@aceshooting/lyra-ui 4.2.0 → 5.1.0

package/dist/components/retrieval/chunk-inspector/chunk-inspector.class.d.ts

@@ -0,0 +1,131 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import '../../layout/virtual-list/virtual-list.class.js';
+import '../../overlays/empty/empty.class.js';
+/** A local, non-exported structural copy of the `lr-document-viewer` `LyraAnchor` discriminated
+ *  union, declared here (rather than imported) so this component has no build-time coupling to the
+ *  viewer stack. Structurally identical to the real thing, so `chunk.anchor` interops with a
+ *  `document-viewer.anchor` assignment with no mapping needed. */
+type LyraChunkAnchor = {
+    kind: 'page';
+    page: number;
+} | {
+    kind: 'text-quote';
+    quote: string;
+    prefix?: string;
+    suffix?: string;
+    page?: number;
+} | {
+    kind: 'fragment';
+    id: string;
+} | {
+    kind: 'line-range';
+    start: number;
+    end?: number;
+} | {
+    kind: 'cell-range';
+    sheet?: string;
+    range: string;
+} | {
+    kind: 'cfi';
+    cfi: string;
+} | {
+    kind: 'time-range';
+    start: number;
+    end?: number;
+} | {
+    kind: 'region';
+    page?: number;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+} | {
+    kind: 'node-path';
+    path: (string | number)[];
+};
+export interface LyraChunk {
+    id: string;
+    text: string;
+    /** 0-1 relevance. */
+    score: number;
+    sourceId: string;
+    /** e.g. filename; falls back to localized `untitledSource`. */
+    title?: string;
+    /** Rendered as-is via the existing `sourcePageSuffix` key. */
+    page?: string | number;
+    /** Carried through `lr-chunk-open` verbatim. */
+    anchor?: LyraChunkAnchor;
+}
+export interface LyraChunkInspectorEventMap {
+    'lr-chunk-open': CustomEvent<{
+        id: string;
+        sourceId: string;
+        anchor?: LyraChunkAnchor;
+    }>;
+    'lr-expand': CustomEvent<{
+        id: string;
+        expanded: boolean;
+    }>;
+}
+/**
+ * `<lr-chunk-inspector>` — a ranked retrieved-chunks list: relevance score bars with tier tones,
+ * expandable chunk text, and the deep-link event that lands a chunk in `lr-document-viewer`.
+ * Never fetches, ranks, or dedupes; never opens documents itself.
+ *
+ * @customElement lr-chunk-inspector
+ * @event lr-chunk-open - A chunk's title/open button was activated -- the event a host routes
+ * into `lr-document-viewer` (set `src` from `sourceId`, set `anchor`). `detail: { id, sourceId,
+ * anchor? }`.
+ * @event lr-expand - A chunk's text toggle was activated. `detail: { id, expanded }`.
+ * @csspart base - The `role="group"` wrapper.
+ * @csspart chunk - One chunk row (`role="listitem"`).
+ * @csspart score - The visible percent-score text.
+ * @csspart score-bar - The `aria-hidden` score bar track.
+ * @csspart score-fill - The score bar's tone-mapped fill.
+ * @csspart open-button - The chunk's title/open `<button>`.
+ * @csspart title - The `<span>` inside `open-button` carrying the visible title text. Split from
+ * `open-button` (rather than a dual part name on one element) because an exact-match
+ * `[part="..."]` CSS attribute selector -- as used by this component's own tests -- cannot match
+ * a multi-token `part` attribute value.
+ * @csspart text - The chunk's text preview, line-clamped unless expanded. Omitted when `compact`.
+ * @csspart toggle - The "Show more"/"Show less" button. Omitted when `compact`.
+ * @csspart empty - The empty-state message, shown when `chunks` is empty.
+ */
+export declare class LyraChunkInspector extends LyraElement<LyraChunkInspectorEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    chunks: LyraChunk[];
+    thresholds: {
+        high: number;
+        medium: number;
+    };
+    sort: 'score' | 'none';
+    /** Marks the chunk currently open in the viewer. */
+    activeId: string;
+    virtualizeAt: number;
+    /** Compact rows render title + score bar + open button only. */
+    compact: boolean;
+    label: string;
+    private expandedIds;
+    /** `virtualizeAt`, normalized to a finite non-negative integer (falling back to the property's
+     *  own default of `50`) -- a raw `NaN` (e.g. an invalid `virtualize-at` attribute) would
+     *  otherwise make `sorted.length > virtualizeAt` always false, silently disabling
+     *  virtualization instead of falling back to the default threshold. */
+    private get effectiveVirtualizeAt();
+    private sortedChunks;
+    private tier;
+    private tierTone;
+    private tierLabel;
+    private toggleExpand;
+    private renderChunk;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-chunk-inspector': LyraChunkInspector;
+    }
+}
+export {};
+//# sourceMappingURL=chunk-inspector.class.d.ts.map

