@yahoo/uds 3.157.0 → 3.158.0

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

@@ -8,6 +8,13 @@ import { SchemaStateValue } from "../types/ConfigSchema.js";
 import { OmitIndexSignature, SimplifyDeep, UnionToIntersection, WritableDeep } from "type-fest";
 
 //#region ../automated-config/dist/utils/buildConfigSchema.d.ts
+type OptionalInDefaultSchemaPropKeys<Props extends Record<string, SelectedConfigurableProperty<ConfigurablePropertiesName, string>>> = { [K in keyof Props]: Props[K] extends {
+  optionalInDefaultSchema: true;
+} ? K : never }[keyof Props];
+type RequiredInDefaultSchemaPropKeys<Props extends Record<string, SelectedConfigurableProperty<ConfigurablePropertiesName, string>>> = { [K in keyof Props]: Props[K] extends {
+  optionalInDefaultSchema: true;
+} ? never : K }[keyof Props];
+type InferredLayerPropertyMap<Props extends Record<string, SelectedConfigurableProperty<ConfigurablePropertiesName, string>>, Layer> = { [PropKey in RequiredInDefaultSchemaPropKeys<Props>]: InferredPropertyStates<Props[PropKey], Layer> } & { [PropKey in OptionalInDefaultSchemaPropKeys<Props>]?: InferredPropertyStates<Props[PropKey], Layer> };
 /** Infers default option values from all component variants */
 type InferredDefaults<C extends ComponentConfig> = (C['variants'] extends NonNullable<ComponentConfig['variants']> ? { [VarKey in keyof C['variants']]: C['variants'][VarKey]['options'][number] } : {}) & (C['subComponents'] extends NonNullable<ComponentConfig['subComponents']> ? UnionToIntersection<{ [SubCompKey in keyof C['subComponents']]: { [VarKey in keyof C['subComponents'][SubCompKey]['variants']]: C['subComponents'][SubCompKey]['variants'][VarKey]['options'][number] } }[keyof C['subComponents']]> : {});
 /** Infers type-safe schema value structure for a configurable property */
@@ -45,6 +52,9 @@ type InferredPropertyStates<Prop extends SelectedConfigurableProperty<Configurab
 type GetExcludedPseudoStatesForOption<StateConfig extends ComponentStateConfig, StateOption extends string> = StateConfig extends {
   excludePseudoStatesForOptions?: infer Exclusions extends Partial<Record<string, readonly PossibleStates[]>>;
 } ? StateOption extends keyof Exclusions ? Exclusions[StateOption] : undefined : undefined;
+type GetExcludedLayersForOption<StateConfig extends ComponentStateConfig, StateOption extends string> = StateConfig extends {
+  excludeLayersForOptions?: infer Exclusions extends Partial<Record<string, readonly string[]>>;
+} ? StateOption extends keyof Exclusions ? Exclusions[StateOption] extends readonly (infer Layer extends string)[] ? Layer : never : never : never;
 /** Property states after applying per-option pseudo-state exclusions */
 type InferredPropertyStatesForOption<Prop extends SelectedConfigurableProperty<ConfigurablePropertiesName, string>, ExcludedPseudoStates extends readonly PossibleStates[] | undefined> = (Prop['skipRestState'] extends true ? {} : {
   rest: InferredPropertySchema<Prop>;
@@ -54,13 +64,13 @@ type InferredPropertyStatesForOption<Prop extends SelectedConfigurableProperty<C
 /** Infers property-to-states mappings for a layer's properties */
 type InferredLayerProperties<Layer> = Layer extends LayerConfig ? Layer extends {
   properties: infer Props extends LayerConfig['properties'];
-} ? { [PropKey in keyof Props]: InferredPropertyStates<Props[PropKey], Layer> } : {} : {};
+} ? InferredLayerPropertyMap<Props, Layer> : {} : {};
 type InferredLayerPropertiesForOption<Layer, ExcludedPseudoStates extends readonly PossibleStates[] | undefined> = Layer extends LayerConfig ? Layer extends {
   properties: infer Props extends LayerConfig['properties'];
-} ? { [PropKey in keyof Props]: InferredPropertyStatesForOption<Props[PropKey], ExcludedPseudoStates> } : {} : {};
+} ? { [PropKey in RequiredInDefaultSchemaPropKeys<Props>]: InferredPropertyStatesForOption<Props[PropKey], ExcludedPseudoStates> } & { [PropKey in OptionalInDefaultSchemaPropKeys<Props>]?: InferredPropertyStatesForOption<Props[PropKey], ExcludedPseudoStates> } : {} : {};
 /** Generates schema key → properties mappings for a variant's layers or component states */
