@object-ui/plugin-form 17.5.0 → 17.7.0

package/dist/fieldWriteGate.d.ts

@@ -0,0 +1,116 @@
+import { SchemaLike } from '@object-ui/core';
+/**
+ * The permission surface this module consumes — structurally the subset of
+ * `usePermissions()` that answers the write question. Declared structurally so
+ * `@object-ui/plugin-form` binds to the two members it actually reads rather
+ * than to the whole context type.
+ */
+export interface FieldWritePrincipal {
+    isLoaded: boolean;
+    checkField: (object: string, field: string, action: 'read' | 'write') => boolean;
+}
+/** A field-name predicate: `true` when the caller may write that field. */
+export type FieldWriteGate = (fieldName: string) => boolean;
+/**
+ * Build the outbound write gate for one object, or `undefined` when there is
+ * no resolved principal to ask.
+ *
+ * `undefined` rather than an always-true function on purpose: the callers hand
+ * this straight to `sanitizeFormData`, whose option is absent-or-predicate, so
+ * an unresolved principal produces the byte-identical payload it produced
+ * before this gate existed.
+ */
+export declare function fieldWriteGate(perms: FieldWritePrincipal | null | undefined, objectName: string): FieldWriteGate | undefined;
+export interface ApplyFieldPermissionsOptions {
+    perms: FieldWritePrincipal | null | undefined;
+    objectName: string;
+    /** A `view`-mode form renders everything read-only already. */
+    mode?: string;
+    /**
+     * Optional hint placed on a field the caller may read but not edit, used
+     * only when the field declares no description of its own. `ObjectForm`'s
+     * simple variant is the one container that shows it.
+     */
+    deniedDescription?: string;
+}
+/**
+ * The render half for a FORM: drop what the caller may not READ, and mark what
+ * they may read but not WRITE as non-editable.
+ */
+export declare function applyFieldPermissions<T extends Record<string, any>>(fields: T[] | undefined, { perms, objectName, mode, deniedDescription }: ApplyFieldPermissionsOptions): T[] | undefined;
+/**
+ * The principal surface {@link gateFormFields} reads: the field-level resolver
+ * plus the server's effective API operation set for an object (`/me/permissions`
+ * `apiOperations`, objectstack#3391). `undefined` from it means "no effective set", which
+ * leaves the object's own affordance standing.
+ */
+export interface FormFieldPrincipal extends FieldWritePrincipal {
+    getObjectApiOperations?: (object: string) => readonly string[] | undefined;
+}
+export interface GateFormFieldsOptions extends ApplyFieldPermissionsOptions {
+    perms: FormFieldPrincipal | null | undefined;
+    /**
+     * The object schema the form resolved (its `managedBy` bucket and
+     * `userActions` opt-ins). `null` while it has not loaded, or when the form
+     * has no metadata source, reads as the default bucket.
+     */
+    objectSchema: SchemaLike | null | undefined;
+}
+/** The form-level affordance {@link closedFormAffordance} can report closed. */
+export type ClosedFormAffordance = 'create' | 'edit';
+/**
+ * Which affordance the managed-object lock found CLOSED for this form, or
+ * `undefined` when the lock does not engage (objectui#11000).
+ *
+ * It is {@link managedModeLocked}, the very predicate {@link gateFormFields}
+ * disables every drawn field on, read for its reason: `create` for a create
+ * form, `edit` for an edit form. The locked form's notice
+ * (`ClosedAffordanceNotice`) and the wizard's navigation gate read THIS, not a
+ * verdict of their own, so a form cannot explain a lock it did not draw, nor
+ * draw one it does not explain.
+ *
+ * A per-field lock never answers here: a field the caller may read but not
+ * edit ({@link applyFieldPermissions}) or a field declared `readonly` locks
+ * that one field while the form's affordance stays open.
+ */
+export declare function closedFormAffordance({ perms, objectName, mode, objectSchema, }: Pick<GateFormFieldsOptions, 'perms' | 'objectName' | 'mode' | 'objectSchema'>): ClosedFormAffordance | undefined;
+/**
+ * The ONE field-gate step every `ObjectForm` layout draws its RESOLVED fields
+ * through (objectui#10612): the default arm (flat and sectioned), `DrawerForm`
+ * and `ModalForm` (sections, derived field groups and flat), and `TabbedForm`,
+ * `SplitForm` and `WizardForm` (sections).
+ *
+ * Two gates, in one pass, so no layout can apply one and skip the other:
+ *
+ *  1. field-level security — {@link applyFieldPermissions}: drop what the
+ *     caller may not READ, lock what they may read but not WRITE;
+ *  2. the managed-object lock — every drawn field is `disabled` when
+ *     {@link managedModeLocked} says the mode's affordance is closed. Only
+ *     `disabled`, not `readOnly`: the default arm's lock always drew a
+ *     disabled input, and the submit button is left as it is.
+ *
+ * Before this step the lock was stamped by the default arm's field generator
+ * alone, so the drawer, modal, tabbed, split and wizard layouts drew live
+ * inputs on a managed object whose write the server refuses (objectui#10613,
+ * folded into objectui#10612). It runs on the resolved list rather than in a
+ * generator, so every drawn field is locked — an inline `customFields` member
+ * and an already-built section entry as much as a field generated from the
+ * object — which is what "blanket" says.
+ *
+ * Entries with no `name` pass through untouched, as in the render pass.
+ */
+export declare function gateFormFields<T extends Record<string, any>>(fields: T[] | undefined, { objectSchema, ...options }: GateFormFieldsOptions): T[] | undefined;
+/**
+ * The render half for a line-items GRID: the same pass over its columns — drop
+ * what the caller may not READ, and lock the cells of what they may read but
+ * not WRITE (objectui#10163).
+ *
+ * ⛔ Not a second gate: the verdict is {@link gateByPermission}'s, the same one
+ * the three form containers render through, so the grid and the form above it
+ * cannot disagree about which field is refused. A column that is refused
+ * replaces any `readonlyWhen` it declared — a lock on every row already covers
+ * every row a narrower lock would. Rows are untouched: whether a line may be
+ * added or removed stays the container's own answer.
+ */
+export declare function applyColumnPermissions<T extends Record<string, any>>(columns: T[] | undefined, { perms, objectName }: Pick<ApplyFieldPermissionsOptions, 'perms' | 'objectName'>): T[] | undefined;
+//# sourceMappingURL=fieldWriteGate.d.ts.map

