@fuf-stack/uniform 1.6.1 → 1.6.3

package/dist/{chunk-VPUMTPD3.cjs.map → chunk-V3NNJJHY.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-VPUMTPD3.cjs","../src/RadioBoxes/RadioBoxes.tsx","../src/RadioBoxes/RadioBox.tsx","../src/RadioBoxes/index.ts"],"names":["jsx","_a","_b","RadioBoxes_default"],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-VPUMTPD3.cjs","sourcesContent":[null,"import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { RadioGroup as HeroRadioGroup } from '@heroui/radio';\n\nimport { slugify, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks';\n//\nimport { RadioBox } from './RadioBox';\n\nexport const radioBoxesVariants = tv({\n  slots: {\n    base: 'group gap-0', // Needs group for group-data condition\n    itemBase: '',\n    itemControl: 'bg-focus group-data-[invalid=true]:bg-danger',\n    itemDescription: '',\n    itemLabel: 'text-sm',\n    itemLabelWrapper: '',\n    itemWrapper:\n      'group-data-[invalid=true]:!border-danger [&:not(group-data-[invalid=\"true\"]):not(group-data-[selected=\"false\"])]:border-focus', // TODO: get rid of !.\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      'mb-2 inline-flex text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:text-danger',\n    wrapper: '',\n  },\n});\n\ntype VariantProps = TVProps<typeof radioBoxesVariants>;\ntype ClassName = TVClassName<typeof radioBoxesVariants>;\n\nexport interface RadioBoxesOption {\n  /** Description of the value. Works with variant radioBox. */\n  description?: ReactNode;\n  /** disables the option */\n  disabled?: boolean;\n  /** option label */\n  label?: ReactNode;\n  /** option icon */\n  icon?: ReactNode;\n  /** HTML data-testid attribute of the option */\n  testId?: string;\n  /** option value */\n  value: string;\n}\n\nexport interface RadioBoxesProps extends VariantProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** Determines if the Buttons are disabled or not. */\n  disabled?: boolean;\n  /** determines orientation of the Buttons. */\n  inline?: boolean;\n  /** Label displayed next to the RadioButton. */\n  label?: ReactNode;\n  /** Name the RadioButtons are registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** Radio button configuration. */\n  options: RadioBoxesOption[];\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * RadioBoxes component based on [HeroUI RadioGroup](https://www.heroui.com//docs/components/radio-group)\n */\nconst RadioBoxes = ({\n  className = undefined,\n  inline = false,\n  name,\n  options,\n  ...uniformFieldProps\n}: RadioBoxesProps) => {\n  const {\n    defaultValue,\n    errorMessage,\n    invalid,\n    disabled,\n    label,\n    onBlur,\n    onChange,\n    ref,\n    required,\n    testId,\n  } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  // classNames from slots\n  const variants = radioBoxesVariants();\n  const classNames = variantsToClassNames(variants, className, 'base');\n  const itemClassNames = {\n    base: classNames.itemBase,\n    control: classNames.itemControl,\n    description: classNames.itemDescription,\n    label: classNames.itemLabel,\n    labelWrapper: classNames.itemLabelWrapper,\n    wrapper: classNames.itemWrapper,\n  };\n\n  return (\n    <HeroRadioGroup\n      ref={ref}\n      classNames={classNames}\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      data-invalid={invalid}\n      data-required={required}\n      data-testid={testId}\n      defaultValue={defaultValue as string}\n      errorMessage={errorMessage}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label ? <legend>{label}</legend> : null}\n      name={name}\n      onBlur={onBlur}\n      orientation={inline ? 'horizontal' : 'vertical'}\n    >\n      {options.map((option) => {\n        if ('value' in option) {\n          const optionTestId = slugify(\n            `${testId}_option_${option.testId ?? option.value}`,\n            { replaceDots: true },\n          );\n          return (\n            <RadioBox\n              key={option.value}\n              classNames={itemClassNames}\n              data-testid={optionTestId}\n              description={option.description}\n              icon={option.icon}\n              isDisabled={!!disabled || option.disabled}\n              onChange={onChange}\n              value={option.value}\n            >\n              {option.label ?? option.value}\n            </RadioBox>\n          );\n        }\n        return null;\n      })}\n    </HeroRadioGroup>\n  );\n};\n\nexport default RadioBoxes;\n","import type { RadioProps as HeroRadioProps } from '@heroui/radio';\nimport type { ReactNode } from 'react';\n\nimport { useRadio } from '@heroui/radio';\nimport { VisuallyHidden } from '@react-aria/visually-hidden';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\ninterface RadioProps extends HeroRadioProps {\n  /** icon for the option */\n  icon?: ReactNode;\n}\n\nexport const RadioBox = ({ icon = undefined, ...props }: RadioProps) => {\n  const {\n    children,\n    Component,\n    description,\n    getBaseProps,\n    getControlProps,\n    getInputProps,\n    getLabelProps,\n    getLabelWrapperProps,\n    getWrapperProps,\n    isDisabled,\n  } = useRadio(props);\n\n  return (\n    <Component\n      {...getBaseProps()}\n      className={cn(\n        'group inline-flex flex-auto cursor-pointer items-center justify-between gap-4 rounded-lg border-2 border-default p-4 hover:bg-content2 data-[selected=true]:border-focus',\n        {\n          // disabled styles\n          'pointer-events-none opacity-disabled': isDisabled,\n        },\n      )}\n    >\n      <VisuallyHidden>\n        <input {...getInputProps()} />\n      </VisuallyHidden>\n      <span {...getWrapperProps()}>\n        <span {...getControlProps()} />\n      </span>\n      {icon}\n      <div\n        {...getLabelWrapperProps()}\n        className={cn(getLabelWrapperProps().className, 'grow')}\n      >\n        {children ? <span {...getLabelProps()}>{children}</span> : null}\n        {description ? (\n          <span className=\"text-foreground opacity-70 text-small\">\n            {description}\n          </span>\n        ) : null}\n      </div>\n    </Component>\n  );\n};\n\nexport default RadioBox;\n","import RadioBoxes from './RadioBoxes';\n\nexport type { RadioBoxesProps } from './RadioBoxes';\n\nexport { RadioBoxes };\n\nexport default RadioBoxes;\n"]}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-V3NNJJHY.cjs","../src/RadioBoxes/RadioBoxes.tsx","../src/RadioBoxes/RadioBox.tsx","../src/RadioBoxes/index.ts"],"names":["jsx","_a","_b","RadioBoxes_default"],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-V3NNJJHY.cjs","sourcesContent":[null,"import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { RadioGroup as HeroRadioGroup } from '@heroui/radio';\n\nimport { slugify, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks';\n//\nimport { RadioBox } from './RadioBox';\n\nexport const radioBoxesVariants = tv({\n  slots: {\n    base: 'group gap-0', // Needs group for group-data condition\n    itemBase: '',\n    itemControl: 'bg-focus group-data-[invalid=true]:bg-danger',\n    itemDescription: '',\n    itemLabel: 'text-sm',\n    itemLabelWrapper: '',\n    itemWrapper:\n      'group-data-[invalid=true]:!border-danger [&:not(group-data-[invalid=\"true\"]):not(group-data-[selected=\"false\"])]:border-focus', // TODO: get rid of !.\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      'mb-2 inline-flex text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:text-danger',\n    wrapper: '',\n  },\n});\n\ntype VariantProps = TVProps<typeof radioBoxesVariants>;\ntype ClassName = TVClassName<typeof radioBoxesVariants>;\n\nexport interface RadioBoxesOption {\n  /** Description of the value. Works with variant radioBox. */\n  description?: ReactNode;\n  /** disables the option */\n  disabled?: boolean;\n  /** option label */\n  label?: ReactNode;\n  /** option icon */\n  icon?: ReactNode;\n  /** HTML data-testid attribute of the option */\n  testId?: string;\n  /** option value */\n  value: string;\n}\n\nexport interface RadioBoxesProps extends VariantProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** Determines if the Buttons are disabled or not. */\n  disabled?: boolean;\n  /** determines orientation of the Buttons. */\n  inline?: boolean;\n  /** Label displayed next to the RadioButton. */\n  label?: ReactNode;\n  /** Name the RadioButtons are registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** Radio button configuration. */\n  options: RadioBoxesOption[];\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * RadioBoxes component based on [HeroUI RadioGroup](https://www.heroui.com//docs/components/radio-group)\n */\nconst RadioBoxes = ({\n  className = undefined,\n  inline = false,\n  name,\n  options,\n  ...uniformFieldProps\n}: RadioBoxesProps) => {\n  const {\n    defaultValue,\n    errorMessage,\n    invalid,\n    disabled,\n    label,\n    onBlur,\n    onChange,\n    ref,\n    required,\n    testId,\n  } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  // classNames from slots\n  const variants = radioBoxesVariants();\n  const classNames = variantsToClassNames(variants, className, 'base');\n  const itemClassNames = {\n    base: classNames.itemBase,\n    control: classNames.itemControl,\n    description: classNames.itemDescription,\n    label: classNames.itemLabel,\n    labelWrapper: classNames.itemLabelWrapper,\n    wrapper: classNames.itemWrapper,\n  };\n\n  return (\n    <HeroRadioGroup\n      ref={ref}\n      classNames={classNames}\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      data-invalid={invalid}\n      data-required={required}\n      data-testid={testId}\n      defaultValue={defaultValue as string}\n      errorMessage={errorMessage}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label ? <legend>{label}</legend> : null}\n      name={name}\n      onBlur={onBlur}\n      orientation={inline ? 'horizontal' : 'vertical'}\n    >\n      {options.map((option) => {\n        if ('value' in option) {\n          const optionTestId = slugify(\n            `${testId}_option_${option.testId ?? option.value}`,\n            { replaceDots: true },\n          );\n          return (\n            <RadioBox\n              key={option.value}\n              classNames={itemClassNames}\n              data-testid={optionTestId}\n              description={option.description}\n              icon={option.icon}\n              isDisabled={!!disabled || option.disabled}\n              onChange={onChange}\n              value={option.value}\n            >\n              {option.label ?? option.value}\n            </RadioBox>\n          );\n        }\n        return null;\n      })}\n    </HeroRadioGroup>\n  );\n};\n\nexport default RadioBoxes;\n","import type { RadioProps as HeroRadioProps } from '@heroui/radio';\nimport type { ReactNode } from 'react';\n\nimport { useRadio } from '@heroui/radio';\nimport { VisuallyHidden } from '@react-aria/visually-hidden';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\ninterface RadioProps extends HeroRadioProps {\n  /** icon for the option */\n  icon?: ReactNode;\n}\n\nexport const RadioBox = ({ icon = undefined, ...props }: RadioProps) => {\n  const {\n    children,\n    Component,\n    description,\n    getBaseProps,\n    getControlProps,\n    getInputProps,\n    getLabelProps,\n    getLabelWrapperProps,\n    getWrapperProps,\n    isDisabled,\n  } = useRadio(props);\n\n  return (\n    <Component\n      {...getBaseProps()}\n      className={cn(\n        'group inline-flex flex-auto cursor-pointer items-center justify-between gap-4 rounded-lg border-2 border-default p-4 hover:bg-content2 data-[selected=true]:border-focus',\n        {\n          // disabled styles\n          'pointer-events-none opacity-disabled': isDisabled,\n        },\n      )}\n    >\n      <VisuallyHidden>\n        <input {...getInputProps()} />\n      </VisuallyHidden>\n      <span {...getWrapperProps()}>\n        <span {...getControlProps()} />\n      </span>\n      {icon}\n      <div\n        {...getLabelWrapperProps()}\n        className={cn(getLabelWrapperProps().className, 'grow')}\n      >\n        {children ? <span {...getLabelProps()}>{children}</span> : null}\n        {description ? (\n          <span className=\"text-foreground opacity-70 text-small\">\n            {description}\n          </span>\n        ) : null}\n      </div>\n    </Component>\n  );\n};\n\nexport default RadioBox;\n","import RadioBoxes from './RadioBoxes';\n\nexport type { RadioBoxesProps } from './RadioBoxes';\n\nexport { RadioBoxes };\n\nexport default RadioBoxes;\n"]}

