rawsql-ts 0.12.0 → 0.13.0

package/dist/parsers/ValuesQueryParser.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValuesQueryParser = void 0;
+const Lexeme_1 = require("../models/Lexeme");
+const SelectQuery_1 = require("../models/SelectQuery");
+const ValueComponent_1 = require("../models/ValueComponent");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+const LexemeCommentUtils_1 = require("./utils/LexemeCommentUtils");
+class ValuesQueryParser {
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
+        const lexemes = tokenizer.readLexmes(); // Get tokens
+        // Parse
+        const result = this.parseFromLexeme(lexemes, 0);
+        // Error if there are remaining tokens
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The VALUES clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error at position ${idx}: Expected 'VALUES' keyword but input ended early.`);
+        }
+        const valuesLexeme = lexemes[idx];
+        if (valuesLexeme.value.toLowerCase() !== 'values') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'VALUES' keyword but found "${valuesLexeme.value}". VALUES clauses must start with the VALUES keyword.`);
+        }
+        const valuesComments = (0, LexemeCommentUtils_1.extractLexemeComments)(valuesLexeme);
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'VALUES' keyword. The VALUES clause requires at least one tuple expression.`);
+        }
+        const tuples = [];
+        const firstTuple = this.parseTuple(lexemes, idx);
+        tuples.push(firstTuple.value);
+        idx = firstTuple.newIndex;
+        if (valuesComments.after.length > 0) {
+            firstTuple.value.addPositionedComments('before', valuesComments.after);
+        }
+        while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Comma)) {
+            idx++;
+            const tuple = this.parseTuple(lexemes, idx);
+            tuples.push(tuple.value);
+            idx = tuple.newIndex;
+        }
+        const query = new SelectQuery_1.ValuesQuery(tuples);
+        if (valuesComments.before.length > 0) {
+            query.headerComments = valuesComments.before;
+        }
+        return { value: query, newIndex: idx };
+    }
+    static parseTuple(lexemes, index) {
+        let idx = index;
+        if (idx >= lexemes.length || lexemes[idx].type !== Lexeme_1.TokenType.OpenParen) {
+            throw new Error(`Syntax error at position ${idx}: Expected opening parenthesis but found "${idx < lexemes.length ? lexemes[idx].value : "end of input"}". Tuple expressions in VALUES clause must be enclosed in parentheses.`);
+        }
+        const openingComments = (0, LexemeCommentUtils_1.extractLexemeComments)(lexemes[idx]);
+        idx++;
+        const values = [];
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after opening parenthesis in tuple expression.`);
+        }
+        if (lexemes[idx].type & Lexeme_1.TokenType.CloseParen) {
+            const tuple = new ValueComponent_1.TupleExpression([]);
+            const closingComments = (0, LexemeCommentUtils_1.extractLexemeComments)(lexemes[idx]);
+            idx++;
+            if (openingComments.before.length > 0) {
+                tuple.addPositionedComments('before', openingComments.before);
+            }
+            if (closingComments.after.length > 0) {
+                tuple.addPositionedComments('after', closingComments.after);
+            }
+            return { value: tuple, newIndex: idx };
+        }
+        const firstValue = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        values.push(firstValue.value);
+        idx = firstValue.newIndex;
+        while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Comma)) {
+            idx++;
+            if (idx >= lexemes.length) {
+                throw new Error(`Syntax error: Unexpected end of input after comma in tuple expression.`);
+            }
+            const value = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+            values.push(value.value);
+            idx = value.newIndex;
+        }
+        if (idx >= lexemes.length || lexemes[idx].type !== Lexeme_1.TokenType.CloseParen) {
+            throw new Error(`Syntax error at position ${idx}: Expected closing parenthesis but found "${idx < lexemes.length ? lexemes[idx].value : "end of input"}". Tuple expressions in VALUES clause must be enclosed in parentheses.`);
+        }
+        const closingComments = (0, LexemeCommentUtils_1.extractLexemeComments)(lexemes[idx]);
+        idx++;
+        const tuple = new ValueComponent_1.TupleExpression(values);
+        if (openingComments.before.length > 0) {
+            tuple.addPositionedComments('before', openingComments.before);
+        }
+        if (openingComments.after.length > 0 && values.length > 0) {
+            values[0].addPositionedComments('before', openingComments.after);
+        }
+        if (closingComments.before.length > 0 && values.length > 0) {
+            values[values.length - 1].addPositionedComments('after', closingComments.before);
+        }
+        if (closingComments.after.length > 0) {
+            tuple.addPositionedComments('after', closingComments.after);
+        }
+        return { value: tuple, newIndex: idx };
+    }
+}
+exports.ValuesQueryParser = ValuesQueryParser;
+//# sourceMappingURL=ValuesQueryParser.js.map

