bash_lsp 0.1.0

package/server/out/methods/textDocument/definition.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = void 0;
+const fs = require("fs");
+const url_1 = require("url");
+const documents_1 = require("../../interfaces/documents");
+const workspace_1 = require("../../interfaces/workspace");
+const functionKeywordPattern = /^(\s*function\s+)([A-Za-z_][A-Za-z0-9_]*)\s*(?:\(\s*\))?\s*(?:\{|$)/;
+const nameParenthesisPattern = /^(\s*)([A-Za-z_][A-Za-z0-9_]*)\s*\(\s*\)\s*(?:\{|$)/;
+/**
+ * Returns whether a character can be part of a shell symbol token.
+ */
+const isWordChar = (char) => /[A-Za-z0-9_]/.test(char);
+/**
+ * Gets the symbol under (or immediately before) the provided cursor position.
+ *
+ * @param line Current line content.
+ * @param character Cursor character index.
+ * @returns The detected symbol or null when no valid token exists at the position.
+ */
+const wordAtPosition = (line, character) => {
+    if (!line.length) {
+        return null;
+    }
+    // checks if the current position is a valid symbol
+    let index = Math.min(character, line.length - 1);
+    if (!isWordChar(line[index])) {
+        // if it is not a valid symbol, check one character to the left to take empty spaces into account
+        if (character > 0 && isWordChar(line[character - 1])) {
+            index = character - 1;
+        }
+        else {
+            return null;
+        }
+    }
+    // sets lower limit of symbol
+    let start = index;
+    while (start > 0 && isWordChar(line[start - 1])) {
+        start -= 1;
+    }
+    // sets upper limit of symbol
+    let end = index + 1;
+    while (end < line.length && isWordChar(line[end])) {
+        end += 1;
+    }
+    // returns the characters between start and end
+    return line.slice(start, end);
+};
+/**
+ * Finds the first matching function-style definition for a symbol in a document.
+ *
+ * Supports both `function name()` and `name()` styles while ignoring commented
+ * lines that start with `#`.
+ *
+ * @param uri Document URI.
+ * @param content Full document content.
+ * @param symbol Symbol to locate.
+ * @returns Definition location or null if no match is found.
+ */
+const findDefinitionInContent = (uri, content, symbol) => {
+    const lines = content.split("\n");
+    for (let lineNumber = 0; lineNumber < lines.length; lineNumber += 1) {
+        const line = lines[lineNumber];
+        // if line is a comment, skip
+        if (/^\s*#/.test(line)) {
+            continue;
+        }
+        // checks for "function name (...)" pattern
+        const functionKeywordMatch = line.match(functionKeywordPattern);
+        if (functionKeywordMatch) {
+            const functionName = functionKeywordMatch[2]; // at 0 returns full text, at 1 returns "function " part
+            if (functionName === symbol) {
+                const startCharacter = functionKeywordMatch[1].length;
+                return {
+                    uri,
+                    range: {
+                        start: { line: lineNumber, character: startCharacter },
+                        end: {
+                            line: lineNumber,
+                            character: startCharacter + symbol.length,
+                        },
+                    },
+                };
+            }
+        }
+        // checks for "name (...)" pattern
+        const nameParenthesisMatch = line.match(nameParenthesisPattern);
+        if (nameParenthesisMatch) {
+            const functionName = nameParenthesisMatch[2]; // at 0 returns full text, at 1 returns indentation
+            if (functionName === symbol) {
+                const startCharacter = nameParenthesisMatch[1].length;
+                return {
+                    uri,
+                    range: {
+                        start: { line: lineNumber, character: startCharacter },
+                        end: {
+                            line: lineNumber,
+                            character: startCharacter + symbol.length,
+                        },
+                    },
+                };
+            }
+        }
+    }
+    return null;
+};
+const definition = (message) => {
+    const params = message.params;
+    const content = documents_1.documents.get(params.textDocument.uri);
+    if (!content) {
+        return null;
+    }
+    const line = content.split("\n")[params.position.line];
+    if (line === undefined) {
+        return null;
+    }
+    const symbol = wordAtPosition(line, params.position.character);
+    if (!symbol) {
+        return null;
+    }
+    const currentDocumentDefinition = findDefinitionInContent(params.textDocument.uri, content, symbol);
+    if (currentDocumentDefinition) {
+        return currentDocumentDefinition;
+    }
+    // search other open documents
+    for (const [uri, documentContent] of documents_1.documents.entries()) {
+        if (uri === params.textDocument.uri)
+            continue;
+        const definitionInOpenDocument = findDefinitionInContent(uri, documentContent, symbol);
+        if (definitionInOpenDocument)
+            return definitionInOpenDocument;
+    }
+    // search workspace .sh files not already open
+    if (workspace_1.workspaceRoot) {
+        for (const filePath of (0, workspace_1.collectShellFiles)(workspace_1.workspaceRoot)) {
+            const fileUri = (0, url_1.pathToFileURL)(filePath).href;
+            if (documents_1.documents.has(fileUri))
+                continue;
+            let fileContent;
+            try {
+                fileContent = fs.readFileSync(filePath, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            const definitionInWorkspace = findDefinitionInContent(fileUri, fileContent, symbol);
+            if (definitionInWorkspace)
+                return definitionInWorkspace;
+        }
+    }
+    return null;
+};
+exports.definition = definition;
+//# sourceMappingURL=definition.js.map

package/server/out/methods/textDocument/definition.js.map

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

package/server/out/methods/textDocument/diagnostic/bracketDiagnostics.js

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bracketDiagnostics = void 0;
+const diagnostics_1 = require("../../../interfaces/diagnostics");
+/**
+ * Maps opening brackets to their expected closing counterparts.
+ */
+const openingToClosingBracket = {
+    "(": ")",
+    "[": "]",
+    "{": "}",
+};
+/**
+ * Maps closing brackets to their expected opening counterparts.
+ */
+const closingToOpeningBracket = {
+    ")": "(",
+    "]": "[",
+    "}": "{",
+};
+/**
+ * Produces diagnostics for unmatched or mismatched brackets in shell content.
+ *
+ * Brackets inside comments and quoted strings are ignored. Inside `case` blocks,
+ * pattern headers are ignored until `)` is reached, then bracket checks run for
+ * the clause body until `;;`.
+ *
+ * @param content Full document text.
+ * @returns Diagnostic list for detected bracket issues.
+ */
+const bracketDiagnostics = (content) => {
+    const diagnostics = [];
+    const bracketStack = [];
+    const lines = content.split("\n");
+    const parserState = {
+        inSingleQuotes: false,
+        inDoubleQuotes: false,
+        inCaseBlock: false,
+        inCaseClauseBody: false,
+    };
+    for (let lineNumber = 0; lineNumber < lines.length; lineNumber += 1) {
+        processLineForBracketDiagnostics(lines[lineNumber], lineNumber, parserState, bracketStack, diagnostics);
+    }
+    emitUnmatchedOpeningBracketDiagnostics(bracketStack, diagnostics);
+    return diagnostics;
+};
+exports.bracketDiagnostics = bracketDiagnostics;
+/**
+ * Parses one line and updates bracket diagnostics and parser state.
+ *
+ * @param line Current line text.
+ * @param lineNumber Zero-based line index.
+ * @param parserState Mutable parser state shared across lines.
+ * @param bracketStack Stack of unmatched opening brackets.
+ * @param diagnostics Collected diagnostics.
+ */
+const processLineForBracketDiagnostics = (line, lineNumber, parserState, bracketStack, diagnostics) => {
+    let currentWord = "";
+    for (let character = 0; character < line.length; character += 1) {
+        const currentChar = line[character];
+        // check if current line is a comment
+        if (isCommentStart(currentChar, parserState)) {
+            processWordForCaseState(currentWord, parserState);
+            break;
+        }
+        // check if current word starts with an escaped character, if it does, skip it
+        if (isEscapedCharacter(currentChar, parserState)) {
+            processWordForCaseState(currentWord, parserState);
+            currentWord = "";
+            character += 1;
+            continue;
+        }
+        // check if current word is starting or ending a single-quoted string
+        if (isSingleQuoteToggle(currentChar, parserState)) {
+            processWordForCaseState(currentWord, parserState);
+            currentWord = "";
+            parserState.inSingleQuotes = !parserState.inSingleQuotes;
+            continue;
+        }
+        // check if current word is starting or ending a double-quoted string
+        if (isDoubleQuoteToggle(currentChar, parserState)) {
+            processWordForCaseState(currentWord, parserState);
+            currentWord = "";
+            parserState.inDoubleQuotes = !parserState.inDoubleQuotes;
+            continue;
+        }
+        // if inside quoted string, skip character
+        if (isInsideQuotedString(parserState)) {
+            continue;
+        }
+        currentWord = updateCurrentWord(currentWord, currentChar, parserState);
+        if (isEnteringCaseClause(currentChar, parserState)) {
+            parserState.inCaseClauseBody = true;
+            continue;
+        }
+        if (isLeavingCaseClause(line, character, parserState)) {
+            parserState.inCaseClauseBody = false;
+            character += 1;
+            continue;
+        }
+        if (shouldIgnoreBracketInCaseHeader(currentChar, parserState)) {
+            continue;
+        }
+        if (isOpeningBracket(currentChar)) {
+            pushOpeningBracket(bracketStack, currentChar, lineNumber, character);
+            continue;
+        }
+        if (isClosingBracket(currentChar)) {
+            processClosingBracket(bracketStack, currentChar, lineNumber, character, diagnostics);
+        }
+    }
+    processWordForCaseState(currentWord, parserState);
+};
+/**
+ * Returns whether a character starts a comment in the current parser state.
+ *
+ * @param char Character to inspect.
+ * @param parserState Current parser state.
+ */
+const isCommentStart = (char, parserState) => {
+    return !isInsideQuotedString(parserState) && char === "#";
+};
+/**
+ * Updates case-related parser state when a shell word boundary is reached.
+ *
+ * @param word Parsed shell word.
+ * @param parserState Mutable parser state.
+ */
+const processWordForCaseState = (word, parserState) => {
+    if (word === "case") {
+        parserState.inCaseBlock = true;
+        parserState.inCaseClauseBody = false;
+        return;
+    }
+    if (word === "esac") {
+        parserState.inCaseBlock = false;
+        parserState.inCaseClauseBody = false;
+    }
+};
+/**
+ * Returns whether the character begins an escaped sequence that should be skipped.
+ *
+ * @param char Character to inspect.
+ * @param parserState Current parser state.
+ */
+const isEscapedCharacter = (char, parserState) => {
+    return char === "\\" && !parserState.inSingleQuotes;
+};
+/**
+ * Returns whether the character toggles single-quote string mode.
+ *
+ * @param char Character to inspect.
+ * @param parserState Current parser state.
+ */
+const isSingleQuoteToggle = (char, parserState) => {
+    return char === "'" && !parserState.inDoubleQuotes;
+};
+/**
+ * Returns whether the character toggles double-quote string mode.
+ *
+ * @param char Character to inspect.
+ * @param parserState Current parser state.
+ */
+const isDoubleQuoteToggle = (char, parserState) => {
+    return char === '"' && !parserState.inSingleQuotes;
+};
+/**
+ * Returns whether parsing is currently inside a quoted string.
+ *
+ * @param parserState Current parser state.
+ */
+const isInsideQuotedString = (parserState) => {
+    return parserState.inSingleQuotes || parserState.inDoubleQuotes;
+};
+/**
+ * Returns whether a character is part of a shell word token.
+ *
+ * @param char Character to inspect.
+ */
+const isWordCharacter = (char) => /[A-Za-z0-9_]/.test(char);
+/**
+ * Appends to the current shell word or flushes it into case-state processing.
+ *
+ * @param currentWord Current accumulated word.
+ * @param currentChar Current character.
+ * @param parserState Mutable parser state.
+ * @returns Updated accumulated word.
+ */
+const updateCurrentWord = (currentWord, currentChar, parserState) => {
+    if (isWordCharacter(currentChar)) {
+        return currentWord + currentChar;
+    }
+    processWordForCaseState(currentWord, parserState);
+    return "";
+};
+/**
+ * Returns whether the current character enters the body of a case clause.
+ *
+ * @param currentChar Character to inspect.
+ * @param parserState Current parser state.
+ */
+const isEnteringCaseClause = (currentChar, parserState) => {
+    return parserState.inCaseBlock && !parserState.inCaseClauseBody && currentChar === ")";
+};
+/**
+ * Returns whether parsing is currently leaving a case clause body.
+ *
+ * @param line Current line text.
+ * @param character Zero-based character index.
+ * @param parserState Current parser state.
+ */
+const isLeavingCaseClause = (line, character, parserState) => {
+    return (parserState.inCaseBlock && parserState.inCaseClauseBody && line.startsWith(";;", character));
+};
+/**
+ * Returns whether bracket tokens should be ignored in a case pattern header.
+ *
+ * @param currentChar Character to inspect.
+ * @param parserState Current parser state.
+ */
+const shouldIgnoreBracketInCaseHeader = (currentChar, parserState) => {
+    return (parserState.inCaseBlock &&
+        !parserState.inCaseClauseBody &&
+        (isOpeningBracket(currentChar) || isClosingBracket(currentChar)));
+};
+/**
+ * Returns whether a character is one of the supported opening brackets.
+ *
+ * @param char Character to inspect.
+ */
+const isOpeningBracket = (char) => {
+    return char === "(" || char === "[" || char === "{";
+};
+/**
+ * Pushes an opening bracket position onto the stack.
+ *
+ * @param bracketStack Stack of unmatched opening brackets.
+ * @param openingBracket Opening bracket token.
+ * @param lineNumber Zero-based line index.
+ * @param character Zero-based character index.
+ */
+const pushOpeningBracket = (bracketStack, openingBracket, lineNumber, character) => {
+    bracketStack.push({
+        char: openingBracket,
+        line: lineNumber,
+        character,
+    });
+};
+/**
+ * Returns whether a character is one of the supported closing brackets.
+ *
+ * @param char Character to inspect.
+ */
+const isClosingBracket = (char) => {
+    return char === ")" || char === "]" || char === "}";
+};
+/**
+ * Processes a closing bracket and emits diagnostics for unmatched/mismatched pairs.
+ *
+ * @param bracketStack Stack of unmatched opening brackets.
+ * @param closingBracket Closing bracket token.
+ * @param lineNumber Zero-based line index.
+ * @param character Zero-based character index.
+ * @param diagnostics Collected diagnostics.
+ */
+const processClosingBracket = (bracketStack, closingBracket, lineNumber, character, diagnostics) => {
+    const expectedMatchingOpeningBracket = closingToOpeningBracket[closingBracket];
+    const openingBracket = bracketStack.at(-1);
+    if (!openingBracket) {
+        diagnostics.push(buildBracketDiagnostic(`Unmatched closing bracket "${closingBracket}".`, lineNumber, character));
+        return;
+    }
+    if (openingBracket.char !== expectedMatchingOpeningBracket) {
+        const expectedMatchingClosingBracket = openingToClosingBracket[openingBracket.char];
+        diagnostics.push(buildBracketDiagnostic(`Mismatched closing bracket "${closingBracket}". Expected "${expectedMatchingClosingBracket}" to match "${openingBracket.char}".`, lineNumber, character));
+        return;
+    }
+    bracketStack.pop();
+};
+/**
+ * Emits diagnostics for any opening brackets left unmatched in the stack.
+ *
+ * @param bracketStack Stack of unmatched opening brackets.
+ * @param diagnostics Collected diagnostics.
+ */
+const emitUnmatchedOpeningBracketDiagnostics = (bracketStack, diagnostics) => {
+    while (bracketStack.length > 0) {
+        const openingBracket = bracketStack.pop();
+        diagnostics.push(buildBracketDiagnostic(`Unmatched opening bracket "${openingBracket.char}".`, openingBracket.line, openingBracket.character));
+    }
+};
+/**
+ * Builds a diagnostic for a bracket parsing error at one character position.
+ *
+ * @param message Diagnostic error message.
+ * @param line Zero-based line index.
+ * @param character Zero-based character index.
+ */
+const buildBracketDiagnostic = (message, line, character) => {
+    return {
+        severity: diagnostics_1.DiagnosticSeverity.Error,
+        message,
+        source: "shell-language-server",
+        range: singleCharacterRange(line, character),
+        data: { type: diagnostics_1.DiagnosticType.MissingBracket },
+    };
+};
+/**
+ * Builds a single-character range at a specific line/column location.
+ *
+ * @param line Zero-based line index.
+ * @param character Zero-based character index.
+ * @returns LSP range covering one character.
+ */
+const singleCharacterRange = (line, character) => ({
+    start: { line, character },
+    end: { line, character: character + 1 },
+});
+//# sourceMappingURL=bracketDiagnostics.js.map

package/server/out/methods/textDocument/diagnostic/bracketDiagnostics.js.map

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

package/server/out/methods/textDocument/diagnostic/diagnostic.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diagnostic = void 0;
+const documents_1 = require("../../../interfaces/documents");
+const bracketDiagnostics_1 = require("./bracketDiagnostics");
+const structureSemicolonDiagnostics_1 = require("./structureSemicolonDiagnostics");
+/**
+ * Handles `textDocument/diagnostic` requests and returns full-document
+ * diagnostics for bracket matching errors and control structure semicolon
+ * checks.
+ *
+ * @param message JSON-RPC request containing document diagnostic params.
+ * @returns Full diagnostic report for the requested document.
+ */
+const diagnostic = (message) => {
+    const params = message.params;
+    const content = documents_1.documents.get(params.textDocument.uri);
+    if (!content) {
+        return null;
+    }
+    return {
+        kind: "full",
+        items: [...(0, bracketDiagnostics_1.bracketDiagnostics)(content), ...(0, structureSemicolonDiagnostics_1.structureSemicolonDiagnostics)(content)],
+    };
+};
+exports.diagnostic = diagnostic;
+//# sourceMappingURL=diagnostic.js.map

package/server/out/methods/textDocument/diagnostic/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../../../src/methods/textDocument/diagnostic/diagnostic.ts"],"names":[],"mappings":";;;AACA,6DAA0D;AAK1D,6DAA0D;AAC1D,mFAAgF;AAEhF;;;;;;;GAOG;AACI,MAAM,UAAU,GAAG,CAAC,OAAuB,EAAuC,EAAE;IACzF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAkC,CAAC;IAC1D,MAAM,OAAO,GAAG,qBAAS,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAEvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC,GAAG,IAAA,uCAAkB,EAAC,OAAO,CAAC,EAAE,GAAG,IAAA,6DAA6B,EAAC,OAAO,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,UAAU,cAYrB"}