@lzehrung/codegraph 2.1.0

package/dist/mcp.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP server and typed handler helpers for agent graph navigation.
+ *
+ * Import from `@lzehrung/codegraph/mcp`. The root package entrypoint does not
+ * re-export these symbols.
+ */
+export { createCodegraphMcpHandlers, listCodegraphMcpTools, serveCodegraphMcp } from "./mcp/server.js";
+export type { CodegraphMcpHandlers, CodegraphMcpServerOptions } from "./mcp/server.js";
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvG,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mcp.js

@@ -0,0 +1,8 @@
+/**
+ * MCP server and typed handler helpers for agent graph navigation.
+ *
+ * Import from `@lzehrung/codegraph/mcp`. The root package entrypoint does not
+ * re-export these symbols.
+ */
+export { createCodegraphMcpHandlers, listCodegraphMcpTools, serveCodegraphMcp } from "./mcp/server.js";
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/native/bindingLoader.d.ts

@@ -0,0 +1,24 @@
+import type { NativeBindingOrigin } from "./contracts.js";
+export type NativeBindingLoadResult<T> = {
+    binding: T;
+    error?: undefined;
+    origin: NativeBindingOrigin;
+} | {
+    binding: null;
+    error?: unknown;
+    origin?: NativeBindingOrigin;
+};
+export type BindingLoaderOptions = {
+    packageName: string;
+    localPackageRoot: string;
+    requireFn: (specifier: string) => unknown;
+    resolveFn?: ((specifier: string) => string) | undefined;
+    platform?: NodeJS.Platform | undefined;
+    arch?: string | undefined;
+    cacheRoot?: string | undefined;
+};
+export declare function nativeTargetSuffixFor(platform: NodeJS.Platform, arch: string): string | null;
+export declare function currentNativeTargetSuffix(): string | null;
+export declare function findLocalNativeBinary(packageRoot: string): string | null;
+export declare function loadNativeBinding<T>(options: BindingLoaderOptions): NativeBindingLoadResult<T>;
+//# sourceMappingURL=bindingLoader.d.ts.map

package/dist/native/bindingLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindingLoader.d.ts","sourceRoot":"","sources":["../../src/native/bindingLoader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,MAAM,MAAM,uBAAuB,CAAC,CAAC,IACjC;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC9D;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAYF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe5F;AAED,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAEzD;AAaD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAaxE;AA+BD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,uBAAuB,CAAC,CAAC,CAAC,CA0H9F"}

package/dist/native/bindingLoader.js

