@lzehrung/codegraph 2.1.0

package/dist/util/rustTestModules.js

@@ -0,0 +1,69 @@
+export function isRustCfgTestStatement(source, statementText, statementStartIndex) {
+    const normalizedStatement = statementText.trim();
+    if (!normalizedStatement)
+        return false;
+    const statementIndex = resolveStatementIndex(source, statementText, normalizedStatement, statementStartIndex);
+    if (statementIndex === -1)
+        return false;
+    if (hasImmediateRustCfgTestAttribute(source, statementIndex))
+        return true;
+    return isInsideRustCfgTestModule(source, statementIndex);
+}
+export function utf8ByteOffsetToStringIndex(source, byteOffset) {
+    if (byteOffset <= 0)
+        return 0;
+    let bytesSeen = 0;
+    for (let index = 0; index < source.length;) {
+        if (bytesSeen >= byteOffset)
+            return index;
+        const codePoint = source.codePointAt(index);
+        if (codePoint === undefined)
+            return source.length;
+        bytesSeen += Buffer.byteLength(String.fromCodePoint(codePoint), "utf8");
+        index += codePoint > 0xffff ? 2 : 1;
+    }
+    return source.length;
+}
+function resolveStatementIndex(source, statementText, normalizedStatement, statementStartIndex) {
+    if (statementStartIndex !== undefined) {
+        const leadingWhitespace = statementText.search(/\S/);
+        return statementStartIndex + Math.max(0, leadingWhitespace);
+    }
+    return source.indexOf(normalizedStatement);
+}
+function hasImmediateRustCfgTestAttribute(source, statementIndex) {
+    const prefix = source.slice(0, statementIndex).trimEnd();
+    return /#\s*\[cfg\s*\(\s*test\s*\)\]\s*$/.test(prefix);
+}
+function isInsideRustCfgTestModule(source, statementIndex) {
+    const testModulePattern = /#\s*\[cfg\s*\(\s*test\s*\)\]\s*mod\s+[A-Za-z_][\w]*\s*\{/g;
+    for (const match of source.matchAll(testModulePattern)) {
+        const moduleStart = match.index;
+        const openBraceIndex = source.indexOf("{", moduleStart);
+        if (openBraceIndex === -1 || statementIndex <= openBraceIndex)
+            continue;
+        const closeBraceIndex = findClosingBrace(source, openBraceIndex);
+        if (closeBraceIndex === undefined)
+            continue;
+        if (statementIndex < closeBraceIndex)
+            return true;
+    }
+    return false;
+}
+function findClosingBrace(source, openBraceIndex) {
+    let depth = 0;
+    for (let index = openBraceIndex; index < source.length; index += 1) {
+        const character = source[index];
+        if (character === "{") {
+            depth += 1;
+            continue;
+        }
+        if (character !== "}")
+            continue;
+        depth -= 1;
+        if (!depth)
+            return index;
+    }
+    return undefined;
+}
+//# sourceMappingURL=rustTestModules.js.map

package/dist/util/rustTestModules.js.map

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

package/dist/util/semaphore.d.ts

@@ -0,0 +1,2 @@
+export { getIOSemaphore, mapLimit, mapLimitSemaphore, resetIOSemaphore, Semaphore } from "./concurrency.js";
+//# sourceMappingURL=semaphore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.d.ts","sourceRoot":"","sources":["../../src/util/semaphore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/util/semaphore.js

@@ -0,0 +1,2 @@
+export { getIOSemaphore, mapLimit, mapLimitSemaphore, resetIOSemaphore, Semaphore } from "./concurrency.js";
+//# sourceMappingURL=semaphore.js.map

package/dist/util/semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.js","sourceRoot":"","sources":["../../src/util/semaphore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/util/sourceLocation.d.ts

