@canonical/terrazzo-lsp-extension 0.4.0

package/dist/esm/providers/artifactDiagnostics/checkBrokenAlias.js

@@ -0,0 +1,15 @@
+import makeDiagnostic from "../makeDiagnostic.js";
+export default function checkBrokenAlias(token, tokenById, config, results) {
+    const severity = config.diagnostics.get("dtcg/broken-alias");
+    if (!severity)
+        return;
+    if (token.aliasChain.length === 0)
+        return;
+    for (const aliasId of token.aliasChain) {
+        if (!tokenById.has(aliasId)) {
+            results.push(makeDiagnostic(token.sourceLine ?? 0, 0, severity, "dtcg/broken-alias", `Token \`${token.id || token.cssVar}\` (\`${token.cssVar}\`) aliases \`${aliasId}\` which does not exist. [DTCG 2025.10 \u2014 \u00A76.3: aliases]`));
+            break; // Report once per token
+        }
+    }
+}
+//# sourceMappingURL=checkBrokenAlias.js.map

package/dist/esm/providers/artifactDiagnostics/checkBrokenAlias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkBrokenAlias.js","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkBrokenAlias.ts"],"names":[],"mappings":"AAMA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAgB,EAChB,SAAiC,EACjC,MAAsB,EACtB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE1C,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,KAAK,CAAC,UAAU,IAAI,CAAC,EACrB,CAAC,EACD,QAAQ,EACR,mBAAmB,EACnB,WAAW,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,iBAAiB,OAAO,mEAAmE,CACpJ,CACF,CAAC;YACF,MAAM,CAAC,wBAAwB;QACjC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/providers/artifactDiagnostics/checkCircularAlias.js

@@ -0,0 +1,22 @@
+import makeDiagnostic from "../makeDiagnostic.js";
+export default function checkCircularAlias(token, config, results) {
+    const severity = config.diagnostics.get("dtcg/circular-alias");
+    if (!severity)
+        return;
+    if (token.aliasChain.length === 0)
+        return;
+    // A cycle exists if any ID appears more than once in the chain,
+    // or if the token's own ID appears in its alias chain
+    const seen = new Set();
+    if (token.id)
+        seen.add(token.id);
+    for (const aliasId of token.aliasChain) {
+        if (seen.has(aliasId)) {
+            const cyclePath = [...token.aliasChain].join(" \u2192 ");
+            results.push(makeDiagnostic(token.sourceLine ?? 0, 0, severity, "dtcg/circular-alias", `Circular alias chain detected for \`${token.id || token.cssVar}\`: ${cyclePath}. [DTCG 2025.10 \u2014 \u00A76.3: aliases must not form cycles]`));
+            break;
+        }
+        seen.add(aliasId);
+    }
+}
+//# sourceMappingURL=checkCircularAlias.js.map

package/dist/esm/providers/artifactDiagnostics/checkCircularAlias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkCircularAlias.js","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkCircularAlias.ts"],"names":[],"mappings":"AAMA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,KAAgB,EAChB,MAAsB,EACtB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE1C,gEAAgE;IAChE,sDAAsD;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,KAAK,CAAC,UAAU,IAAI,CAAC,EACrB,CAAC,EACD,QAAQ,EACR,qBAAqB,EACrB,uCAAuC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,OAAO,SAAS,iEAAiE,CACjJ,CACF,CAAC;YACF,MAAM;QACR,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/esm/providers/artifactDiagnostics/checkDraftSyntax.js

@@ -0,0 +1,15 @@
+import makeDiagnostic from "../makeDiagnostic.js";
+export default function checkDraftSyntax(token, config, results) {
+    const severity = config.diagnostics.get("dtcg/draft-syntax");
+    if (!severity)
+        return;
+    const hasDraftMarker = token.extensions?.["com.terrazzo.draft-syntax"] === true;
+    const hasEmptyId = token.id === "";
+    if (!hasDraftMarker && !hasEmptyId)
+        return;
+    const reason = hasDraftMarker
+        ? "uses pre-standardisation draft field syntax (`value`/`type` without `$` prefix)"
+        : "has an empty token ID, suggesting pre-standardisation source format";
+    results.push(makeDiagnostic(token.sourceLine ?? 0, 0, severity, "dtcg/draft-syntax", `Token \`${token.cssVar}\` ${reason}. Migrate to DTCG 2025.10 standard syntax. [DTCG 2025.10 \u2014 \u00A73: standard field names]`));
+}
+//# sourceMappingURL=checkDraftSyntax.js.map

package/dist/esm/providers/artifactDiagnostics/checkDraftSyntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkDraftSyntax.js","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkDraftSyntax.ts"],"names":[],"mappings":"AAMA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAgB,EAChB,MAAsB,EACtB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,MAAM,cAAc,GAClB,KAAK,CAAC,UAAU,EAAE,CAAC,2BAA2B,CAAC,KAAK,IAAI,CAAC;IAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAEnC,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU;QAAE,OAAO;IAE3C,MAAM,MAAM,GAAG,cAAc;QAC3B,CAAC,CAAC,iFAAiF;QACnF,CAAC,CAAC,qEAAqE,CAAC;IAE1E,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,KAAK,CAAC,UAAU,IAAI,CAAC,EACrB,CAAC,EACD,QAAQ,EACR,mBAAmB,EACnB,WAAW,KAAK,CAAC,MAAM,MAAM,MAAM,gGAAgG,CACpI,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/providers/artifactDiagnostics/checkMissingType.js

@@ -0,0 +1,10 @@
+import makeDiagnostic from "../makeDiagnostic.js";
+export default function checkMissingType(token, config, results) {
+    const severity = config.diagnostics.get("dtcg/missing-type");
+    if (!severity)
+        return;
+    if (token.type !== null)
+        return;
+    results.push(makeDiagnostic(token.sourceLine ?? 0, 0, severity, "dtcg/missing-type", `Token \`${token.id || token.cssVar}\` (\`${token.cssVar}\`) has no explicit \`$type\`. The type is ambiguous and should be specified. [DTCG 2025.10 \u2014 \u00A75: type is required when ambiguous]`));
+}
+//# sourceMappingURL=checkMissingType.js.map

package/dist/esm/providers/artifactDiagnostics/checkMissingType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkMissingType.js","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkMissingType.ts"],"names":[],"mappings":"AAMA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAgB,EAChB,MAAsB,EACtB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO;IAChC,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,KAAK,CAAC,UAAU,IAAI,CAAC,EACrB,CAAC,EACD,QAAQ,EACR,mBAAmB,EACnB,WAAW,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,8IAA8I,CACvM,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/providers/artifactDiagnostics/checkSchemaViolation.js

@@ -0,0 +1,15 @@
+import makeDiagnostic from "../makeDiagnostic.js";
+export default function checkSchemaViolation(token, config, results) {
+    const severity = config.diagnostics.get("dtcg/schema-violation");
+    if (!severity)
+        return;
+    if (token.type === "color" && token.valueLight && !token.hexLight) {
+        // Color type but value couldn't be parsed as a colour
+        results.push(makeDiagnostic(token.sourceLine ?? 0, 0, severity, "dtcg/schema-violation", `Token \`${token.id || token.cssVar}\` (\`${token.cssVar}\`) has \`$type: color\` but its value \`${token.valueLight}\` is not a valid CSS colour. [DTCG 2025.10 \u2014 \u00A74]`));
+    }
+    if (token.type === "dimension" && token.cssType === "<unknown>") {
+        // Dimension type but value couldn't be resolved to a CSS length/percentage
+        results.push(makeDiagnostic(token.sourceLine ?? 0, 0, severity, "dtcg/schema-violation", `Token \`${token.id || token.cssVar}\` (\`${token.cssVar}\`) has \`$type: dimension\` but its value \`${token.valueLight ?? ""}\` is not a valid dimension. [DTCG 2025.10 \u2014 \u00A74]`));
+    }
+}
+//# sourceMappingURL=checkSchemaViolation.js.map

