@lion/ui 0.15.5 → 0.16.0

package/docs/fundamentals/systems/overlays/use-cases.md

@@ -34,7 +34,7 @@ The overlay system allows to create different types of overlays like dialogs, to
 It's designed to be highly flexible, while still delivering sensible defaults.
 On top of this, the system was built having accessibility in mind.
 
-For a detailed rationale, please consult [Rationale](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/systems/overlays/rationale.md).
+For a detailed rationale, please consult [Rationale](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/systems/overlays/rationale.md).
 
 ```js preview-story
 export const main = () => html`
@@ -82,7 +82,7 @@ Global refers to overlays where the content is positioned in a global root node
 
 Overlays can be configured in many ways to suit your needs. We go in-depth into each option in the Overlay System - Configuration chapter.
 
-We also export a few [preset configuration objects](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/systems/overlays/configuration.md).
+We also export a few [preset configuration objects](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/systems/overlays/configuration.md).
 
 - withModalDialogConfig
 - withDropdownConfig

package/docs/fundamentals/tools/helpers/overview.md

@@ -22,7 +22,7 @@ Therefore, they may not have the same quality standards as our other packages.
 
 | Package                                | Description             |
 | -------------------------------------- | ----------------------- |
-| [sb-action-logger](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/tools/helpers/action-logger.md) | Storybook action logger |
+| [sb-action-logger](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/tools/helpers/action-logger.md) | Storybook action logger |
 
 ## Installation
 

package/docs/fundamentals/tools/singleton-manager/overview.md

@@ -22,7 +22,7 @@ Primarily useful if two major version of a package with a singleton is used.
 npm i --save singleton-manager
 ```
 
-⚠️ You need to make SURE that only ONE version of `singleton-manager` is installed. For how see [Non Goals](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/tools/singleton-manager/#non-goals).
+⚠️ You need to make SURE that only ONE version of `singleton-manager` is installed. For how see [Non Goals](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/tools/singleton-manager/#non-goals).
 
 ### Example Singleton Users
 
@@ -172,7 +172,7 @@ Steps to reproduce:
 1. Page A click on block
 2. Page B => "Blocked: false" (even when hitting the refresh button)
 
-➡️ See [it on the example page](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/tools/singleton-manager/example-fail/index.md). <br>
+➡️ See [it on the example page](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/tools/singleton-manager/example-fail/index.md). <br>
 ➡️ See [the code](https://github.com/ing-bank/lion/tree/master/docs/fundamentals/tools/singleton-manager/example-fail/demo-app.js).
 
 ---
@@ -215,7 +215,7 @@ See it in action
 npm run start:singleton
 ```
 
