@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.7

package/dist/esm/components/form/automated/ResourceFormActionsContext.d.ts

@@ -56,6 +56,16 @@ export interface ResourceFormActionsValue {
      * indicators stay at the top. `null`/absent renders nothing.
      */
     submissionNotice?: ReactNode;
+    /**
+     * Lets a template that navigates in steps take over the footer. A wizard inside a create dialog showed its
+     * own Previous/Next row AND the host's Cancel/Create row: "Create" on step 1 submitted without the later steps
+     * ever being seen, and the last step had two submit buttons. A template that claims the footer renders these
+     * same buttons inside its own navigation (the host's submit on its last step), and the host footer renders
+     * nothing while any claim is held. Returns the release.
+     */
+    claimFooter?: () => () => void;
+    /** True while a template holds a `claimFooter` claim; the host footer then renders nothing. */
+    footerClaimed?: boolean;
 }
 export interface ResourceFormActionsProviderProps {
     value: ResourceFormActionsValue;
@@ -78,4 +88,24 @@ export declare function ResourceFormActionsProvider({ value, children }: Resourc
  *   host owns the submit row (non-null).
  */
 export declare function useOptionalResourceFormActions(): ResourceFormActionsValue | null;
+/**
+ * Host-owned form actions footer. `ResourceAutomatedForm` appends its
+ * operation-aware submit row (+ optional draft-save button) after the layout
+ * template; this lays them out as a right-aligned footer row (`justify-end`)
+ * with a horizontal gap, so the submit action reads as a proper form footer
+ * instead of a bare button flushed to the inline-start edge. Wraps on narrow
+ * widths. Renders nothing when no host actions are present (standalone
+ * `FormLayout` usage owns its own `<SubmitButton>`).
+ *
+ * `mt-section` is owned HERE, deliberately: the footer's top gap used to be
+ * delegated to `AutomatedForm`'s `space-y-section` on the `<form>` element, but
+ * `Form` wraps ALL children in one `display: contents` fieldset (the disabled
+ * cascade carrier), so the form has exactly one direct child and every
+ * `space-y-*` on it is structurally inert (`> * + *` never reaches
+ * grandchildren). The footer therefore rendered flush against the template's
+ * last row on every resource form (2026-08-19). The footer is the seam's only
+ * consumer, so it carries the margin itself instead of reworking the Form
+ * layout contract.
+ */
+export declare function HostFormActionsFooter(): React.JSX.Element | null;
 //# sourceMappingURL=ResourceFormActionsContext.d.ts.map

package/dist/esm/components/form/automated/ResourceFormActionsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceFormActionsContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/ResourceFormActionsContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,YAAY,EAAE,SAAS,CAAC;IACxB,oEAAoE;IACpE,eAAe,EAAE,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B;AAYD,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,wBAAwB,CAAC;IAChC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gCAAgC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAMpH;AAMD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,IAAI,wBAAwB,GAAG,IAAI,CAEhF"}
+{"version":3,"file":"ResourceFormActionsContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/ResourceFormActionsContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,YAAY,EAAE,SAAS,CAAC;IACxB,oEAAoE;IACpE,eAAe,EAAE,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,MAAM,IAAI,CAAC;IAC/B,+FAA+F;IAC/F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAYD,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,wBAAwB,CAAC;IAChC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gCAAgC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAMpH;AAMD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,IAAI,wBAAwB,GAAG,IAAI,CAEhF;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAgBhE"}

package/dist/esm/components/form/automated/ResourceFormActionsContext.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * ResourceFormActionsContext — carries resource-level form actions (submit
  * button, draft save button) from `ResourceAutomatedForm` into the form
@@ -63,4 +63,33 @@ export function ResourceFormActionsProvider({ value, children }) {
 export function useOptionalResourceFormActions() {
     return useContext(ResourceFormActionsContext);
 }
+// =============================================================================
+// HOST FOOTER
+// =============================================================================
+/**
+ * Host-owned form actions footer. `ResourceAutomatedForm` appends its
+ * operation-aware submit row (+ optional draft-save button) after the layout
+ * template; this lays them out as a right-aligned footer row (`justify-end`)
+ * with a horizontal gap, so the submit action reads as a proper form footer
+ * instead of a bare button flushed to the inline-start edge. Wraps on narrow
+ * widths. Renders nothing when no host actions are present (standalone
+ * `FormLayout` usage owns its own `<SubmitButton>`).
+ *
+ * `mt-section` is owned HERE, deliberately: the footer's top gap used to be
+ * delegated to `AutomatedForm`'s `space-y-section` on the `<form>` element, but
+ * `Form` wraps ALL children in one `display: contents` fieldset (the disabled
+ * cascade carrier), so the form has exactly one direct child and every
+ * `space-y-*` on it is structurally inert (`> * + *` never reaches
+ * grandchildren). The footer therefore rendered flush against the template's
+ * last row on every resource form (2026-08-19). The footer is the seam's only
+ * consumer, so it carries the margin itself instead of reworking the Form
+ * layout contract.
+ */
+export function HostFormActionsFooter() {
+    const actions = useOptionalResourceFormActions();
+    // A step-navigating template (a wizard) renders these buttons in its own navigation row.
+    if (!actions || actions.footerClaimed)
+        return null;
+    return (_jsxs("div", { className: "mt-section flex flex-col gap-element", children: [actions.submissionNotice, _jsxs("div", { className: "flex flex-wrap items-center justify-end gap-element", children: [actions.cancelButton, actions.draftSaveButton, actions.submitButton] })] }));
+}
 //# sourceMappingURL=ResourceFormActionsContext.js.map

package/dist/esm/components/form/automated/ResourceFormActionsContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceFormActionsContext.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/ResourceFormActionsContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA8BzD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,0BAA0B,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC;AAWxF;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAoC;IAC/F,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC9C,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC","sourcesContent":["/**\n * ResourceFormActionsContext — carries resource-level form actions (submit\n * button, draft save button) from `ResourceAutomatedForm` into the form\n * template tree.\n *\n * **Why this exists (host-owned submit row):**\n *\n * `ResourceAutomatedForm` always renders its own operation-aware submit row —\n * a submit button labelled from the resource operation vocabulary\n * (`components.RESOURCES_LAYOUTS_CREATE.{create|save|publish|...}`), plus the\n * optional draft-save button. The buttons are appended AFTER the layout\n * template by a thin wrapper that reads them from this context, so the\n * template component identity stays stable while reactive button state\n * (isSubmitting, isSavingDraft) updates via context instead of remounting\n * the template tree.\n *\n * **Cross-cutting contract — auto-inject suppression:**\n *\n * The presence of this context is the signal that a resource-form host owns\n * the submit row. `FormLayout` reads it via `useOptionalResourceFormActions()`\n * and suppresses its automatic `<SubmitButton>` injection when a host is\n * present. Without this, every developer-authored `layout.edit` template\n * using a bare `<FormLayout>` under `ResourceAutomatedForm` would render TWO\n * submit buttons: the auto-injected generic one (i18n fallback\n * `components.LOW_LEVEL_FORM_MESSAGE.submitSave`) and the host's\n * operation-aware one. The generated-template path already avoids this via\n * `includeSubmitButton: false` → `autoInjectSubmitButton={false}`; this\n * context closes the same gap for explicit templates, which the framework\n * cannot force a prop onto.\n *\n * Templates rendered under `ResourceAutomatedForm` must therefore NOT place\n * their own `<SubmitButton>` — the host appends the submit row in all cases.\n * Standalone `FormLayout` usage (auth forms, direct `AutomatedForm` callers)\n * is unaffected: no provider means no suppression.\n */\n\nimport React, { createContext, useContext } from 'react';\nimport type { ReactNode } from 'react';\n\n// =============================================================================\n// CONTEXT VALUE\n// =============================================================================\n\nexport interface ResourceFormActionsValue {\n  /** Operation-aware submit button (e.g. \"Create\" / \"Save\" / \"Publish\"). */\n  submitButton: ReactNode;\n  /** Draft-save button when draft mode is enabled, otherwise null. */\n  draftSaveButton: ReactNode;\n  /**\n   * Secondary Cancel button (audit D5) — present when the host supplied an\n   * `onCancel` (overlay-hosted forms wire the modal-close path here so Cancel\n   * behaves exactly like the top-right X). Rendered BEFORE the draft/submit\n   * buttons in the footer row. `null`/absent renders nothing.\n   */\n  cancelButton?: ReactNode;\n  /**\n   * Submission-level notice rendered in the actions footer, directly ABOVE the\n   * submit row — e.g. the version-conflict banner. Submission outcomes belong\n   * next to the button that produced them (a long form can scroll the top-of-form\n   * banner out of view), so the host threads it here instead of rendering it at\n   * the top of the form. Ambient (non-submission) notices like remote-update\n   * indicators stay at the top. `null`/absent renders nothing.\n   */\n  submissionNotice?: ReactNode;\n}\n\n// =============================================================================\n// REACT CONTEXT\n// =============================================================================\n\nconst ResourceFormActionsContext = createContext<ResourceFormActionsValue | null>(null);\n\n// =============================================================================\n// PROVIDER\n// =============================================================================\n\nexport interface ResourceFormActionsProviderProps {\n  value: ResourceFormActionsValue;\n  children: ReactNode;\n}\n\n/**\n * Provides the host-owned form actions to the template tree.\n * Placed by `ResourceAutomatedForm` around `AutomatedForm` so both the\n * template wrapper (which renders the buttons) and skeleton components\n * (which observe host ownership) can read it.\n */\nexport function ResourceFormActionsProvider({ value, children }: ResourceFormActionsProviderProps): React.JSX.Element {\n  return (\n    <ResourceFormActionsContext.Provider value={value}>\n      {children}\n    </ResourceFormActionsContext.Provider>\n  );\n}\n\n// =============================================================================\n// HOOKS\n// =============================================================================\n\n/**\n * Read the resource form actions if a resource-form host provides them.\n * Returns `null` outside `ResourceAutomatedForm` (standalone forms, auth).\n *\n * Consumers:\n * - `ResourceAutomatedForm` template wrappers — render the buttons.\n * - `FormLayout` — suppress automatic `<SubmitButton>` injection when a\n *   host owns the submit row (non-null).\n */\nexport function useOptionalResourceFormActions(): ResourceFormActionsValue | null {\n  return useContext(ResourceFormActionsContext);\n}\n"]}
+{"version":3,"file":"ResourceFormActionsContext.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/ResourceFormActionsContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAwCzD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,0BAA0B,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC;AAWxF;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAoC;IAC/F,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC9C,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,8BAA8B,EAAE,CAAC;IACjD,yFAAyF;IACzF,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,CACL,eAAK,SAAS,EAAC,sCAAsC,aAGlD,OAAO,CAAC,gBAAgB,EACzB,eAAK,SAAS,EAAC,qDAAqD,aACjE,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,YAAY,IACjB,IACF,CACP,CAAC;AACJ,CAAC","sourcesContent":["/**\n * ResourceFormActionsContext — carries resource-level form actions (submit\n * button, draft save button) from `ResourceAutomatedForm` into the form\n * template tree.\n *\n * **Why this exists (host-owned submit row):**\n *\n * `ResourceAutomatedForm` always renders its own operation-aware submit row —\n * a submit button labelled from the resource operation vocabulary\n * (`components.RESOURCES_LAYOUTS_CREATE.{create|save|publish|...}`), plus the\n * optional draft-save button. The buttons are appended AFTER the layout\n * template by a thin wrapper that reads them from this context, so the\n * template component identity stays stable while reactive button state\n * (isSubmitting, isSavingDraft) updates via context instead of remounting\n * the template tree.\n *\n * **Cross-cutting contract — auto-inject suppression:**\n *\n * The presence of this context is the signal that a resource-form host owns\n * the submit row. `FormLayout` reads it via `useOptionalResourceFormActions()`\n * and suppresses its automatic `<SubmitButton>` injection when a host is\n * present. Without this, every developer-authored `layout.edit` template\n * using a bare `<FormLayout>` under `ResourceAutomatedForm` would render TWO\n * submit buttons: the auto-injected generic one (i18n fallback\n * `components.LOW_LEVEL_FORM_MESSAGE.submitSave`) and the host's\n * operation-aware one. The generated-template path already avoids this via\n * `includeSubmitButton: false` → `autoInjectSubmitButton={false}`; this\n * context closes the same gap for explicit templates, which the framework\n * cannot force a prop onto.\n *\n * Templates rendered under `ResourceAutomatedForm` must therefore NOT place\n * their own `<SubmitButton>` — the host appends the submit row in all cases.\n * Standalone `FormLayout` usage (auth forms, direct `AutomatedForm` callers)\n * is unaffected: no provider means no suppression.\n */\n\nimport React, { createContext, useContext } from 'react';\nimport type { ReactNode } from 'react';\n\n// =============================================================================\n// CONTEXT VALUE\n// =============================================================================\n\nexport interface ResourceFormActionsValue {\n  /** Operation-aware submit button (e.g. \"Create\" / \"Save\" / \"Publish\"). */\n  submitButton: ReactNode;\n  /** Draft-save button when draft mode is enabled, otherwise null. */\n  draftSaveButton: ReactNode;\n  /**\n   * Secondary Cancel button (audit D5) — present when the host supplied an\n   * `onCancel` (overlay-hosted forms wire the modal-close path here so Cancel\n   * behaves exactly like the top-right X). Rendered BEFORE the draft/submit\n   * buttons in the footer row. `null`/absent renders nothing.\n   */\n  cancelButton?: ReactNode;\n  /**\n   * Submission-level notice rendered in the actions footer, directly ABOVE the\n   * submit row — e.g. the version-conflict banner. Submission outcomes belong\n   * next to the button that produced them (a long form can scroll the top-of-form\n   * banner out of view), so the host threads it here instead of rendering it at\n   * the top of the form. Ambient (non-submission) notices like remote-update\n   * indicators stay at the top. `null`/absent renders nothing.\n   */\n  submissionNotice?: ReactNode;\n  /**\n   * Lets a template that navigates in steps take over the footer. A wizard inside a create dialog showed its\n   * own Previous/Next row AND the host's Cancel/Create row: \"Create\" on step 1 submitted without the later steps\n   * ever being seen, and the last step had two submit buttons. A template that claims the footer renders these\n   * same buttons inside its own navigation (the host's submit on its last step), and the host footer renders\n   * nothing while any claim is held. Returns the release.\n   */\n  claimFooter?: () => () => void;\n  /** True while a template holds a `claimFooter` claim; the host footer then renders nothing. */\n  footerClaimed?: boolean;\n}\n\n// =============================================================================\n// REACT CONTEXT\n// =============================================================================\n\nconst ResourceFormActionsContext = createContext<ResourceFormActionsValue | null>(null);\n\n// =============================================================================\n// PROVIDER\n// =============================================================================\n\nexport interface ResourceFormActionsProviderProps {\n  value: ResourceFormActionsValue;\n  children: ReactNode;\n}\n\n/**\n * Provides the host-owned form actions to the template tree.\n * Placed by `ResourceAutomatedForm` around `AutomatedForm` so both the\n * template wrapper (which renders the buttons) and skeleton components\n * (which observe host ownership) can read it.\n */\nexport function ResourceFormActionsProvider({ value, children }: ResourceFormActionsProviderProps): React.JSX.Element {\n  return (\n    <ResourceFormActionsContext.Provider value={value}>\n      {children}\n    </ResourceFormActionsContext.Provider>\n  );\n}\n\n// =============================================================================\n// HOOKS\n// =============================================================================\n\n/**\n * Read the resource form actions if a resource-form host provides them.\n * Returns `null` outside `ResourceAutomatedForm` (standalone forms, auth).\n *\n * Consumers:\n * - `ResourceAutomatedForm` template wrappers — render the buttons.\n * - `FormLayout` — suppress automatic `<SubmitButton>` injection when a\n *   host owns the submit row (non-null).\n */\nexport function useOptionalResourceFormActions(): ResourceFormActionsValue | null {\n  return useContext(ResourceFormActionsContext);\n}\n\n// =============================================================================\n// HOST FOOTER\n// =============================================================================\n\n/**\n * Host-owned form actions footer. `ResourceAutomatedForm` appends its\n * operation-aware submit row (+ optional draft-save button) after the layout\n * template; this lays them out as a right-aligned footer row (`justify-end`)\n * with a horizontal gap, so the submit action reads as a proper form footer\n * instead of a bare button flushed to the inline-start edge. Wraps on narrow\n * widths. Renders nothing when no host actions are present (standalone\n * `FormLayout` usage owns its own `<SubmitButton>`).\n *\n * `mt-section` is owned HERE, deliberately: the footer's top gap used to be\n * delegated to `AutomatedForm`'s `space-y-section` on the `<form>` element, but\n * `Form` wraps ALL children in one `display: contents` fieldset (the disabled\n * cascade carrier), so the form has exactly one direct child and every\n * `space-y-*` on it is structurally inert (`> * + *` never reaches\n * grandchildren). The footer therefore rendered flush against the template's\n * last row on every resource form (2026-08-19). The footer is the seam's only\n * consumer, so it carries the margin itself instead of reworking the Form\n * layout contract.\n */\nexport function HostFormActionsFooter(): React.JSX.Element | null {\n  const actions = useOptionalResourceFormActions();\n  // A step-navigating template (a wizard) renders these buttons in its own navigation row.\n  if (!actions || actions.footerClaimed) return null;\n  return (\n    <div className=\"mt-section flex flex-col gap-element\">\n      {/* Submission-level notice (e.g. version conflict) sits directly above the\n          submit row so the user reads it where the action happens. */}\n      {actions.submissionNotice}\n      <div className=\"flex flex-wrap items-center justify-end gap-element\">\n        {actions.cancelButton}\n        {actions.draftSaveButton}\n        {actions.submitButton}\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/esm/components/form/automated/TemplatePlacedFieldsContext.d.ts

@@ -0,0 +1,79 @@
+import { type ReactNode } from 'react';
+/**
+ * Which of a form's top-level fields an authored template PLACES — for the one host that must know:
+ * `ResourceAutomatedForm` rendering a resource's `layout.edit` template for a custom operation.
+ *
+ * A template is written against the resource's own fields, and a custom operation keeps it when every
+ * field of its request is a resource field (`resolveAuthoredEditTemplateForOperation`). That rule says a
+ * field COULD have a slot, not that the template has one. A request field no slot places would never be
+ * rendered, so the host appends it after the template, generated like the rest of a generated form.
+ *
+ * Two sources report, because neither sees everything:
+ * - each mounted `FormField` reports its own top-level field — the only way to see a slot inside a
+ *   custom component (a field component that wraps `FormField` with its own props);
+ * - each `Section` and each grouped section reports every slot it holds, read from its elements
+ *   (`collectPlacedFieldPaths`) — the only way to see a slot whose panel is not mounted (an inactive
+ *   tab, a closed collapsible, an unchosen discriminator variant, a later wizard step).
+ *
+ * Still invisible: a control a custom component renders with its own `useController` (never seen — only
+ * `FormField` reports itself), and a `FormField` a custom component renders internally, or one reached
+ * through a render-prop function, until it mounts. The static reports read the JSX under a `FormLayout`
+ * or a `Section` only.
+ *
+ * The host reads the set ONCE, after the template's first layout pass, and never retracts an appended
+ * field: removing a mounted control would unregister its value.
+ */
+export interface TemplatePlacedFieldsRegistry {
+    place: (topLevelField: string) => () => void;
+    placedFields: () => ReadonlySet<string>;
+}
+export declare const TemplatePlacedFieldsContext: import("react").Context<TemplatePlacedFieldsRegistry>;
+/** An identity-stable registry for one template render. */
+export declare function useTemplatePlacedFieldsRegistry(): TemplatePlacedFieldsRegistry;
+/**
+ * The top-level field a slot path writes to: `notifications.email` → `notifications`, and an array item
+ * `steps[0].afterMinutes` → `steps`. The same root `FormField` computes.
+ */
+export declare function topLevelFieldOf(path: string): string;
+/**
+ * Declares a component that edits the field named by its `name` prop without being a `FormField` slot —
+ * the skeleton `ArrayField`, whose item slots do not exist while the array is empty.
+ */
+export declare function declarePlacesNamedField(component: object): void;
+/**
+ * Every field path a subtree places, read from its ELEMENTS, whatever else it holds. This is not the hide
+ * decision (`listPlacedFieldSlots`, which gives up at the first piece of other content): a slot beside a
+ * paragraph, inside a nested section, a wizard step or an unchosen `DiscriminatorSwitch` variant is still
+ * placed. Any prop holding React nodes is followed, not only `children`, so a variant map or a fallback is
+ * seen. What it cannot see is described once, on `TemplatePlacedFieldsRegistry`: a `useController`
+ * control, and a `FormField` rendered inside a custom component or a render prop until it mounts.
+ *
+ * It walks arbitrary prop DATA, so it is defensive about it:
+ * - only React elements are followed; a Date, a function, a class instance places nothing;
+ * - `Children.toArray` never sees a prop's data (it throws on a plain object);
+ * - a cycle stops at the first value that is already an ANCESTOR on the current path. A value reached
+ *   twice by different paths is walked each time, because it may sit under a different `ObjectScope`
+ *   (one address fragment under `billing` and under `shipping` places two fields);
+ * - an iterator that is its own iterable (a generator, `set.values()`) would be consumed before its owner
+ *   renders it, so it is never read; an iterable that hands out a fresh iterator (an array, a Set, a Map)
+ *   is read, at most `MAX_ITERABLE_ENTRIES` entries, and an iterator cut short is closed as `for…of`
+ *   would close it. An iterable handing out a SHARED one-shot iterator cannot be told apart and is read;
+ * - the whole walk visits at most `MAX_VISITS` values, `MAX_DEPTH` deep, so neither nested sharing nor a
+ *   lazily generated endless structure can stall or overflow a render;
+ * - every read of a foreign value — even asking whether it is an element or an iterable — is guarded, so
+ *   a value that throws when read (a getter, a revoked or strict Proxy) places nothing and does not fail
+ *   the render. The walk's own logic is not guarded: a defect in it must surface.
+ */
+export declare function collectPlacedFieldPaths(nodes: ReactNode, pathPrefix?: string): string[];
+/**
+ * Reports field paths as placed by the enclosing template, if there is a registry. A LAYOUT effect, so
+ * every report lands before the host's own layout effect reads the set.
+ */
+export declare function useTemplatePlacedFields(paths: readonly string[]): void;
+/**
+ * Reports every slot `children` places (`collectPlacedFieldPaths`) — only when a host is listening. The
+ * walk runs for a custom operation's template form and nowhere else: every other section and layout in
+ * the application skips it, and pays nothing.
+ */
+export declare function useTemplatePlacedFieldsOf(children: ReactNode, pathPrefix: string): void;
+//# sourceMappingURL=TemplatePlacedFieldsContext.d.ts.map

package/dist/esm/components/form/automated/TemplatePlacedFieldsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplatePlacedFieldsContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/TemplatePlacedFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2F,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhI;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;IAC7C,YAAY,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,2BAA2B,uDAA2D,CAAC;AAEpG,2DAA2D;AAC3D,wBAAgB,+BAA+B,IAAI,4BAA4B,CAiB9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE/D;AASD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,MAAM,EAAE,CAiFnF;AAqCD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAOvF"}

package/dist/esm/components/form/automated/TemplatePlacedFieldsContext.js

@@ -0,0 +1,203 @@
+import { Fragment, createContext, isValidElement, useContext, useLayoutEffect, useMemo, useState } from 'react';
+import { SectionContentRole, sectionContentRoleOf } from '../../resources/skeleton/SectionFieldsContext.js';
+export const TemplatePlacedFieldsContext = createContext(null);
+/** An identity-stable registry for one template render. */
+export function useTemplatePlacedFieldsRegistry() {
+    const [registry] = useState(() => {
+        // Counted, so a field placed by two slots stays placed when one of them leaves.
+        const placements = new Map();
+        return {
+            place: (topLevelField) => {
+                placements.set(topLevelField, (placements.get(topLevelField) ?? 0) + 1);
+                return () => {
+                    const remaining = (placements.get(topLevelField) ?? 1) - 1;
+                    if (remaining > 0)
+                        placements.set(topLevelField, remaining);
+                    else
+                        placements.delete(topLevelField);
+                };
+            },
+            placedFields: () => new Set(placements.keys()),
+        };
+    });
+    return registry;
+}
+/**
+ * The top-level field a slot path writes to: `notifications.email` → `notifications`, and an array item
+ * `steps[0].afterMinutes` → `steps`. The same root `FormField` computes.
+ */
+export function topLevelFieldOf(path) {
+    return path.match(/^[^.[\]]+/)?.[0] ?? path;
+}
+const PLACES_NAMED_FIELD = Symbol.for('wildo.placesNamedField');
+/**
+ * Declares a component that edits the field named by its `name` prop without being a `FormField` slot —
+ * the skeleton `ArrayField`, whose item slots do not exist while the array is empty.
+ */
+export function declarePlacesNamedField(component) {
+    Object.defineProperty(component, PLACES_NAMED_FIELD, { value: true, enumerable: false });
+}
+/** How many entries of one iterable the walk reads, so a runaway iterable cannot stall a render. */
+const MAX_ITERABLE_ENTRIES = 10_000;
+/** How many values one walk visits in all, so nested sharing cannot grow it exponentially. */
+const MAX_VISITS = 50_000;
+/** How deep one walk descends, so a lazily generated endless structure cannot overflow the stack. */
+const MAX_DEPTH = 200;
+/**
+ * Every field path a subtree places, read from its ELEMENTS, whatever else it holds. This is not the hide
+ * decision (`listPlacedFieldSlots`, which gives up at the first piece of other content): a slot beside a
+ * paragraph, inside a nested section, a wizard step or an unchosen `DiscriminatorSwitch` variant is still
+ * placed. Any prop holding React nodes is followed, not only `children`, so a variant map or a fallback is
+ * seen. What it cannot see is described once, on `TemplatePlacedFieldsRegistry`: a `useController`
+ * control, and a `FormField` rendered inside a custom component or a render prop until it mounts.
+ *
+ * It walks arbitrary prop DATA, so it is defensive about it:
+ * - only React elements are followed; a Date, a function, a class instance places nothing;
+ * - `Children.toArray` never sees a prop's data (it throws on a plain object);
+ * - a cycle stops at the first value that is already an ANCESTOR on the current path. A value reached
+ *   twice by different paths is walked each time, because it may sit under a different `ObjectScope`
+ *   (one address fragment under `billing` and under `shipping` places two fields);
+ * - an iterator that is its own iterable (a generator, `set.values()`) would be consumed before its owner
+ *   renders it, so it is never read; an iterable that hands out a fresh iterator (an array, a Set, a Map)
+ *   is read, at most `MAX_ITERABLE_ENTRIES` entries, and an iterator cut short is closed as `for…of`
+ *   would close it. An iterable handing out a SHARED one-shot iterator cannot be told apart and is read;
+ * - the whole walk visits at most `MAX_VISITS` values, `MAX_DEPTH` deep, so neither nested sharing nor a
+ *   lazily generated endless structure can stall or overflow a render;
+ * - every read of a foreign value — even asking whether it is an element or an iterable — is guarded, so
+ *   a value that throws when read (a getter, a revoked or strict Proxy) places nothing and does not fail
+ *   the render. The walk's own logic is not guarded: a defect in it must surface.
+ */
+export function collectPlacedFieldPaths(nodes, pathPrefix = '') {
+    const paths = [];
+    const scoped = (name, prefix) => typeof name === 'string' && name !== '' ? (prefix ? `${prefix}.${name}` : name) : prefix;
+    const ancestors = new Set();
+    let visits = 0;
+    /**
+     * What a foreign value is, and — for a collection or a readable plain object — its entries. Every read
+     * of the value happens here, inside the guard; a value that throws is `null` (it places nothing).
+     */
+    const inspect = (value, readsPlainObject) => {
+        try {
+            if (isValidElement(value)) {
+                // The element's own parts are foreign too: its type may be `undefined` (a missing import inside a
+                // variant React never renders), and its props are read through `readProp` below.
+                const type = value.type;
+                const props = (value.props ?? {});
+                return { element: { type, props, keys: Object.keys(props) } };
+            }
+            const iterate = value[Symbol.iterator];
+            if (typeof iterate === 'function') {
+                const iterator = iterate.call(value);
+                if (iterator === value)
+                    return null; // its own iterable: reading it would consume it
+                const entries = [];
+                let step = iterator.next();
+                while (!step.done && entries.length < MAX_ITERABLE_ENTRIES) {
+                    entries.push(step.value);
+                    step = iterator.next();
+                }
+                if (!step.done)
+                    iterator.return?.();
+                return { entries, isCollection: true };
+            }
+            if (readsPlainObject && Object.getPrototypeOf(value) === Object.prototype) {
+                return { entries: Object.values(value), isCollection: false };
+            }
+        }
+        catch {
+            // Data that throws when read places nothing.
+        }
+        return null;
+    };
+    const visit = (value, prefix, objectDepth, depth) => {
+        if (value === null || typeof value !== 'object' || ancestors.has(value))
+            return;
+        if (depth > MAX_DEPTH || ++visits > MAX_VISITS)
+            return;
+        const inspected = inspect(value, objectDepth > 0);
+        if (!inspected)
+            return;
+        ancestors.add(value);
+        if ('element' in inspected) {
+            visitElement(inspected.element, prefix, depth);
+        }
+        else {
+            const entryObjectDepth = inspected.isCollection ? objectDepth : objectDepth - 1;
+            for (const entry of inspected.entries)
+                visit(entry, prefix, entryObjectDepth, depth + 1);
+        }
+        ancestors.delete(value);
+    };
+    const visitElement = ({ type, props, keys }, prefix, depth) => {
+        if (type === Fragment) {
+            visit(readProp(props, 'children'), prefix, 0, depth + 1);
+            return;
+        }
+        const role = declaredRoleOf(type);
+        if (role === SectionContentRole.FIELD_SLOT || placesNamedField(type)) {
+            paths.push(scoped(readProp(props, 'name'), prefix));
+            return;
+        }
+        const childPrefix = role === SectionContentRole.FIELD_SLOT_CONTAINER ? scoped(readProp(props, 'name'), prefix) : prefix;
+        for (const key of keys) {
+            // `children` is nodes; any other prop may hold a node, a collection of nodes or a map of them (a
+            // variant map), and is followed one plain-object level deep.
+            visit(readProp(props, key), childPrefix, key === 'children' ? 0 : 1, depth + 1);
+        }
+    };
+    visit(nodes, pathPrefix, 0, 0);
+    return paths.filter((path) => path !== '');
+}
+/** The section role an element type declared; any type, including `undefined` or an exotic object. */
+function declaredRoleOf(type) {
+    try {
+        return sectionContentRoleOf(type);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Whether an element type declared `declarePlacesNamedField`; any type, including `undefined`. */
+function placesNamedField(type) {
+    try {
+        return type !== null && (typeof type === 'function' || typeof type === 'object')
+            && type[PLACES_NAMED_FIELD] === true;
+    }
+    catch {
+        return false;
+    }
+}
+/** One prop's value, or `undefined` when reading it throws. */
+function readProp(props, key) {
+    try {
+        return props[key];
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Reports field paths as placed by the enclosing template, if there is a registry. A LAYOUT effect, so
+ * every report lands before the host's own layout effect reads the set.
+ */
+export function useTemplatePlacedFields(paths) {
+    const registry = useContext(TemplatePlacedFieldsContext);
+    const key = paths.map(topLevelFieldOf).join('\u0000');
+    useLayoutEffect(() => {
+        if (!registry || key === '')
+            return undefined;
+        const releases = key.split('\u0000').map((field) => registry.place(field));
+        return () => releases.forEach((release) => release());
+    }, [registry, key]);
+}
+/**
+ * Reports every slot `children` places (`collectPlacedFieldPaths`) — only when a host is listening. The
+ * walk runs for a custom operation's template form and nowhere else: every other section and layout in
+ * the application skips it, and pays nothing.
+ */
+export function useTemplatePlacedFieldsOf(children, pathPrefix) {
+    const registry = useContext(TemplatePlacedFieldsContext);
+    const paths = useMemo(() => (registry ? collectPlacedFieldPaths(children, pathPrefix) : []), [registry, children, pathPrefix]);
+    useTemplatePlacedFields(paths);
+}
+//# sourceMappingURL=TemplatePlacedFieldsContext.js.map

package/dist/esm/components/form/automated/TemplatePlacedFieldsContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplatePlacedFieldsContext.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/TemplatePlacedFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAChI,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AA+BzG,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAAsC,IAAI,CAAC,CAAC;AAEpG,2DAA2D;AAC3D,MAAM,UAAU,+BAA+B;IAC7C,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAiC,EAAE;QAC7D,gFAAgF;QAChF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,CAAC,aAAqB,EAAE,EAAE;gBAC/B,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxE,OAAO,GAAG,EAAE;oBACV,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;oBAC3D,IAAI,SAAS,GAAG,CAAC;wBAAE,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;;wBACvD,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBACxC,CAAC,CAAC;YACJ,CAAC;YACD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,oGAAoG;AACpG,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,8FAA8F;AAC9F,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,qGAAqG;AACrG,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAgB,EAAE,UAAU,GAAG,EAAE;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,CAAC,IAAa,EAAE,MAAc,EAAU,EAAE,CACvD,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3F,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf;;;OAGG;IACH,MAAM,OAAO,GAAG,CACd,KAAa,EACb,gBAAyB,EAC6D,EAAE;QACxF,IAAI,CAAC;YACH,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,kGAAkG;gBAClG,iFAAiF;gBACjF,MAAM,IAAI,GAAY,KAAK,CAAC,IAAI,CAAC;gBACjC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;gBAC7D,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAChE,CAAC;YACD,MAAM,OAAO,GAAI,KAAyD,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5F,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAK,QAAoB,KAAK,KAAK;oBAAE,OAAO,IAAI,CAAC,CAAC,gDAAgD;gBAClG,MAAM,OAAO,GAAc,EAAE,CAAC;gBAC9B,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;oBAC3D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACzB,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACzB,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,IAAI;oBAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACzC,CAAC;YACD,IAAI,gBAAgB,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;YAChE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,MAAc,EAAE,WAAmB,EAAE,KAAa,EAAQ,EAAE;QACzF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QAChF,IAAI,KAAK,GAAG,SAAS,IAAI,EAAE,MAAM,GAAG,UAAU;YAAE,OAAO;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YAC3B,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,MAAM,gBAAgB,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YAChF,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO;gBAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3F,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAoB,EAAE,MAAc,EAAE,KAAa,EAAQ,EAAE;QACpG,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,kBAAkB,CAAC,UAAU,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,KAAK,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACxH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,iGAAiG;YACjG,6DAA6D;YAC7D,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AAC7C,CAAC;AASD,sGAAsG;AACtG,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,UAAU,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC;eAC1E,IAA2C,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,SAAS,QAAQ,CAAC,KAA8B,EAAE,GAAW;IAC3D,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,MAAM,QAAQ,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,QAAQ,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3E,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAmB,EAAE,UAAkB;IAC/E,MAAM,QAAQ,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EACrE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CACjC,CAAC;IACF,uBAAuB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC","sourcesContent":["import { Fragment, createContext, isValidElement, useContext, useLayoutEffect, useMemo, useState, type ReactNode } from 'react';\nimport { SectionContentRole, sectionContentRoleOf } from '../../resources/skeleton/SectionFieldsContext';\n\n/**\n * Which of a form's top-level fields an authored template PLACES — for the one host that must know:\n * `ResourceAutomatedForm` rendering a resource's `layout.edit` template for a custom operation.\n *\n * A template is written against the resource's own fields, and a custom operation keeps it when every\n * field of its request is a resource field (`resolveAuthoredEditTemplateForOperation`). That rule says a\n * field COULD have a slot, not that the template has one. A request field no slot places would never be\n * rendered, so the host appends it after the template, generated like the rest of a generated form.\n *\n * Two sources report, because neither sees everything:\n * - each mounted `FormField` reports its own top-level field — the only way to see a slot inside a\n *   custom component (a field component that wraps `FormField` with its own props);\n * - each `Section` and each grouped section reports every slot it holds, read from its elements\n *   (`collectPlacedFieldPaths`) — the only way to see a slot whose panel is not mounted (an inactive\n *   tab, a closed collapsible, an unchosen discriminator variant, a later wizard step).\n *\n * Still invisible: a control a custom component renders with its own `useController` (never seen — only\n * `FormField` reports itself), and a `FormField` a custom component renders internally, or one reached\n * through a render-prop function, until it mounts. The static reports read the JSX under a `FormLayout`\n * or a `Section` only.\n *\n * The host reads the set ONCE, after the template's first layout pass, and never retracts an appended\n * field: removing a mounted control would unregister its value.\n */\nexport interface TemplatePlacedFieldsRegistry {\n  place: (topLevelField: string) => () => void;\n  placedFields: () => ReadonlySet<string>;\n}\n\nexport const TemplatePlacedFieldsContext = createContext<TemplatePlacedFieldsRegistry | null>(null);\n\n/** An identity-stable registry for one template render. */\nexport function useTemplatePlacedFieldsRegistry(): TemplatePlacedFieldsRegistry {\n  const [registry] = useState((): TemplatePlacedFieldsRegistry => {\n    // Counted, so a field placed by two slots stays placed when one of them leaves.\n    const placements = new Map<string, number>();\n    return {\n      place: (topLevelField: string) => {\n        placements.set(topLevelField, (placements.get(topLevelField) ?? 0) + 1);\n        return () => {\n          const remaining = (placements.get(topLevelField) ?? 1) - 1;\n          if (remaining > 0) placements.set(topLevelField, remaining);\n          else placements.delete(topLevelField);\n        };\n      },\n      placedFields: () => new Set(placements.keys()),\n    };\n  });\n  return registry;\n}\n\n/**\n * The top-level field a slot path writes to: `notifications.email` → `notifications`, and an array item\n * `steps[0].afterMinutes` → `steps`. The same root `FormField` computes.\n */\nexport function topLevelFieldOf(path: string): string {\n  return path.match(/^[^.[\\]]+/)?.[0] ?? path;\n}\n\nconst PLACES_NAMED_FIELD = Symbol.for('wildo.placesNamedField');\n\n/**\n * Declares a component that edits the field named by its `name` prop without being a `FormField` slot —\n * the skeleton `ArrayField`, whose item slots do not exist while the array is empty.\n */\nexport function declarePlacesNamedField(component: object): void {\n  Object.defineProperty(component, PLACES_NAMED_FIELD, { value: true, enumerable: false });\n}\n\n/** How many entries of one iterable the walk reads, so a runaway iterable cannot stall a render. */\nconst MAX_ITERABLE_ENTRIES = 10_000;\n/** How many values one walk visits in all, so nested sharing cannot grow it exponentially. */\nconst MAX_VISITS = 50_000;\n/** How deep one walk descends, so a lazily generated endless structure cannot overflow the stack. */\nconst MAX_DEPTH = 200;\n\n/**\n * Every field path a subtree places, read from its ELEMENTS, whatever else it holds. This is not the hide\n * decision (`listPlacedFieldSlots`, which gives up at the first piece of other content): a slot beside a\n * paragraph, inside a nested section, a wizard step or an unchosen `DiscriminatorSwitch` variant is still\n * placed. Any prop holding React nodes is followed, not only `children`, so a variant map or a fallback is\n * seen. What it cannot see is described once, on `TemplatePlacedFieldsRegistry`: a `useController`\n * control, and a `FormField` rendered inside a custom component or a render prop until it mounts.\n *\n * It walks arbitrary prop DATA, so it is defensive about it:\n * - only React elements are followed; a Date, a function, a class instance places nothing;\n * - `Children.toArray` never sees a prop's data (it throws on a plain object);\n * - a cycle stops at the first value that is already an ANCESTOR on the current path. A value reached\n *   twice by different paths is walked each time, because it may sit under a different `ObjectScope`\n *   (one address fragment under `billing` and under `shipping` places two fields);\n * - an iterator that is its own iterable (a generator, `set.values()`) would be consumed before its owner\n *   renders it, so it is never read; an iterable that hands out a fresh iterator (an array, a Set, a Map)\n *   is read, at most `MAX_ITERABLE_ENTRIES` entries, and an iterator cut short is closed as `for…of`\n *   would close it. An iterable handing out a SHARED one-shot iterator cannot be told apart and is read;\n * - the whole walk visits at most `MAX_VISITS` values, `MAX_DEPTH` deep, so neither nested sharing nor a\n *   lazily generated endless structure can stall or overflow a render;\n * - every read of a foreign value — even asking whether it is an element or an iterable — is guarded, so\n *   a value that throws when read (a getter, a revoked or strict Proxy) places nothing and does not fail\n *   the render. The walk's own logic is not guarded: a defect in it must surface.\n */\nexport function collectPlacedFieldPaths(nodes: ReactNode, pathPrefix = ''): string[] {\n  const paths: string[] = [];\n  const scoped = (name: unknown, prefix: string): string =>\n    typeof name === 'string' && name !== '' ? (prefix ? `${prefix}.${name}` : name) : prefix;\n  const ancestors = new Set<object>();\n\n  let visits = 0;\n\n  /**\n   * What a foreign value is, and — for a collection or a readable plain object — its entries. Every read\n   * of the value happens here, inside the guard; a value that throws is `null` (it places nothing).\n   */\n  const inspect = (\n    value: object,\n    readsPlainObject: boolean,\n  ): { element: InspectedElement } | { entries: unknown[]; isCollection: boolean } | null => {\n    try {\n      if (isValidElement(value)) {\n        // The element's own parts are foreign too: its type may be `undefined` (a missing import inside a\n        // variant React never renders), and its props are read through `readProp` below.\n        const type: unknown = value.type;\n        const props = (value.props ?? {}) as Record<string, unknown>;\n        return { element: { type, props, keys: Object.keys(props) } };\n      }\n      const iterate = (value as { [Symbol.iterator]?: () => Iterator<unknown> })[Symbol.iterator];\n      if (typeof iterate === 'function') {\n        const iterator = iterate.call(value);\n        if ((iterator as unknown) === value) return null; // its own iterable: reading it would consume it\n        const entries: unknown[] = [];\n        let step = iterator.next();\n        while (!step.done && entries.length < MAX_ITERABLE_ENTRIES) {\n          entries.push(step.value);\n          step = iterator.next();\n        }\n        if (!step.done) iterator.return?.();\n        return { entries, isCollection: true };\n      }\n      if (readsPlainObject && Object.getPrototypeOf(value) === Object.prototype) {\n        return { entries: Object.values(value), isCollection: false };\n      }\n    } catch {\n      // Data that throws when read places nothing.\n    }\n    return null;\n  };\n\n  const visit = (value: unknown, prefix: string, objectDepth: number, depth: number): void => {\n    if (value === null || typeof value !== 'object' || ancestors.has(value)) return;\n    if (depth > MAX_DEPTH || ++visits > MAX_VISITS) return;\n    const inspected = inspect(value, objectDepth > 0);\n    if (!inspected) return;\n    ancestors.add(value);\n    if ('element' in inspected) {\n      visitElement(inspected.element, prefix, depth);\n    } else {\n      const entryObjectDepth = inspected.isCollection ? objectDepth : objectDepth - 1;\n      for (const entry of inspected.entries) visit(entry, prefix, entryObjectDepth, depth + 1);\n    }\n    ancestors.delete(value);\n  };\n\n  const visitElement = ({ type, props, keys }: InspectedElement, prefix: string, depth: number): void => {\n    if (type === Fragment) {\n      visit(readProp(props, 'children'), prefix, 0, depth + 1);\n      return;\n    }\n    const role = declaredRoleOf(type);\n    if (role === SectionContentRole.FIELD_SLOT || placesNamedField(type)) {\n      paths.push(scoped(readProp(props, 'name'), prefix));\n      return;\n    }\n    const childPrefix = role === SectionContentRole.FIELD_SLOT_CONTAINER ? scoped(readProp(props, 'name'), prefix) : prefix;\n    for (const key of keys) {\n      // `children` is nodes; any other prop may hold a node, a collection of nodes or a map of them (a\n      // variant map), and is followed one plain-object level deep.\n      visit(readProp(props, key), childPrefix, key === 'children' ? 0 : 1, depth + 1);\n    }\n  };\n\n  visit(nodes, pathPrefix, 0, 0);\n  return paths.filter((path) => path !== '');\n}\n\n/** A React element's parts, read once inside the walk's guard. */\ninterface InspectedElement {\n  type: unknown;\n  props: Record<string, unknown>;\n  keys: string[];\n}\n\n/** The section role an element type declared; any type, including `undefined` or an exotic object. */\nfunction declaredRoleOf(type: unknown): SectionContentRole | undefined {\n  try {\n    return sectionContentRoleOf(type);\n  } catch {\n    return undefined;\n  }\n}\n\n/** Whether an element type declared `declarePlacesNamedField`; any type, including `undefined`. */\nfunction placesNamedField(type: unknown): boolean {\n  try {\n    return type !== null && (typeof type === 'function' || typeof type === 'object')\n      && (type as { [PLACES_NAMED_FIELD]?: boolean })[PLACES_NAMED_FIELD] === true;\n  } catch {\n    return false;\n  }\n}\n\n/** One prop's value, or `undefined` when reading it throws. */\nfunction readProp(props: Record<string, unknown>, key: string): unknown {\n  try {\n    return props[key];\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Reports field paths as placed by the enclosing template, if there is a registry. A LAYOUT effect, so\n * every report lands before the host's own layout effect reads the set.\n */\nexport function useTemplatePlacedFields(paths: readonly string[]): void {\n  const registry = useContext(TemplatePlacedFieldsContext);\n  const key = paths.map(topLevelFieldOf).join('\\u0000');\n  useLayoutEffect(() => {\n    if (!registry || key === '') return undefined;\n    const releases = key.split('\\u0000').map((field) => registry.place(field));\n    return () => releases.forEach((release) => release());\n  }, [registry, key]);\n}\n\n/**\n * Reports every slot `children` places (`collectPlacedFieldPaths`) — only when a host is listening. The\n * walk runs for a custom operation's template form and nowhere else: every other section and layout in\n * the application skips it, and pays nothing.\n */\nexport function useTemplatePlacedFieldsOf(children: ReactNode, pathPrefix: string): void {\n  const registry = useContext(TemplatePlacedFieldsContext);\n  const paths = useMemo(\n    () => (registry ? collectPlacedFieldPaths(children, pathPrefix) : []),\n    [registry, children, pathPrefix],\n  );\n  useTemplatePlacedFields(paths);\n}\n"]}

package/dist/esm/components/form/automated/automated-form-submit.utils.d.ts

@@ -60,5 +60,17 @@ export declare function sanitizeAutomatedFormSubmissionData<TData extends Record
      */
     schema?: z.ZodTypeAny;
 }): TData;
+/**
+ * Whether a resource form offers its sections a Save of their own.
+ *
+ * A section save writes part of records that EXIST — one record, or a bulk selection — so a create form, whose
+ * record does not exist yet, offers none. Measured on Wonder Todos' reminder rule: the create
+ * dialog showed three section "Save" buttons above its own Create, and none of them could create anything. A
+ * caller that supplies its own section handler owns what a section save means, so it is honoured on any operation.
+ */
+export declare function formOffersSectionSave(params: {
+    createsRecord: boolean;
+    hasCallerSectionHandler: boolean;
+}): boolean;
 export {};
 //# sourceMappingURL=automated-form-submit.utils.d.ts.map

package/dist/esm/components/form/automated/automated-form-submit.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automated-form-submit.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,KAAK,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,OAAO,CAGT;AA8FD,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,IAAI,EAAE,KAAK,EACX,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,KAAK,CAAC,CAkBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAwDD;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvF,IAAI,EAAE,KAAK,EACX,OAAO,EAAE;IACP,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,4BAA4B,CAAC;IAClD,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CACvB,GACA,KAAK,CAwBP"}
+{"version":3,"file":"automated-form-submit.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,KAAK,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,OAAO,CAGT;AA8FD,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,IAAI,EAAE,KAAK,EACX,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,KAAK,CAAC,CAkBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAwDD;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvF,IAAI,EAAE,KAAK,EACX,OAAO,EAAE;IACP,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,4BAA4B,CAAC;IAClD,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CACvB,GACA,KAAK,CAwBP;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,uBAAuB,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEnH"}

package/dist/esm/components/form/automated/automated-form-submit.utils.js

@@ -237,4 +237,15 @@ export function sanitizeAutomatedFormSubmissionData(data, options) {
     }
     return sanitizedData;
 }
+/**
+ * Whether a resource form offers its sections a Save of their own.
+ *
+ * A section save writes part of records that EXIST — one record, or a bulk selection — so a create form, whose
+ * record does not exist yet, offers none. Measured on Wonder Todos' reminder rule: the create
+ * dialog showed three section "Save" buttons above its own Create, and none of them could create anything. A
+ * caller that supplies its own section handler owns what a section save means, so it is honoured on any operation.
+ */
+export function formOffersSectionSave(params) {
+    return !params.createsRecord || params.hasCallerSectionHandler;
+}
 //# sourceMappingURL=automated-form-submit.utils.js.map

package/dist/esm/components/form/automated/automated-form-submit.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"automated-form-submit.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { getObjectLikeFieldSchema } from '@wildo-ai/zod-decorators';\nimport { isUpdateLikeCoreOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\ntype SubmissionContextFieldValues = Record<string, unknown>;\n\n/**\n * Should a cleared (`null`) key be DROPPED from this submission?\n *\n * Yes on a create-like operation, where \"the user emptied this\" and \"the user never filled it\" are\n * the same state and absence already says it. No on an update-like one, where dropping the key\n * would discard the user's clear — the stored value would simply survive.\n *\n * A named decision rather than an inline comparison, because the inline version was WRONG: it\n * compared a raw operation IDENTIFIER against the literal `'update'`, and that identifier is an\n * arbitrary string for any custom operation. `UPDATE_MANY` and every custom update-like operation\n * that does not declare `resourceOperationLike` were therefore classified as creates, and their\n * clears were silently stripped before leaving the form.\n *\n * @param coreOperation - the RESOLVED core operation, supplied by a resource-aware wrapper. When\n *   present it is the only input consulted.\n * @param formOperationType - the raw identifier fallback, for a bare form mounted with no resource\n *   semantics. An unresolved operation is treated as create-like, the conservative direction: such a\n *   surface has no stored row whose value a dropped key could discard.\n */\nexport function shouldOmitClearedFieldsForOperation(\n  coreOperation: CoreResourceOperation | undefined,\n  formOperationType: string | undefined,\n): boolean {\n  if (coreOperation !== undefined) return !isUpdateLikeCoreOperation(coreOperation);\n  return formOperationType !== 'update';\n}\n\nfunction tokenizePath(path: string): string[] {\n  return path.match(/[^.[\\]]+/g) ?? [];\n}\n\nfunction omitPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0 || value === null || value === undefined || typeof value !== 'object') {\n    return value;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return value;\n    }\n\n    const copy = [...value];\n    if (rest.length === 0) {\n      copy.splice(index, 1);\n      return copy;\n    }\n\n    copy[index] = omitPath(copy[index], rest);\n    return copy;\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return value;\n  }\n\n  const copy = { ...recordValue };\n  if (rest.length === 0) {\n    delete copy[head];\n    return copy;\n  }\n\n  copy[head] = omitPath(copy[head], rest);\n  return copy;\n}\n\nfunction getPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0) {\n    return value;\n  }\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return undefined;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return undefined;\n    }\n    return getPath(value[index], rest);\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return undefined;\n  }\n\n  return getPath(recordValue[head], rest);\n}\n\nfunction setPath(value: unknown, pathTokens: string[], nextValue: unknown): unknown {\n  if (pathTokens.length === 0) {\n    return nextValue;\n  }\n\n  const [head, ...rest] = pathTokens;\n  const isArrayIndex = Number.isInteger(Number(head));\n\n  if (isArrayIndex) {\n    const index = Number(head);\n    const copy = Array.isArray(value) ? [...value] : [];\n    copy[index] = setPath(copy[index], rest, nextValue);\n    return copy;\n  }\n\n  const recordValue = value !== null && value !== undefined && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n  return {\n    ...recordValue,\n    [head]: setPath(recordValue[head], rest, nextValue),\n  };\n}\n\nexport function pickSubmissionDataPaths<TData extends Record<string, unknown>>(\n  data: TData,\n  fieldNames: string[],\n): Partial<TData> {\n  let subset: Record<string, unknown> = {};\n\n  for (const fieldName of fieldNames) {\n    const pathTokens = tokenizePath(fieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n\n    const fieldValue = getPath(data, pathTokens);\n    if (fieldValue === undefined) {\n      continue;\n    }\n\n    subset = setPath(subset, pathTokens, fieldValue) as Record<string, unknown>;\n  }\n\n  return subset as Partial<TData>;\n}\n\n/**\n * Give a PARTIAL write of a composite its stored siblings, so the UPDATE does not erase them.\n *\n * A section save sends only the paths its section registered, via\n * {@link pickSubmissionDataPaths}. That nests correctly, and it is still wrong when a composite's\n * children are split across sections: `{ address: { city } }` reaches an UPDATE that REPLACES a\n * nested object whole (a `jsonb` column on PostgreSQL, a subdocument `$set` on MongoDB), so the\n * `address.zip` owned by another section is erased (#1410).\n *\n * So each registered NESTED path is written into a copy of that parent's `stored` value — the last\n * thing the server said, the same source the RMM's `buildWireRequestData` and autosave use (#1395).\n * Not the form's values: those can hold another section's unsaved, possibly invalid edits, and a\n * section save must not commit them.\n *\n * Two cases are deliberately left as the body already has them:\n * - a root the section registers WHOLE (`address` itself) — its form value is complete, and merging\n *   stored keys into it would resurrect a key the person removed;\n * - a path the body no longer carries (sanitization dropped it) — the stored value stands.\n */\nexport function carryStoredSiblingsIntoPartialWrites(\n  body: Record<string, unknown>,\n  fieldNames: string[],\n  stored: Record<string, unknown> | null | undefined,\n): Record<string, unknown> {\n  if (!stored) return body;\n\n  const rootsRegisteredWhole = new Set(\n    fieldNames.map(tokenizePath).filter((tokens) => tokens.length === 1).map((tokens) => tokens[0]),\n  );\n  const rebasedRoots = new Set<string>();\n  let result: Record<string, unknown> = body;\n\n  for (const fieldName of fieldNames) {\n    const tokens = tokenizePath(fieldName);\n    if (tokens.length < 2) continue;\n    const root = tokens[0];\n    if (rootsRegisteredWhole.has(root)) continue;\n\n    const value = getPath(body, tokens);\n    if (value === undefined) continue;\n\n    if (!rebasedRoots.has(root)) {\n      rebasedRoots.add(root);\n      const storedParent = stored[root];\n      if (storedParent !== null && typeof storedParent === 'object') {\n        result = { ...result, [root]: storedParent };\n      }\n    }\n    result = setPath(result, tokens, value) as Record<string, unknown>;\n  }\n\n  return result;\n}\n\n/**\n * Drop top-level keys whose value is the framework's CLEARED sentinel (`null`).\n *\n * Only meaningful on a CREATE-like submission, and only there. On an UPDATE the two states are\n * genuinely different — an absent key leaves the stored value alone, a `null` clears it — so\n * stripping would silently discard the user's clear. On a CREATE there is nothing to leave alone:\n * \"the user emptied this field\" and \"the user never filled it\" are the same state, absence already\n * says it, and the CREATE request DTO deliberately does not accept null.\n *\n * The strip happens HERE rather than in the field change handler because form state must keep\n * `null`: react-hook-form reserves `undefined` to mean \"fall back to defaultValue\" and rejects it\n * from `onChange`, so a cleared field cannot be represented as `undefined` while it is being\n * edited. It only becomes absence at the boundary where the payload leaves the form.\n *\n * Nested objects are left alone: clearing a member of a nested object is expressed by replacing the\n * object, and this pass must not reach inside one and change its shape.\n */\nfunction omitClearedFieldKeys(\n  data: Record<string, unknown>,\n  schema: z.ZodTypeAny | undefined,\n): Record<string, unknown> {\n  const withoutClearedKeys: Record<string, unknown> = {};\n\n  for (const [fieldName, value] of Object.entries(data)) {\n    if (value === null && !fieldAcceptsNullAsAValue(schema, fieldName)) continue;\n    withoutClearedKeys[fieldName] = value;\n  }\n\n  return withoutClearedKeys;\n}\n\n/**\n * Did the AUTHOR declare `null` as a meaningful value for this field, or is it merely the\n * framework's cleared sentinel?\n *\n * The distinction decides whether the CREATE strip may drop the key. A field the create DTO refuses\n * a null for can only be carrying OUR sentinel, so dropping it is lossless. A field that ACCEPTS\n * null — an authored `.nullish()` — is one where the author modelled null as a value distinct from\n * absence, and dropping it changes what gets created.\n *\n * The case that makes this more than pedantry is `z.string().nullish().default('x')`: a default\n * fires on `undefined`, so stripping the user's explicit null makes the server apply the DEFAULT —\n * the opposite of what the user asked for. Found by independent review.\n *\n * An unresolvable field is treated as NOT null-accepting, i.e. stripped. That is the conservative\n * direction here: the create DTO would reject a null it does not declare, so keeping it would turn\n * a clear into a 400.\n */\nfunction fieldAcceptsNullAsAValue(schema: z.ZodTypeAny | undefined, fieldName: string): boolean {\n  if (!schema) return false;\n  const fieldSchema = getObjectLikeFieldSchema(schema, fieldName);\n  return fieldSchema ? fieldSchema.safeParse(null).success : false;\n}\n\n/**\n * Removes framework-hidden fields from the outgoing payload, then reapplies\n * context-owned values that must stay authoritative at submit time.\n *\n * On a CREATE-like operation it also drops cleared (`null`) keys — see `omitClearedFieldKeys` for\n * why that belongs at this boundary and why it must NOT happen on an UPDATE.\n */\nexport function sanitizeAutomatedFormSubmissionData<TData extends Record<string, unknown>>(\n  data: TData,\n  options: {\n    hiddenFieldNames?: string[];\n    contextFieldValues?: SubmissionContextFieldValues;\n    /** True when the submission creates a row, so absence and \"cleared\" are the same state. */\n    omitClearedFields?: boolean;\n    /**\n     * The schema this form validates. Used ONLY to tell an authored `.nullish()` null (a value)\n     * from the framework's cleared sentinel, so the CREATE strip does not discard the former.\n     */\n    schema?: z.ZodTypeAny;\n  },\n): TData {\n  let sanitizedData = options.omitClearedFields\n    ? omitClearedFieldKeys(data as Record<string, unknown>, options.schema)\n    : data as Record<string, unknown>;\n\n  for (const hiddenFieldName of options.hiddenFieldNames ?? []) {\n    const pathTokens = tokenizePath(hiddenFieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n    sanitizedData = omitPath(sanitizedData, pathTokens) as Record<string, unknown>;\n  }\n\n  if (options.contextFieldValues && Object.keys(options.contextFieldValues).length > 0) {\n    for (const [fieldName, fieldValue] of Object.entries(options.contextFieldValues)) {\n      const pathTokens = tokenizePath(fieldName);\n      if (pathTokens.length === 0) {\n        continue;\n      }\n      sanitizedData = setPath(sanitizedData, pathTokens, fieldValue) as Record<string, unknown>;\n    }\n  }\n\n  return sanitizedData as TData;\n}\n"]}
+{"version":3,"file":"automated-form-submit.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { getObjectLikeFieldSchema } from '@wildo-ai/zod-decorators';\nimport { isUpdateLikeCoreOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\ntype SubmissionContextFieldValues = Record<string, unknown>;\n\n/**\n * Should a cleared (`null`) key be DROPPED from this submission?\n *\n * Yes on a create-like operation, where \"the user emptied this\" and \"the user never filled it\" are\n * the same state and absence already says it. No on an update-like one, where dropping the key\n * would discard the user's clear — the stored value would simply survive.\n *\n * A named decision rather than an inline comparison, because the inline version was WRONG: it\n * compared a raw operation IDENTIFIER against the literal `'update'`, and that identifier is an\n * arbitrary string for any custom operation. `UPDATE_MANY` and every custom update-like operation\n * that does not declare `resourceOperationLike` were therefore classified as creates, and their\n * clears were silently stripped before leaving the form.\n *\n * @param coreOperation - the RESOLVED core operation, supplied by a resource-aware wrapper. When\n *   present it is the only input consulted.\n * @param formOperationType - the raw identifier fallback, for a bare form mounted with no resource\n *   semantics. An unresolved operation is treated as create-like, the conservative direction: such a\n *   surface has no stored row whose value a dropped key could discard.\n */\nexport function shouldOmitClearedFieldsForOperation(\n  coreOperation: CoreResourceOperation | undefined,\n  formOperationType: string | undefined,\n): boolean {\n  if (coreOperation !== undefined) return !isUpdateLikeCoreOperation(coreOperation);\n  return formOperationType !== 'update';\n}\n\nfunction tokenizePath(path: string): string[] {\n  return path.match(/[^.[\\]]+/g) ?? [];\n}\n\nfunction omitPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0 || value === null || value === undefined || typeof value !== 'object') {\n    return value;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return value;\n    }\n\n    const copy = [...value];\n    if (rest.length === 0) {\n      copy.splice(index, 1);\n      return copy;\n    }\n\n    copy[index] = omitPath(copy[index], rest);\n    return copy;\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return value;\n  }\n\n  const copy = { ...recordValue };\n  if (rest.length === 0) {\n    delete copy[head];\n    return copy;\n  }\n\n  copy[head] = omitPath(copy[head], rest);\n  return copy;\n}\n\nfunction getPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0) {\n    return value;\n  }\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return undefined;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return undefined;\n    }\n    return getPath(value[index], rest);\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return undefined;\n  }\n\n  return getPath(recordValue[head], rest);\n}\n\nfunction setPath(value: unknown, pathTokens: string[], nextValue: unknown): unknown {\n  if (pathTokens.length === 0) {\n    return nextValue;\n  }\n\n  const [head, ...rest] = pathTokens;\n  const isArrayIndex = Number.isInteger(Number(head));\n\n  if (isArrayIndex) {\n    const index = Number(head);\n    const copy = Array.isArray(value) ? [...value] : [];\n    copy[index] = setPath(copy[index], rest, nextValue);\n    return copy;\n  }\n\n  const recordValue = value !== null && value !== undefined && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n  return {\n    ...recordValue,\n    [head]: setPath(recordValue[head], rest, nextValue),\n  };\n}\n\nexport function pickSubmissionDataPaths<TData extends Record<string, unknown>>(\n  data: TData,\n  fieldNames: string[],\n): Partial<TData> {\n  let subset: Record<string, unknown> = {};\n\n  for (const fieldName of fieldNames) {\n    const pathTokens = tokenizePath(fieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n\n    const fieldValue = getPath(data, pathTokens);\n    if (fieldValue === undefined) {\n      continue;\n    }\n\n    subset = setPath(subset, pathTokens, fieldValue) as Record<string, unknown>;\n  }\n\n  return subset as Partial<TData>;\n}\n\n/**\n * Give a PARTIAL write of a composite its stored siblings, so the UPDATE does not erase them.\n *\n * A section save sends only the paths its section registered, via\n * {@link pickSubmissionDataPaths}. That nests correctly, and it is still wrong when a composite's\n * children are split across sections: `{ address: { city } }` reaches an UPDATE that REPLACES a\n * nested object whole (a `jsonb` column on PostgreSQL, a subdocument `$set` on MongoDB), so the\n * `address.zip` owned by another section is erased (#1410).\n *\n * So each registered NESTED path is written into a copy of that parent's `stored` value — the last\n * thing the server said, the same source the RMM's `buildWireRequestData` and autosave use (#1395).\n * Not the form's values: those can hold another section's unsaved, possibly invalid edits, and a\n * section save must not commit them.\n *\n * Two cases are deliberately left as the body already has them:\n * - a root the section registers WHOLE (`address` itself) — its form value is complete, and merging\n *   stored keys into it would resurrect a key the person removed;\n * - a path the body no longer carries (sanitization dropped it) — the stored value stands.\n */\nexport function carryStoredSiblingsIntoPartialWrites(\n  body: Record<string, unknown>,\n  fieldNames: string[],\n  stored: Record<string, unknown> | null | undefined,\n): Record<string, unknown> {\n  if (!stored) return body;\n\n  const rootsRegisteredWhole = new Set(\n    fieldNames.map(tokenizePath).filter((tokens) => tokens.length === 1).map((tokens) => tokens[0]),\n  );\n  const rebasedRoots = new Set<string>();\n  let result: Record<string, unknown> = body;\n\n  for (const fieldName of fieldNames) {\n    const tokens = tokenizePath(fieldName);\n    if (tokens.length < 2) continue;\n    const root = tokens[0];\n    if (rootsRegisteredWhole.has(root)) continue;\n\n    const value = getPath(body, tokens);\n    if (value === undefined) continue;\n\n    if (!rebasedRoots.has(root)) {\n      rebasedRoots.add(root);\n      const storedParent = stored[root];\n      if (storedParent !== null && typeof storedParent === 'object') {\n        result = { ...result, [root]: storedParent };\n      }\n    }\n    result = setPath(result, tokens, value) as Record<string, unknown>;\n  }\n\n  return result;\n}\n\n/**\n * Drop top-level keys whose value is the framework's CLEARED sentinel (`null`).\n *\n * Only meaningful on a CREATE-like submission, and only there. On an UPDATE the two states are\n * genuinely different — an absent key leaves the stored value alone, a `null` clears it — so\n * stripping would silently discard the user's clear. On a CREATE there is nothing to leave alone:\n * \"the user emptied this field\" and \"the user never filled it\" are the same state, absence already\n * says it, and the CREATE request DTO deliberately does not accept null.\n *\n * The strip happens HERE rather than in the field change handler because form state must keep\n * `null`: react-hook-form reserves `undefined` to mean \"fall back to defaultValue\" and rejects it\n * from `onChange`, so a cleared field cannot be represented as `undefined` while it is being\n * edited. It only becomes absence at the boundary where the payload leaves the form.\n *\n * Nested objects are left alone: clearing a member of a nested object is expressed by replacing the\n * object, and this pass must not reach inside one and change its shape.\n */\nfunction omitClearedFieldKeys(\n  data: Record<string, unknown>,\n  schema: z.ZodTypeAny | undefined,\n): Record<string, unknown> {\n  const withoutClearedKeys: Record<string, unknown> = {};\n\n  for (const [fieldName, value] of Object.entries(data)) {\n    if (value === null && !fieldAcceptsNullAsAValue(schema, fieldName)) continue;\n    withoutClearedKeys[fieldName] = value;\n  }\n\n  return withoutClearedKeys;\n}\n\n/**\n * Did the AUTHOR declare `null` as a meaningful value for this field, or is it merely the\n * framework's cleared sentinel?\n *\n * The distinction decides whether the CREATE strip may drop the key. A field the create DTO refuses\n * a null for can only be carrying OUR sentinel, so dropping it is lossless. A field that ACCEPTS\n * null — an authored `.nullish()` — is one where the author modelled null as a value distinct from\n * absence, and dropping it changes what gets created.\n *\n * The case that makes this more than pedantry is `z.string().nullish().default('x')`: a default\n * fires on `undefined`, so stripping the user's explicit null makes the server apply the DEFAULT —\n * the opposite of what the user asked for. Found by independent review.\n *\n * An unresolvable field is treated as NOT null-accepting, i.e. stripped. That is the conservative\n * direction here: the create DTO would reject a null it does not declare, so keeping it would turn\n * a clear into a 400.\n */\nfunction fieldAcceptsNullAsAValue(schema: z.ZodTypeAny | undefined, fieldName: string): boolean {\n  if (!schema) return false;\n  const fieldSchema = getObjectLikeFieldSchema(schema, fieldName);\n  return fieldSchema ? fieldSchema.safeParse(null).success : false;\n}\n\n/**\n * Removes framework-hidden fields from the outgoing payload, then reapplies\n * context-owned values that must stay authoritative at submit time.\n *\n * On a CREATE-like operation it also drops cleared (`null`) keys — see `omitClearedFieldKeys` for\n * why that belongs at this boundary and why it must NOT happen on an UPDATE.\n */\nexport function sanitizeAutomatedFormSubmissionData<TData extends Record<string, unknown>>(\n  data: TData,\n  options: {\n    hiddenFieldNames?: string[];\n    contextFieldValues?: SubmissionContextFieldValues;\n    /** True when the submission creates a row, so absence and \"cleared\" are the same state. */\n    omitClearedFields?: boolean;\n    /**\n     * The schema this form validates. Used ONLY to tell an authored `.nullish()` null (a value)\n     * from the framework's cleared sentinel, so the CREATE strip does not discard the former.\n     */\n    schema?: z.ZodTypeAny;\n  },\n): TData {\n  let sanitizedData = options.omitClearedFields\n    ? omitClearedFieldKeys(data as Record<string, unknown>, options.schema)\n    : data as Record<string, unknown>;\n\n  for (const hiddenFieldName of options.hiddenFieldNames ?? []) {\n    const pathTokens = tokenizePath(hiddenFieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n    sanitizedData = omitPath(sanitizedData, pathTokens) as Record<string, unknown>;\n  }\n\n  if (options.contextFieldValues && Object.keys(options.contextFieldValues).length > 0) {\n    for (const [fieldName, fieldValue] of Object.entries(options.contextFieldValues)) {\n      const pathTokens = tokenizePath(fieldName);\n      if (pathTokens.length === 0) {\n        continue;\n      }\n      sanitizedData = setPath(sanitizedData, pathTokens, fieldValue) as Record<string, unknown>;\n    }\n  }\n\n  return sanitizedData as TData;\n}\n\n/**\n * Whether a resource form offers its sections a Save of their own.\n *\n * A section save writes part of records that EXIST — one record, or a bulk selection — so a create form, whose\n * record does not exist yet, offers none. Measured on Wonder Todos' reminder rule: the create\n * dialog showed three section \"Save\" buttons above its own Create, and none of them could create anything. A\n * caller that supplies its own section handler owns what a section save means, so it is honoured on any operation.\n */\nexport function formOffersSectionSave(params: { createsRecord: boolean; hasCallerSectionHandler: boolean }): boolean {\n  return !params.createsRecord || params.hasCallerSectionHandler;\n}\n"]}

package/dist/esm/components/form/automated/autosave-derivation.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autosave-derivation.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/autosave-derivation.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,EACpD,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAST"}
+{"version":3,"file":"autosave-derivation.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/autosave-derivation.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,EACpD,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAST"}

package/dist/esm/components/form/automated/autosave-derivation.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"autosave-derivation.frontend.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/autosave-derivation.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAAoD,EACpD,sBAA8B;IAE9B,IAAI,sBAAsB,KAAK,qBAAqB,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;QAC7D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { z } from 'zod';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { getFieldUIEditConfig } from '@wildo-ai/zod-decorators';\n\n/**\n * Does any field in this form DECLARE autosave, on an operation where autosave means anything?\n *\n * Pure and exported so the decision can be pinned without rendering a form — the surrounding memo\n * only adds \"and the caller passed no explicit config\".\n *\n * A field declares autosave with `edit.autosave: true` or an object; `{ enabled: false }` is an\n * explicit opt-OUT and must not count, or a field turning autosave off would turn the provider on.\n */\nexport function deriveAutosaveEnabledFromFields(\n  fieldShape: Record<string, z.ZodTypeAny> | undefined,\n  effectiveOperationType: string,\n): boolean {\n  if (effectiveOperationType !== CoreResourceOperation.UPDATE) return false;\n  if (!fieldShape) return false;\n  return Object.values(fieldShape).some((fieldSchema) => {\n    const declared = getFieldUIEditConfig(fieldSchema)?.autosave;\n    if (declared === undefined) return false;\n    if (declared === true) return true;\n    return typeof declared === 'object' && declared.enabled !== false;\n  });\n}\n\n\n"]}
+{"version":3,"file":"autosave-derivation.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/autosave-derivation.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAAoD,EACpD,sBAA8B;IAE9B,IAAI,sBAAsB,KAAK,qBAAqB,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;QAC7D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { z } from 'zod';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { getFieldUIEditConfig } from '@wildo-ai/zod-decorators';\n\n/**\n * Does any field in this form DECLARE autosave, on an operation where autosave means anything?\n *\n * Pure and exported so the decision can be pinned without rendering a form — the surrounding memo\n * only adds \"and the caller passed no explicit config\".\n *\n * A field declares autosave with `edit.autosave: true` or an object; `{ enabled: false }` is an\n * explicit opt-OUT and must not count, or a field turning autosave off would turn the provider on.\n */\nexport function deriveAutosaveEnabledFromFields(\n  fieldShape: Record<string, z.ZodTypeAny> | undefined,\n  effectiveOperationType: string,\n): boolean {\n  if (effectiveOperationType !== CoreResourceOperation.UPDATE) return false;\n  if (!fieldShape) return false;\n  return Object.values(fieldShape).some((fieldSchema) => {\n    const declared = getFieldUIEditConfig(fieldSchema)?.autosave;\n    if (declared === undefined) return false;\n    if (declared === true) return true;\n    return typeof declared === 'object' && declared.enabled !== false;\n  });\n}\n\n\n"]}