package/dist/esm/providers/artifactDiagnostics/checkSchemaViolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkSchemaViolation.js","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkSchemaViolation.ts"],"names":[],"mappings":"AAMA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,KAAgB,EAChB,MAAsB,EACtB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACjE,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClE,sDAAsD;QACtD,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,KAAK,CAAC,UAAU,IAAI,CAAC,EACrB,CAAC,EACD,QAAQ,EACR,uBAAuB,EACvB,WAAW,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,4CAA4C,KAAK,CAAC,UAAU,6DAA6D,CAClL,CACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAChE,2EAA2E;QAC3E,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,KAAK,CAAC,UAAU,IAAI,CAAC,EACrB,CAAC,EACD,QAAQ,EACR,uBAAuB,EACvB,WAAW,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,gDAAgD,KAAK,CAAC,UAAU,IAAI,EAAE,4DAA4D,CAC3L,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/providers/artifactDiagnostics/index.js

@@ -0,0 +1,28 @@
+import checkBrokenAlias from "./checkBrokenAlias.js";
+import checkCircularAlias from "./checkCircularAlias.js";
+import checkDraftSyntax from "./checkDraftSyntax.js";
+import checkMissingType from "./checkMissingType.js";
+import checkSchemaViolation from "./checkSchemaViolation.js";
+/** Produce diagnostics for all artifact tokens in the graph. */
+const produceArtifactDiagnostics = (graph, config) => {
+    const results = [];
+    // Build id→token index for alias validation
+    const tokenById = new Map();
+    for (const token of graph.tokenValues()) {
+        if (token.provenance.kind === "artifact" && token.id) {
+            tokenById.set(token.id, token);
+        }
+    }
+    for (const token of graph.tokenValues()) {
+        if (token.provenance.kind !== "artifact")
+            continue;
+        checkMissingType(token, config, results);
+        checkDraftSyntax(token, config, results);
+        checkBrokenAlias(token, tokenById, config, results);
+        checkCircularAlias(token, config, results);
+        checkSchemaViolation(token, config, results);
+    }
+    return results;
+};
+export default produceArtifactDiagnostics;
+//# sourceMappingURL=index.js.map

package/dist/esm/providers/artifactDiagnostics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/index.ts"],"names":[],"mappings":"AAaA,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AACzD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,oBAAoB,MAAM,2BAA2B,CAAC;AAE7D,gEAAgE;AAChE,MAAM,0BAA0B,GAAG,CACjC,KAAiB,EACjB,MAAsB,EACR,EAAE;IAChB,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACrD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACnD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/esm/providers/classifyProvenance.js

@@ -0,0 +1,19 @@
+/** Classify the provenance of a CSS custom property. */
+export default function classifyProvenance(cssVar, graph, fileUri) {
+    const token = graph.resolveToken(cssVar);
+    if (token?.provenance.kind === "artifact")
+        return token.provenance;
+    const prop = graph.getProperty(cssVar);
+    if (prop)
+        return { kind: "property", fileUri: prop.fileUri };
+    const decls = graph.getDeclarations(cssVar);
+    const decl = decls?.[0];
+    if (decl) {
+        const file = graph.getFile(decl.fileUri);
+        if (file?.isExternal)
+            return { kind: "external", packageName: file.packageName ?? "unknown" };
+        return { kind: "local", fileUri: decl.fileUri };
+    }
+    return { kind: "local", fileUri };
+}
+//# sourceMappingURL=classifyProvenance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classifyProvenance.js","sourceRoot":"","sources":["../../../src/providers/classifyProvenance.ts"],"names":[],"mappings":"AAWA,wDAAwD;AACxD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,MAAc,EACd,KAAiB,EACjB,OAAe;IAEf,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,UAAU,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,IAAI,EAAE,UAAU;YAClB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC;QAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/esm/providers/completions/buildCompletionItem.js

