@aceshooting/lyra-ui 6.1.0 → 7.0.0

package/dist/components/data/word-cloud/word-cloud.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"word-cloud.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/data/word-cloud/word-cloud.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAkFlB,CAAC"}
+{"version":3,"file":"word-cloud.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/data/word-cloud/word-cloud.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBA8FlB,CAAC"}

package/dist/components/data/word-cloud/word-cloud.styles.js

@@ -16,21 +16,6 @@ export const styles = css `
     --lr-word-cloud-color-7: var(--lr-color-chart-3);
     --lr-word-cloud-color-8: var(--lr-color-chart-4);
   }
-  @media (prefers-color-scheme: dark) {
-    :host {
-      /* Colors 1-4 alias the semantic tokens (--lr-color-brand/-success/-warning/-danger),
-         which already flip to their dark-mode fill in tokens.styles.ts -- redeclaring them
-         here would just repeat the same resolved value, not add a variant. Only the
-         chart-ramp colors (5-8) need an explicit dark swap: they draw from a fixed 4-color
-         segment of the categorical --lr-color-chart-* ramp, and the ramp's *next* segment
-         (5-8) is the one tuned for dark backgrounds, so the swap is a deliberate palette
-         change rather than a token-layer duplicate. */
-      --lr-word-cloud-color-5: var(--lr-color-chart-5);
-      --lr-word-cloud-color-6: var(--lr-color-chart-6);
-      --lr-word-cloud-color-7: var(--lr-color-chart-7);
-      --lr-word-cloud-color-8: var(--lr-color-chart-8);
-    }
-  }
   [part='base'] {
     display: flex;
     flex-direction: column;
@@ -68,6 +53,33 @@ export const styles = css `
     color: var(--lr-color-text-quiet);
     font-size: var(--lr-font-size-md-sm);
   }
