z-schema 12.0.4 → 12.1.0

package/cjs/index.d.ts

@@ -1,7 +1,8 @@
+//#region src/format-validators.d.ts
 type FormatValidatorFn = (input: unknown) => boolean | Promise<boolean>;
 interface FormatValidatorsOptions {
-    strictUris?: boolean;
-    customFormats?: Record<string, FormatValidatorFn | null>;
+  strictUris?: boolean;
+  customFormats?: Record<string, FormatValidatorFn | null>;
 }
 declare function getFormatValidators(options?: FormatValidatorsOptions): Record<string, FormatValidatorFn>;
 declare function registerFormat(name: string, validatorFunction: FormatValidatorFn): void;
@@ -9,82 +10,84 @@ declare function unregisterFormat(name: string): void;
 declare function getSupportedFormats(customFormats?: Record<string, FormatValidatorFn | null>): string[];
 declare function isFormatSupported(name: string, customFormats?: Record<string, FormatValidatorFn | null>): boolean;
 declare function getRegisteredFormats(): string[];
-
+//#endregion
+//#region src/z-schema-options.d.ts
 interface ZSchemaOptions {
-    version?: JsonSchemaVersion | 'none';
-    asyncTimeout?: number;
-    forceAdditional?: boolean;
-    assumeAdditional?: boolean | string[];
-    enumCaseInsensitiveComparison?: boolean;
-    forceItems?: boolean;
-    forceMinItems?: boolean;
-    forceMaxItems?: boolean;
-    forceMinLength?: boolean;
-    forceMaxLength?: boolean;
-    forceProperties?: boolean;
-    ignoreUnresolvableReferences?: boolean;
-    noExtraKeywords?: boolean;
-    noTypeless?: boolean;
-    noEmptyStrings?: boolean;
-    noEmptyArrays?: boolean;
-    strictUris?: boolean;
-    strictMode?: boolean;
-    reportPathAsArray?: boolean;
-    breakOnFirstError?: boolean;
-    pedanticCheck?: boolean;
-    ignoreUnknownFormats?: boolean;
-    formatAssertions?: boolean | null;
-    customValidator?: (report: Report, schema: unknown, json: unknown) => void;
-    customFormats?: Record<string, FormatValidatorFn | null>;
-    maxRecursionDepth?: number;
+  version?: JsonSchemaVersion | 'none';
+  asyncTimeout?: number;
+  forceAdditional?: boolean;
+  assumeAdditional?: boolean | string[];
+  enumCaseInsensitiveComparison?: boolean;
+  forceItems?: boolean;
+  forceMinItems?: boolean;
+  forceMaxItems?: boolean;
+  forceMinLength?: boolean;
+  forceMaxLength?: boolean;
+  forceProperties?: boolean;
+  ignoreUnresolvableReferences?: boolean;
+  noExtraKeywords?: boolean;
+  noTypeless?: boolean;
+  noEmptyStrings?: boolean;
+  noEmptyArrays?: boolean;
+  strictUris?: boolean;
+  strictMode?: boolean;
+  reportPathAsArray?: boolean;
+  breakOnFirstError?: boolean;
+  pedanticCheck?: boolean;
+  ignoreUnknownFormats?: boolean;
+  formatAssertions?: boolean | null;
+  customValidator?: (report: Report, schema: unknown, json: unknown) => void;
+  customFormats?: Record<string, FormatValidatorFn | null>;
+  maxRecursionDepth?: number;
 }
-
+//#endregion
+//#region src/report.d.ts
 interface SchemaErrorDetail {
-    /**
-     * Example: "Expected type string but found type array"
-     */
-    message: string;
-    /**
-     * An error identifier that can be used to format a custom error message.
-     * Example: "INVALID_TYPE"
-     */
-    code: string;
-    /**
-     * Format parameters that can be used to format a custom error message.
-     * Example: ["string","array"]
-     */
-    params: ErrorParam[];
-    /**
-     * A JSON path indicating the location of the error.
-     * Example: "#/projects/1"
-     */
-    path: string | Array<string | number>;
-    /**
-     * A JSON path indicating the location in the schema where the constraint is defined.
-     * Example: ["properties", "name", "type"]
-     */
-    schemaPath?: Array<string | number>;
-    /**
-     * The schema rule description, which is included for certain errors where
-     * this information is useful (e.g. to describe a constraint).
-     */
-    title?: string;
-    description?: string;
-    /**
-     * Returns details for sub-schemas that failed to match.  For example, if the schema
-     * uses the "oneOf" constraint to accept several alternative possibilities, each
-     * alternative will have its own inner detail object explaining why it failed to match.
-     */
-    inner?: SchemaErrorDetail[];
-    schemaId?: string;
-    /**
-     * The schema keyword that caused this validation error.
-     * Example: "required", "type", "minLength"
-     */
-    keyword?: keyof JsonSchemaAll;
+  /**
+   * Example: "Expected type string but found type array"
+   */
+  message: string;
+  /**
+   * An error identifier that can be used to format a custom error message.
+   * Example: "INVALID_TYPE"
+   */
+  code: string;
+  /**
+   * Format parameters that can be used to format a custom error message.
+   * Example: ["string","array"]
+   */
+  params: ErrorParam[];
+  /**
+   * A JSON path indicating the location of the error.
+   * Example: "#/projects/1"
+   */
+  path: string | Array<string | number>;
+  /**
+   * A JSON path indicating the location in the schema where the constraint is defined.
+   * Example: ["properties", "name", "type"]
+   */
+  schemaPath?: Array<string | number>;
+  /**
+   * The schema rule description, which is included for certain errors where
+   * this information is useful (e.g. to describe a constraint).
+   */
+  title?: string;
+  description?: string;
+  /**
+   * Returns details for sub-schemas that failed to match.  For example, if the schema
+   * uses the "oneOf" constraint to accept several alternative possibilities, each
+   * alternative will have its own inner detail object explaining why it failed to match.
+   */
+  inner?: SchemaErrorDetail[];
+  schemaId?: string;
+  /**
+   * The schema keyword that caused this validation error.
+   * Example: "required", "type", "minLength"
+   */
+  keyword?: keyof JsonSchemaAll;
 }
 interface ReportOptions {
-    maxErrors?: number;
+  maxErrors?: number;
 }
 type TaskResult = unknown;
 type TaskFn = (...args: unknown[]) => TaskResult;
