@yahoo/uds 3.96.0 → 3.97.0

package/dist/cli/dist/commands/codemod/codemod.js

@@ -0,0 +1,79 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { trackEvent } from "../../utils/analytics.js";
+import { getCommandHelp, getSubCommandsChoices } from "../../utils/getCommandHelp.js";
+import { getDirChoices } from "../../utils/getDirChoices.js";
+import prompts from "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 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 = getDirChoices();
+		if (wantsHelp) return getCommandHelp(props);
+		const runCodeMod = async (codemod, selectedDirs) => {
+			return (await import(`./${codemod}`)).default.run({
+				...props,
+				selectedDirs
+			});
+		};
+		if (isRootCommand) {
+			const { selectedDirs, selectedCodemods, didConfirm } = await prompts([
+				{
+					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 trackEvent("codemod", { codemod });
+			}));
+			return;
+		} else if (subCommandIsValid) {
+			const { selectedDirs } = await prompts({
+				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 trackEvent("codemod", { codemod });
+		} else await getCommandHelp({
+			...props,
+			notes: `That codemod does not exist. Try one of the codemods listed above!`
+		});
+	}
+};
+
+//#endregion
+export { codemod_default };

package/dist/cli/dist/commands/editor-rules.cjs

@@ -0,0 +1,107 @@
+/*! © 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_colors = require('../lib/colors.cjs');
+const require_print = require('../lib/print.cjs');
+const require_config = require('../utils/rules/config.cjs');
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+
+//#region ../cli/dist/commands/editor-rules.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+var editor_rules_default = {
+	name: "editor-rules",
+	description: "🎯 Generate editor rules for various code editors and AI tools",
+	alias: ["rules", "editor"],
+	run: async ({ options }) => {
+		if (process.argv.includes("--help") || process.argv.includes("-h")) {
+			require_print.print(require_colors.blue("🎯 UDS Editor Rules Command"));
+			require_print.print("");
+			require_print.print(require_colors.green("Description: Generate editor rules for various code editors and AI tools"));
+			require_print.print("");
+			require_print.print(require_colors.yellow("Options:"));
+			require_print.print("  --force, -f     Force overwrite existing rules directory");
+			require_print.print("  --output, -o    Output directory (defaults to workspace root)");
+			require_print.print("  --editor, -e    Specific editor/tool (defaults to all)");
+			require_print.print("");
+			require_print.print(require_colors.blue("Available editors/tools:"));
+			const editors = require_config.getAvailableEditors();
+			for (const editor of editors) {
+				const config = require_config.getEditorConfig(editor);
+				if (config) require_print.print(`  • ${editor}: ${config.description}`);
+			}
+			require_print.print("");
+			require_print.print(require_colors.blue("Examples:"));
+			require_print.print("  uds editor-rules                    # Generate all rules in current directory");
+			require_print.print("  uds editor-rules --editor cursor    # Generate only Cursor rules");
+			require_print.print("  uds editor-rules --output /path     # Generate rules in specific directory");
+			require_print.print("  uds editor-rules --force            # Force overwrite existing rules");
+			require_print.print("");
+			require_print.print(require_colors.green("What it generates:"));
+			require_print.print("  • Cursor Rules (.cursor/uds/)");
+			return;
+		}
+		try {
+			const outputDir = options.output || process.cwd();
+			const selectedEditor = options.editor?.toLowerCase();
+			const force = options.force === "true" || options.force === true;
+			require_print.print(require_colors.blue(`📁 Generating editor rules in: ${outputDir}`));
+			if (selectedEditor) {
+				const editorConfig = require_config.getEditorConfig(selectedEditor);
+				if (!editorConfig) {
+					require_print.print(require_colors.red(`❌ Unknown editor: ${selectedEditor}`));
+					require_print.print(require_colors.yellow("Available editors:"));
+					const editors = require_config.getAvailableEditors();
+					for (const editor of editors) {
+						const config = require_config.getEditorConfig(editor);
+						if (config) require_print.print(`  • ${editor}: ${config.description}`);
+					}
+					return;
+				}
+				await generateEditorRules(outputDir, selectedEditor, editorConfig, force);
+			} else {
+				const editors = require_config.getAvailableEditors();
+				for (const editor of editors) {
+					const editorConfig = require_config.getEditorConfig(editor);
+					if (editorConfig) await generateEditorRules(outputDir, editor, editorConfig, force);
+				}
+			}
+			require_print.print(require_colors.green("🎉 Editor rules generated successfully!"));
+			require_print.print(require_colors.blue("📝 Rules are now available for your development environment"));
+			await require_analytics.trackEvent("editor_rules_generated", {
+				output_dir: outputDir,
+				force: force || false,
+				editor: selectedEditor || "all"
+			});
+		} catch (error) {
+			require_print.print(require_colors.red(`❌ Error generating editor rules: ${error}`));
+			process.exitCode = 1;
+		}
+	}
+};
+async function generateEditorRules(outputDir, editorName, editorConfig, force = false) {
+	require_print.print(require_colors.blue(`\n🔧 Generating ${editorConfig.name} rules...`));
+	for (const rule of editorConfig.rules) {
+		require_print.print(require_colors.yellow(`  📝 ${rule.name}: ${rule.description}`));
+		for (const file of rule.files) {
+			const targetPath = (0, node_path.join)(outputDir, file.target);
+			const targetDir = (0, node_path.join)(targetPath, "..");
+			if (!(0, node_fs.existsSync)(targetDir)) (0, node_fs.mkdirSync)(targetDir, { recursive: true });
+			if ((0, node_fs.existsSync)(targetPath)) if (force) require_print.print(require_colors.yellow(`    🗑️  Overwriting: ${file.target}`));
+			else {
+				require_print.print(require_colors.red(`    ❌ File already exists: ${file.target}`));
+				require_print.print(require_colors.yellow("    Use --force to overwrite existing files"));
+				continue;
+			}
+			try {
+				(0, node_fs.writeFileSync)(targetPath, require_config.getRuleContent(file.source));
+				require_print.print(require_colors.green(`    ✅ Created: ${file.target}`));
+			} catch (error) {
+				require_print.print(require_colors.red(`    ❌ Error creating ${file.target}: ${error}`));
+			}
+		}
+	}
+}
+
+//#endregion
+exports.editor_rules_default = editor_rules_default;

package/dist/cli/dist/commands/editor-rules.js

@@ -0,0 +1,106 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { trackEvent } from "../utils/analytics.js";
+import { blue, green, red, yellow } from "../lib/colors.js";
+import { print } from "../lib/print.js";
+import { getAvailableEditors, getEditorConfig, getRuleContent } from "../utils/rules/config.js";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region ../cli/dist/commands/editor-rules.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+var editor_rules_default = {
+	name: "editor-rules",
+	description: "🎯 Generate editor rules for various code editors and AI tools",
+	alias: ["rules", "editor"],
+	run: async ({ options }) => {
+		if (process.argv.includes("--help") || process.argv.includes("-h")) {
+			print(blue("🎯 UDS Editor Rules Command"));
+			print("");
+			print(green("Description: Generate editor rules for various code editors and AI tools"));
+			print("");
+			print(yellow("Options:"));
+			print("  --force, -f     Force overwrite existing rules directory");
+			print("  --output, -o    Output directory (defaults to workspace root)");
+			print("  --editor, -e    Specific editor/tool (defaults to all)");
+			print("");
+			print(blue("Available editors/tools:"));
+			const editors = getAvailableEditors();
+			for (const editor of editors) {
+				const config = getEditorConfig(editor);
+				if (config) print(`  • ${editor}: ${config.description}`);
+			}
+			print("");
+			print(blue("Examples:"));
+			print("  uds editor-rules                    # Generate all rules in current directory");
+			print("  uds editor-rules --editor cursor    # Generate only Cursor rules");
+			print("  uds editor-rules --output /path     # Generate rules in specific directory");
+			print("  uds editor-rules --force            # Force overwrite existing rules");
+			print("");
+			print(green("What it generates:"));
+			print("  • Cursor Rules (.cursor/uds/)");
+			return;
+		}
+		try {
+			const outputDir = options.output || process.cwd();
+			const selectedEditor = options.editor?.toLowerCase();
+			const force = options.force === "true" || options.force === true;
+			print(blue(`📁 Generating editor rules in: ${outputDir}`));
+			if (selectedEditor) {
+				const editorConfig = getEditorConfig(selectedEditor);
+				if (!editorConfig) {
+					print(red(`❌ Unknown editor: ${selectedEditor}`));
+					print(yellow("Available editors:"));
+					const editors = getAvailableEditors();
+					for (const editor of editors) {
+						const config = getEditorConfig(editor);
+						if (config) print(`  • ${editor}: ${config.description}`);
+					}
+					return;
+				}
+				await generateEditorRules(outputDir, selectedEditor, editorConfig, force);
+			} else {
+				const editors = getAvailableEditors();
+				for (const editor of editors) {
+					const editorConfig = getEditorConfig(editor);
+					if (editorConfig) await generateEditorRules(outputDir, editor, editorConfig, force);
+				}
+			}
+			print(green("🎉 Editor rules generated successfully!"));
+			print(blue("📝 Rules are now available for your development environment"));
+			await trackEvent("editor_rules_generated", {
+				output_dir: outputDir,
+				force: force || false,
+				editor: selectedEditor || "all"
+			});
+		} catch (error) {
+			print(red(`❌ Error generating editor rules: ${error}`));
+			process.exitCode = 1;
+		}
+	}
+};
+async function generateEditorRules(outputDir, editorName, editorConfig, force = false) {
+	print(blue(`\n🔧 Generating ${editorConfig.name} rules...`));
+	for (const rule of editorConfig.rules) {
+		print(yellow(`  📝 ${rule.name}: ${rule.description}`));
+		for (const file of rule.files) {
+			const targetPath = join(outputDir, file.target);
+			const targetDir = join(targetPath, "..");
+			if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
+			if (existsSync(targetPath)) if (force) print(yellow(`    🗑️  Overwriting: ${file.target}`));
+			else {
+				print(red(`    ❌ File already exists: ${file.target}`));
+				print(yellow("    Use --force to overwrite existing files"));
+				continue;
+			}
+			try {
+				writeFileSync(targetPath, getRuleContent(file.source));
+				print(green(`    ✅ Created: ${file.target}`));
+			} catch (error) {
+				print(red(`    ❌ Error creating ${file.target}: ${error}`));
+			}
+		}
+	}
+}
+
+//#endregion
+export { editor_rules_default };

package/dist/cli/dist/lib/args.cjs

@@ -0,0 +1,32 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region ../cli/dist/lib/args.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Parse command line arguments.
+* @param argv - Arguments to parse (typically process.argv.slice(2))
+* @returns Parsed positional args and options
+*/
+function parseArgs(argv) {
+	const positional = [];
+	const options = {};
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg.startsWith("--")) {
+			const key = arg.slice(2);
+			const next = argv[i + 1];
+			options[key] = next && !next.startsWith("-") ? (i++, next) : "true";
+		} else if (arg.startsWith("-") && arg.length === 2) {
+			const key = arg.slice(1);
+			const next = argv[i + 1];
+			options[key] = next && !next.startsWith("-") ? (i++, next) : "true";
+		} else positional.push(arg);
+	}
+	return {
+		positional,
+		options
+	};
+}
+
+//#endregion
+exports.parseArgs = parseArgs;

