@yahoo/uds 3.161.0 → 3.162.1

package/dist/css/dist/css/workerPool.js

@@ -59,7 +59,8 @@ const createWorkerPool = async (config, numWorkers) => {
 				colorModes: options.colorModes,
 				variantDefaults: options.variantDefaults,
 				runtimeConfigValues: options.runtimeConfigValues,
-				includeAllClassNamePrimitives: options.includeAllClassNamePrimitives
+				includeAllClassNamePrimitives: options.includeAllClassNamePrimitives,
+				deferWrapperSpreadResolution: options.deferWrapperSpreadResolution
 			};
 			const task = {
 				resolve,

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

@@ -223,30 +223,114 @@ const extractCallExpressionValues = (node, visited) => {
 	const fromArguments = node.getArguments().flatMap((arg) => extractStringLiterals(arg, visited));
 	return [...fromDefinitions, ...fromArguments];
 };
+/** Array methods that return (a subset of) the receiver's elements. */
+const ARRAY_CHAIN_METHODS = new Set([
+	"concat",
+	"filter",
+	"flat",
+	"reverse",
+	"slice",
+	"sort",
+	"toReversed",
+	"toSorted"
+]);
+/**
+* If the definition is the first parameter of a `.map()`/`.flatMap()` callback,
+* return the expression being mapped over (the array source).
+*/
+const getMappedArraySource = (definition) => {
+	if (!ts_morph.Node.isParameterDeclaration(definition)) return null;
+	const callback = definition.getParentIfKind(ts_morph.SyntaxKind.ArrowFunction);
+	if (!callback) return null;
+	const callExpression = callback.getParentIfKind(ts_morph.SyntaxKind.CallExpression);
+	if (!callExpression) return null;
+	const expression = callExpression.getExpression();
+	if (!ts_morph.Node.isPropertyAccessExpression(expression)) return null;
+	if (!["map", "flatMap"].includes(expression.getName())) return null;
+	if (callback.getParameters().findIndex((parameter) => {
+		return parameter.getNameNode().getText() === definition.getNameNode().getText();
+	}) !== 0) return null;
+	return expression.getExpression();
+};
+/**
+* Resolve a node to the object-literal AST nodes it may evaluate to.
+* Handles arrays of objects (each element is a candidate), element access,
+* array-method chains, and `.map()` callback parameters (UDS-2557 follow-up:
+* variant arrays nested inside const structures).
+*/
+const resolveObjectLiteralNodes = (node, visited) => {
+	if (visited.has(node)) return [];
+	visited.add(node);
+	if (ts_morph.Node.isObjectLiteralExpression(node)) return [node];
+	if (ts_morph.Node.isParenthesizedExpression(node) || ts_morph.Node.isAsExpression(node) || ts_morph.Node.isTypeAssertion(node) || ts_morph.Node.isSatisfiesExpression(node)) return resolveObjectLiteralNodes(node.getExpression(), visited);
+	if (ts_morph.Node.isArrayLiteralExpression(node)) return node.getElements().flatMap((element) => resolveObjectLiteralNodes(element, visited));
+	if (ts_morph.Node.isElementAccessExpression(node)) return resolveObjectLiteralNodes(node.getExpression(), visited);
+	if (ts_morph.Node.isCallExpression(node)) {
+		const expression = node.getExpression();
+		if (ts_morph.Node.isPropertyAccessExpression(expression) && ARRAY_CHAIN_METHODS.has(expression.getName())) return resolveObjectLiteralNodes(expression.getExpression(), visited);
+		return [];
+	}
+	if (ts_morph.Node.isIdentifier(node)) return getLocalDefinitionNodes(node).flatMap((definition) => {
+		if (ts_morph.Node.isVariableDeclaration(definition)) {
+			const initializer = definition.getInitializer();
+			return initializer ? resolveObjectLiteralNodes(initializer, visited) : [];
+		}
+		const mappedSource = getMappedArraySource(definition);
+		if (mappedSource) return resolveObjectLiteralNodes(mappedSource, visited);
+		return [];
+	});
+	return [];
+};
+/**
+* Collect the initializers of a named property across object-literal candidates.
+*/
+const getPropertyInitializers = (objectLiterals, propertyName) => objectLiterals.flatMap((obj) => {
+	if (!ts_morph.Node.isObjectLiteralExpression(obj)) return [];
+	return obj.getProperties().flatMap((prop) => {
+		if (!ts_morph.Node.isPropertyAssignment(prop) || prop.getName() !== propertyName) return [];
+		const initializer = prop.getInitializer();
+		return initializer ? [initializer] : [];
+	});
+});
+/**
+* For a destructured binding (e.g. `({ variants }) =>` map param or
+* `const { variants } = GROUPS[0]`), resolve the bound property's initializers.
+*/
+const getBindingElementSources = (definition) => {
+	if (!ts_morph.Node.isBindingElement(definition)) return [];
+	const bindingPattern = definition.getParent();
+	if (!ts_morph.Node.isObjectBindingPattern(bindingPattern)) return [];
+	const propertyName = definition.getPropertyNameNode()?.getText() ?? definition.getName();
+	const holder = bindingPattern.getParent();
+	let source = null;
+	if (ts_morph.Node.isParameterDeclaration(holder)) source = getMappedArraySource(holder);
+	else if (ts_morph.Node.isVariableDeclaration(holder)) source = holder.getInitializer() ?? null;
+	if (!source) return [];
+	return getPropertyInitializers(resolveObjectLiteralNodes(source, /* @__PURE__ */ new Set()), propertyName);
+};
 const extractArrayElementValues = (node, visited) => {
 	if (ts_morph.Node.isArrayLiteralExpression(node)) return node.getElements().flatMap((element) => extractStringLiterals(element, visited)).filter((value, index, values) => values.indexOf(value) === index);
 	if (ts_morph.Node.isParenthesizedExpression(node)) return extractArrayElementValues(node.getExpression(), visited);
 	if (ts_morph.Node.isAsExpression(node) || ts_morph.Node.isTypeAssertion(node) || ts_morph.Node.isSatisfiesExpression(node)) return extractArrayElementValues(node.getExpression(), visited);
+	if (ts_morph.Node.isPropertyAccessExpression(node)) return getPropertyInitializers(resolveObjectLiteralNodes(node.getExpression(), /* @__PURE__ */ new Set()), node.getName()).flatMap((initializer) => extractArrayElementValues(initializer, visited)).filter((value, index, values) => values.indexOf(value) === index);
+	if (ts_morph.Node.isCallExpression(node)) {
+		const expression = node.getExpression();
+		if (ts_morph.Node.isPropertyAccessExpression(expression) && ARRAY_CHAIN_METHODS.has(expression.getName())) return extractArrayElementValues(expression.getExpression(), visited);
+		return [];
+	}
 	if (ts_morph.Node.isIdentifier(node)) return getLocalDefinitionNodes(node).flatMap((definition) => {
 		if (ts_morph.Node.isVariableDeclaration(definition)) {
 			const initializer = definition.getInitializer();
 			return initializer ? extractArrayElementValues(initializer, visited) : [];
 		}
-		return [];
+		return getBindingElementSources(definition).flatMap((source) => extractArrayElementValues(source, visited));
 	}).filter((value, index, values) => values.indexOf(value) === index);
 	return [];
 };
 const extractMappedParameterValues = (definition, visited) => {
-	if (!ts_morph.Node.isParameterDeclaration(definition)) return [];
-	const callback = definition.getParentIfKind(ts_morph.SyntaxKind.ArrowFunction);
-	if (!callback) return [];
-	const callExpression = callback.getParentIfKind(ts_morph.SyntaxKind.CallExpression);
-	if (!callExpression) return [];
-	const expression = callExpression.getExpression();
-	if (!ts_morph.Node.isPropertyAccessExpression(expression)) return [];
-	if (!["map", "flatMap"].includes(expression.getName())) return [];
-	if (callback.getParameters().findIndex((parameter) => parameter.getNameNode().getText() === definition.getNameNode().getText()) !== 0) return [];
-	return extractArrayElementValues(expression.getExpression(), visited);
+	const mappedSource = getMappedArraySource(definition);
+	if (!mappedSource) return [];
+	return extractArrayElementValues(mappedSource, visited);
 };
 const extractIdentifierValues = (node, visited) => {
 	if (!ts_morph.Node.isIdentifier(node)) return null;
@@ -331,6 +415,15 @@ const extractObjectValues = (node, visited) => {
 				} else values.push(...extractObjectValues(initializer, visited));
 			}
 		});
+		const enumDecl = node.getSourceFile().getEnum(node.getText());
+		if (enumDecl) {
+			const obj = {};
+			enumDecl.getMembers().forEach((member) => {
+				const initializer = member.getInitializer();
+				if (initializer && ts_morph.Node.isStringLiteral(initializer)) obj[member.getName()] = initializer.getLiteralValue();
+			});
+			if (Object.keys(obj).length > 0) values.push(obj);
+		}
 		return values;
 	}
 	if (ts_morph.Node.isCallExpression(node)) {

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

@@ -220,30 +220,114 @@ const extractCallExpressionValues = (node, visited) => {
 	const fromArguments = node.getArguments().flatMap((arg) => extractStringLiterals(arg, visited));
 	return [...fromDefinitions, ...fromArguments];
 };
+/** Array methods that return (a subset of) the receiver's elements. */
+const ARRAY_CHAIN_METHODS = new Set([
+	"concat",
+	"filter",
+	"flat",
+	"reverse",
+	"slice",
+	"sort",
+	"toReversed",
+	"toSorted"
+]);
+/**
+* If the definition is the first parameter of a `.map()`/`.flatMap()` callback,
+* return the expression being mapped over (the array source).
+*/
+const getMappedArraySource = (definition) => {
+	if (!Node.isParameterDeclaration(definition)) return null;
+	const callback = definition.getParentIfKind(SyntaxKind.ArrowFunction);
+	if (!callback) return null;
+	const callExpression = callback.getParentIfKind(SyntaxKind.CallExpression);
+	if (!callExpression) return null;
+	const expression = callExpression.getExpression();
+	if (!Node.isPropertyAccessExpression(expression)) return null;
+	if (!["map", "flatMap"].includes(expression.getName())) return null;
+	if (callback.getParameters().findIndex((parameter) => {
+		return parameter.getNameNode().getText() === definition.getNameNode().getText();
+	}) !== 0) return null;
+	return expression.getExpression();
+};
+/**
+* Resolve a node to the object-literal AST nodes it may evaluate to.
+* Handles arrays of objects (each element is a candidate), element access,
+* array-method chains, and `.map()` callback parameters (UDS-2557 follow-up:
+* variant arrays nested inside const structures).
+*/
+const resolveObjectLiteralNodes = (node, visited) => {
+	if (visited.has(node)) return [];
+	visited.add(node);
+	if (Node.isObjectLiteralExpression(node)) return [node];
+	if (Node.isParenthesizedExpression(node) || Node.isAsExpression(node) || Node.isTypeAssertion(node) || Node.isSatisfiesExpression(node)) return resolveObjectLiteralNodes(node.getExpression(), visited);
+	if (Node.isArrayLiteralExpression(node)) return node.getElements().flatMap((element) => resolveObjectLiteralNodes(element, visited));
+	if (Node.isElementAccessExpression(node)) return resolveObjectLiteralNodes(node.getExpression(), visited);
+	if (Node.isCallExpression(node)) {
+		const expression = node.getExpression();
+		if (Node.isPropertyAccessExpression(expression) && ARRAY_CHAIN_METHODS.has(expression.getName())) return resolveObjectLiteralNodes(expression.getExpression(), visited);
+		return [];
+	}
+	if (Node.isIdentifier(node)) return getLocalDefinitionNodes(node).flatMap((definition) => {
+		if (Node.isVariableDeclaration(definition)) {
+			const initializer = definition.getInitializer();
+			return initializer ? resolveObjectLiteralNodes(initializer, visited) : [];
+		}
+		const mappedSource = getMappedArraySource(definition);
+		if (mappedSource) return resolveObjectLiteralNodes(mappedSource, visited);
+		return [];
+	});
+	return [];
+};
+/**
+* Collect the initializers of a named property across object-literal candidates.
+*/
+const getPropertyInitializers = (objectLiterals, propertyName) => objectLiterals.flatMap((obj) => {
+	if (!Node.isObjectLiteralExpression(obj)) return [];
+	return obj.getProperties().flatMap((prop) => {
+		if (!Node.isPropertyAssignment(prop) || prop.getName() !== propertyName) return [];
+		const initializer = prop.getInitializer();
+		return initializer ? [initializer] : [];
+	});
+});
+/**
+* For a destructured binding (e.g. `({ variants }) =>` map param or
+* `const { variants } = GROUPS[0]`), resolve the bound property's initializers.
+*/
+const getBindingElementSources = (definition) => {
+	if (!Node.isBindingElement(definition)) return [];
+	const bindingPattern = definition.getParent();
+	if (!Node.isObjectBindingPattern(bindingPattern)) return [];
+	const propertyName = definition.getPropertyNameNode()?.getText() ?? definition.getName();
+	const holder = bindingPattern.getParent();
+	let source = null;
+	if (Node.isParameterDeclaration(holder)) source = getMappedArraySource(holder);
+	else if (Node.isVariableDeclaration(holder)) source = holder.getInitializer() ?? null;
+	if (!source) return [];
+	return getPropertyInitializers(resolveObjectLiteralNodes(source, /* @__PURE__ */ new Set()), propertyName);
+};
 const extractArrayElementValues = (node, visited) => {
 	if (Node.isArrayLiteralExpression(node)) return node.getElements().flatMap((element) => extractStringLiterals(element, visited)).filter((value, index, values) => values.indexOf(value) === index);
 	if (Node.isParenthesizedExpression(node)) return extractArrayElementValues(node.getExpression(), visited);
 	if (Node.isAsExpression(node) || Node.isTypeAssertion(node) || Node.isSatisfiesExpression(node)) return extractArrayElementValues(node.getExpression(), visited);
+	if (Node.isPropertyAccessExpression(node)) return getPropertyInitializers(resolveObjectLiteralNodes(node.getExpression(), /* @__PURE__ */ new Set()), node.getName()).flatMap((initializer) => extractArrayElementValues(initializer, visited)).filter((value, index, values) => values.indexOf(value) === index);
+	if (Node.isCallExpression(node)) {
+		const expression = node.getExpression();
+		if (Node.isPropertyAccessExpression(expression) && ARRAY_CHAIN_METHODS.has(expression.getName())) return extractArrayElementValues(expression.getExpression(), visited);
+		return [];
+	}
 	if (Node.isIdentifier(node)) return getLocalDefinitionNodes(node).flatMap((definition) => {
 		if (Node.isVariableDeclaration(definition)) {
 			const initializer = definition.getInitializer();
 			return initializer ? extractArrayElementValues(initializer, visited) : [];
 		}
-		return [];
+		return getBindingElementSources(definition).flatMap((source) => extractArrayElementValues(source, visited));
 	}).filter((value, index, values) => values.indexOf(value) === index);
 	return [];
 };
 const extractMappedParameterValues = (definition, visited) => {
-	if (!Node.isParameterDeclaration(definition)) return [];
-	const callback = definition.getParentIfKind(SyntaxKind.ArrowFunction);
-	if (!callback) return [];
-	const callExpression = callback.getParentIfKind(SyntaxKind.CallExpression);
-	if (!callExpression) return [];
-	const expression = callExpression.getExpression();
-	if (!Node.isPropertyAccessExpression(expression)) return [];
-	if (!["map", "flatMap"].includes(expression.getName())) return [];
-	if (callback.getParameters().findIndex((parameter) => parameter.getNameNode().getText() === definition.getNameNode().getText()) !== 0) return [];
-	return extractArrayElementValues(expression.getExpression(), visited);
+	const mappedSource = getMappedArraySource(definition);
+	if (!mappedSource) return [];
+	return extractArrayElementValues(mappedSource, visited);
 };
 const extractIdentifierValues = (node, visited) => {
 	if (!Node.isIdentifier(node)) return null;
@@ -328,6 +412,15 @@ const extractObjectValues = (node, visited) => {
 				} else values.push(...extractObjectValues(initializer, visited));
 			}
 		});
