@yahoo/uds 3.104.0 → 3.105.0

package/dist/tailwind/dist/purger/optimized/utils/componentAnalyzer.js

@@ -0,0 +1,405 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { SPRING_MOTION_DEFAULTS } from "../../../../../motion-tokens/dist/index.js";
+import path from "node:path";
+import { Node, SyntaxKind } from "ts-morph";
+
+//#region ../tailwind/dist/purger/optimized/utils/componentAnalyzer.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Known UDS component names (populated by scanning)
+*/
+let knownComponents = null;
+/**
+* Map of component name -> file path
+*/
+let componentPaths = null;
+/**
+* Scan src/components to build a map of all component files
+*/
+async function scanComponentFiles(componentsDir) {
+	if (componentPaths) return componentPaths;
+	componentPaths = /* @__PURE__ */ new Map();
+	knownComponents = /* @__PURE__ */ new Set();
+	const glob = new Bun.Glob("**/*.tsx");
+	for await (const file of glob.scan({
+		cwd: componentsDir,
+		absolute: true
+	})) {
+		if (file.includes(".test.") || file.endsWith("index.tsx")) continue;
+		const fileName = path.basename(file, ".tsx");
+		if (/^[A-Z]/.test(fileName)) {
+			componentPaths.set(fileName, file);
+			knownComponents.add(fileName);
+		}
+	}
+	return componentPaths;
+}
+/**
+* Analyze an object literal for variant key mappings.
+* Handles:
+* - Direct property assignments: { fontSize: variant } -> variant maps to fontSize
+* - Nullish coalescing: { fontSize: fontSize ?? variant } -> variant maps to fontSize
+* - Conditional spreads: ...(condition ? { props } : {}) -> recursively analyze props
+*/
+function analyzeObjectForVariantMappings(objLiteral, styleProps, getStylesLiterals, propToVariantKeys, sourceFile) {
+	for (const prop of objLiteral.getProperties()) if (Node.isPropertyAssignment(prop)) {
+		const variantKey = prop.getName();
+		if (variantKey && !styleProps.includes(variantKey)) styleProps.push(variantKey);
+		const initializer = prop.getInitializer();
+		if (initializer && Node.isStringLiteral(initializer)) getStylesLiterals.set(variantKey, initializer.getLiteralValue());
+		if (initializer && Node.isIdentifier(initializer)) {
+			const propName = initializer.getText();
+			const existing = propToVariantKeys.get(propName) ?? [];
+			if (!existing.includes(variantKey)) {
+				existing.push(variantKey);
+				propToVariantKeys.set(propName, existing);
+			}
+		}
+		if (initializer && Node.isBinaryExpression(initializer)) {
+			const operatorToken = initializer.getOperatorToken();
+			if (operatorToken.getKind() === SyntaxKind.QuestionQuestionToken || operatorToken.getKind() === SyntaxKind.BarBarToken) {
+				const rightSide = initializer.getRight();
+				if (Node.isIdentifier(rightSide)) {
+					const fallbackPropName = rightSide.getText();
+					const existing = propToVariantKeys.get(fallbackPropName) ?? [];
+					if (!existing.includes(variantKey)) {
+						existing.push(variantKey);
+						propToVariantKeys.set(fallbackPropName, existing);
+					}
+				}
+			}
+		}
+	} else if (Node.isSpreadAssignment(prop)) {
+		const spreadExpr = prop.getExpression();
+		if (Node.isParenthesizedExpression(spreadExpr)) {
+			const inner = spreadExpr.getExpression();
+			if (Node.isConditionalExpression(inner)) {
+				const whenTrue = inner.getWhenTrue();
+				if (Node.isObjectLiteralExpression(whenTrue)) analyzeObjectForVariantMappings(whenTrue, styleProps, getStylesLiterals, propToVariantKeys, sourceFile);
+			}
+		}
+		if (Node.isIdentifier(spreadExpr)) {
+			const varName = spreadExpr.getText();
+			const varDecl = sourceFile.getDescendantsOfKind(SyntaxKind.VariableDeclaration).find((v) => v.getName() === varName);
+			if (varDecl) {
+				const varInit = varDecl.getInitializer();
+				if (varInit && Node.isObjectLiteralExpression(varInit)) analyzeObjectForVariantMappings(varInit, styleProps, getStylesLiterals, propToVariantKeys, sourceFile);
+			}
+		}
+	}
+}
+/**
+* Analyzes a UDS component file to extract:
+* 1. Default prop values (e.g., display = 'flex')
+* 2. Props passed to getStyles()
+* 3. Internal UDS component usage
+*/
+function analyzeComponent(project, componentPath) {
+	const sourceFile = project.getSourceFile(componentPath);
+	if (!sourceFile) return null;
+	const componentName = path.basename(componentPath, ".tsx");
+	const defaultProps = /* @__PURE__ */ new Map();
+	const componentPropNames = /* @__PURE__ */ new Set();
+	const styleProps = [];
+	const getStylesLiterals = /* @__PURE__ */ new Map();
+	const cxLiterals = [];
+	const internalComponents = [];
+	const internalComponentProps = /* @__PURE__ */ new Map();
+	const propToVariantKeys = /* @__PURE__ */ new Map();
+	const functions = [...sourceFile.getFunctions(), ...sourceFile.getVariableDeclarations().filter((v) => {
+		const init = v.getInitializer();
+		return init && (Node.isArrowFunction(init) || Node.isCallExpression(init));
+	})];
+	for (const fn of functions) {
+		if (Node.isVariableDeclaration(fn)) {
+			const init = fn.getInitializer();
+			if (!init) continue;
+			if (Node.isCallExpression(init)) {
+				const args = init.getArguments();
+				for (const arg of args) if (Node.isFunctionExpression(arg) || Node.isArrowFunction(arg)) {
+					extractDefaultsFromFunction(arg, defaultProps);
+					extractAllPropNames(arg, componentPropNames);
+				}
+			}
+			if (Node.isArrowFunction(init)) {
+				extractDefaultsFromFunction(init, defaultProps);
+				extractAllPropNames(init, componentPropNames);
+			}
+		}
+		if (Node.isFunctionDeclaration(fn)) {
+			extractDefaultsFromFunction(fn, defaultProps);
+			extractAllPropNames(fn, componentPropNames);
+		}
+	}
+	const getStylesCalls = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).filter((call) => call.getExpression().getText() === "getStyles");
+	for (const call of getStylesCalls) {
+		const args = call.getArguments();
+		if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {
+			const objLiteral = args[0];
+			for (const prop of objLiteral.getProperties()) if (Node.isPropertyAssignment(prop)) {
+				const variantKey = prop.getName();
+				if (variantKey && !styleProps.includes(variantKey)) styleProps.push(variantKey);
+				const initializer = prop.getInitializer();
+				if (initializer && Node.isStringLiteral(initializer)) getStylesLiterals.set(variantKey, initializer.getLiteralValue());
+				if (initializer && Node.isIdentifier(initializer)) {
+					const propName = initializer.getText();
+					const existing = propToVariantKeys.get(propName) ?? [];
+					if (!existing.includes(variantKey)) {
+						existing.push(variantKey);
+						propToVariantKeys.set(propName, existing);
+					}
+				}
+				if (initializer && Node.isBinaryExpression(initializer)) {
+					const operatorToken = initializer.getOperatorToken();
+					if (operatorToken.getKind() === SyntaxKind.QuestionQuestionToken || operatorToken.getKind() === SyntaxKind.BarBarToken) {
+						const rightSide = initializer.getRight();
+						if (Node.isIdentifier(rightSide)) {
+							const fallbackPropName = rightSide.getText();
+							const existing = propToVariantKeys.get(fallbackPropName) ?? [];
+							if (!existing.includes(variantKey)) {
+								existing.push(variantKey);
+								propToVariantKeys.set(fallbackPropName, existing);
+							}
+						}
+					}
+				}
+				if (initializer && Node.isConditionalExpression(initializer)) {
+					const whenTrue = initializer.getWhenTrue();
+					const whenFalse = initializer.getWhenFalse();
+					const extractLiterals = (node) => {
+						const literals = [];
+						if (Node.isStringLiteral(node)) literals.push(node.getLiteralValue());
+						else if (Node.isConditionalExpression(node)) {
+							literals.push(...extractLiterals(node.getWhenTrue()));
+							literals.push(...extractLiterals(node.getWhenFalse()));
+						}
+						return literals;
+					};
+					[...extractLiterals(whenTrue), ...extractLiterals(whenFalse)].forEach((value, index) => {
+						const literalKey = index === 0 ? variantKey : `${variantKey}:${index}`;
+						getStylesLiterals.set(literalKey, value);
+					});
+				}
+			} else if (Node.isShorthandPropertyAssignment(prop)) {
+				const propName = prop.getName();
+				if (propName && !styleProps.includes(propName)) styleProps.push(propName);
+			} else if (Node.isSpreadAssignment(prop)) {
+				const spreadExpr = prop.getExpression();
+				if (Node.isIdentifier(spreadExpr)) {
+					const varName = spreadExpr.getText();
+					const varDecl = sourceFile.getDescendantsOfKind(SyntaxKind.VariableDeclaration).find((v) => v.getName() === varName);
+					if (varDecl) {
+						const varInit = varDecl.getInitializer();
+						if (varInit && Node.isObjectLiteralExpression(varInit)) analyzeObjectForVariantMappings(varInit, styleProps, getStylesLiterals, propToVariantKeys, sourceFile);
+					}
+				}
+			}
+		}
+	}
+	const cxCalls = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).filter((call) => call.getExpression().getText() === "cx");
+	for (const call of cxCalls) for (const arg of call.getArguments()) extractCxStringLiterals(arg, cxLiterals);
+	extractInternalComponents(sourceFile, internalComponents, internalComponentProps, propToVariantKeys, componentPropNames);
+	return {
+		name: componentName,
+		filePath: componentPath,
+		defaultProps,
+		styleProps,
+		getStylesLiterals,
+		cxLiterals,
+		internalComponents,
+		internalComponentProps,
+		propToVariantKeys,
+		motionVarPrefixes: extractMotionVarPrefixes(sourceFile)
+	};
+}
+/**
+* Extract UDS components used internally in the file and their prop values.
+* Also detects prop aliasing (e.g., columnGap={gap} means gap -> columnGap).
+*/
+function extractInternalComponents(sourceFile, internalComponents, internalComponentProps, propToVariantKeys, componentProps) {
+	for (const importDecl of sourceFile.getImportDeclarations()) {
+		const moduleSpec = importDecl.getModuleSpecifierValue();
+		if (moduleSpec.startsWith("@yahoo/uds") || moduleSpec.startsWith("../") || moduleSpec.startsWith("./")) {
+			if (moduleSpec.includes("/components/") || moduleSpec === "@yahoo/uds") for (const namedImport of importDecl.getNamedImports()) {
+				const name = namedImport.getName();
+				if (/^[A-Z]/.test(name) && !internalComponents.includes(name)) internalComponents.push(name);
+			}
+		}
+	}
+	const jsxElements = [...sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement), ...sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement)];
+	for (const element of jsxElements) {
+		const tagName = element.getTagNameNode().getText();
+		if (!/^[A-Z]/.test(tagName)) continue;
+		if (!internalComponents.includes(tagName)) internalComponents.push(tagName);
+		const attrs = element.getAttributes();
+		for (const attr of attrs) if (Node.isJsxAttribute(attr)) {
+			const propName = attr.getNameNode().getText();
+			const initializer = attr.getInitializer();
+			let values = [];
+			if (initializer) {
+				if (Node.isStringLiteral(initializer)) values = [initializer.getLiteralValue()];
+				else if (Node.isJsxExpression(initializer)) {
+					const expr = initializer.getExpression();
+					if (expr && Node.isStringLiteral(expr)) values = [expr.getLiteralValue()];
+					else if (expr && Node.isIdentifier(expr)) {
+						const identifierName = expr.getText();
+						if (componentProps.has(identifierName) && identifierName !== propName) {
+							const existing = propToVariantKeys.get(identifierName) ?? [];
+							if (!existing.includes(propName)) {
+								existing.push(propName);
+								propToVariantKeys.set(identifierName, existing);
+							}
+						}
+					}
+				}
+			}
+			if (values.length > 0) {
+				let componentPropsMap = internalComponentProps.get(tagName);
+				if (!componentPropsMap) {
+					componentPropsMap = /* @__PURE__ */ new Map();
+					internalComponentProps.set(tagName, componentPropsMap);
+				}
+				const existingValues = componentPropsMap.get(propName) ?? [];
+				for (const v of values) if (!existingValues.includes(v)) existingValues.push(v);
+				componentPropsMap.set(propName, existingValues);
+			}
+		}
+	}
+}
+/**
+* Extract default prop values from a function's parameter destructuring
+*/
+function extractDefaultsFromFunction(fn, defaults) {
+	let params = [];
+	if (Node.isFunctionDeclaration(fn) || Node.isFunctionExpression(fn)) params = fn.getParameters();
+	else if (Node.isArrowFunction(fn)) params = fn.getParameters();
+	for (const param of params) {
+		if (!Node.isParameterDeclaration(param)) continue;
+		const nameNode = param.getNameNode();
+		if (!nameNode || !Node.isObjectBindingPattern(nameNode)) continue;
+		for (const element of nameNode.getElements()) {
+			const propName = element.getPropertyNameNode()?.getText() || element.getName();
+			const initializer = element.getInitializer();
+			if (initializer && Node.isStringLiteral(initializer)) defaults.set(propName, initializer.getLiteralValue());
+		}
+	}
+}
+/**
+* Extract ALL prop names from a function's parameter destructuring (not just defaults)
+*/
+function extractAllPropNames(fn, propNames) {
+	let params = [];
+	if (Node.isFunctionDeclaration(fn) || Node.isFunctionExpression(fn)) params = fn.getParameters();
+	else if (Node.isArrowFunction(fn)) params = fn.getParameters();
+	for (const param of params) {
+		if (!Node.isParameterDeclaration(param)) continue;
+		const nameNode = param.getNameNode();
+		if (!nameNode || !Node.isObjectBindingPattern(nameNode)) continue;
+		for (const element of nameNode.getElements()) {
+			const propName = element.getPropertyNameNode()?.getText() || element.getName();
+			propNames.add(propName);
+		}
+	}
+}
+/**
+* Extract string literals from cx() call arguments.
+* Handles:
+* - Direct string literals: cx('class1', 'class2')
+* - Object keys: cx({ 'class1': condition, 'class2': true })
+* - Nested calls and arrays
+*/
+function extractCxStringLiterals(node, literals) {
+	if (Node.isStringLiteral(node)) {
+		const classes = node.getLiteralValue().split(/\s+/).filter(Boolean);
+		for (const cls of classes) if (!literals.includes(cls)) literals.push(cls);
+	} else if (Node.isObjectLiteralExpression(node)) {
+		for (const prop of node.getProperties()) if (Node.isPropertyAssignment(prop)) {
+			const nameNode = prop.getNameNode();
+			if (Node.isStringLiteral(nameNode)) {
+				const classes = nameNode.getLiteralValue().split(/\s+/).filter(Boolean);
+				for (const cls of classes) if (!literals.includes(cls)) literals.push(cls);
+			} else if (Node.isIdentifier(nameNode)) {
+				const cls = nameNode.getText();
+				if (!literals.includes(cls)) literals.push(cls);
+			}
+		}
+	} else if (Node.isArrayLiteralExpression(node)) for (const element of node.getElements()) extractCxStringLiterals(element, literals);
+	else if (Node.isConditionalExpression(node)) {
+		extractCxStringLiterals(node.getWhenTrue(), literals);
+		extractCxStringLiterals(node.getWhenFalse(), literals);
+	} else if (Node.isBinaryExpression(node)) {
+		extractCxStringLiterals(node.getLeft(), literals);
+		extractCxStringLiterals(node.getRight(), literals);
+	}
+}
+/**
+* Try to resolve an identifier to its initializer value (for const declarations)
+*/
+function resolveIdentifierToObject(sourceFile, identifier) {
+	const varDecls = sourceFile.getDescendantsOfKind(SyntaxKind.VariableDeclaration);
+	for (const decl of varDecls) {
+		if (decl.getName() !== identifier) continue;
+		let initializer = decl.getInitializer();
+		if (!initializer) continue;
+		if (Node.isAsExpression(initializer)) initializer = initializer.getExpression();
+		if (!Node.isObjectLiteralExpression(initializer)) continue;
+		const result = {};
+		for (const prop of initializer.getProperties()) {
+			if (!Node.isPropertyAssignment(prop)) continue;
+			const propName = prop.getName();
+			const propInit = prop.getInitializer();
+			if (propInit && Node.isStringLiteral(propInit)) result[propName] = propInit.getLiteralValue();
+		}
+		return result;
+	}
+	return null;
+}
+/**
+* Extract motion CSS variable prefixes from SpringMotionConfig usage.
+* Returns prefixes like ['--uds-motion-bouncy-4-', '--uds-motion-smooth-3-']
+*/
+function extractMotionVarPrefixes(sourceFile) {
+	const prefixes = [];
+	const jsxElements = [...sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement), ...sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement)];
+	for (const element of jsxElements) {
+		if (element.getTagNameNode().getText() !== "SpringMotionConfig") continue;
+		const props = {
+			layoutVariant: null,
+			layoutSpeed: null,
+			colorVariant: null,
+			colorSpeed: null
+		};
+		const attrs = element.getAttributes();
+		for (const attr of attrs) {
+			if (Node.isJsxSpreadAttribute(attr)) {
+				const expr = attr.getExpression();
+				if (Node.isIdentifier(expr)) {
+					const spreadObj = resolveIdentifierToObject(sourceFile, expr.getText());
+					if (spreadObj) {
+						for (const key of Object.keys(props)) if (key in spreadObj) props[key] = spreadObj[key];
+					}
+				}
+				continue;
+			}
+			if (!Node.isJsxAttribute(attr)) continue;
+			const propName = attr.getNameNode().getText();
+			if (!(propName in props)) continue;
+			const initializer = attr.getInitializer();
+			if (initializer) {
+				if (Node.isStringLiteral(initializer)) props[propName] = initializer.getLiteralValue();
+				else if (Node.isJsxExpression(initializer)) {
+					const expr = initializer.getExpression();
+					if (expr && Node.isStringLiteral(expr)) props[propName] = expr.getLiteralValue();
+				}
+			}
+		}
+		const layoutPrefix = `--uds-motion-${props.layoutVariant ?? SPRING_MOTION_DEFAULTS.layoutVariant}-${props.layoutSpeed ?? SPRING_MOTION_DEFAULTS.layoutSpeed}-`;
+		if (!prefixes.includes(layoutPrefix)) prefixes.push(layoutPrefix);
+		const colorPrefix = `--uds-motion-${props.colorVariant ?? SPRING_MOTION_DEFAULTS.colorVariant}-${props.colorSpeed ?? SPRING_MOTION_DEFAULTS.colorSpeed}-`;
+		if (!prefixes.includes(colorPrefix)) prefixes.push(colorPrefix);
+	}
+	return prefixes;
+}
+
+//#endregion
+export { analyzeComponent, scanComponentFiles };

