@fuf-stack/uniform 1.10.3 → 1.11.0

package/dist/helpers-KTgXi0lA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-KTgXi0lA.cjs","names":["cleanName: string"],"sources":["../src/helpers/nullishFields/nullishFields.ts"],"sourcesContent":["import { slugify } from '@fuf-stack/pixel-utils';\n\n/** Key used to wrap flat array elements when converting to form format */\nexport const flatArrayKey = '__FLAT__';\n\n/**\n * String markers used to preserve null, false, and 0 values during JSON processing\n */\nconst nullString = '__NULL__';\nconst falseString = '__FALSE__';\nconst zeroString = '__ZERO__';\n\n/**\n * Converts marker strings back to their original values when processing arrays\n */\nexport const fromNullishString = (value: unknown): unknown => {\n  // Support arrays: unwrap flat wrappers and convert marker strings per entry\n  if (Array.isArray(value)) {\n    return (value as unknown[]).map((entry) => {\n      if (entry && typeof entry === 'object') {\n        const record = entry as Record<string, unknown>;\n        if (flatArrayKey in record) {\n          const inner = record[flatArrayKey];\n          // For arrays, treat empty string as null (placeholder input)\n          if (inner === '') {\n            return null;\n          }\n          return fromNullishString(inner);\n        }\n      }\n      return fromNullishString(entry);\n    });\n  }\n\n  if (typeof value !== 'string') {\n    return value;\n  }\n\n  switch (value) {\n    case nullString:\n      return null;\n    case falseString:\n      return false;\n    case zeroString:\n      return 0;\n    default:\n      return value;\n  }\n};\n\n/**\n * Converts null/falsy values to marker strings for JSON processing\n */\nexport const toNullishString = (value: unknown): unknown => {\n  if (Array.isArray(value)) {\n    // Only wrap arrays of primitives; leave arrays of objects as-is\n    const isPrimitive = (v: unknown) => {\n      return v === null || ['string', 'number', 'boolean'].includes(typeof v);\n    };\n    const isPrimitiveArray = (value as unknown[]).every(isPrimitive);\n    if (isPrimitiveArray) {\n      return (value as unknown[]).map((v) => {\n        // Store raw primitive; do not convert to marker strings inside the wrapper\n        return { [flatArrayKey]: v } as Record<string, unknown>;\n      });\n    }\n    return value;\n  }\n  if (value === null || value === '') {\n    return nullString;\n  }\n  if (value === false) {\n    return falseString;\n  }\n  if (value === 0) {\n    return zeroString;\n  }\n  return value;\n};\n\n/**\n * Converts field values to a format suitable for forms by:\n * - Wrapping arrays of primitives as objects using the flatArrayKey `__FLAT__`\n *   to satisfy RHF's requirement that array fields contain objects\n * - Removing empty strings and null values from objects\n *\n * This conversion is required because React Hook Form does not support arrays with\n * flat values (string, number, boolean, null). Array fields must contain objects.\n * We work around this by wrapping primitive entries: `{ __FLAT__: <value> }`.\n *\n * @example\n * const fields = {\n *   name: 'John',\n *   scores: [0, null, 75, false],\n *   scoresDetailed: [\n *     { score: 1 },\n *     { score: null },\n *     { score: 0 },\n *     { score: false },\n *     { score: '' },\n *   ],\n *   contact: {\n *     email: '',\n *     phone: null,\n *     address: '123 Main St'\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: 75 },\n *     { __FLAT__: false }\n *   ],\n *   // Arrays of objects are left as objects; empty/null properties are removed\n *   scoresDetailed: [\n *     { score: 1 },\n *     {}, // null score removed\n *     { score: 0 },\n *     { score: false },\n *     {}, // empty string removed\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toFormFormat = (fields: Record<string, unknown>) => {\n  const formFormatJson = JSON.stringify(fields, (_, value) => {\n    if (Array.isArray(value)) {\n      // Delegate to toNullishString to ensure consistent handling\n      return toNullishString(value);\n    }\n\n    if (value && typeof value === 'object') {\n      // Preserve flat-array wrappers as-is (do not filter their inner values here)\n      const record = value as Record<string, unknown>;\n      if (flatArrayKey in record) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return value;\n      }\n      return Object.fromEntries(\n        Object.entries(value).filter(([_key, v]) => {\n          return v !== '' && v !== null;\n        }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(formFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts form state to a format suitable for validation by:\n * - Unwrapping flat array wrappers `{ __FLAT__: <value> }` back to primitives\n * - Converting legacy string markers (__NULL__, __FALSE__, __ZERO__) back to their original values\n * - Removing fields whose converted value is empty string or null\n * - Removing empty arrays\n *\n * @example\n * const formState = {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 75 },\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: false }\n *   ],\n *   emptyArray: [],\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St',\n *     fax: null\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [75, 0, null, false],\n *   // emptyArray is removed\n *   // Objects inside arrays remain objects; empty entries remain empty objects\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toValidationFormat = (\n  formState: Record<string, unknown> | null | undefined,\n): Record<string, unknown> | null | undefined => {\n  // Handle null or undefined input\n  if (formState === undefined || formState === null) {\n    return formState;\n  }\n\n  const validationFormatJson = JSON.stringify(formState, (_, value) => {\n    if (Array.isArray(value)) {\n      return value.map((v) => {\n        // Unwrap new wrapper format { __FLAT__: <value> }\n        if (v && typeof v === 'object') {\n          const record = v as Record<string, unknown>;\n          if (flatArrayKey in record) {\n            const inner = record[flatArrayKey];\n            // Treat empty string from forms as null in validation format\n            if (inner === '') {\n              return null;\n            }\n            return fromNullishString(inner);\n          }\n        }\n        // Backward compatibility for string markers\n        return fromNullishString(v);\n      });\n    }\n\n    if (value && typeof value === 'object') {\n      // Object branch: remove keys that resolve to empty/null after marker conversion\n      // and unwrap flat-array wrappers if present.\n      //\n      // Why this shape?\n      // - Forms may contain objects with placeholder/empty values that should not\n      //   be part of the validation payload (e.g. \"\" or __NULL__ markers).\n      // - Arrays of primitives are stored as wrapper objects { __FLAT__: <value> }\n      //   to satisfy RHF structure constraints. When converting back for\n      //   validation, we need to treat wrappers whose inner value resolves to\n      //   empty/null as removable, and unwrap non-empty wrappers to the primitive.\n      return Object.fromEntries(\n        Object.entries(value)\n          .filter(([_key, v]) => {\n            // If this is a flat-array wrapper, convert the inner value first and\n            // drop the key when the inner resolves to empty string or null.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                const convertedInner = fromNullishString(record[flatArrayKey]);\n                return convertedInner !== '' && convertedInner !== null;\n              }\n            }\n            // Drop empty arrays\n            if (Array.isArray(v) && v.length === 0) {\n              return false;\n            }\n            // For regular values, convert markers and drop when empty/null.\n            const converted = fromNullishString(v);\n            return converted !== '' && converted !== null;\n          })\n          .map(([k, v]) => {\n            // Unwrap flat-array wrappers to raw primitives after conversion.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                return [k, fromNullishString(record[flatArrayKey])];\n              }\n            }\n            // For other values, just convert markers.\n            return [k, fromNullishString(v)];\n          }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(validationFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts a field name to a testId by removing flat array key segments and slugifying.\n * Removes all occurrences of `flatArrayKey` from the field name and applies slugify transformation.\n *\n * This is used to generate stable testIds for form fields that don't include\n * the internal `__FLAT__` marker used for flat arrays.\n *\n * @param name - The field name as a string (e.g., 'tags.0.__FLAT__') or array path (e.g., ['tags', '0', '__FLAT__'])\n * @returns The slugified field name with all flat array key segments removed (e.g., 'tags_0')\n *\n * @example\n * ```ts\n * nameToTestId('tags.0.__FLAT__') // => 'tags_0'\n * nameToTestId('array.0.__FLAT__') // => 'array_0'\n * nameToTestId('nested.array.0.__FLAT__.field') // => 'nested_array_0_field'\n * nameToTestId('simple.field') // => 'simple_field'\n * nameToTestId(['tags', '0', '__FLAT__']) // => 'tags_0'\n * ```\n */\nexport const nameToTestId = (name: string | readonly string[]): string => {\n  let cleanName: string;\n\n  // Handle array paths - filter out flatArrayKey and join with dots\n  if (Array.isArray(name)) {\n    cleanName = name\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  } else {\n    // Handle string paths - split by dots and filter out flatArrayKey segments\n    const segments = (name as string).split('.');\n    cleanName = segments\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  }\n\n  // Apply slugify transformation\n  return slugify(cleanName, { replaceDots: true });\n};\n"],"mappings":"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"}

package/dist/hooks/useClientValidation/index.cjs

@@ -1,13 +1,9 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+const require_useClientValidation = require('../../useClientValidation-oZd4_ocQ.cjs');
 
+//#region src/hooks/useClientValidation/index.ts
+/* v8 ignore stop */
 
-var _chunk2UQCRQEJcjs = require('../../chunk-2UQCRQEJ.cjs');
-require('../../chunk-FYN7ZWLW.cjs');
-require('../../chunk-AQJLKHAE.cjs');
-require('../../chunk-OKJWLH7T.cjs');
-require('../../chunk-555JRYCS.cjs');
-
-
-
-exports.clientValidationSchemaByName = _chunk2UQCRQEJcjs.clientValidationSchemaByName; exports.useClientValidation = _chunk2UQCRQEJcjs.useClientValidation;
+//#endregion
+exports.clientValidationSchemaByName = require_useClientValidation.clientValidationSchemaByName;
+exports.useClientValidation = require_useClientValidation.useClientValidation;
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useClientValidation/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACA;AACF,2JAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useClientValidation/index.cjs"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/hooks/useClientValidation/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useClientValidation';\n\n/* v8 ignore stop */\n"],"mappings":""}

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

