@canonical/terrazzo-plugin-css 0.0.1

package/README.md

@@ -0,0 +1,49 @@
+# @canonical/terrazzo-plugin-css
+
+Terrazzo CSS plugin for Canonical design tokens. Transforms DTCG token definitions into CSS custom properties.
+
+## Features
+
+- CSS `light-dark()` colour mode output
+- Modifier families (criticality, emphasis, importance, surface, typography)
+- `@layer` ordering
+- `@media` query scoping for mode variants
+
+## Installation
+
+```bash
+bun add -d @canonical/terrazzo-plugin-css
+```
+
+## Usage
+
+Add the plugin to your `terrazzo.config.ts`:
+
+```ts
+import { defineConfig } from "@terrazzo/cli";
+import { canonicalPlugin } from "@canonical/terrazzo-plugin-css";
+
+export default defineConfig({
+  tokens: ["./tokens/canonical/canonical.resolver.json"],
+  outDir: "./dist/",
+  plugins: [canonicalPlugin()],
+});
+```
+
+## Configuration
+
+`canonicalPlugin()` accepts an options object:
+
+```ts
+canonicalPlugin({
+  tokensDir: "./tokens/canonical",  // Base directory for token sources
+});
+```
+
+## Development
+
+```bash
+bun run build     # Compile plugin (tsc)
+bun run test      # Run tests
+bun run check     # Lint + type check
+```

package/dist/esm/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/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/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/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/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/artifact/makeArtifactToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeArtifactToken.js","sourceRoot":"","sources":["../../../src/artifact/makeArtifactToken.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAazC;IACC,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/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/artifact/makeDerivedArtifactToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeDerivedArtifactToken.js","sourceRoot":"","sources":["../../../src/artifact/makeDerivedArtifactToken.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,MAWhD;IACC,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/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/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/css-ast/addDeclUnique.js

@@ -0,0 +1,7 @@
+import hasDecl from "./hasDecl.js";
+export default function addDeclUnique(list, declaration) {
+    if (!hasDecl(list, declaration.property)) {
+        list.push(declaration);
+    }
+}
+//# sourceMappingURL=addDeclUnique.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addDeclUnique.js","sourceRoot":"","sources":["../../../src/css-ast/addDeclUnique.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,IAAe,EACf,WAA2B;IAE3B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hasDecl.js","sourceRoot":"","sources":["../../../src/css-ast/hasDecl.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAe,EAAE,QAAgB;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAC/E,CAAC"}

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

@@ -0,0 +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 printNode } from "./printNode.js";
+export { default as printRules } from "./printRules.js";
+export { default as rule } from "./rule.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,28 @@
+export default function printNode(node, { indentChar, indentLv }) {
+    const indent = indentChar.repeat(indentLv);
+    if (node.type === "Declaration") {
+        let out = "";
+        if (node.comment) {
+            out += `${indent}/* ${node.comment} */\n`;
+        }
+        out += `${indent}${node.property}: ${node.value};\n`;
+        return out;
+    }
+    // Rule — skip if empty prelude or children
+    if (!node.prelude.length || !node.children.length) {
+        return "";
+    }
+    let childOutput = "";
+    for (const child of node.children) {
+        childOutput += printNode(child, { indentChar, indentLv: indentLv + 1 });
+    }
+    if (!childOutput.trim()) {
+        return "";
+    }
+    let out = "";
+    out += `${indent}${node.prelude.join(`,\n${indent}`)} {\n`;
+    out += childOutput;
+    out += `${indent}}\n`;
+    return out;
+}
+//# sourceMappingURL=printNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"printNode.js","sourceRoot":"","sources":["../../../src/css-ast/printNode.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,IAAa,EACb,EAAE,UAAU,EAAE,QAAQ,EAA4C;IAElE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAChC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,IAAI,GAAG,MAAM,MAAM,IAAI,CAAC,OAAO,OAAO,CAAC;QAC5C,CAAC;QACD,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC;QACrD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,WAAW,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,MAAM,CAAC;IAC3D,GAAG,IAAI,WAAW,CAAC;IACnB,GAAG,IAAI,GAAG,MAAM,KAAK,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,13 @@
+import printNode from "./printNode.js";
+export default function printRules(nodes, opts = {}) {
+    const { indentChar = "\t", indentLv = 0 } = opts;
+    let output = "";
+    for (const node of nodes) {
+        if (output && node.type === "Rule") {
+            output += "\n";
+        }
+        output += printNode(node, { indentChar, indentLv });
+    }
+    return output.trimEnd();
+}
+//# sourceMappingURL=printRules.js.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

package/dist/esm/index.js

@@ -0,0 +1,14 @@
+/**
+ * @canonical/terrazzo-plugin-css-v2
+ *
+ * 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 { 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";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +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"}

package/dist/esm/layers/index.js

@@ -0,0 +1,3 @@
+export { default as resolveLayerConfig } from "./resolveLayerConfig.js";
+export { default as wrapInLayer } from "./wrapInLayer.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/layers/resolveLayerConfig.js

@@ -0,0 +1,10 @@
+const DEFAULT_LAYERS = {
+    tokens: "ds.tokens",
+    modifiers: "ds.modifiers",
+    surfaces: "ds.surfaces",
+    states: "ds.states",
+};
+export default function resolveLayerConfig(partial) {
+    return { ...DEFAULT_LAYERS, ...partial };
+}
+//# sourceMappingURL=resolveLayerConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLayerConfig.js","sourceRoot":"","sources":["../../../src/layers/resolveLayerConfig.ts"],"names":[],"mappings":"AAKA,MAAM,cAAc,GAAwB;IAC1C,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,OAAsC;IAEtC,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/layers/wrapInLayer.js

@@ -0,0 +1,14 @@
+/**
+ * Wrap CSS nodes in an `@layer` rule. 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")]
+ */
+import rule from "../css-ast/rule.js";
+export default function wrapInLayer(layerName, children) {
+    if (layerName === null) {
+        return children;
+    }
+    return [rule([`@layer ${layerName}`], children)];
+}
+//# sourceMappingURL=wrapInLayer.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+/**
+ * Build paired `light-dark()` declarations from parallel light/dark token arrays.
+ *
+ * Matches tokens by CSS variable name, produces a `LightDarkPair[]`
+ * and generates CSS declaration nodes.
+ *
+ * @returns Array of CSS declaration nodes for the merged values.
+ */
+import decl from "../css-ast/decl.js";
+import wrapLightDark from "./wrapLightDark.js";
+export default function buildLightDarkDeclarations(pairs) {
+    return pairs.map((pair) => decl(pair.property, wrapLightDark(pair.light, pair.dark)));
+}
+//# sourceMappingURL=buildLightDarkDeclarations.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+export { default as buildLightDarkDeclarations } from "./buildLightDarkDeclarations.js";
+export { default as wrapLightDark } from "./wrapLightDark.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/light-dark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Wrap two values in `light-dark()`. Returns the plain value if both are identical.
+ *
+ * @example wrapLightDark("oklch(0.5 0.1 200)", "oklch(0.8 0.1 200)") => "light-dark(oklch(0.5 0.1 200), oklch(0.8 0.1 200))"
+ * @example wrapLightDark("#000", "#000") => "#000"
+ */
+export default function wrapLightDark(light, dark) {
+    if (light === dark) {
+        return light;
+    }
+    return `light-dark(${light}, ${dark})`;
+}
+//# sourceMappingURL=wrapLightDark.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrapLightDark.js","sourceRoot":"","sources":["../../../src/light-dark/wrapLightDark.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY;IAC/D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,cAAc,KAAK,KAAK,IAAI,GAAG,CAAC;AACzC,CAAC"}

package/dist/esm/modifiers/buildModifierContextCSS.js

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

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

@@ -0,0 +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"}

package/dist/esm/modifiers/computeModifierContext.js

