@videojs/react 10.0.0-beta.23 → 10.0.0-beta.25

package/dist/dev/ui/menu/menu-content.d.ts

@@ -0,0 +1,15 @@
+import { UIComponentProps } from "../../utils/types.js";
+import * as _$react from "react";
+import { MenuState } from "@videojs/core";
+
+//#region src/ui/menu/menu-content.d.ts
+interface MenuContentProps extends UIComponentProps<'div', MenuState> {}
+/** Container for menu items. Positioned relative to the trigger at root level; renders in-place as a submenu panel when nested. */
+declare const MenuContent: _$react.ForwardRefExoticComponent<Omit<MenuContentProps, "ref"> & _$react.RefAttributes<HTMLDivElement>>;
+declare namespace MenuContent {
+  type Props = MenuContentProps;
+  type State = MenuState;
+}
+//#endregion
+export { MenuContent, MenuContentProps };
+//# sourceMappingURL=menu-content.d.ts.map

package/dist/dev/ui/menu/menu-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-content.d.ts","names":[],"sources":["../../../../src/ui/menu/menu-content.tsx"],"mappings":";;;;;UAiCiB,gBAAA,SAAyB,gBAAA,QAAwB,SAAA;;cA0ErD,WAAA,EAAW,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,gBAAA,WAAA,OAAA,CAAA,aAAA,CAAA,cAAA;AAAA,kBAuTP,WAAA;EAAA,KACH,KAAA,GAAQ,gBAAA;EAAA,KACR,KAAA,GAAQ,SAAA;AAAA"}

package/dist/dev/ui/menu/menu-content.js

@@ -0,0 +1,302 @@
+"use client";
+import { useComposedRefs } from "../../utils/use-composed-refs.js";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext, useSubMenuContext } from "./context.js";
+import { createMenuViewTransition, getAnchorPositionStyle, getMenuViewTransitionAttrs, getMenuViewportAttrs, getMenuViewportElement, getPopupPositionRect, getPositioningBoundaryRect, getRootPositionOptions, isEventWithinElement, isMenuNavigationKey, observeMenuViewContent, resolveOffsets, resolvePositioningBoundary, syncMenuViewRoot, syncMenuViewTransition } from "@videojs/core/dom";
+import { useSnapshot } from "@videojs/store/react";
+import { forwardRef, useCallback, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { PopoverCSSVars } from "@videojs/core";
+import { supportsAnchorPositioning } from "@videojs/utils/dom";
+import { createPortal } from "react-dom";
+//#region src/ui/menu/menu-content.tsx
+const POPOVER_RESET = {
+	position: "fixed",
+	inset: "auto",
+	margin: 0
+};
+const menuPreventedNativeEvents = /* @__PURE__ */ new WeakSet();
+function toUIKeyboardEvent(event) {
+	return {
+		get defaultPrevented() {
+			return event.defaultPrevented;
+		},
+		key: event.key,
+		shiftKey: event.shiftKey,
+		ctrlKey: event.ctrlKey,
+		altKey: event.altKey,
+		metaKey: event.metaKey,
+		target: event.target instanceof Node ? event.target : event.currentTarget,
+		currentTarget: event.currentTarget,
+		preventDefault: () => event.preventDefault(),
+		stopPropagation: () => event.stopPropagation()
+	};
+}
+function toUIFocusEvent(event) {
+	return {
+		get defaultPrevented() {
+			return event.defaultPrevented;
+		},
+		relatedTarget: event.relatedTarget,
+		preventDefault: () => event.preventDefault(),
+		stopPropagation: () => event.stopPropagation()
+	};
+}
+function preventMenuKeyDefault(event) {
+	const keyboardEvent = toUIKeyboardEvent(event);
+	if (event.key !== "Escape" && isMenuNavigationKey(keyboardEvent) && !event.defaultPrevented) {
+		event.preventDefault();
+		menuPreventedNativeEvents.add(event.nativeEvent);
+	}
+}
+function wasDefaultPreventedByMenu(event) {
+	return menuPreventedNativeEvents.has(event.nativeEvent);
+}
+function callKeyDownHandler(handler, event) {
+	const defaultPreventedBeforeHandler = event.defaultPrevented && !wasDefaultPreventedByMenu(event);
+	if (!handler) return defaultPreventedBeforeHandler;
+	let defaultPreventedByHandler = false;
+	const preventDefault = event.preventDefault;
+	event.preventDefault = () => {
+		defaultPreventedByHandler = true;
+		preventDefault.call(event);
+	};
+	try {
+		handler(event);
+	} finally {
+		event.preventDefault = preventDefault;
+	}
+	return defaultPreventedBeforeHandler || defaultPreventedByHandler;
+}
+/** Container for menu items. Positioned relative to the trigger at root level; renders in-place as a submenu panel when nested. */
+const MenuContent = forwardRef(function MenuContent({ render, className, style, onKeyDown, onBlur, ...elementProps }, forwardedRef) {
+	const { core, menu, state, stateAttrMap, anchorName, contentId, boundary, container, activeSubMenuId } = useMenuContext();
+	const subMenuCtx = useSubMenuContext();
+	const isSubmenu = state.isSubmenu;
+	const parentMenu = subMenuCtx?.parentMenu ?? null;
+	const subMenuId = subMenuCtx?.subMenuId ?? null;
+	const isActive = isSubmenu && parentMenu !== null && subMenuId !== null ? parentMenu.activeSubMenuId === subMenuId : false;
+	const [menuViewTransition] = useState(() => createMenuViewTransition({
+		focusFirstItem() {
+			menu.highlightFirstItem({ preventScroll: true });
+		},
+		restoreFocus(triggerId) {
+			if (triggerId) document.getElementById(triggerId)?.focus({ preventScroll: true });
+		}
+	}));
+	const menuViewTransitionState = useSnapshot(menuViewTransition.input);
+	const menuViewElementRef = useRef(null);
+	const parentContentElementRef = useRef(null);
+	const activeSubMenuIdRef = useRef(activeSubMenuId);
+	activeSubMenuIdRef.current = activeSubMenuId;
+	useLayoutEffect(() => {
+		return () => menuViewTransition.destroy();
+	}, [menuViewTransition]);
+	useLayoutEffect(() => {
+		if (!isSubmenu) return;
+		menuViewTransition.sync({
+			active: isActive,
+			direction: parentMenu?.navigationDirection ?? "forward",
+			triggerId: parentMenu?.activeSubMenuTriggerId ?? null
+		});
+	}, [
+		isActive,
+		isSubmenu,
+		parentMenu,
+		menuViewTransition
+	]);
+	const setMenuViewElement = useCallback((element) => {
+		menuViewElementRef.current = element;
+		menu.setContentElement(element);
+		menuViewTransition.setElement(element);
+	}, [menu, menuViewTransition]);
+	const handleSubMenuKeyDown = useCallback((event) => {
+		const defaultPreventedByUser = callKeyDownHandler(onKeyDown, event);
+		const keyboardEvent = toUIKeyboardEvent(event);
+		const isNavigationKey = isMenuNavigationKey(keyboardEvent);
+		menu.contentProps.onKeyDown(keyboardEvent);
+		const isBackNavigationKey = event.key === "ArrowLeft" || event.key === "Escape";
+		const ownsActiveSubmenu = parentMenu !== null && subMenuId !== null && parentMenu.menu.navigationInput.current.stack[parentMenu.menu.navigationInput.current.stack.length - 1]?.menuId === subMenuId;
+		if (isBackNavigationKey && ownsActiveSubmenu && !defaultPreventedByUser) {
+			event.preventDefault();
+			parentMenu.pop();
+		}
+		if (isNavigationKey && (!isBackNavigationKey || ownsActiveSubmenu)) event.stopPropagation();
+	}, [
+		onKeyDown,
+		parentMenu,
+		subMenuId,
+		menu
+	]);
+	const handleRootMenuKeyDown = useCallback((event) => {
+		onKeyDown?.(event);
+		const keyboardEvent = toUIKeyboardEvent(event);
+		menu.contentProps.onKeyDown(keyboardEvent);
+		if (event.key === "Escape") return;
+		if (isMenuNavigationKey(keyboardEvent)) event.stopPropagation();
+	}, [onKeyDown, menu]);
+	const handleRootMenuBlur = useCallback((event) => {
+		onBlur?.(event);
+		menu.contentProps.onFocusOut(toUIFocusEvent(event));
+	}, [onBlur, menu]);
+	const internalRef = useRef(null);
+	const rootComposedRef = useComposedRefs(forwardedRef, useCallback((element) => {
+		if (isSubmenu) return;
+		menu.setContentElement(element);
+		if (element && supportsAnchorPositioning()) element.style.setProperty("position-anchor", `--${anchorName}`);
+	}, [
+		isSubmenu,
+		menu,
+		anchorName
+	]), internalRef);
+	const menuViewComposedRef = useComposedRefs(forwardedRef, setMenuViewElement);
+	const positionOptions = useMemo(() => getRootPositionOptions(state.side, state.align), [state.side, state.align]);
+	const anchorStyle = useMemo(() => {
+		if (isSubmenu || !positionOptions || !supportsAnchorPositioning()) return null;
+		const { positionAnchor: _, ...rest } = getAnchorPositionStyle(anchorName, positionOptions);
+		return rest;
+	}, [
+		isSubmenu,
+		anchorName,
+		positionOptions
+	]);
+	const [manualStyle, setManualStyle] = useState(null);
+	useLayoutEffect(() => {
+		if (isSubmenu) return;
+		if (!state.open) return;
+		syncMenuViewRoot(internalRef.current, activeSubMenuId !== null);
+		const contentElement = internalRef.current;
+		if (!contentElement) return;
+		return observeMenuViewContent(contentElement, () => {
+			syncMenuViewRoot(contentElement, activeSubMenuId !== null);
+		});
+	}, [
+		isSubmenu,
+		state.open,
+		activeSubMenuId
+	]);
+	useLayoutEffect(() => {
+		if (!isSubmenu) return;
+		const parentContentElement = parentMenu?.menu.contentElement ?? parentContentElementRef.current;
+		parentContentElementRef.current = parentContentElement;
+		syncMenuViewTransition(parentContentElement, menuViewElementRef.current, menuViewTransitionState);
+	});
+	useLayoutEffect(() => {
+		if (isSubmenu) return;
+		if (!state.open) {
+			setManualStyle(null);
+			return;
+		}
+		if (!positionOptions) {
+			syncMenuViewRoot(internalRef.current, activeSubMenuIdRef.current !== null);
+			return;
+		}
+		const rootPositionOptions = positionOptions;
+		function measure() {
+			const triggerElement = menu.triggerElement;
+			const contentElement = internalRef.current;
+			if (!triggerElement || !contentElement) return;
+			const triggerRect = triggerElement.getBoundingClientRect();
+			const boundaryElement = resolvePositioningBoundary(boundary, {
+				container,
+				root: contentElement.getRootNode()
+			});
+			const anchorSupported = supportsAnchorPositioning();
+			const contentRect = anchorSupported ? void 0 : getPopupPositionRect(contentElement);
+			const boundaryRect = getPositioningBoundaryRect(boundaryElement);
+			const offsets = resolveOffsets(contentElement);
+			let nextStyle = getAnchorPositionStyle(anchorName, rootPositionOptions, triggerRect, contentRect, boundaryRect, offsets);
+			const availableWidth = nextStyle[PopoverCSSVars.availableWidth];
+			syncMenuViewRoot(contentElement, activeSubMenuIdRef.current !== null, availableWidth ? { availableWidth } : void 0);
+			if (!anchorSupported) nextStyle = getAnchorPositionStyle(anchorName, rootPositionOptions, triggerRect, getPopupPositionRect(contentElement), boundaryRect, offsets);
+			const { positionAnchor: _, ...rootStyle } = nextStyle;
+			setManualStyle(rootStyle);
+		}
+		measure();
+		const triggerElement = menu.triggerElement;
+		const contentElement = internalRef.current;
+		const boundaryElement = contentElement ? resolvePositioningBoundary(boundary, {
+			container,
+			root: contentElement.getRootNode()
+		}) : null;
+		let animationFrameId = 0;
+		function reposition(event) {
+			if (event && isEventWithinElement(event, internalRef.current)) return;
+			cancelAnimationFrame(animationFrameId);
+			animationFrameId = requestAnimationFrame(measure);
+		}
+		reposition();
+		const resizeObserver = typeof ResizeObserver === "function" ? new ResizeObserver(() => reposition()) : null;
+		if (triggerElement && resizeObserver) resizeObserver.observe(triggerElement);
+		if (contentElement && resizeObserver) resizeObserver.observe(contentElement);
+		if (boundaryElement && resizeObserver) resizeObserver.observe(boundaryElement);
+		window.addEventListener("scroll", reposition, {
+			capture: true,
+			passive: true
+		});
+		window.addEventListener("resize", reposition);
+		return () => {
+			cancelAnimationFrame(animationFrameId);
+			resizeObserver?.disconnect();
+			window.removeEventListener("scroll", reposition, true);
+			window.removeEventListener("resize", reposition);
+		};
+	}, [
+		isSubmenu,
+		state.open,
+		anchorName,
+		positionOptions,
+		menu,
+		boundary,
+		container
+	]);
+	if (isSubmenu) {
+		if (menuViewTransitionState.phase === "hidden") return null;
+		const subMenuContent = renderElement("div", {
+			render,
+			className,
+			style
+		}, {
+			state,
+			ref: menuViewComposedRef,
+			props: [{
+				...getMenuViewTransitionAttrs(menuViewTransitionState),
+				role: "menu",
+				tabIndex: -1,
+				"data-submenu": "",
+				onKeyDownCapture: preventMenuKeyDefault,
+				onKeyDown: handleSubMenuKeyDown,
+				onBlur
+			}, elementProps]
+		});
+		const parentViewportElement = getMenuViewportElement(parentMenu?.menu.contentElement ?? parentContentElementRef.current);
+		return parentViewportElement ? createPortal(subMenuContent, parentViewportElement) : subMenuContent;
+	}
+	if (!state.open) return null;
+	return renderElement("div", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		stateAttrMap,
+		ref: rootComposedRef,
+		props: [
+			{
+				id: contentId,
+				style: manualStyle ?? anchorStyle ?? POPOVER_RESET,
+				...core.getContentAttrs(state),
+				...getMenuViewportAttrs()
+			},
+			{
+				onKeyDownCapture: preventMenuKeyDefault,
+				onKeyDown: handleRootMenuKeyDown,
+				onBlur: handleRootMenuBlur
+			},
+			elementProps
+		]
+	});
+});
+//#endregion
+export { MenuContent };
+
+//# sourceMappingURL=menu-content.js.map

package/dist/dev/ui/menu/menu-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-content.js","names":[],"sources":["../../../../src/ui/menu/menu-content.tsx"],"sourcesContent":["'use client';\n\nimport { type MenuState, PopoverCSSVars } from '@videojs/core';\nimport {\n  createMenuViewTransition,\n  getAnchorPositionStyle,\n  getMenuViewportAttrs,\n  getMenuViewportElement,\n  getMenuViewTransitionAttrs,\n  getPopupPositionRect,\n  getPositioningBoundaryRect,\n  getRootPositionOptions,\n  isEventWithinElement,\n  isMenuNavigationKey,\n  observeMenuViewContent,\n  resolveOffsets,\n  resolvePositioningBoundary,\n  syncMenuViewRoot,\n  syncMenuViewTransition,\n  type UIFocusEvent,\n  type UIKeyboardEvent,\n} from '@videojs/core/dom';\nimport { useSnapshot } from '@videojs/store/react';\nimport { supportsAnchorPositioning } from '@videojs/utils/dom';\nimport type { CSSProperties } from 'react';\nimport { forwardRef, useCallback, useLayoutEffect, useMemo, useRef, useState } from 'react';\nimport { createPortal } from 'react-dom';\n\nimport type { UIComponentProps } from '../../utils/types';\nimport { useComposedRefs } from '../../utils/use-composed-refs';\nimport { renderElement } from '../../utils/use-render';\nimport { useMenuContext, useSubMenuContext } from './context';\n\nexport interface MenuContentProps extends UIComponentProps<'div', MenuState> {}\n\nconst POPOVER_RESET: CSSProperties = { position: 'fixed', inset: 'auto', margin: 0 };\nconst menuPreventedNativeEvents = new WeakSet<Event>();\n\nfunction toUIKeyboardEvent(event: React.KeyboardEvent<HTMLDivElement>): UIKeyboardEvent {\n  return {\n    get defaultPrevented() {\n      return event.defaultPrevented;\n    },\n    key: event.key,\n    shiftKey: event.shiftKey,\n    ctrlKey: event.ctrlKey,\n    altKey: event.altKey,\n    metaKey: event.metaKey,\n    target: event.target instanceof Node ? event.target : event.currentTarget,\n    currentTarget: event.currentTarget,\n    preventDefault: () => event.preventDefault(),\n    stopPropagation: () => event.stopPropagation(),\n  };\n}\n\nfunction toUIFocusEvent(event: React.FocusEvent<HTMLDivElement>): UIFocusEvent {\n  return {\n    get defaultPrevented() {\n      return event.defaultPrevented;\n    },\n    relatedTarget: event.relatedTarget,\n    preventDefault: () => event.preventDefault(),\n    stopPropagation: () => event.stopPropagation(),\n  };\n}\n\nfunction preventMenuKeyDefault(event: React.KeyboardEvent<HTMLDivElement>): void {\n  const keyboardEvent = toUIKeyboardEvent(event);\n\n  if (event.key !== 'Escape' && isMenuNavigationKey(keyboardEvent) && !event.defaultPrevented) {\n    event.preventDefault();\n    menuPreventedNativeEvents.add(event.nativeEvent);\n  }\n}\n\nfunction wasDefaultPreventedByMenu(event: React.KeyboardEvent<HTMLDivElement>): boolean {\n  return menuPreventedNativeEvents.has(event.nativeEvent);\n}\n\nfunction callKeyDownHandler(\n  handler: React.KeyboardEventHandler<HTMLDivElement> | undefined,\n  event: React.KeyboardEvent<HTMLDivElement>\n): boolean {\n  const defaultPreventedBeforeHandler = event.defaultPrevented && !wasDefaultPreventedByMenu(event);\n\n  if (!handler) return defaultPreventedBeforeHandler;\n\n  let defaultPreventedByHandler = false;\n  const preventDefault = event.preventDefault;\n\n  // Capture-phase menu handling may have already prevented default; track\n  // whether the consumer also calls preventDefault while their handler runs.\n  event.preventDefault = () => {\n    defaultPreventedByHandler = true;\n    preventDefault.call(event);\n  };\n\n  try {\n    handler(event);\n  } finally {\n    event.preventDefault = preventDefault;\n  }\n\n  return defaultPreventedBeforeHandler || defaultPreventedByHandler;\n}\n\n/** Container for menu items. Positioned relative to the trigger at root level; renders in-place as a submenu panel when nested. */\nexport const MenuContent = forwardRef<HTMLDivElement, MenuContentProps>(function MenuContent(\n  { render, className, style, onKeyDown, onBlur, ...elementProps },\n  forwardedRef\n) {\n  const { core, menu, state, stateAttrMap, anchorName, contentId, boundary, container, activeSubMenuId } =\n    useMenuContext();\n  const subMenuCtx = useSubMenuContext();\n  const isSubmenu = state.isSubmenu;\n\n  const parentMenu = subMenuCtx?.parentMenu ?? null;\n  const subMenuId = subMenuCtx?.subMenuId ?? null;\n\n  const isActive =\n    isSubmenu && parentMenu !== null && subMenuId !== null ? parentMenu.activeSubMenuId === subMenuId : false;\n\n  const [menuViewTransition] = useState(() =>\n    createMenuViewTransition({\n      focusFirstItem() {\n        menu.highlightFirstItem({ preventScroll: true });\n      },\n      restoreFocus(triggerId) {\n        if (triggerId) {\n          document.getElementById(triggerId)?.focus({ preventScroll: true });\n        }\n      },\n    })\n  );\n  const menuViewTransitionState = useSnapshot(menuViewTransition.input);\n  const menuViewElementRef = useRef<HTMLDivElement | null>(null);\n  const parentContentElementRef = useRef<HTMLElement | null>(null);\n  const activeSubMenuIdRef = useRef(activeSubMenuId);\n\n  activeSubMenuIdRef.current = activeSubMenuId;\n\n  useLayoutEffect(() => {\n    return () => menuViewTransition.destroy();\n  }, [menuViewTransition]);\n\n  useLayoutEffect(() => {\n    if (!isSubmenu) return;\n\n    menuViewTransition.sync({\n      active: isActive,\n      direction: parentMenu?.navigationDirection ?? 'forward',\n      triggerId: parentMenu?.activeSubMenuTriggerId ?? null,\n    });\n  }, [isActive, isSubmenu, parentMenu, menuViewTransition]);\n\n  const setMenuViewElement = useCallback(\n    (element: HTMLDivElement | null) => {\n      menuViewElementRef.current = element;\n      menu.setContentElement(element);\n      menuViewTransition.setElement(element);\n    },\n    [menu, menuViewTransition]\n  );\n\n  const handleSubMenuKeyDown = useCallback(\n    (event: React.KeyboardEvent<HTMLDivElement>) => {\n      const defaultPreventedByUser = callKeyDownHandler(\n        onKeyDown as React.KeyboardEventHandler<HTMLDivElement> | undefined,\n        event\n      );\n      const keyboardEvent = toUIKeyboardEvent(event);\n      const isNavigationKey = isMenuNavigationKey(keyboardEvent);\n      menu.contentProps.onKeyDown(keyboardEvent);\n      const isBackNavigationKey = event.key === 'ArrowLeft' || event.key === 'Escape';\n\n      const ownsActiveSubmenu =\n        parentMenu !== null &&\n        subMenuId !== null &&\n        parentMenu.menu.navigationInput.current.stack[parentMenu.menu.navigationInput.current.stack.length - 1]\n          ?.menuId === subMenuId;\n\n      if (isBackNavigationKey && ownsActiveSubmenu && !defaultPreventedByUser) {\n        event.preventDefault();\n        parentMenu.pop();\n      }\n\n      if (isNavigationKey && (!isBackNavigationKey || ownsActiveSubmenu)) {\n        event.stopPropagation();\n      }\n    },\n    [onKeyDown, parentMenu, subMenuId, menu]\n  );\n\n  const handleRootMenuKeyDown = useCallback(\n    (event: React.KeyboardEvent<HTMLDivElement>) => {\n      (onKeyDown as React.KeyboardEventHandler<HTMLDivElement> | undefined)?.(event);\n      const keyboardEvent = toUIKeyboardEvent(event);\n      menu.contentProps.onKeyDown(keyboardEvent);\n      if (event.key === 'Escape') return;\n      if (isMenuNavigationKey(keyboardEvent)) {\n        event.stopPropagation();\n      }\n    },\n    [onKeyDown, menu]\n  );\n\n  const handleRootMenuBlur = useCallback(\n    (event: React.FocusEvent<HTMLDivElement>) => {\n      (onBlur as React.FocusEventHandler<HTMLDivElement> | undefined)?.(event);\n      menu.contentProps.onFocusOut(toUIFocusEvent(event));\n    },\n    [onBlur, menu]\n  );\n\n  // ─── Root content state (always declared — Rules of Hooks) ───────────────\n  const internalRef = useRef<HTMLDivElement>(null);\n\n  const contentRef = useCallback(\n    (element: HTMLDivElement | null) => {\n      if (isSubmenu) return;\n      menu.setContentElement(element);\n      if (element && supportsAnchorPositioning()) {\n        element.style.setProperty('position-anchor', `--${anchorName}`);\n      }\n    },\n    [isSubmenu, menu, anchorName]\n  );\n\n  const rootComposedRef = useComposedRefs(forwardedRef, contentRef, internalRef);\n  const menuViewComposedRef = useComposedRefs(forwardedRef, setMenuViewElement);\n\n  const positionOptions = useMemo(() => getRootPositionOptions(state.side, state.align), [state.side, state.align]);\n\n  const anchorStyle = useMemo(() => {\n    if (isSubmenu || !positionOptions || !supportsAnchorPositioning()) return null;\n    const { positionAnchor: _, ...rest } = getAnchorPositionStyle(anchorName, positionOptions);\n    return rest as CSSProperties;\n  }, [isSubmenu, anchorName, positionOptions]);\n\n  const [manualStyle, setManualStyle] = useState<CSSProperties | null>(null);\n\n  useLayoutEffect(() => {\n    if (isSubmenu) return;\n    if (!state.open) return;\n\n    syncMenuViewRoot(internalRef.current, activeSubMenuId !== null);\n\n    const contentElement = internalRef.current;\n    if (!contentElement) return;\n\n    return observeMenuViewContent(contentElement, () => {\n      syncMenuViewRoot(contentElement, activeSubMenuId !== null);\n    });\n  }, [isSubmenu, state.open, activeSubMenuId]);\n\n  useLayoutEffect(() => {\n    if (!isSubmenu) return;\n\n    const parentContentElement = parentMenu?.menu.contentElement ?? parentContentElementRef.current;\n    parentContentElementRef.current = parentContentElement;\n    syncMenuViewTransition(parentContentElement, menuViewElementRef.current, menuViewTransitionState);\n  });\n\n  useLayoutEffect(() => {\n    if (isSubmenu) return;\n    if (!state.open) {\n      setManualStyle(null);\n      return;\n    }\n\n    if (!positionOptions) {\n      syncMenuViewRoot(internalRef.current, activeSubMenuIdRef.current !== null);\n      return;\n    }\n\n    const rootPositionOptions = positionOptions;\n\n    function measure(): void {\n      const triggerElement = menu.triggerElement;\n      const contentElement = internalRef.current;\n      if (!triggerElement || !contentElement) return;\n\n      const triggerRect = triggerElement.getBoundingClientRect();\n      const root = contentElement.getRootNode() as Document | ShadowRoot;\n      const boundaryElement = resolvePositioningBoundary(boundary, { container, root });\n      const anchorSupported = supportsAnchorPositioning();\n      const contentRect = anchorSupported ? undefined : getPopupPositionRect(contentElement);\n      const boundaryRect = getPositioningBoundaryRect(boundaryElement);\n      const offsets = resolveOffsets(contentElement);\n\n      let nextStyle = getAnchorPositionStyle(\n        anchorName,\n        rootPositionOptions,\n        triggerRect,\n        contentRect,\n        boundaryRect,\n        offsets\n      );\n\n      const availableWidth = nextStyle[PopoverCSSVars.availableWidth];\n      syncMenuViewRoot(\n        contentElement,\n        activeSubMenuIdRef.current !== null,\n        availableWidth ? { availableWidth } : undefined\n      );\n\n      if (!anchorSupported) {\n        nextStyle = getAnchorPositionStyle(\n          anchorName,\n          rootPositionOptions,\n          triggerRect,\n          getPopupPositionRect(contentElement),\n          boundaryRect,\n          offsets\n        );\n      }\n\n      const { positionAnchor: _, ...rootStyle } = nextStyle;\n\n      setManualStyle(rootStyle as CSSProperties);\n    }\n\n    measure();\n\n    const triggerElement = menu.triggerElement;\n    const contentElement = internalRef.current;\n    const boundaryElement = contentElement\n      ? resolvePositioningBoundary(boundary, {\n          container,\n          root: contentElement.getRootNode() as Document | ShadowRoot,\n        })\n      : null;\n\n    let animationFrameId = 0;\n    function reposition(event?: Event): void {\n      if (event && isEventWithinElement(event, internalRef.current)) return;\n\n      cancelAnimationFrame(animationFrameId);\n      animationFrameId = requestAnimationFrame(measure);\n    }\n\n    reposition();\n\n    const resizeObserver = typeof ResizeObserver === 'function' ? new ResizeObserver(() => reposition()) : null;\n\n    if (triggerElement && resizeObserver) resizeObserver.observe(triggerElement);\n    if (contentElement && resizeObserver) resizeObserver.observe(contentElement);\n    if (boundaryElement && resizeObserver) resizeObserver.observe(boundaryElement);\n\n    window.addEventListener('scroll', reposition, { capture: true, passive: true });\n    window.addEventListener('resize', reposition);\n\n    return () => {\n      cancelAnimationFrame(animationFrameId);\n      resizeObserver?.disconnect();\n      window.removeEventListener('scroll', reposition, true);\n      window.removeEventListener('resize', reposition);\n    };\n  }, [isSubmenu, state.open, anchorName, positionOptions, menu, boundary, container]);\n\n  // ─── Render ───────────────────────────────────────────────────────────────\n\n  if (isSubmenu) {\n    if (menuViewTransitionState.phase === 'hidden') return null;\n\n    const subMenuContent = renderElement(\n      'div',\n      { render, className, style },\n      {\n        state,\n        ref: menuViewComposedRef,\n        props: [\n          {\n            ...getMenuViewTransitionAttrs(menuViewTransitionState),\n            role: 'menu' as const,\n            tabIndex: -1,\n            'data-submenu': '',\n            onKeyDownCapture: preventMenuKeyDefault,\n            onKeyDown: handleSubMenuKeyDown,\n            onBlur,\n          },\n          elementProps,\n        ],\n      }\n    );\n\n    const parentContentElement = parentMenu?.menu.contentElement ?? parentContentElementRef.current;\n\n    const parentViewportElement = getMenuViewportElement(parentContentElement);\n\n    return parentViewportElement ? createPortal(subMenuContent, parentViewportElement) : subMenuContent;\n  }\n\n  if (!state.open) return null;\n\n  const positioningStyle = manualStyle ?? anchorStyle ?? POPOVER_RESET;\n\n  return renderElement(\n    'div',\n    { render, className, style },\n    {\n      state,\n      stateAttrMap,\n      ref: rootComposedRef,\n      props: [\n        {\n          id: contentId,\n          style: positioningStyle,\n          ...core.getContentAttrs(state),\n          ...getMenuViewportAttrs(),\n        },\n        { onKeyDownCapture: preventMenuKeyDefault, onKeyDown: handleRootMenuKeyDown, onBlur: handleRootMenuBlur },\n        elementProps,\n      ],\n    }\n  );\n});\n\nexport namespace MenuContent {\n  export type Props = MenuContentProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;;;;;;AAmCA,MAAM,gBAA+B;CAAE,UAAU;CAAS,OAAO;CAAQ,QAAQ;CAAG;AACpF,MAAM,4CAA4B,IAAI,SAAgB;AAEtD,SAAS,kBAAkB,OAA6D;AACtF,QAAO;EACL,IAAI,mBAAmB;AACrB,UAAO,MAAM;;EAEf,KAAK,MAAM;EACX,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,QAAQ,MAAM,kBAAkB,OAAO,MAAM,SAAS,MAAM;EAC5D,eAAe,MAAM;EACrB,sBAAsB,MAAM,gBAAgB;EAC5C,uBAAuB,MAAM,iBAAiB;EAC/C;;AAGH,SAAS,eAAe,OAAuD;AAC7E,QAAO;EACL,IAAI,mBAAmB;AACrB,UAAO,MAAM;;EAEf,eAAe,MAAM;EACrB,sBAAsB,MAAM,gBAAgB;EAC5C,uBAAuB,MAAM,iBAAiB;EAC/C;;AAGH,SAAS,sBAAsB,OAAkD;CAC/E,MAAM,gBAAgB,kBAAkB,MAAM;AAE9C,KAAI,MAAM,QAAQ,YAAY,oBAAoB,cAAc,IAAI,CAAC,MAAM,kBAAkB;AAC3F,QAAM,gBAAgB;AACtB,4BAA0B,IAAI,MAAM,YAAY;;;AAIpD,SAAS,0BAA0B,OAAqD;AACtF,QAAO,0BAA0B,IAAI,MAAM,YAAY;;AAGzD,SAAS,mBACP,SACA,OACS;CACT,MAAM,gCAAgC,MAAM,oBAAoB,CAAC,0BAA0B,MAAM;AAEjG,KAAI,CAAC,QAAS,QAAO;CAErB,IAAI,4BAA4B;CAChC,MAAM,iBAAiB,MAAM;AAI7B,OAAM,uBAAuB;AAC3B,8BAA4B;AAC5B,iBAAe,KAAK,MAAM;;AAG5B,KAAI;AACF,UAAQ,MAAM;WACN;AACR,QAAM,iBAAiB;;AAGzB,QAAO,iCAAiC;;;AAI1C,MAAa,cAAc,WAA6C,SAAS,YAC/E,EAAE,QAAQ,WAAW,OAAO,WAAW,QAAQ,GAAG,gBAClD,cACA;CACA,MAAM,EAAE,MAAM,MAAM,OAAO,cAAc,YAAY,WAAW,UAAU,WAAW,oBACnF,gBAAgB;CAClB,MAAM,aAAa,mBAAmB;CACtC,MAAM,YAAY,MAAM;CAExB,MAAM,aAAa,YAAY,cAAc;CAC7C,MAAM,YAAY,YAAY,aAAa;CAE3C,MAAM,WACJ,aAAa,eAAe,QAAQ,cAAc,OAAO,WAAW,oBAAoB,YAAY;CAEtG,MAAM,CAAC,sBAAsB,eAC3B,yBAAyB;EACvB,iBAAiB;AACf,QAAK,mBAAmB,EAAE,eAAe,MAAM,CAAC;;EAElD,aAAa,WAAW;AACtB,OAAI,UACF,UAAS,eAAe,UAAU,EAAE,MAAM,EAAE,eAAe,MAAM,CAAC;;EAGvE,CAAC,CACH;CACD,MAAM,0BAA0B,YAAY,mBAAmB,MAAM;CACrE,MAAM,qBAAqB,OAA8B,KAAK;CAC9D,MAAM,0BAA0B,OAA2B,KAAK;CAChE,MAAM,qBAAqB,OAAO,gBAAgB;AAElD,oBAAmB,UAAU;AAE7B,uBAAsB;AACpB,eAAa,mBAAmB,SAAS;IACxC,CAAC,mBAAmB,CAAC;AAExB,uBAAsB;AACpB,MAAI,CAAC,UAAW;AAEhB,qBAAmB,KAAK;GACtB,QAAQ;GACR,WAAW,YAAY,uBAAuB;GAC9C,WAAW,YAAY,0BAA0B;GAClD,CAAC;IACD;EAAC;EAAU;EAAW;EAAY;EAAmB,CAAC;CAEzD,MAAM,qBAAqB,aACxB,YAAmC;AAClC,qBAAmB,UAAU;AAC7B,OAAK,kBAAkB,QAAQ;AAC/B,qBAAmB,WAAW,QAAQ;IAExC,CAAC,MAAM,mBAAmB,CAC3B;CAED,MAAM,uBAAuB,aAC1B,UAA+C;EAC9C,MAAM,yBAAyB,mBAC7B,WACA,MACD;EACD,MAAM,gBAAgB,kBAAkB,MAAM;EAC9C,MAAM,kBAAkB,oBAAoB,cAAc;AAC1D,OAAK,aAAa,UAAU,cAAc;EAC1C,MAAM,sBAAsB,MAAM,QAAQ,eAAe,MAAM,QAAQ;EAEvE,MAAM,oBACJ,eAAe,QACf,cAAc,QACd,WAAW,KAAK,gBAAgB,QAAQ,MAAM,WAAW,KAAK,gBAAgB,QAAQ,MAAM,SAAS,IACjG,WAAW;AAEjB,MAAI,uBAAuB,qBAAqB,CAAC,wBAAwB;AACvE,SAAM,gBAAgB;AACtB,cAAW,KAAK;;AAGlB,MAAI,oBAAoB,CAAC,uBAAuB,mBAC9C,OAAM,iBAAiB;IAG3B;EAAC;EAAW;EAAY;EAAW;EAAK,CACzC;CAED,MAAM,wBAAwB,aAC3B,UAA+C;AAC7C,cAAuE,MAAM;EAC9E,MAAM,gBAAgB,kBAAkB,MAAM;AAC9C,OAAK,aAAa,UAAU,cAAc;AAC1C,MAAI,MAAM,QAAQ,SAAU;AAC5B,MAAI,oBAAoB,cAAc,CACpC,OAAM,iBAAiB;IAG3B,CAAC,WAAW,KAAK,CAClB;CAED,MAAM,qBAAqB,aACxB,UAA4C;AAC1C,WAAiE,MAAM;AACxE,OAAK,aAAa,WAAW,eAAe,MAAM,CAAC;IAErD,CAAC,QAAQ,KAAK,CACf;CAGD,MAAM,cAAc,OAAuB,KAAK;CAahD,MAAM,kBAAkB,gBAAgB,cAXrB,aAChB,YAAmC;AAClC,MAAI,UAAW;AACf,OAAK,kBAAkB,QAAQ;AAC/B,MAAI,WAAW,2BAA2B,CACxC,SAAQ,MAAM,YAAY,mBAAmB,KAAK,aAAa;IAGnE;EAAC;EAAW;EAAM;EAAW,CAC9B,EAEiE,YAAY;CAC9E,MAAM,sBAAsB,gBAAgB,cAAc,mBAAmB;CAE7E,MAAM,kBAAkB,cAAc,uBAAuB,MAAM,MAAM,MAAM,MAAM,EAAE,CAAC,MAAM,MAAM,MAAM,MAAM,CAAC;CAEjH,MAAM,cAAc,cAAc;AAChC,MAAI,aAAa,CAAC,mBAAmB,CAAC,2BAA2B,CAAE,QAAO;EAC1E,MAAM,EAAE,gBAAgB,GAAG,GAAG,SAAS,uBAAuB,YAAY,gBAAgB;AAC1F,SAAO;IACN;EAAC;EAAW;EAAY;EAAgB,CAAC;CAE5C,MAAM,CAAC,aAAa,kBAAkB,SAA+B,KAAK;AAE1E,uBAAsB;AACpB,MAAI,UAAW;AACf,MAAI,CAAC,MAAM,KAAM;AAEjB,mBAAiB,YAAY,SAAS,oBAAoB,KAAK;EAE/D,MAAM,iBAAiB,YAAY;AACnC,MAAI,CAAC,eAAgB;AAErB,SAAO,uBAAuB,sBAAsB;AAClD,oBAAiB,gBAAgB,oBAAoB,KAAK;IAC1D;IACD;EAAC;EAAW,MAAM;EAAM;EAAgB,CAAC;AAE5C,uBAAsB;AACpB,MAAI,CAAC,UAAW;EAEhB,MAAM,uBAAuB,YAAY,KAAK,kBAAkB,wBAAwB;AACxF,0BAAwB,UAAU;AAClC,yBAAuB,sBAAsB,mBAAmB,SAAS,wBAAwB;GACjG;AAEF,uBAAsB;AACpB,MAAI,UAAW;AACf,MAAI,CAAC,MAAM,MAAM;AACf,kBAAe,KAAK;AACpB;;AAGF,MAAI,CAAC,iBAAiB;AACpB,oBAAiB,YAAY,SAAS,mBAAmB,YAAY,KAAK;AAC1E;;EAGF,MAAM,sBAAsB;EAE5B,SAAS,UAAgB;GACvB,MAAM,iBAAiB,KAAK;GAC5B,MAAM,iBAAiB,YAAY;AACnC,OAAI,CAAC,kBAAkB,CAAC,eAAgB;GAExC,MAAM,cAAc,eAAe,uBAAuB;GAE1D,MAAM,kBAAkB,2BAA2B,UAAU;IAAE;IAAW,MAD7D,eAAe,aAAa;IACuC,CAAC;GACjF,MAAM,kBAAkB,2BAA2B;GACnD,MAAM,cAAc,kBAAkB,KAAA,IAAY,qBAAqB,eAAe;GACtF,MAAM,eAAe,2BAA2B,gBAAgB;GAChE,MAAM,UAAU,eAAe,eAAe;GAE9C,IAAI,YAAY,uBACd,YACA,qBACA,aACA,aACA,cACA,QACD;GAED,MAAM,iBAAiB,UAAU,eAAe;AAChD,oBACE,gBACA,mBAAmB,YAAY,MAC/B,iBAAiB,EAAE,gBAAgB,GAAG,KAAA,EACvC;AAED,OAAI,CAAC,gBACH,aAAY,uBACV,YACA,qBACA,aACA,qBAAqB,eAAe,EACpC,cACA,QACD;GAGH,MAAM,EAAE,gBAAgB,GAAG,GAAG,cAAc;AAE5C,kBAAe,UAA2B;;AAG5C,WAAS;EAET,MAAM,iBAAiB,KAAK;EAC5B,MAAM,iBAAiB,YAAY;EACnC,MAAM,kBAAkB,iBACpB,2BAA2B,UAAU;GACnC;GACA,MAAM,eAAe,aAAa;GACnC,CAAC,GACF;EAEJ,IAAI,mBAAmB;EACvB,SAAS,WAAW,OAAqB;AACvC,OAAI,SAAS,qBAAqB,OAAO,YAAY,QAAQ,CAAE;AAE/D,wBAAqB,iBAAiB;AACtC,sBAAmB,sBAAsB,QAAQ;;AAGnD,cAAY;EAEZ,MAAM,iBAAiB,OAAO,mBAAmB,aAAa,IAAI,qBAAqB,YAAY,CAAC,GAAG;AAEvG,MAAI,kBAAkB,eAAgB,gBAAe,QAAQ,eAAe;AAC5E,MAAI,kBAAkB,eAAgB,gBAAe,QAAQ,eAAe;AAC5E,MAAI,mBAAmB,eAAgB,gBAAe,QAAQ,gBAAgB;AAE9E,SAAO,iBAAiB,UAAU,YAAY;GAAE,SAAS;GAAM,SAAS;GAAM,CAAC;AAC/E,SAAO,iBAAiB,UAAU,WAAW;AAE7C,eAAa;AACX,wBAAqB,iBAAiB;AACtC,mBAAgB,YAAY;AAC5B,UAAO,oBAAoB,UAAU,YAAY,KAAK;AACtD,UAAO,oBAAoB,UAAU,WAAW;;IAEjD;EAAC;EAAW,MAAM;EAAM;EAAY;EAAiB;EAAM;EAAU;EAAU,CAAC;AAInF,KAAI,WAAW;AACb,MAAI,wBAAwB,UAAU,SAAU,QAAO;EAEvD,MAAM,iBAAiB,cACrB,OACA;GAAE;GAAQ;GAAW;GAAO,EAC5B;GACE;GACA,KAAK;GACL,OAAO,CACL;IACE,GAAG,2BAA2B,wBAAwB;IACtD,MAAM;IACN,UAAU;IACV,gBAAgB;IAChB,kBAAkB;IAClB,WAAW;IACX;IACD,EACD,aACD;GACF,CACF;EAID,MAAM,wBAAwB,uBAFD,YAAY,KAAK,kBAAkB,wBAAwB,QAEd;AAE1E,SAAO,wBAAwB,aAAa,gBAAgB,sBAAsB,GAAG;;AAGvF,KAAI,CAAC,MAAM,KAAM,QAAO;AAIxB,QAAO,cACL,OACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA;EACA,KAAK;EACL,OAAO;GACL;IACE,IAAI;IACJ,OAZiB,eAAe,eAAe;IAa/C,GAAG,KAAK,gBAAgB,MAAM;IAC9B,GAAG,sBAAsB;IAC1B;GACD;IAAE,kBAAkB;IAAuB,WAAW;IAAuB,QAAQ;IAAoB;GACzG;GACD;EACF,CACF;EACD"}

package/dist/dev/ui/menu/menu-group-label.d.ts

@@ -0,0 +1,15 @@
+import { UIComponentProps } from "../../utils/types.js";
+import * as _$react from "react";
+import { MenuState } from "@videojs/core";
+
+//#region src/ui/menu/menu-group-label.d.ts
+interface MenuGroupLabelProps extends UIComponentProps<'div', MenuState> {}
+/** Non-interactive label for a group of items. Renders a `<div>`. */
+declare const MenuGroupLabel: _$react.ForwardRefExoticComponent<Omit<MenuGroupLabelProps, "ref"> & _$react.RefAttributes<HTMLDivElement>>;
+declare namespace MenuGroupLabel {
+  type Props = MenuGroupLabelProps;
+  type State = MenuState;
+}
+//#endregion
+export { MenuGroupLabel, MenuGroupLabelProps };
+//# sourceMappingURL=menu-group-label.d.ts.map

package/dist/dev/ui/menu/menu-group-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-group-label.d.ts","names":[],"sources":["../../../../src/ui/menu/menu-group-label.tsx"],"mappings":";;;;;UAUiB,mBAAA,SAA4B,gBAAA,QAAwB,SAAA;;cAGxD,cAAA,EAAc,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,mBAAA,WAAA,OAAA,CAAA,aAAA,CAAA,cAAA;AAAA,kBAwBV,cAAA;EAAA,KACH,KAAA,GAAQ,mBAAA;EAAA,KACR,KAAA,GAAQ,SAAA;AAAA"}

package/dist/dev/ui/menu/menu-group-label.js

@@ -0,0 +1,29 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext, useMenuGroupContext } from "./context.js";
+import { useSafeId } from "../../utils/use-safe-id.js";
+import { forwardRef, useLayoutEffect } from "react";
+//#region src/ui/menu/menu-group-label.tsx
+/** Non-interactive label for a group of items. Renders a `<div>`. */
+const MenuGroupLabel = forwardRef(function MenuGroupLabel({ render, className, style, id: idProp, ...elementProps }, forwardedRef) {
+	const { state } = useMenuContext();
+	const group = useMenuGroupContext();
+	const generatedId = useSafeId("menu-group-label");
+	const id = idProp ?? generatedId;
+	useLayoutEffect(() => {
+		return group?.registerLabel(id);
+	}, [group, id]);
+	return renderElement("div", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		ref: [forwardedRef],
+		props: [{ id }, elementProps]
+	});
+});
+//#endregion
+export { MenuGroupLabel };
+
+//# sourceMappingURL=menu-group-label.js.map

package/dist/dev/ui/menu/menu-group-label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-group-label.js","names":[],"sources":["../../../../src/ui/menu/menu-group-label.tsx"],"sourcesContent":["'use client';\n\nimport type { MenuState } from '@videojs/core';\nimport { forwardRef, useLayoutEffect } from 'react';\n\nimport type { UIComponentProps } from '../../utils/types';\nimport { renderElement } from '../../utils/use-render';\nimport { useSafeId } from '../../utils/use-safe-id';\nimport { useMenuContext, useMenuGroupContext } from './context';\n\nexport interface MenuGroupLabelProps extends UIComponentProps<'div', MenuState> {}\n\n/** Non-interactive label for a group of items. Renders a `<div>`. */\nexport const MenuGroupLabel = forwardRef<HTMLDivElement, MenuGroupLabelProps>(function MenuGroupLabel(\n  { render, className, style, id: idProp, ...elementProps },\n  forwardedRef\n) {\n  const { state } = useMenuContext();\n  const group = useMenuGroupContext();\n  const generatedId = useSafeId('menu-group-label');\n  const id = idProp ?? generatedId;\n\n  useLayoutEffect(() => {\n    return group?.registerLabel(id);\n  }, [group, id]);\n\n  return renderElement(\n    'div',\n    { render, className, style },\n    {\n      state,\n      ref: [forwardedRef],\n      props: [{ id }, elementProps],\n    }\n  );\n});\n\nexport namespace MenuGroupLabel {\n  export type Props = MenuGroupLabelProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;;AAaA,MAAa,iBAAiB,WAAgD,SAAS,eACrF,EAAE,QAAQ,WAAW,OAAO,IAAI,QAAQ,GAAG,gBAC3C,cACA;CACA,MAAM,EAAE,UAAU,gBAAgB;CAClC,MAAM,QAAQ,qBAAqB;CACnC,MAAM,cAAc,UAAU,mBAAmB;CACjD,MAAM,KAAK,UAAU;AAErB,uBAAsB;AACpB,SAAO,OAAO,cAAc,GAAG;IAC9B,CAAC,OAAO,GAAG,CAAC;AAEf,QAAO,cACL,OACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA,KAAK,CAAC,aAAa;EACnB,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa;EAC9B,CACF;EACD"}

package/dist/dev/ui/menu/menu-group.d.ts

@@ -0,0 +1,15 @@
+import { UIComponentProps } from "../../utils/types.js";
+import * as _$react from "react";
+import { MenuState } from "@videojs/core";
+
+//#region src/ui/menu/menu-group.d.ts
+interface MenuGroupProps extends UIComponentProps<'div', MenuState> {}
+/** Groups related menu items. Renders a `<div>` with `role="group"`. */
+declare const MenuGroup: _$react.ForwardRefExoticComponent<Omit<MenuGroupProps, "ref"> & _$react.RefAttributes<HTMLDivElement>>;
+declare namespace MenuGroup {
+  type Props = MenuGroupProps;
+  type State = MenuState;
+}
+//#endregion
+export { MenuGroup, MenuGroupProps };
+//# sourceMappingURL=menu-group.d.ts.map

package/dist/dev/ui/menu/menu-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-group.d.ts","names":[],"sources":["../../../../src/ui/menu/menu-group.tsx"],"mappings":";;;;;UAUiB,cAAA,SAAuB,gBAAA,QAAwB,SAAA;;cAGnD,SAAA,EAAS,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,cAAA,WAAA,OAAA,CAAA,aAAA,CAAA,cAAA;AAAA,kBAuBL,SAAA;EAAA,KACH,KAAA,GAAQ,cAAA;EAAA,KACR,KAAA,GAAQ,SAAA;AAAA"}

package/dist/dev/ui/menu/menu-group.js

@@ -0,0 +1,24 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext } from "./context.js";
+import { MenuGroupProvider, getMenuGroupProps } from "./use-menu-group.js";
+import { forwardRef } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/ui/menu/menu-group.tsx
+/** Groups related menu items. Renders a `<div>` with `role="group"`. */
+const MenuGroup = forwardRef(function MenuGroup({ render, className, style, ...elementProps }, forwardedRef) {
+	const { state } = useMenuContext();
+	return /* @__PURE__ */ jsx(MenuGroupProvider, { children: (labelId) => renderElement("div", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		ref: [forwardedRef],
+		props: [getMenuGroupProps(labelId, elementProps), elementProps]
+	}) });
+});
+//#endregion
+export { MenuGroup };
+
+//# sourceMappingURL=menu-group.js.map

package/dist/dev/ui/menu/menu-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-group.js","names":[],"sources":["../../../../src/ui/menu/menu-group.tsx"],"sourcesContent":["'use client';\n\nimport type { MenuState } from '@videojs/core';\nimport { forwardRef } from 'react';\n\nimport type { UIComponentProps } from '../../utils/types';\nimport { renderElement } from '../../utils/use-render';\nimport { useMenuContext } from './context';\nimport { getMenuGroupProps, MenuGroupProvider } from './use-menu-group';\n\nexport interface MenuGroupProps extends UIComponentProps<'div', MenuState> {}\n\n/** Groups related menu items. Renders a `<div>` with `role=\"group\"`. */\nexport const MenuGroup = forwardRef<HTMLDivElement, MenuGroupProps>(function MenuGroup(\n  { render, className, style, ...elementProps },\n  forwardedRef\n) {\n  const { state } = useMenuContext();\n\n  return (\n    <MenuGroupProvider>\n      {(labelId) =>\n        renderElement(\n          'div',\n          { render, className, style },\n          {\n            state,\n            ref: [forwardedRef],\n            props: [getMenuGroupProps(labelId, elementProps), elementProps],\n          }\n        )\n      }\n    </MenuGroupProvider>\n  );\n});\n\nexport namespace MenuGroup {\n  export type Props = MenuGroupProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;;;AAaA,MAAa,YAAY,WAA2C,SAAS,UAC3E,EAAE,QAAQ,WAAW,OAAO,GAAG,gBAC/B,cACA;CACA,MAAM,EAAE,UAAU,gBAAgB;AAElC,QACE,oBAAC,mBAAD,EAAA,WACI,YACA,cACE,OACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA,KAAK,CAAC,aAAa;EACnB,OAAO,CAAC,kBAAkB,SAAS,aAAa,EAAE,aAAa;EAChE,CACF,EAEe,CAAA;EAEtB"}

package/dist/dev/ui/menu/menu-item-indicator.d.ts

@@ -0,0 +1,20 @@
+import { UIComponentProps } from "../../utils/types.js";
+import * as _$react from "react";
+import { MenuState } from "@videojs/core";
+
+//#region src/ui/menu/menu-item-indicator.d.ts
+interface MenuItemIndicatorProps extends UIComponentProps<'span', MenuState> {
+  /** Whether the indicator is currently shown. Typically bound to the parent item's checked state. */
+  checked?: boolean;
+  /** When `true`, renders even when unchecked (useful for animating out). Defaults to `false`. */
+  forceMount?: boolean;
+}
+/** Visual indicator for a checked state. Only renders when `checked` is `true` (or `forceMount` is set). */
+declare const MenuItemIndicator: _$react.ForwardRefExoticComponent<Omit<MenuItemIndicatorProps, "ref"> & _$react.RefAttributes<HTMLSpanElement>>;
+declare namespace MenuItemIndicator {
+  type Props = MenuItemIndicatorProps;
+  type State = MenuState;
+}
+//#endregion
+export { MenuItemIndicator, MenuItemIndicatorProps };
+//# sourceMappingURL=menu-item-indicator.d.ts.map

package/dist/dev/ui/menu/menu-item-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-indicator.d.ts","names":[],"sources":["../../../../src/ui/menu/menu-item-indicator.tsx"],"mappings":";;;;;UASiB,sBAAA,SAA+B,gBAAA,SAAyB,SAAA;;EAEvE,OAAA;EAFe;EAIf,UAAA;AAAA;;cAIW,iBAAA,EAAiB,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,sBAAA,WAAA,OAAA,CAAA,aAAA,CAAA,eAAA;AAAA,kBAmBb,iBAAA;EAAA,KACH,KAAA,GAAQ,sBAAA;EAAA,KACR,KAAA,GAAQ,SAAA;AAAA"}

package/dist/dev/ui/menu/menu-item-indicator.js

@@ -0,0 +1,23 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext } from "./context.js";
+import { forwardRef } from "react";
+//#region src/ui/menu/menu-item-indicator.tsx
+/** Visual indicator for a checked state. Only renders when `checked` is `true` (or `forceMount` is set). */
+const MenuItemIndicator = forwardRef(function MenuItemIndicator({ render, className, style, checked, forceMount = false, ...elementProps }, forwardedRef) {
+	const { state } = useMenuContext();
+	if (!checked && !forceMount) return null;
+	return renderElement("span", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		ref: [forwardedRef],
+		props: [{ "aria-hidden": true }, elementProps]
+	});
+});
+//#endregion
+export { MenuItemIndicator };
+
+//# sourceMappingURL=menu-item-indicator.js.map

