Skip to content

docs(components): document the remaining nine Shadcn divergences — every tracked component now says why it diverges - #3059

Merged
os-zhuang merged 1 commit into
mainfrom
claude/shadcn-triage-remaining
Jul 30, 2026
Merged

docs(components): document the remaining nine Shadcn divergences — every tracked component now says why it diverges#3059
os-zhuang merged 1 commit into
mainfrom
claude/shadcn-triage-remaining

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Completes the triage started in #3054. All 17 locally-modified components now carry a localEdits note, and --check reports 0 UNDOCUMENTED.

None of the nine are droppable either

Same result as the first eight — every one is a deliberate fix or API extension:

why it diverges
command (35)ADR-0054 C4 contentProps + the sr-only DialogTitle Radix requires. Upstream drops each addition with its usages, so a sync deletes ~38 lines and still type-checks — verified.
select (32)Wraps Root to swallow onValueChange(""). Radix's hidden native mirror registers options a commit after the trigger, so a value arriving mid-hydration echoes back empty and wipes the field, latching forms whose visibleWhen reads it (#2968).
sidebar (24)Tailwind v4 syntax, a data-collapsible-always-present refactor, and an eslint-disable react-hooks/purity.
table (17)containerClassName, to stop the wrapper becoming a second height-unbounded scroll container inside DataTable.
chart (11)block … w-full instead of flex justify-center, or ResponsiveContainer measures no width and charts draw axes with no marks (#1634, 9b163173b); plus hand-written Recharts prop types that actually type-check (2e11aa72f).
calendar (7)Tailwind v4 syntax on --cell-size.
badge (4)whitespace-nowrap, or CJK labels (待审批) break per-character in a cramped table cell (objectui#2762 P0-1).
sheet (4)hideOverlay prop.
slider (4)Forwards aria-label to the Thumb.

Two claims I checked instead of asserting

Both could have shipped as confident wrong statements:

Sidebar's eslint-disable is load-bearing. Removed it and re-ran ESLint: react-hooks/purity fires as an error, not a warning, and Lint gates CI. Claim stands.

theme(spacing.4)1rem is cosmetic, not a fix. I initially wrote that upstream's theme() is "a v3 idiom", implying it's broken. Compiling both against tailwindcss 4.3.3:

.w-\[calc\(var\(--zz-icon\)_\+_1rem\)\] { width: calc(var(--zz-icon) + 1rem) }
.w-\[calc\(var\(--zz-icon\)_\+_theme\(spacing\.4\)\)\] { width: calc(var(--zz-icon) + 1rem) }

Identical. v4 still resolves the dot-notation. The note now says so explicitly — only the [--var](--var) half of that migration is load-bearing.

Fixes a misleading --check label

Both counts are set differences, so a locally-edited line appears on both sides — once as ours, once as the upstream original it replaced. Labelling that "N upstream line(s) pending" reads as updates waiting to be collected.

That's exactly how I misread sidebar's 21 and recommended it as the highest-value target with "21 lines to reclaim". There is essentially nothing to reclaim — the 21 are mostly the mirror image of sidebar's own 24 edits. Now reads "N not matching upstream verbatim".

The outdated bucket keeps its original wording: there localOnly is 0, so the count genuinely is new upstream work.

Where this leaves the sync

✓ Identical: 29 ↑ Outdated: 0 ⚠ Modified: 17 (17 documented) ● Custom: 2 ✗ Errors: 0

Every tracked component is now either byte-identical to upstream or carries a written reason for diverging. --update prints that reason at the moment someone is about to --force past it.

Verification

No changeset.

🤖 Generated with Claude Code

…ery tracked component now says why it diverges
Completes the triage. All 17 locally-modified components now carry a
`localEdits` note; `--check` reports 0 UNDOCUMENTED.
None of the nine are droppable either. Like the first eight, every one is
a deliberate fix or API extension:
command ADR-0054 C4 `contentProps` + the `sr-only` DialogTitle Radix
requires. Upstream drops each addition with its usages, so a
sync deletes ~38 lines and still type-checks — verified.
select Wraps Root to swallow `onValueChange("")`. Radix's hidden
native mirror registers options a commit after the trigger,
so a value arriving mid-hydration echoes back empty and wipes
the field, latching forms whose `visibleWhen` reads it (#2968).
table `containerClassName`, to stop the wrapper becoming a second
height-unbounded scroll container inside DataTable.
chart `block … w-full` instead of `flex justify-center`, or
ResponsiveContainer measures no width and charts draw axes
with no marks (#1634, 9b16317); plus hand-written Recharts
prop types that actually type-check (2e11aa7).
sidebar Tailwind v4 syntax, a `data-collapsible`-always-present
refactor, and an `eslint-disable react-hooks/purity` the
random skeleton width needs.
badge `whitespace-nowrap`, or CJK labels break per-character in a
cramped table cell (objectui#2762 P0-1).
slider Forwards `aria-label` to the Thumb.
sheet `hideOverlay` prop.
calendar Tailwind v4 syntax on `--cell-size`.
Two claims I checked rather than asserted, because both could have
shipped as confident wrong statements:
- Removing sidebar's `eslint-disable` really does fail Lint — it is an
error from `react-hooks/purity`, not a warning, and Lint gates CI.
- `theme(spacing.4)` → `1rem` is **cosmetic**, not a fix. Tailwind 4.3.3
still resolves the v3 dot-notation, and both spellings compile to the
identical `calc(var(--sidebar-width-icon) + 1rem)`. The note says so;
only the `[--var]` → `(--var)` half of that migration is load-bearing.
Also corrects a misleading `--check` label. The counts are set
differences, so a locally-edited line appears on BOTH sides — once as
ours, once as the upstream original it replaced. Calling that "N upstream
line(s) pending" reads as updates waiting to be collected, which is how I
misread sidebar's 21 as reclaimable work; it is mostly the mirror image
of sidebar's own edits. Now "N not matching upstream verbatim". The
`outdated` bucket keeps its wording — there `localOnly` is 0, so the
count genuinely is new upstream work.
Manifest and script only; no component source changes.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredJul 30, 2026 2:40pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)27.9 KB350 KB
Entry fileindex-Ix2kLjpg.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)8.20KB2.97KB
app-shell (runtime-config.js)7.42KB2.32KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)7.57KB2.97KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)22.10KB4.37KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.12KB3.41KB
auth (LoginForm.js)17.86KB5.29KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.43KB2.09KB
auth (SocialSignInButtons.js)9.60KB3.89KB
auth (UserMenu.js)3.40KB1.22KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)35.76KB9.11KB
auth (createAuthenticatedFetch.js)4.37KB1.69KB
auth (index.js)2.35KB1.07KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)4.91KB0.87KB
auth (useIsWorkspaceAdmin.js)1.61KB0.85KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.25KB0.53KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)458.88KB100.29KB
core (index.js)2.16KB0.78KB
create-plugin (index.js)9.28KB2.98KB
data-objectstack (index.js)134.67KB34.24KB
fields (index.js)222.07KB54.35KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)2.46KB0.96KB
i18n (pickLocalized.js)1.70KB0.83KB
i18n (provider.js)5.37KB1.72KB
i18n (useObjectLabel.js)25.17KB5.80KB
i18n (useSafeTranslation.js)3.26KB1.44KB
layout (index.js)38.45KB10.67KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.74KB
mobile (index.js)1.50KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)4.05KB1.53KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)8.76KB3.06KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.67KB1.12KB
permissions (evaluator.js)4.41KB1.44KB
permissions (index.js)0.91KB0.41KB
permissions (retry.js)3.48KB1.61KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)1.55KB0.71KB
plugin-ai (index.js)15.71KB3.79KB
plugin-calendar (index.js)44.90KB12.35KB
plugin-charts (index.js)60.52KB17.11KB
plugin-chatbot (index.js)180.09KB42.72KB
plugin-dashboard (index.js)111.59KB28.74KB
plugin-designer (index.js)210.51KB42.50KB
plugin-detail (index.js)221.42KB54.12KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)106.54KB25.88KB
plugin-gantt (index.js)162.26KB39.53KB
plugin-grid (index.js)183.79KB48.20KB
plugin-kanban (index.js)47.82KB13.18KB
plugin-list (index.js)102.39KB24.18KB
plugin-map (index.js)16.80KB5.24KB
plugin-markdown (index.js)13.65KB4.67KB
plugin-report (index.js)40.32KB10.53KB
plugin-timeline (index.js)25.75KB7.32KB
plugin-tree (index.js)8.36KB2.81KB
plugin-view (index.js)85.95KB21.02KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.71KB3.53KB
providers (index.js)0.44KB0.22KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.67KB2.37KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)19.28KB6.38KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.02KB0.55KB
sdui-parser (codegen.js)4.09KB1.74KB
sdui-parser (index.js)3.47KB1.54KB
sdui-parser (parse.js)10.04KB2.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)4.69KB1.48KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)2.07KB0.99KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.04KB1.93KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)1.08KB0.64KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@os-zhuang
os-zhuang merged commit 9369d4b into mainJul 30, 2026
16 checks passed
@os-zhuang
os-zhuang deleted the claude/shadcn-triage-remaining branch July 30, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang