@yahoo/uds 3.144.0 → 3.145.0-beta.2

package/dist/automated-config/dist/mapTextVariantFixtureToValue.cjs

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_index = require("../../css-tokens/dist/index.cjs");
-const require_assertUnreachable = require("./utils/assertUnreachable.cjs");
+const require_assertUnreachable = require("../../utils/dist/assertUnreachable.cjs");
 //#region ../automated-config/dist/mapTextVariantFixtureToValue.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 const mapTextVariantFixtureToValue = (key) => (selected, value) => {

package/dist/automated-config/dist/mapTextVariantFixtureToValue.js

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { textVariantsSafe } from "../../css-tokens/dist/index.js";
-import { assertUnreachable } from "./utils/assertUnreachable.js";
+import { assertUnreachable } from "../../utils/dist/assertUnreachable.js";
 //#region ../automated-config/dist/mapTextVariantFixtureToValue.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 const mapTextVariantFixtureToValue = (key) => (selected, value) => {

package/dist/automated-config/dist/properties.cjs

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_index = require("../../css-tokens/dist/index.cjs");
-const require_assertUnreachable = require("./utils/assertUnreachable.cjs");
+const require_assertUnreachable = require("../../utils/dist/assertUnreachable.cjs");
 const require_mapTextVariantFixtureToValue = require("./mapTextVariantFixtureToValue.cjs");
 const require_mapColorFixtureToValue = require("./utils/mapColorFixtureToValue.cjs");
 const require_index$1 = require("../../motion-tokens/dist/index.cjs");

package/dist/automated-config/dist/properties.js

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { BACKGROUND_BLUR_COLOR_PREFIX, BACKGROUND_BLUR_FALLBACK_COLOR_PREFIX, BORDER_RADIUS_PREFIX, BUTTON_SCALE_EFFECT, DROP_SHADOW_PREFIX, getShadowLayerValue, textVariantsSafe } from "../../css-tokens/dist/index.js";
-import { assertUnreachable } from "./utils/assertUnreachable.js";
+import { assertUnreachable } from "../../utils/dist/assertUnreachable.js";
 import { mapTextVariantFixtureToValue } from "./mapTextVariantFixtureToValue.js";
 import { mapColorFixtureToValue } from "./utils/mapColorFixtureToValue.js";
 import { SCALE_EFFECTS } from "../../motion-tokens/dist/index.js";

package/dist/automated-config/dist/utils/coalesceConfigVariant.cjs

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_mapValues = require("../../../utils/dist/mapValues.cjs");
 const require_subcomponents = require("./subcomponents.cjs");
-const require_mapValues = require("./mapValues.cjs");
 //#region ../automated-config/dist/utils/coalesceConfigVariant.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 function coalesceConfigVariant(config, variantKey) {

package/dist/automated-config/dist/utils/coalesceConfigVariant.js

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { mapValues } from "../../../utils/dist/mapValues.js";
 import { getConfigSubcomponents } from "./subcomponents.js";
-import { mapValues } from "./mapValues.js";
 //#region ../automated-config/dist/utils/coalesceConfigVariant.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 function coalesceConfigVariant(config, variantKey) {

package/dist/automated-config/dist/utils/mapColorFixtureToValue.cjs

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 require("../../../palette/dist/index.cjs");
-const require_assertUnreachable = require("./assertUnreachable.cjs");
+const require_assertUnreachable = require("../../../utils/dist/assertUnreachable.cjs");
 //#region ../automated-config/dist/utils/mapColorFixtureToValue.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 const mapColorFixtureToValue = (fixtureType, value) => {

package/dist/automated-config/dist/utils/mapColorFixtureToValue.js

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import "../../../palette/dist/index.js";
-import { assertUnreachable } from "./assertUnreachable.js";
+import { assertUnreachable } from "../../../utils/dist/assertUnreachable.js";
 //#region ../automated-config/dist/utils/mapColorFixtureToValue.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 const mapColorFixtureToValue = (fixtureType, value) => {

package/dist/cli/commands/purge.cjs

@@ -0,0 +1,79 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_colors = require("../dist/lib/colors.cjs");
+const require_print = require("../dist/lib/print.cjs");
+const require_spinner = require("../dist/lib/spinner.cjs");
+const require_purge = require("../../css/dist/purger/optimized/purge.cjs");
+const require_purgeCSS = require("../../tailwind-v3/dist/purger/legacy/purgeCSS.cjs");
+const require_cli_commands_purge_helpers = require("./purge.helpers.cjs");
+//#region src/cli/commands/purge.ts
+const showHelp = () => {
+	require_print.print("");
+	require_print.print(`${require_colors.green("uds purge")} - Generate a Tailwind safelist from UDS usage`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Usage:")}`);
+	require_print.print(`  ${require_colors.cyan("uds purge")} [options]`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Options:")}`);
+	require_print.print(`  ${require_colors.cyan("--entry <path>")}       Entry directory or file to scan (default: ./src)`);
+	require_print.print(`  ${require_colors.cyan("--output <path>")}      Output safelist file (default: dist/safelist.ts)`);
+	require_print.print(`  ${require_colors.cyan("--config <path>")}      Path to uds.config.ts for legacy purge mode`);
+	require_print.print(`  ${require_colors.cyan("--optimized")}          Use the optimized AST-based purger implementation`);
+	require_print.print(`  ${require_colors.cyan("--help, -h")}           Show this help message`);
+	require_print.print("");
+	require_print.print(`${require_colors.magenta("Examples:")}`);
+	require_print.print(`  ${require_colors.gray("uds purge")}`);
+	require_print.print(`  ${require_colors.gray("uds purge --optimized")}`);
+	require_print.print(`  ${require_colors.gray("uds purge --entry ./src --output ./dist/safelist.ts")}`);
+	require_print.print(`  ${require_colors.gray("uds purge --config ./uds.config.ts")}`);
+	require_print.print("");
+};
+const makePurgeCommand = (getContext) => ({
+	name: "purge",
+	description: "Purge unused CSS",
+	run: async (props) => {
+		if (require_cli_commands_purge_helpers.shouldShowHelp(props.options)) {
+			showHelp();
+			return;
+		}
+		const { config, entry, optimized, output } = require_cli_commands_purge_helpers.getPurgeRunOptions(props.options);
+		const { variants, autoVariants, componentData, packageJson, generatedPurgeCssData } = await getContext();
+		if (optimized) {
+			require_spinner.spinStart("Purging CSS with optimized purger...");
+			try {
+				const result = await require_purge.purgeOptimized({
+					entry,
+					output,
+					variants,
+					autoVariants,
+					componentData
+				});
+				require_spinner.spinStop("✅", `Purging done (optimized)! Generated ${result.stats.classesGenerated} classes in ${result.stats.timeMs}ms`);
+				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;
+			} 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.");
+				process.exitCode = 1;
+				return;
+			}
+		}
+		require_spinner.spinStart("Purging css started...");
+		try {
+			await require_purgeCSS.purge(variants, packageJson, generatedPurgeCssData, {
+				config,
+				entry,
+				output
+			});
+			require_spinner.spinStop("✅", "Purging css done!");
+		} 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.");
+			process.exitCode = 1;
+		}
+	}
+});
+//#endregion
+exports.makePurgeCommand = makePurgeCommand;

package/dist/cli/commands/purge.d.cts

@@ -0,0 +1,16 @@
+
+import { SerializedComponentInfo } from "../../css/dist/commands/generateComponentData.cjs";
+import { GeneratedPurgeCSSData } from "../../tailwind-v3/dist/purger/legacy/purgeCSS.cjs";
+import { Command } from "@yahoo/uds-cli/lib";
+
+//#region src/cli/commands/purge.d.ts
+type Context = {
+  variants: Record<string, Record<string, string>>;
+  autoVariants: Record<string, Record<string, string>>;
+  componentData: Record<string, SerializedComponentInfo>;
+  packageJson: Record<string, any>;
+  generatedPurgeCssData: GeneratedPurgeCSSData;
+};
+declare const makePurgeCommand: (getContext: () => Promise<Context>) => Command;
+//#endregion
+export { makePurgeCommand };

package/dist/cli/commands/purge.d.ts

@@ -0,0 +1,16 @@
+
+import { SerializedComponentInfo } from "../../css/dist/commands/generateComponentData.js";
+import { GeneratedPurgeCSSData } from "../../tailwind-v3/dist/purger/legacy/purgeCSS.js";
+import { Command } from "@yahoo/uds-cli/lib";
+
+//#region src/cli/commands/purge.d.ts
+type Context = {
+  variants: Record<string, Record<string, string>>;
+  autoVariants: Record<string, Record<string, string>>;
+  componentData: Record<string, SerializedComponentInfo>;
+  packageJson: Record<string, any>;
+  generatedPurgeCssData: GeneratedPurgeCSSData;
+};
+declare const makePurgeCommand: (getContext: () => Promise<Context>) => Command;
+//#endregion
+export { makePurgeCommand };

package/dist/cli/commands/purge.helpers.cjs

@@ -0,0 +1,21 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/cli/commands/purge.helpers.ts
+const isTruthyFlag = (value) => value === true || value === "true";
+const stringOption = (value) => typeof value === "string" ? value : void 0;
+const entryOption = (value) => {
+	if (typeof value === "string") return value;
+	if (Array.isArray(value) && value.every((item) => typeof item === "string")) return value;
+};
+const shouldShowHelp = (options) => isTruthyFlag(options.help) || isTruthyFlag(options.h);
+const isOptimizedPurgeEnabled = (options) => isTruthyFlag(options.optimized);
+const getPurgeRunOptions = (options) => ({
+	config: stringOption(options.config),
+	entry: entryOption(options.entry),
+	optimized: isOptimizedPurgeEnabled(options),
+	output: stringOption(options.output)
+});
+//#endregion
+exports.getPurgeRunOptions = getPurgeRunOptions;
+exports.isOptimizedPurgeEnabled = isOptimizedPurgeEnabled;
+exports.shouldShowHelp = shouldShowHelp;

package/dist/cli/commands/purge.helpers.d.cts

@@ -0,0 +1,14 @@
+
+//#region src/cli/commands/purge.helpers.d.ts
+type PurgeCliOptions = Record<string, unknown>;
+type PurgeRunOptions = {
+  config?: string;
+  entry?: string | string[];
+  optimized: boolean;
+  output?: string;
+};
+declare const shouldShowHelp: (options: PurgeCliOptions) => boolean;
+declare const isOptimizedPurgeEnabled: (options: PurgeCliOptions) => boolean;
+declare const getPurgeRunOptions: (options: PurgeCliOptions) => PurgeRunOptions;
+//#endregion
+export { type PurgeCliOptions, type PurgeRunOptions, getPurgeRunOptions, isOptimizedPurgeEnabled, shouldShowHelp };

package/dist/cli/commands/purge.helpers.d.ts

@@ -0,0 +1,14 @@
+
+//#region src/cli/commands/purge.helpers.d.ts
+type PurgeCliOptions = Record<string, unknown>;
+type PurgeRunOptions = {
+  config?: string;
+  entry?: string | string[];
+  optimized: boolean;
+  output?: string;
+};
+declare const shouldShowHelp: (options: PurgeCliOptions) => boolean;
+declare const isOptimizedPurgeEnabled: (options: PurgeCliOptions) => boolean;
+declare const getPurgeRunOptions: (options: PurgeCliOptions) => PurgeRunOptions;
+//#endregion
+export { type PurgeCliOptions, type PurgeRunOptions, getPurgeRunOptions, isOptimizedPurgeEnabled, shouldShowHelp };

package/dist/cli/commands/purge.helpers.js

