fix(app-shell,console): a plain page route stops loading the Studio designers, InterfaceListPage and one chunk per eager icon (objectui#12187)

[objectstack-fleet]

Part of #12187
Clause-②: no

Item 2 of objectui#12187, under claim 6119197321 as amended for item 2 by 6121401939: what a plain page route pulls before its content. Item 1 landed as 54159d3. Item 3 (one sys_user_preference read per load) stays on the card, so this PR leaves the card open.

The measurement (H0), before and after

Instrument. The console's own vite build (its vite.config.ts, unchanged, plus one scratch plugin that is not committed and dumps rolldown's chunk graph: each chunk's imports, dynamicImports and modules, and the module graph). Then the built dist, served under /_console/ with an injected base href, in a cold Chromium context (/opt/pw-browsers/chromium) on /_console/apps/demo_app/page/welcome. The backend is a Playwright route mock: one app whose navigation opens one home-kind page (a page:header and a text block), signed in as a member without manage_metadata. "Before content" means resource entries whose startTime precedes the moment the page's text is in the DOM. The resource-timing buffer is raised first: Chromium keeps 250 entries by default, and a full buffer reads as exactly 250, which is the figure the card's staging reading shows.

Before = this branch's base 54159d3. After = this PR's head. Three cold runs each; the counts were identical across runs.

reading	before	after
requests before content	385	102
JS chunks before content	355	72
single-icon vendor-icon-* chunks before content	279	0 (one vendor-icons-shell chunk)
Studio designer and interface-list chunks before content	register-builtin-designers, HookDefaultInspector, ReportDefaultInspector, default-inspector-registry, InterfaceListPage	none
other *Inspector*-named chunks before content	ViewVariantInspector, MetadataInspector	the same two (see "Not changed here")
page text in the DOM, ms after navigation (loopback, shared box)	1583 / 1499 / 1398	1184 / 1180 / 1351
main in the DOM, ms	1320 / 1235 / 1132	925 / 926 / 1080

The 102 requests after: 72 JS chunks, 27 API calls, 2 stylesheets, 1 favicon. The 27 API calls include the three sys_user_preference reads that item 3 is about.

JS chunks before content, after (hash suffixes dropped): ActionResultDialog, app-shell-eager-leaves, appRoute, AssignedUsersSection, assistantBus, builtin-designers-loader, componentRegistry, createDerive, CreateViewDialog, data-adapter, DeclaredActionsBar, dist, drillUrlFilters, ExpressionProvider, expressionUser, FlowPaletteRecentsProvider, FlowRunner, framework, i18n, i18n-locale-en, i18n-runtime, index, infrastructure, mergeServerFields, MetadataInspector, nav-selection, ObjectView, packagedActions, pageKindNode, PageView, plugin-chatbot, plugin-form, plugin-grid, plugin-view, plugins-views, preferLocal, PreviewModeContext, RecordDetailView, rolldown-runtime, runtime-metadata-persistence, RuntimeDraftBar, SchemaForm, SettingsField, SkeletonDetail, src, studioEntry, submitRedirect, ui-components, ui-layout, useActionModal, useCanAuthorMetadata, useConsoleActionRuntime, useDatasetCatalog, useMetadata, useMetaItemRefusal, useNavTargetLabel, userFilterUrlState, useSettingsLabel, useTenancyPosture, utils, vendor-dndkit, vendor-i18n, vendor-icons-core, vendor-icons-shell, vendor-markdown, vendor-objectstack, vendor-radix, vendor-react, vendor-react-markdown, vendor-ui-utils, viewFilterFold, ViewVariantInspector.

Before, the same route loaded 279 single-icon chunks and these 76 others: the list above without vendor-icons-shell, builtin-designers-loader and useConsoleActionRuntime, plus register-builtin-designers, HookDefaultInspector, ReportDefaultInspector, default-inspector-registry, InterfaceListPage, identity and apiBase. (apiBase and useConsoleActionRuntime are the same shared helpers, written to a chunk of a different name.)

The edges, each with the module that made it

1. The designers: a dynamic import that ran on every page load. packages/app-shell/src/index.ts ran import('./views/metadata-admin/register-builtin-designers.js').then(...) at its own module scope (objectui#11939 step 2). In the graph it is a dynamicImports edge of the eager src chunk, so the eager-closure gate never weighs it. The browser still fetched it at boot: register-builtin-designers and 62 chunks it imports statically (HookDefaultInspector, ReportDefaultInspector, default-inspector-registry, InterfaceListPage, pageKindNode, identity and 56 single-icon chunks). Nothing on a page route reads a designer.
   • Change: the entry passes the same loader to deferBuiltinDesigners in a new module-internal module, views/metadata-admin/builtin-designers-loader.ts. The three designer registries run it once, on their first read: createObservableTypeRegistry's get and types, and the reader hooks' subscribe. Importing the entry still registers every built-in designer with no call from the host (Ruling A on objectui#11798): entryRegistersBuiltinDesigners-11939 passes unchanged. A module imported without the entry (a test of one surface) keeps empty registries, as before.
   • The loader sits in its own module because the entry calls it at module scope. A first cut kept it in preview-registry.ts, and that put the whole registry module in the eager closure. In the after build the eager closure gains exactly one module, builtin-designers-loader.ts, in a 412-byte chunk.
2. InterfaceListPage: a static import in PageView. packages/app-shell/src/views/PageView.tsx imported InterfaceListPage statically. Its chunk is shared with the Studio's PagePreview and with ObjectDataPage, so it is a chunk of its own, and that import fetched it on every page route.
   • Change: a React.lazy edge, rendered under Suspense with a spinner, in the interfaceConfig.source branch only.
3. The icons: one chunk per icon by design (objectui#9251). On the before build, 223 of the 291 eager-closure chunks were single-icon vendor-icon-* chunks, each imported statically by an eager chunk. The other 56 single-icon chunks on the route came with edge 1.
   • Change: in apps/console/vite.config.ts, a vendor-icons-shell group with tags: ['$initial'], listed after vendor-icons-core and before the per-icon group, at the same priority.
   • Measured on the two builds: its members are exactly the 223 icons whose per-icon chunk was eager before. The after build's eager closure holds the same 223 icons and no vendor-icon-* chunk. Lazy icons keep their own chunks (1592 of them in the after build), so this is not the all-icon aggregate objectui#9251 refused. The lucide runtime stays in vendor-icons-core (12 modules on both builds).
   • $initial over-captures, measured: rolldown decides it before tree-shaking. Without an exclusion the group took 226 icons. The 3 extra are circle-arrow-up, folder-tree and webhook, imported only by MarketplacePackagePage and its PluginDisclosure. The package barrel re-exports that page and viteDeclaredLazyViews marks it side-effect-free, so the bundle keeps it off the eager path. Those three are excluded by name (LAZY_ONLY_INITIAL_ICONS), and their chunks are lazy in the after build. The config's note says that nothing re-derives that list.

Eager closure, from pnpm check:eager-closure

	before	after
gzipped	3,254,971 B (3178.7 KB)	3,201,712 B (3126.7 KB)
raw	10,948,550 B	10,899,430 B
eager chunks	291 of 2474	70 of 2253
ui-components	281.5 KB	279.0 KB

The module set grows by the one loader module and loses none. The bytes that left are gzip-stream overhead (223 streams, now one) and the shorter import lists of the chunks that import the icons. The budget line is untouched.

⚠️ Headroom goes from 25.9 KB to 77.9 KB, which is 0.88x the 89 KB regression the gate's ceiling-sensitivity check is sized on. About 11 KB more shrink would make that check refuse (exit 2) until the ceiling is re-pinned. The ceiling is the budget line, objectui#11762's, and this PR does not touch it.

Not changed here: the two *Inspector* chunks still on the route

• ViewVariantInspector-*.js is in the eager closure. views/ViewConfigPanel.tsx is the runtime ObjectView's view-editor rail, in the eager ObjectView chunk. It imports views/metadata-admin/inspectors/ViewVariantInspector.tsx statically. Measured with a temporary React.lazy on that edge (built, then restored to HEAD, git diff HEAD empty): the closure loses 13,799 B gzipped more, and no *Inspector* chunk but MetadataInspector is eager. Headroom would then be about 91.7 KB, over the 89 KB the sensitivity check allows. The check would refuse until the ceiling is re-pinned, and that is the budget line this amendment rules out. That is a decision for the seat.
• MetadataInspector-*.js is views/MetadataInspector.tsx, the runtime debug panel (MetadataPanel, useMetadataInspector) that ObjectView, PageView and RecordDetailView mount. It is not Studio code. It matches the acceptance's *Inspector* glob by its name only.

Studio and interface pages, in Chromium on the after build

• /_console/apps/demo_app/metadata/page/welcome (the page's Studio editor): register-builtin-designers and the inspector chunks load on that route. The page preview draws "Welcome / Hello from the welcome page." and the Properties form renders. The visible text is the same as on the before build. No page errors.
• An interface page (type: 'list', interfaceConfig.source): InterfaceListPage loads and draws its own state ("Object Not Found", because the mock serves no object). The plain page loads neither chunk.

The pin

packages/app-shell/src/__tests__/pageRouteLoadsNoStudioChunks-12187.test.tsx replaces register-builtin-designers and InterfaceListPage with factories that count their own evaluation, and imports the package entry. It asserts:

• neither module is evaluated by importing the entry, so a static edge back from PageView or a loader run at module scope again goes red;
• the first registry read loads and registers the designers, and later reads of any registry start no second load.

Ablations through objectstack's scripts/ablation-replace.mjs. Each anchor went 1 to 0, was restored to the HEAD blob, and left git diff HEAD empty. The predicted direction was red both times, and both went red:

• the loader called at the entry's module scope again: Tests 1 failed | 1 passed (2), "the entry loaded the designers at its own module scope: expected 1 to be +0";
• PageView's static import { InterfaceListPage } restored: Tests 1 failed | 1 passed (2), "a module in the static graph of the entry (PageView) imports InterfaceListPage statically: expected 1 to be +0".

The test imports app-shell source by relative path, so no dist is in its resolution path.

Co-located test edits

• page-kind-writing-end-9718: the interface-mode case waits for the lazy mount (Testing Library's waitFor). The assertion is unchanged.
• PageView.refreshInPlace-10519: imports ../InterfaceListPage at module scope, so the module loads in the import phase and the interface case's waitFor covers only the lazy edge (AGENTS.md 测试纪律).

Tests and gates, at HEAD 0943b54

• vitest (through the verify lock):
  • the pin, entryRegistersBuiltinDesigners-11939, builtinDesigners.lateArrival-11939, the four designerRegistryMissing, designerRegistryPartial, designerRegistryPopulated and three lateRegistration-11939 files: 12 files, 25 tests passed;
  • every app-shell test file that names preview-registry, inspector-registry, default-inspector-registry, InterfaceListPage or PageView: Test Files 120 passed (120), Tests 1001 passed (1001);
  • the 19 console test files that import @object-ui/app-shell: Test Files 19 passed (19), Tests 162 passed (162).
• type-check: @object-ui/app-shell (tsc --noEmit && tsc -p tsconfig.test.json, whose include is src/**/*.test.tsx, so it compiles the pin and the two edited tests) and @object-ui/console: both exit 0.
• Builds: turbo run build --filter='@object-ui/console^...' --concurrency=2: 34/34 tasks. Console vite build: exit 0, with every build guard in the config green (assert-lazy-linter-stays-lazy, assert-types-zod-stays-lazy, declared-lazy views, ineffective-dynamic-import ledger). @object-ui/app-shell rebuilt at HEAD: its published dist/index.d.ts is byte-identical to the base build's (cmp exit 0), so no exported type moved.
• Gates, all exit 0: check:eager-closure ("3126.7 KB gzipped across 70 of 2253 chunks", membership exact), check:eager-locale-catalogues, check:docs-route-closure, check:unreferenced-sources, check:side-effects-array, check:sdui-registration-pins, check:vi-mock-inherit, check:entry-guard, check:icon-record-names, check-changeset-presence, check:changeset-claims, check:pending-changeset-literals, check:control-bytes, check:new-line-citations ("0 new citation(s)").
• ESLint, narrowed and measured: eslint --no-inline-config --format json over the 8 changed .ts / .tsx files gave 8 files, 0 errors and 27 warnings. Every warning is a no-explicit-any that was already there: the per-file counts equal the base's. The config has no type-aware linting (a grep for projectService, typeChecked, tsconfigRootDir or parserOptions exits 1; the languageOptions control exits 0). No eslint-rules/*.js reads the filesystem (exit 1, 23 rule files). So the diff cannot move another file's verdict. Repo-wide lint: NOT MEASURED, CI-owned.

Changeset

.changeset/12187-page-route-chunks.md: @object-ui/app-shell patch and @object-ui/console patch (the console's published dist is chunked differently). No published export, prop or type changes.

Acceptance notes

• The card's acceptance item 2 is a staging reading. The seat takes it once cloud's pin carries this merge. Read against it: ViewVariantInspector and MetadataInspector will still match *Inspector* (see above). The local request count before content is 102, and 27 of those are API calls, so the staging figure depends on the backend's own calls and on item 3.
• The first Studio open after a cold load. The designers now start loading when the Studio route first reads a registry, not at boot. A reader shows its "designer missing" state until the chunk lands, the same state objectui#11939 already accepted for a cold deep link. A possible follow-up, not done here: the console's Studio route loaders could request the designers alongside the route chunk.
• Imperative readers. A host that reads a registry with getMetadata* / listMetadata* sees the built-ins from a read after the one that started the load. In this repository, every reader outside tests uses the hooks, apart from ResourceEditPage's save handlers, which run after its own hooks have read.
• Two boot requests are issued twice in the mock: /api/v1/runtime/config (from index.html's applyEarlyBranding and from app-shell's initRuntimeConfig) and /api/v1/auth/me/localization. objectui#5544's dedup covers an in-flight request, and this mock answers at once, so this is not a reading of staging. Not classed and not filed.

---

Generated by Claude Code

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Eager closure (gzip, 70 chunks)	3126.7 KB	3204.6 KB
Main entry chunk (gzip)	73.1 KB	350 KB
Entry file	index-DH5MTwRe.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)	20.69KB	7.62KB
app-shell (runtime-config.js)	22.59KB	7.89KB
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)	40.22KB	10.61KB
auth (AuthShell.js)	3.49KB	1.40KB
auth (ForgotPasswordForm.js)	12.21KB	3.45KB
auth (LoginForm.js)	18.15KB	5.40KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.72KB	2.24KB
auth (SocialSignInButtons.js)	9.70KB	3.93KB
auth (UserMenu.js)	3.39KB	1.21KB
auth (auth-gate-events.js)	1.29KB	0.66KB
auth (authStyles.js)	5.04KB	1.72KB
auth (createAuthClient.js)	41.19KB	11.12KB
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.11KB	7.97KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	6.28KB	2.60KB
collaboration (PresenceProvider.js)	2.79KB	1.13KB
collaboration (index.js)	1.68KB	0.73KB
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)	588.51KB	141.71KB
core (index.js)	10.18KB	4.04KB
create-plugin (index.js)	27.94KB	9.51KB
data-objectstack (index.js)	243.13KB	67.92KB
fields (index.js)	279.67KB	71.25KB
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)	40.26KB	11.71KB
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)	54.31KB	15.86KB
plugin-charts (index.js)	84.72KB	23.27KB
plugin-chatbot (index.js)	201.72KB	48.07KB
plugin-dashboard (index.js)	144.20KB	38.95KB
plugin-designer (index.js)	233.77KB	50.02KB
plugin-detail (index.js)	250.93KB	66.25KB
plugin-editor (index.js)	2.23KB	1.05KB
plugin-form (index.js)	178.37KB	46.27KB
plugin-gantt (index.js)	178.63KB	45.19KB
plugin-grid (index.js)	255.09KB	70.91KB
plugin-kanban (index.js)	53.23KB	16.71KB
plugin-list (index.js)	123.03KB	31.28KB
plugin-map (index.js)	27.24KB	9.03KB
plugin-markdown (index.js)	13.88KB	4.80KB
plugin-report (index.js)	44.12KB	12.29KB
plugin-timeline (index.js)	39.21KB	11.85KB
plugin-tree (index.js)	15.07KB	5.33KB
plugin-view (index.js)	92.11KB	23.27KB
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)	120.63KB	39.56KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	4.50KB	2.06KB
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 (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 (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