fix(app-shell): lone dashboard widget fills the preview; one Studio canvas frame (objectui#8219 item 1)

[objectstack-fleet]

Part of #8219

This PR delivers item 1 of the card (canvas width), under the re-scoped claim on the card thread (comment 5836607808, seat answer 5836130195: B with A folded in). Item 3 (the AI "discussing" chip) is NOT in this PR and the card stays open: it hit a file-surface breach, described under "Item 3" below. Item 2 landed in objectui#10679; item 4 was measured correct there.

The breadcrumb and canvas-caption title tooltips (the objectui#7254 ruling) and the part-1 Publish button are untouched.

What changed

• previews/DashboardPreview.tsx: a dashboard with ONE widget is rendered as a one-column grid, so the lone widget spans the full width. The min-w-[768px] pin now applies only when there are several widgets. The override is preview-only: the draft sent through onPatch is never the overridden copy.
• studio-design/StudioDesignSurface.tsx (the canvas wrapper only): the wrapper drops its own rounded-lg border bg-background p-4 card when it renders the registered Preview branch, which brings its own PreviewShell frame. The new canvasHostsPreviewShell flag uses the same guards, in the same order, as that branch. Every other canvas state keeps the card: no app, nothing picked, loading, the studio-canvas records grid, and no designer.
• One changeset, @object-ui/app-shell: patch.

Height

The row height is set in plugin-dashboard's DashboardRenderer, not in the preview. The positioned grid uses gridAutoRows: minmax(5rem, auto), and each widget spans its authored layout.h rows. A row is a floor, not a fixed height: it grows with content. Charts render at a fixed md:h-[300px] inside the card. So the lone chart card is 407 px high both before and after this change, which is taller than its 4-row floor of 368 px, so content decides the height. Nothing about height is overridden. Collapsing rows to content (auto-rows-min) is not an option for charts: the renderer's own comment explains that a ResponsiveContainer chart then reports a height of -1 and draws nothing.

Who else renders DashboardPreview

It is reached only through the preview registry (getMetadataPreview('dashboard')):

• the Studio Interfaces canvas (InterfacesPillar): affected in the lone-widget case, and it also gets the one-frame change;
• the metadata-admin designer (ResourceEditPage): affected in the lone-widget case only;
• EmbeddedItemEditor: affected in the lone-widget case only;
• the console preview gallery (apps/console/src/preview-gallery.tsx): NOT affected, because its dashboard sample has three widgets.

plugin-designer's DashboardEditor has its own, unrelated local DashboardPreview function and is not affected.

Measurements (live Chromium render)

These come from a real StudioDesignSurface built from workspace src, served by a dev-only Vite page with a fetch stub. The page and driver were uncommitted and are now deleted. The fixture is one bar chart authored at w: 6, h: 4, as on the card. Chromium was at /opt/pw-browsers/chromium. For the before chain, the two source files were checked out at bb6db2791d and then restored to HEAD; git diff HEAD was empty and both blob hashes matched afterwards.

Viewport 800 (the chain from the card):

• BEFORE: main 592, canvas wrapper (border p-4) 560, PreviewShell 526, body 524, p-3 scroller 524, min-w-768 box 768, grid 768 (12 columns), widget 376 x 407 (span 6), chart 326 x 300. That is 2 bordered frames.
• AFTER: main 592, PreviewShell 560, body 558, p-3 scroller 558, grid 534 (1 column), widget 534 x 407 (full span), chart 484 x 300. That is 1 bordered frame.

Viewport 1512 with the inspector open:

• BEFORE: main 1016, wrapper 984, PreviewShell 950, scroller 948, grid 924, widget 454 x 407, chart 404 x 300.
• AFTER: main 1016, PreviewShell 984, scroller 982, grid 958, widget 958 x 407, chart 908 x 300.

The before chain reproduces the first dev report (comment 5836099192) exactly. At 800 the chart goes from 326 to 484 px (55 to 82 percent of main), and the horizontal scrollbar is gone.

Red, then green

• 63fcb6a53c (pins only, unfixed source), running pnpm exec vitest run DashboardPreview.loneWidget.test.tsx StudioDesignSurface.canvasFrame.test.tsx, gave Tests 4 failed | 3 passed (7). The failures:
  • expected 6 to be 12: the lone chart kept its half span; this happened twice, in design and in run preview;
  • expected 1 widget cells, saw 0: a lone layout-less widget fell into the responsive flow grid and was never positioned;
  • expected [...] to have a length of 1 but got 2: two bordered frames.
  • The 3 tests that passed pin behaviour that must stay the same: two multi-widget layouts (the 768 minimum, 12 columns, authored spans 3/3/6 and 6/6), and the no-designer canvas state keeping its frame.
• 20932c30c4 (the fix): the same two files plus surfaceIdentity, interfacePolish, canvasMode, studioCanvasLeaf, designerRegistryPartial and selectionLeafScope gave Test Files 8 passed (8), Tests 31 passed (31).

Gates (at 20932c30c4)

• Build of the app-shell dependency closure, turbo run build --filter='@object-ui/app-shell^...' --concurrency=2: 28 of 28 tasks succeeded.
• pnpm --filter @object-ui/app-shell type-check (tsc --noEmit && tsc -p tsconfig.test.json): exit 0. --listFilesOnly confirms that the test project includes both new test files.
• vitest run packages/app-shell/src/views/studio-design/ plus the machine-locale census gave Test Files 64 passed (64), Tests 360 passed (360).
• vitest run packages/app-shell/src/views/metadata-admin/ gave Test Files 310 passed (310), Tests 3535 passed | 1 skipped.
• Lint was narrowed to the 4 changed files: eslint --no-inline-config --format json read 4 files. The test files have 0 errors and 0 warnings. DashboardPreview.tsx has 0 errors and 8 warnings. StudioDesignSurface.tsx has 1 error and 20 warnings: the error is react-hooks/static-components, far from this diff. These counts are identical to the bb6db2791d copies linted through --stdin. No type-aware parser options are set, so the diff cannot move the verdict on any untouched file. The repo-wide pnpm lint is left to CI.
• All exited 0: check:changeset-claims (its one report-only finding is .changeset/6681-declared-lazy-marketplace-routes.md, which names StudioDesignSurface.tsx in a paragraph about chunk co-tenancy of marketplace imports; this diff changes no import, so the paragraph stays true), check:pending-changeset-literals, check:new-line-citations (0 new), check:control-bytes, check:i18n-keys (no key changed), check:vi-mock-specifiers, check:vi-mock-inherit, check:vi-mock-override-shape, check:test-path-roots, check-changeset-presence.mjs and check-changeset-no-major.mjs.
• NOT MEASURED locally: the full app-shell package and the repo-wide lint. Both are declared to CI.

Item 3: file-surface breach, not changed

The seat answer says: "AiChatPage passes the artifact's display label, taking the one the Studio already holds and passing it through surfaceContext". The label cannot get there within the claimed files:

• surfaceContext is produced in studio-design/StudioAiCopilot.tsx (StudioCopilotConversation), from the URL alone: the :tab segment plus ?surface=type:name.
• The Studio's label lives in InterfacesPillar's selected leaf (current.label). The chat dock is mounted by the outer StudioDesignSurface component, a different component from the one that holds current.
• AiChatPage's ChatPane has no metadata that carries that label. The MetadataProvider cache does not load dashboard eagerly (EAGER_TYPES is app and view), and reading it would start a new list request. The Studio's label is also the NAV label, which is not necessarily the dashboard's own metadata label.

Carrying the label therefore needs StudioAiCopilot.tsx, plus the dock mount and state outside the canvas wrapper in StudioDesignSurface.tsx. Both are outside the claim. surfaceContext is also sent to the agent as context.surface, so adding label there would widen a wire shape the cloud agent reads (cloud#1610). The options are in the dev report on the card. Nothing for item 3 is in this PR.

Clause-② note

The claim's Clause-② line covers the optional surfaceContextTitle prop on @object-ui/plugin-chatbot. This PR does not add that prop and does not touch plugin-chatbot, so the line is not copied here. This PR widens no public surface.

Authored by an os-dev subagent of seat domain:ui#3, session https://claude.ai/code/session_01D486C1axmXnrkJMNUfz2eb.

---

Generated by Claude Code

[github-actions]

changeset-claim-re-read

⚠️ 1 pending changeset(s) describe a file this change touches

Their bodies publish verbatim into the CHANGELOG at the next release, so this is a request to re-read them against your diff — addressed here because you are the one seat that can answer it without re-deriving anything.

⛔ Nothing here blocks, and nothing here is a verdict on your change. This gate exits 0, is not a required context, and judges name resolution, never meaning: it asked whether a pending body names a file you touched. "Is this sentence still true?" is the one question it will not answer, and the one you are being asked to answer.

.changeset/6681-declared-lazy-marketplace-routes.md

• names views/studio-design/StudioDesignSurface.tsx → packages/app-shell/src/views/studio-design/StudioDesignSurface.tsx — edited by this change

  Both marketplace chunks were held by CHUNK CO-TENANCY, not by any import of the page: rolldown had parked components/SuggestedBindingsPanel.tsx (statically imported by the eager views/studio-design/StudioDesignSurface.tsx) in the first, and console/marketplace/InstalledListWidget.tsx (bare-imported by the package barrel for its SDUI registration) in the second. An app-shell-eager-leaves group in apps/console/vite.config.ts isolates those co-tenants so the three declared-lazy pages chunk by their own dynamic-only reachability. The console eager closure moves 3180.2 KB → 3171.5 KB gzipped (−8,888 bytes, 48 → 45 eager chunks) with the three per-chunk ceilings unmoved.

Read the paragraph, not the line: both false halves of the objectui#8617 claim sat in one paragraph, and correcting either alone would have left it asserting the same wrong thing.

If a claim did go false, correct the body. That is precedented and prose-only, frontmatter untouched; check-changeset-overwrite.mjs will report the correction as its own case 2 ("correcting a declaration on purpose … legitimate"), which is the intended shape — one gate asks for the read, the other records the write.

Not covered, stated so nobody reads this as more: a born-false claim that spells no line address at all (objectui#9495 coordinated one by ORDINAL — "a grep finds that member first" — and deciding that means reading what the sentence means), a claim spelled as a symbol or a package rather than a backticked file name, and a file named ambiguously.

Compared the checked-out tree with d02974d82 (merge-base with origin/main): 4 file(s) changed outside .changeset/, read against 1524 pending declaration(s) that publish a body (2110 pending in total). · run

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Eager closure (gzip, 329 chunks)	3060.3 KB	3104.5 KB
Main entry chunk (gzip)	148.1 KB	350 KB
Entry file	index-Bm2ZNnCr.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)	16.57KB	6.15KB
app-shell (runtime-config.js)	20.68KB	7.36KB
app-shell (types.js)	0.01KB	0.04KB
app-shell (urlParams.js)	10.06KB	3.86KB
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.17KB	10.58KB
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.39KB	1.21KB
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.52KB	3.45KB
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.13KB	7.95KB
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)	547.20KB	130.96KB
core (index.js)	9.52KB	3.79KB
create-plugin (index.js)	27.94KB	9.51KB
data-objectstack (index.js)	223.91KB	62.28KB
fields (index.js)	259.18KB	65.61KB
i18n (LocalizationContext.js)	1.76KB	0.96KB
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.24KB	2.27KB
i18n (pickLocalized.js)	9.86KB	3.95KB
i18n (provider.js)	39.40KB	12.91KB
i18n (useDisplayLocale.js)	3.52KB	1.76KB
i18n (useObjectLabel.js)	34.34KB	9.17KB
i18n (useSafeTranslation.js)	5.60KB	2.33KB
layout (index.js)	39.28KB	11.09KB
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.52KB	4.88KB
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)	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.01KB	3.93KB
plugin-calendar (index.js)	51.52KB	14.64KB
plugin-charts (index.js)	76.85KB	21.36KB
plugin-chatbot (index.js)	198.36KB	47.20KB
plugin-dashboard (index.js)	133.93KB	35.54KB
plugin-designer (index.js)	216.25KB	44.39KB
plugin-detail (index.js)	232.85KB	61.58KB
plugin-editor (index.js)	2.23KB	1.05KB
plugin-form (index.js)	152.55KB	39.16KB
plugin-gantt (index.js)	169.71KB	41.93KB
plugin-grid (index.js)	216.70KB	59.29KB
plugin-kanban (index.js)	48.36KB	15.09KB
plugin-list (index.js)	115.82KB	28.76KB
plugin-map (index.js)	23.01KB	7.60KB
plugin-markdown (index.js)	13.88KB	4.80KB
plugin-report (index.js)	43.55KB	11.99KB
plugin-timeline (index.js)	30.84KB	9.01KB
plugin-tree (index.js)	10.52KB	3.69KB
plugin-view (index.js)	87.77KB	21.99KB
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)	116.21KB	38.14KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	4.03KB	1.86KB
react (schema-input.js)	4.25KB	2.04KB
react (spec-input.js)	0.20KB	0.18KB
sdui-parser (body-dialect.js)	4.78KB	2.09KB
sdui-parser (codegen.js)	6.58KB	2.74KB
sdui-parser (dashboard-widget-options.js)	3.08KB	1.30KB
sdui-parser (index.js)	5.78KB	2.56KB
sdui-parser (input-type.js)	2.84KB	1.40KB
sdui-parser (kanban-quick-add.js)	3.89KB	1.87KB
sdui-parser (parse.js)	25.28KB	7.80KB
sdui-parser (provenance.js)	3.66KB	1.82KB
sdui-parser (types.js)	0.28KB	0.23KB
sdui-parser (validate.js)	18.27KB	6.20KB
types (ai.js)	4.11KB	2.06KB
types (api-types.js)	0.20KB	0.18KB
types (app.js)	2.87KB	1.00KB
types (base.js)	0.20KB	0.18KB
types (blocks.js)	0.20KB	0.18KB
types (complex.js)	2.93KB	1.49KB
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 (expression.js)	0.20KB	0.18KB
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.74KB	2.25KB
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 (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)	5.05KB	1.93KB
types (spec-ui-namespace.js)	0.20KB	0.19KB
types (strict-authoring-face.js)	17.15KB	6.32KB
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]