package/dist/parsers/ValuesQueryParser.js.map

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

package/dist/parsers/WhereClauseParser.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhereClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+const CommentUtils_1 = require("../utils/CommentUtils");
+class WhereClauseParser {
+    // Parse SQL string to AST (was: parse)
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
+        const lexemes = tokenizer.readLexmes(); // Get tokens
+        // Parse
+        const result = this.parseFromLexeme(lexemes, 0);
+        // Error if there are remaining tokens
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The WHERE clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        // Capture comments associated with the WHERE clause
+        const whereLexeme = lexemes[idx];
+        const whereTokenComments = CommentUtils_1.CommentUtils.collectClauseComments(lexemes, idx, 'where');
+        // Preserve positioned comments from the WHERE keyword so we can reapply them during printing
+        const wherePositionedComments = whereLexeme.positionedComments;
+        if (whereLexeme.value !== 'where') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'WHERE' keyword but found "${lexemes[idx].value}". WHERE clauses must start with the WHERE keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'WHERE' keyword. The WHERE clause requires a condition expression.`);
+        }
+        const item = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        const clause = new Clause_1.WhereClause(item.value);
+        // Set comments from the WHERE token to the clause
+        clause.comments = whereTokenComments;
+        if (wherePositionedComments && wherePositionedComments.length > 0) {
+            // Clone positioned comments so mutations on the clause do not leak back to the tokenizer state
+            clause.positionedComments = wherePositionedComments.map((comment) => ({
+                position: comment.position,
+                comments: [...comment.comments],
+            }));
+        }
+        return { value: clause, newIndex: item.newIndex };
+    }
+}
+exports.WhereClauseParser = WhereClauseParser;
+//# sourceMappingURL=WhereClauseParser.js.map

package/dist/parsers/WhereClauseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhereClauseParser.js","sourceRoot":"","sources":["../../src/parsers/WhereClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAA+C;AAE/C,iDAA8C;AAC9C,+CAA4C;AAC5C,wDAAqD;AAErD,MAAa,iBAAiB;IAC1B,uCAAuC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,MAAM,SAAS,GAAG,IAAI,2BAAY,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB;QAClE,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,aAAa;QAErD,QAAQ;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEhD,sCAAsC;QACtC,IAAI,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,iBAAiB,MAAM,CAAC,QAAQ,iEAAiE,CAAC,CAAC;QACxL,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,uCAAuC;IAChC,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,oDAAoD;QACpD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,kBAAkB,GAAG,2BAAY,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACrF,6FAA6F;QAC7F,MAAM,uBAAuB,GAAG,WAAW,CAAC,kBAAkB,CAAC;QAE/D,IAAI,WAAW,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,yCAAyC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,qDAAqD,CAAC,CAAC;QACrK,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,gHAAgH,CAAC,CAAC;QACtI,CAAC;QAED,MAAM,IAAI,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,oBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,kDAAkD;QAClD,MAAM,CAAC,QAAQ,GAAG,kBAAkB,CAAC;QAErC,IAAI,uBAAuB,IAAI,uBAAuB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,+FAA+F;YAC/F,MAAM,CAAC,kBAAkB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAClE,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;aAClC,CAAC,CAAC,CAAC;QACR,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;CACJ;AAnDD,8CAmDC"}

package/dist/parsers/WindowClauseParser.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WindowClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const Lexeme_1 = require("../models/Lexeme");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const WindowExpressionParser_1 = require("./WindowExpressionParser");
+class WindowClauseParser {
+    // Parse SQL string to AST (was: parse)
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query);
+        const lexemes = tokenizer.readLexmes();
+        const result = this.parseFromLexeme(lexemes, 0);
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The WINDOW clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (lexemes[idx].value !== 'window') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'WINDOW' keyword but found "${lexemes[idx].value}". WINDOW clauses must start with the WINDOW keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'WINDOW' keyword. The WINDOW clause requires at least one window definition.`);
+        }
+        const windows = [];
+        while (idx < lexemes.length) {
+            if (idx >= lexemes.length || lexemes[idx].type !== Lexeme_1.TokenType.Identifier) {
+                throw new Error(`Syntax error: Expected window name after 'WINDOW' keyword.`);
+            }
+            const name = lexemes[idx].value;
+            idx++;
+            if (idx >= lexemes.length || lexemes[idx].value !== 'as') {
+                throw new Error(`Syntax error at position ${idx}: Expected 'AS' keyword after window name.`);
+            }
+            idx++;
+            const expr = WindowExpressionParser_1.WindowExpressionParser.parseFromLexeme(lexemes, idx);
+            idx = expr.newIndex;
+            windows.push(new Clause_1.WindowFrameClause(name, expr.value));
+            if (idx < lexemes.length && lexemes[idx].type & Lexeme_1.TokenType.Comma) {
+                idx++;
+            }
+            else {
+                break;
+            }
+        }
+        if (windows.length === 0) {
+            throw new Error('At least one WINDOW clause is required after WINDOW keyword.');
+        }
+        return { value: new Clause_1.WindowsClause(windows), newIndex: idx };
+    }
+}
+exports.WindowClauseParser = WindowClauseParser;
+//# sourceMappingURL=WindowClauseParser.js.map