@@ -0,0 +1,206 @@
+import fs from "node:fs";
+import path from "node:path";
+import { normalizePath } from "../util/paths.js";
+import { errorMessage } from "../util/errors.js";
+import { prepareNativeRuntimeCache } from "./runtimeCache.js";
+function isMuslRuntime() {
+    if (process.platform !== "linux")
+        return false;
+    const report = process.report?.getReport();
+    const header = report && typeof report === "object" && "header" in report ? report.header : null;
+    const glibcVersionRuntime = header && typeof header === "object" && "glibcVersionRuntime" in header ? header.glibcVersionRuntime : null;
+    if (typeof glibcVersionRuntime === "string" && glibcVersionRuntime)
+        return false;
+    return true;
+}
+export function nativeTargetSuffixFor(platform, arch) {
+    if (platform === "win32") {
+        if (arch === "x64")
+            return "win32-x64-msvc";
+        if (arch === "arm64")
+            return "win32-arm64-msvc";
+    }
+    if (platform === "darwin") {
+        if (arch === "x64")
+            return "darwin-x64";
+        if (arch === "arm64")
+            return "darwin-arm64";
+    }
+    if (platform === "linux") {
+        const abi = isMuslRuntime() ? "musl" : "gnu";
+        if (arch === "x64")
+            return `linux-x64-${abi}`;
+        if (arch === "arm64")
+            return `linux-arm64-${abi}`;
+    }
+    return null;
+}
+export function currentNativeTargetSuffix() {
+    return nativeTargetSuffixFor(process.platform, process.arch);
+}
+function normalizePathForComparison(filePath) {
+    const resolved = path.resolve(filePath);
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function isWithinDirectory(filePath, directoryPath) {
+    const normalizedFile = normalizePathForComparison(filePath);
+    const normalizedDir = normalizePathForComparison(directoryPath);
+    return normalizedFile === normalizedDir || normalizedFile.startsWith(`${normalizedDir}${path.sep}`);
+}
+export function findLocalNativeBinary(packageRoot) {
+    const suffix = currentNativeTargetSuffix();
+    if (!suffix) {
+        return null;
+    }
+    const expectedName = `index.${suffix}.node`;
+    try {
+        const entries = fs.readdirSync(packageRoot, { withFileTypes: true });
+        const binary = entries.find((entry) => entry.isFile() && entry.name === expectedName);
+        return binary ? path.join(packageRoot, binary.name) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readPlatformPackage(packageName, target, resolveFn) {
+    const platformPackageName = `${packageName}-${target}`;
+    const resolvedEntry = resolveFn(platformPackageName);
+    const expectedFileName = `index.${target}.node`;
+    if (path.basename(resolvedEntry) !== expectedFileName) {
+        throw new Error(`unexpected native platform entry for ${platformPackageName}: ${resolvedEntry}`);
+    }
+    const sourcePath = fs.realpathSync.native(resolvedEntry);
+    const stats = fs.statSync(sourcePath);
+    if (!stats.isFile() || stats.size <= 0) {
+        throw new Error(`native platform entry is not a non-empty regular file: ${sourcePath}`);
+    }
+    const packageJsonPath = path.join(path.dirname(sourcePath), "package.json");
+    const parsed = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+    if (parsed.name !== platformPackageName || !parsed.version) {
+        throw new Error(`invalid native platform package metadata: ${packageJsonPath}`);
+    }
+    return { sourcePath, packageVersion: parsed.version };
+}
+export function loadNativeBinding(options) {
+    const localBinary = findLocalNativeBinary(options.localPackageRoot);
+    const localTarget = currentNativeTargetSuffix();
+    let lastError;
+    if (localBinary) {
+        try {
+            return {
+                binding: options.requireFn(localBinary),
+                origin: {
+                    mode: "workspace",
+                    packageName: options.packageName,
+                    ...(localTarget ? { target: localTarget } : {}),
+                    sourcePath: normalizePath(localBinary),
+                    loadedPath: normalizePath(localBinary),
+                },
+            };
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    const packageEntry = (() => {
+        if (!options.resolveFn)
+            return null;
+        try {
+            return options.resolveFn(options.packageName);
+        }
+        catch {
+            return null;
+        }
+    })();
+    if (packageEntry && isWithinDirectory(packageEntry, options.localPackageRoot)) {
+        return {
+            binding: null,
+            error: lastError ?? new Error("local workspace native addon is not built; run `npm run build:native`"),
+            origin: {
+                mode: "workspace",
+                packageName: options.packageName,
+                ...(localTarget ? { target: localTarget } : {}),
+            },
+        };
+    }
+    const platform = options.platform ?? process.platform;
+    const arch = options.arch ?? process.arch;
+    const target = nativeTargetSuffixFor(platform, arch);
+    let installedSourcePath;
+    let installedPackageVersion;
+    let cacheError;
+    if (target && options.resolveFn) {
+        try {
+            const platformPackage = readPlatformPackage(options.packageName, target, options.resolveFn);
+            installedSourcePath = platformPackage.sourcePath;
+            installedPackageVersion = platformPackage.packageVersion;
+        }
+        catch (error) {
+            if (platform === "win32") {
+                cacheError = errorMessage(error);
+            }
+        }
+    }
+    if (platform === "win32" && target && installedSourcePath && installedPackageVersion) {
+        const cached = prepareNativeRuntimeCache({
+            sourcePath: installedSourcePath,
+            packageName: `${options.packageName}-${target}`,
+            packageVersion: installedPackageVersion,
+            target,
+            cacheRoot: options.cacheRoot,
+        });
+        if (cached.status === "unavailable") {
+            cacheError = cached.error.message;
+        }
+        else {
+            try {
+                return {
+                    binding: options.requireFn(cached.loadedPath),
+                    origin: {
+                        mode: "cache",
+                        packageName: `${options.packageName}-${target}`,
+                        packageVersion: installedPackageVersion,
+                        target,
+                        sourcePath: normalizePath(cached.sourcePath),
+                        loadedPath: normalizePath(cached.loadedPath),
+                        cacheKey: cached.cacheKey,
+                        sha256: cached.sha256,
+                    },
+                };
+            }
+            catch (error) {
+                cacheError = `cached native addon failed to load: ${errorMessage(error)}`;
+                lastError = error;
+            }
+        }
+    }
+    let originPackageName = options.packageName;
+    let originLoadedPath = packageEntry;
+    if (target && installedSourcePath && installedPackageVersion) {
+        originPackageName = `${options.packageName}-${target}`;
+        originLoadedPath = installedSourcePath;
+    }
+    const packageOrigin = {
+        mode: "package",
+        packageName: originPackageName,
+        ...(installedPackageVersion ? { packageVersion: installedPackageVersion } : {}),
+        ...(target ? { target } : {}),
+        ...(installedSourcePath ? { sourcePath: normalizePath(installedSourcePath) } : {}),
+        ...(originLoadedPath ? { loadedPath: normalizePath(originLoadedPath) } : {}),
+        ...(cacheError ? { cacheError } : {}),
+    };
+    try {
+        return {
+            binding: options.requireFn(options.packageName),
+            origin: packageOrigin,
+        };
+    }
+    catch (error) {
+        return {
+            binding: null,
+            error: error ?? lastError,
+            origin: packageOrigin,
+        };
+    }
+}
+//# sourceMappingURL=bindingLoader.js.map

package/dist/native/bindingLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindingLoader.js","sourceRoot":"","sources":["../../src/native/bindingLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAgB9D,SAAS,aAAa;IACpB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACjG,MAAM,mBAAmB,GACvB,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,qBAAqB,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9G,IAAI,OAAO,mBAAmB,KAAK,QAAQ,IAAI,mBAAmB;QAAE,OAAO,KAAK,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB,EAAE,IAAY;IAC3E,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,gBAAgB,CAAC;QAC5C,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,kBAAkB,CAAC;IAClD,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,YAAY,CAAC;QACxC,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,cAAc,CAAC;IAC9C,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7C,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,aAAa,GAAG,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,eAAe,GAAG,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,aAAqB;IAChE,MAAM,cAAc,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;IAChE,OAAO,cAAc,KAAK,aAAa,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,YAAY,GAAG,SAAS,MAAM,OAAO,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QACtF,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAmB,EACnB,MAAc,EACd,SAAwC;IAExC,MAAM,mBAAmB,GAAG,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC;IACvD,MAAM,aAAa,GAAG,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,SAAS,MAAM,OAAO,CAAC;IAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,gBAAgB,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,wCAAwC,mBAAmB,KAAK,aAAa,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,0DAA0D,UAAU,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAGjE,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6CAA6C,eAAe,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,OAA6B;IAChE,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,yBAAyB,EAAE,CAAC;IAChD,IAAI,SAAkB,CAAC;IAEvB,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,CAAM;gBAC5C,MAAM,EAAE;oBACN,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/C,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC;oBACtC,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC;iBACvC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE;QACzB,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,YAAY,IAAI,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9E,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,SAAS,IAAI,IAAI,KAAK,CAAC,uEAAuE,CAAC;YACtG,MAAM,EAAE;gBACN,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrD,IAAI,mBAAuC,CAAC;IAC5C,IAAI,uBAA2C,CAAC;IAChD,IAAI,UAA8B,CAAC;IAEnC,IAAI,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC5F,mBAAmB,GAAG,eAAe,CAAC,UAAU,CAAC;YACjD,uBAAuB,GAAG,eAAe,CAAC,cAAc,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,IAAI,MAAM,IAAI,mBAAmB,IAAI,uBAAuB,EAAE,CAAC;QACrF,MAAM,MAAM,GAAG,yBAAyB,CAAC;YACvC,UAAU,EAAE,mBAAmB;YAC/B,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,EAAE;YAC/C,cAAc,EAAE,uBAAuB;YACvC,MAAM;YACN,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACpC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,OAAO;oBACL,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAM;oBAClD,MAAM,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,EAAE;wBAC/C,cAAc,EAAE,uBAAuB;wBACvC,MAAM;wBACN,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC;wBAC5C,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC;wBAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,UAAU,GAAG,uCAAuC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1E,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAC5C,IAAI,gBAAgB,GAAG,YAAY,CAAC;IACpC,IAAI,MAAM,IAAI,mBAAmB,IAAI,uBAAuB,EAAE,CAAC;QAC7D,iBAAiB,GAAG,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC;QACvD,gBAAgB,GAAG,mBAAmB,CAAC;IACzC,CAAC;IAED,MAAM,aAAa,GAAwB;QACzC,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iBAAiB;QAC9B,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;IACF,IAAI,CAAC;QACH,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAM;YACpD,MAAM,EAAE,aAAa;SACtB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,MAAM,EAAE,aAAa;SACtB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/native/contracts.d.ts

@@ -0,0 +1,122 @@
+export type NativePoint = {
+    row: number;
+    column: number;
+    index: number;
+};
+export type NativeCapture = {
+    name: string;
+    text: string;
+    nodeType: string;
+    start: NativePoint;
+    end: NativePoint;
+};
+export type NativeMatch = {
+    patternIndex: number;
+    captures: NativeCapture[];
+};
+export type NativeQueryResults = {
+    imports: NativeMatch[];
+    exports: NativeMatch[];
+    locals: NativeMatch[];
+    importBindings: NativeMatch[];
+};
+export type NativeSyntaxNode = {
+    id: number;
+    parentId: number;
+    nodeType: string;
+    named: boolean;
+    start: NativePoint;
+    end: NativePoint;
+    childIds: number[];
+    namedChildIds: number[];
+    childFieldNames: string[];
+};
+export type NativeSyntaxTree = {
+    rootId: number;
+    nodes: NativeSyntaxNode[];
+};
+export type NativeLanguageExtraction = {
+    results: NativeQueryResults;
+    syntaxTree: NativeSyntaxTree;
+};
+export type CompactCapture = {
+    name: string;
+    text: string;
+};
+export type CompactMatch = {
+    patternIndex: number;
+    captures: CompactCapture[];
+};
+export type CompactQueryResults = {
+    imports: CompactMatch[];
+};
+export type NativeDuplicateTokens = {
+    normalizedTokens: string[];
+};
+export type NativeFallbackReason = "unavailable" | "unsupportedLanguage" | "queryFailure";
+export type NativeQueryExecution = {
+    results: NativeQueryResults | null;
+    fallbackReason?: NativeFallbackReason;
+    error?: string;
+};
+export type CompactImportsExecution = {
+    results: CompactQueryResults | null;
+    fallbackReason?: NativeFallbackReason;
+    error?: string;
+};
+export type NativeSingleQueryExecution = {
+    matches: NativeMatch[] | null;
+    fallbackReason?: NativeFallbackReason;
+    error?: string;
+};
+export type UnifiedQueryExecution = {
+    matches: NativeMatch[] | null;
+    backend: "native";
+    fallbackReason?: NativeFallbackReason;
+    error?: string;
+};
+export type NativeSyntaxTreeExecution = {
+    tree: NativeSyntaxTree | null;
+    fallbackReason?: NativeFallbackReason;
+    error?: string;
+};
+export type NativeRuntimeMode = "auto" | "on" | "off";
+/**
+ * Controls which query kinds are executed in a native call.
+ * - "imports": only run the imports query (used by graph mode)
+ * - "full": run all query kinds (used by full indexing)
+ */
+export type NativeQueryScope = "imports" | "full";
+export type NativeBinding = {
+    runLanguageQueries: (source: string, languageId: string, importsQuery: string, exportsQuery: string, localsQuery: string, importBindingsQuery: string) => NativeQueryResults;
+    extractLanguage: (source: string, languageId: string, importsQuery: string, exportsQuery: string, localsQuery: string, importBindingsQuery: string) => NativeLanguageExtraction;
+    runImportsQueryCompact?: (source: string, languageId: string, importsQuery: string) => CompactQueryResults;
+    runQuery?: (source: string, languageId: string, queryText: string) => {
+        matches: NativeMatch[];
+    };
+    parseSyntaxTree?: (source: string, languageId: string) => NativeSyntaxTree;
+    tokenizeDuplicateSource?: (source: string) => NativeDuplicateTokens;
+    supportedLanguageIds: () => string[];
+};
+export type NativeBindingOrigin = {
+    mode: "workspace" | "package" | "cache";
+    packageName: string;
+    packageVersion?: string;
+    target?: string;
+    sourcePath?: string;
+    loadedPath?: string;
+    cacheKey?: string;
+    sha256?: string;
+    cacheError?: string;
+};
+export type NativeBindingState = {
+    loaded: true;
+    binding: NativeBinding;
+    supportedLanguageIds: Set<string>;
+    origin: NativeBindingOrigin;
+} | {
+    loaded: false;
+    error?: unknown;
+    origin?: NativeBindingOrigin;
+};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/native/contracts.d.ts.map

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

package/dist/native/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/native/contracts.js.map

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

package/dist/native/execution.d.ts

@@ -0,0 +1,16 @@
+import type { LanguageSupport } from "../languages.js";
+import type { CompactImportsExecution, NativeBindingState, NativeQueryExecution, NativeDuplicateTokens, NativeQueryResults, NativeQueryScope, NativeRuntimeMode, NativeSingleQueryExecution, NativeSyntaxTreeExecution } from "./contracts.js";
+export declare function isNativeDuplicateTokenizationAvailable(mode?: NativeRuntimeMode): boolean;
+export declare function getNativeDuplicateTokens(source: string, mode?: NativeRuntimeMode): NativeDuplicateTokens | null;
+export declare function runNativeLanguageQueries(source: string, support: LanguageSupport, mode?: NativeRuntimeMode): NativeQueryResults | null;
+export declare function getNativeQueryExecutionForState(source: string, support: LanguageSupport, state?: NativeBindingState, scope?: NativeQueryScope): NativeQueryExecution;
+export declare function getNativeQueryExecution(source: string, support: LanguageSupport, mode?: NativeRuntimeMode, scope?: NativeQueryScope): NativeQueryExecution;
+/**
+ * Run only the imports query with a compact payload (name + text only).
+ * Falls back to the full execution path if the compact entrypoint is not
+ * available in the native binding.
+ */
+export declare function getCompactImportsExecution(source: string, support: LanguageSupport, mode?: NativeRuntimeMode): CompactImportsExecution;
+export declare function getNativeSingleQueryExecution(source: string, support: LanguageSupport, queryText: string, mode?: NativeRuntimeMode): NativeSingleQueryExecution;
+export declare function getNativeSyntaxTreeExecution(source: string, support: LanguageSupport, mode?: NativeRuntimeMode): NativeSyntaxTreeExecution;
+//# sourceMappingURL=execution.d.ts.map

package/dist/native/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/native/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAIxB,wBAAgB,sCAAsC,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAIxF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,qBAAqB,GAAG,IAAI,CAS/G;AACD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,kBAAkB,GAAG,IAAI,CAE3B;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,KAAK,GAAE,kBAAkC,EACzC,KAAK,GAAE,gBAAyB,GAC/B,oBAAoB,CA0BtB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,iBAAiB,EACxB,KAAK,GAAE,gBAAyB,GAC/B,oBAAoB,CAItB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,uBAAuB,CAiCzB;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,iBAAiB,GACvB,0BAA0B,CA4B5B;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,yBAAyB,CA2B3B"}

package/dist/native/execution.js

@@ -0,0 +1,184 @@
+import { stringifyUnknown } from "../util/ast.js";
+import { errorMessage } from "../util/errors.js";
+import { getCachedNormalizedQuery, normalizeNativeQueryForSupport } from "./queries.js";
+import { loadBinding, resolveNativeBindingState, throwIfNativeRequiredUnavailable } from "./runtime.js";
+export function isNativeDuplicateTokenizationAvailable(mode) {
+    const state = resolveNativeBindingState(mode);
+    throwIfNativeRequiredUnavailable(mode, state);
+    return state.loaded && typeof state.binding.tokenizeDuplicateSource === "function";
+}
+export function getNativeDuplicateTokens(source, mode) {
+    const state = resolveNativeBindingState(mode);
+    throwIfNativeRequiredUnavailable(mode, state);
+    if (!state.loaded || !state.binding.tokenizeDuplicateSource)
+        return null;
+    try {
+        return state.binding.tokenizeDuplicateSource(source);
+    }
+    catch {
+        return null;
+    }
+}
+export function runNativeLanguageQueries(source, support, mode) {
+    return getNativeQueryExecution(source, support, mode).results;
+}
+export function getNativeQueryExecutionForState(source, support, state = loadBinding(), scope = "full") {
+    if (!state.loaded) {
+        return unavailableQueryExecution(state);
+    }
+    if (!state.supportedLanguageIds.has(support.id)) {
+        return { results: null, fallbackReason: "unsupportedLanguage" };
+    }
+    const importsOnly = scope === "imports";
+    try {
+        return {
+            results: state.binding.runLanguageQueries(source, support.id, getCachedNormalizedQuery(support, "imports"), importsOnly ? "" : getCachedNormalizedQuery(support, "exports"), importsOnly ? "" : getCachedNormalizedQuery(support, "locals"), importsOnly ? "" : getCachedNormalizedQuery(support, "importBindings")),
+        };
+    }
+    catch (error) {
+        return {
+            results: null,
+            fallbackReason: "queryFailure",
+            error: errorMessage(error),
+        };
+    }
+}
+export function getNativeQueryExecution(source, support, mode, scope = "full") {
+    const state = resolveNativeBindingState(mode);
+    throwIfNativeRequiredUnavailable(mode, state);
+    return getNativeQueryExecutionForState(source, support, state, scope);
+}
+/**
+ * Run only the imports query with a compact payload (name + text only).
+ * Falls back to the full execution path if the compact entrypoint is not
+ * available in the native binding.
+ */
+export function getCompactImportsExecution(source, support, mode) {
+    const state = resolveNativeBindingState(mode);
+    throwIfNativeRequiredUnavailable(mode, state);
+    if (!state.loaded) {
+        return unavailableCompactExecution(state);
+    }
+    if (!state.supportedLanguageIds.has(support.id)) {
+        return { results: null, fallbackReason: "unsupportedLanguage" };
+    }
+    const importsQuery = getCachedNormalizedQuery(support, "imports");
+    try {
+        if (state.binding.runImportsQueryCompact) {
+            return {
+                results: state.binding.runImportsQueryCompact(source, support.id, importsQuery),
+            };
+        }
+        const full = getNativeQueryExecutionForState(source, support, state, "imports");
+        if (!full.results)
+            return full;
+        return {
+            results: {
+                imports: full.results.imports.map((match) => ({
+                    patternIndex: match.patternIndex,
+                    captures: match.captures.map((capture) => ({ name: capture.name, text: capture.text })),
+                })),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            results: null,
+            fallbackReason: "queryFailure",
+            error: errorMessage(error),
+        };
+    }
+}
+export function getNativeSingleQueryExecution(source, support, queryText, mode) {
+    const state = resolveNativeBindingState(mode);
+    throwIfNativeRequiredUnavailable(mode, state);
+    if (!state.loaded) {
+        return unavailableSingleQueryExecution(state);
+    }
+    if (!state.supportedLanguageIds.has(support.id)) {
+        return { matches: null, fallbackReason: "unsupportedLanguage" };
+    }
+    if (!state.binding.runQuery) {
+        return {
+            matches: null,
+            fallbackReason: "unavailable",
+            error: "native binding does not expose runQuery",
+        };
+    }
+    const normalizedQuery = normalizeNativeQueryForSupport(support, "adHoc", queryText);
+    try {
+        return {
+            matches: state.binding.runQuery(source, support.id, normalizedQuery).matches,
+        };
+    }
+    catch (error) {
+        return {
+            matches: null,
+            fallbackReason: "queryFailure",
+            error: errorMessage(error),
+        };
+    }
+}
+export function getNativeSyntaxTreeExecution(source, support, mode) {
+    const state = resolveNativeBindingState(mode);
+    throwIfNativeRequiredUnavailable(mode, state);
+    if (!state.loaded) {
+        return unavailableSyntaxTreeExecution(state);
+    }
+    if (!state.supportedLanguageIds.has(support.id)) {
+        return { tree: null, fallbackReason: "unsupportedLanguage" };
+    }
+    if (!state.binding.parseSyntaxTree) {
+        return {
+            tree: null,
+            fallbackReason: "unavailable",
+            error: "native binding does not expose parseSyntaxTree",
+        };
+    }
+    try {
+        return {
+            tree: state.binding.parseSyntaxTree(source, support.id),
+        };
+    }
+    catch (error) {
+        return {
+            tree: null,
+            fallbackReason: "queryFailure",
+            error: errorMessage(error),
+        };
+    }
+}
+function unavailableQueryExecution(state) {
+    return {
+        results: null,
+        ...unavailableNativeFailure(state),
+    };
+}
+function unavailableCompactExecution(state) {
+    return {
+        results: null,
+        ...unavailableNativeFailure(state),
+    };
+}
+function unavailableSingleQueryExecution(state) {
+    return {
+        matches: null,
+        ...unavailableNativeFailure(state),
+    };
+}
+function unavailableSyntaxTreeExecution(state) {
+    return {
+        tree: null,
+        ...unavailableNativeFailure(state),
+    };
+}
+function unavailableNativeFailure(state) {
+    if (!state.error) {
+        return { fallbackReason: "unavailable" };
+    }
+    if (state.error instanceof Error) {
+        return { fallbackReason: "unavailable", error: state.error.message };
+    }
+    return { fallbackReason: "unavailable", error: stringifyUnknown(state.error) };
+}
+//# sourceMappingURL=execution.js.map

package/dist/native/execution.js.map

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

package/dist/native/jsBridge.d.ts

@@ -0,0 +1,7 @@
+import type { LanguageSupport } from "../languages.js";
+import type { NativeRuntimeMode, UnifiedQueryExecution } from "./contracts.js";
+export declare function supportsReducedModeRegexRecovery(languageId: string): boolean;
+export declare function getUnifiedQueryExecution(source: string, support: LanguageSupport, queryText: string, opts?: {
+    mode?: NativeRuntimeMode;
+}): UnifiedQueryExecution;
+//# sourceMappingURL=jsBridge.d.ts.map

package/dist/native/jsBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsBridge.d.ts","sourceRoot":"","sources":["../../src/native/jsBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAS/E,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IACL,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B,GACA,qBAAqB,CAcvB"}