@coherent.js/forms 1.0.0-beta.6 → 1.0.0-beta.7

package/dist/forms.js

@@ -0,0 +1,432 @@
+// src/forms.js
+function createForm(options = {}) {
+  const opts = {
+    fields: {},
+    validation: {
+      strategy: "blur",
+      debounce: 300,
+      async: true,
+      stopOnFirstError: false,
+      revalidateOn: ["change", "blur"],
+      ...options.validation
+    },
+    errors: {
+      format: "detailed",
+      display: "inline",
+      customFormatter: null,
+      ...options.errors
+    },
+    submission: {
+      preventDefault: true,
+      validateBeforeSubmit: true,
+      disableOnSubmit: true,
+      resetOnSuccess: false,
+      onSuccess: null,
+      onError: null,
+      ...options.submission
+    },
+    state: {
+      trackDirty: true,
+      trackTouched: true,
+      trackVisited: true,
+      initialValues: {},
+      resetValues: null,
+      ...options.state
+    },
+    middleware: options.middleware || [],
+    ...options
+  };
+  const state = {
+    values: { ...opts.state.initialValues },
+    errors: {},
+    touched: {},
+    dirty: {},
+    visited: {},
+    isSubmitting: false,
+    isValidating: false,
+    submitCount: 0,
+    asyncValidations: /* @__PURE__ */ new Map()
+  };
+  const fields = /* @__PURE__ */ new Map();
+  const stats = {
+    validations: 0,
+    asyncValidations: 0,
+    submissions: 0,
+    successfulSubmissions: 0,
+    failedSubmissions: 0,
+    middlewareExecutions: 0
+  };
+  function registerField(name, config) {
+    fields.set(name, {
+      name,
+      type: config.type || "text",
+      validators: config.validators || [],
+      transform: config.transform || {},
+      validateWhen: config.validateWhen,
+      required: config.required || false,
+      defaultValue: config.defaultValue,
+      ...config
+    });
+    if (!(name in state.values)) {
+      state.values[name] = config.defaultValue !== void 0 ? config.defaultValue : "";
+    }
+    state.errors[name] = [];
+    state.touched[name] = false;
+    state.dirty[name] = false;
+    state.visited[name] = false;
+  }
+  function getField(name) {
+    return fields.get(name);
+  }
+  function setFieldValue(name, value, shouldValidate = true) {
+    const field = fields.get(name);
+    if (!field) {
+      console.warn(`Field ${name} not registered`);
+      return;
+    }
+    if (field.transform?.input) {
+      value = field.transform.input(value);
+    }
+    state.values[name] = value;
+    if (opts.state.trackDirty) {
+      const initialValue = opts.state.initialValues[name];
+      state.dirty[name] = value !== initialValue;
+    }
+    if (shouldValidate && opts.validation.revalidateOn.includes("change")) {
+      validateField(name);
+    }
+  }
+  function getFieldValue(name) {
+    return state.values[name];
+  }
+  function setFieldTouched(name, touched = true) {
+    if (!opts.state.trackTouched) return;
+    state.touched[name] = touched;
+    if (touched && opts.validation.revalidateOn.includes("blur")) {
+      validateField(name);
+    }
+  }
+  function setFieldVisited(name, visited = true) {
+    if (!opts.state.trackVisited) return;
+    state.visited[name] = visited;
+  }
+  async function validateField(name) {
+    const field = fields.get(name);
+    if (!field) return { valid: true, errors: [] };
+    stats.validations++;
+    if (field.validateWhen && !field.validateWhen(state.values)) {
+      state.errors[name] = [];
+      return { valid: true, errors: [] };
+    }
+    const value = state.values[name];
+    const errors = [];
+    if (state.asyncValidations.has(name)) {
+      clearTimeout(state.asyncValidations.get(name));
+    }
+    if (field.required && (value === "" || value === null || value === void 0)) {
+      errors.push({
+        field: name,
+        type: "required",
+        message: `${name} is required`
+      });
+      state.errors[name] = errors;
+      return { valid: false, errors };
+    }
+    for (const validator of field.validators) {
+      try {
+        let result;
+        if (validator.validate.constructor.name === "AsyncFunction" || opts.validation.async) {
+          stats.asyncValidations++;
+          if (validator.debounce || opts.validation.debounce) {
+            await new Promise((resolve) => {
+              const timeoutId = setTimeout(resolve, validator.debounce || opts.validation.debounce);
+              state.asyncValidations.set(name, timeoutId);
+            });
+          }
+          result = await validator.validate(value, state.values);
+        } else {
+          result = validator.validate(value, state.values);
+        }
+        if (result !== true && result !== void 0 && result !== null) {
+          errors.push({
+            field: name,
+            type: validator.name || "custom",
+            message: validator.message || result || "Validation failed"
+          });
+          if (opts.validation.stopOnFirstError) {
+            break;
+          }
+        }
+      } catch (error) {
+        errors.push({
+          field: name,
+          type: "error",
+          message: error.message || "Validation error"
+        });
+        if (opts.validation.stopOnFirstError) {
+          break;
+        }
+      }
+    }
+    state.errors[name] = errors;
+    return { valid: errors.length === 0, errors };
+  }
+  async function validateForm() {
+    state.isValidating = true;
+    const validationPromises = Array.from(fields.keys()).map(
+      (name) => validateField(name)
+    );
+    const results = await Promise.all(validationPromises);
+    state.isValidating = false;
+    const allErrors = results.reduce((acc, result, index) => {
+      const fieldName = Array.from(fields.keys())[index];
+      if (result.errors.length > 0) {
+        acc[fieldName] = result.errors;
+      }
+      return acc;
+    }, {});
+    const isValid2 = Object.keys(allErrors).length === 0;
+    return {
+      valid: isValid2,
+      errors: allErrors
+    };
+  }
+  async function executeMiddleware(action, data) {
+    if (opts.middleware.length === 0) return data;
+    stats.middlewareExecutions++;
+    let result = data;
+    for (const middleware of opts.middleware) {
+      try {
+        const next = () => result;
+        result = await middleware(action, result, next, state);
+      } catch (error) {
+        console.error("Middleware error:", error);
+        throw error;
+      }
+    }
+    return result;
+  }
+  function applyTransformations(values) {
+    const transformed = { ...values };
+    fields.forEach((field, name) => {
+      if (field.transform?.output && name in transformed) {
+        transformed[name] = field.transform.output(transformed[name]);
+      }
+    });
+    return transformed;
+  }
+  async function handleSubmit(onSubmit) {
+    stats.submissions++;
+    try {
+      if (opts.submission.preventDefault && typeof event !== "undefined") {
+        event.preventDefault();
+      }
+      if (opts.submission.disableOnSubmit) {
+        state.isSubmitting = true;
+      }
+      let values = { ...state.values };
+      values = await executeMiddleware("beforeSubmit", values);
+      if (opts.submission.validateBeforeSubmit) {
+        const validation = await validateForm();
+        if (!validation.valid) {
+          if (opts.submission.onError) {
+            opts.submission.onError(validation.errors);
+          }
+          stats.failedSubmissions++;
+          return { success: false, errors: validation.errors };
+        }
+      }
+      values = applyTransformations(values);
+      values = await executeMiddleware("afterValidation", values);
+      const result = await onSubmit(values);
+      await executeMiddleware("afterSubmit", result);
+      state.submitCount++;
+      stats.successfulSubmissions++;
+      if (opts.submission.resetOnSuccess) {
+        reset();
+      }
+      if (opts.submission.onSuccess) {
+        opts.submission.onSuccess(result);
+      }
+      return { success: true, data: result };
+    } catch (error) {
+      stats.failedSubmissions++;
+      if (opts.submission.onError) {
+        opts.submission.onError(error);
+      }
+      await executeMiddleware("onError", error);
+      return { success: false, error };
+    } finally {
+      state.isSubmitting = false;
+    }
+  }
+  function reset(values) {
+    const resetValues = values || opts.state.resetValues || opts.state.initialValues;
+    state.values = { ...resetValues };
+    state.errors = {};
+    state.touched = {};
+    state.dirty = {};
+    state.visited = {};
+    state.submitCount = 0;
+    fields.forEach((field, name) => {
+      if (!(name in state.values)) {
+        state.values[name] = field.defaultValue !== void 0 ? field.defaultValue : "";
+      }
+      state.errors[name] = [];
+      state.touched[name] = false;
+      state.dirty[name] = false;
+      state.visited[name] = false;
+    });
+  }
+  function getErrors(fieldName) {
+    if (fieldName) {
+      return state.errors[fieldName] || [];
+    }
+    if (opts.errors.customFormatter) {
+      return opts.errors.customFormatter(state.errors);
+    }
+    if (opts.errors.format === "simple") {
+      return Object.values(state.errors).flat().map((e) => e.message);
+    }
+    return state.errors;
+  }
+  function isValid() {
+    return Object.values(state.errors).every((errors) => errors.length === 0);
+  }
+  function isDirty(fieldName) {
+    if (fieldName) {
+      return state.dirty[fieldName] || false;
+    }
+    return Object.values(state.dirty).some((dirty) => dirty);
+  }
+  function isTouched(fieldName) {
+    if (fieldName) {
+      return state.touched[fieldName] || false;
+    }
+    return Object.values(state.touched).some((touched) => touched);
+  }
+  function getValues() {
+    return { ...state.values };
+  }
+  function setValues(values, shouldValidate = false) {
+    Object.entries(values).forEach(([name, value]) => {
+      setFieldValue(name, value, shouldValidate);
+    });
+  }
+  function getState() {
+    return {
+      values: { ...state.values },
+      errors: { ...state.errors },
+      touched: { ...state.touched },
+      dirty: { ...state.dirty },
+      visited: { ...state.visited },
+      isSubmitting: state.isSubmitting,
+      isValidating: state.isValidating,
+      submitCount: state.submitCount,
+      isValid: isValid(),
+      isDirty: isDirty(),
+      isTouched: isTouched()
+    };
+  }
+  function getStats() {
+    return {
+      ...stats,
+      fieldsRegistered: fields.size,
+      activeAsyncValidations: state.asyncValidations.size
+    };
+  }
+  Object.entries(opts.fields).forEach(([name, config]) => {
+    registerField(name, config);
+  });
+  return {
+    registerField,
+    getField,
+    setFieldValue,
+    getFieldValue,
+    setFieldTouched,
+    setFieldVisited,
+    validateField,
+    validateForm,
+    handleSubmit,
+    reset,
+    getErrors,
+    isValid,
+    isDirty,
+    isTouched,
+    getValues,
+    setValues,
+    getState,
+    getStats,
+    // Expose state for testing
+    _state: state
+  };
+}
+var formValidators = {
+  required: {
+    name: "required",
+    validate: (value) => {
+      return value !== "" && value !== null && value !== void 0;
+    },
+    message: "This field is required"
+  },
+  email: {
+    name: "email",
+    validate: (value) => {
+      if (!value) return true;
+      const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+      return regex.test(value);
+    },
+    message: "Please enter a valid email address"
+  },
+  minLength: (min) => ({
+    name: "minLength",
+    validate: (value) => {
+      if (!value) return true;
+      return String(value).length >= min;
+    },
+    message: `Must be at least ${min} characters`
+  }),
+  maxLength: (max) => ({
+    name: "maxLength",
+    validate: (value) => {
+      if (!value) return true;
+      return String(value).length <= max;
+    },
+    message: `Must be no more than ${max} characters`
+  }),
+  pattern: (regex, message) => ({
+    name: "pattern",
+    validate: (value) => {
+      if (!value) return true;
+      return regex.test(value);
+    },
+    message: message || "Invalid format"
+  }),
+  asyncEmail: {
+    name: "asyncEmail",
+    validate: async (value) => {
+      if (!value) return true;
+      await new Promise((resolve) => setTimeout(resolve, 100));
+      const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+      return regex.test(value);
+    },
+    message: "Please enter a valid email address",
+    debounce: 500
+  },
+  asyncUnique: (checkFn) => ({
+    name: "asyncUnique",
+    validate: async (value) => {
+      if (!value) return true;
+      return await checkFn(value);
+    },
+    message: "This value is already taken",
+    debounce: 500
+  })
+};
+var enhancedForm = createForm();
+export {
+  createForm,
+  enhancedForm,
+  formValidators
+};
+//# sourceMappingURL=forms.js.map

