@fuf-stack/uniform 1.22.4 → 1.22.6

package/dist/{FormContext-BQeKOV-0.js.map → FormContext-DjJOJKxj.js.map}

@@ -1 +1 @@
-{"version":3,"file":"FormContext-BQeKOV-0.js","names":["FormProvider","HookFormProvider"],"sources":["../src/Form/subcomponents/FormResolver.ts","../src/Form/subcomponents/FormContext.tsx"],"sourcesContent":["import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { and, veto } from '@fuf-stack/veto';\n\nimport { toValidationFormat } from '../../helpers';\n\n/**\n * Hook that manages client validation schemas state.\n *\n * Provides a centralized way to add/remove dynamic validation schemas\n * that can be combined with base form validation.\n *\n * @returns Object with client validation state and memoized setter function\n */\nexport const useClientValidationManager = () => {\n  // Client validation schemas state\n  const [clientValidationSchemas, setClientValidationSchemas] = useState<\n    Record<string, VetoTypeAny>\n  >({});\n\n  // Memoized function to set/clear client validation schema\n  const setClientValidationSchema = useMemo(() => {\n    return (key: string, schema: VetoTypeAny | null) => {\n      // update client validation schemas\n      setClientValidationSchemas((prev) => {\n        // if no schema and no existing client validation schema for this key, do nothing\n        if (!prev[key] && !schema) {\n          return prev;\n        }\n        // if no schema, remove the client validation schema for this key\n        if (!schema) {\n          const { [key]: _removed, ...rest } = prev;\n          return rest;\n        }\n        // if schema, add or update the client validation schema for this key\n        return { ...prev, [key]: schema };\n      });\n    };\n  }, []);\n\n  return {\n    clientValidationSchemas,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates an extended validation instance combining base Veto validation with dynamic client validation.\n *\n * @param baseValidation - Optional base Veto validation schema\n * @returns Combined validation instance and client schema setter\n */\nexport const useExtendedValidation = (baseValidation?: VetoInstance) => {\n  // Setup client validation schemas\n  const { clientValidationSchemas, setClientValidationSchema } =\n    useClientValidationManager();\n\n  // Create a stable dependency array from the client validation schemas\n  const clientSchemaValues = useMemo<VetoTypeAny[]>(\n    () => {\n      const keys = Object.keys(clientValidationSchemas).sort();\n      return keys\n        .map((key) => {\n          return clientValidationSchemas[key];\n        })\n        .filter((schema): schema is VetoTypeAny => {\n          return Boolean(schema);\n        });\n    },\n    // Include the object identity to react to schema instance updates with same shape\n    [clientValidationSchemas],\n  );\n\n  // Memoized extended validation instance\n  const extendedValidation = useMemo(\n    () => {\n      const hasBaseValidation = !!baseValidation;\n      const hasClientSchemas = clientSchemaValues.length > 0;\n\n      // If no base validation and no client schemas, return undefined\n      if (!hasBaseValidation && !hasClientSchemas) {\n        return undefined;\n      }\n\n      // If no client schemas, return base validation\n      if (!hasClientSchemas) {\n        return baseValidation;\n      }\n\n      // Combine client validation schemas\n      const clientSchemasCombined =\n        clientSchemaValues.reduce<VetoTypeAny | null>(\n          (combined, clientSchema) => {\n            return combined ? and(combined, clientSchema) : clientSchema;\n          },\n          null,\n        );\n\n      // return combined validation\n      if (baseValidation && clientSchemasCombined) {\n        // Put client validation first so dynamic/domain-specific messages\n        // are returned before generic base validation errors.\n        const baseSchema = baseValidation.schema as VetoTypeAny;\n        return veto(and(clientSchemasCombined, baseSchema));\n      }\n\n      // If we only have client schemas, return them as a veto instance\n      if (clientSchemasCombined) {\n        return veto(clientSchemasCombined);\n      }\n\n      // This should not happen due to the conditions above, but just in case\n      return baseValidation;\n    },\n    // Recompute when validation schema instances change\n    [baseValidation, clientSchemaValues],\n  );\n\n  return {\n    extendedValidation,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Render state for formatted validation errors produced by the resolver.\n *\n * `errors` is the value exposed through Uniform context. `hash` is the stable\n * comparison key used to avoid re-rendering context consumers when validation\n * returns an equivalent error object with a new identity.\n */\ninterface ValidationErrorsState {\n  /** Formatted validation errors exposed to Uniform consumers. */\n  errors: VetoFormattedError | undefined;\n  /** JSON hash of `errors`, used as a cheap equality signal. */\n  hash: string | undefined;\n}\n\n/**\n * Creates a React Hook Form resolver from an extended validation instance and\n * stores its latest formatted Veto errors as React state.\n *\n * Keeping the resolver errors in state lets Uniform context consumers re-render\n * when validation output changes, while the hash prevents repeated validations\n * with equivalent errors from causing unnecessary updates.\n *\n * @param extendedValidation - Extended validation instance from useExtendedValidation\n * @returns Resolver function plus the latest validation errors and their hash\n */\nexport const useFormResolver = (extendedValidation?: VetoInstance) => {\n  // Keep the latest resolver errors in React state so Uniform context consumers\n  // re-render when validation output changes. The paired hash lets us skip the\n  // state update when a resolver run returns equivalent errors.\n  const [validationErrorsState, setValidationErrorsState] =\n    useState<ValidationErrorsState>({\n      errors: undefined,\n      hash: undefined,\n    });\n\n  /**\n   * Updates resolver error state only when the formatted validation result\n   * actually changes. Veto/RHF may create new error objects for equivalent\n   * validation output, so the hash is the guard against avoidable context\n   * refreshes.\n   */\n  const updateValidationErrors = useCallback(\n    (errors: VetoFormattedError | undefined): void => {\n      const nextHash = JSON.stringify(errors);\n\n      setValidationErrorsState((current) => {\n        if (current.hash === nextHash) {\n          return current;\n        }\n\n        return {\n          errors,\n          hash: nextHash,\n        };\n      });\n    },\n    [],\n  );\n\n  // Memoized resolver function for React Hook Form\n  const resolver = useMemo(() => {\n    if (!extendedValidation) {\n      return undefined;\n    }\n\n    return async (values: FieldValues) => {\n      const validationValues = toValidationFormat(values) ?? {};\n      const result = await extendedValidation.validateAsync(validationValues);\n      updateValidationErrors(result.errors ?? undefined);\n\n      // Transform veto result to React Hook Form format\n      return {\n        values: result.data ?? {},\n        errors: result.errors ?? {},\n      };\n    };\n  }, [extendedValidation, updateValidationErrors]);\n\n  return {\n    resolver,\n    validationErrors: validationErrorsState.errors,\n    validationErrorsHash: validationErrorsState.hash,\n  };\n};\n","import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { BaseSyntheticEvent, ReactNode } from 'react';\nimport type { FieldValues, Path, SubmitHandler } from 'react-hook-form';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport { FormProvider as HookFormProvider, useForm } from 'react-hook-form';\n\nimport createDebug from 'debug';\n\nimport { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toSubmitFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\n\nconst debug = createDebug('uniform:FormContext');\n\ntype DebugMode = 'debug' | 'debug-testids' | 'off' | 'disabled';\n\nexport interface DebugModeSettings {\n  /** disable form debug completely */\n  disable?: boolean;\n  /** custom localStorage key to save debug mode state */\n  localStorageKey?: string;\n}\n\n/** Listener function that gets called when a form reset is triggered */\nexport type FormResetListener = () => void;\n\n/**\n * Listener function that gets called when a field changes due to user input\n */\nexport type UserChangeListener<TFieldValues extends object = object> = (\n  fieldName: Path<TFieldValues>,\n  value: unknown,\n) => void;\n\nconst DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT = 'uniform:debug-mode';\n\n/**\n * The `UniformContext` provides control over the form's submission behavior and may optionally include\n * a Veto validation schema for form validation.\n *\n * Specifically, this context offers:\n * 1. **Form Submission Control**: The `preventSubmit` function allows components to enable or disable\n *    form submissions.\n * 2. **Optional Validation Schema**: The `validation` property may hold a Veto validation schema instance\n *    that can be used to validate form fields and handle validation logic.\n * 3. **Client Validation**: The `setClientValidationSchema` function allows setting dynamic client-side\n *    validation schemas that complement the base Veto validation.\n * 4. **User Change Tracking**: The `userChange` property provides a pub/sub system for tracking\n *    user-initiated field changes (typing, clicking, selecting) - NOT programmatic changes like\n *    form.reset() or form.setValue(). Used by the `useWatchUserChange` hook to enable reactive\n *    field dependencies.\n * 5. **Form Reset Tracking**: The `formReset` property provides a pub/sub system for tracking\n *    programmatic form resets triggered via the wrapped `reset()` from `useFormContext`.\n *    Used by hooks like `useWatchFormReset` to run reset-specific normalization logic.\n *\n * This context is useful for components that need to interact with or control the form submission state,\n * or access the validation schema for managing form validation logic.\n *\n * IMPORTANT: Context Singleton Pattern for HMR (Hot Module Replacement)\n * =====================================================================\n *\n * We use a global window variable to ensure only ONE context instance exists across\n * hot module reloads during development. This is critical because:\n *\n * **The Problem:**\n * When using Vite/Storybook with Fast Refresh (HMR), editing this file causes it to\n * be re-evaluated. Each re-evaluation runs `React.createContext()` again, creating a\n * NEW context instance. This leads to \"context instance mismatch\":\n *\n *   1. FormProvider (provider) loads and uses context instance A\n *   2. File is edited, HMR triggers\n *   3. SubmitButton (consumer) hot-reloads and imports context instance B\n *   4. Provider writes to instance A, Consumer reads from instance B\n *   5. Result: Consumer sees default values (triggerSubmit = () => undefined)\n *   6. Clicking submit does nothing because it calls the empty default function\n *\n * **The Solution:**\n * By storing the context in `window.__UNIFORM_CONTEXT__`, we ensure:\n *   - First load: Create context and store in window\n *   - Subsequent HMRs: Reuse the same context from window\n *   - All components always reference the SAME context instance\n *   - Provider and consumers can properly communicate\n *\n * **Why This Is Safe:**\n * - Only affects development (production has no HMR)\n * - Context type never changes (same interface)\n * - React handles cleanup on unmount normally\n * - No memory leaks (context is lightweight)\n *\n * Without this pattern, you'd need to restart the dev server after every edit\n * to FormContext.tsx to ensure all components use the same context instance.\n */\n\n// Define the context type\ninterface UniformContextType {\n  /** Form debug mode enabled or not */\n  debugMode: DebugMode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** Form reset tracking (programmatic reset calls) */\n  formReset: {\n    /**\n     * Subscribe to programmatic form resets.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: FormResetListener) => () => void;\n    /**\n     * Notify all subscribers about a programmatic form reset.\n     * Called from useFormContext when reset() is invoked.\n     */\n    notify: () => void;\n  };\n  /** Function to update if the form can currently be submitted */\n  preventSubmit: (prevent: boolean) => void;\n  /** Setter to enable or disable form debug mode */\n  setDebugMode: (debugMode: DebugMode) => void;\n  /** Function to trigger form submit programmatically */\n  triggerSubmit: (e?: BaseSyntheticEvent) => Promise<void> | void;\n  /** User change tracking (user input only, not programmatic changes) */\n  userChange: {\n    /**\n     * Subscribe to user field changes.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: UserChangeListener) => () => void;\n    /**\n     * Notify all subscribers about a user field change.\n     * Called from useController when user interacts with a field.\n     */\n    notify: (fieldName: string, value: unknown) => void;\n  };\n  /** Form validation configuration */\n  validation: {\n    /** Base validation schema instance (without client validation) */\n    baseInstance?: VetoInstance;\n    /** Veto validation schema instance for form validation */\n    instance?: VetoInstance;\n    /** Current validation errors in form */\n    errors?: VetoFormattedError;\n    /** Function to set client validation schema for a specific key */\n    setClientValidationSchema: (\n      key: string,\n      schema: VetoTypeAny | null,\n    ) => void;\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nif (!(window as any).__UNIFORM_CONTEXT__) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (window as any).__UNIFORM_CONTEXT__ = React.createContext<UniformContextType>(\n    {\n      debugMode: 'off',\n      formReset: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      preventSubmit: () => {\n        return undefined;\n      },\n      setDebugMode: () => {\n        return undefined;\n      },\n      triggerSubmit: () => {\n        return undefined;\n      },\n      userChange: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      validation: {\n        setClientValidationSchema: () => {\n          return undefined;\n        },\n      },\n    },\n  );\n  debug('Creating new UniformContext instance');\n} else {\n  debug(\n    'Reusing existing UniformContext instance from window.__UNIFORM_CONTEXT__',\n  );\n}\n\n// Export the singleton context instance from window\n// This ensures all imports get the same context, even after HMR\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const UniformContext = (window as any)\n  .__UNIFORM_CONTEXT__ as React.Context<UniformContextType>;\n\ndebug('UniformContext exported', {\n  contextExists: !!UniformContext,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  windowContextExists: !!(window as any).__UNIFORM_CONTEXT__,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextsMatch: UniformContext === (window as any).__UNIFORM_CONTEXT__,\n});\n\n// Define props for the internal FormProvider component\ninterface FormProviderProps {\n  /** children form render function */\n  children: (childProps: {\n    handleSubmit: (e?: BaseSyntheticEvent) => Promise<void>;\n    isValid: boolean;\n  }) => ReactNode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** Veto validation schema instance */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * FormProvider component provides:\n * - Veto validation schema context\n * - Resolver-backed validation error state\n * - Client validation schema management\n * - Submit handler with automatic data conversion and submission control with preventSubmit\n * - Form Debug Mode state\n * - Form reset pub/sub notifications (`formReset`)\n * - User change pub/sub notifications (`userChange`)\n * - React Hook Form context\n */\nconst FormProvider: React.FC<FormProviderProps> = ({\n  children,\n  debugModeSettings = undefined,\n  initialValues = undefined,\n  onSubmit,\n  validation: baseValidation = undefined,\n  validationTrigger,\n}) => {\n  // Form Debug mode state is handled in the form context\n  const [debugMode, setDebugMode] = useLocalStorage<DebugMode>(\n    debugModeSettings?.localStorageKey ?? DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT,\n    'off',\n  );\n\n  // Create extended validation combining base + client validations\n  const { extendedValidation, setClientValidationSchema } =\n    useExtendedValidation(baseValidation);\n\n  // Create resolver from extended validation + reactive validation error state\n  const { resolver, validationErrors, validationErrorsHash } =\n    useFormResolver(extendedValidation);\n\n  // Initialize react hook form with the resolver\n  const methods = useForm({\n    defaultValues: initialValues ? toFormFormat(initialValues) : initialValues,\n    // set rhf mode\n    // see: https://react-hook-form.com/docs/useform#mode\n    mode: validationTrigger,\n    resolver,\n  });\n\n  // Get isValid from React Hook Form's formState\n  const isValid = methods.formState?.isValid;\n\n  // Control if the form can currently be submitted\n  const [preventSubmit, setPreventSubmit] = useState(false);\n\n  // Form reset listener registry (stored in ref to avoid re-renders)\n  const formResetListenersRef = useRef<Set<FormResetListener>>(new Set());\n\n  // Subscribe to form reset notifications\n  const subscribeFormReset = useCallback(\n    (listener: FormResetListener): (() => void) => {\n      formResetListenersRef.current.add(listener);\n      return () => {\n        formResetListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about a programmatic form reset\n  const notifyFormReset = useCallback((): void => {\n    formResetListenersRef.current.forEach((listener) => {\n      listener();\n    });\n  }, []);\n\n  // User change listener registry (stored in ref to avoid re-renders)\n  const userChangeListenersRef = useRef<Set<UserChangeListener>>(new Set());\n\n  // Subscribe to user changes\n  const subscribeUserChange = useCallback(\n    (listener: UserChangeListener): (() => void) => {\n      userChangeListenersRef.current.add(listener);\n      // Return cleanup function to unsubscribe\n      return () => {\n        userChangeListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about user change\n  const notifyUserChange = useCallback(\n    (fieldName: string, value: unknown): void => {\n      // Notify all registered listeners\n      userChangeListenersRef.current.forEach((listener) => {\n        listener(fieldName as Path<object>, value);\n      });\n    },\n    [],\n  );\n\n  // Create submit handler with automatic data conversion\n  // eslint-disable-next-line consistent-return\n  const handleSubmit = async (e?: React.BaseSyntheticEvent) => {\n    debug('handleSubmit called', {\n      preventSubmit,\n      formStateIsValid: methods.formState.isValid,\n      validationErrors: methods.formState.errors,\n      validationTrigger,\n      formValues: methods.getValues(),\n    });\n\n    // only prevent submit when form state is valid, because otherwise\n    // submit will only trigger validation and add errors / focus invalid fields\n    if (methods.formState.isValid && preventSubmit) {\n      debug('⛔ Form submit PREVENTED', {\n        formStateIsValid: methods.formState.isValid,\n        preventSubmit,\n      });\n      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\n    }\n\n    debug('✓ Form submit ALLOWED', {\n      formStateIsValid: methods.formState.isValid,\n      preventSubmit,\n      reason: !methods.formState.isValid\n        ? 'Form is invalid (will trigger validation and show errors)'\n        : 'Form is valid and preventSubmit is false',\n    });\n\n    // Convert form data to submission format:\n    // - Unwrap flat array wrappers and convert markers\n    // - Remove empty strings, nulls, empty arrays, and empty objects\n    const wrappedOnSubmit = (data: FieldValues, event?: BaseSyntheticEvent) => {\n      const submitData = toSubmitFormat(data) ?? {};\n      debug('onSubmit callback called', { submitData });\n      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\n\n    debug('handleSubmit completed');\n  };\n\n  // Memoize the context value so consumers only re-render when context-relevant\n  // state changes, including resolver-backed validation errors.\n  const contextValue = useMemo(\n    () => {\n      return {\n        // set debugMode to disabled when debugModeSettings.disable is true\n        // otherwise use current debug mode from localStorage\n        debugMode: debugModeSettings?.disable ? 'disabled' : debugMode,\n        preventSubmit: (prevent: boolean) => {\n          debug('preventSubmit called', {\n            previousValue: preventSubmit,\n            newValue: prevent,\n            formStateIsValid: methods.formState.isValid,\n            validationErrors: methods.formState.errors,\n          });\n          setPreventSubmit(prevent);\n        },\n        setClientValidationSchema,\n        setDebugMode,\n        triggerSubmit: handleSubmit,\n        formReset: {\n          subscribe: subscribeFormReset,\n          notify: notifyFormReset,\n        },\n        userChange: {\n          subscribe: subscribeUserChange,\n          notify: notifyUserChange,\n        },\n        validation: {\n          baseInstance: baseValidation,\n          instance: extendedValidation,\n          errors: validationErrors,\n          setClientValidationSchema,\n        },\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [debugMode, debugModeSettings?.disable, validationErrorsHash],\n  );\n\n  return (\n    <UniformContext.Provider value={contextValue}>\n      {/* Spread all hook form props into HookFormProvider */}\n      <HookFormProvider {...methods}>\n        {children({ handleSubmit, isValid })}\n      </HookFormProvider>\n    </UniformContext.Provider>\n  );\n};\n\nexport default FormProvider;\n"],"mappings":"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"}
+{"version":3,"file":"FormContext-DjJOJKxj.js","names":["FormProvider","HookFormProvider"],"sources":["../src/Form/subcomponents/FormResolver.ts","../src/Form/subcomponents/FormContext.tsx"],"sourcesContent":["import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { and, veto } from '@fuf-stack/veto';\n\nimport { toValidationFormat } from '../../helpers';\n\n/**\n * Hook that manages client validation schemas state.\n *\n * Provides a centralized way to add/remove dynamic validation schemas\n * that can be combined with base form validation.\n *\n * @returns Object with client validation state and memoized setter function\n */\nexport const useClientValidationManager = () => {\n  // Client validation schemas state\n  const [clientValidationSchemas, setClientValidationSchemas] = useState<\n    Record<string, VetoTypeAny>\n  >({});\n\n  // Memoized function to set/clear client validation schema\n  const setClientValidationSchema = useMemo(() => {\n    return (key: string, schema: VetoTypeAny | null) => {\n      // update client validation schemas\n      setClientValidationSchemas((prev) => {\n        // if no schema and no existing client validation schema for this key, do nothing\n        if (!prev[key] && !schema) {\n          return prev;\n        }\n        // if no schema, remove the client validation schema for this key\n        if (!schema) {\n          const { [key]: _removed, ...rest } = prev;\n          return rest;\n        }\n        // if schema, add or update the client validation schema for this key\n        return { ...prev, [key]: schema };\n      });\n    };\n  }, []);\n\n  return {\n    clientValidationSchemas,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates an extended validation instance combining base Veto validation with dynamic client validation.\n *\n * @param baseValidation - Optional base Veto validation schema\n * @returns Combined validation instance and client schema setter\n */\nexport const useExtendedValidation = (baseValidation?: VetoInstance) => {\n  // Setup client validation schemas\n  const { clientValidationSchemas, setClientValidationSchema } =\n    useClientValidationManager();\n\n  // Create a stable dependency array from the client validation schemas\n  const clientSchemaValues = useMemo<VetoTypeAny[]>(\n    () => {\n      const keys = Object.keys(clientValidationSchemas).sort();\n      return keys\n        .map((key) => {\n          return clientValidationSchemas[key];\n        })\n        .filter((schema): schema is VetoTypeAny => {\n          return Boolean(schema);\n        });\n    },\n    // Include the object identity to react to schema instance updates with same shape\n    [clientValidationSchemas],\n  );\n\n  // Memoized extended validation instance\n  const extendedValidation = useMemo(\n    () => {\n      const hasBaseValidation = !!baseValidation;\n      const hasClientSchemas = clientSchemaValues.length > 0;\n\n      // If no base validation and no client schemas, return undefined\n      if (!hasBaseValidation && !hasClientSchemas) {\n        return undefined;\n      }\n\n      // If no client schemas, return base validation\n      if (!hasClientSchemas) {\n        return baseValidation;\n      }\n\n      // Combine client validation schemas\n      const clientSchemasCombined =\n        clientSchemaValues.reduce<VetoTypeAny | null>(\n          (combined, clientSchema) => {\n            return combined ? and(combined, clientSchema) : clientSchema;\n          },\n          null,\n        );\n\n      // return combined validation\n      if (baseValidation && clientSchemasCombined) {\n        // Put client validation first so dynamic/domain-specific messages\n        // are returned before generic base validation errors.\n        const baseSchema = baseValidation.schema as VetoTypeAny;\n        return veto(and(clientSchemasCombined, baseSchema));\n      }\n\n      // If we only have client schemas, return them as a veto instance\n      if (clientSchemasCombined) {\n        return veto(clientSchemasCombined);\n      }\n\n      // This should not happen due to the conditions above, but just in case\n      return baseValidation;\n    },\n    // Recompute when validation schema instances change\n    [baseValidation, clientSchemaValues],\n  );\n\n  return {\n    extendedValidation,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Render state for formatted validation errors produced by the resolver.\n *\n * `errors` is the value exposed through Uniform context. `hash` is the stable\n * comparison key used to avoid re-rendering context consumers when validation\n * returns an equivalent error object with a new identity.\n */\ninterface ValidationErrorsState {\n  /** Formatted validation errors exposed to Uniform consumers. */\n  errors: VetoFormattedError | undefined;\n  /** JSON hash of `errors`, used as a cheap equality signal. */\n  hash: string | undefined;\n}\n\n/**\n * Creates a React Hook Form resolver from an extended validation instance and\n * stores its latest formatted Veto errors as React state.\n *\n * Keeping the resolver errors in state lets Uniform context consumers re-render\n * when validation output changes, while the hash prevents repeated validations\n * with equivalent errors from causing unnecessary updates.\n *\n * @param extendedValidation - Extended validation instance from useExtendedValidation\n * @returns Resolver function plus the latest validation errors and their hash\n */\nexport const useFormResolver = (extendedValidation?: VetoInstance) => {\n  // Keep the latest resolver errors in React state so Uniform context consumers\n  // re-render when validation output changes. The paired hash lets us skip the\n  // state update when a resolver run returns equivalent errors.\n  const [validationErrorsState, setValidationErrorsState] =\n    useState<ValidationErrorsState>({\n      errors: undefined,\n      hash: undefined,\n    });\n\n  /**\n   * Updates resolver error state only when the formatted validation result\n   * actually changes. Veto/RHF may create new error objects for equivalent\n   * validation output, so the hash is the guard against avoidable context\n   * refreshes.\n   */\n  const updateValidationErrors = useCallback(\n    (errors: VetoFormattedError | undefined): void => {\n      const nextHash = JSON.stringify(errors);\n\n      setValidationErrorsState((current) => {\n        if (current.hash === nextHash) {\n          return current;\n        }\n\n        return {\n          errors,\n          hash: nextHash,\n        };\n      });\n    },\n    [],\n  );\n\n  // Memoized resolver function for React Hook Form\n  const resolver = useMemo(() => {\n    if (!extendedValidation) {\n      return undefined;\n    }\n\n    return async (values: FieldValues) => {\n      const validationValues = toValidationFormat(values) ?? {};\n      const result = await extendedValidation.validateAsync(validationValues);\n      updateValidationErrors(result.errors ?? undefined);\n\n      // Transform veto result to React Hook Form format\n      return {\n        values: result.data ?? {},\n        errors: result.errors ?? {},\n      };\n    };\n  }, [extendedValidation, updateValidationErrors]);\n\n  return {\n    resolver,\n    validationErrors: validationErrorsState.errors,\n    validationErrorsHash: validationErrorsState.hash,\n  };\n};\n","import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { BaseSyntheticEvent, ReactNode } from 'react';\nimport type { FieldValues, Path, SubmitHandler } from 'react-hook-form';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport { FormProvider as HookFormProvider, useForm } from 'react-hook-form';\n\nimport createDebug from 'debug';\n\nimport { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toSubmitFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\n\nconst debug = createDebug('uniform:FormContext');\n\ntype DebugMode = 'debug' | 'debug-testids' | 'off' | 'disabled';\n\nexport interface DebugModeSettings {\n  /** disable form debug completely */\n  disable?: boolean;\n  /** custom localStorage key to save debug mode state */\n  localStorageKey?: string;\n}\n\n/** Listener function that gets called when a form reset is triggered */\nexport type FormResetListener = () => void;\n\n/**\n * Listener function that gets called when a field changes due to user input\n */\nexport type UserChangeListener<TFieldValues extends object = object> = (\n  fieldName: Path<TFieldValues>,\n  value: unknown,\n) => void;\n\nconst DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT = 'uniform:debug-mode';\n\n/**\n * The `UniformContext` provides control over the form's submission behavior and may optionally include\n * a Veto validation schema for form validation.\n *\n * Specifically, this context offers:\n * 1. **Form Submission Control**: The `preventSubmit` function allows components to enable or disable\n *    form submissions.\n * 2. **Optional Validation Schema**: The `validation` property may hold a Veto validation schema instance\n *    that can be used to validate form fields and handle validation logic.\n * 3. **Client Validation**: The `setClientValidationSchema` function allows setting dynamic client-side\n *    validation schemas that complement the base Veto validation.\n * 4. **User Change Tracking**: The `userChange` property provides a pub/sub system for tracking\n *    user-initiated field changes (typing, clicking, selecting) - NOT programmatic changes like\n *    form.reset() or form.setValue(). Used by the `useWatchUserChange` hook to enable reactive\n *    field dependencies.\n * 5. **Form Reset Tracking**: The `formReset` property provides a pub/sub system for tracking\n *    programmatic form resets triggered via the wrapped `reset()` from `useFormContext`.\n *    Used by hooks like `useWatchFormReset` to run reset-specific normalization logic.\n *\n * This context is useful for components that need to interact with or control the form submission state,\n * or access the validation schema for managing form validation logic.\n *\n * IMPORTANT: Context Singleton Pattern for HMR (Hot Module Replacement)\n * =====================================================================\n *\n * We use a global window variable to ensure only ONE context instance exists across\n * hot module reloads during development. This is critical because:\n *\n * **The Problem:**\n * When using Vite/Storybook with Fast Refresh (HMR), editing this file causes it to\n * be re-evaluated. Each re-evaluation runs `React.createContext()` again, creating a\n * NEW context instance. This leads to \"context instance mismatch\":\n *\n *   1. FormProvider (provider) loads and uses context instance A\n *   2. File is edited, HMR triggers\n *   3. SubmitButton (consumer) hot-reloads and imports context instance B\n *   4. Provider writes to instance A, Consumer reads from instance B\n *   5. Result: Consumer sees default values (triggerSubmit = () => undefined)\n *   6. Clicking submit does nothing because it calls the empty default function\n *\n * **The Solution:**\n * By storing the context in `window.__UNIFORM_CONTEXT__`, we ensure:\n *   - First load: Create context and store in window\n *   - Subsequent HMRs: Reuse the same context from window\n *   - All components always reference the SAME context instance\n *   - Provider and consumers can properly communicate\n *\n * **Why This Is Safe:**\n * - Only affects development (production has no HMR)\n * - Context type never changes (same interface)\n * - React handles cleanup on unmount normally\n * - No memory leaks (context is lightweight)\n *\n * Without this pattern, you'd need to restart the dev server after every edit\n * to FormContext.tsx to ensure all components use the same context instance.\n */\n\n// Define the context type\ninterface UniformContextType {\n  /** Form debug mode enabled or not */\n  debugMode: DebugMode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** Form reset tracking (programmatic reset calls) */\n  formReset: {\n    /**\n     * Subscribe to programmatic form resets.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: FormResetListener) => () => void;\n    /**\n     * Notify all subscribers about a programmatic form reset.\n     * Called from useFormContext when reset() is invoked.\n     */\n    notify: () => void;\n  };\n  /** Function to update if the form can currently be submitted */\n  preventSubmit: (prevent: boolean) => void;\n  /** Setter to enable or disable form debug mode */\n  setDebugMode: (debugMode: DebugMode) => void;\n  /** Function to trigger form submit programmatically */\n  triggerSubmit: (e?: BaseSyntheticEvent) => Promise<void> | void;\n  /** User change tracking (user input only, not programmatic changes) */\n  userChange: {\n    /**\n     * Subscribe to user field changes.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: UserChangeListener) => () => void;\n    /**\n     * Notify all subscribers about a user field change.\n     * Called from useController when user interacts with a field.\n     */\n    notify: (fieldName: string, value: unknown) => void;\n  };\n  /** Form validation configuration */\n  validation: {\n    /** Base validation schema instance (without client validation) */\n    baseInstance?: VetoInstance;\n    /** Veto validation schema instance for form validation */\n    instance?: VetoInstance;\n    /** Current validation errors in form */\n    errors?: VetoFormattedError;\n    /** Function to set client validation schema for a specific key */\n    setClientValidationSchema: (\n      key: string,\n      schema: VetoTypeAny | null,\n    ) => void;\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nif (!(window as any).__UNIFORM_CONTEXT__) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (window as any).__UNIFORM_CONTEXT__ = React.createContext<UniformContextType>(\n    {\n      debugMode: 'off',\n      formReset: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      preventSubmit: () => {\n        return undefined;\n      },\n      setDebugMode: () => {\n        return undefined;\n      },\n      triggerSubmit: () => {\n        return undefined;\n      },\n      userChange: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      validation: {\n        setClientValidationSchema: () => {\n          return undefined;\n        },\n      },\n    },\n  );\n  debug('Creating new UniformContext instance');\n} else {\n  debug(\n    'Reusing existing UniformContext instance from window.__UNIFORM_CONTEXT__',\n  );\n}\n\n// Export the singleton context instance from window\n// This ensures all imports get the same context, even after HMR\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const UniformContext = (window as any)\n  .__UNIFORM_CONTEXT__ as React.Context<UniformContextType>;\n\ndebug('UniformContext exported', {\n  contextExists: !!UniformContext,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  windowContextExists: !!(window as any).__UNIFORM_CONTEXT__,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextsMatch: UniformContext === (window as any).__UNIFORM_CONTEXT__,\n});\n\n// Define props for the internal FormProvider component\ninterface FormProviderProps {\n  /** children form render function */\n  children: (childProps: {\n    handleSubmit: (e?: BaseSyntheticEvent) => Promise<void>;\n    isValid: boolean;\n  }) => ReactNode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** Veto validation schema instance */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * FormProvider component provides:\n * - Veto validation schema context\n * - Resolver-backed validation error state\n * - Client validation schema management\n * - Submit handler with automatic data conversion and submission control with preventSubmit\n * - Form Debug Mode state\n * - Form reset pub/sub notifications (`formReset`)\n * - User change pub/sub notifications (`userChange`)\n * - React Hook Form context\n */\nconst FormProvider: React.FC<FormProviderProps> = ({\n  children,\n  debugModeSettings = undefined,\n  initialValues = undefined,\n  onSubmit,\n  validation: baseValidation = undefined,\n  validationTrigger,\n}) => {\n  // Form Debug mode state is handled in the form context\n  const [debugMode, setDebugMode] = useLocalStorage<DebugMode>(\n    debugModeSettings?.localStorageKey ?? DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT,\n    'off',\n  );\n\n  // Create extended validation combining base + client validations\n  const { extendedValidation, setClientValidationSchema } =\n    useExtendedValidation(baseValidation);\n\n  // Create resolver from extended validation + reactive validation error state\n  const { resolver, validationErrors, validationErrorsHash } =\n    useFormResolver(extendedValidation);\n\n  // Initialize react hook form with the resolver\n  const methods = useForm({\n    defaultValues: initialValues ? toFormFormat(initialValues) : initialValues,\n    // set rhf mode\n    // see: https://react-hook-form.com/docs/useform#mode\n    mode: validationTrigger,\n    resolver,\n  });\n\n  // Get isValid from React Hook Form's formState\n  const isValid = methods.formState?.isValid;\n\n  // Control if the form can currently be submitted\n  const [preventSubmit, setPreventSubmit] = useState(false);\n\n  // Form reset listener registry (stored in ref to avoid re-renders)\n  const formResetListenersRef = useRef<Set<FormResetListener>>(new Set());\n\n  // Subscribe to form reset notifications\n  const subscribeFormReset = useCallback(\n    (listener: FormResetListener): (() => void) => {\n      formResetListenersRef.current.add(listener);\n      return () => {\n        formResetListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about a programmatic form reset\n  const notifyFormReset = useCallback((): void => {\n    formResetListenersRef.current.forEach((listener) => {\n      listener();\n    });\n  }, []);\n\n  // User change listener registry (stored in ref to avoid re-renders)\n  const userChangeListenersRef = useRef<Set<UserChangeListener>>(new Set());\n\n  // Subscribe to user changes\n  const subscribeUserChange = useCallback(\n    (listener: UserChangeListener): (() => void) => {\n      userChangeListenersRef.current.add(listener);\n      // Return cleanup function to unsubscribe\n      return () => {\n        userChangeListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about user change\n  const notifyUserChange = useCallback(\n    (fieldName: string, value: unknown): void => {\n      // Notify all registered listeners\n      userChangeListenersRef.current.forEach((listener) => {\n        listener(fieldName as Path<object>, value);\n      });\n    },\n    [],\n  );\n\n  // Create submit handler with automatic data conversion\n  // eslint-disable-next-line consistent-return\n  const handleSubmit = async (e?: React.BaseSyntheticEvent) => {\n    debug('handleSubmit called', {\n      preventSubmit,\n      formStateIsValid: methods.formState.isValid,\n      validationErrors: methods.formState.errors,\n      validationTrigger,\n      formValues: methods.getValues(),\n    });\n\n    // only prevent submit when form state is valid, because otherwise\n    // submit will only trigger validation and add errors / focus invalid fields\n    if (methods.formState.isValid && preventSubmit) {\n      debug('⛔ Form submit PREVENTED', {\n        formStateIsValid: methods.formState.isValid,\n        preventSubmit,\n      });\n      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\n    }\n\n    debug('✓ Form submit ALLOWED', {\n      formStateIsValid: methods.formState.isValid,\n      preventSubmit,\n      reason: !methods.formState.isValid\n        ? 'Form is invalid (will trigger validation and show errors)'\n        : 'Form is valid and preventSubmit is false',\n    });\n\n    // Convert form data to submission format:\n    // - Unwrap flat array wrappers and convert markers\n    // - Remove empty strings, nulls, empty arrays, and empty objects\n    const wrappedOnSubmit = (data: FieldValues, event?: BaseSyntheticEvent) => {\n      const submitData = toSubmitFormat(data) ?? {};\n      debug('onSubmit callback called', { submitData });\n      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\n\n    debug('handleSubmit completed');\n  };\n\n  // Memoize the context value so consumers only re-render when context-relevant\n  // state changes, including resolver-backed validation errors.\n  const contextValue = useMemo(\n    () => {\n      return {\n        // set debugMode to disabled when debugModeSettings.disable is true\n        // otherwise use current debug mode from localStorage\n        debugMode: debugModeSettings?.disable ? 'disabled' : debugMode,\n        preventSubmit: (prevent: boolean) => {\n          debug('preventSubmit called', {\n            previousValue: preventSubmit,\n            newValue: prevent,\n            formStateIsValid: methods.formState.isValid,\n            validationErrors: methods.formState.errors,\n          });\n          setPreventSubmit(prevent);\n        },\n        setClientValidationSchema,\n        setDebugMode,\n        triggerSubmit: handleSubmit,\n        formReset: {\n          subscribe: subscribeFormReset,\n          notify: notifyFormReset,\n        },\n        userChange: {\n          subscribe: subscribeUserChange,\n          notify: notifyUserChange,\n        },\n        validation: {\n          baseInstance: baseValidation,\n          instance: extendedValidation,\n          errors: validationErrors,\n          setClientValidationSchema,\n        },\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [debugMode, debugModeSettings?.disable, validationErrorsHash],\n  );\n\n  return (\n    <UniformContext.Provider value={contextValue}>\n      {/* Spread all hook form props into HookFormProvider */}\n      <HookFormProvider {...methods}>\n        {children({ handleSubmit, isValid })}\n      </HookFormProvider>\n    </UniformContext.Provider>\n  );\n};\n\nexport default FormProvider;\n"],"mappings":";;;;;;;;;;;;;;;;AAqBA,MAAa,mCAAmC;CAE9C,MAAM,CAAC,yBAAyB,8BAA8B,SAE5D,CAAC,CAAC;CAsBJ,OAAO;EACL;EACA,2BArBgC,cAAc;GAC9C,QAAQ,KAAa,WAA+B;IAElD,4BAA4B,SAAS;KAEnC,IAAI,CAAC,KAAK,QAAQ,CAAC,QACjB,OAAO;KAGT,IAAI,CAAC,QAAQ;MACX,MAAM,GAAG,MAAM,UAAU,GAAG,SAAS;MACrC,OAAO;KACT;KAEA,OAAO;MAAE,GAAG;OAAO,MAAM;KAAO;IAClC,CAAC;GACH;EACF,GAAG,CAAC,CAIsB;CAC1B;AACF;;;;;;;AAQA,MAAa,yBAAyB,mBAAkC;CAEtE,MAAM,EAAE,yBAAyB,8BAC/B,2BAA2B;CAG7B,MAAM,qBAAqB,cACnB;EAEJ,OADa,OAAO,KAAK,uBAAuB,EAAE,KACxC,EACP,KAAK,QAAQ;GACZ,OAAO,wBAAwB;EACjC,CAAC,EACA,QAAQ,WAAkC;GACzC,OAAO,QAAQ,MAAM;EACvB,CAAC;CACL,GAEA,CAAC,uBAAuB,CAC1B;CA+CA,OAAO;EACL,oBA7CyB,cACnB;GACJ,MAAM,oBAAoB,CAAC,CAAC;GAC5B,MAAM,mBAAmB,mBAAmB,SAAS;GAGrD,IAAI,CAAC,qBAAqB,CAAC,kBACzB;GAIF,IAAI,CAAC,kBACH,OAAO;GAIT,MAAM,wBACJ,mBAAmB,QAChB,UAAU,iBAAiB;IAC1B,OAAO,WAAW,IAAI,UAAU,YAAY,IAAI;GAClD,GACA,IACF;GAGF,IAAI,kBAAkB,uBAAuB;IAG3C,MAAM,aAAa,eAAe;IAClC,OAAO,KAAK,IAAI,uBAAuB,UAAU,CAAC;GACpD;GAGA,IAAI,uBACF,OAAO,KAAK,qBAAqB;GAInC,OAAO;EACT,GAEA,CAAC,gBAAgB,kBAAkB,CAIlB;EACjB;CACF;AACF;;;;;;;;;;;;AA2BA,MAAa,mBAAmB,uBAAsC;CAIpE,MAAM,CAAC,uBAAuB,4BAC5B,SAAgC;EAC9B,QAAQ,KAAA;EACR,MAAM,KAAA;CACR,CAAC;;;;;;;CAQH,MAAM,yBAAyB,aAC5B,WAAiD;EAChD,MAAM,WAAW,KAAK,UAAU,MAAM;EAEtC,0BAA0B,YAAY;GACpC,IAAI,QAAQ,SAAS,UACnB,OAAO;GAGT,OAAO;IACL;IACA,MAAM;GACR;EACF,CAAC;CACH,GACA,CAAC,CACH;CAqBA,OAAO;EACL,UAnBe,cAAc;GAC7B,IAAI,CAAC,oBACH;GAGF,OAAO,OAAO,WAAwB;IACpC,MAAM,mBAAmB,mBAAmB,MAAM,KAAK,CAAC;IACxD,MAAM,SAAS,MAAM,mBAAmB,cAAc,gBAAgB;IACtE,uBAAuB,OAAO,UAAU,KAAA,CAAS;IAGjD,OAAO;KACL,QAAQ,OAAO,QAAQ,CAAC;KACxB,QAAQ,OAAO,UAAU,CAAC;IAC5B;GACF;EACF,GAAG,CAAC,oBAAoB,sBAAsB,CAGrC;EACP,kBAAkB,sBAAsB;EACxC,sBAAsB,sBAAsB;CAC9C;AACF;;;ACpMA,MAAM,QAAQ,YAAY,qBAAqB;AAsB/C,MAAM,uCAAuC;AAkH7C,IAAI,CAAE,OAAe,qBAAqB;CAExC,OAAgB,sBAAsB,MAAM,cAC1C;EACE,WAAW;EACX,WAAW;GACT,iBAAiB;IACf,aAAa,CAEb;GACF;GACA,cAAc,CAEd;EACF;EACA,qBAAqB,CAErB;EACA,oBAAoB,CAEpB;EACA,qBAAqB,CAErB;EACA,YAAY;GACV,iBAAiB;IACf,aAAa,CAEb;GACF;GACA,cAAc,CAEd;EACF;EACA,YAAY,EACV,iCAAiC,CAEjC,EACF;CACF,CACF;CACA,MAAM,sCAAsC;AAC9C,OACE,MACE,0EACF;AAMF,MAAa,iBAAkB,OAC5B;AAEH,MAAM,2BAA2B;CAC/B,eAAe,CAAC,CAAC;CAEjB,qBAAqB,CAAC,CAAE,OAAe;CAEvC,eAAe,mBAAoB,OAAe;AACpD,CAAC;;;;;;;;;;;;AAgCD,MAAMA,kBAA6C,EACjD,UACA,oBAAoB,KAAA,GACpB,gBAAgB,KAAA,GAChB,UACA,YAAY,iBAAiB,KAAA,GAC7B,wBACI;CAEJ,MAAM,CAAC,WAAW,gBAAgB,gBAChC,mBAAmB,mBAAmB,sCACtC,KACF;CAGA,MAAM,EAAE,oBAAoB,8BAC1B,sBAAsB,cAAc;CAGtC,MAAM,EAAE,UAAU,kBAAkB,yBAClC,gBAAgB,kBAAkB;CAGpC,MAAM,UAAU,QAAQ;EACtB,eAAe,gBAAgB,aAAa,aAAa,IAAI;EAG7D,MAAM;EACN;CACF,CAAC;CAGD,MAAM,UAAU,QAAQ,WAAW;CAGnC,MAAM,CAAC,eAAe,oBAAoB,SAAS,KAAK;CAGxD,MAAM,wBAAwB,uBAA+B,IAAI,IAAI,CAAC;CAGtE,MAAM,qBAAqB,aACxB,aAA8C;EAC7C,sBAAsB,QAAQ,IAAI,QAAQ;EAC1C,aAAa;GACX,sBAAsB,QAAQ,OAAO,QAAQ;EAC/C;CACF,GACA,CAAC,CACH;CAGA,MAAM,kBAAkB,kBAAwB;EAC9C,sBAAsB,QAAQ,SAAS,aAAa;GAClD,SAAS;EACX,CAAC;CACH,GAAG,CAAC,CAAC;CAGL,MAAM,yBAAyB,uBAAgC,IAAI,IAAI,CAAC;CAGxE,MAAM,sBAAsB,aACzB,aAA+C;EAC9C,uBAAuB,QAAQ,IAAI,QAAQ;EAE3C,aAAa;GACX,uBAAuB,QAAQ,OAAO,QAAQ;EAChD;CACF,GACA,CAAC,CACH;CAGA,MAAM,mBAAmB,aACtB,WAAmB,UAAyB;EAE3C,uBAAuB,QAAQ,SAAS,aAAa;GACnD,SAAS,WAA2B,KAAK;EAC3C,CAAC;CACH,GACA,CAAC,CACH;CAIA,MAAM,eAAe,OAAO,MAAiC;EAC3D,MAAM,uBAAuB;GAC3B;GACA,kBAAkB,QAAQ,UAAU;GACpC,kBAAkB,QAAQ,UAAU;GACpC;GACA,YAAY,QAAQ,UAAU;EAChC,CAAC;EAID,IAAI,QAAQ,UAAU,WAAW,eAAe;GAC9C,MAAM,2BAA2B;IAC/B,kBAAkB,QAAQ,UAAU;IACpC;GACF,CAAC;GACD,QAAQ,KACN,2EACF;GACA,GAAG,eAAe;GAClB,OAAO,QAAQ,QAAQ;EACzB;EAEA,MAAM,yBAAyB;GAC7B,kBAAkB,QAAQ,UAAU;GACpC;GACA,QAAQ,CAAC,QAAQ,UAAU,UACvB,8DACA;EACN,CAAC;EAKD,MAAM,mBAAmB,MAAmB,UAA+B;GACzE,MAAM,aAAa,eAAe,IAAI,KAAK,CAAC;GAC5C,MAAM,4BAA4B,EAAE,WAAW,CAAC;GAChD,OAAO,SAAS,YAAY,KAAK;EACnC;EAEA,MAAM,QAAQ,aAAa,eAAe,EAAE,CAAC;EAE7C,MAAM,wBAAwB;CAChC;CAIA,MAAM,eAAe,cACb;EACJ,OAAO;GAGL,WAAW,mBAAmB,UAAU,aAAa;GACrD,gBAAgB,YAAqB;IACnC,MAAM,wBAAwB;KAC5B,eAAe;KACf,UAAU;KACV,kBAAkB,QAAQ,UAAU;KACpC,kBAAkB,QAAQ,UAAU;IACtC,CAAC;IACD,iBAAiB,OAAO;GAC1B;GACA;GACA;GACA,eAAe;GACf,WAAW;IACT,WAAW;IACX,QAAQ;GACV;GACA,YAAY;IACV,WAAW;IACX,QAAQ;GACV;GACA,YAAY;IACV,cAAc;IACd,UAAU;IACV,QAAQ;IACR;GACF;EACF;CACF,GAEA;EAAC;EAAW,mBAAmB;EAAS;CAAoB,CAC9D;CAEA,OACE,oBAAC,eAAe,UAAhB;EAAyB,OAAO;YAE9B,oBAACC,cAAD;GAAkB,GAAI;aACnB,SAAS;IAAE;IAAc;GAAQ,CAAC;EACnB,CAAA;CACK,CAAA;AAE7B"}

