@yahoo/uds 3.114.0 → 3.115.0-beta.2

package/dist/tailwind/dist/css/generate.helpers.cjs

@@ -0,0 +1,112 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_utils = require('./utils.cjs');
+const require_plugin = require('../plugin.cjs');
+const require_optimizeCSS = require('../utils/optimizeCSS.cjs');
+const require_postcssPreserveVars = require('../utils/postcssPreserveVars.cjs');
+const require_postcss = require('./postcss.cjs');
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let postcss = require("postcss");
+postcss = require_runtime.__toESM(postcss);
+let autoprefixer = require("autoprefixer");
+autoprefixer = require_runtime.__toESM(autoprefixer);
+let postcss_prune_var = require("postcss-prune-var");
+postcss_prune_var = require_runtime.__toESM(postcss_prune_var);
+let postcss_scope = require("postcss-scope");
+postcss_scope = require_runtime.__toESM(postcss_scope);
+let tailwindcss = require("tailwindcss");
+tailwindcss = require_runtime.__toESM(tailwindcss);
+
+//#region ../tailwind/dist/css/generate.helpers.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const getCssFeatureFlags = (cssOptions) => {
+	const optimizationConfig = cssOptions?.optimization;
+	const shouldOptimize = optimizationConfig?.enabled !== false;
+	return {
+		enablePreflight: cssOptions?.preflight !== false,
+		enableFontFaceDeclarations: cssOptions?.fontFaceDeclarations !== false,
+		shouldOptimize,
+		shouldPruneVars: shouldOptimize && optimizationConfig?.pruneVars !== false
+	};
+};
+const getContentGlobs = (contentDir) => [node_path.default.join(contentDir, "**/*.{js,jsx,ts,tsx}")];
+const createTailwindPlugin = (options) => {
+	return (0, tailwindcss.default)({
+		content: getContentGlobs(options.contentDir),
+		safelist: options.safelist,
+		corePlugins: { preflight: options.enablePreflight },
+		plugins: [require_plugin.tailwindPlugin({
+			config: options.config,
+			disableFontFaceDeclarations: !options.enableFontFaceDeclarations,
+			ignorePluginSafelists: true
+		})]
+	});
+};
+const getPruneVarPlugins = (safeVarPrefixes) => {
+	if (safeVarPrefixes.length === 0) return [(0, postcss_prune_var.default)()];
+	return [
+		require_postcssPreserveVars.preserveVars({ preserve: safeVarPrefixes }),
+		(0, postcss_prune_var.default)(),
+		require_postcssPreserveVars.preserveVarsCleanup()
+	];
+};
+const buildPostcssPlugins = (options) => {
+	const plugins = [options.tailwindPlugin, (0, autoprefixer.default)()];
+	if (options.shouldPruneVars) plugins.push(...getPruneVarPlugins(options.safeVarPrefixes));
+	if (options.scopeClass) plugins.push((0, postcss_scope.default)(options.scopeClass));
+	return plugins;
+};
+const applyScopedColorModeFix = async (css, scopeClass) => {
+	if (!scopeClass) return css;
+	return (await (0, postcss.default)([require_postcss.fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, { from: void 0 })).css;
+};
+const optimizeGeneratedCss = async (options) => {
+	if (!options.shouldOptimize) return { css: options.css };
+	const optimizationOptions = {
+		removeUnusedFonts: options.optimizationConfig?.removeUnusedFonts,
+		removeEmptyRules: options.optimizationConfig?.removeEmptyRules,
+		aggregateDuplicateSelectors: options.optimizationConfig?.aggregateDuplicateSelectors,
+		referenceCss: options.referenceCss,
+		scopeClass: options.scopeClass
+	};
+	const optimized = await require_optimizeCSS.optimizeCSS(options.css, optimizationOptions);
+	return {
+		css: optimized.css,
+		optimizationStats: {
+			originalSize: optimized.stats.originalSize,
+			originalSizeGzip: optimized.stats.originalSizeGzip,
+			fontFacesRemoved: optimized.stats.fontFacesRemoved,
+			emptyRulesRemoved: optimized.stats.emptyRulesRemoved,
+			validationErrors: optimized.validation.errors
+		}
+	};
+};
+const printSimpleModeStats = (options) => {
+	const { print, magenta, cyan, yellow } = options;
+	print("");
+	print(`${magenta("Output:")} ${cyan(options.outputPath)}`);
+	print(`${magenta("Stats:")}`);
+	print(`   Files scanned: ${options.totalFilesScanned}`);
+	print(`   Classes: ${options.classCount}`);
+	print(`   Size: ${require_utils.formatBytes(options.sizeBytes)} (${require_utils.formatBytes(options.sizeGzipBytes)} gzipped)`);
+	const optimizationStats = options.optimizationStats;
+	if (optimizationStats) {
+		const savedBytesGzip = optimizationStats.originalSizeGzip - options.sizeGzipBytes;
+		if (savedBytesGzip > 0) print(`   Optimized: saved ${require_utils.formatBytes(savedBytesGzip)} gzip (${optimizationStats.fontFacesRemoved} unused @font-face, ${optimizationStats.emptyRulesRemoved} empty rules removed)`);
+		if (optimizationStats.validationErrors.length > 0) {
+			print(`   ${yellow("Validation warnings:")}`);
+			optimizationStats.validationErrors.forEach((error) => print(`      ${yellow("•")} ${error}`));
+		}
+	}
+	print(`   Time: ${options.duration}ms`);
+	if (options.scope) print(`   Scope: ${cyan(options.scope)}`);
+};
+
+//#endregion
+exports.applyScopedColorModeFix = applyScopedColorModeFix;
+exports.buildPostcssPlugins = buildPostcssPlugins;
+exports.createTailwindPlugin = createTailwindPlugin;
+exports.getCssFeatureFlags = getCssFeatureFlags;
+exports.optimizeGeneratedCss = optimizeGeneratedCss;
+exports.printSimpleModeStats = printSimpleModeStats;

package/dist/tailwind/dist/css/generate.helpers.js

@@ -0,0 +1,100 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { formatBytes } from "./utils.js";
+import { tailwindPlugin } from "../plugin.js";
+import { optimizeCSS } from "../utils/optimizeCSS.js";
+import { preserveVars, preserveVarsCleanup } from "../utils/postcssPreserveVars.js";
+import { fixScopedColorModeSelectorsPlugin } from "./postcss.js";
+import path from "node:path";
+import postcss from "postcss";
+import autoprefixer from "autoprefixer";
+import pruneVar from "postcss-prune-var";
+import postcssScope from "postcss-scope";
+import tailwindcss from "tailwindcss";
+
+//#region ../tailwind/dist/css/generate.helpers.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const getCssFeatureFlags = (cssOptions) => {
+	const optimizationConfig = cssOptions?.optimization;
+	const shouldOptimize = optimizationConfig?.enabled !== false;
+	return {
+		enablePreflight: cssOptions?.preflight !== false,
+		enableFontFaceDeclarations: cssOptions?.fontFaceDeclarations !== false,
+		shouldOptimize,
+		shouldPruneVars: shouldOptimize && optimizationConfig?.pruneVars !== false
+	};
+};
+const getContentGlobs = (contentDir) => [path.join(contentDir, "**/*.{js,jsx,ts,tsx}")];
+const createTailwindPlugin = (options) => {
+	return tailwindcss({
+		content: getContentGlobs(options.contentDir),
+		safelist: options.safelist,
+		corePlugins: { preflight: options.enablePreflight },
+		plugins: [tailwindPlugin({
+			config: options.config,
+			disableFontFaceDeclarations: !options.enableFontFaceDeclarations,
+			ignorePluginSafelists: true
+		})]
+	});
+};
+const getPruneVarPlugins = (safeVarPrefixes) => {
+	if (safeVarPrefixes.length === 0) return [pruneVar()];
+	return [
+		preserveVars({ preserve: safeVarPrefixes }),
+		pruneVar(),
+		preserveVarsCleanup()
+	];
+};
+const buildPostcssPlugins = (options) => {
+	const plugins = [options.tailwindPlugin, autoprefixer()];
+	if (options.shouldPruneVars) plugins.push(...getPruneVarPlugins(options.safeVarPrefixes));
+	if (options.scopeClass) plugins.push(postcssScope(options.scopeClass));
+	return plugins;
+};
+const applyScopedColorModeFix = async (css, scopeClass) => {
+	if (!scopeClass) return css;
+	return (await postcss([fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, { from: void 0 })).css;
+};
+const optimizeGeneratedCss = async (options) => {
+	if (!options.shouldOptimize) return { css: options.css };
+	const optimizationOptions = {
+		removeUnusedFonts: options.optimizationConfig?.removeUnusedFonts,
+		removeEmptyRules: options.optimizationConfig?.removeEmptyRules,
+		aggregateDuplicateSelectors: options.optimizationConfig?.aggregateDuplicateSelectors,
+		referenceCss: options.referenceCss,
+		scopeClass: options.scopeClass
+	};
+	const optimized = await optimizeCSS(options.css, optimizationOptions);
+	return {
+		css: optimized.css,
+		optimizationStats: {
+			originalSize: optimized.stats.originalSize,
+			originalSizeGzip: optimized.stats.originalSizeGzip,
+			fontFacesRemoved: optimized.stats.fontFacesRemoved,
+			emptyRulesRemoved: optimized.stats.emptyRulesRemoved,
+			validationErrors: optimized.validation.errors
+		}
+	};
+};
+const printSimpleModeStats = (options) => {
+	const { print, magenta, cyan, yellow } = options;
+	print("");
+	print(`${magenta("Output:")} ${cyan(options.outputPath)}`);
+	print(`${magenta("Stats:")}`);
+	print(`   Files scanned: ${options.totalFilesScanned}`);
+	print(`   Classes: ${options.classCount}`);
+	print(`   Size: ${formatBytes(options.sizeBytes)} (${formatBytes(options.sizeGzipBytes)} gzipped)`);
+	const optimizationStats = options.optimizationStats;
+	if (optimizationStats) {
+		const savedBytesGzip = optimizationStats.originalSizeGzip - options.sizeGzipBytes;
+		if (savedBytesGzip > 0) print(`   Optimized: saved ${formatBytes(savedBytesGzip)} gzip (${optimizationStats.fontFacesRemoved} unused @font-face, ${optimizationStats.emptyRulesRemoved} empty rules removed)`);
+		if (optimizationStats.validationErrors.length > 0) {
+			print(`   ${yellow("Validation warnings:")}`);
+			optimizationStats.validationErrors.forEach((error) => print(`      ${yellow("•")} ${error}`));
+		}
+	}
+	print(`   Time: ${options.duration}ms`);
+	if (options.scope) print(`   Scope: ${cyan(options.scope)}`);
+};
+
+//#endregion
+export { applyScopedColorModeFix, buildPostcssPlugins, createTailwindPlugin, getCssFeatureFlags, optimizeGeneratedCss, printSimpleModeStats };

package/dist/tailwind/dist/css/generate.js

@@ -0,0 +1,116 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { defaultTokensConfig } from "../../../config/dist/index.js";
+import { cyan, magenta, yellow } from "../../../cli/dist/lib/colors.js";
+import { print } from "../../../cli/dist/lib/print.js";
+import { spinStop } from "../../../cli/dist/lib/spinner.js";
+import { loadConfigFile, scanDirectoryForSafelist } from "./nodeUtils.js";
+import { deduplicateSafelist, getThemeAndScaleClasses } from "../purger/optimized/utils/safelist.js";
+import { extractVariantDefaults, getConfigurableCssVariables, getMotionVarPrefixes } from "./utils.js";
+import { applyScopedColorModeFix, buildPostcssPlugins, createTailwindPlugin, getCssFeatureFlags, optimizeGeneratedCss, printSimpleModeStats } from "./generate.helpers.js";
+import path from "node:path";
+import fs from "node:fs";
+import { gzipSync } from "node:zlib";
+import postcss from "postcss";
+
+//#region ../tailwind/dist/css/generate.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const normalizeScope = (scope) => {
+	const trimmedScope = scope?.trim();
+	return trimmedScope ? trimmedScope : void 0;
+};
+/**
+* Generate CSS from a safelist using Tailwind + PostCSS
+* @param safelist - UDS component classes to include
+* @param config - Token configuration
+* @param options - Additional options
+*/
+const generateCSS = async (safelist, config, options) => {
+	const sourceCSS = "@tailwind base; @tailwind components; @tailwind utilities";
+	const contentDir = options?.contentDir ?? path.join(process.cwd(), "src");
+	const cssFlags = getCssFeatureFlags(options?.cssOptions);
+	const optimizationConfig = options?.cssOptions?.optimization;
+	const scopeClass = normalizeScope(options?.scope) ?? normalizeScope(options?.cssOptions?.scope);
+	let css = await applyScopedColorModeFix((await postcss(buildPostcssPlugins({
+		tailwindPlugin: createTailwindPlugin({
+			contentDir,
+			safelist,
+			config,
+			enablePreflight: cssFlags.enablePreflight,
+			enableFontFaceDeclarations: cssFlags.enableFontFaceDeclarations
+		}),
+		shouldPruneVars: cssFlags.shouldPruneVars,
+		safeVarPrefixes: options?.safeVarPrefixes ?? [],
+		scopeClass
+	})).process(sourceCSS, { from: void 0 })).css, scopeClass);
+	const optimizedCss = await optimizeGeneratedCss({
+		css,
+		shouldOptimize: cssFlags.shouldOptimize,
+		optimizationConfig,
+		referenceCss: options?.referenceCss,
+		scopeClass
+	});
+	css = optimizedCss.css;
+	const sizeBytes = Buffer.byteLength(css, "utf8");
+	const sizeGzipBytes = gzipSync(css).length;
+	return {
+		css,
+		sizeBytes,
+		sizeGzipBytes,
+		classCount: safelist.length,
+		optimizationStats: optimizedCss.optimizationStats
+	};
+};
+/**
+* Generate CSS in simple mode (no uds.theme.ts)
+*/
+const generateSimpleModeCSS = async (options) => {
+	const isWatch = options.isWatch === true;
+	const shouldLogStats = !(options.silent === true) && !isWatch;
+	const startTime = performance.now();
+	const colorModes = ["dark"];
+	let tokensConfig = defaultTokensConfig;
+	if (options.configPath) {
+		const loadedConfig = await loadConfigFile(options.configPath);
+		if (loadedConfig) tokensConfig = loadedConfig;
+		else if (shouldLogStats) spinStop("⚠️", `Config file not found: ${options.configPath}, using defaults`);
+	}
+	const variantDefaults = extractVariantDefaults(tokensConfig);
+	const entryDir = path.join(options.workspaceDir, options.entry);
+	const scanResult = await scanDirectoryForSafelist(entryDir, colorModes, options.variants, options.autoVariants, options.componentData, variantDefaults);
+	const totalFilesScanned = scanResult.filesScanned;
+	const allClasses = [...scanResult.safelist];
+	const allComponents = new Set(scanResult.components);
+	const packageDirs = [entryDir];
+	const cssResult = await generateCSS(deduplicateSafelist([...allClasses, ...getThemeAndScaleClasses(colorModes)]), tokensConfig, {
+		scope: options.scope,
+		contentDir: entryDir,
+		safeVarPrefixes: [...getMotionVarPrefixes(options.componentData, [...allComponents]), ...getConfigurableCssVariables()]
+	});
+	const outputPath = path.isAbsolute(options.outFile) ? options.outFile : path.join(options.workspaceDir, options.outFile);
+	const outputDir = path.dirname(outputPath);
+	if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+	fs.writeFileSync(outputPath, cssResult.css);
+	const duration = Math.round(performance.now() - startTime);
+	if (shouldLogStats) printSimpleModeStats({
+		outputPath,
+		totalFilesScanned,
+		classCount: cssResult.classCount,
+		sizeBytes: cssResult.sizeBytes,
+		sizeGzipBytes: cssResult.sizeGzipBytes,
+		duration,
+		scope: options.scope,
+		optimizationStats: cssResult.optimizationStats,
+		print,
+		magenta,
+		cyan,
+		yellow
+	});
+	return {
+		success: true,
+		outputPath,
+		packageDirs
+	};
+};
+
+//#endregion
+export { generateCSS, generateSimpleModeCSS };

