@canonical/terrazzo-lsp 0.0.1

package/dist/esm/runtime/createGraphWorker.js

@@ -0,0 +1,329 @@
+/**
+ * GraphWorker — owns the TokenGraph and handles all heavy computation.
+ *
+ * Receives WorkerRequest messages from the main thread, delegates to
+ * providers, and sends WorkerResponse messages back. All graph construction,
+ * BFS, diagnostics, colour resolution, and CSS scanning run here.
+ *
+ * @note This function is impure — it reads from the file system and
+ * communicates via MessagePort.
+ *
+ * @see session/G.TOKEN_LSP.md §7.2 — GraphWorker thread
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { loadArtifact, ReachabilityCache, TokenGraph } from "../graph/index.js";
+import { loadConfigFile, resolveConfig } from "../protocol/index.js";
+import { produceArtifactDiagnostics, produceDiagnostics, provideCompletions, provideDocumentColors, provideHover, provideRename, provideSemanticTokens, provideWorkspaceSymbols, resolveDefinition, } from "../providers/index.js";
+import { buildImportGraph } from "./buildImportGraph.js";
+import { rescanFile, scheduleBufferUpdate } from "./scheduleBufferUpdate.js";
+/**
+ * Create a new GraphWorker instance.
+ *
+ * @note This function is impure — the returned worker reads files,
+ * maintains mutable state, and posts messages.
+ */
+export function createGraphWorker(options) {
+    const { rootDir, postMessage, log = () => { }, debug = () => { } } = options;
+    const graph = new TokenGraph();
+    const cache = new ReachabilityCache();
+    const pendingUpdates = new Map();
+    const openDocuments = new Map();
+    let config = resolveConfig({}, rootDir);
+    const nodeFs = {
+        rootDir,
+        async readFile(uri) {
+            const fsPath = uri.startsWith("file://") ? uri.slice(7) : uri;
+            try {
+                return await fs.readFile(fsPath, "utf-8");
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+    // Config discovery is deferred until the first document opens.
+    // We walk up from the document's directory to find the nearest
+    // terrazzo-lsp.config.json, which handles monorepo layouts where
+    // the config sits at the package level, not the workspace root.
+    //
+    // A shared promise ensures that concurrent callers (e.g. didOpen
+    // and completion arriving in the same buffer chunk) all await the
+    // same config-loading operation rather than skipping it.
+    let configPromise = null;
+    function ensureConfig(documentUri) {
+        if (!configPromise) {
+            configPromise = doLoadConfig(documentUri);
+        }
+        return configPromise;
+    }
+    async function doLoadConfig(documentUri) {
+        // Determine search start: prefer the directory of the first opened
+        // document, fall back to the workspace rootDir.
+        let searchStart = rootDir;
+        if (documentUri) {
+            const fsPath = documentUri.startsWith("file://")
+                ? decodeURIComponent(documentUri.slice(7))
+                : documentUri;
+            searchStart = path.dirname(fsPath);
+        }
+        const { raw, configDir } = await loadConfigFile(searchStart);
+        const effectiveRoot = configDir ?? rootDir;
+        config = resolveConfig(raw, effectiveRoot);
+        if (configDir) {
+            log(`Config loaded from ${configDir}/terrazzo-lsp.config.json`);
+        }
+        else {
+            log(`No terrazzo-lsp.config.json found (searched from ${searchStart})`);
+        }
+        log(`Root: ${effectiveRoot}`);
+        log(`Artifacts: ${config.artifactPaths.length > 0 ? config.artifactPaths.join(", ") : "(none)"}`);
+        await loadArtifacts(config, graph);
+        const tokenCount = graph.data.tokens.size;
+        log(`Loaded ${tokenCount} token${tokenCount !== 1 ? "s" : ""} from ${config.artifactPaths.length} artifact${config.artifactPaths.length !== 1 ? "s" : ""}`);
+        // Load global stylesheets into the graph so their declarations
+        // are available before any document opens.
+        if (config.globalStylesheets && config.globalStylesheets.length > 0) {
+            let globalDecls = 0;
+            for (const sheetUri of config.globalStylesheets) {
+                const fsPath = sheetUri.startsWith("file://")
+                    ? sheetUri.slice(7)
+                    : sheetUri;
+                try {
+                    const source = await fs.readFile(fsPath, "utf-8");
+                    const declsBefore = graph.data.declarations.size;
+                    rescanFile(sheetUri, source, graph);
+                    globalDecls += graph.data.declarations.size - declsBefore;
+                }
+                catch {
+                    log(`Global stylesheet not found: ${sheetUri}`);
+                }
+            }
+            log(`Global stylesheets: ${config.globalStylesheets.length} file${config.globalStylesheets.length !== 1 ? "s" : ""}, ${globalDecls} declarations`);
+        }
+        log("terrazzo-lsp ready");
+    }
+    async function handleRequest(request) {
+        // Lazily discover config from the first document URI we see.
+        const uri = "uri" in request ? request.uri : undefined;
+        await ensureConfig(uri);
+        debug(`[${request.type}] tokens=${graph.data.tokens.size} docs=${openDocuments.size}`);
+        switch (request.type) {
+            case "COMPLETION": {
+                const completionSource = openDocuments.get(request.uri) ?? "";
+                debug(`[COMPLETION] uri=${request.uri} source=${completionSource.length}B pos=${request.position.line}:${request.position.character}`);
+                const items = provideCompletions(request.uri, graph, cache, config, completionSource, request.position);
+                debug(`[COMPLETION] → ${items.length} items`);
+                postMessage({ id: request.id, type: "COMPLETION_RESULT", items });
+                break;
+            }
+            case "HOVER": {
+                const source = openDocuments.get(request.uri) ?? "";
+                const cssVar = extractCssVarAtPosition(source, request.position);
+                debug(`[HOVER] source=${source.length}B pos=${request.position.line}:${request.position.character} var=${cssVar ?? "(none)"} inGraph=${cssVar ? graph.data.tokens.has(cssVar) : false}`);
+                const content = cssVar
+                    ? provideHover(cssVar, request.uri, graph, config)
+                    : null;
+                debug(`[HOVER] → ${content ? `hit (${content.value.length}B)` : "miss"}`);
+                postMessage({ id: request.id, type: "HOVER_RESULT", content });
+                break;
+            }
+            case "DEFINITION": {
+                const defSource = openDocuments.get(request.uri) ?? "";
+                const defCssVar = extractCssVarAtPosition(defSource, request.position);
+                const locations = defCssVar ? resolveDefinition(defCssVar, graph) : [];
+                postMessage({
+                    id: request.id,
+                    type: "DEFINITION_RESULT",
+                    locations,
+                });
+                break;
+            }
+            case "DIAGNOSTICS": {
+                const diagnostics = produceDiagnostics(request.uri, request.text, graph, cache, config);
+                postMessage({
+                    id: request.id,
+                    type: "DIAGNOSTICS_RESULT",
+                    uri: request.uri,
+                    diagnostics,
+                });
+                break;
+            }
+            case "REFERENCES": {
+                const refSource = openDocuments.get(request.uri) ?? "";
+                const refCssVar = extractCssVarAtPosition(refSource, request.position);
+                const usages = refCssVar
+                    ? (graph.data.usages.get(refCssVar) ?? [])
+                    : [];
+                const locations = usages.map((u) => ({
+                    uri: u.fileUri,
+                    range: {
+                        start: { line: u.line, character: u.column },
+                        end: { line: u.line, character: u.column + u.cssVar.length + 6 },
+                    },
+                }));
+                postMessage({
+                    id: request.id,
+                    type: "REFERENCES_RESULT",
+                    locations,
+                });
+                break;
+            }
+            case "RENAME": {
+                const renameSource = openDocuments.get(request.uri) ?? "";
+                const renameCssVar = extractCssVarAtPosition(renameSource, request.position);
+                const result = renameCssVar
+                    ? provideRename(renameCssVar, request.newName, graph)
+                    : null;
+                postMessage({
+                    id: request.id,
+                    type: "RENAME_RESULT",
+                    result,
+                });
+                break;
+            }
+            case "SEMANTIC_TOKENS": {
+                const stSource = openDocuments.get(request.uri) ?? "";
+                const data = provideSemanticTokens(request.uri, stSource, graph);
+                postMessage({
+                    id: request.id,
+                    type: "SEMANTIC_TOKENS_RESULT",
+                    data,
+                });
+                break;
+            }
+            case "WORKSPACE_SYMBOL": {
+                const symbols = provideWorkspaceSymbols(request.query, graph);
+                postMessage({
+                    id: request.id,
+                    type: "WORKSPACE_SYMBOL_RESULT",
+                    symbols,
+                });
+                break;
+            }
+            case "DOCUMENT_COLOR": {
+                const dcSource = openDocuments.get(request.uri) ?? "";
+                const colors = provideDocumentColors(dcSource, graph);
+                postMessage({
+                    id: request.id,
+                    type: "DOCUMENT_COLOR_RESULT",
+                    colors,
+                });
+                break;
+            }
+            case "OPEN_DOC": {
+                openDocuments.set(request.uri, request.text);
+                const declsBefore = graph.data.declarations.size;
+                const usagesBefore = graph.data.usages.size;
+                rescanFile(request.uri, request.text, graph);
+                const bufferDecls = graph.data.declarations.size - declsBefore;
+                const bufferUsages = graph.data.usages.size - usagesBefore;
+                debug(`[OPEN_DOC] ${request.uri} (${request.text.length}B) → ${bufferDecls} declarations, ${bufferUsages} usages from buffer`);
+                const filesBefore = graph.data.files.size;
+                await buildImportGraph(request.uri, graph, nodeFs);
+                const importedFiles = graph.data.files.size - filesBefore;
+                debug(`[OPEN_DOC] import graph: ${importedFiles} new files discovered, ${graph.data.declarations.size} total declarations, ${graph.data.usages.size} total usages`);
+                cache.invalidate(request.uri);
+                const diagnostics = produceDiagnostics(request.uri, request.text, graph, cache, config);
+                debug(`[OPEN_DOC] → ${diagnostics.length} diagnostics`);
+                postMessage({
+                    id: request.id,
+                    type: "DIAGNOSTICS_RESULT",
+                    uri: request.uri,
+                    diagnostics,
+                });
+                break;
+            }
+            case "CHANGE_DOC": {
+                const text = request.changes[request.changes.length - 1]?.text ?? "";
+                openDocuments.set(request.uri, text);
+                scheduleBufferUpdate(request.uri, text, graph, cache, pendingUpdates, () => {
+                    const diagnostics = produceDiagnostics(request.uri, text, graph, cache, config);
+                    postMessage({
+                        id: request.id,
+                        type: "PUSH_DIAGNOSTICS",
+                        uri: request.uri,
+                        diagnostics,
+                    });
+                });
+                break;
+            }
+            case "CLOSE_DOC": {
+                openDocuments.delete(request.uri);
+                const pending = pendingUpdates.get(request.uri);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    pendingUpdates.delete(request.uri);
+                }
+                break;
+            }
+            case "FILE_CHANGED": {
+                cache.invalidate(request.uri);
+                break;
+            }
+            case "ARTIFACT_CHANGED": {
+                cache.invalidateAll();
+                graph.data.tokens.clear();
+                await loadArtifacts(config, graph);
+                const artifactDiags = produceArtifactDiagnostics(graph, config);
+                if (artifactDiags.length > 0) {
+                    postMessage({
+                        id: request.id,
+                        type: "PUSH_DIAGNOSTICS",
+                        uri: request.path,
+                        diagnostics: artifactDiags,
+                    });
+                }
+                break;
+            }
+        }
+    }
+    return { handleRequest, config, graph };
+}
+/** Extract the CSS custom property name at a given position in source text. */
+function extractCssVarAtPosition(source, position) {
+    const lines = source.split("\n");
+    const line = lines[position.line];
+    if (!line)
+        return null;
+    // Find all --custom-property occurrences on this line
+    const varPattern = /--([\w-]+)/g;
+    let match = varPattern.exec(line);
+    while (match) {
+        const start = match.index;
+        const end = start + match[0].length;
+        if (position.character >= start && position.character <= end) {
+            return match[0];
+        }
+        match = varPattern.exec(line);
+    }
+    return null;
+}
+/** Load all configured artifacts into the graph. */
+async function loadArtifacts(config, graph) {
+    for (const artifactPath of config.artifactPaths) {
+        try {
+            const raw = await fs.readFile(artifactPath, "utf-8");
+            const artifact = JSON.parse(raw);
+            const packageSource = derivePackageSource(artifactPath);
+            const artifactDir = path.dirname(artifactPath);
+            loadArtifact(artifact, graph, packageSource, artifactDir);
+        }
+        catch {
+            // Artifact not found or invalid — continue without it
+        }
+    }
+}
+/** Derive package source from artifact path (e.g., node_modules/@foo/bar → @foo/bar). */
+function derivePackageSource(artifactPath) {
+    const nmIndex = artifactPath.indexOf("node_modules/");
+    if (nmIndex < 0)
+        return "";
+    const afterNm = artifactPath.substring(nmIndex + "node_modules/".length);
+    const parts = afterNm.split(path.sep);
+    if (parts[0]?.startsWith("@") && parts.length >= 2) {
+        return `${parts[0]}/${parts[1]}`;
+    }
+    return parts[0] ?? "";
+}
+//# sourceMappingURL=createGraphWorker.js.map

package/dist/esm/runtime/createGraphWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGraphWorker.js","sourceRoot":"","sources":["../../../src/runtime/createGraphWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAyB7E;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,OAAO,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACtC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,IAAI,MAAM,GAAG,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAExC,MAAM,MAAM,GAAe;QACzB,OAAO;QACP,KAAK,CAAC,QAAQ,CAAC,GAAW;YACxB,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9D,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;IAEF,+DAA+D;IAC/D,+DAA+D;IAC/D,iEAAiE;IACjE,gEAAgE;IAChE,EAAE;IACF,iEAAiE;IACjE,kEAAkE;IAClE,yDAAyD;IACzD,IAAI,aAAa,GAAyB,IAAI,CAAC;IAE/C,SAAS,YAAY,CAAC,WAAoB;QACxC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,WAAoB;QAC9C,mEAAmE;QACnE,gDAAgD;QAChD,IAAI,WAAW,GAAG,OAAO,CAAC;QAC1B,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC9C,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1C,CAAC,CAAC,WAAW,CAAC;YAChB,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,SAAS,IAAI,OAAO,CAAC;QAC3C,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAE3C,IAAI,SAAS,EAAE,CAAC;YACd,GAAG,CAAC,sBAAsB,SAAS,2BAA2B,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,oDAAoD,WAAW,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,GAAG,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;QAC9B,GAAG,CACD,cAAc,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC7F,CAAC;QAEF,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAC1C,GAAG,CACD,UAAU,UAAU,SAAS,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,MAAM,CAAC,aAAa,CAAC,MAAM,YAAY,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACvJ,CAAC;QAEF,+DAA+D;QAC/D,2CAA2C;QAC3C,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;oBAC3C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;oBACnB,CAAC,CAAC,QAAQ,CAAC;gBACb,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;oBAClD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;oBACjD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBACpC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,WAAW,CAAC;gBAC5D,CAAC;gBAAC,MAAM,CAAC;oBACP,GAAG,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YACD,GAAG,CACD,uBAAuB,MAAM,CAAC,iBAAiB,CAAC,MAAM,QAAQ,MAAM,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,eAAe,CAC9I,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,OAAsB;QACjD,6DAA6D;QAC7D,MAAM,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAE,OAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,KAAK,CACH,IAAI,OAAO,CAAC,IAAI,YAAY,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,aAAa,CAAC,IAAI,EAAE,CAChF,CAAC;QACF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,gBAAgB,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9D,KAAK,CACH,oBAAoB,OAAO,CAAC,GAAG,WAAW,gBAAgB,CAAC,MAAM,SAAS,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAChI,CAAC;gBACF,MAAM,KAAK,GAAG,kBAAkB,CAC9B,OAAO,CAAC,GAAG,EACX,KAAK,EACL,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,OAAO,CAAC,QAAQ,CACjB,CAAC;gBACF,KAAK,CAAC,kBAAkB,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;gBAC9C,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClE,MAAM;YACR,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACpD,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACjE,KAAK,CACH,kBAAkB,MAAM,CAAC,MAAM,SAAS,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,QAAQ,MAAM,IAAI,QAAQ,YAAY,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAClL,CAAC;gBACF,MAAM,OAAO,GAAG,MAAM;oBACpB,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;oBAClD,CAAC,CAAC,IAAI,CAAC;gBACT,KAAK,CACH,aAAa,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CACnE,CAAC;gBACF,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/D,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACvE,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,mBAAmB;oBACzB,SAAS;iBACV,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,WAAW,GAAG,kBAAkB,CACpC,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,IAAI,EACZ,KAAK,EACL,KAAK,EACL,MAAM,CACP,CAAC;gBACF,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,oBAAoB;oBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,WAAW;iBACZ,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACvE,MAAM,MAAM,GAAG,SAAS;oBACtB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;oBAC1C,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACnC,GAAG,EAAE,CAAC,CAAC,OAAO;oBACd,KAAK,EAAE;wBACL,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;wBAC5C,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;qBACjE;iBACF,CAAC,CAAC,CAAC;gBACJ,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,mBAAmB;oBACzB,SAAS;iBACV,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC1D,MAAM,YAAY,GAAG,uBAAuB,CAC1C,YAAY,EACZ,OAAO,CAAC,QAAQ,CACjB,CAAC;gBACF,MAAM,MAAM,GAAG,YAAY;oBACzB,CAAC,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;oBACrD,CAAC,CAAC,IAAI,CAAC;gBACT,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,eAAe;oBACrB,MAAM;iBACP,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACjE,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,wBAAwB;oBAC9B,IAAI;iBACL,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC9D,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,yBAAyB;oBAC/B,OAAO;iBACR,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACtD,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,uBAAuB;oBAC7B,MAAM;iBACP,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;gBACjD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC5C,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,WAAW,CAAC;gBAC/D,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;gBAC3D,KAAK,CACH,cAAc,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,QAAQ,WAAW,kBAAkB,YAAY,qBAAqB,CACxH,CAAC;gBACF,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC1C,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBACnD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;gBAC1D,KAAK,CACH,4BAA4B,aAAa,0BAA0B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,wBAAwB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,eAAe,CAC7J,CAAC;gBACF,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC9B,MAAM,WAAW,GAAG,kBAAkB,CACpC,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,IAAI,EACZ,KAAK,EACL,KAAK,EACL,MAAM,CACP,CAAC;gBACF,KAAK,CAAC,gBAAgB,WAAW,CAAC,MAAM,cAAc,CAAC,CAAC;gBACxD,WAAW,CAAC;oBACV,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,oBAAoB;oBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,WAAW;iBACZ,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;gBACrE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACrC,oBAAoB,CAClB,OAAO,CAAC,GAAG,EACX,IAAI,EACJ,KAAK,EACL,KAAK,EACL,cAAc,EACd,GAAG,EAAE;oBACH,MAAM,WAAW,GAAG,kBAAkB,CACpC,OAAO,CAAC,GAAG,EACX,IAAI,EACJ,KAAK,EACL,KAAK,EACL,MAAM,CACP,CAAC;oBACF,WAAW,CAAC;wBACV,EAAE,EAAE,OAAO,CAAC,EAAE;wBACd,IAAI,EAAE,kBAAkB;wBACxB,GAAG,EAAE,OAAO,CAAC,GAAG;wBAChB,WAAW;qBACZ,CAAC,CAAC;gBACL,CAAC,CACF,CAAC;gBACF,MAAM;YACR,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAClC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAChD,IAAI,OAAO,EAAE,CAAC;oBACZ,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC5B,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACrC,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC9B,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,KAAK,CAAC,aAAa,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC1B,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACnC,MAAM,aAAa,GAAG,0BAA0B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAChE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC7B,WAAW,CAAC;wBACV,EAAE,EAAE,OAAO,CAAC,EAAE;wBACd,IAAI,EAAE,kBAAkB;wBACxB,GAAG,EAAE,OAAO,CAAC,IAAI;wBACjB,WAAW,EAAE,aAAa;qBAC3B,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,SAAS,uBAAuB,CAC9B,MAAc,EACd,QAA6C;IAE7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,sDAAsD;IACtD,MAAM,UAAU,GAAG,aAAa,CAAC;IACjC,IAAI,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACpC,IAAI,QAAQ,CAAC,SAAS,IAAI,KAAK,IAAI,QAAQ,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oDAAoD;AACpD,KAAK,UAAU,aAAa,CAC1B,MAAsB,EACtB,KAAiB;IAEjB,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,aAAa,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;YACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC/C,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,SAAS,mBAAmB,CAAC,YAAoB;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACtD,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/esm/runtime/index.js

@@ -0,0 +1,5 @@
+export { buildImportGraph } from "./buildImportGraph.js";
+export { createGraphWorker } from "./createGraphWorker.js";
+export { rescanFile, scheduleBufferUpdate } from "./scheduleBufferUpdate.js";
+export { startLspServer } from "./startLspServer.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/runtime/scheduleBufferUpdate.js

@@ -0,0 +1,57 @@
+/**
+ * Buffer layer — debounced re-scan for a single file.
+ *
+ * After a document change, we delay the re-scan by 100ms. If another
+ * change arrives within that window, the previous timer is cleared.
+ *
+ * @note This function is impure — it uses `setTimeout` side effects.
+ *
+ * @see session/G.TOKEN_LSP.md §7.7 — Buffer layer with 100ms debounce
+ */
+import { buildSelectorContext, scanDeclarations, scanProperties, scanUsages, } from "../css/index.js";
+const DEBOUNCE_MS = 100;
+/**
+ * Schedule a debounced buffer update for a file.
+ *
+ * Clears any pending update for the same URI, then re-scans after 100ms.
+ *
+ * @note This function is impure — it schedules timers and mutates the graph.
+ */
+export function scheduleBufferUpdate(uri, source, graph, cache, pending, onComplete) {
+    const existing = pending.get(uri);
+    if (existing) {
+        clearTimeout(existing.timer);
+        pending.delete(uri);
+    }
+    const timer = setTimeout(() => {
+        pending.delete(uri);
+        rescanFile(uri, source, graph);
+        cache.invalidate(uri);
+        onComplete?.();
+    }, DEBOUNCE_MS);
+    pending.set(uri, { timer, uri });
+}
+/**
+ * Immediately rescan a file and update the graph.
+ *
+ * @note This function is impure — it mutates the graph.
+ */
+export function rescanFile(uri, source, graph) {
+    graph.clearFile(uri);
+    const declarations = scanDeclarations(source, uri);
+    for (const decl of declarations) {
+        graph.addDeclaration({
+            ...decl,
+            selector: buildSelectorContext(decl.selector.selector, decl.selector.atRules),
+        });
+    }
+    const properties = scanProperties(source, uri);
+    for (const prop of properties) {
+        graph.addProperty(prop);
+    }
+    const usages = scanUsages(source, uri);
+    for (const usage of usages) {
+        graph.addUsage(usage);
+    }
+}
+//# sourceMappingURL=scheduleBufferUpdate.js.map

package/dist/esm/runtime/scheduleBufferUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleBufferUpdate.js","sourceRoot":"","sources":["../../../src/runtime/scheduleBufferUpdate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,iBAAiB,CAAC;AAIzB,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAW,EACX,MAAc,EACd,KAAiB,EACjB,KAAwB,EACxB,OAAmC,EACnC,UAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,EAAE,CAAC;QACb,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,UAAU,EAAE,EAAE,CAAC;IACjB,CAAC,EAAE,WAAW,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,MAAc,EACd,KAAiB;IAEjB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAErB,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,KAAK,CAAC,cAAc,CAAC;YACnB,GAAG,IAAI;YACP,QAAQ,EAAE,oBAAoB,CAC5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EACtB,IAAI,CAAC,QAAQ,CAAC,OAAO,CACtB;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}