@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

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

@@ -11,7 +11,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * `layoutTemplate` is required — callers must either provide an explicit template
  * or use `generateDefaultFormTemplate()` to produce one from the schema and config.
  */
-import { useMemo } from 'react';
+import { useCallback, useContext, useMemo, useRef } from 'react';
 import { FrontendComponentType, } from '@wildo-ai/presets-components-models';
 import { FormChromeProvider } from '../chromes/FormChromeContext.js';
 import { useI18n } from '../../../core/i18n/useI18n.js';
@@ -20,11 +20,13 @@ import { Skeleton } from '../../../components/feedback/skeleton.js';
 import { Form } from '../../../components/form/Form.js';
 import { FormTemplateProvider } from './FormTemplateContext.js';
 import { pickSubmissionDataPaths, sanitizeAutomatedFormSubmissionData, shouldOmitClearedFieldsForOperation } from './automated-form-submit.utils.js';
+import { applyRequestFieldOffersToRequest, resolveRequestFieldOffer, } from '@wildo-ai/saas-models';
+import { ApplicationContext } from '../../../core/runtime/ApplicationContext.shared.js';
 import { useResourceLabels } from '../../../core/resources/useResourceLabels.js';
 // =============================================================================
 // COMPONENT
 // =============================================================================
-function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, validationMode, className, disabled, readOnly, id, warnOnUnsavedChanges = false, labels, operationRef, operationType, operationLike, coreOperation, layoutRefs, fileUploadContext, contextFieldValues, hiddenFieldNames, generatedFieldOverrides, inheritanceConfig, chromeMode, onSectionSave, onFormReady, validateFieldUrl, resourceId, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, layoutTemplate: LayoutTemplate, }) {
+function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, validationMode, className, disabled, readOnly, id, warnOnUnsavedChanges = false, labels, operationRef, operationType, operationLike, coreOperation, layoutRefs, fileUploadContext, contextFieldValues, hiddenFieldNames, generatedFieldOverrides, allowedValuesByField, requestFieldOffers, requestFieldOfferRecord, inheritanceConfig, chromeMode, onSectionSave, onFormReady, validateFieldUrl, resourceId, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, layoutTemplate: LayoutTemplate, }) {
     const { tComponent, isReady } = useI18n({
         component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,
     });
@@ -33,6 +35,7 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
         layoutRefs,
         overrides: {
             fields: labels?.fields,
+            descriptions: labels?.descriptions,
             enums: labels?.enums,
             sections: labels?.sections,
             wizardSteps: labels?.wizardSteps,
@@ -73,9 +76,32 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
     // where an unresolved operation is treated as CREATE-like — the conservative direction for a
     // surface that has no stored row to clear.
     const omitClearedFields = shouldOmitClearedFieldsForOperation(coreOperation, operationLike || operationType);
+    /*
+     * #2744 review F1, F2: what the operation does not offer leaves EVERY submission, at this boundary. Hiding a field is not
+     * enough: a field array keeps its value when hidden, and an operation on a record starts from the whole row, so a field
+     * never shown is still held. An offer is judged HERE from the submitted values and the row (review N2: a report from a
+     * field that has since unmounted may be stale), except one that reads a referenced row, which only a mounted field can
+     * read: that one takes the offer the field last reported.
+     */
+    const appConfig = useContext(ApplicationContext)?.appConfig;
+    const reportedOffersRef = useRef(new Map());
+    const reportRequestFieldOffer = useCallback((fieldName, offer) => {
+        reportedOffersRef.current.set(fieldName, offer);
+    }, []);
+    const admitOfferedFields = useCallback((data) => {
+        if (!requestFieldOffers)
+            return data;
+        const offers = Object.fromEntries(Object.entries(requestFieldOffers).map(([field, declaration]) => {
+            const reported = declaration.readsReferences ? reportedOffersRef.current.get(field) : undefined;
+            return [field, reported ?? resolveRequestFieldOffer(declaration, {
+                    appConfig, currentObject: requestFieldOfferRecord, values: data, references: {},
+                })];
+        }));
+        return applyRequestFieldOffersToRequest(data, offers);
+    }, [requestFieldOffers, requestFieldOfferRecord, appConfig]);
     const wrappedOnSubmit = useMemo(() => {
         return (data) => {
-            const processedData = sanitizeAutomatedFormSubmissionData(data, {
+            const processedData = sanitizeAutomatedFormSubmissionData(admitOfferedFields(data), {
                 hiddenFieldNames,
                 contextFieldValues,
                 omitClearedFields,
@@ -83,7 +109,7 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
             });
             return onSubmit(processedData);
         };
-    }, [onSubmit, contextFieldValues, hiddenFieldNames, omitClearedFields]);
+    }, [onSubmit, contextFieldValues, hiddenFieldNames, omitClearedFields, admitOfferedFields]);
     // Apply the same payload-boundary guarantees to section saves so explicit
     // templates do not accidentally leak wrapper-hidden or context-owned fields.
     const wrappedOnSectionSave = useMemo(() => {
@@ -94,7 +120,7 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
             const sectionScopedData = fieldNames.length > 0
                 ? pickSubmissionDataPaths(data, fieldNames)
                 : data;
-            const processedData = sanitizeAutomatedFormSubmissionData(sectionScopedData, {
+            const processedData = sanitizeAutomatedFormSubmissionData(admitOfferedFields(sectionScopedData), {
                 hiddenFieldNames,
                 contextFieldValues,
                 omitClearedFields,
@@ -102,7 +128,7 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
             });
             return onSectionSave(sectionRef, fieldNames, processedData);
         };
-    }, [onSectionSave, contextFieldValues, hiddenFieldNames, omitClearedFields]);
+    }, [onSectionSave, contextFieldValues, hiddenFieldNames, omitClearedFields, admitOfferedFields]);
     // Form template context — carries all resolved values so skeleton components
     // (FormField, Section, WizardLayout, etc.) can read from context.
     const formTemplateContextValue = useMemo(() => ({
@@ -122,6 +148,10 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
         contextFieldValues,
         hiddenFieldNames,
         generatedFieldOverrides,
+        allowedValuesByField,
+        requestFieldOffers,
+        requestFieldOfferRecord,
+        reportRequestFieldOffer,
         onSectionSave: wrappedOnSectionSave,
         operationType: operationLike || operationType,
         operationRef,
@@ -144,6 +174,10 @@ function AutomatedFormComponent({ schema, defaultValues, onSubmit, onError, vali
         contextFieldValues,
         hiddenFieldNames,
         generatedFieldOverrides,
+        allowedValuesByField,
+        requestFieldOffers,
+        requestFieldOfferRecord,
+        reportRequestFieldOffer,
         inheritanceConfig,
         wrappedOnSectionSave,
         operationLike,

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

@@ -1 +1 @@
-{"version":3,"file":"AutomatedForm.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutomatedForm.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * AutomatedForm Component\n *\n * Schema-driven form that renders a mandatory layout template inside infrastructure\n * wrappers (RHF FormProvider, FormTemplateContext, FormChromeProvider).\n *\n * The template controls field order, section structure, wizard steps, and grid layout.\n * All infrastructure (validation, submission, unsaved-changes guard) stays outside.\n *\n * `layoutTemplate` is required — callers must either provide an explicit template\n * or use `generateDefaultFormTemplate()` to produce one from the schema and config.\n */\n\nimport React, { useMemo } from 'react';\nimport { z } from 'zod';\nimport type { FieldErrors, DefaultValues } from 'react-hook-form';\n\nimport {\n  type AutomatedFormLabels,\n  type ResponsiveChromeMode,\n  FrontendComponentType,\n} from '@wildo-ai/presets-components-models';\nimport { FormChromeProvider } from '../chromes/FormChromeContext';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { Form, type FormMethods } from '~wildo-frontend-lib/components/form/Form';\nimport { FormTemplateProvider, type FormTemplateContextValue } from './FormTemplateContext';\nimport type { ValidationMode } from '../form-field-types';\nimport type { FileFieldEndpoints } from '@wildo-ai/zod-decorators';\nimport { pickSubmissionDataPaths, sanitizeAutomatedFormSubmissionData, shouldOmitClearedFieldsForOperation } from './automated-form-submit.utils';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\n\nimport type {\n  FormOperationType,\n  InheritanceSchemaDefinition,\n} from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.schemas';\nimport type { LayoutRefManifest } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n// =============================================================================\n// PROPS\n// =============================================================================\n\nexport interface AutomatedFormProps<TSchema extends z.ZodTypeAny> {\n  schema: TSchema;\n  defaultValues?: DefaultValues<z.infer<TSchema>>;\n  onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;\n  onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;\n  validationMode?: ValidationMode;\n  className?: string;\n  disabled?: boolean;\n  /**\n   * Makes all form fields read-only (values are submitted but not editable).\n   * Individual fields can also be made read-only via the isNotEditable() schema decorator.\n   * Unlike disabled, read-only field values are included in submission.\n   */\n  readOnly?: boolean;\n  id?: string;\n\n  /**\n   * When true, shows a browser confirmation dialog when the user tries to leave\n   * the page (tab close, refresh, back button) while the form has unsaved changes.\n   * Uses the browser's native `beforeunload` event.\n   * @default false\n   */\n  warnOnUnsavedChanges?: boolean;\n\n  /**\n   * Unified labels interface for all form text.\n   * Supports explicit overrides and i18n resolution via resourceContext.\n   */\n  labels?: AutomatedFormLabels;\n\n  /**\n   * Specific operation identifier for operation-level field visibility rules.\n   * Used with isHidden({ operations: ['ARCHIVE'] }) decorator to control\n   * which fields appear for specific operations (beyond just create/update type).\n   */\n  operationRef?: string;\n\n  /**\n   * Operation type for decorator-based field filtering.\n   * Controls excludeFromCreate, excludeFromUpdate, and isHidden(operations) behavior.\n   */\n  operationType?: FormOperationType;\n\n  /**\n   * Operation-like type for custom operations that behave like core operations.\n   * When specified, takes precedence over operationType for excludeFromCreate/excludeFromUpdate checks.\n   */\n  operationLike?: FormOperationType;\n  /**\n   * The RESOLVED core operation this form performs. Supplied by the resource-aware wrapper, which\n   * already resolves custom operations through `resourceOperationLike`. It decides whether a\n   * cleared field is a real CLEAR (update-like) or merely an unfilled input (create-like) — a\n   * question the raw operation identifier cannot answer for custom operations or UPDATE_MANY.\n   */\n  coreOperation?: CoreResourceOperation;\n\n  // =========== LAYOUT REFS ===========\n\n  /**\n   * Structural ref manifest from `layout.refs`. Provides the list of\n   * section, wizard step, and group names for i18n label resolution.\n   */\n  layoutRefs?: LayoutRefManifest;\n\n  /** File upload context for resource-integrated file fields */\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n\n  /**\n   * Context-provided field values that should be hidden from the form but auto-populated on submit.\n   * Key: field name, Value: value to inject on submit.\n   * These fields are automatically excluded from rendering and merged into form data on submission.\n   */\n  contextFieldValues?: Record<string, unknown>;\n\n  /**\n   * Additional field names hidden by an upstream preparation layer before the\n   * generated form tree reaches `FormField`.\n   *\n   * `AutomatedForm` treats this as an opaque infrastructure input and only\n   * applies generic submit/draft pruning. Resource-aware derivation (for\n   * example relationship-backed DTO slots) belongs in `ResourceAutomatedForm`\n   * or another wrapper that understands the caller's domain semantics.\n   */\n  hiddenFieldNames?: string[];\n\n  /**\n   * Generated-form replacements keyed by top-level field name.\n   *\n   * Like `hiddenFieldNames`, this is an upstream resolved input. The generic\n   * form infrastructure mounts the overrides but does not decide when a\n   * resource-specific replacement should exist.\n   */\n  generatedFieldOverrides?: Record<string, React.ReactNode>;\n  inheritanceConfig?: InheritanceSchemaDefinition;\n\n  /**\n   * Default chrome mode for all fields in the form (lowest priority in cascade).\n   * Overridden by section-level chromeMode and field-level decorator chromeMode.\n   * Supports responsive per-breakpoint mapping.\n   */\n  chromeMode?: ResponsiveChromeMode;\n\n  /**\n   * Callback for saving individual sections (partial updates).\n   * Called when a saveable section's save button is clicked and validation passes.\n   */\n  onSectionSave?: (\n    sectionRef: string,\n    fieldNames: string[],\n    data: Record<string, unknown>\n  ) => void | Promise<void>;\n\n  /**\n   * Callback invoked with form methods when the form is ready.\n   * Use this to get access to setError/clearErrors for setting server-side validation errors.\n   */\n  onFormReady?: (formMethods: FormMethods) => void;\n\n  /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */\n  validateFieldUrl?: string;\n  /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */\n  resourceId?: string;\n  /** Resource context identifiers for FK context propagation to nested field components */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship field mutations */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n\n  /**\n   * Layout template component rendered inside the form infrastructure wrappers.\n   * The template is a `React.ComponentType` with access to `useFormTemplateContext()`\n   * for resolved labels, schema, and operation context.\n   *\n   * All skeleton components (`<FormLayout>`, `<Section>`, `<FormField>`, `<WizardLayout>`,\n   * `<WizardStep>`, `<DiscriminatorSwitch>`, etc.) are available inside the template.\n   *\n   * When not provided by callers, `ResourceAutomatedForm` generates one via\n   * `generateDefaultFormTemplate()` based on the schema and config.\n   */\n  layoutTemplate: React.ComponentType;\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction AutomatedFormComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  defaultValues,\n  onSubmit,\n  onError,\n  validationMode,\n  className,\n  disabled,\n  readOnly,\n  id,\n  warnOnUnsavedChanges = false,\n  labels,\n  operationRef,\n  operationType,\n  operationLike,\n  coreOperation,\n  layoutRefs,\n  fileUploadContext,\n  contextFieldValues,\n  hiddenFieldNames,\n  generatedFieldOverrides,\n  inheritanceConfig,\n  chromeMode,\n  onSectionSave,\n  onFormReady,\n  validateFieldUrl,\n  resourceId,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  layoutTemplate: LayoutTemplate,\n}: AutomatedFormProps<TSchema>): React.JSX.Element | null {\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  // Resolve labels via i18n using the shared hook\n  const {\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels: sectionLegends,\n    sectionDescriptions,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    groupLabels,\n    isReady: areResourceLabelsReady,\n  } = useResourceLabels(\n    schema,\n    labels?.resourceContext,\n    defaultValues as Record<string, unknown> | undefined,\n    'edit',\n    {\n      layoutRefs,\n      overrides: {\n        fields: labels?.fields,\n        enums: labels?.enums,\n        sections: labels?.sections,\n        wizardSteps: labels?.wizardSteps,\n      },\n    },\n  );\n\n  // Merge context-provided values into defaultValues so they exist in RHF state.\n  // Context fields (e.g., organizationId) are hidden from the form but their values\n  // need to be present during validation — cross-field .refine() / .superRefine()\n  // refinements may reference context fields.\n  const effectiveDefaultValues = useMemo(() => {\n    if (!contextFieldValues || Object.keys(contextFieldValues).length === 0) {\n      return defaultValues;\n    }\n    return {\n      ...defaultValues,\n      ...contextFieldValues,\n    } as DefaultValues<z.infer<TSchema>>;\n  }, [defaultValues, contextFieldValues]);\n\n  // Generic payload boundary: prune upstream-hidden fields and inject\n  // authoritative context-owned values. This layer intentionally does not\n  // derive resource semantics on its own.\n  // Variant/showWhen filtering is handled automatically by shouldUnregister:true\n  // on FormField — unmounted fields are absent from RHF state at submit time.\n  // A cleared field is `null` in form state on every operation, because that is the only cleared\n  // value react-hook-form accepts. It only means \"clear the stored value\" on an update-like\n  // operation; on a CREATE there is no stored value, so the key is dropped and absence carries the\n  // same meaning.\n  //\n  // The decision MUST come from the resolved CORE operation, not from a string comparison against\n  // `'update'`. `operationType` here is the raw operation IDENTIFIER — an arbitrary string for any\n  // custom operation — so comparing it to `'update'` classified `UPDATE_MANY` and every custom\n  // update-like operation that does not declare `resourceOperationLike` as a CREATE, and silently\n  // STRIPPED the user's clear before it left the form. That is precisely the case\n  // `omitClearedFieldKeys` documents as forbidden.\n  //\n  // `coreOperation` is supplied by the resource-aware wrapper, which already resolves it. The\n  // string fallback only applies to a bare `AutomatedForm` mounted with no resource semantics,\n  // where an unresolved operation is treated as CREATE-like — the conservative direction for a\n  // surface that has no stored row to clear.\n  const omitClearedFields = shouldOmitClearedFieldsForOperation(coreOperation, operationLike || operationType);\n\n  const wrappedOnSubmit = useMemo(() => {\n    return (data: z.infer<TSchema>) => {\n      const processedData = sanitizeAutomatedFormSubmissionData(\n        data as Record<string, unknown>,\n        {\n          hiddenFieldNames,\n          contextFieldValues,\n          omitClearedFields,\n          schema,\n        },\n      );\n      return onSubmit(processedData as z.infer<TSchema>);\n    };\n  }, [onSubmit, contextFieldValues, hiddenFieldNames, omitClearedFields]);\n\n  // Apply the same payload-boundary guarantees to section saves so explicit\n  // templates do not accidentally leak wrapper-hidden or context-owned fields.\n  const wrappedOnSectionSave = useMemo(() => {\n    if (!onSectionSave) {\n      return undefined;\n    }\n\n    return (\n      sectionRef: string,\n      fieldNames: string[],\n      data: Record<string, unknown>,\n    ) => {\n      const sectionScopedData = fieldNames.length > 0\n        ? pickSubmissionDataPaths(data, fieldNames)\n        : data;\n      const processedData = sanitizeAutomatedFormSubmissionData(sectionScopedData, {\n        hiddenFieldNames,\n        contextFieldValues,\n        omitClearedFields,\n        schema,\n      });\n\n      return onSectionSave(sectionRef, fieldNames, processedData);\n    };\n  }, [onSectionSave, contextFieldValues, hiddenFieldNames, omitClearedFields]);\n\n  // Form template context — carries all resolved values so skeleton components\n  // (FormField, Section, WizardLayout, etc.) can read from context.\n  const formTemplateContextValue: FormTemplateContextValue = useMemo(() => ({\n    schema,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels: sectionLegends,\n    sectionDescriptions,\n    groupLabels,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    readOnly,\n    disabled,\n    fileUploadContext,\n    contextFieldValues,\n    hiddenFieldNames,\n    generatedFieldOverrides,\n    onSectionSave: wrappedOnSectionSave,\n    operationType: operationLike || operationType,\n    operationRef,\n    isExisting: (operationLike || operationType) === 'update',\n    inheritanceConfig,\n  }), [\n    schema,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLegends,\n    sectionDescriptions,\n    groupLabels,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    readOnly,\n    disabled,\n    fileUploadContext,\n    contextFieldValues,\n    hiddenFieldNames,\n    generatedFieldOverrides,\n    inheritanceConfig,\n    wrappedOnSectionSave,\n    operationLike,\n    operationType,\n    operationRef,\n  ]);\n\n  // While the form-message bundle resolves, render a schema-shaped skeleton that\n  // RESERVES the form's layout (one label + control row per visible field) rather\n  // than `return null`, which would collapse to zero height and then reflow the\n  // page when the real form mounts. The real form swaps in IN PLACE — no jump.\n  // (Field-label and validation bundles are already requested above via\n  // `useResourceLabels` / `useI18n`, so they load in parallel with this wait.)\n  // Row count comes from the resolved field map — no schema introspection.\n  // Gate on BOTH bundles — the form messages (`isReady`) AND the resource labels\n  // (`areResourceLabelsReady`). This changed on 2026-09-08 with #420, and both\n  // reasons the old comment gave for excluding the second are now gone:\n  //\n  //   - it said `useResourceLabels` \"always returns usable field-name fallbacks\".\n  //     It no longer does. #420 removed the humanizer, so an unresolved field\n  //     renders its KEY (`emailAddress`). Showing that and swapping it for\n  //     \"Email address\" a moment later is the flash of raw keys the humanizer had\n  //     been kept to avoid — so the gate is now what makes the removal safe.\n  //   - it said gating risked \"a never-resolving skeleton if a resource bundle\n  //     never loads\". That was true and is the precondition #420 had to fix\n  //     first: readiness now settles on a FAILED bundle as well as a loaded one\n  //     (`I18nContext.isKeySettled`), so a failed fetch opens the gate and the\n  //     unresolved keys render — visible, and visibly unlabelled.\n  if (!isReady || !areResourceLabelsReady) {\n    const skeletonRowCount = Math.min(Math.max(Object.keys(fieldLabels ?? {}).length, 1), 8);\n    return (\n      <div className={cn('space-y-section', className)} role=\"status\" aria-busy=\"true\" aria-live=\"polite\">\n        {Array.from({ length: skeletonRowCount }).map((_, i) => (\n          <div key={i} className=\"space-y-element\">\n            <Skeleton className=\"h-4 w-28\" />\n            <Skeleton className=\"h-9 w-full\" />\n          </div>\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <Form\n      schema={schema}\n      defaultValues={effectiveDefaultValues}\n      onSubmit={wrappedOnSubmit}\n      onError={onError}\n      validationMode={validationMode}\n      // No spacing utility here: `Form` renders all children inside one\n      // `display: contents` fieldset, so `space-y-*` on the form element is\n      // structurally inert (a `space-y-section` sat here dead until\n      // 2026-08-19). Row spacing is owned by the layout template/containers;\n      // the resource actions footer owns its own `mt-section` seam.\n      className={className}\n      disabled={disabled}\n      id={id}\n      onFormReady={onFormReady}\n      warnOnUnsavedChanges={warnOnUnsavedChanges}\n      validateFieldUrl={validateFieldUrl}\n      resourceId={resourceId}\n      operationType={operationLike || operationType}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      parentResourcesRequirements={parentResourcesRequirements}\n      navigationZone={navigationZone}\n    >\n      <FormTemplateProvider value={formTemplateContextValue}>\n        <FormChromeProvider formChromeMode={chromeMode}>\n          <LayoutTemplate />\n        </FormChromeProvider>\n      </FormTemplateProvider>\n    </Form>\n  );\n}\n\nAutomatedFormComponent.displayName = 'AutomatedForm';\n\nexport const AutomatedForm = AutomatedFormComponent;\n"]}
+{"version":3,"file":"AutomatedForm.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutomatedForm.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;AAEH,OAAc,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAIxE,OAAO,EAGL,qBAAqB,GACtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAEhE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAoB,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAA0D,MAAM,uBAAuB,CAAC;AAGrH,OAAO,EAAE,uBAAuB,EAAE,mCAAmC,EAAE,mCAAmC,EAAE,MAAM,+BAA+B,CAAC;AAClJ,OAAO,EAEL,gCAAgC,EAChC,wBAAwB,GAIzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAOhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AAwKzF,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,SAAS,sBAAsB,CAA+B,EAC5D,MAAM,EACN,aAAa,EACb,QAAQ,EACR,OAAO,EACP,cAAc,EACd,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,EAAE,EACF,oBAAoB,GAAG,KAAK,EAC5B,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,cAAc,EAAE,cAAc,GACF;IAC5B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACtC,SAAS,EAAE,qBAAqB,CAAC,sBAAsB;KACxD,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,EACJ,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,aAAa,EAAE,cAAc,EAC7B,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,OAAO,EAAE,sBAAsB,GAChC,GAAG,iBAAiB,CACnB,MAAM,EACN,MAAM,EAAE,eAAe,EACvB,aAAoD,EACpD,MAAM,EACN;QACE,UAAU;QACV,SAAS,EAAE;YACT,MAAM,EAAE,MAAM,EAAE,MAAM;YACtB,YAAY,EAAE,MAAM,EAAE,YAAY;YAClC,KAAK,EAAE,MAAM,EAAE,KAAK;YACpB,QAAQ,EAAE,MAAM,EAAE,QAAQ;YAC1B,WAAW,EAAE,MAAM,EAAE,WAAW;SACjC;KACF,CACF,CAAC;IAEF,+EAA+E;IAC/E,kFAAkF;IAClF,gFAAgF;IAChF,4CAA4C;IAC5C,MAAM,sBAAsB,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1C,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxE,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,OAAO;YACL,GAAG,aAAa;YAChB,GAAG,kBAAkB;SACa,CAAC;IACvC,CAAC,EAAE,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAExC,oEAAoE;IACpE,wEAAwE;IACxE,wCAAwC;IACxC,+EAA+E;IAC/E,4EAA4E;IAC5E,+FAA+F;IAC/F,0FAA0F;IAC1F,iGAAiG;IACjG,gBAAgB;IAChB,EAAE;IACF,gGAAgG;IAChG,iGAAiG;IACjG,6FAA6F;IAC7F,gGAAgG;IAChG,gFAAgF;IAChF,iDAAiD;IACjD,EAAE;IACF,4FAA4F;IAC5F,6FAA6F;IAC7F,6FAA6F;IAC7F,2CAA2C;IAC3C,MAAM,iBAAiB,GAAG,mCAAmC,CAAC,aAAa,EAAE,aAAa,IAAI,aAAa,CAAC,CAAC;IAE7G;;;;;;OAMG;IACH,MAAM,SAAS,GAAG,UAAU,CAAC,kBAAkB,CAAC,EAAE,SAAyD,CAAC;IAC5G,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,GAAG,EAA6B,CAAC,CAAC;IACvE,MAAM,uBAAuB,GAAG,WAAW,CAAC,CAAC,SAAiB,EAAE,KAAwB,EAAE,EAAE;QAC1F,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,kBAAkB,GAAG,WAAW,CAAC,CAAC,IAA6B,EAA2B,EAAE;QAChG,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,EAAE;YAChG,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,OAAO,CAAC,KAAK,EAAE,QAAQ,IAAI,wBAAwB,CAAC,WAAW,EAAE;oBAC/D,SAAS,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;iBAChF,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,CAAC,CAAC;QACJ,OAAO,gCAAgC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,SAAS,CAAC,CAAC,CAAC;IAE7D,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;QACnC,OAAO,CAAC,IAAsB,EAAE,EAAE;YAChC,MAAM,aAAa,GAAG,mCAAmC,CACvD,kBAAkB,CAAC,IAA+B,CAAC,EACnD;gBACE,gBAAgB;gBAChB,kBAAkB;gBAClB,iBAAiB;gBACjB,MAAM;aACP,CACF,CAAC;YACF,OAAO,QAAQ,CAAC,aAAiC,CAAC,CAAC;QACrD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAE5F,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAAE;QACxC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,CACL,UAAkB,EAClB,UAAoB,EACpB,IAA6B,EAC7B,EAAE;YACF,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC7C,CAAC,CAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC;gBAC3C,CAAC,CAAC,IAAI,CAAC;YACT,MAAM,aAAa,GAAG,mCAAmC,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE;gBAC/F,gBAAgB;gBAChB,kBAAkB;gBAClB,iBAAiB;gBACjB,MAAM;aACP,CAAC,CAAC;YAEH,OAAO,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QAC9D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEjG,6EAA6E;IAC7E,kEAAkE;IAClE,MAAM,wBAAwB,GAA6B,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,MAAM;QACN,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,UAAU;QACV,aAAa,EAAE,cAAc;QAC7B,mBAAmB;QACnB,WAAW;QACX,gBAAgB;QAChB,sBAAsB;QACtB,QAAQ;QACR,QAAQ;QACR,iBAAiB;QACjB,kBAAkB;QAClB,gBAAgB;QAChB,uBAAuB;QACvB,oBAAoB;QACpB,kBAAkB;QAClB,uBAAuB;QACvB,uBAAuB;QACvB,aAAa,EAAE,oBAAoB;QACnC,aAAa,EAAE,aAAa,IAAI,aAAa;QAC7C,YAAY;QACZ,UAAU,EAAE,CAAC,aAAa,IAAI,aAAa,CAAC,KAAK,QAAQ;QACzD,iBAAiB;KAClB,CAAC,EAAE;QACF,MAAM;QACN,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,UAAU;QACV,cAAc;QACd,mBAAmB;QACnB,WAAW;QACX,gBAAgB;QAChB,sBAAsB;QACtB,QAAQ;QACR,QAAQ;QACR,iBAAiB;QACjB,kBAAkB;QAClB,gBAAgB;QAChB,uBAAuB;QACvB,oBAAoB;QACpB,kBAAkB;QAClB,uBAAuB;QACvB,uBAAuB;QACvB,iBAAiB;QACjB,oBAAoB;QACpB,aAAa;QACb,aAAa;QACb,YAAY;KACb,CAAC,CAAC;IAEH,+EAA+E;IAC/E,gFAAgF;IAChF,8EAA8E;IAC9E,6EAA6E;IAC7E,sEAAsE;IACtE,6EAA6E;IAC7E,yEAAyE;IACzE,+EAA+E;IAC/E,6EAA6E;IAC7E,sEAAsE;IACtE,EAAE;IACF,gFAAgF;IAChF,4EAA4E;IAC5E,yEAAyE;IACzE,gFAAgF;IAChF,2EAA2E;IAC3E,6EAA6E;IAC7E,0EAA0E;IAC1E,8EAA8E;IAC9E,6EAA6E;IAC7E,gEAAgE;IAChE,IAAI,CAAC,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACxC,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzF,OAAO,CACL,cAAK,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAC,QAAQ,eAAW,MAAM,eAAW,QAAQ,YAChG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CACtD,eAAa,SAAS,EAAC,iBAAiB,aACtC,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,EACjC,KAAC,QAAQ,IAAC,SAAS,EAAC,YAAY,GAAG,KAF3B,CAAC,CAGL,CACP,CAAC,GACE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,IAAI,IACH,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,sBAAsB,EACrC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,cAAc;QAC9B,kEAAkE;QAClE,sEAAsE;QACtE,8DAA8D;QAC9D,uEAAuE;QACvE,8DAA8D;QAC9D,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,EAAE,EAAE,EAAE,EACN,WAAW,EAAE,WAAW,EACxB,oBAAoB,EAAE,oBAAoB,EAC1C,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,IAAI,aAAa,EAC7C,0BAA0B,EAAE,0BAA0B,EACtD,2BAA2B,EAAE,2BAA2B,EACxD,cAAc,EAAE,cAAc,YAE9B,KAAC,oBAAoB,IAAC,KAAK,EAAE,wBAAwB,YACnD,KAAC,kBAAkB,IAAC,cAAc,EAAE,UAAU,YAC5C,KAAC,cAAc,KAAG,GACC,GACA,GAClB,CACR,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC,WAAW,GAAG,eAAe,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC","sourcesContent":["/**\n * AutomatedForm Component\n *\n * Schema-driven form that renders a mandatory layout template inside infrastructure\n * wrappers (RHF FormProvider, FormTemplateContext, FormChromeProvider).\n *\n * The template controls field order, section structure, wizard steps, and grid layout.\n * All infrastructure (validation, submission, unsaved-changes guard) stays outside.\n *\n * `layoutTemplate` is required — callers must either provide an explicit template\n * or use `generateDefaultFormTemplate()` to produce one from the schema and config.\n */\n\nimport React, { useCallback, useContext, useMemo, useRef } from 'react';\nimport { z } from 'zod';\nimport type { FieldErrors, DefaultValues } from 'react-hook-form';\n\nimport {\n  type AutomatedFormLabels,\n  type ResponsiveChromeMode,\n  FrontendComponentType,\n} from '@wildo-ai/presets-components-models';\nimport { FormChromeProvider } from '../chromes/FormChromeContext';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { Form, type FormMethods } from '~wildo-frontend-lib/components/form/Form';\nimport { FormTemplateProvider, type AllowedFieldValues, type FormTemplateContextValue } from './FormTemplateContext';\nimport type { ValidationMode } from '../form-field-types';\nimport type { FileFieldEndpoints } from '@wildo-ai/zod-decorators';\nimport { pickSubmissionDataPaths, sanitizeAutomatedFormSubmissionData, shouldOmitClearedFieldsForOperation } from './automated-form-submit.utils';\nimport {\n  CoreResourceOperation,\n  applyRequestFieldOffersToRequest,\n  resolveRequestFieldOffer,\n  type AppConfiguration_Shared,\n  type RequestFieldOffer,\n  type RequestFieldOffers,\n} from '@wildo-ai/saas-models';\nimport { ApplicationContext } from '~wildo-frontend-lib/core/runtime/ApplicationContext.shared';\n\nimport type {\n  FormOperationType,\n  InheritanceSchemaDefinition,\n} from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.schemas';\nimport type { LayoutRefManifest } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n// =============================================================================\n// PROPS\n// =============================================================================\n\nexport interface AutomatedFormProps<TSchema extends z.ZodTypeAny> {\n  schema: TSchema;\n  defaultValues?: DefaultValues<z.infer<TSchema>>;\n  onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;\n  onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;\n  validationMode?: ValidationMode;\n  className?: string;\n  disabled?: boolean;\n  /**\n   * Makes all form fields read-only (values are submitted but not editable).\n   * Individual fields can also be made read-only via the isNotEditable() schema decorator.\n   * Unlike disabled, read-only field values are included in submission.\n   */\n  readOnly?: boolean;\n  id?: string;\n\n  /**\n   * When true, shows a browser confirmation dialog when the user tries to leave\n   * the page (tab close, refresh, back button) while the form has unsaved changes.\n   * Uses the browser's native `beforeunload` event.\n   * @default false\n   */\n  warnOnUnsavedChanges?: boolean;\n\n  /**\n   * Unified labels interface for all form text.\n   * Supports explicit overrides and i18n resolution via resourceContext.\n   */\n  labels?: AutomatedFormLabels;\n\n  /**\n   * Specific operation identifier for operation-level field visibility rules.\n   * Used with isHidden({ operations: ['ARCHIVE'] }) decorator to control\n   * which fields appear for specific operations (beyond just create/update type).\n   */\n  operationRef?: string;\n\n  /**\n   * Operation type for decorator-based field filtering.\n   * Controls excludeFromCreate, excludeFromUpdate, and isHidden(operations) behavior.\n   */\n  operationType?: FormOperationType;\n\n  /**\n   * Operation-like type for custom operations that behave like core operations.\n   * When specified, takes precedence over operationType for excludeFromCreate/excludeFromUpdate checks.\n   */\n  operationLike?: FormOperationType;\n  /**\n   * The RESOLVED core operation this form performs. Supplied by the resource-aware wrapper, which\n   * already resolves custom operations through `resourceOperationLike`. It decides whether a\n   * cleared field is a real CLEAR (update-like) or merely an unfilled input (create-like) — a\n   * question the raw operation identifier cannot answer for custom operations or UPDATE_MANY.\n   */\n  coreOperation?: CoreResourceOperation;\n\n  // =========== LAYOUT REFS ===========\n\n  /**\n   * Structural ref manifest from `layout.refs`. Provides the list of\n   * section, wizard step, and group names for i18n label resolution.\n   */\n  layoutRefs?: LayoutRefManifest;\n\n  /** File upload context for resource-integrated file fields */\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n\n  /**\n   * Context-provided field values that should be hidden from the form but auto-populated on submit.\n   * Key: field name, Value: value to inject on submit.\n   * These fields are automatically excluded from rendering and merged into form data on submission.\n   */\n  contextFieldValues?: Record<string, unknown>;\n\n  /**\n   * Additional field names hidden by an upstream preparation layer before the\n   * generated form tree reaches `FormField`.\n   *\n   * `AutomatedForm` treats this as an opaque infrastructure input and only\n   * applies generic submit/draft pruning. Resource-aware derivation (for\n   * example relationship-backed DTO slots) belongs in `ResourceAutomatedForm`\n   * or another wrapper that understands the caller's domain semantics.\n   */\n  hiddenFieldNames?: string[];\n\n  /**\n   * Generated-form replacements keyed by top-level field name.\n   *\n   * Like `hiddenFieldNames`, this is an upstream resolved input. The generic\n   * form infrastructure mounts the overrides but does not decide when a\n   * resource-specific replacement should exist.\n   */\n  generatedFieldOverrides?: Record<string, React.ReactNode>;\n  /**\n   * A runtime vocabulary for a GENERATED field, keyed by field name: the values it may take and, optionally, their words.\n   * A generated field receives it exactly as a template field receives `allowedValues` and `enumLabels`, so the field\n   * becomes a choice among those values. Like `hiddenFieldNames`, an upstream resolved input: which field is narrowed,\n   * and why, is decided by a domain-aware wrapper (a read-through resource's organization unit, #2943), never here.\n   */\n  allowedValuesByField?: Readonly<Record<string, AllowedFieldValues>>;\n  /**\n   * What the operation's form offers in each request field (#2744), from the operation's `requestFieldOffers`.\n   * `FormField` evaluates its own field's declaration against `requestFieldOfferRecord`, the values the declaration\n   * reads and the application's configuration: an enum field shows only the offered values, and a field not offered is\n   * left out of the form and of the request.\n   */\n  requestFieldOffers?: RequestFieldOffers;\n\n  /** The row the operation acts on, which a request field offer reads (`currentObject`). Absent for a create. */\n  requestFieldOfferRecord?: Readonly<Record<string, unknown>>;\n  inheritanceConfig?: InheritanceSchemaDefinition;\n\n  /**\n   * Default chrome mode for all fields in the form (lowest priority in cascade).\n   * Overridden by section-level chromeMode and field-level decorator chromeMode.\n   * Supports responsive per-breakpoint mapping.\n   */\n  chromeMode?: ResponsiveChromeMode;\n\n  /**\n   * Callback for saving individual sections (partial updates).\n   * Called when a saveable section's save button is clicked and validation passes.\n   */\n  onSectionSave?: (\n    sectionRef: string,\n    fieldNames: string[],\n    data: Record<string, unknown>\n  ) => void | Promise<void>;\n\n  /**\n   * Callback invoked with form methods when the form is ready.\n   * Use this to get access to setError/clearErrors for setting server-side validation errors.\n   */\n  onFormReady?: (formMethods: FormMethods) => void;\n\n  /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */\n  validateFieldUrl?: string;\n  /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */\n  resourceId?: string;\n  /** Resource context identifiers for FK context propagation to nested field components */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship field mutations */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n\n  /**\n   * Layout template component rendered inside the form infrastructure wrappers.\n   * The template is a `React.ComponentType` with access to `useFormTemplateContext()`\n   * for resolved labels, schema, and operation context.\n   *\n   * All skeleton components (`<FormLayout>`, `<Section>`, `<FormField>`, `<WizardLayout>`,\n   * `<WizardStep>`, `<DiscriminatorSwitch>`, etc.) are available inside the template.\n   *\n   * When not provided by callers, `ResourceAutomatedForm` generates one via\n   * `generateDefaultFormTemplate()` based on the schema and config.\n   */\n  layoutTemplate: React.ComponentType;\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction AutomatedFormComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  defaultValues,\n  onSubmit,\n  onError,\n  validationMode,\n  className,\n  disabled,\n  readOnly,\n  id,\n  warnOnUnsavedChanges = false,\n  labels,\n  operationRef,\n  operationType,\n  operationLike,\n  coreOperation,\n  layoutRefs,\n  fileUploadContext,\n  contextFieldValues,\n  hiddenFieldNames,\n  generatedFieldOverrides,\n  allowedValuesByField,\n  requestFieldOffers,\n  requestFieldOfferRecord,\n  inheritanceConfig,\n  chromeMode,\n  onSectionSave,\n  onFormReady,\n  validateFieldUrl,\n  resourceId,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  layoutTemplate: LayoutTemplate,\n}: AutomatedFormProps<TSchema>): React.JSX.Element | null {\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  // Resolve labels via i18n using the shared hook\n  const {\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels: sectionLegends,\n    sectionDescriptions,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    groupLabels,\n    isReady: areResourceLabelsReady,\n  } = useResourceLabels(\n    schema,\n    labels?.resourceContext,\n    defaultValues as Record<string, unknown> | undefined,\n    'edit',\n    {\n      layoutRefs,\n      overrides: {\n        fields: labels?.fields,\n        descriptions: labels?.descriptions,\n        enums: labels?.enums,\n        sections: labels?.sections,\n        wizardSteps: labels?.wizardSteps,\n      },\n    },\n  );\n\n  // Merge context-provided values into defaultValues so they exist in RHF state.\n  // Context fields (e.g., organizationId) are hidden from the form but their values\n  // need to be present during validation — cross-field .refine() / .superRefine()\n  // refinements may reference context fields.\n  const effectiveDefaultValues = useMemo(() => {\n    if (!contextFieldValues || Object.keys(contextFieldValues).length === 0) {\n      return defaultValues;\n    }\n    return {\n      ...defaultValues,\n      ...contextFieldValues,\n    } as DefaultValues<z.infer<TSchema>>;\n  }, [defaultValues, contextFieldValues]);\n\n  // Generic payload boundary: prune upstream-hidden fields and inject\n  // authoritative context-owned values. This layer intentionally does not\n  // derive resource semantics on its own.\n  // Variant/showWhen filtering is handled automatically by shouldUnregister:true\n  // on FormField — unmounted fields are absent from RHF state at submit time.\n  // A cleared field is `null` in form state on every operation, because that is the only cleared\n  // value react-hook-form accepts. It only means \"clear the stored value\" on an update-like\n  // operation; on a CREATE there is no stored value, so the key is dropped and absence carries the\n  // same meaning.\n  //\n  // The decision MUST come from the resolved CORE operation, not from a string comparison against\n  // `'update'`. `operationType` here is the raw operation IDENTIFIER — an arbitrary string for any\n  // custom operation — so comparing it to `'update'` classified `UPDATE_MANY` and every custom\n  // update-like operation that does not declare `resourceOperationLike` as a CREATE, and silently\n  // STRIPPED the user's clear before it left the form. That is precisely the case\n  // `omitClearedFieldKeys` documents as forbidden.\n  //\n  // `coreOperation` is supplied by the resource-aware wrapper, which already resolves it. The\n  // string fallback only applies to a bare `AutomatedForm` mounted with no resource semantics,\n  // where an unresolved operation is treated as CREATE-like — the conservative direction for a\n  // surface that has no stored row to clear.\n  const omitClearedFields = shouldOmitClearedFieldsForOperation(coreOperation, operationLike || operationType);\n\n  /*\n   * #2744 review F1, F2: what the operation does not offer leaves EVERY submission, at this boundary. Hiding a field is not\n   * enough: a field array keeps its value when hidden, and an operation on a record starts from the whole row, so a field\n   * never shown is still held. An offer is judged HERE from the submitted values and the row (review N2: a report from a\n   * field that has since unmounted may be stale), except one that reads a referenced row, which only a mounted field can\n   * read: that one takes the offer the field last reported.\n   */\n  const appConfig = useContext(ApplicationContext)?.appConfig as Partial<AppConfiguration_Shared> | undefined;\n  const reportedOffersRef = useRef(new Map<string, RequestFieldOffer>());\n  const reportRequestFieldOffer = useCallback((fieldName: string, offer: RequestFieldOffer) => {\n    reportedOffersRef.current.set(fieldName, offer);\n  }, []);\n  const admitOfferedFields = useCallback((data: Record<string, unknown>): Record<string, unknown> => {\n    if (!requestFieldOffers) return data;\n    const offers = Object.fromEntries(Object.entries(requestFieldOffers).map(([field, declaration]) => {\n      const reported = declaration.readsReferences ? reportedOffersRef.current.get(field) : undefined;\n      return [field, reported ?? resolveRequestFieldOffer(declaration, {\n        appConfig, currentObject: requestFieldOfferRecord, values: data, references: {},\n      })];\n    }));\n    return applyRequestFieldOffersToRequest(data, offers);\n  }, [requestFieldOffers, requestFieldOfferRecord, appConfig]);\n\n  const wrappedOnSubmit = useMemo(() => {\n    return (data: z.infer<TSchema>) => {\n      const processedData = sanitizeAutomatedFormSubmissionData(\n        admitOfferedFields(data as Record<string, unknown>),\n        {\n          hiddenFieldNames,\n          contextFieldValues,\n          omitClearedFields,\n          schema,\n        },\n      );\n      return onSubmit(processedData as z.infer<TSchema>);\n    };\n  }, [onSubmit, contextFieldValues, hiddenFieldNames, omitClearedFields, admitOfferedFields]);\n\n  // Apply the same payload-boundary guarantees to section saves so explicit\n  // templates do not accidentally leak wrapper-hidden or context-owned fields.\n  const wrappedOnSectionSave = useMemo(() => {\n    if (!onSectionSave) {\n      return undefined;\n    }\n\n    return (\n      sectionRef: string,\n      fieldNames: string[],\n      data: Record<string, unknown>,\n    ) => {\n      const sectionScopedData = fieldNames.length > 0\n        ? pickSubmissionDataPaths(data, fieldNames)\n        : data;\n      const processedData = sanitizeAutomatedFormSubmissionData(admitOfferedFields(sectionScopedData), {\n        hiddenFieldNames,\n        contextFieldValues,\n        omitClearedFields,\n        schema,\n      });\n\n      return onSectionSave(sectionRef, fieldNames, processedData);\n    };\n  }, [onSectionSave, contextFieldValues, hiddenFieldNames, omitClearedFields, admitOfferedFields]);\n\n  // Form template context — carries all resolved values so skeleton components\n  // (FormField, Section, WizardLayout, etc.) can read from context.\n  const formTemplateContextValue: FormTemplateContextValue = useMemo(() => ({\n    schema,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLabels: sectionLegends,\n    sectionDescriptions,\n    groupLabels,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    readOnly,\n    disabled,\n    fileUploadContext,\n    contextFieldValues,\n    hiddenFieldNames,\n    generatedFieldOverrides,\n    allowedValuesByField,\n    requestFieldOffers,\n    requestFieldOfferRecord,\n    reportRequestFieldOffer,\n    onSectionSave: wrappedOnSectionSave,\n    operationType: operationLike || operationType,\n    operationRef,\n    isExisting: (operationLike || operationType) === 'update',\n    inheritanceConfig,\n  }), [\n    schema,\n    fieldLabels,\n    fieldDescriptions,\n    fieldTooltips,\n    enumLabels,\n    sectionLegends,\n    sectionDescriptions,\n    groupLabels,\n    wizardStepLabels,\n    wizardStepDescriptions,\n    readOnly,\n    disabled,\n    fileUploadContext,\n    contextFieldValues,\n    hiddenFieldNames,\n    generatedFieldOverrides,\n    allowedValuesByField,\n    requestFieldOffers,\n    requestFieldOfferRecord,\n    reportRequestFieldOffer,\n    inheritanceConfig,\n    wrappedOnSectionSave,\n    operationLike,\n    operationType,\n    operationRef,\n  ]);\n\n  // While the form-message bundle resolves, render a schema-shaped skeleton that\n  // RESERVES the form's layout (one label + control row per visible field) rather\n  // than `return null`, which would collapse to zero height and then reflow the\n  // page when the real form mounts. The real form swaps in IN PLACE — no jump.\n  // (Field-label and validation bundles are already requested above via\n  // `useResourceLabels` / `useI18n`, so they load in parallel with this wait.)\n  // Row count comes from the resolved field map — no schema introspection.\n  // Gate on BOTH bundles — the form messages (`isReady`) AND the resource labels\n  // (`areResourceLabelsReady`). This changed on 2026-09-08 with #420, and both\n  // reasons the old comment gave for excluding the second are now gone:\n  //\n  //   - it said `useResourceLabels` \"always returns usable field-name fallbacks\".\n  //     It no longer does. #420 removed the humanizer, so an unresolved field\n  //     renders its KEY (`emailAddress`). Showing that and swapping it for\n  //     \"Email address\" a moment later is the flash of raw keys the humanizer had\n  //     been kept to avoid — so the gate is now what makes the removal safe.\n  //   - it said gating risked \"a never-resolving skeleton if a resource bundle\n  //     never loads\". That was true and is the precondition #420 had to fix\n  //     first: readiness now settles on a FAILED bundle as well as a loaded one\n  //     (`I18nContext.isKeySettled`), so a failed fetch opens the gate and the\n  //     unresolved keys render — visible, and visibly unlabelled.\n  if (!isReady || !areResourceLabelsReady) {\n    const skeletonRowCount = Math.min(Math.max(Object.keys(fieldLabels ?? {}).length, 1), 8);\n    return (\n      <div className={cn('space-y-section', className)} role=\"status\" aria-busy=\"true\" aria-live=\"polite\">\n        {Array.from({ length: skeletonRowCount }).map((_, i) => (\n          <div key={i} className=\"space-y-element\">\n            <Skeleton className=\"h-4 w-28\" />\n            <Skeleton className=\"h-9 w-full\" />\n          </div>\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <Form\n      schema={schema}\n      defaultValues={effectiveDefaultValues}\n      onSubmit={wrappedOnSubmit}\n      onError={onError}\n      validationMode={validationMode}\n      // No spacing utility here: `Form` renders all children inside one\n      // `display: contents` fieldset, so `space-y-*` on the form element is\n      // structurally inert (a `space-y-section` sat here dead until\n      // 2026-08-19). Row spacing is owned by the layout template/containers;\n      // the resource actions footer owns its own `mt-section` seam.\n      className={className}\n      disabled={disabled}\n      id={id}\n      onFormReady={onFormReady}\n      warnOnUnsavedChanges={warnOnUnsavedChanges}\n      validateFieldUrl={validateFieldUrl}\n      resourceId={resourceId}\n      operationType={operationLike || operationType}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      parentResourcesRequirements={parentResourcesRequirements}\n      navigationZone={navigationZone}\n    >\n      <FormTemplateProvider value={formTemplateContextValue}>\n        <FormChromeProvider formChromeMode={chromeMode}>\n          <LayoutTemplate />\n        </FormChromeProvider>\n      </FormTemplateProvider>\n    </Form>\n  );\n}\n\nAutomatedFormComponent.displayName = 'AutomatedForm';\n\nexport const AutomatedForm = AutomatedFormComponent;\n"]}

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

@@ -24,7 +24,7 @@
  * ```
  */
 import React from 'react';
-import { AutosaveTrigger } from '@wildo-ai/zod-decorators';
+import { AutosaveTrigger, type AutosaveFieldParams } from '@wildo-ai/zod-decorators';
 import type { ResourceMutationManager } from '../../../core/resources/rmm/ResourceMutationManager';
 /**
  * FIX-P7-L2: Re-export AutosaveTrigger from canonical source (zod-decorators)
@@ -82,6 +82,12 @@ export interface AutosaveContextValue {
     cancelAllPending: () => void;
     /** Cancel pending save for a specific field */
     cancelFieldPending: (fieldName: string) => void;
+    /**
+     * Cancel every pending or in-flight save AT or UNDER a path (`address`, `address.city`, `steps.0.title`). A bulk form's
+     * explicit clear of a whole object, record or list calls it (#2620): a child edit still waiting in its debounce would
+     * otherwise fire after the clear and rebuild the object on every selected row, while the form shows it empty.
+     */
+    cancelPendingUnder: (path: string) => void;
     /** Clear all autosave state (on form reset) */
     clearAllState: () => void;
     /** Whether any field is currently saving */
@@ -122,4 +128,19 @@ export interface AutosaveProviderProps {
     onSaveError?: (fieldName: string, error: Error) => void;
 }
 export declare function AutosaveProvider({ children, labels, validateField, onSave, rmm, config: configProp, onSaveSuccess, onSaveError, }: AutosaveProviderProps): React.JSX.Element;
+/**
+ * Resolve autosave trigger mode from field schema or context default.
+ *
+ * The ONE answer to "does this field autosave, and when?", for every field kind: a scalar FormField, an array, a
+ * record, and the item templates inside an array (through `ArrayAutosavesContext`). Arrays and records used to call
+ * `triggerSave(…, DEBOUNCE)` without asking, so in a form whose autosave is DERIVED (only a field that declares it
+ * saves, `defaultTrigger: NONE`) every array and record field saved on each edit while every scalar beside it waited
+ * for Save.
+ *
+ * @param autosaveConfig - Autosave config from decorator (true = default, object = custom, undefined = inherit)
+ * @param contextDefaultTrigger - Default trigger from AutosaveContext
+ * @param isTextField - Whether this is a text field (affects default behavior)
+ * @returns The resolved trigger mode
+ */
+export declare function resolveFieldAutosaveTrigger(autosaveConfig: AutosaveFieldParams | true | undefined, contextDefaultTrigger?: AutosaveTrigger, isTextField?: boolean): AutosaveTrigger;
 //# sourceMappingURL=AutosaveContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AutosaveContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutosaveContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAI5G,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAW9G;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uFAAuF;AACvF,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAAG,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,WAAW,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,MAAM,EAAE,cAAc,CAAC;IACvB,0CAA0C;IAC1C,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IACnF,8DAA8D;IAC9D,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,kDAAkD;IAClD,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;IACzD,oEAAoE;IACpE,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;IAC7D,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,+CAA+C;IAC/C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;CACnB;AA+BD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,IAAI,CAEjE;AAMD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qDAAqD;IACrD,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B;;;OAGG;IACH,GAAG,CAAC,EAAE,uBAAuB,CAAC;IAC9B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,sCAAsC;IACtC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzD;AAOD,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EACN,aAAa,EACb,MAAM,EACN,GAAG,EACH,MAAM,EAAE,UAAU,EAClB,aAAa,EACb,WAAW,GACZ,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmS3C"}
+{"version":3,"file":"AutosaveContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutosaveContext.tsx"],"names":[],"mappings":"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"}

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

@@ -149,6 +149,19 @@ export function AutosaveProvider({ children, labels, validateField, onSave, rmm,
             delete pendingSaves.current[fieldName];
         }
     }, []);
+    // Cancel pending and in-flight saves at or under a path (see `cancelPendingUnder`)
+    const cancelPendingUnder = useCallback((path) => {
+        const covers = (fieldName) => fieldName === path || fieldName.startsWith(`${path}.`) || fieldName.startsWith(`${path}[`);
+        Object.keys(pendingSaves.current).filter(covers).forEach((fieldName) => cancelFieldPending(fieldName));
+        for (const [fieldName, controller] of Object.entries(inFlightControllers.current)) {
+            if (!covers(fieldName))
+                continue;
+            controller.abort();
+            delete inFlightControllers.current[fieldName];
+            // An aborted save is no longer saving: its indicator must not stay on when the field comes back.
+            setFieldState(fieldName, { state: AutosaveFieldState.IDLE });
+        }
+    }, [cancelFieldPending, setFieldState]);
     // Cancel all pending and in-flight saves
     const cancelAllPending = useCallback(() => {
         Object.keys(pendingSaves.current).forEach(fieldName => {
@@ -324,6 +337,7 @@ export function AutosaveProvider({ children, labels, validateField, onSave, rmm,
         getFieldStateInfo,
         cancelAllPending,
         cancelFieldPending,
+        cancelPendingUnder,
         clearAllState,
         isSaving,
     }), [
@@ -334,9 +348,48 @@ export function AutosaveProvider({ children, labels, validateField, onSave, rmm,
         getFieldStateInfo,
         cancelAllPending,
         cancelFieldPending,
+        cancelPendingUnder,
         clearAllState,
         isSaving,
     ]);
     return (_jsx(AutosaveContext.Provider, { value: contextValue, children: children }));
 }
+/**
+ * Resolve autosave trigger mode from field schema or context default.
+ *
+ * The ONE answer to "does this field autosave, and when?", for every field kind: a scalar FormField, an array, a
+ * record, and the item templates inside an array (through `ArrayAutosavesContext`). Arrays and records used to call
+ * `triggerSave(…, DEBOUNCE)` without asking, so in a form whose autosave is DERIVED (only a field that declares it
+ * saves, `defaultTrigger: NONE`) every array and record field saved on each edit while every scalar beside it waited
+ * for Save.
+ *
+ * @param autosaveConfig - Autosave config from decorator (true = default, object = custom, undefined = inherit)
+ * @param contextDefaultTrigger - Default trigger from AutosaveContext
+ * @param isTextField - Whether this is a text field (affects default behavior)
+ * @returns The resolved trigger mode
+ */
+export function resolveFieldAutosaveTrigger(autosaveConfig, contextDefaultTrigger = AutosaveTrigger.DEBOUNCE, isTextField = false) {
+    // No autosave config on field - use context default
+    if (autosaveConfig === undefined) {
+        return contextDefaultTrigger;
+    }
+    // True = default (use context default or debounce for text, blur for others)
+    if (autosaveConfig === true) {
+        return isTextField ? AutosaveTrigger.DEBOUNCE : AutosaveTrigger.BLUR;
+    }
+    // Object config
+    if (typeof autosaveConfig === 'object') {
+        // Check if explicitly disabled via enabled: false
+        if (autosaveConfig.enabled === false) {
+            return AutosaveTrigger.NONE;
+        }
+        // Use explicit trigger or trigger: 'none' to disable
+        if (autosaveConfig.trigger) {
+            return autosaveConfig.trigger;
+        }
+        // Default based on field type
+        return isTextField ? AutosaveTrigger.DEBOUNCE : AutosaveTrigger.BLUR;
+    }
+    return contextDefaultTrigger;
+}
 //# sourceMappingURL=AutosaveContext.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"AutosaveContext.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutosaveContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * AutosaveContext\n *\n * Provides field-level autosave functionality for forms. Handles:\n * - Per-field save state tracking (idle, saving, saved, error)\n * - Debounced saves for 'debounce' trigger mode\n * - Blur-triggered saves for 'blur' trigger mode\n * - Cancellation of pending saves on form reset/submit\n * - Concurrent save handling with AbortController\n *\n * @example\n * ```tsx\n * // In ResourceAutomatedForm with autosaveConfig\n * <AutosaveProvider\n *   onSave={handleFieldSave}\n *   config={{ enabled: true, debounceMs: 500 }}\n * >\n *   <AutomatedForm ... />\n * </AutosaveProvider>\n *\n * // In FormField\n * const { triggerSave, getFieldState } = useAutosave();\n * const saveState = getFieldState(fieldName); // 'idle' | 'saving' | 'saved' | 'error'\n * ```\n */\n\nimport React, { createContext, useContext, useCallback, useRef, useState, useMemo, useEffect } from 'react';\nimport { useFormContext } from 'react-hook-form';\n\n// Import shared autosave enum from zod-decorators (canonical source)\nimport { AutosaveTrigger } from '@wildo-ai/zod-decorators';\n\nimport { MutationPriority, MutationType, MutationErrorType, MutationCancelledError, BackpressureRejectedError, ResourceDeletedError } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AutosaveContext');\nlogger.setDebugTypeLogging('AutosaveContext', false);\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * FIX-P7-L2: Re-export AutosaveTrigger from canonical source (zod-decorators)\n * for convenience. Consumers can import from either:\n * - '@wildo-ai/zod-decorators' (canonical, schema-level usage)\n * - '@wildo-ai/saas-frontend-lib' (convenience, component-level usage)\n */\nexport { AutosaveTrigger };\n\n/**\n * State of a field's autosave operation.\n * Re-exported from form-field-types for convenience.\n */\nimport { AutosaveFieldState } from '../form-field-types';\nexport { AutosaveFieldState };\n\n/** Configuration for autosave behavior */\nexport interface AutosaveConfig {\n  /** Whether autosave is enabled globally */\n  enabled: boolean;\n  /** Default trigger mode for fields without explicit config */\n  defaultTrigger?: AutosaveTrigger;\n  /** Default debounce delay in milliseconds */\n  debounceMs?: number;\n  /** Duration to show 'saved' state before returning to 'idle' */\n  savedStateDurationMs?: number;\n}\n\n/** Per-field autosave state */\nexport interface FieldAutosaveState {\n  state: AutosaveFieldState;\n  lastError?: string;\n  lastSavedAt?: number;\n}\n\n/** Localized error messages for autosave feedback. Resolved via i18n in the parent. */\nexport interface AutosaveProviderLabels {\n  errorNetwork: string;\n  errorValidation: string;\n  errorGeneric: string;\n  errorConflict: string;\n  errorResourceDeleted: string;\n}\n\n/** Callback type for save operation */\nexport type AutosaveSaveHandler = (\n  fieldName: string,\n  value: unknown,\n  abortSignal: AbortSignal\n) => Promise<void>;\n\n/** Context value */\nexport interface AutosaveContextValue {\n  /** Global autosave configuration */\n  config: AutosaveConfig;\n  /** Trigger a save for a specific field */\n  triggerSave: (fieldName: string, value: unknown, trigger: AutosaveTrigger) => void;\n  /** Retry the last save for a specific field (if available) */\n  retryFieldSave: (fieldName: string) => void;\n  /** Get the current state of a field's autosave */\n  getFieldState: (fieldName: string) => AutosaveFieldState;\n  /** Get full state info for a field (including error, timestamps) */\n  getFieldStateInfo: (fieldName: string) => FieldAutosaveState;\n  /** Cancel all pending saves */\n  cancelAllPending: () => void;\n  /** Cancel pending save for a specific field */\n  cancelFieldPending: (fieldName: string) => void;\n  /** Clear all autosave state (on form reset) */\n  clearAllState: () => void;\n  /** Whether any field is currently saving */\n  isSaving: boolean;\n}\n\n// =============================================================================\n// DEFAULTS\n// =============================================================================\n\nconst DEFAULT_CONFIG: AutosaveConfig = {\n  enabled: false,\n  defaultTrigger: AutosaveTrigger.DEBOUNCE,\n  debounceMs: 500,\n  savedStateDurationMs: 2000,\n};\n\nconst DEFAULT_FIELD_STATE: FieldAutosaveState = {\n  state: AutosaveFieldState.IDLE,\n};\n\n// =============================================================================\n// CONTEXT\n// =============================================================================\n\nconst AutosaveContext = createContext<AutosaveContextValue | null>(null);\n\nfunction useAutosave(): AutosaveContextValue {\n  const context = useContext(AutosaveContext);\n  if (!context) {\n    throw new Error('useAutosave must be used within an AutosaveProvider');\n  }\n  return context;\n}\n\n/**\n * Hook to access autosave context.\n * Returns null if not within an AutosaveProvider (autosave disabled).\n */\nexport function useOptionalAutosave(): AutosaveContextValue | null {\n  return useContext(AutosaveContext);\n}\n\n// =============================================================================\n// PROVIDER\n// =============================================================================\n\nexport interface AutosaveProviderProps {\n  children: React.ReactNode;\n  /** Localized error messages for autosave feedback */\n  labels: AutosaveProviderLabels;\n  /**\n   * Optional validation bridge used when the autosave provider is mounted\n   * outside the RHF provider subtree but still needs to honor wrapper-level\n   * field validation before saving.\n   */\n  validateField?: (fieldName: string) => Promise<boolean>;\n  /**\n   * Handler called when a field should be saved.\n   * When provided, this takes precedence over the provider's raw `rmm` path so\n   * callers can preserve custom transport semantics (for example semantic custom\n   * update operations or bulk-hosted mutation transports).\n   */\n  onSave?: AutosaveSaveHandler;\n  /**\n   * RMM instance — when provided, executeSave delegates to rmm.queueMutation()\n   * instead of calling onSave(). cancelAllPending delegates to rmm.cancelPendingMutations().\n   */\n  rmm?: ResourceMutationManager;\n  /** Autosave configuration */\n  config?: Partial<AutosaveConfig>;\n  /** Callback when autosave succeeds */\n  onSaveSuccess?: (fieldName: string) => void;\n  /** Callback when autosave fails */\n  onSaveError?: (fieldName: string, error: Error) => void;\n}\n\ninterface PendingSave {\n  timeoutId: ReturnType<typeof setTimeout>;\n  abortController: AbortController;\n}\n\nexport function AutosaveProvider({\n  children,\n  labels,\n  validateField,\n  onSave,\n  rmm,\n  config: configProp,\n  onSaveSuccess,\n  onSaveError,\n}: AutosaveProviderProps): React.JSX.Element {\n  // Merge config with defaults\n  const config = useMemo<AutosaveConfig>(() => ({\n    ...DEFAULT_CONFIG,\n    ...configProp,\n  }), [configProp]);\n\n  // Per-field state\n  const [fieldStates, setFieldStates] = useState<Record<string, FieldAutosaveState>>({});\n\n  // Pending saves (debounce timers and abort controllers)\n  const pendingSaves = useRef<Record<string, PendingSave>>({});\n\n  // In-flight abort controllers for saves that have passed debounce / blur.\n  // Allows cancelAllPending to abort saves that are already inside executeSave.\n  const inFlightControllers = useRef<Record<string, AbortController>>({});\n\n  // Last values for retry\n  const lastSavedValues = useRef<Record<string, { value: unknown; trigger: AutosaveTrigger }>>({});\n\n  // Saved state fade timers\n  const savedTimers = useRef<Record<string, ReturnType<typeof setTimeout>>>({});\n\n  // Track if any field is currently saving\n  const isSaving = useMemo(() => {\n    return Object.values(fieldStates).some(state => state.state === AutosaveFieldState.SAVING);\n  }, [fieldStates]);\n\n  // Get RHF context for validation\n  const formContext = useFormContext();\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      Object.values(pendingSaves.current).forEach(({ timeoutId, abortController }) => {\n        clearTimeout(timeoutId);\n        abortController.abort();\n      });\n      Object.values(inFlightControllers.current).forEach(c => c.abort());\n      Object.values(savedTimers.current).forEach(timer => clearTimeout(timer));\n    };\n  }, []);\n\n  // Update field state\n  // Uses default only when creating new state, preserves existing state otherwise\n  const setFieldState = useCallback((fieldName: string, state: Partial<FieldAutosaveState>) => {\n    setFieldStates(prev => ({\n      ...prev,\n      [fieldName]: {\n        ...(prev[fieldName] ?? DEFAULT_FIELD_STATE), // Only use default if no existing state\n        ...state,\n      },\n    }));\n  }, []);\n\n  // Clear saved state timer for a field\n  const clearSavedTimer = useCallback((fieldName: string) => {\n    if (savedTimers.current[fieldName]) {\n      clearTimeout(savedTimers.current[fieldName]);\n      delete savedTimers.current[fieldName];\n    }\n  }, []);\n\n  // Set saved state with auto-fade back to idle\n  const setSavedWithFade = useCallback((fieldName: string) => {\n    clearSavedTimer(fieldName);\n    setFieldState(fieldName, { state: AutosaveFieldState.SAVED, lastSavedAt: Date.now() });\n\n    savedTimers.current[fieldName] = setTimeout(() => {\n      setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n      delete savedTimers.current[fieldName];\n    }, config.savedStateDurationMs);\n  }, [clearSavedTimer, setFieldState, config.savedStateDurationMs]);\n\n  // Cancel pending save for a field\n  const cancelFieldPending = useCallback((fieldName: string) => {\n    const pending = pendingSaves.current[fieldName];\n    if (pending) {\n      clearTimeout(pending.timeoutId);\n      pending.abortController.abort();\n      delete pendingSaves.current[fieldName];\n    }\n  }, []);\n\n  // Cancel all pending and in-flight saves\n  const cancelAllPending = useCallback(() => {\n    Object.keys(pendingSaves.current).forEach(fieldName => {\n      cancelFieldPending(fieldName);\n    });\n    // Abort saves that are past debounce and inside executeSave\n    Object.values(inFlightControllers.current).forEach(c => c.abort());\n    inFlightControllers.current = {};\n    // Local debounce timers are only half of the queue. When autosave is backed\n    // by RMM, cancel the shared mutation queue too so submit/conflict flows do\n    // not race a still-pending autosave mutation.\n    rmm?.cancelPendingMutations();\n  }, [cancelFieldPending, rmm]);\n\n  // Clear all autosave state\n  const clearAllState = useCallback(() => {\n    cancelAllPending();\n    setFieldStates({});\n    Object.values(savedTimers.current).forEach(timer => clearTimeout(timer));\n    savedTimers.current = {};\n    lastSavedValues.current = {};\n  }, [cancelAllPending]);\n\n  // Execute save for a field\n  const executeSave = useCallback(async (fieldName: string, value: unknown, abortController: AbortController) => {\n    // Track in-flight controller so cancelAllPending can abort it\n    inFlightControllers.current[fieldName] = abortController;\n\n    try {\n      // Validate field before saving\n      const isValid = validateField\n        ? await validateField(fieldName)\n        : formContext\n          ? await formContext.trigger(fieldName)\n          : true;\n      if (validateField || formContext) {\n        if (!isValid) {\n          setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n          return;\n        }\n      }\n\n      if (abortController.signal.aborted) return;\n\n      setFieldState(fieldName, { state: AutosaveFieldState.SAVING });\n\n      try {\n        if (onSave) {\n          await onSave(fieldName, value, abortController.signal);\n        } else if (rmm) {\n          // Autosave uses the same RMM queue as other mutation surfaces so field\n          // saves participate in ordering, conflict handling, and transport\n          // fallback exactly like explicit update-like actions.\n          const result = await rmm.queueMutation(\n            { [fieldName]: value },\n            { type: MutationType.AUTOSAVE, priority: MutationPriority.LOW },\n          );\n          if (!result.success) {\n            throw result.error ?? new Error(labels.errorGeneric);\n          }\n        } else {\n          return;\n        }\n\n        if (abortController.signal.aborted) return;\n\n        setSavedWithFade(fieldName);\n        onSaveSuccess?.(fieldName);\n      } catch (error) {\n        if (abortController.signal.aborted) return;\n\n        if (error instanceof Error && error.name === 'AbortError') return;\n\n        const typedMutationError = (\n          error && typeof error === 'object' && 'type' in error\n            ? error as { type?: MutationErrorType; message?: string }\n            : null\n        );\n        let errorMessage: string;\n        if (typedMutationError?.type === MutationErrorType.TRANSIENT) {\n          errorMessage = labels.errorNetwork;\n        } else if (typedMutationError?.type === MutationErrorType.VALIDATION) {\n          // The mutation's `message` is the backend reference (e.g. `validation`), never display text.\n          errorMessage = labels.errorValidation;\n        } else if (typedMutationError?.type === MutationErrorType.CONFLICT) {\n          // Field-level autosave copy stays local here, while the parent wrapper\n          // may also receive CONFLICT_RESET and show the broader authoritative\n          // conflict banner/reset UX.\n          errorMessage = labels.errorConflict;\n        } else if (error instanceof BackpressureRejectedError) {\n          logDebug('executeSave: backpressure rejection — resetting field to idle', { fieldName });\n          setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n          return;\n        } else if (error instanceof MutationCancelledError) {\n          setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n          return;\n        } else if (error instanceof ResourceDeletedError) {\n          setFieldState(fieldName, { state: AutosaveFieldState.ERROR, lastError: labels.errorResourceDeleted });\n          return;\n        } else {\n          // A thrown Error's message is developer text, never display text.\n          errorMessage = labels.errorGeneric;\n        }\n        setFieldState(fieldName, { state: AutosaveFieldState.ERROR, lastError: errorMessage });\n        onSaveError?.(fieldName, error instanceof Error ? error : new Error(errorMessage));\n      }\n    } finally {\n      // Only clean up if this controller is still the tracked one for this field\n      // (a newer save for the same field may have replaced it)\n      if (inFlightControllers.current[fieldName] === abortController) {\n        delete inFlightControllers.current[fieldName];\n      }\n    }\n  }, [formContext, labels, onSave, onSaveError, onSaveSuccess, rmm, setSavedWithFade, setFieldState, validateField]);\n\n  // Trigger save for a field\n  const triggerSave = useCallback((fieldName: string, value: unknown, trigger: AutosaveTrigger) => {\n    // Skip if autosave is disabled\n    if (!config.enabled) {\n      return;\n    }\n\n    // Skip for 'none' trigger\n    if (trigger === AutosaveTrigger.NONE) {\n      return;\n    }\n\n    // Track last value for retry\n    lastSavedValues.current[fieldName] = { value, trigger };\n\n    // Cancel any pending save for this field\n    cancelFieldPending(fieldName);\n\n    const abortController = new AbortController();\n\n    if (trigger === AutosaveTrigger.BLUR) {\n      // Immediate save on blur\n      executeSave(fieldName, value, abortController);\n    } else if (trigger === AutosaveTrigger.DEBOUNCE) {\n      // Debounced save\n      const debounceMs = config.debounceMs ?? DEFAULT_CONFIG.debounceMs!;\n\n      const timeoutId = setTimeout(() => {\n        delete pendingSaves.current[fieldName];\n        executeSave(fieldName, value, abortController);\n      }, debounceMs);\n\n      pendingSaves.current[fieldName] = {\n        timeoutId,\n        abortController,\n      };\n    }\n  }, [config.enabled, config.debounceMs, cancelFieldPending, executeSave]);\n\n  // Retry last save for a field (immediate)\n  const retryFieldSave = useCallback((fieldName: string) => {\n    if (!config.enabled) {\n      return;\n    }\n    const last = lastSavedValues.current[fieldName];\n    if (!last) {\n      return;\n    }\n\n    cancelFieldPending(fieldName);\n    const abortController = new AbortController();\n    executeSave(fieldName, last.value, abortController);\n  }, [config.enabled, cancelFieldPending, executeSave]);\n\n  // Get field state\n  const getFieldState = useCallback((fieldName: string): AutosaveFieldState => {\n    return fieldStates[fieldName]?.state ?? AutosaveFieldState.IDLE;\n  }, [fieldStates]);\n\n  // Get full field state info\n  const getFieldStateInfo = useCallback((fieldName: string): FieldAutosaveState => {\n    return fieldStates[fieldName] ?? DEFAULT_FIELD_STATE;\n  }, [fieldStates]);\n\n  // Context value\n  const contextValue = useMemo<AutosaveContextValue>(() => ({\n    config,\n    triggerSave,\n    retryFieldSave,\n    getFieldState,\n    getFieldStateInfo,\n    cancelAllPending,\n    cancelFieldPending,\n    clearAllState,\n    isSaving,\n  }), [\n    config,\n    triggerSave,\n    retryFieldSave,\n    getFieldState,\n    getFieldStateInfo,\n    cancelAllPending,\n    cancelFieldPending,\n    clearAllState,\n    isSaving,\n  ]);\n\n  return (\n    <AutosaveContext.Provider value={contextValue}>\n      {children}\n    </AutosaveContext.Provider>\n  );\n}\n"]}
+{"version":3,"file":"AutosaveContext.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutosaveContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * AutosaveContext\n *\n * Provides field-level autosave functionality for forms. Handles:\n * - Per-field save state tracking (idle, saving, saved, error)\n * - Debounced saves for 'debounce' trigger mode\n * - Blur-triggered saves for 'blur' trigger mode\n * - Cancellation of pending saves on form reset/submit\n * - Concurrent save handling with AbortController\n *\n * @example\n * ```tsx\n * // In ResourceAutomatedForm with autosaveConfig\n * <AutosaveProvider\n *   onSave={handleFieldSave}\n *   config={{ enabled: true, debounceMs: 500 }}\n * >\n *   <AutomatedForm ... />\n * </AutosaveProvider>\n *\n * // In FormField\n * const { triggerSave, getFieldState } = useAutosave();\n * const saveState = getFieldState(fieldName); // 'idle' | 'saving' | 'saved' | 'error'\n * ```\n */\n\nimport React, { createContext, useContext, useCallback, useRef, useState, useMemo, useEffect } from 'react';\nimport { useFormContext } from 'react-hook-form';\n\n// Import shared autosave enum from zod-decorators (canonical source)\nimport { AutosaveTrigger, type AutosaveFieldParams } from '@wildo-ai/zod-decorators';\n\nimport { MutationPriority, MutationType, MutationErrorType, MutationCancelledError, BackpressureRejectedError, ResourceDeletedError } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AutosaveContext');\nlogger.setDebugTypeLogging('AutosaveContext', false);\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * FIX-P7-L2: Re-export AutosaveTrigger from canonical source (zod-decorators)\n * for convenience. Consumers can import from either:\n * - '@wildo-ai/zod-decorators' (canonical, schema-level usage)\n * - '@wildo-ai/saas-frontend-lib' (convenience, component-level usage)\n */\nexport { AutosaveTrigger };\n\n/**\n * State of a field's autosave operation.\n * Re-exported from form-field-types for convenience.\n */\nimport { AutosaveFieldState } from '../form-field-types';\nexport { AutosaveFieldState };\n\n/** Configuration for autosave behavior */\nexport interface AutosaveConfig {\n  /** Whether autosave is enabled globally */\n  enabled: boolean;\n  /** Default trigger mode for fields without explicit config */\n  defaultTrigger?: AutosaveTrigger;\n  /** Default debounce delay in milliseconds */\n  debounceMs?: number;\n  /** Duration to show 'saved' state before returning to 'idle' */\n  savedStateDurationMs?: number;\n}\n\n/** Per-field autosave state */\nexport interface FieldAutosaveState {\n  state: AutosaveFieldState;\n  lastError?: string;\n  lastSavedAt?: number;\n}\n\n/** Localized error messages for autosave feedback. Resolved via i18n in the parent. */\nexport interface AutosaveProviderLabels {\n  errorNetwork: string;\n  errorValidation: string;\n  errorGeneric: string;\n  errorConflict: string;\n  errorResourceDeleted: string;\n}\n\n/** Callback type for save operation */\nexport type AutosaveSaveHandler = (\n  fieldName: string,\n  value: unknown,\n  abortSignal: AbortSignal\n) => Promise<void>;\n\n/** Context value */\nexport interface AutosaveContextValue {\n  /** Global autosave configuration */\n  config: AutosaveConfig;\n  /** Trigger a save for a specific field */\n  triggerSave: (fieldName: string, value: unknown, trigger: AutosaveTrigger) => void;\n  /** Retry the last save for a specific field (if available) */\n  retryFieldSave: (fieldName: string) => void;\n  /** Get the current state of a field's autosave */\n  getFieldState: (fieldName: string) => AutosaveFieldState;\n  /** Get full state info for a field (including error, timestamps) */\n  getFieldStateInfo: (fieldName: string) => FieldAutosaveState;\n  /** Cancel all pending saves */\n  cancelAllPending: () => void;\n  /** Cancel pending save for a specific field */\n  cancelFieldPending: (fieldName: string) => void;\n  /**\n   * Cancel every pending or in-flight save AT or UNDER a path (`address`, `address.city`, `steps.0.title`). A bulk form's\n   * explicit clear of a whole object, record or list calls it (#2620): a child edit still waiting in its debounce would\n   * otherwise fire after the clear and rebuild the object on every selected row, while the form shows it empty.\n   */\n  cancelPendingUnder: (path: string) => void;\n  /** Clear all autosave state (on form reset) */\n  clearAllState: () => void;\n  /** Whether any field is currently saving */\n  isSaving: boolean;\n}\n\n// =============================================================================\n// DEFAULTS\n// =============================================================================\n\nconst DEFAULT_CONFIG: AutosaveConfig = {\n  enabled: false,\n  defaultTrigger: AutosaveTrigger.DEBOUNCE,\n  debounceMs: 500,\n  savedStateDurationMs: 2000,\n};\n\nconst DEFAULT_FIELD_STATE: FieldAutosaveState = {\n  state: AutosaveFieldState.IDLE,\n};\n\n// =============================================================================\n// CONTEXT\n// =============================================================================\n\nconst AutosaveContext = createContext<AutosaveContextValue | null>(null);\n\nfunction useAutosave(): AutosaveContextValue {\n  const context = useContext(AutosaveContext);\n  if (!context) {\n    throw new Error('useAutosave must be used within an AutosaveProvider');\n  }\n  return context;\n}\n\n/**\n * Hook to access autosave context.\n * Returns null if not within an AutosaveProvider (autosave disabled).\n */\nexport function useOptionalAutosave(): AutosaveContextValue | null {\n  return useContext(AutosaveContext);\n}\n\n// =============================================================================\n// PROVIDER\n// =============================================================================\n\nexport interface AutosaveProviderProps {\n  children: React.ReactNode;\n  /** Localized error messages for autosave feedback */\n  labels: AutosaveProviderLabels;\n  /**\n   * Optional validation bridge used when the autosave provider is mounted\n   * outside the RHF provider subtree but still needs to honor wrapper-level\n   * field validation before saving.\n   */\n  validateField?: (fieldName: string) => Promise<boolean>;\n  /**\n   * Handler called when a field should be saved.\n   * When provided, this takes precedence over the provider's raw `rmm` path so\n   * callers can preserve custom transport semantics (for example semantic custom\n   * update operations or bulk-hosted mutation transports).\n   */\n  onSave?: AutosaveSaveHandler;\n  /**\n   * RMM instance — when provided, executeSave delegates to rmm.queueMutation()\n   * instead of calling onSave(). cancelAllPending delegates to rmm.cancelPendingMutations().\n   */\n  rmm?: ResourceMutationManager;\n  /** Autosave configuration */\n  config?: Partial<AutosaveConfig>;\n  /** Callback when autosave succeeds */\n  onSaveSuccess?: (fieldName: string) => void;\n  /** Callback when autosave fails */\n  onSaveError?: (fieldName: string, error: Error) => void;\n}\n\ninterface PendingSave {\n  timeoutId: ReturnType<typeof setTimeout>;\n  abortController: AbortController;\n}\n\nexport function AutosaveProvider({\n  children,\n  labels,\n  validateField,\n  onSave,\n  rmm,\n  config: configProp,\n  onSaveSuccess,\n  onSaveError,\n}: AutosaveProviderProps): React.JSX.Element {\n  // Merge config with defaults\n  const config = useMemo<AutosaveConfig>(() => ({\n    ...DEFAULT_CONFIG,\n    ...configProp,\n  }), [configProp]);\n\n  // Per-field state\n  const [fieldStates, setFieldStates] = useState<Record<string, FieldAutosaveState>>({});\n\n  // Pending saves (debounce timers and abort controllers)\n  const pendingSaves = useRef<Record<string, PendingSave>>({});\n\n  // In-flight abort controllers for saves that have passed debounce / blur.\n  // Allows cancelAllPending to abort saves that are already inside executeSave.\n  const inFlightControllers = useRef<Record<string, AbortController>>({});\n\n  // Last values for retry\n  const lastSavedValues = useRef<Record<string, { value: unknown; trigger: AutosaveTrigger }>>({});\n\n  // Saved state fade timers\n  const savedTimers = useRef<Record<string, ReturnType<typeof setTimeout>>>({});\n\n  // Track if any field is currently saving\n  const isSaving = useMemo(() => {\n    return Object.values(fieldStates).some(state => state.state === AutosaveFieldState.SAVING);\n  }, [fieldStates]);\n\n  // Get RHF context for validation\n  const formContext = useFormContext();\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      Object.values(pendingSaves.current).forEach(({ timeoutId, abortController }) => {\n        clearTimeout(timeoutId);\n        abortController.abort();\n      });\n      Object.values(inFlightControllers.current).forEach(c => c.abort());\n      Object.values(savedTimers.current).forEach(timer => clearTimeout(timer));\n    };\n  }, []);\n\n  // Update field state\n  // Uses default only when creating new state, preserves existing state otherwise\n  const setFieldState = useCallback((fieldName: string, state: Partial<FieldAutosaveState>) => {\n    setFieldStates(prev => ({\n      ...prev,\n      [fieldName]: {\n        ...(prev[fieldName] ?? DEFAULT_FIELD_STATE), // Only use default if no existing state\n        ...state,\n      },\n    }));\n  }, []);\n\n  // Clear saved state timer for a field\n  const clearSavedTimer = useCallback((fieldName: string) => {\n    if (savedTimers.current[fieldName]) {\n      clearTimeout(savedTimers.current[fieldName]);\n      delete savedTimers.current[fieldName];\n    }\n  }, []);\n\n  // Set saved state with auto-fade back to idle\n  const setSavedWithFade = useCallback((fieldName: string) => {\n    clearSavedTimer(fieldName);\n    setFieldState(fieldName, { state: AutosaveFieldState.SAVED, lastSavedAt: Date.now() });\n\n    savedTimers.current[fieldName] = setTimeout(() => {\n      setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n      delete savedTimers.current[fieldName];\n    }, config.savedStateDurationMs);\n  }, [clearSavedTimer, setFieldState, config.savedStateDurationMs]);\n\n  // Cancel pending save for a field\n  const cancelFieldPending = useCallback((fieldName: string) => {\n    const pending = pendingSaves.current[fieldName];\n    if (pending) {\n      clearTimeout(pending.timeoutId);\n      pending.abortController.abort();\n      delete pendingSaves.current[fieldName];\n    }\n  }, []);\n\n  // Cancel pending and in-flight saves at or under a path (see `cancelPendingUnder`)\n  const cancelPendingUnder = useCallback((path: string) => {\n    const covers = (fieldName: string) => fieldName === path || fieldName.startsWith(`${path}.`) || fieldName.startsWith(`${path}[`);\n    Object.keys(pendingSaves.current).filter(covers).forEach((fieldName) => cancelFieldPending(fieldName));\n    for (const [fieldName, controller] of Object.entries(inFlightControllers.current)) {\n      if (!covers(fieldName)) continue;\n      controller.abort();\n      delete inFlightControllers.current[fieldName];\n      // An aborted save is no longer saving: its indicator must not stay on when the field comes back.\n      setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n    }\n  }, [cancelFieldPending, setFieldState]);\n\n  // Cancel all pending and in-flight saves\n  const cancelAllPending = useCallback(() => {\n    Object.keys(pendingSaves.current).forEach(fieldName => {\n      cancelFieldPending(fieldName);\n    });\n    // Abort saves that are past debounce and inside executeSave\n    Object.values(inFlightControllers.current).forEach(c => c.abort());\n    inFlightControllers.current = {};\n    // Local debounce timers are only half of the queue. When autosave is backed\n    // by RMM, cancel the shared mutation queue too so submit/conflict flows do\n    // not race a still-pending autosave mutation.\n    rmm?.cancelPendingMutations();\n  }, [cancelFieldPending, rmm]);\n\n  // Clear all autosave state\n  const clearAllState = useCallback(() => {\n    cancelAllPending();\n    setFieldStates({});\n    Object.values(savedTimers.current).forEach(timer => clearTimeout(timer));\n    savedTimers.current = {};\n    lastSavedValues.current = {};\n  }, [cancelAllPending]);\n\n  // Execute save for a field\n  const executeSave = useCallback(async (fieldName: string, value: unknown, abortController: AbortController) => {\n    // Track in-flight controller so cancelAllPending can abort it\n    inFlightControllers.current[fieldName] = abortController;\n\n    try {\n      // Validate field before saving\n      const isValid = validateField\n        ? await validateField(fieldName)\n        : formContext\n          ? await formContext.trigger(fieldName)\n          : true;\n      if (validateField || formContext) {\n        if (!isValid) {\n          setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n          return;\n        }\n      }\n\n      if (abortController.signal.aborted) return;\n\n      setFieldState(fieldName, { state: AutosaveFieldState.SAVING });\n\n      try {\n        if (onSave) {\n          await onSave(fieldName, value, abortController.signal);\n        } else if (rmm) {\n          // Autosave uses the same RMM queue as other mutation surfaces so field\n          // saves participate in ordering, conflict handling, and transport\n          // fallback exactly like explicit update-like actions.\n          const result = await rmm.queueMutation(\n            { [fieldName]: value },\n            { type: MutationType.AUTOSAVE, priority: MutationPriority.LOW },\n          );\n          if (!result.success) {\n            throw result.error ?? new Error(labels.errorGeneric);\n          }\n        } else {\n          return;\n        }\n\n        if (abortController.signal.aborted) return;\n\n        setSavedWithFade(fieldName);\n        onSaveSuccess?.(fieldName);\n      } catch (error) {\n        if (abortController.signal.aborted) return;\n\n        if (error instanceof Error && error.name === 'AbortError') return;\n\n        const typedMutationError = (\n          error && typeof error === 'object' && 'type' in error\n            ? error as { type?: MutationErrorType; message?: string }\n            : null\n        );\n        let errorMessage: string;\n        if (typedMutationError?.type === MutationErrorType.TRANSIENT) {\n          errorMessage = labels.errorNetwork;\n        } else if (typedMutationError?.type === MutationErrorType.VALIDATION) {\n          // The mutation's `message` is the backend reference (e.g. `validation`), never display text.\n          errorMessage = labels.errorValidation;\n        } else if (typedMutationError?.type === MutationErrorType.CONFLICT) {\n          // Field-level autosave copy stays local here, while the parent wrapper\n          // may also receive CONFLICT_RESET and show the broader authoritative\n          // conflict banner/reset UX.\n          errorMessage = labels.errorConflict;\n        } else if (error instanceof BackpressureRejectedError) {\n          logDebug('executeSave: backpressure rejection — resetting field to idle', { fieldName });\n          setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n          return;\n        } else if (error instanceof MutationCancelledError) {\n          setFieldState(fieldName, { state: AutosaveFieldState.IDLE });\n          return;\n        } else if (error instanceof ResourceDeletedError) {\n          setFieldState(fieldName, { state: AutosaveFieldState.ERROR, lastError: labels.errorResourceDeleted });\n          return;\n        } else {\n          // A thrown Error's message is developer text, never display text.\n          errorMessage = labels.errorGeneric;\n        }\n        setFieldState(fieldName, { state: AutosaveFieldState.ERROR, lastError: errorMessage });\n        onSaveError?.(fieldName, error instanceof Error ? error : new Error(errorMessage));\n      }\n    } finally {\n      // Only clean up if this controller is still the tracked one for this field\n      // (a newer save for the same field may have replaced it)\n      if (inFlightControllers.current[fieldName] === abortController) {\n        delete inFlightControllers.current[fieldName];\n      }\n    }\n  }, [formContext, labels, onSave, onSaveError, onSaveSuccess, rmm, setSavedWithFade, setFieldState, validateField]);\n\n  // Trigger save for a field\n  const triggerSave = useCallback((fieldName: string, value: unknown, trigger: AutosaveTrigger) => {\n    // Skip if autosave is disabled\n    if (!config.enabled) {\n      return;\n    }\n\n    // Skip for 'none' trigger\n    if (trigger === AutosaveTrigger.NONE) {\n      return;\n    }\n\n    // Track last value for retry\n    lastSavedValues.current[fieldName] = { value, trigger };\n\n    // Cancel any pending save for this field\n    cancelFieldPending(fieldName);\n\n    const abortController = new AbortController();\n\n    if (trigger === AutosaveTrigger.BLUR) {\n      // Immediate save on blur\n      executeSave(fieldName, value, abortController);\n    } else if (trigger === AutosaveTrigger.DEBOUNCE) {\n      // Debounced save\n      const debounceMs = config.debounceMs ?? DEFAULT_CONFIG.debounceMs!;\n\n      const timeoutId = setTimeout(() => {\n        delete pendingSaves.current[fieldName];\n        executeSave(fieldName, value, abortController);\n      }, debounceMs);\n\n      pendingSaves.current[fieldName] = {\n        timeoutId,\n        abortController,\n      };\n    }\n  }, [config.enabled, config.debounceMs, cancelFieldPending, executeSave]);\n\n  // Retry last save for a field (immediate)\n  const retryFieldSave = useCallback((fieldName: string) => {\n    if (!config.enabled) {\n      return;\n    }\n    const last = lastSavedValues.current[fieldName];\n    if (!last) {\n      return;\n    }\n\n    cancelFieldPending(fieldName);\n    const abortController = new AbortController();\n    executeSave(fieldName, last.value, abortController);\n  }, [config.enabled, cancelFieldPending, executeSave]);\n\n  // Get field state\n  const getFieldState = useCallback((fieldName: string): AutosaveFieldState => {\n    return fieldStates[fieldName]?.state ?? AutosaveFieldState.IDLE;\n  }, [fieldStates]);\n\n  // Get full field state info\n  const getFieldStateInfo = useCallback((fieldName: string): FieldAutosaveState => {\n    return fieldStates[fieldName] ?? DEFAULT_FIELD_STATE;\n  }, [fieldStates]);\n\n  // Context value\n  const contextValue = useMemo<AutosaveContextValue>(() => ({\n    config,\n    triggerSave,\n    retryFieldSave,\n    getFieldState,\n    getFieldStateInfo,\n    cancelAllPending,\n    cancelFieldPending,\n    cancelPendingUnder,\n    clearAllState,\n    isSaving,\n  }), [\n    config,\n    triggerSave,\n    retryFieldSave,\n    getFieldState,\n    getFieldStateInfo,\n    cancelAllPending,\n    cancelFieldPending,\n    cancelPendingUnder,\n    clearAllState,\n    isSaving,\n  ]);\n\n  return (\n    <AutosaveContext.Provider value={contextValue}>\n      {children}\n    </AutosaveContext.Provider>\n  );\n}\n\n/**\n * Resolve autosave trigger mode from field schema or context default.\n *\n * The ONE answer to \"does this field autosave, and when?\", for every field kind: a scalar FormField, an array, a\n * record, and the item templates inside an array (through `ArrayAutosavesContext`). Arrays and records used to call\n * `triggerSave(…, DEBOUNCE)` without asking, so in a form whose autosave is DERIVED (only a field that declares it\n * saves, `defaultTrigger: NONE`) every array and record field saved on each edit while every scalar beside it waited\n * for Save.\n *\n * @param autosaveConfig - Autosave config from decorator (true = default, object = custom, undefined = inherit)\n * @param contextDefaultTrigger - Default trigger from AutosaveContext\n * @param isTextField - Whether this is a text field (affects default behavior)\n * @returns The resolved trigger mode\n */\nexport function resolveFieldAutosaveTrigger(\n  autosaveConfig: AutosaveFieldParams | true | undefined,\n  contextDefaultTrigger: AutosaveTrigger = AutosaveTrigger.DEBOUNCE,\n  isTextField: boolean = false\n): AutosaveTrigger {\n  // No autosave config on field - use context default\n  if (autosaveConfig === undefined) {\n    return contextDefaultTrigger;\n  }\n\n  // True = default (use context default or debounce for text, blur for others)\n  if (autosaveConfig === true) {\n    return isTextField ? AutosaveTrigger.DEBOUNCE : AutosaveTrigger.BLUR;\n  }\n\n  // Object config\n  if (typeof autosaveConfig === 'object') {\n    // Check if explicitly disabled via enabled: false\n    if (autosaveConfig.enabled === false) {\n      return AutosaveTrigger.NONE;\n    }\n    // Use explicit trigger or trigger: 'none' to disable\n    if (autosaveConfig.trigger) {\n      return autosaveConfig.trigger;\n    }\n    // Default based on field type\n    return isTextField ? AutosaveTrigger.DEBOUNCE : AutosaveTrigger.BLUR;\n  }\n\n  return contextDefaultTrigger;\n}\n"]}

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

@@ -120,7 +120,7 @@ export interface FormFieldProps {
  * Handles composite (object) and array schemas by delegating to
  * specialized components.
  */
-declare function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description: descriptionProp, tooltip: tooltipProp, labelPlacement, hideLabel, hideDescription, controlSize, respectSurfaceErrorPlacement, enumLabels: enumLabelsProp, allowedValues, as, validationMode, disabled: disabledProp, readOnly: readOnlyProp, className, placeholder, type, renderField, sectionAppearance, objectItemLayout, fileUploadContext: fileUploadContextProp, autoFocus: autoFocusProp, excludedChildKeys, quickCreateSourceFieldName, }: FormFieldProps): React.JSX.Element | null;
+declare function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description: descriptionProp, tooltip: tooltipProp, labelPlacement, hideLabel, hideDescription, controlSize, respectSurfaceErrorPlacement, enumLabels: enumLabelsProp, allowedValues: allowedValuesProp, as, validationMode, disabled: disabledProp, readOnly: readOnlyProp, className, placeholder, type, renderField, sectionAppearance, objectItemLayout, fileUploadContext: fileUploadContextProp, autoFocus: autoFocusProp, excludedChildKeys, quickCreateSourceFieldName, }: FormFieldProps): React.JSX.Element | null;
 declare namespace FormFieldImpl {
     var displayName: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/FormField.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/FormField.tsx"],"names":[],"mappings":"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"}