@yahoo/uds 3.96.0 → 3.97.0

package/dist/cli.mjs

@@ -1,897 +0,0 @@
-#!/usr/bin/env node
-import packageJson from "@yahoo/uds/package.json" with { type: "json" };
-import updateNotifier from "simple-update-notifier";
-import prompts from "prompts";
-import { execSync } from "node:child_process";
-import fs, { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import path, { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import fg from "fast-glob";
-import { Node, Project, SyntaxKind, ts } from "ts-morph";
-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 { componentToTwClasses, componentToVariants, componentsDependencies, variantsList } from "./tailwind/purger/index.js";
-import { findReferencesAsJsxElements, getUsedPropsInReference } from "./tailwind/tsMorph.js";
-import { defaultTokensConfig } from "./defaultTokensConfig.js";
-import { configToBreakpointsConfigContext } from "./runtime/breakpointsConfig.js";
-import { configToToastConfigContext } from "./runtime/toastConfig.js";
-
-//#region cli/utils/analytics.ts
-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
-//#region cli/lib/args.ts
-/**
-* 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
-//#region cli/lib/colors.ts
-/**
-* 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
-//#region cli/lib/print.ts
-/**
-* Console output wrapper.
-*/
-function print(...args) {
-	console.log(...args);
-}
-
-//#endregion
-//#region cli/lib/spinner.ts
-/**
-* 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
-//#region cli/utils/getCommandHelp.ts
-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$1 = `
-█ █ █▀▄ ▄▀▀   ▄▀▀ █   █
-▀▄█ █▄▀ ▄██   ▀▄▄ █▄▄ █
-Universal Design System
-`.trim();
-async function getCommandHelp(props) {
-	const { name, commandPath, notes } = props;
-	const category = commandPath?.[0];
-	print(`\n${green(banner$1)}\n`);
-	print(`${magenta("Usage:")} ${white(`${name} <command>`)}\n`);
-	if (category === "codemod") {
-		print(`${magenta("Codemods:")}`);
-		const widest = Math.max(...CODEMOD_SUBCOMMANDS.map((c) => c.name.length)) + 4;
-		for (const cmd of CODEMOD_SUBCOMMANDS) print(`  ${cyan(`${name} codemod ${cmd.name}`.padEnd(widest + 12))} ${gray(cmd.description)}`);
-	}
-	if (notes) print(`\n${magenta("Notes:")} ${notes}`);
-	print("");
-}
-async function getSubCommandsChoices(_props) {
-	return CODEMOD_SUBCOMMANDS.map((cmd) => ({
-		title: `${cmd.name} (${cmd.description})`,
-		value: cmd.name,
-		selected: true
-	}));
-}
-
-//#endregion
-//#region cli/utils/getDirChoices.ts
-const lessCommonDirs = [
-	"node_modules",
-	".git",
-	".github",
-	".husky",
-	".vscode",
-	"dist",
-	"build",
-	"public"
-];
-const getDirChoices = (rootDir = ".") => {
-	return fs.readdirSync(rootDir).filter((dir) => fs.statSync(dir).isDirectory() && dir !== "node_modules" && !dir.startsWith(".")).map((dir) => ({
-		title: dir,
-		value: dir,
-		selected: !lessCommonDirs.includes(dir)
-	}));
-};
-
-//#endregion
-//#region cli/commands/codemod/codemod.ts
-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);
-			return Promise.all(selectedCodemods.map(async (codemod) => {
-				await runCodeMod(codemod, selectedDirs);
-				return trackEvent("codemod", { codemod });
-			}));
-		} 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
-//#region cli/rules/config.ts
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const EDITOR_CONFIGS = { cursor: {
-	name: "Cursor",
-	description: "AI-powered coding assistant rules for UDS development",
-	rules: [
-		{
-			name: "UDS Components",
-			description: "Component development guidelines and patterns",
-			files: [{
-				source: "rules/cursor/uds/components.mdc",
-				target: ".cursor/rules/uds/components.mdc",
-				type: "file"
-			}]
-		},
-		{
-			name: "UDS Tailwind",
-			description: "Tailwind CSS configuration and setup guidelines",
-			files: [{
-				source: "rules/cursor/uds/tailwind.mdc",
-				target: ".cursor/rules/uds/tailwind.mdc",
-				type: "file"
-			}]
-		},
-		{
-			name: "UDS Icons",
-			description: "Icon usage and documentation guidelines",
-			files: [{
-				source: "rules/cursor/uds/icons.mdc",
-				target: ".cursor/rules/uds/icons.mdc",
-				type: "file"
-			}]
-		}
-	]
-} };
-function getAvailableEditors() {
-	return Object.keys(EDITOR_CONFIGS);
-}
-function getEditorConfig(editor) {
-	return EDITOR_CONFIGS[editor];
-}
-function getRuleContent(rulePath) {
-	return readFileSync(join(__dirname, rulePath), "utf-8");
-}
-
-//#endregion
-//#region cli/commands/editor-rules.ts
-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
-//#region cli/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, packageJson.name, component));
-	references.push(...findNamedImportReferences(project, `${packageJson.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() === packageJson.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
-//#region cli/commands/purge.ts
-var purge_default = {
-	name: "purge",
-	description: `Purge unused CSS`,
-	run: async (props) => {
-		spinStart("Purging css started...");
-		try {
-			await purge(props.options);
-			spinStop("✅", "Purging css done!");
-			return await trackEvent("purge");
-		} 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
-//#region cli/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
-//#region cli/commands/sync.ts
-const PRODUCTION_ENDPOINT = "https://config.uds.build/api/config";
-const STAGING_ENDPOINT = "https://staging.config.uds.build/api/config";
-function getConfigEndpoint() {
-	if (process.env.DATABASE === "staging") return STAGING_ENDPOINT;
-	if (process.env.DATABASE === "local") return `http://localhost:${process.env.PORT || 4001}/api/config`;
-	return PRODUCTION_ENDPOINT;
-}
-var sync_default = {
-	name: "sync",
-	description: "🔄 Update to latest design config 🎨",
-	alias: ["update"],
-	run: async ({ name, commandPath, options }) => {
-		const id = options.id || process.env.UDS_ID;
-		const outFile = options.outFile || process.env.UDS_OUT_FILE;
-		if (!id || typeof id === "boolean") {
-			console.error("\nMissing config ID. Please pass an --id flag or set the UDS_ID env variable.\n");
-			print(`${magenta("Usage:")} ${name} ${commandPath} --id <config-id>\n`);
-			return;
-		}
-		const outputPath = outFile ?? "./uds.config.ts";
-		const outFileExtension = outputPath.split(".").pop()?.toLowerCase();
-		if (outFileExtension !== "ts" && outFileExtension !== "js") {
-			print(red("❌ Output file must be a TypeScript or JavaScript file."));
-			process.exitCode = 1;
-			return;
-		}
-		try {
-			const fetchUrl = `${getConfigEndpoint()}?id=${id}`;
-			const fullPath = path.resolve(process.cwd(), outputPath);
-			print(yellow("Fetching from configurator..."));
-			let config;
-			if (process.env.DATABASE === "test") config = defaultTokensConfig;
-			else {
-				const resp = await fetch(fetchUrl);
-				if (!resp.ok) {
-					if (resp.status === 401) throw new Error(`${resp.status} error: ${resp.statusText}\nYou're not authorized to fetch from ${fetchUrl}\nMake sure you have a valid VERCEL_PROTECTION_BYPASS token in your root .env.local`);
-					throw new Error(`Error fetching config id '${id}'. Does it exist in the Configurator?`);
-				}
-				config = (await resp.json()).config;
-			}
-			if (!config) throw new Error("Config JSON could not be parsed.");
-			const sortedConfig = sortKeys(config);
-			const importsTS = [`import type { UniversalTokensConfig } from '@yahoo/uds';`];
-			const exportsTS = [`export const config: UniversalTokensConfig = ${JSON.stringify(sortedConfig, null, 2)};`];
-			const exportsJS = [`export const config = ${JSON.stringify(sortedConfig, null, 2)};`];
-			const runtimeConfigs = {
-				breakpoints: [configToBreakpointsConfigContext(sortedConfig), "UDSBreakpointsConfigContextType"],
-				toast: [configToToastConfigContext(sortedConfig), "UDSToastConfigContextType"]
-			};
-			const runtimeTypeImports = [];
-			for (const [name, [json, type]] of Object.entries(runtimeConfigs)) {
-				const content = 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)};`);
-			}
-			runtimeTypeImports.push("UDSConfigContextType");
-			importsTS.push(`import type { ${runtimeTypeImports.sort().join(", ")} } from '@yahoo/uds/runtime';`);
-			exportsTS.push(`export const runtimeConfig: UDSConfigContextType = {
-  breakpoints: breakpointsRuntimeConfig,
-  toast: toastRuntimeConfig,
-};`);
-			exportsJS.push(`export const runtimeConfig = {
-  breakpoints: breakpointsRuntimeConfig,
-  toast: toastRuntimeConfig,
-};`);
-			const configContentTs = `${importsTS.join("\n")}\n\n${exportsTS.join("\n\n")}\n`;
-			const configContentJs = `${exportsJS.join("\n\n")}\n`;
-			writeFileSync(fullPath, outFileExtension === "js" ? configContentJs : configContentTs);
-			print(green(`✅ Synced UDS config ${id} to ${fullPath}`));
-			await trackEvent("sync", { id });
-		} catch (error) {
-			print(red(`❌ ${error.message}`));
-			print(yellow("Please reach out to #uds-ask channel for support."));
-			process.exitCode = 1;
-		}
-	}
-};
-
-//#endregion
-//#region cli/commands/version.ts
-const version = packageJson.version;
-var version_default = {
-	name: "version",
-	description: version,
-	run: async () => {
-		print(version);
-		await trackEvent("version", { version });
-	}
-};
-
-//#endregion
-//#region cli/cli.ts
-/**
-* 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 COMMANDS = [
-	{
-		name: "sync",
-		description: "🔄 Update to latest design config 🎨",
-		aliases: ["update"]
-	},
-	{
-		name: "purge",
-		description: "Purge unused CSS"
-	},
-	{
-		name: "editor-rules",
-		description: "🎯 Generate editor rules for various code editors and AI tools",
-		aliases: ["rules", "editor"]
-	},
-	{
-		name: "version",
-		description: `Display CLI version (${packageJson.version})`
-	},
-	{
-		name: "codemod",
-		description: "Apply a codemod"
-	}
-];
-function showHelp(notes) {
-	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("");
-	if (notes) print(`${magenta("Notes:")} ${notes}\n`);
-}
-async function main() {
-	if (process.env.CI !== "1") await updateNotifier({
-		pkg: packageJson,
-		shouldNotifyInNpmScript: true
-	});
-	const props = {
-		name: "uds",
-		commandPath: positional.slice(0, 1),
-		first: positional[1],
-		second: positional[2],
-		third: positional[3],
-		options
-	};
-	switch (command) {
-		case "sync":
-		case "update":
-			await sync_default.run(props);
-			break;
-		case "purge":
-			await purge_default.run(props);
-			break;
-		case "editor-rules":
-		case "rules":
-		case "editor":
-			await editor_rules_default.run(props);
-			break;
-		case "version":
-			await version_default.run();
-			break;
-		case "codemod":
-			await codemod_default.run({
-				...props,
-				first: positional[1]
-			});
-			break;
-		case "help":
-		case "--help":
-		case "-h":
-		case void 0:
-			showHelp();
-			break;
-		default:
-			print(red(`Unknown command: ${command}`));
-			await trackEvent("unknown_cmd", { cmd: command });
-			showHelp();
-			process.exitCode = 1;
-	}
-}
-await main();
-
-//#endregion
-export {  };