@quereus/quereus 0.1.0

package/dist/src/planner/rules/physical/rule-filter-optimization.js

@@ -0,0 +1,49 @@
+/**
+ * Rule: Filter Optimization
+ *
+ * Transforms: FilterNode → FilterNode (optimized)
+ * Conditions: When filter node's source needs optimization
+ * Benefits: Ensures filter nodes have optimized sources and proper physical properties
+ */
+import { createLogger } from '../../../common/logger.js';
+import { FilterNode } from '../../nodes/filter.js';
+import { PlanNode as BasePlanNode } from '../../nodes/plan-node.js';
+const log = createLogger('optimizer:rule:filter-optimization');
+export function ruleFilterOptimization(node, context) {
+    // Guard: only apply to FilterNode
+    if (!(node instanceof FilterNode)) {
+        return null;
+    }
+    log('Optimizing FilterNode %s', node.id);
+    // Optimize the source
+    const optimizedSource = context.optimizer.optimizeNode(node.source, context);
+    // If source didn't change, just ensure physical properties are set
+    if (optimizedSource === node.source) {
+        if (!node.physical) {
+            // Filter preserves most properties but may reduce row count
+            const sourceRows = optimizedSource.estimatedRows;
+            const filteredRows = sourceRows ? Math.ceil(sourceRows * 0.3) : undefined; // Assume 30% selectivity
+            BasePlanNode.setDefaultPhysical(node, {
+                estimatedRows: filteredRows,
+                deterministic: true,
+                readonly: true
+            });
+            log('Set physical properties on existing FilterNode');
+            return node;
+        }
+        return null; // No change needed
+    }
+    // Source changed - create new filter node with optimized source
+    const result = new FilterNode(node.scope, optimizedSource, node.predicate);
+    // Set physical properties
+    const sourceRows = optimizedSource.estimatedRows;
+    const filteredRows = sourceRows ? Math.ceil(sourceRows * 0.3) : undefined; // Assume 30% selectivity
+    BasePlanNode.setDefaultPhysical(result, {
+        estimatedRows: filteredRows,
+        deterministic: true,
+        readonly: true
+    });
+    log('Created optimized FilterNode with new source');
+    return result;
+}
+//# sourceMappingURL=rule-filter-optimization.js.map

package/dist/src/planner/rules/physical/rule-filter-optimization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-filter-optimization.js","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-filter-optimization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,GAAG,GAAG,YAAY,CAAC,oCAAoC,CAAC,CAAC;AAE/D,MAAM,UAAU,sBAAsB,CAAC,IAAc,EAAE,OAAmB;IACzE,kCAAkC;IAClC,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAEzC,sBAAsB;IACtB,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAuB,CAAC;IAEnG,mEAAmE;IACnE,IAAI,eAAe,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,4DAA4D;YAC5D,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC;YACjD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,yBAAyB;YAEpG,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE;gBACrC,aAAa,EAAE,YAAY;gBAC3B,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACd,CAAC,CAAC;YACH,GAAG,CAAC,gDAAgD,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,mBAAmB;IACjC,CAAC;IAED,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAE3E,0BAA0B;IAC1B,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC;IACjD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,yBAAyB;IAEpG,YAAY,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACvC,aAAa,EAAE,YAAY;QAC3B,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,GAAG,CAAC,8CAA8C,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/src/planner/rules/physical/rule-mark-physical.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rule: Mark Physical (Fallback)
+ *
+ * Transforms: Any logical node → Same node (marked as physical)
+ * Conditions: When no other rule has made the node physical
+ * Benefits: Ensures all nodes become physical even if no specific transformation is needed
+ */
+import type { PlanNode } from '../../nodes/plan-node.js';
+import type { OptContext } from '../../framework/context.js';
+export declare function ruleMarkPhysical(node: PlanNode, _context: OptContext): PlanNode | null;
+//# sourceMappingURL=rule-mark-physical.d.ts.map

package/dist/src/planner/rules/physical/rule-mark-physical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-mark-physical.d.ts","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-mark-physical.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAsBtF"}

package/dist/src/planner/rules/physical/rule-mark-physical.js

