@aceshooting/lyra-ui 1.2.0 → 2.0.0

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

@@ -0,0 +1,203 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: block;
+    /* Component-specific -- no shared --wa-*/--lyra-* "conversation bubble
+       width" token exists to resolve through, same rationale as
+       --lyra-json-viewer-max-height in json-viewer.styles.ts. */
+    --lyra-chat-message-max-width: 80%;
+    font-size: 0.875rem;
+    line-height: 1.5;
+  }
+  [part='bubble'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--lyra-space-xs);
+    max-inline-size: var(--lyra-chat-message-max-width);
+    padding: var(--lyra-space-m);
+    border: 1px solid var(--lyra-color-border);
+    border-radius: var(--lyra-radius);
+    background: var(--lyra-color-surface);
+    overflow-wrap: anywhere;
+  }
+
+  /* -- role ---------------------------------------------------------------
+     The role property reflects to 'data-role' rather than the bare 'role'
+     attribute -- see the class doc for why -- so these selectors key off
+     'data-role'. */
+  :host([data-role='user']) [part='bubble'] {
+    margin-inline-start: auto;
+    background: var(--lyra-color-brand-quiet);
+    border-color: transparent;
+  }
+  :host([data-role='assistant']) [part='bubble'] {
+    margin-inline-end: auto;
+  }
+  :host([data-role='system']) [part='bubble'] {
+    margin-inline-end: auto;
+    color: var(--lyra-color-text-quiet);
+    font-style: italic;
+    border-style: dashed;
+  }
+
+  /* -- status ---------------------------------------------------------------
+     'failed' gets an unmistakable treatment that does not rely on color
+     alone (see [part='status-text']); 'streaming' is a quieter accent plus
+     the pulsing dot below. */
+  :host([status='failed']) [part='bubble'] {
+    border-color: var(--lyra-color-danger);
+    background: var(--lyra-color-danger-quiet);
+  }
+  :host([status='streaming']) [part='bubble'] {
+    border-color: var(--lyra-color-brand);
+  }
+
+  [part='header'] {
+    display: flex;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+  }
+  [part='header'][hidden],
+  [part='avatar'][hidden],
+  [part='badges'][hidden],
+  [part='attachments'][hidden],
+  [part='footer'][hidden],
+  [part='actions'][hidden],
+  [part='body'][hidden] {
+    display: none;
+  }
+  [part='avatar'] {
+    flex: 0 0 auto;
+    display: inline-flex;
+  }
+  [part='badges'] {
+    flex: 1 1 auto;
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+    min-inline-size: 0;
+  }
+  [part='collapse-button'] {
+    flex: 0 0 auto;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-inline-size: var(--lyra-icon-button-size);
+    min-block-size: var(--lyra-icon-button-size);
+    margin-inline-start: auto;
+    border: none;
+    background: transparent;
+    color: var(--lyra-color-text-quiet);
+    border-radius: var(--lyra-radius);
+    cursor: pointer;
+  }
+  [part='collapse-button']:hover {
+    background: var(--lyra-color-brand-quiet);
+    color: var(--lyra-color-brand);
+  }
+  [part='collapse-button']:focus-visible,
+  [part='retry-button']:focus-visible {
+    outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+    outline-offset: var(--lyra-focus-ring-offset);
+  }
+  [part='collapse-button'] .chevron {
+    display: inline-flex;
+    transition: transform var(--lyra-transition-fast);
+  }
+
+  [part='attachments'] {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--lyra-space-xs);
+  }
+
+  [part='footer'] {
+    display: flex;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+    font-size: 0.75rem;
+    color: var(--lyra-color-text-quiet);
+  }
+  [part='actions'] {
+    display: flex;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+    margin-inline-start: auto;
+  }
+  [part='timestamp'] {
+    white-space: nowrap;
+  }
+  /* [part='timestamp']/[part='actions'] inherit the footer's own quiet
+     text color by default; against the danger-quiet bubble background a
+     'failed' message gets underneath it, that muted color's contrast ratio
+     drops below 4.5:1 (verified via axe's color-contrast rule), so the
+     whole footer switches to the same --lyra-color-danger already used for
+     [part='status-text'] instead. */
+  :host([status='failed']) [part='footer'] {
+    color: var(--lyra-color-danger);
+  }
+
+  [part='status-indicator'] {
+    flex: 0 0 auto;
+    inline-size: 0.5rem;
+    block-size: 0.5rem;
+    border-radius: 50%;
+    background: var(--lyra-color-text-quiet);
+  }
+  :host([status='streaming']) [part='status-indicator'] {
+    background: var(--lyra-color-brand);
+    animation: lyra-chat-message-pulse 1.5s ease-in-out infinite;
+  }
+  :host([status='failed']) [part='status-indicator'] {
+    background: var(--lyra-color-danger);
+  }
+  [part='status-text'] {
+    white-space: nowrap;
+  }
+  :host([status='failed']) [part='status-text'] {
+    color: var(--lyra-color-danger);
+    font-weight: 600;
+  }
+  @keyframes lyra-chat-message-pulse {
+    0%,
+    100% {
+      opacity: 1;
+    }
+    50% {
+      opacity: 0.35;
+    }
+  }
+
+  [part='retry-button'] {
+    flex: 0 0 auto;
+    display: inline-flex;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+    padding: 0.125rem var(--lyra-space-xs);
+    border: 1px solid var(--lyra-color-danger);
+    border-radius: var(--lyra-radius);
+    background: transparent;
+    color: var(--lyra-color-danger);
+    font: inherit;
+    font-size: 0.75rem;
+    cursor: pointer;
+  }
+  [part='retry-button']:hover {
+    background: var(--lyra-color-danger-quiet);
+  }
+  [part='retry-button'] svg {
+    inline-size: 0.875em;
+    block-size: 0.875em;
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [part='status-indicator'] {
+      animation: none !important;
+      opacity: 1;
+    }
+    [part='collapse-button'] .chevron {
+      transition: none !important;
+    }
+  }
+`;

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

@@ -0,0 +1,59 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+/**
+ * `<lyra-checkbox>` — a boolean form control. Structurally the same idea as
+ * `<lyra-switch>` (form-associated via `ElementInternals`, click and
+ * Space/Enter both toggle) but with checkbox semantics: `role="checkbox"` +
+ * an `aria-checked` that can also be `"mixed"`, and a visual box/checkmark
+ * instead of a track/thumb.
+ *
+ * `checked` is not a plain string, so this attaches `ElementInternals`
+ * directly and implements its own `updateValidity()` rather than using the
+ * `FormAssociated` mixin — see `<lyra-combobox>` for the same
+ * direct-`ElementInternals` shape with a non-string value.
+ *
+ * @customElement lyra-checkbox
+ * @slot - Label text, rendered next to the box. Clicking it toggles the
+ * checkbox, the same as clicking a native checkbox's associated `<label>`.
+ * If left empty, set `aria-label` on the host so the control still has an
+ * accessible name.
+ * @event lyra-change - The user toggled the checkbox (click or Space/Enter).
+ * `detail: { checked }`. Not fired for a programmatic `.checked` assignment.
+ * @csspart base - The whole interactive control (`role="checkbox"`); wraps the box and label.
+ * @csspart box - The small square that shows the checkmark/indeterminate dash.
+ * @csspart checkmark - The checkmark (or indeterminate dash) glyph inside the box.
+ * @csspart label - The wrapper around the default slot.
+ */
+export declare class LyraCheckbox extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    static formAssociated: boolean;
+    checked: boolean;
+    indeterminate: boolean;
+    disabled: boolean;
+    required: boolean;
+    name: string;
+    value: string;
+    private hasLabelSlot;
+    private internals;
+    private _defaultChecked;
+    private _defaultCaptured;
+    constructor();
+    connectedCallback(): void;
+    protected willUpdate(): void;
+    private updateValidity;
+    protected updated(changed: PropertyValues): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    private toggle;
+    private onClick;
+    private onKeyDown;
+    private onSlotChange;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-checkbox': LyraCheckbox;
+    }
+}

package/dist/components/checkbox/checkbox.js

@@ -0,0 +1,230 @@
+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, state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { defineElement } from '../../internal/prefix.js';
+import { styles } from './checkbox.styles.js';
+// Mirrors the shared icon set's viewBox/stroke conventions
+// (internal/icons.ts's chevronIcon()/closeIcon()/etc.) without importing
+// that module — it's off limits here — so the glyph still reads as part of
+// the same visual language as the rest of the library's inline icons.
+const GLYPH_VIEW_BOX = '0 0 24 24';
+const GLYPH_STROKE_WIDTH = '1.75';
+function checkmarkGlyph() {
+    return svg `
+    <svg
+      part="checkmark"
+      width="1em"
+      height="1em"
+      viewBox=${GLYPH_VIEW_BOX}
+      fill="none"
+      stroke="currentColor"
+      stroke-width=${GLYPH_STROKE_WIDTH}
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+      focusable="false"
+    ><polyline points="5 12.5 10 17.5 19 6.5"></polyline></svg>
+  `;
+}
+/** The indeterminate/mixed-state dash — takes priority over the checkmark. */
+function indeterminateGlyph() {
+    return svg `
+    <svg
+      part="checkmark"
+      width="1em"
+      height="1em"
+      viewBox=${GLYPH_VIEW_BOX}
+      fill="none"
+      stroke="currentColor"
+      stroke-width=${GLYPH_STROKE_WIDTH}
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+      focusable="false"
+    ><line x1="5" y1="12" x2="19" y2="12"></line></svg>
+  `;
+}
+/**
+ * `<lyra-checkbox>` — a boolean form control. Structurally the same idea as
+ * `<lyra-switch>` (form-associated via `ElementInternals`, click and
+ * Space/Enter both toggle) but with checkbox semantics: `role="checkbox"` +
+ * an `aria-checked` that can also be `"mixed"`, and a visual box/checkmark
+ * instead of a track/thumb.
+ *
+ * `checked` is not a plain string, so this attaches `ElementInternals`
+ * directly and implements its own `updateValidity()` rather than using the
+ * `FormAssociated` mixin — see `<lyra-combobox>` for the same
+ * direct-`ElementInternals` shape with a non-string value.
+ *
+ * @customElement lyra-checkbox
+ * @slot - Label text, rendered next to the box. Clicking it toggles the
+ * checkbox, the same as clicking a native checkbox's associated `<label>`.
+ * If left empty, set `aria-label` on the host so the control still has an
+ * accessible name.
+ * @event lyra-change - The user toggled the checkbox (click or Space/Enter).
+ * `detail: { checked }`. Not fired for a programmatic `.checked` assignment.
+ * @csspart base - The whole interactive control (`role="checkbox"`); wraps the box and label.
+ * @csspart box - The small square that shows the checkmark/indeterminate dash.
+ * @csspart checkmark - The checkmark (or indeterminate dash) glyph inside the box.
+ * @csspart label - The wrapper around the default slot.
+ */
+export class LyraCheckbox extends LyraElement {
+    static { this.styles = [LyraElement.styles, styles]; }
+    static { this.formAssociated = true; }
+    constructor() {
+        super();
+        this.checked = false;
+        // Visual-only mixed state, matching native `<input type="checkbox">`
+        // semantics: it does not affect `checked`'s own value, and a user
+        // interaction (click/keyboard) clears it back to `false`, exactly like the
+        // native control does.
+        this.indeterminate = false;
+        this.disabled = false;
+        this.required = false;
+        this.name = '';
+        this.value = 'on';
+        // Tracks whether the default slot carries any real (non-whitespace)
+        // content, so the label wrapper — and the gap next to the box — can
+        // collapse to nothing for an icon-only/aria-label-only checkbox instead of
+        // leaving a stray empty gap. See lyra-switch's identical field for why
+        // `assignedNodes` (not `assignedElements`) is checked — the common case is
+        // a bare slotted text label, e.g. `<lyra-checkbox>Accept terms</lyra-checkbox>`.
+        this.hasLabelSlot = false;
+        // What `form.reset()` restores to — captured once, from whatever `checked`
+        // reads at first connect (i.e. whatever the declarative `checked`
+        // attribute parsed to, since attribute parsing happens before
+        // `connectedCallback`). `checked` reflects, so unlike `FormAssociated`'s
+        // non-reflecting `value` this can't be captured from
+        // `attributeChangedCallback` alone — that would also fire (and wrongly
+        // redefine the default) every time the property setter reflects a later
+        // user toggle back into the attribute. Guarding with a one-shot flag
+        // instead mirrors `<lyra-combobox>`'s `_defaultCaptured`/`_defaultSelected`
+        // and `<lyra-switch>`'s identical `_defaultChecked`.
+        this._defaultChecked = false;
+        this._defaultCaptured = false;
+        this.onClick = () => {
+            this.toggle();
+        };
+        this.onKeyDown = (e) => {
+            if (this.disabled)
+                return;
+            // Space/Enter both activate, matching lyra-switch's onKeyDown (and
+            // lyra-table's sortable-header/row convention) for role-based clickable
+            // elements — bound to keydown, not keyup/native click-forwarding.
+            if (e.key === ' ' || e.key === 'Spacebar' || e.key === 'Enter') {
+                // Space would otherwise scroll the page, same as a native checkbox.
+                e.preventDefault();
+                this.toggle();
+            }
+        };
+        this.onSlotChange = (e) => {
+            const nodes = e.target.assignedNodes({ flatten: true });
+            this.hasLabelSlot = nodes.some((n) => (n.textContent ?? '').trim().length > 0);
+        };
+        this.internals = this.attachInternals();
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (!this._defaultCaptured) {
+            this._defaultCaptured = true;
+            this._defaultChecked = this.checked;
+        }
+        this.updateValidity();
+    }
+    willUpdate() {
+        // Seed `hasLabelSlot` from the light-DOM children synchronously before
+        // the very first render (same `!hasUpdated` guard as combobox/date-input's
+        // `hasHintSlot` etc.) so declaratively-provided label text doesn't flash
+        // hidden for one frame while waiting on the first `slotchange` event.
+        if (!this.hasUpdated) {
+            this.hasLabelSlot = Array.from(this.childNodes).some((n) => (n.textContent ?? '').trim().length > 0);
+        }
+    }
+    updateValidity() {
+        if (this.required && !this.checked) {
+            this.internals.setValidity({ valueMissing: true }, 'Please check this box if you want to continue.');
+        }
+        else {
+            this.internals.setValidity({});
+        }
+    }
+    updated(changed) {
+        if (changed.has('checked') || changed.has('value')) {
+            // A native checkbox submits its `value` content attribute (default
+            // "on") only while checked, and contributes nothing at all — not even
+            // an empty string — while unchecked.
+            this.internals.setFormValue(this.checked ? this.value : null);
+        }
+        if (changed.has('checked') || changed.has('required')) {
+            this.updateValidity();
+        }
+    }
+    formResetCallback() {
+        this.checked = this._defaultChecked;
+    }
+    formDisabledCallback(disabled) {
+        this.disabled = disabled;
+    }
+    checkValidity() {
+        return this.internals.checkValidity();
+    }
+    reportValidity() {
+        return this.internals.reportValidity();
+    }
+    toggle() {
+        if (this.disabled)
+            return;
+        this.checked = !this.checked;
+        this.indeterminate = false;
+        this.emit('lyra-change', { checked: this.checked });
+    }
+    render() {
+        const mixed = this.indeterminate;
+        return html `
+      <span
+        part="base"
+        role="checkbox"
+        tabindex=${this.disabled ? '-1' : '0'}
+        aria-checked=${mixed ? 'mixed' : this.checked ? 'true' : 'false'}
+        aria-required=${this.required ? 'true' : nothing}
+        aria-disabled=${this.disabled ? 'true' : nothing}
+        aria-label=${this.getAttribute('aria-label') || nothing}
+        @click=${this.onClick}
+        @keydown=${this.onKeyDown}
+      >
+        <span part="box"> ${mixed ? indeterminateGlyph() : this.checked ? checkmarkGlyph() : nothing} </span>
+        <span part="label" ?hidden=${!this.hasLabelSlot}>
+          <slot @slotchange=${this.onSlotChange}></slot>
+        </span>
+      </span>
+    `;
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraCheckbox.prototype, "checked", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraCheckbox.prototype, "indeterminate", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraCheckbox.prototype, "disabled", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraCheckbox.prototype, "required", void 0);
+__decorate([
+    property()
+], LyraCheckbox.prototype, "name", void 0);
+__decorate([
+    property()
+], LyraCheckbox.prototype, "value", void 0);
+__decorate([
+    state()
+], LyraCheckbox.prototype, "hasLabelSlot", void 0);
+defineElement('checkbox', LyraCheckbox);

package/dist/components/checkbox/checkbox.styles.d.ts

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

package/dist/components/checkbox/checkbox.styles.js

@@ -0,0 +1,70 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: inline-block;
+  }
+  [part='base'] {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--lyra-space-s);
+    cursor: pointer;
+    -webkit-tap-highlight-color: transparent;
+  }
+  [part='base']:focus-visible {
+    outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+    outline-offset: var(--lyra-focus-ring-offset);
+  }
+  :host([disabled]) [part='base'] {
+    cursor: not-allowed;
+    opacity: var(--lyra-opacity-disabled);
+  }
+
+  [part='box'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: 0 0 auto;
+    box-sizing: border-box;
+    /* Matches the inline icon-affordance sizing convention used by
+       lyra-combobox's clear-button / lyra-select's toggle
+       (--lyra-icon-button-size capped at 1.75rem) — a real touch target
+       without ballooning to the full 2.5rem meant for standalone
+       icon-only buttons. */
+    min-inline-size: min(var(--lyra-icon-button-size), 1.75rem);
+    min-block-size: min(var(--lyra-icon-button-size), 1.75rem);
+    border: 1px solid var(--lyra-color-border);
+    border-radius: calc(var(--lyra-radius) * 0.6);
+    background: var(--lyra-color-surface);
+    color: var(--lyra-color-on-brand);
+    transition:
+      background-color var(--lyra-transition-fast),
+      border-color var(--lyra-transition-fast);
+  }
+  :host(:not([disabled])) [part='base']:hover [part='box'] {
+    border-color: var(--lyra-color-brand);
+  }
+  :host([checked]) [part='box'],
+  :host([indeterminate]) [part='box'] {
+    background: var(--lyra-color-brand);
+    border-color: var(--lyra-color-brand);
+  }
+
+  [part='checkmark'] {
+    display: block;
+  }
+
+  /* No explicit "display" here (unlike e.g. lyra-combobox's
+     [part='form-control-label']), so the UA stylesheet's default
+     "[hidden] { display: none }" rule needs no author-side override to
+     take effect when hasLabelSlot is false. */
+  [part='label'] {
+    font-size: 0.875rem;
+    color: var(--lyra-color-text);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [part='box'] {
+      transition: none !important;
+    }
+  }
+`;

