@canonical/terrazzo-lsp-extension 0.4.0

package/dist/esm/css/values/resolveDimensionValue.js

@@ -0,0 +1,62 @@
+import extractUnit from "./extractUnit.js";
+const UNIT_TO_CSS = new Map([
+    ["px", "<length>"],
+    ["rem", "<length>"],
+    ["em", "<length>"],
+    ["vw", "<length>"],
+    ["vh", "<length>"],
+    ["dvw", "<length>"],
+    ["dvh", "<length>"],
+    ["dvmin", "<length>"],
+    ["dvmax", "<length>"],
+    ["svw", "<length>"],
+    ["svh", "<length>"],
+    ["svmin", "<length>"],
+    ["svmax", "<length>"],
+    ["lvw", "<length>"],
+    ["lvh", "<length>"],
+    ["lvmin", "<length>"],
+    ["lvmax", "<length>"],
+    ["vmin", "<length>"],
+    ["vmax", "<length>"],
+    ["cqw", "<length>"],
+    ["cqh", "<length>"],
+    ["cqi", "<length>"],
+    ["cqb", "<length>"],
+    ["cqmin", "<length>"],
+    ["cqmax", "<length>"],
+    ["ch", "<length>"],
+    ["ex", "<length>"],
+    ["ic", "<length>"],
+    ["lh", "<length>"],
+    ["rlh", "<length>"],
+    ["cap", "<length>"],
+    ["cm", "<length>"],
+    ["mm", "<length>"],
+    ["Q", "<length>"],
+    ["in", "<length>"],
+    ["pt", "<length>"],
+    ["pc", "<length>"],
+    ["deg", "<angle>"],
+    ["rad", "<angle>"],
+    ["grad", "<angle>"],
+    ["turn", "<angle>"],
+    ["s", "<time>"],
+    ["ms", "<time>"],
+    ["Hz", "<frequency>"],
+    ["kHz", "<frequency>"],
+    ["dpi", "<resolution>"],
+    ["dpcm", "<resolution>"],
+    ["dppx", "<resolution>"],
+    ["x", "<resolution>"],
+    ["fr", "<flex>"],
+]);
+export default function resolveDimensionValue(value) {
+    const unit = extractUnit(value);
+    if (!unit)
+        return "<number>";
+    if (unit === "%")
+        return "<percentage>";
+    return UNIT_TO_CSS.get(unit) ?? "<unknown>";
+}
+//# sourceMappingURL=resolveDimensionValue.js.map

package/dist/esm/css/values/resolveDimensionValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDimensionValue.js","sourceRoot":"","sources":["../../../../src/css/values/resolveDimensionValue.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,WAAW,GAAsC,IAAI,GAAG,CAAC;IAC7D,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,MAAM,EAAE,UAAU,CAAC;IACpB,CAAC,MAAM,EAAE,UAAU,CAAC;IACpB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,GAAG,EAAE,UAAU,CAAC;IACjB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,IAAI,EAAE,UAAU,CAAC;IAClB,CAAC,KAAK,EAAE,SAAS,CAAC;IAClB,CAAC,KAAK,EAAE,SAAS,CAAC;IAClB,CAAC,MAAM,EAAE,SAAS,CAAC;IACnB,CAAC,MAAM,EAAE,SAAS,CAAC;IACnB,CAAC,GAAG,EAAE,QAAQ,CAAC;IACf,CAAC,IAAI,EAAE,QAAQ,CAAC;IAChB,CAAC,IAAI,EAAE,aAAa,CAAC;IACrB,CAAC,KAAK,EAAE,aAAa,CAAC;IACtB,CAAC,KAAK,EAAE,cAAc,CAAC;IACvB,CAAC,MAAM,EAAE,cAAc,CAAC;IACxB,CAAC,MAAM,EAAE,cAAc,CAAC;IACxB,CAAC,GAAG,EAAE,cAAc,CAAC;IACrB,CAAC,IAAI,EAAE,QAAQ,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,KAAa;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO,UAAU,CAAC;IAC7B,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,cAAc,CAAC;IACxC,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC;AAC9C,CAAC"}

package/dist/esm/diagnosticCodes.js

@@ -0,0 +1,18 @@
+export const DIAGNOSTIC_CODES = [
+    "css/unknown-var",
+    "css/missing-fallback",
+    "css/stale-fallback",
+    "css/type-mismatch",
+    "css/type-uncertain",
+    "css/unreachable-token",
+    "css/primitive-token",
+    "css/scoped-usage",
+    "css/no-color-scheme",
+    "dtcg/broken-alias",
+    "dtcg/schema-violation",
+    "dtcg/circular-alias",
+    "dtcg/missing-type",
+    "dtcg/draft-syntax",
+];
+export const KNOWN_CODES = new Set(DIAGNOSTIC_CODES);
+//# sourceMappingURL=diagnosticCodes.js.map

package/dist/esm/diagnosticCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticCodes.js","sourceRoot":"","sources":["../../src/diagnosticCodes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,iBAAiB;IACjB,sBAAsB;IACtB,oBAAoB;IACpB,mBAAmB;IACnB,oBAAoB;IACpB,uBAAuB;IACvB,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,uBAAuB;IACvB,qBAAqB;IACrB,mBAAmB;IACnB,mBAAmB;CACX,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAgC,IAAI,GAAG,CAC7D,gBAAgB,CACjB,CAAC"}

package/dist/esm/extension/findBundledVsixPath.js

@@ -0,0 +1,20 @@
+/**
+ * @note impure — reads the filesystem to find bundled VSIX packages.
+ */
+import * as fs from "node:fs/promises";
+import { join } from "node:path";
+/** Find the bundled VS Code extension package in the package root. */
+export default async function findBundledVsixPath(packageRoot) {
+    const extensionDir = join(packageRoot, "extension");
+    try {
+        const fileNames = await fs.readdir(extensionDir);
+        const vsixName = [...fileNames]
+            .filter((fileName) => /^terrazzo-lsp-.*\.vsix$/u.test(fileName))
+            .sort()[0];
+        return vsixName ? join(extensionDir, vsixName) : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=findBundledVsixPath.js.map

package/dist/esm/extension/findBundledVsixPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findBundledVsixPath.js","sourceRoot":"","sources":["../../../src/extension/findBundledVsixPath.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sEAAsE;AACtE,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,mBAAmB,CAC/C,WAAmB;IAEnB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC;aAC5B,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aAC/D,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEb,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/extension/index.js

@@ -0,0 +1,4 @@
+export { default as findBundledVsixPath } from "./findBundledVsixPath.js";
+export { default as installBundledVscodeExtension } from "./installBundledVscodeExtension.js";
+export { default as updateVscodeSettings } from "./updateVscodeSettings.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extension/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/esm/extension/installBundledVscodeExtension.js

@@ -0,0 +1,25 @@
+import { execFileSync } from "node:child_process";
+/**
+ * Install the bundled VS Code extension with the `code` CLI.
+ *
+ * @note This function is impure because it invokes an external process.
+ */
+export default async function installBundledVscodeExtension(vsixPath, runInstallCommand = executeInstallCommand) {
+    try {
+        runInstallCommand("code", ["--install-extension", vsixPath]);
+        return {
+            didInstall: true,
+            message: "Terrazzo LSP extension installed.",
+        };
+    }
+    catch {
+        return {
+            didInstall: false,
+            message: `Auto-install failed. Install manually:\n  code --install-extension ${vsixPath}`,
+        };
+    }
+}
+function executeInstallCommand(command, args) {
+    execFileSync(command, args, { stdio: "inherit" });
+}
+//# sourceMappingURL=installBundledVscodeExtension.js.map

package/dist/esm/extension/installBundledVscodeExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installBundledVscodeExtension.js","sourceRoot":"","sources":["../../../src/extension/installBundledVscodeExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD;;;;GAIG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,6BAA6B,CACzD,QAAgB,EAChB,oBAAuC,qBAAqB;IAE5D,IAAI,CAAC;QACH,iBAAiB,CAAC,MAAM,EAAE,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7D,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,mCAAmC;SAC7C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,sEAAsE,QAAQ,EAAE;SAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe,EAAE,IAAc;IAC5D,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/esm/extension/updateVscodeSettings.js

@@ -0,0 +1,8 @@
+/** Merge the required Terrazzo VS Code settings into existing settings. */
+export default function updateVscodeSettings(settings) {
+    return {
+        ...settings,
+        "terrazzo-lsp.enable": true,
+    };
+}
+//# sourceMappingURL=updateVscodeSettings.js.map

package/dist/esm/extension/updateVscodeSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateVscodeSettings.js","sourceRoot":"","sources":["../../../src/extension/updateVscodeSettings.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,QAAiC;IAEjC,OAAO;QACL,GAAG,QAAQ;QACX,qBAAqB,EAAE,IAAI;KAC5B,CAAC;AACJ,CAAC"}

package/dist/esm/graph/ReachabilityCache.js

@@ -0,0 +1,91 @@
+/** Maximum number of cached reachability sets before LRU eviction kicks in. */
+const MAX_ENTRIES = 500;
+export default class ReachabilityCache {
+    cache = new Map();
+    dependents = new Map();
+    getReachableFiles(fileUri, graph) {
+        const cached = this.cache.get(fileUri);
+        if (cached) {
+            // Move to end for LRU freshness
+            this.cache.delete(fileUri);
+            this.cache.set(fileUri, cached);
+            return cached;
+        }
+        const visited = new Set();
+        const stack = [fileUri];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (visited.has(current))
+                continue;
+            visited.add(current);
+            const imports = graph.getImports(current);
+            if (imports)
+                for (const imported of imports)
+                    if (!visited.has(imported))
+                        stack.push(imported);
+        }
+        // LRU eviction: drop the oldest entry if over capacity
+        if (this.cache.size >= MAX_ENTRIES) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest !== undefined) {
+                this.cache.delete(oldest);
+                this.dependents.delete(oldest);
+            }
+        }
+        this.cache.set(fileUri, visited);
+        for (const reachable of visited) {
+            let deps = this.dependents.get(reachable);
+            if (!deps) {
+                deps = new Set();
+                this.dependents.set(reachable, deps);
+            }
+            deps.add(fileUri);
+        }
+        return visited;
+    }
+    getReachableVars(fileUri, graph, globalStylesheets) {
+        const reachable = this.getReachableFiles(fileUri, graph);
+        const vars = new Set();
+        for (const uri of reachable) {
+            const decls = graph.getDeclarationsByFile(uri);
+            for (const d of decls)
+                vars.add(d.cssVar);
+        }
+        if (globalStylesheets) {
+            for (const uri of globalStylesheets) {
+                const decls = graph.getDeclarationsByFile(uri);
+                for (const d of decls)
+                    vars.add(d.cssVar);
+            }
+        }
+        return vars;
+    }
+    invalidate(fileUri) {
+        const toInvalidate = new Set();
+        const stack = [fileUri];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (toInvalidate.has(current))
+                continue;
+            toInvalidate.add(current);
+            const deps = this.dependents.get(current);
+            if (deps)
+                for (const dep of deps)
+                    if (!toInvalidate.has(dep))
+                        stack.push(dep);
+        }
+        for (const uri of toInvalidate) {
+            this.cache.delete(uri);
+            this.dependents.delete(uri);
+        }
+    }
+    invalidateAll() {
+        this.cache.clear();
+        this.dependents.clear();
+    }
+    /** Current number of cached entries (exposed for testing). */
+    get size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=ReachabilityCache.js.map

package/dist/esm/graph/ReachabilityCache.js.map

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

package/dist/esm/graph/TokenGraph.js

@@ -0,0 +1,370 @@
+export default class TokenGraph {
+    data;
+    constructor() {
+        this.data = {
+            tokens: new Map(),
+            files: new Map(),
+            declarations: new Map(),
+            properties: new Map(),
+            usages: new Map(),
+            declarationsByFile: new Map(),
+            propertiesByFile: new Map(),
+            usagesByFile: new Map(),
+            imports: new Map(),
+            importedBy: new Map(),
+            allVars: new Set(),
+            artifactFileUris: new Set(),
+        };
+    }
+    // ── Mutation — tokens ───────────────────────────────────────────
+    /** Register or overwrite an artifact/local token. */
+    addToken(node) {
+        this.data.tokens.set(node.cssVar, node);
+        this.data.allVars.add(node.cssVar);
+    }
+    /** Remove all tokens (used when reloading artifacts). */
+    clearTokens() {
+        this.data.tokens.clear();
+    }
+    // ── Mutation — files ────────────────────────────────────────────
+    /** Register a file node. */
+    addFile(node) {
+        this.data.files.set(node.uri, node);
+    }
+    /** Remove a file entry by URI. */
+    removeFile(fileUri) {
+        this.data.files.delete(fileUri);
+    }
+    // ── Mutation — declarations ─────────────────────────────────────
+    /** Add a declaration and update both per-var and per-file indices. */
+    addDeclaration(node) {
+        const byVar = this.data.declarations.get(node.cssVar);
+        if (byVar)
+            byVar.push(node);
+        else
+            this.data.declarations.set(node.cssVar, [node]);
+        const byFile = this.data.declarationsByFile.get(node.fileUri);
+        if (byFile)
+            byFile.push(node);
+        else
+            this.data.declarationsByFile.set(node.fileUri, [node]);
+        this.data.allVars.add(node.cssVar);
+    }
+    // ── Mutation — properties ───────────────────────────────────────
+    /** Add an `@property` registration node. */
+    addProperty(node) {
+        this.data.properties.set(node.cssVar, node);
+        const byFile = this.data.propertiesByFile.get(node.fileUri);
+        if (byFile)
+            byFile.push(node);
+        else
+            this.data.propertiesByFile.set(node.fileUri, [node]);
+        this.data.allVars.add(node.cssVar);
+    }
+    // ── Mutation — usages ───────────────────────────────────────────
+    /** Add a `var()` usage site. */
+    addUsage(node) {
+        const byVar = this.data.usages.get(node.cssVar);
+        if (byVar)
+            byVar.push(node);
+        else
+            this.data.usages.set(node.cssVar, [node]);
+        const byFile = this.data.usagesByFile.get(node.fileUri);
+        if (byFile)
+            byFile.push(node);
+        else
+            this.data.usagesByFile.set(node.fileUri, [node]);
+    }
+    // ── Mutation — import edges ─────────────────────────────────────
+    /** Add a single directed import edge (updates both forward and reverse). */
+    addImport(importerUri, importedUri) {
+        const forward = this.data.imports.get(importerUri);
+        if (forward)
+            forward.add(importedUri);
+        else
+            this.data.imports.set(importerUri, new Set([importedUri]));
+        const reverse = this.data.importedBy.get(importedUri);
+        if (reverse)
+            reverse.add(importerUri);
+        else
+            this.data.importedBy.set(importedUri, new Set([importerUri]));
+    }
+    /**
+     * Replace the full import set for a file, cleaning up stale reverse edges.
+     *
+     * This is the primary entry-point used by the indexing pipeline when a
+     * document's `@import` list changes.
+     */
+    setImports(importerUri, nextImports) {
+        const previousImports = this.data.imports.get(importerUri) ?? new Set();
+        // Remove stale reverse edges
+        for (const importedUri of previousImports) {
+            if (nextImports.has(importedUri))
+                continue;
+            const importers = this.data.importedBy.get(importedUri);
+            if (!importers)
+                continue;
+            importers.delete(importerUri);
+            if (importers.size === 0)
+                this.data.importedBy.delete(importedUri);
+        }
+        // Set forward edges
+        if (nextImports.size === 0) {
+            this.data.imports.delete(importerUri);
+        }
+        else {
+            this.data.imports.set(importerUri, nextImports);
+        }
+        // Add new reverse edges
+        for (const importedUri of nextImports) {
+            const importers = this.data.importedBy.get(importedUri) ?? new Set();
+            importers.add(importerUri);
+            this.data.importedBy.set(importedUri, importers);
+        }
+    }
+    /**
+     * Remove all import edges originating from *and* pointing to a file.
+     *
+     * Used during file cleanup / reindex to sever a file from the graph.
+     */
+    clearImportEdges(fileUri) {
+        // Remove forward edges (fileUri imports → X)
+        const importedUris = this.data.imports.get(fileUri);
+        if (importedUris) {
+            for (const importedUri of importedUris) {
+                const importers = this.data.importedBy.get(importedUri);
+                if (!importers)
+                    continue;
+                importers.delete(fileUri);
+                if (importers.size === 0)
+                    this.data.importedBy.delete(importedUri);
+            }
+            this.data.imports.delete(fileUri);
+        }
+        // Remove reverse edges (X imports → fileUri)
+        const importerUris = this.data.importedBy.get(fileUri);
+        if (importerUris) {
+            for (const importerUri of importerUris) {
+                const imports = this.data.imports.get(importerUri);
+                if (!imports)
+                    continue;
+                imports.delete(fileUri);
+                if (imports.size === 0)
+                    this.data.imports.delete(importerUri);
+            }
+            this.data.importedBy.delete(fileUri);
+        }
+    }
+    // ── Mutation — artifact markers ─────────────────────────────────
+    /** Mark a file URI as originating from artifact declarations. */
+    markArtifactFile(fileUri) {
+        this.data.artifactFileUris.add(fileUri);
+    }
+    // ── Mutation — per-file cleanup ─────────────────────────────────
+    /**
+     * Remove all declarations, properties, and usages for a file.
+     *
+     * The per-var indices are patched to remove entries belonging to the file
+     * and `allVars` is synced (vars with no remaining token/decl/property are
+     * removed).
+     */
+    clearFile(fileUri) {
+        const fileDecls = this.data.declarationsByFile.get(fileUri);
+        if (fileDecls) {
+            for (const decl of fileDecls) {
+                const byVar = this.data.declarations.get(decl.cssVar);
+                if (byVar) {
+                    const filtered = byVar.filter((d) => d.fileUri !== fileUri);
+                    if (filtered.length > 0)
+                        this.data.declarations.set(decl.cssVar, filtered);
+                    else
+                        this.data.declarations.delete(decl.cssVar);
+                }
+                this.syncAllVar(decl.cssVar);
+            }
+            this.data.declarationsByFile.set(fileUri, []);
+        }
+        const fileProps = this.data.propertiesByFile.get(fileUri);
+        if (fileProps) {
+            for (const prop of fileProps) {
+                const existing = this.data.properties.get(prop.cssVar);
+                if (existing?.fileUri === fileUri)
+                    this.data.properties.delete(prop.cssVar);
+                this.syncAllVar(prop.cssVar);
+            }
+            this.data.propertiesByFile.set(fileUri, []);
+        }
+        const fileUsages = this.data.usagesByFile.get(fileUri);
+        if (fileUsages) {
+            for (const usage of fileUsages) {
+                const byVar = this.data.usages.get(usage.cssVar);
+                if (byVar) {
+                    const filtered = byVar.filter((u) => u.fileUri !== fileUri);
+                    if (filtered.length > 0)
+                        this.data.usages.set(usage.cssVar, filtered);
+                    else
+                        this.data.usages.delete(usage.cssVar);
+                }
+            }
+            this.data.usagesByFile.set(fileUri, []);
+        }
+    }
+    /**
+     * Purge all non-artifact CSS data from the graph.
+     *
+     * Walks every file URI in the graph, skips artifact files, and removes
+     * all CSS-sourced data (declarations, properties, usages, import edges,
+     * file entries). Used by the reindex pipeline before re-scanning.
+     */
+    clearCssData() {
+        const fileUris = new Set([
+            ...this.data.files.keys(),
+            ...this.data.declarationsByFile.keys(),
+            ...this.data.propertiesByFile.keys(),
+            ...this.data.usagesByFile.keys(),
+            ...this.data.imports.keys(),
+            ...this.data.importedBy.keys(),
+        ]);
+        for (const fileUri of fileUris) {
+            if (this.data.artifactFileUris.has(fileUri))
+                continue;
+            this.clearFile(fileUri);
+            this.clearImportEdges(fileUri);
+            this.data.files.delete(fileUri);
+            this.data.declarationsByFile.delete(fileUri);
+            this.data.propertiesByFile.delete(fileUri);
+            this.data.usagesByFile.delete(fileUri);
+        }
+    }
+    // ── Queries — tokens ────────────────────────────────────────────
+    /** Resolve a CSS variable to its TokenNode, or `null` if not found. */
+    resolveToken(cssVar) {
+        return this.data.tokens.get(cssVar) ?? null;
+    }
+    /** Check whether a token exists for the given CSS variable. */
+    hasToken(cssVar) {
+        return this.data.tokens.has(cssVar);
+    }
+    /** Return the total number of registered tokens. */
+    get tokenCount() {
+        return this.data.tokens.size;
+    }
+    /** Iterate over all `[cssVar, TokenNode]` entries. */
+    tokenEntries() {
+        return this.data.tokens.entries();
+    }
+    /** Iterate over all registered token nodes. */
+    tokenValues() {
+        return this.data.tokens.values();
+    }
+    // ── Queries — files ─────────────────────────────────────────────
+    /** Retrieve a file node by URI, or `null`. */
+    getFile(fileUri) {
+        return this.data.files.get(fileUri) ?? null;
+    }
+    /** Check whether a file is already indexed. */
+    hasFile(fileUri) {
+        return this.data.files.has(fileUri);
+    }
+    /** Return the total number of indexed files. */
+    get fileCount() {
+        return this.data.files.size;
+    }
+    // ── Queries — declarations ──────────────────────────────────────
+    /** Get all declaration nodes for a CSS variable. */
+    getDeclarations(cssVar) {
+        return this.data.declarations.get(cssVar) ?? [];
+    }
+    /** Check whether any declarations exist for a CSS variable. */
+    hasDeclarations(cssVar) {
+        return this.data.declarations.has(cssVar);
+    }
+    /** Total count of distinct CSS variables that have declarations. */
+    get declarationVarCount() {
+        return this.data.declarations.size;
+    }
+    /** Iterate over all `[cssVar, DeclarationNode[]]` entries. */
+    declarationEntries() {
+        return this.data.declarations.entries();
+    }
+    /** Get declarations for a specific file URI. */
+    getDeclarationsByFile(fileUri) {
+        return this.data.declarationsByFile.get(fileUri) ?? [];
+    }
+    // ── Queries — properties ────────────────────────────────────────
+    /** Get the `@property` registration for a CSS variable, or `null`. */
+    getProperty(cssVar) {
+        return this.data.properties.get(cssVar) ?? null;
+    }
+    /** Check whether an `@property` registration exists. */
+    hasProperty(cssVar) {
+        return this.data.properties.has(cssVar);
+    }
+    /** Iterate over all registered property nodes. */
+    propertyValues() {
+        return this.data.properties.values();
+    }
+    /** Total count of distinct `@property` registrations. */
+    get propertyVarCount() {
+        return this.data.properties.size;
+    }
+    /** Get `@property` nodes for a specific file URI. */
+    getPropertiesByFile(fileUri) {
+        return this.data.propertiesByFile.get(fileUri) ?? [];
+    }
+    // ── Queries — usages ────────────────────────────────────────────
+    /** Get all `var()` usage sites for a CSS variable. */
+    getUsages(cssVar) {
+        return this.data.usages.get(cssVar) ?? [];
+    }
+    /** Total count of distinct CSS variables that have usages. */
+    get usageVarCount() {
+        return this.data.usages.size;
+    }
+    /** Get usages for a specific file URI. */
+    getUsagesByFile(fileUri) {
+        return this.data.usagesByFile.get(fileUri) ?? [];
+    }
+    // ── Queries — imports ───────────────────────────────────────────
+    /** Get the set of URIs imported by a file (forward edges). */
+    getImports(fileUri) {
+        return this.data.imports.get(fileUri);
+    }
+    /** Get the set of URIs that import a file (reverse edges). */
+    getImportedBy(fileUri) {
+        return this.data.importedBy.get(fileUri);
+    }
+    /** Iterate all `[importerUri, Set<importedUri>]` forward edge entries. */
+    importEntries() {
+        return this.data.imports.entries();
+    }
+    // ── Queries — allVars ───────────────────────────────────────────
+    /** Check whether any token, declaration, or property exists for a var. */
+    hasVar(cssVar) {
+        return this.data.allVars.has(cssVar);
+    }
+    /** Total number of known CSS variable names. */
+    get varCount() {
+        return this.data.allVars.size;
+    }
+    // ── Queries — artifact markers ──────────────────────────────────
+    /** Check whether a file URI was injected by the artifact loader. */
+    isArtifactFile(fileUri) {
+        return this.data.artifactFileUris.has(fileUri);
+    }
+    /** Get the selector context from a declaration node. */
+    selectorContextFor(decl) {
+        return decl.selector;
+    }
+    // ── Private ─────────────────────────────────────────────────────
+    syncAllVar(cssVar) {
+        if (this.data.tokens.has(cssVar))
+            return;
+        if (this.data.declarations.has(cssVar))
+            return;
+        if (this.data.properties.has(cssVar))
+            return;
+        this.data.allVars.delete(cssVar);
+    }
+}
+//# sourceMappingURL=TokenGraph.js.map