@yahoo/uds 3.143.0 → 3.145.0-beta.1

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/getConfigVariantProperties.d.cts

@@ -11,8 +11,8 @@ import { SelectedConfigurableProperty } from "../properties.cjs";
  * @returns A Record of layer names to their properties, or null if no properties are found
  */
 declare function getConfigVariantProperties(variant?: VariantConfig): {
-  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
-  root: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  root: Readonly<Record<string, SelectedConfigurableProperty<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
 } | null; //#endregion
 //#endregion
 export { getConfigVariantProperties };

package/dist/automated-config/dist/utils/getConfigVariantProperties.d.ts

@@ -11,8 +11,8 @@ import { SelectedConfigurableProperty } from "../properties.js";
  * @returns A Record of layer names to their properties, or null if no properties are found
  */
 declare function getConfigVariantProperties(variant?: VariantConfig): {
-  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
-  root: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  root: Readonly<Record<string, SelectedConfigurableProperty<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
 } | null; //#endregion
 //#endregion
 export { getConfigVariantProperties };

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/{tailwind/dist → cli}/commands/purge.d.cts

@@ -1,9 +1,9 @@
 
-import { SerializedComponentInfo } from "./generateComponentData.cjs";
-import { GeneratedPurgeCSSData } from "../purger/legacy/purgeCSS.cjs";
+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/commands/purge.d.ts
+//#region src/cli/commands/purge.d.ts
 type Context = {
   variants: Record<string, Record<string, string>>;
   autoVariants: Record<string, Record<string, string>>;
@@ -13,5 +13,4 @@ type Context = {
 };
 declare const makePurgeCommand: (getContext: () => Promise<Context>) => Command;
 //#endregion
-export { makePurgeCommand };
-//# sourceMappingURL=purge.d.cts.map
+export { makePurgeCommand };

package/dist/{tailwind/dist → cli}/commands/purge.d.ts

@@ -1,9 +1,9 @@
 
-import { SerializedComponentInfo } from "./generateComponentData.js";
-import { GeneratedPurgeCSSData } from "../purger/legacy/purgeCSS.js";
+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/commands/purge.d.ts
+//#region src/cli/commands/purge.d.ts
 type Context = {
   variants: Record<string, Record<string, string>>;
   autoVariants: Record<string, Record<string, string>>;
@@ -13,5 +13,4 @@ type Context = {
 };
 declare const makePurgeCommand: (getContext: () => Promise<Context>) => Command;
 //#endregion
-export { makePurgeCommand };
-//# sourceMappingURL=purge.d.ts.map
+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/{tailwind/dist/cli → cli}/dist/lib/spinner.cjs

@@ -1,4 +1,4 @@
-/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 //#region ../cli/dist/lib/spinner.mjs
 /*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
 /**

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));