@yahoo/uds 3.58.1 → 3.59.0-beta.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.Provider.js","names":["MenuProvider","AriakitMenuProvider"],"sources":["../../../../src/components/client/Menu/Menu.Provider.tsx"],"sourcesContent":["import type { MenuProviderProps as AriakitMenuProviderProps } from '@ariakit/react/menu';\nimport { MenuProvider as AriakitMenuProvider } from '@ariakit/react/menu';\nimport type { PropsWithChildren } from 'react';\n\nimport { useRtl } from '../../../hooks/useRtl';\nimport { SpringMotionConfig } from '../SpringMotionConfig';\nimport { transformAriakitPlacement } from './utils/transformAriakitPlacement';\n\n/** Valid vertical placement values for the menu */\ntype VerticalPlacement = 'top' | 'bottom';\n/** Valid horizontal placement values for the menu */\ntype HorizontalPlacement = 'start' | 'end';\n/** Combined placement values for menu positioning */\ntype MenuPlacement =\n  | VerticalPlacement\n  | HorizontalPlacement\n  | `${VerticalPlacement}-${HorizontalPlacement}`\n  | `${HorizontalPlacement}-${VerticalPlacement}`;\n\ntype MenuProviderProps = PropsWithChildren<{\n  /**\n   * A callback that gets called when the\n   * [`values`](https://ariakit.org/reference/menu-provider#values) state\n   * changes.\n   *\n   * Live examples:\n   * - [`MenuItemCheckbox`](https://uds.build/docs/components/menu-item-checkbox).\n   */\n  setValues?: (values: Record<string, boolean>) => void | AriakitMenuProviderProps['setValues'];\n  /**\n   * A map of names and values that will be used by the\n   * [`MenuItemCheckbox`](https://uds.build/docs/components/menu-item-checkbox).\n   *\n   * Live examples:\n   * - [MenuItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)\n   */\n  values?: AriakitMenuProviderProps['values'];\n  /**\n   * The placement of the Menu.Content.\n   *\n   * @default 'bottom'\n   */\n  placement?: MenuPlacement;\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?: AriakitMenuProviderProps['store'];\n  /**\n   * Whether the menu should be rendered in RTL direction.\n   *\n   * This only affects the some component behavior behavior. You still need to set\n   * `dir=\"rtl\"` on HTML/CSS.\n   * @default false\n   */\n  rtl?: AriakitMenuProviderProps['rtl'];\n  /**\n   * Whether the content is visible.\n   * @default false\n   */\n  open?: AriakitMenuProviderProps['open'];\n  /**\n   * A callback that gets called when the\n   * [`open`](https://ariakit.org/reference/disclosure-provider#open) state\n   * changes.\n   * @example\n   * const [open, setOpen] = useState(false);\n   * const disclosure = useDisclosureStore({ open, setOpen });\n   */\n  setOpen?: AriakitMenuProviderProps['setOpen'];\n  /**\n   * Whether the content should be visible by default.\n   * @default false\n   */\n  defaultOpen?: AriakitMenuProviderProps['defaultOpen'];\n  /**\n   * Determines how the focus behaves when the user reaches the end of the\n   * composite widget.\n   *\n   * Live examples:\n   * - [Command Menu](https://uds.build/docs/components/menu)\n   * @default false\n   */\n  focusLoop?: AriakitMenuProviderProps['focusLoop'];\n  /**\n   * If enabled, moving to the next item from the last one in a row or column\n   * will focus on the first item in the next row or column and vice-versa.\n   * `true` wraps between rows and columns, `horizontal` wraps only between rows, and `vertical` wraps only between columns.\n   *\n   * @default false\n   */\n  focusWrap?: AriakitMenuProviderProps['focusWrap'];\n}>;\n\n/**\n * **🏗️ A Menu Provider component**\n *\n * @componentType Server component\n *\n * @description\n * A provider component for the menu, which is used to provide the menu context to the menu items.\n *\n * @see The {@link https://uds.build/docs/components/menu-provider Menu.Provider 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 * import { Calendar, Clipboard } from \"@yahoo/uds-icons\";\n *\n * export function MenuProviderExample() {\n *   return (\n *     <Menu.Provider>\n *       <Menu.Trigger asChild>\n *         <Button>Menu Options</Button>\n *       </Menu.Trigger>\n *       <Menu.Content>\n *         <Menu.Item startIcon={Calendar}>Calendar</Menu.Item>\n *         <Menu.Item startIcon={Clipboard} endIcon={DiagonalRightUp}>\n *           Clipboard\n *         </Menu.Item>\n *         <Menu.Item active>Active Item</Menu.Item>\n *       </Menu.Content>\n *     </Menu.Provider>\n *   )\n * }\n * ```\n *\n * @usage\n * Use MenuItem for standard menu options that trigger actions or navigate to other parts of the application.\n * The active prop can be used to highlight the currently selected item.\n *\n * @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)\n **/\nconst MenuProvider = function MenuProvider({\n  placement = 'bottom',\n  rtl: explicitRtl,\n  ...props\n}: MenuProviderProps) {\n  const isRtl = useRtl({ explicit: explicitRtl });\n  const ariakitPlacement = transformAriakitPlacement(placement, { rtl: isRtl });\n\n  return (\n    <SpringMotionConfig>\n      <AriakitMenuProvider placement={ariakitPlacement} rtl={isRtl} {...props} />\n    </SpringMotionConfig>\n  );\n};\n\nMenuProvider.displayName = 'MenuProvider';\n\nexport { type MenuPlacement, MenuProvider, type MenuProviderProps };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwIA,MAAM,eAAe,SAASA,eAAa,EACzC,YAAY,UACZ,KAAK,YACL,GAAG,SACiB;CACpB,MAAM,QAAQ,OAAO,EAAE,UAAU,aAAa,CAAC;AAG/C,QACE,oBAAC,gCACC,oBAACC;EAAoB,WAJA,0BAA0B,WAAW,EAAE,KAAK,OAAO,CAAC;EAIvB,KAAK;EAAO,GAAI;GAAS,GACxD;;AAIzB,aAAa,cAAc"}

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

