@usefragments/core 1.2.0 → 1.3.0

package/src/rules/spacing-resolution.ts

@@ -1,7 +1,6 @@
 import type { TokenDefinitionFact } from "../facts/index.js";
 
 import {
-  isApplicableTokenReference,
   matchesScale,
   nearestSignedScaleValue,
   normalizeLengthForScale,
@@ -75,7 +74,7 @@ export function resolveSpacingValue(input: {
   let reliableSuggestion = true;
   // Deterministic only when every violating part is a value-preserving,
   // verbatim-resolvable token swap.
-  let allApplicableValuePreserving = true;
+  let allValuePreserving = true;
 
   for (const part of parts) {
     const normalized = normalizeLengthForScale(part.parsed, input.scale);
@@ -93,9 +92,7 @@ export function resolveSpacingValue(input: {
       // On-grid literal that equals a token: value-preserving swap.
       anyViolation = true;
       const reference = tokenReference(exactToken.name);
-      const applicable =
-        isApplicableTokenReference(exactToken.referenceFormat) && normalized.deterministicFix;
-      if (!applicable) allApplicableValuePreserving = false;
+      if (!normalized.deterministicFix) allValuePreserving = false;
       suggestedParts.push(reference);
       if (!firstViolation) {
         firstViolation = {
@@ -103,7 +100,7 @@ export function resolveSpacingValue(input: {
           suggestedValue: reference,
           suggestedToken: exactToken.name,
           fixEmittable: true,
-          deterministicFix: applicable,
+          deterministicFix: normalized.deterministicFix,
           reason: "token-equivalent",
           matchedToken: exactToken.name,
           assumedRootFontSizePx: normalized.assumedRootFontSizePx,
@@ -117,7 +114,7 @@ export function resolveSpacingValue(input: {
     // one exists. Snapping changes rendered value, so this is not deterministic.
     anyViolation = true;
     anyOffScale = true;
-    allApplicableValuePreserving = false;
+    allValuePreserving = false;
 
     const nearest = nearestSignedScaleValue(normalized.value, input.allowed);
     const snapsToZero = nearest === 0 && normalized.value !== 0;
@@ -158,7 +155,7 @@ export function resolveSpacingValue(input: {
   const joined = suggestedParts.join(" ");
   const changes = joined !== input.raw.trim().replace(/\s+/g, " ");
   const fixEmittable = canFixAll && reliableSuggestion && changes;
-  const deterministic = fixEmittable && !anyOffScale && allApplicableValuePreserving;
+  const deterministic = fixEmittable && !anyOffScale && allValuePreserving;
 
   return {
     ...firstViolation,

package/src/rules/styles-no-raw-color.ts

@@ -18,11 +18,12 @@ import { makeFinding } from "./finding.js";
 import type { Finding, FindingReplaceStyleValueFix } from "./types.js";
 import {
   detectRawColor,
+  emitFix,
   indexComponentByNodeId,
-  isApplicableTokenReference,
   isExemptColor,
   readUsageNode,
   tokenReference,
+  type FixEmission,
 } from "./utils.js";
 
 export const RULE_ID = "styles/no-raw-color";
@@ -43,6 +44,10 @@ export function ruleStylesNoRawColor(ix: FactIndex): Finding[] {
     if (isExemptColor(color, policy.except)) continue;
 
     const resolution = resolveColorToken(decl.property, color, colorTokens);
+    const fixEmission =
+      resolution?.kind === "exact"
+        ? buildTokenFix(decl.property, decl.value, color, resolution, ix)
+        : undefined;
     const evidenceIds = resolution
       ? [decl.id, policy.id, resolution.token.id]
       : [decl.id, policy.id];
@@ -63,10 +68,7 @@ export function ruleStylesNoRawColor(ix: FactIndex): Finding[] {
           property: decl.property,
           value: color,
         },
-        fix:
-          resolution?.kind === "exact"
-            ? buildTokenFix(decl.property, decl.value, color, resolution)
-            : undefined,
+        fix: fixEmission?.fix,
         attributes: {
           property: decl.property,
           rawValue: decl.value,
@@ -74,6 +76,7 @@ export function ruleStylesNoRawColor(ix: FactIndex): Finding[] {
           source: "css",
           suggestedToken: resolution?.token.name,
           ...(resolution ? { tokenMatch: resolution.kind } : {}),
+          ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
         },
       })
     );
@@ -91,6 +94,10 @@ export function ruleStylesNoRawColor(ix: FactIndex): Finding[] {
 
     const componentEvidenceId = componentByNode.get(node.id)?.id;
     const resolution = resolveColorToken(inline.property, color, colorTokens);
+    const fixEmission =
+      resolution?.kind === "exact"
+        ? buildTokenFix(inline.property, inline.value, color, resolution, ix)
+        : undefined;
     const baseEvidence = componentEvidenceId
       ? [node.id, componentEvidenceId, inline.id, policy.id]
       : [node.id, inline.id, policy.id];
@@ -112,10 +119,7 @@ export function ruleStylesNoRawColor(ix: FactIndex): Finding[] {
           property: inline.property,
           value: color,
         },
-        fix:
-          resolution?.kind === "exact"
-            ? buildTokenFix(inline.property, inline.value, color, resolution)
-            : undefined,
+        fix: fixEmission?.fix,
         attributes: {
           property: inline.property,
           rawValue: inline.value,
@@ -123,6 +127,7 @@ export function ruleStylesNoRawColor(ix: FactIndex): Finding[] {
           source: "jsx",
           suggestedToken: resolution?.token.name,
           ...(resolution ? { tokenMatch: resolution.kind } : {}),
+          ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
         },
       })
     );
@@ -298,22 +303,26 @@ function buildTokenFix(
   property: string,
   rawValue: string,
   rawColor: string,
-  match: TokenMatch
-): FindingReplaceStyleValueFix {
+  match: TokenMatch,
+  ix: FactIndex
+): FixEmission<FindingReplaceStyleValueFix> {
   const reference = tokenReference(match.token.name);
   const value = replaceRawColor(rawValue, rawColor, reference);
-  return {
-    kind: "replaceStyleValue",
-    title: `Replace ${property} with ${value}`,
-    property,
-    value,
-    // Apply automatically only when the swap is unambiguous AND the reference
-    // resolves verbatim. An ambiguous match (several tokens share the value,
-    // none role-matching) or a token that can't be referenced from CSS (a Sass
-    // *map* member, or a DTCG JSON token with no emitted custom property) is a
-    // suggestion — applying it would cross roles or write non-compiling code.
-    deterministic: !match.ambiguous && isApplicableTokenReference(match.token.referenceFormat),
-  };
+  return emitFix(
+    {
+      kind: "replaceStyleValue",
+      title: `Replace ${property} with ${value}`,
+      property,
+      value,
+      deterministic: true,
+    },
+    {
+      symbols: [match.token.name],
+      editKind: "replaceStyleValue",
+      valuePreserving: !match.ambiguous,
+    },
+    ix
+  );
 }
 
 function replaceRawColor(rawValue: string, rawColor: string, replacement: string): string {

package/src/rules/styles-no-raw-dimensions.ts

@@ -31,7 +31,13 @@ import type { FactId, FactIndex, TokenDefinitionFact } from "../facts/index.js";
 
 import { makeFinding } from "./finding.js";
 import type { Finding, FindingReplaceStyleValueFix } from "./types.js";
-import { indexComponentByNodeId, parseLengthValue, readUsageNode } from "./utils.js";
+import {
+  emitFix,
+  indexComponentByNodeId,
+  parseLengthValue,
+  readUsageNode,
+  type FixEmission,
+} from "./utils.js";
 
 export const RULE_ID = "styles/no-raw-dimensions";
 export const RULE_VERSION = "1";
@@ -75,6 +81,7 @@ export function ruleStylesNoRawDimensions(ix: FactIndex): Finding[] {
     if (!resolution) continue;
     const tokenIds = resolutionTokenIds(resolution);
     const evidenceIds = tokenIds.length ? [decl.id, policy.id, ...tokenIds] : [decl.id, policy.id];
+    const fixEmission = dimensionFix(decl.property, resolution, ix);
 
     findings.push(
       makeFinding({
@@ -92,12 +99,13 @@ export function ruleStylesNoRawDimensions(ix: FactIndex): Finding[] {
           property: decl.property,
           value: decl.value,
         },
-        fix: dimensionFix(decl.property, resolution),
+        fix: fixEmission?.fix,
         attributes: {
           property: decl.property,
           rawValue: decl.value,
           source: "css",
           suggestedToken: resolutionSuggestedToken(resolution),
+          ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
         },
       })
     );
@@ -121,6 +129,7 @@ export function ruleStylesNoRawDimensions(ix: FactIndex): Finding[] {
       : [node.id, inline.id, policy.id];
     const tokenIds = resolutionTokenIds(resolution);
     const evidenceIds = tokenIds.length ? [...baseEvidence, ...tokenIds] : baseEvidence;
+    const fixEmission = dimensionFix(inline.property, resolution, ix);
 
     findings.push(
       makeFinding({
@@ -138,12 +147,13 @@ export function ruleStylesNoRawDimensions(ix: FactIndex): Finding[] {
           property: inline.property,
           value: inline.value,
         },
-        fix: dimensionFix(inline.property, resolution),
+        fix: fixEmission?.fix,
         attributes: {
           property: inline.property,
           rawValue: inline.value,
           source: "jsx",
           suggestedToken: resolutionSuggestedToken(resolution),
+          ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
         },
       })
     );
@@ -219,16 +229,25 @@ function dimensionMessage(
 
 function dimensionFix(
   property: string,
-  resolution: DimensionResolution
-): FindingReplaceStyleValueFix | undefined {
+  resolution: DimensionResolution,
+  ix: FactIndex
+): FixEmission<FindingReplaceStyleValueFix> | undefined {
   if (resolution.kind === "exact") {
-    return {
-      kind: "replaceStyleValue",
-      title: `Replace ${property} with ${resolution.fixValue}`,
-      property,
-      value: resolution.fixValue,
-      deterministic: true,
-    };
+    return emitFix(
+      {
+        kind: "replaceStyleValue",
+        title: `Replace ${property} with ${resolution.fixValue}`,
+        property,
+        value: resolution.fixValue,
+        deterministic: true,
+      },
+      {
+        symbols: resolution.tokens.map((token) => token.name),
+        editKind: "replaceStyleValue",
+        valuePreserving: true,
+      },
+      ix
+    );
   }
   // `nearest` deliberately emits NO fix — a value-changing snap must stay a
   // suggestion (see DimensionResolution); only the exact, value-preserving swap

package/src/rules/styles-no-raw-spacing.ts

@@ -42,7 +42,13 @@ import {
   type SpacingTokenLookup,
 } from "./spacing-resolution.js";
 import type { Finding } from "./types.js";
-import { indexComponentByNodeId, readUsageNode } from "./utils.js";
+import {
+  emitFix,
+  indexComponentByNodeId,
+  readUsageNode,
+  tokenSymbolsInText,
+  type FixEmission,
+} from "./utils.js";
 
 export const RULE_ID = "styles/no-raw-spacing";
 export const RULE_VERSION = "1";
@@ -104,6 +110,7 @@ function checkDeclaration(
     tokens: lookupFor(scale),
   });
   if (!checked) return null;
+  const fixEmission = buildSpacingFix(decl.property, checked, ix);
 
   return makeFinding({
     ruleId: RULE_ID,
@@ -120,7 +127,7 @@ function checkDeclaration(
       property: decl.property,
       value: decl.value,
     },
-    fix: buildSpacingFix(decl.property, checked),
+    fix: fixEmission?.fix,
     attributes: {
       property: decl.property,
       rawValue: decl.value,
@@ -135,6 +142,7 @@ function checkDeclaration(
       assumedRootFontSizePx: checked.assumedRootFontSizePx,
       assumedEmBasePx: checked.assumedEmBasePx,
       source: "css",
+      ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
     },
   });
 }
@@ -162,6 +170,7 @@ function checkInlineStyle(
     bareNumberFix: inline.valueKind === "number",
   });
   if (!checked) return null;
+  const fixEmission = buildSpacingFix(inline.property, checked, ix);
 
   const node = readUsageNode(ix, inline.nodeId);
   if (!node) return null;
@@ -186,7 +195,7 @@ function checkInlineStyle(
       property: inline.property,
       value: inline.value,
     },
-    fix: buildSpacingFix(inline.property, checked),
+    fix: fixEmission?.fix,
     attributes: {
       property: inline.property,
       rawValue: inline.value,
@@ -201,19 +210,32 @@ function checkInlineStyle(
       assumedRootFontSizePx: checked.assumedRootFontSizePx,
       assumedEmBasePx: checked.assumedEmBasePx,
       source: "jsx",
+      ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
     },
   });
 }
 
-function buildSpacingFix(property: string, checked: CheckedSpacingValue) {
+function buildSpacingFix(
+  property: string,
+  checked: CheckedSpacingValue,
+  ix: FactIndex
+): FixEmission | undefined {
   if (!checked.fixEmittable || checked.suggestedValue === undefined) return undefined;
-  return {
-    kind: "replaceStyleValue" as const,
-    title: `Replace ${property} with ${checked.suggestedValue}`,
-    property,
-    value: checked.suggestedValue,
-    deterministic: checked.deterministicFix,
-  };
+  return emitFix(
+    {
+      kind: "replaceStyleValue" as const,
+      title: `Replace ${property} with ${checked.suggestedValue}`,
+      property,
+      value: checked.suggestedValue,
+      deterministic: true,
+    },
+    {
+      symbols: tokenSymbolsInText(checked.suggestedValue),
+      editKind: "replaceStyleValue",
+      valuePreserving: checked.deterministicFix,
+    },
+    ix
+  );
 }
 
 function spacingMessage(

package/src/rules/styles-no-raw-typography.ts

@@ -29,13 +29,15 @@ import { makeFinding } from "./finding.js";
 import type { Finding } from "./types.js";
 import {
   indexComponentByNodeId,
-  isApplicableTokenReference,
+  emitFix,
   matchesScale,
   nearestSignedScaleValue,
   normalizeLengthForScale,
   parseLengthValue,
   readUsageNode,
   tokenReference,
+  tokenSymbolsInText,
+  type FixEmission,
 } from "./utils.js";
 
 export const RULE_ID = "styles/no-raw-typography";
@@ -58,6 +60,7 @@ export function ruleStylesNoRawTypography(ix: FactIndex): Finding[] {
     if (decl.property.toLowerCase() !== "font-size") continue;
     const checked = checkFontSize(decl.value, allowed, scale, tokens);
     if (!checked) continue;
+    const fixEmission = buildFix(decl.property, checked, ix);
     findings.push(
       makeFinding({
         ruleId: RULE_ID,
@@ -74,7 +77,7 @@ export function ruleStylesNoRawTypography(ix: FactIndex): Finding[] {
           property: decl.property,
           value: decl.value,
         },
-        fix: buildFix(decl.property, checked),
+        fix: fixEmission?.fix,
         attributes: {
           property: decl.property,
           rawValue: decl.value,
@@ -83,6 +86,7 @@ export function ruleStylesNoRawTypography(ix: FactIndex): Finding[] {
           suggestedValue: checked.suggestedValue,
           matchedToken: checked.matchedToken,
           source: "css",
+          ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
         },
       })
     );
@@ -92,8 +96,15 @@ export function ruleStylesNoRawTypography(ix: FactIndex): Finding[] {
   for (const inline of ix.byKind("usage_inline_style")) {
     if (inline.valueKind === "css-variable") continue;
     if (!FONT_SIZE_PROPERTIES.has(inline.property.toLowerCase())) continue;
-    const checked = checkFontSize(inline.value, allowed, scale, tokens, inline.valueKind === "number");
+    const checked = checkFontSize(
+      inline.value,
+      allowed,
+      scale,
+      tokens,
+      inline.valueKind === "number"
+    );
     if (!checked) continue;
+    const fixEmission = buildFix(inline.property, checked, ix);
     const node = readUsageNode(ix, inline.nodeId);
     if (!node) continue;
     const componentEvidenceId = componentByNode.get(node.id)?.id;
@@ -116,7 +127,7 @@ export function ruleStylesNoRawTypography(ix: FactIndex): Finding[] {
           property: inline.property,
           value: inline.value,
         },
-        fix: buildFix(inline.property, checked),
+        fix: fixEmission?.fix,
         attributes: {
           property: inline.property,
           rawValue: inline.value,
@@ -125,6 +136,7 @@ export function ruleStylesNoRawTypography(ix: FactIndex): Finding[] {
           suggestedValue: checked.suggestedValue,
           matchedToken: checked.matchedToken,
           source: "jsx",
+          ...(fixEmission?.downgradeReason ? { downgradeReason: fixEmission.downgradeReason } : {}),
         },
       })
     );
@@ -175,12 +187,10 @@ function checkFontSize(
 
   if (matchesScale(normalized.value, allowed)) {
     if (!exactToken) return null;
-    const applicable =
-      isApplicableTokenReference(exactToken.referenceFormat) && normalized.deterministicFix;
     return {
       suggestedValue: tokenReference(exactToken.name),
       fixEmittable: true,
-      deterministicFix: applicable,
+      deterministicFix: normalized.deterministicFix,
       reason: "token-equivalent",
       matchedToken: exactToken.name,
     };
@@ -206,15 +216,27 @@ function checkFontSize(
   };
 }
 
-function buildFix(property: string, checked: CheckedFontSize) {
+function buildFix(
+  property: string,
+  checked: CheckedFontSize,
+  ix: FactIndex
+): FixEmission | undefined {
   if (!checked.fixEmittable || checked.suggestedValue === undefined) return undefined;
-  return {
-    kind: "replaceStyleValue" as const,
-    title: `Replace ${property} with ${checked.suggestedValue}`,
-    property,
-    value: checked.suggestedValue,
-    deterministic: checked.deterministicFix,
-  };
+  return emitFix(
+    {
+      kind: "replaceStyleValue" as const,
+      title: `Replace ${property} with ${checked.suggestedValue}`,
+      property,
+      value: checked.suggestedValue,
+      deterministic: true,
+    },
+    {
+      symbols: tokenSymbolsInText(checked.suggestedValue),
+      editKind: "replaceStyleValue",
+      valuePreserving: checked.deterministicFix,
+    },
+    ix
+  );
 }
 
 function typographyMessage(

package/src/rules/taxonomy.test.ts

@@ -12,6 +12,7 @@ import {
   makeContractTokenFact,
   makeStyleCssVarsMustBeDefinedFact,
   makeStyleDeclarationFact,
+  makeTokenDefinitionFact,
   makeUsageNodeFact,
   makeUsageTextChildFact,
   RULE_TIER,
@@ -36,6 +37,7 @@ import type { Fact } from "../index.js";
 function rawValueFixture(): Fact[] {
   const file = "src/Widget.module.scss";
   return [
+    dualFallbackToken(),
     makeStyleDeclarationFact({
       file,
       selector: ".a",
@@ -64,6 +66,15 @@ function rawValueFixture(): Fact[] {
   ];
 }
 
+function dualFallbackToken(): Fact {
+  return makeTokenDefinitionFact({
+    name: "$fui-surface-secondary",
+    value: "#f1f5f9",
+    category: "color",
+    referenceFormat: "scss-var",
+  });
+}
+
 function index(facts: Fact[]): FactIndex {
   const ix = new FactIndex();
   ix.addMany(facts);
@@ -138,12 +149,14 @@ describe("§2 tokens/require-dual-fallback is Fragments-internal", () => {
   it("customer preset = 0, fragments preset = 1", () => {
     const customer = index([
       ...compileGlobalGovernanceFacts({ rules: customerDefaultRuleStates() }),
+      dualFallbackToken(),
       decl,
     ]);
     expect(runRules(customer)).toHaveLength(0);
 
     const fragments = index([
       ...compileGlobalGovernanceFacts({ rules: fragmentsPresetRuleStates() }),
+      dualFallbackToken(),
       decl,
     ]);
     const fragmentsFindings = runRules(fragments);

package/src/rules/tokens-require-dual-fallback.ts

@@ -1,8 +1,8 @@
-import type { FactIndex } from "../facts/index.js";
+import type { FactIndex, TokenDefinitionFact } from "../facts/index.js";
 
 import { makeFinding } from "./finding.js";
 import type { Finding } from "./types.js";
-import { cssVariableNames } from "./utils.js";
+import { emitFix } from "./utils.js";
 
 export const RULE_ID = "tokens/require-dual-fallback";
 export const RULE_VERSION = "1";
@@ -22,7 +22,7 @@ export function ruleTokensRequireDualFallback(ix: FactIndex): Finding[] {
   const policy = ix.policy.ruleConfig(RULE_ID);
   if (!policy?.enabled) return [];
 
-  const knownTokenVars = cssVariableNames(ix.tokens.list());
+  const tokensByCssVariable = indexTokensByCssVariable(ix.tokens.list());
   const findings: Finding[] = [];
 
   for (const decl of ix.byKind("style_declaration")) {
@@ -33,21 +33,43 @@ export function ruleTokensRequireDualFallback(ix: FactIndex): Finding[] {
       const tokenName = match[1];
       const hasFallback = match[2] !== undefined;
       if (hasFallback) continue;
-      if (!knownTokenVars.has(tokenName) && !tokenName.startsWith("--fui-")) continue;
+      const token = tokensByCssVariable.get(tokenName);
+      if (!token) continue;
 
       const rawValue = match[0];
       const scssVar = tokenName.replace(/^--/, "$");
-      const replacement = `var(${tokenName}, ${scssVar})`;
-      const nextValue = decl.value.replace(rawValue, replacement);
+      const hasScssVariable = token.referenceFormat === "scss-var";
+      const nextValue = hasScssVariable
+        ? decl.value.replace(rawValue, `var(${tokenName}, ${scssVar})`)
+        : undefined;
+      const fixEmission = nextValue
+        ? emitFix(
+            {
+              kind: "replaceStyleValue",
+              title: `Add fallback for ${tokenName}`,
+              property: decl.property,
+              value: nextValue,
+              deterministic: true,
+            },
+            {
+              symbols: [tokenName, scssVar],
+              editKind: "replaceStyleValue",
+              valuePreserving: true,
+            },
+            ix
+          )
+        : undefined;
 
       findings.push(
         makeFinding({
           ruleId: RULE_ID,
           ruleVersion: RULE_VERSION,
           severity: policy.severity ?? "warn",
-          message: `var(${tokenName}) is missing an SCSS fallback. Use var(${tokenName}, ${scssVar}).`,
+          message: hasScssVariable
+            ? `var(${tokenName}) is missing an SCSS fallback. Use var(${tokenName}, ${scssVar}).`
+            : `var(${tokenName}) is missing a fallback. No matching SCSS variable was found in the token source; add a fallback manually or define ${scssVar}.`,
           location: decl.location,
-          evidence: ix.evidence([decl.id, policy.id]),
+          evidence: ix.evidence([decl.id, token.id, policy.id]),
           fingerprintIdentity: {
             file: decl.file,
             selector: decl.selector,
@@ -55,24 +77,39 @@ export function ruleTokensRequireDualFallback(ix: FactIndex): Finding[] {
             property: decl.property,
             tokenName,
           },
-          fix: {
-            kind: "replaceStyleValue",
-            title: `Add fallback for ${tokenName}`,
-            property: decl.property,
-            value: nextValue,
-            deterministic: true,
-          },
+          fix: fixEmission?.fix,
           attributes: {
             property: decl.property,
             rawValue: decl.value,
             tokenName,
-            suggestedValue: nextValue,
+            ...(nextValue ? { suggestedValue: nextValue } : {}),
+            ...(fixEmission?.downgradeReason
+              ? { downgradeReason: fixEmission.downgradeReason }
+              : {}),
             source: "css",
           },
-        }),
+        })
       );
     }
   }
 
   return findings;
 }
+
+function indexTokensByCssVariable(
+  tokens: readonly TokenDefinitionFact[]
+): Map<string, TokenDefinitionFact> {
+  const indexed = new Map<string, TokenDefinitionFact>();
+  for (const token of tokens) {
+    const cssVariable = token.name.startsWith("--")
+      ? token.name
+      : token.name.startsWith("$")
+        ? `--${token.name.slice(1)}`
+        : `--${token.name}`;
+    const existing = indexed.get(cssVariable);
+    if (!existing || token.referenceFormat === "scss-var") {
+      indexed.set(cssVariable, token);
+    }
+  }
+  return indexed;
+}