@shvmgyl15/tsgraph 0.1.0

package/dist/parser/parser.test.d.ts

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

package/dist/parser/parser.test.d.ts.map

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

package/dist/parser/parser.test.js

@@ -0,0 +1,225 @@
+import { describe, it, expect } from "vitest";
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { scanFiles } from "../scanner/index.js";
+import { parseProject } from "./index.js";
+function createTempDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), "tsgraph-test-"));
+}
+function writeFile(dir, relativePath, content) {
+    const fullPath = path.join(dir, relativePath);
+    fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+    fs.writeFileSync(fullPath, content, "utf-8");
+}
+describe("parseProject", () => {
+    it("extracts functions from a TypeScript file", () => {
+        const dir = createTempDir();
+        writeFile(dir, "index.ts", `
+export function greet(name: string): string {
+  return "Hello " + name;
+}
+
+function helper() {
+  return 42;
+}
+`);
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        expect(graph.symbols).toHaveLength(2);
+        const greet = graph.symbols.find((s) => s.name === "greet");
+        expect(greet).toBeTruthy();
+        expect(greet.kind).toBe("function");
+        expect(greet.isExported).toBe(true);
+        expect(greet.file).toBe("index.ts");
+        const helper = graph.symbols.find((s) => s.name === "helper");
+        expect(helper).toBeTruthy();
+        expect(helper.kind).toBe("function");
+        expect(helper.isExported).toBe(false);
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("extracts classes with methods", () => {
+        const dir = createTempDir();
+        writeFile(dir, "user.ts", `
+export class User {
+  name: string;
+
+  constructor(name: string) {
+    this.name = name;
+  }
+
+  greet(): string {
+    return "Hi " + this.name;
+  }
+}
+`);
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        const cls = graph.symbols.find((s) => s.name === "User");
+        expect(cls).toBeTruthy();
+        expect(cls.kind).toBe("class");
+        expect(cls.isExported).toBe(true);
+        const greet = graph.symbols.find((s) => s.name === "greet");
+        expect(greet).toBeTruthy();
+        expect(greet.kind).toBe("method");
+        expect(greet.receiver).toBe("User");
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("extracts interfaces and type aliases", () => {
+        const dir = createTempDir();
+        writeFile(dir, "types.ts", `
+export interface Props {
+  name: string;
+  age?: number;
+}
+
+export type Status = "active" | "inactive";
+
+type Internal = number;
+`);
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        expect(graph.symbols).toHaveLength(3);
+        const props = graph.symbols.find((s) => s.name === "Props");
+        expect(props).toBeTruthy();
+        expect(props.kind).toBe("interface");
+        expect(props.isExported).toBe(true);
+        const status = graph.symbols.find((s) => s.name === "Status");
+        expect(status).toBeTruthy();
+        expect(status.kind).toBe("type_alias");
+        expect(status.isExported).toBe(true);
+        const internal = graph.symbols.find((s) => s.name === "Internal");
+        expect(internal).toBeTruthy();
+        expect(internal.kind).toBe("type_alias");
+        expect(internal.isExported).toBe(false);
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("extracts enums", () => {
+        const dir = createTempDir();
+        writeFile(dir, "enums.ts", `
+export enum Color {
+  Red,
+  Green,
+  Blue,
+}
+`);
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        const color = graph.symbols.find((s) => s.name === "Color");
+        expect(color).toBeTruthy();
+        expect(color.kind).toBe("enum");
+        expect(color.isExported).toBe(true);
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("extracts const and var declarations", () => {
+        const dir = createTempDir();
+        writeFile(dir, "vars.ts", `
+export const MAX = 100;
+const TIMEOUT = 5000;
+var name = "test";
+`);
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        const max = graph.symbols.find((s) => s.name === "MAX");
+        expect(max).toBeTruthy();
+        expect(max.kind).toBe("const");
+        expect(max.isExported).toBe(true);
+        const timeout = graph.symbols.find((s) => s.name === "TIMEOUT");
+        expect(timeout).toBeTruthy();
+        expect(timeout.kind).toBe("const");
+        expect(timeout.isExported).toBe(false);
+        const n = graph.symbols.find((s) => s.name === "name");
+        expect(n).toBeTruthy();
+        expect(n.kind).toBe("var");
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("extracts call expressions within function bodies", () => {
+        const dir = createTempDir();
+        writeFile(dir, "lib.ts", `
+export function log(msg: string) {
+  console.log(msg);
+}
+
+export function process() {
+  log("starting");
+  Math.random();
+}
+`);
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        // process calls log and Math.random
+        const processCalls = graph.calls.filter((c) => c.callerName === "process");
+        expect(processCalls.length).toBeGreaterThanOrEqual(2);
+        expect(processCalls.some((c) => c.calleeRaw === "log")).toBe(true);
+        expect(processCalls.some((c) => c.calleeRaw === "Math.random")).toBe(true);
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("extracts imports", () => {
+        const dir = createTempDir();
+        writeFile(dir, "main.ts", `
+import React, { useState } from "react";
+import { z } from "zod";
+import fs from "node:fs";
+`);
+        writeFile(dir, "package.json", JSON.stringify({
+            name: "test-project",
+            dependencies: { react: "^18", zod: "^3" },
+        }));
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        expect(graph.imports.length).toBeGreaterThanOrEqual(3);
+        const reactDefault = graph.imports.find((i) => i.importPath === "react" && i.alias === "React");
+        expect(reactDefault).toBeTruthy();
+        expect(reactDefault.isDefault).toBe(true);
+        const useState = graph.imports.find((i) => i.importPath === "react" && i.alias === "useState");
+        expect(useState).toBeTruthy();
+        expect(useState.isDefault).toBe(false);
+        const zodImport = graph.imports.find((i) => i.importPath === "zod" && i.alias === "z");
+        expect(zodImport).toBeTruthy();
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("reads dependencies from package.json", () => {
+        const dir = createTempDir();
+        writeFile(dir, "index.ts", `export const x = 1;`);
+        writeFile(dir, "package.json", JSON.stringify({
+            name: "my-app",
+            dependencies: { react: "^18" },
+            devDependencies: { vitest: "^1" },
+        }));
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        expect(graph.dependencies).toHaveLength(2);
+        expect(graph.dependencies.some((d) => d.module === "react")).toBe(true);
+        expect(graph.dependencies.some((d) => d.module === "vitest")).toBe(true);
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("creates file nodes for all scanned files", () => {
+        const dir = createTempDir();
+        writeFile(dir, "src/index.ts", "");
+        writeFile(dir, "src/util.ts", "");
+        writeFile(dir, "data.json", "{}");
+        writeFile(dir, "style.css", "body{}");
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        expect(graph.files).toHaveLength(4);
+        const paths = graph.files.map((f) => f.path).sort();
+        expect(paths).toContain("data.json");
+        expect(paths).toContain("style.css");
+        expect(paths).toContain("src/index.ts");
+        expect(paths).toContain("src/util.ts");
+        fs.rmSync(dir, { recursive: true });
+    });
+    it("handles empty project with no .ts files", () => {
+        const dir = createTempDir();
+        writeFile(dir, "README.md", "# Hello");
+        const { files } = scanFiles(dir);
+        const graph = parseProject(dir, files);
+        expect(graph.symbols).toHaveLength(0);
+        expect(graph.calls).toHaveLength(0);
+        expect(graph.imports).toHaveLength(0);
+        expect(graph.files).toHaveLength(1);
+        expect(graph.packages).toHaveLength(1);
+        fs.rmSync(dir, { recursive: true });
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/parser/parser.test.js.map

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

package/dist/plan/index.d.ts

@@ -0,0 +1,32 @@
+import type { Graph, SymbolNode } from "../graph/types.js";
+import type { ChangedFile } from "../git/index.js";
+export interface PlannedChange {
+    files: string[];
+    symbols: string[];
+}
+export interface PlanResult {
+    changes: PlannedChange;
+    affectedCallers: {
+        symbol: SymbolNode;
+        callerCount: number;
+    }[];
+    affectedFiles: string[];
+    summary: string;
+}
+export interface ReviewFinding {
+    type: "orphan" | "boundary" | "changed_export";
+    detail: string;
+}
+export interface ReviewResult {
+    changes: {
+        path: string;
+        status: ChangedFile["status"];
+    }[];
+    findings: ReviewFinding[];
+    totalChanges: number;
+    totalFindings: number;
+    summary: string;
+}
+export declare function generatePlan(graph: Graph, files: string[], symbols?: string[]): PlanResult;
+export declare function generateReview(graph: Graph, rootDir: string, base?: string): ReviewResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,gBAAgB,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;KAAE,EAAE,CAAC;IAC3D,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,MAAM,EAAO,GACrB,UAAU,CAiDZ;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAe,GACpB,YAAY,CAkEd"}

package/dist/plan/index.js

@@ -0,0 +1,107 @@
+import { findCallers } from "../search/index.js";
+import { getDiffFiles, isGitRepo } from "../git/index.js";
+import { checkBoundaries, loadBoundariesConfig } from "../boundaries/index.js";
+function symbolsInFile(graph, filePath) {
+    return graph.symbols.filter((s) => s.file === filePath);
+}
+export function generatePlan(graph, files, symbols = []) {
+    const allSymbolNames = new Set(symbols);
+    for (const f of files) {
+        for (const sym of symbolsInFile(graph, f)) {
+            allSymbolNames.add(sym.name);
+        }
+    }
+    const callersMap = new Map();
+    for (const symName of allSymbolNames) {
+        const sym = graph.symbols.find((s) => s.name === symName);
+        if (!sym)
+            continue;
+        const callers = findCallers(graph, sym.name);
+        callersMap.set(symName, {
+            symbol: sym,
+            callerCount: callers.length,
+        });
+    }
+    const affectedFiles = new Set();
+    for (const [_, info] of callersMap) {
+        affectedFiles.add(info.symbol.file);
+        const callers = findCallers(graph, info.symbol.name);
+        for (const c of callers) {
+            affectedFiles.add(c.callerSymbol.file);
+        }
+    }
+    for (const f of files) {
+        affectedFiles.add(f);
+    }
+    const totalAffected = callersMap.size;
+    const totalCallers = [...callersMap.values()].reduce((sum, c) => sum + c.callerCount, 0);
+    const summary = `Plan: ${files.length} file(s), ${allSymbolNames.size} symbol(s) changed. ` +
+        `Affects ${totalAffected} symbol(s) with ${totalCallers} total caller(s) across ${affectedFiles.size} file(s).`;
+    return {
+        changes: { files, symbols: [...allSymbolNames] },
+        affectedCallers: [...callersMap.values()],
+        affectedFiles: [...affectedFiles],
+        summary,
+    };
+}
+export function generateReview(graph, rootDir, base = "main") {
+    const findings = [];
+    if (!isGitRepo(rootDir)) {
+        return {
+            changes: [],
+            findings: [],
+            totalChanges: 0,
+            totalFindings: 0,
+            summary: "Not a git repository — cannot review.",
+        };
+    }
+    const diffFiles = getDiffFiles(rootDir, base);
+    const changedPaths = new Set(diffFiles.map((d) => d.path));
+    for (const f of diffFiles) {
+        const fileSyms = symbolsInFile(graph, f.path);
+        for (const sym of fileSyms) {
+            if (f.status === "added") {
+                const callers = findCallers(graph, sym.id);
+                if (callers.length === 0 && !sym.name.startsWith("_")) {
+                    findings.push({
+                        type: "orphan",
+                        detail: `${sym.kind} ${sym.name} in ${sym.file}:${sym.line} — new symbol has no callers`,
+                    });
+                }
+            }
+            if (f.status === "modified" || f.status === "added") {
+                if (sym.isExported) {
+                    findings.push({
+                        type: "changed_export",
+                        detail: `${sym.isExported ? "exported " : ""}${sym.kind} ${sym.name} in ${sym.file}:${sym.line} — public API change`,
+                    });
+                }
+            }
+        }
+    }
+    const boundariesConfig = loadBoundariesConfig(rootDir);
+    if (boundariesConfig) {
+        const result = checkBoundaries(graph, boundariesConfig);
+        for (const v of result.violations) {
+            if (changedPaths.has(v.fromFile) || changedPaths.has(v.toFile)) {
+                findings.push({
+                    type: "boundary",
+                    detail: `${v.fromFile} → ${v.toFile}: ${v.rule}`,
+                });
+            }
+        }
+    }
+    const summary = `Review: ${diffFiles.length} file(s) changed vs "${base}". ` +
+        `${findings.length} finding(s): ` +
+        `${findings.filter((f) => f.type === "orphan").length} orphan(s), ` +
+        `${findings.filter((f) => f.type === "changed_export").length} changed export(s), ` +
+        `${findings.filter((f) => f.type === "boundary").length} boundary violation(s).`;
+    return {
+        changes: diffFiles,
+        findings,
+        totalChanges: diffFiles.length,
+        totalFindings: findings.length,
+        summary,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/plan/index.js.map

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

package/dist/plan/index.test.d.ts

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

package/dist/plan/index.test.d.ts.map

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

package/dist/plan/index.test.js

@@ -0,0 +1,143 @@
+import { describe, it, expect } from "vitest";
+import { makeGraph, makeSymbolNode, makeFileNode, makeCallEdge, } from "../graph/types.js";
+import { generatePlan, generateReview } from "./index.js";
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { execSync } from "node:child_process";
+function createGitRepo() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "tsgraph-plan-"));
+    execSync("git init", { cwd: dir, stdio: "pipe" });
+    execSync('git config user.email "test@test.com"', { cwd: dir, stdio: "pipe" });
+    execSync('git config user.name "Test"', { cwd: dir, stdio: "pipe" });
+    return dir;
+}
+function writeFile(root, relPath, content) {
+    const fullPath = path.join(root, relPath);
+    fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+    fs.writeFileSync(fullPath, content, "utf-8");
+}
+describe("generatePlan", () => {
+    it("returns summary for given files and symbols", () => {
+        const graph = makeGraph({
+            files: [
+                makeFileNode({ path: "src/util.ts", packageName: "app" }),
+                makeFileNode({ path: "src/index.ts", packageName: "app" }),
+            ],
+            symbols: [
+                makeSymbolNode({
+                    id: "src/util.ts::helper",
+                    name: "helper",
+                    kind: "function",
+                    file: "src/util.ts",
+                    packageName: "app",
+                    line: 1,
+                    endLine: 5,
+                    isExported: true,
+                }),
+                makeSymbolNode({
+                    id: "src/index.ts::main",
+                    name: "main",
+                    kind: "function",
+                    file: "src/index.ts",
+                    packageName: "app",
+                    line: 10,
+                    endLine: 15,
+                    isExported: true,
+                }),
+            ],
+            calls: [
+                makeCallEdge({
+                    callerSymbolId: "src/index.ts::main",
+                    callerName: "main",
+                    calleeRaw: "helper",
+                    file: "src/index.ts",
+                    line: 11,
+                }),
+            ],
+            imports: [],
+        });
+        const result = generatePlan(graph, ["src/util.ts"], []);
+        expect(result.changes.files).toContain("src/util.ts");
+        expect(result.affectedFiles).toContain("src/util.ts");
+        expect(result.affectedFiles).toContain("src/index.ts");
+        expect(result.summary).toContain("1 symbol(s) changed");
+    });
+    it("handles explicit symbols", () => {
+        const graph = makeGraph({
+            files: [makeFileNode({ path: "src/lib.ts", packageName: "app" })],
+            symbols: [
+                makeSymbolNode({
+                    id: "src/lib.ts::foo",
+                    name: "foo",
+                    kind: "function",
+                    file: "src/lib.ts",
+                    packageName: "app",
+                    line: 1,
+                    endLine: 3,
+                    isExported: true,
+                }),
+            ],
+            calls: [],
+            imports: [],
+        });
+        const result = generatePlan(graph, [], ["foo"]);
+        expect(result.changes.symbols).toContain("foo");
+        expect(result.summary).toContain("1 symbol(s) changed");
+    });
+});
+describe("generateReview", () => {
+    it("returns empty result if not a git repo", () => {
+        const graph = makeGraph({ files: [], symbols: [], imports: [] });
+        const result = generateReview(graph, "/tmp/nonexistent");
+        expect(result.totalChanges).toBe(0);
+        expect(result.summary).toContain("Not a git repository");
+    });
+    it("finds findings for changed files", () => {
+        const dir = createGitRepo();
+        writeFile(dir, "src/index.ts", 'export const x = 1;\n');
+        execSync("git add . && git commit -m 'initial'", { cwd: dir, stdio: "pipe" });
+        writeFile(dir, "src/new.ts", 'export const y = 2;\n');
+        execSync("git add . && git commit -m 'add new'", { cwd: dir, stdio: "pipe" });
+        const graph = makeGraph({
+            files: [
+                makeFileNode({ path: "src/index.ts", packageName: "app" }),
+                makeFileNode({ path: "src/new.ts", packageName: "app" }),
+            ],
+            symbols: [
+                makeSymbolNode({
+                    id: "src/index.ts::x",
+                    name: "x",
+                    kind: "const",
+                    file: "src/index.ts",
+                    packageName: "app",
+                    line: 1,
+                    endLine: 1,
+                    isExported: true,
+                }),
+                makeSymbolNode({
+                    id: "src/new.ts::y",
+                    name: "y",
+                    kind: "const",
+                    file: "src/new.ts",
+                    packageName: "app",
+                    line: 1,
+                    endLine: 1,
+                    isExported: true,
+                }),
+            ],
+            calls: [],
+            imports: [],
+        });
+        const result = generateReview(graph, dir, "HEAD~1");
+        expect(result.totalChanges).toBeGreaterThanOrEqual(1);
+        expect(result.findings.length).toBeGreaterThanOrEqual(1);
+        const orphan = result.findings.find((f) => f.type === "orphan");
+        expect(orphan).toBeTruthy();
+        expect(orphan.detail).toContain("y");
+        const changedExport = result.findings.find((f) => f.type === "changed_export");
+        expect(changedExport).toBeTruthy();
+        fs.rmSync(dir, { recursive: true });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/plan/index.test.js.map

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

package/dist/report/index.d.ts

@@ -0,0 +1,9 @@
+import type { Graph } from "../graph/types.js";
+export interface ReportOptions {
+    rootDir?: string;
+    includeBoundaries?: boolean;
+    includeStale?: boolean;
+    includeHotspots?: boolean;
+}
+export declare function generateReport(graph: Graph, opts?: ReportOptions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/report/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAO/C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAiH7E"}