@terrazzo/plugin-css 2.4.0 → 2.6.0

package/dist/index.js

@@ -1,746 +1,51 @@
-import { generateShorthand, makeCSSVar, transformCSSValue } from "@terrazzo/token-tools/css";
-import { CachedWildcardMatcher, kebabCase } from "@terrazzo/token-tools";
-//#region src/lib.ts
-const PLUGIN_NAME = "@terrazzo/plugin-css";
-const FORMAT_ID = "css";
-const cachedMatcher = new CachedWildcardMatcher();
-const FILE_PREFIX = `/* -------------------------------------------
- *  Autogenerated by ⛋ Terrazzo. DO NOT EDIT!
- * ------------------------------------------- */`;
-/**
-* Convert CSSRules into a formatted, indented CSS string.
-* The reason we’re using this homemade version instead of something like css-tree is:
-*
-* 1. css-tree doesn’t support comments :(
-* 2. we are only generating PARTIALS, not full CSS (the user controls the
-*    wrapper). So with a proper AST, we’d be hacking it a little anyway because
-*    we never really have a true, valid, finalized document.
-* 3. we want @terrazzo/plugin-css to run in the browser AND be lean (i.e. don’t
-*    load Prettier or 25MB of wasm).
-* 4. we only have to deal with a small subset of CSS—this doesn’t have to be robust
-*    by any means (even future additions won’t push the limits of the spec).
-*/
-function printRules(nodes, { indentChar = "  ", indentLv = 0, alphabetize = true } = {}) {
-	let output = "";
-	const sortedNodes = [...nodes];
-	if (alphabetize) sortedNodes.sort((a, b) => {
-		if (a.type === "Declaration" && b.type === "Declaration") return a.property.localeCompare(b.property, "en-us", { numeric: true });
-		return 0;
-	});
-	for (const node of sortedNodes) {
-		if (output && node.type === "Rule") output += "\n";
-		output += printNode(node, {
-			indentChar,
-			indentLv
-		});
-	}
-	return output.trim();
+import buildCSS from './build.js';
+import { FILE_PREFIX, PLUGIN_NAME } from './lib.js';
+import transformCSS from './transform.js';
+export * from './build.js';
+export { FILE_PREFIX, FORMAT_ID, PLUGIN_NAME, printNode, printRules, } from './lib.js';
+export * from './transform.js';
+export * from './utility-css.js';
+/* oxlint-disable require-await */
+export default function cssPlugin(options) {
+    const { utility, skipBuild, baseScheme, propertyDefinitions } = options ?? {};
+    const filename = options?.filename ?? options?.fileName ?? 'index.css';
+    const baseSelector = options?.baseSelector ?? ':root';
+    return {
+        name: PLUGIN_NAME,
+        config(_config, context) {
+            if (options?.permutations &&
+                (options?.modeSelectors || options?.baseSelector || options?.baseScheme)) {
+                context.logger.error({
+                    group: 'plugin',
+                    label: PLUGIN_NAME,
+                    message: 'Permutations option is incompatible with modeSelectors, baseSelector, and baseScheme.',
+                });
+            }
+        },
+        async transform(transformOptions) {
+            transformCSS({ transform: transformOptions, options: options ?? {} });
+        },
+        async build({ getTransforms, outputFile, context }) {
+            if (skipBuild === true) {
+                return;
+            }
+            let contents = `${FILE_PREFIX}\n\n`;
+            contents += buildCSS({
+                include: options?.include,
+                exclude: options?.exclude,
+                getTransforms,
+                permutations: options?.permutations,
+                modeSelectors: options?.modeSelectors,
+                utility,
+                baseSelector,
+                baseScheme,
+                propertyDefinitions: propertyDefinitions ?? false,
+                logger: context.logger,
+                omitTypographyShorthand: options?.omitTypographyShorthand,
+                subValueVariableName: options?.subValueVariableName,
+            });
+            outputFile(filename, contents.replace(/\n*$/, '\n'));
+        },
+    };
 }
-/** Internal printer for individual nodes */
-function printNode(node, { indentChar, indentLv }) {
-	let output = "";
-	const indent = indentChar.repeat(indentLv);
-	if (node.type === "Declaration") {
-		if (node.comment) output += `${indent}/* ${node.comment} */\n`;
-		output += `${indent}${node.property}: ${node.value};\n`;
-		return output;
-	}
-	if (!node.prelude.length || !node.children.length) return output;
-	const mediaQueryWithDecls = node.children.some((s) => s.type === "Declaration") ? node.prelude.find((s) => s.startsWith("@media")) : void 0;
-	if (mediaQueryWithDecls) {
-		const nonMedia = node.prelude.filter((s) => s !== mediaQueryWithDecls);
-		output += `${indent}${mediaQueryWithDecls} {\n`;
-		output += printNode(rule([":root"], node.children), {
-			indentChar,
-			indentLv: indentLv + 1
-		});
-		output += `${indent}}\n\n`;
-		output += printNode(rule(nonMedia, node.children), {
-			indentChar,
-			indentLv
-		});
-		return output;
-	}
-	let childOutput = "";
-	for (const child of node.children) childOutput += printNode(child, {
-		indentChar,
-		indentLv: indentLv + 1
-	});
-	childOutput = childOutput.trim();
-	if (!childOutput) return output;
-	output += `${indent}${node.prelude.join(", ")} {\n`;
-	output += `${indentChar.repeat(indentLv + 1)}${childOutput}\n`;
-	output += `${indent}}\n`;
-	return output;
-}
-/** Infer indentation preferences from a user-defined wrapping method. */
-function getIndentFromPrepare(prepare) {
-	const str = "//css//";
-	const output = prepare(str).replace(/\/\*.*\*\//g, "");
-	let indentChar = "  ";
-	let indentLv = 0;
-	let lineStartChar = 0;
-	for (let i = 0; i < output.length; i++) if (output[i] === "{") {
-		lineStartChar = i + 1;
-		indentLv++;
-	} else if (output[i] === "}") indentLv--;
-	else if (output[i] === "\n") lineStartChar = i + 1;
-	else if (output[i] === str[0] && output.slice(i).startsWith(str)) {
-		indentChar = output.slice(lineStartChar, i);
-		indentChar = indentChar.slice(0, Math.floor(indentChar.length / indentLv));
-		break;
-	}
-	return {
-		indentChar: indentChar || "  ",
-		indentLv
-	};
-}
-/** Syntactic sugar over Rule boilerplate */
-function rule(prelude, children = []) {
-	return {
-		type: "Rule",
-		prelude,
-		children
-	};
-}
-/** Syntactic sugar over Declaration boilerplate */
-function decl(property, value, comment) {
-	return {
-		type: "Declaration",
-		property,
-		value,
-		comment
-	};
-}
-/** Does a node list contain a root-level declaration with this property? */
-function hasDecl(list, property) {
-	return list.some((d) => d.type === "Declaration" && d.property === property);
-}
-/** Add a declaration only if it’s unique (note: CSS, by design, allows duplication—it’s how fallbacks happen. Only use this if fallbacks aren’t needed. */
-function addDeclUnique(list, declaration) {
-	if (!hasDecl(list, declaration.property)) list.push(declaration);
-}
-//#endregion
-//#region src/utility-css.ts
-const GROUP_REGEX = {
-	bg: /(^bg-|-bg-)/,
-	border: /(^border-|-border-)/,
-	font: /(^font-|-font-)/,
-	gap: /(^gap-|-gap-)/,
-	m: /(^margin-|-margin-|)/,
-	p: /(^padding-|-padding-|)/,
-	shadow: /(^shadow-|-shadow-)/,
-	text: /(^text-|-text-)/
-};
-/** Make CSS class name from transformed token */
-function makePrelude(token, prefix, subgroup) {
-	return [`.${prefix}${subgroup || ""}-${kebabCase(token.token.id).replace(GROUP_REGEX[prefix], "")}`];
-}
-function makeVarValue(token) {
-	return makeCSSVar(token.localID ?? token.token.id, { wrapVar: true });
-}
-const utilityMatcher = new CachedWildcardMatcher();
-function generateUtilityCSS(groups, tokens, { logger }) {
-	const root = [];
-	const groupEntries = Object.entries(groups);
-	groupEntries.sort((a, b) => a[0].localeCompare(b[0]));
-	for (const [group, selectors] of groupEntries) {
-		const selectorMatcher = utilityMatcher.match(selectors);
-		const matchingTokens = tokens.filter((token) => selectorMatcher(token.token.id));
-		if (!matchingTokens.length) {
-			logger.warn({
-				group: "plugin",
-				label: PLUGIN_NAME,
-				message: `utility group "${group}" matched 0 tokens: ${JSON.stringify(selectors)}`
-			});
-			break;
-		}
-		switch (group) {
-			case "bg":
-				for (const token of matchingTokens) {
-					const prelude = makePrelude(token, "bg");
-					switch (token.token.$type) {
-						case "color":
-							root.push(rule(prelude, [decl("background-color", makeVarValue(token))]));
-							break;
-						case "gradient": {
-							const value = decl("background-image", `linear-gradient(${makeCSSVar(token.localID ?? token.token.id, { wrapVar: true })})`);
-							root.push(rule(prelude, [value]));
-						}
-					}
-				}
-				break;
-			case "border":
-				for (const token of matchingTokens) {
-					const property = {
-						border: "border",
-						color: "border-color",
-						dimension: "border-width",
-						strokeStyle: "border-style"
-					}[token.token.$type];
-					if (property) root.push(rule(makePrelude(token, "border"), [decl(property, makeVarValue(token))]));
-				}
-				for (const token of matchingTokens) for (const side of [
-					"top",
-					"right",
-					"bottom",
-					"left"
-				]) {
-					const property = {
-						border: `border-${side}`,
-						color: `border-${side}-color`,
-						dimension: `border-${side}-width`,
-						strokeStyle: `border-${side}-style`
-					}[token.token.$type];
-					if (property) root.push(rule(makePrelude(token, "border", `-${side}`), [decl(property, makeVarValue(token))]));
-				}
-				break;
-			case "font":
-				for (const token of matchingTokens) {
-					const prelude = makePrelude(token, "font");
-					if (token.token.$type === "typography" && token.type === "MULTI_VALUE") {
-						const value = Object.keys(token.value).map((property) => decl(property, makeCSSVar(`${token.localID ?? token.token.id}-${property}`, { wrapVar: true })));
-						root.push(rule(prelude, value));
-					} else {
-						const property = {
-							dimension: "font-size",
-							fontFamily: "font-family",
-							fontWeight: "font-weight"
-						}[token.token.$type];
-						if (property) root.push(rule(prelude, [decl(property, makeVarValue(token))]));
-					}
-				}
-				break;
-			case "layout": {
-				const filteredTokens = matchingTokens.filter((t) => t.token.$type === "dimension");
-				for (const token of filteredTokens) root.push(rule(makePrelude(token, "gap"), [decl("gap", makeVarValue(token))]));
-				for (const token of filteredTokens) root.push(rule(makePrelude(token, "gap", "-col"), [decl("column-gap", makeVarValue(token))]));
-				for (const token of filteredTokens) root.push(rule(makePrelude(token, "gap", "-row"), [decl("row-gap", makeVarValue(token))]));
-				for (const prefix of ["m", "p"]) {
-					const property = prefix === "m" ? "margin" : "padding";
-					for (const token of filteredTokens) root.push(rule(makePrelude(token, prefix, "a"), [decl(property, makeVarValue(token))]));
-					for (const token of filteredTokens) {
-						const value = makeVarValue(token);
-						root.push(rule(makePrelude(token, prefix, "x"), [
-							decl(`${property}-inline`, value),
-							decl(`${property}-left`, value),
-							decl(`${property}-right`, value)
-						]), rule(makePrelude(token, prefix, "y"), [
-							decl(`${property}-block`, value),
-							decl(`${property}-bottom`, value),
-							decl(`${property}-top`, value)
-						]));
-					}
-					for (const side of [
-						"top",
-						"right",
-						"bottom",
-						"left"
-					]) for (const token of filteredTokens) root.push(rule(makePrelude(token, prefix, side[0]), [decl(`${property}-${side}`, makeVarValue(token))]));
-					for (const token of filteredTokens) {
-						const value = makeVarValue(token);
-						root.push(rule(makePrelude(token, prefix, "bs"), [decl(`${property}-block-start`, value)]), rule(makePrelude(token, prefix, "be"), [decl(`${property}-block-end`, value)]), rule(makePrelude(token, prefix, "is"), [decl(`${property}-inline-start`, value)]), rule(makePrelude(token, prefix, "ie"), [decl(`${property}-inline-end`, value)]));
-					}
-				}
-				break;
-			}
-			case "shadow":
-				for (const token of matchingTokens) if (token.token.$type === "shadow") root.push(rule(makePrelude(token, "shadow"), [decl("box-shadow", makeVarValue(token))]));
-				break;
-			case "text":
-				for (const token of matchingTokens) {
-					const prelude = makePrelude(token, "text");
-					const value = makeVarValue(token);
-					switch (token.token.$type) {
-						case "color":
-							root.push(rule(prelude, [decl("color", value)]));
-							break;
-						case "gradient":
-							root.push(rule(prelude, [
-								decl("background", `-webkit-linear-gradient(${value})`),
-								decl("-webkit-background-clip", "text"),
-								decl("-webkit-text-fill-color", "transparent")
-							]));
-							break;
-					}
-				}
-				break;
-			default:
-				logger.warn({
-					group: "plugin",
-					label: PLUGIN_NAME,
-					message: `unknown utility CSS group "${group}", ignoring`
-				});
-				break;
-		}
-	}
-	return root;
-}
-//#endregion
-//#region src/build.ts
-const P3_MQ = "@media (color-gamut: p3)";
-const REC2020_MQ = "@media (color-gamut: rec2020)";
-/**
-* Get description from metadata with fallback to token.$description
-* Preserves the descriptions and alias descriptions.
-*/
-function getDescription(token) {
-	return token.meta?.["plugin-css"]?.description ?? token.token.$description;
-}
-const TOKEN_TYPE_SYNTAX = {
-	color: "<color>",
-	dimension: "<length>",
-	duration: "<time>",
-	fontWeight: "<integer>",
-	number: "<number>",
-	boolean: "<integer>",
-	fontFamily: "*",
-	string: "*",
-	cubicBezier: "*",
-	border: "*",
-	shadow: "*",
-	gradient: "*",
-	typography: "*",
-	transition: "*",
-	strokeStyle: "*",
-	link: "<url>"
-};
-const SUB_PROPERTY_SYNTAX = {
-	border: {
-		color: "<color>",
-		width: "<length>",
-		style: "*"
-	},
-	shadow: {
-		color: "<color>",
-		"offset-x": "<length>",
-		"offset-y": "<length>",
-		blur: "<length>",
-		spread: "<length>"
-	},
-	transition: {
-		duration: "<time>",
-		delay: "<time>",
-		"timing-function": "*"
-	},
-	typography: {
-		"font-family": "*",
-		"font-size": "<length>",
-		"font-weight": "<integer>",
-		"line-height": "*",
-		"letter-spacing": "<length>",
-		"font-style": "*",
-		"font-variant": "*",
-		"font-variation-settings": "*",
-		"text-decoration": "*",
-		"text-transform": "*"
-	},
-	strokeStyle: {
-		"dash-array": "*",
-		"line-cap": "*"
-	}
-};
-function generatePropertyDefinition(localID, syntax, initialValue) {
-	const children = [decl("syntax", `'${syntax}'`), decl("inherits", "true")];
-	if (initialValue) children.push(decl("initial-value", initialValue));
-	return rule([`@property ${localID}`], children);
-}
-function generatePropertyDefinitions(getTransforms, options) {
-	const tokens = getTransforms({ format: "css" });
-	const properties = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const token of tokens) {
-		const localID = token.localID;
-		if (!localID) continue;
-		if (!options.include(token.token.id) || options.exclude(token.token.id)) continue;
-		const cssSyntax = TOKEN_TYPE_SYNTAX[token.token.$type] ?? "*";
-		if (token.type === "SINGLE_VALUE") {
-			if (seen.has(localID)) continue;
-			seen.add(localID);
-			if (!token.token.aliasOf && cssSyntax !== "*") properties.push(generatePropertyDefinition(localID, cssSyntax, token.value));
-			else properties.push(generatePropertyDefinition(localID, "*"));
-		} else if (token.type === "MULTI_VALUE") {
-			for (const [name, subValue] of Object.entries(token.value)) {
-				const subID = name === "." ? localID : `${localID}-${name}`;
-				if (seen.has(subID)) continue;
-				seen.add(subID);
-				const subSyntax = SUB_PROPERTY_SYNTAX[token.token.$type]?.[name] ?? "*";
-				if (!token.token.aliasOf && subSyntax !== "*") properties.push(generatePropertyDefinition(subID, subSyntax, subValue));
-				else properties.push(generatePropertyDefinition(subID, "*"));
-			}
-			if (!seen.has(localID)) {
-				seen.add(localID);
-				properties.push(generatePropertyDefinition(localID, "*"));
-			}
-		}
-	}
-	return properties;
-}
-function buildCSS({ logger, getTransforms, include: userInclude, exclude: userExclude, utility, permutations, modeSelectors, baseSelector, baseScheme, propertyDefinitions = false, omitTypographyShorthand, subValueVariableName }) {
-	function makeSubValueId(variableName, subValueName, token) {
-		const customName = subValueVariableName?.(variableName, subValueName, token);
-		if (customName !== void 0) {
-			if (typeof customName !== "string") logger.error({
-				group: "plugin",
-				label: PLUGIN_NAME,
-				message: `subValueVariableName() must return a string; received ${customName}`
-			});
-			return customName;
-		}
-		return `${variableName}-${subValueName}`;
-	}
-	const include = userInclude ? cachedMatcher.tokenIDMatch(userInclude) : () => true;
-	const exclude = userExclude ? cachedMatcher.tokenIDMatch(userExclude) : () => false;
-	let propertyDefsNodes = [];
-	if (propertyDefinitions) propertyDefsNodes = generatePropertyDefinitions(getTransforms, {
-		include,
-		exclude
-	});
-	if (permutations?.length) {
-		let output = "";
-		for (const p of permutations) {
-			if (typeof p.prepare !== "function") logger.error({
-				group: "plugin",
-				label: PLUGIN_NAME,
-				message: "prepare(css) must be a function!"
-			});
-			const tokens = getTransforms({
-				format: "css",
-				input: p.input
-			});
-			if (!tokens.length) continue;
-			const root = [];
-			const hdrColors = {
-				p3: [],
-				rec2020: []
-			};
-			const pInclude = p.include ? cachedMatcher.tokenIDMatch(p.include) : () => true;
-			const pExclude = p.exclude ? cachedMatcher.tokenIDMatch(p.exclude) : () => false;
-			const includeToken = (tokenId) => {
-				return include(tokenId) && pInclude(tokenId) && !exclude(tokenId) && !pExclude(tokenId);
-			};
-			for (const token of tokens) {
-				if (!includeToken(token.id)) continue;
-				const localID = makeCSSVar(token.localID ?? token.token.id);
-				const aliasTokens = token.token.aliasedBy?.length ? getTransforms({
-					format: "css",
-					id: token.token.aliasedBy,
-					input: p.input
-				}) : [];
-				if (token.type === "SINGLE_VALUE") addDeclUnique(root, decl(localID, token.value, getDescription(token)));
-				else if (token.value.srgb && token.value.p3 && token.value.rec2020) {
-					addDeclUnique(root, decl(localID, token.value.srgb, getDescription(token)));
-					if (token.value.p3 !== token.value.srgb) {
-						addDeclUnique(hdrColors.p3, decl(localID, token.value.p3, getDescription(token)));
-						addDeclUnique(hdrColors.rec2020, decl(localID, token.value.rec2020, getDescription(token)));
-						for (const alias of aliasTokens) if (alias.localID && typeof alias.value === "string") {
-							const aliasID = makeCSSVar(alias.localID);
-							addDeclUnique(hdrColors.p3, decl(aliasID, alias.value, getDescription(alias)));
-							addDeclUnique(hdrColors.rec2020, decl(aliasID, alias.value, getDescription(alias)));
-						}
-					}
-				} else {
-					for (const [name, subValue] of Object.entries(token.value)) addDeclUnique(root, decl(makeSubValueId(localID, name, token), subValue, getDescription(token)));
-					const shorthand = generateShorthand({
-						token: {
-							...token.token,
-							$value: token.value
-						},
-						localID,
-						omitTypographyShorthand
-					});
-					if (shorthand) addDeclUnique(root, decl(localID, shorthand, getDescription(token)));
-				}
-				for (const alias of aliasTokens) if (alias.localID && typeof alias.value === "string") {
-					if (!includeToken(alias.id)) continue;
-					addDeclUnique(root, decl(alias.localID, alias.value, getDescription(token)));
-				}
-			}
-			const indentRules = getIndentFromPrepare(p.prepare);
-			if (output) output += "\n";
-			output += `${p.prepare(printRules(root, indentRules))}\n`;
-			for (const gamut of ["p3", "rec2020"]) if (hdrColors[gamut].length) {
-				output += `\n@media (color-gamut: ${gamut}) {\n`;
-				output += indentRules.indentChar;
-				output += p.prepare(printRules(hdrColors[gamut], indentRules)).replace(/\n(?!\n)/g, `\n${indentRules.indentChar}`);
-				output += "\n}\n";
-			}
-		}
-		if (utility && Object.keys(utility).length) {
-			if (output) output += "\n";
-			output += printRules(generateUtilityCSS(utility, getTransforms({
-				format: "css",
-				input: permutations[0]?.input ?? {}
-			}), { logger }));
-		}
-		if (propertyDefsNodes.length && output) output = `${printRules(propertyDefsNodes)}\n\n${output}`;
-		return output;
-	}
-	let output = "";
-	const rootTokens = getTransforms({
-		format: "css",
-		mode: "."
-	});
-	if (rootTokens.length) {
-		const rules = [
-			rule([baseSelector], []),
-			rule([P3_MQ], [rule([baseSelector])]),
-			rule([REC2020_MQ], [rule([baseSelector])])
-		];
-		const rootRule = rules[0];
-		const p3Rule = rules[1].children[0];
-		const rec2020Rule = rules[2].children[0];
-		if (baseScheme) rootRule.children.unshift(decl("color-scheme", baseScheme));
-		for (const token of rootTokens) {
-			if (!include(token.token.id) || exclude(token.token.id)) continue;
-			const localID = token.localID ?? token.token.id;
-			const aliasTokens = token.token.aliasedBy?.length ? getTransforms({
-				format: "css",
-				id: token.token.aliasedBy
-			}) : [];
-			if (token.type === "SINGLE_VALUE") addDeclUnique(rootRule.children, decl(localID, token.value, getDescription(token)));
-			else if (token.value.srgb && token.value.p3 && token.value.rec2020) {
-				addDeclUnique(rootRule.children, decl(localID, token.value.srgb, getDescription(token)));
-				if (token.value.p3 !== token.value.srgb) {
-					addDeclUnique(p3Rule.children, decl(localID, token.value.p3, getDescription(token)));
-					addDeclUnique(rec2020Rule.children, decl(localID, token.value.rec2020, getDescription(token)));
-					for (const alias of aliasTokens) if (alias.localID && typeof alias.value === "string") {
-						addDeclUnique(p3Rule.children, decl(alias.localID, alias.value, getDescription(alias)));
-						addDeclUnique(rec2020Rule.children, decl(alias.localID, alias.value, getDescription(alias)));
-					}
-				}
-			} else if (token.type === "MULTI_VALUE") {
-				for (const [name, value] of Object.entries(token.value)) {
-					const property = name === "." ? localID : makeSubValueId(localID, name, token);
-					addDeclUnique(rootRule.children, decl(property, value, getDescription(token)));
-				}
-				const shorthand = generateShorthand({
-					token: {
-						...token.token,
-						$value: token.value
-					},
-					localID,
-					omitTypographyShorthand
-				});
-				if (shorthand) addDeclUnique(rootRule.children, decl(token.localID ?? token.token.id, shorthand, getDescription(token)));
-			}
-		}
-		output += printRules(rules);
-	}
-	for (const selector of modeSelectors ?? []) {
-		const selectorTokens = getTransforms({
-			format: "css",
-			id: selector.tokens,
-			mode: selector.mode
-		});
-		if (!selectorTokens.length) continue;
-		const modeRule = rule(selector.selectors);
-		if (selector.scheme) modeRule.children.unshift(decl("color-scheme", selector.scheme));
-		const hdrColors = {
-			p3: [],
-			rec2020: []
-		};
-		for (const token of selectorTokens) {
-			const localID = token.localID ?? token.token.id;
-			const aliasedBy = token.token.mode[selector.mode]?.aliasedBy?.length ? token.token.mode[selector.mode].aliasedBy : token.token.aliasedBy;
-			let aliasTokens = aliasedBy?.length ? getTransforms({
-				format: "css",
-				id: aliasedBy,
-				mode: selector.mode
-			}) : [];
-			if (new Set(aliasTokens.map((t) => t.id)).size !== aliasTokens.length && selector.mode !== ".") aliasTokens = aliasTokens.filter((t, i) => !aliasTokens.some((t2, i2) => t.id === t2.id && i !== i2 && t.mode === "."));
-			if (token.type === "SINGLE_VALUE") addDeclUnique(modeRule.children, decl(localID, token.value, getDescription(token)));
-			else if (token.value.srgb && token.value.p3 && token.value.rec2020) {
-				addDeclUnique(modeRule.children, decl(localID, token.value.srgb, getDescription(token)));
-				if (token.value.p3 !== token.value.srgb) {
-					addDeclUnique(hdrColors.p3, decl(localID, token.value.p3, getDescription(token)));
-					addDeclUnique(hdrColors.rec2020, decl(localID, token.value.rec2020, getDescription(token)));
-					for (const alias of aliasTokens) if (alias.localID && typeof alias.value === "string") for (const gamut of ["p3", "rec2020"]) addDeclUnique(hdrColors[gamut], decl(alias.localID, alias.value, getDescription(alias)));
-				}
-			} else {
-				for (const [name, subValue] of Object.entries(token.value)) {
-					const subValueID = makeSubValueId(localID, name, token);
-					addDeclUnique(modeRule.children, decl(subValueID, subValue, getDescription(token)));
-				}
-				const shorthand = generateShorthand({
-					token: {
-						...token.token,
-						$value: token.value
-					},
-					localID,
-					omitTypographyShorthand
-				});
-				if (shorthand) addDeclUnique(modeRule.children, decl(localID, shorthand, getDescription(token)));
-			}
-			for (const alias of aliasTokens) if (alias.localID && typeof alias.value === "string") addDeclUnique(modeRule.children, decl(alias.localID, alias.value, getDescription(token)));
-		}
-		if (output) output += "\n\n";
-		output += printRules([
-			modeRule,
-			rule([P3_MQ], [rule(selector.selectors, hdrColors.p3)]),
-			rule([REC2020_MQ], [rule(selector.selectors, hdrColors.rec2020)])
-		]);
-	}
-	if (utility && Object.keys(utility).length) {
-		if (output) output += "\n\n";
-		output += printRules(generateUtilityCSS(utility, getTransforms({
-			format: "css",
-			mode: "."
-		}), { logger }));
-	}
-	if (propertyDefsNodes.length && output) output = `${printRules(propertyDefsNodes)}\n\n${output}`;
-	return output;
-}
-//#endregion
-//#region src/transform.ts
-function transformCSS({ transform: { context: { logger }, resolver, setTransform, tokens: baseTokens }, options: { permutations, include: userInclude, exclude: userExclude, legacyHex, transform: customTransform, variableName } }) {
-	function transformName(token) {
-		const customName = variableName?.(token);
-		if (customName !== void 0) {
-			if (typeof customName !== "string") logger.error({
-				group: "plugin",
-				label: PLUGIN_NAME,
-				message: `variableName() must return a string; received ${customName}`
-			});
-			return customName;
-		}
-		return makeCSSVar(token.id);
-	}
-	const transformAlias = (token) => `var(${transformName(token)})`;
-	const include = userInclude ? cachedMatcher.tokenIDMatch(userInclude) : () => true;
-	const exclude = userExclude ? cachedMatcher.tokenIDMatch(userExclude) : () => false;
-	if (Array.isArray(permutations)) {
-		let defaultPermutationI = permutations.findIndex((p) => !Object.keys(p.input ?? {}).length);
-		if (defaultPermutationI === -1) defaultPermutationI = 0;
-		for (let i = 0; i < permutations.length; i++) {
-			const p = permutations[i];
-			const inputRaw = p.input;
-			const input = !Object.keys(inputRaw ?? {}).length ? JSON.parse(resolver.getPermutationID(inputRaw ?? {})) : inputRaw;
-			const pInclude = p.include ? cachedMatcher.tokenIDMatch(p.include) : () => true;
-			const pExclude = p.exclude ? cachedMatcher.tokenIDMatch(p.exclude) : () => false;
-			const includeToken = (tokenId) => {
-				return include(tokenId) && pInclude(tokenId) && !exclude(tokenId) && !pExclude(tokenId);
-			};
-			try {
-				const tokens = resolver.apply(input);
-				for (const token of Object.values(tokens)) {
-					if (!includeToken(token.id)) continue;
-					const options = {
-						tokensSet: tokens,
-						transformAlias,
-						color: { legacyHex },
-						permutation: input
-					};
-					const value = p.transform?.(token, options) ?? customTransform?.(token, options) ?? transformCSSValue(token, options);
-					if (value) {
-						const localID = transformName(token);
-						setTransform(token.id, {
-							format: "css",
-							value,
-							localID,
-							input,
-							meta: {
-								"plugin-css": { description: token.$description },
-								"token-listing": { name: localID }
-							}
-						});
-						if (defaultPermutationI === i) setTransform(token.id, {
-							format: "css",
-							value,
-							localID,
-							mode: ".",
-							meta: {
-								"plugin-css": { description: token.$description },
-								"token-listing": { name: localID }
-							}
-						});
-					}
-				}
-			} catch (err) {
-				logger.error({
-					group: "plugin",
-					label: PLUGIN_NAME,
-					message: `There was an error trying to apply input ${resolver.getPermutationID(input)}.`,
-					continueOnError: true
-				});
-				throw err;
-			}
-		}
-		return;
-	}
-	for (const token of Object.values(baseTokens)) {
-		if (!include(token.id) || exclude(token.id)) continue;
-		for (const mode of Object.keys(token.mode)) {
-			const tokenArgs = {
-				...token,
-				...token.mode[mode]
-			};
-			const options = {
-				tokensSet: baseTokens,
-				transformAlias,
-				color: { legacyHex },
-				permutation: { tzMode: "*" }
-			};
-			const value = customTransform?.(tokenArgs, options) ?? transformCSSValue(tokenArgs, options);
-			if (value) {
-				const localID = transformName(token);
-				setTransform(token.id, {
-					format: "css",
-					localID,
-					value,
-					mode,
-					meta: {
-						"plugin-css": { description: token.$description },
-						"token-listing": { name: localID }
-					}
-				});
-			}
-		}
-	}
-}
-//#endregion
-//#region src/index.ts
-function cssPlugin(options) {
-	const { utility, skipBuild, baseScheme, propertyDefinitions } = options ?? {};
-	const filename = options?.filename ?? options?.fileName ?? "index.css";
-	const baseSelector = options?.baseSelector ?? ":root";
-	return {
-		name: PLUGIN_NAME,
-		config(_config, context) {
-			if (options?.permutations && (options?.modeSelectors || options?.baseSelector || options?.baseScheme)) context.logger.error({
-				group: "plugin",
-				label: PLUGIN_NAME,
-				message: "Permutations option is incompatible with modeSelectors, baseSelector, and baseScheme."
-			});
-		},
-		async transform(transformOptions) {
-			transformCSS({
-				transform: transformOptions,
-				options: options ?? {}
-			});
-		},
-		async build({ getTransforms, outputFile, context }) {
-			if (skipBuild === true) return;
-			let contents = `${FILE_PREFIX}\n\n`;
-			contents += buildCSS({
-				include: options?.include,
-				exclude: options?.exclude,
-				getTransforms,
-				permutations: options?.permutations,
-				modeSelectors: options?.modeSelectors,
-				utility,
-				baseSelector,
-				baseScheme,
-				propertyDefinitions: propertyDefinitions ?? false,
-				logger: context.logger,
-				omitTypographyShorthand: options?.omitTypographyShorthand,
-				subValueVariableName: options?.subValueVariableName
-			});
-			outputFile(filename, contents.replace(/\n*$/, "\n"));
-		}
-	};
-}
-//#endregion
-export { FILE_PREFIX, FORMAT_ID, PLUGIN_NAME, cssPlugin as default, printNode, printRules };
-
 //# sourceMappingURL=index.js.map