@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

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

@@ -0,0 +1,81 @@
+/**
+ * ResourceFormActionsContext — carries resource-level form actions (submit
+ * button, draft save button) from `ResourceAutomatedForm` into the form
+ * template tree.
+ *
+ * **Why this exists (host-owned submit row):**
+ *
+ * `ResourceAutomatedForm` always renders its own operation-aware submit row —
+ * a submit button labelled from the resource operation vocabulary
+ * (`components.RESOURCES_LAYOUTS_CREATE.{create|save|publish|...}`), plus the
+ * optional draft-save button. The buttons are appended AFTER the layout
+ * template by a thin wrapper that reads them from this context, so the
+ * template component identity stays stable while reactive button state
+ * (isSubmitting, isSavingDraft) updates via context instead of remounting
+ * the template tree.
+ *
+ * **Cross-cutting contract — auto-inject suppression:**
+ *
+ * The presence of this context is the signal that a resource-form host owns
+ * the submit row. `FormLayout` reads it via `useOptionalResourceFormActions()`
+ * and suppresses its automatic `<SubmitButton>` injection when a host is
+ * present. Without this, every developer-authored `layout.edit` template
+ * using a bare `<FormLayout>` under `ResourceAutomatedForm` would render TWO
+ * submit buttons: the auto-injected generic one (i18n fallback
+ * `components.LOW_LEVEL_FORM_MESSAGE.submitSave`) and the host's
+ * operation-aware one. The generated-template path already avoids this via
+ * `includeSubmitButton: false` → `autoInjectSubmitButton={false}`; this
+ * context closes the same gap for explicit templates, which the framework
+ * cannot force a prop onto.
+ *
+ * Templates rendered under `ResourceAutomatedForm` must therefore NOT place
+ * their own `<SubmitButton>` — the host appends the submit row in all cases.
+ * Standalone `FormLayout` usage (auth forms, direct `AutomatedForm` callers)
+ * is unaffected: no provider means no suppression.
+ */
+import React from 'react';
+import type { ReactNode } from 'react';
+export interface ResourceFormActionsValue {
+    /** Operation-aware submit button (e.g. "Create" / "Save" / "Publish"). */
+    submitButton: ReactNode;
+    /** Draft-save button when draft mode is enabled, otherwise null. */
+    draftSaveButton: ReactNode;
+    /**
+     * Secondary Cancel button (audit D5) — present when the host supplied an
+     * `onCancel` (overlay-hosted forms wire the modal-close path here so Cancel
+     * behaves exactly like the top-right X). Rendered BEFORE the draft/submit
+     * buttons in the footer row. `null`/absent renders nothing.
+     */
+    cancelButton?: ReactNode;
+    /**
+     * Submission-level notice rendered in the actions footer, directly ABOVE the
+     * submit row — e.g. the version-conflict banner. Submission outcomes belong
+     * next to the button that produced them (a long form can scroll the top-of-form
+     * banner out of view), so the host threads it here instead of rendering it at
+     * the top of the form. Ambient (non-submission) notices like remote-update
+     * indicators stay at the top. `null`/absent renders nothing.
+     */
+    submissionNotice?: ReactNode;
+}
+export interface ResourceFormActionsProviderProps {
+    value: ResourceFormActionsValue;
+    children: ReactNode;
+}
+/**
+ * Provides the host-owned form actions to the template tree.
+ * Placed by `ResourceAutomatedForm` around `AutomatedForm` so both the
+ * template wrapper (which renders the buttons) and skeleton components
+ * (which observe host ownership) can read it.
+ */
+export declare function ResourceFormActionsProvider({ value, children }: ResourceFormActionsProviderProps): React.JSX.Element;
+/**
+ * Read the resource form actions if a resource-form host provides them.
+ * Returns `null` outside `ResourceAutomatedForm` (standalone forms, auth).
+ *
+ * Consumers:
+ * - `ResourceAutomatedForm` template wrappers — render the buttons.
+ * - `FormLayout` — suppress automatic `<SubmitButton>` injection when a
+ *   host owns the submit row (non-null).
+ */
+export declare function useOptionalResourceFormActions(): ResourceFormActionsValue | null;
+//# sourceMappingURL=ResourceFormActionsContext.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,66 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ResourceFormActionsContext — carries resource-level form actions (submit
+ * button, draft save button) from `ResourceAutomatedForm` into the form
+ * template tree.
+ *
+ * **Why this exists (host-owned submit row):**
+ *
+ * `ResourceAutomatedForm` always renders its own operation-aware submit row —
+ * a submit button labelled from the resource operation vocabulary
+ * (`components.RESOURCES_LAYOUTS_CREATE.{create|save|publish|...}`), plus the
+ * optional draft-save button. The buttons are appended AFTER the layout
+ * template by a thin wrapper that reads them from this context, so the
+ * template component identity stays stable while reactive button state
+ * (isSubmitting, isSavingDraft) updates via context instead of remounting
+ * the template tree.
+ *
+ * **Cross-cutting contract — auto-inject suppression:**
+ *
+ * The presence of this context is the signal that a resource-form host owns
+ * the submit row. `FormLayout` reads it via `useOptionalResourceFormActions()`
+ * and suppresses its automatic `<SubmitButton>` injection when a host is
+ * present. Without this, every developer-authored `layout.edit` template
+ * using a bare `<FormLayout>` under `ResourceAutomatedForm` would render TWO
+ * submit buttons: the auto-injected generic one (i18n fallback
+ * `components.LOW_LEVEL_FORM_MESSAGE.submitSave`) and the host's
+ * operation-aware one. The generated-template path already avoids this via
+ * `includeSubmitButton: false` → `autoInjectSubmitButton={false}`; this
+ * context closes the same gap for explicit templates, which the framework
+ * cannot force a prop onto.
+ *
+ * Templates rendered under `ResourceAutomatedForm` must therefore NOT place
+ * their own `<SubmitButton>` — the host appends the submit row in all cases.
+ * Standalone `FormLayout` usage (auth forms, direct `AutomatedForm` callers)
+ * is unaffected: no provider means no suppression.
+ */
+import { createContext, useContext } from 'react';
+// =============================================================================
+// REACT CONTEXT
+// =============================================================================
+const ResourceFormActionsContext = createContext(null);
+/**
+ * Provides the host-owned form actions to the template tree.
+ * Placed by `ResourceAutomatedForm` around `AutomatedForm` so both the
+ * template wrapper (which renders the buttons) and skeleton components
+ * (which observe host ownership) can read it.
+ */
+export function ResourceFormActionsProvider({ value, children }) {
+    return (_jsx(ResourceFormActionsContext.Provider, { value: value, children: children }));
+}
+// =============================================================================
+// HOOKS
+// =============================================================================
+/**
+ * Read the resource form actions if a resource-form host provides them.
+ * Returns `null` outside `ResourceAutomatedForm` (standalone forms, auth).
+ *
+ * Consumers:
+ * - `ResourceAutomatedForm` template wrappers — render the buttons.
+ * - `FormLayout` — suppress automatic `<SubmitButton>` injection when a
+ *   host owns the submit row (non-null).
+ */
+export function useOptionalResourceFormActions() {
+    return useContext(ResourceFormActionsContext);
+}
+//# sourceMappingURL=ResourceFormActionsContext.js.map

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