package/dist/parsers/WindowClauseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowClauseParser.js","sourceRoot":"","sources":["../../src/parsers/WindowClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAAoE;AACpE,6CAAqD;AACrD,iDAA8C;AAC9C,qEAAkE;AAElE,MAAa,kBAAkB;IAC3B,uCAAuC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,MAAM,SAAS,GAAG,IAAI,2BAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,iBAAiB,MAAM,CAAC,QAAQ,kEAAkE,CAAC,CAAC;QACzL,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,uCAAuC;IAChC,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,0CAA0C,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,uDAAuD,CAAC,CAAC;QACxK,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,0HAA0H,CAAC,CAAC;QAChJ,CAAC;QAED,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAE1B,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,kBAAS,CAAC,UAAU,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAChC,GAAG,EAAE,CAAC;YACN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,4CAA4C,CAAC,CAAC;YACjG,CAAC;YACD,GAAG,EAAE,CAAC;YACN,MAAM,IAAI,GAAG,+CAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAClE,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,IAAI,0BAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtD,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,kBAAS,CAAC,KAAK,EAAE,CAAC;gBAC9D,GAAG,EAAE,CAAC;YACV,CAAC;iBAAM,CAAC;gBACJ,MAAM;YACV,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,sBAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChE,CAAC;CACJ;AArDD,gDAqDC"}