package/dist/tailwind/dist/purger/optimized/utils/files.cjs

@@ -0,0 +1,27 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../../../_virtual/_rolldown/runtime.cjs');
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let fast_glob = require("fast-glob");
+fast_glob = require_runtime.__toESM(fast_glob);
+
+//#region ../tailwind/dist/purger/optimized/utils/files.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Scan a directory for JSX/TSX files
+*/
+async function scanForFiles(entry) {
+	const workspaceDir = process.env.PWD ?? process.cwd();
+	const srcDir = node_path.default.join(workspaceDir, entry);
+	try {
+		return await (0, fast_glob.default)("**/*.{jsx,tsx}", {
+			cwd: srcDir,
+			absolute: true
+		});
+	} catch {
+		throw new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
+	}
+}
+
+//#endregion
+exports.scanForFiles = scanForFiles;

package/dist/tailwind/dist/purger/optimized/utils/files.js

@@ -0,0 +1,24 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import path from "node:path";
+import fg from "fast-glob";
+
+//#region ../tailwind/dist/purger/optimized/utils/files.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Scan a directory for JSX/TSX files
+*/
+async function scanForFiles(entry) {
+	const workspaceDir = process.env.PWD ?? process.cwd();
+	const srcDir = path.join(workspaceDir, entry);
+	try {
+		return await fg("**/*.{jsx,tsx}", {
+			cwd: srcDir,
+			absolute: true
+		});
+	} catch {
+		throw new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
+	}
+}
+
+//#endregion
+export { scanForFiles };

