@quereus/quereus 0.16.4 → 0.17.1

package/dist/src/planner/nodes/alter-table-node.js

@@ -0,0 +1,55 @@
+import { PlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+/**
+ * Plan node for ALTER TABLE operations (rename table/column, add/drop column).
+ * Constraint additions are handled by the separate AddConstraintNode.
+ */
+export class AlterTableNode extends PlanNode {
+    table;
+    action;
+    nodeType = PlanNodeType.AlterTable;
+    constructor(scope, table, action) {
+        super(scope);
+        this.table = table;
+        this.action = action;
+    }
+    getType() {
+        return { typeClass: 'void' };
+    }
+    getRelations() {
+        return [this.table];
+    }
+    getChildren() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            throw new Error(`AlterTableNode expects 0 children, got ${newChildren.length}`);
+        }
+        return this;
+    }
+    toString() {
+        switch (this.action.type) {
+            case 'renameTable':
+                return `ALTER TABLE RENAME TO ${this.action.newName}`;
+            case 'renameColumn':
+                return `ALTER TABLE RENAME COLUMN ${this.action.oldName} TO ${this.action.newName}`;
+            case 'addColumn':
+                return `ALTER TABLE ADD COLUMN ${this.action.column.name}`;
+            case 'dropColumn':
+                return `ALTER TABLE DROP COLUMN ${this.action.name}`;
+        }
+    }
+    getLogicalAttributes() {
+        return {
+            table: this.table.tableSchema.name,
+            schema: this.table.tableSchema.schemaName,
+            actionType: this.action.type,
+            ...this.action,
+        };
+    }
+    computePhysical(_children) {
+        return { readonly: false };
+    }
+}
+//# sourceMappingURL=alter-table-node.js.map

