@aceshooting/lyra-ui 2.0.0 → 2.1.0

package/dist/components/date-picker/date-picker.js

@@ -4,13 +4,26 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { html, nothing } from 'lit';
+import { html, nothing, } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { LyraElement } from '../../internal/lyra-element.js';
 import { defineElement } from '../../internal/prefix.js';
 import { chevronIcon } from '../../internal/icons.js';
+import { nextId } from '../../internal/a11y.js';
 import { styles } from './date-picker.styles.js';
-import { monthMatrix, weekdayLabels, monthTitle, formatISO, parseISO, isSameDay, addMonths, clampDate, resolveFirstDayOfWeek, } from './calendar-core.js';
+import { monthMatrix, weekdayLabels, monthTitle, formatISO, parseISO, isSameDay, addMonths, addMonthsClampingDay, clampDate, dateTimeFormat, normalizeCalendarMode, normalizeCalendarMonths, normalizeWeekdayFormat, resolveFirstDayOfWeek, } from './calendar-core.js';
+const modeConverter = {
+    fromAttribute: normalizeCalendarMode,
+    toAttribute: normalizeCalendarMode,
+};
+const monthsConverter = {
+    fromAttribute: normalizeCalendarMonths,
+    toAttribute: normalizeCalendarMonths,
+};
+const weekdayFormatConverter = {
+    fromAttribute: normalizeWeekdayFormat,
+    toAttribute: normalizeWeekdayFormat,
+};
 /**
  * `<lyra-date-picker>` — an inline month-grid calendar for picking a single date
  * or a date range. Mirrors the core `<wa-date-picker>` API under `lyra-`.
@@ -20,8 +33,24 @@ import { monthMatrix, weekdayLabels, monthTitle, formatISO, parseISO, isSameDay,
  * @customElement lyra-date-picker
  * @event change - The user committed a value.
  * @event input - The value changed during interaction (range: after the first click).
- * @csspart base, month, header, title, previous, next, weekdays, weekday, grid, week
- * @csspart day, day-today, day-outside, day-selected, day-range-start, day-range-end, day-range-inner, day-placeholder
+ * @csspart base - The date-picker wrapper.
+ * @csspart month - A visible month wrapper.
+ * @csspart header - The month header.
+ * @csspart title - The month title.
+ * @csspart previous - The previous-month button.
+ * @csspart next - The next-month button.
+ * @csspart weekdays - The weekday header row.
+ * @csspart weekday - A weekday label.
+ * @csspart grid - A month date grid.
+ * @csspart week - A calendar week row.
+ * @csspart day - A calendar day button.
+ * @csspart day-today - A day representing today.
+ * @csspart day-outside - A day outside the active month.
+ * @csspart day-selected - A selected day.
+ * @csspart day-range-start - The start of a selected range.
+ * @csspart day-range-end - The end of a selected range.
+ * @csspart day-range-inner - An interior day in a selected range.
+ * @csspart day-placeholder - A non-day grid placeholder.
  */
 export class LyraDatePicker extends LyraElement {
     constructor() {
@@ -40,9 +69,17 @@ export class LyraDatePicker extends LyraElement {
         this.disablePast = false;
         this.disableFuture = false;
         this.withOutsideDays = false;
+        /** Accessible label for the previous-month button. Override for a non-English `locale`. */
+        this.previousLabel = 'Previous month';
+        /** Accessible label for the next-month button. Override for a non-English `locale`. */
+        this.nextLabel = 'Next month';
         this.viewDate = new Date(new Date().getFullYear(), new Date().getMonth(), 1);
         this.focusedDate = null;
         this.focusPending = false;
+        // Stable per-instance ids for each visible month's title, referenced by
+        // that month's grid via aria-labelledby -- `months` only ever renders 1 or
+        // 2 months, so two ids always suffice regardless of which is in use.
+        this.titleIds = [nextId('date-picker-title'), nextId('date-picker-title')];
         // Set right before `commit()` assigns `value`, so `willUpdate` can tell its
         // own write apart from an external assignment. Internal commits already
         // know the right date is on-screen (it's the cell the user just clicked, or
@@ -88,10 +125,10 @@ export class LyraDatePicker extends LyraElement {
                     next = firstEnabledFrom(step(current, 7), 1);
                     break;
                 case 'PageUp':
-                    next = firstEnabledFrom(new Date(current.getFullYear(), current.getMonth() - 1, current.getDate()), 1);
+                    next = firstEnabledFrom(addMonthsClampingDay(current, -1), 1);
                     break;
                 case 'PageDown':
-                    next = firstEnabledFrom(new Date(current.getFullYear(), current.getMonth() + 1, current.getDate()), 1);
+                    next = firstEnabledFrom(addMonthsClampingDay(current, 1), 1);
                     break;
                 case 'Home':
                     next = firstEnabledFrom(new Date(current.getFullYear(), current.getMonth(), 1), 1);
@@ -116,13 +153,22 @@ export class LyraDatePicker extends LyraElement {
         };
     }
     static { this.styles = [LyraElement.styles, styles]; }
+    get effectiveMode() {
+        return normalizeCalendarMode(this.mode);
+    }
+    get visibleMonths() {
+        return normalizeCalendarMonths(this.months);
+    }
+    get effectiveWeekdayFormat() {
+        return normalizeWeekdayFormat(this.weekdayFormat);
+    }
     get selection() {
         const parts = this.value.split('/');
         return { from: parseISO(parts[0] ?? ''), to: parseISO(parts[1] ?? '') };
     }
     /** Read-only Date view of a single-mode value. */
     get valueAsDate() {
-        return this.mode === 'single' ? this.selection.from : null;
+        return this.effectiveMode === 'single' ? this.selection.from : null;
     }
     willUpdate(changed) {
         if (changed.has('value')) {
@@ -159,7 +205,7 @@ export class LyraDatePicker extends LyraElement {
      *  min/max window). */
     firstEnabledDate(min, max, today) {
         let d = new Date(this.viewDate.getFullYear(), this.viewDate.getMonth(), 1);
-        const lastVisibleMonth = addMonths(d, this.months - 1);
+        const lastVisibleMonth = addMonths(d, this.visibleMonths - 1);
         const boundEnd = new Date(lastVisibleMonth.getFullYear(), lastVisibleMonth.getMonth() + 1, 0);
         for (let i = 0; i < 732 && d <= boundEnd; i++) {
             if (!this.isDisabled(d, min, max, today))
@@ -169,7 +215,7 @@ export class LyraDatePicker extends LyraElement {
         return null;
     }
     commit(from, to, fire) {
-        const next = this.mode === 'range'
+        const next = this.effectiveMode === 'range'
             ? from && to
                 ? `${formatISO(from)}/${formatISO(to)}`
                 : from
@@ -196,7 +242,7 @@ export class LyraDatePicker extends LyraElement {
         if (this.isDisabled(date, min, max, today))
             return;
         this.focusedDate = date;
-        if (this.mode === 'range') {
+        if (this.effectiveMode === 'range') {
             const { from, to } = this.selection;
             if (!from || (from && to)) {
                 this.commit(date, null, false);
@@ -224,9 +270,9 @@ export class LyraDatePicker extends LyraElement {
     /** Navigate the view to a date and focus it, clamped to `min`/`max`. */
     goToDate(date) {
         const d = typeof date === 'string' ? parseISO(date) : date;
-        if (!d)
+        if (!d || !Number.isFinite(d.getTime()))
             return;
-        const clamped = clampDate(d, parseISO(this.min), parseISO(this.max));
+        const clamped = clampDate(new Date(d.getTime()), parseISO(this.min), parseISO(this.max));
         this.viewDate = new Date(clamped.getFullYear(), clamped.getMonth(), 1);
         this.focusedDate = clamped;
         this.focusPending = true;
@@ -243,11 +289,11 @@ export class LyraDatePicker extends LyraElement {
     viewDateForFocus(next) {
         const firstMonth = new Date(this.viewDate.getFullYear(), this.viewDate.getMonth(), 1);
         const nextMonth = new Date(next.getFullYear(), next.getMonth(), 1);
-        const lastMonth = addMonths(firstMonth, this.months - 1);
+        const lastMonth = addMonths(firstMonth, this.visibleMonths - 1);
         if (nextMonth < firstMonth)
             return nextMonth;
         if (nextMonth > lastMonth)
-            return addMonths(nextMonth, -(this.months - 1));
+            return addMonths(nextMonth, -(this.visibleMonths - 1));
         return firstMonth;
     }
     updated() {
@@ -258,7 +304,7 @@ export class LyraDatePicker extends LyraElement {
             cell?.focus();
         }
     }
-    renderDay(date, shownMonth, selection, min, max, today, rowHasVisibleDay, fallbackFocusDate) {
+    renderDay(date, shownMonth, selection, min, max, today, rowHasVisibleDay, fallbackFocusDate, dayLabelFmt) {
         const outside = date.getMonth() !== shownMonth;
         // Outside-month days are empty placeholders by default (matches WA), keeping the
         // 6-row grid aligned without low-contrast faded numbers.
@@ -279,8 +325,8 @@ export class LyraDatePicker extends LyraElement {
         const isToday = isSameDay(date, today);
         const isStart = from && isSameDay(date, from);
         const isEnd = to && isSameDay(date, to);
-        const selected = this.mode === 'single' ? isStart : isStart || isEnd;
-        const inRange = this.mode === 'range' && from && to && date > from && date < to;
+        const selected = this.effectiveMode === 'single' ? isStart : isStart || isEnd;
+        const inRange = this.effectiveMode === 'range' && from && to && date > from && date < to;
         // Falls back to the first *enabled* day across the visible month(s) (see
         // firstEnabledDate()) when there's neither a focusedDate nor a selection,
         // so the grid always has exactly one tabbable cell -- otherwise every
@@ -301,7 +347,7 @@ export class LyraDatePicker extends LyraElement {
             parts.push('day-today');
         if (selected)
             parts.push('day-selected');
-        if (isStart && this.mode === 'range')
+        if (isStart && this.effectiveMode === 'range')
             parts.push('day-range-start');
         if (isEnd)
             parts.push('day-range-end');
@@ -312,12 +358,7 @@ export class LyraDatePicker extends LyraElement {
       role="gridcell"
       data-date=${formatISO(date)}
       aria-selected=${selected ? 'true' : 'false'}
-      aria-label=${date.toLocaleDateString(this.locale || undefined, {
-            weekday: 'long',
-            year: 'numeric',
-            month: 'long',
-            day: 'numeric',
-        })}
+      aria-label=${dayLabelFmt.format(date)}
       tabindex=${focused ? '0' : '-1'}
       ?disabled=${disabled}
       @click=${() => this.selectDate(date)}
@@ -325,32 +366,33 @@ export class LyraDatePicker extends LyraElement {
       ${date.getDate()}
     </button>`;
     }
-    renderMonth(offset, selection, min, max, today, fdow, labels, fallbackFocusDate) {
+    renderMonth(offset, selection, min, max, today, fdow, labels, fallbackFocusDate, dayLabelFmt) {
         const base = addMonths(this.viewDate, offset);
         const year = base.getFullYear();
         const month = base.getMonth();
         const matrix = monthMatrix(year, month, fdow);
         const isFirst = offset === 0;
-        const isLast = offset === this.months - 1;
+        const isLast = offset === this.visibleMonths - 1;
+        const titleId = this.titleIds[offset];
         return html `<div part="month">
       <div part="header">
         ${isFirst
             ? html `<button
               part="previous"
               type="button"
-              aria-label="Previous month"
+              aria-label=${this.previousLabel}
               ?disabled=${this.disabled || this.readonly}
               @click=${() => this.nav(-1)}
             >
               ${chevronIcon()}
             </button>`
             : html `<span></span>`}
-        <div part="title">${monthTitle(year, month, this.locale)}</div>
+        <div part="title" id=${titleId}>${monthTitle(year, month, this.locale)}</div>
         ${isLast
             ? html `<button
               part="next"
               type="button"
-              aria-label="Next month"
+              aria-label=${this.nextLabel}
               ?disabled=${this.disabled || this.readonly}
               @click=${() => this.nav(1)}
             >
@@ -359,10 +401,10 @@ export class LyraDatePicker extends LyraElement {
             : html `<span></span>`}
       </div>
       <div part="weekdays">${labels.map((l) => html `<span part="weekday">${l}</span>`)}</div>
-      <div part="grid" role="grid" @keydown=${this.onGridKey}>
+      <div part="grid" role="grid" aria-labelledby=${titleId} @keydown=${this.onGridKey}>
         ${matrix.map((week) => {
             const rowHasVisibleDay = week.some((d) => d.getMonth() === month);
-            return html `<div part="week" role="row">${week.map((d) => this.renderDay(d, month, selection, min, max, today, rowHasVisibleDay, fallbackFocusDate))}</div>`;
+            return html `<div part="week" role="row">${week.map((d) => this.renderDay(d, month, selection, min, max, today, rowHasVisibleDay, fallbackFocusDate, dayLabelFmt))}</div>`;
         })}
       </div>
     </div>`;
@@ -374,14 +416,24 @@ export class LyraDatePicker extends LyraElement {
         const today = new Date();
         today.setHours(0, 0, 0, 0);
         const fdow = this.fdow;
-        const labels = weekdayLabels(fdow, this.weekdayFormat, this.locale);
+        const labels = weekdayLabels(fdow, this.effectiveWeekdayFormat, this.locale);
+        // Hoisted once per render and reused across every day cell, rather than
+        // each cell constructing its own Intl.DateTimeFormat via
+        // toLocaleDateString() -- mirrors how the weekday-header and month-title
+        // labels already share a single formatter instead of one per cell.
+        const dayLabelFmt = dateTimeFormat(this.locale, {
+            weekday: 'long',
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric',
+        });
         // Only bother scanning for a fallback focus day when it's actually
         // needed: there's no point walking the visible days if a focusedDate or
         // an existing selection already determines the sole tabbable cell.
         const fallbackFocusDate = this.focusedDate || selection.from ? null : this.firstEnabledDate(min, max, today);
         const monthEls = [];
-        for (let i = 0; i < this.months; i++) {
-            monthEls.push(this.renderMonth(i, selection, min, max, today, fdow, labels, fallbackFocusDate));
+        for (let i = 0; i < this.visibleMonths; i++) {
+            monthEls.push(this.renderMonth(i, selection, min, max, today, fdow, labels, fallbackFocusDate, dayLabelFmt));
         }
         return html `<div part="base">${monthEls}</div>`;
     }
@@ -390,7 +442,7 @@ __decorate([
     property()
 ], LyraDatePicker.prototype, "value", void 0);
 __decorate([
-    property()
+    property({ converter: modeConverter })
 ], LyraDatePicker.prototype, "mode", void 0);
 __decorate([
     property()
@@ -405,7 +457,7 @@ __decorate([
     property({ type: Boolean, reflect: true })
 ], LyraDatePicker.prototype, "readonly", void 0);
 __decorate([
-    property({ type: Number })
+    property({ converter: monthsConverter })
 ], LyraDatePicker.prototype, "months", void 0);
 __decorate([
     property()
@@ -414,7 +466,7 @@ __decorate([
     property({ attribute: 'first-day-of-week' })
 ], LyraDatePicker.prototype, "firstDayOfWeek", void 0);
 __decorate([
-    property({ attribute: 'weekday-format' })
+    property({ attribute: 'weekday-format', converter: weekdayFormatConverter })
 ], LyraDatePicker.prototype, "weekdayFormat", void 0);
 __decorate([
     property({ type: Boolean, attribute: 'disable-past' })
@@ -425,6 +477,12 @@ __decorate([
 __decorate([
     property({ type: Boolean, attribute: 'with-outside-days' })
 ], LyraDatePicker.prototype, "withOutsideDays", void 0);
+__decorate([
+    property({ attribute: 'previous-label' })
+], LyraDatePicker.prototype, "previousLabel", void 0);
+__decorate([
+    property({ attribute: 'next-label' })
+], LyraDatePicker.prototype, "nextLabel", void 0);
 __decorate([
     state()
 ], LyraDatePicker.prototype, "viewDate", void 0);

package/dist/components/dialog/confirm.js

@@ -2,17 +2,14 @@ import './dialog.js';
 // Plain inline-styled <button>s, not a shared lyra-button component -- none
 // exists in this library yet. Every value below is still a --lyra-* token
 // reference, never a raw literal, same requirement as a component's own
-// styles.ts. --lyra-color-on-brand is documented (tokens.styles.ts) as the
-// text color for *brand*-fill content specifically, but it's white in both
-// light and dark themes and reads fine over the danger fill too, so the
-// confirm button reuses it rather than introducing a redundant --lyra-color-
-// on-danger token for one call site.
+// styles.ts. Each filled tone uses its matching on-color token so standalone
+// light/dark fallbacks and a consumer's Web Awesome theme stay paired.
 const BUTTON_BASE_STYLE = 'font: inherit; font-size: 0.875rem; padding: var(--lyra-space-xs) var(--lyra-space-m); ' +
     'border-radius: var(--lyra-radius); cursor: pointer; border: 1px solid var(--lyra-color-border);';
 const CANCEL_STYLE = 'background: var(--lyra-color-surface); color: var(--lyra-color-text);';
 const CONFIRM_TONE_STYLE = {
     neutral: 'background: var(--lyra-color-brand); color: var(--lyra-color-on-brand); border-color: var(--lyra-color-brand);',
-    danger: 'background: var(--lyra-color-danger); color: var(--lyra-color-on-brand); border-color: var(--lyra-color-danger);',
+    danger: 'background: var(--lyra-color-danger); color: var(--lyra-color-on-danger); border-color: var(--lyra-color-danger);',
 };
 function createButton(label, style, onClick) {
     const button = document.createElement('button');

package/dist/components/dialog/dialog.d.ts

@@ -3,45 +3,77 @@ import { LyraElement } from '../../internal/lyra-element.js';
 /**
  * Reason a dialog was dismissed, forwarded as the `lyra-dialog-close` event
  * detail. `'escape'` and `'backdrop'` are emitted by the dialog's own built-in
- * dismiss triggers; any other string is whatever a caller passes to
- * `close()` (e.g. a consumer's own footer close button, or confirm.ts's
- * `'confirm'`/`'cancel'`).
+ * dismiss triggers; `'close-button'` by the built-in header close button
+ * (rendered when `closable` is set); `'unmount'` is emitted when the dialog is
+ * removed from the DOM while still open by something other than its own
+ * `close()` (e.g. a consumer's own cleanup code, or a parent re-render that
+ * drops it); any other string is whatever a caller passes to `close()` (e.g. a
+ * consumer's own footer close button, or confirm.ts's `'confirm'`/`'cancel'`).
  */
-export type DialogCloseReason = 'escape' | 'backdrop' | 'api' | string;
+export type DialogCloseReason = 'escape' | 'backdrop' | 'close-button' | 'api' | 'unmount' | string;
 /**
  * `<lyra-dialog>` — a general-purpose modal/overlay. `role="dialog"`,
  * focus-trapped while open, dismissible via Escape or a backdrop click, and
- * scroll-locks the document for as long as it's open. Chrome stays minimal —
- * no built-in title bar or close button; a consumer supplies a heading and
- * any close affordance itself via the default/`footer` slots.
+ * scroll-locks the document for as long as it's open. Chrome stays minimal by
+ * default — no built-in title bar or close button; a consumer supplies a
+ * heading and any close affordance itself via the default/`footer` slots.
+ * `heading`/`closable` are an opt-in convenience for the common case where
+ * hand-building that chrome isn't worth it (see below).
  *
- * Accessible name: if a heading element (`h1`–`h6` or `[role="heading"]`) is
- * a *direct child* (not inside `slot="footer"`), its text content becomes
- * `aria-label` on the panel. Otherwise, when `label` is set, an invisible
- * (`.sr-only`, exposed as the `label` part) element carrying that text is
- * rendered inside the panel and `aria-labelledby` points at it instead.
- * Either way `label` itself never renders visible chrome — a slotted heading
- * is what a sighted user sees; `::part(label)` can be restyled to make the
- * sr-only text visible too, if a consumer wants that instead of slotting a
- * heading.
+ * Accessible name / visible header, in priority order:
+ * 1. If a heading element (`h1`–`h6` or `[role="heading"]`) is a *direct
+ *    child* (not inside `slot="footer"`), its text content becomes
+ *    `aria-label` on the panel — unchanged, and takes priority over `heading`
+ *    below so an existing consumer that already slots its own heading keeps
+ *    rendering it exactly as before.
+ * 2. Otherwise, when `heading` is set, a visible header row (`part="header"`)
+ *    renders containing that text (`part="heading"`), which becomes the
+ *    `aria-labelledby` target.
+ * 3. Otherwise, when `label` is set, an invisible (`.sr-only`, exposed as the
+ *    `label` part) element carrying that text is rendered inside the panel
+ *    and `aria-labelledby` points at it instead.
+ * Only one of cases 2/3 ever renders at a time, so exactly one element ever
+ * claims `aria-labelledby`. `label` itself never renders visible chrome on
+ * its own — `::part(label)` can be restyled to make the sr-only text visible,
+ * or `heading` can be set instead, if a consumer wants visible chrome without
+ * slotting a real heading element.
  *
- * The heading case deliberately uses `aria-label` (a copied string) rather
- * than `aria-labelledby` pointing at the heading's `id`: the heading is
+ * The slotted-heading case deliberately uses `aria-label` (a copied string)
+ * rather than `aria-labelledby` pointing at the heading's `id`: the heading is
  * *light-DOM* content while `[part="panel"]` lives in this element's
  * *shadow* tree, and an ID-reference attribute can't resolve across that
  * boundary (verified against axe's `aria-dialog-name` rule) — unlike the
- * `label`-prop case above, where the sr-only element is rendered inside the
- * same shadow root it labels, so `aria-labelledby` there is safe.
+ * `heading`/`label`-prop cases above, where the target element is rendered
+ * inside the same shadow root it labels, so `aria-labelledby` there is safe.
+ *
+ * `closable` renders a close (X) button in the header row (creating one, with
+ * no heading text, if `heading` is unset) that closes the dialog via the same
+ * `close()` path as Escape/backdrop-dismiss, with reason `'close-button'`.
+ *
+ * Stacking: opening one `<lyra-dialog>` while another is already open (e.g. a
+ * `confirm()` launched from within an already-open dialog) is supported --
+ * Escape and the Tab focus trap only ever act on the topmost open dialog, so
+ * dialogs beneath it stay open and untouched until the one on top closes.
  *
  * @customElement lyra-dialog
  * @slot - The dialog body.
  * @slot footer - Action buttons, rendered in a bottom row.
  * @event lyra-dialog-close - `detail: DialogCloseReason`. Fired whenever the
- *   dialog is dismissed via Escape, a backdrop click, or a `close()` call.
+ *   dialog is dismissed via Escape, a backdrop click, the built-in close
+ *   button (`closable`), a `close()` call, or (with reason `'unmount'`)
+ *   removal from the DOM by anything else while still open.
  * @csspart backdrop - The full-viewport scrim behind the panel.
- * @csspart panel - The dialog panel itself (`role="dialog"` while open).
+ * @csspart panel - The dialog panel itself (`role="dialog"` while open). Its
+ *   max-inline-size is controlled by the `--lyra-dialog-max-width` custom
+ *   property (default `32rem`).
+ * @csspart header - The header row, rendered when `heading` is set (and no
+ *   heading is slotted) and/or `closable` is `true`.
+ * @csspart heading - The visible `heading`-text element inside `header`,
+ *   rendered only when `heading` is set and no heading is slotted.
+ * @csspart close-button - The built-in close button, rendered inside `header`
+ *   only when `closable` is `true`.
  * @csspart label - The invisible `label`-text element used for
- *   `aria-labelledby` when no heading is slotted.
+ *   `aria-labelledby` when no heading is slotted and `heading` is unset.
  * @csspart body - The wrapper around the default slot.
  * @csspart footer - The wrapper around the `footer` slot.
  */
@@ -51,11 +83,22 @@ export declare class LyraDialog extends LyraElement {
     open: boolean;
     /** Accessible name used when no heading is slotted — see the class doc for the full fallback order. */
     label: string;
+    /** Visible header text, rendered when no heading element is slotted into
+     *  the default slot — see the class doc for the full fallback order. Has
+     *  no effect (renders nothing) if a light-DOM heading is slotted; that case
+     *  keeps working completely unchanged whether or not `heading` is set. */
+    heading?: string;
+    /** Renders a built-in close (X) button in the header row (creating one,
+     *  with no heading text, if `heading` is unset), wired to the same
+     *  `close()` path Escape/backdrop-dismiss already use, with reason
+     *  `'close-button'`. */
+    closable: boolean;
     private hasFooterSlot;
     private headingText?;
     private releaseScrollLock?;
-    private lastTrigger?;
+    private overlay?;
     private readonly srLabelId;
+    private readonly headingId;
     protected willUpdate(changed: PropertyValues): void;
     protected updated(changed: PropertyValues): void;
     connectedCallback(): void;
@@ -66,16 +109,17 @@ export declare class LyraDialog extends LyraElement {
     /**
      * Close the dialog and return focus to whatever had it before the dialog
      * opened. `reason` is forwarded as the `lyra-dialog-close` detail --
-     * built-in triggers pass `'escape'`/`'backdrop'`; a consumer's own close
-     * affordance (e.g. a footer Cancel button) should call this directly with
-     * its own reason string, so every dismissal path funnels through the same
-     * event instead of the consumer having to also toggle `open` itself.
+     * built-in triggers pass `'escape'`/`'backdrop'`/`'close-button'`; a
+     * consumer's own close affordance (e.g. a footer Cancel button) should
+     * call this directly with its own reason string, so every dismissal path
+     * funnels through the same event instead of the consumer having to also
+     * toggle `open` itself.
      */
     close(reason?: DialogCloseReason): void;
     private onBackdropClick;
-    private onDocKeyDown;
-    private getFocusableElements;
-    private getActiveElement;
+    private onCloseButtonClick;
+    private activateOverlay;
+    private deactivateOverlay;
     render(): TemplateResult;
 }
 declare global {