@ltm-alpha/alpha-cs 1.6.0

package/dist/extraction/store-writer.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * StoreWriter — main-thread client for the store worker (see store-worker.ts).
+ *
+ * Used ONLY on the fresh-DB bulk path: bundles are posted in file order and the
+ * worker applies them in arrival order, so rowid assignment (and therefore
+ * resolution's insertion-order disambiguation) is byte-identical to the
+ * main-thread store. Kill switch: CODEGRAPH_NO_STORE_WORKER=1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreWriter = void 0;
+exports.finalizeStoreBundle = finalizeStoreBundle;
+const worker_threads_1 = require("worker_threads");
+/**
+ * The validation/denormalization every bundle gets before storeFileBundle —
+ * shared by the orchestrator's object path and the store worker's kernel
+ * decode path so the two can never drift:
+ *   - nodes missing identity fields are dropped (#42-class safety),
+ *   - edges must connect inserted nodes (FK integrity),
+ *   - refs must originate from inserted nodes and carry the denormalized
+ *     filePath/language the resolver reads.
+ */
+function finalizeStoreBundle(result, filePath, language, file) {
+    const validNodes = result.nodes.filter((n) => n.id && n.kind && n.name && n.filePath && n.language);
+    const insertedIds = new Set(validNodes.map((n) => n.id));
+    const validEdges = result.edges.filter((e) => insertedIds.has(e.source) && insertedIds.has(e.target));
+    const validRefs = result.unresolvedReferences
+        .filter((ref) => insertedIds.has(ref.fromNodeId))
+        .map((ref) => ({
+        ...ref,
+        filePath: ref.filePath ?? filePath,
+        language: ref.language ?? language,
+    }));
+    return { nodes: validNodes, edges: validEdges, refs: validRefs, file };
+}
+class StoreWriter {
+    worker;
+    readyPromise;
+    firstError = null;
+    drainWaiters = new Map();
+    nextDrainId = 0;
+    exited = false;
+    /** Bundles posted but not yet acked — the queue-depth backpressure signal. */
+    outstanding = 0;
+    belowWaiters = [];
+    constructor(workerScriptPath, dbPath, fastInit) {
+        this.worker = new worker_threads_1.Worker(workerScriptPath);
+        let readyResolve;
+        let readyReject;
+        this.readyPromise = new Promise((resolve, reject) => {
+            readyResolve = resolve;
+            readyReject = reject;
+        });
+        this.worker.on('message', (msg) => {
+            if (msg.type === 'ready') {
+                readyResolve();
+            }
+            else if (msg.type === 'ack') {
+                this.settleOne();
+            }
+            else if (msg.type === 'drained' && msg.id !== undefined) {
+                const waiter = this.drainWaiters.get(msg.id);
+                this.drainWaiters.delete(msg.id);
+                if (!waiter)
+                    return;
+                if (this.firstError)
+                    waiter.reject(this.firstError);
+                else
+                    waiter.resolve();
+            }
+            else if (msg.type === 'error') {
+                if (!this.firstError)
+                    this.firstError = new Error(`store worker: ${msg.message}`);
+                this.settleOne(); // the error reply is also the failed bundle's ack
+            }
+        });
+        this.worker.on('error', (err) => {
+            this.failAll(err instanceof Error ? err : new Error(String(err)));
+            readyReject(this.firstError);
+        });
+        this.worker.on('exit', (code) => {
+            this.exited = true;
+            if (code !== 0) {
+                this.failAll(new Error(`store worker exited with code ${code}`));
+                readyReject(this.firstError);
+            }
+            else if (this.drainWaiters.size > 0 || this.belowWaiters.length > 0) {
+                // A clean exit with waiters pending is a protocol violation (only
+                // close() should end the worker) — settle the waiters instead of
+                // hanging the index forever.
+                this.failAll(new Error('store worker exited before drain completed'));
+            }
+        });
+        this.worker.postMessage({ type: 'open', dbPath, fastInit });
+        // The worker holds the event loop open only until close(); don't unref —
+        // bundles must never be dropped because main ran out of work.
+    }
+    failAll(err) {
+        if (!this.firstError)
+            this.firstError = err;
+        for (const [, waiter] of this.drainWaiters)
+            waiter.reject(this.firstError);
+        this.drainWaiters.clear();
+        this.outstanding = 0;
+        const waiters = this.belowWaiters;
+        this.belowWaiters = [];
+        for (const w of waiters)
+            w.resolve(); // send() will surface firstError
+    }
+    settleOne() {
+        if (this.outstanding > 0)
+            this.outstanding--;
+        if (this.belowWaiters.length === 0)
+            return;
+        const still = [];
+        for (const w of this.belowWaiters) {
+            if (this.outstanding < w.limit)
+                w.resolve();
+            else
+                still.push(w);
+        }
+        this.belowWaiters = still;
+    }
+    ready() {
+        return this.readyPromise;
+    }
+    /** Post one file's bundle. Throws immediately if the writer already failed. */
+    send(bundle) {
+        if (this.firstError)
+            throw this.firstError;
+        if (this.exited)
+            throw new Error('store worker already exited');
+        this.outstanding++;
+        this.worker.postMessage({ type: 'bundle', bundle });
+    }
+    /** Backpressure: resolves once fewer than `limit` bundles are un-acked. */
+    waitBelow(limit) {
+        if (this.firstError || this.exited || this.outstanding < limit)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            this.belowWaiters.push({ limit, resolve });
+        });
+    }
+    /** Resolves when every bundle posted before this call has been applied. */
+    drain() {
+        if (this.firstError)
+            return Promise.reject(this.firstError);
+        if (this.exited)
+            return Promise.reject(new Error('store worker already exited'));
+        const id = this.nextDrainId++;
+        const p = new Promise((resolve, reject) => {
+            this.drainWaiters.set(id, { resolve, reject });
+        });
+        this.worker.postMessage({ type: 'drain', id });
+        return p;
+    }
+    /** Close the worker's DB connection and join the thread. */
+    async close() {
+        if (this.exited)
+            return;
+        this.worker.postMessage({ type: 'close' });
+        await new Promise((resolve) => {
+            const t = setTimeout(() => {
+                void this.worker.terminate().then(() => resolve());
+            }, 5000);
+            this.worker.once('exit', () => {
+                clearTimeout(t);
+                resolve();
+            });
+        });
+    }
+}
+exports.StoreWriter = StoreWriter;
+//# sourceMappingURL=store-writer.js.map

