npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.4 → 1.1.5 - Mend

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

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 (2512) hide show

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 errorMessage = typedMutationError.message ?? 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 errorMessage = error instanceof Error ? error.message : 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 CHANGED Viewed

@@ -57,6 +57,17 @@ export interface FormFieldProps {
      */
     respectSurfaceErrorPlacement?: boolean;
     enumLabels?: Record<string, string>;
+    /**
+     * The values a STRING field may take when its vocabulary is decided at RUNTIME rather than by the schema —
+     * for example an organization's `type`, which must name one of the application's declared organization types
+     * (#1032). The schema cannot carry them as an enum because they are the application's declaration, not the
+     * engine's, so without this the field renders as free text and a typo is only refused after submit.
+     *
+     * When present, the field renders the enum control over exactly these values. Labels come from `enumLabels` when
+     * given, else the value itself — deliberately never humanized, so an unlabelled value looks unlabelled.
+     * An empty list still renders the enum control (with nothing to pick), rather than falling back to free text.
+     */
+    allowedValues?: readonly string[];
     as?: FormFieldComponent;
     validationMode?: ValidationMode;
     disabled?: boolean;
@@ -106,7 +117,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, 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, 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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/form/automated/FormField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;~~AAEH~~,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,cAAc,EAAE,kBAAkB,~~EAAkd~~,KAAK,kBAAkB,EAAkE,qBAAqB,EAAE,KAAK,eAAe,~~EAAE~~,MAAM,0BAA0B,CAAC;~~AAgBpqB~~,OAAO,EAAkB,cAAc,EAAoB,MAAM,qBAAqB,CAAC;~~AAuCvF~~,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAS3F,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAWlG;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAU1G;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CASjG;~~AAiSD~~;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAkFnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;OAGG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;IAChE,gIAAgI;IAChI,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IACtE,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAkED;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,EACrB,IAAI,EACJ,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,SAAS,EACT,eAAe,EACf,WAAW,EACX,4BAA4B,EAC5B,UAAU,EAAE,cAAc,EAC1B,EAAE,EACF,cAAc,EACd,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,SAAS,EACT,WAAW,EACX,IAAI,EACJ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAAE,qBAAqB,EACxC,SAAS,EAAE,aAAa,EACxB,iBAAiB,EACjB,0BAA0B,GAC3B,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,~~CAmvB3C~~;~~kBA7wBQ~~,aAAa;;;~~AAixBtB~~,eAAO,MAAM,SAAS,sBAAgB,CAAC"}
1	+ {"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/FormField.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/form/automated/FormField.js CHANGED Viewed

@@ -23,10 +23,11 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  * Touch state: Errors are only shown after a field is touched (blur) or
  * after form submit attempt. This prevents showing errors on initial render.
  */
-import { useCallback, useRef, useEffect, useMemo } from 'react';
+import { FormExternalValidationContext } from '../form-external-validation.js';
+import React, { useCallback, useRef, useEffect, useMemo } from 'react';
 import { useFormContext, Controller, useWatch } from 'react-hook-form';
 import { RelationshipNature, } from '@wildo-ai/saas-models';
-import { EditChromeMode, FormFieldComponent, FieldSchemaType, RangeSchemaType, getDefaultRangeComponent, getSchemaType, getEnumValues, getRangeType, getStringConstraints, getStringFormat, isForeignKey, isTemplatableFileField, getFieldUIEditConfig, isOptional, isNotEditableForOperation, getRecordValueSchema, getMapSchemas, getShowWhenParams, normalizeClearedRequestDtoValue, normalizeClearedMainSchemaValue, requestDtoFieldIsClearable, mainSchemaFieldIsClearable, AutosaveTrigger } from '@wildo-ai/zod-decorators';
+import { EditChromeMode, FormFieldComponent, FieldSchemaType, RangeSchemaType, getDefaultRangeComponent, getSchemaType, getEnumValues, getRangeType, getStringConstraints, getStringFormat, isForeignKey, isTemplatableFileField, getFieldUIEditConfig, isOptional, isNotEditableForOperation, getRecordValueSchema, getMapSchemas, getShowWhenParams, normalizeClearedRequestDtoValue, AutosaveTrigger, listAddressPartPaths } from '@wildo-ai/zod-decorators';
 import { AutomatedLayoutFrontendUtils } from '../../../core/automated-layout/automated-layout.frontend.utils.js';
 import { useSurfacePolicy } from '../../../core/ui/SurfacePolicyContext.js';
 import { AutosaveFieldState } from '../../../components/form/automated/AutosaveContext.js';
@@ -36,10 +37,11 @@ import { useResolvedFieldName } from '../../resources/skeleton/FieldScopeContext
 import { useWizardFieldRegistration } from '../../resources/skeleton/WizardStepFieldsContext.js';
 import { useSectionFieldRegistration } from '../../resources/skeleton/SectionFieldsContext.js';
 import { useFieldUniquenessValidation } from '../validation-errors/useFieldUniquenessValidation.js';
+import { useUnstartedFieldVisit } from '../validation-errors/unstarted-field-visit.js';
 import { FormFieldChrome } from '../chromes/FormFieldChrome.js';
 import { useFormChromeContext } from '../chromes/FormChromeContext.js';
 import { RangeSlider } from '../controls/number/slider.js';
-import { FormSchemaKind, ValidationMode } from '../form-field-types.js';
+import { ValidationMode } from '../form-field-types.js';
 import { Input } from '../../../components/form/controls/input.js';
 import { FormFieldDate } from '../fields/form-field-date.js';
 import { FormFieldDateTime } from '../fields/form-field-datetime.js';
@@ -64,6 +66,8 @@ import { FormFieldEnum } from '../fields/form-field-enum.js';
 import { FormFieldMoney } from '../fields/form-field-money.js';
 import { FormFieldDuration } from '../fields/form-field-duration.js';
 import { FormFieldPhone } from '../fields/form-field-phone.js';
+import { FormFieldAddress } from '../fields/form-field-address.js';
+import { FIELD_CLEARING_RULES, resolveFieldClearingRule } from './field-clearing-rule.frontend.utils.js';
 import { FormFieldBigDecimal } from '../fields/form-field-bigdecimal.js';
 import { FormFieldCode } from '../fields/form-field-code.js';
 import { FormFieldRangeBigDecimal } from '../fields/form-field-range-bigdecimal.js';
@@ -217,6 +221,8 @@ normalizeClearedValue = normalizeClearedRequestDtoValue) {
     // Uniqueness pre-validation on blur (only active when validateFieldUrl is in form context
     // and the field has the isUnique() decorator)
     const { validateUniqueness } = useFieldUniquenessValidation({ fieldName, fieldSchema: schema });
+    /** The shared blur gate — see `useUnstartedFieldVisit`, which every site handing out `field.onBlur` uses. */
+    const { handleFieldBlur, noteInputReceived } = useUnstartedFieldVisit(fieldName);
     /**
      * Wrap onBlur to trigger validation in onBlur mode.
      * This ensures validation runs when user leaves the field.
@@ -224,16 +230,22 @@ normalizeClearedValue = normalizeClearedRequestDtoValue) {
      * EDGE CASE: For onChange mode with text fields, we cancel any pending
      * debounced trigger and validate immediately on blur for responsive UX.
      *
+     * An UNSTARTED VISIT — an empty field nobody has typed into, with no error — is only recorded, never
+     * judged: `useUnstartedFieldVisit` marks it touched and this handler then validates nothing. Its
+     * JSDoc carries the reasoning, the source it was decided from, and the known limits.
+     *
      * Also triggers autosave for 'blur' trigger mode.
      * Also triggers uniqueness pre-validation for fields with isUnique() decorator.
      */
     const createBlurHandler = useCallback((fieldOnBlur) => () => {
-        // Always call RHF's onBlur to mark field as touched
-        fieldOnBlur();
+        const isUnstartedVisit = handleFieldBlur(fieldOnBlur);
         // Cancel any pending debounced validation to avoid double trigger
         cancelDebounce();
         // Trigger validation based on mode
-        if (validationMode === 'onBlur' || validationMode === 'onTouched') {
+        if (isUnstartedVisit) {
+            // Nothing to judge yet — see the JSDoc above.
+        }
+        else if (validationMode === 'onBlur' || validationMode === 'onTouched') {
             formContext.trigger(fieldName);
         }
         else if (validationMode === 'onChange' && isTextField) {
@@ -250,7 +262,7 @@ normalizeClearedValue = normalizeClearedRequestDtoValue) {
         // Trigger uniqueness pre-validation on blur (fire-and-forget async)
         // The hook internally guards against no-op cases (no decorator, no URL, empty value)
         validateUniqueness();
-    }, [formContext, fieldName, validationMode, isTextField, cancelDebounce, autosaveContext, autosaveTrigger, validateUniqueness]);
+    }, [formContext, fieldName, validationMode, isTextField, cancelDebounce, autosaveContext, autosaveTrigger, validateUniqueness, handleFieldBlur]);
     /**
      * Wrap onChange to trigger validation in onChange mode.
      * Uses debounce for text fields to avoid excessive validation.
@@ -276,6 +288,7 @@ normalizeClearedValue = normalizeClearedRequestDtoValue) {
         const value = (schema ? normalizeClearedValue(schema, rawValue) : rawValue);
         // Always call RHF's onChange to update value
         fieldOnChange(value);
+        noteInputReceived();
         const fieldState = formContext.getFieldState(fieldName);
         const shouldTrigger = validationMode === 'onChange' ||
             // onTouched: validate on change once the field has been touched (blurred at least once)
@@ -297,7 +310,7 @@ normalizeClearedValue = normalizeClearedRequestDtoValue) {
         if (autosaveContext && autosaveTrigger === AutosaveTrigger.DEBOUNCE) {
             autosaveContext.triggerSave(fieldName, value, AutosaveTrigger.DEBOUNCE);
         }
-    }, [formContext, fieldName, validationMode, isTextField, debouncedTrigger, autosaveContext, autosaveTrigger, schema, normalizeClearedValue]);
+    }, [formContext, fieldName, validationMode, isTextField, debouncedTrigger, autosaveContext, autosaveTrigger, schema, normalizeClearedValue, noteInputReceived]);
     return {
         createBlurHandler,
         createChangeHandler,
@@ -446,7 +459,7 @@ function resolveFieldSchema(rootSchema, path) {
  * Handles composite (object) and array schemas by delegating to
  * specialized components.
  */
-function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description: descriptionProp, tooltip: tooltipProp, labelPlacement, hideLabel, hideDescription, controlSize, respectSurfaceErrorPlacement, enumLabels: enumLabelsProp, as, validationMode, disabled: disabledProp, readOnly: readOnlyProp, className, placeholder, type, renderField, sectionAppearance, objectItemLayout, fileUploadContext: fileUploadContextProp, autoFocus: autoFocusProp, excludedChildKeys, quickCreateSourceFieldName, }) {
+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, }) {
     const formContext = useFormContext();
     const schemaContext = useFormSchemaContext();
     const surfacePolicy = useSurfacePolicy();
@@ -500,10 +513,33 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
     //   3. Here, compute `labelLoading = !labelProp && ctx != null && !ctx.labelsReady`
     //      and render the label via `<SkeletonText loading={labelLoading} …>` in
     //      `FormFieldChrome` instead of the raw `name` fallback.
-    const label = labelProp ?? ctx?.fieldLabels?.[resolvedName] ?? name;
-    const description = descriptionProp ?? ctx?.fieldDescriptions?.[resolvedName];
-    const tooltip = tooltipProp ?? ctx?.fieldTooltips?.[resolvedName];
-    const enumLabels = enumLabelsProp ?? ctx?.enumLabels?.[resolvedName];
+    /*
+     * The DICTIONARIES are keyed INDEX-FREE, so an array item's field must ask for its path without
+     * the index.
+     *
+     * `collectResourceLabelFieldEntries` walks arrays of objects "under their index-free path" — its
+     * own words — so a `steps` array of `{ afterMinutes, note, repeatCount }` registers exactly
+     * `steps.afterMinutes`, once, however many items exist. `resolvedName` inside an
+     * `<ArrayItemTemplate>` is `steps[0].afterMinutes`, which is in no dictionary, so every lookup
+     * missed and the label fell through to `name` — the raw leaf, rendered to the user as
+     * `afterMinutes`. Measured 2026-09-18 on the first authored consumer of `ArrayField` that this
+     * repository has ever had (#1299); the labels were generated correctly all along and nothing was
+     * asking for them.
+     *
+     * Only the DICTIONARY keys are normalized. `resolvedName` still addresses the form field itself,
+     * where the index is the whole point — it is what distinguishes item 0 from item 1 — and the
+     * registration, visibility and sibling-scope reads above and below keep using it unchanged.
+     *
+     * Both index spellings are stripped because both occur: React Hook Form writes `steps.0.x` while
+     * template-resolved paths read `steps[0].x`, which is why the unregister guard at the top of this
+     * component tests the dotted form and the root-name match tests the bracketed one. `DisplayField`
+     * already normalizes the bracketed form for the same reason.
+     */
+    const dictionaryName = resolvedName.replace(/\[(\d+)\]/g, '').replace(/\.\d+(?=\.|$)/g, '');
+    const label = labelProp ?? ctx?.fieldLabels?.[dictionaryName] ?? name;
+    const description = descriptionProp ?? ctx?.fieldDescriptions?.[dictionaryName];
+    const tooltip = tooltipProp ?? ctx?.fieldTooltips?.[dictionaryName];
+    const enumLabels = enumLabelsProp ?? ctx?.enumLabels?.[dictionaryName];
     const disabled = disabledProp ?? ctx?.disabled;
     const fileUploadContext = fileUploadContextProp ?? ctx?.fileUploadContext;
     const overrideElement = ctx?.generatedFieldOverrides?.[resolvedName];
@@ -600,13 +636,17 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
     // controls a plain boolean is what stops three separate controls re-asking the request-DTO
     // question of a schema that may be a MAIN schema — which silently made refined optional fields
     // unclearable on inline-edit surfaces while plain optional strings kept working by accident.
-    const isMainSchemaForm = schemaContext?.schemaKind === FormSchemaKind.MAIN_SCHEMA;
-    const normalizeClearedValue = isMainSchemaForm
-        ? normalizeClearedMainSchemaValue
-        : normalizeClearedRequestDtoValue;
-    const fieldIsClearable = schema
-        ? (isMainSchemaForm ? mainSchemaFieldIsClearable(schema) : requestDtoFieldIsClearable(schema))
-        : false;
+    //
+    // The rule also depends on the OBJECT holding the field (#989): an UPDATE DTO root clears its direct
+    // fields with `null`, while an object written whole — a nested value, an array item — clears by
+    // omission. See `resolveFieldClearingRule`.
+    const fieldClearing = FIELD_CLEARING_RULES[resolveFieldClearingRule({
+        schemaKind: schemaContext?.schemaKind,
+        rootSchema: ctx?.schema,
+        fieldName: resolvedName,
+    })];
+    const normalizeClearedValue = fieldClearing.normalizeClearedValue;
+    const fieldIsClearable = schema ? fieldClearing.isClearable(schema) : false;
     const { createBlurHandler, createChangeHandler, autosaveFieldState, autosaveError, handleRetrySave } = useFieldValidation(formContext, resolvedName, resolvedValidationMode, isTextField, schema, normalizeClearedValue);
     // Resolve autoFocus: explicit props keep working even inside AutomatedForm so
     // hand-authored templates can preserve intentional focus behavior. Only
@@ -630,20 +670,48 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
     // Handler for file component internal validation errors
     // Syncs file-specific validation (MIME type, size) with RHF's error state
     // This ensures formState.isValid correctly reflects file validation state
+    const externalErrors = React.useContext(FormExternalValidationContext);
+    const externalErrorOwner = useRef(Symbol('file-field-validation')).current;
+    useEffect(() => () => { externalErrors?.delete(externalErrorOwner); }, [externalErrors, externalErrorOwner, resolvedName]);
+    /**
+     * Stable and idempotent, and both properties are load-bearing.
+     *
+     * The file control reports its state from an effect keyed on this callback's identity, and the report
+     * calls `setError`, which always publishes a new RHF `formState`. RHF's `FormProvider` memoizes the
+     * context value on `formState`, so a callback keyed on the whole `useFormContext()` object got a new
+     * identity from its own report, re-ran the control's effect, reported again, and never stopped. It
+     * surfaced as "Maximum update depth exceeded" the moment an avatar crop was applied: the upload makes
+     * the control report its "processing" message, and that report fed itself.
+     *
+     * So the callback depends only on RHF's methods, which `useForm` creates once per form, and a report
+     * that matches the error already held publishes nothing.
+     */
+    const { setError: setFormError, clearErrors: clearFormErrors, getFieldState: getFormFieldState } = formContext;
     const handleFileValidationError = useCallback((fileError) => {
+        const holdFileError = (message) => {
+            // `getFieldState` without a `formState` argument reads the live error, not this render's copy.
+            const currentError = getFormFieldState(resolvedName).error;
+            if (currentError?.type === FILE_VALIDATION_ERROR_TYPE && currentError.message === message)
+                return;
+            setFormError(resolvedName, { type: FILE_VALIDATION_ERROR_TYPE, message });
+        };
         if (fileError) {
-            formContext.setError(resolvedName, {
-                type: FILE_VALIDATION_ERROR_TYPE,
-                message: fileError
-            });
+            externalErrors?.set(externalErrorOwner, { name: resolvedName, message: fileError });
+            holdFileError(fileError);
         }
         else {
-            const currentError = formContext.getFieldState(resolvedName, formContext.formState).error;
+            externalErrors?.delete(externalErrorOwner);
+            const remaining = [...(externalErrors?.values() ?? [])].find(entry => entry.name === resolvedName);
+            if (remaining) {
+                holdFileError(remaining.message);
+                return;
+            }
+            const currentError = getFormFieldState(resolvedName).error;
             if (currentError?.type === FILE_VALIDATION_ERROR_TYPE) {
-                formContext.clearErrors(resolvedName);
+                clearFormErrors(resolvedName);
             }
         }
-    }, [formContext, resolvedName]);
+    }, [setFormError, clearFormErrors, getFormFieldState, resolvedName, externalErrors, externalErrorOwner]);
     // =========================================================================
     // CHROME & BASE FIELD PROPS — must be defined before any early returns
     // =========================================================================
