@lzehrung/codegraph 2.1.0

package/dist/util/discoveryPath.js

@@ -0,0 +1,19 @@
+import path from "node:path";
+import { normalizePath } from "./paths.js";
+export function isRelativePathInside(relativePath) {
+    const normalized = normalizePath(relativePath);
+    return (!!normalized &&
+        normalized !== ".." &&
+        !normalized.startsWith("../") &&
+        !path.isAbsolute(relativePath) &&
+        !path.win32.isAbsolute(relativePath) &&
+        !path.posix.isAbsolute(relativePath));
+}
+export function matchesDiscoveryGlob(absolutePath, projectRoot, matcher) {
+    const relativePath = path.relative(projectRoot, absolutePath);
+    if (!isRelativePathInside(relativePath)) {
+        return false;
+    }
+    return matcher(normalizePath(relativePath));
+}
+//# sourceMappingURL=discoveryPath.js.map

package/dist/util/discoveryPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoveryPath.js","sourceRoot":"","sources":["../../src/util/discoveryPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC/C,OAAO,CACL,CAAC,CAAC,UAAU;QACZ,UAAU,KAAK,IAAI;QACnB,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAC7B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAC9B,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC;QACpC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,WAAmB,EACnB,OAA0C;IAE1C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/util/errors.d.ts

@@ -0,0 +1,3 @@
+/** Extract a human-readable message from an unknown thrown value. */
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/util/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD"}

package/dist/util/errors.js

@@ -0,0 +1,7 @@
+/** Extract a human-readable message from an unknown thrown value. */
+export function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/util/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/util/git.d.ts

@@ -0,0 +1,79 @@
+import { type LogLevel } from "../logging.js";
+/**
+ * Default wall-clock budget for a single Git child.
+ * Long enough for ordinary local repos; short enough that a locked network FS or
+ * hung credential helper cannot pin an MCP request indefinitely.
+ */
+export declare const DEFAULT_GIT_TIMEOUT_MS = 30000;
+/** Test-only override of the Git executable path. Pass null to restore. */
+export declare function setGitExecutableForTests(executable: string | null): void;
+export type RunGitOptions = {
+    timeoutMs?: number | undefined;
+    signal?: AbortSignal | undefined;
+    maxBuffer?: number | undefined;
+    input?: string | undefined;
+    /** Test hook: observe the spawned child (e.g. to assert timeout kill). */
+    onSpawn?: ((child: {
+        pid?: number;
+    }) => void) | undefined;
+};
+/** Test-only: drop memoized `isGitRepo` promises. */
+export declare function clearGitRepositoryCheckCacheForTests(): void;
+/**
+ * Central bounded Git execution: timeout + optional AbortSignal, always kills the child.
+ * Preserves stderr/stdout in rejection messages for diagnosis.
+ */
+export declare function runGit(projectRoot: string, args: string[], options?: RunGitOptions): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function isGitWorktreeSentinel(value: string): boolean;
+export declare function isGitIndexSentinel(value: string): boolean;
+export declare function assertSafeRevision(value: string, label: string): string;
+export declare function gitDiffArgs(base: string, head: string, extraArgs?: string[]): string[];
+export declare function getGitHead(projectRoot: string): Promise<string | null>;
+export declare function isGitRepo(projectRoot: string): Promise<boolean>;
+export declare function isGitPathTracked(projectRoot: string, file: string): Promise<boolean>;
+export declare function isGitPathIgnored(projectRoot: string, file: string): Promise<boolean>;
+export declare function getGitBlobHashes(projectRoot: string, files: string[], opts?: {
+    gitAvailable?: boolean;
+    logLevel?: LogLevel;
+}): Promise<Map<string, string>>;
+/**
+ * List files changed in Git.
+ * - base/head: compares commits in the explicit range `${base}..${head ?? "HEAD"}`.
+ *   WORKTREE compares base to the working tree, and STAGED/INDEX compares base to the index.
+ * - changedSince: runs `git diff <rev>` (that revision vs current working tree/index).
+ */
+export declare function listChangedFiles(projectRoot: string, opts: {
+    changedSince?: string | undefined;
+    base?: string | undefined;
+    head?: string | undefined;
+}): Promise<string[]>;
+/**
+ * List files in the working tree that Git does not track (new, uncommitted files).
+ *
+ * Used to cheaply detect newly created project files without a full recursive
+ * directory scan: combined with tracked manifest entries and a commit-range
+ * diff, it lets incremental builds stay correct without re-walking the tree.
+ * `respectGitignore` mirrors Git's own `--exclude-standard`; pass `false` only
+ * when the caller intentionally wants gitignored files included. Callers still
+ * need to apply their own project-pattern, ignore, and realpath confinement
+ * checks before treating these paths as indexable project files.
+ */
+export declare function listUntrackedFiles(projectRoot: string, opts?: {
+    gitAvailable?: boolean;
+    respectGitignore?: boolean;
+}): Promise<string[]>;
+/**
+ * Get unified diff text from Git.
+ * - base/head: compares commits in the explicit range `${base}..${head ?? "HEAD"}`.
+ *   WORKTREE compares base to the working tree, and STAGED/INDEX compares base to the index.
+ * - changedSince: runs `git diff <rev>` (that revision vs current working tree/index).
+ */
+export declare function getUnifiedDiff(projectRoot: string, opts: {
+    changedSince?: string | undefined;
+    base?: string | undefined;
+    head?: string | undefined;
+}): Promise<string>;
+//# sourceMappingURL=git.d.ts.map

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

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

