@warlock.js/seal 4.0.162 → 4.0.163

package/esm/validators/number-validator.js

@@ -0,0 +1,307 @@
+import'@mongez/reinforcements';import'@mongez/supportive-is';import'dayjs';import {absMutator,ceilMutator,floorMutator,roundMutator,toFixedMutator}from'../mutators/number-mutators.js';import'net';import {minRule,maxRule,greaterThanRule,lessThanRule,moduloRule,positiveRule,negativeRule,oddRule,evenRule,betweenNumbersRule}from'../rules/number/number-rules.js';import {lengthRule,minLengthRule,maxLengthRule}from'../rules/length/length-rules.js';import {numberRule}from'../rules/common/type-rules.js';import {PrimitiveValidator}from'./primitive-validator.js';import {getRuleOptions,applyNullable}from'../standard-schema/json-schema.js';/**
+ * Number validator class - base for Int and Float validators
+ */
+class NumberValidator extends PrimitiveValidator {
+    constructor(errorMessage) {
+        super();
+        this.addMutableRule(numberRule, errorMessage);
+    }
+    /**
+     * Check if value is a number type
+     */
+    matchesType(value) {
+        return typeof value === "number" && !isNaN(value);
+    }
+    /**
+     * Value must be equal or higher than the given number or field
+     * Smart detection: number or field name
+     *
+     * @category Validation Rule
+     */
+    min(min, errorMessage) {
+        return this.addRule(minRule, errorMessage, { min, scope: "global" });
+    }
+    /**
+     * Value must be equal or less than the given number or field
+     * Smart detection: number or field name
+     *
+     * @category Validation Rule
+     */
+    max(max, errorMessage) {
+        return this.addRule(maxRule, errorMessage, { max, scope: "global" });
+    }
+    /**
+     * Value must be >= sibling field value
+     * @category Validation Rule
+     */
+    minSibling(field, errorMessage) {
+        return this.addRule(minRule, errorMessage, { min: field, scope: "sibling" });
+    }
+    /**
+     * Value must be <= sibling field value
+     * @category Validation Rule
+     */
+    maxSibling(field, errorMessage) {
+        return this.addRule(maxRule, errorMessage, { max: field, scope: "sibling" });
+    }
+    /**
+     * Value must be strictly greater than the given number or field (>)
+     * Smart detection: number or field name
+     *
+     * @category Validation Rule
+     */
+    greaterThan(value, errorMessage) {
+        return this.addRule(greaterThanRule, errorMessage, {
+            value,
+            scope: "global",
+        });
+    }
+    /**
+     * Value must be strictly less than the given number or field (<)
+     * Smart detection: number or field name
+     *
+     * @category Validation Rule
+     */
+    lessThan(value, errorMessage) {
+        return this.addRule(lessThanRule, errorMessage, {
+            value,
+            scope: "global",
+        });
+    }
+    /**
+     * Alias for greaterThan() - shorter syntax
+     * @category Validation Rule
+     */
+    gt(value, errorMessage) {
+        return this.greaterThan(value, errorMessage);
+    }
+    /**
+     * Alias for lessThan() - shorter syntax
+     * @category Validation Rule
+     */
+    lt(value, errorMessage) {
+        return this.lessThan(value, errorMessage);
+    }
+    /**
+     * Value must be > sibling field value
+     * @category Validation Rule
+     */
+    greaterThanSibling(field, errorMessage) {
+        return this.addRule(greaterThanRule, errorMessage, {
+            value: field,
+            scope: "sibling",
+        });
+    }
+    /**
+     * Alias for greaterThanSibling() - shorter syntax
+     * @category Validation Rule
+     */
+    gtSibling(field, errorMessage) {
+        return this.greaterThanSibling(field, errorMessage);
+    }
+    /**
+     * Value must be < sibling field value
+     * @category Validation Rule
+     */
+    lessThanSibling(field, errorMessage) {
+        return this.addRule(lessThanRule, errorMessage, {
+            value: field,
+            scope: "sibling",
+        });
+    }
+    /**
+     * Alias for lessThanSibling() - shorter syntax
+     * @category Validation Rule
+     */
+    ltSibling(field, errorMessage) {
+        return this.lessThanSibling(field, errorMessage);
+    }
+    /** Value must be a modulo of the given number */
+    modulo(value, errorMessage) {
+        return this.addRule(moduloRule, errorMessage, { value });
+    }
+    /**
+     * Alias for modulo() - Value must be divisible by the given number
+     */
+    divisibleBy(value, errorMessage) {
+        return this.modulo(value, errorMessage);
+    }
+    /**
+     * Alias for modulo() - Value must be a multiple of the given number
+     */
+    multipleOf(value, errorMessage) {
+        return this.modulo(value, errorMessage);
+    }
+    /**
+     * Alias for modulo() - Value must be a multiple of the given number
+     */
+    modulusOf(value, errorMessage) {
+        return this.modulo(value, errorMessage);
+    }
+    /** Accept only numbers higher than 0 */
+    positive(errorMessage) {
+        return this.addRule(positiveRule, errorMessage);
+    }
+    /** Accept only negative numbers */
+    negative(errorMessage) {
+        return this.addRule(negativeRule, errorMessage);
+    }
+    /** Accept only odd numbers */
+    odd(errorMessage) {
+        return this.addRule(oddRule, errorMessage);
+    }
+    /** Accept only even numbers */
+    even(errorMessage) {
+        return this.addRule(evenRule, errorMessage);
+    }
+    /**
+     * Accept only numbers between the given two numbers or fields (Inclusive)
+     * Smart detection: number or field name
+     *
+     * @category Validation Rule
+     */
+    between(min, max, errorMessage) {
+        return this.addRule(betweenNumbersRule, errorMessage, {
+            min,
+            max,
+            scope: "global",
+        });
+    }
+    /**
+     * Value must be between sibling field values
+     * @category Validation Rule
+     */
+    betweenSibling(minField, maxField, errorMessage) {
+        return this.addRule(betweenNumbersRule, errorMessage, {
+            min: minField,
+            max: maxField,
+            scope: "sibling",
+        });
+    }
+    // Enum and value membership methods are inherited from PrimitiveValidator.
+    /**
+     * Value (as a string) must be exactly this many characters.
+     * Useful for fixed-format numeric codes (e.g. 4-digit PIN).
+     */
+    length(length, errorMessage) {
+        return this.addRule(lengthRule, errorMessage, { length });
+    }
+    /** Value (as string representation) length must be ≥ min */
+    minLength(length, errorMessage) {
+        return this.addRule(minLengthRule, errorMessage, { minLength: length });
+    }
+    /** Value (as string representation) length must be ≤ max */
+    maxLength(length, errorMessage) {
+        return this.addRule(maxLengthRule, errorMessage, { maxLength: length });
+    }
+    // Mutators
+    /**
+     * Convert value to its absolute value
+     */
+    abs() {
+        return this.addMutator(absMutator);
+    }
+    /**
+     * Round value up to the nearest integer
+     */
+    ceil() {
+        return this.addMutator(ceilMutator);
+    }
+    /**
+     * Round value down to the nearest integer
+     */
+    floor() {
+        return this.addMutator(floorMutator);
+    }
+    /**
+     * Round value to the nearest integer or specified decimals
+     */
+    round(decimals = 0) {
+        return this.addMutator(roundMutator, { decimals });
+    }
+    /**
+     * Format number using fixed-point notation
+     */
+    toFixed(decimals = 2) {
+        return this.addMutator(toFixedMutator, { decimals });
+    }
+    /**
+     * @inheritdoc
+     *
+     * Returns `{ type: "number" }` with numeric constraint keywords.
+     * IntValidator overrides `type` to `"integer"`.
+     *
+     * @note Sibling-scoped rules (minSibling, maxSibling, etc.) are not representable
+     * in JSON Schema and are silently omitted.
+     *
+     * @example
+     * ```ts
+     * v.number().min(0).max(100).toJsonSchema("draft-2020-12")
+     * // → { type: "number", minimum: 0, maximum: 100 }
+     * ```
+     */
+    toJsonSchema(target = "draft-2020-12") {
+        return this.buildNumberJsonSchema("number", target);
+    }
+    /**
+     * Shared logic for number/integer JSON Schema generation.
+     * Called by NumberValidator.toJsonSchema() (→ type: "number")
+     * and IntValidator.toJsonSchema() (→ type: "integer").
+     */
+    buildNumberJsonSchema(type, target) {
+        const schema = { type };
+        // minimum (inclusive)
+        const minOpts = getRuleOptions(this.rules, "min");
+        if (minOpts?.min !== undefined && typeof minOpts.min === "number") {
+            schema.minimum = minOpts.min;
+        }
+        // maximum (inclusive)
+        const maxOpts = getRuleOptions(this.rules, "max");
+        if (maxOpts?.max !== undefined && typeof maxOpts.max === "number") {
+            schema.maximum = maxOpts.max;
+        }
+        // between (inclusive range)
+        const betweenOpts = getRuleOptions(this.rules, "betweenNumbers");
+        if (betweenOpts) {
+            if (typeof betweenOpts.min === "number")
+                schema.minimum = betweenOpts.min;
+            if (typeof betweenOpts.max === "number")
+                schema.maximum = betweenOpts.max;
+        }
+        // greaterThan (>) → exclusiveMinimum
+        const gtOpts = getRuleOptions(this.rules, "greaterThan");
+        if (gtOpts?.value !== undefined && typeof gtOpts.value === "number") {
+            if (target === "draft-07") {
+                schema.minimum = gtOpts.value;
+                schema.exclusiveMinimum = true;
+            }
+            else {
+                schema.exclusiveMinimum = gtOpts.value;
+            }
+        }
+        // lessThan (<) → exclusiveMaximum
+        const ltOpts = getRuleOptions(this.rules, "lessThan");
+        if (ltOpts?.value !== undefined && typeof ltOpts.value === "number") {
+            if (target === "draft-07") {
+                schema.maximum = ltOpts.value;
+                schema.exclusiveMaximum = true;
+            }
+            else {
+                schema.exclusiveMaximum = ltOpts.value;
+            }
+        }
+        // multipleOf / modulo
+        const moduloOpts = getRuleOptions(this.rules, "modulo");
+        if (moduloOpts?.value !== undefined && typeof moduloOpts.value === "number") {
+            schema.multipleOf = moduloOpts.value;
+        }
+        // enum (from PrimitiveValidator.in / .enum)
+        const inOpts = getRuleOptions(this.rules, "in");
+        if (inOpts?.values && Array.isArray(inOpts.values)) {
+            schema.enum = inOpts.values;
+        }
+        if (this.isNullable)
+            applyNullable(schema, target);
+        return schema;
+    }
+}export{NumberValidator};//# sourceMappingURL=number-validator.js.map

