@canonical/terrazzo-plugin-css 0.1.0 → 0.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"computeModifierContext.js","sourceRoot":"","sources":["../../../src/modifiers/computeModifierContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAEjD;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAkB,EAAE,OAAqB;IAChE,iDAAiD;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IACD,wDAAwD;IACxD,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,MAAc,EACd,OAAe,EACf,UAAwC,EACxC,aAA2C,EAC3C,MAAM,GAAG,UAAU,EACnB,QAAiC,EACjC,gBAAyB;IAEzB,MAAM,YAAY,GAAG,EAAE,CAAC;IAExB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,kEAAkE;QAClE,MAAM,UAAU,GAAG,QAAQ,IAAI,IAAI,IAAI,EAAE,IAAI,QAAQ,CAAC;QACtD,gEAAgE;QAChE,MAAM,UAAU,GAAG,UAAU,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,WAAW,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,gBAAgB,IAAI,IAAI,OAAO,EAAE;QAC3C,YAAY;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"computeModifierContext.js","sourceRoot":"","sources":["../../../src/modifiers/computeModifierContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAGjD;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAkB,EAAE,OAAqB;IAChE,iDAAiD;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IACD,wDAAwD;IACxD,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,MAAc,EACd,OAAe,EACf,UAAwC,EACxC,aAA2C,EAC3C,MAAM,GAAG,UAAU,EACnB,QAAiC,EACjC,gBAAyB;IAEzB,MAAM,YAAY,GAAG,EAAE,CAAC;IAExB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,kEAAkE;QAClE,MAAM,UAAU,GAAG,QAAQ,IAAI,IAAI,IAAI,EAAE,IAAI,QAAQ,CAAC;QACtD,gEAAgE;QAChE,MAAM,UAAU,GAAG,UAAU,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACrE,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,WAAW,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,gBAAgB,IAAI,IAAI,OAAO,EAAE;QAC3C,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/esm/modifiers/types.js

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

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

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

package/dist/esm/naming.js

@@ -1,8 +1,3 @@
-/**
- * Token ID to CSS custom property name conversion.
- *
- * Dot-to-hyphen with camelCase preserved, `$root` stripped.
- */
 /**
  * Convert a DTCG token ID to a CSS custom property name.
  *
@@ -11,10 +6,10 @@
  * 2. Replace every `.` with `-`
  * 3. Prepend `--`
  *
- * @example tokenIdToCssVar("color.foreground.primary.$root") => "--color-foreground-primary"
- * @example tokenIdToCssVar("typography.heading.1.fontSize") => "--typography-heading-1-fontSize"
+ * @example convertTokenIdToCssVar("color.foreground.primary.$root") => "--color-foreground-primary"
+ * @example convertTokenIdToCssVar("typography.heading.1.fontSize") => "--typography-heading-1-fontSize"
  */
-export function tokenIdToCssVar(id) {
+export function convertTokenIdToCssVar(id) {
     let name = id;
     // Strip terminal .$root (only when it is the last segment)
     if (name.endsWith(".$root")) {

package/dist/esm/naming.js.map

@@ -1 +1 @@
-{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/naming.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,2DAA2D;IAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAAc;IACtD,OAAO,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU;IAC/C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,2DAA2D;IAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAAc;IACtD,OAAO,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC"}

package/dist/esm/plugin/canonicalPlugin.js

@@ -0,0 +1,132 @@
+import { transformCSSValue } from "@terrazzo/token-tools/css";
+import { serializeArtifact } from "../artifact/index.js";
+import { annotateDeclarations } from "../build/annotation.js";
+import buildModifierFamily from "../build/builders/buildModifierFamily.js";
+import buildSetsPrimitive from "../build/builders/buildSetsPrimitive.js";
+import buildSetsSemantic from "../build/builders/buildSetsSemantic.js";
+import buildStates from "../build/builders/buildStates.js";
+import buildSurfaces from "../build/builders/buildSurfaces.js";
+import buildTheme from "../build/builders/buildTheme.js";
+import buildTypography from "../build/builders/buildTypography.js";
+import convertCssValueToString from "../build/builders/convertCssValueToString.js";
+import { isSemanticTypography } from "../build/classification.js";
+import { FORMAT } from "../build/constants/format.js";
+import { isColorTokenLike } from "../build/shims.js";
+import { resolveLayerConfig } from "../layers/index.js";
+import { convertTokenIdToCssVar } from "../naming.js";
+/** Create the Canonical CSS plugin for Terrazzo. */
+export default function canonicalPlugin(options = {}) {
+    const layers = resolveLayerConfig(options.layers);
+    const tokensDir = options.tokensDir ?? "./tokens/canonical";
+    const families = options.families ?? [
+        "anticipation",
+        "criticality",
+        "emphasis",
+        "importance",
+    ];
+    return {
+        name: "@canonical/terrazzo-plugin-css",
+        async transform({ tokens, setTransform, resolver, }) {
+            transformBaseSet(resolver, setTransform);
+            transformDarkTheme(resolver, setTransform);
+            transformTypographyContexts(tokens, resolver, setTransform);
+        },
+        async build({ tokens, getTransforms, resolver, outputFile, }) {
+            const artifact = {};
+            const cssOutputs = new Map();
+            const capture = (file, contents) => {
+                if (typeof contents === "string" && file.endsWith(".css")) {
+                    cssOutputs.set(file, contents);
+                }
+                outputFile(file, contents);
+            };
+            buildSetsPrimitive(getTransforms, layers, artifact, capture);
+            buildSetsSemantic(layers, capture);
+            buildTheme(tokens, getTransforms, resolver, layers, artifact, capture);
+            buildTypography(getTransforms, layers, artifact, capture);
+            for (const family of families) {
+                buildModifierFamily(family, resolver, layers, artifact, capture, tokensDir);
+            }
+            buildSurfaces(resolver, layers, artifact, capture, tokensDir);
+            buildStates(tokens, resolver, layers, artifact, capture);
+            annotateDeclarations(artifact, cssOutputs);
+            outputFile("tokens.json", serializeArtifact(artifact));
+        },
+    };
+}
+function transformBaseSet(resolver, setTransform) {
+    const baseSet = resolver.apply({});
+    for (const [id] of Object.entries(baseSet)) {
+        const cssVar = convertTokenIdToCssVar(id);
+        const value = transformCSSValue(baseSet[id], {
+            tokensSet: baseSet,
+            permutation: {},
+        });
+        const stringValue = convertCssValueToString(value);
+        if (stringValue !== null) {
+            setTransform(id, { format: FORMAT, localID: cssVar, value: stringValue });
+        }
+        else {
+            setTransform(id, {
+                format: FORMAT,
+                localID: cssVar,
+                value: value,
+            });
+        }
+    }
+}
+function transformDarkTheme(resolver, setTransform) {
+    const darkSet = resolver.apply({ theme: "dark" });
+    for (const [id, token] of Object.entries(darkSet)) {
+        if (!isColorTokenLike(token)) {
+            continue;
+        }
+        const cssVar = convertTokenIdToCssVar(id);
+        const value = transformCSSValue(token, {
+            tokensSet: darkSet,
+            permutation: { theme: "dark" },
+        });
+        const stringValue = convertCssValueToString(value);
+        if (stringValue !== null) {
+            setTransform(id, {
+                format: FORMAT,
+                localID: cssVar,
+                value: stringValue,
+                input: { theme: "dark" },
+            });
+        }
+    }
+}
+function transformTypographyContexts(tokens, resolver, setTransform) {
+    for (const context of ["apps", "docs", "sites"]) {
+        const typographySet = resolver.apply({ typography: context });
+        for (const [id] of Object.entries(typographySet)) {
+            if (!isSemanticTypography(id) || !(id in tokens)) {
+                continue;
+            }
+            const cssVar = convertTokenIdToCssVar(id);
+            const value = transformCSSValue(typographySet[id], {
+                tokensSet: typographySet,
+                permutation: { typography: context },
+            });
+            const stringValue = convertCssValueToString(value);
+            if (stringValue !== null) {
+                setTransform(id, {
+                    format: FORMAT,
+                    localID: cssVar,
+                    value: stringValue,
+                    input: { typography: context },
+                });
+            }
+            else {
+                setTransform(id, {
+                    format: FORMAT,
+                    localID: cssVar,
+                    value: value,
+                    input: { typography: context },
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=canonicalPlugin.js.map

package/dist/esm/plugin/canonicalPlugin.js.map

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

package/dist/esm/plugin/index.js

@@ -0,0 +1,6 @@
+/**
+ * @module
+ * Public plugin exports.
+ */
+export { default } from "./canonicalPlugin.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/plugin/src/artifact/classifyTier.js

@@ -0,0 +1,7 @@
+export default function classifyTier(_tokenId, setName) {
+    if (setName === "primitive") {
+        return "primitive";
+    }
+    return "semantic";
+}
+//# sourceMappingURL=classifyTier.js.map

package/dist/esm/plugin/src/artifact/classifyTier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyTier.js","sourceRoot":"","sources":["../../../../../src/artifact/classifyTier.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,QAAgB,EAChB,OAA2B;IAE3B,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/esm/plugin/src/artifact/index.js

@@ -0,0 +1,5 @@
+export { default as classifyTier } from "./classifyTier.js";
+export { default as makeArtifactToken } from "./makeArtifactToken.js";
+export { default as makeDerivedArtifactToken } from "./makeDerivedArtifactToken.js";
+export { default as serializeArtifact } from "./serializeArtifact.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/plugin/src/artifact/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/artifact/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/esm/plugin/src/artifact/makeArtifactToken.js

@@ -0,0 +1,36 @@
+export default function makeArtifactToken(params) {
+    const isPaired = params.valueLight !== undefined &&
+        params.valueDark !== undefined &&
+        params.valueLight !== params.valueDark;
+    const token = {
+        cssVar: params.cssVar,
+        id: params.id,
+        type: params.type,
+        tier: params.tier,
+        isPaired,
+        cssOutputFile: params.cssOutputFile,
+    };
+    if (params.description !== undefined) {
+        token.description = params.description;
+    }
+    if (params.declarations !== undefined && params.declarations.length > 0) {
+        token.declarations = params.declarations;
+    }
+    if (params.aliasChain !== undefined) {
+        token.aliasChain = params.aliasChain;
+    }
+    if (params.valueLight !== undefined) {
+        token.valueLight = params.valueLight;
+    }
+    if (params.valueDark !== undefined) {
+        token.valueDark = params.valueDark;
+    }
+    if (params.sourceFile !== undefined) {
+        token.sourceFile = params.sourceFile;
+    }
+    if (params.sourceLine !== undefined) {
+        token.sourceLine = params.sourceLine;
+    }
+    return token;
+}
+//# sourceMappingURL=makeArtifactToken.js.map

package/dist/esm/plugin/src/artifact/makeArtifactToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeArtifactToken.js","sourceRoot":"","sources":["../../../../../src/artifact/makeArtifactToken.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,MAAyB;IAEzB,MAAM,QAAQ,GACZ,MAAM,CAAC,UAAU,KAAK,SAAS;QAC/B,MAAM,CAAC,SAAS,KAAK,SAAS;QAC9B,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,SAAS,CAAC;IAEzC,MAAM,KAAK,GAAkB;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ;QACR,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC3C,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/plugin/src/artifact/makeDerivedArtifactToken.js

@@ -0,0 +1,29 @@
+export default function makeDerivedArtifactToken(params) {
+    const isPaired = params.valueLight !== undefined &&
+        params.valueDark !== undefined &&
+        params.valueLight !== params.valueDark;
+    const token = {
+        cssVar: params.cssVar,
+        id: null,
+        type: params.type,
+        tier: params.tier,
+        isPaired,
+        cssOutputFile: params.cssOutputFile,
+        derivedFrom: params.derivedFrom,
+        derivation: params.derivation,
+    };
+    if (params.description !== undefined) {
+        token.description = params.description;
+    }
+    if (params.declarations !== undefined && params.declarations.length > 0) {
+        token.declarations = params.declarations;
+    }
+    if (params.valueLight !== undefined) {
+        token.valueLight = params.valueLight;
+    }
+    if (params.valueDark !== undefined) {
+        token.valueDark = params.valueDark;
+    }
+    return token;
+}
+//# sourceMappingURL=makeDerivedArtifactToken.js.map

package/dist/esm/plugin/src/artifact/makeDerivedArtifactToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeDerivedArtifactToken.js","sourceRoot":"","sources":["../../../../../src/artifact/makeDerivedArtifactToken.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,MAAgC;IAEhC,MAAM,QAAQ,GACZ,MAAM,CAAC,UAAU,KAAK,SAAS;QAC/B,MAAM,CAAC,SAAS,KAAK,SAAS;QAC9B,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,SAAS,CAAC;IAEzC,MAAM,KAAK,GAAkB;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ;QACR,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC3C,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/plugin/src/artifact/serializeArtifact.js

@@ -0,0 +1,4 @@
+export default function serializeArtifact(artifact) {
+    return JSON.stringify(artifact, null, 2);
+}
+//# sourceMappingURL=serializeArtifact.js.map

package/dist/esm/plugin/src/artifact/serializeArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeArtifact.js","sourceRoot":"","sources":["../../../../../src/artifact/serializeArtifact.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,QAAkB;IAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/esm/plugin/src/artifact/types.js

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

package/dist/esm/plugin/src/artifact/types.js.map

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

package/dist/esm/plugin/src/build/annotation.js

@@ -0,0 +1,70 @@
+/**
+ * Scan CSS output strings and annotate artifact tokens with their
+ * declaration sites (selector, file, line).
+ *
+ * Parses each CSS file to find custom property declarations (`--var: ...`)
+ * and records the enclosing selector and line number. Tokens appearing in
+ * multiple selectors (e.g. modifier channels in `.warning`, `.error`, etc.)
+ * accumulate all their declaration sites.
+ *
+ * @note impure: mutates artifact token entries in-place (adds declaration arrays).
+ */
+export function annotateDeclarations(artifact, cssOutputs) {
+    for (const [file, css] of cssOutputs) {
+        const lines = css.split("\n");
+        const selectorStack = [];
+        const atRuleStack = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const trimmed = line.trim();
+            // Track selector entries: line ending with `{`
+            if (trimmed.endsWith("{")) {
+                const selector = trimmed.slice(0, -1).trim();
+                if (selector.startsWith("@")) {
+                    // at-rule — parse name and prelude, keep current selector
+                    const atMatch = selector.match(/^@(\w+)\s*(.*)/);
+                    const atRule = atMatch
+                        ? { name: atMatch[1], prelude: atMatch[2] }
+                        : { name: selector.slice(1), prelude: "" };
+                    const parentAtRules = atRuleStack[atRuleStack.length - 1] ?? [];
+                    atRuleStack.push([...parentAtRules, atRule]);
+                    selectorStack.push(selectorStack[selectorStack.length - 1] ?? ":root");
+                }
+                else {
+                    atRuleStack.push(atRuleStack[atRuleStack.length - 1] ?? []);
+                    selectorStack.push(selector);
+                }
+                continue;
+            }
+            // Track block exits
+            if (trimmed === "}") {
+                selectorStack.pop();
+                atRuleStack.pop();
+                continue;
+            }
+            // Match custom property declarations
+            const m = trimmed.match(/^(--[\w-]+)\s*:/);
+            if (!m)
+                continue;
+            const cssVar = m[1];
+            const entry = artifact[cssVar];
+            if (!entry)
+                continue;
+            const selector = selectorStack[selectorStack.length - 1] ?? ":root";
+            const currentAtRules = atRuleStack[atRuleStack.length - 1] ?? [];
+            const declSite = {
+                selector,
+                file,
+                line: i,
+                ...(currentAtRules.length > 0 ? { atRules: currentAtRules } : {}),
+            };
+            if (entry.declarations) {
+                entry.declarations.push(declSite);
+            }
+            else {
+                entry.declarations = [declSite];
+            }
+        }
+    }
+}
+//# sourceMappingURL=annotation.js.map

package/dist/esm/plugin/src/build/annotation.js.map

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

package/dist/esm/plugin/src/build/buildModifiers.js

@@ -0,0 +1,114 @@
+/**
+ * Build helpers for modifiers.{family}.css and modifiers.surfaces.css.
+ */
+import { makeDerivedArtifactToken } from "../artifact/index.js";
+import { printRules } from "../css-ast/index.js";
+import { wrapInLayer } from "../layers/index.js";
+import { buildModifierContextCSS, computeModifierContext, } from "../modifiers/index.js";
+import { convertTokenIdToCssVar, prefixVar } from "../naming.js";
+import { HEADER } from "./buildPrimitive.js";
+import { loadModifierData } from "./modifierIo.js";
+// ---------------------------------------------------------------------------
+// Description lookup helper
+// ---------------------------------------------------------------------------
+/**
+ * Build a map from channel CSS variable to description.
+ *
+ * Converts token IDs (e.g. `color.foreground.primary`) into their
+ * channel CSS var form (e.g. `--modifier-color-foreground-primary`)
+ * and maps each to its description.
+ */
+export function buildDescriptionLookup(descriptions, prefix) {
+    const lookup = {};
+    for (const [tokenId, desc] of Object.entries(descriptions)) {
+        const channelVar = prefixVar(convertTokenIdToCssVar(tokenId), prefix);
+        lookup[channelVar] = desc;
+    }
+    return lookup;
+}
+// ---------------------------------------------------------------------------
+// Surface selector map
+// ---------------------------------------------------------------------------
+/**
+ * Surface selector compounding: map resolver context names to compound
+ * `.surface` descendant selectors based on depth.
+ */
+export const SURFACE_SELECTOR_MAP = {
+    layer1: ".surface",
+    layer2: ".surface .surface",
+    layer3: ".surface .surface .surface",
+};
+// ---------------------------------------------------------------------------
+// Family build
+// ---------------------------------------------------------------------------
+/** @note Mutates `artifact`, calls `outputFile` and `loadModifierData` (file I/O). */
+export function buildFamily(family, resolver, layers, artifact, outputFile, tokensDir) {
+    const baseTokens = resolver.apply({});
+    const modifiers = resolver.source?.modifiers;
+    const familyMod = modifiers?.[family];
+    if (!familyMod?.contexts)
+        return;
+    const allNodes = [];
+    for (const context of Object.keys(familyMod.contexts)) {
+        if (context === "none")
+            continue; // skip the empty default context
+        const { aliases: aliasMap, descriptions } = loadModifierData(tokensDir, family, context);
+        const overlayTokens = resolver.apply({ [family]: context });
+        // Build channel-var → description lookup
+        const descByChannelVar = buildDescriptionLookup(descriptions, "modifier");
+        const ctx = computeModifierContext(family, context, baseTokens, overlayTokens, "modifier", aliasMap);
+        const nodes = buildModifierContextCSS(ctx);
+        allNodes.push(...nodes);
+        // Register channel declarations in artifact
+        for (const d of ctx.declarations) {
+            artifact[d.property] = makeDerivedArtifactToken({
+                cssVar: d.property,
+                type: "color",
+                tier: "semantic",
+                cssOutputFile: `modifiers.${family}.css`,
+                derivedFrom: d.value.replace(/^var\(/, "").replace(/\)$/, ""),
+                derivation: "channel-modifier",
+                description: descByChannelVar[d.property],
+            });
+        }
+    }
+    const wrapped = wrapInLayer(layers.modifiers, allNodes);
+    outputFile(`modifiers.${family}.css`, `${HEADER}\n${printRules(wrapped)}\n`);
+}
+// ---------------------------------------------------------------------------
+// Surfaces build
+// ---------------------------------------------------------------------------
+/** @note Mutates `artifact`, calls `outputFile` and `loadModifierData` (file I/O). */
+export function buildSurfaces(resolver, layers, artifact, outputFile, tokensDir) {
+    const baseTokens = resolver.apply({});
+    const modifiers = resolver.source?.modifiers;
+    const surfaceMod = modifiers?.surface;
+    if (!surfaceMod?.contexts)
+        return;
+    const allNodes = [];
+    for (const context of Object.keys(surfaceMod.contexts)) {
+        if (context === "none")
+            continue; // skip the empty default context
+        const { aliases: aliasMap, descriptions } = loadModifierData(tokensDir, "surface", context);
+        const overlayTokens = resolver.apply({ surface: context });
+        // Build channel-var → description lookup
+        const descByChannelVar = buildDescriptionLookup(descriptions, "surface");
+        const ctx = computeModifierContext("surface", context, baseTokens, overlayTokens, "surface", aliasMap, SURFACE_SELECTOR_MAP[context]);
+        const nodes = buildModifierContextCSS(ctx);
+        allNodes.push(...nodes);
+        for (const d of ctx.declarations) {
+            artifact[d.property] = makeDerivedArtifactToken({
+                cssVar: d.property,
+                type: "color",
+                tier: "semantic",
+                cssOutputFile: "modifiers.surfaces.css",
+                derivedFrom: d.value.replace(/^var\(/, "").replace(/\)$/, ""),
+                derivation: "channel-surface",
+                description: descByChannelVar[d.property],
+            });
+        }
+    }
+    const wrapped = wrapInLayer(layers.surfaces, allNodes);
+    outputFile("modifiers.surfaces.css", `${HEADER}\n${printRules(wrapped)}\n`);
+}
+//# sourceMappingURL=buildModifiers.js.map

package/dist/esm/plugin/src/build/buildModifiers.js.map

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

package/dist/esm/plugin/src/build/buildPrimitive.js

@@ -0,0 +1,78 @@
+import { makeArtifactToken } from "../artifact/index.js";
+import { createDecl, createRule, printRules } from "../css-ast/index.js";
+import { wrapInLayer } from "../layers/index.js";
+import { convertTokenIdToCssVar } from "../naming.js";
+import { isPrimitive } from "./classification.js";
+/** Plugin output format identifier. */
+const FORMAT = "canonical-css";
+const HEADER = "/* Generated by @canonical/terrazzo-plugin-css. DO NOT EDIT. */";
+/**
+ * Convert a Terrazzo CSS value (string or multi-value record) to a plain string.
+ * Returns `null` for multi-value composites (typography).
+ */
+export function convertCssValueToString(val) {
+    if (typeof val === "string")
+        return val;
+    if ("." in val)
+        return val["."]; // WideGamutColorValue sRGB fallback
+    return null; // multi-value (typography)
+}
+/** @note Mutates `artifact`, calls `outputFile`. */
+export function buildSetsPrimitive(getTransforms, layers, artifact, outputFile) {
+    const transforms = getTransforms({ format: FORMAT });
+    const nodes = [];
+    for (const t of transforms) {
+        if (!isPrimitive(t.id))
+            continue;
+        if (t.id.startsWith("number."))
+            continue;
+        // Skip dark / per-product permutations — only use the base
+        if (t.input &&
+            Object.keys(t.input).some((k) => k === "theme" && t.input[k] !== "light"))
+            continue;
+        if (t.input && "typography" in t.input && t.input.typography !== "global")
+            continue;
+        const cssVar = t.localID ?? convertTokenIdToCssVar(t.id);
+        if (t.type === "SINGLE_VALUE") {
+            nodes.push(createDecl(cssVar, t.value));
+            artifact[cssVar] = makeArtifactToken({
+                cssVar,
+                id: t.id,
+                type: t.token.$type ?? "unknown",
+                tier: "primitive",
+                cssOutputFile: "sets.primitive.css",
+                description: t.token.$description,
+                valueLight: t.value,
+                valueDark: t.value,
+            });
+        }
+        else {
+            // Multi-value — emit each sub-property
+            for (const [suffix, val] of Object.entries(t.value)) {
+                const subVar = `${cssVar}-${suffix}`;
+                nodes.push(createDecl(subVar, val));
+                artifact[subVar] = makeArtifactToken({
+                    cssVar: subVar,
+                    id: `${t.id}.${suffix}`,
+                    type: t.token.$type ?? "unknown",
+                    tier: "primitive",
+                    cssOutputFile: "sets.primitive.css",
+                    description: t.token.$description,
+                    valueLight: val,
+                    valueDark: val,
+                });
+            }
+        }
+    }
+    const wrapped = wrapInLayer(layers.tokens, [createRule([":root"], nodes)]);
+    outputFile("sets.primitive.css", `${HEADER}\n${printRules(wrapped)}\n`);
+}
+/** @note Calls `outputFile`. */
+export function buildSetsSemantic(_layers, outputFile) {
+    // In V2, most semantic tokens come via modifier contexts (theme, typography).
+    // This file may be empty.  Emit a comment-only placeholder.
+    const comment = "/* sets.semantic.css — no mode-invariant semantic tokens in V2. */";
+    outputFile("sets.semantic.css", `${HEADER}\n${comment}\n`);
+}
+export { FORMAT, HEADER };
+//# sourceMappingURL=buildPrimitive.js.map

package/dist/esm/plugin/src/build/buildPrimitive.js.map

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