@buildnbuzz/buzzform 0.1.0

package/dist/rhf.d.ts

@@ -0,0 +1,70 @@
+import { FieldValues, Control } from 'react-hook-form';
+export { UseFormReturn as RhfForm } from 'react-hook-form';
+import { f as AdapterOptions, b as FormAdapter } from './adapter-BT9v2OVg.js';
+import 'react';
+import 'zod';
+
+/**
+ * Options specific to the React Hook Form adapter.
+ * Extends base AdapterOptions with RHF-specific features.
+ */
+interface RhfAdapterOptions<TData extends FieldValues = FieldValues> extends AdapterOptions<TData> {
+    /**
+     * React Hook Form's reValidateMode.
+     * When to re-validate after initial validation.
+     * @default 'onChange'
+     */
+    reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';
+    /**
+     * Validation strategy before submit.
+     * - 'firstError': Return first error only (faster)
+     * - 'all': Return all errors (better UX for complex forms)
+     * @default 'firstError'
+     */
+    criteriaMode?: 'firstError' | 'all';
+    /**
+     * Delay validation by specified ms (debounce).
+     * Useful for expensive async validation.
+     */
+    delayError?: number;
+    /**
+     * Focus on the first field with an error after submit.
+     * @default true
+     */
+    shouldFocusError?: boolean;
+}
+/**
+ * React Hook Form adapter implementing the FormAdapter interface.
+ *
+ * This is the default adapter for BuzzForm. It provides full implementation
+ * of all required and optional FormAdapter methods using React Hook Form.
+ *
+ * @example
+ * // In FormProvider
+ * import { useRhf } from '@buildnbuzz/buzzform/rhf';
+ *
+ * <FormProvider adapter={useRhf}>
+ *   <App />
+ * </FormProvider>
+ *
+ * @example
+ * // Direct usage
+ * const form = useRhf({
+ *   defaultValues: { email: '', password: '' },
+ *   resolver: zodResolver(schema),
+ *   onSubmit: async (data) => {
+ *     await loginUser(data);
+ *   },
+ * });
+ */
+declare function useRhf<TData extends FieldValues = FieldValues>(options: RhfAdapterOptions<TData>): FormAdapter<TData>;
+/**
+ * Hook to watch specific field values reactively.
+ * Use this when you need to react to field changes outside of components.
+ *
+ * @param control - The control object from useRhf (form.control)
+ * @param name - Field path(s) to watch
+ */
+declare function useRhfWatch<TData extends FieldValues, TValue = unknown>(control: Control<TData>, name: string | string[]): TValue;
+
+export { type RhfAdapterOptions, useRhf, useRhfWatch };

package/dist/rhf.js

@@ -0,0 +1,293 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/rhf.ts
+var rhf_exports = {};
+__export(rhf_exports, {
+  useRhf: () => useRhf,
+  useRhfWatch: () => useRhfWatch
+});
+module.exports = __toCommonJS(rhf_exports);
+var import_react = require("react");
+var import_react_hook_form = require("react-hook-form");
+
+// src/utils/array.ts
+var import_nanoid = require("nanoid");
+function createArrayHelpers(getArray, setArray) {
+  return {
+    fields: (path) => {
+      const arr = getArray(path);
+      if (!Array.isArray(arr)) return [];
+      return arr.map((item, index) => ({
+        id: item?.id || `${path}-${index}`,
+        ...item
+      }));
+    },
+    append: (path, value) => {
+      const current = getArray(path) || [];
+      const itemWithId = ensureId(value);
+      setArray(path, [...current, itemWithId]);
+    },
+    prepend: (path, value) => {
+      const current = getArray(path) || [];
+      const itemWithId = ensureId(value);
+      setArray(path, [itemWithId, ...current]);
+    },
+    insert: (path, index, value) => {
+      const current = [...getArray(path) || []];
+      const itemWithId = ensureId(value);
+      current.splice(index, 0, itemWithId);
+      setArray(path, current);
+    },
+    remove: (path, index) => {
+      const current = [...getArray(path) || []];
+      current.splice(index, 1);
+      setArray(path, current);
+    },
+    move: (path, from, to) => {
+      const current = [...getArray(path) || []];
+      const [item] = current.splice(from, 1);
+      current.splice(to, 0, item);
+      setArray(path, current);
+    },
+    swap: (path, indexA, indexB) => {
+      const current = [...getArray(path) || []];
+      const temp = current[indexA];
+      current[indexA] = current[indexB];
+      current[indexB] = temp;
+      setArray(path, current);
+    },
+    replace: (path, values) => {
+      const itemsWithIds = values.map(ensureId);
+      setArray(path, itemsWithIds);
+    },
+    update: (path, index, value) => {
+      const current = [...getArray(path) || []];
+      const existingId = current[index]?.id;
+      current[index] = {
+        ...typeof value === "object" && value !== null ? value : {},
+        id: existingId || (0, import_nanoid.nanoid)()
+      };
+      setArray(path, current);
+    }
+  };
+}
+function ensureId(value) {
+  if (typeof value === "object" && value !== null) {
+    const obj = value;
+    if (!obj.id) {
+      return { ...obj, id: (0, import_nanoid.nanoid)() };
+    }
+    return obj;
+  }
+  return { value, id: (0, import_nanoid.nanoid)() };
+}
+
+// src/lib/utils.ts
+function getNestedValue(obj, path) {
+  if (!obj || !path) return void 0;
+  return path.split(".").reduce((acc, key) => {
+    if (acc && typeof acc === "object" && acc !== null) {
+      return acc[key];
+    }
+    return void 0;
+  }, obj);
+}
+function flattenNestedObject(obj, prefix = "") {
+  const result = {};
+  for (const key in obj) {
+    const path = prefix ? `${prefix}.${key}` : key;
+    const value = obj[key];
+    if (typeof value === "boolean") {
+      result[path] = value;
+    } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      Object.assign(result, flattenNestedObject(value, path));
+    }
+  }
+  return result;
+}
+
+// src/adapters/rhf.ts
+function useRhf(options) {
+  const {
+    defaultValues,
+    values,
+    resolver,
+    mode = "onChange",
+    reValidateMode = "onChange",
+    criteriaMode,
+    delayError,
+    shouldFocusError = true,
+    onSubmit
+  } = options;
+  const form = (0, import_react_hook_form.useForm)({
+    defaultValues,
+    values,
+    resolver,
+    mode,
+    reValidateMode,
+    criteriaMode,
+    delayError,
+    shouldFocusError
+  });
+  const prevValuesRef = (0, import_react.useRef)(values);
+  (0, import_react.useEffect)(() => {
+    if (values && JSON.stringify(values) !== JSON.stringify(prevValuesRef.current)) {
+      prevValuesRef.current = values;
+    }
+  }, [values]);
+  const handleSubmit = form.handleSubmit(async (data) => {
+    if (onSubmit) {
+      await onSubmit(data);
+    }
+  });
+  const api = {
+    // ---------------------------------------------------------------------
+    // CORE PROPERTIES
+    // ---------------------------------------------------------------------
+    control: form.control,
+    get formState() {
+      const state = form.formState;
+      return {
+        isSubmitting: state.isSubmitting,
+        isValidating: state.isValidating,
+        isDirty: state.isDirty,
+        isValid: state.isValid,
+        isLoading: state.isLoading,
+        errors: normalizeErrors(state.errors),
+        dirtyFields: flattenNestedObject(state.dirtyFields),
+        touchedFields: flattenNestedObject(state.touchedFields),
+        submitCount: state.submitCount
+      };
+    },
+    handleSubmit,
+    // ---------------------------------------------------------------------
+    // VALUE MANAGEMENT
+    // ---------------------------------------------------------------------
+    getValues: () => form.getValues(),
+    setValue: (name, value, opts) => {
+      form.setValue(name, value, {
+        shouldValidate: opts?.shouldValidate,
+        shouldDirty: opts?.shouldDirty ?? true,
+        shouldTouch: opts?.shouldTouch
+      });
+    },
+    reset: (vals) => form.reset(vals),
+    watch: (name) => {
+      return form.watch(name);
+    },
+    // ---------------------------------------------------------------------
+    // VALIDATION
+    // ---------------------------------------------------------------------
+    validate: async (name) => {
+      if (name) {
+        const names = Array.isArray(name) ? name : [name];
+        return form.trigger(names);
+      }
+      return form.trigger();
+    },
+    setError: (name, error) => {
+      form.setError(name, {
+        type: error.type || "manual",
+        message: error.message
+      });
+    },
+    clearErrors: (name) => {
+      if (name) {
+        const names = Array.isArray(name) ? name : [name];
+        names.forEach((n) => form.clearErrors(n));
+      } else {
+        form.clearErrors();
+      }
+    },
+    // ---------------------------------------------------------------------
+    // ARRAYS
+    // ---------------------------------------------------------------------
+    array: createArrayHelpers(
+      (path) => form.getValues(path),
+      (path, value) => form.setValue(
+        path,
+        value,
+        { shouldDirty: true }
+      )
+    ),
+    // ---------------------------------------------------------------------
+    // OPTIONAL ENHANCED FEATURES
+    // ---------------------------------------------------------------------
+    onBlur: (name) => {
+      const hasError = !!getNestedValue(form.formState.errors, name);
+      if (mode === "onBlur" || mode === "all") {
+        form.trigger(name);
+      } else if (hasError && reValidateMode === "onBlur") {
+        form.trigger(name);
+      }
+    },
+    getFieldState: (name) => {
+      const state = form.getFieldState(name, form.formState);
+      return {
+        isDirty: state.isDirty,
+        isTouched: state.isTouched,
+        invalid: state.invalid,
+        error: state.error?.message
+      };
+    },
+    setFocus: (name, options2) => {
+      form.setFocus(name, options2);
+    },
+    unregister: (name) => {
+      const names = Array.isArray(name) ? name : [name];
+      names.forEach((n) => form.unregister(n));
+    }
+  };
+  return api;
+}
+function useRhfWatch(control, name) {
+  if (Array.isArray(name)) {
+    return (0, import_react_hook_form.useWatch)({ control, name });
+  }
+  return (0, import_react_hook_form.useWatch)({ control, name });
+}
+function normalizeErrors(errors) {
+  const result = {};
+  function traverse(obj, prefix = "") {
+    for (const key in obj) {
+      const path = prefix ? `${prefix}.${key}` : key;
+      const value = obj[key];
+      if (isRecord(value) && "message" in value && typeof value.message === "string") {
+        result[path] = value.message;
+      } else if (isRecord(value) && "root" in value && isRecord(value.root) && "message" in value.root && typeof value.root.message === "string") {
+        result[path] = value.root.message;
+      } else if (isRecord(value)) {
+        traverse(value, path);
+      }
+    }
+  }
+  traverse(errors);
+  return result;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useRhf,
+  useRhfWatch
+});
+//# sourceMappingURL=rhf.js.map

package/dist/rhf.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/rhf.ts","../src/utils/array.ts","../src/lib/utils.ts"],"sourcesContent":["'use client';\r\n\r\nimport { useRef, useEffect } from 'react';\r\nimport { useForm, useWatch } from 'react-hook-form';\r\nimport type {\r\n    Control,\r\n    FieldValues,\r\n    Path,\r\n    PathValue,\r\n    DefaultValues,\r\n    FieldErrors,\r\n    Resolver as RhfResolver\r\n} from 'react-hook-form';\r\nimport type {\r\n    FormAdapter,\r\n    AdapterOptions,\r\n    FormState,\r\n    FieldError,\r\n    SetValueOptions,\r\n} from '../types';\r\nimport { createArrayHelpers } from '../utils';\r\nimport { getNestedValue, flattenNestedObject } from '../lib';\r\n\r\n// =============================================================================\r\n// RHF ADAPTER OPTIONS\r\n// =============================================================================\r\n\r\n/**\r\n * Options specific to the React Hook Form adapter.\r\n * Extends base AdapterOptions with RHF-specific features.\r\n */\r\nexport interface RhfAdapterOptions<TData extends FieldValues = FieldValues>\r\n    extends AdapterOptions<TData> {\r\n    /**\r\n     * React Hook Form's reValidateMode.\r\n     * When to re-validate after initial validation.\r\n     * @default 'onChange'\r\n     */\r\n    reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';\r\n\r\n    /**\r\n     * Validation strategy before submit.\r\n     * - 'firstError': Return first error only (faster)\r\n     * - 'all': Return all errors (better UX for complex forms)\r\n     * @default 'firstError'\r\n     */\r\n    criteriaMode?: 'firstError' | 'all';\r\n\r\n    /**\r\n     * Delay validation by specified ms (debounce).\r\n     * Useful for expensive async validation.\r\n     */\r\n    delayError?: number;\r\n\r\n    /**\r\n     * Focus on the first field with an error after submit.\r\n     * @default true\r\n     */\r\n    shouldFocusError?: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// RHF ADAPTER\r\n// =============================================================================\r\n\r\n/**\r\n * React Hook Form adapter implementing the FormAdapter interface.\r\n * \r\n * This is the default adapter for BuzzForm. It provides full implementation\r\n * of all required and optional FormAdapter methods using React Hook Form.\r\n * \r\n * @example\r\n * // In FormProvider\r\n * import { useRhf } from '@buildnbuzz/buzzform/rhf';\r\n * \r\n * <FormProvider adapter={useRhf}>\r\n *   <App />\r\n * </FormProvider>\r\n * \r\n * @example\r\n * // Direct usage\r\n * const form = useRhf({\r\n *   defaultValues: { email: '', password: '' },\r\n *   resolver: zodResolver(schema),\r\n *   onSubmit: async (data) => {\r\n *     await loginUser(data);\r\n *   },\r\n * });\r\n */\r\nexport function useRhf<TData extends FieldValues = FieldValues>(\r\n    options: RhfAdapterOptions<TData>\r\n): FormAdapter<TData> {\r\n    const {\r\n        defaultValues,\r\n        values,\r\n        resolver,\r\n        mode = 'onChange',\r\n        reValidateMode = 'onChange',\r\n        criteriaMode,\r\n        delayError,\r\n        shouldFocusError = true,\r\n        onSubmit,\r\n    } = options;\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Initialize React Hook Form\r\n    // -------------------------------------------------------------------------\r\n\r\n    const form = useForm<TData>({\r\n        defaultValues: defaultValues as DefaultValues<TData>,\r\n        values: values,\r\n        resolver: resolver as unknown as RhfResolver<TData>,\r\n        mode,\r\n        reValidateMode,\r\n        criteriaMode,\r\n        delayError,\r\n        shouldFocusError,\r\n    });\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Handle controlled values updates\r\n    // -------------------------------------------------------------------------\r\n\r\n    const prevValuesRef = useRef(values);\r\n\r\n    useEffect(() => {\r\n        if (values && JSON.stringify(values) !== JSON.stringify(prevValuesRef.current)) {\r\n            prevValuesRef.current = values;\r\n        }\r\n    }, [values]);\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Build submit handler\r\n    // -------------------------------------------------------------------------\r\n\r\n    const handleSubmit = form.handleSubmit(async (data) => {\r\n        if (onSubmit) {\r\n            await onSubmit(data as TData);\r\n        }\r\n    });\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Build the adapter API\r\n    // -------------------------------------------------------------------------\r\n\r\n    const api: FormAdapter<TData> = {\r\n        // ---------------------------------------------------------------------\r\n        // CORE PROPERTIES\r\n        // ---------------------------------------------------------------------\r\n\r\n        control: form.control,\r\n\r\n        get formState(): FormState {\r\n            const state = form.formState;\r\n            return {\r\n                isSubmitting: state.isSubmitting,\r\n                isValidating: state.isValidating,\r\n                isDirty: state.isDirty,\r\n                isValid: state.isValid,\r\n                isLoading: state.isLoading,\r\n                errors: normalizeErrors(state.errors),\r\n                dirtyFields: flattenNestedObject(state.dirtyFields),\r\n                touchedFields: flattenNestedObject(state.touchedFields),\r\n                submitCount: state.submitCount,\r\n            };\r\n        },\r\n\r\n        handleSubmit,\r\n\r\n        // ---------------------------------------------------------------------\r\n        // VALUE MANAGEMENT\r\n        // ---------------------------------------------------------------------\r\n\r\n        getValues: () => form.getValues(),\r\n\r\n        setValue: (name: string, value: unknown, opts?: SetValueOptions) => {\r\n            form.setValue(name as Path<TData>, value as PathValue<TData, Path<TData>>, {\r\n                shouldValidate: opts?.shouldValidate,\r\n                shouldDirty: opts?.shouldDirty ?? true,\r\n                shouldTouch: opts?.shouldTouch,\r\n            });\r\n        },\r\n\r\n        reset: (vals) => form.reset(vals as DefaultValues<TData>),\r\n\r\n        watch: <T = unknown>(name?: string): T => {\r\n            return form.watch(name as Path<TData>) as T;\r\n        },\r\n\r\n        // ---------------------------------------------------------------------\r\n        // VALIDATION\r\n        // ---------------------------------------------------------------------\r\n\r\n        validate: async (name) => {\r\n            if (name) {\r\n                const names = Array.isArray(name) ? name : [name];\r\n                return form.trigger(names as Path<TData>[]);\r\n            }\r\n            return form.trigger();\r\n        },\r\n\r\n        setError: (name: string, error: FieldError) => {\r\n            form.setError(name as Path<TData>, {\r\n                type: error.type || 'manual',\r\n                message: error.message,\r\n            });\r\n        },\r\n\r\n        clearErrors: (name) => {\r\n            if (name) {\r\n                const names = Array.isArray(name) ? name : [name];\r\n                names.forEach(n => form.clearErrors(n as Path<TData>));\r\n            } else {\r\n                form.clearErrors();\r\n            }\r\n        },\r\n\r\n        // ---------------------------------------------------------------------\r\n        // ARRAYS\r\n        // ---------------------------------------------------------------------\r\n\r\n        array: createArrayHelpers(\r\n            (path) => form.getValues(path as Path<TData>) as unknown[],\r\n            (path, value) => form.setValue(\r\n                path as Path<TData>,\r\n                value as PathValue<TData, Path<TData>>,\r\n                { shouldDirty: true }\r\n            )\r\n        ),\r\n\r\n        // ---------------------------------------------------------------------\r\n        // OPTIONAL ENHANCED FEATURES\r\n        // ---------------------------------------------------------------------\r\n\r\n        onBlur: (name: string) => {\r\n            // Mark field as touched\r\n            const hasError = !!getNestedValue(form.formState.errors, name);\r\n\r\n            // Trigger validation based on mode\r\n            if (mode === 'onBlur' || mode === 'all') {\r\n                form.trigger(name as Path<TData>);\r\n            } else if (hasError && reValidateMode === 'onBlur') {\r\n                // Re-validate if field has error and reValidateMode is onBlur\r\n                form.trigger(name as Path<TData>);\r\n            }\r\n        },\r\n\r\n        getFieldState: (name: string) => {\r\n            const state = form.getFieldState(name as Path<TData>, form.formState);\r\n            return {\r\n                isDirty: state.isDirty,\r\n                isTouched: state.isTouched,\r\n                invalid: state.invalid,\r\n                error: state.error?.message,\r\n            };\r\n        },\r\n\r\n        setFocus: (name: string, options?: { shouldSelect?: boolean }) => {\r\n            form.setFocus(name as Path<TData>, options);\r\n        },\r\n\r\n        unregister: (name: string | string[]) => {\r\n            const names = Array.isArray(name) ? name : [name];\r\n            names.forEach(n => form.unregister(n as Path<TData>));\r\n        },\r\n    };\r\n\r\n    return api;\r\n}\r\n\r\n// =============================================================================\r\n// HELPER: Watch hook for external use\r\n// =============================================================================\r\n\r\n/**\r\n * Hook to watch specific field values reactively.\r\n * Use this when you need to react to field changes outside of components.\r\n * \r\n * @param control - The control object from useRhf (form.control)\r\n * @param name - Field path(s) to watch\r\n */\r\nexport function useRhfWatch<TData extends FieldValues, TValue = unknown>(\r\n    control: Control<TData>,\r\n    name: string | string[]\r\n): TValue {\r\n    if (Array.isArray(name)) {\r\n        return useWatch({ control, name: name as unknown as Path<TData>[] }) as TValue;\r\n    }\r\n    return useWatch({ control, name: name as Path<TData> }) as TValue;\r\n}\r\n\r\n// =============================================================================\r\n// UTILITIES\r\n// =============================================================================\r\n\r\n/**\r\n * Normalize RHF's nested error structure to flat string map.\r\n */\r\nfunction normalizeErrors<TData extends FieldValues>(\r\n    errors: FieldErrors<TData>\r\n): Record<string, string | string[] | undefined> {\r\n    const result: Record<string, string | string[] | undefined> = {};\r\n\r\n    function traverse(obj: Record<string, unknown>, prefix = '') {\r\n        for (const key in obj) {\r\n            const path = prefix ? `${prefix}.${key}` : key;\r\n            const value = obj[key];\r\n\r\n            if (isRecord(value) && 'message' in value && typeof value.message === 'string') {\r\n                // Leaf error\r\n                result[path] = value.message;\r\n            } else if (\r\n                isRecord(value) &&\r\n                'root' in value &&\r\n                isRecord(value.root) &&\r\n                'message' in value.root &&\r\n                typeof value.root.message === 'string'\r\n            ) {\r\n                // Array root error\r\n                result[path] = value.root.message;\r\n            } else if (isRecord(value)) {\r\n                // Nested object, traverse deeper\r\n                traverse(value, path);\r\n            }\r\n        }\r\n    }\r\n\r\n    traverse(errors as unknown as Record<string, unknown>);\r\n    return result;\r\n}\r\n\r\n\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n    return typeof value === 'object' && value !== null;\r\n}\r\n\r\n// =============================================================================\r\n// RE-EXPORTS FOR CONVENIENCE\r\n// =============================================================================\r\n\r\nexport type { UseFormReturn as RhfForm } from 'react-hook-form';","import { nanoid } from 'nanoid';\r\nimport type { ArrayHelpers } from '../types';\r\n\r\n/**\r\n * Creates a standardized set of array field manipulation methods.\r\n * Abstracts the difference between getting/setting values in different form libraries.\r\n * \r\n * @param getArray - Function to get current array value at a path\r\n * @param setArray - Function to set array value at a path\r\n */\r\nexport function createArrayHelpers(\r\n    getArray: (path: string) => unknown[],\r\n    setArray: (path: string, value: unknown[]) => void\r\n): ArrayHelpers {\r\n    return {\r\n        fields: <T = unknown>(path: string): Array<T & { id: string }> => {\r\n            const arr = getArray(path);\r\n            if (!Array.isArray(arr)) return [];\r\n            return arr.map((item, index) => ({\r\n                id: (item as Record<string, unknown>)?.id as string || `${path}-${index}`,\r\n                ...item as T,\r\n            }));\r\n        },\r\n\r\n        append: (path: string, value: unknown) => {\r\n            const current = getArray(path) || [];\r\n            const itemWithId = ensureId(value);\r\n            setArray(path, [...current, itemWithId]);\r\n        },\r\n\r\n        prepend: (path: string, value: unknown) => {\r\n            const current = getArray(path) || [];\r\n            const itemWithId = ensureId(value);\r\n            setArray(path, [itemWithId, ...current]);\r\n        },\r\n\r\n        insert: (path: string, index: number, value: unknown) => {\r\n            const current = [...(getArray(path) || [])];\r\n            const itemWithId = ensureId(value);\r\n            current.splice(index, 0, itemWithId);\r\n            setArray(path, current);\r\n        },\r\n\r\n        remove: (path: string, index: number) => {\r\n            const current = [...(getArray(path) || [])];\r\n            current.splice(index, 1);\r\n            setArray(path, current);\r\n        },\r\n\r\n        move: (path: string, from: number, to: number) => {\r\n            const current = [...(getArray(path) || [])];\r\n            const [item] = current.splice(from, 1);\r\n            current.splice(to, 0, item);\r\n            setArray(path, current);\r\n        },\r\n\r\n        swap: (path: string, indexA: number, indexB: number) => {\r\n            const current = [...(getArray(path) || [])];\r\n            const temp = current[indexA];\r\n            current[indexA] = current[indexB];\r\n            current[indexB] = temp;\r\n            setArray(path, current);\r\n        },\r\n\r\n        replace: (path: string, values: unknown[]) => {\r\n            const itemsWithIds = values.map(ensureId);\r\n            setArray(path, itemsWithIds);\r\n        },\r\n\r\n        update: (path: string, index: number, value: unknown) => {\r\n            const current = [...(getArray(path) || [])];\r\n            // Preserve existing ID if present\r\n            const existingId = (current[index] as Record<string, unknown>)?.id;\r\n            current[index] = {\r\n                ...(typeof value === 'object' && value !== null ? value : {}),\r\n                id: existingId || nanoid(),\r\n            };\r\n            setArray(path, current);\r\n        },\r\n    };\r\n}\r\n\r\n/**\r\n * Ensures an item has a unique ID for React keys.\r\n */\r\nfunction ensureId(value: unknown): unknown {\r\n    if (typeof value === 'object' && value !== null) {\r\n        const obj = value as Record<string, unknown>;\r\n        if (!obj.id) {\r\n            return { ...obj, id: nanoid() };\r\n        }\r\n        return obj;\r\n    }\r\n    return { value, id: nanoid() };\r\n}\r\n","// =============================================================================\r\n// COMMON UTILITIES\r\n// These are used by both the core package and registry field components.\r\n// =============================================================================\r\n\r\n/**\r\n * Generate a unique field ID from the field path.\r\n * Converts dot notation to dashes and prefixes with 'field-'.\r\n * Used for accessibility (htmlFor, id attributes).\r\n * \r\n * @example\r\n * generateFieldId('user.profile.email') => 'field-user-profile-email'\r\n * generateFieldId('items[0].name') => 'field-items-0-name'\r\n */\r\nexport function generateFieldId(path: string): string {\r\n    return `field-${path.replace(/\\./g, \"-\").replace(/\\[/g, \"-\").replace(/\\]/g, \"\")}`;\r\n}\r\n\r\n/**\r\n * Safely retrieve a nested value from an object using a dot-notation path.\r\n * \r\n * @example\r\n * getNestedValue({ user: { name: 'John' } }, 'user.name') => 'John'\r\n * getNestedValue({ items: [{ id: 1 }] }, 'items.0.id') => 1\r\n */\r\nexport function getNestedValue(obj: unknown, path: string): unknown {\r\n    if (!obj || !path) return undefined;\r\n    return path.split(\".\").reduce<unknown>((acc: unknown, key: string) => {\r\n        if (acc && typeof acc === \"object\" && acc !== null) {\r\n            return (acc as Record<string, unknown>)[key];\r\n        }\r\n        return undefined;\r\n    }, obj);\r\n}\r\n\r\n/**\r\n * Set a nested value in an object using a dot-notation path.\r\n * Creates intermediate objects/arrays as needed.\r\n * \r\n * @example\r\n * setNestedValue({}, 'user.name', 'John') => { user: { name: 'John' } }\r\n */\r\nexport function setNestedValue<T extends Record<string, unknown>>(\r\n    obj: T,\r\n    path: string,\r\n    value: unknown\r\n): T {\r\n    const keys = path.split(\".\");\r\n    const result = { ...obj } as Record<string, unknown>;\r\n    let current = result;\r\n\r\n    for (let i = 0; i < keys.length - 1; i++) {\r\n        const key = keys[i];\r\n        if (!(key in current) || typeof current[key] !== \"object\") {\r\n            // Check if next key is numeric (array index)\r\n            const nextKey = keys[i + 1];\r\n            current[key] = /^\\d+$/.test(nextKey) ? [] : {};\r\n        } else {\r\n            current[key] = Array.isArray(current[key])\r\n                ? [...(current[key] as unknown[])]\r\n                : { ...(current[key] as Record<string, unknown>) };\r\n        }\r\n        current = current[key] as Record<string, unknown>;\r\n    }\r\n\r\n    current[keys[keys.length - 1]] = value;\r\n    return result as T;\r\n}\r\n\r\n/**\r\n * Format bytes into a human-readable string.\r\n * \r\n * @example\r\n * formatBytes(1024) => '1 KB'\r\n * formatBytes(1234567) => '1.18 MB'\r\n */\r\nexport function formatBytes(bytes: number, decimals = 2): string {\r\n    if (bytes === 0) return '0 Bytes';\r\n\r\n    const k = 1024;\r\n    const dm = decimals < 0 ? 0 : decimals;\r\n    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\r\n\r\n    const i = Math.floor(Math.log(bytes) / Math.log(k));\r\n\r\n    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Flatten a nested object to dot-notation paths.\r\n * Useful for converting form library state (like dirtyFields, touchedFields)\r\n * to the flat format expected by FormState.\r\n * \r\n * @example\r\n * flattenNestedObject({ user: { name: true, email: true } })\r\n * // => { 'user.name': true, 'user.email': true }\r\n * \r\n * flattenNestedObject({ items: { 0: { title: true } } })\r\n * // => { 'items.0.title': true }\r\n */\r\nexport function flattenNestedObject(\r\n    obj: Record<string, unknown>,\r\n    prefix = ''\r\n): Record<string, boolean> {\r\n    const result: Record<string, boolean> = {};\r\n\r\n    for (const key in obj) {\r\n        const path = prefix ? `${prefix}.${key}` : key;\r\n        const value = obj[key];\r\n\r\n        if (typeof value === 'boolean') {\r\n            result[path] = value;\r\n        } else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\r\n            Object.assign(result, flattenNestedObject(value as Record<string, unknown>, path));\r\n        }\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\n"],"mappings":"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","names":["options"]}

