@page-speed/forms 0.1.4 → 0.1.6

package/dist/validation-utils.cjs

@@ -1,48 +1,138 @@
 'use strict';
 
-var chunkP37YLBFA_cjs = require('./chunk-P37YLBFA.cjs');
+// 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);
+}
 
-
-
-Object.defineProperty(exports, "asyncValidator", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.asyncValidator; }
-});
-Object.defineProperty(exports, "crossFieldValidator", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.crossFieldValidator; }
-});
-Object.defineProperty(exports, "debounce", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.debounce; }
-});
-Object.defineProperty(exports, "defaultMessages", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.defaultMessages; }
-});
-Object.defineProperty(exports, "getErrorMessage", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.getErrorMessage; }
-});
-Object.defineProperty(exports, "messageRegistry", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.messageRegistry; }
-});
-Object.defineProperty(exports, "resetErrorMessages", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.resetErrorMessages; }
-});
-Object.defineProperty(exports, "setErrorMessages", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.setErrorMessages; }
-});
-Object.defineProperty(exports, "when", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.when; }
-});
-Object.defineProperty(exports, "withRaceConditionPrevention", {
-  enumerable: true,
-  get: function () { return chunkP37YLBFA_cjs.withRaceConditionPrevention; }
-});
+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;
 //# sourceMappingURL=validation-utils.cjs.map
 //# sourceMappingURL=validation-utils.cjs.map

package/dist/validation-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"validation-utils.cjs"}
+{"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"]}

package/dist/validation-utils.js

@@ -1,3 +1,127 @@
-export { asyncValidator, crossFieldValidator, debounce, defaultMessages, getErrorMessage, messageRegistry, resetErrorMessages, setErrorMessages, when, withRaceConditionPrevention } from './chunk-WHQMBQNI.js';
+// 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 };
 //# sourceMappingURL=validation-utils.js.map
 //# sourceMappingURL=validation-utils.js.map

package/dist/validation-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"validation-utils.js"}
+{"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"]}