package/dist/{FormContext-DsmS_mkO.cjs → FormContext-EGH0cVnH.cjs}

@@ -316,4 +316,4 @@ Object.defineProperty(exports, "__toESM", {
 	}
 });
 
-//# sourceMappingURL=FormContext-DsmS_mkO.cjs.map
+//# sourceMappingURL=FormContext-EGH0cVnH.cjs.map

package/dist/{FormContext-DsmS_mkO.cjs.map → FormContext-EGH0cVnH.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"FormContext-DsmS_mkO.cjs","names":["toValidationFormat","debug","React","toFormFormat","toSubmitFormat","HookFormProvider"],"sources":["../src/Form/subcomponents/FormResolver.ts","../src/Form/subcomponents/FormContext.tsx"],"sourcesContent":["import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { and, veto } from '@fuf-stack/veto';\n\nimport { toValidationFormat } from '../../helpers';\n\n/**\n * Hook that manages client validation schemas state.\n *\n * Provides a centralized way to add/remove dynamic validation schemas\n * that can be combined with base form validation.\n *\n * @returns Object with client validation state and memoized setter function\n */\nexport const useClientValidationManager = () => {\n  // Client validation schemas state\n  const [clientValidationSchemas, setClientValidationSchemas] = useState<\n    Record<string, VetoTypeAny>\n  >({});\n\n  // Memoized function to set/clear client validation schema\n  const setClientValidationSchema = useMemo(() => {\n    return (key: string, schema: VetoTypeAny | null) => {\n      // update client validation schemas\n      setClientValidationSchemas((prev) => {\n        // if no schema and no existing client validation schema for this key, do nothing\n        if (!prev[key] && !schema) {\n          return prev;\n        }\n        // if no schema, remove the client validation schema for this key\n        if (!schema) {\n          const { [key]: _removed, ...rest } = prev;\n          return rest;\n        }\n        // if schema, add or update the client validation schema for this key\n        return { ...prev, [key]: schema };\n      });\n    };\n  }, []);\n\n  return {\n    clientValidationSchemas,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates an extended validation instance combining base Veto validation with dynamic client validation.\n *\n * @param baseValidation - Optional base Veto validation schema\n * @returns Combined validation instance and client schema setter\n */\nexport const useExtendedValidation = (baseValidation?: VetoInstance) => {\n  // Setup client validation schemas\n  const { clientValidationSchemas, setClientValidationSchema } =\n    useClientValidationManager();\n\n  // Create a stable dependency array from the client validation schemas\n  const clientSchemaValues = useMemo<VetoTypeAny[]>(\n    () => {\n      const keys = Object.keys(clientValidationSchemas).sort();\n      return keys\n        .map((key) => {\n          return clientValidationSchemas[key];\n        })\n        .filter((schema): schema is VetoTypeAny => {\n          return Boolean(schema);\n        });\n    },\n    // Include the object identity to react to schema instance updates with same shape\n    [clientValidationSchemas],\n  );\n\n  // Memoized extended validation instance\n  const extendedValidation = useMemo(\n    () => {\n      const hasBaseValidation = !!baseValidation;\n      const hasClientSchemas = clientSchemaValues.length > 0;\n\n      // If no base validation and no client schemas, return undefined\n      if (!hasBaseValidation && !hasClientSchemas) {\n        return undefined;\n      }\n\n      // If no client schemas, return base validation\n      if (!hasClientSchemas) {\n        return baseValidation;\n      }\n\n      // Combine client validation schemas\n      const clientSchemasCombined =\n        clientSchemaValues.reduce<VetoTypeAny | null>(\n          (combined, clientSchema) => {\n            return combined ? and(combined, clientSchema) : clientSchema;\n          },\n          null,\n        );\n\n      // return combined validation\n      if (baseValidation && clientSchemasCombined) {\n        // Put client validation first so dynamic/domain-specific messages\n        // are returned before generic base validation errors.\n        const baseSchema = baseValidation.schema as VetoTypeAny;\n        return veto(and(clientSchemasCombined, baseSchema));\n      }\n\n      // If we only have client schemas, return them as a veto instance\n      if (clientSchemasCombined) {\n        return veto(clientSchemasCombined);\n      }\n\n      // This should not happen due to the conditions above, but just in case\n      return baseValidation;\n    },\n    // Recompute when validation schema instances change\n    [baseValidation, clientSchemaValues],\n  );\n\n  return {\n    extendedValidation,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Render state for formatted validation errors produced by the resolver.\n *\n * `errors` is the value exposed through Uniform context. `hash` is the stable\n * comparison key used to avoid re-rendering context consumers when validation\n * returns an equivalent error object with a new identity.\n */\ninterface ValidationErrorsState {\n  /** Formatted validation errors exposed to Uniform consumers. */\n  errors: VetoFormattedError | undefined;\n  /** JSON hash of `errors`, used as a cheap equality signal. */\n  hash: string | undefined;\n}\n\n/**\n * Creates a React Hook Form resolver from an extended validation instance and\n * stores its latest formatted Veto errors as React state.\n *\n * Keeping the resolver errors in state lets Uniform context consumers re-render\n * when validation output changes, while the hash prevents repeated validations\n * with equivalent errors from causing unnecessary updates.\n *\n * @param extendedValidation - Extended validation instance from useExtendedValidation\n * @returns Resolver function plus the latest validation errors and their hash\n */\nexport const useFormResolver = (extendedValidation?: VetoInstance) => {\n  // Keep the latest resolver errors in React state so Uniform context consumers\n  // re-render when validation output changes. The paired hash lets us skip the\n  // state update when a resolver run returns equivalent errors.\n  const [validationErrorsState, setValidationErrorsState] =\n    useState<ValidationErrorsState>({\n      errors: undefined,\n      hash: undefined,\n    });\n\n  /**\n   * Updates resolver error state only when the formatted validation result\n   * actually changes. Veto/RHF may create new error objects for equivalent\n   * validation output, so the hash is the guard against avoidable context\n   * refreshes.\n   */\n  const updateValidationErrors = useCallback(\n    (errors: VetoFormattedError | undefined): void => {\n      const nextHash = JSON.stringify(errors);\n\n      setValidationErrorsState((current) => {\n        if (current.hash === nextHash) {\n          return current;\n        }\n\n        return {\n          errors,\n          hash: nextHash,\n        };\n      });\n    },\n    [],\n  );\n\n  // Memoized resolver function for React Hook Form\n  const resolver = useMemo(() => {\n    if (!extendedValidation) {\n      return undefined;\n    }\n\n    return async (values: FieldValues) => {\n      const validationValues = toValidationFormat(values) ?? {};\n      const result = await extendedValidation.validateAsync(validationValues);\n      updateValidationErrors(result.errors ?? undefined);\n\n      // Transform veto result to React Hook Form format\n      return {\n        values: result.data ?? {},\n        errors: result.errors ?? {},\n      };\n    };\n  }, [extendedValidation, updateValidationErrors]);\n\n  return {\n    resolver,\n    validationErrors: validationErrorsState.errors,\n    validationErrorsHash: validationErrorsState.hash,\n  };\n};\n","import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { BaseSyntheticEvent, ReactNode } from 'react';\nimport type { FieldValues, Path, SubmitHandler } from 'react-hook-form';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport { FormProvider as HookFormProvider, useForm } from 'react-hook-form';\n\nimport createDebug from 'debug';\n\nimport { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toSubmitFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\n\nconst debug = createDebug('uniform:FormContext');\n\ntype DebugMode = 'debug' | 'debug-testids' | 'off' | 'disabled';\n\nexport interface DebugModeSettings {\n  /** disable form debug completely */\n  disable?: boolean;\n  /** custom localStorage key to save debug mode state */\n  localStorageKey?: string;\n}\n\n/** Listener function that gets called when a form reset is triggered */\nexport type FormResetListener = () => void;\n\n/**\n * Listener function that gets called when a field changes due to user input\n */\nexport type UserChangeListener<TFieldValues extends object = object> = (\n  fieldName: Path<TFieldValues>,\n  value: unknown,\n) => void;\n\nconst DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT = 'uniform:debug-mode';\n\n/**\n * The `UniformContext` provides control over the form's submission behavior and may optionally include\n * a Veto validation schema for form validation.\n *\n * Specifically, this context offers:\n * 1. **Form Submission Control**: The `preventSubmit` function allows components to enable or disable\n *    form submissions.\n * 2. **Optional Validation Schema**: The `validation` property may hold a Veto validation schema instance\n *    that can be used to validate form fields and handle validation logic.\n * 3. **Client Validation**: The `setClientValidationSchema` function allows setting dynamic client-side\n *    validation schemas that complement the base Veto validation.\n * 4. **User Change Tracking**: The `userChange` property provides a pub/sub system for tracking\n *    user-initiated field changes (typing, clicking, selecting) - NOT programmatic changes like\n *    form.reset() or form.setValue(). Used by the `useWatchUserChange` hook to enable reactive\n *    field dependencies.\n * 5. **Form Reset Tracking**: The `formReset` property provides a pub/sub system for tracking\n *    programmatic form resets triggered via the wrapped `reset()` from `useFormContext`.\n *    Used by hooks like `useWatchFormReset` to run reset-specific normalization logic.\n *\n * This context is useful for components that need to interact with or control the form submission state,\n * or access the validation schema for managing form validation logic.\n *\n * IMPORTANT: Context Singleton Pattern for HMR (Hot Module Replacement)\n * =====================================================================\n *\n * We use a global window variable to ensure only ONE context instance exists across\n * hot module reloads during development. This is critical because:\n *\n * **The Problem:**\n * When using Vite/Storybook with Fast Refresh (HMR), editing this file causes it to\n * be re-evaluated. Each re-evaluation runs `React.createContext()` again, creating a\n * NEW context instance. This leads to \"context instance mismatch\":\n *\n *   1. FormProvider (provider) loads and uses context instance A\n *   2. File is edited, HMR triggers\n *   3. SubmitButton (consumer) hot-reloads and imports context instance B\n *   4. Provider writes to instance A, Consumer reads from instance B\n *   5. Result: Consumer sees default values (triggerSubmit = () => undefined)\n *   6. Clicking submit does nothing because it calls the empty default function\n *\n * **The Solution:**\n * By storing the context in `window.__UNIFORM_CONTEXT__`, we ensure:\n *   - First load: Create context and store in window\n *   - Subsequent HMRs: Reuse the same context from window\n *   - All components always reference the SAME context instance\n *   - Provider and consumers can properly communicate\n *\n * **Why This Is Safe:**\n * - Only affects development (production has no HMR)\n * - Context type never changes (same interface)\n * - React handles cleanup on unmount normally\n * - No memory leaks (context is lightweight)\n *\n * Without this pattern, you'd need to restart the dev server after every edit\n * to FormContext.tsx to ensure all components use the same context instance.\n */\n\n// Define the context type\ninterface UniformContextType {\n  /** Form debug mode enabled or not */\n  debugMode: DebugMode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** Form reset tracking (programmatic reset calls) */\n  formReset: {\n    /**\n     * Subscribe to programmatic form resets.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: FormResetListener) => () => void;\n    /**\n     * Notify all subscribers about a programmatic form reset.\n     * Called from useFormContext when reset() is invoked.\n     */\n    notify: () => void;\n  };\n  /** Function to update if the form can currently be submitted */\n  preventSubmit: (prevent: boolean) => void;\n  /** Setter to enable or disable form debug mode */\n  setDebugMode: (debugMode: DebugMode) => void;\n  /** Function to trigger form submit programmatically */\n  triggerSubmit: (e?: BaseSyntheticEvent) => Promise<void> | void;\n  /** User change tracking (user input only, not programmatic changes) */\n  userChange: {\n    /**\n     * Subscribe to user field changes.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: UserChangeListener) => () => void;\n    /**\n     * Notify all subscribers about a user field change.\n     * Called from useController when user interacts with a field.\n     */\n    notify: (fieldName: string, value: unknown) => void;\n  };\n  /** Form validation configuration */\n  validation: {\n    /** Base validation schema instance (without client validation) */\n    baseInstance?: VetoInstance;\n    /** Veto validation schema instance for form validation */\n    instance?: VetoInstance;\n    /** Current validation errors in form */\n    errors?: VetoFormattedError;\n    /** Function to set client validation schema for a specific key */\n    setClientValidationSchema: (\n      key: string,\n      schema: VetoTypeAny | null,\n    ) => void;\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nif (!(window as any).__UNIFORM_CONTEXT__) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (window as any).__UNIFORM_CONTEXT__ = React.createContext<UniformContextType>(\n    {\n      debugMode: 'off',\n      formReset: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      preventSubmit: () => {\n        return undefined;\n      },\n      setDebugMode: () => {\n        return undefined;\n      },\n      triggerSubmit: () => {\n        return undefined;\n      },\n      userChange: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      validation: {\n        setClientValidationSchema: () => {\n          return undefined;\n        },\n      },\n    },\n  );\n  debug('Creating new UniformContext instance');\n} else {\n  debug(\n    'Reusing existing UniformContext instance from window.__UNIFORM_CONTEXT__',\n  );\n}\n\n// Export the singleton context instance from window\n// This ensures all imports get the same context, even after HMR\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const UniformContext = (window as any)\n  .__UNIFORM_CONTEXT__ as React.Context<UniformContextType>;\n\ndebug('UniformContext exported', {\n  contextExists: !!UniformContext,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  windowContextExists: !!(window as any).__UNIFORM_CONTEXT__,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextsMatch: UniformContext === (window as any).__UNIFORM_CONTEXT__,\n});\n\n// Define props for the internal FormProvider component\ninterface FormProviderProps {\n  /** children form render function */\n  children: (childProps: {\n    handleSubmit: (e?: BaseSyntheticEvent) => Promise<void>;\n    isValid: boolean;\n  }) => ReactNode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** Veto validation schema instance */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * FormProvider component provides:\n * - Veto validation schema context\n * - Resolver-backed validation error state\n * - Client validation schema management\n * - Submit handler with automatic data conversion and submission control with preventSubmit\n * - Form Debug Mode state\n * - Form reset pub/sub notifications (`formReset`)\n * - User change pub/sub notifications (`userChange`)\n * - React Hook Form context\n */\nconst FormProvider: React.FC<FormProviderProps> = ({\n  children,\n  debugModeSettings = undefined,\n  initialValues = undefined,\n  onSubmit,\n  validation: baseValidation = undefined,\n  validationTrigger,\n}) => {\n  // Form Debug mode state is handled in the form context\n  const [debugMode, setDebugMode] = useLocalStorage<DebugMode>(\n    debugModeSettings?.localStorageKey ?? DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT,\n    'off',\n  );\n\n  // Create extended validation combining base + client validations\n  const { extendedValidation, setClientValidationSchema } =\n    useExtendedValidation(baseValidation);\n\n  // Create resolver from extended validation + reactive validation error state\n  const { resolver, validationErrors, validationErrorsHash } =\n    useFormResolver(extendedValidation);\n\n  // Initialize react hook form with the resolver\n  const methods = useForm({\n    defaultValues: initialValues ? toFormFormat(initialValues) : initialValues,\n    // set rhf mode\n    // see: https://react-hook-form.com/docs/useform#mode\n    mode: validationTrigger,\n    resolver,\n  });\n\n  // Get isValid from React Hook Form's formState\n  const isValid = methods.formState?.isValid;\n\n  // Control if the form can currently be submitted\n  const [preventSubmit, setPreventSubmit] = useState(false);\n\n  // Form reset listener registry (stored in ref to avoid re-renders)\n  const formResetListenersRef = useRef<Set<FormResetListener>>(new Set());\n\n  // Subscribe to form reset notifications\n  const subscribeFormReset = useCallback(\n    (listener: FormResetListener): (() => void) => {\n      formResetListenersRef.current.add(listener);\n      return () => {\n        formResetListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about a programmatic form reset\n  const notifyFormReset = useCallback((): void => {\n    formResetListenersRef.current.forEach((listener) => {\n      listener();\n    });\n  }, []);\n\n  // User change listener registry (stored in ref to avoid re-renders)\n  const userChangeListenersRef = useRef<Set<UserChangeListener>>(new Set());\n\n  // Subscribe to user changes\n  const subscribeUserChange = useCallback(\n    (listener: UserChangeListener): (() => void) => {\n      userChangeListenersRef.current.add(listener);\n      // Return cleanup function to unsubscribe\n      return () => {\n        userChangeListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about user change\n  const notifyUserChange = useCallback(\n    (fieldName: string, value: unknown): void => {\n      // Notify all registered listeners\n      userChangeListenersRef.current.forEach((listener) => {\n        listener(fieldName as Path<object>, value);\n      });\n    },\n    [],\n  );\n\n  // Create submit handler with automatic data conversion\n  // eslint-disable-next-line consistent-return\n  const handleSubmit = async (e?: React.BaseSyntheticEvent) => {\n    debug('handleSubmit called', {\n      preventSubmit,\n      formStateIsValid: methods.formState.isValid,\n      validationErrors: methods.formState.errors,\n      validationTrigger,\n      formValues: methods.getValues(),\n    });\n\n    // only prevent submit when form state is valid, because otherwise\n    // submit will only trigger validation and add errors / focus invalid fields\n    if (methods.formState.isValid && preventSubmit) {\n      debug('⛔ Form submit PREVENTED', {\n        formStateIsValid: methods.formState.isValid,\n        preventSubmit,\n      });\n      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\n    }\n\n    debug('✓ Form submit ALLOWED', {\n      formStateIsValid: methods.formState.isValid,\n      preventSubmit,\n      reason: !methods.formState.isValid\n        ? 'Form is invalid (will trigger validation and show errors)'\n        : 'Form is valid and preventSubmit is false',\n    });\n\n    // Convert form data to submission format:\n    // - Unwrap flat array wrappers and convert markers\n    // - Remove empty strings, nulls, empty arrays, and empty objects\n    const wrappedOnSubmit = (data: FieldValues, event?: BaseSyntheticEvent) => {\n      const submitData = toSubmitFormat(data) ?? {};\n      debug('onSubmit callback called', { submitData });\n      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\n\n    debug('handleSubmit completed');\n  };\n\n  // Memoize the context value so consumers only re-render when context-relevant\n  // state changes, including resolver-backed validation errors.\n  const contextValue = useMemo(\n    () => {\n      return {\n        // set debugMode to disabled when debugModeSettings.disable is true\n        // otherwise use current debug mode from localStorage\n        debugMode: debugModeSettings?.disable ? 'disabled' : debugMode,\n        preventSubmit: (prevent: boolean) => {\n          debug('preventSubmit called', {\n            previousValue: preventSubmit,\n            newValue: prevent,\n            formStateIsValid: methods.formState.isValid,\n            validationErrors: methods.formState.errors,\n          });\n          setPreventSubmit(prevent);\n        },\n        setClientValidationSchema,\n        setDebugMode,\n        triggerSubmit: handleSubmit,\n        formReset: {\n          subscribe: subscribeFormReset,\n          notify: notifyFormReset,\n        },\n        userChange: {\n          subscribe: subscribeUserChange,\n          notify: notifyUserChange,\n        },\n        validation: {\n          baseInstance: baseValidation,\n          instance: extendedValidation,\n          errors: validationErrors,\n          setClientValidationSchema,\n        },\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [debugMode, debugModeSettings?.disable, validationErrorsHash],\n  );\n\n  return (\n    <UniformContext.Provider value={contextValue}>\n      {/* Spread all hook form props into HookFormProvider */}\n      <HookFormProvider {...methods}>\n        {children({ handleSubmit, isValid })}\n      </HookFormProvider>\n    </UniformContext.Provider>\n  );\n};\n\nexport default FormProvider;\n"],"mappings":"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"}
+{"version":3,"file":"FormContext-EGH0cVnH.cjs","names":["toValidationFormat","debug","React","toFormFormat","toSubmitFormat","HookFormProvider"],"sources":["../src/Form/subcomponents/FormResolver.ts","../src/Form/subcomponents/FormContext.tsx"],"sourcesContent":["import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { and, veto } from '@fuf-stack/veto';\n\nimport { toValidationFormat } from '../../helpers';\n\n/**\n * Hook that manages client validation schemas state.\n *\n * Provides a centralized way to add/remove dynamic validation schemas\n * that can be combined with base form validation.\n *\n * @returns Object with client validation state and memoized setter function\n */\nexport const useClientValidationManager = () => {\n  // Client validation schemas state\n  const [clientValidationSchemas, setClientValidationSchemas] = useState<\n    Record<string, VetoTypeAny>\n  >({});\n\n  // Memoized function to set/clear client validation schema\n  const setClientValidationSchema = useMemo(() => {\n    return (key: string, schema: VetoTypeAny | null) => {\n      // update client validation schemas\n      setClientValidationSchemas((prev) => {\n        // if no schema and no existing client validation schema for this key, do nothing\n        if (!prev[key] && !schema) {\n          return prev;\n        }\n        // if no schema, remove the client validation schema for this key\n        if (!schema) {\n          const { [key]: _removed, ...rest } = prev;\n          return rest;\n        }\n        // if schema, add or update the client validation schema for this key\n        return { ...prev, [key]: schema };\n      });\n    };\n  }, []);\n\n  return {\n    clientValidationSchemas,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates an extended validation instance combining base Veto validation with dynamic client validation.\n *\n * @param baseValidation - Optional base Veto validation schema\n * @returns Combined validation instance and client schema setter\n */\nexport const useExtendedValidation = (baseValidation?: VetoInstance) => {\n  // Setup client validation schemas\n  const { clientValidationSchemas, setClientValidationSchema } =\n    useClientValidationManager();\n\n  // Create a stable dependency array from the client validation schemas\n  const clientSchemaValues = useMemo<VetoTypeAny[]>(\n    () => {\n      const keys = Object.keys(clientValidationSchemas).sort();\n      return keys\n        .map((key) => {\n          return clientValidationSchemas[key];\n        })\n        .filter((schema): schema is VetoTypeAny => {\n          return Boolean(schema);\n        });\n    },\n    // Include the object identity to react to schema instance updates with same shape\n    [clientValidationSchemas],\n  );\n\n  // Memoized extended validation instance\n  const extendedValidation = useMemo(\n    () => {\n      const hasBaseValidation = !!baseValidation;\n      const hasClientSchemas = clientSchemaValues.length > 0;\n\n      // If no base validation and no client schemas, return undefined\n      if (!hasBaseValidation && !hasClientSchemas) {\n        return undefined;\n      }\n\n      // If no client schemas, return base validation\n      if (!hasClientSchemas) {\n        return baseValidation;\n      }\n\n      // Combine client validation schemas\n      const clientSchemasCombined =\n        clientSchemaValues.reduce<VetoTypeAny | null>(\n          (combined, clientSchema) => {\n            return combined ? and(combined, clientSchema) : clientSchema;\n          },\n          null,\n        );\n\n      // return combined validation\n      if (baseValidation && clientSchemasCombined) {\n        // Put client validation first so dynamic/domain-specific messages\n        // are returned before generic base validation errors.\n        const baseSchema = baseValidation.schema as VetoTypeAny;\n        return veto(and(clientSchemasCombined, baseSchema));\n      }\n\n      // If we only have client schemas, return them as a veto instance\n      if (clientSchemasCombined) {\n        return veto(clientSchemasCombined);\n      }\n\n      // This should not happen due to the conditions above, but just in case\n      return baseValidation;\n    },\n    // Recompute when validation schema instances change\n    [baseValidation, clientSchemaValues],\n  );\n\n  return {\n    extendedValidation,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Render state for formatted validation errors produced by the resolver.\n *\n * `errors` is the value exposed through Uniform context. `hash` is the stable\n * comparison key used to avoid re-rendering context consumers when validation\n * returns an equivalent error object with a new identity.\n */\ninterface ValidationErrorsState {\n  /** Formatted validation errors exposed to Uniform consumers. */\n  errors: VetoFormattedError | undefined;\n  /** JSON hash of `errors`, used as a cheap equality signal. */\n  hash: string | undefined;\n}\n\n/**\n * Creates a React Hook Form resolver from an extended validation instance and\n * stores its latest formatted Veto errors as React state.\n *\n * Keeping the resolver errors in state lets Uniform context consumers re-render\n * when validation output changes, while the hash prevents repeated validations\n * with equivalent errors from causing unnecessary updates.\n *\n * @param extendedValidation - Extended validation instance from useExtendedValidation\n * @returns Resolver function plus the latest validation errors and their hash\n */\nexport const useFormResolver = (extendedValidation?: VetoInstance) => {\n  // Keep the latest resolver errors in React state so Uniform context consumers\n  // re-render when validation output changes. The paired hash lets us skip the\n  // state update when a resolver run returns equivalent errors.\n  const [validationErrorsState, setValidationErrorsState] =\n    useState<ValidationErrorsState>({\n      errors: undefined,\n      hash: undefined,\n    });\n\n  /**\n   * Updates resolver error state only when the formatted validation result\n   * actually changes. Veto/RHF may create new error objects for equivalent\n   * validation output, so the hash is the guard against avoidable context\n   * refreshes.\n   */\n  const updateValidationErrors = useCallback(\n    (errors: VetoFormattedError | undefined): void => {\n      const nextHash = JSON.stringify(errors);\n\n      setValidationErrorsState((current) => {\n        if (current.hash === nextHash) {\n          return current;\n        }\n\n        return {\n          errors,\n          hash: nextHash,\n        };\n      });\n    },\n    [],\n  );\n\n  // Memoized resolver function for React Hook Form\n  const resolver = useMemo(() => {\n    if (!extendedValidation) {\n      return undefined;\n    }\n\n    return async (values: FieldValues) => {\n      const validationValues = toValidationFormat(values) ?? {};\n      const result = await extendedValidation.validateAsync(validationValues);\n      updateValidationErrors(result.errors ?? undefined);\n\n      // Transform veto result to React Hook Form format\n      return {\n        values: result.data ?? {},\n        errors: result.errors ?? {},\n      };\n    };\n  }, [extendedValidation, updateValidationErrors]);\n\n  return {\n    resolver,\n    validationErrors: validationErrorsState.errors,\n    validationErrorsHash: validationErrorsState.hash,\n  };\n};\n","import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { BaseSyntheticEvent, ReactNode } from 'react';\nimport type { FieldValues, Path, SubmitHandler } from 'react-hook-form';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport { FormProvider as HookFormProvider, useForm } from 'react-hook-form';\n\nimport createDebug from 'debug';\n\nimport { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toSubmitFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\n\nconst debug = createDebug('uniform:FormContext');\n\ntype DebugMode = 'debug' | 'debug-testids' | 'off' | 'disabled';\n\nexport interface DebugModeSettings {\n  /** disable form debug completely */\n  disable?: boolean;\n  /** custom localStorage key to save debug mode state */\n  localStorageKey?: string;\n}\n\n/** Listener function that gets called when a form reset is triggered */\nexport type FormResetListener = () => void;\n\n/**\n * Listener function that gets called when a field changes due to user input\n */\nexport type UserChangeListener<TFieldValues extends object = object> = (\n  fieldName: Path<TFieldValues>,\n  value: unknown,\n) => void;\n\nconst DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT = 'uniform:debug-mode';\n\n/**\n * The `UniformContext` provides control over the form's submission behavior and may optionally include\n * a Veto validation schema for form validation.\n *\n * Specifically, this context offers:\n * 1. **Form Submission Control**: The `preventSubmit` function allows components to enable or disable\n *    form submissions.\n * 2. **Optional Validation Schema**: The `validation` property may hold a Veto validation schema instance\n *    that can be used to validate form fields and handle validation logic.\n * 3. **Client Validation**: The `setClientValidationSchema` function allows setting dynamic client-side\n *    validation schemas that complement the base Veto validation.\n * 4. **User Change Tracking**: The `userChange` property provides a pub/sub system for tracking\n *    user-initiated field changes (typing, clicking, selecting) - NOT programmatic changes like\n *    form.reset() or form.setValue(). Used by the `useWatchUserChange` hook to enable reactive\n *    field dependencies.\n * 5. **Form Reset Tracking**: The `formReset` property provides a pub/sub system for tracking\n *    programmatic form resets triggered via the wrapped `reset()` from `useFormContext`.\n *    Used by hooks like `useWatchFormReset` to run reset-specific normalization logic.\n *\n * This context is useful for components that need to interact with or control the form submission state,\n * or access the validation schema for managing form validation logic.\n *\n * IMPORTANT: Context Singleton Pattern for HMR (Hot Module Replacement)\n * =====================================================================\n *\n * We use a global window variable to ensure only ONE context instance exists across\n * hot module reloads during development. This is critical because:\n *\n * **The Problem:**\n * When using Vite/Storybook with Fast Refresh (HMR), editing this file causes it to\n * be re-evaluated. Each re-evaluation runs `React.createContext()` again, creating a\n * NEW context instance. This leads to \"context instance mismatch\":\n *\n *   1. FormProvider (provider) loads and uses context instance A\n *   2. File is edited, HMR triggers\n *   3. SubmitButton (consumer) hot-reloads and imports context instance B\n *   4. Provider writes to instance A, Consumer reads from instance B\n *   5. Result: Consumer sees default values (triggerSubmit = () => undefined)\n *   6. Clicking submit does nothing because it calls the empty default function\n *\n * **The Solution:**\n * By storing the context in `window.__UNIFORM_CONTEXT__`, we ensure:\n *   - First load: Create context and store in window\n *   - Subsequent HMRs: Reuse the same context from window\n *   - All components always reference the SAME context instance\n *   - Provider and consumers can properly communicate\n *\n * **Why This Is Safe:**\n * - Only affects development (production has no HMR)\n * - Context type never changes (same interface)\n * - React handles cleanup on unmount normally\n * - No memory leaks (context is lightweight)\n *\n * Without this pattern, you'd need to restart the dev server after every edit\n * to FormContext.tsx to ensure all components use the same context instance.\n */\n\n// Define the context type\ninterface UniformContextType {\n  /** Form debug mode enabled or not */\n  debugMode: DebugMode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** Form reset tracking (programmatic reset calls) */\n  formReset: {\n    /**\n     * Subscribe to programmatic form resets.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: FormResetListener) => () => void;\n    /**\n     * Notify all subscribers about a programmatic form reset.\n     * Called from useFormContext when reset() is invoked.\n     */\n    notify: () => void;\n  };\n  /** Function to update if the form can currently be submitted */\n  preventSubmit: (prevent: boolean) => void;\n  /** Setter to enable or disable form debug mode */\n  setDebugMode: (debugMode: DebugMode) => void;\n  /** Function to trigger form submit programmatically */\n  triggerSubmit: (e?: BaseSyntheticEvent) => Promise<void> | void;\n  /** User change tracking (user input only, not programmatic changes) */\n  userChange: {\n    /**\n     * Subscribe to user field changes.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: UserChangeListener) => () => void;\n    /**\n     * Notify all subscribers about a user field change.\n     * Called from useController when user interacts with a field.\n     */\n    notify: (fieldName: string, value: unknown) => void;\n  };\n  /** Form validation configuration */\n  validation: {\n    /** Base validation schema instance (without client validation) */\n    baseInstance?: VetoInstance;\n    /** Veto validation schema instance for form validation */\n    instance?: VetoInstance;\n    /** Current validation errors in form */\n    errors?: VetoFormattedError;\n    /** Function to set client validation schema for a specific key */\n    setClientValidationSchema: (\n      key: string,\n      schema: VetoTypeAny | null,\n    ) => void;\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nif (!(window as any).__UNIFORM_CONTEXT__) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (window as any).__UNIFORM_CONTEXT__ = React.createContext<UniformContextType>(\n    {\n      debugMode: 'off',\n      formReset: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      preventSubmit: () => {\n        return undefined;\n      },\n      setDebugMode: () => {\n        return undefined;\n      },\n      triggerSubmit: () => {\n        return undefined;\n      },\n      userChange: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      validation: {\n        setClientValidationSchema: () => {\n          return undefined;\n        },\n      },\n    },\n  );\n  debug('Creating new UniformContext instance');\n} else {\n  debug(\n    'Reusing existing UniformContext instance from window.__UNIFORM_CONTEXT__',\n  );\n}\n\n// Export the singleton context instance from window\n// This ensures all imports get the same context, even after HMR\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const UniformContext = (window as any)\n  .__UNIFORM_CONTEXT__ as React.Context<UniformContextType>;\n\ndebug('UniformContext exported', {\n  contextExists: !!UniformContext,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  windowContextExists: !!(window as any).__UNIFORM_CONTEXT__,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextsMatch: UniformContext === (window as any).__UNIFORM_CONTEXT__,\n});\n\n// Define props for the internal FormProvider component\ninterface FormProviderProps {\n  /** children form render function */\n  children: (childProps: {\n    handleSubmit: (e?: BaseSyntheticEvent) => Promise<void>;\n    isValid: boolean;\n  }) => ReactNode;\n  /** settings for form debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** Veto validation schema instance */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * FormProvider component provides:\n * - Veto validation schema context\n * - Resolver-backed validation error state\n * - Client validation schema management\n * - Submit handler with automatic data conversion and submission control with preventSubmit\n * - Form Debug Mode state\n * - Form reset pub/sub notifications (`formReset`)\n * - User change pub/sub notifications (`userChange`)\n * - React Hook Form context\n */\nconst FormProvider: React.FC<FormProviderProps> = ({\n  children,\n  debugModeSettings = undefined,\n  initialValues = undefined,\n  onSubmit,\n  validation: baseValidation = undefined,\n  validationTrigger,\n}) => {\n  // Form Debug mode state is handled in the form context\n  const [debugMode, setDebugMode] = useLocalStorage<DebugMode>(\n    debugModeSettings?.localStorageKey ?? DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT,\n    'off',\n  );\n\n  // Create extended validation combining base + client validations\n  const { extendedValidation, setClientValidationSchema } =\n    useExtendedValidation(baseValidation);\n\n  // Create resolver from extended validation + reactive validation error state\n  const { resolver, validationErrors, validationErrorsHash } =\n    useFormResolver(extendedValidation);\n\n  // Initialize react hook form with the resolver\n  const methods = useForm({\n    defaultValues: initialValues ? toFormFormat(initialValues) : initialValues,\n    // set rhf mode\n    // see: https://react-hook-form.com/docs/useform#mode\n    mode: validationTrigger,\n    resolver,\n  });\n\n  // Get isValid from React Hook Form's formState\n  const isValid = methods.formState?.isValid;\n\n  // Control if the form can currently be submitted\n  const [preventSubmit, setPreventSubmit] = useState(false);\n\n  // Form reset listener registry (stored in ref to avoid re-renders)\n  const formResetListenersRef = useRef<Set<FormResetListener>>(new Set());\n\n  // Subscribe to form reset notifications\n  const subscribeFormReset = useCallback(\n    (listener: FormResetListener): (() => void) => {\n      formResetListenersRef.current.add(listener);\n      return () => {\n        formResetListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about a programmatic form reset\n  const notifyFormReset = useCallback((): void => {\n    formResetListenersRef.current.forEach((listener) => {\n      listener();\n    });\n  }, []);\n\n  // User change listener registry (stored in ref to avoid re-renders)\n  const userChangeListenersRef = useRef<Set<UserChangeListener>>(new Set());\n\n  // Subscribe to user changes\n  const subscribeUserChange = useCallback(\n    (listener: UserChangeListener): (() => void) => {\n      userChangeListenersRef.current.add(listener);\n      // Return cleanup function to unsubscribe\n      return () => {\n        userChangeListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about user change\n  const notifyUserChange = useCallback(\n    (fieldName: string, value: unknown): void => {\n      // Notify all registered listeners\n      userChangeListenersRef.current.forEach((listener) => {\n        listener(fieldName as Path<object>, value);\n      });\n    },\n    [],\n  );\n\n  // Create submit handler with automatic data conversion\n  // eslint-disable-next-line consistent-return\n  const handleSubmit = async (e?: React.BaseSyntheticEvent) => {\n    debug('handleSubmit called', {\n      preventSubmit,\n      formStateIsValid: methods.formState.isValid,\n      validationErrors: methods.formState.errors,\n      validationTrigger,\n      formValues: methods.getValues(),\n    });\n\n    // only prevent submit when form state is valid, because otherwise\n    // submit will only trigger validation and add errors / focus invalid fields\n    if (methods.formState.isValid && preventSubmit) {\n      debug('⛔ Form submit PREVENTED', {\n        formStateIsValid: methods.formState.isValid,\n        preventSubmit,\n      });\n      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\n    }\n\n    debug('✓ Form submit ALLOWED', {\n      formStateIsValid: methods.formState.isValid,\n      preventSubmit,\n      reason: !methods.formState.isValid\n        ? 'Form is invalid (will trigger validation and show errors)'\n        : 'Form is valid and preventSubmit is false',\n    });\n\n    // Convert form data to submission format:\n    // - Unwrap flat array wrappers and convert markers\n    // - Remove empty strings, nulls, empty arrays, and empty objects\n    const wrappedOnSubmit = (data: FieldValues, event?: BaseSyntheticEvent) => {\n      const submitData = toSubmitFormat(data) ?? {};\n      debug('onSubmit callback called', { submitData });\n      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\n\n    debug('handleSubmit completed');\n  };\n\n  // Memoize the context value so consumers only re-render when context-relevant\n  // state changes, including resolver-backed validation errors.\n  const contextValue = useMemo(\n    () => {\n      return {\n        // set debugMode to disabled when debugModeSettings.disable is true\n        // otherwise use current debug mode from localStorage\n        debugMode: debugModeSettings?.disable ? 'disabled' : debugMode,\n        preventSubmit: (prevent: boolean) => {\n          debug('preventSubmit called', {\n            previousValue: preventSubmit,\n            newValue: prevent,\n            formStateIsValid: methods.formState.isValid,\n            validationErrors: methods.formState.errors,\n          });\n          setPreventSubmit(prevent);\n        },\n        setClientValidationSchema,\n        setDebugMode,\n        triggerSubmit: handleSubmit,\n        formReset: {\n          subscribe: subscribeFormReset,\n          notify: notifyFormReset,\n        },\n        userChange: {\n          subscribe: subscribeUserChange,\n          notify: notifyUserChange,\n        },\n        validation: {\n          baseInstance: baseValidation,\n          instance: extendedValidation,\n          errors: validationErrors,\n          setClientValidationSchema,\n        },\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [debugMode, debugModeSettings?.disable, validationErrorsHash],\n  );\n\n  return (\n    <UniformContext.Provider value={contextValue}>\n      {/* Spread all hook form props into HookFormProvider */}\n      <HookFormProvider {...methods}>\n        {children({ handleSubmit, isValid })}\n      </HookFormProvider>\n    </UniformContext.Provider>\n  );\n};\n\nexport default FormProvider;\n"],"mappings":"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"}

