@fuf-stack/uniform 1.10.4 → 1.11.0

package/dist/chunk-CNTOODUQ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/useInputValueTransform/useInputValueTransform.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nexport interface InputValueTransform<TDisplay = unknown> {\n  /** Transforms the form value to display value (e.g., 1000 → \"$1,000\" or 'a' → ['a']) */\n  toDisplayValue: (value: unknown) => TDisplay;\n  /** Transforms the display value to form value (e.g., \"$1,000\" → 1000 or ['a'] → 'a') */\n  toFormValue: (value: TDisplay) => unknown;\n}\n\nexport interface UseInputValueTransformOptions<TDisplay = unknown> {\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n  /** Value transformation functions */\n  transform?: InputValueTransform<TDisplay>;\n}\n\nexport interface UseInputValueTransformReturn<TDisplay = unknown> {\n  /** Converts any form value to display value */\n  toDisplayValue: (formValue: unknown) => TDisplay;\n  /** Converts any display value to form value */\n  toFormValue: (displayValue: TDisplay) => unknown;\n}\n\n/**\n * Custom hook providing utility functions for value transformations between display and form values.\n *\n * This hook provides pure conversion functions without any state management. It's useful for:\n * - Currency formatting ($1,000 display vs 1000 stored)\n * - Number inputs with special handling\n * - Date formatting (MM/DD/YYYY display vs ISO date stored)\n * - Phone number formatting ((555) 123-4567 display vs 5551234567 stored)\n * - Array/Object transformations (single value ↔ array, nested structures)\n *\n * **Key Features:**\n * - Pure conversion functions (no state)\n * - Generic support for any data type (strings, numbers, arrays, objects)\n * - Special number input handling (empty string preservation)\n * - Bidirectional value transformations\n * - Memoized functions for performance\n *\n * @param options Configuration for value transformation\n * @returns Pure conversion utility functions\n *\n * @example\n * ```tsx\n * // Currency formatting\n * const currencyTransform = {\n *   toDisplayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',\n *   toFormValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: currencyTransform\n * });\n *\n * const displayVal = toDisplayValue(1000); // \"$1,000\"\n * const formVal = toFormValue(\"$1,500\"); // 1500\n * ```\n *\n * @example\n * ```tsx\n * // Number input (no transforms needed)\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   type: 'number'\n * });\n *\n * // Handles empty string → empty string (not NaN)\n * // Handles \"123\" → 123 (string to number conversion)\n * ```\n *\n * @example\n * ```tsx\n * // Array to single value (for single checkbox)\n * const singleValueTransform = {\n *   toDisplayValue: (val: string[]) => val?.[0] || '',\n *   toFormValue: (val: string) => val ? [val] : []\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: singleValueTransform\n * });\n *\n * const displayVal = toDisplayValue(['option1']); // \"option1\"\n * const formVal = toFormValue(\"option2\"); // [\"option2\"]\n * ```\n *\n * @example\n * ```tsx\n * // Integration with debouncing\n * const MyInput = ({ field, transform }) => {\n *   const transform = useInputValueTransform({ transform });\n *\n *   const { onChange, onBlur, value } = useInputValueDebounce({\n *     ...transform,\n *     initialValue: field.value,\n *     debounceDelay: 300,\n *     onBlur: field.onBlur,\n *     onChange: field.onChange,\n *   });\n *\n *   return <input value={value} onChange={onChange} onBlur={onBlur} />;\n * };\n * ```\n */\nexport const useInputValueTransform = <TDisplay = unknown>({\n  type,\n  transform,\n}: UseInputValueTransformOptions<TDisplay>): UseInputValueTransformReturn<TDisplay> => {\n  /**\n   * Converts any form value to display value\n   */\n  const toDisplayValue = useCallback(\n    (formValue: unknown): TDisplay => {\n      if (transform?.toDisplayValue) {\n        return transform.toDisplayValue(formValue);\n      }\n\n      // For number type, convert valid strings to numbers for display\n      if (type === 'number') {\n        if (formValue === '') {\n          return '' as TDisplay;\n        }\n        const numValue = Number(formValue);\n        return (Number.isNaN(numValue) ? formValue : numValue) as TDisplay;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return (formValue ?? '') as TDisplay;\n    },\n    [type, transform],\n  );\n\n  /**\n   * Converts any display value to form value\n   */\n  const toFormValue = useCallback(\n    (displayValue: TDisplay): unknown => {\n      if (transform?.toFormValue) {\n        return transform.toFormValue(displayValue);\n      }\n\n      // For number type, convert strings to numbers\n      if (type === 'number') {\n        if (displayValue === '') {\n          return '';\n        }\n        const numValue = Number(displayValue);\n        return Number.isNaN(numValue) ? displayValue : numValue;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return displayValue;\n    },\n    [type, transform],\n  );\n\n  return {\n    toDisplayValue,\n    toFormValue,\n  };\n};\n"],"mappings":";AAAA,SAAS,mBAAmB;AAwGrB,IAAM,yBAAyB,CAAqB;AAAA,EACzD;AAAA,EACA;AACF,MAAuF;AAIrF,QAAM,iBAAiB;AAAA,IACrB,CAAC,cAAiC;AAChC,UAAI,uCAAW,gBAAgB;AAC7B,eAAO,UAAU,eAAe,SAAS;AAAA,MAC3C;AAGA,UAAI,SAAS,UAAU;AACrB,YAAI,cAAc,IAAI;AACpB,iBAAO;AAAA,QACT;AACA,cAAM,WAAW,OAAO,SAAS;AACjC,eAAQ,OAAO,MAAM,QAAQ,IAAI,YAAY;AAAA,MAC/C;AAGA,aAAQ,gCAAa;AAAA,IACvB;AAAA,IACA,CAAC,MAAM,SAAS;AAAA,EAClB;AAKA,QAAM,cAAc;AAAA,IAClB,CAAC,iBAAoC;AACnC,UAAI,uCAAW,aAAa;AAC1B,eAAO,UAAU,YAAY,YAAY;AAAA,MAC3C;AAGA,UAAI,SAAS,UAAU;AACrB,YAAI,iBAAiB,IAAI;AACvB,iBAAO;AAAA,QACT;AACA,cAAM,WAAW,OAAO,YAAY;AACpC,eAAO,OAAO,MAAM,QAAQ,IAAI,eAAe;AAAA,MACjD;AAGA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,MAAM,SAAS;AAAA,EAClB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-ELYGQTXB.js

@@ -1,47 +0,0 @@
-// src/partials/FieldValidationError/FieldValidationError.tsx
-import {
-  AnimatePresence,
-  motion,
-  useReducedMotion
-} from "@fuf-stack/pixel-motion";
-import { slugify } from "@fuf-stack/pixel-utils";
-import { jsx } from "react/jsx-runtime";
-var FieldValidationError = ({
-  className = void 0,
-  error = void 0,
-  testId
-}) => {
-  const disableAnimation = useReducedMotion();
-  return /* @__PURE__ */ jsx(
-    "ul",
-    {
-      "aria-label": `Validation errors of field ${testId}`,
-      className,
-      "data-testid": slugify(`${testId}_error`),
-      children: /* @__PURE__ */ jsx(AnimatePresence, { initial: !disableAnimation, children: error == null ? void 0 : error.map(({ message }, i) => {
-        return /* @__PURE__ */ jsx(
-          motion.li,
-          {
-            exit: disableAnimation ? void 0 : { opacity: 0, height: 0 },
-            initial: disableAnimation ? false : { height: 0, opacity: 0 },
-            style: { overflow: "hidden" },
-            transition: { duration: 0.2, ease: "circOut" },
-            animate: disableAnimation ? void 0 : { opacity: 1, height: "auto" },
-            children: /* @__PURE__ */ jsx("div", { className: "px-1 pt-1", children: message })
-          },
-          slugify(`${testId}_error_${i}`)
-        );
-      }) })
-    }
-  );
-};
-var FieldValidationError_default = FieldValidationError;
-
-// src/partials/FieldValidationError/index.ts
-var FieldValidationError_default2 = FieldValidationError_default;
-
-export {
-  FieldValidationError_default,
-  FieldValidationError_default2
-};
-//# sourceMappingURL=chunk-ELYGQTXB.js.map

package/dist/chunk-ELYGQTXB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/partials/FieldValidationError/FieldValidationError.tsx","../src/partials/FieldValidationError/index.ts"],"sourcesContent":["import type { FieldError } from 'react-hook-form';\n\nimport {\n  AnimatePresence,\n  motion,\n  useReducedMotion,\n} from '@fuf-stack/pixel-motion';\nimport { slugify } from '@fuf-stack/pixel-utils';\n\nexport interface FieldValidationErrorProps {\n  /** CSS class name */\n  className?: string;\n  /** Field errors */\n  error?: FieldError[];\n  /** HTML data-testid attribute used in e2e tests */\n  testId: string;\n}\n\n/**\n * Renders a validation error of a field\n */\nconst FieldValidationError = ({\n  className = undefined,\n  error = undefined,\n  testId,\n}: FieldValidationErrorProps) => {\n  // disable all animation if user prefers reduced motion\n  const disableAnimation = useReducedMotion();\n\n  return (\n    <ul\n      aria-label={`Validation errors of field ${testId}`}\n      className={className}\n      data-testid={slugify(`${testId}_error`)}\n    >\n      <AnimatePresence initial={!disableAnimation}>\n        {error?.map(({ message }, i) => {\n          return (\n            <motion.li\n              key={slugify(`${testId}_error_${i}`)}\n              exit={disableAnimation ? undefined : { opacity: 0, height: 0 }}\n              initial={disableAnimation ? false : { height: 0, opacity: 0 }}\n              style={{ overflow: 'hidden' }}\n              transition={{ duration: 0.2, ease: 'circOut' }}\n              animate={\n                disableAnimation ? undefined : { opacity: 1, height: 'auto' }\n              }\n            >\n              {/* wrap in div to apply padding and animation does not jump */}\n              <div className=\"px-1 pt-1\">{message}</div>\n            </motion.li>\n          );\n        })}\n      </AnimatePresence>\n    </ul>\n  );\n};\n\nexport default FieldValidationError;\n","import FieldValidationError from './FieldValidationError';\n\nexport type { FieldValidationErrorProps } from './FieldValidationError';\n\nexport { FieldValidationError };\n\nexport default FieldValidationError;\n"],"mappings":";AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe;AA0CV;AA5Bd,IAAM,uBAAuB,CAAC;AAAA,EAC5B,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR;AACF,MAAiC;AAE/B,QAAM,mBAAmB,iBAAiB;AAE1C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,8BAA8B,MAAM;AAAA,MAChD;AAAA,MACA,eAAa,QAAQ,GAAG,MAAM,QAAQ;AAAA,MAEtC,8BAAC,mBAAgB,SAAS,CAAC,kBACxB,yCAAO,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM;AAC9B,eACE;AAAA,UAAC,OAAO;AAAA,UAAP;AAAA,YAEC,MAAM,mBAAmB,SAAY,EAAE,SAAS,GAAG,QAAQ,EAAE;AAAA,YAC7D,SAAS,mBAAmB,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE;AAAA,YAC5D,OAAO,EAAE,UAAU,SAAS;AAAA,YAC5B,YAAY,EAAE,UAAU,KAAK,MAAM,UAAU;AAAA,YAC7C,SACE,mBAAmB,SAAY,EAAE,SAAS,GAAG,QAAQ,OAAO;AAAA,YAI9D,8BAAC,SAAI,WAAU,aAAa,mBAAQ;AAAA;AAAA,UAV/B,QAAQ,GAAG,MAAM,UAAU,CAAC,EAAE;AAAA,QAWrC;AAAA,MAEJ,IACF;AAAA;AAAA,EACF;AAEJ;AAEA,IAAO,+BAAQ;;;ACpDf,IAAOA,gCAAQ;","names":["FieldValidationError_default"]}

package/dist/chunk-FBCGU6V6.js

@@ -1,150 +0,0 @@
-import {
-  useInputValueDebounce
-} from "./chunk-LEMQGDFE.js";
-import {
-  useUniformField
-} from "./chunk-GEC75GNL.js";
-import {
-  __objRest,
-  __spreadProps,
-  __spreadValues
-} from "./chunk-K2V4ULA2.js";
-
-// src/Input/Input.tsx
-import { Input as HeroInput } from "@heroui/input";
-import { NumberInput as HeroNumberInput } from "@heroui/number-input";
-import { tv, variantsToClassNames } from "@fuf-stack/pixel-utils";
-import { jsx } from "react/jsx-runtime";
-var inputVariants = tv({
-  slots: {
-    /** wrapper around the whole input */
-    base: "",
-    /** clear button */
-    clearButton: "",
-    /** actual input element */
-    input: "",
-    /** inner wrapper (HeroUI inputWrapper slot) */
-    inputWrapper: "bg-content1 group-data-[focus=true]:border-focus"
-  }
-});
-var Input = (_a) => {
-  var _b = _a, {
-    className: _className = void 0,
-    clearable = false,
-    debounceDelay = 300,
-    endContent = void 0,
-    name,
-    onClear = void 0,
-    placeholder = " ",
-    size = void 0,
-    startContent = void 0,
-    type = void 0
-  } = _b, uniformFieldProps = __objRest(_b, [
-    "className",
-    "clearable",
-    "debounceDelay",
-    "endContent",
-    "name",
-    "onClear",
-    "placeholder",
-    "size",
-    "startContent",
-    "type"
-  ]);
-  const {
-    ariaLabel,
-    disabled,
-    field: {
-      onChange: fieldOnChange,
-      onBlur: fieldOnBlur,
-      value: fieldValue,
-      ref
-    },
-    errorMessage,
-    invalid,
-    label,
-    required,
-    testId,
-    resetField
-  } = useUniformField(__spreadValues({ name, type }, uniformFieldProps));
-  const { onChange, onBlur, value } = useInputValueDebounce({
-    debounceDelay,
-    onBlur: fieldOnBlur,
-    onChange: fieldOnChange,
-    value: fieldValue
-  });
-  const clearableProps = clearable ? {
-    isClearable: true,
-    onClear: () => {
-      resetField(name, { defaultValue: null });
-      if (onClear) {
-        onClear();
-      }
-    }
-  } : {};
-  const variants = inputVariants();
-  const classNames = variantsToClassNames(variants, _className, "base");
-  const commonProps = __spreadValues({
-    ref,
-    // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)
-    "aria-label": !placeholder || placeholder.trim() === "" ? ariaLabel : void 0,
-    // disable autocomplete
-    autoComplete: "off",
-    classNames: {
-      base: classNames.base,
-      clearButton: classNames.clearButton,
-      // set padding to 0 for error message exit animation
-      helperWrapper: "p-0",
-      input: classNames.input,
-      inputWrapper: classNames.inputWrapper
-    },
-    "data-testid": testId,
-    endContent,
-    errorMessage,
-    id: testId,
-    isDisabled: disabled,
-    isInvalid: invalid,
-    isRequired: required,
-    label,
-    labelPlacement: "outside",
-    name,
-    onBlur,
-    placeholder,
-    radius: "sm",
-    size,
-    startContent,
-    variant: "bordered"
-  }, clearableProps);
-  if (type === "number") {
-    const numberValue = value !== "" && value != null && !Number.isNaN(Number(value)) ? Number(value) : null;
-    return /* @__PURE__ */ jsx(
-      HeroNumberInput,
-      __spreadProps(__spreadValues({}, commonProps), {
-        value: numberValue,
-        formatOptions: {
-          useGrouping: false
-        },
-        onChange: (e) => {
-          if (typeof e === "number") {
-            onChange({
-              target: { value: String(e) }
-            });
-          } else {
-            onChange(e);
-          }
-        }
-      })
-    );
-  }
-  return /* @__PURE__ */ jsx(HeroInput, __spreadProps(__spreadValues({}, commonProps), { onChange, type, value }));
-};
-var Input_default = Input;
-
-// src/Input/index.ts
-var Input_default2 = Input_default;
-
-export {
-  Input_default,
-  Input_default2
-};
-//# sourceMappingURL=chunk-FBCGU6V6.js.map

package/dist/chunk-FBCGU6V6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/Input/Input.tsx","../src/Input/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { InputProps as HeroInputProps } from '@heroui/input';\nimport type { ReactNode } from 'react';\nimport type { InputValueTransform } from '../hooks/useInputValueTransform';\n\nimport { Input as HeroInput } from '@heroui/input';\nimport { NumberInput as HeroNumberInput } from '@heroui/number-input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce } from '../hooks/useInputValueDebounce';\nimport { useUniformField } from '../hooks/useUniformField';\n\n// input variants\nexport const inputVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof inputVariants>;\ntype ClassName = TVClassName<typeof inputVariants>;\n\nexport interface InputProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** CSS class name */\n  className?: ClassName;\n  /** shows clear button when input has value */\n  clearable?: boolean;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** input field is disabled */\n  disabled?: boolean;\n  /** added content to the end of the input Field. */\n  endContent?: ReactNode;\n  /** form field label */\n  label?: ReactNode;\n  /** form field name */\n  name: string;\n  /** callback that is fired when the value is cleared */\n  onClear?: () => void;\n  /** form field placeholder */\n  placeholder?: string;\n  /** size of the input */\n  size?: 'sm' | 'md' | 'lg';\n  /** content added to the start of the input field */\n  startContent?: ReactNode;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** allows disentangled display and form values for a field */\n  transform?: InputValueTransform<string>;\n  /** input type */\n  type?: 'number' | 'password';\n}\n\n/**\n * Input component based on [HeroUI Input](https://www.heroui.com//docs/components/input)\n */\nconst Input = ({\n  className: _className = undefined,\n  clearable = false,\n  debounceDelay = 300,\n  endContent = undefined,\n  name,\n  onClear = undefined,\n  placeholder = ' ',\n  size = undefined,\n  startContent = undefined,\n  type = undefined,\n  ...uniformFieldProps\n}: InputProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    errorMessage,\n    invalid,\n    label,\n    required,\n    testId,\n    resetField,\n  } = useUniformField({ name, type, ...uniformFieldProps });\n\n  // Use hook that provides debounced onChange and enhanced blur handling\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // If input is clearable add props for clearing input value\n  const clearableProps: Pick<HeroInputProps, 'isClearable' | 'onClear'> =\n    clearable\n      ? {\n          isClearable: true,\n          onClear: () => {\n            // if field had initial value we do not reset it\n            // to that value, but clear it instead\n            resetField(name, { defaultValue: null });\n            // if onClear cb provided we call it\n            if (onClear) {\n              onClear();\n            }\n          },\n        }\n      : {};\n\n  // classNames from slots\n  const variants = inputVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  // Common props for both Input and NumberInput\n  const commonProps = {\n    ref,\n    // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)\n    'aria-label':\n      !placeholder || placeholder.trim() === '' ? ariaLabel : undefined,\n    // disable autocomplete\n    autoComplete: 'off',\n    classNames: {\n      base: classNames.base,\n      clearButton: classNames.clearButton,\n      // set padding to 0 for error message exit animation\n      helperWrapper: 'p-0',\n      input: classNames.input,\n      inputWrapper: classNames.inputWrapper,\n    },\n    'data-testid': testId,\n    endContent,\n    errorMessage,\n    id: testId,\n    isDisabled: disabled,\n    isInvalid: invalid,\n    isRequired: required,\n    label,\n    labelPlacement: 'outside' as const,\n    name,\n    onBlur,\n    placeholder,\n    radius: 'sm' as const,\n    size,\n    startContent,\n    variant: 'bordered' as const,\n    ...clearableProps,\n  };\n\n  // Render NumberInput for number type\n  if (type === 'number') {\n    // Parse the string value to number - use null for empty/cleared state to keep component controlled\n    const numberValue =\n      value !== '' && value != null && !Number.isNaN(Number(value))\n        ? Number(value)\n        : null;\n\n    return (\n      <HeroNumberInput\n        {...commonProps}\n        // @ts-expect-error - HeroUI NumberInput type is not compatible with null,\n        // but it needs to be for empty/cleared state to be controlled\n        value={numberValue}\n        // Disable thousands separator to avoid parsing issues\n        formatOptions={{\n          useGrouping: false,\n        }}\n        // NumberInput onChange receives either an event or a number\n        onChange={(e: React.ChangeEvent<HTMLInputElement> | number) => {\n          if (typeof e === 'number') {\n            // Convert number to synthetic event and pass through debounced onChange\n            onChange({\n              target: { value: String(e) },\n            } as React.ChangeEvent<HTMLInputElement>);\n          } else {\n            // Pass event through debounced onChange\n            onChange(e);\n          }\n        }}\n      />\n    );\n  }\n\n  // Render regular Input for text/password\n  return (\n    <HeroInput {...commonProps} onChange={onChange} type={type} value={value} />\n  );\n};\n\nexport default Input;\n","import Input from './Input';\n\nexport type { InputProps } from './Input';\n\nexport { Input };\n\nexport default Input;\n"],"mappings":"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","names":["Input_default"]}

package/dist/chunk-FYN7ZWLW.cjs

@@ -1,115 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkAQJLKHAEcjs = require('./chunk-AQJLKHAE.cjs');
-
-
-
-
-var _chunkOKJWLH7Tcjs = require('./chunk-OKJWLH7T.cjs');
-
-
-
-
-var _chunk555JRYCScjs = require('./chunk-555JRYCS.cjs');
-
-// src/hooks/useFormContext/useFormContext.ts
-var _react = require('react');
-var _reacthookform = require('react-hook-form');
-var checkFieldIsRequired = (validation, path) => {
-  const checkPath = path[path.length - 1] === _chunkOKJWLH7Tcjs.flatArrayKey ? path.slice(0, -1) : path;
-  const checkRequired = (schema) => {
-    if (schema.type === "array") {
-      if (schema.isOptional || schema.isNullable) {
-        return false;
-      }
-      return true;
-    }
-    return !schema.isOptional && !schema.isNullable;
-  };
-  return validation.checkSchemaPath(checkRequired, checkPath);
-};
-var getValidationErrorsByName = (errors, name) => {
-  const keys = name.split(".").filter((k) => {
-    return k !== _chunkOKJWLH7Tcjs.flatArrayKey;
-  });
-  let current = errors;
-  keys.forEach((key) => {
-    if (current && typeof current === "object") {
-      current = current[key];
-    } else {
-      current = void 0;
-    }
-  });
-  return current;
-};
-var useFormContext = () => {
-  const _a = _reacthookform.useFormContext.call(void 0, ), {
-    formState,
-    getFieldState: getFieldStateOrig,
-    getValues: getValuesOrig,
-    watch: watchOrig,
-    subscribe: subscribeOrig
-  } = _a, otherMethods = _chunk555JRYCScjs.__objRest.call(void 0, _a, [
-    "formState",
-    // some methods that will be enhanced below
-    "getFieldState",
-    "getValues",
-    "watch",
-    "subscribe"
-  ]);
-  const uniformContext = _react.useContext.call(void 0, _chunkAQJLKHAEcjs.UniformContext);
-  const getFieldState = (name, testId) => {
-    var _a2, _b;
-    const fieldPath = typeof name === "string" ? name.replace(/\[\d+\]/g, "").split(".") : name;
-    const validationInstance = (_a2 = uniformContext == null ? void 0 : uniformContext.validation.baseInstance) != null ? _a2 : uniformContext == null ? void 0 : uniformContext.validation.instance;
-    const required = validationInstance ? checkFieldIsRequired(validationInstance, fieldPath) : false;
-    const error = getValidationErrorsByName(
-      (_b = uniformContext == null ? void 0 : uniformContext.validation.errors) != null ? _b : {},
-      name
-    );
-    const fieldState = getFieldStateOrig(name, formState);
-    return _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, fieldState), {
-      error,
-      invalid: !!error,
-      required,
-      testId: _chunkOKJWLH7Tcjs.nameToTestId.call(void 0, testId != null ? testId : name)
-    });
-  };
-  const getValues = ((...args) => {
-    const result = getValuesOrig(...args);
-    return _chunkOKJWLH7Tcjs.toValidationFormat.call(void 0, result);
-  });
-  const watch = ((...args) => {
-    const result = watchOrig(...args);
-    return _chunkOKJWLH7Tcjs.toValidationFormat.call(void 0, result);
-  });
-  const subscribe = ((...args) => {
-    const [options] = args;
-    if (options == null ? void 0 : options.callback) {
-      const originalCallback = options.callback;
-      const wrappedOptions = _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, options), {
-        callback: (subscribeFormState) => {
-          const convertedFormState = _chunk555JRYCScjs.__spreadValues.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, subscribeFormState), subscribeFormState.values && {
-            values: _chunkOKJWLH7Tcjs.toValidationFormat.call(void 0, subscribeFormState.values)
-          });
-          return originalCallback(convertedFormState);
-        }
-      });
-      return subscribeOrig(wrappedOptions);
-    }
-    return subscribeOrig(...args);
-  });
-  return _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, otherMethods), uniformContext), {
-    formState,
-    getFieldState,
-    getValues,
-    subscribe,
-    watch
-  });
-};
-
-
-
-
-exports.checkFieldIsRequired = checkFieldIsRequired; exports.useFormContext = useFormContext;
-//# sourceMappingURL=chunk-FYN7ZWLW.cjs.map

package/dist/chunk-FYN7ZWLW.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-FYN7ZWLW.cjs","../src/hooks/useFormContext/useFormContext.ts"],"names":["_a"],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-FYN7ZWLW.cjs","sourcesContent":[null,"/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { VetoFormattedError, VetoInstance } from '@fuf-stack/veto';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useFormContext as useHookFormContext } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { flatArrayKey, nameToTestId, toValidationFormat } from '../../helpers';\n\n/** Schema check whether a field is required or optional */\nexport const checkFieldIsRequired = (\n  validation: VetoInstance,\n  path: string[],\n): boolean => {\n  // Handle flat array paths: strip the flatArrayKey to check the array element schema\n  // e.g., ['arrayField', '0', '__FLAT__'] -> check schema at ['arrayField', '0']\n  const checkPath =\n    path[path.length - 1] === flatArrayKey ? path.slice(0, -1) : path;\n\n  const checkRequired = (schema: any) => {\n    // arrays ...\n    if (schema.type === 'array') {\n      // ... if array is optional or nullable it is not required\n      if (schema.isOptional || schema.isNullable) {\n        return false;\n      }\n      // ... otherwise arrays are required (display logic wise -> no asterisk in the label)\n      return true;\n    }\n\n    // all other fields are required if they are\n    // not optional and not nullable\n    return !schema.isOptional && !schema.isNullable;\n  };\n\n  return validation.checkSchemaPath(checkRequired, checkPath);\n};\n\n/**\n * Resolve validation errors for a given field path.\n *\n * Traverses a nested `VetoFormattedError` structure using a dotted path\n * (for example: \"user.address.0.street\") and returns the matching\n * `FieldError[]` if present. If no error exists at the path, returns\n * `undefined`.\n *\n * @param errors - The formatted validation errors from Uniform's context\n * @param name - The dotted field path to resolve\n * @returns An array of `FieldError` entries for the field, or `undefined`\n */\nconst getValidationErrorsByName = (\n  errors: VetoFormattedError,\n  name: string,\n) => {\n  // Traverse nested error structure; ignore flat array wrapper key\n  const keys = name.split('.').filter((k) => {\n    return k !== flatArrayKey;\n  });\n  let current: unknown = errors as unknown;\n  keys.forEach((key) => {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      current = undefined;\n    }\n  });\n  return current as FieldError[] | undefined;\n};\n\n/**\n * Custom hook that extends react-hook-form's useFormContext to add validation and state management.\n *\n * Key features:\n * - Enhanced `getFieldState` that includes validation schema-based \"required\" status and testId generation\n * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:\n *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)\n *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)\n *   - Filters out empty/null values\n */\nexport const useFormContext = <\n  TFieldValues extends FieldValues = FieldValues,\n  TContext = any,\n  TTransformedValues = TFieldValues,\n>() => {\n  const {\n    formState,\n    // some methods that will be enhanced below\n    getFieldState: getFieldStateOrig,\n    getValues: getValuesOrig,\n    watch: watchOrig,\n    subscribe: subscribeOrig,\n    // the rest of the methods pass through unchanged\n    ...otherMethods\n  } = useHookFormContext<TFieldValues, TContext, TTransformedValues>();\n\n  const uniformContext = useContext(UniformContext);\n\n  /**\n   * Updated getFieldState method which returns:\n   * - Whether the field is required by checking the validation schema\n   * - Existing field state information (errors, etc.)\n   * - A testId generated from the field name (with flat array keys removed and slugified)\n   *\n   * @param name - The field path (string or array)\n   * @param testId - Optional explicit testId. If provided, will be slugified. If not provided, generated from name.\n   */\n  const getFieldState = (name: Path<TFieldValues>, testId?: string) => {\n    const fieldPath =\n      typeof name === 'string' ? name.replace(/\\[\\d+\\]/g, '').split('.') : name;\n\n    // Use base validation instance for checking \"required\" status\n    // Client validation often uses .nullish() which would incorrectly mark fields as optional\n    const validationInstance =\n      uniformContext?.validation.baseInstance ??\n      uniformContext?.validation.instance;\n\n    // Check if the field is required using the validation schema\n    const required = validationInstance\n      ? checkFieldIsRequired(validationInstance, fieldPath)\n      : false;\n\n    const error = getValidationErrorsByName(\n      uniformContext?.validation.errors ?? {},\n      name,\n    ) as unknown as FieldError[] | undefined;\n\n    // Get everything but the error from the original field state\n    const fieldState = getFieldStateOrig(name, formState);\n\n    return {\n      ...fieldState,\n      error,\n      invalid: !!error,\n      required,\n      testId: nameToTestId(testId ?? name),\n    };\n  };\n\n  /**\n   * Wrap form value accessor methods to automatically convert from internal storage format\n   * to component-friendly format:\n   *\n   * - Unwrap flat array wrappers: `{ __FLAT__: value }` → `value`\n   * - Convert nullish string markers: `__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`\n   * - Filter out empty/null values: fields with converted null/empty values are removed entirely\n   *\n   * This ensures components receive clean, predictable data without needing to handle\n   * the internal nullish string conversion system or flat array wrapping manually.\n   */\n  const getValues = ((...args: any[]) => {\n    const result = (getValuesOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof getValuesOrig;\n\n  const watch = ((...args: any[]) => {\n    const result = (watchOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof watchOrig;\n\n  const subscribe = ((...args: any[]) => {\n    // For subscribe, we need to wrap the callback to convert the values property\n    const [options] = args;\n    if (options?.callback) {\n      const originalCallback = options.callback;\n      const wrappedOptions = {\n        ...options,\n        callback: (subscribeFormState: any) => {\n          // Convert the values property if it exists\n          const convertedFormState = {\n            ...subscribeFormState,\n            ...(subscribeFormState.values && {\n              values: toValidationFormat(subscribeFormState.values),\n            }),\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n          return originalCallback(convertedFormState);\n        },\n      };\n      return subscribeOrig(wrappedOptions);\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return (subscribeOrig as any)(...args);\n  }) as typeof subscribeOrig;\n\n  return {\n    ...otherMethods,\n    ...uniformContext,\n    formState,\n    getFieldState,\n    getValues,\n    subscribe,\n    watch,\n  };\n};\n"]}

