@warlock.js/seal 5.16.0 → 5.17.1

package/esm/types/context-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"context-types.d.mts","names":[],"sources":["../../../../../../../seal/src/types/context-types.ts"],"mappings":";;;;KAGY,eAAA;EACV,IAAA,EAAM,UAAA;EACN,OAAA,EAAS,aAAa;EACtB,UAAA;IACE,KAAA;IACA,IAAA;IACA,GAAA;IACA,KAAA;IAAA,CACC,GAAA;EAAA;AAAA;AAAA,KAIO,oBAAA;EACV,SAAA;EACA,OAAA,EAAS,aAAA;EACT,IAAA,EAAM,UAAU;AAAA;;AAPF;AAIhB;KASY,aAAA;yBAEV,SAAA,OAVA;EAYA,MAAA,OAXS;EAaT,KAAA,OAZM;EAcN,GAAA,UAdgB;EAgBhB,IAAA,UAVuB;EAYvB,MAAA,GAAS,MAAA,EAAA;EAET,OAAA,GAAU,MAAA,eAEI;EAAd,WAAA,GAAc,MAAA,eAG6B;EAD3C,aAAA,GAAgB,eAAA,EAAiB,eAAA;EACjC,kBAAA,GAAqB,oBAAA,EAAsB,oBAAA,aAjB3C;EAmBA,cAAA;IACE,cAAA;EAAA;AAAA"}
+{"version":3,"file":"context-types.d.mts","names":[],"sources":["../../../../../../../seal/src/types/context-types.ts"],"mappings":";;;;KAGY,eAAA;EACV,IAAA,EAAM,UAAA;EACN,OAAA,EAAS,aAAa;EACtB,UAAA;IACE,KAAA;IACA,IAAA;IACA,GAAA;IACA,KAAA;IAAA,CACC,GAAA;EAAA;AAAA;AAAA,KAIO,oBAAA;EACV,SAAA;EACA,OAAA,EAAS,aAAA;EACT,IAAA,EAAM,UAAU;AAAA;;AAPF;AAIhB;KASY,aAAA;yBAEV,SAAA,OAVA;EAYA,MAAA,OAXS;EAaT,KAAA,OAZM;EAcN,GAAA,UAdgB;EAgBhB,IAAA,UAVuB;EAYvB,MAAA,GAAS,MAAA,EAAA;EAET,OAAA,GAAU,MAAA,eAEI;EAAd,WAAA,GAAc,MAAA,eAG6B;EAD3C,aAAA,GAAgB,eAAA,EAAiB,eAAA;EACjC,kBAAA,GAAqB,oBAAA,EAAsB,oBAAA,aAjB3C;EAmBA,cAAA;IACE,cAAA,YAdF;IAgBE,WAAA;EAAA;AAAA"}

package/esm/validators/base-validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"base-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/base-validator.ts"],"mappings":"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"}
+{"version":3,"file":"base-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/base-validator.ts"],"mappings":"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"}

package/esm/validators/base-validator.mjs

@@ -1,6 +1,5 @@
 import { validate } from "../factory/validate.mjs";
 import { VALID_RULE, invalidRule } from "../helpers/validation-helpers.mjs";
-import "../helpers/index.mjs";
 import { isEmptyValue } from "../helpers/is-empty-value.mjs";
 import { requiredRule } from "../rules/core/required.mjs";
 import { mapToStandardResult } from "../standard-schema/map-result.mjs";

