@yahoo/uds 3.113.0 → 3.114.0-beta.2

package/dist/tailwind/dist/css/runner.cjs

@@ -0,0 +1,278 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_index = require('../../../config/dist/index.cjs');
+const require_colors = require('../../../cli/dist/lib/colors.cjs');
+const require_print = require('../../../cli/dist/lib/print.cjs');
+const require_spinner = require('../../../cli/dist/lib/spinner.cjs');
+const require_logger = require('../../../cli/dist/lib/logger.cjs');
+const require_utils = require('./utils.cjs');
+const require_safelist = require('../purger/optimized/utils/safelist.cjs');
+const require_generate = require('./generate.cjs');
+const require_runner_helpers = require('./runner.helpers.cjs');
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+
+//#region ../tailwind/dist/css/runner.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const DEFAULT_ENTRY = "./src";
+const SOURCE_FILE_PATTERN = /\.(jsx?|tsx?)$/i;
+const getWatchDirs = (dirs) => [...new Set(dirs.filter((dir) => !dir.split(node_path.default.sep).includes("node_modules")))];
+const watchSourceFiles = (dirs, onFileChange) => {
+	dirs.forEach((dir) => {
+		node_fs.default.watch(dir, { recursive: true }, (_eventType, filename) => {
+			if (filename && SOURCE_FILE_PATTERN.test(filename)) onFileChange();
+		});
+	});
+};
+const createDebouncedAction = (action, delayMs) => {
+	let debounceTimer = null;
+	return () => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(action, delayMs);
+	};
+};
+const createQueuedRegenerator = (options) => {
+	let isGenerating = false;
+	let pendingRegenerate = false;
+	const regenerate = async () => {
+		if (isGenerating) {
+			pendingRegenerate = true;
+			return;
+		}
+		isGenerating = true;
+		try {
+			options.onStart?.();
+			const result = await options.regenerateOnce();
+			options.onSuccess?.(result);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : "CSS generation failed";
+			options.onError(message);
+		} finally {
+			isGenerating = false;
+			if (pendingRegenerate) {
+				pendingRegenerate = false;
+				await regenerate();
+			}
+		}
+	};
+	return regenerate;
+};
+const runCssCommand = async (options, context) => {
+	if (!node_fs.default.existsSync(node_path.default.join(options.workspaceDir, String(options.themeConfigPath)))) {
+		await runSimpleMode(options, context);
+		return;
+	}
+	await runThemeMode(options, context);
+};
+const runSimpleMode = async (options, context) => {
+	const entry = typeof options.entryOption === "string" ? options.entryOption : DEFAULT_ENTRY;
+	const configPath = typeof options.configOption === "string" ? options.configOption : void 0;
+	if (!options.watch && !options.silent) require_spinner.spinStart("Generating CSS...");
+	try {
+		const result = await require_generate.generateSimpleModeCSS({
+			workspaceDir: options.workspaceDir,
+			entry,
+			outFile: String(options.outFile),
+			variants: context.variants,
+			autoVariants: context.autoVariants,
+			componentData: context.componentData,
+			scope: options.scope,
+			configPath,
+			isWatch: options.watch,
+			silent: options.silent
+		});
+		if (options.watch) await runSimpleModeWatch(options, context, entry, configPath, result.packageDirs ?? []);
+	} catch (error) {
+		require_spinner.spinStop("❌", error instanceof Error ? error.message : "CSS generation failed");
+		process.exitCode = 1;
+	}
+};
+const runSimpleModeWatch = async (options, context, entry, configPath, packageDirs) => {
+	const entryDir = node_path.default.join(options.workspaceDir, entry);
+	const watchDirs = getWatchDirs(packageDirs.length > 0 ? packageDirs : [entryDir]);
+	if (!options.silent) {
+		require_print.print("");
+		require_print.print(`${require_colors.magenta("Watching for changes...")}`);
+		watchDirs.forEach((dir) => require_print.print(`   ${require_colors.gray("•")} ${dir}`));
+		require_print.print(`${require_colors.gray("Press Ctrl+C to stop")}`);
+		require_print.print("");
+	}
+	const regenerate = createQueuedRegenerator({
+		onStart: () => {
+			if (!options.silent) require_print.print(`${require_colors.gray(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`)} Change detected, regenerating...`);
+		},
+		regenerateOnce: async () => {
+			await require_generate.generateSimpleModeCSS({
+				workspaceDir: options.workspaceDir,
+				entry,
+				outFile: String(options.outFile),
+				variants: context.variants,
+				autoVariants: context.autoVariants,
+				componentData: context.componentData,
+				scope: options.scope,
+				configPath,
+				isWatch: true,
+				silent: true
+			});
+		},
+		onSuccess: () => {
+			if (!options.silent) {
+				require_print.print(`${require_colors.gray(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`)} ${require_colors.green("CSS updated")}`);
+				require_print.print("");
+			}
+		},
+		onError: (message) => {
+			require_print.print(`Error: ${message}`);
+		}
+	});
+	watchSourceFiles(watchDirs, createDebouncedAction(() => {
+		regenerate();
+	}, 100));
+	await new Promise(() => {});
+};
+const loadThemeModeSetup = async (options) => {
+	const themeConfigInput = await require_utils.loadConfigFile(String(options.themeConfigPath));
+	if (!themeConfigInput) return null;
+	const themeContext = {
+		cwd: options.workspaceDir,
+		watch: options.watch
+	};
+	const themeConfig = typeof themeConfigInput === "function" ? await themeConfigInput(themeContext) : themeConfigInput;
+	let appConfig = require_index.defaultTokensConfig;
+	if (themeConfig.config) {
+		const loadedConfig = await require_utils.loadConfigFile(themeConfig.config);
+		if (loadedConfig) appConfig = loadedConfig;
+	}
+	return {
+		themeConfig,
+		colorModes: themeConfig.colorModes ?? ["dark"],
+		entry: themeConfig.entry ?? "/src/",
+		appConfig,
+		appVariantDefaults: require_utils.extractVariantDefaults(appConfig),
+		effectiveSilent: options.silent || themeConfig.silent === true
+	};
+};
+const runThemeMode = async (options, context) => {
+	const workspaceDir = options.workspaceDir;
+	const outputPath = node_path.default.isAbsolute(options.outFile) ? options.outFile : node_path.default.join(workspaceDir, String(options.outFile));
+	let effectiveSilent = options.silent;
+	let log = require_logger.createLogger({ silent: effectiveSilent });
+	log.spinStart("Loading theme configuration...");
+	try {
+		const setup = await loadThemeModeSetup(options);
+		if (!setup) {
+			log.spinStop("❌", `Theme config not found: ${options.themeConfigPath}`);
+			process.exitCode = 1;
+			return;
+		}
+		const { themeConfig, colorModes, entry, appConfig, appVariantDefaults } = setup;
+		effectiveSilent = setup.effectiveSilent;
+		log = require_logger.createLogger({ silent: effectiveSilent });
+		if (!effectiveSilent) log.spinStop("✅", "Theme configuration loaded");
+		if (themeConfig.config && appConfig === require_index.defaultTokensConfig) log.warn(`App config not found: ${themeConfig.config}, using defaults`);
+		const packageDirs = [];
+		const generateThemeModeCSS = async (opts) => {
+			const genStartTime = performance.now();
+			const genLog = opts?.isWatch ? require_logger.createLogger({ silent: true }) : log;
+			genLog.spinStart("Scanning app code...");
+			const appScanResult = await require_utils.scanDirectoryForSafelist(node_path.default.join(workspaceDir, entry), colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults);
+			genLog.spinStop("✅", `Scanned ${appScanResult.filesScanned} files`);
+			genLog.spinStart("Generating main CSS...");
+			const inheritedClasses = [...appScanResult.safelist];
+			const inheritedComponents = new Set(appScanResult.components);
+			const processInheritedPackage = async (packageName) => {
+				genLog.spinStart(`Processing package: ${packageName}...`);
+				const packageDir = require_utils.findPackageSourceDir(packageName);
+				if (!packageDir) {
+					genLog.spinStop("⚠️", `Package not found: ${packageName}`);
+					return;
+				}
+				if (!packageDirs.includes(packageDir)) packageDirs.push(packageDir);
+				const packageScanResult = await require_utils.scanDirectoryForSafelist(packageDir, colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults, true);
+				inheritedClasses.push(...packageScanResult.safelist);
+				packageScanResult.components.forEach((comp) => inheritedComponents.add(comp));
+				genLog.spinStop("✅", `${packageName}: ${packageScanResult.filesScanned} files (inherit)`);
+			};
+			await (themeConfig.inherit ?? []).reduce(async (promise, packageName) => {
+				await promise;
+				await processInheritedPackage(packageName);
+			}, Promise.resolve());
+			const mainSafelist = require_safelist.deduplicateSafelist([...inheritedClasses, ...require_safelist.getThemeAndScaleClasses(colorModes)]);
+			const allMotionComponents = [...inheritedComponents];
+			const mainCssResult = await require_generate.generateCSS([...themeConfig.css?.safelist ?? [], ...mainSafelist], appConfig, {
+				scope: options.scope,
+				contentDir: node_path.default.join(workspaceDir, entry),
+				cssOptions: themeConfig.css,
+				safeVarPrefixes: [...require_utils.getMotionVarPrefixes(context.componentData, allMotionComponents), ...require_utils.getConfigurableCssVariables()]
+			});
+			const outputDir = node_path.default.dirname(outputPath);
+			if (!node_fs.default.existsSync(outputDir)) node_fs.default.mkdirSync(outputDir, { recursive: true });
+			node_fs.default.writeFileSync(outputPath, mainCssResult.css);
+			genLog.spinStop("✅", require_runner_helpers.getMainCssSummaryMessage({
+				sizeGzipBytes: mainCssResult.sizeGzipBytes,
+				optimizationStats: mainCssResult.optimizationStats,
+				formatBytes: require_utils.formatBytes
+			}));
+			const duration = Math.round(performance.now() - genStartTime);
+			genLog.newline();
+			genLog.print(require_colors.green("CSS generation complete!"));
+			genLog.newline();
+			genLog.label("Output file:", outputPath);
+			genLog.newline();
+			genLog.print(`${require_colors.magenta("Total time:")} ${duration}ms`);
+			return {
+				duration,
+				outputPath,
+				packageDirs
+			};
+		};
+		await generateThemeModeCSS();
+		if (options.watch) {
+			const entryDir = node_path.default.join(workspaceDir, entry);
+			const { watchDirs, filteredPackageDirs } = require_runner_helpers.getWatchDirectoryGroups(entryDir, [entryDir, ...packageDirs]);
+			if (!effectiveSilent) {
+				log.newline();
+				log.print(`${require_colors.magenta("Watching for changes...")}`);
+				log.listItem(`App: ${entryDir}`);
+				filteredPackageDirs.forEach((dir) => {
+					log.listItem(`Package: ${dir}`);
+				});
+				log.print(`${require_colors.gray("Press Ctrl+C to stop")}`);
+				log.newline();
+			}
+			const regenerate = createQueuedRegenerator({
+				onStart: () => {
+					if (!effectiveSilent) {
+						const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+						log.print(`${require_colors.gray(`[${timestamp}]`)} Change detected, regenerating...`);
+					}
+				},
+				regenerateOnce: async () => generateThemeModeCSS({ isWatch: true }),
+				onSuccess: (result) => {
+					if (!effectiveSilent) {
+						const updatedAt = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+						log.print(`${require_colors.gray(`[${updatedAt}]`)} ${require_colors.green(`CSS updated (${result?.duration}ms)`)}`);
+						log.newline();
+					}
+				},
+				onError: (message) => {
+					log.print(message);
+				}
+			});
+			watchSourceFiles(watchDirs, createDebouncedAction(() => {
+				regenerate();
+			}, themeConfig.css?.watchDebounce ?? 100));
+			await new Promise(() => {});
+		}
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "CSS generation failed";
+		if (effectiveSilent) require_spinner.spinStop("❌", message);
+		else log.spinStop("❌", message);
+		process.exitCode = 1;
+	}
+};
+
+//#endregion
+exports.runCssCommand = runCssCommand;

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