package/dist/tailwind/dist/purger/optimized/utils/safelist.cjs

@@ -0,0 +1,64 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../../../_virtual/_rolldown/runtime.cjs');
+const require_index = require('../../../../../css-tokens/dist/index.cjs');
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_fs = require("node:fs");
+
+//#region ../tailwind/dist/purger/optimized/utils/safelist.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const colorModeToClass = {
+	dark: require_index.DARK_COLOR_MODE_CLASSNAME,
+	light: require_index.LIGHT_COLOR_MODE_CLASSNAME
+};
+/**
+* Deduplicate and clean a safelist
+*/
+function deduplicateSafelist(safelist) {
+	const set = /* @__PURE__ */ new Set();
+	for (const cls of safelist) {
+		const cleaned = cls.replaceAll("\\", "").trim();
+		if (cleaned && isValidClassName(cleaned)) set.add(cleaned);
+	}
+	return Array.from(set);
+}
+/**
+* Check if a class name is valid (not malformed from CSS escape sequences)
+*/
+function isValidClassName(cls) {
+	if (cls.match(/^[0-9]/)) return false;
+	if (cls.match(/[0-9][a-z]$/)) return false;
+	if (cls.includes("2c")) return false;
+	if (cls.includes("0.")) return false;
+	return true;
+}
+/**
+* Get classes for enabled color modes.
+* Note: Light mode is not included by default since :root already defines light mode styles.
+* Only dark mode class is needed to enable dark mode switching.
+*/
+function getThemeAndScaleClasses(colorModes) {
+	const classes = [];
+	if (colorModes && colorModes.length > 0) {
+		for (const mode of colorModes) if (colorModeToClass[mode]) classes.push(colorModeToClass[mode]);
+	} else classes.push(colorModeToClass.dark);
+	return classes;
+}
+/**
+* Save safelist to a file
+*/
+async function saveSafelistToFile(safelist, outputPath) {
+	const content = `
+//! This file is generated by the optimized purger from @yahoo/uds
+//! Do not edit directly
+//! If there is issue with this file please report to #ask-uds
+export const safelist = ${JSON.stringify(safelist)};
+`;
+	(0, node_fs.mkdirSync)(node_path.default.dirname(outputPath), { recursive: true });
+	(0, node_fs.writeFileSync)(outputPath, content);
+}
+
+//#endregion
+exports.deduplicateSafelist = deduplicateSafelist;
+exports.getThemeAndScaleClasses = getThemeAndScaleClasses;
+exports.saveSafelistToFile = saveSafelistToFile;

