Skip to content

feat(plugin-form): derive the per-row form's fields and its offer through the spec rule deriveInlineRowFormFields / isInlineRowFormOffered (objectui#11428) - #11756

Merged
objectstack-fleet[bot] merged 3 commits into
mainfrom
claude/issue-11428-inline-row-form-spec-derivation
Oct 7, 2026
Merged

objectstack-fleet[bot] merged 3 commits into
mainfrom
claude/issue-11428-inline-row-form-spec-derivation

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11428

Clause-②: no

What this PR is

The per-row expand form of an inline master-detail collection now takes both of its rules from @objectstack/spec/data, as the collection's grid columns already do (objectui#11345):

  • Which fields. deriveFormFields returns deriveInlineRowFormFields(childSchema, { relationshipField, exclude }). objectui's own per-field rendering over the returned names is unchanged: the row form still renders each name through ObjectForm.
  • Whether a row offers the form. MasterDetailForm replaces its hand-written offer expression with isInlineRowFormOffered({ inlineMode, formFields, columns }), asked with the collection's resolved values, authored or derived.

Deleted from packages/plugin-form/src/deriveMasterDetail.ts: SYSTEM_FIELDS and NON_INPUT_TYPES, which only deriveFormFields read. SORT_FIELD_NAMES stays, because the sort-field pick in deriveDetail still reads it.

The direction is triage's first grade (comment 5944853069), unlocked at 17.7.0 (comment 6029278659). The default record form in ObjectForm.tsx is not touched; it waits on objectstack-ai/objectstack#21281.

The fence

  • deriveFormFields keeps its signature. The built dist/deriveMasterDetail.d.ts before (BASE c0862c1) and after differ only in that function's doc comment, and dist/MasterDetailForm.d.ts is byte-identical. No export, prop, type member or i18n key is added to any @object-ui/* package, which is why Clause-②: no stands.
  • The output does not change on any input the evidence below reached.

Landing site, and one addition to the claimed file surface

The landing sites are the claimed ones: deriveMasterDetail.ts, MasterDetailForm.tsx, two tests beside them, and .changeset/11428-inline-row-form-spec-rule.md.

Outside the claim's declared surface, as the unlock comment directs ("any other importer raises its own floor, and the PR says so"): packages/plugin-form/package.json (@objectstack/spec goes from ^17.6.0 to ^17.7.0) and that importer's one specifier line in pnpm-lock.yaml. The resolved version stays 17.7.0. They are commit a62959a, kept separate so it can be judged on its own. The reason: the published dist/index.js now imports deriveInlineRowFormFields and isInlineRowFormOffered from @objectstack/spec/data, and 17.6.x exports neither.

Evidence (head 328a381)

The installed exports. @objectstack/spec 17.7.0 dist/data/index.d.mts declares both, beside deriveInlineGridColumns:

  • deriveInlineRowFormFields(def: unknown, opts?: { relationshipField?: string; exclude?: readonly string[] }): string[]
  • isInlineRowFormOffered(opts: { inlineMode?: 'grid' | 'form'; formFields?: readonly unknown[]; columns?: readonly unknown[] }): boolean

The pins.

  • deriveMasterDetail.inlineRowFormFields-11428.test.ts, the twin of the objectui#11345 corpus: one 15-entry corpus, two answers per entry. The names equal (toStrictEqual) the spec's deriveInlineRowFormFields answer, and they equal the arrays the replaced local filter returned. The second leg was run against the replaced filter, before the swap: Tests 30 passed (30).
  • inlineRowForm.specSource-11428.test.tsx: both exports behind pass-through spies (a file-scoped vi.mock that spreads the real module, with a factory-ran probe). The pass-through rows are the existing behaviour: the three authored offer arms of masterDetailDetailsMembers-8071 row 3, plus a fully derived collection. The stubbed rows hand back answers the local rules could never give: a stubbed field list comes back from deriveFormFields unchanged and drives deriveDetail's formFields and its smart default; an inverted offer answer inverts every collection's offer, while list mode and its Add stay. Run against the BASE implementation, before the swap: Tests 4 failed | 1 passed (5), the one green being the mock-installed check.
  • The existing pins are unchanged and green: deriveFormFields (per-row expand form) in deriveMasterDetail.test.ts, and masterDetailDetailsMembers-8071 row 3.

Ablations on committed code (328a381). Each ran through objectstack's scripts/ablation-replace.mjs. In each, the anchor went from 1 hit to 0, the blob changed, and the restore was proven (blob equals HEAD, git diff HEAD empty).

  • A, the order's leg: the offer reverted to the hand-written expression. Predicted 2 red (the two offer pins) with masterDetailDetailsMembers-8071 green. Observed Tests 2 failed | 12 passed (14). Row 3 of 8071 stays green under this ablation, which is why an equality pin cannot stand in for the spy.
  • B: deriveFormFields reverted to the replaced local filter. Predicted 2 red (the two derive spy pins) with the corpus green. Observed Tests 2 failed | 33 passed (35).

One-off differential. Not committed; a historical reading at 7ae2f6b, whose source is the head's. It compares BASE c0862c1 with this branch.

  • deriveFormFields, 100,000 random cases: system, sort-position and prototype-named keys; random types and flags, truthy and falsy; falsy and primitive definitions; array, null and non-object field maps; random relationshipField and exclude. Compared by deep equality plus the util.inspect rendering. 0 mismatches. Control leg (the BASE filter plus a readonly drop): 14,118 mismatches, so the instrument can fire.
  • The offer, 300,000 random cases: inlineMode grid, form, absent or junk; formFields and columns absent, null or of random length. 0 mismatches. Control leg (greater-or-equal in place of strictly greater): 62,517 mismatches.

