@funstack/ui 0.1.0-alpha.0 → 0.1.0-alpha.2

package/dist/menu/menu-group.mjs

@@ -0,0 +1,69 @@
+"use client";
+import { useRender } from "../internal/use-render.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { MenuGroupContext } from "./menu-context.mjs";
+import { use, useId } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/menu/menu-group.tsx
+const EMPTY = {};
+/**
+* A labelled set of items: `<div role="group" aria-labelledby>` named by the `Menu.GroupLabel`
+* inside it. Owned keys: `role`, `aria-labelledby` (token-merged).
+*/
+function MenuGroup({ className, style, children, render, ...rest }) {
+	const labelId = `${useId()}-label`;
+	const element = useRender({
+		defaultElement: "div",
+		render,
+		state: EMPTY,
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: {
+			role: "group",
+			"aria-labelledby": labelId
+		}
+	});
+	return /* @__PURE__ */ jsx(MenuGroupContext, {
+		value: { labelId },
+		children: element
+	});
+}
+MenuGroup.displayName = "MenuGroup";
+/**
+* The name of the enclosing `Menu.Group` or `Menu.RadioGroup`: a `<div>` with the id the group's
+* `aria-labelledby` references. Owned key: `id`.
+*/
+function MenuGroupLabel({ className, style, children, render, ...rest }) {
+	const group = use(MenuGroupContext);
+	useDevWarning(group === null, "Menu.GroupLabel: rendered outside a Menu.Group or Menu.RadioGroup; it names nothing.");
+	return useRender({
+		defaultElement: "div",
+		render,
+		state: EMPTY,
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: group === null ? {} : { id: group.labelId }
+	});
+}
+MenuGroupLabel.displayName = "MenuGroupLabel";
+/** A divider between items: `<hr>` (implicit `role="separator"`). Owns no keys. */
+function MenuSeparator({ className, style, render, ...rest }) {
+	return useRender({
+		defaultElement: "hr",
+		render,
+		state: EMPTY,
+		className,
+		style,
+		children: void 0,
+		props: rest
+	});
+}
+MenuSeparator.displayName = "MenuSeparator";
+//#endregion
+export { MenuGroup, MenuGroupLabel, MenuSeparator };
+
+//# sourceMappingURL=menu-group.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu-group.mjs","names":[],"sources":["../../src/menu/menu-group.tsx"],"sourcesContent":["\"use client\";\nimport { use, useId } from \"react\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { useDevWarning } from \"../internal/use-dev-warning.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { MenuGroupContext } from \"./menu-context.js\";\n\n/** `Menu.Group`, `Menu.GroupLabel` and `Menu.Separator` have no state. */\nexport type MenuGroupState = Record<string, never>;\nexport type MenuGroupLabelState = Record<string, never>;\nexport type MenuSeparatorState = Record<string, never>;\n\nconst EMPTY: Record<string, never> = {};\n\nexport interface MenuGroupProps extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"role\" | \"className\" | \"style\" | \"children\"\n> {\n  className?: StateValue<string | undefined, MenuGroupState>;\n  style?: StateValue<CSSProperties | undefined, MenuGroupState>;\n  children?: StateValue<ReactNode, MenuGroupState>;\n  render?: RenderProp<ComponentPropsWithRef<\"div\">, MenuGroupState>;\n}\n\n/**\n * A labelled set of items: `<div role=\"group\" aria-labelledby>` named by the `Menu.GroupLabel`\n * inside it. Owned keys: `role`, `aria-labelledby` (token-merged).\n */\nexport function MenuGroup({ className, style, children, render, ...rest }: MenuGroupProps) {\n  const labelId = `${useId()}-label`;\n  const element = useRender<ComponentPropsWithRef<\"div\">, MenuGroupState>({\n    defaultElement: \"div\",\n    render,\n    state: EMPTY,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: { role: \"group\", \"aria-labelledby\": labelId },\n  });\n  return <MenuGroupContext value={{ labelId }}>{element}</MenuGroupContext>;\n}\n\nMenuGroup.displayName = \"MenuGroup\";\n\nexport interface MenuGroupLabelProps extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"id\" | \"className\" | \"style\" | \"children\"\n> {\n  className?: StateValue<string | undefined, MenuGroupLabelState>;\n  style?: StateValue<CSSProperties | undefined, MenuGroupLabelState>;\n  children?: StateValue<ReactNode, MenuGroupLabelState>;\n  render?: RenderProp<ComponentPropsWithRef<\"div\">, MenuGroupLabelState>;\n}\n\n/**\n * The name of the enclosing `Menu.Group` or `Menu.RadioGroup`: a `<div>` with the id the group's\n * `aria-labelledby` references. Owned key: `id`.\n */\nexport function MenuGroupLabel({\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: MenuGroupLabelProps) {\n  const group = use(MenuGroupContext);\n  useDevWarning(\n    group === null,\n    \"Menu.GroupLabel: rendered outside a Menu.Group or Menu.RadioGroup; it names nothing.\",\n  );\n  return useRender<ComponentPropsWithRef<\"div\">, MenuGroupLabelState>({\n    defaultElement: \"div\",\n    render,\n    state: EMPTY,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: group === null ? {} : { id: group.labelId },\n  });\n}\n\nMenuGroupLabel.displayName = \"MenuGroupLabel\";\n\nexport interface MenuSeparatorProps extends Omit<\n  ComponentPropsWithRef<\"hr\">,\n  \"className\" | \"style\" | \"children\"\n> {\n  className?: StateValue<string | undefined, MenuSeparatorState>;\n  style?: StateValue<CSSProperties | undefined, MenuSeparatorState>;\n  /** Another element must carry `role=\"separator\"` itself. */\n  render?: RenderProp<ComponentPropsWithRef<\"hr\">, MenuSeparatorState>;\n}\n\n/** A divider between items: `<hr>` (implicit `role=\"separator\"`). Owns no keys. */\nexport function MenuSeparator({ className, style, render, ...rest }: MenuSeparatorProps) {\n  return useRender<ComponentPropsWithRef<\"hr\">, MenuSeparatorState>({\n    defaultElement: \"hr\",\n    render,\n    state: EMPTY,\n    className,\n    style,\n    children: undefined,\n    props: rest,\n  });\n}\n\nMenuSeparator.displayName = \"MenuSeparator\";\n"],"mappings":";;;;;;;AAaA,MAAM,QAA+B,CAAC;;;;;AAgBtC,SAAgB,UAAU,EAAE,WAAW,OAAO,UAAU,QAAQ,GAAG,QAAwB;CACzF,MAAM,UAAU,GAAG,MAAM,EAAE;CAC3B,MAAM,UAAU,UAAwD;EACtE,gBAAgB;EAChB;EACA,OAAO;EACP;EACA;EACA;EACA,OAAO;EACP,cAAc;GAAE,MAAM;GAAS,mBAAmB;EAAQ;CAC5D,CAAC;CACD,OAAO,oBAAC,kBAAD;EAAkB,OAAO,EAAE,QAAQ;EAAI,UAAA;CAA0B,CAAA;AAC1E;AAEA,UAAU,cAAc;;;;;AAgBxB,SAAgB,eAAe,EAC7B,WACA,OACA,UACA,QACA,GAAG,QACmB;CACtB,MAAM,QAAQ,IAAI,gBAAgB;CAClC,cACE,UAAU,MACV,sFACF;CACA,OAAO,UAA6D;EAClE,gBAAgB;EAChB;EACA,OAAO;EACP;EACA;EACA;EACA,OAAO;EACP,cAAc,UAAU,OAAO,CAAC,IAAI,EAAE,IAAI,MAAM,QAAQ;CAC1D,CAAC;AACH;AAEA,eAAe,cAAc;;AAa7B,SAAgB,cAAc,EAAE,WAAW,OAAO,QAAQ,GAAG,QAA4B;CACvF,OAAO,UAA2D;EAChE,gBAAgB;EAChB;EACA,OAAO;EACP;EACA;EACA,UAAU,KAAA;EACV,OAAO;CACT,CAAC;AACH;AAEA,cAAc,cAAc"}

package/dist/menu/menu-hover.mjs

@@ -0,0 +1,29 @@
+"use client";
+//#region src/menu/menu-hover.ts
+function hovered(element) {
+	if (element === null) return false;
+	try {
+		return element.matches(":hover");
+	} catch {
+		return false;
+	}
+}
+/**
+* Starts the submenu's `closeDelay` (design/components/menu.md 7): on expiry the submenu closes
+* with `"dismiss"` unless the pointer is back over its SubmenuTrigger or Popup, or keyboard focus
+* is inside it (a user who arrowed in and nudged the mouse keeps the submenu).
+*/
+function scheduleHoverClose(menu, event) {
+	const { popover, timers, closeDelay } = menu;
+	timers.close(closeDelay, () => {
+		const popup = popover.popupRef.current;
+		if (hovered(popover.triggerRef.current) || hovered(popup)) return;
+		const active = popup?.ownerDocument.activeElement ?? null;
+		if (popup !== null && active !== null && popup.contains(active)) return;
+		popover.requestClose(event, "dismiss");
+	});
+}
+//#endregion
+export { scheduleHoverClose };
+
+//# sourceMappingURL=menu-hover.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu-hover.mjs","names":[],"sources":["../../src/menu/menu-hover.ts"],"sourcesContent":["\"use client\";\nimport type { MenuContextValue } from \"./menu-context.js\";\n\nfunction hovered(element: Element | null): boolean {\n  if (element === null) return false;\n  try {\n    return element.matches(\":hover\");\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Starts the submenu's `closeDelay` (design/components/menu.md 7): on expiry the submenu closes\n * with `\"dismiss\"` unless the pointer is back over its SubmenuTrigger or Popup, or keyboard focus\n * is inside it (a user who arrowed in and nudged the mouse keeps the submenu).\n */\nexport function scheduleHoverClose(menu: MenuContextValue, event: Event): void {\n  const { popover, timers, closeDelay } = menu;\n  timers.close(closeDelay, () => {\n    const popup = popover.popupRef.current;\n    if (hovered(popover.triggerRef.current) || hovered(popup)) return;\n    const active = popup?.ownerDocument.activeElement ?? null;\n    if (popup !== null && active !== null && popup.contains(active)) return;\n    popover.requestClose(event, \"dismiss\");\n  });\n}\n"],"mappings":";;AAGA,SAAS,QAAQ,SAAkC;CACjD,IAAI,YAAY,MAAM,OAAO;CAC7B,IAAI;EACF,OAAO,QAAQ,QAAQ,QAAQ;CACjC,QAAQ;EACN,OAAO;CACT;AACF;;;;;;AAOA,SAAgB,mBAAmB,MAAwB,OAAoB;CAC7E,MAAM,EAAE,SAAS,QAAQ,eAAe;CACxC,OAAO,MAAM,kBAAkB;EAC7B,MAAM,QAAQ,QAAQ,SAAS;EAC/B,IAAI,QAAQ,QAAQ,WAAW,OAAO,KAAK,QAAQ,KAAK,GAAG;EAC3D,MAAM,SAAS,OAAO,cAAc,iBAAiB;EACrD,IAAI,UAAU,QAAQ,WAAW,QAAQ,MAAM,SAAS,MAAM,GAAG;EACjE,QAAQ,aAAa,OAAO,SAAS;CACvC,CAAC;AACH"}

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