package/dist/hooks/index.cjs

@@ -7,10 +7,10 @@ var _chunkBZ5OMN4Ycjs = require('../chunk-BZ5OMN4Y.cjs');
 var _chunk4WYC2RBEcjs = require('../chunk-4WYC2RBE.cjs');
 
 
-var _chunkAACO4OEKcjs = require('../chunk-AACO4OEK.cjs');
+var _chunkMOVNWZX5cjs = require('../chunk-MOVNWZX5.cjs');
 
 
-var _chunkTGJJZEHBcjs = require('../chunk-TGJJZEHB.cjs');
+var _chunkSOQ6GCN3cjs = require('../chunk-SOQ6GCN3.cjs');
 require('../chunk-NHEZXA4H.cjs');
 
 
@@ -22,11 +22,11 @@ require('../chunk-OE5BOGGX.cjs');
 
 
 
-var _chunkTEIXBRF5cjs = require('../chunk-TEIXBRF5.cjs');
+var _chunkD3EZXJQHcjs = require('../chunk-D3EZXJQH.cjs');
 
 
 
-var _chunkNZBO4N3Scjs = require('../chunk-NZBO4N3S.cjs');
+var _chunk42NCLEX4cjs = require('../chunk-42NCLEX4.cjs');
 require('../chunk-Z353BLWI.cjs');
 require('../chunk-555JRYCS.cjs');
 
