@aceshooting/lyra-ui 25.3.1 → 25.5.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 25.5.0
+
+### Minor Changes
+
+- 8a42ae7: Add `lr-currency-picker`, a form-associated currency selector with localized names and symbols,
+  an optional ordered catalog, and a compact ISO-code trigger. The control follows shared keyboard,
+  validation, localization and styling contracts without fetching exchange rates or changing the
+  page locale. Its opt-in search matches codes, localized names and symbols, and catalogs support
+  caller-defined groups. Registration-free currency helpers expose the complete ISO catalog and
+  validate, load and convert explicit rate snapshots with caller-owned providers and cancellation.
+
+  Add country, time-zone and measurement-unit pickers with configurable catalogs, optional search,
+  native form contracts and consistent field styling. Country choices include localized names and
+  decorative flags by default, with an option to hide the flags. Add optional text filtering to the
+  language picker while preserving its locale loading, veto and selection behavior.
+
+  Match the form mixin's public reset-default setter type to its existing nullable runtime input,
+  while preserving the non-nullable read type and dirty live values. Keep a cleared reset attribute
+  absent after the next render instead of restoring an empty attribute through queued reflection.
+
+  Avoid marking selected `lr-select` and `lr-combobox` values as unavailable before their slotted
+  options have been collected, including during server rendering. Keep the select dropdown within
+  the available screen height and width when text is enlarged, and scroll keyboard-highlighted
+  options into view within the listbox. Document the existing rendered `data-value` hooks and `chooseOption()` test driver for
+  selecting options by value.
+
+## 25.4.0
+
+### Minor Changes
+
+- 9deeb23: Add the inherited `--lr-avatar-border` CSS border hook for image, glyph and initials avatars. It defaults to no border and keeps the configured outer diameter across shapes and avatar groups, while preserving the forced-colors boundary.
+- 9deeb23: Add matrix-only heatmap `rowHeight` / `row-height` to keep readable rows independently of fit-to-width columns, with matching pointer, keyboard, accessibility, frozen labels, and export geometry.
+- 9deeb23: Add opt-in `sync-group` coordination between categorical vertical `lr-chart` and `lr-lite-chart` bar and line charts. Pointer and keyboard navigation show each chart's own matching category, crosshair and tooltip while preserving focus, announcements and activation behavior.
+
+### Patch Changes
+
+- Keep the pan-zoom reset button’s screen-reader label inside its button so nested scroll containers do not create extra page overflow. Preserve localized reset names, keyboard activation and visible zoom percentages.
+- Contain flag-only locale-picker descriptions within their trigger and browser-frame address labels within their toolbar, preserving accessible text without enlarging outer scroll areas.
+- fffbad7: Support KaTeX 0.19 alongside the existing 0.18 range, and preserve complete version ranges in the generated optional-peer documentation.
+- 9deeb23: Give reorder-item move controls localized action-label fallbacks for automation tools that omit
+  reflected element references, while preserving the full action-and-row native accessible names.
+- 9deeb23: Qualify glass control borders from the effective painted opacity, preserving contrast at the default 70% while restoring ordinary border colors on opaque surfaces and nested overlays. Controls inside surface-colored outlined cards and disclosures no longer inherit bright glass border qualification.
+- 9deeb23: Keep the app rail resize handle aligned with the navigation edge during width transitions, live sizing changes and reconnection.
+- 9deeb23: Keep loading button spinners centered in a glyph-sized box so their rotation does not create overflow or flickering scrollbars in dialogs and scroll containers.
+
 ## 25.3.1
 
 ### Patch Changes

package/README.md

@@ -28,7 +28,7 @@
 library for accessible forms, dashboards, charts, data visualization, and AI chat/agent interfaces.
 Built with [Lit](https://lit.dev), it works with Lit, React, Vue, Angular, Svelte, and plain JavaScript.
 It is a practical open-source alternative to [Shoelace](https://shoelace.style/) and
-[Web Awesome](https://webawesome.com/), with 303 custom elements, native custom-element APIs,
+[Web Awesome](https://webawesome.com/), with 307 custom elements, native custom-element APIs,
 tree-shakeable, granular per-component imports, its own `--lr-*` design tokens, built-in localization and RTL support,
 and no runtime dependency on either project.
 
@@ -106,6 +106,14 @@ Run the installed, version-matched CLI with `--origin=lyra-v22` and review its r
 import and SSR replacements, theme semantics, event-detail changes and historical profile rules.
 The generated [`llms/migration.md`](./llms/migration.md) has per-component `wa-*`/`sl-*` mappings.
 
+## Quick Start
+
+Paste this prompt into Claude or Codex:
+
+```text
+Install the Lyra UI skill from GitHub aceshooting/lyra-ui. Start a Lit app with Vite+ and @aceshooting/lyra-ui, following the skill.
+```
+
 ## Install
 
 ```bash
@@ -214,7 +222,7 @@ import "@aceshooting/lyra-ui/all.js";
 > component registration entry, family entry, or `@aceshooting/lyra-ui/all.js` to define tags.
 > An unregistered tag remains inert even when the import and build succeed.
 
-`all.js` registers 288 tags — every component **except** the 15 inventory-designated
+`all.js` registers 292 tags — every component **except** the 15 inventory-designated
 optional-peer-family tags: `<lr-chart>` and its 8 typed subclasses, `<lr-box-plot>`,
 `<lr-histogram>`, `<lr-map>`, `<lr-graph>`, `<lr-knowledge-graph-explorer>`, and
 `<lr-geojson-viewer>` (see Install above). Those always require their own explicit subpath import,
@@ -838,7 +846,7 @@ covers every published component, and is regenerated by `pnpm run registration-g
 
 ## Components
 
-The catalog below lists all 303 tags in the current Custom Elements Manifest, grouped by
+The catalog below lists all 307 tags in the current Custom Elements Manifest, grouped by
 capability. The manifest and live docs are the authoritative sources for the complete generated
 API details.
 
@@ -848,6 +856,10 @@ API details.
 | -------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `<lr-combobox>` + `<lr-option>`              | `wa-combobox` / `wa-option` / `sl-option`                                       | Filterable single/multi select, form-associated; options separate live `selected` from attribute-backed/reset `defaultSelected`; `xs`–`xl` sizing; async rich rows and retained selection payloads via `source`/`selectedRows`; virtual scrolling with `max-render` |
 | `<lr-select>`                                | `wa-select` / `sl-select`                                                       | Closed-list single-select, button trigger (not a text input, no filtering); form-associated, shares `<lr-option>` with `lr-combobox`                                                                                                                                |
+| `<lr-currency-picker>` | — (extra) | Currency selector with optional name/code/symbol search, grouped catalogs and native validation |
+| `<lr-country-picker>` | — (extra) | Country and territory selector with localized names, flags and optional search |
+| `<lr-time-zone-picker>` | — (extra) | IANA time-zone selector with an ordered catalog override and optional search |
+| `<lr-unit-picker>` | — (extra) | Measurement-unit selector with localized names, symbols and custom unit catalogs |
 | `<lr-date-picker>`                           | `wa-date-picker`                                                                | Inline calendar, single + range                                                                                                                                                                                                                                     |
 | `<lr-date-input>`                            | `wa-date-input`                                                                 | Date field + calendar popover, form-associated                                                                                                                                                                                                                      |
 | `<lr-phone-input>`                           | — (extra)                                                                       | Country-aware telephone field with canonical E.164 form values; numbering metadata is supplied through an optional adapter                                                                                                                                          |