@yahoo/uds 3.157.0 → 3.157.1

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

@@ -0,0 +1,78 @@
+
+import { ButtonSize, IconButtonSize } from "../../../types/dist/index.cjs";
+import { IconButtonMatchButtonHeightConfig } from "./iconButtonMatchButtonHeight.cjs";
+
+//#region ../automated-config/dist/utils/getButtonControlHeightPx.d.ts
+//#region src/utils/getButtonControlHeightPx.d.ts
+type ButtonControlHeightConfig = IconButtonMatchButtonHeightConfig & {
+  button?: {
+    variables?: Record<string, {
+      spacingVertical?: {
+        rest?: {
+          value?: string;
+        };
+      };
+      textVariant?: {
+        rest?: {
+          value?: string;
+        };
+      };
+      size?: {
+        rest?: {
+          value?: string;
+        };
+      };
+    }>;
+  };
+  iconButton?: {
+    variables?: Record<string, {
+      spacing?: {
+        rest?: {
+          value?: string;
+        };
+      };
+      size?: {
+        rest?: {
+          value?: string;
+        };
+      };
+    }>;
+  };
+  typography: Record<string, {
+    fontSize: {
+      base: number | {
+        value: number;
+      };
+      breakpoints: Record<string, number | {
+        value: number;
+      }>;
+    };
+    lineHeight: {
+      base: number | {
+        value: number;
+      };
+      breakpoints: Record<string, number | {
+        value: number;
+      }>;
+    };
+  }>;
+  scaleMode: {
+    large: {
+      spacing: Record<string, number>;
+    };
+  };
+  globalDefaults: {
+    breakpoint: string;
+  };
+};
+/** Pixel control height for Button: padding + max(icon size, text line-height). */
+declare function getButtonControlHeightPx(config: ButtonControlHeightConfig, size: ButtonSize): number;
+/** Pixel control height for IconButton: uniform padding plus icon size only. */
+declare function getIconButtonOnlyControlHeightPx(config: ButtonControlHeightConfig, size: IconButtonSize): number;
+/** Pixel control height for IconButton when match-button-height is enabled for that size. */
+declare function getIconButtonControlHeightPx(config: ButtonControlHeightConfig, size: IconButtonSize): number;
+declare function syncButtonControlHeightVarForSize<T extends object>(config: T, size: ButtonSize): T;
+declare function syncIconButtonControlHeightVarForSize<T extends object>(config: T, size: IconButtonSize): T;
+declare function syncIconButtonOnlyControlHeightVarForSize<T extends object>(config: T, size: IconButtonSize): T; //#endregion
+//#endregion
+export { getButtonControlHeightPx, getIconButtonControlHeightPx, getIconButtonOnlyControlHeightPx, syncButtonControlHeightVarForSize, syncIconButtonControlHeightVarForSize, syncIconButtonOnlyControlHeightVarForSize };

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

