@aceshooting/lyra-ui 1.1.0 → 2.0.0

package/dist/components/chat-composer/chat-composer.js

@@ -0,0 +1,285 @@
+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, svg } from 'lit';
+import { property, state, query } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { FormAssociated } from '../../internal/form-associated.js';
+import { defineElement } from '../../internal/prefix.js';
+import { styles } from './chat-composer.styles.js';
+// Mirrors the shared icon set's viewBox/stroke conventions
+// (internal/icons.ts's chevronIcon()/closeIcon()/etc.) without adding
+// send/stop glyphs to that module -- it's off limits here -- so these
+// one-off icons still read as part of the same visual language as the rest
+// of the library's inline icons. Same approach lyra-checkbox's and
+// lyra-chat-message's own local glyphs take for the identical reason.
+const ICON_VIEW_BOX = '0 0 24 24';
+const ICON_STROKE_WIDTH = '1.75';
+function sendIcon() {
+    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"
+    ><line x1="22" y1="2" x2="11" y2="13"></line><polygon points="22 2 15 22 11 13 2 9 22 2"></polygon></svg>
+  `;
+}
+/** A filled square -- the conventional "stop generating" glyph. */
+function stopIcon() {
+    return svg `
+    <svg
+      width="1em"
+      height="1em"
+      viewBox=${ICON_VIEW_BOX}
+      fill="currentColor"
+      stroke="none"
+      aria-hidden="true"
+      focusable="false"
+    ><rect x="6" y="6" width="12" height="12" rx="1.5"></rect></svg>
+  `;
+}
+/**
+ * `<lyra-chat-composer>` — the message input for a chat/agent conversation
+ * surface: an auto-resizing textarea plus a send/stop button. Form-
+ * associated via the `FormAssociated` mixin (see `<lyra-date-input>` for the
+ * same shape), so it participates in native `<form>` submission/validation/
+ * reset like any other text control — `name`/`value`/`disabled`/`required`/
+ * `checkValidity()`/`reportValidity()` all come from that mixin.
+ *
+ * Auto-resize reads the textarea's own *computed* line-height/padding/
+ * border at runtime (`resizeTextarea()`) rather than assuming a fixed
+ * px-per-row constant, so it stays correct under a consumer's own font-size/
+ * line-height overrides. It grows between `min-rows` and `max-rows`, then
+ * switches to internal scrolling.
+ *
+ * Enter-to-send (only active while `submit-on-enter` is true, the default):
+ * plain Enter submits and is prevented from inserting a newline; Shift+Enter
+ * always inserts a newline no matter what; an IME composition step (checked
+ * via `isComposing`, with `keyCode === 229` as a defense-in-depth fallback
+ * for browsers that report `isComposing` inconsistently on the
+ * compositionend-adjacent keydown) is never treated as a submit trigger;
+ * and while `status` isn't `"idle"` Enter is left alone to insert a newline
+ * too, rather than trying to submit again -- there is nothing meaningful to
+ * submit while a previous message is still sending/streaming, and the
+ * textarea deliberately stays interactive (see `disabled` below) so a user
+ * can keep composing their next message in the meantime.
+ *
+ * `lyra-submit`'s `detail.value` is always the exact, untrimmed current
+ * value (`detail.value === value` at the moment it fires) -- trimming is
+ * left to the consumer so it never silently diverges from what `value`
+ * itself reports. Submitting does not clear `value`; the consumer clears it
+ * once the submission has actually been accepted (so e.g. a failed send can
+ * leave the text in place for retry).
+ *
+ * @customElement lyra-chat-composer
+ * @slot leading - Content rendered before the textarea (e.g. an attach-file trigger button).
+ * @slot chips - An attachment tray rendered above the input row (e.g. files queued for this message).
+ * @slot trailing - Overrides the built-in send/stop button entirely when it has assigned content.
+ * @event lyra-input - Fired on every user-driven edit of the textarea (not a programmatic `.value` assignment). `detail: { value }`.
+ * @event lyra-submit - Fired by Enter (per `submit-on-enter`) or the built-in button while `status="idle"`. `detail: { value }`.
+ * @event lyra-stop - Fired by the built-in button while `status` is `"sending"` or `"streaming"`. No detail.
+ * @csspart base - The bordered root container.
+ * @csspart chips - The wrapper around the `chips` slot. Hidden entirely when the slot is empty.
+ * @csspart row - The row holding the leading slot, textarea, and trailing slot/button.
+ * @csspart leading - The wrapper around the `leading` slot. Hidden entirely when the slot is empty.
+ * @csspart textarea - The auto-resizing `<textarea>` itself.
+ * @csspart trailing - The wrapper around the `trailing` slot and the built-in `action-button`.
+ * @csspart action-button - The built-in send/stop button. Absent from the accessibility tree's meaningful content whenever `trailing` has assigned content. Style its busy treatment via `:host([status='sending'])`/`:host([status='streaming'])`.
+ */
+export class LyraChatComposer extends FormAssociated(LyraElement) {
+    constructor() {
+        super(...arguments);
+        this.placeholder = '';
+        this.minRows = 1;
+        this.maxRows = 8;
+        this.status = 'idle';
+        this.submitOnEnter = true;
+        this.hasLeadingSlot = false;
+        this.hasChipsSlot = false;
+        this.hasTrailingSlot = false;
+        this.onTextareaInput = (e) => {
+            this.value = e.target.value;
+            this.emit('lyra-input', { value: this.value });
+        };
+        this.onTextareaKeyDown = (e) => {
+            if (e.key !== 'Enter')
+                return;
+            // Shift+Enter always inserts a newline, regardless of submit-on-enter --
+            // leave the browser's own default action alone.
+            if (e.shiftKey)
+                return;
+            // submit-on-enter="false": Enter always inserts a newline too.
+            if (!this.submitOnEnter)
+                return;
+            // An IME composition step (e.g. confirming a Japanese/Chinese/Korean
+            // candidate) must never be treated as "the user pressed Enter to send" --
+            // keyCode 229 is a defense-in-depth fallback for browsers that report
+            // isComposing inconsistently on the compositionend-adjacent keydown.
+            if (e.isComposing || e.keyCode === 229)
+                return;
+            // Nothing meaningful to (re-)submit while already sending/streaming --
+            // fall through to the default newline insertion instead, so the
+            // textarea stays a normal place to keep composing the next message.
+            if (this.status !== 'idle')
+                return;
+            e.preventDefault();
+            this.submit();
+        };
+        this.onActionClick = () => {
+            if (this.effectiveDisabled)
+                return;
+            if (this.status === 'idle') {
+                this.submit();
+            }
+            else {
+                this.emit('lyra-stop');
+            }
+        };
+        this.onLeadingSlotChange = (e) => {
+            this.hasLeadingSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onChipsSlotChange = (e) => {
+            this.hasChipsSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onTrailingSlotChange = (e) => {
+            this.hasTrailingSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate() {
+        if (!this.hasUpdated) {
+            this.hasLeadingSlot = this.hasSlotted('leading');
+            this.hasChipsSlot = this.hasSlotted('chips');
+            this.hasTrailingSlot = this.hasSlotted('trailing');
+        }
+    }
+    firstUpdated(changed) {
+        super.firstUpdated(changed);
+        this.resizeTextarea();
+    }
+    updated(changed) {
+        super.updated(changed);
+        if (changed.has('value') || changed.has('minRows') || changed.has('maxRows')) {
+            this.resizeTextarea();
+        }
+    }
+    hasSlotted(name) {
+        return Array.from(this.children).some((el) => el.getAttribute('slot') === name);
+    }
+    /**
+     * Grows/shrinks the textarea between `min-rows` and `max-rows`, reading
+     * the *computed* line-height/padding/border back out of the element at
+     * call time instead of assuming a fixed px-per-row figure -- correct
+     * whatever font-size/line-height a consumer's own CSS ends up applying.
+     * Past `max-rows` the box stops growing and switches to internal
+     * scrolling (`overflow-y: auto`).
+     */
+    resizeTextarea() {
+        const ta = this.textareaEl;
+        if (!ta)
+            return;
+        const cs = getComputedStyle(ta);
+        const lineHeight = parseFloat(cs.lineHeight) || parseFloat(cs.fontSize) * 1.2;
+        const paddingBlock = parseFloat(cs.paddingTop) + parseFloat(cs.paddingBottom);
+        const borderBlock = parseFloat(cs.borderTopWidth) + parseFloat(cs.borderBottomWidth);
+        const minRows = Math.max(1, this.minRows || 1);
+        const maxRows = Math.max(minRows, this.maxRows || minRows);
+        const minHeight = lineHeight * minRows + paddingBlock + borderBlock;
+        const maxHeight = lineHeight * maxRows + paddingBlock + borderBlock;
+        // Collapse first so a shrinking edit (e.g. deleting a wrapped line)
+        // reports its true scrollHeight rather than the previous, taller,
+        // explicitly-set height.
+        ta.style.height = 'auto';
+        // scrollHeight never includes border, so it's added back in to compare
+        // apples-to-apples against min/maxHeight, both of which are border-box
+        // figures (this component inherits box-sizing: border-box from
+        // LyraElement's tokens.styles.ts).
+        const contentHeight = ta.scrollHeight + borderBlock;
+        const next = Math.min(Math.max(contentHeight, minHeight), maxHeight);
+        ta.style.height = `${next}px`;
+        ta.style.overflowY = contentHeight > maxHeight ? 'auto' : 'hidden';
+    }
+    submit() {
+        this.emit('lyra-submit', { value: this.value });
+    }
+    renderActionButton() {
+        const busy = this.status !== 'idle';
+        return html `
+      <button
+        part="action-button"
+        type="button"
+        aria-label=${busy ? 'Stop generating' : 'Send message'}
+        ?disabled=${this.effectiveDisabled}
+        @click=${this.onActionClick}
+      >
+        ${busy ? stopIcon() : sendIcon()}
+      </button>
+    `;
+    }
+    render() {
+        return html `
+      <div part="base">
+        <div part="chips" ?hidden=${!this.hasChipsSlot}>
+          <slot name="chips" @slotchange=${this.onChipsSlotChange}></slot>
+        </div>
+        <div part="row">
+          <span part="leading" ?hidden=${!this.hasLeadingSlot}>
+            <slot name="leading" @slotchange=${this.onLeadingSlotChange}></slot>
+          </span>
+          <textarea
+            part="textarea"
+            aria-label=${this.placeholder || 'Message'}
+            .value=${this.value}
+            placeholder=${this.placeholder}
+            rows=${Math.max(1, this.minRows || 1)}
+            ?disabled=${this.effectiveDisabled}
+            @input=${this.onTextareaInput}
+            @keydown=${this.onTextareaKeyDown}
+          ></textarea>
+          <span part="trailing">
+            <slot name="trailing" @slotchange=${this.onTrailingSlotChange}></slot>
+            ${this.hasTrailingSlot ? nothing : this.renderActionButton()}
+          </span>
+        </div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property()
+], LyraChatComposer.prototype, "placeholder", void 0);
+__decorate([
+    property({ type: Number, attribute: 'min-rows' })
+], LyraChatComposer.prototype, "minRows", void 0);
+__decorate([
+    property({ type: Number, attribute: 'max-rows' })
+], LyraChatComposer.prototype, "maxRows", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraChatComposer.prototype, "status", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'submit-on-enter' })
+], LyraChatComposer.prototype, "submitOnEnter", void 0);
+__decorate([
+    state()
+], LyraChatComposer.prototype, "hasLeadingSlot", void 0);
+__decorate([
+    state()
+], LyraChatComposer.prototype, "hasChipsSlot", void 0);
+__decorate([
+    state()
+], LyraChatComposer.prototype, "hasTrailingSlot", void 0);
+__decorate([
+    query('textarea')
+], LyraChatComposer.prototype, "textareaEl", void 0);
+defineElement('chat-composer', LyraChatComposer);

