@fuf-stack/uniform 1.6.5 → 1.7.0

package/dist/hooks/index.cjs

@@ -1,32 +1,36 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-LTKRK3OS.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-KWJMKX5J.cjs');
 
 
-var _chunkBZ5OMN4Ycjs = require('../chunk-BZ5OMN4Y.cjs');
+var _chunkNTOYCWCJcjs = require('../chunk-NTOYCWCJ.cjs');
 
 
-var _chunk4WYC2RBEcjs = require('../chunk-4WYC2RBE.cjs');
+var _chunkIFBKJ5UZcjs = require('../chunk-IFBKJ5UZ.cjs');
 
 
-var _chunkVDTYZM6Ncjs = require('../chunk-VDTYZM6N.cjs');
-
-
-var _chunkSOQ6GCN3cjs = require('../chunk-SOQ6GCN3.cjs');
+var _chunkOQUTHTOKcjs = require('../chunk-OQUTHTOK.cjs');
+require('../chunk-OE5BOGGX.cjs');
 require('../chunk-NHEZXA4H.cjs');
 
 
-var _chunkJMFDNTVCcjs = require('../chunk-JMFDNTVC.cjs');
+var _chunk7KEUEGRCcjs = require('../chunk-7KEUEGRC.cjs');
 
 
 var _chunkPCTYJUY7cjs = require('../chunk-PCTYJUY7.cjs');
-require('../chunk-OE5BOGGX.cjs');
 
 
+var _chunk56TQOKG7cjs = require('../chunk-56TQOKG7.cjs');
+
 
-var _chunkD3EZXJQHcjs = require('../chunk-D3EZXJQH.cjs');
+var _chunk4F45XA7Ycjs = require('../chunk-4F45XA7Y.cjs');
 
 
 
-var _chunk42NCLEX4cjs = require('../chunk-42NCLEX4.cjs');
+var _chunkEUTTXFWAcjs = require('../chunk-EUTTXFWA.cjs');
+
+
+
+var _chunk6LQ2O6SCcjs = require('../chunk-6LQ2O6SC.cjs');
+require('../chunk-4L3JXJ62.cjs');
 require('../chunk-Z353BLWI.cjs');
 require('../chunk-555JRYCS.cjs');
 
@@ -40,5 +44,6 @@ require('../chunk-555JRYCS.cjs');
 
 
 
-exports.checkFieldIsRequired = _chunk42NCLEX4cjs.checkFieldIsRequired; exports.clientValidationSchemaByName = _chunkD3EZXJQHcjs.clientValidationSchemaByName; exports.useClientValidation = _chunkD3EZXJQHcjs.useClientValidation; exports.useController = _chunkJMFDNTVCcjs.useController; exports.useFormContext = _chunk42NCLEX4cjs.useFormContext; exports.useInput = _chunkPCTYJUY7cjs.useInput; exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce; exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform; exports.useUniformField = _chunkSOQ6GCN3cjs.useUniformField; exports.useUniformFieldArray = _chunkVDTYZM6Ncjs.useUniformFieldArray;
+
+exports.checkFieldIsRequired = _chunk6LQ2O6SCcjs.checkFieldIsRequired; exports.clientValidationSchemaByName = _chunkEUTTXFWAcjs.clientValidationSchemaByName; exports.useClientValidation = _chunkEUTTXFWAcjs.useClientValidation; exports.useController = _chunk7KEUEGRCcjs.useController; exports.useFormContext = _chunk6LQ2O6SCcjs.useFormContext; exports.useInput = _chunkPCTYJUY7cjs.useInput; exports.useInputValueDebounce = _chunkNTOYCWCJcjs.useInputValueDebounce; exports.useInputValueTransform = _chunk56TQOKG7cjs.useInputValueTransform; exports.useUniformField = _chunkOQUTHTOKcjs.useUniformField; exports.useUniformFieldArray = _chunkIFBKJ5UZcjs.useUniformFieldArray; exports.useWatchUserChange = _chunk4F45XA7Ycjs.useWatchUserChange;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"],"names":[],"mappings":"AAAA,0GAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,6pBAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"],"names":[],"mappings":"AAAA,0GAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,guBAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"}

