@page-speed/forms 0.5.2 → 0.5.4

package/dist/validation-utils.cjs

@@ -1,138 +1,48 @@
 'use strict';
 
-// src/validation/utils.ts
-function debounce(validator, options = {}) {
-  const { delay = 300, leading = false, trailing = true } = options;
-  let timeoutId = null;
-  let lastCallTime = 0;
-  let lastResult;
-  return async (value, allValues) => {
-    const now = Date.now();
-    const timeSinceLastCall = now - lastCallTime;
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-      timeoutId = null;
-    }
-    if (leading && timeSinceLastCall >= delay) {
-      lastCallTime = now;
-      lastResult = await validator(value, allValues);
-      return lastResult;
-    }
-    if (trailing) {
-      return new Promise((resolve) => {
-        timeoutId = setTimeout(async () => {
-          lastCallTime = Date.now();
-          lastResult = await validator(value, allValues);
-          resolve(lastResult);
-        }, delay);
-      });
-    }
-    return lastResult;
-  };
-}
-var defaultMessages = {
-  required: "This field is required",
-  email: "Please enter a valid email address",
-  url: "Please enter a valid URL",
-  phone: "Please enter a valid phone number",
-  minLength: ({ min }) => `Must be at least ${min} characters`,
-  maxLength: ({ max }) => `Must be no more than ${max} characters`,
-  min: ({ min }) => `Must be at least ${min}`,
-  max: ({ max }) => `Must be no more than ${max}`,
-  pattern: "Invalid format",
-  matches: ({ field }) => `Must match ${field}`,
-  oneOf: "Invalid value",
-  creditCard: "Please enter a valid credit card number",
-  postalCode: "Please enter a valid ZIP code",
-  alpha: "Must contain only letters",
-  alphanumeric: "Must contain only letters and numbers",
-  numeric: "Must be a valid number",
-  integer: "Must be a whole number"
-};
-var MessageRegistry = class {
-  constructor() {
-    this.messages = { ...defaultMessages };
-  }
-  /**
-   * Set custom messages (for i18n or customization)
-   */
-  setMessages(messages) {
-    this.messages = { ...this.messages, ...messages };
-  }
-  /**
-   * Get message by key
-   */
-  getMessage(key, params) {
-    const message = this.messages[key];
-    if (!message) {
-      return `Validation error: ${key}`;
-    }
-    if (typeof message === "function") {
-      return message(params || {});
-    }
-    return message;
-  }
-  /**
-   * Reset to default messages
-   */
-  reset() {
-    this.messages = { ...defaultMessages };
-  }
-};
-var messageRegistry = new MessageRegistry();
-function setErrorMessages(messages) {
-  messageRegistry.setMessages(messages);
-}
-function getErrorMessage(key, params) {
-  return messageRegistry.getMessage(key, params);
-}
-function resetErrorMessages() {
-  messageRegistry.reset();
-}
-function crossFieldValidator(fields, validate) {
-  return (_value, allValues) => {
-    const fieldValues = fields.reduce(
-      (acc, field) => {
-        acc[field] = allValues[field];
-        return acc;
-      },
-      {}
-    );
-    return validate(fieldValues);
-  };
-}
-function when(condition, validator) {
-  return (value, allValues) => {
-    if (condition(allValues)) {
-      return validator(value, allValues);
-    }
-    return void 0;
-  };
-}
-function withRaceConditionPrevention(validator) {
-  let latestCallId = 0;
-  return async (value, allValues) => {
-    const callId = ++latestCallId;
-    const result = await validator(value, allValues);
-    if (callId === latestCallId) {
-      return result;
-    }
-    return void 0;
-  };
-}
-function asyncValidator(validator, options = {}) {
-  return debounce(withRaceConditionPrevention(validator), options);
-}
+var chunkJBEZLX3H_cjs = require('./chunk-JBEZLX3H.cjs');
 