package/esm/validators/number-validator.js.map

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

package/esm/validators/numeric-validator.d.ts

@@ -0,0 +1,15 @@
+import { NumberValidator } from "./number-validator";
+/**
+ * Numeric validator class - base for Int and Float validators either as number or string
+ */
+export declare class NumericValidator extends NumberValidator {
+    /**
+     * Constructor
+     */
+    constructor(errorMessage?: string);
+    /**
+     * Check if value is a numeric type
+     */
+    matchesType(value: any): boolean;
+}
+//# sourceMappingURL=numeric-validator.d.ts.map

package/esm/validators/numeric-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric-validator.d.ts","sourceRoot":"","sources":["../../src/validators/numeric-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD;;OAEG;gBACgB,YAAY,CAAC,EAAE,MAAM;IAKxC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;CAGxC"}

package/esm/validators/numeric-validator.js

@@ -0,0 +1,18 @@
+import {isNumeric}from'@mongez/supportive-is';import {numericMutator}from'../mutators/number-mutators.js';import {NumberValidator}from'./number-validator.js';/**
+ * Numeric validator class - base for Int and Float validators either as number or string
+ */
+class NumericValidator extends NumberValidator {
+    /**
+     * Constructor
+     */
+    constructor(errorMessage) {
+        super(errorMessage);
+        this.addMutableMutator(numericMutator);
+    }
+    /**
+     * Check if value is a numeric type
+     */
+    matchesType(value) {
+        return isNumeric(value);
+    }
+}export{NumericValidator};//# sourceMappingURL=numeric-validator.js.map

