@lion/ui 0.0.12 → 0.0.14

package/docs/fundamentals/node-tools/rocket-preset-extend-lion-docs/overview.md

@@ -7,7 +7,7 @@ To do this automatically you can use this preset for [rocket](https://rocket.mod
 
 ## Features
 
-- Import lion documentation and adjust it using [remark-extend](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/node-tools/remark-extend/overview.md)
+- Import lion documentation and adjust it using [remark-extend](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/node-tools/remark-extend/overview.md)
 - Renames named imports and all it's usage
 - Adjusts import paths
 - Replace tags in template literals
@@ -38,7 +38,7 @@ export default {
 
 ## Reusing documentation
 
-To take an existing documentation you can "import" it using [remark-extend](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/node-tools/remark-extend/overview.md).
+To take an existing documentation you can "import" it using [remark-extend](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/node-tools/remark-extend/overview.md).
 
 As an example you can create `docs/components/tabs/overview.md`.
 

package/docs/fundamentals/systems/core/overview.md

@@ -15,7 +15,7 @@ import { LitElement, html, render } from 'lit-element';
 
 ## Features
 
-- [function to deduplicate mixins (dedupeMixin)](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/core/#deduping-of-mixins)
+- [function to deduplicate mixins (dedupeMixin)](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/core/#deduping-of-mixins)
 - Mixin to handle disabled (DisabledMixin)
 - Mixin to handle disabled AND tabIndex (DisabledWithTabIndexMixin)
 - Mixin to manage auto-generated needed slot elements in light dom (SlotMixin)

package/docs/fundamentals/systems/form/formatting-and-parsing.md

@@ -23,7 +23,7 @@ Our fields can automatically format/parse/serialize user input or an input set i
 
 Below are some concrete examples of implementations of formatters and parsers mimicking a (basic) amount input.
 
-> For an actual amount input, check out [lion-input-amount](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-amount/overview.md).
+> For an actual amount input, check out [lion-input-amount](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-amount/overview.md).
 > This comes with its own formatter, parser, serializer.
 
 ### Parsers & modelValue
@@ -230,16 +230,16 @@ Below we show three flow diagrams to show the flow of formatting, serializing an
 
 Where a user changes the input with their keyboard:
 
-![Standard flow](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/assets/FormatMixinDiagram-1.svg 'Standard flow')
+![Standard flow](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/assets/FormatMixinDiagram-1.svg 'Standard flow')
 
 ### Unparseable flow
 
 Where a user sets the input to something that is not parseable by the parser:
 
-![Unparseable flow](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/assets/FormatMixinDiagram-2.svg 'Unparseable flow')
+![Unparseable flow](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/assets/FormatMixinDiagram-2.svg 'Unparseable flow')
 
 ### Imperative / programmatic flow
 
 Where the developer sets the modelValue of the input programmatically:
 
-![Imperative flow](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/assets/FormatMixinDiagram-3.svg 'Imperative flow')
+![Imperative flow](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/assets/FormatMixinDiagram-3.svg 'Imperative flow')

package/docs/fundamentals/systems/form/model-value.md

@@ -21,7 +21,7 @@ level, via:
 > Internal/private concepts like viewValue, formattedValue, serializedValue are therefore not
 > recommended as a means of interaction.
 
-For more information about parsing and the Unparseable type, see [Formatting and Parsing](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/formatting-and-parsing.md)
+For more information about parsing and the Unparseable type, see [Formatting and Parsing](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/formatting-and-parsing.md)
 
 ### Event meta
 

package/docs/fundamentals/systems/form/overview.md

@@ -20,9 +20,9 @@ Fields (think of an input, textarea, select) are the actual form controls the en
 
 On top of this, they feature:
 
-- [formatting/parsing/serializing](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/formatting-and-parsing.md) of view values.
-- Advanced [validation](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/validate.md) possibilities.
-- Creation of advanced user interaction scenarios via [interaction states](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/interaction-states.md).
+- [formatting/parsing/serializing](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/formatting-and-parsing.md) of view values.
+- Advanced [validation](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/validate.md) possibilities.
+- Creation of advanced user interaction scenarios via [interaction states](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/interaction-states.md).
 - Provision of labels and help texts in an easy, declarative manner.
 - Accessibility out of the box.
 - Advanced styling possibilities: map your own Design System to the internal HTML structure.
@@ -31,33 +31,33 @@ On top of this, they feature:
 
 ### Platform fields (wrappers)
 
-- [LionInput](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input/overview.md), a wrapper for `<input>`.
-- [LionTextarea](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/textarea/overview.md), a wrapper for `<textarea>`.
-- [LionSelect](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/select/overview.md), a wrapper for `<select>`.
+- [LionInput](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input/overview.md), a wrapper for `<input>`.
+- [LionTextarea](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/textarea/overview.md), a wrapper for `<textarea>`.
+- [LionSelect](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/select/overview.md), a wrapper for `<select>`.
 
 ### Custom fields (wrappers)
 
-Whenever a native form control doesn't exist or is not sufficient, a [custom form field](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/guides/how-to/create-a-custom-field.md) should be created. One could think of components like:
+Whenever a native form control doesn't exist or is not sufficient, a [custom form field](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/guides/how-to/create-a-custom-field.md) should be created. One could think of components like:
 
-- [LionCombobox](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/combobox/overview.md), a custom implementation of a combobox.
-- [LionDate](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-date/overview.md), an alternative for `<input type="date">`.
-- [LionDatepicker](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-datepicker/overview.md), an alternative for `<input type="date">` including a calendar dropdown.
-- [LionListbox](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/listbox/overview.md), a custom implementation of a listbox.
-- [LionInputAmount](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-amount/overview.md), an alternative for `<input type="number">` special for amounts.
-- [LionInputEmail](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-email/overview.md), an alternative for `<input type="email">`.
-- [LionInputIban](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-iban/overview.md), an ING specific for an input with IBAN numbers.
-- [LionInputRange](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-range/overview.md), an alternative for `<input type="range">`.
-- [LionInputStepper](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/input-stepper/overview.md), an alternative for `<input type="number">`.
-- [LionSelectRich](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/select-rich/overview.md), an alternative for `<select>` with multiline options.
+- [LionCombobox](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/combobox/overview.md), a custom implementation of a combobox.
+- [LionDate](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-date/overview.md), an alternative for `<input type="date">`.
+- [LionDatepicker](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-datepicker/overview.md), an alternative for `<input type="date">` including a calendar dropdown.
+- [LionListbox](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/listbox/overview.md), a custom implementation of a listbox.
+- [LionInputAmount](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-amount/overview.md), an alternative for `<input type="number">` special for amounts.
+- [LionInputEmail](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-email/overview.md), an alternative for `<input type="email">`.
+- [LionInputIban](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-iban/overview.md), an ING specific for an input with IBAN numbers.
+- [LionInputRange](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-range/overview.md), an alternative for `<input type="range">`.
+- [LionInputStepper](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/input-stepper/overview.md), an alternative for `<input type="number">`.
+- [LionSelectRich](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/select-rich/overview.md), an alternative for `<select>` with multiline options.
 
 ### Choice Input Fields
 
 For form controls which return a `checked-state` you can use the `lion-choice-input` mixin. It is used in:
 
-- [LionCheckbox](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/checkbox-group/overview.md), a wrapper for `<input type="checkbox">`.
+- [LionCheckbox](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/checkbox-group/overview.md), a wrapper for `<input type="checkbox">`.
 - LionOption, an alternative for `<option>`.
-- [LionRadio](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/radio-group/overview.md), a wrapper for `<input type="radio">`.
-- [LionSwitch](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/switch/overview.md), a custom implementation of a switch.
+- [LionRadio](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/radio-group/overview.md), a wrapper for `<input type="radio">`.
+- [LionSwitch](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/switch/overview.md), a custom implementation of a switch.
 
 Which contains the following features:
 
@@ -69,14 +69,14 @@ Which contains the following features:
 
 Fieldsets are groups of fields. They can be considered fields on their own as well, since they partly share the normalized API via `FormControlMixin`. Fieldsets are the basis for:
 
-- [LionFieldset](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/fieldset/overview.md), a wrapper around multiple input fields or other fieldsets.
-- [LionForm](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/form/overview.md), enhances the functionality of the native `<form>` component.
-- [LionCheckboxGroup](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/checkbox-group/overview.md), a wrapper component for multiple checkboxes.
-- [LionRadioGroup](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/radio-group/overview.md), a wrapper component for multiple radio inputs.
+- [LionFieldset](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/fieldset/overview.md), a wrapper around multiple input fields or other fieldsets.
+- [LionForm](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/form/overview.md), enhances the functionality of the native `<form>` component.
+- [LionCheckboxGroup](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/checkbox-group/overview.md), a wrapper component for multiple checkboxes.
+- [LionRadioGroup](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/radio-group/overview.md), a wrapper component for multiple radio inputs.
 
 ## Other Resources
 
-- [Model Value](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/model-value.md)
-- [Formatting and parsing](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/formatting-and-parsing.md)
-- [Interaction states](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/interaction-states.md)
-- [Validation System](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/validate.md)
+- [Model Value](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/model-value.md)
+- [Formatting and parsing](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/formatting-and-parsing.md)
+- [Interaction states](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/interaction-states.md)
+- [Validation System](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/validate.md)

package/docs/fundamentals/systems/form/validate.md

@@ -58,7 +58,7 @@ Validation happens on every change of `modelValue`. A change in modelValue can b
 
 ## When validation feedback will be shown
 
-Although validation happens realtime under the hood, displaying validity feedback in realtime may not always lead to the desired User Experience. Together with [interaction states](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/form/interaction-states.md),
+Although validation happens realtime under the hood, displaying validity feedback in realtime may not always lead to the desired User Experience. Together with [interaction states](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/form/interaction-states.md),
 validity states can determine whether a validation message should be shown along the input field.
 
 ## Assessing field validation state programmatically

package/docs/fundamentals/systems/localize/overview.md

@@ -9,15 +9,15 @@ In it's simplest form it is a function that returns the translated text for a na
 - Formatting of numbers, amounts
 - Formatting of dates
 
-Further examples and a more in depth description can be found at the [Use Cases Page](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/localize/use-cases.md).
+Further examples and a more in depth description can be found at the [Use Cases Page](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/localize/use-cases.md).
 
 ## Content
 
 | Feature                                  | Description                                   |
 | ---------------------------------------- | --------------------------------------------- |
-| [Translate Text](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/localize/text.md)    | Load and translate text in multiple languages |
-| [Format Numbers](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/localize/numbers.md) | Format numbers in multiple languages          |
-| [Format Dates](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/localize/dates.md)     | Format dates in multiple languages            |
+| [Translate Text](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/localize/text.md)    | Load and translate text in multiple languages |
+| [Format Numbers](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/localize/numbers.md) | Format numbers in multiple languages          |
+| [Format Dates](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/localize/dates.md)     | Format dates in multiple languages            |
 
 ## Installation
 

package/docs/fundamentals/systems/overlays/assets/demo-el-using-overlaymixin.mjs

@@ -15,22 +15,6 @@ class DemoElUsingOverlayMixin extends OverlayMixin(LitElement) {
     });
   }
 
-  _setupOpenCloseListeners() {
-    super._setupOpenCloseListeners();
-
-    if (this._overlayInvokerNode) {
-      this._overlayInvokerNode.addEventListener('click', this.toggle);
-    }
-  }
-
-  _teardownOpenCloseListeners() {
-    super._teardownOpenCloseListeners();
-
-    if (this._overlayInvokerNode) {
-      this._overlayInvokerNode.removeEventListener('click', this.toggle);
-    }
-  }
-
   render() {
     return html`
       <slot name="invoker"></slot>

package/docs/fundamentals/systems/overlays/configuration.md

@@ -20,7 +20,7 @@ or in the `overlays` container at the bottom of the `<body>`.
 
 ```js preview-story
 export const placementLocal = () => {
-  const placementModeLocalConfig = { placementMode: 'local' };
+  const placementModeLocalConfig = { ...withDropdownConfig() };
   return html`
     <style>
       .demo-overlay {
@@ -68,7 +68,7 @@ export const placementGlobal = () => {
 
 ## isTooltip (placementMode: 'local')
 
-As specified in the [overlay rationale](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/rationale.md) there are only two official types of overlays: dialogs and tooltips. And their main differences are:
+As specified in the [overlay rationale](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/rationale.md) there are only two official types of overlays: dialogs and tooltips. And their main differences are:
 
 - Dialogs have a modal option, tooltips don’t
 - Dialogs have interactive content, tooltips don’t
@@ -77,24 +77,12 @@ As specified in the [overlay rationale](https://github.com/ing-bank/lion/blob/ed
 Since most overlays have interactive content the default is set to dialogs. To get a tooltip, you can add `isTooltip` to the config object. This only works for local placement and it also needs to have `handlesAccessibility` activated to work.
 
 ```js preview-story
-export const isTooltip = () => {
-  function showTooltip() {
-    const tooltip = document.querySelector('#tooltip');
-    tooltip.opened = true;
-  }
-
-  function hideTooltip() {
-    const tooltip = document.querySelector('#tooltip');
-    tooltip.opened = false;
-  }
-
-  const tooltipConfig = { placementMode: 'local', isTooltip: true, handlesAccessibility: true };
+export const usingTooltipConfig = () => {
+  const tooltipConfig = { ...withTooltipConfig() };
 
   return html`
     <demo-el-using-overlaymixin id="tooltip" .config=${tooltipConfig}>
-      <button slot="invoker" @mouseenter=${showTooltip} @mouseleave=${hideTooltip}>
-        Hover me to open the tooltip!
-      </button>
+      <button slot="invoker">Hover me to open the tooltip!</button>
       <div slot="content" class="demo-overlay">Hello!</div>
     </demo-el-using-overlaymixin>
   `;
@@ -112,7 +100,7 @@ You use the feature on any type of overlay.
 
 ```js preview-story
 export const trapsKeyboardFocus = () => {
-  const trapsKeyboardFocusConfig = { trapsKeyboardFocus: true };
+  const trapsKeyboardFocusConfig = { ...withDropdownConfig(), trapsKeyboardFocus: true };
   return html`
     <demo-el-using-overlaymixin .config=${trapsKeyboardFocusConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -138,7 +126,7 @@ Boolean property. Will allow closing the overlay on ESC key when enabled.
 
 ```js preview-story
 export const hidesOnEsc = () => {
-  const hidesOnEscConfig = { hidesOnEsc: true };
+  const hidesOnEscConfig = { ...withDropdownConfig(), hidesOnEsc: true };
   return html`
     <demo-el-using-overlaymixin .config=${hidesOnEscConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -162,7 +150,7 @@ Boolean property. When enabled allows closing the overlay on ESC key, even when
 
 ```js preview-story
 export const hidesOnOutsideEsc = () => {
-  const hidesOnEscConfig = { hidesOnOutsideEsc: true };
+  const hidesOnEscConfig = { ...withDropdownConfig(), hidesOnOutsideEsc: true };
   return html`
     <demo-el-using-overlaymixin .config=${hidesOnEscConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -186,7 +174,7 @@ Boolean property. Will allow closing the overlay by clicking outside the `conten
 
 ```js preview-story
 export const hidesOnOutsideClick = () => {
-  const hidesOnOutsideClickConfig = { hidesOnOutsideClick: true };
+  const hidesOnOutsideClickConfig = { ...withDropdownConfig(), hidesOnOutsideClick: true };
   return html`
     <demo-el-using-overlaymixin .config=${hidesOnOutsideClickConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -216,7 +204,7 @@ export const elementToFocusAfterHide = () => {
   const btn = document.createElement('button');
   btn.innerText = 'I should get focus';
 
-  const elementToFocusAfterHideConfig = { elementToFocusAfterHide: btn };
+  const elementToFocusAfterHideConfig = { ...withDropdownConfig(), elementToFocusAfterHide: btn };
   return html`
     <demo-el-using-overlaymixin .config=${elementToFocusAfterHideConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -252,7 +240,7 @@ This currently only supports CSS Animations, because it relies on the `animation
 
 ```js preview-story
 export const hasBackdrop = () => {
-  const hasBackdropConfig = { hasBackdrop: true };
+  const hasBackdropConfig = { ...withDropdownConfig(), hasBackdrop: true };
   return html`
     <demo-el-using-overlaymixin .config=${hasBackdropConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -276,7 +264,7 @@ Boolean property. When true, will block other overlays.
 
 ```js preview-story
 export const isBlocking = () => {
-  const isBlockingConfig = { hasBackdrop: true, isBlocking: true };
+  const isBlockingConfig = { ...withDropdownConfig(), hasBackdrop: true, isBlocking: true };
   return html`
     <demo-el-using-overlaymixin>
       <button slot="invoker">Overlay A: open first</button>
@@ -385,7 +373,7 @@ Features:
 
 > Popper strictly is scoped on positioning. **It does not change the dimensions of the content node nor the invoker node**.
 > This also means that if you use the arrow feature, you are in charge of styling it properly, use the data-popper-placement attribute for this.
-> An example implementation can be found in [lion-tooltip](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/tooltip/overview.md), where an arrow is set by default.
+> An example implementation can be found in [lion-tooltip](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/tooltip/overview.md), where an arrow is set by default.
 
 To override the default options we set for local mode, you add a `popperConfig` object to the config passed to the OverlayController.
 Here's a succinct overview of some often used popper properties:

package/docs/fundamentals/systems/overlays/overview.md

@@ -6,7 +6,7 @@ Manages their position on the screen relative to other elements, including other
 
 Its purpose is to make it easy to use our Overlay System declaratively. It can be easily extended where needed, to override event listeners and more.
 
-See [lion-dialog](../../../components/dialog/overview.md) and [lion-tooltip](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/components/tooltip/overview.md) for example Web Component implementations using the Overlay System.
+See [lion-dialog](../../../components/dialog/overview.md) and [lion-tooltip](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/components/tooltip/overview.md) for example Web Component implementations using the Overlay System.
 
 ## Features
 
@@ -18,9 +18,9 @@ See [lion-dialog](../../../components/dialog/overview.md) and [lion-tooltip](htt
 - lion-overlay web component:
   - Show content when clicking the invoker
   - Have a `.config` object to set or update the OverlayController's configuration
-- [**OverlaysManager**](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/use-cases.md#overlaysmanager), a global repository keeping track of all different types of overlays
-- [**OverlayController**](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/use-cases.md#overlaycontroller), a single controller class for handling overlays
-- [**OverlayMixin**](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/use-cases.md#overlaymixin), a mixin that can be used to create webcomponents that use the OverlayController under the hood
+- [**OverlaysManager**](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/use-cases.md#overlaysmanager), a global repository keeping track of all different types of overlays
+- [**OverlayController**](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/use-cases.md#overlaycontroller), a single controller class for handling overlays
+- [**OverlayMixin**](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/use-cases.md#overlaymixin), a mixin that can be used to create webcomponents that use the OverlayController under the hood
 
 Usually you will use `lion-dialog` (or `lion-tooltip` if this makes more sense).
 
@@ -110,7 +110,7 @@ class MyOverlayComponent extends OverlayMixin(LitElement) {
 
 ## Rationales
 
-Please check the [system rationals](https://github.com/ing-bank/lion/blob/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/rationale.md) folder, where we go more in-depth.
+Please check the [system rationals](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/rationale.md) folder, where we go more in-depth.
 
 ### Aria roles
 

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

@@ -21,7 +21,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/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/rationale.md).
+For a detailed rationale, please consult [Rationale](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/rationale.md).
 
 ```js preview-story
 export const main = () => html`
@@ -67,7 +67,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/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/systems/overlays/configuration.md).
+We also export a few [preset configuration objects](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/systems/overlays/configuration.md).
 
 - withModalDialogConfig
 - withDropdownConfig
@@ -539,7 +539,7 @@ Below an example is shown with the `isBlocking` option, which makes use of the O
 
 ```js preview-story
 export const overlayManager = () => {
-  const hasBackdropConfig = { hasBackdrop: true };
+  const hasBackdropConfig = { ...withModalDialogConfig(), hasBackdrop: true };
   return html`
     <demo-el-using-overlaymixin .config=${hasBackdropConfig}>
       <button slot="invoker">Click me to open the overlay!</button>
@@ -558,7 +558,7 @@ export const overlayManager = () => {
     </demo-el-using-overlaymixin>
     <demo-el-using-overlaymixin
       id="secondOverlay"
-      .config=${{ hasBackdrop: true, isBlocking: true }}
+      .config=${{ ...withModalDialogConfig(), hasBackdrop: true, isBlocking: true }}
     >
       <div slot="content" class="demo-overlay demo-overlay--second">
         Hello! You can close this notification here:
@@ -581,7 +581,7 @@ Here is the example below
 
 ```js preview-story
 export const localBackdrop = () => {
-  const localBackdropConfig = { placementMode: 'local' };
+  const localBackdropConfig = { ...withDropdownConfig() };
   return html`
     <demo-el-using-overlaymixin .config=${localBackdropConfig}>
       <demo-overlay-backdrop slot="backdrop"></demo-overlay-backdrop>

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

@@ -9,7 +9,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/ed5016dcea7f081f0c5d4716a3dcba30c0e64c85/docs/fundamentals/tools/helpers/action-logger.md) | Storybook action logger |
+| [sb-action-logger](https://github.com/ing-bank/lion/blob/c7ce3afabd95988fe0cc2f466ffed78890796fa3/docs/fundamentals/tools/helpers/action-logger.md) | Storybook action logger |
 
 ## Installation
 

package/docs/fundamentals/tools/singleton-manager/.gitignore

@@ -0,0 +1 @@
+!**/*

package/docs/fundamentals/tools/singleton-manager/example-complex/demo-app.js

@@ -0,0 +1,93 @@
+import { LitElement, css, html } from 'lit';
+
+import './overlayCompatibility.js';
+
+import 'page-a/page-a.js';
+import 'page-b/page-b.js';
+
+class DemoApp extends LitElement {
+  constructor() {
+    super();
+    this.page = 'A';
+  }
+
+  static get properties() {
+    return {
+      page: { type: String },
+    };
+  }
+
+  static get styles() {
+    return css`
+      :host {
+        display: block;
+        max-width: 680px;
+        margin: 0 auto;
+      }
+
+      nav {
+        padding: 0 10px 10px 10px;
+      }
+
+      button {
+        border: none;
+        padding: 1rem 2rem;
+        background: #0069ed;
+        color: #fff;
+        font-size: 1rem;
+        cursor: pointer;
+        text-align: center;
+        transition: background 250ms ease-in-out, transform 150ms ease;
+      }
+
+      button:hover,
+      button:focus {
+        background: #0053ba;
+      }
+
+      button:focus {
+        outline: 1px solid #fff;
+        outline-offset: -4px;
+      }
+
+      button:active {
+        transform: scale(0.99);
+      }
+
+      button.active {
+        background: #33a43f;
+      }
+
+      h1 {
+        text-align: center;
+      }
+    `;
+  }
+
+  render() {
+    return html`
+      <h1>Demo App</h1>
+      <nav>
+        <button
+          class=${this.page === 'A' ? 'active' : ''}
+          @click=${() => {
+            this.page = 'A';
+          }}
+        >
+          Page A
+        </button>
+        <button
+          class=${this.page === 'B' ? 'active' : ''}
+          @click=${() => {
+            this.page = 'B';
+          }}
+        >
+          Page B
+        </button>
+      </nav>
+      ${this.page === 'A' ? html` <page-a></page-a> ` : html` <page-b></page-b> `}
+    `;
+  }
+}
+
+customElements.define('demo-app', DemoApp);

package/docs/fundamentals/tools/singleton-manager/example-complex/node_modules/overlays/index.js

@@ -0,0 +1,30 @@
+export class OverlaysManager {
+  name = 'OverlayManager 1.x';
+
+  blockBody = false;
+
+  constructor() {
+    this._setupBlocker();
+  }
+
+  _setupBlocker() {
+    const blocker = document.createElement('div');
+    blocker.setAttribute('style', 'border: 2px solid #8d0606; margin: 10px; padding: 10px; width: 140px; text-align: center;');
+    blocker.innerText = `Blocker for ${this.name}`;
+
+    const target = document.getElementById('overlay-target');
+    target.appendChild(blocker);
+
+    this.blocker = blocker;
+  }
+
+  block() {
+    this.blockBody = true;
+    this.blocker.style.backgroundColor = '#ff6161';
+  }
+
+  unBlock() {
+    this.blockBody = false;
+    this.blocker.style.backgroundColor = 'transparent';
+  }
+}

package/docs/fundamentals/tools/singleton-manager/example-complex/node_modules/overlays/instance.js

@@ -0,0 +1,4 @@
+import { OverlaysManager } from './index.js';
+import { singletonManager } from 'singleton-manager';
+
+export const overlays = singletonManager.get('overlays::overlays::1.x') || new OverlaysManager();

package/docs/fundamentals/tools/singleton-manager/example-complex/node_modules/page-a/page-a.js

@@ -0,0 +1,35 @@
+import { LitElement, html, css } from 'lit-element';
+import { overlays } from 'overlays/instance.js';
+
+export class PageA extends LitElement {
+  static get styles() {
+    return css`
+      :host {
+        display: block;
+        padding: 10px;
+        border: 2px solid #ccc;
+      }
+    `;
+  }
+
+  render() {
+    return html`
+      <h3>I am page A</h3>
+      <p>Overlays Status:</p>
+      <p>Name: ${overlays.name}</p>
+      <p>Blocked: ${overlays.blockBody}</p>
+      <button @click=${() => {
+        overlays.block(); this.requestUpdate();
+      }}>block</button>
+      <button @click=${() => {
+        overlays.unBlock(); this.requestUpdate();
+      }}>un-block</button>
+      <button @click=${() => {
+        this.requestUpdate();
+      }}>refresh</button>
+    `;
+  }
+}
+
+
+customElements.define('page-a', PageA);

package/docs/fundamentals/tools/singleton-manager/example-complex/node_modules/page-b/node_modules/overlays/index.js

@@ -0,0 +1,30 @@
+export class OverlaysManager {
+  name = 'OverlayManager 2.x';
+
+  _blockBody = false;
+
+  constructor() {
+    this._setupBlocker();
+  }
+
+  _setupBlocker() {
+    const blocker = document.createElement('div');
+    blocker.setAttribute('style', 'border: 2px solid #8d0606; margin: 10px; padding: 10px; width: 140px; text-align: center;');
+    blocker.innerText = `Blocker for ${this.name}`;
+
+    const target = document.getElementById('overlay-target');
+    target.appendChild(blocker);
+
+    this.blocker = blocker;
+  }
+
+  blockBody() {
+    this._blockBody = true;
+    this.blocker.style.backgroundColor = '#ff6161';
+  }
+
+  unBlockBody() {
+    this._blockBody = false;
+    this.blocker.style.backgroundColor = 'transparent';
+  }
+}

package/docs/fundamentals/tools/singleton-manager/example-complex/node_modules/page-b/node_modules/overlays/instance.js

@@ -0,0 +1,4 @@
+import { OverlaysManager } from './index.js';
+import { singletonManager } from 'singleton-manager';
+
+export const overlays = singletonManager.get('overlays::overlays::2.x') || new OverlaysManager();