@spectrum-web-components/overlay 0.34.1-rc.0 → 0.35.1-rc.15

package/custom-elements.json

@@ -65,13 +65,300 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/Overlay.ts",
+      "path": "src/AbstractOverlay.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "overlayTimer",
+          "default": "new OverlayTimer()"
+        },
+        {
+          "kind": "function",
+          "name": "noop",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          }
+        },
         {
           "kind": "class",
           "description": "",
-          "name": "Overlay",
+          "name": "BeforetoggleClosedEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "currentState",
+              "type": {
+                "text": "string"
+              },
+              "default": "'open'"
+            },
+            {
+              "kind": "field",
+              "name": "newState",
+              "type": {
+                "text": "string"
+              },
+              "default": "'closed'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "BeforetoggleOpenEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "currentState",
+              "type": {
+                "text": "string"
+              },
+              "default": "'closed'"
+            },
+            {
+              "kind": "field",
+              "name": "newState",
+              "type": {
+                "text": "string"
+              },
+              "default": "'open'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "function",
+          "name": "guaranteedAllTransitionend",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "el",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "Target of the \"transition\" listeners."
+            },
+            {
+              "name": "action",
+              "type": {
+                "text": "Function"
+              },
+              "description": "Method to trigger the \"transition\"."
+            },
+            {
+              "name": "cb",
+              "type": {
+                "text": "Function"
+              },
+              "description": "Callback to trigger when the \"transition\" has ended."
+            }
+          ],
+          "description": "Apply a \"transitionend\" listener to an element that may not transition but\nguarantee the callback will be fired either way."
+        },
+        {
+          "kind": "function",
+          "name": "nextFrame",
+          "return": {
+            "type": {
+              "text": "Promise<void>"
+            }
+          }
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AbstractOverlay",
           "members": [
+            {
+              "kind": "method",
+              "name": "applyFocus",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "_focusEl",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "delayed",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dialogEl",
+              "type": {
+                "text": "HTMLDialogElement & {\n        showPopover(): void;\n        hidePopover(): void;\n    }"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dispose",
+              "default": "noop"
+            },
+            {
+              "kind": "method",
+              "name": "ensureOnDOM",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "elements",
+              "type": {
+                "text": "OpenableElement[]"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isVisible",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "makeTransition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<HTMLElement | null>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "manageDelay",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "manageDialogOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "managePopoverOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "managePosition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "placementController",
+              "type": {
+                "text": "PlacementController"
+              },
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "receivesFocus",
+              "type": {
+                "text": "'true' | 'false' | 'auto'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "triggerElement",
+              "type": {
+                "text": "HTMLElement | VirtualTrigger | null"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "OverlayTypes"
+              }
+            },
             {
               "kind": "method",
               "name": "open",
@@ -84,7 +371,7 @@
               },
               "parameters": [
                 {
-                  "name": "target",
+                  "name": "trigger",
                   "type": {
                     "text": "HTMLElement"
                   }
@@ -102,7 +389,7 @@
                   }
                 },
                 {
-                  "name": "options",
+                  "name": "optionsV1",
                   "type": {
                     "text": "OverlayOptionsV1"
                   }
@@ -147,7 +434,7 @@
               },
               "parameters": [
                 {
-                  "name": "targetOrContent",
+                  "name": "triggerOrContent",
                   "type": {
                     "text": "HTMLElement"
                   }
@@ -166,7 +453,7 @@
                   }
                 },
                 {
-                  "name": "options",
+                  "name": "optionsV1",
                   "optional": true,
                   "type": {
                     "text": "OverlayOptionsV1"
@@ -175,44 +462,75 @@
               ]
             }
           ],
-          "events": [
-            {
-              "description": "announces that an overlay has completed any entry animations",
-              "name": "sp-opened"
-            },
-            {
-              "description": "announce that an overlay has compelted any exit animations",
-              "name": "sp-closed"
-            }
-          ],
           "superclass": {
-            "name": "OverlayFeatures",
-            "module": "src/Overlay.ts"
-          },
-          "tagName": "sp-overlay",
-          "customElement": true
+            "name": "SpectrumElement",
+            "package": "@spectrum-web-components/base"
+          }
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "Overlay",
+          "name": "overlayTimer",
           "declaration": {
-            "name": "Overlay",
-            "module": "src/Overlay.ts"
+            "name": "overlayTimer",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "noop",
+          "declaration": {
+            "name": "noop",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BeforetoggleClosedEvent",
+          "declaration": {
+            "name": "BeforetoggleClosedEvent",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BeforetoggleOpenEvent",
+          "declaration": {
+            "name": "BeforetoggleOpenEvent",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "guaranteedAllTransitionend",
+          "declaration": {
+            "name": "guaranteedAllTransitionend",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "nextFrame",
+          "declaration": {
+            "name": "nextFrame",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AbstractOverlay",
+          "declaration": {
+            "name": "AbstractOverlay",
+            "module": "src/AbstractOverlay.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/OverlayBase.ts",
+      "path": "src/Overlay.ts",
       "declarations": [
-        {
-          "kind": "variable",
-          "name": "overlayTimer",
-          "default": "new OverlayTimer()"
-        },
         {
           "kind": "variable",
           "name": "LONGPRESS_INSTRUCTIONS",
@@ -224,104 +542,15 @@
         {
           "kind": "class",
           "description": "",
-          "name": "BeforetoggleClosedEvent",
-          "members": [
-            {
-              "kind": "field",
-              "name": "currentState",
-              "type": {
-                "text": "string"
-              },
-              "default": "'open'"
-            },
-            {
-              "kind": "field",
-              "name": "newState",
-              "type": {
-                "text": "string"
-              },
-              "default": "'closed'"
-            }
-          ],
-          "superclass": {
-            "name": "Event",
-            "module": "src/OverlayBase.ts"
-          }
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "BeforetoggleOpenEvent",
+          "name": "Overlay",
           "members": [
             {
               "kind": "field",
-              "name": "currentState",
-              "type": {
-                "text": "string"
-              },
-              "default": "'closed'"
-            },
-            {
-              "kind": "field",
-              "name": "newState",
-              "type": {
-                "text": "string"
-              },
-              "default": "'open'"
-            }
-          ],
-          "superclass": {
-            "name": "Event",
-            "module": "src/OverlayBase.ts"
-          }
-        },
-        {
-          "kind": "function",
-          "name": "noop",
-          "return": {
-            "type": {
-              "text": "void"
-            }
-          }
-        },
-        {
-          "kind": "function",
-          "name": "guaranteedTransitionend",
-          "return": {
-            "type": {
-              "text": "void"
-            }
-          },
-          "parameters": [
-            {
-              "name": "el",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "Target of the \"transition\" listeners."
-            },
-            {
-              "name": "action",
+              "name": "abortController",
               "type": {
-                "text": "Function"
-              },
-              "description": "Method to trigger the \"transition\"."
+                "text": "AbortController"
+              }
             },
-            {
-              "name": "cb",
-              "type": {
-                "text": "Function"
-              },
-              "description": "Callback to trigger when the \"transition\" has ended."
-            }
-          ],
-          "description": "Apply a \"transitionend\" listener to an element that may not transition but\nguarantee the callback will be fired either way."
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "OverlayBase",
-          "members": [
             {
               "kind": "field",
               "name": "delayed",
@@ -329,6 +558,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "An Overlay that is `delayed` will wait until a warm-up period of 1000ms\nhas completed before opening. Once the warmup period has completed, all\nsubsequent Overlays will open immediately. When no Overlays are opened,\na cooldown period of 1000ms will begin. Once the cooldown has completed,\nthe next Overlay to be opened will be subject to the warm-up period if\nprovided that option.",
               "attribute": "delayed"
             },
             {
@@ -344,22 +574,17 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the overlay is currently functional or not",
               "attribute": "disabled"
             },
             {
               "kind": "field",
               "name": "_disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "dispose",
-              "privacy": "protected",
-              "default": "noop"
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
@@ -372,7 +597,7 @@
               "kind": "field",
               "name": "parentOverlayToForceClose",
               "type": {
-                "text": "OverlayBase | undefined"
+                "text": "Overlay | undefined"
               },
               "privacy": "public"
             },
@@ -402,6 +627,14 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "isVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "offset",
@@ -409,12 +642,13 @@
                 "text": "number | [number, number]"
               },
               "default": "6",
+              "description": "The `offset` property accepts either a single number, to\ndefine the offset of the Overlay along the main axis from\nthe trigger, or 2-tuple, to define the offset along the\nmain axis and the cross axis. This option has no effect\nwhen there is no trigger element.",
               "attribute": "offset"
             },
             {
               "kind": "field",
               "name": "placementController",
-              "privacy": "public",
+              "privacy": "protected",
               "default": "new PlacementController(this)"
             },
             {
@@ -450,6 +684,7 @@
               "type": {
                 "text": "Placement | undefined"
               },
+              "description": "Instruct the Overlay where to place itself in\nrelationship to the trigger element.",
               "attribute": "placement"
             },
             {
@@ -480,12 +715,21 @@
                 "text": "HTMLSlotElement"
               }
             },
+            {
+              "kind": "field",
+              "name": "tipPadding",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "tip-padding"
+            },
             {
               "kind": "field",
               "name": "trigger",
               "type": {
                 "text": "string | undefined"
               },
+              "description": "An optional ID reference for the trigger element combined with the optional\ninteraction (click | hover | longpress) by which the overlay shold open\nthe overlay with an `@`: e.g. `trigger@click` opens the overlay when an\nelement with the ID \"trigger\" is clicked.",
               "attribute": "trigger"
             },
             {
@@ -494,14 +738,16 @@
               "type": {
                 "text": "HTMLElement | VirtualTrigger | null"
               },
-              "default": "null"
+              "default": "null",
+              "description": "An element reference for the trigger element that the overlay should relate to."
             },
             {
               "kind": "field",
               "name": "triggerInteraction",
               "type": {
                 "text": "'click' | 'longpress' | 'hover' | undefined"
-              }
+              },
+              "description": "The specific interaction to listen for on the `triggerElement` to open the overlay."
             },
             {
               "kind": "field",
@@ -545,13 +791,22 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "requiresPosition",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "readonly": true
+            },
             {
               "kind": "method",
-              "name": "manageDialogOpen",
+              "name": "managePosition",
               "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "Promise<void>"
+                  "text": "void"
                 }
               }
             },
@@ -565,24 +820,29 @@
                 }
               }
             },
-            {
-              "kind": "field",
-              "name": "requiresPosition",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "protected",
-              "readonly": true
-            },
             {
               "kind": "method",
-              "name": "managePosition",
+              "name": "applyFocus",
               "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "focusEl",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -610,15 +870,7 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "triggerElement",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ]
+              }
             },
             {
               "kind": "method",
@@ -774,7 +1026,8 @@
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false"
+              "default": "false",
+              "description": "An overlay with a `click` interaction should not close on click `triggerElement`.\nWhen a click is initiated (`pointerdown`), apply `preventNextToggle` when the\noverlay is `open` to prevent from toggling the overlay when the click event\npropagates later in the interaction."
             },
             {
               "kind": "field",
@@ -911,6 +1164,15 @@
                 }
               }
             },
+            {
+              "kind": "field",
+              "name": "dialogStyleMap",
+              "type": {
+                "text": "StyleInfo"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "renderDialog",
@@ -932,6 +1194,16 @@
               }
             }
           ],