@@ -92,274 +95,281 @@ type TaskFnArgs = Parameters<TaskFn>;
 type TaskProcessFn = (result: ReturnType<TaskFn>) => void;
 type AsyncTask = [TaskFn, TaskFnArgs, TaskProcessFn];
 declare class Report {
-    asyncTasks: AsyncTask[];
-    commonErrorMessage?: string;
-    __$recursiveAnchorStack: JsonSchemaInternal[];
-    __$dynamicScopeStack: JsonSchemaInternal[];
-    __validationResultCache: Map<unknown, Map<unknown, boolean>>;
-    errors: SchemaErrorDetail[];
-    json?: unknown;
-    path: Array<number | string>;
-    schemaPath: Array<number | string>;
-    rootSchema?: JsonSchemaInternal;
-    parentReport?: Report;
-    options: ZSchemaOptions;
-    reportOptions: ReportOptions;
-    validateOptions: ValidateOptions;
-    constructor(zschemaOptions: ZSchemaOptions, validateOptions?: ValidateOptions);
-    constructor(parentReport: Report, validateOptions?: ValidateOptions);
-    constructor(parentReport: Report, reportOptions: ReportOptions, validateOptions?: ValidateOptions);
-    isValid(): boolean;
-    addAsyncTask<FV, FN extends (...args: any[]) => FV>(fn: FN, args: Parameters<FN>, asyncTaskResultProcessFn: (result: ReturnType<FN>) => void): void;
-    /**
-     * Like {@link addAsyncTask}, but automatically saves the current `path` and
-     * restores it around `processFn`.  This eliminates the manual
-     * path-save/restore boilerplate that every async-aware validator would
-     * otherwise need.
-     */
-    addAsyncTaskWithPath(fn: (...args: any[]) => any, args: any[], processFn: (result: any) => void): void;
-    getAncestor(id: string): Report | undefined;
-    processAsyncTasks(timeout: number | undefined, callback: ValidateCallback): void;
-    getPath(returnPathAsString?: boolean): string | (string | number)[];
-    getSchemaPath(): Array<string | number>;
-    getSchemaId(): string | undefined;
-    hasError(errCode: string, errParams: Array<any>): boolean;
-    addError(errCode: ErrorCode, errParams?: ErrorParam[], subReports?: Report | Report[], schema?: JsonSchema | boolean, keyword?: keyof JsonSchemaAll): void;
-    getJson(): unknown;
-    addCustomError(errorCode: ErrorCode, errorMessage: string, params?: ErrorParam[], subReports?: Report | Report[], schema?: JsonSchema | boolean, keyword?: keyof JsonSchemaAll): void;
+  asyncTasks: AsyncTask[];
+  commonErrorMessage?: string;
+  __$recursiveAnchorStack: JsonSchemaInternal[];
+  __$dynamicScopeStack: JsonSchemaInternal[];
+  __validationResultCache: Map<unknown, Map<unknown, boolean>>;
+  errors: SchemaErrorDetail[];
+  json?: unknown;
+  path: Array<number | string>;
+  schemaPath: Array<number | string>;
+  rootSchema?: JsonSchemaInternal;
+  parentReport?: Report;
+  options: ZSchemaOptions;
+  reportOptions: ReportOptions;
+  validateOptions: ValidateOptions;
+  constructor(zschemaOptions: ZSchemaOptions, validateOptions?: ValidateOptions);
+  constructor(parentReport: Report, validateOptions?: ValidateOptions);
+  constructor(parentReport: Report, reportOptions: ReportOptions, validateOptions?: ValidateOptions);
+  isValid(): boolean;
+  addAsyncTask<FV, FN extends (...args: any[]) => FV>(fn: FN, args: Parameters<FN>, asyncTaskResultProcessFn: (result: ReturnType<FN>) => void): void;
+  /**
+   * Like {@link addAsyncTask}, but automatically saves the current `path` and
+   * restores it around `processFn`.  This eliminates the manual
+   * path-save/restore boilerplate that every async-aware validator would
+   * otherwise need.
+   */
+  addAsyncTaskWithPath(fn: (...args: any[]) => any, args: any[], processFn: (result: any) => void): void;
+  getAncestor(id: string): Report | undefined;
+  processAsyncTasks(timeout: number | undefined, callback: ValidateCallback): void;
+  getPath(returnPathAsString?: boolean): string | (string | number)[];
+  getSchemaPath(): Array<string | number>;
+  getSchemaId(): string | undefined;
+  hasError(errCode: string, errParams: Array<any>): boolean;
+  addError(errCode: ErrorCode, errParams?: ErrorParam[], subReports?: Report | Report[], schema?: JsonSchema | boolean, keyword?: keyof JsonSchemaAll): void;
+  getJson(): unknown;
+  addCustomError(errorCode: ErrorCode, errorMessage: string, params?: ErrorParam[], subReports?: Report | Report[], schema?: JsonSchema | boolean, keyword?: keyof JsonSchemaAll): void;
 }
