@warlock.js/seal 4.0.162 → 4.0.164

package/cjs/validators/string-validator.d.ts

@@ -0,0 +1,189 @@
+import { PrimitiveValidator } from "./primitive-validator";
+import type { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema";
+/**
+ * String validator class
+ */
+export 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;
+    /**
+     * @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;
+}
+//# sourceMappingURL=string-validator.d.ts.map

package/cjs/validators/string-validator.d.ts.map

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

package/cjs/validators/string-validator.js

@@ -0,0 +1,387 @@
+'use strict';require('@mongez/reinforcements'),require('@mongez/supportive-is'),require('dayjs');var stringMutators=require('../mutators/string-mutators.js'),alpha=require('../rules/string/alpha.js'),creditCard=require('../rules/string/credit-card.js'),email=require('../rules/string/email.js'),ip=require('../rules/string/ip.js'),pattern=require('../rules/string/pattern.js'),stringComparison=require('../rules/string/string-comparison.js'),strongPasswordRule=require('../rules/string/strong-password-rule.js'),url=require('../rules/string/url.js'),withoutWhitespace=require('../rules/string/without-whitespace.js'),lengthRules=require('../rules/length/length-rules.js'),colorRules=require('../rules/color/color-rules.js'),typeRules=require('../rules/common/type-rules.js'),primitiveValidator=require('./primitive-validator.js'),jsonSchema=require('../standard-schema/json-schema.js');/**
+ * String validator class
+ */
+class StringValidator extends primitiveValidator.PrimitiveValidator {
+    constructor(errorMessage) {
+        super();
+        this.addMutableRule(typeRules.stringRule, errorMessage);
+    }
+    /**
+     * Check if value is a string type
+     */
+    matchesType(value) {
+        return typeof value === "string";
+    }
+    // ==================== Mutators ====================
+    /**
+     * Stringify the value if not a string
+     */
+    toString() {
+        return this.addMutator(stringMutators.stringifyMutator);
+    }
+    /** Convert string to uppercase */
+    uppercase() {
+        return this.addMutator(stringMutators.uppercaseMutator);
+    }
+    /** Convert string to lowercase */
+    lowercase() {
+        return this.addMutator(stringMutators.lowercaseMutator);
+    }
+    /** Capitalize only the first letter of the string */
+    capitalize() {
+        return this.addMutator(stringMutators.capitalizeMutator);
+    }
+    /** Capitalize the first letter of each word (Title Case) */
+    titleCase() {
+        return this.addMutator(stringMutators.titleCaseMutator);
+    }
+    /** Convert to camelCase */
+    camelCase() {
+        return this.addMutator(stringMutators.camelCaseMutator);
+    }
+    /** Convert to PascalCase */
+    pascalCase() {
+        return this.addMutator(stringMutators.pascalCaseMutator);
+    }
+    /** Convert to snake_case */
+    snakeCase() {
+        return this.addMutator(stringMutators.snakeCaseMutator);
+    }
+    /** Convert to kebab-case */
+    kebabCase() {
+        return this.addMutator(stringMutators.kebabCaseMutator);
+    }
+    /**
+     * Trim the given needle from the string
+     * If no needle is provided, the default is a single space
+     */
+    trim(needle) {
+        return this.addMutator(stringMutators.trimMutator, { needle });
+    }
+    /** Trim from the left/start */
+    ltrim(needle) {
+        return this.addMutator(stringMutators.ltrimMutator, { needle });
+    }
+    /** Trim from the right/end */
+    rtrim(needle) {
+        return this.addMutator(stringMutators.rtrimMutator, { needle });
+    }
+    /** Trim multiple whitespace into single space */
+    trimMultipleWhitespace() {
+        return this.addMutator(stringMutators.trimMultipleWhitespaceMutator);
+    }
+    /** Pad string from the start to reach target length */
+    padStart(length, char = " ") {
+        return this.addMutator(stringMutators.padStartMutator, { length, char });
+    }
+    /** Pad string from the end to reach target length */
+    padEnd(length, char = " ") {
+        return this.addMutator(stringMutators.padEndMutator, { length, char });
+    }
+    /** Remove HTML tags (safe HTML) */
+    safeHtml() {
+        return this.addMutator(stringMutators.safeHtmlMutator);
+    }
+    /** HTML escape special characters */
+    htmlEscape() {
+        return this.addMutator(stringMutators.htmlEscapeMutator);
+    }
+    /** Unescape HTML entities */
+    unescapeHtml() {
+        return this.addMutator(stringMutators.unescapeHtmlMutator);
+    }
+    /**
+     * Remove special characters
+     * This will remove all characters that are not alphanumeric or whitespace
+     */
+    removeSpecialCharacters() {
+        return this.addMutator(stringMutators.removeSpecialCharactersMutator);
+    }
+    /** Convert to only alphabetic characters */
+    toAlpha() {
+        return this.addMutator(stringMutators.alphaOnlyMutator);
+    }
+    /** Convert to only alphanumeric characters */
+    toAlphanumeric() {
+        return this.addMutator(stringMutators.alphanumericOnlyMutator);
+    }
+    /** Remove all numeric characters */
+    removeNumbers() {
+        return this.addMutator(stringMutators.removeNumbersMutator);
+    }
+    /** URL decode */
+    urlDecode() {
+        return this.addMutator(stringMutators.urlDecodeMutator);
+    }
+    /** URL encode */
+    urlEncode() {
+        return this.addMutator(stringMutators.urlEncodeMutator);
+    }
+    /** Convert to URL-friendly slug */
+    slug() {
+        return this.addMutator(stringMutators.slugMutator);
+    }
+    /** Base64 encode */
+    base64Encode() {
+        return this.addMutator(stringMutators.base64EncodeMutator);
+    }
+    /** Base64 decode */
+    base64Decode() {
+        return this.addMutator(stringMutators.base64DecodeMutator);
+    }
+    /** Replace substring or pattern */
+    replace(search, replace) {
+        return this.addMutator(stringMutators.replaceMutator, { search, replace });
+    }
+    /** Replace all occurrences of substring or pattern */
+    replaceAll(search, replace) {
+        return this.addMutator(stringMutators.replaceAllMutator, { search, replace });
+    }
+    /** Append/suffix text to the end */
+    append(suffix) {
+        return this.addMutator(stringMutators.appendMutator, { suffix });
+    }
+    /** Prepend/prefix text to the beginning */
+    prepend(prefix) {
+        return this.addMutator(stringMutators.prependMutator, { prefix });
+    }
+    /** Reverse the string */
+    reverse() {
+        return this.addMutator(stringMutators.reverseMutator);
+    }
+    /** Truncate to a maximum length */
+    truncate(maxLength, suffix = "...") {
+        return this.addMutator(stringMutators.truncateMutator, { maxLength, suffix });
+    }
+    /** Repeat string N times */
+    repeat(count) {
+        return this.addMutator(stringMutators.repeatMutator, { count });
+    }
+    /** Mask part of string */
+    mask(start, end, char = "*") {
+        return this.addMutator(stringMutators.maskMutator, { start, end, char });
+    }
+    // ==================== Validation Rules ====================
+    /** Value must be a valid email */
+    email(errorMessage) {
+        return this.addRule(email.emailRule, errorMessage);
+    }
+    /** Value must be a valid URL */
+    url(errorMessage) {
+        return this.addRule(url.urlRule, errorMessage);
+    }
+    /** Value can not have whitespace */
+    withoutWhitespace(errorMessage) {
+        return this.addRule(withoutWhitespace.withoutWhitespaceRule, errorMessage);
+    }
+    /** Value must match the given pattern */
+    pattern(pattern$1, errorMessage) {
+        return this.addRule(pattern.patternRule, errorMessage, { pattern: pattern$1 });
+    }
+    /**
+     * 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, errorMessage) {
+        return this.addRule(strongPasswordRule.strongPasswordRule, errorMessage, { minLength });
+    }
+    /** Value must be exactly the given number of words */
+    words(words, errorMessage) {
+        return this.addRule(lengthRules.wordsRule, errorMessage, { words });
+    }
+    /** Value must be at least the given number of words */
+    minWords(words, errorMessage) {
+        return this.addRule(lengthRules.minWordsRule, errorMessage, { minWords: words });
+    }
+    /** Value must be at most the given number of words */
+    maxWords(words, errorMessage) {
+        return this.addRule(lengthRules.maxWordsRule, errorMessage, { maxWords: words });
+    }
+    /** Value length must be greater than the given length */
+    minLength(length, errorMessage) {
+        return this.addRule(lengthRules.minLengthRule, errorMessage, { minLength: length });
+    }
+    /** @alias minLength */
+    min(min, errorMessage) {
+        return this.minLength(min, errorMessage);
+    }
+    /** Value length must be less than the given length */
+    maxLength(length, errorMessage) {
+        return this.addRule(lengthRules.maxLengthRule, errorMessage, { maxLength: length });
+    }
+    /** @alias maxLength */
+    max(max, errorMessage) {
+        return this.maxLength(max, errorMessage);
+    }
+    /** Value must be of the given length */
+    length(length, errorMessage) {
+        return this.addRule(lengthRules.lengthRule, errorMessage, { length });
+    }
+    /**
+     * 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, max, errorMessage) {
+        return this.addRule(lengthRules.betweenLengthRule, errorMessage, {
+            minLength: min,
+            maxLength: max,
+        });
+    }
+    /** Allow only alphabetic characters */
+    alpha(errorMessage) {
+        return this.addRule(alpha.alphaRule, errorMessage);
+    }
+    /** Allow only alphanumeric characters */
+    alphanumeric(errorMessage) {
+        return this.addRule(alpha.alphaNumericRule, errorMessage);
+    }
+    /** Allow only numeric characters */
+    numeric(errorMessage) {
+        return this.addRule(alpha.isNumericRule, errorMessage);
+    }
+    /** Value must starts with the given string */
+    startsWith(value, errorMessage) {
+        return this.addRule(stringComparison.startsWithRule, errorMessage, { value });
+    }
+    /** Value must ends with the given string */
+    endsWith(value, errorMessage) {
+        return this.addRule(stringComparison.endsWithRule, errorMessage, { value });
+    }
+    /** Value must contain the given string */
+    contains(value, errorMessage) {
+        return this.addRule(stringComparison.containsRule, errorMessage, { value });
+    }
+    /** Value must not contain the given string */
+    notContains(value, errorMessage) {
+        return this.addRule(stringComparison.notContainsRule, errorMessage, { value });
+    }
+    /** Value must be a valid IP address */
+    ip(errorMessage) {
+        return this.addRule(ip.ipRule, errorMessage);
+    }
+    /** Value must be a valid IPv4 address */
+    ip4(errorMessage) {
+        return this.addRule(ip.ip4Rule, errorMessage);
+    }
+    /** Value must be a valid IPv6 address */
+    ip6(errorMessage) {
+        return this.addRule(ip.ip6Rule, errorMessage);
+    }
+    /** Check if the string matches a credit card number */
+    creditCard(errorMessage) {
+        return this.addRule(creditCard.isCreditCardRule, errorMessage);
+    }
+    /** Determine if the value is a valid color */
+    color(errorMessage) {
+        return this.addRule(colorRules.colorRule, errorMessage);
+    }
+    /** Determine if the value is a valid hex color */
+    hexColor(errorMessage) {
+        return this.addRule(colorRules.hexColorRule, errorMessage);
+    }
+    /** Determine if the value is a valid HSL color */
+    hslColor(errorMessage) {
+        return this.addRule(colorRules.hslColorRule, errorMessage);
+    }
+    /** Determine if the value is a valid RGB color */
+    rgbColor(errorMessage) {
+        return this.addRule(colorRules.rgbColorRule, errorMessage);
+    }
+    /** Determine if the value is a valid RGBA color */
+    rgbaColor(errorMessage) {
+        return this.addRule(colorRules.rgbaColorRule, errorMessage);
+    }
+    /** Determine if the value is a valid light color */
+    lightColor(errorMessage) {
+        return this.addRule(colorRules.lightColorRule, errorMessage);
+    }
+    /** Determine if the value is a valid dark color */
+    darkColor(errorMessage) {
+        return this.addRule(colorRules.darkColorRule, errorMessage);
+    }
+    /**
+     * @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 = "draft-2020-12") {
+        const schema = { type: "string" };
+        // minLength / min
+        const minOpts = jsonSchema.getRuleOptions(this.rules, "minLength");
+        if (minOpts?.minLength !== undefined)
+            schema.minLength = minOpts.minLength;
+        // maxLength / max
+        const maxOpts = jsonSchema.getRuleOptions(this.rules, "maxLength");
+        if (maxOpts?.maxLength !== undefined)
+            schema.maxLength = maxOpts.maxLength;
+        // betweenLength covers both min and max in one rule
+        const betweenOpts = jsonSchema.getRuleOptions(this.rules, "betweenLength");
+        if (betweenOpts) {
+            if (betweenOpts.minLength !== undefined)
+                schema.minLength = betweenOpts.minLength;
+            if (betweenOpts.maxLength !== undefined)
+                schema.maxLength = betweenOpts.maxLength;
+        }
+        // exact length
+        const lengthOpts = jsonSchema.getRuleOptions(this.rules, "length");
+        if (lengthOpts?.length !== undefined) {
+            schema.minLength = lengthOpts.length;
+            schema.maxLength = lengthOpts.length;
+        }
+        // pattern (regex)
+        const patternOpts = jsonSchema.getRuleOptions(this.rules, "pattern");
+        if (patternOpts?.pattern instanceof RegExp) {
+            schema.pattern = patternOpts.pattern.source;
+        }
+        // format hints
+        if (jsonSchema.getRuleOptions(this.rules, "email") !== undefined ||
+            this.rules.some(r => r.name === "email")) {
+            schema.format = "email";
+        }
+        else if (this.rules.some(r => r.name === "url")) {
+            schema.format = "uri";
+        }
+        else if (this.rules.some(r => r.name === "ip")) {
+            schema.format = "ipv4";
+        }
+        else if (this.rules.some(r => r.name === "ip4")) {
+            schema.format = "ipv4";
+        }
+        else if (this.rules.some(r => r.name === "ip6")) {
+            schema.format = "ipv6";
+        }
+        else if (this.rules.some(r => r.name === "hexColor")) {
+            schema.format = "color";
+        }
+        // enum (from PrimitiveValidator.in / .enum)
+        const inOpts = jsonSchema.getRuleOptions(this.rules, "in");
+        if (inOpts?.values && Array.isArray(inOpts.values)) {
+            schema.enum = inOpts.values;
+        }
+        if (this.isNullable)
+            jsonSchema.applyNullable(schema, target);
+        return schema;
+    }
+}exports.StringValidator=StringValidator;//# sourceMappingURL=string-validator.js.map

package/cjs/validators/string-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-validator.js","sources":["../../src/validators/string-validator.ts"],"sourcesContent":[null],"names":["PrimitiveValidator","stringRule","stringifyMutator","uppercaseMutator","lowercaseMutator","capitalizeMutator","titleCaseMutator","camelCaseMutator","pascalCaseMutator","snakeCaseMutator","kebabCaseMutator","trimMutator","ltrimMutator","rtrimMutator","trimMultipleWhitespaceMutator","padStartMutator","padEndMutator","safeHtmlMutator","htmlEscapeMutator","unescapeHtmlMutator","removeSpecialCharactersMutator","alphaOnlyMutator","alphanumericOnlyMutator","removeNumbersMutator","urlDecodeMutator","urlEncodeMutator","slugMutator","base64EncodeMutator","base64DecodeMutator","replaceMutator","replaceAllMutator","appendMutator","prependMutator","reverseMutator","truncateMutator","repeatMutator","maskMutator","emailRule","urlRule","withoutWhitespaceRule","pattern","patternRule","strongPasswordRule","wordsRule","minWordsRule","maxWordsRule","minLengthRule","maxLengthRule","lengthRule","betweenLengthRule","alphaRule","alphaNumericRule","isNumericRule","startsWithRule","endsWithRule","containsRule","notContainsRule","ipRule","ip4Rule","ip6Rule","isCreditCardRule","colorRule","hexColorRule","hslColorRule","rgbColorRule","rgbaColorRule","lightColorRule","darkColorRule","getRuleOptions","applyNullable"],"mappings":"s3BA0EA;;AAEG;AACG,MAAO,eAAgB,SAAQA,qCAAkB,CAAA;AACrD,IAAA,WAAA,CAAmB,YAAqB,EAAA;AACtC,QAAA,KAAK,EAAE,CAAC;AACR,QAAA,IAAI,CAAC,cAAc,CAACC,oBAAU,EAAE,YAAY,CAAC,CAAC;KAC/C;AAED;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;AAC3B,QAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;KAClC;;AAID;;AAEG;IACI,QAAQ,GAAA;AACb,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,UAAU,GAAA;AACf,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,gCAAiB,CAAC,CAAC;KAC3C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,UAAU,GAAA;AACf,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,gCAAiB,CAAC,CAAC;KAC3C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;AAED;;;AAGG;AACI,IAAA,IAAI,CAAC,MAAe,EAAA;QACzB,OAAO,IAAI,CAAC,UAAU,CAACC,0BAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;KACjD;;AAGM,IAAA,KAAK,CAAC,MAAe,EAAA;QAC1B,OAAO,IAAI,CAAC,UAAU,CAACC,2BAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;KAClD;;AAGM,IAAA,KAAK,CAAC,MAAe,EAAA;QAC1B,OAAO,IAAI,CAAC,UAAU,CAACC,2BAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;KAClD;;IAGM,sBAAsB,GAAA;AAC3B,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,4CAA6B,CAAC,CAAC;KACvD;;AAGM,IAAA,QAAQ,CAAC,MAAc,EAAE,IAAI,GAAG,GAAG,EAAA;AACxC,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,8BAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;KAC3D;;AAGM,IAAA,MAAM,CAAC,MAAc,EAAE,IAAI,GAAG,GAAG,EAAA;AACtC,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,4BAAa,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;KACzD;;IAGM,QAAQ,GAAA;AACb,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,8BAAe,CAAC,CAAC;KACzC;;IAGM,UAAU,GAAA;AACf,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,gCAAiB,CAAC,CAAC;KAC3C;;IAGM,YAAY,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,kCAAmB,CAAC,CAAC;KAC7C;AAED;;;AAGG;IACI,uBAAuB,GAAA;AAC5B,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,6CAA8B,CAAC,CAAC;KACxD;;IAGM,OAAO,GAAA;AACZ,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,cAAc,GAAA;AACnB,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,sCAAuB,CAAC,CAAC;KACjD;;IAGM,aAAa,GAAA;AAClB,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,mCAAoB,CAAC,CAAC;KAC9C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,+BAAgB,CAAC,CAAC;KAC1C;;IAGM,IAAI,GAAA;AACT,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,0BAAW,CAAC,CAAC;KACrC;;IAGM,YAAY,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,kCAAmB,CAAC,CAAC;KAC7C;;IAGM,YAAY,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,kCAAmB,CAAC,CAAC;KAC7C;;IAGM,OAAO,CAAC,MAAuB,EAAE,OAAe,EAAA;AACrD,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,6BAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;KAC7D;;IAGM,UAAU,CAAC,MAAuB,EAAE,OAAe,EAAA;AACxD,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,gCAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;KAChE;;AAGM,IAAA,MAAM,CAAC,MAAc,EAAA;QAC1B,OAAO,IAAI,CAAC,UAAU,CAACC,4BAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;KACnD;;AAGM,IAAA,OAAO,CAAC,MAAc,EAAA;QAC3B,OAAO,IAAI,CAAC,UAAU,CAACC,6BAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;KACpD;;IAGM,OAAO,GAAA;AACZ,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,6BAAc,CAAC,CAAC;KACxC;;AAGM,IAAA,QAAQ,CAAC,SAAiB,EAAE,MAAM,GAAG,KAAK,EAAA;AAC/C,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,8BAAe,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;KAChE;;AAGM,IAAA,MAAM,CAAC,KAAa,EAAA;QACzB,OAAO,IAAI,CAAC,UAAU,CAACC,4BAAa,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KAClD;;AAGM,IAAA,IAAI,CAAC,KAAa,EAAE,GAAY,EAAE,IAAI,GAAG,GAAG,EAAA;AACjD,QAAA,OAAO,IAAI,CAAC,UAAU,CAACC,0BAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;KAC3D;;;AAKM,IAAA,KAAK,CAAC,YAAqB,EAAA;QAChC,OAAO,IAAI,CAAC,OAAO,CAACC,eAAS,EAAE,YAAY,CAAC,CAAC;KAC9C;;AAGM,IAAA,GAAG,CAAC,YAAqB,EAAA;QAC9B,OAAO,IAAI,CAAC,OAAO,CAACC,WAAO,EAAE,YAAY,CAAC,CAAC;KAC5C;;AAGM,IAAA,iBAAiB,CAAC,YAAqB,EAAA;QAC5C,OAAO,IAAI,CAAC,OAAO,CAACC,uCAAqB,EAAE,YAAY,CAAC,CAAC;KAC1D;;IAGM,OAAO,CAACC,SAAe,EAAE,YAAqB,EAAA;AACnD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,mBAAW,EAAE,YAAY,EAAE,WAAED,SAAO,EAAE,CAAC,CAAC;KAC7D;AAED;;;;;;;;AAQG;IACI,cAAc,CAAC,SAAkB,EAAE,YAAqB,EAAA;AAC7D,QAAA,OAAO,IAAI,CAAC,OAAO,CAACE,qCAAkB,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;KACtE;;IAGM,KAAK,CAAC,KAAa,EAAE,YAAqB,EAAA;AAC/C,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,qBAAS,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KACzD;;IAGM,QAAQ,CAAC,KAAa,EAAE,YAAqB,EAAA;AAClD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,wBAAY,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;KACtE;;IAGM,QAAQ,CAAC,KAAa,EAAE,YAAqB,EAAA;AAClD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,wBAAY,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;KACtE;;IAGM,SAAS,CAAC,MAAc,EAAE,YAAqB,EAAA;AACpD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,yBAAa,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;KACzE;;IAGM,GAAG,CAAC,GAAW,EAAE,YAAqB,EAAA;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;KAC1C;;IAGM,SAAS,CAAC,MAAc,EAAE,YAAqB,EAAA;AACpD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,yBAAa,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;KACzE;;IAGM,GAAG,CAAC,GAAW,EAAE,YAAqB,EAAA;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;KAC1C;;IAGM,MAAM,CAAC,MAAc,EAAE,YAAqB,EAAA;AACjD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,sBAAU,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;KAC3D;AAED;;;;;;;;;;;;;AAaG;AACI,IAAA,aAAa,CAAC,GAAW,EAAE,GAAW,EAAE,YAAqB,EAAA;AAClE,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,6BAAiB,EAAE,YAAY,EAAE;AACnD,YAAA,SAAS,EAAE,GAAG;AACd,YAAA,SAAS,EAAE,GAAG;AACf,SAAA,CAAC,CAAC;KACJ;;AAGM,IAAA,KAAK,CAAC,YAAqB,EAAA;QAChC,OAAO,IAAI,CAAC,OAAO,CAACC,eAAS,EAAE,YAAY,CAAC,CAAC;KAC9C;;AAGM,IAAA,YAAY,CAAC,YAAqB,EAAA;QACvC,OAAO,IAAI,CAAC,OAAO,CAACC,sBAAgB,EAAE,YAAY,CAAC,CAAC;KACrD;;AAGM,IAAA,OAAO,CAAC,YAAqB,EAAA;QAClC,OAAO,IAAI,CAAC,OAAO,CAACC,mBAAa,EAAE,YAAY,CAAC,CAAC;KAClD;;IAGM,UAAU,CAAC,KAAa,EAAE,YAAqB,EAAA;AACpD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,+BAAc,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KAC9D;;IAGM,QAAQ,CAAC,KAAa,EAAE,YAAqB,EAAA;AAClD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,6BAAY,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KAC5D;;IAGM,QAAQ,CAAC,KAAa,EAAE,YAAqB,EAAA;AAClD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,6BAAY,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KAC5D;;IAGM,WAAW,CAAC,KAAa,EAAE,YAAqB,EAAA;AACrD,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,gCAAe,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KAC/D;;AAGM,IAAA,EAAE,CAAC,YAAqB,EAAA;QAC7B,OAAO,IAAI,CAAC,OAAO,CAACC,SAAM,EAAE,YAAY,CAAC,CAAC;KAC3C;;AAGM,IAAA,GAAG,CAAC,YAAqB,EAAA;QAC9B,OAAO,IAAI,CAAC,OAAO,CAACC,UAAO,EAAE,YAAY,CAAC,CAAC;KAC5C;;AAGM,IAAA,GAAG,CAAC,YAAqB,EAAA;QAC9B,OAAO,IAAI,CAAC,OAAO,CAACC,UAAO,EAAE,YAAY,CAAC,CAAC;KAC5C;;AAGM,IAAA,UAAU,CAAC,YAAqB,EAAA;QACrC,OAAO,IAAI,CAAC,OAAO,CAACC,2BAAgB,EAAE,YAAY,CAAC,CAAC;KACrD;;AAGM,IAAA,KAAK,CAAC,YAAqB,EAAA;QAChC,OAAO,IAAI,CAAC,OAAO,CAACC,oBAAS,EAAE,YAAY,CAAC,CAAC;KAC9C;;AAGM,IAAA,QAAQ,CAAC,YAAqB,EAAA;QACnC,OAAO,IAAI,CAAC,OAAO,CAACC,uBAAY,EAAE,YAAY,CAAC,CAAC;KACjD;;AAGM,IAAA,QAAQ,CAAC,YAAqB,EAAA;QACnC,OAAO,IAAI,CAAC,OAAO,CAACC,uBAAY,EAAE,YAAY,CAAC,CAAC;KACjD;;AAGM,IAAA,QAAQ,CAAC,YAAqB,EAAA;QACnC,OAAO,IAAI,CAAC,OAAO,CAACC,uBAAY,EAAE,YAAY,CAAC,CAAC;KACjD;;AAGM,IAAA,SAAS,CAAC,YAAqB,EAAA;QACpC,OAAO,IAAI,CAAC,OAAO,CAACC,wBAAa,EAAE,YAAY,CAAC,CAAC;KAClD;;AAGM,IAAA,UAAU,CAAC,YAAqB,EAAA;QACrC,OAAO,IAAI,CAAC,OAAO,CAACC,yBAAc,EAAE,YAAY,CAAC,CAAC;KACnD;;AAGM,IAAA,SAAS,CAAC,YAAqB,EAAA;QACpC,OAAO,IAAI,CAAC,OAAO,CAACC,wBAAa,EAAE,YAAY,CAAC,CAAC;KAClD;AAED;;;;;;;;;;;AAWG;IACa,YAAY,CAAC,SAA2B,eAAe,EAAA;AACrE,QAAA,MAAM,MAAM,GAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;QAGpD,MAAM,OAAO,GAAGC,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AACxD,QAAA,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;;QAG3E,MAAM,OAAO,GAAGA,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AACxD,QAAA,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;;QAG3E,MAAM,WAAW,GAAGA,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;AAChE,QAAA,IAAI,WAAW,EAAE;AACf,YAAA,IAAI,WAAW,CAAC,SAAS,KAAK,SAAS;AAAE,gBAAA,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;AAClF,YAAA,IAAI,WAAW,CAAC,SAAS,KAAK,SAAS;AAAE,gBAAA,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;AACnF,SAAA;;QAGD,MAAM,UAAU,GAAGA,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACxD,QAAA,IAAI,UAAU,EAAE,MAAM,KAAK,SAAS,EAAE;AACpC,YAAA,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;AACrC,YAAA,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;AACtC,SAAA;;QAGD,MAAM,WAAW,GAAGA,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC1D,QAAA,IAAI,WAAW,EAAE,OAAO,YAAY,MAAM,EAAE;YAC1C,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;AAC7C,SAAA;;QAGD,IAAIA,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,SAAS;AACjD,YAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE;AAC5C,YAAA,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;AACzB,SAAA;AAAM,aAAA,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE;AACjD,YAAA,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;AACvB,SAAA;AAAM,aAAA,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE;AAChD,YAAA,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;AACxB,SAAA;AAAM,aAAA,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE;AACjD,YAAA,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;AACxB,SAAA;AAAM,aAAA,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE;AACjD,YAAA,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;AACxB,SAAA;AAAM,aAAA,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE;AACtD,YAAA,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;AACzB,SAAA;;QAGD,MAAM,MAAM,GAAGA,yBAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAChD,QAAA,IAAI,MAAM,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;AAClD,YAAA,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,SAAA;QAED,IAAI,IAAI,CAAC,UAAU;AAAE,YAAAC,wBAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,QAAA,OAAO,MAAM,CAAC;KACf;AACF"}

package/cjs/validators/tuple-validator.d.ts

@@ -0,0 +1,56 @@
+import type { SchemaContext, ValidationResult } from "../types";
+import { BaseValidator } from "./base-validator";
+import type { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema";
+/**
+ * Tuple validator class - validates fixed-length arrays with position-specific types
+ *
+ * @example
+ * ```ts
+ * // RGB color tuple
+ * v.tuple([v.number(), v.number(), v.number()])
+ * // Valid: [255, 128, 0]
+ * // Invalid: [255, 128] (too short)
+ *
+ * // Mixed types
+ * v.tuple([v.string(), v.int(), v.boolean()])
+ * // Valid: ["John", 25, true]
+ * ```
+ */
+export declare class TupleValidator extends BaseValidator {
+    validators: BaseValidator[];
+    constructor(validators: BaseValidator[], errorMessage?: string);
+    /**
+     * Check if value is an array type
+     */
+    matchesType(value: any): boolean;
+    /**
+     * Clone the validator
+     */
+    clone(): this;
+    /**
+     * Validate tuple - check length then validate each position
+     */
+    validate(data: any, context: SchemaContext): Promise<ValidationResult>;
+    /**
+     * @inheritdoc
+     *
+     * Tuple keyword diverges between targets:
+     * - `draft-2020-12` → `prefixItems` + `items: false` (exact length enforced)
+     * - `draft-07`      → `items` as array + `additionalItems: false`
+     * - `openapi-3.0`   → same as draft-07 (OpenAPI 3.0 is based on draft-07)
+     *
+     * @example
+     * ```ts
+     * v.tuple([v.string(), v.int(), v.boolean()]).toJsonSchema("draft-2020-12")
+     * // → {
+     * //   type: "array",
+     * //   prefixItems: [{ type: "string" }, { type: "integer" }, { type: "boolean" }],
+     * //   items: false,
+     * //   minItems: 3,
+     * //   maxItems: 3
+     * // }
+     * ```
+     */
+    toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
+}
+//# sourceMappingURL=tuple-validator.d.ts.map

package/cjs/validators/tuple-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple-validator.d.ts","sourceRoot":"","sources":["../../src/validators/tuple-validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEzF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAEtC,UAAU,EAAE,aAAa,EAAE;gBAA3B,UAAU,EAAE,aAAa,EAAE,EAClC,YAAY,CAAC,EAAE,MAAM;IAMvB;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIvC;;OAEG;IACa,KAAK,IAAI,IAAI;IAM7B;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgDnF;;;;;;;;;;;;;;;;;;;OAmBG;IACa,YAAY,CAAC,MAAM,GAAE,gBAAkC,GAAG,gBAAgB;CAwB3F"}