blendsdk 5.33.0

package/dist/expression/compiler/postgresql-compiler.d.ts

@@ -0,0 +1,56 @@
+/**
+ * PostgreSQL SQL compiler
+ * Compiles AST nodes to PostgreSQL-compatible SQL
+ */
+import { ParameterManager } from '../core/parameter-manager.js';
+import { ASTNode } from '../core/types.js';
+/**
+ * PostgreSQL compiler
+ */
+export declare class PostgreSQLCompiler {
+    private readonly paramManager;
+    private optimizations;
+    private warnings;
+    constructor(paramManager: ParameterManager);
+    /**
+     * Compile AST to SQL
+     */
+    compile(ast: ASTNode): string;
+    /**
+     * Get applied optimizations
+     */
+    getOptimizations(): string[];
+    /**
+     * Get warnings
+     */
+    getWarnings(): string[];
+    /**
+     * Compile a single AST node
+     */
+    private compileNode;
+    /**
+     * Compile comparison node
+     */
+    private compileComparison;
+    /**
+     * Compile logical node (AND/OR)
+     */
+    private compileLogical;
+    /**
+     * Compile group node (parentheses)
+     */
+    private compileGroup;
+    /**
+     * Compile JSON node
+     */
+    private compileJson;
+    /**
+     * Compile full-text search node
+     */
+    private compileFullText;
+    /**
+     * Compile subquery node
+     */
+    private compileSubquery;
+}
+//# sourceMappingURL=postgresql-compiler.d.ts.map

package/dist/expression/compiler/postgresql-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql-compiler.d.ts","sourceRoot":"","sources":["../../src/compiler/postgresql-compiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,OAAO,EAiBR,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAHzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAgB;gBAEH,YAAY,EAAE,gBAAgB;IAE3D;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI7B;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyDzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuCnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,eAAe;CA2BxB"}

package/dist/expression/compiler/postgresql-compiler.js