@@ -1,147 +1,2 @@
-import * as _fuf_stack_veto_dist_types_d_CSVd_Qmh from '@fuf-stack/veto/dist/types.d-CSVd_Qmh';
-import { VetoTypeAny } from '@fuf-stack/veto';
-
-/**
- * Hook for adding dynamic client-side validation to forms.
- *
- * 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")
- *
- * 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. 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
- * // 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.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, 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`
- *
- * 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
- * // 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 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 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
- * // 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_CSVd_Qmh.Z;
-
-export { clientValidationSchemaByName, useClientValidation };
+import { n as useClientValidation, t as clientValidationSchemaByName } from "../../useClientValidation-C3Q5UCy9.cjs";
+export { clientValidationSchemaByName, useClientValidation };

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

@@ -1,147 +1,2 @@
-import * as _fuf_stack_veto_dist_types_d_CSVd_Qmh from '@fuf-stack/veto/dist/types.d-CSVd_Qmh';
-import { VetoTypeAny } from '@fuf-stack/veto';
-
-/**
- * Hook for adding dynamic client-side validation to forms.
- *
- * 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")
- *
- * 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. 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
- * // 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.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, 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`
- *
- * 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
- * // 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 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 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
- * // 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_CSVd_Qmh.Z;
-
-export { clientValidationSchemaByName, useClientValidation };
+import { n as useClientValidation, t as clientValidationSchemaByName } from "../../useClientValidation-CkBtUSco.js";
+export { clientValidationSchemaByName, useClientValidation };

package/dist/hooks/useClientValidation/index.js

@@ -1,13 +1,8 @@
-import {
-  clientValidationSchemaByName,
-  useClientValidation
-} from "../../chunk-26VE4IGU.js";
-import "../../chunk-SJWL6EMI.js";
-import "../../chunk-IV45K4WU.js";
-import "../../chunk-O2XJNQQK.js";
-import "../../chunk-K2V4ULA2.js";
-export {
-  clientValidationSchemaByName,
-  useClientValidation
-};
+import { n as useClientValidation, t as clientValidationSchemaByName } from "../../useClientValidation-BnnscAEe.js";
+
+//#region src/hooks/useClientValidation/index.ts
+/* v8 ignore stop */
+
+//#endregion
+export { clientValidationSchemaByName, useClientValidation };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/useClientValidation/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useClientValidation';\n\n/* v8 ignore stop */\n"],"mappings":""}