+          "events": [
+            {
+              "description": "announces that an overlay has completed any entry animations",
+              "name": "sp-opened"
+            },
+            {
+              "description": "announce that an overlay has compelted any exit animations",
+              "name": "sp-closed"
+            }
+          ],
           "attributes": [
             {
               "name": "delayed",
@@ -939,6 +1211,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "An Overlay that is `delayed` will wait until a warm-up period of 1000ms\nhas completed before opening. Once the warmup period has completed, all\nsubsequent Overlays will open immediately. When no Overlays are opened,\na cooldown period of 1000ms will begin. Once the cooldown has completed,\nthe next Overlay to be opened will be subject to the warm-up period if\nprovided that option.",
               "fieldName": "delayed"
             },
             {
@@ -946,6 +1219,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the overlay is currently functional or not",
               "fieldName": "disabled"
             },
             {
@@ -954,6 +1228,7 @@
                 "text": "number | [number, number]"
               },
               "default": "6",
+              "description": "The `offset` property accepts either a single number, to\ndefine the offset of the Overlay along the main axis from\nthe trigger, or 2-tuple, to define the offset along the\nmain axis and the cross axis. This option has no effect\nwhen there is no trigger element.",
               "fieldName": "offset"
             },
             {
@@ -968,6 +1243,7 @@
               "type": {
                 "text": "Placement | undefined"
               },
+              "description": "Instruct the Overlay where to place itself in\nrelationship to the trigger element.",
               "fieldName": "placement"
             },
             {
@@ -978,11 +1254,19 @@
               "default": "'auto'",
               "fieldName": "receivesFocus"
             },
