Skip to content

test(components): assert the deprecation notice and deprecated.replacement name the same alternatives - #6867

Merged
os-sam merged 1 commit into
mainfrom
claude/issue-6823-deprecation-guidance-agreement
Aug 30, 2026
Merged

test(components): assert the deprecation notice and deprecated.replacement name the same alternatives#6867
os-sam merged 1 commit into
mainfrom
claude/issue-6823-deprecation-guidance-agreement

Conversation

@os-sam

@os-sam os-sam commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Fixes #6823

Since #6674 a deprecated type states its migration guidance twice — the console notice string literal in the renderer, and the machine-readable deprecated.replacement on the same file's registration, transcribed from the notice by hand. Nothing held them together, so a reword of either left the other stale, and the stale one is the copy an automated gate reads and repeats to authors. Unlike the type-level executions of this class (#4580 / #6067 / #5671 / #5893) there is no tsc to notice one string literal drifting from another.

Shape: (a) assert the agreement — triage's ruling, not re-litigated

Triage ruled (2026-08-29) for the assertion over converging the two texts, and this PR does exactly that. The notice wording is pinned byte-for-byte by four existing tests, and those pins are themselves #4000's ruling that the guidance is "byte-for-byte what it was" — converging would trade one ruled invariant for another. No pin is touched; all four are green in the run below.

The stop condition in the triage comment did not trigger: the assertion restates no guidance text at all, so it never became a third copy of the sentence.

What the assertion actually compares

packages/components/src/__tests__/deprecation-guidance-agreement.test.tsx, one case per renderer (div, span):

  1. render one JSON-authored node of the type and read the notice off the console — the way every reader reads it, and without exporting a module-private literal for a test's convenience;
  2. reduce both statements, mechanically, to the thing they are both about: the set of component type names offered, extracted as each text's double-quoted runs. That is a convention both texts already follow, and it is the half that has to agree — prose framing may differ (the notice explains when to reach for each; the declaration is one line for a gate to repeat), the alternatives on offer may not;
  3. assert set equality, not containment. Containment one way catches a name added to the declaration but missing from the notice and misses the reverse; drift has no preferred direction.

Two deliberate boundaries:

Three control assertions keep the comparison from passing while measuring nothing: exactly one notice was emitted, the notice really carries bullet guidance, and the declaration's extracted name set is non-empty (an empty-vs-empty equality would otherwise be green while saying nothing).

Verification — all at accc457, on a clean tree

Re-derived on the shipped tree, not the card's branch. The card was measured on claude/issue-6674-registry-deprecation-declaration @ eb852a052; base here is origin/main @ 30266cf9a, with #6822 / #6834 / #6841 / #6851 all landed. The symbols and paths the card names are unchanged, and the two statements still agree — the new cases are green on arrival, which is why the ablation below is the load-bearing evidence rather than the green.

Ablation — the drift protection is real. Three legs, each mutated on disk with the anchor's occurrence count checked (injected-count=1 removed-count=0; a zero-hit edit would have reported a no-op instead of a pass), restored from a trap on EXIT/INT/TERM with absolute paths, and each restore proven by comparing the file's git hash-object against its HEAD blob plus an empty git diff HEAD:

leg mutation result
A div declaration renames one alternative ("grid" in deprecated.replacement) red — 1 failed | 1 passed
B div notice renames the same alternative in its guidance bullet red — 1 failed | 1 passed
C span declaration renames one alternative ("badge") red — 1 failed | 1 passed
control restored tree green — 2 passed

Every leg failed on the intended line (the set-equality assertion), and in each the other renderer's case stayed green, so attribution is exact. No rebuild leg is needed and none is claimed: the root vitest config aliases @object-ui/* to each package's src/, and the test imports the renderers relatively (../renderers), so nothing in these runs resolves through dist/.

