form-hook-kit 1.2.0 → 1.2.2

package/dist/devtools/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/devtools/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/devtools/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/devtools/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/devtools/index.esm.js

@@ -0,0 +1,203 @@
+import React, { useState, useRef, useEffect } from 'react';
+import { useForm, useFormPerformance } from 'form-hook-kit';
+
+// Detect if we're in React Native environment
+/* istanbul ignore next */
+const isReactNative = typeof navigator !== 'undefined' &&
+    navigator.product === 'ReactNative';
+/**
+ * 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]" />
+ * ```
+ */
+// istanbul ignore next - default mode detection is platform-specific and untestable
+function FormDevTools({ mode = isReactNative ? 'console' : 'ui', autoLog = false, logPrefix = '[FormDevTools]', position = 'bottom-right', defaultOpen = true, } = {}) {
+    const { values, errors } = useForm();
+    const metrics = useFormPerformance();
+    const [isOpen, setIsOpen] = useState(defaultOpen);
+    const [activeTab, setActiveTab] = useState('values');
+    const prevValuesRef = useRef(values);
+    const prevErrorsRef = useRef(errors);
+    // Console logging mode
+    useEffect(() => {
+        if (mode === 'console') {
+            if (autoLog) {
+                // Log when values change
+                if (prevValuesRef.current !== values) {
+                    console.log(`${logPrefix} Values:`, values);
+                    prevValuesRef.current = values;
+                }
+                // Log when errors change
+                if (prevErrorsRef.current !== errors) {
+                    console.log(`${logPrefix} Errors:`, errors);
+                    prevErrorsRef.current = errors;
+                }
+            }
+        }
+    }, [values, errors, mode, autoLog, logPrefix]);
+    // Expose global logging functions for manual inspection
+    useEffect(() => {
+        if (mode === 'console') {
+            const globalObj = typeof globalThis !== 'undefined' ? globalThis : /* istanbul ignore next */ (typeof window !== 'undefined' ? window : undefined);
+            /* istanbul ignore else */
+            if (globalObj) {
+                // Adding to global for debugging
+                globalObj.formDevTools = {
+                    logValues: () => console.log(`${logPrefix} Values:`, values),
+                    logErrors: () => console.log(`${logPrefix} Errors:`, errors),
+                    logMetrics: () => console.log(`${logPrefix} Performance:`, metrics),
+                    logAll: () => {
+                        console.log(`${logPrefix} === Form State ===`);
+                        console.log('Values:', values);
+                        console.log('Errors:', errors);
+                        console.log('Performance:', metrics);
+                    },
+                };
+            }
+        }
+    }, [values, errors, metrics, mode, logPrefix]);
+    // If mode is 'none' or 'console', don't render UI
+    if (mode === 'none' || mode === 'console') {
+        return null;
+    }
+    // UI mode (web only)
+    /* istanbul ignore next */
+    if (isReactNative && mode === 'ui') {
+        console.warn(`${logPrefix} UI mode is not supported in React Native. Use mode="console" instead.`);
+        return null;
+    }
+    const positionStyles = {
+        'top-left': { top: 10, left: 10 },
+        'top-right': { top: 10, right: 10 },
+        'bottom-left': { bottom: 10, left: 10 },
+        'bottom-right': { bottom: 10, right: 10 },
+    };
+    const containerStyle = {
+        position: 'fixed',
+        ...positionStyles[position],
+        zIndex: 999999,
+        fontFamily: 'monospace',
+        fontSize: 12,
+    };
+    const panelStyle = {
+        backgroundColor: '#1e1e1e',
+        color: '#d4d4d4',
+        border: '1px solid #3e3e3e',
+        borderRadius: 4,
+        padding: 12,
+        minWidth: 300,
+        maxWidth: 500,
+        maxHeight: 400,
+        overflow: 'auto',
+        boxShadow: '0 4px 12px rgba(0,0,0,0.3)',
+    };
+    const toggleButtonStyle = {
+        position: 'absolute',
+        top: -10,
+        right: -10,
+        backgroundColor: '#007acc',
+        color: 'white',
+        border: 'none',
+        borderRadius: '50%',
+        width: 30,
+        height: 30,
+        cursor: 'pointer',
+        fontSize: 16,
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+    };
+    const tabStyle = {
+        display: 'inline-block',
+        padding: '4px 8px',
+        marginRight: 8,
+        cursor: 'pointer',
+        borderRadius: 3,
+        backgroundColor: '#2d2d2d',
+    };
+    const activeTabStyle = {
+        ...tabStyle,
+        backgroundColor: '#007acc',
+    };
+    const codeStyle = {
+        backgroundColor: '#2d2d2d',
+        padding: 8,
+        borderRadius: 3,
+        overflow: 'auto',
+        maxHeight: 250,
+    };
+    return (React.createElement("div", { style: containerStyle },
+        React.createElement("button", { style: toggleButtonStyle, onClick: () => setIsOpen(!isOpen), "aria-label": "Toggle DevTools" }, "\uD83D\uDD27"),
+        isOpen && (React.createElement("div", { style: panelStyle },
+            React.createElement("div", { style: { marginBottom: 12, fontWeight: 'bold', fontSize: 14 } }, "Form DevTools"),
+            React.createElement("div", { style: { marginBottom: 12 } },
+                React.createElement("span", { style: activeTab === 'values' ? activeTabStyle : tabStyle, onClick: () => setActiveTab('values') }, "Values"),
+                React.createElement("span", { style: activeTab === 'errors' ? activeTabStyle : tabStyle, onClick: () => setActiveTab('errors') }, "Errors"),
+                React.createElement("span", { style: activeTab === 'performance' ? activeTabStyle : tabStyle, onClick: () => setActiveTab('performance') }, "Performance")),
+            activeTab === 'values' && (React.createElement("div", null,
+                React.createElement("div", { style: { marginBottom: 8, color: '#888' } }, "Current Values:"),
+                React.createElement("pre", { style: codeStyle }, JSON.stringify(values, null, 2)))),
+            activeTab === 'errors' && (React.createElement("div", null,
+                React.createElement("div", { style: { marginBottom: 8, color: '#888' } }, "Errors:"),
+                React.createElement("pre", { style: codeStyle }, JSON.stringify(errors, null, 2)))),
+            activeTab === 'performance' && (React.createElement("div", null,
+                React.createElement("div", { style: { marginBottom: 8, color: '#888' } }, "Performance Metrics:"),
+                React.createElement("div", { style: codeStyle },
+                    React.createElement("div", null,
+                        "Render Count: ",
+                        metrics.renderCount),
+                    React.createElement("div", null,
+                        "Last Render: ",
+                        metrics.lastRenderTime,
+                        "ms"),
+                    React.createElement("div", null,
+                        "Field Changes: ",
+                        metrics.fieldChangeCount)),
+                React.createElement("div", { style: { marginTop: 12, fontSize: 11, color: '#888' } }, "Note: For validation metrics, use useValidationPerformance hook")))))));
+}
+
+export { FormDevTools };
+//# sourceMappingURL=index.esm.js.map

package/dist/devtools/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../src/src/devtools/FormDevTools.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;AA2CA;AACA;AACA,MAAM,aAAa,GACjB,OAAO,SAAS,KAAK,WAAW;AAChC,IAAA,SAAS,CAAC,OAAO,KAAK,aAAa;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CG;AACH;AACM,SAAU,YAAY,CAAC,EAC3B,IAAI,GAAG,aAAa,GAAG,SAAS,GAAG,IAAI,EACvC,OAAO,GAAG,KAAK,EACf,SAAS,GAAG,gBAAgB,EAC5B,QAAQ,GAAG,cAAc,EACzB,WAAW,GAAG,IAAI,MACG,EAAE,EAAA;IACvB,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,OAAO,EAAE;AAClC,IAAA,MAAM,OAAO,GAAG,kBAAkB,EAAE;IACpC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;IACjD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAsC,QAAQ,CAAC;AACzF,IAAA,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;AACpC,IAAA,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;;IAGpC,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,IAAI,KAAK,SAAS,EAAE;YACtB,IAAI,OAAO,EAAE;;AAEX,gBAAA,IAAI,aAAa,CAAC,OAAO,KAAK,MAAM,EAAE;oBACpC,OAAO,CAAC,GAAG,CAAC,CAAA,EAAG,SAAS,CAAA,QAAA,CAAU,EAAE,MAAM,CAAC;AAC3C,oBAAA,aAAa,CAAC,OAAO,GAAG,MAAM;gBAChC;;AAEA,gBAAA,IAAI,aAAa,CAAC,OAAO,KAAK,MAAM,EAAE;oBACpC,OAAO,CAAC,GAAG,CAAC,CAAA,EAAG,SAAS,CAAA,QAAA,CAAU,EAAE,MAAM,CAAC;AAC3C,oBAAA,aAAa,CAAC,OAAO,GAAG,MAAM;gBAChC;YACF;QACF;AACF,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;;IAG9C,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,IAAI,KAAK,SAAS,EAAE;AACtB,YAAA,MAAM,SAAS,GAAG,OAAO,UAAU,KAAK,WAAW,GAAG,UAAU,+BAA+B,OAAO,MAAM,KAAK,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;;YAElJ,IAAI,SAAS,EAAE;;gBAEZ,SAAqC,CAAC,YAAY,GAAG;AACpD,oBAAA,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA,EAAG,SAAS,CAAA,QAAA,CAAU,EAAE,MAAM,CAAC;AAC5D,oBAAA,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA,EAAG,SAAS,CAAA,QAAA,CAAU,EAAE,MAAM,CAAC;AAC5D,oBAAA,UAAU,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA,EAAG,SAAS,CAAA,aAAA,CAAe,EAAE,OAAO,CAAC;oBACnE,MAAM,EAAE,MAAK;AACX,wBAAA,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA,mBAAA,CAAqB,CAAC;AAC9C,wBAAA,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC;AAC9B,wBAAA,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC;AAC9B,wBAAA,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC;oBACtC,CAAC;iBACF;YACH;QACF;AACF,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;;IAG9C,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,EAAE;AACzC,QAAA,OAAO,IAAI;IACb;;;AAIA,IAAA,IAAI,aAAa,IAAI,IAAI,KAAK,IAAI,EAAE;AAClC,QAAA,OAAO,CAAC,IAAI,CACV,GAAG,SAAS,CAAA,sEAAA,CAAwE,CACrF;AACD,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,cAAc,GAAwC;QAC1D,UAAU,EAAE,EAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAC;QAC/B,WAAW,EAAE,EAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAC;QACjC,aAAa,EAAE,EAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAC;QACrC,cAAc,EAAE,EAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAC;KACxC;AAED,IAAA,MAAM,cAAc,GAAwB;AAC1C,QAAA,QAAQ,EAAE,OAAO;QACjB,GAAG,cAAc,CAAC,QAAQ,CAAC;AAC3B,QAAA,MAAM,EAAE,MAAM;AACd,QAAA,UAAU,EAAE,WAAW;AACvB,QAAA,QAAQ,EAAE,EAAE;KACb;AAED,IAAA,MAAM,UAAU,GAAwB;AACtC,QAAA,eAAe,EAAE,SAAS;AAC1B,QAAA,KAAK,EAAE,SAAS;AAChB,QAAA,MAAM,EAAE,mBAAmB;AAC3B,QAAA,YAAY,EAAE,CAAC;AACf,QAAA,OAAO,EAAE,EAAE;AACX,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,SAAS,EAAE,GAAG;AACd,QAAA,QAAQ,EAAE,MAAM;AAChB,QAAA,SAAS,EAAE,4BAA4B;KACxC;AAED,IAAA,MAAM,iBAAiB,GAAwB;AAC7C,QAAA,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,GAAG;AACV,QAAA,eAAe,EAAE,SAAS;AAC1B,QAAA,KAAK,EAAE,OAAO;AACd,QAAA,MAAM,EAAE,MAAM;AACd,QAAA,YAAY,EAAE,KAAK;AACnB,QAAA,KAAK,EAAE,EAAE;AACT,QAAA,MAAM,EAAE,EAAE;AACV,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,OAAO,EAAE,MAAM;AACf,QAAA,UAAU,EAAE,QAAQ;AACpB,QAAA,cAAc,EAAE,QAAQ;KACzB;AAED,IAAA,MAAM,QAAQ,GAAwB;AACpC,QAAA,OAAO,EAAE,cAAc;AACvB,QAAA,OAAO,EAAE,SAAS;AAClB,QAAA,WAAW,EAAE,CAAC;AACd,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,YAAY,EAAE,CAAC;AACf,QAAA,eAAe,EAAE,SAAS;KAC3B;AAED,IAAA,MAAM,cAAc,GAAwB;AAC1C,QAAA,GAAG,QAAQ;AACX,QAAA,eAAe,EAAE,SAAS;KAC3B;AAED,IAAA,MAAM,SAAS,GAAwB;AACrC,QAAA,eAAe,EAAE,SAAS;AAC1B,QAAA,OAAO,EAAE,CAAC;AACV,QAAA,YAAY,EAAE,CAAC;AACf,QAAA,QAAQ,EAAE,MAAM;AAChB,QAAA,SAAS,EAAE,GAAG;KACf;AAED,IAAA,QACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,cAAc,EAAA;AACxB,QAAA,KAAA,CAAA,aAAA,CAAA,QAAA,EAAA,EACE,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,EAAA,YAAA,EACtB,iBAAiB,EAAA,EAAA,cAAA,CAGrB;AAER,QAAA,MAAM,KACL,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,UAAU,EAAA;AACpB,YAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAC,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAC,EAAA,EAAA,eAAA,CAE1D;AAEN,YAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAC,YAAY,EAAE,EAAE,EAAC,EAAA;gBAC5B,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,EACE,KAAK,EAAE,SAAS,KAAK,QAAQ,GAAG,cAAc,GAAG,QAAQ,EACzD,OAAO,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,EAAA,EAAA,QAAA,CAGhC;gBACP,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,EACE,KAAK,EAAE,SAAS,KAAK,QAAQ,GAAG,cAAc,GAAG,QAAQ,EACzD,OAAO,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,EAAA,EAAA,QAAA,CAGhC;gBACP,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,EACE,KAAK,EAAE,SAAS,KAAK,aAAa,GAAG,cAAc,GAAG,QAAQ,EAC9D,OAAO,EAAE,MAAM,YAAY,CAAC,aAAa,CAAC,EAAA,EAAA,aAAA,CAGrC,CACH;YAEL,SAAS,KAAK,QAAQ,KACrB,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,IAAA;gBACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAC,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAC,EAAA,EAAA,iBAAA,CAAuB;AACnE,gBAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,SAAS,EAAA,EAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAO,CAC1D,CACP;YAEA,SAAS,KAAK,QAAQ,KACrB,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,IAAA;gBACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAC,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAC,EAAA,EAAA,SAAA,CAAe;AAC3D,gBAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,SAAS,EAAA,EAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAO,CAC1D,CACP;YAEA,SAAS,KAAK,aAAa,KAC1B,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,IAAA;gBACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAC,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAC,EAAA,EAAA,sBAAA,CAA4B;gBACxE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,SAAS,EAAA;AACnB,oBAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,IAAA;;wBAAoB,OAAO,CAAC,WAAW,CAAO;AAC9C,oBAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,IAAA;;AAAmB,wBAAA,OAAO,CAAC,cAAc;AAAS,wBAAA,IAAA,CAAA;AAClD,oBAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,IAAA;;wBAAqB,OAAO,CAAC,gBAAgB,CAAO,CAChD;gBACN,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAC,EAAA,EAAA,iEAAA,CAElD,CACF,CACP,CACG,CACP,CACG;AAEV;;;;"}

package/dist/devtools/index.js

@@ -0,0 +1,205 @@
+'use strict';
+
+var React = require('react');
+var formHookKit = require('form-hook-kit');
+
+// Detect if we're in React Native environment
+/* istanbul ignore next */
+const isReactNative = typeof navigator !== 'undefined' &&
+    navigator.product === 'ReactNative';
+/**
+ * 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]" />
+ * ```
+ */
+// istanbul ignore next - default mode detection is platform-specific and untestable
+function FormDevTools({ mode = isReactNative ? 'console' : 'ui', autoLog = false, logPrefix = '[FormDevTools]', position = 'bottom-right', defaultOpen = true, } = {}) {
+    const { values, errors } = formHookKit.useForm();
+    const metrics = formHookKit.useFormPerformance();
+    const [isOpen, setIsOpen] = React.useState(defaultOpen);
+    const [activeTab, setActiveTab] = React.useState('values');
+    const prevValuesRef = React.useRef(values);
+    const prevErrorsRef = React.useRef(errors);
+    // Console logging mode
+    React.useEffect(() => {
+        if (mode === 'console') {
+            if (autoLog) {
+                // Log when values change
+                if (prevValuesRef.current !== values) {
+                    console.log(`${logPrefix} Values:`, values);
+                    prevValuesRef.current = values;
+                }
+                // Log when errors change
+                if (prevErrorsRef.current !== errors) {
+                    console.log(`${logPrefix} Errors:`, errors);
+                    prevErrorsRef.current = errors;
+                }
+            }
+        }
+    }, [values, errors, mode, autoLog, logPrefix]);
+    // Expose global logging functions for manual inspection
+    React.useEffect(() => {
+        if (mode === 'console') {
+            const globalObj = typeof globalThis !== 'undefined' ? globalThis : /* istanbul ignore next */ (typeof window !== 'undefined' ? window : undefined);
+            /* istanbul ignore else */
+            if (globalObj) {
+                // Adding to global for debugging
+                globalObj.formDevTools = {
+                    logValues: () => console.log(`${logPrefix} Values:`, values),
+                    logErrors: () => console.log(`${logPrefix} Errors:`, errors),
+                    logMetrics: () => console.log(`${logPrefix} Performance:`, metrics),
+                    logAll: () => {
+                        console.log(`${logPrefix} === Form State ===`);
+                        console.log('Values:', values);
+                        console.log('Errors:', errors);
+                        console.log('Performance:', metrics);
+                    },
+                };
+            }
+        }
+    }, [values, errors, metrics, mode, logPrefix]);
+    // If mode is 'none' or 'console', don't render UI
+    if (mode === 'none' || mode === 'console') {
+        return null;
+    }
+    // UI mode (web only)
+    /* istanbul ignore next */
+    if (isReactNative && mode === 'ui') {
+        console.warn(`${logPrefix} UI mode is not supported in React Native. Use mode="console" instead.`);
+        return null;
+    }
+    const positionStyles = {
+        'top-left': { top: 10, left: 10 },
+        'top-right': { top: 10, right: 10 },
+        'bottom-left': { bottom: 10, left: 10 },
+        'bottom-right': { bottom: 10, right: 10 },
+    };
+    const containerStyle = {
+        position: 'fixed',
+        ...positionStyles[position],
+        zIndex: 999999,
+        fontFamily: 'monospace',
+        fontSize: 12,
+    };
+    const panelStyle = {
+        backgroundColor: '#1e1e1e',
+        color: '#d4d4d4',
+        border: '1px solid #3e3e3e',
+        borderRadius: 4,
+        padding: 12,
+        minWidth: 300,
+        maxWidth: 500,
+        maxHeight: 400,
+        overflow: 'auto',
+        boxShadow: '0 4px 12px rgba(0,0,0,0.3)',
+    };
+    const toggleButtonStyle = {
+        position: 'absolute',
+        top: -10,
+        right: -10,
+        backgroundColor: '#007acc',
+        color: 'white',
+        border: 'none',
+        borderRadius: '50%',
+        width: 30,
+        height: 30,
+        cursor: 'pointer',
+        fontSize: 16,
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+    };
+    const tabStyle = {
+        display: 'inline-block',
+        padding: '4px 8px',
+        marginRight: 8,
+        cursor: 'pointer',
+        borderRadius: 3,
+        backgroundColor: '#2d2d2d',
+    };
+    const activeTabStyle = {
+        ...tabStyle,
+        backgroundColor: '#007acc',
+    };
+    const codeStyle = {
+        backgroundColor: '#2d2d2d',
+        padding: 8,
+        borderRadius: 3,
+        overflow: 'auto',
+        maxHeight: 250,
+    };
+    return (React.createElement("div", { style: containerStyle },
+        React.createElement("button", { style: toggleButtonStyle, onClick: () => setIsOpen(!isOpen), "aria-label": "Toggle DevTools" }, "\uD83D\uDD27"),
+        isOpen && (React.createElement("div", { style: panelStyle },
+            React.createElement("div", { style: { marginBottom: 12, fontWeight: 'bold', fontSize: 14 } }, "Form DevTools"),
+            React.createElement("div", { style: { marginBottom: 12 } },
+                React.createElement("span", { style: activeTab === 'values' ? activeTabStyle : tabStyle, onClick: () => setActiveTab('values') }, "Values"),
+                React.createElement("span", { style: activeTab === 'errors' ? activeTabStyle : tabStyle, onClick: () => setActiveTab('errors') }, "Errors"),
+                React.createElement("span", { style: activeTab === 'performance' ? activeTabStyle : tabStyle, onClick: () => setActiveTab('performance') }, "Performance")),
+            activeTab === 'values' && (React.createElement("div", null,
+                React.createElement("div", { style: { marginBottom: 8, color: '#888' } }, "Current Values:"),
+                React.createElement("pre", { style: codeStyle }, JSON.stringify(values, null, 2)))),
+            activeTab === 'errors' && (React.createElement("div", null,
+                React.createElement("div", { style: { marginBottom: 8, color: '#888' } }, "Errors:"),
+                React.createElement("pre", { style: codeStyle }, JSON.stringify(errors, null, 2)))),
+            activeTab === 'performance' && (React.createElement("div", null,
+                React.createElement("div", { style: { marginBottom: 8, color: '#888' } }, "Performance Metrics:"),
+                React.createElement("div", { style: codeStyle },
+                    React.createElement("div", null,
+                        "Render Count: ",
+                        metrics.renderCount),
+                    React.createElement("div", null,
+                        "Last Render: ",
+                        metrics.lastRenderTime,
+                        "ms"),
+                    React.createElement("div", null,
+                        "Field Changes: ",
+                        metrics.fieldChangeCount)),
+                React.createElement("div", { style: { marginTop: 12, fontSize: 11, color: '#888' } }, "Note: For validation metrics, use useValidationPerformance hook")))))));
+}
+
+exports.FormDevTools = FormDevTools;
+//# sourceMappingURL=index.js.map

package/dist/devtools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/src/devtools/FormDevTools.tsx"],"sourcesContent":[null],"names":["useForm","useFormPerformance","useState","useRef","useEffect"],"mappings":"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"}

package/dist/devtools/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.esm.js",
+  "types": "./index.d.ts"
+}

package/dist/devtools/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/devtools/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/devtools/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/devtools/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"}