@canonical/terrazzo-lsp-extension 0.4.0

package/dist/esm/providers/provideCodeActions.js

@@ -0,0 +1,154 @@
+/**
+ * Produce code actions for a set of diagnostics.
+ *
+ * Returns an array of quick-fix code actions for known diagnostic codes.
+ */
+export default function provideCodeActions(uri, source, diagnostics, graph) {
+    const actions = [];
+    const lines = source.split("\n");
+    for (const diag of diagnostics) {
+        switch (diag.code) {
+            case "css/missing-fallback":
+                addMissingFallbackFix(uri, lines, diag, graph, actions);
+                break;
+            case "css/stale-fallback":
+                addStaleFallbackFix(uri, lines, diag, graph, actions);
+                break;
+            case "css/primitive-token":
+                addPrimitiveTokenFix(uri, lines, diag, graph, actions);
+                break;
+        }
+    }
+    return actions;
+}
+// ---------------------------------------------------------------------------
+// css/missing-fallback → Insert fallback value
+// ---------------------------------------------------------------------------
+function addMissingFallbackFix(uri, lines, diag, graph, actions) {
+    const cssVar = extractCssVarFromRange(lines, diag);
+    if (!cssVar)
+        return;
+    const token = graph.resolveToken(cssVar);
+    const fallbackValue = token?.valueLight ?? token?.valueDark;
+    if (!fallbackValue)
+        return;
+    const line = lines[diag.range.start.line];
+    if (!line)
+        return;
+    // Find var(--name) and replace with var(--name, value)
+    const varPattern = new RegExp(`var\\(${escapeRegExp(cssVar)}\\)`);
+    const match = varPattern.exec(line);
+    if (!match)
+        return;
+    const col = match.index;
+    const edit = {
+        range: {
+            start: { line: diag.range.start.line, character: col },
+            end: { line: diag.range.start.line, character: col + match[0].length },
+        },
+        newText: `var(${cssVar}, ${fallbackValue})`,
+    };
+    actions.push({
+        title: `Add fallback: var(${cssVar}, ${truncate(fallbackValue, 20)})`,
+        kind: "quickfix",
+        edit: { changes: { [uri]: [edit] } },
+    });
+}
+// ---------------------------------------------------------------------------
+// css/stale-fallback → Update fallback to current value
+// ---------------------------------------------------------------------------
+function addStaleFallbackFix(uri, lines, diag, graph, actions) {
+    const cssVar = extractCssVarFromRange(lines, diag);
+    if (!cssVar)
+        return;
+    const token = graph.resolveToken(cssVar);
+    const currentValue = token?.valueLight ?? token?.valueDark;
+    if (!currentValue)
+        return;
+    const line = lines[diag.range.start.line];
+    if (!line)
+        return;
+    // Find var(--name, old-fallback) and replace fallback
+    const varPattern = new RegExp(`var\\(${escapeRegExp(cssVar)},\\s*([^)]+)\\)`);
+    const match = varPattern.exec(line);
+    if (!match)
+        return;
+    const col = match.index;
+    const edit = {
+        range: {
+            start: { line: diag.range.start.line, character: col },
+            end: { line: diag.range.start.line, character: col + match[0].length },
+        },
+        newText: `var(${cssVar}, ${currentValue})`,
+    };
+    actions.push({
+        title: `Update fallback to: ${truncate(currentValue, 25)}`,
+        kind: "quickfix",
+        edit: { changes: { [uri]: [edit] } },
+    });
+}
+// ---------------------------------------------------------------------------
+// css/primitive-token → Replace with semantic alias suggestion
+// ---------------------------------------------------------------------------
+function addPrimitiveTokenFix(uri, lines, diag, graph, actions) {
+    const cssVar = extractCssVarFromRange(lines, diag);
+    if (!cssVar)
+        return;
+    const token = graph.resolveToken(cssVar);
+    if (!token)
+        return;
+    // Look for a semantic token that aliases this primitive
+    const semanticAlias = findSemanticAlias(cssVar, graph);
+    if (!semanticAlias)
+        return;
+    const line = lines[diag.range.start.line];
+    if (!line)
+        return;
+    // Replace the var name inside var()
+    const col = line.indexOf(cssVar, diag.range.start.character);
+    if (col < 0)
+        return;
+    const edit = {
+        range: {
+            start: { line: diag.range.start.line, character: col },
+            end: { line: diag.range.start.line, character: col + cssVar.length },
+        },
+        newText: semanticAlias,
+    };
+    actions.push({
+        title: `Replace with semantic token: ${semanticAlias}`,
+        kind: "quickfix",
+        edit: { changes: { [uri]: [edit] } },
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractCssVarFromRange(lines, diag) {
+    const line = lines[diag.range.start.line];
+    if (!line)
+        return null;
+    // Look for --var-name near the diagnostic range
+    const segment = line.substring(diag.range.start.character, diag.range.end.character + 50);
+    const match = /--([\w-]+)/.exec(segment);
+    return match ? match[0] : null;
+}
+function findSemanticAlias(cssVar, graph) {
+    for (const token of graph.tokenValues()) {
+        if (token.tier !== "semantic")
+            continue;
+        if (token.aliasChain.includes(cssVar)) {
+            return token.cssVar;
+        }
+    }
+    return null;
+}
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return `${str.slice(0, maxLen - 1)}\u2026`;
+}
+//# sourceMappingURL=provideCodeActions.js.map

package/dist/esm/providers/provideCodeActions.js.map

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

package/dist/esm/providers/provideDocumentColors.js

@@ -0,0 +1,90 @@
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+/**
+ * Produce colour information for all `var(--x)` usages in a CSS file
+ * where `--x` resolves to a colour token with a known hex value.
+ */
+export function provideDocumentColors(source, graph) {
+    const results = [];
+    // Match var(--xxx) patterns across all lines
+    const lines = source.split("\n");
+    const varPattern = /var\(\s*(--[\w-]+)/g;
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        let match = varPattern.exec(line);
+        while (match) {
+            const cssVar = match[1];
+            const token = graph.resolveToken(cssVar);
+            if (token?.type === "color" && token.hexLight) {
+                const color = hexToColor(token.hexLight);
+                if (color) {
+                    // Range covers the CSS var name inside var()
+                    const varStart = match.index + match[0].indexOf(cssVar);
+                    results.push({
+                        range: {
+                            start: { line: lineIndex, character: varStart },
+                            end: {
+                                line: lineIndex,
+                                character: varStart + cssVar.length,
+                            },
+                        },
+                        color,
+                    });
+                }
+            }
+            match = varPattern.exec(line);
+        }
+        // Reset lastIndex for next line
+        varPattern.lastIndex = 0;
+    }
+    return results;
+}
+/**
+ * Return colour presentations for a given colour.
+ *
+ * When the user picks a colour from the colour picker, this returns
+ * the label to display. For design tokens, we return the original
+ * `var(--x)` — we don't want users replacing token references with
+ * raw colour values.
+ */
+export function provideColorPresentations(_color, cssVar) {
+    return [{ label: `var(${cssVar})` }];
+}
+// ---------------------------------------------------------------------------
+// Hex parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a hex colour string (#RGB, #RRGGBB, #RRGGBBAA) into an LSP
+ * Color (0-1 RGBA).
+ */
+export function hexToColor(hex) {
+    const h = hex.replace(/^#/, "");
+    let r;
+    let g;
+    let b;
+    let a = 1;
+    if (h.length === 3) {
+        r = Number.parseInt(h[0] + h[0], 16) / 255;
+        g = Number.parseInt(h[1] + h[1], 16) / 255;
+        b = Number.parseInt(h[2] + h[2], 16) / 255;
+    }
+    else if (h.length === 6) {
+        r = Number.parseInt(h.substring(0, 2), 16) / 255;
+        g = Number.parseInt(h.substring(2, 4), 16) / 255;
+        b = Number.parseInt(h.substring(4, 6), 16) / 255;
+    }
+    else if (h.length === 8) {
+        r = Number.parseInt(h.substring(0, 2), 16) / 255;
+        g = Number.parseInt(h.substring(2, 4), 16) / 255;
+        b = Number.parseInt(h.substring(4, 6), 16) / 255;
+        a = Number.parseInt(h.substring(6, 8), 16) / 255;
+    }
+    else {
+        return null;
+    }
+    if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b) || Number.isNaN(a))
+        return null;
+    return { red: r, green: g, blue: b, alpha: a };
+}
+//# sourceMappingURL=provideDocumentColors.js.map

package/dist/esm/providers/provideDocumentColors.js.map

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

package/dist/esm/providers/provideDocumentLinks.js

@@ -0,0 +1,55 @@
+import { extractCssImports } from "../css/index.js";
+/**
+ * Produce document links for `@import` statements.
+ *
+ * Each link covers the import path string and targets the resolved URI.
+ */
+export default function provideDocumentLinks(source, documentUri) {
+    const imports = extractCssImports(source);
+    if (imports.length === 0)
+        return [];
+    const baseDir = documentUri.substring(0, documentUri.lastIndexOf("/") + 1);
+    const links = [];
+    const lines = source.split("\n");
+    for (const importPath of imports) {
+        // Find the line and column of this import path in the source
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const col = line.indexOf(importPath);
+            if (col < 0)
+                continue;
+            // Verify this is in an @import context
+            if (!/@import\b/.test(line))
+                continue;
+            const target = resolveImportUri(baseDir, importPath);
+            links.push({
+                range: {
+                    start: { line: i, character: col },
+                    end: { line: i, character: col + importPath.length },
+                },
+                target,
+            });
+            break; // Only match first occurrence per import path
+        }
+    }
+    return links;
+}
+/**
+ * Resolve an import path relative to the document's directory.
+ */
+function resolveImportUri(baseDir, importPath) {
+    if (importPath.startsWith("file://") || importPath.startsWith("http")) {
+        return importPath;
+    }
+    // Resolve ../  segments by splitting into parts and collapsing
+    const parts = `${baseDir}${importPath}`.split("/");
+    const resolved = [];
+    for (const part of parts) {
+        if (part === "..")
+            resolved.pop();
+        else if (part !== ".")
+            resolved.push(part);
+    }
+    return resolved.join("/");
+}
+//# sourceMappingURL=provideDocumentLinks.js.map

package/dist/esm/providers/provideDocumentLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provideDocumentLinks.js","sourceRoot":"","sources":["../../../src/providers/provideDocumentLinks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AASpD;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,MAAc,EACd,WAAmB;IAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,6DAA6D;QAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,GAAG,GAAG,CAAC;gBAAE,SAAS;YAEtB,uCAAuC;YACvC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE;oBACL,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;oBAClC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE;iBACrD;gBACD,MAAM;aACP,CAAC,CAAC;YACH,MAAM,CAAC,8CAA8C;QACvD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAE,UAAkB;IAC3D,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACtE,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,+DAA+D;IAC/D,MAAM,KAAK,GAAG,GAAG,OAAO,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI;YAAE,QAAQ,CAAC,GAAG,EAAE,CAAC;aAC7B,IAAI,IAAI,KAAK,GAAG;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/esm/providers/provideHover.js

@@ -0,0 +1,20 @@
+import { HOVER_OPTIONS } from "./constants.js";
+import { buildTokenTooltip } from "./tokenTooltip/index.js";
+/**
+ * Produce a hover card for a CSS custom property.
+ *
+ * Delegates to `buildTokenTooltip` with full options derived from
+ * the resolved hover configuration.
+ */
+export default function provideHover(cssVar, fileUri, graph, config) {
+    const options = {
+        ...HOVER_OPTIONS,
+        showProvenanceBadge: config.hover.showProvenanceBadge,
+        showSelectorContext: config.hover.showSelectorContext,
+    };
+    const value = buildTokenTooltip(cssVar, fileUri, graph, config, options);
+    if (!value)
+        return null;
+    return { kind: "markdown", value };
+}
+//# sourceMappingURL=provideHover.js.map