@@ -0,0 +1,78 @@
+
+import { ButtonSize, IconButtonSize } from "../../../types/dist/index.js";
+import { IconButtonMatchButtonHeightConfig } from "./iconButtonMatchButtonHeight.js";
+
+//#region ../automated-config/dist/utils/getButtonControlHeightPx.d.ts
+//#region src/utils/getButtonControlHeightPx.d.ts
+type ButtonControlHeightConfig = IconButtonMatchButtonHeightConfig & {
+  button?: {
+    variables?: Record<string, {
+      spacingVertical?: {
+        rest?: {
+          value?: string;
+        };
+      };
+      textVariant?: {
+        rest?: {
+          value?: string;
+        };
+      };
+      size?: {
+        rest?: {
+          value?: string;
+        };
+      };
+    }>;
+  };
+  iconButton?: {
+    variables?: Record<string, {
+      spacing?: {
+        rest?: {
+          value?: string;
+        };
+      };
+      size?: {
+        rest?: {
+          value?: string;
+        };
+      };
+    }>;
+  };
+  typography: Record<string, {
+    fontSize: {
+      base: number | {
+        value: number;
+      };
+      breakpoints: Record<string, number | {
+        value: number;
+      }>;
+    };
+    lineHeight: {
+      base: number | {
+        value: number;
+      };
+      breakpoints: Record<string, number | {
+        value: number;
+      }>;
+    };
+  }>;
+  scaleMode: {
+    large: {
+      spacing: Record<string, number>;
+    };
+  };
+  globalDefaults: {
+    breakpoint: string;
+  };
+};
+/** Pixel control height for Button: padding + max(icon size, text line-height). */
+declare function getButtonControlHeightPx(config: ButtonControlHeightConfig, size: ButtonSize): number;
+/** Pixel control height for IconButton: uniform padding plus icon size only. */
+declare function getIconButtonOnlyControlHeightPx(config: ButtonControlHeightConfig, size: IconButtonSize): number;
+/** Pixel control height for IconButton when match-button-height is enabled for that size. */
+declare function getIconButtonControlHeightPx(config: ButtonControlHeightConfig, size: IconButtonSize): number;
+declare function syncButtonControlHeightVarForSize<T extends object>(config: T, size: ButtonSize): T;
+declare function syncIconButtonControlHeightVarForSize<T extends object>(config: T, size: IconButtonSize): T;
+declare function syncIconButtonOnlyControlHeightVarForSize<T extends object>(config: T, size: IconButtonSize): T; //#endregion
+//#endregion
+export { getButtonControlHeightPx, getIconButtonControlHeightPx, getIconButtonOnlyControlHeightPx, syncButtonControlHeightVarForSize, syncIconButtonControlHeightVarForSize, syncIconButtonOnlyControlHeightVarForSize };

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

@@ -0,0 +1,108 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { spacingMap } from "../../../fixtures/dist/index.js";
+import { isIconButtonMatchButtonHeightEnabled } from "./iconButtonMatchButtonHeight.js";
+import { get } from "lodash-es";
+import { ICON_SIZE_MAP } from "@yahoo/uds-icons/tokens";
+//#region ../automated-config/dist/utils/getButtonControlHeightPx.js
+/*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
+const SHARED_BUTTON_ICONBUTTON_SIZES = new Set([
+	"xs",
+	"sm",
+	"md",
+	"lg"
+]);
+function resolveSpacingPx(config, alias) {
+	if (!alias) return 0;
+	const scaleValue = get(config, [
+		"scaleMode",
+		"large",
+		"spacing",
+		alias.replace(".", "_")
+	]);
+	if (typeof scaleValue === "number") return scaleValue;
+	return spacingMap[alias] ?? 0;
+}
+function resolveTypographyPx(config, textVariant, property) {
+	if (!textVariant) return 0;
+	const typographyConfig = config.typography[textVariant];
+	if (!typographyConfig?.[property]) return 0;
+	const defaultBreakpoint = config.globalDefaults.breakpoint;
+	const value = defaultBreakpoint === "base" ? typographyConfig[property].base : typographyConfig[property].breakpoints[defaultBreakpoint];
+	if (typeof value === "number") return value;
+	if (value && typeof value === "object" && "value" in value) return value.value;
+	return 0;
+}
+/** Ceil fractional totals so Figma-bound controlHeight matches auto-layout hug (e.g. xs + ui3 15.4lh → 28). */
+function snapControlHeightPx(value) {
+	return Math.ceil(value);
+}
+/** Pixel control height for Button: padding + max(icon size, text line-height). */
+function getButtonControlHeightPx(config, size) {
+	const button = config.button;
+	if (!button?.variables) return 0;
+	const layerPrefix = `size/${size}`;
+	const paddingAlias = button.variables[`${layerPrefix}/root`]?.spacingVertical?.rest?.value;
+	const iconSizeAlias = button.variables[`${layerPrefix}/icon`]?.size?.rest?.value;
+	const textVariant = button.variables[`${layerPrefix}/root`]?.textVariant?.rest?.value;
+	const padding = resolveSpacingPx(config, paddingAlias);
+	const iconSize = ICON_SIZE_MAP[iconSizeAlias ?? "sm"] ?? 16;
+	const lineHeight = resolveTypographyPx(config, textVariant, "lineHeight");
+	return snapControlHeightPx(padding * 2 + Math.max(iconSize, lineHeight || iconSize));
+}
+/** Pixel control height for IconButton: uniform padding plus icon size only. */
+function getIconButtonOnlyControlHeightPx(config, size) {
+	const iconButton = config.iconButton;
+	if (!iconButton?.variables) return 0;
+	const layerPrefix = `size/${size}`;
+	const paddingAlias = iconButton.variables[`${layerPrefix}/root`]?.spacing?.rest?.value;
+	const iconSizeAlias = iconButton.variables[`${layerPrefix}/icon`]?.size?.rest?.value;
+	const padding = resolveSpacingPx(config, paddingAlias);
+	const iconSize = ICON_SIZE_MAP[iconSizeAlias ?? "sm"] ?? 16;
+	return snapControlHeightPx(padding * 2 + iconSize);
+}
+/** Pixel control height for IconButton when match-button-height is enabled for that size. */
+function getIconButtonControlHeightPx(config, size) {
+	if (SHARED_BUTTON_ICONBUTTON_SIZES.has(size)) {
+		if (!isIconButtonMatchButtonHeightEnabled(config, size)) return 0;
+		return getButtonControlHeightPx(config, size);
+	}
+	return 0;
+}
+function setControlHeightVar(config, componentKey, size, heightPx) {
+	const rootKey = `size/${size}/root`;
+	const componentConfig = config[componentKey];
+	const existingRoot = componentConfig?.variables?.[rootKey] ?? {};
+	return {
+		...config,
+		[componentKey]: {
+			...componentConfig,
+			variables: {
+				...componentConfig?.variables,
+				[rootKey]: {
+					...existingRoot,
+					controlHeight: { rest: {
+						type: "positiveIntegers",
+						value: snapControlHeightPx(heightPx),
+						valueType: "alias"
+					} }
+				}
+			}
+		}
+	};
+}
+function syncButtonControlHeightVarForSize(config, size) {
+	if (!SHARED_BUTTON_ICONBUTTON_SIZES.has(size) || !isIconButtonMatchButtonHeightEnabled(config, size)) return config;
+	return setControlHeightVar(config, "iconButton", size, getButtonControlHeightPx(config, size));
+}
+function syncIconButtonControlHeightVarForSize(config, size) {
+	const heightPx = getIconButtonControlHeightPx(config, size);
+	if (heightPx <= 0) return config;
+	return setControlHeightVar(config, "iconButton", size, heightPx);
+}
+function syncIconButtonOnlyControlHeightVarForSize(config, size) {
+	const heightPx = getIconButtonOnlyControlHeightPx(config, size);
+	if (heightPx <= 0) return config;
+	return setControlHeightVar(config, "iconButton", size, heightPx);
+}
+//#endregion
+export { getButtonControlHeightPx, getIconButtonControlHeightPx, getIconButtonOnlyControlHeightPx, syncButtonControlHeightVarForSize, syncIconButtonControlHeightVarForSize, syncIconButtonOnlyControlHeightVarForSize };

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

@@ -11,8 +11,8 @@ import { VariantConfig } from "../types/ComponentConfig.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<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "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<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "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

@@ -11,8 +11,8 @@ import { VariantConfig } from "../types/ComponentConfig.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<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "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<"backgroundColor" | "borderWidth" | "underlineWidth" | "strokeWidth" | "borderRadius" | "borderRadiusVar" | "borderColor" | "underlineColor" | "stroke" | "buttonSize" | "buttonVariant" | "fontFamily" | "fontSize" | "fontVariationSettings" | "lineHeight" | "textTransform" | "letterSpacing" | "gap" | "color" | "opacity" | "fillOpacity" | "fontWeight" | "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/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 };