@fuf-stack/uniform 1.6.0 → 1.6.1

package/dist/{chunk-JEXF6TLO.cjs → chunk-XJBGXFVX.cjs}

@@ -1,14 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
+var _chunkNHEZXA4Hcjs = require('./chunk-NHEZXA4H.cjs');
+
 
+var _chunkJMFDNTVCcjs = require('./chunk-JMFDNTVC.cjs');
 
-var _chunk3SZ2UKFAcjs = require('./chunk-3SZ2UKFA.cjs');
+
+var _chunkPCTYJUY7cjs = require('./chunk-PCTYJUY7.cjs');
 
 
 var _chunkOE5BOGGXcjs = require('./chunk-OE5BOGGX.cjs');
 
 
-var _chunkNHEZXA4Hcjs = require('./chunk-NHEZXA4H.cjs');
+var _chunkNZBO4N3Scjs = require('./chunk-NZBO4N3S.cjs');
 
 
 
@@ -44,11 +48,11 @@ var Switch = ({
   testId: _testId = void 0,
   thumbIcon = void 0
 }) => {
-  const { control, debugMode, getFieldState } = _chunk3SZ2UKFAcjs.useFormContext.call(void 0, );
+  const { control, debugMode, getFieldState } = _chunkNZBO4N3Scjs.useFormContext.call(void 0, );
   const { error, required, testId, invalid } = getFieldState(name, _testId);
-  const { field } = _chunk3SZ2UKFAcjs.useController.call(void 0, { name, control, disabled });
+  const { field } = _chunkJMFDNTVCcjs.useController.call(void 0, { name, control, disabled });
   const { disabled: isDisabled, value, ref, onBlur, onChange } = field;
-  const { label, getInputProps, getErrorMessageProps } = _chunk3SZ2UKFAcjs.useInput.call(void 0, {
+  const { label, getInputProps, getErrorMessageProps } = _chunkPCTYJUY7cjs.useInput.call(void 0, {
     errorMessage: JSON.stringify(error),
     isInvalid: invalid,
     isRequired: required,
@@ -98,4 +102,4 @@ var Switch_default2 = Switch_default;
 
 
 exports.Switch_default = Switch_default; exports.Switch_default2 = Switch_default2;
-//# sourceMappingURL=chunk-JEXF6TLO.cjs.map
+//# sourceMappingURL=chunk-XJBGXFVX.cjs.map

package/dist/chunk-XJBGXFVX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-XJBGXFVX.cjs","../src/Switch/Switch.tsx","../src/Switch/index.ts"],"names":["Switch_default"],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACfA,wCAAqC;AAErC,oDAAyC;AAoFnC,+CAAA;AA9EC,IAAM,eAAA,EAAiB,4BAAA;AAAG,EAC/B,KAAA,EAAO;AAAA,IACL,IAAA,EAAM,EAAA;AAAA,IACN,UAAA,EAAY,EAAA;AAAA,IACZ,YAAA,EAAc,WAAA;AAAA;AAAA;AAAA,IAGd,KAAA,EACE,yNAAA;AAAA,IACF,YAAA,EAAc,sBAAA;AAAA,IACd,YAAA,EAAc,EAAA;AAAA,IACd,KAAA,EAAO,EAAA;AAAA,IACP,SAAA,EAAW,EAAA;AAAA,IACX,OAAA,EAAS;AAAA,EACX;AACF,CAAC,CAAA;AA6BD,IAAM,OAAA,EAAS,CAAC;AAAA,EACd,UAAA,EAAY,KAAA,CAAA;AAAA,EACZ,SAAA,EAAW,KAAA;AAAA,EACX,WAAA,EAAa,KAAA,CAAA;AAAA,EACb,KAAA,EAAO,OAAA,EAAS,KAAA,CAAA;AAAA,EAChB,IAAA;AAAA,EACA,KAAA,EAAO,KAAA,CAAA;AAAA,EACP,aAAA,EAAe,KAAA,CAAA;AAAA,EACf,MAAA,EAAQ,QAAA,EAAU,KAAA,CAAA;AAAA,EAClB,UAAA,EAAY,KAAA;AACd,CAAA,EAAA,GAAmB;AACjB,EAAA,MAAM,EAAE,OAAA,EAAS,SAAA,EAAW,cAAc,EAAA,EAAI,8CAAA,CAAe;AAC7D,EAAA,MAAM,EAAE,KAAA,EAAO,QAAA,EAAU,MAAA,EAAQ,QAAQ,EAAA,EAAI,aAAA,CAAc,IAAA,EAAM,OAAO,CAAA;AAExE,EAAA,MAAM,EAAE,MAAM,EAAA,EAAI,6CAAA,EAA6B,IAAA,EAAM,OAAA,EAAS,SAAS,CAAC,CAAA;AACxE,EAAA,MAAM,EAAE,QAAA,EAAU,UAAA,EAAY,KAAA,EAAO,GAAA,EAAK,MAAA,EAAQ,SAAS,EAAA,EAAI,KAAA;AAE/D,EAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAe,qBAAqB,EAAA,EAAI,wCAAA;AAAS,IAC9D,YAAA,EAAc,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAAA,IAClC,SAAA,EAAW,OAAA;AAAA,IACX,UAAA,EAAY,QAAA;AAAA,IACZ,KAAA,EAAO,MAAA;AAAA,IACP,cAAA,EAAgB,SAAA;AAAA,IAChB,WAAA,EAAa;AAAA,EACf,CAAC,CAAA;AAED,EAAA,MAAM,qBAAA,EAAuB,UAAA,IAAc,eAAA;AAG3C,EAAA,MAAM,SAAA,EAAW,cAAA,CAAe,CAAA;AAChC,EAAA,MAAM,WAAA,EAAa,8CAAA,QAAqB,EAAU,SAAA,EAAW,cAAc,CAAA;AAE3E,EAAA,uBACE,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAW,UAAA,CAAW,YAAA,EACzB,QAAA,EAAA;AAAA,oBAAA,8BAAA;AAAA,MAAC,cAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QAGA,kBAAA,EAAkB,aAAA,CAAc,CAAA,CAAE,kBAAkB,CAAA;AAAA,QACpD,UAAA;AAAA,QACA,cAAA,EAAc,OAAA;AAAA,QACd,eAAA,EAAe,QAAA;AAAA,QACf,aAAA,EAAa,MAAA;AAAA,QACb,UAAA;AAAA,QACA,UAAA;AAAA,QACA,UAAA,EAAY,CAAC,CAAC,KAAA;AAAA,QACd,IAAA;AAAA,QACA,MAAA;AAAA,QACA,aAAA,EAAe,QAAA;AAAA,QACf,QAAA;AAAA,QACA,IAAA;AAAA,QACA,YAAA;AAAA,QACA,SAAA;AAAA,QACA,KAAA;AAAA,QAEC,QAAA,EAAA;AAAA,UAAA,KAAA;AAAA,UACA,qBAAA,kBACC,6BAAA,+CAAC,EAAA,EAAsB,OAAA,CAAgB,EAAA,EACrC;AAAA,QAAA;AAAA,MAAA;AAAA,IACN,CAAA;AAAA,IACC,MAAA,kBACC,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAW,UAAA,CAAW,YAAA,EACzB,QAAA,kBAAA,6BAAA,KAAC,EAAA,6CAAA,8CAAA,CAAA,CAAA,EAAQ,oBAAA,CAAqB,CAAA,CAAA,EAA7B,EACC,QAAA,kBAAA,6BAAA,8CAAC,EAAA,EAAqB,KAAA,EAAc,OAAA,CAAgB,EAAA,CAAA,CACtD,EAAA,CACF,EAAA,EACE;AAAA,EAAA,EAAA,CACN,CAAA;AAEJ,CAAA;AAEA,IAAO,eAAA,EAAQ,MAAA;ADhCf;AACA;AE3FA,IAAOA,gBAAAA,EAAQ,cAAA;AF6Ff;AACA;AACE;AACA;AACF,mFAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-XJBGXFVX.cjs","sourcesContent":[null,"import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { SwitchProps as HeroSwitchProps } from '@heroui/switch';\nimport type { ReactNode } from 'react';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { Switch as HeroSwitch } from '@heroui/switch';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useController, useFormContext, useInput } from '../hooks';\nimport { FieldCopyTestIdButton } from '../partials/FieldCopyTestIdButton';\nimport { FieldValidationError } from '../partials/FieldValidationError';\n\nexport const switchVariants = tv({\n  slots: {\n    base: '',\n    endContent: '',\n    errorMessage: 'ml-1 mt-1',\n    // see HeroUI styles for group-data condition,\n    // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/core/theme/src/components/select.ts\n    label:\n      'text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:!text-danger group-data-[required=true]:after:ml-0.5 group-data-[required=true]:after:text-danger group-data-[required=true]:after:content-[\"*\"]',\n    outerWrapper: 'place-content-center',\n    startContent: '',\n    thumb: '',\n    thumbIcon: '',\n    wrapper: '',\n  },\n});\n\ntype VariantProps = TVProps<typeof switchVariants>;\ntype ClassName = TVClassName<typeof switchVariants>;\n\nexport interface SwitchProps extends VariantProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** whether the select should be disabled */\n  disabled?: boolean;\n  /** Icon to be displayed at the end of the switch (when enabled) */\n  endContent?: ReactNode;\n  /** component displayed next to the switch */\n  label?: ReactNode;\n  /** name the field is registered under */\n  name: string;\n  /* Size of the switch */\n  size?: 'sm' | 'md' | 'lg';\n  /** Icon to be displayed at the start of the switch (when disabled) */\n  startContent?: ReactNode;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** Icon to be displayed inside the thumb */\n  thumbIcon?: HeroSwitchProps['thumbIcon'];\n}\n\n/**\n *  Switch component based on [HeroUI Switch](https://www.heroui.com//docs/components/switch)\n */\nconst Switch = ({\n  className = undefined,\n  disabled = false,\n  endContent = undefined,\n  label: _label = undefined,\n  name,\n  size = undefined,\n  startContent = undefined,\n  testId: _testId = undefined,\n  thumbIcon = undefined,\n}: SwitchProps) => {\n  const { control, debugMode, getFieldState } = useFormContext();\n  const { error, required, testId, invalid } = getFieldState(name, _testId);\n\n  const { field } = useController<FieldValues>({ name, control, disabled });\n  const { disabled: isDisabled, value, ref, onBlur, onChange } = field;\n\n  const { label, getInputProps, getErrorMessageProps } = useInput({\n    errorMessage: JSON.stringify(error),\n    isInvalid: invalid,\n    isRequired: required,\n    label: _label,\n    labelPlacement: 'outside',\n    placeholder: ' ',\n  });\n\n  const showTestIdCopyButton = debugMode === 'debug-testids';\n\n  // classNames from slots\n  const variants = switchVariants();\n  const classNames = variantsToClassNames(variants, className, 'outerWrapper');\n\n  return (\n    <div className={classNames.outerWrapper}>\n      <HeroSwitch\n        ref={ref}\n        // see HeroUI styles for group-data condition (data-invalid),\n        // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/components/select/src/use-select.ts\n        aria-describedby={getInputProps()['aria-describedby']}\n        classNames={classNames}\n        data-invalid={invalid}\n        data-required={required}\n        data-testid={testId}\n        endContent={endContent}\n        isDisabled={isDisabled}\n        isSelected={!!value}\n        name={name}\n        onBlur={onBlur}\n        onValueChange={onChange}\n        required={required}\n        size={size}\n        startContent={startContent}\n        thumbIcon={thumbIcon}\n        value={value}\n      >\n        {label}\n        {showTestIdCopyButton ? (\n          <FieldCopyTestIdButton testId={testId} />\n        ) : null}\n      </HeroSwitch>\n      {error ? (\n        <div className={classNames.errorMessage}>\n          <div {...getErrorMessageProps()}>\n            <FieldValidationError error={error} testId={testId} />\n          </div>\n        </div>\n      ) : null}\n    </div>\n  );\n};\n\nexport default Switch;\n","import Switch from './Switch';\n\nexport type { SwitchProps } from './Switch';\n\nexport { Switch };\n\nexport default Switch;\n"]}

package/dist/chunk-Z7FVILDT.js

@@ -0,0 +1,100 @@
+import {
+  useUniformField
+} from "./chunk-D3NAUOYG.js";
+import {
+  useFormContext
+} from "./chunk-PO5UQAU6.js";
+import {
+  flatArrayKey
+} from "./chunk-76KOVUDN.js";
+import {
+  __spreadValues
+} from "./chunk-K2V4ULA2.js";
+
+// src/hooks/useUniformFieldArray/useUniformFieldArray.ts
+import { useEffect, useMemo, useRef, useState } from "react";
+import { useFieldArray as useRHFFieldArray } from "react-hook-form";
+import { useReducedMotion } from "@fuf-stack/pixel-motion";
+var useUniformFieldArray = ({
+  name,
+  flat = false,
+  elementInitialValue: _elementInitialValue = null,
+  lastElementNotRemovable = false,
+  disabled,
+  testId: explicitTestId,
+  label
+}) => {
+  const uniformField = useUniformField({
+    name,
+    disabled,
+    testId: explicitTestId,
+    label
+  });
+  const { control } = uniformField;
+  const { fields, append, remove, insert, move } = useRHFFieldArray({
+    control,
+    name
+  });
+  const { trigger, setValue } = useFormContext();
+  const needsInitialize = lastElementNotRemovable && fields.length === 0;
+  const hasInitialized = useRef(!needsInitialize);
+  useEffect(() => {
+    if (needsInitialize) {
+      hasInitialized.current = false;
+    }
+  }, [needsInitialize]);
+  useEffect(() => {
+    if (hasInitialized.current) {
+      setTimeout(() => {
+        trigger(name);
+      }, 200);
+    }
+  }, [fields.length]);
+  const [disableAnimation, setDisableAnimation] = useState(true);
+  const prefersReducedMotion = useReducedMotion();
+  useEffect(() => {
+    if (hasInitialized.current) {
+      setDisableAnimation(!!prefersReducedMotion);
+    }
+  }, [prefersReducedMotion]);
+  const elementInitialValue = useMemo(() => {
+    return flat ? { [flatArrayKey]: _elementInitialValue != null ? _elementInitialValue : null } : _elementInitialValue != null ? _elementInitialValue : {};
+  }, [flat, _elementInitialValue]);
+  useEffect(
+    () => {
+      if (needsInitialize) {
+        if (!disableAnimation) {
+          setDisableAnimation(true);
+        }
+        setValue(name, [elementInitialValue], {
+          shouldDirty: false,
+          shouldTouch: false
+        });
+        hasInitialized.current = true;
+        if (!prefersReducedMotion) {
+          setTimeout(() => {
+            setDisableAnimation(false);
+          }, 1);
+        }
+      }
+    },
+    // Run when needsInitialize changes (initial mount or reset)
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [needsInitialize]
+  );
+  return __spreadValues({
+    // Field array methods and state
+    fields,
+    append,
+    remove,
+    insert,
+    move,
+    disableAnimation,
+    elementInitialValue
+  }, uniformField);
+};
+
+export {
+  useUniformFieldArray
+};
+//# sourceMappingURL=chunk-Z7FVILDT.js.map

package/dist/chunk-Z7FVILDT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { ArrayPath, FieldValues, Path } from 'react-hook-form';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { useFieldArray as useRHFFieldArray } from 'react-hook-form';\n\nimport { useReducedMotion } from '@fuf-stack/pixel-motion';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\nimport { useUniformField } from '../useUniformField/useUniformField';\n\nexport interface UseUniformFieldArrayProps<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** Field name for the array */\n  name: ArrayPath<TFieldValues>;\n  /** Whether this is a flat array (array of primitives) */\n  flat?: boolean;\n  /** Initial value for new array elements */\n  elementInitialValue?: unknown;\n  /** Whether the last element cannot be removed (always maintain at least one element) */\n  lastElementNotRemovable?: boolean;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional label content; pass false to suppress label entirely */\n  label?: ReactNode | false;\n}\n\n/**\n * Enhanced useFieldArray hook with initialization and animation logic.\n * Based on React Hook Form's useFieldArray with additional features:\n * - Automatic initialization when lastElementNotRemovable is set\n * - Animation control (disabled during initialization)\n * - Support for flat arrays (arrays of primitives)\n *\n * Note: Automatic validation triggering on length change is disabled to prevent\n * triggering form-wide validation. Array validation still runs on form submission.\n *\n * @see https://react-hook-form.com/docs/usefieldarray\n */\nexport const useUniformFieldArray = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  name,\n  flat = false,\n  elementInitialValue: _elementInitialValue = null,\n  lastElementNotRemovable = false,\n  disabled,\n  testId: explicitTestId,\n  label,\n}: UseUniformFieldArrayProps<TFieldValues>) => {\n  // Get uniform field state and utilities\n  const uniformField = useUniformField<TFieldValues>({\n    name: name as Path<TFieldValues> & string,\n    disabled,\n    testId: explicitTestId,\n    label,\n  });\n\n  const { control } = uniformField;\n\n  const { fields, append, remove, insert, move } = useRHFFieldArray({\n    control,\n    name,\n  });\n\n  const { trigger, setValue } = useFormContext<TFieldValues>();\n\n  // Determine if initialization is needed (initially or after reset).\n  // This flag automatically handles both scenarios:\n  // - Initial mount: fields.length starts at 0\n  // - Form reset: fields.length becomes 0 again\n  // Additional initialization conditions can be added here later (e.g., minElements > 0)\n  const needsInitialize = lastElementNotRemovable && fields.length === 0;\n\n  // Track whether initialization has completed. Initialized contextually:\n  // - If initialization IS needed (needsInitialize = true): starts as false, set to true after init\n  // - If initialization is NOT needed (needsInitialize = false): starts as true (already initialized)\n  // This ref is used to:\n  // 1. Skip validation during initialization/re-initialization\n  // 2. Gate animation enabling until after initialization\n  // 3. Gate motion preference effect until after initialization\n  const hasInitialized = useRef(!needsInitialize);\n\n  // Reset initialization flag when needsInitialize changes to true.\n  // This handles form reset: when fields become empty (needsInitialize becomes true),\n  // hasInitialized is reset to false, triggering re-initialization in the effect below.\n  useEffect(() => {\n    if (needsInitialize) {\n      hasInitialized.current = false;\n    }\n  }, [needsInitialize]);\n\n  // Validate array-level constraints (min/max items) when length changes.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\n        // Trigger validation so min/max errors appear instantly when user adds/removes items\n        trigger(name as Path<TFieldValues>);\n      }, 200);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [fields.length]);\n\n  // Animation control: Start with animations disabled to prevent animating in initial elements.\n  // Will be enabled after initialization completes (unless user prefers reduced motion).\n  const [disableAnimation, setDisableAnimation] = useState(true);\n\n  // Respond to user's motion preference changes (after initialization).\n  // During initialization, animations stay disabled regardless of preference.\n  const prefersReducedMotion = useReducedMotion();\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setDisableAnimation(!!prefersReducedMotion);\n    }\n  }, [prefersReducedMotion]);\n\n  // Prepare initial element value based on mode\n  // - flat=true: arrays of primitives → object with flatArrayKey and null value by default\n  // - flat=false: arrays of objects → empty object by default\n  const elementInitialValue = useMemo(() => {\n    return flat\n      ? { [flatArrayKey]: _elementInitialValue ?? null }\n      : (_elementInitialValue ?? {});\n  }, [flat, _elementInitialValue]);\n\n  // Initialization/Re-initialization: Add initial element when needed.\n  // This handles both initial mount and form reset scenarios by reacting to needsInitialize.\n  // CRITICAL: This effect MUST be the LAST hook in this component.\n  // It sets hasInitialized.current = true, which acts as a gate for other effects.\n  // If this runs before other effects, hasInitialized will be true during their first run,\n  // causing them to execute logic meant only for post-initialization (e.g., validation,\n  // animation enabling). By placing this last, all other effects run first with\n  // hasInitialized = false, allowing them to skip initialization-phase logic.\n  useEffect(\n    () => {\n      if (needsInitialize) {\n        // Disable animations if they're currently enabled (important for reset scenario).\n        // During initial mount, animations are already disabled, but after a form reset\n        // animations might be enabled, so we need to disable them before adding the element.\n        if (!disableAnimation) {\n          setDisableAnimation(true);\n        }\n\n        // use setValue instead of append to avoid focusing the added element\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        setValue(name as Path<TFieldValues>, [elementInitialValue] as any, {\n          shouldDirty: false,\n          shouldTouch: false,\n        });\n\n        // Mark initialization as complete\n        hasInitialized.current = true;\n\n        // Enable animations after a 1ms delay (unless user prefers reduced motion).\n        // The delay ensures the setValue completes before animations turn on,\n        // preventing the initial element from animating in.\n        if (!prefersReducedMotion) {\n          setTimeout(() => {\n            setDisableAnimation(false);\n          }, 1);\n        }\n      }\n    },\n    // Run when needsInitialize changes (initial mount or reset)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [needsInitialize],\n  );\n\n  return {\n    // Field array methods and state\n    fields,\n    append,\n    remove,\n    insert,\n    move,\n    disableAnimation,\n    elementInitialValue,\n    // Uniform field state and utilities (spread all)\n    ...uniformField,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;AAGA,SAAS,WAAW,SAAS,QAAQ,gBAAgB;AACrD,SAAS,iBAAiB,wBAAwB;AAElD,SAAS,wBAAwB;AAqC1B,IAAM,uBAAuB,CAElC;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,qBAAqB,uBAAuB;AAAA,EAC5C,0BAA0B;AAAA,EAC1B;AAAA,EACA,QAAQ;AAAA,EACR;AACF,MAA+C;AAE7C,QAAM,eAAe,gBAA8B;AAAA,IACjD;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,EACF,CAAC;AAED,QAAM,EAAE,QAAQ,IAAI;AAEpB,QAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,KAAK,IAAI,iBAAiB;AAAA,IAChE;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,EAAE,SAAS,SAAS,IAAI,eAA6B;AAO3D,QAAM,kBAAkB,2BAA2B,OAAO,WAAW;AASrE,QAAM,iBAAiB,OAAO,CAAC,eAAe;AAK9C,YAAU,MAAM;AACd,QAAI,iBAAiB;AACnB,qBAAe,UAAU;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,eAAe,CAAC;AAIpB,YAAU,MAAM;AACd,QAAI,eAAe,SAAS;AAC1B,iBAAW,MAAM;AAEf,gBAAQ,IAA0B;AAAA,MACpC,GAAG,GAAG;AAAA,IACR;AAAA,EAEF,GAAG,CAAC,OAAO,MAAM,CAAC;AAIlB,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,SAAS,IAAI;AAI7D,QAAM,uBAAuB,iBAAiB;AAC9C,YAAU,MAAM;AACd,QAAI,eAAe,SAAS;AAC1B,0BAAoB,CAAC,CAAC,oBAAoB;AAAA,IAC5C;AAAA,EACF,GAAG,CAAC,oBAAoB,CAAC;AAKzB,QAAM,sBAAsB,QAAQ,MAAM;AACxC,WAAO,OACH,EAAE,CAAC,YAAY,GAAG,sDAAwB,KAAK,IAC9C,sDAAwB,CAAC;AAAA,EAChC,GAAG,CAAC,MAAM,oBAAoB,CAAC;AAU/B;AAAA,IACE,MAAM;AACJ,UAAI,iBAAiB;AAInB,YAAI,CAAC,kBAAkB;AACrB,8BAAoB,IAAI;AAAA,QAC1B;AAIA,iBAAS,MAA4B,CAAC,mBAAmB,GAAU;AAAA,UACjE,aAAa;AAAA,UACb,aAAa;AAAA,QACf,CAAC;AAGD,uBAAe,UAAU;AAKzB,YAAI,CAAC,sBAAsB;AACzB,qBAAW,MAAM;AACf,gCAAoB,KAAK;AAAA,UAC3B,GAAG,CAAC;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA;AAAA;AAAA,IAGA,CAAC,eAAe;AAAA,EAClB;AAEA,SAAO;AAAA;AAAA,IAEL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,KAEG;AAEP;","names":[]}

package/dist/{chunk-MLPLWUXZ.js → chunk-Z7NI5347.js}

@@ -1,6 +1,6 @@
 import {
   useUniformField
-} from "./chunk-2K6FWC4H.js";
+} from "./chunk-D3NAUOYG.js";
 import {
   FieldValidationError_default
 } from "./chunk-ELYGQTXB.js";
@@ -178,4 +178,4 @@ export {
   Checkboxes_default,
   Checkboxes_default2
 };
-//# sourceMappingURL=chunk-MLPLWUXZ.js.map
+//# sourceMappingURL=chunk-Z7NI5347.js.map

package/dist/hooks/index.cjs

@@ -1,22 +1,33 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-LTKRK3OS.cjs');
 
 
+var _chunkBZ5OMN4Ycjs = require('../chunk-BZ5OMN4Y.cjs');
 
 
+var _chunk4WYC2RBEcjs = require('../chunk-4WYC2RBE.cjs');
 
 
+var _chunkAACO4OEKcjs = require('../chunk-AACO4OEK.cjs');
 
 
-var _chunk3SZ2UKFAcjs = require('../chunk-3SZ2UKFA.cjs');
-require('../chunk-OE5BOGGX.cjs');
+var _chunkTGJJZEHBcjs = require('../chunk-TGJJZEHB.cjs');
 require('../chunk-NHEZXA4H.cjs');
-require('../chunk-Z353BLWI.cjs');
 
 
-var _chunkBZ5OMN4Ycjs = require('../chunk-BZ5OMN4Y.cjs');
+var _chunkJMFDNTVCcjs = require('../chunk-JMFDNTVC.cjs');
 
 
-var _chunk4WYC2RBEcjs = require('../chunk-4WYC2RBE.cjs');
+var _chunkPCTYJUY7cjs = require('../chunk-PCTYJUY7.cjs');
+require('../chunk-OE5BOGGX.cjs');
+
+
+
+var _chunkTEIXBRF5cjs = require('../chunk-TEIXBRF5.cjs');
+
+
+
+var _chunkNZBO4N3Scjs = require('../chunk-NZBO4N3S.cjs');
+require('../chunk-Z353BLWI.cjs');
 require('../chunk-555JRYCS.cjs');
 
 
@@ -29,5 +40,5 @@ require('../chunk-555JRYCS.cjs');
 
 
 
-exports.checkFieldIsRequired = _chunk3SZ2UKFAcjs.checkFieldIsRequired; exports.clientValidationSchemaByName = _chunk3SZ2UKFAcjs.clientValidationSchemaByName; exports.useClientValidation = _chunk3SZ2UKFAcjs.useClientValidation; exports.useController = _chunk3SZ2UKFAcjs.useController; exports.useFormContext = _chunk3SZ2UKFAcjs.useFormContext; exports.useInput = _chunk3SZ2UKFAcjs.useInput; exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce; exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform; exports.useUniformField = _chunk3SZ2UKFAcjs.useUniformField; exports.useUniformFieldArray = _chunk3SZ2UKFAcjs.useUniformFieldArray;
+exports.checkFieldIsRequired = _chunkNZBO4N3Scjs.checkFieldIsRequired; exports.clientValidationSchemaByName = _chunkTEIXBRF5cjs.clientValidationSchemaByName; exports.useClientValidation = _chunkTEIXBRF5cjs.useClientValidation; exports.useController = _chunkJMFDNTVCcjs.useController; exports.useFormContext = _chunkNZBO4N3Scjs.useFormContext; exports.useInput = _chunkPCTYJUY7cjs.useInput; exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce; exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform; exports.useUniformField = _chunkTGJJZEHBcjs.useUniformField; exports.useUniformFieldArray = _chunkAACO4OEKcjs.useUniformFieldArray;
 //# 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;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;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;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"}

package/dist/hooks/index.d.cts

@@ -1,290 +1,13 @@
-import * as _fuf_stack_veto_dist_types_d_CNPgNK_V from '@fuf-stack/veto/dist/types.d-CNPgNK-V';
-import * as _fuf_stack_veto from '@fuf-stack/veto';
-import { VetoTypeAny, VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
-import * as react_hook_form from 'react-hook-form';
-import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState, FieldValues, Path, FieldError, ArrayPath } from 'react-hook-form';
-import * as _heroui_input from '@heroui/input';
-import { useInput } from '@heroui/input';
+export { clientValidationSchemaByName, useClientValidation } from './useClientValidation/index.cjs';
+export { UseControllerProps, UseControllerReturn, useController } from './useController/index.cjs';
+export { UseUniformFieldArrayProps, useUniformFieldArray } from './useUniformFieldArray/index.cjs';
+export { checkFieldIsRequired, useFormContext } from './useFormContext/index.cjs';
 export { useInput } from '@heroui/input';
-import * as React from 'react';
-import { ReactNode } from 'react';
-import { D as DebugModeSettings } from '../FormContext-LRho0tno.cjs';
 export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce } from './useInputValueDebounce/index.cjs';
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform } from './useInputValueTransform/index.cjs';
-
-/**
- * Hook for adding dynamic client-side validation to forms.
- *
- * Automatically manages validation schema lifecycle: sets schema when data is provided,
- * clears schema when data is null/undefined, and cleans up on unmount.
- *
- * When the client validation schema changes, automatically re-validates all touched
- * fields to ensure they are validated against the new schema.
- *
- * @param data - Data to create validation schema from (or null/undefined to clear validation)
- * @param schemaFactory - Function that creates a validation schema from the data.
- *
- * @example
- * ```tsx
- * const { data: teamData } = useTeamQuery(teamId);
- *
- * useClientValidation(teamData, (data) =>
- *   vt.object({
- *     username: vt.string().refine(
- *       (value) => !data.existingUsers.includes(value),
- *       { message: 'Username already exists' }
- *     )
- *   })
- * );
- * ```
- */
-declare const useClientValidation: <TData = unknown>(data: TData | null | undefined, schemaFactory: (data: TData) => VetoTypeAny) => void;
-/**
- * Helper function to create a veto looseObject schema for a single field with nested path support.
- *
- * Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.
- * All intermediate objects and arrays are marked as optional to allow partial data structures.
- * Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.
- *
- * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name')
- * @param fieldSchema - The veto validation schema for the field
- * @returns A nested loose object schema matching the field path structure with proper type inference
- *
- * @example
- * ```tsx
- * // Simple field
- * clientValidationSchemaByName('username', vt.string())
- * // => objectLoose({ username: vt.string() })
- * ```
- *
- * @example
- * ```tsx
- * // Nested field (with optional intermediate objects)
- * clientValidationSchemaByName('user.profile.email', vt.string().email())
- * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: vt.string().email() }).optional() }).optional() })
- * ```
- *
- * @example
- * ```tsx
- * // Array field (with optional array)
- * clientValidationSchemaByName('items.0.name', vt.string())
- * // => objectLoose({ items: array(objectLoose({ name: vt.string() })).optional() })
- * ```
- *
- * @example
- * ```tsx
- * // Usage with useClientValidation
- * const { data: userData } = useUserQuery(userId);
- *
- * useClientValidation(userData, (data) =>
- *   clientValidationSchemaByName('username', vt.string().refine(
- *     (value) => !data.existingUsernames.includes(value),
- *     { message: 'Username already taken' }
- *   ))
- * );
- * ```
- */
-declare const clientValidationSchemaByName: <T extends VetoTypeAny>(name: string, fieldSchema: T) => _fuf_stack_veto_dist_types_d_CNPgNK_V.Z;
-
-type UseControllerProps<TFieldValues extends object = object> = UseControllerProps$1<TFieldValues>;
-interface UseControllerReturn<TFieldValues extends object = object> {
-    field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {
-        onChange: (...event: any[]) => void;
-        value: string;
-    };
-    formState: UseFormStateReturn<TFieldValues>;
-    fieldState: ControllerFieldState;
-}
-/**
- * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.
- *
- * Key features:
- * 1. Empty strings ('') in the UI are stored as null in form state
- * 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
- *
- * This enables consistent handling of empty/null values while keeping a clean API
- * for form inputs that expect string values.
- *
- * @see https://react-hook-form.com/docs/usecontroller
- */
-declare const useController: <TFieldValues extends object = object>(props: UseControllerProps<TFieldValues>) => UseControllerReturn<TFieldValues>;
-
-/** Schema check whether a field is required or optional */
-declare const checkFieldIsRequired: (validation: VetoInstance, path: string[]) => boolean;
-/**
- * Custom hook that extends react-hook-form's useFormContext to add validation and state management.
- */
-declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>() => {
-    formState: react_hook_form.FormState<TFieldValues>;
-    getFieldState: (name: Path<TFieldValues>, testId?: string) => {
-        error: FieldError[] | undefined;
-        invalid: boolean;
-        required: boolean;
-        testId: string;
-        isDirty: boolean;
-        isTouched: boolean;
-        isValidating: boolean;
-    };
-    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
-    subscribe: react_hook_form.UseFromSubscribe<TFieldValues>;
-    watch: react_hook_form.UseFormWatch<TFieldValues>;
-    debugMode: "debug" | "debug-testids" | "off" | "disabled";
-    debugModeSettings?: DebugModeSettings;
-    preventSubmit: (prevent: boolean) => void;
-    setDebugMode: (debugMode: "debug" | "debug-testids" | "off" | "disabled") => void;
-    triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
-    validation: {
-        instance?: VetoInstance;
-        errors?: VetoFormattedError;
-        setClientValidationSchema: (key: string, schema: _fuf_stack_veto.VetoTypeAny | null) => void;
-    };
-    setError: react_hook_form.UseFormSetError<TFieldValues>;
-    clearErrors: react_hook_form.UseFormClearErrors<TFieldValues>;
-    setValue: react_hook_form.UseFormSetValue<TFieldValues>;
-    trigger: react_hook_form.UseFormTrigger<TFieldValues>;
-    resetField: react_hook_form.UseFormResetField<TFieldValues>;
-    reset: react_hook_form.UseFormReset<TFieldValues>;
-    handleSubmit: react_hook_form.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
-    unregister: react_hook_form.UseFormUnregister<TFieldValues>;
-    control: react_hook_form.Control<TFieldValues, TContext, TTransformedValues>;
-    register: react_hook_form.UseFormRegister<TFieldValues>;
-    setFocus: react_hook_form.UseFormSetFocus<TFieldValues>;
-};
-
-interface UseUniformFieldArrayProps<TFieldValues extends FieldValues = FieldValues> {
-    /** Field name for the array */
-    name: ArrayPath<TFieldValues>;
-    /** Whether this is a flat array (array of primitives) */
-    flat?: boolean;
-    /** Initial value for new array elements */
-    elementInitialValue?: unknown;
-    /** Whether the last element cannot be removed (always maintain at least one element) */
-    lastElementNotRemovable?: boolean;
-    /** Disable the field */
-    disabled?: boolean;
-    /** Optional explicit test id used to build stable test ids */
-    testId?: string;
-    /** Optional label content; pass false to suppress label entirely */
-    label?: ReactNode | false;
-}
-/**
- * Enhanced useFieldArray hook with initialization and animation logic.
- * Based on React Hook Form's useFieldArray with additional features:
- * - Automatic initialization when lastElementNotRemovable is set
- * - Animation control (disabled during initialization)
- * - Support for flat arrays (arrays of primitives)
- *
- * Note: Automatic validation triggering on length change is disabled to prevent
- * triggering form-wide validation. Array validation still runs on form submission.
- *
- * @see https://react-hook-form.com/docs/usefieldarray
- */
-declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({ name, flat, elementInitialValue: _elementInitialValue, lastElementNotRemovable, disabled, testId: explicitTestId, label, }: UseUniformFieldArrayProps<TFieldValues>) => {
-    control: react_hook_form.Control<TFieldValues, any, TFieldValues>;
-    debugMode: ReturnType<typeof useFormContext<TFieldValues_1>>["debugMode"];
-    defaultValue: unknown;
-    disabled: boolean | undefined;
-    error: react_hook_form.FieldError[] | undefined;
-    errorMessage: ReactNode | null;
-    field: Omit<react_hook_form.ControllerRenderProps<TFieldValues>, "value" | "onChange"> & {
-        onChange: (... /** Initial value for new array elements */event: any[]) => void;
-        value: string;
-    };
-    getErrorMessageProps: ReturnType<typeof _heroui_input.useInput>["getErrorMessageProps"];
-    getHelperWrapperProps: ReturnType<typeof _heroui_input.useInput>["getHelperWrapperProps"];
-    getLabelProps: ReturnType<typeof _heroui_input.useInput>["getLabelProps"];
-    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
-    invalid: boolean;
-    label: ReactNode | null;
-    onBlur: ReturnType<typeof useController>["field"]["onBlur"];
-    onChange: ReturnType<typeof useController>["field"]["onChange"];
-    ref: ReturnType<typeof useController>["field"]["ref"];
-    required: boolean;
-    resetField: react_hook_form.UseFormResetField<TFieldValues>;
-    testId: string;
-    fields: react_hook_form.FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
-    append: react_hook_form.UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
-    remove: react_hook_form.UseFieldArrayRemove;
-    insert: react_hook_form.UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
-    move: react_hook_form.UseFieldArrayMove;
-    disableAnimation: boolean;
-    elementInitialValue: {};
-};
-
-interface UseUniformFieldParams<TFieldValues extends FieldValues = FieldValues> {
-    /** Form field name */
-    name: Path<TFieldValues> & string;
-    /** Disable the field */
-    disabled?: boolean;
-    /** Optional explicit test id used to build stable test ids */
-    testId?: string;
-    /** Optional label content; pass false to suppress label entirely */
-    label?: ReactNode | false;
-}
-interface UseUniformFieldReturn<TFieldValues extends FieldValues = FieldValues> {
-    /** react-hook-form control instance for advanced integrations */
-    control: ReturnType<typeof useFormContext<TFieldValues>>['control'];
-    /** Debug mode from Uniform provider */
-    debugMode: ReturnType<typeof useFormContext<TFieldValues>>['debugMode'];
-    /** Current value used to initialize uncontrolled components */
-    defaultValue: unknown;
-    /** Whether the field is currently disabled (from RHF) */
-    disabled: boolean | undefined;
-    /** Validation error(s) for the field */
-    error: FieldError[] | undefined;
-    /** Pre-built errorMessage node to plug into components */
-    errorMessage: ReactNode | null;
-    /** RHF controller field with nullish conversions applied */
-    field: ReturnType<typeof useController<TFieldValues>>['field'];
-    /** Helper to spread standardized error message props to underlying components */
-    getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];
-    /** Helper to spread standardized helper wrapper props (for spacing/animation) */
-    getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];
-    /** Helper to spread standardized label props to underlying components */
-    getLabelProps: ReturnType<typeof useInput>['getLabelProps'];
-    /** Access current form values (converted to validation-friendly format) */
-    getValues: ReturnType<typeof useFormContext<TFieldValues>>['getValues'];
-    /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */
-    invalid: boolean;
-    /** Computed label node including optional test id copy button */
-    label: ReactNode | null;
-    /** onBlur handler from controller */
-    onBlur: ReturnType<typeof useController<TFieldValues>>['field']['onBlur'];
-    /** onChange handler from controller (with nullish handling) */
-    onChange: ReturnType<typeof useController<TFieldValues>>['field']['onChange'];
-    /** Ref to forward to underlying control */
-    ref: ReturnType<typeof useController<TFieldValues>>['field']['ref'];
-    /** Whether the field is required according to validation schema */
-    required: boolean;
-    /** Reset a specific field in the form */
-    resetField: ReturnType<typeof useFormContext<TFieldValues>>['resetField'];
-    /** Generated HTML data-testid for the field */
-    testId: string;
-}
-/**
- * Combines frequently used form field logic into a single hook.
- *
- * Provides:
- * - Enhanced form context (validation-aware state, `testId`, value transforms)
- * - Controller field with nullish conversion handling
- * - Debounced `invalid` state with smart timing:
- *   • `true` (field becomes invalid): applies immediately so errors show right away
- *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations
- *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion
- * - Smart `invalid` visibility (via `showInvalid`):
- *   • Shows errors when field is dirty OR touched OR form has been submitted
- *   • Prevents showing errors on pristine/untouched fields for better UX
- *   • Works well for all field types (text inputs, checkboxes, radios, arrays)
- * - Prebuilt `errorMessage` React node using `FieldValidationError`
- * - Computed `label` node which appends a `FieldCopyTestIdButton` in
- *   `debug-testids` mode
- * - `defaultValue` for uncontrolled defaults and all usual field handlers
- * - Access to form utilities: `control`, `getValues`, `resetField`
- * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,
- *   `getHelperWrapperProps` for consistent wiring to underlying UI components
- */
-declare function useUniformField<TFieldValues extends FieldValues = FieldValues>(params: UseUniformFieldParams<TFieldValues>): UseUniformFieldReturn<TFieldValues>;
-
-export { type UseControllerProps, type UseControllerReturn, type UseUniformFieldArrayProps, type UseUniformFieldParams, type UseUniformFieldReturn, checkFieldIsRequired, clientValidationSchemaByName, useClientValidation, useController, useFormContext, useUniformField, useUniformFieldArray };
+export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField } from './useUniformField/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';