-type InferredSchemaMap<VarKey extends string, VarConfig extends VariantConfig, LayersOrStates extends NonNullable<VariantConfigWithComponentStates['componentStates']> | NonNullable<VariantConfigWithProperties['layers']>, Prefix extends string = ''> = LayersOrStates extends NonNullable<VariantConfigWithComponentStates['componentStates']> ? UnionToIntersection<{ [StateKey in keyof OmitIndexSignature<LayersOrStates>]: UnionToIntersection<{ [StateOption in LayersOrStates[StateKey]['options'][number]]: { [LayerKey in keyof OmitIndexSignature<LayersOrStates[StateKey]['layers']> as `${Prefix}${VarKey}/${VarConfig['options'][number]}/${StateKey & string}/${StateOption}/${LayerKey & string}`]: InferredLayerPropertiesForOption<LayersOrStates[StateKey]['layers'][LayerKey], GetExcludedPseudoStatesForOption<LayersOrStates[StateKey], StateOption>> } }[LayersOrStates[StateKey]['options'][number]]> }[keyof OmitIndexSignature<LayersOrStates>]> : { [LayerKey in keyof OmitIndexSignature<LayersOrStates> as `${Prefix}${VarKey}/${VarConfig['options'][number]}/${LayerKey & string}`]: InferredLayerProperties<LayersOrStates[LayerKey]> };
-type InferredVariantLevelProperties<Props extends Record<string, SelectedConfigurableProperty<ConfigurablePropertiesName, string>>> = { [PropKey in keyof Props]: InferredPropertyStates<Props[PropKey]> };
+type InferredSchemaMap<VarKey extends string, VarConfig extends VariantConfig, LayersOrStates extends NonNullable<VariantConfigWithComponentStates['componentStates']> | NonNullable<VariantConfigWithProperties['layers']>, Prefix extends string = ''> = LayersOrStates extends NonNullable<VariantConfigWithComponentStates['componentStates']> ? UnionToIntersection<{ [StateKey in keyof OmitIndexSignature<LayersOrStates>]: UnionToIntersection<{ [StateOption in LayersOrStates[StateKey]['options'][number]]: { [LayerKey in Exclude<keyof OmitIndexSignature<LayersOrStates[StateKey]['layers']>, GetExcludedLayersForOption<LayersOrStates[StateKey], StateOption>> as `${Prefix}${VarKey}/${VarConfig['options'][number]}/${StateKey & string}/${StateOption}/${LayerKey & string}`]: InferredLayerPropertiesForOption<LayersOrStates[StateKey]['layers'][LayerKey], GetExcludedPseudoStatesForOption<LayersOrStates[StateKey], StateOption>> } }[LayersOrStates[StateKey]['options'][number]]> }[keyof OmitIndexSignature<LayersOrStates>]> : { [LayerKey in keyof OmitIndexSignature<LayersOrStates> as `${Prefix}${VarKey}/${VarConfig['options'][number]}/${LayerKey & string}`]: InferredLayerProperties<LayersOrStates[LayerKey]> };
+type InferredVariantLevelProperties<Props extends Record<string, SelectedConfigurableProperty<ConfigurablePropertiesName, string>>> = { [PropKey in RequiredInDefaultSchemaPropKeys<Props>]: InferredPropertyStates<Props[PropKey]> } & { [PropKey in OptionalInDefaultSchemaPropKeys<Props>]?: InferredPropertyStates<Props[PropKey]> };
 type InferredVariantPropertiesMap<VarKey extends string, VarConfig extends VariantConfigWithProperties, Prefix extends string = ''> = VarConfig extends {
   variantProperties: infer Props extends Record<string, SelectedConfigurableProperty<ConfigurablePropertiesName, string>>;
 } ? { [Option in VarConfig['options'][number] as `${Prefix}${VarKey}/${Option}`]: InferredVariantLevelProperties<Props> } : {};

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

@@ -1,5 +1,5 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-import { getExcludedPseudoStatesForComponentStateOption } from "./componentStatePseudoStates.js";
+import { getExcludedLayersForComponentStateOption, getExcludedPseudoStatesForComponentStateOption } from "./componentStatePseudoStates.js";
 import { generateSchemaKey } from "./generateSchemaKey.js";
 import { resolvePropertyStates } from "./resolvePropertyStates.js";
 import { isVariantConfigWithComponentStates, isVariantConfigWithProperties } from "./variantConfigGuards.js";
@@ -70,6 +70,9 @@ function buildPropertyStateMap(layer, property, variantOption, excludedStates =
 function propertyVariesOnlyAtRest(property) {
 	return property.name === "textVariant";
 }
+function isOptionalInDefaultSchema(property) {
+	return property.optionalInDefaultSchema === true;
+}
 /** Resolves the fixture type by finding which value set contains the given value */
 function findFixtureTypeForValue(property, value) {
 	const index = property.values.findIndex((arr) => arr.includes(value));
@@ -99,6 +102,7 @@ function emitUniversalLayerSchema(result, layers, variantKey, variantOption, sub
 		result.variables[schemaKey] = {};
 		for (const propertyKey in layer.properties) {
 			const property = layer.properties[propertyKey];
+			if (isOptionalInDefaultSchema(property)) continue;
 			result.variables[schemaKey] = {
 				...result.variables[schemaKey],
 				[propertyKey]: buildPropertyStateMap(layer, property, variantOption)
@@ -120,22 +124,27 @@ function buildConfigSchema(config) {
 			const componentStates = variantConfig.componentStates;
 			for (const componentStateKey in componentStates) {
 				const componentState = componentStates[componentStateKey];
-				for (const componentStateOption of componentState.options) for (const layerKey in componentState.layers) {
-					const layer = componentState.layers[layerKey];
-					const schemaKey = generateSchemaKey({
-						variantKey,
-						variantValue: variantOption,
-						componentStateKey,
-						componentStateValue: componentStateOption,
-						layer: layerKey
-					});
-					result.variables[schemaKey] = {};
-					for (const propertyKey in layer.properties) {
-						const property = layer.properties[propertyKey];
-						result.variables[schemaKey] = {
-							...result.variables[schemaKey],
-							[propertyKey]: buildPropertyStateMap(layer, property, variantOption, getExcludedPseudoStatesForComponentStateOption(componentState, componentStateOption))
-						};
+				for (const componentStateOption of componentState.options) {
+					const excludedLayers = new Set(getExcludedLayersForComponentStateOption(componentState, componentStateOption));
+					for (const layerKey in componentState.layers) {
+						if (excludedLayers.has(layerKey)) continue;
+						const layer = componentState.layers[layerKey];
+						const schemaKey = generateSchemaKey({
+							variantKey,
+							variantValue: variantOption,
+							componentStateKey,
+							componentStateValue: componentStateOption,
+							layer: layerKey
+						});
+						result.variables[schemaKey] = {};
+						for (const propertyKey in layer.properties) {
+							const property = layer.properties[propertyKey];
+							if (isOptionalInDefaultSchema(property)) continue;
+							result.variables[schemaKey] = {
+								...result.variables[schemaKey],
+								[propertyKey]: buildPropertyStateMap(layer, property, variantOption, getExcludedPseudoStatesForComponentStateOption(componentState, componentStateOption))
+							};
+						}
 					}
 				}
 			}
@@ -145,6 +154,7 @@ function buildConfigSchema(config) {
 				result.variables[variantSchemaKey] = result.variables[variantSchemaKey] ?? {};
 				for (const propertyKey in variantConfig.variantProperties) {
 					const property = variantConfig.variantProperties[propertyKey];
+					if (isOptionalInDefaultSchema(property)) continue;
 					result.variables[variantSchemaKey] = {
 						...result.variables[variantSchemaKey],
 						[propertyKey]: buildPropertyStateMap({
@@ -167,23 +177,28 @@ function buildConfigSchema(config) {
 				const componentStates = variantConfig.componentStates;
 				for (const componentStateKey in componentStates) {
 					const componentState = componentStates[componentStateKey];
-					for (const componentStateOption of componentState.options) for (const layerKey in componentState.layers) {
-						const layer = componentState.layers[layerKey];
-						const schemaKey = generateSchemaKey({
-							variantKey,
-							variantValue: variantOption,
-							componentStateKey,
-							componentStateValue: componentStateOption,
-							layer: layerKey,
-							subComponentName: subComponentKey
-						});
-						result.variables[schemaKey] = {};
-						for (const propertyKey in layer.properties) {
-							const property = layer.properties[propertyKey];
-							result.variables[schemaKey] = {
-								...result.variables[schemaKey],
-								[propertyKey]: buildPropertyStateMap(layer, property, variantOption, getExcludedPseudoStatesForComponentStateOption(componentState, componentStateOption))
-							};
+					for (const componentStateOption of componentState.options) {
+						const excludedLayers = new Set(getExcludedLayersForComponentStateOption(componentState, componentStateOption));
+						for (const layerKey in componentState.layers) {
+							if (excludedLayers.has(layerKey)) continue;
+							const layer = componentState.layers[layerKey];
+							const schemaKey = generateSchemaKey({
+								variantKey,
+								variantValue: variantOption,
+								componentStateKey,
+								componentStateValue: componentStateOption,
+								layer: layerKey,
+								subComponentName: subComponentKey
+							});
+							result.variables[schemaKey] = {};
+							for (const propertyKey in layer.properties) {
+								const property = layer.properties[propertyKey];
+								if (isOptionalInDefaultSchema(property)) continue;
+								result.variables[schemaKey] = {
+									...result.variables[schemaKey],
+									[propertyKey]: buildPropertyStateMap(layer, property, variantOption, getExcludedPseudoStatesForComponentStateOption(componentState, componentStateOption))
+								};
+							}
 						}
 					}
 				}

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

@@ -4,6 +4,9 @@
 function getExcludedPseudoStatesForComponentStateOption(componentState, componentStateOption) {
 	return componentState.excludePseudoStatesForOptions?.[componentStateOption] ?? [];
 }
+function getExcludedLayersForComponentStateOption(componentState, componentStateOption) {
+	return componentState.excludeLayersForOptions?.[componentStateOption] ?? [];
+}
 function filterPseudoStatesByExclusion(pseudoStates, excludedPseudoStates) {
 	if (!pseudoStates) return [];
 	if (excludedPseudoStates.length === 0) return [...pseudoStates];
@@ -12,4 +15,5 @@ function filterPseudoStatesByExclusion(pseudoStates, excludedPseudoStates) {
 }
 //#endregion
 exports.filterPseudoStatesByExclusion = filterPseudoStatesByExclusion;
+exports.getExcludedLayersForComponentStateOption = getExcludedLayersForComponentStateOption;
 exports.getExcludedPseudoStatesForComponentStateOption = getExcludedPseudoStatesForComponentStateOption;

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

@@ -4,6 +4,9 @@
 function getExcludedPseudoStatesForComponentStateOption(componentState, componentStateOption) {
 	return componentState.excludePseudoStatesForOptions?.[componentStateOption] ?? [];
 }
+function getExcludedLayersForComponentStateOption(componentState, componentStateOption) {
+	return componentState.excludeLayersForOptions?.[componentStateOption] ?? [];
+}
 function filterPseudoStatesByExclusion(pseudoStates, excludedPseudoStates) {
 	if (!pseudoStates) return [];
 	if (excludedPseudoStates.length === 0) return [...pseudoStates];
@@ -11,4 +14,4 @@ function filterPseudoStatesByExclusion(pseudoStates, excludedPseudoStates) {
 	return pseudoStates.filter((pseudoState) => !excluded.has(pseudoState));
 }
 //#endregion
-export { filterPseudoStatesByExclusion, getExcludedPseudoStatesForComponentStateOption };
+export { filterPseudoStatesByExclusion, getExcludedLayersForComponentStateOption, getExcludedPseudoStatesForComponentStateOption };

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

@@ -0,0 +1,129 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_index = require("../../../css-tokens/dist/index.cjs");
+const require_mapTextVariantFixtureToValue = require("../mapTextVariantFixtureToValue.cjs");
+const require_properties = require("../properties.cjs");
+const require_iconButtonMatchButtonHeight = require("./iconButtonMatchButtonHeight.cjs");
+//#region ../automated-config/dist/utils/getButtonControlHeight.js
+/*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
+/** Sizes where IconButton control height should match Button. */
+const SHARED_BUTTON_ICONBUTTON_SIZES = new Set([
+	"xs",
+	"sm",
+	"md",
+	"lg"
+]);
+function getButtonIconSizeVar({ schema, iconLayerKey, state, theme }) {
+	const iconSizeValue = schema.variables?.[iconLayerKey]?.size?.[state]?.value;
+	if (typeof iconSizeValue === "string" && iconSizeValue) return theme(require_properties.configurableProperties.iconSize.twThemePath("iconSizes", iconSizeValue));
+}
+/**
+* Button content box: max(icon size, text line-height).
+* Matches Figma auto-layout and keeps IconButton height aligned with Button.
+*/
+function getButtonControlContentSize({ schema, rootLayerKey, iconLayerKey, state, theme }) {
+	const iconSizeVar = getButtonIconSizeVar({
+		schema,
+		iconLayerKey,
+		state,
+		theme
+	});
+	const textVariantValue = schema.variables?.[rootLayerKey]?.textVariant?.[state]?.value;
+	if (iconSizeVar && typeof textVariantValue === "string" && textVariantValue) return `max(${iconSizeVar}, ${theme(require_mapTextVariantFixtureToValue.mapTextVariantFixtureToValue("lineHeight")("textVariants", textVariantValue))})`;
+	if (iconSizeVar) return iconSizeVar;
+}
+/** `round(up, …, 1px)` matches Math.ceil in getButtonControlHeightPx and Figma hug height. */
+function formatControlHeightCalc(calcExpression) {
+	return `round(up, ${calcExpression}, 1px)`;
+}
+/**
+* Button control height: vertical padding on both sides plus max(icon size, text line-height).
+*/
+function getButtonControlHeight({ paddingVertical, schema, rootLayerKey, iconLayerKey, state, theme }) {
+	const contentSize = getButtonControlContentSize({
+		schema,
+		rootLayerKey,
+		iconLayerKey,
+		state,
+		theme
+	});
+	if (!contentSize) return;
+	return formatControlHeightCalc(`calc(2 * ${paddingVertical} + ${contentSize})`);
+}
+/**
+* IconButton control height: uniform padding plus icon size only (no typography).
+*/
+function getIconButtonControlHeight({ paddingVertical, schema, iconLayerKey, state, theme }) {
+	const iconSizeVar = getButtonIconSizeVar({
+		schema,
+		iconLayerKey,
+		state,
+		theme
+	});
+	if (!iconSizeVar) return;
+	return formatControlHeightCalc(`calc(2 * ${paddingVertical} + ${iconSizeVar})`);
+}
+/**
+* Layout line-height for button root: max(icon size, text line-height).
+*/
+function getButtonContentLineHeight({ schema, rootLayerKey, iconLayerKey, state, theme }) {
+	return getButtonControlContentSize({
+		schema,
+		rootLayerKey,
+		iconLayerKey,
+		state,
+		theme
+	}) ?? "1em";
+}
+function applyButtonControlHeightDeclarations({ cssDeclarations, paddingVertical, schema, rootLayerKey, iconLayerKey, state, theme }) {
+	const controlHeight = rootLayerKey ? getButtonControlHeight({
+		paddingVertical,
+		schema,
+		rootLayerKey,
+		iconLayerKey,
+		state,
+		theme
+	}) : getIconButtonControlHeight({
+		paddingVertical,
+		schema,
+		iconLayerKey,
+		state,
+		theme
+	});
+	if (controlHeight) {
+		cssDeclarations[require_index.BUTTON_CONTROL_HEIGHT_VAR] = controlHeight;
+		cssDeclarations.height = `var(${require_index.BUTTON_CONTROL_HEIGHT_VAR})`;
+	}
+}
+function applyIconButtonSquareDimensions(cssDeclarations) {
+	if (cssDeclarations[require_index.BUTTON_CONTROL_HEIGHT_VAR]) cssDeclarations.width = `var(${require_index.BUTTON_CONTROL_HEIGHT_VAR})`;
+}
+/**
+* IconButton height for xs–lg mirrors Button (padding + max(icon, line-height)).
+* xl uses icon-only height from IconButton tokens.
+*/
+function applyIconButtonControlHeightDeclarations({ cssDeclarations, paddingVertical, iconButtonSchema, buttonHeightReferenceSchema, variantValue, iconLayerKey: _iconLayerKey, state, theme }) {
+	if (buttonHeightReferenceSchema && SHARED_BUTTON_ICONBUTTON_SIZES.has(variantValue) && require_iconButtonMatchButtonHeight.isIconButtonMatchButtonHeightEnabled(iconButtonSchema, variantValue)) {
+		const buttonRootLayerKey = `size/${variantValue}/root`;
+		const buttonIconLayerKey = `size/${variantValue}/icon`;
+		const buttonSpacingValue = buttonHeightReferenceSchema.variables?.[buttonRootLayerKey]?.spacingVertical?.[state]?.value;
+		applyButtonControlHeightDeclarations({
+			cssDeclarations,
+			paddingVertical: typeof buttonSpacingValue === "string" && buttonSpacingValue ? theme(require_properties.configurableProperties.spacingVertical.twThemePath("spacingAliases", buttonSpacingValue)) : paddingVertical,
+			schema: buttonHeightReferenceSchema,
+			rootLayerKey: buttonRootLayerKey,
+			iconLayerKey: buttonIconLayerKey,
+			state,
+			theme
+		});
+		applyIconButtonSquareDimensions(cssDeclarations);
+	}
+}
+//#endregion
+exports.SHARED_BUTTON_ICONBUTTON_SIZES = SHARED_BUTTON_ICONBUTTON_SIZES;
+exports.applyButtonControlHeightDeclarations = applyButtonControlHeightDeclarations;
+exports.applyIconButtonControlHeightDeclarations = applyIconButtonControlHeightDeclarations;
+exports.getButtonContentLineHeight = getButtonContentLineHeight;
+exports.getButtonControlContentSize = getButtonControlContentSize;
+exports.getButtonControlHeight = getButtonControlHeight;
+exports.getButtonIconSizeVar = getButtonIconSizeVar;
+exports.getIconButtonControlHeight = getIconButtonControlHeight;

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

@@ -0,0 +1,133 @@
+
+import { IconButtonMatchButtonHeightConfig } from "./iconButtonMatchButtonHeight.cjs";
+
+//#region ../automated-config/dist/utils/getButtonControlHeight.d.ts
+//#region src/utils/getButtonControlHeight.d.ts
+type ThemeFn = (path: string) => string;
+/** Sizes where IconButton control height should match Button. */
+declare const SHARED_BUTTON_ICONBUTTON_SIZES: Set<string>;
+type ButtonControlSchema = IconButtonMatchButtonHeightConfig & {
+  variables?: Record<string, Record<string, Record<string, {
+    value?: unknown;
+  }>>>;
+};
+declare function getButtonIconSizeVar({
+  schema,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  schema: ButtonControlSchema;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * Button content box: max(icon size, text line-height).
+ * Matches Figma auto-layout and keeps IconButton height aligned with Button.
+ */
+declare function getButtonControlContentSize({
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  schema: ButtonControlSchema;
+  rootLayerKey: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * Button control height: vertical padding on both sides plus max(icon size, text line-height).
+ */
+declare function getButtonControlHeight({
+  paddingVertical,
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  paddingVertical: string;
+  schema: ButtonControlSchema;
+  rootLayerKey: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * IconButton control height: uniform padding plus icon size only (no typography).
+ */
+declare function getIconButtonControlHeight({
+  paddingVertical,
+  schema,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  paddingVertical: string;
+  schema: ButtonControlSchema;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * Layout line-height for button root: max(icon size, text line-height).
+ */
+declare function getButtonContentLineHeight({
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  schema: ButtonControlSchema;
+  rootLayerKey: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string;
+declare function applyButtonControlHeightDeclarations({
+  cssDeclarations,
+  paddingVertical,
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  cssDeclarations: Record<string, string>;
+  paddingVertical: string;
+  schema: ButtonControlSchema;
+  rootLayerKey?: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): void;
+/**
+ * IconButton height for xs–lg mirrors Button (padding + max(icon, line-height)).
+ * xl uses icon-only height from IconButton tokens.
+ */
+declare function applyIconButtonControlHeightDeclarations({
+  cssDeclarations,
+  paddingVertical,
+  iconButtonSchema,
+  buttonHeightReferenceSchema,
+  variantValue,
+  iconLayerKey: _iconLayerKey,
+  state,
+  theme
+}: {
+  cssDeclarations: Record<string, string>;
+  paddingVertical: string;
+  iconButtonSchema: ButtonControlSchema;
+  buttonHeightReferenceSchema?: ButtonControlSchema;
+  variantValue: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): void; //#endregion
+//#endregion
+export { type ButtonControlSchema, SHARED_BUTTON_ICONBUTTON_SIZES, applyButtonControlHeightDeclarations, applyIconButtonControlHeightDeclarations, getButtonContentLineHeight, getButtonControlContentSize, getButtonControlHeight, getButtonIconSizeVar, getIconButtonControlHeight };

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

@@ -0,0 +1,133 @@
+
+import { IconButtonMatchButtonHeightConfig } from "./iconButtonMatchButtonHeight.js";
+
+//#region ../automated-config/dist/utils/getButtonControlHeight.d.ts
+//#region src/utils/getButtonControlHeight.d.ts
+type ThemeFn = (path: string) => string;
+/** Sizes where IconButton control height should match Button. */
+declare const SHARED_BUTTON_ICONBUTTON_SIZES: Set<string>;
+type ButtonControlSchema = IconButtonMatchButtonHeightConfig & {
+  variables?: Record<string, Record<string, Record<string, {
+    value?: unknown;
+  }>>>;
+};
+declare function getButtonIconSizeVar({
+  schema,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  schema: ButtonControlSchema;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * Button content box: max(icon size, text line-height).
+ * Matches Figma auto-layout and keeps IconButton height aligned with Button.
+ */
+declare function getButtonControlContentSize({
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  schema: ButtonControlSchema;
+  rootLayerKey: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * Button control height: vertical padding on both sides plus max(icon size, text line-height).
+ */
+declare function getButtonControlHeight({
+  paddingVertical,
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  paddingVertical: string;
+  schema: ButtonControlSchema;
+  rootLayerKey: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * IconButton control height: uniform padding plus icon size only (no typography).
+ */
+declare function getIconButtonControlHeight({
+  paddingVertical,
+  schema,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  paddingVertical: string;
+  schema: ButtonControlSchema;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string | undefined;
+/**
+ * Layout line-height for button root: max(icon size, text line-height).
+ */
+declare function getButtonContentLineHeight({
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  schema: ButtonControlSchema;
+  rootLayerKey: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): string;
+declare function applyButtonControlHeightDeclarations({
+  cssDeclarations,
+  paddingVertical,
+  schema,
+  rootLayerKey,
+  iconLayerKey,
+  state,
+  theme
+}: {
+  cssDeclarations: Record<string, string>;
+  paddingVertical: string;
+  schema: ButtonControlSchema;
+  rootLayerKey?: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): void;
+/**
+ * IconButton height for xs–lg mirrors Button (padding + max(icon, line-height)).
+ * xl uses icon-only height from IconButton tokens.
+ */
+declare function applyIconButtonControlHeightDeclarations({
+  cssDeclarations,
+  paddingVertical,
+  iconButtonSchema,
+  buttonHeightReferenceSchema,
+  variantValue,
+  iconLayerKey: _iconLayerKey,
+  state,
+  theme
+}: {
+  cssDeclarations: Record<string, string>;
+  paddingVertical: string;
+  iconButtonSchema: ButtonControlSchema;
+  buttonHeightReferenceSchema?: ButtonControlSchema;
+  variantValue: string;
+  iconLayerKey: string;
+  state: string;
+  theme: ThemeFn;
+}): void; //#endregion
+//#endregion
+export { type ButtonControlSchema, SHARED_BUTTON_ICONBUTTON_SIZES, applyButtonControlHeightDeclarations, applyIconButtonControlHeightDeclarations, getButtonContentLineHeight, getButtonControlContentSize, getButtonControlHeight, getButtonIconSizeVar, getIconButtonControlHeight };