mtrl 0.8.0-next.27 → 0.8.0-next.29

package/dist/components/menu/features/registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Keeps track of which menu is open, so that opening one closes the last.
+ *
+ * A menu button's menu is dismissed once the interaction moves outside it, so
+ * two menus should never be open together: the screen reader would be told
+ * there are two, since both openers carry aria-expanded="true".
+ *
+ * Menus used to rely on the document click listener each open menu installs to
+ * notice a click elsewhere and close. That never fired for another menu's
+ * opener, because the opener stops the click from propagating, so menus piled
+ * up. Announcing the open here does not depend on how the menu was opened,
+ * which the click path could never cover: a menu opened by keyboard or by code
+ * closes the previous one just the same.
+ *
+ * Only root menus take part. Submenus belong to their parent, which closes them.
+ */
+/** What the registry needs of a menu: a way to close it */
+export interface RegisteredMenu {
+    close: (event?: Event) => void;
+}
+/**
+ * Announces that a menu has opened, closing whichever was open before.
+ *
+ * @param menu - The menu that is opening
+ * @param event - The event that opened it, passed to the menu being closed
+ */
+export declare const menuOpened: (menu: RegisteredMenu, event?: Event) => void;
+/**
+ * Announces that a menu has closed. Closing a menu that is not the open one is
+ * a no-op, which is what makes the call safe from any close path, including
+ * destroy.
+ *
+ * @param menu - The menu that is closing
+ */
+export declare const menuClosed: (menu: RegisteredMenu) => void;
+/** The menu that is currently open, if any. Exported for tests */
+export declare const currentlyOpenMenu: () => RegisteredMenu | null;

package/dist/components/menu/index.d.ts

@@ -8,7 +8,7 @@
  * @category Components
  */
 export { default } from './menu';
-export type { MenuConfig, MenuComponent, MenuItem, MenuDivider, MenuContent, MenuEvent, MenuSelectEvent, MenuPosition } from './types';
+export type { MenuConfig, MenuComponent, MenuItem, MenuDivider, MenuGap, MenuContent, MenuEvent, MenuSelectEvent, MenuPosition } from './types';
 /**
  * Constants for menu position values - use these instead of string literals
  * for better code completion and type safety.

package/dist/components/menu/types.d.ts

@@ -103,11 +103,33 @@ export interface MenuDivider {
     id?: string;
 }
 /**
- * Combined type for menu content items (regular items or dividers)
+ * Menu item type for a gap between groups.
+ *
+ * The M3 expressive vertical menu separates groups two ways: a divider line,
+ * or a gap. A gap splits the menu into separate surfaces, each with its own
+ * rounded container, rather than drawing a line across one surface
+ * (m3.material.io/components/menus, vertical menus).
+ *
+ * A standard menu is a single surface, so a gap there is simply space.
+ *
+ * @category Components
+ */
+export interface MenuGap {
+    /**
+     * Type must be 'gap' to differentiate from regular menu items
+     */
+    type: "gap";
+    /**
+     * Optional ID for the gap (for accessibility)
+     */
+    id?: string;
+}
+/**
+ * Combined type for menu content items (regular items, dividers or gaps)
  *
  * @category Components
  */
-export type MenuContent = MenuItem | MenuDivider;
+export type MenuContent = MenuItem | MenuDivider | MenuGap;
 /**
  * Configuration interface for the Menu component
  *