@lion/ui 0.5.3 → 0.5.5

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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/formatting-and-parsing.md) of view values.
-- Advanced [validation](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/validate.md) possibilities.
-- Creation of advanced user interaction scenarios via [interaction states](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/interaction-states.md).
+- [formatting/parsing/serializing](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/formatting-and-parsing.md) of view values.
+- Advanced [validation](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/validate.md) possibilities.
+- Creation of advanced user interaction scenarios via [interaction states](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input/overview.md), a wrapper for `<input>`.
-- [LionTextarea](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/textarea/overview.md), a wrapper for `<textarea>`.
-- [LionSelect](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/select/overview.md), a wrapper for `<select>`.
+- [LionInput](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input/overview.md), a wrapper for `<input>`.
+- [LionTextarea](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/textarea/overview.md), a wrapper for `<textarea>`.
+- [LionSelect](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/combobox/overview.md), a custom implementation of a combobox.
-- [LionDate](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-date/overview.md), an alternative for `<input type="date">`.
-- [LionDatepicker](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-datepicker/overview.md), an alternative for `<input type="date">` including a calendar dropdown.
-- [LionListbox](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/listbox/overview.md), a custom implementation of a listbox.
-- [LionInputAmount](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-amount/overview.md), an alternative for `<input type="number">` special for amounts.
-- [LionInputEmail](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-email/overview.md), an alternative for `<input type="email">`.
-- [LionInputIban](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-iban/overview.md), an ING specific for an input with IBAN numbers.
-- [LionInputRange](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-range/overview.md), an alternative for `<input type="range">`.
-- [LionInputStepper](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/input-stepper/overview.md), an alternative for `<input type="number">`.
-- [LionSelectRich](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/select-rich/overview.md), an alternative for `<select>` with multiline options.
+- [LionCombobox](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/combobox/overview.md), a custom implementation of a combobox.
+- [LionDate](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-date/overview.md), an alternative for `<input type="date">`.
+- [LionDatepicker](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-datepicker/overview.md), an alternative for `<input type="date">` including a calendar dropdown.
+- [LionListbox](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/listbox/overview.md), a custom implementation of a listbox.
+- [LionInputAmount](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-amount/overview.md), an alternative for `<input type="number">` special for amounts.
+- [LionInputEmail](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-email/overview.md), an alternative for `<input type="email">`.
+- [LionInputIban](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-iban/overview.md), an ING specific for an input with IBAN numbers.
+- [LionInputRange](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-range/overview.md), an alternative for `<input type="range">`.
+- [LionInputStepper](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/input-stepper/overview.md), an alternative for `<input type="number">`.
+- [LionSelectRich](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/checkbox-group/overview.md), a wrapper for `<input type="checkbox">`.
+- [LionCheckbox](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/radio-group/overview.md), a wrapper for `<input type="radio">`.
-- [LionSwitch](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/switch/overview.md), a custom implementation of a switch.
+- [LionRadio](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/radio-group/overview.md), a wrapper for `<input type="radio">`.
+- [LionSwitch](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/fieldset/overview.md), a wrapper around multiple input fields or other fieldsets.
-- [LionForm](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/form/overview.md), enhances the functionality of the native `<form>` component.
-- [LionCheckboxGroup](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/checkbox-group/overview.md), a wrapper component for multiple checkboxes.
-- [LionRadioGroup](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/components/radio-group/overview.md), a wrapper component for multiple radio inputs.
+- [LionFieldset](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/fieldset/overview.md), a wrapper around multiple input fields or other fieldsets.
+- [LionForm](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/form/overview.md), enhances the functionality of the native `<form>` component.
+- [LionCheckboxGroup](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/checkbox-group/overview.md), a wrapper component for multiple checkboxes.
+- [LionRadioGroup](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/components/radio-group/overview.md), a wrapper component for multiple radio inputs.
 
 ## Other Resources
 