package/dist/hooks/index.d.cts

@@ -6,8 +6,9 @@ export { useInput } from '@heroui/input';
 export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce } from './useInputValueDebounce/index.cjs';
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform } from './useInputValueTransform/index.cjs';
 export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField } from './useUniformField/index.cjs';
+export { UseWatchUserChangeOptions, useWatchUserChange } from './useWatchUserChange/index.cjs';
 import '@fuf-stack/veto/dist/types.d-CNPgNK-V';
 import '@fuf-stack/veto';
 import 'react-hook-form';
 import 'react';
-import '../FormContext-LRho0tno.cjs';
+import '../FormContext-9Firwt4k.cjs';

package/dist/hooks/index.d.ts

@@ -6,8 +6,9 @@ export { useInput } from '@heroui/input';
 export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce } from './useInputValueDebounce/index.js';
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform } from './useInputValueTransform/index.js';
 export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField } from './useUniformField/index.js';
+export { UseWatchUserChangeOptions, useWatchUserChange } from './useWatchUserChange/index.js';
 import '@fuf-stack/veto/dist/types.d-CNPgNK-V';
 import '@fuf-stack/veto';
 import 'react-hook-form';
 import 'react';
-import '../FormContext-LRho0tno.js';
+import '../FormContext-9Firwt4k.js';

package/dist/hooks/index.js

@@ -1,32 +1,36 @@
-import "../chunk-35V726MB.js";
+import "../chunk-V3GDAELU.js";
 import {
   useInputValueDebounce
-} from "../chunk-MODD3TFE.js";
-import {
-  useInputValueTransform
-} from "../chunk-7KLFK2IT.js";
+} from "../chunk-ZJDU5EPE.js";
 import {
   useUniformFieldArray
-} from "../chunk-X37C4SVI.js";
+} from "../chunk-FND5Z5BW.js";
 import {
   useUniformField
-} from "../chunk-D3JYMGTB.js";
+} from "../chunk-EGFB5WEK.js";
+import "../chunk-NTDKZW4E.js";
 import "../chunk-ELYGQTXB.js";
 import {
   useController
-} from "../chunk-CK362NWK.js";
+} from "../chunk-GKP3ONKO.js";
 import {
   useInput
 } from "../chunk-AHJJIANM.js";