@@ -761,8 +829,9 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
                     ...baseFieldProps,
                     // Range controls take the same inbound treatment as every other control — this branch
                     // owns its own `Controller` rather than going through `renderControlled`, so the guard
-                    // has to be applied here too or a cleared range renders `null`.
-                    value: toRenderableFieldValue(field.value),
+                    // has to be applied here too or a cleared range renders `null`. It reads FORM STATE rather than
+                    // `field.value` for the same reason `renderControlled` does — see the note there (#989).
+                    value: toRenderableFieldValue(formContext.getValues(resolvedName)),
                     onBlur: wrappedOnBlur,
                 };
                 // Lookup map for component → element factory (avoids repetitive switch/if)
@@ -843,7 +912,12 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
     // override wins.
     chromeOverrides) {
         return (_jsx(Controller, { name: resolvedName, control: formContext.control, shouldUnregister: shouldUnregisterField, render: ({ field }) => (_jsx(FormFieldChrome, { ...chromeProps, ...chromeOverrides, children: render({
-                    value: toRenderableFieldValue(field.value),
+                    // FORM STATE, not `field.value` (#989). `field.value` falls back to the field's DEFAULT whenever
+                    // form state holds `undefined`, and `undefined` is exactly how a field inside an object written
+                    // whole is cleared (`normalizeClearedValueObjectFieldValue`). Rendering the fallback snapped an
+                    // emptied nested input straight back to its stored text while the form correctly held no value.
+                    // The two differ only in that case, so every other value renders as before.
+                    value: toRenderableFieldValue(formContext.getValues(resolvedName)),
                     onChange: createChangeHandler(field.onChange),
                     onBlur: createBlurHandler(field.onBlur),
                     ref: field.ref,
@@ -860,6 +934,12 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
     // resolvers instead, which is why six authored `component: TEXTAREA`
     // declarations silently edited as single-line inputs until 2026-09-08.
     // =========================================================================
+    // RUNTIME VOCABULARY — `allowedValues` turns a string field into a choice among values the schema cannot know.
+    // Before the `as` override on purpose: the values ARE the control's content, so no family choice may discard them.
+    if (allowedValues) {
+        const runtimeOptions = allowedValues.map((value) => ({ value, label: enumLabels?.[value] ?? value }));
+        return renderControlled(field => (_jsx(FormFieldEnum, { ...baseFieldProps, value: field.value, onChange: field.onChange, onBlur: field.onBlur, ref: field.ref, options: runtimeOptions })));
+    }
     const resolvedAs = as;
     if (resolvedAs && !isRangeSchemaType) {
         switch (resolvedAs) {
@@ -898,6 +978,22 @@ function FormFieldImpl({ name, schema: schemaProp, label: labelProp, description
     if (schemaType === FieldSchemaType.PHONE) {
         return renderControlled(field => (_jsx(FormFieldPhone, { ...baseFieldProps, value: field.value, onChange: field.onChange, onBlur: field.onBlur, ref: field.ref, placeholder: placeholder, autoComplete: resolvedAutoComplete })));
     }
+    if (schemaType === FieldSchemaType.ADDRESS) {
+        // A part's issue is reported at its own path (`address.city`), so this field's error is a NESTED
+        // object with no message of its own, and `getFieldError` would summarise it as the generic custom
+        // message for the whole group — naming nothing to fix. Each part's error goes to its own input
+        // instead, shown under the same touch/submit rule as the field (a part is never touched on its
+        // own: the control reports blur for the whole group). The chrome keeps only an issue on the
+        // value itself, such as a required address that is absent.
+        const addressPartErrors = Object.fromEntries(listAddressPartPaths().map((path) => {
+            const partState = formContext.getFieldState(`${resolvedName}.${path}`, formContext.formState);
+            const visiblePartState = { ...partState, isTouched: fieldState.isTouched, isDirty: fieldState.isDirty };
+            return [path, getFieldError(visiblePartState, formContext.formState.isSubmitted, resolvedValidationMode, tErrorValidation)];
+        }));
+        const ownError = fieldState.error;
+        const hasIssueOnValueItself = ownError !== undefined && (ownError.message !== undefined || ownError.type !== undefined);
+        return renderControlled(field => (_jsx(FormFieldAddress, { ...baseFieldProps, value: field.value, onChange: field.onChange, onBlur: field.onBlur, ref: field.ref, partErrors: addressPartErrors })), hasIssueOnValueItself ? undefined : { error: undefined });
+    }
     if (schemaType === FieldSchemaType.BIGDECIMAL) {
         return renderControlled(field => (_jsx(FormFieldBigDecimal, { ...baseFieldProps, value: field.value, onChange: field.onChange, onBlur: field.onBlur, ref: field.ref })));
     }