@@ -0,0 +1,217 @@
+/**
+ * PostgreSQL SQL compiler
+ * Compiles AST nodes to PostgreSQL-compatible SQL
+ */
+import { ComparisonOperator, JsonOperator, FullTextMode, isComparisonNode, isLogicalNode, isGroupNode, isJsonNode, isFullTextNode, isSubqueryNode, } from '../core/types.js';
+/**
+ * PostgreSQL compiler
+ */
+export class PostgreSQLCompiler {
+    paramManager;
+    optimizations = [];
+    warnings = [];
+    constructor(paramManager) {
+        this.paramManager = paramManager;
+    }
+    /**
+     * Compile AST to SQL
+     */
+    compile(ast) {
+        return this.compileNode(ast);
+    }
+    /**
+     * Get applied optimizations
+     */
+    getOptimizations() {
+        return this.optimizations;
+    }
+    /**
+     * Get warnings
+     */
+    getWarnings() {
+        return this.warnings;
+    }
+    /**
+     * Compile a single AST node
+     */
+    compileNode(node) {
+        if (isComparisonNode(node)) {
+            return this.compileComparison(node);
+        }
+        else if (isLogicalNode(node)) {
+            return this.compileLogical(node);
+        }
+        else if (isGroupNode(node)) {
+            return this.compileGroup(node);
+        }
+        else if (isJsonNode(node)) {
+            return this.compileJson(node);
+        }
+        else if (isFullTextNode(node)) {
+            return this.compileFullText(node);
+        }
+        else if (isSubqueryNode(node)) {
+            return this.compileSubquery(node);
+        }
+        throw new Error(`Unknown node type: ${node.type}`);
+    }
+    /**
+     * Compile comparison node
+     */
+    compileComparison(node) {
+        const { column, operator, parameterNames } = node;
+        switch (operator) {
+            case ComparisonOperator.Equal:
+            case ComparisonOperator.NotEqual:
+            case ComparisonOperator.GreaterThan:
+            case ComparisonOperator.GreaterThanOrEqual:
+            case ComparisonOperator.LessThan:
+            case ComparisonOperator.LessThanOrEqual:
+                if (parameterNames && parameterNames.length > 0) {
+                    const placeholder = this.paramManager.formatParameterPlaceholder(parameterNames[0]);
+                    return `${column} ${operator} ${placeholder}`;
+                }
+                else {
+                    // Column reference (for correlated subqueries)
+                    return `${column} ${operator} ${node.value}`;
+                }
+            case ComparisonOperator.Like:
+            case ComparisonOperator.ILike:
+                if (parameterNames && parameterNames.length > 0) {
+                    const placeholder = this.paramManager.formatParameterPlaceholder(parameterNames[0]);
+                    return `${column} ${operator} ${placeholder}`;
+                }
+                throw new Error('LIKE operator requires a parameter');
+            case ComparisonOperator.Between:
+            case ComparisonOperator.NotBetween:
+                if (parameterNames && parameterNames.length === 2) {
+                    const minPlaceholder = this.paramManager.formatParameterPlaceholder(parameterNames[0]);
+                    const maxPlaceholder = this.paramManager.formatParameterPlaceholder(parameterNames[1]);
+                    return `${column} ${operator} ${minPlaceholder} AND ${maxPlaceholder}`;
+                }
+                throw new Error('BETWEEN operator requires two parameters');
+            case ComparisonOperator.In:
+            case ComparisonOperator.NotIn:
+                if (parameterNames && parameterNames.length > 0) {
+                    const placeholders = parameterNames
+                        .map(name => this.paramManager.formatParameterPlaceholder(name))
+                        .join(', ');
+                    return `${column} ${operator} (${placeholders})`;
+                }
+                // Handle empty IN arrays - return empty parentheses
+                return `${column} ${operator} ()`;
+            case ComparisonOperator.IsNull:
+                return `${column} IS NULL`;
+            case ComparisonOperator.IsNotNull:
+                return `${column} IS NOT NULL`;
+            default:
+                throw new Error(`Unknown comparison operator: ${operator}`);
+        }
+    }
+    /**
+     * Compile logical node (AND/OR)
+     */
+    compileLogical(node) {
+        const left = this.compileNode(node.left);
+        const right = this.compileNode(node.right);
+        return `${left} ${node.operator} ${right}`;
+    }
+    /**
+     * Compile group node (parentheses)
+     */
+    compileGroup(node) {
+        const inner = this.compileNode(node.child);
+        return `(${inner})`;
+    }
+    /**
+     * Compile JSON node
+     */
+    compileJson(node) {
+        const { column, operator, parameterName } = node;
+        if (!parameterName) {
+            throw new Error('JSON operation requires a parameter');
+        }
+        const placeholder = this.paramManager.formatParameterPlaceholder(parameterName);
+        switch (operator) {
+            case JsonOperator.Contains:
+                // PostgreSQL @> operator
+                return `${column} @> ${placeholder}`;
+            case JsonOperator.ContainedBy:
+                // PostgreSQL <@ operator
+                return `${column} <@ ${placeholder}`;
+            case JsonOperator.HasKey:
+                // PostgreSQL ? operator
+                return `${column} ? ${placeholder}`;
+            case JsonOperator.HasAnyKey:
+                // PostgreSQL ?| operator
+                return `${column} ?| ${placeholder}`;
+            case JsonOperator.HasAllKeys:
+                // PostgreSQL ?& operator
+                return `${column} ?& ${placeholder}`;
+            case JsonOperator.PathExists:
+                // PostgreSQL @? operator
+                return `${column} @? ${placeholder}`;
+            default:
+                throw new Error(`Unknown JSON operator: ${operator}`);
+        }
+    }
+    /**
+     * Compile full-text search node
+     */
+    compileFullText(node) {
+        const { columns, mode, language, parameterName } = node;
+        const placeholder = this.paramManager.formatParameterPlaceholder(parameterName);
+        // Build tsvector expression
+        let tsvectorExpr;
+        if (columns.length === 1) {
+            tsvectorExpr = `to_tsvector('${language}', ${columns[0]})`;
+        }
+        else {
+            // Concatenate multiple columns
+            const concatenated = columns.join(" || ' ' || ");
+            tsvectorExpr = `to_tsvector('${language}', ${concatenated})`;
+        }
+        // Build tsquery expression based on mode
+        let tsqueryExpr;
+        switch (mode) {
+            case FullTextMode.Plain:
+                tsqueryExpr = `plainto_tsquery('${language}', ${placeholder})`;
+                break;
+            case FullTextMode.Phrase:
+                tsqueryExpr = `phraseto_tsquery('${language}', ${placeholder})`;
+                break;
+            case FullTextMode.WebSearch:
+                tsqueryExpr = `websearch_to_tsquery('${language}', ${placeholder})`;
+                break;
+            default:
+                tsqueryExpr = `plainto_tsquery('${language}', ${placeholder})`;
+        }
+        return `${tsvectorExpr} @@ ${tsqueryExpr}`;
+    }
+    /**
+     * Compile subquery node
+     */
+    compileSubquery(node) {
+        const { column, operator, subquery } = node;
+        const subquerySQL = this.compileNode(subquery);
+        switch (operator) {
+            case 'EXISTS':
+                return `EXISTS (SELECT 1 WHERE ${subquerySQL})`;
+            case 'NOT EXISTS':
+                return `NOT EXISTS (SELECT 1 WHERE ${subquerySQL})`;
+            case 'IN':
+                if (!column) {
+                    throw new Error('IN subquery requires a column');
+                }
+                return `${column} IN (SELECT * WHERE ${subquerySQL})`;
+            case 'NOT IN':
+                if (!column) {
+                    throw new Error('NOT IN subquery requires a column');
+                }
+                return `${column} NOT IN (SELECT * WHERE ${subquerySQL})`;
+            default:
+                throw new Error(`Unknown subquery operator: ${operator}`);
+        }
+    }
+}
+//# sourceMappingURL=postgresql-compiler.js.map