package/dist/esm/providers/provideHover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provideHover.js","sourceRoot":"","sources":["../../../src/providers/provideHover.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,MAAc,EACd,OAAe,EACf,KAAiB,EACjB,MAAsB;IAEtB,MAAM,OAAO,GAAmB;QAC9B,GAAG,aAAa;QAChB,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB;QACrD,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB;KACtD,CAAC;IAEF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/esm/providers/provideInlayHints.js

@@ -0,0 +1,82 @@
+import * as scanners from "../css/scanners/index.js";
+/**
+ * Produce inlay hints for `var()` references in the visible range.
+ *
+ * Each hint shows the resolved value of the referenced token,
+ * positioned after the closing `)` of the `var()` call.
+ */
+export default function provideInlayHints(source, fileUri, graph, config, range) {
+    if (!config.inlayHints.enabled)
+        return [];
+    const usages = scanners.scanUsages(source, fileUri);
+    const hints = [];
+    const lines = source.split("\n");
+    for (const usage of usages) {
+        // Only hints in the visible range
+        if (usage.line < range.start.line || usage.line > range.end.line)
+            continue;
+        const token = graph.resolveToken(usage.cssVar);
+        if (!token)
+            continue;
+        const resolvedValue = resolveDisplayValue(token, graph);
+        if (!resolvedValue)
+            continue;
+        // Position the hint after var(--name) or var(--name, fallback)
+        const line = lines[usage.line];
+        if (!line)
+            continue;
+        const varStart = usage.column;
+        // Find the matching close paren
+        let depth = 0;
+        let endCol = varStart;
+        for (let i = varStart; i < line.length; i++) {
+            if (line[i] === "(")
+                depth++;
+            if (line[i] === ")") {
+                depth--;
+                if (depth === 0) {
+                    endCol = i + 1;
+                    break;
+                }
+            }
+        }
+        hints.push({
+            position: { line: usage.line, character: endCol },
+            label: truncateHint(resolvedValue, 30),
+            kind: 1, // InlayHintKind.Type
+            paddingLeft: true,
+        });
+    }
+    return hints;
+}
+/**
+ * Resolve a token to a display-friendly value string.
+ */
+function resolveDisplayValue(token, graph) {
+    // Walk alias chain to terminal
+    let terminal = token;
+    const visited = new Set();
+    for (const ref of token.aliasChain) {
+        if (visited.has(ref))
+            break;
+        visited.add(ref);
+        const target = graph.resolveToken(ref);
+        if (target)
+            terminal = target;
+        else
+            break;
+    }
+    if (terminal.isPaired &&
+        terminal.valueLight &&
+        terminal.valueDark &&
+        terminal.valueLight !== terminal.valueDark) {
+        return `light-dark(${terminal.valueLight}, ${terminal.valueDark})`;
+    }
+    return terminal.valueLight ?? null;
+}
+function truncateHint(value, maxLen) {
+    if (value.length <= maxLen)
+        return value;
+    return `${value.slice(0, maxLen - 1)}\u2026`;
+}
+//# sourceMappingURL=provideInlayHints.js.map

