form-hook-kit 1.2.0

package/dist/FormContext.d.ts

@@ -0,0 +1,8 @@
+import { FormContextValue } from './types';
+/**
+ * Form context
+ * Provides form state and methods to child components
+ */
+export declare const FormContext: import("react").Context<FormContextValue | null>;
+export default FormContext;
+//# sourceMappingURL=FormContext.d.ts.map

package/dist/FormContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContext.d.ts","sourceRoot":"","sources":["../src/FormContext.tsx"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,WAAW,kDAA+C,CAAC;AAExE,eAAe,WAAW,CAAC"}

package/dist/FormProvider.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { FormProviderProps } from './types';
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function FormProvider({ children, initialErrors, initialValues, schema, validationDebounce, }: FormProviderProps): React.JSX.Element;
+export default FormProvider;
+//# sourceMappingURL=FormProvider.d.ts.map

package/dist/FormProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormProvider.d.ts","sourceRoot":"","sources":["../src/FormProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAC,iBAAiB,EAAiB,MAAM,SAAS,CAAC;AAY1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,aAAkB,EAClB,aAAkB,EAClB,MAAM,EACN,kBAAsB,GACvB,EAAE,iBAAiB,qBAkGnB;AAED,eAAe,YAAY,CAAC"}

package/dist/devtools/FormDevTools.d.ts

@@ -0,0 +1,86 @@
+import React from 'react';
+/**
+ * DevTools mode configuration
+ */
+export type DevToolsMode = 'ui' | 'console' | 'none';
+export interface FormDevToolsProps {
+    /**
+     * Display mode for DevTools
+     * - 'ui': Shows visual UI panel (web only)
+     * - 'console': Logs to console (works everywhere, including React Native)
+     * - 'none': Disabled
+     * @default 'ui' in web, 'console' in React Native
+     */
+    mode?: DevToolsMode;
+    /**
+     * Enable automatic logging on value/error changes
+     * Only applies when mode is 'console'
+     * @default false
+     */
+    autoLog?: boolean;
+    /**
+     * Custom log prefix
+     * @default '[FormDevTools]'
+     */
+    logPrefix?: string;
+    /**
+     * Position of the UI panel (only for 'ui' mode)
+     * @default 'bottom-right'
+     */
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /**
+     * Whether UI panel is open by default (only for 'ui' mode)
+     * @default true
+     */
+    defaultOpen?: boolean;
+}
+/**
+ * FormDevTools Component
+ *
+ * A cross-platform development tool for inspecting form state in real-time.
+ *
+ * **Platform Support:**
+ * - **Web**: Shows a visual UI panel by default (`mode="ui"`)
+ * - **React Native**: Logs to console by default (`mode="console"`)
+ *   - Use with React Native Debugger, Flipper, or Metro logs
+ *
+ * @example
+ * ```tsx
+ * // Web - shows UI panel
+ * import {FormProvider} from 'form-hook-kit';
+ * import {FormDevTools} from 'form-hook-kit/devtools';
+ *
+ * function App() {
+ *   return (
+ *     <FormProvider schema={schema}>
+ *       <MyForm />
+ *       {process.env.NODE_ENV === 'development' && <FormDevTools />}
+ *     </FormProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // React Native - logs to console
+ * import {FormProvider} from 'form-hook-kit';
+ * import {FormDevTools} from 'form-hook-kit/devtools';
+ *
+ * function App() {
+ *   return (
+ *     <FormProvider schema={schema}>
+ *       <MyForm />
+ *       {__DEV__ && <FormDevTools mode="console" autoLog />}
+ *     </FormProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Force console mode (works everywhere)
+ * <FormDevTools mode="console" autoLog logPrefix="[MyForm]" />
+ * ```
+ */
+export declare function FormDevTools({ mode, autoLog, logPrefix, position, defaultOpen, }?: FormDevToolsProps): React.JSX.Element | null;
+//# sourceMappingURL=FormDevTools.d.ts.map

package/dist/devtools/FormDevTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormDevTools.d.ts","sourceRoot":"","sources":["../../src/devtools/FormDevTools.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAIzD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACrE;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,wBAAgB,YAAY,CAAC,EAC3B,IAAuC,EACvC,OAAe,EACf,SAA4B,EAC5B,QAAyB,EACzB,WAAkB,GACnB,GAAE,iBAAsB,4BAqMxB"}

package/dist/devtools/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/devtools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useForm } from './useForm';
+export { useFormField } from './useFormField';
+export { useFormPerformance, useValidationPerformance } from './useFormPerformance';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,kBAAkB,EAAE,wBAAwB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/hooks/useForm.d.ts

@@ -0,0 +1,30 @@
+import { FormContextValue } from '../types';
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function useForm(): FormContextValue;
+export default useForm;
+//# sourceMappingURL=useForm.d.ts.map

package/dist/hooks/useForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../src/hooks/useForm.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,OAAO,IAAI,gBAAgB,CAa1C;AAED,eAAe,OAAO,CAAC"}

package/dist/hooks/useFormField.d.ts

@@ -0,0 +1,40 @@
+import { FormFieldRef } from '../types';
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function useFormField(name: string): {
+    value: import("../types").FormFieldValue;
+    error: string | null;
+    onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    onChangeValue: (newValue: string | number | boolean | null | undefined) => void;
+    onBlur: () => void;
+    onFocus: () => void;
+    setRef: (ref: FormFieldRef) => void;
+    name: string;
+};
+export default useFormField;
+//# sourceMappingURL=useFormField.d.ts.map

package/dist/hooks/useFormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormField.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormField.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM;;;kBAQjC,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC;8BAOlD,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS;;;kBAejD,YAAY;;EAkBrB;AAED,eAAe,YAAY,CAAC"}

package/dist/hooks/useFormPerformance.d.ts

@@ -0,0 +1,57 @@
+import { FormFieldValue } from '../types';
+export interface PerformanceMetrics {
+    renderCount: number;
+    lastRenderTime: number;
+    fieldChangeCount: number;
+}
+/**
+ * Hook to monitor form performance metrics
+ *
+ * Useful for debugging and optimizing form performance.
+ *
+ * @returns Performance metrics object
+ *
+ * @example
+ * ```tsx
+ * function MyForm() {
+ *   const metrics = useFormPerformance();
+ *
+ *   console.log('Render count:', metrics.renderCount);
+ *   console.log('Avg validation time:', metrics.averageValidationTime);
+ *
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useFormPerformance(): PerformanceMetrics;
+/**
+ * Hook to track validation performance
+ *
+ * Wraps validation calls with timing metrics.
+ *
+ * @returns Object with tracked validateField and validateForm functions
+ *
+ * @example
+ * ```tsx
+ * function MyForm() {
+ *   const {validateField, validateForm, metrics} = useValidationPerformance();
+ *
+ *   const handleSubmit = () => {
+ *     validateForm();
+ *     console.log('Validation took:', metrics.lastValidationTime, 'ms');
+ *   };
+ *
+ *   return <button onClick={handleSubmit}>Submit</button>;
+ * }
+ * ```
+ */
+export declare function useValidationPerformance(): {
+    validateField: (name: string, value?: FormFieldValue) => string | null;
+    validateForm: () => Record<string, string | null>;
+    metrics: {
+        lastValidationTime: number;
+        totalValidations: number;
+        averageValidationTime: number;
+    };
+};
+//# sourceMappingURL=useFormPerformance.d.ts.map

package/dist/hooks/useFormPerformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormPerformance.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormPerformance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,cAAc,EAAC,MAAM,UAAU,CAAC;AAGxC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,CAiCvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB;0BAST,MAAM,UAAU,cAAc;;;;;;;EA2C5D"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * form-hook-kit
+ *
+ * A lightweight, flexible form management library for React and React Native
+ * using React Context and Yup validation.
+ */
+export { FormProvider } from './FormProvider';
+export { FormContext } from './FormContext';
+export { useForm, useFormField } from './hooks';
+export type { FormContextValue, FormProviderProps, FormState, FormActions, FormAction, } from './types';
+export { getFieldError, getFormErrors, formReducer, generateChangeValue, generateChangeValues, generateClearError, generateSetError, generateValidateField, generateValidateForm, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAC,OAAO,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AAG9C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}