package/dist/tailwind/dist/css/nodeUtils.cjs

@@ -0,0 +1,156 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_colors = require('../../../cli/dist/lib/colors.cjs');
+const require_print = require('../../../cli/dist/lib/print.cjs');
+const require_purgeFromCode = require('../purger/optimized/purgeFromCode.cjs');
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_module = require("node:module");
+let fast_glob = require("fast-glob");
+fast_glob = require_runtime.__toESM(fast_glob);
+
+//#region ../tailwind/dist/css/nodeUtils.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const loadConfigFile = async (configPath) => {
+	const absolutePath = node_path.default.isAbsolute(configPath) ? configPath : node_path.default.join(process.cwd(), configPath);
+	if (!node_fs.default.existsSync(absolutePath)) return null;
+	try {
+		const module = await import(absolutePath);
+		return module.default ?? module.config ?? module;
+	} catch (error) {
+		throw new Error(`Failed to load config file: ${absolutePath}\n${error instanceof Error ? error.message : "Unknown error"}`);
+	}
+};
+const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, includeAllClassNamePrimitives = false) => {
+	const files = await (0, fast_glob.default)("**/*.{js,jsx,ts,tsx}", {
+		cwd: dir,
+		absolute: true,
+		ignore: ["**/node_modules/**"]
+	});
+	const results = await Promise.all(files.map(async (filePath) => {
+		return require_purgeFromCode.purgeFromCodeOptimized(node_fs.default.readFileSync(filePath, "utf-8"), {
+			colorModes,
+			variantDefaults,
+			variants,
+			autoVariants,
+			componentData,
+			includeAllClassNamePrimitives
+		});
+	}));
+	return {
+		safelist: results.flatMap((result) => result.safelist),
+		components: [...new Set(results.flatMap((result) => result.components))],
+		filesScanned: files.length
+	};
+};
+const findMonorepoRoot = (startDir) => {
+	const findUp = (currentDir) => {
+		if (node_fs.default.existsSync(node_path.default.join(currentDir, "packages"))) return currentDir;
+		const parentDir = node_path.default.dirname(currentDir);
+		return parentDir === currentDir ? null : findUp(parentDir);
+	};
+	return findUp(startDir);
+};
+const resolvePackageRoot = (workspaceDir, packageName) => {
+	const require = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+	try {
+		const resolvedPackageJson = require.resolve(node_path.default.join(packageName, "package.json"), { paths: [workspaceDir] });
+		return node_path.default.dirname(resolvedPackageJson);
+	} catch {
+		return null;
+	}
+};
+const findPackageRootInMonorepo = (monorepoRoot, packageName) => {
+	const matchingPath = fast_glob.default.sync("packages/**/package.json", {
+		cwd: monorepoRoot,
+		absolute: true,
+		ignore: ["**/node_modules/**", "**/dist/**"]
+	}).find((pkgJsonPath) => {
+		try {
+			return JSON.parse(node_fs.default.readFileSync(pkgJsonPath, "utf8")).name === packageName;
+		} catch {
+			return false;
+		}
+	});
+	return matchingPath ? node_path.default.dirname(matchingPath) : null;
+};
+const buildPackageSourceCandidates = (workspaceDir, packageName, packageRoot) => {
+	return [
+		packageRoot ? node_path.default.join(packageRoot, "src") : null,
+		packageRoot ? node_path.default.join(packageRoot, "lib") : null,
+		packageRoot ? node_path.default.join(packageRoot, "dist") : null,
+		packageRoot,
+		node_path.default.join(workspaceDir, "node_modules", packageName, "src"),
+		node_path.default.join(workspaceDir, "node_modules", packageName, "lib"),
+		node_path.default.join(workspaceDir, "node_modules", packageName, "dist"),
+		node_path.default.join(workspaceDir, "node_modules", packageName)
+	].filter(Boolean);
+};
+const getFirstExistingPath = (candidates) => candidates.find((candidate) => node_fs.default.existsSync(candidate)) ?? null;
+const findPackageSourceDir = (packageName) => {
+	const workspaceDir = process.cwd();
+	const monorepoRoot = findMonorepoRoot(workspaceDir);
+	let packageRoot = resolvePackageRoot(workspaceDir, packageName);
+	if (!packageRoot && monorepoRoot) packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);
+	return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));
+};
+const scaffoldThemeConfig = async (options) => {
+	const workspaceDir = process.cwd();
+	const outputPath = options.outputPath ?? "uds.theme.ts";
+	const absoluteOutputPath = node_path.default.isAbsolute(outputPath) ? outputPath : node_path.default.join(workspaceDir, outputPath);
+	if (node_fs.default.existsSync(absoluteOutputPath) && !options.force) {
+		require_print.print(require_colors.red(`Error: ${outputPath} already exists. Use --force to overwrite.`));
+		process.exitCode = 1;
+		return;
+	}
+	const template = `import { defineTheme } from '@yahoo/uds';
+
+/**
+ * UDS Theme Configuration
+ * 
+ * This file configures CSS generation for your app and shared packages.
+ * Run \`uds css\` to generate optimized CSS.
+ */
+export default defineTheme({
+  // Path to your uds.config.ts file
+  config: '${options.configPath ?? "./uds.config.ts"}',
+
+  // Entry directory for scanning your app code
+  entry: '${options.entry ?? "./src"}',
+
+  // Color modes to include (light mode is always in :root)
+  colorModes: ['dark'],
+
+  // Packages that inherit your app's theme (merged into main uds.css)
+  // inherit: ['@your-org/shared-ui'],
+
+  // CSS generation options (all optional)
+  // css: {
+  //   safelist: [],
+  //   preflight: true,
+  //   fontFaceDeclarations: true,
+  //   optimization: {
+  //     removeUnusedFonts: false,
+  //     removeEmptyRules: true,
+  //     deduplicateScopedCss: true
+  //   }
+  // }
+});
+`;
+	node_fs.default.writeFileSync(absoluteOutputPath, template);
+	require_print.print("");
+	require_print.print(require_colors.green("✅ Created uds.theme.ts"));
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Next steps:")}`);
+	require_print.print(`   1. Review and customize ${require_colors.cyan(outputPath)}`);
+	require_print.print(`   2. Run ${require_colors.cyan("uds css")} to generate CSS`);
+	require_print.print("");
+};
+
+//#endregion
+exports.findPackageSourceDir = findPackageSourceDir;
+exports.loadConfigFile = loadConfigFile;
+exports.scaffoldThemeConfig = scaffoldThemeConfig;
+exports.scanDirectoryForSafelist = scanDirectoryForSafelist;

