Skip to content

fix(app-shell): Studio's page previews draw the page's own kind, as the running app does (objectui#11933) - #11959

Merged
objectstack-fleet[bot] merged 5 commits into
mainfrom
claude/issue-11933-preview-page-type
Oct 8, 2026
Merged

objectstack-fleet[bot] merged 5 commits into
mainfrom
claude/issue-11933-preview-page-type

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11933

Clause-②: no
Surface amended by the seat: PagePreview.tsx (card Done-when bullet 1)

What was wrong

A page's KIND (app, home, record, utility) rides two keys on the node handed to SchemaRenderer: the node type that ComponentRegistry dispatches on, and a copy on pageType, which PageRenderer reads for the page's max-width, its data-page-type and whether it draws the implicit title heading. The running app's PageView wrote both. Studio's two page previews wrote type only:

  • the live preview beside an html / react page's source (SourcePageEditor, previewSchema);
  • the Interfaces page canvas in Run mode (PagePreview, its schema memo).

So PageRenderer fell back to record and an app or home page previewed at the record width with no title heading, while the running app drew both. That breaks the previews' contract, quoted from SourcePageEditor's header: "a live preview rendered through the runtime SchemaRenderer".

The change

  • New module-private builder pageKindNode beside PageView (packages/app-shell/src/views/pageKindNode.ts). It returns { type: page.type || 'page', pageType: page.type }, which is exactly the pair PageView wrote inline. It is not exported from the package entry.
  • PageView, SourcePageEditor and PagePreview all spread it, so the three writers cannot drift again. PageView's output is unchanged.
  • Page shape only: PageView's context: { params } and its two providers stay with that writer, because a preview has no URL.
  • PagePreview needed one more line. Its empty-draft check counted the memo's keys (at most one key meant empty), and the builder's pageType key would have moved that count. It now asks the draft's own keys, with type set aside. That is the same predicate the old count expressed. The second ablation leg below shows the line is load-bearing.

Hypothesis reading (H1): the preview dropped exactly one page-shape key, pageType. It also used a different fallback operator (?? where PageView uses ||), which differs only for an empty-string type. The title heading and the width class are not separate keys. PageRenderer derives both from pageType (getPageMaxWidth, and headerOwnsTitle reading pageType === 'record'), and the title text is title ?? label, which every writer carries through the spread.

Pins (real SchemaRenderer, real ComponentRegistry, real PageRenderer)

Widths are compared, never hard-coded. The classes are PageRenderer's choice; this card owns only that a non-record page does not get the record width.

  • SourcePageEditor.pageKind-11933.test.tsx (preview half; only the Monaco loader is mocked offline, as in the sibling source-page tests):
    • CONTROL: a record page draws exactly as an untyped page does. That is the renderer's record default: no h1, same width.
    • app and home draw data-page-type equal to the kind, the title heading, and a width that is not the record width.
    • Every region-composed kind read from PageTypeSchema reaches the renderer as itself.
  • PagePreview.pageKind-11933.test.tsx (Run-mode render, no design mode):
    • The same record CONTROL, and the same app / home cases.
    • CONTROL: an empty draft, typed or not, still shows the add-components message and draws no page.
  • page-kind-writing-end-9718 still pins PageView's write, kind by kind, and is unchanged and green. Card bullet 3: it is not widened. Each preview's write is pinned at render level beside that preview, and all three writers spread one builder.

Ablations (fix committed first; ablation-replace.mjs, which verifies on disk and restores to HEAD)

  • SourcePageEditor, run at 36b3d33fb. The pre-fix type-only line was restored: anchor x1 to x0, blob 90ef1c7fa03e to 268b032164fd. Result: Tests 3 failed | 1 passed (4). For app and home the pin expected the kind and received record; the record CONTROL stayed green. The restore matched the HEAD blob and git diff HEAD was empty.
  • PagePreview, run at 811475cd3:
    • Leg 1: the pre-fix type-only memo was restored (blob b29ef4ae1128 to 5da520728ac5). Result: Tests 2 failed | 3 passed (5). For app and home the pin expected the kind and received record.
    • Leg 2: the old key-count predicate was restored (blob b29ef4ae1128 to 13ca9d01052d). Result: Tests 2 failed | 3 passed (5). Both empty-draft CONTROLs went red.
    • Both legs restored to the HEAD blob b29ef4ae1128 with git diff HEAD empty.

Gates, at HEAD 811475cd3 (git rev-parse --short HEAD after the last commit; main merged at 1c51e973b, no conflicts)

  • The vitest union ran under the verify lock over 23 files, with repo-root pnpm exec vitest run:
    • both pins, page-kind-writing-end-9718, and the five PageView.* tests;
    • no-refresh-key-remount.ratchet, useMonacoFallback.loaderRejection-11800 and ResourceEditPage.pageRequiresStamp-11357;
    • dataPreviews.i18n-10862-s3, PagePreview.test, PagePreview.expandFls-7429 and page-preview-record-type-10482;
    • the StudioDesignSurface tests that mount PagePreview: interfacesReadOnly-11136, autosaveInFlight-11204, autosaveSwitch-11232, navItemTypes-11790 and navPlaceholderSave-11776;
    • packages/core column-identity.ratchet, and the two scripts/__tests__ files that read PageView's source.
    • Result: Test Files 23 passed (23), Tests 223 passed (223), lock VERDICT command-exit 0.
  • pnpm --filter @object-ui/app-shell type-check (tsc --noEmit && tsc -p tsconfig.test.json) gave VERDICT command-exit 0. It ran after rebuilding the dependency closure, and @object-ui/plugin-list again after the merge. --listFilesOnly shows both pins and the builder in the test program.
  • eslint on the 6 touched files: exit 0, 0 errors. No warning is new: PageView has 3 against 5 on main, and PagePreview has 15 against 15 on main, all pre-existing no-explicit-any / set-state-in-effect. Type-aware linting is off in eslint.config.js, so the diff moves no verdict on an untouched file. Repo-wide pnpm lint is left to CI.
  • check:unreferenced-sources: "OK Every shipped source file in every covered package is reachable."
  • check-changeset-presence: "6 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s)".
  • check-changeset-no-major, check:changeset-claims and check:pending-changeset-literals: green.
  • check:new-line-citations: "VERDICT new-cross-file-line-citations: 0 new citation(s)".
  • check:spec-symbols, check:control-bytes, check:vi-mock-specifiers / -inherit / -override-shape and check:test-path-roots: all exit 0.
  • Eager-closure budget: NOT MEASURED locally (no console build, by dispatch). The budget bot's reading on this PR is the measurement. Expected delta: one small function added to PageView's closure, and the inline pair it replaces removed.

Changeset and docs

  • .changeset/11933-preview-page-kind.md: a patch for @object-ui/app-shell. Nothing is added to the package entry.
  • Docs: no guide or README prose describes the previews' page width or title heading, so there is nothing to update.

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


Generated by Claude Code

claude added 5 commits October 8, 2026 10:32
…d (objectui#11933)

Studio's source-page preview wrote the page's kind into the node `type`
only. PageRenderer reads the kind from `pageType`, so every source page
previewed as a record page: record width, no title heading. The running
app's PageView wrote both keys.

Both writers now spread one module-private builder, `pageKindNode`, for
the `{ type, pageType }` pair, so they cannot drift again. PageView's
output is unchanged; data and context wiring stay with each writer.

Pin: SourcePageEditor.pageKind-11933 renders through the real
SchemaRenderer and PageRenderer: an app and a home page preview with the
title heading and a non-record width; a record page previews as the
renderer's record default, as before.

Claude-Session: https://claude.ai/code/session_01MgfduSkFrfM3eorB3UGfAU
Co-authored-by: Claude <noreply@anthropic.com>
…offline (objectui#11933)

The preview half never mounts the editor, but the component asks the
Monaco loader either way; the sibling source-page tests mock it offline,
and so does this pin, so no CDN script is requested.

Claude-Session: https://claude.ai/code/session_01MgfduSkFrfM3eorB3UGfAU
Co-authored-by: Claude <noreply@anthropic.com>
…ly (objectui#11933)

Claude-Session: https://claude.ai/code/session_01MgfduSkFrfM3eorB3UGfAU
Co-authored-by: Claude <noreply@anthropic.com>
…nd too (objectui#11933)

PagePreview's run-mode render handed SchemaRenderer `{ ...draft, type }`
with no `pageType`, so an app or home region page drew as a record page:
record width, no title heading. Its `schema` memo now spreads the same
`pageKindNode` builder PageView and the source-page preview use.

The empty-draft check counted the memo's keys (`<= 1`), which the new
`pageType` key would have moved; it now asks the draft's own keys, a
`type` aside, which is the same predicate the old count expressed.

Pin: PagePreview.pageKind-11933 renders through the real PageRenderer:
app and home draw the title and a non-record width; a record page draws
as the untyped record default; an empty draft, typed or not, still shows
the add-components message. Changeset and the builder's comments name
both previews.

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

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 337 chunks) 3306.7 KB 3312.0 KB
Main entry chunk (gzip) 71.3 KB 350 KB
Entry file index-VHzT3R26.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) 17.82KB 6.58KB
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) 40.70KB 10.94KB
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) 586.28KB 141.14KB
core (index.js) 10.00KB 3.96KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 240.39KB 67.09KB
fields (index.js) 266.92KB 67.47KB
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) 38.37KB 10.31KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.50KB 11.82KB
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) 13.86KB 5.00KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.52KB 2.26KB
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) 53.39KB 15.52KB
plugin-charts (index.js) 84.71KB 23.25KB
plugin-chatbot (index.js) 199.63KB 47.46KB
plugin-dashboard (index.js) 144.82KB 39.17KB
plugin-designer (index.js) 231.46KB 48.87KB
plugin-detail (index.js) 248.57KB 65.47KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 176.62KB 45.75KB
plugin-gantt (index.js) 179.17KB 45.07KB
plugin-grid (index.js) 248.06KB 68.77KB
plugin-kanban (index.js) 52.17KB 16.37KB
plugin-list (index.js) 117.58KB 29.37KB
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.10KB 11.81KB
plugin-tree (index.js) 15.07KB 5.33KB
plugin-view (index.js) 91.07KB 22.93KB
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.81KB 3.58KB
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.08KB 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.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
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.25KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
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

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review October 8, 2026 11:32
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 8, 2026 11:32
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 8, 2026
Merged via the queue into main with commit ccc2824 Oct 8, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-11933-preview-page-type branch October 8, 2026 11:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants