@canonical/terrazzo-plugin-css 0.0.2 → 0.2.0

package/dist/esm/build/constants/interactiveRoles.js

@@ -0,0 +1,88 @@
+/** Interactive roles and their state variants. */
+export const interactiveRoles = [
+    {
+        role: "color.foreground.primary",
+        states: ["hover", "active", "disabled"],
+        hasSurface: false,
+        hasModifier: true,
+    },
+    {
+        role: "color.foreground.secondary",
+        states: ["hover", "active", "disabled"],
+        hasSurface: false,
+        hasModifier: true,
+    },
+    {
+        role: "color.foreground.ghost",
+        states: ["hover", "active", "disabled"],
+        hasSurface: true,
+        hasModifier: true,
+    },
+    {
+        role: "color.foreground.input",
+        states: ["hover", "active", "disabled"],
+        hasSurface: true,
+        hasModifier: true,
+    },
+    {
+        role: "color.foreground.navigation.primary",
+        states: ["hover", "active", "disabled"],
+        hasSurface: true,
+        hasModifier: false,
+    },
+    {
+        role: "color.foreground.navigation.secondary",
+        states: ["hover", "active", "disabled"],
+        hasSurface: false,
+        hasModifier: false,
+    },
+    {
+        role: "color.foreground.checkbox.unselected",
+        states: ["hover", "active", "disabled"],
+        hasSurface: true,
+        hasModifier: false,
+    },
+    {
+        role: "color.foreground.radio.unselected",
+        states: ["hover", "active", "disabled"],
+        hasSurface: true,
+        hasModifier: false,
+    },
+    {
+        role: "color.foreground.checkbox.checkmark",
+        states: ["disabled"],
+        hasSurface: true,
+        hasModifier: false,
+    },
+    {
+        role: "color.foreground.radio.checkmark",
+        states: ["disabled"],
+        hasSurface: true,
+        hasModifier: false,
+    },
+    {
+        role: "color.foreground.switch.knob",
+        states: ["disabled"],
+        hasSurface: true,
+        hasModifier: false,
+    },
+    {
+        role: "color.border",
+        states: ["disabled"],
+        hasSurface: false,
+        hasModifier: true,
+    },
+    {
+        role: "color.text",
+        states: ["disabled"],
+        hasSurface: false,
+        hasModifier: true,
+    },
+    {
+        role: "color.icon",
+        states: ["disabled"],
+        hasSurface: false,
+        hasModifier: true,
+    },
+];
+//# sourceMappingURL=interactiveRoles.js.map

package/dist/esm/build/constants/interactiveRoles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveRoles.js","sourceRoot":"","sources":["../../../../src/build/constants/interactiveRoles.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD;QACE,IAAI,EAAE,0BAA0B;QAChC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,qCAAqC;QAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,uCAAuC;QAC7C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,sCAAsC;QAC5C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvC,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,qCAAqC;QAC3C,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,kCAAkC;QACxC,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;KACnB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,IAAI;KAClB;CACF,CAAC"}

package/dist/esm/build/constants/surfaceSelectorMap.js

@@ -0,0 +1,7 @@
+/** Surface selector compounding by context depth. */
+export const SURFACE_SELECTOR_MAP = {
+    layer1: ".surface",
+    layer2: ".surface .surface",
+    layer3: ".surface .surface .surface",
+};
+//# sourceMappingURL=surfaceSelectorMap.js.map

package/dist/esm/build/constants/surfaceSelectorMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceSelectorMap.js","sourceRoot":"","sources":["../../../../src/build/constants/surfaceSelectorMap.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,4BAA4B;CACrC,CAAC"}

package/dist/esm/build/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/esm/build/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/build/context.ts"],"names":[],"mappings":""}

package/dist/esm/build/deltas.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deltas.js.map

package/dist/esm/build/deltas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.js","sourceRoot":"","sources":["../../../src/build/deltas.ts"],"names":[],"mappings":""}

package/dist/esm/build/extractOklchL.js

@@ -0,0 +1,13 @@
+export function extractOklchL(value) {
+    if (typeof value === "object" &&
+        value !== null &&
+        "colorSpace" in value &&
+        value.colorSpace === "oklch" &&
+        "components" in value &&
+        Array.isArray(value.components)) {
+        const l = value.components[0];
+        return typeof l === "number" ? l : null;
+    }
+    return null;
+}
+//# sourceMappingURL=extractOklchL.js.map

package/dist/esm/build/extractOklchL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractOklchL.js","sourceRoot":"","sources":["../../../src/build/extractOklchL.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,YAAY,IAAI,KAAK;QACpB,KAAgC,CAAC,UAAU,KAAK,OAAO;QACxD,YAAY,IAAI,KAAK;QACrB,KAAK,CAAC,OAAO,CAAE,KAAmC,CAAC,UAAU,CAAC,EAC9D,CAAC;QACD,MAAM,CAAC,GAAI,KAAyB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/build/filterExtensions.js

@@ -0,0 +1,21 @@
+/**
+ * Filter DTCG $extensions: strip internal `com.canonical.*` keys,
+ * returning only third-party / user-defined extensions for artifact output.
+ *
+ * Returns `undefined` when no passthrough keys remain, so callers can
+ * use it directly in the spread-based construction without adding empty objects.
+ */
+export function filterExtensions(raw) {
+    if (!raw)
+        return undefined;
+    const result = {};
+    let hasKeys = false;
+    for (const [key, value] of Object.entries(raw)) {
+        if (!key.startsWith("com.canonical.")) {
+            result[key] = value;
+            hasKeys = true;
+        }
+    }
+    return hasKeys ? result : undefined;
+}
+//# sourceMappingURL=filterExtensions.js.map

package/dist/esm/build/filterExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterExtensions.js","sourceRoot":"","sources":["../../../src/build/filterExtensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAwC;IAExC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC"}

package/dist/esm/build/formatDelta.js

@@ -0,0 +1,5 @@
+export function formatDelta(delta) {
+    const rounded = Math.round(delta * 1_000_000) / 1_000_000;
+    return String(rounded);
+}
+//# sourceMappingURL=formatDelta.js.map

package/dist/esm/build/formatDelta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDelta.js","sourceRoot":"","sources":["../../../src/build/formatDelta.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC"}

package/dist/esm/build/index.js

@@ -0,0 +1,17 @@
+/**
+ * Build module barrel — re-exports all build helpers.
+ */
+export { annotateDeclarations } from "./annotation.js";
+export { buildDescriptionLookup, buildFallbackChain, buildModifierFamily, buildSetsPrimitive, buildSetsSemantic, buildStates, buildSurfaces, buildTheme, buildTypography, convertCssValueToString, emitTypographyDecls, } from "./builders/index.js";
+export { isPrimitive, isSemanticColor, isSemanticTypography, } from "./classification.js";
+export { computeDeltas } from "./computeDeltas.js";
+export { FORMAT } from "./constants/format.js";
+export { HEADER } from "./constants/header.js";
+export { interactiveRoles } from "./constants/interactiveRoles.js";
+export { SURFACE_SELECTOR_MAP } from "./constants/surfaceSelectorMap.js";
+export { extractOklchL } from "./extractOklchL.js";
+export { formatDelta } from "./formatDelta.js";
+export { extractModifierFileData, loadModifierData, walkTokenTree, } from "./modifierIo.js";
+export { recoverPrimitiveRef } from "./recoverPrimitiveRef.js";
+export { isColorTokenLike, isSingleValueTransformResult } from "./shims.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/build/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAoB/D,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/build/modifierIo.js

@@ -0,0 +1,105 @@
+/**
+ * Modifier file I/O — read DTCG source files and extract alias maps.
+ *
+ * Performs synchronous file I/O via `readFileSync`. These functions are
+ * called during the build phase to resolve modifier alias relationships
+ * from the raw token source files.
+ */
+import { readFileSync } from "node:fs";
+// ---------------------------------------------------------------------------
+// Public helpers
+// ---------------------------------------------------------------------------
+/**
+ * Walk a DTCG token JSON tree and collect alias targets (from `$value` alias
+ * strings) and `$description` values, keyed by the dot-separated token ID path.
+ *
+ * @note Performs synchronous file I/O (readFileSync).
+ */
+export function extractModifierFileData(filePath) {
+    const aliases = {};
+    const descriptions = {};
+    try {
+        const raw = readFileSync(filePath, "utf8");
+        const json = JSON.parse(raw);
+        walkTokenTree(json, [], aliases, descriptions);
+    }
+    catch (err) {
+        console.warn(`[canonical-css] Could not read modifier data from ${filePath}:`, err instanceof Error ? err.message : err);
+    }
+    return { aliases, descriptions };
+}
+/**
+ * Recursively walk a DTCG token tree, collecting alias targets and
+ * `$description` values.
+ *
+ * Alias targets are extracted from DTCG `$value` strings matching the
+ * `"{token.path}"` pattern. When `$root` is encountered, the token ID
+ * is the parent path (the `$root` marker is stripped per DTCG spec).
+ */
+export function walkTokenTree(node, path, aliases, descriptions) {
+    if (typeof node !== "object" || node === null)
+        return;
+    const obj = node;
+    // Check for DTCG alias: $value is a string matching "{token.path}"
+    const rawValue = obj.$value;
+    if (typeof rawValue === "string") {
+        const aliasMatch = /^\{(.+)\}$/.exec(rawValue);
+        if (aliasMatch) {
+            const tokenId = path.join(".");
+            aliases[tokenId] = aliasMatch[1];
+        }
+    }
+    // Collect $description at this level (only for token nodes with $value)
+    if ("$value" in obj &&
+        "$description" in obj &&
+        typeof obj.$description === "string") {
+        const tokenId = path.join(".");
+        descriptions[tokenId] = obj.$description;
+    }
+    // Recurse into children (skip $-prefixed keys except $root)
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === "$root") {
+            // $root collapses to the parent path
+            walkTokenTree(value, path, aliases, descriptions);
+        }
+        else if (!key.startsWith("$")) {
+            walkTokenTree(value, [...path, key], aliases, descriptions);
+        }
+    }
+}
+/**
+ * Load modifier file data for a specific family context by reading the raw
+ * token source files referenced in the resolver JSON.
+ *
+ * Returns both the alias map (token ID → aliasOf target) and the
+ * description map (token ID → `$description` text).
+ *
+ * @note Performs synchronous file I/O (readFileSync + JSON.parse on the resolver).
+ * @param tokensDir  - Base directory for token sources (e.g. "./tokens/canonical")
+ * @param family     - Modifier family name (e.g. "anticipation")
+ * @param context    - Context name (e.g. "constructive")
+ */
+export function loadModifierData(tokensDir, family, context) {
+    // Read the resolver JSON to find the $ref paths for this context
+    const resolverPath = `${tokensDir}/canonical.resolver.json`;
+    try {
+        const resolverJson = JSON.parse(readFileSync(resolverPath, "utf8"));
+        const refs = resolverJson.modifiers?.[family]?.contexts?.[context] ?? [];
+        const aliases = {};
+        const descriptions = {};
+        for (const ref of refs) {
+            if (ref.$ref) {
+                const filePath = `${tokensDir}/${ref.$ref}`;
+                const data = extractModifierFileData(filePath);
+                Object.assign(aliases, data.aliases);
+                Object.assign(descriptions, data.descriptions);
+            }
+        }
+        return { aliases, descriptions };
+    }
+    catch (err) {
+        console.warn(`[canonical-css] Could not load modifier data for ${family}/${context}:`, err instanceof Error ? err.message : err);
+        return { aliases: {}, descriptions: {} };
+    }
+}
+//# sourceMappingURL=modifierIo.js.map

package/dist/esm/build/modifierIo.js.map

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

package/dist/esm/build/recoverPrimitiveRef.js

@@ -0,0 +1,26 @@
+/**
+ * Primitive reference recovery.
+ *
+ * Terrazzo resolves component-level `$ref` aliases to literal values during
+ * `transformCSSValue`. This restores the semantic → primitive relationship
+ * so the CSS output and artifact both reference the primitive custom property
+ * instead of duplicating the raw value.
+ */
+/**
+ * Replace a resolved literal value with a `var()` reference to the matching
+ * primitive token when one exists.
+ *
+ * Values that are already `var()` references (whole-token aliases preserved
+ * by Terrazzo) are returned unchanged. Self-references are also skipped.
+ */
+export function recoverPrimitiveRef(value, selfCssVar, primitiveByValue) {
+    // Already a var() reference — nothing to recover
+    if (value.startsWith("var("))
+        return value;
+    const primitiveVar = primitiveByValue.get(value);
+    if (primitiveVar && primitiveVar !== selfCssVar) {
+        return `var(${primitiveVar})`;
+    }
+    return value;
+}
+//# sourceMappingURL=recoverPrimitiveRef.js.map

package/dist/esm/build/recoverPrimitiveRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recoverPrimitiveRef.js","sourceRoot":"","sources":["../../../src/build/recoverPrimitiveRef.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,UAAkB,EAClB,gBAAqC;IAErC,iDAAiD;IACjD,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,YAAY,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChD,OAAO,OAAO,YAAY,GAAG,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/build/shims.js

@@ -0,0 +1,16 @@
+/**
+ * Internal type shims — avoid coupling to @terrazzo/parser internal types.
+ *
+ * These lightweight interfaces match the shape that the Terrazzo plugin
+ * runtime passes into `transform()` and `build()` hooks, without importing
+ * from @terrazzo/parser directly.
+ */
+/** Narrow a token to the color-token shape. */
+export function isColorTokenLike(token) {
+    return token.$type === "color";
+}
+/** Narrow a transform result to a single-value payload. */
+export function isSingleValueTransformResult(result) {
+    return result.type === "SINGLE_VALUE";
+}
+//# sourceMappingURL=shims.js.map

package/dist/esm/build/shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shims.js","sourceRoot":"","sources":["../../../src/build/shims.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiHH,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,OAAO,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;AACjC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,4BAA4B,CAC1C,MAAuB;IAEvB,OAAO,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;AACxC,CAAC"}

package/dist/esm/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/build/types.ts"],"names":[],"mappings":""}

package/dist/esm/css-ast/addDeclarationUnique.js

@@ -0,0 +1,7 @@
+import hasDeclaration from "./hasDeclaration.js";
+export default function addDeclarationUnique(nodes, decl) {
+    if (!hasDeclaration(nodes, decl.property)) {
+        nodes.push(decl);
+    }
+}
+//# sourceMappingURL=addDeclarationUnique.js.map

package/dist/esm/css-ast/addDeclarationUnique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addDeclarationUnique.js","sourceRoot":"","sources":["../../../src/css-ast/addDeclarationUnique.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAGjD,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,KAAgB,EAChB,IAAoB;IAEpB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/esm/css-ast/createDeclaration.js

@@ -0,0 +1,4 @@
+export default function createDeclaration(property, value, comment) {
+    return { type: "Declaration", property, value, comment };
+}
+//# sourceMappingURL=createDeclaration.js.map

package/dist/esm/css-ast/createDeclaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDeclaration.js","sourceRoot":"","sources":["../../../src/css-ast/createDeclaration.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,QAAgB,EAChB,KAAa,EACb,OAAgB;IAEhB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/esm/css-ast/decl.js

@@ -1,4 +1,4 @@
-export default function decl(property, value, comment) {
+export default function createDecl(property, value, comment) {
     return { type: "Declaration", property, value, comment };
 }
 //# sourceMappingURL=decl.js.map

package/dist/esm/css-ast/decl.js.map

@@ -1 +1 @@
-{"version":3,"file":"decl.js","sourceRoot":"","sources":["../../../src/css-ast/decl.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,IAAI,CAC1B,QAAgB,EAChB,KAAa,EACb,OAAgB;IAEhB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"decl.js","sourceRoot":"","sources":["../../../src/css-ast/decl.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,QAAgB,EAChB,KAAa,EACb,OAAgB;IAEhB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/esm/css-ast/hasDeclaration.js

@@ -0,0 +1,4 @@
+export default function hasDeclaration(nodes, property) {
+    return nodes.some((node) => node.type === "Declaration" && node.property === property);
+}
+//# sourceMappingURL=hasDeclaration.js.map

package/dist/esm/css-ast/hasDeclaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasDeclaration.js","sourceRoot":"","sources":["../../../src/css-ast/hasDeclaration.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,KAAgB,EAChB,QAAgB;IAEhB,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CACpE,CAAC;AACJ,CAAC"}

package/dist/esm/css-ast/index.js

@@ -1,7 +1,7 @@
-export { default as addDeclUnique } from "./addDeclUnique.js";
-export { default as decl } from "./decl.js";
-export { default as hasDecl } from "./hasDecl.js";
+export { default as addDeclarationUnique } from "./addDeclarationUnique.js";
+export { default as createDeclaration } from "./createDeclaration.js";
+export { default as hasDeclaration } from "./hasDeclaration.js";
 export { default as printNode } from "./printNode.js";
 export { default as printRules } from "./printRules.js";
-export { default as rule } from "./rule.js";
+export { default as createRule } from "./rule.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/css-ast/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/css-ast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/css-ast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/css-ast/printRules.js

@@ -1,3 +1,4 @@
+/** Print an array of CSS AST nodes into a formatted CSS string. */
 import printNode from "./printNode.js";
 export default function printRules(nodes, opts = {}) {
     const { indentChar = "\t", indentLv = 0 } = opts;

package/dist/esm/css-ast/printRules.js.map

@@ -1 +1 @@
-{"version":3,"file":"printRules.js","sourceRoot":"","sources":["../../../src/css-ast/printRules.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,KAAgB,EAChB,OAAqB,EAAE;IAEvB,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"printRules.js","sourceRoot":"","sources":["../../../src/css-ast/printRules.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,KAAgB,EAChB,OAAqB,EAAE;IAEvB,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}

package/dist/esm/css-ast/rule.js

@@ -1,4 +1,4 @@
-export default function rule(prelude, children = []) {
+export default function createRule(prelude, children = []) {
     return { type: "Rule", prelude, children };
 }
 //# sourceMappingURL=rule.js.map

package/dist/esm/css-ast/rule.js.map

@@ -1 +1 @@
-{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/css-ast/rule.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,IAAI,CAC1B,OAAiB,EACjB,WAAsB,EAAE;IAExB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/css-ast/rule.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,OAAiB,EACjB,WAAsB,EAAE;IAExB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC7C,CAAC"}

package/dist/esm/css-ast/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/css-ast/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/css-ast/types.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -1,14 +1,14 @@
 /**
- * @canonical/terrazzo-plugin-css-v2
+ * @canonical/terrazzo-plugin-css
  *
  * Custom Terrazzo plugin for Canonical design tokens.
  * Modifier contracts, light-dark pairing, layer wrapping, artifact emission.
  */
 export { classifyTier, makeArtifactToken, makeDerivedArtifactToken, serializeArtifact, } from "./artifact/index.js";
-export { addDeclUnique, decl, hasDecl, printNode, printRules, rule, } from "./css-ast/index.js";
+export { addDeclarationUnique, createDeclaration, createRule, hasDeclaration, printNode, printRules, } from "./css-ast/index.js";
 export { resolveLayerConfig, wrapInLayer } from "./layers/index.js";
 export { buildLightDarkDeclarations, wrapLightDark, } from "./light-dark/index.js";
 export { buildModifierContextCSS, computeModifierContext, getAliasTarget, } from "./modifiers/index.js";
-export { prefixVar, tokenIdToCssVar } from "./naming.js";
-export { canonicalPlugin } from "./plugin.js";
+export { convertTokenIdToCssVar, prefixVar } from "./naming.js";
+export { default as canonicalPlugin } from "./plugin/index.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,IAAI,EACJ,OAAO,EACP,SAAS,EACT,UAAU,EACV,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/layers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/layers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/layers/types.ts"],"names":[],"mappings":""}

package/dist/esm/layers/wrapInLayer.js

@@ -1,14 +1,14 @@
 /**
- * Wrap CSS nodes in an `@layer` rule. Returns nodes unwrapped if `layerName` is null.
+ * Wrap CSS nodes in an `@layer` createRule. Returns nodes unwrapped if `layerName` is null.
  *
- * @example wrapInLayer("ds.tokens", [decl("--x", "1")]) => rule(["@layer ds.tokens"], [...])
- * @example wrapInLayer(null, [decl("--x", "1")]) => [decl("--x", "1")]
+ * @example wrapInLayer("ds.tokens", [createDeclaration("--x", "1")]) => createRule(["@layer ds.tokens"], [...])
+ * @example wrapInLayer(null, [createDeclaration("--x", "1")]) => [createDeclaration("--x", "1")]
  */
-import rule from "../css-ast/rule.js";
+import createRule from "../css-ast/rule.js";
 export default function wrapInLayer(layerName, children) {
     if (layerName === null) {
         return children;
     }
-    return [rule([`@layer ${layerName}`], children)];
+    return [createRule([`@layer ${layerName}`], children)];
 }
 //# sourceMappingURL=wrapInLayer.js.map

package/dist/esm/layers/wrapInLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapInLayer.js","sourceRoot":"","sources":["../../../src/layers/wrapInLayer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAGtC,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,SAAwB,EACxB,QAAmB;IAEnB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"wrapInLayer.js","sourceRoot":"","sources":["../../../src/layers/wrapInLayer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAG5C,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,SAAwB,EACxB,QAAmB;IAEnB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,UAAU,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/esm/light-dark/buildLightDarkDeclarations.js

@@ -6,9 +6,9 @@
  *
  * @returns Array of CSS declaration nodes for the merged values.
  */
-import decl from "../css-ast/decl.js";
+import createDeclaration from "../css-ast/createDeclaration.js";
 import wrapLightDark from "./wrapLightDark.js";
 export default function buildLightDarkDeclarations(pairs) {
-    return pairs.map((pair) => decl(pair.property, wrapLightDark(pair.light, pair.dark)));
+    return pairs.map((pair) => createDeclaration(pair.property, wrapLightDark(pair.light, pair.dark)));
 }
 //# sourceMappingURL=buildLightDarkDeclarations.js.map

package/dist/esm/light-dark/buildLightDarkDeclarations.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildLightDarkDeclarations.js","sourceRoot":"","sources":["../../../src/light-dark/buildLightDarkDeclarations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAEtC,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,KAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"buildLightDarkDeclarations.js","sourceRoot":"","sources":["../../../src/light-dark/buildLightDarkDeclarations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAGhE,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,KAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CACvE,CAAC;AACJ,CAAC"}

package/dist/esm/light-dark/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/light-dark/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/light-dark/types.ts"],"names":[],"mappings":""}

package/dist/esm/modifiers/buildModifierContextCSS.js

@@ -1,11 +1,11 @@
 /**
  * Build CSS nodes for a modifier context (class selector + declarations).
  */
-import rule from "../css-ast/rule.js";
+import createRule from "../css-ast/rule.js";
 export default function buildModifierContextCSS(ctx) {
     if (ctx.declarations.length === 0) {
         return [];
     }
-    return [rule([ctx.selector], ctx.declarations)];
+    return [createRule([ctx.selector], ctx.declarations)];
 }
 //# sourceMappingURL=buildModifierContextCSS.js.map

package/dist/esm/modifiers/buildModifierContextCSS.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildModifierContextCSS.js","sourceRoot":"","sources":["../../../src/modifiers/buildModifierContextCSS.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAGtC,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,GAAoB;IAEpB,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"buildModifierContextCSS.js","sourceRoot":"","sources":["../../../src/modifiers/buildModifierContextCSS.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAI5C,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,GAAoB;IAEpB,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/esm/modifiers/computeModifierContext.js

@@ -14,7 +14,7 @@
  *
  * Alias target resolution uses (in order):
  *   1. `aliasMap` parameter (pre-built from modifier source files)
- *   2. `getAliasTarget()` on the overlay token (DTCG `aliasOf` or `$extensions`)
+ *   2. `getAliasTarget()` on the overlay token (DTCG `aliasOf`)
  *   3. Falls back to the token's own CSS variable (identity)
  *
  * @param family    - Family name (e.g. "anticipation")
@@ -25,8 +25,8 @@
  * @param aliasMap  - Optional map of token ID -> alias target ID (from source files).
  * @returns A `ModifierContext` with computed declarations.
  */
-import decl from "../css-ast/decl.js";
-import { prefixVar, tokenIdToCssVar } from "../naming.js";
+import createDeclaration from "../css-ast/createDeclaration.js";
+import { convertTokenIdToCssVar, prefixVar } from "../naming.js";
 import getAliasTarget from "./getAliasTarget.js";
 /**
  * Detect whether an overlay token shadows its base counterpart.
@@ -59,11 +59,11 @@ export default function computeModifierContext(family, context, baseTokens, over
         if (!isShadowed) {
             continue;
         }
-        const cssVar = tokenIdToCssVar(id);
+        const cssVar = convertTokenIdToCssVar(id);
         const channelVar = prefixVar(cssVar, prefix);
         const target = aliasMap?.[id] ?? getAliasTarget(overlay);
-        const aliasTarget = target ? tokenIdToCssVar(target) : cssVar;
-        declarations.push(decl(channelVar, `var(${aliasTarget})`));
+        const aliasTarget = target ? convertTokenIdToCssVar(target) : cssVar;
+        declarations.push(createDeclaration(channelVar, `var(${aliasTarget})`));
     }
     return {
         family,