-
+//#endregion
+//#region src/errors.d.ts
 type ErrorCode = keyof typeof Errors;
 type ErrorParam = string | number | Array<string | number>;
 declare const Errors: {
-    INVALID_TYPE: string;
-    INVALID_FORMAT: string;
-    ENUM_MISMATCH: string;
-    ENUM_CASE_MISMATCH: string;
-    ANY_OF_MISSING: string;
-    ONE_OF_MISSING: string;
-    ONE_OF_MULTIPLE: string;
-    NOT_PASSED: string;
-    ARRAY_LENGTH_SHORT: string;
-    ARRAY_LENGTH_LONG: string;
-    ARRAY_UNIQUE: string;
-    ARRAY_ADDITIONAL_ITEMS: string;
-    ARRAY_UNEVALUATED_ITEMS: string;
-    MULTIPLE_OF: string;
-    MINIMUM: string;
-    MINIMUM_EXCLUSIVE: string;
-    MAXIMUM: string;
-    MAXIMUM_EXCLUSIVE: string;
-    OBJECT_PROPERTIES_MINIMUM: string;
-    OBJECT_PROPERTIES_MAXIMUM: string;
-    OBJECT_MISSING_REQUIRED_PROPERTY: string;
-    OBJECT_ADDITIONAL_PROPERTIES: string;
-    OBJECT_UNEVALUATED_PROPERTIES: string;
-    OBJECT_DEPENDENCY_KEY: string;
-    MIN_LENGTH: string;
-    MAX_LENGTH: string;
-    PATTERN: string;
-    KEYWORD_TYPE_EXPECTED: string;
-    KEYWORD_UNDEFINED_STRICT: string;
-    KEYWORD_UNEXPECTED: string;
-    KEYWORD_MUST_BE: string;
-    KEYWORD_DEPENDENCY: string;
-    KEYWORD_PATTERN: string;
-    KEYWORD_VALUE_TYPE: string;
-    UNKNOWN_FORMAT: string;
-    CUSTOM_MODE_FORCE_PROPERTIES: string;
-    REF_UNRESOLVED: string;
-    UNRESOLVABLE_REFERENCE: string;
-    SCHEMA_NOT_REACHABLE: string;
-    SCHEMA_TYPE_EXPECTED: string;
-    SCHEMA_NOT_AN_OBJECT: string;
-    ASYNC_TIMEOUT: string;
-    PARENT_SCHEMA_VALIDATION_FAILED: string;
-    REMOTE_NOT_VALID: string;
-    SCHEMA_IS_FALSE: string;
-    CONST: string;
-    CONTAINS: string;
-    PROPERTY_NAMES: string;
-    COLLECT_EVALUATED_DEPTH_EXCEEDED: string;
-    MAX_RECURSION_DEPTH_EXCEEDED: string;
+  INVALID_TYPE: string;
+  INVALID_FORMAT: string;
+  ENUM_MISMATCH: string;
+  ENUM_CASE_MISMATCH: string;
+  ANY_OF_MISSING: string;
+  ONE_OF_MISSING: string;
+  ONE_OF_MULTIPLE: string;
+  NOT_PASSED: string;
+  ARRAY_LENGTH_SHORT: string;
+  ARRAY_LENGTH_LONG: string;
+  ARRAY_UNIQUE: string;
+  ARRAY_ADDITIONAL_ITEMS: string;
+  ARRAY_UNEVALUATED_ITEMS: string;
+  MULTIPLE_OF: string;
+  MINIMUM: string;
+  MINIMUM_EXCLUSIVE: string;
+  MAXIMUM: string;
+  MAXIMUM_EXCLUSIVE: string;
+  OBJECT_PROPERTIES_MINIMUM: string;
+  OBJECT_PROPERTIES_MAXIMUM: string;
+  OBJECT_MISSING_REQUIRED_PROPERTY: string;
+  OBJECT_ADDITIONAL_PROPERTIES: string;
+  OBJECT_UNEVALUATED_PROPERTIES: string;
+  OBJECT_DEPENDENCY_KEY: string;
+  MIN_LENGTH: string;
+  MAX_LENGTH: string;
+  PATTERN: string;
+  KEYWORD_TYPE_EXPECTED: string;
+  KEYWORD_UNDEFINED_STRICT: string;
+  KEYWORD_UNEXPECTED: string;
+  KEYWORD_MUST_BE: string;
+  KEYWORD_DEPENDENCY: string;
+  KEYWORD_PATTERN: string;
+  KEYWORD_VALUE_TYPE: string;
+  UNKNOWN_FORMAT: string;
+  CUSTOM_MODE_FORCE_PROPERTIES: string;
+  REF_UNRESOLVED: string;
+  UNRESOLVABLE_REFERENCE: string;
+  SCHEMA_NOT_REACHABLE: string;
+  SCHEMA_TYPE_EXPECTED: string;
+  SCHEMA_NOT_AN_OBJECT: string;
+  ASYNC_TIMEOUT: string;
+  PARENT_SCHEMA_VALIDATION_FAILED: string;
+  REMOTE_NOT_VALID: string;
+  SCHEMA_IS_FALSE: string;
+  CONST: string;
+  CONTAINS: string;
+  PROPERTY_NAMES: string;
+  COLLECT_EVALUATED_DEPTH_EXCEEDED: string;
+  MAX_RECURSION_DEPTH_EXCEEDED: string;
 };
 declare class ValidateError extends Error {
-    name: string;
-    details?: SchemaErrorDetail[];
-    constructor(message: string, details?: SchemaErrorDetail[]);
+  name: string;
+  details?: SchemaErrorDetail[];
+  constructor(message: string, details?: SchemaErrorDetail[]);
 }
-
+//#endregion
+//#region src/schema-cache.d.ts
 type SchemaCacheStorage = Record<string, JsonSchemaInternal>;
 declare class SchemaCache {
-    private validator;
-    static global_cache: SchemaCacheStorage;
-    cache: SchemaCacheStorage;
-    constructor(validator: ZSchemaBase);
-    static cacheSchemaByUri(uri: string, schema: JsonSchemaInternal): void;
-    cacheSchemaByUri(uri: string, schema: JsonSchemaInternal): void;
-    removeFromCacheByUri(uri: string): void;
-    checkCacheForUri(uri: string): boolean;
-    getSchema(report: Report, refOrSchema: string): JsonSchemaInternal | undefined;
-    getSchema(report: Report, refOrSchema: JsonSchema): JsonSchemaInternal;
-    getSchema(report: Report, refOrSchema: JsonSchema[]): JsonSchemaInternal[];
-    fromCache(path: string): JsonSchemaInternal | undefined;
-    getSchemaByUri(report: Report, uri: string, root?: JsonSchemaInternal): JsonSchemaInternal | undefined;
+  private validator;
+  static global_cache: SchemaCacheStorage;
+  cache: SchemaCacheStorage;
+  constructor(validator: ZSchemaBase);
+  static cacheSchemaByUri(uri: string, schema: JsonSchemaInternal): void;
+  cacheSchemaByUri(uri: string, schema: JsonSchemaInternal): void;
+  removeFromCacheByUri(uri: string): void;
+  checkCacheForUri(uri: string): boolean;
+  getSchema(report: Report, refOrSchema: string): JsonSchemaInternal | undefined;
+  getSchema(report: Report, refOrSchema: JsonSchema): JsonSchemaInternal;
+  getSchema(report: Report, refOrSchema: JsonSchema[]): JsonSchemaInternal[];
+  fromCache(path: string): JsonSchemaInternal | undefined;
+  getSchemaByUri(report: Report, uri: string, root?: JsonSchemaInternal): JsonSchemaInternal | undefined;
 }
-
+//#endregion
+//#region src/schema-validator.d.ts
 declare class SchemaValidator {
-    private validator;
-    constructor(validator: ZSchemaBase);
-    get options(): ZSchemaOptions;
-    validateArrayOfSchemas(report: Report, arr: Array<JsonSchemaInternal | boolean>): boolean;
-    validateSchema(report: Report, schema: JsonSchemaInternal | boolean | Array<JsonSchemaInternal | boolean>): boolean;
+  private validator;
+  constructor(validator: ZSchemaBase);
+  get options(): ZSchemaOptions;
+  validateArrayOfSchemas(report: Report, arr: Array<JsonSchemaInternal | boolean>): boolean;
+  validateSchema(report: Report, schema: JsonSchemaInternal | boolean | Array<JsonSchemaInternal | boolean>): boolean;
 }