package/dist/{FormContext-i66vM5f1.d.ts → FormContext-LgzrDWu1.d.ts}

@@ -17,4 +17,4 @@ type FormResetListener = () => void;
 type UserChangeListener<TFieldValues extends object = object> = (fieldName: Path<TFieldValues>, value: unknown) => void;
 //#endregion
 export { FormResetListener as n, UserChangeListener as r, DebugModeSettings as t };
-//# sourceMappingURL=FormContext-i66vM5f1.d.ts.map
+//# sourceMappingURL=FormContext-LgzrDWu1.d.ts.map

package/dist/{FormContext-i66vM5f1.d.ts.map → FormContext-LgzrDWu1.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"FormContext-i66vM5f1.d.ts","names":[],"sources":["../src/Form/subcomponents/FormContext.tsx"],"mappings":";;;;;UAsBiB,iBAAA;EAAiB;EAEhC,OAAA;EAAA;EAEA,eAAe;AAAA;;KAIL,iBAAA;;AAAiB;AAK7B;KAAY,kBAAA,0CACV,SAAA,EAAW,IAAI,CAAC,YAAA,GAChB,KAAA"}
+{"version":3,"file":"FormContext-LgzrDWu1.d.ts","names":[],"sources":["../src/Form/subcomponents/FormContext.tsx"],"mappings":";;;;;UAsBiB,iBAAA;EAAiB;EAEhC,OAAA;EAAA;EAEA,eAAe;AAAA;;KAIL,iBAAA;;AAAiB;AAK7B;KAAY,kBAAA,0CACV,SAAA,EAAW,IAAI,CAAC,YAAA,GAChB,KAAA"}