@@ -0,0 +1,8 @@
+export type SourceLocationInput = {
+    file: string;
+    line?: number;
+    column?: number;
+};
+/** Parse a plain file or file:line[:column], preserving Windows drive letters. */
+export declare function parseSourceLocationInput(value: string): SourceLocationInput;
+//# sourceMappingURL=sourceLocation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLocation.d.ts","sourceRoot":"","sources":["../../src/util/sourceLocation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAKF,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAgB3E"}

package/dist/util/sourceLocation.js

@@ -0,0 +1,19 @@
+const FILE_LINE_COLUMN_PATTERN = /^(.*):(\d+):(\d+)$/;
+const FILE_LINE_PATTERN = /^(.*):(\d+)$/;
+/** Parse a plain file or file:line[:column], preserving Windows drive letters. */
+export function parseSourceLocationInput(value) {
+    const lineColumnMatch = FILE_LINE_COLUMN_PATTERN.exec(value);
+    if (lineColumnMatch?.[1] && lineColumnMatch[2] && lineColumnMatch[3]) {
+        return {
+            file: lineColumnMatch[1],
+            line: Number(lineColumnMatch[2]),
+            column: Number(lineColumnMatch[3]),
+        };
+    }
+    const lineMatch = FILE_LINE_PATTERN.exec(value);
+    if (lineMatch?.[1] && lineMatch[2]) {
+        return { file: lineMatch[1], line: Number(lineMatch[2]) };
+    }
+    return { file: value };
+}
+//# sourceMappingURL=sourceLocation.js.map

package/dist/util/sourceLocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLocation.js","sourceRoot":"","sources":["../../src/util/sourceLocation.ts"],"names":[],"mappings":"AAMA,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AACtD,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,MAAM,eAAe,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;YACxB,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/util/specifiers.d.ts

@@ -0,0 +1,17 @@
+export type ModuleSpecifierResolutionKind = "document" | "source" | "stylesheet";
+export type ModuleSpecifierExportCondition = "import" | "require";
+export type ModuleSpecifier = {
+    spec: string;
+    raw?: string;
+    typeOnly?: boolean;
+    phpImportType?: "class" | "function" | "const";
+    resolutionKind?: ModuleSpecifierResolutionKind;
+    exportCondition?: ModuleSpecifierExportCondition;
+    dropIfUnresolved?: boolean;
+    resolved?: "heuristic" | "precise";
+    confidence?: number;
+};
+export declare function extractJsTsSpecifiers(source: string): ModuleSpecifier[];
+export declare function extractJsTsDynamicSpecifiers(source: string, fromFile: string, projectRoot: string): ModuleSpecifier[];
+export declare function extractPythonSpecifiers(source: string): string[];
+//# sourceMappingURL=specifiers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specifiers.d.ts","sourceRoot":"","sources":["../../src/util/specifiers.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,6BAA6B,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEjF,MAAM,MAAM,8BAA8B,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IAC/C,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAcF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CA0CvE;AAmID,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE,CAyCrH;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYhE"}

package/dist/util/specifiers.js

