@yahoo/uds 3.58.2-beta.1 → 3.59.0-beta.1

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

@@ -0,0 +1,93 @@
+import { UniversalMenuItemProps } from "../../../tokens/types.js";
+import "../../../tokens/index.js";
+import { PressableProps } from "../Pressable.js";
+import * as react51 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: react51.ForwardRefExoticComponent<Omit<MenuItemCheckboxProps, "active" | "hideEndIcon" | "rootProps"> & react51.RefAttributes<HTMLDivElement>>;
+//#endregion
+export { MenuItemCheckbox, type MenuItemCheckboxProps };
+//# sourceMappingURL=Menu.ItemCheckbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.ItemCheckbox.d.ts","names":[],"sources":["../../../../src/components/client/Menu/Menu.ItemCheckbox.tsx"],"sourcesContent":[],"mappings":";;;;;;;;KAYK,eAAA,CAAA,CAAA,CAAkB,eAAe;UAE5B,qBAAA,CAAA,OAAA,CACA,KAAK,4BACX,iBACA;;;AAR+C,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,OAAA,CAAA,GAAA,CAAA,SAAA,CAAA,IAAA,CAAA,QAAA,CAAA,MAAA,CAAA,CAAA,KAAA;AAGd,CAAA,CAAA,CAAA;;;EAwCrB,IAAA,CAAA,CAAA,MAAA;EArCN,CAAA,CAAA;;;;AAEgB,CAAA,CAAA,CAAA,CAAA;EAiFJ,OAAA,CAAA,CAAA,CAAA,OAAA;EAAA,CAAA,CAAA;;;;;;;;;;;UAxDZ,qBAAA,CAAA;;;;;;;;;;gBAUM,qBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8CV,kBAAgB,OAAA,CAAA,0BAAA,KAAA,iEAAA,OAAA,CAAA,cAAA"}

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

@@ -0,0 +1,138 @@
+"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 { MenuItemCheckbox as MenuItemCheckbox$1, useMenuContext } from "@ariakit/react/menu";
+import { useStoreState } from "@ariakit/react";
+
+//#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$1,
+		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 };
+//# sourceMappingURL=Menu.ItemCheckbox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.ItemCheckbox.js","names":["MenuItemCheckbox","item","AriakitMenuItemCheckbox"],"sources":["../../../../src/components/client/Menu/Menu.ItemCheckbox.tsx"],"sourcesContent":["import { useStoreState } from '@ariakit/react';\nimport type { MenuItemCheckboxProps as AriakitMenuItemCheckboxProps } from '@ariakit/react/menu';\nimport { MenuItemCheckbox as AriakitMenuItemCheckbox, useMenuContext } from '@ariakit/react/menu';\nimport type { UniversalMenuItemProps } from '@yahoo/uds/tokens';\nimport { Check } from '@yahoo/uds-icons';\nimport type { ChangeEvent, HTMLAttributes } from 'react';\nimport { forwardRef, useCallback, useEffect, useMemo, useRef } from 'react';\n\nimport { cx, getStyles } from '../../../styles/styler';\nimport type { PressableProps } from '../Pressable';\nimport { MenuItemBase } from './Menu.ItemBase';\n\ntype HtmlButtonProps = HTMLAttributes<HTMLButtonElement>;\n\ninterface MenuItemCheckboxProps\n  extends Omit<PressableProps, 'asChild'>,\n    HtmlButtonProps,\n    UniversalMenuItemProps {\n  /**\n   * The name of the field in the\n   * [`values`](https://ariakit.org/reference/menu-provider#values) state.\n   *\n   * Live examples at [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)\n   */\n  name: string;\n  /**\n   * The controlled checked state of the element. It will set the menu\n   * [`values`](https://ariakit.org/reference/menu-provider#values) state if\n   * provided.\n   */\n  checked?: boolean;\n  /**\n   * The default checked state of the element. It will set the default value in\n   * the menu [`values`](https://ariakit.org/reference/menu-provider#values)\n   * state if provided.\n   */\n  defaultChecked?: boolean;\n  /**\n   * Object returned by the [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook.\n   * If not provided, the closest [`Menu.Content`](https://uds.build/docs/components/menu#menu-content) or\n   * [`Menu.Provider`](https://uds.build/docs/components/menu#menu-provider) context will be used.\n   */\n  store?: AriakitMenuItemCheckboxProps['store'];\n  /**\n   * Determines if the menu should hide when this item is clicked.\n   *\n   * **Note**: This behavior isn't triggered if this menu item is rendered as a\n   * link and modifier keys are used to either open the link in a new tab or\n   * download it.\n   *\n   * @default undefined\n   */\n  hideOnClick?: AriakitMenuItemCheckboxProps['hideOnClick'];\n}\n\n/**\n * **✅ A Menu Item Checkbox component**\n *\n * @componentType Client component\n *\n * @description\n * A checkable menu item that toggles between selected and unselected states. Menu item checkboxes\n * allow users to select multiple options from a menu, displaying a checkmark when active. They maintain\n * their state even when the menu is closed and reopened.\n *\n * @see The {@link https://uds.build/docs/components/menu-item-checkbox Menu.ItemCheckbox Docs} for more info\n *\n * @example\n * ```tsx\n * 'use client'; // Next.js client component\n *\n * import { Menu, Button } from \"@yahoo/uds\";\n *\n * export function MenuItemCheckboxExample() {\n *   return (\n *     <Menu.Provider>\n *       <Menu.Trigger asChild>\n *         <Button>Filter Options</Button>\n *       </Menu.Trigger>\n *       <Menu.Content>\n *         <Menu.ItemCheckbox name=\"showArchived\" defaultChecked={false}>\n *           Show Archived\n *         </Menu.ItemCheckbox>\n *         <Menu.ItemCheckbox name=\"includeComments\" defaultChecked={true}>\n *           Include Comments\n *         </Menu.ItemCheckbox>\n *       </Menu.Content>\n *     </Menu.Provider>\n *   )\n * }\n * ```\n *\n * @usage\n * Use MenuItemCheckbox when you need to provide users with multiple selectable options within a menu.\n * Unlike radio options, checkboxes allow for multiple simultaneous selections.\n *\n * @related [Menu](https://uds.build/docs/components/menu), [Menu.Item](https://uds.build/docs/components/menu-item)\n **/\nconst MenuItemCheckbox = forwardRef<\n  HTMLDivElement,\n  Omit<MenuItemCheckboxProps, 'rootProps' | 'hideEndIcon' | 'active'>\n>(function MenuItemCheckbox(\n  { name, endIcon = Check, checked, defaultChecked, hideOnClick, className, ...props },\n  ref,\n) {\n  const itemName = name;\n  const hasInitialized = useRef(false);\n\n  // Connect to the menu store\n  const context = useMenuContext();\n  const allState = useStoreState(context);\n\n  // Initialize default value in menu store if provided\n  useEffect(() => {\n    if (!hasInitialized.current && defaultChecked !== undefined && context) {\n      context.setValues((prev) => ({ ...prev, [itemName]: defaultChecked }));\n      hasInitialized.current = true;\n    }\n  }, [context, defaultChecked, itemName]);\n\n  // Get checked state from the menu store\n  const isChecked = useMemo(() => {\n    // If controlled, use the checked prop\n    if (checked !== undefined) {\n      return checked;\n    }\n\n    // Check DOM element state first\n    if (allState?.items?.length) {\n      const item = allState?.items.find(\n        (item) => (item.element as HTMLInputElement)?.name === itemName,\n      );\n\n      if (item?.element) {\n        return (item.element as HTMLInputElement).checked;\n      }\n    }\n\n    // Fall back to store value or default\n    const storeValue = allState?.values[itemName];\n    return typeof storeValue === 'boolean' ? storeValue : (defaultChecked ?? false);\n  }, [allState?.items, allState?.values, itemName, checked, defaultChecked]);\n\n  // Update the menu store when the checkbox is interacted with\n  const handleChange = useCallback(\n    (d: ChangeEvent<HTMLInputElement>) => {\n      // Only update store if not controlled\n      if (checked === undefined) {\n        context?.setValues((prev) => ({ ...prev, [itemName]: d.target.checked }));\n      }\n    },\n    [itemName, context, checked],\n  );\n\n  const layerClassNames = {\n    root: getStyles({\n      menuItemCheckboxVariantRoot: 'default',\n      menuItemCheckboxVariantActiveRoot: isChecked ? 'on' : 'off',\n    }),\n    text: getStyles({\n      menuItemCheckboxVariantText: 'default',\n      menuItemCheckboxVariantActiveText: isChecked ? 'on' : 'off',\n    }),\n    startIcon: getStyles({\n      menuItemCheckboxVariantStartIcon: 'default',\n      menuItemCheckboxVariantActiveStartIcon: isChecked ? 'on' : 'off',\n    }),\n    endIcon: getStyles({\n      menuItemCheckboxVariantEndIcon: 'default',\n      menuItemCheckboxVariantActiveEndIcon: isChecked ? 'on' : 'off',\n    }),\n  };\n\n  return (\n    <MenuItemBase\n      ref={ref}\n      as={AriakitMenuItemCheckbox}\n      hideEndIcon={!isChecked}\n      endIcon={endIcon}\n      active={isChecked}\n      className={cx('uds-menu-item-checkbox', className)}\n      layerClassNames={layerClassNames}\n      name={name}\n      rootProps={{\n        onChange: handleChange,\n        defaultChecked,\n        checked: checked !== undefined ? checked : undefined,\n        hideOnClick,\n      }}\n      {...props}\n    />\n  );\n});\n\nMenuItemCheckbox.displayName = 'MenuItemCheckbox';\n\nexport { MenuItemCheckbox, type MenuItemCheckboxProps };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkGA,MAAM,mBAAmB,WAGvB,SAASA,mBACT,EAAE,MAAM,UAAU,OAAO,SAAS,gBAAgB,aAAa,UAAW,GAAG,SAC7E,KACA;CACA,MAAM,WAAW;CACjB,MAAM,iBAAiB,OAAO,MAAM;CAGpC,MAAM,UAAU,gBAAgB;CAChC,MAAM,WAAW,cAAc,QAAQ;AAGvC,iBAAgB;AACd,MAAI,CAAC,eAAe,WAAW,mBAAmB,UAAa,SAAS;AACtE,WAAQ,WAAW,UAAU;IAAE,GAAG;KAAO,WAAW;IAAgB,EAAE;AACtE,kBAAe,UAAU;;IAE1B;EAAC;EAAS;EAAgB;EAAS,CAAC;CAGvC,MAAM,YAAY,cAAc;AAE9B,MAAI,YAAY,OACd,QAAO;AAIT,MAAI,UAAU,OAAO,QAAQ;GAC3B,MAAM,OAAO,UAAU,MAAM,MAC1B,WAAUC,OAAK,SAA8B,SAAS,SACxD;AAED,OAAI,MAAM,QACR,QAAQ,KAAK,QAA6B;;EAK9C,MAAM,aAAa,UAAU,OAAO;AACpC,SAAO,OAAO,eAAe,YAAY,aAAc,kBAAkB;IACxE;EAAC,UAAU;EAAO,UAAU;EAAQ;EAAU;EAAS;EAAe,CAAC;CAG1E,MAAM,eAAe,aAClB,MAAqC;AAEpC,MAAI,YAAY,OACd,UAAS,WAAW,UAAU;GAAE,GAAG;IAAO,WAAW,EAAE,OAAO;GAAS,EAAE;IAG7E;EAAC;EAAU;EAAS;EAAQ,CAC7B;CAED,MAAM,kBAAkB;EACtB,MAAM,UAAU;GACd,6BAA6B;GAC7B,mCAAmC,YAAY,OAAO;GACvD,CAAC;EACF,MAAM,UAAU;GACd,6BAA6B;GAC7B,mCAAmC,YAAY,OAAO;GACvD,CAAC;EACF,WAAW,UAAU;GACnB,kCAAkC;GAClC,wCAAwC,YAAY,OAAO;GAC5D,CAAC;EACF,SAAS,UAAU;GACjB,gCAAgC;GAChC,sCAAsC,YAAY,OAAO;GAC1D,CAAC;EACH;AAED,QACE,oBAAC;EACM;EACL,IAAIC;EACJ,aAAa,CAAC;EACL;EACT,QAAQ;EACR,WAAW,GAAG,0BAA0B,UAAU;EACjC;EACX;EACN,WAAW;GACT,UAAU;GACV;GACA,SAAS,YAAY,SAAY,UAAU;GAC3C;GACD;EACD,GAAI;GACJ;EAEJ;AAEF,iBAAiB,cAAc"}

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,138 @@
+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 };
+//# sourceMappingURL=Menu.Provider.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.Provider.d.cts","names":[],"sources":["../../../../src/components/client/Menu/Menu.Provider.tsx"],"sourcesContent":[],"mappings":";;;;;;KASK,iBAAA,CAAA,CAAA;;AAP0C,IAAA,CAS1C,mBAAA,CAAA,CAAA,CAFiB,CAAA,KAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA;AAAA,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,SAAA,CAAA,MAAA,CAAA,GAAA,CAAA,IAAA,CAAA,WAAA,CAAA,CAAA;AAEE,IAAA,CAEnB,aAAA,CAAA,CAAA,CACD,iBADc,CAAA,CAAA,CAEd,mBAFc,CAAA,CAAA,CAAA,CAAA,CAAA,CAGX,iBAHW,CAAA,CAAA,CAAA,CAGU,mBAHV,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAIX,mBAJW,CAAA,CAAA,CAAA,CAIY,iBAJZ,CAAA,CAAA;KAMb,iBAAA,CAAA,CAAA,CAAoB,iBALrB,CAAA;EACA,CAAA,CAAA;;;;;;AAE2C,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,gBAAA,CAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,IAAA,CAAA,UAAA,CAAA,IAAA,CAAA,IAAA,CAAA,QAAA,CAAA;;EAWW,SAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAnC,MAAmC,CAAA,MAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,CAAA,CAAA,iBAAA,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA;EAQ/C,CAAA,CAAA;;;;;;;EAgDG,MAAA,CAAA,CAAA,CAhDH,iBAAA,CAAA,CAgDG,CAAA,CAAA,MAAA,CAAA,CAAA;EAQA,CAAA,CAAA;;;AAzE4B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,CAAA,MAAA;;cAuB5B;EAkGX,CAAA,CAAA;;;;;UA5FO,iBAAA,CAAA;;;;;;;;QAQF,iBAAA,CAAA;;;;;SAKC,iBAAA,CAAA;;;;;;;;;YASG,iBAAA,CAAA;;;;;gBAKI,iBAAA,CAAA;;;;;;;;;cASF,iBAAA,CAAA;;;;;;;;cAQA,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4CR;;;;;KAIH,oBAAiB,mBAAA,CAAA,GAAA,CAAA"}

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

