@warlock.js/seal 5.29.0 → 5.30.0

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

@@ -1 +1 @@
-{"version":3,"file":"primitive-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/primitive-validator.ts"],"mappings":";;;;;AAyBA;;;;;;;;;;;;;;;;;;;;uBAAsB,kBAAA,SAA2B,aAAa;EA2D/C;;;AAAoC;;;EApD1C,IAAA,CAAK,MAAA,OAAa,YAAA;;;;;;;;EAWlB,EAAA,CAAG,MAAA,SAAe,YAAA;;;;;;;EAUlB,KAAA,CAAM,MAAA,SAAe,YAAA;;;;;;;EAUrB,UAAA,CAAW,MAAA,SAAe,YAAA;;;;;;;;EAW1B,OAAA,CAAQ,MAAA,SAAe,YAAA;;;;;;;EAUvB,KAAA,CAAM,MAAA,SAAe,YAAA;AAAA"}
+{"version":3,"file":"primitive-validator.d.mts","names":[],"sources":["../../../../../../../../packages/seal/src/validators/primitive-validator.ts"],"mappings":";;;;;AAyBA;;;;;;;;;;;;;;;;;;;;uBAAsB,kBAAA,SAA2B,aAAa;EA2D/C;;;AAAoC;;;EApD1C,IAAA,CAAK,MAAA,OAAa,YAAA;;;;;;;;EAWlB,EAAA,CAAG,MAAA,SAAe,YAAA;;;;;;;EAUlB,KAAA,CAAM,MAAA,SAAe,YAAA;;;;;;;EAUrB,UAAA,CAAW,MAAA,SAAe,YAAA;;;;;;;;EAW1B,OAAA,CAAQ,MAAA,SAAe,YAAA;;;;;;;EAUvB,KAAA,CAAM,MAAA,SAAe,YAAA;AAAA"}

package/esm/validators/primitive-validator.mjs

@@ -1,7 +1,7 @@
 import { BaseValidator } from "./base-validator.mjs";
 import { allowedValuesRule, enumRule, inRule, notAllowedValuesRule } from "../rules/common/enum.mjs";
 