@@ -0,0 +1,75 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_styles_styler = require('../../../styles/styler.cjs');
+const require_components_Box = require('../../Box.cjs');
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let __ariakit_react_menu = require("@ariakit/react/menu");
+
+//#region src/components/client/Menu/Menu.Trigger.tsx
+/**
+* **⚡ A Menu Trigger component**
+*
+* @componentType Server component
+*
+* @description
+* A trigger component for the menu, which is used to toggle the menus open state.
+*
+* @see The {@link https://uds.build/docs/components/menu-trigger Menu.Trigger 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 MenuTrigger to toggle the open state of a menu.
+*
+* @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+**/
+const MenuTrigger = (0, react.forwardRef)(function MenuTrigger$1({ asChild, children, className,...props }, ref) {
+	const slotRef = (0, react.useRef)(null);
+	const renderProps = asChild ? { render: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_Box.Box, {
+		asChild: true,
+		ref: slotRef,
+		className: "uds-ring h-fit w-fit",
+		children
+	}) } : { children };
+	const handleFocusVisible = (0, react.useCallback)(() => {
+		const firstChild = slotRef.current?.firstChild;
+		if (firstChild instanceof HTMLElement && typeof firstChild.focus === "function") firstChild.focus();
+	}, [slotRef]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__ariakit_react_menu.MenuButton, {
+		onFocus: handleFocusVisible,
+		onFocusVisible: handleFocusVisible,
+		ref,
+		className: require_styles_styler.cx("uds-menu-trigger", className),
+		...renderProps,
+		...props
+	});
+});
+MenuTrigger.displayName = "MenuTrigger";
+
+//#endregion
+exports.MenuTrigger = MenuTrigger;

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