package/dist/parsers/WindowExpressionParser.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WindowExpressionParser = void 0;
+const Lexeme_1 = require("../models/Lexeme");
+const ValueComponent_1 = require("../models/ValueComponent");
+const OrderByClauseParser_1 = require("./OrderByClauseParser");
+const PartitionByParser_1 = require("./PartitionByParser");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+class WindowExpressionParser {
+    // Parse SQL string to AST (was: parse)
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
+        const lexemes = tokenizer.readLexmes(); // Get tokens
+        // Parse
+        const result = this.parseFromLexeme(lexemes, 0);
+        // Error if there are remaining tokens
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The window frame expression is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (lexemes[idx].type !== Lexeme_1.TokenType.OpenParen) {
+            throw new Error(`Syntax error at position ${idx}: Expected opening parenthesis '(' but found "${lexemes[idx].value}".`);
+        }
+        idx++;
+        let partition = null;
+        let order = null;
+        let frameSpec = null;
+        if (idx < lexemes.length && lexemes[idx].value === 'partition by') {
+            const partitionResult = PartitionByParser_1.PartitionByParser.parseFromLexeme(lexemes, idx);
+            partition = partitionResult.value;
+            idx = partitionResult.newIndex;
+        }
+        if (idx < lexemes.length && lexemes[idx].value === 'order by') {
+            const orderResult = OrderByClauseParser_1.OrderByClauseParser.parseFromLexeme(lexemes, idx);
+            order = orderResult.value;
+            idx = orderResult.newIndex;
+        }
+        // Parse frame clause (ROWS/RANGE/GROUPS)
+        if (idx < lexemes.length && this.isFrameTypeKeyword(lexemes[idx].value)) {
+            const frameSpecResult = this.parseFrameSpec(lexemes, idx);
+            frameSpec = frameSpecResult.value;
+            idx = frameSpecResult.newIndex;
+        }
+        if (idx >= lexemes.length || lexemes[idx].type !== Lexeme_1.TokenType.CloseParen) {
+            throw new Error(`Syntax error at position ${idx}: Missing closing parenthesis ')' for window frame. Each opening parenthesis must have a matching closing parenthesis.`);
+        }
+        // Read close paren
+        idx++;
+        return { value: new ValueComponent_1.WindowFrameExpression(partition, order, frameSpec), newIndex: idx };
+    }
+    static isFrameTypeKeyword(value) {
+        const lowerValue = value;
+        return lowerValue === 'rows' || lowerValue === 'range' || lowerValue === 'groups';
+    }
+    static parseFrameSpec(lexemes, index) {
+        let idx = index;
+        // Determine frame type (ROWS/RANGE/GROUPS)
+        const frameTypeStr = lexemes[idx].value;
+        let frameType;
+        switch (frameTypeStr) {
+            case 'rows':
+                frameType = ValueComponent_1.WindowFrameType.Rows;
+                break;
+            case 'range':
+                frameType = ValueComponent_1.WindowFrameType.Range;
+                break;
+            case 'groups':
+                frameType = ValueComponent_1.WindowFrameType.Groups;
+                break;
+            default:
+                throw new Error(`Syntax error at position ${idx}: Invalid frame type "${lexemes[idx].value}". Expected one of: ROWS, RANGE, GROUPS.`);
+        }
+        idx++;
+        // Check for BETWEEN ... AND ... syntax
+        if (idx < lexemes.length && lexemes[idx].value === 'between') {
+            // BETWEEN ... AND ... syntax
+            idx++;
+            // Parse start boundary
+            const startBoundResult = this.parseFrameBoundary(lexemes, idx);
+            const startBound = startBoundResult.value;
+            idx = startBoundResult.newIndex;
+            // Check for AND keyword - may be recognized as a separate token or part of a compound token
+            if (idx >= lexemes.length || (lexemes[idx].value !== 'and')) {
+                throw new Error(`Syntax error at position ${idx}: Expected 'AND' keyword in BETWEEN clause.`);
+            }
+            idx++; // Skip AND
+            // Parse end boundary
+            const endBoundResult = this.parseFrameBoundary(lexemes, idx);
+            const endBound = endBoundResult.value;
+            idx = endBoundResult.newIndex;
+            return {
+                value: new ValueComponent_1.WindowFrameSpec(frameType, startBound, endBound),
+                newIndex: idx
+            };
+        }
+        else {
+            // Single boundary specification
+            const boundaryResult = this.parseFrameBoundary(lexemes, idx);
+            const startBound = boundaryResult.value;
+            idx = boundaryResult.newIndex;
+            return {
+                value: new ValueComponent_1.WindowFrameSpec(frameType, startBound, null),
+                newIndex: idx
+            };
+        }
+    }
+    static parseFrameBoundary(lexemes, index) {
+        let idx = index;
+        // Check for predefined boundaries
+        if (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Command)) {
+            const currentValue = lexemes[idx].value;
+            let frameBound;
+            switch (currentValue) {
+                case 'current row':
+                    frameBound = ValueComponent_1.WindowFrameBound.CurrentRow;
+                    break;
+                case 'unbounded preceding':
+                    frameBound = ValueComponent_1.WindowFrameBound.UnboundedPreceding;
+                    break;
+                case 'unbounded following':
+                    frameBound = ValueComponent_1.WindowFrameBound.UnboundedFollowing;
+                    break;
+                default:
+                    throw new Error(`Syntax error at position ${idx}: Invalid frame type "${lexemes[idx].value}". Expected one of: ROWS, RANGE, GROUPS.`);
+            }
+            const bound = new ValueComponent_1.WindowFrameBoundStatic(frameBound);
+            return { value: bound, newIndex: idx + 1 };
+        }
+        else if (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Literal)) {
+            // Parse the numeric/literal value
+            const valueResult = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+            idx = valueResult.newIndex;
+            // Next token must be 'preceding' or 'following'
+            if (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Command)) {
+                const direction = lexemes[idx].value;
+                let isFollowing;
+                if (direction === 'preceding') {
+                    isFollowing = false;
+                }
+                else if (direction === 'following') {
+                    isFollowing = true;
+                }
+                else {
+                    throw new Error(`Syntax error at position ${idx}: Expected 'preceding' or 'following' after numeric value in window frame boundary.`);
+                }
+                idx++;
+                const bound = new ValueComponent_1.WindowFrameBoundaryValue(valueResult.value, isFollowing);
+                return { value: bound, newIndex: idx };
+            }
+            else {
+                throw new Error(`Syntax error at position ${idx}: Expected 'preceding' or 'following' after numeric value in window frame boundary.`);
+            }
+        }
+        throw new Error(`Syntax error at position ${idx}: Expected a valid frame boundary component.`);
+    }
+}
+exports.WindowExpressionParser = WindowExpressionParser;
+//# sourceMappingURL=WindowExpressionParser.js.map

