@react-md/core 1.0.0-next.0

package/dist/menu/MenuConfigurationProvider.d.ts

@@ -0,0 +1,82 @@
+import { type ReactElement, type ReactNode } from "react";
+import { type SheetPosition, type SheetVerticalSize } from "../sheet/styles.js";
+/** @remarks \@since 5.0.0 */
+export interface MenuOrientationProps {
+    /**
+     * Boolean if the menu should be rendered horizontally instead of vertically.
+     * This will also update the `aria-orientation`.
+     *
+     * @defaultValue `false`
+     */
+    horizontal?: boolean;
+}
+/**
+ * This allows the menu to be conditionally rendered as a `Sheet` instead of a
+ * menu.
+ *
+ * - `false` - always render as a `Menu`
+ * - `true` - always render as a `Sheet`
+ * - `"phone"` - render as a sheet only when the {@link AppSize} is considered
+ *   phone (`isPhone === true`).
+ *
+ * @defaultValue `false`
+ * @remarks \@since 5.0.0
+ */
+export type RenderMenuAsSheet = boolean | "phone";
+/** @remarks \@since 5.0.0 */
+export interface MenuConfiguration extends MenuOrientationProps {
+    /** {@inheritDoc RenderMenuAsSheet} */
+    renderAsSheet?: RenderMenuAsSheet;
+    /**
+     * @see {@link SheetPosition}
+     * @defaultValue `"bottom"`
+     */
+    sheetPosition?: SheetPosition;
+    /**
+     * @see {@link SheetVerticalSize}
+     * @defaultValue `"touch"`
+     */
+    sheetVerticalSize?: SheetVerticalSize;
+    /**
+     * Any children to render above the sheet's menu implementation. This would
+     * normally be something like a `<DialogHeader>` or `AppBar`.
+     *
+     * @defaultValue `null`
+     */
+    sheetHeader?: ReactNode;
+    /**
+     * Any children to render below the sheet's menu implementation. This would
+     * normally be something like a `<DialogFooter>`.
+     *
+     * @defaultValue `null`
+     */
+    sheetFooter?: ReactNode;
+}
+/** @remarks \@since 5.0.0 */
+export type MenuConfigurationContext = Required<MenuConfiguration>;
+/** @remarks \@since 5.0.0 */
+export declare const DEFAULT_MENU_CONFIGURATION: Readonly<MenuConfiguration>;
+/**
+ * This is probably just an internal only hook that allows you to get the
+ * {@link MenuConfigurationContext} with optional overrides.
+ *
+ * @param overrides - An object of {@link MenuConfiguration} that would override
+ * the inherited context values if they are not `undefined`.
+ * @returns the {@link MenuConfigurationContext} with any overrides that were
+ * provided.
+ * @remarks \@since 5.0.0
+ */
+export declare function useMenuConfiguration(overrides?: MenuConfiguration): Readonly<MenuConfigurationContext>;
+/** @remarks \@since 5.0.0 */
+export interface MenuConfigurationProviderProps extends MenuConfiguration {
+    children: ReactNode;
+}
+/**
+ * **Client Component**
+ *
+ * Note: This will always merge values with any parent
+ * `MenuConfigurationProvider`s.
+ *
+ * @remarks \@since 5.0.0
+ */
+export declare function MenuConfigurationProvider(props: MenuConfigurationProviderProps): ReactElement;

package/dist/menu/MenuConfigurationProvider.js

@@ -0,0 +1,80 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+/** @remarks \@since 5.0.0 */ export const DEFAULT_MENU_CONFIGURATION = {
+    horizontal: false,
+    renderAsSheet: false,
+    sheetHeader: null,
+    sheetFooter: null,
+    sheetPosition: "bottom",
+    sheetVerticalSize: "touch"
+};
+/**
+ * @internal
+ * @remarks \@since 5.0.0
+ */ const context = /*#__PURE__*/ createContext({
+    horizontal: false,
+    renderAsSheet: false,
+    sheetHeader: null,
+    sheetFooter: null,
+    sheetPosition: "bottom",
+    sheetVerticalSize: "touch"
+});
+context.displayName = "MenuConfiguration";
+/**
+ * @internal
+ * @remarks \@since 5.0.0
+ */ const { Provider } = context;
+/**
+ * This is probably just an internal only hook that allows you to get the
+ * {@link MenuConfigurationContext} with optional overrides.
+ *
+ * @param overrides - An object of {@link MenuConfiguration} that would override
+ * the inherited context values if they are not `undefined`.
+ * @returns the {@link MenuConfigurationContext} with any overrides that were
+ * provided.
+ * @remarks \@since 5.0.0
+ */ export function useMenuConfiguration(overrides = {}) {
+    const { horizontal, renderAsSheet, sheetHeader, sheetFooter, sheetPosition, sheetVerticalSize } = overrides;
+    const inherited = useContext(context);
+    return {
+        horizontal: horizontal ?? inherited.horizontal,
+        renderAsSheet: renderAsSheet ?? inherited.renderAsSheet,
+        sheetHeader: sheetHeader === null ? null : sheetHeader ?? inherited.sheetHeader,
+        sheetFooter: sheetFooter === null ? null : sheetFooter ?? inherited.sheetFooter,
+        sheetPosition: sheetPosition ?? inherited.sheetPosition,
+        sheetVerticalSize: sheetVerticalSize ?? inherited.sheetVerticalSize
+    };
+}
+/**
+ * **Client Component**
+ *
+ * Note: This will always merge values with any parent
+ * `MenuConfigurationProvider`s.
+ *
+ * @remarks \@since 5.0.0
+ */ export function MenuConfigurationProvider(props) {
+    const { children, ...configuration } = props;
+    const { horizontal, renderAsSheet, sheetHeader, sheetFooter, sheetPosition, sheetVerticalSize } = useMenuConfiguration(configuration);
+    const value = useMemo(()=>({
+            horizontal,
+            renderAsSheet,
+            sheetHeader,
+            sheetFooter,
+            sheetPosition,
+            sheetVerticalSize
+        }), [
+        horizontal,
+        renderAsSheet,
+        sheetFooter,
+        sheetHeader,
+        sheetPosition,
+        sheetVerticalSize
+    ]);
+    return /*#__PURE__*/ _jsx(Provider, {
+        value: value,
+        children: children
+    });
+}
+
+//# sourceMappingURL=MenuConfigurationProvider.js.map

package/dist/menu/MenuConfigurationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/menu/MenuConfigurationProvider.tsx"],"sourcesContent":["\"use client\";\nimport {\n  createContext,\n  useContext,\n  useMemo,\n  type ReactElement,\n  type ReactNode,\n} from \"react\";\nimport { type SheetPosition, type SheetVerticalSize } from \"../sheet/styles.js\";\n\n/** @remarks \\@since 5.0.0 */\nexport interface MenuOrientationProps {\n  /**\n   * Boolean if the menu should be rendered horizontally instead of vertically.\n   * This will also update the `aria-orientation`.\n   *\n   * @defaultValue `false`\n   */\n  horizontal?: boolean;\n}\n\n/**\n * This allows the menu to be conditionally rendered as a `Sheet` instead of a\n * menu.\n *\n * - `false` - always render as a `Menu`\n * - `true` - always render as a `Sheet`\n * - `\"phone\"` - render as a sheet only when the {@link AppSize} is considered\n *   phone (`isPhone === true`).\n *\n * @defaultValue `false`\n * @remarks \\@since 5.0.0\n */\nexport type RenderMenuAsSheet = boolean | \"phone\";\n\n/** @remarks \\@since 5.0.0 */\nexport interface MenuConfiguration extends MenuOrientationProps {\n  /** {@inheritDoc RenderMenuAsSheet} */\n  renderAsSheet?: RenderMenuAsSheet;\n\n  /**\n   * @see {@link SheetPosition}\n   * @defaultValue `\"bottom\"`\n   */\n  sheetPosition?: SheetPosition;\n\n  /**\n   * @see {@link SheetVerticalSize}\n   * @defaultValue `\"touch\"`\n   */\n  sheetVerticalSize?: SheetVerticalSize;\n\n  /**\n   * Any children to render above the sheet's menu implementation. This would\n   * normally be something like a `<DialogHeader>` or `AppBar`.\n   *\n   * @defaultValue `null`\n   */\n  sheetHeader?: ReactNode;\n\n  /**\n   * Any children to render below the sheet's menu implementation. This would\n   * normally be something like a `<DialogFooter>`.\n   *\n   * @defaultValue `null`\n   */\n  sheetFooter?: ReactNode;\n}\n\n/** @remarks \\@since 5.0.0 */\nexport type MenuConfigurationContext = Required<MenuConfiguration>;\n\n/** @remarks \\@since 5.0.0 */\nexport const DEFAULT_MENU_CONFIGURATION: Readonly<MenuConfiguration> = {\n  horizontal: false,\n  renderAsSheet: false,\n  sheetHeader: null,\n  sheetFooter: null,\n  sheetPosition: \"bottom\",\n  sheetVerticalSize: \"touch\",\n};\n\n/**\n * @internal\n * @remarks \\@since 5.0.0\n */\nconst context = createContext<MenuConfigurationContext>({\n  horizontal: false,\n  renderAsSheet: false,\n  sheetHeader: null,\n  sheetFooter: null,\n  sheetPosition: \"bottom\",\n  sheetVerticalSize: \"touch\",\n});\ncontext.displayName = \"MenuConfiguration\";\n\n/**\n * @internal\n * @remarks \\@since 5.0.0\n */\nconst { Provider } = context;\n\n/**\n * This is probably just an internal only hook that allows you to get the\n * {@link MenuConfigurationContext} with optional overrides.\n *\n * @param overrides - An object of {@link MenuConfiguration} that would override\n * the inherited context values if they are not `undefined`.\n * @returns the {@link MenuConfigurationContext} with any overrides that were\n * provided.\n * @remarks \\@since 5.0.0\n */\nexport function useMenuConfiguration(\n  overrides: MenuConfiguration = {}\n): Readonly<MenuConfigurationContext> {\n  const {\n    horizontal,\n    renderAsSheet,\n    sheetHeader,\n    sheetFooter,\n    sheetPosition,\n    sheetVerticalSize,\n  } = overrides;\n  const inherited = useContext(context);\n\n  return {\n    horizontal: horizontal ?? inherited.horizontal,\n    renderAsSheet: renderAsSheet ?? inherited.renderAsSheet,\n    sheetHeader:\n      sheetHeader === null ? null : sheetHeader ?? inherited.sheetHeader,\n    sheetFooter:\n      sheetFooter === null ? null : sheetFooter ?? inherited.sheetFooter,\n    sheetPosition: sheetPosition ?? inherited.sheetPosition,\n    sheetVerticalSize: sheetVerticalSize ?? inherited.sheetVerticalSize,\n  };\n}\n\n/** @remarks \\@since 5.0.0 */\nexport interface MenuConfigurationProviderProps extends MenuConfiguration {\n  children: ReactNode;\n}\n\n/**\n * **Client Component**\n *\n * Note: This will always merge values with any parent\n * `MenuConfigurationProvider`s.\n *\n * @remarks \\@since 5.0.0\n */\nexport function MenuConfigurationProvider(\n  props: MenuConfigurationProviderProps\n): ReactElement {\n  const { children, ...configuration } = props;\n  const {\n    horizontal,\n    renderAsSheet,\n    sheetHeader,\n    sheetFooter,\n    sheetPosition,\n    sheetVerticalSize,\n  } = useMenuConfiguration(configuration);\n\n  const value = useMemo<MenuConfigurationContext>(\n    () => ({\n      horizontal,\n      renderAsSheet,\n      sheetHeader,\n      sheetFooter,\n      sheetPosition,\n      sheetVerticalSize,\n    }),\n    [\n      horizontal,\n      renderAsSheet,\n      sheetFooter,\n      sheetHeader,\n      sheetPosition,\n      sheetVerticalSize,\n    ]\n  );\n\n  return <Provider value={value}>{children}</Provider>;\n}\n"],"names":["createContext","useContext","useMemo","DEFAULT_MENU_CONFIGURATION","horizontal","renderAsSheet","sheetHeader","sheetFooter","sheetPosition","sheetVerticalSize","context","displayName","Provider","useMenuConfiguration","overrides","inherited","MenuConfigurationProvider","props","children","configuration","value"],"mappings":"AAAA;;AACA,SACEA,aAAa,EACbC,UAAU,EACVC,OAAO,QAGF,QAAQ;AAiEf,2BAA2B,GAC3B,OAAO,MAAMC,6BAA0D;IACrEC,YAAY;IACZC,eAAe;IACfC,aAAa;IACbC,aAAa;IACbC,eAAe;IACfC,mBAAmB;AACrB,EAAE;AAEF;;;CAGC,GACD,MAAMC,wBAAUV,cAAwC;IACtDI,YAAY;IACZC,eAAe;IACfC,aAAa;IACbC,aAAa;IACbC,eAAe;IACfC,mBAAmB;AACrB;AACAC,QAAQC,WAAW,GAAG;AAEtB;;;CAGC,GACD,MAAM,EAAEC,QAAQ,EAAE,GAAGF;AAErB;;;;;;;;;CASC,GACD,OAAO,SAASG,qBACdC,YAA+B,CAAC,CAAC;IAEjC,MAAM,EACJV,UAAU,EACVC,aAAa,EACbC,WAAW,EACXC,WAAW,EACXC,aAAa,EACbC,iBAAiB,EAClB,GAAGK;IACJ,MAAMC,YAAYd,WAAWS;IAE7B,OAAO;QACLN,YAAYA,cAAcW,UAAUX,UAAU;QAC9CC,eAAeA,iBAAiBU,UAAUV,aAAa;QACvDC,aACEA,gBAAgB,OAAO,OAAOA,eAAeS,UAAUT,WAAW;QACpEC,aACEA,gBAAgB,OAAO,OAAOA,eAAeQ,UAAUR,WAAW;QACpEC,eAAeA,iBAAiBO,UAAUP,aAAa;QACvDC,mBAAmBA,qBAAqBM,UAAUN,iBAAiB;IACrE;AACF;AAOA;;;;;;;CAOC,GACD,OAAO,SAASO,0BACdC,KAAqC;IAErC,MAAM,EAAEC,QAAQ,EAAE,GAAGC,eAAe,GAAGF;IACvC,MAAM,EACJb,UAAU,EACVC,aAAa,EACbC,WAAW,EACXC,WAAW,EACXC,aAAa,EACbC,iBAAiB,EAClB,GAAGI,qBAAqBM;IAEzB,MAAMC,QAAQlB,QACZ,IAAO,CAAA;YACLE;YACAC;YACAC;YACAC;YACAC;YACAC;QACF,CAAA,GACA;QACEL;QACAC;QACAE;QACAD;QACAE;QACAC;KACD;IAGH,qBAAO,KAACG;QAASQ,OAAOA;kBAAQF;;AAClC"}

package/dist/menu/MenuItem.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="react" />
+import { type ListItemProps } from "../list/ListItem.js";
+/**
+ * @remarks \@since 5.0.0
+ */
+export interface MenuItemProps extends Omit<ListItemProps, "role"> {
+    /**
+     * @defaultValue `"menuitem"`
+     */
+    role?: string;
+    /**
+     * @defaultValue `-1`
+     */
+    tabIndex?: number;
+}
+/**
+ * **Client Component**
+ *
+ * This component is used as an "action" within a `Menu`/`DropdownMenu` that
+ * implements some keyboard focus behavior. This component should generally have
+ * an `onClick` event handler.
+ *
+ * @remarks \@since 5.0.0
+ */
+export declare const MenuItem: import("react").ForwardRefExoticComponent<MenuItemProps & import("react").RefAttributes<HTMLLIElement>>;

package/dist/menu/MenuItem.js

@@ -0,0 +1,36 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cnb } from "cnbuilder";
+import { forwardRef } from "react";
+import { ListItem } from "../list/ListItem.js";
+import { useKeyboardMovementContext } from "../movement/useKeyboardMovementProvider.js";
+import { useEnsuredId } from "../useEnsuredId.js";
+/**
+ * **Client Component**
+ *
+ * This component is used as an "action" within a `Menu`/`DropdownMenu` that
+ * implements some keyboard focus behavior. This component should generally have
+ * an `onClick` event handler.
+ *
+ * @remarks \@since 5.0.0
+ */ export const MenuItem = /*#__PURE__*/ forwardRef(function MenuItem(props, ref) {
+    const { id: propId, role = "menuitem", tabIndex: propTabIndex, children, className, ...remaining } = props;
+    const id = useEnsuredId(propId, "menuitem");
+    const { tabIndexBehavior, activeDescendantId } = useKeyboardMovementContext();
+    const focused = id === activeDescendantId;
+    let tabIndex = propTabIndex ?? -1;
+    if (tabIndexBehavior === "roving" && focused) {
+        tabIndex = 0;
+    }
+    return /*#__PURE__*/ _jsx(ListItem, {
+        ...remaining,
+        id: id,
+        ref: ref,
+        role: role,
+        tabIndex: tabIndex,
+        className: cnb("rmd-menu-item", tabIndexBehavior === "virtual" && focused && "rmd-menu-item--focused", className),
+        children: children
+    });
+});
+
+//# sourceMappingURL=MenuItem.js.map

package/dist/menu/MenuItem.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/menu/MenuItem.tsx"],"sourcesContent":["\"use client\";\nimport { cnb } from \"cnbuilder\";\nimport { forwardRef } from \"react\";\nimport { ListItem, type ListItemProps } from \"../list/ListItem.js\";\nimport { useKeyboardMovementContext } from \"../movement/useKeyboardMovementProvider.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\n\n/**\n * @remarks \\@since 5.0.0\n */\nexport interface MenuItemProps extends Omit<ListItemProps, \"role\"> {\n  /**\n   * @defaultValue `\"menuitem\"`\n   */\n  role?: string;\n\n  /**\n   * @defaultValue `-1`\n   */\n  tabIndex?: number;\n}\n\n/**\n * **Client Component**\n *\n * This component is used as an \"action\" within a `Menu`/`DropdownMenu` that\n * implements some keyboard focus behavior. This component should generally have\n * an `onClick` event handler.\n *\n * @remarks \\@since 5.0.0\n */\nexport const MenuItem = forwardRef<HTMLLIElement, MenuItemProps>(\n  function MenuItem(props, ref) {\n    const {\n      id: propId,\n      role = \"menuitem\",\n      tabIndex: propTabIndex,\n      children,\n      className,\n      ...remaining\n    } = props;\n\n    const id = useEnsuredId(propId, \"menuitem\");\n    const { tabIndexBehavior, activeDescendantId } =\n      useKeyboardMovementContext();\n    const focused = id === activeDescendantId;\n    let tabIndex = propTabIndex ?? -1;\n    if (tabIndexBehavior === \"roving\" && focused) {\n      tabIndex = 0;\n    }\n\n    return (\n      <ListItem\n        {...remaining}\n        id={id}\n        ref={ref}\n        role={role}\n        tabIndex={tabIndex}\n        className={cnb(\n          \"rmd-menu-item\",\n          tabIndexBehavior === \"virtual\" && focused && \"rmd-menu-item--focused\",\n          className\n        )}\n      >\n        {children}\n      </ListItem>\n    );\n  }\n);\n"],"names":["cnb","forwardRef","ListItem","useKeyboardMovementContext","useEnsuredId","MenuItem","props","ref","id","propId","role","tabIndex","propTabIndex","children","className","remaining","tabIndexBehavior","activeDescendantId","focused"],"mappings":"AAAA;;AACA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAASC,UAAU,QAAQ,QAAQ;AACnC,SAASC,QAAQ,QAA4B,sBAAsB;AACnE,SAASC,0BAA0B,QAAQ,6CAA6C;AACxF,SAASC,YAAY,QAAQ,qBAAqB;AAiBlD;;;;;;;;CAQC,GACD,OAAO,MAAMC,yBAAWJ,WACtB,SAASI,SAASC,KAAK,EAAEC,GAAG;IAC1B,MAAM,EACJC,IAAIC,MAAM,EACVC,OAAO,UAAU,EACjBC,UAAUC,YAAY,EACtBC,QAAQ,EACRC,SAAS,EACT,GAAGC,WACJ,GAAGT;IAEJ,MAAME,KAAKJ,aAAaK,QAAQ;IAChC,MAAM,EAAEO,gBAAgB,EAAEC,kBAAkB,EAAE,GAC5Cd;IACF,MAAMe,UAAUV,OAAOS;IACvB,IAAIN,WAAWC,gBAAgB,CAAC;IAChC,IAAII,qBAAqB,YAAYE,SAAS;QAC5CP,WAAW;IACb;IAEA,qBACE,KAACT;QACE,GAAGa,SAAS;QACbP,IAAIA;QACJD,KAAKA;QACLG,MAAMA;QACNC,UAAUA;QACVG,WAAWd,IACT,iBACAgB,qBAAqB,aAAaE,WAAW,0BAC7CJ;kBAGDD;;AAGP,GACA"}

package/dist/menu/MenuItemButton.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="react" />
+import { type BaseMenuButtonProps } from "./MenuButton.js";
+import { type MenuItemProps } from "./MenuItem.js";
+/**
+ * @internal
+ * @remarks \@since 5.0.0
+ */
+export interface MenuItemButtonProps extends BaseMenuButtonProps, MenuItemProps {
+}
+/**
+ * **Client Component**
+ *
+ * This is just an internal component that handles rendering a submenu as a
+ * menuitem for a `DropdownMenu` with a conditional dropdown icon.
+ *
+ * @internal
+ * @remarks \@since 5.0.0
+ */
+export declare const MenuItemButton: import("react").ForwardRefExoticComponent<MenuItemButtonProps & import("react").RefAttributes<HTMLLIElement>>;

package/dist/menu/MenuItemButton.js

@@ -0,0 +1,125 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useEffect } from "react";
+import { useHoverMode } from "../hoverMode/useHoverMode.js";
+import { IconRotator } from "../icon/IconRotator.js";
+import { getIcon } from "../icon/iconConfig.js";
+import { useUserInteractionMode } from "../interaction/UserInteractionModeProvider.js";
+import { useAppSize } from "../media-queries/AppSizeProvider.js";
+import { useEnsuredId } from "../useEnsuredId.js";
+import { useMenuConfiguration } from "./MenuConfigurationProvider.js";
+import { MenuItem } from "./MenuItem.js";
+import { useMenuVisibility } from "./MenuVisibilityProvider.js";
+import { useMenuBarContext } from "./useMenuBarProvider.js";
+const noop = ()=>{
+// do nothing
+};
+/**
+ * **Client Component**
+ *
+ * This is just an internal component that handles rendering a submenu as a
+ * menuitem for a `DropdownMenu` with a conditional dropdown icon.
+ *
+ * @internal
+ * @remarks \@since 5.0.0
+ */ export const MenuItemButton = /*#__PURE__*/ forwardRef(function MenuItemButton(props, ref) {
+    const { id: propId, children, onClick = noop, onKeyDown = noop, onMouseEnter = noop, onMouseLeave = noop, rightAddon: propRightAddon, iconRotatorProps, disableDropdownIcon = typeof propRightAddon !== "undefined", ...remaining } = props;
+    const { disabled } = props;
+    const id = useEnsuredId(propId, "menuitem");
+    const mode = useUserInteractionMode();
+    const { renderAsSheet } = useMenuConfiguration();
+    const { isPhone } = useAppSize();
+    const isSheet = renderAsSheet === true || renderAsSheet === "phone" && isPhone;
+    const { root, menubar, activeId, enableHoverMode, disableHoverMode, startDisableTimer, clearDisableTimer, leaveTimeoutRef, hoverTimeoutRef } = useMenuBarContext();
+    const { visible, setVisible, defaultFocusIndex } = useMenuVisibility();
+    const { startShowFlow, clearVisibilityTimeout } = useHoverMode({
+        setVisible,
+        enableHoverMode,
+        disableHoverMode,
+        startDisableTimer,
+        leaveTimeoutRef,
+        hoverTimeoutRef,
+        clearDisableTimer
+    });
+    const { horizontal } = useMenuConfiguration();
+    useEffect(()=>{
+        setVisible(id === activeId);
+    }, [
+        activeId,
+        defaultFocusIndex,
+        id,
+        menubar,
+        setVisible
+    ]);
+    const dropdownIcon = getIcon(root ? "dropdown" : "forward");
+    let rightAddon = propRightAddon;
+    if (!disableDropdownIcon) {
+        rightAddon = /*#__PURE__*/ _jsx(IconRotator, {
+            ...iconRotatorProps,
+            rotated: visible,
+            children: dropdownIcon
+        });
+    }
+    const updateVisibility = (nextVisible, focusIndex = 0)=>{
+        defaultFocusIndex.current = focusIndex;
+        setVisible(nextVisible);
+        if (!menubar) {
+            return;
+        }
+        if (nextVisible) {
+            enableHoverMode(id);
+        } else {
+            disableHoverMode();
+        }
+    };
+    return /*#__PURE__*/ _jsx(MenuItem, {
+        ...remaining,
+        "aria-haspopup": isSheet ? "dialog" : "menu",
+        "aria-expanded": visible || undefined,
+        id: id,
+        ref: ref,
+        rightAddon: rightAddon,
+        onClick: (event)=>{
+            onClick(event);
+            event.stopPropagation();
+            updateVisibility(!visible);
+        },
+        onKeyDown: (event)=>{
+            onKeyDown(event);
+            switch(event.key){
+                case "ArrowDown":
+                    if (horizontal || root) {
+                        event.preventDefault();
+                        event.stopPropagation();
+                        updateVisibility(true);
+                    }
+                    break;
+                case "ArrowRight":
+                    if (!horizontal && !root) {
+                        event.preventDefault();
+                        event.stopPropagation();
+                        updateVisibility(true);
+                    }
+                    break;
+            }
+        },
+        onMouseEnter: (event)=>{
+            onMouseEnter(event);
+            if (mode === "touch" || disabled || !menubar) {
+                return;
+            }
+            defaultFocusIndex.current = 0;
+            startShowFlow(id);
+        },
+        onMouseLeave: (event)=>{
+            onMouseLeave(event);
+            if (mode === "touch" || disabled || !menubar) {
+                return;
+            }
+            clearVisibilityTimeout();
+        },
+        children: children
+    });
+});
+
+//# sourceMappingURL=MenuItemButton.js.map

package/dist/menu/MenuItemButton.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/menu/MenuItemButton.tsx"],"sourcesContent":["\"use client\";\nimport { forwardRef, useEffect } from \"react\";\nimport { useHoverMode } from \"../hoverMode/useHoverMode.js\";\nimport { IconRotator } from \"../icon/IconRotator.js\";\nimport { getIcon } from \"../icon/iconConfig.js\";\nimport { useUserInteractionMode } from \"../interaction/UserInteractionModeProvider.js\";\nimport { useAppSize } from \"../media-queries/AppSizeProvider.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport { type BaseMenuButtonProps } from \"./MenuButton.js\";\nimport { useMenuConfiguration } from \"./MenuConfigurationProvider.js\";\nimport { MenuItem, type MenuItemProps } from \"./MenuItem.js\";\nimport { useMenuVisibility } from \"./MenuVisibilityProvider.js\";\nimport { useMenuBarContext } from \"./useMenuBarProvider.js\";\n\nconst noop = (): void => {\n  // do nothing\n};\n\n/**\n * @internal\n * @remarks \\@since 5.0.0\n */\nexport interface MenuItemButtonProps\n  extends BaseMenuButtonProps,\n    MenuItemProps {}\n\n/**\n * **Client Component**\n *\n * This is just an internal component that handles rendering a submenu as a\n * menuitem for a `DropdownMenu` with a conditional dropdown icon.\n *\n * @internal\n * @remarks \\@since 5.0.0\n */\nexport const MenuItemButton = forwardRef<HTMLLIElement, MenuItemButtonProps>(\n  function MenuItemButton(props, ref) {\n    const {\n      id: propId,\n      children,\n      onClick = noop,\n      onKeyDown = noop,\n      onMouseEnter = noop,\n      onMouseLeave = noop,\n      rightAddon: propRightAddon,\n      iconRotatorProps,\n      disableDropdownIcon = typeof propRightAddon !== \"undefined\",\n      ...remaining\n    } = props;\n    const { disabled } = props;\n\n    const id = useEnsuredId(propId, \"menuitem\");\n    const mode = useUserInteractionMode();\n    const { renderAsSheet } = useMenuConfiguration();\n    const { isPhone } = useAppSize();\n    const isSheet =\n      renderAsSheet === true || (renderAsSheet === \"phone\" && isPhone);\n    const {\n      root,\n      menubar,\n      activeId,\n      enableHoverMode,\n      disableHoverMode,\n      startDisableTimer,\n      clearDisableTimer,\n      leaveTimeoutRef,\n      hoverTimeoutRef,\n    } = useMenuBarContext();\n    const { visible, setVisible, defaultFocusIndex } = useMenuVisibility();\n    const { startShowFlow, clearVisibilityTimeout } = useHoverMode({\n      setVisible,\n      enableHoverMode,\n      disableHoverMode,\n      startDisableTimer,\n      leaveTimeoutRef,\n      hoverTimeoutRef,\n      clearDisableTimer,\n    });\n    const { horizontal } = useMenuConfiguration();\n\n    useEffect(() => {\n      setVisible(id === activeId);\n    }, [activeId, defaultFocusIndex, id, menubar, setVisible]);\n\n    const dropdownIcon = getIcon(root ? \"dropdown\" : \"forward\");\n    let rightAddon = propRightAddon;\n    if (!disableDropdownIcon) {\n      rightAddon = (\n        <IconRotator {...iconRotatorProps} rotated={visible}>\n          {dropdownIcon}\n        </IconRotator>\n      );\n    }\n\n    const updateVisibility = (nextVisible: boolean, focusIndex = 0): void => {\n      defaultFocusIndex.current = focusIndex;\n      setVisible(nextVisible);\n      if (!menubar) {\n        return;\n      }\n\n      if (nextVisible) {\n        enableHoverMode(id);\n      } else {\n        disableHoverMode();\n      }\n    };\n\n    return (\n      <MenuItem\n        {...remaining}\n        aria-haspopup={isSheet ? \"dialog\" : \"menu\"}\n        aria-expanded={visible || undefined}\n        id={id}\n        ref={ref}\n        rightAddon={rightAddon}\n        onClick={(event) => {\n          onClick(event);\n\n          event.stopPropagation();\n          updateVisibility(!visible);\n        }}\n        onKeyDown={(event) => {\n          onKeyDown(event);\n\n          switch (event.key) {\n            case \"ArrowDown\":\n              if (horizontal || root) {\n                event.preventDefault();\n                event.stopPropagation();\n                updateVisibility(true);\n              }\n              break;\n            case \"ArrowRight\":\n              if (!horizontal && !root) {\n                event.preventDefault();\n                event.stopPropagation();\n                updateVisibility(true);\n              }\n              break;\n          }\n        }}\n        onMouseEnter={(event) => {\n          onMouseEnter(event);\n          if (mode === \"touch\" || disabled || !menubar) {\n            return;\n          }\n\n          defaultFocusIndex.current = 0;\n          startShowFlow(id);\n        }}\n        onMouseLeave={(event) => {\n          onMouseLeave(event);\n          if (mode === \"touch\" || disabled || !menubar) {\n            return;\n          }\n\n          clearVisibilityTimeout();\n        }}\n      >\n        {children}\n      </MenuItem>\n    );\n  }\n);\n"],"names":["forwardRef","useEffect","useHoverMode","IconRotator","getIcon","useUserInteractionMode","useAppSize","useEnsuredId","useMenuConfiguration","MenuItem","useMenuVisibility","useMenuBarContext","noop","MenuItemButton","props","ref","id","propId","children","onClick","onKeyDown","onMouseEnter","onMouseLeave","rightAddon","propRightAddon","iconRotatorProps","disableDropdownIcon","remaining","disabled","mode","renderAsSheet","isPhone","isSheet","root","menubar","activeId","enableHoverMode","disableHoverMode","startDisableTimer","clearDisableTimer","leaveTimeoutRef","hoverTimeoutRef","visible","setVisible","defaultFocusIndex","startShowFlow","clearVisibilityTimeout","horizontal","dropdownIcon","rotated","updateVisibility","nextVisible","focusIndex","current","aria-haspopup","aria-expanded","undefined","event","stopPropagation","key","preventDefault"],"mappings":"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"}

package/dist/menu/MenuItemGroup.d.ts

@@ -0,0 +1,75 @@
+import { type ReactNode } from "react";
+import { type ListElement, type ListProps } from "../list/List.js";
+import { type LabelRequiredForA11y } from "../types.js";
+/** @remarks \@since 5.0.0 */
+export type MenuItemGroupProps = LabelRequiredForA11y<Omit<ListProps, "role">> & {
+    children: ReactNode;
+};
+/**
+ * **Client Component**
+ *
+ * If a menu or menubar contains more than one group of menuitemradio elements,
+ * or if the menu contains one group and other, unrelated menu items, authors
+ * SHOULD nest each set of related menuitemradio elements in an element using
+ * the group role, and authors SHOULD delimit the group from other menu items
+ * with an element using the separator role.
+ *
+ * @see {@link https://www.w3.org/TR/wai-aria-1.1/#menuitemradio}
+ *
+ * @example
+ * Simple Example
+ * ```tsx
+ * import { ReactElement, useState } from "react";
+ * import {
+ *   DropdownMenu,
+ *   MenuItemGroup,
+ *   MenuItemRadio,
+ *   MenuItemSeparator,
+ *   MenuItemSwitch,
+ * } from "@react-md/core";
+ *
+ * function Example(): ReactElement {
+ *   const [value, setValue] = useState("value1");
+ *   const [checked, setChecked] = useState(false);
+ *
+ *   return (
+ *     <DropdownMenu id="dropdown-menu-id" buttonChildren="Button">
+ *       <MenuItemSwitch
+ *         id="switch-id"
+ *         checked={checked}
+ *         onCheckedChange={nextChecked => setChecked(nextChecked)}
+ *       >
+ *         Light mode
+ *       </MenuItemSwitch>
+ *       <MenuItemSeparator />
+ *       <MenuItemGroup aria-label="My Group Label">
+ *         <MenuItemRadio
+ *           id="radio-1"
+ *           checked={value === "value1"}
+ *           onCheckedChange={() => setValue("value1")}
+ *         >
+ *           Radio 1
+ *         </MenuItemRadio>
+ *         <MenuItemRadio
+ *           id="radio-2"
+ *           checked={value === "value2"}
+ *           onCheckedChange={() => setValue("value2")}
+ *         >
+ *           Radio 2
+ *         </MenuItemRadio>
+ *         <MenuItemRadio
+ *           id="radio-3"
+ *           checked={value === "value3"}
+ *           onCheckedChange={() => setValue("value3")}
+ *         >
+ *           Radio 3
+ *         </MenuItemRadio>
+ *       </MenuItemGroup>
+ *     </DropdownMenu>
+ *   );
+ * }
+ * ```
+ *
+ * @remarks \@since 5.0.0
+ */
+export declare const MenuItemGroup: import("react").ForwardRefExoticComponent<MenuItemGroupProps & import("react").RefAttributes<ListElement>>;

package/dist/menu/MenuItemGroup.js

@@ -0,0 +1,85 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cnb } from "cnbuilder";
+import { forwardRef } from "react";
+import { List } from "../list/List.js";
+import { useMenuConfiguration } from "./MenuConfigurationProvider.js";
+/**
+ * **Client Component**
+ *
+ * If a menu or menubar contains more than one group of menuitemradio elements,
+ * or if the menu contains one group and other, unrelated menu items, authors
+ * SHOULD nest each set of related menuitemradio elements in an element using
+ * the group role, and authors SHOULD delimit the group from other menu items
+ * with an element using the separator role.
+ *
+ * @see {@link https://www.w3.org/TR/wai-aria-1.1/#menuitemradio}
+ *
+ * @example
+ * Simple Example
+ * ```tsx
+ * import { ReactElement, useState } from "react";
+ * import {
+ *   DropdownMenu,
+ *   MenuItemGroup,
+ *   MenuItemRadio,
+ *   MenuItemSeparator,
+ *   MenuItemSwitch,
+ * } from "@react-md/core";
+ *
+ * function Example(): ReactElement {
+ *   const [value, setValue] = useState("value1");
+ *   const [checked, setChecked] = useState(false);
+ *
+ *   return (
+ *     <DropdownMenu id="dropdown-menu-id" buttonChildren="Button">
+ *       <MenuItemSwitch
+ *         id="switch-id"
+ *         checked={checked}
+ *         onCheckedChange={nextChecked => setChecked(nextChecked)}
+ *       >
+ *         Light mode
+ *       </MenuItemSwitch>
+ *       <MenuItemSeparator />
+ *       <MenuItemGroup aria-label="My Group Label">
+ *         <MenuItemRadio
+ *           id="radio-1"
+ *           checked={value === "value1"}
+ *           onCheckedChange={() => setValue("value1")}
+ *         >
+ *           Radio 1
+ *         </MenuItemRadio>
+ *         <MenuItemRadio
+ *           id="radio-2"
+ *           checked={value === "value2"}
+ *           onCheckedChange={() => setValue("value2")}
+ *         >
+ *           Radio 2
+ *         </MenuItemRadio>
+ *         <MenuItemRadio
+ *           id="radio-3"
+ *           checked={value === "value3"}
+ *           onCheckedChange={() => setValue("value3")}
+ *         >
+ *           Radio 3
+ *         </MenuItemRadio>
+ *       </MenuItemGroup>
+ *     </DropdownMenu>
+ *   );
+ * }
+ * ```
+ *
+ * @remarks \@since 5.0.0
+ */ export const MenuItemGroup = /*#__PURE__*/ forwardRef(function MenuItemGroup({ children, className, ...props }, ref) {
+    const { horizontal } = useMenuConfiguration(props);
+    return /*#__PURE__*/ _jsx(List, {
+        ...props,
+        ref: ref,
+        role: "group",
+        className: cnb("rmd-menu-item-group", className),
+        horizontal: horizontal,
+        children: children
+    });
+});
+
+//# sourceMappingURL=MenuItemGroup.js.map

package/dist/menu/MenuItemGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/menu/MenuItemGroup.tsx"],"sourcesContent":["\"use client\";\nimport { cnb } from \"cnbuilder\";\nimport { forwardRef, type ReactNode } from \"react\";\nimport { List, type ListElement, type ListProps } from \"../list/List.js\";\nimport { type LabelRequiredForA11y } from \"../types.js\";\nimport { useMenuConfiguration } from \"./MenuConfigurationProvider.js\";\n\n/** @remarks \\@since 5.0.0 */\nexport type MenuItemGroupProps = LabelRequiredForA11y<\n  Omit<ListProps, \"role\">\n> & {\n  children: ReactNode;\n};\n\n/**\n * **Client Component**\n *\n * If a menu or menubar contains more than one group of menuitemradio elements,\n * or if the menu contains one group and other, unrelated menu items, authors\n * SHOULD nest each set of related menuitemradio elements in an element using\n * the group role, and authors SHOULD delimit the group from other menu items\n * with an element using the separator role.\n *\n * @see {@link https://www.w3.org/TR/wai-aria-1.1/#menuitemradio}\n *\n * @example\n * Simple Example\n * ```tsx\n * import { ReactElement, useState } from \"react\";\n * import {\n *   DropdownMenu,\n *   MenuItemGroup,\n *   MenuItemRadio,\n *   MenuItemSeparator,\n *   MenuItemSwitch,\n * } from \"@react-md/core\";\n *\n * function Example(): ReactElement {\n *   const [value, setValue] = useState(\"value1\");\n *   const [checked, setChecked] = useState(false);\n *\n *   return (\n *     <DropdownMenu id=\"dropdown-menu-id\" buttonChildren=\"Button\">\n *       <MenuItemSwitch\n *         id=\"switch-id\"\n *         checked={checked}\n *         onCheckedChange={nextChecked => setChecked(nextChecked)}\n *       >\n *         Light mode\n *       </MenuItemSwitch>\n *       <MenuItemSeparator />\n *       <MenuItemGroup aria-label=\"My Group Label\">\n *         <MenuItemRadio\n *           id=\"radio-1\"\n *           checked={value === \"value1\"}\n *           onCheckedChange={() => setValue(\"value1\")}\n *         >\n *           Radio 1\n *         </MenuItemRadio>\n *         <MenuItemRadio\n *           id=\"radio-2\"\n *           checked={value === \"value2\"}\n *           onCheckedChange={() => setValue(\"value2\")}\n *         >\n *           Radio 2\n *         </MenuItemRadio>\n *         <MenuItemRadio\n *           id=\"radio-3\"\n *           checked={value === \"value3\"}\n *           onCheckedChange={() => setValue(\"value3\")}\n *         >\n *           Radio 3\n *         </MenuItemRadio>\n *       </MenuItemGroup>\n *     </DropdownMenu>\n *   );\n * }\n * ```\n *\n * @remarks \\@since 5.0.0\n */\nexport const MenuItemGroup = forwardRef<ListElement, MenuItemGroupProps>(\n  function MenuItemGroup({ children, className, ...props }, ref) {\n    const { horizontal } = useMenuConfiguration(props);\n    return (\n      <List\n        {...props}\n        ref={ref}\n        role=\"group\"\n        className={cnb(\"rmd-menu-item-group\", className)}\n        horizontal={horizontal}\n      >\n        {children}\n      </List>\n    );\n  }\n);\n"],"names":["cnb","forwardRef","List","useMenuConfiguration","MenuItemGroup","children","className","props","ref","horizontal","role"],"mappings":"AAAA;;AACA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAASC,UAAU,QAAwB,QAAQ;AACnD,SAASC,IAAI,QAA0C,kBAAkB;AAEzE,SAASC,oBAAoB,QAAQ,iCAAiC;AAStE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkEC,GACD,OAAO,MAAMC,8BAAgBH,WAC3B,SAASG,cAAc,EAAEC,QAAQ,EAAEC,SAAS,EAAE,GAAGC,OAAO,EAAEC,GAAG;IAC3D,MAAM,EAAEC,UAAU,EAAE,GAAGN,qBAAqBI;IAC5C,qBACE,KAACL;QACE,GAAGK,KAAK;QACTC,KAAKA;QACLE,MAAK;QACLJ,WAAWN,IAAI,uBAAuBM;QACtCG,YAAYA;kBAEXJ;;AAGP,GACA"}

package/dist/menu/MenuItemSeparator.d.ts

@@ -0,0 +1,16 @@
+import { type HTMLAttributes } from "react";
+import { type DividerProps } from "../divider/Divider.js";
+import { type VerticalDividerProps } from "../divider/VerticalDivider.js";
+/** @remarks \@since 5.0.0 */
+export interface MenuItemSeparatorProps extends HTMLAttributes<HTMLLIElement>, Pick<DividerProps, "inset" | "vertical">, Pick<VerticalDividerProps, "maxHeight"> {
+}
+/**
+ * **Client Component**
+ *
+ * This component renders a `<li role="separator">` with the divider styles. It
+ * will also automatically render itself vertically instead of horizontally if
+ * the menu is rendering horizontally.
+ *
+ * @remarks \@since 5.0.0 Renders as an `<li>` instead of a `<div>` or `<hr />`.
+ */
+export declare const MenuItemSeparator: import("react").ForwardRefExoticComponent<MenuItemSeparatorProps & import("react").RefAttributes<HTMLLIElement>>;

package/dist/menu/MenuItemSeparator.js

@@ -0,0 +1,38 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { divider } from "../divider/styles.js";
+import { useVerticalDividerHeight } from "../divider/useVerticalDividerHeight.js";
+import { useMenuConfiguration } from "./MenuConfigurationProvider.js";
+/**
+ * **Client Component**
+ *
+ * This component renders a `<li role="separator">` with the divider styles. It
+ * will also automatically render itself vertically instead of horizontally if
+ * the menu is rendering horizontally.
+ *
+ * @remarks \@since 5.0.0 Renders as an `<li>` instead of a `<div>` or `<hr />`.
+ */ export const MenuItemSeparator = /*#__PURE__*/ forwardRef(function MenuItemSeparator(props, ref) {
+    const { style, className, maxHeight, inset, vertical: propVertical, children, ...remaining } = props;
+    const horizontal = useMenuConfiguration().horizontal;
+    const vertical = propVertical ?? horizontal;
+    const heightProps = useVerticalDividerHeight({
+        ref,
+        style,
+        maxHeight: vertical ? maxHeight ?? 1 : 0
+    });
+    return /*#__PURE__*/ _jsx("li", {
+        ...remaining,
+        ...heightProps,
+        "aria-orientation": vertical ? "vertical" : undefined,
+        role: "separator",
+        className: divider({
+            inset: inset && !vertical,
+            vertical,
+            className
+        }),
+        children: children
+    });
+});
+
+//# sourceMappingURL=MenuItemSeparator.js.map

package/dist/menu/MenuItemSeparator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/menu/MenuItemSeparator.tsx"],"sourcesContent":["\"use client\";\nimport { forwardRef, type HTMLAttributes } from \"react\";\nimport { type DividerProps } from \"../divider/Divider.js\";\nimport { type VerticalDividerProps } from \"../divider/VerticalDivider.js\";\nimport { divider } from \"../divider/styles.js\";\nimport { useVerticalDividerHeight } from \"../divider/useVerticalDividerHeight.js\";\nimport { useMenuConfiguration } from \"./MenuConfigurationProvider.js\";\n\n/** @remarks \\@since 5.0.0 */\nexport interface MenuItemSeparatorProps\n  extends HTMLAttributes<HTMLLIElement>,\n    Pick<DividerProps, \"inset\" | \"vertical\">,\n    Pick<VerticalDividerProps, \"maxHeight\"> {}\n\n/**\n * **Client Component**\n *\n * This component renders a `<li role=\"separator\">` with the divider styles. It\n * will also automatically render itself vertically instead of horizontally if\n * the menu is rendering horizontally.\n *\n * @remarks \\@since 5.0.0 Renders as an `<li>` instead of a `<div>` or `<hr />`.\n */\nexport const MenuItemSeparator = forwardRef<\n  HTMLLIElement,\n  MenuItemSeparatorProps\n>(function MenuItemSeparator(props, ref) {\n  const {\n    style,\n    className,\n    maxHeight,\n    inset,\n    vertical: propVertical,\n    children,\n    ...remaining\n  } = props;\n\n  const horizontal = useMenuConfiguration().horizontal;\n  const vertical = propVertical ?? horizontal;\n  const heightProps = useVerticalDividerHeight({\n    ref,\n    style,\n    maxHeight: vertical ? maxHeight ?? 1 : 0,\n  });\n\n  return (\n    <li\n      {...remaining}\n      {...heightProps}\n      aria-orientation={vertical ? \"vertical\" : undefined}\n      role=\"separator\"\n      className={divider({ inset: inset && !vertical, vertical, className })}\n    >\n      {children}\n    </li>\n  );\n});\n"],"names":["forwardRef","divider","useVerticalDividerHeight","useMenuConfiguration","MenuItemSeparator","props","ref","style","className","maxHeight","inset","vertical","propVertical","children","remaining","horizontal","heightProps","li","aria-orientation","undefined","role"],"mappings":"AAAA;;AACA,SAASA,UAAU,QAA6B,QAAQ;AAGxD,SAASC,OAAO,QAAQ,uBAAuB;AAC/C,SAASC,wBAAwB,QAAQ,yCAAyC;AAClF,SAASC,oBAAoB,QAAQ,iCAAiC;AAQtE;;;;;;;;CAQC,GACD,OAAO,MAAMC,kCAAoBJ,WAG/B,SAASI,kBAAkBC,KAAK,EAAEC,GAAG;IACrC,MAAM,EACJC,KAAK,EACLC,SAAS,EACTC,SAAS,EACTC,KAAK,EACLC,UAAUC,YAAY,EACtBC,QAAQ,EACR,GAAGC,WACJ,GAAGT;IAEJ,MAAMU,aAAaZ,uBAAuBY,UAAU;IACpD,MAAMJ,WAAWC,gBAAgBG;IACjC,MAAMC,cAAcd,yBAAyB;QAC3CI;QACAC;QACAE,WAAWE,WAAWF,aAAa,IAAI;IACzC;IAEA,qBACE,KAACQ;QACE,GAAGH,SAAS;QACZ,GAAGE,WAAW;QACfE,oBAAkBP,WAAW,aAAaQ;QAC1CC,MAAK;QACLZ,WAAWP,QAAQ;YAAES,OAAOA,SAAS,CAACC;YAAUA;YAAUH;QAAU;kBAEnEK;;AAGP,GAAG"}