package/dist/dev/ui/menu/menu-item-indicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-indicator.js","names":[],"sources":["../../../../src/ui/menu/menu-item-indicator.tsx"],"sourcesContent":["'use client';\n\nimport type { MenuState } from '@videojs/core';\nimport { forwardRef } from 'react';\n\nimport type { UIComponentProps } from '../../utils/types';\nimport { renderElement } from '../../utils/use-render';\nimport { useMenuContext } from './context';\n\nexport interface MenuItemIndicatorProps extends UIComponentProps<'span', MenuState> {\n  /** Whether the indicator is currently shown. Typically bound to the parent item's checked state. */\n  checked?: boolean;\n  /** When `true`, renders even when unchecked (useful for animating out). Defaults to `false`. */\n  forceMount?: boolean;\n}\n\n/** Visual indicator for a checked state. Only renders when `checked` is `true` (or `forceMount` is set). */\nexport const MenuItemIndicator = forwardRef<HTMLSpanElement, MenuItemIndicatorProps>(function MenuItemIndicator(\n  { render, className, style, checked, forceMount = false, ...elementProps },\n  forwardedRef\n) {\n  const { state } = useMenuContext();\n\n  if (!checked && !forceMount) return null;\n\n  return renderElement(\n    'span',\n    { render, className, style },\n    {\n      state,\n      ref: [forwardedRef],\n      props: [{ 'aria-hidden': true }, elementProps],\n    }\n  );\n});\n\nexport namespace MenuItemIndicator {\n  export type Props = MenuItemIndicatorProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;AAiBA,MAAa,oBAAoB,WAAoD,SAAS,kBAC5F,EAAE,QAAQ,WAAW,OAAO,SAAS,aAAa,OAAO,GAAG,gBAC5D,cACA;CACA,MAAM,EAAE,UAAU,gBAAgB;AAElC,KAAI,CAAC,WAAW,CAAC,WAAY,QAAO;AAEpC,QAAO,cACL,QACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA,KAAK,CAAC,aAAa;EACnB,OAAO,CAAC,EAAE,eAAe,MAAM,EAAE,aAAa;EAC/C,CACF;EACD"}

package/dist/dev/ui/menu/menu-item-setting-provider.js

@@ -0,0 +1,72 @@
+"use client";
+import { MenuItemSettingContextProvider } from "./context.js";
+import { useAudioTrackOptions } from "../audio-track/use-audio-track-options.js";
+import { useCaptionsOptions } from "../captions-radio-group/use-captions-options.js";
+import { usePlaybackRateOptions } from "../playback-rate/use-playback-rate-options.js";
+import { useQualityOptions } from "../quality/use-quality-options.js";
+import { jsx } from "react/jsx-runtime";
+import { CAPTIONS_OFF_VALUE } from "@videojs/core";
+//#region src/ui/menu/menu-item-setting-provider.tsx
+function PlaybackRateMenuItemSettingProvider({ children }) {
+	const playbackRate = usePlaybackRateOptions();
+	if (!playbackRate) return children;
+	const { state, options, value } = playbackRate;
+	return /* @__PURE__ */ jsx(MenuItemSettingContextProvider, {
+		value: {
+			type: "playback-rate",
+			label: options.find((option) => option.value === value)?.label ?? "",
+			availability: state.availability
+		},
+		children
+	});
+}
+function CaptionsMenuItemSettingProvider({ children }) {
+	const captions = useCaptionsOptions();
+	if (!captions) return children;
+	const { state, options, value } = captions;
+	return /* @__PURE__ */ jsx(MenuItemSettingContextProvider, {
+		value: {
+			type: "captions",
+			label: value === CAPTIONS_OFF_VALUE ? "Off" : options.find((option) => option.value === value)?.label ?? "Off",
+			availability: state.availability
+		},
+		children
+	});
+}
+function QualityMenuItemSettingProvider({ children }) {
+	const quality = useQualityOptions();
+	if (!quality) return children;
+	const { state, options, value } = quality;
+	return /* @__PURE__ */ jsx(MenuItemSettingContextProvider, {
+		value: {
+			type: "quality",
+			label: options.find((option) => option.value === value)?.label ?? "Auto",
+			availability: state.availability
+		},
+		children
+	});
+}
+function AudioTrackMenuItemSettingProvider({ children }) {
+	const audioTrack = useAudioTrackOptions();
+	if (!audioTrack) return children;
+	const { state, options, value } = audioTrack;
+	return /* @__PURE__ */ jsx(MenuItemSettingContextProvider, {
+		value: {
+			type: "audio-track",
+			label: options.find((option) => option.value === value)?.label ?? "",
+			availability: state.availability
+		},
+		children
+	});
+}
+function MenuItemSettingProvider({ type, children }) {
+	if (type === "playback-rate") return /* @__PURE__ */ jsx(PlaybackRateMenuItemSettingProvider, { children });
+	if (type === "quality") return /* @__PURE__ */ jsx(QualityMenuItemSettingProvider, { children });
+	if (type === "audio-track") return /* @__PURE__ */ jsx(AudioTrackMenuItemSettingProvider, { children });
+	if (type === "captions") return /* @__PURE__ */ jsx(CaptionsMenuItemSettingProvider, { children });
+	return children;
+}
+//#endregion
+export { MenuItemSettingProvider };
+
+//# sourceMappingURL=menu-item-setting-provider.js.map

package/dist/dev/ui/menu/menu-item-setting-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-setting-provider.js","names":[],"sources":["../../../../src/ui/menu/menu-item-setting-provider.tsx"],"sourcesContent":["'use client';\n\nimport { CAPTIONS_OFF_VALUE } from '@videojs/core';\nimport type { ReactNode } from 'react';\n\nimport { useAudioTrackOptions } from '../audio-track/use-audio-track-options';\nimport { useCaptionsOptions } from '../captions-radio-group/use-captions-options';\nimport { usePlaybackRateOptions } from '../playback-rate/use-playback-rate-options';\nimport { useQualityOptions } from '../quality/use-quality-options';\nimport { MenuItemSettingContextProvider } from './context';\nimport type { MenuItemSettingType } from './menu-item-type';\n\nexport interface MenuItemSettingProviderProps {\n  type: MenuItemSettingType;\n  children: ReactNode;\n}\n\nfunction PlaybackRateMenuItemSettingProvider({ children }: { children: ReactNode }): ReactNode {\n  const playbackRate = usePlaybackRateOptions();\n  if (!playbackRate) return children;\n\n  const { state, options, value } = playbackRate;\n  const label = options.find((option) => option.value === value)?.label ?? '';\n\n  return (\n    <MenuItemSettingContextProvider value={{ type: 'playback-rate', label, availability: state.availability }}>\n      {children}\n    </MenuItemSettingContextProvider>\n  );\n}\n\nfunction CaptionsMenuItemSettingProvider({ children }: { children: ReactNode }): ReactNode {\n  const captions = useCaptionsOptions();\n  if (!captions) return children;\n\n  const { state, options, value } = captions;\n  const label =\n    value === CAPTIONS_OFF_VALUE ? 'Off' : (options.find((option) => option.value === value)?.label ?? 'Off');\n\n  return (\n    <MenuItemSettingContextProvider value={{ type: 'captions', label, availability: state.availability }}>\n      {children}\n    </MenuItemSettingContextProvider>\n  );\n}\n\nfunction QualityMenuItemSettingProvider({ children }: { children: ReactNode }): ReactNode {\n  const quality = useQualityOptions();\n  if (!quality) return children;\n\n  const { state, options, value } = quality;\n  const label = options.find((option) => option.value === value)?.label ?? 'Auto';\n\n  return (\n    <MenuItemSettingContextProvider value={{ type: 'quality', label, availability: state.availability }}>\n      {children}\n    </MenuItemSettingContextProvider>\n  );\n}\n\nfunction AudioTrackMenuItemSettingProvider({ children }: { children: ReactNode }): ReactNode {\n  const audioTrack = useAudioTrackOptions();\n  if (!audioTrack) return children;\n\n  const { state, options, value } = audioTrack;\n  const label = options.find((option) => option.value === value)?.label ?? '';\n\n  return (\n    <MenuItemSettingContextProvider value={{ type: 'audio-track', label, availability: state.availability }}>\n      {children}\n    </MenuItemSettingContextProvider>\n  );\n}\n\nexport function MenuItemSettingProvider({ type, children }: MenuItemSettingProviderProps): ReactNode {\n  if (type === 'playback-rate')\n    return <PlaybackRateMenuItemSettingProvider>{children}</PlaybackRateMenuItemSettingProvider>;\n  if (type === 'quality') return <QualityMenuItemSettingProvider>{children}</QualityMenuItemSettingProvider>;\n  if (type === 'audio-track') return <AudioTrackMenuItemSettingProvider>{children}</AudioTrackMenuItemSettingProvider>;\n  if (type === 'captions') return <CaptionsMenuItemSettingProvider>{children}</CaptionsMenuItemSettingProvider>;\n  return children;\n}\n"],"mappings":";;;;;;;;;AAiBA,SAAS,oCAAoC,EAAE,YAAgD;CAC7F,MAAM,eAAe,wBAAwB;AAC7C,KAAI,CAAC,aAAc,QAAO;CAE1B,MAAM,EAAE,OAAO,SAAS,UAAU;AAGlC,QACE,oBAAC,gCAAD;EAAgC,OAAO;GAAE,MAAM;GAAiB,OAHpD,QAAQ,MAAM,WAAW,OAAO,UAAU,MAAM,EAAE,SAAS;GAGA,cAAc,MAAM;GAAc;EACtG;EAC8B,CAAA;;AAIrC,SAAS,gCAAgC,EAAE,YAAgD;CACzF,MAAM,WAAW,oBAAoB;AACrC,KAAI,CAAC,SAAU,QAAO;CAEtB,MAAM,EAAE,OAAO,SAAS,UAAU;AAIlC,QACE,oBAAC,gCAAD;EAAgC,OAAO;GAAE,MAAM;GAAY,OAH3D,UAAU,qBAAqB,QAAS,QAAQ,MAAM,WAAW,OAAO,UAAU,MAAM,EAAE,SAAS;GAGjC,cAAc,MAAM;GAAc;EACjG;EAC8B,CAAA;;AAIrC,SAAS,+BAA+B,EAAE,YAAgD;CACxF,MAAM,UAAU,mBAAmB;AACnC,KAAI,CAAC,QAAS,QAAO;CAErB,MAAM,EAAE,OAAO,SAAS,UAAU;AAGlC,QACE,oBAAC,gCAAD;EAAgC,OAAO;GAAE,MAAM;GAAW,OAH9C,QAAQ,MAAM,WAAW,OAAO,UAAU,MAAM,EAAE,SAAS;GAGN,cAAc,MAAM;GAAc;EAChG;EAC8B,CAAA;;AAIrC,SAAS,kCAAkC,EAAE,YAAgD;CAC3F,MAAM,aAAa,sBAAsB;AACzC,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,EAAE,OAAO,SAAS,UAAU;AAGlC,QACE,oBAAC,gCAAD;EAAgC,OAAO;GAAE,MAAM;GAAe,OAHlD,QAAQ,MAAM,WAAW,OAAO,UAAU,MAAM,EAAE,SAAS;GAGF,cAAc,MAAM;GAAc;EACpG;EAC8B,CAAA;;AAIrC,SAAgB,wBAAwB,EAAE,MAAM,YAAqD;AACnG,KAAI,SAAS,gBACX,QAAO,oBAAC,qCAAD,EAAsC,UAA+C,CAAA;AAC9F,KAAI,SAAS,UAAW,QAAO,oBAAC,gCAAD,EAAiC,UAA0C,CAAA;AAC1G,KAAI,SAAS,cAAe,QAAO,oBAAC,mCAAD,EAAoC,UAA6C,CAAA;AACpH,KAAI,SAAS,WAAY,QAAO,oBAAC,iCAAD,EAAkC,UAA2C,CAAA;AAC7G,QAAO"}

package/dist/dev/ui/menu/menu-item-type.d.ts

@@ -0,0 +1,5 @@
+//#region src/ui/menu/menu-item-type.d.ts
+type MenuItemSettingType = 'playback-rate' | 'quality' | 'audio-track' | 'captions';
+//#endregion
+export { MenuItemSettingType };
+//# sourceMappingURL=menu-item-type.d.ts.map

package/dist/dev/ui/menu/menu-item-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-type.d.ts","names":[],"sources":["../../../../src/ui/menu/menu-item-type.ts"],"mappings":";KAAY,mBAAA"}

package/dist/dev/ui/menu/menu-item-value.d.ts

@@ -0,0 +1,14 @@
+import { UIComponentProps } from "../../utils/types.js";
+import * as _$react from "react";
+import { MenuState } from "@videojs/core";
+
+//#region src/ui/menu/menu-item-value.d.ts
+interface MenuItemValueProps extends UIComponentProps<'span', MenuState> {}
+/** Displays the current value for a settings menu item from `Menu.Item` or `Menu.Trigger` context. */
+declare const MenuItemValue: _$react.ForwardRefExoticComponent<Omit<MenuItemValueProps, "ref"> & _$react.RefAttributes<HTMLSpanElement>>;
+declare namespace MenuItemValue {
+  type Props = MenuItemValueProps;
+}
+//#endregion
+export { MenuItemValue, MenuItemValueProps };
+//# sourceMappingURL=menu-item-value.d.ts.map

package/dist/dev/ui/menu/menu-item-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-value.d.ts","names":[],"sources":["../../../../src/ui/menu/menu-item-value.tsx"],"mappings":";;;;;UASiB,kBAAA,SAA2B,gBAAA,SAAyB,SAAA;;cAGxD,aAAA,EAAa,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,kBAAA,WAAA,OAAA,CAAA,aAAA,CAAA,eAAA;AAAA,kBAoBT,aAAA;EAAA,KACH,KAAA,GAAQ,kBAAA;AAAA"}