@page-speed/forms 0.1.4 → 0.1.6

package/dist/validation.js

@@ -1,4 +1,341 @@
-export { alpha, alphanumeric, compose, creditCard, email, integer, matches, max, maxLength, min, minLength, numeric, oneOf, pattern, phone, postalCode, required, url } from './chunk-YTTOWHBZ.js';
-export { asyncValidator, crossFieldValidator, debounce, defaultMessages, getErrorMessage, messageRegistry, resetErrorMessages, setErrorMessages, when, withRaceConditionPrevention } from './chunk-WHQMBQNI.js';
+// src/validation/rules.ts
+function required(options = {}) {
+  const defaultMessage = "This field is required";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  return (value) => {
+    if (value === void 0 || value === null || value === "") {
+      return message;
+    }
+    if (Array.isArray(value) && value.length === 0) {
+      return message;
+    }
+    if (typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) {
+      return message;
+    }
+    return void 0;
+  };
+}
+function email(options = {}) {
+  const defaultMessage = "Please enter a valid email address";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    if (!emailRegex.test(value)) return message;
+    return void 0;
+  };
+}
+function url(options = {}) {
+  const defaultMessage = "Please enter a valid URL";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    try {
+      new URL(value);
+      return void 0;
+    } catch {
+      return message;
+    }
+  };
+}
+function phone(options = {}) {
+  const defaultMessage = "Please enter a valid phone number";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  const phoneRegex = /^[\+]?[(]?[0-9]{3}[)]?[-\s\.]?[0-9]{3}[-\s\.]?[0-9]{4,6}$/;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    const cleaned = value.replace(/[^\d+]/g, "");
+    if (!phoneRegex.test(cleaned)) return message;
+    return void 0;
+  };
+}
+function minLength(min2, options = {}) {
+  const defaultMessage = (p) => `Must be at least ${p.min} characters`;
+  const message = typeof options.message === "function" ? options.message({ min: min2 }) : options.message || defaultMessage({ min: min2 });
+  return (value) => {
+    if (!value) return void 0;
+    const length = Array.isArray(value) ? value.length : typeof value === "string" ? value.length : 0;
+    if (length < min2) return message;
+    return void 0;
+  };
+}
+function maxLength(max2, options = {}) {
+  const defaultMessage = (p) => `Must be no more than ${p.max} characters`;
+  const message = typeof options.message === "function" ? options.message({ max: max2 }) : options.message || defaultMessage({ max: max2 });
+  return (value) => {
+    if (!value) return void 0;
+    const length = Array.isArray(value) ? value.length : typeof value === "string" ? value.length : 0;
+    if (length > max2) return message;
+    return void 0;
+  };
+}
+function min(minValue, options = {}) {
+  const defaultMessage = (p) => `Must be at least ${p.min}`;
+  const message = typeof options.message === "function" ? options.message({ min: minValue }) : options.message || defaultMessage({ min: minValue });
+  return (value) => {
+    if (value === void 0 || value === null) return void 0;
+    const numValue = typeof value === "number" ? value : parseFloat(value);
+    if (isNaN(numValue) || numValue < minValue) return message;
+    return void 0;
+  };
+}
+function max(maxValue, options = {}) {
+  const defaultMessage = (p) => `Must be no more than ${p.max}`;
+  const message = typeof options.message === "function" ? options.message({ max: maxValue }) : options.message || defaultMessage({ max: maxValue });
+  return (value) => {
+    if (value === void 0 || value === null) return void 0;
+    const numValue = typeof value === "number" ? value : parseFloat(value);
+    if (isNaN(numValue) || numValue > maxValue) return message;
+    return void 0;
+  };
+}
+function pattern(regex, options = {}) {
+  const defaultMessage = "Invalid format";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    if (!regex.test(value)) return message;
+    return void 0;
+  };
+}
+function matches(fieldName, options = {}) {
+  const defaultMessage = (p) => `Must match ${p.field}`;
+  const message = typeof options.message === "function" ? options.message({ field: fieldName }) : options.message || defaultMessage({ field: fieldName });
+  return (value, allValues) => {
+    const otherValue = allValues[fieldName];
+    if (value !== otherValue) return message;
+    return void 0;
+  };
+}
+function oneOf(allowedValues, options = {}) {
+  const defaultMessage = "Invalid value";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  return (value) => {
+    if (!value) return void 0;
+    if (!allowedValues.includes(value)) return message;
+    return void 0;
+  };
+}
+function creditCard(options = {}) {
+  const defaultMessage = "Please enter a valid credit card number";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  const luhnCheck = (num) => {
+    let sum = 0;
+    let isEven = false;
+    for (let i = num.length - 1; i >= 0; i--) {
+      let digit = parseInt(num[i], 10);
+      if (isEven) {
+        digit *= 2;
+        if (digit > 9) {
+          digit -= 9;
+        }
+      }
+      sum += digit;
+      isEven = !isEven;
+    }
+    return sum % 10 === 0;
+  };
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    const cleaned = value.replace(/[\s-]/g, "");
+    if (!/^\d+$/.test(cleaned)) return message;
+    if (cleaned.length < 13 || cleaned.length > 19) return message;
+    if (!luhnCheck(cleaned)) return message;
+    return void 0;
+  };
+}
+function postalCode(options = {}) {
+  const defaultMessage = "Please enter a valid ZIP code";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  const zipRegex = /^\d{5}(-\d{4})?$/;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    if (!zipRegex.test(value)) return message;
+    return void 0;
+  };
+}
+function alpha(options = {}) {
+  const defaultMessage = "Must contain only letters";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  const alphaRegex = /^[a-zA-Z]+$/;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    if (!alphaRegex.test(value)) return message;
+    return void 0;
+  };
+}
+function alphanumeric(options = {}) {
+  const defaultMessage = "Must contain only letters and numbers";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  const alphanumericRegex = /^[a-zA-Z0-9]+$/;
+  return (value) => {
+    if (!value) return void 0;
+    if (typeof value !== "string") return message;
+    if (!alphanumericRegex.test(value)) return message;
+    return void 0;
+  };
+}
+function numeric(options = {}) {
+  const defaultMessage = "Must be a valid number";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  return (value) => {
+    if (value === void 0 || value === null || value === "") return void 0;
+    const numValue = typeof value === "number" ? value : parseFloat(value);
+    if (isNaN(numValue)) return message;
+    return void 0;
+  };
+}
+function integer(options = {}) {
+  const defaultMessage = "Must be a whole number";
+  const message = typeof options.message === "function" ? options.message() : options.message || defaultMessage;
+  return (value) => {
+    if (value === void 0 || value === null || value === "") return void 0;
+    const numValue = typeof value === "number" ? value : parseFloat(value);
+    if (isNaN(numValue) || !Number.isInteger(numValue)) return message;
+    return void 0;
+  };
+}
+function compose(...validators) {
+  return async (value, allValues) => {
+    for (const validator of validators) {
+      const error = await validator(value, allValues);
+      if (error) return error;
+    }
+    return void 0;
+  };
+}
+
+// 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: min2 }) => `Must be at least ${min2} characters`,
+  maxLength: ({ max: max2 }) => `Must be no more than ${max2} characters`,
+  min: ({ min: min2 }) => `Must be at least ${min2}`,
+  max: ({ max: max2 }) => `Must be no more than ${max2}`,
+  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 { alpha, alphanumeric, asyncValidator, compose, creditCard, crossFieldValidator, debounce, defaultMessages, email, getErrorMessage, integer, matches, max, maxLength, messageRegistry, min, minLength, numeric, oneOf, pattern, phone, postalCode, required, resetErrorMessages, setErrorMessages, url, when, withRaceConditionPrevention };
 //# sourceMappingURL=validation.js.map
 //# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"validation.js"}
