rawsql-ts 0.11.32-beta → 0.11.34-beta

package/dist/src/utils/CursorContextAnalyzer.d.ts

@@ -0,0 +1,70 @@
+import { Lexeme } from '../models/Lexeme';
+import { LineColumn } from './LexemeCursor';
+/**
+ * IntelliSense context focused on what suggestions can be provided
+ */
+export interface IntelliSenseContext {
+    /** Whether to suggest table names (can provide actual table list) */
+    suggestTables: boolean;
+    /** Whether to suggest column names (can provide actual column list) */
+    suggestColumns: boolean;
+    /** Whether to suggest SQL keywords (can provide keyword list) */
+    suggestKeywords: boolean;
+    /** If suggesting columns, limit to this table's columns (for table.| syntax) */
+    tableScope?: string;
+    /** If suggesting keywords, these specific keywords are required */
+    requiredKeywords?: string[];
+    /** Token at cursor position (if any) */
+    currentToken?: Lexeme;
+    /** Token immediately before cursor position */
+    previousToken?: Lexeme;
+}
+export declare class CursorContextAnalyzer {
+    /**
+     * Cache for processed keyword patterns
+     */
+    private static patternCache;
+    /**
+     * Process existing dictionaries into IntelliSense-friendly patterns
+     * Single source of truth: existing CommandTokenReader dictionaries
+     */
+    private static getKeywordPatterns;
+    /**
+     * Extract all keyword patterns from the existing dictionaries
+     */
+    private static extractKeywordPatterns;
+    /**
+     * Check if a keyword exists in the command dictionaries using existing parsers
+     */
+    private static isKeywordInDictionary;
+    /**
+     * Extract all keywords that require specific followup keywords
+     */
+    private static extractRequiresKeywordPatterns;
+    /**
+     * Find all possible followup keywords for a given word using KeywordCache
+     */
+    private static findPossibleFollowups;
+    /**
+     * Helper function to check if a token requires specific keywords
+     */
+    private static requiresSpecificKeywords;
+    /**
+     * Analyze cursor position for IntelliSense suggestions
+     *
+     * Direct implementation that determines what suggestions can be provided
+     * without legacy context conversion overhead.
+     *
+     * @param sql - SQL text to analyze
+     * @param cursorPosition - Character position (0-based)
+     * @returns IntelliSense context focused on what suggestions can be provided
+     */
+    static analyzeIntelliSense(sql: string, cursorPosition: number): IntelliSenseContext;
+    /**
+     * Analyze cursor position for IntelliSense at line/column position
+     */
+    static analyzeIntelliSenseAt(sql: string, position: LineColumn): IntelliSenseContext;
+    private static isAfterDot;
+    private static findPrecedingIdentifier;
+    private static isIdentifier;
+}

package/dist/src/utils/CursorContextAnalyzer.js

