@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 29.1.0
+
+### Minor Changes
+
+- 3807e35: Improve large-collection rendering, search, interaction and streaming.
+
+  - Cache unchanged projections, indexes, geometry and content; limit focus, selection, pointer and scroll work to affected or visible content.
+  - Expose bounded limits and omitted-content notices. Tail feeds retain newest entries; virtual lists support large logical scroll extents.
+  - Add host-owned collection sources, bounded tabular access and staged numeric preparation preserving counts, domains, distributions and source indices.
+  - Reuse markdown/highlighting, bound viewer input before parsing and accept in-memory tabular data.
+  - Load optional graph features on demand; add `lr-map.updateSourceData()` for source diffs.
+  - Add scale-regression checks alongside behavior and accessibility tests.
+  - Preserve styles when elements change documents.
+
+  Paging, hierarchy, graph/spatial controllers and numeric utilities expand bundles, alongside localized loading/error/coverage messages. Declarations, docs and locale catalogs increase unpacked size; see component references for limits and input ownership.
+
+  Matched Chromium benchmarks (software rendering, 15 workloads, seven samples each) against 29.0.2 found 12/150 phase/control series above both 15% and 1 ms; no operation-total median or p95 did. Queue projection shifts cost from assignment to update, reducing their combined cost. Table sort/filter settlement rose; totals stayed near 44 ms. Frame waits and no-op controls also rose; they include scheduling, not only CPU work. One chart tail raised update/settlement p95; its cause is unresolved. With seven samples, p95 is the maximum, not a field tail-latency estimate.
+
+### Patch Changes
+
+- b603b71: Correct and tighten the shipped documentation and agent skills.
+
+  - The README upgrade guidance is one table covering every major release since v22, with the matching `lyra-ui-migrate` profile for each.
+  - The exported TypeScript contracts in `llms/shared/events-and-types.md` now print their real member, parameter and return types instead of `unknown` placeholders.
+  - Relative links in generated `llms/shared.md`, `llms/components/<tag>.md` and `llms-full.txt` now resolve from their published location.
+  - Accessible-name guidance no longer describes `accessibleLabel` compatibility properties that were already removed.
+  - `lyra-ui-migrate --help` describes the `lyra-v25` profile.
+  - The bundled agent skills drop guidance for past upgrades, list `@aceshooting/lyra-map` among independently versioned companions, name every rename profile, and prefer the installed package's `llms/` reference over the plugin copy.
+- 88c3542: Reduce remaining large-collection costs.
+
+  - `lr-tool-timeline` keeps the processed form of every unchanged call when a replaced collection appends or updates a few calls, instead of rebuilding all retained calls.
+  - Currency and unit pickers resolve a new locale's names and symbols without evicting number formatters other components share.
+  - Theme-aware components no longer receive style and class mutations from inside their own shadow root, such as map marker movement, unless a nested theme-aware component needs them.
+
+  These changes add up to 128 gzip bytes to the complete registration, family barrels, root entry and scoped-registry loader route, and 295 raw bytes to the packed core bundle. Only the breached size ceilings advance, each to the next 64-byte boundary above its measurement (raw core: 40 bytes of headroom).
+- @aceshooting/lyra-translations@29.1.0
+
 ## 29.0.2
 
 ### Patch Changes

package/README.md