package/dist/tailwind/dist/purger/optimized/utils/safelist.js

@@ -0,0 +1,60 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { DARK_COLOR_MODE_CLASSNAME, LIGHT_COLOR_MODE_CLASSNAME } from "../../../../../css-tokens/dist/index.js";
+import path from "node:path";
+import { mkdirSync, writeFileSync } from "node:fs";
+
+//#region ../tailwind/dist/purger/optimized/utils/safelist.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const colorModeToClass = {
+	dark: DARK_COLOR_MODE_CLASSNAME,
+	light: LIGHT_COLOR_MODE_CLASSNAME
+};
+/**
+* Deduplicate and clean a safelist
+*/
+function deduplicateSafelist(safelist) {
+	const set = /* @__PURE__ */ new Set();
+	for (const cls of safelist) {
+		const cleaned = cls.replaceAll("\\", "").trim();
+		if (cleaned && isValidClassName(cleaned)) set.add(cleaned);
+	}
+	return Array.from(set);
+}
+/**
+* Check if a class name is valid (not malformed from CSS escape sequences)
+*/
+function isValidClassName(cls) {
+	if (cls.match(/^[0-9]/)) return false;
+	if (cls.match(/[0-9][a-z]$/)) return false;
+	if (cls.includes("2c")) return false;
+	if (cls.includes("0.")) return false;
+	return true;
+}
+/**
+* Get classes for enabled color modes.
+* Note: Light mode is not included by default since :root already defines light mode styles.
+* Only dark mode class is needed to enable dark mode switching.
+*/
+function getThemeAndScaleClasses(colorModes) {
+	const classes = [];
+	if (colorModes && colorModes.length > 0) {
+		for (const mode of colorModes) if (colorModeToClass[mode]) classes.push(colorModeToClass[mode]);
+	} else classes.push(colorModeToClass.dark);
+	return classes;
+}
+/**
+* Save safelist to a file
+*/
+async function saveSafelistToFile(safelist, outputPath) {
+	const content = `
+//! This file is generated by the optimized purger from @yahoo/uds
+//! Do not edit directly
+//! If there is issue with this file please report to #ask-uds
+export const safelist = ${JSON.stringify(safelist)};
+`;
+	mkdirSync(path.dirname(outputPath), { recursive: true });
+	writeFileSync(outputPath, content);
+}
+
+//#endregion
+export { deduplicateSafelist, getThemeAndScaleClasses, saveSafelistToFile };