-➡️ See [it on the example page](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/tools/singleton-manager/example-success/index.md). <br>
+➡️ See [it on the example page](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/tools/singleton-manager/example-success/index.md). <br>
 ➡️ See [the code](https://github.com/ing-bank/lion/tree/master/docs/fundamentals/tools/singleton-manager/example-success/demo-app.js).
 
 ---
@@ -256,7 +256,7 @@ See it in action
 npm run start:singleton-complex
 ```
 
-➡️ See [it on the example page](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/tools/singleton-manager/example-complex/index.md). <br>
+➡️ See [it on the example page](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/tools/singleton-manager/example-complex/index.md). <br>
 ➡️ See [the code](https://github.com/ing-bank/lion/tree/master/docs/fundamentals/tools/singleton-manager/example-complex/demo-app.js).
 
 ---

package/docs/guides/how-to/create-a-custom-field.md

@@ -87,9 +87,9 @@ if (!customElements.get('dummy-slider')) {
 }
 ```
 
-Custom Fields can be created in just a few steps. All you need is an interaction element (like for instance a slider, a listbox or a combobox) and connect it to the [LionField](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/components/input/overview.md).
+Custom Fields can be created in just a few steps. All you need is an interaction element (like for instance a slider, a listbox or a combobox) and connect it to the [LionField](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/components/input/overview.md).
 
-> In case you want to extend a native element, follow [Extend a native Input](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/extend-a-native-input.md).
+> In case you want to extend a native element, follow [Extend a native Input](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/extend-a-native-input.md).
 
 ## A) an interaction element
 
@@ -138,7 +138,7 @@ export const createAnInteractiveElement = () => {
 ## B) your LionField extension
 
 Now we want to integrate the slider in our form system to enrich the user interface, get
-validation support and all other [benefits of LionField](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/components/input/overview.md).
+validation support and all other [benefits of LionField](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/components/input/overview.md).
 We start by creating a component `<slider-field>` that extends from `LionField`.
 Then we follow the steps below:
 
@@ -151,7 +151,7 @@ Then we follow the steps below:
 
   The `user-input-changed` event is listened to by the FormatMixin: it should be regarded as the
   equivalent of the `input` event of the platform, but for custom built interaction elements.
-  You now synchronized [modelValue](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/systems/form/model-value.md), which can be regarded as
+  You now synchronized [modelValue](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/systems/form/model-value.md), which can be regarded as
   the glue to integrate all other functionality like parsing/formatting/serializing, validating,
   tracking interaction states etc.
 
@@ -159,7 +159,7 @@ Then we follow the steps below:
 > because those properties will lose their reactivity (they won't be considered anymore in the
 > update loop of LitElement).
 > Whenever a .modelValue/.formattedValue/.serializedValue needs to be computed, use
-> [parser/formatter/serializer](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/systems/form/formatting-and-parsing.md)
+> [parser/formatter/serializer](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/systems/form/formatting-and-parsing.md)
 
 Implement with the following code:
 

package/docs/guides/how-to/create-a-form.md

@@ -39,7 +39,7 @@ Large or complex forms might need to be split up into multiple files. This compo
 
 In the latter case: make sure that your components don't have a shadow root. This can be achieved by rendering into Light DOM. The form registration mechanism relies on light dom by design: as soon as you do start to use shadow roots, you will notice that your form components won't register themselves anymore to their parents.
 
-> Today, rendering to light dom is the only way to [stay accessible](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/fundamentals/rationales/accessibility.md#shadow-roots-and-accessibility).
+> Today, rendering to light dom is the only way to [stay accessible](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/fundamentals/rationales/accessibility.md#shadow-roots-and-accessibility).
 
 ### Example of a component that renders into Light DOM
 
@@ -86,7 +86,7 @@ Extending form components is not recommended for Application Developers: it shou
 This team will add the styling and default configuration needed to make it fit the particular Design System.
 
 With the toolbox provided by the team that creates your Design System, you should be able to build all your forms. Only if you have a really good reason, look into
-[exceptional cases](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/#exceptional-cases) below.
+[exceptional cases](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/#exceptional-cases) below.
 
 ### Exceptional cases
 
@@ -94,8 +94,8 @@ If the form component you need is still missing, you have two options:
 
 - is it a generic primitive that should be part of Lion? Request it in [Lion discussions](https://github.com/ing-bank/lion/discussions)
 - is it a non generic component that is unique to your app?
-  - follow [create a custom field](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/create-a-custom-field.md)
-  - follow [extend a native input](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/extend-a-native-input.md)
+  - follow [create a custom field](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/create-a-custom-field.md)
+  - follow [extend a native input](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/extend-a-native-input.md)
 
 It's also possible to extend other components, like LionListbox or LionCombobox. You need to be aware that you're building on top of protected apis.
 Changing/overriding functionality is only recommended if the source code in `form-core` is fully understood.

package/docs/guides/how-to/extend-a-native-input.md

@@ -23,9 +23,9 @@ import '../../fundamentals/systems/form/assets/h-output.js';
 loadDefaultFeedbackMessages();
 ```
 
-Input fields can be created by extending [LionInput](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/components/input/overview.md).
+Input fields can be created by extending [LionInput](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/components/input/overview.md).
 
-> In case you want to wrap a custom form element, follow [Create a custom Field](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/create-a-custom-field.md).
+> In case you want to wrap a custom form element, follow [Create a custom Field](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/create-a-custom-field.md).
 
 For this tutorial, we create an input that wraps native `input[type=datetime-local]`.
 This is as simple as adding a type:

package/docs/guides/index.md

@@ -22,9 +22,9 @@ Developers consuming our web components inside an application (not extending the
 `Application Developers` are only allowed to interact with `public` properties and methods.
 Can be abbreviated as `AD`. Sometimes also called `Consuming Developer`.
 
-- [Definitions and Terms](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/definitions-and-terms.md)
-- [Styling](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/styling.md)
-- [Scoped Elements](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/scoped-elements.md)
+- [Definitions and Terms](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/definitions-and-terms.md)
+- [Styling](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/styling.md)
+- [Scoped Elements](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/scoped-elements.md)
 
 ## Extending Developer
 
@@ -32,13 +32,13 @@ Developers extending our web components, for instance: `class MaterialInput exte
 
 Especially for subclassers we have some extra documentation:
 
-- [Subclasser APIs](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/subclasser-apis.md)
-- [Extend documentation](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/blog/extending-documentation.md)
+- [Subclasser APIs](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/subclasser-apis.md)
+- [Extend documentation](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/blog/extending-documentation.md)
 
 ## How To
 
 Next to that we have some specific "How To" documentations.
 
-- [Get started](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/get-started.md)
-- [Create a custom field](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/create-a-custom-field.md)
-- [Extend a native input](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/how-to/extend-a-native-input.md)
+- [Get started](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/get-started.md)
+- [Create a custom field](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/create-a-custom-field.md)
+- [Extend a native input](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/how-to/extend-a-native-input.md)

package/docs/guides/principles/index.md

@@ -22,9 +22,9 @@ Developers consuming our web components inside an application (not extending the
 `Application Developers` are only allowed to interact with `public` properties and methods.
 Can be abbreviated as `AD`. Sometimes also called `Consuming Developer`.
 
-- [Definitions and Terms](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/definitions-and-terms.md)
-- [Styling](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/styling.md)
-- [Scoped Elements](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/scoped-elements.md)
+- [Definitions and Terms](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/definitions-and-terms.md)
+- [Styling](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/styling.md)
+- [Scoped Elements](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/scoped-elements.md)
 
 ## Extending Developer
 
@@ -32,5 +32,5 @@ Developers extending our web components, for instance: `class MaterialInput exte
 
 Especially for subclassers we have some extra documentation:
 
-- [Subclasser APIs](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/subclasser-apis.md)
-- [Extend documentation](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/blog/extending-documentation.md)
+- [Subclasser APIs](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/subclasser-apis.md)
+- [Extend documentation](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/blog/extending-documentation.md)

package/docs/guides/principles/styling.md

@@ -31,7 +31,7 @@ Examples for both categories can be found below:
 - Accessibility examples:
   - Content (for instance a caption in a table) can be `visually hidden`: it will be
     readable by screen readers, but invisible for end users.
-  - When an html table is used, we allow [subclassers](https://github.com/ing-bank/lion/blob/306ed5a799d10ddde151740c31f946981caac4ba/docs/guides/principles/subclasser-apis.md) to override the display property (`table-cell`) to `flex`. By putting the proper accessible roles (`role="cell"`) in the markup, we guarantee our markup stays accessible.
+  - When an html table is used, we allow [subclassers](https://github.com/ing-bank/lion/blob/07b67ecb65d6c48ea4dd152f451ce5070a553056/docs/guides/principles/subclasser-apis.md) to override the display property (`table-cell`) to `flex`. By putting the proper accessible roles (`role="cell"`) in the markup, we guarantee our markup stays accessible.
 
 Although Lion components try to stay as unbiased as possible with regard to styling, defaults will be needed. In these cases we try to follow the platform as much as possible. If the platform doesn't provide defaults, the largest common denominator across existing UI systems is taken as a lead.
 

package/exports/overlays.js

@@ -9,7 +9,6 @@ export { withModalDialogConfig } from '../components/overlays/src/configurations
 export { withDropdownConfig } from '../components/overlays/src/configurations/withDropdownConfig.js';
 export { withTooltipConfig } from '../components/overlays/src/configurations/withTooltipConfig.js';
 
-export { containFocus, rotateFocus } from '../components/overlays/src/utils/contain-focus.js';
 export { deepContains } from '../components/overlays/src/utils/deep-contains.js';
 // re-export via this entrypoint for backwards compatibility
 export { getDeepActiveElement } from '../components/core/src/getDeepActiveElement.js';

package/overlays.js

@@ -6,7 +6,6 @@ export { withBottomSheetConfig } from './components/overlays/src/configurations/
 export { withModalDialogConfig } from './components/overlays/src/configurations/withModalDialogConfig.js';
 export { withDropdownConfig } from './components/overlays/src/configurations/withDropdownConfig.js';
 export { withTooltipConfig } from './components/overlays/src/configurations/withTooltipConfig.js';
-export { containFocus, rotateFocus } from './components/overlays/src/utils/contain-focus.js';
 export { deepContains } from './components/overlays/src/utils/deep-contains.js';
 // re-export via this entrypoint for backwards compatibility
 export { getDeepActiveElement } from './components/core/src/getDeepActiveElement.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lion/ui",
-  "version": "0.15.5",
+  "version": "0.16.0",
   "description": "A package of extendable web components",
   "license": "MIT",
   "author": "ing-bank",

package/components/overlays/src/utils/contain-focus.js

@@ -1,202 +0,0 @@
-/* eslint-disable no-param-reassign */
-
-/**
- * Implementation based on: https://github.com/PolymerElements/iron-overlay-behavior/blob/master/iron-focusables-helper.html
- * The original implementation does not work for non-Polymer web components,
- * and contains several bugs on IE11.
- */
-
-import { getDeepActiveElement } from '../../../core/src/getDeepActiveElement.js';
-import { getFocusableElements } from './get-focusable-elements.js';
-import { deepContains } from './deep-contains.js';
-import { keyCodes } from './key-codes.js';
-
-/**
- * Rotates focus within a list of elements. If shift key was not pressed and focus
- * is on last item, puts focus on the first item. Reversed if shift key.
- *
- * @param {HTMLElement} rootElement The root element
- * @param {KeyboardEvent} e The keyboard event
- */
-export function rotateFocus(rootElement, e) {
-  // Find focusable elements
-  const els = getFocusableElements(rootElement);
-  // Determine the focus rotation boundaries.
-  let boundaryEls;
-
-  // If more than two elements, take the first and last
-  if (els.length >= 2) {
-    boundaryEls = [els[0], els[els.length - 1]];
-
-    // If 1 element, it is the boundary
-  } else if (els.length === 1) {
-    boundaryEls = [els[0], els[0]];
-
-    // If no focusable elements, root becomes the boundary
-  } else {
-    boundaryEls = [rootElement, rootElement];
-  }
-
-  // Reverse direction of boundaries if shift key was pressed
-  if (e.shiftKey) {
-    boundaryEls.reverse();
-  }
-
-  // Take first and last elements within boundary
-  const [first, last] = boundaryEls;
-
-  // Get the currently focused element
-  const activeElement = /** @type {HTMLElement} */ (getDeepActiveElement());
-
-  /**
-   * If currently focused on the root element or an element contained within the root element:
-   * allow native browser behavior (tab to the next node in DOM order).
-   *
-   * If currently focused on the last focusable element within the root element, or on an element
-   * outside of the root element: redirect focus to the first focusable element.
-   */
-  if (activeElement === rootElement || (els.includes(activeElement) && last !== activeElement)) {
-    return;
-  }
-
-  e.preventDefault();
-  first.focus();
-}
-
-/**
- * Contains focus within given root element. When focus is on the last focusable
- * element inside the root element, the next focus will be redirected to the first
- * focusable element.
- *
- * @param {HTMLElement} rootElement The element to contain focus within
- * @returns {{ disconnect: () => void }} handler with a disconnect callback
- */
-export function containFocus(rootElement) {
-  const focusableElements = getFocusableElements(rootElement);
-  // Initial focus goes to first element with autofocus, or the root element
-  const initialFocus = focusableElements.find(e => e.hasAttribute('autofocus')) || rootElement;
-  /** @type {HTMLElement} */
-  let tabDetectionElement;
-  /** @type {MutationObserver} */
-  let rootElementMutationObserver;
-
-  // If root element will receive focus, it should have a tabindex of -1.
-  // This makes it focusable through js, but it won't appear in the tab order
-  if (initialFocus === rootElement) {
-    rootElement.tabIndex = -1;
-    rootElement.style.setProperty('outline', 'none');
-  }
-
-  // Focus first focusable element
-  initialFocus.focus();
-
-  /**
-   * Ensures focus stays inside root element on tab
-   * @param {KeyboardEvent} e
-   */
-  function handleKeydown(e) {
-    if (e.keyCode === keyCodes.tab) {
-      rotateFocus(rootElement, e);
-    }
-  }
-
-  function createHelpersDetectingTabDirection() {
-    tabDetectionElement = document.createElement('div');
-    tabDetectionElement.style.display = 'none';
-    tabDetectionElement.setAttribute('data-is-tab-detection-element', '');
-    rootElement.insertBefore(tabDetectionElement, rootElement.children[0]);
-
-    rootElementMutationObserver = new MutationObserver(mutationsList => {
-      for (const mutation of mutationsList) {
-        if (mutation.type === 'childList') {
-          const tabDetectionElIsMissing = !Array.from(rootElement.children).find(el =>
-            el.hasAttribute('data-is-tab-detection-element'),
-          );
-          const foundTabDetectionElInMutations = Array.from(mutation.addedNodes).find(
-            /** @param {Node} el */ el =>
-              el instanceof HTMLElement && el.hasAttribute('data-is-tab-detection-element'),
-          );
-          // Prevent infinite loop by detecting that mutation event is not from adding the tab detection el
-          if (tabDetectionElIsMissing && !foundTabDetectionElInMutations) {
-            rootElementMutationObserver.disconnect();
-            createHelpersDetectingTabDirection();
-          }
-        }
-      }
-    });
-    rootElementMutationObserver.observe(rootElement, { childList: true });
-  }
-
-  function isForwardTabInWindow() {
-    const compareMask = tabDetectionElement.compareDocumentPosition(
-      /** @type {Element} */ (document.activeElement),
-    );
-    return compareMask === Node.DOCUMENT_POSITION_PRECEDING;
-  }
-
-  /**
-   * @param {Object} opts
-   * @param {boolean} [opts.resetToRoot]
-   * @desc When we simulate a modal dialog, we need to restore the focus to the first or last
-   * element of the rootElement
-   */
-  function setFocusInRootElement({ resetToRoot = false } = {}) {
-    if (deepContains(rootElement, /** @type {HTMLElement} */ (getDeepActiveElement()))) {
-      return;
-    }
-
-    let nextActive;
-    if (resetToRoot) {
-      nextActive = rootElement;
-    } else {
-      nextActive = focusableElements[isForwardTabInWindow() ? 0 : focusableElements.length - 1];
-    }
-
-    if (nextActive) {
-      nextActive.focus();
-    }
-  }
-
-  function handleFocusin() {
-    window.removeEventListener('focusin', handleFocusin);
-    setFocusInRootElement();
-  }
-
-  function handleFocusout() {
-    /**
-     * There is a moment in time between focusout and focusin (when focus shifts)
-     * where the activeElement is reset to body first. So we use an async task to check
-     * a little bit later for activeElement, so we don't get a false positive.
-     *
-     * We used to check for focusin event for this, however,
-     * it can happen that focusout happens, but focusin never does, e.g. click outside but no focusable
-     * element is found to focus. If this happens, we should take the focus back to the rootElement.
-     */
-    setTimeout(() => {
-      if (!deepContains(rootElement, /** @type {HTMLElement} */ (getDeepActiveElement()))) {
-        setFocusInRootElement({ resetToRoot: true });
-      }
-    });
-
-    window.addEventListener('focusin', handleFocusin);
-  }
-
-  function disconnect() {
-    window.removeEventListener('keydown', handleKeydown);
-    window.removeEventListener('focusin', handleFocusin);
-    window.removeEventListener('focusout', handleFocusout);
-    // Guard this, since we also disconnect if we notice a missing tab
-    // detection element. We reinsert it, so it's okay to not fail here.
-    rootElementMutationObserver.disconnect();
-    if (Array.from(rootElement.children).includes(tabDetectionElement)) {
-      rootElement.removeChild(tabDetectionElement);
-    }
-    rootElement.style.removeProperty('outline');
-  }
-
-  window.addEventListener('keydown', handleKeydown);
-  window.addEventListener('focusout', handleFocusout);
-  createHelpersDetectingTabDirection();
-
-  return { disconnect };
-}