@yahoo/uds 3.96.0 → 3.97.0

package/dist/cli/commands/utils/purgeCSS.d.ts

@@ -0,0 +1,59 @@
+
+import { JsxOpeningElement, JsxSelfClosingElement, Project } from "ts-morph";
+
+//#region src/cli/commands/utils/purgeCSS.d.ts
+type SafeList = string[];
+type ImportsList = string[];
+type Files = string[];
+declare const getFiles: (entry: string) => Promise<Files>;
+/**
+ * Find all JSX references for a named import.
+ *
+ * @example
+ * const references = findNamedImportReferences(project, '@yahoo/uds', 'HStack')
+ */
+declare function findNamedImportReferences(project: Project, moduleSpecifierValue: string, namedImportName: string): (JsxOpeningElement | JsxSelfClosingElement)[];
+/**
+ * Given a file it returns the list of imports from @yahoo/uds
+ */
+declare const parseFiles: (project: Project, files: Files) => ImportsList;
+declare const getTailwindSafelist: (project: Project, componentList: string[]) => SafeList;
+/**
+ * Get the used props for a given component.
+ *
+ * @example
+ * const usedProps = getUsedProps(project, 'HStack');
+ */
+declare const getUsedProps: (project: Project, component: string) => Array<[string, string[]]>;
+declare const isUDSComponent: (component: string) => boolean;
+declare const getComponentsToConvertToTW: (udsImport: ImportsList) => string[];
+/**
+ * Get the classes that corresponds to the used modes
+ */
+declare const getClassesForEnabledThemesAndScales: () => string[];
+/**
+ * Scan the source code for all `getStyles` references
+ *
+ * Note: This currently only works if we are passing a literal object to getStyles.
+ *
+ * Explanation: They we are able to enfer what css to include is by looking at the properties of the object passed.
+ * If something other than an object is passed, we can fallback on the Type, but that would require handling
+ * a lot of edge cases (function return type, spread operator, ternary, ...) and each one of these cases will
+ * most likely have a sub case. Falling back to the Type will complicate the code a lot is error prone as there
+ * is only so much info we can get out of the types as the Users are free to use `any` on their project which will
+ * provide no value for us. Hence why having a literal object passed is the best and probably the only sane way
+ * to go about this.
+ */
+declare const scanGetStylesReferences: (project: Project) => Map<string, Set<string>>;
+type PurgeOptions = {
+  config?: string;
+  output?: string;
+  entry?: string;
+};
+declare function purge({
+  config: configPath,
+  output: output,
+  entry: entry
+}: PurgeOptions): Promise<void>;
+//#endregion
+export { type PurgeOptions, findNamedImportReferences, getClassesForEnabledThemesAndScales, getComponentsToConvertToTW, getFiles, getTailwindSafelist, getUsedProps, isUDSComponent, parseFiles, purge, scanGetStylesReferences };

package/dist/cli/commands/utils/purgeCSS.js