@@ -0,0 +1,132 @@
+import { CompletionItemKind, InsertTextFormat, } from "../../types/index.js";
+import { COMPLETION_BADGE, COMPLETION_DERIVATION_LABEL, COMPLETION_OPTIONS, COMPLETION_SORT_PREFIX, TIER_BADGE, TIER_LABEL, } from "../constants.js";
+import { buildTokenTooltip } from "../tokenTooltip/index.js";
+import truncate from "../truncate.js";
+import { buildSortText, contextMatchScore } from "./buildSortText.js";
+/** Build a single completion item for a CSS variable in the graph. */
+export default function buildCompletionItem(cssVar, fileUri, graph, config, expectedType) {
+    const token = graph.resolveToken(cssVar);
+    const prop = graph.getProperty(cssVar);
+    const decls = graph.getDeclarations(cssVar);
+    const options = {
+        ...COMPLETION_OPTIONS,
+        showProvenanceBadge: false,
+        showSelectorContext: config.hover.showSelectorContext,
+    };
+    const docValue = buildTokenTooltip(cssVar, fileUri, graph, config, options);
+    const documentation = docValue
+        ? { kind: "markdown", value: docValue }
+        : undefined;
+    if (token?.provenance.kind === "artifact") {
+        const contextPrefix = contextMatchScore(token.cssType, expectedType);
+        return {
+            label: cssVar,
+            detail: buildArtifactDetail(token, graph),
+            kind: token.type === "color"
+                ? CompletionItemKind.Color
+                : CompletionItemKind.Variable,
+            sortText: buildSortText(contextPrefix, COMPLETION_SORT_PREFIX.artifact, cssVar, token),
+            filterText: cssVar,
+            insertText: `${cssVar})$0`,
+            insertTextFormat: InsertTextFormat.Snippet,
+            documentation,
+        };
+    }
+    if (prop) {
+        const cssType = prop.cssType ?? "<unknown>";
+        const contextPrefix = contextMatchScore(cssType, expectedType);
+        return {
+            label: cssVar,
+            detail: `${COMPLETION_BADGE.property} ${prop.syntax} \u00B7 initial: ${prop.initialValue ?? "none"}`,
+            kind: CompletionItemKind.Property,
+            sortText: `${contextPrefix}_${COMPLETION_SORT_PREFIX.property}_0_zzz_${cssVar.replace(/^--/, "")}`,
+            filterText: cssVar,
+            insertText: `${cssVar})$0`,
+            insertTextFormat: InsertTextFormat.Snippet,
+            documentation,
+        };
+    }
+    const decl = decls?.[0];
+    if (decl) {
+        const file = graph.getFile(decl.fileUri);
+        const isExternal = file?.isExternal ?? false;
+        const badge = isExternal
+            ? COMPLETION_BADGE.external
+            : COMPLETION_BADGE.local;
+        const prefix = isExternal
+            ? COMPLETION_SORT_PREFIX.external
+            : COMPLETION_SORT_PREFIX.local;
+        const fileName = decl.fileUri.split("/").pop() ?? decl.fileUri;
+        const selectorStr = decl.selector.selector;
+        const contextPrefix = contextMatchScore(decl.cssType, expectedType);
+        return {
+            label: cssVar,
+            detail: `${badge} ${decl.rawValue}  \u00B7  ${selectorStr}  \u00B7  ${fileName}:${decl.line + 1}`,
+            kind: CompletionItemKind.Variable,
+            sortText: `${contextPrefix}_${prefix}_0_zzz_${cssVar.replace(/^--/, "")}`,
+            filterText: cssVar,
+            insertText: `${cssVar})$0`,
+            insertTextFormat: InsertTextFormat.Snippet,
+            documentation,
+        };
+    }
+    return {
+        label: cssVar,
+        detail: `${COMPLETION_BADGE.buffer} (buffer)`,
+        kind: CompletionItemKind.Variable,
+        sortText: `1_${COMPLETION_SORT_PREFIX.buffer}_0_zzz_${cssVar.replace(/^--/, "")}`,
+        filterText: cssVar,
+        insertText: `${cssVar})$0`,
+        insertTextFormat: InsertTextFormat.Snippet,
+    };
+}
+// ---------------------------------------------------------------------------
+// Detail line (shown inline in the completion list)
+// ---------------------------------------------------------------------------
+function buildArtifactDetail(token, graph) {
+    const badge = token.tier
+        ? (TIER_BADGE[token.tier] ?? COMPLETION_BADGE.artifact)
+        : COMPLETION_BADGE.artifact;
+    const parts = [badge];
+    if (token.tier) {
+        parts.push(TIER_LABEL[token.tier] ?? token.tier);
+    }
+    if (token.type)
+        parts.push(token.type);
+    const resolved = resolveTerminalLiteral(token, graph);
+    if (resolved) {
+        parts.push(`\u00B7 ${truncate(resolved, 40)}`);
+    }
+    if (token.derivation) {
+        const kindLabel = COMPLETION_DERIVATION_LABEL[token.derivation];
+        if (kindLabel)
+            parts.push(`\u00B7 ${kindLabel}`);
+    }
+    return parts.join(" ");
+}
+/**
+ * Walk the alias chain to the terminal token and format its value.
+ * Returns `light-dark(L, D)` for paired, plain value otherwise.
+ */
+function resolveTerminalLiteral(token, graph) {
+    let terminal = token;
+    const visited = new Set([token.cssVar]);
+    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;
+}
+//# sourceMappingURL=buildCompletionItem.js.map

