@aceshooting/lyra-ui 18.2.0 → 18.4.0

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 6 parts, 5 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 6 parts, 14 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.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
@@ -93,8 +98,16 @@ closes caused by disablement, loading, or an unusable format list emit neither e
 attempt regardless of outcome — style with `::part(trigger-error)`), `menu`, `menu-item`,
 `format-label`, `format-description`
 
-**Themeable custom properties:** shared tokens only, including `--lr-popover-viewport-clamp`
-(default `92vw`) — the shared narrow-viewport ceiling the `menu`'s max-inline-size is `min()`ed
+**Themeable custom properties:** the trigger's paint is settable per state. At rest,
+`--lr-export-button-background`, `--lr-export-button-color` and `--lr-export-button-border`; on
+hover, `--lr-export-button-hover-background`, `--lr-export-button-hover-color` and
+`--lr-export-button-hover-border`; while pressed, `--lr-export-button-active-background`,
+`--lr-export-button-active-color` and `--lr-export-button-active-border`. Each layers over whatever
+the current `appearance` resolves to and leaves the other paints alone, so they are also the way to
+keep `appearance="outlined"` chrome while returning its label to neutral text — `outlined` paints
+the label `--lr-color-brand` and, unlike `lr-button`, this component has no `variant` of its own to
+opt out. Before 18.4.0 none of these existed and the only lever was `::part(trigger)`. Plus shared
+tokens, including `--lr-popover-viewport-clamp` (default `92vw`) — the shared narrow-viewport ceiling the `menu`'s max-inline-size is `min()`ed
 against, alongside its own `20rem` cap and the positioner's available space. See `lr-tour` for the
 shared-clamp note.
 

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
@@ -24865,8 +24874,16 @@ closes caused by disablement, loading, or an unusable format list emit neither e
 attempt regardless of outcome — style with `::part(trigger-error)`), `menu`, `menu-item`,
 `format-label`, `format-description`
 
-**Themeable custom properties:** shared tokens only, including `--lr-popover-viewport-clamp`
-(default `92vw`) — the shared narrow-viewport ceiling the `menu`'s max-inline-size is `min()`ed
+**Themeable custom properties:** the trigger's paint is settable per state. At rest,
+`--lr-export-button-background`, `--lr-export-button-color` and `--lr-export-button-border`; on
+hover, `--lr-export-button-hover-background`, `--lr-export-button-hover-color` and
+`--lr-export-button-hover-border`; while pressed, `--lr-export-button-active-background`,
+`--lr-export-button-active-color` and `--lr-export-button-active-border`. Each layers over whatever
+the current `appearance` resolves to and leaves the other paints alone, so they are also the way to
+keep `appearance="outlined"` chrome while returning its label to neutral text — `outlined` paints
+the label `--lr-color-brand` and, unlike `lr-button`, this component has no `variant` of its own to
+opt out. Before 18.4.0 none of these existed and the only lever was `::part(trigger)`. Plus shared
+tokens, including `--lr-popover-viewport-clamp` (default `92vw`) — the shared narrow-viewport ceiling the `menu`'s max-inline-size is `min()`ed
 against, alongside its own `20rem` cap and the positioner's available space. See `lr-tour` for the
 shared-clamp note.
 
@@ -28547,6 +28564,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 +29555,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 +29618,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.4.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",