[objectstack-fleet]

Fixes #11388
Clause-②: yes

The three dashboard widget width / height editors now write a whole four-number layout through one shared helper, and the casts past DashboardWidgetSchema['layout'] are gone, so the compiler judges each write.

What changed

• @object-ui/types gains two exports on its main entry, in a new zod-free module dashboard-widget-layout.ts:
  • defaultWidgetPlacement(index): the box the dashboard grid auto-places a widget with no layout in. It is the fallback the spec states in the doc comment of its widget layout member: x: (i % 4) * 3, y: Math.floor(i / 4) * 4, w: 3, h: 4.
  • completeWidgetLayout(layout, patch, placement): the whole box after an edit. Each coordinate comes from the edit, else from the stored layout, else from the placement.
• The three writers all call it, with defaultWidgetPlacement(index) as the placement:
  • app-shell, Studio's DashboardWidgetInspector (width and height inputs);
  • plugin-dashboard, DashboardWithConfig's live writer (handleWidgetFieldChange, for layoutW / layoutH);
  • plugin-designer, DashboardEditor's WidgetPropertyPanel, which now takes the widget's index.
• DashboardGridLayout's buildDefaultLayouts places a widget with no layout through the same defaultWidgetPlacement. Where widgets land does not change. The grid's default is now stated once, and the editors seed from that same statement instead of a copy.
• What the inputs show. Each width / height input, and DashboardWithConfig's two sliders, shows the same completed box the writer stores. For a widget with no layout that box is 3 × 4, where the inputs used to show 1 × 1. Without this, editing the width would store h: 4 while the height input still showed 1. In DashboardWithConfig it would be worse: the slider seed also feeds the save payload, so the live schema would hold h: 4 and the saved layoutH would be 1.
• Docs: a "Writing a widget's layout" section in the @object-ui/types README (its snippet is judged by check:readme-exports), and one paragraph each in the plugin-dashboard README and content/docs/plugins/plugin-dashboard.mdx. Changeset .changeset/11388-widget-layout-complete.md: types minor, app-shell, plugin-dashboard and plugin-designer patch.

Where the helper lives, and the export it adds

I checked each package's package.json. The production @object-ui/* deps that all three writers share are components, core, i18n, react and types. plugin-designer does not depend on plugin-dashboard. @object-ui/types is the lowest of these (core depends on it). It already holds the type the helper returns (DashboardWidgetLayout), and it already exports zod-free runtime helpers from its main entry, so no new dependency edge is added.

