@warlock.js/seal 4.0.174 → 4.1.2

package/esm/validators/scalar-validator.mjs

@@ -0,0 +1,172 @@
+import { getRuleOptions } from "../standard-schema/json-schema.mjs";
+import { VALID_RULE, invalidRule } from "../helpers/validation-helpers.mjs";
+import "../helpers/index.mjs";
+import { numberMutator } from "../mutators/number-mutators.mjs";
+import { stringMutator } from "../mutators/scalar-mutators.mjs";
+import "../mutators/index.mjs";
+import { PrimitiveValidator } from "./primitive-validator.mjs";
+import { acceptedIfPresentRule, acceptedIfRequiredRule, acceptedIfRule, acceptedRule, acceptedUnlessRule, acceptedWithoutRule } from "../rules/scalar/accepted-rule.mjs";
+import { declinedIfPresentRule, declinedIfRequiredRule, declinedIfRule, declinedRule, declinedUnlessRule, declinedWithoutRule } from "../rules/scalar/declined-rule.mjs";
+import "../rules/scalar/index.mjs";
+
+//#region ../../@warlock.js/seal/src/validators/scalar-validator.ts
+/**
+* Scalar validator class
+*
+* Core validator for scalar values (string, number, boolean).
+* Extends PrimitiveValidator (inherits enum/in/oneOf/allowsOnly/forbids/notIn)
+* and additionally provides type-coercion mutators and accepted/declined rules.
+*
+* Database methods (unique, exists, etc.) are injected by the framework
+*/
+var ScalarValidator = class extends PrimitiveValidator {
+	constructor(errorMessage) {
+		super();
+		this.addMutableRule({
+			name: "scalar",
+			defaultErrorMessage: "The :input must be a scalar value",
+			async validate(value, context) {
+				if ([
+					"string",
+					"number",
+					"boolean"
+				].includes(typeof value)) return VALID_RULE;
+				return invalidRule(this, context);
+			}
+		}, errorMessage);
+	}
+	/**
+	* Add matches type
+	*/
+	matchesType(value) {
+		return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+	}
+	/**
+	* Mutate the scalar value to be number
+	*/
+	asNumber() {
+		return this.addMutator(numberMutator);
+	}
+	/**
+	* Mutate the scalar value to be string
+	*/
+	asString() {
+		return this.addMutator(stringMutator);
+	}
+	/**
+	* Accepted value
+	* The value will be valid if it equals 1 | "1" | true | "true" | "yes" | "y" | "on"
+	*/
+	accepted(errorMessage) {
+		return this.addRule(acceptedRule, errorMessage);
+	}
+	/**
+	* Accepted value if another field's value equals to a specific value
+	*/
+	acceptedIf(field, value, errorMessage) {
+		return this.addRule(acceptedIfRule, errorMessage, {
+			field,
+			value
+		});
+	}
+	/**
+	* Accepted value if another field's value is not equal to the given value
+	*/
+	acceptedUnless(field, value, errorMessage) {
+		return this.addRule(acceptedUnlessRule, errorMessage, {
+			field,
+			value
+		});
+	}
+	/**
+	* Accepted value if another field is required
+	*/
+	acceptedIfRequired(field, errorMessage) {
+		return this.addRule(acceptedIfRequiredRule, errorMessage, { field });
+	}
+	/**
+	* Accepted value if another field is present
+	*/
+	acceptedIfPresent(field, errorMessage) {
+		return this.addRule(acceptedIfPresentRule, errorMessage, { field });
+	}
+	/**
+	* Accepted value if another field is missing
+	*/
+	acceptedWithout(field, errorMessage) {
+		return this.addRule(acceptedWithoutRule, errorMessage, { field });
+	}
+	/**
+	* Declined value
+	* The value will be valid if it equals 0 | "0" | false | "false" | "no" | "n" | "off"
+	*/
+	declined(errorMessage) {
+		return this.addRule(declinedRule, errorMessage);
+	}
+	/**
+	* Declined value if another field's value equals to a specific value
+	*/
+	declinedIf(field, value, errorMessage) {
+		return this.addRule(declinedIfRule, errorMessage, {
+			field,
+			value
+		});
+	}
+	/**
+	* Declined value if another field's value is not equal to the given value
+	*/
+	declinedUnless(field, value, errorMessage) {
+		return this.addRule(declinedUnlessRule, errorMessage, {
+			field,
+			value
+		});
+	}
+	/**
+	* Declined value if another field is required
+	*/
+	declinedIfRequired(field, errorMessage) {
+		return this.addRule(declinedIfRequiredRule, errorMessage, { field });
+	}
+	/**
+	* Declined value if another field is present
+	*/
+	declinedIfPresent(field, errorMessage) {
+		return this.addRule(declinedIfPresentRule, errorMessage, { field });
+	}
+	/**
+	* Declined value if another field is missing
+	*/
+	declinedWithout(field, errorMessage) {
+		return this.addRule(declinedWithoutRule, errorMessage, { field });
+	}
+	/**
+	* @inheritdoc
+	*
+	* A scalar accepts string | number | boolean. If `.in()` / `.enum()` is used,
+	* output collapses to a simple `enum` list instead.
+	*
+	* @example
+	* ```ts
+	* v.scalar().toJsonSchema("draft-2020-12")
+	* // → { oneOf: [{ type: "string" }, { type: "number" }, { type: "boolean" }] }
+	*
+	* v.scalar().in(["active", "inactive"]).toJsonSchema("draft-2020-12")
+	* // → { enum: ["active", "inactive"] }
+	* ```
+	*/
+	toJsonSchema(_target = "draft-2020-12") {
+		const inOpts = getRuleOptions(this.rules, "in");
+		if (inOpts?.values && Array.isArray(inOpts.values)) return { enum: inOpts.values };
+		const enumOpts = getRuleOptions(this.rules, "enum");
+		if (enumOpts?.enum && Array.isArray(enumOpts.enum)) return { enum: enumOpts.enum };
+		return { oneOf: [
+			{ type: "string" },
+			{ type: "number" },
+			{ type: "boolean" }
+		] };
+	}
+};
+
+//#endregion
+export { ScalarValidator };
+//# sourceMappingURL=scalar-validator.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-validator.mjs","names":[],"sources":["../../../../../../@warlock.js/seal/src/validators/scalar-validator.ts"],"sourcesContent":["import { invalidRule, VALID_RULE } from \"../helpers\";\r\nimport { numberMutator, stringMutator } from \"../mutators\";\r\nimport {\r\n  acceptedIfPresentRule,\r\n  acceptedIfRequiredRule,\r\n  acceptedIfRule,\r\n  acceptedRule,\r\n  acceptedUnlessRule,\r\n  acceptedWithoutRule,\r\n  declinedIfPresentRule,\r\n  declinedIfRequiredRule,\r\n  declinedIfRule,\r\n  declinedRule,\r\n  declinedUnlessRule,\r\n  declinedWithoutRule,\r\n} from \"../rules/scalar\";\r\nimport { PrimitiveValidator } from \"./primitive-validator\";\r\nimport { getRuleOptions } from \"../standard-schema/json-schema\";\r\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\r\n\r\n/**\r\n * Scalar validator class\r\n *\r\n * Core validator for scalar values (string, number, boolean).\r\n * Extends PrimitiveValidator (inherits enum/in/oneOf/allowsOnly/forbids/notIn)\r\n * and additionally provides type-coercion mutators and accepted/declined rules.\r\n *\r\n * Database methods (unique, exists, etc.) are injected by the framework\r\n */\r\nexport class ScalarValidator extends PrimitiveValidator {\r\n  public constructor(errorMessage?: string) {\r\n    super();\r\n    this.addMutableRule(\r\n      {\r\n        name: \"scalar\",\r\n        defaultErrorMessage: \"The :input must be a scalar value\",\r\n        async validate(value, context) {\r\n          if ([\"string\", \"number\", \"boolean\"].includes(typeof value)) {\r\n            return VALID_RULE;\r\n          }\r\n          return invalidRule(this, context);\r\n        },\r\n      },\r\n      errorMessage,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Add matches type\r\n   */\r\n  public matchesType(value: any) {\r\n    return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\r\n  }\r\n\r\n  /**\r\n   * Mutate the scalar value to be number\r\n   */\r\n  public asNumber() {\r\n    return this.addMutator(numberMutator);\r\n  }\r\n\r\n  /**\r\n   * Mutate the scalar value to be string\r\n   */\r\n  public asString() {\r\n    return this.addMutator(stringMutator);\r\n  }\r\n\r\n  /**\r\n   * Accepted value\r\n   * The value will be valid if it equals 1 | \"1\" | true | \"true\" | \"yes\" | \"y\" | \"on\"\r\n   */\r\n  public accepted(errorMessage?: string) {\r\n    return this.addRule(acceptedRule, errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Accepted value if another field's value equals to a specific value\r\n   */\r\n  public acceptedIf(field: string, value: any, errorMessage?: string) {\r\n    return this.addRule(acceptedIfRule, errorMessage, { field, value });\r\n  }\r\n\r\n  /**\r\n   * Accepted value if another field's value is not equal to the given value\r\n   */\r\n  public acceptedUnless(field: string, value: any, errorMessage?: string) {\r\n    return this.addRule(acceptedUnlessRule, errorMessage, { field, value });\r\n  }\r\n\r\n  /**\r\n   * Accepted value if another field is required\r\n   */\r\n  public acceptedIfRequired(field: string, errorMessage?: string) {\r\n    return this.addRule(acceptedIfRequiredRule, errorMessage, { field });\r\n  }\r\n\r\n  /**\r\n   * Accepted value if another field is present\r\n   */\r\n  public acceptedIfPresent(field: string, errorMessage?: string) {\r\n    return this.addRule(acceptedIfPresentRule, errorMessage, { field });\r\n  }\r\n\r\n  /**\r\n   * Accepted value if another field is missing\r\n   */\r\n  public acceptedWithout(field: string, errorMessage?: string) {\r\n    return this.addRule(acceptedWithoutRule, errorMessage, { field });\r\n  }\r\n\r\n  /**\r\n   * Declined value\r\n   * The value will be valid if it equals 0 | \"0\" | false | \"false\" | \"no\" | \"n\" | \"off\"\r\n   */\r\n  public declined(errorMessage?: string) {\r\n    return this.addRule(declinedRule, errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Declined value if another field's value equals to a specific value\r\n   */\r\n  public declinedIf(field: string, value: any, errorMessage?: string) {\r\n    return this.addRule(declinedIfRule, errorMessage, { field, value });\r\n  }\r\n\r\n  /**\r\n   * Declined value if another field's value is not equal to the given value\r\n   */\r\n  public declinedUnless(field: string, value: any, errorMessage?: string) {\r\n    return this.addRule(declinedUnlessRule, errorMessage, { field, value });\r\n  }\r\n\r\n  /**\r\n   * Declined value if another field is required\r\n   */\r\n  public declinedIfRequired(field: string, errorMessage?: string) {\r\n    return this.addRule(declinedIfRequiredRule, errorMessage, { field });\r\n  }\r\n\r\n  /**\r\n   * Declined value if another field is present\r\n   */\r\n  public declinedIfPresent(field: string, errorMessage?: string) {\r\n    return this.addRule(declinedIfPresentRule, errorMessage, { field });\r\n  }\r\n\r\n  /**\r\n   * Declined value if another field is missing\r\n   */\r\n  public declinedWithout(field: string, errorMessage?: string) {\r\n    return this.addRule(declinedWithoutRule, errorMessage, { field });\r\n  }\r\n\r\n  /**\r\n   * @inheritdoc\r\n   *\r\n   * A scalar accepts string | number | boolean. If `.in()` / `.enum()` is used,\r\n   * output collapses to a simple `enum` list instead.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * v.scalar().toJsonSchema(\"draft-2020-12\")\r\n   * // → { oneOf: [{ type: \"string\" }, { type: \"number\" }, { type: \"boolean\" }] }\r\n   *\r\n   * v.scalar().in([\"active\", \"inactive\"]).toJsonSchema(\"draft-2020-12\")\r\n   * // → { enum: [\"active\", \"inactive\"] }\r\n   * ```\r\n   */\r\n  public override toJsonSchema(_target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\r\n    // If a value set is constrained, collapse to enum\r\n    const inOpts = getRuleOptions(this.rules, \"in\");\r\n    if (inOpts?.values && Array.isArray(inOpts.values)) {\r\n      return { enum: inOpts.values };\r\n    }\r\n\r\n    const enumOpts = getRuleOptions(this.rules, \"enum\");\r\n    if (enumOpts?.enum && Array.isArray(enumOpts.enum)) {\r\n      return { enum: enumOpts.enum };\r\n    }\r\n\r\n    return {\r\n      oneOf: [\r\n        { type: \"string\" },\r\n        { type: \"number\" },\r\n        { type: \"boolean\" },\r\n      ],\r\n    };\r\n  }\r\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,kBAAb,cAAqC,mBAAmB;CACtD,AAAO,YAAY,cAAuB;EACxC,MAAM;EACN,KAAK,eACH;GACE,MAAM;GACN,qBAAqB;GACrB,MAAM,SAAS,OAAO,SAAS;IAC7B,IAAI;KAAC;KAAU;KAAU;IAAS,EAAE,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

