@funstack/ui 0.0.0-stage → 0.1.0-alpha.1

package/dist/menu/menu-popup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-popup.mjs","names":[],"sources":["../../src/menu/menu-popup.tsx"],"sourcesContent":["\"use client\";\nimport { Activity, useCallback, useMemo, useRef, useSyncExternalStore } from \"react\";\nimport type {\n  ComponentPropsWithRef,\n  CSSProperties,\n  FocusEvent,\n  KeyboardEvent,\n  MouseEvent,\n  PointerEvent,\n  ReactNode,\n  ViewTransitionClass,\n} from \"react\";\nimport { POSITION_TRY_FALLBACKS, positionArea } from \"../internal/anchor-position.js\";\nimport type { AnchorAlign, AnchorSide } from \"../internal/anchor-position.js\";\nimport { mergeRefs } from \"../internal/merge-props.js\";\nimport { useTransitionBoundary } from \"../internal/transition-boundary.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { usePopoverPopup } from \"../internal/use-popover-popup.js\";\nimport { resolveStateValue, useRender } from \"../internal/use-render.js\";\nimport type { DataAttributes } from \"../internal/use-render.js\";\nimport { MenuListContext, useMenuContext } from \"./menu-context.js\";\nimport type { MenuListContextValue } from \"./menu-context.js\";\nimport {\n  edgeItem,\n  focusItem,\n  hasModifier,\n  isMenuItem,\n  isRtl,\n  menuItems,\n  typeaheadText,\n} from \"./menu-dom.js\";\nimport { scheduleHoverClose } from \"./menu-hover.js\";\n\nexport type MenuSide = AnchorSide;\nexport type MenuAlign = AnchorAlign;\n\nexport interface MenuPopupState {\n  /** Committed open state. Read `:popover-open` for the DOM truth. */\n  readonly open: boolean;\n  readonly side: MenuSide | null;\n  readonly align: MenuAlign;\n  /** This popup belongs to a submenu. */\n  readonly submenu: boolean;\n}\n\nexport interface MenuPopupProps extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  | \"id\"\n  | \"popover\"\n  | \"role\"\n  | \"aria-labelledby\"\n  | \"onKeyDown\"\n  | \"onFocus\"\n  | \"onBlur\"\n  | \"onMouseDown\"\n  | \"onPointerEnter\"\n  | \"onPointerLeave\"\n  | \"onToggle\"\n  | \"onBeforeToggle\"\n  | \"className\"\n  | \"style\"\n  | \"children\"\n> {\n  /**\n   * Placement against the Trigger through inline `position-area`, with `position-try-fallbacks`\n   * flipping it when it does not fit. Default `\"bottom\"` for a top-level menu, `\"right\"` for a\n   * submenu (whose fallback is `flip-inline` only). `null` emits no inline positioning (and no\n   * `data-side` / `data-align`): the stylesheet owns placement.\n   */\n  side?: MenuSide | null;\n  /** Alignment along the side. Default `\"start\"`. Ignored when `side` is `null`. */\n  align?: MenuAlign;\n  /**\n   * `false` (default): the items are not rendered while the menu is closed; mounting them is part\n   * of the opening transition, so items that suspend hold the open (and the Trigger pending)\n   * until they are ready. `true`: they stay mounted inside `<Activity mode=\"hidden\">`.\n   */\n  keepMounted?: boolean;\n  /**\n   * Experimental (Chromium 150+). Renders `focusgroup=\"menu wrap|nowrap\"` and, where the engine\n   * implements `focusGroup`, lets the browser handle ArrowUp / ArrowDown / Home / End: items then\n   * render no `tabindex` and the library's arrow-key handling steps aside. Typeahead, activation,\n   * submenu keys and Tab stay in JS. No effect in other engines. Default `false`.\n   */\n  experimental_focusgroup?: boolean;\n  /**\n   * Forwarded to the `<ViewTransition default>` around the popup element. Animates the opening\n   * commit and every library-driven close (an item's activation, the Trigger, ArrowLeft, hover\n   * leaving a submenu, controlled `open={false}`) in all engines; dismissals (Escape, a click\n   * outside, Tab) animate with CSS only. Without it the part renders no `<ViewTransition>`.\n   */\n  transition?: ViewTransitionClass;\n  className?: StateValue<string | undefined, MenuPopupState>;\n  style?: StateValue<CSSProperties | undefined, MenuPopupState>;\n  children?: StateValue<ReactNode, MenuPopupState>;\n  /** Should render a `<div>`; a `<dialog>` would run the dialog focusing steps. */\n  render?: RenderProp<ComponentPropsWithRef<\"div\">, MenuPopupState>;\n}\n\n/** Engine capabilities never change while the page lives. */\nconst subscribeNever = () => () => {};\n\n/** Typeahead buffer lifetime after the last keystroke (design 5.1). */\nconst TYPEAHEAD_RESET_MS = 500;\n\nconst isDev = process.env.NODE_ENV !== \"production\";\n\n/** What a press may focus inside a popup: items, the popup itself, the consumer's controls. */\nconst FOCUSABLE_SELECTOR =\n  'a[href], button, input, select, textarea, summary, [tabindex], [contenteditable]:not([contenteditable=\"false\"])';\n\n/**\n * The menu itself: `<div popover=\"auto\" role=\"menu\" aria-labelledby={trigger} tabindex=\"-1\">`,\n * placed against its Trigger with CSS Anchor Positioning. Owns the keyboard model (design 5):\n * ArrowUp / ArrowDown / Home / End move focus between items (or the browser does, with\n * `experimental_focusgroup` where supported), printable characters run typeahead, ArrowLeft\n * closes a submenu. The top-level popup closes the whole menu at once when focus leaves it (Tab).\n * Style it with `:popover-open`; it emits `data-side` / `data-align` but no `data-open`.\n *\n * Owned keys (conventions 1.2): `id`, `popover`, `role`, `aria-labelledby` (token-merged),\n * `tabIndex`, `focusgroup` (with the flag), `onKeyDown`, `onBlur`, `onMouseDown` (a press on\n * non-item space keeps focus on the current item), `onPointerEnter` / `onPointerLeave`, and\n * `data-side` / `data-align` unless `side` is `null`.\n */\nexport function MenuPopup({\n  side: sideProp,\n  align = \"start\",\n  keepMounted,\n  experimental_focusgroup = false,\n  transition,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: MenuPopupProps) {\n  const menu = useMenuContext(\"Menu.Popup\");\n  const { popover, submenu, loop } = menu;\n  const side = sideProp === undefined ? (submenu ? \"right\" : \"bottom\") : sideProp;\n\n  // As Tabs.List (#43): detected only with the flag, never during SSR or hydration.\n  const nativeFocusgroup = useSyncExternalStore(\n    subscribeNever,\n    () => experimental_focusgroup && \"focusGroup\" in HTMLElement.prototype,\n    () => false,\n  );\n\n  const typeahead = useRef({ text: \"\", at: 0 });\n  const typingAhead = useCallback(() => {\n    const { text, at } = typeahead.current;\n    return text !== \"\" && Date.now() - at <= TYPEAHEAD_RESET_MS;\n  }, []);\n\n  const { setElement, visible, wrapContent } = usePopoverPopup(popover, {\n    part: \"Menu.Popup\",\n    initialFocus: undefined,\n    // Design 6.1: the first (or last) enabled item by open cause, nothing for a hover open, the\n    // popup itself when there are no items.\n    // A pointer open focuses without the focus ring where the engine can be told so (H1).\n    resolveInitialFocus: (popup) => {\n      const { cause, pointer } = menu.takeOpenCause();\n      if (cause === \"none\") return null;\n      const element = edgeItem(popup, cause) ?? popup;\n      return pointer ? { element, focusVisible: false } : element;\n    },\n    keepMounted,\n    transition,\n  });\n\n  const devRef = useCallback((element: HTMLElement) => {\n    if (isDev && element.tagName === \"DIALOG\") {\n      console.error(\n        \"Menu.Popup: rendered a <dialog>. Render a <div>: a <dialog popover> runs the dialog \" +\n          \"focusing steps, which fight the menu's item focus.\",\n      );\n    }\n    return () => {};\n  }, []);\n  const ref = useMemo(() => mergeRefs(setElement, devRef), [setElement, devRef]);\n\n  const listContext = useMemo<MenuListContextValue>(\n    () => ({ menu, nativeFocusgroup, typingAhead }),\n    [menu, nativeFocusgroup, typingAhead],\n  );\n\n  const state: MenuPopupState = { open: popover.committed, side, align, submenu };\n\n  const runTypeahead = (popup: HTMLElement, current: HTMLElement | null, key: string): boolean => {\n    const now = Date.now();\n    const buffer = typeahead.current;\n    if (buffer.text === \"\" || now - buffer.at > TYPEAHEAD_RESET_MS) buffer.text = \"\";\n    if (key === \" \" && buffer.text === \"\") return false;\n    buffer.text += key.toLowerCase();\n    buffer.at = now;\n    const items = menuItems(popup);\n    if (items.length === 0) return true;\n    // A repeated single character cycles through the items starting with it; a longer buffer\n    // keeps the current item while it still matches (design 5.1).\n    const repeated = [...buffer.text].every((c) => c === buffer.text[0]);\n    const search = repeated ? buffer.text[0]! : buffer.text;\n    const index = current === null ? -1 : items.indexOf(current);\n    const start = repeated || index < 0 ? index + 1 : index;\n    for (let i = 0; i < items.length; i++) {\n      const item = items[(start + i) % items.length]!;\n      if (typeaheadText(item).startsWith(search)) {\n        if (item !== current) focusItem(item);\n        break;\n      }\n    }\n    return true;\n  };\n\n  const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n    if (event.defaultPrevented || hasModifier(event)) return;\n    const popup = event.currentTarget;\n    const target = event.target as HTMLElement;\n    const onItem = isMenuItem(target, popup);\n    if (!onItem && target !== popup) return;\n    const key = event.key;\n\n    // ArrowLeft (ArrowRight in RTL) closes a submenu; focus returns to its SubmenuTrigger\n    // through the popover hook's nested focus rule (design 6.3).\n    if (submenu && key === (isRtl(popup) ? \"ArrowRight\" : \"ArrowLeft\")) {\n      event.preventDefault();\n      popover.requestClose(event.nativeEvent, \"activate\");\n      return;\n    }\n\n    if (key === \"ArrowDown\" || key === \"ArrowUp\" || key === \"Home\" || key === \"End\") {\n      if (!onItem) {\n        // The popup itself has focus (no items at open, or focus landed on it some other way):\n        // into the list from its edge (review M1).\n        event.preventDefault();\n        const items = menuItems(popup);\n        const item = key === \"ArrowDown\" || key === \"Home\" ? items[0] : items.at(-1);\n        if (item !== undefined) focusItem(item);\n        return;\n      }\n      // The browser moves focus itself where `focusgroup` is implemented.\n      if (nativeFocusgroup) return;\n      event.preventDefault();\n      const items = menuItems(popup);\n      const index = items.indexOf(target);\n      const last = items.length - 1;\n      let next: number;\n      if (key === \"Home\") next = 0;\n      else if (key === \"End\") next = last;\n      else if (key === \"ArrowDown\") next = index >= last ? (loop ? 0 : last) : index + 1;\n      else next = index <= 0 ? (loop ? last : 0) : index - 1;\n      const item = items[next];\n      if (item !== undefined && item !== target) focusItem(item);\n      return;\n    }\n\n    if (key.length === 1 && runTypeahead(popup, onItem ? target : null, key)) {\n      event.preventDefault();\n    }\n  };\n\n  // Tab / Shift+Tab or any focus move out of the tree closes the whole stack at once (design\n  // 2.2): submenus are DOM descendants of the top-level popup, the Trigger is outside on purpose.\n  // A null `relatedTarget` (window blur, a removed element) closes nothing.\n  const onBlur = (event: FocusEvent<HTMLElement>) => {\n    if (submenu) return;\n    const popup = event.currentTarget;\n    const next = event.relatedTarget;\n    if (!(next instanceof Node) || popup.contains(next)) return;\n    if (popup.matches(\":popover-open\")) popup.hidePopover();\n  };\n\n  // A press on non-item space (padding, a Separator, a GroupLabel) would focus the popup itself\n  // (`tabindex=\"-1\"`) and take focus off the current item; keep it where it is (review M1, the\n  // pointer-focus model of design 6.2). Focusable content of the consumer's (a text field) still\n  // takes focus.\n  const onMouseDown = (event: MouseEvent<HTMLElement>) => {\n    if (event.button !== 0) return;\n    const target = event.target as Element;\n    const focusable = target.closest(FOCUSABLE_SELECTOR);\n    if (focusable === null || focusable.getAttribute(\"role\") === \"menu\") event.preventDefault();\n  };\n\n  const libraryProps: ComponentPropsWithRef<\"div\"> & DataAttributes = {\n    id: popover.ids.popup,\n    popover: \"auto\",\n    role: \"menu\",\n    \"aria-labelledby\": menu.triggerId,\n    // The popup itself takes focus as the last resort when a menu has no items.\n    tabIndex: -1,\n    ...(experimental_focusgroup && { focusgroup: `menu ${loop ? \"wrap\" : \"nowrap\"}` }),\n    onKeyDown,\n    onBlur,\n    onMouseDown,\n    ...(submenu && {\n      onPointerEnter: (event: PointerEvent<HTMLElement>) => {\n        if (event.pointerType !== \"touch\") menu.timers.cancelClose();\n      },\n      onPointerLeave: (event: PointerEvent<HTMLElement>) => {\n        if (event.pointerType !== \"touch\") scheduleHoverClose(menu, event.nativeEvent);\n      },\n    }),\n    ...(side !== null && { \"data-side\": side, \"data-align\": align }),\n  };\n\n  const content = (s: MenuPopupState): ReactNode => {\n    let node: ReactNode;\n    if (keepMounted === true) {\n      node = (\n        <Activity mode={visible ? \"visible\" : \"hidden\"}>\n          {wrapContent(resolveStateValue(children, s))}\n        </Activity>\n      );\n    } else {\n      node = visible ? wrapContent(resolveStateValue(children, s)) : null;\n    }\n    return <MenuListContext value={listContext}>{node}</MenuListContext>;\n  };\n\n  const element = useRender<ComponentPropsWithRef<\"div\">, MenuPopupState>({\n    defaultElement: \"div\",\n    render,\n    state,\n    className,\n    // The inline placement sits under the consumer's style: the consumer wins.\n    style:\n      side === null\n        ? style\n        : (s) => ({\n            positionArea: positionArea(side, align),\n            positionTryFallbacks: submenu ? \"flip-inline\" : POSITION_TRY_FALLBACKS,\n            ...resolveStateValue(style, s),\n          }),\n    children: content,\n    props: rest,\n    libraryProps,\n    ref,\n  });\n\n  return useTransitionBoundary(\"Menu.Popup\", transition, element);\n}\n\nMenuPopup.displayName = \"MenuPopup\";\n"],"mappings":"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"}

