@yahoo/uds 3.116.0-beta.3 → 3.116.1

package/dist/tailwind/dist/css/runner.cjs

@@ -3,6 +3,7 @@ const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_index = require('../../../config/dist/index.cjs');
 const require_colors = require('../../../cli/dist/lib/colors.cjs');
 const require_print = require('../../../cli/dist/lib/print.cjs');
+const require_entryPoints = require('../utils/entryPoints.cjs');
 const require_spinner = require('../../../cli/dist/lib/spinner.cjs');
 const require_logger = require('../../../cli/dist/lib/logger.cjs');
 const require_nodeUtils = require('./nodeUtils.cjs');
@@ -17,13 +18,34 @@ node_fs = require_runtime.__toESM(node_fs);
 
 //#region ../tailwind/dist/css/runner.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
-const DEFAULT_ENTRY = "./src";
 const SOURCE_FILE_PATTERN = /\.(jsx?|tsx?)$/i;
 const getWatchDirs = (dirs) => [...new Set(dirs.filter((dir) => !dir.split(node_path.default.sep).includes("node_modules")))];
-const watchSourceFiles = (dirs, onFileChange) => {
-	dirs.forEach((dir) => {
-		node_fs.default.watch(dir, { recursive: true }, (_eventType, filename) => {
-			if (filename && SOURCE_FILE_PATTERN.test(filename)) onFileChange();
+const isCoveredByRecursiveWatch = (watchPath, targetPath) => targetPath === watchPath || targetPath.startsWith(`${watchPath}${node_path.default.sep}`);
+const getEntryWatchTargets = (entries) => {
+	const directoryTargets = getWatchDirs(entries.filter((entry) => entry.kind === "directory").map((entry) => entry.absolutePath)).map((watchPath) => ({
+		watchPath,
+		recursive: true
+	}));
+	const fileNamesByDirectory = /* @__PURE__ */ new Map();
+	entries.filter((entry) => entry.kind === "file" && typeof entry.fileName === "string").forEach((entry) => {
+		if (directoryTargets.some((target) => isCoveredByRecursiveWatch(target.watchPath, entry.absolutePath))) return;
+		const fileNames = fileNamesByDirectory.get(entry.watchDirectory) ?? /* @__PURE__ */ new Set();
+		fileNames.add(entry.fileName);
+		fileNamesByDirectory.set(entry.watchDirectory, fileNames);
+	});
+	const fileTargets = [...fileNamesByDirectory.entries()].map(([watchPath, fileNames]) => ({
+		watchPath,
+		recursive: false,
+		fileNames: [...fileNames]
+	}));
+	return [...directoryTargets, ...fileTargets];
+};
+const watchSourceFiles = (targets, onFileChange) => {
+	targets.forEach((target) => {
+		node_fs.default.watch(target.watchPath, { recursive: target.recursive }, (_eventType, filename) => {
+			if (!filename || !SOURCE_FILE_PATTERN.test(filename)) return;
+			if (target.fileNames && !target.fileNames.includes(node_path.default.basename(String(filename)))) return;
+			onFileChange();
 		});
 	});
 };
@@ -68,7 +90,7 @@ const runCssCommand = async (options, context) => {
 	await runThemeMode(options, context);
 };
 const runSimpleMode = async (options, context) => {
-	const entry = typeof options.entryOption === "string" ? options.entryOption : DEFAULT_ENTRY;
+	const entry = options.entryOption ?? require_entryPoints.DEFAULT_ENTRY;
 	const configPath = typeof options.configOption === "string" ? options.configOption : void 0;
 	if (!options.watch && !options.silent) require_spinner.spinStart("Generating CSS...");
 	try {
@@ -91,12 +113,16 @@ const runSimpleMode = async (options, context) => {
 	}
 };
 const runSimpleModeWatch = async (options, context, entry, configPath, packageDirs) => {
-	const entryDir = node_path.default.join(options.workspaceDir, entry);
-	const watchDirs = getWatchDirs(packageDirs.length > 0 ? packageDirs : [entryDir]);
+	const entryWatchTargets = getEntryWatchTargets(require_entryPoints.resolveEntryPaths(entry, options.workspaceDir));
+	const fallbackTargets = getWatchDirs(packageDirs).map((watchPath) => ({
+		watchPath,
+		recursive: true
+	}));
+	const watchTargets = packageDirs.length > 0 ? fallbackTargets : entryWatchTargets;
 	if (!options.silent) {
 		require_print.print("");
 		require_print.print(`${require_colors.magenta("Watching for changes...")}`);
-		watchDirs.forEach((dir) => require_print.print(`   ${require_colors.gray("•")} ${dir}`));
+		watchTargets.forEach((target) => require_print.print(`   ${require_colors.gray("•")} ${target.watchPath}`));
 		require_print.print(`${require_colors.gray("Press Ctrl+C to stop")}`);
 		require_print.print("");
 	}
@@ -128,7 +154,7 @@ const runSimpleModeWatch = async (options, context, entry, configPath, packageDi
 			require_print.print(`Error: ${message}`);
 		}
 	});
-	watchSourceFiles(watchDirs, createDebouncedAction(() => {
+	watchSourceFiles(watchTargets, createDebouncedAction(() => {
 		regenerate();
 	}, 100));
 	await new Promise(() => {});
@@ -149,7 +175,7 @@ const loadThemeModeSetup = async (options) => {
 	return {
 		themeConfig,
 		colorModes: themeConfig.colorModes ?? ["dark"],
-		entry: themeConfig.entry ?? "/src/",
+		entries: require_entryPoints.resolveEntryPaths(themeConfig.entry, options.workspaceDir),
 		appConfig,
 		appVariantDefaults: require_utils.extractVariantDefaults(appConfig),
 		effectiveSilent: options.silent || themeConfig.silent === true
@@ -168,9 +194,10 @@ const runThemeMode = async (options, context) => {
 			process.exitCode = 1;
 			return;
 		}
-		const { themeConfig, colorModes, entry, appConfig, appVariantDefaults } = setup;
+		const { themeConfig, colorModes, entries, appConfig, appVariantDefaults } = setup;
 		effectiveSilent = setup.effectiveSilent;
 		log = require_logger.createLogger({ silent: effectiveSilent });
+		const entryDirs = entries.map((entry) => entry.absolutePath);
 		if (!effectiveSilent) log.spinStop("✅", "Theme configuration loaded");
 		if (themeConfig.config && appConfig === require_index.defaultTokensConfig) log.warn(`App config not found: ${themeConfig.config}, using defaults`);
 		const packageDirs = [];
@@ -178,7 +205,7 @@ const runThemeMode = async (options, context) => {
 			const genStartTime = performance.now();
 			const genLog = opts?.isWatch ? require_logger.createLogger({ silent: true }) : log;
 			genLog.spinStart("Scanning app code...");
-			const appScanResult = await require_nodeUtils.scanDirectoryForSafelist(node_path.default.join(workspaceDir, entry), colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults);
+			const appScanResult = await require_nodeUtils.scanDirectoriesForSafelist(entryDirs, colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults);
 			genLog.spinStop("✅", `Scanned ${appScanResult.filesScanned} files`);
 			genLog.spinStart("Generating main CSS...");
 			const inheritedClasses = [...appScanResult.safelist];
@@ -204,7 +231,7 @@ const runThemeMode = async (options, context) => {
 			const allMotionComponents = [...inheritedComponents];
 			const mainCssResult = await require_generate.generateCSS([...themeConfig.css?.safelist ?? [], ...mainSafelist], appConfig, {
 				scope: options.scope,
-				contentDir: node_path.default.join(workspaceDir, entry),
+				contentDir: entryDirs,
 				cssOptions: themeConfig.css,
 				safeVarPrefixes: [...require_utils.getMotionVarPrefixes(context.componentData, allMotionComponents), ...require_utils.getConfigurableCssVariables()]
 			});
@@ -231,12 +258,14 @@ const runThemeMode = async (options, context) => {
 		};
 		await generateThemeModeCSS();
 		if (options.watch) {
-			const entryDir = node_path.default.join(workspaceDir, entry);
-			const { watchDirs, filteredPackageDirs } = require_runner_helpers.getWatchDirectoryGroups(entryDir, [entryDir, ...packageDirs]);
+			const entryWatchTargets = getEntryWatchTargets(entries);
+			const { filteredPackageDirs } = require_runner_helpers.getWatchDirectoryGroups(getWatchDirs(entryWatchTargets.map((target) => target.watchPath)), [...entryDirs, ...packageDirs]);
 			if (!effectiveSilent) {
 				log.newline();
 				log.print(`${require_colors.magenta("Watching for changes...")}`);
-				log.listItem(`App: ${entryDir}`);
+				entryDirs.forEach((entryDir) => {
+					log.listItem(`App: ${entryDir}`);
+				});
 				filteredPackageDirs.forEach((dir) => {
 					log.listItem(`Package: ${dir}`);
 				});
@@ -262,9 +291,13 @@ const runThemeMode = async (options, context) => {
 					log.print(message);
 				}
 			});
-			watchSourceFiles(watchDirs, createDebouncedAction(() => {
+			const watchDebounce = themeConfig.css?.watchDebounce ?? 100;
+			watchSourceFiles([...entryWatchTargets, ...filteredPackageDirs.filter((packageDir) => !entryWatchTargets.some((target) => isCoveredByRecursiveWatch(target.watchPath, packageDir))).map((watchPath) => ({
+				watchPath,
+				recursive: true
+			}))], createDebouncedAction(() => {
 				regenerate();
-			}, themeConfig.css?.watchDebounce ?? 100));
+			}, watchDebounce));
 			await new Promise(() => {});
 		}
 	} catch (error) {

package/dist/tailwind/dist/css/runner.helpers.cjs

@@ -13,11 +13,11 @@ const getMainCssSummaryMessage = (options) => {
 	if (savedBytesGzip <= 0) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
 	return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip)(optimized: saved ${formatBytes(savedBytesGzip)} gzip, ${fontFacesRemoved} unused @font-face, ${emptyRulesRemoved} empty rules removed)`;
 };
-const getWatchDirectoryGroups = (entryDir, dirs) => {
+const getWatchDirectoryGroups = (entryDirs, dirs) => {
 	const watchDirs = [...new Set(dirs.filter((dir) => !dir.split(node_path.default.sep).includes("node_modules")))];
 	return {
 		watchDirs,
-		filteredPackageDirs: watchDirs.filter((dir) => dir !== entryDir)
+		filteredPackageDirs: watchDirs.filter((dir) => !entryDirs.includes(dir))
 	};
 };
 

package/dist/tailwind/dist/css/runner.helpers.js

@@ -11,11 +11,11 @@ const getMainCssSummaryMessage = (options) => {
 	if (savedBytesGzip <= 0) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
 	return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip)(optimized: saved ${formatBytes(savedBytesGzip)} gzip, ${fontFacesRemoved} unused @font-face, ${emptyRulesRemoved} empty rules removed)`;
 };
-const getWatchDirectoryGroups = (entryDir, dirs) => {
+const getWatchDirectoryGroups = (entryDirs, dirs) => {
 	const watchDirs = [...new Set(dirs.filter((dir) => !dir.split(path.sep).includes("node_modules")))];
 	return {
 		watchDirs,
-		filteredPackageDirs: watchDirs.filter((dir) => dir !== entryDir)
+		filteredPackageDirs: watchDirs.filter((dir) => !entryDirs.includes(dir))
 	};
 };
 

package/dist/tailwind/dist/css/runner.js

@@ -2,9 +2,10 @@
 import { defaultTokensConfig } from "../../../config/dist/index.js";
 import { gray, green, magenta } from "../../../cli/dist/lib/colors.js";
 import { print } from "../../../cli/dist/lib/print.js";
+import { DEFAULT_ENTRY, resolveEntryPaths } from "../utils/entryPoints.js";
 import { spinStart, spinStop } from "../../../cli/dist/lib/spinner.js";
 import { createLogger } from "../../../cli/dist/lib/logger.js";
-import { findPackageSourceDir, loadConfigFile, scanDirectoryForSafelist } from "./nodeUtils.js";
+import { findPackageSourceDir, loadConfigFile, scanDirectoriesForSafelist, scanDirectoryForSafelist } from "./nodeUtils.js";
 import { deduplicateSafelist, getThemeAndScaleClasses } from "../purger/optimized/utils/safelist.js";
 import { extractVariantDefaults, formatBytes, getConfigurableCssVariables, getMotionVarPrefixes } from "./utils.js";
 import { generateCSS, generateSimpleModeCSS } from "./generate.js";
@@ -14,13 +15,34 @@ import fs from "node:fs";
 
 //#region ../tailwind/dist/css/runner.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
-const DEFAULT_ENTRY = "./src";
 const SOURCE_FILE_PATTERN = /\.(jsx?|tsx?)$/i;
 const getWatchDirs = (dirs) => [...new Set(dirs.filter((dir) => !dir.split(path.sep).includes("node_modules")))];
-const watchSourceFiles = (dirs, onFileChange) => {
-	dirs.forEach((dir) => {
-		fs.watch(dir, { recursive: true }, (_eventType, filename) => {
-			if (filename && SOURCE_FILE_PATTERN.test(filename)) onFileChange();
+const isCoveredByRecursiveWatch = (watchPath, targetPath) => targetPath === watchPath || targetPath.startsWith(`${watchPath}${path.sep}`);
+const getEntryWatchTargets = (entries) => {
+	const directoryTargets = getWatchDirs(entries.filter((entry) => entry.kind === "directory").map((entry) => entry.absolutePath)).map((watchPath) => ({
+		watchPath,
+		recursive: true
+	}));
+	const fileNamesByDirectory = /* @__PURE__ */ new Map();
+	entries.filter((entry) => entry.kind === "file" && typeof entry.fileName === "string").forEach((entry) => {
+		if (directoryTargets.some((target) => isCoveredByRecursiveWatch(target.watchPath, entry.absolutePath))) return;
+		const fileNames = fileNamesByDirectory.get(entry.watchDirectory) ?? /* @__PURE__ */ new Set();
+		fileNames.add(entry.fileName);
+		fileNamesByDirectory.set(entry.watchDirectory, fileNames);
+	});
+	const fileTargets = [...fileNamesByDirectory.entries()].map(([watchPath, fileNames]) => ({
+		watchPath,
+		recursive: false,
+		fileNames: [...fileNames]
+	}));
+	return [...directoryTargets, ...fileTargets];
+};
+const watchSourceFiles = (targets, onFileChange) => {
+	targets.forEach((target) => {
+		fs.watch(target.watchPath, { recursive: target.recursive }, (_eventType, filename) => {
+			if (!filename || !SOURCE_FILE_PATTERN.test(filename)) return;
+			if (target.fileNames && !target.fileNames.includes(path.basename(String(filename)))) return;
+			onFileChange();
 		});
 	});
 };
@@ -65,7 +87,7 @@ const runCssCommand = async (options, context) => {
 	await runThemeMode(options, context);
 };
 const runSimpleMode = async (options, context) => {
-	const entry = typeof options.entryOption === "string" ? options.entryOption : DEFAULT_ENTRY;
+	const entry = options.entryOption ?? DEFAULT_ENTRY;
 	const configPath = typeof options.configOption === "string" ? options.configOption : void 0;
 	if (!options.watch && !options.silent) spinStart("Generating CSS...");
 	try {
@@ -88,12 +110,16 @@ const runSimpleMode = async (options, context) => {
 	}
 };
 const runSimpleModeWatch = async (options, context, entry, configPath, packageDirs) => {
-	const entryDir = path.join(options.workspaceDir, entry);
-	const watchDirs = getWatchDirs(packageDirs.length > 0 ? packageDirs : [entryDir]);
+	const entryWatchTargets = getEntryWatchTargets(resolveEntryPaths(entry, options.workspaceDir));
+	const fallbackTargets = getWatchDirs(packageDirs).map((watchPath) => ({
+		watchPath,
+		recursive: true
+	}));
+	const watchTargets = packageDirs.length > 0 ? fallbackTargets : entryWatchTargets;
 	if (!options.silent) {
 		print("");
 		print(`${magenta("Watching for changes...")}`);
-		watchDirs.forEach((dir) => print(`   ${gray("•")} ${dir}`));
+		watchTargets.forEach((target) => print(`   ${gray("•")} ${target.watchPath}`));
 		print(`${gray("Press Ctrl+C to stop")}`);
 		print("");
 	}
@@ -125,7 +151,7 @@ const runSimpleModeWatch = async (options, context, entry, configPath, packageDi
 			print(`Error: ${message}`);
 		}
 	});
-	watchSourceFiles(watchDirs, createDebouncedAction(() => {
+	watchSourceFiles(watchTargets, createDebouncedAction(() => {
 		regenerate();
 	}, 100));
 	await new Promise(() => {});
@@ -146,7 +172,7 @@ const loadThemeModeSetup = async (options) => {
 	return {
 		themeConfig,
 		colorModes: themeConfig.colorModes ?? ["dark"],
-		entry: themeConfig.entry ?? "/src/",
+		entries: resolveEntryPaths(themeConfig.entry, options.workspaceDir),
 		appConfig,
 		appVariantDefaults: extractVariantDefaults(appConfig),
 		effectiveSilent: options.silent || themeConfig.silent === true
@@ -165,9 +191,10 @@ const runThemeMode = async (options, context) => {
 			process.exitCode = 1;
 			return;
 		}
-		const { themeConfig, colorModes, entry, appConfig, appVariantDefaults } = setup;
+		const { themeConfig, colorModes, entries, appConfig, appVariantDefaults } = setup;
 		effectiveSilent = setup.effectiveSilent;
 		log = createLogger({ silent: effectiveSilent });
+		const entryDirs = entries.map((entry) => entry.absolutePath);
 		if (!effectiveSilent) log.spinStop("✅", "Theme configuration loaded");
 		if (themeConfig.config && appConfig === defaultTokensConfig) log.warn(`App config not found: ${themeConfig.config}, using defaults`);
 		const packageDirs = [];
@@ -175,7 +202,7 @@ const runThemeMode = async (options, context) => {
 			const genStartTime = performance.now();
 			const genLog = opts?.isWatch ? createLogger({ silent: true }) : log;
 			genLog.spinStart("Scanning app code...");
-			const appScanResult = await scanDirectoryForSafelist(path.join(workspaceDir, entry), colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults);
+			const appScanResult = await scanDirectoriesForSafelist(entryDirs, colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults);
 			genLog.spinStop("✅", `Scanned ${appScanResult.filesScanned} files`);
 			genLog.spinStart("Generating main CSS...");
 			const inheritedClasses = [...appScanResult.safelist];
@@ -201,7 +228,7 @@ const runThemeMode = async (options, context) => {
 			const allMotionComponents = [...inheritedComponents];
 			const mainCssResult = await generateCSS([...themeConfig.css?.safelist ?? [], ...mainSafelist], appConfig, {
 				scope: options.scope,
-				contentDir: path.join(workspaceDir, entry),
+				contentDir: entryDirs,
 				cssOptions: themeConfig.css,
 				safeVarPrefixes: [...getMotionVarPrefixes(context.componentData, allMotionComponents), ...getConfigurableCssVariables()]
 			});
@@ -228,12 +255,14 @@ const runThemeMode = async (options, context) => {
 		};
 		await generateThemeModeCSS();
 		if (options.watch) {
-			const entryDir = path.join(workspaceDir, entry);
-			const { watchDirs, filteredPackageDirs } = getWatchDirectoryGroups(entryDir, [entryDir, ...packageDirs]);
+			const entryWatchTargets = getEntryWatchTargets(entries);
+			const { filteredPackageDirs } = getWatchDirectoryGroups(getWatchDirs(entryWatchTargets.map((target) => target.watchPath)), [...entryDirs, ...packageDirs]);
 			if (!effectiveSilent) {
 				log.newline();
 				log.print(`${magenta("Watching for changes...")}`);
-				log.listItem(`App: ${entryDir}`);
+				entryDirs.forEach((entryDir) => {
+					log.listItem(`App: ${entryDir}`);
+				});
 				filteredPackageDirs.forEach((dir) => {
 					log.listItem(`Package: ${dir}`);
 				});
@@ -259,9 +288,13 @@ const runThemeMode = async (options, context) => {
 					log.print(message);
 				}
 			});
-			watchSourceFiles(watchDirs, createDebouncedAction(() => {
+			const watchDebounce = themeConfig.css?.watchDebounce ?? 100;
+			watchSourceFiles([...entryWatchTargets, ...filteredPackageDirs.filter((packageDir) => !entryWatchTargets.some((target) => isCoveredByRecursiveWatch(target.watchPath, packageDir))).map((watchPath) => ({
+				watchPath,
+				recursive: true
+			}))], createDebouncedAction(() => {
 				regenerate();
-			}, themeConfig.css?.watchDebounce ?? 100));
+			}, watchDebounce));
 			await new Promise(() => {});
 		}
 	} catch (error) {

package/dist/tailwind/dist/css/theme.d.cts

@@ -39,8 +39,8 @@ interface UDSCSSOptimizationOptions {
 interface UDSThemeConfig {
   /** Path to app's uds.config (relative to project root) */
   config?: string;
-  /** Entry directory for app code scanning (default: '/src/') */
-  entry?: string;
+  /** Entry directory path or .tsx file path, or a list of those paths (default: './src') */
+  entry?: string | string[];
   /** Suppress log output during generation (default: false) */
   silent?: boolean;
   /**

package/dist/tailwind/dist/css/theme.d.ts

@@ -39,8 +39,8 @@ interface UDSCSSOptimizationOptions {
 interface UDSThemeConfig {
   /** Path to app's uds.config (relative to project root) */
   config?: string;
-  /** Entry directory for app code scanning (default: '/src/') */
-  entry?: string;
+  /** Entry directory path or .tsx file path, or a list of those paths (default: './src') */
+  entry?: string | string[];
   /** Suppress log output during generation (default: false) */
   silent?: boolean;
   /**

package/dist/tailwind/dist/purger/legacy/purgeCSS.cjs

@@ -2,6 +2,7 @@
 const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
 const require_index = require('../../../../css-tokens/dist/index.cjs');
 const require_print = require('../../../../cli/dist/lib/print.cjs');
+const require_entryPoints = require('../../utils/entryPoints.cjs');
 const require_spinner = require('../../../../cli/dist/lib/spinner.cjs');
 const require_tsMorph = require('../../utils/tsMorph.cjs');
 let node_path = require("node:path");
@@ -30,13 +31,17 @@ const getFiles = async (entry) => {
 	try {
 		const workspaceDir = process.env.PWD || process.cwd();
 		if (!workspaceDir) throw new Error("Workspace directory not found.");
-		return await (0, fast_glob.default)(["**/*.jsx", "**/*.tsx"], {
-			cwd: node_path.default.join(workspaceDir, entry),
-			absolute: true,
-			ignore: ["**/node_modules/**"]
-		});
-	} catch {
-		throw new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
+		const files = await Promise.all(require_entryPoints.resolveEntryPaths(entry, workspaceDir, require_entryPoints.DEFAULT_ENTRY).map((entryPath) => {
+			if (entryPath.kind === "file") return [entryPath.absolutePath];
+			return (0, fast_glob.default)(["**/*.jsx", "**/*.tsx"], {
+				cwd: entryPath.absolutePath,
+				absolute: true,
+				ignore: ["**/node_modules/**"]
+			});
+		}));
+		return [...new Set(files.flat())];
+	} catch (error) {
+		throw error instanceof Error ? error : /* @__PURE__ */ new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
 	}
 };
 /**
@@ -219,7 +224,13 @@ const scanGetStylesReferences = (project, variants, packageJson) => {
 	}
 	return usedProps;
 };
-async function purge(variants, packageJson, generatedPurgeCssData, { config: configPath = process.env.UDS_OUT_FILE ?? "./uds.config.ts", output = "dist/safelist.ts", entry = "/src/" }) {
+const applyPurgeDefaults = (options = {}) => ({
+	config: options.config ?? process.env.UDS_OUT_FILE ?? "./uds.config.ts",
+	output: options.output ?? "dist/safelist.ts",
+	entry: options.entry ?? require_entryPoints.DEFAULT_ENTRY
+});
+async function purge(variants, packageJson, generatedPurgeCssData, options = {}) {
+	const { config: configPath, output, entry } = applyPurgeDefaults(options);
 	const workspaceDir = process.env.PWD || process.cwd();
 	if (!workspaceDir) throw new Error("Workspace directory not found.");
 	const project = new ts_morph.Project({ tsConfigFilePath: node_path.default.join(workspaceDir, "/tsconfig.json") });

package/dist/tailwind/dist/purger/legacy/purgeCSS.js

@@ -1,6 +1,7 @@
 /*! © 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 { print } from "../../../../cli/dist/lib/print.js";
+import { DEFAULT_ENTRY, resolveEntryPaths } from "../../utils/entryPoints.js";
 import { spinStart, spinStop } from "../../../../cli/dist/lib/spinner.js";
 import { findReferencesAsJsxElements, getUsedPropsInReference } from "../../utils/tsMorph.js";
 import path from "node:path";
@@ -27,13 +28,17 @@ 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,
-			ignore: ["**/node_modules/**"]
-		});
-	} catch {
-		throw new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
+		const files = await Promise.all(resolveEntryPaths(entry, workspaceDir, DEFAULT_ENTRY).map((entryPath) => {
+			if (entryPath.kind === "file") return [entryPath.absolutePath];
+			return fg(["**/*.jsx", "**/*.tsx"], {
+				cwd: entryPath.absolutePath,
+				absolute: true,
+				ignore: ["**/node_modules/**"]
+			});
+		}));
+		return [...new Set(files.flat())];
+	} catch (error) {
+		throw error instanceof Error ? error : /* @__PURE__ */ new Error(`Couldn't find the entry directory: ${entry}. Please make sure it exists.`);
 	}
 };
 /**
@@ -216,7 +221,13 @@ const scanGetStylesReferences = (project, variants, packageJson) => {
 	}
 	return usedProps;
 };
-async function purge(variants, packageJson, generatedPurgeCssData, { config: configPath = process.env.UDS_OUT_FILE ?? "./uds.config.ts", output = "dist/safelist.ts", entry = "/src/" }) {
+const applyPurgeDefaults = (options = {}) => ({
+	config: options.config ?? process.env.UDS_OUT_FILE ?? "./uds.config.ts",
+	output: options.output ?? "dist/safelist.ts",
+	entry: options.entry ?? DEFAULT_ENTRY
+});
+async function purge(variants, packageJson, generatedPurgeCssData, options = {}) {
+	const { config: configPath, output, entry } = applyPurgeDefaults(options);
 	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") });

package/dist/tailwind/dist/purger/optimized/purge.cjs

@@ -1,6 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
 const require_purgeFromCode = require('./purgeFromCode.cjs');
+const require_entryPoints = require('../../utils/entryPoints.cjs');
 const require_safelist = require('./utils/safelist.cjs');
 const require_files = require('./utils/files.cjs');
 let node_path = require("node:path");
@@ -24,7 +25,7 @@ const clearWarnings = () => {
 * between CLI and playground.
 */
 const purgeOptimized = async (options) => {
-	const { entry = "/src/", output = "dist/safelist.ts", colorModes = ["dark"], variants, autoVariants, componentData } = options;
+	const { entry = require_entryPoints.DEFAULT_ENTRY, output = "dist/safelist.ts", colorModes = ["dark"], variants, autoVariants, componentData } = options;
 	const startTime = performance.now();
 	clearWarnings();
 	const workspaceDir = process.env.PWD ?? process.cwd();

package/dist/tailwind/dist/purger/optimized/purge.js

@@ -1,5 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { purgeFromCodeOptimized } from "./purgeFromCode.js";
+import { DEFAULT_ENTRY } from "../../utils/entryPoints.js";
 import { deduplicateSafelist, getThemeAndScaleClasses, saveSafelistToFile } from "./utils/safelist.js";
 import { scanForFiles } from "./utils/files.js";
 import path from "node:path";
@@ -21,7 +22,7 @@ const clearWarnings = () => {
 * between CLI and playground.
 */
 const purgeOptimized = async (options) => {
-	const { entry = "/src/", output = "dist/safelist.ts", colorModes = ["dark"], variants, autoVariants, componentData } = options;
+	const { entry = DEFAULT_ENTRY, output = "dist/safelist.ts", colorModes = ["dark"], variants, autoVariants, componentData } = options;
 	const startTime = performance.now();
 	clearWarnings();
 	const workspaceDir = process.env.PWD ?? process.cwd();

package/dist/tailwind/dist/purger/optimized/purgeFromCode.cjs

@@ -266,12 +266,32 @@ const purgeFromCodeOptimized = async (code, options) => {
 */
 const findComponentReferences = (sourceFile, componentName) => {
 	const references = [];
+	const seenTags = /* @__PURE__ */ new Set();
+	const collectMatchingTags = (localName) => {
+		sourceFile.getDescendants().filter((node) => ts_morph.Node.isJsxOpeningElement(node) || ts_morph.Node.isJsxSelfClosingElement(node)).forEach((node) => {
+			const tagName = node.getTagNameNode().getText();
+			if (tagName === localName || tagName.startsWith(`${localName}.`)) {
+				const key = `${tagName}:${node.getStart()}`;
+				if (!seenTags.has(key)) {
+					seenTags.add(key);
+					references.push(node);
+				}
+			}
+		});
+	};
 	sourceFile.getImportDeclarations().forEach((importDecl) => {
 		if (!isUdsComponentModule(getModuleSpecifierValue(importDecl))) return;
 		importDecl.getNamedImports().forEach((namedImport) => {
 			if (namedImport.getName() === componentName) {
-				const identifier = namedImport.getFirstDescendantByKindOrThrow(ts_morph.ts.SyntaxKind.Identifier);
-				references.push(...require_jsx.findJsxReferences(identifier));
+				const localName = namedImport.getAliasNode()?.getText() ?? componentName;
+				require_jsx.findJsxReferences(namedImport.getFirstDescendantByKindOrThrow(ts_morph.ts.SyntaxKind.Identifier)).forEach((reference) => {
+					const key = `${reference.getTagNameNode().getText()}:${reference.getStart()}`;
+					if (!seenTags.has(key)) {
+						seenTags.add(key);
+						references.push(reference);
+					}
+				});
+				collectMatchingTags(localName);
 			}
 		});
 	});

package/dist/tailwind/dist/purger/optimized/purgeFromCode.js

@@ -265,12 +265,32 @@ const purgeFromCodeOptimized = async (code, options) => {
 */
 const findComponentReferences = (sourceFile, componentName) => {
 	const references = [];
+	const seenTags = /* @__PURE__ */ new Set();
+	const collectMatchingTags = (localName) => {
+		sourceFile.getDescendants().filter((node) => Node.isJsxOpeningElement(node) || Node.isJsxSelfClosingElement(node)).forEach((node) => {
+			const tagName = node.getTagNameNode().getText();
+			if (tagName === localName || tagName.startsWith(`${localName}.`)) {
+				const key = `${tagName}:${node.getStart()}`;
+				if (!seenTags.has(key)) {
+					seenTags.add(key);
+					references.push(node);
+				}
+			}
+		});
+	};
 	sourceFile.getImportDeclarations().forEach((importDecl) => {
 		if (!isUdsComponentModule(getModuleSpecifierValue(importDecl))) return;
 		importDecl.getNamedImports().forEach((namedImport) => {
 			if (namedImport.getName() === componentName) {
-				const identifier = namedImport.getFirstDescendantByKindOrThrow(ts.SyntaxKind.Identifier);
-				references.push(...findJsxReferences(identifier));
+				const localName = namedImport.getAliasNode()?.getText() ?? componentName;
+				findJsxReferences(namedImport.getFirstDescendantByKindOrThrow(ts.SyntaxKind.Identifier)).forEach((reference) => {
+					const key = `${reference.getTagNameNode().getText()}:${reference.getStart()}`;
+					if (!seenTags.has(key)) {
+						seenTags.add(key);
+						references.push(reference);
+					}
+				});
+				collectMatchingTags(localName);
 			}
 		});
 	});

package/dist/tailwind/dist/purger/optimized/utils/componentAnalyzer.cjs

@@ -1,6 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_runtime = require('../../../../../_virtual/_rolldown/runtime.cjs');
 const require_index = require('../../../../../motion-tokens/dist/index.cjs');
+const require_entryPoints = require('../../../utils/entryPoints.cjs');
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
 let node_fs = require("node:fs");
@@ -19,7 +20,7 @@ let knownComponents = null;
 */
 let componentPaths = null;
 let scannedComponentsDir = null;
-const scanComponentFilePaths = async (componentsDir) => (0, fast_glob.default)("**/*.tsx", {
+const scanComponentFilePaths = async (componentsDir) => (0, fast_glob.default)(require_entryPoints.getAllowedEntryFileGlobPatterns(), {
 	cwd: componentsDir,
 	absolute: true
 });
@@ -34,8 +35,8 @@ const scanComponentFiles = async (componentsDir) => {
 	const nextComponentPaths = componentPaths;
 	const nextKnownComponents = knownComponents;
 	(await scanComponentFilePaths(componentsDir)).forEach((file) => {
-		if (file.includes(".test.") || file.endsWith("index.tsx")) return;
-		const fileName = node_path.default.basename(file, ".tsx");
+		if (file.includes(".test.") || node_path.default.basename(require_entryPoints.stripAllowedEntryFileExtension(file)) === "index") return;
+		const fileName = node_path.default.basename(require_entryPoints.stripAllowedEntryFileExtension(file));
 		if (/^[A-Z]/.test(fileName)) {
 			nextComponentPaths.set(fileName, file);
 			nextKnownComponents.add(fileName);
@@ -110,7 +111,7 @@ const analyzeVariantSpreadAssignment = (prop, styleProps, getStylesLiterals, pro
 const analyzeComponent = (project, componentPath) => {
 	const sourceFile = project.getSourceFile(componentPath);
 	if (!sourceFile) return null;
-	const componentName = node_path.default.basename(componentPath, ".tsx");
+	const componentName = node_path.default.basename(require_entryPoints.stripAllowedEntryFileExtension(componentPath));
 	const defaultProps = /* @__PURE__ */ new Map();
 	const componentPropNames = /* @__PURE__ */ new Set();
 	const styleProps = [];