@@ -40,5 +40,5 @@ require('../chunk-555JRYCS.cjs');
 
 
 
-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;
+exports.checkFieldIsRequired = _chunk42NCLEX4cjs.checkFieldIsRequired; exports.clientValidationSchemaByName = _chunkD3EZXJQHcjs.clientValidationSchemaByName; exports.useClientValidation = _chunkD3EZXJQHcjs.useClientValidation; exports.useController = _chunkJMFDNTVCcjs.useController; exports.useFormContext = _chunk42NCLEX4cjs.useFormContext; exports.useInput = _chunkPCTYJUY7cjs.useInput; exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce; exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform; exports.useUniformField = _chunkSOQ6GCN3cjs.useUniformField; exports.useUniformFieldArray = _chunkMOVNWZX5cjs.useUniformFieldArray;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.js

@@ -7,10 +7,10 @@ import {
 } from "../chunk-7KLFK2IT.js";
 import {
   useUniformFieldArray
-} from "../chunk-Z7FVILDT.js";
+} from "../chunk-FZQDAI7E.js";
 import {
   useUniformField
-} from "../chunk-D3NAUOYG.js";
+} from "../chunk-D3JYMGTB.js";
 import "../chunk-ELYGQTXB.js";
 import {
   useController
@@ -22,11 +22,11 @@ import "../chunk-NTDKZW4E.js";
 import {
   clientValidationSchemaByName,
   useClientValidation
-} from "../chunk-CHNYQVWO.js";
+} from "../chunk-RI45RSNN.js";
 import {
   checkFieldIsRequired,
   useFormContext
-} from "../chunk-PO5UQAU6.js";
+} from "../chunk-NZ54JBSR.js";
 import "../chunk-76KOVUDN.js";
 import "../chunk-K2V4ULA2.js";
 export {

package/dist/hooks/useClientValidation/index.cjs

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

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

@@ -4,73 +4,142 @@ import { VetoTypeAny } from '@fuf-stack/veto';
 /**
  * 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.
+ * Client validation is used for context-dependent validation rules that require external data
+ * (e.g., checking if a username already exists). It complements base validation (passed to Form),
+ * which handles static rules like "required", min/max length, format, etc.
+ *
+ * **Typical pattern:**
+ * - Base validation: Static, always-on rules (required, format, length constraints)
+ * - Client validation: Dynamic rules based on external data (uniqueness, business logic)
+ * - Client schemas should use `.nullish()` to allow empty values (base validation handles "required")
  *
- * When the client validation schema changes, automatically re-validates all touched
- * fields to ensure they are validated against the new schema.
+ * 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.
  *
  * @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.
+ * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.
+ * @param options - Optional configuration object
+ * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)
  *
  * @example
  * ```tsx
- * const { data: teamData } = useTeamQuery(teamId);
+ * // Base validation handles "required" and format
+ * const baseSchema = veto({ username: vt.string({ min: 3 }) });
  *
+ * // Client validation adds dynamic uniqueness check
+ * const { data: teamData } = useTeamQuery(teamId);
  * useClientValidation(teamData, (data) =>
- *   vt.object({
- *     username: vt.string().refine(
- *       (value) => !data.existingUsers.includes(value),
- *       { message: 'Username already exists' }
- *     )
+ *   vt.objectLoose({
+ *     username: vt.string()
+ *       .refine(
+ *         (value) => !data.existingUsers.includes(value),
+ *         { message: 'Username already exists' }
+ *       )
+ *       .nullish() // Allow empty - base validation handles "required"
  *   })
  * );
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Using custom key in a field array to avoid multiple registrations
+ * fields.map((field, index) => (
+ *   useClientValidation(
+ *     userData,
+ *     (data) => clientValidationSchemaByName(
+ *       `items.${index}.name`,
+ *       vt.string()
+ *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })
+ *         .nullish()
+ *     ),
+ *     { key: 'items-validation' } // All instances share the same key
+ *   )
+ * ));
+ * ```
  */
-declare const useClientValidation: <TData = unknown>(data: TData | null | undefined, schemaFactory: (data: TData) => VetoTypeAny) => void;
+declare const useClientValidation: <TData = unknown>(data: TData | null | undefined, schemaFactory: (data: TData) => VetoTypeAny, options?: {
+    key?: string;
+}) => 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.
+ * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.
+ *
+ * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:
+ * - Base validation (passed to Form) handles "required" constraints
+ * - Client validation adds dynamic, context-dependent rules (e.g., "username already exists")
+ * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)
+ * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`
  *
- * @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
+ * This pattern ensures client validation only validates non-empty values, while base validation
+ * enforces required fields and basic constraints (min length, format, etc.).
+ *
+ * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')
+ * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.
  * @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() })
+ * // Typical usage: base validation handles "required", client validation adds dynamic rules
+ * // Base validation (in Form component)
+ * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length
+ *
+ * // Client validation (dynamic check for existing usernames)
+ * const { data: userData } = useUserQuery(userId);
+ * useClientValidation(userData, (data) =>
+ *   clientValidationSchemaByName(
+ *     'username',
+ *     vt.string()
+ *       .refine(
+ *         (value) => !data.existingUsernames.includes(value),
+ *         { message: 'Username already taken' }
+ *       )
+ *       .nullish() // Allow empty - base validation handles "required"
+ *   )
+ * );
  * ```
  *
  * @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() })
