@yahoo/uds 3.165.0 → 3.167.0

package/dist/components/client/Chip/index.d.ts

@@ -5,4 +5,5 @@ import { ChipButton, ChipButtonProps } from "./ChipButton.js";
 import { ChipDismissible, ChipDismissibleProps } from "./ChipDismissible.js";
 import { ChipLink, ChipLinkProps } from "./ChipLink.js";
 import { ChipToggle, ChipToggleProps } from "./ChipToggle.js";
-export { Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps };
+import { UDSChipConfigProvider, UDSChipConfigProviderProps, useChipConfig } from "./UDSChipConfigProvider.js";
+export { Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, UDSChipConfigProvider, type UDSChipConfigProviderProps, useChipConfig };

package/dist/components/client/Chip/index.js

@@ -1,8 +1,9 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
+import { UDSChipConfigProvider, useChipConfig } from "./UDSChipConfigProvider.js";
 import { ChipButton } from "./ChipButton.js";
 import { ChipDismissible } from "./ChipDismissible.js";
 import { ChipLink } from "./ChipLink.js";
 import { ChipToggle } from "./ChipToggle.js";
 import { Chip } from "./Chip.js";
-export { Chip, ChipButton, ChipDismissible, ChipLink, ChipToggle };
+export { Chip, ChipButton, ChipDismissible, ChipLink, ChipToggle, UDSChipConfigProvider, useChipConfig };

package/dist/components/client/Input/Input.cjs

@@ -9,6 +9,7 @@ const require_components_HStack = require("../../HStack.cjs");
 const require_components_VStack = require("../../VStack.cjs");
 const require_hooks_usePrefersReducedMotion = require("../../../hooks/usePrefersReducedMotion.cjs");
 const require_components_client_AnimateHeightChange = require("../AnimateHeightChange.cjs");
+const require_components_client_Input_UDSInputConfigProvider = require("./UDSInputConfigProvider.cjs");
 const require_components_client_Input_InputHelpTextInternal = require("./InputHelpTextInternal.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -90,6 +91,7 @@ const Input = (0, react.forwardRef)(function Input({ id, label, type = "text", s
 	const generatedId = (0, react.useId)();
 	const uid = id ?? `uds-input-${generatedId}`;
 	const helpTextId = `uds-input-${uid}-help-text`;
+	const { startIconSize, endIconSize } = require_components_client_Input_UDSInputConfigProvider.useInputConfig(size);
 	const { className: inputClassName, ...inputProps } = slotProps?.input ?? {};
 	const { className: inputWrapperClassName, ...inputWrapperProps } = slotProps?.inputWrapper ?? {};
 	const ref = (0, react.useRef)(null);
@@ -204,7 +206,10 @@ const Input = (0, react.forwardRef)(function Input({ id, label, type = "text", s
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StartIcon, {
 						icon: startIcon,
 						className: classNames.startIcon,
-						iconProps: slotProps?.startIcon
+						iconProps: {
+							size: startIconSize,
+							...slotProps?.startIcon
+						}
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 						ref,
@@ -229,7 +234,10 @@ const Input = (0, react.forwardRef)(function Input({ id, label, type = "text", s
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EndIcon, {
 							icon: endIcon,
 							className: classNames.endIcon,
-							iconProps: slotProps?.endIcon
+							iconProps: {
+								size: endIconSize,
+								...slotProps?.endIcon
+							}
 						})
 					})
 				]

package/dist/components/client/Input/Input.js

@@ -7,6 +7,7 @@ import { HStack } from "../../HStack.js";
 import { VStack } from "../../VStack.js";
 import { usePrefersReducedMotion } from "../../../hooks/usePrefersReducedMotion.js";
 import { AnimateHeightChange } from "../AnimateHeightChange.js";
+import { useInputConfig } from "./UDSInputConfigProvider.js";
 import { InputHelpTextInternal as InputHelpTextInternalMemo } from "./InputHelpTextInternal.js";
 import { forwardRef, memo, useCallback, useEffect, useId, useImperativeHandle, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -87,6 +88,7 @@ const Input = forwardRef(function Input({ id, label, type = "text", size = "md",
 	const generatedId = useId();
 	const uid = id ?? `uds-input-${generatedId}`;
 	const helpTextId = `uds-input-${uid}-help-text`;
+	const { startIconSize, endIconSize } = useInputConfig(size);
 	const { className: inputClassName, ...inputProps } = slotProps?.input ?? {};
 	const { className: inputWrapperClassName, ...inputWrapperProps } = slotProps?.inputWrapper ?? {};
 	const ref = useRef(null);
@@ -201,7 +203,10 @@ const Input = forwardRef(function Input({ id, label, type = "text", size = "md",
 					/* @__PURE__ */ jsx(StartIcon, {
 						icon: startIcon,
 						className: classNames.startIcon,
-						iconProps: slotProps?.startIcon
+						iconProps: {
+							size: startIconSize,
+							...slotProps?.startIcon
+						}
 					}),
 					/* @__PURE__ */ jsx("input", {
 						ref,
@@ -226,7 +231,10 @@ const Input = forwardRef(function Input({ id, label, type = "text", size = "md",
 						children: /* @__PURE__ */ jsx(EndIcon, {
 							icon: endIcon,
 							className: classNames.endIcon,
-							iconProps: slotProps?.endIcon
+							iconProps: {
+								size: endIconSize,
+								...slotProps?.endIcon
+							}
 						})
 					})
 				]

package/dist/components/client/Input/InputHelpTextInternal.cjs

@@ -5,11 +5,16 @@ require("../../../_virtual/_rolldown/runtime.cjs");
 const require_styles_styler = require("../../../styles/styler.cjs");
 const require_components_IconSlot = require("../../IconSlot.cjs");
 const require_components_HStack = require("../../HStack.cjs");
+const require_components_client_Input_UDSInputConfigProvider = require("./UDSInputConfigProvider.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/components/client/Input/InputHelpTextInternal.tsx
 const InputHelpTextInternal = (0, react.forwardRef)(function InputHelpTextInternal({ startIcon, endIcon, iconProps, children, size, isFilled, slotProps, ...rest }, ref) {
-	const defaultIconProps = { variant: "outline" };
+	const { helperIconSize } = require_components_client_Input_UDSInputConfigProvider.useInputConfig(size);
+	const defaultIconProps = {
+		variant: "outline",
+		size: helperIconSize
+	};
 	const classNames = {
 		helperText: require_styles_styler.cx(require_styles_styler.getStyles({
 			inputSizeHelperText: size,

package/dist/components/client/Input/InputHelpTextInternal.js

@@ -3,11 +3,16 @@
 import { cx, getStyles } from "../../../styles/styler.js";
 import { IconSlot } from "../../IconSlot.js";
 import { HStack } from "../../HStack.js";
+import { useInputConfig } from "./UDSInputConfigProvider.js";
 import { forwardRef, memo } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/client/Input/InputHelpTextInternal.tsx
 const InputHelpTextInternal = forwardRef(function InputHelpTextInternal({ startIcon, endIcon, iconProps, children, size, isFilled, slotProps, ...rest }, ref) {
-	const defaultIconProps = { variant: "outline" };
+	const { helperIconSize } = useInputConfig(size);
+	const defaultIconProps = {
+		variant: "outline",
+		size: helperIconSize
+	};
 	const classNames = {
 		helperText: cx(getStyles({
 			inputSizeHelperText: size,

package/dist/components/client/Input/UDSInputConfigProvider.cjs

@@ -0,0 +1,33 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/components/client/Input/UDSInputConfigProvider.tsx
+const { Provider: UDSInputConfigProvider, useConfigContext } = require("../providers/createUDSConfigProvider.cjs").createUDSConfigProvider("Input");
+/**
+* Resolves the configured start/end/helper icon sizes for an Input size.
+*
+* Unlike other UDS config hooks, this hook does not require a provider: Input
+* is used in many apps without a `UDSConfigProvider`, so it gracefully falls
+* back to `undefined` for all three slots (letting `Icon` apply its own
+* default size) when no config is present — preserving the previous rendering
+* exactly.
+*/
+const useInputConfig = (sizeProp) => {
+	const context = useConfigContext();
+	if (!context) return {
+		size: sizeProp,
+		startIconSize: void 0,
+		endIconSize: void 0,
+		helperIconSize: void 0
+	};
+	const size = sizeProp ?? context.defaultSize;
+	return {
+		size,
+		startIconSize: context.startIconSize[size],
+		endIconSize: context.endIconSize[size],
+		helperIconSize: context.helperIconSize[size]
+	};
+};
+//#endregion
+exports.UDSInputConfigProvider = UDSInputConfigProvider;
+exports.useInputConfig = useInputConfig;

package/dist/components/client/Input/UDSInputConfigProvider.d.cts

@@ -0,0 +1,32 @@
+
+import { IconSize, InputSize } from "../../../types/dist/index.cjs";
+import { UDSConfigProviderProps } from "../providers/createUDSConfigProvider.cjs";
+import { UDSInputConfigContextType } from "../../../runtime/inputConfig.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Input/UDSInputConfigProvider.d.ts
+declare const UDSInputConfigProvider: {
+  ({
+    children,
+    value
+  }: UDSConfigProviderProps<UDSInputConfigContextType>): _$react_jsx_runtime0.JSX.Element;
+  displayName: string;
+};
+type UDSInputConfigProviderProps = UDSConfigProviderProps<UDSInputConfigContextType>;
+/**
+ * Resolves the configured start/end/helper icon sizes for an Input size.
+ *
+ * Unlike other UDS config hooks, this hook does not require a provider: Input
+ * is used in many apps without a `UDSConfigProvider`, so it gracefully falls
+ * back to `undefined` for all three slots (letting `Icon` apply its own
+ * default size) when no config is present — preserving the previous rendering
+ * exactly.
+ */
+declare const useInputConfig: (sizeProp?: InputSize | undefined) => {
+  size: InputSize | undefined;
+  startIconSize: IconSize | undefined;
+  endIconSize: IconSize | undefined;
+  helperIconSize: IconSize | undefined;
+};
+//#endregion
+export { type UDSInputConfigContextType, UDSInputConfigProvider, type UDSInputConfigProviderProps, useInputConfig };

package/dist/components/client/Input/UDSInputConfigProvider.d.ts

@@ -0,0 +1,33 @@
+
+"use client";
+import { IconSize, InputSize } from "../../../types/dist/index.js";
+import { UDSConfigProviderProps } from "../providers/createUDSConfigProvider.js";
+import { UDSInputConfigContextType } from "../../../runtime/inputConfig.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Input/UDSInputConfigProvider.d.ts
+declare const UDSInputConfigProvider: {
+  ({
+    children,
+    value
+  }: UDSConfigProviderProps<UDSInputConfigContextType>): _$react_jsx_runtime0.JSX.Element;
+  displayName: string;
+};
+type UDSInputConfigProviderProps = UDSConfigProviderProps<UDSInputConfigContextType>;
+/**
+ * Resolves the configured start/end/helper icon sizes for an Input size.
+ *
+ * Unlike other UDS config hooks, this hook does not require a provider: Input
+ * is used in many apps without a `UDSConfigProvider`, so it gracefully falls
+ * back to `undefined` for all three slots (letting `Icon` apply its own
+ * default size) when no config is present — preserving the previous rendering
+ * exactly.
+ */
+declare const useInputConfig: (sizeProp?: InputSize | undefined) => {
+  size: InputSize | undefined;
+  startIconSize: IconSize | undefined;
+  endIconSize: IconSize | undefined;
+  helperIconSize: IconSize | undefined;
+};
+//#endregion
+export { type UDSInputConfigContextType, UDSInputConfigProvider, type UDSInputConfigProviderProps, useInputConfig };

package/dist/components/client/Input/UDSInputConfigProvider.js

@@ -0,0 +1,32 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { createUDSConfigProvider } from "../providers/createUDSConfigProvider.js";
+//#region src/components/client/Input/UDSInputConfigProvider.tsx
+const { Provider: UDSInputConfigProvider, useConfigContext } = createUDSConfigProvider("Input");
+/**
+* Resolves the configured start/end/helper icon sizes for an Input size.
+*
+* Unlike other UDS config hooks, this hook does not require a provider: Input
+* is used in many apps without a `UDSConfigProvider`, so it gracefully falls
+* back to `undefined` for all three slots (letting `Icon` apply its own
+* default size) when no config is present — preserving the previous rendering
+* exactly.
+*/
+const useInputConfig = (sizeProp) => {
+	const context = useConfigContext();
+	if (!context) return {
+		size: sizeProp,
+		startIconSize: void 0,
+		endIconSize: void 0,
+		helperIconSize: void 0
+	};
+	const size = sizeProp ?? context.defaultSize;
+	return {
+		size,
+		startIconSize: context.startIconSize[size],
+		endIconSize: context.endIconSize[size],
+		helperIconSize: context.helperIconSize[size]
+	};
+};
+//#endregion
+export { UDSInputConfigProvider, useInputConfig };

package/dist/components/client/Input/index.cjs

@@ -1,7 +1,10 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_components_client_Input_UDSInputConfigProvider = require("./UDSInputConfigProvider.cjs");
 const require_components_client_Input_Input = require("./Input.cjs");
 const require_components_client_Input_InputHelpText = require("./InputHelpText.cjs");
 exports.Input = require_components_client_Input_Input.Input;
 exports.InputHelpText = require_components_client_Input_InputHelpText.InputHelpText;
+exports.UDSInputConfigProvider = require_components_client_Input_UDSInputConfigProvider.UDSInputConfigProvider;
+exports.useInputConfig = require_components_client_Input_UDSInputConfigProvider.useInputConfig;

package/dist/components/client/Input/index.d.cts

@@ -1,4 +1,5 @@
 
 import { Input, InputProps } from "./Input.cjs";
 import { InputHelpText, InputHelpTextProps } from "./InputHelpText.cjs";
-export { Input, InputHelpText, type InputHelpTextProps, type InputProps };
+import { UDSInputConfigProvider, UDSInputConfigProviderProps, useInputConfig } from "./UDSInputConfigProvider.cjs";
+export { Input, InputHelpText, type InputHelpTextProps, type InputProps, UDSInputConfigProvider, type UDSInputConfigProviderProps, useInputConfig };

package/dist/components/client/Input/index.d.ts

@@ -2,4 +2,5 @@
 "use client";
 import { Input, InputProps } from "./Input.js";
 import { InputHelpText, InputHelpTextProps } from "./InputHelpText.js";
-export { Input, InputHelpText, type InputHelpTextProps, type InputProps };
+import { UDSInputConfigProvider, UDSInputConfigProviderProps, useInputConfig } from "./UDSInputConfigProvider.js";
+export { Input, InputHelpText, type InputHelpTextProps, type InputProps, UDSInputConfigProvider, type UDSInputConfigProviderProps, useInputConfig };

package/dist/components/client/Input/index.js

@@ -1,5 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
+import { UDSInputConfigProvider, useInputConfig } from "./UDSInputConfigProvider.js";
 import { Input } from "./Input.js";
 import { InputHelpText } from "./InputHelpText.js";
-export { Input, InputHelpText };
+export { Input, InputHelpText, UDSInputConfigProvider, useInputConfig };

package/dist/components/client/Menu/Menu.ItemBase.cjs

@@ -6,6 +6,7 @@ const require_styles_styler = require("../../../styles/styler.cjs");
 const require_components_client_Pressable = require("../Pressable.cjs");
 const require_components_IconSlot = require("../../IconSlot.cjs");
 const require_components_HStack = require("../../HStack.cjs");
+const require_components_client_Menu_UDSMenuItemConfigProvider = require("./UDSMenuItemConfigProvider.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let motion_react = require("motion/react");
@@ -36,6 +37,7 @@ const MenuItemBase = (0, react.forwardRef)(function MenuItemBase({ spacing = "0"
 		disabled,
 		className
 	});
+	const { startIconSize, endIconSize } = require_components_client_Menu_UDSMenuItemConfigProvider.useMenuItemConfig();
 	const { className: rootClassName, ...rootSlotProps } = slotProps?.root ?? {};
 	const { className: textClassName, ...textSlotProps } = slotProps?.text ?? {};
 	const { className: startIconClassName, ...startIconSlotProps } = slotProps?.startIcon ?? {};
@@ -129,7 +131,7 @@ const MenuItemBase = (0, react.forwardRef)(function MenuItemBase({ spacing = "0"
 						icon: startIcon,
 						className: classNames.startIcon,
 						iconProps: {
-							size: "sm",
+							size: startIconSize,
 							variant: active ? "fill" : "outline",
 							color: "current",
 							...endIconSlotProps,
@@ -155,7 +157,7 @@ const MenuItemBase = (0, react.forwardRef)(function MenuItemBase({ spacing = "0"
 					icon: endIcon,
 					className: classNames.endIcon,
 					iconProps: {
-						size: "sm",
+						size: endIconSize,
 						variant: active ? "fill" : "outline",
 						color: "current"
 					}

package/dist/components/client/Menu/Menu.ItemBase.js

@@ -4,6 +4,7 @@ import { cx, getStyles } from "../../../styles/styler.js";
 import { Pressable } from "../Pressable.js";
 import { IconSlot } from "../../IconSlot.js";
 import { HStack } from "../../HStack.js";
+import { useMenuItemConfig } from "./UDSMenuItemConfigProvider.js";
 import { Children, forwardRef, useMemo } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { AnimatePresence, m } from "motion/react";
@@ -34,6 +35,7 @@ const MenuItemBase = forwardRef(function MenuItemBase({ spacing = "0", spacingBo
 		disabled,
 		className
 	});
+	const { startIconSize, endIconSize } = useMenuItemConfig();
 	const { className: rootClassName, ...rootSlotProps } = slotProps?.root ?? {};
 	const { className: textClassName, ...textSlotProps } = slotProps?.text ?? {};
 	const { className: startIconClassName, ...startIconSlotProps } = slotProps?.startIcon ?? {};
@@ -127,7 +129,7 @@ const MenuItemBase = forwardRef(function MenuItemBase({ spacing = "0", spacingBo
 						icon: startIcon,
 						className: classNames.startIcon,
 						iconProps: {
-							size: "sm",
+							size: startIconSize,
 							variant: active ? "fill" : "outline",
 							color: "current",
 							...endIconSlotProps,
@@ -153,7 +155,7 @@ const MenuItemBase = forwardRef(function MenuItemBase({ spacing = "0", spacingBo
 					icon: endIcon,
 					className: classNames.endIcon,
 					iconProps: {
-						size: "sm",
+						size: endIconSize,
 						variant: active ? "fill" : "outline",
 						color: "current"
 					}

package/dist/components/client/Menu/Menu.ItemCheckbox.d.cts

@@ -131,6 +131,6 @@ interface MenuItemCheckboxProps extends Omit<PressableProps, 'asChild'>, HtmlBut
  *
  * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
  **/
-declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "rootProps" | "hideEndIcon" | "active"> & _$react.RefAttributes<HTMLDivElement>>;
+declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & _$react.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { MenuItemCheckbox, type MenuItemCheckboxProps };

package/dist/components/client/Menu/Menu.ItemCheckbox.d.ts

@@ -132,6 +132,6 @@ interface MenuItemCheckboxProps extends Omit<PressableProps, 'asChild'>, HtmlBut
  *
  * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
  **/
-declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "rootProps" | "hideEndIcon" | "active"> & _$react.RefAttributes<HTMLDivElement>>;
+declare const MenuItemCheckbox: _$react.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & _$react.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { MenuItemCheckbox, type MenuItemCheckboxProps };

package/dist/components/client/Menu/UDSMenuItemConfigProvider.cjs

@@ -0,0 +1,30 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/components/client/Menu/UDSMenuItemConfigProvider.tsx
+const { Provider: UDSMenuItemConfigProvider, useConfigContext } = require("../providers/createUDSConfigProvider.cjs").createUDSConfigProvider("MenuItem");
+/** The icon size MenuItem hardcoded before runtime config support. */
+const menuItemFallbackIconSize = "sm";
+/**
+* Resolves the configured start/end icon sizes for MenuItem.
+*
+* Unlike other UDS config hooks, this hook does not require a provider:
+* MenuItem is used in many apps without a `UDSConfigProvider`, so it
+* gracefully falls back to the previously hardcoded icon size (`sm`) when no
+* config is present.
+*/
+const useMenuItemConfig = () => {
+	const context = useConfigContext();
+	if (!context) return {
+		startIconSize: menuItemFallbackIconSize,
+		endIconSize: menuItemFallbackIconSize
+	};
+	const size = context.defaultSize;
+	return {
+		startIconSize: context.startIconSize[size],
+		endIconSize: context.endIconSize[size]
+	};
+};
+//#endregion
+exports.UDSMenuItemConfigProvider = UDSMenuItemConfigProvider;
+exports.useMenuItemConfig = useMenuItemConfig;

package/dist/components/client/Menu/UDSMenuItemConfigProvider.d.cts

@@ -0,0 +1,29 @@
+
+import { IconSize } from "../../../types/dist/index.cjs";
+import { UDSConfigProviderProps } from "../providers/createUDSConfigProvider.cjs";
+import { UDSMenuItemConfigContextType } from "../../../runtime/menuItemConfig.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Menu/UDSMenuItemConfigProvider.d.ts
+declare const UDSMenuItemConfigProvider: {
+  ({
+    children,
+    value
+  }: UDSConfigProviderProps<UDSMenuItemConfigContextType>): _$react_jsx_runtime0.JSX.Element;
+  displayName: string;
+};
+type UDSMenuItemConfigProviderProps = UDSConfigProviderProps<UDSMenuItemConfigContextType>;
+/**
+ * Resolves the configured start/end icon sizes for MenuItem.
+ *
+ * Unlike other UDS config hooks, this hook does not require a provider:
+ * MenuItem is used in many apps without a `UDSConfigProvider`, so it
+ * gracefully falls back to the previously hardcoded icon size (`sm`) when no
+ * config is present.
+ */
+declare const useMenuItemConfig: () => {
+  startIconSize: IconSize;
+  endIconSize: IconSize;
+};
+//#endregion
+export { type UDSMenuItemConfigContextType, UDSMenuItemConfigProvider, type UDSMenuItemConfigProviderProps, useMenuItemConfig };

package/dist/components/client/Menu/UDSMenuItemConfigProvider.d.ts

@@ -0,0 +1,30 @@
+
+"use client";
+import { IconSize } from "../../../types/dist/index.js";
+import { UDSConfigProviderProps } from "../providers/createUDSConfigProvider.js";
+import { UDSMenuItemConfigContextType } from "../../../runtime/menuItemConfig.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Menu/UDSMenuItemConfigProvider.d.ts
+declare const UDSMenuItemConfigProvider: {
+  ({
+    children,
+    value
+  }: UDSConfigProviderProps<UDSMenuItemConfigContextType>): _$react_jsx_runtime0.JSX.Element;
+  displayName: string;
+};
+type UDSMenuItemConfigProviderProps = UDSConfigProviderProps<UDSMenuItemConfigContextType>;
+/**
+ * Resolves the configured start/end icon sizes for MenuItem.
+ *
+ * Unlike other UDS config hooks, this hook does not require a provider:
+ * MenuItem is used in many apps without a `UDSConfigProvider`, so it
+ * gracefully falls back to the previously hardcoded icon size (`sm`) when no
+ * config is present.
+ */
+declare const useMenuItemConfig: () => {
+  startIconSize: IconSize;
+  endIconSize: IconSize;
+};
+//#endregion
+export { type UDSMenuItemConfigContextType, UDSMenuItemConfigProvider, type UDSMenuItemConfigProviderProps, useMenuItemConfig };

package/dist/components/client/Menu/UDSMenuItemConfigProvider.js

@@ -0,0 +1,29 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { createUDSConfigProvider } from "../providers/createUDSConfigProvider.js";
+//#region src/components/client/Menu/UDSMenuItemConfigProvider.tsx
+const { Provider: UDSMenuItemConfigProvider, useConfigContext } = createUDSConfigProvider("MenuItem");
+/** The icon size MenuItem hardcoded before runtime config support. */
+const menuItemFallbackIconSize = "sm";
+/**
+* Resolves the configured start/end icon sizes for MenuItem.
+*
+* Unlike other UDS config hooks, this hook does not require a provider:
+* MenuItem is used in many apps without a `UDSConfigProvider`, so it
+* gracefully falls back to the previously hardcoded icon size (`sm`) when no
+* config is present.
+*/
+const useMenuItemConfig = () => {
+	const context = useConfigContext();
+	if (!context) return {
+		startIconSize: menuItemFallbackIconSize,
+		endIconSize: menuItemFallbackIconSize
+	};
+	const size = context.defaultSize;
+	return {
+		startIconSize: context.startIconSize[size],
+		endIconSize: context.endIconSize[size]
+	};
+};
+//#endregion
+export { UDSMenuItemConfigProvider, useMenuItemConfig };

package/dist/components/client/Menu/index.cjs

@@ -1,6 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_components_client_Menu_UDSMenuItemConfigProvider = require("./UDSMenuItemConfigProvider.cjs");
 const require_components_client_Menu_Menu_index = require("./Menu.index.cjs");
 Object.defineProperty(exports, "Menu", {
 	enumerable: true,
@@ -8,3 +9,5 @@ Object.defineProperty(exports, "Menu", {
 		return require_components_client_Menu_Menu_index.Menu_index_exports;
 	}
 });
+exports.UDSMenuItemConfigProvider = require_components_client_Menu_UDSMenuItemConfigProvider.UDSMenuItemConfigProvider;
+exports.useMenuItemConfig = require_components_client_Menu_UDSMenuItemConfigProvider.useMenuItemConfig;

package/dist/components/client/Menu/index.d.cts

@@ -6,4 +6,5 @@ import { MenuItemCheckboxProps } from "./Menu.ItemCheckbox.cjs";
 import { MenuPlacement, MenuProviderProps } from "./Menu.Provider.cjs";
 import { MenuTriggerProps } from "./Menu.Trigger.cjs";
 import { Menu_index_d_exports } from "./Menu.index.cjs";
-export { Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps };
+import { UDSMenuItemConfigProvider, UDSMenuItemConfigProviderProps, useMenuItemConfig } from "./UDSMenuItemConfigProvider.cjs";
+export { Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, UDSMenuItemConfigProvider, type UDSMenuItemConfigProviderProps, useMenuItemConfig };

package/dist/components/client/Menu/index.d.ts

@@ -7,4 +7,5 @@ import { MenuItemCheckboxProps } from "./Menu.ItemCheckbox.js";
 import { MenuPlacement, MenuProviderProps } from "./Menu.Provider.js";
 import { MenuTriggerProps } from "./Menu.Trigger.js";
 import { Menu_index_d_exports } from "./Menu.index.js";
-export { Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps };
+import { UDSMenuItemConfigProvider, UDSMenuItemConfigProviderProps, useMenuItemConfig } from "./UDSMenuItemConfigProvider.js";
+export { Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, UDSMenuItemConfigProvider, type UDSMenuItemConfigProviderProps, useMenuItemConfig };

package/dist/components/client/Menu/index.js

@@ -1,4 +1,5 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
+import { UDSMenuItemConfigProvider, useMenuItemConfig } from "./UDSMenuItemConfigProvider.js";
 import { Menu_index_exports } from "./Menu.index.js";
-export { Menu_index_exports as Menu };
+export { Menu_index_exports as Menu, UDSMenuItemConfigProvider, useMenuItemConfig };

package/dist/components/client/PaddleNav/PaddleButton.cjs

@@ -6,11 +6,13 @@ const require_styles_styler = require("../../../styles/styler.cjs");
 const require_components_Icon = require("../../Icon.cjs");
 const require_components_client_PaddleNav_paddleButtonIcons = require("./paddleButtonIcons.cjs");
 const require_components_client_PaddleNav_paddleNavContext = require("./paddleNavContext.cjs");
+const require_components_client_PaddleNav_UDSPaddleNavConfigProvider = require("./UDSPaddleNavConfigProvider.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/components/client/PaddleNav/PaddleButton.tsx
 const PaddleButton = (0, react.forwardRef)(function PaddleButton({ onClick, disabled = false, hidden = false, icon, paddleRole, className, ...rest }, ref) {
 	const { variant, size, orientation, registerPaddleHidden } = require_components_client_PaddleNav_paddleNavContext.usePaddleNavContext();
+	const { iconSize } = require_components_client_PaddleNav_UDSPaddleNavConfigProvider.usePaddleNavConfig(size);
 	(0, react.useLayoutEffect)(() => {
 		registerPaddleHidden(paddleRole, hidden);
 		return () => registerPaddleHidden(paddleRole, false);
@@ -39,7 +41,7 @@ const PaddleButton = (0, react.forwardRef)(function PaddleButton({ onClick, disa
 			"aria-hidden": true,
 			className: require_styles_styler.cx("absolute inset-0 -z-10 pointer-events-none rounded-[var(--uds-nested-radius)]", "transition-[background-color,opacity] duration-[180ms] ease-[cubic-bezier(0,0,0.2,1)]", backgroundClass)
 		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_Icon.Icon, {
-			size: "md",
+			size: iconSize,
 			name: resolvedIcon,
 			color: "current",
 			className: require_styles_styler.cx(iconSizeClass, iconVariantClass)

package/dist/components/client/PaddleNav/PaddleButton.js

@@ -4,11 +4,13 @@ import { cx, getStyles } from "../../../styles/styler.js";
 import { Icon } from "../../Icon.js";
 import { pickDefaultPaddleIcon } from "./paddleButtonIcons.js";
 import { usePaddleNavContext } from "./paddleNavContext.js";
+import { usePaddleNavConfig } from "./UDSPaddleNavConfigProvider.js";
 import { forwardRef, useLayoutEffect, useMemo } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/client/PaddleNav/PaddleButton.tsx
 const PaddleButton = forwardRef(function PaddleButton({ onClick, disabled = false, hidden = false, icon, paddleRole, className, ...rest }, ref) {
 	const { variant, size, orientation, registerPaddleHidden } = usePaddleNavContext();
+	const { iconSize } = usePaddleNavConfig(size);
 	useLayoutEffect(() => {
 		registerPaddleHidden(paddleRole, hidden);
 		return () => registerPaddleHidden(paddleRole, false);
@@ -37,7 +39,7 @@ const PaddleButton = forwardRef(function PaddleButton({ onClick, disabled = fals
 			"aria-hidden": true,
 			className: cx("absolute inset-0 -z-10 pointer-events-none rounded-[var(--uds-nested-radius)]", "transition-[background-color,opacity] duration-[180ms] ease-[cubic-bezier(0,0,0.2,1)]", backgroundClass)
 		}), /* @__PURE__ */ jsx(Icon, {
-			size: "md",
+			size: iconSize,
 			name: resolvedIcon,
 			color: "current",
 			className: cx(iconSizeClass, iconVariantClass)