package/dist/hooks/useController/index.cjs

@@ -1,10 +1,8 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+const require_useController = require('../../useController-BzkCcbSo.cjs');
 
-var _chunk6AWHOBNLcjs = require('../../chunk-6AWHOBNL.cjs');
-require('../../chunk-AQJLKHAE.cjs');
-require('../../chunk-OKJWLH7T.cjs');
-require('../../chunk-555JRYCS.cjs');
+//#region src/hooks/useController/index.ts
+/* v8 ignore stop */
 
-
-exports.useController = _chunk6AWHOBNLcjs.useController;
+//#endregion
+exports.useController = require_useController.useController;
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useController/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,4DAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC,oCAAiC;AACjC;AACE;AACF,wDAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/useController/index.cjs"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/hooks/useController/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useController';\n\n/* v8 ignore stop */\n"],"mappings":""}

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

@@ -1,29 +1,2 @@
-import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState } from 'react-hook-form';
-
-type UseControllerProps<TFieldValues extends object = object> = UseControllerProps$1<TFieldValues>;
-interface UseControllerReturn<TFieldValues extends object = object> {
-    field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {
-        onChange: (...event: any[]) => void;
-        value: string;
-    };
-    formState: UseFormStateReturn<TFieldValues>;
-    fieldState: ControllerFieldState;
-}
-/**
- * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.
- *
- * Key features:
- * 1. Empty strings ('') in the UI are stored as null in form state
- * 2. Null/undefined values in form state are displayed as empty strings in the UI
- * 3. Handles both direct value changes and React synthetic events
- * 4. Maintains the same API as react-hook-form's useController
- * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)
- *
- * This enables consistent handling of empty/null values while keeping a clean API
- * for form inputs that expect string values.
- *
- * @see https://react-hook-form.com/docs/usecontroller
- */
-declare const useController: <TFieldValues extends object = object>(props: UseControllerProps<TFieldValues>) => UseControllerReturn<TFieldValues>;
-
-export { type UseControllerProps, type UseControllerReturn, useController };
+import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "../../useController-C_MZLZIp.cjs";
+export { UseControllerProps, UseControllerReturn, useController };

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