@@ -0,0 +1,244 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { DARK_COLOR_MODE_CLASSNAME, LARGE_SCALE_MODE_CLASSNAME, LIGHT_COLOR_MODE_CLASSNAME, MEDIUM_SCALE_MODE_CLASSNAME, SMALL_SCALE_MODE_CLASSNAME, XLARGE_SCALE_MODE_CLASSNAME, XSMALL_SCALE_MODE_CLASSNAME, XXLARGE_SCALE_MODE_CLASSNAME, XXXLARGE_SCALE_MODE_CLASSNAME } from "../../../css-tokens/dist/index.js";
+import { variants } from "../../../styles/variants.js";
+import { print } from "../../dist/lib/print.js";
+import { spinStart, spinStop } from "../../dist/lib/spinner.js";
+import { componentToTwClasses, componentToVariants, componentsDependencies, variantsList } from "../../../uds/generated/tailwindPurge.js";
+import { findReferencesAsJsxElements, getUsedPropsInReference } from "../../../uds/scripts/utils/tsMorph.js";
+import { mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import pkg from "@yahoo/uds/package.json" with { type: "json" };
+import fg from "fast-glob";
+import { Node, Project, SyntaxKind, ts } from "ts-morph";
+
+//#region src/cli/commands/utils/purgeCSS.ts
+const scaleModeToClass = {
+	large: LARGE_SCALE_MODE_CLASSNAME,
+	medium: MEDIUM_SCALE_MODE_CLASSNAME,
+	small: SMALL_SCALE_MODE_CLASSNAME,
+	xLarge: XLARGE_SCALE_MODE_CLASSNAME,
+	xSmall: XSMALL_SCALE_MODE_CLASSNAME,
+	xxLarge: XXLARGE_SCALE_MODE_CLASSNAME,
+	xxxLarge: XXXLARGE_SCALE_MODE_CLASSNAME
+};
+const colorModeToClass = {
+	dark: DARK_COLOR_MODE_CLASSNAME,
+	light: LIGHT_COLOR_MODE_CLASSNAME
+};
+const getFiles = async (entry) => {
+	try {
+		const workspaceDir = process.env.PWD || process.cwd();
+		if (!workspaceDir) throw new Error("Workspace directory not found.");
+		return await fg(["**/*.jsx", "**/*.tsx"], {
+			cwd: path.join(workspaceDir, entry),
+			absolute: true
+		});
+	} catch {
+		throw new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
+	}
+};
+/**
+* Find all JSX references for a named import.
+*
+* @example
+* const references = findNamedImportReferences(project, '@yahoo/uds', 'HStack')
+*/
+function findNamedImportReferences(project, moduleSpecifierValue, namedImportName) {
+	const references = [];
+	for (const sourceFile of project.getSourceFiles()) for (const importDeclaration of sourceFile.getImportDeclarations()) if (importDeclaration.getModuleSpecifierValue() === moduleSpecifierValue) {
+		for (const namedImport of importDeclaration.getNamedImports()) if (namedImport.getName() === namedImportName) {
+			const identifier = namedImport.getFirstDescendantByKindOrThrow(ts.SyntaxKind.Identifier);
+			references.push(...findReferencesAsJsxElements(identifier));
+		}
+	}
+	return references;
+}
+/**
+* Given a file it returns the list of imports from @yahoo/uds
+*/
+const parseFiles = (project, files) => {
+	const importsSet = /* @__PURE__ */ new Set();
+	files.map((file) => {
+		return project.getSourceFile(file)?.getImportDeclarations().filter((declaration) => {
+			return declaration.getModuleSpecifier().getText().includes("@yahoo/uds") || declaration.getModuleSpecifier().getText().includes("@yahoo/uds/experimental");
+		}).map((declaration) => {
+			return declaration.getNamedImports().map((namedImport) => namedImport.getName());
+		}).flat() ?? [];
+	}).flat().forEach((item) => {
+		if (!importsSet.has(item)) importsSet.add(item);
+	});
+	return Array.from(importsSet);
+};
+const getTailwindSafelist = (project, componentList) => {
+	const safeList = [];
+	const validVariants = new Set(variantsList);
+	const usedProps = /* @__PURE__ */ new Map();
+	componentList.forEach((component) => {
+		if (isUDSComponent(component)) {
+			componentToVariants[component].forEach(([propName, usedValues]) => {
+				if (validVariants.has(propName)) {
+					const options = usedProps.get(propName) ?? /* @__PURE__ */ new Set();
+					usedValues.forEach((val) => options.add(val));
+					usedProps.set(propName, options);
+				}
+			});
+			getUsedProps(project, component).forEach(([propName, usedValues]) => {
+				if (validVariants.has(propName)) {
+					if (usedValues.length === 0) usedValues = Object.keys(variants[propName]);
+					const options = usedProps.get(propName) ?? /* @__PURE__ */ new Set();
+					usedValues.forEach((val) => options.add(val));
+					usedProps.set(propName, options);
+				}
+			});
+			safeList.push(...componentToTwClasses[component].replaceAll("\\", "").split(" "));
+		}
+	});
+	for (const [propName, usedValues] of usedProps) {
+		const variantGroup = variants[propName];
+		if (variantGroup) usedValues.forEach((option) => {
+			const variantClass = variantGroup[option];
+			if (variantClass) safeList.push(variantClass.replaceAll("\\", ""));
+		});
+	}
+	for (const [variant, variantOptions] of scanGetStylesReferences(project)) {
+		const variantGroup = variants[variant];
+		if (variantGroup) variantOptions.forEach((option) => {
+			const variantClass = variantGroup[option];
+			if (variantClass) safeList.push(variantClass.replaceAll("\\", ""));
+		});
+	}
+	return Array.from(new Set(safeList)).filter(Boolean);
+};
+/**
+* Get the used props for a given component.
+*
+* @example
+* const usedProps = getUsedProps(project, 'HStack');
+*/
+const getUsedProps = (project, component) => {
+	const references = [];
+	references.push(...findNamedImportReferences(project, pkg.name, component));
+	references.push(...findNamedImportReferences(project, `${pkg.name}/experimental`, component));
+	return references.map((reference) => getUsedPropsInReference(reference)).flat();
+};
+const isUDSComponent = (component) => {
+	return !!componentToVariants[component];
+};
+const saveToFile = (safeList, outputPath) => {
+	const fileContent = `
+    //! This file is generated by purgeCSS.ts from @yahoo/uds
+    //! Do not edit directly
+    //! If there is issue with this file please report to #ask-uds
+    export const safelist = ${JSON.stringify(safeList)};
+    `;
+	mkdirSync(path.dirname(outputPath), { recursive: true });
+	writeFileSync(outputPath, fileContent);
+};
+const getComponentsToConvertToTW = (udsImport) => {
+	const components = udsImport.filter((importedItem) => !!componentToVariants[importedItem]);
+	const set = /* @__PURE__ */ new Set();
+	components.forEach((component) => {
+		if (!set.has(component)) set.add(component);
+		if (componentsDependencies[component]) componentsDependencies[component].forEach((dependent) => {
+			if (!set.has(dependent)) set.add(dependent);
+		});
+	});
+	return Array.from(set);
+};
+/**
+* Get the classes that corresponds to the used modes
+*/
+const getClassesForEnabledThemesAndScales = () => {
+	const classes = [];
+	if (process.env.ENABLED_SCALE_AND_COLOR_MODES) process.env.ENABLED_SCALE_AND_COLOR_MODES.split(",").map((mode) => {
+		mode = mode.trim();
+		if (colorModeToClass[mode]) classes.push(colorModeToClass[mode]);
+		else if (scaleModeToClass[mode]) classes.push(scaleModeToClass[mode]);
+	});
+	else {
+		classes.push(colorModeToClass.dark);
+		classes.push(colorModeToClass.light);
+		classes.push(scaleModeToClass.large);
+	}
+	return classes;
+};
+/**
+* Scan the source code for all `getStyles` references
+*
+* Note: This currently only works if we are passing a literal object to getStyles.
+*
+* Explanation: They we are able to enfer what css to include is by looking at the properties of the object passed.
+* If something other than an object is passed, we can fallback on the Type, but that would require handling
+* a lot of edge cases (function return type, spread operator, ternary, ...) and each one of these cases will
+* most likely have a sub case. Falling back to the Type will complicate the code a lot is error prone as there
+* is only so much info we can get out of the types as the Users are free to use `any` on their project which will
+* provide no value for us. Hence why having a literal object passed is the best and probably the only sane way
+* to go about this.
+*/
+const scanGetStylesReferences = (project) => {
+	const references = [];
+	for (const sourceFile of project.getSourceFiles()) for (const importDeclaration of sourceFile.getImportDeclarations()) if (importDeclaration.getModuleSpecifierValue() === pkg.name) {
+		for (const namedImport of importDeclaration.getNamedImports()) if (namedImport.getName() === "getStyles") {
+			const identifier = namedImport.getFirstDescendantByKindOrThrow(ts.SyntaxKind.Identifier);
+			for (const reference of identifier.findReferencesAsNodes()) {
+				const node = reference.getFirstAncestor((node) => {
+					return Node.isCallExpression(node);
+				});
+				if (node) references.push(node);
+			}
+		}
+	}
+	const usedProps = /* @__PURE__ */ new Map();
+	for (const reference of references) {
+		const objectLiteralExpression = reference.getFirstChildByKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+		const propertyAssignments = objectLiteralExpression.getDescendantsOfKind(SyntaxKind.PropertyAssignment);
+		const shorthandPropertyAssignments = objectLiteralExpression.getDescendantsOfKind(SyntaxKind.ShorthandPropertyAssignment);
+		propertyAssignments.forEach((propertyAssigment) => {
+			const identifier = propertyAssigment.getFirstChildByKind(SyntaxKind.Identifier)?.getText();
+			const stringLiteral = propertyAssigment.getFirstChildByKind(SyntaxKind.StringLiteral)?.getLiteralText();
+			if (identifier && !stringLiteral) {
+				const fallback = !!variants[identifier] ? Object.keys(variants[identifier]) : [];
+				usedProps.set(identifier, new Set(fallback));
+			}
+			if (identifier && stringLiteral) {
+				let options;
+				if (usedProps.has(identifier)) options = usedProps.get(identifier);
+				else options = /* @__PURE__ */ new Set();
+				options.add(stringLiteral);
+				usedProps.set(identifier, options);
+			}
+		});
+		shorthandPropertyAssignments.forEach((propertyAssigment) => {
+			const identifier = propertyAssigment.getFirstChildByKind(SyntaxKind.Identifier)?.getText();
+			if (identifier) usedProps.set(identifier, /* @__PURE__ */ new Set());
+		});
+	}
+	return usedProps;
+};
+async function purge({ config: configPath = process.env.UDS_OUT_FILE ?? "./uds.config.ts", output = "dist/safelist.ts", entry = "/src/" }) {
+	const workspaceDir = process.env.PWD || process.cwd();
+	if (!workspaceDir) throw new Error("Workspace directory not found.");
+	const project = new Project({ tsConfigFilePath: path.join(workspaceDir, "/tsconfig.json") });
+	const outputFilePath = path.join(workspaceDir, output);
+	const configAbsolutePath = path.join(workspaceDir, configPath);
+	try {
+		await import(configAbsolutePath);
+	} catch {
+		throw new Error("Couldn't load the UDS config. Make sure you have uds.config.ts in the root of your project.");
+	}
+	spinStart("Getting used UDS components...");
+	print("Loading the project...");
+	const files = await getFiles(entry);
+	print("Going through the imports...");
+	const udsImports = parseFiles(project, files);
+	print("Finding all the components imported from UDS...");
+	const udsComponents = getComponentsToConvertToTW(udsImports);
+	print("🧑‍🍳 Cooking...");
+	const safeList = getTailwindSafelist(project, udsComponents);
+	const themesAndScalesClasses = getClassesForEnabledThemesAndScales();
+	saveToFile(safeList.concat(themesAndScalesClasses), outputFilePath);
+	spinStop("Generated your safelist!");
+}
+
+//#endregion
+export { findNamedImportReferences, getClassesForEnabledThemesAndScales, getComponentsToConvertToTW, getFiles, getTailwindSafelist, getUsedProps, isUDSComponent, parseFiles, purge, scanGetStylesReferences };

package/dist/cli/commands/utils/sortKeys.cjs

@@ -0,0 +1,23 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/cli/commands/utils/sortKeys.ts
+function sortKeys(unsortedObj) {
+	const sortedObj = {};
+	if (!unsortedObj || typeof unsortedObj !== "object") return unsortedObj;
+	const keys = Object.keys(unsortedObj).sort();
+	for (var index in keys) {
+		const key = keys[index];
+		const value = unsortedObj[key];
+		if (typeof value === "object") if (Array.isArray(value)) sortedObj[key] = value.map((item) => {
+			if (typeof item === "object") return sortKeys(item);
+			return item;
+		});
+		else sortedObj[key] = sortKeys(value);
+		else sortedObj[key] = value;
+	}
+	return sortedObj;
+}
+
+//#endregion
+exports.sortKeys = sortKeys;

package/dist/cli/commands/utils/sortKeys.d.cts

@@ -0,0 +1,5 @@
+
+//#region src/cli/commands/utils/sortKeys.d.ts
+declare function sortKeys<T extends Record<string, unknown>>(unsortedObj: T): Record<string, unknown>;
+//#endregion
+export { sortKeys };

package/dist/cli/commands/utils/sortKeys.d.ts

@@ -0,0 +1,5 @@
+
+//#region src/cli/commands/utils/sortKeys.d.ts
+declare function sortKeys<T extends Record<string, unknown>>(unsortedObj: T): Record<string, unknown>;
+//#endregion
+export { sortKeys };

package/dist/cli/commands/utils/sortKeys.js

@@ -0,0 +1,21 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region src/cli/commands/utils/sortKeys.ts
+function sortKeys(unsortedObj) {
+	const sortedObj = {};
+	if (!unsortedObj || typeof unsortedObj !== "object") return unsortedObj;
+	const keys = Object.keys(unsortedObj).sort();
+	for (var index in keys) {
+		const key = keys[index];
+		const value = unsortedObj[key];
+		if (typeof value === "object") if (Array.isArray(value)) sortedObj[key] = value.map((item) => {
+			if (typeof item === "object") return sortKeys(item);
+			return item;
+		});
+		else sortedObj[key] = sortKeys(value);
+		else sortedObj[key] = value;
+	}
+	return sortedObj;
+}
+
+//#endregion
+export { sortKeys };

package/dist/cli/commands/version.cjs

@@ -0,0 +1,21 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_analytics = require('../dist/utils/analytics.cjs');
+const require_print = require('../dist/lib/print.cjs');
+let _yahoo_uds_package_json = require("@yahoo/uds/package.json");
+_yahoo_uds_package_json = require_runtime.__toESM(_yahoo_uds_package_json);
+
+//#region src/cli/commands/version.ts
+const version = _yahoo_uds_package_json.default.version;
+const versionCommand = {
+	name: "version",
+	description: `Display CLI version (${version})`,
+	run: async () => {
+		require_print.print(version);
+		await require_analytics.trackEvent("version", { version });
+	}
+};
+
+//#endregion
+exports.versionCommand = versionCommand;

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

@@ -0,0 +1,7 @@
+
+import { Command } from "@yahoo/uds-cli";
+
+//#region src/cli/commands/version.d.ts
+declare const versionCommand: Command;
+//#endregion
+export { versionCommand };

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

@@ -0,0 +1,7 @@
+
+import { Command } from "@yahoo/uds-cli";
+
+//#region src/cli/commands/version.d.ts
+declare const versionCommand: Command;
+//#endregion
+export { versionCommand };

package/dist/cli/commands/version.js

@@ -0,0 +1,18 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { trackEvent } from "../dist/utils/analytics.js";
+import { print } from "../dist/lib/print.js";
+import pkg from "@yahoo/uds/package.json" with { type: "json" };
+
+//#region src/cli/commands/version.ts
+const version = pkg.version;
+const versionCommand = {
+	name: "version",
+	description: `Display CLI version (${version})`,
+	run: async () => {
+		print(version);
+		await trackEvent("version", { version });
+	}
+};
+
+//#endregion
+export { versionCommand };

package/dist/cli/dist/cli.cjs

@@ -0,0 +1,78 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_analytics = require('./utils/analytics.cjs');
+const require_args = require('./lib/args.cjs');
+const require_colors = require('./lib/colors.cjs');
+const require_print = require('./lib/print.cjs');
+const require_getCommandHelp = require('./utils/getCommandHelp.cjs');
+const require_codemod = require('./commands/codemod/codemod.cjs');
+const require_editor_rules = require('./commands/editor-rules.cjs');
+
+//#region ../cli/dist/cli.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* UDS CLI - Universal Design System Command Line Interface
+*
+* This is the main entry point for the CLI. It uses manual argument parsing
+* (no external framework) following the packages/mobile pattern.
+*/
+const { positional, options } = require_args.parseArgs(process.argv.slice(2));
+const command = positional[0];
+const banner = `
+█ █ █▀▄ ▄▀▀   ▄▀▀ █   █
+▀▄█ █▄▀ ▄██   ▀▄▄ █▄▄ █
+Universal Design System
+`.trim();
+const LOCAL_COMMANDS = [{
+	name: "codemod",
+	description: "Apply a codemod",
+	run: (props) => require_codemod.codemod_default.run({
+		...props,
+		first: positional[1]
+	})
+}, {
+	name: "editor-rules",
+	description: "🎯 Generate editor rules for various code editors and AI tools",
+	aliases: ["rules", "editor"],
+	run: require_editor_rules.editor_rules_default.run
+}];
+function showHelp(commands) {
+	const widest = Math.max(...commands.map((c) => c.name.length)) + 4;
+	const subcommandWidest = Math.max(...require_getCommandHelp.CODEMOD_SUBCOMMANDS.map((c) => c.name.length)) + 4;
+	require_print.print(`\n${require_colors.green(banner)}\n`);
+	require_print.print(`${require_colors.magenta("Usage:")} ${require_colors.white("uds <command> [options]")}\n`);
+	require_print.print(`${require_colors.magenta("Commands:")}`);
+	for (const cmd of commands) {
+		require_print.print(`  ${require_colors.cyan(cmd.name.padEnd(widest))} ${require_colors.gray(cmd.description)}`);
+		if (cmd.name === "codemod") for (const sub of require_getCommandHelp.CODEMOD_SUBCOMMANDS) require_print.print(`      ${require_colors.cyan(sub.name.padEnd(subcommandWidest))} ${require_colors.gray(sub.description)}`);
+	}
+	require_print.print("");
+}
+async function run(externalCommands) {
+	const commands = [...LOCAL_COMMANDS, ...externalCommands];
+	const helpCommands = commands.filter((c) => c.tag !== "hidden");
+	const showHelpForCommands = () => showHelp(helpCommands);
+	const props = {
+		name: "uds",
+		commandPath: positional.slice(0, 1),
+		first: positional[1],
+		second: positional[2],
+		third: positional[3],
+		options
+	};
+	if (command === "help" || command === "--help" || command === "-h" || !command) {
+		showHelpForCommands();
+		return;
+	}
+	const commandDefinition = commands.find((c) => c.name === command || c.aliases?.includes(command));
+	if (!commandDefinition) {
+		require_print.print(require_colors.red(`Unknown command: ${command}`));
+		await require_analytics.trackEvent("unknown_cmd", { cmd: command });
+		showHelpForCommands();
+		process.exitCode = 1;
+		return;
+	}
+	await commandDefinition.run(props);
+}
+
+//#endregion
+exports.run = run;

package/dist/cli/dist/cli.js

@@ -0,0 +1,78 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { trackEvent } from "./utils/analytics.js";
+import { parseArgs } from "./lib/args.js";
+import { cyan, gray, green, magenta, red, white } from "./lib/colors.js";
+import { print } from "./lib/print.js";
+import { CODEMOD_SUBCOMMANDS } from "./utils/getCommandHelp.js";
+import { codemod_default } from "./commands/codemod/codemod.js";
+import { editor_rules_default } from "./commands/editor-rules.js";
+
+//#region ../cli/dist/cli.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* UDS CLI - Universal Design System Command Line Interface
+*
+* This is the main entry point for the CLI. It uses manual argument parsing
+* (no external framework) following the packages/mobile pattern.
+*/
+const { positional, options } = parseArgs(process.argv.slice(2));
+const command = positional[0];
+const banner = `
+█ █ █▀▄ ▄▀▀   ▄▀▀ █   █
+▀▄█ █▄▀ ▄██   ▀▄▄ █▄▄ █
+Universal Design System
+`.trim();
+const LOCAL_COMMANDS = [{
+	name: "codemod",
+	description: "Apply a codemod",
+	run: (props) => codemod_default.run({
+		...props,
+		first: positional[1]
+	})
+}, {
+	name: "editor-rules",
+	description: "🎯 Generate editor rules for various code editors and AI tools",
+	aliases: ["rules", "editor"],
+	run: editor_rules_default.run
+}];
+function showHelp(commands) {
+	const widest = Math.max(...commands.map((c) => c.name.length)) + 4;
+	const subcommandWidest = Math.max(...CODEMOD_SUBCOMMANDS.map((c) => c.name.length)) + 4;
+	print(`\n${green(banner)}\n`);
+	print(`${magenta("Usage:")} ${white("uds <command> [options]")}\n`);
+	print(`${magenta("Commands:")}`);
+	for (const cmd of commands) {
+		print(`  ${cyan(cmd.name.padEnd(widest))} ${gray(cmd.description)}`);
+		if (cmd.name === "codemod") for (const sub of CODEMOD_SUBCOMMANDS) print(`      ${cyan(sub.name.padEnd(subcommandWidest))} ${gray(sub.description)}`);
+	}
+	print("");
+}
+async function run(externalCommands) {
+	const commands = [...LOCAL_COMMANDS, ...externalCommands];
+	const helpCommands = commands.filter((c) => c.tag !== "hidden");
+	const showHelpForCommands = () => showHelp(helpCommands);
+	const props = {
+		name: "uds",
+		commandPath: positional.slice(0, 1),
+		first: positional[1],
+		second: positional[2],
+		third: positional[3],
+		options
+	};
+	if (command === "help" || command === "--help" || command === "-h" || !command) {
+		showHelpForCommands();
+		return;
+	}
+	const commandDefinition = commands.find((c) => c.name === command || c.aliases?.includes(command));
+	if (!commandDefinition) {
+		print(red(`Unknown command: ${command}`));
+		await trackEvent("unknown_cmd", { cmd: command });
+		showHelpForCommands();
+		process.exitCode = 1;
+		return;
+	}
+	await commandDefinition.run(props);
+}
+
+//#endregion
+export { run };

package/dist/cli/dist/commands/codemod/codemod.cjs

@@ -0,0 +1,81 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_analytics = require('../../utils/analytics.cjs');
+const require_getCommandHelp = require('../../utils/getCommandHelp.cjs');
+const require_getDirChoices = require('../../utils/getDirChoices.cjs');
+let prompts = require("prompts");
+prompts = require_runtime.__toESM(prompts);
+
+//#region ../cli/dist/commands/codemod/codemod.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+var codemod_default = {
+	name: "codemod",
+	description: `Apply a codemod`,
+	run: async (props) => {
+		const subCommands = await require_getCommandHelp.getSubCommandsChoices(props);
+		const subCommandIsValid = subCommands.some(({ value }) => props?.first === value);
+		const wantsHelp = props.options.help || props.options.h;
+		const isRootCommand = Boolean(!props?.first);
+		const dirChoices = require_getDirChoices.getDirChoices();
+		if (wantsHelp) return require_getCommandHelp.getCommandHelp(props);
+		const runCodeMod = async (codemod, selectedDirs) => {
+			return (await import(`./${codemod}`)).default.run({
+				...props,
+				selectedDirs
+			});
+		};
+		if (isRootCommand) {
+			const { selectedDirs, selectedCodemods, didConfirm } = await (0, prompts.default)([
+				{
+					type: "multiselect",
+					name: "selectedDirs",
+					instructions: false,
+					message: "Where are your sourcefiles?",
+					hint: "(Space to select. Return to submit)",
+					choices: dirChoices
+				},
+				{
+					type: "multiselect",
+					name: "selectedCodemods",
+					instructions: false,
+					message: "Select the codemods you want to run",
+					hint: "(Space to select. Return to submit)",
+					choices: subCommands
+				},
+				{
+					type: "toggle",
+					name: "didConfirm",
+					message: "Are you ready?",
+					initial: true,
+					active: "yes",
+					inactive: "no"
+				}
+			]);
+			if (!selectedDirs?.length || !selectedCodemods?.length || !didConfirm) process.exit(1);
+			await Promise.all(selectedCodemods.map(async (codemod) => {
+				await runCodeMod(codemod, selectedDirs);
+				return require_analytics.trackEvent("codemod", { codemod });
+			}));
+			return;
+		} else if (subCommandIsValid) {
+			const { selectedDirs } = await (0, prompts.default)({
+				type: "multiselect",
+				name: "selectedDirs",
+				instructions: false,
+				message: "Where are your sourcefiles?",
+				hint: "(Space to select. Return to submit)",
+				choices: dirChoices
+			});
+			if (!selectedDirs?.length) process.exit(1);
+			const codemod = props.first;
+			await runCodeMod(codemod, selectedDirs);
+			return require_analytics.trackEvent("codemod", { codemod });
+		} else await require_getCommandHelp.getCommandHelp({
+			...props,
+			notes: `That codemod does not exist. Try one of the codemods listed above!`
+		});
+	}
+};
+
+//#endregion
+exports.codemod_default = codemod_default;