rawsql-ts 0.11.32-beta → 0.11.34-beta

package/dist/esm/src/utils/IntelliSenseApi.js

@@ -0,0 +1,284 @@
+import { CursorContextAnalyzer } from './CursorContextAnalyzer';
+import { ScopeResolver } from './ScopeResolver';
+import { PositionAwareParser } from './PositionAwareParser';
+import { MultiQuerySplitter } from './MultiQuerySplitter';
+import { TextPositionUtils } from './TextPositionUtils';
+/**
+ * Convenience API for SQL IntelliSense integration
+ *
+ * Provides simplified, high-level functions that combine the functionality
+ * of the various position-aware parsing components for easy integration
+ * with Monaco Editor and other code editors.
+ *
+ * @example
+ * ```typescript
+ * import { parseToPosition, getCursorContext, resolveScope, splitQueries } from 'rawsql-ts';
+ *
+ * // Parse incomplete SQL with error recovery
+ * const sql = "SELECT u.name FROM users u WHERE u.";
+ * const parseResult = parseToPosition(sql, sql.length, { errorRecovery: true });
+ *
+ * // Get cursor context for completion suggestions
+ * const context = getCursorContext(sql, sql.length);
+ * console.log(context.isAfterDot); // true
+ * console.log(context.precedingIdentifier); // "u"
+ *
+ * // Get scope information for table/column completion
+ * const scope = resolveScope(sql, sql.length);
+ * console.log(scope.availableTables); // [{ name: 'users', alias: 'u' }]
+ *
+ * // Handle multi-query editor
+ * const multiSQL = "SELECT 1; SELECT 2;";
+ * const queries = splitQueries(multiSQL);
+ * const activeQuery = queries.getActive(12); // Get query at position
+ * ```
+ */
+/**
+ * Parse SQL up to cursor position with error recovery
+ *
+ * Combines position-aware parsing with error recovery to handle incomplete SQL
+ * that users are actively typing. Ideal for providing IntelliSense in editors.
+ *
+ * @param sql - SQL text to parse
+ * @param cursorPosition - Cursor position (character offset or line/column)
+ * @param options - Parsing options including error recovery settings
+ * @returns Parse result with position-specific information
+ */
+export function parseToPosition(sql, cursorPosition, options = {}) {
+    return PositionAwareParser.parseToPosition(sql, cursorPosition, options);
+}
+/**
+ * Analyze cursor context for IntelliSense completion suggestions
+ *
+ * Determines what type of completions should be offered at the cursor position
+ * based on SQL syntax context (SELECT clause, WHERE condition, etc.).
+ *
+ * @param sql - SQL text to analyze
+ * @param cursorPosition - Cursor position (character offset or line/column)
+ * @returns Cursor context information for completion logic
+ */
+export function getCursorContext(sql, cursorPosition) {
+    if (typeof cursorPosition === 'number') {
+        return CursorContextAnalyzer.analyzeIntelliSense(sql, cursorPosition);
+    }
+    else {
+        return CursorContextAnalyzer.analyzeIntelliSenseAt(sql, cursorPosition);
+    }
+}
+/**
+ * Resolve scope information at cursor position
+ *
+ * Provides comprehensive information about available tables, CTEs, and columns
+ * at the specified cursor position for intelligent completion suggestions.
+ *
+ * @param sql - SQL text to analyze
+ * @param cursorPosition - Cursor position (character offset or line/column)
+ * @returns Complete scope information including available tables and columns
+ */
+export function resolveScope(sql, cursorPosition) {
+    if (typeof cursorPosition === 'number') {
+        return ScopeResolver.resolve(sql, cursorPosition);
+    }
+    else {
+        return ScopeResolver.resolveAt(sql, cursorPosition);
+    }
+}
+/**
+ * Split multi-query SQL text into individual queries
+ *
+ * Handles SQL editors that contain multiple statements separated by semicolons.
+ * Properly handles string literals and comments containing semicolons.
+ *
+ * @param sql - Multi-query SQL text
+ * @returns Collection of individual queries with position information
+ */
+export function splitQueries(sql) {
+    return MultiQuerySplitter.split(sql);
+}
+/**
+ * Get IntelliSense information for a cursor position in multi-query context
+ *
+ * Combines query splitting, context analysis, and scope resolution to provide
+ * complete IntelliSense information for a cursor position in multi-query SQL.
+ *
+ * @param sql - Multi-query SQL text
+ * @param cursorPosition - Cursor position
+ * @param options - Parsing options
+ * @returns Complete IntelliSense information or undefined if position is invalid
+ */
+export function getIntelliSenseInfo(sql, cursorPosition, options = {}) {
+    const charPos = typeof cursorPosition === 'number'
+        ? cursorPosition
+        : TextPositionUtils.lineColumnToCharOffset(sql, cursorPosition);
+    if (charPos === -1) {
+        return undefined;
+    }
+    // Split queries and find the active one
+    const queries = splitQueries(sql);
+    const activeQuery = queries.getActive(charPos);
+    if (!activeQuery) {
+        return undefined;
+    }
+    // Calculate relative position within the active query
+    const relativePosition = charPos - activeQuery.start;
+    const querySQL = activeQuery.sql;
+    // Get IntelliSense information for the active query
+    const context = getCursorContext(querySQL, relativePosition);
+    const scope = resolveScope(querySQL, relativePosition);
+    const parseResult = parseToPosition(querySQL, relativePosition, options);
+    return {
+        context,
+        scope,
+        parseResult,
+        currentQuery: querySQL,
+        relativePosition
+    };
+}
+/**
+ * Get completion suggestions based on cursor context and scope
+ *
+ * Uses the new IntelliSense interface to provide targeted completion suggestions.
+ * This function leverages the suggestion-based design to efficiently determine
+ * what completions should be offered.
+ *
+ * @param sql - SQL text
+ * @param cursorPosition - Cursor position
+ * @returns Array of completion suggestions with context information
+ */
+export function getCompletionSuggestions(sql, cursorPosition) {
+    const charPos = typeof cursorPosition === 'number'
+        ? cursorPosition
+        : TextPositionUtils.lineColumnToCharOffset(sql, cursorPosition);
+    if (charPos === -1) {
+        return [];
+    }
+    const intelliSenseContext = CursorContextAnalyzer.analyzeIntelliSense(sql, charPos);
+    const scope = resolveScope(sql, cursorPosition);
+    const suggestions = [];
+    // Add keyword suggestions
+    if (intelliSenseContext.suggestKeywords) {
+        // Add required keywords if specified
+        if (intelliSenseContext.requiredKeywords) {
+            intelliSenseContext.requiredKeywords.forEach(keyword => {
+                suggestions.push({
+                    type: 'keyword',
+                    value: keyword,
+                    detail: `Required keyword: ${keyword}`
+                });
+            });
+        }
+        else {
+            // Add general contextual keywords based on token context
+            const generalKeywords = getGeneralKeywords(intelliSenseContext);
+            generalKeywords.forEach(keyword => {
+                suggestions.push({
+                    type: 'keyword',
+                    value: keyword.value,
+                    detail: keyword.detail
+                });
+            });
+        }
+    }
+    // Add table suggestions
+    if (intelliSenseContext.suggestTables) {
+        scope.availableTables.forEach(table => {
+            suggestions.push({
+                type: 'table',
+                value: table.alias || table.name,
+                detail: `Table: ${table.fullName}`,
+                documentation: `Available table${table.alias ? ` (alias: ${table.alias})` : ''}`
+            });
+        });
+        // Add CTE suggestions
+        scope.availableCTEs.forEach(cte => {
+            suggestions.push({
+                type: 'cte',
+                value: cte.name,
+                detail: `CTE: ${cte.name}`,
+                documentation: `Common Table Expression${cte.columns ? ` with columns: ${cte.columns.join(', ')}` : ''}`
+            });
+        });
+    }
+    // Add column suggestions
+    if (intelliSenseContext.suggestColumns) {
+        if (intelliSenseContext.tableScope) {
+            // Specific table/alias column completion
+            const columns = scope.visibleColumns.filter(col => col.tableName === intelliSenseContext.tableScope ||
+                col.tableAlias === intelliSenseContext.tableScope);
+            columns.forEach(col => {
+                suggestions.push({
+                    type: 'column',
+                    value: col.name,
+                    detail: `Column: ${col.fullReference}`,
+                    documentation: `Column from ${col.tableName}${col.type ? ` (${col.type})` : ''}`
+                });
+            });
+        }
+        else {
+            // General column completion
+            scope.visibleColumns.forEach(col => {
+                suggestions.push({
+                    type: 'column',
+                    value: col.name === '*' ? '*' : `${col.tableAlias || col.tableName}.${col.name}`,
+                    detail: `Column: ${col.fullReference}`,
+                    documentation: `Column from ${col.tableName}`
+                });
+            });
+        }
+    }
+    return suggestions;
+}
+/**
+ * Get general keyword suggestions based on IntelliSense context
+ */
+function getGeneralKeywords(context) {
+    var _a, _b, _c, _d;
+    // Determine context from token information
+    const prevToken = (_b = (_a = context.previousToken) === null || _a === void 0 ? void 0 : _a.value) === null || _b === void 0 ? void 0 : _b.toLowerCase();
+    const currentToken = (_d = (_c = context.currentToken) === null || _c === void 0 ? void 0 : _c.value) === null || _d === void 0 ? void 0 : _d.toLowerCase();
+    // SELECT context - aggregate functions and keywords
+    if (prevToken === "select" || currentToken === "select") {
+        return [
+            { value: "DISTINCT", detail: "Remove duplicate rows" },
+            { value: "COUNT", detail: "Aggregate function" },
+            { value: "SUM", detail: "Aggregate function" },
+            { value: "AVG", detail: "Aggregate function" },
+            { value: "MAX", detail: "Aggregate function" },
+            { value: "MIN", detail: "Aggregate function" }
+        ];
+    }
+    // FROM context - JOIN options and clauses
+    if (prevToken === "from" || currentToken === "from") {
+        return [
+            { value: "JOIN", detail: "Inner join tables" },
+            { value: "LEFT JOIN", detail: "Left outer join" },
+            { value: "RIGHT JOIN", detail: "Right outer join" },
+            { value: "FULL JOIN", detail: "Full outer join" },
+            { value: "WHERE", detail: "Filter conditions" },
+            { value: "GROUP BY", detail: "Group results" },
+            { value: "ORDER BY", detail: "Sort results" }
+        ];
+    }
+    // WHERE/HAVING context - logical operators
+    if (["where", "having", "on"].includes(prevToken || "") || ["where", "having", "on"].includes(currentToken || "")) {
+        return [
+            { value: "AND", detail: "Logical AND operator" },
+            { value: "OR", detail: "Logical OR operator" },
+            { value: "NOT", detail: "Logical NOT operator" },
+            { value: "IN", detail: "Match any value in list" },
+            { value: "LIKE", detail: "Pattern matching" },
+            { value: "BETWEEN", detail: "Range comparison" }
+        ];
+    }
+    // Default context - general SQL keywords
+    return [
+        { value: "SELECT", detail: "Query data" },
+        { value: "FROM", detail: "Specify table" },
+        { value: "WHERE", detail: "Filter conditions" },
+        { value: "JOIN", detail: "Join tables" },
+        { value: "GROUP BY", detail: "Group results" },
+        { value: "ORDER BY", detail: "Sort results" },
+        { value: "LIMIT", detail: "Limit results" }
+    ];
+}
+//# sourceMappingURL=IntelliSenseApi.js.map

package/dist/esm/src/utils/IntelliSenseApi.js.map

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

package/dist/esm/src/utils/KeywordCache.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Utility for caching keyword relationships for fast access
+ * Dynamically builds keyword relationships from existing joinkeywordParser
+ *
+ * SOURCE DICTIONARIES (single source of truth):
+ * - JOIN patterns: /src/tokenReaders/CommandTokenReader.ts (joinTrie, lines 10-29)
+ * - Command patterns: /src/tokenReaders/CommandTokenReader.ts (keywordTrie, lines 30-118)
+ *
+ * MIGRATION NOTE:
+ * If keywords are added/modified in CommandTokenReader.ts, update the
+ * extractCommandPatternsFromTrie() method to reflect those changes.
+ * JOIN patterns are automatically extracted via joinkeywordParser.
+ */
+export declare class KeywordCache {
+    private static joinSuggestionCache;
+    private static commandSuggestionCache;
+    private static initialized;
+    /**
+     * Initialize JOIN-related keyword suggestions
+     * Dynamically generated based on information extracted from joinkeywordParser
+     */
+    private static initialize;
+    /**
+     * Get next suggestions for the specified keyword
+     * Example: "left" → ["join", "outer", "outer join"]
+     */
+    static getJoinSuggestions(keyword: string): string[];
+    /**
+     * Check if a keyword is a valid JOIN keyword
+     * Uses existing joinkeywordParser as the primary resource
+     */
+    static isValidJoinKeyword(keyword: string): boolean;
+    /**
+     * Generate suggestions based on partial keyword input
+     * Example: "le" → find keywords starting with "left"
+     */
+    static getPartialSuggestions(partialKeyword: string): string[];
+    /**
+     * Get all JOIN keywords
+     */
+    static getAllJoinKeywords(): string[];
+    /**
+     * Initialize command keyword patterns
+     * Dynamically extracted from commandKeywordTrie
+     */
+    private static initializeCommandKeywords;
+    /**
+     * Extract multi-word patterns from commandKeywordTrie
+     * Uses known patterns since direct extraction from trie structure is difficult
+     *
+     * SOURCE: /src/tokenReaders/CommandTokenReader.ts keywordTrie (lines 30-118)
+     * MIGRATION: When updating, copy multi-word patterns from the source trie
+     */
+    private static extractCommandPatternsFromTrie;
+    /**
+     * Get next command suggestions for the specified keyword
+     * Example: "group" → ["by"]
+     */
+    static getCommandSuggestions(keyword: string): string[];
+    /**
+     * Force cache re-initialization
+     * Used for testing or when keyword definitions have changed
+     */
+    static reset(): void;
+}

