@aceshooting/lyra-ui 1.1.0 → 2.0.0

package/dist/components/mention-popover/mention-popover.js

@@ -0,0 +1,475 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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 { property, state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { defineElement } from '../../internal/prefix.js';
+import { place } from '../../internal/positioner.js';
+import { nextId } from '../../internal/a11y.js';
+import { styles } from './mention-popover.styles.js';
+function defaultFilter(item, query) {
+    return item.label.toLowerCase().includes(query) || (item.description ?? '').toLowerCase().includes(query);
+}
+function isTextControl(el) {
+    if (el instanceof HTMLTextAreaElement)
+        return true;
+    return el instanceof HTMLInputElement && (el.type === 'text' || el.type === 'search');
+}
+// Computed-style properties that affect text layout/measurement, copied
+// verbatim from the real control onto the hidden mirror in caretClientRect()
+// below so wrapped-line offsets inside the mirror land exactly where they do
+// in the real control. Deliberately excludes paint-only properties (color,
+// background, etc.) -- those never affect where text/lines break.
+const MIRROR_CSS_PROPS = [
+    'box-sizing',
+    'width',
+    'padding-top',
+    'padding-right',
+    'padding-bottom',
+    'padding-left',
+    'border-top-width',
+    'border-right-width',
+    'border-bottom-width',
+    'border-left-width',
+    'border-style',
+    'font-family',
+    'font-size',
+    'font-style',
+    'font-variant',
+    'font-weight',
+    'font-stretch',
+    'letter-spacing',
+    'word-spacing',
+    'line-height',
+    'text-align',
+    'text-indent',
+    'text-transform',
+    'tab-size',
+    'direction',
+];
+/**
+ * Measures exactly where `el`'s caret (`selectionStart`) currently paints,
+ * in viewport coordinates, via the classic "hidden mirror div + marker span"
+ * technique: there is no native DOM API for this -- `getBoundingClientRect()`
+ * on a text control only reports the control's own box, never a cursor
+ * position inside it. A throwaway off-screen clone of `el` is built (font/
+ * box metrics copied via `MIRROR_CSS_PROPS` above), a marker `<span>` is
+ * inserted at the caret's text offset, its rect is measured relative to the
+ * mirror's own rect (so the absolute off-screen position of the mirror
+ * itself never matters), and that local offset is applied to `el`'s real
+ * `getBoundingClientRect()` minus its current scroll offset. Returns `null`
+ * for a zero-size (e.g. `display: none`) control.
+ */
+function caretClientRect(el) {
+    const elRect = el.getBoundingClientRect();
+    if (elRect.width === 0 || elRect.height === 0)
+        return null;
+    const computed = window.getComputedStyle(el);
+    const mirror = document.createElement('div');
+    mirror.style.position = 'absolute';
+    mirror.style.visibility = 'hidden';
+    mirror.style.top = '0';
+    mirror.style.left = '-9999px';
+    // <textarea> soft-wraps; a single-line <input> never does -- mismatching
+    // this makes the mirror wrap where the real control wouldn't (or vice
+    // versa), throwing off every offset past the first line/character run.
+    mirror.style.whiteSpace = el instanceof HTMLTextAreaElement ? 'pre-wrap' : 'pre';
+    mirror.style.overflowWrap = 'break-word';
+    for (const prop of MIRROR_CSS_PROPS) {
+        mirror.style.setProperty(prop, computed.getPropertyValue(prop));
+    }
+    const index = el.selectionStart ?? el.value.length;
+    mirror.append(document.createTextNode(el.value.slice(0, index)));
+    const marker = document.createElement('span');
+    // A marker with no content at all collapses to zero width -- a hair of
+    // content keeps it reliably measurable even for a caret sitting at the
+    // very end of the value.
+    marker.textContent = el.value.slice(index) || '​';
+    mirror.appendChild(marker);
+    document.body.appendChild(mirror);
+    const mirrorRect = mirror.getBoundingClientRect();
+    const markerRect = marker.getBoundingClientRect();
+    mirror.remove();
+    const lineHeight = parseFloat(computed.lineHeight) || markerRect.height || 16;
+    return new DOMRect(elRect.left + (markerRect.left - mirrorRect.left) - el.scrollLeft, elRect.top + (markerRect.top - mirrorRect.top) - el.scrollTop, 1, lineHeight);
+}
+/**
+ * `<lyra-mention-popover>` — a caret-anchored, keyboard-navigable popover for
+ * `@`-mention and `/`-slash-command autocomplete inside a plain-text
+ * `<textarea>`/`<input>` the host owns (e.g. `<lyra-chat-composer>`'s own
+ * textarea, though this component has no dependency on that or any other
+ * specific input). It never takes DOM focus itself — the same "focus stays
+ * put, `aria-activedescendant` conveys the active row" pattern
+ * `<lyra-select>`/`<lyra-combobox>` use for their own listbox — so a host
+ * must apply `aria-activedescendant` to its *own* input element, pointing at
+ * whatever `activeDescendantId` currently returns.
+ *
+ * Integration contract (entirely the host's responsibility — this component
+ * never inspects the text control's value or listens to it directly):
+ * 1. Detect a mention/command trigger (e.g. `@`/`/` at the start of a word)
+ *    in the host's own `input` handling.
+ * 2. Set `anchor` (the `<textarea>`/`<input>` itself, or any element for
+ *    plain whole-element anchoring — see "Positioning" below), `items`, and
+ *    `query` (the text typed since the trigger character), then flip
+ *    `open = true`.
+ * 3. Forward every `keydown` the input receives, while `open`, through
+ *    `handleKeyDown()` — it returns `true` when it consumed the key (so the
+ *    host's own handler should stop, e.g. skip submitting the message on an
+ *    Enter that actually picked a mention) and `false` otherwise.
+ * 4. Set `open = false` whenever the query stops looking like an active
+ *    mention context (a space typed, the trigger character deleted, the
+ *    input blurred, …) — `lyra-mention-close` fires automatically from that
+ *    (see below), there is no separate "tell it to close" call needed.
+ * 5. Keep the host's own input's `aria-activedescendant` (and, optionally,
+ *    `aria-controls`, via `listboxId`) in sync with `activeDescendantId` —
+ *    this component has no DOM of the host's to attach that to itself.
+ *
+ * Positioning: when `anchor` is a plain `<textarea>` or single-line text
+ * `<input>`, this component measures exactly where the caret currently
+ * paints (`caretClientRect()`, the standard hidden-mirror-element technique
+ * — see that function's own doc) and positions against that single point
+ * with `internal/positioner.js`'s `place()`, so the popup tracks the caret
+ * rather than sitting under the whole textarea. Any other `anchor` element
+ * (or a text control this component fails to measure, e.g. one with
+ * `display: none`) falls back to `place(anchor, popup)` against the whole
+ * element — the same whole-element anchoring `<lyra-combobox>`/
+ * `<lyra-select>` use for their own popups. Re-measures on every `anchor`/
+ * `query` change while open (a keystroke moves the caret, so a fresh `query`
+ * is the proxy for "the caret may have moved"); a caret that moves for a
+ * reason other than typing (e.g. a mouse click elsewhere in the text while
+ * the popover happens to still be open) is not separately tracked — the
+ * host can force a re-measure by toggling `open` or reassigning `anchor`.
+ *
+ * Filtering happens internally against `items` (mirroring `<lyra-combobox>`'s
+ * filter-predicate convention via `filter`, rather than requiring the host to
+ * pre-filter): the default predicate is a case-insensitive substring match
+ * against `label`/`description`, overridable via `filter`.
+ *
+ * There is no persisted "selection" the way a real listbox has one — a
+ * mention is either committed (closing the popover) or the popover is
+ * dismissed with nothing chosen — so `aria-selected="true"` marks whichever
+ * row is currently *active* (what Enter/Tab would commit right now), per the
+ * WAI-ARIA combobox-with-list-autocomplete pattern, rather than tracking a
+ * separate persisted value the way `<lyra-combobox>`'s own `aria-selected`
+ * does.
+ *
+ * @example
+ * ```html
+ * <textarea id="composer"></textarea>
+ * <lyra-mention-popover id="mentions"></lyra-mention-popover>
+ * <script>
+ *   const textarea = document.getElementById('composer');
+ *   const popover = document.getElementById('mentions');
+ *
+ *   textarea.addEventListener('keydown', (e) => {
+ *     if (popover.open && popover.handleKeyDown(e)) return; // consumed
+ *     // ...the host's own Enter-to-send handling, etc.
+ *   });
+ *   textarea.addEventListener('input', () => {
+ *     // host's own '@'/'/' + query detection, then:
+ *     popover.anchor = textarea;
+ *     popover.items = candidates;
+ *     popover.query = detectedQuery;
+ *     popover.open = detectedQuery !== null;
+ *   });
+ *   textarea.addEventListener('blur', () => (popover.open = false));
+ *
+ *   popover.addEventListener('lyra-mention-select', (e) => {
+ *     // splice `${e.detail.label}` into the textarea at the trigger offset
+ *   });
+ *   popover.addEventListener('lyra-mention-close', () => {
+ *     textarea.removeAttribute('aria-activedescendant');
+ *   });
+ *
+ *   // Whenever the popover re-renders its active row (e.g. after every
+ *   // ArrowUp/ArrowDown handleKeyDown() call above), sync the host's own
+ *   // input so assistive tech announces the current candidate:
+ *   const syncActiveDescendant = () => {
+ *     if (popover.open && popover.activeDescendantId) {
+ *       textarea.setAttribute('aria-activedescendant', popover.activeDescendantId);
+ *     } else {
+ *       textarea.removeAttribute('aria-activedescendant');
+ *     }
+ *   };
+ * </script>
+ * ```
+ *
+ * @customElement lyra-mention-popover
+ * @event lyra-mention-select - An item was committed (Enter/Tab/click). `detail: { id, label }`.
+ * @event lyra-mention-close - The popover was dismissed with no selection — Escape, or `open`
+ * transitioning to `false` by any other means (a direct host assignment included). Never fires
+ * for a close that followed a `lyra-mention-select` commit.
+ * @csspart listbox - The popover's root element (`role="listbox"`).
+ * @csspart option - A candidate row (`role="option"`).
+ * @csspart option-icon - A row's leading icon glyph, when `icon` is set.
+ * @csspart option-label - Wrapper around a row's label/description.
+ * @csspart option-description - A row's optional secondary line, when `description` is set.
+ * @csspart empty - The "no matches" message, shown when `items`/`query` produce zero rows.
+ */
+export class LyraMentionPopover extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** The full candidate set, pre-`query`-filtering. */
+        this.items = [];
+        /** The text typed since the trigger character (`@`/`/`/…) — drives the
+         *  built-in internal filtering (see `filter` to override it). */
+        this.query = '';
+        /** Whether the popover is shown. */
+        this.open = false;
+        /** Overrides the built-in case-insensitive label/description substring match. */
+        this.filter = null;
+        /** Message shown when `items` (post-`query`-filtering) is empty. */
+        this.emptyText = 'No matches';
+        /** Accessible name for the `role="listbox"` popup. */
+        this.label = 'Suggestions';
+        // Highlighted row, opens pre-highlighted on the top match (index 0) so a
+        // bare Enter right after opening commits immediately -- the same "first
+        // result is pre-selected" UX every mainstream @-mention/slash-command
+        // picker (Slack, GitHub, Notion, …) uses, unlike lyra-combobox's own
+        // listbox which opens with nothing highlighted (-1) since a combobox's
+        // typed text can itself already equal a full, deliberately-typed value.
+        this.activeIndex = 0;
+        this._listboxId = nextId('mention-popover-listbox');
+        // A synthetic zero-size point element, positioned at the measured caret
+        // rect and handed to place() in caret-precision mode -- place()/Floating
+        // UI only understand a real HTMLElement anchor, so caret positioning goes
+        // through this rather than a bespoke non-place()-based positioning path.
+        this.virtualAnchor = null;
+        this._isFirstUpdate = true;
+        // Set by commit() immediately before it flips `open` false, so updated()'s
+        // open-transition handling below (which otherwise fires lyra-mention-close
+        // on every true->false transition, matching lyra-combobox's/lyra-select's
+        // identical lyra-hide handling) can tell a successful-selection close
+        // apart from every other close and skip the event for that one case.
+        this._suppressCloseEvent = false;
+        // Delegated onto [part="listbox"] rather than one closure pair allocated
+        // per row per render -- same pattern as lyra-combobox's/lyra-select's
+        // identical onListboxMouseDown/onListboxClick.
+        this.onListboxMouseDown = (e) => {
+            // Focus must never leave the host's own text control -- preventing the
+            // default here is what stops a plain (non-focusable) row click from
+            // blurring it.
+            if (e.target.closest('[part="option"]'))
+                e.preventDefault();
+        };
+        this.onListboxClick = (e) => {
+            const optionEl = e.target.closest('[part="option"]');
+            const id = optionEl?.dataset.id;
+            if (id === undefined)
+                return;
+            const item = this.filteredItems.find((i) => i.id === id);
+            if (item)
+                this.commit(item);
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate(changed) {
+        this._isFirstUpdate = !this.hasUpdated;
+        // A fresh query or candidate set re-highlights the top match, mirroring
+        // how a filtering text field's own suggestion list re-anchors to the
+        // first result on every keystroke rather than preserving a highlight
+        // that may no longer even be in the filtered set.
+        if (changed.has('query') || changed.has('items'))
+            this.activeIndex = 0;
+    }
+    updated(changed) {
+        if (changed.has('open')) {
+            if (this.open) {
+                this.reposition();
+            }
+            else {
+                this.cleanup?.();
+                this.cleanup = undefined;
+                this.virtualAnchor?.remove();
+                // Don't fire for markup that's simply rendering open="false" for the
+                // first time, and don't fire for the commit() path (see
+                // _suppressCloseEvent's own doc above) -- every other true->false
+                // transition (Escape, or a direct host assignment) does fire.
+                if (!this._isFirstUpdate && !this._suppressCloseEvent)
+                    this.emit('lyra-mention-close');
+                this._suppressCloseEvent = false;
+            }
+        }
+        else if (this.open && (changed.has('anchor') || changed.has('query'))) {
+            this.reposition();
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.cleanup?.();
+        this.cleanup = undefined;
+        this.virtualAnchor?.remove();
+    }
+    /** The current candidate set: `items` filtered by `query` via `filter`
+     *  (or the built-in default). Empty `query` returns `items` unfiltered. */
+    get filteredItems() {
+        const q = this.query.trim().toLowerCase();
+        if (!q)
+            return this.items;
+        const fn = this.filter ?? defaultFilter;
+        return this.items.filter((item) => fn(item, q));
+    }
+    /** The `id` of the currently-highlighted row for the host to apply as its
+     *  own input's `aria-activedescendant` — `null` while closed or when
+     *  `filteredItems` is empty (nothing to point at). See the class doc's
+     *  `@example` for the full wiring. */
+    get activeDescendantId() {
+        if (!this.open)
+            return null;
+        const idx = this.clampedIndex(this.filteredItems);
+        return idx >= 0 ? this.rowId(idx) : null;
+    }
+    /** The `id` of the `role="listbox"` popup, for a host that also wants to
+     *  wire `aria-controls` on its own input (screen-reader support for
+     *  `aria-controls` is inconsistent, so `activeDescendantId` remains the
+     *  load-bearing piece; this is a supplementary nicety). */
+    get listboxId() {
+        return this._listboxId;
+    }
+    /**
+     * The host's own text-control keydown handler calls this while the
+     * popover is open. Returns `true` when the key was intercepted
+     * (`preventDefault()` already called) and the host should not also act on
+     * it; `false` when the host's normal handling should proceed untouched.
+     */
+    handleKeyDown(e) {
+        if (!this.open)
+            return false;
+        const rows = this.filteredItems;
+        switch (e.key) {
+            case 'ArrowDown':
+                e.preventDefault();
+                if (rows.length)
+                    this.activeIndex = Math.min(rows.length - 1, this.clampedIndex(rows) + 1);
+                return true;
+            case 'ArrowUp':
+                e.preventDefault();
+                if (rows.length)
+                    this.activeIndex = Math.max(0, this.clampedIndex(rows) - 1);
+                return true;
+            case 'Enter':
+            case 'Tab': {
+                const idx = this.clampedIndex(rows);
+                // Nothing to commit -- let Enter submit / Tab move focus normally,
+                // matching a native combobox with no highlighted suggestion.
+                if (idx < 0)
+                    return false;
+                e.preventDefault();
+                this.commit(rows[idx]);
+                return true;
+            }
+            case 'Escape':
+                e.preventDefault();
+                this.open = false;
+                return true;
+            default:
+                return false;
+        }
+    }
+    clampedIndex(rows) {
+        if (!rows.length)
+            return -1;
+        return Math.min(Math.max(this.activeIndex, 0), rows.length - 1);
+    }
+    rowId(index) {
+        return `${this._listboxId}-opt-${index}`;
+    }
+    commit(item) {
+        this.emit('lyra-mention-select', { id: item.id, label: item.label });
+        this._suppressCloseEvent = true;
+        this.open = false;
+    }
+    reposition() {
+        this.cleanup?.();
+        this.cleanup = undefined;
+        const anchorEl = this.resolveAnchorElement();
+        const popup = this.renderRoot.querySelector('[part="listbox"]');
+        if (anchorEl && popup)
+            this.cleanup = place(anchorEl, popup, { placement: 'bottom-start' });
+    }
+    /** Resolves what to actually hand `place()` -- a caret-precise virtual
+     *  point for a measurable text control, `anchor` itself otherwise. See the
+     *  class doc's "Positioning" section. */
+    resolveAnchorElement() {
+        const anchor = this.anchor;
+        if (!anchor)
+            return null;
+        if (isTextControl(anchor)) {
+            const rect = caretClientRect(anchor);
+            if (rect) {
+                const virtual = this.virtualAnchor ?? (this.virtualAnchor = document.createElement('div'));
+                virtual.style.position = 'fixed';
+                virtual.style.left = `${rect.left}px`;
+                virtual.style.top = `${rect.top}px`;
+                virtual.style.width = '0';
+                virtual.style.height = `${rect.height}px`;
+                virtual.style.pointerEvents = 'none';
+                if (!virtual.isConnected)
+                    document.body.appendChild(virtual);
+                return virtual;
+            }
+        }
+        return anchor;
+    }
+    renderRow(item, index, activeId) {
+        const id = this.rowId(index);
+        const active = id === activeId;
+        return html `
+      <div part="option" id=${id} role="option" data-id=${item.id} aria-selected=${active ? 'true' : 'false'} ?data-active=${active}>
+        ${item.icon ? html `<span part="option-icon" aria-hidden="true">${item.icon}</span>` : nothing}
+        <span part="option-label">
+          <span>${item.label}</span>
+          ${item.description ? html `<span part="option-description">${item.description}</span>` : nothing}
+        </span>
+      </div>
+    `;
+    }
+    render() {
+        const rows = this.filteredItems;
+        const idx = this.clampedIndex(rows);
+        const activeId = idx >= 0 ? this.rowId(idx) : '';
+        return html `
+      <div
+        part="listbox"
+        id=${this._listboxId}
+        role="listbox"
+        aria-label=${this.label}
+        @mousedown=${this.onListboxMouseDown}
+        @click=${this.onListboxClick}
+      >
+        ${rows.length === 0
+            ? html `<div part="empty" role="option" aria-selected="false" aria-disabled="true">${this.emptyText}</div>`
+            : rows.map((item, i) => this.renderRow(item, i, activeId))}
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraMentionPopover.prototype, "anchor", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraMentionPopover.prototype, "items", void 0);
+__decorate([
+    property()
+], LyraMentionPopover.prototype, "query", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraMentionPopover.prototype, "open", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraMentionPopover.prototype, "filter", void 0);
+__decorate([
+    property({ attribute: 'empty-text' })
+], LyraMentionPopover.prototype, "emptyText", void 0);
+__decorate([
+    property()
+], LyraMentionPopover.prototype, "label", void 0);
+__decorate([
+    state()
+], LyraMentionPopover.prototype, "activeIndex", void 0);
+defineElement('mention-popover', LyraMentionPopover);

package/dist/components/mention-popover/mention-popover.styles.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/dist/components/mention-popover/mention-popover.styles.js

@@ -0,0 +1,101 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: contents;
+  }
+
+  /* Positioned by internal/positioner.js's place() -- same fixed/z-index
+     shape as lyra-combobox's/lyra-select's own [part='listbox']. Closed
+     state: invisible + slightly raised, transitioning in on :host([open]),
+     same as those two. */
+  [part='listbox'] {
+    position: fixed;
+    z-index: 900;
+    box-sizing: border-box;
+    max-block-size: 16rem;
+    overflow-y: auto;
+    inline-size: max-content;
+    min-inline-size: 14rem;
+    max-inline-size: min(92vw, 24rem);
+    padding: var(--lyra-space-xs);
+    background: var(--lyra-color-surface);
+    border: 1px solid var(--lyra-color-border);
+    border-radius: var(--lyra-radius);
+    box-shadow: var(--lyra-shadow);
+    visibility: hidden;
+    opacity: 0;
+    transform: translateY(-0.25rem);
+    transition:
+      opacity var(--lyra-transition-fast),
+      transform var(--lyra-transition-fast),
+      visibility var(--lyra-transition-fast);
+  }
+  :host([open]) [part='listbox'] {
+    visibility: visible;
+    opacity: 1;
+    transform: translateY(0);
+  }
+  @media (prefers-reduced-motion: reduce) {
+    [part='listbox'] {
+      transition: none !important;
+    }
+  }
+
+  [part='option'] {
+    display: flex;
+    align-items: flex-start;
+    gap: var(--lyra-space-xs);
+    inline-size: 100%;
+    padding: var(--lyra-space-xs) var(--lyra-space-s);
+    border-radius: var(--lyra-radius);
+    cursor: pointer;
+  }
+  [part='option'][data-active] {
+    background: var(--lyra-color-brand-quiet);
+  }
+  [part='option'][aria-selected='true'] {
+    color: var(--lyra-color-brand);
+  }
+
+  [part='option-icon'] {
+    flex: 0 0 auto;
+    line-height: 1.4;
+  }
+
+  [part='option-label'] {
+    display: flex;
+    flex-direction: column;
+    min-inline-size: 0;
+    line-height: 1.4;
+  }
+  [part='option-label'] span:first-child {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  [part='option-description'] {
+    font-size: 0.75rem;
+    color: var(--lyra-color-text-quiet);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+  /* --lyra-color-text-quiet-on-brand-quiet fails WCAG AA (~4.24:1, needs
+     4.5:1) -- unlike lyra-combobox's/lyra-select's identical-looking
+     [part='option'][data-active] background (which never has this problem
+     in practice, since those default their active index to -1/none until a
+     user actually arrows through the list), this component always opens
+     with row 0 pre-highlighted (see the activeIndex field's own doc), so the
+     active/quiet-text combination is the default state, not an edge case --
+     it must pass contrast on its own. */
+  [part='option'][data-active] [part='option-description'] {
+    color: var(--lyra-color-text);
+  }
+
+  [part='empty'] {
+    padding: var(--lyra-space-s) var(--lyra-space-m);
+    color: var(--lyra-color-text-quiet);
+    font-size: 0.875rem;
+  }
+`;

package/dist/components/menu/menu-item.d.ts

@@ -0,0 +1,62 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+/**
+ * `<lyra-menu-item>` — a single action row inside `<lyra-menu>`'s default
+ * slot. Not meaningful on its own (there is no standalone "click a menu item"
+ * use case) — it exists purely as `<lyra-menu>`'s light-DOM child, the same
+ * relationship `<lyra-option>` has to `<lyra-combobox>`/`<lyra-select>`.
+ *
+ * `role="menuitem"` and the roving `tabindex` both live on *this host
+ * element*, not an internal shadow-DOM button — mirroring `<lyra-tree-node>`'s
+ * identical choice (see that class's doc). `<lyra-menu>` is the sole owner of
+ * this element's `tabIndex`: it flips exactly one navigable item's `tabIndex`
+ * to `0` (the rest sit at `-1`) as its roving-tabindex highlight moves, and
+ * calls `.focus()` directly on this host to move real DOM focus there.
+ * `[part="base"]` is purely a visual box with no interactive semantics of its
+ * own — see the class doc on `<lyra-menu>` for why real DOM focus (rather
+ * than `aria-activedescendant`) was chosen for this pair.
+ *
+ * Enter/Space activation is handled by `<lyra-menu>`'s own delegated
+ * `keydown` listener calling `select()` on whichever item is currently
+ * roving-focused (mirrors `<lyra-tree>` calling `current.select()` from its
+ * own keydown handler) — this element only wires a plain `click` listener
+ * itself, so `select()` fires identically whether the item was reached by
+ * mouse or keyboard.
+ *
+ * @customElement lyra-menu-item
+ * @slot - The item's label content.
+ * @slot icon - Optional leading icon.
+ * @event lyra-menu-item-select - This item was activated (click, or the
+ * parent `<lyra-menu>`'s own Enter/Space handling of the roving-focused
+ * item). No detail payload — a listener already has `event.target` (this
+ * element) to read `value` off of, and `<lyra-menu>` itself consumes this
+ * event to close and re-fire it as its own consolidated `lyra-menu-select`
+ * (`detail: { value }`) rather than requiring a consumer to listen on every
+ * individual item — listen there instead unless you specifically need a
+ * per-item handler.
+ * @csspart base - The row (`role` lives on the host — see the class doc).
+ * @csspart icon - Wrapper around the `icon` slot. Not rendered at all when the slot is empty.
+ * @csspart label - Wrapper around the default slot.
+ */
+export declare class LyraMenuItem extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** An id/value the parent `<lyra-menu>`'s `lyra-menu-select` detail keys off of. */
+    value: string;
+    /** Disables selection and excludes this item from `<lyra-menu>`'s roving-tabindex nav entirely. */
+    disabled: boolean;
+    /** Visual treatment for a dangerous action (e.g. "Delete") — tints the row with `--lyra-color-danger`. */
+    destructive: boolean;
+    private hasIconSlot;
+    connectedCallback(): void;
+    protected willUpdate(): void;
+    /** Fires `lyra-menu-item-select` (no-op while `disabled`). Called by this element's own
+     *  click handler, and by `<lyra-menu>`'s Enter/Space keydown handling of the active item. */
+    select(): void;
+    private onIconSlotChange;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-menu-item': LyraMenuItem;
+    }
+}