-
+//#endregion
+//#region src/z-schema-base.d.ts
 interface ValidateOptions {
-    schemaPath?: string;
-    includeErrors?: Array<keyof typeof Errors>;
-    excludeErrors?: Array<keyof typeof Errors>;
+  schemaPath?: string;
+  includeErrors?: Array<keyof typeof Errors>;
+  excludeErrors?: Array<keyof typeof Errors>;
 }
 type ValidateResponse = {
-    valid: boolean;
-    err?: ValidateError;
+  valid: boolean;
+  err?: ValidateError;
 };
 type ValidateCallback = (err: ValidateResponse['err'], valid: ValidateResponse['valid']) => void;
 declare class ZSchemaBase {
-    scache: SchemaCache;
-    sc: SchemaCompiler;
-    sv: SchemaValidator;
-    validateOptions: ValidateOptions;
-    options: ZSchemaOptions;
-    constructor(options: ZSchemaOptions | undefined, token: symbol);
-    /**
-     * Internal recursive JSON validation — delegates to the `validate` function
-     * in `json-validation.ts`. Exposed as a method so that per-keyword validator
-     * modules (array, combinators, object) can call back into the core validator
-     * via `this` without importing `json-validation.ts` directly (which would
-     * create a circular dependency).
-     */
-    _jsonValidate(report: Report, schema: boolean | JsonSchemaInternal, json: unknown): boolean;
-    getDefaultSchemaId(): string;
-    _validate(json: unknown, schema: JsonSchema | string, options: ValidateOptions, callback: ValidateCallback): void;
-    _validate(json: unknown, schema: JsonSchema | string, callback: ValidateCallback): void;
-    _validate(json: unknown, schema: JsonSchema | string, options: ValidateOptions): true;
-    _validate(json: unknown, schema: JsonSchema | string): true;
-    _validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): true;
-    /**
-     * Register a format validator on this instance only (does not affect other instances or the global registry).
-     * @param name - The format name.
-     * @param validatorFunction - A sync or async function `(value: unknown) => boolean | Promise<boolean>`.
-     */
-    registerFormat(name: string, validatorFunction: FormatValidatorFn): void;
-    /**
-     * Unregister an instance-scoped format validator.
-     * @param name - The format name to unregister.
-     */
-    unregisterFormat(name: string): void;
-    /** Returns the names of format validators registered on this instance. */
-    getRegisteredFormats(): string[];
-    /** Returns all supported format names (global + instance-registered). */
-    getSupportedFormats(): string[];
-    /**
-     * Register a remote schema in this instance's cache so `$ref` can resolve to it.
-     * @param uri - The URI the schema will be known by.
-     * @param schema - The schema object or JSON string.
-     * @param validationOptions - Optional options used for schema preparation.
-     */
-    setRemoteReference(uri: string, schema: string | JsonSchema, validationOptions?: ZSchemaOptions): void;
-    /**
-     * Extract unresolvable `$ref` URIs from a validation error.
-     * @param err - A `ValidateError` from a failed validation.
-     * @returns An array of unresolvable reference URIs.
-     */
-    getMissingReferences(err: ValidateError): string[];
-    /**
-     * Extract unresolvable **remote** `$ref` URIs from a validation error (local fragment-only refs are excluded).
-     * @param err - A `ValidateError` from a failed validation.
-     * @returns An array of remote reference base URIs.
-     */
-    getMissingRemoteReferences(err: ValidateError): string[];
-    /**
-     * Resolve a previously compiled schema by its `$id` / `id`, cleaning up internal bookkeeping properties
-     * and inlining resolved `$ref` targets.
-     * @param schemaId - The schema identifier to look up.
-     * @returns A clean, resolved copy of the schema, or `undefined` if not found.
-     */
-    getResolvedSchema(schemaId: string): JsonSchema | undefined;
+  scache: SchemaCache;
+  sc: SchemaCompiler;
+  sv: SchemaValidator;
+  validateOptions: ValidateOptions;
+  options: ZSchemaOptions;
+  constructor(options: ZSchemaOptions | undefined, token: symbol);
+  /**
+   * Internal recursive JSON validation — delegates to the `validate` function
+   * in `json-validation.ts`. Exposed as a method so that per-keyword validator
+   * modules (array, combinators, object) can call back into the core validator
+   * via `this` without importing `json-validation.ts` directly (which would
+   * create a circular dependency).
+   */
+  _jsonValidate(report: Report, schema: boolean | JsonSchemaInternal, json: unknown): boolean;
+  getDefaultSchemaId(): string;
+  _validate(json: unknown, schema: JsonSchema | string, options: ValidateOptions, callback: ValidateCallback): void;
+  _validate(json: unknown, schema: JsonSchema | string, callback: ValidateCallback): void;
+  _validate(json: unknown, schema: JsonSchema | string, options: ValidateOptions): true;
+  _validate(json: unknown, schema: JsonSchema | string): true;
+  _validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): true;
+  /**
+   * Register a format validator on this instance only (does not affect other instances or the global registry).
+   * @param name - The format name.
+   * @param validatorFunction - A sync or async function `(value: unknown) => boolean | Promise<boolean>`.
+   */
+  registerFormat(name: string, validatorFunction: FormatValidatorFn): void;
+  /**
+   * Unregister an instance-scoped format validator.
+   * @param name - The format name to unregister.
+   */
+  unregisterFormat(name: string): void;
+  /** Returns the names of format validators registered on this instance. */
+  getRegisteredFormats(): string[];
+  /** Returns all supported format names (global + instance-registered). */
+  getSupportedFormats(): string[];
+  /**
+   * Register a remote schema in this instance's cache so `$ref` can resolve to it.
+   * @param uri - The URI the schema will be known by.
+   * @param schema - The schema object or JSON string.
+   * @param validationOptions - Optional options used for schema preparation.
+   */
+  setRemoteReference(uri: string, schema: string | JsonSchema, validationOptions?: ZSchemaOptions): void;
+  /**
+   * Extract unresolvable `$ref` URIs from a validation error.
+   * @param err - A `ValidateError` from a failed validation.
+   * @returns An array of unresolvable reference URIs.
+   */
+  getMissingReferences(err: ValidateError): string[];
+  /**
+   * Extract unresolvable **remote** `$ref` URIs from a validation error (local fragment-only refs are excluded).
+   * @param err - A `ValidateError` from a failed validation.
+   * @returns An array of remote reference base URIs.
+   */
+  getMissingRemoteReferences(err: ValidateError): string[];
+  /**
+   * Resolve a previously compiled schema by its `$id` / `id`, cleaning up internal bookkeeping properties
+   * and inlining resolved `$ref` targets.
+   * @param schemaId - The schema identifier to look up.
+   * @returns A clean, resolved copy of the schema, or `undefined` if not found.
+   */
+  getResolvedSchema(schemaId: string): JsonSchema | undefined;
 }
-
+//#endregion
+//#region src/schema-compiler.d.ts
 interface Reference {
-    ref: string;
-    key: '$ref' | '$schema' | '$recursiveRef' | '$dynamicRef';
-    obj: JsonSchemaInternal;
-    path: Array<string | number>;
+  ref: string;
+  key: '$ref' | '$schema' | '$recursiveRef' | '$dynamicRef';
+  obj: JsonSchemaInternal;
+  path: Array<string | number>;
 }
 declare class SchemaCompiler {
-    private validator;
-    constructor(validator: ZSchemaBase);
-    collectAndCacheIds(schema: JsonSchemaInternal): void;
-    compileSchema(report: Report, schema: JsonSchemaInternal | JsonSchemaInternal[], options?: {
-        noCache?: boolean;
-    }): boolean;
-    compileArrayOfSchemas(report: Report, arr: JsonSchemaInternal[]): boolean;
-    compileArrayOfSchemasLoop(mainReport: Report, arr: JsonSchemaInternal[]): number;
+  private validator;
+  constructor(validator: ZSchemaBase);
+  collectAndCacheIds(schema: JsonSchemaInternal): void;
+  compileSchema(report: Report, schema: JsonSchemaInternal | JsonSchemaInternal[], options?: {
+    noCache?: boolean;
+  }): boolean;
+  compileArrayOfSchemas(report: Report, arr: JsonSchemaInternal[]): boolean;
+  compileArrayOfSchemasLoop(mainReport: Report, arr: JsonSchemaInternal[]): number;
 }
