rn-inputforge 0.4.0 → 0.5.1

package/lib/typescript/hooks/useFieldFlowForm.d.ts

@@ -1,4 +1,8 @@
+import type { TextInput } from 'react-native';
 import type { FieldFlowRules, ValidationResult } from '../types';
+import { type FieldFlowLocale, type FieldFlowValidationMessages } from '../i18n/messages';
+import { type UseFormIntelligenceResult } from './useFormIntelligence';
+import type { FormIntelligenceOptions } from '../intelligence/types';
 export type FieldFlowFormRules<T extends Record<string, string>> = {
     [K in keyof T]?: FieldFlowRules;
 };
@@ -13,6 +17,23 @@ export interface CrossFieldRule<T extends Record<string, string>> {
     deps?: (keyof T)[];
     validate: (values: T) => ValidationResult;
 }
+export type FieldConditionFn<T extends Record<string, string>> = (values: T) => boolean;
+export interface FieldConditionConfig<T extends Record<string, string>> {
+    /** Hide the field when false. Hidden fields are skipped during validation. */
+    showWhen?: FieldConditionFn<T>;
+    /** Dynamically require the field. */
+    requiredWhen?: FieldConditionFn<T>;
+    /** Dynamically disable the field (caller should pass `disabled` to the input). */
+    disabledWhen?: FieldConditionFn<T>;
+}
+export type FieldConditions<T extends Record<string, string>> = {
+    [K in keyof T]?: FieldConditionConfig<T>;
+};
+export interface FieldVisibilityState {
+    visible: boolean;
+    required: boolean;
+    disabled: boolean;
+}
 export interface UseFieldFlowFormOptions<T extends Record<string, string>> {
     initialValues: T;
     rules?: FieldFlowFormRules<T>;
@@ -29,6 +50,10 @@ export interface UseFieldFlowFormOptions<T extends Record<string, string>> {
      * }]
      */
     crossFieldRules?: CrossFieldRule<T>[];
+    /**
+     * Conditional visibility / required / disabled rules evaluated against live values.
+     */
+    conditions?: FieldConditions<T>;
     /**
      * Whole-form validator (e.g. from `zodFormValidate(schema)`).
      * Merged after sync + cross-field rules; field keys map to error messages.
@@ -41,6 +66,20 @@ export interface UseFieldFlowFormOptions<T extends Record<string, string>> {
     asyncValidators?: AsyncFieldValidators<T>;
     /** Debounce for async field validators on change. Default: 400ms. */
     asyncDebounceMs?: number;
+    /**
+     * Enable form intelligence (friction analytics + a11y autofocus/announce on failed submit).
+     * Pass `true` for defaults, or an options object.
+     */
+    intelligence?: boolean | FormIntelligenceOptions;
+    /** Preferred field order for focus-first-error / announcements. */
+    fieldOrder?: (keyof T)[];
+    /**
+     * Locale for default validation messages (`en` | `es` | `fr` | `de` | `pt` | `ar`).
+     * Ignored for rule keys that already pass a custom string message.
+     */
+    locale?: FieldFlowLocale;
+    /** Full message catalog override (wins over `locale`). */
+    messages?: FieldFlowValidationMessages;
     /** Called only when every field passes sync + cross-field + form + async validation. */
     onSubmit?: (values: T) => void | Promise<void>;
 }