@@ -0,0 +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"]}

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

@@ -1,12 +1,44 @@
+import { z } from 'zod';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
 type SubmissionContextFieldValues = Record<string, unknown>;
+/**
+ * Should a cleared (`null`) key be DROPPED from this submission?
+ *
+ * Yes on a create-like operation, where "the user emptied this" and "the user never filled it" are
+ * the same state and absence already says it. No on an update-like one, where dropping the key
+ * would discard the user's clear — the stored value would simply survive.
+ *
+ * A named decision rather than an inline comparison, because the inline version was WRONG: it
+ * compared a raw operation IDENTIFIER against the literal `'update'`, and that identifier is an
+ * arbitrary string for any custom operation. `UPDATE_MANY` and every custom update-like operation
+ * that does not declare `resourceOperationLike` were therefore classified as creates, and their
+ * clears were silently stripped before leaving the form.
+ *
+ * @param coreOperation - the RESOLVED core operation, supplied by a resource-aware wrapper. When
+ *   present it is the only input consulted.
+ * @param formOperationType - the raw identifier fallback, for a bare form mounted with no resource
+ *   semantics. An unresolved operation is treated as create-like, the conservative direction: such a
+ *   surface has no stored row whose value a dropped key could discard.
+ */
+export declare function shouldOmitClearedFieldsForOperation(coreOperation: CoreResourceOperation | undefined, formOperationType: string | undefined): boolean;
 export declare function pickSubmissionDataPaths<TData extends Record<string, unknown>>(data: TData, fieldNames: string[]): Partial<TData>;
 /**
  * Removes framework-hidden fields from the outgoing payload, then reapplies
  * context-owned values that must stay authoritative at submit time.
+ *
+ * On a CREATE-like operation it also drops cleared (`null`) keys — see `omitClearedFieldKeys` for
+ * why that belongs at this boundary and why it must NOT happen on an UPDATE.
  */
 export declare function sanitizeAutomatedFormSubmissionData<TData extends Record<string, unknown>>(data: TData, options: {
     hiddenFieldNames?: string[];
     contextFieldValues?: SubmissionContextFieldValues;
+    /** True when the submission creates a row, so absence and "cleared" are the same state. */
+    omitClearedFields?: boolean;
+    /**
+     * The schema this form validates. Used ONLY to tell an authored `.nullish()` null (a value)
+     * from the framework's cleared sentinel, so the CREATE strip does not discard the former.
+     */
+    schema?: z.ZodTypeAny;
 }): TData;
 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,KAAK,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8F5D,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;;;GAGG;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;CACnD,GACA,KAAK,CAsBP"}
