rn-inputforge 0.3.1 → 0.5.0

package/lib/typescript/components/FieldFlowSwitch/FieldFlowSwitch.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+import { type FieldFlowIconSource } from '../../icons';
+import type { DeepPartial, FieldFlowTheme } from '../../types';
+export interface FieldFlowSwitchProps {
+    value: boolean;
+    onChange: (value: boolean) => void;
+    label?: string;
+    helperText?: string;
+    errorText?: string;
+    disabled?: boolean;
+    required?: boolean;
+    switchPosition?: 'left' | 'right';
+    leftIcon?: FieldFlowIconSource;
+    iconSize?: number;
+    /** Track color when on. */
+    onTrackColor?: string;
+    /** Track color when off. */
+    offTrackColor?: string;
+    thumbColor?: string;
+    trackStyle?: ViewStyle;
+    thumbStyle?: ViewStyle;
+    containerStyle?: ViewStyle;
+    labelStyle?: TextStyle;
+    helperStyle?: TextStyle;
+    errorStyle?: TextStyle;
+    theme?: DeepPartial<FieldFlowTheme>;
+    testID?: string;
+}
+export declare function FieldFlowSwitch({ value, onChange, label, helperText, errorText, disabled, required, switchPosition, leftIcon, iconSize, onTrackColor, offTrackColor, thumbColor, trackStyle, thumbStyle, containerStyle, labelStyle, helperStyle, errorStyle, theme: themeOverride, testID, }: FieldFlowSwitchProps): React.JSX.Element;
+//# sourceMappingURL=FieldFlowSwitch.d.ts.map

package/lib/typescript/components/FieldFlowSwitch/FieldFlowSwitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldFlowSwitch.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowSwitch/FieldFlowSwitch.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAC1D,OAAO,EAA+C,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjG,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,cAAwB,EACxB,QAAQ,EACR,QAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAsB,EACtB,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,EAAE,aAAa,EACpB,MAAM,GACP,EAAE,oBAAoB,qBAkEtB"}

package/lib/typescript/components/FieldFlowSwitch/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldFlowSwitch } from './FieldFlowSwitch';
+export type { FieldFlowSwitchProps } from './FieldFlowSwitch';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowSwitch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/typescript/components/FieldFlowTags/FieldFlowTags.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import { type TextStyle, type ViewStyle } from 'react-native';
+import { type FieldFlowIconSource } from '../../icons';
+import type { DeepPartial, FieldFlowTheme, FieldFlowVariant } from '../../types';
+export interface FieldFlowTagsProps {
+    value?: string[];
+    onChange: (tags: string[]) => void;
+    label?: string;
+    placeholder?: string;
+    helperText?: string;
+    errorText?: string;
+    hasError?: boolean;
+    disabled?: boolean;
+    required?: boolean;
+    /** Max number of tags. */
+    maxTags?: number;
+    /** Max characters per tag. Default: 32. */
+    maxTagLength?: number;
+    /** Separators that commit the current draft. Default: enter + comma. */
+    separators?: Array<',' | ' ' | 'enter'>;
+    /** Allow duplicate tags. Default: false. */
+    allowDuplicates?: boolean;
+    /** Transform each tag before commit (default: trim). */
+    transformTag?: (raw: string) => string;
+    leftIcon?: FieldFlowIconSource | null;
+    variant?: FieldFlowVariant;
+    containerStyle?: ViewStyle;
+    inputContainerStyle?: ViewStyle;
+    tagStyle?: ViewStyle;
+    tagTextStyle?: TextStyle;
+    labelStyle?: TextStyle;
+    helperStyle?: TextStyle;
+    theme?: DeepPartial<FieldFlowTheme>;
+    testID?: string;
+}
+/**
+ * Multi-value chip / tags input — skills, interests, keywords.
+ * Type a value and press Enter or comma to commit.
+ */
+export declare function FieldFlowTags({ value, onChange, label, placeholder, helperText, errorText, hasError, disabled, required, maxTags, maxTagLength, separators, allowDuplicates, transformTag, leftIcon, variant, containerStyle, inputContainerStyle, tagStyle, tagTextStyle, labelStyle, helperStyle, theme: themeOverride, testID, }: FieldFlowTagsProps): React.JSX.Element;
+//# sourceMappingURL=FieldFlowTags.d.ts.map