package/dist/expression/compiler/postgresql-compiler.js.map

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

package/dist/expression/core/ast-node.d.ts

@@ -0,0 +1,47 @@
+/**
+ * AST node factory functions
+ * Creates immutable AST nodes for the expression tree
+ */
+import { ASTNode, ComparisonNode, ComparisonOperator, LogicalNode, LogicalOperator, GroupNode, JsonNode, JsonOperator, FullTextNode, FullTextMode, SubqueryNode } from './types.js';
+/**
+ * Reset node ID counter (useful for testing)
+ */
+export declare function resetNodeIdCounter(): void;
+/**
+ * Create a comparison node
+ */
+export declare function createComparisonNode(column: string, operator: ComparisonOperator, value?: any, values?: any[], parameterNames?: string[]): ComparisonNode;
+/**
+ * Create a logical node (AND/OR)
+ */
+export declare function createLogicalNode(operator: LogicalOperator, left: ASTNode, right: ASTNode): LogicalNode;
+/**
+ * Create a group node (for parentheses)
+ */
+export declare function createGroupNode(child: ASTNode): GroupNode;
+/**
+ * Create a JSON operation node
+ */
+export declare function createJsonNode(column: string, operator: JsonOperator, options?: {
+    value?: any;
+    path?: string;
+    keys?: string[];
+    parameterName?: string;
+}): JsonNode;
+/**
+ * Create a full-text search node
+ */
+export declare function createFullTextNode(columns: string[], query: string, mode: FullTextMode, language: string, parameterName: string): FullTextNode;
+/**
+ * Create a subquery node
+ */
+export declare function createSubqueryNode(operator: SubqueryNode['operator'], subquery: ASTNode, column?: string): SubqueryNode;
+/**
+ * Clone an AST node (creates a new immutable copy)
+ */
+export declare function cloneNode<T extends ASTNode>(node: T): T;
+/**
+ * Check if two nodes are structurally equal (ignoring IDs)
+ */
+export declare function nodesEqual(a: ASTNode, b: ASTNode): boolean;
+//# sourceMappingURL=ast-node.d.ts.map

