form-hook-kit 1.2.0

package/dist/index.js

@@ -0,0 +1,408 @@
+'use strict';
+
+var React = require('react');
+var yup = require('yup');
+
+/**
+ * Form context
+ * Provides form state and methods to child components
+ */
+const FormContext = React.createContext(null);
+
+/**
+ * Get validation error for a specific field
+ * @param name - Field name
+ * @param schema - Yup schema
+ * @param values - Current form values
+ * @returns Error message or null if valid
+ */
+function getFieldError({ name, schema, values, }) {
+    try {
+        schema.validateSyncAt(name, values);
+        return null;
+    }
+    catch (error) {
+        if (error instanceof yup.ValidationError) {
+            return error.message;
+        }
+        return 'Validation error';
+    }
+}
+/**
+ * Get validation errors for entire form
+ * @param schema - Yup schema
+ * @param values - Current form values
+ * @returns Object with errors by field name
+ */
+function getFormErrors({ schema, values, }) {
+    // Type guard to check if schema is an ObjectSchema with fields
+    const objectSchema = schema;
+    const fields = objectSchema.fields
+        ? Object.keys(objectSchema.fields)
+        : Object.keys(values);
+    return fields.reduce((acc, field) => {
+        acc[field] = getFieldError({ name: field, schema, values });
+        return acc;
+    }, {});
+}
+
+/**
+ * Form actions
+ */
+var FormActions;
+(function (FormActions) {
+    FormActions["UPDATE_ERRORS"] = "UPDATE_ERRORS";
+    FormActions["UPDATE_VALUES"] = "UPDATE_VALUES";
+})(FormActions || (FormActions = {}));
+
+/**
+ * Form state reducer
+ * Manages form state updates for values and errors
+ */
+function formReducer(state, action) {
+    switch (action.type) {
+        case FormActions.UPDATE_ERRORS:
+            return {
+                ...state,
+                errors: {
+                    ...state.errors,
+                    ...action.payload,
+                },
+            };
+        case FormActions.UPDATE_VALUES:
+            return {
+                ...state,
+                values: action.payload,
+            };
+        default:
+            return state;
+    }
+}
+
+/**
+ * Generate changeValue function
+ * Updates a single field value
+ */
+function generateChangeValue({ dispatch, values, }) {
+    return ({ name, value }) => {
+        const payload = { ...values };
+        payload[name] = value;
+        dispatch({
+            payload,
+            type: FormActions.UPDATE_VALUES,
+        });
+    };
+}
+/**
+ * Generate changeValues function
+ * Updates multiple field values at once
+ */
+function generateChangeValues({ dispatch, }) {
+    return (values) => {
+        dispatch({
+            payload: values,
+            type: FormActions.UPDATE_VALUES,
+        });
+    };
+}
+/**
+ * Generate clearError function
+ * Clears error for a specific field
+ */
+function generateClearError({ dispatch, }) {
+    return (name) => {
+        dispatch({
+            payload: { [name]: null },
+            type: FormActions.UPDATE_ERRORS,
+        });
+    };
+}
+/**
+ * Generate setError function
+ * Sets error for a specific field
+ */
+function generateSetError({ dispatch, }) {
+    return ({ error, name }) => {
+        dispatch({
+            payload: { [name]: error },
+            type: FormActions.UPDATE_ERRORS,
+        });
+    };
+}
+/**
+ * Generate validateField function
+ * Validates a single field against the schema
+ */
+function generateValidateField({ dispatch, schema, values, }) {
+    return (name, value) => {
+        const newErrors = {};
+        newErrors[name] = getFieldError({
+            name,
+            schema,
+            values: value === undefined ? values : { ...values, [name]: value },
+        });
+        dispatch({
+            payload: newErrors,
+            type: FormActions.UPDATE_ERRORS,
+        });
+        return newErrors[name];
+    };
+}
+/**
+ * Generate validateForm function
+ * Validates entire form against the schema
+ */
+function generateValidateForm({ dispatch, schema, values, }) {
+    return () => {
+        const newErrors = getFormErrors({ schema, values });
+        dispatch({
+            payload: newErrors,
+            type: FormActions.UPDATE_ERRORS,
+        });
+        return newErrors;
+    };
+}
+
+/**
+ * Creates a debounced function that delays invoking func until after wait milliseconds
+ * have elapsed since the last time the debounced function was invoked.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function debounce(func, wait) {
+    let timeoutId;
+    return function debounced(...args) {
+        if (timeoutId !== undefined) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            func(...args);
+        }, wait);
+    };
+}
+
+/**
+ * Enhanced error messages with helpful suggestions
+ */
+class FormHookKitError extends Error {
+    constructor(message, suggestion) {
+        super(message);
+        this.suggestion = suggestion;
+        this.name = 'FormHookKitError';
+    }
+}
+function createContextError() {
+    return new FormHookKitError('useForm must be used within a FormProvider', 'Wrap your component tree with <FormProvider> to use form hooks. Example:\n\n' +
+        '<FormProvider schema={schema} initialValues={{}}>\n' +
+        '  <YourComponent />\n' +
+        '</FormProvider>');
+}
+
+/**
+ * Form Provider Component
+ *
+ * Wraps your form and provides form state management using React Context.
+ * Integrates with Yup for validation.
+ *
+ * @example
+ * ```tsx
+ * import * as yup from 'yup';
+ * import {FormProvider} from 'form-hook-kit';
+ *
+ * const schema = yup.object({
+ *   email: yup.string().email().required(),
+ *   password: yup.string().min(8).required(),
+ * });
+ *
+ * function MyForm() {
+ *   return (
+ *     <FormProvider
+ *       schema={schema}
+ *       initialValues={{ email: '', password: '' }}
+ *     >
+ *       <MyFormFields />
+ *     </FormProvider>
+ *   );
+ * }
+ * ```
+ */
+function FormProvider({ children, initialErrors = {}, initialValues = {}, schema, validationDebounce = 0, }) {
+    const fieldRefs = React.useRef({});
+    const [state, dispatch] = React.useReducer(formReducer, {
+        errors: initialErrors,
+        values: initialValues,
+    });
+    // Memoize action generators to prevent unnecessary re-renders
+    const changeValue = React.useMemo(() => generateChangeValue({ dispatch, values: state.values }), [state.values]);
+    const changeValues = React.useMemo(() => generateChangeValues({ dispatch }), []);
+    const clearError = React.useMemo(() => generateClearError({ dispatch }), []);
+    const setError = React.useMemo(() => generateSetError({ dispatch }), []);
+    // Create validation functions with optional debouncing
+    const validateField = React.useMemo(() => {
+        const validator = generateValidateField({
+            dispatch,
+            schema,
+            values: state.values,
+        });
+        if (validationDebounce > 0) {
+            const debouncedValidator = debounce(validator, validationDebounce);
+            // Return a wrapper that calls debounced but still returns the result synchronously
+            return (name, value) => {
+                debouncedValidator(name, value);
+                return validator(name, value);
+            };
+        }
+        return validator;
+    }, [schema, state.values, validationDebounce]);
+    const validateForm = React.useMemo(() => {
+        const validator = generateValidateForm({
+            dispatch,
+            schema,
+            values: state.values,
+        });
+        if (validationDebounce > 0) {
+            const debouncedValidator = debounce(validator, validationDebounce);
+            // Return a wrapper that calls debounced but still returns the result synchronously
+            return () => {
+                debouncedValidator();
+                return validator();
+            };
+        }
+        return validator;
+    }, [schema, state.values, validationDebounce]);
+    // Memoize context value to prevent unnecessary re-renders of consumers
+    const contextValue = React.useMemo(() => ({
+        fieldRefs,
+        errors: state.errors,
+        values: state.values,
+        changeValue,
+        changeValues,
+        clearError,
+        setError,
+        validateField,
+        validateForm,
+    }), [
+        state.errors,
+        state.values,
+        changeValue,
+        changeValues,
+        clearError,
+        setError,
+        validateField,
+        validateForm,
+    ]);
+    return (React.createElement(FormContext.Provider, { value: contextValue }, children));
+}
+
+/**
+ * Hook to access form context
+ *
+ * Must be used within a FormProvider component.
+ * Provides access to form state, values, errors, and methods.
+ *
+ * @returns Form context value with state and methods
+ *
+ * @example
+ * ```tsx
+ * function MyFormField() {
+ *   const {values, errors, changeValue, validateField} = useForm();
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={values.email || ''}
+ *         onChange={(e) => changeValue({name: 'email', value: e.target.value})}
+ *         onBlur={() => validateField('email')}
+ *       />
+ *       {errors.email && <span>{errors.email}</span>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useForm() {
+    const context = React.useContext(FormContext);
+    if (!context) {
+        const error = createContextError();
+        // Log suggestion to console for better DX
+        if (error.suggestion) {
+            console.error(error.suggestion);
+        }
+        throw error;
+    }
+    return context;
+}
+
+/**
+ * Hook for managing a single form field
+ *
+ * Provides field-specific state and handlers for common field operations.
+ *
+ * @param name - Field name
+ * @returns Field state and handlers
+ *
+ * @example
+ * ```tsx
+ * function EmailField() {
+ *   const {value, error, onChange, onBlur} = useFormField('email');
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         type="email"
+ *         value={value || ''}
+ *         onChange={onChange}
+ *         onBlur={onBlur}
+ *       />
+ *       {error && <span className="error">{error}</span>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useFormField(name) {
+    const { values, errors, changeValue, validateField, clearError, fieldRefs } = useForm();
+    const value = values[name];
+    const error = errors[name];
+    const onChange = React.useCallback((e) => {
+        changeValue({ name, value: e.target.value });
+    }, [name, changeValue]);
+    const onChangeValue = React.useCallback((newValue) => {
+        changeValue({ name, value: newValue });
+    }, [name, changeValue]);
+    const onBlur = React.useCallback(() => {
+        validateField(name);
+    }, [name, validateField]);
+    const onFocus = React.useCallback(() => {
+        clearError(name);
+    }, [name, clearError]);
+    const setRef = React.useCallback((ref) => {
+        if (ref) {
+            fieldRefs.current[name] = ref;
+        }
+    }, [name, fieldRefs]);
+    return {
+        value,
+        error,
+        onChange,
+        onChangeValue,
+        onBlur,
+        onFocus,
+        setRef,
+        name,
+    };
+}
+
+exports.FormContext = FormContext;
+exports.FormProvider = FormProvider;
+exports.formReducer = formReducer;
+exports.generateChangeValue = generateChangeValue;
+exports.generateChangeValues = generateChangeValues;
+exports.generateClearError = generateClearError;
+exports.generateSetError = generateSetError;
+exports.generateValidateField = generateValidateField;
+exports.generateValidateForm = generateValidateForm;
+exports.getFieldError = getFieldError;
+exports.getFormErrors = getFormErrors;
+exports.useForm = useForm;
+exports.useFormField = useFormField;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/FormContext.tsx","../src/utils/validation.ts","../src/types/index.ts","../src/utils/formReducer.ts","../src/utils/formActions.ts","../src/utils/debounce.ts","../src/utils/errors.ts","../src/FormProvider.tsx","../src/hooks/useForm.ts","../src/hooks/useFormField.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null],"names":["createContext","ValidationError","useRef","useReducer","useMemo","useContext","useCallback"],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,94 @@
+import { AnySchema } from 'yup';
+/**
+ * Generic form field value type
+ */
+export type FormFieldValue = string | number | boolean | null | undefined;
+/**
+ * Form values object
+ */
+export type FormValues = Record<string, FormFieldValue>;
+/**
+ * Minimal interface for form field refs
+ * Works with both web inputs and React Native TextInput
+ */
+export interface FocusableElement {
+    focus: () => void;
+}
+/**
+ * Form field ref type (for React Native TextInput or HTML input elements)
+ *
+ * Supports both web (HTMLInputElement, HTMLTextAreaElement) and React Native (any object with focus method)
+ */
+export type FormFieldRef = FocusableElement | null;
+/**
+ * Form context state
+ */
+export interface FormState {
+    errors: Record<string, string | null>;
+    values: FormValues;
+}
+/**
+ * Form context value interface
+ */
+export interface FormContextValue {
+    /** Refs to form fields for focus management */
+    fieldRefs: React.MutableRefObject<Record<string, FormFieldRef>>;
+    /** Current form errors by field name */
+    errors: Record<string, string | null>;
+    /** Current form values by field name */
+    values: FormValues;
+    /** Change a single field value */
+    changeValue: (params: {
+        name: string;
+        value: FormFieldValue;
+    }) => void;
+    /** Change multiple field values at once */
+    changeValues: (values: FormValues) => void;
+    /** Clear error for a specific field */
+    clearError: (name: string) => void;
+    /** Set error for a specific field */
+    setError: (params: {
+        name: string;
+        error: string;
+    }) => void;
+    /** Validate a single field and return error if any */
+    validateField: (name: string, value?: FormFieldValue) => string | null;
+    /** Validate entire form and return errors object */
+    validateForm: () => Record<string, string | null>;
+}
+/**
+ * Form provider props
+ */
+export interface FormProviderProps {
+    /** Form child components */
+    children: React.ReactNode;
+    /** Initial error state */
+    initialErrors?: Record<string, string>;
+    /** Initial form values */
+    initialValues?: FormValues;
+    /** Yup validation schema */
+    schema: AnySchema;
+    /**
+     * Debounce validation in milliseconds. Useful for performance optimization.
+     * @default 0 (no debounce)
+     */
+    validationDebounce?: number;
+}
+/**
+ * Form actions
+ */
+export declare enum FormActions {
+    UPDATE_ERRORS = "UPDATE_ERRORS",
+    UPDATE_VALUES = "UPDATE_VALUES"
+}
+/**
+ * Form action types
+ */
+export type FormAction = {
+    type: FormActions.UPDATE_ERRORS;
+    payload: Record<string, string | null>;
+} | {
+    type: FormActions.UPDATE_VALUES;
+    payload: FormValues;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,KAAK,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAChE,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,wCAAwC;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,kCAAkC;IAClC,WAAW,EAAE,CAAC,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAC,KAAK,IAAI,CAAC;IACrE,2CAA2C;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C,uCAAuC;IACvC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,qCAAqC;IACrC,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,KAAK,IAAI,CAAC;IAC1D,sDAAsD;IACtD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;IACvE,oDAAoD;IACpD,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,0BAA0B;IAC1B,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACxC,GACD;IACE,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC;IAChC,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC"}

package/dist/utils/debounce.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a debounced function that delays invoking func until after wait milliseconds
+ * have elapsed since the last time the debounced function was invoked.
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/utils/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Enhanced error messages with helpful suggestions
+ */
+export declare class FormHookKitError extends Error {
+    suggestion?: string | undefined;
+    constructor(message: string, suggestion?: string | undefined);
+}
+export declare function createContextError(): FormHookKitError;
+export declare function createInvalidSchemaError(): FormHookKitError;
+export declare function createValidationError(fieldName: string, error: string): FormHookKitError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACL,UAAU,CAAC,EAAE,MAAM;gBAA3C,OAAO,EAAE,MAAM,EAAS,UAAU,CAAC,EAAE,MAAM,YAAA;CAIxD;AAED,wBAAgB,kBAAkB,IAAI,gBAAgB,CAQrD;AAED,wBAAgB,wBAAwB,IAAI,gBAAgB,CAU3D;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAKxF"}

package/dist/utils/formActions.d.ts

@@ -0,0 +1,57 @@
+import { Dispatch } from 'react';
+import { AnySchema } from 'yup';
+import { FormAction, FormValues, FormFieldValue } from '../types';
+/**
+ * Generate changeValue function
+ * Updates a single field value
+ */
+export declare function generateChangeValue({ dispatch, values, }: {
+    dispatch: Dispatch<FormAction>;
+    values: FormValues;
+}): ({ name, value }: {
+    name: string;
+    value: FormFieldValue;
+}) => void;
+/**
+ * Generate changeValues function
+ * Updates multiple field values at once
+ */
+export declare function generateChangeValues({ dispatch, }: {
+    dispatch: Dispatch<FormAction>;
+}): (values: FormValues) => void;
+/**
+ * Generate clearError function
+ * Clears error for a specific field
+ */
+export declare function generateClearError({ dispatch, }: {
+    dispatch: Dispatch<FormAction>;
+}): (name: string) => void;
+/**
+ * Generate setError function
+ * Sets error for a specific field
+ */
+export declare function generateSetError({ dispatch, }: {
+    dispatch: Dispatch<FormAction>;
+}): ({ error, name }: {
+    error: string;
+    name: string;
+}) => void;
+/**
+ * Generate validateField function
+ * Validates a single field against the schema
+ */
+export declare function generateValidateField({ dispatch, schema, values, }: {
+    dispatch: Dispatch<FormAction>;
+    schema: AnySchema;
+    values: FormValues;
+}): (name: string, value?: FormFieldValue) => string | null;
+/**
+ * Generate validateForm function
+ * Validates entire form against the schema
+ */
+export declare function generateValidateForm({ dispatch, schema, values, }: {
+    dispatch: Dispatch<FormAction>;
+    schema: AnySchema;
+    values: FormValues;
+}): () => Record<string, string | null>;
+//# sourceMappingURL=formActions.d.ts.map

package/dist/utils/formActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formActions.d.ts","sourceRoot":"","sources":["../../src/utils/formActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAC,SAAS,EAAC,MAAM,KAAK,CAAC;AAC9B,OAAO,EAAc,UAAU,EAAE,UAAU,EAAE,cAAc,EAAC,MAAM,UAAU,CAAC;AAG7E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,EAAE,UAAU,CAAC;CACpB,IACS,iBAAe;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAC,UAS7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CAChC,IACS,QAAQ,UAAU,UAM3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CAChC,IACS,MAAM,MAAM,UAMrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CAChC,IACS,iBAAe;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,UAMrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,MAAM,EACN,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB,IACS,MAAM,MAAM,EAAE,QAAQ,cAAc,KAAG,MAAM,GAAG,IAAI,CAe7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,MAAM,EACN,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB,SACY,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAUzC"}

package/dist/utils/formReducer.d.ts

@@ -0,0 +1,7 @@
+import { FormAction, FormState } from '../types';
+/**
+ * Form state reducer
+ * Manages form state updates for values and errors
+ */
+export declare function formReducer(state: FormState, action: FormAction): FormState;
+//# sourceMappingURL=formReducer.d.ts.map

package/dist/utils/formReducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formReducer.d.ts","sourceRoot":"","sources":["../../src/utils/formReducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAkB3E"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './validation';
+export * from './formReducer';
+export * from './formActions';
+export * from './debounce';
+export * from './errors';
+export * from './performance';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/utils/performance.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cross-platform performance utilities
+ *
+ * Provides performance.now() polyfill for React Native
+ */
+export declare const now: () => number;
+//# sourceMappingURL=performance.d.ts.map

package/dist/utils/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/utils/performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,GAAG,QAAO,MAKtB,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,25 @@
+import { AnySchema } from 'yup';
+import { FormValues } from '../types';
+/**
+ * Get validation error for a specific field
+ * @param name - Field name
+ * @param schema - Yup schema
+ * @param values - Current form values
+ * @returns Error message or null if valid
+ */
+export declare function getFieldError({ name, schema, values, }: {
+    name: string;
+    schema: AnySchema;
+    values: FormValues;
+}): string | null;
+/**
+ * Get validation errors for entire form
+ * @param schema - Yup schema
+ * @param values - Current form values
+ * @returns Object with errors by field name
+ */
+export declare function getFormErrors({ schema, values, }: {
+    schema: AnySchema;
+    values: FormValues;
+}): Record<string, string | null>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAgC,MAAM,KAAK,CAAC;AAC7D,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,MAAM,EACN,MAAM,GACP,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB,GAAG,MAAM,GAAG,IAAI,CAUhB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,MAAM,GACP,EAAE;IACD,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAWhC"}