@@ -0,0 +1,138 @@
+import { PropsWithChildren } from "react";
+import * as react_jsx_runtime14 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_runtime14.JSX.Element;
+  displayName: string;
+};
+//#endregion
+export { type MenuPlacement, MenuProvider, type MenuProviderProps };
+//# sourceMappingURL=Menu.Provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.Provider.d.ts","names":[],"sources":["../../../../src/components/client/Menu/Menu.Provider.tsx"],"sourcesContent":[],"mappings":";;;;;;KASK,iBAAA,CAAA,CAAA;;AAP0C,IAAA,CAS1C,mBAAA,CAAA,CAAA,CAFiB,CAAA,KAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA;AAAA,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,SAAA,CAAA,MAAA,CAAA,GAAA,CAAA,IAAA,CAAA,WAAA,CAAA,CAAA;AAEE,IAAA,CAEnB,aAAA,CAAA,CAAA,CACD,iBADc,CAAA,CAAA,CAEd,mBAFc,CAAA,CAAA,CAAA,CAAA,CAAA,CAGX,iBAHW,CAAA,CAAA,CAAA,CAGU,mBAHV,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAIX,mBAJW,CAAA,CAAA,CAAA,CAIY,iBAJZ,CAAA,CAAA;KAMb,iBAAA,CAAA,CAAA,CAAoB,iBALrB,CAAA;EACA,CAAA,CAAA;;;;;;AAE2C,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,gBAAA,CAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,IAAA,CAAA,UAAA,CAAA,IAAA,CAAA,IAAA,CAAA,QAAA,CAAA;;EAWW,SAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAnC,MAAmC,CAAA,MAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,CAAA,CAAA,iBAAA,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA;EAQ/C,CAAA,CAAA;;;;;;;EAgDG,MAAA,CAAA,CAAA,CAhDH,iBAAA,CAAA,CAgDG,CAAA,CAAA,MAAA,CAAA,CAAA;EAQA,CAAA,CAAA;;;AAzE4B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,CAAA,MAAA;;cAuB5B;EAkGX,CAAA,CAAA;;;;;UA5FO,iBAAA,CAAA;;;;;;;;QAQF,iBAAA,CAAA;;;;;SAKC,iBAAA,CAAA;;;;;;;;;YASG,iBAAA,CAAA;;;;;gBAKI,iBAAA,CAAA;;;;;;;;;cASF,iBAAA,CAAA;;;;;;;;cAQA,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4CR;;;;;KAIH,oBAAiB,mBAAA,CAAA,GAAA,CAAA"}

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

@@ -0,0 +1,63 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { SpringMotionConfig } from "../SpringMotionConfig.js";
+import { useRtl } from "../../../hooks/useRtl.js";
+import { transformAriakitPlacement } from "./utils/transformAriakitPlacement.js";
+import { jsx } from "react/jsx-runtime";
+import { MenuProvider as MenuProvider$1 } from "@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$2({ placement = "bottom", rtl: explicitRtl,...props }) {
+	const isRtl = useRtl({ explicit: explicitRtl });
+	return /* @__PURE__ */ jsx(SpringMotionConfig, { children: /* @__PURE__ */ jsx(MenuProvider$1, {
+		placement: transformAriakitPlacement(placement, { rtl: isRtl }),
+		rtl: isRtl,
+		...props
+	}) });
+};
+MenuProvider.displayName = "MenuProvider";
+
+//#endregion
+export { MenuProvider };
+//# sourceMappingURL=Menu.Provider.js.map