package/dist/components/chip/chip-group.d.ts

@@ -0,0 +1,56 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export interface ChipGroupOverflowToggleDetail {
+    expanded: boolean;
+}
+/**
+ * `<lyra-chip-group>` — a flex-wrap container for a set of `<lyra-chip>`
+ * children (plain light-DOM composition — direct children are the chips,
+ * the same shape `<lyra-split>`'s panels / `<lyra-source-list>`'s cards
+ * take — no `.items` array prop).
+ *
+ * `max-visible` is entirely optional. When unset, every child is always
+ * shown and this component does nothing beyond flex-wrap layout. When set
+ * and the group has more chip children than that, the excess children are
+ * hidden (via their own `hidden` property — CSS alone can't parameterize
+ * `:nth-child` on a runtime prop, so this reaches into the light DOM the
+ * same way `<lyra-split>` sets each panel's inline `flex`/`order`) and a
+ * "+N" overflow-indicator pill takes their place. Clicking it is a toggle:
+ * it reveals the rest (and relabels itself "Show less"); clicking again
+ * re-collapses back to `max-visible`. `lyra-overflow-toggle` fires only from
+ * that click — i.e. only when `max-visible` is actually causing an overflow
+ * state — never as a side effect of `max-visible`/children changing on
+ * their own.
+ *
+ * @customElement lyra-chip-group
+ * @slot - `<lyra-chip>` elements (or any content, though the chip pairing is
+ * the intended usage).
+ * @event lyra-overflow-toggle - The overflow indicator was activated,
+ * revealing or re-collapsing the excess children. `detail: { expanded }`.
+ * @csspart base - The flex-wrap container (holds both the slot and the overflow indicator).
+ * @csspart overflow-indicator - The "+N" / "Show less" toggle button. Only rendered while `max-visible` is actively causing an overflow.
+ */
+export declare class LyraChipGroup extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** Maximum number of direct children shown before the rest collapse behind
+     *  a "+N" indicator. Unset (the default) means no limit — every child is
+     *  always shown. */
+    maxVisible?: number;
+    private childCount;
+    /** Whether the excess (beyond `max-visible`) children are currently
+     *  revealed. Meaningless (and never rendered) while there's no overflow. */
+    private expanded;
+    protected willUpdate(): void;
+    firstUpdated(): void;
+    protected updated(): void;
+    private get hasOverflow();
+    private syncChildVisibility;
+    private onSlotChange;
+    private onToggleOverflow;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-chip-group': LyraChipGroup;
+    }
+}