@canonical/terrazzo-lsp 0.0.1

package/dist/esm/css/scanDeclarations.js

@@ -0,0 +1,107 @@
+/**
+ * @see session/G.TOKEN_LSP.md §7.3 — DeclarationNode
+ * @see session/G.TOKEN_LSP.md §10.4 — Selector scope classification
+ */
+import { buildSelectorContext } from "./buildSelectorContext.js";
+const DECL_REGEX = /(--[\w-]+)\s*:\s*([^;{}]+)/g;
+/** Scan CSS source for custom property declarations. */
+export function scanDeclarations(source, fileUri) {
+    const results = [];
+    const lines = source.split("\n");
+    const selectorStack = [];
+    const atRuleStack = [];
+    let braceDepth = 0;
+    const depthContexts = [];
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        for (let i = 0; i < line.length; i++) {
+            const ch = line[i];
+            if (ch === "{") {
+                const preceding = line.substring(0, i).trim();
+                const atRuleMatch = preceding.match(/@(\w+)\s*(.*)/);
+                if (atRuleMatch && atRuleMatch[1] !== "property") {
+                    const atRule = {
+                        name: atRuleMatch[1],
+                        prelude: atRuleMatch[2]?.trim() ?? "",
+                    };
+                    atRuleStack.push(atRule);
+                    depthContexts[braceDepth] = { selector: null, atRule };
+                }
+                else if (atRuleMatch && atRuleMatch[1] === "property") {
+                    depthContexts[braceDepth] = { selector: null, atRule: null };
+                }
+                else {
+                    const selector = preceding || ":root";
+                    selectorStack.push(selector);
+                    depthContexts[braceDepth] = { selector, atRule: null };
+                }
+                braceDepth++;
+            }
+            else if (ch === "}") {
+                braceDepth--;
+                if (braceDepth >= 0) {
+                    const ctx = depthContexts[braceDepth];
+                    if (ctx?.selector)
+                        selectorStack.pop();
+                    if (ctx?.atRule)
+                        atRuleStack.pop();
+                    depthContexts[braceDepth] = { selector: null, atRule: null };
+                }
+            }
+        }
+        DECL_REGEX.lastIndex = 0;
+        let match = DECL_REGEX.exec(line);
+        while (match !== null) {
+            const cssVar = match[1];
+            const rawValue = match[2].trim();
+            const currentSelector = selectorStack.length > 0
+                ? selectorStack[selectorStack.length - 1]
+                : ":root";
+            const selectorCtx = buildSelectorContext(currentSelector, [
+                ...atRuleStack,
+            ]);
+            results.push({
+                cssVar,
+                fileUri,
+                line: lineIndex,
+                column: match.index,
+                rawValue,
+                cssType: inferCssType(rawValue),
+                selector: selectorCtx,
+            });
+            match = DECL_REGEX.exec(line);
+        }
+    }
+    return results;
+}
+function inferCssType(rawValue) {
+    const trimmed = rawValue.trim();
+    if (/^(oklch|rgb|rgba|hsl|hsla|hwb|lab|lch|color|light-dark)\s*\(/i.test(trimmed))
+        return "<color>";
+    if (/^#[0-9a-f]{3,8}$/i.test(trimmed))
+        return "<color>";
+    if (/^(transparent|currentcolor|inherit|initial|unset)$/i.test(trimmed))
+        return "<color>";
+    const unitMatch = trimmed.match(/^-?[\d.]+([a-zA-Z%]+)$/);
+    if (unitMatch) {
+        const unit = unitMatch[1];
+        if (unit === "%")
+            return "<percentage>";
+        if (/^(px|rem|em|vw|vh|ch|ex|cm|mm|in|pt|pc|lh|rlh|cap)$/i.test(unit))
+            return "<length>";
+        if (/^(deg|rad|grad|turn)$/i.test(unit))
+            return "<angle>";
+        if (/^(s|ms)$/i.test(unit))
+            return "<time>";
+        if (/^(Hz|kHz)$/.test(unit))
+            return "<frequency>";
+        if (/^(dpi|dpcm|dppx|x)$/.test(unit))
+            return "<resolution>";
+        if (unit === "fr")
+            return "<flex>";
+    }
+    if (/^-?[\d.]+$/.test(trimmed))
+        return "<number>";
+    return "<unknown>";
+}
+//# sourceMappingURL=scanDeclarations.js.map

package/dist/esm/css/scanDeclarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanDeclarations.js","sourceRoot":"","sources":["../../../src/css/scanDeclarations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAEjD,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,OAAe;IAEf,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,aAAa,GAGd,EAAE,CAAC;IAER,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC9C,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBACrD,IAAI,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;oBACjD,MAAM,MAAM,GAAkB;wBAC5B,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;wBACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;qBACtC,CAAC;oBACF,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACzB,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzD,CAAC;qBAAM,IAAI,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;oBACxD,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBAC/D,CAAC;qBAAM,CAAC;oBACN,MAAM,QAAQ,GAAG,SAAS,IAAI,OAAO,CAAC;oBACtC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC7B,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACzD,CAAC;gBACD,UAAU,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACtB,UAAU,EAAE,CAAC;gBACb,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;oBACpB,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;oBACtC,IAAI,GAAG,EAAE,QAAQ;wBAAE,aAAa,CAAC,GAAG,EAAE,CAAC;oBACvC,IAAI,GAAG,EAAE,MAAM;wBAAE,WAAW,CAAC,GAAG,EAAE,CAAC;oBACnC,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QACD,UAAU,CAAC,SAAS,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,eAAe,GACnB,aAAa,CAAC,MAAM,GAAG,CAAC;gBACtB,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;gBACzC,CAAC,CAAC,OAAO,CAAC;YACd,MAAM,WAAW,GAAG,oBAAoB,CAAC,eAAe,EAAE;gBACxD,GAAG,WAAW;aACf,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,KAAK,CAAC,KAAK;gBACnB,QAAQ;gBACR,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC;gBAC/B,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;YACH,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IACE,+DAA+D,CAAC,IAAI,CAClE,OAAO,CACR;QAED,OAAO,SAAS,CAAC;IACnB,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACxD,IAAI,qDAAqD,CAAC,IAAI,CAAC,OAAO,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,cAAc,CAAC;QACxC,IAAI,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC;YACnE,OAAO,UAAU,CAAC;QACpB,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1D,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC5C,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,aAAa,CAAC;QAClD,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,cAAc,CAAC;QAC5D,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;IACrC,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC;IAClD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/esm/css/scanProperties.js

@@ -0,0 +1,40 @@
+/**
+ * @see session/G.TOKEN_LSP.md §7.3 — PropertyNode
+ */
+import { parseSyntaxType } from "./parseSyntaxType.js";
+const PROPERTY_REGEX = /@property\s+(--[\w-]+)\s*\{([^}]*)\}/g;
+/** Scan CSS source for @property registration blocks. */
+export function scanProperties(source, fileUri) {
+    const results = [];
+    PROPERTY_REGEX.lastIndex = 0;
+    let match = PROPERTY_REGEX.exec(source);
+    while (match !== null) {
+        const cssVar = match[1];
+        const body = match[2];
+        const upToMatch = source.substring(0, match.index);
+        const line = upToMatch.split("\n").length - 1;
+        const syntax = extractDescriptor(body, "syntax");
+        const inheritsRaw = extractDescriptor(body, "inherits");
+        const initialValue = extractDescriptor(body, "initial-value");
+        const inherits = inheritsRaw === "true";
+        const syntaxValue = syntax ? syntax.replace(/^['"]|['"]$/g, "") : "*";
+        const cssType = parseSyntaxType(syntaxValue);
+        results.push({
+            cssVar,
+            fileUri,
+            line,
+            syntax: syntaxValue,
+            inherits,
+            initialValue,
+            cssType,
+        });
+        match = PROPERTY_REGEX.exec(source);
+    }
+    return results;
+}
+function extractDescriptor(body, name) {
+    const regex = new RegExp(`${name}\\s*:\\s*([^;]+)`, "i");
+    const match = body.match(regex);
+    return match ? match[1].trim() : null;
+}
+//# sourceMappingURL=scanProperties.js.map

package/dist/esm/css/scanProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanProperties.js","sourceRoot":"","sources":["../../../src/css/scanProperties.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,cAAc,GAAG,uCAAuC,CAAC;AAE/D,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,OAAe;IAEf,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,WAAW,KAAK,MAAM,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACtE,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,OAAO;YACP,IAAI;YACJ,MAAM,EAAE,WAAW;YACnB,QAAQ;YACR,YAAY;YACZ,OAAO;SACR,CAAC,CAAC;QACH,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,IAAY;IACnD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC"}

package/dist/esm/css/scanUsages.js

@@ -0,0 +1,81 @@
+const CSS_PROPERTY_REGEX = /([\w-]+)\s*:/;
+/** Scan CSS source for var() usage sites (supports multi-line var() calls). */
+export function scanUsages(source, fileUri) {
+    const results = [];
+    const lines = source.split("\n");
+    // Build line offset table: lineOffsets[i] = character offset of line i
+    const lineOffsets = [0];
+    for (let i = 0; i < lines.length - 1; i++) {
+        lineOffsets.push(lineOffsets[i] + lines[i].length + 1); // +1 for \n
+    }
+    // Binary search: character offset → line number
+    function offsetToLine(offset) {
+        let lo = 0;
+        let hi = lineOffsets.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi + 1) >> 1;
+            if (lineOffsets[mid] <= offset)
+                lo = mid;
+            else
+                hi = mid - 1;
+        }
+        return lo;
+    }
+    // Walk backwards from offset to the previous `;` or `{` to find the
+    // enclosing CSS property name. Handles multi-line declarations.
+    function findPropertyAtOffset(offset) {
+        let i = offset - 1;
+        while (i >= 0 && source[i] !== ";" && source[i] !== "{")
+            i--;
+        const segment = source.substring(i + 1, offset);
+        const match = segment.match(CSS_PROPERTY_REGEX);
+        return match ? match[1] : "unknown";
+    }
+    // Scan full source for `var( --name` patterns (handles multi-line)
+    const VAR_OPEN = /var\(\s*(--[\w-]+)/g;
+    let m = VAR_OPEN.exec(source);
+    while (m !== null) {
+        const varStart = m.index;
+        const cssVar = m[1];
+        const afterName = varStart + m[0].length;
+        // Determine fallback: look for comma after the variable name
+        let fallback = null;
+        const rest = source.substring(afterName);
+        const commaMatch = rest.match(/^\s*,\s*/);
+        if (commaMatch) {
+            const fbStart = afterName + commaMatch[0].length;
+            // Track parens to find the matching close paren for this var()
+            let depth = 1;
+            let i = fbStart;
+            while (i < source.length && depth > 0) {
+                if (source[i] === "(")
+                    depth++;
+                else if (source[i] === ")")
+                    depth--;
+                i++;
+            }
+            if (depth === 0) {
+                fallback = source.substring(fbStart, i - 1).trim() || null;
+            }
+        }
+        // Map character offset to line/column
+        const line = offsetToLine(varStart);
+        const column = varStart - lineOffsets[line];
+        // --name starts after "var(" and optional whitespace
+        const varNameStart = varStart + m[0].length - cssVar.length;
+        const varNameColumn = varNameStart - lineOffsets[line];
+        results.push({
+            cssVar,
+            fileUri,
+            line,
+            column,
+            varNameColumn,
+            varNameLength: cssVar.length,
+            property: findPropertyAtOffset(varStart),
+            fallback,
+        });
+        m = VAR_OPEN.exec(source);
+    }
+    return results;
+}
+//# sourceMappingURL=scanUsages.js.map

package/dist/esm/css/scanUsages.js.map

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

package/dist/esm/graph/ReachabilityCache.js

@@ -0,0 +1,75 @@
+export class ReachabilityCache {
+    cache = new Map();
+    dependents = new Map();
+    reachableFiles(fileUri, graph) {
+        const cached = this.cache.get(fileUri);
+        if (cached)
+            return cached;
+        const visited = new Set();
+        const queue = [fileUri];
+        while (queue.length > 0) {
+            const current = queue.pop();
+            if (visited.has(current))
+                continue;
+            visited.add(current);
+            const imports = graph.data.imports.get(current);
+            if (imports)
+                for (const imported of imports)
+                    if (!visited.has(imported))
+                        queue.push(imported);
+        }
+        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;
+    }
+    reachableVars(fileUri, graph, globalStylesheets) {
+        const reachable = this.reachableFiles(fileUri, graph);
+        const vars = new Set();
+        for (const uri of reachable) {
+            const decls = graph.data.declarationsByFile.get(uri);
+            if (decls)
+                for (const d of decls)
+                    vars.add(d.cssVar);
+        }
+        if (globalStylesheets) {
+            for (const uri of globalStylesheets) {
+                const decls = graph.data.declarationsByFile.get(uri);
+                if (decls)
+                    for (const d of decls)
+                        vars.add(d.cssVar);
+            }
+        }
+        return vars;
+    }
+    invalidate(fileUri) {
+        const toInvalidate = new Set();
+        const queue = [fileUri];
+        while (queue.length > 0) {
+            const current = queue.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))
+                        queue.push(dep);
+        }
+        for (const uri of toInvalidate) {
+            this.cache.delete(uri);
+            this.dependents.delete(uri);
+        }
+    }
+    invalidateAll() {
+        this.cache.clear();
+        this.dependents.clear();
+    }
+}
+//# 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,120 @@
+export 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(),
+        };
+    }
+    addToken(node) {
+        this.data.tokens.set(node.cssVar, node);
+        this.data.allVars.add(node.cssVar);
+    }
+    addFile(node) {
+        this.data.files.set(node.uri, node);
+    }
+    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);
+    }
+    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);
+    }
+    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]);
+    }
+    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]));
+    }
+    resolveToken(cssVar) {
+        return this.data.tokens.get(cssVar) ?? null;
+    }
+    getDeclarations(cssVar) {
+        return this.data.declarations.get(cssVar) ?? [];
+    }
+    selectorContextFor(decl) {
+        return decl.selector;
+    }
+    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.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.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, []);
+        }
+    }
+}
+//# sourceMappingURL=TokenGraph.js.map

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

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

package/dist/esm/graph/index.js

@@ -0,0 +1,5 @@
+export { loadArtifact } from "./loadArtifact.js";
+export { parseArtifactToken } from "./parseArtifactToken.js";
+export { ReachabilityCache } from "./ReachabilityCache.js";
+export { TokenGraph } from "./TokenGraph.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/esm/graph/loadArtifact.js

@@ -0,0 +1,159 @@
+/**
+ * @see session/G.TOKEN_LSP.md §16.3 — Artifact format
+ */
+import * as path from "node:path";
+import { buildSelectorContext } from "../css/buildSelectorContext.js";
+import { parseArtifactToken } from "./parseArtifactToken.js";
+/**
+ * Extract the token entries from a RawArtifact, handling both
+ * the flat format (keys are CSS var names) and the wrapped
+ * format (`{ tokens: { ... } }`).
+ */
+function extractTokens(artifact) {
+    // Wrapped format: { version, generator, tokens: { ... } }
+    const a = artifact;
+    if ("tokens" in a &&
+        "version" in a &&
+        typeof a.tokens === "object" &&
+        a.tokens !== null) {
+        return a.tokens;
+    }
+    // Flat format — the artifact itself is the token map
+    return artifact;
+}
+/**
+ * Load all tokens from an artifact into a TokenGraph.
+ *
+ * @param artifactDir - Directory containing the artifact file.
+ *   Used to resolve relative `cssOutputFile` paths to absolute URIs.
+ */
+export function loadArtifact(artifact, graph, packageSource = "", artifactDir = "") {
+    const tokens = extractTokens(artifact);
+    for (const [cssVar, raw] of Object.entries(tokens)) {
+        const node = parseArtifactToken(cssVar, raw, packageSource, artifactDir);
+        graph.addToken(node);
+        // Inject artifact-embedded declarations into the graph so the
+        // tooltip's declaration sites section works without CSS scanning.
+        if (raw.declarations && raw.declarations.length > 0) {
+            injectArtifactDeclarations(cssVar, raw.declarations, graph, artifactDir);
+        }
+    }
+    buildAliasChains(graph);
+}
+// ---------------------------------------------------------------------------
+// Alias chain construction
+// ---------------------------------------------------------------------------
+const VAR_REF_RE = /^var\((--[\w-]+)\)$/;
+/**
+ * Post-pass: build alias chains by following `var()` references and
+ * falling back to value-matching for resolved literals.
+ *
+ * Terrazzo resolves alias values to literals in the build output, so
+ * many semantic tokens contain `oklch(...)` rather than `var(--x)`.
+ * For these, we match the resolved `valueLight` against primitive
+ * tokens to reconstruct the semantic → primitive link.
+ *
+ * After this pass, `token.aliasChain` contains an ordered list of CSS var
+ * names from the token down to the primitive value, and `token.isPrimary`
+ * is updated accordingly.
+ */
+function buildAliasChains(graph) {
+    // Build a reverse index: valueLight → primitive token cssVar.
+    // Used as a fallback when the semantic token's value is a resolved
+    // literal rather than a var() reference.
+    const primitiveByValue = new Map();
+    for (const t of graph.data.tokens.values()) {
+        if (t.provenance.kind !== "artifact")
+            continue;
+        if (t.tier === "primitive" && t.valueLight) {
+            // First primitive wins — multiple primitives may share a value
+            // but the first is a reasonable default.
+            if (!primitiveByValue.has(t.valueLight)) {
+                primitiveByValue.set(t.valueLight, t.cssVar);
+            }
+        }
+    }
+    for (const token of graph.data.tokens.values()) {
+        if (token.provenance.kind !== "artifact")
+            continue;
+        const chain = [];
+        const visited = new Set();
+        let current = token.valueLight;
+        while (current) {
+            const match = VAR_REF_RE.exec(current);
+            if (!match)
+                break;
+            const ref = match[1];
+            if (visited.has(ref))
+                break; // guard against cycles
+            visited.add(ref);
+            chain.push(ref);
+            const target = graph.data.tokens.get(ref);
+            if (!target)
+                break;
+            current = target.valueLight;
+        }
+        // Fallback: if no var() chain was found and this is a non-primitive
+        // token, try to match its resolved literal value to a primitive.
+        if (chain.length === 0 && token.tier !== "primitive" && token.valueLight) {
+            const primitiveVar = primitiveByValue.get(token.valueLight);
+            if (primitiveVar && primitiveVar !== token.cssVar) {
+                chain.push(primitiveVar);
+            }
+        }
+        if (chain.length > 0) {
+            token.aliasChain = chain;
+            token.isPrimary = false;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Artifact declaration injection
+// ---------------------------------------------------------------------------
+/**
+ * Convert artifact-embedded declarations into DeclarationNode objects
+ * and inject them into the graph's declaration stores.
+ *
+ * This allows the tooltip to display declaration sites (selectors like
+ * `:root`, `.warning`, `.constructive`) without requiring CSS file scanning.
+ */
+function injectArtifactDeclarations(cssVar, rawDecls, graph, artifactDir) {
+    for (const rawDecl of rawDecls) {
+        // Resolve the file path to an absolute file URI
+        const filePath = path.isAbsolute(rawDecl.file)
+            ? rawDecl.file
+            : artifactDir
+                ? path.resolve(artifactDir, rawDecl.file)
+                : rawDecl.file;
+        const fileUri = filePath.startsWith("file://")
+            ? filePath
+            : `file://${filePath}`;
+        const selectorContext = buildSelectorContext(rawDecl.selector, []);
+        const declNode = {
+            cssVar,
+            fileUri,
+            line: rawDecl.line,
+            column: 0,
+            rawValue: "",
+            cssType: "<unknown>",
+            selector: selectorContext,
+        };
+        // Add to cssVar → DeclarationNode[] map
+        const existing = graph.data.declarations.get(cssVar);
+        if (existing) {
+            existing.push(declNode);
+        }
+        else {
+            graph.data.declarations.set(cssVar, [declNode]);
+        }
+        // Add to per-file index
+        const byFile = graph.data.declarationsByFile.get(fileUri);
+        if (byFile) {
+            byFile.push(declNode);
+        }
+        else {
+            graph.data.declarationsByFile.set(fileUri, [declNode]);
+        }
+    }
+}
+//# sourceMappingURL=loadArtifact.js.map

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

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