@quereus/quereus 0.1.0

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

@@ -0,0 +1,297 @@
+import { PlanNodeType } from './plan-node-type.js';
+import type { Scope } from '../scopes/scope.js';
+import type { BaseType, RelationType, ScalarType } from '../../common/datatype.js';
+import type { Expression } from '../../parser/ast.js';
+import type { OutputValue, Row } from '../../common/types.js';
+/**
+ * Physical properties that execution nodes can provide or require
+ */
+export interface PhysicalProperties {
+    /** Ordering of rows. Each element is a column index, negative for DESC */
+    ordering?: {
+        column: number;
+        desc: boolean;
+    }[];
+    /** Estimated number of rows this node will produce */
+    estimatedRows?: number;
+    /**
+     * Column sets that are guaranteed unique in the output.
+     * Unlike logical keys which are schema-defined, these are derived from
+     * the operation (e.g., DISTINCT creates a unique key on all columns)
+     */
+    uniqueKeys?: number[][];
+    /**
+     * Whether this node is read-only (does not mutate external state).
+     * false = has side effects, true = pure/read-only
+     */
+    readonly?: boolean;
+    /**
+     * Whether this node is deterministic - same inputs always produce same outputs.
+     * Non-deterministic examples: random(), now(), sequence generators
+     */
+    deterministic?: boolean;
+    /**
+     * Whether this node is idempotent - calling twice in same transaction
+     * leaves state as if called once. Only meaningful for non-readonly nodes.
+     * Examples: INSERT with IGNORE, UPDATE with same values
+     */
+    idempotent?: boolean;
+    /**
+     * Whether this node directly produces a constant result (deterministic, readonly, and no dependencies).
+       * If this is true, the node should implement getValue() to return the constant value.
+     */
+    constant?: boolean;
+}
+/**
+ * Default physical properties for plan nodes
+ */
+export declare const DEFAULT_PHYSICAL: PhysicalProperties;
+/**
+ * Represents a column with a unique identifier that persists across plan transformations
+ */
+export interface Attribute {
+    /** Globally unique identifier for this column */
+    id: number;
+    /** Human-readable name (may not be unique) */
+    name: string;
+    /** Data type information */
+    type: ScalarType;
+    /** Source relation that originally produced this column */
+    sourceRelation?: string;
+}
+/**
+ * Row descriptor that maps attribute IDs to column indices in a row array
+ */
+export type RowDescriptor = number[];
+/**
+ * Function that returns a row when called
+ */
+export type RowGetter = () => Row;
+export type TableDescriptor = {};
+export type TableGetter = () => AsyncIterable<Row>;
+/**
+ * Base class for all nodes in the logical query plan.
+ * PlanNodes are immutable once constructed.
+ */
+export declare abstract class PlanNode {
+    /** The scope in which this node is planned.  Note that this captures references made through it, so you can tell if a node has dependencies. */
+    readonly scope: Scope;
+    /** Estimated cost to execute this node itself (excluding its children). */
+    readonly estimatedCost: number;
+    private static nextId;
+    private static nextAttributeId;
+    readonly id: string;
+    abstract readonly nodeType: PlanNodeType;
+    /** Present if the node is a physical plan node */
+    private _physical?;
+    constructor(
+    /** The scope in which this node is planned.  Note that this captures references made through it, so you can tell if a node has dependencies. */
+    scope: Scope, 
+    /** Estimated cost to execute this node itself (excluding its children). */
+    estimatedCost?: number);
+    abstract getType(): BaseType;
+    abstract getChildren(): readonly PlanNode[];
+    /**
+     * Default implementation of getRelations() that filters getChildren()
+     * Can be overridden for performance if needed
+     */
+    getRelations(): readonly RelationalPlanNode[];
+    /**
+     * Return this node with its children replaced by newChildren.
+     * MUST keep attribute IDs stable unless the concrete node deliberately produces new columns.
+     *
+     * Implementations must:
+     *   1. Verify arity (throw if length mismatch)
+     *   2. Return `this` if nothing changed
+     *   3. Otherwise construct a new instance copying all immutable properties
+     */
+    abstract withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    /**
+     * Compute physical property overrides for this node
+     * Called by the optimizer when converting logical to physical nodes.
+     * @param children Physical properties of optimized children
+     */
+    computePhysical?(children: readonly PhysicalProperties[]): Partial<PhysicalProperties>;
+    /**
+     * Get the attributes (columns) produced by this relational node
+     */
+    getAttributes?(): Attribute[];
+    /**
+     * Get map of attribute ID to producing scalar expression (for constant folding)
+     * Only relational nodes that synthesize columns from expressions need implement this
+     */
+    getProducingExprs?(): Map<number, ScalarPlanNode>;
+    getTotalCost(): number;
+    visit(visitor: PlanNodeVisitor): void;
+    toString(): string;
+    /**
+   * Get logical properties for this node.
+   * Override to provide node-specific logical information.
+   */
+    getLogicalAttributes(): Record<string, unknown>;
+    /** Infer and cache the physical properties of this node */
+    get physical(): PhysicalProperties;
+    /** Helper to generate unique attribute IDs */
+    static nextAttrId(): number;
+    /**
+     * Check if a node is functional (pure and deterministic), safe for constant folding
+     */
+    static isFunctional(physical: PhysicalProperties): boolean;
+    /**
+     * Check if a node has side effects (mutates external state)
+     */
+    static hasSideEffects(physical: PhysicalProperties): boolean;
+}
+export type PlanNodeVisitor = (node: PlanNode) => void;
+/**
+ * Base class for PlanNodes that do not produce a relational or scalar output,
+ * typically used for DDL or other side-effecting operations.
+ */
+export declare abstract class VoidNode extends PlanNode {
+    getType(): BaseType;
+    getChildren(): readonly PlanNode[];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    getRelations(): readonly RelationalPlanNode[];
+}
+/**
+ * Base interface for PlanNodes that produce a relation (a set of rows).
+ * Note: this is an interface that concrete RelationalNode classes will implement.
+ */
+export interface RelationalPlanNode extends PlanNode {
+    /** Estimated number of rows this node will output. */
+    readonly estimatedRows?: number;
+    getType(): RelationType;
+    /**
+     * Get the attributes (columns) produced by this relational node
+     * Each attribute has a unique ID that persists across plan transformations
+     */
+    getAttributes(): Attribute[];
+}
+/**
+ * Base interface for PlanNodes that produce a scalar value (Expression Nodes).
+ * Note: this is an interface that concrete ScalarNode classes will implement.
+ */
+export interface ScalarPlanNode extends PlanNode {
+    readonly expression: Expression;
+    getType(): ScalarType;
+}
+/** A relational plan node that has no relational inputs (a leaf in the relational algebra tree).
+ * Will not have scalar inputs either - this is either TableDee or TableDum, projection can be used to compute columns
+ */
+export interface ZeroAryRelationalNode extends RelationalPlanNode {
+    getRelations(): readonly [];
+}
+/** A relational plan node that operates on a single relational input. */
+export interface UnaryRelationalNode extends RelationalPlanNode {
+    readonly source: RelationalPlanNode;
+    getRelations(): readonly [RelationalPlanNode];
+}
+/** A relational plan node that operates on two relational inputs. */
+export interface BinaryRelationalNode extends RelationalPlanNode {
+    readonly left: RelationalPlanNode;
+    readonly right: RelationalPlanNode;
+    getRelations(): readonly [RelationalPlanNode, RelationalPlanNode];
+}
+/** A scalar plan node that has no scalar inputs (a leaf in an expression tree).
+ * May have relational input(s) e.g. EXISTS, IN, etc.
+ */
+export interface ZeroAryScalarNode extends ScalarPlanNode {
+    getChildren(): readonly [];
+}
+/** A scalar plan node that operates on a single scalar input. */
+export interface UnaryScalarNode extends ScalarPlanNode {
+    readonly operand: ScalarPlanNode;
+    getChildren(): readonly [ScalarPlanNode];
+}
+/** A scalar plan node that operates on two scalar inputs. */
+export interface BinaryScalarNode extends ScalarPlanNode {
+    readonly left: ScalarPlanNode;
+    readonly right: ScalarPlanNode;
+    getChildren(): readonly [ScalarPlanNode, ScalarPlanNode];
+}
+/** A scalar plan node that operates on N scalar inputs. */
+export interface NaryScalarNode extends ScalarPlanNode {
+    readonly operands: ReadonlyArray<ScalarPlanNode>;
+    getChildren(): readonly ScalarPlanNode[];
+}
+/**
+ * Base class for relational nodes with no relational inputs (leaf nodes)
+ */
+export declare abstract class ZeroAryRelationalBase extends PlanNode implements ZeroAryRelationalNode {
+    abstract getType(): RelationType;
+    abstract getAttributes(): Attribute[];
+    getChildren(): readonly PlanNode[];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * Base class for relational nodes with one relational input
+ */
+export declare abstract class UnaryRelationalBase extends PlanNode implements UnaryRelationalNode {
+    abstract readonly source: RelationalPlanNode;
+    abstract getType(): RelationType;
+    abstract getAttributes(): Attribute[];
+    getChildren(): readonly PlanNode[];
+    getRelations(): readonly [RelationalPlanNode];
+    abstract withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * Base class for relational nodes with two relational inputs
+ */
+export declare abstract class BinaryRelationalBase extends PlanNode implements BinaryRelationalNode {
+    abstract readonly left: RelationalPlanNode;
+    abstract readonly right: RelationalPlanNode;
+    abstract getType(): RelationType;
+    abstract getAttributes(): Attribute[];
+    getChildren(): readonly PlanNode[];
+    getRelations(): readonly [RelationalPlanNode, RelationalPlanNode];
+    abstract withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * Base class for scalar nodes with no scalar inputs (leaf expressions)
+ */
+export declare abstract class ZeroAryScalarBase extends PlanNode implements ZeroAryScalarNode {
+    abstract readonly expression: Expression;
+    abstract getType(): ScalarType;
+    getChildren(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * Base class for scalar nodes with one scalar input
+ */
+export declare abstract class UnaryScalarBase extends PlanNode implements UnaryScalarNode {
+    abstract readonly operand: ScalarPlanNode;
+    abstract readonly expression: Expression;
+    abstract getType(): ScalarType;
+    getChildren(): readonly [ScalarPlanNode];
+    abstract withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * Base class for scalar nodes with two scalar inputs
+ */
+export declare abstract class BinaryScalarBase extends PlanNode implements BinaryScalarNode {
+    abstract readonly left: ScalarPlanNode;
+    abstract readonly right: ScalarPlanNode;
+    abstract readonly expression: Expression;
+    abstract getType(): ScalarType;
+    getChildren(): readonly [ScalarPlanNode, ScalarPlanNode];
+    abstract withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * Base class for scalar nodes with N scalar inputs
+ */
+export declare abstract class NaryScalarBase extends PlanNode implements NaryScalarNode {
+    abstract readonly operands: ReadonlyArray<ScalarPlanNode>;
+    abstract readonly expression: Expression;
+    abstract getType(): ScalarType;
+    getChildren(): readonly ScalarPlanNode[];
+    abstract withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+/**
+ * A node that directly produces a constant result (deterministic, readonly, and no dependencies).
+ * If the node is constant (literal value), it should implement getValue() to return the constant value.
+ */
+export interface ConstantNode extends PlanNode {
+    getValue(): OutputValue;
+}
+//# sourceMappingURL=plan-node.d.ts.map

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

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

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

@@ -0,0 +1,198 @@
+import { quereusError } from '../../common/errors.js';
+// Derived properties (computed, not stored):
+// functional = deterministic && readonly (safe for constant folding)
+// sideEffects = !readonly (mutates external state)
+/**
+ * Default physical properties for plan nodes
+ */
+export const DEFAULT_PHYSICAL = {
+    deterministic: true,
+    readonly: true,
+    idempotent: true, // Default true for readonly nodes
+    constant: false,
+};
+/**
+ * Base class for all nodes in the logical query plan.
+ * PlanNodes are immutable once constructed.
+ */
+export class PlanNode {
+    scope;
+    estimatedCost;
+    static nextId = 0;
+    static nextAttributeId = 0;
+    id;
+    /** Present if the node is a physical plan node */
+    _physical;
+    constructor(
+    /** The scope in which this node is planned.  Note that this captures references made through it, so you can tell if a node has dependencies. */
+    scope, 
+    /** Estimated cost to execute this node itself (excluding its children). */
+    estimatedCost = 0.01) {
+        this.scope = scope;
+        this.estimatedCost = estimatedCost;
+        this.id = `${PlanNode.nextId++}`;
+    }
+    /**
+     * Default implementation of getRelations() that filters getChildren()
+     * Can be overridden for performance if needed
+     */
+    getRelations() {
+        return this.getChildren()
+            .filter((c) => 'getAttributes' in c && typeof c.getAttributes === 'function');
+    }
+    getTotalCost() {
+        return (this.estimatedCost + this.getChildren().reduce((acc, child) => acc + child.getTotalCost(), 0))
+            * (this.getRelations().reduce((acc, relation) => acc + relation.getTotalCost(), 0) || 1);
+    }
+    visit(visitor) {
+        visitor(this);
+        this.getChildren().forEach(child => child.visit(visitor));
+        this.getRelations().forEach(relation => relation.visit(visitor));
+    }
+    toString() {
+        return `${this.nodeType} [${this.id}]`;
+    }
+    /**
+   * Get logical properties for this node.
+   * Override to provide node-specific logical information.
+   */
+    getLogicalAttributes() {
+        return {};
+    }
+    /** Infer and cache the physical properties of this node */
+    get physical() {
+        if (!this._physical) {
+            const childrenPhysical = this.getChildren().map(child => child.physical);
+            // Get the node-specific overrides
+            const propsOverride = this.computePhysical?.(childrenPhysical);
+            // Derive defaults from children if there are any, else leaf defaults
+            const defaults = childrenPhysical.length
+                ? {
+                    deterministic: childrenPhysical.every(child => child.deterministic),
+                    idempotent: childrenPhysical.every(child => child.idempotent),
+                    readonly: childrenPhysical.every(child => child.readonly),
+                    constant: childrenPhysical.every(child => child.constant),
+                }
+                : DEFAULT_PHYSICAL;
+            this._physical = { ...defaults, ...propsOverride };
+        }
+        return this._physical;
+    }
+    /** Helper to generate unique attribute IDs */
+    static nextAttrId() {
+        return PlanNode.nextAttributeId++;
+    }
+    /**
+     * Check if a node is functional (pure and deterministic), safe for constant folding
+     */
+    static isFunctional(physical) {
+        return (physical.deterministic !== false) && (physical.readonly !== false);
+    }
+    /**
+     * Check if a node has side effects (mutates external state)
+     */
+    static hasSideEffects(physical) {
+        return physical.readonly === false;
+    }
+}
+/**
+ * Base class for PlanNodes that do not produce a relational or scalar output,
+ * typically used for DDL or other side-effecting operations.
+ */
+export class VoidNode extends PlanNode {
+    getType() {
+        // Indicates a non-relational, non-scalar result, e.g., status object or no output.
+        return { typeClass: 'void' };
+    }
+    getChildren() {
+        return []; // No direct child plan nodes in the execution sense
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`${this.nodeType} expects 0 children, got ${newChildren.length}`);
+        }
+        return this; // No children, so no change
+    }
+    getRelations() {
+        return []; // Does not operate on input relations
+    }
+}
+// --- Concrete Arity-Based Base Classes ---
+/**
+ * Base class for relational nodes with no relational inputs (leaf nodes)
+ */
+export class ZeroAryRelationalBase extends PlanNode {
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`${this.nodeType} expects 0 children, got ${newChildren.length}`);
+        }
+        return this;
+    }
+}
+/**
+ * Base class for relational nodes with one relational input
+ */
+export class UnaryRelationalBase extends PlanNode {
+    getChildren() {
+        return [this.source];
+    }
+    getRelations() {
+        return [this.source];
+    }
+}
+/**
+ * Base class for relational nodes with two relational inputs
+ */
+export class BinaryRelationalBase extends PlanNode {
+    getChildren() {
+        return [this.left, this.right];
+    }
+    getRelations() {
+        return [this.left, this.right];
+    }
+}
+/**
+ * Base class for scalar nodes with no scalar inputs (leaf expressions)
+ */
+export class ZeroAryScalarBase extends PlanNode {
+    getChildren() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`${this.nodeType} expects 0 children, got ${newChildren.length}`);
+        }
+        return this;
+    }
+}
+/**
+ * Base class for scalar nodes with one scalar input
+ */
+export class UnaryScalarBase extends PlanNode {
+    getChildren() {
+        return [this.operand];
+    }
+}
+/**
+ * Base class for scalar nodes with two scalar inputs
+ */
+export class BinaryScalarBase extends PlanNode {
+    getChildren() {
+        return [this.left, this.right];
+    }
+}
+/**
+ * Base class for scalar nodes with N scalar inputs
+ */
+export class NaryScalarBase extends PlanNode {
+    getChildren() {
+        return this.operands;
+    }
+}
+//# sourceMappingURL=plan-node.js.map

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

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