@@ -0,0 +1,29 @@
+/**
+ * Rule: Mark Physical (Fallback)
+ *
+ * Transforms: Any logical node → Same node (marked as physical)
+ * Conditions: When no other rule has made the node physical
+ * Benefits: Ensures all nodes become physical even if no specific transformation is needed
+ */
+import { createLogger } from '../../../common/logger.js';
+const log = createLogger('optimizer:rule:mark-physical');
+export function ruleMarkPhysical(node, _context) {
+    // This is a fallback rule - only apply if the node is not already physical
+    if (node.physical) {
+        return null; // Already physical
+    }
+    // Some node types cannot be made physical directly (like AggregateNode)
+    // These should have been handled by specific transformation rules
+    const cannotBePhysical = new Set([
+        'Aggregate', // Should be transformed to StreamAggregate/HashAggregate
+    ]);
+    if (cannotBePhysical.has(node.nodeType)) {
+        log('Cannot mark %s as physical - requires transformation', node.nodeType);
+        return null; // Let the optimizer handle this as an error
+    }
+    log('Marking %s as physical (fallback rule)', node.nodeType);
+    // Return the node - framework will set physical properties via markPhysical()
+    // Don't hardcode properties, let the framework compute them from children
+    return node;
+}
+//# sourceMappingURL=rule-mark-physical.js.map

package/dist/src/planner/rules/physical/rule-mark-physical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-mark-physical.js","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-mark-physical.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,MAAM,GAAG,GAAG,YAAY,CAAC,8BAA8B,CAAC,CAAC;AAEzD,MAAM,UAAU,gBAAgB,CAAC,IAAc,EAAE,QAAoB;IACpE,2EAA2E;IAC3E,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,CAAC,mBAAmB;IACjC,CAAC;IAED,wEAAwE;IACxE,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;QAChC,WAAW,EAAE,yDAAyD;KACtE,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,sDAAsD,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,CAAC,4CAA4C;IAC1D,CAAC;IAED,GAAG,CAAC,wCAAwC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE7D,8EAA8E;IAC9E,0EAA0E;IAC1E,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/src/planner/rules/physical/rule-project-optimization.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rule: Project Optimization
+ *
+ * Transforms: ProjectNode → ProjectNode (optimized)
+ * Conditions: When project node's source needs optimization
+ * Benefits: Ensures project nodes have optimized sources and proper physical properties
+ */
+import type { PlanNode } from '../../nodes/plan-node.js';
+import type { OptContext } from '../../framework/context.js';
+export declare function ruleProjectOptimization(node: PlanNode, context: OptContext): PlanNode | null;
+//# sourceMappingURL=rule-project-optimization.d.ts.map

package/dist/src/planner/rules/physical/rule-project-optimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-project-optimization.d.ts","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-project-optimization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAqC5F"}

package/dist/src/planner/rules/physical/rule-project-optimization.js

@@ -0,0 +1,44 @@
+/**
+ * Rule: Project Optimization
+ *
+ * Transforms: ProjectNode → ProjectNode (optimized)
+ * Conditions: When project node's source needs optimization
+ * Benefits: Ensures project nodes have optimized sources and proper physical properties
+ */
+import { createLogger } from '../../../common/logger.js';
+import { ProjectNode } from '../../nodes/project-node.js';
+import { PlanNode as BasePlanNode } from '../../nodes/plan-node.js';
+const log = createLogger('optimizer:rule:project-optimization');
+export function ruleProjectOptimization(node, context) {
+    // Guard: only apply to ProjectNode
+    if (!(node instanceof ProjectNode)) {
+        return null;
+    }
+    log('Optimizing ProjectNode %s', node.id);
+    // Optimize the source
+    const optimizedSource = context.optimizer.optimizeNode(node.source, context);
+    // If source didn't change, just ensure physical properties are set
+    if (optimizedSource === node.source) {
+        if (!node.physical) {
+            BasePlanNode.setDefaultPhysical(node, {
+                estimatedRows: optimizedSource.estimatedRows,
+                deterministic: true,
+                readonly: true
+            });
+            log('Set physical properties on existing ProjectNode');
+            return node;
+        }
+        return null; // No change needed
+    }
+    // Source changed - create new project node with optimized source
+    const result = new ProjectNode(node.scope, optimizedSource, node.projections);
+    // Set physical properties
+    BasePlanNode.setDefaultPhysical(result, {
+        estimatedRows: optimizedSource.estimatedRows,
+        deterministic: true,
+        readonly: true
+    });
+    log('Created optimized ProjectNode with new source');
+    return result;
+}
+//# sourceMappingURL=rule-project-optimization.js.map

package/dist/src/planner/rules/physical/rule-project-optimization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-project-optimization.js","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-project-optimization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,GAAG,GAAG,YAAY,CAAC,qCAAqC,CAAC,CAAC;AAEhE,MAAM,UAAU,uBAAuB,CAAC,IAAc,EAAE,OAAmB;IAC1E,mCAAmC;IACnC,IAAI,CAAC,CAAC,IAAI,YAAY,WAAW,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,2BAA2B,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAE1C,sBAAsB;IACtB,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAuB,CAAC;IAEnG,mEAAmE;IACnE,IAAI,eAAe,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE;gBACrC,aAAa,EAAE,eAAe,CAAC,aAAa;gBAC5C,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACd,CAAC,CAAC;YACH,GAAG,CAAC,iDAAiD,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,mBAAmB;IACjC,CAAC;IAED,iEAAiE;IACjE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAE9E,0BAA0B;IAC1B,YAAY,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACvC,aAAa,EAAE,eAAe,CAAC,aAAa;QAC5C,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,GAAG,CAAC,+CAA+C,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/src/planner/rules/physical/rule-sort-optimization.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rule: Sort Optimization
+ *
+ * Transforms: SortNode → SortNode (optimized)
+ * Conditions: When sort node needs optimization or source changes
+ * Benefits: Ensures proper physical properties and optimizes child nodes
+ */
+import type { PlanNode } from '../../nodes/plan-node.js';
+import type { OptContext } from '../../framework/context.js';
+export declare function ruleSortOptimization(node: PlanNode, context: OptContext): PlanNode | null;
+//# sourceMappingURL=rule-sort-optimization.d.ts.map

package/dist/src/planner/rules/physical/rule-sort-optimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-sort-optimization.d.ts","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-sort-optimization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CA6CzF"}

package/dist/src/planner/rules/physical/rule-sort-optimization.js

@@ -0,0 +1,53 @@
+/**
+ * Rule: Sort Optimization
+ *
+ * Transforms: SortNode → SortNode (optimized)
+ * Conditions: When sort node needs optimization or source changes
+ * Benefits: Ensures proper physical properties and optimizes child nodes
+ */
+import { createLogger } from '../../../common/logger.js';
+import { SortNode } from '../../nodes/sort.js';
+import { PlanNode as BasePlanNode } from '../../nodes/plan-node.js';
+const log = createLogger('optimizer:rule:sort-optimization');
+export function ruleSortOptimization(node, context) {
+    // Guard: only apply to SortNode
+    if (!(node instanceof SortNode)) {
+        return null;
+    }
+    log('Optimizing SortNode %s', node.id);
+    // Sort is already a physical node in our current design
+    // Just optimize its source
+    const optimizedSource = context.optimizer.optimizeNode(node.source, context);
+    if (optimizedSource === node.source) {
+        // No change in source, but still need to ensure physical properties are set
+        if (!node.physical) {
+            BasePlanNode.setDefaultPhysical(node, {
+                ordering: node.sortKeys.map((key, idx) => ({
+                    column: idx,
+                    desc: key.direction === 'desc'
+                })),
+                estimatedRows: optimizedSource.estimatedRows,
+                deterministic: true,
+                readonly: true
+            });
+            log('Set physical properties on existing SortNode');
+            return node;
+        }
+        return null; // No change
+    }
+    // Source changed - create new sort node
+    const newSort = new SortNode(node.scope, optimizedSource, node.sortKeys);
+    // Set physical properties
+    BasePlanNode.setDefaultPhysical(newSort, {
+        ordering: node.sortKeys.map((key, idx) => ({
+            column: idx,
+            desc: key.direction === 'desc'
+        })),
+        estimatedRows: optimizedSource.estimatedRows,
+        deterministic: true,
+        readonly: true
+    });
+    log('Created optimized SortNode with new source');
+    return newSort;
+}
+//# sourceMappingURL=rule-sort-optimization.js.map

package/dist/src/planner/rules/physical/rule-sort-optimization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-sort-optimization.js","sourceRoot":"","sources":["../../../../../src/planner/rules/physical/rule-sort-optimization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,GAAG,GAAG,YAAY,CAAC,kCAAkC,CAAC,CAAC;AAE7D,MAAM,UAAU,oBAAoB,CAAC,IAAc,EAAE,OAAmB;IACvE,gCAAgC;IAChC,IAAI,CAAC,CAAC,IAAI,YAAY,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAEvC,wDAAwD;IACxD,2BAA2B;IAC3B,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAuB,CAAC;IACnG,IAAI,eAAe,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,4EAA4E;QAC5E,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE;gBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC1C,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE,GAAG,CAAC,SAAS,KAAK,MAAM;iBAC9B,CAAC,CAAC;gBACH,aAAa,EAAE,eAAe,CAAC,aAAa;gBAC5C,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACd,CAAC,CAAC;YACH,GAAG,CAAC,8CAA8C,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,YAAY;IAC1B,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEzE,0BAA0B;IAC1B,YAAY,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,GAAG,CAAC,SAAS,KAAK,MAAM;SAC9B,CAAC,CAAC;QACH,aAAa,EAAE,eAAe,CAAC,aAAa;QAC5C,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/src/planner/rules/rewrite/rule-constant-folding.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rule: Constant Folding
+ *
+ * Transforms: Relational nodes with constant scalar expressions → Same node with literals
+ * Conditions: When relational nodes contain scalar expressions that can be folded
+ * Benefits: Reduces runtime computation by evaluating constants at plan time
+ */
+import type { PlanNode } from '../../nodes/plan-node.js';
+import type { OptContext } from '../../framework/context.js';
+export declare function ruleConstantFolding(node: PlanNode, context: OptContext): PlanNode | null;
+//# sourceMappingURL=rule-constant-folding.d.ts.map

package/dist/src/planner/rules/rewrite/rule-constant-folding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-constant-folding.d.ts","sourceRoot":"","sources":["../../../../../src/planner/rules/rewrite/rule-constant-folding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CA4BxF"}

package/dist/src/planner/rules/rewrite/rule-constant-folding.js

@@ -0,0 +1,59 @@
+/**
+ * Rule: Constant Folding
+ *
+ * Transforms: Relational nodes with constant scalar expressions → Same node with literals
+ * Conditions: When relational nodes contain scalar expressions that can be folded
+ * Benefits: Reduces runtime computation by evaluating constants at plan time
+ */
+import { createLogger } from '../../../common/logger.js';
+import { classifyConstants, applyConstPropagation, createConstFoldingContext } from '../../analysis/const-pass.js';
+import { createRuntimeExpressionEvaluator } from '../../analysis/const-evaluator.js';
+const log = createLogger('optimizer:rule:constant-folding');
+export function ruleConstantFolding(node, context) {
+    // Only apply to relational nodes that can have scalar expressions
+    if (node.getType().typeClass !== 'relation') {
+        return null;
+    }
+    const relationalNode = node;
+    // Skip if this node doesn't have any scalar expressions to fold
+    // We'll target nodes that commonly have expressions: Project, Filter, etc.
+    const targetNodeTypes = new Set([
+        'Project', // Projection expressions
+        'Filter', // Predicate expressions
+        'Window', // Window function expressions
+        'Aggregate', // Aggregate expressions
+        'Sort', // Sort key expressions
+        'Values', // Literal values in VALUES clauses
+        'Join' // Join condition expressions
+    ]);
+    if (!targetNodeTypes.has(node.nodeType)) {
+        return null;
+    }
+    log('Applying constant folding to %s node %s', node.nodeType, node.id);
+    // Apply constant folding using the full const-pass infrastructure
+    return applyConstantFoldingToNode(relationalNode, context);
+}
+/**
+ * Apply constant folding to a relational node using the const-pass infrastructure
+ */
+function applyConstantFoldingToNode(node, context) {
+    try {
+        // Create runtime expression evaluator
+        const evaluator = createRuntimeExpressionEvaluator(context.db);
+        const foldingContext = createConstFoldingContext(evaluator);
+        // Classify constants in the tree
+        classifyConstants(node, foldingContext);
+        // Apply propagation
+        const result = applyConstPropagation(node, foldingContext);
+        if (result !== node) {
+            log('Constant folding transformed node %s', node.nodeType);
+            return result;
+        }
+        return null; // No changes
+    }
+    catch (error) {
+        log('Failed to apply constant folding to node %s: %s', node.id, error);
+        return null;
+    }
+}
+//# sourceMappingURL=rule-constant-folding.js.map

package/dist/src/planner/rules/rewrite/rule-constant-folding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-constant-folding.js","sourceRoot":"","sources":["../../../../../src/planner/rules/rewrite/rule-constant-folding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAErF,MAAM,GAAG,GAAG,YAAY,CAAC,iCAAiC,CAAC,CAAC;AAE5D,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,OAAmB;IACtE,kEAAkE;IAClE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,cAAc,GAAG,IAA0B,CAAC;IAElD,gEAAgE;IAChE,2EAA2E;IAC3E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;QAC/B,SAAS,EAAK,yBAAyB;QACvC,QAAQ,EAAM,wBAAwB;QACtC,QAAQ,EAAM,8BAA8B;QAC5C,WAAW,EAAG,wBAAwB;QACtC,MAAM,EAAQ,uBAAuB;QACrC,QAAQ,EAAM,mCAAmC;QACjD,MAAM,CAAQ,6BAA6B;KAC3C,CAAC,CAAC;IAEH,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,yCAAyC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAEvE,kEAAkE;IAClE,OAAO,0BAA0B,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,IAAwB,EAAE,OAAmB;IAChF,IAAI,CAAC;QACJ,sCAAsC;QACtC,MAAM,SAAS,GAAG,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,cAAc,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAE5D,iCAAiC;QACjC,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAExC,oBAAoB;QACpB,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAE3D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACrB,GAAG,CAAC,sCAAsC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3D,OAAO,MAAM,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,CAAC,aAAa;IAE3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,GAAG,CAAC,iDAAiD,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/src/planner/scopes/aliased.d.ts

@@ -0,0 +1,18 @@
+import type { PlanNode } from "../nodes/plan-node.js";
+import type { Scope } from "./scope.js";
+import { Ambiguous } from "./scope.js";
+import * as AST from "../../parser/ast.js";
+import { BaseScope } from "./base.js";
+/**
+ * A Scope that aliases a parent scope.
+ *
+ * @param parent The parent scope, assumed to already be populated with symbols..
+ */
+export declare class AliasedScope extends BaseScope {
+    readonly parent: Scope;
+    private readonly _parentName;
+    private readonly _alias;
+    constructor(parent: Scope, parentName: string, alias: string);
+    resolveSymbol(symbolKey: string, expression: AST.Expression): PlanNode | typeof Ambiguous | undefined;
+}
+//# sourceMappingURL=aliased.d.ts.map

package/dist/src/planner/scopes/aliased.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliased.d.ts","sourceRoot":"","sources":["../../../../src/planner/scopes/aliased.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,SAAS;aAKzB,MAAM,EAAE,KAAK;IAJ9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGf,MAAM,EAAE,KAAK,EAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM;IAOd,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,OAAO,SAAS,GAAG,SAAS;CAwBrG"}

package/dist/src/planner/scopes/aliased.js

@@ -0,0 +1,41 @@
+import { BaseScope } from "./base.js";
+/**
+ * A Scope that aliases a parent scope.
+ *
+ * @param parent The parent scope, assumed to already be populated with symbols..
+ */
+export class AliasedScope extends BaseScope {
+    parent;
+    _parentName;
+    _alias;
+    constructor(parent, parentName, alias) {
+        super();
+        this.parent = parent;
+        this._parentName = parentName.toLowerCase();
+        this._alias = alias.toLowerCase();
+    }
+    resolveSymbol(symbolKey, expression) {
+        const parts = symbolKey.split('.');
+        // Handle schema-qualified symbols like "main.j.value"
+        if (parts.length === 3 && parts[1].toLowerCase() === this._alias) {
+            // Replace alias with parent name: "main.j.value" -> "main..value" -> "main.value" (if parent name is empty)
+            if (this._parentName === '') {
+                // For table-valued functions, remove the alias entirely: "main.j.value" -> "value"
+                return this.parent.resolveSymbol(parts[2], expression);
+            }
+            else {
+                parts[1] = this._parentName;
+                return this.parent.resolveSymbol(parts.join('.'), expression);
+            }
+        }
+        // Handle qualified symbols like "j.value"
+        else if (parts.length === 2 && parts[0].toLowerCase() === this._alias) {
+            // For both cases (table-valued functions and regular tables),
+            // just use the column name since the parent scope knows what table it represents
+            return this.parent.resolveSymbol(parts[1], expression);
+        }
+        // For all other symbols (including unqualified columns), delegate to parent
+        return this.parent.resolveSymbol(symbolKey, expression);
+    }
+}
+//# sourceMappingURL=aliased.js.map

