@aceshooting/lyra-ui 3.6.0 → 3.8.0

package/dist/components/task-list/task-list.class.js

@@ -0,0 +1,271 @@
+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, svg, nothing, } from 'lit';
+import { property, query } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { nextId } from '../../internal/a11y.js';
+import { chevronIcon } from '../../internal/icons.js';
+import '../live-region/live-region.js';
+import { styles } from './task-list.styles.js';
+// Mirrors the shared icon set's viewBox/stroke conventions (internal/icons.ts) without adding
+// task-list-specific glyphs there -- duplicated locally, matching lyra-tool-call-chip's own
+// STATUS_ICON set (same four shapes, minus its 'denied' glyph, which has no TaskStatus
+// counterpart).
+const ICON_VIEW_BOX = '0 0 24 24';
+const ICON_STROKE_WIDTH = '1.75';
+function icon(paths) {
+    return svg `
+    <svg
+      width="1em"
+      height="1em"
+      viewBox=${ICON_VIEW_BOX}
+      fill="none"
+      stroke="currentColor"
+      stroke-width=${ICON_STROKE_WIDTH}
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+      focusable="false"
+    >${paths}</svg>
+  `;
+}
+function pendingIcon() {
+    return icon(svg `<circle cx="12" cy="12" r="9"></circle><polyline points="12 7 12 12 15 14"></polyline>`);
+}
+function runningIcon() {
+    return icon(svg `<path d="M21 12a9 9 0 1 1-9-9"></path>`);
+}
+function successIcon() {
+    return icon(svg `<circle cx="12" cy="12" r="9"></circle><polyline points="8 12.5 11 15.5 16 9.5"></polyline>`);
+}
+function errorIcon() {
+    return icon(svg `
+    <circle cx="12" cy="12" r="9"></circle>
+    <line x1="9" y1="9" x2="15" y2="15"></line>
+    <line x1="15" y1="9" x2="9" y2="15"></line>
+  `);
+}
+const STATUS_ICON = {
+    pending: pendingIcon,
+    running: runningIcon,
+    success: successIcon,
+    error: errorIcon,
+};
+const STATUS_LABEL_KEY = {
+    pending: 'statusPending',
+    running: 'statusRunning',
+    success: 'statusSuccess',
+    error: 'statusError',
+};
+/** `true`-defaulting boolean attribute converter -- Lit's default presence-based `type: Boolean`
+ *  can never be set back to `false` from a plain-HTML attribute once the property's own default is
+ *  `true` (removing an attribute that was never present fires no `attributeChangedCallback`), so
+ *  `fromAttribute` checks the literal string instead (mirrors `lyra-generation-status`'s
+ *  `showStopConverter`). Unlike that converter, `toAttribute` here reflects the `true` state as a
+ *  present attribute rather than omitting it: `expanded`'s host attribute drives this component's
+ *  own `:host([expanded])` styling, so the attribute must actually be present while expanded and
+ *  absent while collapsed for that selector to work. Shared by both `expanded` and `collapsible`,
+ *  which have the identical `true`-default parsing need -- `collapsible` just isn't reflected. */
+const trueDefaultBooleanConverter = {
+    fromAttribute(value) {
+        return value !== 'false';
+    },
+    toAttribute(value) {
+        return value ? '' : null;
+    },
+};
+/**
+ * `<lyra-task-list>` — a live, collapsible tracker for an agent's plan: ordered steps with
+ * per-step lifecycle status and one level of nested sub-steps, embedded in the transcript.
+ * `items` is controlled and never mutated by this component, mirroring `<lyra-stepper>`'s `steps`
+ * contract -- but unlike stepper's single-`current` navigation control, task-list is a read-only
+ * status report: several steps may be `running` at once, there is no selection, and status changes
+ * are announced through an internal `<lyra-live-region>`.
+ *
+ * @customElement lyra-task-list
+ * @slot detail-<id> - Dynamic, one per item id (e.g. `slot="detail-step-3"`). Rich detail under
+ *   that item's label, after its `detail` text -- typically a `<lyra-tool-call-chip>` or file
+ *   `<lyra-chip>`. Plain-HTML friendly, no render props.
+ * @event lyra-toggle - The header was activated, expanding or collapsing the panel. `detail: {
+ *   expanded }`.
+ * @csspart base - The outer container.
+ * @csspart header - The clickable header (a `<button>` when `collapsible`, a plain heading
+ *   otherwise).
+ * @csspart label - The `label` text.
+ * @csspart summary - The visible "N of M completed" summary, counting only top-level items.
+ * @csspart toggle - The chevron indicator inside the header. Only rendered when `collapsible`.
+ * @csspart body - The list of items, `hidden` while collapsed.
+ * @csspart item - One item row (`role="listitem"`); carries `data-status`, `data-id`,
+ *   `data-depth` (`"0"` for a top-level item, `"1"` for a child).
+ * @csspart status-icon - The per-item status glyph.
+ * @csspart item-label - The item's `label` text.
+ * @csspart item-detail - The item's optional `detail` text.
+ * @csspart item-children - The nested `role="list"` wrapper around a top-level item's children.
+ * @cssprop [--lyra-task-list-spin=1s linear] - Running-status icon spin animation duration/timing.
+ */
+export class LyraTaskList extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** The plan. Controlled and never mutated by this component -- pass a new array to update it. */
+        this.items = [];
+        /** Header text. Localized (`taskListLabel`) while at its default `'Tasks'`; any other value is
+         *  shown as-is. */
+        this.label = 'Tasks';
+        /** Whether the body (item list) is currently shown. Defaults open -- this is a progress surface,
+         *  not a details disclosure a reader opts into. */
+        this.expanded = true;
+        /** When `false`, the header renders as a static heading (no button, no toggle affordance) and
+         *  `expanded` can still be set programmatically by the host, just not toggled via the UI. */
+        this.collapsible = true;
+        this.headerId = nextId('task-list-header');
+        this.bodyId = nextId('task-list-body');
+        /** `true` until the first completed update -- gates the status-change announcements below so a
+         *  freshly-mounted list never announces whatever statuses its very first `items` happens to
+         *  carry (mirrors `<lyra-chat-message>`'s identical `isMounting` gate for its own status-change
+         *  announcement). */
+        this.isMounting = true;
+        /** Last-seen status per item id, one level deep (top-level items plus their direct children) --
+         *  diffed against the incoming `items` on every update to decide what to announce. */
+        this.previousStatusById = new Map();
+        this.toggle = () => {
+            if (!this.collapsible)
+                return;
+            this.expanded = !this.expanded;
+            this.emit('lyra-toggle', { expanded: this.expanded });
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate(changed) {
+        if (changed.has('items')) {
+            for (const item of this.items) {
+                for (const child of item.children ?? []) {
+                    for (const grandchild of child.children ?? []) {
+                        console.warn(`<lyra-task-list> item "${grandchild.id}" is nested more than one level deep and will be ignored -- only one level of nesting is supported.`);
+                    }
+                }
+            }
+        }
+    }
+    updated(changed) {
+        const wasMounting = this.isMounting;
+        this.isMounting = false;
+        if (changed.has('items'))
+            this.diffAndAnnounce(wasMounting);
+    }
+    flattenOneLevel(items) {
+        const out = [];
+        for (const item of items) {
+            out.push(item);
+            for (const child of item.children ?? [])
+                out.push(child);
+        }
+        return out;
+    }
+    diffAndAnnounce(firstSight) {
+        const region = this.liveRegion;
+        const nextMap = new Map();
+        for (const item of this.flattenOneLevel(this.items)) {
+            nextMap.set(item.id, item.status);
+            if (!firstSight && region) {
+                const previous = this.previousStatusById.get(item.id);
+                if (previous !== undefined && previous !== item.status) {
+                    // Every branch forces an immediate flush -- these are discrete lifecycle transitions
+                    // (a step starting/finishing), not a high-frequency stream where throttling matters, and
+                    // a caller updating `items` in a synchronous batch expects the *latest* transition heard
+                    // right away rather than coalesced behind the announcer's default throttle window.
+                    if (item.status === 'running') {
+                        region.mode = 'polite';
+                        region.announce(this.localize('taskListStepStartedAnnounce', undefined, { label: item.label }), {
+                            force: true,
+                        });
+                    }
+                    else if (item.status === 'success') {
+                        region.mode = 'polite';
+                        region.announce(this.localize('taskListStepCompletedAnnounce', undefined, { label: item.label }), {
+                            force: true,
+                        });
+                    }
+                    else if (item.status === 'error') {
+                        region.mode = 'assertive';
+                        region.announce(this.localize('taskListStepFailedAnnounce', undefined, { label: item.label }), {
+                            force: true,
+                        });
+                    }
+                }
+            }
+        }
+        this.previousStatusById = nextMap;
+    }
+    renderItem(item, depth) {
+        const hasChildren = depth === 0 && !!item.children && item.children.length > 0;
+        return html `
+      <div part="item" role="listitem" data-status=${item.status} data-id=${item.id} data-depth=${depth}>
+        <span part="status-icon" aria-hidden="true">${STATUS_ICON[item.status]()}</span>
+        <span class="sr-only">${this.localize(STATUS_LABEL_KEY[item.status])}</span>
+        <span part="item-label">${item.label}</span>
+        ${item.detail ? html `<span part="item-detail">${item.detail}</span>` : nothing}
+        <slot name=${`detail-${item.id}`}></slot>
+        ${hasChildren
+            ? html `<div part="item-children" role="list">
+              ${item.children.map((child) => this.renderItem(child, 1))}
+            </div>`
+            : nothing}
+      </div>
+    `;
+    }
+    render() {
+        const label = this.label === 'Tasks' ? this.localize('taskListLabel') : this.label;
+        const total = this.items.length;
+        const completed = this.items.filter((item) => item.status === 'success').length;
+        const summary = this.localize('taskListCompletedOfTotal', undefined, { completed, total });
+        return html `
+      <div part="base">
+        ${this.collapsible
+            ? html `
+              <button
+                part="header"
+                type="button"
+                id=${this.headerId}
+                aria-expanded=${this.expanded ? 'true' : 'false'}
+                aria-controls=${this.bodyId}
+                @click=${this.toggle}
+              >
+                <span part="toggle" aria-hidden="true">${chevronIcon()}</span>
+                <span part="label">${label}</span>
+                <span part="summary">${summary}</span>
+              </button>
+            `
+            : html `
+              <div part="header" id=${this.headerId}>
+                <span part="label">${label}</span>
+                <span part="summary">${summary}</span>
+              </div>
+            `}
+        <div part="body" id=${this.bodyId} role="list" aria-label=${label} ?hidden=${!this.expanded}>
+          ${this.items.map((item) => this.renderItem(item, 0))}
+        </div>
+        <lyra-live-region></lyra-live-region>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraTaskList.prototype, "items", void 0);
+__decorate([
+    property()
+], LyraTaskList.prototype, "label", void 0);
+__decorate([
+    property({ reflect: true, converter: trueDefaultBooleanConverter })
+], LyraTaskList.prototype, "expanded", void 0);
+__decorate([
+    property({ converter: trueDefaultBooleanConverter })
+], LyraTaskList.prototype, "collapsible", void 0);
+__decorate([
+    query('lyra-live-region')
+], LyraTaskList.prototype, "liveRegion", void 0);
+//# sourceMappingURL=task-list.class.js.map

package/dist/components/task-list/task-list.class.js.map

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

package/dist/components/task-list/task-list.d.ts

@@ -0,0 +1,2 @@
+export * from './task-list.class.js';
+//# sourceMappingURL=task-list.d.ts.map

package/dist/components/task-list/task-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.d.ts","sourceRoot":"","sources":["../../../src/components/task-list/task-list.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/components/task-list/task-list.js

@@ -0,0 +1,5 @@
+export * from './task-list.class.js';
+import { LyraTaskList } from './task-list.class.js';
+import { defineElement } from '../../internal/prefix.js';
+defineElement('task-list', LyraTaskList);
+//# sourceMappingURL=task-list.js.map

package/dist/components/task-list/task-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.js","sourceRoot":"","sources":["../../../src/components/task-list/task-list.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC"}

package/dist/components/task-list/task-list.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const styles: import("lit").CSSResult[];
+//# sourceMappingURL=task-list.styles.d.ts.map

package/dist/components/task-list/task-list.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.styles.d.ts","sourceRoot":"","sources":["../../../src/components/task-list/task-list.styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,2BAkIlB,CAAC"}

package/dist/components/task-list/task-list.styles.js

@@ -0,0 +1,134 @@
+import { css } from 'lit';
+import { srOnly } from '../../internal/a11y.js';
+export const styles = [
+    srOnly,
+    css `
+    :host {
+      display: block;
+      --lyra-task-list-spin: 1s linear;
+    }
+    [part='base'] {
+      border: var(--lyra-border-width-thin) solid var(--lyra-color-border);
+      border-radius: var(--lyra-radius);
+      background: var(--lyra-color-surface);
+      overflow: hidden;
+    }
+    [part='header'] {
+      display: flex;
+      align-items: center;
+      gap: var(--lyra-space-xs);
+      inline-size: 100%;
+      box-sizing: border-box;
+      padding: var(--lyra-space-s) var(--lyra-space-m);
+      border: none;
+      background: none;
+      color: var(--lyra-color-text);
+      font: inherit;
+      font-weight: var(--lyra-font-weight-semibold);
+      font-size: var(--lyra-font-size-md-sm);
+      text-align: start;
+    }
+    button[part='header'] {
+      cursor: pointer;
+    }
+    button[part='header']:hover {
+      background: var(--lyra-color-brand-quiet);
+      color: var(--lyra-color-brand);
+    }
+    button[part='header']:focus-visible {
+      outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+      outline-offset: calc(-1 * var(--lyra-focus-ring-offset));
+    }
+    [part='toggle'] {
+      display: inline-flex;
+      flex: 0 0 auto;
+      transition: transform var(--lyra-transition-fast);
+    }
+    :host([expanded]) [part='toggle'] {
+      transform: rotate(90deg);
+    }
+    :host(:not([expanded]):dir(rtl)) [part='toggle'] {
+      transform: scaleX(-1);
+    }
+    [part='label'] {
+      flex: 1 1 auto;
+      min-inline-size: 0;
+      overflow-wrap: anywhere;
+    }
+    [part='summary'] {
+      flex: 0 0 auto;
+      font-weight: var(--lyra-font-weight-normal);
+      font-size: var(--lyra-font-size-sm);
+      color: var(--lyra-color-text-quiet);
+    }
+    [part='body'] {
+      display: flex;
+      flex-direction: column;
+      gap: var(--lyra-space-s);
+      padding: var(--lyra-space-xs) var(--lyra-space-m) var(--lyra-space-m);
+      border-block-start: var(--lyra-border-width-thin) solid var(--lyra-color-border);
+    }
+    [part='body'][hidden] {
+      display: none;
+    }
+    [part='item'] {
+      display: flex;
+      flex-wrap: wrap;
+      align-items: baseline;
+      gap: var(--lyra-space-xs);
+    }
+    [part='item'][data-depth='1'] {
+      margin-inline-start: var(--lyra-space-l);
+    }
+    [part='item-children'] {
+      display: flex;
+      flex-direction: column;
+      gap: var(--lyra-space-s);
+      flex-basis: 100%;
+      margin-block-start: var(--lyra-space-xs);
+    }
+    [part='status-icon'] {
+      display: inline-flex;
+      flex: 0 0 auto;
+      color: var(--lyra-color-text-quiet);
+    }
+    [part='status-icon'] svg {
+      display: block;
+    }
+    [part='item'][data-status='running'] [part='status-icon'] {
+      color: var(--lyra-color-brand);
+    }
+    [part='item'][data-status='running'] [part='status-icon'] svg {
+      animation: lyra-task-list-spin var(--lyra-task-list-spin) infinite;
+    }
+    [part='item'][data-status='success'] [part='status-icon'] {
+      color: var(--lyra-color-success);
+    }
+    [part='item'][data-status='error'] [part='status-icon'] {
+      color: var(--lyra-color-danger);
+    }
+    [part='item-label'] {
+      flex: 1 1 auto;
+      min-inline-size: var(--lyra-size-6ch);
+    }
+    [part='item-detail'] {
+      flex-basis: 100%;
+      font-size: var(--lyra-font-size-sm);
+      color: var(--lyra-color-text-quiet);
+    }
+    @keyframes lyra-task-list-spin {
+      to {
+        transform: rotate(360deg);
+      }
+    }
+    @media (prefers-reduced-motion: reduce) {
+      [part='toggle'] {
+        transition: none !important;
+      }
+      [part='item'][data-status='running'] [part='status-icon'] svg {
+        animation: none !important;
+      }
+    }
+  `,
+];
+//# sourceMappingURL=task-list.styles.js.map

package/dist/components/task-list/task-list.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.styles.js","sourceRoot":"","sources":["../../../src/components/task-list/task-list.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM;IACN,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+HF;CACF,CAAC"}

package/dist/components/terminal/terminal.class.d.ts

@@ -0,0 +1,150 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { type AnsiStyles } from '../../internal/ansi.js';
+import type { LyraAnchor, LyraHighlight, HighlightActivateDetail, TextSelectDetail } from '../document-viewer/anchors.js';
+import '../virtual-list/virtual-list.js';
+export interface TerminalCell {
+    char: string;
+    styles: AnsiStyles;
+}
+export interface TerminalLine {
+    /** Absolute (1-based) line number since the last `clear()`/`content` assignment. Survives
+     *  scrollback trimming as a stable identity even though the line itself may later be trimmed. */
+    number: number;
+    cells: TerminalCell[];
+}
+export interface LyraTerminalEventMap {
+    'lyra-copy': CustomEvent<{
+        text: string;
+    }>;
+    'lyra-download': CustomEvent<{
+        filename: string;
+    }>;
+    'lyra-follow-change': CustomEvent<{
+        following: boolean;
+    }>;
+    'lyra-search-change': CustomEvent<{
+        query: string;
+        matchCount: number;
+        activeIndex: number;
+    }>;
+    'lyra-highlight-activate': CustomEvent<HighlightActivateDetail>;
+    'lyra-text-select': CustomEvent<TextSelectDetail>;
+}
+/**
+ * `<lyra-terminal>` — read-only ANSI console for streamed agent/tool output. Not a PTY: no
+ * stdin/keystroke handling, no cursor-addressed full-screen apps.
+ *
+ * @customElement lyra-terminal
+ * @event lyra-copy - `detail: { text }` — the copy button copied the SGR-stripped plain text.
+ * @event lyra-download - `detail: { filename }` — the download button triggered a Blob download.
+ * @event lyra-follow-change - `detail: { following }` — stick-to-bottom engaged/disengaged.
+ * @event lyra-search-change - `detail: { query, matchCount, activeIndex }`.
+ * @event lyra-highlight-activate - `detail: { id }` — a highlighted line was clicked/activated.
+ * @event lyra-text-select - `detail: { text, anchor, rects }` — fires on pointerup after a text
+ *   selection ending inside the viewport. `anchor` is `null` when either selection endpoint isn't
+ *   inside a currently-mounted (non-virtualized-out) line.
+ * @csspart base - The outer container.
+ * @csspart toolbar - The header row, only rendered when copy/download are enabled.
+ * @csspart copy-button - The copy-to-clipboard button.
+ * @csspart download-button - The download button.
+ * @csspart viewport - The `role="log"` scrollable region wrapping the virtualized line list.
+ * @csspart line - One rendered line; carries `data-line-number`, `data-match`, `data-highlight-tone`.
+ *   Rendered through `<lyra-virtual-list>`'s `renderItem`, so it lives inside that element's own
+ *   shadow root rather than this component's -- this component's own stylesheet reaches it via
+ *   `lyra-virtual-list::part(line)`, one hop of the standard CSS Shadow Parts selector.
+ * @csspart jump-to-latest - The pill shown while `follow` is disengaged and new output has arrived.
+ * @csspart announcer - The visually-hidden `role="status"` region used when `announce-output` is set.
+ */
+export declare class LyraTerminal extends LyraElement<LyraTerminalEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    content: string;
+    /** Line-count scrollback buffer limit. NaN/negative/oversized (e.g. `Infinity`) all normalize
+     *  through `finiteCount`, with a floor of 1 -- see `appendLine()`. */
+    maxScrollback: number;
+    follow: boolean;
+    wrap: boolean;
+    copyable: boolean;
+    downloadable: boolean;
+    filename: string;
+    announceOutput: boolean;
+    accessibleLabel: string;
+    highlights: LyraHighlight[];
+    activeHighlightId: string | null;
+    /** Feature-detectable capability mirror -- the same pattern `DocumentAnchorTarget`-adopting
+     *  viewers use for their own `anchorKinds` field. This component isn't document-viewer-registry-
+     *  routed, so it has no registry `capabilities.anchors` entry to declare this on instead. */
+    readonly anchorKinds: LyraAnchor['kind'][];
+    private lines;
+    private scrollTargetLineNumber;
+    private justCopied;
+    private buffer;
+    private lineSeq;
+    private column;
+    private readonly ansiParser;
+    private copyTimeoutId?;
+    /** Plain text appended since the last announcer flush -- coalesced so a burst of small
+     *  `write()` chunks (a common line-by-line stdout pattern) becomes one throttled announcement
+     *  instead of one per chunk. Reset in the announcer's own `onFlush` callback below, so it always
+     *  reflects exactly "what's new since the last thing actually spoken". */
+    private pendingAnnounceText;
+    private announceRegionEl?;
+    private readonly announcer;
+    private searchQuery;
+    private searchMatches;
+    private searchActiveIndex;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    protected willUpdate(changed: PropertyValues): void;
+    private resetBuffer;
+    private appendLine;
+    private putChar;
+    private applyChunk;
+    private writeInternal;
+    /** Append streamed output. Escape sequences may split across chunks -- the shared parser buffers
+     *  partial sequences internally. */
+    write(chunk: string): void;
+    clear(): void;
+    getPlainText(): string;
+    scrollToBottom(): void;
+    private jumpToLatest;
+    private recomputeSearchMatches;
+    private emitSearchChange;
+    private jumpToActiveMatch;
+    search(query: string): Promise<number>;
+    searchNext(): void;
+    searchPrevious(): void;
+    clearSearch(): void;
+    private highlightForLine;
+    private activateHighlight;
+    private onLineKeyDown;
+    scrollToAnchor(target: LyraAnchor | string): Promise<boolean>;
+    private onCopy;
+    private onDownload;
+    private onVisibleRangeChanged;
+    private onViewportKeyDown;
+    /** Best-effort: resolves a user text selection ending inside the viewport into `lyra-text-select`.
+     *  Walks each selection endpoint up to its nearest `[data-line-number]` ancestor to build a
+     *  `line-range` anchor; `anchor` is `null` when either endpoint isn't inside a currently-mounted
+     *  line (virtualized out, or the selection reaches outside the viewport entirely) -- matching
+     *  `TextSelectDetail`'s own documented "`anchor` is `null` when the selection couldn't be
+     *  anchored" case, shared by every anchor-capable viewer. Cross-shadow-boundary text selection
+     *  has known browser-support variance; this degrades to no event firing rather than a broken one
+     *  when the platform doesn't expose a usable Selection here. */
+    private onViewportPointerUp;
+    /** Per-line state styling (cursor, search-match outline, highlight-tone background). Applied
+     *  inline rather than through `data-match`/`data-highlight-tone` stylesheet selectors, since those
+     *  attributes live on the same element `part="line"` names -- and a `::part()` selector (needed to
+     *  reach across `<lyra-virtual-list>`'s shadow boundary, see `terminal.styles.ts`) cannot be
+     *  combined with a trailing attribute selector the way a same-shadow-root rule could. */
+    private lineStateStyle;
+    private renderLine;
+    private segmentStyle;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-terminal': LyraTerminal;
+    }
+}
+//# sourceMappingURL=terminal.class.d.ts.map

package/dist/components/terminal/terminal.class.d.ts.map

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