+{"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;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"}

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

@@ -1,3 +1,29 @@
+import { getObjectLikeFieldSchema } from '@wildo-ai/zod-decorators';
+import { isUpdateLikeCoreOperation } from '../../../core/resources/operation-semantics.frontend.utils.js';
+/**
+ * Should a cleared (`null`) key be DROPPED from this submission?
+ *
+ * Yes on a create-like operation, where "the user emptied this" and "the user never filled it" are
+ * the same state and absence already says it. No on an update-like one, where dropping the key
+ * would discard the user's clear — the stored value would simply survive.
+ *
+ * A named decision rather than an inline comparison, because the inline version was WRONG: it
+ * compared a raw operation IDENTIFIER against the literal `'update'`, and that identifier is an
+ * arbitrary string for any custom operation. `UPDATE_MANY` and every custom update-like operation
+ * that does not declare `resourceOperationLike` were therefore classified as creates, and their
+ * clears were silently stripped before leaving the form.
+ *
+ * @param coreOperation - the RESOLVED core operation, supplied by a resource-aware wrapper. When
+ *   present it is the only input consulted.
+ * @param formOperationType - the raw identifier fallback, for a bare form mounted with no resource
+ *   semantics. An unresolved operation is treated as create-like, the conservative direction: such a
+ *   surface has no stored row whose value a dropped key could discard.
+ */
+export function shouldOmitClearedFieldsForOperation(coreOperation, formOperationType) {
+    if (coreOperation !== undefined)
+        return !isUpdateLikeCoreOperation(coreOperation);
+    return formOperationType !== 'update';
+}
 function tokenizePath(path) {
     return path.match(/[^.[\]]+/g) ?? [];
 }
@@ -87,12 +113,66 @@ export function pickSubmissionDataPaths(data, fieldNames) {
     }
     return subset;
 }