@@ -0,0 +1,224 @@
+import { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema.mjs";
+import { PrimitiveValidator } from "./primitive-validator.mjs";
+import { UUIDVersion } from "../rules/string/id-formats.mjs";
+
+//#region ../../@warlock.js/seal/src/validators/string-validator.d.ts
+/**
+ * String validator class
+ */
+declare class StringValidator extends PrimitiveValidator {
+  constructor(errorMessage?: string);
+  /**
+   * Check if value is a string type
+   */
+  matchesType(value: any): boolean;
+  /**
+   * Stringify the value if not a string
+   */
+  toString(): this;
+  /** Convert string to uppercase */
+  uppercase(): this;
+  /** Convert string to lowercase */
+  lowercase(): this;
+  /** Capitalize only the first letter of the string */
+  capitalize(): this;
+  /** Capitalize the first letter of each word (Title Case) */
+  titleCase(): this;
+  /** Convert to camelCase */
+  camelCase(): this;
+  /** Convert to PascalCase */
+  pascalCase(): this;
+  /** Convert to snake_case */
+  snakeCase(): this;
+  /** Convert to kebab-case */
+  kebabCase(): this;
+  /**
+   * Trim the given needle from the string
+   * If no needle is provided, the default is a single space
+   */
+  trim(needle?: string): this;
+  /** Trim from the left/start */
+  ltrim(needle?: string): this;
+  /** Trim from the right/end */
+  rtrim(needle?: string): this;
+  /** Trim multiple whitespace into single space */
+  trimMultipleWhitespace(): this;
+  /** Pad string from the start to reach target length */
+  padStart(length: number, char?: string): this;
+  /** Pad string from the end to reach target length */
+  padEnd(length: number, char?: string): this;
+  /** Remove HTML tags (safe HTML) */
+  safeHtml(): this;
+  /** HTML escape special characters */
+  htmlEscape(): this;
+  /** Unescape HTML entities */
+  unescapeHtml(): this;
+  /**
+   * Remove special characters
+   * This will remove all characters that are not alphanumeric or whitespace
+   */
+  removeSpecialCharacters(): this;
+  /** Convert to only alphabetic characters */
+  toAlpha(): this;
+  /** Convert to only alphanumeric characters */
+  toAlphanumeric(): this;
+  /** Remove all numeric characters */
+  removeNumbers(): this;
+  /** URL decode */
+  urlDecode(): this;
+  /** URL encode */
+  urlEncode(): this;
+  /** Convert to URL-friendly slug */
+  slug(): this;
+  /** Base64 encode */
+  base64Encode(): this;
+  /** Base64 decode */
+  base64Decode(): this;
+  /** Replace substring or pattern */
+  replace(search: string | RegExp, replace: string): this;
+  /** Replace all occurrences of substring or pattern */
+  replaceAll(search: string | RegExp, replace: string): this;
+  /** Append/suffix text to the end */
+  append(suffix: string): this;
+  /** Prepend/prefix text to the beginning */
+  prepend(prefix: string): this;
+  /** Reverse the string */
+  reverse(): this;
+  /** Truncate to a maximum length */
+  truncate(maxLength: number, suffix?: string): this;
+  /** Repeat string N times */
+  repeat(count: number): this;
+  /** Mask part of string */
+  mask(start: number, end?: number, char?: string): this;
+  /** Value must be a valid email */
+  email(errorMessage?: string): this;
+  /** Value must be a valid URL */
+  url(errorMessage?: string): this;
+  /** Value can not have whitespace */
+  withoutWhitespace(errorMessage?: string): this;
+  /** Value must match the given pattern */
+  pattern(pattern: RegExp, errorMessage?: string): this;
+  /**
+   * Value must be a strong password
+   * Requirements:
+   * - At least 8 characters
+   * - At least 1 uppercase letter
+   * - At least 1 lowercase letter
+   * - At least 1 number
+   * - At least 1 special character
+   */
+  strongPassword(minLength?: number, errorMessage?: string): this;
+  /** Value must be exactly the given number of words */
+  words(words: number, errorMessage?: string): this;
+  /** Value must be at least the given number of words */
+  minWords(words: number, errorMessage?: string): this;
+  /** Value must be at most the given number of words */
+  maxWords(words: number, errorMessage?: string): this;
+  /** Value length must be greater than the given length */
+  minLength(length: number, errorMessage?: string): this;
+  /** @alias minLength */
+  min(min: number, errorMessage?: string): this;
+  /** Value length must be less than the given length */
+  maxLength(length: number, errorMessage?: string): this;
+  /** @alias maxLength */
+  max(max: number, errorMessage?: string): this;
+  /** Value must be of the given length */
+  length(length: number, errorMessage?: string): this;
+  /**
+   * String length must be between min and max (inclusive)
+   *
+   * @param min - Minimum length (inclusive)
+   * @param max - Maximum length (inclusive)
+   *
+   * @example
+   * ```ts
+   * v.string().between(5, 10)  // Length: 5 to 10 characters
+   * v.string().lengthBetween(8, 20)  // Same using alias
+   * ```
+   *
+   * @category Validation Rule
+   */
+  lengthBetween(min: number, max: number, errorMessage?: string): this;
+  /** Allow only alphabetic characters */
+  alpha(errorMessage?: string): this;
+  /** Allow only alphanumeric characters */
+  alphanumeric(errorMessage?: string): this;
+  /** Allow only numeric characters */
+  numeric(errorMessage?: string): this;
+  /** Value must starts with the given string */
+  startsWith(value: string, errorMessage?: string): this;
+  /** Value must ends with the given string */
+  endsWith(value: string, errorMessage?: string): this;
+  /** Value must contain the given string */
+  contains(value: string, errorMessage?: string): this;
+  /** Value must not contain the given string */
+  notContains(value: string, errorMessage?: string): this;
+  /** Value must be a valid IP address */
+  ip(errorMessage?: string): this;
+  /** Value must be a valid IPv4 address */
+  ip4(errorMessage?: string): this;
+  /** Value must be a valid IPv6 address */
+  ip6(errorMessage?: string): this;
+  /** Check if the string matches a credit card number */
+  creditCard(errorMessage?: string): this;
+  /** Determine if the value is a valid color */
+  color(errorMessage?: string): this;
+  /** Determine if the value is a valid hex color */
+  hexColor(errorMessage?: string): this;
+  /** Determine if the value is a valid HSL color */
+  hslColor(errorMessage?: string): this;
+  /** Determine if the value is a valid RGB color */
+  rgbColor(errorMessage?: string): this;
+  /** Determine if the value is a valid RGBA color */
+  rgbaColor(errorMessage?: string): this;
+  /** Determine if the value is a valid light color */
+  lightColor(errorMessage?: string): this;
+  /** Determine if the value is a valid dark color */
+  darkColor(errorMessage?: string): this;
+  /**
+   * Value must be a valid UUID. Optionally restrict to a specific version.
+   *
+   * @example
+   * v.string().uuid()    // any RFC 4122 UUID
+   * v.string().uuid(4)   // only v4 (random)
+   * v.string().uuid(7)   // only v7 (timestamp-ordered)
+   */
+  uuid(version?: UUIDVersion, errorMessage?: string): this;
+  /**
+   * Value must be a valid CUID. Defaults to CUID2; pass `{ version: 1 }` for legacy.
+   *
+   * @example
+   * v.string().cuid()                   // CUID2
+   * v.string().cuid({ version: 1 })     // legacy CUID1
+   */
+  cuid(options?: {
+    version?: 1 | 2;
+    errorMessage?: string;
+  }): this;
+  /** Value must be a valid ULID (26 chars, Crockford base32). */
+  ulid(errorMessage?: string): this;
+  /**
+   * Value must be a valid nanoid string. Default length is 21.
+   *
+   * @example
+   * v.string().nanoid()       // 21 chars (default)
+   * v.string().nanoid(10)     // 10 chars
+   */
+  nanoid(length?: number, errorMessage?: string): this;
+  /**
+   * @inheritdoc
+   *
+   * Maps String-specific rule options to JSON Schema keywords.
+   * Non-representable rules (cross-field, refine, color rules, etc.) are silently omitted.
+   *
+   * @example
+   * ```ts
+   * v.string().min(2).max(100).email().toJsonSchema("draft-2020-12")
+   * // → { type: "string", minLength: 2, maxLength: 100, format: "email" }
+   * ```
+   */
+  toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
+}
+//#endregion
+export { StringValidator };
+//# sourceMappingURL=string-validator.d.mts.map

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

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