package/dist/parsers/WindowExpressionParser.js.map

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

package/dist/parsers/WithClauseParser.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WithClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const Lexeme_1 = require("../models/Lexeme");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const CommonTableParser_1 = require("./CommonTableParser");
+/**
+ * Parser for SQL WITH clauses (Common Table Expressions - CTEs).
+ * Parses only the WITH clause portion of SQL, not the entire query.
+ *
+ * **Note**: For most use cases, use `SelectQueryParser` which provides more comprehensive SQL parsing.
+ * This parser should only be used for the special case where you need to analyze only the WITH clause portion.
+ *
+ * @example
+ * ```typescript
+ * // Parses only the WITH clause, not the following SELECT
+ * const sql = "WITH recursive_cte AS (SELECT 1 as n UNION SELECT n+1 FROM recursive_cte WHERE n < 10)";
+ * const withClause = WithClauseParser.parse(sql);
+ * console.log(withClause.recursive); // true
+ * console.log(withClause.tables.length); // 1
+ * ```
+ */
+class WithClauseParser {
+    /**
+     * Parses a SQL string containing only a WITH clause into a WithClause AST.
+     * The input should contain only the WITH clause, not the subsequent main query.
+     *
+     * @param query - The SQL string containing only the WITH clause
+     * @returns The parsed WithClause object
+     * @throws Error if the syntax is invalid or there are unexpected tokens after the WITH clause
+     *
+     * @example
+     * ```typescript
+     * // Correct: Only the WITH clause
+     * const sql = "WITH users_data AS (SELECT id, name FROM users)";
+     * const withClause = WithClauseParser.parse(sql);
+     *
+     * // Error: Contains SELECT after WITH clause
+     * // const badSql = "WITH users_data AS (SELECT id, name FROM users) SELECT * FROM users_data";
+     * ```
+     */
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
+        const lexemes = tokenizer.readLexmes(); // Get tokens
+        // Parse
+        const result = this.parseFromLexeme(lexemes, 0);
+        // Error if there are remaining tokens
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The WITH clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    /**
+     * Parses a WITH clause from an array of lexemes starting at the specified index.
+     *
+     * @param lexemes - Array of lexemes to parse from
+     * @param index - Starting index in the lexemes array
+     * @returns Object containing the parsed WithClause and the new index position
+     * @throws Error if the syntax is invalid or WITH keyword is not found
+     *
+     * @example
+     * ```typescript
+     * const tokenizer = new SqlTokenizer("WITH cte AS (SELECT 1)");
+     * const lexemes = tokenizer.readLexmes();
+     * const result = WithClauseParser.parseFromLexeme(lexemes, 0);
+     * console.log(result.value.tables.length); // 1
+     * console.log(result.newIndex); // position after the WITH clause
+     * ```
+     */
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        // Extract header comments from WITH token
+        const headerComments = this.extractWithTokenHeaderComments(lexemes, idx);
+        // Parse WITH keyword
+        idx = this.parseWithKeyword(lexemes, idx);
+        // Parse optional RECURSIVE keyword
+        const { recursive, newIndex: recursiveIndex } = this.parseRecursiveFlag(lexemes, idx);
+        idx = recursiveIndex;
+        // Parse all CTEs
+        const { tables, trailingComments, newIndex: ctesIndex } = this.parseAllCommonTables(lexemes, idx);
+        idx = ctesIndex;
+        // Create WITH clause and apply trailing comments directly
+        const withClause = new Clause_1.WithClause(recursive, tables);
+        if (trailingComments.length > 0) {
+            withClause.trailingComments = trailingComments;
+        }
+        return {
+            value: withClause,
+            newIndex: idx,
+            headerComments: headerComments
+        };
+    }
+    // Extract header comments from WITH token
+    static extractWithTokenHeaderComments(lexemes, index) {
+        if (index >= lexemes.length)
+            return null;
+        const withToken = lexemes[index];
+        let headerComments = null;
+        // Extract positioned comments: only "before" comments are header comments
+        if (withToken.positionedComments && withToken.positionedComments.length > 0) {
+            for (const posComment of withToken.positionedComments) {
+                if (posComment.position === 'before' && posComment.comments) {
+                    if (!headerComments)
+                        headerComments = [];
+                    headerComments.push(...posComment.comments);
+                }
+            }
+        }
+        // Fallback to legacy comments if no positioned comments (for backward compatibility)
+        if (!headerComments && withToken.comments && withToken.comments.length > 0) {
+            headerComments = [...withToken.comments];
+        }
+        return headerComments;
+    }
+    // Parse WITH keyword
+    static parseWithKeyword(lexemes, index) {
+        if (index < lexemes.length && lexemes[index].value.toLowerCase() === "with") {
+            return index + 1;
+        }
+        else {
+            throw new Error(`Syntax error at position ${index}: Expected WITH keyword.`);
+        }
+    }
+    // Parse optional RECURSIVE keyword
+    static parseRecursiveFlag(lexemes, index) {
+        const recursive = index < lexemes.length && lexemes[index].value.toLowerCase() === "recursive";
+        return {
+            recursive,
+            newIndex: recursive ? index + 1 : index
+        };
+    }
+    // Parse all common table expressions
+    static parseAllCommonTables(lexemes, index) {
+        let idx = index;
+        const tables = [];
+        const allTrailingComments = [];
+        // Parse first CTE (required)
+        const firstCte = CommonTableParser_1.CommonTableParser.parseFromLexeme(lexemes, idx);
+        tables.push(firstCte.value);
+        idx = firstCte.newIndex;
+        // Collect trailing comments from first CTE directly
+        if (firstCte.trailingComments) {
+            allTrailingComments.push(...firstCte.trailingComments);
+        }
+        // Parse additional CTEs (optional)
+        while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Comma)) {
+            idx++; // Skip comma
+            const cteResult = CommonTableParser_1.CommonTableParser.parseFromLexeme(lexemes, idx);
+            tables.push(cteResult.value);
+            idx = cteResult.newIndex;
+            // Collect trailing comments from this CTE directly
+            if (cteResult.trailingComments) {
+                allTrailingComments.push(...cteResult.trailingComments);
+            }
+        }
+        return {
+            tables,
+            trailingComments: allTrailingComments,
+            newIndex: idx
+        };
+    }
+}
+exports.WithClauseParser = WithClauseParser;
+//# sourceMappingURL=WithClauseParser.js.map

