@lzehrung/codegraph 2.1.0

package/dist/indexer/incremental-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-plan.d.ts","sourceRoot":"","sources":["../../src/indexer/incremental-plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAKxE,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,GAAE,MAAsC,GAClD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAM/B;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYjE;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,GAAG,yBAAyB,CAMnH;AAED,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACjD,WAAW,GAAE,MAAsC,GAClD,OAAO,CAAC,uBAAuB,CAAC,CAclC;AAED,wBAAgB,mCAAmC,CACjD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACjD,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,GACvC,GAAG,CAAC,MAAM,CAAC,CAWb;AAED,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACjD,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,GAAG,CAAC,MAAM,CAAC,CAkCb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,2BAA2B,GAAG,SAAS,EAClD,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAEnH;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAyCrC;AACD,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAG1B"}

package/dist/indexer/incremental-plan.js

@@ -0,0 +1,212 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import { diffBuildOptions, loadManifest, sanitizeManifestEntriesForRoot, } from "./build-cache.js";
+import { listChangedFiles, listUntrackedFiles } from "../util/git.js";
+import { errorMessage } from "../util/errors.js";
+import { fileIdentityKey } from "../util/paths.js";
+import { mapLimit } from "../util/concurrency.js";
+import { createDiscoveredFileMatcher, DEFAULT_PROJECT_PATTERNS, filterRealPathsWithinRoot, } from "../util/projectFiles.js";
+/** Bound concurrent existence probes so warm builds don't stall the event loop. */
+export const PATH_EXISTS_PROBE_CONCURRENCY = 64;
+export async function pathExists(filePath) {
+    try {
+        await fsp.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe unique paths once with bounded concurrency. Scaling: O(unique paths)
+ * syscalls instead of O(call sites × paths).
+ */
+export async function probePathExistence(paths, concurrency = PATH_EXISTS_PROBE_CONCURRENCY) {
+    const uniquePaths = Array.from(new Set(paths));
+    const results = await mapLimit(uniquePaths, concurrency, async (filePath) => {
+        return [filePath, await pathExists(filePath)];
+    });
+    return new Map(results);
+}
+export function isMissingGitRevisionError(error) {
+    const message = errorMessage(error);
+    return (message.includes("Invalid revision range") ||
+        message.includes("bad revision") ||
+        // A single-revision diff against WORKTREE (git diff --end-of-options <base>) reports
+        // a missing base commit as "bad object", not "bad revision" (that phrasing is
+        // specific to two-dot/three-dot range syntax); both mean the same thing here.
+        message.includes("bad object") ||
+        message.includes("unknown revision") ||
+        message.includes("ambiguous argument"));
+}
+export function buildIncrementalGitDiffOptions(opts) {
+    const gitOpts = {};
+    if (opts?.gitBase)
+        gitOpts.base = opts.gitBase;
+    if (opts?.gitHead)
+        gitOpts.head = opts.gitHead;
+    if (!opts?.gitBase && opts?.changedSince)
+        gitOpts.changedSince = opts.changedSince;
+    return gitOpts;
+}
+export async function partitionTrackedManifestFiles(trackedEntries, concurrency = PATH_EXISTS_PROBE_CONCURRENCY) {
+    const trackedFileList = Object.keys(trackedEntries);
+    const existence = await probePathExistence(trackedFileList, concurrency);
+    const trackedFiles = new Set();
+    const deletedTrackedFiles = new Set();
+    for (const file of trackedFileList) {
+        if (existence.get(file))
+            trackedFiles.add(file);
+        else
+            deletedTrackedFiles.add(file);
+    }
+    return {
+        trackedFileList,
+        trackedFiles,
+        deletedTrackedFiles,
+    };
+}
+export function collectDeletedTrackedFileDependents(trackedEntries, deletedTrackedFiles) {
+    const dependents = new Set();
+    if (!deletedTrackedFiles.size)
+        return dependents;
+    const deletedFileKeys = new Set(Array.from(deletedTrackedFiles, fileIdentityKey));
+    for (const [file, entry] of Object.entries(trackedEntries)) {
+        if (deletedFileKeys.has(fileIdentityKey(file)))
+            continue;
+        if (entry.edges.some((edge) => edge.to.type === "file" && deletedFileKeys.has(fileIdentityKey(edge.to.path)))) {
+            dependents.add(file);
+        }
+    }
+    return dependents;
+}
+export function collectTrackedFileDependents(trackedEntries, changedFiles) {
+    const dependents = new Set();
+    if (!changedFiles.size)
+        return dependents;
+    const reverseDeps = new Map();
+    for (const [file, entry] of Object.entries(trackedEntries)) {
+        for (const edge of entry.edges) {
+            if (edge.to.type !== "file")
+                continue;
+            const importedFileKey = fileIdentityKey(edge.to.path);
+            let bucket = reverseDeps.get(importedFileKey);
+            if (!bucket) {
+                bucket = new Set();
+                reverseDeps.set(importedFileKey, bucket);
+            }
+            bucket.add(file);
+        }
+    }
+    const enqueued = new Set(Array.from(changedFiles, fileIdentityKey));
+    const queue = [...enqueued];
+    let head = 0;
+    while (head < queue.length) {
+        const targetKey = queue[head];
+        head += 1;
+        for (const dependent of reverseDeps.get(targetKey) ?? []) {
+            const dependentKey = fileIdentityKey(dependent);
+            if (enqueued.has(dependentKey))
+                continue;
+            enqueued.add(dependentKey);
+            dependents.add(dependent);
+            queue.push(dependentKey);
+        }
+    }
+    return dependents;
+}
+/**
+ * List new, untracked files that Git sees but the manifest does not yet know about,
+ * filtered to the same discovery patterns/ignores a full scan would apply.
+ *
+ * This is the one piece a manifest-plus-git-diff reconciliation cannot otherwise cover:
+ * modified and deleted tracked files are already detected cheaply via git diff and
+ * per-file signature checks, but a file that was just created and never committed or
+ * staged has no tracked entry and no diff record. Errors are not swallowed here;
+ * callers decide whether a failure should fall back to a full scan or be treated as a
+ * best-effort miss.
+ *
+ * When `discovery.useGitignore` is `false`, Git's `--exclude-standard` is dropped too:
+ * that mode explicitly wants gitignored files included, so filtering untracked
+ * candidates through `.gitignore` here would be exactly backwards. The default
+ * project-file ignores (`node_modules`, `.git`, build output, ...) still apply via
+ * `createDiscoveredFileMatcher()` below regardless of this setting.
+ */
+export async function listUntrackedProjectFiles(projectRoot, discovery, gitAvailable) {
+    if (!gitAvailable)
+        return [];
+    const respectGitignore = discovery?.useGitignore !== false;
+    const candidates = await listUntrackedFiles(projectRoot, { gitAvailable, respectGitignore });
+    if (!candidates.length)
+        return [];
+    const globRoot = discovery?.globRoot ?? projectRoot;
+    const isDiscoveredFile = createDiscoveredFileMatcher(projectRoot, globRoot, DEFAULT_PROJECT_PATTERNS, discovery);
+    const matchingCandidates = candidates.filter(isDiscoveredFile);
+    if (!matchingCandidates.length)
+        return [];
+    const realRoot = await fs.promises.realpath(projectRoot);
+    return filterRealPathsWithinRoot(matchingCandidates, realRoot);
+}
+/**
+ * Whether the cheap manifest-plus-git discovery path can stand in for a full recursive
+ * scan. Requires a Git repository (the only source of untracked-file detection this
+ * fast path has) and no `--cache-strict` request (an explicit ask for maximum
+ * certainty over speed). `useGitignore: false` no longer disqualifies the fast path:
+ * `listUntrackedProjectFiles()` drops `--exclude-standard` in that mode instead of
+ * giving up, so it stays correct either way.
+ */
+export function canUseIncrementalDiscoveryFastPath(gitAvailable, cacheStrict) {
+    return gitAvailable && !cacheStrict;
+}
+export async function resolveIncrementalFilePlan(projectRoot, opts) {
+    const manifest = await loadManifest(projectRoot, opts);
+    if (!manifest)
+        return null;
+    if (!manifest.buildOptions)
+        return null;
+    if (diffBuildOptions(manifest.buildOptions, opts).includes("discovery"))
+        return null;
+    if (opts?.cacheStrict)
+        return null;
+    try {
+        const trackedEntries = sanitizeManifestEntriesForRoot(projectRoot, manifest.files);
+        const { trackedFiles } = await partitionTrackedManifestFiles(trackedEntries);
+        // Diff against the working tree, not just the current commit: a file that was
+        // `git add`ed but never committed is neither in the manifest (not yet indexed) nor
+        // reported by `git ls-files --others` (it is no longer "untracked" once staged), so
+        // a commit-only diff would miss it entirely whenever HEAD hasn't moved. Diffing the
+        // last-indexed commit against WORKTREE catches staged and unstaged tracked-file
+        // changes together, including new commits made since (working tree reflects those
+        // too when clean), so this replaces the narrower commit-to-commit comparison.
+        const [workingTreeDiffFiles, untrackedFiles] = await Promise.all([
+            manifest.lastCommit ? listChangedFiles(projectRoot, { base: manifest.lastCommit, head: "WORKTREE" }) : [],
+            listUntrackedProjectFiles(projectRoot, opts?.discovery, true),
+        ]);
+        const candidatePaths = [...workingTreeDiffFiles, ...untrackedFiles];
+        const existence = candidatePaths.length ? await probePathExistence(candidatePaths) : new Map();
+        const files = new Set(trackedFiles);
+        for (const file of workingTreeDiffFiles)
+            if (existence.get(file))
+                files.add(file);
+        for (const file of untrackedFiles)
+            if (existence.get(file))
+                files.add(file);
+        return {
+            files: Array.from(files).sort(),
+            manifestUpdatedAt: manifest.updatedAt,
+            workingTreeDiffFiles,
+            untrackedFiles,
+        };
+    }
+    catch {
+        // Any failure here (stale/missing manifest commit, transient Git error, ...) means
+        // the fast path cannot be trusted. Fall back to a full scan rather than risk an
+        // incomplete or stale file list.
+        return null;
+    }
+}
+export async function resolveIncrementalFileList(projectRoot, opts) {
+    const plan = await resolveIncrementalFilePlan(projectRoot, opts);
+    return plan?.files ?? null;
+}
+//# sourceMappingURL=incremental-plan.js.map

package/dist/indexer/incremental-plan.js.map

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

package/dist/indexer/load-current-index.d.ts

@@ -0,0 +1,51 @@
+import type { IncrementalBuildOptions, ProjectIndex } from "./types.js";
+/**
+ * Scope of a current-repository-state index load.
+ *
+ * `project` lets discovery decide the file set, optionally unioning
+ * `additionalFiles` (for example review targets outside discovery). `resolved-files`
+ * declares an already resolved, complete file scope. Neither variant can express
+ * "these files changed"; changed-file inputs belong to `buildProjectIndexIncremental`.
+ */
+export type CurrentProjectIndexScope = {
+    kind: "project";
+    additionalFiles?: readonly string[];
+} | {
+    kind: "resolved-files";
+    files: readonly string[];
+};
+/**
+ * Build options accepted for current-state loads.
+ *
+ * Scope encoding and change-range selection are deliberately excluded: they are
+ * expressed by {@link CurrentProjectIndexScope} or belong to specialized
+ * incremental callers such as `graph-delta` and `drift`.
+ */
+export type LoadCurrentProjectIndexOptions = Omit<IncrementalBuildOptions, "files" | "additionalFiles" | "filesAreProjectScope" | "gitBase" | "gitHead" | "changedSince" | "reconciledManifestUpdatedAt" | "reconciledWorkingTreeDiffFiles" | "reconciledUntrackedFiles">;
+export type LoadCurrentProjectIndexRequest = {
+    root: string;
+    scope: CurrentProjectIndexScope;
+    options?: LoadCurrentProjectIndexOptions;
+};
+/** Bound loader handed to command handlers so they cannot select a full-build path. */
+export type CurrentProjectIndexLoader = () => Promise<ProjectIndex>;
+/**
+ * Translate a current-state request into incremental build options.
+ *
+ * The disk cache is the default because current-state queries must validate
+ * persisted state instead of rebuilding; an explicit `off`/`memory`/`disk` mode
+ * from the caller always wins.
+ */
+export declare function currentProjectIndexBuildOptions(scope: CurrentProjectIndexScope, options?: LoadCurrentProjectIndexOptions): IncrementalBuildOptions;
+/**
+ * Load the index for current repository state.
+ *
+ * All freshness decisions (manifest compatibility, discovery/config/native/graph
+ * options, file signatures, Git reconciliation, snapshot validation, dependent
+ * invalidation, and rebuild fallback) stay in `buildProjectIndexIncremental`.
+ * This helper only encodes intent: current state, declared scope, disk default.
+ */
+export declare function loadCurrentProjectIndex(request: LoadCurrentProjectIndexRequest): Promise<ProjectIndex>;
+/** Bind a project-scope loader for handlers that receive index loading by injection. */
+export declare function createCurrentProjectIndexLoader(root: string, options?: LoadCurrentProjectIndexOptions, scope?: CurrentProjectIndexScope): CurrentProjectIndexLoader;
+//# sourceMappingURL=load-current-index.d.ts.map

package/dist/indexer/load-current-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-current-index.d.ts","sourceRoot":"","sources":["../../src/indexer/load-current-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAElH;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,uBAAuB,EACrB,OAAO,GACP,iBAAiB,GACjB,sBAAsB,GACtB,SAAS,GACT,SAAS,GACT,cAAc,GACd,6BAA6B,GAC7B,gCAAgC,GAChC,0BAA0B,CAC7B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,wBAAwB,CAAC;IAChC,OAAO,CAAC,EAAE,8BAA8B,CAAC;CAC1C,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;AAcpE;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE,8BAA8B,GACvC,uBAAuB,CAiBzB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,YAAY,CAAC,CAM5G;AAED,wFAAwF;AACxF,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,8BAA8B,EACxC,KAAK,GAAE,wBAA8C,GACpD,yBAAyB,CAE3B"}

package/dist/indexer/load-current-index.js

@@ -0,0 +1,53 @@
+const NON_CURRENT_STATE_OPTION_KEYS = [
+    "files",
+    "additionalFiles",
+    "filesAreProjectScope",
+    "gitBase",
+    "gitHead",
+    "changedSince",
+    "reconciledManifestUpdatedAt",
+    "reconciledWorkingTreeDiffFiles",
+    "reconciledUntrackedFiles",
+];
+/**
+ * Translate a current-state request into incremental build options.
+ *
+ * The disk cache is the default because current-state queries must validate
+ * persisted state instead of rebuilding; an explicit `off`/`memory`/`disk` mode
+ * from the caller always wins.
+ */
+export function currentProjectIndexBuildOptions(scope, options) {
+    const buildOptions = { ...options };
+    // Callers may forward a wider options object; strip anything that would be
+    // reinterpreted as scope or as a changed-file range.
+    for (const key of NON_CURRENT_STATE_OPTION_KEYS) {
+        delete buildOptions[key];
+    }
+    buildOptions.cache = options?.cache ?? "disk";
+    if (scope.kind === "resolved-files") {
+        buildOptions.files = [...scope.files];
+        buildOptions.filesAreProjectScope = true;
+        return buildOptions;
+    }
+    if (scope.additionalFiles?.length) {
+        buildOptions.additionalFiles = [...scope.additionalFiles];
+    }
+    return buildOptions;
+}
+/**
+ * Load the index for current repository state.
+ *
+ * All freshness decisions (manifest compatibility, discovery/config/native/graph
+ * options, file signatures, Git reconciliation, snapshot validation, dependent
+ * invalidation, and rebuild fallback) stay in `buildProjectIndexIncremental`.
+ * This helper only encodes intent: current state, declared scope, disk default.
+ */
+export async function loadCurrentProjectIndex(request) {
+    const { buildProjectIndexIncremental } = await import("./build-index.js");
+    return await buildProjectIndexIncremental(request.root, currentProjectIndexBuildOptions(request.scope, request.options));
+}
+/** Bind a project-scope loader for handlers that receive index loading by injection. */
+export function createCurrentProjectIndexLoader(root, options, scope = { kind: "project" }) {
+    return async () => await loadCurrentProjectIndex({ root, scope, ...(options ? { options } : {}) });
+}
+//# sourceMappingURL=load-current-index.js.map

package/dist/indexer/load-current-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-current-index.js","sourceRoot":"","sources":["../../src/indexer/load-current-index.ts"],"names":[],"mappings":"AA4CA,MAAM,6BAA6B,GAAG;IACpC,OAAO;IACP,iBAAiB;IACjB,sBAAsB;IACtB,SAAS;IACT,SAAS;IACT,cAAc;IACd,6BAA6B;IAC7B,gCAAgC;IAChC,0BAA0B;CAClB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA+B,EAC/B,OAAwC;IAExC,MAAM,YAAY,GAA4B,EAAE,GAAG,OAAO,EAAE,CAAC;IAC7D,2EAA2E;IAC3E,qDAAqD;IACrD,KAAK,MAAM,GAAG,IAAI,6BAA6B,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,YAAY,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACpC,YAAY,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,YAAY,CAAC,oBAAoB,GAAG,IAAI,CAAC;QACzC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QAClC,YAAY,CAAC,eAAe,GAAG,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAuC;IACnF,MAAM,EAAE,4BAA4B,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC1E,OAAO,MAAM,4BAA4B,CACvC,OAAO,CAAC,IAAI,EACZ,+BAA+B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,OAAwC,EACxC,QAAkC,EAAE,IAAI,EAAE,SAAS,EAAE;IAErD,OAAO,KAAK,IAAI,EAAE,CAAC,MAAM,uBAAuB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACrG,CAAC"}

package/dist/indexer/locals-and-exports.d.ts

@@ -0,0 +1,12 @@
+import type { LogLevel } from "../logging.js";
+import { type NativeQueryResults, type NativeRuntimeMode } from "../native/treeSitterNative.js";
+import type { LanguageSupport } from "../languages.js";
+import type { ParserLanguage, SyntaxTreeLike } from "../languages/types.js";
+import type { ImportBinding, ModuleIndex } from "./types.js";
+export declare function collectLocalsAndExportsFromSource(file: string, source: string, support: LanguageSupport, lang?: ParserLanguage, imports?: ImportBinding[], opts?: {
+    tree?: SyntaxTreeLike;
+    nativeQueries?: NativeQueryResults | null;
+    nativeMode?: NativeRuntimeMode;
+    logLevel?: LogLevel;
+}): ModuleIndex;
+//# sourceMappingURL=locals-and-exports.d.ts.map

package/dist/indexer/locals-and-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locals-and-exports.d.ts","sourceRoot":"","sources":["../../src/indexer/locals-and-exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAkB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAe,aAAa,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AAsNrF,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,GAAE,aAAa,EAAO,EAC7B,IAAI,CAAC,EAAE;IACL,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,aAAa,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GACA,WAAW,CAgsBb"}