@@ -0,0 +1,18 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region src/cli/commands/purge.helpers.ts
+const isTruthyFlag = (value) => value === true || value === "true";
+const stringOption = (value) => typeof value === "string" ? value : void 0;
+const entryOption = (value) => {
+	if (typeof value === "string") return value;
+	if (Array.isArray(value) && value.every((item) => typeof item === "string")) return value;
+};
+const shouldShowHelp = (options) => isTruthyFlag(options.help) || isTruthyFlag(options.h);
+const isOptimizedPurgeEnabled = (options) => isTruthyFlag(options.optimized);
+const getPurgeRunOptions = (options) => ({
+	config: stringOption(options.config),
+	entry: entryOption(options.entry),
+	optimized: isOptimizedPurgeEnabled(options),
+	output: stringOption(options.output)
+});
+//#endregion
+export { getPurgeRunOptions, isOptimizedPurgeEnabled, shouldShowHelp };

package/dist/cli/commands/purge.js

@@ -0,0 +1,78 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { cyan, gray, green, magenta } from "../dist/lib/colors.js";
+import { print } from "../dist/lib/print.js";
+import { spinStart, spinStop } from "../dist/lib/spinner.js";
+import { purgeOptimized } from "../../css/dist/purger/optimized/purge.js";
+import { purge } from "../../tailwind-v3/dist/purger/legacy/purgeCSS.js";
+import { getPurgeRunOptions, shouldShowHelp } from "./purge.helpers.js";
+//#region src/cli/commands/purge.ts
+const showHelp = () => {
+	print("");
+	print(`${green("uds purge")} - Generate a Tailwind safelist from UDS usage`);
+	print("");
+	print(`${magenta("Usage:")}`);
+	print(`  ${cyan("uds purge")} [options]`);
+	print("");
+	print(`${magenta("Options:")}`);
+	print(`  ${cyan("--entry <path>")}       Entry directory or file to scan (default: ./src)`);
+	print(`  ${cyan("--output <path>")}      Output safelist file (default: dist/safelist.ts)`);
+	print(`  ${cyan("--config <path>")}      Path to uds.config.ts for legacy purge mode`);
+	print(`  ${cyan("--optimized")}          Use the optimized AST-based purger implementation`);
+	print(`  ${cyan("--help, -h")}           Show this help message`);
+	print("");
+	print(`${magenta("Examples:")}`);
+	print(`  ${gray("uds purge")}`);
+	print(`  ${gray("uds purge --optimized")}`);
+	print(`  ${gray("uds purge --entry ./src --output ./dist/safelist.ts")}`);
+	print(`  ${gray("uds purge --config ./uds.config.ts")}`);
+	print("");
+};
+const makePurgeCommand = (getContext) => ({
+	name: "purge",
+	description: "Purge unused CSS",
+	run: async (props) => {
+		if (shouldShowHelp(props.options)) {
+			showHelp();
+			return;
+		}
+		const { config, entry, optimized, output } = getPurgeRunOptions(props.options);
+		const { variants, autoVariants, componentData, packageJson, generatedPurgeCssData } = await getContext();
+		if (optimized) {
+			spinStart("Purging CSS with optimized purger...");
+			try {
+				const result = await purgeOptimized({
+					entry,
+					output,
+					variants,
+					autoVariants,
+					componentData
+				});
+				spinStop("✅", `Purging done (optimized)! Generated ${result.stats.classesGenerated} classes in ${result.stats.timeMs}ms`);
+				print(`   Files scanned: ${result.stats.filesScanned}`);
+				print(`   Spreads traced: ${result.stats.spreadsTraced}`);
+				print(`   Expressions resolved: ${result.stats.expressionsResolved}`);
+				return;
+			} catch (error) {
+				if (error instanceof Error) spinStop("❌", error.message);
+				else spinStop("❌", "Purging css failed! Please reach out to #uds-ask channel for support.");
+				process.exitCode = 1;
+				return;
+			}
+		}
+		spinStart("Purging css started...");
+		try {
+			await purge(variants, packageJson, generatedPurgeCssData, {
+				config,
+				entry,
+				output
+			});
+			spinStop("✅", "Purging css done!");
+		} catch (error) {
+			if (error instanceof Error) spinStop("❌", error.message);
+			else spinStop("❌", "Purging css failed! Please reach out to #uds-ask channel for support.");
+			process.exitCode = 1;
+		}
+	}
+});
+//#endregion
+export { makePurgeCommand };

