Skip to content

fix(app-shell): register the console home blocks under the app-shell namespace - #13314

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-13301-product-blocks-namespace
Oct 21, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-13301-product-blocks-namespace

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #13301
Clause-②: no

What

The five console home blocks (hero, stat, usage-bar, checklist, tile-grid) now register under namespace: 'app-shell', as every other console registration does, so the registry no longer logs Registering component "…" without a namespace is deprecated for each on every console boot. This is the maintainer's ruling B (comment 6312301934), executed in its dispatch shape:

  1. packages/app-shell/src/console/blocks/productBlocks.tsx: one namespace: 'app-shell' line on each of the five ComponentRegistry.register calls. Nothing else in the file moves.
  2. packages/cli/src/utils/known-schema-types.ts: regenerated with node scripts/regenerate-known-schema-types.mjs, not by hand. The diff adds exactly app-shell:checklist, app-shell:hero, app-shell:stat, app-shell:tile-grid and app-shell:usage-bar, and nothing else; --check exits 0 on the head.
  3. registered-types-validate-ratchet-10859.test.ts: NAMESPACED_REFUSED_AT_TYPE 302 to 307. The docblock entry beside it names this card and the ruling, in the same form as the earlier objectui#7611 PR-5 named stopgap raise, and says the raise covers these five keys only.
  4. Pin tests (below) and a patch changeset for @object-ui/app-shell and @object-ui/cli (the regenerated list is published src of the CLI).

Options A (app-shell: arms in @object-ui/types) and C (a packages/core Registry policy change) are not touched. No spec or protocol change.

