@validex/core 1.0.0

package/dist/index.cjs

@@ -0,0 +1,361 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkPQ4TUE2Qcjs = require('./chunk-PQ4TUE2Q.cjs');
+require('./chunk-TSPTIW3V.cjs');
+require('./chunk-OCTLUBGT.cjs');
+require('./chunk-WE2OD5XD.cjs');
+require('./chunk-2OTGUKO7.cjs');
+require('./chunk-5CYBSNNG.cjs');
+require('./chunk-D232V332.cjs');
+require('./chunk-P3FRVJ3U.cjs');
+require('./chunk-ZWIO2MJX.cjs');
+require('./chunk-ZAUX2RGL.cjs');
+require('./chunk-JEKRBIPN.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkOFT3FQPJcjs = require('./chunk-OFT3FQPJ.cjs');
+
+
+
+var _chunkH3XHQLZFcjs = require('./chunk-H3XHQLZF.cjs');
+require('./chunk-ISY3F7TI.cjs');
+
+
+var _chunkLSQNDPFQcjs = require('./chunk-LSQNDPFQ.cjs');
+require('./chunk-64X6D23X.cjs');
+
+// src/core/validate.ts
+var _zod = require('zod');
+
+// src/core/crossFieldResolver.ts
+
+function deriveFieldLabel(fieldName, explicitLabel, prefix) {
+  if (explicitLabel !== void 0)
+    return explicitLabel;
+  const config = _chunkPQ4TUE2Qcjs.getConfig.call(void 0, );
+  const fallback = _nullishCoalesce(_optionalChain([config, 'access', _ => _.label, 'optionalAccess', _2 => _2.fallback]), () => ( "derived"));
+  let defaultLabel;
+  if (fallback === "none")
+    defaultLabel = "";
+  else if (fallback === "generic")
+    defaultLabel = "This field";
+  else
+    defaultLabel = _chunkPQ4TUE2Qcjs.fieldNameToLabel.call(void 0, fieldName);
+  if (_optionalChain([config, 'access', _3 => _3.label, 'optionalAccess', _4 => _4.transform]) !== void 0) {
+    const path = [..._nullishCoalesce(prefix, () => ( [])), fieldName];
+    return config.label.transform({ path, fieldName, defaultLabel });
+  }
+  return defaultLabel;
+}
+function resolveCrossFieldMessage(namespace, code, params) {
+  const config = _chunkPQ4TUE2Qcjs.getConfig.call(void 0, );
+  const i18n = config.i18n;
+  const pfx = _nullishCoalesce(i18n.prefix, () => ( "validation"));
+  const sep = _nullishCoalesce(i18n.separator, () => ( "."));
+  const key = [pfx, "messages", namespace, code].join(sep);
+  if (i18n.enabled && i18n.t !== void 0)
+    return i18n.t(key, params);
+  if (i18n.enabled)
+    return key;
+  return _chunkPQ4TUE2Qcjs.getErrorMessage.call(void 0, namespace, code, params);
+}
+function resolveSameAs(fieldName, sameAs2, shape, parsedData, meta, prefix) {
+  if (!(sameAs2 in shape)) {
+    throw new Error(
+      `validex: sameAs("${sameAs2}") on field "${fieldName}" \u2014 target field "${sameAs2}" does not exist in the schema`
+    );
+  }
+  const sourceValue = _optionalChain([parsedData, 'optionalAccess', _5 => _5[fieldName]]);
+  const targetValue = _optionalChain([parsedData, 'optionalAccess', _6 => _6[sameAs2]]);
+  if (sourceValue === targetValue)
+    return void 0;
+  const targetSchema = shape[sameAs2];
+  const targetMeta = targetSchema !== void 0 ? _chunkPQ4TUE2Qcjs.getCrossField.call(void 0, targetSchema) : void 0;
+  const label = deriveFieldLabel(fieldName, meta.label, prefix);
+  const targetLabel = deriveFieldLabel(sameAs2, _optionalChain([targetMeta, 'optionalAccess', _7 => _7.label]), prefix);
+  return {
+    path: [...prefix, fieldName],
+    message: resolveCrossFieldMessage("confirmation", "mismatch", {
+      label,
+      targetLabel,
+      code: "mismatch",
+      namespace: "confirmation"
+    })
+  };
+}
+function resolveRequiredWhen(fieldName, targetName, parsedData, rawObj, fieldErrors, meta, prefix) {
+  const targetDotPath = [...prefix, targetName].join(".");
+  if (fieldErrors.has(targetDotPath))
+    return void 0;
+  const targetValue = _optionalChain([parsedData, 'optionalAccess', _8 => _8[targetName]]);
+  if (targetValue === void 0 || targetValue === null || targetValue === "")
+    return void 0;
+  const rawValue = rawObj[fieldName];
+  if (rawValue !== void 0 && rawValue !== null && rawValue !== "")
+    return void 0;
+  const label = deriveFieldLabel(fieldName, meta.label, prefix);
+  return {
+    path: [...prefix, fieldName],
+    message: resolveCrossFieldMessage("base", "required", {
+      label,
+      code: "required",
+      namespace: "base"
+    })
+  };
+}
+function resolveFieldConstraint(fieldName, shape, parsedData, rawObj, fieldErrors, prefix) {
+  const fieldSchema = shape[fieldName];
+  if (fieldSchema === void 0)
+    return [];
+  const meta = _chunkPQ4TUE2Qcjs.getCrossField.call(void 0, fieldSchema);
+  if (meta === void 0)
+    return [];
+  const issues = [];
+  const dotPath = [...prefix, fieldName].join(".");
+  if (meta.sameAs !== void 0 && !fieldErrors.has(dotPath)) {
+    const issue = resolveSameAs(fieldName, meta.sameAs, shape, parsedData, meta, prefix);
+    if (issue !== void 0)
+      issues.push(issue);
+  }
+  if (meta.requiredWhen !== void 0) {
+    const issue = resolveRequiredWhen(fieldName, meta.requiredWhen, parsedData, rawObj, fieldErrors, meta, prefix);
+    if (issue !== void 0)
+      issues.push(issue);
+  }
+  return issues;
+}
+function resolveCrossFieldConstraints(schema, parsedData, fieldErrors, rawData, prefix = []) {
+  const shape = schema.shape;
+  const rawObj = typeof rawData === "object" && rawData !== null ? rawData : {};
+  const issues = [];
+  for (const fieldName of Object.keys(shape)) {
+    issues.push(...resolveFieldConstraint(fieldName, shape, parsedData, rawObj, fieldErrors, prefix));
+  }
+  for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+    if (fieldSchema instanceof _zod.z.ZodObject) {
+      const nestedParsed = _optionalChain([parsedData, 'optionalAccess', _9 => _9[fieldName]]);
+      issues.push(...resolveCrossFieldConstraints(
+        fieldSchema,
+        nestedParsed,
+        fieldErrors,
+        rawObj[fieldName],
+        [...prefix, fieldName]
+      ));
+    }
+  }
+  return issues;
+}
+
+// src/core/validate.ts
+function buildDotPath(path) {
+  return path.map(String).join(".");
+}
+function buildNestedErrors(issues) {
+  const root = {};
+  for (const issue of issues) {
+    const { path, message } = issue;
+    if (path.length === 0)
+      continue;
+    let current = root;
+    for (let i = 0; i < path.length - 1; i++) {
+      const segment = String(path[i]);
+      if (current[segment] === void 0)
+        current[segment] = {};
+      current = current[segment];
+    }
+    const lastSegment = String(path.at(-1));
+    const existing = current[lastSegment];
+    if (Array.isArray(existing))
+      existing.push(message);
+    else
+      current[lastSegment] = [message];
+  }
+  return root;
+}
+function collectIssues(issues, errors, firstErrors) {
+  for (const issue of issues) {
+    const dotPath = buildDotPath(issue.path);
+    if (errors[dotPath] === void 0) {
+      errors[dotPath] = [];
+      firstErrors[dotPath] = issue.message;
+    }
+    errors[dotPath].push(issue.message);
+  }
+}
+async function validate(schema, data) {
+  _chunkPQ4TUE2Qcjs.initAugmentation.call(void 0, );
+  const result = await schema.safeParseAsync(data);
+  if (result.success)
+    return handleSuccess(schema, result.data, data);
+  return handleFailure(schema, result.error, data);
+}
+function handleSuccess(schema, parsed, raw) {
+  if (schema instanceof _zod.z.ZodObject) {
+    const crossIssues = resolveCrossFieldConstraints(schema, parsed, /* @__PURE__ */ new Set(), raw);
+    if (crossIssues.length > 0) {
+      const errors = {};
+      const firstErrors = {};
+      collectIssues(crossIssues, errors, firstErrors);
+      return { success: false, errors, firstErrors, nestedErrors: buildNestedErrors(crossIssues), issues: crossIssues };
+    }
+  }
+  return {
+    success: true,
+    data: parsed,
+    // SAFETY: Zod safeParseAsync returns inferred output type on success
+    errors: {},
+    firstErrors: {},
+    nestedErrors: {},
+    issues: []
+  };
+}
+function handleFailure(schema, error, raw) {
+  const rawIssues = error.issues;
+  const errors = {};
+  const firstErrors = {};
+  const fieldErrors = /* @__PURE__ */ new Set();
+  for (const issue of rawIssues) {
+    const dotPath = buildDotPath(issue.path);
+    fieldErrors.add(dotPath);
+    if (errors[dotPath] === void 0) {
+      errors[dotPath] = [];
+      firstErrors[dotPath] = issue.message;
+    }
+    errors[dotPath].push(issue.message);
+  }
+  if (schema instanceof _zod.z.ZodObject) {
+    const rawObj = typeof raw === "object" && raw !== null ? raw : {};
+    const crossIssues = resolveCrossFieldConstraints(schema, rawObj, fieldErrors, raw);
+    collectIssues(crossIssues, errors, firstErrors);
+    if (crossIssues.length > 0) {
+      const allIssues = [...rawIssues, ...crossIssues];
+      return { success: false, errors, firstErrors, nestedErrors: buildNestedErrors(allIssues), issues: allIssues };
+    }
+  }
+  return {
+    success: false,
+    errors,
+    firstErrors,
+    nestedErrors: buildNestedErrors(rawIssues),
+    // SAFETY: issues escape hatch exposes raw Zod issues as ReadonlyArray<unknown> for consumers
+    issues: error.issues
+  };
+}
+
+// src/index.ts
+_chunkPQ4TUE2Qcjs.initAugmentation.call(void 0, );
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.BusinessName = _chunkPQ4TUE2Qcjs.BusinessName; exports.Color = _chunkPQ4TUE2Qcjs.Color; exports.Country = _chunkPQ4TUE2Qcjs.Country; exports.CreditCard = _chunkPQ4TUE2Qcjs.CreditCard; exports.Currency = _chunkPQ4TUE2Qcjs.Currency; exports.DateTime = _chunkPQ4TUE2Qcjs.DateTime; exports.Email = _chunkPQ4TUE2Qcjs.Email; exports.Iban = _chunkPQ4TUE2Qcjs.Iban; exports.IpAddress = _chunkPQ4TUE2Qcjs.IpAddress; exports.Jwt = _chunkPQ4TUE2Qcjs.Jwt; exports.LicenseKey = _chunkPQ4TUE2Qcjs.LicenseKey; exports.MacAddress = _chunkPQ4TUE2Qcjs.MacAddress; exports.Password = _chunkPQ4TUE2Qcjs.Password; exports.PasswordConfirmation = _chunkPQ4TUE2Qcjs.PasswordConfirmation; exports.PersonName = _chunkPQ4TUE2Qcjs.PersonName; exports.Phone = _chunkPQ4TUE2Qcjs.Phone; exports.PostalCode = _chunkPQ4TUE2Qcjs.PostalCode; exports.Slug = _chunkPQ4TUE2Qcjs.Slug; exports.Text = _chunkPQ4TUE2Qcjs.Text; exports.Token = _chunkPQ4TUE2Qcjs.Token; exports.Url = _chunkPQ4TUE2Qcjs.Url; exports.Username = _chunkPQ4TUE2Qcjs.Username; exports.Uuid = _chunkPQ4TUE2Qcjs.Uuid; exports.VatNumber = _chunkPQ4TUE2Qcjs.VatNumber; exports.Website = _chunkPQ4TUE2Qcjs.Website; exports.collapseWhitespace = _chunkOFT3FQPJcjs.collapseWhitespace; exports.configure = _chunkPQ4TUE2Qcjs.configure; exports.containsEmail = _chunkOFT3FQPJcjs.containsEmail; exports.containsHtml = _chunkOFT3FQPJcjs.containsHtml; exports.containsPhoneNumber = _chunkLSQNDPFQcjs.containsPhoneNumber; exports.containsUrl = _chunkOFT3FQPJcjs.containsUrl; exports.createRule = _chunkPQ4TUE2Qcjs.createRule; exports.emptyToUndefined = _chunkOFT3FQPJcjs.emptyToUndefined; exports.getConfig = _chunkPQ4TUE2Qcjs.getConfig2; exports.getParams = _chunkPQ4TUE2Qcjs.getParams; exports.hasDigits = _chunkOFT3FQPJcjs.hasDigits; exports.hasLowercase = _chunkOFT3FQPJcjs.hasLowercase; exports.hasSpecial = _chunkOFT3FQPJcjs.hasSpecial; exports.hasUppercase = _chunkOFT3FQPJcjs.hasUppercase; exports.maxConsecutive = _chunkOFT3FQPJcjs.maxConsecutive; exports.maxWords = _chunkOFT3FQPJcjs.maxWords; exports.minWords = _chunkOFT3FQPJcjs.minWords; exports.noSpaces = _chunkOFT3FQPJcjs.noSpaces; exports.onlyAlpha = _chunkOFT3FQPJcjs.onlyAlpha; exports.onlyAlphaSpaceHyphen = _chunkOFT3FQPJcjs.onlyAlphaSpaceHyphen; exports.onlyAlphanumeric = _chunkOFT3FQPJcjs.onlyAlphanumeric; exports.onlyAlphanumericSpaceHyphen = _chunkOFT3FQPJcjs.onlyAlphanumericSpaceHyphen; exports.onlyNumeric = _chunkOFT3FQPJcjs.onlyNumeric; exports.preloadData = _chunkPQ4TUE2Qcjs.preloadData; exports.requiredWhen = _chunkH3XHQLZFcjs.requiredWhen; exports.resetConfig = _chunkPQ4TUE2Qcjs.resetConfig; exports.sameAs = _chunkH3XHQLZFcjs.sameAs; exports.setup = _chunkPQ4TUE2Qcjs.setup; exports.stripHtml = _chunkOFT3FQPJcjs.stripHtml; exports.toSlug = _chunkOFT3FQPJcjs.toSlug; exports.toTitleCase = _chunkOFT3FQPJcjs.toTitleCase; exports.validate = validate;