package/esm/validators/base-validator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"base-validator.mjs","names":["defaultRequiredRule"],"sources":["../../../../../../../seal/src/validators/base-validator.ts"],"sourcesContent":["import { clone } from \"@mongez/reinforcements\";\nimport { validate } from \"../factory/validate\";\nimport { VALID_RULE, invalidRule } from \"../helpers\";\nimport { isEmptyValue } from \"../helpers/is-empty-value\";\nimport { requiredRule as defaultRequiredRule } from \"../rules/core/required\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\nimport { mapToStandardResult } from \"../standard-schema/map-result\";\nimport type { StandardJSONSchemaV1, StandardSchemaV1 } from \"../standard-schema/types\";\nimport type {\n  ContextualSchemaRule,\n  ContextualizedMutator,\n  ContextualizedTransformer,\n  Mutator,\n  SchemaContext,\n  SchemaRule,\n  SchemaRuleOptions,\n  SimpleTransformerCallback,\n  TransformerCallback,\n  ValidationAttributesList,\n  ValidationResult,\n} from \"../types\";\n\n/**\n * Base validator class - foundation for all validators\n */\nexport class BaseValidator<TInput = unknown, TOutput = TInput> {\n  public rules: ContextualSchemaRule[] = [];\n  public mutators: ContextualizedMutator[] = [];\n  protected defaultValue: any | (() => any);\n  protected description?: string;\n  protected shouldOmit = false;\n  protected isNullable = false;\n  protected isMutable = false;\n\n  /**\n   * Catch state — when `hasCatch` is true and validation fails, `catchValue`\n   * (or its callback result) substitutes for the failed value, and the public\n   * result reports `isValid: true` with no errors.\n   *\n   * See `.catch()` for semantics and the v1 scope (leaf-only).\n   */\n  protected catchValue:\n    | any\n    | ((errors: ValidationResult[\"errors\"], originalInput: any) => any | Promise<any>);\n  protected hasCatch = false;\n\n  /**\n   * Whether the field is optional.\n   * - false (default): field is required unless a requiredRule governs the condition.\n   * - true: field can be absent or empty — set by calling .optional().\n   *\n   * Also used as a TypeScript literal brand via the optional() return type.\n   */\n  public isOptional = false;\n\n  /**\n   * The single required-condition rule for this field.\n   * - null: field uses strict default (always required when not optional).\n   * - set: the rule governs when the field is required (e.g., requiredIf).\n   *\n   * Stored separately from rules[] and prepended at validate() time.\n   */\n  public requiredRule: ContextualSchemaRule | null = this.createRule(defaultRequiredRule);\n\n  /**\n   * Pipeline to transform the mutated/original data before returning it\n   */\n  protected dataTransformers: ContextualizedTransformer[] = [];\n\n  /**\n   * Attributes text to be replaced on translations\n   * If the value is an object, it will be used as the attributes list for the rule\n   * If the value is a string, it will be used as the attributes list for the rule\n   */\n  protected attributesText: ValidationAttributesList = {};\n\n  /**\n   * Attributed that will be always using the attribute translator\n   */\n  protected translatedAttributes: Record<string, string> = {};\n\n  /**\n   * Mark the validator as mutable\n   */\n  public get mutable() {\n    this.isMutable = true;\n    return this;\n  }\n\n  /**\n   * Mark the validator as immutable\n   */\n  public get immutable() {\n    this.isMutable = false;\n    return this;\n  }\n\n  /**\n   * Get the instance to apply changes to.\n   * By default (immutable), returns a clone so the original is unchanged.\n   * When `.mutable` is set, returns `this` to mutate in place.\n   */\n  protected get instance(): this {\n    return this.isMutable ? this : this.clone();\n  }\n\n  /**\n   * Get the default value\n   * Supports lazy evaluation via callbacks\n   */\n  public getDefaultValue(): any {\n    return typeof this.defaultValue === \"function\" ? this.defaultValue() : this.defaultValue;\n  }\n\n  /**\n   * Allow null as a valid value.\n   *\n   * Brands the return type with `{ isNullable: true }` so `Infer<>` widens\n   * the inferred output to include `| null`.\n   */\n  public nullable(): this & { isNullable: true } {\n    const instance = this.instance;\n    instance.isNullable = true;\n    return instance as this & { isNullable: true };\n  }\n\n  /**\n   * Explicitly disallow null values after calling nullable.\n   *\n   * Brands the return type with `{ isNullable: false }` to cancel any prior\n   * `.nullable()` at the type level.\n   */\n  public notNullable(): this & { isNullable: false } {\n    const instance = this.instance;\n    instance.isNullable = false;\n    return instance as this & { isNullable: false };\n  }\n\n  /**\n   * Add transformer with optional options\n   *\n   * @param transform - The transformer callback function\n   * @param options - Optional options to pass to the transformer\n   *\n   * @example\n   * ```ts\n   * // Without options\n   * v.date().addTransformer(data => data.toISOString())\n   *\n   * // With options\n   * v.date().addTransformer(\n   *   (data, { options }) => dayjs(data).format(options.format),\n   *   { format: 'YYYY-MM-DD' }\n   * )\n   * ```\n   */\n  public addTransformer(transform: TransformerCallback, options: any = {}) {\n    const instance = this.instance;\n    instance.addMutableTransformer(transform, options);\n\n    return instance;\n  }\n\n  /**\n   * Add transformer with optional options\n   *\n   * @param transform - The transformer callback function\n   * @param options - Optional options to pass to the transformer\n   *\n   * @example\n   * ```ts\n   * // Without options\n   * v.date().addTransformer(data => data.toISOString())\n   *\n   * // With options\n   * v.date().addTransformer(\n   *   (data, { options }) => dayjs(data).format(options.format),\n   *   { format: 'YYYY-MM-DD' }\n   * )\n   * ```\n   */\n  public addMutableTransformer(transform: TransformerCallback, options: any = {}) {\n    this.dataTransformers.push({\n      transform,\n      options,\n    });\n  }\n\n  /**\n   * Transform the output value - simple one-time transformation\n   *\n   * @param callback - Simple callback receiving data and context\n   *\n   * @example\n   * ```ts\n   * // Simple transformation\n   * v.string().outputAs(data => data.toUpperCase())\n   *\n   * // With context\n   * v.string().outputAs((data, context) => {\n   *   console.log(`Transforming ${context.path}`);\n   *   return data.toLowerCase();\n   * })\n   * ```\n   */\n  public outputAs(callback: SimpleTransformerCallback) {\n    return this.addTransformer((data, { context }) => callback(data, context));\n  }\n\n  /**\n   * Transform output to JSON string\n   *\n   * Works with any validator type (string, number, date, object, array, etc.)\n   *\n   * @param indent - Optional indentation for pretty printing (default: 0 for compact)\n   *\n   * @example\n   * ```ts\n   * // Compact JSON\n   * v.object({ name: v.string() }).toJSON()\n   * // Output: '{\"name\":\"John\"}'\n   *\n   * // Pretty-printed JSON\n   * v.array(v.object({...})).toJSON(2)\n   * // Output:\n   * // [\n   * //   {\n   * //     \"name\": \"John\"\n   * //   }\n   * // ]\n   *\n   * // Works with any type\n   * v.string().toJSON()  // '\"hello\"'\n   * v.number().toJSON()  // '42'\n   * v.date().toJSON()    // '\"2024-10-26T00:00:00.000Z\"'\n   * ```\n   *\n   * @category Transformer\n   */\n  public toJSON(indent?: number) {\n    return this.addTransformer((data, { options }) => JSON.stringify(data, null, options.indent), {\n      indent: indent ?? 0,\n    });\n  }\n\n  /**\n   * Start data transformation pipeline\n   * Context is passed at runtime, not stored\n   */\n  public async startTransformationPipeline(data: any, context: SchemaContext) {\n    for (const transformer of this.dataTransformers) {\n      data = await transformer.transform(data, {\n        options: transformer.options,\n        context,\n      });\n    }\n\n    return data;\n  }\n\n  /**\n   * Set attributes text to be replaced on translations\n   * If the value is an object, it will be used as the attributes list for the rule\n   * If the value is a string, it will be used as the attributes list for the rule\n   *\n   * @example\n   * v.string().attributes({\n   *   name: \"Name\",\n   *   email: \"Email\",\n   * });\n   * // Example 2: Add custom attributes for matches\n   * v.string().matches(\"confirmPassword\").attributes({\n   *   matches: {\n   *     confirmPassword: \"Confirm Password\",\n   *   },\n   * });\n   */\n  public attributes(attributes: Record<string, string | Record<string, string>>) {\n    const instance = this.instance;\n    for (const [key, value] of Object.entries(attributes)) {\n      instance.attributesText[key] = value;\n    }\n\n    return instance;\n  }\n\n  /**\n   * Define a lazy getter property for each attribute in the given object and use the config attribute translator\n   */\n  public transAttributes(attributes: Record<string, string>) {\n    const instance = this.instance;\n    for (const [key, value] of Object.entries(attributes)) {\n      instance.translatedAttributes[key] = value;\n    }\n\n    return instance;\n  }\n\n  /**\n   * Add description to the validator\n   */\n  public describe(description: string) {\n    const instance = this.instance;\n    instance.description = description;\n    return instance;\n  }\n\n  /**\n   * Check if this validator can handle the given value's type\n   * Override this in specific validators to enable type-based routing in union validators\n   *\n   * Default: returns true (validator will attempt to validate any type)\n   *\n   * @param value - The value to check\n   * @returns True if this validator can handle this type\n   *\n   * @example\n   * ```ts\n   * // StringValidator\n   * public matchesType(value: any): boolean {\n   *   return typeof value === 'string';\n   * }\n   *\n   * // Custom FileValidator\n   * public matchesType(value: any): boolean {\n   *   return value instanceof UploadedFile;\n   * }\n   * ```\n   */\n  public matchesType(_value: any): boolean {\n    return true; // Default: permissive, attempt to validate any type\n  }\n\n  /**\n   * Create a copy of this validator with the same configuration\n   * Copies all rules, mutators, transformers, default values, and settings\n   *\n   * @returns A new validator instance with copied configuration\n   *\n   * @example\n   * ```ts\n   * // Create reusable validator templates\n   * const baseString = v.string().required().trim().min(3);\n   * const emailField = baseString.clone().email();\n   * const usernameField = baseString.clone().alphanumeric().max(20);\n   *\n   * // Works with all validators\n   * const positiveInt = v.int().positive().required();\n   * const ageField = positiveInt.clone().min(18).max(120);\n   * ```\n   */\n  public clone(): this {\n    // Create a new instance using Object.create to preserve the prototype chain\n    const Constructor = this.constructor as new (...args: any[]) => this;\n    const cloned = Object.create(Constructor.prototype);\n\n    // Copy all BaseValidator properties\n    cloned.rules = [...this.rules];\n    cloned.mutators = [...this.mutators];\n    cloned.dataTransformers = [...this.dataTransformers];\n    cloned.defaultValue = this.defaultValue;\n    cloned.shouldOmit = this.shouldOmit;\n    cloned.description = this.description;\n    cloned.attributesText = { ...this.attributesText };\n    cloned.isNullable = this.isNullable;\n    cloned.isOptional = this.isOptional;\n    cloned.requiredRule = this.requiredRule; // same reference is fine — rule is treated as immutable\n    cloned.catchValue = this.catchValue;\n    cloned.hasCatch = this.hasCatch;\n\n    return cloned;\n  }\n\n  /**\n   * @deprecated This method is no longer needed and does nothing.\n   * Empty values are now automatically skipped for validation rules by default.\n   * Only presence validators (required, present, etc.) will check empty values.\n   * You can safely remove this call from your code.\n   */\n  public ignoreEmptyValue(_ignoreEmptyValue = true) {\n    // No-op for backward compatibility\n    return this;\n  }\n\n  /**\n   * Omit this field from the validated data output\n   *\n   * Field will still be validated but not included in the final result.\n   * Useful for confirmation fields, captcha, terms acceptance, etc.\n   *\n   * @example\n   * ```ts\n   * v.object({\n   *   password: v.string().required(),\n   *   confirmPassword: v.string().required().sameAs(\"password\").omit(),\n   *   acceptTerms: v.boolean().required().omit(),\n   * });\n   * // Output: { password: \"...\" }\n   * // confirmPassword and acceptTerms validated but omitted\n   * ```\n   */\n  public omit() {\n    const instance = this.instance;\n    instance.shouldOmit = true;\n    return instance;\n  }\n\n  /**\n   * @alias omit\n   */\n  public exclude() {\n    return this.omit();\n  }\n\n  /**\n   * Check if this field should be omitted from the output\n   */\n  public isOmitted(): boolean {\n    return this.shouldOmit;\n  }\n\n  /**\n   * Add rule to the validator\n   */\n  public addRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): this {\n    const instance = this.instance;\n    instance.addMutableRule(rule, errorMessage, options);\n    return instance;\n  }\n\n  /**\n   * Set the required-condition rule for this field.\n   *\n   * Unlike addRule(), this does NOT push to rules[]. The rule is stored in the\n   * dedicated `requiredRule` slot and is prepended to the validation pipeline\n   * at runtime. Only one required rule can be active per field — this replaces\n   * any previously set required rule.\n   *\n   * Also marks the field as not optional (isOptional = false).\n   *\n   * @example\n   * ```ts\n   * // Used internally by required(), requiredIf(), requiredWith(), etc.\n   * BaseValidator.prototype.required = function(msg) {\n   *   return this.setRequiredRule(requiredRule, msg);\n   * };\n   * ```\n   */\n  public setRequiredRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): this {\n    const instance = this.instance;\n    instance.isOptional = false;\n    instance.requiredRule = instance.createRule(rule, errorMessage, options);\n    return instance;\n  }\n\n  /**\n   * Add mutable rule\n   */\n  public addMutableRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): ContextualSchemaRule<T> {\n    const newRule: ContextualSchemaRule<T> = this.createRule(rule, errorMessage, options);\n\n    this.rules.push(newRule);\n\n    return newRule;\n  }\n\n  /**\n   * Create new rule\n   */\n  protected createRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): ContextualSchemaRule<T> {\n    const newRule: ContextualSchemaRule<T> = {\n      ...(clone(rule) as ContextualSchemaRule<T>),\n      context: {\n        errorMessage,\n        options,\n        attributesList: this.attributesText,\n        translatedAttributes: this.translatedAttributes,\n        translationParams: {},\n        translatableParams: {},\n      },\n    };\n\n    if (errorMessage) {\n      newRule.errorMessage = errorMessage;\n    }\n\n    if (rule.sortOrder === undefined) {\n      newRule.sortOrder = this.rules.length + 1;\n    }\n\n    return newRule;\n  }\n\n  /**\n   * Use a custom or pre-built validation rule\n   *\n   * @param rule - The validation rule to apply\n   * @param options - Rule options including errorMessage and any rule-specific options\n   *\n   * @example\n   * ```ts\n   * import { hexColorRule } from \"@warlock.js/seal\";\n   *\n   * v.string().useRule(hexColorRule, { errorMessage: \"Invalid color\" });\n   * ```\n   *\n   * @example\n   * ```ts\n   * // With rule options\n   * v.string().useRule(myCustomRule, {\n   *   customOption: true,\n   *   errorMessage: \"Custom validation failed\"\n   * });\n   * ```\n   */\n  public useRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    options?: T & { errorMessage?: string },\n  ) {\n    const { errorMessage, ...ruleOptions } = options || ({} as any);\n    return this.addRule(rule, errorMessage, ruleOptions);\n  }\n\n  /**\n   * Define custom rule\n   */\n  public refine(\n    callback: (\n      value: any,\n      context: SchemaContext,\n    ) => Promise<string | undefined> | string | undefined,\n  ) {\n    return this.addRule({\n      name: \"custom\",\n      async validate(value, context) {\n        const result = await callback(value, context);\n        if (result) {\n          this.context.errorMessage = result;\n          return invalidRule(this, context);\n        }\n        return VALID_RULE;\n      },\n    });\n  }\n\n  /**\n   * Add mutator to the validator\n   */\n  public addMutator(mutator: Mutator, options: any = {}) {\n    const instance = this.instance;\n    instance.addMutableMutator(mutator, options);\n    return instance;\n  }\n\n  /**\n   * Add mutable mutator\n   */\n  public addMutableMutator(mutator: Mutator, options: any = {}) {\n    this.mutators.push({\n      mutate: mutator,\n      context: {\n        options,\n        ctx: {} as any,\n      },\n    });\n  }\n\n  /**\n   * Set default value for the field. The default is used when the input is\n   * absent (`undefined`); it then flows through the rule pipeline.\n   *\n   * Brands the return type with `{ hasDefault: true }` so `Infer<>` treats\n   * the field as guaranteed-present even when chained with `.optional()`.\n   */\n  public default(value: any): this & { hasDefault: true } {\n    const instance = this.instance;\n    instance.defaultValue = value;\n    return instance as this & { hasDefault: true };\n  }\n\n  /**\n   * Fallback to a value when validation fails.\n   *\n   * Complementary to `.default()`: `.default(x)` fires when input is **absent**,\n   * `.catch(y)` fires when input is **present but invalid**. Combine them when\n   * you want both behaviours: `.optional().default(x).catch(y)`.\n   *\n   * The fallback can be a value or a callback `(errors, originalInput) => fallback`.\n   * The callback variant is the only side-channel for the swallowed errors —\n   * use it to log/alert before the fallback substitutes.\n   *\n   * Brands the return type with `{ hasCatch: true }` so `Infer<>` treats the\n   * field as guaranteed-present (the catch ensures a value will always exist).\n   *\n   * **Scope (v1).** Catch is honoured for **leaf validators** (string, number,\n   * boolean, date, …) and for fields inside containers. It is a **no-op on\n   * container validators themselves** (`v.object`, `v.array`, `v.record`,\n   * `v.tuple`, `v.discriminatedUnion`) — those use their own iteration logic\n   * that bypasses the catch hook in `BaseValidator.validate()`.\n   *\n   * @example\n   * ```ts\n   * v.int().min(0).catch(3)                   // bad number → 3\n   * v.string().in([\"us\", \"eu\"]).catch(\"us\")   // unknown enum → \"us\"\n   * v.string().catch((errors, input) => {\n   *   console.warn(`bad user value: ${JSON.stringify(input)}`, errors);\n   *   return \"anonymous\";\n   * })\n   * ```\n   */\n  public catch(\n    fallback:\n      | any\n      | ((errors: ValidationResult[\"errors\"], originalInput: any) => any | Promise<any>),\n  ): this & { hasCatch: true } {\n    const instance = this.instance;\n\n    instance.catchValue = fallback;\n    instance.hasCatch = true;\n\n    return instance as this & { hasCatch: true };\n  }\n\n  /**\n   * Mutate the data\n   */\n  public async mutate(data: any, context: SchemaContext) {\n    let mutatedData = data;\n\n    for (const mutator of this.mutators) {\n      mutator.context.ctx = context;\n      mutatedData = await mutator.mutate(mutatedData, mutator.context);\n    }\n\n    return mutatedData;\n  }\n\n  /**\n   * Set the label for the validator that will be matching the :input attribute\n   */\n  public label(label: string) {\n    const instance = this.instance;\n    instance.attributesText.input = label;\n    return instance;\n  }\n\n  /**\n   * Validate the data\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    if (data === null && this.isNullable) {\n      return { isValid: true, errors: [], data: null };\n    }\n\n    const valueForRules = data ?? this.getDefaultValue();\n    const mutatedData = await this.mutate(valueForRules, context);\n\n    const errors: ValidationResult[\"errors\"] = [];\n    let isValid = true;\n    const isFirstErrorOnly = context.configurations?.firstErrorOnly ?? true;\n\n    const isEmpty = isEmptyValue(valueForRules);\n\n    // D8 fix (design/core-defects-found.md): for an optional field, only a\n    // truly ABSENT value (`valueForRules === undefined` — the key was\n    // missing, or was `null`/`undefined` and got coalesced above) may skip\n    // the value rules. A PRESENT-but-empty value (e.g. `\"\"` from `?page=`)\n    // must still run them, so `v.int().optional()` given `\"\"` fails instead\n    // of silently handing back a string that `Infer.Output`'s\n    // `number | undefined` forbids. Non-optional fields are unaffected —\n    // their `requiredRule` (not nulled out by `.optional()`) already rejects\n    // `\"\"` before these rules matter.\n    const skipEmptyRules = this.isOptional ? valueForRules === undefined : isEmpty;\n\n    // Prepend the required-condition rule if set, so it always runs first.\n    // requiredRule has requiresValue = false so it runs even on empty values.\n    const rulesToRun = this.requiredRule ? [this.requiredRule, ...this.rules] : this.rules;\n\n    for (const rule of rulesToRun) {\n      if ((rule.requiresValue ?? true) && skipEmptyRules) continue;\n\n      this.setRuleAttributesList(rule);\n\n      const result = await rule.validate(mutatedData, context);\n\n      if (result.isValid === false) {\n        isValid = false;\n        errors.push({\n          type: rule.name,\n          error: result.error,\n          input: result.path ?? context.path,\n        });\n\n        if (isFirstErrorOnly) {\n          break;\n        }\n      }\n    }\n\n    const result: ValidationResult = {\n      isValid,\n      errors,\n      data:\n        mutatedData !== undefined\n          ? await this.startTransformationPipeline(mutatedData, context)\n          : undefined,\n    };\n\n    // Catch fallback — only on the leaf path. Container validators override\n    // validate() and don't run this hook on their own outcome, so catching\n    // a whole object/array/record is a no-op in v1.\n    if (result.isValid === false && this.hasCatch) {\n      const fallback =\n        typeof this.catchValue === \"function\"\n          ? await this.catchValue(result.errors, data)\n          : this.catchValue;\n\n      return { isValid: true, errors: [], data: fallback };\n    }\n\n    return result;\n  }\n\n  /**\n   * Set rule attributes list\n   */\n  protected setRuleAttributesList(rule: ContextualSchemaRule) {\n    rule.context.attributesList =\n      typeof this.attributesText[rule.name] === \"object\"\n        ? (this.attributesText[rule.name] as ValidationAttributesList)\n        : this.attributesText;\n  }\n\n  /**\n   * Standard Schema V1 compliance.\n   *\n   * Allows this validator to be used with any Standard Schema-aware library\n   * (OpenAI structured outputs, LangGraph, TanStack Form, Conform, Valibot adapters, etc.)\n   * without extra adapters.\n   *\n   * Delegates to the `validate()` factory so all `configureSeal()` options\n   * (translations, firstErrorOnly) are picked up automatically at call time.\n   *\n   * Includes Standard JSON Schema support via `jsonSchema.input()` / `jsonSchema.output()`.\n   *\n   * ## How Standard Schema libraries consume this\n   *\n   * You pass the **schema object itself** to the library — they internally read\n   * `schema[\"~standard\"]`. Do NOT pass `schema[\"~standard\"]` directly.\n   *\n   * @example\n   * ```ts\n   * const schema = v.object({ name: v.string().required() });\n   *\n   * // TanStack Form — pass schema, library reads [\"~standard\"] internally\n   * const form = useForm({ validators: { onChange: schema } });\n   *\n   * // Conform (Remix) — same pattern\n   * const [form] = useForm({ onValidate({ formData }) {\n   *   return parseWithStandardSchema(formData, { schema });\n   * }});\n   *\n   * // Direct validation (lower level — most apps don't need this)\n   * const result = await schema[\"~standard\"].validate({ name: \"Hasan\" });\n   * // → { value: { name: \"Hasan\" } }  on success\n   * // → { issues: [{ message: \"...\", path: [{ key: \"name\" }] }] }  on failure\n   *\n   * // JSON Schema for OpenAI / LangChain tool calling\n   * const parameters = schema[\"~standard\"].jsonSchema.input({ target: \"openai-strict\" });\n   * // → { type: \"object\", properties: {...}, required: [...], additionalProperties: false }\n   * ```\n   *\n   * @note Cross-field rules (sameAs, requiredIf, requiredWith) rely on sibling values\n   * available in the full validation context. When called on a standalone scalar validator,\n   * sibling data is absent and those rules will not evaluate correctly.\n   * Always call on the parent ObjectValidator for full-payload validation.\n   */\n  get [\"~standard\"](): StandardJSONSchemaV1.Props<TInput, TOutput> {\n    return {\n      version: 1,\n      vendor: \"seal\",\n      types: undefined as unknown as StandardSchemaV1.Types<TInput, TOutput>,\n      validate: async (value: unknown) => {\n        const result = await validate(this, value);\n        return mapToStandardResult(result) as StandardSchemaV1.Result<TOutput>;\n      },\n      jsonSchema: {\n        input: (options) => this.toJsonSchema(options.target),\n        output: (options) => this.toJsonSchema(options.target),\n      },\n    };\n  }\n\n  /**\n   * Generate a JSON Schema representation of this validator.\n   *\n   * Supports targets: `\"draft-2020-12\"` (default), `\"draft-07\"`, `\"openapi-3.0\"`.\n   *\n   * Subclasses override this to describe their specific constraints.\n   * The base implementation returns `{}` (permissive — accepts anything),\n   * which is correct for validators with no representable JSON Schema constraints.\n   *\n   * @note Rules that cannot be expressed in JSON Schema are silently omitted:\n   * - Cross-field rules: sameAs, requiredIf, requiredWith, requiredWithout\n   * - Custom callbacks: refine()\n   * - Framework-specific runtime rules (core/cascade plugins)\n   * These rules still run normally at validation time — only absent from JSON Schema.\n   *\n   * @example\n   * ```ts\n   * v.string().min(3).max(50).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"string\", minLength: 3, maxLength: 50 }\n   *\n   * v.object({ name: v.string().required(), age: v.int().optional() })\n   *   .toJsonSchema(\"draft-07\")\n   * // → { type: \"object\", properties: { name: { type: \"string\" }, age: { type: \"integer\" } }, required: [\"name\"] }\n   * ```\n   */\n  public toJsonSchema(_target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    return {};\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"base-validator.mjs","names":["defaultRequiredRule"],"sources":["../../../../../../../seal/src/validators/base-validator.ts"],"sourcesContent":["import { clone } from \"@mongez/reinforcements\";\nimport { validate } from \"../factory/validate\";\nimport { VALID_RULE, invalidRule } from \"../helpers/validation-helpers\";\nimport { isEmptyValue } from \"../helpers/is-empty-value\";\nimport { requiredRule as defaultRequiredRule } from \"../rules/core/required\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\nimport { mapToStandardResult } from \"../standard-schema/map-result\";\nimport type { StandardJSONSchemaV1, StandardSchemaV1 } from \"../standard-schema/types\";\nimport type {\n  ContextualSchemaRule,\n  ContextualizedMutator,\n  ContextualizedTransformer,\n  Mutator,\n  SchemaContext,\n  SchemaRule,\n  SchemaRuleOptions,\n  SimpleTransformerCallback,\n  TransformerCallback,\n  ValidationAttributesList,\n  ValidationResult,\n} from \"../types\";\n\n/**\n * Base validator class - foundation for all validators\n */\nexport class BaseValidator<TInput = unknown, TOutput = TInput> {\n  public rules: ContextualSchemaRule[] = [];\n  public mutators: ContextualizedMutator[] = [];\n  protected defaultValue: any | (() => any);\n  protected description?: string;\n  protected shouldOmit = false;\n  protected isNullable = false;\n  protected isMutable = false;\n\n  /**\n   * Catch state — when `hasCatch` is true and validation fails, `catchValue`\n   * (or its callback result) substitutes for the failed value, and the public\n   * result reports `isValid: true` with no errors.\n   *\n   * See `.catch()` for semantics and the v1 scope (leaf-only).\n   */\n  protected catchValue:\n    any | ((errors: ValidationResult[\"errors\"], originalInput: any) => any | Promise<any>);\n  protected hasCatch = false;\n\n  /**\n   * Whether the field is optional.\n   * - false (default): field is required unless a requiredRule governs the condition.\n   * - true: field can be absent or empty — set by calling .optional().\n   *\n   * Also used as a TypeScript literal brand via the optional() return type.\n   */\n  public isOptional = false;\n\n  /**\n   * The single required-condition rule for this field.\n   * - null: field uses strict default (always required when not optional).\n   * - set: the rule governs when the field is required (e.g., requiredIf).\n   *\n   * Stored separately from rules[] and prepended at validate() time.\n   */\n  public requiredRule: ContextualSchemaRule | null = this.createRule(defaultRequiredRule);\n\n  /**\n   * Pipeline to transform the mutated/original data before returning it\n   */\n  protected dataTransformers: ContextualizedTransformer[] = [];\n\n  /**\n   * Attributes text to be replaced on translations\n   * If the value is an object, it will be used as the attributes list for the rule\n   * If the value is a string, it will be used as the attributes list for the rule\n   */\n  protected attributesText: ValidationAttributesList = {};\n\n  /**\n   * Attributed that will be always using the attribute translator\n   */\n  protected translatedAttributes: Record<string, string> = {};\n\n  /**\n   * Mark the validator as mutable\n   */\n  public get mutable() {\n    this.isMutable = true;\n    return this;\n  }\n\n  /**\n   * Mark the validator as immutable\n   */\n  public get immutable() {\n    this.isMutable = false;\n    return this;\n  }\n\n  /**\n   * Get the instance to apply changes to.\n   * By default (immutable), returns a clone so the original is unchanged.\n   * When `.mutable` is set, returns `this` to mutate in place.\n   */\n  protected get instance(): this {\n    return this.isMutable ? this : this.clone();\n  }\n\n  /**\n   * Get the default value\n   * Supports lazy evaluation via callbacks\n   */\n  public getDefaultValue(): any {\n    return typeof this.defaultValue === \"function\" ? this.defaultValue() : this.defaultValue;\n  }\n\n  /**\n   * Allow null as a valid value.\n   *\n   * Brands the return type with `{ isNullable: true }` so `Infer<>` widens\n   * the inferred output to include `| null`.\n   */\n  public nullable(): this & { isNullable: true } {\n    const instance = this.instance;\n    instance.isNullable = true;\n    return instance as this & { isNullable: true };\n  }\n\n  /**\n   * Explicitly disallow null values after calling nullable.\n   *\n   * Brands the return type with `{ isNullable: false }` to cancel any prior\n   * `.nullable()` at the type level.\n   */\n  public notNullable(): this & { isNullable: false } {\n    const instance = this.instance;\n    instance.isNullable = false;\n    return instance as this & { isNullable: false };\n  }\n\n  /**\n   * Add transformer with optional options\n   *\n   * @param transform - The transformer callback function\n   * @param options - Optional options to pass to the transformer\n   *\n   * @example\n   * ```ts\n   * // Without options\n   * v.date().addTransformer(data => data.toISOString())\n   *\n   * // With options\n   * v.date().addTransformer(\n   *   (data, { options }) => dayjs(data).format(options.format),\n   *   { format: 'YYYY-MM-DD' }\n   * )\n   * ```\n   */\n  public addTransformer(transform: TransformerCallback, options: any = {}) {\n    const instance = this.instance;\n    instance.addMutableTransformer(transform, options);\n\n    return instance;\n  }\n\n  /**\n   * Add transformer with optional options\n   *\n   * @param transform - The transformer callback function\n   * @param options - Optional options to pass to the transformer\n   *\n   * @example\n   * ```ts\n   * // Without options\n   * v.date().addTransformer(data => data.toISOString())\n   *\n   * // With options\n   * v.date().addTransformer(\n   *   (data, { options }) => dayjs(data).format(options.format),\n   *   { format: 'YYYY-MM-DD' }\n   * )\n   * ```\n   */\n  public addMutableTransformer(transform: TransformerCallback, options: any = {}) {\n    this.dataTransformers.push({\n      transform,\n      options,\n    });\n  }\n\n  /**\n   * Transform the output value - simple one-time transformation\n   *\n   * @param callback - Simple callback receiving data and context\n   *\n   * @example\n   * ```ts\n   * // Simple transformation\n   * v.string().outputAs(data => data.toUpperCase())\n   *\n   * // With context\n   * v.string().outputAs((data, context) => {\n   *   console.log(`Transforming ${context.path}`);\n   *   return data.toLowerCase();\n   * })\n   * ```\n   */\n  public outputAs(callback: SimpleTransformerCallback) {\n    return this.addTransformer((data, { context }) => callback(data, context));\n  }\n\n  /**\n   * Transform output to JSON string\n   *\n   * Works with any validator type (string, number, date, object, array, etc.)\n   *\n   * @param indent - Optional indentation for pretty printing (default: 0 for compact)\n   *\n   * @example\n   * ```ts\n   * // Compact JSON\n   * v.object({ name: v.string() }).toJSON()\n   * // Output: '{\"name\":\"John\"}'\n   *\n   * // Pretty-printed JSON\n   * v.array(v.object({...})).toJSON(2)\n   * // Output:\n   * // [\n   * //   {\n   * //     \"name\": \"John\"\n   * //   }\n   * // ]\n   *\n   * // Works with any type\n   * v.string().toJSON()  // '\"hello\"'\n   * v.number().toJSON()  // '42'\n   * v.date().toJSON()    // '\"2024-10-26T00:00:00.000Z\"'\n   * ```\n   *\n   * @category Transformer\n   */\n  public toJSON(indent?: number) {\n    return this.addTransformer((data, { options }) => JSON.stringify(data, null, options.indent), {\n      indent: indent ?? 0,\n    });\n  }\n\n  /**\n   * Start data transformation pipeline\n   * Context is passed at runtime, not stored\n   */\n  public async startTransformationPipeline(data: any, context: SchemaContext) {\n    for (const transformer of this.dataTransformers) {\n      data = await transformer.transform(data, {\n        options: transformer.options,\n        context,\n      });\n    }\n\n    return data;\n  }\n\n  /**\n   * Set attributes text to be replaced on translations\n   * If the value is an object, it will be used as the attributes list for the rule\n   * If the value is a string, it will be used as the attributes list for the rule\n   *\n   * @example\n   * v.string().attributes({\n   *   name: \"Name\",\n   *   email: \"Email\",\n   * });\n   * // Example 2: Add custom attributes for matches\n   * v.string().matches(\"confirmPassword\").attributes({\n   *   matches: {\n   *     confirmPassword: \"Confirm Password\",\n   *   },\n   * });\n   */\n  public attributes(attributes: Record<string, string | Record<string, string>>) {\n    const instance = this.instance;\n    for (const [key, value] of Object.entries(attributes)) {\n      instance.attributesText[key] = value;\n    }\n\n    return instance;\n  }\n\n  /**\n   * Define a lazy getter property for each attribute in the given object and use the config attribute translator\n   */\n  public transAttributes(attributes: Record<string, string>) {\n    const instance = this.instance;\n    for (const [key, value] of Object.entries(attributes)) {\n      instance.translatedAttributes[key] = value;\n    }\n\n    return instance;\n  }\n\n  /**\n   * Add description to the validator\n   */\n  public describe(description: string) {\n    const instance = this.instance;\n    instance.description = description;\n    return instance;\n  }\n\n  /**\n   * Check if this validator can handle the given value's type\n   * Override this in specific validators to enable type-based routing in union validators\n   *\n   * Default: returns true (validator will attempt to validate any type)\n   *\n   * @param value - The value to check\n   * @returns True if this validator can handle this type\n   *\n   * @example\n   * ```ts\n   * // StringValidator\n   * public matchesType(value: any): boolean {\n   *   return typeof value === 'string';\n   * }\n   *\n   * // Custom FileValidator\n   * public matchesType(value: any): boolean {\n   *   return value instanceof UploadedFile;\n   * }\n   * ```\n   */\n  public matchesType(_value: any): boolean {\n    return true; // Default: permissive, attempt to validate any type\n  }\n\n  /**\n   * Create a copy of this validator with the same configuration\n   * Copies all rules, mutators, transformers, default values, and settings\n   *\n   * @returns A new validator instance with copied configuration\n   *\n   * @example\n   * ```ts\n   * // Create reusable validator templates\n   * const baseString = v.string().required().trim().min(3);\n   * const emailField = baseString.clone().email();\n   * const usernameField = baseString.clone().alphanumeric().max(20);\n   *\n   * // Works with all validators\n   * const positiveInt = v.int().positive().required();\n   * const ageField = positiveInt.clone().min(18).max(120);\n   * ```\n   */\n  public clone(): this {\n    // Create a new instance using Object.create to preserve the prototype chain\n    const Constructor = this.constructor as new (...args: any[]) => this;\n    const cloned = Object.create(Constructor.prototype);\n\n    // Copy all BaseValidator properties\n    cloned.rules = [...this.rules];\n    cloned.mutators = [...this.mutators];\n    cloned.dataTransformers = [...this.dataTransformers];\n    cloned.defaultValue = this.defaultValue;\n    cloned.shouldOmit = this.shouldOmit;\n    cloned.description = this.description;\n    cloned.attributesText = { ...this.attributesText };\n    cloned.isNullable = this.isNullable;\n    cloned.isOptional = this.isOptional;\n    cloned.requiredRule = this.requiredRule; // same reference is fine — rule is treated as immutable\n    cloned.catchValue = this.catchValue;\n    cloned.hasCatch = this.hasCatch;\n\n    return cloned;\n  }\n\n  /**\n   * @deprecated This method is no longer needed and does nothing.\n   * Empty values are now automatically skipped for validation rules by default.\n   * Only presence validators (required, present, etc.) will check empty values.\n   * You can safely remove this call from your code.\n   */\n  public ignoreEmptyValue(_ignoreEmptyValue = true) {\n    // No-op for backward compatibility\n    return this;\n  }\n\n  /**\n   * Omit this field from the validated data output\n   *\n   * Field will still be validated but not included in the final result.\n   * Useful for confirmation fields, captcha, terms acceptance, etc.\n   *\n   * @example\n   * ```ts\n   * v.object({\n   *   password: v.string().required(),\n   *   confirmPassword: v.string().required().sameAs(\"password\").omit(),\n   *   acceptTerms: v.boolean().required().omit(),\n   * });\n   * // Output: { password: \"...\" }\n   * // confirmPassword and acceptTerms validated but omitted\n   * ```\n   */\n  public omit() {\n    const instance = this.instance;\n    instance.shouldOmit = true;\n    return instance;\n  }\n\n  /**\n   * @alias omit\n   */\n  public exclude() {\n    return this.omit();\n  }\n\n  /**\n   * Check if this field should be omitted from the output\n   */\n  public isOmitted(): boolean {\n    return this.shouldOmit;\n  }\n\n  /**\n   * Add rule to the validator\n   */\n  public addRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): this {\n    const instance = this.instance;\n    instance.addMutableRule(rule, errorMessage, options);\n    return instance;\n  }\n\n  /**\n   * Set the required-condition rule for this field.\n   *\n   * Unlike addRule(), this does NOT push to rules[]. The rule is stored in the\n   * dedicated `requiredRule` slot and is prepended to the validation pipeline\n   * at runtime. Only one required rule can be active per field — this replaces\n   * any previously set required rule.\n   *\n   * Also marks the field as not optional (isOptional = false).\n   *\n   * @example\n   * ```ts\n   * // Used internally by required(), requiredIf(), requiredWith(), etc.\n   * BaseValidator.prototype.required = function(msg) {\n   *   return this.setRequiredRule(requiredRule, msg);\n   * };\n   * ```\n   */\n  public setRequiredRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): this {\n    const instance = this.instance;\n    instance.isOptional = false;\n    instance.requiredRule = instance.createRule(rule, errorMessage, options);\n    return instance;\n  }\n\n  /**\n   * Add mutable rule\n   */\n  public addMutableRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): ContextualSchemaRule<T> {\n    const newRule: ContextualSchemaRule<T> = this.createRule(rule, errorMessage, options);\n\n    this.rules.push(newRule);\n\n    return newRule;\n  }\n\n  /**\n   * Create new rule\n   */\n  protected createRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    errorMessage?: string,\n    options: T = {} as T,\n  ): ContextualSchemaRule<T> {\n    const newRule: ContextualSchemaRule<T> = {\n      ...(clone(rule) as ContextualSchemaRule<T>),\n      context: {\n        errorMessage,\n        options,\n        attributesList: this.attributesText,\n        translatedAttributes: this.translatedAttributes,\n        translationParams: {},\n        translatableParams: {},\n      },\n    };\n\n    if (errorMessage) {\n      newRule.errorMessage = errorMessage;\n    }\n\n    if (rule.sortOrder === undefined) {\n      newRule.sortOrder = this.rules.length + 1;\n    }\n\n    return newRule;\n  }\n\n  /**\n   * Use a custom or pre-built validation rule\n   *\n   * @param rule - The validation rule to apply\n   * @param options - Rule options including errorMessage and any rule-specific options\n   *\n   * @example\n   * ```ts\n   * import { hexColorRule } from \"@warlock.js/seal\";\n   *\n   * v.string().useRule(hexColorRule, { errorMessage: \"Invalid color\" });\n   * ```\n   *\n   * @example\n   * ```ts\n   * // With rule options\n   * v.string().useRule(myCustomRule, {\n   *   customOption: true,\n   *   errorMessage: \"Custom validation failed\"\n   * });\n   * ```\n   */\n  public useRule<T extends SchemaRuleOptions = SchemaRuleOptions>(\n    rule: SchemaRule<T>,\n    options?: T & { errorMessage?: string },\n  ) {\n    const { errorMessage, ...ruleOptions } = options || ({} as any);\n    return this.addRule(rule, errorMessage, ruleOptions);\n  }\n\n  /**\n   * Define custom rule\n   */\n  public refine(\n    callback: (\n      value: any,\n      context: SchemaContext,\n    ) => Promise<string | undefined> | string | undefined,\n  ) {\n    return this.addRule({\n      name: \"custom\",\n      async validate(value, context) {\n        const result = await callback(value, context);\n        if (result) {\n          this.context.errorMessage = result;\n          return invalidRule(this, context);\n        }\n        return VALID_RULE;\n      },\n    });\n  }\n\n  /**\n   * Add mutator to the validator\n   */\n  public addMutator(mutator: Mutator, options: any = {}) {\n    const instance = this.instance;\n    instance.addMutableMutator(mutator, options);\n    return instance;\n  }\n\n  /**\n   * Add mutable mutator\n   */\n  public addMutableMutator(mutator: Mutator, options: any = {}) {\n    this.mutators.push({\n      mutate: mutator,\n      context: {\n        options,\n        ctx: {} as any,\n      },\n    });\n  }\n\n  /**\n   * Set default value for the field. The default is used when the input is\n   * absent (`undefined`); it then flows through the rule pipeline.\n   *\n   * Brands the return type with `{ hasDefault: true }` so `Infer<>` treats\n   * the field as guaranteed-present even when chained with `.optional()`.\n   */\n  public default(value: any): this & { hasDefault: true } {\n    const instance = this.instance;\n    instance.defaultValue = value;\n    return instance as this & { hasDefault: true };\n  }\n\n  /**\n   * Fallback to a value when validation fails.\n   *\n   * Complementary to `.default()`: `.default(x)` fires when input is **absent**,\n   * `.catch(y)` fires when input is **present but invalid**. Combine them when\n   * you want both behaviours: `.optional().default(x).catch(y)`.\n   *\n   * The fallback can be a value or a callback `(errors, originalInput) => fallback`.\n   * The callback variant is the only side-channel for the swallowed errors —\n   * use it to log/alert before the fallback substitutes.\n   *\n   * Brands the return type with `{ hasCatch: true }` so `Infer<>` treats the\n   * field as guaranteed-present (the catch ensures a value will always exist).\n   *\n   * **Scope (v1).** Catch is honoured for **leaf validators** (string, number,\n   * boolean, date, …) and for fields inside containers. It is a **no-op on\n   * container validators themselves** (`v.object`, `v.array`, `v.record`,\n   * `v.tuple`, `v.discriminatedUnion`) — those use their own iteration logic\n   * that bypasses the catch hook in `BaseValidator.validate()`.\n   *\n   * @example\n   * ```ts\n   * v.int().min(0).catch(3)                   // bad number → 3\n   * v.string().in([\"us\", \"eu\"]).catch(\"us\")   // unknown enum → \"us\"\n   * v.string().catch((errors, input) => {\n   *   console.warn(`bad user value: ${JSON.stringify(input)}`, errors);\n   *   return \"anonymous\";\n   * })\n   * ```\n   */\n  public catch(\n    fallback:\n      any | ((errors: ValidationResult[\"errors\"], originalInput: any) => any | Promise<any>),\n  ): this & { hasCatch: true } {\n    const instance = this.instance;\n\n    instance.catchValue = fallback;\n    instance.hasCatch = true;\n\n    return instance as this & { hasCatch: true };\n  }\n\n  /**\n   * Mutate the data\n   */\n  public async mutate(data: any, context: SchemaContext) {\n    let mutatedData = data;\n\n    for (const mutator of this.mutators) {\n      mutator.context.ctx = context;\n      mutatedData = await mutator.mutate(mutatedData, mutator.context);\n    }\n\n    return mutatedData;\n  }\n\n  /**\n   * Set the label for the validator that will be matching the :input attribute\n   */\n  public label(label: string) {\n    const instance = this.instance;\n    instance.attributesText.input = label;\n    return instance;\n  }\n\n  /**\n   * Validate the data\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    if (data === null && this.isNullable) {\n      return { isValid: true, errors: [], data: null };\n    }\n\n    const valueForRules = data ?? this.getDefaultValue();\n    const mutatedData = await this.mutate(valueForRules, context);\n\n    const errors: ValidationResult[\"errors\"] = [];\n    let isValid = true;\n    const isFirstErrorOnly = context.configurations?.firstErrorOnly ?? true;\n\n    const isEmpty = isEmptyValue(valueForRules);\n\n    // D8 fix (design/core-defects-found.md): for an optional field, only a\n    // truly ABSENT value (`valueForRules === undefined` — the key was\n    // missing, or was `null`/`undefined` and got coalesced above) may skip\n    // the value rules. A PRESENT-but-empty value (e.g. `\"\"` from `?page=`)\n    // must still run them, so `v.int().optional()` given `\"\"` fails instead\n    // of silently handing back a string that `Infer.Output`'s\n    // `number | undefined` forbids. Non-optional fields are unaffected —\n    // their `requiredRule` (not nulled out by `.optional()`) already rejects\n    // `\"\"` before these rules matter.\n    const skipEmptyRules = this.isOptional ? valueForRules === undefined : isEmpty;\n\n    // Prepend the required-condition rule if set, so it always runs first.\n    // requiredRule has requiresValue = false so it runs even on empty values.\n    const rulesToRun = this.requiredRule ? [this.requiredRule, ...this.rules] : this.rules;\n\n    for (const rule of rulesToRun) {\n      if ((rule.requiresValue ?? true) && skipEmptyRules) continue;\n\n      this.setRuleAttributesList(rule);\n\n      const result = await rule.validate(mutatedData, context);\n\n      if (result.isValid === false) {\n        isValid = false;\n        errors.push({\n          type: rule.name,\n          error: result.error,\n          input: result.path ?? context.path,\n        });\n\n        if (isFirstErrorOnly) {\n          break;\n        }\n      }\n    }\n\n    const result: ValidationResult = {\n      isValid,\n      errors,\n      data:\n        mutatedData !== undefined\n          ? await this.startTransformationPipeline(mutatedData, context)\n          : undefined,\n    };\n\n    // Catch fallback — only on the leaf path. Container validators override\n    // validate() and don't run this hook on their own outcome, so catching\n    // a whole object/array/record is a no-op in v1.\n    if (result.isValid === false && this.hasCatch) {\n      const fallback =\n        typeof this.catchValue === \"function\"\n          ? await this.catchValue(result.errors, data)\n          : this.catchValue;\n\n      return { isValid: true, errors: [], data: fallback };\n    }\n\n    return result;\n  }\n\n  /**\n   * Set rule attributes list\n   */\n  protected setRuleAttributesList(rule: ContextualSchemaRule) {\n    rule.context.attributesList =\n      typeof this.attributesText[rule.name] === \"object\"\n        ? (this.attributesText[rule.name] as ValidationAttributesList)\n        : this.attributesText;\n  }\n\n  /**\n   * Standard Schema V1 compliance.\n   *\n   * Allows this validator to be used with any Standard Schema-aware library\n   * (OpenAI structured outputs, LangGraph, TanStack Form, Conform, Valibot adapters, etc.)\n   * without extra adapters.\n   *\n   * Delegates to the `validate()` factory so all `configureSeal()` options\n   * (translations, firstErrorOnly) are picked up automatically at call time.\n   *\n   * Includes Standard JSON Schema support via `jsonSchema.input()` / `jsonSchema.output()`.\n   *\n   * ## How Standard Schema libraries consume this\n   *\n   * You pass the **schema object itself** to the library — they internally read\n   * `schema[\"~standard\"]`. Do NOT pass `schema[\"~standard\"]` directly.\n   *\n   * @example\n   * ```ts\n   * const schema = v.object({ name: v.string().required() });\n   *\n   * // TanStack Form — pass schema, library reads [\"~standard\"] internally\n   * const form = useForm({ validators: { onChange: schema } });\n   *\n   * // Conform (Remix) — same pattern\n   * const [form] = useForm({ onValidate({ formData }) {\n   *   return parseWithStandardSchema(formData, { schema });\n   * }});\n   *\n   * // Direct validation (lower level — most apps don't need this)\n   * const result = await schema[\"~standard\"].validate({ name: \"Hasan\" });\n   * // → { value: { name: \"Hasan\" } }  on success\n   * // → { issues: [{ message: \"...\", path: [{ key: \"name\" }] }] }  on failure\n   *\n   * // JSON Schema for OpenAI / LangChain tool calling\n   * const parameters = schema[\"~standard\"].jsonSchema.input({ target: \"openai-strict\" });\n   * // → { type: \"object\", properties: {...}, required: [...], additionalProperties: false }\n   * ```\n   *\n   * @note Cross-field rules (sameAs, requiredIf, requiredWith) rely on sibling values\n   * available in the full validation context. When called on a standalone scalar validator,\n   * sibling data is absent and those rules will not evaluate correctly.\n   * Always call on the parent ObjectValidator for full-payload validation.\n   */\n  get [\"~standard\"](): StandardJSONSchemaV1.Props<TInput, TOutput> {\n    return {\n      version: 1,\n      vendor: \"seal\",\n      types: undefined as unknown as StandardSchemaV1.Types<TInput, TOutput>,\n      validate: async (value: unknown) => {\n        const result = await validate(this, value);\n        return mapToStandardResult(result) as StandardSchemaV1.Result<TOutput>;\n      },\n      jsonSchema: {\n        input: (options) => this.toJsonSchema(options.target),\n        output: (options) => this.toJsonSchema(options.target),\n      },\n    };\n  }\n\n  /**\n   * Generate a JSON Schema representation of this validator.\n   *\n   * Supports targets: `\"draft-2020-12\"` (default), `\"draft-07\"`, `\"openapi-3.0\"`.\n   *\n   * Subclasses override this to describe their specific constraints.\n   * The base implementation returns `{}` (permissive — accepts anything),\n   * which is correct for validators with no representable JSON Schema constraints.\n   *\n   * @note Rules that cannot be expressed in JSON Schema are silently omitted:\n   * - Cross-field rules: sameAs, requiredIf, requiredWith, requiredWithout\n   * - Custom callbacks: refine()\n   * - Framework-specific runtime rules (core/cascade plugins)\n   * These rules still run normally at validation time — only absent from JSON Schema.\n   *\n   * @example\n   * ```ts\n   * v.string().min(3).max(50).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"string\", minLength: 3, maxLength: 50 }\n   *\n   * v.object({ name: v.string().required(), age: v.int().optional() })\n   *   .toJsonSchema(\"draft-07\")\n   * // → { type: \"object\", properties: { name: { type: \"string\" }, age: { type: \"integer\" } }, required: [\"name\"] }\n   * ```\n   */\n  public toJsonSchema(_target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    return {};\n  }\n}\n"],"mappings":"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"}