+		const enumDecl = node.getSourceFile().getEnum(node.getText());
+		if (enumDecl) {
+			const obj = {};
+			enumDecl.getMembers().forEach((member) => {
+				const initializer = member.getInitializer();
+				if (initializer && Node.isStringLiteral(initializer)) obj[member.getName()] = initializer.getLiteralValue();
+			});
+			if (Object.keys(obj).length > 0) values.push(obj);
+		}
 		return values;
 	}
 	if (Node.isCallExpression(node)) {

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

@@ -0,0 +1,74 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+require("../../../../../_virtual/_rolldown/runtime.cjs");
+let ts_morph = require("ts-morph");
+//#region ../css/dist/purger/optimized/ast/jsx.mjs
+/*! © 2026 Yahoo, Inc. UDS CSS v0.0.0-development */
+/**
+* Check if an expression is using React.forwardRef
+*/
+const isForwardRefExpression = (node) => {
+	if (!ts_morph.Node.isCallExpression(node)) return false;
+	const expression = node.getExpression();
+	if (ts_morph.Node.isIdentifier(expression) && expression.getText() === "forwardRef") return true;
+	if (ts_morph.Node.isPropertyAccessExpression(expression) && expression.getText() === "React.forwardRef") return true;
+	return false;
+};
+/**
+* Check if a node is a JSX component (PascalCase name)
+*/
+const isJsxComponent = (node) => {
+	let name;
+	if (ts_morph.Node.isVariableDeclaration(node) || ts_morph.Node.isFunctionDeclaration(node) || ts_morph.Node.isClassDeclaration(node)) name = node.getName();
+	else if (ts_morph.Node.isFunctionExpression(node) || ts_morph.Node.isArrowFunction(node)) name = node.getFirstAncestorByKind(ts_morph.SyntaxKind.VariableDeclaration)?.getName();
+	return name ? /^[A-Z]/.test(name) : false;
+};
+/**
+* Get the function declaration from a component, unwrapping forwardRef if needed
+*/
+const getReactFunctionDeclaration = (declaration) => {
+	if (!isJsxComponent(declaration)) return null;
+	if (ts_morph.Node.isFunctionDeclaration(declaration)) return declaration;
+	if (ts_morph.Node.isVariableDeclaration(declaration)) {
+		const initializer = declaration.getInitializer();
+		if (!initializer) return null;
+		if (isForwardRefExpression(initializer)) {
+			const [arg] = initializer.getArguments();
+			if (ts_morph.Node.isFunctionDeclaration(arg) || ts_morph.Node.isFunctionExpression(arg) || ts_morph.Node.isArrowFunction(arg)) return arg;
+		} else if (ts_morph.Node.isFunctionDeclaration(initializer) || ts_morph.Node.isFunctionExpression(initializer) || ts_morph.Node.isArrowFunction(initializer)) return initializer;
+	}
+	return null;
+};
+/**
+* Get the parent component that contains a JSX reference.
+* Returns information about the component including spread rest identifier.
+*/
+const getParentComponentInfo = (reference) => {
+	const block = reference.getParentWhile((parent) => !getReactFunctionDeclaration(parent));
+	if (!block) return;
+	const blockParent = block.getParent();
+	if (!blockParent) return;
+	const reactComponent = getReactFunctionDeclaration(blockParent);
+	if (!reactComponent) return;
+	let componentName;
+	const variableDeclaration = reactComponent.getFirstAncestorByKind(ts_morph.SyntaxKind.VariableDeclaration);
+	if (variableDeclaration) componentName = variableDeclaration.getName();
+	else if (ts_morph.Node.isFunctionDeclaration(reactComponent)) componentName = reactComponent.getName();
+	if (!componentName) return;
+	let spreadRestIdentifier;
+	let paramIdentifier;
+	reactComponent.getParameters().forEach((parameter) => {
+		const objectBindingPattern = parameter.getChildrenOfKind(ts_morph.SyntaxKind.ObjectBindingPattern)[0];
+		const identifier = parameter.getChildrenOfKind(ts_morph.SyntaxKind.Identifier)[0];
+		if (objectBindingPattern) {
+			const dotDotToken = objectBindingPattern.getFirstDescendantByKind(ts_morph.SyntaxKind.DotDotDotToken);
+			if (dotDotToken) spreadRestIdentifier = dotDotToken.getParent()?.getFirstChildByKindOrThrow(ts_morph.SyntaxKind.Identifier).getText();
+		} else if (identifier) paramIdentifier = identifier.getText();
+	});
+	return {
+		componentName,
+		spreadRestIdentifier,
+		paramIdentifier
+	};
+};
+//#endregion
+exports.getParentComponentInfo = getParentComponentInfo;

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

@@ -0,0 +1,73 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { Node, SyntaxKind } from "ts-morph";
+//#region ../css/dist/purger/optimized/ast/jsx.mjs
+/*! © 2026 Yahoo, Inc. UDS CSS v0.0.0-development */
+/**
+* Check if an expression is using React.forwardRef
+*/
+const isForwardRefExpression = (node) => {
+	if (!Node.isCallExpression(node)) return false;
+	const expression = node.getExpression();
+	if (Node.isIdentifier(expression) && expression.getText() === "forwardRef") return true;
+	if (Node.isPropertyAccessExpression(expression) && expression.getText() === "React.forwardRef") return true;
+	return false;
+};
+/**
+* Check if a node is a JSX component (PascalCase name)
+*/
+const isJsxComponent = (node) => {
+	let name;
+	if (Node.isVariableDeclaration(node) || Node.isFunctionDeclaration(node) || Node.isClassDeclaration(node)) name = node.getName();
+	else if (Node.isFunctionExpression(node) || Node.isArrowFunction(node)) name = node.getFirstAncestorByKind(SyntaxKind.VariableDeclaration)?.getName();
+	return name ? /^[A-Z]/.test(name) : false;
+};
+/**
+* Get the function declaration from a component, unwrapping forwardRef if needed
+*/
+const getReactFunctionDeclaration = (declaration) => {
+	if (!isJsxComponent(declaration)) return null;
+	if (Node.isFunctionDeclaration(declaration)) return declaration;
+	if (Node.isVariableDeclaration(declaration)) {
+		const initializer = declaration.getInitializer();
+		if (!initializer) return null;
+		if (isForwardRefExpression(initializer)) {
+			const [arg] = initializer.getArguments();
+			if (Node.isFunctionDeclaration(arg) || Node.isFunctionExpression(arg) || Node.isArrowFunction(arg)) return arg;
+		} else if (Node.isFunctionDeclaration(initializer) || Node.isFunctionExpression(initializer) || Node.isArrowFunction(initializer)) return initializer;
+	}
+	return null;
+};
+/**
+* Get the parent component that contains a JSX reference.
+* Returns information about the component including spread rest identifier.
+*/
+const getParentComponentInfo = (reference) => {
+	const block = reference.getParentWhile((parent) => !getReactFunctionDeclaration(parent));
+	if (!block) return;
+	const blockParent = block.getParent();
+	if (!blockParent) return;
+	const reactComponent = getReactFunctionDeclaration(blockParent);
+	if (!reactComponent) return;
+	let componentName;
+	const variableDeclaration = reactComponent.getFirstAncestorByKind(SyntaxKind.VariableDeclaration);
+	if (variableDeclaration) componentName = variableDeclaration.getName();
+	else if (Node.isFunctionDeclaration(reactComponent)) componentName = reactComponent.getName();
+	if (!componentName) return;
+	let spreadRestIdentifier;
+	let paramIdentifier;
+	reactComponent.getParameters().forEach((parameter) => {
+		const objectBindingPattern = parameter.getChildrenOfKind(SyntaxKind.ObjectBindingPattern)[0];
+		const identifier = parameter.getChildrenOfKind(SyntaxKind.Identifier)[0];
+		if (objectBindingPattern) {
+			const dotDotToken = objectBindingPattern.getFirstDescendantByKind(SyntaxKind.DotDotDotToken);
+			if (dotDotToken) spreadRestIdentifier = dotDotToken.getParent()?.getFirstChildByKindOrThrow(SyntaxKind.Identifier).getText();
+		} else if (identifier) paramIdentifier = identifier.getText();
+	});
+	return {
+		componentName,
+		spreadRestIdentifier,
+		paramIdentifier
+	};
+};
+//#endregion
+export { getParentComponentInfo };

package/dist/css/dist/purger/optimized/ast/props.cjs

@@ -0,0 +1,47 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+require("../../../../../_virtual/_rolldown/runtime.cjs");
+const require_expressions = require("./expressions.cjs");
+let ts_morph = require("ts-morph");
+//#region ../css/dist/purger/optimized/ast/props.mjs
+/*! © 2026 Yahoo, Inc. UDS CSS v0.0.0-development */
+/**
+* Extract all props from a JSX element (both explicit props and spread props).
+*
+* For explicit props like `<Box color="brand" />`, extracts the prop name and value.
+* For spread props like `<Box {...props} />`, marks them as fromSpread for later resolution.
+*
+* @param element The JSX element to extract props from
+* @returns Array of extracted props with their values
+*/
+const extractPropsFromElement = (element) => element.getAttributes().flatMap((attr) => {
+	if (ts_morph.Node.isJsxAttribute(attr)) {
+		const propName = attr.getNameNode().getText();
+		const stringLiterals = attr.getDescendantsOfKind(ts_morph.SyntaxKind.StringLiteral);
+		return [{
+			name: propName,
+			values: stringLiterals.length > 0 ? stringLiterals.map((lit) => lit.getLiteralText()) : (() => {
+				const initializer = attr.getInitializer();
+				if (!initializer || !ts_morph.Node.isJsxExpression(initializer)) return [];
+				const expression = initializer.getExpression();
+				return expression ? require_expressions.extractStringLiterals(expression) : [];
+			})(),
+			fromSpread: false
+		}];
+	}
+	if (ts_morph.Node.isJsxSpreadAttribute(attr)) {
+		const expression = attr.getExpression();
+		return [{
+			name: `__spread__:${ts_morph.Node.isIdentifier(expression) ? expression.getText() : expression.getChildren().pop()?.getText() ?? ""}`,
+			values: [],
+			fromSpread: true
+		}];
+	}
+	return [];
+});
+/**
+* Extract only explicit (non-spread) props from a JSX element.
+* Used when we want to avoid including spread-derived values.
+*/
+const extractExplicitProps = (element) => extractPropsFromElement(element).filter((p) => !p.fromSpread);
+//#endregion
+exports.extractExplicitProps = extractExplicitProps;

package/dist/css/dist/purger/optimized/ast/props.js

@@ -0,0 +1,46 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { extractStringLiterals } from "./expressions.js";
+import { Node, SyntaxKind } from "ts-morph";
+//#region ../css/dist/purger/optimized/ast/props.mjs
+/*! © 2026 Yahoo, Inc. UDS CSS v0.0.0-development */
+/**
+* Extract all props from a JSX element (both explicit props and spread props).
+*
+* For explicit props like `<Box color="brand" />`, extracts the prop name and value.
+* For spread props like `<Box {...props} />`, marks them as fromSpread for later resolution.
+*
+* @param element The JSX element to extract props from
+* @returns Array of extracted props with their values
+*/
+const extractPropsFromElement = (element) => element.getAttributes().flatMap((attr) => {
+	if (Node.isJsxAttribute(attr)) {
+		const propName = attr.getNameNode().getText();
+		const stringLiterals = attr.getDescendantsOfKind(SyntaxKind.StringLiteral);
+		return [{
+			name: propName,
+			values: stringLiterals.length > 0 ? stringLiterals.map((lit) => lit.getLiteralText()) : (() => {
+				const initializer = attr.getInitializer();
+				if (!initializer || !Node.isJsxExpression(initializer)) return [];
+				const expression = initializer.getExpression();
+				return expression ? extractStringLiterals(expression) : [];
+			})(),
+			fromSpread: false
+		}];
+	}
+	if (Node.isJsxSpreadAttribute(attr)) {
+		const expression = attr.getExpression();
+		return [{
+			name: `__spread__:${Node.isIdentifier(expression) ? expression.getText() : expression.getChildren().pop()?.getText() ?? ""}`,
+			values: [],
+			fromSpread: true
+		}];
+	}
+	return [];
+});
+/**
+* Extract only explicit (non-spread) props from a JSX element.
+* Used when we want to avoid including spread-derived values.
+*/
+const extractExplicitProps = (element) => extractPropsFromElement(element).filter((p) => !p.fromSpread);
+//#endregion
+export { extractExplicitProps };

package/dist/css/dist/purger/optimized/ast/spread.cjs

@@ -0,0 +1,87 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+require("../../../../../_virtual/_rolldown/runtime.cjs");
+const require_jsx = require("./jsx.cjs");
+const require_props = require("./props.cjs");
+let ts_morph = require("ts-morph");
+//#region ../css/dist/purger/optimized/ast/spread.mjs
+/*! © 2026 Yahoo, Inc. UDS CSS v0.0.0-development */
+/**
+* Find all usages of a component across the entire project.
+* This is the key function for spread resolution - when we encounter
+* {...props} on a UDS component inside a wrapper, we trace back to
+* find all places where the wrapper is used and extract actual values.
+*
+* @param componentName Name of the component to find usages of
+* @param project The ts-morph project
+* @param cache Optional cache to avoid re-scanning
+* @returns Array of component usages with their props
+*/
+const findComponentUsages = (componentName, project, cache) => {
+	if (cache?.has(componentName)) return cache.get(componentName);
+	const usages = [];
+	project.getSourceFiles().forEach((sourceFile) => {
+		if (!fileReferencesComponent(sourceFile, componentName)) return;
+		[...sourceFile.getDescendantsOfKind(ts_morph.SyntaxKind.JsxSelfClosingElement), ...sourceFile.getDescendantsOfKind(ts_morph.SyntaxKind.JsxOpeningElement)].filter((el) => el.getTagNameNode().getText() === componentName).forEach((element) => {
+			const props = require_props.extractExplicitProps(element);
+			usages.push({
+				componentName,
+				filePath: sourceFile.getFilePath(),
+				line: element.getStartLineNumber(),
+				props
+			});
+		});
+	});
+	if (cache) cache.set(componentName, usages);
+	return usages;
+};
+/**
+* Check if a source file references a component (by import or definition)
+*/
+const fileReferencesComponent = (sourceFile, componentName) => {
+	if (sourceFile.getImportDeclarations().some((imp) => imp.getNamedImports().some((named) => named.getName() === componentName))) return true;
+	if (sourceFile.getVariableDeclaration(componentName)) return true;
+	if (sourceFile.getFunction(componentName)) return true;
+	return false;
+};
+/**
+* Resolve spread props by tracing component usage.
+*
+* When we encounter {...props} on a UDS component inside a wrapper:
+* 1. Find the parent component that contains this spread
+* 2. Search ALL files for usages of that parent component
+* 3. Extract actual prop values passed at each usage site
+* 4. Return ONLY those values - never fall back to type properties
+*
+* @param element The JSX element with the spread
+* @param spreadIdentifier The identifier being spread (e.g., 'rest' from {...rest})
+* @param context The purge context for caching
+* @returns Map of prop names to their resolved values, or undefined if couldn't trace
+*/
+const resolveSpreadFromUsages = (element, spreadIdentifier, context) => {
+	const parentInfo = require_jsx.getParentComponentInfo(element);
+	if (!parentInfo) return;
+	if (!(parentInfo.spreadRestIdentifier === spreadIdentifier || parentInfo.paramIdentifier === spreadIdentifier)) return;
+	const usages = findComponentUsages(parentInfo.componentName, context.project, context.componentUsageCache);
+	if (usages.length === 0) return;
+	context.stats.spreadsTraced++;
+	const resolvedProps = /* @__PURE__ */ new Map();
+	usages.forEach((usage) => {
+		usage.props.forEach((prop) => {
+			if (prop.fromSpread) return;
+			const existing = resolvedProps.get(prop.name) ?? [];
+			prop.values.forEach((value) => {
+				if (!existing.includes(value)) existing.push(value);
+			});
+			resolvedProps.set(prop.name, existing);
+		});
+	});
+	const cacheKey = `${element.getSourceFile().getFilePath()}:${element.getStartLineNumber()}:${spreadIdentifier}`;
+	context.spreadCache.set(cacheKey, Array.from(resolvedProps).map(([name, values]) => ({
+		name,
+		values,
+		fromSpread: true
+	})));
+	return resolvedProps;
+};
+//#endregion
+exports.resolveSpreadFromUsages = resolveSpreadFromUsages;