package/dist/extraction/store-writer.js.map

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

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

@@ -0,0 +1,56 @@
+import { ExtractionResult } from '../types';
+/**
+ * SvelteExtractor - Extracts code relationships from Svelte component files
+ *
+ * Svelte files are multi-language (script + template + style). Rather than
+ * parsing the full Svelte grammar, we extract the <script> block content
+ * and delegate it to the TypeScript/JavaScript TreeSitterExtractor.
+ *
+ * Also extracts function calls from template expressions (`{fn(...)}`) so
+ * cross-file call edges are captured even when calls live in markup.
+ *
+ * Every .svelte file produces a component node (Svelte components are always importable).
+ */
+export declare class SvelteExtractor {
+    private filePath;
+    private source;
+    private nodes;
+    private edges;
+    private unresolvedReferences;
+    private errors;
+    constructor(filePath: string, source: string);
+    /**
+     * Extract from Svelte source
+     */
+    extract(): ExtractionResult;
+    /**
+     * Create a component node for the .svelte file
+     */
+    private createComponentNode;
+    /**
+     * Extract <script> blocks from the Svelte source
+     */
+    private extractScriptBlocks;
+    /**
+     * Process a script block by delegating to TreeSitterExtractor
+     */
+    private processScriptBlock;
+    /**
+     * Extract function calls from Svelte template expressions.
+     *
+     * In Svelte, many function calls happen in markup (e.g., `class={cn(...)}`),
+     * not inside `<script>` blocks. We scan the template portion for `{expression}`
+     * blocks and extract call patterns from them.
+     */
+    private extractTemplateCalls;
+    /**
+     * Extract component usages from the Svelte template.
+     *
+     * PascalCase tags like <Modal>, <Button />, <DevServerPreview> represent
+     * component instantiations — analogous to function calls in imperative code.
+     * Capturing these creates graph edges from parent to child components and
+     * gives codegraph_explore anchor points in the template markup.
+     */
+    private extractTemplateComponents;
+}
+//# sourceMappingURL=svelte-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svelte-extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/svelte-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,gBAAgB,EAAkD,MAAM,UAAU,CAAC;AAWxG;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,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;;OAEG;IACH,OAAO,IAAI,gBAAgB;IAyC3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4D1B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAqD5B;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;CAmClC"}

