@lion/ui 0.20.0 → 0.21.1-menu-system.0

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

@@ -16,198 +16,70 @@ eleventyNavigation:
 
 ### Fields
 
-| Name                         | Privacy   | Type                                      | Default                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Inherited From       |
-| ---------------------------- | --------- | ----------------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
-| `activePhoneNumberType`      | public    |                                           |                                                                                      | Type of phone number, derived from textbox value. Enum with values:
-'fixed-line'
-'fixed-line-or-mobile'
-'mobile'
-'pager'
-'personal-number'
-'premium-rate'
-'shared-cost'
-'toll-free'
-'uan'
-'voip'
-'unknown'
See https\://www\.npmjs.com/package/awesome-phonenumber                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | LionInputTel         |
-| `activeRegion`               | public    | `string`                                  |                                                                                      | Currently active region based on:
1\. allowed regions: get the region from configured allowed regions (if one entry)
2\. user input: try to derive active region from user input
3\. locale: try to get the region from locale (\`html\[lang]\` attribute)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | LionInputTel         |
-| `allowCrossRootRegistration` | public    | `boolean`                                 | `false`                                                                              | To encourage accessibility best practices, \`form-element-register\` events
do not pierce through shadow roots. This forces the developer to create form groups and fieldsets that automatically allow the creation of accessible relationships in the same dom tree.
Use this option if you know what you're doing. It will then be possible to nest FormControls
inside shadow dom. See https\://lion.js.org/fundamentals/rationales/accessibility/#shadow-roots-and-accessibility                                                                                                                                                                                                                                                                                                                                                                                        | LionField            |
-| `allowedRegions`             | public    | `RegionCode[]`                            | `[]`                                                                                 | The regions that should be considered when international phone numbers are detected.
(when not configured, all regions worldwide will be considered)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | LionInputTel         |
-| `autocomplete`               | public    | `string \| undefined`                     | `'tel'`                                                                              | Delegates this property to input/textarea/select.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | NativeTextFieldMixin |
-| `autofocus`                  | public    | `boolean`                                 | `false`                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `defaultValidators`          | public    | `Validator[]`                             | `[]`                                                                                 | Used by Subclassers to add default Validators to a particular FormControl.
A date input for instance, always needs the isDate validator.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LionField            |
-| `dirty`                      | public    | `boolean`                                 | `false`                                                                              | True when user has changed the value of the field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | LionField            |
-| `disabled`                   | public    | `boolean`                                 | `false`                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `fieldName`                  | public    | `string`                                  |                                                                                      | Set a default name for this field, so that validation feedback will be always
accessible and linguistically correct                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
-| `filled`                     | public    | `boolean`                                 | `false`                                                                              | True when the modelValue is non-empty (see \_isEmpty in FormControlMixin)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
-| `focused`                    | public    | `boolean`                                 | `false`                                                                              | Whether the focusable element within (\`.\_focusableNode\`) is focused.
Reflects to attribute '\[focused]' as a styling hook                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | LionField            |
-| `focusedVisible`             | public    | `boolean`                                 | `false`                                                                              | Whether the focusable element within (\`.\_focusableNode\`) matches ':focus-visible'
Reflects to attribute '\[focused-visible]' as a styling hook
See: https\://developer.mozilla.org/en-US/docs/Web/CSS/:focus-visible                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `formatCountryCodeStyle`     | public    | `string`                                  | `'default'`                                                                          | Extra styling of the format strategy
default \| parentheses                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel         |
-| `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    |                                           | `({ mode: 'auto' })`                                                                 | Configuration object that will be available inside the formatter function                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
-| `formatStrategy`             | public    | `PhoneNumberFormat`                       | `'international'`                                                                    | Determines what the formatter output should look like.
Formatting strategies as provided by google-libphonenumber
See: https\://www\.npmjs.com/package/google-libphonenumber                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | LionInputTel         |
-| `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            |
-| `hasFeedbackFor`             | public    | `ValidationType[]`                        | `[]`                                                                                 | As soon as validation happens (after modelValue/validators/validator param change), this
array is updated with the active ValidationTypes ('error'\|'warning'\|'success'\|'info' etc.).
Notice the difference with \`.showsFeedbackFor\`, which filters \`.hasFeedbackFor\` based on
\`.feedbackCondition()\`.

For styling purposes, will be reflected to \[has-feedback-for="error warning"]. This can
be useful for subtle visual feedback on keyup, like a red/green border around an input.                                                                                                                                                                                                                                                                                                                                                                | LionField            |
-| `helpText`                   | public    | `string`                                  |                                                                                      | The helpt text for the input node.
When no light dom defined via \[slot=help-text], this value will be used                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `isPending`                  | public    | `boolean`                                 | `false`                                                                              | Flag indicating whether async validation is pending.
Creates attribute \[is-pending] as a styling hook                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionField            |
-| `label`                      | public    | `string`                                  |                                                                                      | The label text for the input node.
When no light dom defined via \[slot=label], this value will be used.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LionField            |
-| `labelSrOnly`                | public    | `boolean`                                 | `false`                                                                              | The label will only be visible for srceen readers when true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | LionField            |
-| `modelValue`                 | public    |                                           |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `name`                       | public    | `string`                                  | `''`                                                                                 | The name the element will be registered with to the .formElements collection
of the parent. Also, it serves as the key of key/value pairs in
 modelValue/serializedValue objects                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | LionField            |
-| `operationMode`              | public    | `OperationMode`                           |                                                                                      | Types of input interaction of the FormControl (for instance 'enter'\|'select'\|'upload')                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | LionField            |
-| `placeholder`                | public    | `string`                                  | `''`                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInput            |
-| `preferredRegions`           | public    | `RegionCode[]`                            | `[]`                                                                                 | Regions that will be shown on top of the dropdown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | LionInputTel         |
-| `prefilled`                  | public    | `boolean`                                 | `false`                                                                              | True when user has left non-empty field or input is prefilled.
The name must be seen from the point of view of the input field:
once the user enters the input field, the value is non-empty.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | LionField            |
-| `readOnly`                   | public    | `boolean`                                 | `false`                                                                              | A Boolean attribute which, if present, indicates that the user should not be able to edit
the value of the input. The difference between disabled and readonly is that read-only
controls can still function, whereas disabled controls generally do not function as
controls until they are enabled.
(From: https\://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-readonly)                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LionField            |
-| `refs`                       | public    | `object`                                  | `{ /** @type {DropdownRef} */ dropdown: /** @type {DropdownRef} */ (createRef()), }` |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                      |
-| `selectionEnd`               | public    | `number`                                  |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | NativeTextFieldMixin |
-| `selectionStart`             | public    | `number`                                  |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | NativeTextFieldMixin |
-| `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            |
-| `showsFeedbackFor`           | public    | `ValidationType[]`                        | `[]`                                                                                 | Based on outcome of feedbackCondition, this array decides what ValidationTypes should be
shown in validationFeedback, based on meta data like interaction states.

For styling purposes, it reflects it \`\[shows-feedback-for="error warning"]\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | LionField            |
-| `slots`                      | public    |                                           |                                                                                      | Adds ".\_feedbackNode" as described below                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
-| `submitted`                  | public    |                                           |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `touched`                    | public    | `boolean`                                 | `false`                                                                              | True when user has focused and left(blurred) the field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
-| `type`                       | public    | `string`                                  | `'text'`                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInput            |
-| `validationStates`           | public    | `ValidationStates`                        | `{}`                                                                                 | The outcome of a validation 'round'. Keyed by ValidationType and Validator name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `validators`                 | public    | `Validator[]`                             | `[]`                                                                                 | Used by Application Developers to add Validators to a FormControl.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | LionField            |
-| `value`                      | public    |                                           |                                                                                      | The view value. Will be delegated to \`.\_inputNode.value\`

Note: Overrides the implementation from FormatMixin                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | LionField            |
-| `_allCountriesLabel`         | protected | `string`                                  | `''`                                                                                 | Group label for all countries, when preferredCountries are shown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                      |
-| `_allowedOrAllRegions`       | protected | `RegionCode[]`                            |                                                                                      | Used for rendering the region/country list                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionInputTel         |
-| `_allValidators`             | protected | `(Validator \| MetaValidator)[]`          |                                                                                      | Combination of validators provided by Application Developer and the default validators                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | LionField            |
-| `_ariaDescribedNodes`        | public    | `HTMLElement[]`                           | `[]`                                                                                 | Contains all elements that should end up in aria-describedby of \`.\_inputNode\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | LionField            |
-| `_ariaLabelledNodes`         | public    | `HTMLElement[]`                           | `[]`                                                                                 | Contains all elements that should end up in aria-labelledby of \`.\_inputNode\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `_feedbackConditionMeta`     | protected |                                           |                                                                                      | Allows Subclassers to add meta info for feedbackCondition                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
-| `_feedbackNode`              | protected |                                           |                                                                                      | Element where validation feedback will be rendered to                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | LionField            |
-| `_focusableNode`             | protected | `HTMLElement`                             |                                                                                      | The focusable element:
could be an input, textarea, select, button or any other element with tabindex > -1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | LionField            |
-| `_helpTextNode`              | protected |                                           |                                                                                      | Element where help text will be rendered to                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | LionField            |
-| `_inputId`                   | protected | `string`                                  |                                                                                      | Unique id that can be used in all light dom                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | LionField            |
-| `_inputNode`                 | protected | `HTMLInputElement \| HTMLTextAreaElement` |                                                                                      | The interactive (form) element. Can be a native element like input/textarea/select or
an element with tabindex > -1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
-| `_isHandlingUserInput`       | protected | `boolean`                                 | `false`                                                                              | Flag that will be set when user interaction takes place (for instance after an 'input'
event). Will be added as meta info to the \`model-value-changed\` event. Depending on
whether a user is interacting, formatting logic will be handled differently.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | LionField            |
-| `_isPasting`                 | protected | `boolean`                                 | `false`                                                                              | Whether the user is pasting content. Allows Subclassers to do this in their subclass:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | LionField            |
-| `_isRepropagationEndpoint`   | public    | `boolean`                                 | `false`                                                                              | By default, a field with \_repropagationRole 'choice-group' will act as an
'endpoint'. This means it will be considered as an individual field: for
a select, individual options will not be part of the formPath. They
will.
Similarly, components that (a11y wise) need to be fieldsets, but 'interaction wise'
(from Application Developer perspective) need to be more like fields
(think of an amount-input with a currency select box next to it), can set this
to true to hide private internals in the formPath.                                                                                                                                                                                                                                                                                                                                    | LionField            |
-| `_labelNode`                 | protected |                                           |                                                                                      | Element where label will be rendered to                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
-| `_leaveEvent`                | protected | `string`                                  | `'blur'`                                                                             | The event that triggers the touched state                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | LionField            |
-| `_parentFormGroup`           | protected | `FormRegistrarHost \| undefined`          | `undefined`                                                                          | The registrar this FormControl registers to, Usually a descendant of FormGroup or
ChoiceGroup                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | LionField            |
-| `_phoneUtil`                 | protected | `AwesomePhoneNumber\|null`                |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel         |
-| `_phoneUtilLoadComplete`     | protected | `Promise<PhoneNumber>`                    |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel         |
-| `_preferredCountriesLabel`   | protected | `string`                                  | `''`                                                                                 | Group label for preferred countries, when preferredCountries are shown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                      |
-| `_repropagationRole`         | public    | `'child'\|'choice-group'\|'fieldset'`     | `'child'`                                                                            | Based on the role, details of handling model-value-changed repropagation differ.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | LionField            |
-| `_requestedToBeDisabled`     | protected | `boolean`                                 | `false`                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField            |
-| `_templateDataDropdown`      | protected | `TemplateDataForDropdownInputTel`         |                                                                                      | This method provides a TemplateData object to be fed to pure template functions, a.k.a.&#xA;Pure Templates™. The goal is to totally decouple presentation from logic here, so that&#xA;Subclassers can override all content without having to loose private info contained&#xA;within the template function that was overridden.&#xA;&#xA;Subclassers would need to make sure all the contents of the TemplateData object are implemented&#xA;by making sure they are coupled to the right 'ref' (\[data-ref=dropdown] in this example),&#xA;with the help of lit's spread operator directive.&#xA;To enhance this process, the TemplateData object is completely typed. Ideally, this would be&#xA;enhanced by providing linters that make sure all of their required members are implemented by&#xA;a Subclasser.&#xA;When a Subclasser wants to add more data, this can be done via: |                      |
-| `_valueChangedEvent`         | protected | `string`                                  | `'model-value-changed'`                                                              | The event that triggers the dirty state                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionField            |
-| `_visibleMessagesAmount`     | protected | `number`                                  | `1`                                                                                  | The amount of feedback messages that will visible in LionValidationFeedback                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | LionField            |
+| Name                       | Privacy   | Type                              | Default                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Inherited From |
+| -------------------------- | --------- | --------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `activePhoneNumberType`    | public    |                                   |                                                                                      | Type of phone number, derived from textbox value. Enum with values:&#xA;-'fixed-line'&#xA;-'fixed-line-or-mobile'&#xA;-'mobile'&#xA;-'pager'&#xA;-'personal-number'&#xA;-'premium-rate'&#xA;-'shared-cost'&#xA;-'toll-free'&#xA;-'uan'&#xA;-'voip'&#xA;-'unknown'&#xA;See https\://www\.npmjs.com/package/awesome-phonenumber                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | LionInputTel   |
+| `activeRegion`             | public    | `string`                          |                                                                                      | Currently active region based on:&#xA;1\. allowed regions: get the region from configured allowed regions (if one entry)&#xA;2\. user input: try to derive active region from user input&#xA;3\. locale: try to get the region from locale (\`html\[lang]\` attribute)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | LionInputTel   |
+| `allowedRegions`           | public    | `RegionCode[]`                    | `[]`                                                                                 | The regions that should be considered when international phone numbers are detected.&#xA;(when not configured, all regions worldwide will be considered)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | LionInputTel   |
+| `autocomplete`             | public    | `string`                          | `'tel'`                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel   |
+| `fieldName`                | public    |                                   |                                                                                      | Set a default name for this field, so that validation feedback will be always&#xA;accessible and linguistically correct                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | LionInputTel   |
+| `formatCountryCodeStyle`   | public    | `string`                          | `'default'`                                                                          | Extra styling of the format strategy&#xA;default \| parentheses                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel   |
+| `formatStrategy`           | public    | `PhoneNumberFormat`               | `'international'`                                                                    | Determines what the formatter output should look like.&#xA;Formatting strategies as provided by google-libphonenumber&#xA;See: https\://www\.npmjs.com/package/google-libphonenumber                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | LionInputTel   |
+| `placeholder`              | public    | `string`                          | `''`                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInput      |
+| `preferredRegions`         | public    | `RegionCode[]`                    | `[]`                                                                                 | Regions that will be shown on top of the dropdown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | LionInputTel   |
+| `readOnly`                 | public    | `boolean`                         | `false`                                                                              | A Boolean attribute which, if present, indicates that the user should not be able to edit&#xA;the value of the input. The difference between disabled and readonly is that read-only&#xA;controls can still function, whereas disabled controls generally do not function as&#xA;controls until they are enabled.&#xA;&#xA;(From: https\://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-readonly)                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | LionInput      |
+| `refs`                     | public    | `object`                          | `{ /** @type {DropdownRef} */ dropdown: /** @type {DropdownRef} */ (createRef()), }` |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                |
+| `slots`                    | public    |                                   |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInput      |
+| `type`                     | public    | `string`                          | `'text'`                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInput      |
+| `_allCountriesLabel`       | protected | `string`                          | `''`                                                                                 | Group label for all countries, when preferredCountries are shown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                |
+| `_allowedOrAllRegions`     | protected | `RegionCode[]`                    |                                                                                      | Used for rendering the region/country list                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | LionInputTel   |
+| `_feedbackConditionMeta`   | protected |                                   |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField      |
+| `_focusableNode`           | protected |                                   |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionField      |
+| `_inputNode`               | protected | `HTMLInputElement`                |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInput      |
+| `_langIso`                 | protected | `RegionCode \| undefined`         | `undefined`                                                                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel   |
+| `_phoneUtil`               | protected | `AwesomePhoneNumber\|null`        |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel   |
+| `_phoneUtilLoadComplete`   | protected | `Promise<PhoneNumber>`            |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | LionInputTel   |
+| `_preferredCountriesLabel` | protected | `string`                          | `''`                                                                                 | Group label for preferred countries, when preferredCountries are shown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                |
+| `_templateDataDropdown`    | protected | `TemplateDataForDropdownInputTel` |                                                                                      | This method provides a TemplateData object to be fed to pure template functions, a.k.a.&#xA;Pure Templates™. The goal is to totally decouple presentation from logic here, so that&#xA;Subclassers can override all content without having to loose private info contained&#xA;within the template function that was overridden.&#xA;&#xA;Subclassers would need to make sure all the contents of the TemplateData object are implemented&#xA;by making sure they are coupled to the right 'ref' (\[data-ref=dropdown] in this example),&#xA;with the help of lit's spread operator directive.&#xA;To enhance this process, the TemplateData object is completely typed. Ideally, this would be&#xA;enhanced by providing linters that make sure all of their required members are implemented by&#xA;a Subclasser.&#xA;When a Subclasser wants to add more data, this can be done via: |                |
 
 ### Methods
 
-| Name                                     | Privacy   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Parameters                                                                                                                                                     | Return                                                    | Inherited From       |
-| ---------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------- |
-| `addToAriaDescribedBy`                   | public    | Allows to add element references to aria-describedby attribute.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `element: HTMLElement, { idPrefix = '', reorder = true }, customConfig: {idPrefix?:string; reorder?: boolean}`                                                 |                                                           | LionField            |
-| `addToAriaLabelledBy`                    | public    | Allows to add extra element references to aria-labelledby attribute.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `element: HTMLElement, { idPrefix = '', reorder = true }, customConfig: {idPrefix?:string; reorder?: boolean}`                                                 |                                                           | LionField            |
-| `attachShadow`                           | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `options: ShadowRootInit`                                                                                                                                      | `ShadowRoot`                                              | LionField            |
-| `blur`                                   | public    | Calls \`blur()\` on focusable element within                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                                                                                                                                                                |                                                           | LionField            |
-| `clear`                                  | public    | Clears modelValue.&#xA;Interaction states are not cleared (use resetInteractionState for this)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                |                                                           | LionField            |
-| `click`                                  | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `createScopedElement`                    | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `tagName`                                                                                                                                                      |                                                           | LionField            |
-| `defineScopedElement`                    | public    | Defines a scoped element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `tagName: string, classToBeRegistered: typeof HTMLElement`                                                                                                     |                                                           | LionField            |
-| `deserializer`                           | public    | Converts \`.serializedValue\` to \`.modelValue\`&#xA;For instance, an iso formatted date string to a Date object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `v: ?`                                                                                                                                                         | `?`                                                       | LionField            |
-| `feedbackCondition`                      | public    | Allows the Application Developer to specify when a feedback message should be shown                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `type: string, meta: object, currentCondition: ((type: string, meta: object) => boolean)`                                                                      | `boolean`                                                 | LionField            |
-| `focus`                                  | public    | Calls \`focus()\` on focusable element within                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                |                                                           | LionField            |
-| `formatter`                              | public    | Converts modelValue to formattedValue (formattedValue will be synced with&#xA;\`.\_inputNode.value\`)&#xA;For instance, a Date object to a localized date.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `modelValue: string`                                                                                                                                           | `string`                                                  | LionField            |
-| `initInteractionState`                   | public    | Evaluations performed on connectedCallback.&#xA;This method is public, so it can be called at a later moment (when we need to wait for&#xA;registering children for instance) as well.&#xA;Since this method will be called twice in last mentioned scenario, it must stay idempotent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                |                                                           | LionField            |
-| `makeRequestToBeDisabled`                | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `parser`                                 | public    | Converts viewValue to modelValue&#xA;For instance, a localized date to a Date Object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `viewValue: string`                                                                                                                                            | `string`                                                  | LionField            |
-| `preprocessor`                           | public    | Preprocessors could be considered 'live formatters'. Their result is shown to the user&#xA;on keyup instead of after blurring the field. The biggest difference between preprocessors&#xA;and formatters is their moment of execution: preprocessors are run before modelValue is&#xA;computed (and work based on view value), whereas formatters are run after the parser (and&#xA;are based on modelValue)&#xA;Automatically formats code while typing. It depends on a preprocessro that smartly&#xA;updates the viewValue and caret position for best UX.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `viewValue: string, { currentCaretIndex, prevViewValue }, options: @param {string} options.prevViewValue    * @param {number} options.currentCaretIndex    * ` | `{ viewValue: string; caretIndex: number; } \| undefined` | LionField            |
-| `removeFromAriaDescribedBy`              | public    | Allows to remove element references from aria-describedby attribute.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `element: HTMLElement`                                                                                                                                         |                                                           | LionField            |
-| `removeFromAriaLabelledBy`               | public    | Allows to remove element references from aria-labelledby attribute.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `element: HTMLElement`                                                                                                                                         |                                                           | LionField            |
-| `reset`                                  | public    | Resets modelValue to initial value.&#xA;Interaction states are cleared                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                |                                                           | LionField            |
-| `resetInteractionState`                  | public    | Resets touched and dirty, and recomputes prefilled                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                |                                                           | LionField            |
-| `retractRequestToBeDisabled`             | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `serializer`                             | public    | Converts \`.modelValue\` to \`.serializedValue\`&#xA;For instance, a Date object to an iso formatted date string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `v: ?`                                                                                                                                                         | `string`                                                  | LionField            |
-| `updateSync`                             | public    | An abstraction that has the exact same api as \`requestUpdate\`, but taking&#xA;into account:&#xA;- \[member order independence]\(https\://github.com/webcomponents/gold-standard/wiki/Member-Order-Independence)&#xA;- property effects start when all (light) dom has initialized (on firstUpdated)&#xA;- property effects don't interrupt the first meaningful paint&#xA;- compatible with propertyAccessor.\`hasChanged\`: no manual checks needed or accidentally&#xA;run property effects / events when no change happened&#xA;effects when values didn't change&#xA;All code previously present in requestUpdate can be placed in this method.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `name: string, oldValue: ?`                                                                                                                                    |                                                           | LionField            |
-| `validate`                               | public    | Triggered by:&#xA; \- modelValue change&#xA; \- change in the 'validators' array&#xA; \- change in the config of an individual Validator&#xA;&#xA;Three situations are handled:&#xA;- a1) the FormControl is empty: further execution is halted. When the Required Validator&#xA;(being mutually exclusive to the other Validators) is applied, it will end up in the&#xA;validation result (as the only Validator, since further execution was halted).&#xA;- a2) there are synchronous Validators: this is the most common flow. When modelValue hasn't&#xA;changed since last async results were generated, 'sync results' are merged with the&#xA;'async results'.&#xA;- a3) there are asynchronous Validators: for instance when server side evaluation is needed.&#xA;Executions are scheduled and awaited and the 'async results' are merged with the&#xA;'sync results'.&#xA;&#xA;- b) there are MetaValidators. After steps a1, a2, or a3 are finished, the holistic&#xA;MetaValidators (evaluating the total result of the 'regular' (a1, a2 and a3) validators)&#xA;will be run...&#xA;&#xA;Situations a2 and a3 are not mutually exclusive and can be triggered within one \`validate()\`&#xA;call. Situation b will occur after every call. | `{ clearCurrentResult = false }, opts: { clearCurrentResult?: boolean }`                                                                                       |                                                           | LionField            |
-| `_calculateValues`                       | protected | Responsible for storing all representations(modelValue, serializedValue, formattedValue&#xA;and value) of the input value. Prevents infinite loops, so all value observers can be&#xA;treated like they will only be called once, without indirectly calling other observers.&#xA;(in fact, some are called twice, but the \_\_preventRecursiveTrigger lock prevents the&#xA;second call from having effect).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `{ source }, config: {source:'model'\|'serialized'\|'formatted'\|null}`                                                                                        |                                                           | LionField            |
-| `_connectSlotMixin`                      | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_dispatchInitialModelValueChangedEvent` | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_dispatchModelValueChangedEvent`        | protected | This is wrapped in a distinct method, so that parents can control when the changed event&#xA;is fired. For objects, a deep comparison might be needed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `args: { modelValue: unknown; }[]`                                                                                                                             |                                                           | LionField            |
-| `_enhanceLightDomA11y`                   | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_enhanceLightDomA11yForAdditionalSlots` | protected | Enhances additional slots(prefix, suffix, before, after) defined by developer.&#xA;&#xA;When boolean attribute data-label or data-description is found,&#xA;the slot element will be connected to the input via aria-labelledby or aria-describedby                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `additionalSlots: string[]`                                                                                                                                    |                                                           | LionField            |
-| `_enhanceLightDomClasses`                | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_feedbackTemplate`                      | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_getAriaDescriptionElements`            | protected | This function exposes descripion elements that a FormGroup should expose to its&#xA;children. See FormGroupMixin.\_\_getAllDescriptionElementsInParentChain()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                | `Array.<HTMLElement>`                                     | LionField            |
-| `_groupOneTemplate`                      | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_groupTwoTemplate`                      | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_hasFeedbackVisibleFor`                 | protected | Used to translate \`.hasFeedbackFor\` and \`.shouldShowFeedbackFor\` to \`.showsFeedbackFor\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `type: string`                                                                                                                                                 |                                                           | LionField            |
-| `_helpTextTemplate`                      | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_initModelValueBasedOnDropdown`         | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           |                      |
-| `_inputGroupAfterTemplate`               | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_inputGroupBeforeTemplate`              | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_inputGroupInputTemplate`               | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_inputGroupPrefixTemplate`              | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult \| nothing`                               | LionField            |
-| `_inputGroupSuffixTemplate`              | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult \| nothing`                               | LionField            |
-| `_inputGroupTemplate`                    | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_isEmpty`                               | protected | Used for Required validation and computation of interaction states.&#xA;We need to override this, because we prefill the input with the region code (like +31), but for proper UX,&#xA;we don't consider this as having interaction state \`prefilled\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `modelValue: string`                                                                                                                                           | `boolean`                                                 | LionField            |
-| `_isPrivateSlot`                         | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `slotName: string`                                                                                                                                             | `boolean`                                                 | LionField            |
-| `_iStateOnLeave`                         | protected | Sets touched value to true and reevaluates prefilled state.&#xA;When false, on next interaction, user will start with a clean state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                |                                                           | LionField            |
-| `_iStateOnValueChange`                   | protected | Sets dirty value and validates when already touched or invalid                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                |                                                           | LionField            |
-| `_labelTemplate`                         | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                | `TemplateResult`                                          | LionField            |
-| `_onBeforeRepropagateChildrenValues`     | protected | Hook for Subclassers to add logic before repropagation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `ev: CustomEvent`                                                                                                                                              |                                                           | LionField            |
-| `_onChange`                              | protected | Dispatches custom bubble event                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | `ev: Event=`                                                                                                                                                   |                                                           | LionField            |
-| `_onDirtyChanged`                        | protected | Dispatches event on touched state change                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                                                                                                                                                                |                                                           | LionField            |
-| `_onDropdownValueChange`                 | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `event: OnDropdownChangeEvent`                                                                                                                                 |                                                           |                      |
-| `_onLabelClick`                          | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_onModelValueChanged`                   | protected | Responds to modelValue changes in the synchronous cycle (most subclassers should listen to&#xA;the asynchronous cycle ('modelValue' in the .updated lifecycle))                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `args: { modelValue: unknown; }[]`                                                                                                                             |                                                           | LionField            |
-| `_onPhoneNumberUtilReady`                | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionInputTel         |
-| `_onTouchedChanged`                      | protected | Dispatches event on touched state change                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                                                                                                                                                                |                                                           | LionField            |
-| `_onUserInputChanged`                    | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_onValidatorUpdated`                    | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `e: Event\|CustomEvent`                                                                                                                                        |                                                           | LionField            |
-| `_prioritizeAndFilterFeedback`           | protected | Orders all active validators in this.\_\_validationResult.&#xA;Can also filter out occurrences (based on interaction states)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `{ validationResult }, opts: { validationResult: Validator[] }`                                                                                                | `Validator[]`                                             | LionField            |
-| `_proxyInputEvent`                       | protected | This can be called whenever the view value should be updated. Dependent on component type&#xA;("input" for \<input> or "change" for \<select>(mainly for IE)) a different event should be&#xA;used  as source for the "user-input-changed" event (which can be seen as an abstraction&#xA;layer on top of other events (input, change, whatever))                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                |                                                           | LionField            |
-| `_reflectBackFormattedValueToUser`       | protected | Note: Overrides the implementation from FormatMixin                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                |                                                           | LionField            |
-| `_reflectBackOn`                         | protected | Do not reflect back .formattedValue during typing (this normally wouldn't happen when&#xA;FormatMixin calls \_calculateValues based on user input, but for LionInputTel we need to&#xA;call it on .activeRegion change)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                | `boolean`                                                 | LionField            |
-| `_repropagationCondition`                | protected | Usually, we don't use composition in regular LionFields (non choice-groups). Here we use a LionSelect(Rich) inside.&#xA;We don't want to repropagate any children, since an Application Developer is not concerned with these internals (see repropate logic in FormControlMixin)&#xA;Also, we don't want to give (wrong) info to InteractionStateMixin, that will set the wrong interaction states based on child info.&#xA;TODO: Make "this.\_repropagationRole !== 'child'" the default for FormControlMixin&#xA;(so that FormControls used within are never repropagated for LionFields)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `target: FormControlHost`                                                                                                                                      |                                                           | LionField            |
-| `_setActiveRegion`                       | protected | Protected setter for activeRegion, only meant for subclassers                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `newValue: RegionCode\|undefined`                                                                                                                              |                                                           | LionInputTel         |
-| `_setValueAndPreserveCaret`              | protected | Restores the cursor to its original position after updating the value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `newValue: string`                                                                                                                                             |                                                           | NativeTextFieldMixin |
-| `_showFeedbackConditionFor`              | protected | Default feedbackCondition condition, used by Subclassers, that will be used when&#xA;\`feedbackCondition()\` is not overridden by Application Developer.&#xA;Show the validity feedback when returning true, don't show when false                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `type: string, meta: InteractionStates`                                                                                                                        |                                                           | LionField            |
-| `_syncValueUpwards`                      | protected | Synchronization from \`.\_inputNode.value\` to \`LionField\` (flow \[2])&#xA;Downwards syncing should only happen for \`LionField\`.value changes from 'above'.&#xA;This triggers \_onModelValueChanged and connects user input&#xA;to the parsing/formatting/serializing loop.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_triggerInitialModelValueChangedEvent`  | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
-| `_updateFeedbackComponent`               | protected | Responsible for retrieving messages from Validators and&#xA;(delegation of) rendering them.&#xA;&#xA;For \`.\_feedbackNode\` (extension of LionValidationFeedback):&#xA;- retrieve messages from highest prio Validators&#xA;- provide the result to custom feedback node and let the&#xA;custom node decide on their renderings&#xA;&#xA;In both cases:&#xA;- we compute the 'show' flag (like 'hasErrorVisible') for all types&#xA;- we set the customValidity message of the highest prio Validator&#xA;- we set aria-invalid="true" in case hasErrorVisible is true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                |                                                           | LionField            |
-| `_updateShouldShowFeedbackFor`           | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                |                                                           | LionField            |
+| Name                             | Privacy   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Parameters                                                                                                                                                     | Return                                                    | Inherited From |
+| -------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------- |
+| `clear`                          | public    | Clears modelValue.&#xA;Interaction states are not cleared (use resetInteractionState for this)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                |                                                           | LionField      |
+| `formatter`                      | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `modelValue: string`                                                                                                                                           | `string`                                                  | LionInputTel   |
+| `onLocaleUpdated`                | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                                                                                                                                                                |                                                           | LionInputTel   |
+| `parser`                         | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `viewValue: string`                                                                                                                                            | `string`                                                  | LionInputTel   |
+| `preprocessor`                   | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `viewValue: string, { currentCaretIndex, prevViewValue }, options: @param {string} options.prevViewValue    * @param {number} options.currentCaretIndex    * ` | `{ viewValue: string; caretIndex: number; } \| undefined` | LionInputTel   |
+| `reset`                          | public    | Resets modelValue to initial value.&#xA;Interaction states are cleared                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                |                                                           | LionField      |
+| `resetInteractionState`          | public    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                                                                                                                                                                |                                                           | LionField      |
+| `_initModelValueBasedOnDropdown` | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                                                                                                                                                                |                                                           |                |
+| `_isEmpty`                       | protected | Used for Required validation and computation of interaction states.&#xA;We need to override this, because we prefill the input with the region code (like +31), but for proper UX,&#xA;we don't consider this as having interaction state \`prefilled\`                                                                                                                                                                                                                                                                                                                                      | `modelValue: string`                                                                                                                                           | `boolean`                                                 |                |
+| `_onChange`                      | protected | Dispatches custom bubble event                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `ev: Event=`                                                                                                                                                   |                                                           | LionField      |
+| `_onDropdownValueChange`         | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `event: OnDropdownChangeEvent`                                                                                                                                 |                                                           |                |
+| `_onPhoneNumberUtilReady`        | protected |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                                                                                                                                                                |                                                           | LionInputTel   |
+| `_reflectBackOn`                 | protected | Do not reflect back .formattedValue during typing (this normally wouldn't happen when&#xA;FormatMixin calls \_calculateValues based on user input, but for LionInputTel we need to&#xA;call it on .activeRegion change)                                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                | `boolean`                                                 | LionInputTel   |
+| `_repropagationCondition`        | protected | Usually, we don't use composition in regular LionFields (non choice-groups). Here we use a LionSelect(Rich) inside.&#xA;We don't want to repropagate any children, since an Application Developer is not concerned with these internals (see repropate logic in FormControlMixin)&#xA;Also, we don't want to give (wrong) info to InteractionStateMixin, that will set the wrong interaction states based on child info.&#xA;TODO: Make "this.\_repropagationRole !== 'child'" the default for FormControlMixin&#xA;(so that FormControls used within are never repropagated for LionFields) |                                                                                                                                                                |                                                           |                |
+| `_setActiveRegion`               | protected | Protected setter for activeRegion, only meant for subclassers                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `newValue: RegionCode\|undefined`                                                                                                                              |                                                           | LionInputTel   |
 
 ### Events
 
-| Name                           | Type          | Description                                              | Inherited From |
-| ------------------------------ | ------------- | -------------------------------------------------------- | -------------- |
-| `model-value-changed`          | `CustomEvent` |                                                          | LionField      |
-| `user-input-changed`           | `Event`       |                                                          | LionField      |
-| `focus`                        | `Event`       |                                                          | LionField      |
-| `blur`                         | `Event`       |                                                          | LionField      |
-| `focusin`                      | `Event`       |                                                          | LionField      |
-| `focusout`                     | `Event`       |                                                          | LionField      |
-| `form-element-name-changed`    | `CustomEvent` |                                                          | LionField      |
-| `form-element-register`        | `CustomEvent` |                                                          | LionField      |
-| `touched-changed`              | `Event`       |                                                          | LionField      |
-| `dirty-changed`                | `Event`       |                                                          | LionField      |
-| `showsFeedbackForChanged`      | `Event`       |                                                          | LionField      |
-|                                | `Event`       |                                                          | LionField      |
-| `shouldShowFeedbackForChanged` | `Event`       |                                                          | LionField      |
-| `validate-performed`           | `Event`       | private event that should be listened to by LionFieldSet | LionField      |
+| Name                 | Type    | Description | Inherited From |
+| -------------------- | ------- | ----------- | -------------- |
+| `user-input-changed` | `Event` |             | LionField      |
 
 ### Attributes
 
-| Name                            | Field                      | Inherited From       |
-| ------------------------------- | -------------------------- | -------------------- |
-| `allowedRegions`                | allowedRegions             | LionInputTel         |
-| `format-strategy`               | formatStrategy             | LionInputTel         |
-| `format-country-code-style`     | formatCountryCodeStyle     | LionInputTel         |
-| `activeRegion`                  | activeRegion               | LionInputTel         |
-| `preferredRegions`              | preferredRegions           | LionInputTel         |
-| `_phoneUtil`                    | \_phoneUtil                | LionInputTel         |
-| `autocomplete`                  | autocomplete               | NativeTextFieldMixin |
-| `focused`                       | focused                    | LionField            |
-| `focused-visible`               | focusedVisible             | LionField            |
-| `autofocus`                     | autofocus                  | LionField            |
-| `readonly`                      | readOnly                   | LionField            |
-| `label`                         | label                      | LionField            |
-| `label-sr-only`                 | labelSrOnly                | LionField            |
-| `help-text`                     | helpText                   | LionField            |
-| `type`                          | type                       | LionInput            |
-| `placeholder`                   | placeholder                | LionInput            |
-| `name`                          | name                       | LionField            |
-| `allow-cross-root-registration` | allowCrossRootRegistration | LionField            |
-| `disabled`                      | disabled                   | LionField            |
-| `touched`                       | touched                    | LionField            |
-| `dirty`                         | dirty                      | LionField            |
-| `filled`                        | filled                     | LionField            |
-| `shows-feedback-for`            | showsFeedbackFor           | LionField            |
-| `is-pending`                    | isPending                  | LionField            |
+| Name                        | Field                  | Inherited From |
+| --------------------------- | ---------------------- | -------------- |
+| `allowedRegions`            | allowedRegions         | LionInputTel   |
+| `format-strategy`           | formatStrategy         | LionInputTel   |
+| `format-country-code-style` | formatCountryCodeStyle | LionInputTel   |
+| `activeRegion`              | activeRegion           | LionInputTel   |
+| `preferredRegions`          | preferredRegions       | LionInputTel   |
+| `_phoneUtil`                | \_phoneUtil            | LionInputTel   |
+| `readonly`                  | readOnly               | LionInput      |
+| `type`                      | type                   | LionInput      |
+| `placeholder`               | placeholder            | LionInput      |
 
 <hr/>