-exports.asyncValidator = asyncValidator;
-exports.crossFieldValidator = crossFieldValidator;
-exports.debounce = debounce;
-exports.defaultMessages = defaultMessages;
-exports.getErrorMessage = getErrorMessage;
-exports.messageRegistry = messageRegistry;
-exports.resetErrorMessages = resetErrorMessages;
-exports.setErrorMessages = setErrorMessages;
-exports.when = when;
-exports.withRaceConditionPrevention = withRaceConditionPrevention;
+
+
+Object.defineProperty(exports, "asyncValidator", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.asyncValidator; }
+});
+Object.defineProperty(exports, "crossFieldValidator", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.crossFieldValidator; }
+});
+Object.defineProperty(exports, "debounce", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.debounce; }
+});
+Object.defineProperty(exports, "defaultMessages", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.defaultMessages; }
+});
+Object.defineProperty(exports, "getErrorMessage", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.getErrorMessage; }
+});
+Object.defineProperty(exports, "messageRegistry", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.messageRegistry; }
+});
+Object.defineProperty(exports, "resetErrorMessages", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.resetErrorMessages; }
+});
+Object.defineProperty(exports, "setErrorMessages", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.setErrorMessages; }
+});
+Object.defineProperty(exports, "when", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.when; }
+});
+Object.defineProperty(exports, "withRaceConditionPrevention", {
+  enumerable: true,
+  get: function () { return chunkJBEZLX3H_cjs.withRaceConditionPrevention; }
+});
 //# sourceMappingURL=validation-utils.cjs.map
 //# sourceMappingURL=validation-utils.cjs.map