Pins

  • (a) bare key still renders. productBlocks-namespace-13301.test.tsx renders a node authoring bare type for each of the five through the real SchemaRenderer and finds its text, with no unknown-component panel. It also pins that the bare key and the app-shell: key resolve to the same renderer.
  • (b) validate refuses the namespaced spelling. product-blocks-namespace-13301.test.ts (cli): for each block the bare key is claimed and the app-shell: key is refused at type (an invalid_union at path type); end to end, objectui validate passes a page with a bare hero (exit 0) and fails the same page with app-shell:hero (exit 1).
  • (c) no deprecation line. The app-shell test installs a console.warn capture in vi.hoisted, before ../productBlocks evaluates (the dom project is isolated, so that evaluation is the file's own), and asserts none of the five is named in a deprecation line. A lit control registers a bare probe key and sees its line captured.
  • (d) the ratchet. It passes at 307. Two one-shot probes, each through ablation-replace.mjs with its blob-hash restore:
    • pin set to 306: red, objectui validate refuses 307 registered namespaced key(s) at type; the pin is 306.
    • a sixth unarmed key app-shell:probe-sixth-13301 added to the generated list: red, refuses 308 ...; the pin is 307., with the probe named in the refused list.
    • Both restored: blob equals HEAD, git diff HEAD empty.

Ablation

Fix committed first (6ccc16f). ablation-replace.mjs --delete --expect 5 on the five namespace: 'app-shell' lines: anchor 5 to 0, blob 2f944edbf050 to 4e044375ef7d (the origin/main blob). Result: Tests 2 failed | 6 passed (8). Red: the deprecation pin (c) and the same-renderer pin. Green: the five bare-key renders (a) and the capture control. Restore: blob after restore 2f944edbf050 equals HEAD, git diff HEAD empty. No dist/ build is involved: the test imports ../productBlocks from source.

Verification (head 6ccc16f)

  • Targeted vitest, --maxWorkers=1, one package group at a time, under the shared lock. app-shell blocks: 3 files, 30 passed. cli + the generator pins (ratchet, new cli pin, known-schema-types-derivation-5115, report-namespace-agreement-6416): 4 files, 62 passed. Families naming the touched files: cli 5 files, 61 passed; types 4 files, 88 passed; plugin-report 1 file, 12 passed; scripts check-lucide-icon-record-names 51 passed; examples/schema-catalog gallery render 588 passed.
  • Closure build turbo run build --filter=@object-ui/app-shell^... --filter=@object-ui/cli^...: 28/28. type-check for @object-ui/app-shell exit 0 and @object-ui/cli exit 0; each new test is in a checked program (--listFilesOnly count 1 each).
  • Lint narrowed to the 5 changed source and test files: eslint --no-inline-config --format json read 5 files, 0 errors, 1 warning (react-refresh/only-export-components on an untouched line of productBlocks.tsx, pre-existing). The population is the repo eslint.config.js, which sets no type-aware parserOptions project, so this diff cannot move a verdict on any untouched file.
  • Battery, exit 0: check:phantom-deps, self-import, unreferenced-sources, doc-example-readers, handler-key-reads, side-effects-array, element-data-source-declaration, spec-symbols, action-forward-parity, designer-field-key-parity, icon-record-names, i18n-keys, i18n-drift, i18n-designer-parity, control-bytes, doc-types, registry-bare-names, prompt-keys, entry-guard, new-line-citations (0 new), check-hand-rolled-comment-mask, check-doc-expression-carriage, regenerate-known-schema-types --check, check-changeset-fixed, check-changeset-presence. check:spec-floors exits 1 with six findings: five no-artifact (packages not built in this worktree, app-shell and cli among them, since only their dependency closure was built) and one floor-too-low on @object-ui/types, a package this diff does not touch. Recorded per the order, not fixed; NOT MEASURED for this diff.
  • Declared to CI: the full packages/app-shell/ and packages/cli/ directories (no whole-directory runs here).

Acceptance notes

  • The raise is a named stopgap. The ratchet's "never rises" rule still applies to every other change, and the sixth-key probe above shows it still fires.

The implementing session is https://claude.ai/code/session_01XVp19E1MYUTFM3dnkwz8gB.


Generated by Claude Code

…namespace

The five console home blocks (hero, stat, usage-bar, checklist, tile-grid)
registered with no namespace, so the registry logged a deprecation warning
for each on every console boot. They now register under `app-shell`, like
every other console registration; a bare `type: 'hero'` still resolves
through the registry's bare fallback.

KNOWN_SCHEMA_TYPES is regenerated with scripts/regenerate-known-schema-types.mjs
and gains exactly the five `app-shell:` keys. objectui validate refuses them
at `type`, so the bare key stays the one authorable spelling, and the
NAMESPACED_REFUSED_AT_TYPE pin rises 302 -> 307 as a named stopgap for these
five keys only (maintainer ruling 6312301934).

Co-authored-by: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XVp19E1MYUTFM3dnkwz8gB
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 77 chunks) 3225.1 KB 3744.1 KB
Main entry chunk (gzip) 81.2 KB 350 KB
Entry file index-DCWXPzEA.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 (buildIdentity.js) 0.80KB 0.49KB
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 21.41KB 7.90KB
app-shell (runtime-config.js) 24.52KB 8.48KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.11KB 3.87KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 45.59KB 12.03KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 20.67KB 6.12KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.74KB 3.94KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.62KB 0.83KB
auth (authStyles.js) 5.27KB 1.86KB
auth (createAuthClient.js) 42.84KB 11.66KB
auth (createAuthenticatedFetch.js) 8.54KB 3.46KB
auth (index.js) 3.63KB 1.64KB
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) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.26KB 8.03KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (commentAuthorship.js) 1.39KB 0.78KB
collaboration (index.js) 1.93KB 0.85KB
collaboration (useCollaborationTranslation.js) 6.50KB 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) 617.54KB 150.58KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 252.96KB 70.67KB
fields (index.js) 294.97KB 75.45KB
i18n (LocalizationContext.js) 2.92KB 1.42KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.52KB 2.39KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.35KB 12.88KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 36.87KB 9.88KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.40KB 12.01KB
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.99KB 0.87KB
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) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 15.35KB 5.51KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.82KB 2.38KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
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) 16.04KB 3.92KB
plugin-calendar (index.js) 55.56KB 16.21KB
plugin-charts (index.js) 86.06KB 23.66KB
plugin-chatbot (index.js) 238.47KB 56.30KB
plugin-dashboard (index.js) 147.53KB 39.95KB
plugin-designer (index.js) 233.95KB 50.08KB
plugin-detail (index.js) 267.56KB 71.11KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 186.64KB 48.54KB
plugin-gantt (index.js) 178.46KB 45.13KB
plugin-grid (index.js) 276.74KB 76.89KB
plugin-kanban (index.js) 64.49KB 19.83KB
plugin-list (index.js) 149.81KB 39.28KB
plugin-map (index.js) 27.17KB 9.00KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 46.66KB 13.13KB
plugin-timeline (index.js) 39.31KB 11.88KB
plugin-tree (index.js) 15.27KB 5.40KB
plugin-view (index.js) 94.54KB 24.33KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 12.07KB 3.68KB
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) 129.13KB 42.23KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.71KB 2.11KB
react (schema-input.js) 4.31KB 2.07KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.50KB 1.99KB
sdui-parser (codegen.js) 9.45KB 3.76KB
sdui-parser (dashboard-widget-options.js) 3.07KB 1.30KB
sdui-parser (index.js) 7.30KB 3.12KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 25.28KB 7.81KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 23.87KB 7.83KB
types (ai.js) 4.39KB 2.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 4.12KB 1.61KB
types (authoring-nodes.js) 0.20KB 0.19KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (cloud.js) 0.20KB 0.18KB
types (complex.js) 4.44KB 2.07KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (dashboard-widget-layout.js) 2.06KB 0.96KB
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 (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 1.13KB 0.65KB
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) 5.78KB 2.70KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (node-slots.js) 7.18KB 2.34KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (product-blocks.js) 0.20KB 0.19KB
types (record-approval-decision.js) 0.20KB 0.20KB
types (record-components.js) 0.20KB 0.19KB
types (record-panels.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 (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 4.99KB 1.96KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 19.93KB 7.26KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.48KB 3.50KB
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

Development

Successfully merging this pull request may close these issues.

[Decision] Console home blocks registered without a namespace: raise the namespaced ratchet, arm twins, or leave bare

2 participants