@@ -16,7 +16,7 @@
 [![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/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)
+[![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
 
 <p align="center">
   <a href="https://www.lyra-ui.com/">
@@ -38,8 +38,6 @@ and no runtime dependency on either project.
 > users get a separate `sl-*` migration map because the APIs are not identical. No competitor runtime,
 > theme, token namespace, or source code is required by Lyra.
 
-<a id="v21-highlights"></a>
-
 ## Highlights
 
 - **Composable looks.** Lyra, shadcn, Material, data, terminal and high contrast combine with independent
@@ -55,28 +53,24 @@ and no runtime dependency on either project.
 The [roadmap](../../docs/roadmap.md#roadmap-index-and-release-status) tracks upcoming work; the
 [changelog](CHANGELOG.md) and [archive](../../docs/changelog) hold per-version changes and older upgrade notes.
 
-## Upgrading to v23
-
-Compatibility APIs deprecated before v22 were removed; use the [migration guide](./llms/migration.md) and the `lyra-v21` profile ([notes](../../docs/changelog/v23.md)).
-
-## Upgrading to v24
+## Upgrading
 
-Theme/preset facade, nested registration routes and `ssr-loader.js` were removed; follow the [v23-to-v24 guide](./llms/shared/v23-to-v24-migration.md) and run the CLI with `--origin=lyra-v22` ([notes](../../docs/changelog/v24.md)).
+Every major release has notes. This list covers all of them since v22; older ones are in the
+[archive](../../docs/changelog). Moving across several majors? Do them one at a time, oldest first:
+each `--origin` profile below needs the CLI from the version it upgrades to
+(`npx --package @aceshooting/lyra-ui@<version> lyra-ui-migrate`). The [migration guide](./llms/migration.md)
+has the full rules, and `--check` lists what's left without changing any files.
 
-## Upgrading to v27
-
-V27 is a major release; each change below has a migration note in the [changelog](CHANGELOG.md). Run `npx lyra-ui-migrate --origin=lyra-v26 --check src` first.
-
-- **Package split.** Locale catalogs moved to [`@aceshooting/lyra-translations`](../lyra-translations)
-  (`@aceshooting/lyra-ui/translations/<locale>.js` becomes `@aceshooting/lyra-translations/<locale>.js`; the
-  pseudo-locales stay here) and editor data to [`@aceshooting/lyra-ide`](../lyra-ide)
-  (the `custom-elements.json` export is now `@aceshooting/lyra-ide/custom-elements.json`). Install
-  them at the same version; `loadLyraLocale()` needs `lyra-translations`.
-- **Agent tools.** `ToolCallStatus` and `ToolResultStatus` are replaced by one `ToolStatus` union.
-  `lr-task-list` and `lr-prompt-studio` default `heading-level` to `none`; set `3` / `2` to keep headings.
-- **Copy controls** show feedback for 1500 ms; set `feedback-duration="1000"` on `lr-copy-button` to keep the old timing.
-- **Text fields.** `lr-phone-input`'s string `autoCorrect` is now the boolean `autocorrect`.
-- **Charts** over the row budget keep every series and thin only rows.
+| To | What breaks | Migration help |
+| --- | --- | --- |
+| **v29** | `lr-map` now uses the optional `@aceshooting/lyra-map` renderer (or set `engine="maplibre"`); the DOCX editor bundles its engine and `execute()` returns a promise | [Changelog](CHANGELOG.md#2900), [map setup](../lyra-map/README.md) |
+| **v28** | Shared `--lr-*` tokens are declared once per document; a `--lr-theme-*` input set on a plain element needs `data-lr-theme-scope` | `--rule=theme-scopes`, [notes](../../docs/changelog/v28.md) |
+| **v27** | Locales moved to `@aceshooting/lyra-translations`, editor data to `@aceshooting/lyra-ide`; one `ToolStatus` union; some changed defaults | `--origin=lyra-v26`, [notes](../../docs/changelog/v27.md) |
+| **v26** | Form events use native `input`/`change` plus typed `lr-input`/`lr-change`; resize, focus and viewer-diagnostic events changed | `--origin=lyra-v25`, [notes](../../docs/changelog/v26.md) |
+| **v25** | Built-in look is now Shadcn, Glass, Emerald and System mode | Set the look you want explicitly, [notes](../../docs/changelog/v25.md) |
+| **v24** | Theme/preset facade, nested registration routes and `ssr-loader.js` removed | `--origin=lyra-v22`, [v23→v24 guide](./llms/shared/v23-to-v24-migration.md), [notes](../../docs/changelog/v24.md) |
+| **v23** | APIs deprecated before v22 removed | `--origin=lyra-v21`, [notes](../../docs/changelog/v23.md) |
+| **v22** | Requires Node 22 and the Popover API; Lyra-only events and defaults normalized | `--origin=lyra-v21`, [notes](../../docs/changelog/v22.md) |
 
 ## Quick Start
 
@@ -231,8 +225,7 @@ Lyra reads only its own `--lr-theme-*` variables; map existing values in applica
 
 Some upstream behavior is deliberately not automatic; the report records it instead of emitting markup that weakens a boundary:
 
-- `<lr-include>` sanitizes every fragment, has no script mode, defaults `mode` to `same-origin`, and strips every
-  navigation or resource attribute except same-document `#fragment` anchors. Its post-sanitization transclusion is network-silent and non-interactive: anchors remain only for resolvable same-document `#fragment` links (rebased per include instance); every other navigation or resource attribute, including `href`, `src`, `srcset`, `action`, `ping`, and `poster`, is stripped, so images do not load. Form-control and custom-element wrappers are unwrapped to safe ordinary text or children, while controls with no passive content are removed.
+- `<lr-include>` sanitizes every fragment, has no script mode, and defaults `mode` to `same-origin`. Its post-sanitization transclusion is network-silent and non-interactive: anchors remain only for resolvable same-document `#fragment` links (rebased per include instance); every other navigation or resource attribute, including `href`, `src`, `srcset`, `action`, `ping`, and `poster`, is stripped, so images do not load. Form-control and custom-element wrappers are unwrapped to safe ordinary text or children, while controls with no passive content are removed.
 - Link-like controls always add `noopener noreferrer` to `rel` when `target` is set and strip `opener`; author
   `rel` tokens are merged. `<lr-app-rail-item>` still derives `rel` from `target` alone.
 - `<lr-zoomable-frame>` rejects active/non-embeddable schemes, always sandboxes, and never combines
@@ -247,7 +240,7 @@ density, mode and accent independently ([guide](./llms/shared/styles-and-tokens.
 
 `setLyraStyle({})` from `@aceshooting/lyra-ui/theme.js` restores saved choices (missing fields use the built-in
 profile); `setLyraStyle({ look: "lyra", surface: "solid", accent: null })` selects the earlier appearance and
-`resetLyraStyle()` restores the built-in profile. Since 28.0.0 the resolved `--lr-color-*`/`--lr-space-*`/... layer is
+`resetLyraStyle()` restores the built-in profile. The resolved `--lr-color-*`/`--lr-space-*`/... layer is
 declared once per document and re-derived only at **theme scopes** (`.lr-light`/`.lr-dark`, `data-lr-theme`, style-axis
 boundaries, or any element marked `data-lr-theme-scope`), so retheme through the `--lr-theme-*` inputs on `:root` or a
 theme scope, for example `:root { --lr-theme-color-brand-fill-loud: #60a5fa; }`; an input on a plain wrapper no longer