@samchon/graph 0.1.0

package/lib/indexer/overrideEdges.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overrideEdges = overrideEdges;
+// Given a graph that already carries `contains` (owner -> member) and
+// `extends`/`implements` (subtype -> supertype) edges, link a method to the
+// supertype method it overrides: a same-named method reachable on a supertype.
+function overrideEdges(nodes, edges) {
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    const methodsByOwner = new Map();
+    for (const edge of edges) {
+        if (edge.kind !== "contains")
+            continue;
+        const member = byId.get(edge.to);
+        if (member === undefined || member.kind !== "method")
+            continue;
+        let methods = methodsByOwner.get(edge.from);
+        if (methods === undefined) {
+            methods = new Map();
+            methodsByOwner.set(edge.from, methods);
+        }
+        methods.set(member.name, member);
+    }
+    const out = [];
+    for (const edge of edges) {
+        if (edge.kind !== "extends" && edge.kind !== "implements")
+            continue;
+        const subMethods = methodsByOwner.get(edge.from);
+        const superMethods = methodsByOwner.get(edge.to);
+        if (subMethods === undefined || superMethods === undefined)
+            continue;
+        for (const [name, subMethod] of subMethods) {
+            const superMethod = superMethods.get(name);
+            if (superMethod === undefined)
+                continue;
+            out.push({
+                from: subMethod.id,
+                to: superMethod.id,
+                kind: "overrides",
+                evidence: subMethod.evidence,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=overrideEdges.js.map

package/lib/indexer/overrideEdges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideEdges.js","sourceRoot":"","sources":["../../src/indexer/overrideEdges.ts"],"names":[],"mappings":";;;AAEA,sEAAsE;AACtE,4EAA4E;AAC5E,+EAA+E;AAC/E,uBACE,KAA4B,EAC5B,KAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmC,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QAC/D,IAAI,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS;QACpE,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,UAAU,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS;YAAE,SAAS;QACrE,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,WAAW,KAAK,SAAS;gBAAE,SAAS;YACxC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,SAAS,CAAC,EAAE;gBAClB,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,SAAS,CAAC,QAAQ;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/indexer/resolveType.d.ts

@@ -0,0 +1,2 @@
+import { IGraphNode } from "../structures";
+export declare function resolveType(name: string, source: IGraphNode, byName: Map<string, IGraphNode[]>): IGraphNode | undefined;

package/lib/indexer/resolveType.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveType = resolveType;
+function resolveType(name, source, byName) {
+    const candidates = byName.get(name.split(".").pop());
+    if (candidates === undefined)
+        return undefined;
+    return (candidates.find((node) => node.id !== source.id && node.file === source.file) ??
+        candidates.find((node) => node.id !== source.id));
+}
+//# sourceMappingURL=resolveType.js.map

package/lib/indexer/resolveType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveType.js","sourceRoot":"","sources":["../../src/indexer/resolveType.ts"],"names":[],"mappings":";;;AAEA,qBACE,IAAY,EACZ,MAAkB,EAClB,MAAiC;IAEjC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;QAC7E,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CACjD,CAAC;AACJ,CAAC"}

package/lib/indexer/specOf.d.ts

@@ -0,0 +1,3 @@
+import { GraphLanguage } from "../structures";
+import { ILanguageSpec } from "./ILanguageSpec";
+export declare function specOf(language: GraphLanguage): ILanguageSpec | undefined;

package/lib/indexer/specOf.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.specOf = specOf;
+const LANGUAGE_SPECS_1 = require("./LANGUAGE_SPECS");
+function specOf(language) {
+    return LANGUAGE_SPECS_1.LANGUAGE_SPECS.find((spec) => spec.language === language);
+}
+//# sourceMappingURL=specOf.js.map

package/lib/indexer/specOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specOf.js","sourceRoot":"","sources":["../../src/indexer/specOf.ts"],"names":[],"mappings":";;;AAEA,qDAAkD;AAElD,gBAAuB,QAAuB;IAC5C,OAAO,+BAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACnE,CAAC"}

package/lib/indexer/staticIndexer.d.ts

@@ -0,0 +1 @@
+export * from "./buildStaticGraph";

package/lib/indexer/staticIndexer.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./buildStaticGraph"), exports);
+//# sourceMappingURL=staticIndexer.js.map

package/lib/indexer/staticIndexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticIndexer.js","sourceRoot":"","sources":["../../src/indexer/staticIndexer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC"}

package/lib/indexer/supertypesOf.d.ts

@@ -0,0 +1,4 @@
+export declare function supertypesOf(rawDeclaration: string): Array<{
+    name: string;
+    relation: "extends" | "implements";
+}>;

package/lib/indexer/supertypesOf.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supertypesOf = supertypesOf;
+function supertypesOf(rawDeclaration) {
+    const out = [];
+    const declaration = rawDeclaration.replace(/^\s*(?:(?:export|public|private|protected|internal|abstract|final|open|sealed|static|data)\s+)+/, "");
+    const extendsMatch = /\bextends\s+([^{]+?)(?:\bimplements\b|\bwith\b|\{|$)/.exec(declaration);
+    if (extendsMatch !== null)
+        for (const name of splitTypeList(extendsMatch[1]))
+            out.push({ name, relation: "extends" });
+    const implementsMatch = /\b(?:implements|with)\s+([^{]+?)(?:\{|$)/.exec(declaration);
+    if (implementsMatch !== null)
+        for (const name of splitTypeList(implementsMatch[1]))
+            out.push({ name, relation: "implements" });
+    const pythonMatch = /^class\s+\w+\s*\(([^)]*)\)/.exec(declaration);
+    if (pythonMatch !== null)
+        for (const name of splitTypeList(pythonMatch[1]))
+            out.push({ name, relation: "extends" });
+    const rubyMatch = /^class\s+\w+\s*<\s*([A-Za-z_][\w.]*)/.exec(declaration);
+    if (rubyMatch !== null)
+        out.push({ name: rubyMatch[1], relation: "extends" });
+    if (out.length === 0) {
+        const colonMatch = /^(?:class|struct|interface)\s+\w+\s*:\s*([^{]+)/.exec(declaration);
+        if (colonMatch !== null)
+            for (const name of splitTypeList(colonMatch[1]))
+                out.push({ name, relation: "extends" });
+    }
+    return out;
+}
+function splitTypeList(text) {
+    const names = [];
+    for (const part of text.split(",")) {
+        // Skip Python keyword-argument bases (`metaclass=Meta`) and `*args`/`**kw`
+        // unpacking, which are not supertypes.
+        if (part.includes("=") || part.trim().startsWith("*"))
+            continue;
+        const cleaned = part
+            .trim()
+            .replace(/^(?:public|private|protected|virtual|final|open|sealed|abstract)\s+/, "")
+            .replace(/<[^>]*>/g, "")
+            .replace(/\(.*$/, "");
+        const match = /^[A-Za-z_][\w.]*/.exec(cleaned.trim());
+        if (match !== null)
+            names.push(match[0]);
+    }
+    return names;
+}
+//# sourceMappingURL=supertypesOf.js.map

package/lib/indexer/supertypesOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supertypesOf.js","sourceRoot":"","sources":["../../src/indexer/supertypesOf.ts"],"names":[],"mappings":";;;AAAA,sBACE,cAAsB;IAEtB,MAAM,GAAG,GAAgE,EAAE,CAAC;IAC5E,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CACxC,iGAAiG,EACjG,EAAE,CACH,CAAC;IACF,MAAM,YAAY,GAAG,sDAAsD,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9F,IAAI,YAAY,KAAK,IAAI;QACvB,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9F,MAAM,eAAe,GAAG,0CAA0C,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrF,IAAI,eAAe,KAAK,IAAI;QAC1B,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;IACpG,MAAM,WAAW,GAAG,4BAA4B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,WAAW,KAAK,IAAI;QACtB,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,sCAAsC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3E,IAAI,SAAS,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/E,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,iDAAiD,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvF,IAAI,UAAU,KAAK,IAAI;YACrB,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,2EAA2E;QAC3E,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAChE,MAAM,OAAO,GAAG,IAAI;aACjB,IAAI,EAAE;aACN,OAAO,CAAC,qEAAqE,EAAE,EAAE,CAAC;aAClF,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/lsp/DocumentSymbolResult.d.ts

@@ -0,0 +1,3 @@
+import { IDocumentSymbol } from "./IDocumentSymbol";
+import { ISymbolInformation } from "./ISymbolInformation";
+export type DocumentSymbolResult = Array<IDocumentSymbol | ISymbolInformation> | null;

package/lib/lsp/DocumentSymbolResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DocumentSymbolResult.js.map

package/lib/lsp/DocumentSymbolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentSymbolResult.js","sourceRoot":"","sources":["../../src/lsp/DocumentSymbolResult.ts"],"names":[],"mappings":""}

package/lib/lsp/IDiagnostic.d.ts

@@ -0,0 +1,8 @@
+import { IRange } from "./IRange";
+export interface IDiagnostic {
+    range: IRange;
+    severity?: number;
+    code?: string | number;
+    source?: string;
+    message: string;
+}

package/lib/lsp/IDiagnostic.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IDiagnostic.js.map

package/lib/lsp/IDiagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDiagnostic.js","sourceRoot":"","sources":["../../src/lsp/IDiagnostic.ts"],"names":[],"mappings":""}

package/lib/lsp/IDocumentSymbol.d.ts

@@ -0,0 +1,9 @@
+import { IRange } from "./IRange";
+export interface IDocumentSymbol {
+    name: string;
+    detail?: string;
+    kind: number;
+    range: IRange;
+    selectionRange: IRange;
+    children?: IDocumentSymbol[];
+}

package/lib/lsp/IDocumentSymbol.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IDocumentSymbol.js.map

package/lib/lsp/IDocumentSymbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDocumentSymbol.js","sourceRoot":"","sources":["../../src/lsp/IDocumentSymbol.ts"],"names":[],"mappings":""}

package/lib/lsp/ILocation.d.ts

@@ -0,0 +1,5 @@
+import { IRange } from "./IRange";
+export interface ILocation {
+    uri: string;
+    range: IRange;
+}

package/lib/lsp/ILocation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILocation.js.map

package/lib/lsp/ILocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILocation.js","sourceRoot":"","sources":["../../src/lsp/ILocation.ts"],"names":[],"mappings":""}

package/lib/lsp/IPosition.d.ts

@@ -0,0 +1,4 @@
+export interface IPosition {
+    line: number;
+    character: number;
+}

package/lib/lsp/IPosition.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPosition.js.map

package/lib/lsp/IPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPosition.js","sourceRoot":"","sources":["../../src/lsp/IPosition.ts"],"names":[],"mappings":""}

package/lib/lsp/IRange.d.ts

@@ -0,0 +1,5 @@
+import { IPosition } from "./IPosition";
+export interface IRange {
+    start: IPosition;
+    end: IPosition;
+}

package/lib/lsp/IRange.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IRange.js.map

package/lib/lsp/IRange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRange.js","sourceRoot":"","sources":["../../src/lsp/IRange.ts"],"names":[],"mappings":""}

package/lib/lsp/ISymbolInformation.d.ts

@@ -0,0 +1,7 @@
+import { ILocation } from "./ILocation";
+export interface ISymbolInformation {
+    name: string;
+    kind: number;
+    location: ILocation;
+    containerName?: string;
+}

package/lib/lsp/ISymbolInformation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISymbolInformation.js.map

package/lib/lsp/ISymbolInformation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISymbolInformation.js","sourceRoot":"","sources":["../../src/lsp/ISymbolInformation.ts"],"names":[],"mappings":""}

package/lib/lsp/LspClient.d.ts

@@ -0,0 +1,17 @@
+export declare class LspClient {
+    private readonly timeoutMs;
+    private readonly process;
+    private readonly pending;
+    private readonly events;
+    private buffer;
+    private nextId;
+    constructor(command: string, args: readonly string[], timeoutMs: number);
+    request<T>(method: string, params: unknown, timeoutMs?: number): Promise<T>;
+    notify(method: string, params: unknown): void;
+    onNotification(method: string, listener: (params: unknown) => void): void;
+    close(): Promise<void>;
+    private write;
+    private onData;
+    private handleMessage;
+    private rejectAll;
+}

package/lib/lsp/LspClient.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LspClient = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_events_1 = require("node:events");
+class LspClient {
+    timeoutMs;
+    process;
+    pending = new Map();
+    events = new node_events_1.EventEmitter();
+    buffer = Buffer.alloc(0);
+    nextId = 1;
+    constructor(command, args, timeoutMs) {
+        this.timeoutMs = timeoutMs;
+        this.process = (0, node_child_process_1.spawn)(command, [...args], {
+            stdio: "pipe",
+            windowsHide: true,
+        });
+        this.process.stdout.on("data", (chunk) => this.onData(chunk));
+        this.process.stderr.on("data", () => {
+            // Language servers often log noisy progress to stderr.
+        });
+        this.process.on("error", (error) => this.rejectAll(error));
+        this.process.on("exit", (code, signal) => {
+            this.rejectAll(new Error(`Language server exited (${code ?? "null"}, ${signal ?? "null"}).`));
+        });
+    }
+    async request(method, params, timeoutMs) {
+        const id = this.nextId++;
+        const payload = { jsonrpc: "2.0", id, method, params };
+        const promise = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`LSP request timed out: ${method}`));
+            }, timeoutMs ?? this.timeoutMs);
+            this.pending.set(id, {
+                resolve: (value) => resolve(value),
+                reject,
+                timer,
+            });
+        });
+        this.write(payload);
+        return promise;
+    }
+    notify(method, params) {
+        this.write({ jsonrpc: "2.0", method, params });
+    }
+    onNotification(method, listener) {
+        this.events.on(method, listener);
+    }
+    async close() {
+        try {
+            await this.request("shutdown", null);
+        }
+        catch {
+            // Some servers exit before answering shutdown.
+        }
+        /* c8 ignore start */
+        try {
+            this.notify("exit", null);
+        }
+        catch {
+            // Ignore close errors.
+        }
+        /* c8 ignore stop */
+        if (!this.process.killed)
+            this.process.kill();
+    }
+    write(payload) {
+        const body = Buffer.from(JSON.stringify(payload), "utf8");
+        const header = Buffer.from(`Content-Length: ${body.length}\r\n\r\n`, "ascii");
+        this.process.stdin.write(Buffer.concat([header, body]));
+    }
+    onData(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        for (;;) {
+            const headerEnd = this.buffer.indexOf("\r\n\r\n");
+            if (headerEnd < 0)
+                return;
+            const header = this.buffer.slice(0, headerEnd).toString("ascii");
+            const match = /Content-Length:\s*(\d+)/i.exec(header);
+            if (match === null) {
+                this.buffer = this.buffer.slice(headerEnd + 4);
+                continue;
+            }
+            const length = Number(match[1]);
+            const bodyStart = headerEnd + 4;
+            const bodyEnd = bodyStart + length;
+            if (this.buffer.length < bodyEnd)
+                return;
+            const body = this.buffer.slice(bodyStart, bodyEnd).toString("utf8");
+            this.buffer = this.buffer.slice(bodyEnd);
+            // A malformed frame must not throw out of the stdout `data` listener as an
+            // uncaught exception; drop it and keep draining the buffer.
+            let message;
+            try {
+                message = JSON.parse(body);
+            }
+            catch {
+                continue;
+            }
+            this.handleMessage(message);
+        }
+    }
+    handleMessage(message) {
+        // A server-initiated request carries both an id and a method. It must be
+        // answered or some servers block: gopls, for instance, withholds
+        // documentSymbol until its `window/workDoneProgress/create` request is
+        // acknowledged. A null result satisfies the acknowledgements we advertise.
+        if (message.id !== undefined && message.method !== undefined) {
+            this.write({ jsonrpc: "2.0", id: message.id, result: null });
+            return;
+        }
+        if (message.id !== undefined) {
+            const pending = this.pending.get(message.id);
+            if (pending === undefined)
+                return;
+            this.pending.delete(message.id);
+            clearTimeout(pending.timer);
+            if (message.error !== undefined) {
+                pending.reject(new Error(message.error.message ?? "LSP request failed."));
+            }
+            else {
+                pending.resolve(message.result);
+            }
+            return;
+        }
+        if (message.method !== undefined)
+            this.events.emit(message.method, message.params);
+    }
+    rejectAll(error) {
+        for (const [id, request] of this.pending) {
+            this.pending.delete(id);
+            clearTimeout(request.timer);
+            request.reject(error);
+        }
+    }
+}
+exports.LspClient = LspClient;
+//# sourceMappingURL=LspClient.js.map

package/lib/lsp/LspClient.js.map

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

package/lib/lsp/isDocumentSymbol.d.ts

@@ -0,0 +1,3 @@
+import { IDocumentSymbol } from "./IDocumentSymbol";
+import { ISymbolInformation } from "./ISymbolInformation";
+export declare function isDocumentSymbol(value: IDocumentSymbol | ISymbolInformation): value is IDocumentSymbol;

package/lib/lsp/isDocumentSymbol.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDocumentSymbol = isDocumentSymbol;
+function isDocumentSymbol(value) {
+    return "selectionRange" in value;
+}
+//# sourceMappingURL=isDocumentSymbol.js.map

package/lib/lsp/isDocumentSymbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDocumentSymbol.js","sourceRoot":"","sources":["../../src/lsp/isDocumentSymbol.ts"],"names":[],"mappings":";;;AAGA,0BACE,KAA2C;IAE3C,OAAO,gBAAgB,IAAI,KAAK,CAAC;AACnC,CAAC"}

package/lib/lsp/types.d.ts

@@ -0,0 +1,8 @@
+export * from "./DocumentSymbolResult";
+export * from "./IDiagnostic";
+export * from "./IDocumentSymbol";
+export * from "./ILocation";
+export * from "./IPosition";
+export * from "./IRange";
+export * from "./ISymbolInformation";
+export * from "./isDocumentSymbol";

package/lib/lsp/types.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./DocumentSymbolResult"), exports);
+__exportStar(require("./IDiagnostic"), exports);
+__exportStar(require("./IDocumentSymbol"), exports);
+__exportStar(require("./ILocation"), exports);
+__exportStar(require("./IPosition"), exports);
+__exportStar(require("./IRange"), exports);
+__exportStar(require("./ISymbolInformation"), exports);
+__exportStar(require("./isDocumentSymbol"), exports);
+//# sourceMappingURL=types.js.map

package/lib/lsp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lsp/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,gDAA8B;AAC9B,oDAAkC;AAClC,8CAA4B;AAC5B,8CAA4B;AAC5B,2CAAyB;AACzB,uDAAqC;AACrC,qDAAmC"}

package/lib/mcp/createServer.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AsyncSamchonGraphSource } from "../application";
+export declare function createServer(graph: AsyncSamchonGraphSource, version: string): McpServer;