-
+//#endregion
+//#region src/json-schema.d.ts
 /**
  * Properties present in ALL JSON Schema drafts (04 through 2020-12) with
  * identical types.  Draft-specific additions live on the individual draft
  * interfaces in `json-schema-versions.ts`.
  */
 interface JsonSchemaCommon {
-    $ref?: string;
-    $schema?: string;
-    title?: string;
-    description?: string;
-    default?: unknown;
-    type?: string | string[];
-    enum?: Array<unknown>;
-    format?: string;
-    multipleOf?: number;
-    minimum?: number;
-    maximum?: number;
-    /** Draft-04: `boolean` modifier on `minimum`/`maximum`. Draft-06+: standalone `number`. */
-    exclusiveMinimum?: boolean | number;
-    /** Draft-04: `boolean` modifier on `minimum`/`maximum`. Draft-06+: standalone `number`. */
-    exclusiveMaximum?: boolean | number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    items?: JsonSchema | boolean | Array<JsonSchema | boolean>;
-    additionalItems?: boolean | JsonSchema;
-    minItems?: number;
-    maxItems?: number;
-    uniqueItems?: boolean;
-    properties?: Record<string, JsonSchema | boolean>;
-    patternProperties?: Record<string, JsonSchema>;
-    additionalProperties?: boolean | JsonSchema;
-    required?: string[];
-    minProperties?: number;
-    maxProperties?: number;
-    dependencies?: Record<string, string[] | JsonSchema>;
-    allOf?: JsonSchema[];
-    anyOf?: JsonSchema[];
-    oneOf?: JsonSchema[];
-    not?: JsonSchema;
-    definitions?: Record<string, JsonSchema>;
+  $ref?: string;
+  $schema?: string;
+  title?: string;
+  description?: string;
+  default?: unknown;
+  type?: string | string[];
+  enum?: Array<unknown>;
+  format?: string;
+  multipleOf?: number;
+  minimum?: number;
+  maximum?: number;
+  /** Draft-04: `boolean` modifier on `minimum`/`maximum`. Draft-06+: standalone `number`. */
+  exclusiveMinimum?: boolean | number;
+  /** Draft-04: `boolean` modifier on `minimum`/`maximum`. Draft-06+: standalone `number`. */
+  exclusiveMaximum?: boolean | number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  items?: JsonSchema | boolean | Array<JsonSchema | boolean>;
+  additionalItems?: boolean | JsonSchema;
+  minItems?: number;
+  maxItems?: number;
+  uniqueItems?: boolean;
+  properties?: Record<string, JsonSchema | boolean>;
+  patternProperties?: Record<string, JsonSchema>;
+  additionalProperties?: boolean | JsonSchema;
+  required?: string[];
+  minProperties?: number;
+  maxProperties?: number;
+  dependencies?: Record<string, string[] | JsonSchema>;
+  allOf?: JsonSchema[];
+  anyOf?: JsonSchema[];
+  oneOf?: JsonSchema[];
+  not?: JsonSchema;
+  definitions?: Record<string, JsonSchema>;
 }
 type JsonSchemaType = 'array' | 'boolean' | 'integer' | 'null' | 'number' | 'object' | 'string';
 interface ZSchemaInternalProperties {
-    __$compiled?: unknown;
-    __$missingReferences?: Reference[];
-    __$refResolved?: JsonSchema;
-    __$dynamicRefResolved?: JsonSchema;
-    __$recursiveRefResolved?: JsonSchema;
-    __$resourceRoot?: JsonSchemaInternal;
-    __$schemaResolved?: unknown;
-    __$validated?: boolean;
-    __$validationOptions?: ZSchemaOptions;
+  __$compiled?: unknown;
+  __$missingReferences?: Reference[];
+  __$refResolved?: JsonSchema;
+  __$dynamicRefResolved?: JsonSchema;
+  __$recursiveRefResolved?: JsonSchema;
+  __$resourceRoot?: JsonSchemaInternal;
+  __$schemaResolved?: unknown;
+  __$validated?: boolean;
+  __$validationOptions?: ZSchemaOptions;
 }
-
+//#endregion
+//#region src/json-schema-versions.d.ts
 type JsonSchemaVersion = 'draft-04' | 'draft-06' | 'draft-07' | 'draft2019-09' | 'draft2020-12';
 /** Union of all draft-specific schema interfaces — the public API type. */
 type JsonSchema = JsonSchemaDraft4 | JsonSchemaDraft6 | JsonSchemaDraft7 | JsonSchemaDraft201909 | JsonSchemaDraft202012;