+ * // Nested field path with dynamic validation
+ * clientValidationSchemaByName(
+ *   'user.profile.email',
+ *   vt.string()
+ *     .refine(
+ *       (value) => !reservedEmails.includes(value),
+ *       { message: 'This email is reserved' }
+ *     )
+ *     .nullish()
+ * )
+ * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })
  * ```
  *
  * @example
  * ```tsx
- * // Array field (with optional array)
- * clientValidationSchemaByName('items.0.name', vt.string())
- * // => objectLoose({ items: array(objectLoose({ name: vt.string() })).optional() })
+ * // Array of objects with dynamic validation
+ * clientValidationSchemaByName(
+ *   'items.0.tag',
+ *   vt.string()
+ *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })
+ *     .nullish()
+ * )
+ * // => objectLoose({ items: array(objectLoose({ tag: ... })).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' }
- *   ))
- * );
+ * // Flat array (array of primitives) with dynamic validation
+ * clientValidationSchemaByName(
+ *   'tags.0.__FLAT__',
+ *   vt.string()
+ *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })
+ *     .nullish()
+ * )
+ * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })
  * ```
  */
 declare const clientValidationSchemaByName: <T extends VetoTypeAny>(name: string, fieldSchema: T) => _fuf_stack_veto_dist_types_d_CNPgNK_V.Z;

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

@@ -4,73 +4,142 @@ import { VetoTypeAny } from '@fuf-stack/veto';
 /**
  * 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.
+ * Client validation is used for context-dependent validation rules that require external data
+ * (e.g., checking if a username already exists). It complements base validation (passed to Form),
+ * which handles static rules like "required", min/max length, format, etc.
+ *
+ * **Typical pattern:**
+ * - Base validation: Static, always-on rules (required, format, length constraints)
+ * - Client validation: Dynamic rules based on external data (uniqueness, business logic)
+ * - Client schemas should use `.nullish()` to allow empty values (base validation handles "required")
  *
- * When the client validation schema changes, automatically re-validates all touched
- * fields to ensure they are validated against the new schema.
+ * 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.
  *
  * @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.
+ * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.
+ * @param options - Optional configuration object
+ * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)
  *
  * @example
  * ```tsx