package/esm/validators/object-validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"object-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/object-validator.ts"],"mappings":";;;;;;;;;;;;AA+BA;;;;;;;;;;;;cAAa,eAAA,iBAAgC,MAAA,GAAS,MAAA,UAAgB,aAAA,CACpE,qBAAA,CAAsB,OAAA,GACtB,sBAAA,CAAuB,OAAA;EAOd,MAAA,EAAQ,OAAA;EAAA,UALP,kBAAA;EAAA,UACA,WAAA;EAAA,UACA,iBAAA;cAGD,MAAA,EAAQ,OAAA,EACf,YAAA;EAyK0B;;;EAhKrB,WAAA,CAAY,KAAA;EAkKU;EA7JtB,YAAA;EAyNqB;EA/MrB,KAAA,IAAS,IAAA;EA+MyD;EAxMlE,IAAA,CAAK,SAAA;EAwMwD;;;EAhM7D,YAAA,CAAa,KAAA;EAuOkB;;;;;;;;;;;;;EApNtB,KAAA,CAAM,IAAA;EApE8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoI7D,MAAA,oBAA0B,MAAA,EAC/B,iBAAA,EAAmB,UAAA,GAAa,eAAA,CAAgB,UAAA,IAC/C,eAAA,CAAgB,OAAA,GAAU,UAAA;EA6ChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAN,KAAA,gBAAqB,MAAA,EAC1B,SAAA,EAAW,eAAA,CAAgB,MAAA,IAC1B,eAAA,CAAgB,OAAA,GAAU,MAAA;EAmJc;;;;;;;;;;;;;;;;;;;;;;;AA+M+C;;;;;EAtSnF,IAAA,iBAAqB,OAAA,KAAY,IAAA,EAAM,CAAA,KAAM,eAAA,CAAgB,IAAA,CAAK,OAAA,EAAS,CAAA;;;;EAoB3E,OAAA,iBAAwB,OAAA,KAAY,IAAA,EAAM,CAAA;;;;EAmB1C,cAAA,iBAA+B,OAAA,KAAY,IAAA,EAAM,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDjD,OAAA,iBAAwB,OAAA,KAAY,IAAA,EAAM,CAAA,KAAM,eAAA,CAAgB,IAAA,CAAK,OAAA,EAAS,CAAA;;EAkB9E,MAAA,CAAO,IAAA,OAAW,OAAA,EAAS,aAAA;;EAMrB,QAAA,CACX,IAAA,OACA,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;;;;;UA8HH,mBAAA;;;;UAOA,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CQ,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"object-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/object-validator.ts"],"mappings":";;;;;;;;;;;;AA6BA;;;;;;;;;;;;cAAa,eAAA,iBAAgC,MAAA,GAAS,MAAA,UAAgB,aAAA,CACpE,qBAAA,CAAsB,OAAA,GACtB,sBAAA,CAAuB,OAAA;EAOd,MAAA,EAAQ,OAAA;EAAA,UALP,kBAAA;EAAA,UACA,WAAA;EAAA,UACA,iBAAA;cAGD,MAAA,EAAQ,OAAA,EACf,YAAA;EAyK0B;;;EAhKrB,WAAA,CAAY,KAAA;EAkKU;EA7JtB,YAAA;EAyNqB;EA/MrB,KAAA,IAAS,IAAA;EA+MyD;EAxMlE,IAAA,CAAK,SAAA;EAwMwD;;;EAhM7D,YAAA,CAAa,KAAA;EAuOkB;;;;;;;;;;;;;EApNtB,KAAA,CAAM,IAAA;EApE8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoI7D,MAAA,oBAA0B,MAAA,EAC/B,iBAAA,EAAmB,UAAA,GAAa,eAAA,CAAgB,UAAA,IAC/C,eAAA,CAAgB,OAAA,GAAU,UAAA;EA6ChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAN,KAAA,gBAAqB,MAAA,EAC1B,SAAA,EAAW,eAAA,CAAgB,MAAA,IAC1B,eAAA,CAAgB,OAAA,GAAU,MAAA;EAmJc;;;;;;;;;;;;;;;;;;;;;;;AA8M+C;;;;;EArSnF,IAAA,iBAAqB,OAAA,KAAY,IAAA,EAAM,CAAA,KAAM,eAAA,CAAgB,IAAA,CAAK,OAAA,EAAS,CAAA;;;;EAoB3E,OAAA,iBAAwB,OAAA,KAAY,IAAA,EAAM,CAAA;;;;EAmB1C,cAAA,iBAA+B,OAAA,KAAY,IAAA,EAAM,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDjD,OAAA,iBAAwB,OAAA,KAAY,IAAA,EAAM,CAAA,KAAM,eAAA,CAAgB,IAAA,CAAK,OAAA,EAAS,CAAA;;EAkB9E,MAAA,CAAO,IAAA,OAAW,OAAA,EAAS,aAAA;;EAMrB,QAAA,CACX,IAAA,OACA,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;;;;;UA6HH,mBAAA;;;;UAOA,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CQ,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/validators/object-validator.mjs