package/dist/src/planner/scopes/aliased.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliased.js","sourceRoot":"","sources":["../../../../src/planner/scopes/aliased.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IAKzB;IAJA,WAAW,CAAS;IACpB,MAAM,CAAS;IAEhC,YACiB,MAAa,EAC7B,UAAkB,EAClB,KAAa;QAEb,KAAK,EAAE,CAAC;QAJQ,WAAM,GAAN,MAAM,CAAO;QAK7B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,aAAa,CAAC,SAAiB,EAAE,UAA0B;QAC1D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnC,sDAAsD;QACtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAClE,4GAA4G;YAC5G,IAAI,IAAI,CAAC,WAAW,KAAK,EAAE,EAAE,CAAC;gBAC7B,mFAAmF;gBACnF,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;gBAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;YAC/D,CAAC;QACF,CAAC;QACD,0CAA0C;aACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACvE,8DAA8D;YAC9D,iFAAiF;YACjF,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACxD,CAAC;QAED,4EAA4E;QAC5E,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;CACD"}

package/dist/src/planner/scopes/base.d.ts

@@ -0,0 +1,20 @@
+import type { PlanNode } from '../nodes/plan-node.js';
+import * as AST from '../../parser/ast.js';
+import { type Scope, Ambiguous } from './scope.js';
+/**
+ * Scope that tracks references.
+ */
+export declare abstract class BaseScope implements Scope {
+    /** References that have been resolved through this scope. */
+    private _references;
+    abstract resolveSymbol(symbolKey: string, expression: AST.Expression): PlanNode | typeof Ambiguous | undefined;
+    /**
+     * Returns all references that have been resolved through this scope.
+     * This includes references from both this scope and any parent scopes.
+     *
+     * @returns An array of all resolved references.
+     */
+    getReferences(): readonly PlanNode[];
+    addReference(reference: PlanNode): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/planner/scopes/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/planner/scopes/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,8BAAsB,SAAU,YAAW,KAAK;IAC/C,6DAA6D;IAC7D,OAAO,CAAC,WAAW,CAAkB;IAErC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,OAAO,SAAS,GAAG,SAAS;IAE9G;;;;;OAKG;IACH,aAAa,IAAI,SAAS,QAAQ,EAAE;IAIpC,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,IAAI;CAGvC"}

package/dist/src/planner/scopes/base.js

@@ -0,0 +1,20 @@
+/**
+ * Scope that tracks references.
+ */
+export class BaseScope {
+    /** References that have been resolved through this scope. */
+    _references = [];
+    /**
+     * Returns all references that have been resolved through this scope.
+     * This includes references from both this scope and any parent scopes.
+     *
+     * @returns An array of all resolved references.
+     */
+    getReferences() {
+        return this._references;
+    }
+    addReference(reference) {
+        this._references.push(reference);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/src/planner/scopes/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/planner/scopes/base.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAgB,SAAS;IAC9B,6DAA6D;IACrD,WAAW,GAAe,EAAE,CAAC;IAIrC;;;;;OAKG;IACH,aAAa;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,SAAmB;QAC/B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CACD"}

package/dist/src/planner/scopes/empty.d.ts

@@ -0,0 +1,11 @@
+import * as AST from '../../parser/ast.js';
+import type { PlanNode } from '../nodes/plan-node.js';
+import { type Scope, Ambiguous } from './scope.js';
+/** Scope that contains no symbols.  */
+export declare class EmptyScope implements Scope {
+    resolveSymbol(_symbolKey: string, _expression: AST.Expression): PlanNode | typeof Ambiguous | undefined;
+    getReferences(): readonly PlanNode[];
+    addReference(_reference: PlanNode): void;
+    static readonly instance: EmptyScope;
+}
+//# sourceMappingURL=empty.d.ts.map

package/dist/src/planner/scopes/empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../../src/planner/scopes/empty.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEnD,uCAAuC;AACvC,qBAAa,UAAW,YAAW,KAAK;IACvC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,OAAO,SAAS,GAAG,SAAS;IAIvG,aAAa,IAAI,SAAS,QAAQ,EAAE;IAIpC,YAAY,CAAC,UAAU,EAAE,QAAQ,GAAG,IAAI;IAIxC,MAAM,CAAC,QAAQ,CAAC,QAAQ,aAAoB;CAC5C"}

package/dist/src/planner/scopes/empty.js

@@ -0,0 +1,16 @@
+import { QuereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+/** Scope that contains no symbols.  */
+export class EmptyScope {
+    resolveSymbol(_symbolKey, _expression) {
+        return undefined;
+    }
+    getReferences() {
+        return [];
+    }
+    addReference(_reference) {
+        throw new QuereusError('EmptyScope does not support adding references.', StatusCode.MISUSE);
+    }
+    static instance = new EmptyScope();
+}
+//# sourceMappingURL=empty.js.map

package/dist/src/planner/scopes/empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../../../src/planner/scopes/empty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKnD,uCAAuC;AACvC,MAAM,OAAO,UAAU;IACtB,aAAa,CAAC,UAAkB,EAAE,WAA2B;QAC5D,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,aAAa;QACZ,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YAAY,CAAC,UAAoB;QAChC,MAAM,IAAI,YAAY,CAAC,gDAAgD,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,CAAU,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/src/planner/scopes/global.d.ts

@@ -0,0 +1,12 @@
+import { BaseScope } from "./base.js";
+import type { SchemaManager } from "../../schema/manager.js";
+import type { PlanNode } from "../nodes/plan-node.js";
+import * as AST from "../../parser/ast.js";
+import { Ambiguous } from "./scope.js";
+export declare class GlobalScope extends BaseScope {
+    readonly manager: SchemaManager;
+    constructor(manager: SchemaManager);
+    resolveSymbol(symbolKey: string, _expression: AST.Expression): PlanNode | typeof Ambiguous | undefined;
+    findUnqualifiedName(name: string): PlanNode | typeof Ambiguous | undefined;
+}
+//# sourceMappingURL=global.d.ts.map

package/dist/src/planner/scopes/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../../src/planner/scopes/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAKvC,qBAAa,WAAY,SAAQ,SAAS;aACb,OAAO,EAAE,aAAa;gBAAtB,OAAO,EAAE,aAAa;IAIlD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,OAAO,SAAS,GAAG,SAAS;IAiCtG,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,SAAS,GAAG,SAAS;CAwB1E"}

package/dist/src/planner/scopes/global.js

@@ -0,0 +1,65 @@
+import { BaseScope } from "./base.js";
+import { FunctionReferenceNode, TableReferenceNode } from "../nodes/reference.js";
+import { SqlDataType } from "../../common/types.js";
+import { isScalarFunctionSchema } from "../../schema/function.js";
+export class GlobalScope extends BaseScope {
+    manager;
+    constructor(manager) {
+        super();
+        this.manager = manager;
+    }
+    resolveSymbol(symbolKey, _expression) {
+        if (symbolKey.includes('/')) { // Function: [schema.]name/nArgs
+            const [name, nArgsStr] = symbolKey.split('/');
+            const nArgs = parseInt(nArgsStr);
+            const func = this.manager.findFunction(name, nArgs);
+            if (!func) {
+                return undefined;
+            }
+            // Get the proper scalar type from the function schema
+            const scalarType = isScalarFunctionSchema(func)
+                ? func.returnType
+                : { typeClass: 'scalar', affinity: SqlDataType.NUMERIC, nullable: true, isReadOnly: true };
+            return new FunctionReferenceNode(this, func, scalarType);
+        }
+        // Table: [schema.]table
+        const [first, second] = symbolKey.split('.');
+        const schema = second ? first : undefined;
+        const table = second ? second : first;
+        const tableSchema = this.manager.findTable(table, schema);
+        if (!tableSchema) {
+            return undefined;
+        }
+        // Note: GlobalScope can't resolve vtab modules without a planning context
+        // This path is mainly used for constraint checking where we don't need full resolution
+        const vtabModule = this.manager.getModule(tableSchema.vtabModuleName);
+        if (!vtabModule) {
+            return undefined;
+        }
+        return new TableReferenceNode(this, tableSchema, vtabModule.module, vtabModule.auxData);
+    }
+    findUnqualifiedName(name) {
+        // Functions have priority over tables.
+        // Check for zero-argument functions first
+        const func = this.manager.findFunction(name, 0);
+        if (func) {
+            // Get the proper scalar type from the function schema
+            const scalarType = isScalarFunctionSchema(func)
+                ? func.returnType
+                : { typeClass: 'scalar', affinity: SqlDataType.NUMERIC, nullable: true, isReadOnly: true };
+            return new FunctionReferenceNode(this, func, scalarType);
+        }
+        // Table: [schema.]table
+        const table = this.manager.findTable(name);
+        if (table) {
+            // TODO: Create a proper ColumnScope to allow column references
+            const vtabModule = this.manager.getModule(table.vtabModuleName);
+            if (!vtabModule) {
+                return undefined;
+            }
+            return new TableReferenceNode(this, table, vtabModule.module, vtabModule.auxData);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=global.js.map

package/dist/src/planner/scopes/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../../src/planner/scopes/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGlF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,OAAO,WAAY,SAAQ,SAAS;IACb;IAA5B,YAA4B,OAAsB;QACjD,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAe;IAElD,CAAC;IAED,aAAa,CAAC,SAAiB,EAAE,WAA2B;QAC3D,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA,gCAAgC;YAC7D,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACX,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,sDAAsD;YACtD,MAAM,UAAU,GAAe,sBAAsB,CAAC,IAAI,CAAC;gBAC1D,CAAC,CAAC,IAAI,CAAC,UAAU;gBACjB,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAE5F,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QACD,wBAAwB;QACxB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,0EAA0E;QAC1E,uFAAuF;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACtE,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;IAED,mBAAmB,CAAC,IAAY;QAC/B,uCAAuC;QACvC,0CAA0C;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,IAAI,EAAE,CAAC;YACV,sDAAsD;YACtD,MAAM,UAAU,GAAe,sBAAsB,CAAC,IAAI,CAAC;gBAC1D,CAAC,CAAC,IAAI,CAAC,UAAU;gBACjB,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAE5F,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QACD,wBAAwB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACX,+DAA+D;YAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAChE,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjB,OAAO,SAAS,CAAC;YAClB,CAAC;YACD,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;CACD"}

package/dist/src/planner/scopes/multi.d.ts

@@ -0,0 +1,17 @@
+import { Ambiguous } from "./scope.js";
+import * as AST from "../../parser/ast.js";
+import type { PlanNode } from "../nodes/plan-node.js";
+import type { Scope } from "./scope.js";
+import { BaseScope } from "./base.js";
+/**
+ * A Scope that contains multiple other scopes.
+ * Symbols are resolved in order, and the first match is used.
+ * If a symbol is found in multiple scopes, an error is thrown.
+ */
+export declare class MultiScope extends BaseScope {
+    readonly scopes: Scope[];
+    constructor(scopes: Scope[]);
+    registerSymbol(_symbolKey: string, _getReference: (expression: AST.Expression, currentScope: Scope) => PlanNode): void;
+    resolveSymbol(symbolKey: string, expression: AST.Expression): PlanNode | typeof Ambiguous | undefined;
+}
+//# sourceMappingURL=multi.d.ts.map

package/dist/src/planner/scopes/multi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.d.ts","sourceRoot":"","sources":["../../../../src/planner/scopes/multi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAG3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,SAAS;aAEvB,MAAM,EAAE,KAAK,EAAE;gBAAf,MAAM,EAAE,KAAK,EAAE;IAKhC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,KAAK,QAAQ,GAAG,IAAI;IAItH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,OAAO,SAAS,GAAG,SAAS;CAerG"}