@@ -0,0 +1,26 @@
+/*! © 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);
+
+//#region ../tailwind/dist/css/runner.helpers.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const getMainCssSummaryMessage = (options) => {
+	const { optimizationStats, sizeGzipBytes, formatBytes } = options;
+	if (!optimizationStats) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
+	const { originalSizeGzip, fontFacesRemoved, emptyRulesRemoved } = optimizationStats;
+	const savedBytesGzip = originalSizeGzip - sizeGzipBytes;
+	if (savedBytesGzip <= 0) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
+	return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip)(optimized: saved ${formatBytes(savedBytesGzip)} gzip, ${fontFacesRemoved} unused @font-face, ${emptyRulesRemoved} empty rules removed)`;
+};
+const getWatchDirectoryGroups = (entryDir, dirs) => {
+	const watchDirs = [...new Set(dirs.filter((dir) => !dir.split(node_path.default.sep).includes("node_modules")))];
+	return {
+		watchDirs,
+		filteredPackageDirs: watchDirs.filter((dir) => dir !== entryDir)
+	};
+};
+
+//#endregion
+exports.getMainCssSummaryMessage = getMainCssSummaryMessage;
+exports.getWatchDirectoryGroups = getWatchDirectoryGroups;

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

@@ -0,0 +1,23 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import path from "node:path";
+
+//#region ../tailwind/dist/css/runner.helpers.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const getMainCssSummaryMessage = (options) => {
+	const { optimizationStats, sizeGzipBytes, formatBytes } = options;
+	if (!optimizationStats) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
+	const { originalSizeGzip, fontFacesRemoved, emptyRulesRemoved } = optimizationStats;
+	const savedBytesGzip = originalSizeGzip - sizeGzipBytes;
+	if (savedBytesGzip <= 0) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
+	return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip)(optimized: saved ${formatBytes(savedBytesGzip)} gzip, ${fontFacesRemoved} unused @font-face, ${emptyRulesRemoved} empty rules removed)`;
+};
+const getWatchDirectoryGroups = (entryDir, dirs) => {
+	const watchDirs = [...new Set(dirs.filter((dir) => !dir.split(path.sep).includes("node_modules")))];
+	return {
+		watchDirs,
+		filteredPackageDirs: watchDirs.filter((dir) => dir !== entryDir)
+	};
+};
+
+//#endregion
+export { getMainCssSummaryMessage, getWatchDirectoryGroups };

package/dist/tailwind/dist/css/runner.js

@@ -0,0 +1,275 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { defaultTokensConfig } from "../../../config/dist/index.js";
+import { gray, green, magenta } from "../../../cli/dist/lib/colors.js";
+import { print } from "../../../cli/dist/lib/print.js";
+import { spinStart, spinStop } from "../../../cli/dist/lib/spinner.js";
+import { createLogger } from "../../../cli/dist/lib/logger.js";
+import { extractVariantDefaults, findPackageSourceDir, formatBytes, getConfigurableCssVariables, getMotionVarPrefixes, loadConfigFile, scanDirectoryForSafelist } from "./utils.js";
+import { deduplicateSafelist, getThemeAndScaleClasses } from "../purger/optimized/utils/safelist.js";
+import { generateCSS, generateSimpleModeCSS } from "./generate.js";
+import { getMainCssSummaryMessage, getWatchDirectoryGroups } from "./runner.helpers.js";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region ../tailwind/dist/css/runner.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const DEFAULT_ENTRY = "./src";
+const SOURCE_FILE_PATTERN = /\.(jsx?|tsx?)$/i;
+const getWatchDirs = (dirs) => [...new Set(dirs.filter((dir) => !dir.split(path.sep).includes("node_modules")))];
+const watchSourceFiles = (dirs, onFileChange) => {
+	dirs.forEach((dir) => {
+		fs.watch(dir, { recursive: true }, (_eventType, filename) => {
+			if (filename && SOURCE_FILE_PATTERN.test(filename)) onFileChange();
+		});
+	});
+};
+const createDebouncedAction = (action, delayMs) => {
+	let debounceTimer = null;
+	return () => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(action, delayMs);
+	};
+};
+const createQueuedRegenerator = (options) => {
+	let isGenerating = false;
+	let pendingRegenerate = false;
+	const regenerate = async () => {
+		if (isGenerating) {
+			pendingRegenerate = true;
+			return;
+		}
+		isGenerating = true;
+		try {
+			options.onStart?.();
+			const result = await options.regenerateOnce();
+			options.onSuccess?.(result);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : "CSS generation failed";
+			options.onError(message);
+		} finally {
+			isGenerating = false;
+			if (pendingRegenerate) {
+				pendingRegenerate = false;
+				await regenerate();
+			}
+		}
+	};
+	return regenerate;
+};
+const runCssCommand = async (options, context) => {
+	if (!fs.existsSync(path.join(options.workspaceDir, String(options.themeConfigPath)))) {
+		await runSimpleMode(options, context);
+		return;
+	}
+	await runThemeMode(options, context);
+};
+const runSimpleMode = async (options, context) => {
+	const entry = typeof options.entryOption === "string" ? options.entryOption : DEFAULT_ENTRY;
+	const configPath = typeof options.configOption === "string" ? options.configOption : void 0;
+	if (!options.watch && !options.silent) spinStart("Generating CSS...");
+	try {
+		const result = await generateSimpleModeCSS({
+			workspaceDir: options.workspaceDir,
+			entry,
+			outFile: String(options.outFile),
+			variants: context.variants,
+			autoVariants: context.autoVariants,
+			componentData: context.componentData,
+			scope: options.scope,
+			configPath,
+			isWatch: options.watch,
+			silent: options.silent
+		});
+		if (options.watch) await runSimpleModeWatch(options, context, entry, configPath, result.packageDirs ?? []);
+	} catch (error) {
+		spinStop("❌", error instanceof Error ? error.message : "CSS generation failed");
+		process.exitCode = 1;
+	}
+};
+const runSimpleModeWatch = async (options, context, entry, configPath, packageDirs) => {
+	const entryDir = path.join(options.workspaceDir, entry);
+	const watchDirs = getWatchDirs(packageDirs.length > 0 ? packageDirs : [entryDir]);
+	if (!options.silent) {
+		print("");
+		print(`${magenta("Watching for changes...")}`);
+		watchDirs.forEach((dir) => print(`   ${gray("•")} ${dir}`));
+		print(`${gray("Press Ctrl+C to stop")}`);
+		print("");
+	}
+	const regenerate = createQueuedRegenerator({
+		onStart: () => {
+			if (!options.silent) print(`${gray(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`)} Change detected, regenerating...`);
+		},
+		regenerateOnce: async () => {
+			await generateSimpleModeCSS({
+				workspaceDir: options.workspaceDir,
+				entry,
+				outFile: String(options.outFile),
+				variants: context.variants,
+				autoVariants: context.autoVariants,
+				componentData: context.componentData,
+				scope: options.scope,
+				configPath,
+				isWatch: true,
+				silent: true
+			});
+		},
+		onSuccess: () => {
+			if (!options.silent) {
+				print(`${gray(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`)} ${green("CSS updated")}`);
+				print("");
+			}
+		},
+		onError: (message) => {
+			print(`Error: ${message}`);
+		}
+	});
+	watchSourceFiles(watchDirs, createDebouncedAction(() => {
+		regenerate();
+	}, 100));
+	await new Promise(() => {});
+};
+const loadThemeModeSetup = async (options) => {
+	const themeConfigInput = await loadConfigFile(String(options.themeConfigPath));
+	if (!themeConfigInput) return null;
+	const themeContext = {
+		cwd: options.workspaceDir,
+		watch: options.watch
+	};
+	const themeConfig = typeof themeConfigInput === "function" ? await themeConfigInput(themeContext) : themeConfigInput;
+	let appConfig = defaultTokensConfig;
+	if (themeConfig.config) {
+		const loadedConfig = await loadConfigFile(themeConfig.config);
+		if (loadedConfig) appConfig = loadedConfig;
+	}
+	return {
+		themeConfig,
+		colorModes: themeConfig.colorModes ?? ["dark"],
+		entry: themeConfig.entry ?? "/src/",
+		appConfig,
+		appVariantDefaults: extractVariantDefaults(appConfig),
+		effectiveSilent: options.silent || themeConfig.silent === true
+	};
+};
+const runThemeMode = async (options, context) => {
+	const workspaceDir = options.workspaceDir;
+	const outputPath = path.isAbsolute(options.outFile) ? options.outFile : path.join(workspaceDir, String(options.outFile));
+	let effectiveSilent = options.silent;
+	let log = createLogger({ silent: effectiveSilent });
+	log.spinStart("Loading theme configuration...");
+	try {
+		const setup = await loadThemeModeSetup(options);
+		if (!setup) {
+			log.spinStop("❌", `Theme config not found: ${options.themeConfigPath}`);
+			process.exitCode = 1;
+			return;
+		}
+		const { themeConfig, colorModes, entry, appConfig, appVariantDefaults } = setup;
+		effectiveSilent = setup.effectiveSilent;
+		log = createLogger({ silent: effectiveSilent });
+		if (!effectiveSilent) log.spinStop("✅", "Theme configuration loaded");
+		if (themeConfig.config && appConfig === defaultTokensConfig) log.warn(`App config not found: ${themeConfig.config}, using defaults`);
+		const packageDirs = [];
+		const generateThemeModeCSS = async (opts) => {
+			const genStartTime = performance.now();
+			const genLog = opts?.isWatch ? createLogger({ silent: true }) : log;
+			genLog.spinStart("Scanning app code...");
+			const appScanResult = await scanDirectoryForSafelist(path.join(workspaceDir, entry), colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults);
+			genLog.spinStop("✅", `Scanned ${appScanResult.filesScanned} files`);
+			genLog.spinStart("Generating main CSS...");
+			const inheritedClasses = [...appScanResult.safelist];
+			const inheritedComponents = new Set(appScanResult.components);
+			const processInheritedPackage = async (packageName) => {
+				genLog.spinStart(`Processing package: ${packageName}...`);
+				const packageDir = findPackageSourceDir(packageName);
+				if (!packageDir) {
+					genLog.spinStop("⚠️", `Package not found: ${packageName}`);
+					return;
+				}
+				if (!packageDirs.includes(packageDir)) packageDirs.push(packageDir);
+				const packageScanResult = await scanDirectoryForSafelist(packageDir, colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults, true);
+				inheritedClasses.push(...packageScanResult.safelist);
+				packageScanResult.components.forEach((comp) => inheritedComponents.add(comp));
+				genLog.spinStop("✅", `${packageName}: ${packageScanResult.filesScanned} files (inherit)`);
+			};
+			await (themeConfig.inherit ?? []).reduce(async (promise, packageName) => {
+				await promise;
+				await processInheritedPackage(packageName);
+			}, Promise.resolve());
+			const mainSafelist = deduplicateSafelist([...inheritedClasses, ...getThemeAndScaleClasses(colorModes)]);
+			const allMotionComponents = [...inheritedComponents];
+			const mainCssResult = await generateCSS([...themeConfig.css?.safelist ?? [], ...mainSafelist], appConfig, {
+				scope: options.scope,
+				contentDir: path.join(workspaceDir, entry),
+				cssOptions: themeConfig.css,
+				safeVarPrefixes: [...getMotionVarPrefixes(context.componentData, allMotionComponents), ...getConfigurableCssVariables()]
+			});
+			const outputDir = path.dirname(outputPath);
+			if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+			fs.writeFileSync(outputPath, mainCssResult.css);
+			genLog.spinStop("✅", getMainCssSummaryMessage({
+				sizeGzipBytes: mainCssResult.sizeGzipBytes,
+				optimizationStats: mainCssResult.optimizationStats,
+				formatBytes
+			}));
+			const duration = Math.round(performance.now() - genStartTime);
+			genLog.newline();
+			genLog.print(green("CSS generation complete!"));
+			genLog.newline();
+			genLog.label("Output file:", outputPath);
+			genLog.newline();
+			genLog.print(`${magenta("Total time:")} ${duration}ms`);
+			return {
+				duration,
+				outputPath,
+				packageDirs
+			};
+		};
+		await generateThemeModeCSS();
+		if (options.watch) {
+			const entryDir = path.join(workspaceDir, entry);
+			const { watchDirs, filteredPackageDirs } = getWatchDirectoryGroups(entryDir, [entryDir, ...packageDirs]);
+			if (!effectiveSilent) {
+				log.newline();
+				log.print(`${magenta("Watching for changes...")}`);
+				log.listItem(`App: ${entryDir}`);
+				filteredPackageDirs.forEach((dir) => {
+					log.listItem(`Package: ${dir}`);
+				});
+				log.print(`${gray("Press Ctrl+C to stop")}`);
+				log.newline();
+			}
+			const regenerate = createQueuedRegenerator({
+				onStart: () => {
+					if (!effectiveSilent) {
+						const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+						log.print(`${gray(`[${timestamp}]`)} Change detected, regenerating...`);
+					}
+				},
+				regenerateOnce: async () => generateThemeModeCSS({ isWatch: true }),
+				onSuccess: (result) => {
+					if (!effectiveSilent) {
+						const updatedAt = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+						log.print(`${gray(`[${updatedAt}]`)} ${green(`CSS updated (${result?.duration}ms)`)}`);
+						log.newline();
+					}
+				},
+				onError: (message) => {
+					log.print(message);
+				}
+			});
+			watchSourceFiles(watchDirs, createDebouncedAction(() => {
+				regenerate();
+			}, themeConfig.css?.watchDebounce ?? 100));
+			await new Promise(() => {});
+		}
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "CSS generation failed";
+		if (effectiveSilent) spinStop("❌", message);
+		else log.spinStop("❌", message);
+		process.exitCode = 1;
+	}
+};
+
+//#endregion
+export { runCssCommand };

package/dist/tailwind/dist/css/theme.cjs

@@ -0,0 +1,12 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region ../tailwind/dist/css/theme.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Helper function to define theme configuration with full type support.
+* Supports both static config objects and dynamic functions.
+*/
+const defineTheme = (config) => config;
+
+//#endregion
+exports.defineTheme = defineTheme;