package/dist/esm/src/utils/KeywordCache.js

@@ -0,0 +1,202 @@
+import { joinkeywordParser } from "../tokenReaders/CommandTokenReader";
+/**
+ * Utility for caching keyword relationships for fast access
+ * Dynamically builds keyword relationships from existing joinkeywordParser
+ *
+ * SOURCE DICTIONARIES (single source of truth):
+ * - JOIN patterns: /src/tokenReaders/CommandTokenReader.ts (joinTrie, lines 10-29)
+ * - Command patterns: /src/tokenReaders/CommandTokenReader.ts (keywordTrie, lines 30-118)
+ *
+ * MIGRATION NOTE:
+ * If keywords are added/modified in CommandTokenReader.ts, update the
+ * extractCommandPatternsFromTrie() method to reflect those changes.
+ * JOIN patterns are automatically extracted via joinkeywordParser.
+ */
+export class KeywordCache {
+    /**
+     * Initialize JOIN-related keyword suggestions
+     * Dynamically generated based on information extracted from joinkeywordParser
+     */
+    static initialize() {
+        if (this.initialized)
+            return;
+        // SOURCE: /src/tokenReaders/CommandTokenReader.ts joinTrie (lines 10-33)
+        // Dynamically build keyword relationships from joinTrie
+        const joinPatterns = [
+            ["join"],
+            ["inner", "join"],
+            ["cross", "join"],
+            ["left", "join"],
+            ["left", "outer", "join"],
+            ["right", "join"],
+            ["right", "outer", "join"],
+            ["full", "join"],
+            ["full", "outer", "join"],
+            ["natural", "join"],
+            ["natural", "inner", "join"],
+            ["natural", "left", "join"],
+            ["natural", "left", "outer", "join"],
+            ["natural", "right", "join"],
+            ["natural", "right", "outer", "join"],
+            ["natural", "full", "join"],
+            ["natural", "full", "outer", "join"],
+            // LATERAL JOIN patterns
+            ["lateral", "join"],
+            ["lateral", "inner", "join"],
+            ["lateral", "left", "join"],
+            ["lateral", "left", "outer", "join"],
+        ];
+        // Build keyword suggestion relationships
+        const suggestionMap = new Map();
+        // Build complete phrase suggestions for better UX
+        const completePhrases = new Set();
+        joinPatterns.forEach(pattern => {
+            if (pattern.length > 1) {
+                completePhrases.add(pattern.slice(1).join(' ').toUpperCase());
+            }
+        });
+        // For each prefix, find all possible complete continuations
+        joinPatterns.forEach(pattern => {
+            for (let i = 0; i < pattern.length - 1; i++) {
+                const prefix = pattern[i];
+                if (!suggestionMap.has(prefix)) {
+                    suggestionMap.set(prefix, new Set());
+                }
+                // Find all patterns that start with this prefix and add complete phrases
+                joinPatterns.forEach(candidatePattern => {
+                    if (candidatePattern.length > i + 1 && candidatePattern[i] === prefix) {
+                        const completePhrase = candidatePattern.slice(i + 1).join(' ').toUpperCase();
+                        suggestionMap.get(prefix).add(completePhrase);
+                    }
+                });
+            }
+        });
+        // Convert Set to array and save to cache
+        suggestionMap.forEach((suggestions, keyword) => {
+            this.joinSuggestionCache.set(keyword.toLowerCase(), Array.from(suggestions));
+        });
+        // Also process command keywords
+        this.initializeCommandKeywords();
+        this.initialized = true;
+    }
+    /**
+     * Get next suggestions for the specified keyword
+     * Example: "left" → ["join", "outer", "outer join"]
+     */
+    static getJoinSuggestions(keyword) {
+        this.initialize();
+        return this.joinSuggestionCache.get(keyword.toLowerCase()) || [];
+    }
+    /**
+     * Check if a keyword is a valid JOIN keyword
+     * Uses existing joinkeywordParser as the primary resource
+     */
+    static isValidJoinKeyword(keyword) {
+        const result = joinkeywordParser.parse(keyword, 0);
+        return result !== null;
+    }
+    /**
+     * Generate suggestions based on partial keyword input
+     * Example: "le" → find keywords starting with "left"
+     */
+    static getPartialSuggestions(partialKeyword) {
+        this.initialize();
+        const partial = partialKeyword.toLowerCase();
+        const suggestions = [];
+        this.joinSuggestionCache.forEach((values, key) => {
+            if (key.startsWith(partial)) {
+                suggestions.push(key);
+                // Include next suggestions for that keyword as well
+                values.forEach(value => {
+                    if (!suggestions.includes(value)) {
+                        suggestions.push(value);
+                    }
+                });
+            }
+        });
+        return suggestions;
+    }
+    /**
+     * Get all JOIN keywords
+     */
+    static getAllJoinKeywords() {
+        this.initialize();
+        const allKeywords = new Set();
+        this.joinSuggestionCache.forEach((values, key) => {
+            allKeywords.add(key);
+            values.forEach(value => allKeywords.add(value));
+        });
+        return Array.from(allKeywords);
+    }
+    /**
+     * Initialize command keyword patterns
+     * Dynamically extracted from commandKeywordTrie
+     */
+    static initializeCommandKeywords() {
+        // Extract multi-word patterns from commandKeywordTrie
+        const commandPatterns = this.extractCommandPatternsFromTrie();
+        const suggestionMap = new Map();
+        commandPatterns.forEach(pattern => {
+            for (let i = 0; i < pattern.length - 1; i++) {
+                const prefix = pattern[i];
+                const nextWord = pattern[i + 1];
+                if (!suggestionMap.has(prefix)) {
+                    suggestionMap.set(prefix, new Set());
+                }
+                suggestionMap.get(prefix).add(nextWord);
+            }
+        });
+        // Convert Set to array and save to cache
+        suggestionMap.forEach((suggestions, keyword) => {
+            this.commandSuggestionCache.set(keyword.toLowerCase(), Array.from(suggestions));
+        });
+    }
+    /**
+     * Extract multi-word patterns from commandKeywordTrie
+     * Uses known patterns since direct extraction from trie structure is difficult
+     *
+     * SOURCE: /src/tokenReaders/CommandTokenReader.ts keywordTrie (lines 30-118)
+     * MIGRATION: When updating, copy multi-word patterns from the source trie
+     */
+    static extractCommandPatternsFromTrie() {
+        // These are patterns defined in CommandTokenReader's keywordTrie
+        return [
+            ["group", "by"],
+            ["order", "by"],
+            ["distinct", "on"],
+            ["not", "materialized"],
+            ["row", "only"],
+            ["rows", "only"],
+            ["percent", "with", "ties"],
+            ["key", "share"],
+            ["no", "key", "update"],
+            ["union", "all"],
+            ["intersect", "all"],
+            ["except", "all"],
+            ["partition", "by"],
+            ["within", "group"],
+            ["with", "ordinality"]
+        ];
+    }
+    /**
+     * Get next command suggestions for the specified keyword
+     * Example: "group" → ["by"]
+     */
+    static getCommandSuggestions(keyword) {
+        this.initialize();
+        return this.commandSuggestionCache.get(keyword.toLowerCase()) || [];
+    }
+    /**
+     * Force cache re-initialization
+     * Used for testing or when keyword definitions have changed
+     */
+    static reset() {
+        this.joinSuggestionCache.clear();
+        this.commandSuggestionCache.clear();
+        this.initialized = false;
+    }
+}
+KeywordCache.joinSuggestionCache = new Map();
+KeywordCache.commandSuggestionCache = new Map();
+KeywordCache.initialized = false;
+//# sourceMappingURL=KeywordCache.js.map

