@spectrum-web-components/menu 0.32.1-overlay.33 → 0.32.1-overlay.41

package/custom-elements.json

@@ -256,7 +256,7 @@
                   }
                 }
               ],
-              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the capture phase the first\nMenu based element that the event encounters will manage the focus state of the\ndispatching `<sp-menu-item>` element."
+              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the CAPTURE phase the first\nMenu based element that the event encounters will manage the focus state of the\ndispatching `<sp-menu-item>` element."
             },
             {
               "kind": "method",
@@ -275,7 +275,7 @@
                   }
                 }
               ],
-              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the bubble phase the first\nMenu based element that the event encounters that does not inherit selection will\nmanage the selection state of the dispatching `<sp-menu-item>` element."
+              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the BUBBLE phase the first\nMenu based element that the event encounters that does not inherit selection will\nmanage the selection state of the dispatching `<sp-menu-item>` element."
             },
             {
               "kind": "method",
@@ -296,9 +296,22 @@
               ]
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "removeChildItem",
-              "privacy": "private"
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "MenuItem"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -321,7 +334,7 @@
             },
             {
               "kind": "method",
-              "name": "onClick",
+              "name": "handleClick",
               "privacy": "private",
               "return": {
                 "type": {
@@ -417,6 +430,29 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "handleDescendentOverlayClosed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "handleSubmenuClosed",
+              "privacy": "public"
+            },
             {
               "kind": "field",
               "name": "handleSubmenuOpened",
@@ -545,9 +581,10 @@
               "kind": "field",
               "name": "_willUpdateItems",
               "type": {
-                "text": "number | undefined"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "method",
@@ -559,6 +596,16 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "updateCache",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "updateItemFocus",
@@ -625,15 +672,6 @@
                 }
               }
             },
-            {
-              "kind": "field",
-              "name": "_notFirstUpdated",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
             {
               "kind": "method",
               "name": "selectsChanged",
@@ -794,16 +832,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "instances",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "static": true,
-              "default": "1"
-            },
             {
               "kind": "field",
               "name": "headerId",
@@ -811,7 +839,7 @@
                 "text": "string"
               },
               "privacy": "private",
-              "default": "`sp-menu-group-label-${MenuGroup.instances}`"
+              "default": "''"
             },
             {
               "kind": "field",
@@ -1094,7 +1122,7 @@
                   }
                 }
               ],
-              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the capture phase the first\nMenu based element that the event encounters will manage the focus state of the\ndispatching `<sp-menu-item>` element.",
+              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the CAPTURE phase the first\nMenu based element that the event encounters will manage the focus state of the\ndispatching `<sp-menu-item>` element.",
               "inheritedFrom": {
                 "name": "Menu",
                 "module": "src/Menu.ts"
@@ -1117,7 +1145,7 @@
                   }
                 }
               ],
-              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the bubble phase the first\nMenu based element that the event encounters that does not inherit selection will\nmanage the selection state of the dispatching `<sp-menu-item>` element.",
+              "description": "When a descendant `<sp-menu-item>` element is added or updated it will dispatch\nthis event to announce its presence in the DOM. During the BUBBLE phase the first\nMenu based element that the event encounters that does not inherit selection will\nmanage the selection state of the dispatching `<sp-menu-item>` element.",
               "inheritedFrom": {
                 "name": "Menu",
                 "module": "src/Menu.ts"
@@ -1146,9 +1174,22 @@
               }
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "removeChildItem",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "MenuItem"
+                  }
+                }
+              ],
               "inheritedFrom": {
                 "name": "Menu",
                 "module": "src/Menu.ts"
@@ -1179,7 +1220,7 @@
             },
             {
               "kind": "method",
-              "name": "onClick",
+              "name": "handleClick",
               "privacy": "private",
               "return": {
                 "type": {
@@ -1303,6 +1344,37 @@
                 "module": "src/Menu.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "handleDescendentOverlayClosed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSubmenuClosed",
+              "privacy": "public",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleSubmenuOpened",
@@ -1467,9 +1539,10 @@
               "kind": "field",
               "name": "_willUpdateItems",
               "type": {
-                "text": "number | undefined"
+                "text": "boolean"
               },
               "privacy": "private",
+              "default": "false",
               "inheritedFrom": {
                 "name": "Menu",
                 "module": "src/Menu.ts"
@@ -1489,6 +1562,20 @@
                 "module": "src/Menu.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "updateCache",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "updateItemFocus",
@@ -1575,19 +1662,6 @@
                 "module": "src/Menu.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "_notFirstUpdated",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false",
-              "inheritedFrom": {
-                "name": "Menu",
-                "module": "src/Menu.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "selectsChanged",
@@ -1746,34 +1820,11 @@
         {
           "kind": "class",
           "description": "",
-          "name": "MenuItemRemovedEvent",
+          "name": "MenuItemAddedOrUpdatedEvent",
           "members": [
-            {
-              "kind": "field",
-              "name": "item",
-              "type": {
-                "text": "MenuItem"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "_item",
-              "type": {
-                "text": "MenuItem"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "focused",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false"
-            },
             {
               "kind": "method",
-              "name": "reset",
+              "name": "clear",
               "return": {
                 "type": {
                   "text": "void"
@@ -1787,34 +1838,11 @@
                   }
                 }
               ]
-            }
-          ],
-          "superclass": {
-            "name": "Event",
-            "module": "src/MenuItem.ts"
-          }
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "MenuItemAddedOrUpdatedEvent",
-          "members": [
-            {
-              "kind": "field",
-              "name": "menuCascade",
-              "default": "new WeakMap<\n        HTMLElement,\n        {\n            hadFocusRoot: boolean;\n            ancestorWithSelects?: HTMLElement;\n        }\n    >()"
-            },
-            {
-              "kind": "field",
-              "name": "focusRoot"
-            },
-            {
-              "kind": "field",
-              "name": "parentMenu"
             },
             {
               "kind": "field",
-              "name": "selectionRoot"
+              "name": "menuCascade",
+              "default": "new WeakMap<HTMLElement, MenuCascadeItem>()"
             },
             {
               "kind": "field",
@@ -1829,7 +1857,8 @@
               "name": "_item",
               "type": {
                 "text": "MenuItem"
-              }
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -1837,30 +1866,6 @@
               "type": {
                 "text": "Menu | undefined"
               }
-            },
-            {
-              "kind": "field",
-              "name": "_currentAncestorWithSelects",
-              "type": {
-                "text": "Menu | undefined"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "reset",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "item",
-                  "type": {
-                    "text": "MenuItem"
-                  }
-                }
-              ]
             }
           ],
           "superclass": {
@@ -1891,15 +1896,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "instanceCount",
-              "type": {
-                "text": "number"
-              },
-              "static": true,
-              "default": "0"
-            },
             {
               "kind": "field",
               "name": "active",
@@ -2031,7 +2027,8 @@
               },
               "privacy": "public",
               "default": "false",
-              "attribute": "open"
+              "attribute": "open",
+              "reflects": true
             },
             {
               "kind": "method",
@@ -2264,6 +2261,16 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "cleanup",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "openOverlay",
@@ -2310,7 +2317,7 @@
             },
             {
               "kind": "field",
-              "name": "willTriggerUpdate",
+              "name": "willDispatchUpdate",
               "type": {
                 "text": "boolean"
               },
@@ -2328,36 +2335,34 @@
               }
             },
             {
-              "kind": "field",
-              "name": "menuDataUpdated",
-              "type": {
-                "text": "Promise<void>"
-              },
-              "privacy": "protected"
-            },
-            {
-              "kind": "field",
-              "name": "resolveMenuDataUpdated",
-              "privacy": "protected"
+              "kind": "method",
+              "name": "dispatchUpdate",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "field",
               "name": "menuData",
               "type": {
-                "text": "{\n        focusRoot?: Menu;\n        parentMenu?: Menu;\n        selectionRoot?: Menu;\n    }"
+                "text": "{\n        focusRoot?: Menu;\n        parentMenu?: Menu;\n        selectionRoot?: Menu;\n        cleanupSteps: ((item: MenuItem) => void)[];\n    }"
               },
               "privacy": "public",
-              "default": "{\n        focusRoot: undefined,\n        parentMenu: undefined,\n        selectionRoot: undefined,\n    }"
+              "default": "{\n        focusRoot: undefined,\n        parentMenu: undefined,\n        selectionRoot: undefined,\n        cleanupSteps: [],\n    }"
             }
           ],
           "events": [
             {
-              "description": "announces the item has been added so a parent menu can take ownerships",
-              "name": "sp-menu-item-added"
+              "type": {
+                "text": "MenuItemAddedOrUpdatedEvent"
+              }
             },
             {
-              "description": "announces when removed from the DOM so the parent menu can remove ownership and update selected state",
-              "name": "sp-menu-item-removed"
+              "description": "announces the item has been added so a parent menu can take ownerships",
+              "name": "sp-menu-item-added"
             }
           ],
           "attributes": [
@@ -2432,14 +2437,6 @@
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "MenuItemRemovedEvent",
-          "declaration": {
-            "name": "MenuItemRemovedEvent",
-            "module": "src/MenuItem.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "MenuItemAddedOrUpdatedEvent",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@spectrum-web-components/menu",
-    "version": "0.32.1-overlay.33+8b9227d00",
+    "version": "0.32.1-overlay.41+ea2752a5d",
     "publishConfig": {
         "access": "public"
     },
@@ -85,13 +85,13 @@
     ],
     "dependencies": {
         "@lit-labs/observers": "^2.0.0",
-        "@spectrum-web-components/action-button": "^0.32.1-overlay.33+8b9227d00",
-        "@spectrum-web-components/base": "^0.32.1-overlay.33+8b9227d00",
-        "@spectrum-web-components/divider": "^0.32.1-overlay.33+8b9227d00",
-        "@spectrum-web-components/icon": "^0.32.1-overlay.33+8b9227d00",
-        "@spectrum-web-components/icons-ui": "^0.32.1-overlay.33+8b9227d00",
-        "@spectrum-web-components/overlay": "^0.32.1-overlay.33+8b9227d00",
-        "@spectrum-web-components/shared": "^0.32.1-overlay.33+8b9227d00"
+        "@spectrum-web-components/action-button": "^0.32.1-overlay.41+ea2752a5d",
+        "@spectrum-web-components/base": "^0.32.1-overlay.41+ea2752a5d",
+        "@spectrum-web-components/divider": "^0.32.1-overlay.41+ea2752a5d",
+        "@spectrum-web-components/icon": "^0.32.1-overlay.41+ea2752a5d",
+        "@spectrum-web-components/icons-ui": "^0.32.1-overlay.41+ea2752a5d",
+        "@spectrum-web-components/overlay": "^0.32.1-overlay.41+ea2752a5d",
+        "@spectrum-web-components/shared": "^0.32.1-overlay.41+ea2752a5d"
     },
     "devDependencies": {
         "@spectrum-css/menu": "^4.0.34"
@@ -102,5 +102,5 @@
         "./sp-*.js",
         "./**/*.dev.js"
     ],
-    "gitHead": "8b9227d00900eacee1c6d194064f10062f27ab3e"
+    "gitHead": "ea2752a5dab7c3fc9f9d68148e74af23c63e2cfd"
 }

package/src/Menu.d.ts

@@ -50,7 +50,7 @@ export declare class Menu extends SpectrumElement {
     private resolvedRole?;
     /**
      * When a descendant `<sp-menu-item>` element is added or updated it will dispatch
-     * this event to announce its presence in the DOM. During the capture phase the first
+     * this event to announce its presence in the DOM. During the CAPTURE phase the first
      * Menu based element that the event encounters will manage the focus state of the
      * dispatching `<sp-menu-item>` element.
      * @param event
@@ -58,7 +58,7 @@ export declare class Menu extends SpectrumElement {
     private onFocusableItemAddedOrUpdated;
     /**
      * When a descendant `<sp-menu-item>` element is added or updated it will dispatch
-     * this event to announce its presence in the DOM. During the bubble phase the first
+     * this event to announce its presence in the DOM. During the BUBBLE phase the first
      * Menu based element that the event encounters that does not inherit selection will
      * manage the selection state of the dispatching `<sp-menu-item>` element.
      * @param event
@@ -68,13 +68,15 @@ export declare class Menu extends SpectrumElement {
     private removeChildItem;
     constructor();
     focus({ preventScroll }?: FocusOptions): void;
-    private onClick;
+    private handleClick;
     handleFocusin(event: FocusEvent): void;
     startListeningToKeyboard(): void;
     handleFocusout(event: FocusEvent): void;
     stopListeningToKeyboard(): void;
     private descendentOverlays;
     protected handleDescendentOverlayOpened(event: Event): void;
+    protected handleDescendentOverlayClosed(event: Event): void;
+    handleSubmenuClosed: (event: Event) => void;
     handleSubmenuOpened: (event: Event) => void;
     selectOrToggleItem(targetItem: MenuItem): Promise<void>;
     protected navigateWithinMenu(event: KeyboardEvent): void;
@@ -84,15 +86,15 @@ export declare class Menu extends SpectrumElement {
     private prepareToCleanUp;
     private _hasUpdatedSelectedItemIndex;
     updateSelectedItemIndex(): void;
-    private _willUpdateItems?;
+    private _willUpdateItems;
     private handleItemsChanged;
+    private updateCache;
     private updateItemFocus;
     closeDescendentOverlays(): void;
     private forwardFocusVisibleToItem;
     private handleSlotchange;
     protected renderMenuItemSlot(): TemplateResult;
     render(): TemplateResult;
-    private _notFirstUpdated;
     protected firstUpdated(changed: PropertyValues): void;
     protected updated(changes: PropertyValues<this>): void;
     protected selectsChanged(): void;