@yahoo/uds 3.66.1 → 3.67.0-beta.2

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

@@ -0,0 +1,92 @@
+import { UniversalMenuItemProps } from "../../../tokens/types.cjs";
+import "../../../tokens/index.cjs";
+import { PressableProps } from "../Pressable.cjs";
+import * as react39 from "react";
+import { HTMLAttributes } from "react";
+import { MenuItemCheckboxProps as MenuItemCheckboxProps$1 } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.ItemCheckbox.d.ts
+type HtmlButtonProps = HTMLAttributes<HTMLButtonElement>;
+interface MenuItemCheckboxProps extends Omit<PressableProps, 'asChild'>, HtmlButtonProps, UniversalMenuItemProps {
+  /**
+   * The name of the field in the
+   * [`values`](https://ariakit.org/reference/menu-provider#values) state.
+   *
+   * Live examples at [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
+   */
+  name: string;
+  /**
+   * The controlled checked state of the element. It will set the menu
+   * [`values`](https://ariakit.org/reference/menu-provider#values) state if
+   * provided.
+   */
+  checked?: boolean;
+  /**
+   * The default checked state of the element. It will set the default value in
+   * the menu [`values`](https://ariakit.org/reference/menu-provider#values)
+   * state if provided.
+   */
+  defaultChecked?: boolean;
+  /**
+   * Object returned by the [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook.
+   * If not provided, the closest [`Menu.Content`](https://uds.build/docs/components/menu#menu-content) or
+   * [`Menu.Provider`](https://uds.build/docs/components/menu#menu-provider) context will be used.
+   */
+  store?: MenuItemCheckboxProps$1['store'];
+  /**
+   * Determines if the menu should hide when this item is clicked.
+   *
+   * **Note**: This behavior isn't triggered if this menu item is rendered as a
+   * link and modifier keys are used to either open the link in a new tab or
+   * download it.
+   *
+   * @default undefined
+   */
+  hideOnClick?: MenuItemCheckboxProps$1['hideOnClick'];
+}
+/**
+ * **✅ A Menu Item Checkbox component**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * A checkable menu item that toggles between selected and unselected states. Menu item checkboxes
+ * allow users to select multiple options from a menu, displaying a checkmark when active. They maintain
+ * their state even when the menu is closed and reopened.
+ *
+ * @see The {@link https://uds.build/docs/components/menu-item-checkbox Menu.ItemCheckbox Docs} for more info
+ *
+ * @example
+ * ```tsx
+ * 'use client'; // Next.js client component
+ *
+ * import { Menu, Button } from "@yahoo/uds";
+ *
+ * export function MenuItemCheckboxExample() {
+ *   return (
+ *     <Menu.Provider>
+ *       <Menu.Trigger asChild>
+ *         <Button>Filter Options</Button>
+ *       </Menu.Trigger>
+ *       <Menu.Content>
+ *         <Menu.ItemCheckbox name="showArchived" defaultChecked={false}>
+ *           Show Archived
+ *         </Menu.ItemCheckbox>
+ *         <Menu.ItemCheckbox name="includeComments" defaultChecked={true}>
+ *           Include Comments
+ *         </Menu.ItemCheckbox>
+ *       </Menu.Content>
+ *     </Menu.Provider>
+ *   )
+ * }
+ * ```
+ *
+ * @usage
+ * Use MenuItemCheckbox when you need to provide users with multiple selectable options within a menu.
+ * Unlike radio options, checkboxes allow for multiple simultaneous selections.
+ *
+ * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
+ **/
+declare const MenuItemCheckbox: react39.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & react39.RefAttributes<HTMLDivElement>>;
+//#endregion
+export { MenuItemCheckbox, type MenuItemCheckboxProps };

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