package/dist/expression/core/ast-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-node.d.ts","sourceRoot":"","sources":["../../src/core/ast-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,OAAO,EAEP,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,CAAC,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,GAAG,EAAE,EACd,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,cAAc,CAUhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GACb,WAAW,CAQb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAMzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,QAAQ,CAQV;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,YAAY,CAUd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,EAClC,QAAQ,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CAQd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAmE1D"}

package/dist/expression/core/ast-node.js

@@ -0,0 +1,154 @@
+/**
+ * AST node factory functions
+ * Creates immutable AST nodes for the expression tree
+ */
+import { ASTNodeType, } from './types.js';
+/**
+ * Generate unique node ID
+ */
+let nodeIdCounter = 0;
+function generateNodeId() {
+    return `node_${++nodeIdCounter}`;
+}
+/**
+ * Reset node ID counter (useful for testing)
+ */
+export function resetNodeIdCounter() {
+    nodeIdCounter = 0;
+}
+/**
+ * Create a comparison node
+ */
+export function createComparisonNode(column, operator, value, values, parameterNames) {
+    return Object.freeze({
+        type: ASTNodeType.Comparison,
+        id: generateNodeId(),
+        column,
+        operator,
+        value,
+        values,
+        parameterNames,
+    });
+}
+/**
+ * Create a logical node (AND/OR)
+ */
+export function createLogicalNode(operator, left, right) {
+    return Object.freeze({
+        type: ASTNodeType.Logical,
+        id: generateNodeId(),
+        operator,
+        left,
+        right,
+    });
+}
+/**
+ * Create a group node (for parentheses)
+ */
+export function createGroupNode(child) {
+    return Object.freeze({
+        type: ASTNodeType.Group,
+        id: generateNodeId(),
+        child,
+    });
+}
+/**
+ * Create a JSON operation node
+ */
+export function createJsonNode(column, operator, options = {}) {
+    return Object.freeze({
+        type: ASTNodeType.Json,
+        id: generateNodeId(),
+        column,
+        operator,
+        ...options,
+    });
+}
+/**
+ * Create a full-text search node
+ */
+export function createFullTextNode(columns, query, mode, language, parameterName) {
+    return Object.freeze({
+        type: ASTNodeType.FullText,
+        id: generateNodeId(),
+        columns,
+        query,
+        mode,
+        language,
+        parameterName,
+    });
+}
+/**
+ * Create a subquery node
+ */
+export function createSubqueryNode(operator, subquery, column) {
+    return Object.freeze({
+        type: ASTNodeType.Subquery,
+        id: generateNodeId(),
+        column,
+        operator,
+        subquery,
+    });
+}
+/**
+ * Clone an AST node (creates a new immutable copy)
+ */
+export function cloneNode(node) {
+    return Object.freeze({ ...node, id: generateNodeId() });
+}
+/**
+ * Check if two nodes are structurally equal (ignoring IDs)
+ */
+export function nodesEqual(a, b) {
+    if (a.type !== b.type)
+        return false;
+    switch (a.type) {
+        case ASTNodeType.Comparison: {
+            const nodeA = a;
+            const nodeB = b;
+            return (nodeA.column === nodeB.column &&
+                nodeA.operator === nodeB.operator &&
+                nodeA.value === nodeB.value &&
+                JSON.stringify(nodeA.values) === JSON.stringify(nodeB.values));
+        }
+        case ASTNodeType.Logical: {
+            const nodeA = a;
+            const nodeB = b;
+            return (nodeA.operator === nodeB.operator &&
+                nodesEqual(nodeA.left, nodeB.left) &&
+                nodesEqual(nodeA.right, nodeB.right));
+        }
+        case ASTNodeType.Group: {
+            const nodeA = a;
+            const nodeB = b;
+            return nodesEqual(nodeA.child, nodeB.child);
+        }
+        case ASTNodeType.Json: {
+            const nodeA = a;
+            const nodeB = b;
+            return (nodeA.column === nodeB.column &&
+                nodeA.operator === nodeB.operator &&
+                JSON.stringify(nodeA.value) === JSON.stringify(nodeB.value) &&
+                nodeA.path === nodeB.path &&
+                JSON.stringify(nodeA.keys) === JSON.stringify(nodeB.keys));
+        }
+        case ASTNodeType.FullText: {
+            const nodeA = a;
+            const nodeB = b;
+            return (JSON.stringify(nodeA.columns) === JSON.stringify(nodeB.columns) &&
+                nodeA.query === nodeB.query &&
+                nodeA.mode === nodeB.mode &&
+                nodeA.language === nodeB.language);
+        }
+        case ASTNodeType.Subquery: {
+            const nodeA = a;
+            const nodeB = b;
+            return (nodeA.column === nodeB.column &&
+                nodeA.operator === nodeB.operator &&
+                nodesEqual(nodeA.subquery, nodeB.subquery));
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=ast-node.js.map

package/dist/expression/core/ast-node.js.map

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

package/dist/expression/core/parameter-manager.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Parameter manager for handling SQL parameters
+ * Manages parameter generation, validation, and serialization
+ */
+import { SqlDialect } from './types.js';
+/**
+ * Parameter manager class
+ */
+export declare class ParameterManager {
+    private parameterCount;
+    private parameters;
+    private readonly dialect;
+    constructor(dialect?: SqlDialect);
+    /**
+     * Generate a new unique parameter name
+     */
+    generateParameterName(): string;
+    /**
+     * Add a parameter with a specific name
+     */
+    addParameter(name: string, value: any): void;
+    /**
+     * Add a parameter and return its name
+     */
+    addParameterWithValue(value: any): string;
+    /**
+     * Get parameter value by name
+     */
+    getParameter(name: string): any;
+    /**
+     * Check if parameter exists
+     */
+    hasParameter(name: string): boolean;
+    /**
+     * Get all parameters as a record
+     */
+    getParameters(): Record<string, any>;
+    /**
+     * Get parameter count
+     */
+    getParameterCount(): number;
+    /**
+     * Reset parameter manager
+     */
+    reset(): void;
+    /**
+     * Format parameter name with a sequential index.
+     * Currently all dialects use the same naming convention (p1, p2, p3, etc.).
+     *
+     * @param index - The sequential parameter index
+     * @returns The formatted parameter name (e.g., "p1", "p2")
+     */
+    private formatParameterName;
+    /**
+     * Format parameter placeholder for SQL
+     */
+    formatParameterPlaceholder(name: string): string;
+    /**
+     * Serialize parameter value for SQL.
+     * Normalizes undefined to null and handles Date, array, and object types.
+     *
+     * @param value - The value to serialize
+     * @returns The serialized value suitable for SQL parameterization
+     */
+    serializeParameter(value: any): any;
+    /**
+     * Deduplicate parameters with same value.
+     * Uses JSON.stringify for deep comparison so objects and arrays
+     * are correctly deduplicated (not just compared by reference).
+     *
+     * @param value - The parameter value to look for
+     * @returns The existing parameter name if a duplicate is found, null otherwise
+     */
+    deduplicateParameter(value: any): string | null;
+    /**
+     * Clone parameter manager
+     */
+    clone(): ParameterManager;
+}
+/**
+ * Create a new parameter manager
+ */
+export declare function createParameterManager(dialect?: SqlDialect): ParameterManager;
+//# sourceMappingURL=parameter-manager.d.ts.map

package/dist/expression/core/parameter-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-manager.d.ts","sourceRoot":"","sources":["../../src/core/parameter-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAEzB,OAAO,GAAE,UAAkC;IAIvD;;OAEG;IACI,qBAAqB,IAAI,MAAM;IAKtC;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAMnD;;OAEG;IACI,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAMhD;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAItC;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQ3C;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACI,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAcvD;;;;;;OAMG;IACI,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;IA6B1C;;;;;;;OAOG;IACI,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAatD;;OAEG;IACI,KAAK,IAAI,gBAAgB;CAMjC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,UAAkC,GAAG,gBAAgB,CAEpG"}