+/**
+ * Drop top-level keys whose value is the framework's CLEARED sentinel (`null`).
+ *
+ * Only meaningful on a CREATE-like submission, and only there. On an UPDATE the two states are
+ * genuinely different — an absent key leaves the stored value alone, a `null` clears it — so
+ * stripping would silently discard the user's clear. On a CREATE there is nothing to leave alone:
+ * "the user emptied this field" and "the user never filled it" are the same state, absence already
+ * says it, and the CREATE request DTO deliberately does not accept null.
+ *
+ * The strip happens HERE rather than in the field change handler because form state must keep
+ * `null`: react-hook-form reserves `undefined` to mean "fall back to defaultValue" and rejects it
+ * from `onChange`, so a cleared field cannot be represented as `undefined` while it is being
+ * edited. It only becomes absence at the boundary where the payload leaves the form.
+ *
+ * Nested objects are left alone: clearing a member of a nested object is expressed by replacing the
+ * object, and this pass must not reach inside one and change its shape.
+ */
+function omitClearedFieldKeys(data, schema) {
+    const withoutClearedKeys = {};
+    for (const [fieldName, value] of Object.entries(data)) {
+        if (value === null && !fieldAcceptsNullAsAValue(schema, fieldName))
+            continue;
+        withoutClearedKeys[fieldName] = value;
+    }
+    return withoutClearedKeys;
+}
+/**
+ * Did the AUTHOR declare `null` as a meaningful value for this field, or is it merely the
+ * framework's cleared sentinel?
+ *
+ * The distinction decides whether the CREATE strip may drop the key. A field the create DTO refuses
+ * a null for can only be carrying OUR sentinel, so dropping it is lossless. A field that ACCEPTS
+ * null — an authored `.nullish()` — is one where the author modelled null as a value distinct from
+ * absence, and dropping it changes what gets created.
+ *
+ * The case that makes this more than pedantry is `z.string().nullish().default('x')`: a default
+ * fires on `undefined`, so stripping the user's explicit null makes the server apply the DEFAULT —
+ * the opposite of what the user asked for. Found by independent review.
+ *
+ * An unresolvable field is treated as NOT null-accepting, i.e. stripped. That is the conservative
+ * direction here: the create DTO would reject a null it does not declare, so keeping it would turn
+ * a clear into a 400.
+ */
+function fieldAcceptsNullAsAValue(schema, fieldName) {
+    if (!schema)
+        return false;
+    const fieldSchema = getObjectLikeFieldSchema(schema, fieldName);
+    return fieldSchema ? fieldSchema.safeParse(null).success : false;
+}
 /**
  * Removes framework-hidden fields from the outgoing payload, then reapplies
  * context-owned values that must stay authoritative at submit time.
+ *
+ * On a CREATE-like operation it also drops cleared (`null`) keys — see `omitClearedFieldKeys` for
+ * why that belongs at this boundary and why it must NOT happen on an UPDATE.
  */
 export function sanitizeAutomatedFormSubmissionData(data, options) {
-    let sanitizedData = data;
+    let sanitizedData = options.omitClearedFields
+        ? omitClearedFieldKeys(data, options.schema)
+        : data;
     for (const hiddenFieldName of options.hiddenFieldNames ?? []) {
         const pathTokens = tokenizePath(hiddenFieldName);
         if (pathTokens.length === 0) {
@@ -111,4 +191,4 @@ export function sanitizeAutomatedFormSubmissionData(data, options) {
     }
     return sanitizedData;
 }
-//# sourceMappingURL=automated-form-submit.utils.js.map
+//# 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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"}
+{"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 * 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"]}

package/dist/esm/components/form/automated/autosave-indicator.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas.js';
-import { AutosaveFieldState } from '../../../components/form/form-field-types.js';
+import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
+import { AutosaveFieldState } from '../../../components/form/form-field-types';
 export interface AutosaveIndicatorProps {
     /** Current save state of the field */
     state: AutosaveFieldState;

package/dist/esm/components/form/automated/autosave-indicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autosave-indicator.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/autosave-indicator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AAGzF,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,KAAK,EAAE,kBAAkB,CAAA;IACzB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAA;CACvC;AAED,kFAAkF;AAClF,MAAM,WAAW,gCAAgC;IAC/C,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC7B;AAGD,wBAAgB,iBAAiB,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGlJ"}
+{"version":3,"file":"autosave-indicator.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/autosave-indicator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AAGzF,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,KAAK,EAAE,kBAAkB,CAAA;IACzB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAA;CACvC;AAED,kFAAkF;AAClF,MAAM,WAAW,gCAAgC;IAC/C,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC7B;AAGD,wBAAgB,iBAAiB,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGlJ"}

package/dist/esm/components/form/automated/autosave-indicator.js

@@ -6,4 +6,4 @@ export function AutosaveIndicator({ preset = CorePresetNames.DEFAULT, ...props }
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_AUTOSAVE_INDICATOR, 'AutosaveIndicator')(preset);
     return _jsx(Component, { ...props });
 }
-//# sourceMappingURL=autosave-indicator.js.map
+//# sourceMappingURL=autosave-indicator.js.map

package/dist/esm/components/form/automated/autosave-indicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"autosave-indicator.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/autosave-indicator.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AA6B5F,kBAAkB;AAClB,MAAM,UAAU,iBAAiB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAiD;IAC7H,MAAM,SAAS,GAAG,uBAAuB,CAAyB,qBAAqB,CAAC,4BAA4B,EAAE,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;IAClJ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC"}
+{"version":3,"file":"autosave-indicator.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/autosave-indicator.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AA6B5F,kBAAkB;AAClB,MAAM,UAAU,iBAAiB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAiD;IAC7H,MAAM,SAAS,GAAG,uBAAuB,CAAyB,qBAAqB,CAAC,4BAA4B,EAAE,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;IAClJ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { AutosaveFieldState } from '~wildo-frontend-lib/components/form/form-field-types'\n\n// --- Contract ---\nexport interface AutosaveIndicatorProps {\n  /** Current save state of the field */\n  state: AutosaveFieldState\n  /** Error message to display (when state is 'error') */\n  errorMessage?: string\n  /** Callback when retry is clicked (when state is 'error') */\n  onRetry?: () => void\n  /** Additional CSS class names */\n  className?: string\n  /** Size variant */\n  size?: 'sm' | 'md'\n  /** Position of the indicator */\n  position?: 'inline' | 'absolute-right'\n}\n\n/** Options for the shared autosave indicator wrapper (used by FormFieldChrome) */\nexport interface WrapWithAutosaveIndicatorOptions {\n  saveState?: AutosaveFieldState\n  saveErrorMessage?: string\n  onRetrySave?: () => void\n  /** Layout variant: 'block' (default) or 'inline' */\n  variant?: 'block' | 'inline'\n}\n\n// --- Wrapper ---\nexport function AutosaveIndicator({ preset = CorePresetNames.DEFAULT, ...props }: AutosaveIndicatorProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AutosaveIndicatorProps>(FrontendComponentType.LOW_LEVEL_AUTOSAVE_INDICATOR, 'AutosaveIndicator')(preset)\n  return <Component {...props} />\n}\n"]}

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

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type WrapWithAutosaveIndicatorOptions } from './autosave-indicator.js';
+import { type WrapWithAutosaveIndicatorOptions } from './autosave-indicator';
 /**
  * Wraps a form field element with an AutosaveIndicator when the save state is active.
  * Returns the element unchanged when idle or when no save state is provided.

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

@@ -1 +1 @@
-{"version":3,"file":"autosave-indicator.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/autosave-indicator.utils.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAqB,KAAK,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AAE/F;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EACxB,OAAO,EAAE,gCAAgC,GACxC,KAAK,CAAC,GAAG,CAAC,OAAO,CAkCnB"}
+{"version":3,"file":"autosave-indicator.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/autosave-indicator.utils.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAqB,KAAK,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AAE/F;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EACxB,OAAO,EAAE,gCAAgC,GACxC,KAAK,CAAC,GAAG,CAAC,OAAO,CAkCnB"}

package/dist/esm/components/form/automated/autosave-indicator.utils.js

@@ -15,4 +15,4 @@ export function wrapWithAutosaveIndicator(input, options) {
     }
     return (_jsxs("div", { className: "relative", children: [input, _jsx(AutosaveIndicator, { state: saveState, errorMessage: saveErrorMessage, onRetry: onRetrySave, position: "absolute-right", className: onRetrySave ? undefined : "pointer-events-none" })] }));
 }
-//# sourceMappingURL=autosave-indicator.utils.js.map
+//# sourceMappingURL=autosave-indicator.utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"autosave-indicator.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/autosave-indicator.utils.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EAAE,iBAAiB,EAAyC,MAAM,sBAAsB,CAAA;AAE/F;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAwB,EACxB,OAAyC;IAEzC,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAEhF,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,kBAAkB,CAAC,IAAI,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CACL,eAAK,SAAS,EAAC,sBAAsB,aAClC,KAAK,EACN,KAAC,iBAAiB,IAChB,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAC,QAAQ,EACjB,SAAS,EAAC,YAAY,GACtB,IACE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eAAK,SAAS,EAAC,UAAU,aACtB,KAAK,EACN,KAAC,iBAAiB,IAChB,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAC,gBAAgB,EACzB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,GAC1D,IACE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"autosave-indicator.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/autosave-indicator.utils.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EAAE,iBAAiB,EAAyC,MAAM,sBAAsB,CAAA;AAE/F;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAwB,EACxB,OAAyC;IAEzC,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAEhF,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,kBAAkB,CAAC,IAAI,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CACL,eAAK,SAAS,EAAC,sBAAsB,aAClC,KAAK,EACN,KAAC,iBAAiB,IAChB,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAC,QAAQ,EACjB,SAAS,EAAC,YAAY,GACtB,IACE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eAAK,SAAS,EAAC,UAAU,aACtB,KAAK,EACN,KAAC,iBAAiB,IAChB,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAC,gBAAgB,EACzB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,GAC1D,IACE,CACP,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react'\nimport { AutosaveFieldState } from '~wildo-frontend-lib/components/form/form-field-types'\nimport { AutosaveIndicator, type WrapWithAutosaveIndicatorOptions } from './autosave-indicator'\n\n/**\n * Wraps a form field element with an AutosaveIndicator when the save state is active.\n * Returns the element unchanged when idle or when no save state is provided.\n */\nexport function wrapWithAutosaveIndicator(\n  input: React.JSX.Element,\n  options: WrapWithAutosaveIndicatorOptions\n): React.JSX.Element {\n  const { saveState, saveErrorMessage, onRetrySave, variant = 'block' } = options;\n\n  if (!saveState || saveState === AutosaveFieldState.IDLE) {\n    return input;\n  }\n\n  if (variant === 'inline') {\n    return (\n      <div className=\"relative inline-flex\">\n        {input}\n        <AutosaveIndicator\n          state={saveState}\n          errorMessage={saveErrorMessage}\n          onRetry={onRetrySave}\n          position=\"inline\"\n          className=\"ml-element\"\n        />\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"relative\">\n      {input}\n      <AutosaveIndicator\n        state={saveState}\n        errorMessage={saveErrorMessage}\n        onRetry={onRetrySave}\n        position=\"absolute-right\"\n        className={onRetrySave ? undefined : \"pointer-events-none\"}\n      />\n    </div>\n  );\n}\n"]}

package/dist/esm/components/form/automated/create-form-default-values.utils.d.ts

@@ -0,0 +1,80 @@
+import type { z } from 'zod';
+/**
+ * The slice of a resource's inheritance (discriminated-union) configuration that
+ * the create-form initial-value seeding needs.
+ *
+ * Mirrors the shape `ResourceAutomatedForm` derives from
+ * `resourceConfig.inheritenceSchemaDefinition` — kept structural (not a re-export
+ * of the full config type) so this pure util stays decoupled from the registry.
+ */
+export interface CreateFormInheritanceConfig {
+    /** Field name that discriminates the union (e.g. `recurringType`). */
+    discriminatorField: string;
+    /**
+     * Discriminator values handled by the BASE schema alone (no variant
+     * extension). The first entry is the natural "base variant" fallback when the
+     * discriminator field declares no `.default()`.
+     */
+    withoutInheritanceDiscriminatorFieldValues?: string[];
+}
+/** Inputs for {@link resolveCreateFormInitialValues}. */
+export interface ResolveCreateFormInitialValuesInput {
+    /**
+     * The union-aware field shape of the form schema
+     * (`getObjectLikeFieldShape(operation.requestDto)`). For a discriminated union
+     * this is the MERGED shape across variants, so the discriminator field (and its
+     * `.default()` decorator) is present here.
+     */
+    formFieldShape: Record<string, z.ZodTypeAny> | undefined;
+    /** Inheritance config when the resource is a discriminated schema family; `undefined` otherwise. */
+    inheritanceConfig: CreateFormInheritanceConfig | undefined;
+    /** Caller-supplied default values (context FKs, duplicate seeds, etc.). Always wins over seeded defaults. */
+    defaultValuesOverride: Record<string, unknown> | undefined;
+}
+/**
+ * Compute the react-hook-form `defaultValues` for a CREATE operation.
+ *
+ * Two distinct problems are solved by seeding here, both rooted in the fact that
+ * `Form`/`useForm` consume `defaultValues` only at initialization:
+ *
+ * ## 1. The discriminated-union dispatch trap (correctness)
+ *
+ * `createSchemaFamily` validates a CREATE against a `z.discriminatedUnion` keyed
+ * on the discriminator field. Zod reads the discriminator value from the **raw
+ * input** to pick which variant to parse, and that dispatch happens **before**
+ * any variant-level `.default()` is applied. So when the create form leaves the
+ * discriminator `undefined` (it is frequently a structural field the layout does
+ * not even render), dispatch fails with `Invalid input` on the discriminator
+ * path and the form can NEVER submit — even though the discriminator declares a
+ * `.default()`. (Observed live: Wonder Todos `todos` create blocked on
+ * `recurringType` despite `.default(ONE_TIME)`.)
+ *
+ * The discriminator seed comes from the field's own `.default()` (honouring the
+ * schema as the single source of truth), falling back to the first
+ * "base variant" value when the field declares no default.
+ *
+ * ## 2. Visible schema defaults (truthfulness — audit finding D3)
+ *
+ * Regular (non-discriminator) field defaults do not need seeding for the SUBMIT
+ * to work — once a variant is selected, the resolver applies their `.default()`
+ * during the variant parse. But without seeding, the FORM LIES: a `status`
+ * field with `.default('pending')` renders an empty "Select..." although the
+ * created record will carry `pending`. We therefore seed EVERY field whose
+ * schema declares a `.default()` (unwrapping optional/nullable — see
+ * `getDefaultValue`), so the create form shows exactly the values the backend
+ * will apply. Fields without a declared default stay untouched/empty.
+ *
+ * Seeding from the MERGED union shape is deliberate and safe: a default that
+ * belongs to a variant other than the selected one is stripped at submit time
+ * by the resolver's variant parse (schema-family variants are non-strict
+ * objects), so it never reaches the wire for the wrong variant.
+ *
+ * Caller-provided `defaultValuesOverride` always wins (it carries context FKs and
+ * duplicate seeds the user/route already decided). When nothing is seeded and no
+ * override is supplied we return `undefined`, preserving the prior
+ * "no defaultValues" behavior exactly for schemas with no declared defaults.
+ *
+ * @returns the merged initial values, or `undefined` when there is nothing to seed.
+ */
+export declare function resolveCreateFormInitialValues(input: ResolveCreateFormInitialValuesInput): Record<string, unknown> | undefined;
+//# sourceMappingURL=create-form-default-values.utils.d.ts.map

package/dist/esm/components/form/automated/create-form-default-values.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-form-default-values.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/create-form-default-values.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;CACvD;AAED,yDAAyD;AACzD,MAAM,WAAW,mCAAmC;IAClD;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IACzD,oGAAoG;IACpG,iBAAiB,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAC3D,6GAA6G;IAC7G,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mCAAmC,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkCrC"}

package/dist/esm/components/form/automated/create-form-default-values.utils.js

@@ -0,0 +1,77 @@
+import { getDefaultValue } from '@wildo-ai/zod-decorators';
+/**
+ * Compute the react-hook-form `defaultValues` for a CREATE operation.
+ *
+ * Two distinct problems are solved by seeding here, both rooted in the fact that
+ * `Form`/`useForm` consume `defaultValues` only at initialization:
+ *
+ * ## 1. The discriminated-union dispatch trap (correctness)
+ *
+ * `createSchemaFamily` validates a CREATE against a `z.discriminatedUnion` keyed
+ * on the discriminator field. Zod reads the discriminator value from the **raw
+ * input** to pick which variant to parse, and that dispatch happens **before**
+ * any variant-level `.default()` is applied. So when the create form leaves the
+ * discriminator `undefined` (it is frequently a structural field the layout does
+ * not even render), dispatch fails with `Invalid input` on the discriminator
+ * path and the form can NEVER submit — even though the discriminator declares a
+ * `.default()`. (Observed live: Wonder Todos `todos` create blocked on
+ * `recurringType` despite `.default(ONE_TIME)`.)
+ *
+ * The discriminator seed comes from the field's own `.default()` (honouring the
+ * schema as the single source of truth), falling back to the first
+ * "base variant" value when the field declares no default.
+ *
+ * ## 2. Visible schema defaults (truthfulness — audit finding D3)
+ *
+ * Regular (non-discriminator) field defaults do not need seeding for the SUBMIT
+ * to work — once a variant is selected, the resolver applies their `.default()`
+ * during the variant parse. But without seeding, the FORM LIES: a `status`
+ * field with `.default('pending')` renders an empty "Select..." although the
+ * created record will carry `pending`. We therefore seed EVERY field whose
+ * schema declares a `.default()` (unwrapping optional/nullable — see
+ * `getDefaultValue`), so the create form shows exactly the values the backend
+ * will apply. Fields without a declared default stay untouched/empty.
+ *
+ * Seeding from the MERGED union shape is deliberate and safe: a default that
+ * belongs to a variant other than the selected one is stripped at submit time
+ * by the resolver's variant parse (schema-family variants are non-strict
+ * objects), so it never reaches the wire for the wrong variant.
+ *
+ * Caller-provided `defaultValuesOverride` always wins (it carries context FKs and
+ * duplicate seeds the user/route already decided). When nothing is seeded and no
+ * override is supplied we return `undefined`, preserving the prior
+ * "no defaultValues" behavior exactly for schemas with no declared defaults.
+ *
+ * @returns the merged initial values, or `undefined` when there is nothing to seed.
+ */
+export function resolveCreateFormInitialValues(input) {
+    const { formFieldShape, inheritanceConfig, defaultValuesOverride } = input;
+    const seeded = {};
+    // D3: seed every declared schema default so the form displays what the
+    // backend will apply. `getDefaultValue` evaluates function defaults per call
+    // (Zod 4 stores `defaultValue` as a getter/function), so each form mount gets
+    // a fresh value — no frozen module-load snapshot.
+    if (formFieldShape) {
+        for (const [fieldName, fieldSchema] of Object.entries(formFieldShape)) {
+            const declaredDefault = getDefaultValue(fieldSchema);
+            if (declaredDefault !== undefined) {
+                seeded[fieldName] = declaredDefault;
+            }
+        }
+    }
+    // Discriminator seed: schema `.default()` (already collected above) with the
+    // base-variant fallback when the discriminator declares no default.
+    const discriminatorField = inheritanceConfig?.discriminatorField;
+    if (discriminatorField && seeded[discriminatorField] === undefined) {
+        const baseVariantFallback = inheritanceConfig?.withoutInheritanceDiscriminatorFieldValues?.[0];
+        if (baseVariantFallback !== undefined) {
+            seeded[discriminatorField] = baseVariantFallback;
+        }
+    }
+    // Caller overrides always win over seeded schema defaults.
+    const merged = { ...seeded, ...(defaultValuesOverride ?? {}) };
+    // Preserve the prior `undefined` contract when there is genuinely nothing to
+    // seed — default-free schemas without an override see no behavior change.
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+//# sourceMappingURL=create-form-default-values.utils.js.map

package/dist/esm/components/form/automated/create-form-default-values.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-form-default-values.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/create-form-default-values.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAqC3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAA0C;IAE1C,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,GAAG,KAAK,CAAC;IAE3E,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,uEAAuE;IACvE,6EAA6E;IAC7E,8EAA8E;IAC9E,kDAAkD;IAClD,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACtE,MAAM,eAAe,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,MAAM,kBAAkB,GAAG,iBAAiB,EAAE,kBAAkB,CAAC;IACjE,IAAI,kBAAkB,IAAI,MAAM,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,mBAAmB,GAAG,iBAAiB,EAAE,0CAA0C,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/F,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,CAAC,kBAAkB,CAAC,GAAG,mBAAmB,CAAC;QACnD,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,EAAE,CAAC;IAExF,6EAA6E;IAC7E,0EAA0E;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC","sourcesContent":["import { getDefaultValue } from '@wildo-ai/zod-decorators';\nimport type { z } from 'zod';\n\n/**\n * The slice of a resource's inheritance (discriminated-union) configuration that\n * the create-form initial-value seeding needs.\n *\n * Mirrors the shape `ResourceAutomatedForm` derives from\n * `resourceConfig.inheritenceSchemaDefinition` — kept structural (not a re-export\n * of the full config type) so this pure util stays decoupled from the registry.\n */\nexport interface CreateFormInheritanceConfig {\n  /** Field name that discriminates the union (e.g. `recurringType`). */\n  discriminatorField: string;\n  /**\n   * Discriminator values handled by the BASE schema alone (no variant\n   * extension). The first entry is the natural \"base variant\" fallback when the\n   * discriminator field declares no `.default()`.\n   */\n  withoutInheritanceDiscriminatorFieldValues?: string[];\n}\n\n/** Inputs for {@link resolveCreateFormInitialValues}. */\nexport interface ResolveCreateFormInitialValuesInput {\n  /**\n   * The union-aware field shape of the form schema\n   * (`getObjectLikeFieldShape(operation.requestDto)`). For a discriminated union\n   * this is the MERGED shape across variants, so the discriminator field (and its\n   * `.default()` decorator) is present here.\n   */\n  formFieldShape: Record<string, z.ZodTypeAny> | undefined;\n  /** Inheritance config when the resource is a discriminated schema family; `undefined` otherwise. */\n  inheritanceConfig: CreateFormInheritanceConfig | undefined;\n  /** Caller-supplied default values (context FKs, duplicate seeds, etc.). Always wins over seeded defaults. */\n  defaultValuesOverride: Record<string, unknown> | undefined;\n}\n\n/**\n * Compute the react-hook-form `defaultValues` for a CREATE operation.\n *\n * Two distinct problems are solved by seeding here, both rooted in the fact that\n * `Form`/`useForm` consume `defaultValues` only at initialization:\n *\n * ## 1. The discriminated-union dispatch trap (correctness)\n *\n * `createSchemaFamily` validates a CREATE against a `z.discriminatedUnion` keyed\n * on the discriminator field. Zod reads the discriminator value from the **raw\n * input** to pick which variant to parse, and that dispatch happens **before**\n * any variant-level `.default()` is applied. So when the create form leaves the\n * discriminator `undefined` (it is frequently a structural field the layout does\n * not even render), dispatch fails with `Invalid input` on the discriminator\n * path and the form can NEVER submit — even though the discriminator declares a\n * `.default()`. (Observed live: Wonder Todos `todos` create blocked on\n * `recurringType` despite `.default(ONE_TIME)`.)\n *\n * The discriminator seed comes from the field's own `.default()` (honouring the\n * schema as the single source of truth), falling back to the first\n * \"base variant\" value when the field declares no default.\n *\n * ## 2. Visible schema defaults (truthfulness — audit finding D3)\n *\n * Regular (non-discriminator) field defaults do not need seeding for the SUBMIT\n * to work — once a variant is selected, the resolver applies their `.default()`\n * during the variant parse. But without seeding, the FORM LIES: a `status`\n * field with `.default('pending')` renders an empty \"Select...\" although the\n * created record will carry `pending`. We therefore seed EVERY field whose\n * schema declares a `.default()` (unwrapping optional/nullable — see\n * `getDefaultValue`), so the create form shows exactly the values the backend\n * will apply. Fields without a declared default stay untouched/empty.\n *\n * Seeding from the MERGED union shape is deliberate and safe: a default that\n * belongs to a variant other than the selected one is stripped at submit time\n * by the resolver's variant parse (schema-family variants are non-strict\n * objects), so it never reaches the wire for the wrong variant.\n *\n * Caller-provided `defaultValuesOverride` always wins (it carries context FKs and\n * duplicate seeds the user/route already decided). When nothing is seeded and no\n * override is supplied we return `undefined`, preserving the prior\n * \"no defaultValues\" behavior exactly for schemas with no declared defaults.\n *\n * @returns the merged initial values, or `undefined` when there is nothing to seed.\n */\nexport function resolveCreateFormInitialValues(\n  input: ResolveCreateFormInitialValuesInput,\n): Record<string, unknown> | undefined {\n  const { formFieldShape, inheritanceConfig, defaultValuesOverride } = input;\n\n  const seeded: Record<string, unknown> = {};\n\n  // D3: seed every declared schema default so the form displays what the\n  // backend will apply. `getDefaultValue` evaluates function defaults per call\n  // (Zod 4 stores `defaultValue` as a getter/function), so each form mount gets\n  // a fresh value — no frozen module-load snapshot.\n  if (formFieldShape) {\n    for (const [fieldName, fieldSchema] of Object.entries(formFieldShape)) {\n      const declaredDefault = getDefaultValue(fieldSchema);\n      if (declaredDefault !== undefined) {\n        seeded[fieldName] = declaredDefault;\n      }\n    }\n  }\n\n  // Discriminator seed: schema `.default()` (already collected above) with the\n  // base-variant fallback when the discriminator declares no default.\n  const discriminatorField = inheritanceConfig?.discriminatorField;\n  if (discriminatorField && seeded[discriminatorField] === undefined) {\n    const baseVariantFallback = inheritanceConfig?.withoutInheritanceDiscriminatorFieldValues?.[0];\n    if (baseVariantFallback !== undefined) {\n      seeded[discriminatorField] = baseVariantFallback;\n    }\n  }\n\n  // Caller overrides always win over seeded schema defaults.\n  const merged: Record<string, unknown> = { ...seeded, ...(defaultValuesOverride ?? {}) };\n\n  // Preserve the prior `undefined` contract when there is genuinely nothing to\n  // seed — default-free schemas without an override see no behavior change.\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n"]}