package/dist/index.d.cts

@@ -0,0 +1,132 @@
+import { G as GlobalConfig, P as PreloadOptions, B as BaseRuleOptions, C as CreateRuleOptions, R as RuleFactory, E as ErrorParams, V as ValidationResult } from './index-Cid7Ygr_.cjs';
+export { a as Boundary, b as BusinessName, c as BusinessNameOptions, d as CheckMethodOptions, e as Color, f as ColorOptions, g as CompositionMethodOptions, h as Country, i as CountryOptions, j as CreditCard, k as CreditCardOptions, l as Currency, m as CurrencyOptions, D as DateTime, n as DateTimeOptions, o as Email, p as EmailOptions, F as FormatRuleOptions, I as I18nConfig, q as Iban, r as IbanOptions, s as IpAddress, t as IpAddressOptions, u as IssuerType, J as JWTOptions, v as Jwt, L as LabelConfig, w as LabelTransform, x as LicenseKey, y as LicenseKeyOptions, M as MacAddress, z as MacAddressOptions, A as MaxConsecutiveOptions, H as MaxWordsOptions, K as MessageConfig, N as MessageTransform, O as MinWordsOptions, Q as NestedErrors, S as Password, T as PasswordConfirmation, U as PasswordConfirmationOptions, W as PasswordOptions, X as PathTransform, Y as PersonName, Z as PersonNameOptions, _ as Phone, $ as PhoneOptions, a0 as PostalCode, a1 as PostalCodeOptions, a2 as Range, a3 as RuleDefaults, a4 as Slug, a5 as SlugOptions, a6 as Text, a7 as TextOptions, a8 as Token, a9 as TokenOptions, aa as TokenType, ab as TranslationFunction, ac as URLOptions, ad as UUIDOptions, ae as Url, af as Username, ag as UsernameOptions, ah as Uuid, ai as VatNumber, aj as VatNumberOptions, ak as Website, al as WebsiteOptions } from './index-Cid7Ygr_.cjs';
+export { collapseWhitespace, containsEmail, containsHtml, containsPhoneNumber, containsUrl, emptyToUndefined, hasDigits, hasLowercase, hasSpecial, hasUppercase, maxConsecutive, maxWords, minWords, noSpaces, onlyAlpha, onlyAlphaSpaceHyphen, onlyAlphanumeric, onlyAlphanumericSpaceHyphen, onlyNumeric, stripHtml, toSlug, toTitleCase } from './checks/index.cjs';
+import { z } from 'zod';
+export { requiredWhen, sameAs } from './utilities/index.cjs';
+
+/**
+ * Reset Config
+ * Resets configuration to defaults. Used for testing only.
+ */
+declare function resetConfig(): void;
+
+/**
+ * Configure
+ * Deep-merges the given config into the current global configuration.
+ * Can be called multiple times — each call merges, never replaces.
+ * Does NOT register the Zod customError handler (use setup() for that).
+ *
+ * @param config - Partial configuration to merge.
+ */
+declare function configure(config: Partial<GlobalConfig>): void;
+/**
+ * Setup
+ * Configures validex globally and registers the customError handler with Zod.
+ * Deep merges with existing config if called multiple times.
+ *
+ * @param config - Partial configuration to apply.
+ */
+declare function setup(config?: Partial<GlobalConfig>): void;
+/**
+ * Get Config
+ * Returns the current global configuration.
+ *
+ * @returns The current readonly global configuration.
+ */
+declare function getConfig(): Readonly<GlobalConfig>;
+/**
+ * Preload Data
+ * Preloads async data files at startup so that sync .parse() works everywhere.
+ * Safe to call multiple times — already-loaded data is cached.
+ *
+ * @param options - Which data files to preload.
+ * @returns A promise that resolves when all requested data is loaded.
+ */
+declare function preloadData(options: PreloadOptions): Promise<void>;
+
+/**
+ * Create Rule
+ * Factory that builds a reusable validation rule with three-tier merge,
+ * empty-to-undefined preprocessing, and optional custom validation.
+ *
+ * @param config - The rule configuration object.
+ * @returns A RuleFactory function that accepts per-call options.
+ */
+declare function createRule<T extends BaseRuleOptions>(config: CreateRuleOptions<T>): RuleFactory<T>;
+
+/**
+ * ZodIssueInput
+ * Minimal shape of a Zod issue used for parameter extraction.
+ */
+interface ZodIssueInput {
+    readonly code?: string | undefined;
+    readonly path?: ReadonlyArray<string | number> | undefined;
+    readonly minimum?: unknown;
+    readonly maximum?: unknown;
+    readonly expected?: string | undefined;
+    readonly received?: string | undefined;
+    readonly input?: unknown;
+    readonly format?: string | undefined;
+    readonly params?: Readonly<Record<string, unknown>> | undefined;
+}
+/**
+ * Get Params
+ * Extracts validex ErrorParams from a Zod issue object.
+ *
+ * @param issue - A Zod issue (typed loosely for forward compatibility).
+ * @returns The normalized ErrorParams for the issue.
+ */
+declare function getParams(issue: ZodIssueInput): ErrorParams;
+
+/**
+ * Validate
+ * Runs Zod's safeParseAsync, resolves cross-field constraints (sameAs,
+ * requiredWhen), and returns a structured ValidationResult.
+ *
+ * @param schema - The Zod schema to validate against.
+ * @param data   - The unknown data to validate.
+ * @returns A promise resolving to a typed ValidationResult.
+ */
+declare function validate<T extends z.ZodType>(schema: T, data: unknown): Promise<ValidationResult<z.output<T>>>;
+
+/** Valid boundary character constraint values. */
+type BoundaryValue = 'alpha' | 'alphanumeric' | 'any';
+/**
+ * ResolvedBoundary
+ * Normalized boundary with start and end constraints.
+ */
+interface ResolvedBoundary {
+    readonly start: BoundaryValue;
+    readonly end: BoundaryValue;
+}
+
+/**
+ * ResolvedRange
+ * Normalized range with optional min and max.
+ */
+interface ResolvedRange {
+    readonly min?: number;
+    readonly max?: number;
+}
+
+/** CountryData — a single ISO 3166-1 country entry. */
+interface CountryData {
+    readonly alpha2: string;
+    readonly alpha3: string;
+    readonly name: string;
+}
+
+/** CardIssuer -- identification data for a single card network. */
+interface CardIssuer {
+    readonly name: string;
+    readonly prefixes: readonly string[];
+    readonly lengths: readonly number[];
+}
+
+/** IbanPattern — IBAN length and structural regex for one country. */
+interface IbanPattern {
+    readonly length: number;
+    readonly regex: RegExp;
+}
+
+export { BaseRuleOptions, type CardIssuer, type CountryData, CreateRuleOptions, ErrorParams, GlobalConfig, type IbanPattern, PreloadOptions, type ResolvedBoundary, type ResolvedRange, RuleFactory, ValidationResult, configure, createRule, getConfig, getParams, preloadData, resetConfig, setup, validate };

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+import { G as GlobalConfig, P as PreloadOptions, B as BaseRuleOptions, C as CreateRuleOptions, R as RuleFactory, E as ErrorParams, V as ValidationResult } from './index-Cid7Ygr_.js';
+export { a as Boundary, b as BusinessName, c as BusinessNameOptions, d as CheckMethodOptions, e as Color, f as ColorOptions, g as CompositionMethodOptions, h as Country, i as CountryOptions, j as CreditCard, k as CreditCardOptions, l as Currency, m as CurrencyOptions, D as DateTime, n as DateTimeOptions, o as Email, p as EmailOptions, F as FormatRuleOptions, I as I18nConfig, q as Iban, r as IbanOptions, s as IpAddress, t as IpAddressOptions, u as IssuerType, J as JWTOptions, v as Jwt, L as LabelConfig, w as LabelTransform, x as LicenseKey, y as LicenseKeyOptions, M as MacAddress, z as MacAddressOptions, A as MaxConsecutiveOptions, H as MaxWordsOptions, K as MessageConfig, N as MessageTransform, O as MinWordsOptions, Q as NestedErrors, S as Password, T as PasswordConfirmation, U as PasswordConfirmationOptions, W as PasswordOptions, X as PathTransform, Y as PersonName, Z as PersonNameOptions, _ as Phone, $ as PhoneOptions, a0 as PostalCode, a1 as PostalCodeOptions, a2 as Range, a3 as RuleDefaults, a4 as Slug, a5 as SlugOptions, a6 as Text, a7 as TextOptions, a8 as Token, a9 as TokenOptions, aa as TokenType, ab as TranslationFunction, ac as URLOptions, ad as UUIDOptions, ae as Url, af as Username, ag as UsernameOptions, ah as Uuid, ai as VatNumber, aj as VatNumberOptions, ak as Website, al as WebsiteOptions } from './index-Cid7Ygr_.js';
+export { collapseWhitespace, containsEmail, containsHtml, containsPhoneNumber, containsUrl, emptyToUndefined, hasDigits, hasLowercase, hasSpecial, hasUppercase, maxConsecutive, maxWords, minWords, noSpaces, onlyAlpha, onlyAlphaSpaceHyphen, onlyAlphanumeric, onlyAlphanumericSpaceHyphen, onlyNumeric, stripHtml, toSlug, toTitleCase } from './checks/index.js';
+import { z } from 'zod';
+export { requiredWhen, sameAs } from './utilities/index.js';
+
+/**
+ * Reset Config
+ * Resets configuration to defaults. Used for testing only.
+ */
+declare function resetConfig(): void;
+
+/**
+ * Configure
+ * Deep-merges the given config into the current global configuration.
+ * Can be called multiple times — each call merges, never replaces.
+ * Does NOT register the Zod customError handler (use setup() for that).
+ *
+ * @param config - Partial configuration to merge.
+ */
+declare function configure(config: Partial<GlobalConfig>): void;
+/**
+ * Setup
+ * Configures validex globally and registers the customError handler with Zod.
+ * Deep merges with existing config if called multiple times.
+ *
+ * @param config - Partial configuration to apply.
+ */
+declare function setup(config?: Partial<GlobalConfig>): void;
+/**
+ * Get Config
+ * Returns the current global configuration.
+ *
+ * @returns The current readonly global configuration.
+ */
+declare function getConfig(): Readonly<GlobalConfig>;
+/**
+ * Preload Data
+ * Preloads async data files at startup so that sync .parse() works everywhere.
+ * Safe to call multiple times — already-loaded data is cached.
+ *
+ * @param options - Which data files to preload.
+ * @returns A promise that resolves when all requested data is loaded.
+ */
+declare function preloadData(options: PreloadOptions): Promise<void>;
+
+/**
+ * Create Rule
+ * Factory that builds a reusable validation rule with three-tier merge,
+ * empty-to-undefined preprocessing, and optional custom validation.
+ *
+ * @param config - The rule configuration object.
+ * @returns A RuleFactory function that accepts per-call options.
+ */
+declare function createRule<T extends BaseRuleOptions>(config: CreateRuleOptions<T>): RuleFactory<T>;
+
+/**
+ * ZodIssueInput
+ * Minimal shape of a Zod issue used for parameter extraction.
+ */
+interface ZodIssueInput {
+    readonly code?: string | undefined;
+    readonly path?: ReadonlyArray<string | number> | undefined;
+    readonly minimum?: unknown;
+    readonly maximum?: unknown;
+    readonly expected?: string | undefined;
+    readonly received?: string | undefined;
+    readonly input?: unknown;
+    readonly format?: string | undefined;
+    readonly params?: Readonly<Record<string, unknown>> | undefined;
+}
+/**
+ * Get Params
+ * Extracts validex ErrorParams from a Zod issue object.
+ *
+ * @param issue - A Zod issue (typed loosely for forward compatibility).
+ * @returns The normalized ErrorParams for the issue.
+ */
+declare function getParams(issue: ZodIssueInput): ErrorParams;
+
+/**
+ * Validate
+ * Runs Zod's safeParseAsync, resolves cross-field constraints (sameAs,
+ * requiredWhen), and returns a structured ValidationResult.
+ *
+ * @param schema - The Zod schema to validate against.
+ * @param data   - The unknown data to validate.
+ * @returns A promise resolving to a typed ValidationResult.
+ */
+declare function validate<T extends z.ZodType>(schema: T, data: unknown): Promise<ValidationResult<z.output<T>>>;
+
+/** Valid boundary character constraint values. */
+type BoundaryValue = 'alpha' | 'alphanumeric' | 'any';
+/**
+ * ResolvedBoundary
+ * Normalized boundary with start and end constraints.
+ */
+interface ResolvedBoundary {
+    readonly start: BoundaryValue;
+    readonly end: BoundaryValue;
+}
+
+/**
+ * ResolvedRange
+ * Normalized range with optional min and max.
+ */
+interface ResolvedRange {
+    readonly min?: number;
+    readonly max?: number;
+}
+
+/** CountryData — a single ISO 3166-1 country entry. */
+interface CountryData {
+    readonly alpha2: string;
+    readonly alpha3: string;
+    readonly name: string;
+}
+
+/** CardIssuer -- identification data for a single card network. */
+interface CardIssuer {
+    readonly name: string;
+    readonly prefixes: readonly string[];
+    readonly lengths: readonly number[];
+}
+
+/** IbanPattern — IBAN length and structural regex for one country. */
+interface IbanPattern {
+    readonly length: number;
+    readonly regex: RegExp;
+}
+
+export { BaseRuleOptions, type CardIssuer, type CountryData, CreateRuleOptions, ErrorParams, GlobalConfig, type IbanPattern, PreloadOptions, type ResolvedBoundary, type ResolvedRange, RuleFactory, ValidationResult, configure, createRule, getConfig, getParams, preloadData, resetConfig, setup, validate };