@@ -0,0 +1,79 @@
+import { BoxProps } from "../../Box.cjs";
+import { PressableProps } from "../Pressable.cjs";
+import * as react46 from "react";
+import { MenuButtonProps } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.Trigger.d.ts
+interface MenuTriggerProps extends PressableProps {
+  /**
+   * When asChild is set to true, the component's child will be cloned and passed
+   * the props and behavior required to make it functional.
+   */
+  asChild?: BoxProps['asChild'];
+  /**
+   * 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?: MenuButtonProps['store'];
+  /**
+   * Determines if [Focusable](https://ariakit.org/components/focusable)
+   * features should be active on non-native focusable elements.
+   *
+   * **Note**: This prop only turns off the additional features provided by the
+   * [`Focusable`](https://ariakit.org/reference/focusable) component.
+   * Non-native focusable elements will lose their focusability entirely.
+   * However, native focusable elements will retain their inherent focusability,
+   * but without added features such as improved
+   * [`autoFocus`](https://ariakit.org/reference/focusable#autofocus),
+   * [`accessibleWhenDisabled`](https://ariakit.org/reference/focusable#accessiblewhendisabled),
+   * [`onFocusVisible`](https://ariakit.org/reference/focusable#onfocusvisible),
+   * etc.
+   * @default true
+   */
+  focusable?: MenuButtonProps['focusable'];
+}
+/**
+ * **⚡ A Menu Trigger component**
+ *
+ * @componentType Server component
+ *
+ * @description
+ * A trigger component for the menu, which is used to toggle the menus open state.
+ *
+ * @see The {@link https://uds.build/docs/components/menu-trigger Menu.Trigger 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 MenuTrigger to toggle the open state of a menu.
+ *
+ * @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+ **/
+declare const MenuTrigger: react46.ForwardRefExoticComponent<MenuTriggerProps & react46.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { MenuTrigger, type MenuTriggerProps };
+//# sourceMappingURL=Menu.Trigger.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.Trigger.d.cts","names":[],"sources":["../../../../src/components/client/Menu/Menu.Trigger.tsx"],"sourcesContent":[],"mappings":";;;;;;UASU,gBAAA,CAAA,OAAA,CAAyB;;;AAFgB,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,GAAA,CAAA,QAAA,CAAA,QAAA,CAAA,EAAA,CAAA,IAAA,CAAA,EAAA,CAAA,UAAA;;EAazC,OAAA,CAAA,CAAA,CANE,QAMF,CAAA,CAAA,OAAA,CAAA,CAAA;EAgBI,CAAA,CAAA;;;AA3BmC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,QAAA,CAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,IAAA,CAAA,UAAA,CAAA,IAAA,CAAA,IAAA,CAAA,QAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,IAAA;;EAsEhC,KAAA,CAAA,CAAA,CA3DP,eA2DO,CAAA,CAAA,KAAA,CAAA,CAAA;EAAA,CAAA,CAAA;;;;;;;;;;;;;;;cA3CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2CR,aAAW,OAAA,CAAA,0BAAA,mBAAA,OAAA,CAAA,cAAA"}

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

@@ -0,0 +1,79 @@
+import { BoxProps } from "../../Box.js";
+import { PressableProps } from "../Pressable.js";
+import * as react58 from "react";
+import { MenuButtonProps } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.Trigger.d.ts
+interface MenuTriggerProps extends PressableProps {
+  /**
+   * When asChild is set to true, the component's child will be cloned and passed
+   * the props and behavior required to make it functional.
+   */
+  asChild?: BoxProps['asChild'];
+  /**
+   * 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?: MenuButtonProps['store'];
+  /**
+   * Determines if [Focusable](https://ariakit.org/components/focusable)
+   * features should be active on non-native focusable elements.
+   *
+   * **Note**: This prop only turns off the additional features provided by the
+   * [`Focusable`](https://ariakit.org/reference/focusable) component.
+   * Non-native focusable elements will lose their focusability entirely.
+   * However, native focusable elements will retain their inherent focusability,
+   * but without added features such as improved
+   * [`autoFocus`](https://ariakit.org/reference/focusable#autofocus),
+   * [`accessibleWhenDisabled`](https://ariakit.org/reference/focusable#accessiblewhendisabled),
+   * [`onFocusVisible`](https://ariakit.org/reference/focusable#onfocusvisible),
+   * etc.
+   * @default true
+   */
+  focusable?: MenuButtonProps['focusable'];
+}
+/**
+ * **⚡ A Menu Trigger component**
+ *
+ * @componentType Server component
+ *
+ * @description
+ * A trigger component for the menu, which is used to toggle the menus open state.
+ *
+ * @see The {@link https://uds.build/docs/components/menu-trigger Menu.Trigger 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 MenuTrigger to toggle the open state of a menu.
+ *
+ * @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+ **/
+declare const MenuTrigger: react58.ForwardRefExoticComponent<MenuTriggerProps & react58.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { MenuTrigger, type MenuTriggerProps };
+//# sourceMappingURL=Menu.Trigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.Trigger.d.ts","names":[],"sources":["../../../../src/components/client/Menu/Menu.Trigger.tsx"],"sourcesContent":[],"mappings":";;;;;;UASU,gBAAA,CAAA,OAAA,CAAyB;;;AAFgB,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,GAAA,CAAA,QAAA,CAAA,QAAA,CAAA,EAAA,CAAA,IAAA,CAAA,EAAA,CAAA,UAAA;;EAazC,OAAA,CAAA,CAAA,CANE,QAMF,CAAA,CAAA,OAAA,CAAA,CAAA;EAgBI,CAAA,CAAA;;;AA3BmC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,QAAA,CAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,IAAA,CAAA,UAAA,CAAA,IAAA,CAAA,IAAA,CAAA,QAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,IAAA;;EAsEhC,KAAA,CAAA,CAAA,CA3DP,eA2DO,CAAA,CAAA,KAAA,CAAA,CAAA;EAAA,CAAA,CAAA;;;;;;;;;;;;;;;cA3CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2CR,aAAW,OAAA,CAAA,0BAAA,mBAAA,OAAA,CAAA,cAAA"}

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

@@ -0,0 +1,75 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { cx } from "../../../styles/styler.js";
+import { Box } from "../../Box.js";
+import { forwardRef, useCallback, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+import { MenuButton } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/Menu.Trigger.tsx
+/**
+* **⚡ A Menu Trigger component**
+*
+* @componentType Server component
+*
+* @description
+* A trigger component for the menu, which is used to toggle the menus open state.
+*
+* @see The {@link https://uds.build/docs/components/menu-trigger Menu.Trigger 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 MenuTrigger to toggle the open state of a menu.
+*
+* @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)
+**/
+const MenuTrigger = forwardRef(function MenuTrigger$1({ asChild, children, className,...props }, ref) {
+	const slotRef = useRef(null);
+	const renderProps = asChild ? { render: /* @__PURE__ */ jsx(Box, {
+		asChild: true,
+		ref: slotRef,
+		className: "uds-ring h-fit w-fit",
+		children
+	}) } : { children };
+	const handleFocusVisible = useCallback(() => {
+		const firstChild = slotRef.current?.firstChild;
+		if (firstChild instanceof HTMLElement && typeof firstChild.focus === "function") firstChild.focus();
+	}, [slotRef]);
+	return /* @__PURE__ */ jsx(MenuButton, {
+		onFocus: handleFocusVisible,
+		onFocusVisible: handleFocusVisible,
+		ref,
+		className: cx("uds-menu-trigger", className),
+		...renderProps,
+		...props
+	});
+});
+MenuTrigger.displayName = "MenuTrigger";
+
+//#endregion
+export { MenuTrigger };
+//# sourceMappingURL=Menu.Trigger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.Trigger.js","names":["MenuTrigger","renderProps: Partial<AriakitMenuTriggerProps>","AriakitMenuTrigger"],"sources":["../../../../src/components/client/Menu/Menu.Trigger.tsx"],"sourcesContent":["import type { MenuButtonProps as AriakitMenuTriggerProps } from '@ariakit/react/menu';\nimport { MenuButton as AriakitMenuTrigger } from '@ariakit/react/menu';\nimport { forwardRef, useCallback, useRef } from 'react';\n\nimport { cx } from '../../../styles/styler';\nimport type { BoxProps } from '../../Box';\nimport { Box } from '../../Box';\nimport type { PressableProps } from '../Pressable';\n\ninterface MenuTriggerProps extends PressableProps {\n  /**\n   * When asChild is set to true, the component's child will be cloned and passed\n   * the props and behavior required to make it functional.\n   */\n  asChild?: BoxProps['asChild'];\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?: AriakitMenuTriggerProps['store'];\n  /**\n   * Determines if [Focusable](https://ariakit.org/components/focusable)\n   * features should be active on non-native focusable elements.\n   *\n   * **Note**: This prop only turns off the additional features provided by the\n   * [`Focusable`](https://ariakit.org/reference/focusable) component.\n   * Non-native focusable elements will lose their focusability entirely.\n   * However, native focusable elements will retain their inherent focusability,\n   * but without added features such as improved\n   * [`autoFocus`](https://ariakit.org/reference/focusable#autofocus),\n   * [`accessibleWhenDisabled`](https://ariakit.org/reference/focusable#accessiblewhendisabled),\n   * [`onFocusVisible`](https://ariakit.org/reference/focusable#onfocusvisible),\n   * etc.\n   * @default true\n   */\n  focusable?: AriakitMenuTriggerProps['focusable'];\n}\n\n/**\n * **⚡ A Menu Trigger component**\n *\n * @componentType Server component\n *\n * @description\n * A trigger component for the menu, which is used to toggle the menus open state.\n *\n * @see The {@link https://uds.build/docs/components/menu-trigger Menu.Trigger 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 * import { Calendar, Clipboard } from \"@yahoo/uds-icons\";\n *\n * export function MenuProviderExample() {\n *   return (\n *     <Menu.Provider>\n *       <Menu.Trigger asChild>\n *         <Button>Menu Options</Button>\n *       </Menu.Trigger>\n *       <Menu.Content>\n *         <Menu.Item startIcon={Calendar}>Calendar</Menu.Item>\n *         <Menu.Item startIcon={Clipboard} endIcon={DiagonalRightUp}>\n *           Clipboard\n *         </Menu.Item>\n *         <Menu.Item active>Active Item</Menu.Item>\n *       </Menu.Content>\n *     </Menu.Provider>\n *   )\n * }\n * ```\n *\n * @usage\n * Use MenuTrigger to toggle the open state of a menu.\n *\n * @related [Menu](https://uds.build/docs/components/menu), [Menu.ItemCheckbox](https://uds.build/docs/components/menu-item-checkbox)\n **/\nconst MenuTrigger = forwardRef<HTMLButtonElement, MenuTriggerProps>(function MenuTrigger(\n  { asChild, children, className, ...props },\n  ref,\n) {\n  const slotRef = useRef<HTMLDivElement>(null);\n\n  const renderProps: Partial<AriakitMenuTriggerProps> = asChild\n    ? {\n        render: (\n          <Box asChild ref={slotRef} className=\"uds-ring h-fit w-fit\">\n            {children}\n          </Box>\n        ),\n      }\n    : {\n        children,\n      };\n\n  const handleFocusVisible = useCallback(() => {\n    const firstChild = slotRef.current?.firstChild;\n    if (firstChild instanceof HTMLElement && typeof firstChild.focus === 'function') {\n      firstChild.focus();\n    }\n  }, [slotRef]);\n\n  return (\n    <AriakitMenuTrigger\n      onFocus={handleFocusVisible}\n      onFocusVisible={handleFocusVisible}\n      ref={ref}\n      className={cx('uds-menu-trigger', className)}\n      {...renderProps}\n      {...props}\n    />\n  );\n});\n\nMenuTrigger.displayName = 'MenuTrigger';\n\nexport { MenuTrigger, type MenuTriggerProps };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,MAAM,cAAc,WAAgD,SAASA,cAC3E,EAAE,SAAS,UAAU,UAAW,GAAG,SACnC,KACA;CACA,MAAM,UAAU,OAAuB,KAAK;CAE5C,MAAMC,cAAgD,UAClD,EACE,QACE,oBAAC;EAAI;EAAQ,KAAK;EAAS,WAAU;EAClC;GACG,EAET,GACD,EACE,UACD;CAEL,MAAM,qBAAqB,kBAAkB;EAC3C,MAAM,aAAa,QAAQ,SAAS;AACpC,MAAI,sBAAsB,eAAe,OAAO,WAAW,UAAU,WACnE,YAAW,OAAO;IAEnB,CAAC,QAAQ,CAAC;AAEb,QACE,oBAACC;EACC,SAAS;EACT,gBAAgB;EACX;EACL,WAAW,GAAG,oBAAoB,UAAU;EAC5C,GAAI;EACJ,GAAI;GACJ;EAEJ;AAEF,YAAY,cAAc"}

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

@@ -0,0 +1,10 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_components_client_Menu_Menu_index = require('./Menu.index.cjs');
+
+Object.defineProperty(exports, 'Menu', {
+  enumerable: true,
+  get: function () {
+    return require_components_client_Menu_Menu_index.Menu_index_exports;
+  }
+});

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

@@ -0,0 +1,2 @@
+import { Menu_index_d_exports } from "./Menu.index.cjs";
+export { Menu_index_d_exports as Menu };

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

@@ -0,0 +1,2 @@
+import { Menu_index_d_exports } from "./Menu.index.js";
+export { Menu_index_d_exports as Menu };

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

@@ -0,0 +1,56 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_components_client_Menu_Menu_Content = require('./Menu.Content.cjs');
+const require_components_client_Menu_Menu_Divider = require('./Menu.Divider.cjs');
+const require_components_client_Menu_Menu_Item = require('./Menu.Item.cjs');
+const require_components_client_Menu_Menu_ItemCheckbox = require('./Menu.ItemCheckbox.cjs');
+const require_components_client_Menu_Menu_Provider = require('./Menu.Provider.cjs');
+const require_components_client_Menu_Menu_Trigger = require('./Menu.Trigger.cjs');
+let __ariakit_react_menu = require("@ariakit/react/menu");
+let __ariakit_react = require("@ariakit/react");
+
+//#region src/components/client/Menu/Menu.index.tsx
+var Menu_index_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	Content: () => require_components_client_Menu_Menu_Content.MenuContent,
+	Divider: () => require_components_client_Menu_Menu_Divider.MenuDivider,
+	Item: () => require_components_client_Menu_Menu_Item.MenuItem,
+	ItemCheckbox: () => require_components_client_Menu_Menu_ItemCheckbox.MenuItemCheckbox,
+	Provider: () => require_components_client_Menu_Menu_Provider.MenuProvider,
+	Trigger: () => require_components_client_Menu_Menu_Trigger.MenuTrigger,
+	useMenuContext: () => __ariakit_react_menu.useMenuContext,
+	useMenuStore: () => __ariakit_react_menu.useMenuStore,
+	useStoreState: () => __ariakit_react.useStoreState
+});
+
+//#endregion
+exports.Content = require_components_client_Menu_Menu_Content.MenuContent;
+exports.Divider = require_components_client_Menu_Menu_Divider.MenuDivider;
+exports.Item = require_components_client_Menu_Menu_Item.MenuItem;
+exports.ItemCheckbox = require_components_client_Menu_Menu_ItemCheckbox.MenuItemCheckbox;
+Object.defineProperty(exports, 'Menu_index_exports', {
+  enumerable: true,
+  get: function () {
+    return Menu_index_exports;
+  }
+});
+exports.Provider = require_components_client_Menu_Menu_Provider.MenuProvider;
+exports.Trigger = require_components_client_Menu_Menu_Trigger.MenuTrigger;
+Object.defineProperty(exports, 'useMenuContext', {
+  enumerable: true,
+  get: function () {
+    return __ariakit_react_menu.useMenuContext;
+  }
+});
+Object.defineProperty(exports, 'useMenuStore', {
+  enumerable: true,
+  get: function () {
+    return __ariakit_react_menu.useMenuStore;
+  }
+});
+Object.defineProperty(exports, 'useStoreState', {
+  enumerable: true,
+  get: function () {
+    return __ariakit_react.useStoreState;
+  }
+});

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

@@ -0,0 +1,16 @@
+import { MenuContent } from "./Menu.Content.cjs";
+import { MenuDivider } from "./Menu.Divider.cjs";
+import { MenuItem } from "./Menu.Item.cjs";
+import { MenuItemCheckbox } from "./Menu.ItemCheckbox.cjs";
+import { MenuProvider } from "./Menu.Provider.cjs";
+import { MenuTrigger } from "./Menu.Trigger.cjs";
+import { useMenuContext, useMenuStore } from "@ariakit/react/menu";
+import { useStoreState } from "@ariakit/react";
+
+//#region src/components/client/Menu/Menu.index.d.ts
+declare namespace Menu_index_d_exports {
+  export { MenuContent as Content, MenuDivider as Divider, MenuItem as Item, MenuItemCheckbox as ItemCheckbox, MenuProvider as Provider, MenuTrigger as Trigger, useMenuContext, useMenuStore, useStoreState };
+}
+//#endregion
+export { MenuContent as Content, MenuDivider as Divider, MenuItem as Item, MenuItemCheckbox as ItemCheckbox, Menu_index_d_exports, MenuProvider as Provider, MenuTrigger as Trigger, useMenuContext, useMenuStore, useStoreState };
+//# sourceMappingURL=Menu.index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.index.d.cts","names":[],"sources":["../../../../src/components/client/Menu/Menu.index.tsx"],"sourcesContent":[],"mappings":""}

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

@@ -0,0 +1,16 @@
+import { MenuContent } from "./Menu.Content.js";
+import { MenuDivider } from "./Menu.Divider.js";
+import { MenuItem } from "./Menu.Item.js";
+import { MenuItemCheckbox } from "./Menu.ItemCheckbox.js";
+import { MenuProvider } from "./Menu.Provider.js";
+import { MenuTrigger } from "./Menu.Trigger.js";
+import { useMenuContext, useMenuStore } from "@ariakit/react/menu";
+import { useStoreState } from "@ariakit/react";
+
+//#region src/components/client/Menu/Menu.index.d.ts
+declare namespace Menu_index_d_exports {
+  export { MenuContent as Content, MenuDivider as Divider, MenuItem as Item, MenuItemCheckbox as ItemCheckbox, MenuProvider as Provider, MenuTrigger as Trigger, useMenuContext, useMenuStore, useStoreState };
+}
+//#endregion
+export { MenuContent as Content, MenuDivider as Divider, MenuItem as Item, MenuItemCheckbox as ItemCheckbox, Menu_index_d_exports, MenuProvider as Provider, MenuTrigger as Trigger, useMenuContext, useMenuStore, useStoreState };
+//# sourceMappingURL=Menu.index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.index.d.ts","names":[],"sources":["../../../../src/components/client/Menu/Menu.index.tsx"],"sourcesContent":[],"mappings":""}

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

@@ -0,0 +1,28 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { __export } from "../../../_virtual/rolldown_runtime.js";
+import { MenuContent } from "./Menu.Content.js";
+import { MenuDivider } from "./Menu.Divider.js";
+import { MenuItem } from "./Menu.Item.js";
+import { MenuItemCheckbox } from "./Menu.ItemCheckbox.js";
+import { MenuProvider } from "./Menu.Provider.js";
+import { MenuTrigger } from "./Menu.Trigger.js";
+import { useMenuContext, useMenuStore } from "@ariakit/react/menu";
+import { useStoreState } from "@ariakit/react";
+
+//#region src/components/client/Menu/Menu.index.tsx
+var Menu_index_exports = /* @__PURE__ */ __export({
+	Content: () => MenuContent,
+	Divider: () => MenuDivider,
+	Item: () => MenuItem,
+	ItemCheckbox: () => MenuItemCheckbox,
+	Provider: () => MenuProvider,
+	Trigger: () => MenuTrigger,
+	useMenuContext: () => useMenuContext,
+	useMenuStore: () => useMenuStore,
+	useStoreState: () => useStoreState
+});
+
+//#endregion
+export { MenuContent as Content, MenuDivider as Divider, MenuItem as Item, MenuItemCheckbox as ItemCheckbox, Menu_index_exports, MenuProvider as Provider, MenuTrigger as Trigger, useMenuContext, useMenuStore, useStoreState };
+//# sourceMappingURL=Menu.index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.index.js","names":[],"sources":["../../../../src/components/client/Menu/Menu.index.tsx"],"sourcesContent":["export { MenuContent as Content } from './Menu.Content';\nexport { MenuDivider as Divider } from './Menu.Divider';\nexport { MenuItem as Item } from './Menu.Item';\nexport { MenuItemCheckbox as ItemCheckbox } from './Menu.ItemCheckbox';\nexport { MenuProvider as Provider } from './Menu.Provider';\nexport { MenuTrigger as Trigger } from './Menu.Trigger';\n// Forward relevant AriaKit hooks\nexport { useStoreState } from '@ariakit/react';\nexport { useMenuContext, useMenuStore } from '@ariakit/react/menu';\n"],"mappings":""}

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

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

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

@@ -0,0 +1,10 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_components_client_Menu_Menu_index = require('./Menu.index.cjs');
+
+Object.defineProperty(exports, 'Menu', {
+  enumerable: true,
+  get: function () {
+    return require_components_client_Menu_Menu_index.Menu_index_exports;
+  }
+});

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

@@ -0,0 +1,9 @@
+import { MenuContentProps } from "./Menu.Content.cjs";
+import { MenuDividerProps } from "./Menu.Divider.cjs";
+import { MenuItemProps } from "./Menu.Item.cjs";
+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";
+import "./Menu.cjs";
+export { Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps };

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

@@ -0,0 +1,9 @@
+import { MenuContentProps } from "./Menu.Content.js";
+import { MenuDividerProps } from "./Menu.Divider.js";
+import { MenuItemProps } from "./Menu.Item.js";
+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";
+import "./Menu.js";
+export { Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps };

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

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

