@aceshooting/lyra-ui 24.1.0 → 25.0.0

package/CHANGELOG.md

@@ -1,34 +1,43 @@
 # Changelog
 
-## 24.1.0
-
-### Minor Changes
-
-- c3ed27e: Expose approval finalization and retry methods on `lr-agent-workspace` for its built-in tool timeline.
-
-### Patch Changes
-
-- c3ed27e: Correct the table sort listener example and v24 event detail and global event type guidance.
-- c3ed27e: Keep swatch radios and keyboard focus stable when applications assign equivalent fresh palette items, while preserving distinct duplicate occurrences and original item identities during reordering.
-
-## 24.0.0
+## 25.0.0
 
 ### Major Changes
 
-- aa25ee4: Remove the eligible v22 compatibility APIs after their supported v23 transition period. Use granular component registration and class imports, the independent style APIs, and the `lyra-v21` and `lyra-v22` migration profiles when upgrading. Upstream-mirrored aliases and saved style-preference readers remain supported.
+- ad64381: Use Shadcn, Glass, Emerald and System mode as the built-in appearance defaults. First paint, runtime restoration and resets share the same profile while preserving independently saved choices, including explicit Solid surfaces, the Lyra look and cleared accents. `accent: null` remains an explicit clear; `resetLyraStyle()` restores the Emerald default.
 
-  Consolidate component implementations and behavioral tests, refresh library documentation, and qualify styling, localization, package costs and representative compositions for the new release.
+  Use a 70% opaque Glass fill across navigation, menus, listboxes, dialogs and drawers, with foreground contrast protection. Native application chrome can use `.lr-surface-chrome` from `theme.css`. Scrolling surfaces keep their material stationary, nested surfaces avoid repeated blur, and accessibility preferences retain opaque fills.
 
-  Data grids resolve themed row heights once per measurement pass, reducing repeated layout work for large and expanded tree views while preserving live theme changes.
+  Allow `--lr-theme-surface-opacity` to span 0–1 for user-controlled Glass opacity. The default remains 70%; Solid surfaces and increased-contrast or reduced-transparency preferences remain opaque. The design-panel recipe uses the existing slider, the public CSS input and an application preference to save and reset opacity.
 
-  Clearing a component's locale override now observes the inherited locale even when the public locale resolver was called before its next render. Time inputs reuse the active locale's native-digit map across keystrokes while continuing to accept ASCII digits. Media controls share locale-aware time formatting, and animation timing uses a shared CSS time parser; the AV player retains its whole-second rounding behavior.
+  Preserve explicit Solid and Glass scopes across nested and promoted surfaces, and keep plain rail and menubar frames transparent. Align form controls across size tiers while preserving custom sizing and wrapping. Keep keyboard focus visible inside clipped panels and image viewports, and restore visible hover feedback in document comparison panes.
 
-  Map data layers skip unused fallback color resolution when explicit colors are valid. Command palettes project visible result rows plus the active row without filtering every group, and Lite Chart reuses the category-label width it already measured for automatic axis selection. These changes preserve the existing rendered and interaction contracts; no latency claim is implied.
+  Resolve contrast corrections against the selected or inherited look during startup and runtime updates. Preserve the Lyra look's local decorative-border fallback while retaining Shadcn defaults without a theme stylesheet.
 
-  Lite Chart no longer reads the retired `accessibleLabel` property as a fallback. Streaming text documents and types its existing internal-link event, while RAG answers contain their owned markdown child's link events. Buttons share identical slot and focus handlers, and locale resolution shares one cache record per component.
+### Minor Changes
 
-  The package README, migration guides and agent skill now route to focused v24 import, styling, SSR and event-detail guidance. Historical roadmap scope remains available through stable anchors and focused pages.
+- d839991: Add `--lr-gemstone-selected-animation` to disable the selected gemstone shine independently while preserving its static halo. The inherited hook works in gemstone swatch pickers and external glyphs, preserves the default loop when unset, and respects application and OS reduced motion.
+
+### Patch Changes
 