package/dist/tailwind/dist/css/nodeUtils.js

@@ -0,0 +1,149 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { cyan, green, magenta, red } from "../../../cli/dist/lib/colors.js";
+import { print } from "../../../cli/dist/lib/print.js";
+import { purgeFromCodeOptimized } from "../purger/optimized/purgeFromCode.js";
+import path from "node:path";
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import fg from "fast-glob";
+
+//#region ../tailwind/dist/css/nodeUtils.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const loadConfigFile = async (configPath) => {
+	const absolutePath = path.isAbsolute(configPath) ? configPath : path.join(process.cwd(), configPath);
+	if (!fs.existsSync(absolutePath)) return null;
+	try {
+		const module = await import(absolutePath);
+		return module.default ?? module.config ?? module;
+	} catch (error) {
+		throw new Error(`Failed to load config file: ${absolutePath}\n${error instanceof Error ? error.message : "Unknown error"}`);
+	}
+};
+const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, includeAllClassNamePrimitives = false) => {
+	const files = await fg("**/*.{js,jsx,ts,tsx}", {
+		cwd: dir,
+		absolute: true,
+		ignore: ["**/node_modules/**"]
+	});
+	const results = await Promise.all(files.map(async (filePath) => {
+		return purgeFromCodeOptimized(fs.readFileSync(filePath, "utf-8"), {
+			colorModes,
+			variantDefaults,
+			variants,
+			autoVariants,
+			componentData,
+			includeAllClassNamePrimitives
+		});
+	}));
+	return {
+		safelist: results.flatMap((result) => result.safelist),
+		components: [...new Set(results.flatMap((result) => result.components))],
+		filesScanned: files.length
+	};
+};
+const findMonorepoRoot = (startDir) => {
+	const findUp = (currentDir) => {
+		if (fs.existsSync(path.join(currentDir, "packages"))) return currentDir;
+		const parentDir = path.dirname(currentDir);
+		return parentDir === currentDir ? null : findUp(parentDir);
+	};
+	return findUp(startDir);
+};
+const resolvePackageRoot = (workspaceDir, packageName) => {
+	const require = createRequire(import.meta.url);
+	try {
+		const resolvedPackageJson = require.resolve(path.join(packageName, "package.json"), { paths: [workspaceDir] });
+		return path.dirname(resolvedPackageJson);
+	} catch {
+		return null;
+	}
+};
+const findPackageRootInMonorepo = (monorepoRoot, packageName) => {
+	const matchingPath = fg.sync("packages/**/package.json", {
+		cwd: monorepoRoot,
+		absolute: true,
+		ignore: ["**/node_modules/**", "**/dist/**"]
+	}).find((pkgJsonPath) => {
+		try {
+			return JSON.parse(fs.readFileSync(pkgJsonPath, "utf8")).name === packageName;
+		} catch {
+			return false;
+		}
+	});
+	return matchingPath ? path.dirname(matchingPath) : null;
+};
+const buildPackageSourceCandidates = (workspaceDir, packageName, packageRoot) => {
+	return [
+		packageRoot ? path.join(packageRoot, "src") : null,
+		packageRoot ? path.join(packageRoot, "lib") : null,
+		packageRoot ? path.join(packageRoot, "dist") : null,
+		packageRoot,
+		path.join(workspaceDir, "node_modules", packageName, "src"),
+		path.join(workspaceDir, "node_modules", packageName, "lib"),
+		path.join(workspaceDir, "node_modules", packageName, "dist"),
+		path.join(workspaceDir, "node_modules", packageName)
+	].filter(Boolean);
+};
+const getFirstExistingPath = (candidates) => candidates.find((candidate) => fs.existsSync(candidate)) ?? null;
+const findPackageSourceDir = (packageName) => {
+	const workspaceDir = process.cwd();
+	const monorepoRoot = findMonorepoRoot(workspaceDir);
+	let packageRoot = resolvePackageRoot(workspaceDir, packageName);
+	if (!packageRoot && monorepoRoot) packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);
+	return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));
+};
+const scaffoldThemeConfig = async (options) => {
+	const workspaceDir = process.cwd();
+	const outputPath = options.outputPath ?? "uds.theme.ts";
+	const absoluteOutputPath = path.isAbsolute(outputPath) ? outputPath : path.join(workspaceDir, outputPath);
+	if (fs.existsSync(absoluteOutputPath) && !options.force) {
+		print(red(`Error: ${outputPath} already exists. Use --force to overwrite.`));
+		process.exitCode = 1;
+		return;
+	}
+	const template = `import { defineTheme } from '@yahoo/uds';
+
+/**
+ * UDS Theme Configuration
+ * 
+ * This file configures CSS generation for your app and shared packages.
+ * Run \`uds css\` to generate optimized CSS.
+ */
+export default defineTheme({
+  // Path to your uds.config.ts file
+  config: '${options.configPath ?? "./uds.config.ts"}',
+
+  // Entry directory for scanning your app code
+  entry: '${options.entry ?? "./src"}',
+
+  // Color modes to include (light mode is always in :root)
+  colorModes: ['dark'],
+
+  // Packages that inherit your app's theme (merged into main uds.css)
+  // inherit: ['@your-org/shared-ui'],
+
+  // CSS generation options (all optional)
+  // css: {
+  //   safelist: [],
+  //   preflight: true,
+  //   fontFaceDeclarations: true,
+  //   optimization: {
+  //     removeUnusedFonts: false,
+  //     removeEmptyRules: true,
+  //     deduplicateScopedCss: true
+  //   }
+  // }
+});
+`;
+	fs.writeFileSync(absoluteOutputPath, template);
+	print("");
+	print(green("✅ Created uds.theme.ts"));
+	print("");
+	print(`${magenta("Next steps:")}`);
+	print(`   1. Review and customize ${cyan(outputPath)}`);
+	print(`   2. Run ${cyan("uds css")} to generate CSS`);
+	print("");
+};
+
+//#endregion
+export { findPackageSourceDir, loadConfigFile, scaffoldThemeConfig, scanDirectoryForSafelist };