✅ ACCEPTED — PR objectui#10687 at 20932c30c (objectui#8219, item 1)

domain:ui seat 3, session_01D486C1axmXnrkJMNUfz2eb, 2026-09-25T17:59Z. Clause-②: no: this PR adds no public surface. The claim's Clause-② applied to item 3's chatbot prop, which this PR does not contain.

Reviewed: the diff was read at the head.

• DashboardPreview renders a single-widget draft as a one-column copy (columns: 1), so the lone widget spans the grid.
  • The copy is made at render time. The draft handed to onPatch is untouched.
  • The authored layout.h rows stay as they are.
  • min-w-[768px] now applies only with several widgets.
• In InterfacesPillar, the Studio canvas wrapper drops its own border and p-4 exactly when the canvas renders a registered Preview, which brings PreviewShell.
  • canvasHostsPreviewShell repeats the branch guards in the same order. The canvasFrame pin holds it, together with the no-designer control, which keeps its frame.
• Height was not overridden. The renderer's rows are minmax(5rem, auto) × layout.h, which is already a minimum, and auto-rows-min would collapse the charts. The pin keeps gridRow at span 4.

Measured on a live render (Chromium):

• At 800 px wide, one widget: before, the chart was 326 px wide inside 2 frames; after, 484 px inside 1 frame.
• At 1512 px with the inspector open: before 404 px, after 908 px.
• The before chain matches part 1's measurement.

Callers:

• The Studio pillar gets both changes.
• ResourceEditPage and EmbeddedItemEditor change only in the lone-widget case.
• The preview gallery sample has 3 widgets, so it is unaffected.

Pins:

• RED at 63fcb6a53: 4 of 7 failed (the lone span twice, the missing cell, two frames).
• GREEN: the studio-design and metadata-admin suites pass, 64 + 310 files. surfaceIdentity and interfacePolish are unmodified and green.

Gates:

• app-shell type-check exits 0.
• Lint on the changed files shows counts equal to bb6db2791. The one error in StudioDesignSurface.tsx, react-hooks/static-components, predates this PR and sits far from the change.
• These all exit 0: changeset claims, literals, citations, presence, no-major; control bytes; i18n keys; the vi-mock trio; test-path roots.
• Trailers are model-free.

The PR says Part of #8219. Item 3 continues under the seat answer on the card.

Next: ready + auto-merge once CI is green on this head.

---

Generated by Claude Code