+{"version":3,"sources":["../src/validation/rules.ts","../src/validation/utils.ts"],"names":["min","max"],"mappings":"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","file":"validation.js","sourcesContent":["/**\n * @page-speed/forms - Validation Rules\n *\n * Common validation rules for form fields.\n * Tree-shakable - import only the rules you need.\n *\n * @example\n * ```tsx\n * import { required, email, minLength } from '@page-speed/forms/validation/rules';\n *\n * const form = useForm({\n *   validationSchema: {\n *     email: [required(), email()],\n *     password: [required(), minLength(8)],\n *   }\n * });\n * ```\n */\n\nimport type { FieldValidator } from \"../core/types\";\n\n/**\n * Error message template function\n * Allows customization of error messages\n */\nexport type ErrorMessageFn = (params?: Record<string, any>) => string;\n\n/**\n * Validation rule options\n */\nexport interface ValidationRuleOptions {\n  /**\n   * Custom error message\n   */\n  message?: string | ErrorMessageFn;\n}\n\n/**\n * Required field validator\n * Ensures field has a truthy value\n */\nexport function required(\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = \"This field is required\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  return (value) => {\n    if (value === undefined || value === null || value === \"\") {\n      return message;\n    }\n\n    // Check for empty arrays\n    if (Array.isArray(value) && value.length === 0) {\n      return message;\n    }\n\n    // Check for empty objects\n    if (\n      typeof value === \"object\" &&\n      !Array.isArray(value) &&\n      Object.keys(value).length === 0\n    ) {\n      return message;\n    }\n\n    return undefined;\n  };\n}\n\n/**\n * Email validator\n * Validates email format using RFC 5322 compatible regex\n */\nexport function email(options: ValidationRuleOptions = {}): FieldValidator {\n  const defaultMessage = \"Please enter a valid email address\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  // RFC 5322 simplified email regex\n  const emailRegex =\n    /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;\n\n  return (value) => {\n    if (!value) return undefined; // Use with required() if needed\n    if (typeof value !== \"string\") return message;\n    if (!emailRegex.test(value)) return message;\n    return undefined;\n  };\n}\n\n/**\n * URL validator\n * Validates URL format\n */\nexport function url(options: ValidationRuleOptions = {}): FieldValidator {\n  const defaultMessage = \"Please enter a valid URL\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  return (value) => {\n    if (!value) return undefined; // Use with required() if needed\n    if (typeof value !== \"string\") return message;\n\n    try {\n      new URL(value);\n      return undefined;\n    } catch {\n      return message;\n    }\n  };\n}\n\n/**\n * Phone number validator\n * Validates US phone numbers (flexible formats)\n */\nexport function phone(options: ValidationRuleOptions = {}): FieldValidator {\n  const defaultMessage = \"Please enter a valid phone number\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  // Matches: (123) 456-7890, 123-456-7890, 1234567890, +1 123 456 7890\n  const phoneRegex = /^[\\+]?[(]?[0-9]{3}[)]?[-\\s\\.]?[0-9]{3}[-\\s\\.]?[0-9]{4,6}$/;\n\n  return (value) => {\n    if (!value) return undefined;\n    if (typeof value !== \"string\") return message;\n\n    // Remove all non-numeric characters except +\n    const cleaned = value.replace(/[^\\d+]/g, \"\");\n\n    if (!phoneRegex.test(cleaned)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Minimum length validator\n */\nexport function minLength(\n  min: number,\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = (p: { min: number }) =>\n    `Must be at least ${p.min} characters`;\n  const message =\n    typeof options.message === \"function\"\n      ? options.message({ min })\n      : options.message || defaultMessage({ min });\n\n  return (value) => {\n    if (!value) return undefined;\n\n    const length = Array.isArray(value)\n      ? value.length\n      : typeof value === \"string\"\n        ? value.length\n        : 0;\n\n    if (length < min) return message;\n    return undefined;\n  };\n}\n\n/**\n * Maximum length validator\n */\nexport function maxLength(\n  max: number,\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = (p: { max: number }) =>\n    `Must be no more than ${p.max} characters`;\n  const message =\n    typeof options.message === \"function\"\n      ? options.message({ max })\n      : options.message || defaultMessage({ max });\n\n  return (value) => {\n    if (!value) return undefined;\n\n    const length = Array.isArray(value)\n      ? value.length\n      : typeof value === \"string\"\n        ? value.length\n        : 0;\n\n    if (length > max) return message;\n    return undefined;\n  };\n}\n\n/**\n * Minimum value validator (for numbers)\n */\nexport function min(\n  minValue: number,\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = (p: { min: number }) =>\n    `Must be at least ${p.min}`;\n  const message =\n    typeof options.message === \"function\"\n      ? options.message({ min: minValue })\n      : options.message || defaultMessage({ min: minValue });\n\n  return (value) => {\n    if (value === undefined || value === null) return undefined;\n\n    const numValue = typeof value === \"number\" ? value : parseFloat(value);\n\n    if (isNaN(numValue) || numValue < minValue) return message;\n    return undefined;\n  };\n}\n\n/**\n * Maximum value validator (for numbers)\n */\nexport function max(\n  maxValue: number,\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = (p: { max: number }) =>\n    `Must be no more than ${p.max}`;\n  const message =\n    typeof options.message === \"function\"\n      ? options.message({ max: maxValue })\n      : options.message || defaultMessage({ max: maxValue });\n\n  return (value) => {\n    if (value === undefined || value === null) return undefined;\n\n    const numValue = typeof value === \"number\" ? value : parseFloat(value);\n\n    if (isNaN(numValue) || numValue > maxValue) return message;\n    return undefined;\n  };\n}\n\n/**\n * Pattern validator\n * Validates against a regular expression\n */\nexport function pattern(\n  regex: RegExp,\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = \"Invalid format\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  return (value) => {\n    if (!value) return undefined;\n    if (typeof value !== \"string\") return message;\n    if (!regex.test(value)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Match validator\n * Ensures field matches another field (e.g., password confirmation)\n */\nexport function matches(\n  fieldName: string,\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = (p: { field: string }) =>\n    `Must match ${p.field}`;\n  const message =\n    typeof options.message === \"function\"\n      ? options.message({ field: fieldName })\n      : options.message || defaultMessage({ field: fieldName });\n\n  return (value, allValues) => {\n    const otherValue = allValues[fieldName];\n    if (value !== otherValue) return message;\n    return undefined;\n  };\n}\n\n/**\n * One of validator\n * Ensures value is one of the allowed values\n */\nexport function oneOf<T = any>(\n  allowedValues: T[],\n  options: ValidationRuleOptions = {}\n): FieldValidator<T> {\n  const defaultMessage = \"Invalid value\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  return (value) => {\n    if (!value) return undefined;\n    if (!allowedValues.includes(value)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Credit card validator\n * Validates credit card numbers using Luhn algorithm\n */\nexport function creditCard(\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = \"Please enter a valid credit card number\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  const luhnCheck = (num: string): boolean => {\n    let sum = 0;\n    let isEven = false;\n\n    for (let i = num.length - 1; i >= 0; i--) {\n      let digit = parseInt(num[i], 10);\n\n      if (isEven) {\n        digit *= 2;\n        if (digit > 9) {\n          digit -= 9;\n        }\n      }\n\n      sum += digit;\n      isEven = !isEven;\n    }\n\n    return sum % 10 === 0;\n  };\n\n  return (value) => {\n    if (!value) return undefined;\n    if (typeof value !== \"string\") return message;\n\n    // Remove spaces and dashes\n    const cleaned = value.replace(/[\\s-]/g, \"\");\n\n    // Check if only digits\n    if (!/^\\d+$/.test(cleaned)) return message;\n\n    // Check length (13-19 digits for most cards)\n    if (cleaned.length < 13 || cleaned.length > 19) return message;\n\n    // Luhn algorithm check\n    if (!luhnCheck(cleaned)) return message;\n\n    return undefined;\n  };\n}\n\n/**\n * Postal code validator (US ZIP codes)\n */\nexport function postalCode(\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = \"Please enter a valid ZIP code\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  // Matches: 12345 or 12345-6789\n  const zipRegex = /^\\d{5}(-\\d{4})?$/;\n\n  return (value) => {\n    if (!value) return undefined;\n    if (typeof value !== \"string\") return message;\n    if (!zipRegex.test(value)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Alpha validator\n * Ensures value contains only alphabetic characters\n */\nexport function alpha(options: ValidationRuleOptions = {}): FieldValidator {\n  const defaultMessage = \"Must contain only letters\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  const alphaRegex = /^[a-zA-Z]+$/;\n\n  return (value) => {\n    if (!value) return undefined;\n    if (typeof value !== \"string\") return message;\n    if (!alphaRegex.test(value)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Alphanumeric validator\n * Ensures value contains only letters and numbers\n */\nexport function alphanumeric(\n  options: ValidationRuleOptions = {}\n): FieldValidator {\n  const defaultMessage = \"Must contain only letters and numbers\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  const alphanumericRegex = /^[a-zA-Z0-9]+$/;\n\n  return (value) => {\n    if (!value) return undefined;\n    if (typeof value !== \"string\") return message;\n    if (!alphanumericRegex.test(value)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Numeric validator\n * Ensures value is a valid number\n */\nexport function numeric(options: ValidationRuleOptions = {}): FieldValidator {\n  const defaultMessage = \"Must be a valid number\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  return (value) => {\n    if (value === undefined || value === null || value === \"\") return undefined;\n\n    const numValue = typeof value === \"number\" ? value : parseFloat(value);\n\n    if (isNaN(numValue)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Integer validator\n * Ensures value is a valid integer\n */\nexport function integer(options: ValidationRuleOptions = {}): FieldValidator {\n  const defaultMessage = \"Must be a whole number\";\n  const message =\n    typeof options.message === \"function\"\n      ? options.message()\n      : options.message || defaultMessage;\n\n  return (value) => {\n    if (value === undefined || value === null || value === \"\") return undefined;\n\n    const numValue = typeof value === \"number\" ? value : parseFloat(value);\n\n    if (isNaN(numValue) || !Number.isInteger(numValue)) return message;\n    return undefined;\n  };\n}\n\n/**\n * Compose multiple validators\n * Runs validators in sequence and returns first error\n */\nexport function compose(\n  ...validators: FieldValidator[]\n): FieldValidator {\n  return async (value, allValues) => {\n    for (const validator of validators) {\n      const error = await validator(value, allValues);\n      if (error) return error;\n    }\n    return undefined;\n  };\n}\n","/**\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@page-speed/forms",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Ultra-high-performance React form library with field-level reactivity and tree-shakable architecture",
   "keywords": [
     "react",
@@ -62,6 +62,16 @@
       "types": "./dist/validation-utils.d.ts",
       "import": "./dist/validation-utils.js",
       "require": "./dist/validation-utils.cjs"
+    },
+    "./upload": {
+      "types": "./dist/upload.d.ts",
+      "import": "./dist/upload.js",
+      "require": "./dist/upload.cjs"
+    },
+    "./integration": {
+      "types": "./dist/integration.d.ts",
+      "import": "./dist/integration.js",
+      "require": "./dist/integration.cjs"
     }
   },
   "files": [
@@ -77,10 +87,10 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest",
-    "test:ci": "vitest run",
+    "test:ci": "./scripts/test-ci-silent.sh",
     "type-check": "tsc --noEmit",
-    "size": "size-limit",
-    "prepublishOnly": "pnpm run build && pnpm run test:ci && pnpm run size"
+    "size": "bash -c 'size-limit --silent 2>/dev/null'",
+    "prepublishOnly": "pnpm run build && pnpm run test:ci"
   },
   "peerDependencies": {
     "react": ">=16.8.0",