package/dist/cli/dist/lib/args.js

@@ -0,0 +1,31 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region ../cli/dist/lib/args.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Parse command line arguments.
+* @param argv - Arguments to parse (typically process.argv.slice(2))
+* @returns Parsed positional args and options
+*/
+function parseArgs(argv) {
+	const positional = [];
+	const options = {};
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg.startsWith("--")) {
+			const key = arg.slice(2);
+			const next = argv[i + 1];
+			options[key] = next && !next.startsWith("-") ? (i++, next) : "true";
+		} else if (arg.startsWith("-") && arg.length === 2) {
+			const key = arg.slice(1);
+			const next = argv[i + 1];
+			options[key] = next && !next.startsWith("-") ? (i++, next) : "true";
+		} else positional.push(arg);
+	}
+	return {
+		positional,
+		options
+	};
+}
+
+//#endregion
+export { parseArgs };

package/dist/cli/dist/lib/colors.cjs

@@ -0,0 +1,26 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region ../cli/dist/lib/colors.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* ANSI escape code color utilities for terminal output.
+* Zero dependencies - uses standard ANSI escape sequences.
+*/
+const red = (text) => `\x1b[31m${text}\x1b[0m`;
+const green = (text) => `\x1b[32m${text}\x1b[0m`;
+const yellow = (text) => `\x1b[33m${text}\x1b[0m`;
+const blue = (text) => `\x1b[34m${text}\x1b[0m`;
+const magenta = (text) => `\x1b[35m${text}\x1b[0m`;
+const cyan = (text) => `\x1b[36m${text}\x1b[0m`;
+const white = (text) => `\x1b[37m${text}\x1b[0m`;
+const gray = (text) => `\x1b[2m${text}\x1b[0m`;
+
+//#endregion
+exports.blue = blue;
+exports.cyan = cyan;
+exports.gray = gray;
+exports.green = green;
+exports.magenta = magenta;
+exports.red = red;
+exports.white = white;
+exports.yellow = yellow;