package/dist/extraction/svelte-extractor.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SvelteExtractor = void 0;
+const tree_sitter_helpers_1 = require("./tree-sitter-helpers");
+const tree_sitter_1 = require("./tree-sitter");
+const grammars_1 = require("./grammars");
+/** Svelte 5 rune names — compiler builtins, not real functions */
+const SVELTE_RUNES = new Set([
+    '$props', '$state', '$derived', '$effect', '$bindable',
+    '$inspect', '$host', '$snippet',
+]);
+/**
+ * SvelteExtractor - Extracts code relationships from Svelte component files
+ *
+ * Svelte files are multi-language (script + template + style). Rather than
+ * parsing the full Svelte grammar, we extract the <script> block content
+ * and delegate it to the TypeScript/JavaScript TreeSitterExtractor.
+ *
+ * Also extracts function calls from template expressions (`{fn(...)}`) so
+ * cross-file call edges are captured even when calls live in markup.
+ *
+ * Every .svelte file produces a component node (Svelte components are always importable).
+ */
+class SvelteExtractor {
+    filePath;
+    source;
+    nodes = [];
+    edges = [];
+    unresolvedReferences = [];
+    errors = [];
+    constructor(filePath, source) {
+        this.filePath = filePath;
+        this.source = source;
+    }
+    /**
+     * Extract from Svelte source
+     */
+    extract() {
+        const startTime = Date.now();
+        try {
+            // Create component node for the .svelte file itself
+            const componentNode = this.createComponentNode();
+            // Extract and process script blocks
+            const scriptBlocks = this.extractScriptBlocks();
+            for (const block of scriptBlocks) {
+                this.processScriptBlock(block, componentNode.id);
+            }
+            // Extract function calls from template expressions ({fn(...)})
+            this.extractTemplateCalls(componentNode.id, scriptBlocks);
+            // Extract component usages from template (<ComponentName>)
+            this.extractTemplateComponents(componentNode.id);
+            // Filter out Svelte rune calls ($state, $props, $derived, etc.)
+            this.unresolvedReferences = this.unresolvedReferences.filter(ref => !SVELTE_RUNES.has(ref.referenceName));
+        }
+        catch (error) {
+            this.errors.push({
+                message: `Svelte extraction error: ${error instanceof Error ? error.message : String(error)}`,
+                severity: 'error',
+                code: 'parse_error',
+            });
+        }
+        return {
+            nodes: this.nodes,
+            edges: this.edges,
+            unresolvedReferences: this.unresolvedReferences,
+            errors: this.errors,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * Create a component node for the .svelte file
+     */
+    createComponentNode() {
+        const lines = this.source.split('\n');
+        const fileName = this.filePath.split(/[/\\]/).pop() || this.filePath;
+        const componentName = fileName.replace(/\.svelte$/, '');
+        const id = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'component', componentName, 1);
+        const node = {
+            id,
+            kind: 'component',
+            name: componentName,
+            qualifiedName: `${this.filePath}::${componentName}`,
+            filePath: this.filePath,
+            language: 'svelte',
+            startLine: 1,
+            endLine: lines.length,
+            startColumn: 0,
+            endColumn: lines[lines.length - 1]?.length || 0,
+            isExported: true, // Svelte components are always importable
+            updatedAt: Date.now(),
+        };
+        this.nodes.push(node);
+        return node;
+    }
+    /**
+     * Extract <script> blocks from the Svelte source
+     */
+    extractScriptBlocks() {
+        const blocks = [];
+        const scriptRegex = /<script(\s[^>]*)?>(?<content>[\s\S]*?)<\/script>/g;
+        let match;
+        while ((match = scriptRegex.exec(this.source)) !== null) {
+            const attrs = match[1] || '';
+            const content = match.groups?.content || match[2] || '';
+            // Detect TypeScript from lang attribute
+            const isTypeScript = /lang\s*=\s*["'](ts|typescript)["']/.test(attrs);
+            // Detect module script
+            const isModule = /context\s*=\s*["']module["']/.test(attrs);
+            // Calculate the 0-indexed line where the content begins. The content
+            // starts right after the opening tag's `>` — its leading `\n` is part
+            // of the content, so relative line 1 sits ON the tag's closing line
+            // (adding 1 here double-counted the embedded newline and shifted every
+            // script-block symbol down a line).
+            const beforeScript = this.source.substring(0, match.index);
+            const scriptTagLine = (beforeScript.match(/\n/g) || []).length;
+            const openingTag = match[0].substring(0, match[0].indexOf('>') + 1);
+            const openingTagLines = (openingTag.match(/\n/g) || []).length;
+            const contentStartLine = scriptTagLine + openingTagLines; // 0-indexed line
+            blocks.push({
+                content,
+                startLine: contentStartLine,
+                isModule,
+                isTypeScript,
+            });
+        }
+        return blocks;
+    }
+    /**
+     * Process a script block by delegating to TreeSitterExtractor
+     */
+    processScriptBlock(block, componentNodeId) {
+        const scriptLanguage = block.isTypeScript ? 'typescript' : 'javascript';
+        // Check if the script language parser is available
+        if (!(0, grammars_1.isLanguageSupported)(scriptLanguage)) {
+            this.errors.push({
+                message: `Parser for ${scriptLanguage} not available, cannot parse Svelte script block`,
+                severity: 'warning',
+            });
+            return;
+        }
+        // Delegate to TreeSitterExtractor
+        const extractor = new tree_sitter_1.TreeSitterExtractor(this.filePath, block.content, scriptLanguage);
+        const result = extractor.extract();
+        // Offset line numbers from script block back to .svelte file positions
+        for (const node of result.nodes) {
+            node.startLine += block.startLine;
+            node.endLine += block.startLine;
+            node.language = 'svelte'; // Mark as svelte, not TS/JS
+            this.nodes.push(node);
+            // Add containment edge from component to this node
+            this.edges.push({
+                source: componentNodeId,
+                target: node.id,
+                kind: 'contains',
+            });
+        }
+        // Offset edges (they reference line numbers)
+        for (const edge of result.edges) {
+            if (edge.line) {
+                edge.line += block.startLine;
+            }
+            this.edges.push(edge);
+        }
+        // Offset unresolved references
+        for (const ref of result.unresolvedReferences) {
+            ref.line += block.startLine;
+            ref.filePath = this.filePath;
+            ref.language = 'svelte';
+            this.unresolvedReferences.push(ref);
+        }
+        // Carry over errors
+        for (const error of result.errors) {
+            if (error.line) {
+                error.line += block.startLine;
+            }
+            this.errors.push(error);
+        }
+    }
+    /**
+     * Extract function calls from Svelte template expressions.
+     *
+     * In Svelte, many function calls happen in markup (e.g., `class={cn(...)}`),
+     * not inside `<script>` blocks. We scan the template portion for `{expression}`
+     * blocks and extract call patterns from them.
+     */
+    extractTemplateCalls(componentNodeId, _scriptBlocks) {
+        // Build a set of line ranges covered by <script> and <style> blocks so we skip them
+        const coveredRanges = [];
+        // Find all <script>...</script> and <style>...</style> ranges
+        const tagRegex = /<(script|style)(\s[^>]*)?>[\s\S]*?<\/\1>/g;
+        let tagMatch;
+        while ((tagMatch = tagRegex.exec(this.source)) !== null) {
+            const startLine = (this.source.substring(0, tagMatch.index).match(/\n/g) || []).length;
+            const endLine = startLine + (tagMatch[0].match(/\n/g) || []).length;
+            coveredRanges.push([startLine, endLine]);
+        }
+        // Find template expressions: {...} outside of script/style blocks
+        // Matches curly-brace expressions, excluding Svelte block syntax ({#if}, {:else}, {/if}, {@html}, {@render})
+        const lines = this.source.split('\n');
+        const exprRegex = /\{([^}#/:@][^}]*)\}/g;
+        for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
+            // Skip lines inside script/style blocks
+            if (coveredRanges.some(([start, end]) => lineIdx >= start && lineIdx <= end))
+                continue;
+            const line = lines[lineIdx];
+            let exprMatch;
+            while ((exprMatch = exprRegex.exec(line)) !== null) {
+                const expr = exprMatch[1];
+                // Extract function calls: identifiers followed by (
+                // Matches: cn(...), buttonVariants(...), obj.method(...)
+                const callRegex = /\b([a-zA-Z_$][\w$.]*)\s*\(/g;
+                let callMatch;
+                while ((callMatch = callRegex.exec(expr)) !== null) {
+                    const calleeName = callMatch[1];
+                    // Skip Svelte runes, control flow keywords, and common non-function patterns
+                    if (SVELTE_RUNES.has(calleeName))
+                        continue;
+                    if (calleeName === 'if' || calleeName === 'else' || calleeName === 'each' || calleeName === 'await')
+                        continue;
+                    this.unresolvedReferences.push({
+                        fromNodeId: componentNodeId,
+                        referenceName: calleeName,
+                        referenceKind: 'calls',
+                        line: lineIdx + 1, // 1-indexed
+                        column: exprMatch.index + callMatch.index,
+                        filePath: this.filePath,
+                        language: 'svelte',
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Extract component usages from the Svelte template.
+     *
+     * PascalCase tags like <Modal>, <Button />, <DevServerPreview> represent
+     * component instantiations — analogous to function calls in imperative code.
+     * Capturing these creates graph edges from parent to child components and
+     * gives codegraph_explore anchor points in the template markup.
+     */
+    extractTemplateComponents(componentNodeId) {
+        // Build ranges covered by <script> and <style> blocks to skip them
+        const coveredRanges = [];
+        const tagRegex = /<(script|style)(\s[^>]*)?>[\s\S]*?<\/\1>/g;
+        let tagMatch;
+        while ((tagMatch = tagRegex.exec(this.source)) !== null) {
+            const startLine = (this.source.substring(0, tagMatch.index).match(/\n/g) || []).length;
+            const endLine = startLine + (tagMatch[0].match(/\n/g) || []).length;
+            coveredRanges.push([startLine, endLine]);
+        }
+        const lines = this.source.split('\n');
+        // Match PascalCase opening/self-closing tags (closing tags </Foo> start with </ so won't match)
+        const componentTagRegex = /<([A-Z][a-zA-Z0-9_$]*)\b/g;
+        for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
+            if (coveredRanges.some(([start, end]) => lineIdx >= start && lineIdx <= end))
+                continue;
+            const line = lines[lineIdx];
+            let match;
+            while ((match = componentTagRegex.exec(line)) !== null) {
+                const componentName = match[1];
+                this.unresolvedReferences.push({
+                    fromNodeId: componentNodeId,
+                    referenceName: componentName,
+                    referenceKind: 'references',
+                    line: lineIdx + 1, // 1-indexed
+                    column: match.index + 1,
+                    filePath: this.filePath,
+                    language: 'svelte',
+                });
+            }
+        }
+    }
+}
+exports.SvelteExtractor = SvelteExtractor;
+//# sourceMappingURL=svelte-extractor.js.map

package/dist/extraction/svelte-extractor.js.map

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

package/dist/extraction/syntax-tokens.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Syntax classification from the engine's own tree-sitter parse (CG-57).
+ *
+ * The viewer used to run a second highlighter (Shiki + 56 pruned TextMate
+ * grammars) over source the engine had already parsed with a real grammar. This
+ * takes the classification off the tree instead, which removes the second
+ * dependency, the second grammar set, and — the part that actually mattered —
+ * the second opinion: a `.ts` file is now read by exactly the grammar that
+ * decided what its symbols are.
+ *
+ * ## What comes out
+ *
+ * A flat, ordered, non-overlapping list of {@link SyntaxSpan}s over the source
+ * string. Gaps between spans are whitespace and are the caller's to fill. The
+ * classes are deliberately few, because the design's code colouring is
+ * near-monochrome: comments recede, strings and numbers recede one step less,
+ * keywords carry weight rather than hue, and the only colour in the body is a
+ * call site the graph resolved.
+ *
+ * ## How a node becomes a class
+ *
+ * The rules are language-agnostic on purpose — the engine indexes 40-odd
+ * languages and a per-grammar scope table would be 40 tables to keep true:
+ *
+ * * a node whose type mentions `comment` is a comment, whole, undescended;
+ * * inside a string node every leaf is string, *except* below an interpolation,
+ *   where the code starts again (so `${user.name()}` still links);
+ * * a numeric literal node is a number;
+ * * an **anonymous** leaf is a keyword when its text is a bare word and
+ *   punctuation otherwise — this is what makes `func`, `fn`, `def`, `END-IF`
+ *   and `Sub` all land as keywords without naming any of them;
+ * * a **named** leaf whose text is identifier-shaped is an identifier, unless
+ *   the grammar called it a type name, or the extractor's own definition tables
+ *   say it is the name of a definition.
+ *
+ * The last of those is the one place per-language knowledge is used, and it is
+ * reused rather than restated: {@link EXTRACTORS} already names every node type
+ * that declares something in each language, plus the field its name hangs on.
+ */
+import type { Node as SyntaxNode } from 'web-tree-sitter';
+import { Language } from '../types';
+/**
+ * Every class a token can carry, in wire order.
+ *
+ * `other` is punctuation and whitespace both. The design spec lists them apart
+ * (`punct` vs the gaps) but they paint identically — plain ink — and splitting
+ * them would roughly double the token count on a dense line to express a
+ * difference nothing draws.
+ */
+export declare const SYNTAX_TOKEN_CLASSES: readonly ["other", "ident", "comment", "string", "keyword", "number", "type", "def"];
+export type SyntaxTokenClass = (typeof SYNTAX_TOKEN_CLASSES)[number];
+/** A classified run of the source, by JS string index. Half-open. */
+export interface SyntaxSpan {
+    start: number;
+    end: number;
+    cls: SyntaxTokenClass;
+}
+/**
+ * Classify one parsed tree into spans.
+ *
+ * Exported for tests and for anything that already holds a tree; the usual
+ * entry point is {@link tokenizeSource}, which parses first.
+ */
+export declare function classifyTree(root: SyntaxNode, source: string, language: Language, offset?: number): SyntaxSpan[];
+/**
+ * A stretch of a file written in a different language from the file itself.
+ *
+ * Single-file components are the only case: a `.svelte`, `.vue` or `.astro`
+ * file has no tree-sitter grammar of its own here, but its `<script>` block —
+ * where every symbol the engine indexed in that file lives — is ordinary
+ * TypeScript or JavaScript. The extractors already delegate exactly this way,
+ * so the viewer reads a component's code with the same grammar the graph was
+ * built from. The surrounding markup stays unclassified, which under a
+ * near-monochrome theme costs the recession on tag names and attribute strings
+ * and nothing else.
+ */
+export interface SyntaxRegion {
+    start: number;
+    end: number;
+    language: Language;
+}
+/**
+ * The sub-language regions of a file, or null when the file is one language.
+ *
+ * Null and an empty array mean different things: null is "parse the whole file
+ * as `language`", empty is "this file has a grammar for none of it".
+ */
+export declare function syntaxRegionsFor(source: string, language: Language): SyntaxRegion[] | null;
+export interface TokenizeResult {
+    spans: SyntaxSpan[];
+    /** The grammar(s) that produced them, for the payload's `grammar` field. */
+    grammars: string[];
+}
+/**
+ * Parse `source` and classify it.
+ *
+ * Returns null when nothing in the file has a grammar — a plain answer, which
+ * every caller here already knows how to serve. Never throws: a grammar that
+ * fails to load or a parse that comes back empty is the same outcome as not
+ * having one.
+ */
+export declare function tokenizeSource(source: string, language: Language): Promise<TokenizeResult | null>;
+//# sourceMappingURL=syntax-tokens.d.ts.map

package/dist/extraction/syntax-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-tokens.d.ts","sourceRoot":"","sources":["../../src/extraction/syntax-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAOpC;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,sFASvB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAmKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,MAAM,SAAI,GACT,UAAU,EAAE,CAYd;AAmFD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,EAAE,GAAG,IAAI,CAyB1F;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAuBhC"}