@@ -0,0 +1,45 @@
+import { Action, ActionDetails, RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/menu/menu-item.d.ts
+/** Details passed to `Menu.Item`'s `action`. */
+export interface MenuItemDetails extends ActionDetails {}
+export interface MenuItemState {
+  /** This item's `action` is in flight. */
+  readonly pending: boolean;
+  readonly disabled: boolean;
+}
+export interface MenuItemProps extends Omit<ComponentPropsWithRef<"button">, "onClick" | "onKeyDown" | "onPointerMove" | "disabled" | "className" | "style" | "children"> {
+  /**
+   * Runs inside this item's own transition (`data-pending` on the item); the menu stays open
+   * until it settles, then the whole menu closes (`closeOnActivate`). May be a Server Function
+   * (`details.event` is virtual). A rejection leaves the menu open and reaches the nearest Error
+   * Boundary above the item. Without `action`, activation only closes.
+   */
+  action?: Action<[details: MenuItemDetails]>;
+  /** Close the whole menu once `action` settles. Default `true`. */
+  closeOnActivate?: boolean;
+  /** Renders `aria-disabled`: the item stays focusable and never activates. */
+  disabled?: boolean;
+  /** Text typeahead matches when the item's text content is not representative (an icon). */
+  label?: string;
+  className?: StateValue<string | undefined, MenuItemState>;
+  style?: StateValue<CSSProperties | undefined, MenuItemState>;
+  children?: StateValue<ReactNode, MenuItemState>;
+  render?: RenderProp<ComponentPropsWithRef<"button">, MenuItemState>;
+}
+/**
+ * A menu command: `<button type="button" role="menuitem" tabindex="-1">`. Click, Enter or Space
+ * runs `action` in the item's own transition; once it resolves the whole menu stack closes
+ * through the top-level Root (`openChangeAction(false, { reason: "activate" })` awaited, view
+ * transition if set). Hovering the item focuses it.
+ *
+ * Owned keys (conventions 1.2): `type` (on a `<button>`), `role`, `tabIndex`, `disabled`
+ * (always absent), `aria-disabled`, `onClick`, `onKeyDown`, `onPointerMove`, `data-pending`,
+ * `data-disabled`, `data-typeahead`.
+ */
+export declare function MenuItem({ action, closeOnActivate, disabled, label, className, style, children, render, ...rest }: MenuItemProps): ReactNode;
+export declare namespace MenuItem {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=menu-item.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item.d.mts","names":[],"sources":["../../src/menu/menu-item.tsx"],"mappings":";;;;iBAWiB,wBAAwB;iBAExB;;WAEN;WACA;;iBAGM,sBAAsB,KACrC;;;;;;;EASA,SAAS,QAAQ,SAAS;;EAE1B;;EAEA;;EAEA;EACA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,iCAAiC;;;;;;;;;;;;wBAavC,WACd,QACA,iBACA,UACA,OACA,WACA,OACA,UACA,WACG,QACF,gBAAa;yBAVA"}

package/dist/menu/menu-item.mjs

@@ -0,0 +1,54 @@
+"use client";
+import { createActionDetails } from "../internal/action-details.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { rendersButton, useRender } from "../internal/use-render.mjs";
+import { useActionTrigger } from "../internal/use-action-trigger.mjs";
+import { useMenuContext } from "./menu-context.mjs";
+import { useMenuItem } from "./use-menu-item.mjs";
+//#region src/menu/menu-item.tsx
+/**
+* A menu command: `<button type="button" role="menuitem" tabindex="-1">`. Click, Enter or Space
+* runs `action` in the item's own transition; once it resolves the whole menu stack closes
+* through the top-level Root (`openChangeAction(false, { reason: "activate" })` awaited, view
+* transition if set). Hovering the item focuses it.
+*
+* Owned keys (conventions 1.2): `type` (on a `<button>`), `role`, `tabIndex`, `disabled`
+* (always absent), `aria-disabled`, `onClick`, `onKeyDown`, `onPointerMove`, `data-pending`,
+* `data-disabled`, `data-typeahead`.
+*/
+function MenuItem({ action, closeOnActivate = true, disabled = false, label, className, style, children, render, ...rest }) {
+	const menu = useMenuContext("Menu.Item");
+	const { pending, run } = useActionTrigger(menu.root.popover.openGeneration);
+	const { libraryProps } = useMenuItem({
+		part: "Menu.Item",
+		role: "menuitem",
+		disabled,
+		label,
+		activate: (event) => {
+			const details = createActionDetails(event, {});
+			run(() => action?.(details), closeOnActivate ? () => menu.root.popover.requestClose(event, "activate") : void 0);
+		}
+	});
+	return useRender({
+		defaultElement: "button",
+		render,
+		state: {
+			pending,
+			disabled
+		},
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: {
+			...rendersButton(render) && { type: "button" },
+			...libraryProps,
+			"data-pending": dataAttr(pending)
+		}
+	});
+}
+MenuItem.displayName = "MenuItem";
+//#endregion
+export { MenuItem };
+
+//# sourceMappingURL=menu-item.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item.mjs","names":[],"sources":["../../src/menu/menu-item.tsx"],"sourcesContent":["\"use client\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport { createActionDetails } from \"../internal/action-details.js\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { Action, ActionDetails, RenderProp, StateValue } from \"../internal/types.js\";\nimport { useActionTrigger } from \"../internal/use-action-trigger.js\";\nimport { rendersButton, useRender } from \"../internal/use-render.js\";\nimport { useMenuContext } from \"./menu-context.js\";\nimport { useMenuItem } from \"./use-menu-item.js\";\n\n/** Details passed to `Menu.Item`'s `action`. */\nexport interface MenuItemDetails extends ActionDetails {}\n\nexport interface MenuItemState {\n  /** This item's `action` is in flight. */\n  readonly pending: boolean;\n  readonly disabled: boolean;\n}\n\nexport interface MenuItemProps extends Omit<\n  ComponentPropsWithRef<\"button\">,\n  \"onClick\" | \"onKeyDown\" | \"onPointerMove\" | \"disabled\" | \"className\" | \"style\" | \"children\"\n> {\n  /**\n   * Runs inside this item's own transition (`data-pending` on the item); the menu stays open\n   * until it settles, then the whole menu closes (`closeOnActivate`). May be a Server Function\n   * (`details.event` is virtual). A rejection leaves the menu open and reaches the nearest Error\n   * Boundary above the item. Without `action`, activation only closes.\n   */\n  action?: Action<[details: MenuItemDetails]>;\n  /** Close the whole menu once `action` settles. Default `true`. */\n  closeOnActivate?: boolean;\n  /** Renders `aria-disabled`: the item stays focusable and never activates. */\n  disabled?: boolean;\n  /** Text typeahead matches when the item's text content is not representative (an icon). */\n  label?: string;\n  className?: StateValue<string | undefined, MenuItemState>;\n  style?: StateValue<CSSProperties | undefined, MenuItemState>;\n  children?: StateValue<ReactNode, MenuItemState>;\n  render?: RenderProp<ComponentPropsWithRef<\"button\">, MenuItemState>;\n}\n\n/**\n * A menu command: `<button type=\"button\" role=\"menuitem\" tabindex=\"-1\">`. Click, Enter or Space\n * runs `action` in the item's own transition; once it resolves the whole menu stack closes\n * through the top-level Root (`openChangeAction(false, { reason: \"activate\" })` awaited, view\n * transition if set). Hovering the item focuses it.\n *\n * Owned keys (conventions 1.2): `type` (on a `<button>`), `role`, `tabIndex`, `disabled`\n * (always absent), `aria-disabled`, `onClick`, `onKeyDown`, `onPointerMove`, `data-pending`,\n * `data-disabled`, `data-typeahead`.\n */\nexport function MenuItem({\n  action,\n  closeOnActivate = true,\n  disabled = false,\n  label,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: MenuItemProps) {\n  const menu = useMenuContext(\"Menu.Item\");\n  // The close belongs to the top-level menu, so its open generation guards it.\n  const { pending, run } = useActionTrigger(menu.root.popover.openGeneration);\n\n  const { libraryProps } = useMenuItem({\n    part: \"Menu.Item\",\n    role: \"menuitem\",\n    disabled,\n    label,\n    activate: (event) => {\n      const details: MenuItemDetails = createActionDetails(event, {});\n      // Repeated activations re-run the action; the first close wins (design 2.3).\n      run(\n        () => action?.(details),\n        closeOnActivate ? () => menu.root.popover.requestClose(event, \"activate\") : undefined,\n      );\n    },\n  });\n\n  const state: MenuItemState = { pending, disabled };\n\n  return useRender<ComponentPropsWithRef<\"button\">, MenuItemState>({\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      \"data-pending\": dataAttr(pending),\n    },\n  });\n}\n\nMenuItem.displayName = \"MenuItem\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoDA,SAAgB,SAAS,EACvB,QACA,kBAAkB,MAClB,WAAW,OACX,OACA,WACA,OACA,UACA,QACA,GAAG,QACa;CAChB,MAAM,OAAO,eAAe,WAAW;CAEvC,MAAM,EAAE,SAAS,QAAQ,iBAAiB,KAAK,KAAK,QAAQ,cAAc;CAE1E,MAAM,EAAE,iBAAiB,YAAY;EACnC,MAAM;EACN,MAAM;EACN;EACA;EACA,WAAW,UAAU;GACnB,MAAM,UAA2B,oBAAoB,OAAO,CAAC,CAAC;GAE9D,UACQ,SAAS,OAAO,GACtB,wBAAwB,KAAK,KAAK,QAAQ,aAAa,OAAO,UAAU,IAAI,KAAA,CAC9E;EACF;CACF,CAAC;CAID,OAAO,UAA0D;EAC/D,gBAAgB;EAChB;EACA,OAAA;GAL6B;GAAS;EAKlC;EACJ;EACA;EACA;EACA,OAAO;EACP,cAAc;GACZ,GAAI,cAAc,MAAM,KAAK,EAAE,MAAM,SAAkB;GACvD,GAAG;GACH,gBAAgB,SAAS,OAAO;EAClC;CACF,CAAC;AACH;AAEA,SAAS,cAAc"}

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

@@ -0,0 +1,69 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { AnchorAlign, AnchorSide } from "../internal/anchor-position.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode, ViewTransitionClass } from "react";
+//#region src/menu/menu-popup.d.ts
+export type MenuSide = AnchorSide;
+export type MenuAlign = AnchorAlign;
+export interface MenuPopupState {
+  /** Committed open state. Read `:popover-open` for the DOM truth. */
+  readonly open: boolean;
+  readonly side: MenuSide | null;
+  readonly align: MenuAlign;
+  /** This popup belongs to a submenu. */
+  readonly submenu: boolean;
+}
+export interface MenuPopupProps extends Omit<ComponentPropsWithRef<"div">, "id" | "popover" | "role" | "aria-labelledby" | "onKeyDown" | "onFocus" | "onBlur" | "onMouseDown" | "onPointerEnter" | "onPointerLeave" | "onToggle" | "onBeforeToggle" | "className" | "style" | "children"> {
+  /**
+   * Placement against the Trigger through inline `position-area`, with `position-try-fallbacks`
+   * flipping it when it does not fit. Default `"bottom"` for a top-level menu, `"right"` for a
+   * submenu (whose fallback is `flip-inline` only). `null` emits no inline positioning (and no
+   * `data-side` / `data-align`): the stylesheet owns placement.
+   */
+  side?: MenuSide | null;
+  /** Alignment along the side. Default `"start"`. Ignored when `side` is `null`. */
+  align?: MenuAlign;
+  /**
+   * `false` (default): the items are not rendered while the menu is closed; mounting them is part
+   * of the opening transition, so items that suspend hold the open (and the Trigger pending)
+   * until they are ready. `true`: they stay mounted inside `<Activity mode="hidden">`.
+   */
+  keepMounted?: boolean;
+  /**
+   * Experimental (Chromium 150+). Renders `focusgroup="menu wrap|nowrap"` and, where the engine
+   * implements `focusGroup`, lets the browser handle ArrowUp / ArrowDown / Home / End: items then
+   * render no `tabindex` and the library's arrow-key handling steps aside. Typeahead, activation,
+   * submenu keys and Tab stay in JS. No effect in other engines. Default `false`.
+   */
+  experimental_focusgroup?: boolean;
+  /**
+   * Forwarded to the `<ViewTransition default>` around the popup element. Animates the opening
+   * commit and every library-driven close (an item's activation, the Trigger, ArrowLeft, hover
+   * leaving a submenu, controlled `open={false}`) in all engines; dismissals (Escape, a click
+   * outside, Tab) animate with CSS only. Without it the part renders no `<ViewTransition>`.
+   */
+  transition?: ViewTransitionClass;
+  className?: StateValue<string | undefined, MenuPopupState>;
+  style?: StateValue<CSSProperties | undefined, MenuPopupState>;
+  children?: StateValue<ReactNode, MenuPopupState>;
+  /** Should render a `<div>`; a `<dialog>` would run the dialog focusing steps. */
+  render?: RenderProp<ComponentPropsWithRef<"div">, MenuPopupState>;
+}
+/**
+ * The menu itself: `<div popover="auto" role="menu" aria-labelledby={trigger} tabindex="-1">`,
+ * placed against its Trigger with CSS Anchor Positioning. Owns the keyboard model (design 5):
+ * ArrowUp / ArrowDown / Home / End move focus between items (or the browser does, with
+ * `experimental_focusgroup` where supported), printable characters run typeahead, ArrowLeft
+ * closes a submenu. The top-level popup closes the whole menu at once when focus leaves it (Tab).
+ * Style it with `:popover-open`; it emits `data-side` / `data-align` but no `data-open`.
+ *
+ * Owned keys (conventions 1.2): `id`, `popover`, `role`, `aria-labelledby` (token-merged),
+ * `tabIndex`, `focusgroup` (with the flag), `onKeyDown`, `onBlur`, `onMouseDown` (a press on
+ * non-item space keeps focus on the current item), `onPointerEnter` / `onPointerLeave`, and
+ * `data-side` / `data-align` unless `side` is `null`.
+ */
+export declare function MenuPopup({ side: sideProp, align, keepMounted, experimental_focusgroup, transition, className, style, children, render, ...rest }: MenuPopupProps): ReactNode;
+export declare namespace MenuPopup {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=menu-popup.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu-popup.d.mts","names":[],"sources":["../../src/menu/menu-popup.tsx"],"mappings":";;;;YAiCY,WAAW;YACX,YAAY;iBAEP;;WAEN;WACA,MAAM;WACN,OAAO;;WAEP;;iBAGM,uBAAuB,KACtC;;;;;;;EAuBA,OAAO;;EAEP,QAAQ;;;;;;EAMR;;;;;;;EAOA;;;;;;;EAOA,aAAa;EACb,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;;EAEjC,SAAS,WAAW,8BAA8B;;;;;;;;;;;;;;;wBA4BpC,YACd,MAAM,UACN,OACA,aACA,yBACA,YACA,WACA,OACA,UACA,WACG,QACF,iBAAc;yBAXD"}

package/dist/menu/menu-popup.mjs

@@ -0,0 +1,207 @@
+"use client";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { mergeRefs } from "../internal/merge-props.mjs";
+import { resolveStateValue, useRender } from "../internal/use-render.mjs";
+import { POSITION_TRY_FALLBACKS, positionArea } from "../internal/anchor-position.mjs";
+import { usePopoverPopup } from "../internal/use-popover-popup.mjs";
+import { MenuListContext, useMenuContext } from "./menu-context.mjs";
+import { edgeItem, focusItem, hasModifier, isMenuItem, isRtl, menuItems, typeaheadText } from "./menu-dom.mjs";
+import { scheduleHoverClose } from "./menu-hover.mjs";
+import { Activity, useCallback, useMemo, useRef, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/menu/menu-popup.tsx
+/** Engine capabilities never change while the page lives. */
+const subscribeNever = () => () => {};
+/** Typeahead buffer lifetime after the last keystroke (design 5.1). */
+const TYPEAHEAD_RESET_MS = 500;
+const isDev = process.env.NODE_ENV !== "production";
+/** What a press may focus inside a popup: items, the popup itself, the consumer's controls. */
+const FOCUSABLE_SELECTOR = "a[href], button, input, select, textarea, summary, [tabindex], [contenteditable]:not([contenteditable=\"false\"])";
+/**
+* The menu itself: `<div popover="auto" role="menu" aria-labelledby={trigger} tabindex="-1">`,
+* placed against its Trigger with CSS Anchor Positioning. Owns the keyboard model (design 5):
+* ArrowUp / ArrowDown / Home / End move focus between items (or the browser does, with
+* `experimental_focusgroup` where supported), printable characters run typeahead, ArrowLeft
+* closes a submenu. The top-level popup closes the whole menu at once when focus leaves it (Tab).
+* Style it with `:popover-open`; it emits `data-side` / `data-align` but no `data-open`.
+*
+* Owned keys (conventions 1.2): `id`, `popover`, `role`, `aria-labelledby` (token-merged),
+* `tabIndex`, `focusgroup` (with the flag), `onKeyDown`, `onBlur`, `onMouseDown` (a press on
+* non-item space keeps focus on the current item), `onPointerEnter` / `onPointerLeave`, and
+* `data-side` / `data-align` unless `side` is `null`.
+*/
+function MenuPopup({ side: sideProp, align = "start", keepMounted, experimental_focusgroup = false, transition, className, style, children, render, ...rest }) {
+	const menu = useMenuContext("Menu.Popup");
+	const { popover, submenu, loop } = menu;
+	const side = sideProp === void 0 ? submenu ? "right" : "bottom" : sideProp;
+	const nativeFocusgroup = useSyncExternalStore(subscribeNever, () => experimental_focusgroup && "focusGroup" in HTMLElement.prototype, () => false);
+	const typeahead = useRef({
+		text: "",
+		at: 0
+	});
+	const typingAhead = useCallback(() => {
+		const { text, at } = typeahead.current;
+		return text !== "" && Date.now() - at <= TYPEAHEAD_RESET_MS;
+	}, []);
+	const { setElement, visible, wrapContent } = usePopoverPopup(popover, {
+		part: "Menu.Popup",
+		initialFocus: void 0,
+		resolveInitialFocus: (popup) => {
+			const { cause, pointer } = menu.takeOpenCause();
+			if (cause === "none") return null;
+			const element = edgeItem(popup, cause) ?? popup;
+			return pointer ? {
+				element,
+				focusVisible: false
+			} : element;
+		},
+		keepMounted,
+		transition
+	});
+	const devRef = useCallback((element) => {
+		if (isDev && element.tagName === "DIALOG") console.error("Menu.Popup: rendered a <dialog>. Render a <div>: a <dialog popover> runs the dialog focusing steps, which fight the menu's item focus.");
+		return () => {};
+	}, []);
+	const ref = useMemo(() => mergeRefs(setElement, devRef), [setElement, devRef]);
+	const listContext = useMemo(() => ({
+		menu,
+		nativeFocusgroup,
+		typingAhead
+	}), [
+		menu,
+		nativeFocusgroup,
+		typingAhead
+	]);
+	const state = {
+		open: popover.committed,
+		side,
+		align,
+		submenu
+	};
+	const runTypeahead = (popup, current, key) => {
+		const now = Date.now();
+		const buffer = typeahead.current;
+		if (buffer.text === "" || now - buffer.at > TYPEAHEAD_RESET_MS) buffer.text = "";
+		if (key === " " && buffer.text === "") return false;
+		buffer.text += key.toLowerCase();
+		buffer.at = now;
+		const items = menuItems(popup);
+		if (items.length === 0) return true;
+		const repeated = [...buffer.text].every((c) => c === buffer.text[0]);
+		const search = repeated ? buffer.text[0] : buffer.text;
+		const index = current === null ? -1 : items.indexOf(current);
+		const start = repeated || index < 0 ? index + 1 : index;
+		for (let i = 0; i < items.length; i++) {
+			const item = items[(start + i) % items.length];
+			if (typeaheadText(item).startsWith(search)) {
+				if (item !== current) focusItem(item);
+				break;
+			}
+		}
+		return true;
+	};
+	const onKeyDown = (event) => {
+		if (event.defaultPrevented || hasModifier(event)) return;
+		const popup = event.currentTarget;
+		const target = event.target;
+		const onItem = isMenuItem(target, popup);
+		if (!onItem && target !== popup) return;
+		const key = event.key;
+		if (submenu && key === (isRtl(popup) ? "ArrowRight" : "ArrowLeft")) {
+			event.preventDefault();
+			popover.requestClose(event.nativeEvent, "activate");
+			return;
+		}
+		if (key === "ArrowDown" || key === "ArrowUp" || key === "Home" || key === "End") {
+			if (!onItem) {
+				event.preventDefault();
+				const items = menuItems(popup);
+				const item = key === "ArrowDown" || key === "Home" ? items[0] : items.at(-1);
+				if (item !== void 0) focusItem(item);
+				return;
+			}
+			if (nativeFocusgroup) return;
+			event.preventDefault();
+			const items = menuItems(popup);
+			const index = items.indexOf(target);
+			const last = items.length - 1;
+			let next;
+			if (key === "Home") next = 0;
+			else if (key === "End") next = last;
+			else if (key === "ArrowDown") next = index >= last ? loop ? 0 : last : index + 1;
+			else next = index <= 0 ? loop ? last : 0 : index - 1;
+			const item = items[next];
+			if (item !== void 0 && item !== target) focusItem(item);
+			return;
+		}
+		if (key.length === 1 && runTypeahead(popup, onItem ? target : null, key)) event.preventDefault();
+	};
+	const onBlur = (event) => {
+		if (submenu) return;
+		const popup = event.currentTarget;
+		const next = event.relatedTarget;
+		if (!(next instanceof Node) || popup.contains(next)) return;
+		if (popup.matches(":popover-open")) popup.hidePopover();
+	};
+	const onMouseDown = (event) => {
+		if (event.button !== 0) return;
+		const focusable = event.target.closest(FOCUSABLE_SELECTOR);
+		if (focusable === null || focusable.getAttribute("role") === "menu") event.preventDefault();
+	};
+	const libraryProps = {
+		id: popover.ids.popup,
+		popover: "auto",
+		role: "menu",
+		"aria-labelledby": menu.triggerId,
+		tabIndex: -1,
+		...experimental_focusgroup && { focusgroup: `menu ${loop ? "wrap" : "nowrap"}` },
+		onKeyDown,
+		onBlur,
+		onMouseDown,
+		...submenu && {
+			onPointerEnter: (event) => {
+				if (event.pointerType !== "touch") menu.timers.cancelClose();
+			},
+			onPointerLeave: (event) => {
+				if (event.pointerType !== "touch") scheduleHoverClose(menu, event.nativeEvent);
+			}
+		},
+		...side !== null && {
+			"data-side": side,
+			"data-align": align
+		}
+	};
+	const content = (s) => {
+		let node;
+		if (keepMounted === true) node = /* @__PURE__ */ jsx(Activity, {
+			mode: visible ? "visible" : "hidden",
+			children: wrapContent(resolveStateValue(children, s))
+		});
+		else node = visible ? wrapContent(resolveStateValue(children, s)) : null;
+		return /* @__PURE__ */ jsx(MenuListContext, {
+			value: listContext,
+			children: node
+		});
+	};
+	const element = useRender({
+		defaultElement: "div",
+		render,
+		state,
+		className,
+		style: side === null ? style : (s) => ({
+			positionArea: positionArea(side, align),
+			positionTryFallbacks: submenu ? "flip-inline" : POSITION_TRY_FALLBACKS,
+			...resolveStateValue(style, s)
+		}),
+		children: content,
+		props: rest,
+		libraryProps,
+		ref
+	});
+	return useTransitionBoundary("Menu.Popup", transition, element);
+}
+MenuPopup.displayName = "MenuPopup";
+//#endregion
+export { MenuPopup };
+
+//# sourceMappingURL=menu-popup.mjs.map

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"}