npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.6 → 1.1.7 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1971) hide show

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

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

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

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

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

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

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