feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

feat(ui): scale Mosaic Item rows from a single size prop - #9297

Merged
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions
Jul 31, 2026
Merged

feat(ui): scale Mosaic Item rows from a single size prop#9297
alexcarpenter merged 3 commits into
mainfrom
carp/mosaic-item-revisions

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 30, 2026

Copy link
Copy Markdown
Member

Description

Preview: https://swingset-git-carp-mosaic-item-revisions.clerkstage.dev/components/item

Item.Root takes a size (xs | md, default md) that fixes the row's height and gap, and provides it through context so Item.Media derives its column width from the row rather than taking a size of its own. A row scales as one unit instead of needing the prop set on two parts that can drift apart. Item.Media reflects the resolved value as data-size alongside the root, and falls back to the default when rendered outside a root.

This replaces the entity/actionvariant, which conflated visual treatment with density. Action rows now use a dedicated Item.Label part in place of Item.Title — dimmed until the row is hovered, so it reads as an affordance rather than content. Item.Header, Item.HeaderTitle, and Item.HeaderActions are removed; they had no consumers in the monorepo.

Because media is now sized by the row, its child should fill the column (Avatar.Root size='fit', or an icon at width='100%') rather than carry a fixed pixel size that won't track size. The swingset page and JSDoc are updated to match, and the Item.Label component had been declared under a duplicated MosaicItemDescription name, which is corrected.

The changeset is empty: Mosaic is not yet part of the public @clerk/ui surface, matching the existing mosaic-item and mosaic-button-variants changesets.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Item.Root now takes size (xs | md), fixing the row height and gap, and
provides it through context so Item.Media derives its column width instead
of taking a size of its own.
Replaces the entity/action variant, adds Item.Label for action rows, and
drops Item.Header/HeaderTitle/HeaderActions, which had no consumers.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreviewJul 31, 2026 12:03am
swingsetReadyReadyPreviewJul 31, 2026 12:03am

Request Review

@changeset-bot

changeset-botBot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d47e2da

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 30, 2026 23:47 Inactive
@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c9d6f3b5-d6ce-4d6c-ac05-73a906dc5869

📥 Commits

Reviewing files that changed from the base of the PR and between fa09923 and d47e2da.

📒 Files selected for processing (3)
  • packages/ui/src/mosaic/components/item/item.markers.stylex.ts
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The Item component now uses root-level size values with context-driven media sizing, adds Item.Label, and removes header-related exports. Styles support xs and md variants, responsive media dimensions, truncation, and updated focus treatment. Tests cover size propagation and defaults. Stories and documentation describe the new API and examples, and a spacing token plus Changesets metadata were added.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

Suggested reviewers:maxyinger

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely summarizes the main change: consolidating Mosaic Item row sizing under a single size prop.
Description check✅ PassedThe description directly explains the sizing changes, API updates, component removals, styling behavior, and documentation updates.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actionsBot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T00:04:11.157Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on d47e2da.

@pkg-pr-new

pkg-pr-newBot commented Jul 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9297

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9297

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9297

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9297

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9297

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9297

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9297

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9297

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9297

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9297

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9297

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9297

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9297

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9297

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9297

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9297

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9297

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9297

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9297

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9297

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9297

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9297

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9297

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9297

commit: d47e2da

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/item/item.test.tsx (1)

94-109: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add coverage for the new Item.Label part.

The "composed slots" test checks Item.Title, Item.Description, and Item.Actions classes but doesn't exercise Item.Label, the new component introduced in this PR. As per coding guidelines, "Unit tests are required for all new functionality" / "Include tests for all new features."

✅ Suggested addition
 <Item.Actions>
<button type='button'>Manage</button>
</Item.Actions>
+ <Item.Label>Sign out</Item.Label>
</Item.Root>,
);
expect(screen.getByText('Test Organization')).toHaveClass('cl-item-title');
expect(screen.getByText('Member')).toHaveClass('cl-item-description');
expect(screen.getByRole('button', { name: 'Manage' }).parentElement).toHaveClass('cl-item-actions');
+expect(screen.getByText('Sign out')).toHaveClass('cl-item-label');
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/item/item.test.tsx` around lines 94 - 109,
The composed-slots test does not cover the new Item.Label component. Update the
test around the existing Item.Root composition to render Item.Label with
representative text and assert it has the expected stable label class, while
preserving the existing Title, Description, and Actions assertions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/swingset/src/stories/item.stories.tsx`:
- Around line 195-218: Update the icon-only Button in the story to provide an
accessible name describing its more-options action, using an appropriate
aria-label or equivalent accessible labeling mechanism; keep the SVG decorative
or otherwise prevent it from being announced redundantly.
---
Nitpick comments:
In `@packages/ui/src/mosaic/components/item/item.test.tsx`:
- Around line 94-109: The composed-slots test does not cover the new Item.Label
component. Update the test around the existing Item.Root composition to render
Item.Label with representative text and assert it has the expected stable label
class, while preserving the existing Title, Description, and Actions assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a6da41b6-6884-4b21-bd02-522dc42c9f19

📥 Commits

Reviewing files that changed from the base of the PR and between b0519d2 and fa09923.

📒 Files selected for processing (7)
  • .changeset/mosaic-item-size.md
  • packages/swingset/src/stories/item.mdx
  • packages/swingset/src/stories/item.stories.tsx
  • packages/ui/src/mosaic/components/item/item.styles.ts
  • packages/ui/src/mosaic/components/item/item.test.tsx
  • packages/ui/src/mosaic/components/item/item.tsx
  • packages/ui/src/mosaic/tokens.stylex.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

Comment threadpackages/swingset/src/stories/item.stories.tsx
Item.Label reacted to :hover on its own text, so the color only promoted when
the pointer was over the label itself rather than anywhere in the row.
Adds an itemScope marker applied by Item.Root and keys the label color to
stylex.when.ancestor against it, so the scope cannot be triggered by an
unrelated hovered ancestor.

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏 lets 👏 go 👏

@alexcarpenter
alexcarpenter merged commit 49d61ff into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-item-revisions branch July 31, 2026 00:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger