@yahoo/uds 3.104.0 → 3.105.0

package/dist/tailwind/dist/commands/purge.js

@@ -1,7 +1,9 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { trackEvent } from "../../../cli/dist/utils/analytics.js";
+import { print } from "../../../cli/dist/lib/print.js";
 import { spinStart, spinStop } from "../../../cli/dist/lib/spinner.js";
-import { purge } from "../utils/purgeCSS.js";
+import { purge } from "../purger/legacy/purgeCSS.js";
+import { purgeOptimized } from "../purger/optimized/purge.js";
 
 //#region ../tailwind/dist/commands/purge.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
@@ -9,16 +11,44 @@ const makePurgeCommand = (getContext) => ({
 	name: "purge",
 	description: `Purge unused CSS`,
 	run: async (props) => {
-		spinStart("Purging css started...");
-		try {
-			const { variants, packageJson, generatedPurgeCssData } = await getContext();
-			await purge(variants, packageJson, generatedPurgeCssData, 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;
+		const { entry, output, optimized, config } = props.options;
+		const useOptimized = optimized === "true" || optimized === true;
+		const { variants, autoVariants, packageJson, generatedPurgeCssData, componentData } = await getContext();
+		if (useOptimized) {
+			spinStart("Purging CSS with optimized purger...");
+			try {
+				const result = await purgeOptimized({
+					entry: typeof entry === "string" ? entry : void 0,
+					output: typeof output === "string" ? output : void 0,
+					variants,
+					autoVariants,
+					componentData
+				});
+				spinStop("✅", `Purging done (optimized)! Generated ${result.stats.classesGenerated} classes in ${result.stats.timeMs}ms`);
+				print(`   Files scanned: ${result.stats.filesScanned}`);
+				print(`   Spreads traced: ${result.stats.spreadsTraced}`);
+				print(`   Expressions resolved: ${result.stats.expressionsResolved}`);
+				return await trackEvent("purge", { optimized: true });
+			} 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;
+			}
+		} else {
+			spinStart("Purging css started...");
+			try {
+				await purge(variants, packageJson, generatedPurgeCssData, {
+					config: typeof config === "string" ? config : void 0,
+					entry: typeof entry === "string" ? entry : void 0,
+					output: typeof output === "string" ? output : void 0
+				});
+				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;
+			}
 		}
 	}
 });

package/dist/tailwind/dist/index.d.ts

@@ -1,5 +1,6 @@
 
 import "./tailwind/components/getResponsiveTextStyles.js";
 import { WebTokens, parseTokens } from "./utils/parseTokens.js";
+import "./commands/generateComponentData.js";
 import "./commands/generatePurgeCSSData.js";
 import "./commands/purge.js";

package/dist/tailwind/dist/{utils → purger/legacy}/purgeCSS.cjs

@@ -1,9 +1,9 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-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_spinner = require('../../../cli/dist/lib/spinner.cjs');
-const require_tsMorph = require('./tsMorph.cjs');
+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_spinner = require('../../../../cli/dist/lib/spinner.cjs');
+const require_tsMorph = require('../../utils/tsMorph.cjs');
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
 let node_fs = require("node:fs");
@@ -11,7 +11,7 @@ let ts_morph = require("ts-morph");
 let fast_glob = require("fast-glob");
 fast_glob = require_runtime.__toESM(fast_glob);
 
-//#region ../tailwind/dist/utils/purgeCSS.js
+//#region ../tailwind/dist/purger/legacy/purgeCSS.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
 const scaleModeToClass = {
 	large: require_index.LARGE_SCALE_MODE_CLASSNAME,
@@ -128,7 +128,7 @@ const isUDSComponent = (component, { componentToVariants }) => {
 };
 const saveToFile = (safeList, outputPath) => {
 	const fileContent = `
-    //! This file is generated by purgeCSS.ts from @yahoo/uds
+    //! This file is generated by \`uds purge\` 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)};

package/dist/tailwind/dist/{utils → purger/legacy}/purgeCSS.js

@@ -1,14 +1,14 @@
 /*! © 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 { spinStart, spinStop } from "../../../cli/dist/lib/spinner.js";
-import { findReferencesAsJsxElements, getUsedPropsInReference } from "./tsMorph.js";
+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 { spinStart, spinStop } from "../../../../cli/dist/lib/spinner.js";
+import { findReferencesAsJsxElements, getUsedPropsInReference } from "../../utils/tsMorph.js";
 import path from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { Node, Project, SyntaxKind, ts } from "ts-morph";
 import fg from "fast-glob";
 
-//#region ../tailwind/dist/utils/purgeCSS.js
+//#region ../tailwind/dist/purger/legacy/purgeCSS.js
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
 const scaleModeToClass = {
 	large: LARGE_SCALE_MODE_CLASSNAME,
@@ -125,7 +125,7 @@ const isUDSComponent = (component, { componentToVariants }) => {
 };
 const saveToFile = (safeList, outputPath) => {
 	const fileContent = `
-    //! This file is generated by purgeCSS.ts from @yahoo/uds
+    //! This file is generated by \`uds purge\` 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)};

package/dist/tailwind/dist/purger/optimized/ast/expressions.cjs

@@ -0,0 +1,193 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../../../_virtual/_rolldown/runtime.cjs');
+let ts_morph = require("ts-morph");
+
+//#region ../tailwind/dist/purger/optimized/ast/expressions.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Extracts string literal values from an expression.
+*
+* Handles:
+* - Direct string literals: 'value'
+* - Ternary expressions: condition ? 'a' : 'b' -> ['a', 'b']
+* - Variable references: traces back to initializer
+* - Logical expressions: a || 'fallback', a ?? 'default'
+* - Function calls: traces to return statements
+* - Template literals: `value`
+* - As expressions: value as Type
+*
+* @param node The expression node to extract values from
+* @param visited Set of visited nodes to prevent infinite recursion
+* @returns Array of extracted string literal values
+*/
+function extractStringLiterals(node, visited = /* @__PURE__ */ new Set()) {
+	if (visited.has(node)) return [];
+	visited.add(node);
+	const values = [];
+	if (ts_morph.Node.isStringLiteral(node)) {
+		values.push(node.getLiteralValue());
+		return values;
+	}
+	if (ts_morph.Node.isNoSubstitutionTemplateLiteral(node)) {
+		values.push(node.getLiteralValue());
+		return values;
+	}
+	if (ts_morph.Node.isConditionalExpression(node)) {
+		values.push(...extractStringLiterals(node.getWhenTrue(), visited));
+		values.push(...extractStringLiterals(node.getWhenFalse(), visited));
+		return values;
+	}
+	if (ts_morph.Node.isBinaryExpression(node)) {
+		const op = node.getOperatorToken().getText();
+		if (op === "||" || op === "??") {
+			values.push(...extractStringLiterals(node.getLeft(), visited));
+			values.push(...extractStringLiterals(node.getRight(), visited));
+			return values;
+		}
+	}
+	if (ts_morph.Node.isParenthesizedExpression(node)) {
+		values.push(...extractStringLiterals(node.getExpression(), visited));
+		return values;
+	}
+	if (ts_morph.Node.isAsExpression(node)) {
+		values.push(...extractStringLiterals(node.getExpression(), visited));
+		return values;
+	}
+	if (ts_morph.Node.isPropertyAccessExpression(node)) {
+		const typeValues = extractLiteralValuesFromType(node);
+		if (typeValues.length > 0) {
+			values.push(...typeValues);
+			return values;
+		}
+		const expression = node.getExpression();
+		const propertyName = node.getName();
+		const baseValues = extractObjectValues(expression, visited);
+		for (const objValue of baseValues) if (typeof objValue === "object" && objValue !== null && propertyName in objValue) {
+			const propValue = objValue[propertyName];
+			if (typeof propValue === "string") values.push(propValue);
+		}
+		return values;
+	}
+	if (ts_morph.Node.isElementAccessExpression(node)) {
+		const typeValues = extractLiteralValuesFromType(node);
+		if (typeValues.length > 0) {
+			values.push(...typeValues);
+			return values;
+		}
+		return values;
+	}
+	if (ts_morph.Node.isCallExpression(node)) {
+		const expression = node.getExpression();
+		if (ts_morph.Node.isIdentifier(expression)) for (const definition of expression.getDefinitionNodes()) {
+			if (ts_morph.Node.isFunctionDeclaration(definition)) for (const returnStmt of definition.getDescendantsOfKind(ts_morph.SyntaxKind.ReturnStatement)) {
+				const returnExpr = returnStmt.getExpression();
+				if (returnExpr) values.push(...extractStringLiterals(returnExpr, visited));
+			}
+			if (ts_morph.Node.isVariableDeclaration(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) values.push(...extractFromFunctionLike(initializer, visited));
+			}
+		}
+		return values;
+	}
+	if (ts_morph.Node.isIdentifier(node)) {
+		let foundInitializer = false;
+		for (const definition of node.getDefinitionNodes()) {
+			if (ts_morph.Node.isVariableDeclaration(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) {
+					foundInitializer = true;
+					values.push(...extractStringLiterals(initializer, visited));
+				}
+			}
+			if (ts_morph.Node.isParameterDeclaration(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) {
+					foundInitializer = true;
+					values.push(...extractStringLiterals(initializer, visited));
+				}
+			}
+			if (ts_morph.Node.isBindingElement(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) {
+					foundInitializer = true;
+					values.push(...extractStringLiterals(initializer, visited));
+				}
+			}
+		}
+		if (!foundInitializer && values.length === 0) values.push(...extractLiteralValuesFromType(node));
+		return values;
+	}
+	return values;
+}
+/**
+* Extract string literals from arrow functions or function expressions
+*/
+function extractFromFunctionLike(node, visited) {
+	const values = [];
+	if (ts_morph.Node.isArrowFunction(node)) {
+		const body = node.getBody();
+		if (ts_morph.Node.isBlock(body)) for (const returnStmt of body.getDescendantsOfKind(ts_morph.SyntaxKind.ReturnStatement)) {
+			const returnExpr = returnStmt.getExpression();
+			if (returnExpr) values.push(...extractStringLiterals(returnExpr, visited));
+		}
+		else values.push(...extractStringLiterals(body, visited));
+	} else if (ts_morph.Node.isFunctionExpression(node)) for (const returnStmt of node.getDescendantsOfKind(ts_morph.SyntaxKind.ReturnStatement)) {
+		const returnExpr = returnStmt.getExpression();
+		if (returnExpr) values.push(...extractStringLiterals(returnExpr, visited));
+	}
+	return values;
+}
+/**
+* Extract object literal values from an expression.
+* Returns an array of all possible object values (for union types or indexed access).
+*/
+function extractObjectValues(node, visited) {
+	if (visited.has(node)) return [];
+	visited.add(node);
+	const values = [];
+	if (ts_morph.Node.isObjectLiteralExpression(node)) {
+		const obj = {};
+		for (const prop of node.getProperties()) if (ts_morph.Node.isPropertyAssignment(prop)) {
+			const name = prop.getName();
+			const init = prop.getInitializer();
+			if (init && ts_morph.Node.isStringLiteral(init)) obj[name] = init.getLiteralValue();
+			else if (init && ts_morph.Node.isObjectLiteralExpression(init)) {
+				const nestedValues = extractObjectValues(init, visited);
+				if (nestedValues.length > 0) obj[name] = nestedValues[0];
+			}
+		}
+		values.push(obj);
+		return values;
+	}
+	if (ts_morph.Node.isIdentifier(node)) {
+		for (const definition of node.getDefinitionNodes()) if (ts_morph.Node.isVariableDeclaration(definition)) {
+			const initializer = definition.getInitializer();
+			if (initializer) if (ts_morph.Node.isAsExpression(initializer)) {
+				const inner = initializer.getExpression();
+				values.push(...extractObjectValues(inner, visited));
+			} else values.push(...extractObjectValues(initializer, visited));
+		}
+		return values;
+	}
+	if (ts_morph.Node.isElementAccessExpression(node)) {
+		const baseObjects = extractObjectValues(node.getExpression(), visited);
+		for (const obj of baseObjects) if (typeof obj === "object" && obj !== null) for (const value of Object.values(obj)) values.push(value);
+		return values;
+	}
+	return values;
+}
+/**
+* Extract literal values from a TypeScript type (for union types like 'brand' | 'secondary')
+*/
+function extractLiteralValuesFromType(node) {
+	const values = [];
+	const nodeType = node.getType();
+	if (nodeType.isUnion()) {
+		for (const unionMember of nodeType.getUnionTypes()) if (unionMember.isStringLiteral()) values.push(unionMember.getLiteralValue());
+	} else if (nodeType.isStringLiteral()) values.push(nodeType.getLiteralValue());
+	return values;
+}
+
+//#endregion
+exports.extractStringLiterals = extractStringLiterals;

package/dist/tailwind/dist/purger/optimized/ast/expressions.js

@@ -0,0 +1,192 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { Node, SyntaxKind } from "ts-morph";
+
+//#region ../tailwind/dist/purger/optimized/ast/expressions.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Extracts string literal values from an expression.
+*
+* Handles:
+* - Direct string literals: 'value'
+* - Ternary expressions: condition ? 'a' : 'b' -> ['a', 'b']
+* - Variable references: traces back to initializer
+* - Logical expressions: a || 'fallback', a ?? 'default'
+* - Function calls: traces to return statements
+* - Template literals: `value`
+* - As expressions: value as Type
+*
+* @param node The expression node to extract values from
+* @param visited Set of visited nodes to prevent infinite recursion
+* @returns Array of extracted string literal values
+*/
+function extractStringLiterals(node, visited = /* @__PURE__ */ new Set()) {
+	if (visited.has(node)) return [];
+	visited.add(node);
+	const values = [];
+	if (Node.isStringLiteral(node)) {
+		values.push(node.getLiteralValue());
+		return values;
+	}
+	if (Node.isNoSubstitutionTemplateLiteral(node)) {
+		values.push(node.getLiteralValue());
+		return values;
+	}
+	if (Node.isConditionalExpression(node)) {
+		values.push(...extractStringLiterals(node.getWhenTrue(), visited));
+		values.push(...extractStringLiterals(node.getWhenFalse(), visited));
+		return values;
+	}
+	if (Node.isBinaryExpression(node)) {
+		const op = node.getOperatorToken().getText();
+		if (op === "||" || op === "??") {
+			values.push(...extractStringLiterals(node.getLeft(), visited));
+			values.push(...extractStringLiterals(node.getRight(), visited));
+			return values;
+		}
+	}
+	if (Node.isParenthesizedExpression(node)) {
+		values.push(...extractStringLiterals(node.getExpression(), visited));
+		return values;
+	}
+	if (Node.isAsExpression(node)) {
+		values.push(...extractStringLiterals(node.getExpression(), visited));
+		return values;
+	}
+	if (Node.isPropertyAccessExpression(node)) {
+		const typeValues = extractLiteralValuesFromType(node);
+		if (typeValues.length > 0) {
+			values.push(...typeValues);
+			return values;
+		}
+		const expression = node.getExpression();
+		const propertyName = node.getName();
+		const baseValues = extractObjectValues(expression, visited);
+		for (const objValue of baseValues) if (typeof objValue === "object" && objValue !== null && propertyName in objValue) {
+			const propValue = objValue[propertyName];
+			if (typeof propValue === "string") values.push(propValue);
+		}
+		return values;
+	}
+	if (Node.isElementAccessExpression(node)) {
+		const typeValues = extractLiteralValuesFromType(node);
+		if (typeValues.length > 0) {
+			values.push(...typeValues);
+			return values;
+		}
+		return values;
+	}
+	if (Node.isCallExpression(node)) {
+		const expression = node.getExpression();
+		if (Node.isIdentifier(expression)) for (const definition of expression.getDefinitionNodes()) {
+			if (Node.isFunctionDeclaration(definition)) for (const returnStmt of definition.getDescendantsOfKind(SyntaxKind.ReturnStatement)) {
+				const returnExpr = returnStmt.getExpression();
+				if (returnExpr) values.push(...extractStringLiterals(returnExpr, visited));
+			}
+			if (Node.isVariableDeclaration(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) values.push(...extractFromFunctionLike(initializer, visited));
+			}
+		}
+		return values;
+	}
+	if (Node.isIdentifier(node)) {
+		let foundInitializer = false;
+		for (const definition of node.getDefinitionNodes()) {
+			if (Node.isVariableDeclaration(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) {
+					foundInitializer = true;
+					values.push(...extractStringLiterals(initializer, visited));
+				}
+			}
+			if (Node.isParameterDeclaration(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) {
+					foundInitializer = true;
+					values.push(...extractStringLiterals(initializer, visited));
+				}
+			}
+			if (Node.isBindingElement(definition)) {
+				const initializer = definition.getInitializer();
+				if (initializer) {
+					foundInitializer = true;
+					values.push(...extractStringLiterals(initializer, visited));
+				}
+			}
+		}
+		if (!foundInitializer && values.length === 0) values.push(...extractLiteralValuesFromType(node));
+		return values;
+	}
+	return values;
+}
+/**
+* Extract string literals from arrow functions or function expressions
+*/
+function extractFromFunctionLike(node, visited) {
+	const values = [];
+	if (Node.isArrowFunction(node)) {
+		const body = node.getBody();
+		if (Node.isBlock(body)) for (const returnStmt of body.getDescendantsOfKind(SyntaxKind.ReturnStatement)) {
+			const returnExpr = returnStmt.getExpression();
+			if (returnExpr) values.push(...extractStringLiterals(returnExpr, visited));
+		}
+		else values.push(...extractStringLiterals(body, visited));
+	} else if (Node.isFunctionExpression(node)) for (const returnStmt of node.getDescendantsOfKind(SyntaxKind.ReturnStatement)) {
+		const returnExpr = returnStmt.getExpression();
+		if (returnExpr) values.push(...extractStringLiterals(returnExpr, visited));
+	}
+	return values;
+}
+/**
+* Extract object literal values from an expression.
+* Returns an array of all possible object values (for union types or indexed access).
+*/
+function extractObjectValues(node, visited) {
+	if (visited.has(node)) return [];
+	visited.add(node);
+	const values = [];
+	if (Node.isObjectLiteralExpression(node)) {
+		const obj = {};
+		for (const prop of node.getProperties()) if (Node.isPropertyAssignment(prop)) {
+			const name = prop.getName();
+			const init = prop.getInitializer();
+			if (init && Node.isStringLiteral(init)) obj[name] = init.getLiteralValue();
+			else if (init && Node.isObjectLiteralExpression(init)) {
+				const nestedValues = extractObjectValues(init, visited);
+				if (nestedValues.length > 0) obj[name] = nestedValues[0];
+			}
+		}
+		values.push(obj);
+		return values;
+	}
+	if (Node.isIdentifier(node)) {
+		for (const definition of node.getDefinitionNodes()) if (Node.isVariableDeclaration(definition)) {
+			const initializer = definition.getInitializer();
+			if (initializer) if (Node.isAsExpression(initializer)) {
+				const inner = initializer.getExpression();
+				values.push(...extractObjectValues(inner, visited));
+			} else values.push(...extractObjectValues(initializer, visited));
+		}
+		return values;
+	}
+	if (Node.isElementAccessExpression(node)) {
+		const baseObjects = extractObjectValues(node.getExpression(), visited);
+		for (const obj of baseObjects) if (typeof obj === "object" && obj !== null) for (const value of Object.values(obj)) values.push(value);
+		return values;
+	}
+	return values;
+}
+/**
+* Extract literal values from a TypeScript type (for union types like 'brand' | 'secondary')
+*/
+function extractLiteralValuesFromType(node) {
+	const values = [];
+	const nodeType = node.getType();
+	if (nodeType.isUnion()) {
+		for (const unionMember of nodeType.getUnionTypes()) if (unionMember.isStringLiteral()) values.push(unionMember.getLiteralValue());
+	} else if (nodeType.isStringLiteral()) values.push(nodeType.getLiteralValue());
+	return values;
+}
+
+//#endregion
+export { extractStringLiterals };

package/dist/tailwind/dist/purger/optimized/ast/jsx.cjs

@@ -0,0 +1,20 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../../../_virtual/_rolldown/runtime.cjs');
+let ts_morph = require("ts-morph");
+
+//#region ../tailwind/dist/purger/optimized/ast/jsx.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Find all JSX usages of a component from its identifier
+*/
+function findJsxReferences(identifier) {
+	const elements = [];
+	for (const reference of identifier.findReferencesAsNodes()) {
+		const node = reference.getFirstAncestor((n) => ts_morph.Node.isJsxOpeningElement(n) || ts_morph.Node.isJsxSelfClosingElement(n));
+		if (node && (ts_morph.Node.isJsxOpeningElement(node) || ts_morph.Node.isJsxSelfClosingElement(node))) elements.push(node);
+	}
+	return elements;
+}
+
+//#endregion
+exports.findJsxReferences = findJsxReferences;

package/dist/tailwind/dist/purger/optimized/ast/jsx.js

@@ -0,0 +1,19 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { Node, SyntaxKind } from "ts-morph";
+
+//#region ../tailwind/dist/purger/optimized/ast/jsx.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+/**
+* Find all JSX usages of a component from its identifier
+*/
+function findJsxReferences(identifier) {
+	const elements = [];
+	for (const reference of identifier.findReferencesAsNodes()) {
+		const node = reference.getFirstAncestor((n) => Node.isJsxOpeningElement(n) || Node.isJsxSelfClosingElement(n));
+		if (node && (Node.isJsxOpeningElement(node) || Node.isJsxSelfClosingElement(node))) elements.push(node);
+	}
+	return elements;
+}
+
+//#endregion
+export { findJsxReferences };

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

@@ -0,0 +1,69 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_purgeFromCode = require('./purgeFromCode.cjs');
+const require_files = require('./utils/files.cjs');
+const require_safelist = require('./utils/safelist.cjs');
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+
+//#region ../tailwind/dist/purger/optimized/purge.js
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+const warnedLocations = /* @__PURE__ */ new Set();
+/**
+* Clear warned locations (call at start of new purge run)
+*/
+function clearWarnings() {
+	warnedLocations.clear();
+}
+/**
+* Main purge function - optimized version
+*
+* Uses purgeFromCodeOptimized internally to ensure consistent behavior
+* between CLI and playground.
+*/
+async function purgeOptimized(options) {
+	const { entry = "/src/", output = "dist/safelist.ts", colorModes = ["dark"], variants, autoVariants, componentData } = options;
+	const startTime = performance.now();
+	clearWarnings();
+	const workspaceDir = process.env.PWD ?? process.cwd();
+	const files = await require_files.scanForFiles(entry);
+	const allClasses = [];
+	const allImports = /* @__PURE__ */ new Set();
+	const allComponents = /* @__PURE__ */ new Set();
+	const stats = {
+		filesScanned: files.length,
+		timeMs: 0,
+		classesGenerated: 0,
+		spreadsTraced: 0,
+		expressionsResolved: 0
+	};
+	for (const filePath of files) {
+		const result = await require_purgeFromCode.purgeFromCodeOptimized(node_fs.default.readFileSync(filePath, "utf-8"), {
+			colorModes,
+			variants,
+			autoVariants,
+			componentData
+		});
+		allClasses.push(...result.safelist);
+		result.imports.forEach((imp) => allImports.add(imp));
+		result.components.forEach((comp) => allComponents.add(comp));
+		stats.spreadsTraced += result.stats.spreadsTraced;
+		stats.expressionsResolved += result.stats.expressionsResolved;
+	}
+	allClasses.push(...require_safelist.getThemeAndScaleClasses(colorModes));
+	const finalSafelist = require_safelist.deduplicateSafelist(allClasses);
+	await require_safelist.saveSafelistToFile(finalSafelist, node_path.default.join(workspaceDir, output));
+	stats.timeMs = Math.round(performance.now() - startTime);
+	stats.classesGenerated = finalSafelist.length;
+	return {
+		safelist: finalSafelist,
+		imports: [...allImports],
+		components: [...allComponents],
+		stats
+	};
+}
+
+//#endregion
+exports.purgeOptimized = purgeOptimized;