package/dist/esm/src/utils/KeywordCache.js.map

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

package/dist/esm/src/utils/LexemeCursor.d.ts

@@ -1,4 +1,11 @@
 import { Lexeme } from '../models/Lexeme';
+/**
+ * Line and column position (1-based indexing for editor integration)
+ */
+export interface LineColumn {
+    line: number;
+    column: number;
+}
 /**
  * Utility class for cursor-to-lexeme mapping in SQL text.
  *
@@ -14,6 +21,24 @@ import { Lexeme } from '../models/Lexeme';
  */
 export declare class LexemeCursor {
     private static readonly SQL_COMMANDS;
+    /**
+     * Find the lexeme at the specified line and column position.
+     *
+     * Designed for GUI editor integration where users select alias text.
+     * Uses 1-based line and column indexing to match editor conventions.
+     *
+     * @param sql - The SQL string to analyze
+     * @param position - Line and column position (1-based)
+     * @returns The lexeme at the position, or null if not found
+     *
+     * @example
+     * ```typescript
+     * const sql = "SELECT user_id FROM orders";
+     * const lexeme = LexemeCursor.findLexemeAtLineColumn(sql, { line: 1, column: 8 });
+     * console.log(lexeme?.value); // 'user_id'
+     * ```
+     */
+    static findLexemeAtLineColumn(sql: string, position: LineColumn): Lexeme | null;
     /**
      * Find the lexeme at the specified cursor position.
      *
@@ -85,4 +110,20 @@ export declare class LexemeCursor {
      * Create a lexeme with position information
      */
     private static createLexeme;
+    /**
+     * Convert line and column position to character offset.
+     *
+     * @param sql - The SQL string
+     * @param position - Line and column position (1-based)
+     * @returns Character offset (0-based), or -1 if position is out of bounds
+     */
+    private static lineColumnToCharOffset;
+    /**
+     * Convert character offset to line and column position.
+     *
+     * @param sql - The SQL string
+     * @param charOffset - Character offset (0-based)
+     * @returns Line and column position (1-based), or null if offset is out of bounds
+     */
+    static charOffsetToLineColumn(sql: string, charOffset: number): LineColumn | null;
 }