@axenstudio/axen-form 0.1.18 → 0.1.19

package/dist/core/formStore.cjs

@@ -23,6 +23,9 @@ function createFormStore(options) {
     values: structuredClone(initialValues),
     errors: {},
     touched: {},
+    validationStatus: "unvalidated",
+    fieldValidationStatus: {},
+    isValidating: false,
     dirty: false,
     isSubmitting: false,
     submitCount: 0,
@@ -73,19 +76,42 @@ function createFormStore(options) {
   }
   function setFieldValue(name, value) {
     const nextValues = pathUtils.set(state.values, name, value);
+    const statuses = { ...state.fieldValidationStatus, [name]: "unvalidated" };
+    const dependents = (options.fields ?? []).filter((field) => {
+      var _a;
+      return field.name !== name && ((_a = field.rules) == null ? void 0 : _a.countryField) === name;
+    });
+    const errors = { ...state.errors };
+    for (const field of dependents) {
+      statuses[field.name] = "unvalidated";
+      delete errors[field.name];
+    }
     valuesRevision += 1;
-    state = { ...state, values: nextValues, dirty: !valuesEqual(nextValues, state.initialValues) };
+    state = {
+      ...state,
+      values: nextValues,
+      errors,
+      dirty: !valuesEqual(nextValues, state.initialValues),
+      validationStatus: "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: statuses
+    };
     for (const field of options.fields ?? []) {
       if (field.hidden && state.errors[field.name] && (typeof field.hidden === "function" ? field.hidden(nextValues) : field.hidden)) {
         setFieldError(field.name, void 0);
       }
     }
     notifyValuePath(name);
+    for (const field of dependents) notifyField(field.name);
     if (validateOnChange && validationAdapter && validationSchema) {
       const revision = valuesRevision;
-      void runFieldValidation(name).catch((error) => {
-        if (revision === valuesRevision) setFieldError(name, error instanceof Error ? error.message : "Validation failed");
-      });
+      for (const fieldName of [name, ...dependents.map((field) => field.name)]) {
+        void runFieldValidation(fieldName).catch((error) => {
+          if (revision === valuesRevision) {
+            setFieldError(fieldName, error instanceof Error ? error.message : "Validation failed");
+          }
+        });
+      }
     }
   }
   function setFieldTouched(name, touched = true) {
@@ -103,23 +129,39 @@ function createFormStore(options) {
     }
   }
   function setFieldError(name, error) {
-    const next = { ...state.errors };
-    if (error) {
-      next[name] = error;
-    } else {
-      delete next[name];
-    }
-    state = { ...state, errors: next };
+    const errors = { ...state.errors };
+    if (error) errors[name] = error;
+    else delete errors[name];
+    state = {
+      ...state,
+      errors,
+      validationStatus: Object.keys(errors).length ? "invalid" : "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: { ...state.fieldValidationStatus, [name]: error ? "invalid" : "unvalidated" }
+    };
     notifyField(name);
     notify();
   }
   function setValues(values) {
     valuesRevision += 1;
-    state = { ...state, values, dirty: !valuesEqual(values, state.initialValues) };
+    state = {
+      ...state,
+      values,
+      dirty: !valuesEqual(values, state.initialValues),
+      validationStatus: "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: {}
+    };
     notifyAllFields();
   }
   function setErrors(errors) {
-    state = { ...state, errors };
+    state = {
+      ...state,
+      errors,
+      validationStatus: Object.keys(errors).length ? "invalid" : "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: {}
+    };
     notifyAllFields();
   }
   function setFieldArrayValue(name, items, origins) {
@@ -152,7 +194,10 @@ function createFormStore(options) {
       values,
       dirty: !valuesEqual(values, state.initialValues),
       errors: remap(state.errors),
-      touched: remap(state.touched)
+      touched: remap(state.touched),
+      validationStatus: "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: remap(state.fieldValidationStatus)
     };
     notifyValuePath(name);
   }
@@ -162,6 +207,9 @@ function createFormStore(options) {
       values: newValues,
       errors: {},
       touched: {},
+      validationStatus: "unvalidated",
+      fieldValidationStatus: {},
+      isValidating: false,
       dirty: false,
       isSubmitting: false,
       submitCount: state.submitCount,
@@ -174,12 +222,30 @@ function createFormStore(options) {
     if (!validationAdapter || !validationSchema) return {};
     const revision = valuesRevision;
     const request = ++formRequest;
-    const errors = await validationAdapter.validate(validationSchema, state.values);
-    if (revision !== valuesRevision || request !== formRequest) return state.errors;
-    state = { ...state, errors };
+    state = { ...state, validationStatus: "validating", isValidating: true };
     notify();
-    for (const name of fieldSubscribers.keys()) notifyField(name);
-    return errors;
+    try {
+      const errors = await validationAdapter.validate(validationSchema, state.values);
+      if (revision !== valuesRevision || request !== formRequest) return state.errors;
+      const statuses = { ...state.fieldValidationStatus };
+      for (const field of options.fields ?? []) statuses[field.name] = errors[field.name] ? "invalid" : "valid";
+      state = {
+        ...state,
+        errors,
+        validationStatus: Object.keys(errors).length ? "invalid" : "valid",
+        isValidating: false,
+        fieldValidationStatus: statuses
+      };
+      notify();
+      for (const name of fieldSubscribers.keys()) notifyField(name);
+      return errors;
+    } catch (error) {
+      if (revision === valuesRevision && request === formRequest) {
+        state = { ...state, validationStatus: "unvalidated", isValidating: false };
+        notify();
+      }
+      throw error;
+    }
   }
   async function validateField(name) {
     var _a;
@@ -188,17 +254,47 @@ function createFormStore(options) {
     const request = (fieldRequests.get(name) ?? 0) + 1;
     fieldRequests.set(name, request);
     const config = (_a = options.fields) == null ? void 0 : _a.find((field) => field.name === name);
-    if ((config == null ? void 0 : config.hidden) && (typeof config.hidden === "function" ? config.hidden(state.values) : config.hidden)) {
+    const hidden = (config == null ? void 0 : config.hidden) && (typeof config.hidden === "function" ? config.hidden(state.values) : config.hidden);
+    if (hidden) {
       setFieldError(name, void 0);
+      state = { ...state, fieldValidationStatus: { ...state.fieldValidationStatus, [name]: "valid" } };
+      notifyField(name);
+      notify();
       return void 0;
     }
+    state = {
+      ...state,
+      fieldValidationStatus: { ...state.fieldValidationStatus, [name]: "validating" },
+      validationStatus: state.validationStatus === "validating" ? "validating" : "unvalidated"
+    };
+    notifyField(name);
+    notify();
     const fieldValue = pathUtils.get(state.values, name);
-    const error = await validationAdapter.validateField(validationSchema, name, fieldValue);
-    if (revision === valuesRevision && request === fieldRequests.get(name)) {
-      setFieldError(name, error);
-      return error;
+    try {
+      const error = await validationAdapter.validateField(validationSchema, name, fieldValue, state.values);
+      if (revision === valuesRevision && request === fieldRequests.get(name)) {
+        const errors = { ...state.errors };
+        if (error) errors[name] = error;
+        else delete errors[name];
+        state = {
+          ...state,
+          errors,
+          validationStatus: state.validationStatus === "validating" ? "validating" : Object.keys(errors).length ? "invalid" : "unvalidated",
+          fieldValidationStatus: { ...state.fieldValidationStatus, [name]: error ? "invalid" : "valid" }
+        };
+        notifyField(name);
+        notify();
+        return error;
+      }
+      return state.errors[name];
+    } catch (error) {
+      if (revision === valuesRevision && request === fieldRequests.get(name)) {
+        state = { ...state, fieldValidationStatus: { ...state.fieldValidationStatus, [name]: "unvalidated" } };
+        notifyField(name);
+        notify();
+      }
+      throw error;
     }
-    return state.errors[name];
   }
   async function runFieldValidation(name) {
     if (validationAdapter == null ? void 0 : validationAdapter.validateField) {

package/dist/core/formStore.d.ts

@@ -1,8 +1,11 @@
-import { FieldConfig, ValidationAdapter } from '../types';
+import { FieldConfig, ValidationAdapter, ValidationStatus } from '../types';
 export interface FormState<TValues extends Record<string, unknown> = Record<string, unknown>> {
     values: TValues;
     errors: Record<string, string>;
     touched: Record<string, boolean>;
+    validationStatus: ValidationStatus;
+    fieldValidationStatus: Record<string, ValidationStatus>;
+    isValidating: boolean;
     dirty: boolean;
     isSubmitting: boolean;
     submitCount: number;

package/dist/core/formStore.js

@@ -21,6 +21,9 @@ function createFormStore(options) {
     values: structuredClone(initialValues),
     errors: {},
     touched: {},
+    validationStatus: "unvalidated",
+    fieldValidationStatus: {},
+    isValidating: false,
     dirty: false,
     isSubmitting: false,
     submitCount: 0,
@@ -71,19 +74,42 @@ function createFormStore(options) {
   }
   function setFieldValue(name, value) {
     const nextValues = set(state.values, name, value);
+    const statuses = { ...state.fieldValidationStatus, [name]: "unvalidated" };
+    const dependents = (options.fields ?? []).filter((field) => {
+      var _a;
+      return field.name !== name && ((_a = field.rules) == null ? void 0 : _a.countryField) === name;
+    });
+    const errors = { ...state.errors };
+    for (const field of dependents) {
+      statuses[field.name] = "unvalidated";
+      delete errors[field.name];
+    }
     valuesRevision += 1;
-    state = { ...state, values: nextValues, dirty: !valuesEqual(nextValues, state.initialValues) };
+    state = {
+      ...state,
+      values: nextValues,
+      errors,
+      dirty: !valuesEqual(nextValues, state.initialValues),
+      validationStatus: "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: statuses
+    };
     for (const field of options.fields ?? []) {
       if (field.hidden && state.errors[field.name] && (typeof field.hidden === "function" ? field.hidden(nextValues) : field.hidden)) {
         setFieldError(field.name, void 0);
       }
     }
     notifyValuePath(name);
+    for (const field of dependents) notifyField(field.name);
     if (validateOnChange && validationAdapter && validationSchema) {
       const revision = valuesRevision;
-      void runFieldValidation(name).catch((error) => {
-        if (revision === valuesRevision) setFieldError(name, error instanceof Error ? error.message : "Validation failed");
-      });
+      for (const fieldName of [name, ...dependents.map((field) => field.name)]) {
+        void runFieldValidation(fieldName).catch((error) => {
+          if (revision === valuesRevision) {
+            setFieldError(fieldName, error instanceof Error ? error.message : "Validation failed");
+          }
+        });
+      }
     }
   }
   function setFieldTouched(name, touched = true) {
@@ -101,23 +127,39 @@ function createFormStore(options) {
     }
   }
   function setFieldError(name, error) {
-    const next = { ...state.errors };
-    if (error) {
-      next[name] = error;
-    } else {
-      delete next[name];
-    }
-    state = { ...state, errors: next };
+    const errors = { ...state.errors };
+    if (error) errors[name] = error;
+    else delete errors[name];
+    state = {
+      ...state,
+      errors,
+      validationStatus: Object.keys(errors).length ? "invalid" : "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: { ...state.fieldValidationStatus, [name]: error ? "invalid" : "unvalidated" }
+    };
     notifyField(name);
     notify();
   }
   function setValues(values) {
     valuesRevision += 1;
-    state = { ...state, values, dirty: !valuesEqual(values, state.initialValues) };
+    state = {
+      ...state,
+      values,
+      dirty: !valuesEqual(values, state.initialValues),
+      validationStatus: "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: {}
+    };
     notifyAllFields();
   }
   function setErrors(errors) {
-    state = { ...state, errors };
+    state = {
+      ...state,
+      errors,
+      validationStatus: Object.keys(errors).length ? "invalid" : "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: {}
+    };
     notifyAllFields();
   }
   function setFieldArrayValue(name, items, origins) {
@@ -150,7 +192,10 @@ function createFormStore(options) {
       values,
       dirty: !valuesEqual(values, state.initialValues),
       errors: remap(state.errors),
-      touched: remap(state.touched)
+      touched: remap(state.touched),
+      validationStatus: "unvalidated",
+      isValidating: false,
+      fieldValidationStatus: remap(state.fieldValidationStatus)
     };
     notifyValuePath(name);
   }
@@ -160,6 +205,9 @@ function createFormStore(options) {
       values: newValues,
       errors: {},
       touched: {},
+      validationStatus: "unvalidated",
+      fieldValidationStatus: {},
+      isValidating: false,
       dirty: false,
       isSubmitting: false,
       submitCount: state.submitCount,
@@ -172,12 +220,30 @@ function createFormStore(options) {
     if (!validationAdapter || !validationSchema) return {};
     const revision = valuesRevision;
     const request = ++formRequest;
-    const errors = await validationAdapter.validate(validationSchema, state.values);
-    if (revision !== valuesRevision || request !== formRequest) return state.errors;
-    state = { ...state, errors };
+    state = { ...state, validationStatus: "validating", isValidating: true };
     notify();
-    for (const name of fieldSubscribers.keys()) notifyField(name);
-    return errors;
+    try {
+      const errors = await validationAdapter.validate(validationSchema, state.values);
+      if (revision !== valuesRevision || request !== formRequest) return state.errors;
+      const statuses = { ...state.fieldValidationStatus };
+      for (const field of options.fields ?? []) statuses[field.name] = errors[field.name] ? "invalid" : "valid";
+      state = {
+        ...state,
+        errors,
+        validationStatus: Object.keys(errors).length ? "invalid" : "valid",
+        isValidating: false,
+        fieldValidationStatus: statuses
+      };
+      notify();
+      for (const name of fieldSubscribers.keys()) notifyField(name);
+      return errors;
+    } catch (error) {
+      if (revision === valuesRevision && request === formRequest) {
+        state = { ...state, validationStatus: "unvalidated", isValidating: false };
+        notify();
+      }
+      throw error;
+    }
   }
   async function validateField(name) {
     var _a;
@@ -186,17 +252,47 @@ function createFormStore(options) {
     const request = (fieldRequests.get(name) ?? 0) + 1;
     fieldRequests.set(name, request);
     const config = (_a = options.fields) == null ? void 0 : _a.find((field) => field.name === name);
-    if ((config == null ? void 0 : config.hidden) && (typeof config.hidden === "function" ? config.hidden(state.values) : config.hidden)) {
+    const hidden = (config == null ? void 0 : config.hidden) && (typeof config.hidden === "function" ? config.hidden(state.values) : config.hidden);
+    if (hidden) {
       setFieldError(name, void 0);
+      state = { ...state, fieldValidationStatus: { ...state.fieldValidationStatus, [name]: "valid" } };
+      notifyField(name);
+      notify();
       return void 0;
     }
+    state = {
+      ...state,
+      fieldValidationStatus: { ...state.fieldValidationStatus, [name]: "validating" },
+      validationStatus: state.validationStatus === "validating" ? "validating" : "unvalidated"
+    };
+    notifyField(name);
+    notify();
     const fieldValue = get(state.values, name);
-    const error = await validationAdapter.validateField(validationSchema, name, fieldValue);
-    if (revision === valuesRevision && request === fieldRequests.get(name)) {
-      setFieldError(name, error);
-      return error;
+    try {
+      const error = await validationAdapter.validateField(validationSchema, name, fieldValue, state.values);
+      if (revision === valuesRevision && request === fieldRequests.get(name)) {
+        const errors = { ...state.errors };
+        if (error) errors[name] = error;
+        else delete errors[name];
+        state = {
+          ...state,
+          errors,
+          validationStatus: state.validationStatus === "validating" ? "validating" : Object.keys(errors).length ? "invalid" : "unvalidated",
+          fieldValidationStatus: { ...state.fieldValidationStatus, [name]: error ? "invalid" : "valid" }
+        };
+        notifyField(name);
+        notify();
+        return error;
+      }
+      return state.errors[name];
+    } catch (error) {
+      if (revision === valuesRevision && request === fieldRequests.get(name)) {
+        state = { ...state, fieldValidationStatus: { ...state.fieldValidationStatus, [name]: "unvalidated" } };
+        notifyField(name);
+        notify();
+      }
+      throw error;
     }
-    return state.errors[name];
   }
   async function runFieldValidation(name) {
     if (validationAdapter == null ? void 0 : validationAdapter.validateField) {

package/dist/core/semanticValidation.cjs

@@ -4,8 +4,8 @@ const pathUtils = require("./pathUtils.cjs");
 function isHidden(field, values) {
   return typeof field.hidden === "function" ? Boolean(field.hidden(values)) : Boolean(field.hidden);
 }
-function validateSemanticValue(field, value, policy) {
-  var _a;
+function validateSemanticValue(field, value, policy, values = {}) {
+  var _a, _b;
   if (field.validation) return void 0;
   const rules = field.rules;
   const inferred = field.type === "tel" ? "phone" : field.type;
@@ -29,13 +29,23 @@ function validateSemanticValue(field, value, policy) {
     const region = ((rules == null ? void 0 : rules.region) ?? "").toUpperCase();
     valid = region === "ID" ? /^(?:\+62|62|0)8\d{7,11}$/u.test(clean) : /^\+[1-9]\d{7,14}$/u.test(clean);
   } else if (format === "postalCode") {
-    const country = ((rules == null ? void 0 : rules.country) ?? "").toUpperCase();
+    const resolved = ((_a = rules == null ? void 0 : rules.countryResolver) == null ? void 0 : _a.call(rules, values)) ?? ((rules == null ? void 0 : rules.countryField) ? pathUtils.get(values, rules.countryField) : void 0) ?? (rules == null ? void 0 : rules.country);
+    const country = typeof resolved === "string" ? resolved.trim().toUpperCase() : "";
+    if (!country && ((rules == null ? void 0 : rules.countryField) || (rules == null ? void 0 : rules.countryResolver))) return void 0;
     const patterns = {
       ID: /^\d{5}$/u,
       US: /^\d{5}(?:-\d{4})?$/u,
-      SG: /^\d{6}$/u
+      SG: /^\d{6}$/u,
+      JP: /^\d{3}-?\d{4}$/u,
+      GB: /^(?:GIR\s?0AA|[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2})$/iu,
+      UK: /^(?:GIR\s?0AA|[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2})$/iu
     };
-    valid = Boolean((_a = patterns[country]) == null ? void 0 : _a.test(input));
+    const validator = ((_b = policy == null ? void 0 : policy.postalCodePatterns) == null ? void 0 : _b[country]) ?? patterns[country];
+    if (!validator) valid = (policy == null ? void 0 : policy.unknownCountry) === "ignore";
+    else if (validator instanceof RegExp) {
+      validator.lastIndex = 0;
+      valid = validator.test(input);
+    } else valid = Boolean(validator(input, values));
   }
   return valid ? void 0 : (rules == null ? void 0 : rules.message) ?? `Invalid ${format}`;
 }
@@ -51,17 +61,20 @@ function withValidationPolicy(adapter, policy) {
         if (isHidden(field, values)) {
           delete errors[field.name];
         } else if (!errors[field.name]) {
-          const error = validateSemanticValue(field, pathUtils.get(values, field.name), policy);
+          const error = validateSemanticValue(field, pathUtils.get(values, field.name), policy, values);
           if (error) errors[field.name] = error;
         }
       }
       return errors;
     },
-    async validateField(schema, name, value) {
+    async validateField(schema, name, value, values) {
       var _a;
       const { base, fields } = schema;
-      const error = await ((_a = adapter.validateField) == null ? void 0 : _a.call(adapter, base, name, value));
-      return error ?? validateSemanticValue(fields.find((f) => f.name === name) ?? { type: "text" }, value, policy);
+      const context = values ?? { [name]: value };
+      const field = fields.find((f) => f.name === name) ?? { name, type: "text" };
+      if (isHidden(field, context)) return void 0;
+      const error = await ((_a = adapter.validateField) == null ? void 0 : _a.call(adapter, base, name, value, context));
+      return error ?? validateSemanticValue(field, value, policy, context);
     }
   };
 }

package/dist/core/semanticValidation.d.ts

@@ -1,5 +1,5 @@
 import { FieldConfig, ValidationAdapter, ValidationPolicy } from '../types';
 /** Optional semantics: custom Yup/Zod field schemas retain precedence. */
-export declare function validateSemanticValue(field: FieldConfig, value: unknown, policy?: ValidationPolicy): string | undefined;
+export declare function validateSemanticValue(field: FieldConfig, value: unknown, policy?: ValidationPolicy, values?: Record<string, unknown>): string | undefined;
 /** Adapter-independent policy wrapper. No mandatory Yup, Zod, or UI dependencies. */
 export declare function withValidationPolicy(adapter: ValidationAdapter, policy?: ValidationPolicy): ValidationAdapter;

package/dist/core/semanticValidation.js

@@ -2,8 +2,8 @@ import { get } from "./pathUtils.js";
 function isHidden(field, values) {
   return typeof field.hidden === "function" ? Boolean(field.hidden(values)) : Boolean(field.hidden);
 }
-function validateSemanticValue(field, value, policy) {
-  var _a;
+function validateSemanticValue(field, value, policy, values = {}) {
+  var _a, _b;
   if (field.validation) return void 0;
   const rules = field.rules;
   const inferred = field.type === "tel" ? "phone" : field.type;
@@ -27,13 +27,23 @@ function validateSemanticValue(field, value, policy) {
     const region = ((rules == null ? void 0 : rules.region) ?? "").toUpperCase();
     valid = region === "ID" ? /^(?:\+62|62|0)8\d{7,11}$/u.test(clean) : /^\+[1-9]\d{7,14}$/u.test(clean);
   } else if (format === "postalCode") {
-    const country = ((rules == null ? void 0 : rules.country) ?? "").toUpperCase();
+    const resolved = ((_a = rules == null ? void 0 : rules.countryResolver) == null ? void 0 : _a.call(rules, values)) ?? ((rules == null ? void 0 : rules.countryField) ? get(values, rules.countryField) : void 0) ?? (rules == null ? void 0 : rules.country);
+    const country = typeof resolved === "string" ? resolved.trim().toUpperCase() : "";
+    if (!country && ((rules == null ? void 0 : rules.countryField) || (rules == null ? void 0 : rules.countryResolver))) return void 0;
     const patterns = {
       ID: /^\d{5}$/u,
       US: /^\d{5}(?:-\d{4})?$/u,
-      SG: /^\d{6}$/u
+      SG: /^\d{6}$/u,
+      JP: /^\d{3}-?\d{4}$/u,
+      GB: /^(?:GIR\s?0AA|[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2})$/iu,
+      UK: /^(?:GIR\s?0AA|[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2})$/iu
     };
-    valid = Boolean((_a = patterns[country]) == null ? void 0 : _a.test(input));
+    const validator = ((_b = policy == null ? void 0 : policy.postalCodePatterns) == null ? void 0 : _b[country]) ?? patterns[country];
+    if (!validator) valid = (policy == null ? void 0 : policy.unknownCountry) === "ignore";
+    else if (validator instanceof RegExp) {
+      validator.lastIndex = 0;
+      valid = validator.test(input);
+    } else valid = Boolean(validator(input, values));
   }
   return valid ? void 0 : (rules == null ? void 0 : rules.message) ?? `Invalid ${format}`;
 }
@@ -49,17 +59,20 @@ function withValidationPolicy(adapter, policy) {
         if (isHidden(field, values)) {
           delete errors[field.name];
         } else if (!errors[field.name]) {
-          const error = validateSemanticValue(field, get(values, field.name), policy);
+          const error = validateSemanticValue(field, get(values, field.name), policy, values);
           if (error) errors[field.name] = error;
         }
       }
       return errors;
     },
-    async validateField(schema, name, value) {
+    async validateField(schema, name, value, values) {
       var _a;
       const { base, fields } = schema;
-      const error = await ((_a = adapter.validateField) == null ? void 0 : _a.call(adapter, base, name, value));
-      return error ?? validateSemanticValue(fields.find((f) => f.name === name) ?? { type: "text" }, value, policy);
+      const context = values ?? { [name]: value };
+      const field = fields.find((f) => f.name === name) ?? { name, type: "text" };
+      if (isHidden(field, context)) return void 0;
+      const error = await ((_a = adapter.validateField) == null ? void 0 : _a.call(adapter, base, name, value, context));
+      return error ?? validateSemanticValue(field, value, policy, context);
     }
   };
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { ArrayFieldConfig, ArrayHelpers, AutocompleteOption, AxenFormProps, AxenFormRef, BoxProps, Breakpoint, BuiltInFieldType, DividerProps, FieldComponentProps, FieldConfig, FieldGroupConfig, FieldOption, FieldTypeComponentMap, FormApi, FormConfig, GridProps, GridSize, PayloadConfig, SpacerProps, StackProps, ValidationAdapter, ValidationPolicy, ValidationRules, } from './types';
+export type { ArrayFieldConfig, ArrayHelpers, AutocompleteOption, AxenFormProps, AxenFormRef, BoxProps, Breakpoint, BuiltInFieldType, DividerProps, FieldComponentProps, FieldConfig, FieldGroupConfig, FieldOption, FieldTypeComponentMap, FormApi, FormConfig, GridProps, GridSize, PayloadConfig, SpacerProps, StackProps, ValidationAdapter, ValidationPolicy, ValidationRules, ValidationStatus, } from './types';
 export { isFieldGroup } from './types';
 export { formatDateLocale, formatDateTimeLocale, formatTimeLocale, getDefaultLocale, toISODateString, toISODateTimeLocalString, toISOTimeString, } from './core/dateUtils';
 export { createFormStore } from './core/formStore';

package/dist/react/AxenArrayField.cjs

@@ -57,6 +57,8 @@ function ArrayItemField({
         touched: store.getState().touched,
         dirty: store.getState().dirty,
         isSubmitting: store.getState().isSubmitting,
+        validationStatus: store.getState().validationStatus,
+        fieldValidationStatus: store.getState().fieldValidationStatus,
         isValid: Object.keys(store.getState().errors).length === 0,
         submitCount: store.getState().submitCount,
         setFieldValue: store.setFieldValue,

package/dist/react/AxenArrayField.js

@@ -55,6 +55,8 @@ function ArrayItemField({
         touched: store.getState().touched,
         dirty: store.getState().dirty,
         isSubmitting: store.getState().isSubmitting,
+        validationStatus: store.getState().validationStatus,
+        fieldValidationStatus: store.getState().fieldValidationStatus,
         isValid: Object.keys(store.getState().errors).length === 0,
         submitCount: store.getState().submitCount,
         setFieldValue: store.setFieldValue,

package/dist/react/AxenField.cjs

@@ -29,6 +29,8 @@ function AxenField({ name, config, component, children }) {
       touched: store.getState().touched,
       dirty: store.getState().dirty,
       isSubmitting: store.getState().isSubmitting,
+      validationStatus: store.getState().validationStatus,
+      fieldValidationStatus: store.getState().fieldValidationStatus,
       isValid: Object.keys(store.getState().errors).length === 0,
       submitCount: store.getState().submitCount,
       setFieldValue: store.setFieldValue,

package/dist/react/AxenField.js

@@ -27,6 +27,8 @@ function AxenField({ name, config, component, children }) {
       touched: store.getState().touched,
       dirty: store.getState().dirty,
       isSubmitting: store.getState().isSubmitting,
+      validationStatus: store.getState().validationStatus,
+      fieldValidationStatus: store.getState().fieldValidationStatus,
       isValid: Object.keys(store.getState().errors).length === 0,
       submitCount: store.getState().submitCount,
       setFieldValue: store.setFieldValue,

package/dist/react/useAxenForm.cjs

@@ -70,6 +70,12 @@ function useAxenForm(props) {
       get isSubmitting() {
         return store.getState().isSubmitting;
       },
+      get validationStatus() {
+        return store.getState().validationStatus;
+      },
+      get fieldValidationStatus() {
+        return store.getState().fieldValidationStatus;
+      },
       get isValid() {
         return Object.keys(store.getState().errors).length === 0;
       },

package/dist/react/useAxenForm.js

@@ -68,6 +68,12 @@ function useAxenForm(props) {
       get isSubmitting() {
         return store.getState().isSubmitting;
       },
+      get validationStatus() {
+        return store.getState().validationStatus;
+      },
+      get fieldValidationStatus() {
+        return store.getState().fieldValidationStatus;
+      },
       get isValid() {
         return Object.keys(store.getState().errors).length === 0;
       },

package/dist/types.d.ts

@@ -17,13 +17,20 @@ export interface ValidationRules {
     format?: 'email' | 'url' | 'phone' | 'postalCode';
     region?: string;
     country?: string;
+    /** Resolve country from a sibling or nested form field. */
+    countryField?: string;
+    /** Optional custom country resolver, taking precedence over countryField. */
+    countryResolver?: (values: Record<string, unknown>) => string | undefined;
     message?: string;
 }
 /** Legacy required-only mode remains the default. */
 export interface ValidationPolicy {
     mode?: 'legacy-required-only' | 'standard';
     locale?: string;
+    postalCodePatterns?: Record<string, RegExp | ((code: string, values: Record<string, unknown>) => boolean)>;
+    unknownCountry?: 'reject' | 'ignore';
 }
+export type ValidationStatus = 'unvalidated' | 'validating' | 'valid' | 'invalid';
 /** Base field configuration */
 export interface FieldConfig<TValues extends Record<string, unknown> = Record<string, unknown>> {
     name: string;
@@ -125,6 +132,8 @@ export interface FormApi<TValues extends Record<string, unknown> = Record<string
     touched: Record<string, boolean>;
     dirty: boolean;
     isSubmitting: boolean;
+    validationStatus: ValidationStatus;
+    fieldValidationStatus: Record<string, ValidationStatus>;
     isValid: boolean;
     submitCount: number;
     setFieldValue: (name: string, value: unknown) => void;
@@ -183,7 +192,7 @@ export interface AxenFormProps<TValues extends Record<string, unknown> = Record<
 export interface ValidationAdapter {
     buildSchema: (fields: FieldConfig[]) => unknown;
     validate: (schema: unknown, values: Record<string, unknown>) => Promise<Record<string, string>>;
-    validateField?: (schema: unknown, name: string, value: unknown) => Promise<string | undefined>;
+    validateField?: (schema: unknown, name: string, value: unknown, values?: Record<string, unknown>) => Promise<string | undefined>;
 }
 export interface ArrayHelpers {
     push: (value: unknown) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axenstudio/axen-form",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Lightweight, config-driven, enterprise-grade React form library. Zero UI dependency. CSS Modules. A11y-aware.",
   "type": "module",
   "main": "./dist/index.cjs",