package/dist/cli/commands/sync.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
 const require_defaultTokensConfig = require("../../defaultTokensConfig.cjs");
+const require_sortKeys = require("../../utils/dist/sortKeys.cjs");
 const require_runtime_bottomSheetConfig = require("../../runtime/bottomSheetConfig.cjs");
 const require_runtime_breakpointsConfig = require("../../runtime/breakpointsConfig.cjs");
 const require_runtime_modalConfig = require("../../runtime/modalConfig.cjs");
@@ -12,7 +13,6 @@ const require_config = require("../dist/utils/rules/config.cjs");
 const require_colors = require("../dist/lib/colors.cjs");
 const require_print = require("../dist/lib/print.cjs");
 const require_box = require("../dist/lib/box.cjs");
-const require_cli_commands_utils_sortKeys = require("./utils/sortKeys.cjs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path, 1);
 let node_fs = require("node:fs");
@@ -70,7 +70,7 @@ const syncCommand = {
 				config = (await resp.json()).config;
 			}
 			if (!config) throw new Error("Config JSON could not be parsed.");
-			const sortedConfig = require_cli_commands_utils_sortKeys.sortKeys(config);
+			const sortedConfig = require_sortKeys.sortKeys(config);
 			const importsTS = [`import type { UniversalTokensConfig } from '@yahoo/uds';`];
 			const exportsTS = [`export const config: UniversalTokensConfig = ${JSON.stringify(sortedConfig, null, 2)} as UniversalTokensConfig;`];
 			const exportsJS = [`export const config = ${JSON.stringify(sortedConfig, null, 2)};`];
@@ -84,7 +84,7 @@ const syncCommand = {
 			};
 			const runtimeTypeImports = [];
 			for (const [name, [json, type]] of Object.entries(runtimeConfigs)) {
-				const content = require_cli_commands_utils_sortKeys.sortKeys(json);
+				const content = require_sortKeys.sortKeys(json);
 				runtimeTypeImports.push(type);
 				exportsTS.push(`export const ${name}RuntimeConfig: ${type} = ${JSON.stringify(content, null, 2)};`);
 				exportsJS.push(`export const ${name}RuntimeConfig = ${JSON.stringify(content, null, 2)};`);

package/dist/cli/commands/sync.js

@@ -1,5 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { defaultTokensConfig } from "../../defaultTokensConfig.js";
+import { sortKeys } from "../../utils/dist/sortKeys.js";
 import { configToBottomSheetConfigContext } from "../../runtime/bottomSheetConfig.js";
 import { configToBreakpointsConfigContext } from "../../runtime/breakpointsConfig.js";
 import { configToModalConfigContext } from "../../runtime/modalConfig.js";
@@ -10,7 +11,6 @@ import { getEditorsWithStaleRules } from "../dist/utils/rules/config.js";
 import { bold, cyan, green, magenta, red, yellow } from "../dist/lib/colors.js";
 import { print } from "../dist/lib/print.js";
 import { printBox } from "../dist/lib/box.js";
-import { sortKeys } from "./utils/sortKeys.js";
 import path from "node:path";
 import { writeFileSync } from "node:fs";
 import packageJSON from "@yahoo/uds/package.json" with { type: "json" };

package/dist/cli/dist/lib/spinner.cjs

@@ -0,0 +1,57 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region ../cli/dist/lib/spinner.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Simple terminal spinner for showing progress during long operations.
+* Uses Braille spinner characters for a smooth animation.
+*/
+let spinnerInterval = null;
+let currentMessage = "";
+const frames = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+let frameIndex = 0;
+/**
+* Start a spinner with a message.
+* Only one spinner can be active at a time.
+*/
+function spinStart(message) {
+	if (spinnerInterval) spinStop();
+	currentMessage = message;
+	frameIndex = 0;
+	process.stdout.write("\x1B[?25l");
+	spinnerInterval = setInterval(() => {
+		const frame = frames[frameIndex];
+		process.stdout.write(`\r${frame} ${currentMessage}`);
+		frameIndex = (frameIndex + 1) % frames.length;
+	}, 80);
+}
+/**
+* Stop the spinner and optionally show a final message.
+* @param iconOrMessage - Optional icon to show OR the message if second param not provided
+* @param message - Optional final message to display
+*/
+function spinStop(iconOrMessage, message) {
+	if (spinnerInterval) {
+		clearInterval(spinnerInterval);
+		spinnerInterval = null;
+	}
+	process.stdout.write("\r\x1B[K");
+	process.stdout.write("\x1B[?25h");
+	if (iconOrMessage || message) {
+		const finalMessage = message ? `${iconOrMessage} ${message}` : iconOrMessage;
+		console.log(finalMessage);
+	}
+}
+//#endregion
+exports.spinStart = spinStart;
+exports.spinStop = spinStop;

package/dist/cli/dist/lib/spinner.js

@@ -0,0 +1,56 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region ../cli/dist/lib/spinner.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Simple terminal spinner for showing progress during long operations.
+* Uses Braille spinner characters for a smooth animation.
+*/
+let spinnerInterval = null;
+let currentMessage = "";
+const frames = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+let frameIndex = 0;
+/**
+* Start a spinner with a message.
+* Only one spinner can be active at a time.
+*/
+function spinStart(message) {
+	if (spinnerInterval) spinStop();
+	currentMessage = message;
+	frameIndex = 0;
+	process.stdout.write("\x1B[?25l");
+	spinnerInterval = setInterval(() => {
+		const frame = frames[frameIndex];
+		process.stdout.write(`\r${frame} ${currentMessage}`);
+		frameIndex = (frameIndex + 1) % frames.length;
+	}, 80);
+}
+/**
+* Stop the spinner and optionally show a final message.
+* @param iconOrMessage - Optional icon to show OR the message if second param not provided
+* @param message - Optional final message to display
+*/
+function spinStop(iconOrMessage, message) {
+	if (spinnerInterval) {
+		clearInterval(spinnerInterval);
+		spinnerInterval = null;
+	}
+	process.stdout.write("\r\x1B[K");
+	process.stdout.write("\x1B[?25h");
+	if (iconOrMessage || message) {
+		const finalMessage = message ? `${iconOrMessage} ${message}` : iconOrMessage;
+		console.log(finalMessage);
+	}
+}
+//#endregion
+export { spinStart, spinStop };

package/dist/cli/dist/utils/rules/config.cjs

@@ -1,8 +1,8 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 require("../../../../_virtual/_rolldown/runtime.cjs");
 let node_path = require("node:path");
-let node_fs = require("node:fs");
 let node_url = require("node:url");
+let node_fs = require("node:fs");
 //#region ../cli/dist/utils/rules/config.mjs
 /*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
 const __dirname$1 = (0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));

package/dist/cli/dist/utils/rules/config.js

@@ -1,7 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { dirname, join } from "node:path";
-import { existsSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
+import { existsSync, readFileSync } from "node:fs";
 //#region ../cli/dist/utils/rules/config.mjs
 /*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
 const __dirname = dirname(fileURLToPath(import.meta.url));

package/dist/cli/runner.cjs

@@ -1,57 +1,55 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-require("../_virtual/_rolldown/runtime.cjs");
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_defaultTokensConfig = require("../defaultTokensConfig.cjs");
 const require_styles_variants = require("../styles/variants.cjs");
-const require_components_index = require("../components/index.cjs");
 const require_cli = require("./dist/cli.cjs");
-const require_css = require("../tailwind/dist/commands/css.cjs");
-const require_generateComponentData = require("../tailwind/dist/commands/generateComponentData.cjs");
-const require_generatePurgeCSSData = require("../tailwind/dist/commands/generatePurgeCSSData.cjs");
-const require_purge = require("../tailwind/dist/commands/purge.cjs");
+const require_css = require("../css/dist/commands/css.cjs");
+const require_cli$1 = require("../tailwind-v4/dist/cli.cjs");
 const require_package = require("../uds/package.cjs");
-const require_components_experimental_index = require("../components/experimental/index.cjs");
+const require_cli_commands_purge = require("./commands/purge.cjs");
 const require_cli_commands_sync = require("./commands/sync.cjs");
 const require_cli_commands_version = require("./commands/version.cjs");
 let node_path = require("node:path");
-let ts_morph = require("ts-morph");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
 //#region src/cli/runner.ts
+const getPurgeContext = async () => {
+	const componentData = await Promise.resolve().then(() => require("../uds/generated/componentData.cjs"));
+	return {
+		variants: require_styles_variants.variants,
+		packageJson: require_package.default,
+		generatedPurgeCssData: await Promise.resolve().then(() => require("../uds/generated/tailwindPurge.cjs")),
+		autoVariants: (await Promise.resolve().then(() => require("../automated-config/dist/generated/autoVariants.cjs"))).autoVariants,
+		componentData
+	};
+};
+const purgeCommand = {
+	name: "purge",
+	description: "Purge unused CSS",
+	run: async (props) => {
+		await require_cli_commands_purge.makePurgeCommand(getPurgeContext).run(props);
+	}
+};
+const cssCommand = require_css.makeCSSCommand(async () => {
+	const componentData = await Promise.resolve().then(() => require("../uds/generated/componentData.cjs"));
+	return {
+		variants: require_styles_variants.variants,
+		autoVariants: (await Promise.resolve().then(() => require("../automated-config/dist/generated/autoVariants.cjs"))).autoVariants,
+		componentData
+	};
+});
+const getTailwindV4Config = async () => {
+	for (const candidatePath of ["uds.config.ts", "uds.config.js"]) try {
+		const loaded = await import((0, node_url.pathToFileURL)(node_path.default.resolve(process.cwd(), candidatePath)).href);
+		if (loaded.config) return loaded.config;
+	} catch {}
+	return require_defaultTokensConfig.defaultTokensConfig;
+};
 require_cli.run([
 	require_cli_commands_version.versionCommand,
-	require_purge.makePurgeCommand(async () => {
-		const componentData = await Promise.resolve().then(() => require("../uds/generated/componentData.cjs"));
-		return {
-			variants: require_styles_variants.variants,
-			packageJson: require_package.default,
-			generatedPurgeCssData: await Promise.resolve().then(() => require("../uds/generated/tailwindPurge.cjs")),
-			autoVariants: (await Promise.resolve().then(() => require("../automated-config/dist/generated/autoVariants.cjs"))).autoVariants,
-			componentData
-		};
-	}),
-	require_generatePurgeCSSData.makeGeneratePurgeCSSDataCommand(async () => {
-		return {
-			project: new ts_morph.Project({ tsConfigFilePath: (0, node_path.join)(process.cwd(), `./tsconfig.json`) }),
-			variants: require_styles_variants.variants,
-			UDS: require_components_index.components_exports,
-			UDS_EXPERIMENTAL: require_components_experimental_index.experimental_exports
-		};
-	}),
-	require_generateComponentData.makeGenerateComponentDataCommand(async () => {
-		return {
-			project: new ts_morph.Project({
-				tsConfigFilePath: (0, node_path.join)(process.cwd(), `./tsconfig.json`),
-				skipFileDependencyResolution: true
-			}),
-			componentsDir: (0, node_path.join)(process.cwd(), "src/components"),
-			outputFile: (0, node_path.join)(process.cwd(), "generated/componentData.json")
-		};
-	}),
-	require_css.makeCSSCommand(async () => {
-		const componentData = await Promise.resolve().then(() => require("../uds/generated/componentData.cjs"));
-		return {
-			variants: require_styles_variants.variants,
-			autoVariants: (await Promise.resolve().then(() => require("../automated-config/dist/generated/autoVariants.cjs"))).autoVariants,
-			componentData
-		};
-	}),
+	purgeCommand,
+	cssCommand,
+	require_cli$1.makeTailwindV4ThemeCommand({ getConfig: getTailwindV4Config }),
 	require_cli_commands_sync.syncCommand
 ]);
 //#endregion