Skip to content

Report an inert section visibleWhen on the tabbed and wizard arms (the ruled interim diagnostic) - #6733

Merged
os-sales merged 1 commit into
mainfrom
claude/issue-6237-formfieldtab-visiblewhen
Aug 29, 2026
Merged

Report an inert section visibleWhen on the tabbed and wizard arms (the ruled interim diagnostic)#6733
os-sales merged 1 commit into
mainfrom
claude/issue-6237-formfieldtab-visiblewhen

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Part of #6237 — deliberately not Fixes. This ships the ruled interim half only; the card stays open for the design task the same ruling created.

The order's premise was dead, and that is the first finding

The dispatch order asked me to give the tabbed arm a visibleWhen slot and make the renderer honour it. That already exists on origin/main. It landed in #6619 (commit 46f0bb4f5, 2026-08-27) and both halves are live:

packages/types/src/form.tsFormFieldTab (the arm the card's title names):

 visibleWhen?: string|{dialect?: string; source: string};

packages/plugin-form/src/ModalForm.tsx — the sibling declaration it mirrors, on ModalFormSectionConfig:

 visibleWhen?: string|{dialect?: string; source: string};

The renderer evaluates it (hiddenFieldTabKeys in renderers/form/form.tsx) and ModalForm's tabbed synthesis copies the section predicate onto the tab (visibleWhen: g.visibleWhen). Measured green on origin/main before touching anything: the existing pin suite fieldtab-visiblewhen-6237.test.tsx runs 12 passed (12), and sectionVisibleWhen-6111.test.tsx + zod-mirror-parity.test.ts run 27 passed (27).

Adding a second slot would have been a redundant declaration, so I did not.

On the zod mirror, which the order flagged: FormFieldTab has no zod counterpart at allfieldTabs is not modelled in form.zod.ts (0 occurrences), and that absence is already ledgered as a pre-existing LOCAL divergence in zod-mirror-parity.test.ts ('form.zod.ts#FormSchema': … | 'fieldTabs' | …). So there is no mirror asymmetry to close here, and adding a validated surface no ruling covers would have been unauthorised widening.

What is actually broken, and what this PR does

ObjectForm rebuilds each section key by key when it delegates to a layout, so a key the map does not copy never reaches a renderer. Measured across all five routes:

RouteCopies visibleWhen?
formType: 'tabbed'TabbedFormNo — the predicate is dropped
formType: 'wizard'WizardFormNo — the predicate is dropped
formType: 'split'SplitFormYes (#6111)
formType: 'drawer'DrawerFormYes (#6111)
formType: 'modal'ModalFormYes (#6111), incl. contentLayout: 'tabbed' via #6619

The modal map even carries a comment naming the hazard — "this mapping rebuilds each section key by key, so a key it doesn't copy is silently dropped" — which is why the two omissions read as omissions rather than as design.

Per the maintainer ruling of 2026-08-29 (option A), making those two arms honour the predicate is a design task: one renderer-side section/group contract with a predicate slot, designed once for every layout arm, answering the three binding semantics (hidden-tab required fields, active-tab re-selection, collapse below two tabs). Ruled as part of that option, a loud diagnostic lands first. That is this PR:

  • One shared message builder, sectionPredicateUnsupportedWarning, so the two arms cannot drift apart. It is not added to the package barrel — no published surface widens.
  • A useEffect in ObjectForm reporting the gap, keyed on primitives so it fires once per mount rather than once per keystroke.
  • routesToMasterDetail hoisted out of the existing branch condition and reused, so the diagnostic and the actual routing cannot disagree.

No rendering behaviour changes. No authorable key is added anywhere — declaring visibleWhen on a type whose renderer ignores it is the exact defect this card family exists to close, and the FormSectionConfig that WizardForm shares for its steps makes that trap concrete.

Declared scope call — please trim if unwanted

The ruling names "the tabbed arm"; I cover both silently-inert arms (tabbed and wizard). Rationale: both drop the key through the identical mechanism, the docs support table already lists both as No, and covering the second costs one array entry and no new surface — whereas leaving it out keeps an author writing a wizard step predicate in exactly the silence the ruling set out to end. Trimming to tabbed-only is a one-line change if the maintainer prefers the literal reading.

The pins, and their red-against-unfixed-source verification

New: packages/plugin-form/src/__tests__/sectionPredicateLayoutDiagnostic-6237.test.tsx14 passed (14).

It pins reporting, never behaviour — it must not grow an assertion that a tabbed or wizard section actually hides, since that is the design task's deliverable. The negative rows are the load-bearing half: a diagnostic that fires everywhere is as useless as one that fires nowhere.

Ablation (fix committed first, so the restore leg has a real reference). Mutation neutralised only the console.warn call, leaving the builder and the routing guard intact.

  • Re-run on the final tree (c6e97a309). Mutation proven on disk: anchor count 1 → 0, injected count 1, blob de30e381 → 191ed7f5.
  • Predicted 6 red / 8 green; observed exactly that, row for row. Red: the four reporting rows, once-per-mount, and master-detail-tabbed-once. Green: the five honouring-arm rows, the no-predicate row, master-detail-wizard-silent, and the builder row.
  • Restore proven both ways: blob hash matches the HEAD blob andgit diff HEAD is empty.

Docs

Both surfaces already carried a correct support table with TabbedForm sections and WizardForm steps as explicit No rows, so no prose was wrong. Each now also states that those two rows report themselves, with the message and the reason it is interim: content/docs/plugins/plugin-form.mdx and packages/plugin-form/README.md.

What stays open on #6237

The design task itself — the one grouping contract across all layout arms, and its three binding semantics. This PR does not touch them, which is why it is Part of and not Fixes.


Generated by Claude Code

…nd wizard arms
ObjectForm rebuilds each section key by key when delegating to a layout, so a
key the map does not copy never reaches a renderer. The split/drawer/modal maps
copy visibleWhen (#6111) and the flat arm carries it on the section-divider
pseudo-field; the tabbed and wizard maps copy nothing, so an authored section
predicate did nothing at all, with no signal anywhere.
Those two arms now warn, naming the layout and the sections being dropped,
through one shared message builder. No rendering behaviour changes and no
authorable key is added: this is the interim half of the 2026-08-29 ruling that
the real repair is one section/group predicate contract designed once for every
layout arm.
Deliberately silent on the four arms that honour the key, and on the
master-detail branch, which re-enters ObjectForm where the real layout is
decided.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CRJge11jso9TpXRWFt1Z49
@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation plugin tests labels Aug 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 49 chunks)3233.4 KB3266.6 KB
Main entry chunk (gzip)157.3 KB350 KB
Entry fileindex-CXOdvYcq.js
StatusPASS

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

PackageSizeGzipped
app-shell (consoleActionDispatch.js)0.20KB0.19KB
app-shell (index.js)11.89KB4.50KB
app-shell (runtime-config.js)20.61KB7.35KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)10.06KB3.86KB
auth (ActiveOrganizationStorage.js)25.05KB9.16KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)2.07KB1.00KB
auth (AuthProvider.js)40.18KB10.59KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.15KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.65KB2.22KB
auth (SocialSignInButtons.js)9.61KB3.89KB
auth (UserMenu.js)3.41KB1.23KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)40.21KB10.80KB
auth (createAuthenticatedFetch.js)8.46KB3.43KB
auth (index.js)3.19KB1.44KB
auth (invitation-status.js)1.22KB0.70KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)5.30KB1.02KB
auth (useWorkspaceAdminStatus.js)5.13KB2.35KB
collaboration (CommentThread.js)26.08KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.68KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)511.59KB116.29KB
core (index.js)5.30KB2.13KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)173.10KB47.96KB
fields (index.js)239.31KB60.18KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (fallbackInterpolation.js)6.25KB2.77KB
i18n (i18n.js)4.28KB1.75KB
i18n (index.js)3.44KB1.39KB
i18n (pickLocalized.js)7.62KB3.26KB
i18n (provider.js)26.89KB9.04KB
i18n (useDisplayLocale.js)2.85KB1.45KB
i18n (useObjectLabel.js)33.40KB8.71KB
i18n (useSafeTranslation.js)5.60KB2.33KB
layout (index.js)38.95KB10.97KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.75KB
mobile (index.js)1.55KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.72KB0.42KB
mobile (useResponsiveConfig.js)1.37KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)9.53KB3.38KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)4.64KB1.50KB
permissions (evaluator.js)5.12KB1.74KB
permissions (index.js)0.93KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.53KB
permissions (usePermissions.js)1.93KB0.88KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.89KB12.91KB
plugin-charts (index.js)64.66KB18.32KB
plugin-chatbot (index.js)190.33KB45.10KB
plugin-dashboard (index.js)133.44KB34.48KB
plugin-designer (index.js)212.87KB43.19KB
plugin-detail (index.js)245.29KB62.39KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)132.90KB32.60KB
plugin-gantt (index.js)165.20KB40.37KB
plugin-grid (index.js)201.53KB54.54KB
plugin-kanban (index.js)53.11KB14.62KB
plugin-list (index.js)113.01KB27.57KB
plugin-map (index.js)20.17KB6.66KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)43.51KB11.94KB
plugin-timeline (index.js)26.44KB7.59KB
plugin-tree (index.js)9.00KB3.08KB
plugin-view (index.js)85.87KB21.12KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.66KB3.50KB
providers (index.js)0.45KB0.23KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.62KB2.34KB
react (LazyPluginLoader.js)4.47KB1.63KB
react (SchemaRenderer.js)67.73KB22.54KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)2.44KB1.21KB
react (schema-input.js)2.32KB1.24KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)5.41KB2.34KB
sdui-parser (dashboard-widget-options.js)3.08KB1.30KB
sdui-parser (index.js)4.93KB2.24KB
sdui-parser (input-type.js)2.84KB1.40KB
sdui-parser (parse.js)20.57KB5.88KB
sdui-parser (provenance.js)3.66KB1.82KB
sdui-parser (types.js)0.28KB0.23KB
sdui-parser (validate.js)10.35KB3.60KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)2.74KB1.41KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)3.75KB1.85KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.85KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-inflight.js)8.87KB3.73KB
types (http-retry.js)4.32KB2.02KB
types (icon-key-migration.js)4.26KB1.63KB
types (index.js)4.72KB2.24KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (spec-ui-namespace.js)0.20KB0.19KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)6.28KB2.87KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationplugintests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-sales@claude