@@ -0,0 +1,92 @@
+import { UniversalMenuItemProps } from "../../../tokens/types.js";
+import "../../../tokens/index.js";
+import { PressableProps } from "../Pressable.js";
+import * as react49 from "react";
+import { HTMLAttributes } from "react";
+import { MenuItemCheckboxProps as MenuItemCheckboxProps$1 } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.ItemCheckbox.d.ts
+type HtmlButtonProps = HTMLAttributes<HTMLButtonElement>;
+interface MenuItemCheckboxProps extends Omit<PressableProps, 'asChild'>, HtmlButtonProps, UniversalMenuItemProps {
+  /**
+   * The name of the field in the
+   * [`values`](https://ariakit.org/reference/menu-provider#values) state.
+   *
+   * Live examples at [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
+   */
+  name: string;
+  /**
+   * The controlled checked state of the element. It will set the menu
+   * [`values`](https://ariakit.org/reference/menu-provider#values) state if
+   * provided.
+   */
+  checked?: boolean;
+  /**
+   * The default checked state of the element. It will set the default value in
+   * the menu [`values`](https://ariakit.org/reference/menu-provider#values)
+   * state if provided.
+   */
+  defaultChecked?: boolean;
+  /**
+   * Object returned by the [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook.
+   * If not provided, the closest [`Menu.Content`](https://uds.build/docs/components/menu#menu-content) or
+   * [`Menu.Provider`](https://uds.build/docs/components/menu#menu-provider) context will be used.
+   */
+  store?: MenuItemCheckboxProps$1['store'];
+  /**
+   * Determines if the menu should hide when this item is clicked.
+   *
+   * **Note**: This behavior isn't triggered if this menu item is rendered as a
+   * link and modifier keys are used to either open the link in a new tab or
+   * download it.
+   *
+   * @default undefined
+   */
+  hideOnClick?: MenuItemCheckboxProps$1['hideOnClick'];
+}
+/**
+ * **✅ A Menu Item Checkbox component**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * A checkable menu item that toggles between selected and unselected states. Menu item checkboxes
+ * allow users to select multiple options from a menu, displaying a checkmark when active. They maintain
+ * their state even when the menu is closed and reopened.
+ *
+ * @see The {@link https://uds.build/docs/components/menu-item-checkbox Menu.ItemCheckbox Docs} for more info
+ *
+ * @example
+ * ```tsx
+ * 'use client'; // Next.js client component
+ *
+ * import { Menu, Button } from "@yahoo/uds";
+ *
+ * export function MenuItemCheckboxExample() {
+ *   return (
+ *     <Menu.Provider>
+ *       <Menu.Trigger asChild>
+ *         <Button>Filter Options</Button>
+ *       </Menu.Trigger>
+ *       <Menu.Content>
+ *         <Menu.ItemCheckbox name="showArchived" defaultChecked={false}>
+ *           Show Archived
+ *         </Menu.ItemCheckbox>
+ *         <Menu.ItemCheckbox name="includeComments" defaultChecked={true}>
+ *           Include Comments
+ *         </Menu.ItemCheckbox>
+ *       </Menu.Content>
+ *     </Menu.Provider>
+ *   )
+ * }
+ * ```
+ *
+ * @usage
+ * Use MenuItemCheckbox when you need to provide users with multiple selectable options within a menu.
+ * Unlike radio options, checkboxes allow for multiple simultaneous selections.
+ *
+ * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
+ **/
+declare const MenuItemCheckbox: react49.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & react49.RefAttributes<HTMLDivElement>>;
+//#endregion
+export { MenuItemCheckbox, type MenuItemCheckboxProps };

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