@@ -54,17 +93,56 @@ export interface UseFieldFlowFormResult<T extends Record<string, string>> {
     isValid: boolean;
     /** True while any async field validator is in flight. */
     isValidating: boolean;
+    /** True when current values differ from `initialValues`. */
+    isDirty: boolean;
+    /** Per-field dirty flags. */
+    dirtyFields: Partial<Record<keyof T, boolean>>;
     setValue: (field: keyof T, value: string) => void;
+    setValues: (values: T | ((prev: T) => T)) => void;
+    /** Merge server / API errors (e.g. 422 field map). Touches those fields. */
+    setErrors: (errors: Partial<Record<keyof T, string | undefined>>) => void;
+    /** Set a single field error from the server. */
+    setFieldError: (field: keyof T, message: string | undefined) => void;
+    /** Clear one field or all errors. */
+    clearErrors: (field?: keyof T) => void;
     handleChange: (field: keyof T) => (value: string) => void;
     handleBlur: (field: keyof T) => () => void;
+    handleFocus: (field: keyof T) => () => void;
     validateField: (field: keyof T) => Promise<boolean>;
+    /** Validate a subset of fields (wizard steps). */
+    validateFields: (fields: (keyof T)[]) => Promise<boolean>;
     validateAll: () => Promise<boolean>;
     submit: () => Promise<void>;
     reset: () => void;
+    /** Evaluate conditional rules for a field against current values. */
+    getFieldState: (field: keyof T) => FieldVisibilityState;
+    isVisible: (field: keyof T) => boolean;
+    isRequired: (field: keyof T) => boolean;
+    isDisabled: (field: keyof T) => boolean;
+    /**
+     * Convenience props to spread onto a FieldFlow input for a given field.
+     * Respects visibility (returns `null` when hidden so you can short-circuit render).
+     */
+    getInputProps: (field: keyof T) => null | {
+        value: string;
+        onChangeText: (value: string) => void;
+        onBlur: () => void;
+        onFocus: () => void;
+        errorText: string | undefined;
+        required: boolean;
+        disabled: boolean;
+    };
+    /** Present when `intelligence` is enabled. */
+    intelligence: UseFormIntelligenceResult<Extract<keyof T, string>> | null;
+    /** Register a TextInput ref for a11y autofocus (intelligence). */
+    registerFieldRef: (field: keyof T, ref: {
+        current: TextInput | null;
+    } | TextInput | null) => void;
 }
 /**
  * Drop-in form state manager for a set of FieldFlow inputs. Handles values,
- * per-field + cross-field + async validation, touched-state, and submission.
+ * per-field + cross-field + conditional + async validation, touched-state,
+ * optional form intelligence, and submission.
  */
-export declare function useFieldFlowForm<T extends Record<string, string>>({ initialValues, rules, crossFieldRules, formValidate, asyncValidators, asyncDebounceMs, onSubmit, }: UseFieldFlowFormOptions<T>): UseFieldFlowFormResult<T>;
+export declare function useFieldFlowForm<T extends Record<string, string>>({ initialValues, rules, crossFieldRules, conditions, formValidate, asyncValidators, asyncDebounceMs, intelligence: intelligenceOpt, fieldOrder, locale, messages: messagesOverride, onSubmit, }: UseFieldFlowFormOptions<T>): UseFieldFlowFormResult<T>;
 //# sourceMappingURL=useFieldFlowForm.d.ts.map

package/lib/typescript/hooks/useFieldFlowForm.d.ts.map

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

package/lib/typescript/hooks/useFieldFlowSteps.d.ts

@@ -0,0 +1,42 @@
+export interface FieldFlowStepDefinition<T extends Record<string, string> = Record<string, string>> {
+    /** Stable id for the step. */
+    id: string;
+    title: string;
+    description?: string;
+    /** Fields that must pass validation before advancing (keys of your form values). */
+    fields?: (keyof T)[];
+    /** Optional guard — return false (or a message) to block next. */
+    canLeave?: (values: T) => boolean | string;
+}
+export interface UseFieldFlowStepsOptions<T extends Record<string, string>> {
+    steps: FieldFlowStepDefinition<T>[];
+    /** Form values used by `canLeave` and exposed to callers. */
+    values: T;
+    /**
+     * Validate a subset of fields (usually from `useFieldFlowForm`).
+     * Should return true when all listed fields are valid.
+     */
+    validateFields?: (fields: (keyof T)[]) => Promise<boolean>;
+    /** Initial step index. Default: 0. */
+    initialStep?: number;
+    /** Called when the user completes the last step successfully. */
+    onComplete?: () => void | Promise<void>;
+}
+export interface UseFieldFlowStepsResult<T extends Record<string, string>> {
+    steps: FieldFlowStepDefinition<T>[];
+    stepIndex: number;
+    step: FieldFlowStepDefinition<T>;
+    isFirst: boolean;
+    isLast: boolean;
+    progress: number;
+    stepError: string | undefined;
+    goTo: (index: number) => void;
+    next: () => Promise<boolean>;
+    back: () => void;
+    reset: () => void;
+}
+/**
+ * Multi-step / wizard controller — pairs with `FieldFlowStepper` and `useFieldFlowForm`.
+ */
+export declare function useFieldFlowSteps<T extends Record<string, string>>({ steps, values, validateFields, initialStep, onComplete, }: UseFieldFlowStepsOptions<T>): UseFieldFlowStepsResult<T>;
+//# sourceMappingURL=useFieldFlowSteps.d.ts.map

package/lib/typescript/hooks/useFieldFlowSteps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFlowSteps.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFieldFlowSteps.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAChG,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxE,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC;IACV;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACvE,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAClE,KAAK,EACL,MAAM,EACN,cAAc,EACd,WAAe,EACf,UAAU,GACX,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CA8E1D"}