-- [Model Value](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/model-value.md)
-- [Formatting and parsing](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/formatting-and-parsing.md)
-- [Interaction states](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/interaction-states.md)
-- [Validation System](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/form/validate.md)
+- [Model Value](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/model-value.md)
+- [Formatting and parsing](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/formatting-and-parsing.md)
+- [Interaction states](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/interaction-states.md)
+- [Validation System](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/validate.md)

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

@@ -17,7 +17,6 @@ export const label = () => html`
   <style>
     .u-sr-only {
       position: absolute;
-      top: 0;
       width: 1px;
       height: 1px;
       overflow: hidden;
@@ -37,65 +36,61 @@ export const label = () => html`
 `;
 ```
 
-## Prefix
+## Input additions
+
+When using an addition to the input you could add `data-label` to add the content connected to the input via `aria-labelledby` or add `data-description` to connect it via the `aria-describedby` when the content is relevant for the screen-reader user to fill in the form field. This won't be necessary for a search icon, since that should already be clear via the label, but it is relevant in case a unit is added behind the input field.
+
+### Prefix
 
 The prefix is used for addons to the input like a minus button in the `input-stepper`.
 
-```js preview-story
-export const prefix = () => html`
-  <lion-input label="Prefix">
-    <div slot="prefix">[prefix]</div>
-  </lion-input>
-`;
+```html preview-story
+<lion-input label="Prefix">
+  <div slot="prefix" data-description>[prefix]</div>
+</lion-input>
 ```
 
-## Suffix
+### Suffix
 
 The suffix can be used for addons to the input like a calculator, datepicker or addressbook.
 In these cases a button with an icon is used.
 
-```js preview-story
-export const suffix = () => html`
-  <lion-input label="Suffix">
-    <div slot="suffix">[suffix]</div>
-  </lion-input>
-`;
+```html preview-story
+<lion-input label="Suffix">
+  <div slot="suffix" data-description>[suffix]</div>
+</lion-input>
 ```
 
-## Before
+### Before
 
 > Before slot does not have an active use case yet.
 
-```js preview-story
-export const before = () => html`
-  <lion-input label="Before">
-    <div slot="before">[before]</div>
-  </lion-input>
-`;
+```html preview-story
+<lion-input label="Before">
+  <div slot="before" data-description>[before]</div>
+</lion-input>
 ```
 
-## After
+### After
 
-```js preview-story
-export const after = () => html`
-  <lion-input label="Amount">
-    <div slot="after">EUR</div>
-  </lion-input>
-  <lion-input label="Percentage">
-    <div slot="after">%</div>
-  </lion-input>
-`;
+The after is mostly used to add a unit to the input field, such as a currency or percentage.
+
+```html preview-story
+<lion-input label="Amount">
+  <div slot="after" data-description>EUR</div>
+</lion-input>
+<lion-input label="Percentage">
+  <div slot="after" data-description>%</div>
+</lion-input>
 ```
 
 ### Examples
 
 Due to our custom inputs being Web Components, it is possible to put HTML content inside an input. For example if you want to add a button as a prefix or suffix.
 
-```js preview-story
-export const ButtonsWithFields = () => html`
-  <lion-input label="Prefix and suffix">
-    <lion-button slot="prefix">prefix</lion-button>
-    <lion-button slot="suffix">suffix</lion-button>
-  </lion-input>
-`;
+```html preview-story
+<lion-input label="Prefix and suffix">
+  <lion-button slot="prefix">prefix</lion-button>
+  <lion-button slot="suffix">suffix</lion-button>
+</lion-input>
 ```

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

@@ -4,7 +4,7 @@
 import { html } from '@mdjs/mdjs-preview';
 import { LionInput } from '@lion/ui/input.js';
 import '@lion/ui/define/lion-checkbox-group.js';
-import '@lion/ui/define/lion-checkbox-group.js';
+import '@lion/ui/define/lion-checkbox.js';
 import '@lion/ui/define/lion-combobox.js';
 import '@lion/ui/define/lion-fieldset.js';
 import '@lion/ui/define/lion-form.js';
@@ -21,7 +21,6 @@ import '@lion/ui/define/lion-listbox.js';
 import '@lion/ui/define/lion-option.js';
 import '@lion/ui/define/lion-options.js';
 import '@lion/ui/define/lion-radio-group.js';
-import '@lion/ui/define/lion-radio-group.js';
 import '@lion/ui/define/lion-radio.js';
 import '@lion/ui/define/lion-select.js';
 import '@lion/ui/define/lion-select-rich.js';
@@ -58,7 +57,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/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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
@@ -229,10 +228,14 @@ The required validator can be put onto every form field element and will make su
 
 ```js preview-story
 export const requiredValidator = () => html`
-  <lion-input .validators=${[new Required()]} label="Required"></lion-input>
+  <lion-input .validators=${[new Required()]} label="Required" .fieldName="value"></lion-input>
 `;
 ```
 
+The default `Required` validation message is "Please, enter a(n) {fieldName}". In which the "fieldName" can be provided separately via the `fieldName` attribute, with a fallback to the label. See [override fieldname](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/form/#override-fieldname) for more information.
+
+Specific required messages for a select and file-upload are created.
+
 ### String Validators
 
 Useful on input elements it allows to define how many characters can be entered.

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/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/localize/use-cases.md).
 
 ## Content
 
 | Feature                                  | Description                                   |
 | ---------------------------------------- | --------------------------------------------- |
-| [Translate Text](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/localize/text.md)    | Load and translate text in multiple languages |
-| [Format Numbers](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/localize/numbers.md) | Format numbers in multiple languages          |
-| [Format Dates](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/localize/dates.md)     | Format dates in multiple languages            |
+| [Translate Text](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/localize/text.md)    | Load and translate text in multiple languages |
+| [Format Numbers](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/localize/numbers.md) | Format numbers in multiple languages          |
+| [Format Dates](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/localize/dates.md)     | Format dates in multiple languages            |
 
 ## Installation
 

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

@@ -69,7 +69,7 @@ export const placementGlobal = () => {
 
 ## isTooltip (placementMode: 'local')
 
-As specified in the [overlay rationale](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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
@@ -374,7 +374,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/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/overlays/use-cases.md#overlaycontroller), a single controller class for handling overlays
-- [**OverlayMixin**](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/overlays/use-cases.md#overlaycontroller), a single controller class for handling overlays
+- [**OverlayMixin**](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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,4 +110,4 @@ class MyOverlayComponent extends OverlayMixin(LitElement) {
 
 ## Rationales
 
-Please check the [system rationals](https://github.com/ing-bank/lion/blob/38c495ba1fde292e3f78d5d41676c669338afb46/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/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/overlays/rationale.md) folder, where we go more in-depth.

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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/overlays/rationale.md).
+For a detailed rationale, please consult [Rationale](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/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/38c495ba1fde292e3f78d5d41676c669338afb46/docs/fundamentals/systems/overlays/configuration.md).
+We also export a few [preset configuration objects](https://github.com/ing-bank/lion/blob/a99f2e1dbfa5889d3f93ea39cd9c5aa84cc5b629/docs/fundamentals/systems/overlays/configuration.md).
 
 - withModalDialogConfig
 - withDropdownConfig

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

@@ -7,7 +7,7 @@
 - Supports caching, so a request can be prevented from reaching to network, by returning the cached response.
 - Supports JSON with `ajax.fetchJSON` by automatically serializing request body and deserializing response payload as JSON, and adding the correct Content-Type and Accept headers.
 - Adds accept-language header to requests based on application language
-- Adds XSRF header to request if the cookie is present
+- Adds XSRF header to request if the cookie is present and the request is for a mutable action (POST/PUT/PATCH/DELETE) and if the origin is the same as current origin or the request origin is in the xsrfTrustedOrigins list.
 
 ## Installation
 
@@ -132,6 +132,7 @@ Response interceptors can be async and will be awaited.
 | addCaching                       | boolean  | `false`                                                            | Whether to add the cache interceptor and start storing responses in the cache, even if `cacheOptions.useCache` is `false`                       |
 | xsrfCookieName                   | string   | `"XSRF-TOKEN"`                                                     | The name for the Cross Site Request Forgery cookie                                                                                              |
 | xsrfHeaderName                   | string   | `"X-XSRF-TOKEN"`                                                   | The name for the Cross Site Request Forgery header                                                                                              |
+| xsrfTrustedOrigins               | string[] | []                                                                 | List of trusted origins, the XSRF header will also be added if the origin is in this list.                                                      |
 | jsonPrefix                       | string   | `""`                                                               | The prefix to add to add to responses for the `.fetchJson` functions                                                                            |
 | cacheOptions.useCache            | boolean  | `false`                                                            | Whether to use the default cache interceptors to cache requests                                                                                 |
 | cacheOptions.getCacheIdentifier  | function | a function returning the string `_default`                         | A function to determine the cache that should be used for each request; used to make sure responses for one session are not used in the next    |

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

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

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

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

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

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

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

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

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

package/docs/guides/index.md

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

package/docs/guides/principles/index.md

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

package/docs/guides/principles/styling.md

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

package/exports/input-tel-dropdown-test-helpers.js

@@ -0,0 +1 @@
+export { mimicUserChangingDropdown } from '../components/input-tel-dropdown/test-helpers/mimicUserChangingDropdown.js';

package/exports/validate-messages-no-side-effects.js

@@ -1 +1,4 @@
 export { loadDefaultFeedbackMessagesNoSideEffects } from '../components/validate-messages/src/loadDefaultFeedbackMessagesNoSideEffects.js';
+export { loadComboboxMessagesNoSideEffects } from '../components/validate-messages/src/per-entrypoint/loadComboboxMessagesNoSideEffects.js';
+export { loadFormCoreMessagesNoSideEffects } from '../components/validate-messages/src/per-entrypoint/loadFormCoreMessagesNoSideEffects.js';
+export { loadInputTelMessagesNoSideEffects } from '../components/validate-messages/src/per-entrypoint/loadInputTelMessagesNoSideEffects.js';

package/input-tel-dropdown-test-helpers.js

@@ -0,0 +1 @@
+export { mimicUserChangingDropdown } from './components/input-tel-dropdown/test-helpers/mimicUserChangingDropdown.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lion/ui",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "A package of extendable web components",
   "license": "MIT",
   "author": "ing-bank",
@@ -23,6 +23,8 @@
     "./input-datepicker-translations/*": "./components/input-datepicker/translations/*",
     "./input-file-translations/*": "./components/input-file/translations/*",
     "./input-iban-translations/*": "./components/input-iban/translations/*",
+    "./input-range-translations/*": "./components/input-range/translations/*",
+    "./input-stepper-translations/*": "./components/input-stepper/translations/*",
     "./input-tel-translations/*": "./components/input-tel/translations/*",
     "./overlays-translations/*": "./components/overlays/translations/*",
     "./validate-messages-translations/*": "./components/validate-messages/translations/*",

package/validate-messages-no-side-effects.js

@@ -1 +1,4 @@
 export { loadDefaultFeedbackMessagesNoSideEffects } from './components/validate-messages/src/loadDefaultFeedbackMessagesNoSideEffects.js';
+export { loadComboboxMessagesNoSideEffects } from './components/validate-messages/src/per-entrypoint/loadComboboxMessagesNoSideEffects.js';
+export { loadFormCoreMessagesNoSideEffects } from './components/validate-messages/src/per-entrypoint/loadFormCoreMessagesNoSideEffects.js';
+export { loadInputTelMessagesNoSideEffects } from './components/validate-messages/src/per-entrypoint/loadInputTelMessagesNoSideEffects.js';