@lion/ui 0.9.1 → 0.10.0

package/docs/components/input-tel/api-table.md

@@ -22,7 +22,7 @@
 | `_focusableNode`             | protected | `HTMLElement`                             |                         | The focusable element:
could be an input, textarea, select, button or any other element with tabindex > -1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LionField            |
 | `autocomplete`               | public    | `string \| undefined`                     | `undefined`             | Delegates this property to input/textarea/select.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | NativeTextFieldMixin |
 | `formatOn`                   | protected | `string`                                  | `'change'`              | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionField            |
-| `formatOptions`              | public    |                                           | `({})`                  | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
+| `formatOptions`              | public    |                                           | `({ mode: 'auto' })`    | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
 | `formattedValue`             | public    | `string\|undefined`                       | `undefined`             | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | LionField            |
 | `serializedValue`            | public    | `string\|undefined`                       | `undefined`             | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | LionField            |
 | `_isPasting`                 | protected | `boolean`                                 | `false`                 | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | LionField            |

package/docs/components/input-tel/overview.md

@@ -39,7 +39,7 @@ export const main = () => {
 
 ## Features
 
-- Extends our [input](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input/overview.md)
+- Extends our [input](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input/overview.md)
 - Shows a mobile telephone keypad on mobile (by having a native `<input inputmode="tel">` inside)
 - Can be configured with a list of allowed region codes
 - Will be preconfigured with region derived from locale

package/docs/components/input-tel/use-cases.md

@@ -22,7 +22,7 @@ Say we have the following telephone number from Madrid, Spain: `+34919930432`.
 It contains a [country code](https://en.wikipedia.org/wiki/Country_code) (34), an [area code](https://en.wikipedia.org/wiki/Telephone_numbering_plan#Area_code) (91) and a [dial code](https://en.wikipedia.org/wiki/Mobile_dial_code) (+34 91).
 Input Tel interprets phone numbers based on their [region code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2): a two character long region representation('ES' in the telephone number above).
 
-The table below lists all possible regions worldwide. When [allowed regions](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel/#allowed-regions) are not configured,
+The table below lists all possible regions worldwide. When [allowed regions](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel/#allowed-regions) are not configured,
 all of them will be supported as values of Input Tel.
 
 ```js story
@@ -37,11 +37,11 @@ export const regionCodesTable = () => {
 The active region (accessible via readonly accessor `.activeRegion`) determines how validation and formatting
 should be applied. It is dependent on the following factors:
 
-- [allowed regions](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel/#allowed-regions): a list that determines what is allowed to become .activeRegion. If
-  [.allowedRegions has only one entry](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel/#restrict-to-one-region), .activeRegion will always be this value.
+- [allowed regions](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel/#allowed-regions): a list that determines what is allowed to become .activeRegion. If
+  [.allowedRegions has only one entry](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel/#restrict-to-one-region), .activeRegion will always be this value.
 - the modelValue or viewValue: once it contains sufficient info to derive its region code (and
-  the derived code is inside [allowed regions](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel/#allowed-regions) if configured)
-- active locale (and the derived locale is inside [allowed regions](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel/#allowed-regions) if configured)
+  the derived code is inside [allowed regions](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel/#allowed-regions) if configured)
+- active locale (and the derived locale is inside [allowed regions](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel/#allowed-regions) if configured)
 
 What follows from the list above is that .activeRegion can change dynamically, after a value
 change in the text box by the user (or when locales or allowed regions would be changed by the
@@ -130,7 +130,7 @@ export const heuristic = () => {
 Once it is configured, validation and formatting will be restricted to those
 values that are present in this list.
 
-> Note that for [InputTelDropdown](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel-dropdown/index.md), only allowed regions will
+> Note that for [InputTelDropdown](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel-dropdown/index.md), only allowed regions will
 > be shown in the dropdown list.
 
 ```js preview-story

package/docs/components/input-tel-dropdown/api-table.md

@@ -28,7 +28,7 @@
 | `_focusableNode`             | protected | `HTMLElement`                             |                                                                                      | The focusable element:
could be an input, textarea, select, button or any other element with tabindex > -1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | LionField            |
 | `autocomplete`               | public    | `string \| undefined`                     | `undefined`                                                                          | Delegates this property to input/textarea/select.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | NativeTextFieldMixin |
 | `formatOn`                   | protected | `string`                                  | `'change'`                                                                           | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LionField            |
-| `formatOptions`              | public    |                                           | `({})`                                                                               | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
+| `formatOptions`              | public    |                                           | `({ mode: 'auto' })`                                                                 | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
 | `formattedValue`             | public    | `string\|undefined`                       | `undefined`                                                                          | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | LionField            |
 | `serializedValue`            | public    | `string\|undefined`                       | `undefined`                                                                          | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value)                                                                                                                                                                                                                                                                               | LionField            |
 | `_isPasting`                 | protected | `boolean`                                 | `false`                                                                              | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | LionField            |

package/docs/components/input-tel-dropdown/overview.md

@@ -19,7 +19,7 @@ export const main = () => {
 
 ## Features
 
-- Extends our [input-tel](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-tel/overview.md)
+- Extends our [input-tel](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/input-tel/overview.md)
 - Shows dropdown list with all possible regions
 - Shows only allowed regions in dropdown list when .allowedRegions is configured
 - Highlights regions on top of dropdown list when .preferredRegions is configured

package/docs/components/listbox/api-table.md

@@ -209,7 +209,7 @@
 | `checked`                    | public    | `boolean`                             |                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | ChoiceInputMixin     |
 | `value`                      | public    |                                       |                                 | The view value. Will be delegated to \`.\_inputNode.value\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | FormatMixin          |
 | `formatOn`                   | protected | `string`                              | `'change'`                      | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | FormatMixin          |
-| `formatOptions`              | public    |                                       | `({})`                          | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | FormatMixin          |
+| `formatOptions`              | public    |                                       | `({ mode: 'auto' })`            | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | FormatMixin          |
 | `formattedValue`             | public    | `string\|undefined`                   | `undefined`                     | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | FormatMixin          |
 | `serializedValue`            | public    | `string\|undefined`                   | `undefined`                     | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | FormatMixin          |
 | `_isPasting`                 | protected | `boolean`                             | `false`                         | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | FormatMixin          |

package/docs/components/listbox/use-cases.md

@@ -139,4 +139,4 @@ Navigation will skip over disabled options. Let's disable Artichoke and Brussel
 
 ## Validation
 
-A validator can be used to make it e.g. `required`. If you want to know how to do that, please take a look at our [validation examples](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/form/validate.md).
+A validator can be used to make it e.g. `required`. If you want to know how to do that, please take a look at our [validation examples](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/systems/form/validate.md).

package/docs/components/radio-group/api-table.md

@@ -12,7 +12,7 @@
 | `checked`                    | public    | `boolean`                                 |                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | ChoiceInputMixin     |
 | `value`                      | public    |                                           |                                 | The view value. Will be delegated to \`.\_inputNode.value\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
 | `formatOn`                   | protected | `string`                                  | `'change'`                      | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionField            |
-| `formatOptions`              | public    |                                           | `({})`                          | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
+| `formatOptions`              | public    |                                           | `({ mode: 'auto' })`            | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
 | `formattedValue`             | public    | `string\|undefined`                       | `undefined`                     | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | LionField            |
 | `serializedValue`            | public    | `string\|undefined`                       | `undefined`                     | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | LionField            |
 | `_isPasting`                 | protected | `boolean`                                 | `false`                         | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | LionField            |

package/docs/components/radio-group/overview.md

@@ -20,12 +20,12 @@ export const main = () => html`
 `;
 ```
 
-- Make sure that to use a name attribute as it is necessary for our [form](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/form/overview.md)'s serialization result.
-- If you have many options for a user to pick from, consider using our [select](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/select/overview.md) instead.
+- Make sure that to use a name attribute as it is necessary for our [form](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/form/overview.md)'s serialization result.
+- If you have many options for a user to pick from, consider using our [select](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/select/overview.md) instead.
 
 ## Features
 
-Since it extends from our [fieldset](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/fieldset/overview.md), it has all the features a fieldset has.
+Since it extends from our [fieldset](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/fieldset/overview.md), it has all the features a fieldset has.
 
 - Get or set the checked value of the group:
   - modelValue (default) - `checkedValue()`

package/docs/components/select/api-table.md

@@ -43,7 +43,7 @@
 | `autofocus`                  | public    | `boolean`                             | `false`                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | LionField           |
 | `value`                      | public    |                                       |                         | The view value. Will be delegated to \`.\_inputNode.value\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField           |
 | `formatOn`                   | protected | `string`                              | `'change'`              | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionField           |
-| `formatOptions`              | public    |                                       | `({})`                  | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField           |
+| `formatOptions`              | public    |                                       | `({ mode: 'auto' })`    | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField           |
 | `formattedValue`             | public    | `string\|undefined`                   | `undefined`             | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | LionField           |
 | `serializedValue`            | public    | `string\|undefined`                   | `undefined`             | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | LionField           |
 | `_isPasting`                 | protected | `boolean`                             | `false`                 | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | LionField           |

package/docs/components/select/use-cases.md

@@ -53,7 +53,7 @@ Or by setting the `disabled` attribute on the entire `lion-select` field.
 
 ## Validation
 
-A validator can be used to make it e.g. `required`. If you want to know how to do that, please take a look at our [validation examples](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/form/validate.md).
+A validator can be used to make it e.g. `required`. If you want to know how to do that, please take a look at our [validation examples](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/systems/form/validate.md).
 
 ## Rendering and updating select options
 

package/docs/components/select-rich/api-table.md

@@ -165,6 +165,7 @@
 | `open`                                   | public    | Shows the overlay                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                        |                             | OverlayMixin   |
 | `close`                                  | public    | Hides the overlay                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                        |                             | OverlayMixin   |
 | `repositionOverlay`                      | public    | Sometimes it's needed to recompute Popper position of an overlay, for instance when we have
an opened combobox and the surrounding context changes (the space consumed by the textbox
increases vertically)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                        |                             | OverlayMixin   |
+| `_isPermanentlyDisconnected`             | protected | When we're moving around in dom, disconnectedCallback gets called.&#xA;Before we decide to teardown, let's wait to see if we were not just moving nodes around.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                        | `Promise<boolean>`          | OverlayMixin   |
 | `setCheckedIndex`                        | public    | If an array is passed for multiple-choice, it will check the indexes in array, and uncheck the rest&#xA;If a number is passed, the item with the passed index is checked without unchecking others&#xA;For single choice, \_\_onChildCheckedChanged we ensure that we uncheck siblings                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `index: number\|number[]`                                                                                                                                                                                                                                                                                                                                              |                             | LionListbox    |
 | `resetInteractionState`                  | public    | Resets touched and dirty, and recomputes prefilled                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                        |                             | LionListbox    |
 | `reset`                                  | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                        |                             | LionListbox    |

package/docs/components/select-rich/use-cases.md

@@ -302,7 +302,7 @@ LionSelectRich will give it acces to:
 - LionSelectRich itself, via `.hostElement`
 
 Code of an advanced custom invoker is shown below (this is the code for the
-invoker used in [IntlSelectRich](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/select-rich/examples.md)).
+invoker used in [IntlSelectRich](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/components/select-rich/examples.md)).
 The invoker is usually added in the invoker slot of the LionSelectRich subclass.
 However, it would also be possible for an application developer to provide the invoker
 by putting it in light dom:

package/docs/components/switch/api-table.md

@@ -14,7 +14,7 @@
 | `disabled`                   | public    | `boolean`                             | `false`                         | Boolean indicating whether or not this element is disabled.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField        |
 | `value`                      | public    |                                       |                                 | The view value. Will be delegated to \`.\_inputNode.value\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField        |
 | `formatOn`                   | protected | `string`                              | `'change'`                      | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionField        |
-| `formatOptions`              | public    |                                       | `({})`                          | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField        |
+| `formatOptions`              | public    |                                       | `({ mode: 'auto' })`            | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField        |
 | `formattedValue`             | public    | `string\|undefined`                   | `undefined`                     | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | LionField        |
 | `serializedValue`            | public    | `string\|undefined`                   | `undefined`                     | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | LionField        |
 | `_isPasting`                 | protected | `boolean`                             | `false`                         | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | LionField        |

package/docs/components/tabs/examples.md

@@ -9,7 +9,7 @@ import './src/lea-tab-panel.js';
 
 ## Lea Tabs
 
-Learn how to create the `lea tabs` in our ["introducing lion" blogpost](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/blog/ing-open-sources-lion.md).
+Learn how to create the `lea tabs` in our ["introducing lion" blogpost](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/blog/ing-open-sources-lion.md).
 
 ```js preview-story
 export const main = () => html`

package/docs/components/textarea/api-table.md

@@ -19,7 +19,7 @@
 | `_focusableNode`             | protected | `HTMLElement`                             |                         | The focusable element:
could be an input, textarea, select, button or any other element with tabindex > -1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LionField            |
 | `autocomplete`               | public    | `string \| undefined`                     | `undefined`             | Delegates this property to input/textarea/select.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | NativeTextFieldMixin |
 | `formatOn`                   | protected | `string`                                  | `'change'`              | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionField            |
-| `formatOptions`              | public    |                                           | `({})`                  | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
+| `formatOptions`              | public    |                                           | `({ mode: 'auto' })`    | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
 | `formattedValue`             | public    | `string\|undefined`                       | `undefined`             | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | LionField            |
 | `serializedValue`            | public    | `string\|undefined`                       | `undefined`             | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | LionField            |
 | `_isPasting`                 | protected | `boolean`                                 | `false`                 | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | LionField            |

package/docs/components/tooltip/api-table.md

@@ -35,6 +35,7 @@
 | `open`                             | public    | Shows the overlay                                                                                                                                                                                                                                                                                                          |                                                                                                              |                          | OverlayMixin   |
 | `close`                            | public    | Hides the overlay                                                                                                                                                                                                                                                                                                          |                                                                                                              |                          | OverlayMixin   |
 | `repositionOverlay`                | public    | Sometimes it's needed to recompute Popper position of an overlay, for instance when we have
an opened combobox and the surrounding context changes (the space consumed by the textbox
increases vertically)                                                                                                        |                                                                                                              |                          | OverlayMixin   |
+| `_isPermanentlyDisconnected`       | protected | When we're moving around in dom, disconnectedCallback gets called.&#xA;Before we decide to teardown, let's wait to see if we were not just moving nodes around.                                                                                                                                                            |                                                                                                              | `Promise<boolean>`       | OverlayMixin   |
 
 ### Events
 

package/docs/fundamentals/index.md

@@ -9,11 +9,11 @@ Here you find more details about what we offer.
 
 Let's see what each section describes.
 
-1. [Systems](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/core/overview.md) <br>
+1. [Systems](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/systems/core/overview.md) <br>
    These are the fundamental systems that power all of our components.
-2. [Tools](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/tools/helpers/overview.md) <br>
+2. [Tools](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/tools/helpers/overview.md) <br>
    Frontend Tools useful for web development but are not visual and therefore are not components.
-3. [Node Tools](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/node-tools/babel-plugin-extend-docs/overview.md) <br>
+3. [Node Tools](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/node-tools/babel-plugin-extend-docs/overview.md) <br>
    Node tools to analyse the code and for extending the documentation.
-4. [Rationales](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/rationales/side-effects.md) <br>
+4. [Rationales](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/rationales/side-effects.md) <br>
    The reasoning behind some of our decisions.

package/docs/fundamentals/node-tools/providence-analytics/overview.md

@@ -28,7 +28,7 @@ It does this via the [oxc parser](https://oxc.rs/docs/guide/usage/parser.html),
 Providence expects an analyzer name that tells it what type of analysis to run:
 
 ```bash
-npx providence analyze <analyzer-name>
+npx providence-analytics analyze <analyzer-name>
 ```
 
 By default Providence ships these analyzers:
@@ -42,7 +42,7 @@ By default Providence ships these analyzers:
 Let's say we run `find-imports`:
 
 ```bash
-npx providence analyze find-imports
+npx providence-analytics analyze find-imports
 ```
 
 Now it retrieves all relevant data about es module imports.
@@ -68,14 +68,14 @@ For a "find" analyzer, there is one project involved (the target project).
 We can specify it like this (we override the default current working directory):
 
 ```bash
-npx providence analyze find-imports -t /importing/project
+npx providence-analytics analyze find-imports -t /importing/project
 ```
 
 For a "match" analyzer, there is also a reference project.
 Here we match the exports of the reference project (-r) against the imports of the target project (-t).
 
 ```bash
-npx providence analyze match-imports -t /importing/project -r /exporting/project
+npx providence-analytics analyze match-imports -t /importing/project -r /exporting/project
 ```
 
 ## Utils
@@ -91,5 +91,5 @@ For a better understanding, check out the utils folders (tests and code).
 For more options, see:
 
 ```bash
-npx providence --help
+npx providence-analytics --help
 ```

package/docs/fundamentals/node-tools/publish-docs/overview.md

@@ -31,7 +31,7 @@ For a Mono Repository
    ```md
    # My Pkg
 
-   [=> See Source <=](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/docs/deep/dir/overview.md)
+   [=> See Source <=](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/docs/deep/dir/overview.md)
    ```
 
 ## CLI flags
@@ -61,7 +61,7 @@ Bring the `overview.md` in a docs folder along.
 👉 `packages/[my-package]/docs/overview.md`
 
 ```md
-[=> See Source <=](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/docs/deep/dir/overview.md)
+[=> See Source <=](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/docs/deep/dir/overview.md)
 ```
 
 Add a `use-cases.md`
@@ -69,7 +69,7 @@ Add a `use-cases.md`
 👉 `packages/[my-package]/docs/use-cases.md`
 
 ```md
-[=> See Source <=](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/docs/deep/dir/use-cases.md)
+[=> See Source <=](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/docs/deep/dir/use-cases.md)
 ```
 
 So you will end up with something like this in your package.

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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/node-tools/remark-extend/overview.md)
+- Import lion documentation and adjust it using [remark-extend](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/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/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/node-tools/remark-extend/overview.md).
 
 As an example you can create `docs/components/tabs/overview.md`.
 

package/docs/fundamentals/rationales/accessibility.md

@@ -25,4 +25,4 @@ Internally, we delegate all intricacies involved in managing light dom to SlotMi
 SlotMixin automatically mediates between light dom provided by the user ('public slots') and light dom provided by the component author ('private slots').
 Also, SlotMixin allows to hook into the reactive update loop of LitElement (automatically rerendering on property changes) and it automatically respects
 the scoped registry belonging to the shadow root.
-More details about SlotMixin can be found in the [SlotMixin documentation](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/core/SlotMixin.md)
+More details about SlotMixin can be found in the [SlotMixin documentation](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/systems/core/SlotMixin.md)

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

@@ -152,4 +152,4 @@ This will make sure that the slot provided by the user always takes precedence a
 
 ### Default slot
 
-As can be seen in the example of [SlotFunctionResults](https://github.com/ing-bank/lion/blob/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/core/#slotfunctionresults), '' can be used to add content to the default slot
+As can be seen in the example of [SlotFunctionResults](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/systems/core/#slotfunctionresults), '' can be used to add content to the default slot

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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/core/#deduping-of-mixins)
+- [function to deduplicate mixins (dedupeMixin)](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/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/api-table.md

@@ -40,7 +40,7 @@
 | `autofocus`                  | public    | `boolean`                             | `false`                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | FocusMixin            |
 | `value`                      | public    |                                       |                         | The view value. Will be delegated to \`.\_inputNode.value\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | FormatMixin           |
 | `formatOn`                   | protected | `string`                              | `'change'`              | Event that will trigger formatting (more precise, visual update of the view, so the
user sees the formatted value)
Default: 'change'                                                                                                                                                                                                                                                                                                                                                                                                                                                              | FormatMixin           |
-| `formatOptions`              | public    |                                       | `({})`                  | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | FormatMixin           |
+| `formatOptions`              | public    |                                       | `({ mode: 'auto' })`    | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | FormatMixin           |
 | `formattedValue`             | public    | `string\|undefined`                   | `undefined`             | The view value is the result of the formatter function (when available).
The result will be stored in the native \_inputNode (usually an input\[type=text]).

Examples:
- For a date input, this would be '20/01/1999' (dependent on locale).
- For a number input, this could be '1,234.56' (a String representation of modelValue
1234.56)                                                                                                                                                                                                                                      | FormatMixin           |
 | `serializedValue`            | public    | `string\|undefined`                   | `undefined`             | The serialized version of the model value.
This value exists for maximal compatibility with the platform API.
The serialized value can be an interface in context where data binding is not
supported and a serialized string needs to be set.

Examples:
- For a date input, this would be the iso format of a date, e.g. '1999-01-20'.
- For a number input this would be the String representation of a float ('1234.56'
  instead of 1234.56)

When no parser is available, the value is usually the same as the formattedValue
(being \_inputNode.value) | FormatMixin           |
 | `_isPasting`                 | protected | `boolean`                             | `false`                 | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | FormatMixin           |

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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/components/input-amount/overview.md).
+> For an actual amount input, check out [lion-input-amount](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/form/assets/FormatMixinDiagram-1.svg 'Standard flow')
+![Standard flow](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/form/assets/FormatMixinDiagram-2.svg 'Unparseable flow')
+![Unparseable flow](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/docs/fundamentals/systems/form/assets/FormatMixinDiagram-3.svg 'Imperative flow')
+![Imperative flow](https://github.com/ing-bank/lion/blob/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/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/9825cbf65639370f2e4e7bb994e3bc1ba60b0f9a/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/43b694e7f86a4b0e8d949e2db0dd74af5c81de73/docs/fundamentals/systems/form/formatting-and-parsing.md)
 
 ### Event meta