package/dist/src/planner/nodes/alter-table-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alter-table-node.js","sourceRoot":"","sources":["../../../../src/planner/nodes/alter-table-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAenD;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAK1B;IACA;IALC,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC;IAErD,YACC,KAAY,EACI,KAAyB,EACzB,MAAwB;QAExC,KAAK,CAAC,KAAK,CAAC,CAAC;QAHG,UAAK,GAAL,KAAK,CAAoB;QACzB,WAAM,GAAN,MAAM,CAAkB;IAGzC,CAAC;IAED,OAAO;QACN,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY;QACX,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,WAAW;QACV,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YAAY,CAAC,WAAgC;QAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0CAA0C,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAEQ,QAAQ;QAChB,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC1B,KAAK,aAAa;gBACjB,OAAO,yBAAyB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvD,KAAK,cAAc;gBAClB,OAAO,6BAA6B,IAAI,CAAC,MAAM,CAAC,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrF,KAAK,WAAW;gBACf,OAAO,0BAA0B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5D,KAAK,YAAY;gBAChB,OAAO,2BAA2B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,CAAC;IACF,CAAC;IAEQ,oBAAoB;QAC5B,OAAO;YACN,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI;YAClC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU;YACzC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAC5B,GAAG,IAAI,CAAC,MAAM;SACd,CAAC;IACH,CAAC;IAEQ,eAAe,CAAC,SAAwC;QAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/src/planner/nodes/analyze-node.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Plan node for the ANALYZE statement.
+ * When executed, collects table statistics and caches them on TableSchema.
+ */
+import type * as AST from '../../parser/ast.js';
+import { Attribute, type RelationalPlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { PlanNode } from './plan-node.js';
+import { RelationType } from '../../common/datatype.js';
+import { Scope } from '../scopes/scope.js';
+export declare class AnalyzePlanNode extends PlanNode implements RelationalPlanNode {
+    readonly statementAst: AST.AnalyzeStmt;
+    readonly targetTableName?: string | undefined;
+    readonly targetSchemaName?: string | undefined;
+    readonly nodeType = PlanNodeType.Analyze;
+    constructor(scope: Scope, statementAst: AST.AnalyzeStmt, targetTableName?: string | undefined, targetSchemaName?: string | undefined);
+    getType(): RelationType;
+    get estimatedRows(): number | undefined;
+    getAttributes(): Attribute[];
+    getChildren(): PlanNode[];
+    withChildren(_newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=analyze-node.d.ts.map

package/dist/src/planner/nodes/analyze-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/analyze-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,qBAAa,eAAgB,SAAQ,QAAS,YAAW,kBAAkB;aAKzD,YAAY,EAAE,GAAG,CAAC,WAAW;aAC7B,eAAe,CAAC,EAAE,MAAM;aACxB,gBAAgB,CAAC,EAAE,MAAM;IAN1C,SAAkB,QAAQ,wBAAwB;gBAGjD,KAAK,EAAE,KAAK,EACI,YAAY,EAAE,GAAG,CAAC,WAAW,EAC7B,eAAe,CAAC,EAAE,MAAM,YAAA,EACxB,gBAAgB,CAAC,EAAE,MAAM,YAAA;IAK1C,OAAO,IAAI,YAAY;IA+BvB,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,aAAa,IAAI,SAAS,EAAE;IAS5B,WAAW,IAAI,QAAQ,EAAE;IAIzB,YAAY,CAAC,YAAY,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAIhD,QAAQ,IAAI,MAAM;IAUlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOxD"}

package/dist/src/planner/nodes/analyze-node.js

@@ -0,0 +1,83 @@
+/**
+ * Plan node for the ANALYZE statement.
+ * When executed, collects table statistics and caches them on TableSchema.
+ */
+import { PlanNodeType } from './plan-node-type.js';
+import { PlanNode } from './plan-node.js';
+import { TEXT_TYPE, INTEGER_TYPE } from '../../types/builtin-types.js';
+export class AnalyzePlanNode extends PlanNode {
+    statementAst;
+    targetTableName;
+    targetSchemaName;
+    nodeType = PlanNodeType.Analyze;
+    constructor(scope, statementAst, targetTableName, targetSchemaName) {
+        super(scope, 1);
+        this.statementAst = statementAst;
+        this.targetTableName = targetTableName;
+        this.targetSchemaName = targetSchemaName;
+    }
+    getType() {
+        return {
+            typeClass: 'relation',
+            isReadOnly: true,
+            isSet: true,
+            columns: [
+                {
+                    name: 'table',
+                    type: {
+                        typeClass: 'scalar',
+                        logicalType: TEXT_TYPE,
+                        nullable: false,
+                        isReadOnly: true,
+                    },
+                    generated: true,
+                },
+                {
+                    name: 'rows',
+                    type: {
+                        typeClass: 'scalar',
+                        logicalType: INTEGER_TYPE,
+                        nullable: false,
+                    },
+                    generated: true,
+                },
+            ],
+            keys: [[]],
+            rowConstraints: [],
+        };
+    }
+    get estimatedRows() {
+        return this.targetTableName ? 1 : 10; // 1 for single table, ~10 for all tables
+    }
+    getAttributes() {
+        return this.getType().columns.map((column) => ({
+            id: PlanNode.nextAttrId(),
+            name: column.name,
+            type: column.type,
+            sourceRelation: `${this.nodeType}:${this.id}`
+        }));
+    }
+    getChildren() {
+        return [];
+    }
+    withChildren(_newChildren) {
+        return new AnalyzePlanNode(this.scope, this.statementAst, this.targetTableName, this.targetSchemaName);
+    }
+    toString() {
+        if (this.targetSchemaName && this.targetTableName) {
+            return `ANALYZE ${this.targetSchemaName}.${this.targetTableName}`;
+        }
+        if (this.targetTableName) {
+            return `ANALYZE ${this.targetTableName}`;
+        }
+        return 'ANALYZE';
+    }
+    getLogicalAttributes() {
+        return {
+            type: 'analyze',
+            tableName: this.targetTableName,
+            schemaName: this.targetSchemaName,
+        };
+    }
+}
+//# sourceMappingURL=analyze-node.js.map

package/dist/src/planner/nodes/analyze-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-node.js","sourceRoot":"","sources":["../../../../src/planner/nodes/analyze-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAK3B;IACA;IACA;IANC,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC;IAElD,YACC,KAAY,EACI,YAA6B,EAC7B,eAAwB,EACxB,gBAAyB;QAEzC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAJA,iBAAY,GAAZ,YAAY,CAAiB;QAC7B,oBAAe,GAAf,eAAe,CAAS;QACxB,qBAAgB,GAAhB,gBAAgB,CAAS;IAG1C,CAAC;IAED,OAAO;QACN,OAAO;YACN,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE;wBACL,SAAS,EAAE,QAAQ;wBACnB,WAAW,EAAE,SAAS;wBACtB,QAAQ,EAAE,KAAK;wBACf,UAAU,EAAE,IAAI;qBAChB;oBACD,SAAS,EAAE,IAAI;iBACf;gBACD;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACL,SAAS,EAAE,QAAQ;wBACnB,WAAW,EAAE,YAAY;wBACzB,QAAQ,EAAE,KAAK;qBACf;oBACD,SAAS,EAAE,IAAI;iBACf;aACD;YACD,IAAI,EAAE,CAAC,EAAE,CAAC;YACV,cAAc,EAAE,EAAE;SAClB,CAAC;IACH,CAAC;IAED,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,yCAAyC;IAChF,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9C,EAAE,EAAE,QAAQ,CAAC,UAAU,EAAE;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,EAAE;SACxB,CAAA,CAAC,CAAC;IACzB,CAAC;IAED,WAAW;QACV,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YAAY,CAAC,YAAiC;QAC7C,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxG,CAAC;IAEQ,QAAQ;QAChB,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACnD,OAAO,WAAW,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAEQ,oBAAoB;QAC5B,OAAO;YACN,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,IAAI,CAAC,eAAe;YAC/B,UAAU,EAAE,IAAI,CAAC,gBAAgB;SACjC,CAAC;IACH,CAAC;CACD"}

package/dist/src/planner/nodes/bloom-join-node.d.ts

@@ -0,0 +1,66 @@
+import { PlanNodeType } from './plan-node-type.js';
+import { PlanNode, type RelationalPlanNode, type BinaryRelationalNode, type ScalarPlanNode, type PhysicalProperties, type Attribute } from './plan-node.js';
+import type { RelationType } from '../../common/datatype.js';
+import type { Scope } from '../scopes/scope.js';
+import type { JoinCapable, PredicateSourceCapable } from '../framework/characteristics.js';
+import type { JoinType } from './join-node.js';
+/**
+ * An equi-join pair: left attribute = right attribute.
+ * Attribute IDs are stable across plan transformations.
+ */
+export interface EquiJoinPair {
+    leftAttrId: number;
+    rightAttrId: number;
+}
+/**
+ * Physical plan node implementing a hash (bloom) join.
+ *
+ * Build phase: materializes the smaller (right) side into a Map keyed by
+ * serialized equi-join column values.
+ * Probe phase: streams the larger (left) side, probing the map for matches.
+ *
+ * Reduces O(n*m) nested-loop to O(n+m) for equi-joins.
+ */
+export declare class BloomJoinNode extends PlanNode implements BinaryRelationalNode, JoinCapable, PredicateSourceCapable {
+    /** Probe side (streamed) */
+    readonly left: RelationalPlanNode;
+    /** Build side (materialized into hash map) */
+    readonly right: RelationalPlanNode;
+    readonly joinType: JoinType;
+    /** Pre-extracted equi-join pairs (left.col = right.col) */
+    readonly equiPairs: readonly EquiJoinPair[];
+    /** Non-equi remainder of the ON condition, if any */
+    readonly residualCondition?: ScalarPlanNode | undefined;
+    /** Preserved attribute IDs from the logical JoinNode */
+    readonly preserveAttributeIds?: readonly Attribute[] | undefined;
+    readonly nodeType = PlanNodeType.HashJoin;
+    private attributesCache;
+    constructor(scope: Scope, 
+    /** Probe side (streamed) */
+    left: RelationalPlanNode, 
+    /** Build side (materialized into hash map) */
+    right: RelationalPlanNode, joinType: JoinType, 
+    /** Pre-extracted equi-join pairs (left.col = right.col) */
+    equiPairs: readonly EquiJoinPair[], 
+    /** Non-equi remainder of the ON condition, if any */
+    residualCondition?: ScalarPlanNode | undefined, 
+    /** Preserved attribute IDs from the logical JoinNode */
+    preserveAttributeIds?: readonly Attribute[] | undefined);
+    private buildAttributes;
+    getAttributes(): Attribute[];
+    getType(): RelationType;
+    computePhysical(childrenPhysical: PhysicalProperties[]): Partial<PhysicalProperties>;
+    get estimatedRows(): number | undefined;
+    getChildren(): readonly PlanNode[];
+    getRelations(): readonly [RelationalPlanNode, RelationalPlanNode];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    getJoinType(): JoinType;
+    getJoinCondition(): ScalarPlanNode | undefined;
+    getLeftSource(): RelationalPlanNode;
+    getRightSource(): RelationalPlanNode;
+    getUsingColumns(): readonly string[] | undefined;
+    getPredicates(): readonly ScalarPlanNode[];
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=bloom-join-node.d.ts.map

package/dist/src/planner/nodes/bloom-join-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-join-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/bloom-join-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAoB,MAAM,gBAAgB,CAAC;AAC9K,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,QAAS,YAAW,oBAAoB,EAAE,WAAW,EAAE,sBAAsB;IAM9G,4BAA4B;aACZ,IAAI,EAAE,kBAAkB;IACxC,8CAA8C;aAC9B,KAAK,EAAE,kBAAkB;aACzB,QAAQ,EAAE,QAAQ;IAClC,2DAA2D;aAC3C,SAAS,EAAE,SAAS,YAAY,EAAE;IAClD,qDAAqD;aACrC,iBAAiB,CAAC,EAAE,cAAc;IAClD,wDAAwD;aACxC,oBAAoB,CAAC,EAAE,SAAS,SAAS,EAAE;IAf5D,SAAkB,QAAQ,yBAAyB;IACnD,OAAO,CAAC,eAAe,CAAsB;gBAG5C,KAAK,EAAE,KAAK;IACZ,4BAA4B;IACZ,IAAI,EAAE,kBAAkB;IACxC,8CAA8C;IAC9B,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,QAAQ;IAClC,2DAA2D;IAC3C,SAAS,EAAE,SAAS,YAAY,EAAE;IAClD,qDAAqD;IACrC,iBAAiB,CAAC,EAAE,cAAc,YAAA;IAClD,wDAAwD;IACxC,oBAAoB,CAAC,EAAE,SAAS,SAAS,EAAE,YAAA;IAU5D,OAAO,CAAC,eAAe;IA4BvB,aAAa,IAAI,SAAS,EAAE;IAI5B,OAAO,IAAI,YAAY;IAyCvB,eAAe,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyBpF,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAkBtC;IAED,WAAW,IAAI,SAAS,QAAQ,EAAE;IAMlC,YAAY,IAAI,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAIjE,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAgCxD,WAAW,IAAI,QAAQ;IACvB,gBAAgB,IAAI,cAAc,GAAG,SAAS;IAC9C,aAAa,IAAI,kBAAkB;IACnC,cAAc,IAAI,kBAAkB;IACpC,eAAe,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS;IAGhD,aAAa,IAAI,SAAS,cAAc,EAAE;IAIjC,QAAQ,IAAI,MAAM;IAKlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAcxD"}

package/dist/src/planner/nodes/bloom-join-node.js

@@ -0,0 +1,200 @@
+import { PlanNodeType } from './plan-node-type.js';
+import { PlanNode, isRelationalNode } from './plan-node.js';
+import { Cached } from '../../util/cached.js';
+import { StatusCode } from '../../common/types.js';
+import { quereusError } from '../../common/errors.js';
+import { hashJoinCost } from '../cost/index.js';
+import { analyzeJoinKeyCoverage } from '../util/key-utils.js';
+/**
+ * Physical plan node implementing a hash (bloom) join.
+ *
+ * Build phase: materializes the smaller (right) side into a Map keyed by
+ * serialized equi-join column values.
+ * Probe phase: streams the larger (left) side, probing the map for matches.
+ *
+ * Reduces O(n*m) nested-loop to O(n+m) for equi-joins.
+ */
+export class BloomJoinNode extends PlanNode {
+    left;
+    right;
+    joinType;
+    equiPairs;
+    residualCondition;
+    preserveAttributeIds;
+    nodeType = PlanNodeType.HashJoin;
+    attributesCache;
+    constructor(scope, 
+    /** Probe side (streamed) */
+    left, 
+    /** Build side (materialized into hash map) */
+    right, joinType, 
+    /** Pre-extracted equi-join pairs (left.col = right.col) */
+    equiPairs, 
+    /** Non-equi remainder of the ON condition, if any */
+    residualCondition, 
+    /** Preserved attribute IDs from the logical JoinNode */
+    preserveAttributeIds) {
+        const leftRows = left.estimatedRows ?? 100;
+        const rightRows = right.estimatedRows ?? 100;
+        const cost = left.getTotalCost() + right.getTotalCost() + hashJoinCost(rightRows, leftRows);
+        super(scope, cost);
+        this.left = left;
+        this.right = right;
+        this.joinType = joinType;
+        this.equiPairs = equiPairs;
+        this.residualCondition = residualCondition;
+        this.preserveAttributeIds = preserveAttributeIds;
+        this.attributesCache = new Cached(() => this.buildAttributes());
+    }
+    buildAttributes() {
+        if (this.preserveAttributeIds) {
+            return this.preserveAttributeIds.slice();
+        }
+        const leftAttrs = this.left.getAttributes();
+        // Semi/anti joins produce only left-side attributes
+        if (this.joinType === 'semi' || this.joinType === 'anti') {
+            return leftAttrs.slice();
+        }
+        // Fallback: combine left + right attributes (should rarely happen)
+        const rightAttrs = this.right.getAttributes();
+        const attributes = [];
+        for (const attr of leftAttrs) {
+            const isNullable = this.joinType === 'right' || this.joinType === 'full';
+            attributes.push(isNullable ? { ...attr, type: { ...attr.type, nullable: true } } : attr);
+        }
+        for (const attr of rightAttrs) {
+            const isNullable = this.joinType === 'left' || this.joinType === 'full';
+            attributes.push(isNullable ? { ...attr, type: { ...attr.type, nullable: true } } : attr);
+        }
+        return attributes;
+    }
+    getAttributes() {
+        return this.attributesCache.value;
+    }
+    getType() {
+        const leftType = this.left.getType();
+        // Semi/anti joins produce only left-side columns
+        if (this.joinType === 'semi' || this.joinType === 'anti') {
+            return {
+                typeClass: 'relation',
+                columns: leftType.columns,
+                isSet: leftType.isSet,
+                isReadOnly: leftType.isReadOnly,
+                keys: leftType.keys,
+                rowConstraints: leftType.rowConstraints
+            };
+        }
+        const rightType = this.right.getType();
+        const combinedColumns = [
+            ...leftType.columns.map(col => {
+                const isNullable = this.joinType === 'right' || this.joinType === 'full';
+                return isNullable ? { ...col, type: { ...col.type, nullable: true } } : col;
+            }),
+            ...rightType.columns.map(col => {
+                const isNullable = this.joinType === 'left' || this.joinType === 'full';
+                return isNullable ? { ...col, type: { ...col.type, nullable: true } } : col;
+            })
+        ];
+        const isSet = (this.joinType === 'inner' || this.joinType === 'cross') &&
+            leftType.isSet && rightType.isSet;
+        return {
+            typeClass: 'relation',
+            columns: combinedColumns,
+            isSet,
+            isReadOnly: leftType.isReadOnly && rightType.isReadOnly,
+            keys: [], // Conservative: don't infer keys for hash join
+            rowConstraints: [...leftType.rowConstraints, ...rightType.rowConstraints]
+        };
+    }
+    computePhysical(childrenPhysical) {
+        const leftPhys = childrenPhysical[0];
+        const rightPhys = childrenPhysical[1];
+        const leftAttrs = this.left.getAttributes();
+        const rightAttrs = this.right.getAttributes();
+        // Map attribute-ID-based equi-pairs to column-index-based pairs
+        const indexPairs = this.equiPairs.map(p => ({
+            left: leftAttrs.findIndex(a => a.id === p.leftAttrId),
+            right: rightAttrs.findIndex(a => a.id === p.rightAttrId),
+        }));
+        const result = analyzeJoinKeyCoverage(this.joinType, leftPhys, rightPhys, this.left.getType(), this.right.getType(), indexPairs, this.left.estimatedRows, this.right.estimatedRows, leftAttrs.length);
+        return {
+            uniqueKeys: result.uniqueKeys,
+            estimatedRows: result.estimatedRows,
+        };
+    }
+    get estimatedRows() {
+        const leftRows = this.left.estimatedRows;
+        const rightRows = this.right.estimatedRows;
+        if (leftRows === undefined || rightRows === undefined)
+            return undefined;
+        switch (this.joinType) {
+            case 'cross':
+                return leftRows * rightRows;
+            case 'inner':
+                return Math.max(1, leftRows * rightRows * 0.1);
+            case 'left':
+                return leftRows;
+            case 'semi':
+            case 'anti':
+                return Math.max(1, Math.floor(leftRows * 0.5));
+            default:
+                return leftRows * rightRows * 0.1;
+        }
+    }
+    getChildren() {
+        const children = [this.left, this.right];
+        if (this.residualCondition)
+            children.push(this.residualCondition);
+        return children;
+    }
+    getRelations() {
+        return [this.left, this.right];
+    }
+    withChildren(newChildren) {
+        const expectedLength = this.residualCondition ? 3 : 2;
+        if (newChildren.length !== expectedLength) {
+            quereusError(`BloomJoinNode expects ${expectedLength} children, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        const [newLeft, newRight, newResidual] = newChildren;
+        if (!isRelationalNode(newLeft)) {
+            quereusError('BloomJoinNode: first child must be a RelationalPlanNode', StatusCode.INTERNAL);
+        }
+        if (!isRelationalNode(newRight)) {
+            quereusError('BloomJoinNode: second child must be a RelationalPlanNode', StatusCode.INTERNAL);
+        }
+        if (newLeft === this.left && newRight === this.right &&
+            (!this.residualCondition || newResidual === this.residualCondition)) {
+            return this;
+        }
+        return new BloomJoinNode(this.scope, newLeft, newRight, this.joinType, this.equiPairs, newResidual, this.preserveAttributeIds);
+    }
+    // JoinCapable interface
+    getJoinType() { return this.joinType; }
+    getJoinCondition() { return this.residualCondition; }
+    getLeftSource() { return this.left; }
+    getRightSource() { return this.right; }
+    getUsingColumns() { return undefined; }
+    // PredicateSourceCapable
+    getPredicates() {
+        return this.residualCondition ? [this.residualCondition] : [];
+    }
+    toString() {
+        const pairs = this.equiPairs.map(p => `${p.leftAttrId}=${p.rightAttrId}`).join(', ');
+        return `${this.joinType.toUpperCase()} HASH JOIN on [${pairs}]`;
+    }
+    getLogicalAttributes() {
+        const attrs = {
+            joinType: this.joinType,
+            algorithm: 'bloom',
+            equiPairs: this.equiPairs.map(p => ({ left: p.leftAttrId, right: p.rightAttrId })),
+            hasResidual: !!this.residualCondition,
+            leftRows: this.left.estimatedRows,
+            rightRows: this.right.estimatedRows,
+        };
+        if (this.physical?.uniqueKeys) {
+            attrs.uniqueKeys = this.physical.uniqueKeys;
+        }
+        return attrs;
+    }
+}
+//# sourceMappingURL=bloom-join-node.js.map

package/dist/src/planner/nodes/bloom-join-node.js.map

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

package/dist/src/planner/nodes/constraint-check-node.d.ts

@@ -10,7 +10,7 @@ export interface ConstraintCheck {
     expression: ScalarPlanNode;
     deferrable?: boolean;
     initiallyDeferred?: boolean;
-    containsSubquery: boolean;
+    needsDeferred: boolean;
 }
 /**
  * Represents constraint checking for DML operations.

package/dist/src/planner/nodes/constraint-check-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-check-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/constraint-check-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAkC,MAAM,gBAAgB,CAAC;AAC5J,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAS,YAAW,kBAAkB;aAK3D,MAAM,EAAE,kBAAkB;aAC1B,KAAK,EAAE,kBAAkB;aACzB,SAAS,EAAE,SAAS;aACpB,gBAAgB,EAAE,aAAa,GAAG,SAAS;aAC3C,gBAAgB,EAAE,aAAa,GAAG,SAAS;aAC3C,iBAAiB,EAAE,aAAa;aAChC,gBAAgB,EAAE,eAAe,EAAE;aACnC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;aACnD,iBAAiB,CAAC,EAAE,SAAS,EAAE;aAC/B,iBAAiB,CAAC,EAAE,aAAa;IAbnD,SAAkB,QAAQ,gCAAgC;gBAGxD,KAAK,EAAE,KAAK,EACI,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,aAAa,GAAG,SAAS,EAC3C,gBAAgB,EAAE,aAAa,GAAG,SAAS,EAC3C,iBAAiB,EAAE,aAAa,EAChC,gBAAgB,EAAE,eAAe,EAAE,EACnC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,YAAA,EAAE,qCAAqC;IAC1F,iBAAiB,CAAC,EAAE,SAAS,EAAE,YAAA,EAAE,8BAA8B;IAC/D,iBAAiB,CAAC,EAAE,aAAa,YAAA;IAKnD,OAAO,IAAI,YAAY;IAIvB,aAAa,IAAI,SAAS,SAAS,EAAE;IAKrC,YAAY,IAAI,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAIjE,WAAW,IAAI,SAAS,QAAQ,EAAE;IASlC,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAiDxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,MAAM;IAQlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAezD"}
+{"version":3,"file":"constraint-check-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/constraint-check-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAkC,MAAM,gBAAgB,CAAC;AAC5J,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAS,YAAW,kBAAkB;aAK3D,MAAM,EAAE,kBAAkB;aAC1B,KAAK,EAAE,kBAAkB;aACzB,SAAS,EAAE,SAAS;aACpB,gBAAgB,EAAE,aAAa,GAAG,SAAS;aAC3C,gBAAgB,EAAE,aAAa,GAAG,SAAS;aAC3C,iBAAiB,EAAE,aAAa;aAChC,gBAAgB,EAAE,eAAe,EAAE;aACnC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;aACnD,iBAAiB,CAAC,EAAE,SAAS,EAAE;aAC/B,iBAAiB,CAAC,EAAE,aAAa;IAbnD,SAAkB,QAAQ,gCAAgC;gBAGxD,KAAK,EAAE,KAAK,EACI,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,aAAa,GAAG,SAAS,EAC3C,gBAAgB,EAAE,aAAa,GAAG,SAAS,EAC3C,iBAAiB,EAAE,aAAa,EAChC,gBAAgB,EAAE,eAAe,EAAE,EACnC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,YAAA,EAAE,qCAAqC;IAC1F,iBAAiB,CAAC,EAAE,SAAS,EAAE,YAAA,EAAE,8BAA8B;IAC/D,iBAAiB,CAAC,EAAE,aAAa,YAAA;IAKnD,OAAO,IAAI,YAAY;IAIvB,aAAa,IAAI,SAAS,SAAS,EAAE;IAKrC,YAAY,IAAI,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAIjE,WAAW,IAAI,SAAS,QAAQ,EAAE;IASlC,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAiDxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,MAAM;IAQlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAezD"}

package/dist/src/planner/nodes/cte-reference-node.js

@@ -31,15 +31,15 @@ export class CTEReferenceNode extends PlanNode {
         this.typeCache = new Cached(() => this.buildType());
     }
     buildAttributes() {
-        // CRITICAL: Always create fresh attribute IDs for each CTE reference instance.
-        // Since we now cache CTEReferenceNode instances per alias in buildFrom(),
-        // each alias gets its own unique set of attribute IDs that remain consistent
-        // throughout the planning and execution phases.
+        // Always create fresh attribute IDs for each CTE reference instance.
+        // This ensures that the cte_ref's context entry uses unique attribute IDs
+        // that cannot collide with other descriptors (e.g. InternalRecursiveCTERef)
+        // still present in the context map. Without fresh IDs, resolveAttribute's
+        // newest→oldest search may find a stale slot from an inner operator that
+        // shares the same attribute IDs, causing incorrect column resolution.
         const relationName = this.alias || this.source.cteName;
-        // Only use fresh IDs when we have an alias that differs from the CTE name
-        const useFreshIds = this.alias !== undefined && this.alias.toLowerCase() !== this.source.cteName.toLowerCase();
         return this.source.getAttributes().map((attr) => ({
-            id: useFreshIds ? PlanNode.nextAttrId() : attr.id,
+            id: PlanNode.nextAttrId(),
             name: attr.name,
             type: attr.type,
             sourceRelation: `cte_ref:${this.source.cteName}`,

package/dist/src/planner/nodes/cte-reference-node.js.map

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

package/dist/src/planner/nodes/join-node.d.ts

@@ -5,7 +5,15 @@ import type { PhysicalProperties } from './plan-node.js';
 import { PlanNodeType } from './plan-node-type.js';
 import type { Scope } from '../scopes/scope.js';
 import { JoinCapable, type PredicateSourceCapable } from '../framework/characteristics.js';
-export type JoinType = 'inner' | 'left' | 'right' | 'full' | 'cross';
+export type JoinType = 'inner' | 'left' | 'right' | 'full' | 'cross' | 'semi' | 'anti';
+/**
+ * Extract equi-join column index pairs from a join condition (AND-of-equalities).
+ * Returns pairs of {left, right} column indices.
+ */
+export declare function extractEquiPairsFromCondition(condition: ScalarPlanNode | undefined, leftAttrs: readonly Attribute[], rightAttrs: readonly Attribute[]): Array<{
+    left: number;
+    right: number;
+}>;
 /**
  * Represents a logical JOIN operation between two relations.
  * This is a logical node that will be converted to physical join algorithms during optimization.

package/dist/src/planner/nodes/join-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"join-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/join-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,WAAW,EAAE,KAAK,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAM3F,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE;;;GAGG;AACH,qBAAa,QAAS,SAAQ,QAAS,YAAW,oBAAoB,EAAE,WAAW,EAAE,sBAAsB;aAMzF,IAAI,EAAE,kBAAkB;aACxB,KAAK,EAAE,kBAAkB;aACzB,QAAQ,EAAE,QAAQ;aAClB,SAAS,CAAC,EAAE,cAAc;aAC1B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE;IATjD,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,OAAO,CAAC,eAAe,CAAsB;gBAG5C,KAAK,EAAE,KAAK,EACI,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,cAAc,YAAA,EAC1B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,YAAA;IAejD,eAAe,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuFpF,OAAO,CAAC,eAAe;IA+BvB,aAAa,IAAI,SAAS,EAAE;IAI5B,OAAO,IAAI,YAAY;IAyCvB,WAAW,IAAI,SAAS,QAAQ,EAAE;IAIlC,YAAY,IAAI,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAIjE,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAuCxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CA2BtC;IAEQ,QAAQ,IAAI,MAAM;IAWlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAejD,WAAW,IAAI,QAAQ;IAIvB,gBAAgB,IAAI,cAAc,GAAG,SAAS;IAI9C,aAAa,IAAI,kBAAkB;IAInC,cAAc,IAAI,kBAAkB;IAIpC,eAAe,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS;IAKvD,aAAa,IAAI,SAAS,cAAc,EAAE;CAG1C"}
+{"version":3,"file":"join-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/join-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,WAAW,EAAE,KAAK,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAM3F,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvF;;;GAGG;AACH,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,UAAU,EAAE,SAAS,SAAS,EAAE,GAC9B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCxC;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,QAAS,YAAW,oBAAoB,EAAE,WAAW,EAAE,sBAAsB;aAMzF,IAAI,EAAE,kBAAkB;aACxB,KAAK,EAAE,kBAAkB;aACzB,QAAQ,EAAE,QAAQ;aAClB,SAAS,CAAC,EAAE,cAAc;aAC1B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE;IATjD,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,OAAO,CAAC,eAAe,CAAsB;gBAG5C,KAAK,EAAE,KAAK,EACI,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,cAAc,YAAA,EAC1B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,YAAA;IAejD,eAAe,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBpF,OAAO,CAAC,eAAe;IAqCvB,aAAa,IAAI,SAAS,EAAE;IAI5B,OAAO,IAAI,YAAY;IAsDvB,WAAW,IAAI,SAAS,QAAQ,EAAE;IAIlC,YAAY,IAAI,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAIjE,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAuCxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAiCtC;IAEQ,QAAQ,IAAI,MAAM;IAWlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAejD,WAAW,IAAI,QAAQ;IAIvB,gBAAgB,IAAI,cAAc,GAAG,SAAS;IAI9C,aAAa,IAAI,kBAAkB;IAInC,cAAc,IAAI,kBAAkB;IAIpC,eAAe,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS;IAKvD,aAAa,IAAI,SAAS,cAAc,EAAE;CAG1C"}