@@ -1,12 +1,9 @@
 import { applyNullable, wrapNullableStrict } from "../standard-schema/json-schema.mjs";
 import { setKeyPath } from "../helpers/path-helpers.mjs";
-import "../helpers/index.mjs";
 import { BaseValidator } from "./base-validator.mjs";
 import { objectTrimMutator, stripUnknownMutator } from "../mutators/object-mutators.mjs";
-import "../mutators/index.mjs";
 import { objectRule } from "../rules/common/type-rules.mjs";
 import { unknownKeyRule } from "../rules/common/unknown-key.mjs";
-import "../rules/index.mjs";
 import { ComputedValidator } from "./computed-validator.mjs";
 import { except } from "@mongez/reinforcements";
 import { isPlainObject } from "@mongez/supportive-is";

package/esm/validators/object-validator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"object-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/object-validator.ts"],"sourcesContent":["import { except } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\nimport { setKeyPath } from \"../helpers\";\nimport { objectTrimMutator, stripUnknownMutator } from \"../mutators\";\nimport { objectRule, unknownKeyRule } from \"../rules\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\nimport { applyNullable, wrapNullableStrict } from \"../standard-schema/json-schema\";\nimport type { Schema, SchemaContext, ValidationResult } from \"../types\";\nimport type {\n  InferInputObjectShape,\n  InferOutputObjectShape,\n} from \"../types/inference-types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { ComputedValidator } from \"./computed-validator\";\n\n/**\n * Object validator class with generic schema type for proper type inference.\n *\n * Threads two distinct inferred shapes into `BaseValidator`'s `TInput`/`TOutput`:\n *\n * - `TInput`  = `InferInputObjectShape<TSchema>`  — what `~standard.validate()`\n *               accepts (caller's pre-validation payload; defaults/catches make\n *               keys optional)\n * - `TOutput` = `InferOutputObjectShape<TSchema>` — what `~standard.validate()`\n *               returns on success (post-default, post-catch shape; guaranteed\n *               keys are required)\n *\n * Both helpers are used directly (not the full `Infer.*` walker) to avoid a\n * recursive class-base evaluation that would otherwise occur when the\n * brand-aware widening tries to inspect the class type.\n */\nexport class ObjectValidator<TSchema extends Schema = Schema> extends BaseValidator<\n  InferInputObjectShape<TSchema>,\n  InferOutputObjectShape<TSchema>\n> {\n  protected shouldAllowUnknown = false;\n  protected allowedKeys: string[] = [];\n  protected hasUnknownKeyRule = false;\n\n  public constructor(\n    public schema: TSchema,\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(objectRule, errorMessage);\n  }\n\n  /**\n   * Check if value is an object type (plain object, not array or date)\n   */\n  public matchesType(value: any): boolean {\n    return isPlainObject(value);\n  }\n\n  /** Strip unknown keys from the data */\n  public stripUnknown() {\n    const validator = this.instance;\n    return validator.addMutator(stripUnknownMutator, {\n      get allowedKeys() {\n        return validator.allowedKeys;\n      },\n    });\n  }\n\n  /** Add list of allowed keys that could be in the data but not necessarily validated */\n  public allow(...keys: string[]) {\n    const validator = this.instance;\n    validator.allowedKeys.push(...keys);\n    return validator;\n  }\n\n  /** Trim values of the object properties */\n  public trim(recursive = true) {\n    const validator = this.instance;\n    return validator.addMutator(objectTrimMutator, { recursive });\n  }\n\n  /** Whether to allow unknown properties\n   * Please note it will allow only unknown direct children keys, not nested children keys\n   */\n  public allowUnknown(allow = true) {\n    const validator = this.instance;\n    validator.shouldAllowUnknown = allow;\n    return validator;\n  }\n\n  /**\n   * Create a copy of this object validator with the same configuration\n   * Copies schema, rules, mutators, transformers, and object-specific settings\n   *\n   * @returns A new ObjectValidator instance with copied configuration\n   *\n   * @example\n   * ```ts\n   * const baseUser = v.object({ name: v.string() }).allowUnknown();\n   * const userCopy = baseUser.clone();\n   * // userCopy has the same schema and allowUnknown setting\n   * ```\n   */\n  public override clone(keys?: string[]): this {\n    // Get cloned instance with all BaseValidator properties\n    const cloned = super.clone();\n\n    // Clone schema with deep copy of validators\n    const newSchema = {} as TSchema;\n    for (const [key, validator] of Object.entries(this.schema)) {\n      if (keys && !keys.includes(key)) continue;\n      (newSchema as Schema)[key] = validator.clone();\n    }\n\n    cloned.schema = newSchema;\n\n    // Add ObjectValidator-specific properties\n    cloned.shouldAllowUnknown = this.shouldAllowUnknown;\n    cloned.allowedKeys = [...this.allowedKeys];\n    // NOTE: hasUnknownKeyRule is intentionally NOT copied.\n    // Each clone must add its own unknownKeyRule on first validate()\n    // so it holds references to its own schema/allowedKeys, not the original's.\n\n    return cloned;\n  }\n\n  /**\n   * Extend this schema with additional fields\n   * Clones the current validator and adds new fields to the schema\n   * **Keeps original configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * If an ObjectValidator is provided, only its schema is used - its configuration is ignored.\n   * This is useful for creating reusable field collections that can be added to different schemas.\n   *\n   * @param schemaOrValidator - Plain schema object or ObjectValidator to extend with\n   * @returns A new ObjectValidator with merged schema and original configuration\n   *\n   * @example\n   * ```ts\n   * // Extend with plain schema\n   * const baseUser = v.object({\n   *   name: v.string().required(),\n   *   email: v.string().email().required()\n   * }).allowUnknown();\n   *\n   * const adminUser = baseUser.extend({\n   *   role: v.string().in(['admin', 'superadmin']).required()\n   * });\n   * // adminUser has: name, email, role\n   * // adminUser keeps: allowUnknown() from base ✅\n   *\n   * // Extend with ObjectValidator (only schema is used)\n   * const auditFields = v.object({\n   *   createdAt: v.date().required(),\n   *   updatedAt: v.date().required()\n   * }).stripUnknown(); // This config is ignored!\n   *\n   * const fullUser = baseUser.extend(auditFields);\n   * // fullUser has: name, email, createdAt, updatedAt\n   * // fullUser keeps: allowUnknown() from base (NOT stripUnknown from auditFields) ✅\n   *\n   * // Chain multiple extends\n   * const complexSchema = baseUser\n   *   .extend(auditFields)\n   *   .extend({ metadata: v.object({}) });\n   * ```\n   */\n  public extend<TExtension extends Schema>(\n    schemaOrValidator: TExtension | ObjectValidator<TExtension>,\n  ): ObjectValidator<TSchema & TExtension> {\n    // Clone current validator to preserve original\n    const extended = this.clone() as any;\n\n    // Extract schema from parameter\n    const schemaToAdd =\n      schemaOrValidator instanceof ObjectValidator ? schemaOrValidator.schema : schemaOrValidator;\n\n    // Merge schemas with cloned validators (later fields override earlier ones)\n    for (const [key, validator] of Object.entries(schemaToAdd)) {\n      (extended.schema as Schema)[key] = validator.clone();\n    }\n\n    return extended as ObjectValidator<TSchema & TExtension>;\n  }\n\n  /**\n   * Merge with another ObjectValidator\n   * Clones current validator, merges schemas, and **overrides configuration** with other validator's config\n   *\n   * Unlike extend(), merge() combines both schemas AND configurations.\n   * The other validator's configuration (allowUnknown, stripUnknown, etc.) takes precedence.\n   *\n   * @param validator - Another ObjectValidator to merge with\n   * @returns A new ObjectValidator with merged schema and configuration\n   *\n   * @example\n   * ```ts\n   * const baseUser = v.object({\n   *   name: v.string().required()\n   * }).allowUnknown();\n   *\n   * const timestamps = v.object({\n   *   createdAt: v.date().required(),\n   *   updatedAt: v.date().required()\n   * }).stripUnknown();\n   *\n   * const merged = baseUser.merge(timestamps);\n   * // merged has: name, createdAt, updatedAt\n   * // merged config: stripUnknown() from timestamps (overrides allowUnknown) ✅\n   *\n   * // Chain multiple merges\n   * const full = baseUser.merge(timestamps).merge(softDeleteSchema);\n   * ```\n   */\n  public merge<TMerge extends Schema>(\n    validator: ObjectValidator<TMerge>,\n  ): ObjectValidator<TSchema & TMerge> {\n    // Clone current validator\n    const merged = this.clone() as any;\n\n    // Merge schemas with cloned validators (later fields override earlier ones)\n    for (const [key, schemaValidator] of Object.entries(validator.schema)) {\n      (merged.schema as Schema)[key] = schemaValidator.clone();\n    }\n\n    // Override configuration with other validator's config\n    merged.shouldAllowUnknown = validator.shouldAllowUnknown;\n    merged.allowedKeys = [...merged.allowedKeys, ...validator.allowedKeys];\n\n    // Append rules, mutators, transformers from other validator\n    merged.rules.push(...validator.rules);\n    merged.mutators.push(...validator.mutators);\n    merged.dataTransformers.push(...validator.dataTransformers);\n\n    // Merge attributes text (later wins)\n    merged.attributesText = {\n      ...merged.attributesText,\n      ...validator.attributesText,\n    };\n\n    merged.translatedAttributes = {\n      ...merged.translatedAttributes,\n      ...validator.translatedAttributes,\n    };\n\n    return merged as ObjectValidator<TSchema & TMerge>;\n  }\n\n  /**\n   * Create a new schema with only the specified fields\n   * Clones the current validator and keeps only the selected fields\n   * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * @param keys - Field names to keep in the schema\n   * @returns A new ObjectValidator with only the picked fields\n   *\n   * @example\n   * ```ts\n   * const fullUser = v.object({\n   *   id: v.int().required(),\n   *   name: v.string().required(),\n   *   email: v.string().email().required(),\n   *   password: v.string().required(),\n   *   role: v.string()\n   * }).allowUnknown();\n   *\n   * // For login - only need email and password\n   * const loginSchema = fullUser.pick('email', 'password');\n   * // loginSchema has: { email, password }\n   * // loginSchema keeps: allowUnknown() ✅\n   *\n   * // For public profile\n   * const publicSchema = fullUser.pick('id', 'name', 'role');\n   * // publicSchema has: { id, name, role }\n   * ```\n   */\n  public pick<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Pick<TSchema, K>> {\n    // Clone current validator\n    const picked = this.clone() as any;\n\n    // Create new schema with only picked keys\n    const newSchema = {} as Pick<TSchema, K>;\n    for (const key of keys) {\n      if (key in picked.schema) {\n        (newSchema as any)[key] = picked.schema[key];\n      }\n    }\n\n    picked.schema = newSchema;\n\n    return picked as ObjectValidator<Pick<TSchema, K>>;\n  }\n\n  /**\n   * Mark all or the given schema fields as optional\n   */\n  public partial<K extends keyof TSchema>(...keys: K[]) {\n    const validationSchema = this.clone();\n\n    if (keys.length === 0) {\n      keys = Object.keys(validationSchema.schema) as K[];\n    }\n\n    for (const [key, validator] of Object.entries(validationSchema.schema)) {\n      if (keys.length === 0 || keys.includes(key as K)) {\n        (validationSchema.schema as Schema)[key] = validator.optional();\n      }\n    }\n\n    return validationSchema;\n  }\n\n  /**\n   * Make the all or the given fields as required\n   */\n  public requiredFields<K extends keyof TSchema>(...keys: K[]) {\n    const validationSchema = this.clone();\n\n    if (keys.length === 0) {\n      keys = Object.keys(validationSchema.schema) as K[];\n    }\n\n    for (const [key, validator] of Object.entries(validationSchema.schema)) {\n      if (keys.length === 0 || keys.includes(key as K)) {\n        (validationSchema.schema as Schema)[key] = validator.required();\n      }\n    }\n\n    return validationSchema;\n  }\n\n  /**\n   * Create a new schema excluding the specified fields\n   * Clones the current validator and removes the specified fields\n   * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * @param keys - Field names to exclude from the schema\n   * @returns A new ObjectValidator without the excluded fields\n   *\n   * @example\n   * ```ts\n   * const fullUser = v.object({\n   *   id: v.int().required(),\n   *   name: v.string().required(),\n   *   email: v.string().email().required(),\n   *   password: v.string().required(),\n   *   role: v.string()\n   * }).allowUnknown();\n   *\n   * // For updates - exclude id\n   * const updateSchema = fullUser.without('id');\n   * // updateSchema has: { name, email, password, role }\n   * // updateSchema keeps: allowUnknown() ✅\n   *\n   * // For public API - exclude sensitive fields\n   * const publicSchema = fullUser.without('password', 'role');\n   * // publicSchema has: { id, name, email }\n   *\n   * // Combine with other methods\n   * const patchSchema = fullUser.without('id', 'password');\n   * // patchSchema has: { name, email, role }\n   * ```\n   */\n  public without<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Omit<TSchema, K>> {\n    // Clone current validator\n    const filtered = this.clone() as any;\n\n    // Create new schema excluding specified keys\n    const newSchema = {} as Omit<TSchema, K>;\n    for (const key in filtered.schema) {\n      if (!keys.includes(key as any)) {\n        (newSchema as any)[key] = filtered.schema[key];\n      }\n    }\n\n    filtered.schema = newSchema;\n\n    return filtered as ObjectValidator<Omit<TSchema, K>>;\n  }\n\n  /** Mutate the data */\n  public mutate(data: any, context: SchemaContext) {\n    if (!isPlainObject(data)) return data;\n    return super.mutate({ ...data }, context);\n  }\n\n  /** Validate the data */\n  public async validate(\n    data: any,\n    context: SchemaContext = { path: \"\" } as SchemaContext,\n  ): Promise<ValidationResult> {\n    context.schema = this.schema;\n    const mutatedData = await this.mutate(data, context);\n\n    // Check for unknown properties\n    if (this.shouldAllowUnknown === false && !this.hasUnknownKeyRule) {\n      this.hasUnknownKeyRule = true;\n      const rule = this.addMutableRule(unknownKeyRule, undefined, {\n        allowedKeys: this.allowedKeys,\n        schema: this.schema,\n      });\n\n      this.setRuleAttributesList(rule);\n    }\n\n    const result = await super.validate(mutatedData, context);\n\n    if (result.isValid === false) return result;\n    if (data === undefined) return result;\n\n    // ═══════════════════════════════════════════════════════════\n    // PHASE 1: Validate user input fields (skip computed/managed)\n    // ═══════════════════════════════════════════════════════════\n    const errors: ValidationResult[\"errors\"] = [];\n    const validatedData: any = {};\n\n    const userInputEntries = Object.entries(this.schema).filter(\n      ([, validator]) => !this.isComputedValidator(validator),\n    );\n\n    const validationPromises = userInputEntries.map(async ([key, validator]) => {\n      const value =\n        mutatedData?.[key] !== undefined ? mutatedData[key] : validator.getDefaultValue();\n\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value,\n        key,\n        path: setKeyPath(context.path, key),\n      };\n\n      const childResult = await validator.validate(value, childContext);\n\n      // Only include in validated data if not omitted\n      if (childResult.data !== undefined && !validator.isOmitted()) {\n        validatedData[key] = childResult.data;\n      }\n\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    // If Phase 1 failed, return early\n    if (errors.length > 0) {\n      return {\n        isValid: false,\n        errors,\n        data: undefined,\n      };\n    }\n\n    // ═══════════════════════════════════════════════════════════\n    // PHASE 2: Execute computed/managed fields with validated data\n    // ═══════════════════════════════════════════════════════════\n    const computedFields = this.getComputedFields();\n\n    const computedPromises = Object.entries(computedFields).map(async ([key, validator]) => {\n\n      const childContext: SchemaContext = {\n        ...context,\n        parent: validatedData,\n        value: undefined, // Computed fields don't have input value\n      };\n\n      // Execute computed callback with validated data\n      const childResult = await validator.validate(validatedData, childContext);\n\n      // Only include in final data if not omitted\n      if (childResult.data !== undefined && !validator.isOmitted()) {\n        validatedData[key] = childResult.data;\n      }\n\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(computedPromises);\n\n    // If Phase 2 failed, return early\n    if (errors.length > 0) {\n      return {\n        isValid: false,\n        errors,\n        data: undefined,\n      };\n    }\n\n    // Remove undefined values\n    const cleanedData = removeUndefinedValues(validatedData);\n\n    const transformedData = await this.startTransformationPipeline(cleanedData, context);\n\n    const output =\n      this.shouldAllowUnknown === false\n        ? transformedData\n        : {\n            ...transformedData,\n            ...except(mutatedData, Object.keys(this.schema)),\n          };\n\n    return {\n      isValid: true,\n      errors: [],\n      data: output,\n    };\n  }\n\n  /**\n   * Check if a validator is a computed or managed field\n   * ManagedValidator extends ComputedValidator, so instanceof catches both\n   */\n  private isComputedValidator(validator: BaseValidator): boolean {\n    return validator instanceof ComputedValidator;\n  }\n\n  /**\n   * Get all computed/managed fields from the schema\n   */\n  private getComputedFields(): Record<string, ComputedValidator> {\n    const computed: Record<string, ComputedValidator> = {};\n\n    for (const [key, validator] of Object.entries(this.schema)) {\n      if (validator instanceof ComputedValidator) {\n        computed[key] = validator;\n      }\n    }\n\n    return computed;\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Recursively generates JSON Schema for all input fields in the schema.\n   * Computed/managed fields are skipped — they have no input representation.\n   *\n   * **Standard targets** (`draft-2020-12`, `draft-07`, `openapi-3.0`):\n   * - Fields marked `.optional()` are excluded from `required`.\n   *\n   * **`openai-strict` target** (OpenAI Structured Outputs):\n   * - ALL fields appear in `required` — OpenAI rejects schemas with optional fields.\n   * - Optional fields are instead expressed as nullable types:\n   *   `{ type: [\"string\", \"null\"] }` so the model can output `null` for them.\n   * - Recursively applies `openai-strict` to all nested objects.\n   *\n   * @example\n   * ```ts\n   * v.object({\n   *   name: v.string().required(),\n   *   age: v.int().optional(),\n   * }).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\",\n   * //     properties: { name: { type: \"string\" }, age: { type: \"integer\" } },\n   * //     required: [\"name\"], additionalProperties: false }\n   *\n   * v.object({\n   *   name: v.string().required(),\n   *   age: v.int().optional(),\n   * }).toJsonSchema(\"openai-strict\")\n   * // → { type: \"object\",\n   * //     properties: { name: { type: \"string\" }, age: { type: [\"integer\", \"null\"] } },\n   * //     required: [\"name\", \"age\"],   ← all fields\n   * //     additionalProperties: false }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const properties: Record<string, JsonSchemaResult> = {};\n    const required: string[] = [];\n    const isOpenAIStrict = target === \"openai-strict\";\n\n    for (const [key, validator] of Object.entries(this.schema)) {\n      // Skip computed/managed — runtime-only, no input schema\n      if (validator instanceof ComputedValidator) continue;\n\n      let fieldSchema = validator.toJsonSchema(target);\n\n      if (isOpenAIStrict) {\n        // OpenAI strict: every field must be in required.\n        // Optional fields are expressed as nullable rather than absent.\n        if (validator.isOptional) {\n          fieldSchema = wrapNullableStrict(fieldSchema);\n        }\n        required.push(key);\n      } else {\n        // Standard JSON Schema: only non-optional fields go in required\n        if (!validator.isOptional) {\n          required.push(key);\n        }\n      }\n\n      properties[key] = fieldSchema;\n    }\n\n    const schema: JsonSchemaResult = { type: \"object\", properties };\n\n    if (required.length > 0) schema.required = required;\n    if (!this.shouldAllowUnknown) schema.additionalProperties = false;\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n\n/** Recursively remove undefined values from an object */\nfunction removeUndefinedValues(obj: any, visited = new WeakMap<object, any>()): any {\n  // Handle primitives and null\n  if (obj === null) {\n    return obj;\n  }\n\n  // Handle arrays\n  if (Array.isArray(obj)) {\n    return obj.map((item) => removeUndefinedValues(item, visited));\n  }\n\n  // Skip non-plain objects (class instances, Dates, Buffers, etc.)\n  if (!isPlainObject(obj)) {\n    return obj;\n  }\n\n  // Handle circular references - return already processed result\n  if (visited.has(obj)) {\n    return visited.get(obj);\n  }\n\n  // Process plain objects\n  const result: any = {};\n  visited.set(obj, result); // Mark as processing BEFORE recursion\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (value !== undefined) {\n      result[key] = removeUndefinedValues(value, visited);\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}
+{"version":3,"file":"object-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/object-validator.ts"],"sourcesContent":["import { except } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\nimport { setKeyPath } from \"../helpers/path-helpers\";\nimport { objectTrimMutator, stripUnknownMutator } from \"../mutators/object-mutators\";\nimport { objectRule } from \"../rules/common/type-rules\";\nimport { unknownKeyRule } from \"../rules/common/unknown-key\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\nimport { applyNullable, wrapNullableStrict } from \"../standard-schema/json-schema\";\nimport type { Schema, SchemaContext, ValidationResult } from \"../types\";\nimport type { InferInputObjectShape, InferOutputObjectShape } from \"../types/inference-types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { ComputedValidator } from \"./computed-validator\";\n\n/**\n * Object validator class with generic schema type for proper type inference.\n *\n * Threads two distinct inferred shapes into `BaseValidator`'s `TInput`/`TOutput`:\n *\n * - `TInput`  = `InferInputObjectShape<TSchema>`  — what `~standard.validate()`\n *               accepts (caller's pre-validation payload; defaults/catches make\n *               keys optional)\n * - `TOutput` = `InferOutputObjectShape<TSchema>` — what `~standard.validate()`\n *               returns on success (post-default, post-catch shape; guaranteed\n *               keys are required)\n *\n * Both helpers are used directly (not the full `Infer.*` walker) to avoid a\n * recursive class-base evaluation that would otherwise occur when the\n * brand-aware widening tries to inspect the class type.\n */\nexport class ObjectValidator<TSchema extends Schema = Schema> extends BaseValidator<\n  InferInputObjectShape<TSchema>,\n  InferOutputObjectShape<TSchema>\n> {\n  protected shouldAllowUnknown = false;\n  protected allowedKeys: string[] = [];\n  protected hasUnknownKeyRule = false;\n\n  public constructor(\n    public schema: TSchema,\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(objectRule, errorMessage);\n  }\n\n  /**\n   * Check if value is an object type (plain object, not array or date)\n   */\n  public matchesType(value: any): boolean {\n    return isPlainObject(value);\n  }\n\n  /** Strip unknown keys from the data */\n  public stripUnknown() {\n    const validator = this.instance;\n    return validator.addMutator(stripUnknownMutator, {\n      get allowedKeys() {\n        return validator.allowedKeys;\n      },\n    });\n  }\n\n  /** Add list of allowed keys that could be in the data but not necessarily validated */\n  public allow(...keys: string[]) {\n    const validator = this.instance;\n    validator.allowedKeys.push(...keys);\n    return validator;\n  }\n\n  /** Trim values of the object properties */\n  public trim(recursive = true) {\n    const validator = this.instance;\n    return validator.addMutator(objectTrimMutator, { recursive });\n  }\n\n  /** Whether to allow unknown properties\n   * Please note it will allow only unknown direct children keys, not nested children keys\n   */\n  public allowUnknown(allow = true) {\n    const validator = this.instance;\n    validator.shouldAllowUnknown = allow;\n    return validator;\n  }\n\n  /**\n   * Create a copy of this object validator with the same configuration\n   * Copies schema, rules, mutators, transformers, and object-specific settings\n   *\n   * @returns A new ObjectValidator instance with copied configuration\n   *\n   * @example\n   * ```ts\n   * const baseUser = v.object({ name: v.string() }).allowUnknown();\n   * const userCopy = baseUser.clone();\n   * // userCopy has the same schema and allowUnknown setting\n   * ```\n   */\n  public override clone(keys?: string[]): this {\n    // Get cloned instance with all BaseValidator properties\n    const cloned = super.clone();\n\n    // Clone schema with deep copy of validators\n    const newSchema = {} as TSchema;\n    for (const [key, validator] of Object.entries(this.schema)) {\n      if (keys && !keys.includes(key)) continue;\n      (newSchema as Schema)[key] = validator.clone();\n    }\n\n    cloned.schema = newSchema;\n\n    // Add ObjectValidator-specific properties\n    cloned.shouldAllowUnknown = this.shouldAllowUnknown;\n    cloned.allowedKeys = [...this.allowedKeys];\n    // NOTE: hasUnknownKeyRule is intentionally NOT copied.\n    // Each clone must add its own unknownKeyRule on first validate()\n    // so it holds references to its own schema/allowedKeys, not the original's.\n\n    return cloned;\n  }\n\n  /**\n   * Extend this schema with additional fields\n   * Clones the current validator and adds new fields to the schema\n   * **Keeps original configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * If an ObjectValidator is provided, only its schema is used - its configuration is ignored.\n   * This is useful for creating reusable field collections that can be added to different schemas.\n   *\n   * @param schemaOrValidator - Plain schema object or ObjectValidator to extend with\n   * @returns A new ObjectValidator with merged schema and original configuration\n   *\n   * @example\n   * ```ts\n   * // Extend with plain schema\n   * const baseUser = v.object({\n   *   name: v.string().required(),\n   *   email: v.string().email().required()\n   * }).allowUnknown();\n   *\n   * const adminUser = baseUser.extend({\n   *   role: v.string().in(['admin', 'superadmin']).required()\n   * });\n   * // adminUser has: name, email, role\n   * // adminUser keeps: allowUnknown() from base ✅\n   *\n   * // Extend with ObjectValidator (only schema is used)\n   * const auditFields = v.object({\n   *   createdAt: v.date().required(),\n   *   updatedAt: v.date().required()\n   * }).stripUnknown(); // This config is ignored!\n   *\n   * const fullUser = baseUser.extend(auditFields);\n   * // fullUser has: name, email, createdAt, updatedAt\n   * // fullUser keeps: allowUnknown() from base (NOT stripUnknown from auditFields) ✅\n   *\n   * // Chain multiple extends\n   * const complexSchema = baseUser\n   *   .extend(auditFields)\n   *   .extend({ metadata: v.object({}) });\n   * ```\n   */\n  public extend<TExtension extends Schema>(\n    schemaOrValidator: TExtension | ObjectValidator<TExtension>,\n  ): ObjectValidator<TSchema & TExtension> {\n    // Clone current validator to preserve original\n    const extended = this.clone() as any;\n\n    // Extract schema from parameter\n    const schemaToAdd =\n      schemaOrValidator instanceof ObjectValidator ? schemaOrValidator.schema : schemaOrValidator;\n\n    // Merge schemas with cloned validators (later fields override earlier ones)\n    for (const [key, validator] of Object.entries(schemaToAdd)) {\n      (extended.schema as Schema)[key] = validator.clone();\n    }\n\n    return extended as ObjectValidator<TSchema & TExtension>;\n  }\n\n  /**\n   * Merge with another ObjectValidator\n   * Clones current validator, merges schemas, and **overrides configuration** with other validator's config\n   *\n   * Unlike extend(), merge() combines both schemas AND configurations.\n   * The other validator's configuration (allowUnknown, stripUnknown, etc.) takes precedence.\n   *\n   * @param validator - Another ObjectValidator to merge with\n   * @returns A new ObjectValidator with merged schema and configuration\n   *\n   * @example\n   * ```ts\n   * const baseUser = v.object({\n   *   name: v.string().required()\n   * }).allowUnknown();\n   *\n   * const timestamps = v.object({\n   *   createdAt: v.date().required(),\n   *   updatedAt: v.date().required()\n   * }).stripUnknown();\n   *\n   * const merged = baseUser.merge(timestamps);\n   * // merged has: name, createdAt, updatedAt\n   * // merged config: stripUnknown() from timestamps (overrides allowUnknown) ✅\n   *\n   * // Chain multiple merges\n   * const full = baseUser.merge(timestamps).merge(softDeleteSchema);\n   * ```\n   */\n  public merge<TMerge extends Schema>(\n    validator: ObjectValidator<TMerge>,\n  ): ObjectValidator<TSchema & TMerge> {\n    // Clone current validator\n    const merged = this.clone() as any;\n\n    // Merge schemas with cloned validators (later fields override earlier ones)\n    for (const [key, schemaValidator] of Object.entries(validator.schema)) {\n      (merged.schema as Schema)[key] = schemaValidator.clone();\n    }\n\n    // Override configuration with other validator's config\n    merged.shouldAllowUnknown = validator.shouldAllowUnknown;\n    merged.allowedKeys = [...merged.allowedKeys, ...validator.allowedKeys];\n\n    // Append rules, mutators, transformers from other validator\n    merged.rules.push(...validator.rules);\n    merged.mutators.push(...validator.mutators);\n    merged.dataTransformers.push(...validator.dataTransformers);\n\n    // Merge attributes text (later wins)\n    merged.attributesText = {\n      ...merged.attributesText,\n      ...validator.attributesText,\n    };\n\n    merged.translatedAttributes = {\n      ...merged.translatedAttributes,\n      ...validator.translatedAttributes,\n    };\n\n    return merged as ObjectValidator<TSchema & TMerge>;\n  }\n\n  /**\n   * Create a new schema with only the specified fields\n   * Clones the current validator and keeps only the selected fields\n   * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * @param keys - Field names to keep in the schema\n   * @returns A new ObjectValidator with only the picked fields\n   *\n   * @example\n   * ```ts\n   * const fullUser = v.object({\n   *   id: v.int().required(),\n   *   name: v.string().required(),\n   *   email: v.string().email().required(),\n   *   password: v.string().required(),\n   *   role: v.string()\n   * }).allowUnknown();\n   *\n   * // For login - only need email and password\n   * const loginSchema = fullUser.pick('email', 'password');\n   * // loginSchema has: { email, password }\n   * // loginSchema keeps: allowUnknown() ✅\n   *\n   * // For public profile\n   * const publicSchema = fullUser.pick('id', 'name', 'role');\n   * // publicSchema has: { id, name, role }\n   * ```\n   */\n  public pick<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Pick<TSchema, K>> {\n    // Clone current validator\n    const picked = this.clone() as any;\n\n    // Create new schema with only picked keys\n    const newSchema = {} as Pick<TSchema, K>;\n    for (const key of keys) {\n      if (key in picked.schema) {\n        (newSchema as any)[key] = picked.schema[key];\n      }\n    }\n\n    picked.schema = newSchema;\n\n    return picked as ObjectValidator<Pick<TSchema, K>>;\n  }\n\n  /**\n   * Mark all or the given schema fields as optional\n   */\n  public partial<K extends keyof TSchema>(...keys: K[]) {\n    const validationSchema = this.clone();\n\n    if (keys.length === 0) {\n      keys = Object.keys(validationSchema.schema) as K[];\n    }\n\n    for (const [key, validator] of Object.entries(validationSchema.schema)) {\n      if (keys.length === 0 || keys.includes(key as K)) {\n        (validationSchema.schema as Schema)[key] = validator.optional();\n      }\n    }\n\n    return validationSchema;\n  }\n\n  /**\n   * Make the all or the given fields as required\n   */\n  public requiredFields<K extends keyof TSchema>(...keys: K[]) {\n    const validationSchema = this.clone();\n\n    if (keys.length === 0) {\n      keys = Object.keys(validationSchema.schema) as K[];\n    }\n\n    for (const [key, validator] of Object.entries(validationSchema.schema)) {\n      if (keys.length === 0 || keys.includes(key as K)) {\n        (validationSchema.schema as Schema)[key] = validator.required();\n      }\n    }\n\n    return validationSchema;\n  }\n\n  /**\n   * Create a new schema excluding the specified fields\n   * Clones the current validator and removes the specified fields\n   * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * @param keys - Field names to exclude from the schema\n   * @returns A new ObjectValidator without the excluded fields\n   *\n   * @example\n   * ```ts\n   * const fullUser = v.object({\n   *   id: v.int().required(),\n   *   name: v.string().required(),\n   *   email: v.string().email().required(),\n   *   password: v.string().required(),\n   *   role: v.string()\n   * }).allowUnknown();\n   *\n   * // For updates - exclude id\n   * const updateSchema = fullUser.without('id');\n   * // updateSchema has: { name, email, password, role }\n   * // updateSchema keeps: allowUnknown() ✅\n   *\n   * // For public API - exclude sensitive fields\n   * const publicSchema = fullUser.without('password', 'role');\n   * // publicSchema has: { id, name, email }\n   *\n   * // Combine with other methods\n   * const patchSchema = fullUser.without('id', 'password');\n   * // patchSchema has: { name, email, role }\n   * ```\n   */\n  public without<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Omit<TSchema, K>> {\n    // Clone current validator\n    const filtered = this.clone() as any;\n\n    // Create new schema excluding specified keys\n    const newSchema = {} as Omit<TSchema, K>;\n    for (const key in filtered.schema) {\n      if (!keys.includes(key as any)) {\n        (newSchema as any)[key] = filtered.schema[key];\n      }\n    }\n\n    filtered.schema = newSchema;\n\n    return filtered as ObjectValidator<Omit<TSchema, K>>;\n  }\n\n  /** Mutate the data */\n  public mutate(data: any, context: SchemaContext) {\n    if (!isPlainObject(data)) return data;\n    return super.mutate({ ...data }, context);\n  }\n\n  /** Validate the data */\n  public async validate(\n    data: any,\n    context: SchemaContext = { path: \"\" } as SchemaContext,\n  ): Promise<ValidationResult> {\n    context.schema = this.schema;\n    const mutatedData = await this.mutate(data, context);\n\n    // Check for unknown properties\n    if (this.shouldAllowUnknown === false && !this.hasUnknownKeyRule) {\n      this.hasUnknownKeyRule = true;\n      const rule = this.addMutableRule(unknownKeyRule, undefined, {\n        allowedKeys: this.allowedKeys,\n        schema: this.schema,\n      });\n\n      this.setRuleAttributesList(rule);\n    }\n\n    const result = await super.validate(mutatedData, context);\n\n    if (result.isValid === false) return result;\n    if (data === undefined) return result;\n\n    // ═══════════════════════════════════════════════════════════\n    // PHASE 1: Validate user input fields (skip computed/managed)\n    // ═══════════════════════════════════════════════════════════\n    const errors: ValidationResult[\"errors\"] = [];\n    const validatedData: any = {};\n\n    const userInputEntries = Object.entries(this.schema).filter(\n      ([, validator]) => !this.isComputedValidator(validator),\n    );\n\n    const validationPromises = userInputEntries.map(async ([key, validator]) => {\n      const value =\n        mutatedData?.[key] !== undefined ? mutatedData[key] : validator.getDefaultValue();\n\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value,\n        key,\n        path: setKeyPath(context.path, key),\n      };\n\n      const childResult = await validator.validate(value, childContext);\n\n      // Only include in validated data if not omitted\n      if (childResult.data !== undefined && !validator.isOmitted()) {\n        validatedData[key] = childResult.data;\n      }\n\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    // If Phase 1 failed, return early\n    if (errors.length > 0) {\n      return {\n        isValid: false,\n        errors,\n        data: undefined,\n      };\n    }\n\n    // ═══════════════════════════════════════════════════════════\n    // PHASE 2: Execute computed/managed fields with validated data\n    // ═══════════════════════════════════════════════════════════\n    const computedFields = this.getComputedFields();\n\n    const computedPromises = Object.entries(computedFields).map(async ([key, validator]) => {\n      const childContext: SchemaContext = {\n        ...context,\n        parent: validatedData,\n        value: undefined, // Computed fields don't have input value\n      };\n\n      // Execute computed callback with validated data\n      const childResult = await validator.validate(validatedData, childContext);\n\n      // Only include in final data if not omitted\n      if (childResult.data !== undefined && !validator.isOmitted()) {\n        validatedData[key] = childResult.data;\n      }\n\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(computedPromises);\n\n    // If Phase 2 failed, return early\n    if (errors.length > 0) {\n      return {\n        isValid: false,\n        errors,\n        data: undefined,\n      };\n    }\n\n    // Remove undefined values\n    const cleanedData = removeUndefinedValues(validatedData);\n\n    const transformedData = await this.startTransformationPipeline(cleanedData, context);\n\n    const output =\n      this.shouldAllowUnknown === false\n        ? transformedData\n        : {\n            ...transformedData,\n            ...except(mutatedData, Object.keys(this.schema)),\n          };\n\n    return {\n      isValid: true,\n      errors: [],\n      data: output,\n    };\n  }\n\n  /**\n   * Check if a validator is a computed or managed field\n   * ManagedValidator extends ComputedValidator, so instanceof catches both\n   */\n  private isComputedValidator(validator: BaseValidator): boolean {\n    return validator instanceof ComputedValidator;\n  }\n\n  /**\n   * Get all computed/managed fields from the schema\n   */\n  private getComputedFields(): Record<string, ComputedValidator> {\n    const computed: Record<string, ComputedValidator> = {};\n\n    for (const [key, validator] of Object.entries(this.schema)) {\n      if (validator instanceof ComputedValidator) {\n        computed[key] = validator;\n      }\n    }\n\n    return computed;\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Recursively generates JSON Schema for all input fields in the schema.\n   * Computed/managed fields are skipped — they have no input representation.\n   *\n   * **Standard targets** (`draft-2020-12`, `draft-07`, `openapi-3.0`):\n   * - Fields marked `.optional()` are excluded from `required`.\n   *\n   * **`openai-strict` target** (OpenAI Structured Outputs):\n   * - ALL fields appear in `required` — OpenAI rejects schemas with optional fields.\n   * - Optional fields are instead expressed as nullable types:\n   *   `{ type: [\"string\", \"null\"] }` so the model can output `null` for them.\n   * - Recursively applies `openai-strict` to all nested objects.\n   *\n   * @example\n   * ```ts\n   * v.object({\n   *   name: v.string().required(),\n   *   age: v.int().optional(),\n   * }).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\",\n   * //     properties: { name: { type: \"string\" }, age: { type: \"integer\" } },\n   * //     required: [\"name\"], additionalProperties: false }\n   *\n   * v.object({\n   *   name: v.string().required(),\n   *   age: v.int().optional(),\n   * }).toJsonSchema(\"openai-strict\")\n   * // → { type: \"object\",\n   * //     properties: { name: { type: \"string\" }, age: { type: [\"integer\", \"null\"] } },\n   * //     required: [\"name\", \"age\"],   ← all fields\n   * //     additionalProperties: false }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const properties: Record<string, JsonSchemaResult> = {};\n    const required: string[] = [];\n    const isOpenAIStrict = target === \"openai-strict\";\n\n    for (const [key, validator] of Object.entries(this.schema)) {\n      // Skip computed/managed — runtime-only, no input schema\n      if (validator instanceof ComputedValidator) continue;\n\n      let fieldSchema = validator.toJsonSchema(target);\n\n      if (isOpenAIStrict) {\n        // OpenAI strict: every field must be in required.\n        // Optional fields are expressed as nullable rather than absent.\n        if (validator.isOptional) {\n          fieldSchema = wrapNullableStrict(fieldSchema);\n        }\n        required.push(key);\n      } else {\n        // Standard JSON Schema: only non-optional fields go in required\n        if (!validator.isOptional) {\n          required.push(key);\n        }\n      }\n\n      properties[key] = fieldSchema;\n    }\n\n    const schema: JsonSchemaResult = { type: \"object\", properties };\n\n    if (required.length > 0) schema.required = required;\n    if (!this.shouldAllowUnknown) schema.additionalProperties = false;\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n\n/** Recursively remove undefined values from an object */\nfunction removeUndefinedValues(obj: any, visited = new WeakMap<object, any>()): any {\n  // Handle primitives and null\n  if (obj === null) {\n    return obj;\n  }\n\n  // Handle arrays\n  if (Array.isArray(obj)) {\n    return obj.map((item) => removeUndefinedValues(item, visited));\n  }\n\n  // Skip non-plain objects (class instances, Dates, Buffers, etc.)\n  if (!isPlainObject(obj)) {\n    return obj;\n  }\n\n  // Handle circular references - return already processed result\n  if (visited.has(obj)) {\n    return visited.get(obj);\n  }\n\n  // Process plain objects\n  const result: any = {};\n  visited.set(obj, result); // Mark as processing BEFORE recursion\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (value !== undefined) {\n      result[key] = removeUndefinedValues(value, visited);\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/esm/validators/primitive-validator.mjs

@@ -1,6 +1,5 @@
 import { BaseValidator } from "./base-validator.mjs";
 import { allowedValuesRule, enumRule, inRule, notAllowedValuesRule } from "../rules/common/enum.mjs";
-import "../rules/index.mjs";
 
 //#region ../seal/src/validators/primitive-validator.ts
 /**

package/esm/validators/primitive-validator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"primitive-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/primitive-validator.ts"],"sourcesContent":["import { allowedValuesRule, enumRule, inRule, notAllowedValuesRule } from \"../rules\";\nimport { BaseValidator } from \"./base-validator\";\n\n/**\n * Abstract base validator for primitive-typed fields (string, number, boolean).\n *\n * Provides value-membership rules that are meaningful for any single primitive value\n * but not for complex structures (object, array).\n *\n * Do NOT expose this on the `v` factory — it is an inheritance-only base class.\n *\n * Hierarchy:\n *   BaseValidator\n *     └── PrimitiveValidator    ← enum, in, oneOf, allowsOnly, forbids, notIn\n *           ├── StringValidator\n *           ├── NumberValidator\n *           │     └── FloatValidator\n *           ├── BooleanValidator\n *           └── ScalarValidator  (extends PrimitiveValidator, adds asNumber/asString/accepted/declined)\n *\n * @example\n * class MyValidator extends PrimitiveValidator {\n *   // inherits: in(), forbids(), enum(), oneOf(), allowsOnly(), notIn()\n * }\n */\nexport abstract class PrimitiveValidator extends BaseValidator {\n  /**\n   * Value must be one of the enum's values\n   *\n   * @example\n   * v.string().enum(Direction) // Direction is a TS enum\n   */\n  public enum(values: any, errorMessage?: string) {\n    return this.addRule(enumRule, errorMessage, { enum: Object.values(values) });\n  }\n\n  /**\n   * Value must be one of the given values\n   *\n   * @example\n   * v.string().in([\"admin\", \"user\", \"guest\"])\n   * v.number().in([1, 2, 3])\n   */\n  public in(values: any[], errorMessage?: string) {\n    return this.addRule(inRule, errorMessage, { values });\n  }\n\n  /**\n   * Alias for `in()`\n   *\n   * @example\n   * v.string().oneOf([\"active\", \"inactive\"])\n   */\n  public oneOf(values: any[], errorMessage?: string) {\n    return this.in(values, errorMessage);\n  }\n\n  /**\n   * Value must be one of the allowed values (stricter variant)\n   *\n   * @example\n   * v.string().allowsOnly([\"yes\", \"no\"])\n   */\n  public allowsOnly(values: any[], errorMessage?: string) {\n    return this.addRule(allowedValuesRule, errorMessage, { allowedValues: values });\n  }\n\n  /**\n   * Value must NOT be one of the given values\n   *\n   * @example\n   * v.string().forbids([\"banned\", \"blacklisted\"])\n   * v.number().forbids([0, -1])\n   */\n  public forbids(values: any[], errorMessage?: string) {\n    return this.addRule(notAllowedValuesRule, errorMessage, { notAllowedValues: values });\n  }\n\n  /**\n   * Alias for `forbids()`\n   *\n   * @example\n   * v.string().notIn([\"OK\", \"NOT OK\"])\n   */\n  public notIn(values: any[], errorMessage?: string) {\n    return this.forbids(values, errorMessage);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAsB,qBAAtB,cAAiD,cAAc;;;;;;;CAO7D,AAAO,KAAK,QAAa,cAAuB;EAC9C,OAAO,KAAK,QAAQ,UAAU,cAAc,EAAE,MAAM,OAAO,OAAO,MAAM,EAAE,CAAC;CAC7E;;;;;;;;CASA,AAAO,GAAG,QAAe,cAAuB;EAC9C,OAAO,KAAK,QAAQ,QAAQ,cAAc,EAAE,OAAO,CAAC;CACtD;;;;;;;CAQA,AAAO,MAAM,QAAe,cAAuB;EACjD,OAAO,KAAK,GAAG,QAAQ,YAAY;CACrC;;;;;;;CAQA,AAAO,WAAW,QAAe,cAAuB;EACtD,OAAO,KAAK,QAAQ,mBAAmB,cAAc,EAAE,eAAe,OAAO,CAAC;CAChF;;;;;;;;CASA,AAAO,QAAQ,QAAe,cAAuB;EACnD,OAAO,KAAK,QAAQ,sBAAsB,cAAc,EAAE,kBAAkB,OAAO,CAAC;CACtF;;;;;;;CAQA,AAAO,MAAM,QAAe,cAAuB;EACjD,OAAO,KAAK,QAAQ,QAAQ,YAAY;CAC1C;AACF"}
+{"version":3,"file":"primitive-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/primitive-validator.ts"],"sourcesContent":["import { allowedValuesRule, enumRule, inRule, notAllowedValuesRule } from \"../rules/common/enum\";\nimport { BaseValidator } from \"./base-validator\";\n\n/**\n * Abstract base validator for primitive-typed fields (string, number, boolean).\n *\n * Provides value-membership rules that are meaningful for any single primitive value\n * but not for complex structures (object, array).\n *\n * Do NOT expose this on the `v` factory — it is an inheritance-only base class.\n *\n * Hierarchy:\n *   BaseValidator\n *     └── PrimitiveValidator    ← enum, in, oneOf, allowsOnly, forbids, notIn\n *           ├── StringValidator\n *           ├── NumberValidator\n *           │     └── FloatValidator\n *           ├── BooleanValidator\n *           └── ScalarValidator  (extends PrimitiveValidator, adds asNumber/asString/accepted/declined)\n *\n * @example\n * class MyValidator extends PrimitiveValidator {\n *   // inherits: in(), forbids(), enum(), oneOf(), allowsOnly(), notIn()\n * }\n */\nexport abstract class PrimitiveValidator extends BaseValidator {\n  /**\n   * Value must be one of the enum's values\n   *\n   * @example\n   * v.string().enum(Direction) // Direction is a TS enum\n   */\n  public enum(values: any, errorMessage?: string) {\n    return this.addRule(enumRule, errorMessage, { enum: Object.values(values) });\n  }\n\n  /**\n   * Value must be one of the given values\n   *\n   * @example\n   * v.string().in([\"admin\", \"user\", \"guest\"])\n   * v.number().in([1, 2, 3])\n   */\n  public in(values: any[], errorMessage?: string) {\n    return this.addRule(inRule, errorMessage, { values });\n  }\n\n  /**\n   * Alias for `in()`\n   *\n   * @example\n   * v.string().oneOf([\"active\", \"inactive\"])\n   */\n  public oneOf(values: any[], errorMessage?: string) {\n    return this.in(values, errorMessage);\n  }\n\n  /**\n   * Value must be one of the allowed values (stricter variant)\n   *\n   * @example\n   * v.string().allowsOnly([\"yes\", \"no\"])\n   */\n  public allowsOnly(values: any[], errorMessage?: string) {\n    return this.addRule(allowedValuesRule, errorMessage, { allowedValues: values });\n  }\n\n  /**\n   * Value must NOT be one of the given values\n   *\n   * @example\n   * v.string().forbids([\"banned\", \"blacklisted\"])\n   * v.number().forbids([0, -1])\n   */\n  public forbids(values: any[], errorMessage?: string) {\n    return this.addRule(notAllowedValuesRule, errorMessage, { notAllowedValues: values });\n  }\n\n  /**\n   * Alias for `forbids()`\n   *\n   * @example\n   * v.string().notIn([\"OK\", \"NOT OK\"])\n   */\n  public notIn(values: any[], errorMessage?: string) {\n    return this.forbids(values, errorMessage);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAsB,qBAAtB,cAAiD,cAAc;;;;;;;CAO7D,AAAO,KAAK,QAAa,cAAuB;EAC9C,OAAO,KAAK,QAAQ,UAAU,cAAc,EAAE,MAAM,OAAO,OAAO,MAAM,EAAE,CAAC;CAC7E;;;;;;;;CASA,AAAO,GAAG,QAAe,cAAuB;EAC9C,OAAO,KAAK,QAAQ,QAAQ,cAAc,EAAE,OAAO,CAAC;CACtD;;;;;;;CAQA,AAAO,MAAM,QAAe,cAAuB;EACjD,OAAO,KAAK,GAAG,QAAQ,YAAY;CACrC;;;;;;;CAQA,AAAO,WAAW,QAAe,cAAuB;EACtD,OAAO,KAAK,QAAQ,mBAAmB,cAAc,EAAE,eAAe,OAAO,CAAC;CAChF;;;;;;;;CASA,AAAO,QAAQ,QAAe,cAAuB;EACnD,OAAO,KAAK,QAAQ,sBAAsB,cAAc,EAAE,kBAAkB,OAAO,CAAC;CACtF;;;;;;;CAQA,AAAO,MAAM,QAAe,cAAuB;EACjD,OAAO,KAAK,QAAQ,QAAQ,YAAY;CAC1C;AACF"}

package/esm/validators/string-validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"string-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"mappings":"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"}
+{"version":3,"file":"string-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"mappings":"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"}

package/esm/validators/string-validator.mjs

@@ -1,6 +1,5 @@
 import { applyNullable, getRuleOptions } from "../standard-schema/json-schema.mjs";
 import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "../mutators/string-mutators.mjs";
-import "../mutators/index.mjs";
 import { alphaNumericRule, alphaRule, isNumericRule } from "../rules/string/alpha.mjs";
 import { isCreditCardRule } from "../rules/string/credit-card.mjs";
 import { emailRule } from "../rules/string/email.mjs";
@@ -12,9 +11,10 @@ import { strongPasswordRule } from "../rules/string/strong-password-rule.mjs";
 import { urlRule } from "../rules/string/url.mjs";
 import { withoutWhitespaceRule } from "../rules/string/without-whitespace.mjs";
 import { betweenLengthRule, lengthRule, maxLengthRule, maxWordsRule, minLengthRule, minWordsRule, wordsRule } from "../rules/length/length-rules.mjs";
+import "../rules/length/index.mjs";
 import { colorRule, darkColorRule, hexColorRule, hslColorRule, lightColorRule, rgbColorRule, rgbaColorRule } from "../rules/color/color-rules.mjs";
+import "../rules/color/index.mjs";
 import { stringRule } from "../rules/common/type-rules.mjs";
-import "../rules/index.mjs";
 import { PrimitiveValidator } from "./primitive-validator.mjs";
 
 //#region ../seal/src/validators/string-validator.ts

package/esm/validators/string-validator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"string-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"sourcesContent":["import {\r\n  alphaOnlyMutator,\r\n  alphanumericOnlyMutator,\r\n  appendMutator,\r\n  base64DecodeMutator,\r\n  base64EncodeMutator,\r\n  camelCaseMutator,\r\n  capitalizeMutator,\r\n  htmlEscapeMutator,\r\n  kebabCaseMutator,\r\n  lowercaseMutator,\r\n  ltrimMutator,\r\n  maskMutator,\r\n  padEndMutator,\r\n  padStartMutator,\r\n  pascalCaseMutator,\r\n  prependMutator,\r\n  removeNumbersMutator,\r\n  removeSpecialCharactersMutator,\r\n  repeatMutator,\r\n  replaceAllMutator,\r\n  replaceMutator,\r\n  reverseMutator,\r\n  rtrimMutator,\r\n  slugMutator,\r\n  snakeCaseMutator,\r\n  stringifyMutator,\r\n  stripTagsMutator,\r\n  titleCaseMutator,\r\n  trimMultipleWhitespaceMutator,\r\n  trimMutator,\r\n  truncateMutator,\r\n  unescapeHtmlMutator,\r\n  uppercaseMutator,\r\n  urlDecodeMutator,\r\n  urlEncodeMutator,\r\n} from \"../mutators\";\r\nimport {\r\n  alphaNumericRule,\r\n  alphaRule,\r\n  betweenLengthRule,\r\n  colorRule,\r\n  containsRule,\r\n  cuidRule,\r\n  darkColorRule,\r\n  emailRule,\r\n  endsWithRule,\r\n  hexColorRule,\r\n  hslColorRule,\r\n  ip4Rule,\r\n  ip6Rule,\r\n  ipRule,\r\n  isCreditCardRule,\r\n  isNumericRule,\r\n  lengthRule,\r\n  lightColorRule,\r\n  maxLengthRule,\r\n  maxWordsRule,\r\n  minLengthRule,\r\n  minWordsRule,\r\n  nanoidRule,\r\n  notContainsRule,\r\n  patternRule,\r\n  rgbColorRule,\r\n  rgbaColorRule,\r\n  startsWithRule,\r\n  stringRule,\r\n  strongPasswordRule,\r\n  ulidRule,\r\n  urlRule,\r\n  uuidRule,\r\n  withoutWhitespaceRule,\r\n  wordsRule,\r\n  type UUIDVersion,\r\n} from \"../rules\";\r\nimport { PrimitiveValidator } from \"./primitive-validator\";\r\nimport { applyNullable, getRuleOptions } from \"../standard-schema/json-schema\";\r\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\r\n\r\n/**\r\n * String validator class\r\n */\r\nexport class StringValidator extends PrimitiveValidator {\r\n  public constructor(errorMessage?: string) {\r\n    super();\r\n    this.addMutableRule(stringRule, errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Check if value is a string type\r\n   */\r\n  public matchesType(value: any): boolean {\r\n    return typeof value === \"string\";\r\n  }\r\n\r\n  // ==================== Mutators ====================\r\n\r\n  /**\r\n   * Stringify the value if not a string\r\n   */\r\n  public toString() {\r\n    return this.addMutator(stringifyMutator);\r\n  }\r\n\r\n  /** Convert string to uppercase */\r\n  public uppercase() {\r\n    return this.addMutator(uppercaseMutator);\r\n  }\r\n\r\n  /** Convert string to lowercase */\r\n  public lowercase() {\r\n    return this.addMutator(lowercaseMutator);\r\n  }\r\n\r\n  /** Capitalize only the first letter of the string */\r\n  public capitalize() {\r\n    return this.addMutator(capitalizeMutator);\r\n  }\r\n\r\n  /** Capitalize the first letter of each word (Title Case) */\r\n  public titleCase() {\r\n    return this.addMutator(titleCaseMutator);\r\n  }\r\n\r\n  /** Convert to camelCase */\r\n  public camelCase() {\r\n    return this.addMutator(camelCaseMutator);\r\n  }\r\n\r\n  /** Convert to PascalCase */\r\n  public pascalCase() {\r\n    return this.addMutator(pascalCaseMutator);\r\n  }\r\n\r\n  /** Convert to snake_case */\r\n  public snakeCase() {\r\n    return this.addMutator(snakeCaseMutator);\r\n  }\r\n\r\n  /** Convert to kebab-case */\r\n  public kebabCase() {\r\n    return this.addMutator(kebabCaseMutator);\r\n  }\r\n\r\n  /**\r\n   * Trim the given needle from the string\r\n   * If no needle is provided, the default is a single space\r\n   */\r\n  public trim(needle?: string) {\r\n    return this.addMutator(trimMutator, { needle });\r\n  }\r\n\r\n  /** Trim from the left/start */\r\n  public ltrim(needle?: string) {\r\n    return this.addMutator(ltrimMutator, { needle });\r\n  }\r\n\r\n  /** Trim from the right/end */\r\n  public rtrim(needle?: string) {\r\n    return this.addMutator(rtrimMutator, { needle });\r\n  }\r\n\r\n  /** Trim multiple whitespace into single space */\r\n  public trimMultipleWhitespace() {\r\n    return this.addMutator(trimMultipleWhitespaceMutator);\r\n  }\r\n\r\n  /** Pad string from the start to reach target length */\r\n  public padStart(length: number, char = \" \") {\r\n    return this.addMutator(padStartMutator, { length, char });\r\n  }\r\n\r\n  /** Pad string from the end to reach target length */\r\n  public padEnd(length: number, char = \" \") {\r\n    return this.addMutator(padEndMutator, { length, char });\r\n  }\r\n\r\n  /**\r\n   * Strip HTML tags with a naive `<...>` regex.\r\n   *\r\n   * This is a **tag stripper, not an XSS sanitizer**: it is not a parser,\r\n   * so malformed/nested markup or content re-introduced later in a\r\n   * pipeline can defeat it. Do not rely on this alone to make untrusted\r\n   * rich text safe to render — use a real parser-based sanitizer (e.g.\r\n   * DOMPurify / sanitize-html) for that.\r\n   */\r\n  public stripTags() {\r\n    return this.addMutator(stripTagsMutator);\r\n  }\r\n\r\n  /**\r\n   * @deprecated Renamed to {@link StringValidator.stripTags} — the old\r\n   * name implied XSS safety this tag-stripping regex does not provide.\r\n   * Kept as an alias for backward compatibility; switch to `.stripTags()`.\r\n   */\r\n  public safeHtml() {\r\n    return this.stripTags();\r\n  }\r\n\r\n  /** HTML escape special characters */\r\n  public htmlEscape() {\r\n    return this.addMutator(htmlEscapeMutator);\r\n  }\r\n\r\n  /** Unescape HTML entities */\r\n  public unescapeHtml() {\r\n    return this.addMutator(unescapeHtmlMutator);\r\n  }\r\n\r\n  /**\r\n   * Remove special characters\r\n   * This will remove all characters that are not alphanumeric or whitespace\r\n   */\r\n  public removeSpecialCharacters() {\r\n    return this.addMutator(removeSpecialCharactersMutator);\r\n  }\r\n\r\n  /** Convert to only alphabetic characters */\r\n  public toAlpha() {\r\n    return this.addMutator(alphaOnlyMutator);\r\n  }\r\n\r\n  /** Convert to only alphanumeric characters */\r\n  public toAlphanumeric() {\r\n    return this.addMutator(alphanumericOnlyMutator);\r\n  }\r\n\r\n  /** Remove all numeric characters */\r\n  public removeNumbers() {\r\n    return this.addMutator(removeNumbersMutator);\r\n  }\r\n\r\n  /** URL decode */\r\n  public urlDecode() {\r\n    return this.addMutator(urlDecodeMutator);\r\n  }\r\n\r\n  /** URL encode */\r\n  public urlEncode() {\r\n    return this.addMutator(urlEncodeMutator);\r\n  }\r\n\r\n  /** Convert to URL-friendly slug */\r\n  public slug() {\r\n    return this.addMutator(slugMutator);\r\n  }\r\n\r\n  /** Base64 encode */\r\n  public base64Encode() {\r\n    return this.addMutator(base64EncodeMutator);\r\n  }\r\n\r\n  /** Base64 decode */\r\n  public base64Decode() {\r\n    return this.addMutator(base64DecodeMutator);\r\n  }\r\n\r\n  /** Replace substring or pattern */\r\n  public replace(search: string | RegExp, replace: string) {\r\n    return this.addMutator(replaceMutator, { search, replace });\r\n  }\r\n\r\n  /** Replace all occurrences of substring or pattern */\r\n  public replaceAll(search: string | RegExp, replace: string) {\r\n    return this.addMutator(replaceAllMutator, { search, replace });\r\n  }\r\n\r\n  /** Append/suffix text to the end */\r\n  public append(suffix: string) {\r\n    return this.addMutator(appendMutator, { suffix });\r\n  }\r\n\r\n  /** Prepend/prefix text to the beginning */\r\n  public prepend(prefix: string) {\r\n    return this.addMutator(prependMutator, { prefix });\r\n  }\r\n\r\n  /** Reverse the string */\r\n  public reverse() {\r\n    return this.addMutator(reverseMutator);\r\n  }\r\n\r\n  /** Truncate to a maximum length */\r\n  public truncate(maxLength: number, suffix = \"...\") {\r\n    return this.addMutator(truncateMutator, { maxLength, suffix });\r\n  }\r\n\r\n  /** Repeat string N times */\r\n  public repeat(count: number) {\r\n    return this.addMutator(repeatMutator, { count });\r\n  }\r\n\r\n  /** Mask part of string */\r\n  public mask(start: number, end?: number, char = \"*\") {\r\n    return this.addMutator(maskMutator, { start, end, char });\r\n  }\r\n\r\n  // ==================== Validation Rules ====================\r\n\r\n  /** Value must be a valid email */\r\n  public email(errorMessage?: string) {\r\n    return this.addRule(emailRule, errorMessage);\r\n  }\r\n\r\n  /** Value must be a valid URL */\r\n  public url(errorMessage?: string) {\r\n    return this.addRule(urlRule, errorMessage);\r\n  }\r\n\r\n  /** Value can not have whitespace */\r\n  public withoutWhitespace(errorMessage?: string) {\r\n    return this.addRule(withoutWhitespaceRule, errorMessage);\r\n  }\r\n\r\n  /** Value must match the given pattern */\r\n  public pattern(pattern: RegExp, errorMessage?: string) {\r\n    return this.addRule(patternRule, errorMessage, { pattern });\r\n  }\r\n\r\n  /**\r\n   * Value must be a strong password\r\n   * Requirements:\r\n   * - At least 8 characters\r\n   * - At least 1 uppercase letter\r\n   * - At least 1 lowercase letter\r\n   * - At least 1 number\r\n   * - At least 1 special character\r\n   */\r\n  public strongPassword(minLength?: number, errorMessage?: string) {\r\n    return this.addRule(strongPasswordRule, errorMessage, { minLength });\r\n  }\r\n\r\n  /** Value must be exactly the given number of words */\r\n  public words(words: number, errorMessage?: string) {\r\n    return this.addRule(wordsRule, errorMessage, { words });\r\n  }\r\n\r\n  /** Value must be at least the given number of words */\r\n  public minWords(words: number, errorMessage?: string) {\r\n    return this.addRule(minWordsRule, errorMessage, { minWords: words });\r\n  }\r\n\r\n  /** Value must be at most the given number of words */\r\n  public maxWords(words: number, errorMessage?: string) {\r\n    return this.addRule(maxWordsRule, errorMessage, { maxWords: words });\r\n  }\r\n\r\n  /** Value length must be greater than the given length */\r\n  public minLength(length: number, errorMessage?: string) {\r\n    return this.addRule(minLengthRule, errorMessage, { minLength: length });\r\n  }\r\n\r\n  /** @alias minLength */\r\n  public min(min: number, errorMessage?: string) {\r\n    return this.minLength(min, errorMessage);\r\n  }\r\n\r\n  /** Value length must be less than the given length */\r\n  public maxLength(length: number, errorMessage?: string) {\r\n    return this.addRule(maxLengthRule, errorMessage, { maxLength: length });\r\n  }\r\n\r\n  /** @alias maxLength */\r\n  public max(max: number, errorMessage?: string) {\r\n    return this.maxLength(max, errorMessage);\r\n  }\r\n\r\n  /** Value must be of the given length */\r\n  public length(length: number, errorMessage?: string) {\r\n    return this.addRule(lengthRule, errorMessage, { length });\r\n  }\r\n\r\n  /**\r\n   * String length must be between min and max (inclusive)\r\n   *\r\n   * @param min - Minimum length (inclusive)\r\n   * @param max - Maximum length (inclusive)\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * v.string().between(5, 10)  // Length: 5 to 10 characters\r\n   * v.string().lengthBetween(8, 20)  // Same using alias\r\n   * ```\r\n   *\r\n   * @category Validation Rule\r\n   */\r\n  public lengthBetween(min: number, max: number, errorMessage?: string) {\r\n    return this.addRule(betweenLengthRule, errorMessage, {\r\n      minLength: min,\r\n      maxLength: max,\r\n    });\r\n  }\r\n\r\n  /** Allow only alphabetic characters */\r\n  public alpha(errorMessage?: string) {\r\n    return this.addRule(alphaRule, errorMessage);\r\n  }\r\n\r\n  /** Allow only alphanumeric characters */\r\n  public alphanumeric(errorMessage?: string) {\r\n    return this.addRule(alphaNumericRule, errorMessage);\r\n  }\r\n\r\n  /** Allow only numeric characters */\r\n  public numeric(errorMessage?: string) {\r\n    return this.addRule(isNumericRule, errorMessage);\r\n  }\r\n\r\n  /** Value must starts with the given string */\r\n  public startsWith(value: string, errorMessage?: string) {\r\n    return this.addRule(startsWithRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must ends with the given string */\r\n  public endsWith(value: string, errorMessage?: string) {\r\n    return this.addRule(endsWithRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must contain the given string */\r\n  public contains(value: string, errorMessage?: string) {\r\n    return this.addRule(containsRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must not contain the given string */\r\n  public notContains(value: string, errorMessage?: string) {\r\n    return this.addRule(notContainsRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must be a valid IP address */\r\n  public ip(errorMessage?: string) {\r\n    return this.addRule(ipRule, errorMessage);\r\n  }\r\n\r\n  /** Value must be a valid IPv4 address */\r\n  public ip4(errorMessage?: string) {\r\n    return this.addRule(ip4Rule, errorMessage);\r\n  }\r\n\r\n  /** Value must be a valid IPv6 address */\r\n  public ip6(errorMessage?: string) {\r\n    return this.addRule(ip6Rule, errorMessage);\r\n  }\r\n\r\n  /** Check if the string matches a credit card number */\r\n  public creditCard(errorMessage?: string) {\r\n    return this.addRule(isCreditCardRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid color */\r\n  public color(errorMessage?: string) {\r\n    return this.addRule(colorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid hex color */\r\n  public hexColor(errorMessage?: string) {\r\n    return this.addRule(hexColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid HSL color */\r\n  public hslColor(errorMessage?: string) {\r\n    return this.addRule(hslColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid RGB color */\r\n  public rgbColor(errorMessage?: string) {\r\n    return this.addRule(rgbColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid RGBA color */\r\n  public rgbaColor(errorMessage?: string) {\r\n    return this.addRule(rgbaColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid light color */\r\n  public lightColor(errorMessage?: string) {\r\n    return this.addRule(lightColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid dark color */\r\n  public darkColor(errorMessage?: string) {\r\n    return this.addRule(darkColorRule, errorMessage);\r\n  }\r\n\r\n  // ==================== ID Format Rules ====================\r\n\r\n  /**\r\n   * Value must be a valid UUID. Optionally restrict to a specific version.\r\n   *\r\n   * @example\r\n   * v.string().uuid()    // any RFC 4122 UUID\r\n   * v.string().uuid(4)   // only v4 (random)\r\n   * v.string().uuid(7)   // only v7 (timestamp-ordered)\r\n   */\r\n  public uuid(version?: UUIDVersion, errorMessage?: string) {\r\n    return this.addRule(uuidRule, errorMessage, { version });\r\n  }\r\n\r\n  /**\r\n   * Value must be a valid CUID. Defaults to CUID2; pass `{ version: 1 }` for legacy.\r\n   *\r\n   * @example\r\n   * v.string().cuid()                   // CUID2\r\n   * v.string().cuid({ version: 1 })     // legacy CUID1\r\n   */\r\n  public cuid(options?: { version?: 1 | 2; errorMessage?: string }) {\r\n    const { errorMessage, version } = options ?? {};\r\n    return this.addRule(cuidRule, errorMessage, { version });\r\n  }\r\n\r\n  /** Value must be a valid ULID (26 chars, Crockford base32). */\r\n  public ulid(errorMessage?: string) {\r\n    return this.addRule(ulidRule, errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Value must be a valid nanoid string. Default length is 21.\r\n   *\r\n   * @example\r\n   * v.string().nanoid()       // 21 chars (default)\r\n   * v.string().nanoid(10)     // 10 chars\r\n   */\r\n  public nanoid(length?: number, errorMessage?: string) {\r\n    return this.addRule(nanoidRule, errorMessage, { length });\r\n  }\r\n\r\n  /**\r\n   * @inheritdoc\r\n   *\r\n   * Maps String-specific rule options to JSON Schema keywords.\r\n   * Non-representable rules (cross-field, refine, color rules, etc.) are silently omitted.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * v.string().min(2).max(100).email().toJsonSchema(\"draft-2020-12\")\r\n   * // → { type: \"string\", minLength: 2, maxLength: 100, format: \"email\" }\r\n   * ```\r\n   */\r\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\r\n    const schema: JsonSchemaResult = { type: \"string\" };\r\n\r\n    // minLength / min\r\n    const minOpts = getRuleOptions(this.rules, \"minLength\");\r\n    if (minOpts?.minLength !== undefined) schema.minLength = minOpts.minLength;\r\n\r\n    // maxLength / max\r\n    const maxOpts = getRuleOptions(this.rules, \"maxLength\");\r\n    if (maxOpts?.maxLength !== undefined) schema.maxLength = maxOpts.maxLength;\r\n\r\n    // betweenLength covers both min and max in one rule\r\n    const betweenOpts = getRuleOptions(this.rules, \"betweenLength\");\r\n    if (betweenOpts) {\r\n      if (betweenOpts.minLength !== undefined) schema.minLength = betweenOpts.minLength;\r\n      if (betweenOpts.maxLength !== undefined) schema.maxLength = betweenOpts.maxLength;\r\n    }\r\n\r\n    // exact length\r\n    const lengthOpts = getRuleOptions(this.rules, \"length\");\r\n    if (lengthOpts?.length !== undefined) {\r\n      schema.minLength = lengthOpts.length;\r\n      schema.maxLength = lengthOpts.length;\r\n    }\r\n\r\n    // pattern (regex)\r\n    const patternOpts = getRuleOptions(this.rules, \"pattern\");\r\n    if (patternOpts?.pattern instanceof RegExp) {\r\n      schema.pattern = patternOpts.pattern.source;\r\n    }\r\n\r\n    // format hints\r\n    if (getRuleOptions(this.rules, \"email\") !== undefined ||\r\n        this.rules.some(r => r.name === \"email\")) {\r\n      schema.format = \"email\";\r\n    } else if (this.rules.some(r => r.name === \"url\")) {\r\n      schema.format = \"uri\";\r\n    } else if (this.rules.some(r => r.name === \"ip\")) {\r\n      schema.format = \"ipv4\";\r\n    } else if (this.rules.some(r => r.name === \"ip4\")) {\r\n      schema.format = \"ipv4\";\r\n    } else if (this.rules.some(r => r.name === \"ip6\")) {\r\n      schema.format = \"ipv6\";\r\n    } else if (this.rules.some(r => r.name === \"uuid\")) {\r\n      schema.format = \"uuid\";\r\n    } else if (this.rules.some(r => r.name === \"hexColor\")) {\r\n      schema.format = \"color\";\r\n    }\r\n\r\n    // CUID / ULID / nanoid don't have widely-supported format keywords —\r\n    // fall back to pattern so JSON Schema validators still enforce shape.\r\n    if (!schema.format) {\r\n      const cuidOpts = getRuleOptions(this.rules, \"cuid\");\r\n      if (cuidOpts) {\r\n        schema.pattern = cuidOpts.version === 1 ? \"^c[a-z0-9]{24,}$\" : \"^[a-z][a-z0-9]{23}$\";\r\n      }\r\n      if (this.rules.some(r => r.name === \"ulid\")) {\r\n        schema.pattern = \"^[0-9A-HJKMNP-TV-Z]{26}$\";\r\n      }\r\n      const nanoidOpts = getRuleOptions(this.rules, \"nanoid\");\r\n      if (nanoidOpts) {\r\n        const len = (nanoidOpts.length as number | undefined) ?? 21;\r\n        schema.pattern = `^[A-Za-z0-9_-]{${len}}$`;\r\n      }\r\n    }\r\n\r\n    // enum (from PrimitiveValidator.in / .enum)\r\n    const inOpts = getRuleOptions(this.rules, \"in\");\r\n    if (inOpts?.values && Array.isArray(inOpts.values)) {\r\n      schema.enum = inOpts.values;\r\n    }\r\n\r\n    if (this.isNullable) applyNullable(schema, target);\r\n\r\n    return schema;\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"string-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"sourcesContent":["import {\r\n  alphaOnlyMutator,\r\n  alphanumericOnlyMutator,\r\n  appendMutator,\r\n  base64DecodeMutator,\r\n  base64EncodeMutator,\r\n  camelCaseMutator,\r\n  capitalizeMutator,\r\n  htmlEscapeMutator,\r\n  kebabCaseMutator,\r\n  lowercaseMutator,\r\n  ltrimMutator,\r\n  maskMutator,\r\n  padEndMutator,\r\n  padStartMutator,\r\n  pascalCaseMutator,\r\n  prependMutator,\r\n  removeNumbersMutator,\r\n  removeSpecialCharactersMutator,\r\n  repeatMutator,\r\n  replaceAllMutator,\r\n  replaceMutator,\r\n  reverseMutator,\r\n  rtrimMutator,\r\n  slugMutator,\r\n  snakeCaseMutator,\r\n  stringifyMutator,\r\n  stripTagsMutator,\r\n  titleCaseMutator,\r\n  trimMultipleWhitespaceMutator,\r\n  trimMutator,\r\n  truncateMutator,\r\n  unescapeHtmlMutator,\r\n  uppercaseMutator,\r\n  urlDecodeMutator,\r\n  urlEncodeMutator,\r\n} from \"../mutators/string-mutators\";\r\nimport { alphaNumericRule, alphaRule, isNumericRule } from \"../rules/string/alpha\";\r\nimport { isCreditCardRule } from \"../rules/string/credit-card\";\r\nimport { emailRule } from \"../rules/string/email\";\r\nimport { cuidRule, nanoidRule, ulidRule, uuidRule } from \"../rules/string/id-formats\";\r\nimport { ip4Rule, ip6Rule, ipRule } from \"../rules/string/ip\";\r\nimport {\r\n  containsRule,\r\n  endsWithRule,\r\n  notContainsRule,\r\n  startsWithRule,\r\n} from \"../rules/string/string-comparison\";\r\nimport { patternRule } from \"../rules/string/pattern\";\r\nimport { strongPasswordRule } from \"../rules/string/strong-password-rule\";\r\nimport { urlRule } from \"../rules/string/url\";\r\nimport { withoutWhitespaceRule } from \"../rules/string/without-whitespace\";\r\nimport type { UUIDVersion } from \"../rules/string/id-formats\";\r\nimport {\r\n  betweenLengthRule,\r\n  lengthRule,\r\n  maxLengthRule,\r\n  maxWordsRule,\r\n  minLengthRule,\r\n  minWordsRule,\r\n  wordsRule,\r\n} from \"../rules/length\";\r\nimport {\r\n  colorRule,\r\n  darkColorRule,\r\n  hexColorRule,\r\n  hslColorRule,\r\n  lightColorRule,\r\n  rgbColorRule,\r\n  rgbaColorRule,\r\n} from \"../rules/color\";\r\nimport { stringRule } from \"../rules/common/type-rules\";\r\nimport { PrimitiveValidator } from \"./primitive-validator\";\r\nimport { applyNullable, getRuleOptions } from \"../standard-schema/json-schema\";\r\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\r\n\r\n/**\r\n * String validator class\r\n */\r\nexport class StringValidator extends PrimitiveValidator {\r\n  public constructor(errorMessage?: string) {\r\n    super();\r\n    this.addMutableRule(stringRule, errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Check if value is a string type\r\n   */\r\n  public matchesType(value: any): boolean {\r\n    return typeof value === \"string\";\r\n  }\r\n\r\n  // ==================== Mutators ====================\r\n\r\n  /**\r\n   * Stringify the value if not a string\r\n   */\r\n  public toString() {\r\n    return this.addMutator(stringifyMutator);\r\n  }\r\n\r\n  /** Convert string to uppercase */\r\n  public uppercase() {\r\n    return this.addMutator(uppercaseMutator);\r\n  }\r\n\r\n  /** Convert string to lowercase */\r\n  public lowercase() {\r\n    return this.addMutator(lowercaseMutator);\r\n  }\r\n\r\n  /** Capitalize only the first letter of the string */\r\n  public capitalize() {\r\n    return this.addMutator(capitalizeMutator);\r\n  }\r\n\r\n  /** Capitalize the first letter of each word (Title Case) */\r\n  public titleCase() {\r\n    return this.addMutator(titleCaseMutator);\r\n  }\r\n\r\n  /** Convert to camelCase */\r\n  public camelCase() {\r\n    return this.addMutator(camelCaseMutator);\r\n  }\r\n\r\n  /** Convert to PascalCase */\r\n  public pascalCase() {\r\n    return this.addMutator(pascalCaseMutator);\r\n  }\r\n\r\n  /** Convert to snake_case */\r\n  public snakeCase() {\r\n    return this.addMutator(snakeCaseMutator);\r\n  }\r\n\r\n  /** Convert to kebab-case */\r\n  public kebabCase() {\r\n    return this.addMutator(kebabCaseMutator);\r\n  }\r\n\r\n  /**\r\n   * Trim the given needle from the string\r\n   * If no needle is provided, the default is a single space\r\n   */\r\n  public trim(needle?: string) {\r\n    return this.addMutator(trimMutator, { needle });\r\n  }\r\n\r\n  /** Trim from the left/start */\r\n  public ltrim(needle?: string) {\r\n    return this.addMutator(ltrimMutator, { needle });\r\n  }\r\n\r\n  /** Trim from the right/end */\r\n  public rtrim(needle?: string) {\r\n    return this.addMutator(rtrimMutator, { needle });\r\n  }\r\n\r\n  /** Trim multiple whitespace into single space */\r\n  public trimMultipleWhitespace() {\r\n    return this.addMutator(trimMultipleWhitespaceMutator);\r\n  }\r\n\r\n  /** Pad string from the start to reach target length */\r\n  public padStart(length: number, char = \" \") {\r\n    return this.addMutator(padStartMutator, { length, char });\r\n  }\r\n\r\n  /** Pad string from the end to reach target length */\r\n  public padEnd(length: number, char = \" \") {\r\n    return this.addMutator(padEndMutator, { length, char });\r\n  }\r\n\r\n  /**\r\n   * Strip HTML tags with a naive `<...>` regex.\r\n   *\r\n   * This is a **tag stripper, not an XSS sanitizer**: it is not a parser,\r\n   * so malformed/nested markup or content re-introduced later in a\r\n   * pipeline can defeat it. Do not rely on this alone to make untrusted\r\n   * rich text safe to render — use a real parser-based sanitizer (e.g.\r\n   * DOMPurify / sanitize-html) for that.\r\n   */\r\n  public stripTags() {\r\n    return this.addMutator(stripTagsMutator);\r\n  }\r\n\r\n  /**\r\n   * @deprecated Renamed to {@link StringValidator.stripTags} — the old\r\n   * name implied XSS safety this tag-stripping regex does not provide.\r\n   * Kept as an alias for backward compatibility; switch to `.stripTags()`.\r\n   */\r\n  public safeHtml() {\r\n    return this.stripTags();\r\n  }\r\n\r\n  /** HTML escape special characters */\r\n  public htmlEscape() {\r\n    return this.addMutator(htmlEscapeMutator);\r\n  }\r\n\r\n  /** Unescape HTML entities */\r\n  public unescapeHtml() {\r\n    return this.addMutator(unescapeHtmlMutator);\r\n  }\r\n\r\n  /**\r\n   * Remove special characters\r\n   * This will remove all characters that are not alphanumeric or whitespace\r\n   */\r\n  public removeSpecialCharacters() {\r\n    return this.addMutator(removeSpecialCharactersMutator);\r\n  }\r\n\r\n  /** Convert to only alphabetic characters */\r\n  public toAlpha() {\r\n    return this.addMutator(alphaOnlyMutator);\r\n  }\r\n\r\n  /** Convert to only alphanumeric characters */\r\n  public toAlphanumeric() {\r\n    return this.addMutator(alphanumericOnlyMutator);\r\n  }\r\n\r\n  /** Remove all numeric characters */\r\n  public removeNumbers() {\r\n    return this.addMutator(removeNumbersMutator);\r\n  }\r\n\r\n  /** URL decode */\r\n  public urlDecode() {\r\n    return this.addMutator(urlDecodeMutator);\r\n  }\r\n\r\n  /** URL encode */\r\n  public urlEncode() {\r\n    return this.addMutator(urlEncodeMutator);\r\n  }\r\n\r\n  /** Convert to URL-friendly slug */\r\n  public slug() {\r\n    return this.addMutator(slugMutator);\r\n  }\r\n\r\n  /** Base64 encode */\r\n  public base64Encode() {\r\n    return this.addMutator(base64EncodeMutator);\r\n  }\r\n\r\n  /** Base64 decode */\r\n  public base64Decode() {\r\n    return this.addMutator(base64DecodeMutator);\r\n  }\r\n\r\n  /** Replace substring or pattern */\r\n  public replace(search: string | RegExp, replace: string) {\r\n    return this.addMutator(replaceMutator, { search, replace });\r\n  }\r\n\r\n  /** Replace all occurrences of substring or pattern */\r\n  public replaceAll(search: string | RegExp, replace: string) {\r\n    return this.addMutator(replaceAllMutator, { search, replace });\r\n  }\r\n\r\n  /** Append/suffix text to the end */\r\n  public append(suffix: string) {\r\n    return this.addMutator(appendMutator, { suffix });\r\n  }\r\n\r\n  /** Prepend/prefix text to the beginning */\r\n  public prepend(prefix: string) {\r\n    return this.addMutator(prependMutator, { prefix });\r\n  }\r\n\r\n  /** Reverse the string */\r\n  public reverse() {\r\n    return this.addMutator(reverseMutator);\r\n  }\r\n\r\n  /** Truncate to a maximum length */\r\n  public truncate(maxLength: number, suffix = \"...\") {\r\n    return this.addMutator(truncateMutator, { maxLength, suffix });\r\n  }\r\n\r\n  /** Repeat string N times */\r\n  public repeat(count: number) {\r\n    return this.addMutator(repeatMutator, { count });\r\n  }\r\n\r\n  /** Mask part of string */\r\n  public mask(start: number, end?: number, char = \"*\") {\r\n    return this.addMutator(maskMutator, { start, end, char });\r\n  }\r\n\r\n  // ==================== Validation Rules ====================\r\n\r\n  /** Value must be a valid email */\r\n  public email(errorMessage?: string) {\r\n    return this.addRule(emailRule, errorMessage);\r\n  }\r\n\r\n  /** Value must be a valid URL */\r\n  public url(errorMessage?: string) {\r\n    return this.addRule(urlRule, errorMessage);\r\n  }\r\n\r\n  /** Value can not have whitespace */\r\n  public withoutWhitespace(errorMessage?: string) {\r\n    return this.addRule(withoutWhitespaceRule, errorMessage);\r\n  }\r\n\r\n  /** Value must match the given pattern */\r\n  public pattern(pattern: RegExp, errorMessage?: string) {\r\n    return this.addRule(patternRule, errorMessage, { pattern });\r\n  }\r\n\r\n  /**\r\n   * Value must be a strong password\r\n   * Requirements:\r\n   * - At least 8 characters\r\n   * - At least 1 uppercase letter\r\n   * - At least 1 lowercase letter\r\n   * - At least 1 number\r\n   * - At least 1 special character\r\n   */\r\n  public strongPassword(minLength?: number, errorMessage?: string) {\r\n    return this.addRule(strongPasswordRule, errorMessage, { minLength });\r\n  }\r\n\r\n  /** Value must be exactly the given number of words */\r\n  public words(words: number, errorMessage?: string) {\r\n    return this.addRule(wordsRule, errorMessage, { words });\r\n  }\r\n\r\n  /** Value must be at least the given number of words */\r\n  public minWords(words: number, errorMessage?: string) {\r\n    return this.addRule(minWordsRule, errorMessage, { minWords: words });\r\n  }\r\n\r\n  /** Value must be at most the given number of words */\r\n  public maxWords(words: number, errorMessage?: string) {\r\n    return this.addRule(maxWordsRule, errorMessage, { maxWords: words });\r\n  }\r\n\r\n  /** Value length must be greater than the given length */\r\n  public minLength(length: number, errorMessage?: string) {\r\n    return this.addRule(minLengthRule, errorMessage, { minLength: length });\r\n  }\r\n\r\n  /** @alias minLength */\r\n  public min(min: number, errorMessage?: string) {\r\n    return this.minLength(min, errorMessage);\r\n  }\r\n\r\n  /** Value length must be less than the given length */\r\n  public maxLength(length: number, errorMessage?: string) {\r\n    return this.addRule(maxLengthRule, errorMessage, { maxLength: length });\r\n  }\r\n\r\n  /** @alias maxLength */\r\n  public max(max: number, errorMessage?: string) {\r\n    return this.maxLength(max, errorMessage);\r\n  }\r\n\r\n  /** Value must be of the given length */\r\n  public length(length: number, errorMessage?: string) {\r\n    return this.addRule(lengthRule, errorMessage, { length });\r\n  }\r\n\r\n  /**\r\n   * String length must be between min and max (inclusive)\r\n   *\r\n   * @param min - Minimum length (inclusive)\r\n   * @param max - Maximum length (inclusive)\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * v.string().between(5, 10)  // Length: 5 to 10 characters\r\n   * v.string().lengthBetween(8, 20)  // Same using alias\r\n   * ```\r\n   *\r\n   * @category Validation Rule\r\n   */\r\n  public lengthBetween(min: number, max: number, errorMessage?: string) {\r\n    return this.addRule(betweenLengthRule, errorMessage, {\r\n      minLength: min,\r\n      maxLength: max,\r\n    });\r\n  }\r\n\r\n  /** Allow only alphabetic characters */\r\n  public alpha(errorMessage?: string) {\r\n    return this.addRule(alphaRule, errorMessage);\r\n  }\r\n\r\n  /** Allow only alphanumeric characters */\r\n  public alphanumeric(errorMessage?: string) {\r\n    return this.addRule(alphaNumericRule, errorMessage);\r\n  }\r\n\r\n  /** Allow only numeric characters */\r\n  public numeric(errorMessage?: string) {\r\n    return this.addRule(isNumericRule, errorMessage);\r\n  }\r\n\r\n  /** Value must starts with the given string */\r\n  public startsWith(value: string, errorMessage?: string) {\r\n    return this.addRule(startsWithRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must ends with the given string */\r\n  public endsWith(value: string, errorMessage?: string) {\r\n    return this.addRule(endsWithRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must contain the given string */\r\n  public contains(value: string, errorMessage?: string) {\r\n    return this.addRule(containsRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must not contain the given string */\r\n  public notContains(value: string, errorMessage?: string) {\r\n    return this.addRule(notContainsRule, errorMessage, { value });\r\n  }\r\n\r\n  /** Value must be a valid IP address */\r\n  public ip(errorMessage?: string) {\r\n    return this.addRule(ipRule, errorMessage);\r\n  }\r\n\r\n  /** Value must be a valid IPv4 address */\r\n  public ip4(errorMessage?: string) {\r\n    return this.addRule(ip4Rule, errorMessage);\r\n  }\r\n\r\n  /** Value must be a valid IPv6 address */\r\n  public ip6(errorMessage?: string) {\r\n    return this.addRule(ip6Rule, errorMessage);\r\n  }\r\n\r\n  /** Check if the string matches a credit card number */\r\n  public creditCard(errorMessage?: string) {\r\n    return this.addRule(isCreditCardRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid color */\r\n  public color(errorMessage?: string) {\r\n    return this.addRule(colorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid hex color */\r\n  public hexColor(errorMessage?: string) {\r\n    return this.addRule(hexColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid HSL color */\r\n  public hslColor(errorMessage?: string) {\r\n    return this.addRule(hslColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid RGB color */\r\n  public rgbColor(errorMessage?: string) {\r\n    return this.addRule(rgbColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid RGBA color */\r\n  public rgbaColor(errorMessage?: string) {\r\n    return this.addRule(rgbaColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid light color */\r\n  public lightColor(errorMessage?: string) {\r\n    return this.addRule(lightColorRule, errorMessage);\r\n  }\r\n\r\n  /** Determine if the value is a valid dark color */\r\n  public darkColor(errorMessage?: string) {\r\n    return this.addRule(darkColorRule, errorMessage);\r\n  }\r\n\r\n  // ==================== ID Format Rules ====================\r\n\r\n  /**\r\n   * Value must be a valid UUID. Optionally restrict to a specific version.\r\n   *\r\n   * @example\r\n   * v.string().uuid()    // any RFC 4122 UUID\r\n   * v.string().uuid(4)   // only v4 (random)\r\n   * v.string().uuid(7)   // only v7 (timestamp-ordered)\r\n   */\r\n  public uuid(version?: UUIDVersion, errorMessage?: string) {\r\n    return this.addRule(uuidRule, errorMessage, { version });\r\n  }\r\n\r\n  /**\r\n   * Value must be a valid CUID. Defaults to CUID2; pass `{ version: 1 }` for legacy.\r\n   *\r\n   * @example\r\n   * v.string().cuid()                   // CUID2\r\n   * v.string().cuid({ version: 1 })     // legacy CUID1\r\n   */\r\n  public cuid(options?: { version?: 1 | 2; errorMessage?: string }) {\r\n    const { errorMessage, version } = options ?? {};\r\n    return this.addRule(cuidRule, errorMessage, { version });\r\n  }\r\n\r\n  /** Value must be a valid ULID (26 chars, Crockford base32). */\r\n  public ulid(errorMessage?: string) {\r\n    return this.addRule(ulidRule, errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Value must be a valid nanoid string. Default length is 21.\r\n   *\r\n   * @example\r\n   * v.string().nanoid()       // 21 chars (default)\r\n   * v.string().nanoid(10)     // 10 chars\r\n   */\r\n  public nanoid(length?: number, errorMessage?: string) {\r\n    return this.addRule(nanoidRule, errorMessage, { length });\r\n  }\r\n\r\n  /**\r\n   * @inheritdoc\r\n   *\r\n   * Maps String-specific rule options to JSON Schema keywords.\r\n   * Non-representable rules (cross-field, refine, color rules, etc.) are silently omitted.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * v.string().min(2).max(100).email().toJsonSchema(\"draft-2020-12\")\r\n   * // → { type: \"string\", minLength: 2, maxLength: 100, format: \"email\" }\r\n   * ```\r\n   */\r\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\r\n    const schema: JsonSchemaResult = { type: \"string\" };\r\n\r\n    // minLength / min\r\n    const minOpts = getRuleOptions(this.rules, \"minLength\");\r\n    if (minOpts?.minLength !== undefined) schema.minLength = minOpts.minLength;\r\n\r\n    // maxLength / max\r\n    const maxOpts = getRuleOptions(this.rules, \"maxLength\");\r\n    if (maxOpts?.maxLength !== undefined) schema.maxLength = maxOpts.maxLength;\r\n\r\n    // betweenLength covers both min and max in one rule\r\n    const betweenOpts = getRuleOptions(this.rules, \"betweenLength\");\r\n    if (betweenOpts) {\r\n      if (betweenOpts.minLength !== undefined) schema.minLength = betweenOpts.minLength;\r\n      if (betweenOpts.maxLength !== undefined) schema.maxLength = betweenOpts.maxLength;\r\n    }\r\n\r\n    // exact length\r\n    const lengthOpts = getRuleOptions(this.rules, \"length\");\r\n    if (lengthOpts?.length !== undefined) {\r\n      schema.minLength = lengthOpts.length;\r\n      schema.maxLength = lengthOpts.length;\r\n    }\r\n\r\n    // pattern (regex)\r\n    const patternOpts = getRuleOptions(this.rules, \"pattern\");\r\n    if (patternOpts?.pattern instanceof RegExp) {\r\n      schema.pattern = patternOpts.pattern.source;\r\n    }\r\n\r\n    // format hints\r\n    if (\r\n      getRuleOptions(this.rules, \"email\") !== undefined ||\r\n      this.rules.some((r) => r.name === \"email\")\r\n    ) {\r\n      schema.format = \"email\";\r\n    } else if (this.rules.some((r) => r.name === \"url\")) {\r\n      schema.format = \"uri\";\r\n    } else if (this.rules.some((r) => r.name === \"ip\")) {\r\n      schema.format = \"ipv4\";\r\n    } else if (this.rules.some((r) => r.name === \"ip4\")) {\r\n      schema.format = \"ipv4\";\r\n    } else if (this.rules.some((r) => r.name === \"ip6\")) {\r\n      schema.format = \"ipv6\";\r\n    } else if (this.rules.some((r) => r.name === \"uuid\")) {\r\n      schema.format = \"uuid\";\r\n    } else if (this.rules.some((r) => r.name === \"hexColor\")) {\r\n      schema.format = \"color\";\r\n    }\r\n\r\n    // CUID / ULID / nanoid don't have widely-supported format keywords —\r\n    // fall back to pattern so JSON Schema validators still enforce shape.\r\n    if (!schema.format) {\r\n      const cuidOpts = getRuleOptions(this.rules, \"cuid\");\r\n      if (cuidOpts) {\r\n        schema.pattern = cuidOpts.version === 1 ? \"^c[a-z0-9]{24,}$\" : \"^[a-z][a-z0-9]{23}$\";\r\n      }\r\n      if (this.rules.some((r) => r.name === \"ulid\")) {\r\n        schema.pattern = \"^[0-9A-HJKMNP-TV-Z]{26}$\";\r\n      }\r\n      const nanoidOpts = getRuleOptions(this.rules, \"nanoid\");\r\n      if (nanoidOpts) {\r\n        const len = (nanoidOpts.length as number | undefined) ?? 21;\r\n        schema.pattern = `^[A-Za-z0-9_-]{${len}}$`;\r\n      }\r\n    }\r\n\r\n    // enum (from PrimitiveValidator.in / .enum)\r\n    const inOpts = getRuleOptions(this.rules, \"in\");\r\n    if (inOpts?.values && Array.isArray(inOpts.values)) {\r\n      schema.enum = inOpts.values;\r\n    }\r\n\r\n    if (this.isNullable) applyNullable(schema, target);\r\n\r\n    return schema;\r\n  }\r\n}\r\n"],"mappings":"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"}

package/llms-full.txt

@@ -2190,6 +2190,28 @@ if (result.isValid) {
 }
 ```
 
+## Granular object and string schemas
+
+For code that only constructs object and string schemas, import the dedicated
+factories instead of the package-root `v` factory:
+
+```ts
+import { object } from "@warlock.js/seal/object";
+import { string } from "@warlock.js/seal/string";
+
+const commentSchema = object({
+  comment: string().trim().required().minLength(3),
+});
+
+const result = await commentSchema["~standard"].validate({
+  comment: "  Hello  ",
+});
+```
+
+These entries provide the `object` and `string` factories, their validator
+classes, chain methods, and the Standard Schema bridge. They do not replace the
+root `v` factory when a schema needs other factories.
+
 ## Foundations
 
 The 12 things that are true in every seal use: