@stigmer/react 3.9.0 → 3.10.0

package/attachment/AttachmentChipList.d.ts

@@ -7,14 +7,26 @@ export interface AttachmentChipListProps {
     readonly onRemove: (id: string) => void;
     /** Retry callback for failed uploads (by entry ID). */
     readonly onRetry: (id: string) => void;
-    /** Disables remove and retry actions. */
+    /**
+     * Called when the user clicks an image chip's preview target. When
+     * provided, it **replaces** the built-in lightbox — platform builders
+     * route the click to their own viewer. Omit for the default behavior:
+     * a full-size image lightbox over the locally-held file bytes.
+     */
+    readonly onPreview?: (entry: AttachmentEntry) => void;
+    /** Disables remove and retry actions. Preview stays active — it is read-only. */
     readonly disabled?: boolean;
     /** Additional CSS class names for the root container. */
     readonly className?: string;
 }
 /**
- * Renders a horizontal list of compact attachment chips showing
- * filename, size, upload status, and remove/retry actions.
+ * Renders a horizontal list of attachment chips: image attachments as
+ * preview-only thumbnail tiles (the image IS the chip — no filename
+ * text; visible from the moment of paste, through upload, and on error
+ * — stigmer/stigmer#371, #372), other files as compact filename chips.
+ * Filename, size, and upload status stay available on every chip via
+ * the tooltip and the accessible label; clicking an image tile opens
+ * the full image.
  *
  * Designed to sit between the context chips and toolbar in
  * {@link SessionComposer}, but usable standalone by platform builders
@@ -37,5 +49,5 @@ export interface AttachmentChipListProps {
  * }
  * ```
  */
-export declare function AttachmentChipList({ entries, onRemove, onRetry, disabled, className, }: AttachmentChipListProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AttachmentChipList({ entries, onRemove, onRetry, onPreview, disabled, className, }: AttachmentChipListProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=AttachmentChipList.d.ts.map

package/attachment/AttachmentChipList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentChipList.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE,uBAAuB,kDAoBzB"}
+{"version":3,"file":"AttachmentChipList.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,GACV,EAAE,uBAAuB,kDAgDzB"}

package/attachment/AttachmentChipList.js

@@ -1,11 +1,19 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
 import { cn } from "@stigmer/theme";
 import { formatFileSize } from "./attachment-utils.js";
+import { useObjectUrl } from "./useObjectUrl.js";
+import { AttachmentImageLightbox } from "./AttachmentImageLightbox.js";
+import { UNSTYLED_BUTTON } from "../internal/form-primitives.js";
 /**
- * Renders a horizontal list of compact attachment chips showing
- * filename, size, upload status, and remove/retry actions.
+ * Renders a horizontal list of attachment chips: image attachments as
+ * preview-only thumbnail tiles (the image IS the chip — no filename
+ * text; visible from the moment of paste, through upload, and on error
+ * — stigmer/stigmer#371, #372), other files as compact filename chips.
+ * Filename, size, and upload status stay available on every chip via
+ * the tooltip and the accessible label; clicking an image tile opens
+ * the full image.
  *
  * Designed to sit between the context chips and toolbar in
  * {@link SessionComposer}, but usable standalone by platform builders
@@ -28,54 +36,112 @@ import { formatFileSize } from "./attachment-utils.js";
  * }
  * ```
  */
-export function AttachmentChipList({ entries, onRemove, onRetry, disabled, className, }) {
+export function AttachmentChipList({ entries, onRemove, onRetry, onPreview, disabled, className, }) {
+    // The built-in lightbox tracks the previewed entry by ID (direct identity,
+    // never object reference), and the entry itself is derived from `entries`
+    // on render — so removing an attachment while its preview is open closes
+    // the lightbox without any effect-based synchronization.
+    const [previewId, setPreviewId] = useState(null);
+    const previewEntry = previewId !== null ? (entries.find((e) => e.id === previewId) ?? null) : null;
     if (entries.length === 0)
         return null;
-    return (_jsx("div", { className: cn("flex flex-wrap gap-1.5", className), role: "list", "aria-label": "Attached files", children: entries.map((entry) => (_jsx(AttachmentChip, { entry: entry, onRemove: () => onRemove(entry.id), onRetry: () => onRetry(entry.id), disabled: disabled }, entry.id))) }));
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: cn("flex flex-wrap items-center gap-1.5", className), role: "list", "aria-label": "Attached files", children: entries.map((entry) => (_jsx(AttachmentChip, { entry: entry, onRemove: () => onRemove(entry.id), onRetry: () => onRetry(entry.id), onPreview: onPreview
+                        ? () => onPreview(entry)
+                        : () => setPreviewId(entry.id), disabled: disabled }, entry.id))) }), previewEntry && (_jsx(ChipPreviewLightbox, { entry: previewEntry, onClose: () => setPreviewId(null) }))] }));
 }
 // ---------------------------------------------------------------------------
-// Individual chip
+// Individual chip — dispatches on content type
 // ---------------------------------------------------------------------------
-function AttachmentChip({ entry, onRemove, onRetry, disabled, }) {
-    const isError = entry.phase === "error";
+function AttachmentChip({ entry, onRemove, onRetry, onPreview, disabled, }) {
+    return entry.contentType.startsWith("image/") ? (_jsx(ImageAttachmentChip, { entry: entry, onRemove: onRemove, onRetry: onRetry, onPreview: onPreview, disabled: disabled })) : (_jsx(FileAttachmentChip, { entry: entry, onRemove: onRemove, onRetry: onRetry, disabled: disabled }));
+}
+/** Shared accessible name: filename, size, and upload status. */
+function chipAriaLabel(entry) {
     const isUploading = entry.phase === "uploading";
-    return (_jsxs("span", { role: "listitem", "aria-label": `${entry.file.name}, ${formatFileSize(entry.file.size)}${isUploading ? ", uploading" : ""}${isError ? ", upload failed" : ""}`, className: cn("inline-flex max-w-[200px] items-center gap-1 rounded-md px-2 py-0.5 text-xs", isError
-            ? "border border-destructive/30 bg-destructive-subtle text-destructive"
-            : "bg-muted-subtle text-foreground", isUploading && "opacity-70"), children: [isUploading && _jsx(ChipSpinner, {}), isError && _jsx(ErrorDot, {}), !isUploading && !isError &&
-                (entry.contentType.startsWith("image/") ? (_jsx(ChipThumbnail, { file: entry.file })) : (_jsx(FileIcon, {}))), _jsx("span", { className: "truncate", children: entry.file.name }), _jsx("span", { className: "shrink-0 text-[0.6rem] tabular-nums text-muted-foreground", children: formatFileSize(entry.file.size) }), isError && (_jsx("button", { type: "button", onClick: onRetry, disabled: disabled, className: "shrink-0 text-[0.6rem] font-medium text-destructive underline hover:text-destructive-muted disabled:pointer-events-none", "aria-label": `Retry uploading ${entry.file.name}`, children: "Retry" })), _jsx("button", { type: "button", onClick: onRemove, disabled: disabled, className: "ml-0.5 shrink-0 text-muted-foreground hover:text-destructive disabled:pointer-events-none", "aria-label": `Remove ${entry.file.name}`, children: _jsx(XIcon, {}) })] }));
+    const isError = entry.phase === "error";
+    return `${entry.file.name}, ${formatFileSize(entry.file.size)}${isUploading ? ", uploading" : ""}${isError ? ", upload failed" : ""}`;
 }
 // ---------------------------------------------------------------------------
-// Image thumbnail — a #284 ask: a pasted screenshot's chip shows the image,
-// not a generic file glyph
+// Image chip — a preview-only thumbnail tile (#371, #372)
 // ---------------------------------------------------------------------------
 /**
- * Tiny preview of an image attachment, driven by an object URL over the
- * locally-held `File` (no fetch — the bytes are already in memory).
+ * The preview-only image tile: the thumbnail IS the chip. No filename
+ * text, no size caption — the image is its own identity (the grammar
+ * users know from Cursor/ChatGPT attachment tiles), while filename,
+ * size, and upload status stay one hover away in the tooltip and are
+ * always in the accessible label.
+ *
+ * The tile is alive through every upload phase (the spinner overlays
+ * the image during upload, never replaces it — the bytes are local, so
+ * the preview never waits on the network) and is one large click
+ * target that opens the full image. Remove is an always-visible corner
+ * badge — never hover-revealed, so it exists on touch devices and is
+ * discoverable without a pointer.
  *
- * The URL is created in an effect, not a memo: StrictMode double-invokes
- * memos and would leak the first URL without a revoke. The effect cleanup
- * revokes on removal, unmount, and file change. Until the effect runs (or
- * if it never gets a URL) the generic icon renders instead.
+ * On upload error the tile stays loud: destructive ring, dimmed image,
+ * and a centered Retry pill — failure never hides behind hover.
  *
- * `aria-hidden`: the chip's own `aria-label` already names the file; a
- * 16px thumbnail adds nothing for screen readers.
+ * If the file claims `image/*` but the browser can't decode it (corrupt,
+ * zero-byte), the chip degrades to the compact file-chip treatment — a
+ * generic icon and no preview affordance, never a broken-image glyph.
+ */
+function ImageAttachmentChip({ entry, onRemove, onRetry, onPreview, disabled, }) {
+    const url = useObjectUrl(entry.file);
+    const [loadFailed, setLoadFailed] = useState(false);
+    if (loadFailed) {
+        return (_jsx(FileAttachmentChip, { entry: entry, onRemove: onRemove, onRetry: onRetry, disabled: disabled }));
+    }
+    const isError = entry.phase === "error";
+    const isUploading = entry.phase === "uploading";
+    return (
+    // The remove badge and retry pill are SIBLINGS of the preview button,
+    // absolutely positioned over it — buttons cannot nest inside buttons.
+    _jsxs("span", { role: "listitem", "aria-label": chipAriaLabel(entry), title: entry.file.name, className: "relative inline-flex", children: [_jsxs("button", { type: "button", onClick: onPreview, "aria-label": `Preview ${entry.file.name}`, className: cn(UNSTYLED_BUTTON, "relative block h-14 w-14 overflow-hidden rounded-md focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isError && "ring-1 ring-destructive"), children: [url ? (_jsx("img", { src: url, alt: "", "aria-hidden": "true", onError: () => setLoadFailed(true), className: cn("h-full w-full object-cover", (isUploading || isError) && "opacity-50") })) : (
+                    // One-frame placeholder until the object-URL effect runs; same
+                    // footprint as the image, so no layout shift.
+                    _jsx("span", { className: "block h-full w-full animate-pulse bg-muted", "aria-hidden": "true" })), isUploading && (_jsx("span", { className: "absolute inset-0 flex items-center justify-center", children: _jsx(ChipSpinner, { size: 16 }) }))] }), isError && (_jsx("button", { type: "button", onClick: onRetry, disabled: disabled, "aria-label": `Retry uploading ${entry.file.name}`, className: cn(UNSTYLED_BUTTON, "absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 rounded-full bg-destructive px-1.5 py-0.5 text-[0.6rem] font-medium leading-none text-destructive-foreground shadow-sm [font-family:inherit] hover:bg-destructive-hover disabled:pointer-events-none"), children: "Retry" })), _jsx("button", { type: "button", onClick: onRemove, disabled: disabled, "aria-label": `Remove ${entry.file.name}`, className: cn(UNSTYLED_BUTTON, 
+                // The established corner-badge geometry (ContextPopover,
+                // ComposerToolbar). Solid bg + border keep it legible over any
+                // image without opacity-modified tokens (Dont-Do #4).
+                "absolute -right-1.5 -top-1.5 flex h-4 w-4 items-center justify-center rounded-full border border-border bg-background text-muted-foreground shadow-sm hover:text-destructive disabled:pointer-events-none"), children: _jsx(XIcon, {}) })] }));
+}
+// ---------------------------------------------------------------------------
+// File chip — the compact treatment for non-image attachments
+// ---------------------------------------------------------------------------
+function FileAttachmentChip({ entry, onRemove, onRetry, disabled, }) {
+    const isError = entry.phase === "error";
+    const isUploading = entry.phase === "uploading";
+    return (_jsxs("span", { role: "listitem", "aria-label": chipAriaLabel(entry), className: cn("inline-flex max-w-[200px] items-center gap-1 rounded-md px-2 py-0.5 text-xs", isError
+            ? "border border-destructive/30 bg-destructive-subtle text-destructive"
+            : "bg-muted-subtle text-foreground", isUploading && "opacity-70"), children: [isUploading && _jsx(ChipSpinner, {}), isError && _jsx(ErrorDot, {}), !isUploading && !isError && _jsx(FileIcon, {}), _jsx("span", { className: "truncate", children: entry.file.name }), _jsx("span", { className: "shrink-0 text-[0.6rem] tabular-nums text-muted-foreground", children: formatFileSize(entry.file.size) }), isError && _jsx(RetryButton, { filename: entry.file.name, onRetry: onRetry, disabled: disabled }), _jsx(RemoveButton, { filename: entry.file.name, onRemove: onRemove, disabled: disabled })] }));
+}
+// ---------------------------------------------------------------------------
+// Shared chip actions
+// ---------------------------------------------------------------------------
+function RetryButton({ filename, onRetry, disabled, }) {
+    return (_jsx("button", { type: "button", onClick: onRetry, disabled: disabled, className: cn(UNSTYLED_BUTTON, "shrink-0 text-[0.6rem] font-medium text-destructive underline [font-family:inherit] hover:text-destructive-muted disabled:pointer-events-none"), "aria-label": `Retry uploading ${filename}`, children: "Retry" }));
+}
+function RemoveButton({ filename, onRemove, disabled, }) {
+    return (_jsx("button", { type: "button", onClick: onRemove, disabled: disabled, className: cn(UNSTYLED_BUTTON, "ml-0.5 shrink-0 text-muted-foreground hover:text-destructive disabled:pointer-events-none"), "aria-label": `Remove ${filename}`, children: _jsx(XIcon, {}) }));
+}
+// ---------------------------------------------------------------------------
+// Built-in lightbox mount
+// ---------------------------------------------------------------------------
+/**
+ * Bridges the previewed entry to the dumb {@link AttachmentImageLightbox}:
+ * mounted only while a preview is open, so its object URL is created on
+ * open and revoked on close (independent of the chip's own URL, whose
+ * lifetime tracks the chip).
  */
-function ChipThumbnail({ file }) {
-    const [url, setUrl] = useState(null);
-    useEffect(() => {
-        const objectUrl = URL.createObjectURL(file);
-        setUrl(objectUrl);
-        return () => URL.revokeObjectURL(objectUrl);
-    }, [file]);
-    if (!url)
-        return _jsx(FileIcon, {});
-    return (_jsx("img", { src: url, alt: "", "aria-hidden": "true", className: "h-4 w-4 shrink-0 rounded-sm object-cover" }));
+function ChipPreviewLightbox({ entry, onClose, }) {
+    const src = useObjectUrl(entry.file);
+    return (_jsx(AttachmentImageLightbox, { src: src, filename: entry.file.name, open: true, onClose: onClose }));
 }
 // ---------------------------------------------------------------------------
 // Inline SVG icons — kept minimal and consistent with SessionComposer icons
 // ---------------------------------------------------------------------------
-function ChipSpinner() {
-    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", className: "shrink-0 animate-spin text-muted-foreground", "aria-hidden": "true", children: _jsx("path", { d: "M8 2a6 6 0 1 0 6 6" }) }));
+function ChipSpinner({ size = 10 }) {
+    return (_jsx("svg", { width: size, height: size, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", className: "shrink-0 animate-spin text-muted-foreground", "aria-hidden": "true", children: _jsx("path", { d: "M8 2a6 6 0 1 0 6 6" }) }));
 }
 function ErrorDot() {
     return (_jsx("span", { className: "inline-block h-1.5 w-1.5 shrink-0 rounded-full bg-destructive", "aria-hidden": "true" }));

package/attachment/AttachmentChipList.js.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentChipList.js","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AttachmentChipList.js","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"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"}

package/attachment/AttachmentImageLightbox.d.ts

@@ -0,0 +1,39 @@
+/** Props for {@link AttachmentImageLightbox}. */
+export interface AttachmentImageLightboxProps {
+    /**
+     * Image source URL. `null` for the first-paint frame before the caller's
+     * object URL exists — the lightbox shows a pulse placeholder, never a
+     * broken-image glyph.
+     */
+    readonly src: string | null;
+    /** Filename shown in the header and used as the image alt text. */
+    readonly filename: string;
+    /** Controls visibility. `true` opens the dialog via `showModal()`. */
+    readonly open: boolean;
+    /** Called when the lightbox should close (Escape, backdrop click, close button). */
+    readonly onClose: () => void;
+    /** Additional CSS classes for the dialog element. */
+    readonly className?: string;
+}
+/**
+ * Full-size image preview in a native `<dialog>` — the click-to-open target
+ * for composer attachment chips (stigmer/stigmer#371).
+ *
+ * A thin modal shell following the SDK's established dialog pattern
+ * ({@link ArtifactPreviewModal}): `showModal()`/`close()` driven by the
+ * `open` prop, Escape via the intercepted `cancel` event, focus trap and
+ * top layer native — no portal plumbing, no `@base-ui/react` dependency.
+ * Backdrop click closes via the canonical `e.target === dialog` check
+ * (clicks on content children never match the dialog element itself).
+ *
+ * Deliberately dumb (`src` + `filename`, no attachment types): liftable to
+ * `internal/` unchanged if other image surfaces (e.g. tool-output
+ * screenshots in `ResultView`) later want in-app preview instead of
+ * open-in-new-tab.
+ *
+ * The backdrop uses the `--stgm-backdrop` theme token ("modal backdrop
+ * overlay behind dialogs") rather than the `bg-black/50` hardcode found in
+ * older dialogs — the token is the designed value (Dont-Do #3).
+ */
+export declare function AttachmentImageLightbox({ src, filename, open, onClose, className, }: AttachmentImageLightboxProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AttachmentImageLightbox.d.ts.map

package/attachment/AttachmentImageLightbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentImageLightbox.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentImageLightbox.tsx"],"names":[],"mappings":"AAKA,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,GACV,EAAE,4BAA4B,2CAmF9B"}

package/attachment/AttachmentImageLightbox.js

@@ -0,0 +1,57 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef } from "react";
+import { cn } from "@stigmer/theme";
+/**
+ * Full-size image preview in a native `<dialog>` — the click-to-open target
+ * for composer attachment chips (stigmer/stigmer#371).
+ *
+ * A thin modal shell following the SDK's established dialog pattern
+ * ({@link ArtifactPreviewModal}): `showModal()`/`close()` driven by the
+ * `open` prop, Escape via the intercepted `cancel` event, focus trap and
+ * top layer native — no portal plumbing, no `@base-ui/react` dependency.
+ * Backdrop click closes via the canonical `e.target === dialog` check
+ * (clicks on content children never match the dialog element itself).
+ *
+ * Deliberately dumb (`src` + `filename`, no attachment types): liftable to
+ * `internal/` unchanged if other image surfaces (e.g. tool-output
+ * screenshots in `ResultView`) later want in-app preview instead of
+ * open-in-new-tab.
+ *
+ * The backdrop uses the `--stgm-backdrop` theme token ("modal backdrop
+ * overlay behind dialogs") rather than the `bg-black/50` hardcode found in
+ * older dialogs — the token is the designed value (Dont-Do #3).
+ */
+export function AttachmentImageLightbox({ src, filename, open, onClose, className, }) {
+    const dialogRef = useRef(null);
+    useEffect(() => {
+        const dialog = dialogRef.current;
+        if (!dialog)
+            return;
+        if (open && !dialog.open) {
+            dialog.showModal();
+        }
+        else if (!open && dialog.open) {
+            dialog.close();
+        }
+    }, [open]);
+    // Escape arrives as the native `cancel` event; intercept it so the
+    // caller's `open` prop stays the single source of truth for visibility.
+    const handleCancel = useCallback((e) => {
+        e.preventDefault();
+        onClose();
+    }, [onClose]);
+    const handleBackdropClick = useCallback((e) => {
+        if (e.target === dialogRef.current) {
+            onClose();
+        }
+    }, [onClose]);
+    return (_jsx("dialog", { ref: dialogRef, onCancel: handleCancel, onClick: handleBackdropClick, "aria-label": `Preview ${filename}`, className: cn("fixed inset-0 m-auto max-h-[85vh] max-w-[85vw] rounded-lg border border-border bg-background p-0 text-foreground shadow-lg outline-none", "backdrop:bg-backdrop", className), children: open && (_jsxs("div", { className: "flex flex-col", children: [_jsxs("div", { className: "flex items-center gap-2 px-3 py-2", children: [_jsx("span", { className: "min-w-0 flex-1 truncate text-xs font-semibold text-foreground", title: filename, children: filename }), _jsx("button", { type: "button", onClick: onClose, "aria-label": "Close image preview", className: "shrink-0 cursor-pointer rounded bg-transparent p-0.5 text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", children: _jsx(CloseIcon, {}) })] }), _jsx("div", { className: "min-h-0 overflow-auto border-t border-border", children: src ? (_jsx("img", { src: src, alt: filename, className: "block max-h-[75vh] max-w-full object-contain" })) : (_jsx("div", { className: "h-48 w-72 animate-pulse bg-muted", "aria-hidden": "true" })) })] })) }));
+}
+// ---------------------------------------------------------------------------
+// Inline SVG icons (SDK pattern: no external icon dependency)
+// ---------------------------------------------------------------------------
+function CloseIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M3 3L11 11" }), _jsx("path", { d: "M11 3L3 11" })] }));
+}
+//# sourceMappingURL=AttachmentImageLightbox.js.map

package/attachment/AttachmentImageLightbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentImageLightbox.js","sourceRoot":"","sources":["../../src/attachment/AttachmentImageLightbox.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAoBpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,GACoB;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,mEAAmE;IACnE,wEAAwE;IACxE,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,CAAuB,EAAE,EAAE;QAC1B,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,mBAAmB,GAAG,WAAW,CACrC,CAAC,CAAsC,EAAE,EAAE;QACzC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,CACL,iBACE,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,mBAAmB,gBAChB,WAAW,QAAQ,EAAE,EACjC,SAAS,EAAE,EAAE,CACX,yIAAyI,EACzI,sBAAsB,EACtB,SAAS,CACV,YAEA,IAAI,IAAI,CACP,eAAK,SAAS,EAAC,eAAe,aAC5B,eAAK,SAAS,EAAC,mCAAmC,aAChD,eACE,SAAS,EAAC,+DAA+D,EACzE,KAAK,EAAE,QAAQ,YAEd,QAAQ,GACJ,EAGP,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,gBACL,qBAAqB,EAChC,SAAS,EAAC,4LAA4L,YAEtM,KAAC,SAAS,KAAG,GACN,IACL,EACN,cAAK,SAAS,EAAC,8CAA8C,YAC1D,GAAG,CAAC,CAAC,CAAC,CACL,cACE,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,QAAQ,EACb,SAAS,EAAC,8CAA8C,GACxD,CACH,CAAC,CAAC,CAAC,CACF,cACE,SAAS,EAAC,kCAAkC,iBAChC,MAAM,GAClB,CACH,GACG,IACF,CACP,GACM,CACV,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,SAAS,SAAS;IAChB,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,aAElB,eAAM,CAAC,EAAC,YAAY,GAAG,EACvB,eAAM,CAAC,EAAC,YAAY,GAAG,IACnB,CACP,CAAC;AACJ,CAAC"}

package/attachment/useObjectUrl.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Object URL over a locally-held `Blob` (or `File`), alive for the lifetime
+ * of the mounted component (no fetch — the bytes are already in memory).
+ *
+ * The URL is created in an effect, not a memo: StrictMode double-invokes
+ * memos and would leak the first URL without a revoke. The effect cleanup
+ * revokes on unmount and on blob change. Returns `null` until the effect
+ * runs (first paint) — callers render a fallback for that frame.
+ *
+ * Deliberately display-oriented: the SDK's other `createObjectURL` calls
+ * (`useExportResource`, `useExportCSV`) are fire-and-forget download
+ * helpers with an immediate revoke, a different lifecycle from this one.
+ */
+export declare function useObjectUrl(blob: Blob): string | null;
+//# sourceMappingURL=useObjectUrl.d.ts.map

package/attachment/useObjectUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectUrl.d.ts","sourceRoot":"","sources":["../../src/attachment/useObjectUrl.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAUtD"}

package/attachment/useObjectUrl.js

@@ -0,0 +1,25 @@
+"use client";
+import { useEffect, useState } from "react";
+/**
+ * Object URL over a locally-held `Blob` (or `File`), alive for the lifetime
+ * of the mounted component (no fetch — the bytes are already in memory).
+ *
+ * The URL is created in an effect, not a memo: StrictMode double-invokes
+ * memos and would leak the first URL without a revoke. The effect cleanup
+ * revokes on unmount and on blob change. Returns `null` until the effect
+ * runs (first paint) — callers render a fallback for that frame.
+ *
+ * Deliberately display-oriented: the SDK's other `createObjectURL` calls
+ * (`useExportResource`, `useExportCSV`) are fire-and-forget download
+ * helpers with an immediate revoke, a different lifecycle from this one.
+ */
+export function useObjectUrl(blob) {
+    const [url, setUrl] = useState(null);
+    useEffect(() => {
+        const objectUrl = URL.createObjectURL(blob);
+        setUrl(objectUrl);
+        return () => URL.revokeObjectURL(objectUrl);
+    }, [blob]);
+    return url;
+}
+//# sourceMappingURL=useObjectUrl.js.map

package/attachment/useObjectUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectUrl.js","sourceRoot":"","sources":["../../src/attachment/useObjectUrl.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEpD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,CAAC;QAClB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,GAAG,CAAC;AACb,CAAC"}

package/conversation/ConversationMediaAttachment.d.ts

@@ -0,0 +1,45 @@
+import type { ConversationMediaRef } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+/**
+ * The full address of one timeline item's media — what
+ * `getMediaDownloadUrl` is addressed by. The storage key deliberately
+ * never rides the wire (whatsapp-media DD-001 D4); the server resolves
+ * it from its own row, so this address is all a client ever holds.
+ */
+export interface ConversationMediaAddress {
+    /** AgentChannel the conversation belongs to. */
+    readonly agentChannelId: string;
+    /** Conversation key within the channel (WhatsApp: the customer's wa_id). */
+    readonly conversationKey: string;
+    /** The timeline item carrying the media (its item_id, e.g. `"wa:<wamid>"`). */
+    readonly itemId: string;
+}
+/** Props for {@link ConversationMediaAttachment}. */
+export interface ConversationMediaAttachmentProps {
+    /** The item's media reference (filename, content type, size). */
+    readonly media: ConversationMediaRef;
+    /** Where to fetch the bytes from. */
+    readonly address: ConversationMediaAddress;
+    /** Additional CSS classes for the container. */
+    readonly className?: string;
+}
+/**
+ * One inbound timeline item's ingested media (stigmer/stigmer#367):
+ * images as a WhatsApp-style inline thumbnail (click opens the shared
+ * {@link AttachmentImageLightbox}), everything else as a document chip
+ * (filename + size, click opens the file in a new tab).
+ *
+ * This component calls `useStigmer()`, so it must only be MOUNTED when
+ * the timeline view holds a conversation address — that conditional
+ * mount is what keeps `ConversationTimelineView` renderable without a
+ * `StigmerProvider` (its presentational contract; see the view's
+ * `agentChannelId` prop).
+ *
+ * Deliberately a sibling of the execution thread's `MessageAttachments`,
+ * not a reuse of it: that row renders storage-key-addressed artifacts of
+ * an execution the viewer owns, while this one renders
+ * conversation-viewer-scoped media addressed by timeline position — the
+ * two read paths have different trust models (DD-001 D4) and different
+ * bubble treatments (chat thumbnail vs. attachment chip row).
+ */
+export declare function ConversationMediaAttachment({ media, address, className, }: ConversationMediaAttachmentProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConversationMediaAttachment.d.ts.map

package/conversation/ConversationMediaAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationMediaAttachment.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationMediaAttachment.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uEAAuE,CAAC;AASlH;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,OAAO,EACP,SAAS,GACV,EAAE,gCAAgC,2CAOlC"}

package/conversation/ConversationMediaAttachment.js

@@ -0,0 +1,153 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { GetConversationMediaDownloadUrlInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { AttachmentImageLightbox } from "../attachment/AttachmentImageLightbox.js";
+import { formatFileSize } from "../attachment/attachment-utils.js";
+import { UNSTYLED_BUTTON } from "../internal/form-primitives.js";
+import { toError } from "../internal/toError.js";
+import { useStigmer } from "../hooks.js";
+import { useConversationMediaUrl } from "./useConversationMediaUrl.js";
+/**
+ * One inbound timeline item's ingested media (stigmer/stigmer#367):
+ * images as a WhatsApp-style inline thumbnail (click opens the shared
+ * {@link AttachmentImageLightbox}), everything else as a document chip
+ * (filename + size, click opens the file in a new tab).
+ *
+ * This component calls `useStigmer()`, so it must only be MOUNTED when
+ * the timeline view holds a conversation address — that conditional
+ * mount is what keeps `ConversationTimelineView` renderable without a
+ * `StigmerProvider` (its presentational contract; see the view's
+ * `agentChannelId` prop).
+ *
+ * Deliberately a sibling of the execution thread's `MessageAttachments`,
+ * not a reuse of it: that row renders storage-key-addressed artifacts of
+ * an execution the viewer owns, while this one renders
+ * conversation-viewer-scoped media addressed by timeline position — the
+ * two read paths have different trust models (DD-001 D4) and different
+ * bubble treatments (chat thumbnail vs. attachment chip row).
+ */
+export function ConversationMediaAttachment({ media, address, className, }) {
+    const isImage = media.contentType.startsWith("image/");
+    return isImage ? (_jsx(MediaImageThumbnail, { media: media, address: address, className: className })) : (_jsx(MediaDocumentChip, { media: media, address: address, className: className }));
+}
+/**
+ * Display name for the media: the ingest-recorded filename (documents
+ * keep the provider's name; camera images get a platform-synthesized
+ * one, so this is never empty in practice), with a defensive fallback.
+ */
+function displayName(media) {
+    return media.filename || "attachment";
+}
+// ---------------------------------------------------------------------------
+// Image — WhatsApp-style inline thumbnail, click-to-open lightbox
+// ---------------------------------------------------------------------------
+/**
+ * A bounded preview frame in the bubble, minted from the item address at
+ * view time. The frame is fixed-size for BOTH the pulse placeholder and
+ * the loaded image, so the load causes no layout shift (the
+ * content-agnostic auto-scroll then needs no special case). If the URL
+ * can't be minted (revoked media, transient API failure, the server's
+ * uniform NOT_FOUND), the treatment degrades to the document chip —
+ * never a broken-image glyph (the `MessageAttachments` precedent).
+ */
+function MediaImageThumbnail({ media, address, className, }) {
+    const { url, error } = useConversationMediaUrl(address.agentChannelId, address.conversationKey, address.itemId);
+    const [previewOpen, setPreviewOpen] = useState(false);
+    const name = displayName(media);
+    if (error) {
+        return _jsx(MediaDocumentChip, { media: media, address: address, className: className });
+    }
+    return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: () => setPreviewOpen(true), "aria-label": `Preview ${name}`, className: cn(UNSTYLED_BUTTON, "block rounded-md focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", className), children: _jsx("span", { className: "relative block h-40 w-56 max-w-full overflow-hidden rounded-md", children: url ? (_jsx("img", { src: url, alt: "", "aria-hidden": "true", loading: "lazy", className: "h-full w-full object-cover" })) : (
+                    // Pulse placeholder while the presigned URL is minted; same
+                    // footprint as the image, so no layout shift.
+                    _jsx("span", { className: "block h-full w-full animate-pulse bg-muted", "aria-hidden": "true" })) }) }), previewOpen && (_jsx(AttachmentImageLightbox, { src: url, filename: name, open: true, onClose: () => setPreviewOpen(false) }))] }));
+}
+// ---------------------------------------------------------------------------
+// Document — compact chip, click-to-open in a new tab
+// ---------------------------------------------------------------------------
+/**
+ * The compact treatment for documents (and the degraded arm for images
+ * whose URL failed): file glyph, filename, size. A click mints a FRESH
+ * URL — presigned URLs expire, so the stable item address is the thing
+ * to hold, not a URL (the `useArtifactDownload` rationale) — and opens
+ * it in a new tab: the media contract presigns inline disposition only,
+ * so the browser previews what it can (PDFs) and downloads the rest.
+ * A failed mint reports below the chip in the surface's own error
+ * grammar (DD-006 — never a silent dead click).
+ */
+function MediaDocumentChip({ media, address, className, }) {
+    const { open, isOpening, error } = useOpenConversationMedia(address);
+    const name = displayName(media);
+    const size = media.sizeBytes > BigInt(0)
+        ? // WhatsApp caps media far below 2^53 bytes, so the narrowing is exact.
+            formatFileSize(Number(media.sizeBytes))
+        : null;
+    return (_jsxs("div", { className: className, children: [_jsx("span", { title: name, className: "inline-flex max-w-[240px] items-center rounded-md bg-muted-subtle px-2 py-1 text-xs text-foreground", children: _jsxs("button", { type: "button", onClick: () => void open(), disabled: isOpening, "aria-label": `Open ${name}`, className: cn(UNSTYLED_BUTTON, "flex min-w-0 items-center gap-1.5 rounded-sm text-inherit [font:inherit] hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isOpening && "opacity-70"), children: [_jsx(FileGlyph, {}), _jsx("span", { className: "min-w-0 truncate", children: name }), size !== null && (_jsx("span", { className: "shrink-0 text-muted-foreground", children: size }))] }) }), error !== null && (_jsx("p", { className: "mt-1 break-words text-xs text-destructive", children: getUserMessage(error) }))] }));
+}
+/**
+ * Click → mint fresh URL → open in a new tab. Kept local to this file:
+ * unlike {@link useConversationMediaUrl} (render data), an open is a
+ * user action — and it must complete within the browser's
+ * user-activation window, which the single fast unary mint does.
+ */
+function useOpenConversationMedia(address) {
+    const stigmer = useStigmer();
+    const [isOpening, setIsOpening] = useState(false);
+    const [error, setError] = useState(null);
+    const open = useCallback(async () => {
+        if (isOpening)
+            return;
+        setIsOpening(true);
+        setError(null);
+        try {
+            const result = await stigmer.agentChannel.getMediaDownloadUrl(create(GetConversationMediaDownloadUrlInputSchema, {
+                agentChannelId: address.agentChannelId,
+                conversationKey: address.conversationKey,
+                itemId: address.itemId,
+            }));
+            if (result.url) {
+                openInNewTab(result.url);
+            }
+        }
+        catch (err) {
+            setError(toError(err));
+        }
+        finally {
+            setIsOpening(false);
+        }
+    }, [stigmer, address.agentChannelId, address.conversationKey, address.itemId, isOpening]);
+    return useMemo(() => ({ open, isOpening, error }), [open, isOpening, error]);
+}
+/**
+ * Open a URL in a new tab via a transient anchor click (the
+ * `triggerBrowserDownload` shape, minus the `download` hint — the URL's
+ * disposition is inline and cross-origin anchors ignore the attribute
+ * anyway). Falls back to `window.open` in non-DOM environments.
+ */
+function openInNewTab(url) {
+    if (typeof document === "undefined") {
+        if (typeof window !== "undefined") {
+            window.open(url, "_blank", "noopener,noreferrer");
+        }
+        return;
+    }
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    anchor.rel = "noopener noreferrer";
+    anchor.target = "_blank";
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
+}
+/**
+ * Generic document glyph — the same geometry as the attachment chips'
+ * icon so the surfaces read as one family.
+ */
+function FileGlyph() {
+    return (_jsxs("svg", { width: "10", height: "10", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("path", { d: "M8 1H4C3.45 1 3 1.45 3 2V12C3 12.55 3.45 13 4 13H10C10.55 13 11 12.55 11 12V4L8 1Z" }), _jsx("path", { d: "M8 1V4H11" })] }));
+}
+//# sourceMappingURL=ConversationMediaAttachment.js.map