exisjs 0.7.6 → 0.7.8

package/dist/swagger/types.d.ts

@@ -0,0 +1,190 @@
+export interface OpenApiInfo {
+    title: string;
+    version: string;
+    description?: string;
+    termsOfService?: string;
+    contact?: {
+        name?: string;
+        url?: string;
+        email?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+}
+export interface OpenApiServer {
+    url: string;
+    description?: string;
+    variables?: Record<string, {
+        default: string;
+        enum?: string[];
+        description?: string;
+    }>;
+}
+export interface OpenApiTag {
+    name: string;
+    description?: string;
+    externalDocs?: {
+        description?: string;
+        url: string;
+    };
+}
+export interface SecuritySchemeObject {
+    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+    description?: string;
+    name?: string;
+    in?: 'query' | 'header' | 'cookie';
+    scheme?: string;
+    bearerFormat?: string;
+    flows?: Record<string, any>;
+    openIdConnectUrl?: string;
+}
+export interface SwaggerConfig {
+    /**
+     * Whether to enable the interactive API documentation and OpenAPI spec endpoint.
+     * Default: `false` (can be enabled globally or per environment).
+     */
+    enabled?: boolean;
+    /**
+     * The base URL path where the interactive documentation UI will be mounted.
+     * Default: `'/docs'`
+     */
+    path?: string;
+    /**
+     * The URL path where the raw OpenAPI 3.1 JSON specification will be served.
+     * Default: `'/docs/json'`
+     */
+    specPath?: string;
+    /**
+     * API Title shown in the documentation UI.
+     * Default: `'ExisJS API Documentation'`
+     */
+    title?: string;
+    /**
+     * API Version string.
+     * Default: `'1.0.0'`
+     */
+    version?: string;
+    /**
+     * Detailed API description or overview markdown.
+     */
+    description?: string;
+    /**
+     * Terms of Service URL.
+     */
+    termsOfService?: string;
+    /**
+     * Contact information for the API.
+     */
+    contact?: OpenApiInfo['contact'];
+    /**
+     * License information for the API.
+     */
+    license?: OpenApiInfo['license'];
+    /**
+     * List of target servers (environments) for the API.
+     */
+    servers?: OpenApiServer[];
+    /**
+     * Global list of tags with descriptions for organizing operations in groups.
+     */
+    tags?: OpenApiTag[];
+    /**
+     * Global security requirements applied across all endpoints unless overridden.
+     */
+    security?: Record<string, string[]>[];
+    /**
+     * Reusable security schemes (e.g. Bearer JWT, API Keys, OAuth2).
+     */
+    securitySchemes?: Record<string, SecuritySchemeObject>;
+    /**
+     * The interactive documentation UI engine to render.
+     * Options: `'swagger-ui'` | `'scalar'` (Default: `'swagger-ui'`)
+     */
+    ui?: 'swagger-ui' | 'scalar';
+    /**
+     * Custom CSS styling injected into the documentation UI.
+     */
+    customCss?: string;
+    /**
+     * Custom favicon URL for the documentation page.
+     */
+    customFavicon?: string;
+    /**
+     * Transform or mutate the generated OpenAPI specification before serving.
+     */
+    transformSpec?: (spec: OpenApiSpec) => OpenApiSpec | void;
+}
+export interface OpenApiParameter {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    schema: Record<string, any>;
+    example?: any;
+}
+export interface OpenApiRequestBody {
+    description?: string;
+    required?: boolean;
+    content: Record<string, {
+        schema: Record<string, any>;
+        example?: any;
+    }>;
+}
+export interface OpenApiResponse {
+    description: string;
+    headers?: Record<string, any>;
+    content?: Record<string, {
+        schema: Record<string, any>;
+        example?: any;
+    }>;
+}
+export interface OpenApiOperation {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    parameters?: OpenApiParameter[];
+    requestBody?: OpenApiRequestBody;
+    responses: Record<string, OpenApiResponse>;
+    deprecated?: boolean;
+    security?: Record<string, string[]>[];
+    externalDocs?: {
+        url: string;
+        description?: string;
+    };
+}
+export interface OpenApiSpec {
+    openapi: string;
+    info: OpenApiInfo;
+    servers?: OpenApiServer[];
+    paths: Record<string, Record<string, OpenApiOperation>>;
+    components?: {
+        schemas?: Record<string, any>;
+        securitySchemes?: Record<string, SecuritySchemeObject>;
+        parameters?: Record<string, OpenApiParameter>;
+        responses?: Record<string, OpenApiResponse>;
+    };
+    security?: Record<string, string[]>[];
+    tags?: OpenApiTag[];
+}
+export interface RouteDocMetadata {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    operationId?: string;
+    deprecated?: boolean;
+    security?: Record<string, string[]>[];
+    responses?: Record<number | string, {
+        description?: string;
+        schema?: any;
+    }>;
+    externalDocs?: {
+        url: string;
+        description?: string;
+    };
+    excludeFromDocs?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/swagger/types.d.ts.map

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

package/dist/swagger/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/swagger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swagger/types.ts"],"names":[],"mappings":""}

package/dist/swagger/ui.d.ts

@@ -0,0 +1,6 @@
+import type { SwaggerConfig } from './types';
+/**
+ * Generates the HTML markup for interactive Swagger UI or Scalar API documentation.
+ */
+export declare function renderDocumentationHtml(config: SwaggerConfig): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/swagger/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAyGrE"}

package/dist/swagger/ui.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderDocumentationHtml = renderDocumentationHtml;
+/**
+ * Generates the HTML markup for interactive Swagger UI or Scalar API documentation.
+ */
+function renderDocumentationHtml(config) {
+    const uiEngine = config.ui || 'swagger-ui';
+    const title = config.title || 'ExisJS API Documentation';
+    const specPath = config.specPath || '/docs/json';
+    const customCss = config.customCss || '';
+    const customFavicon = config.customFavicon ||
+        'https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/favicon-32x32.png';
+    if (uiEngine === 'scalar') {
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(title)}</title>
+  <link rel="icon" type="image/png" href="${escapeHtml(customFavicon)}">
+  <style>
+    body { margin: 0; padding: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; }
+    ${customCss}
+  </style>
+</head>
+<body>
+  <script
+    id="api-reference"
+    data-url="${escapeHtml(specPath)}"
+    data-configuration='{"theme":"purple","layout":"modern"}'
+    src="https://cdn.jsdelivr.net/npm/@scalar/api-reference@1.25.105/dist/browser/standalone.min.js">
+  </script>
+</body>
+</html>`;
+    }
+    // Default: Swagger UI
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(title)}</title>
+  <link rel="icon" type="image/png" href="${escapeHtml(customFavicon)}">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui.css">
+  <style>
+    html {
+      box-sizing: border-box;
+      overflow: -moz-scrollbars-vertical;
+      overflow-y: scroll;
+    }
+    *, *:before, *:after {
+      box-sizing: inherit;
+    }
+    body {
+      margin: 0;
+      background: #fafafa;
+    }
+    .topbar {
+      display: none !important;
+    }
+    .swagger-ui .info {
+      margin: 25px 0 20px 0;
+    }
+    .swagger-ui .info .title {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+      font-weight: 700;
+      color: #1e293b;
+    }
+    .swagger-ui .btn.authorize {
+      background-color: #7c3aed;
+      border-color: #7c3aed;
+      color: #fff;
+    }
+    .swagger-ui .btn.authorize svg {
+      fill: #fff;
+    }
+    ${customCss}
+  </style>
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui-bundle.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui-standalone-preset.js"></script>
+  <script>
+    window.onload = function() {
+      window.ui = SwaggerUIBundle({
+        url: "${escapeHtml(specPath)}",
+        dom_id: '#swagger-ui',
+        deepLinking: true,
+        presets: [
+          SwaggerUIBundle.presets.apis,
+          SwaggerUIStandalonePreset
+        ],
+        plugins: [
+          SwaggerUIBundle.plugins.DownloadUrl
+        ],
+        layout: "StandaloneLayout",
+        displayRequestDuration: true,
+        docExpansion: "list",
+        filter: true,
+        showExtensions: true,
+        showCommonExtensions: true
+      });
+    };
+  </script>
+</body>
+</html>`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+//# sourceMappingURL=ui.js.map

package/dist/swagger/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":";;AAKA,0DAyGC;AA5GD;;GAEG;AACH,SAAgB,uBAAuB,CAAC,MAAqB;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,IAAI,YAAY,CAAA;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,0BAA0B,CAAA;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAA;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAA;IACxC,MAAM,aAAa,GACjB,MAAM,CAAC,aAAa;QACpB,wFAAwF,CAAA;IAE1F,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO;;;;;WAKA,UAAU,CAAC,KAAK,CAAC;4CACgB,UAAU,CAAC,aAAa,CAAC;;;MAG/D,SAAS;;;;;;gBAMC,UAAU,CAAC,QAAQ,CAAC;;;;;QAK5B,CAAA;IACN,CAAC;IAED,sBAAsB;IACtB,OAAO;;;;;WAKE,UAAU,CAAC,KAAK,CAAC;4CACgB,UAAU,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkC/D,SAAS;;;;;;;;;;gBAUC,UAAU,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;QAoB5B,CAAA;AACR,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC"}

package/dist/validator/builder.d.ts

@@ -0,0 +1,223 @@
+import { TexString, TexNumber, TexBoolean, TexArray, TexEnum, TexLiteral, TexUnion, TexDate, TexRecord, TexAny, TexFile, ResolveSchema } from './tex-types';
+import type { TexBaseOptions, TexStringOptions, TexNumberOptions, TexBooleanOptions, TexArrayOptions, TexEnumOptions, TexObjectOptions, TexFileOptions, TexPasswordOptions, TexDateOptions } from './types';
+import { TexEngine } from './engine';
+/**
+ * Ultra-high performance declarative schema builder powered by the native Rust validator.
+ */
+export declare class TexBuilder {
+    /**
+     * Defines a string schema with built-in sanitization and security protections.
+     *
+     * @param opts Validation rules and transformations (min, max, trim, toLowerCase, escapeHtml, etc.)
+     * @returns Strongly typed string schema descriptor
+     *
+     * @example
+     * ```ts
+     * const username = tex.string({ min: 3, max: 20, trim: true, toLowerCase: true })
+     * ```
+     */
+    string<O extends TexStringOptions = TexStringOptions>(opts?: O): TexString<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a number schema with bounds and optional auto-coercion from string query parameters.
+     *
+     * @param opts Validation rules (min, max, coerce, default)
+     * @returns Strongly typed number schema descriptor
+     *
+     * @example
+     * ```ts
+     * const age = tex.number({ min: 18, max: 120, coerce: true })
+     * ```
+     */
+    number<O extends TexNumberOptions = TexNumberOptions>(opts?: O): TexNumber<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a boolean schema with optional string-to-boolean coercion (`"true"`, `"false"`).
+     *
+     * @param opts Validation rules (coerce, optional, default)
+     * @returns Strongly typed boolean schema descriptor
+     *
+     * @example
+     * ```ts
+     * const isActive = tex.boolean({ coerce: true, default: true })
+     * ```
+     */
+    boolean<O extends TexBooleanOptions = TexBooleanOptions>(opts?: O): TexBoolean<O['optional'] extends true ? true : false>;
+    /**
+     * Defines an email schema verified natively against RFC standards.
+     *
+     * @param opts Validation and formatting rules
+     * @returns Strongly typed email string schema descriptor
+     *
+     * @example
+     * ```ts
+     * const userEmail = tex.email({ trim: true, toLowerCase: true })
+     * ```
+     */
+    email<O extends TexStringOptions = TexStringOptions>(opts?: O): TexString<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a UUID v1 or v4 schema.
+     *
+     * @param opts UUID options including optional version specification
+     * @returns Strongly typed UUID string schema descriptor
+     */
+    uuid<O extends TexStringOptions & {
+        version?: 1 | 4;
+    } = TexStringOptions & {
+        version?: 1 | 4;
+    }>(opts?: O): TexString<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a CUID (Collision-resistant Unique Identifier) schema.
+     */
+    cuid<O extends TexStringOptions = TexStringOptions>(opts?: O): TexString<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a Credit Card schema validated via the Luhn checksum algorithm.
+     */
+    creditCard<O extends TexStringOptions = TexStringOptions>(opts?: O): TexString<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a secure password schema with enforcement for length, numbers, symbols, and casing.
+     *
+     * @param opts Complexity constraints (min, requireNumbers, requireSymbols, requireUppercase, requireLowercase)
+     * @returns Strongly typed password schema descriptor
+     *
+     * @example
+     * ```ts
+     * const password = tex.password({
+     *   min: 8,
+     *   requireNumbers: true,
+     *   requireSymbols: true,
+     *   requireUppercase: true
+     * })
+     * ```
+     */
+    password<O extends TexPasswordOptions = TexPasswordOptions>(opts?: O): TexString<O['optional'] extends true ? true : false>;
+    /**
+     * Defines an array schema with item validation, bounds, and automatic coercion from comma-delimited strings.
+     *
+     * @param schema Schema descriptor for each item in the array
+     * @param opts Array rules (min, max, dedupe, coerce, default)
+     * @returns Strongly typed array schema descriptor
+     *
+     * @example
+     * ```ts
+     * const tags = tex.array(tex.string({ trim: true }), { min: 1, max: 10, dedupe: true })
+     * ```
+     */
+    array<T, O extends TexArrayOptions<T> = TexArrayOptions<T>>(schema: T, opts?: O): TexArray<T, O['optional'] extends true ? true : false>;
+    /**
+     * Defines an enum schema restricted to an exact list of allowed string literals.
+     *
+     * @param values Array of allowed string values
+     * @param opts Enum options (optional, default)
+     * @returns Strongly typed enum schema descriptor
+     *
+     * @example
+     * ```ts
+     * const role = tex.enum(['admin', 'user', 'guest'], { default: 'user' })
+     * ```
+     */
+    enum<T extends string, O extends TexEnumOptions<T> = TexEnumOptions<T>>(values: T[], opts?: O): TexEnum<T, O['optional'] extends true ? true : false>;
+    /**
+     * Defines an exact literal value schema (e.g. `'v1'`, `42`, `true`).
+     */
+    literal<T extends string | number | boolean, O extends TexBaseOptions = TexBaseOptions>(value: T, opts?: O): TexLiteral<T, O['optional'] extends true ? true : false>;
+    /**
+     * Defines a union schema that succeeds if any of the provided candidate schemas match.
+     *
+     * @example
+     * ```ts
+     * const idOrEmail = tex.union([tex.number({ coerce: true }), tex.email()])
+     * ```
+     */
+    union<T extends any[], O extends TexBaseOptions = TexBaseOptions>(schemas: T, opts?: O): TexUnion<T, O['optional'] extends true ? true : false>;
+    /**
+     * Defines a date schema with bounds checking and automatic coercion from ISO strings or timestamps.
+     *
+     * @param opts Date options (minDate, maxDate, coerce, default)
+     * @returns Strongly typed Date schema descriptor
+     *
+     * @example
+     * ```ts
+     * const createdAt = tex.date({ coerce: true, minDate: '2024-01-01' })
+     * ```
+     */
+    date<O extends TexDateOptions = TexDateOptions>(opts?: O): TexDate<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a dynamic key-value record schema (e.g. `Record<string, T>`).
+     */
+    record<T, O extends TexBaseOptions = TexBaseOptions>(schema: T, opts?: O): TexRecord<T, O['optional'] extends true ? true : false>;
+    /**
+     * Defines an unconstrained pass-through schema.
+     */
+    any<O extends TexBaseOptions = TexBaseOptions>(opts?: O): TexAny<O['optional'] extends true ? true : false>;
+    /**
+     * Defines a file upload validation schema.
+     */
+    file<O extends TexFileOptions = TexFileOptions>(opts?: O): TexFile<O['optional'] extends true ? true : false>;
+    /**
+     * Compiles an object structure into a fast `TexEngine` validator instance.
+     *
+     * @param schema Object map containing field definitions
+     * @param opts Object options (e.g. `{ strict: true }` to reject unknown fields)
+     * @returns Compiled `TexEngine` validator
+     *
+     * @example
+     * ```ts
+     * const UserSchema = tex.object({
+     *   id: tex.number({ coerce: true }),
+     *   name: tex.string({ min: 2 }),
+     *   email: tex.email()
+     * }, { strict: true })
+     *
+     * const user = UserSchema.parse(req.body)
+     * ```
+     */
+    object<T extends Record<string, any>>(schema: T, opts?: TexObjectOptions): TexEngine<ResolveSchema<T>>;
+    /**
+     * Dedicated Environment Schema parser (`tex.env`).
+     * Automatically coerces numbers, booleans, dates, and arrays from `process.env` string values,
+     * while preserving strict type validation and defaults.
+     *
+     * @param schema Environment variable schema definition
+     * @param opts Schema configuration
+     * @returns Compiled `TexEngine` tailored for environment variable parsing
+     *
+     * @example
+     * ```ts
+     * export const env = tex.env({
+     *   PORT: tex.number({ default: 3000 }),
+     *   NODE_ENV: tex.enum(['development', 'production', 'test'], { default: 'development' }),
+     *   DATABASE_URL: tex.string(),
+     *   ENABLE_METRICS: tex.boolean({ default: false })
+     * }).parse(process.env)
+     * ```
+     */
+    env<T extends Record<string, any>>(schema: T, opts?: TexObjectOptions): TexEngine<ResolveSchema<T>>;
+    /**
+     * Helper that builds standard query pagination schema (`page`, `limit`, `sort`, `order`).
+     *
+     * @param options Configuration for default and maximum limit
+     * @returns Compiled pagination query validator
+     *
+     * @example
+     * ```ts
+     * export default controller({
+     *   listUsers: route.get('/', {
+     *     query: tex.pagination({ defaultLimit: 25, maxLimit: 100 }),
+     *     async handle({ query }) {
+     *       const { skip, limit } = getPaginationSkip(query)
+     *       return UserService.find(skip, limit)
+     *     }
+     *   })
+     * })
+     * ```
+     */
+    pagination(options?: {
+        defaultLimit?: number;
+        maxLimit?: number;
+    }): TexEngine<ResolveSchema<{
+        page: TexNumber<true>;
+        limit: TexNumber<true>;
+        sort: TexString<true>;
+        order: TexEnum<"asc" | "desc", true>;
+    }>>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/validator/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/validator/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,OAAO,EACP,aAAa,EACd,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC;;GAEG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAClD,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAsBvD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAClD,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAavD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EACrD,IAAI,CAAC,EAAE,CAAC,GACP,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAWxD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EACjD,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAavD;;;;;OAKG;IACH,IAAI,CACF,CAAC,SAAS,gBAAgB,GAAG;QAAE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,GAAG,gBAAgB,GAAG;QACpE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;KAChB,EACD,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAWjE;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAChD,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAUvD;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EACtD,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAWvD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,EACxD,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAgBvD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EACxD,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,CAAC,GACP,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAiCzD;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EACpE,MAAM,EAAE,CAAC,EAAE,EACX,IAAI,CAAC,EAAE,CAAC,GACP,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAWxD;;OAEG;IACH,OAAO,CACL,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EACnC,CAAC,SAAS,cAAc,GAAG,cAAc,EAEzC,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE,CAAC,GACP,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAW3D;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,EAC9D,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,CAAC,GACP,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAYzD;;;;;;;;;;OAUG;IACH,IAAI,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5C,IAAI,CAAC,EAAE,CAAC,GACP,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAarD;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,EACjD,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,CAAC,GACP,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAY1D;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC3C,IAAI,CAAC,EAAE,CAAC,GACP,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAUpD;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5C,IAAI,CAAC,EAAE,CAAC,GACP,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAYrD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,gBAAgB,GACtB,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAe9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,gBAAgB,GACtB,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA2C9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;CAgBlE"}