package/dist/menu/menu-radio-group.d.mts

@@ -0,0 +1,37 @@
+import { ChangeAction, RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/menu/menu-radio-group.d.ts
+export interface MenuRadioGroupState {
+  /** Optimistic value; `null` when no item is selected. */
+  readonly value: string | null;
+  /** `valueChangeAction` is in flight. */
+  readonly pending: boolean;
+}
+export interface MenuRadioGroupProps extends Omit<ComponentPropsWithRef<"div">, "role" | "defaultValue" | "className" | "style" | "children"> {
+  /** Controlled value; `null` selects nothing, `undefined` means uncontrolled. */
+  value?: string | null;
+  /** Initial value when uncontrolled. Default `null`. */
+  defaultValue?: string | null;
+  /**
+   * Receives the chosen item's `value`, awaited inside the group's transition; the items'
+   * `aria-checked` follow at once and roll back on rejection. Re-activating the selected item
+   * dispatches nothing. May be a Server Function.
+   */
+  valueChangeAction?: ChangeAction<string>;
+  className?: StateValue<string | undefined, MenuRadioGroupState>;
+  style?: StateValue<CSSProperties | undefined, MenuRadioGroupState>;
+  children?: StateValue<ReactNode, MenuRadioGroupState>;
+  render?: RenderProp<ComponentPropsWithRef<"div">, MenuRadioGroupState>;
+}
+/**
+ * The state owner of a set of `Menu.RadioItem`s: `<div role="group" aria-labelledby>` (named by
+ * a `Menu.GroupLabel` inside it). Emits `data-pending` while `valueChangeAction` runs.
+ *
+ * Owned keys (conventions 1.2): `role`, `aria-labelledby` (token-merged), `data-pending`.
+ */
+export declare function MenuRadioGroup({ value, defaultValue, valueChangeAction, className, style, children, render, ...rest }: MenuRadioGroupProps): import("react").JSX.Element;
+export declare namespace MenuRadioGroup {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=menu-radio-group.d.mts.map

package/dist/menu/menu-radio-group.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-radio-group.d.mts","names":[],"sources":["../../src/menu/menu-radio-group.tsx"],"mappings":";;;iBAYiB;;WAEN;;WAEA;;iBAGM,4BAA4B,KAC3C;;EAIA;;EAEA;;;;;;EAMA,oBAAoB;EACpB,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,8BAA8B;;;;;;;;wBASpC,iBACd,OACA,cACA,mBACA,WACA,OACA,UACA,WACG,QACF,sCAAmB,IAAA;yBATN"}

package/dist/menu/menu-radio-group.mjs

@@ -0,0 +1,72 @@
+"use client";
+import { createActionDetails } from "../internal/action-details.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { transitionTypes } from "../internal/transition-types.mjs";
+import { useControllableAction } from "../internal/use-controllable-action.mjs";
+import { useRender } from "../internal/use-render.mjs";
+import { MenuGroupContext, MenuRadioGroupContext } from "./menu-context.mjs";
+import { useId, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/menu/menu-radio-group.tsx
+/**
+* The state owner of a set of `Menu.RadioItem`s: `<div role="group" aria-labelledby>` (named by
+* a `Menu.GroupLabel` inside it). Emits `data-pending` while `valueChangeAction` runs.
+*
+* Owned keys (conventions 1.2): `role`, `aria-labelledby` (token-merged), `data-pending`.
+*/
+function MenuRadioGroup({ value, defaultValue, valueChangeAction, className, style, children, render, ...rest }) {
+	const labelId = `${useId()}-label`;
+	const after = useRef(/* @__PURE__ */ new WeakMap());
+	const { optimistic, pending, dispatch } = useControllableAction({
+		controlled: value,
+		defaultValue,
+		initialValue: null,
+		action: async (next, details) => {
+			if (next !== null) await valueChangeAction?.(next, details);
+			after.current.get(details)?.();
+		},
+		transitionTypes: () => transitionTypes("menu", "select"),
+		warn: {
+			component: "Menu.RadioGroup",
+			prop: "value"
+		}
+	});
+	const context = {
+		value: optimistic,
+		pending,
+		select: (next, event, then) => {
+			const details = createActionDetails(event, {});
+			if (then !== void 0) after.current.set(details, then);
+			dispatch(next, details);
+		}
+	};
+	const element = useRender({
+		defaultElement: "div",
+		render,
+		state: {
+			value: optimistic,
+			pending
+		},
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: {
+			role: "group",
+			"aria-labelledby": labelId,
+			"data-pending": dataAttr(pending)
+		}
+	});
+	return /* @__PURE__ */ jsx(MenuGroupContext, {
+		value: { labelId },
+		children: /* @__PURE__ */ jsx(MenuRadioGroupContext, {
+			value: context,
+			children: element
+		})
+	});
+}
+MenuRadioGroup.displayName = "MenuRadioGroup";
+//#endregion
+export { MenuRadioGroup };
+
+//# sourceMappingURL=menu-radio-group.mjs.map

package/dist/menu/menu-radio-group.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-radio-group.mjs","names":[],"sources":["../../src/menu/menu-radio-group.tsx"],"sourcesContent":["\"use client\";\nimport { useId, useRef } from \"react\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport { createActionDetails } from \"../internal/action-details.js\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport { transitionTypes } from \"../internal/transition-types.js\";\nimport type { ActionDetails, ChangeAction, RenderProp, StateValue } from \"../internal/types.js\";\nimport { useControllableAction } from \"../internal/use-controllable-action.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { MenuGroupContext, MenuRadioGroupContext } from \"./menu-context.js\";\nimport type { MenuRadioGroupContextValue } from \"./menu-context.js\";\n\nexport interface MenuRadioGroupState {\n  /** Optimistic value; `null` when no item is selected. */\n  readonly value: string | null;\n  /** `valueChangeAction` is in flight. */\n  readonly pending: boolean;\n}\n\nexport interface MenuRadioGroupProps extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"role\" | \"defaultValue\" | \"className\" | \"style\" | \"children\"\n> {\n  /** Controlled value; `null` selects nothing, `undefined` means uncontrolled. */\n  value?: string | null;\n  /** Initial value when uncontrolled. Default `null`. */\n  defaultValue?: string | null;\n  /**\n   * Receives the chosen item's `value`, awaited inside the group's transition; the items'\n   * `aria-checked` follow at once and roll back on rejection. Re-activating the selected item\n   * dispatches nothing. May be a Server Function.\n   */\n  valueChangeAction?: ChangeAction<string>;\n  className?: StateValue<string | undefined, MenuRadioGroupState>;\n  style?: StateValue<CSSProperties | undefined, MenuRadioGroupState>;\n  children?: StateValue<ReactNode, MenuRadioGroupState>;\n  render?: RenderProp<ComponentPropsWithRef<\"div\">, MenuRadioGroupState>;\n}\n\n/**\n * The state owner of a set of `Menu.RadioItem`s: `<div role=\"group\" aria-labelledby>` (named by\n * a `Menu.GroupLabel` inside it). Emits `data-pending` while `valueChangeAction` runs.\n *\n * Owned keys (conventions 1.2): `role`, `aria-labelledby` (token-merged), `data-pending`.\n */\nexport function MenuRadioGroup({\n  value,\n  defaultValue,\n  valueChangeAction,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: MenuRadioGroupProps) {\n  const labelId = `${useId()}-label`;\n  // The work to run after a dispatch's action resolved (an item's `closeOnActivate`), keyed by\n  // the dispatch's details object.\n  const after = useRef(new WeakMap<object, () => void>());\n\n  const { optimistic, pending, dispatch } = useControllableAction<string | null>({\n    controlled: value,\n    defaultValue,\n    initialValue: null,\n    action: async (next, details) => {\n      if (next !== null) await valueChangeAction?.(next, details);\n      after.current.get(details)?.();\n    },\n    transitionTypes: () => transitionTypes(\"menu\", \"select\"),\n    warn: { component: \"Menu.RadioGroup\", prop: \"value\" },\n  });\n\n  const context: MenuRadioGroupContextValue = {\n    value: optimistic,\n    pending,\n    select: (next, event, then) => {\n      const details = createActionDetails(event, {}) as ActionDetails;\n      if (then !== undefined) after.current.set(details, then);\n      dispatch(next, details);\n    },\n  };\n\n  const state: MenuRadioGroupState = { value: optimistic, pending };\n\n  const element = useRender<ComponentPropsWithRef<\"div\">, MenuRadioGroupState>({\n    defaultElement: \"div\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: {\n      role: \"group\",\n      \"aria-labelledby\": labelId,\n      \"data-pending\": dataAttr(pending),\n    },\n  });\n\n  return (\n    <MenuGroupContext value={{ labelId }}>\n      <MenuRadioGroupContext value={context}>{element}</MenuRadioGroupContext>\n    </MenuGroupContext>\n  );\n}\n\nMenuRadioGroup.displayName = \"MenuRadioGroup\";\n"],"mappings":";;;;;;;;;;;;;;;;AA6CA,SAAgB,eAAe,EAC7B,OACA,cACA,mBACA,WACA,OACA,UACA,QACA,GAAG,QACmB;CACtB,MAAM,UAAU,GAAG,MAAM,EAAE;CAG3B,MAAM,QAAQ,uBAAO,IAAI,QAA4B,CAAC;CAEtD,MAAM,EAAE,YAAY,SAAS,aAAa,sBAAqC;EAC7E,YAAY;EACZ;EACA,cAAc;EACd,QAAQ,OAAO,MAAM,YAAY;GAC/B,IAAI,SAAS,MAAM,MAAM,oBAAoB,MAAM,OAAO;GAC1D,MAAM,QAAQ,IAAI,OAAO,CAAC,GAAG;EAC/B;EACA,uBAAuB,gBAAgB,QAAQ,QAAQ;EACvD,MAAM;GAAE,WAAW;GAAmB,MAAM;EAAQ;CACtD,CAAC;CAED,MAAM,UAAsC;EAC1C,OAAO;EACP;EACA,SAAS,MAAM,OAAO,SAAS;GAC7B,MAAM,UAAU,oBAAoB,OAAO,CAAC,CAAC;GAC7C,IAAI,SAAS,KAAA,GAAW,MAAM,QAAQ,IAAI,SAAS,IAAI;GACvD,SAAS,MAAM,OAAO;EACxB;CACF;CAIA,MAAM,UAAU,UAA6D;EAC3E,gBAAgB;EAChB;EACA,OAAA;GALmC,OAAO;GAAY;EAKlD;EACJ;EACA;EACA;EACA,OAAO;EACP,cAAc;GACZ,MAAM;GACN,mBAAmB;GACnB,gBAAgB,SAAS,OAAO;EAClC;CACF,CAAC;CAED,OACE,oBAAC,kBAAD;EAAkB,OAAO,EAAE,QAAQ;EACjC,UAAA,oBAAC,uBAAD;GAAuB,OAAO;GAAU,UAAA;EAA+B,CAAA;CACvD,CAAA;AAEtB;AAEA,eAAe,cAAc"}

package/dist/menu/menu-radio-item.d.mts

@@ -0,0 +1,33 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { MenuCheckboxItemProps } from "./menu-checkbox-item.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/menu/menu-radio-item.d.ts
+export interface MenuRadioItemState {
+  /** This item is the group's optimistic value (`aria-checked`). */
+  readonly checked: boolean;
+  /** The group's change to this item is in flight. */
+  readonly pending: boolean;
+  readonly disabled: boolean;
+}
+export interface MenuRadioItemProps extends Omit<MenuCheckboxItemProps, "checked" | "defaultChecked" | "checkedChangeAction" | "className" | "style" | "children" | "render"> {
+  /** The value the group's `valueChangeAction` receives when this item is chosen. */
+  value: string;
+  className?: StateValue<string | undefined, MenuRadioItemState>;
+  style?: StateValue<CSSProperties | undefined, MenuRadioItemState>;
+  children?: StateValue<ReactNode, MenuRadioItemState>;
+  render?: RenderProp<ComponentPropsWithRef<"button">, MenuRadioItemState>;
+}
+/**
+ * One option of a `Menu.RadioGroup`: `<button type="button" role="menuitemradio" aria-checked>`.
+ * Activation selects it through the group's transition (nothing is dispatched when it is already
+ * selected); the menu stays open unless `closeOnActivate`.
+ *
+ * Owned keys (conventions 1.2): those of `Menu.Item`, plus `aria-checked`, `data-checked`, and
+ * `value` (not rendered: a menu item is not a form control).
+ */
+export declare function MenuRadioItem({ value, closeOnActivate, disabled, label, className, style, children, render, ...rest }: MenuRadioItemProps): ReactNode;
+export declare namespace MenuRadioItem {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=menu-radio-item.d.mts.map

package/dist/menu/menu-radio-item.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-radio-item.d.mts","names":[],"sources":["../../src/menu/menu-radio-item.tsx"],"mappings":";;;;iBAUiB;;WAEN;;WAEA;WACA;;iBAGM,2BAA2B,KAC1C;;EAUA;EACA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,iCAAiC;;;;;;;;;;wBAWvC,gBACd,OACA,iBACA,UACA,OACA,WACA,OACA,UACA,WACG,QACF,qBAAkB;yBAVL"}

package/dist/menu/menu-radio-item.mjs

@@ -0,0 +1,62 @@
+"use client";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { rendersButton, useRender } from "../internal/use-render.mjs";
+import { MenuRadioGroupContext, closeStackLater, useMenuContext } from "./menu-context.mjs";
+import { useMenuItem } from "./use-menu-item.mjs";
+import { use } from "react";
+//#region src/menu/menu-radio-item.tsx
+/**
+* One option of a `Menu.RadioGroup`: `<button type="button" role="menuitemradio" aria-checked>`.
+* Activation selects it through the group's transition (nothing is dispatched when it is already
+* selected); the menu stays open unless `closeOnActivate`.
+*
+* Owned keys (conventions 1.2): those of `Menu.Item`, plus `aria-checked`, `data-checked`, and
+* `value` (not rendered: a menu item is not a form control).
+*/
+function MenuRadioItem({ value, closeOnActivate = false, disabled = false, label, className, style, children, render, ...rest }) {
+	const menu = useMenuContext("Menu.RadioItem");
+	const group = use(MenuRadioGroupContext);
+	if (group === null) throw new Error("Menu.RadioItem must be rendered inside a Menu.RadioGroup.");
+	const checked = group.value === value;
+	const pending = group.pending && checked;
+	const { libraryProps } = useMenuItem({
+		part: "Menu.RadioItem",
+		role: "menuitemradio",
+		disabled,
+		label,
+		activate: (event) => {
+			const close = closeOnActivate ? closeStackLater(menu, event) : void 0;
+			if (checked) {
+				close?.();
+				return;
+			}
+			group.select(value, event, close);
+		}
+	});
+	return useRender({
+		defaultElement: "button",
+		render,
+		state: {
+			checked,
+			pending,
+			disabled
+		},
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: {
+			...rendersButton(render) && { type: "button" },
+			...libraryProps,
+			value: void 0,
+			"aria-checked": checked,
+			"data-checked": dataAttr(checked),
+			"data-pending": dataAttr(pending)
+		}
+	});
+}
+MenuRadioItem.displayName = "MenuRadioItem";
+//#endregion
+export { MenuRadioItem };
+
+//# sourceMappingURL=menu-radio-item.mjs.map

package/dist/menu/menu-radio-item.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-radio-item.mjs","names":[],"sources":["../../src/menu/menu-radio-item.tsx"],"sourcesContent":["\"use client\";\nimport { use } from \"react\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { rendersButton, useRender } from \"../internal/use-render.js\";\nimport type { MenuCheckboxItemProps } from \"./menu-checkbox-item.js\";\nimport { closeStackLater, MenuRadioGroupContext, useMenuContext } from \"./menu-context.js\";\nimport { useMenuItem } from \"./use-menu-item.js\";\n\nexport interface MenuRadioItemState {\n  /** This item is the group's optimistic value (`aria-checked`). */\n  readonly checked: boolean;\n  /** The group's change to this item is in flight. */\n  readonly pending: boolean;\n  readonly disabled: boolean;\n}\n\nexport interface MenuRadioItemProps extends Omit<\n  MenuCheckboxItemProps,\n  | \"checked\"\n  | \"defaultChecked\"\n  | \"checkedChangeAction\"\n  | \"className\"\n  | \"style\"\n  | \"children\"\n  | \"render\"\n> {\n  /** The value the group's `valueChangeAction` receives when this item is chosen. */\n  value: string;\n  className?: StateValue<string | undefined, MenuRadioItemState>;\n  style?: StateValue<CSSProperties | undefined, MenuRadioItemState>;\n  children?: StateValue<ReactNode, MenuRadioItemState>;\n  render?: RenderProp<ComponentPropsWithRef<\"button\">, MenuRadioItemState>;\n}\n\n/**\n * One option of a `Menu.RadioGroup`: `<button type=\"button\" role=\"menuitemradio\" aria-checked>`.\n * Activation selects it through the group's transition (nothing is dispatched when it is already\n * selected); the menu stays open unless `closeOnActivate`.\n *\n * Owned keys (conventions 1.2): those of `Menu.Item`, plus `aria-checked`, `data-checked`, and\n * `value` (not rendered: a menu item is not a form control).\n */\nexport function MenuRadioItem({\n  value,\n  closeOnActivate = false,\n  disabled = false,\n  label,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: MenuRadioItemProps) {\n  const menu = useMenuContext(\"Menu.RadioItem\");\n  const group = use(MenuRadioGroupContext);\n  if (group === null) throw new Error(\"Menu.RadioItem must be rendered inside a Menu.RadioGroup.\");\n\n  const checked = group.value === value;\n  const pending = group.pending && checked;\n\n  const { libraryProps } = useMenuItem({\n    part: \"Menu.RadioItem\",\n    role: \"menuitemradio\",\n    disabled,\n    label,\n    activate: (event) => {\n      const close = closeOnActivate ? closeStackLater(menu, event) : undefined;\n      // Re-activating the selected item changes nothing (conventions 2.3 item 8); with\n      // `closeOnActivate` it still closes the menu, as any activation does.\n      if (checked) {\n        close?.();\n        return;\n      }\n      group.select(value, event, close);\n    },\n  });\n\n  const state: MenuRadioItemState = { checked, pending, disabled };\n\n  return useRender<ComponentPropsWithRef<\"button\">, MenuRadioItemState>({\n    defaultElement: \"button\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: {\n      ...(rendersButton(render) && { type: \"button\" as const }),\n      ...libraryProps,\n      value: undefined,\n      \"aria-checked\": checked,\n      \"data-checked\": dataAttr(checked),\n      \"data-pending\": dataAttr(pending),\n    },\n  });\n}\n\nMenuRadioItem.displayName = \"MenuRadioItem\";\n"],"mappings":";;;;;;;;;;;;;;;AA4CA,SAAgB,cAAc,EAC5B,OACA,kBAAkB,OAClB,WAAW,OACX,OACA,WACA,OACA,UACA,QACA,GAAG,QACkB;CACrB,MAAM,OAAO,eAAe,gBAAgB;CAC5C,MAAM,QAAQ,IAAI,qBAAqB;CACvC,IAAI,UAAU,MAAM,MAAM,IAAI,MAAM,2DAA2D;CAE/F,MAAM,UAAU,MAAM,UAAU;CAChC,MAAM,UAAU,MAAM,WAAW;CAEjC,MAAM,EAAE,iBAAiB,YAAY;EACnC,MAAM;EACN,MAAM;EACN;EACA;EACA,WAAW,UAAU;GACnB,MAAM,QAAQ,kBAAkB,gBAAgB,MAAM,KAAK,IAAI,KAAA;GAG/D,IAAI,SAAS;IACX,QAAQ;IACR;GACF;GACA,MAAM,OAAO,OAAO,OAAO,KAAK;EAClC;CACF,CAAC;CAID,OAAO,UAA+D;EACpE,gBAAgB;EAChB;EACA,OAAA;GALkC;GAAS;GAAS;EAKhD;EACJ;EACA;EACA;EACA,OAAO;EACP,cAAc;GACZ,GAAI,cAAc,MAAM,KAAK,EAAE,MAAM,SAAkB;GACvD,GAAG;GACH,OAAO,KAAA;GACP,gBAAgB;GAChB,gBAAgB,SAAS,OAAO;GAChC,gBAAgB,SAAS,OAAO;EAClC;CACF,CAAC;AACH;AAEA,cAAc,cAAc"}

package/dist/menu/menu-root.d.mts

@@ -0,0 +1,54 @@
+import { ActionDetails, ChangeAction, ChangeReason, StateValue } from "../internal/types.mjs";
+import { ReactNode } from "react";
+//#region src/menu/menu-root.d.ts
+/** Details passed as the second argument of `Menu.Root`'s `openChangeAction`. */
+export interface MenuOpenChangeDetails extends ActionDetails {
+  /**
+   * `"activate"`: the user acted on a part: the Trigger or SubmenuTrigger (click, Enter / Space,
+   * arrow keys), an item's activation (the close after its action), ArrowLeft in a submenu, or a
+   * foreign invoker.
+   * `"dismiss"`: Escape, a click outside, Tab or focus leaving the menu, the pointer leaving a
+   * hover-opened submenu, the parent menu closing (a submenu when the whole stack closes), script.
+   * `"platform"`: the menu was found open on mount (opened before hydration); `event` is
+   * `undefined`.
+   */
+  readonly reason: ChangeReason;
+}
+export interface MenuRootState {
+  /** Optimistic open state. Content rendered from it must not suspend. */
+  readonly open: boolean;
+  /** An open or close of this Root is in flight (its `openChangeAction`). */
+  readonly pending: boolean;
+  /** This Root is a submenu (rendered inside a `Menu.Popup`). */
+  readonly submenu: boolean;
+}
+export interface MenuRootProps {
+  /** Controlled open state. `undefined` means uncontrolled. */
+  open?: boolean;
+  /** Initial open state when uncontrolled. Opens after hydration. */
+  defaultOpen?: boolean;
+  /**
+   * Awaited for `true` (the menu opens when it resolves and the items have rendered) and for the
+   * closes the user asks a part for (Trigger toggle, an item's activation, ArrowLeft in a
+   * submenu); a notification for dismissals (Escape, a click outside, Tab, the parent menu
+   * closing). May be a Server Function. A `setState` placed after your own `await` needs
+   * `startTransition` (React limitation).
+   */
+  openChangeAction?: ChangeAction<boolean, MenuOpenChangeDetails>;
+  /** Arrow keys wrap from the last item to the first and back. Default `true`. */
+  loop?: boolean;
+  /** Submenu only: milliseconds from hovering the SubmenuTrigger to the open. Default 100. */
+  delay?: number;
+  /**
+   * Submenu only: milliseconds from the pointer leaving the SubmenuTrigger and the submenu to the
+   * close. Default 150.
+   */
+  closeDelay?: number;
+  children?: StateValue<ReactNode, MenuRootState>;
+}
+export declare function MenuRoot({ open, defaultOpen, openChangeAction, loop, delay, closeDelay, children }: MenuRootProps): import("react").JSX.Element;
+export declare namespace MenuRoot {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=menu-root.d.mts.map

package/dist/menu/menu-root.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-root.d.mts","names":[],"sources":["../../src/menu/menu-root.tsx"],"mappings":";;;;iBAYiB,8BAA8B;;;;;;;;;;WAUpC,QAAQ;;iBAGF;;WAEN;;WAEA;;WAEA;;iBAGM;;EAEf;;EAEA;;;;;;;;EAQA,mBAAmB,sBAAsB;;EAEzC;;EAEA;;;;;EAKA;EACA,WAAW,WAAW,WAAW;;wBAenB,WACd,MACA,aACA,kBACA,MACA,OACA,YACA,YACC,gCAAa,IAAA;yBARA"}

package/dist/menu/menu-root.mjs

@@ -0,0 +1,102 @@
+"use client";
+import { resolveStateValue } from "../internal/use-render.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { useDelayedPair } from "../internal/use-delayed-pair.mjs";
+import { usePopoverRoot } from "../internal/use-popover-root.mjs";
+import { MenuContext, MenuListContext } from "./menu-context.mjs";
+import { use, useCallback, useMemo, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/menu/menu-root.tsx
+/**
+* Owns the ids, the open state and the context of one menu level. Renders no DOM. A `Menu.Root`
+* rendered inside a `Menu.Popup` is a **submenu**: its Trigger is a `Menu.SubmenuTrigger` (an
+* item of the parent menu) and its Popup opens beside that item.
+*
+* A menu is always in library mode (design/components/menu.md 2.1): opening and the closes a
+* part asks for are transitions (pending Trigger, items render from committed state,
+* `showPopover()` / `hidePopover()` once the change has committed); dismissals are the
+* browser's and `openChangeAction(false)` is a notification.
+*/
+const DEFAULT_FOCUS = {
+	cause: "first",
+	pointer: false
+};
+function MenuRoot({ open, defaultOpen, openChangeAction, loop = true, delay, closeDelay, children }) {
+	const parent = use(MenuContext);
+	const list = use(MenuListContext);
+	const parentMenu = list !== null ? list.menu : null;
+	const submenu = parentMenu !== null;
+	useDevWarning(!submenu && (delay !== void 0 || closeDelay !== void 0), "Menu.Root: `delay` and `closeDelay` only apply to a submenu (a Menu.Root inside a Menu.Popup); a top-level menu does not open on hover.");
+	useDevWarning(parent !== null && !submenu, "Menu.Root: rendered inside another Menu.Root but outside its Menu.Popup. A submenu's Root goes inside the parent's Menu.Popup.");
+	const timers = useDelayedPair();
+	const nextCause = useRef(null);
+	const openCause = useRef(null);
+	const popover = usePopoverRoot({
+		component: "menu",
+		part: "Menu.Root",
+		mode: "library",
+		open,
+		defaultOpen,
+		openChangeAction,
+		onDispatch: (next) => {
+			timers.cancel();
+			if (next) openCause.current = nextCause.current ?? DEFAULT_FOCUS;
+			nextCause.current = null;
+		}
+	});
+	const setOpenCause = useCallback((cause, pointer = false) => {
+		nextCause.current = {
+			cause,
+			pointer
+		};
+	}, []);
+	const takeOpenCause = useCallback(() => {
+		const cause = openCause.current ?? DEFAULT_FOCUS;
+		openCause.current = null;
+		return cause;
+	}, []);
+	const resolvedDelay = delay ?? 100;
+	const resolvedCloseDelay = closeDelay ?? 150;
+	const value = useMemo(() => {
+		const self = {
+			popover,
+			submenu,
+			get root() {
+				return parentMenu?.root ?? self;
+			},
+			parent: parentMenu,
+			loop,
+			delay: resolvedDelay,
+			closeDelay: resolvedCloseDelay,
+			triggerId: `${popover.ids.popup}-trigger`,
+			setOpenCause,
+			takeOpenCause,
+			timers
+		};
+		return self;
+	}, [
+		popover,
+		submenu,
+		parentMenu,
+		loop,
+		resolvedDelay,
+		resolvedCloseDelay,
+		setOpenCause,
+		takeOpenCause,
+		timers
+	]);
+	const state = {
+		open: popover.optimistic,
+		pending: popover.pending,
+		submenu
+	};
+	return /* @__PURE__ */ jsx(MenuContext, {
+		value,
+		children: resolveStateValue(children, state)
+	});
+}
+MenuRoot.displayName = "MenuRoot";
+//#endregion
+export { MenuRoot };
+
+//# sourceMappingURL=menu-root.mjs.map

package/dist/menu/menu-root.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-root.mjs","names":[],"sources":["../../src/menu/menu-root.tsx"],"sourcesContent":["\"use client\";\nimport { use, useCallback, useMemo, useRef } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { ActionDetails, ChangeAction, ChangeReason, StateValue } from \"../internal/types.js\";\nimport { useDelayedPair } from \"../internal/use-delayed-pair.js\";\nimport { useDevWarning } from \"../internal/use-dev-warning.js\";\nimport { usePopoverRoot } from \"../internal/use-popover-root.js\";\nimport { resolveStateValue } from \"../internal/use-render.js\";\nimport { MenuContext, MenuListContext } from \"./menu-context.js\";\nimport type { MenuContextValue, MenuOpenFocus } from \"./menu-context.js\";\n\n/** Details passed as the second argument of `Menu.Root`'s `openChangeAction`. */\nexport interface MenuOpenChangeDetails extends ActionDetails {\n  /**\n   * `\"activate\"`: the user acted on a part: the Trigger or SubmenuTrigger (click, Enter / Space,\n   * arrow keys), an item's activation (the close after its action), ArrowLeft in a submenu, or a\n   * foreign invoker.\n   * `\"dismiss\"`: Escape, a click outside, Tab or focus leaving the menu, the pointer leaving a\n   * hover-opened submenu, the parent menu closing (a submenu when the whole stack closes), script.\n   * `\"platform\"`: the menu was found open on mount (opened before hydration); `event` is\n   * `undefined`.\n   */\n  readonly reason: ChangeReason;\n}\n\nexport interface MenuRootState {\n  /** Optimistic open state. Content rendered from it must not suspend. */\n  readonly open: boolean;\n  /** An open or close of this Root is in flight (its `openChangeAction`). */\n  readonly pending: boolean;\n  /** This Root is a submenu (rendered inside a `Menu.Popup`). */\n  readonly submenu: boolean;\n}\n\nexport interface MenuRootProps {\n  /** Controlled open state. `undefined` means uncontrolled. */\n  open?: boolean;\n  /** Initial open state when uncontrolled. Opens after hydration. */\n  defaultOpen?: boolean;\n  /**\n   * Awaited for `true` (the menu opens when it resolves and the items have rendered) and for the\n   * closes the user asks a part for (Trigger toggle, an item's activation, ArrowLeft in a\n   * submenu); a notification for dismissals (Escape, a click outside, Tab, the parent menu\n   * closing). May be a Server Function. A `setState` placed after your own `await` needs\n   * `startTransition` (React limitation).\n   */\n  openChangeAction?: ChangeAction<boolean, MenuOpenChangeDetails>;\n  /** Arrow keys wrap from the last item to the first and back. Default `true`. */\n  loop?: boolean;\n  /** Submenu only: milliseconds from hovering the SubmenuTrigger to the open. Default 100. */\n  delay?: number;\n  /**\n   * Submenu only: milliseconds from the pointer leaving the SubmenuTrigger and the submenu to the\n   * close. Default 150.\n   */\n  closeDelay?: number;\n  children?: StateValue<ReactNode, MenuRootState>;\n}\n\n/**\n * Owns the ids, the open state and the context of one menu level. Renders no DOM. A `Menu.Root`\n * rendered inside a `Menu.Popup` is a **submenu**: its Trigger is a `Menu.SubmenuTrigger` (an\n * item of the parent menu) and its Popup opens beside that item.\n *\n * A menu is always in library mode (design/components/menu.md 2.1): opening and the closes a\n * part asks for are transitions (pending Trigger, items render from committed state,\n * `showPopover()` / `hidePopover()` once the change has committed); dismissals are the\n * browser's and `openChangeAction(false)` is a notification.\n */\nconst DEFAULT_FOCUS: MenuOpenFocus = { cause: \"first\", pointer: false };\n\nexport function MenuRoot({\n  open,\n  defaultOpen,\n  openChangeAction,\n  loop = true,\n  delay,\n  closeDelay,\n  children,\n}: MenuRootProps) {\n  const parent = use(MenuContext);\n  const list = use(MenuListContext);\n  // A Root inside a Popup's content is a submenu (design 1); the enclosing menu is the Popup's.\n  const parentMenu = list !== null ? list.menu : null;\n  const submenu = parentMenu !== null;\n\n  useDevWarning(\n    !submenu && (delay !== undefined || closeDelay !== undefined),\n    \"Menu.Root: `delay` and `closeDelay` only apply to a submenu (a Menu.Root inside a \" +\n      \"Menu.Popup); a top-level menu does not open on hover.\",\n  );\n  useDevWarning(\n    parent !== null && !submenu,\n    \"Menu.Root: rendered inside another Menu.Root but outside its Menu.Popup. A submenu's Root \" +\n      \"goes inside the parent's Menu.Popup.\",\n  );\n\n  const timers = useDelayedPair();\n  // The cause recorded by the part about to dispatch an open, and the cause of the open being\n  // shown (design 14, \"Open cause\").\n  const nextCause = useRef<MenuOpenFocus | null>(null);\n  const openCause = useRef<MenuOpenFocus | null>(null);\n\n  const popover = usePopoverRoot<MenuOpenChangeDetails>({\n    component: \"menu\",\n    part: \"Menu.Root\",\n    mode: \"library\",\n    open,\n    defaultOpen,\n    openChangeAction,\n    onDispatch: (next) => {\n      // Any dispatch cancels hover intent (walkthrough 9).\n      timers.cancel();\n      if (next) openCause.current = nextCause.current ?? DEFAULT_FOCUS;\n      nextCause.current = null;\n    },\n  });\n\n  const setOpenCause = useCallback((cause: MenuOpenFocus[\"cause\"], pointer = false) => {\n    nextCause.current = { cause, pointer };\n  }, []);\n  const takeOpenCause = useCallback(() => {\n    const cause = openCause.current ?? DEFAULT_FOCUS;\n    openCause.current = null;\n    return cause;\n  }, []);\n\n  const resolvedDelay = delay ?? 100;\n  const resolvedCloseDelay = closeDelay ?? 150;\n  // Note: `popover` is a new object on every render (the shared `usePopoverRoot` is not memoised:\n  // its `dispatch` closes over the render's state), so today this recomputes on every render of\n  // the Root and the parts re-render with it, as Popover's do. The other members are stable; the\n  // memo starts to hit without further change once that hook returns a stable value.\n  const value = useMemo<MenuContextValue>(() => {\n    const self: MenuContextValue = {\n      popover,\n      submenu,\n      // The top-level menu: this one, or the parent's root (design 2.2).\n      get root() {\n        return parentMenu?.root ?? self;\n      },\n      parent: parentMenu,\n      loop,\n      delay: resolvedDelay,\n      closeDelay: resolvedCloseDelay,\n      triggerId: `${popover.ids.popup}-trigger`,\n      setOpenCause,\n      takeOpenCause,\n      timers,\n    };\n    return self;\n  }, [\n    popover,\n    submenu,\n    parentMenu,\n    loop,\n    resolvedDelay,\n    resolvedCloseDelay,\n    setOpenCause,\n    takeOpenCause,\n    timers,\n  ]);\n\n  const state: MenuRootState = {\n    open: popover.optimistic,\n    pending: popover.pending,\n    submenu,\n  };\n\n  return <MenuContext value={value}>{resolveStateValue(children, state)}</MenuContext>;\n}\n\nMenuRoot.displayName = \"MenuRoot\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqEA,MAAM,gBAA+B;CAAE,OAAO;CAAS,SAAS;AAAM;AAEtE,SAAgB,SAAS,EACvB,MACA,aACA,kBACA,OAAO,MACP,OACA,YACA,YACgB;CAChB,MAAM,SAAS,IAAI,WAAW;CAC9B,MAAM,OAAO,IAAI,eAAe;CAEhC,MAAM,aAAa,SAAS,OAAO,KAAK,OAAO;CAC/C,MAAM,UAAU,eAAe;CAE/B,cACE,CAAC,YAAY,UAAU,KAAA,KAAa,eAAe,KAAA,IACnD,yIAEF;CACA,cACE,WAAW,QAAQ,CAAC,SACpB,gIAEF;CAEA,MAAM,SAAS,eAAe;CAG9B,MAAM,YAAY,OAA6B,IAAI;CACnD,MAAM,YAAY,OAA6B,IAAI;CAEnD,MAAM,UAAU,eAAsC;EACpD,WAAW;EACX,MAAM;EACN,MAAM;EACN;EACA;EACA;EACA,aAAa,SAAS;GAEpB,OAAO,OAAO;GACd,IAAI,MAAM,UAAU,UAAU,UAAU,WAAW;GACnD,UAAU,UAAU;EACtB;CACF,CAAC;CAED,MAAM,eAAe,aAAa,OAA+B,UAAU,UAAU;EACnF,UAAU,UAAU;GAAE;GAAO;EAAQ;CACvC,GAAG,CAAC,CAAC;CACL,MAAM,gBAAgB,kBAAkB;EACtC,MAAM,QAAQ,UAAU,WAAW;EACnC,UAAU,UAAU;EACpB,OAAO;CACT,GAAG,CAAC,CAAC;CAEL,MAAM,gBAAgB,SAAS;CAC/B,MAAM,qBAAqB,cAAc;CAKzC,MAAM,QAAQ,cAAgC;EAC5C,MAAM,OAAyB;GAC7B;GACA;GAEA,IAAI,OAAO;IACT,OAAO,YAAY,QAAQ;GAC7B;GACA,QAAQ;GACR;GACA,OAAO;GACP,YAAY;GACZ,WAAW,GAAG,QAAQ,IAAI,MAAM;GAChC;GACA;GACA;EACF;EACA,OAAO;CACT,GAAG;EACD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAED,MAAM,QAAuB;EAC3B,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB;CACF;CAEA,OAAO,oBAAC,aAAD;EAAoB;EAAQ,UAAA,kBAAkB,UAAU,KAAK;CAAe,CAAA;AACrF;AAEA,SAAS,cAAc"}

package/dist/menu/menu-submenu-trigger.d.mts

@@ -0,0 +1,31 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { MenuItemProps } from "./menu-item.mjs";
+import { MenuTriggerState } from "./menu-trigger.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/menu/menu-submenu-trigger.d.ts
+export type MenuSubmenuTriggerState = MenuTriggerState;
+export interface MenuSubmenuTriggerProps extends Omit<MenuItemProps, "action" | "closeOnActivate" | "aria-expanded" | "aria-haspopup" | "onPointerEnter" | "onPointerLeave" | "className" | "style" | "children" | "render"> {
+  className?: StateValue<string | undefined, MenuSubmenuTriggerState>;
+  style?: StateValue<CSSProperties | undefined, MenuSubmenuTriggerState>;
+  /** Rendered from optimistic state; must not suspend. */
+  children?: StateValue<ReactNode, MenuSubmenuTriggerState>;
+  render?: RenderProp<ComponentPropsWithRef<"button">, MenuSubmenuTriggerState>;
+}
+/**
+ * The item that opens a submenu: an item of the parent menu (`role="menuitem"`, roving
+ * `tabindex`, typeahead) and the Trigger of the submenu's Root (`commandfor`,
+ * `command="toggle-popover"`, `aria-haspopup="menu"`, `aria-expanded`). ArrowRight (ArrowLeft in
+ * RTL), Enter, Space or a click open the submenu with its first item focused; hovering it opens
+ * the submenu after the Root's `delay` and leaves focus where it is.
+ *
+ * Owned keys (conventions 1.2): the Trigger's (`type`, `id`, `commandfor`, `command`,
+ * `aria-haspopup`, `aria-expanded`, `data-open`, `data-pending`) and the item's (`role`,
+ * `tabIndex`, `disabled` (absent), `aria-disabled`, `data-disabled`, `data-typeahead`,
+ * `onClick`, `onKeyDown`, `onPointerMove`, `onPointerEnter`, `onPointerLeave`).
+ */
+export declare function MenuSubmenuTrigger({ disabled, label, className, style, children, render, ...rest }: MenuSubmenuTriggerProps): ReactNode;
+export declare namespace MenuSubmenuTrigger {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=menu-submenu-trigger.d.mts.map

package/dist/menu/menu-submenu-trigger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-submenu-trigger.d.mts","names":[],"sources":["../../src/menu/menu-submenu-trigger.tsx"],"mappings":";;;;;YAoBY,0BAA0B;iBAErB,gCAAgC,KAC/C;EAYA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;EAE9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,iCAAiC;;;;;;;;;;;;;;wBAevC,qBACd,UACA,OACA,WACA,OACA,UACA,WACG,QACF,0BAAuB;yBARV"}

package/dist/menu/menu-submenu-trigger.mjs

@@ -0,0 +1,92 @@
+"use client";
+import { useRender } from "../internal/use-render.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { usePopoverTrigger } from "../internal/use-popover-trigger.mjs";
+import { useMenuContext } from "./menu-context.mjs";
+import { hasModifier, isRtl } from "./menu-dom.mjs";
+import { useMenuItem } from "./use-menu-item.mjs";
+import { scheduleHoverClose } from "./menu-hover.mjs";
+import { openMenuWithFocus } from "./menu-trigger.mjs";
+//#region src/menu/menu-submenu-trigger.tsx
+/**
+* The item that opens a submenu: an item of the parent menu (`role="menuitem"`, roving
+* `tabindex`, typeahead) and the Trigger of the submenu's Root (`commandfor`,
+* `command="toggle-popover"`, `aria-haspopup="menu"`, `aria-expanded`). ArrowRight (ArrowLeft in
+* RTL), Enter, Space or a click open the submenu with its first item focused; hovering it opens
+* the submenu after the Root's `delay` and leaves focus where it is.
+*
+* Owned keys (conventions 1.2): the Trigger's (`type`, `id`, `commandfor`, `command`,
+* `aria-haspopup`, `aria-expanded`, `data-open`, `data-pending`) and the item's (`role`,
+* `tabIndex`, `disabled` (absent), `aria-disabled`, `data-disabled`, `data-typeahead`,
+* `onClick`, `onKeyDown`, `onPointerMove`, `onPointerEnter`, `onPointerLeave`).
+*/
+function MenuSubmenuTrigger({ disabled = false, label, className, style, children, render, ...rest }) {
+	const menu = useMenuContext("Menu.SubmenuTrigger");
+	useDevWarning(!menu.submenu, "Menu.SubmenuTrigger: rendered in a top-level Menu.Root. Use Menu.Trigger, or put this Root inside the parent's Menu.Popup.");
+	const open = (event) => openMenuWithFocus(menu, event, "first");
+	const item = useMenuItem({
+		part: "Menu.SubmenuTrigger",
+		role: "menuitem",
+		disabled,
+		label,
+		activate: open
+	});
+	const onKeyDown = (event) => {
+		if (event.defaultPrevented || hasModifier(event) || disabled) return;
+		const parentPopup = event.currentTarget.closest("[role=\"menu\"]");
+		const forward = parentPopup !== null && isRtl(parentPopup) ? "ArrowLeft" : "ArrowRight";
+		if (event.key !== forward) return;
+		event.preventDefault();
+		open(event.nativeEvent);
+	};
+	const { state, libraryProps, ref } = usePopoverTrigger(menu.popover, {
+		part: "Menu.SubmenuTrigger",
+		disabled,
+		render,
+		disabledAs: "aria",
+		handlers: {
+			onKeyDown: (event) => {
+				item.libraryProps.onKeyDown(event);
+				onKeyDown(event);
+			},
+			onPointerMove: item.libraryProps.onPointerMove,
+			onPointerEnter: (event) => {
+				if (disabled || event.pointerType === "touch") return;
+				const native = event.nativeEvent;
+				menu.timers.open(menu.delay, () => {
+					menu.setOpenCause("none");
+					menu.popover.requestOpen(native, "activate");
+				});
+			},
+			onPointerLeave: (event) => {
+				if (event.pointerType === "touch") return;
+				if (menu.popover.intended()) scheduleHoverClose(menu, event.nativeEvent);
+				else menu.timers.cancel();
+			}
+		},
+		activate: (event) => open(event.nativeEvent)
+	});
+	return useRender({
+		defaultElement: "button",
+		render,
+		state,
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: {
+			...libraryProps,
+			role: item.libraryProps.role,
+			tabIndex: item.libraryProps.tabIndex,
+			"data-typeahead": item.libraryProps["data-typeahead"],
+			id: menu.triggerId,
+			"aria-haspopup": "menu"
+		},
+		ref
+	});
+}
+MenuSubmenuTrigger.displayName = "MenuSubmenuTrigger";
+//#endregion
+export { MenuSubmenuTrigger };
+
+//# sourceMappingURL=menu-submenu-trigger.mjs.map

package/dist/menu/menu-submenu-trigger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-submenu-trigger.mjs","names":[],"sources":["../../src/menu/menu-submenu-trigger.tsx"],"sourcesContent":["\"use client\";\nimport type {\n  ComponentPropsWithRef,\n  CSSProperties,\n  KeyboardEvent,\n  PointerEvent,\n  ReactNode,\n} from \"react\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { useDevWarning } from \"../internal/use-dev-warning.js\";\nimport { usePopoverTrigger } from \"../internal/use-popover-trigger.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { useMenuContext } from \"./menu-context.js\";\nimport { hasModifier, isRtl } from \"./menu-dom.js\";\nimport { scheduleHoverClose } from \"./menu-hover.js\";\nimport type { MenuItemProps } from \"./menu-item.js\";\nimport { openMenuWithFocus } from \"./menu-trigger.js\";\nimport type { MenuTriggerState } from \"./menu-trigger.js\";\nimport { useMenuItem } from \"./use-menu-item.js\";\n\nexport type MenuSubmenuTriggerState = MenuTriggerState;\n\nexport interface MenuSubmenuTriggerProps extends Omit<\n  MenuItemProps,\n  | \"action\"\n  | \"closeOnActivate\"\n  | \"aria-expanded\"\n  | \"aria-haspopup\"\n  | \"onPointerEnter\"\n  | \"onPointerLeave\"\n  | \"className\"\n  | \"style\"\n  | \"children\"\n  | \"render\"\n> {\n  className?: StateValue<string | undefined, MenuSubmenuTriggerState>;\n  style?: StateValue<CSSProperties | undefined, MenuSubmenuTriggerState>;\n  /** Rendered from optimistic state; must not suspend. */\n  children?: StateValue<ReactNode, MenuSubmenuTriggerState>;\n  render?: RenderProp<ComponentPropsWithRef<\"button\">, MenuSubmenuTriggerState>;\n}\n\n/**\n * The item that opens a submenu: an item of the parent menu (`role=\"menuitem\"`, roving\n * `tabindex`, typeahead) and the Trigger of the submenu's Root (`commandfor`,\n * `command=\"toggle-popover\"`, `aria-haspopup=\"menu\"`, `aria-expanded`). ArrowRight (ArrowLeft in\n * RTL), Enter, Space or a click open the submenu with its first item focused; hovering it opens\n * the submenu after the Root's `delay` and leaves focus where it is.\n *\n * Owned keys (conventions 1.2): the Trigger's (`type`, `id`, `commandfor`, `command`,\n * `aria-haspopup`, `aria-expanded`, `data-open`, `data-pending`) and the item's (`role`,\n * `tabIndex`, `disabled` (absent), `aria-disabled`, `data-disabled`, `data-typeahead`,\n * `onClick`, `onKeyDown`, `onPointerMove`, `onPointerEnter`, `onPointerLeave`).\n */\nexport function MenuSubmenuTrigger({\n  disabled = false,\n  label,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: MenuSubmenuTriggerProps) {\n  const menu = useMenuContext(\"Menu.SubmenuTrigger\");\n  useDevWarning(\n    !menu.submenu,\n    \"Menu.SubmenuTrigger: rendered in a top-level Menu.Root. Use Menu.Trigger, or put this Root \" +\n      \"inside the parent's Menu.Popup.\",\n  );\n\n  const open = (event: Event) => openMenuWithFocus(menu, event, \"first\");\n\n  // The item half: role, roving tabindex, aria-disabled, Enter / Space, pointer focus. Its\n  // activation is the click, which the trigger half handles (`activate` below).\n  const item = useMenuItem({\n    part: \"Menu.SubmenuTrigger\",\n    role: \"menuitem\",\n    disabled,\n    label,\n    activate: open,\n  });\n\n  const onKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {\n    if (event.defaultPrevented || hasModifier(event) || disabled) return;\n    const parentPopup = event.currentTarget.closest('[role=\"menu\"]');\n    const forward = parentPopup !== null && isRtl(parentPopup) ? \"ArrowLeft\" : \"ArrowRight\";\n    if (event.key !== forward) return;\n    event.preventDefault();\n    open(event.nativeEvent);\n  };\n\n  const { state, libraryProps, ref } = usePopoverTrigger(menu.popover, {\n    part: \"Menu.SubmenuTrigger\",\n    disabled,\n    render,\n    disabledAs: \"aria\",\n    // Item first (Enter / Space activation, pointer focus), then the submenu keys.\n    handlers: {\n      onKeyDown: (event) => {\n        item.libraryProps.onKeyDown(event);\n        onKeyDown(event);\n      },\n      onPointerMove: item.libraryProps.onPointerMove,\n      onPointerEnter: (event: PointerEvent<HTMLButtonElement>) => {\n        if (disabled || event.pointerType === \"touch\") return;\n        const native = event.nativeEvent;\n        menu.timers.open(menu.delay, () => {\n          menu.setOpenCause(\"none\");\n          menu.popover.requestOpen(native, \"activate\");\n        });\n      },\n      onPointerLeave: (event: PointerEvent<HTMLButtonElement>) => {\n        if (event.pointerType === \"touch\") return;\n        // Leaving before the open delay cancels it; leaving an open submenu's trigger starts the\n        // close delay (cancelled by entering the submenu).\n        if (menu.popover.intended()) scheduleHoverClose(menu, event.nativeEvent);\n        else menu.timers.cancel();\n      },\n    },\n    // A click opens (or moves focus into the open submenu); it never closes.\n    activate: (event) => open(event.nativeEvent),\n  });\n\n  return useRender<ComponentPropsWithRef<\"button\">, MenuSubmenuTriggerState>({\n    defaultElement: \"button\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: {\n      ...libraryProps,\n      role: item.libraryProps.role,\n      tabIndex: item.libraryProps.tabIndex,\n      \"data-typeahead\": item.libraryProps[\"data-typeahead\"],\n      id: menu.triggerId,\n      \"aria-haspopup\": \"menu\",\n    },\n    ref,\n  });\n}\n\nMenuSubmenuTrigger.displayName = \"MenuSubmenuTrigger\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsDA,SAAgB,mBAAmB,EACjC,WAAW,OACX,OACA,WACA,OACA,UACA,QACA,GAAG,QACuB;CAC1B,MAAM,OAAO,eAAe,qBAAqB;CACjD,cACE,CAAC,KAAK,SACN,4HAEF;CAEA,MAAM,QAAQ,UAAiB,kBAAkB,MAAM,OAAO,OAAO;CAIrE,MAAM,OAAO,YAAY;EACvB,MAAM;EACN,MAAM;EACN;EACA;EACA,UAAU;CACZ,CAAC;CAED,MAAM,aAAa,UAA4C;EAC7D,IAAI,MAAM,oBAAoB,YAAY,KAAK,KAAK,UAAU;EAC9D,MAAM,cAAc,MAAM,cAAc,QAAQ,iBAAe;EAC/D,MAAM,UAAU,gBAAgB,QAAQ,MAAM,WAAW,IAAI,cAAc;EAC3E,IAAI,MAAM,QAAQ,SAAS;EAC3B,MAAM,eAAe;EACrB,KAAK,MAAM,WAAW;CACxB;CAEA,MAAM,EAAE,OAAO,cAAc,QAAQ,kBAAkB,KAAK,SAAS;EACnE,MAAM;EACN;EACA;EACA,YAAY;EAEZ,UAAU;GACR,YAAY,UAAU;IACpB,KAAK,aAAa,UAAU,KAAK;IACjC,UAAU,KAAK;GACjB;GACA,eAAe,KAAK,aAAa;GACjC,iBAAiB,UAA2C;IAC1D,IAAI,YAAY,MAAM,gBAAgB,SAAS;IAC/C,MAAM,SAAS,MAAM;IACrB,KAAK,OAAO,KAAK,KAAK,aAAa;KACjC,KAAK,aAAa,MAAM;KACxB,KAAK,QAAQ,YAAY,QAAQ,UAAU;IAC7C,CAAC;GACH;GACA,iBAAiB,UAA2C;IAC1D,IAAI,MAAM,gBAAgB,SAAS;IAGnC,IAAI,KAAK,QAAQ,SAAS,GAAG,mBAAmB,MAAM,MAAM,WAAW;SAClE,KAAK,OAAO,OAAO;GAC1B;EACF;EAEA,WAAW,UAAU,KAAK,MAAM,WAAW;CAC7C,CAAC;CAED,OAAO,UAAoE;EACzE,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,OAAO;EACP,cAAc;GACZ,GAAG;GACH,MAAM,KAAK,aAAa;GACxB,UAAU,KAAK,aAAa;GAC5B,kBAAkB,KAAK,aAAa;GACpC,IAAI,KAAK;GACT,iBAAiB;EACnB;EACA;CACF,CAAC;AACH;AAEA,mBAAmB,cAAc"}