@yahoo/uds 3.156.2 → 3.157.1

package/dist/automated-config/dist/utils/getConfigVariantProperties.d.cts

@@ -1,6 +1,6 @@
 
-import { VariantConfig } from "../types/ComponentConfig.cjs";
 import { SelectedConfigurableProperty } from "../properties.cjs";
+import { VariantConfig } from "../types/ComponentConfig.cjs";
 
 //#region ../automated-config/dist/utils/getConfigVariantProperties.d.ts
 //#region src/utils/getConfigVariantProperties.d.ts
@@ -11,8 +11,8 @@ import { SelectedConfigurableProperty } from "../properties.cjs";
  * @returns A Record of layer names to their properties, or null if no properties are found
  */
 declare function getConfigVariantProperties(variant?: VariantConfig): {
-  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
-  root: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar" | "controlHeight", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  root: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar" | "controlHeight", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
 } | null; //#endregion
 //#endregion
 export { getConfigVariantProperties };

package/dist/automated-config/dist/utils/getConfigVariantProperties.d.ts

@@ -1,6 +1,6 @@
 
-import { VariantConfig } from "../types/ComponentConfig.js";
 import { SelectedConfigurableProperty } from "../properties.js";
+import { VariantConfig } from "../types/ComponentConfig.js";
 
 //#region ../automated-config/dist/utils/getConfigVariantProperties.d.ts
 //#region src/utils/getConfigVariantProperties.d.ts
@@ -11,8 +11,8 @@ import { SelectedConfigurableProperty } from "../properties.js";
  * @returns A Record of layer names to their properties, or null if no properties are found
  */
 declare function getConfigVariantProperties(variant?: VariantConfig): {
-  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
-  root: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar" | "controlHeight", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
+  root: Readonly<Record<string, SelectedConfigurableProperty<"textTransform" | "fontSize" | "fontWeight" | "lineHeight" | "fontFamily" | "letterSpacing" | "backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontVariationSettings" | "gap" | "color" | "opacity" | "fillOpacity" | "iconSize" | "spacing" | "iconVariant" | "horizontalMargin" | "bottomMargin" | "spacingHorizontal" | "spacingVertical" | "spacingTop" | "spacingBottom" | "textVariant" | "textDecorationLine" | "shadow" | "shadowVar" | "insetShadow" | "bannerInnerShadow" | "height" | "width" | "scaleEffect" | "backdropBlur" | "blurBackgroundColor" | "blurBackgroundColorFallback" | "scrimBackgroundColor" | "scrimOpacity" | "paginationWidthVar" | "controlHeight", string, readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases" | "elevationAliases")[] | readonly ("elevationAliases" | "borderWidths" | "spacingAliases")[] | readonly "borderRadii"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "elevationAliases" | "linePaletteColors")[] | readonly "buttonSizes"[] | readonly "buttonVariantsFlat"[] | readonly "textVariants"[] | readonly "spacingAliases"[] | readonly ("spectrumColors" | "alwaysPaletteAliases" | "foregroundPaletteColors")[] | readonly "opacitySteps"[] | readonly "iconSizes"[] | readonly "iconVariants"[] | readonly "textDecorationLines"[] | readonly ("elevationAliases" | "shadowVariants" | "shadowVariantConfig")[] | readonly ("shadowVariantConfig" | "shadowVariantsWithInvert")[] | readonly "bannerInnerShadowOptions"[] | readonly "scaleEffects"[] | readonly "positiveIntegers"[] | readonly ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[], readonly (readonly unknown[])[]>>>;
 } | null; //#endregion
 //#endregion
 export { getConfigVariantProperties };

package/dist/automated-config/dist/utils/getConfigVariantPseudoStates.cjs

@@ -1,10 +1,17 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_componentStatePseudoStates = require("./componentStatePseudoStates.cjs");
+const require_resolvePropertyStates = require("./resolvePropertyStates.cjs");
 const require_variantConfigGuards = require("./variantConfigGuards.cjs");
 const require_getConfigComponentVariant = require("./getConfigComponentVariant.cjs");
 //#region ../automated-config/dist/utils/getConfigVariantPseudoStates.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