package/dist/fieldWriteGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldWriteGate.d.ts","sourceRoot":"","sources":["../src/fieldWriteGate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,KAAK,OAAO,CAAC;CAClF;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAC7C,UAAU,EAAE,MAAM,GACjB,cAAc,GAAG,SAAS,CAG5B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAqCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EACvB,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,4BAA4B,GAC3E,CAAC,EAAE,GAAG,SAAS,CAMjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5E;AAED,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B;IACzE,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C;;;;OAIG;IACH,YAAY,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7C;AAoCD,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,UAAU,EACV,IAAI,EACJ,YAAY,GACb,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,CAAC,GAC5E,oBAAoB,GACpB,SAAS,CAGZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1D,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EACvB,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,EAAE,qBAAqB,GAClD,CAAC,EAAE,GAAG,SAAS,CAOjB;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClE,OAAO,EAAE,CAAC,EAAE,GAAG,SAAS,EACxB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,GAAG,YAAY,CAAC,GAChF,CAAC,EAAE,GAAG,SAAS,CAKjB"}

package/dist/flatFields.d.ts

@@ -0,0 +1,30 @@
+import { FormField } from '@object-ui/types';
+import { SectionFieldsContext } from './sectionFields.js';
+export interface FlatFieldsContext extends SectionFieldsContext {
+    /**
+     * The caller's explicit field whitelist, in render order. Entries are field
+     * names or objects carrying one (`{ name }`). Omitted → every field the
+     * object schema declares, in schema order.
+     */
+    fields?: Array<string | Record<string, any>>;
+    /**
+     * The authored inline members (`schema.customFields`), MERGED over the
+     * generated set exactly as `ObjectForm` merges them — override by name in
+     * place, keep the rest, append the unmatched in authored order
+     * (objectui#10073; the rule lives in `customFieldsMerge.ts`).
+     */
+    customFields?: FormField[];
+}
+/**
+ * Build the runtime `FormField` list for a container rendering an object's
+ * fields flat (no sections).
+ *
+ * Fields the object schema does not declare are SKIPPED — the flat containers
+ * have always dropped them rather than rendering `fromObjectSchema`'s bare
+ * `input` stub, and a whitelist naming a field the object does not have is an
+ * authoring error the form should not paper over with an untyped control. A
+ * `customFields` member naming such a field is drawn in its place: the member
+ * is a whole definition, not an untyped stub.
+ */
+export declare function buildFlatFields(ctx: FlatFieldsContext): FormField[];
+//# sourceMappingURL=flatFields.d.ts.map