package/dist/esm/providers/completions/buildCompletionItem.js.map

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

package/dist/esm/providers/completions/buildSortText.js

@@ -0,0 +1,39 @@
+import * as values from "../../css/values/index.js";
+/**
+ * Score how well a token's CSS type matches the expected property type.
+ *
+ * - `"0"` — type is assignable to the expected type (best match)
+ * - `"1"` — no expected type, or type is unknown (neutral)
+ * - `"2"` — type is NOT assignable (worst match)
+ */
+export function contextMatchScore(cssType, expectedType) {
+    if (!expectedType)
+        return "1";
+    if (cssType === "<unknown>")
+        return "1";
+    if (values.isAssignable(cssType, expectedType))
+        return "0";
+    return "2";
+}
+/**
+ * Tier sort groups. Known tiers get explicit priority;
+ * unrecognised tiers default to `"1"` (middle priority).
+ */
+const TIER_SORT_GROUP = {
+    semantic: "0",
+    derived: "1",
+    primitive: "2",
+};
+const TIER_SORT_DEFAULT = "1";
+/**
+ * Build a sort string that groups by context match, provenance, tier,
+ * type, then alphabetically.
+ */
+export function buildSortText(contextPrefix, provenancePrefix, cssVar, token) {
+    const tierGroup = token.tier
+        ? (TIER_SORT_GROUP[token.tier] ?? TIER_SORT_DEFAULT)
+        : TIER_SORT_DEFAULT;
+    const typeGroup = token.type ?? "zzz";
+    return `${contextPrefix}_${provenancePrefix}_${tierGroup}_${typeGroup}_${cssVar.replace(/^--/, "")}`;
+}
+//# sourceMappingURL=buildSortText.js.map

package/dist/esm/providers/completions/buildSortText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSortText.js","sourceRoot":"","sources":["../../../../src/providers/completions/buildSortText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAGpD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAqB,EACrB,YAAiC;IAEjC,IAAI,CAAC,YAAY;QAAE,OAAO,GAAG,CAAC;IAC9B,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,eAAe,GAAqC;IACxD,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,GAAG;CACf,CAAC;AACF,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,aAAqB,EACrB,gBAAwB,EACxB,MAAc,EACd,KAAgB;IAEhB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;QAC1B,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC;QACpD,CAAC,CAAC,iBAAiB,CAAC;IACtB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;IACtC,OAAO,GAAG,aAAa,IAAI,gBAAgB,IAAI,SAAS,IAAI,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;AACvG,CAAC"}