-const DEFAULT_PSEUDO_STATES = ["rest"];
+/**
+* Returns a map of state key → reactive properties for a variant. The state
+* set comes from `resolvePropertyStates` — rest, atoms, and auto-generated
+* compounds (modifier × interactive, modifier × modifier × interactive,
+* etc.). The Configurator's StateBuilder caps user composition at the same
+* depth, so every selectable state is in this map.
+*/
 function getConfigVariantPseudoStates(config, variantKey, state, subComponentName, componentStateValue) {
 	const componentVariant = require_getConfigComponentVariant.getConfigComponentVariant(config, variantKey, subComponentName);
 	if (!componentVariant) return null;
@@ -13,21 +20,21 @@ function getConfigVariantPseudoStates(config, variantKey, state, subComponentNam
 	const stateLayers = require_variantConfigGuards.isVariantConfigWithComponentStates(componentVariant) && state ? Object.entries(componentVariant.componentStates[state].layers ?? {}) : [];
 	return [...variantLayers, ...stateLayers].flatMap(([layerKey, layer]) => Object.entries(layer.properties).map(([propertyKey, property]) => [
 		layerKey,
+		layer,
 		propertyKey,
 		property
-	])).flatMap(([layerKey, propertyKey, property]) => [...property.skipRestState ? DEFAULT_PSEUDO_STATES.filter((s) => s !== "rest") : DEFAULT_PSEUDO_STATES, ...require_componentStatePseudoStates.filterPseudoStatesByExclusion(property.pseudoStates, excludedPseudoStates)].map((pseudoState) => [
+	])).flatMap(([layerKey, layer, propertyKey, property]) => require_componentStatePseudoStates.filterPseudoStatesByExclusion(require_resolvePropertyStates.resolvePropertyStates(layer, property), excludedPseudoStates).map((pseudoState) => [
 		layerKey,
 		propertyKey,
 		property,
 		pseudoState
 	])).reduce((acc, [layerKey, propertyKey, property, pseudoState]) => {
 		acc[pseudoState] = acc[pseudoState] ?? [];
-		const info = [
+		acc[pseudoState].push([
 			layerKey,
 			propertyKey,
 			property
-		];
-		acc[pseudoState].push(info);
+		]);
 		return acc;
 	}, {});
 }

package/dist/automated-config/dist/utils/getConfigVariantPseudoStates.d.cts

@@ -1,11 +1,18 @@
 
-import { ComponentConfig, PossibleStatesWithRest } from "../types/ComponentConfig.cjs";
 import { SelectedConfigurableProperty } from "../properties.cjs";
+import { ComponentConfig, PossibleStatesWithRest } from "../types/ComponentConfig.cjs";
 
 //#region ../automated-config/dist/utils/getConfigVariantPseudoStates.d.ts
 //#region src/utils/getConfigVariantPseudoStates.d.ts
 type GenericProperty = SelectedConfigurableProperty<any, any>;
 type InfoTuple = [string, string, GenericProperty];
+/**
+ * Returns a map of state key → reactive properties for a variant. The state
+ * set comes from `resolvePropertyStates` — rest, atoms, and auto-generated
+ * compounds (modifier × interactive, modifier × modifier × interactive,
+ * etc.). The Configurator's StateBuilder caps user composition at the same
+ * depth, so every selectable state is in this map.
+ */
 declare function getConfigVariantPseudoStates<C extends ComponentConfig>(config: C, variantKey: string, state?: string, subComponentName?: string, componentStateValue?: string): Record<PossibleStatesWithRest, InfoTuple[]> | null; //#endregion
 //#endregion
 export { getConfigVariantPseudoStates };

package/dist/automated-config/dist/utils/getConfigVariantPseudoStates.d.ts

@@ -1,11 +1,18 @@
 
-import { ComponentConfig, PossibleStatesWithRest } from "../types/ComponentConfig.js";
 import { SelectedConfigurableProperty } from "../properties.js";
+import { ComponentConfig, PossibleStatesWithRest } from "../types/ComponentConfig.js";
 
 //#region ../automated-config/dist/utils/getConfigVariantPseudoStates.d.ts
 //#region src/utils/getConfigVariantPseudoStates.d.ts
 type GenericProperty = SelectedConfigurableProperty<any, any>;
 type InfoTuple = [string, string, GenericProperty];
+/**
+ * Returns a map of state key → reactive properties for a variant. The state
+ * set comes from `resolvePropertyStates` — rest, atoms, and auto-generated
+ * compounds (modifier × interactive, modifier × modifier × interactive,
+ * etc.). The Configurator's StateBuilder caps user composition at the same
+ * depth, so every selectable state is in this map.
+ */
 declare function getConfigVariantPseudoStates<C extends ComponentConfig>(config: C, variantKey: string, state?: string, subComponentName?: string, componentStateValue?: string): Record<PossibleStatesWithRest, InfoTuple[]> | null; //#endregion
 //#endregion
 export { getConfigVariantPseudoStates };

package/dist/automated-config/dist/utils/getConfigVariantPseudoStates.js

@@ -1,10 +1,17 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { filterPseudoStatesByExclusion, getExcludedPseudoStatesForComponentStateOption } from "./componentStatePseudoStates.js";
+import { resolvePropertyStates } from "./resolvePropertyStates.js";
 import { isVariantConfigWithComponentStates, isVariantConfigWithProperties } from "./variantConfigGuards.js";
 import { getConfigComponentVariant } from "./getConfigComponentVariant.js";
 //#region ../automated-config/dist/utils/getConfigVariantPseudoStates.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
-const DEFAULT_PSEUDO_STATES = ["rest"];
+/**
+* Returns a map of state key → reactive properties for a variant. The state
+* set comes from `resolvePropertyStates` — rest, atoms, and auto-generated
+* compounds (modifier × interactive, modifier × modifier × interactive,
+* etc.). The Configurator's StateBuilder caps user composition at the same
+* depth, so every selectable state is in this map.
+*/
 function getConfigVariantPseudoStates(config, variantKey, state, subComponentName, componentStateValue) {
 	const componentVariant = getConfigComponentVariant(config, variantKey, subComponentName);
 	if (!componentVariant) return null;
@@ -13,21 +20,21 @@ function getConfigVariantPseudoStates(config, variantKey, state, subComponentNam
 	const stateLayers = isVariantConfigWithComponentStates(componentVariant) && state ? Object.entries(componentVariant.componentStates[state].layers ?? {}) : [];
 	return [...variantLayers, ...stateLayers].flatMap(([layerKey, layer]) => Object.entries(layer.properties).map(([propertyKey, property]) => [
 		layerKey,
+		layer,
 		propertyKey,
 		property
-	])).flatMap(([layerKey, propertyKey, property]) => [...property.skipRestState ? DEFAULT_PSEUDO_STATES.filter((s) => s !== "rest") : DEFAULT_PSEUDO_STATES, ...filterPseudoStatesByExclusion(property.pseudoStates, excludedPseudoStates)].map((pseudoState) => [
+	])).flatMap(([layerKey, layer, propertyKey, property]) => filterPseudoStatesByExclusion(resolvePropertyStates(layer, property), excludedPseudoStates).map((pseudoState) => [
 		layerKey,
 		propertyKey,
 		property,
 		pseudoState
 	])).reduce((acc, [layerKey, propertyKey, property, pseudoState]) => {
 		acc[pseudoState] = acc[pseudoState] ?? [];
-		const info = [
+		acc[pseudoState].push([
 			layerKey,
 			propertyKey,
 			property
-		];
-		acc[pseudoState].push(info);
+		]);
 		return acc;
 	}, {});
 }

package/dist/automated-config/dist/utils/iconButtonMatchButtonHeight.cjs

@@ -0,0 +1,110 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_getButtonControlHeight = require("./getButtonControlHeight.cjs");
+const require_getButtonControlHeightPx = require("./getButtonControlHeightPx.cjs");
+//#region ../automated-config/dist/utils/iconButtonMatchButtonHeight.js
+/*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
+function asMatchButtonHeightConfig(config) {
+	return config;
+}
+function getMatchButtonHeightMap(config) {
+	return config.iconButton?.matchButtonHeight ?? config.matchButtonHeight;
+}
+function getIconButtonVariables(config) {
+	return config.iconButton?.variables ?? config.variables;
+}
+function isMatchButtonHeightSize(size) {
+	return require_getButtonControlHeight.SHARED_BUTTON_ICONBUTTON_SIZES.has(size);
+}
+function isIconButtonMatchButtonHeightEnabled(config, size) {
+	if (!isMatchButtonHeightSize(size)) return false;
+	return getMatchButtonHeightMap(asMatchButtonHeightConfig(config))?.[size] === true;
+}
+function getIconButtonSpacingRestValue(config, size) {
+	const rootKey = `size/${size}/root`;
+	const value = (getIconButtonVariables(config)?.[rootKey]?.spacing)?.rest?.value;
+	return typeof value === "string" ? value : void 0;
+}
+function setIconButtonSpacingRestValue(config, size, spacing) {
+	const matchConfig = asMatchButtonHeightConfig(config);
+	const rootKey = `size/${size}/root`;
+	const iconButton = matchConfig.iconButton ?? { variables: {} };
+	const existingRoot = iconButton.variables?.[rootKey] ?? {};
+	return {
+		...config,
+		iconButton: {
+			...iconButton,
+			variables: {
+				...iconButton.variables,
+				[rootKey]: {
+					...existingRoot,
+					spacing: { rest: {
+						type: "spacingAliases",
+						value: spacing,
+						valueType: "alias"
+					} }
+				}
+			}
+		}
+	};
+}
+function removeIconButtonControlHeight(config, size) {
+	const matchConfig = asMatchButtonHeightConfig(config);
+	const rootKey = `size/${size}/root`;
+	const iconButton = matchConfig.iconButton;
+	const rootLayer = iconButton?.variables?.[rootKey];
+	if (!rootLayer?.controlHeight) return config;
+	const { controlHeight: _, ...restRoot } = rootLayer;
+	return {
+		...config,
+		iconButton: {
+			...iconButton,
+			variables: {
+				...iconButton?.variables,
+				[rootKey]: restRoot
+			}
+		}
+	};
+}
+function enableIconButtonMatchButtonHeight(config, size) {
+	const matchConfig = asMatchButtonHeightConfig(config);
+	const currentSpacing = getIconButtonSpacingRestValue(matchConfig, size);
+	const iconButton = {
+		...matchConfig.iconButton,
+		matchButtonHeight: {
+			...matchConfig.iconButton?.matchButtonHeight,
+			[size]: true
+		}
+	};
+	if (currentSpacing !== void 0) iconButton.spacingBeforeMatchButtonHeight = {
+		...matchConfig.iconButton?.spacingBeforeMatchButtonHeight,
+		[size]: currentSpacing
+	};
+	let nextConfig = {
+		...config,
+		iconButton
+	};
+	nextConfig = require_getButtonControlHeightPx.syncButtonControlHeightVarForSize(nextConfig, size);
+	return nextConfig;
+}
+function disableIconButtonMatchButtonHeight(config, size) {
+	const spacingSnapshot = asMatchButtonHeightConfig(config).iconButton?.spacingBeforeMatchButtonHeight?.[size];
+	let nextConfig = removeIconButtonControlHeight(config, size);
+	if (spacingSnapshot !== void 0) nextConfig = setIconButtonSpacingRestValue(nextConfig, size, spacingSnapshot);
+	nextConfig = require_getButtonControlHeightPx.syncIconButtonOnlyControlHeightVarForSize(nextConfig, size);
+	const nextMatchConfig = asMatchButtonHeightConfig(nextConfig);
+	const { [size]: _removedFlag, ...remainingMatchButtonHeight } = nextMatchConfig.iconButton?.matchButtonHeight ?? {};
+	const { [size]: _removedSnapshot, ...remainingSpacingSnapshot } = nextMatchConfig.iconButton?.spacingBeforeMatchButtonHeight ?? {};
+	const iconButton = { ...nextMatchConfig.iconButton };
+	if (Object.keys(remainingMatchButtonHeight).length > 0) iconButton.matchButtonHeight = remainingMatchButtonHeight;
+	else delete iconButton.matchButtonHeight;
+	if (Object.keys(remainingSpacingSnapshot).length > 0) iconButton.spacingBeforeMatchButtonHeight = remainingSpacingSnapshot;
+	else delete iconButton.spacingBeforeMatchButtonHeight;
+	return {
+		...nextConfig,
+		iconButton
+	};
+}
+//#endregion
+exports.disableIconButtonMatchButtonHeight = disableIconButtonMatchButtonHeight;
+exports.enableIconButtonMatchButtonHeight = enableIconButtonMatchButtonHeight;
+exports.isIconButtonMatchButtonHeightEnabled = isIconButtonMatchButtonHeightEnabled;

package/dist/automated-config/dist/utils/iconButtonMatchButtonHeight.d.cts

@@ -0,0 +1,19 @@
+
+import { ButtonSize } from "../../../types/dist/index.cjs";
+
+//#region ../automated-config/dist/utils/iconButtonMatchButtonHeight.d.ts
+//#region src/utils/iconButtonMatchButtonHeight.d.ts
+type IconButtonMatchButtonHeightSize = ButtonSize;
+type IconButtonMatchButtonHeightConfig = {
+  iconButton?: {
+    matchButtonHeight?: Partial<Record<IconButtonMatchButtonHeightSize, true>>;
+    spacingBeforeMatchButtonHeight?: Partial<Record<IconButtonMatchButtonHeightSize, string>>;
+    variables?: Record<string, Record<string, unknown>>;
+  };
+  matchButtonHeight?: Partial<Record<IconButtonMatchButtonHeightSize, true>>;
+};
+declare function isIconButtonMatchButtonHeightEnabled(config: object, size: string): boolean;
+declare function enableIconButtonMatchButtonHeight<T extends object>(config: T, size: IconButtonMatchButtonHeightSize): T;
+declare function disableIconButtonMatchButtonHeight<T extends object>(config: T, size: IconButtonMatchButtonHeightSize): T; //#endregion
+//#endregion
+export { IconButtonMatchButtonHeightConfig, IconButtonMatchButtonHeightSize, disableIconButtonMatchButtonHeight, enableIconButtonMatchButtonHeight, isIconButtonMatchButtonHeightEnabled };

package/dist/automated-config/dist/utils/iconButtonMatchButtonHeight.d.ts

@@ -0,0 +1,19 @@
+
+import { ButtonSize } from "../../../types/dist/index.js";
+
+//#region ../automated-config/dist/utils/iconButtonMatchButtonHeight.d.ts
+//#region src/utils/iconButtonMatchButtonHeight.d.ts
+type IconButtonMatchButtonHeightSize = ButtonSize;
+type IconButtonMatchButtonHeightConfig = {
+  iconButton?: {
+    matchButtonHeight?: Partial<Record<IconButtonMatchButtonHeightSize, true>>;
+    spacingBeforeMatchButtonHeight?: Partial<Record<IconButtonMatchButtonHeightSize, string>>;
+    variables?: Record<string, Record<string, unknown>>;
+  };
+  matchButtonHeight?: Partial<Record<IconButtonMatchButtonHeightSize, true>>;
+};
+declare function isIconButtonMatchButtonHeightEnabled(config: object, size: string): boolean;
+declare function enableIconButtonMatchButtonHeight<T extends object>(config: T, size: IconButtonMatchButtonHeightSize): T;
+declare function disableIconButtonMatchButtonHeight<T extends object>(config: T, size: IconButtonMatchButtonHeightSize): T; //#endregion
+//#endregion
+export { IconButtonMatchButtonHeightConfig, IconButtonMatchButtonHeightSize, disableIconButtonMatchButtonHeight, enableIconButtonMatchButtonHeight, isIconButtonMatchButtonHeightEnabled };

package/dist/automated-config/dist/utils/iconButtonMatchButtonHeight.js

@@ -0,0 +1,108 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { SHARED_BUTTON_ICONBUTTON_SIZES } from "./getButtonControlHeight.js";
+import { syncButtonControlHeightVarForSize, syncIconButtonOnlyControlHeightVarForSize } from "./getButtonControlHeightPx.js";
+//#region ../automated-config/dist/utils/iconButtonMatchButtonHeight.js
+/*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
+function asMatchButtonHeightConfig(config) {
+	return config;
+}
+function getMatchButtonHeightMap(config) {
+	return config.iconButton?.matchButtonHeight ?? config.matchButtonHeight;
+}
+function getIconButtonVariables(config) {
+	return config.iconButton?.variables ?? config.variables;
+}
+function isMatchButtonHeightSize(size) {
+	return SHARED_BUTTON_ICONBUTTON_SIZES.has(size);
+}
+function isIconButtonMatchButtonHeightEnabled(config, size) {
+	if (!isMatchButtonHeightSize(size)) return false;
+	return getMatchButtonHeightMap(asMatchButtonHeightConfig(config))?.[size] === true;
+}
+function getIconButtonSpacingRestValue(config, size) {
+	const rootKey = `size/${size}/root`;
+	const value = (getIconButtonVariables(config)?.[rootKey]?.spacing)?.rest?.value;
+	return typeof value === "string" ? value : void 0;
+}
+function setIconButtonSpacingRestValue(config, size, spacing) {
+	const matchConfig = asMatchButtonHeightConfig(config);
+	const rootKey = `size/${size}/root`;
+	const iconButton = matchConfig.iconButton ?? { variables: {} };
+	const existingRoot = iconButton.variables?.[rootKey] ?? {};
+	return {
+		...config,
+		iconButton: {
+			...iconButton,
+			variables: {
+				...iconButton.variables,
+				[rootKey]: {
+					...existingRoot,
+					spacing: { rest: {
+						type: "spacingAliases",
+						value: spacing,
+						valueType: "alias"
+					} }
+				}
+			}
+		}
+	};
+}
+function removeIconButtonControlHeight(config, size) {
+	const matchConfig = asMatchButtonHeightConfig(config);
+	const rootKey = `size/${size}/root`;
+	const iconButton = matchConfig.iconButton;
+	const rootLayer = iconButton?.variables?.[rootKey];
+	if (!rootLayer?.controlHeight) return config;
+	const { controlHeight: _, ...restRoot } = rootLayer;
+	return {
+		...config,
+		iconButton: {
+			...iconButton,
+			variables: {
+				...iconButton?.variables,
+				[rootKey]: restRoot
+			}
+		}
+	};
+}
+function enableIconButtonMatchButtonHeight(config, size) {
+	const matchConfig = asMatchButtonHeightConfig(config);
+	const currentSpacing = getIconButtonSpacingRestValue(matchConfig, size);
+	const iconButton = {
+		...matchConfig.iconButton,
+		matchButtonHeight: {
+			...matchConfig.iconButton?.matchButtonHeight,
+			[size]: true
+		}
+	};
+	if (currentSpacing !== void 0) iconButton.spacingBeforeMatchButtonHeight = {
+		...matchConfig.iconButton?.spacingBeforeMatchButtonHeight,
+		[size]: currentSpacing
+	};
+	let nextConfig = {
+		...config,
+		iconButton
+	};
+	nextConfig = syncButtonControlHeightVarForSize(nextConfig, size);
+	return nextConfig;
+}
+function disableIconButtonMatchButtonHeight(config, size) {
+	const spacingSnapshot = asMatchButtonHeightConfig(config).iconButton?.spacingBeforeMatchButtonHeight?.[size];
+	let nextConfig = removeIconButtonControlHeight(config, size);
+	if (spacingSnapshot !== void 0) nextConfig = setIconButtonSpacingRestValue(nextConfig, size, spacingSnapshot);
+	nextConfig = syncIconButtonOnlyControlHeightVarForSize(nextConfig, size);
+	const nextMatchConfig = asMatchButtonHeightConfig(nextConfig);
+	const { [size]: _removedFlag, ...remainingMatchButtonHeight } = nextMatchConfig.iconButton?.matchButtonHeight ?? {};
+	const { [size]: _removedSnapshot, ...remainingSpacingSnapshot } = nextMatchConfig.iconButton?.spacingBeforeMatchButtonHeight ?? {};
+	const iconButton = { ...nextMatchConfig.iconButton };
+	if (Object.keys(remainingMatchButtonHeight).length > 0) iconButton.matchButtonHeight = remainingMatchButtonHeight;
+	else delete iconButton.matchButtonHeight;
+	if (Object.keys(remainingSpacingSnapshot).length > 0) iconButton.spacingBeforeMatchButtonHeight = remainingSpacingSnapshot;
+	else delete iconButton.spacingBeforeMatchButtonHeight;
+	return {
+		...nextConfig,
+		iconButton
+	};
+}
+//#endregion
+export { disableIconButtonMatchButtonHeight, enableIconButtonMatchButtonHeight, isIconButtonMatchButtonHeightEnabled };