@spectrum-web-components/overlay 0.36.0 → 0.37.0

package/custom-elements.json

@@ -2,6 +2,21 @@
   "schemaVersion": "1.0.0",
   "readme": "",
   "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "sp-overlay.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "sp-overlay",
+          "declaration": {
+            "name": "Overlay",
+            "module": "/src/Overlay.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "overlay-trigger.js",
@@ -21,165 +36,269 @@
       "kind": "javascript-module",
       "path": "sync/overlay-trigger.js",
       "declarations": [],
-      "exports": []
+      "exports": [
+        {
+          "kind": "js",
+          "name": "OverlayTrigger",
+          "declaration": {
+            "name": "OverlayTrigger",
+            "module": "sync/overlay-trigger.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "OverlayOptionsV1",
+          "declaration": {
+            "name": "OverlayOptionsV1",
+            "module": "sync/overlay-trigger.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "TriggerInteractions",
+          "declaration": {
+            "name": "TriggerInteractions",
+            "module": "sync/overlay-trigger.js"
+          }
+        }
+      ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/ActiveOverlay.js",
+      "path": "src/AbstractOverlay.js",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "overlayTimer",
+          "default": "new OverlayTimer()"
+        },
+        {
+          "kind": "function",
+          "name": "noop",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          }
+        },
         {
           "kind": "class",
           "description": "",
-          "name": "ActiveOverlay",
-          "slots": [
-            {
-              "description": "content to display in the overlay",
-              "name": ""
-            }
-          ],
+          "name": "BeforetoggleClosedEvent",
           "members": [
             {
               "kind": "field",
-              "name": "overlayContent",
+              "name": "currentState",
               "type": {
-                "text": "HTMLElement"
+                "text": "string"
               },
-              "privacy": "public"
+              "default": "'open'"
             },
             {
               "kind": "field",
-              "name": "overlayContentTip",
+              "name": "newState",
               "type": {
-                "text": "HTMLElement | undefined"
+                "text": "string"
               },
-              "privacy": "public"
-            },
+              "default": "'closed'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "BeforetoggleOpenEvent",
+          "members": [
             {
               "kind": "field",
-              "name": "trigger",
+              "name": "currentState",
               "type": {
-                "text": "HTMLElement"
+                "text": "string"
               },
-              "privacy": "public"
+              "default": "'closed'"
             },
             {
               "kind": "field",
-              "name": "root",
+              "name": "newState",
               "type": {
-                "text": "HTMLElement | undefined"
+                "text": "string"
               },
-              "privacy": "public"
-            },
+              "default": "'open'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/AbstractOverlay.ts"
+          }
+        },
+        {
+          "kind": "function",
+          "name": "guaranteedAllTransitionend",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "virtualTrigger",
+              "name": "el",
               "type": {
-                "text": "VirtualTrigger | undefined"
+                "text": "HTMLElement"
               },
-              "privacy": "public"
+              "description": "Target of the \"transition\" listeners."
             },
             {
-              "kind": "field",
-              "name": "cleanup",
+              "name": "action",
               "type": {
-                "text": "() => void | undefined"
+                "text": "Function"
               },
-              "privacy": "private"
+              "description": "Method to trigger the \"transition\"."
             },
             {
-              "kind": "field",
-              "name": "contentAnimationPromise",
+              "name": "cb",
               "type": {
-                "text": "Promise<boolean>"
+                "text": "Function"
               },
-              "privacy": "protected"
-            },
-            {
-              "kind": "field",
-              "name": "resolveContentAnimationPromise",
-              "privacy": "protected"
-            },
-            {
-              "kind": "field",
-              "name": "_state",
-              "privacy": "public",
-              "attribute": "_state"
-            },
+              "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": "function",
+          "name": "forcePaint",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          }
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AbstractOverlay",
+          "members": [
             {
-              "kind": "field",
-              "name": "state",
-              "type": {
-                "text": "OverlayStateType"
+              "kind": "method",
+              "name": "applyFocus",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
               },
-              "privacy": "public"
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "_focusEl",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                }
+              ]
             },
             {
               "kind": "field",
-              "name": "animating",
+              "name": "delayed",
               "type": {
                 "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "attribute": "animating",
-              "reflects": true
+              }
             },
             {
               "kind": "field",
-              "name": "placement",
+              "name": "dialogEl",
               "type": {
-                "text": "Placement | undefined"
-              },
-              "privacy": "public",
-              "attribute": "placement",
-              "reflects": true
+                "text": "HTMLDialogElement & {\n        showPopover(): void;\n        hidePopover(): void;\n    }"
+              }
             },
             {
               "kind": "field",
-              "name": "theme",
-              "type": {
-                "text": "{\n        color?: Color;\n        scale?: Scale;\n        lang?: string;\n        theme?: ThemeVariant;\n    }"
-              },
-              "privacy": "public",
-              "default": "{}"
+              "name": "dispose",
+              "default": "noop"
             },
             {
-              "kind": "field",
-              "name": "receivesFocus",
-              "type": {
-                "text": "'auto' | undefined"
+              "kind": "method",
+              "name": "ensureOnDOM",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
               },
-              "privacy": "public"
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
             },
             {
               "kind": "field",
-              "name": "tabbingAway",
+              "name": "elements",
               "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false"
+                "text": "OpenableElement[]"
+              }
             },
             {
-              "kind": "field",
-              "name": "originalPlacement",
-              "type": {
-                "text": "Placement | undefined"
+              "kind": "method",
+              "name": "makeTransition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<HTMLElement | null>"
+                }
               },
