fix(plugin-grid): group-header labels read the object field's options only; the column options read is retired (objectui#11544)

[objectstack-fleet]

Fixes #11544

Clause-②: no

Retire, not widen (triage ruling 5966937083): a grouped object-grid labels its group headers from the object field's options only. ListColumnSchema declares no options and is strict, so the column-level read honoured a key every publish refuses. Session session_01FjqrwXPfSMkSfkKYDSRkN2, branch claude/issue-11544-group-header-field-options.

What changed

• packages/plugin-grid/src/ObjectGrid.tsx, groupValueFormatter: the label source colOverride?.options || objectDefField?.options is now objectDefField?.options. The column lookup stays, because it also supplies type, a declared ListColumn member (a boolean column respells "true" / "false" as Yes / No). The lookup is now typed as ListColumn, with the same c is ListColumn guard maskedGroupingSignature already uses, instead of as any[]. As a result, an undeclared column-member read at this site no longer compiles (proved below).
• packages/plugin-grid/src/__tests__/gridGroupingMembers-8071.test.tsx: the two cases that pinned columns[].options as behaviour are turned to pin the field's labels:
  • "the object field's options decide the header label, and a column options beside them is not read". It has three legs. The field's labels reach the header. A column carrying options beside the field's still shows the FIELD's labels. The same column with no field options shows the stored values.
  • "order sorts the RENDERED labels, so the field's options move the groups". This is order: 'asc' over the field's labels, with a no-field-labels control.
  • The header note ("pinned below AS BEHAVIOUR and reported as a finding") is rewritten to say the read is retired. renderGrouped now takes the host objectFields runtime prop, which is how field options reach an inline-rows grid without a schema read.
• apps/console/src/__tests__/registry-inputs-spec-parity.test.ts: the object-grid.grouping pins descriptor follows the fixture; it had said the read was pinned as behaviour and not repaired. This is the move PR feat(types,plugin-grid)!: object-grid and list-view conditionalFormatting take the spec list view's { condition, style } rule only; the native dialect is refused by name (objectui#11533) #11540 made to its own descriptor. It is text only: nothing asserts on pins content.
• .changeset/11544-group-header-field-options.md: @object-ui/plugin-grid patch.

Premise, measured on origin/main d0c0c7fe9 (after PR #11554)

• @objectstack/spec 17.6.0 ListColumnSchema has fourteen keys (field, label, width, align, hidden, sortable, resizable, wrap, type, pinned, summary, prefix, link, action). safeParse({ field, options }) answers unrecognized_keys naming options, and the control { field, type: 'select' } parses.
• objectui ObjectGridSchema.safeParse with a column options answers invalid_union at columns, and the same grid with a column type parses.
• One read site. A grep for .options in ObjectGrid.tsx finds only the groupValueFormatter line reading it off a column; every other hit reads a field. A repo grep for the column-override lookup finds only this memo. Other col.options hits (GridField, RecordPickerDialog, the flow inspector) read different column schemas, not ListColumn, and none of them labels a group.
• In-repo producers of column options: none. The options spreads in app-shell build detail-form fields and import targets, not grid columns.
• PM hypothesis 1 ("the now-unused column lookup is removed if nothing else in the memo needs it") is half-falsified: type needs the lookup, so it stays, typed.

Tests (HEAD 92bddae)

• Fixture plus parity ledger: pnpm exec vitest run --maxWorkers=2 packages/plugin-grid/src/__tests__/gridGroupingMembers-8071.test.tsx apps/console/src/__tests__/registry-inputs-spec-parity.test.ts gives Test Files 2 passed (2) and Tests 265 passed (265).
• Whole package: pnpm exec vitest run --maxWorkers=2 packages/plugin-grid/ gives Test Files 182 passed (182) and Tests 1691 passed (1691).
• pnpm --filter @object-ui/plugin-grid type-check (tsc --noEmit && tsc -p tsconfig.test.json) exits 0. --listFiles on tsconfig.test.json lists the fixture once and ObjectGrid.tsx once.
• Dependency closure: pnpm --workspace-concurrency=2 --filter '@object-ui/plugin-grid^...' build exits 0.

Ablation (one-shot, run from the committed fix through objectstack's scripts/ablation-replace.mjs in wrap mode)

• Behaviour. Anchor const rawOptions = objectDefField?.options;, replaced with const rawOptions = (colOverride as any)?.options || objectDefField?.options; (anchor count 1 to 0, blob 004444984f55 to 316153fc4622). Predicted: the label case goes red and everything else stays green. Observed: Tests 1 failed | 9 passed (10), expected [ 'Column Lost', 'Column Won' ] to deeply equal [ 'Closed Lost', 'Closed Won' ]. Restore: blob equals HEAD, and git diff HEAD is empty.
• Type. The same anchor, replaced with const rawOptions = colOverride?.options || objectDefField?.options;. tsc --noEmit gives error TS2339: Property 'options' does not exist on type (the ListColumn object shape). Restore: blob equals HEAD.
• The order case stays green under the behaviour ablation by design. It carries no column options; it pins that order sorts the field's labels, which both trees do.

Gates (HEAD 92bddae, each exit 0)

• pnpm check:control-bytes: check-control-bytes: OK.
• pnpm check:new-line-citations: VERDICT new-cross-file-line-citations: 0 new citation(s).
• node scripts/check-changeset-presence.mjs: 3 source file(s) of 2 released package(s) changed, and this change declares 1 changeset(s).
• node scripts/check-changeset-no-major.mjs, check-changeset-fixed.mjs and check-changeset-overwrite.mjs: all report OK.
• pnpm check:changeset-claims is report-only. It names six pending changesets that mention ObjectGrid.tsx or the parity ledger. I re-read each paragraph, and none makes a claim about group-header labels or column options.
• pnpm check:pending-changeset-literals: No test source names a pending changeset.
• pnpm check:test-path-roots, node scripts/check-vi-mock-specifiers.mjs, node scripts/check-vi-mock-inherit.mjs, pnpm check:spec-symbols and node scripts/check-type-check-coverage.mjs: all report OK.

Narrowings (declared)

• Lint (CI-owned). A narrowed run over the three changed source files. The population is from eslint's own config: eslint --print-config resolves all three, so none is ignored. --format json counts 3 files. eslint.config.js sets no parserOptions.project / projectService, so type-aware linting is off, and this diff cannot move an untouched file's verdict. In package form (inline config honoured, as pnpm lint runs it): 0 errors. In root --no-inline-config form: 1 error, react-hooks/static-components, at the annotated AuthoredEmptyIcon site. It is identical at BASE (BASE 1 error / 210 warnings, head 1 / 209).
• Build-reading gates (check:published-dist, check:node-esm-load, check:phantom-deps and the rest) and the full sharded pnpm test belong to CI. This diff adds no import, export or dependency.

Acceptance notes

• The parity ledger's slice-17 history paragraph, which says the group-label memo reads columns[].options, is left as written. It records what that slice did, the way a changelog entry does. Only the live pins descriptor changed.
• No doc page or README described the column-options read (grep of content/docs and packages/plugin-grid/README.md), so there is no doc edit.
• The parity ledger is a shared file. This PR edits one string in its object-grid.grouping entry.
• objectstack#21464 types columns by reference once its .objectui-sha covers this landing. That stays on objectstack#21464, per triage.

---

Generated by Claude Code

[github-actions]

changeset-claim-re-read

⚠️ 6 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/4730-retire-dead-locale-key-batch.md

• names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

  • Superseded twin vocabularies. cellRender.* and rowAction.* duplicated a grid.* vocabulary that won. RowActionMenu.tsx is fully i18n-wired and reads grid.openMenu / grid.edit / grid.delete; ObjectGrid.tsx reads grid.empty / grid.yes / grid.no / grid.systemFields. The twins had no reader on either side. - Labels that outlived their control. calendar.agenda labelled a view mode b55a34647 retired from CalendarViewMode (now 'month' | 'week' | 'day'). home.quickActions.createApp*, layout.systemNav.createApp, actionDialog.defaultActionTitle / .ok and grid.bulk.selectPlaceholder sit in namespaces whose consumers are live and wired but demonstrably read other siblings. - Surfaces that left the product. map.* is the strongest form: @object-ui/plugin-map declares no @object-ui/i18n dependency and contains no t() call at all, so it cannot consume a locale string. home.stats.* and recordDetail.viewersTooltip name surfaces nothing renders.

.changeset/6597-retire-fieldmeta-referenceto.md

• names plugin-grid/src/ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

  No authoring story survived the search either. ObjectGrid's own relational-meta pass-through (applyRelationalMeta, plugin-grid/src/ObjectGrid.tsx) copies reference_to / reference / display_field / etc. from the SCHEMA field def only, at all three of its call sites — never from an authored column override. No doc, example, or fixture in this repo shows a table column pinning a lookup's target away from what its schema field already says. Under the maintainer's standing startup-stage rule (2026-08-27: deprecated/alias spellings retire immediately, no transition windows), no measured demand selects withdraw.

.changeset/7762-object-grid-export-options-bare-array-refusal.md

• names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

  What was measured, on this branch's base. The mirror declared NO exportOptions member at all, and BaseSchema is .passthrough(), so ObjectGridSchema.safeParse({ type: 'object-grid', objectName: 'accounts', exportOptions: ['csv', 'xlsx'] }) returned success: true with the array back VERBATIM — as did { formats: ['csv', 'pdf'], compression: 'gzip' }. Nothing on the render path parses, and ObjectGrid.tsx reads schema.exportOptions?.formats and only that, so the authored array then lost SILENTLY to the ['csv', 'json'] default: the useEffect that warns about dropped formats reads .formats too and returns early when it is absent, while !!schema.exportOptions kept the export button on screen. An author declared ['csv', 'xlsx'] and got csv/json with no error, no warning and no console line. The two authoring faces disagreed in the direction opposite to objectui#6956's: the TypeScript interface already declared the object form only, so TS refused what zod admitted.

.changeset/8067-component-input-member-kind.md

• names apps/console/src/__tests__/registry-inputs-spec-parity.test.ts → apps/console/src/__tests__/registry-inputs-spec-parity.test.ts — edited by this change

  A registration's type: 'array' said a value was a list and stopped there, so a member that drifted from @objectstack/spec was invisible to every layer that reads a declaration. page:header.actions is the measured cost: the contract declares z.array(z.string()) ("Action IDs"), the renderer read the members as ActionDef objects, and the repo-wide parity gate in apps/console/src/__tests__/registry-inputs-spec-parity.test.ts stayed green for the whole life of the drift because both sides carried the key and neither could say what was inside it. What settled it was a maintainer ruling, not a test — and even after the fix, "these are ids" survived only as English in the registration's description.

.changeset/9722-bulk-executor-datasource-face.md

• names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

  • ObjectGrid.tsx → RecordDetailPanel: removing it type-checks GREEN. It was paying for nothing — both sides already declare the same DataSource | undefined from @object-ui/types. Removed outright. - ObjectGrid.tsx → BulkActionDialog: removing it reddens, and it was paying for TWO things at once — the optional-vs-required arm (the grid declares dataSource?: DataSource, the dialog demands one) AND the bulk-door contravariance. Only the first still needs erasing, so it is now a non-null assertion: today's runtime behaviour is preserved exactly, and any future drift of the face reddens at that site instead of passing silently.

.changeset/9853-grid-non-positive-page-size.md

• names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

  Refuse a non-positive pageSize at all three of ObjectGrid.tsx's read points, instead of giving two different answers for one authored value (objectui#9853).

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 806f32726 (merge-base with origin/main): 3 file(s) changed outside .changeset/, read against 2086 pending declaration(s) that publish a body (2721 pending in total). · run

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Eager closure (gzip, 330 chunks)	3308.6 KB	3330.4 KB
Main entry chunk (gzip)	150.4 KB	350 KB
Entry file	index-BO0hC7ot.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.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)	572.97KB	137.34KB
core (index.js)	10.00KB	3.96KB
create-plugin (index.js)	27.94KB	9.51KB
data-objectstack (index.js)	232.57KB	64.51KB
fields (index.js)	261.62KB	66.20KB
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)	35.66KB	9.49KB
i18n (useSafeTranslation.js)	7.14KB	2.92KB
layout (index.js)	39.47KB	11.25KB
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.17KB	15.46KB
plugin-charts (index.js)	83.60KB	22.89KB
plugin-chatbot (index.js)	198.22KB	46.97KB
plugin-dashboard (index.js)	142.26KB	38.44KB
plugin-designer (index.js)	231.28KB	48.76KB
plugin-detail (index.js)	245.59KB	64.56KB
plugin-editor (index.js)	2.23KB	1.05KB
plugin-form (index.js)	172.96KB	44.52KB
plugin-gantt (index.js)	179.16KB	45.06KB
plugin-grid (index.js)	235.02KB	64.63KB
plugin-kanban (index.js)	49.59KB	15.58KB
plugin-list (index.js)	116.46KB	28.93KB
plugin-map (index.js)	25.60KB	8.62KB
plugin-markdown (index.js)	13.88KB	4.80KB
plugin-report (index.js)	44.12KB	12.29KB
plugin-timeline (index.js)	38.80KB	11.71KB
plugin-tree (index.js)	14.51KB	5.15KB
plugin-view (index.js)	90.23KB	22.73KB
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 (cloud.js)	0.20KB	0.18KB
types (complex.js)	4.16KB	1.96KB
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)	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