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

package/dist/default/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/default/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/default/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/default/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/default/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/default/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/default/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/default/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/default/ui/menu/menu-item-value.js

@@ -0,0 +1,28 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext, useOptionalMenuItemSettingContext } from "./context.js";
+import { forwardRef } from "react";
+//#region src/ui/menu/menu-item-value.tsx
+/** Displays the current value for a settings menu item from `Menu.Item` or `Menu.Trigger` context. */
+const MenuItemValue = forwardRef(function MenuItemValue({ render, className, style, ...elementProps }, forwardedRef) {
+	const { state, stateAttrMap } = useMenuContext();
+	const setting = useOptionalMenuItemSettingContext();
+	if (!setting) return null;
+	return renderElement("span", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		stateAttrMap,
+		ref: forwardedRef,
+		props: [{
+			"aria-live": "off",
+			children: setting.label
+		}, elementProps]
+	});
+});
+//#endregion
+export { MenuItemValue };
+
+//# sourceMappingURL=menu-item-value.js.map

package/dist/default/ui/menu/menu-item-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-value.js","names":[],"sources":["../../../../src/ui/menu/menu-item-value.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, useOptionalMenuItemSettingContext } from './context';\n\nexport interface MenuItemValueProps extends UIComponentProps<'span', MenuState> {}\n\n/** Displays the current value for a settings menu item from `Menu.Item` or `Menu.Trigger` context. */\nexport const MenuItemValue = forwardRef<HTMLSpanElement, MenuItemValueProps>(function MenuItemValue(\n  { render, className, style, ...elementProps },\n  forwardedRef\n) {\n  const { state, stateAttrMap } = useMenuContext();\n  const setting = useOptionalMenuItemSettingContext();\n  if (!setting) return null;\n\n  return renderElement(\n    'span',\n    { render, className, style },\n    {\n      state,\n      stateAttrMap,\n      ref: forwardedRef,\n      props: [{ 'aria-live': 'off' as const, children: setting.label }, elementProps],\n    }\n  );\n});\n\nexport namespace MenuItemValue {\n  export type Props = MenuItemValueProps;\n}\n"],"mappings":";;;;;;AAYA,MAAa,gBAAgB,WAAgD,SAAS,cACpF,EAAE,QAAQ,WAAW,OAAO,GAAG,gBAC/B,cACA;CACA,MAAM,EAAE,OAAO,iBAAiB,gBAAgB;CAChD,MAAM,UAAU,mCAAmC;AACnD,KAAI,CAAC,QAAS,QAAO;AAErB,QAAO,cACL,QACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA;EACA,KAAK;EACL,OAAO,CAAC;GAAE,aAAa;GAAgB,UAAU,QAAQ;GAAO,EAAE,aAAa;EAChF,CACF;EACD"}

package/dist/default/ui/menu/menu-item.js

@@ -0,0 +1,74 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext, useOptionalMenuItemSettingContext, useSubMenuContext } from "./context.js";
+import { MenuItemSettingProvider } from "./menu-item-setting-provider.js";
+import { completeMenuItemSelection } from "@videojs/core/dom";
+import { forwardRef, useCallback, useEffect, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/ui/menu/menu-item.tsx
+/** A single action in the menu. Renders a `<div>` with `role="menuitem"`. */
+const MenuItem = forwardRef(function MenuItem({ render, className, style, onSelect, disabled, type, onClick, ...elementProps }, forwardedRef) {
+	const { menu, state } = useMenuContext();
+	const parentMenu = useSubMenuContext()?.parentMenu.menu ?? null;
+	const elementRef = useRef(null);
+	useEffect(() => {
+		const element = elementRef.current;
+		if (!element) return;
+		return menu.registerItem(element);
+	}, [menu]);
+	const item = /* @__PURE__ */ jsx(MenuItemContent, {
+		disabled,
+		elementProps,
+		onClick: useCallback((event) => {
+			if (disabled) return;
+			onClick?.(event);
+			onSelect?.();
+			completeMenuItemSelection(menu, parentMenu);
+		}, [
+			disabled,
+			onClick,
+			onSelect,
+			menu,
+			parentMenu
+		]),
+		onPointerEnter: useCallback(() => {
+			const element = elementRef.current;
+			if (!element || disabled) return;
+			menu.highlight(element, { focus: false });
+		}, [menu, disabled]),
+		render,
+		className,
+		style,
+		state,
+		forwardedRef,
+		elementRef
+	});
+	if (!type) return item;
+	return /* @__PURE__ */ jsx(MenuItemSettingProvider, {
+		type,
+		children: item
+	});
+});
+function MenuItemContent({ disabled, elementProps, onClick, onPointerEnter, render, className, style, state, forwardedRef, elementRef }) {
+	const setting = useOptionalMenuItemSettingContext();
+	const settingAttrs = setting ? { "data-availability": setting.availability } : void 0;
+	return renderElement("div", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		ref: [forwardedRef, elementRef],
+		props: [{
+			role: "menuitem",
+			"aria-disabled": disabled ? true : void 0,
+			onClick,
+			onPointerEnter,
+			...settingAttrs
+		}, elementProps]
+	});
+}
+//#endregion
+export { MenuItem };
+
+//# sourceMappingURL=menu-item.js.map

package/dist/default/ui/menu/menu-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item.js","names":[],"sources":["../../../../src/ui/menu/menu-item.tsx"],"sourcesContent":["'use client';\n\nimport type { MenuState } from '@videojs/core';\nimport { completeMenuItemSelection } from '@videojs/core/dom';\nimport { forwardRef, useCallback, useEffect, useRef } from 'react';\n\nimport type { UIComponentProps } from '../../utils/types';\nimport { renderElement } from '../../utils/use-render';\nimport { useMenuContext, useOptionalMenuItemSettingContext, useSubMenuContext } from './context';\nimport { MenuItemSettingProvider } from './menu-item-setting-provider';\nimport type { MenuItemSettingType } from './menu-item-type';\n\nexport interface MenuItemProps extends UIComponentProps<'div', MenuState> {\n  /** Called when the item is selected. */\n  onSelect?: () => void;\n  /** Whether the item is disabled. */\n  disabled?: boolean;\n  /** Setting kind for submenu triggers (`playback-rate`, `quality`, `audio-track`, or `captions`). */\n  type?: MenuItemSettingType | undefined;\n}\n\n/** A single action in the menu. Renders a `<div>` with `role=\"menuitem\"`. */\nexport const MenuItem = forwardRef<HTMLDivElement, MenuItemProps>(function MenuItem(\n  { render, className, style, onSelect, disabled, type, onClick, ...elementProps },\n  forwardedRef\n) {\n  const { menu, state } = useMenuContext();\n  const subMenuCtx = useSubMenuContext();\n  const parentMenu = subMenuCtx?.parentMenu.menu ?? null;\n  const elementRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const element = elementRef.current;\n    if (!element) return;\n    return menu.registerItem(element);\n  }, [menu]);\n\n  const handleClick = useCallback(\n    (event: React.MouseEvent<HTMLDivElement>) => {\n      if (disabled) return;\n      onClick?.(event);\n      onSelect?.();\n      completeMenuItemSelection(menu, parentMenu);\n    },\n    [disabled, onClick, onSelect, menu, parentMenu]\n  );\n\n  const handlePointerEnter = useCallback(() => {\n    const element = elementRef.current;\n    if (!element || disabled) return;\n    menu.highlight(element, { focus: false });\n  }, [menu, disabled]);\n\n  const item = (\n    <MenuItemContent\n      disabled={disabled}\n      elementProps={elementProps}\n      onClick={handleClick}\n      onPointerEnter={handlePointerEnter}\n      render={render}\n      className={className}\n      style={style}\n      state={state}\n      forwardedRef={forwardedRef}\n      elementRef={elementRef}\n    />\n  );\n\n  if (!type) return item;\n\n  return <MenuItemSettingProvider type={type}>{item}</MenuItemSettingProvider>;\n});\n\ninterface MenuItemContentProps {\n  disabled: boolean | undefined;\n  elementProps: Record<string, unknown>;\n  onClick: (event: React.MouseEvent<HTMLDivElement>) => void;\n  onPointerEnter: () => void;\n  render: MenuItemProps['render'];\n  className: MenuItemProps['className'];\n  style: MenuItemProps['style'];\n  state: MenuState;\n  forwardedRef: React.ForwardedRef<HTMLDivElement>;\n  elementRef: React.RefObject<HTMLDivElement | null>;\n}\n\nfunction MenuItemContent({\n  disabled,\n  elementProps,\n  onClick,\n  onPointerEnter,\n  render,\n  className,\n  style,\n  state,\n  forwardedRef,\n  elementRef,\n}: MenuItemContentProps) {\n  const setting = useOptionalMenuItemSettingContext();\n  const settingAttrs = setting ? { 'data-availability': setting.availability } : undefined;\n\n  return renderElement(\n    'div',\n    { render, className, style },\n    {\n      state,\n      ref: [forwardedRef, elementRef],\n      props: [\n        {\n          role: 'menuitem' as const,\n          'aria-disabled': disabled ? true : undefined,\n          onClick,\n          onPointerEnter,\n          ...settingAttrs,\n        },\n        elementProps,\n      ],\n    }\n  );\n}\n\nexport namespace MenuItem {\n  export type Props = MenuItemProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;;;;AAsBA,MAAa,WAAW,WAA0C,SAAS,SACzE,EAAE,QAAQ,WAAW,OAAO,UAAU,UAAU,MAAM,SAAS,GAAG,gBAClE,cACA;CACA,MAAM,EAAE,MAAM,UAAU,gBAAgB;CAExC,MAAM,aADa,mBAAmB,EACP,WAAW,QAAQ;CAClD,MAAM,aAAa,OAAuB,KAAK;AAE/C,iBAAgB;EACd,MAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS;AACd,SAAO,KAAK,aAAa,QAAQ;IAChC,CAAC,KAAK,CAAC;CAkBV,MAAM,OACJ,oBAAC,iBAAD;EACY;EACI;EACd,SApBgB,aACjB,UAA4C;AAC3C,OAAI,SAAU;AACd,aAAU,MAAM;AAChB,eAAY;AACZ,6BAA0B,MAAM,WAAW;KAE7C;GAAC;GAAU;GAAS;GAAU;GAAM;GAAW,CAChD;EAaG,gBAXuB,kBAAkB;GAC3C,MAAM,UAAU,WAAW;AAC3B,OAAI,CAAC,WAAW,SAAU;AAC1B,QAAK,UAAU,SAAS,EAAE,OAAO,OAAO,CAAC;KACxC,CAAC,MAAM,SAAS,CAAC;EAQR;EACG;EACJ;EACA;EACO;EACF;EACZ,CAAA;AAGJ,KAAI,CAAC,KAAM,QAAO;AAElB,QAAO,oBAAC,yBAAD;EAA+B;YAAO;EAA+B,CAAA;EAC5E;AAeF,SAAS,gBAAgB,EACvB,UACA,cACA,SACA,gBACA,QACA,WACA,OACA,OACA,cACA,cACuB;CACvB,MAAM,UAAU,mCAAmC;CACnD,MAAM,eAAe,UAAU,EAAE,qBAAqB,QAAQ,cAAc,GAAG,KAAA;AAE/E,QAAO,cACL,OACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA,KAAK,CAAC,cAAc,WAAW;EAC/B,OAAO,CACL;GACE,MAAM;GACN,iBAAiB,WAAW,OAAO,KAAA;GACnC;GACA;GACA,GAAG;GACJ,EACD,aACD;EACF,CACF"}

package/dist/default/ui/menu/menu-radio-group.js

@@ -0,0 +1,30 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { MenuRadioGroupContextProvider, 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-radio-group.tsx
+/** A group of mutually exclusive radio items. Renders a `<div>` with `role="group"`. */
+const MenuRadioGroup = forwardRef(function MenuRadioGroup({ render, className, style, value, onValueChange, ...elementProps }, forwardedRef) {
+	const { state } = useMenuContext();
+	return /* @__PURE__ */ jsx(MenuGroupProvider, { children: (labelId) => /* @__PURE__ */ jsx(MenuRadioGroupContextProvider, {
+		value: {
+			value,
+			onValueChange
+		},
+		children: renderElement("div", {
+			render,
+			className,
+			style
+		}, {
+			state,
+			ref: [forwardedRef],
+			props: [getMenuGroupProps(labelId, elementProps), elementProps]
+		})
+	}) });
+});
+//#endregion
+export { MenuRadioGroup };
+
+//# sourceMappingURL=menu-radio-group.js.map

package/dist/default/ui/menu/menu-radio-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-radio-group.js","names":[],"sources":["../../../../src/ui/menu/menu-radio-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 { MenuRadioGroupContextProvider, useMenuContext } from './context';\nimport { getMenuGroupProps, MenuGroupProvider } from './use-menu-group';\n\nexport interface MenuRadioGroupProps extends UIComponentProps<'div', MenuState> {\n  /** The currently selected value. */\n  value: string;\n  /** Called when the user selects a radio item. */\n  onValueChange: (value: string) => void;\n}\n\n/** A group of mutually exclusive radio items. Renders a `<div>` with `role=\"group\"`. */\nexport const MenuRadioGroup = forwardRef<HTMLDivElement, MenuRadioGroupProps>(function MenuRadioGroup(\n  { render, className, style, value, onValueChange, ...elementProps },\n  forwardedRef\n) {\n  const { state } = useMenuContext();\n\n  return (\n    <MenuGroupProvider>\n      {(labelId) => (\n        <MenuRadioGroupContextProvider value={{ value, onValueChange }}>\n          {renderElement(\n            'div',\n            { render, className, style },\n            {\n              state,\n              ref: [forwardedRef],\n              props: [getMenuGroupProps(labelId, elementProps), elementProps],\n            }\n          )}\n        </MenuRadioGroupContextProvider>\n      )}\n    </MenuGroupProvider>\n  );\n});\n\nexport namespace MenuRadioGroup {\n  export type Props = MenuRadioGroupProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;;;AAkBA,MAAa,iBAAiB,WAAgD,SAAS,eACrF,EAAE,QAAQ,WAAW,OAAO,OAAO,eAAe,GAAG,gBACrD,cACA;CACA,MAAM,EAAE,UAAU,gBAAgB;AAElC,QACE,oBAAC,mBAAD,EAAA,WACI,YACA,oBAAC,+BAAD;EAA+B,OAAO;GAAE;GAAO;GAAe;YAC3D,cACC,OACA;GAAE;GAAQ;GAAW;GAAO,EAC5B;GACE;GACA,KAAK,CAAC,aAAa;GACnB,OAAO,CAAC,kBAAkB,SAAS,aAAa,EAAE,aAAa;GAChE,CACF;EAC6B,CAAA,EAEhB,CAAA;EAEtB"}

package/dist/default/ui/menu/menu-radio-item.js

@@ -0,0 +1,56 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext, useMenuRadioGroupContext, useSubMenuContext } from "./context.js";
+import { completeMenuItemSelection } from "@videojs/core/dom";
+import { forwardRef, useCallback, useEffect, useRef } from "react";
+//#region src/ui/menu/menu-radio-item.tsx
+/** A radio-style menu item. Renders a `<div>` with `role="menuitemradio"`. */
+const MenuRadioItem = forwardRef(function MenuRadioItem({ render, className, style, value, disabled, onClick, ...elementProps }, forwardedRef) {
+	const { menu, state } = useMenuContext();
+	const { value: groupValue, onValueChange } = useMenuRadioGroupContext();
+	const parentMenu = useSubMenuContext()?.parentMenu.menu ?? null;
+	const elementRef = useRef(null);
+	const checked = groupValue === value;
+	useEffect(() => {
+		const element = elementRef.current;
+		if (!element) return;
+		return menu.registerItem(element);
+	}, [menu]);
+	const handleClick = useCallback((event) => {
+		if (disabled) return;
+		onClick?.(event);
+		onValueChange(value);
+		completeMenuItemSelection(menu, parentMenu);
+	}, [
+		disabled,
+		onClick,
+		onValueChange,
+		value,
+		menu,
+		parentMenu
+	]);
+	const handlePointerEnter = useCallback(() => {
+		const element = elementRef.current;
+		if (!element || disabled) return;
+		menu.highlight(element, { focus: false });
+	}, [menu, disabled]);
+	return renderElement("div", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		ref: [forwardedRef, elementRef],
+		props: [{
+			role: "menuitemradio",
+			"aria-checked": checked,
+			"aria-disabled": disabled ? true : void 0,
+			onClick: handleClick,
+			onPointerEnter: handlePointerEnter
+		}, elementProps]
+	});
+});
+//#endregion
+export { MenuRadioItem };
+
+//# sourceMappingURL=menu-radio-item.js.map

package/dist/default/ui/menu/menu-radio-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-radio-item.js","names":[],"sources":["../../../../src/ui/menu/menu-radio-item.tsx"],"sourcesContent":["'use client';\n\nimport type { MenuState } from '@videojs/core';\nimport { completeMenuItemSelection } from '@videojs/core/dom';\nimport { forwardRef, useCallback, useEffect, useRef } from 'react';\n\nimport type { UIComponentProps } from '../../utils/types';\nimport { renderElement } from '../../utils/use-render';\nimport { useMenuContext, useMenuRadioGroupContext, useSubMenuContext } from './context';\n\nexport interface MenuRadioItemProps extends UIComponentProps<'div', MenuState> {\n  /** The value this item represents. */\n  value: string;\n  /** Whether the item is disabled. */\n  disabled?: boolean;\n}\n\n/** A radio-style menu item. Renders a `<div>` with `role=\"menuitemradio\"`. */\nexport const MenuRadioItem = forwardRef<HTMLDivElement, MenuRadioItemProps>(function MenuRadioItem(\n  { render, className, style, value, disabled, onClick, ...elementProps },\n  forwardedRef\n) {\n  const { menu, state } = useMenuContext();\n  const { value: groupValue, onValueChange } = useMenuRadioGroupContext();\n  const subMenuCtx = useSubMenuContext();\n  const parentMenu = subMenuCtx?.parentMenu.menu ?? null;\n  const elementRef = useRef<HTMLDivElement>(null);\n  const checked = groupValue === value;\n\n  useEffect(() => {\n    const element = elementRef.current;\n    if (!element) return;\n    return menu.registerItem(element);\n  }, [menu]);\n\n  const handleClick = useCallback(\n    (event: React.MouseEvent<HTMLDivElement>) => {\n      if (disabled) return;\n      onClick?.(event);\n      onValueChange(value);\n      completeMenuItemSelection(menu, parentMenu);\n    },\n    [disabled, onClick, onValueChange, value, menu, parentMenu]\n  );\n\n  const handlePointerEnter = useCallback(() => {\n    const element = elementRef.current;\n    if (!element || disabled) return;\n    menu.highlight(element, { focus: false });\n  }, [menu, disabled]);\n\n  return renderElement(\n    'div',\n    { render, className, style },\n    {\n      state,\n      ref: [forwardedRef, elementRef],\n      props: [\n        {\n          role: 'menuitemradio' as const,\n          'aria-checked': checked,\n          'aria-disabled': disabled ? true : undefined,\n          onClick: handleClick,\n          onPointerEnter: handlePointerEnter,\n        },\n        elementProps,\n      ],\n    }\n  );\n});\n\nexport namespace MenuRadioItem {\n  export type Props = MenuRadioItemProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;;AAkBA,MAAa,gBAAgB,WAA+C,SAAS,cACnF,EAAE,QAAQ,WAAW,OAAO,OAAO,UAAU,SAAS,GAAG,gBACzD,cACA;CACA,MAAM,EAAE,MAAM,UAAU,gBAAgB;CACxC,MAAM,EAAE,OAAO,YAAY,kBAAkB,0BAA0B;CAEvE,MAAM,aADa,mBAAmB,EACP,WAAW,QAAQ;CAClD,MAAM,aAAa,OAAuB,KAAK;CAC/C,MAAM,UAAU,eAAe;AAE/B,iBAAgB;EACd,MAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS;AACd,SAAO,KAAK,aAAa,QAAQ;IAChC,CAAC,KAAK,CAAC;CAEV,MAAM,cAAc,aACjB,UAA4C;AAC3C,MAAI,SAAU;AACd,YAAU,MAAM;AAChB,gBAAc,MAAM;AACpB,4BAA0B,MAAM,WAAW;IAE7C;EAAC;EAAU;EAAS;EAAe;EAAO;EAAM;EAAW,CAC5D;CAED,MAAM,qBAAqB,kBAAkB;EAC3C,MAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,WAAW,SAAU;AAC1B,OAAK,UAAU,SAAS,EAAE,OAAO,OAAO,CAAC;IACxC,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAO,cACL,OACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA,KAAK,CAAC,cAAc,WAAW;EAC/B,OAAO,CACL;GACE,MAAM;GACN,gBAAgB;GAChB,iBAAiB,WAAW,OAAO,KAAA;GACnC,SAAS;GACT,gBAAgB;GACjB,EACD,aACD;EACF,CACF;EACD"}

package/dist/default/ui/menu/menu-root.js

@@ -0,0 +1,136 @@
+"use client";
+import { useOptionalContainer, useOptionalPopupGroup } from "../../player/context.js";
+import { useLatestRef } from "../../utils/use-latest-ref.js";
+import { useDestroy } from "../../utils/use-destroy.js";
+import { MenuContextProvider, SubMenuContextProvider, useOptionalMenuContext } from "./context.js";
+import { useSafeId } from "../../utils/use-safe-id.js";
+import { useOptionalControlsContext } from "../controls/context.js";
+import { createMenu, createTransition } from "@videojs/core/dom";
+import { useSnapshot } from "@videojs/store/react";
+import { useEffect, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+import { MenuCore, MenuDataAttrs } from "@videojs/core";
+//#region src/ui/menu/menu-root.tsx
+function MenuRoot({ open: controlledOpen, defaultOpen = MenuCore.defaultProps.defaultOpen, onOpenChange: onOpenChangeProp, onOpenChangeComplete: onOpenChangeCompleteProp, boundary = "container", children, ...coreProps }) {
+	const parentMenu = useOptionalMenuContext();
+	const controls = useOptionalControlsContext();
+	const container = useOptionalContainer();
+	const popupGroup = useOptionalPopupGroup();
+	const isSubmenu = parentMenu !== null;
+	const { side, align, closeOnEscape, closeOnOutsideClick } = coreProps;
+	const [core] = useState(() => new MenuCore({
+		...coreProps,
+		isSubmenu
+	}));
+	const isControlled = controlledOpen !== void 0;
+	const onOpenChangeRef = useLatestRef(onOpenChangeProp);
+	const onOpenChangeCompleteRef = useLatestRef(onOpenChangeCompleteProp);
+	const closeOnEscapeRef = useLatestRef(closeOnEscape);
+	const closeOnOutsideClickRef = useLatestRef(closeOnOutsideClick);
+	const popupGroupRef = useLatestRef(popupGroup);
+	const isSubmenuRef = useLatestRef(isSubmenu);
+	const [menu] = useState(() => {
+		const instance = createMenu({
+			transition: createTransition(),
+			onOpenChange(nextOpen, details) {
+				onOpenChangeRef.current?.(nextOpen, details);
+			},
+			onOpenChangeComplete(nextOpen) {
+				onOpenChangeCompleteRef.current?.(nextOpen);
+			},
+			closeOnEscape: () => closeOnEscapeRef.current ?? MenuCore.defaultProps.closeOnEscape,
+			closeOnOutsideClick: () => closeOnOutsideClickRef.current ?? MenuCore.defaultProps.closeOnOutsideClick,
+			group: () => isSubmenuRef.current ? void 0 : popupGroupRef.current
+		});
+		if (!isControlled && defaultOpen) instance.open();
+		return instance;
+	});
+	const anchorName = useSafeId();
+	const contentId = useSafeId("menu");
+	useEffect(() => {
+		if (controlledOpen === void 0) return;
+		const { active: inputOpen } = menu.input.current;
+		if (controlledOpen === inputOpen) return;
+		if (controlledOpen) menu.open("click");
+		else menu.close("click");
+	}, [controlledOpen, menu]);
+	useEffect(() => {
+		if (isSubmenu || controls?.state.visible !== false) return;
+		menu.close("imperative-action");
+	}, [
+		controls?.state.visible,
+		isSubmenu,
+		menu
+	]);
+	useDestroy(menu);
+	const input = useSnapshot(menu.input);
+	const state = useMemo(() => {
+		core.setProps({
+			side,
+			align,
+			closeOnEscape,
+			closeOnOutsideClick,
+			isSubmenu
+		});
+		core.setInput(input);
+		return core.getState();
+	}, [
+		core,
+		input,
+		side,
+		align,
+		closeOnEscape,
+		closeOnOutsideClick,
+		isSubmenu
+	]);
+	const navigationInput = useSnapshot(menu.navigationInput);
+	const topEntry = navigationInput.stack[navigationInput.stack.length - 1];
+	const activeSubMenuId = topEntry?.menuId ?? null;
+	const activeSubMenuTriggerId = topEntry?.triggerId ?? null;
+	const navigationDirection = navigationInput.direction;
+	const contextValue = useMemo(() => ({
+		core,
+		menu,
+		state,
+		stateAttrMap: MenuDataAttrs,
+		contentId,
+		anchorName,
+		boundary,
+		container,
+		activeSubMenuId,
+		activeSubMenuTriggerId,
+		navigationDirection,
+		push: menu.push,
+		pop: menu.pop
+	}), [
+		core,
+		menu,
+		state,
+		contentId,
+		anchorName,
+		boundary,
+		container,
+		activeSubMenuId,
+		activeSubMenuTriggerId,
+		navigationDirection
+	]);
+	const subMenuContextValue = useMemo(() => parentMenu ? {
+		subMenuId: contentId,
+		parentMenu
+	} : null, [contentId, parentMenu]);
+	if (subMenuContextValue) return /* @__PURE__ */ jsx(MenuContextProvider, {
+		value: contextValue,
+		children: /* @__PURE__ */ jsx(SubMenuContextProvider, {
+			value: subMenuContextValue,
+			children
+		})
+	});
+	return /* @__PURE__ */ jsx(MenuContextProvider, {
+		value: contextValue,
+		children
+	});
+}
+//#endregion
+export { MenuRoot };
+
+//# sourceMappingURL=menu-root.js.map

package/dist/default/ui/menu/menu-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-root.js","names":[],"sources":["../../../../src/ui/menu/menu-root.tsx"],"sourcesContent":["'use client';\n\nimport { MenuCore, MenuDataAttrs } from '@videojs/core';\nimport { createMenu, createTransition, type MenuChangeDetails, type PositioningBoundary } from '@videojs/core/dom';\nimport { useSnapshot } from '@videojs/store/react';\nimport type { ReactNode } from 'react';\nimport { useEffect, useMemo, useState } from 'react';\nimport { useOptionalContainer, useOptionalPopupGroup } from '../../player/context';\nimport { useDestroy } from '../../utils/use-destroy';\nimport { useLatestRef } from '../../utils/use-latest-ref';\nimport { useSafeId } from '../../utils/use-safe-id';\nimport { useOptionalControlsContext } from '../controls/context';\nimport { MenuContextProvider, SubMenuContextProvider, useOptionalMenuContext } from './context';\n\nexport interface MenuRootProps extends MenuCore.Props {\n  /** Boundary used to constrain the root menu popup size. */\n  boundary?: PositioningBoundary;\n  /** Called when the menu open state changes (fires immediately, before animations). */\n  onOpenChange?: (open: boolean, details: MenuChangeDetails) => void;\n  /** Called after open/close animations complete. */\n  onOpenChangeComplete?: (open: boolean) => void;\n  children?: ReactNode;\n}\n\nexport function MenuRoot({\n  open: controlledOpen,\n  defaultOpen = MenuCore.defaultProps.defaultOpen,\n  onOpenChange: onOpenChangeProp,\n  onOpenChangeComplete: onOpenChangeCompleteProp,\n  boundary = 'container',\n  children,\n  ...coreProps\n}: MenuRootProps): ReactNode {\n  // Detect if we are nested inside a parent Menu.Content — if so, operate as\n  // a submenu: no popover positioning, Trigger acts as a parent item.\n  const parentMenu = useOptionalMenuContext();\n  const controls = useOptionalControlsContext();\n  const container = useOptionalContainer();\n  const popupGroup = useOptionalPopupGroup();\n  const isSubmenu = parentMenu !== null;\n  const { side, align, closeOnEscape, closeOnOutsideClick } = coreProps;\n\n  const [core] = useState(() => new MenuCore({ ...coreProps, isSubmenu }));\n\n  const isControlled = controlledOpen !== undefined;\n\n  const onOpenChangeRef = useLatestRef(onOpenChangeProp);\n  const onOpenChangeCompleteRef = useLatestRef(onOpenChangeCompleteProp);\n  const closeOnEscapeRef = useLatestRef(closeOnEscape);\n  const closeOnOutsideClickRef = useLatestRef(closeOnOutsideClick);\n  const popupGroupRef = useLatestRef(popupGroup);\n  const isSubmenuRef = useLatestRef(isSubmenu);\n\n  const [menu] = useState(() => {\n    const instance = createMenu({\n      transition: createTransition(),\n      onOpenChange(nextOpen, details) {\n        onOpenChangeRef.current?.(nextOpen, details);\n      },\n      onOpenChangeComplete(nextOpen) {\n        onOpenChangeCompleteRef.current?.(nextOpen);\n      },\n      closeOnEscape: () => closeOnEscapeRef.current ?? MenuCore.defaultProps.closeOnEscape,\n      closeOnOutsideClick: () => closeOnOutsideClickRef.current ?? MenuCore.defaultProps.closeOnOutsideClick,\n      group: () => (isSubmenuRef.current ? undefined : popupGroupRef.current),\n    });\n\n    if (!isControlled && defaultOpen) {\n      instance.open();\n    }\n\n    return instance;\n  });\n\n  const anchorName = useSafeId();\n  const contentId = useSafeId('menu');\n\n  // Sync controlled open prop → internal state.\n  useEffect(() => {\n    if (controlledOpen === undefined) return;\n\n    const { active: inputOpen } = menu.input.current;\n    if (controlledOpen === inputOpen) return;\n\n    if (controlledOpen) {\n      menu.open('click');\n    } else {\n      menu.close('click');\n    }\n  }, [controlledOpen, menu]);\n\n  useEffect(() => {\n    if (isSubmenu || controls?.state.visible !== false) return;\n\n    menu.close('imperative-action');\n  }, [controls?.state.visible, isSubmenu, menu]);\n\n  useDestroy(menu);\n\n  const input = useSnapshot(menu.input);\n  const state = useMemo(() => {\n    core.setProps({ side, align, closeOnEscape, closeOnOutsideClick, isSubmenu });\n    core.setInput(input);\n    return core.getState();\n  }, [core, input, side, align, closeOnEscape, closeOnOutsideClick, isSubmenu]);\n\n  // Subscribe to navigation state — used by Content/Trigger when this is a root menu.\n  const navigationInput = useSnapshot(menu.navigationInput);\n  const topEntry = navigationInput.stack[navigationInput.stack.length - 1];\n  const activeSubMenuId = topEntry?.menuId ?? null;\n  const activeSubMenuTriggerId = topEntry?.triggerId ?? null;\n  const navigationDirection = navigationInput.direction;\n\n  const contextValue = useMemo(\n    () => ({\n      core,\n      menu,\n      state,\n      stateAttrMap: MenuDataAttrs,\n      contentId,\n      anchorName,\n      boundary,\n      container,\n      activeSubMenuId,\n      activeSubMenuTriggerId,\n      navigationDirection,\n      push: menu.push,\n      pop: menu.pop,\n    }),\n    [\n      core,\n      menu,\n      state,\n      contentId,\n      anchorName,\n      boundary,\n      container,\n      activeSubMenuId,\n      activeSubMenuTriggerId,\n      navigationDirection,\n    ]\n  );\n\n  const subMenuContextValue = useMemo(\n    () => (parentMenu ? { subMenuId: contentId, parentMenu } : null),\n    [contentId, parentMenu]\n  );\n\n  // When acting as a submenu, expose its content ID and the parent menu context\n  // through SubMenuContext so Trigger can register/push and Content can show/hide.\n  if (subMenuContextValue) {\n    return (\n      <MenuContextProvider value={contextValue}>\n        <SubMenuContextProvider value={subMenuContextValue}>{children}</SubMenuContextProvider>\n      </MenuContextProvider>\n    );\n  }\n\n  return <MenuContextProvider value={contextValue}>{children}</MenuContextProvider>;\n}\n\nexport namespace MenuRoot {\n  export type Props = MenuRootProps;\n}\n"],"mappings":";;;;;;;;;;;;;AAwBA,SAAgB,SAAS,EACvB,MAAM,gBACN,cAAc,SAAS,aAAa,aACpC,cAAc,kBACd,sBAAsB,0BACtB,WAAW,aACX,UACA,GAAG,aACwB;CAG3B,MAAM,aAAa,wBAAwB;CAC3C,MAAM,WAAW,4BAA4B;CAC7C,MAAM,YAAY,sBAAsB;CACxC,MAAM,aAAa,uBAAuB;CAC1C,MAAM,YAAY,eAAe;CACjC,MAAM,EAAE,MAAM,OAAO,eAAe,wBAAwB;CAE5D,MAAM,CAAC,QAAQ,eAAe,IAAI,SAAS;EAAE,GAAG;EAAW;EAAW,CAAC,CAAC;CAExE,MAAM,eAAe,mBAAmB,KAAA;CAExC,MAAM,kBAAkB,aAAa,iBAAiB;CACtD,MAAM,0BAA0B,aAAa,yBAAyB;CACtE,MAAM,mBAAmB,aAAa,cAAc;CACpD,MAAM,yBAAyB,aAAa,oBAAoB;CAChE,MAAM,gBAAgB,aAAa,WAAW;CAC9C,MAAM,eAAe,aAAa,UAAU;CAE5C,MAAM,CAAC,QAAQ,eAAe;EAC5B,MAAM,WAAW,WAAW;GAC1B,YAAY,kBAAkB;GAC9B,aAAa,UAAU,SAAS;AAC9B,oBAAgB,UAAU,UAAU,QAAQ;;GAE9C,qBAAqB,UAAU;AAC7B,4BAAwB,UAAU,SAAS;;GAE7C,qBAAqB,iBAAiB,WAAW,SAAS,aAAa;GACvE,2BAA2B,uBAAuB,WAAW,SAAS,aAAa;GACnF,aAAc,aAAa,UAAU,KAAA,IAAY,cAAc;GAChE,CAAC;AAEF,MAAI,CAAC,gBAAgB,YACnB,UAAS,MAAM;AAGjB,SAAO;GACP;CAEF,MAAM,aAAa,WAAW;CAC9B,MAAM,YAAY,UAAU,OAAO;AAGnC,iBAAgB;AACd,MAAI,mBAAmB,KAAA,EAAW;EAElC,MAAM,EAAE,QAAQ,cAAc,KAAK,MAAM;AACzC,MAAI,mBAAmB,UAAW;AAElC,MAAI,eACF,MAAK,KAAK,QAAQ;MAElB,MAAK,MAAM,QAAQ;IAEpB,CAAC,gBAAgB,KAAK,CAAC;AAE1B,iBAAgB;AACd,MAAI,aAAa,UAAU,MAAM,YAAY,MAAO;AAEpD,OAAK,MAAM,oBAAoB;IAC9B;EAAC,UAAU,MAAM;EAAS;EAAW;EAAK,CAAC;AAE9C,YAAW,KAAK;CAEhB,MAAM,QAAQ,YAAY,KAAK,MAAM;CACrC,MAAM,QAAQ,cAAc;AAC1B,OAAK,SAAS;GAAE;GAAM;GAAO;GAAe;GAAqB;GAAW,CAAC;AAC7E,OAAK,SAAS,MAAM;AACpB,SAAO,KAAK,UAAU;IACrB;EAAC;EAAM;EAAO;EAAM;EAAO;EAAe;EAAqB;EAAU,CAAC;CAG7E,MAAM,kBAAkB,YAAY,KAAK,gBAAgB;CACzD,MAAM,WAAW,gBAAgB,MAAM,gBAAgB,MAAM,SAAS;CACtE,MAAM,kBAAkB,UAAU,UAAU;CAC5C,MAAM,yBAAyB,UAAU,aAAa;CACtD,MAAM,sBAAsB,gBAAgB;CAE5C,MAAM,eAAe,eACZ;EACL;EACA;EACA;EACA,cAAc;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM,KAAK;EACX,KAAK,KAAK;EACX,GACD;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF;CAED,MAAM,sBAAsB,cACnB,aAAa;EAAE,WAAW;EAAW;EAAY,GAAG,MAC3D,CAAC,WAAW,WAAW,CACxB;AAID,KAAI,oBACF,QACE,oBAAC,qBAAD;EAAqB,OAAO;YAC1B,oBAAC,wBAAD;GAAwB,OAAO;GAAsB;GAAkC,CAAA;EACnE,CAAA;AAI1B,QAAO,oBAAC,qBAAD;EAAqB,OAAO;EAAe;EAA+B,CAAA"}

package/dist/default/ui/menu/menu-separator.js

@@ -0,0 +1,22 @@
+"use client";
+import { renderElement } from "../../utils/use-render.js";
+import { useMenuContext } from "./context.js";
+import { forwardRef } from "react";
+//#region src/ui/menu/menu-separator.tsx
+/** Visual divider between groups of items. Renders a `<div>` with `role="separator"`. */
+const MenuSeparator = forwardRef(function MenuSeparator({ render, className, style, ...elementProps }, forwardedRef) {
+	const { state } = useMenuContext();
+	return renderElement("div", {
+		render,
+		className,
+		style
+	}, {
+		state,
+		ref: [forwardedRef],
+		props: [{ role: "separator" }, elementProps]
+	});
+});
+//#endregion
+export { MenuSeparator };
+
+//# sourceMappingURL=menu-separator.js.map

package/dist/default/ui/menu/menu-separator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-separator.js","names":[],"sources":["../../../../src/ui/menu/menu-separator.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 MenuSeparatorProps extends UIComponentProps<'div', MenuState> {}\n\n/** Visual divider between groups of items. Renders a `<div>` with `role=\"separator\"`. */\nexport const MenuSeparator = forwardRef<HTMLDivElement, MenuSeparatorProps>(function MenuSeparator(\n  { render, className, style, ...elementProps },\n  forwardedRef\n) {\n  const { state } = useMenuContext();\n\n  return renderElement(\n    'div',\n    { render, className, style },\n    {\n      state,\n      ref: [forwardedRef],\n      props: [{ role: 'separator' as const }, elementProps],\n    }\n  );\n});\n\nexport namespace MenuSeparator {\n  export type Props = MenuSeparatorProps;\n  export type State = MenuState;\n}\n"],"mappings":";;;;;;AAYA,MAAa,gBAAgB,WAA+C,SAAS,cACnF,EAAE,QAAQ,WAAW,OAAO,GAAG,gBAC/B,cACA;CACA,MAAM,EAAE,UAAU,gBAAgB;AAElC,QAAO,cACL,OACA;EAAE;EAAQ;EAAW;EAAO,EAC5B;EACE;EACA,KAAK,CAAC,aAAa;EACnB,OAAO,CAAC,EAAE,MAAM,aAAsB,EAAE,aAAa;EACtD,CACF;EACD"}