@@ -372,33 +382,33 @@ type JsonSchema = JsonSchemaDraft4 | JsonSchemaDraft6 | JsonSchemaDraft7 | JsonS
  * Draft-06+, which would yield `never` in a plain intersection.
  */
 interface JsonSchemaAll extends JsonSchemaCommon {
-    /** Pre-`$id` identifier (draft-04 only). */
-    id?: string;
-    /** Schema identifier (replaces `id` from draft-06 onward). */
-    $id?: string;
-    const?: unknown;
-    contains?: JsonSchema;
-    propertyNames?: JsonSchema;
-    examples?: unknown[];
-    if?: JsonSchema | boolean;
-    then?: JsonSchema | boolean;
-    else?: JsonSchema | boolean;
-    contentEncoding?: string;
-    contentMediaType?: string;
-    $defs?: Record<string, JsonSchema>;
-    $anchor?: string;
-    $vocabulary?: Record<string, boolean>;
-    $recursiveAnchor?: boolean;
-    $recursiveRef?: string;
-    dependentSchemas?: Record<string, JsonSchema>;
-    dependentRequired?: Record<string, string[]>;
-    unevaluatedItems?: JsonSchema | boolean;
-    unevaluatedProperties?: JsonSchema | boolean;
-    maxContains?: number;
-    minContains?: number;
-    $dynamicAnchor?: string;
-    $dynamicRef?: string;
-    prefixItems?: Array<JsonSchema | boolean>;
+  /** Pre-`$id` identifier (draft-04 only). */
+  id?: string;
+  /** Schema identifier (replaces `id` from draft-06 onward). */
+  $id?: string;
+  const?: unknown;
+  contains?: JsonSchema;
+  propertyNames?: JsonSchema;
+  examples?: unknown[];
+  if?: JsonSchema | boolean;
+  then?: JsonSchema | boolean;
+  else?: JsonSchema | boolean;
+  contentEncoding?: string;
+  contentMediaType?: string;
+  $defs?: Record<string, JsonSchema>;
+  $anchor?: string;
+  $vocabulary?: Record<string, boolean>;
+  $recursiveAnchor?: boolean;
+  $recursiveRef?: string;
+  dependentSchemas?: Record<string, JsonSchema>;
+  dependentRequired?: Record<string, string[]>;
+  unevaluatedItems?: JsonSchema | boolean;
+  unevaluatedProperties?: JsonSchema | boolean;
+  maxContains?: number;
+  minContains?: number;
+  $dynamicAnchor?: string;
+  $dynamicRef?: string;
+  prefixItems?: Array<JsonSchema | boolean>;
 }
 /**
  * Internal schema type used throughout the validator. Based on `JsonSchemaAll`
@@ -417,8 +427,8 @@ type JsonSchemaInternal = JsonSchemaAll & ZSchemaInternalProperties;
  * @see https://json-schema.org/draft-04/draft-zyp-json-schema-04
  */
 interface JsonSchemaDraft4 extends JsonSchemaCommon {
-    /** Schema identifier (draft-04). Replaced by `$id` in draft-06+. */
-    id?: string;
+  /** Schema identifier (draft-04). Replaced by `$id` in draft-06+. */
+  id?: string;
 }
 /**
  * JSON Schema Draft-06.
@@ -431,11 +441,11 @@ interface JsonSchemaDraft4 extends JsonSchemaCommon {
  * @see https://json-schema.org/draft-06/draft-wright-json-schema-validation-01
  */
 interface JsonSchemaDraft6 extends JsonSchemaCommon {
-    $id?: string;
-    const?: unknown;
-    contains?: JsonSchema;
-    propertyNames?: JsonSchema;
-    examples?: unknown[];
+  $id?: string;
+  const?: unknown;
+  contains?: JsonSchema;
+  propertyNames?: JsonSchema;
+  examples?: unknown[];
 }
 /**
  * JSON Schema Draft-07.
@@ -447,11 +457,11 @@ interface JsonSchemaDraft6 extends JsonSchemaCommon {
  * @see https://json-schema.org/draft-07/draft-handrews-json-schema-validation-01
  */
 interface JsonSchemaDraft7 extends JsonSchemaDraft6 {
-    if?: JsonSchema | boolean;
-    then?: JsonSchema | boolean;
-    else?: JsonSchema | boolean;
-    contentEncoding?: string;
-    contentMediaType?: string;
+  if?: JsonSchema | boolean;
+  then?: JsonSchema | boolean;
+  else?: JsonSchema | boolean;
+  contentEncoding?: string;
+  contentMediaType?: string;
 }
 /**
  * JSON Schema Draft 2019-09.
@@ -466,17 +476,17 @@ interface JsonSchemaDraft7 extends JsonSchemaDraft6 {
  * @see https://json-schema.org/draft/2019-09/release-notes
  */
 interface JsonSchemaDraft201909 extends JsonSchemaDraft7 {
-    $defs?: Record<string, JsonSchema>;
-    $anchor?: string;
-    $vocabulary?: Record<string, boolean>;
-    $recursiveAnchor?: boolean;
-    $recursiveRef?: string;
-    dependentSchemas?: Record<string, JsonSchema>;
-    dependentRequired?: Record<string, string[]>;
-    unevaluatedItems?: JsonSchema | boolean;
-    unevaluatedProperties?: JsonSchema | boolean;
-    maxContains?: number;
-    minContains?: number;
+  $defs?: Record<string, JsonSchema>;
+  $anchor?: string;
+  $vocabulary?: Record<string, boolean>;
+  $recursiveAnchor?: boolean;
+  $recursiveRef?: string;
+  dependentSchemas?: Record<string, JsonSchema>;
+  dependentRequired?: Record<string, string[]>;
+  unevaluatedItems?: JsonSchema | boolean;
+  unevaluatedProperties?: JsonSchema | boolean;
+  maxContains?: number;
+  minContains?: number;
 }
 /**
  * JSON Schema Draft 2020-12.
@@ -488,197 +498,198 @@ interface JsonSchemaDraft201909 extends JsonSchemaDraft7 {
  * @see https://json-schema.org/draft/2020-12/release-notes
  */
 interface JsonSchemaDraft202012 extends JsonSchemaDraft201909 {
-    $dynamicAnchor?: string;
-    $dynamicRef?: string;
-    prefixItems?: Array<JsonSchema | boolean>;
+  $dynamicAnchor?: string;
+  $dynamicRef?: string;
+  prefixItems?: Array<JsonSchema | boolean>;
 }
-
+//#endregion
+//#region src/z-schema-reader.d.ts
 type SchemaReader = (uri: string) => JsonSchema;