package/dist/components/retrieval/chunk-inspector/chunk-inspector.class.d.ts.map

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

package/dist/components/retrieval/chunk-inspector/chunk-inspector.class.js

@@ -0,0 +1,170 @@
+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 { styleMap } from 'lit/directives/style-map.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { finiteCount } from '../../../internal/numbers.js';
+import '../../layout/virtual-list/virtual-list.class.js';
+import '../../overlays/empty/empty.class.js';
+import { styles } from './chunk-inspector.styles.js';
+/**
+ * `<lr-chunk-inspector>` — a ranked retrieved-chunks list: relevance score bars with tier tones,
+ * expandable chunk text, and the deep-link event that lands a chunk in `lr-document-viewer`.
+ * Never fetches, ranks, or dedupes; never opens documents itself.
+ *
+ * @customElement lr-chunk-inspector
+ * @event lr-chunk-open - A chunk's title/open button was activated -- the event a host routes
+ * into `lr-document-viewer` (set `src` from `sourceId`, set `anchor`). `detail: { id, sourceId,
+ * anchor? }`.
+ * @event lr-expand - A chunk's text toggle was activated. `detail: { id, expanded }`.
+ * @csspart base - The `role="group"` wrapper.
+ * @csspart chunk - One chunk row (`role="listitem"`).
+ * @csspart score - The visible percent-score text.
+ * @csspart score-bar - The `aria-hidden` score bar track.
+ * @csspart score-fill - The score bar's tone-mapped fill.
+ * @csspart open-button - The chunk's title/open `<button>`.
+ * @csspart title - The `<span>` inside `open-button` carrying the visible title text. Split from
+ * `open-button` (rather than a dual part name on one element) because an exact-match
+ * `[part="..."]` CSS attribute selector -- as used by this component's own tests -- cannot match
+ * a multi-token `part` attribute value.
+ * @csspart text - The chunk's text preview, line-clamped unless expanded. Omitted when `compact`.
+ * @csspart toggle - The "Show more"/"Show less" button. Omitted when `compact`.
+ * @csspart empty - The empty-state message, shown when `chunks` is empty.
+ */
+export class LyraChunkInspector extends LyraElement {
+    constructor() {
+        super(...arguments);
+        this.chunks = [];
+        this.thresholds = { high: 0.75, medium: 0.5 };
+        this.sort = 'score';
+        /** Marks the chunk currently open in the viewer. */
+        this.activeId = '';
+        this.virtualizeAt = 50;
+        /** Compact rows render title + score bar + open button only. */
+        this.compact = false;
+        this.label = '';
+        this.expandedIds = new Set();
+        this.renderChunk = (item) => {
+            const chunk = item;
+            const tier = this.tier(chunk.score);
+            const tone = this.tierTone(tier);
+            const percent = Math.round(chunk.score * 100);
+            const titleText = chunk.title || this.localize('untitledSource');
+            const titleWithPage = chunk.page == null || chunk.page === '' ? titleText : this.localize('sourcePageSuffix', undefined, { base: titleText, page: chunk.page });
+            const expanded = this.expandedIds.has(chunk.id);
+            return html `
+      <div part="chunk" role="listitem" aria-current=${this.activeId === chunk.id ? 'true' : nothing}>
+        <div part="score">
+          <span>${this.localize('chunkScore', undefined, { percent })}</span>
+          <span part="score-bar" aria-hidden="true"
+            ><span part="score-fill" data-tone=${tone} style=${styleMap({ inlineSize: `${percent}%` })}></span
+          ></span>
+        </div>
+        <button
+          part="open-button"
+          type="button"
+          aria-label=${`${titleWithPage}, ${this.tierLabel(tier)}`}
+          @click=${() => this.emit('lr-chunk-open', { id: chunk.id, sourceId: chunk.sourceId, ...(chunk.anchor ? { anchor: chunk.anchor } : {}) })}
+        >
+          <span part="title">${titleWithPage}</span>
+        </button>
+        ${!this.compact
+                ? html `<p part="text" ?data-clamped=${!expanded}>${chunk.text}</p>
+              <button part="toggle" type="button" aria-expanded=${expanded ? 'true' : 'false'} @click=${() => this.toggleExpand(chunk.id)}>
+                ${this.localize(expanded ? 'showLess' : 'showMore')}
+              </button>`
+                : nothing}
+      </div>
+    `;
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    /** `virtualizeAt`, normalized to a finite non-negative integer (falling back to the property's
+     *  own default of `50`) -- a raw `NaN` (e.g. an invalid `virtualize-at` attribute) would
+     *  otherwise make `sorted.length > virtualizeAt` always false, silently disabling
+     *  virtualization instead of falling back to the default threshold. */
+    get effectiveVirtualizeAt() {
+        return finiteCount(this.virtualizeAt, 50);
+    }
+    sortedChunks() {
+        return this.sort === 'score' ? [...this.chunks].sort((a, b) => b.score - a.score) : this.chunks;
+    }
+    tier(score) {
+        if (score >= this.thresholds.high)
+            return 'high';
+        if (score >= this.thresholds.medium)
+            return 'medium';
+        return 'low';
+    }
+    tierTone(tier) {
+        return tier === 'high' ? 'success' : tier === 'medium' ? 'warning' : 'danger';
+    }
+    tierLabel(tier) {
+        return this.localize(tier === 'high' ? 'scoreTierHigh' : tier === 'medium' ? 'scoreTierMedium' : 'scoreTierLow');
+    }
+    toggleExpand(id) {
+        const next = new Set(this.expandedIds);
+        const expanded = !next.has(id);
+        if (expanded)
+            next.add(id);
+        else
+            next.delete(id);
+        this.expandedIds = next;
+        this.emit('lr-expand', { id, expanded });
+    }
+    render() {
+        const sorted = this.sortedChunks();
+        const label = this.label || this.localize('chunkInspectorLabel');
+        if (sorted.length === 0) {
+            // `heading` is passed as slotted light-DOM content (rather than the `heading` attribute
+            // most other components use) so `[part="empty"]`'s `.textContent` -- a plain DOM accessor,
+            // which never pierces `lr-empty`'s own shadow root -- actually includes the message; see
+            // this component's notes for why the attribute-only form other components use wouldn't.
+            return html `<div part="base">
+        <lr-empty part="empty"><span slot="heading">${this.localize('chunkInspectorEmpty')}</span></lr-empty>
+      </div>`;
+        }
+        return html `
+      <div part="base" role="group" aria-label=${label}>
+        ${sorted.length > this.effectiveVirtualizeAt
+            ? html `<lr-virtual-list
+              .items=${sorted}
+              .renderItem=${this.renderChunk}
+              .keyFunction=${(item) => item.id}
+              .activeId=${this.activeId || ''}
+            ></lr-virtual-list>`
+            : html `<div role="list">${sorted.map((c) => this.renderChunk(c))}</div>`}
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraChunkInspector.prototype, "chunks", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraChunkInspector.prototype, "thresholds", void 0);
+__decorate([
+    property()
+], LyraChunkInspector.prototype, "sort", void 0);
+__decorate([
+    property({ attribute: 'active-id' })
+], LyraChunkInspector.prototype, "activeId", void 0);
+__decorate([
+    property({ type: Number, attribute: 'virtualize-at' })
+], LyraChunkInspector.prototype, "virtualizeAt", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraChunkInspector.prototype, "compact", void 0);
+__decorate([
+    property()
+], LyraChunkInspector.prototype, "label", void 0);
+__decorate([
+    state()
+], LyraChunkInspector.prototype, "expandedIds", void 0);
+//# sourceMappingURL=chunk-inspector.class.js.map

package/dist/components/retrieval/chunk-inspector/chunk-inspector.class.js.map

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

package/dist/components/retrieval/chunk-inspector/chunk-inspector.d.ts

@@ -0,0 +1,4 @@
+export * from './chunk-inspector.class.js';
+import '../../layout/virtual-list/virtual-list.js';
+import '../../overlays/empty/empty.js';
+//# sourceMappingURL=chunk-inspector.d.ts.map

package/dist/components/retrieval/chunk-inspector/chunk-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-inspector.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/chunk-inspector/chunk-inspector.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAG3C,OAAO,2CAA2C,CAAC;AACnD,OAAO,+BAA+B,CAAC"}

package/dist/components/retrieval/chunk-inspector/chunk-inspector.js

@@ -0,0 +1,7 @@
+export * from './chunk-inspector.class.js';
+import { LyraChunkInspector } from './chunk-inspector.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+import '../../layout/virtual-list/virtual-list.js';
+import '../../overlays/empty/empty.js';
+defineElement('chunk-inspector', LyraChunkInspector);
+//# sourceMappingURL=chunk-inspector.js.map

package/dist/components/retrieval/chunk-inspector/chunk-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-inspector.js","sourceRoot":"","sources":["../../../../src/components/retrieval/chunk-inspector/chunk-inspector.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,2CAA2C,CAAC;AACnD,OAAO,+BAA+B,CAAC;AACvC,aAAa,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/components/retrieval/chunk-inspector/chunk-inspector.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-inspector.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/chunk-inspector/chunk-inspector.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAiFlB,CAAC"}

package/dist/components/retrieval/chunk-inspector/chunk-inspector.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-inspector.styles.js","sourceRoot":"","sources":["../../../../src/components/retrieval/chunk-inspector/chunk-inspector.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFxB,CAAC"}

package/dist/components/retrieval/citation-badge/citation-badge.class.d.ts

@@ -0,0 +1,134 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+export type CitationBadgeStatus = 'default' | 'high' | 'medium' | 'low' | 'verified' | 'unverified';
+export interface CitationActivateDetail {
+    sourceId: string;
+    index: number;
+}
+export interface CitationOpenDetail {
+    sourceId: string;
+    index: number;
+    href?: string;
+}
+export interface LyraCitationBadgeEventMap {
+    'lr-citation-activate': CustomEvent<CitationActivateDetail>;
+    'lr-citation-open': CustomEvent<CitationOpenDetail>;
+}
+/**
+ * `<lr-citation-badge>` — an inline `[n]` citation marker with a hover/
+ * focus preview popover and confidence/verification-status coloring. Used
+ * for an agent response's inline citations, each carrying a `source-id`
+ * that matches a corresponding `<lr-source-card>` shown elsewhere on the
+ * page (a sibling component in this same family — this component doesn't
+ * import or know anything about it, only carries the id through its
+ * events).
+ *
+ * The default slot is *not* the badge's visible content — the badge always
+ * renders `[index]` — it's reserved for optional rich preview content (e.g.
+ * a filename + short excerpt) shown in a floating popover on hover/focus,
+ * positioned with `internal/positioner.js`'s `place()` the same way
+ * `<lr-tool-call-chip>` positions its own detail tooltip. No popover shows
+ * at all when the slot carries no content, and the popover never traps
+ * focus — it's supplementary preview content, not a modal, so Tab continues
+ * past the badge normally even while it happens to be visible from a mouse
+ * hover. When preview content exists, the button keeps a stable
+ * `aria-describedby` relationship to the `role="tooltip"` panel while it is
+ * both hidden and visible, so assistive technology can resolve the preview
+ * as soon as focus causes it to open.
+ *
+ * Two distinct signals fire from the same badge: `lr-citation-activate`
+ * (click, or Enter while focused — native `<button>` behavior, no listener
+ * needed for the Enter case) is the lightweight "jump to this source"
+ * signal a host wires to scrolling/highlighting the matching
+ * `<lr-source-card>`. `lr-citation-open` (dblclick, or Space while
+ * focused) is a distinct "full preview" signal — `href` in its detail is
+ * `undefined` when the `href` prop isn't set; the consumer decides what
+ * "open" means (a new tab, a dialog, etc). A double-click still fires two
+ * `lr-citation-activate` events (one per constituent click — standard
+ * browser `dblclick` behavior) in addition to the one `lr-citation-open`;
+ * a consumer that only cares about the richer signal on a double-click
+ * should ignore the paired activate events in that case.
+ *
+ * Status coloring: `verified`/`high` use the success tones (a claim that's
+ * been checked out, or the model is confident in). `medium`/`low` use
+ * warning (progressively less certain, but still a real citation).
+ * `unverified` uses danger — deliberately distinct from `low`: "hasn't been
+ * checked at all" is a different (arguably riskier) claim than "checked but
+ * uncertain". `default` renders as plain neutral text with no background
+ * tint, for citations that carry no confidence/verification signal at all.
+ *
+ * @customElement lr-citation-badge
+ * @slot - Rich preview/tooltip content (e.g. a filename + excerpt), shown in
+ * a floating popover on hover/focus. Nothing renders (no hover affordance at
+ * all) when this slot is empty.
+ * @event lr-citation-activate - The badge was activated (click, or Enter
+ * while focused). `detail: { sourceId, index }`.
+ * @event lr-citation-open - The badge's "full preview" affordance was
+ * triggered (dblclick, or Space while focused).
+ * `detail: { sourceId, index, href }`.
+ * @csspart base - The clickable badge (`<button>`).
+ * @csspart bracket - Each of the two literal `[`/`]` glyphs.
+ * @csspart index - The citation number.
+ * @csspart popover - The floating preview panel (only meaningful while open).
+ * @cssprop [--lr-citation-badge-accent=var(--lr-color-text-quiet)] - Text color of `base`, and its
+ * hover border color. Swapped by the reflected `status`: `var(--lr-color-success)` for
+ * `high`/`verified`, `var(--lr-color-warning)` for `medium`/`low`, `var(--lr-color-danger)` for
+ * `unverified`.
+ * @cssprop [--lr-citation-badge-bg=transparent] - Background of `base`. Swapped by the reflected
+ * `status` to the matching `-quiet` tone (`success`/`warning`/`danger`).
+ * @cssprop [--lr-citation-badge-border=transparent] - Resting border color of `base`; no `status`
+ * changes it, so it stays transparent unless a host overrides it.
+ */
+export declare class LyraCitationBadge extends LyraElement<LyraCitationBadgeEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    private _index;
+    /** The citation number shown, e.g. `3` renders as `[3]`. Renders directly as visible text (and
+     *  feeds `lr-citation-activate`/`lr-citation-open`'s `detail.index`), so a NaN/non-integer
+     *  value would be a real user-facing rendering bug — clamped to a finite, 1-indexed integer
+     *  (citation numbers are conventionally 1-indexed, matching this property's own default). */
+    get index(): number;
+    set index(value: number);
+    /** Confidence/verification state — drives the badge's color and (unless
+     *  `label` is set) part of its accessible name. */
+    status: CitationBadgeStatus;
+    /** Id of a corresponding `<lr-source-card>` elsewhere on the page —
+     *  echoed back verbatim in both events, never read or validated here. */
+    sourceId: string;
+    /** Optional direct link target for the citation's source. Carried into
+     *  `lr-citation-open`'s detail as-is; this component never navigates. */
+    href: string;
+    /** Overrides the computed accessible name (`"Citation {index}[, {status}]"`). */
+    label: string;
+    private hasPreviewSlot;
+    private popoverOpen;
+    private buttonEl?;
+    private popoverEl?;
+    private readonly popoverId;
+    private cleanupPositioner?;
+    private hideTimer?;
+    private hovering;
+    private focused;
+    protected willUpdate(): void;
+    protected updated(changed: PropertyValues): void;
+    disconnectedCallback(): void;
+    private get accessibleLabel();
+    private onSlotChange;
+    private showPreview;
+    private scheduleHidePreview;
+    private hidePreviewNow;
+    private onPointerEnter;
+    private onPointerLeave;
+    private onFocusIn;
+    private onFocusOut;
+    private onKeyDown;
+    private onClick;
+    private onDblClick;
+    private emitOpen;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-citation-badge': LyraCitationBadge;
+    }
+}
+//# sourceMappingURL=citation-badge.class.d.ts.map

package/dist/components/retrieval/citation-badge/citation-badge.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-badge.class.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/citation-badge/citation-badge.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAMhE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAC5D,kBAAkB,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;CACrD;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAC3E,MAAM,CAAC,MAAM,iCAAgC;IAE7C,OAAO,CAAC,MAAM,CAAK;IACnB;;;iGAG6F;IAC7F,IACI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAItB;IAED;uDACmD;IACtB,MAAM,EAAE,mBAAmB,CAAa;IAErE;6EACyE;IACnC,QAAQ,SAAM;IAEpD;6EACyE;IAC7D,IAAI,SAAM;IAEtB,iFAAiF;IACrE,KAAK,SAAM;IAMd,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAEb,OAAO,CAAC,QAAQ,CAAC,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAC,CAAc;IAE3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,SAAS,CAAC,CAAgC;IAKlD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IAExB,SAAS,CAAC,UAAU,IAAI,IAAI,CAI3B;IAED,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAQ/C;IAED,oBAAoB,IAAI,IAAI,CAI3B;IAED,OAAO,KAAK,eAAe,GAQ1B;IAED,OAAO,CAAC,YAAY,CAMlB;IASF,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc,CAGpB;IACF,OAAO,CAAC,cAAc,CAGpB;IACF,OAAO,CAAC,SAAS,CAGf;IAMF,OAAO,CAAC,UAAU,CAIhB;IAOF,OAAO,CAAC,SAAS,CAmBf;IAEF,OAAO,CAAC,OAAO,CAEb;IAEF,OAAO,CAAC,UAAU,CAEhB;IAEF,OAAO,CAAC,QAAQ;IAQhB,MAAM,IAAI,cAAc,CA0BvB;CACF;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,iBAAiB,CAAC;KACxC;CACF"}