@object-ui/plugin-form 17.6.0 → 17.7.0

package/dist/WizardForm.d.ts

@@ -1,40 +1,112 @@
 import { default as React } from 'react';
-import { DataSource } from '@object-ui/types';
-import { SubmitBehavior } from './successBehavior';
-import { FormSectionConfig } from './TabbedForm';
+import { FormField, DataSource, ObjectFormSchema } from '@object-ui/types';
+import { SubmitBehavior } from './successBehavior.js';
 /**
- * What the submitter is told when a DECLARED `navigateOnSuccess` produced no
- * destination — objectui#5034 point 2.
+ * A wizard STEP — the wizard's OWN authored group shape (objectui#6237).
  *
- * The write succeeded, so this rides on the success toast as a note rather than
- * becoming an error or a blocking panel: turning a successful write into an
- * error state would be a worse lie than the silence it replaces. What was
- * missing is one fact, and only one: the navigation the author declared did not
- * happen. Before this, the toast was byte-identical to the toast a form with no
- * `navigateOnSuccess` at all produces, so an author who mistyped the destination
- * — or whose record carried no usable id — saw a form that looked entirely
- * healthy and had silently stopped honouring a key they wrote.
+ * ## Why this is declared here rather than derived from the tabbed layout
  *
- * Maintainer ruling, 2026-08-17: "A refused declared navigation is surfaced: the
- * success toast carries a note that the declared navigation was not performed —
- * never indistinguishable from the no-key case."
+ * It used to be `Omit<FormSectionConfig, 'visibleWhen'>`, which subtracted the
+ * predicate slot from `TabbedForm`'s section type. That closed the hole for the
+ * ONE key it named and left the mechanism wide open: `FormSectionConfig` is the
+ * predicate-CARRYING type, so every key added to it lands here by default and
+ * the author has to remember to widen the `Omit`. The defect the 2026-08-30
+ * ruling closes is the SILENCE — "在共享 `FormSectionConfig` 上声明 `visibleWhen`
+ * 会**静默**给 WizardForm 的 step 也发一个谓词槽而那侧无实现" — and a subtractive
+ * derivation reproduces that silence for the next key in the same family
+ * (`readonlyWhen` / `requiredWhen`, both already this repo's field-level
+ * predicate vocabulary). Declaring the step shape independently flips the
+ * derivation from subtractive to additive: a key reaches a wizard step only
+ * because someone wrote it here, on the type whose renderer has to honour it.
  *
- * The note names no REASON on purpose. `resolveSuccessNavigate` answers null for
- * two different causes (no usable id on the written record; a destination the
- * same-origin guard refused) and returns no discriminant, so a reason in this
- * copy could only be re-derived by reimplementing that helper's internals at the
- * call site — where it would drift from the helper, and would additionally bake
- * today's acceptance rule into user-visible prose while objectui#5548 is still
- * open on exactly that rule. The diagnosable detail — the template the author
- * actually wrote — goes to `console.warn` at each call site instead.
+ * This is also simply the house pattern. `SplitFormSectionConfig`,
+ * `ModalFormSectionConfig` and `DrawerFormSectionConfig` each declare their own
+ * group shape, each documents `className` / `gridClassName` in ITS layout's
+ * terms, and each declares `visibleWhen` only because its layout honours it
+ * (`SplitFormSectionConfig` even carries a key — `pane` — that exists nowhere
+ * else). The wizard borrowing the tabbed layout's interface was the exception,
+ * and it cost real accuracy: a wizard author reading the shared type was told
+ * `name` is "used as tab value", `label` is "used as tab trigger text", and
+ * `className` is "Unused in the tabbed layout" — while this renderer uses all
+ * three, `className` at the step container (`FormSectionContainer` below).
  *
- * Lives here rather than in `successBehavior.ts` (the natural home, but read-only
- * for this card) and is imported BY `ObjectForm`, which is the dependency
- * direction that already exists — ObjectForm imports WizardForm, never the
- * reverse. Single-sourced so a wizard and a flat form cannot tell a submitter
- * two different things about one refusal; a test pins that they do not.
+ * ## ⛔ Why there is no predicate slot, and why that is not an oversight
+ *
+ * A step predicate is not a port of the tab predicate, it is a different
+ * contract. Steps are wizard component state keyed by section INDEX, only the
+ * current step is mounted (unmounted-ness is every other step's NORMAL state,
+ * which is why the final gate re-checks the whole declared field set), and the
+ * predicate would read `formData` — which merges only at step boundaries. So a
+ * step predicate is structurally STEP-BOUNDARY reactive where a tab's is ruled
+ * LIVE-RECORD reactive: one keyword, two different "when". It also needs
+ * machinery none of which is inherited — navigation policy for skipping hidden
+ * steps, the indicator, `isLastStep`, the "Step X of Y" denominator, index
+ * stability while hiding is live, re-selection when the CURRENT step hides, and
+ * a final-gate exclusion for a hidden step's required fields.
+ *
+ * Declaring the key on a type this renderer ignores would make it WRITABLE on a
+ * step — precisely the declared-but-unenforced shape this card family exists to
+ * close. Its absence means TypeScript rejects the key on a wizard step literal,
+ * which is where an author (or an agent authoring metadata) finds out.
+ * `ObjectForm` additionally reports the gap at runtime for a section predicate
+ * arriving on the wizard route, since untyped JSON reaches it too. Both halves
+ * are pinned in `__tests__/tabbedFormSectionPredicate-6237.test.tsx`, including
+ * a FAMILY-level pin that fails the build if any `*When` key ever appears here,
+ * not just the one this card was about.
+ *
+ * Since the objectstack#13622 ruling (2026-08-31), the boundary is also an
+ * AUTHOR-door refusal: `@objectstack/spec` refuses `visibleWhen` (and
+ * `collapsible`/`collapsed: true`) on a wizard step at parse, so authored
+ * form-view metadata carrying them never reaches this renderer at all. This
+ * type and the runtime report remain the guard for what the spec door cannot
+ * see — programmatic SDUI callers and metadata published before the
+ * tightening. The step-predicate FUTURE contract stays tracked in
+ * objectui#6237; the spec-side refusal is its single opening point.
+ *
+ * ⚠️ This changes nothing that used to work. The published surface is exactly
+ * the key set `WizardStepConfig` already had — the derivation changed, not the
+ * type — and `visibleWhen` was already a type error on a wizard step literal.
  */