package/dist/esm/providers/provideInlayHints.js.map

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

package/dist/esm/providers/provideReferences.js

@@ -0,0 +1,39 @@
+/**
+ * Provide reference locations for a CSS custom property.
+ *
+ * Returns usage sites and declaration sites merged into a single
+ * location list, suitable for the LSP `textDocument/references` response.
+ */
+export default function provideReferences(cssVar, graph) {
+    const locations = [];
+    // Usage sites: var(--x)
+    const usages = graph.getUsages(cssVar);
+    for (const usage of usages) {
+        locations.push({
+            uri: usage.fileUri,
+            range: {
+                start: { line: usage.line, character: usage.column },
+                end: {
+                    line: usage.line,
+                    character: usage.column + "var(".length + usage.cssVar.length + ")".length,
+                },
+            },
+        });
+    }
+    // Declaration sites: --x: value
+    const declarations = graph.getDeclarations(cssVar);
+    for (const decl of declarations) {
+        locations.push({
+            uri: decl.fileUri,
+            range: {
+                start: { line: decl.line, character: decl.column },
+                end: {
+                    line: decl.line,
+                    character: decl.column + decl.cssVar.length,
+                },
+            },
+        });
+    }
+    return locations;
+}
+//# sourceMappingURL=provideReferences.js.map

