mtrl 0.8.0-next.26 → 0.8.0-next.28

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

@@ -165,7 +165,7 @@ export interface DialogConfig {
     zIndex?: number;
     /**
      * Duration of open/close animations in milliseconds
-     * @default 300
+     * @default 150
      */
     animationDuration?: number;
     /**

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

@@ -92,7 +92,7 @@ export interface DrawerConfig extends BaseComponentConfig {
     items?: DrawerItemConfig[];
     /**
      * Drawer width as a CSS value
-     * @default '360px'
+     * @default 360
      */
     width?: string | number;
     /**

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/types.d.ts

@@ -129,15 +129,11 @@ export interface MenuConfig {
      * Array of menu items and dividers to display
      */
     items: MenuContent[];
-    /**
-     * Position of the menu relative to the opener
-     * @default 'bottom-start'
-     */
     /**
      * Menu variant. `'vertical'` is the M3 expressive menu: a rounded
      * container holding items that sit apart and change shape as they are
-     * hovered, focused, pressed or selected. Defaults to `'baseline'`, the
-     * original M3 menu.
+     * hovered, focused, pressed or selected.
+     * @default 'baseline'
      */
     variant?: MenuVariant;
     /**
@@ -145,6 +141,10 @@ export interface MenuConfig {
      * and more prominent, so it should be used sparingly.
      */
     color?: MenuColor;
+    /**
+     * Position of the menu relative to the opener
+     * @default 'bottom-start'
+     */
     position?: MenuPosition;
     /**
      * Whether the menu should close when an item is clicked
@@ -183,7 +183,7 @@ export interface MenuConfig {
     maxHeight?: string;
     /**
      * Optional offset from the opener (in pixels)
-     * @default 8
+     * @default 0
      */
     offset?: number;
     /**

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

@@ -55,7 +55,7 @@ export interface ProgressConfig {
     /**
      * Thickness of the progress track and indicator
      * Can be a named preset ('thin', 'default', 'thick') or a specific number in pixels
-     * @default 'default'
+     * @default 'thin'
      */
     thickness?: ProgressThickness;
     /**
@@ -109,7 +109,7 @@ export interface ProgressConfig {
     /**
      * Size of the circular progress indicator in dp (only for circular variant)
      * Clamped between 24 and 240
-     * @default 50
+     * @default 40 (48 when wavy)
      */
     size?: number;
 }