@mneme-ai/core 0.8.3

package/dist/entities/python-parser.js

@@ -0,0 +1,248 @@
+/**
+ * Python entity parser.
+ *
+ * Strategy: spawn Python's own `ast` module via `python3 -c <script>` and read
+ * JSON back. Python ships everywhere a developer's machine runs Python code, so
+ * we lean on the runtime that's already there. This works for:
+ *
+ *   • Code from 10 years ago (Python 3.6+)
+ *   • Code written yesterday by a human
+ *   • Code generated by an AI assistant (most LLMs emit syntactically valid Python)
+ *
+ * If Python is not on PATH, the parser raises a clean error rather than guessing
+ * with regex. The TypeScript parser remains the default for TS/JS; this one
+ * activates per-file based on extension.
+ *
+ * Why not tree-sitter? Three reasons:
+ *   1. tree-sitter native binaries are platform-fragile on Windows.
+ *   2. The WASM build (`web-tree-sitter`) requires shipping a grammar `.wasm`
+ *      file and is fiddly to install.
+ *   3. Python's `ast` is the same AST CPython itself uses to compile your code.
+ *      It cannot be more accurate.
+ */
+import { createHash } from "node:crypto";
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { execGit } from "../git/exec.js";
+const PY_EXTENSIONS = new Set([".py", ".pyi"]);
+/**
+ * Embedded Python script. Reads source from stdin, emits a JSON list of
+ * entities to stdout. Stays under 2k chars so cli args / stdin don't strain.
+ */
+const PY_SCRIPT = String.raw `import sys, json, ast
+src = sys.stdin.read()
+try:
+    tree = ast.parse(src)
+except SyntaxError as e:
+    json.dump({"error": f"SyntaxError at line {e.lineno}: {e.msg}"}, sys.stdout)
+    sys.exit(0)
+
+def sig(node):
+    if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
+        args = [a.arg for a in node.args.args]
+        ret = ""
+        if node.returns is not None:
+            try:
+                ret = " -> " + ast.unparse(node.returns)
+            except Exception:
+                pass
+        prefix = "async def " if isinstance(node, ast.AsyncFunctionDef) else "def "
+        return f"{prefix}{node.name}({', '.join(args)}){ret}"
+    if isinstance(node, ast.ClassDef):
+        bases = []
+        for b in node.bases:
+            try:
+                bases.append(ast.unparse(b))
+            except Exception:
+                bases.append("?")
+        suffix = f"({', '.join(bases)})" if bases else ""
+        return f"class {node.name}{suffix}"
+    return ""
+
+out = []
+def is_module_level(parent):
+    return isinstance(parent, ast.Module)
+
+# Walk: top-level defs + class methods + module-level Assign that look like exports.
+for node in tree.body:
+    if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
+        out.append({
+            "kind": "function",
+            "name": node.name,
+            "startLine": node.lineno,
+            "endLine": getattr(node, "end_lineno", node.lineno) or node.lineno,
+            "signature": sig(node),
+        })
+    elif isinstance(node, ast.ClassDef):
+        out.append({
+            "kind": "class",
+            "name": node.name,
+            "startLine": node.lineno,
+            "endLine": getattr(node, "end_lineno", node.lineno) or node.lineno,
+            "signature": sig(node),
+        })
+        for sub in node.body:
+            if isinstance(sub, (ast.FunctionDef, ast.AsyncFunctionDef)):
+                out.append({
+                    "kind": "function",
+                    "name": f"{node.name}.{sub.name}",
+                    "startLine": sub.lineno,
+                    "endLine": getattr(sub, "end_lineno", sub.lineno) or sub.lineno,
+                    "signature": sig(sub),
+                })
+    elif isinstance(node, ast.Assign):
+        for t in node.targets:
+            if isinstance(t, ast.Name) and not t.id.startswith("_"):
+                out.append({
+                    "kind": "variable",
+                    "name": t.id,
+                    "startLine": node.lineno,
+                    "endLine": getattr(node, "end_lineno", node.lineno) or node.lineno,
+                    "signature": "",
+                })
+
+json.dump(out, sys.stdout)
+`;
+export class PythonParser {
+    name = "python-ast";
+    languages = ["python"];
+    pythonCmd = null;
+    /** Detect which Python binary works on this machine. */
+    async preload() {
+        if (this.pythonCmd)
+            return;
+        for (const cmd of ["python3", "python"]) {
+            const ok = await this.probe(cmd);
+            if (ok) {
+                this.pythonCmd = cmd;
+                return;
+            }
+        }
+        throw new Error("Python parser requires `python3` (or `python`) on PATH. Install Python 3.8+ to enable Python entity parsing.");
+    }
+    async *parseRepo(opts) {
+        await this.preload();
+        const files = await listPyFiles(opts.cwd, opts.paths);
+        let i = 0;
+        for (const relPath of files) {
+            i++;
+            let source;
+            try {
+                source = await readFile(join(opts.cwd, relPath), "utf8");
+            }
+            catch {
+                opts.onProgress?.(i);
+                continue;
+            }
+            try {
+                const entities = await this.parseSource(relPath, source);
+                for (const e of entities)
+                    yield e;
+            }
+            catch {
+                // best-effort — keep going on bad files
+            }
+            opts.onProgress?.(i);
+        }
+    }
+    parseFile(_filePath, _source) {
+        // Synchronous parse not supported (subprocess-based). Use parseRepo.
+        throw new Error("PythonParser.parseFile is not synchronous — call parseSourceAsync() or use parseRepo().");
+    }
+    async parseSourceAsync(filePath, source) {
+        await this.preload();
+        return this.parseSource(filePath, source);
+    }
+    async parseSource(filePath, source) {
+        const raw = await this.runPython(source);
+        if (!raw)
+            return [];
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+        if (parsed && typeof parsed === "object" && parsed.error) {
+            // Syntax error in the file — emit nothing. This is normal for partial files.
+            return [];
+        }
+        if (!Array.isArray(parsed))
+            return [];
+        const out = [];
+        for (const item of parsed) {
+            const kind = String(item.kind);
+            const name = String(item.name);
+            const startLine = Number(item.startLine);
+            const endLine = Number(item.endLine);
+            const signature = item.signature ? String(item.signature) : undefined;
+            if (!["function", "class", "variable"].includes(kind) || !name || !startLine)
+                continue;
+            out.push({
+                id: stableId(filePath, kind, name, startLine),
+                kind: kind,
+                name,
+                filePath,
+                startLine,
+                endLine,
+                signature,
+                language: "python",
+            });
+        }
+        return out;
+    }
+    runPython(source) {
+        return new Promise((resolve) => {
+            if (!this.pythonCmd)
+                return resolve("");
+            const child = spawn(this.pythonCmd, ["-c", PY_SCRIPT], { windowsHide: true });
+            const chunks = [];
+            child.stdout.on("data", (b) => chunks.push(b));
+            child.stderr.on("data", () => {
+                /* swallow — bad files happen, syntax errors come back as JSON */
+            });
+            child.on("error", () => resolve(""));
+            child.on("close", () => resolve(Buffer.concat(chunks).toString("utf8")));
+            child.stdin.end(source, "utf8");
+        });
+    }
+    probe(cmd) {
+        return new Promise((resolve) => {
+            const child = spawn(cmd, ["-c", "import sys; print(sys.version_info[0])"], {
+                windowsHide: true,
+            });
+            let out = "";
+            child.stdout.on("data", (b) => (out += b.toString()));
+            child.on("error", () => resolve(false));
+            child.on("close", (code) => {
+                resolve(code === 0 && out.trim().startsWith("3"));
+            });
+        });
+    }
+}
+async function listPyFiles(cwd, paths) {
+    const r = await execGit(["ls-files"], { cwd });
+    if (r.code !== 0)
+        return [];
+    const tracked = r.stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .filter((p) => PY_EXTENSIONS.has(extname(p).toLowerCase()))
+        .filter((p) => !/(^|\/)tests?\//.test(p))
+        .filter((p) => !/_test\.py$|\/test_/.test(p))
+        .filter((p) => !/(^|\/)(\.venv|venv|__pycache__|dist|build)\//.test(p));
+    if (!paths || paths.length === 0)
+        return tracked;
+    return tracked.filter((p) => paths.some((needle) => p === needle || p.startsWith(needle + "/")));
+}
+function stableId(filePath, kind, name, line) {
+    const h = createHash("sha1")
+        .update(`${filePath}|${kind}|${name}|${line}`)
+        .digest("hex")
+        .slice(0, 12);
+    return `e_${h}`;
+}
+//# sourceMappingURL=python-parser.js.map

package/dist/entities/python-parser.js.map

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

package/dist/entities/typescript-parser.d.ts

@@ -0,0 +1,18 @@
+import type { Entity } from "../types.js";
+import type { EntityParser, ParseOptions } from "./index.js";
+export declare class TypeScriptParser implements EntityParser {
+    readonly name = "typescript-compiler-api";
+    readonly languages: string[];
+    private ts;
+    parseRepo(opts: ParseOptions): AsyncIterable<Entity>;
+    parseFile(filePath: string, source: string): Iterable<Entity>;
+    /** Eager-load typescript so subsequent sync parseFile() calls work. */
+    preload(): Promise<void>;
+    private loadTs;
+    private parseSourceFileImpl;
+    private emitFromStatement;
+    private makeEntity;
+}
+/** For tests: build entity-embedding text from name + signature + signature-extracted body. */
+export declare function entityEmbeddingText(e: Entity, body?: string): string;
+//# sourceMappingURL=typescript-parser.d.ts.map

package/dist/entities/typescript-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-parser.d.ts","sourceRoot":"","sources":["../../src/entities/typescript-parser.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK7D,qBAAa,gBAAiB,YAAW,YAAY;IACnD,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,SAAS,WAA8C;IAGhE,OAAO,CAAC,EAAE,CAA4C;IAE/C,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC;IAsB3D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAW7D,uEAAuE;IACjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,MAAM;IAYpB,OAAO,CAAE,mBAAmB;IAmB5B,OAAO,CAAE,iBAAiB;IAiD1B,OAAO,CAAC,UAAU;CAwBnB;AAsFD,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpE"}

package/dist/entities/typescript-parser.js

@@ -0,0 +1,220 @@
+/**
+ * TypeScript / JavaScript entity parser.
+ *
+ * Uses the TypeScript compiler API (zero new runtime deps — `typescript` is
+ * a soft peer dep). Parses .ts / .tsx / .js / .jsx files into Entity records:
+ *
+ *   function declarations, class declarations, interface declarations,
+ *   type aliases, exported variable bindings, exported re-exports.
+ *
+ * Skips: nested closures, IIFEs, anonymous arrow functions assigned to non-
+ * exported variables. The goal is "things a human would consider a unit",
+ * not every AST node.
+ */
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { execGit } from "../git/exec.js";
+const TS_EXTENSIONS = new Set([".ts", ".tsx", ".mts", ".cts"]);
+const JS_EXTENSIONS = new Set([".js", ".jsx", ".mjs", ".cjs"]);
+export class TypeScriptParser {
+    name = "typescript-compiler-api";
+    languages = ["typescript", "tsx", "javascript", "jsx"];
+    // Lazy-loaded to keep `typescript` an optional peer dep.
+    ts = null;
+    async *parseRepo(opts) {
+        const ts = await this.loadTs();
+        const files = await listTsJsFiles(opts.cwd, opts.paths);
+        let processed = 0;
+        for (const relPath of files) {
+            const abs = join(opts.cwd, relPath);
+            let source;
+            try {
+                source = await readFile(abs, "utf8");
+            }
+            catch {
+                processed++;
+                continue;
+            }
+            const language = languageForPath(relPath);
+            for (const e of this.parseSourceFileImpl(relPath, source, language, ts)) {
+                yield e;
+            }
+            processed++;
+            opts.onProgress?.(processed);
+        }
+    }
+    parseFile(filePath, source) {
+        if (!this.ts) {
+            throw new Error("TypeScriptParser.parseFile() requires parseRepo to be called first " +
+                "(or call await parser['loadTs']() once). The peer dep `typescript` is loaded lazily.");
+        }
+        const language = languageForPath(filePath);
+        return this.parseSourceFileImpl(filePath, source, language, this.ts);
+    }
+    /** Eager-load typescript so subsequent sync parseFile() calls work. */
+    async preload() {
+        await this.loadTs();
+    }
+    async loadTs() {
+        if (this.ts)
+            return this.ts;
+        try {
+            this.ts = await import("typescript");
+            return this.ts;
+        }
+        catch {
+            throw new Error("TypeScriptParser requires the `typescript` package. Install it with: npm install --save-dev typescript");
+        }
+    }
+    *parseSourceFileImpl(filePath, source, language, ts) {
+        const sf = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, 
+        /* setParentNodes */ true, filePath.endsWith(".tsx") || filePath.endsWith(".jsx") ? ts.ScriptKind.TSX : undefined);
+        for (const node of sf.statements) {
+            yield* this.emitFromStatement(node, sf, filePath, language, ts);
+        }
+    }
+    *emitFromStatement(node, sf, filePath, language, ts) {
+        if (ts.isFunctionDeclaration(node) && node.name) {
+            yield this.makeEntity("function", node.name.text, node, sf, filePath, language, ts);
+            return;
+        }
+        if (ts.isClassDeclaration(node) && node.name) {
+            yield this.makeEntity("class", node.name.text, node, sf, filePath, language, ts);
+            return;
+        }
+        if (ts.isInterfaceDeclaration(node)) {
+            yield this.makeEntity("type", node.name.text, node, sf, filePath, language, ts);
+            return;
+        }
+        if (ts.isTypeAliasDeclaration(node)) {
+            yield this.makeEntity("type", node.name.text, node, sf, filePath, language, ts);
+            return;
+        }
+        if (ts.isVariableStatement(node)) {
+            // Only emit exported variables — anonymous internal bindings would create noise.
+            if (!hasModifier(node, ts.SyntaxKind.ExportKeyword, ts))
+                return;
+            for (const decl of node.declarationList.declarations) {
+                if (ts.isIdentifier(decl.name)) {
+                    // If the initializer is an arrow function or function expression, classify as function.
+                    const kind = decl.initializer &&
+                        (ts.isArrowFunction(decl.initializer) || ts.isFunctionExpression(decl.initializer))
+                        ? "function"
+                        : "variable";
+                    yield this.makeEntity(kind, decl.name.text, node, sf, filePath, language, ts);
+                }
+            }
+            return;
+        }
+        if (ts.isModuleDeclaration(node) && node.name && ts.isIdentifier(node.name)) {
+            yield this.makeEntity("module", node.name.text, node, sf, filePath, language, ts);
+            return;
+        }
+        if (ts.isEnumDeclaration(node)) {
+            yield this.makeEntity("type", node.name.text, node, sf, filePath, language, ts);
+            return;
+        }
+    }
+    makeEntity(kind, name, node, sf, filePath, language, ts) {
+        const start = sf.getLineAndCharacterOfPosition(node.getStart(sf, /*includeJsDoc*/ false));
+        const end = sf.getLineAndCharacterOfPosition(node.getEnd());
+        const signature = extractSignature(node, sf, ts);
+        const id = stableId(filePath, kind, name, start.line);
+        return {
+            id,
+            kind,
+            name,
+            filePath,
+            startLine: start.line + 1,
+            endLine: end.line + 1,
+            signature,
+            language,
+        };
+    }
+}
+/** Use git ls-files when available — automatic .gitignore respect. Fall back to filesystem walk. */
+async function listTsJsFiles(cwd, paths) {
+    const r = await execGit(["ls-files"], { cwd });
+    if (r.code !== 0) {
+        return [];
+    }
+    const all = r.stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+    const tracked = all.filter((p) => {
+        const ext = extname(p).toLowerCase();
+        if (!TS_EXTENSIONS.has(ext) && !JS_EXTENSIONS.has(ext))
+            return false;
+        // Skip type declaration files — they expose types but no implementation.
+        if (p.endsWith(".d.ts"))
+            return false;
+        // Skip tests by default — they tend to dominate clone clusters with assertion plumbing.
+        if (/(^|\/)tests?\//.test(p))
+            return false;
+        if (/\.(test|spec)\./.test(p))
+            return false;
+        return true;
+    });
+    if (!paths || paths.length === 0)
+        return tracked;
+    return tracked.filter((p) => paths.some((needle) => p === needle || p.startsWith(needle + "/")));
+}
+function languageForPath(p) {
+    const ext = extname(p).toLowerCase();
+    if (ext === ".ts" || ext === ".mts" || ext === ".cts")
+        return "typescript";
+    if (ext === ".tsx")
+        return "tsx";
+    if (ext === ".jsx")
+        return "jsx";
+    return "javascript";
+}
+function hasModifier(node, kind, ts) {
+    // `node.modifiers` is preferred but on some node kinds we still need ts.canHaveModifiers.
+    const mods = ts.canHaveModifiers?.(node)
+        ? ts.getModifiers(node)
+        : node.modifiers;
+    return Array.isArray(mods) && mods.some((m) => m.kind === kind);
+}
+function extractSignature(node, sf, ts) {
+    // For functions/methods grab everything up to the opening brace.
+    if (ts.isFunctionDeclaration(node) ||
+        ts.isMethodDeclaration(node) ||
+        ts.isFunctionExpression(node) ||
+        ts.isArrowFunction(node)) {
+        const text = node.getText(sf);
+        const braceIdx = text.indexOf("{");
+        return braceIdx >= 0 ? text.slice(0, braceIdx).trim() : text.trim().slice(0, 200);
+    }
+    if (ts.isClassDeclaration(node) && node.name) {
+        const text = node.getText(sf);
+        const braceIdx = text.indexOf("{");
+        return braceIdx >= 0 ? text.slice(0, braceIdx).trim() : text.trim().slice(0, 200);
+    }
+    if (ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node)) {
+        return node.getText(sf).slice(0, 200).trim();
+    }
+    if (ts.isVariableStatement(node)) {
+        return node.getText(sf).slice(0, 160).trim();
+    }
+    return node.getText(sf).slice(0, 120).trim();
+}
+function stableId(filePath, kind, name, line) {
+    const h = createHash("sha1")
+        .update(`${filePath}|${kind}|${name}|${line}`)
+        .digest("hex")
+        .slice(0, 12);
+    return `e_${h}`;
+}
+/** For tests: build entity-embedding text from name + signature + signature-extracted body. */
+export function entityEmbeddingText(e, body) {
+    const parts = [`${e.kind} ${e.name}`];
+    if (e.signature)
+        parts.push(e.signature);
+    if (body)
+        parts.push(body.slice(0, 600));
+    return parts.join("\n");
+}
+//# sourceMappingURL=typescript-parser.js.map

package/dist/entities/typescript-parser.js.map

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

package/dist/entities/typescript-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typescript-parser.test.d.ts.map

package/dist/entities/typescript-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-parser.test.d.ts","sourceRoot":"","sources":["../../src/entities/typescript-parser.test.ts"],"names":[],"mappings":""}

package/dist/entities/typescript-parser.test.js

@@ -0,0 +1,103 @@
+import { describe, it, expect, beforeAll } from "vitest";
+import { TypeScriptParser } from "./typescript-parser.js";
+let parser;
+beforeAll(async () => {
+    parser = new TypeScriptParser();
+    await parser.preload();
+});
+function parse(filePath, source) {
+    return Array.from(parser.parseFile(filePath, source));
+}
+describe("TypeScriptParser", () => {
+    it("extracts function declarations", () => {
+        const out = parse("x.ts", `
+      export function charge(amount: number): number {
+        return amount;
+      }
+    `);
+        expect(out).toHaveLength(1);
+        expect(out[0].kind).toBe("function");
+        expect(out[0].name).toBe("charge");
+        expect(out[0].signature).toContain("charge(amount: number): number");
+    });
+    it("extracts class declarations", () => {
+        const out = parse("x.ts", `
+      export class OrderQueue {
+        enqueue(x: any) {}
+      }
+    `);
+        const cls = out.find((e) => e.kind === "class");
+        expect(cls).toBeDefined();
+        expect(cls.name).toBe("OrderQueue");
+    });
+    it("extracts interfaces and type aliases as 'type'", () => {
+        const out = parse("x.ts", `
+      export interface User { id: string; }
+      export type Email = string;
+    `);
+        const kinds = out.filter((e) => e.kind === "type").map((e) => e.name);
+        expect(kinds).toContain("User");
+        expect(kinds).toContain("Email");
+    });
+    it("treats exported arrow functions as 'function' kind", () => {
+        const out = parse("x.ts", `export const handler = (x: number) => x + 1;`);
+        expect(out).toHaveLength(1);
+        expect(out[0].kind).toBe("function");
+        expect(out[0].name).toBe("handler");
+    });
+    it("treats exported plain values as 'variable' kind", () => {
+        const out = parse("x.ts", `export const VERSION = "0.2.0";`);
+        expect(out[0].kind).toBe("variable");
+        expect(out[0].name).toBe("VERSION");
+    });
+    it("does not emit non-exported variables", () => {
+        const out = parse("x.ts", `
+      const internal = 42;
+      export const exposed = 1;
+    `);
+        const names = out.map((e) => e.name);
+        expect(names).not.toContain("internal");
+        expect(names).toContain("exposed");
+    });
+    it("captures startLine and endLine accurately", () => {
+        const src = [
+            "// line 1",
+            "// line 2",
+            "export function foo() {",
+            "  return 1;",
+            "}",
+        ].join("\n");
+        const [foo] = parse("x.ts", src);
+        expect(foo.startLine).toBe(3);
+        expect(foo.endLine).toBe(5);
+    });
+    it("produces stable, file-specific ids", () => {
+        const a = parse("a.ts", "export function f() {}");
+        const b = parse("b.ts", "export function f() {}");
+        expect(a[0].id).not.toBe(b[0].id);
+        const a2 = parse("a.ts", "export function f() {}");
+        expect(a[0].id).toBe(a2[0].id);
+    });
+    it("handles TSX files", () => {
+        const out = parse("Component.tsx", `export function Button(props: { label: string }) {
+        return <button>{props.label}</button>;
+      }`);
+        expect(out).toHaveLength(1);
+        expect(out[0].language).toBe("tsx");
+    });
+    it("handles JS files", () => {
+        const out = parse("a.js", `export function add(a, b) { return a + b; }`);
+        expect(out[0].language).toBe("javascript");
+    });
+    it("extracts multiple top-level statements", () => {
+        const out = parse("x.ts", `
+      export function a() {}
+      export class B {}
+      export interface C {}
+      export const d = 1;
+      export const e = () => 2;
+    `);
+        expect(out.map((e) => e.name).sort()).toEqual(["B", "C", "a", "d", "e"]);
+    });
+});
+//# sourceMappingURL=typescript-parser.test.js.map

package/dist/entities/typescript-parser.test.js.map

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

package/dist/git/blame.d.ts

@@ -0,0 +1,9 @@
+export interface BlameLine {
+    commitHash: string;
+    authorName: string;
+    authorTime: number;
+    lineNumber: number;
+    content: string;
+}
+export declare function blame(cwd: string, filePath: string, startLine?: number, endLine?: number): Promise<BlameLine[]>;
+//# sourceMappingURL=blame.d.ts.map

package/dist/git/blame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.d.ts","sourceRoot":"","sources":["../../src/git/blame.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,EAAE,CAAC,CAQtB"}