package/lib/typescript/hooks/useFieldFlowSubmitQueue.d.ts

@@ -0,0 +1,45 @@
+export interface FieldFlowSubmitJob<T = unknown> {
+    id: string;
+    payload: T;
+    createdAt: number;
+    attempts: number;
+    lastError?: string;
+}
+export interface FieldFlowSubmitQueueStorage {
+    getItem: (key: string) => Promise<string | null> | string | null;
+    setItem: (key: string, value: string) => Promise<void> | void;
+    removeItem: (key: string) => Promise<void> | void;
+}
+export interface UseFieldFlowSubmitQueueOptions<T> {
+    /** Unique storage key. */
+    key: string;
+    /** Persist queue (AsyncStorage / MMKV). Optional — in-memory if omitted. */
+    storage?: FieldFlowSubmitQueueStorage;
+    /** Actually send the payload. Throw / return false to keep in queue. */
+    submit: (payload: T) => Promise<void | boolean>;
+    /** Max attempts before parking as failed. Default: 5. */
+    maxAttempts?: number;
+    /** Auto-flush when online. Default: true. */
+    flushOnOnline?: boolean;
+    /** Called after a successful flush of one job. */
+    onSuccess?: (job: FieldFlowSubmitJob<T>) => void;
+    /** Called when a job exceeds maxAttempts. */
+    onGiveUp?: (job: FieldFlowSubmitJob<T>) => void;
+}
+export interface UseFieldFlowSubmitQueueResult<T> {
+    queue: FieldFlowSubmitJob<T>[];
+    pendingCount: number;
+    isFlushing: boolean;
+    isOnline: boolean;
+    /** Enqueue a payload (and try flush if online). */
+    enqueue: (payload: T) => Promise<string>;
+    /** Process the queue now. */
+    flush: () => Promise<void>;
+    clear: () => Promise<void>;
+    remove: (id: string) => Promise<void>;
+}
+/**
+ * Offline-friendly submit queue — persist failed / offline form posts and retry.
+ */
+export declare function useFieldFlowSubmitQueue<T>({ key, storage, submit, maxAttempts, flushOnOnline, onSuccess, onGiveUp, }: UseFieldFlowSubmitQueueOptions<T>): UseFieldFlowSubmitQueueResult<T>;
+//# sourceMappingURL=useFieldFlowSubmitQueue.d.ts.map

package/lib/typescript/hooks/useFieldFlowSubmitQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFlowSubmitQueue.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFieldFlowSubmitQueue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,wEAAwE;IACxE,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IAChD,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACjD,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EACzC,GAAG,EACH,OAAO,EACP,MAAM,EACN,WAAe,EACf,aAAoB,EACpB,SAAS,EACT,QAAQ,GACT,EAAE,8BAA8B,CAAC,CAAC,CAAC,GAAG,6BAA6B,CAAC,CAAC,CAAC,CAgJtE"}

package/lib/typescript/hooks/useFormIntelligence.d.ts

@@ -0,0 +1,23 @@
+import type { TextInput } from 'react-native';
+import type { FormHealthReport, FormIntelligenceOptions } from '../intelligence/types';
+export interface UseFormIntelligenceResult<T extends string = string> {
+    registerFieldRef: (field: T, ref: {
+        current: TextInput | null;
+    } | TextInput | null) => void;
+    trackFocus: (field: T) => void;
+    trackBlur: (field: T) => void;
+    trackChange: (field: T) => void;
+    trackError: (field: T) => void;
+    /** Call after validateAll — handles a11y focus/announce + friction accounting. */
+    onValidationResult: (valid: boolean, errors: Partial<Record<T, string | undefined>>, fieldOrder?: T[]) => void;
+    trackSubmitSuccess: () => void;
+    getReport: () => FormHealthReport;
+    flush: () => FormHealthReport;
+    reset: () => void;
+}
+/**
+ * Tracks per-field friction and runs accessibility autopilot on failed validation.
+ * Designed to plug into `useFieldFlowForm({ intelligence: true })` or be used standalone.
+ */
+export declare function useFormIntelligence<T extends string = string>(options?: FormIntelligenceOptions): UseFormIntelligenceResult<T>;
+//# sourceMappingURL=useFormIntelligence.d.ts.map

package/lib/typescript/hooks/useFormIntelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormIntelligence.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFormIntelligence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C,OAAO,KAAK,EAEV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAY/B,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAClE,gBAAgB,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE;QAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5F,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,kFAAkF;IAClF,kBAAkB,EAAE,CAClB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAC9C,UAAU,CAAC,EAAE,CAAC,EAAE,KACb,IAAI,CAAC;IACV,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,gBAAgB,CAAC;IAClC,KAAK,EAAE,MAAM,gBAAgB,CAAC;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC3D,OAAO,GAAE,uBAA4B,GACpC,yBAAyB,CAAC,CAAC,CAAC,CA8J9B"}