-export declare const NAVIGATE_ON_SUCCESS_REFUSED_NOTE: string;
+export interface WizardStepConfig {
+    /**
+     * Step identifier. Used as the step's test handle
+     * (`data-testid="wizard-step:<name>"`) and, with `label`, as what the
+     * indicator names; falls back to the step INDEX when absent.
+     */
+    name?: string;
+    /**
+     * Step label — the text the step indicator shows.
+     * Falls back to `Step <n>`, in the session locale (`wizard.stepFallback`).
+     */
+    label?: string;
+    /**
+     * Step description, rendered under the step heading.
+     */
+    description?: string;
+    /**
+     * How densely this step fills the grid (1–4). Outranked by the form view's
+     * own `columns` (spec `FormView.columns`), which sets the grid WIDTH.
+     * @default 1
+     */
+    columns?: 1 | 2 | 3 | 4;
+    /**
+     * Field names or configurations in this step.
+     */
+    fields: (string | FormField)[];
+    /**
+     * Custom CSS class for this step's container.
+     *
+     * Honoured, unlike its tabbed counterpart: a wizard mounts ONE step at a
+     * time inside its own `FormSectionContainer`, so the step has a container to
+     * carry it.
+     */
+    className?: string;
+    /**
+     * Custom CSS class for this step's field grid (overrides the column classes).
+     */
+    gridClassName?: string;
+}
+export { NAVIGATE_ON_SUCCESS_REFUSED_NOTE } from './formChrome.js';
 export interface WizardFormSchema {
     type: 'object-form';
     formType: 'wizard';
@@ -47,13 +119,23 @@ export interface WizardFormSchema {
      */
     mode: 'create' | 'edit' | 'view';
     /**
-     * Record ID (for edit/view modes)
+     * Record ID (for edit/view modes). A string, per the one record-id rule on
+     * `DataSource` (objectui#9511) — `ObjectForm` builds this schema from the
+     * authorable `ObjectFormSchema.recordId`, which is a string, and `findOne`
+     * takes a string.
      */
-    recordId?: string | number;
+    recordId?: string;
     /**
      * Wizard step sections
      */
-    sections: FormSectionConfig[];
+    sections: WizardStepConfig[];
+    /**
+     * Inline field definitions (`object-form.customFields`). A member naming a
+     * field a section lists is that field's definition, as on every other
+     * `formType` (objectui#10254); `ObjectForm` hands the key over in its
+     * `{...schema}` spread.
+     */
+    customFields?: FormField[];
     /**
      * Allow navigation to any step (not just sequential).
      *
@@ -77,22 +159,26 @@ export interface WizardFormSchema {
      */
     showStepIndicator?: boolean;
     /**
-     * Text for Next button
+     * Text for Next button. Rendered as authored when set; otherwise the
+     * session locale's `common.next`.
      * @default 'Next'
      */
     nextText?: string;
     /**
-     * Text for Previous button
+     * Text for Previous button. Rendered as authored when set; otherwise the
+     * session locale's `wizard.back`.
      * @default 'Back'
      */
     prevText?: string;
     /**
-     * Submit button text (shown on last step)
+     * Submit button text (shown on last step). Rendered as authored when set;
+     * otherwise the session locale's `form.create` / `form.update`.
      */
     submitText?: string;
     /**
      * Declarative success toast text shown when no `onSuccess` handler is given
-     * (metadata pages cannot pass a function). Falls back to 'Created'/'Saved'.
+     * (metadata pages cannot pass a function). Falls back to the session
+     * locale's `form.created` / `form.saved` ('Created' / 'Saved' in English).
      * Ignored when `submitBehavior` is set.
      */
     successMessage?: string;
@@ -117,7 +203,8 @@ export interface WizardFormSchema {
      */
     showCancel?: boolean;
     /**
-     * Cancel button text
+     * Cancel button text. Rendered as authored when set; otherwise the session
+     * locale's `common.cancel`.
      */
     cancelText?: string;
     /**
@@ -132,6 +219,24 @@ export interface WizardFormSchema {
      * Read-only mode
      */
     readOnly?: boolean;
+    /**
+     * Override persistence — the seam a host uses to own the write. Declared as
+     * `ObjectFormSchema['submitHandler']` rather than restated, so this variant
+     * and the canonical key `ObjectForm` forwards can never drift apart.
+     * When supplied, the form validates and hands the collected values
+     * to this handler INSTEAD of calling `dataSource.create` /
+     * `dataSource.update`; the returned record is passed on to `onSuccess`.
+     * In `edit` mode, for a record this form read itself, it hands over what it
+     * would have written: the fields that differ from that read, or the full
+     * sanitized payload when nothing changed (objectui#10156, objectui#10563;
+     * the whole rule is on `ObjectFormSchema['submitHandler']`).
+     *
+     * `MasterDetailForm` supplies it to route the parent AND its child
+     * collections through one atomic `batchTransaction` (#2679 / ADR-0034
+     * item 4). A renderer that does not read it writes the parent on its own and
+     * escapes that transaction — objectui#6176.
+     */
+    submitHandler?: ObjectFormSchema['submitHandler'];
     /**
      * Callbacks
      */

package/dist/WizardForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WizardForm.d.ts","sourceRoot":"","sources":["../src/WizardForm.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAW9D,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,gCAAgC,QAEN,CAAC;AAiBxC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAE9B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;+CAG2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;iBAEa;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEpC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAwsBhD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"WizardForm.d.ts","sourceRoot":"","sources":["../src/WizardForm.tsx"],"names":[],"mappings":"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"}

package/dist/autoLayout.d.ts

@@ -8,7 +8,7 @@ export declare function isWideFieldType(type: string): boolean;
  */
 export declare function isAutoGeneratedFieldType(type: string): boolean;
 /**
- * Infer the MAX column count from the field count (#2578). This is an UPPER
+ * Infer the MAX column count from the field count (objectstack-ai/objectstack#2578). This is an UPPER
  * BOUND — the actual column count at render time is decided by the CSS
  * container queries in {@link CONTAINER_GRID_COLS} against the form's REAL
  * width, so a narrow drawer stays 1–2 columns while the SAME form on a wide
@@ -25,12 +25,21 @@ export declare function isAutoGeneratedFieldType(type: string): boolean;
 export declare function inferColumns(fieldCount: number): number;
 /**
  * Resolve the effective colSpan (grid cells) a field occupies, given the form's
- * grid width and the section's desired column count (#2578).
+ * grid width and the section's desired column count (objectstack-ai/objectstack#2578).
  *
  * The column count is derived per surface (mobile 1 / modal 2 / page 3-4), so
  * the robust field-width primitive is the relative `span`, NOT an absolute
  * colSpan. Precedence:
  *   1. `span: 'full'`     → whole row (grid cells).
+ *
+ * ⚠️ «Whole row» is a claim about what RENDERS, and this function only returns
+ * a number. It is kept by the form renderer's `spanLadderFor`, which turns
+ * that number into one col-span class per container-query tier. Until
+ * `bd0995738` the renderer emitted a single class for the widest tier only,
+ * so this sentence was true of the return value and false on screen at every
+ * intermediate width. ⛔ A pin under this function cannot observe that — see
+ * `__tests__/spanFullTierLadder-9244.test.tsx` for the leg that can.
+ *
  *   2. legacy `colSpan`   → honoured but CLAMPED to the grid (never overflows).
  *   3. wide widget type   → whole row (textarea/markdown/… — the `span:'auto'` default).
  *   4. section density    → grid / sectionColumns, so `sectionColumns` fields fill a row.
@@ -41,7 +50,7 @@ export declare function inferColumns(fieldCount: number): number;
 export declare function resolveColSpan(field: FormField, gridColumns: number, sectionColumns?: number): number;
 /**
  * Apply the resolved colSpan to each field so the form's CSS grid lays them out
- * at the intended density. Span-aware and clamping (#2578); wide fields still
+ * at the intended density. Span-aware and clamping (objectstack-ai/objectstack#2578); wide fields still
  * span the full row (the `span: 'auto'` default). `section-divider` rows are
  * left untouched (they carry their own full-row span).
  *

package/dist/autoLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoLayout.d.ts","sourceRoot":"","sources":["../src/autoLayout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqElD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKvD;AAOD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAmBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,SAAS,EAAE,CAab;AAmCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,CAAC,EAAE,GAAG,GACjB,SAAS,EAAE,CAgBb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,CAAC,EAAE,GAAG,GACjB,SAAS,EAAE,CAmBb;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,CAAC,EAAE,GAAG,GACjB,SAAS,EAAE,CAOb;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAKlE,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CASxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAIvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,EAAE,EACvB,YAAY,EAAE,GAAG,EACjB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA6BtD"}
+{"version":3,"file":"autoLayout.d.ts","sourceRoot":"","sources":["../src/autoLayout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAsElD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKvD;AAOD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAmBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,SAAS,EAAE,CAab;AAiBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,CAAC,EAAE,GAAG,GACjB,SAAS,EAAE,CAgBb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,CAAC,EAAE,GAAG,GACjB,SAAS,EAAE,CAmBb;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,CAAC,EAAE,GAAG,GACjB,SAAS,EAAE,CAOb;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAKlE,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CASxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAIvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,EAAE,EACvB,YAAY,EAAE,GAAG,EACjB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA6BtD"}

package/dist/closedAffordanceNotice.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+import { ClosedFormAffordance } from './fieldWriteGate.js';
+export interface ClosedAffordanceNoticeProps {
+    /** `closedFormAffordance`'s answer for the form; nothing renders when `undefined`. */
+    affordance: ClosedFormAffordance | undefined;
+    /** The form's object. Its label is resolved the way the console resolves it. */
+    objectName: string;
+    /** The object schema the form resolved; its `label` is the fallback label. */
+    objectSchema: {
+        label?: unknown;
+    } | null | undefined;
+}
+export declare function ClosedAffordanceNotice({ affordance, objectName, objectSchema, }: ClosedAffordanceNoticeProps): React.ReactElement | null;
+//# sourceMappingURL=closedAffordanceNotice.d.ts.map

package/dist/closedAffordanceNotice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closedAffordanceNotice.d.ts","sourceRoot":"","sources":["../src/closedAffordanceNotice.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAwC7D,MAAM,WAAW,2BAA2B;IAC1C,sFAAsF;IACtF,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC7C,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,YAAY,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CACtD;AAED,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EACV,UAAU,EACV,YAAY,GACb,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA4BzD"}

package/dist/customFieldsMerge.d.ts

@@ -0,0 +1,29 @@
+import { FormField } from '@object-ui/types';
+/**
+ * The member that supplies the definition of the field called `name`, or
+ * `undefined` when no member names it — the override direction's precedence,
+ * spelled once. The first member naming the field wins, and an EMPTY
+ * `customFields` supplies nothing.
+ *
+ * Shared by the two producers of a runtime field from a name: the flat list
+ * (`mergeCustomFields` below, the default arm's pool and the drawer / modal
+ * no-sections path) and a section body (`normalizeSectionField` in
+ * `sectionFields.ts`, where the member is a section entry's BASE definition).
+ * objectui#10254: the drawer and modal section bodies used to regenerate every
+ * named field from the object schema, so a member the default arm drew was
+ * dropped on those two arms.
+ */
+export declare function findCustomFieldMember(customFields: readonly FormField[] | null | undefined, name: string): FormField | undefined;
+/**
+ * Resolve the runtime field list for `names`, with `customFields` merged over
+ * the fields `generate` produces.
+ *
+ * @param names        The field names the form draws, in render order.
+ * @param customFields The authored members (`schema.customFields`).
+ * @param generate     Builds the generated field for `names[index]`, or
+ *                     returns `undefined` when the object declares no such
+ *                     field (the name is then skipped unless a member names it).
+ * @param normalize    Applied to every member before it is drawn.
+ */
+export declare function mergeCustomFields(names: readonly string[], customFields: readonly FormField[] | null | undefined, generate: (name: string, index: number) => FormField | undefined, normalize?: (member: FormField) => FormField): FormField[];
+//# sourceMappingURL=customFieldsMerge.d.ts.map

package/dist/customFieldsMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customFieldsMerge.d.ts","sourceRoot":"","sources":["../src/customFieldsMerge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACrD,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,SAAS,CAGvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,YAAY,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACrD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,EAChE,SAAS,GAAE,CAAC,MAAM,EAAE,SAAS,KAAK,SAA8B,GAC/D,SAAS,EAAE,CAyBb"}

package/dist/deriveMasterDetail.d.ts

@@ -1,6 +1,25 @@
 import { GridColumn } from '@object-ui/fields';
-/** Minimal shape of an object schema as returned by `DataSource.getObjectSchema`. */
-export interface ObjectSchemaLike {
+/**
+ * Minimal shape of a MASTER-DETAIL CHILD object's schema, as returned by
+ * `DataSource.getObjectSchema` — the `childSchema` parameter of every derive
+ * function below (objectui#7324).
+ *
+ * Named for the child because that is the only thing it is ever used for, and
+ * because `schemaDefaults.ts` holds a DIFFERENT shape under what used to be
+ * the same name (`FieldDefaultsSchemaLike` now). The two are not
+ * interchangeable: this one's field values are `any` — these functions read a
+ * field's `type`, `label`, `options`, `hidden`, `reference` and more — while
+ * the defaults one pins the four members that rule reads. Publishing both
+ * under one name would have put a name on the package surface that already
+ * meant something else two files over.
+ *
+ * NOT `@object-ui/types`' `ObjectSchemaMetadata`: that type requires `name`
+ * and requires a `type` on every field, so the partial schemas these
+ * functions are handed (and every fixture that exercises them) would stop
+ * compiling. This is a deliberately structural parameter type — pass the
+ * object document your data source serves.
+ */
+export interface ChildObjectSchemaLike {
     name?: string;
     fields?: Record<string, any>;
 }
@@ -11,7 +30,7 @@ export declare function fieldTypeToColumnType(type: string | undefined): GridCol
  * master_detail/lookup field whose `reference` is the parent object. Prefer
  * `master_detail` over `lookup` when both exist.
  */
-export declare function findRelationshipField(childSchema: ObjectSchemaLike | undefined, parentObjectName: string): string | undefined;
+export declare function findRelationshipField(childSchema: ChildObjectSchemaLike | undefined, parentObjectName: string): string | undefined;
 /**
  * Default-visible column budget for an auto-derived inline grid. An inline
  * line-item grid lives in a constrained width (modal / detail card), so we show
@@ -29,7 +48,7 @@ export declare const DEFAULT_MAX_INLINE_COLUMNS = 6;
  * are flagged `defaultHidden` (collapsed into the grid's column chooser, not
  * dropped). Pass `maxColumns: 0` to flag none.
  */
-export declare function deriveColumns(childSchema: ObjectSchemaLike | undefined, opts?: {
+export declare function deriveColumns(childSchema: ChildObjectSchemaLike | undefined, opts?: {
     relationshipField?: string;
     exclude?: string[];
     maxColumns?: number;
@@ -44,15 +63,20 @@ export declare function deriveColumns(childSchema: ObjectSchemaLike | undefined,
  * schema, exactly as {@link deriveColumns} would, while preserving the author's
  * column set, order and labels. A column that already declares a `type` is left
  * untouched — the author's explicit choice always wins.
+ *
+ * A column that renders as `currency` and carries an authored `scale`, whether
+ * its type is declared or hydrated, is reported by
+ * {@link reportCurrencyColumnScale} (objectui#10783): the grid does not read
+ * that key.
  */
-export declare function hydrateColumns(columns: GridColumn[] | undefined, childSchema: ObjectSchemaLike | undefined): GridColumn[];
+export declare function hydrateColumns(columns: GridColumn[] | undefined, childSchema: ChildObjectSchemaLike | undefined): GridColumn[];
 /**
  * Field names for a child's full "row form" (the per-row expand editor) — every
  * editable business field, skipping system/audit fields, the back-reference FK,
  * and computed types. Broader than {@link deriveColumns} (which only returns
  * grid-friendly types): the form has room for textarea/richtext/file/etc.
  */
-export declare function deriveFormFields(childSchema: ObjectSchemaLike | undefined, opts?: {
+export declare function deriveFormFields(childSchema: ChildObjectSchemaLike | undefined, opts?: {
     relationshipField?: string;
     exclude?: string[];
 }): string[];
@@ -72,7 +96,7 @@ export declare const RICH_FIELD_FORM_THRESHOLD = 2;
  *     ({@link RICH_FIELD_FORM_THRESHOLD}), or more than
  *     {@link SMART_FORM_FIELD_THRESHOLD} editable business fields; else a `grid`.
  */
-export declare function resolveInlineMode(childSchema: ObjectSchemaLike | undefined, inlineEdit: boolean | InlineMode | undefined, opts?: {
+export declare function resolveInlineMode(childSchema: ChildObjectSchemaLike | undefined, inlineEdit: boolean | InlineMode | undefined, opts?: {
     relationshipField?: string;
 }): InlineMode;
 export interface DerivedDetail {
@@ -95,7 +119,7 @@ export interface DerivedDetail {
  * supplies any explicit overrides (relationshipField / columns / amountField),
  * which win over the derived values.
  */
-export declare function deriveDetail(childObject: string, childSchema: ObjectSchemaLike | undefined, parentObjectName: string, override?: {
+export declare function deriveDetail(childObject: string, childSchema: ChildObjectSchemaLike | undefined, parentObjectName: string, override?: {
     relationshipField?: string;
     columns?: GridColumn[];
     amountField?: string;

package/dist/deriveMasterDetail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deriveMasterDetail.d.ts","sourceRoot":"","sources":["../src/deriveMasterDetail.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAuBD,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAqClF;AAgCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,gBAAgB,EAAE,MAAM,GACvB,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAuD5C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACjF,UAAU,EAAE,CA0Cd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,GAAG,SAAS,EACjC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GACxC,UAAU,EAAE,CAgCd;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC5D,MAAM,EAAE,CAaV;AAED,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAiBzC,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;iFAEiF;AACjF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,EAC5C,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,UAAU,CAaZ;AAwBD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,wEAAwE;IACxE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mFAAmF;IACnF,IAAI,EAAE,UAAU,CAAC;IACjB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;+EAC2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CAAO,GAC7H,aAAa,CAmBf"}
+{"version":3,"file":"deriveMasterDetail.d.ts","sourceRoot":"","sources":["../src/deriveMasterDetail.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAuBD,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAqClF;AAgCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,gBAAgB,EAAE,MAAM,GACvB,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAuD5C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACjF,UAAU,EAAE,CAsDd;AAkDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,GAAG,SAAS,EACjC,WAAW,EAAE,qBAAqB,GAAG,SAAS,GAC7C,UAAU,EAAE,CAqCd;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC5D,MAAM,EAAE,CAaV;AAED,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAiBzC,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;iFAEiF;AACjF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,EAC5C,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,UAAU,CAaZ;AAwBD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,wEAAwE;IACxE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mFAAmF;IACnF,IAAI,EAAE,UAAU,CAAC;IACjB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;+EAC2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,gBAAgB,EAAE,MAAM,EACxB,QAAQ,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CAAO,GAC7H,aAAa,CAmBf"}

package/dist/fieldGroups.d.ts

@@ -19,4 +19,180 @@ import { FormField, ObjectFormSection } from '@object-ui/types';
  * into ObjectForm's existing section-render path.
  */
 export declare function deriveFieldGroupSections(fields: FormField[], fieldGroups: unknown): ObjectFormSection[] | null;
+/**
+ * THE ONE ROW RULE (objectui#9849 step two — director ruling letter E,
+ * item 2): 「The divider row exists iff `title || description`; with
+ * `description` only it is the blurb-only row (objectui#9835's shape), on
+ * every arm — one rule」.
+ *
+ * Every arm asks this one function, both to decide whether a row is drawn and
+ * — because 「the collapse control lives on the row」 (item 3) — whether a
+ * collapse control has anywhere to live. It replaced a four-way gate union
+ * (one answer per arm) that the ruling deleted.
+ *
+ * ⚠️ The row is PRESENTATION only. Whether the group is gated by its ADR-0089
+ * `visibleWhen` predicate and objectui#6236 membership claim does NOT depend
+ * on it (item 1) — see `projectSectionDivider`.
+ */
+export declare function sectionDrawsDividerRow(title?: string, description?: string): boolean;
+/**
+ * The section configuration a divider row is projected FROM, already resolved
+ * by the arm that owns each resolution.
+ *
+ * ⚠️ `collapse` arrives RESOLVED — by `resolveSectionCollapse` below, the one
+ * `collapsed` / `collapsible` resolution every arm calls. It is resolved before
+ * this projection rather than inside it because the arm needs the same answer
+ * a second time: whether to take the section's fields out of the DOM.
+ */
+export interface SectionDividerSource {
+    /** Section identity; spells the row's `name`. */
+    key: string | number;
+    /** The heading, already resolved through `sectionLabel` where the arm does that. */
+    title?: string;
+    /** The authored blurb (spec `FormSection.description`). */
+    description?: string;
+    /** ADR-0089 `FormSection.visibleWhen` (#6111), unevaluated. */
+    visibleWhen?: unknown;
+    /** The objectui#6236 membership claim: RESOLVED (post-FLS) member names. */
+    members: string[];
+    /** Read by one arm only — see `projectSectionDivider`. */
+    className?: string;
+    /** Resolved by `resolveSectionCollapse`, ⛔ never here. */
+    collapse?: {
+        collapsible?: boolean;
+        collapsed?: boolean;
+        onToggle?: () => void;
+    };
+}
+/**
+ * The loud diagnostic director ruling letter E, item 3 orders for a group that
+ * declares `collapsible` (or `collapsed`) but yields neither a heading nor a
+ * blurb: 「The collapse control lives on the row. A group that … yields neither
+ * title nor description has nowhere to host the control ⇒ a loud diagnostic at
+ * validation or render …, ⛔ never fields removed from the DOM with no control」.
+ *
+ * Emitted at RENDER, through the channel this package already uses for
+ * renderer-side author mistakes — a once-per-occurrence `console.warn`, the
+ * voice of `warnSectionMemberExcludedByFields` in `sectionFields.ts`. ⛔ It
+ * only warns: the resolution below keeps such a group OPEN, so its fields stay
+ * reachable whatever the warning's reader does.
+ *
+ * The first sentence is the ruling's own wording, verbatim; the pin that holds
+ * it reads it from this function, so the two cannot drift.
+ */
+export declare function headinglessCollapseWarning(where: string): string;
+/**
+ * Forget which sections were already reported — for pins only, so each row
+ * observes its own first report. The dedupe is per module instance, and this
+ * module is internal (the package barrel does not re-export it).
+ */
+export declare function resetHeadinglessCollapseWarnings(): void;
+/**
+ * Resolve a section's authored `collapsed` / `collapsible` pair into what the
+ * page draws: whether its row is a disclosure control, whether its fields are
+ * out of the DOM right now, and what toggles them.
+ *
+ * ⭐ THE ONE RESOLUTION (objectui#9849 — director ruling letter E, item 4:
+ * 「the three `collapsed` / `collapsible` resolutions converge to the
+ * declaration-based one objectui#9780 established」). Every arm calls it: the
+ * default arm, both `DrawerForm` pushes and — since step two, per item 1's
+ * 「on every arm」 — both stacked `ModalForm` pushes.
+ *
+ * The rules, each objectui#9780's (maintainer ruling 2026-09-18, letter A):
+ *
+ *  - `collapsed` IMPLIES `collapsible`. "Collapsed by default" is an everyday
+ *    intent and `collapsed: true` its most natural spelling, so that spelling
+ *    installs the control.
+ *  - `collapsible: false` WITH `collapsed: true` is the same contradiction and
+ *    resolves the same way — collapsed wins, the control is present.
+ *  - The control is read off the DECLARATION, ⛔ never off the live state:
+ *    deriving it from the live state would delete the control the moment the
+ *    user opened the section.
+ *  - A section declaring neither member is untouched.
+ *  - ⭐ A section is only ever collapsed when it is collapsible, and it is only
+ *    collapsible when it has a divider row to carry the control — which, by
+ *    the one row rule (`sectionDrawsDividerRow`), is exactly when it yields a
+ *    heading or a blurb. So fields leave the DOM only while a control that
+ *    brings them back is on the page.
+ *  - ⭐ A section that declares the pair and yields NEITHER is rendered open
+ *    and reported (`headinglessCollapseWarning`) — letter E item 3.
+ */
+export declare function resolveSectionCollapse(declared: {
+    collapsible?: boolean;
+    collapsed?: boolean;
+}, host: {
+    /** The live state the user has toggled this section to, if any. */
+    live: boolean | undefined;
+    /** The row the section yields — the one row rule decides from these two. */
+    title: string | undefined;
+    description: string | undefined;
+    /**
+     * Who is asking and about which section, for the diagnostic only — e.g.
+     * `ObjectForm section 2 of object 'invoice'`. Also its dedupe key.
+     */
+    where: string;
+    /** Record the next live state for this section. */
+    setCollapsed: (next: boolean) => void;
+}): {
+    collapsible: boolean;
+    collapsed: boolean;
+    onToggle?: () => void;
+};
+/**
+ * Project one section configuration onto the `section-divider` row it draws.
+ *
+ * ⭐ THIS IS THE ONE PATH (objectui#9849, triage ruling 2026-09-18:
+ * 「让 section 配置到 divider 的投影只有一条路径」). Before it, six sites across
+ * `ObjectForm.tsx`, `ModalForm.tsx` and `DrawerForm.tsx` each rebuilt the row
+ * key by key, and a key one of them forgot was invisible to the author. A key
+ * added here is added for every arm at once, and a key dropped here is dropped
+ * for every arm at once, which is what makes the loss visible instead of
+ * silent.
+ *
+ * ⭐ AND ONE RULE FOR WHICH ROW (director ruling letter E, maintainer 「同意」).
+ * There is no per-arm gate any more — the enumerated four-way union this
+ * function used to take as a parameter was deleted by that ruling:
+ *
+ *  1. 「Group-level semantics are independent of the heading」 — the ADR-0089
+ *     `visibleWhen` predicate and the objectui#6236 membership claim ride
+ *     EVERY row this function returns, so a headingless group is never
+ *     un-gated, and the claim names only the group's own resolved members, so
+ *     its predicate never hides more than the group it names.
+ *  2. The VISIBLE row exists iff `title || description`
+ *     (`sectionDrawsDividerRow`); with `description` only, it is the blurb-only
+ *     row — no heading span, just the blurb (objectui#9835's shape).
+ *  3. A group with neither, that authored a predicate, still needs a carrier
+ *     for item 1: it gets a CHROME-LESS gate row — no `label`, no
+ *     `description`, so `SectionDivider` renders nothing — which exists only
+ *     to carry the predicate and the claim. It is the same shape `TabbedForm`
+ *     already emits for a degraded single-section form, spelled
+ *     `__section_gate_` like that one. A group with neither and no predicate
+ *     returns no row at all: nothing to draw, nothing to gate.
+ *
+ * The key set, and who owns each member:
+ *
+ *  - `label` — the heading. The arm resolves i18n before handing it over.
+ *  - `description` — the authored blurb (objectui#9779 / #9834 / #9849).
+ *  - `visibleWhen` — ADR-0089's section predicate (#6111). The renderer
+ *    evaluates it on this pseudo-field with the host predicate scope bound
+ *    (#6010), so copying it here is what makes the authored predicate reach an
+ *    evaluator at all.
+ *  - `fields` — the objectui#6236 membership claim: RESOLVED member names, so
+ *    the predicate gates the whole group and not just the heading.
+ *  - `colSpan` — see `DIVIDER_COL_SPAN`.
+ *  - `collapsible` / `collapsed` / `onToggle` — on the visible row only (the
+ *    control lives on the row), and only when the arm hands over a resolved
+ *    `collapse`; see `SectionDividerSource`.
+ *  - `className` — emitted only when the arm hands one over. objectstack#13626
+ *    ("retire the reads", maintainer ruling 2026-09-01) took this read off
+ *    every arm but `ModalForm`'s explicit-sections push, whose residue is
+ *    preserved here rather than retired in passing: retiring it is a second
+ *    ruling's job, and `sectionStyleKeysRetired-13626` pins the arms that
+ *    already dropped it.
+ *
+ * ⛔ Not read, on any arm: `gridClassName` — a per-section grid needs a
+ * per-section form, which the single-form structure these arms share does not
+ * have.
+ */
+export declare function projectSectionDivider(source: SectionDividerSource): FormField[];
 //# sourceMappingURL=fieldGroups.d.ts.map