@aceshooting/lyra-ui 25.4.0 → 25.6.0

package/llms/components/lr-currency-picker.md

@@ -0,0 +1,101 @@
+<!-- GENERATED by scripts/build-llms.mjs from llms/forms.md — do not edit this file. -->
+
+# `lr-currency-picker`
+
+- **Import** `import '@aceshooting/lyra-ui/components/lr-currency-picker.js';` (stable tag alias; registers the tag)
+- **Class** `LyraCurrencyPicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/currency-picker/currency-picker.class.js`
+- **Family** `components/forms/` — see `llms/index.md` for its siblings
+- **Status** `experimental` since `25.5.0` — see the maturity and deprecation policy in `llms/shared.md`
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Deprecations** none
+- **Optional peers** none
+- **Themeable via** 11 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
+
+---
+
+## `lr-currency-picker`
+
+A form-associated, single-currency selector with a compact ISO-code trigger and localized currency
+names and symbols in its options. It composes `lr-select` (or `lr-combobox` when searchable) and `lr-option`; no additional popover,
+currency-name table or optional peer is needed. Selection changes the field value only: exchange
+rates, amount conversion, persistence and the application's display-currency preference belong to
+the application. Selecting a currency does not change the interface language.
+
+**Value and catalog.** `value` defaults to `''`; no currency is inferred or selected automatically.
+Set `value="EUR"` when your application wants euros by default. Valid three-letter codes are trimmed
+and uppercased. The default catalog contains the pinned ISO 4217 currency, fund and metal codes,
+excluding the testing/no-currency codes `XTS` and `XXX`. Use `.currencies` for an ordered everyday
+subset. Omitted, `undefined` or `null` restores the default catalog; `[]` means no options.
+
+`currencies` accepts `LyraCurrencyCatalog = readonly string[] | readonly LyraCurrencyEntry[]`.
+Each `LyraCurrencyEntry { readonly code: string; readonly label?: string; readonly symbol?: string;
+readonly group?: string; readonly disabled?: boolean }` supplies one option. Names and symbols come from `Intl` using the field's
+effective locale, with code fallbacks where display data is unavailable. Caller labels/symbols,
+including explicit empty strings, override that presentation. The catalog is copied; reassign it
+to change options. At most 512 rows are examined, invalid rows are skipped, and the first valid
+entry for each normalized code wins. Caller order is preserved.
+
+**Unavailable values stay visible.** A value outside the configured catalog, a malformed nonempty
+value, or a selected entry that becomes disabled is retained and marked unavailable. It fails
+validation until cleared or replaced; it is never silently switched to another currency. Such a
+value is not added as a selectable option. A caller's `setCustomValidity()` message takes priority.
+
+**Field API.** `label`, `hint`, `errorText` (`error-text`) and their slots supply field chrome.
+`accessibleLabel` (host attribute `aria-label`) overrides the computed field name; otherwise a label or localized Currency name
+names the actual control. `placeholder` defaults to localized Select, with explicit empty strings
+preserved. `name`, `form`, `required`, `disabled`, `defaultValue`, native form submission/reset,
+fieldset disablement, `checkValidity()`, `reportValidity()` and `setCustomValidity()` follow the
+shared form contracts. `size` defaults to `m`; `clearable` defaults to `false`. `focus()`, `blur()`
+and `click()` forward to the visible control.
+
+`customError: string | null = null` (attribute `custom-error`, reflected) supplies a consumer
+validation message. `getForm()` returns the browser-resolved form owner, including an external
+owner selected by `form`. `setCustomValidity(message)` sets or clears `customError`;
+`resetValidity()` clears only that consumer error and recomputes the current required/catalog
+constraints, leaving `value`, `defaultValue` and interaction state unchanged.
+
+`topLayer` (attribute `top-layer`) defaults to `false`; enable it inside clipped headers or dialogs.
+An explicit `positioningStrategy` (attribute `positioning-strategy`) of `"fixed"` or `"absolute"`
+overrides inherited `--lr-positioning-strategy`.
+Keyboard navigation and ISO-code type-ahead use the select contract by default. Set
+`searchable` (default `false`) to enable a text filter matching codes, localized names, literal
+labels, and regular/narrow symbols. Typing only filters; it does not change `value` or emit
+selection events. A query matching the current displayed code follows the combobox convention
+of showing the complete list. An empty or unmatched query never creates a currency.
+`group` supplies caller-owned headings for contiguous rows; order is never rearranged.
+`autocomplete='off'`, `inputMode=''` (attribute `inputmode`), `enterKeyHint=''`
+(attribute `enterkeyhint`), `spellcheck=false`,
+`autocapitalize=''`, and `autocorrect=true` forward native editing guidance in searchable mode.
+The readonly `input: HTMLInputElement | null` exposes that native filter (null in compact mode).
+After directly changing its DOM value, dispatch a native `input` event to update filtering.
+Mode changes, reset and reconnect clear unfinished filtering without changing the reset default.
+
+**Events:** An accepted user choice or clear updates `value` synchronously, then emits exactly one
+`input`, `lr-input`, `change`, `lr-change` sequence. The prefixed details are
+`LyraCurrencyChangeDetail { readonly value: string; readonly previousValue: string }`.
+Re-selecting the current code, programmatic
+updates, resets, locale changes and catalog replacements emit no change event. Native `focus` and
+`blur` relay once; the cancelable `lr-invalid` alias follows native validation.
+
+**Slots:** `label`, `hint`, `error` — custom field copy. There is no option/default content slot;
+bind `currencies` to supply rows.
+
+**CSS parts:** `form-control`, `form-control-label`, `hint`, `error`;
+`select-trigger`, `select-display-input`, `select-listbox`, `select-option`, `select-option-sub`,
+`select-clear-button`, `select-group-label`. Both composed controls preserve these part names
+and inherit shared form-control and surface tokens.
+
+```html
+<script type="module">
+  import '@aceshooting/lyra-ui/components/lr-currency-picker.js';
+
+  const picker = document.querySelector('lr-currency-picker');
+  picker.currencies = ['EUR', 'USD', 'GBP', 'CHF', 'JPY', 'CAD', 'AUD'];
+  picker.addEventListener('lr-change', ({ detail }) => {
+    console.log(detail.value, detail.previousValue);
+  });
+</script>
+
+<lr-currency-picker name="currency" label="Display currency" value="EUR"></lr-currency-picker>
+```