- * const { data: teamData } = useTeamQuery(teamId);
+ * // Base validation handles "required" and format
+ * const baseSchema = veto({ username: vt.string({ min: 3 }) });
  *
+ * // Client validation adds dynamic uniqueness check
+ * const { data: teamData } = useTeamQuery(teamId);
  * useClientValidation(teamData, (data) =>
- *   vt.object({
- *     username: vt.string().refine(
- *       (value) => !data.existingUsers.includes(value),
- *       { message: 'Username already exists' }
- *     )
+ *   vt.objectLoose({
+ *     username: vt.string()
+ *       .refine(
+ *         (value) => !data.existingUsers.includes(value),
+ *         { message: 'Username already exists' }
+ *       )
+ *       .nullish() // Allow empty - base validation handles "required"
  *   })
  * );
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Using custom key in a field array to avoid multiple registrations
+ * fields.map((field, index) => (
+ *   useClientValidation(
+ *     userData,
+ *     (data) => clientValidationSchemaByName(
+ *       `items.${index}.name`,
+ *       vt.string()
+ *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })
+ *         .nullish()
+ *     ),
+ *     { key: 'items-validation' } // All instances share the same key
+ *   )
+ * ));
+ * ```
  */
-declare const useClientValidation: <TData = unknown>(data: TData | null | undefined, schemaFactory: (data: TData) => VetoTypeAny) => void;
+declare const useClientValidation: <TData = unknown>(data: TData | null | undefined, schemaFactory: (data: TData) => VetoTypeAny, options?: {
+    key?: string;
+}) => 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.
+ * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.
+ *
+ * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:
+ * - Base validation (passed to Form) handles "required" constraints
+ * - Client validation adds dynamic, context-dependent rules (e.g., "username already exists")
+ * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)
+ * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`
  *
