@arun-dev/headless 4.6.0 → 4.7.0

package/dist/chunk-2S4XG4VD.js

@@ -0,0 +1,33 @@
+// src/core/rovingFocus.ts
+function byDocumentOrder(a, b) {
+  const x = a.ref.current;
+  const y = b.ref.current;
+  if (!x || !y) return 0;
+  return x.compareDocumentPosition(y) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1;
+}
+function rovingIndex(key, {
+  count,
+  current,
+  orientation,
+  rtl
+}) {
+  if (count === 0) return null;
+  const [prevKey, nextKey] = orientation === "vertical" ? ["ArrowUp", "ArrowDown"] : rtl ? ["ArrowRight", "ArrowLeft"] : ["ArrowLeft", "ArrowRight"];
+  switch (key) {
+    case nextKey:
+      return current < 0 ? 0 : (current + 1) % count;
+    case prevKey:
+      return current < 0 ? count - 1 : (current - 1 + count) % count;
+    case "Home":
+      return 0;
+    case "End":
+      return count - 1;
+    default:
+      return null;
+  }
+}
+
+export {
+  byDocumentOrder,
+  rovingIndex
+};

package/dist/menu/index.cjs

@@ -0,0 +1,438 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/menu/index.ts
+var menu_exports = {};
+__export(menu_exports, {
+  Menu: () => index_parts_exports
+});
+module.exports = __toCommonJS(menu_exports);
+
+// src/menu/index.parts.ts
+var index_parts_exports = {};
+__export(index_parts_exports, {
+  Item: () => MenuItem,
+  Popup: () => MenuPopup,
+  Root: () => MenuRoot,
+  Trigger: () => MenuTrigger
+});
+
+// src/menu/MenuRoot.tsx
+var import_react3 = require("react");
+
+// src/core/anchoring.ts
+function anchorNameFor(id) {
+  return `--hl-anchor-${id.replace(/[^a-zA-Z0-9_-]/g, "")}`;
+}
+var POSITION_AREA = {
+  bottom: { start: "bottom span-right", center: "bottom", end: "bottom span-left" },
+  top: { start: "top span-right", center: "top", end: "top span-left" },
+  right: { start: "right span-bottom", center: "right", end: "right span-top" },
+  left: { start: "left span-bottom", center: "left", end: "left span-top" }
+};
+function anchoredPopupStyle(anchorName, side, align) {
+  return {
+    positionAnchor: anchorName,
+    positionArea: POSITION_AREA[side][align],
+    // Flip across the axis it opens on; the other axis is left alone.
+    positionTryFallbacks: side === "top" || side === "bottom" ? "flip-block" : "flip-inline"
+  };
+}
+function anchoredDataAttributes(side, align) {
+  return { "data-side": side, "data-align": align };
+}
+
+// src/core/rovingFocus.ts
+function byDocumentOrder(a, b) {
+  const x = a.ref.current;
+  const y = b.ref.current;
+  if (!x || !y) return 0;
+  return x.compareDocumentPosition(y) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1;
+}
+function rovingIndex(key, {
+  count,
+  current,
+  orientation,
+  rtl
+}) {
+  if (count === 0) return null;
+  const [prevKey, nextKey] = orientation === "vertical" ? ["ArrowUp", "ArrowDown"] : rtl ? ["ArrowRight", "ArrowLeft"] : ["ArrowLeft", "ArrowRight"];
+  switch (key) {
+    case nextKey:
+      return current < 0 ? 0 : (current + 1) % count;
+    case prevKey:
+      return current < 0 ? count - 1 : (current - 1 + count) % count;
+    case "Home":
+      return 0;
+    case "End":
+      return count - 1;
+    default:
+      return null;
+  }
+}
+
+// src/core/useControlled.ts
+var import_react = require("react");
+function useControlled({
+  controlled,
+  default: defaultValue,
+  name = "Component",
+  state = "value"
+}) {
+  const { current: isControlled } = (0, import_react.useRef)(controlled !== void 0);
+  const [uncontrolled, setUncontrolled] = (0, import_react.useState)(defaultValue);
+  const defaultRef = (0, import_react.useRef)(defaultValue);
+  const value = isControlled ? controlled : uncontrolled;
+  if (process.env.NODE_ENV !== "production") {
+    if (isControlled !== (controlled !== void 0)) {
+      console.error(
+        `${name}: cannot switch between controlled and uncontrolled \`${state}\`. Decide which one this component is for the whole of its life.`
+      );
+    }
+    if (!isControlled && defaultRef.current !== defaultValue) {
+      console.error(
+        `${name}: cannot change the default \`${state}\` after mount. It is only read once, so later changes are silently ignored.`
+      );
+    }
+  }
+  const setValue = (0, import_react.useCallback)(
+    (next) => {
+      if (!isControlled) setUncontrolled(next);
+    },
+    [isControlled]
+  );
+  return [value, setValue];
+}
+
+// src/menu/MenuRootContext.ts
+var import_react2 = require("react");
+var MenuRootContext = (0, import_react2.createContext)(null);
+function useMenuRootContext(part) {
+  const context = (0, import_react2.useContext)(MenuRootContext);
+  if (context === null) {
+    throw new Error(`<Menu.${part}> must be rendered inside <Menu.Root>.`);
+  }
+  return context;
+}
+
+// src/menu/MenuRoot.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function MenuRoot({
+  open: openProp,
+  defaultOpen,
+  onOpenChange,
+  focusableWhenDisabled = false,
+  children
+}) {
+  const [open, setOpenState] = useControlled({
+    controlled: openProp,
+    default: defaultOpen ?? false,
+    name: "Menu.Root",
+    state: "open"
+  });
+  const setOpen = (0, import_react3.useCallback)(
+    (next) => {
+      if (next === open) return;
+      setOpenState(next);
+      onOpenChange?.(next);
+    },
+    [open, setOpenState, onOpenChange]
+  );
+  const [items, setItems] = (0, import_react3.useState)([]);
+  const register = (0, import_react3.useCallback)((entry) => {
+    setItems((current) => [...current, entry].sort(byDocumentOrder));
+    return () => setItems((current) => current.filter((i) => i !== entry));
+  }, []);
+  const navigableItems = (0, import_react3.useMemo)(
+    () => focusableWhenDisabled ? items : items.filter((i) => !i.disabled),
+    [items, focusableWhenDisabled]
+  );
+  const id = (0, import_react3.useId)();
+  const triggerRef = (0, import_react3.useRef)(null);
+  const focusOnOpenRef = (0, import_react3.useRef)("first");
+  const context = (0, import_react3.useMemo)(
+    () => ({
+      open,
+      setOpen,
+      navigableItems,
+      focusableWhenDisabled,
+      register,
+      focusOnOpenRef,
+      triggerId: `${id}-trigger`,
+      popupId: `${id}-popup`,
+      anchorName: anchorNameFor(id),
+      triggerRef
+    }),
+    [open, setOpen, navigableItems, focusableWhenDisabled, register, id]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MenuRootContext.Provider, { value: context, children });
+}
+
+// src/core/useRender.ts
+var import_react4 = require("react");
+
+// src/core/mergeProps.ts
+function isEventHandler(key) {
+  return key.length > 2 && key.startsWith("on") && key[2] === key[2]?.toUpperCase();
+}
+function mergeRefs(...refs) {
+  return (node) => {
+    const cleanups = refs.map((ref) => {
+      if (typeof ref === "function") {
+        const result = ref(node);
+        return typeof result === "function" ? result : () => ref(null);
+      }
+      if (ref && typeof ref === "object") {
+        ref.current = node;
+        return () => {
+          ref.current = null;
+        };
+      }
+      return void 0;
+    });
+    return () => {
+      cleanups.forEach((cleanup) => {
+        if (typeof cleanup === "function") cleanup();
+      });
+    };
+  };
+}
+function isSyntheticEvent(event) {
+  return typeof event === "object" && event !== null && "nativeEvent" in event;
+}
+function makeEventPreventable(event) {
+  if (Object.prototype.hasOwnProperty.call(event, "preventComponentHandler")) return;
+  const target = event;
+  target.preventComponentHandler = () => {
+    target.componentHandlerPrevented = true;
+  };
+}
+function isComponentHandlerPrevented(event) {
+  return typeof event === "object" && event !== null && event.componentHandlerPrevented === true;
+}
+function chainHandlers(earlier, value) {
+  return (...args) => {
+    const event = args[0];
+    if (isSyntheticEvent(event)) makeEventPreventable(event);
+    value(...args);
+    if (isComponentHandlerPrevented(event)) return;
+    earlier(...args);
+  };
+}
+function mergeProps(...objects) {
+  const merged = {};
+  for (const props of objects) {
+    if (!props) continue;
+    for (const key of Object.keys(props)) {
+      const value = props[key];
+      if (value === void 0) continue;
+      if (isEventHandler(key) && typeof value === "function") {
+        const earlier = merged[key];
+        merged[key] = typeof earlier === "function" ? chainHandlers(earlier, value) : value;
+      } else if (key === "className") {
+        merged.className = merged.className ? `${String(merged.className)} ${String(value)}` : value;
+      } else if (key === "style") {
+        merged.style = { ...merged.style, ...value };
+      } else if (key === "ref") {
+        merged.ref = merged.ref ? mergeRefs(merged.ref, value) : value;
+      } else {
+        merged[key] = value;
+      }
+    }
+  }
+  return merged;
+}
+
+// src/core/useRender.ts
+function useRender({
+  render,
+  defaultTagName,
+  props,
+  consumerProps
+}) {
+  const merged = mergeProps(props, consumerProps);
+  if ((0, import_react4.isValidElement)(render)) {
+    return (0, import_react4.cloneElement)(render, mergeProps(merged, render.props));
+  }
+  return (0, import_react4.createElement)(defaultTagName, merged);
+}
+
+// src/menu/menuDataAttributes.ts
+function menuDataAttributes({ open }) {
+  return {
+    "data-open": open ? "" : void 0,
+    "data-closed": open ? void 0 : ""
+  };
+}
+function menuItemDataAttributes(disabled) {
+  return { "data-disabled": disabled ? "" : void 0 };
+}
+
+// src/menu/MenuTrigger.tsx
+function MenuTrigger({ className, children, render, ...rest }) {
+  const { open, setOpen, focusOnOpenRef, triggerId, popupId, anchorName, triggerRef } = useMenuRootContext("Trigger");
+  return useRender({
+    render,
+    defaultTagName: "button",
+    props: {
+      type: "button",
+      id: triggerId,
+      "aria-haspopup": "menu",
+      "aria-expanded": open,
+      "aria-controls": popupId,
+      ...menuDataAttributes({ open }),
+      style: { anchorName },
+      className,
+      children,
+      ref: triggerRef,
+      onClick() {
+        focusOnOpenRef.current = "first";
+        setOpen(!open);
+      },
+      onKeyDown(event) {
+        if (event.key !== "ArrowDown" && event.key !== "ArrowUp") return;
+        event.preventDefault();
+        focusOnOpenRef.current = event.key === "ArrowUp" ? "last" : "first";
+        setOpen(true);
+      }
+    },
+    consumerProps: rest
+  });
+}
+
+// src/menu/MenuPopup.tsx
+var import_react5 = require("react");
+function MenuPopup({
+  side = "bottom",
+  align = "start",
+  className,
+  children,
+  render,
+  ...rest
+}) {
+  const {
+    open,
+    setOpen,
+    navigableItems,
+    focusOnOpenRef,
+    triggerId,
+    popupId,
+    anchorName,
+    triggerRef
+  } = useMenuRootContext("Popup");
+  const elementRef = (0, import_react5.useRef)(null);
+  const focusPendingRef = (0, import_react5.useRef)(false);
+  const [, resync] = (0, import_react5.useReducer)((n) => n + 1, 0);
+  (0, import_react5.useEffect)(() => {
+    const popup = elementRef.current;
+    if (!popup || typeof popup.showPopover !== "function") return;
+    const shown = popup.matches(":popover-open");
+    if (open && !shown) {
+      popup.showPopover({ source: triggerRef.current ?? void 0 });
+      if (!popup.matches(":popover-open")) setOpen(false);
+      else focusPendingRef.current = true;
+    } else if (!open && shown) {
+      focusPendingRef.current = false;
+      popup.hidePopover();
+    }
+    if (focusPendingRef.current && navigableItems.length > 0) {
+      focusPendingRef.current = false;
+      const target = focusOnOpenRef.current === "last" ? navigableItems.at(-1) : navigableItems[0];
+      target?.ref.current?.focus();
+    }
+  });
+  return useRender({
+    render,
+    defaultTagName: "div",
+    props: {
+      id: popupId,
+      popover: "auto",
+      role: "menu",
+      "aria-labelledby": triggerId,
+      ...anchoredDataAttributes(side, align),
+      ...menuDataAttributes({ open }),
+      style: anchoredPopupStyle(anchorName, side, align),
+      className,
+      children,
+      ref: elementRef,
+      onKeyDown(event) {
+        if (event.key === "Tab") {
+          setOpen(false);
+          return;
+        }
+        const current = navigableItems.findIndex((i) => i.ref.current === event.target);
+        if (current < 0 && event.target !== event.currentTarget) return;
+        const next = rovingIndex(event.key, {
+          count: navigableItems.length,
+          current,
+          orientation: "vertical",
+          rtl: false
+        });
+        if (next === null) return;
+        event.preventDefault();
+        navigableItems[next]?.ref.current?.focus();
+      },
+      onToggle(event) {
+        if (event.target !== event.currentTarget) return;
+        if (event.nativeEvent.newState !== "closed") return;
+        setOpen(false);
+        resync();
+      }
+    },
+    consumerProps: rest
+  });
+}
+
+// src/menu/MenuItem.tsx
+var import_react6 = require("react");
+function MenuItem({
+  disabled = false,
+  onClick,
+  className,
+  children,
+  render,
+  ...rest
+}) {
+  const { setOpen, focusableWhenDisabled, register } = useMenuRootContext("Item");
+  const elementRef = (0, import_react6.useRef)(null);
+  (0, import_react6.useLayoutEffect)(() => register({ disabled, ref: elementRef }), [register, disabled]);
+  return useRender({
+    render,
+    defaultTagName: "button",
+    props: {
+      type: "button",
+      role: "menuitem",
+      tabIndex: -1,
+      disabled: disabled && !focusableWhenDisabled || void 0,
+      "aria-disabled": disabled && focusableWhenDisabled || void 0,
+      ...menuItemDataAttributes(disabled),
+      className,
+      children,
+      ref: elementRef,
+      onClick() {
+        if (!disabled) setOpen(false);
+      }
+    },
+    consumerProps: disabled ? rest : { ...rest, onClick }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Menu
+});

package/dist/menu/index.d.cts

@@ -0,0 +1,115 @@
+import * as react from 'react';
+import { ReactNode, ReactElement, Ref, ComponentPropsWithRef } from 'react';
+import { A as AnchorSide, a as AnchorAlign } from '../anchoring-Btxi0QwC.cjs';
+
+type MenuRootProps = {
+    /**
+     * Controlled state. Provide `onOpenChange` alongside it.
+     *
+     * Never `undefined` once mounted: the mode is latched at mount, as for Switch.
+     */
+    open?: boolean;
+    /** Initial state when uncontrolled. Read once, at mount. */
+    defaultOpen?: boolean;
+    /**
+     * Called on every request to open or close — Trigger, an Item, Tab, Esc, or a click
+     * outside. A controlled menu moves only if the parent accepts it.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Keeps disabled items in the arrow-key sequence, so a screen reader announces them as
+     * unavailable. They still cannot be activated. Off by default: the arrows skip them.
+     */
+    focusableWhenDisabled?: boolean;
+    children?: ReactNode;
+};
+/**
+ * A menu button, by the WAI-ARIA pattern: a Trigger that opens a list of actions. Holds the
+ * state and shares it with its parts. Renders no element of its own.
+ *
+ * The popup is a native `popover`, anchored like Popover (decision 12): the platform supplies
+ * the top layer, light dismiss, Esc and focus return. This component adds state, one setter
+ * every close goes through, and the arrow-key focus a menu needs (`core/rovingFocus`).
+ *
+ * Each Item registers its own `disabled` from its props; the Root never reads it back from
+ * the DOM (decision 10). Elements are kept only to move focus to.
+ */
+declare function MenuRoot({ open: openProp, defaultOpen, onOpenChange, focusableWhenDisabled, children, }: MenuRootProps): react.JSX.Element;
+
+type MenuTriggerOwnProps = {
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type MenuTriggerProps = MenuTriggerOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof MenuTriggerOwnProps>;
+/**
+ * The menu button. A native `<button>`, so a click, Enter and Space open the menu at its
+ * first item with no key handling here; Down does the same, and Up opens it at the last.
+ * It is what the popup is anchored to, and names it: the popup is `aria-labelledby` it.
+ */
+declare function MenuTrigger({ className, children, render, ...rest }: MenuTriggerProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type MenuSide = AnchorSide;
+type MenuAlign = AnchorAlign;
+type MenuPopupOwnProps = {
+    /** Which side of the trigger to open on. Flips to the opposite side when there is no room. */
+    side?: MenuSide;
+    /** Where along that side: flush with the trigger's start or end edge, or centred on it. */
+    align?: MenuAlign;
+    /** Element to render instead of the default `<div>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type MenuPopupProps = MenuPopupOwnProps & Omit<ComponentPropsWithRef<'div'>, keyof MenuPopupOwnProps | 'popover'>;
+/**
+ * The menu: a native `popover="auto"` with `role="menu"`, anchored to the Trigger as
+ * Popover's popup is (decision 12), and labelled by it.
+ *
+ * Opening moves focus to the first item — the last, when Up on the Trigger opened it. Up
+ * and Down then move between items, wrapping, with Home and End; disabled items are skipped
+ * unless the Root sets `focusableWhenDisabled`. Tab closes the menu and lets focus move on.
+ *
+ * Light dismiss and Esc close the element before anyone is asked; the `toggle` event
+ * reports it through the Root, and the element reopens if the state stays open. Focus
+ * returns to the Trigger, the invoker, whenever the menu hides with focus inside it.
+ */
+declare function MenuPopup({ side, align, className, children, render, ...rest }: MenuPopupProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type MenuItemOwnProps = {
+    /**
+     * Cannot be activated. Skipped by the arrow keys, unless the Root sets
+     * `focusableWhenDisabled`.
+     */
+    disabled?: boolean;
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type MenuItemProps = MenuItemOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof MenuItemOwnProps>;
+/**
+ * One action. A native `<button>`, so Enter, Space and a click activate it with no key
+ * handling here: put the action in `onClick`. Activating it closes the menu — call
+ * `event.preventComponentHandler()` in your `onClick` to keep it open.
+ *
+ * `tabIndex={-1}`: the menu moves focus between items itself, and Tab leaves the menu.
+ *
+ * Disabled, it is a native `disabled` button, out of focus and activation. With the Root's
+ * `focusableWhenDisabled` it is `aria-disabled` instead, which keeps it focusable, so the
+ * activation a native `disabled` would block is blocked here: your `onClick` is not
+ * attached while it is disabled.
+ */
+declare function MenuItem({ disabled, onClick, className, children, render, ...rest }: MenuItemProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+declare namespace index_parts {
+  export { MenuItem as Item, MenuPopup as Popup, MenuRoot as Root, MenuTrigger as Trigger };
+}
+
+/** The state Menu.Root shares with its parts, and projects as `data-*` attributes. */
+type MenuState = {
+    open: boolean;
+};
+
+export { index_parts as Menu, type MenuAlign, type MenuItemProps, type MenuPopupProps, type MenuRootProps, type MenuSide, type MenuState, type MenuTriggerProps };

package/dist/menu/index.d.ts

@@ -0,0 +1,115 @@
+import * as react from 'react';
+import { ReactNode, ReactElement, Ref, ComponentPropsWithRef } from 'react';
+import { A as AnchorSide, a as AnchorAlign } from '../anchoring-Btxi0QwC.js';
+
+type MenuRootProps = {
+    /**
+     * Controlled state. Provide `onOpenChange` alongside it.
+     *
+     * Never `undefined` once mounted: the mode is latched at mount, as for Switch.
+     */
+    open?: boolean;
+    /** Initial state when uncontrolled. Read once, at mount. */
+    defaultOpen?: boolean;
+    /**
+     * Called on every request to open or close — Trigger, an Item, Tab, Esc, or a click
+     * outside. A controlled menu moves only if the parent accepts it.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Keeps disabled items in the arrow-key sequence, so a screen reader announces them as
+     * unavailable. They still cannot be activated. Off by default: the arrows skip them.
+     */
+    focusableWhenDisabled?: boolean;
+    children?: ReactNode;
+};
+/**
+ * A menu button, by the WAI-ARIA pattern: a Trigger that opens a list of actions. Holds the
+ * state and shares it with its parts. Renders no element of its own.
+ *
+ * The popup is a native `popover`, anchored like Popover (decision 12): the platform supplies
+ * the top layer, light dismiss, Esc and focus return. This component adds state, one setter
+ * every close goes through, and the arrow-key focus a menu needs (`core/rovingFocus`).
+ *
+ * Each Item registers its own `disabled` from its props; the Root never reads it back from
+ * the DOM (decision 10). Elements are kept only to move focus to.
+ */
+declare function MenuRoot({ open: openProp, defaultOpen, onOpenChange, focusableWhenDisabled, children, }: MenuRootProps): react.JSX.Element;
+
+type MenuTriggerOwnProps = {
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type MenuTriggerProps = MenuTriggerOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof MenuTriggerOwnProps>;
+/**
+ * The menu button. A native `<button>`, so a click, Enter and Space open the menu at its
+ * first item with no key handling here; Down does the same, and Up opens it at the last.
+ * It is what the popup is anchored to, and names it: the popup is `aria-labelledby` it.
+ */
+declare function MenuTrigger({ className, children, render, ...rest }: MenuTriggerProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type MenuSide = AnchorSide;
+type MenuAlign = AnchorAlign;
+type MenuPopupOwnProps = {
+    /** Which side of the trigger to open on. Flips to the opposite side when there is no room. */
+    side?: MenuSide;
+    /** Where along that side: flush with the trigger's start or end edge, or centred on it. */
+    align?: MenuAlign;
+    /** Element to render instead of the default `<div>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type MenuPopupProps = MenuPopupOwnProps & Omit<ComponentPropsWithRef<'div'>, keyof MenuPopupOwnProps | 'popover'>;
+/**
+ * The menu: a native `popover="auto"` with `role="menu"`, anchored to the Trigger as
+ * Popover's popup is (decision 12), and labelled by it.
+ *
+ * Opening moves focus to the first item — the last, when Up on the Trigger opened it. Up
+ * and Down then move between items, wrapping, with Home and End; disabled items are skipped
+ * unless the Root sets `focusableWhenDisabled`. Tab closes the menu and lets focus move on.
+ *
+ * Light dismiss and Esc close the element before anyone is asked; the `toggle` event
+ * reports it through the Root, and the element reopens if the state stays open. Focus
+ * returns to the Trigger, the invoker, whenever the menu hides with focus inside it.
+ */
+declare function MenuPopup({ side, align, className, children, render, ...rest }: MenuPopupProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type MenuItemOwnProps = {
+    /**
+     * Cannot be activated. Skipped by the arrow keys, unless the Root sets
+     * `focusableWhenDisabled`.
+     */
+    disabled?: boolean;
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type MenuItemProps = MenuItemOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof MenuItemOwnProps>;
+/**
+ * One action. A native `<button>`, so Enter, Space and a click activate it with no key
+ * handling here: put the action in `onClick`. Activating it closes the menu — call
+ * `event.preventComponentHandler()` in your `onClick` to keep it open.
+ *
+ * `tabIndex={-1}`: the menu moves focus between items itself, and Tab leaves the menu.
+ *
+ * Disabled, it is a native `disabled` button, out of focus and activation. With the Root's
+ * `focusableWhenDisabled` it is `aria-disabled` instead, which keeps it focusable, so the
+ * activation a native `disabled` would block is blocked here: your `onClick` is not
+ * attached while it is disabled.
+ */
+declare function MenuItem({ disabled, onClick, className, children, render, ...rest }: MenuItemProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+declare namespace index_parts {
+  export { MenuItem as Item, MenuPopup as Popup, MenuRoot as Root, MenuTrigger as Trigger };
+}
+
+/** The state Menu.Root shares with its parts, and projects as `data-*` attributes. */
+type MenuState = {
+    open: boolean;
+};
+
+export { index_parts as Menu, type MenuAlign, type MenuItemProps, type MenuPopupProps, type MenuRootProps, type MenuSide, type MenuState, type MenuTriggerProps };