@@ -0,0 +1,263 @@
+import path from "node:path";
+import { buildJsLikeLiteralMask, stripJsLikeComments, stripPythonCommentsAndStrings } from "./comments.js";
+import { normalizePath } from "./paths.js";
+function matchStartsInCode(mask, match) {
+    const index = match.index;
+    if (index === undefined || !mask)
+        return true;
+    const text = match[0] ?? "";
+    for (let offset = 0; offset < text.length; offset += 1) {
+        const ch = text[offset];
+        if (/\s/.test(ch))
+            continue;
+        return mask[index + offset] === 0;
+    }
+    return true;
+}
+export function extractJsTsSpecifiers(source) {
+    const out = [];
+    try {
+        const src = stripJsLikeComments(source);
+        const push = (spec, opts) => {
+            if (!spec)
+                return;
+            out.push({
+                spec,
+                ...(opts?.typeOnly ? { typeOnly: true } : {}),
+                ...(opts?.exportCondition ? { exportCondition: opts.exportCondition } : {}),
+            });
+        };
+        const literalMask = buildJsLikeLiteralMask(src);
+        // Capture groups: 1 import-from, 2 side-effect import, 3 export-from,
+        // 4 destructured require, 5 require(), 6 import(), 7 import = require, 8 declare module.
+        const combined = /^\s*import\s+[^\n;]*?\s+from\s+["']([^"']+)["']|^\s*import\s+["']([^"']+)["']|\bexport\s+[^\n;]*?\s+from\s+["']([^"']+)["']|\b(?:const|let|var)\s*\{[^}]*\}\s*=\s*require\s*\(\s*["']([^"']+)["']\s*\)|(?<!["'`])\brequire\s*\(\s*["']([^"']+)["']\s*\)|(?<!["'`])\bimport\s*\(\s*["']([^"']+)["']\s*\)|^\s*import\s+[A-Za-z_$][\w$]*\s*=\s*require\s*\(\s*["']([^"']+)["']\s*\)|^\s*declare\s+module\s+["']([^"']+)["']/gm;
+        for (const match of src.matchAll(combined)) {
+            if (!matchStartsInCode(literalMask, match))
+                continue;
+            const spec = match[1] ?? match[2] ?? match[3] ?? match[4] ?? match[5] ?? match[6] ?? match[7] ?? match[8];
+            if (!spec)
+                continue;
+            const text = match[0] ?? "";
+            let typeOnly = false;
+            if (match[1] !== undefined || match[2] !== undefined) {
+                typeOnly = /\bimport\s+type\b/.test(text);
+            }
+            else if (match[3] !== undefined) {
+                typeOnly = /\bexport\s+type\b/.test(text);
+            }
+            else if (match[8] !== undefined) {
+                typeOnly = true;
+            }
+            const exportCondition = match[4] !== undefined || match[5] !== undefined || match[7] !== undefined ? "require" : undefined;
+            push(spec, {
+                ...(typeOnly ? { typeOnly: true } : {}),
+                ...(exportCondition ? { exportCondition } : {}),
+            });
+        }
+    }
+    catch {
+        /* regex/parse fallback: ignore */
+    }
+    return out;
+}
+function parseStringLiteralToken(token) {
+    const trimmed = token.trim();
+    if (trimmed.length < 2)
+        return null;
+    const quote = trimmed[0];
+    if (quote !== "'" && quote !== `"` && quote !== "`")
+        return null;
+    if (!trimmed.endsWith(quote))
+        return null;
+    if (quote === "`" && trimmed.includes("${"))
+        return null;
+    return trimmed.slice(1, -1);
+}
+function splitTopLevelArgs(text) {
+    const args = [];
+    let current = "";
+    let depth = 0;
+    let quote = null;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (quote) {
+            current += ch;
+            if (ch === "\\") {
+                const next = text[i + 1];
+                if (next) {
+                    current += next;
+                    i += 1;
+                }
+                continue;
+            }
+            if (quote === "`" && ch === "$" && text[i + 1] === "{")
+                return null;
+            if (ch === quote)
+                quote = null;
+            continue;
+        }
+        if (ch === "'" || ch === `"` || ch === "`") {
+            quote = ch;
+            current += ch;
+            continue;
+        }
+        if (ch === "(" || ch === "[" || ch === "{") {
+            depth += 1;
+            current += ch;
+            continue;
+        }
+        if (ch === ")" || ch === "]" || ch === "}") {
+            if (depth === 0)
+                return null;
+            depth -= 1;
+            current += ch;
+            continue;
+        }
+        if (ch === "," && depth === 0) {
+            const trimmed = current.trim();
+            if (trimmed)
+                args.push(trimmed);
+            current = "";
+            continue;
+        }
+        current += ch;
+    }
+    if (quote || depth !== 0)
+        return null;
+    const tail = current.trim();
+    if (tail)
+        args.push(tail);
+    return args;
+}
+function parseDynamicToken(token) {
+    const compact = token.replace(/\s+/g, "");
+    if (compact === "__dirname") {
+        return { kind: "base", base: "fileDir" };
+    }
+    if (compact === "__filename" || compact === "import.meta.url") {
+        return { kind: "base", base: "filePath" };
+    }
+    if (compact === "process.cwd()") {
+        return { kind: "base", base: "project" };
+    }
+    const literal = parseStringLiteralToken(token);
+    if (literal !== null) {
+        return { kind: "literal", value: literal };
+    }
+    return null;
+}
+function parsePathCallArg(argText) {
+    const match = argText.match(/^\s*path\.(?:join|resolve)\s*\(([\s\S]*)\)\s*$/);
+    if (!match)
+        return null;
+    const args = splitTopLevelArgs(match[1] ?? "");
+    if (!args?.length)
+        return null;
+    let base = null;
+    const segments = [];
+    for (const arg of args) {
+        const token = parseDynamicToken(arg);
+        if (!token)
+            return null;
+        if (token.kind === "base") {
+            if (base && base !== token.base)
+                return null;
+            base = token.base;
+        }
+        else {
+            segments.push(token.value);
+        }
+    }
+    if (!base || !segments.length)
+        return null;
+    return { base, segments };
+}
+function parseNewUrlArg(argText) {
+    const match = argText.match(/^\s*new\s+URL\s*\(([\s\S]*)\)\s*$/);
+    if (!match)
+        return null;
+    const args = splitTopLevelArgs(match[1] ?? "");
+    if (!args || args.length < 2)
+        return null;
+    const firstLiteral = parseStringLiteralToken(args[0] ?? "");
+    if (!firstLiteral)
+        return null;
+    const baseToken = parseDynamicToken(args[1] ?? "");
+    if (!baseToken || baseToken.kind !== "base")
+        return null;
+    if (baseToken.base !== "filePath")
+        return null;
+    return { base: baseToken.base, segments: [firstLiteral] };
+}
+function buildRelativeSpecifier(fromFile, targetPath) {
+    const fromDir = path.dirname(fromFile);
+    const rel = normalizePath(path.relative(fromDir, targetPath));
+    if (!rel)
+        return null;
+    return rel.startsWith(".") ? rel : `./${rel}`;
+}
+export function extractJsTsDynamicSpecifiers(source, fromFile, projectRoot) {
+    const out = [];
+    try {
+        const src = stripJsLikeComments(source);
+        const literalMask = buildJsLikeLiteralMask(src);
+        const seen = new Set();
+        const addSpec = (spec) => {
+            if (!spec || seen.has(spec))
+                return;
+            seen.add(spec);
+            out.push({ spec, resolved: "heuristic", confidence: 0.7 });
+        };
+        const pathCallRe = /(?<!["'`])\b(?:require|import)\s*\(\s*(path\.(?:join|resolve)\s*\((?:[^()]|\([^()]*\))*\))\s*\)/g;
+        for (const match of src.matchAll(pathCallRe)) {
+            if (!matchStartsInCode(literalMask, match))
+                continue;
+            const argText = match[1] ?? "";
+            const parsed = parsePathCallArg(argText);
+            if (!parsed)
+                continue;
+            let basePath = projectRoot;
+            if (parsed.base === "fileDir") {
+                basePath = path.dirname(fromFile);
+            }
+            else if (parsed.base === "filePath") {
+                basePath = fromFile;
+            }
+            const targetPath = path.resolve(basePath, ...parsed.segments);
+            addSpec(buildRelativeSpecifier(fromFile, targetPath));
+        }
+        const urlCallRe = /(?<!["'`])\b(?:require|import)\s*\(\s*(new\s+URL\s*\([^)]*\))\s*\)/g;
+        for (const match of src.matchAll(urlCallRe)) {
+            if (!matchStartsInCode(literalMask, match))
+                continue;
+            const argText = match[1] ?? "";
+            const parsed = parseNewUrlArg(argText);
+            if (!parsed)
+                continue;
+            const baseDir = path.dirname(fromFile);
+            const targetPath = path.resolve(baseDir, ...parsed.segments);
+            addSpec(buildRelativeSpecifier(fromFile, targetPath));
+        }
+    }
+    catch {
+        /* parse fallback: ignore */
+    }
+    return out;
+}
+export function extractPythonSpecifiers(source) {
+    const out = [];
+    try {
+        const cleaned = stripPythonCommentsAndStrings(source);
+        const reImport = /^\s*import\s+([A-Za-z_][\w.]*)/gm;
+        for (const match of cleaned.matchAll(reImport))
+            out.push(match[1]);
+        const reFrom = /^\s*from\s+(\.+(?:[A-Za-z_][\w.]*)?|[A-Za-z_][\w.]*)\s+import/gm;
+        for (const match of cleaned.matchAll(reFrom))
+            out.push(match[1]);
+    }
+    catch {
+        /* parse fallback: ignore */
+    }
+    return out;
+}
+//# sourceMappingURL=specifiers.js.map

package/dist/util/specifiers.js.map

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

package/dist/util/sqliteSchema.d.ts

@@ -0,0 +1,28 @@
+import { SqliteDatabase } from "../sqlite-driver.js";
+export type SqliteSchemaVersion = {
+    status: "missing";
+} | {
+    status: "invalid";
+} | {
+    status: "ok";
+    version: number;
+};
+export type SqliteTableColumn = {
+    name: string;
+    definition: string;
+};
+export declare function ensureSqliteSchemaMetadataTable(db: SqliteDatabase): void;
+export declare function createSqliteTableIfMissing(db: SqliteDatabase, tableName: string, columns: readonly SqliteTableColumn[], tableConstraints?: readonly string[]): void;
+export declare function recreateSqliteTable(db: SqliteDatabase, tableName: string, createTable: (db: SqliteDatabase) => void): void;
+export declare function readSqliteSchemaVersion(db: SqliteDatabase, key: string): SqliteSchemaVersion;
+export declare function writeSqliteSchemaVersion(db: SqliteDatabase, key: string, version: number): void;
+export declare function ensureSqliteVersionedTableSchema(args: {
+    db: SqliteDatabase;
+    tableName: string;
+    schemaVersionKey: string;
+    schemaVersion: number;
+    createTable: (db: SqliteDatabase) => void;
+    migrateTable: (db: SqliteDatabase) => void;
+}): void;
+export declare function sqliteTableColumns(db: SqliteDatabase, tableName: string): Set<string>;
+//# sourceMappingURL=sqliteSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteSchema.d.ts","sourceRoot":"","sources":["../../src/util/sqliteSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AASF,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAOxE;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,gBAAgB,GAAE,SAAS,MAAM,EAAO,GACvC,IAAI,CAQN;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,GACxC,IAAI,CAGN;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAQ5F;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAM/F;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,EAAE,EAAE,cAAc,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,YAAY,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C,GAAG,IAAI,CAYP;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOrF"}

package/dist/util/sqliteSchema.js

@@ -0,0 +1,66 @@
+import { SqliteDatabase } from "../sqlite-driver.js";
+function quoteSqliteIdentifier(identifier) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
+        throw new Error(`Invalid SQLite identifier "${identifier}".`);
+    }
+    return `"${identifier}"`;
+}
+export function ensureSqliteSchemaMetadataTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS cache_schema_metadata (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+  `);
+}
+export function createSqliteTableIfMissing(db, tableName, columns, tableConstraints = []) {
+    const columnSql = columns.map((column) => `${quoteSqliteIdentifier(column.name)} ${column.definition}`);
+    const statements = [...columnSql, ...tableConstraints];
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS ${quoteSqliteIdentifier(tableName)} (
+      ${statements.join(",\n      ")}
+    );
+  `);
+}
+export function recreateSqliteTable(db, tableName, createTable) {
+    db.exec(`DROP TABLE IF EXISTS ${quoteSqliteIdentifier(tableName)};`);
+    createTable(db);
+}
+export function readSqliteSchemaVersion(db, key) {
+    const row = db.prepare("SELECT value FROM cache_schema_metadata WHERE key = ?").get(key);
+    if (!row)
+        return { status: "missing" };
+    if (typeof row.value !== "string")
+        return { status: "invalid" };
+    const version = Number(row.value);
+    if (!Number.isInteger(version) || version < 0)
+        return { status: "invalid" };
+    return { status: "ok", version };
+}
+export function writeSqliteSchemaVersion(db, key, version) {
+    db.prepare(`INSERT INTO cache_schema_metadata (key, value)
+     VALUES (?, ?)
+     ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(key, String(version));
+}
+export function ensureSqliteVersionedTableSchema(args) {
+    ensureSqliteSchemaMetadataTable(args.db);
+    const schemaVersion = readSqliteSchemaVersion(args.db, args.schemaVersionKey);
+    if (schemaVersion.status === "invalid" ||
+        (schemaVersion.status === "ok" && schemaVersion.version > args.schemaVersion)) {
+        recreateSqliteTable(args.db, args.tableName, args.createTable);
+    }
+    else {
+        args.migrateTable(args.db);
+    }
+    writeSqliteSchemaVersion(args.db, args.schemaVersionKey, args.schemaVersion);
+}
+export function sqliteTableColumns(db, tableName) {
+    const rows = db.prepare(`PRAGMA table_info(${quoteSqliteIdentifier(tableName)})`).all();
+    const columns = new Set();
+    for (const row of rows) {
+        if (typeof row.name === "string")
+            columns.add(row.name);
+    }
+    return columns;
+}
+//# sourceMappingURL=sqliteSchema.js.map

package/dist/util/sqliteSchema.js.map

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

package/dist/util/symbolHash.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Symbol-level change detection for incremental rebuilds
+ *
+ * Instead of invalidating entire files, we track which specific symbols changed
+ * and only re-analyze those symbols and their dependents. This gives 5-10x faster
+ * rebuilds for large files with small changes.
+ */
+import { type ExportEntry, type SymbolDef } from "../indexer/types.js";
+import type { Edge } from "../types.js";
+/**
+ * Hash of a symbol's definition
+ */
+export type SymbolHash = {
+    /** Symbol identifier (name + position) */
+    id: string;
+    /** Hash of the symbol's AST node */
+    hash: string;
+    /** Symbol kind */
+    kind: string;
+    /** Whether this symbol is exported */
+    exported: boolean;
+};
+/**
+ * Compute a stable hash for a symbol's definition
+ * This hash changes only when the symbol's implementation changes
+ */
+export declare function computeSymbolHash(def: SymbolDef, source: string): SymbolHash;
+/**
+ * Create a stable identifier for a symbol
+ * Format: name::kind::startIndex
+ */
+export declare function symbolIdentifier(def: SymbolDef): string;
+/**
+ * Detect which symbols changed between two sets of symbol hashes
+ */
+export declare function detectSymbolChanges(oldHashes: SymbolHash[], newHashes: SymbolHash[]): {
+    added: SymbolHash[];
+    removed: SymbolHash[];
+    modified: SymbolHash[];
+    unchanged: SymbolHash[];
+};
+/**
+ * Extended manifest entry with symbol-level tracking
+ */
+export type SymbolManifestEntry = {
+    /** File signature */
+    sig: string;
+    /** Git signature if available */
+    gitSig?: string;
+    /** Dependency edges */
+    edges: Edge[];
+    /** Symbol hashes for symbol-level change detection */
+    symbolHashes?: SymbolHash[];
+};
+/**
+ * Compute symbol hashes for a file
+ */
+export declare function computeFileSymbolHashes(symbols: SymbolDef[], exports: ExportEntry[], source: string): SymbolHash[];
+//# sourceMappingURL=symbolHash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbolHash.d.ts","sourceRoot":"","sources":["../../src/util/symbolHash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAiB5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,EAAE,EACvB,SAAS,EAAE,UAAU,EAAE,GACtB;IACD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,EAAE,UAAU,EAAE,CAAC;CACzB,CA6BA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,sDAAsD;IACtD,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAgBlH"}