package/dist/Grid/index.cjs

@@ -2,6 +2,5 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_Grid = require("../Grid-D-VcRGi9.cjs");
-exports.Grid = require_Grid.Grid;
+const require_Grid = require("../Grid-BbqCRkuY.cjs");
 exports.default = require_Grid.Grid_default;

package/dist/Grid/index.d.cts

@@ -1,2 +1,22 @@
-import { n as GridProps, t as Grid } from "../index-BqxDWhNr.cjs";
-export { Grid, Grid as default, type GridProps };
+import { ReactNode } from "react";
+
+//#region src/Grid/Grid.d.ts
+interface GridProps {
+  /** child components */
+  children?: ReactNode;
+  /** CSS class name */
+  className?: string;
+  /** HTML data-testid attribute used in e2e tests */
+  testId?: string;
+}
+/**
+ * Defines the default grid for form components
+ */
+declare const Grid: ({
+  children,
+  className,
+  testId
+}: GridProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { type GridProps, Grid as default };
+//# sourceMappingURL=index.d.cts.map

package/dist/Grid/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/Grid/Grid.tsx"],"mappings":";;;UAIiB,SAAA;;EAEf,QAAA,GAAW,SAAS;EAFI;EAIxB,SAAA;EAFoB;EAIpB,MAAA;AAAA;;;;cAMI,IAAA;EAAQ,QAAA;EAAA,SAAA;EAAA;AAAA,GAIX,SAAA,iCAAS,GAAA,CAAA,OAAA"}

package/dist/Grid/index.d.ts

@@ -1,2 +1,22 @@
-import { n as GridProps, t as Grid } from "../index-PWRw2bPH.js";
-export { Grid, Grid as default, type GridProps };
+import { ReactNode } from "react";
+
+//#region src/Grid/Grid.d.ts
+interface GridProps {
+  /** child components */
+  children?: ReactNode;
+  /** CSS class name */
+  className?: string;
+  /** HTML data-testid attribute used in e2e tests */
+  testId?: string;
+}
+/**
+ * Defines the default grid for form components
+ */
+declare const Grid: ({
+  children,
+  className,
+  testId
+}: GridProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { type GridProps, Grid as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/Grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/Grid/Grid.tsx"],"mappings":";;;UAIiB,SAAA;;EAEf,QAAA,GAAW,SAAS;EAFI;EAIxB,SAAA;EAFoB;EAIpB,MAAA;AAAA;;;;cAMI,IAAA;EAAQ,QAAA;EAAA,SAAA;EAAA;AAAA,GAIX,SAAA,iCAAS,GAAA,CAAA,OAAA"}

package/dist/Grid/index.js

@@ -1,2 +1,2 @@
-import { n as Grid, t as Grid_default } from "../Grid-BQpLOB0G.js";
-export { Grid, Grid_default as default };
+import { t as Grid_default } from "../Grid-CTs-Rb9G.js";
+export { Grid_default as default };

package/dist/{Grid-D-VcRGi9.cjs → Grid-BbqCRkuY.cjs}

@@ -1,4 +1,3 @@
-require("./FormContext-DsmS_mkO.cjs");
 let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/Grid/Grid.tsx
@@ -16,12 +15,6 @@ const Grid = ({ children = null, className = void 0, testId = void 0 }) => {
 //#region src/Grid/index.ts
 var Grid_default = Grid;
 //#endregion
-Object.defineProperty(exports, "Grid", {
-	enumerable: true,
-	get: function() {
-		return Grid;
-	}
-});
 Object.defineProperty(exports, "Grid_default", {
 	enumerable: true,
 	get: function() {
@@ -29,4 +22,4 @@ Object.defineProperty(exports, "Grid_default", {
 	}
 });
 
-//# sourceMappingURL=Grid-D-VcRGi9.cjs.map
+//# sourceMappingURL=Grid-BbqCRkuY.cjs.map

package/dist/{Grid-D-VcRGi9.cjs.map → Grid-BbqCRkuY.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"Grid-D-VcRGi9.cjs","names":[],"sources":["../src/Grid/Grid.tsx","../src/Grid/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\nexport interface GridProps {\n  /** child components */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * Defines the default grid for form components\n */\nconst Grid = ({\n  children = null,\n  className = undefined,\n  testId = undefined,\n}: GridProps) => {\n  return (\n    <div className={cn('grid gap-6', className)} data-testid={testId}>\n      {children}\n    </div>\n  );\n};\n\nexport default Grid;\n","import Grid from './Grid';\n\nexport type { GridProps } from './Grid';\n\nexport { Grid };\n\nexport default Grid;\n"],"mappings":";;;;;;;AAgBA,MAAM,QAAQ,EACZ,WAAW,MACX,YAAY,KAAA,GACZ,SAAS,KAAA,QACM;CACf,OACE,iBAAA,GAAA,kBAAA,KAAC,OAAD;EAAK,YAAA,GAAA,uBAAA,IAAc,cAAc,SAAS;EAAG,eAAa;EACvD;CACE,CAAA;AAET;;;ACpBA,IAAA,eAAe"}
+{"version":3,"file":"Grid-BbqCRkuY.cjs","names":[],"sources":["../src/Grid/Grid.tsx","../src/Grid/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\nexport interface GridProps {\n  /** child components */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * Defines the default grid for form components\n */\nconst Grid = ({\n  children = null,\n  className = undefined,\n  testId = undefined,\n}: GridProps) => {\n  return (\n    <div className={cn('grid gap-6', className)} data-testid={testId}>\n      {children}\n    </div>\n  );\n};\n\nexport default Grid;\n","import Grid from './Grid';\n\nexport type { GridProps } from './Grid';\n\nexport default Grid;\n"],"mappings":";;;;;;AAgBA,MAAM,QAAQ,EACZ,WAAW,MACX,YAAY,KAAA,GACZ,SAAS,KAAA,QACM;CACf,OACE,iBAAA,GAAA,kBAAA,KAAC,OAAD;EAAK,YAAA,GAAA,uBAAA,IAAc,cAAc,SAAS;EAAG,eAAa;EACvD;CACE,CAAA;AAET;;;ACtBA,IAAA,eAAe"}

package/dist/{Grid-BQpLOB0G.js → Grid-CTs-Rb9G.js}

@@ -15,6 +15,6 @@ const Grid = ({ children = null, className = void 0, testId = void 0 }) => {
 //#region src/Grid/index.ts
 var Grid_default = Grid;
 //#endregion
-export { Grid as n, Grid_default as t };
+export { Grid_default as t };
 
-//# sourceMappingURL=Grid-BQpLOB0G.js.map
+//# sourceMappingURL=Grid-CTs-Rb9G.js.map

package/dist/{Grid-BQpLOB0G.js.map → Grid-CTs-Rb9G.js.map}

@@ -1 +1 @@
-{"version":3,"file":"Grid-BQpLOB0G.js","names":[],"sources":["../src/Grid/Grid.tsx","../src/Grid/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\nexport interface GridProps {\n  /** child components */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * Defines the default grid for form components\n */\nconst Grid = ({\n  children = null,\n  className = undefined,\n  testId = undefined,\n}: GridProps) => {\n  return (\n    <div className={cn('grid gap-6', className)} data-testid={testId}>\n      {children}\n    </div>\n  );\n};\n\nexport default Grid;\n","import Grid from './Grid';\n\nexport type { GridProps } from './Grid';\n\nexport { Grid };\n\nexport default Grid;\n"],"mappings":";;;;;;AAgBA,MAAM,QAAQ,EACZ,WAAW,MACX,YAAY,KAAA,GACZ,SAAS,KAAA,QACM;CACf,OACE,oBAAC,OAAD;EAAK,WAAW,GAAG,cAAc,SAAS;EAAG,eAAa;EACvD;CACE,CAAA;AAET;;;ACpBA,IAAA,eAAe"}
+{"version":3,"file":"Grid-CTs-Rb9G.js","names":[],"sources":["../src/Grid/Grid.tsx","../src/Grid/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\nexport interface GridProps {\n  /** child components */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * Defines the default grid for form components\n */\nconst Grid = ({\n  children = null,\n  className = undefined,\n  testId = undefined,\n}: GridProps) => {\n  return (\n    <div className={cn('grid gap-6', className)} data-testid={testId}>\n      {children}\n    </div>\n  );\n};\n\nexport default Grid;\n","import Grid from './Grid';\n\nexport type { GridProps } from './Grid';\n\nexport default Grid;\n"],"mappings":";;;;;;AAgBA,MAAM,QAAQ,EACZ,WAAW,MACX,YAAY,KAAA,GACZ,SAAS,KAAA,QACM;CACf,OACE,oBAAC,OAAD;EAAK,WAAW,GAAG,cAAc,SAAS;EAAG,eAAa;EACvD;CACE,CAAA;AAET;;;ACtBA,IAAA,eAAe"}

package/dist/Input/index.cjs

@@ -2,6 +2,99 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_Input = require("../Input-DvVViuWH.cjs");
-exports.Input = require_Input.Input;
-exports.default = require_Input.Input_default;
+const require_hooks_useUniformField_index = require("../hooks/useUniformField/index.cjs");
+const require_hooks_useInputValueDebounce_index = require("../hooks/useInputValueDebounce/index.cjs");
+let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _heroui_input = require("@heroui/input");
+let _heroui_number_input = require("@heroui/number-input");
+//#region src/Input/Input.tsx
+const inputVariants = (0, _fuf_stack_pixel_utils.tv)({ slots: {
+	/** wrapper around the whole input */
+	base: "",
+	/** clear button */
+	clearButton: "",
+	/** actual input element */
+	input: "",
+	/** inner wrapper (HeroUI inputWrapper slot) */
+	inputWrapper: "bg-content1 group-data-[focus=true]:border-focus"
+} });
+/**
+* Input component based on [HeroUI Input](https://www.heroui.com//docs/components/input)
+*/
+const Input = ({ className: _className = void 0, clearable = false, debounceDelay = 300, endContent = void 0, name, onClear = void 0, placeholder = " ", size = void 0, startContent = void 0, type = void 0, ...uniformFieldProps }) => {
+	const { ariaLabel, disabled, field: { onChange: fieldOnChange, onBlur: fieldOnBlur, value: fieldValue, ref }, errorMessage, invalid, label, required, testId, resetField } = require_hooks_useUniformField_index.useUniformField({
+		name,
+		type,
+		...uniformFieldProps
+	});
+	const { onChange, onBlur, value } = require_hooks_useInputValueDebounce_index.useInputValueDebounce({
+		debounceDelay,
+		name,
+		onBlur: fieldOnBlur,
+		onChange: fieldOnChange,
+		value: fieldValue
+	});
+	const clearableProps = clearable ? {
+		isClearable: true,
+		onClear: () => {
+			resetField(name, { defaultValue: null });
+			if (onClear) onClear();
+		}
+	} : {};
+	const classNames = (0, _fuf_stack_pixel_utils.variantsToClassNames)(inputVariants(), _className, "base");
+	const commonProps = {
+		ref,
+		"aria-label": !placeholder || placeholder.trim() === "" ? ariaLabel : void 0,
+		autoComplete: "off",
+		classNames: {
+			base: classNames.base,
+			clearButton: classNames.clearButton,
+			helperWrapper: "p-0",
+			input: classNames.input,
+			inputWrapper: classNames.inputWrapper
+		},
+		"data-testid": testId,
+		endContent,
+		errorMessage,
+		id: testId,
+		isDisabled: disabled,
+		isInvalid: invalid,
+		isRequired: required,
+		label,
+		labelPlacement: "outside",
+		name,
+		onBlur,
+		placeholder,
+		radius: "sm",
+		size,
+		startContent,
+		variant: "bordered",
+		...clearableProps
+	};
+	if (type === "number") {
+		const numberValue = value !== "" && value != null && !Number.isNaN(Number(value)) ? Number(value) : null;
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_heroui_number_input.NumberInput, {
+			...commonProps,
+			formatOptions: { useGrouping: false },
+			onChange: (e) => {
+				if (typeof e === "number") onChange({ target: { value: String(e) } });
+				else onChange(e);
+			},
+			value: numberValue
+		});
+	}
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_heroui_input.Input, {
+		...commonProps,
+		onChange,
+		type,
+		value
+	});
+};
+//#endregion
+//#region src/Input/index.ts
+var Input_default = Input;
+//#endregion
+exports.default = Input_default;
+
+//# sourceMappingURL=index.cjs.map

package/dist/Input/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useUniformField","useInputValueDebounce","HeroNumberInput","HeroInput"],"sources":["../../src/Input/Input.tsx","../../src/Input/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { InputProps as HeroInputProps } from '@heroui/input';\nimport type { ReactNode } from 'react';\nimport type { InputValueTransform } from '../hooks/useInputValueTransform';\n\nimport { Input as HeroInput } from '@heroui/input';\nimport { NumberInput as HeroNumberInput } from '@heroui/number-input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce } from '../hooks/useInputValueDebounce';\nimport { useUniformField } from '../hooks/useUniformField';\n\n// input variants\nexport const inputVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof inputVariants>;\ntype ClassName = TVClassName<typeof inputVariants>;\n\nexport interface InputProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** CSS class name */\n  className?: ClassName;\n  /** shows clear button when input has value */\n  clearable?: boolean;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** input field is disabled */\n  disabled?: boolean;\n  /** added content to the end of the input Field. */\n  endContent?: ReactNode;\n  /** form field label */\n  label?: ReactNode;\n  /** form field name */\n  name: string;\n  /** callback that is fired when the value is cleared */\n  onClear?: () => void;\n  /** form field placeholder */\n  placeholder?: string;\n  /** size of the input */\n  size?: 'sm' | 'md' | 'lg';\n  /** content added to the start of the input field */\n  startContent?: ReactNode;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** allows disentangled display and form values for a field */\n  transform?: InputValueTransform<string>;\n  /** input type */\n  type?: 'number' | 'password';\n}\n\n/**\n * Input component based on [HeroUI Input](https://www.heroui.com//docs/components/input)\n */\nconst Input = ({\n  className: _className = undefined,\n  clearable = false,\n  debounceDelay = 300,\n  endContent = undefined,\n  name,\n  onClear = undefined,\n  placeholder = ' ',\n  size = undefined,\n  startContent = undefined,\n  type = undefined,\n  ...uniformFieldProps\n}: InputProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    errorMessage,\n    invalid,\n    label,\n    required,\n    testId,\n    resetField,\n  } = useUniformField({ name, type, ...uniformFieldProps });\n\n  // Use hook that provides debounced onChange and enhanced blur handling\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    name,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // If input is clearable add props for clearing input value\n  const clearableProps: Pick<HeroInputProps, 'isClearable' | 'onClear'> =\n    clearable\n      ? {\n          isClearable: true,\n          onClear: () => {\n            // if field had initial value we do not reset it\n            // to that value, but clear it instead\n            resetField(name, { defaultValue: null });\n            // if onClear cb provided we call it\n            if (onClear) {\n              onClear();\n            }\n          },\n        }\n      : {};\n\n  // classNames from slots\n  const variants = inputVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  // Common props for both Input and NumberInput\n  const commonProps = {\n    ref,\n    // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)\n    'aria-label':\n      !placeholder || placeholder.trim() === '' ? ariaLabel : undefined,\n    // disable autocomplete\n    autoComplete: 'off',\n    classNames: {\n      base: classNames.base,\n      clearButton: classNames.clearButton,\n      // set padding to 0 for error message exit animation\n      helperWrapper: 'p-0',\n      input: classNames.input,\n      inputWrapper: classNames.inputWrapper,\n    },\n    'data-testid': testId,\n    endContent,\n    errorMessage,\n    id: testId,\n    isDisabled: disabled,\n    isInvalid: invalid,\n    isRequired: required,\n    label,\n    labelPlacement: 'outside' as const,\n    name,\n    onBlur,\n    placeholder,\n    radius: 'sm' as const,\n    size,\n    startContent,\n    variant: 'bordered' as const,\n    ...clearableProps,\n  };\n\n  // Render NumberInput for number type\n  if (type === 'number') {\n    // Parse the string value to number - use null for empty/cleared state to keep component controlled\n    const numberValue =\n      value !== '' && value != null && !Number.isNaN(Number(value))\n        ? Number(value)\n        : null;\n\n    return (\n      <HeroNumberInput\n        {...commonProps}\n        // Disable thousands separator to avoid parsing issues\n        formatOptions={{\n          useGrouping: false,\n        }}\n        // NumberInput onChange receives either an event or a number\n        onChange={(e: React.ChangeEvent<HTMLInputElement> | number) => {\n          if (typeof e === 'number') {\n            // Convert number to synthetic event and pass through debounced onChange\n            onChange({\n              target: { value: String(e) },\n            });\n          } else {\n            // Pass event through debounced onChange\n            onChange(e);\n          }\n        }}\n        // @ts-expect-error - HeroUI NumberInput type is not compatible with null,\n        // but it needs to be for empty/cleared state to be controlled\n        value={numberValue}\n      />\n    );\n  }\n\n  // Render regular Input for text/password\n  return (\n    <HeroInput {...commonProps} onChange={onChange} type={type} value={value} />\n  );\n};\n\nexport default Input;\n","import Input from './Input';\n\nexport type { InputProps } from './Input';\n\nexport default Input;\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,iBAAA,GAAA,uBAAA,IAAmB,EAC9B,OAAO;;CAEL,MAAM;;CAEN,aAAa;;CAEb,OAAO;;CAEP,cAAc;AAChB,EACF,CAAC;;;;AAyCD,MAAM,SAAS,EACb,WAAW,aAAa,KAAA,GACxB,YAAY,OACZ,gBAAgB,KAChB,aAAa,KAAA,GACb,MACA,UAAU,KAAA,GACV,cAAc,KACd,OAAO,KAAA,GACP,eAAe,KAAA,GACf,OAAO,KAAA,GACP,GAAG,wBACa;CAChB,MAAM,EACJ,WACA,UACA,OAAO,EACL,UAAU,eACV,QAAQ,aACR,OAAO,YACP,OAEF,cACA,SACA,OACA,UACA,QACA,eACEA,oCAAAA,gBAAgB;EAAE;EAAM;EAAM,GAAG;CAAkB,CAAC;CAGxD,MAAM,EAAE,UAAU,QAAQ,UAAUC,0CAAAA,sBAAsB;EACxD;EACA;EACA,QAAQ;EACR,UAAU;EACV,OAAO;CACT,CAAC;CAGD,MAAM,iBACJ,YACI;EACE,aAAa;EACb,eAAe;GAGb,WAAW,MAAM,EAAE,cAAc,KAAK,CAAC;GAEvC,IAAI,SACF,QAAQ;EAEZ;CACF,IACA,CAAC;CAIP,MAAM,cAAA,GAAA,uBAAA,sBADW,cAC8B,GAAG,YAAY,MAAM;CAGpE,MAAM,cAAc;EAClB;EAEA,cACE,CAAC,eAAe,YAAY,KAAK,MAAM,KAAK,YAAY,KAAA;EAE1D,cAAc;EACd,YAAY;GACV,MAAM,WAAW;GACjB,aAAa,WAAW;GAExB,eAAe;GACf,OAAO,WAAW;GAClB,cAAc,WAAW;EAC3B;EACA,eAAe;EACf;EACA;EACA,IAAI;EACJ,YAAY;EACZ,WAAW;EACX,YAAY;EACZ;EACA,gBAAgB;EAChB;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA,SAAS;EACT,GAAG;CACL;CAGA,IAAI,SAAS,UAAU;EAErB,MAAM,cACJ,UAAU,MAAM,SAAS,QAAQ,CAAC,OAAO,MAAM,OAAO,KAAK,CAAC,IACxD,OAAO,KAAK,IACZ;EAEN,OACE,iBAAA,GAAA,kBAAA,KAACC,qBAAAA,aAAD;GACE,GAAI;GAEJ,eAAe,EACb,aAAa,MACf;GAEA,WAAW,MAAoD;IAC7D,IAAI,OAAO,MAAM,UAEf,SAAS,EACP,QAAQ,EAAE,OAAO,OAAO,CAAC,EAAE,EAC7B,CAAC;SAGD,SAAS,CAAC;GAEd;GAGA,OAAO;EACR,CAAA;CAEL;CAGA,OACE,iBAAA,GAAA,kBAAA,KAACC,cAAAA,OAAD;EAAW,GAAI;EAAuB;EAAgB;EAAa;CAAQ,CAAA;AAE/E;;;ACnMA,IAAA,gBAAe"}