package/dist/flatFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatFields.d.ts","sourceRoot":"","sources":["../src/flatFields.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAiD,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3G,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAAE,CA8BnE"}

package/dist/formChrome.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * What the submitter is told when a DECLARED `navigateOnSuccess` produced no
+ * destination — objectui#5034 point 2.
+ *
+ * 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.
+ *
+ * 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."
+ *
+ * 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
+ * an acceptance rule into user-visible prose, which objectui#5034 has since
+ * narrowed once already. The diagnosable detail — the template the author
+ * actually wrote — goes to `console.warn` at each call site instead.
+ *
+ * The submitter sees it (it is the toast's description), so it is pack key
+ * `form.navigateRefused` and each form renders `t('form.navigateRefused')`
+ * (objectui#11039). This constant is that key's English default, read from the
+ * table above so there is one spelling of it; `WizardForm` re-exports it,
+ * because that is where it used to live and where its tests import it from.
+ * 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.
+ */
+export declare const NAVIGATE_ON_SUCCESS_REFUSED_NOTE: string;
+/**
+ * The form family's feedback chrome. Falls back to the English table above
+ * when no i18n provider is mounted, or when the mounted catalogue predates
+ * these keys (`form.errorLoading` is the probe).
+ */
+export declare const useFormChromeTranslation: () => {
+    t: (key: string, options?: Record<string, unknown>) => string;
+    language: string;
+} | {
+    t: import('i18next').TFunction<string, undefined>;
+    language: string;
+};
+//# sourceMappingURL=formChrome.d.ts.map

package/dist/formChrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formChrome.d.ts","sourceRoot":"","sources":["../src/formChrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6EH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,gCAAgC,QAA+C,CAAC;AAE7F;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;4BAvHpC,CAAC;;;;;CA0HD,CAAC"}

package/dist/index.d.ts

@@ -1,27 +1,133 @@
-import { ObjectForm } from './ObjectForm';
+import { ObjectForm } from './ObjectForm.js';
 export { ObjectForm };
-export type { ObjectFormProps } from './ObjectForm';
-export { FormSectionContainer } from './FormSection';
-export type { FormSectionContainerProps } from './FormSection';
-export { applyAutoLayout, inferColumns, inferModalSize, isWideFieldType, isAutoGeneratedFieldType, applyAutoColSpan, containerGridColsFor, filterCreateModeFields, filterSystemFields, filterAutoGeneratedFields, } from './autoLayout';
-export { TabbedForm } from './TabbedForm';
-export type { TabbedFormProps, TabbedFormSchema, FormSectionConfig } from './TabbedForm';
-export { WizardForm } from './WizardForm';
-export type { WizardFormProps, WizardFormSchema } from './WizardForm';
-export { SplitForm } from './SplitForm';
-export type { SplitFormProps, SplitFormSchema } from './SplitForm';
-export { DrawerForm } from './DrawerForm';
-export type { DrawerFormProps, DrawerFormSchema } from './DrawerForm';
-export { ModalForm } from './ModalForm';
-export type { ModalFormProps, ModalFormSchema } from './ModalForm';
-export { EmbeddableForm } from './EmbeddableForm';
-export type { EmbeddableFormProps, EmbeddableFormConfig, EmbeddableFormTexts } from './EmbeddableForm';
-export { FormAnalytics } from './FormAnalytics';
-export type { FormAnalyticsProps, FormSubmissionMetric } from './FormAnalytics';
-export { MasterDetailForm } from './MasterDetailForm';
-export type { MasterDetailFormProps, MasterDetailFormSchema, MasterDetailDetailConfig, } from './MasterDetailForm';
-export { LineItemsPanel } from './LineItemsPanel';
-export type { LineItemsPanelSchema } from './LineItemsPanel';
-export { deriveDetail, deriveColumns, deriveFormFields, findRelationshipField, resolveInlineMode } from './deriveMasterDetail';
-export type { DerivedDetail, InlineMode } from './deriveMasterDetail';
+export type { ObjectFormComponentProps } from './ObjectForm.js';
+/**
+ * @deprecated Use `ObjectFormComponentProps`. Renamed in objectui#4650 because
+ * `@objectstack/spec/ui` owns `ObjectFormProps` from 17.0.0, where it means the
+ * AUTHORED props document of the `object-form` element — not this component's
+ * props. The alias denotes the SAME type and is kept only so existing importers
+ * keep compiling.
+ */
+export type { ObjectFormComponentProps as ObjectFormProps } from './ObjectForm.js';
+export { FormSectionContainer } from './FormSection.js';
+export type { FormSectionContainerProps } from './FormSection.js';
+export { applyAutoLayout, inferColumns, inferModalSize, isWideFieldType, isAutoGeneratedFieldType, applyAutoColSpan, containerGridColsFor, filterCreateModeFields, filterSystemFields, filterAutoGeneratedFields, } from './autoLayout.js';
+export { TabbedForm } from './TabbedForm.js';
+export type { TabbedFormProps, TabbedFormSchema, FormSectionConfig } from './TabbedForm.js';
+export { WizardForm } from './WizardForm.js';
+export type { WizardFormProps, WizardFormSchema, WizardStepConfig } from './WizardForm.js';
+export { SplitForm } from './SplitForm.js';
+export type { SplitFormProps, SplitFormSchema } from './SplitForm.js';
+export { DrawerForm } from './DrawerForm.js';
+export type { DrawerFormProps, DrawerFormSchema } from './DrawerForm.js';
+export { ModalForm } from './ModalForm.js';
+export type { ModalFormProps, ModalFormSchema } from './ModalForm.js';
+export { EmbeddableForm } from './EmbeddableForm.js';
+export type { EmbeddableFormProps, EmbeddableFormConfig, EmbeddableFormTexts } from './EmbeddableForm.js';
+export { FormAnalytics } from './FormAnalytics.js';
+export type { FormAnalyticsProps, FormSubmissionMetric } from './FormAnalytics.js';
+export { MasterDetailForm } from './MasterDetailForm.js';
+export type { MasterDetailFormProps, MasterDetailFormSchema, MasterDetailDetailConfig, } from './MasterDetailForm.js';
+export { LineItemsPanel } from './LineItemsPanel.js';
+export type { LineItemsPanelSchema } from './LineItemsPanel.js';
+export { deriveDetail, deriveColumns, deriveFormFields, findRelationshipField, resolveInlineMode } from './deriveMasterDetail.js';
+export type { DerivedDetail, InlineMode, ChildObjectSchemaLike } from './deriveMasterDetail.js';
+/**
+ * The CREATE-payload rule this package owns, published for the OTHER form
+ * renderer (objectui#6059).
+ *
+ * `omitServerResolvedDefaults` is a pure function over a values object and an
+ * object schema — no React, no registry, no container — and it is the
+ * COMPOSITION of two `@object-ui/core` predicates (`isRuntimeDefault` AND
+ * `isMissingForRequired`, on create only) rather than a third opinion about
+ * either. It stayed module-private through the whole #4047 / #4068 / #4069 /
+ * #4085 / #5683 / #5727 / #5883 chain, so the console's `FormPage` — the SECOND
+ * form renderer in this repo — had to spell that composition out by hand for
+ * #5883, and the next renderer would have had to as well. Neither PREDICATE was
+ * ever copied (both live in `@object-ui/core` precisely so they cannot fork),
+ * but two hand-written copies of the composition are still free to disagree
+ * about a case neither author had in mind. One importable function is not.
+ *
+ * `isRequiredInForm` travels with it because each one's docblock names the
+ * other as its half: excusing a server-owned field from `required` and then
+ * submitting the key anyway is not half a fix, it is no fix. A consumer able to
+ * reach one and not the other can build exactly that state, which is the defect
+ * #4069 and #5883 closed on the two chains separately.
+ *
+ * Deliberately NOT the rest of `schemaDefaults.ts`. `seedCreateValues`,
+ * `schemaDefaultValues`, `isSeedableDefault`, `isCreateFormMode` and
+ * `SeedContext` are adjacent, not asked for — no consumer outside this package
+ * has needed them, and every added name is published surface somebody then has
+ * to keep. `isRuntimeDefault` stays out for a stronger reason: it is
+ * `@object-ui/core`'s to publish, this module only re-exports it for its own
+ * call sites, and a second published spelling of one classifier is the very
+ * thing #4085 collapsed.
+ */
+export { omitServerResolvedDefaults, isRequiredInForm } from './schemaDefaults.js';
+/**
+ * The `form.sections[].group` RESOLVER, published for the third form-section
+ * consumer (objectui#8641).
+ *
+ * `resolveSectionGroupReferences` replaces every `{ group: 'x' }` section with
+ * the section that group declares, and returns its input UNCHANGED — the same
+ * array reference — when no section uses the reference form. It is a pure
+ * function over plain data: no React, no registry, no container.
+ *
+ * ## Why it is published rather than copied
+ *
+ * `apps/console`'s `FormPage` has its OWN section builder (`buildSections`),
+ * on none of this package's code path, and it read `sec.fields ?? []` — so a
+ * spec-legal `{ group }` section produced a section with no label and no
+ * fields, measured in the DOM as an empty bordered card with zero inputs on
+ * both the internal `/forms/:name` and public `/f/:slug` routes. That is the
+ * silent-drop class objectui#7051 closed HERE, arriving at a renderer #7051's
+ * fix could not reach.
+ *
+ * The standing constraint of objectui#7051 / objectstack#13855 is that no
+ * assembly rule may be re-implemented on the objectui side — not declared
+ * order, not the empty-group drop, not the ungrouped trailing bucket, not the
+ * collapse / `visibleWhen` passthrough. Every one of those comes from
+ * `deriveFieldGroupLayout` (ADR-0085 §5) through this package's ONE adapter,
+ * `deriveFieldGroupSections`, which this resolver calls. A consumer that
+ * reached for `deriveFieldGroupLayout` directly would have to re-spell the
+ * `collapse` enum -> `{ collapsible, collapsed }` mapping and the `visibleWhen`
+ * passthrough to land on a section shape, which is that constraint's exact
+ * prohibition. So the importable resolver is the only arm that keeps one
+ * assembler and one behaviour for all three consumers.
+ *
+ * This is the same surface decision as objectui#6059's create-payload pair,
+ * for the same file, and it is deliberately as small: the resolver and the
+ * options type its signature requires (objectui#7324's rule — a consumer must
+ * be able to NAME what it passes; a type adds no runtime surface).
+ * `hasSectionGroupReference` stays module-private because the resolver already
+ * answers it by returning its input unchanged, and `resetSectionGroupReports`
+ * stays private because it is this package's own test seam.
+ */
+export { resolveSectionGroupReferences } from './sectionGroups.js';
+export type { ResolveSectionGroupsOptions } from './sectionGroups.js';
+/**
+ * The parameter types those published signatures require, so a consumer can
+ * NAME what it must pass (objectui#7324).
+ *
+ * Both were unnameable: `ChildObjectSchemaLike` is the `childSchema` of the
+ * five derive functions exported above, and `FieldDefaultsSchemaLike` is the
+ * `objectSchema` of `omitServerResolvedDefaults`. Neither reached this barrel,
+ * so a host held them in a variable it could not annotate and wrote the shape
+ * out by hand instead — a producer-owned shape copied into every consumer,
+ * which is what `declared = enforced` exists to prevent.
+ *
+ * Two names, not one. They arrived carrying the SAME name (`ObjectSchemaLike`)
+ * in two files, and they are not the same type: measured with `tsc`, the
+ * defaults one is a strict subtype of the child one, and the compiler calls
+ * them mutually assignable ONLY because the child one's field values are
+ * `any` — swap that single `any` for `unknown` and the child -> defaults
+ * direction fails (TS2322). Lifting either under the shared name would have
+ * put a name on this package's public surface that already meant something
+ * else two files over, with nothing in the name to say which.
+ *
+ * These are types, not values: they add no runtime surface, and each is the
+ * type a signature already published requires — not an adjacent name lifted
+ * because it was nearby.
+ */
+export type { FieldDefaultsSchemaLike } from './schemaDefaults.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/H,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;GAMG;AACH,YAAY,EAAE,wBAAwB,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/H,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}