+  [part='legend'] {
+    display: flex;
+    flex-wrap: wrap;
+    min-inline-size: 0;
+    max-inline-size: 100%;
+    gap: var(--lr-space-s);
+    align-items: center;
+    color: var(--lr-color-text-quiet);
+    font-size: var(--lr-font-size-sm);
+  }
+  [part='legend-item'] {
+    display: inline-flex;
+    align-items: center;
+    min-inline-size: 0;
+    max-inline-size: 100%;
+    gap: var(--lr-space-2xs);
+  }
+  [part='legend-swatch'] {
+    inline-size: var(--lr-size-0-75rem);
+    block-size: var(--lr-size-0-75rem);
+    border-radius: var(--lr-radius-xs);
+    flex: none;
+  }
+  [part='legend-label'] {
+    min-inline-size: 0;
+    overflow-wrap: anywhere;
+  }
   @media (prefers-reduced-motion: reduce) {
     [part='word'] {
       transition: none !important;

package/dist/components/data/word-cloud/word-cloud.styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"word-cloud.styles.js","sourceRoot":"","sources":["../../../../src/components/data/word-cloud/word-cloud.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFxB,CAAC"}
+{"version":3,"file":"word-cloud.styles.js","sourceRoot":"","sources":["../../../../src/components/data/word-cloud/word-cloud.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FxB,CAAC"}

package/dist/components/forms/button/button.class.d.ts

@@ -1,4 +1,4 @@
-import { type TemplateResult } from 'lit';
+import { type PropertyValues, type TemplateResult } from 'lit';
 import { LyraElement } from '../../../internal/lyra-element.js';
 export type ButtonVariant = 'neutral' | 'brand' | 'success' | 'warning' | 'danger';
 export type ButtonAppearance = 'accent' | 'filled' | 'outlined' | 'plain' | 'link' | 'quiet';
@@ -11,15 +11,31 @@ export type ButtonType = 'button' | 'submit' | 'reset';
  * native `<button type="submit">` does not participate in an ancestor light-DOM form's submission
  * on its own, since form-submitter semantics don't cross the shadow boundary.
  *
- * A host `aria-label` is forwarded to the internal button as a literal string (for an icon-only
- * button with no visible label); external `aria-labelledby`/`aria-describedby` idrefs are not
- * copied across the shadow boundary.
+ * When `href` is set to a safe link URL (`http:`/`https:`/`blob:`/`mailto:`/relative — see
+ * `safeLinkHref`, or `safeDownloadHref` which drops `mailto:` when `download` is set) the root
+ * renders as a real `<a part="base" href=…>` instead — for a link styled
+ * as a button (e.g. a CTA). Native navigation is then the anchor's own activation, so the
+ * submit/reset click handler and `type` (submit/reset) have no effect in that mode. When the
+ * button is disabled (its own `disabled` or an ancestor `<fieldset disabled>`) the anchor renders
+ * with `aria-disabled="true"` and **no `href`** — an href-less anchor is not focusable or
+ * navigable, so a disabled link button genuinely cannot be activated (unlike a bare
+ * `aria-disabled` on a still-navigable link). An unsafe/unparseable `href` falls back to the
+ * native `<button>`.
+ *
+ * `accessibleLabel` (attribute `aria-label`) is forwarded reactively to the internal button/anchor
+ * as a literal string (for an icon-only button with no visible label); external
+ * `aria-labelledby`/`aria-describedby` idrefs are not copied across the shadow boundary.
+ * Host `aria-haspopup` and `aria-expanded` values are likewise forwarded to the internal semantic
+ * control. When host `aria-controls` names elements in the host's own root, the controls
+ * relationship is resolved onto the internal control through the reflected element-reference API
+ * so it remains valid across this component's shadow boundary; browsers without that API retain
+ * the forwarded string attribute as a best-effort fallback.
  *
  * @customElement lr-button
  * @slot - Default slot: the button's label content.
  * @slot start - Leading icon/content, rendered before the label.
  * @slot end - Trailing icon/content, rendered after the label.
- * @csspart base - The internal native `<button>`.
+ * @csspart base - The internal native `<button>` (or an `<a>` when `href` resolves to a safe link).
  * @csspart label - The default-slot label wrapper.
  * @csspart start - The `start` slot wrapper.
  * @csspart end - The `end` slot wrapper.
@@ -31,7 +47,7 @@ export type ButtonType = 'button' | 'submit' | 'reset';
  * while hovering a non-disabled button.
  * @cssprop [--lr-button-active-scale=0.9875] - `transform: scale()` factor applied while a
  * non-disabled button is pressed.
- * @cssprop [--lr-button-spinner-duration=1s] - Rotation period of the `loading` spinner.
+ * @cssprop [--lr-button-spinner-duration=var(--lr-transition-ambient)] - Timing of the `loading` spinner.
  * @cssprop [--lr-button-accent=var(--lr-color-text)] - Text/glyph color for the chrome-less
  * appearances (`outlined`, `plain`, `link`). Swapped per `variant` to that variant's semantic color.
  * @cssprop [--lr-button-fill=var(--lr-color-surface)] - Background of `appearance="filled"`.
@@ -87,6 +103,9 @@ export type ButtonType = 'button' | 'submit' | 'reset';
  * Override it to retune without a `::part(base)` rule.
  * @cssprop [--lr-button-radius=var(--lr-radius)] - Corner radius of the internal button. Does not
  * vary by `size` tier. `appearance="link"` ignores it (it renders with zero radius).
+ * @cssprop --lr-button-shadow - Box shadow of the internal button. **Undeclared by default**, so
+ * `box-shadow` falls back to `none` — byte-identical to before this property existed. Set it (e.g.
+ * an elevated/floating action button) without a `::part(base)` rule.
  */
 export declare class LyraButton extends LyraElement {
     static styles: import("lit").CSSResultGroup[];
@@ -105,6 +124,13 @@ export declare class LyraButton extends LyraElement {
     /** Whether the button is disabled explicitly or by an ancestor fieldset. */
     get effectiveDisabled(): boolean;
     constructor();
+    /** Accessible name forwarded to the internal native button or anchor. Bound to the host's
+     *  `aria-label` content attribute so changing or removing that attribute after mount keeps the
+     *  actual focused control synchronized. */
+    accessibleLabel: string | null;
+    private triggerHasPopup;
+    private triggerExpanded;
+    private triggerControls;
     /** Tone vocabulary shared with `<lr-chip>`/`<lr-avatar>`'s own `tone` property, named
      *  `variant` here (not `tone`) to keep the component's semantic tone vocabulary consistent. */
     variant: ButtonVariant;
@@ -130,8 +156,36 @@ export declare class LyraButton extends LyraElement {
      *  clearing `disabled` — a consumer's own `disabled` state and a transient `loading` state are
      *  independent (mirrors `<lr-export-button>`'s own `loading`/`disabled` pair). */
     loading: boolean;
-    private buttonEl?;
-    /** Activates the internal native button, including submit/reset behavior. */
+    /** When set to a safe link URL, the button's root renders as a real `<a href=…>` instead of a
+     *  `<button>` — for a link styled as a button (e.g. a CTA). Unset (the default) renders a plain
+     *  `<button>`, byte-for-byte as before. Only `http:`/`https:`/`blob:`/`mailto:`/relative URLs are
+     *  honored (see `safeLinkHref`); an unsafe/unparseable value falls back to the native `<button>`.
+     *  Setting `download` narrows the allowlist to `safeDownloadHref`'s, which drops `mailto:` — a
+     *  mail handoff names no retrievable bytes, so it cannot be a download target.
+     *  `type` (submit/reset) has no effect while the anchor renders — an anchor has no submit/reset
+     *  concept, and native navigation is its own activation. While the button is disabled the anchor
+     *  renders with no `href` (see the class doc comment), so a disabled link button cannot navigate. */
+    href?: string;
+    /** Native anchor `target`, used only while `href` resolves to a link. Setting this to `'_blank'`
+     *  (or any other target) automatically derives `rel="noopener noreferrer"` on the rendered anchor
+     *  — matching `lr-card`'s/`lr-stat`'s identical pattern; `rel` is never independently settable, to
+     *  close the reverse-tabnabbing vector. Ignored in `<button>` mode. */
+    target?: string;
+    /** Native anchor `download` attribute, used only while `href` resolves to a link. Ignored in
+     *  `<button>` mode. */
+    download?: string;
+    /** Whether the `start`/`end` slots have assigned content. Drives `?hidden` on the adornment
+     *  wrappers so an unslotted wrapper collapses to `display: none` instead of contributing a dead
+     *  `--lr-button-gap` of inline space (a bare `<slot>` is an element child, so a `:empty` rule
+     *  could never match it). Seeded synchronously in `willUpdate` before the first paint, then kept
+     *  current by each slot's `slotchange` — mirrors `<lr-input>`'s identical pattern. */
+    private hasStartSlot;
+    private hasEndSlot;
+    private baseEl?;
+    /** Activates the internal base element. In `<button>` mode this also runs the component's
+     *  submit/reset behavior (via the button's own `@click`); in anchor mode it triggers native
+     *  navigation (the anchor has no `@click` handler of its own). Disabled and loading buttons
+     *  remain inert in both modes. */
     click(): void;
     focus(options?: FocusOptions): void;
     blur(): void;
@@ -143,6 +197,10 @@ export declare class LyraButton extends LyraElement {
      * mirrors `<lr-checkbox>`'s/`<lr-switch>`'s identical `_fieldsetDisabled` pattern.
      */
     formDisabledCallback(disabled: boolean): void;
+    protected willUpdate(changed: PropertyValues): void;
+    private onStartSlotChange;
+    private onEndSlotChange;
+    protected updated(changed: PropertyValues): void;
     render(): TemplateResult;
 }
 declare global {

package/dist/components/forms/button/button.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.class.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/button/button.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIhE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAC7F,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAgB,MAAM,iCAAgC;IAOtD,MAAM,CAAC,cAAc,UAAQ;IAE7B,OAAgB,UAAU;QACxB,QAAQ;YAAI,IAAI;YAAW,OAAO;YAAQ,UAAU;;MACpD;IAEF,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,SAAS,CAAS;IAE1B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,EAKzB;IAED,4EAA4E;IAC5E,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,cAiBC;IAED;mGAC+F;IAClE,OAAO,EAAE,aAAa,CAAa;IAChE;;;;;;;;;kCAS8B;IACD,UAAU,EAAE,gBAAgB,CAAY;IACrE;;6DAEyD;IAC5B,IAAI,EAAE,UAAU,CAAO;IACpD;0FACsF;IAC1E,IAAI,EAAE,UAAU,CAAY;IACxC;;sFAEkF;IACtC,OAAO,UAAS;IAE3C,OAAO,CAAC,QAAQ,CAAC,CAAoB;IAEtD,6EAA6E;IACpE,KAAK,IAAI,IAAI,CAErB;IAEQ,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAE3C;IAEQ,IAAI,IAAI,IAAI,CAEpB;IAED,OAAO,CAAC,OAAO,CAMb;IAEF;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAG5C;IAEQ,MAAM,IAAI,cAAc,CAiBhC;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,UAAU,CAAC;KACzB;CACF"}
+{"version":3,"file":"button.class.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/button/button.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAMhE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAC7F,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsGG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAgB,MAAM,iCAAgC;IAOtD,MAAM,CAAC,cAAc,UAAQ;IAE7B,OAAgB,UAAU;QACxB,QAAQ;YAAI,IAAI;YAAW,OAAO;YAAQ,UAAU;;MACpD;IAEF,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,SAAS,CAAS;IAE1B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,EAKzB;IAED,4EAA4E;IAC5E,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,cAiBC;IAED;;+CAE2C;IACJ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IACnC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAExF;mGAC+F;IAClE,OAAO,EAAE,aAAa,CAAa;IAChE;;;;;;;;;kCAS8B;IACD,UAAU,EAAE,gBAAgB,CAAY;IACrE;;6DAEyD;IAC5B,IAAI,EAAE,UAAU,CAAO;IACpD;0FACsF;IAC1E,IAAI,EAAE,UAAU,CAAY;IACxC;;sFAEkF;IACtC,OAAO,UAAS;IAE5D;;;;;;;;yGAQqG;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;IAC1B;;;2EAGuE;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAC5B;2BACuB;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;0FAIsF;IAC7E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAIZ,OAAO,CAAC,MAAM,CAAC,CAAwC;IAE/E;;;sCAGkC;IACzB,KAAK,IAAI,IAAI,CAGrB;IAEQ,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAE3C;IAEQ,IAAI,IAAI,IAAI,CAEpB;IAED,OAAO,CAAC,OAAO,CAMb;IAEF;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAG5C;IAED,UAAmB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAU3D;IAED,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,UAAmB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAGxD;IAEQ,MAAM,IAAI,cAAc,CAyDhC;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,UAAU,CAAC;KACzB;CACF"}

package/dist/components/forms/button/button.class.js

@@ -5,9 +5,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { html, nothing } from 'lit';
-import { property, query } from 'lit/decorators.js';
+import { property, query, state } from 'lit/decorators.js';
 import { LyraElement } from '../../../internal/lyra-element.js';
 import { spinnerIcon } from '../../../internal/icons.js';
+import { safeDownloadHref, safeLinkHref } from '../../../internal/safe-url.js';
+import { syncAriaControlsElements } from '../../../internal/aria-controls.js';
 import { styles } from './button.styles.js';
 /**
  * `<lr-button>` — a generic action-button primitive. Renders an internal native
@@ -16,15 +18,31 @@ import { styles } from './button.styles.js';
  * native `<button type="submit">` does not participate in an ancestor light-DOM form's submission
  * on its own, since form-submitter semantics don't cross the shadow boundary.
  *
- * A host `aria-label` is forwarded to the internal button as a literal string (for an icon-only
- * button with no visible label); external `aria-labelledby`/`aria-describedby` idrefs are not
- * copied across the shadow boundary.
+ * When `href` is set to a safe link URL (`http:`/`https:`/`blob:`/`mailto:`/relative — see
+ * `safeLinkHref`, or `safeDownloadHref` which drops `mailto:` when `download` is set) the root
+ * renders as a real `<a part="base" href=…>` instead — for a link styled
+ * as a button (e.g. a CTA). Native navigation is then the anchor's own activation, so the
+ * submit/reset click handler and `type` (submit/reset) have no effect in that mode. When the
+ * button is disabled (its own `disabled` or an ancestor `<fieldset disabled>`) the anchor renders
+ * with `aria-disabled="true"` and **no `href`** — an href-less anchor is not focusable or
+ * navigable, so a disabled link button genuinely cannot be activated (unlike a bare
+ * `aria-disabled` on a still-navigable link). An unsafe/unparseable `href` falls back to the
+ * native `<button>`.
+ *
+ * `accessibleLabel` (attribute `aria-label`) is forwarded reactively to the internal button/anchor
+ * as a literal string (for an icon-only button with no visible label); external
+ * `aria-labelledby`/`aria-describedby` idrefs are not copied across the shadow boundary.
+ * Host `aria-haspopup` and `aria-expanded` values are likewise forwarded to the internal semantic
+ * control. When host `aria-controls` names elements in the host's own root, the controls
+ * relationship is resolved onto the internal control through the reflected element-reference API
+ * so it remains valid across this component's shadow boundary; browsers without that API retain
+ * the forwarded string attribute as a best-effort fallback.
  *
  * @customElement lr-button
  * @slot - Default slot: the button's label content.
  * @slot start - Leading icon/content, rendered before the label.
  * @slot end - Trailing icon/content, rendered after the label.
- * @csspart base - The internal native `<button>`.
+ * @csspart base - The internal native `<button>` (or an `<a>` when `href` resolves to a safe link).
  * @csspart label - The default-slot label wrapper.
  * @csspart start - The `start` slot wrapper.
  * @csspart end - The `end` slot wrapper.
@@ -36,7 +54,7 @@ import { styles } from './button.styles.js';
  * while hovering a non-disabled button.
  * @cssprop [--lr-button-active-scale=0.9875] - `transform: scale()` factor applied while a
  * non-disabled button is pressed.
- * @cssprop [--lr-button-spinner-duration=1s] - Rotation period of the `loading` spinner.
+ * @cssprop [--lr-button-spinner-duration=var(--lr-transition-ambient)] - Timing of the `loading` spinner.
  * @cssprop [--lr-button-accent=var(--lr-color-text)] - Text/glyph color for the chrome-less
  * appearances (`outlined`, `plain`, `link`). Swapped per `variant` to that variant's semantic color.
  * @cssprop [--lr-button-fill=var(--lr-color-surface)] - Background of `appearance="filled"`.
@@ -92,6 +110,9 @@ import { styles } from './button.styles.js';
  * Override it to retune without a `::part(base)` rule.
  * @cssprop [--lr-button-radius=var(--lr-radius)] - Corner radius of the internal button. Does not
  * vary by `size` tier. `appearance="link"` ignores it (it renders with zero radius).
+ * @cssprop --lr-button-shadow - Box shadow of the internal button. **Undeclared by default**, so
+ * `box-shadow` falls back to `none` — byte-identical to before this property existed. Set it (e.g.
+ * an elevated/floating action button) without a `::part(base)` rule.
  */
 export class LyraButton extends LyraElement {
     static { this.styles = [LyraElement.styles, styles]; }
@@ -122,6 +143,13 @@ export class LyraButton extends LyraElement {
         super();
         this._fieldsetDisabled = false;
         this._disabled = false;
+        /** Accessible name forwarded to the internal native button or anchor. Bound to the host's
+         *  `aria-label` content attribute so changing or removing that attribute after mount keeps the
+         *  actual focused control synchronized. */
+        this.accessibleLabel = null;
+        this.triggerHasPopup = null;
+        this.triggerExpanded = null;
+        this.triggerControls = null;
         /** Tone vocabulary shared with `<lr-chip>`/`<lr-avatar>`'s own `tone` property, named
          *  `variant` here (not `tone`) to keep the component's semantic tone vocabulary consistent. */
         this.variant = 'neutral';
@@ -147,6 +175,13 @@ export class LyraButton extends LyraElement {
          *  clearing `disabled` — a consumer's own `disabled` state and a transient `loading` state are
          *  independent (mirrors `<lr-export-button>`'s own `loading`/`disabled` pair). */
         this.loading = false;
+        /** Whether the `start`/`end` slots have assigned content. Drives `?hidden` on the adornment
+         *  wrappers so an unslotted wrapper collapses to `display: none` instead of contributing a dead
+         *  `--lr-button-gap` of inline space (a bare `<slot>` is an element child, so a `:empty` rule
+         *  could never match it). Seeded synchronously in `willUpdate` before the first paint, then kept
+         *  current by each slot's `slotchange` — mirrors `<lr-input>`'s identical pattern. */
+        this.hasStartSlot = false;
+        this.hasEndSlot = false;
         this.onClick = () => {
             if (this.type === 'submit') {
                 this.closest('form')?.requestSubmit();
@@ -155,6 +190,12 @@ export class LyraButton extends LyraElement {
                 this.closest('form')?.reset();
             }
         };
+        this.onStartSlotChange = (e) => {
+            this.hasStartSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onEndSlotChange = (e) => {
+            this.hasEndSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
         // `attachInternals()` is browser-only; a downstream consumer's Vitest + happy-dom (or similar)
         // test suite has no implementation of it at all, so calling it unconditionally would throw
         // merely from constructing/importing this component, before any assertion runs. The return
@@ -172,15 +213,20 @@ export class LyraButton extends LyraElement {
             }
         }
     }
-    /** Activates the internal native button, including submit/reset behavior. */
+    /** Activates the internal base element. In `<button>` mode this also runs the component's
+     *  submit/reset behavior (via the button's own `@click`); in anchor mode it triggers native
+     *  navigation (the anchor has no `@click` handler of its own). Disabled and loading buttons
+     *  remain inert in both modes. */
     click() {
-        this.buttonEl?.click();
+        if (this.effectiveDisabled || this.loading)
+            return;
+        this.baseEl?.click();
     }
     focus(options) {
-        this.buttonEl?.focus(options);
+        this.baseEl?.focus(options);
     }
     blur() {
-        this.buttonEl?.blur();
+        this.baseEl?.blur();
     }
     /**
      * Called by the browser when an ancestor `<fieldset disabled>` toggles. Tracked separately
@@ -192,25 +238,90 @@ export class LyraButton extends LyraElement {
         this._fieldsetDisabled = disabled;
         this.requestUpdate();
     }
+    willUpdate(changed) {
+        super.willUpdate(changed);
+        // Seed the wrapper-visibility flags from light-DOM children before the first render, so the
+        // adornment wrappers start collapsed/expanded correctly rather than flashing full-width for a
+        // frame until the first `slotchange` fires. Refreshed thereafter by `onStartSlotChange`/
+        // `onEndSlotChange`.
+        if (!this.hasUpdated) {
+            this.hasStartSlot = Array.from(this.children).some((element) => element.getAttribute('slot') === 'start');
+            this.hasEndSlot = Array.from(this.children).some((element) => element.getAttribute('slot') === 'end');
+        }
+    }
+    updated(changed) {
+        super.updated(changed);
+        syncAriaControlsElements(this, this.baseEl, this.triggerControls);
+    }
     render() {
-        const ariaLabel = this.getAttribute('aria-label');
+        // Shared inner content, rendered identically in both roots so the extracted variable produces
+        // byte-identical DOM to the previous inline template in `<button>` mode.
+        const content = html `
+      <span part="start" ?hidden=${!this.hasStartSlot}>
+        <slot name="start" @slotchange=${this.onStartSlotChange}></slot>
+      </span>
+      <span part="label"><slot></slot></span>
+      <span part="end" ?hidden=${!this.hasEndSlot}>
+        <slot name="end" @slotchange=${this.onEndSlotChange}></slot>
+      </span>
+      ${this.loading ? html `<span part="spinner" aria-hidden="true">${spinnerIcon()}</span>` : ''}
+    `;
+        // `download` turns the anchor from a navigation sink into a resource sink, and the two carry
+        // different allowlists -- `mailto:` is a legitimate destination but names no retrievable bytes.
+        // The condition mirrors the `download=${this.download || nothing}` binding below exactly, so
+        // the href is validated against whichever sink the rendered anchor actually is.
+        const href = this.download ? safeDownloadHref(this.href) : safeLinkHref(this.href);
+        if (href) {
+            const disabled = this.effectiveDisabled || this.loading;
+            // Per decision D8: a disabled link button omits `href` entirely. An anchor with no `href` is
+            // not focusable or activatable, so the button genuinely cannot navigate -- unlike a bare
+            // `aria-disabled` on a still-navigable `<a href>`. `@click`/submit-reset are deliberately
+            // absent: native navigation is the anchor's own activation (mirrors `lr-card`).
+            return html `<a
+        part="base"
+        href=${disabled ? nothing : href}
+        target=${this.target || nothing}
+        rel=${this.target ? 'noopener noreferrer' : nothing}
+        download=${this.download || nothing}
+        aria-label=${this.accessibleLabel || nothing}
+        aria-haspopup=${this.triggerHasPopup ?? nothing}
+        aria-expanded=${this.triggerExpanded ?? nothing}
+        aria-controls=${this.triggerControls || nothing}
+        aria-disabled=${disabled ? 'true' : nothing}
+        aria-busy=${this.loading ? 'true' : 'false'}
+        tabindex=${disabled ? '-1' : nothing}
+        >${content}</a
+      >`;
+        }
         return html `
       <button
         part="base"
         type="button"
-        aria-label=${ariaLabel || nothing}
+        aria-label=${this.accessibleLabel || nothing}
+        aria-haspopup=${this.triggerHasPopup ?? nothing}
+        aria-expanded=${this.triggerExpanded ?? nothing}
+        aria-controls=${this.triggerControls || nothing}
         aria-busy=${this.loading ? 'true' : 'false'}
         ?disabled=${this.effectiveDisabled || this.loading}
         @click=${this.onClick}
       >
-        <span part="start"><slot name="start"></slot></span>
-        <span part="label"><slot></slot></span>
-        <span part="end"><slot name="end"></slot></span>
-        ${this.loading ? html `<span part="spinner" aria-hidden="true">${spinnerIcon()}</span>` : ''}
+        ${content}
       </button>
     `;
     }
 }
+__decorate([
+    property({ attribute: 'aria-label' })
+], LyraButton.prototype, "accessibleLabel", void 0);
+__decorate([
+    property({ attribute: 'aria-haspopup' })
+], LyraButton.prototype, "triggerHasPopup", void 0);
+__decorate([
+    property({ attribute: 'aria-expanded' })
+], LyraButton.prototype, "triggerExpanded", void 0);
+__decorate([
+    property({ attribute: 'aria-controls' })
+], LyraButton.prototype, "triggerControls", void 0);
 __decorate([
     property({ reflect: true })
 ], LyraButton.prototype, "variant", void 0);
@@ -227,6 +338,21 @@ __decorate([
     property({ type: Boolean, reflect: true })
 ], LyraButton.prototype, "loading", void 0);
 __decorate([
-    query('button')
-], LyraButton.prototype, "buttonEl", void 0);
+    property()
+], LyraButton.prototype, "href", void 0);
+__decorate([
+    property()
+], LyraButton.prototype, "target", void 0);
+__decorate([
+    property()
+], LyraButton.prototype, "download", void 0);
+__decorate([
+    state()
+], LyraButton.prototype, "hasStartSlot", void 0);
+__decorate([
+    state()
+], LyraButton.prototype, "hasEndSlot", void 0);
+__decorate([
+    query('[part="base"]')
+], LyraButton.prototype, "baseEl", void 0);
 //# sourceMappingURL=button.class.js.map

package/dist/components/forms/button/button.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"button.class.js","sourceRoot":"","sources":["../../../../src/components/forms/button/button.class.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"button.class.js","sourceRoot":"","sources":["../../../../src/components/forms/button/button.class.ts"],"names":[],"mappings":"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"}

package/dist/components/forms/button/button.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/button/button.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAiPlB,CAAC"}
+{"version":3,"file":"button.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/button/button.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAyPlB,CAAC"}

package/dist/components/forms/button/button.styles.js

@@ -105,6 +105,9 @@ export const styles = css `
     /* After the "font" shorthand, which would otherwise reset font-size back to the inherited one. */
     font-size: var(--lr-button-font-size);
     cursor: pointer;
+    /* Undeclared by default (byte-identical to today's absent box-shadow); set it to add a
+       drop shadow (e.g. an elevated/floating action button) without a ::part(base) rule. */
+    box-shadow: var(--lr-button-shadow, none);
   }
   :host([appearance='filled']) [part='base'] {
     background: var(--lr-button-fill);
@@ -155,15 +158,20 @@ export const styles = css `
     outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);
     outline-offset: var(--lr-focus-ring-offset);
   }
-  [part='start']:empty,
-  [part='end']:empty {
-    display: none;
-  }
   [part='start'],
   [part='end'] {
     display: inline-flex;
     align-items: center;
   }
+  /* When the matching slot has no assigned content, button.class.ts stamps the hidden attribute
+     on the wrapper (a bare slot is an element child, so the old :empty rule could never match).
+     This higher-specificity selector wins over the display: inline-flex above so the empty
+     wrapper collapses and stops contributing a dead --lr-button-gap of inline space -- mirrors
+     input.styles.ts's identical [part='start'][hidden]/[part='end'][hidden] rule. */
+  [part='start'][hidden],
+  [part='end'][hidden] {
+    display: none;
+  }
   /* Per-tier geometry: cssprop re-assignment only. The "m" tier lives on :host above ("size"
      reflects and defaults to 'm', so :host always matches it). */
   :host([size='2xs']) {
@@ -222,7 +230,7 @@ export const styles = css `
     inset: 0;
     align-items: center;
     justify-content: center;
-    animation: lr-button-spin var(--lr-button-spinner-duration, 1s) linear infinite;
+    animation: lr-button-spin var(--lr-button-spinner-duration, var(--lr-transition-ambient)) infinite;
   }
   :host([loading]) [part='start'],
   :host([loading]) [part='label'],

package/dist/components/forms/button/button.styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"button.styles.js","sourceRoot":"","sources":["../../../../src/components/forms/button/button.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiPxB,CAAC"}
+{"version":3,"file":"button.styles.js","sourceRoot":"","sources":["../../../../src/components/forms/button/button.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyPxB,CAAC"}

package/dist/components/forms/checkbox/checkbox.class.d.ts

@@ -33,6 +33,9 @@ export interface LyraCheckboxEventMap {
  * checkbox, the same as clicking a native checkbox's associated `<label>`.
  * If left empty, set `aria-label` on the host so the control still has an
  * accessible name.
+ * A host `aria-describedby` attribute is forwarded to the internal
+ * `role="checkbox"` so externally-owned descriptions can be associated with
+ * this individual control.
  * @event input - The user toggled the checkbox; bubbling and composed like a native form event.
  * @event change - Fired immediately after `input` for the same user toggle.
  * @event lr-change - Compatibility alias fired after `input` and `change` (click or Space).

package/dist/components/forms/checkbox/checkbox.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkbox.class.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/checkbox/checkbox.class.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkbox.class.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/checkbox/checkbox.class.ts"],"names":[],"mappings":"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"}

package/dist/components/forms/checkbox/checkbox.class.js

@@ -111,6 +111,9 @@ function indeterminateGlyph() {
  * checkbox, the same as clicking a native checkbox's associated `<label>`.
  * If left empty, set `aria-label` on the host so the control still has an
  * accessible name.
+ * A host `aria-describedby` attribute is forwarded to the internal
+ * `role="checkbox"` so externally-owned descriptions can be associated with
+ * this individual control.
  * @event input - The user toggled the checkbox; bubbling and composed like a native form event.
  * @event change - Fired immediately after `input` for the same user toggle.
  * @event lr-change - Compatibility alias fired after `input` and `change` (click or Space).
@@ -311,7 +314,11 @@ export class LyraCheckbox extends LyraElement {
         }
         this.updateValidity();
         this.labelObserver = new MutationObserver(() => this.recomputeHasLabelSlot());
-        this.labelObserver.observe(this, { childList: true, subtree: true, characterData: true });
+        this.labelObserver.observe(this, {
+            childList: true,
+            subtree: true,
+            characterData: true,
+        });
     }
     disconnectedCallback() {
         super.disconnectedCallback();
@@ -429,6 +436,7 @@ export class LyraCheckbox extends LyraElement {
         aria-invalid=${this.touched && !this.internals.validity.valid ? 'true' : 'false'}
         aria-disabled=${this.effectiveDisabled ? 'true' : 'false'}
         aria-label=${this.getAttribute('aria-label') || nothing}
+        aria-describedby=${this.getAttribute('aria-describedby') || nothing}
         @click=${this.onClick}
         @keydown=${this.onKeyDown}
         @focus=${this.onFocus}