-              "privacy": "private"
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "restoreContent",
-              "type": {
-                "text": "() => Element[] | undefined"
+              "kind": "method",
+              "name": "manageDelay",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
               },
-              "privacy": "private"
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "focus",
-              "privacy": "public",
+              "name": "manageDialogOpen",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "Promise<void>"
@@ -187,78 +306,79 @@
               }
             },
             {
-              "kind": "field",
-              "name": "hasTheme",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "readonly": true
+              "kind": "method",
+              "name": "managePopoverOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "managePosition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "field",
-              "name": "offset",
+              "name": "open",
               "type": {
-                "text": "number"
-              },
-              "privacy": "public",
-              "default": "6"
+                "text": "boolean"
+              }
             },
             {
               "kind": "field",
-              "name": "skidding",
+              "name": "placementController",
               "type": {
-                "text": "number"
+                "text": "PlacementController"
               },
-              "privacy": "public",
-              "default": "0"
+              "privacy": "protected"
             },
             {
               "kind": "field",
-              "name": "interaction",
+              "name": "receivesFocus",
               "type": {
-                "text": "TriggerInteractions"
-              },
-              "privacy": "public",
-              "default": "'hover'"
+                "text": "'true' | 'false' | 'auto'"
+              }
             },
             {
               "kind": "field",
-              "name": "positionAnimationFrame",
+              "name": "state",
               "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
+                "text": "OverlayState"
+              }
             },
             {
               "kind": "field",
-              "name": "timeout",
+              "name": "_state",
               "type": {
-                "text": "number | undefined"
+                "text": "OverlayState"
               },
-              "privacy": "private"
+              "privacy": "protected"
             },
             {
               "kind": "field",
-              "name": "_modalRoot",
+              "name": "triggerElement",
               "type": {
-                "text": "ActiveOverlay | undefined"
-              },
-              "privacy": "private"
+                "text": "HTMLElement | VirtualTrigger | null"
+              }
             },
             {
               "kind": "field",
-              "name": "hasModalRoot",
+              "name": "type",
               "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "readonly": true
+                "text": "OverlayTypes"
+              }
             },
             {
               "kind": "method",
-              "name": "feature",
+              "name": "manuallyKeepOpen",
               "privacy": "public",
               "return": {
                 "type": {
@@ -268,36 +388,37 @@
             },
             {
               "kind": "method",
-              "name": "obscure",
+              "name": "open",
               "privacy": "public",
+              "static": true,
               "return": {
                 "type": {
-                  "text": "ActiveOverlay | undefined"
+                  "text": "Promise<() => void>"
                 }
               },
               "parameters": [
                 {
-                  "name": "nextOverlayInteraction",
+                  "name": "trigger",
                   "type": {
-                    "text": "TriggerInteractions"
+                    "text": "HTMLElement"
                   }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "openCallback",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              },
-              "parameters": [
+                },
+                {
+                  "name": "interaction",
+                  "type": {
+                    "text": "TriggerInteractionsV1"
+                  }
+                },
+                {
+                  "name": "content",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
                 {
-                  "name": "lifecycleCallback",
+                  "name": "optionsV1",
                   "type": {
-                    "text": "() => Promise<void> | void"
+                    "text": "OverlayOptionsV1"
                   }
                 }
               ]
@@ -305,70 +426,195 @@
             {
               "kind": "method",
               "name": "open",
-              "privacy": "private",
+              "privacy": "public",
+              "static": true,
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<Overlay>"
                 }
               },
               "parameters": [
                 {
-                  "name": "openDetail",
+                  "name": "content",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
                   "type": {
-                    "text": "OverlayOpenDetail"
+                    "text": "OverlayOptions"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "extractDetail",
-              "privacy": "private",
+              "name": "open",
+              "privacy": "public",
+              "static": true,
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<Overlay | (() => void)>"
                 }
               },
               "parameters": [
                 {
-                  "name": "detail",
+                  "name": "triggerOrContent",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "interactionOrOptions",
+                  "type": {
+                    "text": "| TriggerInteractionsV1\n            | OverlayOptions\n            | undefined"
+                  }
+                },
+                {
+                  "name": "content",
+                  "optional": true,
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "optionsV1",
+                  "optional": true,
                   "type": {
-                    "text": "OverlayOpenDetail"
+                    "text": "OverlayOptionsV1"
                   }
                 }
               ]
+            }
+          ],
+          "superclass": {
+            "name": "SpectrumElement",
+            "package": "@spectrum-web-components/base"
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "overlayTimer",
+          "declaration": {
+            "name": "overlayTimer",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "noop",
+          "declaration": {
+            "name": "noop",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BeforetoggleClosedEvent",
+          "declaration": {
+            "name": "BeforetoggleClosedEvent",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BeforetoggleOpenEvent",
+          "declaration": {
+            "name": "BeforetoggleOpenEvent",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "guaranteedAllTransitionend",
+          "declaration": {
+            "name": "guaranteedAllTransitionend",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "nextFrame",
+          "declaration": {
+            "name": "nextFrame",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "forcePaint",
+          "declaration": {
+            "name": "forcePaint",
+            "module": "src/AbstractOverlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AbstractOverlay",
+          "declaration": {
+            "name": "AbstractOverlay",
+            "module": "src/AbstractOverlay.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/Overlay.js",
+      "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": "",
+          "name": "Overlay",
+          "members": [
+            {
+              "kind": "field",
+              "name": "abortController",
+              "type": {
+                "text": "AbortController"
+              }
             },
             {
-              "kind": "method",
-              "name": "dispose",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "delayed",
+              "type": {
+                "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"
+            },
+            {
+              "kind": "field",
+              "name": "dialogEl",
+              "type": {
+                "text": "HTMLDialogElement & {\n        showPopover(): void;\n        hidePopover(): void;\n    }"
               }
             },
             {
-              "kind": "method",
-              "name": "stealOverlayContent",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
               },
-              "parameters": [
-                {
-                  "name": "element",
-                  "type": {
-                    "text": "HTMLElement & { placement: Placement }"
-                  }
-                }
-              ]
+              "description": "Whether the overlay is currently functional or not",
+              "attribute": "disabled"
             },
             {
               "kind": "field",
-              "name": "willNotifyClosed",
+              "name": "_disabled",
               "type": {
                 "text": "boolean"
               },
@@ -376,26 +622,75 @@
               "default": "false"
             },
             {
-              "kind": "method",
-              "name": "returnOverlayContent",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "elements",
+              "type": {
+                "text": "OpenableElement[]"
               }
             },
             {
               "kind": "field",
-              "name": "initialHeight",
+              "name": "parentOverlayToForceClose",
               "type": {
-                "text": "number | undefined"
+                "text": "Overlay | undefined"
+              },
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "hasNonVirtualTrigger",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "longpressState",
+              "type": {
+                "text": "'null' | 'potential' | 'opening' | 'pressed'"
+              },
+              "privacy": "protected",
+              "default": "'null'"
+            },
+            {
+              "kind": "field",
+              "name": "longressTimeout",
+              "type": {
+                "text": "ReturnType<typeof setTimeout>"
               },
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "isConstrained",
+              "name": "offset",
+              "type": {
+                "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": "protected",
+              "default": "new PlacementController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the Overlay is projected onto the \"top layer\" or not.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_open",
               "type": {
                 "text": "boolean"
               },
@@ -403,34 +698,885 @@
               "default": "false"
             },
             {
-              "kind": "method",
-              "name": "placeOverlay",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
+              "kind": "field",
+              "name": "openCount",
+              "type": {
+                "text": "number"
+              },
+              "static": true,
+              "default": "1"
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\""
+              },
+              "description": "Instruct the Overlay where to place itself in\nrelationship to the trigger element.",
+              "attribute": "placement"
+            },
+            {
+              "kind": "field",
+              "name": "receivesFocus",
+              "type": {
+                "text": "'true' | 'false' | 'auto'"
+              },
+              "default": "'auto'",
+              "description": "Whether to pass focus to the overlay once opened, or\nto the appropriate value based on the \"type\" of the overlay\nwhen set to `\"auto\"`.",
+              "attribute": "receives-focus"
+            },
+            {
+              "kind": "field",
+              "name": "releaseAriaDescribedby",
+              "privacy": "private",
+              "default": "noop"
+            },
+            {
+              "kind": "field",
+              "name": "releaseLongpressDescribedby",
+              "privacy": "private",
+              "default": "noop"
+            },
+            {
+              "kind": "field",
+              "name": "slotEl",
+              "type": {
+                "text": "HTMLSlotElement"
               }
             },
             {
               "kind": "field",
-              "name": "updateOverlayPosition",
-              "privacy": "public"
+              "name": "state",
+              "type": {
+                "text": "OverlayState"
+              }
             },
             {
               "kind": "field",
-              "name": "resetOverlayPosition",
-              "privacy": "public"
+              "name": "_state",
+              "type": {
+                "text": "OverlayState"
+              },
+              "default": "'closed'"
             },
             {
               "kind": "field",
-              "name": "setOverlayPosition",
-              "privacy": "public"
+              "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"
+            },
+            {
+              "kind": "field",
+              "name": "triggerElement",
+              "type": {
+                "text": "HTMLElement | VirtualTrigger | 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",
+              "name": "type",
+              "type": {
+                "text": "\"auto\" | \"hint\" | \"manual\" | \"modal\" | \"page\""
+              },
+              "default": "'auto'",
+              "description": "Configures the open/close heuristics of the Overlay.",
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "wasOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "elementResolver",
+              "privacy": "private",
+              "default": "new ElementResolutionController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "usesDialog",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "popoverValue",
+              "type": {
+                "text": "'auto' | 'manual' | undefined"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "requiresPosition",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "managePosition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "managePopoverOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "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": "closeOnFocusOut",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "manageOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "oldOpen",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "unbindEvents",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "bindEvents",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "bindClickEvents",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "triggerElement",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "bindLongpressEvents",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "triggerElement",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "bindHoverEvents",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "triggerElement",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "manageTriggerElement",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "triggerElement",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "elementIds",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "method",
+              "name": "prepareLongpressDescription",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "trigger",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "prepareAriaDescribedby",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerdown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerup",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleKeydown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleKeyup",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "preventNextToggle",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "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",
+              "name": "handlePointerdownForClick",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "handleClick",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "focusedin",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "handleFocusin",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "handleFocusout",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "pointerentered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerenter",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerleave",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "handleOverlayPointerleave",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "doPointerleave",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleLongpress",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "handleBeforetoggle",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event & { newState: string }"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleBrowserClose",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "manuallyKeepOpen",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleSlotchange",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "willPreventClose",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "shouldPreventClose",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderContent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dialogStyleMap",
+              "type": {
+                "text": "StyleInfo"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "renderDialog",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderPopover",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            }
+          ],
+          "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",
+              "type": {
+                "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"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the overlay is currently functional or not",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "offset",
+              "type": {
+                "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"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the Overlay is projected onto the \"top layer\" or not.",
+              "fieldName": "open"
+            },
+            {
+              "name": "placement",
+              "type": {
+                "text": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\""
+              },
+              "description": "Instruct the Overlay where to place itself in\nrelationship to the trigger element.",
+              "fieldName": "placement"
+            },
+            {
+              "name": "receives-focus",
+              "type": {
+                "text": "'true' | 'false' | 'auto'"
+              },
+              "default": "'auto'",
+              "description": "Whether to pass focus to the overlay once opened, or\nto the appropriate value based on the \"type\" of the overlay\nwhen set to `\"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"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "\"auto\" | \"hint\" | \"manual\" | \"modal\" | \"page\""
+              },
+              "default": "'auto'",
+              "description": "Configures the open/close heuristics of the Overlay.",
+              "fieldName": "type"
+            }
+          ],
+          "superclass": {
+            "name": "OverlayFeatures",
+            "module": "src/Overlay.ts"
+          },
+          "tagName": "sp-overlay",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LONGPRESS_INSTRUCTIONS",
+          "declaration": {
+            "name": "LONGPRESS_INSTRUCTIONS",
+            "module": "src/Overlay.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Overlay",
+          "declaration": {
+            "name": "Overlay",
+            "module": "src/Overlay.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/OverlayDialog.js",
+      "declarations": [
+        {
+          "kind": "mixin",
+          "description": "",
+          "name": "OverlayDialog",
+          "members": [
+            {
+              "kind": "method",
+              "name": "manageDialogOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dialogMakeTransition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<HTMLElement | null>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "dialogApplyFocus",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "focusEl",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "event"
+              }
+            },
+            {
+              "name": "eventName",
+              "type": {
+                "text": "Event"
+              }
+            }
+          ],
+          "parameters": [
+            {
+              "name": "constructor",
+              "type": {
+                "text": "T"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "OverlayDialog",
+          "declaration": {
+            "name": "OverlayDialog",
+            "module": "src/OverlayDialog.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/OverlayNoPopover.js",
+      "declarations": [
+        {
+          "kind": "mixin",
+          "description": "",
+          "name": "OverlayNoPopover",
+          "members": [
+            {
+              "kind": "method",
+              "name": "managePopoverOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "manageDelay",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "ensureOnDOM",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "makeTransition",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<HTMLElement | null>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "event"
+              }
+            },
+            {
+              "name": "eventName",
+              "type": {
+                "text": "Event"
+              }
+            }
+          ],
+          "parameters": [
+            {
+              "name": "constructor",
+              "type": {
+                "text": "T"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "OverlayNoPopover",
+          "declaration": {
+            "name": "OverlayNoPopover",
+            "module": "src/OverlayNoPopover.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/OverlayPopover.js",
+      "declarations": [
+        {
+          "kind": "mixin",
+          "description": "",
+          "name": "OverlayPopover",
+          "members": [
             {
               "kind": "method",
-              "name": "hide",
-              "privacy": "public",
+              "name": "manageDelay",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "Promise<void>"
@@ -438,168 +1584,145 @@
               },
               "parameters": [
                 {
-                  "name": "animated",
-                  "default": "true"
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "schedulePositionUpdate",
+              "name": "shouldHidePopover",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "onSlotChange",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
+              },
+              "parameters": [
+                {
+                  "name": "targetOpenState",
+                  "type": {
+                    "text": "boolean"
+                  }
                 }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "handleInlineTriggerKeydown",
-              "privacy": "public"
+              ]
             },
             {
               "kind": "method",
-              "name": "applyContentAnimation",
-              "privacy": "public",
+              "name": "shouldShowPopover",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<boolean>"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
                 {
-                  "name": "animation",
+                  "name": "targetOpenState",
                   "type": {
-                    "text": "ContentAnimation"
+                    "text": "boolean"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "renderTheme",
-              "privacy": "public",
+              "name": "ensureOnDOM",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "TemplateResult"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
                 {
-                  "name": "content",
+                  "name": "targetOpenState",
                   "type": {
-                    "text": "TemplateResult"
+                    "text": "boolean"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "create",
-              "privacy": "public",
-              "static": true,
+              "name": "makeTransition",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "ActiveOverlay"
+                  "text": "Promise<HTMLElement | null>"
                 }
               },
               "parameters": [
                 {
-                  "name": "details",
+                  "name": "targetOpenState",
                   "type": {
-                    "text": "OverlayOpenDetail"
+                    "text": "boolean"
                   }
                 }
               ]
-            },
-            {
-              "kind": "field",
-              "name": "stealOverlayContentPromise",
-              "privacy": "private",
-              "default": "new Promise(\n            (res) => (this.stealOverlayContentResolver = res)\n        )"
-            },
+            }
+          ],
+          "events": [
             {
-              "kind": "field",
-              "name": "stealOverlayContentResolver",
               "type": {
-                "text": "() => void"
-              },
-              "privacy": "private"
+                "text": "event"
+              }
             },
             {
-              "kind": "method",
-              "name": "getUpdateComplete",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "Promise<boolean>"
-                }
+              "name": "eventName",
+              "type": {
+                "text": "Event"
               }
             }
           ],
-          "attributes": [
-            {
-              "name": "_state",
-              "fieldName": "_state"
-            },
-            {
-              "name": "animating",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "animating"
-            },
+          "parameters": [
             {
-              "name": "placement",
+              "name": "constructor",
               "type": {
-                "text": "Placement | undefined"
-              },
-              "fieldName": "placement"
+                "text": "T"
+              }
             }
-          ],
-          "superclass": {
-            "name": "SpectrumElement",
-            "package": "@spectrum-web-components/base"
-          },
-          "tagName": "active-overlay",
-          "customElement": true
+          ]
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ActiveOverlay",
+          "name": "OverlayPopover",
           "declaration": {
-            "name": "ActiveOverlay",
-            "module": "src/ActiveOverlay.js"
+            "name": "OverlayPopover",
+            "module": "src/OverlayPopover.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/OverlayTrigger.js",
+      "path": "src/OverlayStack.js",
       "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}"
-        },
+          "name": "overlayStack",
+          "default": "new OverlayStack()"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "overlayStack",
+          "declaration": {
+            "name": "overlayStack",
+            "module": "src/OverlayStack.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/OverlayTrigger.js",
+      "declarations": [
         {
           "kind": "class",
           "description": "",
@@ -625,36 +1748,20 @@
           "members": [
             {
               "kind": "field",
-              "name": "closeClickOverlay",
-              "type": {
-                "text": "Promise<() => void> | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "closeLongpressOverlay",
-              "type": {
-                "text": "Promise<() => void> | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "closeHoverOverlay",
+              "name": "content",
               "type": {
-                "text": "Promise<() => void> | undefined"
+                "text": "string"
               },
-              "privacy": "private"
+              "default": "'click hover longpress'",
+              "attribute": "content"
             },
             {
               "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": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\""
               },
               "privacy": "public",
-              "default": "'bottom'",
               "attribute": "placement",
               "reflects": true
             },
@@ -675,8 +1782,7 @@
               },
               "privacy": "public",
               "default": "6",
-              "attribute": "offset",
-              "reflects": true
+              "attribute": "offset"
             },
             {
               "kind": "field",
@@ -699,272 +1805,108 @@
               "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",
               "type": {
-                "text": "HTMLElement | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "longpressContent",
-              "type": {
-                "text": "HTMLElement | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "hoverContent",
-              "type": {
-                "text": "HTMLElement | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "targetContent",
-              "type": {
-                "text": "HTMLElement | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "overlaidContent",
-              "type": {
-                "text": "HTMLElement | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_longpressId",
-              "privacy": "private",
-              "default": "`longpress-describedby-descriptor`"
-            },
-            {
-              "kind": "method",
-              "name": "handleClose",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+                "text": "HTMLElement[]"
               },
-              "parameters": [
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "CustomEvent<OverlayOpenCloseDetail>"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "manageLongpressDescriptor",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "closeAllOverlays",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "manageOpen",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "openOverlay",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<() => void>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "target",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                },
-                {
-                  "name": "interaction",
-                  "type": {
-                    "text": "TriggerInteractions"
-                  }
-                },
-                {
-                  "name": "content",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                },
-                {
-                  "name": "options",
-                  "type": {
-                    "text": "OverlayOptions"
-                  }
-                }
-              ]
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "openOverlay",
-              "privacy": "public",
-              "static": true
+              "name": "clickPlacement",
+              "type": {
+                "text": "Placement | undefined"
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "overlayOptions",
+              "name": "longpressContent",
               "type": {
-                "text": "OverlayOptions"
+                "text": "HTMLElement[]"
               },
               "privacy": "private",
-              "readonly": true
+              "default": "[]"
             },
             {
-              "kind": "method",
-              "name": "onTrigger",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "longpressPlacement",
+              "type": {
+                "text": "Placement | undefined"
               },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "CustomEvent<LongpressEvent>"
-                  }
-                }
-              ]
+              "privacy": "private"
             },
             {
-              "kind": "method",
-              "name": "prepareToFocusOverlayContent",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "hoverContent",
+              "type": {
+                "text": "HTMLElement[]"
               },
-              "parameters": [
-                {
-                  "name": "overlayContent",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "onTriggerClick",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              }
+              "privacy": "private",
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "_longpressEvent",
+              "name": "hoverPlacement",
               "type": {
-                "text": "CustomEvent<LongpressEvent> | undefined"
+                "text": "Placement | undefined"
               },
               "privacy": "private"
             },
             {
-              "kind": "method",
-              "name": "onTriggerLongpress",
+              "kind": "field",
+              "name": "targetContent",
+              "type": {
+                "text": "HTMLElement[]"
+              },
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "clickOverlayElement",
+              "type": {
+                "text": "Overlay"
               }
             },
             {
               "kind": "field",
-              "name": "abortOverlay",
+              "name": "longpressOverlayElement",
               "type": {
-                "text": "(cancelled: boolean) => void"
-              },
-              "privacy": "private"
+                "text": "Overlay"
+              }
             },
             {
-              "kind": "method",
-              "name": "onTriggerMouseEnter",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
+              "kind": "field",
+              "name": "hoverOverlayElement",
+              "type": {
+                "text": "Overlay"
               }
             },
             {
               "kind": "method",
-              "name": "onClickSlotChange",
+              "name": "getAssignedElementsFromSlot",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "HTMLElement[]"
                 }
               },
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "slot",
                   "type": {
-                    "text": "Event & { target: HTMLSlotElement }"
+                    "text": "HTMLSlotElement"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "onLongpressSlotChange",
+              "name": "handleTriggerContent",
               "privacy": "private",
               "return": {
                 "type": {
@@ -982,7 +1924,7 @@
             },
             {
               "kind": "method",
-              "name": "onHoverSlotChange",
+              "name": "handleSlotContent",
               "privacy": "private",
               "return": {
                 "type": {
@@ -1000,7 +1942,7 @@
             },
             {
               "kind": "method",
-              "name": "onTargetSlotChange",
+              "name": "handleBeforetoggle",
               "privacy": "private",
               "return": {
                 "type": {
@@ -1011,41 +1953,58 @@
                 {
                   "name": "event",
                   "type": {
-                    "text": "Event & { target: HTMLSlotElement }"
+                    "text": "BeforetoggleOpenEvent"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "extractSlotContentFromEvent",
-              "privacy": "private",
+              "name": "renderSlot",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "HTMLElement | undefined"
+                  "text": "TemplateResult"
                 }
               },
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "name",
                   "type": {
-                    "text": "Event"
+                    "text": "string"
                   }
                 }
               ]
             },
             {
-              "kind": "field",
-              "name": "openStatePromise",
-              "privacy": "private"
+              "kind": "method",
+              "name": "renderClickOverlay",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
             },
             {
-              "kind": "field",
-              "name": "openStateResolver",
-              "type": {
-                "text": "() => void"
-              },
-              "privacy": "private"
+              "kind": "method",
+              "name": "renderHoverOverlay",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderLongpressOverlay",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
             },
             {
               "kind": "method",
@@ -1072,12 +2031,19 @@
             {
               "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": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\""
               },
-              "default": "'bottom'",
               "fieldName": "placement",
               "attribute": "placement"
             },
+            {
+              "name": "content",
+              "type": {
+                "text": "string"
+              },
+              "default": "'click hover longpress'",
+              "fieldName": "content"
+            },
             {
               "name": "type",
               "type": {
@@ -1120,18 +2086,177 @@
       "exports": [
         {
           "kind": "js",
-          "name": "LONGPRESS_INSTRUCTIONS",
+          "name": "OverlayTrigger",
           "declaration": {
-            "name": "LONGPRESS_INSTRUCTIONS",
+            "name": "OverlayTrigger",
             "module": "src/OverlayTrigger.js"
           }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/PlacementController.js",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "placementUpdatedSymbol"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "PlacementController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "cleanup",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "initialHeight",
+              "type": {
+                "text": "number | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isConstrained",
+              "type": {
+                "text": "boolean | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "host",
+              "type": {
+                "text": "ReactiveElement & { elements: OpenableElement[] }"
+              },
+              "privacy": "private",
+              "default": "host"
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "OverlayOptionsV1"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "originalPlacements",
+              "privacy": "private",
+              "default": "new WeakMap<HTMLElement, Placement>()"
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "placeOverlay",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "default": "this.target",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "options",
+                  "default": "this.options",
+                  "type": {
+                    "text": "OverlayOptionsV1"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "allowPlacementUpdate",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "updatePlacement"
+            },
+            {
+              "kind": "method",
+              "name": "computePlacement",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resetOverlayPosition",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hostUpdated",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "placementUpdatedSymbol",
+          "declaration": {
+            "name": "placementUpdatedSymbol",
+            "module": "src/PlacementController.js"
+          }
         },
         {
           "kind": "js",
-          "name": "OverlayTrigger",
+          "name": "PlacementController",
           "declaration": {
-            "name": "OverlayTrigger",
-            "module": "src/OverlayTrigger.js"
+            "name": "PlacementController",
+            "module": "src/PlacementController.js"
           }
         }
       ]