@@ -0,0 +1,338 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorContextAnalyzer = void 0;
+const LexemeCursor_1 = require("./LexemeCursor");
+const TextPositionUtils_1 = require("./TextPositionUtils");
+const KeywordCache_1 = require("./KeywordCache");
+class CursorContextAnalyzer {
+    /**
+     * Process existing dictionaries into IntelliSense-friendly patterns
+     * Single source of truth: existing CommandTokenReader dictionaries
+     */
+    static getKeywordPatterns() {
+        if (this.patternCache !== null) {
+            return this.patternCache;
+        }
+        const requiresKeywords = new Map();
+        const suggestsTables = new Set();
+        const suggestsColumns = new Set();
+        // Extract all patterns by systematically testing the dictionaries
+        this.extractKeywordPatterns(requiresKeywords, suggestsTables, suggestsColumns);
+        // Cache the processed patterns
+        this.patternCache = {
+            requiresKeywords,
+            suggestsTables,
+            suggestsColumns
+        };
+        return this.patternCache;
+    }
+    /**
+     * Extract all keyword patterns from the existing dictionaries
+     */
+    static extractKeywordPatterns(requiresKeywords, suggestsTables, suggestsColumns) {
+        // Define SQL contexts and their expected behavior
+        const tableContexts = ['from', 'join']; // Keywords that introduce table names
+        const columnContexts = ['select', 'where', 'on', 'having', 'by']; // Keywords that introduce columns
+        // Check table context keywords
+        for (const keyword of tableContexts) {
+            if (this.isKeywordInDictionary(keyword)) {
+                suggestsTables.add(keyword);
+            }
+        }
+        // Check column context keywords  
+        for (const keyword of columnContexts) {
+            if (this.isKeywordInDictionary(keyword)) {
+                suggestsColumns.add(keyword);
+            }
+        }
+        // Extract all keyword patterns that require followups
+        this.extractRequiresKeywordPatterns(requiresKeywords);
+    }
+    /**
+     * Check if a keyword exists in the command dictionaries using existing parsers
+     */
+    static isKeywordInDictionary(keyword) {
+        // Use KeywordCache for JOIN keywords
+        if (KeywordCache_1.KeywordCache.isValidJoinKeyword(keyword)) {
+            return true;
+        }
+        // Check if keyword exists in command dictionary
+        // Since we can't directly query the trie, use known keyword list
+        const knownKeywords = ['from', 'join', 'select', 'where', 'on', 'having', 'by', 'group', 'order'];
+        return knownKeywords.includes(keyword);
+    }
+    /**
+     * Extract all keywords that require specific followup keywords
+     */
+    static extractRequiresKeywordPatterns(requiresKeywords) {
+        // Test all potential first words that might require followup keywords
+        const potentialFirstWords = [
+            // JOIN modifiers
+            'inner', 'left', 'right', 'full', 'cross', 'natural', 'outer',
+            // Other composite keywords
+            'group', 'order'
+        ];
+        for (const word of potentialFirstWords) {
+            const possibleFollowups = this.findPossibleFollowups(word);
+            if (possibleFollowups.length > 0) {
+                requiresKeywords.set(word, possibleFollowups);
+            }
+        }
+    }
+    /**
+     * Find all possible followup keywords for a given word using KeywordCache
+     */
+    static findPossibleFollowups(word) {
+        const followups = new Set();
+        // Use KeywordCache for JOIN-related suggestions
+        const joinSuggestions = KeywordCache_1.KeywordCache.getJoinSuggestions(word.toLowerCase());
+        joinSuggestions.forEach(s => followups.add(s.toUpperCase()));
+        // Use KeywordCache for command-related suggestions
+        const commandSuggestions = KeywordCache_1.KeywordCache.getCommandSuggestions(word.toLowerCase());
+        commandSuggestions.forEach(s => followups.add(s.toUpperCase()));
+        return Array.from(followups);
+    }
+    /**
+     * Helper function to check if a token requires specific keywords
+     */
+    static requiresSpecificKeywords(tokenValue) {
+        const patterns = this.getKeywordPatterns();
+        const requiredKeywords = patterns.requiresKeywords.get(tokenValue);
+        if (requiredKeywords) {
+            return {
+                suggestKeywords: true,
+                requiredKeywords
+            };
+        }
+        return null;
+    }
+    /**
+     * Analyze cursor position for IntelliSense suggestions
+     *
+     * Direct implementation that determines what suggestions can be provided
+     * without legacy context conversion overhead.
+     *
+     * @param sql - SQL text to analyze
+     * @param cursorPosition - Character position (0-based)
+     * @returns IntelliSense context focused on what suggestions can be provided
+     */
+    static analyzeIntelliSense(sql, cursorPosition) {
+        try {
+            // Get all lexemes with position information
+            const allLexemes = LexemeCursor_1.LexemeCursor.getAllLexemesWithPosition(sql);
+            // Find token at cursor position
+            let actualTokenIndex = -1;
+            let actualCurrentToken;
+            // Find the token that contains or precedes the cursor
+            for (let i = 0; i < allLexemes.length; i++) {
+                const lexeme = allLexemes[i];
+                if (!lexeme.position)
+                    continue;
+                if (cursorPosition >= lexeme.position.startPosition &&
+                    cursorPosition <= lexeme.position.endPosition) {
+                    // Cursor is within this token
+                    actualCurrentToken = lexeme;
+                    actualTokenIndex = i;
+                    break;
+                }
+                else if (lexeme.position.startPosition > cursorPosition) {
+                    // Cursor is before this token (in whitespace)
+                    actualTokenIndex = Math.max(0, i - 1);
+                    actualCurrentToken = actualTokenIndex >= 0 ? allLexemes[actualTokenIndex] : undefined;
+                    break;
+                }
+            }
+            // If not found, cursor is after all tokens
+            if (actualTokenIndex === -1 && allLexemes.length > 0) {
+                actualTokenIndex = allLexemes.length - 1;
+                actualCurrentToken = allLexemes[actualTokenIndex];
+            }
+            const previousToken = actualTokenIndex > 0 ? allLexemes[actualTokenIndex - 1] : undefined;
+            // Check for dot completion (highest priority)
+            const isAfterDot = this.isAfterDot(sql, cursorPosition, previousToken);
+            if (isAfterDot) {
+                const precedingIdentifier = this.findPrecedingIdentifier(sql, cursorPosition, allLexemes);
+                return {
+                    suggestTables: false,
+                    suggestColumns: true,
+                    suggestKeywords: false,
+                    tableScope: precedingIdentifier,
+                    currentToken: actualCurrentToken,
+                    previousToken: previousToken
+                };
+            }
+            // Check for keywords that require additional keywords
+            if (actualCurrentToken) {
+                const currentValue = actualCurrentToken.value.toLowerCase();
+                const keywordRequirement = this.requiresSpecificKeywords(currentValue);
+                if (keywordRequirement) {
+                    return {
+                        suggestTables: false,
+                        suggestColumns: false,
+                        ...keywordRequirement,
+                        currentToken: actualCurrentToken,
+                        previousToken: previousToken
+                    };
+                }
+            }
+            // Check tokens for context-based suggestions
+            const tokenValue = actualCurrentToken === null || actualCurrentToken === void 0 ? void 0 : actualCurrentToken.value.toLowerCase();
+            const prevValue = previousToken === null || previousToken === void 0 ? void 0 : previousToken.value.toLowerCase();
+            // Check current token first (when cursor is at end of token)
+            if (tokenValue) {
+                const patterns = this.getKeywordPatterns();
+                // Keywords that suggest tables after them
+                if (patterns.suggestsTables.has(tokenValue)) {
+                    return {
+                        suggestTables: true,
+                        suggestColumns: false,
+                        suggestKeywords: false,
+                        currentToken: actualCurrentToken,
+                        previousToken: previousToken
+                    };
+                }
+                // Keywords that suggest columns after them
+                if (patterns.suggestsColumns.has(tokenValue)) {
+                    return {
+                        suggestTables: false,
+                        suggestColumns: true,
+                        suggestKeywords: false,
+                        currentToken: actualCurrentToken,
+                        previousToken: previousToken
+                    };
+                }
+            }
+            // Check previous token (when cursor is in whitespace after token)
+            if (prevValue) {
+                const patterns = this.getKeywordPatterns();
+                // Check if previous token requires specific keywords (and next token doesn't already fulfill it)
+                const keywordRequirement = this.requiresSpecificKeywords(prevValue);
+                if (keywordRequirement && tokenValue !== 'join' && tokenValue !== 'outer' && tokenValue !== 'by') {
+                    return {
+                        suggestTables: false,
+                        suggestColumns: false,
+                        ...keywordRequirement,
+                        currentToken: actualCurrentToken,
+                        previousToken: previousToken
+                    };
+                }
+                // Keywords that suggest tables
+                if (patterns.suggestsTables.has(prevValue)) {
+                    return {
+                        suggestTables: true,
+                        suggestColumns: false,
+                        suggestKeywords: false,
+                        currentToken: actualCurrentToken,
+                        previousToken: previousToken
+                    };
+                }
+                // Keywords that suggest columns
+                if (patterns.suggestsColumns.has(prevValue)) {
+                    return {
+                        suggestTables: false,
+                        suggestColumns: true,
+                        suggestKeywords: false,
+                        currentToken: actualCurrentToken,
+                        previousToken: previousToken
+                    };
+                }
+            }
+            // Default fallback - suggest keywords
+            return {
+                suggestTables: false,
+                suggestColumns: false,
+                suggestKeywords: true,
+                currentToken: actualCurrentToken,
+                previousToken: previousToken
+            };
+        }
+        catch (error) {
+            // Return minimal context on error
+            return {
+                suggestTables: false,
+                suggestColumns: false,
+                suggestKeywords: false,
+            };
+        }
+    }
+    /**
+     * Analyze cursor position for IntelliSense at line/column position
+     */
+    static analyzeIntelliSenseAt(sql, position) {
+        const charOffset = TextPositionUtils_1.TextPositionUtils.lineColumnToCharOffset(sql, position);
+        if (charOffset === -1) {
+            return {
+                suggestTables: false,
+                suggestColumns: false,
+                suggestKeywords: false,
+            };
+        }
+        return this.analyzeIntelliSense(sql, charOffset);
+    }
+    static isAfterDot(sql, cursorPosition, previousToken) {
+        // Check if character before cursor is a dot
+        if (cursorPosition > 0 && sql[cursorPosition - 1] === '.') {
+            return true;
+        }
+        // Check if previous token is a dot
+        if (previousToken && previousToken.value === '.') {
+            return true;
+        }
+        // Check for dot in nearby characters (handle whitespace)
+        let pos = cursorPosition - 1;
+        while (pos >= 0 && /\s/.test(sql[pos])) {
+            pos--; // Skip whitespace backwards
+        }
+        if (pos >= 0 && sql[pos] === '.') {
+            return true;
+        }
+        return false;
+    }
+    static findPrecedingIdentifier(sql, cursorPosition, lexemes) {
+        // If cursor is after a dot, look for identifier before the dot
+        if (this.isAfterDot(sql, cursorPosition)) {
+            // Find dot position in SQL text
+            let pos = cursorPosition - 1;
+            while (pos >= 0 && /\s/.test(sql[pos])) {
+                pos--; // Skip whitespace backwards
+            }
+            if (pos >= 0 && sql[pos] === '.') {
+                // Found the dot, now look for identifier before it
+                let identifierEnd = pos;
+                while (pos >= 0 && /\s/.test(sql[pos])) {
+                    pos--; // Skip whitespace
+                }
+                // Extract identifier backwards
+                while (pos >= 0 && /[a-zA-Z0-9_]/.test(sql[pos])) {
+                    pos--;
+                }
+                const identifierStart = pos + 1;
+                if (identifierStart < identifierEnd) {
+                    return sql.substring(identifierStart, identifierEnd);
+                }
+            }
+            // Fallback: try to find dot token in lexemes and get identifier before it
+            for (let i = lexemes.length - 1; i >= 0; i--) {
+                if (lexemes[i].value === '.' &&
+                    lexemes[i].position &&
+                    lexemes[i].position.startPosition < cursorPosition) {
+                    // Found a dot before cursor, get identifier before it
+                    if (i > 0 && this.isIdentifier(lexemes[i - 1])) {
+                        return lexemes[i - 1].value;
+                    }
+                    break;
+                }
+            }
+        }
+        return undefined;
+    }
+    static isIdentifier(lexeme) {
+        return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(lexeme.value);
+    }
+}
+exports.CursorContextAnalyzer = CursorContextAnalyzer;
+/**
+ * Cache for processed keyword patterns
+ */
+CursorContextAnalyzer.patternCache = null;
+//# sourceMappingURL=CursorContextAnalyzer.js.map