-//#region ../seal/src/validators/primitive-validator.ts
+//#region ../../packages/seal/src/validators/primitive-validator.ts
 /**
 * Abstract base validator for primitive-typed fields (string, number, boolean).
 *

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/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"}
+{"version":3,"file":"primitive-validator.mjs","names":[],"sources":["../../../../../../../../packages/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/record-validator.d.mts

@@ -3,7 +3,7 @@ import { SchemaContext } from "../types/context-types.mjs";
 import { ValidationResult } from "../types/result-types.mjs";
 import { BaseValidator } from "./base-validator.mjs";
 
-//#region ../seal/src/validators/record-validator.d.ts
+//#region ../../packages/seal/src/validators/record-validator.d.ts
 /**
  * Record validator class - validates objects with dynamic keys and consistent value types
  *

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

@@ -1 +1 @@
-{"version":3,"file":"record-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/record-validator.ts"],"mappings":";;;;;;;;;;AAsBA;;;;;;;;;;cAAa,eAAA,SAAwB,aAAA;EAE1B,cAAA,EAAgB,aAAA;cAAhB,cAAA,EAAgB,aAAA,EACvB,YAAA;EAHiC;;;EAY5B,WAAA,CAAY,YAAA;EAVM;;;EAiBlB,WAAA,CAAY,KAAA;EAPA;;;EAcH,KAAA;EAaH;;;;;;;EAAA,QAAA,CAAS,IAAA,OAAW,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,gBAAA;EAkErC;;;AAA6D;;;;;;;;;;;;EAA1E,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"record-validator.d.mts","names":[],"sources":["../../../../../../../../packages/seal/src/validators/record-validator.ts"],"mappings":";;;;;;;;;AAsBA;;;;;;;;;;;cAAa,eAAA,SAAwB,aAAA;EAE1B,cAAA,EAAgB,aAAA;cAAhB,cAAA,EAAgB,aAAA,EACvB,YAAA;EADO;;;EAUF,WAAA,CAAY,YAAA;EAVV;;;EAiBF,WAAA,CAAY,KAAA;EAAZ;;;EAOS,KAAA;EAaM;;;;;;;EAAT,QAAA,CAAS,IAAA,OAAW,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,gBAAA;EAkEQ;;AAAgB;;;;;;;;;;;;;EAA1E,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/validators/record-validator.mjs

@@ -6,7 +6,7 @@ import { objectRule, plainObjectRule } from "../rules/common/type-rules.mjs";
 import "../rules/index.mjs";
 import { isPlainObject } from "@mongez/supportive-is";
 
-//#region ../seal/src/validators/record-validator.ts
+//#region ../../packages/seal/src/validators/record-validator.ts
 /**
 * Record validator class - validates objects with dynamic keys and consistent value types
 *

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

@@ -1 +1 @@
-{"version":3,"file":"record-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/record-validator.ts"],"sourcesContent":["import { isPlainObject } from \"@mongez/supportive-is\";\nimport { setKeyPath } from \"../helpers\";\nimport { objectRule, plainObjectRule } from \"../rules\";\nimport type { SchemaContext, ValidationResult } from \"../types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { applyNullable } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Record validator class - validates objects with dynamic keys and consistent value types\n *\n * @example\n * ```ts\n * // Translations object\n * v.record(v.string())\n * // Valid: { en: \"Hello\", ar: \"مرحبا\", fr: \"Bonjour\" }\n *\n * // User preferences\n * v.record(v.union([v.string(), v.number(), v.boolean()]))\n * // Valid: { theme: \"dark\", fontSize: 16, notifications: true }\n * ```\n */\nexport class RecordValidator extends BaseValidator {\n  public constructor(\n    public valueValidator: BaseValidator,\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(objectRule, errorMessage);\n  }\n\n  /**\n   * Validate it as plain object\n   */\n  public plainObject(errorMessage?: string) {\n    return this.addRule(plainObjectRule, errorMessage);\n  }\n\n  /**\n   * Check if value is a plain object type\n   */\n  public matchesType(value: any): boolean {\n    return isPlainObject(value);\n  }\n\n  /**\n   * Clone the validator\n   */\n  public override clone(): this {\n    const cloned = super.clone();\n    cloned.valueValidator = this.valueValidator.clone();\n    return cloned;\n  }\n\n  /**\n   * Validate record - iterate all keys and validate each value\n   *\n   * Absent input (and absent without `.default()`) propagates as `data: undefined`\n   * so the parent ObjectValidator can omit the key. Without this, optional record\n   * fields would silently materialise as `{}` in the validated output.\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    // Apply default when absent, then mutate. Mirrors BaseValidator's\n    // `valueForRules = data ?? this.getDefaultValue()` so `.default({...})`\n    // works on records too.\n    const valueForRules = data ?? this.getDefaultValue();\n    const mutatedData = await this.mutate(valueForRules, context);\n\n    const result = await super.validate(data, context);\n\n    if (result.isValid === false) return result;\n\n    // Nothing to iterate for absent (no default) or null (nullable) inputs —\n    // propagate so the parent ObjectValidator can omit the key.\n    if (mutatedData === undefined || mutatedData === null) return result;\n\n    // Defensive: type rule (objectRule) should have failed for non-objects.\n    if (!isPlainObject(mutatedData)) return result;\n\n    const errors: ValidationResult[\"errors\"] = [];\n    const keys = Object.keys(mutatedData);\n\n    // Validate all values in parallel\n    const validationPromises = keys.map(async (key) => {\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value: mutatedData[key],\n        key,\n        path: setKeyPath(context.path, key),\n      };\n\n      const childResult = await this.valueValidator.validate(mutatedData[key], childContext);\n\n      // Update mutated data with validated result\n      mutatedData[key] = childResult.data;\n\n      // Collect errors from this value\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n      data: await this.startTransformationPipeline(mutatedData, context),\n    };\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Generates `{ type: \"object\", additionalProperties: <valueSchema> }` —\n   * the standard JSON Schema for a dictionary/map with homogeneous values.\n   *\n   * @example\n   * ```ts\n   * v.record(v.string()).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\", additionalProperties: { type: \"string\" } }\n   *\n   * v.record(v.union([v.string(), v.number()])).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\", additionalProperties: { oneOf: [{ type: \"string\" }, { type: \"number\" }] } }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const schema: JsonSchemaResult = {\n      type: \"object\",\n      additionalProperties: this.valueValidator.toJsonSchema(target),\n    };\n\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,kBAAb,cAAqC,cAAc;CACjD,AAAO,YACL,AAAO,gBACP,cACA;EACA,MAAM;EAHC;EAIP,KAAK,eAAe,YAAY,YAAY;CAC9C;;;;CAKA,AAAO,YAAY,cAAuB;EACxC,OAAO,KAAK,QAAQ,iBAAiB,YAAY;CACnD;;;;CAKA,AAAO,YAAY,OAAqB;EACtC,OAAO,cAAc,KAAK;CAC5B;;;;CAKA,AAAgB,QAAc;EAC5B,MAAM,SAAS,MAAM,MAAM;EAC3B,OAAO,iBAAiB,KAAK,eAAe,MAAM;EAClD,OAAO;CACT;;;;;;;;CASA,MAAa,SAAS,MAAW,SAAmD;EAIlF,MAAM,gBAAgB,QAAQ,KAAK,gBAAgB;EACnD,MAAM,cAAc,MAAM,KAAK,OAAO,eAAe,OAAO;EAE5D,MAAM,SAAS,MAAM,MAAM,SAAS,MAAM,OAAO;EAEjD,IAAI,OAAO,YAAY,OAAO,OAAO;EAIrC,IAAI,gBAAgB,UAAa,gBAAgB,MAAM,OAAO;EAG9D,IAAI,CAAC,cAAc,WAAW,GAAG,OAAO;EAExC,MAAM,SAAqC,CAAC;EAI5C,MAAM,qBAHO,OAAO,KAAK,WAGK,CAAC,CAAC,IAAI,OAAO,QAAQ;GACjD,MAAM,eAA8B;IAClC,GAAG;IACH,QAAQ;IACR,OAAO,YAAY;IACnB;IACA,MAAM,WAAW,QAAQ,MAAM,GAAG;GACpC;GAEA,MAAM,cAAc,MAAM,KAAK,eAAe,SAAS,YAAY,MAAM,YAAY;GAGrF,YAAY,OAAO,YAAY;GAG/B,IAAI,YAAY,YAAY,OAC1B,OAAO,KAAK,GAAG,YAAY,MAAM;EAErC,CAAC;EAED,MAAM,QAAQ,IAAI,kBAAkB;EAEpC,OAAO;GACL,SAAS,OAAO,WAAW;GAC3B;GACA,MAAM,MAAM,KAAK,4BAA4B,aAAa,OAAO;EACnE;CACF;;;;;;;;;;;;;;;;CAiBA,AAAgB,aAAa,SAA2B,iBAAmC;EACzF,MAAM,SAA2B;GAC/B,MAAM;GACN,sBAAsB,KAAK,eAAe,aAAa,MAAM;EAC/D;EAEA,IAAI,KAAK,YAAY,cAAc,QAAQ,MAAM;EAEjD,OAAO;CACT;AACF"}
+{"version":3,"file":"record-validator.mjs","names":[],"sources":["../../../../../../../../packages/seal/src/validators/record-validator.ts"],"sourcesContent":["import { isPlainObject } from \"@mongez/supportive-is\";\nimport { setKeyPath } from \"../helpers\";\nimport { objectRule, plainObjectRule } from \"../rules\";\nimport type { SchemaContext, ValidationResult } from \"../types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { applyNullable } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Record validator class - validates objects with dynamic keys and consistent value types\n *\n * @example\n * ```ts\n * // Translations object\n * v.record(v.string())\n * // Valid: { en: \"Hello\", ar: \"مرحبا\", fr: \"Bonjour\" }\n *\n * // User preferences\n * v.record(v.union([v.string(), v.number(), v.boolean()]))\n * // Valid: { theme: \"dark\", fontSize: 16, notifications: true }\n * ```\n */\nexport class RecordValidator extends BaseValidator {\n  public constructor(\n    public valueValidator: BaseValidator,\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(objectRule, errorMessage);\n  }\n\n  /**\n   * Validate it as plain object\n   */\n  public plainObject(errorMessage?: string) {\n    return this.addRule(plainObjectRule, errorMessage);\n  }\n\n  /**\n   * Check if value is a plain object type\n   */\n  public matchesType(value: any): boolean {\n    return isPlainObject(value);\n  }\n\n  /**\n   * Clone the validator\n   */\n  public override clone(): this {\n    const cloned = super.clone();\n    cloned.valueValidator = this.valueValidator.clone();\n    return cloned;\n  }\n\n  /**\n   * Validate record - iterate all keys and validate each value\n   *\n   * Absent input (and absent without `.default()`) propagates as `data: undefined`\n   * so the parent ObjectValidator can omit the key. Without this, optional record\n   * fields would silently materialise as `{}` in the validated output.\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    // Apply default when absent, then mutate. Mirrors BaseValidator's\n    // `valueForRules = data ?? this.getDefaultValue()` so `.default({...})`\n    // works on records too.\n    const valueForRules = data ?? this.getDefaultValue();\n    const mutatedData = await this.mutate(valueForRules, context);\n\n    const result = await super.validate(data, context);\n\n    if (result.isValid === false) return result;\n\n    // Nothing to iterate for absent (no default) or null (nullable) inputs —\n    // propagate so the parent ObjectValidator can omit the key.\n    if (mutatedData === undefined || mutatedData === null) return result;\n\n    // Defensive: type rule (objectRule) should have failed for non-objects.\n    if (!isPlainObject(mutatedData)) return result;\n\n    const errors: ValidationResult[\"errors\"] = [];\n    const keys = Object.keys(mutatedData);\n\n    // Validate all values in parallel\n    const validationPromises = keys.map(async (key) => {\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value: mutatedData[key],\n        key,\n        path: setKeyPath(context.path, key),\n      };\n\n      const childResult = await this.valueValidator.validate(mutatedData[key], childContext);\n\n      // Update mutated data with validated result\n      mutatedData[key] = childResult.data;\n\n      // Collect errors from this value\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n      data: await this.startTransformationPipeline(mutatedData, context),\n    };\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Generates `{ type: \"object\", additionalProperties: <valueSchema> }` —\n   * the standard JSON Schema for a dictionary/map with homogeneous values.\n   *\n   * @example\n   * ```ts\n   * v.record(v.string()).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\", additionalProperties: { type: \"string\" } }\n   *\n   * v.record(v.union([v.string(), v.number()])).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\", additionalProperties: { oneOf: [{ type: \"string\" }, { type: \"number\" }] } }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const schema: JsonSchemaResult = {\n      type: \"object\",\n      additionalProperties: this.valueValidator.toJsonSchema(target),\n    };\n\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,kBAAb,cAAqC,cAAc;CACjD,AAAO,YACL,AAAO,gBACP,cACA;EACA,MAAM;EAHC;EAIP,KAAK,eAAe,YAAY,YAAY;CAC9C;;;;CAKA,AAAO,YAAY,cAAuB;EACxC,OAAO,KAAK,QAAQ,iBAAiB,YAAY;CACnD;;;;CAKA,AAAO,YAAY,OAAqB;EACtC,OAAO,cAAc,KAAK;CAC5B;;;;CAKA,AAAgB,QAAc;EAC5B,MAAM,SAAS,MAAM,MAAM;EAC3B,OAAO,iBAAiB,KAAK,eAAe,MAAM;EAClD,OAAO;CACT;;;;;;;;CASA,MAAa,SAAS,MAAW,SAAmD;EAIlF,MAAM,gBAAgB,QAAQ,KAAK,gBAAgB;EACnD,MAAM,cAAc,MAAM,KAAK,OAAO,eAAe,OAAO;EAE5D,MAAM,SAAS,MAAM,MAAM,SAAS,MAAM,OAAO;EAEjD,IAAI,OAAO,YAAY,OAAO,OAAO;EAIrC,IAAI,gBAAgB,UAAa,gBAAgB,MAAM,OAAO;EAG9D,IAAI,CAAC,cAAc,WAAW,GAAG,OAAO;EAExC,MAAM,SAAqC,CAAC;EAI5C,MAAM,qBAHO,OAAO,KAAK,WAGK,CAAC,CAAC,IAAI,OAAO,QAAQ;GACjD,MAAM,eAA8B;IAClC,GAAG;IACH,QAAQ;IACR,OAAO,YAAY;IACnB;IACA,MAAM,WAAW,QAAQ,MAAM,GAAG;GACpC;GAEA,MAAM,cAAc,MAAM,KAAK,eAAe,SAAS,YAAY,MAAM,YAAY;GAGrF,YAAY,OAAO,YAAY;GAG/B,IAAI,YAAY,YAAY,OAC1B,OAAO,KAAK,GAAG,YAAY,MAAM;EAErC,CAAC;EAED,MAAM,QAAQ,IAAI,kBAAkB;EAEpC,OAAO;GACL,SAAS,OAAO,WAAW;GAC3B;GACA,MAAM,MAAM,KAAK,4BAA4B,aAAa,OAAO;EACnE;CACF;;;;;;;;;;;;;;;;CAiBA,AAAgB,aAAa,SAA2B,iBAAmC;EACzF,MAAM,SAA2B;GAC/B,MAAM;GACN,sBAAsB,KAAK,eAAe,aAAa,MAAM;EAC/D;EAEA,IAAI,KAAK,YAAY,cAAc,QAAQ,MAAM;EAEjD,OAAO;CACT;AACF"}

package/esm/validators/scalar-validator.d.mts

@@ -1,7 +1,7 @@
 import { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema.mjs";
 import { PrimitiveValidator } from "./primitive-validator.mjs";
 
-//#region ../seal/src/validators/scalar-validator.d.ts
+//#region ../../packages/seal/src/validators/scalar-validator.d.ts
 /**
  * Scalar validator class
  *

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

@@ -1 +1 @@
-{"version":3,"file":"scalar-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/scalar-validator.ts"],"mappings":";;;;;;AA6BA;;;;;;;cAAa,eAAA,SAAwB,kBAAA;cAChB,YAAA;;;;EAqBZ,WAAA,CAAY,KAAA,QAAU,KAAA;EAAA;;;EAOtB,QAAA;EAeS;;;EART,QAAA;EAesC;;;;EAPtC,QAAA,CAAS,YAAA;EAqBT;;;EAdA,UAAA,CAAW,KAAA,UAAe,KAAA,OAAY,YAAA;EAqBpB;;;EAdlB,cAAA,CAAe,KAAA,UAAe,KAAA,OAAY,YAAA;EAqBX;;;EAd/B,kBAAA,CAAmB,KAAA,UAAe,YAAA;EA6BvB;;;EAtBX,iBAAA,CAAkB,KAAA,UAAe,YAAA;EA6BlB;;;EAtBf,eAAA,CAAgB,KAAA,UAAe,YAAA;EA6BZ;;;;EArBnB,QAAA,CAAS,YAAA;EAmCT;;;EA5BA,UAAA,CAAW,KAAA,UAAe,KAAA,OAAY,YAAA;EA+CP;;;EAxC/B,cAAA,CAAe,KAAA,UAAe,KAAA,OAAY,YAAA;EAwC0C;;;EAjCpF,kBAAA,CAAmB,KAAA,UAAe,YAAA;;;;EAOlC,iBAAA,CAAkB,KAAA,UAAe,YAAA;;;;EAOjC,eAAA,CAAgB,KAAA,UAAe,YAAA;;;;;;;;;;;;;;;;EAmBtB,YAAA,CAAa,OAAA,GAAS,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"scalar-validator.d.mts","names":[],"sources":["../../../../../../../../packages/seal/src/validators/scalar-validator.ts"],"mappings":";;;;;;AA6BA;;;;;;;cAAa,eAAA,SAAwB,kBAAA;cAChB,YAAA;;;;EAqBZ,WAAA,CAAY,KAAA,QAAU,KAAA;EAAA;;;EAOtB,QAAA;EAeS;;;EART,QAAA;EAesC;;;;EAPtC,QAAA,CAAS,YAAA;EAqBT;;;EAdA,UAAA,CAAW,KAAA,UAAe,KAAA,OAAY,YAAA;EAqBpB;;;EAdlB,cAAA,CAAe,KAAA,UAAe,KAAA,OAAY,YAAA;EAqBX;;;EAd/B,kBAAA,CAAmB,KAAA,UAAe,YAAA;EA6BvB;;;EAtBX,iBAAA,CAAkB,KAAA,UAAe,YAAA;EA6BlB;;;EAtBf,eAAA,CAAgB,KAAA,UAAe,YAAA;EA6BZ;;;;EArBnB,QAAA,CAAS,YAAA;EAmCT;;;EA5BA,UAAA,CAAW,KAAA,UAAe,KAAA,OAAY,YAAA;EA+CP;;;EAxC/B,cAAA,CAAe,KAAA,UAAe,KAAA,OAAY,YAAA;EAwC0C;;;EAjCpF,kBAAA,CAAmB,KAAA,UAAe,YAAA;;;;EAOlC,iBAAA,CAAkB,KAAA,UAAe,YAAA;;;;EAOjC,eAAA,CAAgB,KAAA,UAAe,YAAA;;;;;;;;;;;;;;;;EAmBtB,YAAA,CAAa,OAAA,GAAS,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/validators/scalar-validator.mjs

@@ -9,7 +9,7 @@ import "../mutators/index.mjs";
 import { PrimitiveValidator } from "./primitive-validator.mjs";
 import "../rules/scalar/index.mjs";
 
-//#region ../seal/src/validators/scalar-validator.ts
+//#region ../../packages/seal/src/validators/scalar-validator.ts
 /**
 * Scalar validator class
 *

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

@@ -1 +1 @@
-{"version":3,"file":"scalar-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/scalar-validator.ts"],"sourcesContent":["import { invalidRule, VALID_RULE } from \"../helpers\";\nimport { numberMutator, stringMutator } from \"../mutators\";\nimport {\n  acceptedIfPresentRule,\n  acceptedIfRequiredRule,\n  acceptedIfRule,\n  acceptedRule,\n  acceptedUnlessRule,\n  acceptedWithoutRule,\n  declinedIfPresentRule,\n  declinedIfRequiredRule,\n  declinedIfRule,\n  declinedRule,\n  declinedUnlessRule,\n  declinedWithoutRule,\n} from \"../rules/scalar\";\nimport { PrimitiveValidator } from \"./primitive-validator\";\nimport { getRuleOptions } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Scalar validator class\n *\n * Core validator for scalar values (string, number, boolean).\n * Extends PrimitiveValidator (inherits enum/in/oneOf/allowsOnly/forbids/notIn)\n * and additionally provides type-coercion mutators and accepted/declined rules.\n *\n * Database methods (unique, exists, etc.) are injected by the framework\n */\nexport class ScalarValidator extends PrimitiveValidator {\n  public constructor(errorMessage?: string) {\n    super();\n    this.blankIsMissing = true;\n    this.addMutableRule(\n      {\n        name: \"scalar\",\n        defaultErrorMessage: \"The :input must be a scalar value\",\n        async validate(value, context) {\n          if ([\"string\", \"number\", \"boolean\"].includes(typeof value)) {\n            return VALID_RULE;\n          }\n          return invalidRule(this, context);\n        },\n      },\n      errorMessage,\n    );\n  }\n\n  /**\n   * Add matches type\n   */\n  public matchesType(value: any) {\n    return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\n  }\n\n  /**\n   * Mutate the scalar value to be number\n   */\n  public asNumber() {\n    return this.addMutator(numberMutator);\n  }\n\n  /**\n   * Mutate the scalar value to be string\n   */\n  public asString() {\n    return this.addMutator(stringMutator);\n  }\n\n  /**\n   * Accepted value\n   * The value will be valid if it equals 1 | \"1\" | true | \"true\" | \"yes\" | \"y\" | \"on\"\n   */\n  public accepted(errorMessage?: string) {\n    return this.addRule(acceptedRule, errorMessage);\n  }\n\n  /**\n   * Accepted value if another field's value equals to a specific value\n   */\n  public acceptedIf(field: string, value: any, errorMessage?: string) {\n    return this.addRule(acceptedIfRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Accepted value if another field's value is not equal to the given value\n   */\n  public acceptedUnless(field: string, value: any, errorMessage?: string) {\n    return this.addRule(acceptedUnlessRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Accepted value if another field is required\n   */\n  public acceptedIfRequired(field: string, errorMessage?: string) {\n    return this.addRule(acceptedIfRequiredRule, errorMessage, { field });\n  }\n\n  /**\n   * Accepted value if another field is present\n   */\n  public acceptedIfPresent(field: string, errorMessage?: string) {\n    return this.addRule(acceptedIfPresentRule, errorMessage, { field });\n  }\n\n  /**\n   * Accepted value if another field is missing\n   */\n  public acceptedWithout(field: string, errorMessage?: string) {\n    return this.addRule(acceptedWithoutRule, errorMessage, { field });\n  }\n\n  /**\n   * Declined value\n   * The value will be valid if it equals 0 | \"0\" | false | \"false\" | \"no\" | \"n\" | \"off\"\n   */\n  public declined(errorMessage?: string) {\n    return this.addRule(declinedRule, errorMessage);\n  }\n\n  /**\n   * Declined value if another field's value equals to a specific value\n   */\n  public declinedIf(field: string, value: any, errorMessage?: string) {\n    return this.addRule(declinedIfRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Declined value if another field's value is not equal to the given value\n   */\n  public declinedUnless(field: string, value: any, errorMessage?: string) {\n    return this.addRule(declinedUnlessRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Declined value if another field is required\n   */\n  public declinedIfRequired(field: string, errorMessage?: string) {\n    return this.addRule(declinedIfRequiredRule, errorMessage, { field });\n  }\n\n  /**\n   * Declined value if another field is present\n   */\n  public declinedIfPresent(field: string, errorMessage?: string) {\n    return this.addRule(declinedIfPresentRule, errorMessage, { field });\n  }\n\n  /**\n   * Declined value if another field is missing\n   */\n  public declinedWithout(field: string, errorMessage?: string) {\n    return this.addRule(declinedWithoutRule, errorMessage, { field });\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * A scalar accepts string | number | boolean. If `.in()` / `.enum()` is used,\n   * output collapses to a simple `enum` list instead.\n   *\n   * @example\n   * ```ts\n   * v.scalar().toJsonSchema(\"draft-2020-12\")\n   * // → { oneOf: [{ type: \"string\" }, { type: \"number\" }, { type: \"boolean\" }] }\n   *\n   * v.scalar().in([\"active\", \"inactive\"]).toJsonSchema(\"draft-2020-12\")\n   * // → { enum: [\"active\", \"inactive\"] }\n   * ```\n   */\n  public override toJsonSchema(_target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    // If a value set is constrained, collapse to enum\n    const inOpts = getRuleOptions(this.rules, \"in\");\n    if (inOpts?.values && Array.isArray(inOpts.values)) {\n      return { enum: inOpts.values };\n    }\n\n    const enumOpts = getRuleOptions(this.rules, \"enum\");\n    if (enumOpts?.enum && Array.isArray(enumOpts.enum)) {\n      return { enum: enumOpts.enum };\n    }\n\n    return {\n      oneOf: [\n        { type: \"string\" },\n        { type: \"number\" },\n        { type: \"boolean\" },\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,kBAAb,cAAqC,mBAAmB;CACtD,AAAO,YAAY,cAAuB;EACxC,MAAM;EACN,KAAK,iBAAiB;EACtB,KAAK,eACH;GACE,MAAM;GACN,qBAAqB;GACrB,MAAM,SAAS,OAAO,SAAS;IAC7B,IAAI;KAAC;KAAU;KAAU;IAAS,CAAC,CAAC,SAAS,OAAO,KAAK,GACvD,OAAO;IAET,OAAO,YAAY,MAAM,OAAO;GAClC;EACF,GACA,YACF;CACF;;;;CAKA,AAAO,YAAY,OAAY;EAC7B,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU;CACpF;;;;CAKA,AAAO,WAAW;EAChB,OAAO,KAAK,WAAW,aAAa;CACtC;;;;CAKA,AAAO,WAAW;EAChB,OAAO,KAAK,WAAW,aAAa;CACtC;;;;;CAMA,AAAO,SAAS,cAAuB;EACrC,OAAO,KAAK,QAAQ,cAAc,YAAY;CAChD;;;;CAKA,AAAO,WAAW,OAAe,OAAY,cAAuB;EAClE,OAAO,KAAK,QAAQ,gBAAgB,cAAc;GAAE;GAAO;EAAM,CAAC;CACpE;;;;CAKA,AAAO,eAAe,OAAe,OAAY,cAAuB;EACtE,OAAO,KAAK,QAAQ,oBAAoB,cAAc;GAAE;GAAO;EAAM,CAAC;CACxE;;;;CAKA,AAAO,mBAAmB,OAAe,cAAuB;EAC9D,OAAO,KAAK,QAAQ,wBAAwB,cAAc,EAAE,MAAM,CAAC;CACrE;;;;CAKA,AAAO,kBAAkB,OAAe,cAAuB;EAC7D,OAAO,KAAK,QAAQ,uBAAuB,cAAc,EAAE,MAAM,CAAC;CACpE;;;;CAKA,AAAO,gBAAgB,OAAe,cAAuB;EAC3D,OAAO,KAAK,QAAQ,qBAAqB,cAAc,EAAE,MAAM,CAAC;CAClE;;;;;CAMA,AAAO,SAAS,cAAuB;EACrC,OAAO,KAAK,QAAQ,cAAc,YAAY;CAChD;;;;CAKA,AAAO,WAAW,OAAe,OAAY,cAAuB;EAClE,OAAO,KAAK,QAAQ,gBAAgB,cAAc;GAAE;GAAO;EAAM,CAAC;CACpE;;;;CAKA,AAAO,eAAe,OAAe,OAAY,cAAuB;EACtE,OAAO,KAAK,QAAQ,oBAAoB,cAAc;GAAE;GAAO;EAAM,CAAC;CACxE;;;;CAKA,AAAO,mBAAmB,OAAe,cAAuB;EAC9D,OAAO,KAAK,QAAQ,wBAAwB,cAAc,EAAE,MAAM,CAAC;CACrE;;;;CAKA,AAAO,kBAAkB,OAAe,cAAuB;EAC7D,OAAO,KAAK,QAAQ,uBAAuB,cAAc,EAAE,MAAM,CAAC;CACpE;;;;CAKA,AAAO,gBAAgB,OAAe,cAAuB;EAC3D,OAAO,KAAK,QAAQ,qBAAqB,cAAc,EAAE,MAAM,CAAC;CAClE;;;;;;;;;;;;;;;;CAiBA,AAAgB,aAAa,UAA4B,iBAAmC;EAE1F,MAAM,SAAS,eAAe,KAAK,OAAO,IAAI;EAC9C,IAAI,QAAQ,UAAU,MAAM,QAAQ,OAAO,MAAM,GAC/C,OAAO,EAAE,MAAM,OAAO,OAAO;EAG/B,MAAM,WAAW,eAAe,KAAK,OAAO,MAAM;EAClD,IAAI,UAAU,QAAQ,MAAM,QAAQ,SAAS,IAAI,GAC/C,OAAO,EAAE,MAAM,SAAS,KAAK;EAG/B,OAAO,EACL,OAAO;GACL,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,UAAU;EACpB,EACF;CACF;AACF"}
+{"version":3,"file":"scalar-validator.mjs","names":[],"sources":["../../../../../../../../packages/seal/src/validators/scalar-validator.ts"],"sourcesContent":["import { invalidRule, VALID_RULE } from \"../helpers\";\nimport { numberMutator, stringMutator } from \"../mutators\";\nimport {\n  acceptedIfPresentRule,\n  acceptedIfRequiredRule,\n  acceptedIfRule,\n  acceptedRule,\n  acceptedUnlessRule,\n  acceptedWithoutRule,\n  declinedIfPresentRule,\n  declinedIfRequiredRule,\n  declinedIfRule,\n  declinedRule,\n  declinedUnlessRule,\n  declinedWithoutRule,\n} from \"../rules/scalar\";\nimport { PrimitiveValidator } from \"./primitive-validator\";\nimport { getRuleOptions } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Scalar validator class\n *\n * Core validator for scalar values (string, number, boolean).\n * Extends PrimitiveValidator (inherits enum/in/oneOf/allowsOnly/forbids/notIn)\n * and additionally provides type-coercion mutators and accepted/declined rules.\n *\n * Database methods (unique, exists, etc.) are injected by the framework\n */\nexport class ScalarValidator extends PrimitiveValidator {\n  public constructor(errorMessage?: string) {\n    super();\n    this.blankIsMissing = true;\n    this.addMutableRule(\n      {\n        name: \"scalar\",\n        defaultErrorMessage: \"The :input must be a scalar value\",\n        async validate(value, context) {\n          if ([\"string\", \"number\", \"boolean\"].includes(typeof value)) {\n            return VALID_RULE;\n          }\n          return invalidRule(this, context);\n        },\n      },\n      errorMessage,\n    );\n  }\n\n  /**\n   * Add matches type\n   */\n  public matchesType(value: any) {\n    return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\n  }\n\n  /**\n   * Mutate the scalar value to be number\n   */\n  public asNumber() {\n    return this.addMutator(numberMutator);\n  }\n\n  /**\n   * Mutate the scalar value to be string\n   */\n  public asString() {\n    return this.addMutator(stringMutator);\n  }\n\n  /**\n   * Accepted value\n   * The value will be valid if it equals 1 | \"1\" | true | \"true\" | \"yes\" | \"y\" | \"on\"\n   */\n  public accepted(errorMessage?: string) {\n    return this.addRule(acceptedRule, errorMessage);\n  }\n\n  /**\n   * Accepted value if another field's value equals to a specific value\n   */\n  public acceptedIf(field: string, value: any, errorMessage?: string) {\n    return this.addRule(acceptedIfRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Accepted value if another field's value is not equal to the given value\n   */\n  public acceptedUnless(field: string, value: any, errorMessage?: string) {\n    return this.addRule(acceptedUnlessRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Accepted value if another field is required\n   */\n  public acceptedIfRequired(field: string, errorMessage?: string) {\n    return this.addRule(acceptedIfRequiredRule, errorMessage, { field });\n  }\n\n  /**\n   * Accepted value if another field is present\n   */\n  public acceptedIfPresent(field: string, errorMessage?: string) {\n    return this.addRule(acceptedIfPresentRule, errorMessage, { field });\n  }\n\n  /**\n   * Accepted value if another field is missing\n   */\n  public acceptedWithout(field: string, errorMessage?: string) {\n    return this.addRule(acceptedWithoutRule, errorMessage, { field });\n  }\n\n  /**\n   * Declined value\n   * The value will be valid if it equals 0 | \"0\" | false | \"false\" | \"no\" | \"n\" | \"off\"\n   */\n  public declined(errorMessage?: string) {\n    return this.addRule(declinedRule, errorMessage);\n  }\n\n  /**\n   * Declined value if another field's value equals to a specific value\n   */\n  public declinedIf(field: string, value: any, errorMessage?: string) {\n    return this.addRule(declinedIfRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Declined value if another field's value is not equal to the given value\n   */\n  public declinedUnless(field: string, value: any, errorMessage?: string) {\n    return this.addRule(declinedUnlessRule, errorMessage, { field, value });\n  }\n\n  /**\n   * Declined value if another field is required\n   */\n  public declinedIfRequired(field: string, errorMessage?: string) {\n    return this.addRule(declinedIfRequiredRule, errorMessage, { field });\n  }\n\n  /**\n   * Declined value if another field is present\n   */\n  public declinedIfPresent(field: string, errorMessage?: string) {\n    return this.addRule(declinedIfPresentRule, errorMessage, { field });\n  }\n\n  /**\n   * Declined value if another field is missing\n   */\n  public declinedWithout(field: string, errorMessage?: string) {\n    return this.addRule(declinedWithoutRule, errorMessage, { field });\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * A scalar accepts string | number | boolean. If `.in()` / `.enum()` is used,\n   * output collapses to a simple `enum` list instead.\n   *\n   * @example\n   * ```ts\n   * v.scalar().toJsonSchema(\"draft-2020-12\")\n   * // → { oneOf: [{ type: \"string\" }, { type: \"number\" }, { type: \"boolean\" }] }\n   *\n   * v.scalar().in([\"active\", \"inactive\"]).toJsonSchema(\"draft-2020-12\")\n   * // → { enum: [\"active\", \"inactive\"] }\n   * ```\n   */\n  public override toJsonSchema(_target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    // If a value set is constrained, collapse to enum\n    const inOpts = getRuleOptions(this.rules, \"in\");\n    if (inOpts?.values && Array.isArray(inOpts.values)) {\n      return { enum: inOpts.values };\n    }\n\n    const enumOpts = getRuleOptions(this.rules, \"enum\");\n    if (enumOpts?.enum && Array.isArray(enumOpts.enum)) {\n      return { enum: enumOpts.enum };\n    }\n\n    return {\n      oneOf: [\n        { type: \"string\" },\n        { type: \"number\" },\n        { type: \"boolean\" },\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,kBAAb,cAAqC,mBAAmB;CACtD,AAAO,YAAY,cAAuB;EACxC,MAAM;EACN,KAAK,iBAAiB;EACtB,KAAK,eACH;GACE,MAAM;GACN,qBAAqB;GACrB,MAAM,SAAS,OAAO,SAAS;IAC7B,IAAI;KAAC;KAAU;KAAU;IAAS,CAAC,CAAC,SAAS,OAAO,KAAK,GACvD,OAAO;IAET,OAAO,YAAY,MAAM,OAAO;GAClC;EACF,GACA,YACF;CACF;;;;CAKA,AAAO,YAAY,OAAY;EAC7B,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU;CACpF;;;;CAKA,AAAO,WAAW;EAChB,OAAO,KAAK,WAAW,aAAa;CACtC;;;;CAKA,AAAO,WAAW;EAChB,OAAO,KAAK,WAAW,aAAa;CACtC;;;;;CAMA,AAAO,SAAS,cAAuB;EACrC,OAAO,KAAK,QAAQ,cAAc,YAAY;CAChD;;;;CAKA,AAAO,WAAW,OAAe,OAAY,cAAuB;EAClE,OAAO,KAAK,QAAQ,gBAAgB,cAAc;GAAE;GAAO;EAAM,CAAC;CACpE;;;;CAKA,AAAO,eAAe,OAAe,OAAY,cAAuB;EACtE,OAAO,KAAK,QAAQ,oBAAoB,cAAc;GAAE;GAAO;EAAM,CAAC;CACxE;;;;CAKA,AAAO,mBAAmB,OAAe,cAAuB;EAC9D,OAAO,KAAK,QAAQ,wBAAwB,cAAc,EAAE,MAAM,CAAC;CACrE;;;;CAKA,AAAO,kBAAkB,OAAe,cAAuB;EAC7D,OAAO,KAAK,QAAQ,uBAAuB,cAAc,EAAE,MAAM,CAAC;CACpE;;;;CAKA,AAAO,gBAAgB,OAAe,cAAuB;EAC3D,OAAO,KAAK,QAAQ,qBAAqB,cAAc,EAAE,MAAM,CAAC;CAClE;;;;;CAMA,AAAO,SAAS,cAAuB;EACrC,OAAO,KAAK,QAAQ,cAAc,YAAY;CAChD;;;;CAKA,AAAO,WAAW,OAAe,OAAY,cAAuB;EAClE,OAAO,KAAK,QAAQ,gBAAgB,cAAc;GAAE;GAAO;EAAM,CAAC;CACpE;;;;CAKA,AAAO,eAAe,OAAe,OAAY,cAAuB;EACtE,OAAO,KAAK,QAAQ,oBAAoB,cAAc;GAAE;GAAO;EAAM,CAAC;CACxE;;;;CAKA,AAAO,mBAAmB,OAAe,cAAuB;EAC9D,OAAO,KAAK,QAAQ,wBAAwB,cAAc,EAAE,MAAM,CAAC;CACrE;;;;CAKA,AAAO,kBAAkB,OAAe,cAAuB;EAC7D,OAAO,KAAK,QAAQ,uBAAuB,cAAc,EAAE,MAAM,CAAC;CACpE;;;;CAKA,AAAO,gBAAgB,OAAe,cAAuB;EAC3D,OAAO,KAAK,QAAQ,qBAAqB,cAAc,EAAE,MAAM,CAAC;CAClE;;;;;;;;;;;;;;;;CAiBA,AAAgB,aAAa,UAA4B,iBAAmC;EAE1F,MAAM,SAAS,eAAe,KAAK,OAAO,IAAI;EAC9C,IAAI,QAAQ,UAAU,MAAM,QAAQ,OAAO,MAAM,GAC/C,OAAO,EAAE,MAAM,OAAO,OAAO;EAG/B,MAAM,WAAW,eAAe,KAAK,OAAO,MAAM;EAClD,IAAI,UAAU,QAAQ,MAAM,QAAQ,SAAS,IAAI,GAC/C,OAAO,EAAE,MAAM,SAAS,KAAK;EAG/B,OAAO,EACL,OAAO;GACL,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,UAAU;EACpB,EACF;CACF;AACF"}

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

@@ -2,7 +2,7 @@ import { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-sche
 import { PrimitiveValidator } from "./primitive-validator.mjs";
 import { UUIDVersion } from "../rules/string/id-formats.mjs";
 
-//#region ../seal/src/validators/string-validator.d.ts
+//#region ../../packages/seal/src/validators/string-validator.d.ts
 /**
  * String validator class
  */

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":["../../../../../../../../packages/seal/src/validators/string-validator.ts"],"mappings":"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"}

package/esm/validators/string-validator.mjs

@@ -17,7 +17,7 @@ import "../rules/color/index.mjs";
 import { stringRule } from "../rules/common/type-rules.mjs";
 import { PrimitiveValidator } from "./primitive-validator.mjs";
 
-//#region ../seal/src/validators/string-validator.ts
+//#region ../../packages/seal/src/validators/string-validator.ts
 /**
 * String validator class
 */

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

package/esm/validators/tuple-validator.d.mts

@@ -3,7 +3,7 @@ import { SchemaContext } from "../types/context-types.mjs";
 import { ValidationResult } from "../types/result-types.mjs";
 import { BaseValidator } from "./base-validator.mjs";
 
-//#region ../seal/src/validators/tuple-validator.d.ts
+//#region ../../packages/seal/src/validators/tuple-validator.d.ts
 /**
  * Tuple validator class - validates fixed-length arrays with position-specific types
  *

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

@@ -1 +1 @@
-{"version":3,"file":"tuple-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/tuple-validator.ts"],"mappings":";;;;;;;;;;AAsBA;;;;;;;;;;;cAAa,cAAA,SAAuB,aAAA;EAEzB,UAAA,EAAY,aAAA;cAAZ,UAAA,EAAY,aAAA,IACnB,YAAA;EADO;;;EAUF,WAAA,CAAY,KAAA;EAVV;;;EAiBO,KAAA;EAAA;;;;;;;;EAcH,QAAA,CAAS,IAAA,OAAW,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,gBAAA;EAgFrC;;;AAA6D;;;;;;;;;;;;;;;;;EAA1E,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"tuple-validator.d.mts","names":[],"sources":["../../../../../../../../packages/seal/src/validators/tuple-validator.ts"],"mappings":";;;;;;;;;AAsBA;;;;;;;;;;;;cAAa,cAAA,SAAuB,aAAA;EAEzB,UAAA,EAAY,aAAA;cAAZ,UAAA,EAAY,aAAA,IACnB,YAAA;EADmB;;;EAUd,WAAA,CAAY,KAAA;EATjB;;;EAgBc,KAAA;EAcH;;;;;;;;EAAA,QAAA,CAAS,IAAA,OAAW,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,gBAAA;EAgFQ;;AAAgB;;;;;;;;;;;;;;;;;;EAA1E,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/validators/tuple-validator.mjs

@@ -5,7 +5,7 @@ import { BaseValidator } from "./base-validator.mjs";
 import { arrayRule } from "../rules/common/type-rules.mjs";
 import "../rules/index.mjs";
 
-//#region ../seal/src/validators/tuple-validator.ts
+//#region ../../packages/seal/src/validators/tuple-validator.ts
 /**
 * Tuple validator class - validates fixed-length arrays with position-specific types
 *

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

@@ -1 +1 @@
-{"version":3,"file":"tuple-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/tuple-validator.ts"],"sourcesContent":["import { setKeyPath } from \"../helpers\";\nimport { arrayRule } from \"../rules\";\nimport type { SchemaContext, ValidationResult } from \"../types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { applyNullable } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Tuple validator class - validates fixed-length arrays with position-specific types\n *\n * @example\n * ```ts\n * // RGB color tuple\n * v.tuple([v.number(), v.number(), v.number()])\n * // Valid: [255, 128, 0]\n * // Invalid: [255, 128] (too short)\n *\n * // Mixed types\n * v.tuple([v.string(), v.int(), v.boolean()])\n * // Valid: [\"John\", 25, true]\n * ```\n */\nexport class TupleValidator extends BaseValidator {\n  public constructor(\n    public validators: BaseValidator[],\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(arrayRule, errorMessage);\n  }\n\n  /**\n   * Check if value is an array type\n   */\n  public matchesType(value: any): boolean {\n    return Array.isArray(value);\n  }\n\n  /**\n   * Clone the validator\n   */\n  public override clone(): this {\n    const cloned = super.clone();\n    cloned.validators = this.validators.map((v) => v.clone());\n    return cloned;\n  }\n\n  /**\n   * Validate tuple - check length then validate each position\n   *\n   * Absent input (and absent without `.default()`) propagates as `data: undefined`\n   * so the parent ObjectValidator can omit the key. Without this, optional tuple\n   * fields would silently materialise as `[]` in the validated output and then\n   * fail the length check.\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    // Apply default when absent, then mutate. Mirrors BaseValidator's\n    // `valueForRules = data ?? this.getDefaultValue()` so `.default([...])`\n    // works on tuples too.\n    const valueForRules = data ?? this.getDefaultValue();\n    const mutatedData = await this.mutate(valueForRules, context);\n\n    const result = await super.validate(data, context);\n\n    if (result.isValid === false) return result;\n\n    // Nothing to iterate for absent (no default) or null (nullable) inputs —\n    // propagate so the parent ObjectValidator can omit the key.\n    if (mutatedData === undefined || mutatedData === null) return result;\n\n    // Defensive: type rule (arrayRule) should have failed for non-arrays.\n    if (!Array.isArray(mutatedData)) return result;\n\n    const errors: ValidationResult[\"errors\"] = [];\n\n    // Tuple-specific: length validation\n    if (mutatedData.length !== this.validators.length) {\n      errors.push({\n        type: \"tuple\",\n        input: context.key || \"value\",\n        error: `Expected exactly ${this.validators.length} items, but got ${mutatedData.length}`,\n      });\n      return { isValid: false, errors, data: mutatedData };\n    }\n\n    // Validate each position with its specific validator in parallel\n    const validationPromises = this.validators.map(async (validator, index) => {\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value: mutatedData[index],\n        key: index.toString(),\n        path: setKeyPath(context.path, index.toString()),\n      };\n\n      const childResult = await validator.validate(mutatedData[index], childContext);\n\n      // Update mutated data with validated result\n      mutatedData[index] = childResult.data;\n\n      // Collect errors from this element\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n      data: await this.startTransformationPipeline(mutatedData, context),\n    };\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Tuple keyword diverges between targets:\n   * - `draft-2020-12` → `prefixItems` + `items: false` (exact length enforced)\n   * - `draft-07`      → `items` as array + `additionalItems: false`\n   * - `openapi-3.0`   → same as draft-07 (OpenAPI 3.0 is based on draft-07)\n   *\n   * @example\n   * ```ts\n   * v.tuple([v.string(), v.int(), v.boolean()]).toJsonSchema(\"draft-2020-12\")\n   * // → {\n   * //   type: \"array\",\n   * //   prefixItems: [{ type: \"string\" }, { type: \"integer\" }, { type: \"boolean\" }],\n   * //   items: false,\n   * //   minItems: 3,\n   * //   maxItems: 3\n   * // }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const itemSchemas = this.validators.map(v => v.toJsonSchema(target));\n    const length = this.validators.length;\n\n    const schema: JsonSchemaResult = {\n      type: \"array\",\n      minItems: length,\n      maxItems: length,\n    };\n\n    if (target === \"draft-2020-12\") {\n      // prefixItems is the draft-2020-12 keyword for positional tuple items\n      schema.prefixItems = itemSchemas;\n      schema.items = false; // no additional items beyond the tuple\n    } else {\n      // draft-07 and openapi-3.0: items as array + additionalItems: false\n      schema.items = itemSchemas;\n      schema.additionalItems = false;\n    }\n\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,iBAAb,cAAoC,cAAc;CAChD,AAAO,YACL,AAAO,YACP,cACA;EACA,MAAM;EAHC;EAIP,KAAK,eAAe,WAAW,YAAY;CAC7C;;;;CAKA,AAAO,YAAY,OAAqB;EACtC,OAAO,MAAM,QAAQ,KAAK;CAC5B;;;;CAKA,AAAgB,QAAc;EAC5B,MAAM,SAAS,MAAM,MAAM;EAC3B,OAAO,aAAa,KAAK,WAAW,KAAK,MAAM,EAAE,MAAM,CAAC;EACxD,OAAO;CACT;;;;;;;;;CAUA,MAAa,SAAS,MAAW,SAAmD;EAIlF,MAAM,gBAAgB,QAAQ,KAAK,gBAAgB;EACnD,MAAM,cAAc,MAAM,KAAK,OAAO,eAAe,OAAO;EAE5D,MAAM,SAAS,MAAM,MAAM,SAAS,MAAM,OAAO;EAEjD,IAAI,OAAO,YAAY,OAAO,OAAO;EAIrC,IAAI,gBAAgB,UAAa,gBAAgB,MAAM,OAAO;EAG9D,IAAI,CAAC,MAAM,QAAQ,WAAW,GAAG,OAAO;EAExC,MAAM,SAAqC,CAAC;EAG5C,IAAI,YAAY,WAAW,KAAK,WAAW,QAAQ;GACjD,OAAO,KAAK;IACV,MAAM;IACN,OAAO,QAAQ,OAAO;IACtB,OAAO,oBAAoB,KAAK,WAAW,OAAO,kBAAkB,YAAY;GAClF,CAAC;GACD,OAAO;IAAE,SAAS;IAAO;IAAQ,MAAM;GAAY;EACrD;EAGA,MAAM,qBAAqB,KAAK,WAAW,IAAI,OAAO,WAAW,UAAU;GACzE,MAAM,eAA8B;IAClC,GAAG;IACH,QAAQ;IACR,OAAO,YAAY;IACnB,KAAK,MAAM,SAAS;IACpB,MAAM,WAAW,QAAQ,MAAM,MAAM,SAAS,CAAC;GACjD;GAEA,MAAM,cAAc,MAAM,UAAU,SAAS,YAAY,QAAQ,YAAY;GAG7E,YAAY,SAAS,YAAY;GAGjC,IAAI,YAAY,YAAY,OAC1B,OAAO,KAAK,GAAG,YAAY,MAAM;EAErC,CAAC;EAED,MAAM,QAAQ,IAAI,kBAAkB;EAEpC,OAAO;GACL,SAAS,OAAO,WAAW;GAC3B;GACA,MAAM,MAAM,KAAK,4BAA4B,aAAa,OAAO;EACnE;CACF;;;;;;;;;;;;;;;;;;;;;CAsBA,AAAgB,aAAa,SAA2B,iBAAmC;EACzF,MAAM,cAAc,KAAK,WAAW,KAAI,MAAK,EAAE,aAAa,MAAM,CAAC;EACnE,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,SAA2B;GAC/B,MAAM;GACN,UAAU;GACV,UAAU;EACZ;EAEA,IAAI,WAAW,iBAAiB;GAE9B,OAAO,cAAc;GACrB,OAAO,QAAQ;EACjB,OAAO;GAEL,OAAO,QAAQ;GACf,OAAO,kBAAkB;EAC3B;EAEA,IAAI,KAAK,YAAY,cAAc,QAAQ,MAAM;EAEjD,OAAO;CACT;AACF"}
+{"version":3,"file":"tuple-validator.mjs","names":[],"sources":["../../../../../../../../packages/seal/src/validators/tuple-validator.ts"],"sourcesContent":["import { setKeyPath } from \"../helpers\";\nimport { arrayRule } from \"../rules\";\nimport type { SchemaContext, ValidationResult } from \"../types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { applyNullable } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Tuple validator class - validates fixed-length arrays with position-specific types\n *\n * @example\n * ```ts\n * // RGB color tuple\n * v.tuple([v.number(), v.number(), v.number()])\n * // Valid: [255, 128, 0]\n * // Invalid: [255, 128] (too short)\n *\n * // Mixed types\n * v.tuple([v.string(), v.int(), v.boolean()])\n * // Valid: [\"John\", 25, true]\n * ```\n */\nexport class TupleValidator extends BaseValidator {\n  public constructor(\n    public validators: BaseValidator[],\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(arrayRule, errorMessage);\n  }\n\n  /**\n   * Check if value is an array type\n   */\n  public matchesType(value: any): boolean {\n    return Array.isArray(value);\n  }\n\n  /**\n   * Clone the validator\n   */\n  public override clone(): this {\n    const cloned = super.clone();\n    cloned.validators = this.validators.map((v) => v.clone());\n    return cloned;\n  }\n\n  /**\n   * Validate tuple - check length then validate each position\n   *\n   * Absent input (and absent without `.default()`) propagates as `data: undefined`\n   * so the parent ObjectValidator can omit the key. Without this, optional tuple\n   * fields would silently materialise as `[]` in the validated output and then\n   * fail the length check.\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    // Apply default when absent, then mutate. Mirrors BaseValidator's\n    // `valueForRules = data ?? this.getDefaultValue()` so `.default([...])`\n    // works on tuples too.\n    const valueForRules = data ?? this.getDefaultValue();\n    const mutatedData = await this.mutate(valueForRules, context);\n\n    const result = await super.validate(data, context);\n\n    if (result.isValid === false) return result;\n\n    // Nothing to iterate for absent (no default) or null (nullable) inputs —\n    // propagate so the parent ObjectValidator can omit the key.\n    if (mutatedData === undefined || mutatedData === null) return result;\n\n    // Defensive: type rule (arrayRule) should have failed for non-arrays.\n    if (!Array.isArray(mutatedData)) return result;\n\n    const errors: ValidationResult[\"errors\"] = [];\n\n    // Tuple-specific: length validation\n    if (mutatedData.length !== this.validators.length) {\n      errors.push({\n        type: \"tuple\",\n        input: context.key || \"value\",\n        error: `Expected exactly ${this.validators.length} items, but got ${mutatedData.length}`,\n      });\n      return { isValid: false, errors, data: mutatedData };\n    }\n\n    // Validate each position with its specific validator in parallel\n    const validationPromises = this.validators.map(async (validator, index) => {\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value: mutatedData[index],\n        key: index.toString(),\n        path: setKeyPath(context.path, index.toString()),\n      };\n\n      const childResult = await validator.validate(mutatedData[index], childContext);\n\n      // Update mutated data with validated result\n      mutatedData[index] = childResult.data;\n\n      // Collect errors from this element\n      if (childResult.isValid === false) {\n        errors.push(...childResult.errors);\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n      data: await this.startTransformationPipeline(mutatedData, context),\n    };\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Tuple keyword diverges between targets:\n   * - `draft-2020-12` → `prefixItems` + `items: false` (exact length enforced)\n   * - `draft-07`      → `items` as array + `additionalItems: false`\n   * - `openapi-3.0`   → same as draft-07 (OpenAPI 3.0 is based on draft-07)\n   *\n   * @example\n   * ```ts\n   * v.tuple([v.string(), v.int(), v.boolean()]).toJsonSchema(\"draft-2020-12\")\n   * // → {\n   * //   type: \"array\",\n   * //   prefixItems: [{ type: \"string\" }, { type: \"integer\" }, { type: \"boolean\" }],\n   * //   items: false,\n   * //   minItems: 3,\n   * //   maxItems: 3\n   * // }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const itemSchemas = this.validators.map(v => v.toJsonSchema(target));\n    const length = this.validators.length;\n\n    const schema: JsonSchemaResult = {\n      type: \"array\",\n      minItems: length,\n      maxItems: length,\n    };\n\n    if (target === \"draft-2020-12\") {\n      // prefixItems is the draft-2020-12 keyword for positional tuple items\n      schema.prefixItems = itemSchemas;\n      schema.items = false; // no additional items beyond the tuple\n    } else {\n      // draft-07 and openapi-3.0: items as array + additionalItems: false\n      schema.items = itemSchemas;\n      schema.additionalItems = false;\n    }\n\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,iBAAb,cAAoC,cAAc;CAChD,AAAO,YACL,AAAO,YACP,cACA;EACA,MAAM;EAHC;EAIP,KAAK,eAAe,WAAW,YAAY;CAC7C;;;;CAKA,AAAO,YAAY,OAAqB;EACtC,OAAO,MAAM,QAAQ,KAAK;CAC5B;;;;CAKA,AAAgB,QAAc;EAC5B,MAAM,SAAS,MAAM,MAAM;EAC3B,OAAO,aAAa,KAAK,WAAW,KAAK,MAAM,EAAE,MAAM,CAAC;EACxD,OAAO;CACT;;;;;;;;;CAUA,MAAa,SAAS,MAAW,SAAmD;EAIlF,MAAM,gBAAgB,QAAQ,KAAK,gBAAgB;EACnD,MAAM,cAAc,MAAM,KAAK,OAAO,eAAe,OAAO;EAE5D,MAAM,SAAS,MAAM,MAAM,SAAS,MAAM,OAAO;EAEjD,IAAI,OAAO,YAAY,OAAO,OAAO;EAIrC,IAAI,gBAAgB,UAAa,gBAAgB,MAAM,OAAO;EAG9D,IAAI,CAAC,MAAM,QAAQ,WAAW,GAAG,OAAO;EAExC,MAAM,SAAqC,CAAC;EAG5C,IAAI,YAAY,WAAW,KAAK,WAAW,QAAQ;GACjD,OAAO,KAAK;IACV,MAAM;IACN,OAAO,QAAQ,OAAO;IACtB,OAAO,oBAAoB,KAAK,WAAW,OAAO,kBAAkB,YAAY;GAClF,CAAC;GACD,OAAO;IAAE,SAAS;IAAO;IAAQ,MAAM;GAAY;EACrD;EAGA,MAAM,qBAAqB,KAAK,WAAW,IAAI,OAAO,WAAW,UAAU;GACzE,MAAM,eAA8B;IAClC,GAAG;IACH,QAAQ;IACR,OAAO,YAAY;IACnB,KAAK,MAAM,SAAS;IACpB,MAAM,WAAW,QAAQ,MAAM,MAAM,SAAS,CAAC;GACjD;GAEA,MAAM,cAAc,MAAM,UAAU,SAAS,YAAY,QAAQ,YAAY;GAG7E,YAAY,SAAS,YAAY;GAGjC,IAAI,YAAY,YAAY,OAC1B,OAAO,KAAK,GAAG,YAAY,MAAM;EAErC,CAAC;EAED,MAAM,QAAQ,IAAI,kBAAkB;EAEpC,OAAO;GACL,SAAS,OAAO,WAAW;GAC3B;GACA,MAAM,MAAM,KAAK,4BAA4B,aAAa,OAAO;EACnE;CACF;;;;;;;;;;;;;;;;;;;;;CAsBA,AAAgB,aAAa,SAA2B,iBAAmC;EACzF,MAAM,cAAc,KAAK,WAAW,KAAI,MAAK,EAAE,aAAa,MAAM,CAAC;EACnE,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,SAA2B;GAC/B,MAAM;GACN,UAAU;GACV,UAAU;EACZ;EAEA,IAAI,WAAW,iBAAiB;GAE9B,OAAO,cAAc;GACrB,OAAO,QAAQ;EACjB,OAAO;GAEL,OAAO,QAAQ;GACf,OAAO,kBAAkB;EAC3B;EAEA,IAAI,KAAK,YAAY,cAAc,QAAQ,MAAM;EAEjD,OAAO;CACT;AACF"}

package/esm/validators/union-validator.d.mts

@@ -1,7 +1,7 @@
 import { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema.mjs";
 import { BaseValidator } from "./base-validator.mjs";
 
-//#region ../seal/src/validators/union-validator.d.ts
+//#region ../../packages/seal/src/validators/union-validator.d.ts
 /**
  * Union validator class - validates value against multiple validator types
  *

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

@@ -1 +1 @@
-{"version":3,"file":"union-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/union-validator.ts"],"mappings":";;;;;;AA6BA;;;;;;;;;;;;;;;;;;;AA6B4F;;;cA7B/E,cAAA,SAAuB,aAAA;;;;;;;;;;;;;;EAc3B,KAAA,CAAM,UAAA,EAAY,aAAA,IAAiB,YAAA;;;;;;;;;;;;EAe1B,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"union-validator.d.mts","names":[],"sources":["../../../../../../../../packages/seal/src/validators/union-validator.ts"],"mappings":";;;;;;AA6BA;;;;;;;;;;;;;;;;;;;AA6B4F;;;cA7B/E,cAAA,SAAuB,aAAA;;;;;;;;;;;;;;EAc3B,KAAA,CAAM,UAAA,EAAY,aAAA,IAAiB,YAAA;;;;;;;;;;;;EAe1B,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/validators/union-validator.mjs

@@ -3,7 +3,7 @@ import { BaseValidator } from "./base-validator.mjs";
 import { unionRule } from "../rules/core/union.mjs";
 import "../rules/index.mjs";
 
-//#region ../seal/src/validators/union-validator.ts
+//#region ../../packages/seal/src/validators/union-validator.ts
 /**
 * Union validator class - validates value against multiple validator types
 *

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

@@ -1 +1 @@
-{"version":3,"file":"union-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/union-validator.ts"],"sourcesContent":["import { unionRule } from \"../rules\";\nimport { BaseValidator } from \"./base-validator\";\nimport { getRuleOptions } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Union validator class - validates value against multiple validator types\n *\n * Tries each validator in order until one passes. If a validator's matchesType()\n * returns false, it's skipped for optimization. First validator that both matches\n * the type and passes validation wins.\n *\n * @example\n * ```ts\n * // Accept email or username\n * const identifier = v.union([\n *   v.string().email(),\n *   v.string().alphanumeric().min(3).max(20)\n * ]);\n *\n * // Accept different types\n * const customValue = v.union([\n *   v.string().required(),\n *   v.number().required(),\n *   v.boolean().required(),\n *   v.file().required()\n * ]);\n * ```\n */\nexport class UnionValidator extends BaseValidator {\n  /**\n   * Set the validators to try for union validation\n   *\n   * @param validators - Array of validators to try\n   * @param errorMessage - Optional custom error message if all validators fail\n   * @returns This validator for chaining\n   *\n   * @example\n   * ```ts\n   * new UnionValidator()\n   *   .union([v.string(), v.number()], 'Must be string or number');\n   * ```\n   */\n  public union(validators: BaseValidator[], errorMessage?: string) {\n    return this.addRule(unionRule, errorMessage, { validators });\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Generates `{ oneOf: [...] }` by mapping each sub-validator to its JSON Schema.\n   *\n   * @example\n   * ```ts\n   * v.union([v.string(), v.number()]).toJsonSchema(\"draft-2020-12\")\n   * // → { oneOf: [{ type: \"string\" }, { type: \"number\" }] }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const opts = getRuleOptions(this.rules, \"union\");\n    const validators = (opts?.validators ?? []) as BaseValidator[];\n\n    return {\n      oneOf: validators.map(v => v.toJsonSchema(target)),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,iBAAb,cAAoC,cAAc;;;;;;;;;;;;;;CAchD,AAAO,MAAM,YAA6B,cAAuB;EAC/D,OAAO,KAAK,QAAQ,WAAW,cAAc,EAAE,WAAW,CAAC;CAC7D;;;;;;;;;;;;CAaA,AAAgB,aAAa,SAA2B,iBAAmC;EAIzF,OAAO,EACL,QAJW,eAAe,KAAK,OAAO,OACjB,CAAC,EAAE,cAAc,CAAC,EAGtB,CAAC,KAAI,MAAK,EAAE,aAAa,MAAM,CAAC,EACnD;CACF;AACF"}
+{"version":3,"file":"union-validator.mjs","names":[],"sources":["../../../../../../../../packages/seal/src/validators/union-validator.ts"],"sourcesContent":["import { unionRule } from \"../rules\";\nimport { BaseValidator } from \"./base-validator\";\nimport { getRuleOptions } from \"../standard-schema/json-schema\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Union validator class - validates value against multiple validator types\n *\n * Tries each validator in order until one passes. If a validator's matchesType()\n * returns false, it's skipped for optimization. First validator that both matches\n * the type and passes validation wins.\n *\n * @example\n * ```ts\n * // Accept email or username\n * const identifier = v.union([\n *   v.string().email(),\n *   v.string().alphanumeric().min(3).max(20)\n * ]);\n *\n * // Accept different types\n * const customValue = v.union([\n *   v.string().required(),\n *   v.number().required(),\n *   v.boolean().required(),\n *   v.file().required()\n * ]);\n * ```\n */\nexport class UnionValidator extends BaseValidator {\n  /**\n   * Set the validators to try for union validation\n   *\n   * @param validators - Array of validators to try\n   * @param errorMessage - Optional custom error message if all validators fail\n   * @returns This validator for chaining\n   *\n   * @example\n   * ```ts\n   * new UnionValidator()\n   *   .union([v.string(), v.number()], 'Must be string or number');\n   * ```\n   */\n  public union(validators: BaseValidator[], errorMessage?: string) {\n    return this.addRule(unionRule, errorMessage, { validators });\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Generates `{ oneOf: [...] }` by mapping each sub-validator to its JSON Schema.\n   *\n   * @example\n   * ```ts\n   * v.union([v.string(), v.number()]).toJsonSchema(\"draft-2020-12\")\n   * // → { oneOf: [{ type: \"string\" }, { type: \"number\" }] }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const opts = getRuleOptions(this.rules, \"union\");\n    const validators = (opts?.validators ?? []) as BaseValidator[];\n\n    return {\n      oneOf: validators.map(v => v.toJsonSchema(target)),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,iBAAb,cAAoC,cAAc;;;;;;;;;;;;;;CAchD,AAAO,MAAM,YAA6B,cAAuB;EAC/D,OAAO,KAAK,QAAQ,WAAW,cAAc,EAAE,WAAW,CAAC;CAC7D;;;;;;;;;;;;CAaA,AAAgB,aAAa,SAA2B,iBAAmC;EAIzF,OAAO,EACL,QAJW,eAAe,KAAK,OAAO,OACjB,CAAC,EAAE,cAAc,CAAC,EAGtB,CAAC,KAAI,MAAK,EAAE,aAAa,MAAM,CAAC,EACnD;CACF;AACF"}

package/llms-full.txt

@@ -1171,14 +1171,12 @@ description: 'Read `ValidationResult` — `isValid`, `errors[]`, `data`. Branch
 
 # `ValidationResult` — reading errors
 
-`validate(schema, data)` never throws. It returns a `ValidationResult`:
+`validate(schema, data)` never throws. It returns a result narrowed on `isValid`:
 
 ```ts
-type ValidationResult = {
-  isValid: boolean;
-  data: any;             // shape after mutators + transformers (the validated value)
-  errors: ValidationError[];
-};
+type TypedValidationResult<TData> =
+  | { isValid: true; data: TData; errors: ValidationError[] }   // TData = Infer.Output<typeof schema>
+  | { isValid: false; data: undefined; errors: ValidationError[] };
 
 type ValidationError = {
   type: string;          // rule type that failed — "required", "email", "min", "string", ...
@@ -1475,6 +1473,10 @@ That distinction matters wherever "empty" and "absent" mean different things —
 Before 4.9.2 `v.literal("")` always failed with *"is required"*, and `.optional()` looked like a workaround while actually disabling the literal check — accepting `""`, `null`, and a missing key alike. `v.literal(0)` and `v.literal(false)` were never affected.
 :::
 
+:::note[Fixed again in 5.30]
+5.25 made a blank form value count as missing for literal and enum sets, so an unselected `<select>` reads as absent. That rule also caught `v.literal("")` from 5.25 to 5.29: the required literal rejected `""` and `.optional()` dropped it from the data. Since 5.30 a literal set that lists a blank string keeps `""` as a value in its default (implicit) required state and under `.present()`, `.optional()` and `.nullable()`; a set without one still reads a blank value as missing. An explicit `.required()` (or `requiredIf` and the other conditional rules) puts back the strict non-empty rule and rejects `""` — leave the default state in place when `""` is a valid value.
+:::
+
 `v.instanceof(Ctor)` for File/Buffer/Uint8Array/custom classes. Returns `{}` from `toJsonSchema()` (not representable). For OpenAPI `File`, attach `{ type: "string", format: "binary" }` manually after generation.
 
 ## `v.any` — escape hatch
@@ -2218,7 +2220,7 @@ The 12 things that are true in every seal use:
 2. **Every factory return is a `StandardSchemaV1<Infer.Output<T>>`.** Pass seal schemas straight into `StandardSchemaV1<T>`-typed slots — no casts.
 3. **Two inference helpers — `Infer.Input<T>` and `Infer.Output<T>`.** Bare `Infer<T>` is an alias for `Infer.Input<T>` (the dominant usage: HTTP bodies, DTOs, form payloads). Use `Infer.Output<T>` for validated state (Cascade `Model<>` params, post-`validate()` data). See [the rules below](#inferinput-vs-inferoutput).
 4. **Fields are required by default.** Mark optional explicitly: `.optional()`. Skip `.required()` — canonical seal style omits the redundant call; inferred types already show what's required.
-5. **`validate(schema, data)` never throws.** Returns `Promise<ValidationResult>` with `{ isValid, data, errors }` — the validated value is `result.data`. See the `handle-seal-errors` topic.
+5. **`validate(schema, data)` never throws.** Returns `{ isValid, data, errors }`, narrowed on `isValid`: on success `data` is `Infer.Output<typeof schema>`, on failure it is `undefined` (a bare `BaseValidator`/`ObjectValidator` annotation keeps `data: any`). See the `handle-seal-errors` topic.
 6. **Validators are immutable by default.** Every chain method (`.min(3)`, `.email()`, `.optional()`, …) returns a clone. Toggle with the `.mutable` getter.
 7. **Two pipelines: mutators (pre-validation), transformers (post-validation).** Order: `default → mutators → required check → required-condition rule → other rules → transformers → data`. `.catch(fallback)` rescues any failure on leaf validators.
 8. **Cross-field rules need a `v.object` parent.** Standalone scalar validators have no siblings to resolve against.

package/package.json

@@ -11,7 +11,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/warlockjs/seal"
+    "url": "git+https://github.com/warlockjs/framework.git",
+    "directory": "packages/seal"
   },
   "keywords": [
     "validation",
@@ -22,7 +23,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.29.0",
+  "version": "5.30.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",

package/skills/handle-seal-errors/SKILL.md

@@ -5,14 +5,12 @@ description: 'Read `ValidationResult` — `isValid`, `errors[]`, `data`. Branch
 
 # `ValidationResult` — reading errors
 
-`validate(schema, data)` never throws. It returns a `ValidationResult`:
+`validate(schema, data)` never throws. It returns a result narrowed on `isValid`:
 
 ```ts
-type ValidationResult = {
-  isValid: boolean;
-  data: any;             // shape after mutators + transformers (the validated value)
-  errors: ValidationError[];
-};
+type TypedValidationResult<TData> =
+  | { isValid: true; data: TData; errors: ValidationError[] }   // TData = Infer.Output<typeof schema>
+  | { isValid: false; data: undefined; errors: ValidationError[] };
 
 type ValidationError = {
   type: string;          // rule type that failed — "required", "email", "min", "string", ...

package/skills/pick-seal-primitive/SKILL.md

@@ -81,6 +81,10 @@ That distinction matters wherever "empty" and "absent" mean different things —
 Before 4.9.2 `v.literal("")` always failed with *"is required"*, and `.optional()` looked like a workaround while actually disabling the literal check — accepting `""`, `null`, and a missing key alike. `v.literal(0)` and `v.literal(false)` were never affected.
 :::
 
+:::note[Fixed again in 5.30]
+5.25 made a blank form value count as missing for literal and enum sets, so an unselected `<select>` reads as absent. That rule also caught `v.literal("")` from 5.25 to 5.29: the required literal rejected `""` and `.optional()` dropped it from the data. Since 5.30 a literal set that lists a blank string keeps `""` as a value in its default (implicit) required state and under `.present()`, `.optional()` and `.nullable()`; a set without one still reads a blank value as missing. An explicit `.required()` (or `requiredIf` and the other conditional rules) puts back the strict non-empty rule and rejects `""` — leave the default state in place when `""` is a valid value.
+:::
+
 `v.instanceof(Ctor)` for File/Buffer/Uint8Array/custom classes. Returns `{}` from `toJsonSchema()` (not representable). For OpenAPI `File`, attach `{ type: "string", format: "binary" }` manually after generation.
 
 ## `v.any` — escape hatch

package/skills/seal-basics/SKILL.md

@@ -69,7 +69,7 @@ The 12 things that are true in every seal use:
 2. **Every factory return is a `StandardSchemaV1<Infer.Output<T>>`.** Pass seal schemas straight into `StandardSchemaV1<T>`-typed slots — no casts.
 3. **Two inference helpers — `Infer.Input<T>` and `Infer.Output<T>`.** Bare `Infer<T>` is an alias for `Infer.Input<T>` (the dominant usage: HTTP bodies, DTOs, form payloads). Use `Infer.Output<T>` for validated state (Cascade `Model<>` params, post-`validate()` data). See [the rules below](#inferinput-vs-inferoutput).
 4. **Fields are required by default.** Mark optional explicitly: `.optional()`. Skip `.required()` — canonical seal style omits the redundant call; inferred types already show what's required.
-5. **`validate(schema, data)` never throws.** Returns `Promise<ValidationResult>` with `{ isValid, data, errors }` — the validated value is `result.data`. See the `handle-seal-errors` topic.
+5. **`validate(schema, data)` never throws.** Returns `{ isValid, data, errors }`, narrowed on `isValid`: on success `data` is `Infer.Output<typeof schema>`, on failure it is `undefined` (a bare `BaseValidator`/`ObjectValidator` annotation keeps `data: any`). See the `handle-seal-errors` topic.
 6. **Validators are immutable by default.** Every chain method (`.min(3)`, `.email()`, `.optional()`, …) returns a clone. Toggle with the `.mutable` getter.
 7. **Two pipelines: mutators (pre-validation), transformers (post-validation).** Order: `default → mutators → required check → required-condition rule → other rules → transformers → data`. `.catch(fallback)` rescues any failure on leaf validators.
 8. **Cross-field rules need a `v.object` parent.** Standalone scalar validators have no siblings to resolve against.