+            {
+              "name": "tip-padding",
+              "type": {
+                "text": "number | undefined"
+              },
+              "fieldName": "tipPadding"
+            },
             {
               "name": "trigger",
               "type": {
                 "text": "string | undefined"
               },
+              "description": "An optional ID reference for the trigger element combined with the optional\ninteraction (click | hover | longpress) by which the overlay shold open\nthe overlay with an `@`: e.g. `trigger@click` opens the overlay when an\nelement with the ID \"trigger\" is clicked.",
               "fieldName": "trigger"
             },
             {
@@ -995,66 +1279,28 @@
             }
           ],
           "superclass": {
-            "name": "SpectrumElement",
-            "package": "@spectrum-web-components/base"
-          }
+            "name": "OverlayFeatures",
+            "module": "src/Overlay.ts"
+          },
+          "tagName": "sp-overlay",
+          "customElement": true
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "overlayTimer",
-          "declaration": {
-            "name": "overlayTimer",
-            "module": "src/OverlayBase.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "LONGPRESS_INSTRUCTIONS",
           "declaration": {
             "name": "LONGPRESS_INSTRUCTIONS",
-            "module": "src/OverlayBase.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "BeforetoggleClosedEvent",
-          "declaration": {
-            "name": "BeforetoggleClosedEvent",
-            "module": "src/OverlayBase.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "BeforetoggleOpenEvent",
-          "declaration": {
-            "name": "BeforetoggleOpenEvent",
-            "module": "src/OverlayBase.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "noop",
-          "declaration": {
-            "name": "noop",
-            "module": "src/OverlayBase.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "guaranteedTransitionend",
-          "declaration": {
-            "name": "guaranteedTransitionend",
-            "module": "src/OverlayBase.ts"
+            "module": "src/Overlay.ts"
           }
         },
         {
           "kind": "js",
-          "name": "OverlayBase",
+          "name": "Overlay",
           "declaration": {
-            "name": "OverlayBase",
-            "module": "src/OverlayBase.ts"
+            "name": "Overlay",
+            "module": "src/Overlay.ts"
           }
         }
       ]
@@ -1078,16 +1324,6 @@
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "dialogEnsureOnDOM",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "dialogMakeTransition",
@@ -1187,7 +1423,7 @@
             {
               "kind": "method",
               "name": "manageDelay",
-              "privacy": "private",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "Promise<void>"
@@ -1205,25 +1441,15 @@
             {
               "kind": "method",
               "name": "ensureOnDOM",
-              "privacy": "private",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "Promise<void>"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "makeTransition",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<HTMLElement | null>"
-                }
               },
               "parameters": [
                 {
-                  "name": "targetOpenState",
+                  "name": "_targetOpenState",
                   "type": {
                     "text": "boolean"
                   }
@@ -1232,11 +1458,11 @@
             },
             {
               "kind": "method",
-              "name": "applyFocus",
-              "privacy": "private",
+              "name": "makeTransition",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "Promise<void>"
+                  "text": "Promise<HTMLElement | null>"
                 }
               },
               "parameters": [
@@ -1245,12 +1471,6 @@
                   "type": {
                     "text": "boolean"
                   }
-                },
-                {
-                  "name": "focusEl",
-                  "type": {
-                    "text": "HTMLElement | null"
-                  }
                 }
               ]
             }
@@ -1300,17 +1520,25 @@
           "members": [
             {
               "kind": "method",
-              "name": "managePopoverOpen",
+              "name": "manageDelay",
               "privacy": "protected",
               "return": {
                 "type": {
                   "text": "Promise<void>"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "manageDelay",
+              "name": "shouldHidePopover",
               "privacy": "private",
               "return": {
                 "type": {
@@ -1328,7 +1556,7 @@
             },
             {
               "kind": "method",
-              "name": "ensureOnDOM",
+              "name": "shouldShowPopover",
               "privacy": "private",
               "return": {
                 "type": {
@@ -1346,11 +1574,11 @@
             },
             {
               "kind": "method",
-              "name": "makeTransition",
-              "privacy": "private",
+              "name": "ensureOnDOM",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "Promise<HTMLElement | null>"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
@@ -1364,11 +1592,11 @@
             },
             {
               "kind": "method",
-              "name": "applyFocus",
-              "privacy": "private",
+              "name": "makeTransition",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "Promise<void>"
+                  "text": "Promise<HTMLElement | null>"
                 }
               },
               "parameters": [
@@ -1377,12 +1605,6 @@
                   "type": {
                     "text": "boolean"
                   }
-                },
-                {
-                  "name": "focusEl",
-                  "type": {
-                    "text": "HTMLElement | null"
-                  }
                 }
               ]
             }
@@ -1446,14 +1668,6 @@
       "kind": "javascript-module",
       "path": "src/OverlayTrigger.ts",
       "declarations": [
-        {
-          "kind": "variable",
-          "name": "LONGPRESS_INSTRUCTIONS",
-          "type": {
-            "text": "object"
-          },
-          "default": "{\n    touch: 'Double tap and long press for additional options',\n    keyboard: 'Press Space or Alt+Down Arrow for additional options',\n    mouse: 'Click and hold for additional options',\n}"
-        },
         {
           "kind": "class",
           "description": "",
@@ -1481,7 +1695,7 @@
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "\"auto\" | \"auto-start\" | \"auto-end\" | \"top\" | \"bottom\" | \"right\" | \"left\" | \"top-start\" | \"top-end\" | \"bottom-start\" | \"bottom-end\" | \"right-start\" | \"right-end\" | \"left-start\" | \"left-end\" | \"none\""
+                "text": "\"auto\" | \"auto-start\" | \"auto-end\" | \"top\" | \"bottom\" | \"right\" | \"left\" | \"top-start\" | \"top-end\" | \"bottom-start\" | \"bottom-end\" | \"right-start\" | \"right-end\" | \"left-start\" | \"left-end\""
               },
               "privacy": "public",
               "attribute": "placement",
@@ -1527,23 +1741,6 @@
               "attribute": "disabled",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "hasLongpressContent",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "longpressDescriptor",
-              "type": {
-                "text": "HTMLElement | undefined"
-              },
-              "privacy": "private"
-            },
             {
               "kind": "field",
               "name": "clickContent",
@@ -1608,21 +1805,21 @@
               "kind": "field",
               "name": "clickOverlayElement",
               "type": {
-                "text": "OverlayBase"
+                "text": "Overlay"
               }
             },
             {
               "kind": "field",
               "name": "longpressOverlayElement",
               "type": {
-                "text": "OverlayBase"
+                "text": "Overlay"
               }
             },
             {
               "kind": "field",
               "name": "hoverOverlayElement",
               "type": {
-                "text": "OverlayBase"
+                "text": "Overlay"
               }
             },
             {
@@ -1739,16 +1936,6 @@
                 }
               ]
             },
-            {
-              "kind": "method",
-              "name": "manageLongpressDescriptor",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "getUpdateComplete",
@@ -1774,7 +1961,7 @@
             {
               "name": "placement",
               "type": {
-                "text": "\"auto\" | \"auto-start\" | \"auto-end\" | \"top\" | \"bottom\" | \"right\" | \"left\" | \"top-start\" | \"top-end\" | \"bottom-start\" | \"bottom-end\" | \"right-start\" | \"right-end\" | \"left-start\" | \"left-end\" | \"none\""
+                "text": "\"auto\" | \"auto-start\" | \"auto-end\" | \"top\" | \"bottom\" | \"right\" | \"left\" | \"top-start\" | \"top-end\" | \"bottom-start\" | \"bottom-end\" | \"right-start\" | \"right-end\" | \"left-start\" | \"left-end\""
               },
               "fieldName": "placement",
               "attribute": "placement"
@@ -1819,14 +2006,6 @@
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "LONGPRESS_INSTRUCTIONS",
-          "declaration": {
-            "name": "LONGPRESS_INSTRUCTIONS",
-            "module": "src/OverlayTrigger.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "OverlayTrigger",
@@ -1929,6 +2108,14 @@
                 }
               ]
             },
+            {
+              "kind": "field",
+              "name": "updateCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0"
+            },
             {
               "kind": "field",
               "name": "updatePlacement"