package/dist/chunk-GEC75GNL.js

@@ -1,137 +0,0 @@
-import {
-  FieldCopyTestIdButton_default
-} from "./chunk-NTDKZW4E.js";
-import {
-  FieldValidationError_default
-} from "./chunk-ELYGQTXB.js";
-import {
-  useController
-} from "./chunk-5MTIQ6WD.js";
-import {
-  useInput
-} from "./chunk-AHJJIANM.js";
-import {
-  useInputValueTransform
-} from "./chunk-CNTOODUQ.js";
-import {
-  useFormContext
-} from "./chunk-SJWL6EMI.js";
-import {
-  __spreadProps,
-  __spreadValues
-} from "./chunk-K2V4ULA2.js";
-
-// src/hooks/useUniformField/useUniformField.tsx
-import { isTestEnvironment } from "@fuf-stack/pixel-utils";
-import { useDebounce } from "@fuf-stack/pixels";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-var useDebouncedInvalid = (invalid, delayMs) => {
-  const debouncedInvalid = useDebounce(invalid, delayMs);
-  if (isTestEnvironment()) {
-    return invalid;
-  }
-  return debouncedInvalid;
-};
-var useUniformField = (params) => {
-  var _a;
-  const {
-    name,
-    ariaLabel: customAriaLabel,
-    disabled = false,
-    testId: explicitTestId,
-    label,
-    type,
-    transform
-  } = params;
-  const {
-    control,
-    debugMode,
-    formState: { submitCount },
-    getFieldState,
-    getValues,
-    resetField
-  } = useFormContext();
-  const {
-    error,
-    invalid: rawInvalid,
-    isDirty,
-    isTouched,
-    required,
-    testId
-  } = getFieldState(name, explicitTestId);
-  const { field } = useController({
-    control,
-    disabled,
-    name
-  });
-  const {
-    onChange: fieldOnChange,
-    value: fieldValue,
-    disabled: isDisabled,
-    onBlur,
-    ref
-  } = field;
-  const { toDisplayValue, toFormValue } = useInputValueTransform({
-    type,
-    transform
-  });
-  const transformedValue = toDisplayValue(fieldValue);
-  const transformedOnChange = (eventOrValue) => {
-    var _a2, _b;
-    const displayValue = (_b = (_a2 = eventOrValue == null ? void 0 : eventOrValue.target) == null ? void 0 : _a2.value) != null ? _b : eventOrValue;
-    const formValue = toFormValue(displayValue);
-    fieldOnChange(formValue);
-  };
-  const defaultValue = (_a = getValues()) == null ? void 0 : _a[name];
-  const showInvalid = rawInvalid && (isDirty || isTouched || submitCount > 0);
-  const invalid = useDebouncedInvalid(showInvalid, 200);
-  const showTestIdCopyButton = debugMode === "debug-testids";
-  const labelNode = !!label || showTestIdCopyButton ? /* @__PURE__ */ jsxs(Fragment, { children: [
-    label !== false ? label : null,
-    showTestIdCopyButton ? /* @__PURE__ */ jsx(FieldCopyTestIdButton_default, { testId }) : null
-  ] }) : null;
-  const errorMessage = /* @__PURE__ */ jsx(FieldValidationError_default, { error, testId });
-  const { getErrorMessageProps, getLabelProps, getHelperWrapperProps } = useInput({
-    ref,
-    classNames: {
-      // set padding to 0 for error message exit animation
-      helperWrapper: "p-0"
-    },
-    errorMessage: JSON.stringify(error),
-    isInvalid: invalid,
-    isRequired: required,
-    label,
-    labelPlacement: "outside"
-  });
-  const ariaLabel = customAriaLabel != null ? customAriaLabel : typeof label === "string" ? label : name;
-  return {
-    ariaLabel,
-    control,
-    debugMode,
-    defaultValue,
-    disabled: isDisabled,
-    error,
-    errorMessage,
-    field: __spreadProps(__spreadValues({}, field), {
-      value: transformedValue,
-      onChange: transformedOnChange
-    }),
-    getErrorMessageProps,
-    getHelperWrapperProps,
-    getLabelProps,
-    getValues,
-    invalid,
-    label: labelNode,
-    onBlur,
-    onChange: transformedOnChange,
-    ref,
-    required,
-    resetField,
-    testId
-  };
-};
-
-export {
-  useUniformField
-};
-//# sourceMappingURL=chunk-GEC75GNL.js.map

