@lzehrung/codegraph-core 2.1.0

package/dist/languages.js

@@ -0,0 +1,118 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getAllLanguages, getLanguageById } from "./languages/registry.js";
+import "./languages/all.js";
+function adaptDefinition(def) {
+    return {
+        id: def.id,
+        matchExts: def.extensions,
+        language: (filename) => def.grammar(filename),
+        nodeTypes: def.nodeTypes || { identifier: ["identifier"] },
+        queries: def.graph,
+        classifyDefinition: def.classifyDefinition || (() => "variable"),
+        isDeclarationName: def.isDeclarationName || (() => false),
+        scopeDeclarationNames: def.scopeDeclarationNames === "all" ? () => true : (def.scopeDeclarationNames ?? (() => false)),
+        createsBlockScope: def.createsBlockScope || (() => false),
+        createsFunctionScope: def.createsFunctionScope || (() => false),
+        membersAreImplicitlyInScope: def.membersAreImplicitlyInScope ?? true,
+        supportsCrossModuleSymbols: def.supportsCrossModuleSymbols || false,
+        isTypeOnly: def.isTypeOnly || (() => false),
+        usesQueryDrivenLocals: def.usesQueryDrivenLocals || false,
+        normalizeIdentifier: def.normalizeIdentifier || ((name) => name),
+        ...(def.native ? { native: def.native } : {}),
+    };
+}
+export const TS_SUPPORT = adaptDefinition(getLanguageById("ts"));
+export const TSX_SUPPORT = adaptDefinition(getLanguageById("tsx"));
+export const JS_SUPPORT = adaptDefinition(getLanguageById("js"));
+export const PY_SUPPORT = adaptDefinition(getLanguageById("python"));
+export const PHP_SUPPORT = adaptDefinition(getLanguageById("php"));
+export const HTML_SUPPORT = adaptDefinition(getLanguageById("html"));
+export const CSS_SUPPORT = adaptDefinition(getLanguageById("css"));
+export const SCSS_SUPPORT = adaptDefinition(getLanguageById("scss"));
+export const LESS_SUPPORT = adaptDefinition(getLanguageById("less"));
+export const VUE_SUPPORT = adaptDefinition(getLanguageById("vue"));
+export const SVELTE_SUPPORT = adaptDefinition(getLanguageById("svelte"));
+export const RUBY_SUPPORT = adaptDefinition(getLanguageById("ruby"));
+export const GO_SUPPORT = adaptDefinition(getLanguageById("go"));
+export const JAVA_SUPPORT = adaptDefinition(getLanguageById("java"));
+export const CSHARP_SUPPORT = adaptDefinition(getLanguageById("csharp"));
+export const RUST_SUPPORT = adaptDefinition(getLanguageById("rust"));
+export const C_SUPPORT = adaptDefinition(getLanguageById("c"));
+export const CPP_SUPPORT = adaptDefinition(getLanguageById("cpp"));
+export const KOTLIN_SUPPORT = adaptDefinition(getLanguageById("kotlin"));
+export const SWIFT_SUPPORT = adaptDefinition(getLanguageById("swift"));
+export const ZIG_SUPPORT = adaptDefinition(getLanguageById("zig"));
+export const SQL_SUPPORT = adaptDefinition(getLanguageById("sql"));
+export const LANGUAGE_SUPPORTS = getAllLanguages().map(adaptDefinition);
+const LANGUAGE_EXTENSION_KEY_PATTERN = /^\.[a-z0-9][a-z0-9._+-]*$/;
+const NON_REMAPPABLE_EXTENSIONS = new Set([".vue", ".svelte"]);
+export function isLiteralLanguageExtension(extension) {
+    return LANGUAGE_EXTENSION_KEY_PATTERN.test(extension.trim().toLowerCase());
+}
+export function isRemappableLanguageExtension(extension) {
+    return !NON_REMAPPABLE_EXTENSIONS.has(extension.trim().toLowerCase());
+}
+export function normalizeLanguageExtensions(extensions) {
+    const entries = Object.entries(extensions ?? {})
+        .map(([extension, languageId]) => [extension.trim().toLowerCase(), languageId.trim().toLowerCase()])
+        .filter(([extension, languageId]) => isLiteralLanguageExtension(extension) && isRemappableLanguageExtension(extension) && !!supportById(languageId))
+        .sort((left, right) => left[0].localeCompare(right[0]));
+    if (!entries.length)
+        return undefined;
+    return Object.fromEntries(entries);
+}
+function caseInsensitiveExtensionPattern(extension) {
+    const suffix = extension.replace(/[a-z]/g, (letter) => `[${letter}${letter.toUpperCase()}]`);
+    return `**/*${suffix}`;
+}
+export function languageExtensionPatterns(extensions) {
+    return Object.keys(normalizeLanguageExtensions(extensions) ?? {}).map(caseInsensitiveExtensionPattern);
+}
+function mappedSupportForFile(filename, extensionMap) {
+    const mappings = Object.entries(normalizeLanguageExtensions(extensionMap) ?? {}).sort((left, right) => right[0].length - left[0].length || left[0].localeCompare(right[0]));
+    const lowerFilename = filename.toLowerCase();
+    for (const [extension, languageId] of mappings) {
+        if (!lowerFilename.endsWith(extension))
+            continue;
+        return supportById(languageId);
+    }
+    return undefined;
+}
+export function supportForFile(filename, extensionMap) {
+    const mapped = extensionMap ? mappedSupportForFile(filename, extensionMap) : undefined;
+    if (mapped)
+        return mapped;
+    const ext = path.extname(filename).toLowerCase();
+    if (ext === ".h") {
+        const sample = readFileSample(filename);
+        if (sample && isLikelyCppHeader(sample))
+            return CPP_SUPPORT;
+        return C_SUPPORT;
+    }
+    return LANGUAGE_SUPPORTS.find((s) => s.matchExts.includes(ext));
+}
+export function languageForFile(filename, extensionMap) {
+    const sup = supportForFile(filename, extensionMap);
+    if (!sup)
+        throw new Error(`Unsupported file extension: ${filename}`);
+    return sup.language(filename);
+}
+export function supportById(id) {
+    return LANGUAGE_SUPPORTS.find((s) => s.id === id);
+}
+const HEADER_SAMPLE_SIZE = 8000;
+const CPP_HEADER_HINT = /\b(class|namespace|template|typename|constexpr|operator|using\s+namespace)\b|::/;
+function readFileSample(filePath) {
+    try {
+        const contents = fs.readFileSync(filePath, "utf8");
+        return contents.slice(0, HEADER_SAMPLE_SIZE);
+    }
+    catch {
+        return null;
+    }
+}
+function isLikelyCppHeader(sample) {
+    return CPP_HEADER_HINT.test(sample);
+}
+//# sourceMappingURL=languages.js.map