package/lib/typescript/components/FieldFlowTags/FieldFlowTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldFlowTags.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowTags/FieldFlowTags.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,EAML,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC;IACxC,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,mBAAmB,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,WAA0B,EAC1B,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,YAAiB,EACjB,UAA2B,EAC3B,eAAuB,EACvB,YAAgC,EAChC,QAAiB,EACjB,OAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EAAE,aAAa,EACpB,MAAM,GACP,EAAE,kBAAkB,qBA6IpB"}

package/lib/typescript/components/FieldFlowTags/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldFlowTags } from './FieldFlowTags';
+export type { FieldFlowTagsProps } from './FieldFlowTags';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowTags/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/typescript/components/FieldFlowTypeahead/FieldFlowTypeahead.d.ts

@@ -0,0 +1,43 @@
+import React from 'react';
+import { type TextStyle, type ViewStyle } from 'react-native';
+import type { DeepPartial, FieldFlowOption, FieldFlowTheme } from '../../types';
+export type FieldFlowTypeaheadFetcher = (query: string) => Promise<FieldFlowOption[]> | FieldFlowOption[];
+export interface FieldFlowTypeaheadProps {
+    value?: string | null;
+    /** Selected option label for display when value is set. */
+    displayValue?: string;
+    onChange: (value: string | null, option?: FieldFlowOption) => void;
+    /**
+     * Async (or sync) option loader. Debounced by `debounceMs`.
+     * Return [] when nothing matches.
+     */
+    fetchOptions: FieldFlowTypeaheadFetcher;
+    /** Optional static fallback options used when query is empty. */
+    defaultOptions?: FieldFlowOption[];
+    label?: string;
+    placeholder?: string;
+    helperText?: string;
+    errorText?: string;
+    disabled?: boolean;
+    required?: boolean;
+    debounceMs?: number;
+    minChars?: number;
+    emptyText?: string;
+    /** Custom dropdown row. Call `select()` to commit. */
+    renderOption?: (ctx: {
+        option: FieldFlowOption;
+        selected: boolean;
+        select: () => void;
+    }) => React.ReactNode;
+    /** Custom empty / no-results state. */
+    renderEmpty?: (ctx: {
+        query: string;
+        loading: boolean;
+    }) => React.ReactNode;
+    containerStyle?: ViewStyle;
+    labelStyle?: TextStyle;
+    theme?: DeepPartial<FieldFlowTheme>;
+    testID?: string;
+}
+export declare function FieldFlowTypeahead({ value, displayValue, onChange, fetchOptions, defaultOptions, label, placeholder, helperText, errorText, disabled, required, debounceMs, minChars, emptyText, renderOption, renderEmpty, containerStyle, labelStyle, theme: themeOverride, testID, }: FieldFlowTypeaheadProps): React.JSX.Element;
+//# sourceMappingURL=FieldFlowTypeahead.d.ts.map

package/lib/typescript/components/FieldFlowTypeahead/FieldFlowTypeahead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldFlowTypeahead.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowTypeahead/FieldFlowTypeahead.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AACpE,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACnE;;;OAGG;IACH,YAAY,EAAE,yBAAyB,CAAC;IACxC,iEAAiE;IACjE,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QACnB,MAAM,EAAE,eAAe,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,KAAK,KAAK,CAAC,SAAS,CAAC;IACtB,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5E,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,cAAmB,EACnB,KAAK,EACL,WAAuB,EACvB,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAgB,EAChB,QAAY,EACZ,SAAwB,EACxB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,KAAK,EAAE,aAAa,EACpB,MAAM,GACP,EAAE,uBAAuB,qBAuIzB"}

package/lib/typescript/components/FieldFlowTypeahead/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldFlowTypeahead } from './FieldFlowTypeahead';
+export type { FieldFlowTypeaheadProps, FieldFlowTypeaheadFetcher } from './FieldFlowTypeahead';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowTypeahead/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/components/FieldFlowUpload/FieldFlowUpload.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+import { type TextStyle, type ViewStyle } from 'react-native';
+import type { DeepPartial, FieldFlowTheme } from '../../types';
+export interface FieldFlowUploadFile {
+    uri: string;
+    name?: string;
+    mimeType?: string;
+    size?: number;
+    /** Optional local preview (same as uri for images). */
+    previewUri?: string;
+}
+export type FieldFlowUploadPicker = () => Promise<FieldFlowUploadFile | FieldFlowUploadFile[] | null>;
+export interface FieldFlowUploadProps {
+    value?: FieldFlowUploadFile[];
+    onChange: (files: FieldFlowUploadFile[]) => void;
+    /**
+     * Injected picker — keep the library free of native upload deps.
+     * Example: wrap `expo-image-picker` / `expo-document-picker` / `launchImageLibrary`.
+     */
+    pick: FieldFlowUploadPicker;
+    label?: string;
+    helperText?: string;
+    errorText?: string;
+    disabled?: boolean;
+    required?: boolean;
+    /** Max files. Default: 1. */
+    maxFiles?: number;
+    /** Accept hint shown in UI. */
+    acceptHint?: string;
+    /** Show image thumbnails when mime looks like image. Default: true. */
+    showPreviews?: boolean;
+    /** Replace the dashed dropzone chrome. */
+    renderDropzone?: (ctx: {
+        atMax: boolean;
+        fileCount: number;
+        maxFiles: number;
+        disabled: boolean;
+        openPicker: () => void;
+    }) => React.ReactNode;
+    /** Replace each file row. Call `remove` to delete. */
+    renderFile?: (ctx: {
+        file: FieldFlowUploadFile;
+        index: number;
+        remove: () => void;
+    }) => React.ReactNode;
+    containerStyle?: ViewStyle;
+    labelStyle?: TextStyle;
+    theme?: DeepPartial<FieldFlowTheme>;
+    testID?: string;
+}
+export declare function FieldFlowUpload({ value, onChange, pick, label, helperText, errorText, disabled, required, maxFiles, acceptHint, showPreviews, renderDropzone, renderFile, containerStyle, labelStyle, theme: themeOverride, testID, }: FieldFlowUploadProps): React.JSX.Element;
+//# sourceMappingURL=FieldFlowUpload.d.ts.map

package/lib/typescript/components/FieldFlowUpload/FieldFlowUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldFlowUpload.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowUpload/FieldFlowUpload.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAML,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,mBAAmB,GAAG,mBAAmB,EAAE,GAAG,IAAI,CAAC,CAAC;AAEtG,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IACjD;;;OAGG;IACH,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,IAAI,CAAC;KACxB,KAAK,KAAK,CAAC,SAAS,CAAC;IACtB,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QACjB,IAAI,EAAE,mBAAmB,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,KAAK,KAAK,CAAC,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAU,EACV,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAY,EACZ,UAA4B,EAC5B,YAAmB,EACnB,cAAc,EACd,UAAU,EACV,cAAc,EACd,UAAU,EACV,KAAK,EAAE,aAAa,EACpB,MAAM,GACP,EAAE,oBAAoB,qBAiGtB"}

package/lib/typescript/components/FieldFlowUpload/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldFlowUpload } from './FieldFlowUpload';
+export type { FieldFlowUploadProps, FieldFlowUploadFile, FieldFlowUploadPicker, } from './FieldFlowUpload';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/FieldFlowUpload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

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

@@ -1,7 +1,17 @@
 export { useKeyboardManager } from './useKeyboardManager';
 export type { UseKeyboardManagerOptions, UseKeyboardManagerResult, KeyboardManagerField } from './useKeyboardManager';
 export { useFieldFlowForm } from './useFieldFlowForm';
-export type { UseFieldFlowFormOptions, UseFieldFlowFormResult, FieldFlowFormRules, } from './useFieldFlowForm';
+export type { UseFieldFlowFormOptions, UseFieldFlowFormResult, FieldFlowFormRules, AsyncFieldValidator, AsyncFieldValidators, CrossFieldRule, FieldConditionFn, FieldConditionConfig, FieldConditions, FieldVisibilityState, } from './useFieldFlowForm';
 export { useFieldState } from './useFieldState';
 export type { UseFieldStateOptions } from './useFieldState';
+export { useFormIntelligence } from './useFormIntelligence';
+export type { UseFormIntelligenceResult } from './useFormIntelligence';
+export { useFieldFlowArray } from './useFieldFlowArray';
+export type { UseFieldFlowArrayOptions, UseFieldFlowArrayResult } from './useFieldFlowArray';
+export { useFieldFlowDraft } from './useFieldFlowDraft';
+export type { FieldFlowDraftStorage, FieldFlowDraftPayload, UseFieldFlowDraftOptions, UseFieldFlowDraftResult, } from './useFieldFlowDraft';
+export { useFieldFlowSteps } from './useFieldFlowSteps';
+export type { FieldFlowStepDefinition, UseFieldFlowStepsOptions, UseFieldFlowStepsResult, } from './useFieldFlowSteps';
+export { useFieldFlowDirtyGuard } from './useFieldFlowDirtyGuard';
+export type { UseFieldFlowDirtyGuardOptions, UseFieldFlowDirtyGuardResult, } from './useFieldFlowDirtyGuard';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEtH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEtH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,54 @@
+export interface UseFieldFlowArrayOptions<TItem> {
+    /** Initial rows. Default: `[]`. */
+    initialItems?: TItem[];
+    /** Factory for a blank row when calling `append()` without an argument. */
+    createItem: () => TItem;
+    /** Hard cap on rows. `append` becomes a no-op at the limit. */
+    max?: number;
+    /** Minimum rows. `remove` is blocked when at the floor. Default: 0. */
+    min?: number;
+}
+export interface UseFieldFlowArrayResult<TItem> {
+    items: TItem[];
+    /** Number of rows. */
+    length: number;
+    /** True when `max` is set and reached. */
+    isMax: boolean;
+    /** True when at `min` rows. */
+    isMin: boolean;
+    setItems: (items: TItem[] | ((prev: TItem[]) => TItem[])) => void;
+    /** Append a row (or `createItem()`). Returns the new index, or `-1` if blocked. */
+    append: (item?: TItem) => number;
+    /** Remove by index. Returns false if blocked by `min`. */
+    remove: (index: number) => boolean;
+    /** Replace a single row. */
+    update: (index: number, item: TItem | ((prev: TItem) => TItem)) => void;
+    /** Swap two indices. */
+    move: (from: number, to: number) => void;
+    /** Insert at index (clamped). */
+    insert: (index: number, item?: TItem) => void;
+    clear: () => void;
+    reset: () => void;
+}
+/**
+ * Manage dynamic / repeatable field groups (addresses, line items, guests, …)
+ * alongside FieldFlow inputs. Pure state — no UI assumptions.
+ *
+ * @example
+ * const guests = useFieldFlowArray({
+ *   createItem: () => ({ name: '', email: '' }),
+ *   min: 1,
+ *   max: 5,
+ * });
+ *
+ * guests.items.map((guest, i) => (
+ *   <FieldFlowInput
+ *     key={i}
+ *     label={`Guest ${i + 1}`}
+ *     value={guest.name}
+ *     onChangeText={name => guests.update(i, g => ({ ...g, name }))}
+ *   />
+ * ));
+ */
+export declare function useFieldFlowArray<TItem>({ initialItems, createItem, max, min, }: UseFieldFlowArrayOptions<TItem>): UseFieldFlowArrayResult<TItem>;
+//# sourceMappingURL=useFieldFlowArray.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFlowArray.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFieldFlowArray.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB,CAAC,KAAK;IAC7C,mCAAmC;IACnC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IACvB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,KAAK,CAAC;IACxB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB,CAAC,KAAK;IAC5C,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAClE,mFAAmF;IACnF,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,MAAM,CAAC;IACjC,0DAA0D;IAC1D,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,4BAA4B;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC;IACxE,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iCAAiC;IACjC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,EACvC,YAAiB,EACjB,UAAU,EACV,GAAG,EACH,GAAO,GACR,EAAE,wBAAwB,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,CA2FlE"}

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