Floor. objectui's scripts/check-spec-range-floors.mjs verdict through its own analyze(), scoped to @object-ui/plugin-form over its built dist:

  • at ^17.7.0: 0 findings;
  • at ^17.6.0 (in memory): floor-too-low on exactly deriveInlineRowFormFields and isInlineRowFormOffered.
Run (from the repo root, head 328a381) Exit
pnpm exec vitest run --maxWorkers=2 packages/plugin-form/ 0: Test Files 167 passed (167), Tests 1970 passed / 1 skipped (1971)
pnpm --filter @object-ui/plugin-form type-check, after turbo run build --filter=@object-ui/plugin-form. Both tsc legs ran, and --listFiles shows the test program reads both new files 0
pnpm --filter @object-ui/plugin-form lint 0, with 0 errors
check:phantom-deps, check:unused-deps, check:esm-specifiers, check:self-import, check:spec-symbols, check:unreferenced-sources, check:test-path-roots, check:vi-mock-specifiers, check:vi-mock-inherit, check:vi-mock-override-shape, check:lockfile-integrity, check:lockfile-dedupe, check:installed-pin-claims, check:changeset-claims, check:pending-changeset-literals, check:new-line-citations, check:control-bytes, check:element-data-source-declaration, check:handler-key-reads, check:metadata-write-doors, check:published-tsconfig-exclude 0 each
scripts/check-changeset-presence.mjs, scripts/check-changeset-no-major.mjs, scripts/check-changeset-fixed.mjs, scripts/check-lint-coverage.mjs, scripts/check-type-check-coverage.mjs 0 each
scripts/check-governed-queue-guard.mjs --test over the seven changed paths NOT GOVERNED

NOT MEASURED locally. These need every published package built, and CI or the release path runs them:

  • the full check:spec-floors (the scoped verdict above stands in);
  • check:readme-exports (this diff touches no README and no export);
  • check:dist-completeness, the load leg of check:node-esm-load, and check:published-dist;
  • the root pnpm lint and pnpm test.

Acceptance notes

  • The sort-position names are now read in two places that hold the same set: the spec's module-private INLINE_GRID_SORT_FIELDS (through both derive exports) and objectui's SORT_FIELD_NAMES, which deriveDetail reads to pick the line's sort field. @objectstack/spec/data does not export the set. An observation only; the sort-field pick is not this card's rule. Carrier: none.

Changeset

.changeset/11428-inline-row-form-spec-rule.md declares @object-ui/plugin-form patch, the level measured above (the output is unchanged), and carries the floor sentence.

Session: https://claude.ai/code/session_01FngvPpdrnhHMdHHq6vwwju (os-dev, dispatched by the domain:ui seat 2).


Generated by Claude Code

claude added 3 commits October 7, 2026 02:39
…ectui#11428)

The published entry is about to import `deriveInlineRowFormFields` and
`isInlineRowFormOffered` from `@objectstack/spec/data`, which the spec
first exports in 17.7.0. The old floor admitted 17.6.x, which carries
neither name. The resolved version stays 17.7.0; the lockfile moves only
this importer's specifier line.

Claude-Session: https://claude.ai/code/session_01FngvPpdrnhHMdHHq6vwwju
Co-authored-by: Claude <noreply@anthropic.com>
…ough the spec rule `deriveInlineRowFormFields` / `isInlineRowFormOffered` (objectui#11428)

`deriveFormFields` now returns `@objectstack/spec/data`'s
`deriveInlineRowFormFields` answer, and `MasterDetailForm` offers a row
the expand form when `isInlineRowFormOffered` says so, asked with the
collection's resolved `inlineMode`, `formFields` and `columns`. The local
`SYSTEM_FIELDS` and `NON_INPUT_TYPES` sets, which only the row form read,
are removed; `SORT_FIELD_NAMES` stays for the sort-field pick.

Pins: a 15-entry corpus holds `deriveFormFields` equal to the spec's
answer and to the replaced filter's answers (checked against that filter
before the swap); a file-scoped spy pins that both sites read the spec,
with stubbed answers the local rules could never give.

Claude-Session: https://claude.ai/code/session_01FngvPpdrnhHMdHHq6vwwju
Co-authored-by: Claude <noreply@anthropic.com>
The captured grid props, the child object fixtures, the data source and
the block schema are typed against `GridProps`, `DataSource` and
`MasterDetailFormSchema` instead of `any`. No assertion changes.

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

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 331 chunks) 3506.8 KB 3551.8 KB
Main entry chunk (gzip) 154.9 KB 350 KB
Entry file index-B6g6fGIq.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) 578.94KB 139.21KB
core (index.js) 10.00KB 3.96KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 235.41KB 65.46KB
fields (index.js) 266.88KB 67.46KB
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.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) 37.51KB 10.04KB
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.26KB 23.05KB
plugin-chatbot (index.js) 199.63KB 47.46KB
plugin-dashboard (index.js) 144.22KB 38.99KB
plugin-designer (index.js) 231.46KB 48.87KB
plugin-detail (index.js) 247.73KB 65.20KB
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) 238.51KB 65.53KB
plugin-kanban (index.js) 52.17KB 16.37KB
plugin-list (index.js) 116.85KB 29.12KB
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) 39.10KB 11.81KB
plugin-tree (index.js) 15.07KB 5.33KB
plugin-view (index.js) 90.64KB 22.85KB
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 7, 2026 03:18
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 7, 2026 03:18
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 7, 2026
Merged via the queue into main with commit 3f0b0cd Oct 7, 2026
47 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-11428-inline-row-form-spec-derivation branch October 7, 2026 03:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants