@aceshooting/lyra-ui 2.1.0 → 2.3.0

package/dist/components/attachment-chip/attachment-chip.class.js

@@ -0,0 +1,379 @@
+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 } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { nextId } from '../../internal/a11y.js';
+import { closeIcon } from '../../internal/icons.js';
+import { styles } from './attachment-chip.styles.js';
+// Mirrors the shared icon set's viewBox/stroke conventions
+// (internal/icons.ts's chevronIcon()/closeIcon()/etc.) without adding a
+// generic-file glyph to that module -- it's off limits here -- so this one-off
+// icon still reads as part of the same visual language as the rest of the
+// library's inline icons. `closeIcon()` itself already exists there and is
+// imported directly rather than duplicated (see `<lyra-toast-item>`'s /
+// `<lyra-widget>`'s identical import for the same remove/dismiss glyph).
+const ICON_VIEW_BOX = '0 0 24 24';
+const ICON_STROKE_WIDTH = '1.75';
+/** A generic "document" glyph, used as the thumbnail for any non-image file. */
+function fileGlyph() {
+    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"
+    ><path d="M6 2h8l6 6v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2Z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>
+  `;
+}
+// Same shape as `<lyra-chat-message>`'s local `retryIcon()` -- duplicated
+// rather than imported (these are two independent, separately-consumable
+// components) but kept visually identical so a retry affordance reads the
+// same wherever it shows up in the library.
+function retryIcon() {
+    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"
+    ><polyline points="1 4 1 10 7 10"></polyline><path d="M3.51 15a9 9 0 1 0 2.13-9.36L1 10"></path></svg>
+  `;
+}
+const BYTE_UNITS = ['B', 'KB', 'MB', 'GB', 'TB'];
+/**
+ * `512` -> `"512 B"`; `2415919` -> `"2.3 MB"`. Whole bytes never get a
+ * decimal (there's no meaningful fraction of a byte); every unit past that
+ * gets exactly one decimal place. Returns `""` for a negative/non-finite
+ * input so a missing/unknown size renders nothing instead of `"NaN B"`.
+ */
+export function formatFileSize(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return '';
+    if (bytes < 1024)
+        return `${Math.round(bytes)} B`;
+    let value = bytes;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < BYTE_UNITS.length - 1) {
+        value /= 1024;
+        unitIndex++;
+    }
+    return `${value.toFixed(1)} ${BYTE_UNITS[unitIndex]}`;
+}
+/** Visible (not just color-coded) text for every non-resting status --
+ *  `'pending'`/`'done'` render nothing here, they're resting states.
+ *  `clampedProgress` (not the raw `progress`) is what gets displayed, so the
+ *  percentage shown here can never drift from the progressbar's own
+ *  `aria-valuenow`/fill-width, which reads from the same clamped value.
+ *  `uploadingLabel`/`uploadFailedLabel` are the host's (possibly overridden)
+ *  verb/phrase -- defaulting to `'Uploading'`/`'Upload failed'` reproduces
+ *  today's exact hardcoded text byte-for-byte. */
+function statusText(status, progress, clampedProgress, uploadingLabel, uploadFailedLabel) {
+    if (status === 'error')
+        return uploadFailedLabel;
+    if (status === 'uploading') {
+        return Number.isFinite(progress) && progress > 0
+            ? `${uploadingLabel} ${Math.round(clampedProgress)}%`
+            : `${uploadingLabel}…`;
+    }
+    return '';
+}
+/**
+ * `<lyra-attachment-chip>` — a compact chip representing one file queued for
+ * (or already part of) a chat message: a composer's pre-send attachment
+ * tray, or a sent message's `attachments` slot (see `<lyra-chat-message>`).
+ *
+ * Two independent ways to populate it, matching the two points in a message's
+ * lifecycle this is used at:
+ *  - Set `file` to a real `File` (fresh from a picker/drop) — `name`, `size`,
+ *    `mime-type` and the image thumbnail are all auto-derived from it.
+ *  - Set the plain `name`/`size`/`mime-type`/`thumbnail-src` props instead,
+ *    for reconstructing a chip from server-persisted attachment metadata
+ *    (e.g. after a page reload, when no real `File` object exists any more).
+ *
+ * `file` always wins when both are present — see each accessor's own doc.
+ * The image thumbnail for a real `File` is a cached `URL.createObjectURL()`
+ * blob URL, created in the update lifecycle immediately before the thumbnail
+ * renders and revoked automatically once `file`
+ * changes away from the object it was created for, and on disconnect — this
+ * component never leaks a blob URL.
+ *
+ * Identifying *which* attachment a `lyra-remove`/`lyra-retry` event is about:
+ * this deliberately reuses the platform's own `id`/`id` attribute (every
+ * element already has one; there's no need to shadow it with a second,
+ * differently-named Lit property, unlike e.g. `<lyra-tool-call-chip>`'s
+ * `call-id` which identifies a *call*, a concept distinct from the chip
+ * element itself). Set `id="..."` when you have a stable server-side
+ * attachment id. When `id` is left unset and `file` is set, a stable id is
+ * derived from `` `${file.name}:${file.size}:${file.lastModified}` `` — stable
+ * across re-renders of the *same* `File` object without requiring the
+ * consumer to invent one. When neither is available, a generated internal id
+ * is used as a last resort so the event always has *some* id.
+ *
+ * i18n/locale: every translatable word rendered by this component is
+ * override-able via a dedicated property — `removeLabel`/`retryLabel`
+ * (the verb prefixed to the remove/retry buttons' `aria-label`, keeping the
+ * `displayName` interpolation), and `uploadingLabel`/`uploadFailedLabel` (the
+ * verb/phrase used in the visible `status-text`, keeping the live percentage
+ * interpolation for `uploadingLabel`). All four default to today's exact
+ * hardcoded English text (`'Remove'`, `'Retry'`, `'Uploading'`, `'Upload
+ * failed'`), so leaving them unset changes nothing. These are plain
+ * properties, not slots — this component still exposes no slots.
+ *
+ * @customElement lyra-attachment-chip
+ * @event lyra-remove - The user activated the remove (×) button. `detail: { id }`. Only rendered while `removable`.
+ * @event lyra-retry - The user activated the retry button. `detail: { id }`. Only rendered while `status="error"`.
+ * @csspart base - The chip's root container.
+ * @csspart thumbnail - The leading image thumbnail / generic file glyph.
+ * @csspart meta - Wrapper around `name` and `size`.
+ * @csspart name - The filename (ellipsis-truncated via CSS; the untruncated name is always available via the native `title` tooltip).
+ * @csspart size - The human-readable formatted file size. Hidden when no size is known.
+ * @csspart status-text - The visible text twin of the status accent color — carries the state in text, not just color. Empty/hidden for `pending`/`done`. Gets `role="alert"` for `status="error"` only, so a screen-reader user not already focused on the chip still hears an upload failure; the ticking `'uploading'` readout deliberately stays out of the accessibility tree the same way `<lyra-generation-status>`'s per-second elapsed/token readout does — a live region re-announcing every progress tick would be noise, not information, while a one-shot failure is exactly the kind of infrequent, actionable transition a live region exists for.
+ * @csspart progress - The numeric upload progress bar (`role="progressbar"`), shown only while `status="uploading"` and `progress` is a meaningful (>0) number.
+ * @csspart progress-fill - The filled portion of `progress`.
+ * @csspart spinner - The indeterminate upload spinner, shown instead of `progress` while `status="uploading"` and `progress` is unset/0.
+ * @csspart retry-button - The retry affordance, only rendered while `status="error"`.
+ * @csspart remove-button - The remove (×) affordance, only rendered while `removable`.
+ */
+export class LyraAttachmentChip extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Filename, used only while `file` is unset. */
+        this.name = '';
+        /** File size in bytes, used only while `file` is unset. */
+        this.size = 0;
+        /** MIME type, used only while `file` is unset. */
+        this.mimeType = '';
+        /** Thumbnail image URL, used only while `file` is unset (a real `File`'s
+         *  thumbnail always comes from a generated object URL instead — see the
+         *  class doc). Unlike the other independent props this one has no
+         *  `file`-derived equivalent to defer to for a non-image file; it's simply
+         *  rendered whenever present. */
+        this.thumbnailSrc = '';
+        /** Lifecycle state — drives the accent tint and which of `progress`/`spinner`/`retry-button` renders. */
+        this.status = 'pending';
+        /** Upload completion, 0-100. Only meaningful while `status="uploading"`;
+         *  a value of 0 (the default) or `NaN` falls back to the indeterminate spinner. */
+        this.progress = 0;
+        /** Shows the remove (×) button. */
+        this.removable = true;
+        /** Renders a smaller, borderless pill presentation instead of the default bordered/chrome-heavy
+         *  chip -- for a consumer that wants an icon-only-adjacent, compact attachment affordance (e.g.
+         *  a composer's pending-attachment tray) without hand-tuning several `::part()` custom
+         *  properties individually. `false` (the default) is visually identical to today. */
+        this.compact = false;
+        /** When both this and `compact` are set, hides `[part=meta]` (the filename/size text) entirely
+         *  for an image-mime attachment, leaving only the thumbnail -- for a consumer wanting a
+         *  thumbnail-only density purely through props, with no consumer-side CSS. Has no effect for a
+         *  non-image chip (there is no thumbnail to fall back to showing on its own) or when `compact` is
+         *  unset. `false` (the default) reproduces today's exact output. */
+        this.thumbnailOnly = false;
+        /** Verb used in the remove button's `aria-label`, interpolated as
+         *  `` `${removeLabel} ${displayName}` `` -- override for i18n/locale.
+         *  Defaults to `'Remove'`, reproducing today's exact `"Remove ${displayName}"`
+         *  text byte-for-byte. */
+        this.removeLabel = 'Remove';
+        /** Verb used in the retry button's `aria-label`, interpolated as
+         *  `` `${retryLabel} ${displayName}` `` -- override for i18n/locale.
+         *  Defaults to `'Retry'`, reproducing today's exact `"Retry ${displayName}"`
+         *  text byte-for-byte. */
+        this.retryLabel = 'Retry';
+        /** Verb used in the visible uploading status text -- rendered as
+         *  `` `${uploadingLabel} ${percent}%` `` once progress is a meaningful
+         *  number, else `` `${uploadingLabel}…` ``. Override for i18n/locale.
+         *  Defaults to `'Uploading'`, reproducing today's exact `"Uploading N%"`/
+         *  `"Uploading…"` text byte-for-byte. */
+        this.uploadingLabel = 'Uploading';
+        /** Visible status text shown for `status="error"`. Override for
+         *  i18n/locale. Defaults to `'Upload failed'`, reproducing today's exact
+         *  text byte-for-byte. */
+        this.uploadFailedLabel = 'Upload failed';
+        /** Override for the empty-name fallback shown (and used as the `title` tooltip) when neither
+         *  `file` nor `name` supply a filename -- for i18n/locale. Defaults to `'Untitled file'`,
+         *  reproducing today's exact hardcoded text byte-for-byte. */
+        this.untitledLabel = 'Untitled file';
+        // Last-resort id, generated once per instance -- see the class doc's
+        // "Identifying which attachment..." section.
+        this.fallbackId = nextId('attachment-chip');
+        this.onRemoveClick = () => {
+            this.emit('lyra-remove', { id: this.resolvedId });
+        };
+        this.onRetryClick = () => {
+            this.emit('lyra-retry', { id: this.resolvedId });
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    get effectiveName() {
+        return this.file ? this.file.name : this.name;
+    }
+    get effectiveSize() {
+        return this.file ? this.file.size : this.size;
+    }
+    get effectiveMimeType() {
+        return this.file ? this.file.type : this.mimeType;
+    }
+    get resolvedId() {
+        if (this.id)
+            return this.id;
+        if (this.file)
+            return `${this.file.name}:${this.file.size}:${this.file.lastModified}`;
+        return this.fallbackId;
+    }
+    get hasNumericProgress() {
+        return this.status === 'uploading' && Number.isFinite(this.progress) && this.progress > 0;
+    }
+    get clampedProgress() {
+        return Math.min(100, Math.max(0, this.progress));
+    }
+    /** Returns (creating or reusing as needed) the object URL for `file`'s
+     * image thumbnail. Called from the update lifecycle, never from `render()`,
+     * so rendering stays a pure projection of already-prepared state. */
+    ensureObjectUrl(file) {
+        if (this.objectUrlFile === file && this.objectUrl)
+            return this.objectUrl;
+        this.revokeObjectUrl();
+        this.objectUrl = URL.createObjectURL(file);
+        this.objectUrlFile = file;
+        return this.objectUrl;
+    }
+    revokeObjectUrl() {
+        if (this.objectUrl)
+            URL.revokeObjectURL(this.objectUrl);
+        this.objectUrl = undefined;
+        this.objectUrlFile = undefined;
+    }
+    willUpdate() {
+        // Prepare or revoke the non-reactive cache before render. This keeps URL
+        // allocation out of the render phase and also handles a file changing to
+        // a non-image or to undefined, where no thumbnail render would otherwise
+        // revisit the old cache entry.
+        if (this.file?.type.startsWith('image/'))
+            this.ensureObjectUrl(this.file);
+        else if (this.objectUrlFile)
+            this.revokeObjectUrl();
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.revokeObjectUrl();
+    }
+    renderThumbnail() {
+        if (this.file) {
+            return this.effectiveMimeType.startsWith('image/')
+                ? html `<img src=${this.objectUrl ?? ''} alt="" />`
+                : html `${fileGlyph()}`;
+        }
+        // No `file`: `thumbnail-src` is used whenever present, regardless of
+        // `mime-type` -- a server-generated preview thumbnail (e.g. a rendered
+        // first page of a PDF) is itself always an image, independent of the
+        // *source* file's own MIME type.
+        return this.thumbnailSrc ? html `<img src=${this.thumbnailSrc} alt="" />` : html `${fileGlyph()}`;
+    }
+    render() {
+        const name = this.effectiveName;
+        const displayName = name || this.untitledLabel;
+        // A `0`-byte size reads the same as "unknown" here (there's no prop to
+        // distinguish a genuinely empty file from a size that was simply never
+        // supplied) -- hide the part entirely rather than show a literal "0 B".
+        const sizeText = this.effectiveSize > 0 ? formatFileSize(this.effectiveSize) : '';
+        const text = statusText(this.status, this.progress, this.clampedProgress, this.uploadingLabel, this.uploadFailedLabel);
+        const uploading = this.status === 'uploading';
+        return html `
+      <div part="base">
+        <span part="thumbnail" aria-hidden="true">${this.renderThumbnail()}</span>
+        <span part="meta">
+          <span part="name" title=${name || this.untitledLabel}>${displayName}</span>
+          <span part="size" ?hidden=${!sizeText}>${sizeText || nothing}</span>
+          <span part="status-text" role=${this.status === 'error' ? 'alert' : nothing} ?hidden=${!text}>${text || nothing}</span>
+        </span>
+        ${uploading
+            ? this.hasNumericProgress
+                ? html `
+                <div
+                  part="progress"
+                  role="progressbar"
+                  aria-valuenow=${Math.round(this.clampedProgress)}
+                  aria-valuemin="0"
+                  aria-valuemax="100"
+                  aria-label=${`${this.uploadingLabel} ${displayName}`}
+                >
+                  <div part="progress-fill" style=${`inline-size:${this.clampedProgress}%`}></div>
+                </div>
+              `
+                : html `<span part="spinner" role="status" aria-label=${`${this.uploadingLabel} ${displayName}`}></span>`
+            : nothing}
+        ${this.status === 'error'
+            ? html `<button part="retry-button" type="button" aria-label=${`${this.localize('retry', this.retryLabel === 'Retry' ? undefined : this.retryLabel)} ${displayName}`} @click=${this.onRetryClick}>
+              ${retryIcon()}
+            </button>`
+            : nothing}
+        ${this.removable
+            ? html `<button part="remove-button" type="button" aria-label=${`${this.localize('remove', this.removeLabel === 'Remove' ? undefined : this.removeLabel)} ${displayName}`} @click=${this.onRemoveClick}>
+              ${closeIcon()}
+            </button>`
+            : nothing}
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraAttachmentChip.prototype, "file", void 0);
+__decorate([
+    property()
+], LyraAttachmentChip.prototype, "name", void 0);
+__decorate([
+    property({ type: Number })
+], LyraAttachmentChip.prototype, "size", void 0);
+__decorate([
+    property({ attribute: 'mime-type' })
+], LyraAttachmentChip.prototype, "mimeType", void 0);
+__decorate([
+    property({ attribute: 'thumbnail-src' })
+], LyraAttachmentChip.prototype, "thumbnailSrc", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraAttachmentChip.prototype, "status", void 0);
+__decorate([
+    property({ type: Number })
+], LyraAttachmentChip.prototype, "progress", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraAttachmentChip.prototype, "removable", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraAttachmentChip.prototype, "compact", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'thumbnail-only' })
+], LyraAttachmentChip.prototype, "thumbnailOnly", void 0);
+__decorate([
+    property({ attribute: 'remove-label' })
+], LyraAttachmentChip.prototype, "removeLabel", void 0);
+__decorate([
+    property({ attribute: 'retry-label' })
+], LyraAttachmentChip.prototype, "retryLabel", void 0);
+__decorate([
+    property({ attribute: 'uploading-label' })
+], LyraAttachmentChip.prototype, "uploadingLabel", void 0);
+__decorate([
+    property({ attribute: 'upload-failed-label' })
+], LyraAttachmentChip.prototype, "uploadFailedLabel", void 0);
+__decorate([
+    property({ attribute: 'untitled-label' })
+], LyraAttachmentChip.prototype, "untitledLabel", void 0);
+//# sourceMappingURL=attachment-chip.class.js.map

package/dist/components/attachment-chip/attachment-chip.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-chip.class.js","sourceRoot":"","sources":["../../../src/components/attachment-chip/attachment-chip.class.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAA+C,MAAM,KAAK,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAQrD,2DAA2D;AAC3D,wEAAwE;AACxE,+EAA+E;AAC/E,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,yEAAyE;AACzE,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,gFAAgF;AAChF,SAAS,SAAS;IAChB,OAAO,GAAG,CAAA;;;;gBAII,aAAa;;;qBAGR,iBAAiB;;;;;;GAMnC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,yEAAyE;AACzE,0EAA0E;AAC1E,4CAA4C;AAC5C,SAAS,SAAS;IAChB,OAAO,GAAG,CAAA;;;;gBAII,aAAa;;;qBAGR,iBAAiB;;;;;;GAMnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IAClD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,IAAI,IAAI,CAAC;QACd,SAAS,EAAE,CAAC;IACd,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;;kDAOkD;AAClD,SAAS,UAAU,CACjB,MAA4B,EAC5B,QAAgB,EAChB,eAAuB,EACvB,cAAsB,EACtB,iBAAyB;IAEzB,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,iBAAiB,CAAC;IACjD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;YAC9C,CAAC,CAAC,GAAG,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG;YACrD,CAAC,CAAC,GAAG,cAAc,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAAnD;;QAQE,iDAAiD;QACrC,SAAI,GAAG,EAAE,CAAC;QAEtB,2DAA2D;QAC/B,SAAI,GAAG,CAAC,CAAC;QAErC,kDAAkD;QACZ,aAAQ,GAAG,EAAE,CAAC;QAEpD;;;;yCAIiC;QACS,iBAAY,GAAG,EAAE,CAAC;QAE5D,yGAAyG;QAC5E,WAAM,GAAyB,SAAS,CAAC;QAEtE;2FACmF;QACvD,aAAQ,GAAG,CAAC,CAAC;QAEzC,mCAAmC;QACS,cAAS,GAAG,IAAI,CAAC;QAE7D;;;6FAGqF;QACzC,YAAO,GAAG,KAAK,CAAC;QAE5D;;;;4EAIoE;QACK,kBAAa,GAAG,KAAK,CAAC;QAE/F;;;kCAG0B;QACe,gBAAW,GAAG,QAAQ,CAAC;QAEhE;;;kCAG0B;QACc,eAAU,GAAG,OAAO,CAAC;QAE7D;;;;iDAIyC;QACG,mBAAc,GAAG,WAAW,CAAC;QAEzE;;kCAE0B;QACsB,sBAAiB,GAAG,eAAe,CAAC;QAEpF;;sEAE8D;QACnB,kBAAa,GAAG,eAAe,CAAC;QAU3E,qEAAqE;QACrE,6CAA6C;QAC5B,eAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;QA2DhD,kBAAa,GAAG,GAAS,EAAE;YACjC,IAAI,CAAC,IAAI,CAAyB,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,CAAC,CAAC;QAEM,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,IAAI,CAAyB,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3E,CAAC,CAAC;IAoEJ,CAAC;aA1NQ,WAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,AAA/B,CAAgC;IAuF7C,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAChD,CAAC;IAED,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAChD,CAAC;IAED,IAAY,iBAAiB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACpD,CAAC;IAED,IAAY,UAAU;QACpB,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAY,kBAAkB;QAC5B,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC5F,CAAC;IAED,IAAY,eAAe;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;yEAEqE;IAC7D,eAAe,CAAC,IAAU;QAChC,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QACzE,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,SAAS;YAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;IACjC,CAAC;IAES,UAAU;QAClB,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,+BAA+B;QAC/B,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACrE,IAAI,IAAI,CAAC,aAAa;YAAE,IAAI,CAAC,eAAe,EAAE,CAAC;IACtD,CAAC;IAED,oBAAoB;QAClB,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAUO,eAAe;QACrB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAChD,CAAC,CAAC,IAAI,CAAA,YAAY,IAAI,CAAC,SAAS,IAAI,EAAE,YAAY;gBAClD,CAAC,CAAC,IAAI,CAAA,GAAG,SAAS,EAAE,EAAE,CAAC;QAC3B,CAAC;QACD,qEAAqE;QACrE,uEAAuE;QACvE,qEAAqE;QACrE,iCAAiC;QACjC,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAA,YAAY,IAAI,CAAC,YAAY,YAAY,CAAC,CAAC,CAAC,IAAI,CAAA,GAAG,SAAS,EAAE,EAAE,CAAC;IAClG,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;QAChC,MAAM,WAAW,GAAG,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC;QAC/C,uEAAuE;QACvE,uEAAuE;QACvE,wEAAwE;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,GAAG,UAAU,CACrB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,iBAAiB,CACvB,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC;QAE9C,OAAO,IAAI,CAAA;;oDAEqC,IAAI,CAAC,eAAe,EAAE;;oCAEtC,IAAI,IAAI,IAAI,CAAC,aAAa,IAAI,WAAW;sCACvC,CAAC,QAAQ,IAAI,QAAQ,IAAI,OAAO;0CAC5B,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,YAAY,CAAC,IAAI,IAAI,IAAI,IAAI,OAAO;;UAE/G,SAAS;YACT,CAAC,CAAC,IAAI,CAAC,kBAAkB;gBACvB,CAAC,CAAC,IAAI,CAAA;;;;kCAIgB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC;;;+BAGnC,GAAG,IAAI,CAAC,cAAc,IAAI,WAAW,EAAE;;oDAElB,eAAe,IAAI,CAAC,eAAe,GAAG;;eAE3E;gBACH,CAAC,CAAC,IAAI,CAAA,iDAAiD,GAAG,IAAI,CAAC,cAAc,IAAI,WAAW,EAAE,UAAU;YAC1G,CAAC,CAAC,OAAO;UACT,IAAI,CAAC,MAAM,KAAK,OAAO;YACvB,CAAC,CAAC,IAAI,CAAA,wDAAwD,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,WAAW,IAAI,CAAC,YAAY;gBACzL,SAAS,EAAE;sBACL;YACZ,CAAC,CAAC,OAAO;UACT,IAAI,CAAC,SAAS;YACd,CAAC,CAAC,IAAI,CAAA,yDAAyD,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,WAAW,EAAE,WAAW,IAAI,CAAC,aAAa;gBAC/L,SAAS,EAAE;sBACL;YACZ,CAAC,CAAC,OAAO;;KAEd,CAAC;IACJ,CAAC;CACF;AArNiC;IAA/B,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;gDAAa;AAGhC;IAAX,QAAQ,EAAE;gDAAW;AAGM;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gDAAU;AAGC;IAArC,QAAQ,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;oDAAe;AAOV;IAAzC,QAAQ,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;wDAAmB;AAG/B;IAA5B,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;kDAA0C;AAI1C;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oDAAc;AAGG;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;qDAAkB;AAMjB;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;mDAAiB;AAOa;IAAxE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;yDAAuB;AAMtD;IAAxC,QAAQ,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;uDAAwB;AAMxB;IAAvC,QAAQ,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;sDAAsB;AAOjB;IAA3C,QAAQ,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;0DAA8B;AAKzB;IAA/C,QAAQ,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;6DAAqC;AAKzC;IAA1C,QAAQ,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;yDAAiC"}

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

@@ -1,141 +1,2 @@
-import { type TemplateResult } from 'lit';
-import { LyraElement } from '../../internal/lyra-element.js';
-export type AttachmentChipStatus = 'pending' | 'uploading' | 'error' | 'done';
-export interface AttachmentChipIdDetail {
-    id: string;
-}
-/**
- * `512` -> `"512 B"`; `2415919` -> `"2.3 MB"`. Whole bytes never get a
- * decimal (there's no meaningful fraction of a byte); every unit past that
- * gets exactly one decimal place. Returns `""` for a negative/non-finite
- * input so a missing/unknown size renders nothing instead of `"NaN B"`.
- */
-export declare function formatFileSize(bytes: number): string;
-/**
- * `<lyra-attachment-chip>` — a compact chip representing one file queued for
- * (or already part of) a chat message: a composer's pre-send attachment
- * tray, or a sent message's `attachments` slot (see `<lyra-chat-message>`).
- *
- * Two independent ways to populate it, matching the two points in a message's
- * lifecycle this is used at:
- *  - Set `file` to a real `File` (fresh from a picker/drop) — `name`, `size`,
- *    `mime-type` and the image thumbnail are all auto-derived from it.
- *  - Set the plain `name`/`size`/`mime-type`/`thumbnail-src` props instead,
- *    for reconstructing a chip from server-persisted attachment metadata
- *    (e.g. after a page reload, when no real `File` object exists any more).
- *
- * `file` always wins when both are present — see each accessor's own doc.
- * The image thumbnail for a real `File` is a cached `URL.createObjectURL()`
- * blob URL, created in the update lifecycle immediately before the thumbnail
- * renders and revoked automatically once `file`
- * changes away from the object it was created for, and on disconnect — this
- * component never leaks a blob URL.
- *
- * Identifying *which* attachment a `lyra-remove`/`lyra-retry` event is about:
- * this deliberately reuses the platform's own `id`/`id` attribute (every
- * element already has one; there's no need to shadow it with a second,
- * differently-named Lit property, unlike e.g. `<lyra-tool-call-chip>`'s
- * `call-id` which identifies a *call*, a concept distinct from the chip
- * element itself). Set `id="..."` when you have a stable server-side
- * attachment id. When `id` is left unset and `file` is set, a stable id is
- * derived from `` `${file.name}:${file.size}:${file.lastModified}` `` — stable
- * across re-renders of the *same* `File` object without requiring the
- * consumer to invent one. When neither is available, a generated internal id
- * is used as a last resort so the event always has *some* id.
- *
- * i18n/locale: every translatable word rendered by this component is
- * override-able via a dedicated property — `removeLabel`/`retryLabel`
- * (the verb prefixed to the remove/retry buttons' `aria-label`, keeping the
- * `displayName` interpolation), and `uploadingLabel`/`uploadFailedLabel` (the
- * verb/phrase used in the visible `status-text`, keeping the live percentage
- * interpolation for `uploadingLabel`). All four default to today's exact
- * hardcoded English text (`'Remove'`, `'Retry'`, `'Uploading'`, `'Upload
- * failed'`), so leaving them unset changes nothing. These are plain
- * properties, not slots — this component still exposes no slots.
- *
- * @customElement lyra-attachment-chip
- * @event lyra-remove - The user activated the remove (×) button. `detail: { id }`. Only rendered while `removable`.
- * @event lyra-retry - The user activated the retry button. `detail: { id }`. Only rendered while `status="error"`.
- * @csspart base - The chip's root container.
- * @csspart thumbnail - The leading image thumbnail / generic file glyph.
- * @csspart meta - Wrapper around `name` and `size`.
- * @csspart name - The filename (ellipsis-truncated via CSS; the untruncated name is always available via the native `title` tooltip).
- * @csspart size - The human-readable formatted file size. Hidden when no size is known.
- * @csspart status-text - The visible text twin of the status accent color — carries the state in text, not just color. Empty/hidden for `pending`/`done`. Gets `role="alert"` for `status="error"` only, so a screen-reader user not already focused on the chip still hears an upload failure; the ticking `'uploading'` readout deliberately stays out of the accessibility tree the same way `<lyra-generation-status>`'s per-second elapsed/token readout does — a live region re-announcing every progress tick would be noise, not information, while a one-shot failure is exactly the kind of infrequent, actionable transition a live region exists for.
- * @csspart progress - The numeric upload progress bar (`role="progressbar"`), shown only while `status="uploading"` and `progress` is a meaningful (>0) number.
- * @csspart progress-fill - The filled portion of `progress`.
- * @csspart spinner - The indeterminate upload spinner, shown instead of `progress` while `status="uploading"` and `progress` is unset/0.
- * @csspart retry-button - The retry affordance, only rendered while `status="error"`.
- * @csspart remove-button - The remove (×) affordance, only rendered while `removable`.
- */
-export declare class LyraAttachmentChip extends LyraElement {
-    static styles: import("lit").CSSResultGroup[];
-    /** A real `File`, e.g. fresh from `<lyra-file-input>`'s `lyra-files` event.
-     *  When set, `name`/`size`/`mime-type`/the image thumbnail are all derived
-     *  from it, taking precedence over the independent props below. */
-    file?: File;
-    /** Filename, used only while `file` is unset. */
-    name: string;
-    /** File size in bytes, used only while `file` is unset. */
-    size: number;
-    /** MIME type, used only while `file` is unset. */
-    mimeType: string;
-    /** Thumbnail image URL, used only while `file` is unset (a real `File`'s
-     *  thumbnail always comes from a generated object URL instead — see the
-     *  class doc). Unlike the other independent props this one has no
-     *  `file`-derived equivalent to defer to for a non-image file; it's simply
-     *  rendered whenever present. */
-    thumbnailSrc: string;
-    /** Lifecycle state — drives the accent tint and which of `progress`/`spinner`/`retry-button` renders. */
-    status: AttachmentChipStatus;
-    /** Upload completion, 0-100. Only meaningful while `status="uploading"`;
-     *  a value of 0 (the default) or `NaN` falls back to the indeterminate spinner. */
-    progress: number;
-    /** Shows the remove (×) button. */
-    removable: boolean;
-    /** Verb used in the remove button's `aria-label`, interpolated as
-     *  `` `${removeLabel} ${displayName}` `` -- override for i18n/locale.
-     *  Defaults to `'Remove'`, reproducing today's exact `"Remove ${displayName}"`
-     *  text byte-for-byte. */
-    removeLabel: string;
-    /** Verb used in the retry button's `aria-label`, interpolated as
-     *  `` `${retryLabel} ${displayName}` `` -- override for i18n/locale.
-     *  Defaults to `'Retry'`, reproducing today's exact `"Retry ${displayName}"`
-     *  text byte-for-byte. */
-    retryLabel: string;
-    /** Verb used in the visible uploading status text -- rendered as
-     *  `` `${uploadingLabel} ${percent}%` `` once progress is a meaningful
-     *  number, else `` `${uploadingLabel}…` ``. Override for i18n/locale.
-     *  Defaults to `'Uploading'`, reproducing today's exact `"Uploading N%"`/
-     *  `"Uploading…"` text byte-for-byte. */
-    uploadingLabel: string;
-    /** Visible status text shown for `status="error"`. Override for
-     *  i18n/locale. Defaults to `'Upload failed'`, reproducing today's exact
-     *  text byte-for-byte. */
-    uploadFailedLabel: string;
-    private objectUrl?;
-    private objectUrlFile?;
-    private readonly fallbackId;
-    private get effectiveName();
-    private get effectiveSize();
-    private get effectiveMimeType();
-    private get resolvedId();
-    private get hasNumericProgress();
-    private get clampedProgress();
-    /** Returns (creating or reusing as needed) the object URL for `file`'s
-     * image thumbnail. Called from the update lifecycle, never from `render()`,
-     * so rendering stays a pure projection of already-prepared state. */
-    private ensureObjectUrl;
-    private revokeObjectUrl;
-    protected willUpdate(): void;
-    disconnectedCallback(): void;
-    private onRemoveClick;
-    private onRetryClick;
-    private renderThumbnail;
-    render(): TemplateResult;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'lyra-attachment-chip': LyraAttachmentChip;
-    }
-}
+export * from './attachment-chip.class.js';
+//# sourceMappingURL=attachment-chip.d.ts.map

package/dist/components/attachment-chip/attachment-chip.d.ts.map

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