@@ -1,29 +1,3 @@
-import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState } from 'react-hook-form';
-
-type UseControllerProps<TFieldValues extends object = object> = UseControllerProps$1<TFieldValues>;
-interface UseControllerReturn<TFieldValues extends object = object> {
-    field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {
-        onChange: (...event: any[]) => void;
-        value: string;
-    };
-    formState: UseFormStateReturn<TFieldValues>;
-    fieldState: ControllerFieldState;
-}
-/**
- * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.
- *
- * Key features:
- * 1. Empty strings ('') in the UI are stored as null in form state
- * 2. Null/undefined values in form state are displayed as empty strings in the UI
- * 3. Handles both direct value changes and React synthetic events
- * 4. Maintains the same API as react-hook-form's useController
- * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)
- *
- * This enables consistent handling of empty/null values while keeping a clean API
- * for form inputs that expect string values.
- *
- * @see https://react-hook-form.com/docs/usecontroller
- */
-declare const useController: <TFieldValues extends object = object>(props: UseControllerProps<TFieldValues>) => UseControllerReturn<TFieldValues>;
-
-export { type UseControllerProps, type UseControllerReturn, useController };
+import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "../../useController-hjpJQf0w.js";
+import "../../index-B3Z8gdjC.js";
+export { UseControllerProps, UseControllerReturn, useController };

