umple-lsp-server 0.2.0 → 0.2.2

package/out/hoverBuilder.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * Hover content builder.
+ *
+ * Produces markdown hover strings from SymbolEntry data + tree access.
+ * No dependency on LSP connection, documents, or SymbolIndex class.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHoverMarkdown = buildHoverMarkdown;
+// Module-level context set by the entry point
+let ctx;
+function findDefNode(sym) {
+    if (sym.defLine == null || sym.defEndLine == null)
+        return null;
+    const tree = ctx.getTree(sym.file);
+    if (!tree)
+        return null;
+    return tree.rootNode.descendantForPosition({ row: sym.defLine, column: sym.defColumn ?? 0 }, { row: sym.defEndLine, column: sym.defEndColumn ?? 0 });
+}
+function buildClassLikeHover(sym, allSymbols) {
+    const keyword = sym.kind;
+    const parts = [];
+    const sameNameSyms = allSymbols.filter((s) => s.kind === sym.kind && s.name === sym.name);
+    let isAbstract = false;
+    for (const s of sameNameSyms) {
+        const node = findDefNode(s);
+        if (node &&
+            node.children.some((c) => c.type === "abstract_declaration")) {
+            isAbstract = true;
+            break;
+        }
+    }
+    let header = "";
+    if (isAbstract)
+        header += "abstract ";
+    header += `${keyword} ${sym.name}`;
+    parts.push(header);
+    const parents = ctx.getIsAParents(sym.name);
+    if (parents.length > 0) {
+        parts.push(`isA ${parents.join(", ")}`);
+    }
+    if (keyword === "enum") {
+        const defNode = findDefNode(sym);
+        if (defNode) {
+            const values = [];
+            for (const child of defNode.children) {
+                if (child.type === "enum_value") {
+                    const name = child.childForFieldName("name");
+                    if (name)
+                        values.push(name.text);
+                }
+            }
+            if (values.length > 0) {
+                parts.push(`{ ${values.join(", ")} }`);
+            }
+        }
+    }
+    return "```umple\n" + parts.join("\n") + "\n```";
+}
+function buildAttributeHover(sym, defNode) {
+    const parts = [];
+    const modifier = defNode.children.find((c) => c.type === "attribute_modifier");
+    if (modifier)
+        parts.push(modifier.text);
+    const typeNode = defNode.childForFieldName("type");
+    if (typeNode) {
+        parts.push(typeNode.text);
+    }
+    else if (!modifier || modifier.text !== "autounique") {
+        parts.push("String");
+    }
+    parts.push(sym.name);
+    let extra = "";
+    if (sym.container) {
+        extra = `\n\n*in class ${sym.container}*`;
+    }
+    return "```umple\n" + parts.join(" ") + "\n```" + extra;
+}
+function buildConstHover(sym, defNode) {
+    const typeNode = defNode.childForFieldName("type");
+    const typeName = typeNode ? typeNode.text : "String";
+    let value = "";
+    let seenEquals = false;
+    for (const child of defNode.children) {
+        if (child.type === "=" || child.text === "=") {
+            seenEquals = true;
+            continue;
+        }
+        if (seenEquals && child.text !== ";") {
+            value = child.text;
+            break;
+        }
+    }
+    let result = "```umple\nconst " + typeName + " " + sym.name;
+    if (value)
+        result += " = " + value;
+    result += "\n```";
+    if (sym.container) {
+        result += `\n\n*in class ${sym.container}*`;
+    }
+    return result;
+}
+function buildMethodHover(sym, defNode) {
+    const parts = [];
+    const vis = defNode.children.find((c) => c.type === "visibility");
+    if (vis)
+        parts.push(vis.text);
+    for (const child of defNode.children) {
+        if (child.type === "static") {
+            parts.push("static");
+            break;
+        }
+    }
+    const returnType = defNode.childForFieldName("return_type");
+    if (returnType) {
+        parts.push(returnType.text);
+    }
+    else {
+        parts.push("void");
+    }
+    const paramList = defNode.children.find((c) => c.type === "param_list");
+    let paramStr = "";
+    if (paramList) {
+        const params = [];
+        for (const p of paramList.children) {
+            if (p.type === "param") {
+                const pName = p.childForFieldName("name");
+                const pType = p.children.find((c) => c.type === "type_name");
+                if (pType && pName) {
+                    params.push(`${pType.text} ${pName.text}`);
+                }
+                else if (pName) {
+                    params.push(pName.text);
+                }
+            }
+        }
+        paramStr = params.join(", ");
+    }
+    parts.push(`${sym.name}(${paramStr})`);
+    let extra = "";
+    if (sym.container) {
+        extra = `\n\n*in class ${sym.container}*`;
+    }
+    return "```umple\n" + parts.join(" ") + "\n```" + extra;
+}
+function buildStateMachineHover(sym, allSymbols) {
+    const stateNames = [];
+    const sameNameSyms = allSymbols.filter((s) => s.kind === "statemachine" && s.name === sym.name);
+    for (const s of sameNameSyms) {
+        const node = findDefNode(s);
+        if (!node)
+            continue;
+        for (const child of node.children) {
+            if (child.type === "state") {
+                const name = child.childForFieldName("name");
+                if (name && !stateNames.includes(name.text)) {
+                    stateNames.push(name.text);
+                }
+            }
+        }
+    }
+    let result = "```umple\n" + sym.name + " (state machine)\n```";
+    if (stateNames.length > 0) {
+        result += `\n\nStates: ${stateNames.join(", ")}`;
+    }
+    if (sym.container) {
+        result += `\n\n*in class ${sym.container}*`;
+    }
+    return result;
+}
+function collectStateInfo(defNode) {
+    const transitions = [];
+    const actions = [];
+    const nestedStates = [];
+    for (const child of defNode.children) {
+        if (child.type === "transition") {
+            const event = child.childForFieldName("event");
+            const target = child.childForFieldName("target");
+            const guard = child.children.find((c) => c.type === "guard");
+            let transStr = "  ";
+            if (event)
+                transStr += event.text;
+            else
+                transStr += "(auto)";
+            if (guard)
+                transStr += ` ${guard.text}`;
+            if (target)
+                transStr += ` -> ${target.text}`;
+            if (!transitions.includes(transStr))
+                transitions.push(transStr);
+        }
+        if (child.type === "entry_exit_action") {
+            const keyword = child.children.find((c) => c.text === "entry" || c.text === "exit")
+                ?.text ?? "action";
+            const line = `  ${keyword} / { ... }`;
+            if (!actions.includes(line))
+                actions.push(line);
+        }
+        if (child.type === "state") {
+            const name = child.childForFieldName("name");
+            if (name && !nestedStates.includes(name.text)) {
+                nestedStates.push(name.text);
+            }
+        }
+    }
+    return { transitions, actions, nestedStates };
+}
+function buildStateHover(sym, allSymbols) {
+    const lines = [`${sym.name} (state)`];
+    const sameNameStates = allSymbols.filter((s) => s.kind === "state" && s.name === sym.name);
+    for (const s of sameNameStates) {
+        const node = findDefNode(s);
+        if (!node)
+            continue;
+        const info = collectStateInfo(node);
+        for (const t of info.transitions) {
+            if (!lines.includes(t))
+                lines.push(t);
+        }
+        for (const a of info.actions) {
+            if (!lines.includes(a))
+                lines.push(a);
+        }
+        if (info.nestedStates.length > 0) {
+            const nested = `  nested: ${info.nestedStates.join(", ")}`;
+            if (!lines.includes(nested))
+                lines.push(nested);
+        }
+    }
+    let result = "```umple\n" + lines.join("\n") + "\n```";
+    if (sym.container) {
+        const smDisplay = sym.container.includes(".")
+            ? sym.container.substring(sym.container.indexOf(".") + 1)
+            : sym.container;
+        result += `\n\n*in state machine ${smDisplay}*`;
+    }
+    return result;
+}
+function buildAssociationHover(sym, defNode) {
+    const nodeType = defNode.type;
+    if (nodeType === "association_definition") {
+        const members = defNode.children.filter((c) => c.type === "association_member");
+        if (members.length > 0) {
+            const lines = [];
+            for (const member of members) {
+                lines.push(member.text.trim());
+            }
+            let result = "```umple\nassociation";
+            if (sym.name)
+                result += ` ${sym.name}`;
+            result += `\n  ${lines.join("\n  ")}\n\`\`\``;
+            return result;
+        }
+    }
+    if (nodeType === "inline_association" || nodeType === "association_inline") {
+        return "```umple\n" + defNode.text.trim() + "\n```";
+    }
+    return "```umple\nassociation " + sym.name + "\n```";
+}
+/**
+ * Build markdown hover content for a resolved symbol.
+ *
+ * @param sym        The primary resolved symbol
+ * @param allSymbols Full match list (for merging split definitions)
+ * @param hoverCtx   Callbacks for tree access and isA parents
+ * @returns Markdown string, or null if no definition node found
+ */
+function buildHoverMarkdown(sym, allSymbols, hoverCtx) {
+    ctx = hoverCtx;
+    const defNode = findDefNode(sym);
+    if (!defNode)
+        return null;
+    switch (sym.kind) {
+        case "class":
+        case "interface":
+        case "trait":
+        case "enum":
+            return buildClassLikeHover(sym, allSymbols);
+        case "attribute":
+            return buildAttributeHover(sym, defNode);
+        case "const":
+            return buildConstHover(sym, defNode);
+        case "method":
+            return buildMethodHover(sym, defNode);
+        case "statemachine":
+            return buildStateMachineHover(sym, allSymbols);
+        case "state":
+            return buildStateHover(sym, allSymbols);
+        case "association":
+            return buildAssociationHover(sym, defNode);
+        case "enum_value": {
+            let result = "```umple\n" + sym.name + "\n```";
+            if (sym.container) {
+                result += `\n\n*in enum ${sym.container}*`;
+            }
+            return result;
+        }
+        case "mixset":
+            return "```umple\nmixset " + sym.name + "\n```";
+        case "requirement":
+            return "```umple\nrequirement " + sym.name + "\n```";
+        case "template":
+            return "```umple\ntemplate " + sym.name + "\n```";
+        default:
+            return "```umple\n" + sym.kind + " " + sym.name + "\n```";
+    }
+}
+//# sourceMappingURL=hoverBuilder.js.map