@@ -0,0 +1,137 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { cx, getStyles } from "../../../styles/styler.js";
+import { MenuItemBase } from "./Menu.ItemBase.js";
+import { forwardRef, useCallback, useEffect, useMemo, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+import { Check } from "@yahoo/uds-icons";
+import { useStoreState } from "@ariakit/react";
+import { MenuItemCheckbox as MenuItemCheckbox$2, useMenuContext } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.ItemCheckbox.tsx
+/**
+* **✅ A Menu Item Checkbox component**
+*
+* @componentType Client component
+*
+* @description
+* A checkable menu item that toggles between selected and unselected states. Menu item checkboxes
+* allow users to select multiple options from a menu, displaying a checkmark when active. They maintain
+* their state even when the menu is closed and reopened.
+*
+* @see The {@link https://uds.build/docs/components/menu-item-checkbox Menu.ItemCheckbox Docs} for more info
+*
+* @example
+* ```tsx
+* 'use client'; // Next.js client component
+*
+* import { Menu, Button } from "@yahoo/uds";
+*
+* export function MenuItemCheckboxExample() {
+*   return (
+*     <Menu.Provider>
+*       <Menu.Trigger asChild>
+*         <Button>Filter Options</Button>
+*       </Menu.Trigger>
+*       <Menu.Content>
+*         <Menu.ItemCheckbox name="showArchived" defaultChecked={false}>
+*           Show Archived
+*         </Menu.ItemCheckbox>
+*         <Menu.ItemCheckbox name="includeComments" defaultChecked={true}>
+*           Include Comments
+*         </Menu.ItemCheckbox>
+*       </Menu.Content>
+*     </Menu.Provider>
+*   )
+* }
+* ```
+*
+* @usage
+* Use MenuItemCheckbox when you need to provide users with multiple selectable options within a menu.
+* Unlike radio options, checkboxes allow for multiple simultaneous selections.
+*
+* @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)
+**/
+const MenuItemCheckbox = forwardRef(function MenuItemCheckbox$3({ name, endIcon = Check, checked, defaultChecked, hideOnClick, className, ...props }, ref) {
+	const itemName = name;
+	const hasInitialized = useRef(false);
+	const context = useMenuContext();
+	const allState = useStoreState(context);
+	useEffect(() => {
+		if (!hasInitialized.current && defaultChecked !== void 0 && context) {
+			context.setValues((prev) => ({
+				...prev,
+				[itemName]: defaultChecked
+			}));
+			hasInitialized.current = true;
+		}
+	}, [
+		context,
+		defaultChecked,
+		itemName
+	]);
+	const isChecked = useMemo(() => {
+		if (checked !== void 0) return checked;
+		if (allState?.items?.length) {
+			const item = allState?.items.find((item$1) => item$1.element?.name === itemName);
+			if (item?.element) return item.element.checked;
+		}
+		const storeValue = allState?.values[itemName];
+		return typeof storeValue === "boolean" ? storeValue : defaultChecked ?? false;
+	}, [
+		allState?.items,
+		allState?.values,
+		itemName,
+		checked,
+		defaultChecked
+	]);
+	const handleChange = useCallback((d) => {
+		if (checked === void 0) context?.setValues((prev) => ({
+			...prev,
+			[itemName]: d.target.checked
+		}));
+	}, [
+		itemName,
+		context,
+		checked
+	]);
+	const layerClassNames = {
+		root: getStyles({
+			menuItemCheckboxVariantRoot: "default",
+			menuItemCheckboxVariantActiveRoot: isChecked ? "on" : "off"
+		}),
+		text: getStyles({
+			menuItemCheckboxVariantText: "default",
+			menuItemCheckboxVariantActiveText: isChecked ? "on" : "off"
+		}),
+		startIcon: getStyles({
+			menuItemCheckboxVariantStartIcon: "default",
+			menuItemCheckboxVariantActiveStartIcon: isChecked ? "on" : "off"
+		}),
+		endIcon: getStyles({
+			menuItemCheckboxVariantEndIcon: "default",
+			menuItemCheckboxVariantActiveEndIcon: isChecked ? "on" : "off"
+		})
+	};
+	return /* @__PURE__ */ jsx(MenuItemBase, {
+		ref,
+		as: MenuItemCheckbox$2,
+		hideEndIcon: !isChecked,
+		endIcon,
+		active: isChecked,
+		className: cx("uds-menu-item-checkbox", className),
+		layerClassNames,
+		name,
+		rootProps: {
+			onChange: handleChange,
+			defaultChecked,
+			checked: checked !== void 0 ? checked : void 0,
+			hideOnClick
+		},
+		...props
+	});
+});
+MenuItemCheckbox.displayName = "MenuItemCheckbox";
+
+//#endregion
+export { MenuItemCheckbox };

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

@@ -0,0 +1,63 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_components_client_SpringMotionConfig = require('../SpringMotionConfig.cjs');
+const require_hooks_useRtl = require('../../../hooks/useRtl.cjs');
+const require_components_client_Menu_utils_transformAriakitPlacement = require('./utils/transformAriakitPlacement.cjs');
+let react_jsx_runtime = require("react/jsx-runtime");
+let __ariakit_react_menu = require("@ariakit/react/menu");
+
+//#region src/components/client/Menu/Menu.Provider.tsx
+/**
+* **🏗️ A Menu Provider component**
+*
+* @componentType Server component
+*
+* @description
+* A provider component for the menu, which is used to provide the menu context to the menu items.
+*
+* @see The {@link https://uds.build/docs/components/menu-provider Menu.Provider Docs} for more info
+*
+* @example
+* ```tsx
+* 'use client'; // Next.js client component
+*
+* import { Menu, Button } from "@yahoo/uds";
+* import { Calendar, Clipboard } from "@yahoo/uds-icons";
+*
+* export function MenuProviderExample() {
+*   return (
+*     <Menu.Provider>
+*       <Menu.Trigger asChild>
+*         <Button>Menu Options</Button>
+*       </Menu.Trigger>
+*       <Menu.Content>
+*         <Menu.Item startIcon={Calendar}>Calendar</Menu.Item>
+*         <Menu.Item startIcon={Clipboard} endIcon={DiagonalRightUp}>
+*           Clipboard
+*         </Menu.Item>
+*         <Menu.Item active>Active Item</Menu.Item>
+*       </Menu.Content>
+*     </Menu.Provider>
+*   )
+* }
+* ```
+*
+* @usage
+* Use MenuItem for standard menu options that trigger actions or navigate to other parts of the application.
+* The active prop can be used to highlight the currently selected item.
+*
+* @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+**/
+const MenuProvider = function MenuProvider$1({ placement = "bottom", rtl: explicitRtl, ...props }) {
+	const isRtl = require_hooks_useRtl.useRtl({ explicit: explicitRtl });
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_SpringMotionConfig.SpringMotionConfig, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__ariakit_react_menu.MenuProvider, {
+		placement: require_components_client_Menu_utils_transformAriakitPlacement.transformAriakitPlacement(placement, { rtl: isRtl }),
+		rtl: isRtl,
+		...props
+	}) });
+};
+MenuProvider.displayName = "MenuProvider";
+
+//#endregion
+exports.MenuProvider = MenuProvider;

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

@@ -0,0 +1,137 @@
+import { PropsWithChildren } from "react";
+import * as react_jsx_runtime11 from "react/jsx-runtime";
+import { MenuProviderProps as MenuProviderProps$1 } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.Provider.d.ts
+/** Valid vertical placement values for the menu */
+type VerticalPlacement = 'top' | 'bottom';
+/** Valid horizontal placement values for the menu */
+type HorizontalPlacement = 'start' | 'end';
+/** Combined placement values for menu positioning */
+type MenuPlacement = VerticalPlacement | HorizontalPlacement | `${VerticalPlacement}-${HorizontalPlacement}` | `${HorizontalPlacement}-${VerticalPlacement}`;
+type MenuProviderProps = PropsWithChildren<{
+  /**
+   * A callback that gets called when the
+   * [`values`](https://ariakit.org/reference/menu-provider#values) state
+   * changes.
+   *
+   * Live examples:
+   * - [`MenuItemCheckbox`](https://uds.build/docs/components/menu-item-checkbox).
+   */
+  setValues?: (values: Record<string, boolean>) => void | MenuProviderProps$1['setValues'];
+  /**
+   * A map of names and values that will be used by the
+   * [`MenuItemCheckbox`](https://uds.build/docs/components/menu-item-checkbox).
+   *
+   * Live examples:
+   * - [MenuItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+   */
+  values?: MenuProviderProps$1['values'];
+  /**
+   * The placement of the Menu.Content.
+   *
+   * @default 'bottom'
+   */
+  placement?: MenuPlacement;
+  /**
+   * Object returned by the [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook.
+   * If not provided, the closest [`Menu.Content`](https://uds.build/docs/components/menu#menu-content) or
+   * [`Menu.Provider`](https://uds.build/docs/components/menu#menu-provider) context will be used.
+   */
+  store?: MenuProviderProps$1['store'];
+  /**
+   * Whether the menu should be rendered in RTL direction.
+   *
+   * This only affects the some component behavior behavior. You still need to set
+   * `dir="rtl"` on HTML/CSS.
+   * @default false
+   */
+  rtl?: MenuProviderProps$1['rtl'];
+  /**
+   * Whether the content is visible.
+   * @default false
+   */
+  open?: MenuProviderProps$1['open'];
+  /**
+   * A callback that gets called when the
+   * [`open`](https://ariakit.org/reference/disclosure-provider#open) state
+   * changes.
+   * @example
+   * const [open, setOpen] = useState(false);
+   * const disclosure = useDisclosureStore({ open, setOpen });
+   */
+  setOpen?: MenuProviderProps$1['setOpen'];
+  /**
+   * Whether the content should be visible by default.
+   * @default false
+   */
+  defaultOpen?: MenuProviderProps$1['defaultOpen'];
+  /**
+   * Determines how the focus behaves when the user reaches the end of the
+   * composite widget.
+   *
+   * Live examples:
+   * - [Command Menu](https://uds.build/docs/components/menu)
+   * @default false
+   */
+  focusLoop?: MenuProviderProps$1['focusLoop'];
+  /**
+   * If enabled, moving to the next item from the last one in a row or column
+   * will focus on the first item in the next row or column and vice-versa.
+   * `true` wraps between rows and columns, `horizontal` wraps only between rows, and `vertical` wraps only between columns.
+   *
+   * @default false
+   */
+  focusWrap?: MenuProviderProps$1['focusWrap'];
+}>;
+/**
+ * **🏗️ A Menu Provider component**
+ *
+ * @componentType Server component
+ *
+ * @description
+ * A provider component for the menu, which is used to provide the menu context to the menu items.
+ *
+ * @see The {@link https://uds.build/docs/components/menu-provider Menu.Provider Docs} for more info
+ *
+ * @example
+ * ```tsx
+ * 'use client'; // Next.js client component
+ *
+ * import { Menu, Button } from "@yahoo/uds";
+ * import { Calendar, Clipboard } from "@yahoo/uds-icons";
+ *
+ * export function MenuProviderExample() {
+ *   return (
+ *     <Menu.Provider>
+ *       <Menu.Trigger asChild>
+ *         <Button>Menu Options</Button>
+ *       </Menu.Trigger>
+ *       <Menu.Content>
+ *         <Menu.Item startIcon={Calendar}>Calendar</Menu.Item>
+ *         <Menu.Item startIcon={Clipboard} endIcon={DiagonalRightUp}>
+ *           Clipboard
+ *         </Menu.Item>
+ *         <Menu.Item active>Active Item</Menu.Item>
+ *       </Menu.Content>
+ *     </Menu.Provider>
+ *   )
+ * }
+ * ```
+ *
+ * @usage
+ * Use MenuItem for standard menu options that trigger actions or navigate to other parts of the application.
+ * The active prop can be used to highlight the currently selected item.
+ *
+ * @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+ **/
+declare const MenuProvider: {
+  ({
+    placement,
+    rtl: explicitRtl,
+    ...props
+  }: MenuProviderProps): react_jsx_runtime11.JSX.Element;
+  displayName: string;
+};
+//#endregion
+export { type MenuPlacement, MenuProvider, type MenuProviderProps };

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

@@ -0,0 +1,137 @@
+import { PropsWithChildren } from "react";
+import * as react_jsx_runtime13 from "react/jsx-runtime";
+import { MenuProviderProps as MenuProviderProps$1 } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.Provider.d.ts
+/** Valid vertical placement values for the menu */
+type VerticalPlacement = 'top' | 'bottom';
+/** Valid horizontal placement values for the menu */
+type HorizontalPlacement = 'start' | 'end';
+/** Combined placement values for menu positioning */
+type MenuPlacement = VerticalPlacement | HorizontalPlacement | `${VerticalPlacement}-${HorizontalPlacement}` | `${HorizontalPlacement}-${VerticalPlacement}`;
+type MenuProviderProps = PropsWithChildren<{
+  /**
+   * A callback that gets called when the
+   * [`values`](https://ariakit.org/reference/menu-provider#values) state
+   * changes.
+   *
+   * Live examples:
+   * - [`MenuItemCheckbox`](https://uds.build/docs/components/menu-item-checkbox).
+   */
+  setValues?: (values: Record<string, boolean>) => void | MenuProviderProps$1['setValues'];
+  /**
+   * A map of names and values that will be used by the
+   * [`MenuItemCheckbox`](https://uds.build/docs/components/menu-item-checkbox).
+   *
+   * Live examples:
+   * - [MenuItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+   */
+  values?: MenuProviderProps$1['values'];
+  /**
+   * The placement of the Menu.Content.
+   *
+   * @default 'bottom'
+   */
+  placement?: MenuPlacement;
+  /**
+   * Object returned by the [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook.
+   * If not provided, the closest [`Menu.Content`](https://uds.build/docs/components/menu#menu-content) or
+   * [`Menu.Provider`](https://uds.build/docs/components/menu#menu-provider) context will be used.
+   */
+  store?: MenuProviderProps$1['store'];
+  /**
+   * Whether the menu should be rendered in RTL direction.
+   *
+   * This only affects the some component behavior behavior. You still need to set
+   * `dir="rtl"` on HTML/CSS.
+   * @default false
+   */
+  rtl?: MenuProviderProps$1['rtl'];
+  /**
+   * Whether the content is visible.
+   * @default false
+   */
+  open?: MenuProviderProps$1['open'];
+  /**
+   * A callback that gets called when the
+   * [`open`](https://ariakit.org/reference/disclosure-provider#open) state
+   * changes.
+   * @example
+   * const [open, setOpen] = useState(false);
+   * const disclosure = useDisclosureStore({ open, setOpen });
+   */
+  setOpen?: MenuProviderProps$1['setOpen'];
+  /**
+   * Whether the content should be visible by default.
+   * @default false
+   */
+  defaultOpen?: MenuProviderProps$1['defaultOpen'];
+  /**
+   * Determines how the focus behaves when the user reaches the end of the
+   * composite widget.
+   *
+   * Live examples:
+   * - [Command Menu](https://uds.build/docs/components/menu)
+   * @default false
+   */
+  focusLoop?: MenuProviderProps$1['focusLoop'];
+  /**
+   * If enabled, moving to the next item from the last one in a row or column
+   * will focus on the first item in the next row or column and vice-versa.
+   * `true` wraps between rows and columns, `horizontal` wraps only between rows, and `vertical` wraps only between columns.
+   *
+   * @default false
+   */
+  focusWrap?: MenuProviderProps$1['focusWrap'];
+}>;
+/**
+ * **🏗️ A Menu Provider component**
+ *
+ * @componentType Server component
+ *
+ * @description
+ * A provider component for the menu, which is used to provide the menu context to the menu items.
+ *
+ * @see The {@link https://uds.build/docs/components/menu-provider Menu.Provider Docs} for more info
+ *
+ * @example
+ * ```tsx
+ * 'use client'; // Next.js client component
+ *
+ * import { Menu, Button } from "@yahoo/uds";
+ * import { Calendar, Clipboard } from "@yahoo/uds-icons";
+ *
+ * export function MenuProviderExample() {
+ *   return (
+ *     <Menu.Provider>
+ *       <Menu.Trigger asChild>
+ *         <Button>Menu Options</Button>
+ *       </Menu.Trigger>
+ *       <Menu.Content>
+ *         <Menu.Item startIcon={Calendar}>Calendar</Menu.Item>
+ *         <Menu.Item startIcon={Clipboard} endIcon={DiagonalRightUp}>
+ *           Clipboard
+ *         </Menu.Item>
+ *         <Menu.Item active>Active Item</Menu.Item>
+ *       </Menu.Content>
+ *     </Menu.Provider>
+ *   )
+ * }
+ * ```
+ *
+ * @usage
+ * Use MenuItem for standard menu options that trigger actions or navigate to other parts of the application.
+ * The active prop can be used to highlight the currently selected item.
+ *
+ * @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+ **/
+declare const MenuProvider: {
+  ({
+    placement,
+    rtl: explicitRtl,
+    ...props
+  }: MenuProviderProps): react_jsx_runtime13.JSX.Element;
+  displayName: string;
+};
+//#endregion
+export { type MenuPlacement, MenuProvider, type MenuProviderProps };