package/dist/src/utils/CursorContextAnalyzer.js.map

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

package/dist/src/utils/IntelliSenseApi.d.ts

@@ -0,0 +1,114 @@
+import { IntelliSenseContext } from './CursorContextAnalyzer';
+import { ScopeInfo } from './ScopeResolver';
+import { ParseToPositionOptions, PositionParseResult } from './PositionAwareParser';
+import { QueryCollection } from './MultiQuerySplitter';
+import { LineColumn } from './LexemeCursor';
+/**
+ * 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 declare function parseToPosition(sql: string, cursorPosition: number | LineColumn, options?: ParseToPositionOptions): PositionParseResult;
+/**
+ * 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 declare function getCursorContext(sql: string, cursorPosition: number | LineColumn): IntelliSenseContext;
+/**
+ * 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 declare function resolveScope(sql: string, cursorPosition: number | LineColumn): ScopeInfo;
+/**
+ * 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 declare function splitQueries(sql: string): QueryCollection;
+/**
+ * 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 declare function getIntelliSenseInfo(sql: string, cursorPosition: number | LineColumn, options?: ParseToPositionOptions): {
+    context: IntelliSenseContext;
+    scope: ScopeInfo;
+    parseResult: PositionParseResult;
+    currentQuery: string;
+    relativePosition: number;
+} | undefined;
+/**
+ * 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 declare function getCompletionSuggestions(sql: string, cursorPosition: number | LineColumn): Array<{
+    type: 'keyword' | 'table' | 'column' | 'cte' | 'function';
+    value: string;
+    detail?: string;
+    documentation?: string;
+}>;