package/out/hoverBuilder.js.map

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

package/out/importGraph.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Import graph data structure.
+ *
+ * Manages forward (file → imports) and reverse (file → importers) edge maps
+ * for use-statement resolution. Owns only edge storage and traversal —
+ * path resolution, use parsing, and fs policy stay in symbolIndex.ts.
+ */
+export declare class ImportGraph {
+    private forward;
+    private reverse;
+    /**
+     * Update import edges for a file. Removes old edges first, then adds new ones.
+     */
+    setEdges(filePath: string, imports: Set<string>): void;
+    /**
+     * Remove all edges for a file (both directions).
+     */
+    removeEdges(filePath: string): void;
+    /**
+     * Get forward imports for a file.
+     */
+    getForward(filePath: string): Set<string> | undefined;
+    /**
+     * Transitive reverse closure: all files whose use chain can reach
+     * any of the given target files.
+     */
+    getReverseImporters(targetFiles: Set<string>): Set<string>;
+}

package/out/importGraph.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Import graph data structure.
+ *
+ * Manages forward (file → imports) and reverse (file → importers) edge maps
+ * for use-statement resolution. Owns only edge storage and traversal —
+ * path resolution, use parsing, and fs policy stay in symbolIndex.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportGraph = void 0;
+class ImportGraph {
+    forward = new Map();
+    reverse = new Map();
+    /**
+     * Update import edges for a file. Removes old edges first, then adds new ones.
+     */
+    setEdges(filePath, imports) {
+        // Remove old forward edges from reverse map
+        const oldImports = this.forward.get(filePath);
+        if (oldImports) {
+            for (const imp of oldImports) {
+                const rev = this.reverse.get(imp);
+                if (rev) {
+                    rev.delete(filePath);
+                    if (rev.size === 0)
+                        this.reverse.delete(imp);
+                }
+            }
+        }
+        // Set new forward edges
+        this.forward.set(filePath, imports);
+        // Add new reverse edges
+        for (const imp of imports) {
+            let rev = this.reverse.get(imp);
+            if (!rev) {
+                rev = new Set();
+                this.reverse.set(imp, rev);
+            }
+            rev.add(filePath);
+        }
+    }
+    /**
+     * Remove all edges for a file (both directions).
+     */
+    removeEdges(filePath) {
+        // Clean forward → reverse
+        const oldImports = this.forward.get(filePath);
+        if (oldImports) {
+            for (const imp of oldImports) {
+                const rev = this.reverse.get(imp);
+                if (rev) {
+                    rev.delete(filePath);
+                    if (rev.size === 0)
+                        this.reverse.delete(imp);
+                }
+            }
+        }
+        this.forward.delete(filePath);
+        // Also remove as a target in reverse map
+        this.reverse.delete(filePath);
+    }
+    /**
+     * Get forward imports for a file.
+     */
+    getForward(filePath) {
+        return this.forward.get(filePath);
+    }
+    /**
+     * Transitive reverse closure: all files whose use chain can reach
+     * any of the given target files.
+     */
+    getReverseImporters(targetFiles) {
+        const result = new Set();
+        const queue = [...targetFiles];
+        while (queue.length > 0) {
+            const file = queue.pop();
+            const importers = this.reverse.get(file);
+            if (!importers)
+                continue;
+            for (const importer of importers) {
+                if (!result.has(importer) && !targetFiles.has(importer)) {
+                    result.add(importer);
+                    queue.push(importer);
+                }
+            }
+        }
+        return result;
+    }
+}
+exports.ImportGraph = ImportGraph;
+//# sourceMappingURL=importGraph.js.map

package/out/importGraph.js.map

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

package/out/referenceSearch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Reference search logic.
+ *
+ * Finds all references to a symbol across indexed files using
+ * references.scm query captures and semantic filtering.
+ * No dependency on SymbolIndex class.
+ */
+declare const TreeSitter: any;
+type Tree = InstanceType<typeof TreeSitter.Tree>;
+type Query = InstanceType<typeof TreeSitter.Query>;
+import type { SymbolEntry, ReferenceLocation } from "./symbolTypes";
+/**
+ * Find all references to a symbol across the given files.
+ *
+ * @param declarations      Target symbol declaration(s)
+ * @param includeDeclaration Whether to include declaration sites in results
+ * @param referencesQuery   Loaded references.scm query
+ * @param fileTreeMap       filePath → cached parse tree (only files to search)
+ * @param isAGraph          className → parent class names (for inheritance checks)
+ */
+export declare function searchReferences(declarations: SymbolEntry[], includeDeclaration: boolean, referencesQuery: Query, fileTreeMap: Map<string, Tree>, isAGraph: Map<string, string[]>): ReferenceLocation[];
+export {};