-import "../chunk-NTDKZW4E.js";
+import {
+  useInputValueTransform
+} from "../chunk-CNTOODUQ.js";
+import {
+  useWatchUserChange
+} from "../chunk-PY4GCAFN.js";
 import {
   clientValidationSchemaByName,
   useClientValidation
-} from "../chunk-RI45RSNN.js";
+} from "../chunk-4TQ53WAY.js";
 import {
   checkFieldIsRequired,
   useFormContext
-} from "../chunk-NZ54JBSR.js";
+} from "../chunk-U45RW4FC.js";
+import "../chunk-LKR6D3RL.js";
 import "../chunk-76KOVUDN.js";
 import "../chunk-K2V4ULA2.js";
 export {
@@ -39,6 +43,7 @@ export {
   useInputValueDebounce,
   useInputValueTransform,
   useUniformField,
-  useUniformFieldArray
+  useUniformFieldArray,
+  useWatchUserChange
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/useClientValidation/index.cjs

@@ -1,12 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkD3EZXJQHcjs = require('../../chunk-D3EZXJQH.cjs');
-require('../../chunk-42NCLEX4.cjs');
+var _chunkEUTTXFWAcjs = require('../../chunk-EUTTXFWA.cjs');
+require('../../chunk-6LQ2O6SC.cjs');
+require('../../chunk-4L3JXJ62.cjs');
 require('../../chunk-Z353BLWI.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
 
-exports.clientValidationSchemaByName = _chunkD3EZXJQHcjs.clientValidationSchemaByName; exports.useClientValidation = _chunkD3EZXJQHcjs.useClientValidation;
+exports.clientValidationSchemaByName = _chunkEUTTXFWAcjs.clientValidationSchemaByName; exports.useClientValidation = _chunkEUTTXFWAcjs.useClientValidation;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useClientValidation/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useClientValidation/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACA;AACF,2JAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useClientValidation/index.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useClientValidation/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACA;AACF,2JAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useClientValidation/index.cjs"}

package/dist/hooks/useClientValidation/index.js

@@ -1,8 +1,9 @@
 import {
   clientValidationSchemaByName,
   useClientValidation
-} from "../../chunk-RI45RSNN.js";
-import "../../chunk-NZ54JBSR.js";
+} from "../../chunk-4TQ53WAY.js";
+import "../../chunk-U45RW4FC.js";
+import "../../chunk-LKR6D3RL.js";
 import "../../chunk-76KOVUDN.js";
 import "../../chunk-K2V4ULA2.js";
 export {

package/dist/hooks/useController/index.cjs

@@ -1,9 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkJMFDNTVCcjs = require('../../chunk-JMFDNTVC.cjs');
+var _chunk7KEUEGRCcjs = require('../../chunk-7KEUEGRC.cjs');
+require('../../chunk-4L3JXJ62.cjs');
 require('../../chunk-Z353BLWI.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
-exports.useController = _chunkJMFDNTVCcjs.useController;
+exports.useController = _chunk7KEUEGRCcjs.useController;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useController/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useController/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACF,wDAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useController/index.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useController/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACF,wDAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useController/index.cjs"}

package/dist/hooks/useController/index.d.cts

@@ -17,6 +17,7 @@ interface UseControllerReturn<TFieldValues extends object = object> {
  * 2. Null/undefined values in form state are displayed as empty strings in the UI
  * 3. Handles both direct value changes and React synthetic events
  * 4. Maintains the same API as react-hook-form's useController
+ * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)
  *
  * This enables consistent handling of empty/null values while keeping a clean API
  * for form inputs that expect string values.

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

@@ -17,6 +17,7 @@ interface UseControllerReturn<TFieldValues extends object = object> {
  * 2. Null/undefined values in form state are displayed as empty strings in the UI
  * 3. Handles both direct value changes and React synthetic events
  * 4. Maintains the same API as react-hook-form's useController
+ * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)
  *
  * This enables consistent handling of empty/null values while keeping a clean API
  * for form inputs that expect string values.

package/dist/hooks/useController/index.js

@@ -1,6 +1,7 @@
 import {
   useController
-} from "../../chunk-CK362NWK.js";
+} from "../../chunk-GKP3ONKO.js";
+import "../../chunk-LKR6D3RL.js";
 import "../../chunk-76KOVUDN.js";
 import "../../chunk-K2V4ULA2.js";
 export {

package/dist/hooks/useFormContext/index.cjs

@@ -1,11 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunk42NCLEX4cjs = require('../../chunk-42NCLEX4.cjs');
+var _chunk6LQ2O6SCcjs = require('../../chunk-6LQ2O6SC.cjs');
+require('../../chunk-4L3JXJ62.cjs');
 require('../../chunk-Z353BLWI.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
 
-exports.checkFieldIsRequired = _chunk42NCLEX4cjs.checkFieldIsRequired; exports.useFormContext = _chunk42NCLEX4cjs.useFormContext;
+exports.checkFieldIsRequired = _chunk6LQ2O6SCcjs.checkFieldIsRequired; exports.useFormContext = _chunk6LQ2O6SCcjs.useFormContext;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useFormContext/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useFormContext/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACA;AACF,iIAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useFormContext/index.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useFormContext/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACA;AACF,iIAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useFormContext/index.cjs"}

package/dist/hooks/useFormContext/index.d.cts

@@ -1,7 +1,7 @@
 import * as _fuf_stack_veto from '@fuf-stack/veto';
 import { VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
 import * as React from 'react';
-import { D as DebugModeSettings } from '../../FormContext-LRho0tno.cjs';
+import { D as DebugModeSettings, U as UserChangeListener } from '../../FormContext-9Firwt4k.cjs';
 import * as react_hook_form from 'react-hook-form';
 import { FieldValues, Path, FieldError } from 'react-hook-form';
 
@@ -29,6 +29,10 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     preventSubmit: (prevent: boolean) => void;
     setDebugMode: (debugMode: "debug" | "debug-testids" | "off" | "disabled") => void;
     triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
+    userChange: {
+        subscribe: (listener: UserChangeListener) => () => void;
+        notify: (fieldName: string, value: unknown) => void;
+    };
     validation: {
         baseInstance?: VetoInstance;
         instance?: VetoInstance;

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

@@ -1,7 +1,7 @@
 import * as _fuf_stack_veto from '@fuf-stack/veto';
 import { VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
 import * as React from 'react';
-import { D as DebugModeSettings } from '../../FormContext-LRho0tno.js';
+import { D as DebugModeSettings, U as UserChangeListener } from '../../FormContext-9Firwt4k.js';
 import * as react_hook_form from 'react-hook-form';
 import { FieldValues, Path, FieldError } from 'react-hook-form';
 
@@ -29,6 +29,10 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     preventSubmit: (prevent: boolean) => void;
     setDebugMode: (debugMode: "debug" | "debug-testids" | "off" | "disabled") => void;
     triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
+    userChange: {
+        subscribe: (listener: UserChangeListener) => () => void;
+        notify: (fieldName: string, value: unknown) => void;
+    };
     validation: {
         baseInstance?: VetoInstance;
         instance?: VetoInstance;

package/dist/hooks/useFormContext/index.js

@@ -1,7 +1,8 @@
 import {
   checkFieldIsRequired,
   useFormContext
-} from "../../chunk-NZ54JBSR.js";
+} from "../../chunk-U45RW4FC.js";
+import "../../chunk-LKR6D3RL.js";
 import "../../chunk-76KOVUDN.js";
 import "../../chunk-K2V4ULA2.js";
 export {

package/dist/hooks/useInputValueDebounce/index.cjs

@@ -1,9 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkBZ5OMN4Ycjs = require('../../chunk-BZ5OMN4Y.cjs');
-require('../../chunk-4WYC2RBE.cjs');
+var _chunkNTOYCWCJcjs = require('../../chunk-NTOYCWCJ.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
-exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce;
+exports.useInputValueDebounce = _chunkNTOYCWCJcjs.useInputValueDebounce;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useInputValueDebounce/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useInputValueDebounce/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACF,wEAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useInputValueDebounce/index.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useInputValueDebounce/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,4DAAiC;AACjC,oCAAiC;AACjC;AACE;AACF,wEAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useInputValueDebounce/index.cjs"}

package/dist/hooks/useInputValueDebounce/index.d.cts

@@ -1,49 +1,43 @@
-import { InputValueTransform } from '../useInputValueTransform/index.cjs';
-
-interface UseInputValueDebounceOptions {
+interface UseInputValueDebounceOptions<TValue = unknown> {
     /** Debounce delay in milliseconds (default: 300) */
     debounceDelay?: number;
     /** The onBlur function to call after flushing debounced value */
     onBlur: () => void;
     /** The onChange function to call with debounced value */
     onChange: (...event: any[]) => void;
-    /** Value transformation functions */
-    transform?: InputValueTransform;
-    /** Input type to handle number conversion (optional) */
-    type?: 'text' | 'number' | 'password';
-    /** The initial form value */
-    value: string | number;
+    /** The field value */
+    value: TValue;
 }
-interface UseInputValueDebounceReturn {
+interface UseInputValueDebounceReturn<TValue = unknown> {
     /** Enhanced onChange function with debouncing */
     onChange: (...event: any[]) => void;
     /** Enhanced onBlur function that flushes current value immediately */
     onBlur: () => void;
     /** The field value that is displayed - updates immediately */
-    value: string | number;
+    value: TValue;
 }
 /**
- * Custom hook for debouncing input value changes with immediate blur support.
+ * Custom hook for debouncing value changes with immediate blur support.
  *
- * Provides immediate visual feedback by updating the display value instantly,
- * while debouncing the actual form state changes. When the input loses focus,
+ * Provides immediate visual feedback by updating the value instantly,
+ * while debouncing the actual onChange calls. When focus is lost,
  * any pending debounced changes are immediately flushed.
  *
  * **Key Features:**
- * - **Debouncing**: Delays form updates until user stops typing
- * - **Transform support**: Optional value transformation between display and form values
- * - **Number conversion**: Automatic conversion for number inputs
- * - **Immediate display updates**: UI stays responsive during debouncing
+ * - **Debouncing**: Delays onChange calls until user stops typing
+ * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)
+ * - **Immediate value updates**: UI stays responsive during debouncing
  * - **Blur flushing**: Immediately applies pending changes on blur
  *
+ * **Note:** Value transformations should be handled at the `useUniformField` level,
+ * not in this hook. This hook only handles debouncing timing.
+ *
  * @param options Configuration for debounced value handling
  * @param options.debounceDelay Delay in milliseconds (default: 300)
  * @param options.onBlur Function to call after flushing debounced value
  * @param options.onChange Function to call with debounced value
- * @param options.transform Optional transform functions for display ↔ form value conversion
- * @param options.type Input type for number conversion ('text' | 'number' | 'password')
- * @param options.value The initial form value
- * @returns Object containing enhanced onChange, onBlur, and immediate display value
+ * @param options.value The field value
+ * @returns Object containing enhanced onChange, onBlur, and immediate value
  *
  * @example
  * Basic usage with debouncing:
@@ -55,36 +49,7 @@ interface UseInputValueDebounceReturn {
  *   value: field.value,
  * });
  * ```
- *
- * @example
- * Number input with automatic conversion:
- * ```tsx
- * const { onChange, onBlur, value } = useInputValueDebounce({
- *   debounceDelay: 300,
- *   onBlur: field.onBlur,
- *   onChange: field.onChange,
- *   type: 'number',
- *   value: field.value, // Display: 123 (number), Form: 123 (number)
- * });
- * ```
- *
- * @example
- * Currency formatting with transforms:
- * ```tsx
- * const currencyTransform = {
- *   displayValue: (val) => val ? `$${Number(val).toFixed(2)}` : '',
- *   formValue: (val) => Number(val.replace(/[$,]/g, '')) || 0
- * };
- *
- * const { onChange, onBlur, value } = useInputValueDebounce({
- *   debounceDelay: 300,
- *   onBlur: field.onBlur,
- *   onChange: field.onChange,
- *   transform: currencyTransform,
- *   value: field.value, // Display: "$100.00", Form: 100
- * });
- * ```
  */
-declare const useInputValueDebounce: ({ debounceDelay, onBlur, onChange, transform, type, value, }: UseInputValueDebounceOptions) => UseInputValueDebounceReturn;
+declare const useInputValueDebounce: <TValue = unknown>({ debounceDelay, onBlur, onChange, value, }: UseInputValueDebounceOptions<TValue>) => UseInputValueDebounceReturn<TValue>;
 
 export { type UseInputValueDebounceOptions, type UseInputValueDebounceReturn, useInputValueDebounce };

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

@@ -1,49 +1,43 @@
-import { InputValueTransform } from '../useInputValueTransform/index.js';
-
-interface UseInputValueDebounceOptions {
+interface UseInputValueDebounceOptions<TValue = unknown> {
     /** Debounce delay in milliseconds (default: 300) */
     debounceDelay?: number;
     /** The onBlur function to call after flushing debounced value */
     onBlur: () => void;
     /** The onChange function to call with debounced value */
     onChange: (...event: any[]) => void;
-    /** Value transformation functions */
-    transform?: InputValueTransform;
-    /** Input type to handle number conversion (optional) */
-    type?: 'text' | 'number' | 'password';
-    /** The initial form value */
-    value: string | number;
+    /** The field value */
+    value: TValue;
 }
-interface UseInputValueDebounceReturn {
+interface UseInputValueDebounceReturn<TValue = unknown> {
     /** Enhanced onChange function with debouncing */
     onChange: (...event: any[]) => void;
     /** Enhanced onBlur function that flushes current value immediately */
     onBlur: () => void;
     /** The field value that is displayed - updates immediately */
-    value: string | number;
+    value: TValue;
 }
 /**
- * Custom hook for debouncing input value changes with immediate blur support.
+ * Custom hook for debouncing value changes with immediate blur support.
  *
- * Provides immediate visual feedback by updating the display value instantly,
- * while debouncing the actual form state changes. When the input loses focus,
+ * Provides immediate visual feedback by updating the value instantly,
+ * while debouncing the actual onChange calls. When focus is lost,
  * any pending debounced changes are immediately flushed.
  *
  * **Key Features:**
- * - **Debouncing**: Delays form updates until user stops typing
- * - **Transform support**: Optional value transformation between display and form values
- * - **Number conversion**: Automatic conversion for number inputs
- * - **Immediate display updates**: UI stays responsive during debouncing
+ * - **Debouncing**: Delays onChange calls until user stops typing
+ * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)
+ * - **Immediate value updates**: UI stays responsive during debouncing
  * - **Blur flushing**: Immediately applies pending changes on blur
  *
+ * **Note:** Value transformations should be handled at the `useUniformField` level,
+ * not in this hook. This hook only handles debouncing timing.
+ *
  * @param options Configuration for debounced value handling
  * @param options.debounceDelay Delay in milliseconds (default: 300)
  * @param options.onBlur Function to call after flushing debounced value
  * @param options.onChange Function to call with debounced value
- * @param options.transform Optional transform functions for display ↔ form value conversion
- * @param options.type Input type for number conversion ('text' | 'number' | 'password')
- * @param options.value The initial form value
- * @returns Object containing enhanced onChange, onBlur, and immediate display value
+ * @param options.value The field value
+ * @returns Object containing enhanced onChange, onBlur, and immediate value
  *
  * @example
  * Basic usage with debouncing:
@@ -55,36 +49,7 @@ interface UseInputValueDebounceReturn {
  *   value: field.value,
  * });
  * ```
- *
- * @example
- * Number input with automatic conversion:
- * ```tsx
- * const { onChange, onBlur, value } = useInputValueDebounce({
- *   debounceDelay: 300,
- *   onBlur: field.onBlur,
- *   onChange: field.onChange,
- *   type: 'number',
- *   value: field.value, // Display: 123 (number), Form: 123 (number)
- * });
- * ```
- *
- * @example
- * Currency formatting with transforms:
- * ```tsx
- * const currencyTransform = {
- *   displayValue: (val) => val ? `$${Number(val).toFixed(2)}` : '',
- *   formValue: (val) => Number(val.replace(/[$,]/g, '')) || 0
- * };
- *
- * const { onChange, onBlur, value } = useInputValueDebounce({
- *   debounceDelay: 300,
- *   onBlur: field.onBlur,
- *   onChange: field.onChange,
- *   transform: currencyTransform,
- *   value: field.value, // Display: "$100.00", Form: 100
- * });
- * ```
  */
-declare const useInputValueDebounce: ({ debounceDelay, onBlur, onChange, transform, type, value, }: UseInputValueDebounceOptions) => UseInputValueDebounceReturn;
+declare const useInputValueDebounce: <TValue = unknown>({ debounceDelay, onBlur, onChange, value, }: UseInputValueDebounceOptions<TValue>) => UseInputValueDebounceReturn<TValue>;
 
 export { type UseInputValueDebounceOptions, type UseInputValueDebounceReturn, useInputValueDebounce };

package/dist/hooks/useInputValueDebounce/index.js

@@ -1,7 +1,6 @@
 import {
   useInputValueDebounce
-} from "../../chunk-MODD3TFE.js";
-import "../../chunk-7KLFK2IT.js";
+} from "../../chunk-ZJDU5EPE.js";
 import "../../chunk-K2V4ULA2.js";
 export {
   useInputValueDebounce

package/dist/hooks/useInputValueTransform/index.cjs

@@ -1,8 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk4WYC2RBEcjs = require('../../chunk-4WYC2RBE.cjs');
+var _chunk56TQOKG7cjs = require('../../chunk-56TQOKG7.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
-exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform;
+exports.useInputValueTransform = _chunk56TQOKG7cjs.useInputValueTransform;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useInputValueTransform/index.d.cts

@@ -1,20 +1,20 @@
-interface InputValueTransform {
-    /** Transforms the form value to display value (e.g., 1000 → "$1,000") */
-    toDisplayValue: (value: string | number) => string | number;
-    /** Transforms the display value to form value (e.g., "$1,000" → 1000) */
-    toFormValue: (value: string) => string | number;
+interface InputValueTransform<TDisplay = unknown> {
+    /** Transforms the form value to display value (e.g., 1000 → "$1,000" or 'a' → ['a']) */
+    toDisplayValue: (value: unknown) => TDisplay;
+    /** Transforms the display value to form value (e.g., "$1,000" → 1000 or ['a'] → 'a') */
+    toFormValue: (value: TDisplay) => unknown;
 }
-interface UseInputValueTransformOptions {
+interface UseInputValueTransformOptions<TDisplay = unknown> {
     /** Input type for special number handling */
     type?: 'text' | 'number' | 'password';
     /** Value transformation functions */
-    transform?: InputValueTransform;
+    transform?: InputValueTransform<TDisplay>;
 }
-interface UseInputValueTransformReturn {
+interface UseInputValueTransformReturn<TDisplay = unknown> {
     /** Converts any form value to display value */
-    toDisplayValue: (formValue: string | number) => string | number;
+    toDisplayValue: (formValue: unknown) => TDisplay;
     /** Converts any display value to form value */
-    toFormValue: (displayValue: string | number) => string | number;
+    toFormValue: (displayValue: TDisplay) => unknown;
 }
 /**
  * Custom hook providing utility functions for value transformations between display and form values.
@@ -24,9 +24,11 @@ interface UseInputValueTransformReturn {
  * - Number inputs with special handling
  * - Date formatting (MM/DD/YYYY display vs ISO date stored)
  * - Phone number formatting ((555) 123-4567 display vs 5551234567 stored)
+ * - Array/Object transformations (single value ↔ array, nested structures)
  *
  * **Key Features:**
  * - Pure conversion functions (no state)
+ * - Generic support for any data type (strings, numbers, arrays, objects)
  * - Special number input handling (empty string preservation)
  * - Bidirectional value transformations
  * - Memoized functions for performance
@@ -38,8 +40,8 @@ interface UseInputValueTransformReturn {
  * ```tsx
  * // Currency formatting
  * const currencyTransform = {
- *   displayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',
- *   formValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0
+ *   toDisplayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',
+ *   toFormValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0
  * };
  *
  * const { toDisplayValue, toFormValue } = useInputValueTransform({
@@ -63,6 +65,22 @@ interface UseInputValueTransformReturn {
  *
  * @example
  * ```tsx
+ * // Array to single value (for single checkbox)
+ * const singleValueTransform = {
+ *   toDisplayValue: (val: string[]) => val?.[0] || '',
+ *   toFormValue: (val: string) => val ? [val] : []
+ * };
+ *
+ * const { toDisplayValue, toFormValue } = useInputValueTransform({
+ *   transform: singleValueTransform
+ * });
+ *
+ * const displayVal = toDisplayValue(['option1']); // "option1"
+ * const formVal = toFormValue("option2"); // ["option2"]
+ * ```
+ *
+ * @example
+ * ```tsx
  * // Integration with debouncing
  * const MyInput = ({ field, transform }) => {
  *   const transform = useInputValueTransform({ transform });
@@ -79,6 +97,6 @@ interface UseInputValueTransformReturn {
  * };
  * ```
  */
-declare const useInputValueTransform: ({ type, transform, }: UseInputValueTransformOptions) => UseInputValueTransformReturn;
+declare const useInputValueTransform: <TDisplay = unknown>({ type, transform, }: UseInputValueTransformOptions<TDisplay>) => UseInputValueTransformReturn<TDisplay>;
 
 export { type InputValueTransform, type UseInputValueTransformOptions, type UseInputValueTransformReturn, useInputValueTransform };