@yahoo/uds 3.66.1 → 3.67.0-beta.2

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

@@ -0,0 +1,62 @@
+"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 };

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,78 @@
+import { BoxProps } from "../../Box.cjs";
+import { PressableProps } from "../Pressable.cjs";
+import * as react41 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: react41.ForwardRefExoticComponent<MenuTriggerProps & react41.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { MenuTrigger, type MenuTriggerProps };

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

@@ -0,0 +1,78 @@
+import { BoxProps } from "../../Box.js";
+import { PressableProps } from "../Pressable.js";
+import * as react51 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: react51.ForwardRefExoticComponent<MenuTriggerProps & react51.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { MenuTrigger, type MenuTriggerProps };

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

@@ -0,0 +1,74 @@
+"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 };

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 = require("@ariakit/react");
+let __ariakit_react_menu = require("@ariakit/react/menu");
+
+//#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,15 @@
+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 };

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

@@ -0,0 +1,15 @@
+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 { useStoreState } from "@ariakit/react";
+import { useMenuContext, useMenuStore } from "@ariakit/react/menu";
+
+//#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 };

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

@@ -0,0 +1,27 @@
+"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 { useStoreState } from "@ariakit/react";
+import { useMenuContext, useMenuStore } from "@ariakit/react/menu";
+
+//#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 };

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,31 @@
+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 };

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

@@ -0,0 +1,31 @@
+import { MenuPlacement } from "../Menu.Provider.js";
+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 };