package/dist/components/client/Menu/utils/transformAriakitPlacement.cjs

@@ -0,0 +1,39 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region src/components/client/Menu/utils/transformAriakitPlacement.ts
+/**
+* Maps directionally-agnostic placement values to Ariakit LTR values
+* - Converts 'start' to 'left' and 'end' to 'right' (with RTL support)
+* - Examples:
+*   - 'start' -> 'left' (or 'right' in RTL)
+*   - 'end' -> 'right' (or 'left' in RTL)
+*   - 'top-start' -> 'top-left' (or 'top-right' in RTL)
+*   - 'bottom-end' -> 'bottom-right' (or 'bottom-left' in RTL)
+*   - 'start-top' -> 'left-top' (or 'right-top' in RTL)
+*   - 'end-bottom' -> 'right-bottom' (or 'left-bottom' in RTL)
+*
+* The function handles:
+* - Simple placements (start/end)
+* - Vertical-horizontal combinations (top-start, bottom-end, etc.)
+* - Horizontal-vertical combinations (start-top, end-bottom, etc.)
+* - RTL/LTR directionality
+* - Undefined placements and options
+*/
+const transformAriakitPlacement = (placement, options) => {
+	const isRtl = options?.rtl;
+	if (placement === "start") return isRtl ? "right" : "left";
+	if (placement === "end") return isRtl ? "left" : "right";
+	if (placement?.includes("-")) {
+		const [first, second] = placement.split("-");
+		if (first === "start" || first === "end") {
+			const horizontal = first === "start" ? isRtl ? "right" : "left" : isRtl ? "left" : "right";
+			if (second === "top" || second === "bottom") return `${horizontal}-${second === "bottom" ? "end" : "start"}`;
+		}
+		if (first === "top" || first === "bottom") return `${first}-${second === "start" ? isRtl ? "end" : "start" : isRtl ? "start" : "end"}`;
+	}
+	return placement;
+};
+
+//#endregion
+exports.transformAriakitPlacement = transformAriakitPlacement;

package/dist/components/client/Menu/utils/transformAriakitPlacement.d.cts

@@ -0,0 +1,32 @@
+import { MenuPlacement } from "../Menu.Provider.cjs";
+import { MenuProviderProps } from "@ariakit/react/menu";
+
+//#region src/components/client/Menu/utils/transformAriakitPlacement.d.ts
+
+/**
+ * Maps directionally-agnostic placement values to Ariakit LTR values
+ * - Converts 'start' to 'left' and 'end' to 'right' (with RTL support)
+ * - Examples:
+ *   - 'start' -> 'left' (or 'right' in RTL)
+ *   - 'end' -> 'right' (or 'left' in RTL)
+ *   - 'top-start' -> 'top-left' (or 'top-right' in RTL)
+ *   - 'bottom-end' -> 'bottom-right' (or 'bottom-left' in RTL)
+ *   - 'start-top' -> 'left-top' (or 'right-top' in RTL)
+ *   - 'end-bottom' -> 'right-bottom' (or 'left-bottom' in RTL)
+ *
+ * The function handles:
+ * - Simple placements (start/end)
+ * - Vertical-horizontal combinations (top-start, bottom-end, etc.)
+ * - Horizontal-vertical combinations (start-top, end-bottom, etc.)
+ * - RTL/LTR directionality
+ * - Undefined placements and options
+ */
+declare const transformAriakitPlacement: (/** The placement of the menu relative to the trigger */
+placement?: MenuPlacement, /** Extra options */
+options?: {
+  /** Whether to apply RTL/LTR directionality to the menu */
+  rtl?: boolean;
+}) => MenuProviderProps["placement"];
+//#endregion
+export { transformAriakitPlacement };
+//# sourceMappingURL=transformAriakitPlacement.d.cts.map

package/dist/components/client/Menu/utils/transformAriakitPlacement.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformAriakitPlacement.d.cts","names":[],"sources":["../../../../../src/components/client/Menu/utils/transformAriakitPlacement.ts"],"sourcesContent":[],"mappings":";;;;;;;AAsBA,CAAA,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,CAAA,KAAA,CAAA,CAAA,EAAA,CAAA,CAAA,IAAA,CAAA,CAAA,GAAA,CAAA,CAAA,GAAA,CAAA,CAAA,EAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,IAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;;;;;;;;;;cAAa;YAEC;;;;MAMX"}