package/dist/components/chat-composer/chat-composer.styles.d.ts

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

package/dist/components/chat-composer/chat-composer.styles.js

@@ -0,0 +1,135 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: block;
+  }
+  [part='base'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--lyra-space-xs);
+    box-sizing: border-box;
+    border: 1px solid var(--lyra-color-border);
+    border-radius: var(--lyra-radius);
+    background: var(--lyra-color-surface);
+    padding: var(--lyra-space-s);
+    transition: border-color var(--lyra-transition-fast);
+  }
+  [part='base']:focus-within {
+    border-color: var(--lyra-color-brand);
+  }
+  :host([disabled]) [part='base'] {
+    opacity: var(--lyra-opacity-disabled);
+    cursor: not-allowed;
+  }
+
+  /* :empty never matches [part='chips'] -- it always contains a literal
+     <slot> child regardless of assigned content -- so real emptiness is
+     tracked in JS (hasChipsSlot) and reflected via [hidden] instead (same
+     fix as lyra-date-input's hint/error parts). Author-level display rules
+     always beat the UA stylesheet's [hidden] rule regardless of source
+     order/specificity (different cascade origins), so the override below is
+     required, not redundant. */
+  [part='chips'] {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--lyra-space-xs);
+  }
+  [part='chips'][hidden] {
+    display: none;
+  }
+
+  [part='row'] {
+    display: flex;
+    align-items: flex-end;
+    gap: var(--lyra-space-s);
+  }
+
+  [part='leading'] {
+    display: flex;
+    flex: 0 0 auto;
+    align-items: center;
+    /* Matches the textarea's own first-line box so a leading icon button
+       sits level with placeholder/typed text at min-rows, not glued to the
+       row's cross-axis edge. */
+    padding-block-end: var(--lyra-space-xs);
+  }
+  [part='leading'][hidden] {
+    display: none;
+  }
+
+  [part='textarea'] {
+    flex: 1 1 auto;
+    min-inline-size: 0;
+    box-sizing: border-box;
+    resize: none;
+    border: none;
+    outline: none;
+    background: transparent;
+    color: inherit;
+    font: inherit;
+    /* A concrete, unitless line-height so the runtime auto-resize logic
+       (chat-composer.ts's resizeTextarea()) can read a real pixel value
+       back out of getComputedStyle() -- the UA default of "normal" has no
+       single resolved px figure to measure rows against. */
+    line-height: 1.5;
+    padding-block: var(--lyra-space-xs);
+    overflow-y: hidden;
+  }
+  [part='textarea']::placeholder {
+    color: var(--lyra-color-text-quiet);
+  }
+  [part='textarea']:disabled {
+    cursor: not-allowed;
+  }
+
+  [part='trailing'] {
+    display: flex;
+    flex: 0 0 auto;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+  }
+
+  [part='action-button'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: 0 0 auto;
+    box-sizing: border-box;
+    min-inline-size: var(--lyra-icon-button-size);
+    min-block-size: var(--lyra-icon-button-size);
+    border: none;
+    border-radius: var(--lyra-radius);
+    background: var(--lyra-color-brand);
+    color: var(--lyra-color-on-brand);
+    font-size: 1.125rem;
+    line-height: 1;
+    cursor: pointer;
+    transition: background-color var(--lyra-transition-fast);
+  }
+  [part='action-button']:hover {
+    background: var(--lyra-color-brand);
+    filter: brightness(1.1);
+  }
+  [part='action-button']:focus-visible {
+    outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+    outline-offset: var(--lyra-focus-ring-offset);
+  }
+  [part='action-button']:disabled {
+    cursor: not-allowed;
+    opacity: var(--lyra-opacity-disabled);
+  }
+  /* Stop affordance while generating -- a neutral/quiet treatment rather
+     than the resting brand fill, so it doesn't read as "send is still
+     available" while a response is in flight. */
+  :host([status='sending']) [part='action-button'],
+  :host([status='streaming']) [part='action-button'] {
+    background: var(--lyra-color-text-quiet);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [part='base'],
+    [part='action-button'] {
+      transition: none !important;
+    }
+  }
+`;

package/dist/components/chat-message/chat-message.d.ts

@@ -0,0 +1,113 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import '../live-region/live-region.js';
+export type ChatMessageRole = 'user' | 'assistant' | 'system';
+export type ChatMessageStatus = 'sending' | 'sent' | 'failed' | 'streaming';
+/**
+ * `<lyra-chat-message>` — a role-based message bubble *shell* for a chat/
+ * agent conversation surface. It renders none of the message content itself:
+ * the default slot carries whatever a consumer wants to display (plain
+ * text, a `<lyra-markdown>`, a custom template, anything at all) and this
+ * component only supplies the surrounding chrome — alignment/coloring by
+ * `role`, an avatar/badges header row, an optional collapse toggle, an
+ * attachments strip, and a status-aware footer (a live-updating status dot +
+ * text, the formatted `timestamp`, a built-in retry affordance for
+ * `status="failed"`, and an `actions` slot for everything else).
+ *
+ * No built-in copy button is rendered. Deciding what "the copyable text" of
+ * an arbitrary slotted message even means (plain text? the rendered
+ * markdown source? something else?) is exactly the kind of content
+ * interpretation this shell deliberately stays out of — slot a copy control
+ * into `actions` instead. Firing `lyra-copy` (`detail: { text }`) from that
+ * control keeps the event name consistent with `<lyra-json-viewer>`'s own
+ * copy affordance, for anything listening at the conversation-surface level.
+ *
+ * Accessibility of `status`: the current status is always available as
+ * plain visible text (`[part="status-text"]`), never color alone. A
+ * transition *to* `"failed"`, or *from* `"streaming"` to `"sent"` (a stream
+ * finishing), is additionally announced through an internal
+ * `<lyra-live-region>` (see that component's header for the throttled-
+ * announcement wiring this composes) so a screen-reader user who isn't
+ * currently focused on this message still learns about it. This differs
+ * from `<lyra-typing-indicator>`'s deliberately simpler `role="status"`
+ * approach — that component only ever has one thing to announce (its own
+ * mount); this one has a `status` that can flip between several values
+ * across a single element's lifetime, which is exactly the coalescing job
+ * `<lyra-live-region>` exists for.
+ *
+ * `role` is a message-author role (`user`/`assistant`/`system`, matching
+ * the vocabulary of every chat/completion API), *not* a WAI-ARIA role, so
+ * it reflects to a `data-role` attribute rather than the bare `role`
+ * attribute — `role="user"` would collide with `Element`'s own ARIA `role`
+ * accessor and is not a valid ARIA role token to begin with.
+ *
+ * @customElement lyra-chat-message
+ * @slot - The message body.
+ * @slot avatar - An avatar/icon for the message author.
+ * @slot badges - Small status/metric chips (e.g. token count, latency, model name) — entirely app-supplied; this component computes none of that itself.
+ * @slot actions - Action controls (e.g. copy, retry), rendered at the end of the footer.
+ * @slot attachments - File/image attachment chips, rendered below the message body.
+ * @event lyra-retry - Fired by the built-in retry button, only rendered when `status="failed"`.
+ * @event lyra-collapse-toggle - `detail: boolean` (the new `collapsed` state) — fired when the user activates the built-in collapse button.
+ * @csspart bubble - The message bubble root.
+ * @csspart header - The row above the message body — avatar, badges, and the collapse toggle. Hidden entirely when none of those have anything to show.
+ * @csspart avatar - The wrapper around the `avatar` slot.
+ * @csspart badges - The wrapper around the `badges` slot.
+ * @csspart collapse-button - The built-in collapse/expand toggle (only rendered when `collapsible`).
+ * @csspart body - The wrapper around the default slot (the message content). Hidden while `collapsed`.
+ * @csspart attachments - The wrapper around the `attachments` slot.
+ * @csspart footer - The row below the message body — status, timestamp, retry, and actions. Hidden entirely when none of those have anything to show.
+ * @csspart status-indicator - A small decorative (`aria-hidden`) dot reflecting `status`; absent while `status="sent"`.
+ * @csspart status-text - The visible text twin of `status-indicator` — carries the state in text, not just color.
+ * @csspart timestamp - The formatted `timestamp`, rendered in a `<time>` element.
+ * @csspart retry-button - The built-in retry button (only rendered when `status="failed"`).
+ * @csspart actions - The wrapper around the `actions` slot.
+ */
+export declare class LyraChatMessage extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** Who authored the message. Reflects to `data-role` — see the class doc. */
+    role: ChatMessageRole;
+    /** Delivery/generation state. Drives the footer's status dot/text and, for
+     *  `"failed"`, the bubble's danger treatment and the built-in retry button. */
+    status: ChatMessageStatus;
+    /** When the message was sent/received. Accepts a `Date` or anything
+     *  `new Date()` can parse (e.g. an ISO 8601 string); invalid input is
+     *  treated the same as unset (no timestamp rendered). */
+    timestamp?: Date | string;
+    /** Overrides the default `hour:minute` rendering of `timestamp` — this
+     *  library has no i18n system of its own, so an overridable formatter is
+     *  the established way to hand locale-sensitive display back to the
+     *  consumer (mirrors `lyra-heatmap`'s `cellText`). */
+    formatTimestamp?: (date: Date) => string;
+    /** Shows the built-in collapse/expand toggle in the header. */
+    collapsible: boolean;
+    /** Whether the message body is currently hidden. Effective whenever set,
+     *  independent of `collapsible` — `collapsible` only controls whether the
+     *  built-in toggle button is rendered, mirroring `lyra-widget`'s identical
+     *  `collapsible`/`collapsed` pair. */
+    collapsed: boolean;
+    private hasAvatarSlot;
+    private hasBadgesSlot;
+    private hasAttachmentsSlot;
+    private hasActionsSlot;
+    private liveRegion?;
+    private readonly bodyId;
+    protected willUpdate(): void;
+    protected updated(changed: PropertyValues): void;
+    private hasSlotted;
+    private get normalizedTimestamp();
+    private get statusText();
+    private announceStatusChange;
+    private onAvatarSlotChange;
+    private onBadgesSlotChange;
+    private onAttachmentsSlotChange;
+    private onActionsSlotChange;
+    private toggleCollapsed;
+    private onRetryClick;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-chat-message': LyraChatMessage;
+    }
+}