-
+//#endregion
+//#region src/z-schema.d.ts
 declare class ZSchema extends ZSchemaBase {
-    /** @internal Use ZSchema.create() instead. */
-    constructor(options: ZSchemaOptions | undefined, token: symbol);
-    /**
-     * Register a global format validator available to all instances.
-     * @param name - The format name (e.g. `'email'`, `'date'`).
-     * @param validatorFunction - A sync or async function `(value: unknown) => boolean | Promise<boolean>`.
-     */
-    static registerFormat(name: string, validatorFunction: FormatValidatorFn): void;
-    /**
-     * Remove a globally registered format validator.
-     * @param name - The format name to unregister.
-     */
-    static unregisterFormat(name: string): void;
-    /** Returns the names of all globally registered format validators. */
-    static getRegisteredFormats(): string[];
-    /** Returns a deep clone of the default options. */
-    static getDefaultOptions(): ZSchemaOptions;
-    /**
-     * Register a remote schema in the global cache so any instance can resolve `$ref` to it.
-     * @param uri - The URI the schema will be known by.
-     * @param schema - The schema object or JSON string.
-     * @param validationOptions - Optional options used for schema preparation.
-     */
-    static setRemoteReference(uri: string, schema: string | JsonSchema, validationOptions?: ZSchemaOptions): void;
-    /** Returns the current global schema reader, or `undefined` if none is set. */
-    static getSchemaReader(): SchemaReader | undefined;
-    /**
-     * Set a global schema reader function used to resolve remote `$ref` URIs.
-     * @param schemaReader - A function `(uri: string) => JsonSchema | undefined`, or `undefined` to clear.
-     */
-    static setSchemaReader(schemaReader: SchemaReader | undefined): void;
-    static schemaSymbol: symbol;
-    static jsonSymbol: symbol;
-    /**
-     * Create a validator instance.
-     *
-     * The returned type depends on the `async` and `safe` options:
-     * - `{}` → `ZSchema` — `validate()` returns `true` or throws.
-     * - `{ safe: true }` → `ZSchemaSafe` — `validate()` returns `{ valid, err? }`.
-     * - `{ async: true }` → `ZSchemaAsync` — `validate()` returns `Promise<true>` or rejects.
-     * - `{ async: true, safe: true }` → `ZSchemaAsyncSafe` — `validate()` returns `Promise<{ valid, err? }>`.
-     *
-     * @param options - Validator configuration. See `ZSchemaOptions` for all available settings.
-     * @returns A validator instance of the appropriate variant.
-     *
-     * @example
-     * ```ts
-     * const validator = ZSchema.create();
-     * validator.validate(data, schema); // throws on error
-     *
-     * const safe = ZSchema.create({ safe: true });
-     * const result = safe.validate(data, schema); // { valid, err? }
-     * ```
-     */
-    static create(options: ZSchemaOptions & {
-        async: true;
-        safe: true;
-    }): ZSchemaAsyncSafe;
-    static create(options: ZSchemaOptions & {
-        async: true;
-    }): ZSchemaAsync;
-    static create(options: ZSchemaOptions & {
-        safe: true;
-    }): ZSchemaSafe;
-    static create(options?: ZSchemaOptions): ZSchema;
-    /**
-     * Validate JSON data against a schema.
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string (previously registered via `validateSchema`).
-     * @param options - Per-call options (`schemaPath`, `includeErrors`, `excludeErrors`).
-     * @returns `true` if valid.
-     * @throws {@link ValidateError} if validation fails, with a `details` array of structured errors.
-     */
-    validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): true;
-    /**
-     * Validate JSON data against a schema, returning a result object instead of throwing.
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string.
-     * @param options - Per-call options.
-     * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
-     */
-    validateSafe(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): ValidateResponse;
-    /**
-     * Validate JSON data against a schema asynchronously (supports async format validators).
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string.
-     * @param options - Per-call options.
-     * @returns A promise that resolves to `true` if valid.
-     * @throws {@link ValidateError} if validation fails (the promise rejects).
-     */
-    validateAsync(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<true>;
-    /**
-     * Validate JSON data against a schema asynchronously, returning a result object.
-     * The promise always resolves (never rejects).
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string.
-     * @param options - Per-call options.
-     * @returns A promise resolving to `{ valid: true }` or `{ valid: false, err: ValidateError }`.
-     */
-    validateAsyncSafe(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<ValidateResponse>;
-    /**
-     * Validate one or more JSON Schemas, compiling and caching them for later use with `validate()`.
-     * @param schemaOrArr - A single schema or an array of schemas (for cross-referencing).
-     * @returns `true` if all schemas are valid.
-     * @throws {@link ValidateError} if any schema is invalid.
-     */
-    validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): true;
-    /**
-     * Validate one or more JSON Schemas, returning a result object instead of throwing.
-     * @param schemaOrArr - A single schema or an array of schemas.
-     * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
-     */
-    validateSchemaSafe(schemaOrArr: JsonSchema | JsonSchema[]): ValidateResponse;
+  /** @internal Use ZSchema.create() instead. */
+  constructor(options: ZSchemaOptions | undefined, token: symbol);
+  /**
+   * Register a global format validator available to all instances.
+   * @param name - The format name (e.g. `'email'`, `'date'`).
+   * @param validatorFunction - A sync or async function `(value: unknown) => boolean | Promise<boolean>`.
+   */
+  static registerFormat(name: string, validatorFunction: FormatValidatorFn): void;
+  /**
+   * Remove a globally registered format validator.
+   * @param name - The format name to unregister.
+   */
+  static unregisterFormat(name: string): void;
+  /** Returns the names of all globally registered format validators. */
+  static getRegisteredFormats(): string[];
+  /** Returns a deep clone of the default options. */
+  static getDefaultOptions(): ZSchemaOptions;
+  /**
+   * Register a remote schema in the global cache so any instance can resolve `$ref` to it.
+   * @param uri - The URI the schema will be known by.
+   * @param schema - The schema object or JSON string.
+   * @param validationOptions - Optional options used for schema preparation.
+   */
+  static setRemoteReference(uri: string, schema: string | JsonSchema, validationOptions?: ZSchemaOptions): void;
+  /** Returns the current global schema reader, or `undefined` if none is set. */
+  static getSchemaReader(): SchemaReader | undefined;
+  /**
+   * Set a global schema reader function used to resolve remote `$ref` URIs.
+   * @param schemaReader - A function `(uri: string) => JsonSchema | undefined`, or `undefined` to clear.
+   */
+  static setSchemaReader(schemaReader: SchemaReader | undefined): void;
+  static schemaSymbol: symbol;
+  static jsonSymbol: symbol;
+  /**
+   * Create a validator instance.
+   *
+   * The returned type depends on the `async` and `safe` options:
+   * - `{}` → `ZSchema` — `validate()` returns `true` or throws.
+   * - `{ safe: true }` → `ZSchemaSafe` — `validate()` returns `{ valid, err? }`.
+   * - `{ async: true }` → `ZSchemaAsync` — `validate()` returns `Promise<true>` or rejects.
+   * - `{ async: true, safe: true }` → `ZSchemaAsyncSafe` — `validate()` returns `Promise<{ valid, err? }>`.
+   *
+   * @param options - Validator configuration. See `ZSchemaOptions` for all available settings.
+   * @returns A validator instance of the appropriate variant.
+   *
+   * @example
+   * ```ts
+   * const validator = ZSchema.create();
+   * validator.validate(data, schema); // throws on error
+   *
+   * const safe = ZSchema.create({ safe: true });
+   * const result = safe.validate(data, schema); // { valid, err? }
+   * ```
+   */
+  static create(options: ZSchemaOptions & {
+    async: true;
+    safe: true;
+  }): ZSchemaAsyncSafe;
+  static create(options: ZSchemaOptions & {
+    async: true;
+  }): ZSchemaAsync;
+  static create(options: ZSchemaOptions & {
+    safe: true;
+  }): ZSchemaSafe;
+  static create(options?: ZSchemaOptions): ZSchema;
+  /**
+   * Validate JSON data against a schema.
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string (previously registered via `validateSchema`).
+   * @param options - Per-call options (`schemaPath`, `includeErrors`, `excludeErrors`).
+   * @returns `true` if valid.
+   * @throws {@link ValidateError} if validation fails, with a `details` array of structured errors.
+   */
+  validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): true;
+  /**
+   * Validate JSON data against a schema, returning a result object instead of throwing.
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string.
+   * @param options - Per-call options.
+   * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
+   */
+  validateSafe(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): ValidateResponse;
+  /**
+   * Validate JSON data against a schema asynchronously (supports async format validators).
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string.
+   * @param options - Per-call options.
+   * @returns A promise that resolves to `true` if valid.
+   * @throws {@link ValidateError} if validation fails (the promise rejects).
+   */
+  validateAsync(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<true>;
+  /**
+   * Validate JSON data against a schema asynchronously, returning a result object.
+   * The promise always resolves (never rejects).
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string.
+   * @param options - Per-call options.
+   * @returns A promise resolving to `{ valid: true }` or `{ valid: false, err: ValidateError }`.
+   */
+  validateAsyncSafe(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<ValidateResponse>;
+  /**
+   * Validate one or more JSON Schemas, compiling and caching them for later use with `validate()`.
+   * @param schemaOrArr - A single schema or an array of schemas (for cross-referencing).
+   * @returns `true` if all schemas are valid.
+   * @throws {@link ValidateError} if any schema is invalid.
+   */
+  validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): true;
+  /**
+   * Validate one or more JSON Schemas, returning a result object instead of throwing.
+   * @param schemaOrArr - A single schema or an array of schemas.
+   * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
+   */
+  validateSchemaSafe(schemaOrArr: JsonSchema | JsonSchema[]): ValidateResponse;
 }
 /**
  * Synchronous safe validator — `validate()` returns `{ valid, err? }` instead of throwing.
  * Created via `ZSchema.create({ safe: true })`.
  */
 declare class ZSchemaSafe extends ZSchemaBase {
-    /** @internal Use ZSchema.create() instead. */
-    constructor(options: ZSchemaOptions | undefined, token: symbol);
-    /**
-     * Validate JSON data against a schema.
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string.
-     * @param options - Per-call options.
-     * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
-     */
-    validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): ValidateResponse;
-    /**
-     * Validate one or more JSON Schemas.
-     * @param schemaOrArr - A single schema or an array of schemas.
-     * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
-     */
-    validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): ValidateResponse;
+  /** @internal Use ZSchema.create() instead. */
+  constructor(options: ZSchemaOptions | undefined, token: symbol);
+  /**
+   * Validate JSON data against a schema.
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string.
+   * @param options - Per-call options.
+   * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
+   */
+  validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): ValidateResponse;
+  /**
+   * Validate one or more JSON Schemas.
+   * @param schemaOrArr - A single schema or an array of schemas.
+   * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
+   */
+  validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): ValidateResponse;
 }
 /**
  * Asynchronous throw validator — `validate()` returns `Promise<true>` or rejects.
  * Created via `ZSchema.create({ async: true })`.
  */
 declare class ZSchemaAsync extends ZSchemaBase {
-    /** @internal Use ZSchema.create() instead. */
-    constructor(options: ZSchemaOptions | undefined, token: symbol);
-    /**
-     * Validate JSON data against a schema asynchronously.
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string.
-     * @param options - Per-call options.
-     * @returns A promise that resolves to `true` if valid.
-     * @throws {@link ValidateError} if validation fails (the promise rejects).
-     */
-    validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<true>;
-    /**
-     * Validate one or more JSON Schemas (synchronous, throws on error).
-     * @param schemaOrArr - A single schema or an array of schemas.
-     * @returns `true` if all schemas are valid.
-     * @throws {@link ValidateError} if any schema is invalid.
-     */
-    validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): true;
+  /** @internal Use ZSchema.create() instead. */
+  constructor(options: ZSchemaOptions | undefined, token: symbol);
+  /**
+   * Validate JSON data against a schema asynchronously.
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string.
+   * @param options - Per-call options.
+   * @returns A promise that resolves to `true` if valid.
+   * @throws {@link ValidateError} if validation fails (the promise rejects).
+   */
+  validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<true>;
+  /**
+   * Validate one or more JSON Schemas (synchronous, throws on error).
+   * @param schemaOrArr - A single schema or an array of schemas.
+   * @returns `true` if all schemas are valid.
+   * @throws {@link ValidateError} if any schema is invalid.
+   */
+  validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): true;
 }
 /**
  * Asynchronous safe validator — `validate()` returns `Promise<{ valid, err? }>` (never rejects).
  * Created via `ZSchema.create({ async: true, safe: true })`.
  */
 declare class ZSchemaAsyncSafe extends ZSchemaBase {
-    /** @internal Use ZSchema.create() instead. */
-    constructor(options: ZSchemaOptions | undefined, token: symbol);
-    /**
-     * Validate JSON data against a schema asynchronously.
-     * The promise always resolves (never rejects).
-     * @param json - The data to validate.
-     * @param schema - A JSON Schema object or a schema id string.
-     * @param options - Per-call options.
-     * @returns A promise resolving to `{ valid: true }` or `{ valid: false, err: ValidateError }`.
-     */
-    validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<ValidateResponse>;
-    /**
-     * Validate one or more JSON Schemas.
-     * @param schemaOrArr - A single schema or an array of schemas.
-     * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
-     */
-    validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): ValidateResponse;
+  /** @internal Use ZSchema.create() instead. */
+  constructor(options: ZSchemaOptions | undefined, token: symbol);
+  /**
+   * Validate JSON data against a schema asynchronously.
+   * The promise always resolves (never rejects).
+   * @param json - The data to validate.
+   * @param schema - A JSON Schema object or a schema id string.
+   * @param options - Per-call options.
+   * @returns A promise resolving to `{ valid: true }` or `{ valid: false, err: ValidateError }`.
+   */
+  validate(json: unknown, schema: JsonSchema | string, options?: ValidateOptions): Promise<ValidateResponse>;
+  /**
+   * Validate one or more JSON Schemas.
+   * @param schemaOrArr - A single schema or an array of schemas.
+   * @returns `{ valid: true }` on success, or `{ valid: false, err: ValidateError }` on failure.
+   */
+  validateSchema(schemaOrArr: JsonSchema | JsonSchema[]): ValidateResponse;
 }