package/dist/cli/dist/lib/colors.js

@@ -0,0 +1,18 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region ../cli/dist/lib/colors.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* ANSI escape code color utilities for terminal output.
+* Zero dependencies - uses standard ANSI escape sequences.
+*/
+const red = (text) => `\x1b[31m${text}\x1b[0m`;
+const green = (text) => `\x1b[32m${text}\x1b[0m`;
+const yellow = (text) => `\x1b[33m${text}\x1b[0m`;
+const blue = (text) => `\x1b[34m${text}\x1b[0m`;
+const magenta = (text) => `\x1b[35m${text}\x1b[0m`;
+const cyan = (text) => `\x1b[36m${text}\x1b[0m`;
+const white = (text) => `\x1b[37m${text}\x1b[0m`;
+const gray = (text) => `\x1b[2m${text}\x1b[0m`;
+
+//#endregion
+export { blue, cyan, gray, green, magenta, red, white, yellow };

package/dist/cli/dist/lib/print.cjs

@@ -0,0 +1,13 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region ../cli/dist/lib/print.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Console output wrapper.
+*/
+function print(...args) {
+	console.log(...args);
+}
+
+//#endregion
+exports.print = print;

package/dist/cli/dist/lib/print.js

@@ -0,0 +1,12 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region ../cli/dist/lib/print.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Console output wrapper.
+*/
+function print(...args) {
+	console.log(...args);
+}
+
+//#endregion
+export { print };

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

