@saluzi/codegraph 0.2.0 → 0.2.1

package/dist/extraction/parse-pool.js

@@ -0,0 +1,387 @@
+"use strict";
+/**
+ * Parse worker pool — runs tree-sitter parsing across N worker threads so a full
+ * `codegraph index` uses every core instead of pinning one.
+ *
+ * Why this exists: `ExtractionOrchestrator.indexAll()` already reads files in
+ * parallel, but it parsed them through a SINGLE worker thread, so on an
+ * N-core machine indexing a large repo used one core and left the rest idle
+ * (issue #1015, the parse-time half of #320). Spreading the parse calls across a
+ * pool of workers — each its own tree-sitter WASM heap — restores multi-core
+ * throughput. SQLite storage stays on the main thread (it isn't thread-safe), so
+ * only the CPU-bound parse step is parallelised; results are stored as they
+ * arrive, in whatever order they finish.
+ *
+ * Design mirrors {@link ../mcp/query-pool} (idle-list dispatch, lazy growth,
+ * throttled cold-starts, crash recovery), with parse-specific behaviour:
+ *   - per-worker recycle: WASM linear memory grows but never shrinks, so each
+ *     worker is torn down and replaced after `recycleInterval` parses to reclaim
+ *     its heap — the same reason the old single worker recycled.
+ *   - reject, don't retry: a parse that crashes or times out its worker REJECTS
+ *     (with a message the orchestrator's retry pass recognises) rather than being
+ *     silently requeued — the orchestrator owns the smarter two-stage retry
+ *     (fresh worker, then comment-stripped) on a clean WASM heap.
+ *   - a size-1 pool reproduces the old single-worker path exactly, which is the
+ *     conservative rollback: set `CODEGRAPH_PARSE_WORKERS=1`.
+ *
+ * Memory: peak scales with pool size (≈ size × a worker's pre-recycle heap), so
+ * the default is capped and the env var lets constrained machines dial it down.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseWorkerPool = void 0;
+exports.resolveParseTimeoutMs = resolveParseTimeoutMs;
+exports.resolveParsePoolSize = resolveParsePoolSize;
+const worker_threads_1 = require("worker_threads");
+/** Default upper bound on the pool size derived from the core count. */
+const DEFAULT_PARSE_POOL_CAP = 8;
+/** Hard ceiling on pool size regardless of an explicit env override. */
+const MAX_PARSE_POOL_SIZE = 16;
+/** Parses a worker performs before it's recycled to reclaim WASM heap. */
+const DEFAULT_RECYCLE_INTERVAL = 250;
+/** Base per-parse timeout; scaled up for large files by the caller's formula. */
+const DEFAULT_PARSE_TIMEOUT_MS = 10_000;
+/**
+ * A worker is only killed once a parse has gone this many × its budget with no
+ * result. The base timer firing is NOT proof the parse is still running: after
+ * a long synchronous main-thread stretch (the SQLite store on slow disks,
+ * issue #1231) Node runs the timers phase before the poll phase, so the
+ * expired timer fires BEFORE an already-delivered `parse-result` is processed.
+ * Killing at the base timeout therefore produced false timeouts on parses that
+ * finished instantly (even 0-byte files). Instead the base timer only marks
+ * the job late; a result that arrives before this backstop is accepted, and
+ * only a worker that stays silent the whole window is treated as hung.
+ */
+const HARD_KILL_MULTIPLIER = 3;
+/**
+ * Max workers cold-starting at once. A worker's cold start is heavy (module load
+ * + grammar WASM compile); starting the whole pool simultaneously thrashes CPU.
+ * Warming a couple at a time keeps each start fast while the pool still reaches
+ * full size within a few parses of a large run.
+ */
+const MAX_CONCURRENT_SPAWN = 2;
+/**
+ * Total worker deaths before the pool stops respawning and fails outstanding
+ * work, so a systematically-broken worker platform degrades instead of
+ * respawning forever. Set high: normal per-file WASM crashes are cleared by the
+ * orchestrator's retry pass and shouldn't trip this on a merely-crashy repo.
+ */
+const CRASH_BUDGET = 100;
+/**
+ * Resolve the pool size from the `CODEGRAPH_PARSE_WORKERS` override and the
+ * machine's core count.
+ *   - explicit `0` or `1` → 1 worker (the old single-worker path; the rollback).
+ *   - explicit `N` → N, clamped to [1, 16].
+ *   - unset / blank / non-numeric → `clamp(cores - 1, 1, 8)` (leave a core for
+ *     the main thread + UI; never zero — parsing always needs a worker).
+ */
+/**
+ * Resolve the base per-parse timeout from the `CODEGRAPH_PARSE_TIMEOUT_MS`
+ * override. Slow storage (HDD, network folders) can need a larger budget; a
+ * non-numeric / non-positive value falls back to the default (10s).
+ */
+function resolveParseTimeoutMs(envVal) {
+    if (envVal !== undefined && envVal !== '') {
+        const n = Number(envVal);
+        if (Number.isFinite(n) && n > 0)
+            return Math.floor(n);
+    }
+    return DEFAULT_PARSE_TIMEOUT_MS;
+}
+function resolveParsePoolSize(envVal, cpuCount) {
+    if (envVal !== undefined && envVal !== '') {
+        const n = Number(envVal);
+        if (Number.isFinite(n) && n >= 0) {
+            return Math.max(1, Math.min(Math.floor(n), MAX_PARSE_POOL_SIZE));
+        }
+        // non-numeric / negative → fall through to the default
+    }
+    return Math.max(1, Math.min(cpuCount - 1, DEFAULT_PARSE_POOL_CAP));
+}
+class ParseWorkerPool {
+    idle = [];
+    queue = [];
+    inflight = new Map();
+    workers = new Set();
+    // Spawned but not yet 'grammars-loaded'. Growth counts these so a single first
+    // parse doesn't spawn the whole pool before the eager worker reports ready.
+    pending = new Set();
+    parseCounts = new Map();
+    nextId = 1;
+    totalCrashes = 0;
+    destroyed = false;
+    languages;
+    maxSize;
+    recycleInterval;
+    parseTimeoutMs;
+    createWorker;
+    log;
+    grammarBuffers;
+    constructor(opts) {
+        this.languages = opts.languages;
+        this.grammarBuffers = opts.grammarBuffers;
+        this.maxSize = Math.max(1, Math.min(opts.size, MAX_PARSE_POOL_SIZE));
+        this.recycleInterval = opts.recycleInterval ?? DEFAULT_RECYCLE_INTERVAL;
+        this.parseTimeoutMs = opts.parseTimeoutMs ?? DEFAULT_PARSE_TIMEOUT_MS;
+        this.log = opts.log ?? (() => { });
+        if (opts.createWorker) {
+            this.createWorker = opts.createWorker;
+        }
+        else if (opts.workerScriptPath) {
+            const scriptPath = opts.workerScriptPath;
+            this.createWorker = () => new worker_threads_1.Worker(scriptPath);
+        }
+        else {
+            throw new Error('ParseWorkerPool requires workerScriptPath or createWorker');
+        }
+        this.spawnOne(); // one eager warm worker, ready for the first parse
+    }
+    /** Pool size cap (for logging). */
+    get size() { return this.maxSize; }
+    /** Live worker count (for tests). */
+    get liveWorkers() { return this.workers.size; }
+    /** False once the crash budget is exhausted (or after destroy). */
+    get healthy() {
+        return !this.destroyed && this.totalCrashes < CRASH_BUDGET;
+    }
+    /**
+     * Parse one file on the pool. Resolves with the extraction result, or REJECTS
+     * if the parse times out or its worker crashes — the caller records the error
+     * and (for worker-exit/OOM/timeout rejections) re-attempts in its retry pass.
+     */
+    requestParse(task) {
+        if (this.destroyed)
+            return Promise.reject(new Error('Parse pool destroyed'));
+        return new Promise((resolve, reject) => {
+            this.queue.push({ id: this.nextId++, task, resolve, reject, settled: false });
+            this.drain();
+        });
+    }
+    spawnOne() {
+        if (this.destroyed || this.workers.size >= this.maxSize || !this.healthy)
+            return;
+        let w;
+        try {
+            w = this.createWorker();
+        }
+        catch {
+            this.totalCrashes++; // counts toward the circuit breaker
+            return;
+        }
+        this.workers.add(w);
+        this.pending.add(w);
+        this.parseCounts.set(w, 0);
+        w.on('message', (m) => this.onMessage(w, (m ?? {})));
+        w.on('error', (e) => this.onWorkerGone(w, `Worker error: ${e?.message ?? 'unknown'}`));
+        w.on('exit', (code) => { if (code !== 0)
+            this.onWorkerGone(w, `Worker exited with code ${code}`); });
+        // Load grammars; the worker replies 'grammars-loaded' and only then is idle.
+        // Pre-read WASM bytes (when the orchestrator provided them) make this a
+        // memory load instead of a per-spawn disk read.
+        w.postMessage({ type: 'load-grammars', languages: this.languages, grammarBuffers: this.grammarBuffers });
+    }
+    onMessage(w, m) {
+        if (m.type === 'grammars-loaded') {
+            if (!this.workers.has(w))
+                return; // recycled/destroyed before ready
+            this.pending.delete(w);
+            this.idle.push(w);
+            this.drain();
+            return;
+        }
+        if (m.type === 'parse-result') {
+            const job = this.inflight.get(w);
+            if (!job || (m.id !== undefined && m.id !== job.id))
+                return; // stale (post-recycle)
+            this.inflight.delete(w);
+            if (job.timerExpired) {
+                // The base timer fired before this result was processed. That almost
+                // always means the MAIN THREAD was stalled (sync SQLite store on slow
+                // disks) while the parse itself finished long ago — the worker's own
+                // clock (parseMs) tells the two apart. Either way the result is here
+                // and valid: accept it instead of the old behaviour (kill worker +
+                // reject), which turned every main-thread stall into false timeouts
+                // and dropped files (issue #1231).
+                const parseMs = typeof m.parseMs === 'number' ? Math.round(m.parseMs) : undefined;
+                const detail = parseMs === undefined
+                    ? ''
+                    : parseMs < (job.budgetMs ?? this.parseTimeoutMs)
+                        ? ` (parse took ${parseMs}ms in-worker — the main thread was stalled, not the parse)`
+                        : ` (parse genuinely took ${parseMs}ms)`;
+                this.log(`Late parse-result accepted: ${job.task.filePath}${detail}`);
+            }
+            // Recycle the worker once it's done enough parses to have grown its WASM
+            // heap; otherwise return it to the idle set for the next job.
+            if ((this.parseCounts.get(w) ?? 0) >= this.recycleInterval) {
+                this.recycle(w);
+            }
+            else {
+                this.idle.push(w);
+            }
+            this.settle(job, m.result);
+            this.drain();
+        }
+    }
+    /** A worker died (crash hook / OOM exit / spawn error). Reject its in-flight
+     *  parse so the caller's retry pass can re-attempt it, then respawn. */
+    onWorkerGone(w, message) {
+        if (!this.workers.has(w))
+            return; // already handled (error+exit both fire), or recycled
+        this.removeWorker(w);
+        this.totalCrashes++;
+        const job = this.inflight.get(w);
+        this.inflight.delete(w);
+        try {
+            void w.terminate();
+        }
+        catch { /* already gone */ }
+        if (job)
+            this.settle(job, undefined, new Error(message));
+        if (this.healthy)
+            this.spawnOne(); // keep capacity
+        this.drain();
+    }
+    /** Tear down a worker that has hit its recycle threshold and replace it. Not a
+     *  crash, so it doesn't count against the budget. */
+    recycle(w) {
+        this.log(`Recycling worker after ${this.parseCounts.get(w)} parses (heap: ${Math.round(process.memoryUsage().rss / 1024 / 1024)}MB RSS)`);
+        this.removeWorker(w);
+        // Fire-and-forget: worker.terminate() can hang if WASM is wedged.
+        try {
+            void w.terminate();
+        }
+        catch { /* already gone */ }
+        if (this.healthy && !this.destroyed)
+            this.spawnOne();
+    }
+    removeWorker(w) {
+        this.workers.delete(w);
+        this.pending.delete(w);
+        this.parseCounts.delete(w);
+        this.idle = this.idle.filter((x) => x !== w);
+    }
+    dispatch(w, job) {
+        this.inflight.set(w, job);
+        this.parseCounts.set(w, (this.parseCounts.get(w) ?? 0) + 1);
+        // Scale the timeout for large files: base + 10s per 100KB (matches the
+        // original single-worker formula so pathological-file behaviour is unchanged).
+        const timeoutMs = this.parseTimeoutMs + Math.floor(job.task.content.length / 100_000) * 10_000;
+        job.budgetMs = timeoutMs;
+        job.timer = setTimeout(() => this.onTimeout(w, job, timeoutMs), timeoutMs);
+        job.timer.unref?.();
+        w.postMessage({
+            type: 'parse',
+            id: job.id,
+            filePath: job.task.filePath,
+            content: job.task.content,
+            frameworkNames: job.task.frameworkNames,
+            language: job.task.language,
+        });
+    }
+    /**
+     * The base timer fired with no result processed yet. Do NOT kill or settle:
+     * the timer firing doesn't prove the parse is still running — after a long
+     * synchronous main-thread stretch Node services the timers phase before the
+     * poll phase, so an already-delivered `parse-result` is still queued behind
+     * this callback. Mark the job late (onMessage accepts a result that shows up)
+     * and arm the hard-kill backstop for workers that are genuinely hung.
+     */
+    onTimeout(w, job, ms) {
+        if (job.settled || !this.workers.has(w))
+            return;
+        const graceMs = ms * (HARD_KILL_MULTIPLIER - 1);
+        this.log(`TIMEOUT: ${job.task.filePath} exceeded ${ms}ms with no result — waiting up to ${graceMs}ms more for a late result before killing the worker`);
+        job.timerExpired = true;
+        job.hardKillTimer = setTimeout(() => this.onHardTimeout(w, job, ms * HARD_KILL_MULTIPLIER), graceMs);
+        job.hardKillTimer.unref?.();
+    }
+    /** No result after the full hard-kill window — the worker really is hung. */
+    onHardTimeout(w, job, totalMs) {
+        if (job.settled || !this.workers.has(w))
+            return;
+        this.log(`TIMEOUT: ${job.task.filePath} got no result after ${totalMs}ms — killing worker`);
+        // Kill the (WASM-wedged) worker and reject this parse. A timeout isn't a
+        // crash — don't charge the budget — but the worker is gone, so spawn a
+        // replacement to keep capacity. The rejection message contains "timed out"
+        // so the orchestrator's retry pass re-attempts the file.
+        this.removeWorker(w);
+        this.inflight.delete(w);
+        try {
+            void w.terminate();
+        }
+        catch { /* already gone */ }
+        this.settle(job, undefined, new Error(`Parse timed out after ${totalMs}ms`));
+        if (this.healthy)
+            this.spawnOne();
+        this.drain();
+    }
+    drain() {
+        // Grow toward maxSize while queued work outstrips workers that are idle OR
+        // already on their way up — throttled so we never cold-start the whole pool
+        // at once.
+        while (this.queue.length > this.idle.length + this.pending.size &&
+            this.workers.size < this.maxSize &&
+            this.pending.size < MAX_CONCURRENT_SPAWN &&
+            !this.destroyed &&
+            this.healthy) {
+            this.spawnOne();
+        }
+        // Dispatch queued jobs to idle workers.
+        while (this.idle.length && this.queue.length) {
+            let job;
+            while (this.queue.length && (job = this.queue.shift()) && job.settled)
+                job = undefined;
+            if (!job || job.settled)
+                break;
+            const w = this.idle.pop();
+            this.dispatch(w, job);
+        }
+        // Hang-prevention: if there's queued work but nothing can ever run it (no
+        // idle workers, none spawning, none alive), fail it instead of hanging
+        // forever. Reached only when the crash budget is exhausted or after destroy.
+        if (this.queue.length && this.idle.length === 0 && this.pending.size === 0 && this.workers.size === 0) {
+            const reason = this.destroyed ? 'parse pool destroyed' : 'parse pool exhausted its worker crash budget';
+            for (const job of this.queue.splice(0))
+                this.settle(job, undefined, new Error(reason));
+        }
+    }
+    settle(job, result, err) {
+        if (job.settled)
+            return;
+        job.settled = true;
+        if (job.timer)
+            clearTimeout(job.timer);
+        if (job.hardKillTimer)
+            clearTimeout(job.hardKillTimer);
+        if (err)
+            job.reject(err);
+        else
+            job.resolve(result);
+    }
+    /**
+     * Recycle every idle worker now (fresh WASM heaps). The orchestrator calls
+     * this before its retry pass so crash-on-memory files get the cleanest heap.
+     */
+    recycleAll() {
+        for (const w of [...this.idle])
+            this.recycle(w);
+    }
+    /** Terminate all workers and reject any outstanding parses. */
+    async destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        const ws = [...this.workers];
+        this.workers.clear();
+        this.pending.clear();
+        this.parseCounts.clear();
+        this.idle = [];
+        for (const job of [...this.inflight.values(), ...this.queue]) {
+            this.settle(job, undefined, new Error('parse pool destroyed'));
+        }
+        this.inflight.clear();
+        this.queue = [];
+        await Promise.all(ws.map((w) => Promise.resolve(w.terminate()).catch(() => { })));
+    }
+}
+exports.ParseWorkerPool = ParseWorkerPool;
+//# sourceMappingURL=parse-pool.js.map

package/dist/extraction/parse-pool.js.map

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

package/dist/extraction/parse-worker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parse Worker
+ *
+ * Runs tree-sitter parsing in a separate thread so the main thread
+ * stays unblocked and the UI animation renders smoothly.
+ */
+export {};
+//# sourceMappingURL=parse-worker.d.ts.map

package/dist/extraction/parse-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-worker.d.ts","sourceRoot":"","sources":["../../src/extraction/parse-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/extraction/parse-worker.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Parse Worker
+ *
+ * Runs tree-sitter parsing in a separate thread so the main thread
+ * stays unblocked and the UI animation renders smoothly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const tree_sitter_1 = require("./tree-sitter");
+const grammars_1 = require("./grammars");
+// Emscripten prints `Aborted()` (and a follow-up RuntimeError diag
+// line) directly to stderr when WASM aborts — before the JS catch
+// runs. Worker stderr is inherited by the parent, so each crash leaks
+// a noise line to the user's terminal even though the JS layer
+// already handles the failure cleanly. Filter these specific lines
+// out at the source. Real diagnostic output (anything we log
+// ourselves) goes through console.* / parentPort and is unaffected.
+//
+// Caveats deliberately accepted:
+//   - Per-call match: each `write()` call is matched in isolation.
+//     If Emscripten ever splits `Aborted(` across two write()s (it
+//     doesn't today — synchronous abort prints the whole line at
+//     once via libc puts) the first fragment would leak. Buffering
+//     across calls would add complexity for a hypothetical case.
+//   - Substring exactness: the prefix `Aborted(` is the literal
+//     Emscripten signature. Any user code that legitimately writes
+//     a stderr line starting with that prefix would also be filtered;
+//     in practice no real diagnostic does.
+{
+    const realWrite = process.stderr.write.bind(process.stderr);
+    process.stderr.write = ((chunk, encoding, cb) => {
+        const s = typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf-8');
+        if (s.startsWith('Aborted(') ||
+            s.includes('Build with -sASSERTIONS for more info')) {
+            // Honour the Writable stream contract: callbacks must always
+            // fire even when the write is suppressed, or upstream code
+            // waiting on the drain signal would hang. Both overload forms
+            // are handled (`(chunk, cb)` and `(chunk, encoding, cb)`).
+            if (typeof encoding === 'function')
+                encoding();
+            else if (cb)
+                cb();
+            return true;
+        }
+        return realWrite(chunk, encoding, cb);
+    });
+}
+const PARSER_RESET_INTERVAL = 5000;
+const parseCounts = new Map();
+worker_threads_1.parentPort.on('message', async (msg) => {
+    if (msg.type === 'load-grammars') {
+        // Grammar WASM bytes pre-read by the main thread (when provided) make this
+        // a memory load instead of a per-spawn disk read — see issue #1231.
+        await (0, grammars_1.loadGrammarsForLanguages)(msg.languages, msg.grammarBuffers);
+        worker_threads_1.parentPort.postMessage({ type: 'grammars-loaded' });
+    }
+    else if (msg.type === 'parse') {
+        const { id, filePath, content, frameworkNames } = msg;
+        // Worker-side parse clock: reported back with the result so the pool can
+        // tell a genuinely slow parse from a result whose delivery was delayed by
+        // a stalled main thread (issue #1231 false timeouts).
+        const t0 = performance.now();
+        try {
+            // The main thread resolves the language (it holds the project's
+            // codegraph.json extension overrides) and sends it; fall back to detection
+            // for older callers / safety.
+            const language = msg.language ?? (0, grammars_1.detectLanguage)(filePath, content);
+            const result = (0, tree_sitter_1.extractFromSource)(filePath, content, language, frameworkNames);
+            // Periodic parser reset to reclaim WASM heap memory
+            const count = (parseCounts.get(language) ?? 0) + 1;
+            parseCounts.set(language, count);
+            if (count % PARSER_RESET_INTERVAL === 0) {
+                (0, grammars_1.resetParser)(language);
+            }
+            worker_threads_1.parentPort.postMessage({ type: 'parse-result', id, result, parseMs: performance.now() - t0 });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // WASM memory errors leave the module in a corrupted state — all
+            // subsequent parses would also fail (cascading failures). Crash the
+            // worker so the main thread spawns a fresh one with a clean heap.
+            if (message.includes('memory access out of bounds') || message.includes('out of memory')) {
+                process.exit(1);
+            }
+            worker_threads_1.parentPort.postMessage({
+                type: 'parse-result',
+                id,
+                parseMs: performance.now() - t0,
+                result: {
+                    nodes: [],
+                    edges: [],
+                    unresolvedReferences: [],
+                    errors: [{ message: `Parse worker error: ${message}`, filePath: filePath, severity: 'error', code: 'parse_error' }],
+                    durationMs: 0,
+                },
+            });
+        }
+    }
+    else if (msg.type === 'shutdown') {
+        worker_threads_1.parentPort.postMessage({ type: 'shutdown-ack' });
+    }
+});
+//# sourceMappingURL=parse-worker.js.map