@@ -0,0 +1,26 @@
+export interface UseFieldFlowDirtyGuardOptions {
+    /** When true, leaving the screen should confirm. */
+    isDirty: boolean;
+    enabled?: boolean;
+    title?: string;
+    message?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    /** Android hardware back — intercept when dirty. Default: true. */
+    interceptAndroidBack?: boolean;
+    /** Called when the user confirms discard. */
+    onDiscard?: () => void;
+}
+export interface UseFieldFlowDirtyGuardResult {
+    /**
+     * Call before navigating away. Returns true if navigation may proceed.
+     * Shows a confirm alert when the form is dirty.
+     */
+    confirmIfDirty: () => Promise<boolean>;
+}
+/**
+ * Warns before leaving a dirty form (Android back + imperative `confirmIfDirty`).
+ * For React Navigation, call `confirmIfDirty` inside a `beforeRemove` listener.
+ */
+export declare function useFieldFlowDirtyGuard({ isDirty, enabled, title, message, confirmLabel, cancelLabel, interceptAndroidBack, onDiscard, }: UseFieldFlowDirtyGuardOptions): UseFieldFlowDirtyGuardResult;
+//# sourceMappingURL=useFieldFlowDirtyGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFlowDirtyGuard.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFieldFlowDirtyGuard.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,6BAA6B;IAC5C,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,OAAc,EACd,KAA0B,EAC1B,OAA2D,EAC3D,YAAwB,EACxB,WAAoB,EACpB,oBAA2B,EAC3B,SAAS,GACV,EAAE,6BAA6B,GAAG,4BAA4B,CA+B9D"}

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

@@ -0,0 +1,64 @@
+/**
+ * Minimal async key-value storage. Pass AsyncStorage, MMKV wrapper, or any custom backend.
+ *
+ * @example
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * const storage = {
+ *   getItem: (k) => AsyncStorage.getItem(k),
+ *   setItem: (k, v) => AsyncStorage.setItem(k, v),
+ *   removeItem: (k) => AsyncStorage.removeItem(k),
+ * };
+ */
+export interface FieldFlowDraftStorage {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+}
+export interface FieldFlowDraftPayload<T extends Record<string, string>> {
+    values: T;
+    savedAt: number;
+    version: 1;
+}
+export interface UseFieldFlowDraftOptions<T extends Record<string, string>> {
+    /** Unique storage key, e.g. `signup-form-v1`. */
+    key: string;
+    storage: FieldFlowDraftStorage;
+    /** Live form values to persist. */
+    values: T;
+    /** Apply restored values (typically `form` helpers or `setValues`). */
+    onRestore: (values: T) => void;
+    /** Fields never written to storage (passwords, OTPs, card numbers). */
+    exclude?: (keyof T)[];
+    /** Debounce writes while typing. Default: 600ms. */
+    debounceMs?: number;
+    /** Discard drafts older than this many ms. Default: 7 days. */
+    ttlMs?: number;
+    /** When true (default), auto-load a valid draft on mount and surface `hasDraft`. */
+    autoLoad?: boolean;
+    /** Disable all persistence (useful in tests). */
+    enabled?: boolean;
+}
+export interface UseFieldFlowDraftResult<T extends Record<string, string>> {
+    /** True once the initial storage read has finished. */
+    ready: boolean;
+    /** A valid draft exists that has not yet been resumed or discarded. */
+    hasDraft: boolean;
+    /** Timestamp of the pending draft, if any. */
+    draftSavedAt: number | null;
+    /** Snapshot of the pending draft values (before resume). */
+    draftValues: T | null;
+    /** Apply the pending draft via `onRestore` and clear the banner state. */
+    resume: () => void;
+    /** Delete the draft and hide the banner. */
+    discard: () => Promise<void>;
+    /** Force an immediate save of current values. */
+    saveNow: () => Promise<void>;
+    /** Clear storage for this key. */
+    clear: () => Promise<void>;
+}
+/**
+ * Debounced draft persistence for FieldFlow forms. Storage is injected so the
+ * package stays free of native / peer storage dependencies.
+ */
+export declare function useFieldFlowDraft<T extends Record<string, string>>({ key, storage, values, onRestore, exclude, debounceMs, ttlMs, autoLoad, enabled, }: UseFieldFlowDraftOptions<T>): UseFieldFlowDraftResult<T>;
+//# sourceMappingURL=useFieldFlowDraft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFlowDraft.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFieldFlowDraft.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACrE,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxE,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,qBAAqB,CAAC;IAC/B,mCAAmC;IACnC,MAAM,EAAE,CAAC,CAAC;IACV,uEAAuE;IACvE,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACvE,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4DAA4D;IAC5D,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,iDAAiD;IACjD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,kCAAkC;IAClC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAClE,GAAG,EACH,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,UAAgB,EAChB,KAA+B,EAC/B,QAAe,EACf,OAAc,GACf,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAkI1D"}

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