package/dist/languages.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,5 @@
+export type LogLevel = "error" | "warn" | "info" | "debug" | "silent";
+export type LogSeverity = "error" | "warn" | "info" | "debug";
+export declare function shouldLog(level: LogLevel | undefined, severity: LogSeverity): boolean;
+export declare function logWithLevel(level: LogLevel | undefined, severity: LogSeverity, ...args: unknown[]): void;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAiB9D,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAGrF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAgBzG"}

package/dist/logging.js

@@ -0,0 +1,35 @@
+const LOG_LEVEL_RANK = {
+    silent: -1,
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+};
+const LOG_SEVERITY_RANK = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+};
+export function shouldLog(level, severity) {
+    const effectiveLevel = level ?? "warn";
+    return LOG_LEVEL_RANK[effectiveLevel] >= LOG_SEVERITY_RANK[severity];
+}
+export function logWithLevel(level, severity, ...args) {
+    if (!shouldLog(level, severity))
+        return;
+    if (severity === "error") {
+        console.error(...args);
+        return;
+    }
+    if (severity === "warn") {
+        console.warn(...args);
+        return;
+    }
+    if (severity === "info") {
+        console.info(...args);
+        return;
+    }
+    console.debug(...args);
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAA6B;IAC/C,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,iBAAiB,GAAgC;IACrD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,KAA2B,EAAE,QAAqB;IAC1E,MAAM,cAAc,GAAG,KAAK,IAAI,MAAM,CAAC;IACvC,OAAO,cAAc,CAAC,cAAc,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA2B,EAAE,QAAqB,EAAE,GAAG,IAAe;IACjG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,OAAO;IAExC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,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":"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"}

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":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,cAAc,EAAE,WAAW,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,qBAAqB,GAAG,cAAc,CAAC;AAE1F,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,QAAQ,CAAC;IAClB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB,EAAE,CAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,KACxB,kBAAkB,CAAC;IACxB,eAAe,EAAE,CACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,KACxB,wBAAwB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAC3G,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IACjG,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC3E,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,qBAAqB,CAAC;IACpE,oBAAoB,EAAE,MAAM,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IACE,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,mBAAmB,CAAC;CAC7B,GACD;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC"}

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"}