package/dist/forms.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/forms.js"],
+  "sourcesContent": ["/**\n * Enhanced Form System\n *\n * Provides advanced form features:\n * - Async validation\n * - Custom validators\n * - Field transformations\n * - Form middleware\n */\n\n/**\n * Create an enhanced form with advanced validation and middleware\n *\n * @param {Object} options - Configuration options\n * @param {Object} [options.fields] - Field configurations\n * @param {Object} [options.validation] - Validation options\n * @param {Array} [options.middleware] - Form middleware functions\n * @param {Object} [options.submission] - Submission options\n * @returns {Object} Enhanced form instance\n */\nexport function createForm(options = {}) {\n  const opts = {\n    fields: {},\n    validation: {\n      strategy: 'blur',\n      debounce: 300,\n      async: true,\n      stopOnFirstError: false,\n      revalidateOn: ['change', 'blur'],\n      ...options.validation\n    },\n    errors: {\n      format: 'detailed',\n      display: 'inline',\n      customFormatter: null,\n      ...options.errors\n    },\n    submission: {\n      preventDefault: true,\n      validateBeforeSubmit: true,\n      disableOnSubmit: true,\n      resetOnSuccess: false,\n      onSuccess: null,\n      onError: null,\n      ...options.submission\n    },\n    state: {\n      trackDirty: true,\n      trackTouched: true,\n      trackVisited: true,\n      initialValues: {},\n      resetValues: null,\n      ...options.state\n    },\n    middleware: options.middleware || [],\n    ...options\n  };\n\n  // Form state\n  const state = {\n    values: { ...opts.state.initialValues },\n    errors: {},\n    touched: {},\n    dirty: {},\n    visited: {},\n    isSubmitting: false,\n    isValidating: false,\n    submitCount: 0,\n    asyncValidations: new Map()\n  };\n\n  // Field metadata\n  const fields = new Map();\n\n  // Statistics\n  const stats = {\n    validations: 0,\n    asyncValidations: 0,\n    submissions: 0,\n    successfulSubmissions: 0,\n    failedSubmissions: 0,\n    middlewareExecutions: 0\n  };\n\n  /**\n   * Register a field\n   */\n  function registerField(name, config) {\n    fields.set(name, {\n      name,\n      type: config.type || 'text',\n      validators: config.validators || [],\n      transform: config.transform || {},\n      validateWhen: config.validateWhen,\n      required: config.required || false,\n      defaultValue: config.defaultValue,\n      ...config\n    });\n\n    // Initialize field state\n    if (!(name in state.values)) {\n      state.values[name] = config.defaultValue !== undefined\n        ? config.defaultValue\n        : '';\n    }\n    state.errors[name] = [];\n    state.touched[name] = false;\n    state.dirty[name] = false;\n    state.visited[name] = false;\n  }\n\n  /**\n   * Get field configuration\n   */\n  function getField(name) {\n    return fields.get(name);\n  }\n\n  /**\n   * Set field value\n   */\n  function setFieldValue(name, value, shouldValidate = true) {\n    const field = fields.get(name);\n    if (!field) {\n      console.warn(`Field ${name} not registered`);\n      return;\n    }\n\n    // Apply input transformation\n    if (field.transform?.input) {\n      value = field.transform.input(value);\n    }\n\n    state.values[name] = value;\n\n    // Track dirty state\n    if (opts.state.trackDirty) {\n      const initialValue = opts.state.initialValues[name];\n      state.dirty[name] = value !== initialValue;\n    }\n\n    // Validate if needed\n    if (shouldValidate && opts.validation.revalidateOn.includes('change')) {\n      validateField(name);\n    }\n  }\n\n  /**\n   * Get field value\n   */\n  function getFieldValue(name) {\n    return state.values[name];\n  }\n\n  /**\n   * Set field touched\n   */\n  function setFieldTouched(name, touched = true) {\n    if (!opts.state.trackTouched) return;\n\n    state.touched[name] = touched;\n\n    // Validate on blur if configured\n    if (touched && opts.validation.revalidateOn.includes('blur')) {\n      validateField(name);\n    }\n  }\n\n  /**\n   * Set field visited\n   */\n  function setFieldVisited(name, visited = true) {\n    if (!opts.state.trackVisited) return;\n    state.visited[name] = visited;\n  }\n\n  /**\n   * Validate a single field\n   */\n  async function validateField(name) {\n    const field = fields.get(name);\n    if (!field) return { valid: true, errors: [] };\n\n    stats.validations++;\n\n    // Check conditional validation\n    if (field.validateWhen && !field.validateWhen(state.values)) {\n      state.errors[name] = [];\n      return { valid: true, errors: [] };\n    }\n\n    const value = state.values[name];\n    const errors = [];\n\n    // Cancel previous async validation if any\n    if (state.asyncValidations.has(name)) {\n      clearTimeout(state.asyncValidations.get(name));\n    }\n\n    // Required validation\n    if (field.required && (value === '' || value === null || value === undefined)) {\n      errors.push({\n        field: name,\n        type: 'required',\n        message: `${name} is required`\n      });\n\n      state.errors[name] = errors;\n      return { valid: false, errors };\n    }\n\n    // Run validators\n    for (const validator of field.validators) {\n      try {\n        let result;\n\n        // Check if validator is async\n        if (validator.validate.constructor.name === 'AsyncFunction' || opts.validation.async) {\n          stats.asyncValidations++;\n\n          // Debounce async validation\n          if (validator.debounce || opts.validation.debounce) {\n            await new Promise(resolve => {\n              const timeoutId = setTimeout(resolve, validator.debounce || opts.validation.debounce);\n              state.asyncValidations.set(name, timeoutId);\n            });\n          }\n\n          result = await validator.validate(value, state.values);\n        } else {\n          result = validator.validate(value, state.values);\n        }\n\n        // Check result\n        if (result !== true && result !== undefined && result !== null) {\n          errors.push({\n            field: name,\n            type: validator.name || 'custom',\n            message: validator.message || result || 'Validation failed'\n          });\n\n          if (opts.validation.stopOnFirstError) {\n            break;\n          }\n        }\n      } catch (error) {\n        errors.push({\n          field: name,\n          type: 'error',\n          message: error.message || 'Validation error'\n        });\n\n        if (opts.validation.stopOnFirstError) {\n          break;\n        }\n      }\n    }\n\n    state.errors[name] = errors;\n    return { valid: errors.length === 0, errors };\n  }\n\n  /**\n   * Validate all fields\n   */\n  async function validateForm() {\n    state.isValidating = true;\n\n    const validationPromises = Array.from(fields.keys()).map(name =>\n      validateField(name)\n    );\n\n    const results = await Promise.all(validationPromises);\n\n    state.isValidating = false;\n\n    const allErrors = results.reduce((acc, result, index) => {\n      const fieldName = Array.from(fields.keys())[index];\n      if (result.errors.length > 0) {\n        acc[fieldName] = result.errors;\n      }\n      return acc;\n    }, {});\n\n    const isValid = Object.keys(allErrors).length === 0;\n\n    return {\n      valid: isValid,\n      errors: allErrors\n    };\n  }\n\n  /**\n   * Execute middleware\n   */\n  async function executeMiddleware(action, data) {\n    if (opts.middleware.length === 0) return data;\n\n    stats.middlewareExecutions++;\n\n    let result = data;\n\n    for (const middleware of opts.middleware) {\n      try {\n        const next = () => result;\n        result = await middleware(action, result, next, state);\n      } catch (error) {\n        console.error('Middleware error:', error);\n        throw error;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Apply field transformations\n   */\n  function applyTransformations(values) {\n    const transformed = { ...values };\n\n    fields.forEach((field, name) => {\n      if (field.transform?.output && name in transformed) {\n        transformed[name] = field.transform.output(transformed[name]);\n      }\n    });\n\n    return transformed;\n  }\n\n  /**\n   * Submit the form\n   */\n  async function handleSubmit(onSubmit) {\n    stats.submissions++;\n\n    try {\n      // Prevent default if needed\n      if (opts.submission.preventDefault && typeof event !== 'undefined') {\n        event.preventDefault();\n      }\n\n      // Disable form during submission\n      if (opts.submission.disableOnSubmit) {\n        state.isSubmitting = true;\n      }\n\n      // Execute beforeSubmit middleware\n      let values = { ...state.values };\n      values = await executeMiddleware('beforeSubmit', values);\n\n      // Validate before submit\n      if (opts.submission.validateBeforeSubmit) {\n        const validation = await validateForm();\n\n        if (!validation.valid) {\n          if (opts.submission.onError) {\n            opts.submission.onError(validation.errors);\n          }\n\n          stats.failedSubmissions++;\n          return { success: false, errors: validation.errors };\n        }\n      }\n\n      // Apply transformations\n      values = applyTransformations(values);\n\n      // Execute afterValidation middleware\n      values = await executeMiddleware('afterValidation', values);\n\n      // Submit\n      const result = await onSubmit(values);\n\n      // Execute afterSubmit middleware\n      await executeMiddleware('afterSubmit', result);\n\n      state.submitCount++;\n      stats.successfulSubmissions++;\n\n      // Reset on success\n      if (opts.submission.resetOnSuccess) {\n        reset();\n      }\n\n      if (opts.submission.onSuccess) {\n        opts.submission.onSuccess(result);\n      }\n\n      return { success: true, data: result };\n\n    } catch (error) {\n      stats.failedSubmissions++;\n\n      if (opts.submission.onError) {\n        opts.submission.onError(error);\n      }\n\n      // Execute onError middleware\n      await executeMiddleware('onError', error);\n\n      return { success: false, error };\n\n    } finally {\n      state.isSubmitting = false;\n    }\n  }\n\n  /**\n   * Reset form to initial state\n   */\n  function reset(values) {\n    const resetValues = values || opts.state.resetValues || opts.state.initialValues;\n\n    state.values = { ...resetValues };\n    state.errors = {};\n    state.touched = {};\n    state.dirty = {};\n    state.visited = {};\n    state.submitCount = 0;\n\n    // Re-initialize field states\n    fields.forEach((field, name) => {\n      // Ensure field has a value from resetValues or defaultValue\n      if (!(name in state.values)) {\n        state.values[name] = field.defaultValue !== undefined\n          ? field.defaultValue\n          : '';\n      }\n      state.errors[name] = [];\n      state.touched[name] = false;\n      state.dirty[name] = false;\n      state.visited[name] = false;\n    });\n  }\n\n  /**\n   * Get form errors\n   */\n  function getErrors(fieldName) {\n    if (fieldName) {\n      return state.errors[fieldName] || [];\n    }\n\n    if (opts.errors.customFormatter) {\n      return opts.errors.customFormatter(state.errors);\n    }\n\n    if (opts.errors.format === 'simple') {\n      // Return array of error messages\n      return Object.values(state.errors).flat().map(e => e.message);\n    }\n\n    // Return detailed errors\n    return state.errors;\n  }\n\n  /**\n   * Check if form is valid\n   */\n  function isValid() {\n    return Object.values(state.errors).every(errors => errors.length === 0);\n  }\n\n  /**\n   * Check if form is dirty\n   */\n  function isDirty(fieldName) {\n    if (fieldName) {\n      return state.dirty[fieldName] || false;\n    }\n    return Object.values(state.dirty).some(dirty => dirty);\n  }\n\n  /**\n   * Check if form is touched\n   */\n  function isTouched(fieldName) {\n    if (fieldName) {\n      return state.touched[fieldName] || false;\n    }\n    return Object.values(state.touched).some(touched => touched);\n  }\n\n  /**\n   * Get form values\n   */\n  function getValues() {\n    return { ...state.values };\n  }\n\n  /**\n   * Set form values\n   */\n  function setValues(values, shouldValidate = false) {\n    Object.entries(values).forEach(([name, value]) => {\n      setFieldValue(name, value, shouldValidate);\n    });\n  }\n\n  /**\n   * Get form state\n   */\n  function getState() {\n    return {\n      values: { ...state.values },\n      errors: { ...state.errors },\n      touched: { ...state.touched },\n      dirty: { ...state.dirty },\n      visited: { ...state.visited },\n      isSubmitting: state.isSubmitting,\n      isValidating: state.isValidating,\n      submitCount: state.submitCount,\n      isValid: isValid(),\n      isDirty: isDirty(),\n      isTouched: isTouched()\n    };\n  }\n\n  /**\n   * Get statistics\n   */\n  function getStats() {\n    return {\n      ...stats,\n      fieldsRegistered: fields.size,\n      activeAsyncValidations: state.asyncValidations.size\n    };\n  }\n\n  // Register initial fields\n  Object.entries(opts.fields).forEach(([name, config]) => {\n    registerField(name, config);\n  });\n\n  return {\n    registerField,\n    getField,\n    setFieldValue,\n    getFieldValue,\n    setFieldTouched,\n    setFieldVisited,\n    validateField,\n    validateForm,\n    handleSubmit,\n    reset,\n    getErrors,\n    isValid,\n    isDirty,\n    isTouched,\n    getValues,\n    setValues,\n    getState,\n    getStats,\n    // Expose state for testing\n    _state: state\n  };\n}\n\n// Export built-in validators\nexport const formValidators = {\n  required: {\n    name: 'required',\n    validate: (value) => {\n      return value !== '' && value !== null && value !== undefined;\n    },\n    message: 'This field is required'\n  },\n\n  email: {\n    name: 'email',\n    validate: (value) => {\n      if (!value) return true;\n      const regex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n      return regex.test(value);\n    },\n    message: 'Please enter a valid email address'\n  },\n\n  minLength: (min) => ({\n    name: 'minLength',\n    validate: (value) => {\n      if (!value) return true;\n      return String(value).length >= min;\n    },\n    message: `Must be at least ${min} characters`\n  }),\n\n  maxLength: (max) => ({\n    name: 'maxLength',\n    validate: (value) => {\n      if (!value) return true;\n      return String(value).length <= max;\n    },\n    message: `Must be no more than ${max} characters`\n  }),\n\n  pattern: (regex, message) => ({\n    name: 'pattern',\n    validate: (value) => {\n      if (!value) return true;\n      return regex.test(value);\n    },\n    message: message || 'Invalid format'\n  }),\n\n  asyncEmail: {\n    name: 'asyncEmail',\n    validate: async (value) => {\n      if (!value) return true;\n      // Simulate async validation (e.g., check if email exists)\n      await new Promise(resolve => setTimeout(resolve, 100));\n      const regex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n      return regex.test(value);\n    },\n    message: 'Please enter a valid email address',\n    debounce: 500\n  },\n\n  asyncUnique: (checkFn) => ({\n    name: 'asyncUnique',\n    validate: async (value) => {\n      if (!value) return true;\n      return await checkFn(value);\n    },\n    message: 'This value is already taken',\n    debounce: 500\n  })\n};\n\n// Export default instance\nexport const enhancedForm = createForm();\n"],
+  "mappings": "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",
+  "names": ["isValid"]
+}