- * @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
+ * This pattern ensures client validation only validates non-empty values, while base validation
+ * enforces required fields and basic constraints (min length, format, etc.).
+ *
+ * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')
+ * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.
  * @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() })
+ * // Typical usage: base validation handles "required", client validation adds dynamic rules
+ * // Base validation (in Form component)
+ * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length
+ *
+ * // Client validation (dynamic check for existing usernames)
+ * const { data: userData } = useUserQuery(userId);
+ * useClientValidation(userData, (data) =>
+ *   clientValidationSchemaByName(
+ *     'username',
+ *     vt.string()
+ *       .refine(
+ *         (value) => !data.existingUsernames.includes(value),
+ *         { message: 'Username already taken' }
+ *       )
+ *       .nullish() // Allow empty - base validation handles "required"
+ *   )
+ * );
  * ```
  *
  * @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() })
+ * // Nested field path with dynamic validation
+ * clientValidationSchemaByName(
+ *   'user.profile.email',
+ *   vt.string()
+ *     .refine(
+ *       (value) => !reservedEmails.includes(value),
+ *       { message: 'This email is reserved' }
+ *     )
+ *     .nullish()
+ * )
+ * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })
  * ```
  *
  * @example
  * ```tsx
- * // Array field (with optional array)
- * clientValidationSchemaByName('items.0.name', vt.string())
- * // => objectLoose({ items: array(objectLoose({ name: vt.string() })).optional() })
+ * // Array of objects with dynamic validation
+ * clientValidationSchemaByName(
+ *   'items.0.tag',
+ *   vt.string()
+ *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })
+ *     .nullish()
+ * )
+ * // => objectLoose({ items: array(objectLoose({ tag: ... })).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' }
- *   ))
- * );
+ * // Flat array (array of primitives) with dynamic validation
+ * clientValidationSchemaByName(
+ *   'tags.0.__FLAT__',
+ *   vt.string()
+ *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })
+ *     .nullish()
+ * )
+ * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })
  * ```
  */
 declare const clientValidationSchemaByName: <T extends VetoTypeAny>(name: string, fieldSchema: T) => _fuf_stack_veto_dist_types_d_CNPgNK_V.Z;

