@aceshooting/lyra-ui 24.2.0 → 25.1.0

package/CHANGELOG.md

@@ -1,48 +1,60 @@
 # Changelog
 
-## 24.2.0
+## 25.1.0
 
 ### Minor Changes
 
-- 78b333b: Add controlled `loadingMore` and optional `loadingMoreLabel` to tables. Incremental loading keeps existing rows and the focused Load more button in place, communicates localized progress, and suppresses duplicate requests while pending. Initial full-table loading remains separate.
-- 78b333b: Add an optional `interactionBoundary` to `lr-popover.showAt()` so caller-owned virtual targets can toggle a popover without outside-pointer dismissal racing their click handler. The boundary affects only light dismissal and preserves caller-owned positioning, ARIA, and focus return.
+- 94a6d02: Emit `lr-tour-end` with reason `unavailable` when deferred placement fails and the tour closes, so hosts tracking the public lifecycle can clear their open state.
 
 ### Patch Changes
 
-- 548e61d: Preserve click pinning when popover or dropdown trigger lists combine click with hover or focus. Clicking an already revealed surface keeps it open without moving focus, while a second click dismisses it. Disabled or vetoed click openings no longer leave a stale pin behind.
-- 78b333b: Coalesce element resize positioning updates into the next animation frame to prevent resize-delivery errors when an open anchored surface changes size. Initial placement, scrolling and layout shifts remain immediate; queued resize updates are canceled when placement is disposed.
+- Close the combobox if its positioning runtime fails, even when a host vetoes ordinary dismissal. The failure emits a non-cancelable `lr-hide`; later user-initiated dismissal remains cancelable.
+- 8416b39: Keep `lr-data-grid` programmatic row alignment inside its own scrollable body so revealing a row does not move the page or an ancestor scroller.
+- 8416b39: Measure data-grid row, group, and expanded-detail heights in layout pixels so ancestor transforms and CSS zoom do not corrupt virtual scrolling. Correct subpixel scroll rounding for rendered and virtual rows so zoomed rows reach their requested viewport edge.
+- 8416b39: Keep map legend spacing aligned with native controls when an ancestor scales or zooms the map.
+- cfa77b8: Align virtual-list rows to the content viewport of a bordered external scroll element. Programmatic start, end, and nearest scrolling now account for the scroller's block-start border.
 
-  Reduce temporary placement allocations while preserving rollback and consumer-owned styles.
+  Remove redundant hex parsing from syntax-theme detection while preserving the browser's resolved CSS color behavior.
+- 8416b39: Align virtual-list rows correctly when an external scroll element or the list has a positive CSS scale or zoom. Start, end, and nearest scrolling now convert rendered geometry to list and scroll coordinates, including fractional borders and Window scrollers.
 
-## 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/">
@@ -62,7 +62,10 @@ v24 publication.
 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. Lyra's runtime defaults remain independently configurable.
+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.
 
@@ -505,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.