package/esm/validators/numeric-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric-validator.js","sources":["../../src/validators/numeric-validator.ts"],"sourcesContent":[null],"names":[],"mappings":"8JAIA;;AAEG;AACG,MAAO,gBAAiB,SAAQ,eAAe,CAAA;AACnD;;AAEG;AACH,IAAA,WAAA,CAAmB,YAAqB,EAAA;QACtC,KAAK,CAAC,YAAY,CAAC,CAAC;AACpB,QAAA,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;KACxC;AAED;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;AAC3B,QAAA,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;KACzB;AACF"}

package/esm/validators/object-validator.d.ts

@@ -0,0 +1,233 @@
+import type { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema";
+import type { Schema, SchemaContext, ValidationResult } from "../types";
+import { BaseValidator } from "./base-validator";
+/**
+ * Object validator class with generic schema type for proper type inference
+ */
+export declare class ObjectValidator<TSchema extends Schema = Schema> extends BaseValidator {
+    schema: TSchema;
+    protected shouldAllowUnknown: boolean;
+    protected allowedKeys: string[];
+    protected hasUnknownKeyRule: boolean;
+    constructor(schema: TSchema, errorMessage?: string);
+    /**
+     * Check if value is an object type (plain object, not array or date)
+     */
+    matchesType(value: any): boolean;
+    /** Strip unknown keys from the data */
+    stripUnknown(): this;
+    /** Add list of allowed keys that could be in the data but not necessarily validated */
+    allow(...keys: string[]): this;
+    /** Trim values of the object properties */
+    trim(recursive?: boolean): this;
+    /** Whether to allow unknown properties
+     * Please note it will allow only unknown direct children keys, not nested children keys
+     */
+    allowUnknown(allow?: boolean): this;
+    /**
+     * Create a copy of this object validator with the same configuration
+     * Copies schema, rules, mutators, transformers, and object-specific settings
+     *
+     * @returns A new ObjectValidator instance with copied configuration
+     *
+     * @example
+     * ```ts
+     * const baseUser = v.object({ name: v.string() }).allowUnknown();
+     * const userCopy = baseUser.clone();
+     * // userCopy has the same schema and allowUnknown setting
+     * ```
+     */
+    clone(keys?: string[]): this;
+    /**
+     * Extend this schema with additional fields
+     * Clones the current validator and adds new fields to the schema
+     * **Keeps original configuration** (allowUnknown, stripUnknown, etc.)
+     *
+     * If an ObjectValidator is provided, only its schema is used - its configuration is ignored.
+     * This is useful for creating reusable field collections that can be added to different schemas.
+     *
+     * @param schemaOrValidator - Plain schema object or ObjectValidator to extend with
+     * @returns A new ObjectValidator with merged schema and original configuration
+     *
+     * @example
+     * ```ts
+     * // Extend with plain schema
+     * const baseUser = v.object({
+     *   name: v.string().required(),
+     *   email: v.string().email().required()
+     * }).allowUnknown();
+     *
+     * const adminUser = baseUser.extend({
+     *   role: v.string().in(['admin', 'superadmin']).required()
+     * });
+     * // adminUser has: name, email, role
+     * // adminUser keeps: allowUnknown() from base ✅
+     *
+     * // Extend with ObjectValidator (only schema is used)
+     * const auditFields = v.object({
+     *   createdAt: v.date().required(),
+     *   updatedAt: v.date().required()
+     * }).stripUnknown(); // This config is ignored!
+     *
+     * const fullUser = baseUser.extend(auditFields);
+     * // fullUser has: name, email, createdAt, updatedAt
+     * // fullUser keeps: allowUnknown() from base (NOT stripUnknown from auditFields) ✅
+     *
+     * // Chain multiple extends
+     * const complexSchema = baseUser
+     *   .extend(auditFields)
+     *   .extend({ metadata: v.object({}) });
+     * ```
+     */
+    extend<TExtension extends Schema>(schemaOrValidator: TExtension | ObjectValidator<TExtension>): ObjectValidator<TSchema & TExtension>;
+    /**
+     * Merge with another ObjectValidator
+     * Clones current validator, merges schemas, and **overrides configuration** with other validator's config
+     *
+     * Unlike extend(), merge() combines both schemas AND configurations.
+     * The other validator's configuration (allowUnknown, stripUnknown, etc.) takes precedence.
+     *
+     * @param validator - Another ObjectValidator to merge with
+     * @returns A new ObjectValidator with merged schema and configuration
+     *
+     * @example
+     * ```ts
+     * const baseUser = v.object({
+     *   name: v.string().required()
+     * }).allowUnknown();
+     *
+     * const timestamps = v.object({
+     *   createdAt: v.date().required(),
+     *   updatedAt: v.date().required()
+     * }).stripUnknown();
+     *
+     * const merged = baseUser.merge(timestamps);
+     * // merged has: name, createdAt, updatedAt
+     * // merged config: stripUnknown() from timestamps (overrides allowUnknown) ✅
+     *
+     * // Chain multiple merges
+     * const full = baseUser.merge(timestamps).merge(softDeleteSchema);
+     * ```
+     */
+    merge<TMerge extends Schema>(validator: ObjectValidator<TMerge>): ObjectValidator<TSchema & TMerge>;
+    /**
+     * Create a new schema with only the specified fields
+     * Clones the current validator and keeps only the selected fields
+     * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)
+     *
+     * @param keys - Field names to keep in the schema
+     * @returns A new ObjectValidator with only the picked fields
+     *
+     * @example
+     * ```ts
+     * const fullUser = v.object({
+     *   id: v.int().required(),
+     *   name: v.string().required(),
+     *   email: v.string().email().required(),
+     *   password: v.string().required(),
+     *   role: v.string()
+     * }).allowUnknown();
+     *
+     * // For login - only need email and password
+     * const loginSchema = fullUser.pick('email', 'password');
+     * // loginSchema has: { email, password }
+     * // loginSchema keeps: allowUnknown() ✅
+     *
+     * // For public profile
+     * const publicSchema = fullUser.pick('id', 'name', 'role');
+     * // publicSchema has: { id, name, role }
+     * ```
+     */
+    pick<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Pick<TSchema, K>>;
+    /**
+     * Mark all or the given schema fields as optional
+     */
+    partial<K extends keyof TSchema>(...keys: K[]): this;
+    /**
+     * Make the all or the given fields as required
+     */
+    requiredFields<K extends keyof TSchema>(...keys: K[]): this;
+    /**
+     * Create a new schema excluding the specified fields
+     * Clones the current validator and removes the specified fields
+     * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)
+     *
+     * @param keys - Field names to exclude from the schema
+     * @returns A new ObjectValidator without the excluded fields
+     *
+     * @example
+     * ```ts
+     * const fullUser = v.object({
+     *   id: v.int().required(),
+     *   name: v.string().required(),
+     *   email: v.string().email().required(),
+     *   password: v.string().required(),
+     *   role: v.string()
+     * }).allowUnknown();
+     *
+     * // For updates - exclude id
+     * const updateSchema = fullUser.without('id');
+     * // updateSchema has: { name, email, password, role }
+     * // updateSchema keeps: allowUnknown() ✅
+     *
+     * // For public API - exclude sensitive fields
+     * const publicSchema = fullUser.without('password', 'role');
+     * // publicSchema has: { id, name, email }
+     *
+     * // Combine with other methods
+     * const patchSchema = fullUser.without('id', 'password');
+     * // patchSchema has: { name, email, role }
+     * ```
+     */
+    without<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Omit<TSchema, K>>;
+    /** Mutate the data */
+    mutate(data: any, context: SchemaContext): any;
+    /** Validate the data */
+    validate(data: any, context?: SchemaContext): Promise<ValidationResult>;
+    /**
+     * Check if a validator is a computed or managed field
+     * ManagedValidator extends ComputedValidator, so instanceof catches both
+     */
+    private isComputedValidator;
+    /**
+     * Get all computed/managed fields from the schema
+     */
+    private getComputedFields;
+    /**
+     * @inheritdoc
+     *
+     * Recursively generates JSON Schema for all input fields in the schema.
+     * Computed/managed fields are skipped — they have no input representation.
+     *
+     * **Standard targets** (`draft-2020-12`, `draft-07`, `openapi-3.0`):
+     * - Fields marked `.optional()` are excluded from `required`.
+     *
+     * **`openai-strict` target** (OpenAI Structured Outputs):
+     * - ALL fields appear in `required` — OpenAI rejects schemas with optional fields.
+     * - Optional fields are instead expressed as nullable types:
+     *   `{ type: ["string", "null"] }` so the model can output `null` for them.
+     * - Recursively applies `openai-strict` to all nested objects.
+     *
+     * @example
+     * ```ts
+     * v.object({
+     *   name: v.string().required(),
+     *   age: v.int().optional(),
+     * }).toJsonSchema("draft-2020-12")
+     * // → { type: "object",
+     * //     properties: { name: { type: "string" }, age: { type: "integer" } },
+     * //     required: ["name"], additionalProperties: false }
+     *
+     * v.object({
+     *   name: v.string().required(),
+     *   age: v.int().optional(),
+     * }).toJsonSchema("openai-strict")
+     * // → { type: "object",
+     * //     properties: { name: { type: "string" }, age: { type: ["integer", "null"] } },
+     * //     required: ["name", "age"],   ← all fields
+     * //     additionalProperties: false }
+     * ```
+     */
+    toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
+}
+//# sourceMappingURL=object-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object-validator.d.ts","sourceRoot":"","sources":["../../src/validators/object-validator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEzF,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;GAEG;AACH,qBAAa,eAAe,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa;IAMxE,MAAM,EAAE,OAAO;IALxB,SAAS,CAAC,kBAAkB,UAAS;IACrC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAM;IACrC,SAAS,CAAC,iBAAiB,UAAS;gBAG3B,MAAM,EAAE,OAAO,EACtB,YAAY,CAAC,EAAE,MAAM;IAMvB;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIvC,uCAAuC;IAChC,YAAY;IASnB,uFAAuF;IAChF,KAAK,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE;IAM9B,2CAA2C;IACpC,IAAI,CAAC,SAAS,UAAO;IAK5B;;OAEG;IACI,YAAY,CAAC,KAAK,UAAO;IAMhC;;;;;;;;;;;;OAYG;IACa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAuB5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACI,MAAM,CAAC,UAAU,SAAS,MAAM,EACrC,iBAAiB,EAAE,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC,GAC1D,eAAe,CAAC,OAAO,GAAG,UAAU,CAAC;IAgBxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACI,KAAK,CAAC,MAAM,SAAS,MAAM,EAChC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,GACjC,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC;IAgCpC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACI,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAiBrF;;OAEG;IACI,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE;IAcpD;;OAEG;IACI,cAAc,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE;IAc3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACI,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAiBxF,sBAAsB;IACf,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa;IAK/C,wBAAwB;IACX,QAAQ,CACnB,IAAI,EAAE,GAAG,EACT,OAAO,GAAE,aAA6C,GACrD,OAAO,CAAC,gBAAgB,CAAC;IA4H5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACa,YAAY,CAAC,MAAM,GAAE,gBAAkC,GAAG,gBAAgB;CAoC3F"}