-
-export { Errors, Report, ValidateError, ZSchema, ZSchemaAsync, ZSchemaAsyncSafe, ZSchemaSafe, ZSchema as default, getFormatValidators, getRegisteredFormats, getSupportedFormats, isFormatSupported, registerFormat, unregisterFormat };
-export type { ErrorCode, ErrorParam, FormatValidatorFn, FormatValidatorsOptions, JsonSchema, JsonSchemaCommon, JsonSchemaDraft201909, JsonSchemaDraft202012, JsonSchemaDraft4, JsonSchemaDraft6, JsonSchemaDraft7, JsonSchemaType, JsonSchemaVersion, SchemaErrorDetail, SchemaReader, ValidateOptions, ValidateResponse, ZSchemaOptions };
+//#endregion
+export { type ErrorCode, type ErrorParam, type Errors, type FormatValidatorFn, type FormatValidatorsOptions, type JsonSchema, type JsonSchemaCommon, type JsonSchemaDraft201909, type JsonSchemaDraft202012, type JsonSchemaDraft4, type JsonSchemaDraft6, type JsonSchemaDraft7, type JsonSchemaType, type JsonSchemaVersion, type Report, type SchemaErrorDetail, type SchemaReader, ValidateError, type ValidateOptions, type ValidateResponse, type ZSchema, ZSchema as default, type ZSchemaAsync, type ZSchemaAsyncSafe, type ZSchemaOptions, type ZSchemaSafe, getFormatValidators, getRegisteredFormats, getSupportedFormats, isFormatSupported, registerFormat, unregisterFormat };