-  Event-detail migration diagnostics distinguish payload fields from component properties, avoiding conflicting advice for `lr-app-rail-group` listeners. The retained migration profiles continue to report manual changes for consumers upgrading across multiple major versions.
+- Handle map style failures after rendering and discard obsolete work when the style or connection changes.
+- Honor the current disabled and read-only state before submitting a completed OTP value.
+- Refresh knowledge-base error content when an existing child's slot assignment changes.
+- Cancel obsolete text previews before rendering a changed format or loading status.
+- Announce asynchronously rendered chat messages across window realms, including adopted custom elements.
+- Refresh document-library error content when an existing child's slot assignment changes.
+- Preserve tall content inside vertically constrained scrollers instead of shrinking slotted items to the viewport.
+- Reset a collapsed map legend's scroll position so its Glass layer cannot retain an empty scroll range; preserve focus and expanded scrolling.
+- 29ef483: Keep locale-picker language menus within the viewport when text is enlarged by capping their minimum width by the existing viewport limit.
+- 57d8360: Declare cascade layer order in the signature starter so bundled styles preserve the selected look and accent, and include the supported refresh glyph in the icon reference.
+- ad64381: Apply the shared Glass treatment to map navigation, scale, attribution and legends. Solid and
+  accessibility preferences retain opaque surfaces, and scrolling legends keep their material
+  stationary without changing native peer controls or map data colors.
+
+  Defer resize-observer control measurements to the next animation frame so adjusting a legend's
+  available space cannot interrupt the same resize notification cycle. Cancel pending measurements
+  when the map disconnects or changes containers.
+- 3023260: Keep locale loading Retry reachable beside an open locale picker popup, including top-layer popups. The popup places outside failure guidance while preserving the previous selection until loading succeeds.
+- 6825826: Reveal the complete keyboard-focused swatch in scrolling single-row palettes, including after item updates.
 
 Older major versions: [release history archive](https://github.com/aceshooting/lyra-ui/tree/main/docs/changelog).

package/README.md

@@ -10,13 +10,13 @@
 [![npm](https://img.shields.io/npm/v/%40aceshooting%2Flyra-ui)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
 [![npm downloads](https://img.shields.io/npm/dm/%40aceshooting%2Flyra-ui)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
 [![npm weekly downloads](https://img.shields.io/npm/dw/%40aceshooting%2Flyra-ui)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
-[![Node.js](https://img.shields.io/node/v/%40aceshooting%2Flyra-ui)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
+[![Node.js](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.npmjs.org%2F%40aceshooting%2Flyra-ui%2Flatest&query=%24.engines.node&label=node&color=339933&logo=nodedotjs&logoColor=white)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
 [![Lit](https://img.shields.io/badge/Lit-3-324FFF?logo=lit)](https://lit.dev/)
 [![Web Components](https://img.shields.io/badge/Web%20Components-native-29ABE2)](https://www.webcomponents.org/)
 [![avg per component](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faceshooting%2Flyra-ui%2Fmain%2Fpackages%2Flyra-ui%2Fscripts%2Fbundle-stats.json&query=%24.avgComponentGzipKb&label=avg%20per%20component&suffix=%20KB%20gzip&color=blue)](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/scripts/bundle-stats.json)
 [![total gzip](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faceshooting%2Flyra-ui%2Fmain%2Fpackages%2Flyra-ui%2Fscripts%2Fbundle-stats.json&query=%24.barrelGzipKb&label=total%20gzip&suffix=%20KB&color=blue)](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/scripts/bundle-stats.json)
-[![types](https://img.shields.io/npm/types/%40aceshooting%2Flyra-ui)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
-[![license](https://img.shields.io/npm/l/%40aceshooting%2Flyra-ui)](./LICENSE)
+[![types](https://img.shields.io/badge/types-TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.npmjs.com/package/@aceshooting/lyra-ui)
+[![license](https://img.shields.io/github/license/aceshooting/lyra-ui)](./LICENSE)
 
 <p align="center">
   <a href="https://www.lyra-ui.com/">
@@ -59,17 +59,13 @@ The [release roadmap](../../docs/roadmap.md#roadmap-index-and-release-status) tr
 localization, cleanup and qualification work, then the separate website and consumer rollout after
 v24 publication.
 
-Choose the original Lyra look by loading `theme.css`. To select shadcn through the runtime:
-
-```js
-import '@aceshooting/lyra-ui/theme.css';
-import '@aceshooting/lyra-ui/looks/shadcn.css';
-import '@aceshooting/lyra-ui/accents.css';
-import { setLyraStyle } from '@aceshooting/lyra-ui/theme.js';
-
-setLyraStyle({ look: 'shadcn', mode: 'system', accent: 'sapphire' });
-setLyraStyle({ accent: 'ruby' }); // keeps the other choices
-```
+For new apps, use the [Lyra signature starter](./llms/shared/styles-and-tokens.md#lyra-signature-starter):
+Shadcn, glass, Emerald, theme-aware spotlights, compact gemstones and country-flag language controls.
+The recipe preserves saved choices and explicit branding and covers first paint, persistence and
+accessible controls. The built-in profile is Shadcn/Glass/Emerald/System with comfortable density;
+saved choices override each axis independently. To retain the earlier appearance, select
+`look: 'lyra'`, `surface: 'solid'`, and `accent: null` explicitly. Clearing an accent with `null`
+remains supported; `resetLyraStyle()` restores Emerald.
 
 See the [changelog](CHANGELOG.md) for version-by-version changes and historical upgrade notes.
 
@@ -512,27 +508,27 @@ matching `data-lr-theme` attribute) on an ancestor:
 @import "@aceshooting/lyra-ui/theme.css";
 ```
 
-**shadcn/ui look.** Add one more import to restyle every component after shadcn/ui's default
-("new-york", Neutral) — monochrome primary, `0.5rem` radii, `text-sm`, `h-9` controls, a 3px focus
-ring. It layers over `theme.css` whatever the load order, also answers to shadcn's `.dark`/`.light`
-classes, and keeps gemstone accents working. A few values deliberately differ from shadcn to keep
-WCAG contrast (control borders, focus colour, danger red, chart colours); see
-[The shadcn look](./llms/shared.md#the-shadcn-look--looksshadcncss).
+**Appearance defaults.** Shadcn, Glass, Emerald, System mode and comfortable density are built in.
+`theme.css` supplies the document-level profile, including the default look, accent and material;
+granular components also carry these visual defaults. Select a different look or accent through
+the canonical style API, preserving each valid saved choice at startup:
 
-```css
-@import "@aceshooting/lyra-ui/theme.css";
-@import "@aceshooting/lyra-ui/looks/shadcn.css";
-@import "@aceshooting/lyra-ui/accents.css";
+```js
+import { setLyraStyle } from '@aceshooting/lyra-ui/theme.js';
+
+setLyraStyle({}); // Restore saved choices; missing or invalid fields use the built-in profile.
 ```
 
-Select the same look through the canonical style API after importing its stylesheet:
+To retain the earlier Lyra/Solid appearance without an accent:
 
 ```js
-import { setLyraStyle } from '@aceshooting/lyra-ui/theme.js';
-
-setLyraStyle({ look: 'shadcn', mode: 'system', accent: 'sapphire' });
+setLyraStyle({ look: 'lyra', surface: 'solid', accent: null });
 ```
 
+`accent: null` clears the accent. `resetLyraStyle()` restores the built-in profile, including
+Emerald; pass a field list to reset only those axes. See [The shadcn look](./llms/shared.md#the-shadcn-look--looksshadcncss)
+for the look's typography, geometry and contrast adjustments.
+
 The style API persists the independent look, surface, density, mode and accent choices. See the
 [style API guide](./llms/shared/styles-and-tokens.md#composing-looks-surfaces-and-density) for
 scoped styling, reset and saved-preference behavior.