package/dist/hooks/useController/index.js

@@ -1,10 +1,8 @@
-import {
-  useController
-} from "../../chunk-5MTIQ6WD.js";
-import "../../chunk-IV45K4WU.js";
-import "../../chunk-O2XJNQQK.js";
-import "../../chunk-K2V4ULA2.js";
-export {
-  useController
-};
+import { t as useController } from "../../useController-CumIERks.js";
+
+//#region src/hooks/useController/index.ts
+/* v8 ignore stop */
+
+//#endregion
+export { useController };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/useController/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useController';\n\n/* v8 ignore stop */\n"],"mappings":""}

package/dist/hooks/useFormContext/index.cjs

@@ -1,13 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../../chunk-3JAVQAL5.cjs');
+const require_useFormContext = require('../../useFormContext-CWuN-_7P.cjs');
 
-
-
-var _chunkFYN7ZWLWcjs = require('../../chunk-FYN7ZWLW.cjs');
-require('../../chunk-AQJLKHAE.cjs');
-require('../../chunk-OKJWLH7T.cjs');
-require('../../chunk-555JRYCS.cjs');
-
-
-
-exports.checkFieldIsRequired = _chunkFYN7ZWLWcjs.checkFieldIsRequired; exports.useFormContext = _chunkFYN7ZWLWcjs.useFormContext;
-//# sourceMappingURL=index.cjs.map
+exports.checkFieldIsRequired = require_useFormContext.checkFieldIsRequired;
+exports.useFormContext = require_useFormContext.useFormContext;

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