package/dist/esm/providers/completions/index.js

@@ -0,0 +1,6 @@
+export { default as buildCompletionItem } from "./buildCompletionItem.js";
+export { buildSortText, contextMatchScore } from "./buildSortText.js";
+export { default as provideCompletions } from "./provideCompletions.js";
+export { default as resolveCompletionItem } from "./resolveCompletionItem.js";
+export { default as resolveExpectedType } from "./resolveExpectedType.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/providers/completions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/completions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/providers/completions/provideCompletions.js

@@ -0,0 +1,64 @@
+import buildCompletionItem from "./buildCompletionItem.js";
+import resolveExpectedType from "./resolveExpectedType.js";
+/**
+ * Produce completion items for a `var(--)` context in a CSS file.
+ *
+ * Completions are scoped to the file's import graph: only variables
+ * reachable from the open document (via import traversal or global
+ * stylesheets) are offered. Artifact tokens are always included.
+ *
+ * When `source` and `position` are provided, the completion list is
+ * sorted so that tokens whose type matches the enclosing CSS property
+ * appear first.
+ */
+export default function provideCompletions(fileUri, graph, cache, config, source, position) {
+    const results = [];
+    const globalStylesheets = resolveGlobalStylesheetSet(graph, config);
+    const reachableVars = cache.getReachableVars(fileUri, graph, globalStylesheets);
+    const scopedVars = new Set(reachableVars);
+    for (const [cssVar, token] of graph.tokenEntries()) {
+        if (token.provenance.kind === "artifact") {
+            scopedVars.add(cssVar);
+        }
+    }
+    const expectedType = resolveExpectedType(source, position);
+    for (const cssVar of scopedVars) {
+        const item = buildCompletionItem(cssVar, fileUri, graph, config, expectedType);
+        if (item)
+            results.push(item);
+    }
+    // Post-process: strip the closing paren from insertText when the
+    // source already contains one immediately after the cursor position.
+    if (!shouldAppendVarClosingParen(source, position)) {
+        for (const item of results) {
+            if (item.insertText?.endsWith(")$0")) {
+                item.insertText = `${item.insertText.slice(0, -3)}$0`;
+            }
+        }
+    }
+    return results;
+}
+function shouldAppendVarClosingParen(source, position) {
+    if (!source || !position)
+        return true;
+    const lines = source.split("\n");
+    const line = lines[position.line];
+    if (!line)
+        return true;
+    const suffix = line.slice(position.character);
+    const nextSignificantChar = suffix.match(/\S/u)?.[0];
+    return nextSignificantChar !== ")" && nextSignificantChar !== ",";
+}
+function resolveGlobalStylesheetSet(graph, config) {
+    if (config.globalStylesheets === null) {
+        const files = new Set();
+        for (const token of graph.tokenValues())
+            if (token.cssOutputFile)
+                files.add(`file://${token.cssOutputFile}`);
+        return files.size > 0 ? files : undefined;
+    }
+    if (config.globalStylesheets.length === 0)
+        return undefined;
+    return new Set(config.globalStylesheets);
+}
+//# sourceMappingURL=provideCompletions.js.map

package/dist/esm/providers/completions/provideCompletions.js.map

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

package/dist/esm/providers/completions/resolveCompletionItem.js