package/dist/validation-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/validation/utils.ts"],"names":[],"mappings":"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","file":"validation-utils.cjs","sourcesContent":["/**\n * @page-speed/forms - Validation Utilities\n *\n * Utilities for advanced validation scenarios\n */\n\nimport type { FieldValidator, FormValues } from \"../core/types\";\n\n/**\n * Debounce options for async validators\n */\nexport interface DebounceOptions {\n  /**\n   * Debounce delay in milliseconds\n   * @default 300\n   */\n  delay?: number;\n\n  /**\n   * Leading edge - call immediately on first invocation\n   * @default false\n   */\n  leading?: boolean;\n\n  /**\n   * Trailing edge - call after delay\n   * @default true\n   */\n  trailing?: boolean;\n}\n\n/**\n * Debounce an async validator\n * Prevents rapid validation calls (e.g., for username availability checks)\n *\n * @example\n * ```tsx\n * const checkUsername = debounce(\n *   async (value) => {\n *     const available = await api.checkUsername(value);\n *     return available ? undefined : 'Username is taken';\n *   },\n *   { delay: 500 }\n * );\n * ```\n */\nexport function debounce<T = any>(\n  validator: FieldValidator<T>,\n  options: DebounceOptions = {}\n): FieldValidator<T> {\n  const { delay = 300, leading = false, trailing = true } = options;\n\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let lastCallTime = 0;\n  let lastResult: string | undefined;\n\n  return async (value: T, allValues: FormValues) => {\n    const now = Date.now();\n    const timeSinceLastCall = now - lastCallTime;\n\n    // Clear existing timeout\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n\n    // Leading edge call\n    if (leading && timeSinceLastCall >= delay) {\n      lastCallTime = now;\n      lastResult = await validator(value, allValues);\n      return lastResult;\n    }\n\n    // Trailing edge call\n    if (trailing) {\n      return new Promise((resolve) => {\n        timeoutId = setTimeout(async () => {\n          lastCallTime = Date.now();\n          lastResult = await validator(value, allValues);\n          resolve(lastResult);\n        }, delay);\n      });\n    }\n\n    return lastResult;\n  };\n}\n\n/**\n * Error message template function\n */\nexport type MessageTemplate = (params?: any) => string;\n\n/**\n * Error message templates for internationalization\n */\nexport interface ErrorMessages {\n  [key: string]: string | MessageTemplate;\n}\n\n/**\n * Default error messages (English)\n */\nexport const defaultMessages: ErrorMessages = {\n  required: \"This field is required\",\n  email: \"Please enter a valid email address\",\n  url: \"Please enter a valid URL\",\n  phone: \"Please enter a valid phone number\",\n  minLength: ({ min }: { min: number }) =>\n    `Must be at least ${min} characters`,\n  maxLength: ({ max }: { max: number }) =>\n    `Must be no more than ${max} characters`,\n  min: ({ min }: { min: number }) => `Must be at least ${min}`,\n  max: ({ max }: { max: number }) => `Must be no more than ${max}`,\n  pattern: \"Invalid format\",\n  matches: ({ field }: { field: string }) => `Must match ${field}`,\n  oneOf: \"Invalid value\",\n  creditCard: \"Please enter a valid credit card number\",\n  postalCode: \"Please enter a valid ZIP code\",\n  alpha: \"Must contain only letters\",\n  alphanumeric: \"Must contain only letters and numbers\",\n  numeric: \"Must be a valid number\",\n  integer: \"Must be a whole number\",\n};\n\n/**\n * Error message registry for i18n support\n */\nclass MessageRegistry {\n  private messages: ErrorMessages = { ...defaultMessages };\n\n  /**\n   * Set custom messages (for i18n or customization)\n   */\n  setMessages(messages: ErrorMessages): void {\n    this.messages = { ...this.messages, ...messages };\n  }\n\n  /**\n   * Get message by key\n   */\n  getMessage(key: string, params?: Record<string, any>): string {\n    const message = this.messages[key];\n\n    if (!message) {\n      return `Validation error: ${key}`;\n    }\n\n    if (typeof message === \"function\") {\n      return message(params || {});\n    }\n\n    return message;\n  }\n\n  /**\n   * Reset to default messages\n   */\n  reset(): void {\n    this.messages = { ...defaultMessages };\n  }\n}\n\n/**\n * Global message registry instance\n */\nexport const messageRegistry = new MessageRegistry();\n\n/**\n * Set custom error messages globally\n * Useful for internationalization\n *\n * @example\n * ```tsx\n * setErrorMessages({\n *   required: 'Este campo es obligatorio',\n *   email: 'Por favor ingrese un email válido',\n * });\n * ```\n */\nexport function setErrorMessages(messages: ErrorMessages): void {\n  messageRegistry.setMessages(messages);\n}\n\n/**\n * Get error message by key\n */\nexport function getErrorMessage(\n  key: string,\n  params?: Record<string, any>\n): string {\n  return messageRegistry.getMessage(key, params);\n}\n\n/**\n * Reset error messages to defaults\n */\nexport function resetErrorMessages(): void {\n  messageRegistry.reset();\n}\n\n/**\n * Cross-field validator helper\n * Creates a validator that depends on multiple fields\n *\n * @example\n * ```tsx\n * const passwordMatch = crossFieldValidator(\n *   ['password', 'confirmPassword'],\n *   (values) => {\n *     if (values.password !== values.confirmPassword) {\n *       return 'Passwords must match';\n *     }\n *     return undefined;\n *   }\n * );\n * ```\n */\nexport function crossFieldValidator<T extends FormValues = FormValues>(\n  fields: (keyof T)[],\n  validate: (values: Pick<T, keyof T>) => string | undefined | Promise<string | undefined>\n): FieldValidator {\n  return (_value, allValues) => {\n    const fieldValues = fields.reduce(\n      (acc, field) => {\n        acc[field] = allValues[field as string];\n        return acc;\n      },\n      {} as Record<keyof T, any>\n    );\n\n    return validate(fieldValues as Pick<T, keyof T>);\n  };\n}\n\n/**\n * Conditional validator\n * Only validates when condition is met\n *\n * @example\n * ```tsx\n * const conditionalRequired = when(\n *   (values) => values.country === 'US',\n *   required()\n * );\n * ```\n */\nexport function when<T = any>(\n  condition: (allValues: FormValues) => boolean,\n  validator: FieldValidator<T>\n): FieldValidator<T> {\n  return (value, allValues) => {\n    if (condition(allValues)) {\n      return validator(value, allValues);\n    }\n    return undefined;\n  };\n}\n\n/**\n * Async validator with race condition prevention\n * Ensures only the latest validation call resolves\n *\n * @example\n * ```tsx\n * const checkUsername = withRaceConditionPrevention(\n *   async (value) => {\n *     const available = await api.checkUsername(value);\n *     return available ? undefined : 'Username is taken';\n *   }\n * );\n * ```\n */\nexport function withRaceConditionPrevention<T = any>(\n  validator: FieldValidator<T>\n): FieldValidator<T> {\n  let latestCallId = 0;\n\n  return async (value: T, allValues: FormValues) => {\n    const callId = ++latestCallId;\n\n    const result = await validator(value, allValues);\n\n    // Only return result if this is still the latest call\n    if (callId === latestCallId) {\n      return result;\n    }\n\n    // Ignore stale results\n    return undefined;\n  };\n}\n\n/**\n * Combine debounce with race condition prevention\n * Best practice for async validators\n *\n * @example\n * ```tsx\n * const checkUsername = asyncValidator(\n *   async (value) => {\n *     const available = await api.checkUsername(value);\n *     return available ? undefined : 'Username is taken';\n *   },\n *   { delay: 500 }\n * );\n * ```\n */\nexport function asyncValidator<T = any>(\n  validator: FieldValidator<T>,\n  options: DebounceOptions = {}\n): FieldValidator<T> {\n  return debounce(withRaceConditionPrevention(validator), options);\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"validation-utils.cjs"}

package/dist/validation-utils.js

@@ -1,127 +1,3 @@
-// src/validation/utils.ts
-function debounce(validator, options = {}) {
-  const { delay = 300, leading = false, trailing = true } = options;
-  let timeoutId = null;
-  let lastCallTime = 0;
-  let lastResult;
-  return async (value, allValues) => {
-    const now = Date.now();
-    const timeSinceLastCall = now - lastCallTime;
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-      timeoutId = null;
-    }
-    if (leading && timeSinceLastCall >= delay) {
-      lastCallTime = now;
-      lastResult = await validator(value, allValues);
-      return lastResult;
-    }
-    if (trailing) {
-      return new Promise((resolve) => {
-        timeoutId = setTimeout(async () => {
-          lastCallTime = Date.now();
-          lastResult = await validator(value, allValues);
-          resolve(lastResult);
-        }, delay);
-      });
-    }
-    return lastResult;
-  };
-}
-var defaultMessages = {
-  required: "This field is required",
-  email: "Please enter a valid email address",
-  url: "Please enter a valid URL",
-  phone: "Please enter a valid phone number",
-  minLength: ({ min }) => `Must be at least ${min} characters`,
-  maxLength: ({ max }) => `Must be no more than ${max} characters`,
-  min: ({ min }) => `Must be at least ${min}`,
-  max: ({ max }) => `Must be no more than ${max}`,
-  pattern: "Invalid format",
-  matches: ({ field }) => `Must match ${field}`,
-  oneOf: "Invalid value",
-  creditCard: "Please enter a valid credit card number",
-  postalCode: "Please enter a valid ZIP code",
-  alpha: "Must contain only letters",
-  alphanumeric: "Must contain only letters and numbers",
-  numeric: "Must be a valid number",
-  integer: "Must be a whole number"
-};
-var MessageRegistry = class {
-  constructor() {
-    this.messages = { ...defaultMessages };
-  }
-  /**
-   * Set custom messages (for i18n or customization)
-   */
-  setMessages(messages) {
-    this.messages = { ...this.messages, ...messages };
-  }
-  /**
-   * Get message by key
-   */
-  getMessage(key, params) {
-    const message = this.messages[key];
-    if (!message) {
-      return `Validation error: ${key}`;
-    }
-    if (typeof message === "function") {
-      return message(params || {});
-    }
-    return message;
-  }
-  /**
-   * Reset to default messages
-   */
-  reset() {
-    this.messages = { ...defaultMessages };
-  }
-};
-var messageRegistry = new MessageRegistry();
-function setErrorMessages(messages) {
-  messageRegistry.setMessages(messages);
-}
-function getErrorMessage(key, params) {
-  return messageRegistry.getMessage(key, params);
-}
-function resetErrorMessages() {
-  messageRegistry.reset();
-}
-function crossFieldValidator(fields, validate) {
-  return (_value, allValues) => {
-    const fieldValues = fields.reduce(
-      (acc, field) => {
-        acc[field] = allValues[field];
-        return acc;
-      },
-      {}
-    );
-    return validate(fieldValues);
-  };
-}
-function when(condition, validator) {
-  return (value, allValues) => {
-    if (condition(allValues)) {
-      return validator(value, allValues);
-    }
-    return void 0;
-  };
-}
-function withRaceConditionPrevention(validator) {
-  let latestCallId = 0;
-  return async (value, allValues) => {
-    const callId = ++latestCallId;
-    const result = await validator(value, allValues);
-    if (callId === latestCallId) {
-      return result;
-    }
-    return void 0;
-  };
-}
-function asyncValidator(validator, options = {}) {
-  return debounce(withRaceConditionPrevention(validator), options);
-}
-
-export { asyncValidator, crossFieldValidator, debounce, defaultMessages, getErrorMessage, messageRegistry, resetErrorMessages, setErrorMessages, when, withRaceConditionPrevention };
+export { asyncValidator, crossFieldValidator, debounce, defaultMessages, getErrorMessage, messageRegistry, resetErrorMessages, setErrorMessages, when, withRaceConditionPrevention } from './chunk-H6NNFV64.js';
 //# sourceMappingURL=validation-utils.js.map
 //# sourceMappingURL=validation-utils.js.map

package/dist/validation-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/validation/utils.ts"],"names":[],"mappings":"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","file":"validation-utils.js","sourcesContent":["/**\n * @page-speed/forms - Validation Utilities\n *\n * Utilities for advanced validation scenarios\n */\n\nimport type { FieldValidator, FormValues } from \"../core/types\";\n\n/**\n * Debounce options for async validators\n */\nexport interface DebounceOptions {\n  /**\n   * Debounce delay in milliseconds\n   * @default 300\n   */\n  delay?: number;\n\n  /**\n   * Leading edge - call immediately on first invocation\n   * @default false\n   */\n  leading?: boolean;\n\n  /**\n   * Trailing edge - call after delay\n   * @default true\n   */\n  trailing?: boolean;\n}\n\n/**\n * Debounce an async validator\n * Prevents rapid validation calls (e.g., for username availability checks)\n *\n * @example\n * ```tsx\n * const checkUsername = debounce(\n *   async (value) => {\n *     const available = await api.checkUsername(value);\n *     return available ? undefined : 'Username is taken';\n *   },\n *   { delay: 500 }\n * );\n * ```\n */\nexport function debounce<T = any>(\n  validator: FieldValidator<T>,\n  options: DebounceOptions = {}\n): FieldValidator<T> {\n  const { delay = 300, leading = false, trailing = true } = options;\n\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let lastCallTime = 0;\n  let lastResult: string | undefined;\n\n  return async (value: T, allValues: FormValues) => {\n    const now = Date.now();\n    const timeSinceLastCall = now - lastCallTime;\n\n    // Clear existing timeout\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n\n    // Leading edge call\n    if (leading && timeSinceLastCall >= delay) {\n      lastCallTime = now;\n      lastResult = await validator(value, allValues);\n      return lastResult;\n    }\n\n    // Trailing edge call\n    if (trailing) {\n      return new Promise((resolve) => {\n        timeoutId = setTimeout(async () => {\n          lastCallTime = Date.now();\n          lastResult = await validator(value, allValues);\n          resolve(lastResult);\n        }, delay);\n      });\n    }\n\n    return lastResult;\n  };\n}\n\n/**\n * Error message template function\n */\nexport type MessageTemplate = (params?: any) => string;\n\n/**\n * Error message templates for internationalization\n */\nexport interface ErrorMessages {\n  [key: string]: string | MessageTemplate;\n}\n\n/**\n * Default error messages (English)\n */\nexport const defaultMessages: ErrorMessages = {\n  required: \"This field is required\",\n  email: \"Please enter a valid email address\",\n  url: \"Please enter a valid URL\",\n  phone: \"Please enter a valid phone number\",\n  minLength: ({ min }: { min: number }) =>\n    `Must be at least ${min} characters`,\n  maxLength: ({ max }: { max: number }) =>\n    `Must be no more than ${max} characters`,\n  min: ({ min }: { min: number }) => `Must be at least ${min}`,\n  max: ({ max }: { max: number }) => `Must be no more than ${max}`,\n  pattern: \"Invalid format\",\n  matches: ({ field }: { field: string }) => `Must match ${field}`,\n  oneOf: \"Invalid value\",\n  creditCard: \"Please enter a valid credit card number\",\n  postalCode: \"Please enter a valid ZIP code\",\n  alpha: \"Must contain only letters\",\n  alphanumeric: \"Must contain only letters and numbers\",\n  numeric: \"Must be a valid number\",\n  integer: \"Must be a whole number\",\n};\n\n/**\n * Error message registry for i18n support\n */\nclass MessageRegistry {\n  private messages: ErrorMessages = { ...defaultMessages };\n\n  /**\n   * Set custom messages (for i18n or customization)\n   */\n  setMessages(messages: ErrorMessages): void {\n    this.messages = { ...this.messages, ...messages };\n  }\n\n  /**\n   * Get message by key\n   */\n  getMessage(key: string, params?: Record<string, any>): string {\n    const message = this.messages[key];\n\n    if (!message) {\n      return `Validation error: ${key}`;\n    }\n\n    if (typeof message === \"function\") {\n      return message(params || {});\n    }\n\n    return message;\n  }\n\n  /**\n   * Reset to default messages\n   */\n  reset(): void {\n    this.messages = { ...defaultMessages };\n  }\n}\n\n/**\n * Global message registry instance\n */\nexport const messageRegistry = new MessageRegistry();\n\n/**\n * Set custom error messages globally\n * Useful for internationalization\n *\n * @example\n * ```tsx\n * setErrorMessages({\n *   required: 'Este campo es obligatorio',\n *   email: 'Por favor ingrese un email válido',\n * });\n * ```\n */\nexport function setErrorMessages(messages: ErrorMessages): void {\n  messageRegistry.setMessages(messages);\n}\n\n/**\n * Get error message by key\n */\nexport function getErrorMessage(\n  key: string,\n  params?: Record<string, any>\n): string {\n  return messageRegistry.getMessage(key, params);\n}\n\n/**\n * Reset error messages to defaults\n */\nexport function resetErrorMessages(): void {\n  messageRegistry.reset();\n}\n\n/**\n * Cross-field validator helper\n * Creates a validator that depends on multiple fields\n *\n * @example\n * ```tsx\n * const passwordMatch = crossFieldValidator(\n *   ['password', 'confirmPassword'],\n *   (values) => {\n *     if (values.password !== values.confirmPassword) {\n *       return 'Passwords must match';\n *     }\n *     return undefined;\n *   }\n * );\n * ```\n */\nexport function crossFieldValidator<T extends FormValues = FormValues>(\n  fields: (keyof T)[],\n  validate: (values: Pick<T, keyof T>) => string | undefined | Promise<string | undefined>\n): FieldValidator {\n  return (_value, allValues) => {\n    const fieldValues = fields.reduce(\n      (acc, field) => {\n        acc[field] = allValues[field as string];\n        return acc;\n      },\n      {} as Record<keyof T, any>\n    );\n\n    return validate(fieldValues as Pick<T, keyof T>);\n  };\n}\n\n/**\n * Conditional validator\n * Only validates when condition is met\n *\n * @example\n * ```tsx\n * const conditionalRequired = when(\n *   (values) => values.country === 'US',\n *   required()\n * );\n * ```\n */\nexport function when<T = any>(\n  condition: (allValues: FormValues) => boolean,\n  validator: FieldValidator<T>\n): FieldValidator<T> {\n  return (value, allValues) => {\n    if (condition(allValues)) {\n      return validator(value, allValues);\n    }\n    return undefined;\n  };\n}\n\n/**\n * Async validator with race condition prevention\n * Ensures only the latest validation call resolves\n *\n * @example\n * ```tsx\n * const checkUsername = withRaceConditionPrevention(\n *   async (value) => {\n *     const available = await api.checkUsername(value);\n *     return available ? undefined : 'Username is taken';\n *   }\n * );\n * ```\n */\nexport function withRaceConditionPrevention<T = any>(\n  validator: FieldValidator<T>\n): FieldValidator<T> {\n  let latestCallId = 0;\n\n  return async (value: T, allValues: FormValues) => {\n    const callId = ++latestCallId;\n\n    const result = await validator(value, allValues);\n\n    // Only return result if this is still the latest call\n    if (callId === latestCallId) {\n      return result;\n    }\n\n    // Ignore stale results\n    return undefined;\n  };\n}\n\n/**\n * Combine debounce with race condition prevention\n * Best practice for async validators\n *\n * @example\n * ```tsx\n * const checkUsername = asyncValidator(\n *   async (value) => {\n *     const available = await api.checkUsername(value);\n *     return available ? undefined : 'Username is taken';\n *   },\n *   { delay: 500 }\n * );\n * ```\n */\nexport function asyncValidator<T = any>(\n  validator: FieldValidator<T>,\n  options: DebounceOptions = {}\n): FieldValidator<T> {\n  return debounce(withRaceConditionPrevention(validator), options);\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"validation-utils.js"}