package/dist/esm/providers/provideReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provideReferences.js","sourceRoot":"","sources":["../../../src/providers/provideReferences.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,MAAc,EACd,KAAiB;IAEjB,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,wBAAwB;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,KAAK,CAAC,OAAO;YAClB,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;gBACpD,GAAG,EAAE;oBACH,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,SAAS,EACP,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM;iBAClE;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;gBAClD,GAAG,EAAE;oBACH,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;iBAC5C;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/providers/provideRename.js

@@ -0,0 +1,63 @@
+/**
+ * Produce a workspace edit that renames a CSS custom property.
+ *
+ * Returns `null` if the variable is not known in the graph.
+ */
+export default function provideRename(cssVar, newName, graph) {
+    const token = graph.resolveToken(cssVar);
+    const decls = graph.getDeclarations(cssVar);
+    const prop = graph.getProperty(cssVar);
+    const usages = graph.getUsages(cssVar);
+    // Must exist somewhere in the graph
+    if (!token && decls.length === 0 && !prop && usages.length === 0) {
+        return null;
+    }
+    const changes = {};
+    const requiresRebuild = token?.provenance.kind === "artifact";
+    // Collect edits per file
+    // 1. Declaration sites
+    for (const decl of decls) {
+        addEdit(changes, decl.fileUri, {
+            range: {
+                start: { line: decl.line, character: decl.column },
+                end: { line: decl.line, character: decl.column + cssVar.length },
+            },
+            newText: newName,
+        });
+    }
+    // 2. @property registration
+    if (prop) {
+        addEdit(changes, prop.fileUri, {
+            range: {
+                start: { line: prop.line, character: 0 },
+                end: { line: prop.line, character: cssVar.length },
+            },
+            newText: newName,
+        });
+    }
+    // 3. Usage sites (var(--x) references)
+    for (const usage of usages) {
+        addEdit(changes, usage.fileUri, {
+            range: {
+                start: { line: usage.line, character: usage.column },
+                end: { line: usage.line, character: usage.column + cssVar.length },
+            },
+            newText: newName,
+        });
+    }
+    return {
+        edit: { changes },
+        requiresRebuild,
+    };
+}
+/** Append a text edit to the changes map for a given file URI. */
+function addEdit(changes, uri, edit) {
+    const existing = changes[uri];
+    if (existing) {
+        existing.push(edit);
+    }
+    else {
+        changes[uri] = [edit];
+    }
+}
+//# sourceMappingURL=provideRename.js.map

package/dist/esm/providers/provideRename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provideRename.js","sourceRoot":"","sources":["../../../src/providers/provideRename.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,MAAc,EACd,OAAe,EACf,KAAiB;IAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEvC,oCAAoC;IACpC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAA+B,EAAE,CAAC;IAC/C,MAAM,eAAe,GAAG,KAAK,EAAE,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC;IAE9D,yBAAyB;IAEzB,uBAAuB;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YAC7B,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;gBAClD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE;aACjE;YACD,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YAC7B,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;gBACxC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;aACnD;YACD,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;YAC9B,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;gBACpD,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE;aACnE;YACD,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,EAAE,OAAO,EAAE;QACjB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,SAAS,OAAO,CACd,OAAmC,EACnC,GAAW,EACX,IAAc;IAEd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/esm/providers/provideSemanticTokens.js