package/dist/util/git.js

@@ -0,0 +1,403 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { stringifyUnknown } from "./ast.js";
+import { normalizePath } from "./paths.js";
+import { logWithLevel } from "../logging.js";
+/**
+ * Default wall-clock budget for a single Git child.
+ * Long enough for ordinary local repos; short enough that a locked network FS or
+ * hung credential helper cannot pin an MCP request indefinitely.
+ */
+export const DEFAULT_GIT_TIMEOUT_MS = 30_000;
+const gitRepositoryChecks = new Map();
+let gitExecutableForTests = null;
+/** Test-only override of the Git executable path. Pass null to restore. */
+export function setGitExecutableForTests(executable) {
+    gitExecutableForTests = executable;
+}
+/** Test-only: drop memoized `isGitRepo` promises. */
+export function clearGitRepositoryCheckCacheForTests() {
+    gitRepositoryChecks.clear();
+}
+function resolveGitTimeoutMs(timeoutMs) {
+    if (typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs > 0) {
+        return Math.floor(timeoutMs);
+    }
+    return DEFAULT_GIT_TIMEOUT_MS;
+}
+function killGitChild(child) {
+    if (child.killed || child.exitCode !== null)
+        return;
+    try {
+        child.kill("SIGTERM");
+    }
+    catch {
+        // ignore
+    }
+    // Escalate if the child ignores SIGTERM (common on Windows for hung helpers).
+    setTimeout(() => {
+        if (child.killed || child.exitCode !== null)
+            return;
+        try {
+            child.kill("SIGKILL");
+        }
+        catch {
+            // ignore
+        }
+    }, 1_000).unref?.();
+}
+/**
+ * Central bounded Git execution: timeout + optional AbortSignal, always kills the child.
+ * Preserves stderr/stdout in rejection messages for diagnosis.
+ */
+export async function runGit(projectRoot, args, options) {
+    const timeoutMs = resolveGitTimeoutMs(options?.timeoutMs);
+    const maxBuffer = options?.maxBuffer ?? 64 * 1024 * 1024;
+    const executable = gitExecutableForTests ?? "git";
+    const signal = options?.signal;
+    if (signal?.aborted) {
+        throw createGitError(projectRoot, args, new Error("aborted before start"));
+    }
+    return await new Promise((resolve, reject) => {
+        const child = spawn(executable, args, {
+            cwd: projectRoot,
+            env: process.env,
+            stdio: [options?.input !== undefined ? "pipe" : "ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        options?.onSpawn?.(child.pid === undefined ? {} : { pid: child.pid });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        let timedOut = false;
+        let aborted = false;
+        let totalBytes = 0;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+            fn();
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killGitChild(child);
+        }, timeoutMs);
+        timer.unref?.();
+        const onAbort = () => {
+            aborted = true;
+            killGitChild(child);
+        };
+        if (signal)
+            signal.addEventListener("abort", onAbort, { once: true });
+        const stdoutStream = child.stdout;
+        const stderrStream = child.stderr;
+        if (!stdoutStream || !stderrStream) {
+            killGitChild(child);
+            settle(() => reject(createGitError(projectRoot, args, new Error("git child missing stdio pipes"))));
+            return;
+        }
+        stdoutStream.on("data", (chunk) => {
+            const textChunk = typeof chunk === "string" ? chunk : chunk.toString();
+            totalBytes += Buffer.byteLength(textChunk, "utf8");
+            if (totalBytes > maxBuffer) {
+                killGitChild(child);
+                settle(() => reject(createGitError(projectRoot, args, new Error(`stdout exceeded maxBuffer (${maxBuffer} bytes)`))));
+                return;
+            }
+            stdout += textChunk;
+        });
+        stderrStream.on("data", (chunk) => {
+            stderr += typeof chunk === "string" ? chunk : chunk.toString();
+        });
+        child.on("error", (error) => {
+            settle(() => reject(createGitError(projectRoot, args, error)));
+        });
+        child.on("close", (code, signalName) => {
+            settle(() => {
+                if (timedOut) {
+                    reject(createGitError(projectRoot, args, new Error(`timed out after ${timeoutMs}ms${stderr ? `: ${stderr.trim()}` : ""}`)));
+                    return;
+                }
+                if (aborted) {
+                    reject(createGitError(projectRoot, args, new Error(`aborted${stderr ? `: ${stderr.trim()}` : ""}`)));
+                    return;
+                }
+                if (code !== 0) {
+                    reject(new Error(`git ${args.join(" ")} failed (${code ?? signalName ?? "unknown"}): ${stderr || stdout || "unknown error"}`));
+                    return;
+                }
+                resolve({ stdout, stderr });
+            });
+        });
+        if (options?.input !== undefined) {
+            if (!child.stdin) {
+                killGitChild(child);
+                settle(() => reject(createGitError(projectRoot, args, new Error("git child missing stdin pipe"))));
+                return;
+            }
+            child.stdin.write(options.input);
+            child.stdin.end();
+        }
+    });
+}
+async function runGitCollectStdout(projectRoot, args) {
+    const { stdout } = await runGit(projectRoot, args);
+    return stdout;
+}
+export function isGitWorktreeSentinel(value) {
+    return value.toUpperCase() === "WORKTREE";
+}
+export function isGitIndexSentinel(value) {
+    const normalized = value.toUpperCase();
+    return normalized === "INDEX" || normalized === "STAGED";
+}
+const UNSAFE_REVISION_CHARACTERS = /[\0\r\n]/;
+export function assertSafeRevision(value, label) {
+    if (UNSAFE_REVISION_CHARACTERS.test(value)) {
+        throw new Error(`Invalid ${label}: revisions must not contain NUL or newline characters.`);
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`Invalid ${label}: revision must not be empty.`);
+    }
+    if (trimmed.startsWith("-")) {
+        throw new Error(`Invalid ${label} "${trimmed}": revisions must not start with "-".`);
+    }
+    return trimmed;
+}
+export function gitDiffArgs(base, head, extraArgs = []) {
+    const safeBase = assertSafeRevision(base, "base");
+    if (isGitWorktreeSentinel(head)) {
+        return ["diff", ...extraArgs, "--end-of-options", safeBase];
+    }
+    if (isGitIndexSentinel(head)) {
+        return ["diff", "--cached", ...extraArgs, "--end-of-options", safeBase];
+    }
+    const safeHead = assertSafeRevision(head, "head");
+    return ["diff", ...extraArgs, "--end-of-options", `${safeBase}..${safeHead}`];
+}
+export async function getGitHead(projectRoot) {
+    try {
+        const { stdout } = await runGit(projectRoot, ["rev-parse", "HEAD"]);
+        const hash = stdout.trim();
+        return hash || null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function isGitRepo(projectRoot) {
+    const resolvedRoot = path.resolve(projectRoot);
+    const cached = gitRepositoryChecks.get(resolvedRoot);
+    if (cached)
+        return await cached;
+    const check = (async () => {
+        try {
+            const { stdout } = await runGit(resolvedRoot, ["rev-parse", "--is-inside-work-tree"]);
+            return stdout.trim() === "true";
+        }
+        catch {
+            return false;
+        }
+    })();
+    gitRepositoryChecks.set(resolvedRoot, check);
+    return await check;
+}
+export async function isGitPathTracked(projectRoot, file) {
+    return await runGitPathPredicate(projectRoot, ["ls-files", "--error-unmatch", "--", normalizePath(file)]);
+}
+export async function isGitPathIgnored(projectRoot, file) {
+    return await runGitPathPredicate(projectRoot, ["check-ignore", "--quiet", "--no-index", "--", normalizePath(file)]);
+}
+async function runGitPathPredicate(projectRoot, args) {
+    try {
+        await runGit(projectRoot, args);
+        return true;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // git ls-files --error-unmatch / check-ignore --quiet exit 1 for "no".
+        if (/\bfailed \(1\):/.test(message))
+            return false;
+        if (error instanceof Error && message.startsWith(`git ${args.join(" ")} failed in ${projectRoot}:`)) {
+            throw error;
+        }
+        throw createGitError(projectRoot, args, error);
+    }
+}
+export async function getGitBlobHashes(projectRoot, files, opts) {
+    const gitAvailable = opts?.gitAvailable ?? true;
+    if (!gitAvailable)
+        return new Map();
+    const relFileSet = new Set(files
+        .map((file) => normalizePath(path.relative(projectRoot, file)))
+        .filter((rel) => rel && !rel.startsWith("..") && !path.isAbsolute(rel) && rel !== "."));
+    if (!relFileSet.size)
+        return new Map();
+    try {
+        // Deliberately no path arguments here: passing one argv entry per requested file hits
+        // Windows' ~32,767-character command-line limit past roughly 1,100 files, failing the
+        // whole call with ENAMETOOLONG and silently discarding every git signature for the
+        // build. Listing every tracked file and intersecting against the requested set in
+        // memory costs a little extra parsing but stays correct at any repo size.
+        // Full-repo NUL listings can exceed Node's default 1 MiB execFile maxBuffer on large
+        // trees; raising it keeps the argv-limit fix from regressing into a silent maxBuffer miss.
+        const { stdout: trackedStdout } = await runGit(projectRoot, ["ls-files", "-z"], {
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        const trackedRel = trackedStdout
+            .toString()
+            .split("\0")
+            .map((line) => line.trim())
+            .filter((rel) => rel && relFileSet.has(rel));
+        if (!trackedRel.length)
+            return new Map();
+        const { stdout: hashStdout } = await runGit(projectRoot, ["hash-object", "--stdin-paths"], {
+            input: trackedRel.join("\n"),
+        });
+        const hashes = hashStdout
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+        if (hashes.length !== trackedRel.length) {
+            logWithLevel(opts?.logLevel, "warn", `Warning: git hash-object returned ${hashes.length} hash(es) for ${trackedRel.length} ` +
+                "requested file(s); discarding Git signatures for this build.");
+            return new Map();
+        }
+        const out = new Map();
+        for (let i = 0; i < trackedRel.length; i += 1) {
+            const rel = trackedRel[i];
+            const hash = hashes[i];
+            if (!hash)
+                continue;
+            const abs = normalizePath(path.resolve(projectRoot, rel));
+            out.set(abs, hash);
+        }
+        return out;
+    }
+    catch (error) {
+        // A genuine git invocation failure, not "no git repository" (already handled above by
+        // the early `gitAvailable` return). Losing Git signatures means every file falls back to
+        // full content hashing, an easy-to-miss O(repo) regression, so surface it instead of
+        // failing silently.
+        logWithLevel(opts?.logLevel, "warn", "Warning: Failed to read Git blob hashes; falling back to content hashing.", error);
+        return new Map();
+    }
+}
+/**
+ * List files changed in Git.
+ * - base/head: compares commits in the explicit range `${base}..${head ?? "HEAD"}`.
+ *   WORKTREE compares base to the working tree, and STAGED/INDEX compares base to the index.
+ * - changedSince: runs `git diff <rev>` (that revision vs current working tree/index).
+ */
+export async function listChangedFiles(projectRoot, opts) {
+    let args = ["diff", "--name-only", "--diff-filter=ACDMRTUXB"];
+    if (opts.base) {
+        const head = opts.head ?? "HEAD";
+        args = gitDiffArgs(opts.base, head, ["--name-only", "--diff-filter=ACDMRTUXB"]);
+    }
+    else if (opts.changedSince) {
+        args.push("--end-of-options", assertSafeRevision(opts.changedSince, "changedSince"));
+    }
+    else {
+        return [];
+    }
+    args.push("--");
+    try {
+        const stdout = await runGitCollectStdout(projectRoot, args);
+        const relFiles = stdout
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+        const out = [];
+        for (const rel of relFiles) {
+            const abs = normalizePath(path.resolve(projectRoot, rel));
+            if (abs)
+                out.push(abs);
+        }
+        return Array.from(new Set(out));
+    }
+    catch (error) {
+        throw createGitError(projectRoot, args, error);
+    }
+}
+/**
+ * List files in the working tree that Git does not track (new, uncommitted files).
+ *
+ * Used to cheaply detect newly created project files without a full recursive
+ * directory scan: combined with tracked manifest entries and a commit-range
+ * diff, it lets incremental builds stay correct without re-walking the tree.
+ * `respectGitignore` mirrors Git's own `--exclude-standard`; pass `false` only
+ * when the caller intentionally wants gitignored files included. Callers still
+ * need to apply their own project-pattern, ignore, and realpath confinement
+ * checks before treating these paths as indexable project files.
+ */
+export async function listUntrackedFiles(projectRoot, opts) {
+    const gitAvailable = opts?.gitAvailable ?? true;
+    if (!gitAvailable)
+        return [];
+    const args = ["ls-files", "--others", "-z"];
+    if (opts?.respectGitignore ?? true)
+        args.push("--exclude-standard");
+    try {
+        const stdout = await runGitCollectStdout(projectRoot, args);
+        // git ls-files -z NUL-delimits entries; the trailing split segment is always an
+        // empty string, not a filename, so filter it out without trimming (a leading or
+        // trailing whitespace character can be a legitimate part of a real filename).
+        const relFiles = stdout.toString().split("\0").filter(Boolean);
+        const out = [];
+        for (const rel of relFiles) {
+            const abs = normalizePath(path.resolve(projectRoot, rel));
+            if (abs)
+                out.push(abs);
+        }
+        return Array.from(new Set(out));
+    }
+    catch (error) {
+        throw createGitError(projectRoot, args, error);
+    }
+}
+/**
+ * Get unified diff text from Git.
+ * - base/head: compares commits in the explicit range `${base}..${head ?? "HEAD"}`.
+ *   WORKTREE compares base to the working tree, and STAGED/INDEX compares base to the index.
+ * - changedSince: runs `git diff <rev>` (that revision vs current working tree/index).
+ */
+export async function getUnifiedDiff(projectRoot, opts) {
+    let args = ["diff", "--unified=0", "--no-color", "--diff-filter=ACDMRTUXB"];
+    if (opts.base) {
+        const head = opts.head ?? "HEAD";
+        args = gitDiffArgs(opts.base, head, ["--unified=0", "--no-color", "--diff-filter=ACDMRTUXB"]);
+    }
+    else if (opts.changedSince) {
+        args.push("--end-of-options", assertSafeRevision(opts.changedSince, "changedSince"));
+    }
+    else {
+        return "";
+    }
+    args.push("--");
+    try {
+        return await runGitCollectStdout(projectRoot, args);
+    }
+    catch (error) {
+        throw createGitError(projectRoot, args, error);
+    }
+}
+function createGitError(projectRoot, args, error) {
+    let detail = stringifyUnknown(error);
+    if (typeof error === "object" &&
+        error !== null &&
+        "stderr" in error &&
+        typeof error.stderr === "string" &&
+        error.stderr.trim()) {
+        detail = error.stderr.trim();
+    }
+    else if (error instanceof Error && error.message) {
+        detail = error.message;
+    }
+    return new Error(`git ${args.join(" ")} failed in ${projectRoot}: ${detail}`);
+}
+//# sourceMappingURL=git.js.map

package/dist/util/git.js.map

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

package/dist/util/graphEdges.d.ts

@@ -0,0 +1,5 @@
+import type { Edge } from "../types.js";
+export declare function edgeKey(edge: Edge): string;
+export declare function compareEdges(left: Edge, right: Edge): number;
+export declare function toRelativeEdge(projectRoot: string, edge: Edge): Edge;
+//# sourceMappingURL=graphEdges.d.ts.map

package/dist/util/graphEdges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEdges.d.ts","sourceRoot":"","sources":["../../src/util/graphEdges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAI1C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAe5D;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAepE"}

package/dist/util/graphEdges.js

@@ -0,0 +1,42 @@
+import { toProjectDisplayPath } from "./paths.js";
+export function edgeKey(edge) {
+    const toKey = edge.to.type === "file" ? `file:${edge.to.path}` : `external:${edge.to.name}`;
+    const typeOnly = edge.typeOnly ? "1" : "0";
+    return `${edge.from}|${toKey}|${edge.raw}|${typeOnly}`;
+}
+export function compareEdges(left, right) {
+    const fromCompare = left.from.localeCompare(right.from);
+    if (fromCompare)
+        return fromCompare;
+    if (left.to.type !== right.to.type) {
+        return left.to.type === "file" ? -1 : 1;
+    }
+    const leftTo = left.to.type === "file" ? left.to.path : left.to.name;
+    const rightTo = right.to.type === "file" ? right.to.path : right.to.name;
+    const toCompare = leftTo.localeCompare(rightTo);
+    if (toCompare)
+        return toCompare;
+    const rawCompare = left.raw.localeCompare(right.raw);
+    if (rawCompare)
+        return rawCompare;
+    const leftTypeOnly = left.typeOnly ? 1 : 0;
+    const rightTypeOnly = right.typeOnly ? 1 : 0;
+    return leftTypeOnly - rightTypeOnly;
+}
+export function toRelativeEdge(projectRoot, edge) {
+    const from = toProjectDisplayPath(projectRoot, edge.from);
+    let to = edge.to;
+    if (edge.to.type === "file") {
+        to = {
+            type: "file",
+            path: toProjectDisplayPath(projectRoot, edge.to.path),
+        };
+    }
+    return {
+        from,
+        to,
+        raw: edge.raw,
+        ...(edge.typeOnly ? { typeOnly: edge.typeOnly } : {}),
+    };
+}
+//# sourceMappingURL=graphEdges.js.map

package/dist/util/graphEdges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEdges.js","sourceRoot":"","sources":["../../src/util/graphEdges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,UAAU,OAAO,CAAC,IAAU;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,KAAW;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IACzE,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,YAAY,GAAG,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,IAAU;IAC5D,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACjB,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,EAAE,GAAG;YACH,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;SACtD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,EAAE;QACF,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/util/graphOnlyExtensions.d.ts

@@ -0,0 +1,5 @@
+export declare const GRAPH_ONLY_DOCUMENT_EXTENSIONS: readonly [".md", ".mdx", ".rst", ".adoc", ".asciidoc"];
+export type GraphOnlyDocumentExtension = (typeof GRAPH_ONLY_DOCUMENT_EXTENSIONS)[number];
+export declare const GRAPH_ONLY_RESOLUTION_EXTENSIONS: readonly [".md", ".mdx", ".astro", ".hbs", ".handlebars", ".rst", ".adoc", ".asciidoc"];
+export type GraphOnlyResolutionExtension = (typeof GRAPH_ONLY_RESOLUTION_EXTENSIONS)[number];
+//# sourceMappingURL=graphOnlyExtensions.d.ts.map

package/dist/util/graphOnlyExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphOnlyExtensions.d.ts","sourceRoot":"","sources":["../../src/util/graphOnlyExtensions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,wDAAyD,CAAC;AAErG,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzF,eAAO,MAAM,gCAAgC,yFASnC,CAAC;AAEX,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/util/graphOnlyExtensions.js

@@ -0,0 +1,12 @@
+export const GRAPH_ONLY_DOCUMENT_EXTENSIONS = [".md", ".mdx", ".rst", ".adoc", ".asciidoc"];
+export const GRAPH_ONLY_RESOLUTION_EXTENSIONS = [
+    ".md",
+    ".mdx",
+    ".astro",
+    ".hbs",
+    ".handlebars",
+    ".rst",
+    ".adoc",
+    ".asciidoc",
+];
+//# sourceMappingURL=graphOnlyExtensions.js.map

package/dist/util/graphOnlyExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphOnlyExtensions.js","sourceRoot":"","sources":["../../src/util/graphOnlyExtensions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAIrG,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,aAAa;IACb,MAAM;IACN,OAAO;IACP,WAAW;CACH,CAAC"}

package/dist/util/guards.d.ts

@@ -0,0 +1,2 @@
+export declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=guards.d.ts.map