@yahoo/uds 3.114.0 → 3.115.0-beta.2

package/dist/tailwind/dist/commands/css.cjs

@@ -0,0 +1,79 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_colors = require('../../../cli/dist/lib/colors.cjs');
+const require_print = require('../../../cli/dist/lib/print.cjs');
+const require_nodeUtils = require('../css/nodeUtils.cjs');
+const require_runner = require('../css/runner.cjs');
+const require_css_helpers = require('./css.helpers.cjs');
+
+//#region ../tailwind/dist/commands/css.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const showHelp = () => {
+	require_print.print("");
+	require_print.print(`${require_colors.green("uds css")} - Generate CSS for app`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Usage:")}`);
+	require_print.print(`  ${require_colors.cyan("uds css")} [options]`);
+	require_print.print(`  ${require_colors.cyan("uds css init")} [options]`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Commands:")}`);
+	require_print.print(`  ${require_colors.cyan("init")}              Create a new uds.theme.ts file`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Options:")}`);
+	require_print.print(`  ${require_colors.cyan("--entry <path>")}    Entry directory to scan (default: /src/)`);
+	require_print.print(`  ${require_colors.cyan("--outFile <path>")}  Output CSS file (default: dist/uds.css)`);
+	require_print.print(`  ${require_colors.cyan("--config <path>")}   Path to uds.config.ts for tokens`);
+	require_print.print(`  ${require_colors.cyan("--theme <path>")}    Path to uds.theme.ts (default: uds.theme.ts)`);
+	require_print.print(`  ${require_colors.cyan("--watch, -w")}       Watch for file changes and regenerate`);
+	require_print.print(`  ${require_colors.cyan("--silent, -s")}      Suppress output logging`);
+	require_print.print(`  ${require_colors.cyan("--force")}           Overwrite existing uds.theme.ts (for init)`);
+	require_print.print(`  ${require_colors.cyan("--help, -h")}        Show this help message`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Initialize theme config:")}`);
+	require_print.print(`  ${require_colors.gray("uds css init")}`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Simple mode")} (no uds.theme.ts):`);
+	require_print.print(`  ${require_colors.gray("uds css --entry ./src --outFile dist/uds.css")}`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Theme mode")} (with uds.theme.ts):`);
+	require_print.print(`  ${require_colors.gray("uds css --theme uds.theme.ts --outFile dist/uds.css")}`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Example uds.theme.ts:")}`);
+	require_print.print(require_colors.gray(`  import { defineTheme } from '@yahoo/uds';
+
+  export default defineTheme({
+    config: './uds.config.ts',
+    entry: './src',
+    colorModes: ['dark'],
+    css: {
+      preflight: true,
+      fontFaceDeclarations: true,
+      enableSystemColorMode: false,      // Auto dark mode via prefers-color-scheme
+      disableOverrideTailwindTheme: true // Don't merge into Tailwind defaults
+    }
+  });`));
+	require_print.print("");
+};
+const makeCSSCommand = (getContext) => ({
+	name: "css",
+	description: "Generate CSS for app",
+	tag: "hidden",
+	run: async (props) => {
+		const { variants, autoVariants, componentData } = await getContext();
+		if (require_css_helpers.shouldShowHelp(props.options)) {
+			showHelp();
+			return;
+		}
+		if (require_css_helpers.isInitCommand(props.first)) {
+			await require_nodeUtils.scaffoldThemeConfig(require_css_helpers.getCssInitOptions(props.options));
+			return;
+		}
+		await require_runner.runCssCommand(require_css_helpers.getCssRunOptions(process.cwd(), props.options), {
+			variants,
+			autoVariants,
+			componentData
+		});
+	}
+});
+
+//#endregion
+exports.makeCSSCommand = makeCSSCommand;

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

@@ -0,0 +1,32 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region ../tailwind/dist/commands/css.helpers.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const isTruthyFlag = (value) => value === true || value === "true";
+const stringOption = (value) => typeof value === "string" ? value : void 0;
+const shouldShowHelp = (options) => isTruthyFlag(options.help) || isTruthyFlag(options.h);
+const isInitCommand = (firstArg) => firstArg === "init";
+const getCssInitOptions = (options) => ({
+	force: isTruthyFlag(options.force),
+	configPath: stringOption(options.config),
+	entry: stringOption(options.entry),
+	outputPath: stringOption(options.outFile)
+});
+const getCssRunOptions = (workspaceDir, options) => {
+	return {
+		workspaceDir,
+		outFile: stringOption(options.outFile) ?? "dist/uds.css",
+		themeConfigPath: stringOption(options.theme) ?? "uds.theme.ts",
+		scope: stringOption(options.scope),
+		entryOption: stringOption(options.entry),
+		configOption: stringOption(options.config),
+		watch: isTruthyFlag(options.watch) || isTruthyFlag(options.w),
+		silent: isTruthyFlag(options.silent) || isTruthyFlag(options.s)
+	};
+};
+
+//#endregion
+exports.getCssInitOptions = getCssInitOptions;
+exports.getCssRunOptions = getCssRunOptions;
+exports.isInitCommand = isInitCommand;
+exports.shouldShowHelp = shouldShowHelp;

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

@@ -0,0 +1,28 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region ../tailwind/dist/commands/css.helpers.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const isTruthyFlag = (value) => value === true || value === "true";
+const stringOption = (value) => typeof value === "string" ? value : void 0;
+const shouldShowHelp = (options) => isTruthyFlag(options.help) || isTruthyFlag(options.h);
+const isInitCommand = (firstArg) => firstArg === "init";
+const getCssInitOptions = (options) => ({
+	force: isTruthyFlag(options.force),
+	configPath: stringOption(options.config),
+	entry: stringOption(options.entry),
+	outputPath: stringOption(options.outFile)
+});
+const getCssRunOptions = (workspaceDir, options) => {
+	return {
+		workspaceDir,
+		outFile: stringOption(options.outFile) ?? "dist/uds.css",
+		themeConfigPath: stringOption(options.theme) ?? "uds.theme.ts",
+		scope: stringOption(options.scope),
+		entryOption: stringOption(options.entry),
+		configOption: stringOption(options.config),
+		watch: isTruthyFlag(options.watch) || isTruthyFlag(options.w),
+		silent: isTruthyFlag(options.silent) || isTruthyFlag(options.s)
+	};
+};
+
+//#endregion
+export { getCssInitOptions, getCssRunOptions, isInitCommand, shouldShowHelp };

package/dist/tailwind/dist/commands/css.js

@@ -0,0 +1,79 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { cyan, gray, green, magenta } from "../../../cli/dist/lib/colors.js";
+import { print } from "../../../cli/dist/lib/print.js";
+import { scaffoldThemeConfig } from "../css/nodeUtils.js";
+import { runCssCommand } from "../css/runner.js";
+import { getCssInitOptions, getCssRunOptions, isInitCommand, shouldShowHelp } from "./css.helpers.js";
+
+//#region ../tailwind/dist/commands/css.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const showHelp = () => {
+	print("");
+	print(`${green("uds css")} - Generate CSS for app`);
+	print("");
+	print(`${magenta("Usage:")}`);
+	print(`  ${cyan("uds css")} [options]`);
+	print(`  ${cyan("uds css init")} [options]`);
+	print("");
+	print(`${magenta("Commands:")}`);
+	print(`  ${cyan("init")}              Create a new uds.theme.ts file`);
+	print("");
+	print(`${magenta("Options:")}`);
+	print(`  ${cyan("--entry <path>")}    Entry directory to scan (default: /src/)`);
+	print(`  ${cyan("--outFile <path>")}  Output CSS file (default: dist/uds.css)`);
+	print(`  ${cyan("--config <path>")}   Path to uds.config.ts for tokens`);
+	print(`  ${cyan("--theme <path>")}    Path to uds.theme.ts (default: uds.theme.ts)`);
+	print(`  ${cyan("--watch, -w")}       Watch for file changes and regenerate`);
+	print(`  ${cyan("--silent, -s")}      Suppress output logging`);
+	print(`  ${cyan("--force")}           Overwrite existing uds.theme.ts (for init)`);
+	print(`  ${cyan("--help, -h")}        Show this help message`);
+	print("");
+	print(`${magenta("Initialize theme config:")}`);
+	print(`  ${gray("uds css init")}`);
+	print("");
+	print(`${magenta("Simple mode")} (no uds.theme.ts):`);
+	print(`  ${gray("uds css --entry ./src --outFile dist/uds.css")}`);
+	print("");
+	print(`${magenta("Theme mode")} (with uds.theme.ts):`);
+	print(`  ${gray("uds css --theme uds.theme.ts --outFile dist/uds.css")}`);
+	print("");
+	print(`${magenta("Example uds.theme.ts:")}`);
+	print(gray(`  import { defineTheme } from '@yahoo/uds';
+
+  export default defineTheme({
+    config: './uds.config.ts',
+    entry: './src',
+    colorModes: ['dark'],
+    css: {
+      preflight: true,
+      fontFaceDeclarations: true,
+      enableSystemColorMode: false,      // Auto dark mode via prefers-color-scheme
+      disableOverrideTailwindTheme: true // Don't merge into Tailwind defaults
+    }
+  });`));
+	print("");
+};
+const makeCSSCommand = (getContext) => ({
+	name: "css",
+	description: "Generate CSS for app",
+	tag: "hidden",
+	run: async (props) => {
+		const { variants, autoVariants, componentData } = await getContext();
+		if (shouldShowHelp(props.options)) {
+			showHelp();
+			return;
+		}
+		if (isInitCommand(props.first)) {
+			await scaffoldThemeConfig(getCssInitOptions(props.options));
+			return;
+		}
+		await runCssCommand(getCssRunOptions(process.cwd(), props.options), {
+			variants,
+			autoVariants,
+			componentData
+		});
+	}
+});
+
+//#endregion
+export { makeCSSCommand };

package/dist/tailwind/dist/commands/generateComponentData.cjs

@@ -23,43 +23,45 @@ const makeGenerateComponentDataCommand = (getContext) => ({
 		require_print.print("Scanning components in:", componentsDir);
 		const componentPaths = await require_componentAnalyzer.scanComponentFiles(componentsDir);
 		require_print.print(`Found ${componentPaths.size} components`);
-		const componentData = {};
-		for (const [name, filePath] of componentPaths) try {
-			project.addSourceFileAtPath(filePath);
-			const info = require_componentAnalyzer.analyzeComponent(project, filePath);
-			if (info) componentData[name] = serializeComponentInfo(info);
-		} catch (error) {
-			console.warn(`Warning: Could not analyze ${name}:`, error);
-		}
+		const componentDataEntries = await Promise.all([...componentPaths].map(async ([name, filePath]) => {
+			try {
+				project.addSourceFileAtPath(filePath);
+				const info = require_componentAnalyzer.analyzeComponent(project, filePath);
+				return info ? [name, serializeComponentInfo(info)] : null;
+			} catch (error) {
+				console.warn(`Warning: Could not analyze ${name}:`, error);
+				return null;
+			}
+		}));
+		const componentData = Object.fromEntries(componentDataEntries.filter((entry) => Boolean(entry)));
 		(0, node_fs.writeFileSync)(outputFile, JSON.stringify(componentData, null, 2));
 		require_print.print(`Generated component data for ${Object.keys(componentData).length} components`);
 		require_print.print(`Output written to: ${outputFile}`);
-		let totalDefaults = 0;
-		let totalLiterals = 0;
-		let totalInternalComponents = 0;
-		for (const comp of Object.values(componentData)) {
-			totalDefaults += Object.keys(comp.defaultProps).length;
-			totalLiterals += Object.keys(comp.getStylesLiterals).length;
-			totalInternalComponents += comp.internalComponents.length;
-		}
+		const totals = Object.values(componentData).reduce((acc, comp) => ({
+			totalDefaults: acc.totalDefaults + Object.keys(comp.defaultProps).length,
+			totalLiterals: acc.totalLiterals + Object.keys(comp.getStylesLiterals).length,
+			totalInternalComponents: acc.totalInternalComponents + comp.internalComponents.length
+		}), {
+			totalDefaults: 0,
+			totalLiterals: 0,
+			totalInternalComponents: 0
+		});
 		require_print.print("\nStats:");
-		require_print.print(`  Default props: ${totalDefaults}`);
-		require_print.print(`  getStyles literals: ${totalLiterals}`);
-		require_print.print(`  Internal component refs: ${totalInternalComponents}`);
+		require_print.print(`  Default props: ${totals.totalDefaults}`);
+		require_print.print(`  getStyles literals: ${totals.totalLiterals}`);
+		require_print.print(`  Internal component refs: ${totals.totalInternalComponents}`);
 	}
 });
-function serializeComponentInfo(info) {
-	return {
-		name: info.name,
-		defaultProps: Object.fromEntries(info.defaultProps),
-		getStylesLiterals: Object.fromEntries(info.getStylesLiterals),
-		cxLiterals: info.cxLiterals,
-		internalComponents: info.internalComponents,
-		internalComponentProps: Object.fromEntries(Array.from(info.internalComponentProps.entries()).map(([key, propsMap]) => [key, Object.fromEntries(propsMap)])),
-		propToVariantKeys: Object.fromEntries(info.propToVariantKeys),
-		motionVarPrefixes: info.motionVarPrefixes
-	};
-}
+const serializeComponentInfo = (info) => ({
+	name: info.name,
+	defaultProps: Object.fromEntries(info.defaultProps),
+	getStylesLiterals: Object.fromEntries(info.getStylesLiterals),
+	cxLiterals: info.cxLiterals,
+	internalComponents: info.internalComponents,
+	internalComponentProps: Object.fromEntries(Array.from(info.internalComponentProps.entries()).map(([key, propsMap]) => [key, Object.fromEntries(propsMap)])),
+	propToVariantKeys: Object.fromEntries(info.propToVariantKeys),
+	motionVarPrefixes: info.motionVarPrefixes
+});
 
 //#endregion
 exports.makeGenerateComponentDataCommand = makeGenerateComponentDataCommand;

package/dist/tailwind/dist/commands/generateComponentData.d.ts

@@ -1,3 +1,3 @@
 
 import { Project } from "ts-morph";
-import { Command } from "@yahoo/uds-cli";
+import { Command } from "@yahoo/uds-cli/lib";

package/dist/tailwind/dist/commands/generateComponentData.js

@@ -22,43 +22,45 @@ const makeGenerateComponentDataCommand = (getContext) => ({
 		print("Scanning components in:", componentsDir);
 		const componentPaths = await scanComponentFiles(componentsDir);
 		print(`Found ${componentPaths.size} components`);
-		const componentData = {};
-		for (const [name, filePath] of componentPaths) try {
-			project.addSourceFileAtPath(filePath);
-			const info = analyzeComponent(project, filePath);
-			if (info) componentData[name] = serializeComponentInfo(info);
-		} catch (error) {
-			console.warn(`Warning: Could not analyze ${name}:`, error);
-		}
+		const componentDataEntries = await Promise.all([...componentPaths].map(async ([name, filePath]) => {
+			try {
+				project.addSourceFileAtPath(filePath);
+				const info = analyzeComponent(project, filePath);
+				return info ? [name, serializeComponentInfo(info)] : null;
+			} catch (error) {
+				console.warn(`Warning: Could not analyze ${name}:`, error);
+				return null;
+			}
+		}));
+		const componentData = Object.fromEntries(componentDataEntries.filter((entry) => Boolean(entry)));
 		writeFileSync(outputFile, JSON.stringify(componentData, null, 2));
 		print(`Generated component data for ${Object.keys(componentData).length} components`);
 		print(`Output written to: ${outputFile}`);
-		let totalDefaults = 0;
-		let totalLiterals = 0;
-		let totalInternalComponents = 0;
-		for (const comp of Object.values(componentData)) {
-			totalDefaults += Object.keys(comp.defaultProps).length;
-			totalLiterals += Object.keys(comp.getStylesLiterals).length;
-			totalInternalComponents += comp.internalComponents.length;
-		}
+		const totals = Object.values(componentData).reduce((acc, comp) => ({
+			totalDefaults: acc.totalDefaults + Object.keys(comp.defaultProps).length,
+			totalLiterals: acc.totalLiterals + Object.keys(comp.getStylesLiterals).length,
+			totalInternalComponents: acc.totalInternalComponents + comp.internalComponents.length
+		}), {
+			totalDefaults: 0,
+			totalLiterals: 0,
+			totalInternalComponents: 0
+		});
 		print("\nStats:");
-		print(`  Default props: ${totalDefaults}`);
-		print(`  getStyles literals: ${totalLiterals}`);
-		print(`  Internal component refs: ${totalInternalComponents}`);
+		print(`  Default props: ${totals.totalDefaults}`);
+		print(`  getStyles literals: ${totals.totalLiterals}`);
+		print(`  Internal component refs: ${totals.totalInternalComponents}`);
 	}
 });
-function serializeComponentInfo(info) {
-	return {
-		name: info.name,
-		defaultProps: Object.fromEntries(info.defaultProps),
-		getStylesLiterals: Object.fromEntries(info.getStylesLiterals),
-		cxLiterals: info.cxLiterals,
-		internalComponents: info.internalComponents,
-		internalComponentProps: Object.fromEntries(Array.from(info.internalComponentProps.entries()).map(([key, propsMap]) => [key, Object.fromEntries(propsMap)])),
-		propToVariantKeys: Object.fromEntries(info.propToVariantKeys),
-		motionVarPrefixes: info.motionVarPrefixes
-	};
-}
+const serializeComponentInfo = (info) => ({
+	name: info.name,
+	defaultProps: Object.fromEntries(info.defaultProps),
+	getStylesLiterals: Object.fromEntries(info.getStylesLiterals),
+	cxLiterals: info.cxLiterals,
+	internalComponents: info.internalComponents,
+	internalComponentProps: Object.fromEntries(Array.from(info.internalComponentProps.entries()).map(([key, propsMap]) => [key, Object.fromEntries(propsMap)])),
+	propToVariantKeys: Object.fromEntries(info.propToVariantKeys),
+	motionVarPrefixes: info.motionVarPrefixes
+});
 
 //#endregion
 export { makeGenerateComponentDataCommand };

package/dist/tailwind/dist/commands/purge.cjs

@@ -1,9 +1,8 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-const require_analytics = require('../../../cli/dist/utils/analytics.cjs');
 const require_print = require('../../../cli/dist/lib/print.cjs');
 const require_spinner = require('../../../cli/dist/lib/spinner.cjs');
-const require_purgeCSS = require('../purger/legacy/purgeCSS.cjs');
 const require_purge = require('../purger/optimized/purge.cjs');
+const require_purgeCSS = require('../purger/legacy/purgeCSS.cjs');
 
 //#region ../tailwind/dist/commands/purge.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
@@ -28,7 +27,7 @@ const makePurgeCommand = (getContext) => ({
 				require_print.print(`   Files scanned: ${result.stats.filesScanned}`);
 				require_print.print(`   Spreads traced: ${result.stats.spreadsTraced}`);
 				require_print.print(`   Expressions resolved: ${result.stats.expressionsResolved}`);
-				return await require_analytics.trackEvent("purge", { optimized: true });
+				return;
 			} catch (error) {
 				if (error instanceof Error) require_spinner.spinStop("❌", error.message);
 				else require_spinner.spinStop("❌", "Purging css failed! Please reach out to #uds-ask channel for support.");
@@ -43,7 +42,7 @@ const makePurgeCommand = (getContext) => ({
 					output: typeof output === "string" ? output : void 0
 				});
 				require_spinner.spinStop("✅", "Purging css done!");
-				return await require_analytics.trackEvent("purge");
+				return;
 			} catch (error) {
 				if (error instanceof Error) require_spinner.spinStop("❌", error.message);
 				else require_spinner.spinStop("❌", "Purging css failed! Please reach out to #uds-ask channel for support.");

package/dist/tailwind/dist/commands/purge.js

@@ -1,9 +1,8 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-import { trackEvent } from "../../../cli/dist/utils/analytics.js";
 import { print } from "../../../cli/dist/lib/print.js";
 import { spinStart, spinStop } from "../../../cli/dist/lib/spinner.js";
-import { purge } from "../purger/legacy/purgeCSS.js";
 import { purgeOptimized } from "../purger/optimized/purge.js";
+import { purge } from "../purger/legacy/purgeCSS.js";
 
 //#region ../tailwind/dist/commands/purge.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
@@ -28,7 +27,7 @@ const makePurgeCommand = (getContext) => ({
 				print(`   Files scanned: ${result.stats.filesScanned}`);
 				print(`   Spreads traced: ${result.stats.spreadsTraced}`);
 				print(`   Expressions resolved: ${result.stats.expressionsResolved}`);
-				return await trackEvent("purge", { optimized: true });
+				return;
 			} catch (error) {
 				if (error instanceof Error) spinStop("❌", error.message);
 				else spinStop("❌", "Purging css failed! Please reach out to #uds-ask channel for support.");
@@ -43,7 +42,7 @@ const makePurgeCommand = (getContext) => ({
 					output: typeof output === "string" ? output : void 0
 				});
 				spinStop("✅", "Purging css done!");
-				return await trackEvent("purge");
+				return;
 			} catch (error) {
 				if (error instanceof Error) spinStop("❌", error.message);
 				else spinStop("❌", "Purging css failed! Please reach out to #uds-ask channel for support.");

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

@@ -0,0 +1,121 @@
+/*! © 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_nodeUtils = require('./nodeUtils.cjs');
+const require_safelist = require('../purger/optimized/utils/safelist.cjs');
+const require_utils = require('./utils.cjs');
+const require_generate_helpers = require('./generate.helpers.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_zlib = require("node:zlib");
+let postcss = require("postcss");
+postcss = require_runtime.__toESM(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 ?? node_path.default.join(process.cwd(), "src");
+	const cssFlags = require_generate_helpers.getCssFeatureFlags(options?.cssOptions);
+	const optimizationConfig = options?.cssOptions?.optimization;
+	const scopeClass = normalizeScope(options?.scope) ?? normalizeScope(options?.cssOptions?.scope);
+	let css = await require_generate_helpers.applyScopedColorModeFix((await (0, postcss.default)(require_generate_helpers.buildPostcssPlugins({
+		tailwindPlugin: require_generate_helpers.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 require_generate_helpers.optimizeGeneratedCss({
+		css,
+		shouldOptimize: cssFlags.shouldOptimize,
+		optimizationConfig,
+		referenceCss: options?.referenceCss,
+		scopeClass
+	});
+	css = optimizedCss.css;
+	const sizeBytes = Buffer.byteLength(css, "utf8");
+	const sizeGzipBytes = (0, node_zlib.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 = require_index.defaultTokensConfig;
+	if (options.configPath) {
+		const loadedConfig = await require_nodeUtils.loadConfigFile(options.configPath);
+		if (loadedConfig) tokensConfig = loadedConfig;
+		else if (shouldLogStats) require_spinner.spinStop("⚠️", `Config file not found: ${options.configPath}, using defaults`);
+	}
+	const variantDefaults = require_utils.extractVariantDefaults(tokensConfig);
+	const entryDir = node_path.default.join(options.workspaceDir, options.entry);
+	const scanResult = await require_nodeUtils.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(require_safelist.deduplicateSafelist([...allClasses, ...require_safelist.getThemeAndScaleClasses(colorModes)]), tokensConfig, {
+		scope: options.scope,
+		contentDir: entryDir,
+		safeVarPrefixes: [...require_utils.getMotionVarPrefixes(options.componentData, [...allComponents]), ...require_utils.getConfigurableCssVariables()]
+	});
+	const outputPath = node_path.default.isAbsolute(options.outFile) ? options.outFile : node_path.default.join(options.workspaceDir, options.outFile);
+	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, cssResult.css);
+	const duration = Math.round(performance.now() - startTime);
+	if (shouldLogStats) require_generate_helpers.printSimpleModeStats({
+		outputPath,
+		totalFilesScanned,
+		classCount: cssResult.classCount,
+		sizeBytes: cssResult.sizeBytes,
+		sizeGzipBytes: cssResult.sizeGzipBytes,
+		duration,
+		scope: options.scope,
+		optimizationStats: cssResult.optimizationStats,
+		print: require_print.print,
+		magenta: require_colors.magenta,
+		cyan: require_colors.cyan,
+		yellow: require_colors.yellow
+	});
+	return {
+		success: true,
+		outputPath,
+		packageDirs
+	};
+};
+
+//#endregion
+exports.generateCSS = generateCSS;
+exports.generateSimpleModeCSS = generateSimpleModeCSS;

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

@@ -0,0 +1,30 @@
+
+import "../../../config/dist/index.cjs";
+import { UDSCSSOptimizationOptions } from "./theme.cjs";
+import { SafelistConfig } from "tailwindcss/types/config";
+
+//#region ../tailwind/dist/css/generate.d.ts
+//#region src/css/generate.d.ts
+/**
+ * CSS generation options for uds.theme.ts
+ */
+interface UDSCSSOptions {
+  /** CSS scope wrapper class (optional) */
+  scope?: string;
+  /** Safelist of CSS classes to always include */
+  safelist?: SafelistConfig[];
+  /** CSS optimization settings */
+  optimization?: UDSCSSOptimizationOptions;
+  /** Include Tailwind preflight/reset styles (default: true) */
+  preflight?: boolean;
+  /** Include @font-face declarations (default: true) */
+  fontFaceDeclarations?: boolean;
+  /** Debounce delay (ms) for watch mode regenerations */
+  watchDebounce?: number;
+}
+/**
+ * Options for generateCSS function
+ */
+//#endregion
+//#endregion
+export { type UDSCSSOptions };

package/dist/tailwind/dist/css/generate.d.ts

@@ -0,0 +1,31 @@
+
+import "../../../config/dist/index.js";
+import "../commands/generateComponentData.js";
+import { UDSCSSOptimizationOptions } from "./theme.js";
+import { SafelistConfig } from "tailwindcss/types/config";
+
+//#region ../tailwind/dist/css/generate.d.ts
+//#region src/css/generate.d.ts
+/**
+ * CSS generation options for uds.theme.ts
+ */
+interface UDSCSSOptions {
+  /** CSS scope wrapper class (optional) */
+  scope?: string;
+  /** Safelist of CSS classes to always include */
+  safelist?: SafelistConfig[];
+  /** CSS optimization settings */
+  optimization?: UDSCSSOptimizationOptions;
+  /** Include Tailwind preflight/reset styles (default: true) */
+  preflight?: boolean;
+  /** Include @font-face declarations (default: true) */
+  fontFaceDeclarations?: boolean;
+  /** Debounce delay (ms) for watch mode regenerations */
+  watchDebounce?: number;
+}
+/**
+ * Options for generateCSS function
+ */
+//#endregion
+//#endregion
+export { type UDSCSSOptions };