@@ -1,62 +1,2 @@
-import * as _fuf_stack_veto from '@fuf-stack/veto';
-import { VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
-import * as React from 'react';
-import { D as DebugModeSettings, U as UserChangeListener } from '../../FormContext-9Firwt4k.cjs';
-import * as react_hook_form from 'react-hook-form';
-import { FieldValues, Path, FieldError } from 'react-hook-form';
-
-/** Schema check whether a field is required or optional */
-declare const checkFieldIsRequired: (validation: VetoInstance, path: string[]) => boolean;
-/**
- * Custom hook that extends react-hook-form's useFormContext to add validation and state management.
- *
- * Key features:
- * - Enhanced `getFieldState` that includes validation schema-based "required" status and testId generation
- * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:
- *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)
- *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)
- *   - Filters out empty/null values
- */
-declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>() => {
-    formState: react_hook_form.FormState<TFieldValues>;
-    getFieldState: (name: Path<TFieldValues>, testId?: string) => {
-        error: FieldError[] | undefined;
-        invalid: boolean;
-        required: boolean;
-        testId: string;
-        isDirty: boolean;
-        isTouched: boolean;
-        isValidating: boolean;
-    };
-    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
-    subscribe: react_hook_form.UseFormSubscribe<TFieldValues>;
-    watch: react_hook_form.UseFormWatch<TFieldValues>;
-    debugMode: "disabled" | "debug" | "debug-testids" | "off";
-    debugModeSettings?: DebugModeSettings;
-    preventSubmit: (prevent: boolean) => void;
-    setDebugMode: (debugMode: "disabled" | "debug" | "debug-testids" | "off") => void;
-    triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
-    userChange: {
-        subscribe: (listener: UserChangeListener) => () => void;
-        notify: (fieldName: string, value: unknown) => void;
-    };
-    validation: {
-        baseInstance?: VetoInstance;
-        instance?: VetoInstance;
-        errors?: VetoFormattedError;
-        setClientValidationSchema: (key: string, schema: _fuf_stack_veto.VetoTypeAny | null) => void;
-    };
-    setError: react_hook_form.UseFormSetError<TFieldValues>;
-    clearErrors: react_hook_form.UseFormClearErrors<TFieldValues>;
-    setValue: react_hook_form.UseFormSetValue<TFieldValues>;
-    trigger: react_hook_form.UseFormTrigger<TFieldValues>;
-    resetField: react_hook_form.UseFormResetField<TFieldValues>;
-    reset: react_hook_form.UseFormReset<TFieldValues>;
-    handleSubmit: react_hook_form.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
-    unregister: react_hook_form.UseFormUnregister<TFieldValues>;
-    control: react_hook_form.Control<TFieldValues, TContext, TTransformedValues>;
-    register: react_hook_form.UseFormRegister<TFieldValues>;
-    setFocus: react_hook_form.UseFormSetFocus<TFieldValues>;
-};
-
-export { checkFieldIsRequired, useFormContext };
+import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-CZh7pv8f.cjs";
+export { checkFieldIsRequired, useFormContext };

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

@@ -1,62 +1,4 @@
-import * as _fuf_stack_veto from '@fuf-stack/veto';
-import { VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
-import * as React from 'react';
-import { D as DebugModeSettings, U as UserChangeListener } from '../../FormContext-9Firwt4k.js';
-import * as react_hook_form from 'react-hook-form';
-import { FieldValues, Path, FieldError } from 'react-hook-form';
-
-/** Schema check whether a field is required or optional */
-declare const checkFieldIsRequired: (validation: VetoInstance, path: string[]) => boolean;
-/**
- * Custom hook that extends react-hook-form's useFormContext to add validation and state management.
- *
- * Key features:
- * - Enhanced `getFieldState` that includes validation schema-based "required" status and testId generation
- * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:
- *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)
- *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)
- *   - Filters out empty/null values
- */
-declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>() => {
-    formState: react_hook_form.FormState<TFieldValues>;
-    getFieldState: (name: Path<TFieldValues>, testId?: string) => {
-        error: FieldError[] | undefined;
-        invalid: boolean;
-        required: boolean;
-        testId: string;
-        isDirty: boolean;
-        isTouched: boolean;
-        isValidating: boolean;
-    };
-    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
-    subscribe: react_hook_form.UseFormSubscribe<TFieldValues>;
-    watch: react_hook_form.UseFormWatch<TFieldValues>;
-    debugMode: "disabled" | "debug" | "debug-testids" | "off";
-    debugModeSettings?: DebugModeSettings;
-    preventSubmit: (prevent: boolean) => void;
-    setDebugMode: (debugMode: "disabled" | "debug" | "debug-testids" | "off") => void;
-    triggerSubmit: (e?: React.BaseSyntheticEvent) => Promise<void> | void;
-    userChange: {
-        subscribe: (listener: UserChangeListener) => () => void;
-        notify: (fieldName: string, value: unknown) => void;
-    };
-    validation: {
-        baseInstance?: VetoInstance;
-        instance?: VetoInstance;
-        errors?: VetoFormattedError;
-        setClientValidationSchema: (key: string, schema: _fuf_stack_veto.VetoTypeAny | null) => void;
-    };
-    setError: react_hook_form.UseFormSetError<TFieldValues>;
-    clearErrors: react_hook_form.UseFormClearErrors<TFieldValues>;
-    setValue: react_hook_form.UseFormSetValue<TFieldValues>;
-    trigger: react_hook_form.UseFormTrigger<TFieldValues>;
-    resetField: react_hook_form.UseFormResetField<TFieldValues>;
-    reset: react_hook_form.UseFormReset<TFieldValues>;
-    handleSubmit: react_hook_form.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
-    unregister: react_hook_form.UseFormUnregister<TFieldValues>;
-    control: react_hook_form.Control<TFieldValues, TContext, TTransformedValues>;
-    register: react_hook_form.UseFormRegister<TFieldValues>;
-    setFocus: react_hook_form.UseFormSetFocus<TFieldValues>;
-};
-
-export { checkFieldIsRequired, useFormContext };
+import "../../FormContext-C2_WMi_v.js";
+import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-3AAPT6eZ.js";
+import "../../index-CJNLQVjx.js";
+export { checkFieldIsRequired, useFormContext };