@@ -0,0 +1,75 @@
+/**
+ * Compute modifier channel declarations for a single family context.
+ *
+ * Shadow detection uses THREE strategies (tried in order):
+ *   1. **Alias map** — if the token ID exists in `aliasMap`, the source file
+ *      explicitly declares it as an override. This is the primary strategy
+ *      because Terrazzo's resolver normalises `source.loc` to the resolver
+ *      file URL and `destructiveMerge` can fail to override `$value` when
+ *      the token structure uses `$root` at different nesting levels.
+ *   2. **Value comparison** — if `$value` differs between base and overlay
+ *      (deep equality via JSON serialization).
+ *   3. **Source location comparison** — legacy fallback for unit tests that
+ *      don't populate `$value` or `aliasMap`.
+ *
+ * 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`)
+ *   3. Falls back to the token's own CSS variable (identity)
+ *
+ * @param family    - Family name (e.g. "anticipation")
+ * @param context   - Context name (e.g. "constructive")
+ * @param baseTokens  - Base-resolution token map (from `resolver.apply({})`)
+ * @param overlayTokens - Context-resolution token map
+ * @param prefix    - CSS variable prefix (default: "modifier"). Use "surface" for surface layers.
+ * @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 getAliasTarget from "./getAliasTarget.js";
+/**
+ * Detect whether an overlay token shadows its base counterpart.
+ *
+ * Uses value comparison when both tokens have `$value`, otherwise
+ * falls back to source location comparison for backward compatibility.
+ */
+function isShadowedToken(base, overlay) {
+    // Primary: compare $value via JSON serialization
+    if (base.$value !== undefined && overlay.$value !== undefined) {
+        return JSON.stringify(base.$value) !== JSON.stringify(overlay.$value);
+    }
+    // Fallback: source location comparison (for unit tests)
+    if (base.source?.loc !== undefined || overlay.source?.loc !== undefined) {
+        return base.source?.loc !== overlay.source?.loc;
+    }
+    return false;
+}
+export default function computeModifierContext(family, context, baseTokens, overlayTokens, prefix = "modifier", aliasMap, selectorOverride) {
+    const declarations = [];
+    for (const [id, overlay] of Object.entries(overlayTokens)) {
+        const base = baseTokens[id];
+        if (!base) {
+            continue;
+        }
+        // Primary: alias map declares this token as explicitly overridden
+        const inAliasMap = aliasMap != null && id in aliasMap;
+        // Fallback: value or loc comparison for tokens not in alias map
+        const isShadowed = inAliasMap || isShadowedToken(base, overlay);
+        if (!isShadowed) {
+            continue;
+        }
+        const cssVar = tokenIdToCssVar(id);
+        const channelVar = prefixVar(cssVar, prefix);
+        const target = aliasMap?.[id] ?? getAliasTarget(overlay);
+        const aliasTarget = target ? tokenIdToCssVar(target) : cssVar;
+        declarations.push(decl(channelVar, `var(${aliasTarget})`));
+    }
+    return {
+        family,
+        context,
+        selector: selectorOverride ?? `.${context}`,
+        declarations,
+    };
+}
+//# sourceMappingURL=computeModifierContext.js.map

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

@@ -0,0 +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"}

package/dist/esm/modifiers/getAliasTarget.js

@@ -0,0 +1,10 @@
+export default function getAliasTarget(token) {
+    if (token.aliasOf)
+        return token.aliasOf;
+    const ext = token.$extensions?.["com.canonical.modifier"];
+    if (ext && typeof ext === "object" && "aliasOf" in ext) {
+        return ext.aliasOf;
+    }
+    return undefined;
+}
+//# sourceMappingURL=getAliasTarget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAliasTarget.js","sourceRoot":"","sources":["../../../src/modifiers/getAliasTarget.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,KAAmB;IAEnB,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACxC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,wBAAwB,CAAC,CAAC;IAC1D,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACvD,OAAQ,GAA2B,CAAC,OAAO,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/modifiers/index.js

@@ -0,0 +1,4 @@
+export { default as buildModifierContextCSS } from "./buildModifierContextCSS.js";
+export { default as computeModifierContext } from "./computeModifierContext.js";
+export { default as getAliasTarget } from "./getAliasTarget.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modifiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/naming.js

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ *
+ * Rules:
+ * 1. Strip the `.$root` terminal if present
+ * 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"
+ */
+export function tokenIdToCssVar(id) {
+    let name = id;
+    // Strip terminal .$root (only when it is the last segment)
+    if (name.endsWith(".$root")) {
+        name = name.slice(0, -6);
+    }
+    return `--${name.replaceAll(".", "-")}`;
+}
+/**
+ * Add a channel prefix to a CSS variable name.
+ *
+ * @example prefixVar("--color-foreground-primary", "modifier") => "--modifier-color-foreground-primary"
+ */
+export function prefixVar(cssVar, prefix) {
+    return `--${prefix}-${cssVar.slice(2)}`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/esm/naming.js.map

@@ -0,0 +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"}