@yahoo/uds 3.162.0 → 3.162.2

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

@@ -55,6 +55,22 @@ interface UDSThemeConfig {
   config?: string;
   /** Entry directory path or .tsx file path, or a list of those paths (default: './src') */
   entry?: string | string[];
+  /**
+   * Additional glob patterns to exclude from the safelist scan (e.g. dev-only
+   * pages not detectable by filename). Test/spec/story files and
+   * __tests__/__mocks__ directories are always excluded.
+   */
+  ignore?: string[];
+  /**
+   * Also scan test/spec/story files and __tests__/__mocks__ directories
+   * (default: false). Useful when a Storybook build shares this CSS output.
+   */
+  includeDevFiles?: boolean;
+  /**
+   * Also scan story files (default: false) while keeping test/spec files
+   * excluded. Use when a Storybook build consumes the generated CSS.
+   */
+  includeStories?: boolean;
   /** Suppress log output during generation (default: false) */
   silent?: boolean;
   /**

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

@@ -55,6 +55,22 @@ interface UDSThemeConfig {
   config?: string;
   /** Entry directory path or .tsx file path, or a list of those paths (default: './src') */
   entry?: string | string[];
+  /**
+   * Additional glob patterns to exclude from the safelist scan (e.g. dev-only
+   * pages not detectable by filename). Test/spec/story files and
+   * __tests__/__mocks__ directories are always excluded.
+   */
+  ignore?: string[];
+  /**
+   * Also scan test/spec/story files and __tests__/__mocks__ directories
+   * (default: false). Useful when a Storybook build shares this CSS output.
+   */
+  includeDevFiles?: boolean;
+  /**
+   * Also scan story files (default: false) while keeping test/spec files
+   * excluded. Use when a Storybook build consumes the generated CSS.
+   */
+  includeStories?: boolean;
   /** Suppress log output during generation (default: false) */
   silent?: boolean;
   /**

package/dist/css/dist/css/workerPool.cjs

@@ -60,7 +60,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/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 };