package/dist/rhf.mjs

@@ -0,0 +1,175 @@
+"use client";
+import {
+  createArrayHelpers,
+  flattenNestedObject,
+  getNestedValue
+} from "./chunk-DDDGBPVU.mjs";
+
+// src/adapters/rhf.ts
+import { useRef, useEffect } from "react";
+import { useForm, useWatch } from "react-hook-form";
+function useRhf(options) {
+  const {
+    defaultValues,
+    values,
+    resolver,
+    mode = "onChange",
+    reValidateMode = "onChange",
+    criteriaMode,
+    delayError,
+    shouldFocusError = true,
+    onSubmit
+  } = options;
+  const form = useForm({
+    defaultValues,
+    values,
+    resolver,
+    mode,
+    reValidateMode,
+    criteriaMode,
+    delayError,
+    shouldFocusError
+  });
+  const prevValuesRef = useRef(values);
+  useEffect(() => {
+    if (values && JSON.stringify(values) !== JSON.stringify(prevValuesRef.current)) {
+      prevValuesRef.current = values;
+    }
+  }, [values]);
+  const handleSubmit = form.handleSubmit(async (data) => {
+    if (onSubmit) {
+      await onSubmit(data);
+    }
+  });
+  const api = {
+    // ---------------------------------------------------------------------
+    // CORE PROPERTIES
+    // ---------------------------------------------------------------------
+    control: form.control,
+    get formState() {
+      const state = form.formState;
+      return {
+        isSubmitting: state.isSubmitting,
+        isValidating: state.isValidating,
+        isDirty: state.isDirty,
+        isValid: state.isValid,
+        isLoading: state.isLoading,
+        errors: normalizeErrors(state.errors),
+        dirtyFields: flattenNestedObject(state.dirtyFields),
+        touchedFields: flattenNestedObject(state.touchedFields),
+        submitCount: state.submitCount
+      };
+    },
+    handleSubmit,
+    // ---------------------------------------------------------------------
+    // VALUE MANAGEMENT
+    // ---------------------------------------------------------------------
+    getValues: () => form.getValues(),
+    setValue: (name, value, opts) => {
+      form.setValue(name, value, {
+        shouldValidate: opts?.shouldValidate,
+        shouldDirty: opts?.shouldDirty ?? true,
+        shouldTouch: opts?.shouldTouch
+      });
+    },
+    reset: (vals) => form.reset(vals),
+    watch: (name) => {
+      return form.watch(name);
+    },
+    // ---------------------------------------------------------------------
+    // VALIDATION
+    // ---------------------------------------------------------------------
+    validate: async (name) => {
+      if (name) {
+        const names = Array.isArray(name) ? name : [name];
+        return form.trigger(names);
+      }
+      return form.trigger();
+    },
+    setError: (name, error) => {
+      form.setError(name, {
+        type: error.type || "manual",
+        message: error.message
+      });
+    },
+    clearErrors: (name) => {
+      if (name) {
+        const names = Array.isArray(name) ? name : [name];
+        names.forEach((n) => form.clearErrors(n));
+      } else {
+        form.clearErrors();
+      }
+    },
+    // ---------------------------------------------------------------------
+    // ARRAYS
+    // ---------------------------------------------------------------------
+    array: createArrayHelpers(
+      (path) => form.getValues(path),
+      (path, value) => form.setValue(
+        path,
+        value,
+        { shouldDirty: true }
+      )
+    ),
+    // ---------------------------------------------------------------------
+    // OPTIONAL ENHANCED FEATURES
+    // ---------------------------------------------------------------------
+    onBlur: (name) => {
+      const hasError = !!getNestedValue(form.formState.errors, name);
+      if (mode === "onBlur" || mode === "all") {
+        form.trigger(name);
+      } else if (hasError && reValidateMode === "onBlur") {
+        form.trigger(name);
+      }
+    },
+    getFieldState: (name) => {
+      const state = form.getFieldState(name, form.formState);
+      return {
+        isDirty: state.isDirty,
+        isTouched: state.isTouched,
+        invalid: state.invalid,
+        error: state.error?.message
+      };
+    },
+    setFocus: (name, options2) => {
+      form.setFocus(name, options2);
+    },
+    unregister: (name) => {
+      const names = Array.isArray(name) ? name : [name];
+      names.forEach((n) => form.unregister(n));
+    }
+  };
+  return api;
+}
+function useRhfWatch(control, name) {
+  if (Array.isArray(name)) {
+    return useWatch({ control, name });
+  }
+  return useWatch({ control, name });
+}
+function normalizeErrors(errors) {
+  const result = {};
+  function traverse(obj, prefix = "") {
+    for (const key in obj) {
+      const path = prefix ? `${prefix}.${key}` : key;
+      const value = obj[key];
+      if (isRecord(value) && "message" in value && typeof value.message === "string") {
+        result[path] = value.message;
+      } else if (isRecord(value) && "root" in value && isRecord(value.root) && "message" in value.root && typeof value.root.message === "string") {
+        result[path] = value.root.message;
+      } else if (isRecord(value)) {
+        traverse(value, path);
+      }
+    }
+  }
+  traverse(errors);
+  return result;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+export {
+  useRhf,
+  useRhfWatch
+};
+//# sourceMappingURL=rhf.mjs.map

package/dist/rhf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/rhf.ts"],"sourcesContent":["'use client';\r\n\r\nimport { useRef, useEffect } from 'react';\r\nimport { useForm, useWatch } from 'react-hook-form';\r\nimport type {\r\n    Control,\r\n    FieldValues,\r\n    Path,\r\n    PathValue,\r\n    DefaultValues,\r\n    FieldErrors,\r\n    Resolver as RhfResolver\r\n} from 'react-hook-form';\r\nimport type {\r\n    FormAdapter,\r\n    AdapterOptions,\r\n    FormState,\r\n    FieldError,\r\n    SetValueOptions,\r\n} from '../types';\r\nimport { createArrayHelpers } from '../utils';\r\nimport { getNestedValue, flattenNestedObject } from '../lib';\r\n\r\n// =============================================================================\r\n// RHF ADAPTER OPTIONS\r\n// =============================================================================\r\n\r\n/**\r\n * Options specific to the React Hook Form adapter.\r\n * Extends base AdapterOptions with RHF-specific features.\r\n */\r\nexport interface RhfAdapterOptions<TData extends FieldValues = FieldValues>\r\n    extends AdapterOptions<TData> {\r\n    /**\r\n     * React Hook Form's reValidateMode.\r\n     * When to re-validate after initial validation.\r\n     * @default 'onChange'\r\n     */\r\n    reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';\r\n\r\n    /**\r\n     * Validation strategy before submit.\r\n     * - 'firstError': Return first error only (faster)\r\n     * - 'all': Return all errors (better UX for complex forms)\r\n     * @default 'firstError'\r\n     */\r\n    criteriaMode?: 'firstError' | 'all';\r\n\r\n    /**\r\n     * Delay validation by specified ms (debounce).\r\n     * Useful for expensive async validation.\r\n     */\r\n    delayError?: number;\r\n\r\n    /**\r\n     * Focus on the first field with an error after submit.\r\n     * @default true\r\n     */\r\n    shouldFocusError?: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// RHF ADAPTER\r\n// =============================================================================\r\n\r\n/**\r\n * React Hook Form adapter implementing the FormAdapter interface.\r\n * \r\n * This is the default adapter for BuzzForm. It provides full implementation\r\n * of all required and optional FormAdapter methods using React Hook Form.\r\n * \r\n * @example\r\n * // In FormProvider\r\n * import { useRhf } from '@buildnbuzz/buzzform/rhf';\r\n * \r\n * <FormProvider adapter={useRhf}>\r\n *   <App />\r\n * </FormProvider>\r\n * \r\n * @example\r\n * // Direct usage\r\n * const form = useRhf({\r\n *   defaultValues: { email: '', password: '' },\r\n *   resolver: zodResolver(schema),\r\n *   onSubmit: async (data) => {\r\n *     await loginUser(data);\r\n *   },\r\n * });\r\n */\r\nexport function useRhf<TData extends FieldValues = FieldValues>(\r\n    options: RhfAdapterOptions<TData>\r\n): FormAdapter<TData> {\r\n    const {\r\n        defaultValues,\r\n        values,\r\n        resolver,\r\n        mode = 'onChange',\r\n        reValidateMode = 'onChange',\r\n        criteriaMode,\r\n        delayError,\r\n        shouldFocusError = true,\r\n        onSubmit,\r\n    } = options;\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Initialize React Hook Form\r\n    // -------------------------------------------------------------------------\r\n\r\n    const form = useForm<TData>({\r\n        defaultValues: defaultValues as DefaultValues<TData>,\r\n        values: values,\r\n        resolver: resolver as unknown as RhfResolver<TData>,\r\n        mode,\r\n        reValidateMode,\r\n        criteriaMode,\r\n        delayError,\r\n        shouldFocusError,\r\n    });\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Handle controlled values updates\r\n    // -------------------------------------------------------------------------\r\n\r\n    const prevValuesRef = useRef(values);\r\n\r\n    useEffect(() => {\r\n        if (values && JSON.stringify(values) !== JSON.stringify(prevValuesRef.current)) {\r\n            prevValuesRef.current = values;\r\n        }\r\n    }, [values]);\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Build submit handler\r\n    // -------------------------------------------------------------------------\r\n\r\n    const handleSubmit = form.handleSubmit(async (data) => {\r\n        if (onSubmit) {\r\n            await onSubmit(data as TData);\r\n        }\r\n    });\r\n\r\n    // -------------------------------------------------------------------------\r\n    // Build the adapter API\r\n    // -------------------------------------------------------------------------\r\n\r\n    const api: FormAdapter<TData> = {\r\n        // ---------------------------------------------------------------------\r\n        // CORE PROPERTIES\r\n        // ---------------------------------------------------------------------\r\n\r\n        control: form.control,\r\n\r\n        get formState(): FormState {\r\n            const state = form.formState;\r\n            return {\r\n                isSubmitting: state.isSubmitting,\r\n                isValidating: state.isValidating,\r\n                isDirty: state.isDirty,\r\n                isValid: state.isValid,\r\n                isLoading: state.isLoading,\r\n                errors: normalizeErrors(state.errors),\r\n                dirtyFields: flattenNestedObject(state.dirtyFields),\r\n                touchedFields: flattenNestedObject(state.touchedFields),\r\n                submitCount: state.submitCount,\r\n            };\r\n        },\r\n\r\n        handleSubmit,\r\n\r\n        // ---------------------------------------------------------------------\r\n        // VALUE MANAGEMENT\r\n        // ---------------------------------------------------------------------\r\n\r\n        getValues: () => form.getValues(),\r\n\r\n        setValue: (name: string, value: unknown, opts?: SetValueOptions) => {\r\n            form.setValue(name as Path<TData>, value as PathValue<TData, Path<TData>>, {\r\n                shouldValidate: opts?.shouldValidate,\r\n                shouldDirty: opts?.shouldDirty ?? true,\r\n                shouldTouch: opts?.shouldTouch,\r\n            });\r\n        },\r\n\r\n        reset: (vals) => form.reset(vals as DefaultValues<TData>),\r\n\r\n        watch: <T = unknown>(name?: string): T => {\r\n            return form.watch(name as Path<TData>) as T;\r\n        },\r\n\r\n        // ---------------------------------------------------------------------\r\n        // VALIDATION\r\n        // ---------------------------------------------------------------------\r\n\r\n        validate: async (name) => {\r\n            if (name) {\r\n                const names = Array.isArray(name) ? name : [name];\r\n                return form.trigger(names as Path<TData>[]);\r\n            }\r\n            return form.trigger();\r\n        },\r\n\r\n        setError: (name: string, error: FieldError) => {\r\n            form.setError(name as Path<TData>, {\r\n                type: error.type || 'manual',\r\n                message: error.message,\r\n            });\r\n        },\r\n\r\n        clearErrors: (name) => {\r\n            if (name) {\r\n                const names = Array.isArray(name) ? name : [name];\r\n                names.forEach(n => form.clearErrors(n as Path<TData>));\r\n            } else {\r\n                form.clearErrors();\r\n            }\r\n        },\r\n\r\n        // ---------------------------------------------------------------------\r\n        // ARRAYS\r\n        // ---------------------------------------------------------------------\r\n\r\n        array: createArrayHelpers(\r\n            (path) => form.getValues(path as Path<TData>) as unknown[],\r\n            (path, value) => form.setValue(\r\n                path as Path<TData>,\r\n                value as PathValue<TData, Path<TData>>,\r\n                { shouldDirty: true }\r\n            )\r\n        ),\r\n\r\n        // ---------------------------------------------------------------------\r\n        // OPTIONAL ENHANCED FEATURES\r\n        // ---------------------------------------------------------------------\r\n\r\n        onBlur: (name: string) => {\r\n            // Mark field as touched\r\n            const hasError = !!getNestedValue(form.formState.errors, name);\r\n\r\n            // Trigger validation based on mode\r\n            if (mode === 'onBlur' || mode === 'all') {\r\n                form.trigger(name as Path<TData>);\r\n            } else if (hasError && reValidateMode === 'onBlur') {\r\n                // Re-validate if field has error and reValidateMode is onBlur\r\n                form.trigger(name as Path<TData>);\r\n            }\r\n        },\r\n\r\n        getFieldState: (name: string) => {\r\n            const state = form.getFieldState(name as Path<TData>, form.formState);\r\n            return {\r\n                isDirty: state.isDirty,\r\n                isTouched: state.isTouched,\r\n                invalid: state.invalid,\r\n                error: state.error?.message,\r\n            };\r\n        },\r\n\r\n        setFocus: (name: string, options?: { shouldSelect?: boolean }) => {\r\n            form.setFocus(name as Path<TData>, options);\r\n        },\r\n\r\n        unregister: (name: string | string[]) => {\r\n            const names = Array.isArray(name) ? name : [name];\r\n            names.forEach(n => form.unregister(n as Path<TData>));\r\n        },\r\n    };\r\n\r\n    return api;\r\n}\r\n\r\n// =============================================================================\r\n// HELPER: Watch hook for external use\r\n// =============================================================================\r\n\r\n/**\r\n * Hook to watch specific field values reactively.\r\n * Use this when you need to react to field changes outside of components.\r\n * \r\n * @param control - The control object from useRhf (form.control)\r\n * @param name - Field path(s) to watch\r\n */\r\nexport function useRhfWatch<TData extends FieldValues, TValue = unknown>(\r\n    control: Control<TData>,\r\n    name: string | string[]\r\n): TValue {\r\n    if (Array.isArray(name)) {\r\n        return useWatch({ control, name: name as unknown as Path<TData>[] }) as TValue;\r\n    }\r\n    return useWatch({ control, name: name as Path<TData> }) as TValue;\r\n}\r\n\r\n// =============================================================================\r\n// UTILITIES\r\n// =============================================================================\r\n\r\n/**\r\n * Normalize RHF's nested error structure to flat string map.\r\n */\r\nfunction normalizeErrors<TData extends FieldValues>(\r\n    errors: FieldErrors<TData>\r\n): Record<string, string | string[] | undefined> {\r\n    const result: Record<string, string | string[] | undefined> = {};\r\n\r\n    function traverse(obj: Record<string, unknown>, prefix = '') {\r\n        for (const key in obj) {\r\n            const path = prefix ? `${prefix}.${key}` : key;\r\n            const value = obj[key];\r\n\r\n            if (isRecord(value) && 'message' in value && typeof value.message === 'string') {\r\n                // Leaf error\r\n                result[path] = value.message;\r\n            } else if (\r\n                isRecord(value) &&\r\n                'root' in value &&\r\n                isRecord(value.root) &&\r\n                'message' in value.root &&\r\n                typeof value.root.message === 'string'\r\n            ) {\r\n                // Array root error\r\n                result[path] = value.root.message;\r\n            } else if (isRecord(value)) {\r\n                // Nested object, traverse deeper\r\n                traverse(value, path);\r\n            }\r\n        }\r\n    }\r\n\r\n    traverse(errors as unknown as Record<string, unknown>);\r\n    return result;\r\n}\r\n\r\n\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n    return typeof value === 'object' && value !== null;\r\n}\r\n\r\n// =============================================================================\r\n// RE-EXPORTS FOR CONVENIENCE\r\n// =============================================================================\r\n\r\nexport type { UseFormReturn as RhfForm } from 'react-hook-form';"],"mappings":"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","names":["options"]}