package/dist/tailwind/dist/tailwind/utils/getColorModeStyles.cjs

@@ -3,6 +3,7 @@
 //#region ../tailwind/dist/tailwind/utils/getColorModeStyles.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
 function getColorModeStyles(tokens) {
+	if (!tokens.colorMode?.light?._vars || !tokens.colorMode?.dark?._vars) throw new Error("Invalid tokens configuration: missing colorMode.light._vars or colorMode.dark._vars. Ensure your uds.config.ts exports a valid UniversalTokensConfig.");
 	return {
 		light: {
 			colorScheme: "light",

package/dist/tailwind/dist/tailwind/utils/getColorModeStyles.js

@@ -2,6 +2,7 @@
 //#region ../tailwind/dist/tailwind/utils/getColorModeStyles.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
 function getColorModeStyles(tokens) {
+	if (!tokens.colorMode?.light?._vars || !tokens.colorMode?.dark?._vars) throw new Error("Invalid tokens configuration: missing colorMode.light._vars or colorMode.dark._vars. Ensure your uds.config.ts exports a valid UniversalTokensConfig.");
 	return {
 		light: {
 			colorScheme: "light",

package/dist/tailwind/dist/utils/tsMorph.cjs

@@ -1,7 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-let lodash_es = require("lodash-es");
 let ts_morph = require("ts-morph");
+let lodash_es = require("lodash-es");
 
 //#region ../tailwind/dist/utils/tsMorph.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */

package/dist/tokens/automation/index.cjs

@@ -1,5 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_generateDefaultClassName = require('../../automated-config/dist/utils/generateDefaultClassName.cjs');
 const require_generateSchemaKey = require('../../automated-config/dist/utils/generateSchemaKey.cjs');
 const require_buildConfigSchema = require('../../automated-config/dist/utils/buildConfigSchema.cjs');
 const require_cartesianProduct = require('../../automated-config/dist/utils/cartesianProduct.cjs');
@@ -43,7 +44,7 @@ exports.findFixtureType = require_buildConfigSchema.findFixtureType;
 exports.generateClassName = require_index.generateClassName;
 exports.generateConfigStyles = require_index.generateConfigStyles;
 exports.generateDeclaration = require_index.generateDeclaration;
-exports.generateDefaultClassName = require_index.generateDefaultClassName;
+exports.generateDefaultClassName = require_generateDefaultClassName.generateDefaultClassName;
 exports.generateKeyFromFlatConfigPath = require_generateKeyFromFlatConfigPath.generateKeyFromFlatConfigPath;
 exports.generateSchemaKey = require_generateSchemaKey.generateSchemaKey;
 exports.generateStyles = require_index.generateStyles;

package/dist/tokens/automation/index.d.cts

@@ -4,6 +4,7 @@ import { ComponentSchema, buildConfigSchema, findFixtureType } from "../../autom
 import { cartesianProduct } from "../../automated-config/dist/utils/cartesianProduct.cjs";
 import { coalesceConfigVariant } from "../../automated-config/dist/utils/coalesceConfigVariant.cjs";
 import { getConfigDefaultValue, isConfigDefaultValue } from "../../automated-config/dist/utils/defaults.cjs";
+import { generateDefaultClassName } from "../../automated-config/dist/utils/generateDefaultClassName.cjs";
 import { generateKeyFromFlatConfigPath } from "../../automated-config/dist/utils/generateKeyFromFlatConfigPath.cjs";
 import { generateSchemaKey } from "../../automated-config/dist/utils/generateSchemaKey.cjs";
 import { getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix } from "../../automated-config/dist/utils/getConfigVariantComponentStatesMatrix.cjs";
@@ -11,5 +12,5 @@ import { getConfigVariantProperties } from "../../automated-config/dist/utils/ge
 import { getConfigVariantPseudoStates } from "../../automated-config/dist/utils/getConfigVariantPseudoStates.cjs";
 import { getConfigVariants } from "../../automated-config/dist/utils/getConfigVariants.cjs";
 import { getConfigSubcomponents } from "../../automated-config/dist/utils/subcomponents.cjs";
-import { createComponentStates, createConfigurableProperty, createLayerConfig, createSubComponentConfig, createVariantConfig, createVariantConfigWithComponentStates, createVariantConfigWithProperties, generateClassName, generateConfigStyles, generateDeclaration, generateDefaultClassName, generateStyles, statePseudoMapDocsMode } from "../../automated-config/dist/utils/index.cjs";
+import { createComponentStates, createConfigurableProperty, createLayerConfig, createSubComponentConfig, createVariantConfig, createVariantConfigWithComponentStates, createVariantConfigWithProperties, generateClassName, generateConfigStyles, generateDeclaration, generateStyles, statePseudoMapDocsMode } from "../../automated-config/dist/utils/index.cjs";
 export { AvatarConfig, BadgeConfig, ButtonConfig, CheckboxConfig, ChipConfig, ComponentSchema, DividerConfig, IconButtonConfig, InputConfig, LinkConfig, MenuContentConfig, MenuItemConfig, RadioConfig, SwitchConfig, ToastConfig, TooltipConfig, buildConfigSchema, cartesianProduct, coalesceConfigVariant, createComponentStates, createConfigurableProperty, createLayerConfig, createSubComponentConfig, createVariantConfig, createVariantConfigWithComponentStates, createVariantConfigWithProperties, findFixtureType, generateClassName, generateConfigStyles, generateDeclaration, generateDefaultClassName, generateKeyFromFlatConfigPath, generateSchemaKey, generateStyles, getConfigDefaultValue, getConfigSubcomponents, getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix, getConfigVariantProperties, getConfigVariantPseudoStates, getConfigVariants, isConfigDefaultValue, statePseudoMapDocsMode };

package/dist/tokens/automation/index.d.ts

@@ -4,6 +4,7 @@ import { ComponentSchema, buildConfigSchema, findFixtureType } from "../../autom
 import { cartesianProduct } from "../../automated-config/dist/utils/cartesianProduct.js";
 import { coalesceConfigVariant } from "../../automated-config/dist/utils/coalesceConfigVariant.js";
 import { getConfigDefaultValue, isConfigDefaultValue } from "../../automated-config/dist/utils/defaults.js";
+import { generateDefaultClassName } from "../../automated-config/dist/utils/generateDefaultClassName.js";
 import { generateKeyFromFlatConfigPath } from "../../automated-config/dist/utils/generateKeyFromFlatConfigPath.js";
 import { generateSchemaKey } from "../../automated-config/dist/utils/generateSchemaKey.js";
 import { getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix } from "../../automated-config/dist/utils/getConfigVariantComponentStatesMatrix.js";
@@ -11,5 +12,5 @@ import { getConfigVariantProperties } from "../../automated-config/dist/utils/ge
 import { getConfigVariantPseudoStates } from "../../automated-config/dist/utils/getConfigVariantPseudoStates.js";
 import { getConfigVariants } from "../../automated-config/dist/utils/getConfigVariants.js";
 import { getConfigSubcomponents } from "../../automated-config/dist/utils/subcomponents.js";
-import { createComponentStates, createConfigurableProperty, createLayerConfig, createSubComponentConfig, createVariantConfig, createVariantConfigWithComponentStates, createVariantConfigWithProperties, generateClassName, generateConfigStyles, generateDeclaration, generateDefaultClassName, generateStyles, statePseudoMapDocsMode } from "../../automated-config/dist/utils/index.js";
+import { createComponentStates, createConfigurableProperty, createLayerConfig, createSubComponentConfig, createVariantConfig, createVariantConfigWithComponentStates, createVariantConfigWithProperties, generateClassName, generateConfigStyles, generateDeclaration, generateStyles, statePseudoMapDocsMode } from "../../automated-config/dist/utils/index.js";
 export { AvatarConfig, BadgeConfig, ButtonConfig, CheckboxConfig, ChipConfig, ComponentSchema, DividerConfig, IconButtonConfig, InputConfig, LinkConfig, MenuContentConfig, MenuItemConfig, RadioConfig, SwitchConfig, ToastConfig, TooltipConfig, buildConfigSchema, cartesianProduct, coalesceConfigVariant, createComponentStates, createConfigurableProperty, createLayerConfig, createSubComponentConfig, createVariantConfig, createVariantConfigWithComponentStates, createVariantConfigWithProperties, findFixtureType, generateClassName, generateConfigStyles, generateDeclaration, generateDefaultClassName, generateKeyFromFlatConfigPath, generateSchemaKey, generateStyles, getConfigDefaultValue, getConfigSubcomponents, getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix, getConfigVariantProperties, getConfigVariantPseudoStates, getConfigVariants, isConfigDefaultValue, statePseudoMapDocsMode };