package/dist/extraction/parse-worker.js.map

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

package/dist/extraction/razor-extractor.d.ts

@@ -0,0 +1,42 @@
+import { ExtractionResult } from '../types';
+export declare class RazorExtractor {
+    private filePath;
+    private source;
+    private nodes;
+    private edges;
+    private unresolvedReferences;
+    private errors;
+    constructor(filePath: string, source: string);
+    extract(): ExtractionResult;
+    private createComponentNode;
+    /** Last `.`-segment (`App.ViewModels.RegisterModel` → `RegisterModel`). */
+    private lastSegment;
+    /**
+     * Split a type expression into the capitalized type names it contains — base
+     * type plus any generic arguments (`Bar<Foo, Baz>` → `Bar`, `Foo`, `Baz`),
+     * each reduced to its last namespace segment. Lowercase/keyword tokens drop out.
+     */
+    private typeNames;
+    private pushRef;
+    private extractDirectives;
+    private extractComponentTags;
+    /**
+     * Find the matching `}` for the `{` at `openIdx`, skipping string literals and
+     * comments so a brace inside `"{"` / `// }` doesn't throw off the count.
+     * Returns the index of the closing brace, or -1 if unbalanced.
+     */
+    private matchBrace;
+    /** `@code { … }` / `@functions { … }` (Blazor) and `@{ … }` (Razor) C# blocks. */
+    private extractCodeBlocks;
+    /**
+     * Delegate each `@code`/`@functions`/`@{` block's C# to the tree-sitter C#
+     * extractor and attribute the block's external references (service/DTO calls,
+     * `new X()`, type uses) to the component. The block is wrapped in a synthetic
+     * class so tree-sitter parses the component's fields/methods in a class context
+     * (a Blazor `@code` body compiles into the component's partial class). We keep
+     * only the dependency references — coverage just needs the edges to external
+     * types, not per-member nodes. Degrades gracefully if the C# grammar isn't loaded.
+     */
+    private processCodeBlocks;
+}
+//# sourceMappingURL=razor-extractor.d.ts.map

package/dist/extraction/razor-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"razor-extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/razor-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,gBAAgB,EAAwC,MAAM,UAAU,CAAC;AAiD9F,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,MAAM,CAAyB;gBAE3B,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK5C,OAAO,IAAI,gBAAgB;IA+B3B,OAAO,CAAC,mBAAmB;IAsB3B,2EAA2E;IAC3E,OAAO,CAAC,WAAW;IAKnB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,oBAAoB;IAqB5B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAgClB,kFAAkF;IAClF,OAAO,CAAC,iBAAiB;IAkBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;CA4B1B"}