package/lib/typescript/hooks/useKeyboardManager.d.ts

@@ -10,7 +10,13 @@ export interface UseKeyboardManagerResult {
     unregisterField: (id: string) => void;
     /** Call from a field's onSubmitEditing to move focus to the next registered field, or submit if it's last. */
     focusNext: (id: string) => void;
+    /** Move focus to the previous field in `order` (no-op on first). */
+    focusPrevious: (id: string) => void;
     focusField: (id: string) => void;
+    /** Index helpers for keyboard toolbar enablement. */
+    getFieldIndex: (id: string) => number;
+    canGoPrevious: (id: string) => boolean;
+    canGoNext: (id: string) => boolean;
     /** Attach to the surrounding ScrollView so FieldFlow can scroll the active field into view. */
     scrollViewRef: React.RefObject<ScrollView | null>;
     /** returnKeyType to use for a field given its position ("next" for all but the last, "done" for the last). */

package/lib/typescript/hooks/useKeyboardManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useKeyboardManager.d.ts","sourceRoot":"","sources":["../../../src/hooks/useKeyboardManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACvC,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9F,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,8GAA8G;IAC9G,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+FAA+F;IAC/F,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClD,8GAA8G;IAC9G,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IAClD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,iGAAiG;IACjG,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,YAAiB,GAClB,EAAE,yBAAyB,GAAG,wBAAwB,CA8DtD"}
+{"version":3,"file":"useKeyboardManager.d.ts","sourceRoot":"","sources":["../../../src/hooks/useKeyboardManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACvC,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9F,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,8GAA8G;IAC9G,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,oEAAoE;IACpE,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,qDAAqD;IACrD,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,+FAA+F;IAC/F,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClD,8GAA8G;IAC9G,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IAClD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,iGAAiG;IACjG,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,YAAiB,GAClB,EAAE,yBAAyB,GAAG,wBAAwB,CAkFtD"}

package/lib/typescript/hooks/useSmartPaste.d.ts

@@ -0,0 +1,14 @@
+import { routeSmartPaste, type FieldFlowPasteResult, type FieldFlowPasteTargets } from '../paste/smartPaste';
+export interface UseSmartPasteOptions {
+    targets: FieldFlowPasteTargets;
+    minConfidence?: number;
+    onRouted?: (result: FieldFlowPasteResult) => void;
+}
+/**
+ * Hook helper for smart paste — call `handlePaste(text)` from Clipboard or a paste event.
+ */
+export declare function useSmartPaste({ targets, minConfidence, onRouted, }: UseSmartPasteOptions): {
+    handlePaste: (text: string) => FieldFlowPasteResult;
+    routeSmartPaste: typeof routeSmartPaste;
+};
+//# sourceMappingURL=useSmartPaste.d.ts.map

package/lib/typescript/hooks/useSmartPaste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSmartPaste.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSmartPaste.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,aAAmB,EACnB,QAAQ,GACT,EAAE,oBAAoB;wBAEZ,MAAM;;EAShB"}

package/lib/typescript/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export { validationMessageCatalogs, getValidationMessages, createValidationMessages, } from './messages';
+export type { FieldFlowLocale, FieldFlowValidationMessages } from './messages';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC"}

package/lib/typescript/i18n/messages.d.ts

@@ -0,0 +1,16 @@
+export type FieldFlowLocale = 'en' | 'es' | 'fr' | 'de' | 'pt' | 'ar';
+export interface FieldFlowValidationMessages {
+    required: string;
+    email: string;
+    number: string;
+    phone: string;
+    minLength: (min: number) => string;
+    maxLength: (max: number) => string;
+    pattern: string;
+    invalid: string;
+}
+export declare const validationMessageCatalogs: Record<FieldFlowLocale, FieldFlowValidationMessages>;
+export declare function getValidationMessages(locale?: FieldFlowLocale): FieldFlowValidationMessages;
+/** Merge a partial catalog over a locale base (default English). */
+export declare function createValidationMessages(overrides: Partial<FieldFlowValidationMessages>, locale?: FieldFlowLocale): FieldFlowValidationMessages;
+//# sourceMappingURL=messages.d.ts.map

package/lib/typescript/i18n/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/i18n/messages.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAoED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAO1F,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,eAAsB,GAC7B,2BAA2B,CAE7B;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,OAAO,CAAC,2BAA2B,CAAC,EAC/C,MAAM,GAAE,eAAsB,GAC7B,2BAA2B,CAE7B"}

package/lib/typescript/index.d.ts

@@ -20,15 +20,83 @@ export { FieldFlowSwitch } from './components/FieldFlowSwitch';
 export type { FieldFlowSwitchProps } from './components/FieldFlowSwitch';
 export { FieldFlowDateTimePicker } from './components/FieldFlowDateTimePicker';
 export type { FieldFlowDateTimePickerProps, FieldFlowDateTimeMode, } from './components/FieldFlowDateTimePicker';
-export { FieldFlowThemeProvider, useFieldFlowTheme, defaultTheme, darkTheme } from './theme';
-export type { FieldFlowThemeProviderProps } from './theme';
-export { useFieldFlowForm, useKeyboardManager, useFieldState } from './hooks';
-export type { UseFieldFlowFormOptions, UseFieldFlowFormResult, FieldFlowFormRules, AsyncFieldValidator, AsyncFieldValidators, CrossFieldRule, UseKeyboardManagerOptions, UseKeyboardManagerResult, UseFieldStateOptions, } from './hooks';
+export { FieldFlowAffordance } from './components/FieldFlowAffordance';
+export type { FieldFlowAffordanceProps } from './components/FieldFlowAffordance';
+export { FieldFlowDraftBanner } from './components/FieldFlowDraftBanner';
+export type { FieldFlowDraftBannerProps } from './components/FieldFlowDraftBanner';
+export { FieldFlowTags } from './components/FieldFlowTags';
+export type { FieldFlowTagsProps } from './components/FieldFlowTags';
+export { FieldFlowPasswordStrength } from './components/FieldFlowPasswordStrength';
+export type { FieldFlowPasswordStrengthProps } from './components/FieldFlowPasswordStrength';
+export { FieldFlowSection } from './components/FieldFlowSection';
+export type { FieldFlowSectionProps } from './components/FieldFlowSection';
+export { FieldFlowSegmented } from './components/FieldFlowSegmented';
+export type { FieldFlowSegmentedProps } from './components/FieldFlowSegmented';
+export { FieldFlowStepper } from './components/FieldFlowStepper';
+export type { FieldFlowStepperProps, FieldFlowStepRenderContext } from './components/FieldFlowStepper';
+export { FieldFlowPhone } from './components/FieldFlowPhone';
+export type { FieldFlowPhoneProps, FieldFlowPhoneValue } from './components/FieldFlowPhone';
+export { FieldFlowUpload } from './components/FieldFlowUpload';
+export type { FieldFlowUploadProps, FieldFlowUploadFile, FieldFlowUploadPicker, } from './components/FieldFlowUpload';
+export { FieldFlowTypeahead } from './components/FieldFlowTypeahead';
+export type { FieldFlowTypeaheadProps, FieldFlowTypeaheadFetcher } from './components/FieldFlowTypeahead';
+export { FieldFlowRating } from './components/FieldFlowRating';
+export type { FieldFlowRatingProps } from './components/FieldFlowRating';
+export { FieldFlowSlider } from './components/FieldFlowSlider';
+export type { FieldFlowSliderProps } from './components/FieldFlowSlider';
+export { FieldFlowNumberStepper } from './components/FieldFlowNumberStepper';
+export type { FieldFlowNumberStepperProps } from './components/FieldFlowNumberStepper';
+export { FieldFlowCreditCard } from './components/FieldFlowCreditCard';
+export type { FieldFlowCreditCardProps, FieldFlowCreditCardValue } from './components/FieldFlowCreditCard';
+export { FieldFlowSignature } from './components/FieldFlowSignature';
+export type { FieldFlowSignatureProps, FieldFlowSignatureValue, FieldFlowStroke, FieldFlowPoint, } from './components/FieldFlowSignature';
+export { FieldFlowCompleteness } from './components/FieldFlowCompleteness';
+export type { FieldFlowCompletenessProps } from './components/FieldFlowCompleteness';
+export { FieldFlowAuthActions } from './components/FieldFlowAuthActions';
+export type { FieldFlowAuthActionsProps, FieldFlowAuthAction, FieldFlowAuthProvider, } from './components/FieldFlowAuthActions';
+export { FieldFlowKeyboardToolbar, FIELD_FLOW_KEYBOARD_TOOLBAR_ID, } from './components/FieldFlowKeyboardToolbar';
+export type { FieldFlowKeyboardToolbarProps } from './components/FieldFlowKeyboardToolbar';
+export { FieldFlowA11yAudit } from './components/FieldFlowA11yAudit';
+export type { FieldFlowA11yAuditProps } from './components/FieldFlowA11yAudit';
+export { FieldFlowInlineAlert } from './components/FieldFlowInlineAlert';
+export type { FieldFlowInlineAlertProps, FieldFlowAlertTone } from './components/FieldFlowInlineAlert';
+export { FieldFlowSkeleton } from './components/FieldFlowSkeleton';
+export type { FieldFlowSkeletonProps } from './components/FieldFlowSkeleton';
+export { FieldFlowFormHeader } from './components/FieldFlowFormHeader';
+export type { FieldFlowFormHeaderProps } from './components/FieldFlowFormHeader';
+export { FieldFlowInfoTip } from './components/FieldFlowInfoTip';
+export type { FieldFlowInfoTipProps } from './components/FieldFlowInfoTip';
+export { FieldFlowSchemaForm } from './schema';
+export type { FieldFlowSchemaFormProps, FieldFlowSchemaShowWhenFn, FieldFlowFormSchema, FieldFlowSchemaField, FieldFlowSchemaFieldType, FieldFlowSchemaSection, } from './schema';
+export { FieldFlowController, FieldFlowTagsController, mapRhfToFieldFlowProps, } from './adapters';
+export type { FieldFlowControllerProps, FieldFlowTagsControllerProps, } from './adapters';
+export { FieldFlowThemeProvider, useFieldFlowTheme, defaultTheme, darkTheme, themePresets, getThemePreset, applyAppearance, defaultAppearance, surfaceShadow, } from './theme';
+export type { FieldFlowThemeProviderProps, FieldFlowThemePresetName } from './theme';
+export { useFieldMotion, useReducedMotion } from './motion';
+export type { UseFieldMotionOptions, UseFieldMotionResult } from './motion';
+export { useFieldFlowForm, useKeyboardManager, useFieldState, useFormIntelligence, useFieldFlowArray, useFieldFlowDraft, useFieldFlowSteps, useFieldFlowDirtyGuard, useFieldFlowCompleteness, useFieldFlowSubmitQueue, useSmartPaste, } from './hooks';
+export type { UseFieldFlowFormOptions, UseFieldFlowFormResult, FieldFlowFormRules, AsyncFieldValidator, AsyncFieldValidators, CrossFieldRule, FieldConditionFn, FieldConditionConfig, FieldConditions, FieldVisibilityState, UseKeyboardManagerOptions, UseKeyboardManagerResult, UseFieldStateOptions, UseFormIntelligenceResult, UseFieldFlowArrayOptions, UseFieldFlowArrayResult, FieldFlowDraftStorage, FieldFlowDraftPayload, UseFieldFlowDraftOptions, UseFieldFlowDraftResult, FieldFlowStepDefinition, UseFieldFlowStepsOptions, UseFieldFlowStepsResult, UseFieldFlowDirtyGuardOptions, UseFieldFlowDirtyGuardResult, UseFieldFlowCompletenessOptions, UseFieldFlowCompletenessResult, FieldFlowSubmitJob, FieldFlowSubmitQueueStorage, UseFieldFlowSubmitQueueOptions, UseFieldFlowSubmitQueueResult, UseSmartPasteOptions, } from './hooks';
+export { getAutofillProps, autofillRoleFromFieldType, autofillProfiles, } from './autofill';
+export type { FieldFlowAutofillRole, FieldFlowAutofillProps, FieldFlowAutofillProfileName, } from './autofill';
+export { routeSmartPaste, applySmartPaste } from './paste';
+export type { FieldFlowPasteKind, FieldFlowPasteResult, FieldFlowAddressPaste, FieldFlowPasteTargets, } from './paste';
+export { runA11yAudit } from './a11y';
+export type { FieldFlowA11ySeverity, FieldFlowA11yIssue, FieldFlowA11yFieldSnapshot, FieldFlowA11yAuditInput, } from './a11y';
+export { validationMessageCatalogs, getValidationMessages, createValidationMessages, } from './i18n';
+export type { FieldFlowLocale, FieldFlowValidationMessages } from './i18n';
+export { DEFAULT_COUNTRY_DIALS, findCountryByCode, composeE164, } from './utils/phoneCountries';
+export type { FieldFlowCountryDial } from './utils/phoneCountries';
 export { useValidation, runRules, isValidEmail, isValidNumber, isValidPhone, requiredValidator, emailValidator, numberValidator, phoneValidator, minLengthValidator, maxLengthValidator, patternValidator, zodToFormErrors, zodFormValidate, createZodSubmitGuard, fieldRulesFromZodString, } from './validation';
 export type { UseValidationResult, ZodSchemaLike, ZodIssueLike, ZodErrorLike } from './validation';
 export { applyMask, applyPattern, formatMasked, unmask, digitsOnly, applyPhoneMask, applyCardMask, applyDateMask, applyCurrencyMask, } from './utils/masks';
 export type { FieldFlowMaskType, MaskResult, ApplyMaskOptions } from './utils/masks';
+export { applyEmailDomainSuggestion, applyPhoneDialSuggestion, applyCurrencySymbolSuggestion, applyAffordanceSuggestion, resolveAffordanceChips, emailDomainsToChips, affordanceKindFromFieldType, DEFAULT_EMAIL_DOMAINS, DEFAULT_PHONE_DIAL_CODES, DEFAULT_CURRENCY_SYMBOLS, } from './utils/affordance';
+export type { FieldFlowAffordanceKind, FieldFlowAffordanceChip } from './utils/affordance';
+export { evaluatePasswordStrength, DEFAULT_PASSWORD_RULES, PASSWORD_STRENGTH_COLORS, } from './utils/passwordStrength';
+export type { PasswordStrengthLevel, PasswordStrengthRule, PasswordStrengthResult, } from './utils/passwordStrength';
+export { focusFirstError, announceForAccessibility, buildValidationAnnouncement, setAccessibilityFocus, } from './intelligence';
+export type { FieldRefMap, FieldFrictionStats, FormHealthReport, FormIntelligenceOptions, } from './intelligence';
 export { FieldFlowIcon, renderFieldFlowIcon } from './icons';
 export type { FieldFlowIconName, FieldFlowIconProps, FieldFlowIconSource } from './icons';
-export type { FieldFlowFieldType, FieldFlowState, FieldFlowRules, FieldFlowOption, FieldFlowVariant, ValidationResult, Validator, FieldFlowColors, FieldFlowSpacing, FieldFlowTypography, FieldFlowAnimationConfig, FieldFlowTheme, DeepPartial, } from './types';
+export type { FieldFlowFieldType, FieldFlowState, FieldFlowRules, FieldFlowOption, FieldFlowVariant, ValidationResult, Validator, FieldFlowColors, FieldFlowSpacing, FieldFlowTypography, FieldFlowAnimationConfig, FieldFlowTheme, FieldFlowAppearance, FieldFlowDensity, FieldFlowControlSize, FieldFlowSurface, FieldFlowShape, FieldFlowFocusRing, DeepPartial, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

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

package/lib/typescript/intelligence/formAccessibility.d.ts

@@ -0,0 +1,21 @@
+import { type TextInput } from 'react-native';
+export type FieldRefMap<T extends string = string> = Partial<Record<T, {
+    current: TextInput | null;
+} | TextInput | null>>;
+/**
+ * Focus the first field (in `order` or object key order) that has an error.
+ * Returns the field key that was focused, or `undefined` if none.
+ */
+export declare function focusFirstError<T extends string>(errors: Partial<Record<T, string | undefined>>, refs: FieldRefMap<T>, order?: T[]): T | undefined;
+/** Announce a short message to VoiceOver / TalkBack when available. */
+export declare function announceForAccessibility(message: string): void;
+/**
+ * Build a concise announcement for failed validation, e.g.
+ * "Form has 2 errors. Email is required."
+ */
+export declare function buildValidationAnnouncement(errors: Partial<Record<string, string | undefined>>): string;
+/** Best-effort: mark a native view as accessibility-focused (Android). */
+export declare function setAccessibilityFocus(ref: {
+    current: TextInput | null;
+} | TextInput | null): void;
+//# sourceMappingURL=formAccessibility.d.ts.map

package/lib/typescript/intelligence/formAccessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAccessibility.d.ts","sourceRoot":"","sources":["../../../src/intelligence/formAccessibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEjF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,OAAO,CAC1D,MAAM,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAC5D,CAAC;AAQF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAC9C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,KAAK,CAAC,EAAE,CAAC,EAAE,GACV,CAAC,GAAG,SAAS,CAoBf;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAClD,MAAM,CAUR;AAUD,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAOjG"}

package/lib/typescript/intelligence/index.d.ts

@@ -0,0 +1,4 @@
+export { focusFirstError, announceForAccessibility, buildValidationAnnouncement, setAccessibilityFocus, } from './formAccessibility';
+export type { FieldRefMap } from './formAccessibility';
+export type { FieldFrictionStats, FormHealthReport, FormIntelligenceOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/intelligence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/intelligence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,SAAS,CAAC"}

package/lib/typescript/intelligence/types.d.ts

@@ -0,0 +1,36 @@
+export interface FieldFrictionStats {
+    focusCount: number;
+    /** Cumulative milliseconds the field was focused. */
+    totalFocusMs: number;
+    errorCount: number;
+    changeCount: number;
+    blurCount: number;
+    lastFocusedAt?: number;
+    /** Running focus session start (ms since epoch); cleared on blur. */
+    focusStartedAt?: number;
+}
+export interface FormHealthReport {
+    /** Wall-clock ms from first interaction to this report. */
+    sessionMs: number;
+    submitAttempts: number;
+    successfulSubmits: number;
+    fields: Record<string, FieldFrictionStats>;
+    /**
+     * Fields sorted by estimated friction (errors × 3 + focusCount + changeCount / 10).
+     * Useful for product analytics / debugging onboarding drop-off.
+     */
+    mostFriction: Array<{
+        field: string;
+        score: number;
+    }>;
+    generatedAt: number;
+}
+export interface FormIntelligenceOptions {
+    /** Called whenever a new report is produced (submit attempt, or `flush()`). */
+    onReport?: (report: FormHealthReport) => void;
+    /** When true (default), failed submit focuses & announces the first invalid field. */
+    focusFirstError?: boolean;
+    /** Announce errors via `AccessibilityInfo.announceForAccessibility`. Default: true. */
+    announceErrors?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/intelligence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/intelligence/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C;;;OAGG;IACH,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9C,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/lib/typescript/motion/index.d.ts

@@ -0,0 +1,4 @@
+export { useReducedMotion } from './useReducedMotion';
+export { useFieldMotion } from './useFieldMotion';
+export type { UseFieldMotionOptions, UseFieldMotionResult } from './useFieldMotion';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/motion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/motion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/typescript/motion/useFieldMotion.d.ts

@@ -0,0 +1,31 @@
+import { Animated } from 'react-native';
+export interface UseFieldMotionOptions {
+    /** Master switch. Default: true. */
+    enabled?: boolean;
+    isFocused: boolean;
+    hasError: boolean;
+    isSuccess?: boolean;
+    /** Base duration from theme. */
+    duration?: number;
+}
+export interface UseFieldMotionResult {
+    /** Apply to the field chrome (input container). */
+    containerStyle: {
+        transform: Array<{
+            translateX: Animated.AnimatedInterpolation<string | number>;
+        }>;
+    };
+    /** Soft focus glow overlay opacity (0–1). */
+    glowOpacity: Animated.Value;
+    /** Footer message fade. */
+    messageOpacity: Animated.Value;
+    /** Success check scale pop. */
+    successScale: Animated.Value;
+    reducedMotion: boolean;
+}
+/**
+ * Field micro-interactions: error shake, focus glow, message cross-fade, success pop.
+ * Uses RN Animated only (no Reanimated) and respects Reduce Motion.
+ */
+export declare function useFieldMotion({ enabled, isFocused, hasError, isSuccess, duration, }: UseFieldMotionOptions): UseFieldMotionResult;
+//# sourceMappingURL=useFieldMotion.d.ts.map

package/lib/typescript/motion/useFieldMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldMotion.d.ts","sourceRoot":"","sources":["../../../src/motion/useFieldMotion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAU,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,cAAc,EAAE;QACd,SAAS,EAAE,KAAK,CAAC;YAAE,UAAU,EAAE,QAAQ,CAAC,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;SAAE,CAAC,CAAC;KACnF,CAAC;IACF,6CAA6C;IAC7C,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC5B,2BAA2B;IAC3B,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC/B,+BAA+B;IAC/B,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAc,GACf,EAAE,qBAAqB,GAAG,oBAAoB,CAiF9C"}

package/lib/typescript/motion/useReducedMotion.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tracks the OS “Reduce Motion” preference so FieldFlow can skip decorative animation.
+ */
+export declare function useReducedMotion(): boolean;
+//# sourceMappingURL=useReducedMotion.d.ts.map

package/lib/typescript/motion/useReducedMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReducedMotion.d.ts","sourceRoot":"","sources":["../../../src/motion/useReducedMotion.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAwB1C"}

package/lib/typescript/paste/index.d.ts

@@ -0,0 +1,3 @@
+export { routeSmartPaste, applySmartPaste } from './smartPaste';
+export type { FieldFlowPasteKind, FieldFlowPasteResult, FieldFlowAddressPaste, FieldFlowPasteTargets, } from './smartPaste';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/paste/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/paste/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}