@canonical/terrazzo-lsp 0.0.2 → 0.2.0

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"}

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

@@ -0,0 +1,20 @@
+import { formatFileUri } from "../../css/index.js";
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/primitive-token — usage of a primitive-tier token outside its output file. */
+export default function checkPrimitiveToken(ctx, results) {
+    const severity = ctx.config.diagnostics.get("css/primitive-token");
+    if (!severity)
+        return;
+    if (!ctx.token || ctx.token.provenance.kind !== "artifact")
+        return;
+    if (ctx.token.tier !== "primitive")
+        return;
+    if (ctx.token.cssOutputFile &&
+        ctx.fileUri === formatFileUri(ctx.token.cssOutputFile))
+        return;
+    if (values.isSuppressed("css/primitive-token", ctx.usage.line, ctx.directives))
+        return;
+    results.push(makeDiagnostic(ctx.usage.line, ctx.usage.varNameColumn, severity, "css/primitive-token", `\`${ctx.usage.cssVar}\` is a primitive token${ctx.token.packageSource ? ` (${ctx.token.packageSource} \u00B7 ${ctx.token.id})` : ""}. Primitive tokens are raw palette values \u2014 prefer a semantic token alias. [DTCG 2025.10 \u2014 \u00A76.3: aliases as the indirection mechanism]`, ctx.usage.varNameColumn + ctx.usage.varNameLength));
+}
+//# sourceMappingURL=checkPrimitiveToken.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkPrimitiveToken.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkPrimitiveToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,4FAA4F;AAC5F,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,GAAqB,EACrB,OAAqB;IAErB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO;IACnE,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO;IAC3C,IACE,GAAG,CAAC,KAAK,CAAC,aAAa;QACvB,GAAG,CAAC,OAAO,KAAK,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;QAEtD,OAAO;IACT,IACE,MAAM,CAAC,YAAY,CAAC,qBAAqB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QAE1E,OAAO;IACT,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,GAAG,CAAC,KAAK,CAAC,aAAa,EACvB,QAAQ,EACR,qBAAqB,EACrB,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,aAAa,WAAW,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,uJAAuJ,EAC3R,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAClD,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+import * as values from "../../css/values/index.js";
+import { DiagnosticSeverity, } from "../../types/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/scoped-usage — var() references a declaration under a scoped selector. */
+export default function checkScopedUsage(ctx, results) {
+    const severity = ctx.config.diagnostics.get("css/scoped-usage");
+    if (!severity)
+        return;
+    const decls = ctx.graph.getDeclarations(ctx.usage.cssVar);
+    if (decls.length === 0)
+        return;
+    const scopedDecls = decls.filter((d) => d.selector.isScoped && d.fileUri !== ctx.fileUri);
+    if (scopedDecls.length === 0)
+        return;
+    const hasGlobalDecl = decls.some((d) => d.selector.isGlobal);
+    if (hasGlobalDecl)
+        return;
+    if (values.isSuppressed("css/scoped-usage", ctx.usage.line, ctx.directives))
+        return;
+    const firstScoped = scopedDecls[0];
+    const scopeSelector = firstScoped.selector.selector;
+    const scopeFile = firstScoped.fileUri.split("/").pop() ?? firstScoped.fileUri;
+    const effectiveSeverity = firstScoped.selector.scopeType === "class"
+        ? severity
+        : DiagnosticSeverity.Information;
+    results.push(makeDiagnostic(ctx.usage.line, ctx.usage.varNameColumn, effectiveSeverity, "css/scoped-usage", `\`${ctx.usage.cssVar}\` is declared under \`${scopeSelector}\` in \`${scopeFile}\`. It will only resolve when an ancestor matches \`${scopeSelector}\` \u2014 using it outside that context produces guaranteed-invalid at computed-value time. [CSS Custom Properties Level 1 \u2014 \u00A72: scope and inheritance]`, ctx.usage.varNameColumn + ctx.usage.varNameLength));
+}
+//# sourceMappingURL=checkScopedUsage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkScopedUsage.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkScopedUsage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAGL,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,wFAAwF;AACxF,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,GAAqB,EACrB,OAAqB;IAErB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CACxD,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACrC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,aAAa;QAAE,OAAO;IAC1B,IAAI,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QACzE,OAAO;IACT,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAoB,CAAC;IACtD,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACpD,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,OAAO,CAAC;IAC9E,MAAM,iBAAiB,GACrB,WAAW,CAAC,QAAQ,CAAC,SAAS,KAAK,OAAO;QACxC,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC;IACrC,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,GAAG,CAAC,KAAK,CAAC,aAAa,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,0BAA0B,aAAa,WAAW,SAAS,uDAAuD,aAAa,mKAAmK,EACvT,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAClD,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/stale-fallback — fallback value doesn't match the token's current value. */
+export default function checkStaleFallback(ctx, results) {
+    if (ctx.insideMath)
+        return;
+    const severity = ctx.config.diagnostics.get("css/stale-fallback");
+    if (!severity)
+        return;
+    if (ctx.usage.fallback === null)
+        return;
+    if (!ctx.token)
+        return;
+    const isColour = ctx.token.type === "color";
+    const currentValue = ctx.token.valueLight ?? null;
+    if (!values.compareFallbackStaleness(ctx.usage.fallback, currentValue, isColour))
+        return;
+    if (values.isSuppressed("css/stale-fallback", ctx.usage.line, ctx.directives))
+        return;
+    results.push(makeDiagnostic(ctx.usage.line, ctx.usage.varNameColumn, severity, "css/stale-fallback", `Fallback value \`${ctx.usage.fallback}\` does not match the current value of \`${ctx.usage.cssVar}\`${currentValue ? ` (\`${currentValue}\`)` : ""}. The fallback may be out of date. [CSS Custom Properties Level 1 \u2014 \u00A73: fallback values]`, ctx.usage.varNameColumn + ctx.usage.varNameLength));
+}
+//# sourceMappingURL=checkStaleFallback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkStaleFallback.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkStaleFallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,0FAA0F;AAC1F,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,GAAqB,EACrB,OAAqB;IAErB,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO;IAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO;IACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;IAC5C,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;IAClD,IACE,CAAC,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC;QAE5E,OAAO;IACT,IAAI,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QAC3E,OAAO;IACT,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,GAAG,CAAC,KAAK,CAAC,aAAa,EACvB,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,GAAG,CAAC,KAAK,CAAC,QAAQ,4CAA4C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,oGAAoG,EACvP,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAClD,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,24 @@
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/type-mismatch — token type doesn't match the property's expected type. */
+export default function checkTypeMismatch(ctx, results) {
+    if (ctx.insideMath)
+        return;
+    const severity = ctx.config.diagnostics.get("css/type-mismatch");
+    if (!severity)
+        return;
+    const tokenType = ctx.token?.cssType ?? ctx.prop?.cssType;
+    if (!tokenType || tokenType === "<unknown>")
+        return;
+    const expectedType = values.expectedTypeForProperty(ctx.usage.property);
+    if (!expectedType)
+        return;
+    if (values.isAssignable(tokenType, expectedType))
+        return;
+    if (values.isSuppressed("css/type-mismatch", ctx.usage.line, ctx.directives))
+        return;
+    const trimStart = ctx.lineText.length - ctx.lineText.trimStart().length;
+    const trimEnd = ctx.lineText.trimEnd().length;
+    results.push(makeDiagnostic(ctx.usage.line, trimStart, severity, "css/type-mismatch", `Type mismatch: \`${ctx.usage.cssVar}\` resolves to \`${tokenType}\` which is not assignable to \`${ctx.usage.property}\`. \`${ctx.usage.property}\` expects \`${expectedType}\`. [CSS Values Level 4 \u00A74; CSS Custom Properties Level 1 \u00A72]`, trimEnd));
+}
+//# sourceMappingURL=checkTypeMismatch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkTypeMismatch.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkTypeMismatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,wFAAwF;AACxF,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,GAAqB,EACrB,OAAqB;IAErB,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO;IAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC;IAC1D,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,YAA4B,CAAC;QAAE,OAAO;IACzE,IAAI,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QAC1E,OAAO;IACT,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;IACxE,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;IAC9C,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,GAAG,CAAC,KAAK,CAAC,MAAM,oBAAoB,SAAS,mCAAmC,GAAG,CAAC,KAAK,CAAC,QAAQ,SAAS,GAAG,CAAC,KAAK,CAAC,QAAQ,gBAAgB,YAAY,yEAAyE,EACtP,OAAO,CACR,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,19 @@
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/type-uncertain — token in a shorthand with ambiguous component mapping. */
+export default function checkTypeUncertain(ctx, results) {
+    if (ctx.insideMath)
+        return;
+    const severity = ctx.config.diagnostics.get("css/type-uncertain");
+    if (!severity)
+        return;
+    const tokenType = ctx.token?.cssType ?? ctx.prop?.cssType;
+    if (!tokenType || tokenType === "<unknown>")
+        return;
+    if (!values.SHORTHAND_PROPERTIES.has(ctx.usage.property))
+        return;
+    if (values.isSuppressed("css/type-uncertain", ctx.usage.line, ctx.directives))
+        return;
+    results.push(makeDiagnostic(ctx.usage.line, ctx.usage.varNameColumn, severity, "css/type-uncertain", `\`${ctx.usage.cssVar}\` resolves to \`${tokenType}\` in shorthand property \`${ctx.usage.property}\`. The component mapping is ambiguous \u2014 consider using a longhand property instead. [CSS Values Level 4 \u00A74]`, ctx.usage.varNameColumn + ctx.usage.varNameLength));
+}
+//# sourceMappingURL=checkTypeUncertain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkTypeUncertain.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkTypeUncertain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,yFAAyF;AACzF,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,GAAqB,EACrB,OAAqB;IAErB,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO;IAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC;IAC1D,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO;IACpD,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO;IACjE,IAAI,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QAC3E,OAAO;IACT,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,GAAG,CAAC,KAAK,CAAC,aAAa,EACvB,QAAQ,EACR,oBAAoB,EACpB,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,oBAAoB,SAAS,8BAA8B,GAAG,CAAC,KAAK,CAAC,QAAQ,wHAAwH,EAC1N,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAClD,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+import * as values from "../../css/values/index.js";
+import makeDiagnostic from "../makeDiagnostic.js";
+/** Check: css/unknown-var — var() references an unknown custom property. */
+export default function checkUnknownVar(ctx, results) {
+    const severity = ctx.config.diagnostics.get("css/unknown-var");
+    if (!severity)
+        return;
+    if (ctx.graph.hasToken(ctx.usage.cssVar))
+        return;
+    if (ctx.graph.hasProperty(ctx.usage.cssVar))
+        return;
+    if (ctx.graph.hasVar(ctx.usage.cssVar))
+        return;
+    if (values.isSuppressed("css/unknown-var", ctx.usage.line, ctx.directives))
+        return;
+    results.push(makeDiagnostic(ctx.usage.line, ctx.usage.varNameColumn, severity, "css/unknown-var", `\`var(${ctx.usage.cssVar})\` references a custom property not found in any reachable graph node. [CSS Custom Properties Level 1 \u2014 \u00A72]`, ctx.usage.varNameColumn + ctx.usage.varNameLength));
+}
+//# sourceMappingURL=checkUnknownVar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkUnknownVar.js","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkUnknownVar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAGlD,4EAA4E;AAC5E,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,GAAqB,EACrB,OAAqB;IAErB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO;IACjD,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO;IACpD,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO;IAC/C,IAAI,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;QACxE,OAAO;IACT,OAAO,CAAC,IAAI,CACV,cAAc,CACZ,GAAG,CAAC,KAAK,CAAC,IAAI,EACd,GAAG,CAAC,KAAK,CAAC,aAAa,EACvB,QAAQ,EACR,iBAAiB,EACjB,SAAS,GAAG,CAAC,KAAK,CAAC,MAAM,wHAAwH,EACjJ,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAClD,CACF,CAAC;AACJ,CAAC"}