@@ -1,31 +1,148 @@
-import type { FieldFlowRules } from '../types';
+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;
 };
+export type AsyncFieldValidator<T extends Record<string, string>> = (value: string, values: T) => Promise<ValidationResult> | ValidationResult;
+export type AsyncFieldValidators<T extends Record<string, string>> = {
+    [K in keyof T]?: AsyncFieldValidator<T>;
+};
+export interface CrossFieldRule<T extends Record<string, string>> {
+    /** Field that receives the error message when validation fails. */
+    target: keyof T;
+    /** When set, this rule re-runs when any of these fields change (in addition to `target`). */
+    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>;
-    /** Called only when every field passes validation. */
+    /**
+     * Cross-field rules (e.g. password confirm). Run after per-field sync rules.
+     *
+     * @example
+     * crossFieldRules: [{
+     *   target: 'confirm',
+     *   deps: ['password'],
+     *   validate: v => v.password === v.confirm
+     *     ? { valid: true }
+     *     : { valid: false, message: 'Passwords must match' },
+     * }]
+     */
+    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.
+     */
+    formValidate?: (values: T) => Partial<Record<keyof T, string | undefined>> | Promise<Partial<Record<keyof T, string | undefined>>>;
+    /**
+     * Per-field async validators (e.g. "email already taken").
+     * Debounced on change after the field has been touched; always awaited on submit.
+     */
+    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>;
 }
 export interface UseFieldFlowFormResult<T extends Record<string, string>> {
     values: T;
     errors: Partial<Record<keyof T, string>>;
     touched: Partial<Record<keyof T, boolean>>;
+    /** Fields currently waiting on an async validator. */
+    validating: Partial<Record<keyof T, boolean>>;
     isSubmitting: boolean;
     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;
-    validateField: (field: keyof T) => boolean;
-    validateAll: () => boolean;
+    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 + whole-form validation (via the same `FieldFlowRules` used by
- * the input components), 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, 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":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KAChE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc;CAChC,CAAC;AAEF,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACvE,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC;IAC3C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;IAC3C,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACjE,aAAa,EACb,KAAK,EACL,QAAQ,GACT,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CA6FxD"}
+{"version":3,"file":"useFieldFlowForm.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFieldFlowForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjE,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,2BAA2B,EACjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KAChE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc;CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAClE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,KACN,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;AAElD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KAClE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAC9D,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,gBAAgB,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;AAExF,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACpE,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC/B,qCAAqC;IACrC,YAAY,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACnC,kFAAkF;IAClF,YAAY,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KAC7D,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACvE,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,CAAC,KACN,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1G;;;OAGG;IACH,eAAe,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC1C,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IACjD,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,wFAAwF;IACxF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IAClD,4EAA4E;IAC5E,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1E,gDAAgD;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACrE,qCAAqC;IACrC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC;IAC5C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,kDAAkD;IAClD,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,qEAAqE;IACrE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,oBAAoB,CAAC;IACxD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;IACxC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;IACxC;;;OAGG;IACH,aAAa,EAAE,CACb,KAAK,EAAE,MAAM,CAAC,KACX,IAAI,GAAG;QACV,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QACtC,MAAM,EAAE,MAAM,IAAI,CAAC;QACnB,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,8CAA8C;IAC9C,YAAY,EAAE,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IACzE,kEAAkE;IAClE,gBAAgB,EAAE,CAChB,KAAK,EAAE,MAAM,CAAC,EACd,GAAG,EAAE;QAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,KAClD,IAAI,CAAC;CACX;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACjE,aAAa,EACb,KAAK,EACL,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAqB,EACrB,YAAY,EAAE,eAAe,EAC7B,UAAU,EACV,MAAa,EACb,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,GACT,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAkcxD"}

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