package/dist/tailwind/dist/css/theme.d.cts

@@ -0,0 +1,66 @@
+
+import { UDSCSSOptions } from "./generate.cjs";
+
+//#region ../tailwind/dist/css/theme.d.ts
+//#region src/css/theme.d.ts
+/**
+ * Context passed to theme config function
+ */
+interface UDSThemeContext {
+  /** Current working directory */
+  cwd: string;
+  /** Whether the CLI is running in watch mode */
+  watch?: boolean;
+}
+/**
+ * CSS optimization options for uds.theme.ts
+ */
+interface UDSCSSOptimizationOptions {
+  /** Enable all CSS optimizations (default: true) */
+  enabled?: boolean;
+  /** Remove @font-face declarations for fonts not used in the CSS (default: false) */
+  removeUnusedFonts?: boolean;
+  /** Remove empty CSS rules (default: true) */
+  removeEmptyRules?: boolean;
+  /** Aggregate duplicate selectors (default: true) */
+  aggregateDuplicateSelectors?: boolean;
+  /**
+   * Remove duplicate content from scoped CSS that already exists in main CSS (default: true)
+   * Currently deduplicates @font-face declarations. Reduces bundle size when scoped packages
+   * share fonts with the main app.
+   */
+  deduplicateScopedCss?: boolean;
+  /** Prune unused CSS variables (default: true) */
+  pruneVars?: boolean;
+}
+/**
+ * Theme configuration structure for uds.theme.ts
+ */
+interface UDSThemeConfig {
+  /** Path to app's uds.config (relative to project root) */
+  config?: string;
+  /** Entry directory for app code scanning (default: '/src/') */
+  entry?: string;
+  /** Suppress log output during generation (default: false) */
+  silent?: boolean;
+  /**
+   * Packages that inherit the app's theme configuration.
+   * These packages' styles are merged into the main uds.css file.
+   */
+  inherit?: string[];
+  /** Color modes to include (default: ['dark']) - light mode is always in :root */
+  colorModes?: ('dark' | 'light')[];
+  /** CSS generation options */
+  css?: UDSCSSOptions;
+}
+/**
+ * Theme config can be an object or a function that receives context
+ */
+type UDSThemeConfigInput = UDSThemeConfig | ((ctx: UDSThemeContext) => UDSThemeConfig | Promise<UDSThemeConfig>);
+/**
+ * Helper function to define theme configuration with full type support.
+ * Supports both static config objects and dynamic functions.
+ */
+declare const defineTheme: (config: UDSThemeConfigInput) => UDSThemeConfigInput; //#endregion
+//#endregion
+export { type UDSCSSOptimizationOptions, defineTheme };