@@ -0,0 +1,26 @@
+import { COMPLETION_OPTIONS } from "../constants.js";
+import { buildTokenTooltip } from "../tokenTooltip/index.js";
+/**
+ * Resolve a completion item by adding full documentation.
+ *
+ * The `label` field of the item is the CSS variable name (e.g. `--color-bg`).
+ */
+export default function resolveCompletionItem(item, fileUri, graph, config) {
+    if (item.documentation)
+        return item; // Already resolved
+    const cssVar = item.label;
+    const options = {
+        ...COMPLETION_OPTIONS,
+        showProvenanceBadge: false,
+        showSelectorContext: config.hover.showSelectorContext,
+    };
+    const docValue = buildTokenTooltip(cssVar, fileUri, graph, config, options);
+    if (docValue) {
+        return {
+            ...item,
+            documentation: { kind: "markdown", value: docValue },
+        };
+    }
+    return item;
+}
+//# sourceMappingURL=resolveCompletionItem.js.map

package/dist/esm/providers/completions/resolveCompletionItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveCompletionItem.js","sourceRoot":"","sources":["../../../../src/providers/completions/resolveCompletionItem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,IAAoB,EACpB,OAAe,EACf,KAAiB,EACjB,MAAsB;IAEtB,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAExD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,MAAM,OAAO,GAAmB;QAC9B,GAAG,kBAAkB;QACrB,mBAAmB,EAAE,KAAK;QAC1B,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB;KACtD,CAAC;IACF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,GAAG,IAAI;YACP,aAAa,EAAE,EAAE,IAAI,EAAE,UAAmB,EAAE,KAAK,EAAE,QAAQ,EAAE;SAC9D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/providers/completions/resolveExpectedType.js

@@ -0,0 +1,17 @@
+import * as scanners from "../../css/scanners/index.js";
+import * as values from "../../css/values/index.js";
+/**
+ * Determine the expected CSS value type from the document context.
+ *
+ * Returns `null` when there is no position, no source, or the cursor
+ * is not inside a known property-value context.
+ */
+export default function resolveExpectedType(source, position) {
+    if (!source || !position)
+        return null;
+    const property = scanners.extractPropertyAtPosition(source, position);
+    if (!property)
+        return null;
+    return values.expectedTypeForProperty(property);
+}
+//# sourceMappingURL=resolveExpectedType.js.map

package/dist/esm/providers/completions/resolveExpectedType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveExpectedType.js","sourceRoot":"","sources":["../../../../src/providers/completions/resolveExpectedType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,MAA0B,EAC1B,QAA8B;IAE9B,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,MAAM,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC"}

package/dist/esm/providers/constants.js