package/dist/hooks/useClientValidation/index.js

@@ -1,8 +1,8 @@
 import {
   clientValidationSchemaByName,
   useClientValidation
-} from "../../chunk-CHNYQVWO.js";
-import "../../chunk-PO5UQAU6.js";
+} from "../../chunk-RI45RSNN.js";
+import "../../chunk-NZ54JBSR.js";
 import "../../chunk-76KOVUDN.js";
 import "../../chunk-K2V4ULA2.js";
 export {

package/dist/hooks/useFormContext/index.cjs

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

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

@@ -24,12 +24,13 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     getValues: react_hook_form.UseFormGetValues<TFieldValues>;
     subscribe: react_hook_form.UseFromSubscribe<TFieldValues>;
     watch: react_hook_form.UseFormWatch<TFieldValues>;
-    debugMode: "debug" | "debug-testids" | "off" | "disabled";
+    debugMode: "disabled" | "debug" | "debug-testids" | "off";
     debugModeSettings?: DebugModeSettings;
     preventSubmit: (prevent: boolean) => void;
-    setDebugMode: (debugMode: "debug" | "debug-testids" | "off" | "disabled") => void;
+    setDebugMode: (debugMode: "disabled" | "debug" | "debug-testids" | "off") => void;
     triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
     validation: {
+        baseInstance?: VetoInstance;
         instance?: VetoInstance;
         errors?: VetoFormattedError;
         setClientValidationSchema: (key: string, schema: _fuf_stack_veto.VetoTypeAny | null) => void;

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

@@ -24,12 +24,13 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     getValues: react_hook_form.UseFormGetValues<TFieldValues>;
     subscribe: react_hook_form.UseFromSubscribe<TFieldValues>;
     watch: react_hook_form.UseFormWatch<TFieldValues>;
-    debugMode: "debug" | "debug-testids" | "off" | "disabled";
+    debugMode: "disabled" | "debug" | "debug-testids" | "off";
     debugModeSettings?: DebugModeSettings;
     preventSubmit: (prevent: boolean) => void;
-    setDebugMode: (debugMode: "debug" | "debug-testids" | "off" | "disabled") => void;
+    setDebugMode: (debugMode: "disabled" | "debug" | "debug-testids" | "off") => void;
     triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
     validation: {
+        baseInstance?: VetoInstance;
         instance?: VetoInstance;
         errors?: VetoFormattedError;
         setClientValidationSchema: (key: string, schema: _fuf_stack_veto.VetoTypeAny | null) => void;

package/dist/hooks/useFormContext/index.js

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

package/dist/hooks/useUniformField/index.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkTGJJZEHBcjs = require('../../chunk-TGJJZEHB.cjs');
+var _chunkSOQ6GCN3cjs = require('../../chunk-SOQ6GCN3.cjs');
 require('../../chunk-NHEZXA4H.cjs');
 require('../../chunk-JMFDNTVC.cjs');
 require('../../chunk-PCTYJUY7.cjs');
 require('../../chunk-OE5BOGGX.cjs');
-require('../../chunk-NZBO4N3S.cjs');
+require('../../chunk-42NCLEX4.cjs');
 require('../../chunk-Z353BLWI.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
-exports.useUniformField = _chunkTGJJZEHBcjs.useUniformField;
+exports.useUniformField = _chunkSOQ6GCN3cjs.useUniformField;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useUniformField/index.js

@@ -1,11 +1,11 @@
 import {
   useUniformField
-} from "../../chunk-D3NAUOYG.js";
+} from "../../chunk-D3JYMGTB.js";
 import "../../chunk-ELYGQTXB.js";
 import "../../chunk-CK362NWK.js";
 import "../../chunk-AHJJIANM.js";
 import "../../chunk-NTDKZW4E.js";
-import "../../chunk-PO5UQAU6.js";
+import "../../chunk-NZ54JBSR.js";
 import "../../chunk-76KOVUDN.js";
 import "../../chunk-K2V4ULA2.js";
 export {

package/dist/hooks/useUniformFieldArray/index.cjs

@@ -1,15 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkAACO4OEKcjs = require('../../chunk-AACO4OEK.cjs');
-require('../../chunk-TGJJZEHB.cjs');
+var _chunkMOVNWZX5cjs = require('../../chunk-MOVNWZX5.cjs');
+require('../../chunk-SOQ6GCN3.cjs');
 require('../../chunk-NHEZXA4H.cjs');
 require('../../chunk-JMFDNTVC.cjs');
 require('../../chunk-PCTYJUY7.cjs');
 require('../../chunk-OE5BOGGX.cjs');
-require('../../chunk-NZBO4N3S.cjs');
+require('../../chunk-42NCLEX4.cjs');
 require('../../chunk-Z353BLWI.cjs');
 require('../../chunk-555JRYCS.cjs');
 
 
-exports.useUniformFieldArray = _chunkAACO4OEKcjs.useUniformFieldArray;
+exports.useUniformFieldArray = _chunkMOVNWZX5cjs.useUniformFieldArray;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useUniformFieldArray/index.js

@@ -1,12 +1,12 @@
 import {
   useUniformFieldArray
-} from "../../chunk-Z7FVILDT.js";
-import "../../chunk-D3NAUOYG.js";
+} from "../../chunk-FZQDAI7E.js";
+import "../../chunk-D3JYMGTB.js";
 import "../../chunk-ELYGQTXB.js";
 import "../../chunk-CK362NWK.js";
 import "../../chunk-AHJJIANM.js";
 import "../../chunk-NTDKZW4E.js";
-import "../../chunk-PO5UQAU6.js";
+import "../../chunk-NZ54JBSR.js";
 import "../../chunk-76KOVUDN.js";
 import "../../chunk-K2V4ULA2.js";
 export {