package/dist/tailwind/dist/css/postcss.cjs

@@ -0,0 +1,35 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_postcss_helpers = require('./postcss.helpers.cjs');
+
+//#region ../tailwind/dist/css/postcss.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* PostCSS plugin to fix color mode selectors for scoped CSS.
+*
+* postcss-scope converts selectors like:
+*   `.uds-color-mode-dark .foo` → `.scope .uds-color-mode-dark .foo`
+*
+* But the color mode class is typically on <html> or <body>, which is an
+* ANCESTOR of the scope, not a descendant. This plugin adds alternative
+* selectors so color modes work correctly:
+*
+*   `.scope .uds-color-mode-dark .foo` → `.scope .uds-color-mode-dark .foo, .uds-color-mode-dark .scope .foo`
+*
+* This ensures styles apply whether the color mode class is inside or outside the scope.
+*/
+const fixScopedColorModeSelectorsPlugin = (scopeClass) => {
+	const colorModePattern = /\.(uds-color-mode-(?:dark|light))/;
+	return {
+		postcssPlugin: "fix-scoped-color-mode-selectors",
+		Once(root) {
+			root.walkRules((rule) => {
+				if (!rule.selector.includes(scopeClass) || !colorModePattern.test(rule.selector)) return;
+				const nextSelector = require_postcss_helpers.buildScopedColorModeSelectorList(rule.selector, scopeClass);
+				if (nextSelector !== rule.selector) rule.selector = nextSelector;
+			});
+		}
+	};
+};
+
+//#endregion
+exports.fixScopedColorModeSelectorsPlugin = fixScopedColorModeSelectorsPlugin;