@stigmer/react 3.8.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":"AAGA,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,10 +1,19 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+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
@@ -27,26 +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, }) {
+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";
+    const isError = entry.phase === "error";
+    return `${entry.file.name}, ${formatFileSize(entry.file.size)}${isUploading ? ", uploading" : ""}${isError ? ", upload failed" : ""}`;
+}
+// ---------------------------------------------------------------------------
+// Image chip — a preview-only thumbnail tile (#371, #372)
+// ---------------------------------------------------------------------------
+/**
+ * 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.
+ *
+ * On upload error the tile stays loud: destructive ring, dimmed image,
+ * and a centered Retry pill — failure never hides behind hover.
+ *
+ * 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 (_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
+    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("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, {}) })] }));
+            : "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 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/attachment-utils.d.ts

@@ -29,4 +29,15 @@ export declare function formatFileSize(bytes: number): string;
  * file exceeds {@link MAX_ATTACHMENT_BYTES}.
  */
 export declare function validateAttachmentSize(file: File): string | null;
+/**
+ * Returns `name` unchanged when it is not in `taken`, otherwise the first
+ * free `stem-2.ext`, `stem-3.ext`, … variant.
+ *
+ * Duplicate filenames within one turn are not a cosmetic problem:
+ * attachments materialize at `.stigmer/inputs/{filename}`, where the
+ * deep-agent harness fails the whole execution on a mount-path collision
+ * and the Cursor harness silently overwrites the earlier file. A visible
+ * rename on the attachment chip is strictly better than either outcome.
+ */
+export declare function uniquifyFilename(name: string, taken: ReadonlySet<string>): string;
 //# sourceMappingURL=attachment-utils.d.ts.map

package/attachment/attachment-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-utils.d.ts","sourceRoot":"","sources":["../../src/attachment/attachment-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAiDrD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAapD;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAKhE"}
+{"version":3,"file":"attachment-utils.d.ts","sourceRoot":"","sources":["../../src/attachment/attachment-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAiDrD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAapD;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GACzB,MAAM,CAYR"}

package/attachment/attachment-utils.js

@@ -101,4 +101,27 @@ export function validateAttachmentSize(file) {
     }
     return null;
 }
+/**
+ * Returns `name` unchanged when it is not in `taken`, otherwise the first
+ * free `stem-2.ext`, `stem-3.ext`, … variant.
+ *
+ * Duplicate filenames within one turn are not a cosmetic problem:
+ * attachments materialize at `.stigmer/inputs/{filename}`, where the
+ * deep-agent harness fails the whole execution on a mount-path collision
+ * and the Cursor harness silently overwrites the earlier file. A visible
+ * rename on the attachment chip is strictly better than either outcome.
+ */
+export function uniquifyFilename(name, taken) {
+    if (!taken.has(name))
+        return name;
+    const dotIndex = name.lastIndexOf(".");
+    // A leading dot (".env") is a hidden-file prefix, not an extension.
+    const stem = dotIndex > 0 ? name.slice(0, dotIndex) : name;
+    const ext = dotIndex > 0 ? name.slice(dotIndex) : "";
+    for (let n = 2;; n++) {
+        const candidate = `${stem}-${n}${ext}`;
+        if (!taken.has(candidate))
+            return candidate;
+    }
+}
 //# sourceMappingURL=attachment-utils.js.map

package/attachment/attachment-utils.js.map

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

package/attachment/clipboard.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Clipboard file extraction for composer surfaces — the paste half of
+ * "paste a screenshot and the agent sees it" (stigmer/stigmer#284).
+ *
+ * Extraction is deliberately SYNCHRONOUS. Clipboard file handles are only
+ * reliable while the paste event is being dispatched, and the caller must
+ * decide `preventDefault()` in the same tick (a copied image usually carries
+ * an HTML/text flavor that would otherwise paste as junk markup). An async
+ * "one call" API here would pass in tests and lose pastes in real browsers.
+ * Async work on the extracted files (e.g. {@link prepareImageForVision})
+ * happens after extraction, on plain `File` objects that stay valid.
+ */
+/**
+ * Structural source for {@link extractClipboardFiles}: both the native
+ * `ClipboardEvent` and React's synthetic clipboard event satisfy it.
+ */
+export interface ClipboardFilesSource {
+    readonly clipboardData: {
+        readonly files: FileList;
+    } | null;
+}
+/**
+ * Extracts files from a paste event, giving clipboard images that carry the
+ * browser's generic `image.png` name a unique, human-readable one
+ * (`pasted-image-<HHMMSS>-<n>.<ext>`).
+ *
+ * Unique names are load-bearing, not cosmetic: attachments mount at
+ * `.stigmer/inputs/{filename}`, and two same-named attachments either fail
+ * the execution (deep-agent harness) or silently overwrite each other
+ * (Cursor harness). Files with real names (pasted from a file manager) are
+ * returned unchanged.
+ *
+ * Returns an empty array for a text-only paste — callers use that to let
+ * the default text insertion proceed untouched.
+ *
+ * Must be called synchronously from the paste event handler. Call
+ * `event.preventDefault()` in the same tick when the result is non-empty;
+ * the returned `File` objects remain valid afterwards.
+ *
+ * @example
+ * ```tsx
+ * function handlePaste(e: React.ClipboardEvent<HTMLTextAreaElement>) {
+ *   const files = extractClipboardFiles(e);
+ *   if (files.length === 0) return; // plain text paste — leave it alone
+ *   e.preventDefault();
+ *   attachments.addFiles(files);
+ * }
+ * ```
+ */
+export declare function extractClipboardFiles(event: ClipboardFilesSource): File[];
+//# sourceMappingURL=clipboard.d.ts.map

package/attachment/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/attachment/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7D;AAuCD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAAE,CAezE"}

package/attachment/clipboard.js

@@ -0,0 +1,89 @@
+/**
+ * Clipboard file extraction for composer surfaces — the paste half of
+ * "paste a screenshot and the agent sees it" (stigmer/stigmer#284).
+ *
+ * Extraction is deliberately SYNCHRONOUS. Clipboard file handles are only
+ * reliable while the paste event is being dispatched, and the caller must
+ * decide `preventDefault()` in the same tick (a copied image usually carries
+ * an HTML/text flavor that would otherwise paste as junk markup). An async
+ * "one call" API here would pass in tests and lose pastes in real browsers.
+ * Async work on the extracted files (e.g. {@link prepareImageForVision})
+ * happens after extraction, on plain `File` objects that stay valid.
+ */
+/**
+ * Names browsers assign to clipboard images that never had a real filename
+ * (a screenshot, an image copied off a web page). Chrome, Firefox, and
+ * Safari all use `image.<ext>`. A file pasted from the OS file manager
+ * keeps its real name and never matches.
+ */
+const GENERIC_CLIPBOARD_IMAGE_NAME = /^image\.(png|jpe?g|gif|webp|tiff?|bmp|avif)$/i;
+/** Extension for a synthesized name, keyed by the clipboard MIME type. */
+const IMAGE_MIME_EXTENSIONS = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/gif": "gif",
+    "image/webp": "webp",
+    "image/tiff": "tiff",
+    "image/bmp": "bmp",
+    "image/avif": "avif",
+    "image/svg+xml": "svg",
+};
+/**
+ * Monotonic per-page-session counter. Combined with the time component this
+ * keeps synthesized names unique even across page reloads within one agent
+ * session — required because attachments materialize at
+ * `.stigmer/inputs/{filename}` in a session-scoped directory, where a
+ * repeated name from a later turn silently replaces the earlier turn's file.
+ */
+let pasteSequence = 0;
+function synthesizePastedImageName(mimeType, now) {
+    const pad = (n) => String(n).padStart(2, "0");
+    const time = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    const ext = IMAGE_MIME_EXTENSIONS[mimeType.toLowerCase()] ?? "png";
+    pasteSequence += 1;
+    return `pasted-image-${time}-${pasteSequence}.${ext}`;
+}
+/**
+ * Extracts files from a paste event, giving clipboard images that carry the
+ * browser's generic `image.png` name a unique, human-readable one
+ * (`pasted-image-<HHMMSS>-<n>.<ext>`).
+ *
+ * Unique names are load-bearing, not cosmetic: attachments mount at
+ * `.stigmer/inputs/{filename}`, and two same-named attachments either fail
+ * the execution (deep-agent harness) or silently overwrite each other
+ * (Cursor harness). Files with real names (pasted from a file manager) are
+ * returned unchanged.
+ *
+ * Returns an empty array for a text-only paste — callers use that to let
+ * the default text insertion proceed untouched.
+ *
+ * Must be called synchronously from the paste event handler. Call
+ * `event.preventDefault()` in the same tick when the result is non-empty;
+ * the returned `File` objects remain valid afterwards.
+ *
+ * @example
+ * ```tsx
+ * function handlePaste(e: React.ClipboardEvent<HTMLTextAreaElement>) {
+ *   const files = extractClipboardFiles(e);
+ *   if (files.length === 0) return; // plain text paste — leave it alone
+ *   e.preventDefault();
+ *   attachments.addFiles(files);
+ * }
+ * ```
+ */
+export function extractClipboardFiles(event) {
+    const fileList = event.clipboardData?.files;
+    if (!fileList || fileList.length === 0)
+        return [];
+    return Array.from(fileList).map((file) => {
+        const isGenericImage = file.type.toLowerCase().startsWith("image/") &&
+            (file.name === "" || GENERIC_CLIPBOARD_IMAGE_NAME.test(file.name));
+        if (!isGenericImage)
+            return file;
+        return new File([file], synthesizePastedImageName(file.type, new Date()), {
+            type: file.type,
+            lastModified: file.lastModified,
+        });
+    });
+}
+//# sourceMappingURL=clipboard.js.map