Suites and gates (exit codes captured before any pipe; verdicts quoted from each gate's own output):

  • pnpm exec vitest run packages/components/ --maxWorkers=2216 files / 1995 tests passed, which is every *.test.ts(x) in the package (216 by count) and includes all four div 的废弃警告会对 kind: 'html' tier 自己解析出的节点开火 —— 作者无法消除,且意味着 div 结构上退不掉 #4000 pins.
  • pnpm --filter @object-ui/components run type-check (tsc --noEmit && tsc -p tsconfig.test.json) — exit 0. --listFiles confirms the new file is a program input, so this covers it rather than merely passing beside it.
  • node scripts/check-changeset-presence.mjs — "Every one of them has an EMPTY frontmatter — declared as releasing nothing, which is the explicit exemption and a complete answer to this gate."
  • node scripts/check-changeset-fixed.mjs, node scripts/check-changeset-no-major.mjs, node scripts/check-control-bytes.mjs, node scripts/check-vi-mock-specifiers.mjs — all exit 0 on their own verdict lines.

Lint, and the narrowing declared. pnpm exec eslint . --format json from packages/components433 files, 0 errors, 934 warnings, the package's standing baseline; the new file contributes 0 of each. This is the whole eslint surface the diff can affect, on three pieces of evidence: the population comes from eslint's own config resolution rather than a guess about which files count; the file count is read from the --format json output; and eslint.config.js declares no parserOptions.project / projectService, so type-aware linting is off and a new file cannot move any untouched file's verdict. The repo-wide turbo run lint is CI's run.

Release

Test-only, no published behaviour changes: .changeset/6823-deprecation-guidance-agreement.md carries an empty frontmatter, the exemption check-changeset-presence names explicitly. No skip-changeset label — in this repo that label is read by nothing.

Session: https://claude.ai/code/session_013hfmP9hoMd3dJwTh85J4yB

Generated by Claude Code


Generated by Claude Code

…cement` agree

Since #6674 a deprecated type states its migration guidance twice — the
console notice string literal in the renderer, and the machine-readable
`deprecated.replacement` on its registration, transcribed from the notice by
hand. Nothing held them together, so a reword of either left the other stale,
and the stale copy is the one an automated gate reads and repeats to authors.
Unlike the type-level cases of this class there is no `tsc` to notice.

One case per renderer extracts the double-quoted type names from each side —
the notice's guidance bullets, and the declaration's replacement line — and
asserts set equality. No guidance text is restated in the test: a third copy of
the sentence is the defect one layer up.

The four byte-for-byte pins from #4000 are untouched.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013hfmP9hoMd3dJwTh85J4yB
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 45 chunks) 3176.7 KB 3222.7 KB
Main entry chunk (gzip) 143.6 KB 350 KB
Entry file index-CAhwLgVa.js
Status PASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 12.46KB 4.71KB
app-shell (runtime-config.js) 20.61KB 7.35KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 511.68KB 116.36KB
core (index.js) 5.30KB 2.13KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 173.17KB 47.98KB
fields (index.js) 243.36KB 61.51KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 4.28KB 1.75KB
i18n (index.js) 3.44KB 1.39KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 33.40KB 8.71KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.95KB 10.97KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.55KB 0.62KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useResponsiveConfig.js) 1.37KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 11.71KB 4.29KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 46.92KB 12.93KB
plugin-charts (index.js) 64.68KB 18.35KB
plugin-chatbot (index.js) 190.53KB 45.18KB
plugin-dashboard (index.js) 133.48KB 34.51KB
plugin-designer (index.js) 212.87KB 43.19KB
plugin-detail (index.js) 245.43KB 62.46KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 133.32KB 32.69KB
plugin-gantt (index.js) 165.23KB 40.37KB
plugin-grid (index.js) 201.72KB 54.58KB
plugin-kanban (index.js) 53.14KB 14.64KB
plugin-list (index.js) 113.15KB 27.59KB
plugin-map (index.js) 20.20KB 6.66KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 43.51KB 11.94KB
plugin-timeline (index.js) 28.95KB 8.33KB
plugin-tree (index.js) 9.00KB 3.08KB
plugin-view (index.js) 85.83KB 21.11KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 76.75KB 25.49KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 3.11KB 1.48KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 5.41KB 2.34KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 4.93KB 2.24KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 10.35KB 3.60KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.72KB 2.24KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 2.59KB 1.31KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 3.40KB 1.71KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants