@aceshooting/lyra-ui 18.2.0 → 18.3.0

package/llms/components/lr-export-button.md

@@ -57,6 +57,11 @@ extension?: string }`. Descriptor labels/descriptions are consumer-supplied, alr
   copy. `formatId` must be nonempty and unique; malformed options and later duplicates are omitted
   first-wins before menu state, focus reconciliation, or export events. Custom format ids are
   event-only; no custom encoder is bundled
+- `size?: LyraSize` — optional density on the shared `2xs` through `xl` ladder, including the
+  `small`/`medium`/`large` aliases. It changes trigger and menu-row typography and padding while
+  retaining the shared 40px minimum hit-area floor. Unset preserves the established geometry
+- `appearance?: LyraExportButtonAppearance` — `outlined` or `quiet` trigger treatment. Unset
+  preserves the established surface, border, and text colors
 - `disabled: boolean = false` (reflected) — also disables every `[part="menu-item"]` button, not just
   the trigger
 - `loading: boolean = false` (reflected) — controlled busy state for an async or server-generated

package/llms/components/lr-heatmap.md

@@ -348,9 +348,13 @@ color?: string; label?: string; partOfRamp?: boolean }`: a discrete legend key r
   "no data" color next to an N-step ramp) to exclude just that stop from the comparison; defaults to
   `true`. A caption-only stop (no `color`) is already excluded regardless of this flag.
 
-**Getters/methods:** `refreshTheme()` — redraws canvas content after an upstream design-token or
-color-scheme change; called automatically on theme changes, exposed for a consumer that needs to
-force a redraw manually. `matrixGeometry: Readonly<LyraHeatmapMatrixGeometryChangeDetail> | undefined` — the gutter/cell geometry the last matrix-mode draw actually painted with,
+**Getters/methods:** `exportData('png')` returns a PNG data URL for the most recently completed
+canvas paint. It includes the painted axes, cells, focus/selection/annotation overlays, and frozen
+label bands while `stickyLabels` is enabled; the DOM legend, tooltip, and accessible-cell buttons
+are deliberately excluded. It returns `''` before a completed paint, while rendering is deferred or
+zero-sized, after disconnect, or when the browser cannot encode the snapshot. `refreshTheme()` —
+redraws canvas content after an upstream design-token or color-scheme change; called automatically
+on theme changes, exposed for a consumer that needs to force a redraw manually. `matrixGeometry: Readonly<LyraHeatmapMatrixGeometryChangeDetail> | undefined` — the gutter/cell geometry the last matrix-mode draw actually painted with,
 in CSS pixels; `undefined` in calendar mode. Lets a light-DOM consumer line up with the canvas
 without hardcoding the same numbers `row-label-width`/`col-label-height`'s `"auto"` resolution would
 otherwise keep private. For the case that motivated it — a frozen header or gutter on a tall or wide

package/llms/components/lr-lightbox.md

@@ -46,6 +46,13 @@ trap, Escape/backdrop dismissal, scroll lock, and focus return.
 - `minZoom: number = 0.5`, `maxZoom: number = 4`, `zoomStep: number = 0.25` (attributes `min-zoom`/
   `max-zoom`/`zoom-step`) — pure pass-throughs to the embedded `<lr-pan-zoom>`, which does the
   normalizing.
+- `fit: LyraImageFit = 'actual'` (reflected) — opt-in base sizing policy for the current image,
+  reusing `<lr-image-viewer>`'s `contain`/`width`/`actual` vocabulary. The default preserves the
+  existing natural-size behavior. `contain` fits both landscape and tall images inside the stage;
+  `width` fills its inline size. CSS recalculates either policy when the stage is resized or a
+  delayed image source finishes loading, so navigation and opening do not require consumer timers.
+  Fit is the base zoom policy: an explicit user zoom remains until navigation or a reset, and
+  changing the theme does not mutate the lightbox's zoom property.
 - `accessibleLabel: string | null = null` (attribute `aria-label`) — the panel's accessible name,
   overriding the localized `lightboxLabel`.
 
@@ -102,6 +109,10 @@ photo content.
 - zoom/pan reset on navigation is imperative (`resetView()` from `updated()`), not a binding; the
   frame element is reused across navigations rather than recreated, so a keyboard user who tabbed
   into the viewport keeps focus.
+- fit sizing is CSS-driven inside the stable frame. The rendered DOM image is not copied or
+  measured by the lightbox, so stale load events cannot apply a previous image's size. The fit
+  policy covers the painted image only; the lightbox's DOM caption, toolbar, legend-like actions,
+  and tooltip content remain outside that image surface.
 - scope for v1: no per-image slotted content (data-driven via `images` only), no dot indicators, no
   visual open/close animation, no click-image-to-navigate, no touch-swipe. Lifecycle phases are
   still observable through the before/after events and methods above.

package/llms/components/lr-pan-zoom.md

@@ -27,6 +27,10 @@ import to `LyraPanZoom`); `lr-zoomable-frame` now means the mapped iframe compon
   `zoomStep: number = 0.25` — bounded, finite zoom configuration
 - `src: string = ''` and `alt: string = ''` — optional safe image source. A rejected URL is treated
   as absent and the default slot renders; no empty or unsafe `<img>` replaces that fallback.
+- `fit: LyraImageFit = 'actual'` (reflected) — base sizing policy for an image supplied through
+  `src`, using the same `contain`/`width`/`actual` vocabulary as `<lr-image-viewer>`. `actual`
+  preserves the historical natural-size layout; the other modes resolve against the viewport and
+  update with its allocation, including when an image loads after the frame first renders.
 - `accessibleLabel: string | null` (attribute `aria-label`) — a declarative host label remains on
   the host while the focusable viewport receives the localized inspection-surface purpose name.
   A property-only value names the viewport and updates reactively without creating a host attribute. This avoids cloning one author label onto both the outer component and nested `role="group"`. An explicitly empty direct property remains empty; a present host attribute, including an empty one, leaves the viewport's localized purpose name intact.

package/llms-full.txt

@@ -13702,9 +13702,13 @@ color?: string; label?: string; partOfRamp?: boolean }`: a discrete legend key r
   "no data" color next to an N-step ramp) to exclude just that stop from the comparison; defaults to
   `true`. A caption-only stop (no `color`) is already excluded regardless of this flag.
 
-**Getters/methods:** `refreshTheme()` — redraws canvas content after an upstream design-token or
-color-scheme change; called automatically on theme changes, exposed for a consumer that needs to
-force a redraw manually. `matrixGeometry: Readonly<LyraHeatmapMatrixGeometryChangeDetail> | undefined` — the gutter/cell geometry the last matrix-mode draw actually painted with,
+**Getters/methods:** `exportData('png')` returns a PNG data URL for the most recently completed
+canvas paint. It includes the painted axes, cells, focus/selection/annotation overlays, and frozen
+label bands while `stickyLabels` is enabled; the DOM legend, tooltip, and accessible-cell buttons
+are deliberately excluded. It returns `''` before a completed paint, while rendering is deferred or
+zero-sized, after disconnect, or when the browser cannot encode the snapshot. `refreshTheme()` —
+redraws canvas content after an upstream design-token or color-scheme change; called automatically
+on theme changes, exposed for a consumer that needs to force a redraw manually. `matrixGeometry: Readonly<LyraHeatmapMatrixGeometryChangeDetail> | undefined` — the gutter/cell geometry the last matrix-mode draw actually painted with,
 in CSS pixels; `undefined` in calendar mode. Lets a light-DOM consumer line up with the canvas
 without hardcoding the same numbers `row-label-width`/`col-label-height`'s `"auto"` resolution would
 otherwise keep private. For the case that motivated it — a frozen header or gutter on a tall or wide
@@ -24829,6 +24833,11 @@ extension?: string }`. Descriptor labels/descriptions are consumer-supplied, alr
   copy. `formatId` must be nonempty and unique; malformed options and later duplicates are omitted
   first-wins before menu state, focus reconciliation, or export events. Custom format ids are
   event-only; no custom encoder is bundled
+- `size?: LyraSize` — optional density on the shared `2xs` through `xl` ladder, including the
+  `small`/`medium`/`large` aliases. It changes trigger and menu-row typography and padding while
+  retaining the shared 40px minimum hit-area floor. Unset preserves the established geometry
+- `appearance?: LyraExportButtonAppearance` — `outlined` or `quiet` trigger treatment. Unset
+  preserves the established surface, border, and text colors
 - `disabled: boolean = false` (reflected) — also disables every `[part="menu-item"]` button, not just
   the trigger
 - `loading: boolean = false` (reflected) — controlled busy state for an async or server-generated
@@ -28547,6 +28556,10 @@ import to `LyraPanZoom`); `lr-zoomable-frame` now means the mapped iframe compon
   `zoomStep: number = 0.25` — bounded, finite zoom configuration
 - `src: string = ''` and `alt: string = ''` — optional safe image source. A rejected URL is treated
   as absent and the default slot renders; no empty or unsafe `<img>` replaces that fallback.
+- `fit: LyraImageFit = 'actual'` (reflected) — base sizing policy for an image supplied through
+  `src`, using the same `contain`/`width`/`actual` vocabulary as `<lr-image-viewer>`. `actual`
+  preserves the historical natural-size layout; the other modes resolve against the viewport and
+  update with its allocation, including when an image loads after the frame first renders.
 - `accessibleLabel: string | null` (attribute `aria-label`) — a declarative host label remains on
   the host while the focusable viewport receives the localized inspection-surface purpose name.
   A property-only value names the viewport and updates reactively without creating a host attribute. This avoids cloning one author label onto both the outer component and nested `role="group"`. An explicitly empty direct property remains empty; a present host attribute, including an empty one, leaves the viewport's localized purpose name intact.
@@ -29534,6 +29547,13 @@ trap, Escape/backdrop dismissal, scroll lock, and focus return.
 - `minZoom: number = 0.5`, `maxZoom: number = 4`, `zoomStep: number = 0.25` (attributes `min-zoom`/
   `max-zoom`/`zoom-step`) — pure pass-throughs to the embedded `<lr-pan-zoom>`, which does the
   normalizing.
+- `fit: LyraImageFit = 'actual'` (reflected) — opt-in base sizing policy for the current image,
+  reusing `<lr-image-viewer>`'s `contain`/`width`/`actual` vocabulary. The default preserves the
+  existing natural-size behavior. `contain` fits both landscape and tall images inside the stage;
+  `width` fills its inline size. CSS recalculates either policy when the stage is resized or a
+  delayed image source finishes loading, so navigation and opening do not require consumer timers.
+  Fit is the base zoom policy: an explicit user zoom remains until navigation or a reset, and
+  changing the theme does not mutate the lightbox's zoom property.
 - `accessibleLabel: string | null = null` (attribute `aria-label`) — the panel's accessible name,
   overriding the localized `lightboxLabel`.
 
@@ -29590,6 +29610,10 @@ photo content.
 - zoom/pan reset on navigation is imperative (`resetView()` from `updated()`), not a binding; the
   frame element is reused across navigations rather than recreated, so a keyboard user who tabbed
   into the viewport keeps focus.
+- fit sizing is CSS-driven inside the stable frame. The rendered DOM image is not copied or
+  measured by the lightbox, so stale load events cannot apply a previous image's size. The fit
+  policy covers the painted image only; the lightbox's DOM caption, toolbar, legend-like actions,
+  and tooltip content remain outside that image surface.
 - scope for v1: no per-image slotted content (data-driven via `images` only), no dot indicators, no
   visual open/close animation, no click-image-to-navigate, no touch-swipe. Lifecycle phases are
   still observable through the before/after events and methods above.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aceshooting/lyra-ui",
-  "version": "18.2.0",
+  "version": "18.3.0",
   "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",