package/attachment/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/attachment/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH;;;;;GAKG;AACH,MAAM,4BAA4B,GAAG,+CAA+C,CAAC;AAErF,0EAA0E;AAC1E,MAAM,qBAAqB,GAA2B;IACpD,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB,SAAS,yBAAyB,CAAC,QAAgB,EAAE,GAAS;IAC5D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IACtF,MAAM,GAAG,GAAG,qBAAqB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC;IACnE,aAAa,IAAI,CAAC,CAAC;IACnB,OAAO,gBAAgB,IAAI,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC;IAC5C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,cAAc,GAClB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC5C,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QAEjC,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,yBAAyB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE;YACxE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/attachment/index.d.ts

@@ -2,5 +2,10 @@ export { useAttachments } from "./useAttachments.js";
 export type { AttachmentPhase, AttachmentEntry, UseAttachmentsOptions, UseAttachmentsReturn, } from "./useAttachments.js";
 export { AttachmentChipList } from "./AttachmentChipList.js";
 export type { AttachmentChipListProps } from "./AttachmentChipList.js";
-export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment-utils.js";
+export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, uniquifyFilename, validateAttachmentSize, } from "./attachment-utils.js";
+export { extractClipboardFiles } from "./clipboard.js";
+export type { ClipboardFilesSource } from "./clipboard.js";
+export { prepareImageForVision } from "./prepare-image.js";
+export { MAX_VISION_LONG_EDGE_PX, MAX_VISION_PIXELS, exceedsVisionResolution, fitToVisionResolution, } from "./vision-fit.js";
+export type { VisionFitSize } from "./vision-fit.js";
 //# sourceMappingURL=index.d.ts.map

package/attachment/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/attachment/index.js

@@ -1,4 +1,7 @@
 export { useAttachments } from "./useAttachments.js";
 export { AttachmentChipList } from "./AttachmentChipList.js";
-export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment-utils.js";
+export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, uniquifyFilename, validateAttachmentSize, } from "./attachment-utils.js";
+export { extractClipboardFiles } from "./clipboard.js";
+export { prepareImageForVision } from "./prepare-image.js";
+export { MAX_VISION_LONG_EDGE_PX, MAX_VISION_PIXELS, exceedsVisionResolution, fitToVisionResolution, } from "./vision-fit.js";
 //# sourceMappingURL=index.js.map

package/attachment/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}