@@ -0,0 +1,59 @@
+/*! © 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,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
+export { spinStart, spinStop };

package/dist/cli/dist/utils/analytics.cjs

@@ -0,0 +1,33 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+let node_child_process = require("node:child_process");
+
+//#region ../cli/dist/utils/analytics.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+async function trackEvent(eventName, eventParams) {
+	try {
+		let userEmail = "unknown";
+		if (process.env.CI) userEmail = "CI";
+		else try {
+			userEmail = (0, node_child_process.execSync)("git config user.email", {
+				encoding: "utf8",
+				stdio: "pipe"
+			}).trim();
+		} catch {}
+		const team = process.env.UDS_TEAM_SLUG;
+		const request = new Request("https://config.uds.build/api/cli-analytics", {
+			method: "POST",
+			body: JSON.stringify({
+				userEmail,
+				team,
+				eventName,
+				eventParams
+			}),
+			headers: { "Content-Type": "application/json" }
+		});
+		await fetch(request);
+	} catch (_error) {}
+}
+
+//#endregion
+exports.trackEvent = trackEvent;

package/dist/cli/dist/utils/analytics.js

@@ -0,0 +1,32 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { execSync } from "node:child_process";
+
+//#region ../cli/dist/utils/analytics.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+async function trackEvent(eventName, eventParams) {
+	try {
+		let userEmail = "unknown";
+		if (process.env.CI) userEmail = "CI";
+		else try {
+			userEmail = execSync("git config user.email", {
+				encoding: "utf8",
+				stdio: "pipe"
+			}).trim();
+		} catch {}
+		const team = process.env.UDS_TEAM_SLUG;
+		const request = new Request("https://config.uds.build/api/cli-analytics", {
+			method: "POST",
+			body: JSON.stringify({
+				userEmail,
+				team,
+				eventName,
+				eventParams
+			}),
+			headers: { "Content-Type": "application/json" }
+		});
+		await fetch(request);
+	} catch (_error) {}
+}
+
+//#endregion
+export { trackEvent };

package/dist/cli/dist/utils/getCommandHelp.cjs

@@ -0,0 +1,58 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_colors = require('../lib/colors.cjs');
+const require_print = require('../lib/print.cjs');
+
+//#region ../cli/dist/utils/getCommandHelp.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+const CODEMOD_SUBCOMMANDS = [
+	{
+		name: "sizingProps",
+		description: "Convert sizing props to classNames"
+	},
+	{
+		name: "spacingProps",
+		description: "Migrate spacing props from old to new values"
+	},
+	{
+		name: "tailwindClassesToProps",
+		description: "Convert Tailwind classes to UDS props"
+	},
+	{
+		name: "flattenButtonVariant",
+		description: "Flatten Button variant props"
+	},
+	{
+		name: "buttonType",
+		description: "Add type attribute to Button components"
+	}
+];
+const banner = `
+█ █ █▀▄ ▄▀▀   ▄▀▀ █   █
+▀▄█ █▄▀ ▄██   ▀▄▄ █▄▄ █
+Universal Design System
+`.trim();
+async function getCommandHelp(props) {
+	const { name, commandPath, notes } = props;
+	const category = commandPath?.[0];
+	require_print.print(`\n${require_colors.green(banner)}\n`);
+	require_print.print(`${require_colors.magenta("Usage:")} ${require_colors.white(`${name} <command>`)}\n`);
+	if (category === "codemod") {
+		require_print.print(`${require_colors.magenta("Codemods:")}`);
+		const widest = Math.max(...CODEMOD_SUBCOMMANDS.map((c) => c.name.length)) + 4;
+		for (const cmd of CODEMOD_SUBCOMMANDS) require_print.print(`  ${require_colors.cyan(`${name} codemod ${cmd.name}`.padEnd(widest + 12))} ${require_colors.gray(cmd.description)}`);
+	}
+	if (notes) require_print.print(`\n${require_colors.magenta("Notes:")} ${notes}`);
+	require_print.print("");
+}
+async function getSubCommandsChoices(_props) {
+	return CODEMOD_SUBCOMMANDS.map((cmd) => ({
+		title: `${cmd.name} (${cmd.description})`,
+		value: cmd.name,
+		selected: true
+	}));
+}
+
+//#endregion
+exports.CODEMOD_SUBCOMMANDS = CODEMOD_SUBCOMMANDS;
+exports.getCommandHelp = getCommandHelp;
+exports.getSubCommandsChoices = getSubCommandsChoices;