package/dist/src/planner/nodes/pragma.d.ts

@@ -0,0 +1,21 @@
+import { type SqlValue } from '../../common/types.js';
+import * 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';
+export declare class PragmaPlanNode extends PlanNode implements RelationalPlanNode {
+    readonly pragmaName: string;
+    readonly statementAst: AST.PragmaStmt;
+    readonly value?: SqlValue | undefined;
+    readonly nodeType = PlanNodeType.Pragma;
+    constructor(scope: any, pragmaName: string, statementAst: AST.PragmaStmt, value?: SqlValue | undefined);
+    getType(): RelationType;
+    get estimatedRows(): number | undefined;
+    getAttributes(): Attribute[];
+    getChildren(): PlanNode[];
+    withChildren(_newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=pragma.d.ts.map

package/dist/src/planner/nodes/pragma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pragma.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/pragma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,qBAAa,cAAe,SAAQ,QAAS,YAAW,kBAAkB;aAKxD,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,GAAG,CAAC,UAAU;aAC5B,KAAK,CAAC,EAAE,QAAQ;IANjC,SAAkB,QAAQ,uBAAuB;gBAGhD,KAAK,EAAE,GAAG,EACM,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,GAAG,CAAC,UAAU,EAC5B,KAAK,CAAC,EAAE,QAAQ,YAAA;IAKjC,OAAO,IAAI,YAAY;IA+BvB,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,aAAa,IAAI,SAAS,EAAE;IAW5B,WAAW,IAAI,QAAQ,EAAE;IAIzB,YAAY,CAAC,YAAY,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAIhD,QAAQ,IAAI,MAAM;IAOlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYxD"}

package/dist/src/planner/nodes/pragma.js

@@ -0,0 +1,80 @@
+import { SqlDataType } from '../../common/types.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { expressionToString } from '../../util/ast-stringify.js';
+import { PlanNode } from './plan-node.js';
+export class PragmaPlanNode extends PlanNode {
+    pragmaName;
+    statementAst;
+    value;
+    nodeType = PlanNodeType.Pragma;
+    constructor(scope, pragmaName, statementAst, value) {
+        super(scope, 1); // PRAGMA operations have low cost
+        this.pragmaName = pragmaName;
+        this.statementAst = statementAst;
+        this.value = value;
+    }
+    getType() {
+        return {
+            typeClass: 'relation',
+            isReadOnly: true,
+            isSet: true,
+            columns: [
+                {
+                    name: "name",
+                    type: {
+                        typeClass: 'scalar',
+                        affinity: SqlDataType.TEXT,
+                        nullable: false,
+                        isReadOnly: true,
+                    },
+                    generated: true,
+                },
+                {
+                    name: "value",
+                    type: {
+                        typeClass: 'scalar',
+                        affinity: SqlDataType.TEXT,
+                        nullable: false,
+                    },
+                    generated: true,
+                },
+            ],
+            keys: [[]],
+            rowConstraints: [],
+        };
+    }
+    get estimatedRows() {
+        return 1;
+    }
+    getAttributes() {
+        return this.getType().columns.map((column) => ({
+            id: PlanNode.nextAttrId(),
+            name: column.name, // Use the deduplicated name
+            type: column.type,
+            sourceRelation: `${this.nodeType}:${this.id}`
+        }));
+    }
+    getChildren() {
+        return [];
+    }
+    withChildren(_newChildren) {
+        return new PragmaPlanNode(this.scope, this.pragmaName, this.statementAst, this.value);
+    }
+    toString() {
+        if (this.value !== undefined) {
+            return `PRAGMA ${this.pragmaName} = ${this.value}`;
+        }
+        return `PRAGMA ${this.pragmaName}`;
+    }
+    getLogicalAttributes() {
+        const props = {
+            pragma: this.pragmaName,
+            statement: expressionToString(this.statementAst)
+        };
+        if (this.value !== undefined) {
+            props.value = this.value;
+        }
+        return props;
+    }
+}
+//# sourceMappingURL=pragma.js.map

package/dist/src/planner/nodes/pragma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pragma.js","sourceRoot":"","sources":["../../../../src/planner/nodes/pragma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,uBAAuB,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAK1B;IACA;IACA;IANC,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC;IAEjD,YACC,KAAU,EACM,UAAkB,EAClB,YAA4B,EAC5B,KAAgB;QAEhC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,kCAAkC;QAJnC,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAgB;QAC5B,UAAK,GAAL,KAAK,CAAW;IAGjC,CAAC;IAED,OAAO;QACN,OAAO;YACN,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACL,SAAS,EAAE,QAAQ;wBACnB,QAAQ,EAAE,WAAW,CAAC,IAAI;wBAC1B,QAAQ,EAAE,KAAK;wBACf,UAAU,EAAE,IAAI;qBAChB;oBACD,SAAS,EAAE,IAAI;iBACf;gBACD;oBACC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE;wBACL,SAAS,EAAE,QAAQ;wBACnB,QAAQ,EAAE,WAAW,CAAC,IAAI;wBAC1B,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,CAAC,CAAC;IACV,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC7C;YACC,EAAE,EAAE,QAAQ,CAAC,UAAU,EAAE;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,4BAA4B;YAC/C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,EAAE;SAE9C,CAAA,CAAC,CAAC;IACJ,CAAC;IAED,WAAW;QACV,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YAAY,CAAC,YAAiC;QAC7C,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACvF,CAAC;IAEQ,QAAQ;QAChB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,UAAU,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IAEQ,oBAAoB;QAC5B,MAAM,KAAK,GAA4B;YACtC,MAAM,EAAE,IAAI,CAAC,UAAU;YACvB,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,YAAmB,CAAC;SACvD,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1B,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

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

@@ -0,0 +1,34 @@
+import { PlanNodeType } from './plan-node-type.js';
+import { PlanNode, type RelationalPlanNode, type UnaryRelationalNode, type ScalarPlanNode, type Attribute } from './plan-node.js';
+import type { RelationType } from '../../common/datatype.js';
+import type { Scope } from '../scopes/scope.js';
+export interface Projection {
+    node: ScalarPlanNode;
+    alias?: string;
+    /** Optional predefined attribute ID to preserve during optimization */
+    attributeId?: number;
+}
+/**
+ * Represents a projection operation (SELECT list) without DISTINCT.
+ * It takes an input relation and outputs a new relation with specified columns/expressions.
+ */
+export declare class ProjectNode extends PlanNode implements UnaryRelationalNode {
+    readonly source: RelationalPlanNode;
+    readonly projections: ReadonlyArray<Projection>;
+    readonly nodeType = PlanNodeType.Project;
+    private outputTypeCache;
+    private attributesCache;
+    constructor(scope: Scope, source: RelationalPlanNode, projections: ReadonlyArray<Projection>, estimatedCostOverride?: number, 
+    /** Optional predefined attributes for preserving IDs during optimization */
+    predefinedAttributes?: Attribute[]);
+    getType(): RelationType;
+    getAttributes(): Attribute[];
+    getProducingExprs(): Map<number, ScalarPlanNode>;
+    getChildren(): readonly PlanNode[];
+    getRelations(): readonly [RelationalPlanNode];
+    get estimatedRows(): number | undefined;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+}
+//# sourceMappingURL=project-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/project-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQhD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAS,YAAW,mBAAmB;aAQtD,MAAM,EAAE,kBAAkB;aAC1B,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC;IARvD,SAAkB,QAAQ,wBAAwB;IAElD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAsB;gBAG5C,KAAK,EAAE,KAAK,EACI,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,EACtD,qBAAqB,CAAC,EAAE,MAAM;IAC9B,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,SAAS,EAAE;IAkGnC,OAAO,IAAI,YAAY;IAIvB,aAAa,IAAI,SAAS,EAAE;IAI5B,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAehD,WAAW,IAAI,SAAS,QAAQ,EAAE;IAIlC,YAAY,IAAI,SAAS,CAAC,kBAAkB,CAAC;IAI7C,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,MAAM;IAOlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASxD,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;CAuCxD"}