package/dist/chunk-GEC75GNL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/useUniformField/useUniformField.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\nimport type { InputValueTransform } from '../useInputValueTransform/useInputValueTransform';\n\nimport React from 'react';\n\nimport { isTestEnvironment } from '@fuf-stack/pixel-utils';\nimport { useDebounce } from '@fuf-stack/pixels';\n\nimport { FieldCopyTestIdButton } from '../../partials/FieldCopyTestIdButton';\nimport { FieldValidationError } from '../../partials/FieldValidationError';\nimport { useController } from '../useController/useController';\nimport { useFormContext } from '../useFormContext/useFormContext';\nimport { useInput } from '../useInput/useInput';\nimport { useInputValueTransform } from '../useInputValueTransform/useInputValueTransform';\n\n/**\n * Debounce invalid state changes to prevent UI flicker on rapid changes.\n *\n * Primary purpose: Reduce UI flicker when validation state changes rapidly\n * (e.g., during fast typing). Without debouncing, error messages would flash\n * in/out rapidly, creating a poor UX.\n *\n * Secondary benefit: When animations are enabled (default), gives time for\n * enter/exit animations to complete smoothly.\n *\n * Behavior:\n * - Debounces both true → false and false → true transitions by `delayMs`\n * - Disabled in test environments for immediate snapshots\n */\nconst useDebouncedInvalid = (invalid: boolean, delayMs: number) => {\n  const debouncedInvalid = useDebounce(invalid, delayMs);\n\n  // Disable debouncing in test environments for immediate snapshots\n  if (isTestEnvironment()) {\n    return invalid;\n  }\n\n  return debouncedInvalid;\n};\n\nexport interface UseUniformFieldParams<\n  TFieldValues extends FieldValues = FieldValues,\n  TDisplay = unknown,\n> {\n  /** Form field name */\n  name: Path<TFieldValues> & string;\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional label content */\n  label?: ReactNode;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional value transformation between form and display values */\n  transform?: InputValueTransform<TDisplay>;\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n}\n\nexport interface UseUniformFieldReturn<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** Computed aria-label fallback (field name) when no visible label exists. Components can override based on their accessibility needs (e.g., if placeholder provides sufficient context) */\n  ariaLabel: string | undefined;\n  /** react-hook-form control instance for advanced integrations */\n  control: ReturnType<typeof useFormContext<TFieldValues>>['control'];\n  /** Debug mode from Uniform provider */\n  debugMode: ReturnType<typeof useFormContext<TFieldValues>>['debugMode'];\n  /** Current value used to initialize uncontrolled components */\n  defaultValue: unknown;\n  /** Whether the field is currently disabled (from RHF) */\n  disabled: boolean | undefined;\n  /** Validation error(s) for the field */\n  error: FieldError[] | undefined;\n  /** Pre-built errorMessage node to plug into components */\n  errorMessage: ReactNode | null;\n  /** RHF controller field with transformed value/onChange (use this for simple components) */\n  field: ReturnType<typeof useController<TFieldValues>>['field'];\n  /** Helper to spread standardized error message props to underlying components */\n  getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];\n  /** Helper to spread standardized helper wrapper props (for spacing/animation) */\n  getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];\n  /** Helper to spread standardized label props to underlying components */\n  getLabelProps: ReturnType<typeof useInput>['getLabelProps'];\n  /** Access current form values (converted to validation-friendly format) */\n  getValues: ReturnType<typeof useFormContext<TFieldValues>>['getValues'];\n  /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */\n  invalid: boolean;\n  /** Computed label node including optional test id copy button */\n  label: ReactNode | null;\n  /** onBlur handler from controller */\n  onBlur: ReturnType<typeof useController<TFieldValues>>['field']['onBlur'];\n  /** onChange handler from controller (with transform applied) */\n  onChange: ReturnType<typeof useController<TFieldValues>>['field']['onChange'];\n  /** Ref to forward to underlying control */\n  ref: ReturnType<typeof useController<TFieldValues>>['field']['ref'];\n  /** Whether the field is required according to validation schema */\n  required: boolean;\n  /** Reset a specific field in the form */\n  resetField: ReturnType<typeof useFormContext<TFieldValues>>['resetField'];\n  /** Generated HTML data-testid for the field */\n  testId: string;\n}\n\n/**\n * Combines frequently used form field logic into a single hook.\n *\n * Provides:\n * - Enhanced form context (validation-aware state, `testId`, value transforms)\n * - Controller field with nullish conversion handling\n * - Value transformation via `transform` prop:\n *   • Allows disentangled display and form values (e.g., string ↔ object, boolean ↔ array)\n *   • Automatically applies `toDisplayValue` to field value for components\n *   • Automatically applies `toFormValue` to display value when onChange is called\n *   • Works with `type` prop for automatic number/string conversion\n *   • Examples: storing objects while displaying strings, storing booleans as arrays, enriching values with metadata\n * - Debounced `invalid` state with smart timing:\n *   • `true` (field becomes invalid): applies immediately so errors show right away\n *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations\n *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion\n * - Smart `invalid` visibility (via `showInvalid`):\n *   • Shows errors when field is dirty OR touched OR form has been submitted\n *   • Prevents showing errors on pristine/untouched fields for better UX\n *   • Works well for all field types (text inputs, checkboxes, radios, arrays)\n * - Prebuilt `errorMessage` React node using `FieldValidationError`\n * - Computed `label` node which appends a `FieldCopyTestIdButton` in\n *   `debug-testids` mode\n * - `defaultValue` for uncontrolled defaults and all usual field handlers\n * - Access to form utilities: `control`, `getValues`, `resetField`\n * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,\n *   `getHelperWrapperProps` for consistent wiring to underlying UI components\n */\nexport const useUniformField = <\n  TFieldValues extends FieldValues = FieldValues,\n  TDisplay = unknown,\n>(\n  params: UseUniformFieldParams<TFieldValues, TDisplay>,\n): UseUniformFieldReturn<TFieldValues> => {\n  const {\n    name,\n    ariaLabel: customAriaLabel,\n    disabled = false,\n    testId: explicitTestId,\n    label,\n    type,\n    transform,\n  } = params;\n\n  const {\n    control,\n    debugMode,\n    formState: { submitCount },\n    getFieldState,\n    getValues,\n    resetField,\n  } = useFormContext<TFieldValues>();\n\n  const {\n    error,\n    invalid: rawInvalid,\n    isDirty,\n    isTouched,\n    required,\n    testId,\n  } = getFieldState(name, explicitTestId);\n\n  const { field } = useController<TFieldValues>({\n    control,\n    disabled,\n    name,\n  });\n  const {\n    onChange: fieldOnChange,\n    value: fieldValue,\n    disabled: isDisabled,\n    onBlur,\n    ref,\n  } = field;\n\n  // Get transform utilities (but don't apply them automatically)\n  // Components can choose how to use them (directly or via useInputValueDebounce)\n  const { toDisplayValue, toFormValue } = useInputValueTransform<TDisplay>({\n    type,\n    transform,\n  });\n\n  // For components without special needs: apply transform to value and onChange\n  const transformedValue = toDisplayValue(fieldValue);\n  const transformedOnChange = (eventOrValue: TDisplay | React.ChangeEvent) => {\n    // Extract value from event or use value directly\n    const displayValue =\n      (eventOrValue as React.ChangeEvent<HTMLInputElement>)?.target?.value ??\n      eventOrValue;\n    const formValue = toFormValue(displayValue as TDisplay);\n    fieldOnChange(formValue as typeof fieldValue);\n  };\n\n  const defaultValue = (getValues() as Record<string, unknown>)?.[\n    name as string\n  ];\n\n  /**\n   * Determine when to show the invalid state to the user.\n   *\n   * Show errors when the field is invalid AND any of these conditions are met:\n   *   - Field is dirty (value changed from initial) - good for checkboxes/radios/arrays\n   *   - Field is touched (focused and blurred) - good for text inputs\n   *   - Form has been submitted - shows all errors after submit attempt\n   *\n   * This prevents showing errors on pristine/untouched fields for better UX.\n   * Examples:\n   *   - Text input: User loads form with empty required field → no error shown yet\n   *   - Text input: User focuses and blurs → error shows (via isTouched)\n   *   - Checkbox group: User clicks first checkbox → error shows immediately (via isDirty)\n   *   - Any field: User submits form → all errors show (via submitCount)\n   *\n   * The entire condition is debounced to prevent flickering and allow smooth animations\n   * when any of the states (invalid, isDirty, isTouched, submitCount) change.\n   */\n  const showInvalid = rawInvalid && (isDirty || isTouched || submitCount > 0);\n  const invalid = useDebouncedInvalid(showInvalid, 200);\n\n  // Build a label node that:\n  // - shows the provided label (unless explicitly set to false)\n  // - appends a copy-to-clipboard button for the test id in `debug-testids` mode\n  // Consumers can pass this directly to component `label` props\n  const showTestIdCopyButton = debugMode === 'debug-testids';\n  const labelNode: ReactNode | null =\n    !!label || showTestIdCopyButton ? (\n      <>\n        {label !== false ? label : null}\n        {showTestIdCopyButton ? (\n          <FieldCopyTestIdButton testId={testId} />\n        ) : null}\n      </>\n    ) : null;\n\n  // Ready-to-render error message; consumers can drop this into their\n  // component `errorMessage` prop without repeating mapping/markup\n  const errorMessage = <FieldValidationError error={error} testId={testId} />;\n\n  // Generate standardized props for label, helper wrapper and error message\n  // so consumers can spread them directly into UI components (e.g. HeroUI),\n  // keeping animations/spacing consistent across fields\n  const { getErrorMessageProps, getLabelProps, getHelperWrapperProps } =\n    useInput({\n      ref,\n      classNames: {\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n      },\n      errorMessage: JSON.stringify(error),\n      isInvalid: invalid,\n      isRequired: required,\n      label,\n      labelPlacement: 'outside',\n    });\n\n  // Compute aria-label: prefer custom prop, then use string label if available, otherwise field name\n  // Components can further override this based on their specific accessibility needs\n  // (e.g., Input/TextArea may skip this if they have a meaningful placeholder)\n  const ariaLabel =\n    customAriaLabel ?? (typeof label === 'string' ? label : name);\n\n  return {\n    ariaLabel,\n    control,\n    debugMode,\n    defaultValue,\n    disabled: isDisabled,\n    error,\n    errorMessage,\n    field: {\n      ...field,\n      value: transformedValue as typeof field.value,\n      onChange: transformedOnChange as typeof field.onChange,\n    },\n    getErrorMessageProps,\n    getHelperWrapperProps,\n    getLabelProps,\n    getValues,\n    invalid,\n    label: labelNode,\n    onBlur,\n    onChange: transformedOnChange as typeof field.onChange,\n    ref,\n    required,\n    resetField,\n    testId,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAMA,SAAS,yBAAyB;AAClC,SAAS,mBAAmB;AAgOtB,mBAGI,KAHJ;AAzMN,IAAM,sBAAsB,CAAC,SAAkB,YAAoB;AACjE,QAAM,mBAAmB,YAAY,SAAS,OAAO;AAGrD,MAAI,kBAAkB,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AA+FO,IAAM,kBAAkB,CAI7B,WACwC;AA3I1C;AA4IE,QAAM;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,IACX,WAAW;AAAA,IACX,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,WAAW,EAAE,YAAY;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,eAA6B;AAEjC,QAAM;AAAA,IACJ;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,cAAc,MAAM,cAAc;AAEtC,QAAM,EAAE,MAAM,IAAI,cAA4B;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM;AAAA,IACJ,UAAU;AAAA,IACV,OAAO;AAAA,IACP,UAAU;AAAA,IACV;AAAA,IACA;AAAA,EACF,IAAI;AAIJ,QAAM,EAAE,gBAAgB,YAAY,IAAI,uBAAiC;AAAA,IACvE;AAAA,IACA;AAAA,EACF,CAAC;AAGD,QAAM,mBAAmB,eAAe,UAAU;AAClD,QAAM,sBAAsB,CAAC,iBAA+C;AA9L9E,QAAAA,KAAA;AAgMI,UAAM,gBACH,MAAAA,MAAA,6CAAsD,WAAtD,gBAAAA,IAA8D,UAA9D,YACD;AACF,UAAM,YAAY,YAAY,YAAwB;AACtD,kBAAc,SAA8B;AAAA,EAC9C;AAEA,QAAM,gBAAgB,eAAU,MAAV,mBACpB;AAqBF,QAAM,cAAc,eAAe,WAAW,aAAa,cAAc;AACzE,QAAM,UAAU,oBAAoB,aAAa,GAAG;AAMpD,QAAM,uBAAuB,cAAc;AAC3C,QAAM,YACJ,CAAC,CAAC,SAAS,uBACT,iCACG;AAAA,cAAU,QAAQ,QAAQ;AAAA,IAC1B,uBACC,oBAAC,iCAAsB,QAAgB,IACrC;AAAA,KACN,IACE;AAIN,QAAM,eAAe,oBAAC,gCAAqB,OAAc,QAAgB;AAKzE,QAAM,EAAE,sBAAsB,eAAe,sBAAsB,IACjE,SAAS;AAAA,IACP;AAAA,IACA,YAAY;AAAA;AAAA,MAEV,eAAe;AAAA,IACjB;AAAA,IACA,cAAc,KAAK,UAAU,KAAK;AAAA,IAClC,WAAW;AAAA,IACX,YAAY;AAAA,IACZ;AAAA,IACA,gBAAgB;AAAA,EAClB,CAAC;AAKH,QAAM,YACJ,4CAAoB,OAAO,UAAU,WAAW,QAAQ;AAE1D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,OAAO,iCACF,QADE;AAAA,MAEL,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":["_a"]}

package/dist/chunk-HEPNEBRF.cjs

@@ -1,26 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkFYN7ZWLWcjs = require('./chunk-FYN7ZWLW.cjs');
-
-// src/hooks/useWatchUserChange/useWatchUserChange.ts
-var _react = require('react');
-var useWatchUserChange = ({
-  watch: watchField,
-  onChange
-}) => {
-  const { setValue, resetField, reset, userChange } = _chunkFYN7ZWLWcjs.useFormContext.call(void 0, );
-  _react.useEffect.call(void 0, () => {
-    const listener = (fieldName, value) => {
-      if (fieldName === watchField) {
-        onChange(value, { setValue, resetField, reset });
-      }
-    };
-    const unsubscribe = userChange.subscribe(listener);
-    return unsubscribe;
-  }, [watchField, onChange, setValue, resetField, reset, userChange]);
-};
-
-
-
-exports.useWatchUserChange = useWatchUserChange;
-//# sourceMappingURL=chunk-HEPNEBRF.cjs.map

package/dist/chunk-HEPNEBRF.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-HEPNEBRF.cjs","../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACA;ACIA,8BAA0B;AA4EnB,IAAM,mBAAA,EAAqB,CAEhC;AAAA,EACA,KAAA,EAAO,UAAA;AAAA,EACP;AACF,CAAA,EAAA,GAA+C;AAC7C,EAAA,MAAM,EAAE,QAAA,EAAU,UAAA,EAAY,KAAA,EAAO,WAAW,EAAA,EAC9C,8CAAA,CAA6B;AAE/B,EAAA,8BAAA,CAAU,EAAA,GAAM;AAEd,IAAA,MAAM,SAAA,EAAW,CAAC,SAAA,EAA+B,KAAA,EAAA,GAAmB;AAElE,MAAA,GAAA,CAAI,UAAA,IAAc,UAAA,EAAY;AAE5B,QAAA,QAAA,CAAS,KAAA,EAAO,EAAE,QAAA,EAAU,UAAA,EAAY,MAAM,CAAC,CAAA;AAAA,MACjD;AAAA,IACF,CAAA;AAGA,IAAA,MAAM,YAAA,EAAc,UAAA,CAAW,SAAA,CAAU,QAAQ,CAAA;AAGjD,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,UAAA,EAAY,QAAA,EAAU,QAAA,EAAU,UAAA,EAAY,KAAA,EAAO,UAAU,CAAC,CAAA;AACpE,CAAA;ADxFA;AACA;AACE;AACF,gDAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-HEPNEBRF.cjs","sourcesContent":[null,"import type {\n  FieldValues,\n  Path,\n  UseFormReset,\n  UseFormResetField,\n  UseFormSetValue,\n} from 'react-hook-form';\n\nimport { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {\n  /** Field name to watch for user changes */\n  watch: Path<TFieldValues>;\n  /**\n   * Callback when watched field is changed by user input.\n   * Receives the new value and form helpers (setValue, resetField, reset).\n   */\n  onChange: (\n    value: unknown,\n    helpers: {\n      setValue: UseFormSetValue<TFieldValues>;\n      resetField: UseFormResetField<TFieldValues>;\n      reset: UseFormReset<TFieldValues>;\n    },\n  ) => void;\n}\n\n/**\n * Hook that watches for user changes on a specific form field.\n *\n * Only triggers on manual user input (typing, clicking, selecting),\n * NOT on programmatic changes like form.reset() or form.setValue().\n *\n * This hook subscribes to field changes at the source (useController),\n * ensuring immediate and accurate detection of user interactions.\n *\n * Use cases:\n * - Reset dependent fields when parent field changes\n * - Set mode-specific default values when a toggle changes\n * - Clear form sections based on user selections\n * - Trigger side effects only on user interaction\n *\n * Note: To watch multiple fields, call this hook multiple times.\n *\n * @example\n * ```tsx\n * // Reset city and address when user changes country\n * useWatchUserChange({\n *   watch: 'country',\n *   onChange: (value, { resetField }) => {\n *     resetField('city');\n *     resetField('address');\n *   },\n * });\n *\n * // Set defaults when user changes payment method\n * useWatchUserChange({\n *   watch: 'paymentMethod',\n *   onChange: (value, { setValue }) => {\n *     if (value === 'credit') {\n *       setValue('installments', 3);\n *     } else {\n *       setValue('installments', 1);\n *     }\n *   },\n * });\n *\n * // Watch multiple fields by calling the hook multiple times\n * useWatchUserChange({\n *   watch: 'category',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * useWatchUserChange({\n *   watch: 'brand',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * ```\n */\nexport const useWatchUserChange = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  watch: watchField,\n  onChange,\n}: UseWatchUserChangeOptions<TFieldValues>) => {\n  const { setValue, resetField, reset, userChange } =\n    useFormContext<TFieldValues>();\n\n  useEffect(() => {\n    // Create listener that checks if changed field is the one we're watching\n    const listener = (fieldName: Path<TFieldValues>, value: unknown) => {\n      // Check if this is the field we're watching\n      if (fieldName === watchField) {\n        // Call the onChange callback with helpers\n        onChange(value, { setValue, resetField, reset });\n      }\n    };\n\n    // Subscribe to user changes\n    const unsubscribe = userChange.subscribe(listener);\n\n    // Cleanup on unmount\n    return unsubscribe;\n  }, [watchField, onChange, setValue, resetField, reset, userChange]);\n};\n"]}