@@ -0,0 +1,53 @@
+export const COMPLETION_BADGE = {
+    artifact: "\u25CF",
+    property: "\u00AE",
+    local: "\u25C8",
+    external: "\u2A21",
+    buffer: "\u25CC",
+};
+export const COMPLETION_DERIVATION_LABEL = {
+    hover: "hover",
+    active: "active",
+    disabled: "disabled",
+    delta: "delta",
+};
+export const COMPLETION_SORT_PREFIX = {
+    artifact: "0",
+    property: "1",
+    local: "2",
+    external: "2",
+    buffer: "3",
+};
+/**
+ * Tier → badge icon map. Unknown tiers fall back to {@link TIER_BADGE_DEFAULT}.
+ *
+ * Common tiers: `"primitive"` (◇), `"semantic"` (●), `"derived"` (▲).
+ */
+export const TIER_BADGE = {
+    primitive: "\u25C7",
+    semantic: "\u25CF",
+    derived: "\u25B2",
+};
+/** Fallback badge for unrecognised tier values. */
+export const TIER_BADGE_DEFAULT = "\u25CB";
+/**
+ * Tier → display label map. Unknown tiers are title-cased automatically.
+ */
+export const TIER_LABEL = {
+    primitive: "Primitive",
+    semantic: "Semantic",
+    derived: "Derived",
+};
+export const HOVER_OPTIONS = {
+    showProvenanceBadge: true,
+    showDescription: true,
+    showMetadataFooter: true,
+    showSelectorContext: true,
+};
+export const COMPLETION_OPTIONS = {
+    showProvenanceBadge: true,
+    showDescription: true,
+    showMetadataFooter: true,
+    showSelectorContext: true,
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/providers/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;IAClB,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,2BAA2B,GAAqC;IAC3E,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,GAAG;CACH,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,QAAQ;CACT,CAAC;AAEX,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,IAAI;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,IAAI;CAC1B,CAAC"}

package/dist/esm/providers/diagnostics/checkMissingFallback.js

@@ -0,0 +1,20 @@
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/missing-fallback — var() without a fallback on an unregistered property. */
+export default function checkMissingFallback(ctx, results) {
+    if (ctx.insideMath)
+        return;
+    const severity = ctx.config.diagnostics.get("css/missing-fallback");
+    if (!severity)
+        return;
+    if (ctx.isRegistered)
+        return;
+    if (ctx.token?.provenance.kind === "artifact")
+        return;
+    if (ctx.usage.fallback !== null)
+        return;
+    if (values.isSuppressed("css/missing-fallback", ctx.usage.line, ctx.directives))
+        return;
+    results.push(makeDiagnostic(ctx.usage.line, ctx.usage.varNameColumn, severity, "css/missing-fallback", `\`var(${ctx.usage.cssVar})\` has no fallback value and the property is not registered with \`@property\`. If the custom property is not set, the declaration will be invalid at computed-value time. [CSS Custom Properties Level 1 \u2014 \u00A73]`, ctx.usage.varNameColumn + ctx.usage.varNameLength));
+}
+//# sourceMappingURL=checkMissingFallback.js.map

package/dist/esm/providers/diagnostics/checkMissingFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkMissingFallback.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkMissingFallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,0FAA0F;AAC1F,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,GAAqB,EACrB,OAAqB;IAErB,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO;IAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO;IAC7B,IAAI,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO;IACtD,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,IACE,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QAE3E,OAAO;IACT,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,GAAG,CAAC,KAAK,CAAC,aAAa,EACvB,QAAQ,EACR,sBAAsB,EACtB,SAAS,GAAG,CAAC,KAAK,CAAC,MAAM,4NAA4N,EACrP,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAClD,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/providers/diagnostics/checkNoColorScheme.js

@@ -0,0 +1,27 @@
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/no-color-scheme — light-dark() used without color-scheme property. */
+export default function checkNoColorScheme(ctx, results) {
+    const severity = ctx.config.diagnostics.get("css/no-color-scheme");
+    if (!severity)
+        return;
+    const hasLightDark = /light-dark\s*\(/.test(ctx.source);
+    if (!hasLightDark)
+        return;
+    const hasColorScheme = /color-scheme\s*:/.test(ctx.source);
+    if (hasColorScheme)
+        return;
+    const lines = ctx.source.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        if (/light-dark\s*\(/.test(lines[i])) {
+            if (values.isSuppressed("css/no-color-scheme", i, ctx.directives))
+                continue;
+            const col = lines[i].indexOf("light-dark");
+            const startCol = col >= 0 ? col : 0;
+            const endCol = col >= 0 ? col + "light-dark".length : 0;
+            results.push(makeDiagnostic(i, startCol, severity, "css/no-color-scheme", `\`light-dark()\` is used but no \`color-scheme\` property is set in this file. Without \`color-scheme\`, the browser cannot determine which value to use. [CSS Color Level 5 \u2014 \u00A73.4]`, endCol));
+            break;
+        }
+    }
+}
+//# sourceMappingURL=checkNoColorScheme.js.map

package/dist/esm/providers/diagnostics/checkNoColorScheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkNoColorScheme.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkNoColorScheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,oFAAoF;AACpF,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,GAAoB,EACpB,OAAqB;IAErB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,cAAc;QAAE,OAAO;IAE3B,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;gBAC/D,SAAS;YACX,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,CAAC,EACD,QAAQ,EACR,QAAQ,EACR,qBAAqB,EACrB,gMAAgM,EAChM,MAAM,CACP,CACF,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC"}