Because @object-ui/types is published, this is a new export from a published package's entry point. Under the claim's own condition, its Clause-②: no goes back to the seat to re-judge, so this body carries no Clause-② line. The new module stays clear of packages/types/src/zod/objectql.zod.ts (objectui#11276). The only other types file touched is one export line in src/index.ts, which that branch does not touch.

What each writer can actually see

No writer can see a react-grid-layout placement:

• Studio's preview and DashboardWithConfig both render DashboardRenderer, which places widgets by span and array order and computes no x / y.
• DashboardEditor's own grid places widgets by array order.

So all three seed from defaultWidgetPlacement(index). That is exactly where DashboardGridLayout puts a widget with no layout. Each writer says this in a comment at the call.

Measurements

• Premise (@objectstack/spec 17.5.0, installed): layout: { w: 6 } → REFUSE, invalid_type at layout.x, layout.y, layout.h. { h: 3 } → refused at x, y, w. Four numbers → ACCEPT. No box → ACCEPT.
• Red through each real writer. The three writer files were checked out from base 5ad9f5dc with the new pins kept, all inside an EXIT INT TERM trap. Result: Tests 8 failed | 3 passed. The three that pass are the controls, which hold on both trees. The stored boxes were { w: 6 } (Studio), { h: 2 }, and { w: 2 } (the DashboardWithConfig slider, seeded at 1). The inputs showed '1'. Restored with git checkout HEAD, then confirmed: git diff HEAD empty and all three blob hashes equal HEAD.
• Green: the four pin files, Test Files 4 passed (4), Tests 18 passed (18).
• Reverse type check. I put the cast-free spread back into DashboardEditor ({ ...widget.layout, w: … }) and ran tsc --noEmit: exit 2, TS2322: Type '{ w: number; x?: number | undefined; y?: number | undefined; h?: number | undefined; }' is not assignable to type 'DashboardWidgetLayout'. So the cast was what hid the write. Restored and checked by hash.
• Browser, through the real Studio inspector. Console preview gallery (?only=dashboard), Chromium, no backend. I clicked the kpi_revenue widget (it has no layout), filled Width = 6, and read the stored draft:
  • this branch: inputs 3 / 4 before the edit; stored layout: { x: 0, y: 0, w: 6, h: 4 }; the renderer drew gridColumn: span 6, gridRow: span 4; parsing with the spec gives no layout.* issue, and the box parses on a spec-valid widget.
  • unfixed control (base inspector, same driver): inputs 1 / 1; stored layout: { w: 6 }; the renderer drew gridRow: span undefined; the spec refuses with invalid_type at layout.x, layout.y, layout.h.
• NOT MEASURED: the server leg (Studio save → reload → validate against a backend). The sibling objectstack checkout in this container has no install and no build, and standing up its dev server was outside this run's foreground and shared-box budget. The browser legs above measure the same stored draft up to the point where it would be sent.

Gates

Toolchain: Node v22.22.2 from /opt/nvm via PATH. A plain pnpm install passed engine-strict, with no override.

All gates below were read on head a831be79 (main d59f11c0 merged in).

• Build: turbo run build --filter='@object-ui/app-shell^...' --concurrency=2, 28/28 tasks. This closure contains types, plugin-dashboard and plugin-designer. I used turbo instead of pnpm --filter so a capped run could resume from cache. The other unbuilt packages were then built so check:readme-exports could judge every README.
• type-check for types, plugin-dashboard, plugin-designer and app-shell: all Done, exit 0. Each package's tsconfig.test.json lists its new pin (--listFilesOnly). The consumers read the rebuilt @object-ui/types dist that carries both exports.
• vitest:
  • packages/plugin-dashboard/, packages/plugin-designer/, and the outside suites that import a touched module: Test Files 196 passed (196), Tests 1733 passed | 6 skipped. The outside suites are schema-catalog dashboard-root-title-retired-7624, components inline-locale-label-read-sites, two plugin-charts dashboard suites, and sdui-parser dashboard-widget-options-census.
  • types dashboard-* plus the export-surface and parity pins, and app-shell's Dashboard* inspector / preview suites plus every inspector suite that imports DashboardWidgetInspector: Test Files 31 passed (31), Tests 486 passed (486).
  • A first attempt at the whole packages/types/ plus all of app-shell metadata-admin/ hit the 530 s cap (exit 124). It measured nothing and was narrowed to the set above. CI runs the full set.
• Gates, exit 0 each: check:new-line-citations (0 new citation(s)), check:control-bytes, check-changeset-presence (11 source file(s) of 4 releas…, 1 changeset added), changeset:check, check-changeset-overwrite, check-changeset-claims, check:readme-exports (561 real, 0 wrong-path, 0 fabricated, 0 unbuilt), check-vi-mock-specifiers / -inherit / -override-shape, check-test-path-roots, check:doc-examples, check-doc-snippet-types, check-doc-links, check-doc-fence-languages, check:unreferenced-sources, check:self-import, check:esm-specifiers, check:phantom-deps, check-type-check-coverage, check:eager-closure.
  • Before the merge, these were also exit 0: check:doc-example-ids, check:doc-example-readers, check-doc-component-types, check-doc-expression-carriage, check-lint-coverage, check:published-dist, check:side-effects-array, check:entry-guard, check:spec-symbols.
  • check:node-esm-load exited 1 on provenance: it refused two entries the shared turbo cache replayed from other worktrees (@object-ui/auth, @object-ui/react-runtime). Neither is touched here, and both are NOT MEASURED. Its load leg imported 32 of 39 entries, including @object-ui/types and @object-ui/plugin-designer. app-shell and plugin-dashboard are unbundled-Node unsupported by ruling.
• Lint, narrowed to the changed files. eslint --format json on the 11 changed .ts / .tsx files: 11 results, 0 errors, 31 warnings. The warnings are the same per-file counts base 5ad9f5dc gives the five modified files. The two new files add none.
  • Population: each package's lint is eslint . under the root eslint.config.js.
  • Why the narrowing cannot change another file's verdict: that config enables no type-aware linting (no parserOptions.project / projectService), and no rule in eslint-rules/ reads the filesystem. The full pnpm lint is CI's.
• Governed surface: check-governed-queue-guard --test over the 15 changed paths → NOT GOVERNED.

Acceptance notes

• Two renderers, two defaults. In the positioned grid, DashboardRenderer gives a widget with no layout a span of its own: 3 × 2 for a metric, 6 × 4 otherwise. That is not the spec-stated auto-placement (3 × 4) that DashboardGridLayout uses and that the editors now seed from, though its comment says it matches. One visible effect in Studio: after a width edit, a metric that had no layout gets h: 4, where the preview had drawn it 2 rows tall. Not changed here. Carrier: none.
• DashboardWithConfig's save payload is the documented flattened layoutW / layoutH with no x / y, and the host un-flattens it. Neither objectui nor objectstack has a host for it. The shape is unchanged. For a widget with no layout that the author did not resize, the values are now 3 / 4 where they were 1 / 1. Carrier: none.
• DashboardEditor's addWidget seeds its own complete box (x: 0, y = index, w = columns ?? 2, h: 1). It is spec-valid and not changed here.
• One existing pin was touched. The map-title round trip in DashboardWidgetInspector.test.tsx used "height = 4" as its unrelated edit. The input now shows 4 for a widget with no layout, so that edit fired no change. It now edits 2, with a comment saying why.

Session: https://claude.ai/code/session_01JG2jy8a9su7ia4Hx7zxv42 (seat domain:ui#2, claim on the card).

---

Generated by Claude Code

[github-actions]

changeset-claim-re-read

⚠️ 4 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/6051-gantt-flat-config-declared-keys.md

• names packages/types/src/index.ts → packages/types/src/index.ts — edited by this change

  GanttConfig itself gains nine members and is a published type, exported by name from packages/types/src/index.ts: lockField, objectField, summaryExtent, defaultCollapsedDepth, borderColorField, dependencyTypes, timeZone, exportFileName, interactions. The entry file's diff is empty only because the export list already named the type — the widening happened at the declaration.

.changeset/8114-detail-tab-activity-timeline.md

• names plugin-dashboard/README.md → packages/plugin-dashboard/README.md — edited by this change

  README.md ships in this package's files, so the example went out in every tarball. DetailTabs renders a tab's content through ANGLE-BRACKETS(SchemaRenderer schema={toRenderableSchema(tab.content)} /), which makes content.type an SDUI node position judged by the component registry — so a reader copying the tab got the registry's Unknown component type panel (OBJUI-001) where the timeline should be. Same shape as the line-chart widget in plugin-dashboard/README.md (objectui#7896's census; fixed by objectui#7951) and the fourth known instance.

.changeset/8760-unfulfilled-chart-stubs.md

• names content/docs/plugins/plugin-dashboard.mdx → content/docs/plugins/plugin-dashboard.mdx — edited by this change

  • At render. SchemaRenderer's lazy branch re-checks hasLazy(type) on every pass and returns the Loading ANGLE-BRACKETS(type)… placeholder. Registry.register() deletes a lazy entry only for keys the loaded module actually registers, so for an unfulfilled key the entry SURVIVES the load and every later pass takes the same branch. Measured on b775500af through the real chain: { "type": "line-chart" } painted role="status" / data-lazy-loading="line-chart" / Loading line-chart…, permanently. Not the OBJUI-001 panel the card expected — no alert, no error, no console warning. A skeleton that never resolves reads to a user as a slow network. - At authoring. A stub is enough to put a key into getKnownTypes(), so check:doc-types and the CLI's generated KNOWN_SCHEMA_TYPES snapshot both blessed all three. content/docs/plugins/plugin-dashboard.mdx taught "type": "line-chart" inside a card body, and every gate was green on it.

.changeset/component-meta-converge-and-deprecate-alias-5893.md

• names packages/types/src/index.ts → packages/types/src/index.ts — edited by this change

  ⚠️ Dated note, 2026-09-29 — the one-occurrence reading above has since moved — objectui#10979. "In-repo, PluginComponentMeta has exactly one occurrence — its own export line" above is the reading of the commit this change landed on (575b71c850), where a whole-tree search for the name returned that one line, in packages/types/src/index.ts. This change then added its own pins and this entry, and later in this same release objectui#5674's retirement of the sibling alias PluginComponentInput (PR objectui#10826) added mentions in its test and its entry. Re-measured on main at 2eaf5be27, the name occurred on 19 lines in 7 files. In non-test source it appeared only on the export line and on one doc-comment line in plugin-scope.ts, and the one file that imported it was this change's own component-meta-single-declaration.test.ts. The text above is kept as the reading of this change.

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.

Angle-bracketed names in the quoted prose above are rewritten as ANGLE-BRACKETS(name): GitHub deletes tag-shaped fragments from a stored body, and a quote that silently loses the identifier it is about is worse than a visible repair.

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

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Eager closure (gzip, 330 chunks)	3552.8 KB	3574.6 KB
Main entry chunk (gzip)	150.3 KB	350 KB
Entry file	index-BKMtPNNZ.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.88KB	6.25KB
app-shell (runtime-config.js)	20.68KB	7.36KB
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.17KB	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.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)	570.62KB	136.73KB
core (index.js)	10.00KB	3.96KB
create-plugin (index.js)	27.94KB	9.51KB
data-objectstack (index.js)	230.46KB	63.94KB
fields (index.js)	260.89KB	66.19KB
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.35KB	12.88KB
i18n (translateFn.js)	0.20KB	0.18KB
i18n (useDisplayLocale.js)	3.52KB	1.76KB
i18n (useObjectLabel.js)	34.49KB	9.23KB
i18n (useSafeTranslation.js)	5.60KB	2.33KB
layout (index.js)	40.15KB	11.34KB
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.01KB	3.93KB
plugin-calendar (index.js)	53.15KB	15.45KB
plugin-charts (index.js)	84.07KB	22.93KB
plugin-chatbot (index.js)	198.22KB	46.97KB
plugin-dashboard (index.js)	139.77KB	37.47KB
plugin-designer (index.js)	216.57KB	44.72KB
plugin-detail (index.js)	245.70KB	64.54KB
plugin-editor (index.js)	2.23KB	1.05KB
plugin-form (index.js)	173.14KB	44.58KB
plugin-gantt (index.js)	178.11KB	44.87KB
plugin-grid (index.js)	231.72KB	63.65KB
plugin-kanban (index.js)	49.49KB	15.54KB
plugin-list (index.js)	116.63KB	28.97KB
plugin-map (index.js)	25.60KB	8.62KB
plugin-markdown (index.js)	13.88KB	4.80KB
plugin-report (index.js)	44.04KB	12.21KB
plugin-timeline (index.js)	34.29KB	10.13KB
plugin-tree (index.js)	14.58KB	5.17KB
plugin-view (index.js)	90.32KB	22.76KB
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.25KB	2.04KB
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)	6.06KB	2.68KB
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)	21.42KB	7.05KB
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 (complex.js)	3.19KB	1.62KB
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)	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)	5.07KB	2.39KB
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)	4.99KB	1.96KB
types (spec-ui-namespace.js)	0.20KB	0.19KB
types (strict-authoring-face.js)	21.59KB	7.71KB
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