@@ -0,0 +1,74 @@
+import * as scanners from "../css/scanners/index.js";
+import { SEMANTIC_TOKEN_MODIFIERS } from "./types.js";
+/** Modifier index lookup. */
+const MOD_ARTIFACT = SEMANTIC_TOKEN_MODIFIERS.indexOf("artifact");
+const MOD_REGISTERED = SEMANTIC_TOKEN_MODIFIERS.indexOf("registered");
+const MOD_LOCAL = SEMANTIC_TOKEN_MODIFIERS.indexOf("local");
+const MOD_EXTERNAL = SEMANTIC_TOKEN_MODIFIERS.indexOf("external");
+const MOD_SCOPED = SEMANTIC_TOKEN_MODIFIERS.indexOf("scoped");
+/**
+ * Produce delta-encoded semantic token data for a CSS file.
+ *
+ * Returns an array of integers in groups of 5:
+ *   [deltaLine, deltaStartChar, length, tokenType, tokenModifiers]
+ *
+ * tokenType is always 0 (designToken).
+ * tokenModifiers is a bitmask of SEMANTIC_TOKEN_MODIFIERS indices.
+ */
+function provideSemanticTokens(fileUri, source, graph) {
+    const usages = scanners.scanUsages(source, fileUri);
+    if (usages.length === 0)
+        return [];
+    // Sort by line then column for delta encoding
+    usages.sort((a, b) => a.line - b.line || a.column - b.column);
+    const data = [];
+    let prevLine = 0;
+    let prevChar = 0;
+    for (const usage of usages) {
+        const modifiers = computeModifiers(usage.cssVar, fileUri, graph);
+        // var(--name) — the token covers the `--name` part
+        const length = usage.cssVar.length;
+        const deltaLine = usage.line - prevLine;
+        const deltaChar = deltaLine === 0 ? usage.column - prevChar : usage.column;
+        data.push(deltaLine, deltaChar, length, 0, modifiers);
+        prevLine = usage.line;
+        prevChar = usage.column;
+    }
+    return data;
+}
+/** Compute the modifier bitmask for a CSS variable usage. */
+function computeModifiers(cssVar, fileUri, graph) {
+    let bits = 0;
+    const token = graph.resolveToken(cssVar);
+    if (token) {
+        if (token.provenance.kind === "artifact") {
+            bits |= 1 << MOD_ARTIFACT;
+        }
+        if (token.provenance.kind === "external") {
+            bits |= 1 << MOD_EXTERNAL;
+        }
+        if (token.registered) {
+            bits |= 1 << MOD_REGISTERED;
+        }
+    }
+    // Check declarations for local/scoped classification
+    const decls = graph.getDeclarations(cssVar);
+    if (decls.length > 0) {
+        const allScoped = decls.every((d) => d.selector.isScoped);
+        if (allScoped) {
+            bits |= 1 << MOD_SCOPED;
+        }
+        // Local if any declaration is in the same file
+        const hasLocal = decls.some((d) => d.fileUri === fileUri);
+        if (hasLocal && !token) {
+            bits |= 1 << MOD_LOCAL;
+        }
+    }
+    else if (!token) {
+        // Not in tokens and not in declarations — local/unknown
+        bits |= 1 << MOD_LOCAL;
+    }
+    return bits;
+}
+export default provideSemanticTokens;
+//# sourceMappingURL=provideSemanticTokens.js.map

package/dist/esm/providers/provideSemanticTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provideSemanticTokens.js","sourceRoot":"","sources":["../../../src/providers/provideSemanticTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,6BAA6B;AAC7B,MAAM,YAAY,GAAG,wBAAwB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAClE,MAAM,cAAc,GAAG,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AACtE,MAAM,SAAS,GAAG,wBAAwB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC5D,MAAM,YAAY,GAAG,wBAAwB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAClE,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE9D;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAC5B,OAAe,EACf,MAAc,EACd,KAAiB;IAEjB,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,8CAA8C;IAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAE9D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACjE,mDAAmD;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QAEnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;QACxC,MAAM,SAAS,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAE3E,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEtD,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QACtB,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,SAAS,gBAAgB,CACvB,MAAc,EACd,OAAe,EACf,KAAiB;IAEjB,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,YAAY,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,YAAY,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,IAAI,cAAc,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,IAAI,CAAC,IAAI,UAAU,CAAC;QAC1B,CAAC;QACD,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QAC1D,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;SAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,wDAAwD;QACxD,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,eAAe,qBAAqB,CAAC"}