package/llms/components/lr-locale-picker.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 15 parts, 25 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 17 parts, 25 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -20,8 +20,8 @@ A closed-list locale switcher over the library's own locale registry. First-part
 Web Awesome equivalent). With `locales` unset (the default), the offered rows are exactly
 `getRegisteredLyraLocales()` — every locale with strings registered via `registerLyraLocale()`,
 plus `en` — kept live via `subscribeLyraLocaleRegistry()`. Built directly on `lr-select`'s
-trigger-button/`aria-activedescendant` listbox technique, not composed from it — a plain closed
-list, no filter/free-text mode.
+trigger-button/`aria-activedescendant` listbox technique, not composed from it. Optional
+`searchable` adds a text filter; free text never becomes a locale selection.
 
 Host `aria-describedby` references resolve onto the role=combobox trigger before its local error and
 hint guidance. The relationship tracks missing IDs, target replacement, removal/reinsertion,
@@ -52,6 +52,18 @@ readonly LyraLocaleEntry[]`, `LyraLocaleEntry { tag: string; label?: string; cou
   the catalog while the listbox is open keeps keyboard navigation valid: an active row beyond the
   new end is rehomed to the last remaining row. Arrow/Home/End/typeahead changes scroll the active
   owned option into nearest view after render; replacement and disconnect cancel stale scrolls.
+- `searchable: boolean = false` — add a search field inside the open menu. Substring matching
+  ignores case and accents across language tags, native names, localized names and caller labels;
+  for example, `eng` finds English. Filtering emits no selection events and does not invoke a
+  locale loader. Arrow keys and Enter select an offered match; ordinary text editing and IME
+  composition remain native. Empty results show localized guidance. Closing, disabling, resetting,
+  reconnecting or turning search off clears unfinished filtering. The default keeps the existing
+  compact list without an input.
+- `autocomplete: string = 'off'`, `inputMode: string = ''` (attribute `inputmode`),
+  `enterKeyHint: string = ''` (attribute `enterkeyhint`), `spellcheck: boolean = false`,
+  `autocapitalize: string = ''`, `autocorrect: boolean = true` — native guidance for the filter.
+  The readonly `input: HTMLInputElement | null` exposes it in searchable mode. After directly
+  editing `input.value`, dispatch a native `input` event to update the matches.
 - `topLayer: boolean = false` (attribute `top-layer`, reflected) — same contract as `<lr-popover>`:
   always shows the open listbox in the browser top layer, placed `fixed` whatever the positioning
   strategy resolves to, so it paints above a sibling surface stacked higher than a `z-index`ed fixed
@@ -177,7 +189,9 @@ visually hidden in flag-only mode), `listbox`, `option`, `option-flag` (present
 `optionDisplay` is `label-tag`, and absent from the DOM entirely under `optionDisplay="label"`),
 `expand-icon`,
 `hint`, `error`, `load-status` (the optional localized loading or failure message), and
-`load-retry` (the retry button shown after a locale load fails).
+`load-retry` (the retry button shown after a locale load fails), `search-input` (the opt-in
+filter) and `empty` (the no-match message). Search uses the localized `localePickerSearchLabel`
+and `localePickerEmpty` string keys.
 
 **The required marker.** `required` with a non-empty `label` paints the library's shared marker on
 `[part="form-control-label"]` — the one `::after` rule described under "The required-field marker"

package/llms/components/lr-popover.md

@@ -183,10 +183,16 @@ If the import fails, leave the native disclosure visible and usable.
 To preserve the previous Lyra-shaped defaults explicitly, use
 `placement="bottom-start" distance="4" without-arrow`; origin-aware migration emits those tokens.
 
-The slotted trigger receives `aria-haspopup`, `aria-expanded`, and `aria-controls`. With no slotted
-trigger, a live HTML `for` target receives the identical ownership contract. A wrapper/custom
-trigger's composed descendant that actually receives focus receives the same semantics and becomes
-the focus-return target. The component supplies the real popup to the shared relationship owner;
+The slotted trigger owns interaction; with no slotted trigger, a live HTML `for` target owns it.
+Only its semantic focus target receives `aria-haspopup`, `aria-expanded`, and `aria-controls`.
+For wrapper/custom triggers such as `lr-button`, the composed native control receives these
+attributes and becomes the focus-return target; the generic host receives no generated trigger
+ARIA, including when the host forwards a roving `tabindex` to its native control. Native triggers
+and focusable hosts with an authored role supporting expansion (such as `button`) own their state
+directly; roles such as `img` and ordinary text fields receive no generated expansion state.
+Ownership follows replacement controls and waits for an unresolved slotted or `for` custom trigger
+to upgrade.
+The component supplies the real popup to the shared relationship owner;
 because current browsers reject a light-DOM reference into a private shadow tree, that inward edge
 is exposed as the public `lr-popover` host. Target insertion, removal, replacement, `id` changes,
 and late custom-element upgrade are tracked live. Authored relationship tokens compose, generated

package/llms/components/lr-select.md

@@ -32,6 +32,29 @@ Session-history/autofill restoration assigns the stored string through the same
 value/form/validity path as a programmatic value write and does not emit `input`, `change`, or
 `lr-change`.
 
+**Selecting options in browser tests.** The light-DOM `<lr-option>` children supply option data;
+the clickable rows are rendered inside `<lr-select>`'s shadow-root listbox as
+`[part="option"][role="option"]`, each with a `data-value` matching its represented value.
+Click the trigger to open the listbox, then target a rendered row. For example, in Playwright:
+
+```ts
+const select = page.locator('lr-select[name="country"]');
+await select.getByRole('combobox').click();
+await select.getByRole('option', { name: 'France' }).click();
+// When the label is localized or otherwise variable, target its value instead:
+await select.getByRole('combobox').click();
+await select.locator('[part="option"][data-value="fr"]').click();
+```
+
+For an in-page component test with a `LyraSelect` element, the public
+`@aceshooting/lyra-ui/testing` `chooseOption(selectElement, 'fr')` driver opens the listbox,
+clicks its first rendered row with that value, and awaits the component update. It also works in
+DOM test environments without Playwright; see [interaction drivers](shared/testing-and-utilities.md#driving-a-components-real-activation-path-interaction-drivers).
+
+Playwright's locators enter the open shadow root. A light-DOM `lr-option[value="fr"]` has no
+clickable box in this picker. If multiple options share a value, `data-value` matches every
+occurrence; narrow by accessible name or assert their order before choosing an occurrence.
+
 Mounted `option.selected` assignments update the picker value and form submission immediately,
 including deselection and equal-value writes. Duplicate-valued options retain their individual
 occurrence identities. These programmatic writes emit no user input/change event.
@@ -236,6 +259,12 @@ renders the same localized `loading` text in place of `placeholder`, so a consum
 hand-write a conditional placeholder bound to the same flag and re-localize, in its own catalogue,
 the string this control already owns.
 
+When not loading, before the browser first reads the option slot, including during SSR, a committed
+value renders as its raw code without an unavailable badge, synthetic unknown option, or custom unknown label.
+After hydration observes the slot, real option labels and genuine unmatched-value feedback resolve
+normally; an observed empty slot is an empty catalog. Server rendering does not inspect browser
+slot assignments or provide an interactive popup without JavaScript.
+
 **Methods:** `focus(options?)`, `blur()`, and `click()` forward to the internal trigger button.
 `show()` and `hide()` return `Promise<void>` and resolve after `lr-after-show`/`lr-after-hide` once
 the matching transition settles. `getForm()` returns the browser-resolved form owner, including an

package/llms/components/lr-time-zone-picker.md

@@ -0,0 +1,56 @@
+<!-- GENERATED by scripts/build-llms.mjs from llms/forms.md — do not edit this file. -->
+
+# `lr-time-zone-picker`
+
+- **Import** `import '@aceshooting/lyra-ui/components/lr-time-zone-picker.js';` (stable tag alias; registers the tag)
+- **Class** `LyraTimeZonePicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/time-zone-picker/time-zone-picker.class.js`
+- **Family** `components/forms/` — see `llms/index.md` for its siblings
+- **Status** `experimental` since `25.5.0` — see the maturity and deprecation policy in `llms/shared.md`
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Deprecations** none
+- **Optional peers** none
+- **Themeable via** 11 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
+
+---
+
+## `lr-time-zone-picker`
+
+A form-associated identifier selector. Import
+`@aceshooting/lyra-ui/components/lr-time-zone-picker.js`. It follows the
+[shared field contract](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/components/lr-country-picker.md),
+with `.timeZones` accepting
+`LyraTimeZoneCatalog = readonly string[] | readonly LyraTimeZoneEntry[]`.
+Default options are `UTC` followed by the runtime's supported primary IANA identifiers, or only
+`UTC` when that catalog API is unavailable. Supply the same explicit catalog on server and client
+when their time-zone data may differ. `value=''` selects nothing automatically.
+
+Identifiers are trimmed and case-sensitive, limited to 256 characters, and never canonicalized.
+Caller catalogs can retain aliases or custom identifiers. Default labels replace underscores
+with spaces; `label` overrides provide other display names, and `searchable` matches both.
+Selection does not change the application's time zone or calculate offsets, clocks or daylight
+saving transitions. Catalog types and `getTimeZoneCodes()` are documented in the
+[catalog helper reference](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md#country-time-zone-and-unit-catalog-helpers).
+
+**Field API:** `label`, `hint`, `errorText` (`error-text`), `placeholder`, `accessibleLabel`
+(`aria-label`), `name`, `form`, `value`, `defaultValue`, `required`, `disabled`, `customError`
+(`custom-error`), `size`, `clearable`, `searchable`, `topLayer` (`top-layer`),
+`positioningStrategy` (`positioning-strategy`), `autocomplete`, `inputMode` (`inputmode`),
+`enterKeyHint` (`enterkeyhint`), `spellcheck`, `autocapitalize`, `autocorrect`, and readonly `input`.
+Defaults and form/editing methods follow the
+[shared contract](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/components/lr-country-picker.md), including
+`getForm()`, `checkValidity()`, `reportValidity()`, `setCustomValidity(message)` and
+`resetValidity()` for the owning form and consumer validation messages.
+
+**Events:** `input`, `lr-input`, `change`, `lr-change`, `focus`, `blur`, `lr-invalid`.
+**Slots:** `label`, `hint`, `error`.
+**CSS parts:** `form-control`, `form-control-label`, `hint`, `error`, `select-trigger`,
+`select-display-input`, `select-listbox`, `select-option`, `select-option-sub`, `select-group-label`,
+`select-clear-button`.
+
+```html
+<script type="module">
+  import '@aceshooting/lyra-ui/components/lr-time-zone-picker.js';
+</script>
+<lr-time-zone-picker name="zone" label="Time zone" value="UTC" searchable></lr-time-zone-picker>
+```

package/llms/components/lr-unit-picker.md

@@ -0,0 +1,54 @@
+<!-- GENERATED by scripts/build-llms.mjs from llms/forms.md — do not edit this file. -->
+
+# `lr-unit-picker`
+
+- **Import** `import '@aceshooting/lyra-ui/components/lr-unit-picker.js';` (stable tag alias; registers the tag)
+- **Class** `LyraUnitPicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/unit-picker/unit-picker.class.js`
+- **Family** `components/forms/` — see `llms/index.md` for its siblings
+- **Status** `experimental` since `25.5.0` — see the maturity and deprecation policy in `llms/shared.md`
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Deprecations** none
+- **Optional peers** none
+- **Themeable via** 11 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
+
+---
+
+## `lr-unit-picker`
+
+A form-associated measurement-unit selector. Import
+`@aceshooting/lyra-ui/components/lr-unit-picker.js`. It follows the
+[shared field contract](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/components/lr-country-picker.md),
+with `.units` accepting
+`LyraUnitCatalog = readonly string[] | readonly LyraUnitEntry[]`.
+The default catalog contains the 45 standard ECMA-402 simple units. `value=''` selects nothing;
+identifiers are trimmed and case-sensitive, limited to 256 characters. Caller catalogs may include
+custom or compound units. `Intl.NumberFormat` resolves localized singular names and short symbols;
+unsupported identifiers fall back to their code. Literal `label` and `symbol` overrides, including
+empty strings, take precedence. `searchable` matches identifiers, localized/literal names and
+symbols. Selection edits no amount and performs no unit conversion. Catalog types and name
+resolution are documented in the
+[catalog helper reference](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md#country-time-zone-and-unit-catalog-helpers).
+
+**Field API:** `label`, `hint`, `errorText` (`error-text`), `placeholder`, `accessibleLabel`
+(`aria-label`), `name`, `form`, `value`, `defaultValue`, `required`, `disabled`, `customError`
+(`custom-error`), `size`, `clearable`, `searchable`, `topLayer` (`top-layer`),
+`positioningStrategy` (`positioning-strategy`), `autocomplete`, `inputMode` (`inputmode`),
+`enterKeyHint` (`enterkeyhint`), `spellcheck`, `autocapitalize`, `autocorrect`, and readonly `input`.
+Defaults and form/editing methods follow the
+[shared contract](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/components/lr-country-picker.md), including
+`getForm()`, `checkValidity()`, `reportValidity()`, `setCustomValidity(message)` and
+`resetValidity()` for the owning form and consumer validation messages.
+
+**Events:** `input`, `lr-input`, `change`, `lr-change`, `focus`, `blur`, `lr-invalid`.
+**Slots:** `label`, `hint`, `error`.
+**CSS parts:** `form-control`, `form-control-label`, `hint`, `error`, `select-trigger`,
+`select-display-input`, `select-listbox`, `select-option`, `select-option-sub`, `select-group-label`,
+`select-clear-button`.
+
+```html
+<script type="module">
+  import '@aceshooting/lyra-ui/components/lr-unit-picker.js';
+</script>
+<lr-unit-picker name="unit" label="Measurement unit" value="meter" searchable></lr-unit-picker>
+```

package/llms/index.md

@@ -2,7 +2,7 @@
 
 # Component index
 
-303 custom elements, grouped by the source family they live in.
+307 custom elements, grouped by the source family they live in.
 
 **Reading one component.** Its reference file path is derived from the tag — no search needed:
 `llms/components/<tag>.md` (e.g. `llms/components/lr-table.md`): import path, optional peers,
@@ -30,7 +30,7 @@ and testing and utilities (`llms/shared/testing-and-utilities.md`). The combined
 compatibility guide remains at `llms/shared.md`. Design tokens: `llms/tokens.md`.
 Optional peers: `llms/peers.md`. Safe `wa-*`/`sl-*` migration: `llms/migration.md`.
 
-## Form controls & inputs — `components/forms/` (31)
+## Form controls & inputs — `components/forms/` (35)
 
 - `lr-combobox` · lr-combobox.js · `stable` since `4.0.0` — a filterable single/multi select that combines a text input with a listbox.
 - `lr-option` · lr-option.js · `stable` since `4.0.0` — a selectable option for `<lr-combobox>` and `<lr-select>`.
@@ -63,6 +63,10 @@ Optional peers: `llms/peers.md`. Safe `wa-*`/`sl-*` migration: `llms/migration.m
 - `lr-locale-picker` · lr-locale-picker.js · `stable` since `6.0.0` — a closed-list locale switcher over the library's own locale registry.
 - `lr-toggle` · lr-toggle.js · `experimental` since `21.0.0` — a two-state button that owns its `pressed` state.
 - `lr-toggle-group` · lr-toggle-group.js · `experimental` since `21.0.0` — a set of `<lr-toggle>` children behind one tab stop.
+- `lr-currency-picker` · lr-currency-picker.js · `experimental` since `25.5.0` — a form-associated currency-code selector.
+- `lr-country-picker` · lr-country-picker.js · `experimental` since `25.5.0` — a form-associated country and territory selector.
+- `lr-time-zone-picker` · lr-time-zone-picker.js · `experimental` since `25.5.0` — a form-associated time-zone identifier selector.
+- `lr-unit-picker` · lr-unit-picker.js · `experimental` since `25.5.0` — a form-associated measurement-unit identifier selector.
 
 ## Data display, dashboards & flow canvas — `components/data/` (26)
 

package/llms/shared/events-and-types.md

@@ -584,7 +584,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraControlGroupReactProps;
   'lr-conversation-item': LyraConversationItemReactProps;
   'lr-copy-button': LyraCopyButtonReactProps;
+  'lr-country-picker': LyraCountryPickerReactProps;
   'lr-csv-viewer': LyraCsvViewerReactProps;
+  'lr-currency-picker': LyraCurrencyPickerReactProps;
   'lr-dashboard-grid': LyraDashboardGridReactProps;
   'lr-data-grid': LyraDataGridReactProps;
   'lr-dataset-viewer': LyraDatasetViewerReactProps;
@@ -781,6 +783,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraThreadListReactProps;
   'lr-time-input': LyraTimeInputReactProps;
   'lr-time-range': LyraTimeRangeReactProps;
+  'lr-time-zone-picker': LyraTimeZonePickerReactProps;
   'lr-timeline': LyraTimelineReactProps;
   'lr-timeline-item': LyraTimelineItemReactProps;
   'lr-toast': LyraToastReactProps;
@@ -803,6 +806,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraTreeReactProps;
   'lr-tree-item': LyraTreeItemReactProps;
   'lr-typing-indicator': LyraTypingIndicatorReactProps;
+  'lr-unit-picker': LyraUnitPickerReactProps;
   'lr-usage-badge': LyraUsageBadgeReactProps;
   'lr-video': LyraVideoReactProps;
   'lr-video-playlist': LyraVideoPlaylistReactProps;
@@ -1012,7 +1016,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraComponentTypeMap['lr-control-group']['element'];
   'lr-conversation-item': LyraComponentTypeMap['lr-conversation-item']['element'];
   'lr-copy-button': LyraComponentTypeMap['lr-copy-button']['element'];
+  'lr-country-picker': LyraComponentTypeMap['lr-country-picker']['element'];
   'lr-csv-viewer': LyraComponentTypeMap['lr-csv-viewer']['element'];
+  'lr-currency-picker': LyraComponentTypeMap['lr-currency-picker']['element'];
   'lr-dashboard-grid': LyraComponentTypeMap['lr-dashboard-grid']['element'];
   'lr-data-grid': LyraComponentTypeMap['lr-data-grid']['element'];
   'lr-dataset-viewer': LyraComponentTypeMap['lr-dataset-viewer']['element'];
@@ -1209,6 +1215,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraComponentTypeMap['lr-thread-list']['element'];
   'lr-time-input': LyraComponentTypeMap['lr-time-input']['element'];
   'lr-time-range': LyraComponentTypeMap['lr-time-range']['element'];
+  'lr-time-zone-picker': LyraComponentTypeMap['lr-time-zone-picker']['element'];
   'lr-timeline': LyraComponentTypeMap['lr-timeline']['element'];
   'lr-timeline-item': LyraComponentTypeMap['lr-timeline-item']['element'];
   'lr-toast': LyraComponentTypeMap['lr-toast']['element'];
@@ -1231,6 +1238,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraComponentTypeMap['lr-tree']['element'];
   'lr-tree-item': LyraComponentTypeMap['lr-tree-item']['element'];
   'lr-typing-indicator': LyraComponentTypeMap['lr-typing-indicator']['element'];
+  'lr-unit-picker': LyraComponentTypeMap['lr-unit-picker']['element'];
   'lr-usage-badge': LyraComponentTypeMap['lr-usage-badge']['element'];
   'lr-video': LyraComponentTypeMap['lr-video']['element'];
   'lr-video-playlist': LyraComponentTypeMap['lr-video-playlist']['element'];
@@ -1317,7 +1325,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraControlGroupSvelteProps;
   'lr-conversation-item': LyraConversationItemSvelteProps;
   'lr-copy-button': LyraCopyButtonSvelteProps;
+  'lr-country-picker': LyraCountryPickerSvelteProps;
   'lr-csv-viewer': LyraCsvViewerSvelteProps;
+  'lr-currency-picker': LyraCurrencyPickerSvelteProps;
   'lr-dashboard-grid': LyraDashboardGridSvelteProps;
   'lr-data-grid': LyraDataGridSvelteProps;
   'lr-dataset-viewer': LyraDatasetViewerSvelteProps;
@@ -1514,6 +1524,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraThreadListSvelteProps;
   'lr-time-input': LyraTimeInputSvelteProps;
   'lr-time-range': LyraTimeRangeSvelteProps;
+  'lr-time-zone-picker': LyraTimeZonePickerSvelteProps;
   'lr-timeline': LyraTimelineSvelteProps;
   'lr-timeline-item': LyraTimelineItemSvelteProps;
   'lr-toast': LyraToastSvelteProps;
@@ -1536,6 +1547,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraTreeSvelteProps;
   'lr-tree-item': LyraTreeItemSvelteProps;
   'lr-typing-indicator': LyraTypingIndicatorSvelteProps;
+  'lr-unit-picker': LyraUnitPickerSvelteProps;
   'lr-usage-badge': LyraUsageBadgeSvelteProps;
   'lr-video': LyraVideoSvelteProps;
   'lr-video-playlist': LyraVideoPlaylistSvelteProps;
@@ -1734,7 +1746,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraControlGroupVueProps;
   'lr-conversation-item': LyraConversationItemVueProps;
   'lr-copy-button': LyraCopyButtonVueProps;
+  'lr-country-picker': LyraCountryPickerVueProps;
   'lr-csv-viewer': LyraCsvViewerVueProps;
+  'lr-currency-picker': LyraCurrencyPickerVueProps;
   'lr-dashboard-grid': LyraDashboardGridVueProps;
   'lr-data-grid': LyraDataGridVueProps;
   'lr-dataset-viewer': LyraDatasetViewerVueProps;
@@ -1931,6 +1945,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraThreadListVueProps;
   'lr-time-input': LyraTimeInputVueProps;
   'lr-time-range': LyraTimeRangeVueProps;
+  'lr-time-zone-picker': LyraTimeZonePickerVueProps;
   'lr-timeline': LyraTimelineVueProps;
   'lr-timeline-item': LyraTimelineItemVueProps;
   'lr-toast': LyraToastVueProps;
@@ -1953,6 +1968,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraTreeVueProps;
   'lr-tree-item': LyraTreeItemVueProps;
   'lr-typing-indicator': LyraTypingIndicatorVueProps;
+  'lr-unit-picker': LyraUnitPickerVueProps;
   'lr-usage-badge': LyraUsageBadgeVueProps;
   'lr-video': LyraVideoVueProps;
   'lr-video-playlist': LyraVideoPlaylistVueProps;

package/llms/shared/imports-and-registration.md

@@ -157,7 +157,7 @@ The entry points, then:
   but it is not an exhaustive promise that every component-owned type or future export is present.
   Prefer the owning component entry in application code, both for the smallest bundle and the
   complete contract of that component.
-- **`all.js` compatibility entry.** `import '@aceshooting/lyra-ui/all.js';` registers the 288
+- **`all.js` compatibility entry.** `import '@aceshooting/lyra-ui/all.js';` registers the 292
   root-included tags — everything **except** the 15 inventory-designated optional-peer-family tags:
   `lr-chart` and its 8 typed subclasses (`lr-line-chart`, `lr-bar-chart`, `lr-pie-chart`,
   `lr-doughnut-chart`, `lr-radar-chart`, `lr-polar-area-chart`, `lr-bubble-chart`,

package/llms/shared/testing-and-utilities.md

@@ -397,6 +397,8 @@ arrowPadding?: number; hoverBridge?: HTMLElement; onPlaced?: (result: PlacementR
   `validationMessage`, and `willValidate`; `setFormValue(next)`; `getForm()`; `checkValidity()`;
   `reportValidity()`; `setCustomValidity(message)`; `resetValidity()`; `formResetCallback()`; and
   `formStateRestoreCallback(state, reason)`.
+  Writing `null` to `defaultValue` removes its markup value and resets the default to the adapter's
+  empty value; reading it still returns `TValue`. This does not overwrite a dirty live value.
   The exact callable signatures are `attachInternalsSafely(host: HTMLElement): ElementInternals`,
   `createFallbackInternals(): ElementInternals`, `createStringArrayFormDataState(name: string,
 values: readonly string[]): FormData`, `readStringArrayFormDataState(state: string | File |
@@ -409,7 +411,8 @@ toFormValue(value: TValue): FormSubmissionValue; toFormState?(value: TValue):
 FormSubmissionValue; isEmpty?(value: TValue): boolean; fromAttribute?(attribute: string): TValue;
 toAttribute?(value: TValue): string | null; fromFormState?(state: FormSubmissionValue): TValue }`
   and `FormAssociatedInterface<TValue> { internals: ElementInternals; get name(): string; set
-name(next: string | null); value: TValue; defaultValue: TValue; customError: string | null;
+name(next: string | null); value: TValue; get defaultValue(): TValue;
+set defaultValue(next: TValue | null); customError: string | null;
 disabled: boolean; required: boolean; readonly effectiveDisabled: boolean; get form():
 HTMLFormElement | null; set form(owner: FormOwnerValue); readonly labels: NodeList; readonly
 validity: ValidityState; readonly validationMessage: string; readonly willValidate: boolean;

package/llms/shared.md

@@ -156,7 +156,7 @@ The entry points, then:
   but it is not an exhaustive promise that every component-owned type or future export is present.
   Prefer the owning component entry in application code, both for the smallest bundle and the
   complete contract of that component.
-- **`all.js` compatibility entry.** `import '@aceshooting/lyra-ui/all.js';` registers the 288
+- **`all.js` compatibility entry.** `import '@aceshooting/lyra-ui/all.js';` registers the 292
   root-included tags — everything **except** the 15 inventory-designated optional-peer-family tags:
   `lr-chart` and its 8 typed subclasses (`lr-line-chart`, `lr-bar-chart`, `lr-pie-chart`,
   `lr-doughnut-chart`, `lr-radar-chart`, `lr-polar-area-chart`, `lr-bubble-chart`,
@@ -3080,6 +3080,8 @@ arrowPadding?: number; hoverBridge?: HTMLElement; onPlaced?: (result: PlacementR
   `validationMessage`, and `willValidate`; `setFormValue(next)`; `getForm()`; `checkValidity()`;
   `reportValidity()`; `setCustomValidity(message)`; `resetValidity()`; `formResetCallback()`; and
   `formStateRestoreCallback(state, reason)`.
+  Writing `null` to `defaultValue` removes its markup value and resets the default to the adapter's
+  empty value; reading it still returns `TValue`. This does not overwrite a dirty live value.
   The exact callable signatures are `attachInternalsSafely(host: HTMLElement): ElementInternals`,
   `createFallbackInternals(): ElementInternals`, `createStringArrayFormDataState(name: string,
 values: readonly string[]): FormData`, `readStringArrayFormDataState(state: string | File |
@@ -3092,7 +3094,8 @@ toFormValue(value: TValue): FormSubmissionValue; toFormState?(value: TValue):
 FormSubmissionValue; isEmpty?(value: TValue): boolean; fromAttribute?(attribute: string): TValue;
 toAttribute?(value: TValue): string | null; fromFormState?(state: FormSubmissionValue): TValue }`
   and `FormAssociatedInterface<TValue> { internals: ElementInternals; get name(): string; set
-name(next: string | null); value: TValue; defaultValue: TValue; customError: string | null;
+name(next: string | null); value: TValue; get defaultValue(): TValue;
+set defaultValue(next: TValue | null); customError: string | null;
 disabled: boolean; required: boolean; readonly effectiveDisabled: boolean; get form():
 HTMLFormElement | null; set form(owner: FormOwnerValue); readonly labels: NodeList; readonly
 validity: ValidityState; readonly validationMessage: string; readonly willValidate: boolean;
@@ -3938,7 +3941,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraControlGroupReactProps;
   'lr-conversation-item': LyraConversationItemReactProps;
   'lr-copy-button': LyraCopyButtonReactProps;
+  'lr-country-picker': LyraCountryPickerReactProps;
   'lr-csv-viewer': LyraCsvViewerReactProps;
+  'lr-currency-picker': LyraCurrencyPickerReactProps;
   'lr-dashboard-grid': LyraDashboardGridReactProps;
   'lr-data-grid': LyraDataGridReactProps;
   'lr-dataset-viewer': LyraDatasetViewerReactProps;
@@ -4135,6 +4140,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraThreadListReactProps;
   'lr-time-input': LyraTimeInputReactProps;
   'lr-time-range': LyraTimeRangeReactProps;
+  'lr-time-zone-picker': LyraTimeZonePickerReactProps;
   'lr-timeline': LyraTimelineReactProps;
   'lr-timeline-item': LyraTimelineItemReactProps;
   'lr-toast': LyraToastReactProps;
@@ -4157,6 +4163,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraTreeReactProps;
   'lr-tree-item': LyraTreeItemReactProps;
   'lr-typing-indicator': LyraTypingIndicatorReactProps;
+  'lr-unit-picker': LyraUnitPickerReactProps;
   'lr-usage-badge': LyraUsageBadgeReactProps;
   'lr-video': LyraVideoReactProps;
   'lr-video-playlist': LyraVideoPlaylistReactProps;
@@ -4366,7 +4373,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraComponentTypeMap['lr-control-group']['element'];
   'lr-conversation-item': LyraComponentTypeMap['lr-conversation-item']['element'];
   'lr-copy-button': LyraComponentTypeMap['lr-copy-button']['element'];
+  'lr-country-picker': LyraComponentTypeMap['lr-country-picker']['element'];
   'lr-csv-viewer': LyraComponentTypeMap['lr-csv-viewer']['element'];
+  'lr-currency-picker': LyraComponentTypeMap['lr-currency-picker']['element'];
   'lr-dashboard-grid': LyraComponentTypeMap['lr-dashboard-grid']['element'];
   'lr-data-grid': LyraComponentTypeMap['lr-data-grid']['element'];
   'lr-dataset-viewer': LyraComponentTypeMap['lr-dataset-viewer']['element'];
@@ -4563,6 +4572,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraComponentTypeMap['lr-thread-list']['element'];
   'lr-time-input': LyraComponentTypeMap['lr-time-input']['element'];
   'lr-time-range': LyraComponentTypeMap['lr-time-range']['element'];
+  'lr-time-zone-picker': LyraComponentTypeMap['lr-time-zone-picker']['element'];
   'lr-timeline': LyraComponentTypeMap['lr-timeline']['element'];
   'lr-timeline-item': LyraComponentTypeMap['lr-timeline-item']['element'];
   'lr-toast': LyraComponentTypeMap['lr-toast']['element'];
@@ -4585,6 +4595,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraComponentTypeMap['lr-tree']['element'];
   'lr-tree-item': LyraComponentTypeMap['lr-tree-item']['element'];
   'lr-typing-indicator': LyraComponentTypeMap['lr-typing-indicator']['element'];
+  'lr-unit-picker': LyraComponentTypeMap['lr-unit-picker']['element'];
   'lr-usage-badge': LyraComponentTypeMap['lr-usage-badge']['element'];
   'lr-video': LyraComponentTypeMap['lr-video']['element'];
   'lr-video-playlist': LyraComponentTypeMap['lr-video-playlist']['element'];
@@ -4671,7 +4682,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraControlGroupSvelteProps;
   'lr-conversation-item': LyraConversationItemSvelteProps;
   'lr-copy-button': LyraCopyButtonSvelteProps;
+  'lr-country-picker': LyraCountryPickerSvelteProps;
   'lr-csv-viewer': LyraCsvViewerSvelteProps;
+  'lr-currency-picker': LyraCurrencyPickerSvelteProps;
   'lr-dashboard-grid': LyraDashboardGridSvelteProps;
   'lr-data-grid': LyraDataGridSvelteProps;
   'lr-dataset-viewer': LyraDatasetViewerSvelteProps;
@@ -4868,6 +4881,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraThreadListSvelteProps;
   'lr-time-input': LyraTimeInputSvelteProps;
   'lr-time-range': LyraTimeRangeSvelteProps;
+  'lr-time-zone-picker': LyraTimeZonePickerSvelteProps;
   'lr-timeline': LyraTimelineSvelteProps;
   'lr-timeline-item': LyraTimelineItemSvelteProps;
   'lr-toast': LyraToastSvelteProps;
@@ -4890,6 +4904,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraTreeSvelteProps;
   'lr-tree-item': LyraTreeItemSvelteProps;
   'lr-typing-indicator': LyraTypingIndicatorSvelteProps;
+  'lr-unit-picker': LyraUnitPickerSvelteProps;
   'lr-usage-badge': LyraUsageBadgeSvelteProps;
   'lr-video': LyraVideoSvelteProps;
   'lr-video-playlist': LyraVideoPlaylistSvelteProps;
@@ -5088,7 +5103,9 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-control-group': LyraControlGroupVueProps;
   'lr-conversation-item': LyraConversationItemVueProps;
   'lr-copy-button': LyraCopyButtonVueProps;
+  'lr-country-picker': LyraCountryPickerVueProps;
   'lr-csv-viewer': LyraCsvViewerVueProps;
+  'lr-currency-picker': LyraCurrencyPickerVueProps;
   'lr-dashboard-grid': LyraDashboardGridVueProps;
   'lr-data-grid': LyraDataGridVueProps;
   'lr-dataset-viewer': LyraDatasetViewerVueProps;
@@ -5285,6 +5302,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-thread-list': LyraThreadListVueProps;
   'lr-time-input': LyraTimeInputVueProps;
   'lr-time-range': LyraTimeRangeVueProps;
+  'lr-time-zone-picker': LyraTimeZonePickerVueProps;
   'lr-timeline': LyraTimelineVueProps;
   'lr-timeline-item': LyraTimelineItemVueProps;
   'lr-toast': LyraToastVueProps;
@@ -5307,6 +5325,7 @@ These named interfaces and helper signatures are available to typed integrations
   'lr-tree': LyraTreeVueProps;
   'lr-tree-item': LyraTreeItemVueProps;
   'lr-typing-indicator': LyraTypingIndicatorVueProps;
+  'lr-unit-picker': LyraUnitPickerVueProps;
   'lr-usage-badge': LyraUsageBadgeVueProps;
   'lr-video': LyraVideoVueProps;
   'lr-video-playlist': LyraVideoPlaylistVueProps;