package/dist/parsers/WithClauseParser.js.map

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

package/dist/parsers/utils/LexemeCommentUtils.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractLexemeComments = extractLexemeComments;
+// Extracts positioned comments from a lexeme while preserving order and duplicates.
+function extractLexemeComments(lexeme) {
+    const before = [];
+    const after = [];
+    if (!lexeme) {
+        return { before, after };
+    }
+    if (lexeme.positionedComments && lexeme.positionedComments.length > 0) {
+        for (const positioned of lexeme.positionedComments) {
+            if (!positioned.comments || positioned.comments.length === 0) {
+                continue;
+            }
+            if (positioned.position === "before") {
+                before.push(...positioned.comments);
+            }
+            else if (positioned.position === "after") {
+                after.push(...positioned.comments);
+            }
+        }
+    }
+    else if (lexeme.comments && lexeme.comments.length > 0) {
+        before.push(...lexeme.comments);
+    }
+    return { before, after };
+}
+//# sourceMappingURL=LexemeCommentUtils.js.map

package/dist/parsers/utils/LexemeCommentUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LexemeCommentUtils.js","sourceRoot":"","sources":["../../../src/parsers/utils/LexemeCommentUtils.ts"],"names":[],"mappings":";;AAQA,sDAyBC;AA1BD,oFAAoF;AACpF,SAAgB,qBAAqB,CAAC,MAA0B;IAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,SAAS;YACb,CAAC;YAED,IAAI,UAAU,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;QACL,CAAC;IACL,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}