@aceshooting/lyra-ui 28.1.0 → 28.1.2

package/llms/components/lr-stat.md

@@ -114,6 +114,10 @@ it with `[part="label"]`'s generated id whenever `label` is non-empty (so tabbin
 `exactValue`-focusable value still announces e.g. "Revenue $1.2K USD", including the visible unit,
 not just the bare value); each
 `[part="row-value"]` is paired the same way with its own row's `[part="row-label"]`.
+Present metric and row labels expose the `term` role; their named values expose `definition`,
+which supports these accessible names. A unit-only headline value also exposes `definition`
+and includes the unit in its name. Values without a label or unit remain plain text; setting
+`exactValue` still adds the existing focus stop and exact-value tooltip in an unlinked stat.
 
 **Themeable custom properties:** `--lr-stat-bg` (default `var(--lr-color-surface)`) is
 `[part="base"]`'s RESTING background — the tier a dashboard sits at all day, and the companion to

package/llms/peers.md

@@ -38,7 +38,7 @@ for the page.
 | Peer | Range | Needed by |
 |---|---|---|
 | `@aceshooting/lyra-flags` | `^2.3.0` | _(loaded by a shared internal module)_ |
-| `@aceshooting/lyra-translations` | `^28.1.0` | _(not referenced by any component)_ |
+| `@aceshooting/lyra-translations` | `^28.1.2` | _(not referenced by any component)_ |
 | `@aiden0z/pptx-renderer` | `^1.3.0` | `lr-pptx-viewer` |
 | `@sgratzl/chartjs-chart-boxplot` | `^4.0.0` | `lr-box-plot` |
 | `chart.js` | `^4.0.1` | `lr-bar-chart`, `lr-box-plot`, `lr-bubble-chart`, `lr-chart`, `lr-doughnut-chart`, `lr-histogram`, `lr-line-chart`, `lr-pie-chart`, `lr-polar-area-chart`, `lr-radar-chart`, `lr-scatter-chart` |

package/llms/shared/ai-and-peers.md

@@ -130,3 +130,47 @@ sanitizer is unavailable. Some components additionally issue a deduped warning.
 component section instead of assuming every peer user renders an `<lr-skeleton>` or the same
 degraded state. `lr-phone-input` is the exception to dynamic peer import: it takes a consumer-built
 adapter (`loadLibphonenumberAdapter()`) rather than importing `libphonenumber-js` itself.
+
+### Experimental DOCX editing companion
+
+Use `@aceshooting/lyra-docs` for editing; `lr-docx-viewer` remains a viewer in Lyra UI.
+The companion uses optional `@docx-editor.dev/core@2.27.0`. Its installed README owns
+installation, admission limits, lifecycle, exact supported structures and save receipts.
+
+```ts
+import '@aceshooting/lyra-ui/theme.css';
+import '@aceshooting/lyra-docs/docx/editor';
+import '@aceshooting/lyra-docs/docx/editor.css';
+import { createDocxSession } from '@aceshooting/lyra-docs/docx';
+```
+
+`lr-docx-editor` provides command search (Ctrl/Command+K), bounded find excerpts and
+replace-and-advance, Outline, Checks and Review panels, table formatting and local raster
+image tools. `createDocxSession({ mount })` supports a host-owned toolbar; it requires a
+connected empty light-DOM mount. Both routes expose `can()`/`execute()`, `find()`/
+`selectMatch()`/`replaceMatch()`, `outline()`/`selectOutlineItem()`, `inspectDocument()`/
+`selectDiagnostic()`, and `review()`/`selectReviewItem()`. Query rows are copied, bounded
+and revision-scoped; refresh after edits and pass the returned `expectedRevision` when
+navigating. Queries do not save or fetch. Inspection covers body metadata only; capability
+fields `preserved`, `renderable` and `editable` remain `unverified`, and the report is not
+an accessibility certification.
+
+`insertImage(source, options)` copies local raster bytes and requires explicit dimensions;
+its narrow package profile includes visible styles and plain table cells at existing
+paragraph/run boundaries. `replaceImage(bytes, options)` preserves selected image size,
+title and description. Both use `DocxInsertImageOptions` for retained selection, revision
+and cancellation. `canInsertImage()` and `canReplaceImage()` are advisory; unsupported
+content refuses unchanged after canonical qualification.
+
+Table actions cover simple topology, explicit first-row headers, current-cell vertical
+alignment/shading/borders, and equal-column table width. Adding or replying to comments
+and changing tracking mode require an explicit author; supported comments can be replied
+to, resolved/reopened and deleted.
+Only bounded simple body text insertion/deletion revisions support accept/reject;
+unsupported revisions remain `readOnly`. These contracts do not qualify every native
+engine gesture or promise arbitrary DOCX fidelity.
+
+The host persists bytes explicitly: `save()` returns a receipt; call
+`acknowledgeSaved(receipt)` only after durable persistence. Disconnect destroys the
+session and undo history. See the [companion README](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-docs/README.md)
+for complete public types, bounds and guarded examples.

package/llms/shared.md

@@ -2719,6 +2719,50 @@ component section instead of assuming every peer user renders an `<lr-skeleton>`
 degraded state. `lr-phone-input` is the exception to dynamic peer import: it takes a consumer-built
 adapter (`loadLibphonenumberAdapter()`) rather than importing `libphonenumber-js` itself.
 
+### Experimental DOCX editing companion
+
+Use `@aceshooting/lyra-docs` for editing; `lr-docx-viewer` remains a viewer in Lyra UI.
+The companion uses optional `@docx-editor.dev/core@2.27.0`. Its installed README owns
+installation, admission limits, lifecycle, exact supported structures and save receipts.
+
+```ts
+import '@aceshooting/lyra-ui/theme.css';
+import '@aceshooting/lyra-docs/docx/editor';
+import '@aceshooting/lyra-docs/docx/editor.css';
+import { createDocxSession } from '@aceshooting/lyra-docs/docx';
+```
+
+`lr-docx-editor` provides command search (Ctrl/Command+K), bounded find excerpts and
+replace-and-advance, Outline, Checks and Review panels, table formatting and local raster
+image tools. `createDocxSession({ mount })` supports a host-owned toolbar; it requires a
+connected empty light-DOM mount. Both routes expose `can()`/`execute()`, `find()`/
+`selectMatch()`/`replaceMatch()`, `outline()`/`selectOutlineItem()`, `inspectDocument()`/
+`selectDiagnostic()`, and `review()`/`selectReviewItem()`. Query rows are copied, bounded
+and revision-scoped; refresh after edits and pass the returned `expectedRevision` when
+navigating. Queries do not save or fetch. Inspection covers body metadata only; capability
+fields `preserved`, `renderable` and `editable` remain `unverified`, and the report is not
+an accessibility certification.
+
+`insertImage(source, options)` copies local raster bytes and requires explicit dimensions;
+its narrow package profile includes visible styles and plain table cells at existing
+paragraph/run boundaries. `replaceImage(bytes, options)` preserves selected image size,
+title and description. Both use `DocxInsertImageOptions` for retained selection, revision
+and cancellation. `canInsertImage()` and `canReplaceImage()` are advisory; unsupported
+content refuses unchanged after canonical qualification.
+
+Table actions cover simple topology, explicit first-row headers, current-cell vertical
+alignment/shading/borders, and equal-column table width. Adding or replying to comments
+and changing tracking mode require an explicit author; supported comments can be replied
+to, resolved/reopened and deleted.
+Only bounded simple body text insertion/deletion revisions support accept/reject;
+unsupported revisions remain `readOnly`. These contracts do not qualify every native
+engine gesture or promise arbitrary DOCX fidelity.
+
+The host persists bytes explicitly: `save()` returns a receipt; call
+`acknowledgeSaved(receipt)` only after durable persistence. Disconnect destroys the
+session and undo history. See the [companion README](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-docs/README.md)
+for complete public types, bounds and guarded examples.
+
 ## Framework integration
 
 Plain custom elements, so they work anywhere — with the usual two caveats. React 19/JSX, Vue 3,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aceshooting/lyra-ui",
-  "version": "28.1.0",
+  "version": "28.1.2",
   "description": "Free, independent Lit web components: an open-source alternative to Shoelace and Web Awesome with accessible forms, dashboards, charts, and agent UI.",
   "keywords": [
     "web-components",
@@ -2598,7 +2598,7 @@
   },
   "peerDependencies": {
     "@aceshooting/lyra-flags": "^2.3.0",
-    "@aceshooting/lyra-translations": "^28.1.0",
+    "@aceshooting/lyra-translations": "^28.1.2",
     "@aiden0z/pptx-renderer": "^1.3.0",
     "@sgratzl/chartjs-chart-boxplot": "^4.0.0",
     "chart.js": "^4.0.1",
@@ -2749,11 +2749,11 @@
     "d3-force": "^3.0.0",
     "d3-selection": "^3.0.0",
     "d3-zoom": "^3.0.0",
-    "dompurify": "^3.4.16",
+    "dompurify": "^3.4.17",
     "emoji-picker-element-data": "^1.8.0",
     "epubjs": "^0.3.93",
     "fast-check": "^4.10.2",
-    "happy-dom": "^20.14.6",
+    "happy-dom": "^21.0.1",
     "ical.js": "^2.2.1",
     "istanbul-lib-coverage": "^3.2.2",
     "istanbul-lib-report": "^3.0.1",
@@ -2765,7 +2765,7 @@
     "libphonenumber-js": "^1.13.15",
     "mammoth": "^1.13.0",
     "maplibre-gl": "^6.14.0",
-    "marked": "^18.1.0",
+    "marked": "^18.1.1",
     "oxc-parser": "^0.153.0",
     "papaparse": "^5.7.0",
     "pdfjs-dist": "^6.4.299",