@schlessera/brain-ui-react 0.12.1 → 0.13.1

package/dist/components/images/zoomable-image.d.ts

@@ -0,0 +1,35 @@
+/**
+ * An image that opens into the full-screen zoom viewer when tapped — the same
+ * treatment a mermaid diagram gets, and for the same reason: the inline preview
+ * is only as wide as the viewport, which on a phone means a generated image is
+ * visible but not legible.
+ *
+ * Click-to-open rather than pinch-in-place: both the chat transcript and the
+ * file panel scroll, and a zoom surface embedded in a scroller has to steal the
+ * gestures that scrolling needs. Opening a dedicated stage keeps both intact.
+ *
+ * Sharing is deliberately NOT offered here. The hover affordance sits inside
+ * markdown prose and inside a file panel, both of which clip overflow, and a
+ * share menu that drops out of a clipping ancestor loses its lower entries. The
+ * viewer this opens carries the share menu, and the file viewer's own header
+ * has one too.
+ *
+ * The wrapper is a `span`, not a `div`: markdown puts images inside paragraphs,
+ * and a block element there is invalid nesting.
+ */
+export declare function ZoomableImage({ src, alt, className, mime, bytes, toolbar, imgProps, }: {
+    src: string;
+    alt?: string;
+    /** Classes for the inline `<img>` itself. */
+    className?: string;
+    mime?: string;
+    /** Byte size when known (the file viewer knows it; the chat does not). */
+    bytes?: number;
+    /**
+     * Hover expand button. Off for thumbnails, where a 28px button would cover
+     * the picture it is meant to act on — tapping the image still opens it.
+     */
+    toolbar?: boolean;
+    imgProps?: Omit<React.ComponentPropsWithoutRef<"img">, "src" | "alt" | "className">;
+}): import("react").JSX.Element;
+//# sourceMappingURL=zoomable-image.d.ts.map

package/dist/components/images/zoomable-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoomable-image.d.ts","sourceRoot":"","sources":["../../../src/components/images/zoomable-image.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,GAAG,EACH,SAAS,EACT,IAAI,EACJ,KAAK,EACL,OAAc,EACd,QAAQ,GACT,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC,CAAC;CACrF,+BA8CA"}

package/dist/components/images/zoomable-image.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Expand } from "lucide-react";
+import { imageFilenameFromSrc } from "../../lib/image-source.js";
+import { ImageViewer } from "./image-viewer.js";
+/**
+ * An image that opens into the full-screen zoom viewer when tapped — the same
+ * treatment a mermaid diagram gets, and for the same reason: the inline preview
+ * is only as wide as the viewport, which on a phone means a generated image is
+ * visible but not legible.
+ *
+ * Click-to-open rather than pinch-in-place: both the chat transcript and the
+ * file panel scroll, and a zoom surface embedded in a scroller has to steal the
+ * gestures that scrolling needs. Opening a dedicated stage keeps both intact.
+ *
+ * Sharing is deliberately NOT offered here. The hover affordance sits inside
+ * markdown prose and inside a file panel, both of which clip overflow, and a
+ * share menu that drops out of a clipping ancestor loses its lower entries. The
+ * viewer this opens carries the share menu, and the file viewer's own header
+ * has one too.
+ *
+ * The wrapper is a `span`, not a `div`: markdown puts images inside paragraphs,
+ * and a block element there is invalid nesting.
+ */
+export function ZoomableImage({ src, alt, className, mime, bytes, toolbar = true, imgProps, }) {
+    const [zoomed, setZoomed] = useState(false);
+    const filename = imageFilenameFromSrc(src, mime);
+    return (_jsxs("span", { className: "group relative inline-block max-w-full align-top", children: [_jsx("img", { ...imgProps, src: src, alt: alt ?? "", 
+                // The whole image is the affordance — the hover button is pointer-only,
+                // and this has to work on a touch screen. Focusable and Enter/Space
+                // activated because for a thumbnail (toolbar off) this is the ONLY way
+                // in, so it cannot be pointer-only either.
+                role: "button", tabIndex: 0, onClick: () => setZoomed(true), onKeyDown: (e) => {
+                    if (e.key !== "Enter" && e.key !== " ")
+                        return;
+                    e.preventDefault();
+                    setZoomed(true);
+                }, className: className }), toolbar && (_jsx("button", { type: "button", title: "Open image", onClick: () => setZoomed(true), className: "absolute right-2 top-2 flex h-7 w-7 items-center justify-center rounded-md bg-surface-raised/80 text-muted-foreground opacity-0 transition-all hover:bg-surface-overlay hover:text-foreground focus-visible:opacity-100 group-hover:opacity-100", children: _jsx(Expand, { className: "h-3.5 w-3.5" }) })), zoomed && (_jsx(ImageViewer, { src: src, alt: alt, filename: filename, mime: mime, bytes: bytes, onClose: () => setZoomed(false) }))] }));
+}
+//# sourceMappingURL=zoomable-image.js.map

package/dist/components/images/zoomable-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoomable-image.js","sourceRoot":"","sources":["../../../src/components/images/zoomable-image.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,GAAG,EACH,GAAG,EACH,SAAS,EACT,IAAI,EACJ,KAAK,EACL,OAAO,GAAG,IAAI,EACd,QAAQ,GAeT;IACC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEjD,OAAO,CACL,gBAAM,SAAS,EAAC,kDAAkD,aAChE,iBACM,QAAQ,EACZ,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,IAAI,EAAE;gBACd,wEAAwE;gBACxE,oEAAoE;gBACpE,uEAAuE;gBACvE,2CAA2C;gBAC3C,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAC9B,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;oBACf,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG;wBAAE,OAAO;oBAC/C,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,SAAS,CAAC,IAAI,CAAC,CAAC;gBAClB,CAAC,EACD,SAAS,EAAE,SAAS,GACpB,EACD,OAAO,IAAI,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAC,YAAY,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAC9B,SAAS,EAAC,iPAAiP,YAE3P,KAAC,MAAM,IAAC,SAAS,EAAC,aAAa,GAAG,GAC3B,CACV,EACA,MAAM,IAAI,CACT,KAAC,WAAW,IACV,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,GAC/B,CACH,IACI,CACR,CAAC;AACJ,CAAC"}

package/dist/components/viewer/zoom-viewer.d.ts

@@ -0,0 +1,26 @@
+export interface ZoomViewerProps {
+    children: React.ReactNode;
+    onClose: () => void;
+    /**
+     * Extra toolbar nodes, placed left of the close button — typically a share
+     * menu. Rendered inside the header, above the stage.
+     */
+    actions?: React.ReactNode;
+    /**
+     * Changes when the content's natural size may have changed (a streaming
+     * diagram growing, an image finishing its decode). Re-fits, but only while
+     * the user has not panned or zoomed — after that nothing moves behind them.
+     */
+    refitKey?: unknown;
+    /**
+     * Ceiling on the scale `fit()` may choose. Small diagrams may grow to fill
+     * the stage (blowing one up 8x reads as broken, hence a cap), but a raster
+     * image has real pixels: opening it above 100% only shows interpolation, so
+     * image callers pass 1.
+     */
+    maxFitScale?: number;
+    /** Aria label for the overlay. */
+    label?: string;
+}
+export declare function ZoomViewer({ children, onClose, actions, refitKey, maxFitScale, label, }: ZoomViewerProps): import("react").ReactPortal;
+//# sourceMappingURL=zoom-viewer.d.ts.map

package/dist/components/viewer/zoom-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom-viewer.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/zoom-viewer.tsx"],"names":[],"mappings":"AA6BA,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,EACR,WAAiB,EACjB,KAAqB,GACtB,EAAE,eAAe,+BAoSjB"}

package/dist/components/viewer/zoom-viewer.js

@@ -0,0 +1,254 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { Minus, Plus, Maximize2, X } from "lucide-react";
+/**
+ * Full-screen, pan-and-zoom view of one visual thing — a diagram, an image,
+ * anything with a natural pixel size. Callers supply the content and any extra
+ * toolbar actions; everything about the gesture surface lives here.
+ *
+ * Hand-rolled on pointer events rather than pulling a pan/zoom library: the
+ * whole surface is two transforms and the repo has no other dependency of that
+ * shape. Touch gestures work because the stage sets `touch-action: none` —
+ * the browser hands us every pointer instead of scrolling the page, which is
+ * also why no preventDefault is needed on the touch path. Wheel is the one
+ * exception: React's onWheel is passive, so it is bound manually.
+ */
+const MIN_SCALE = 0.15;
+const MAX_SCALE = 12;
+function clampScale(s) {
+    return Math.min(MAX_SCALE, Math.max(MIN_SCALE, s));
+}
+export function ZoomViewer({ children, onClose, actions, refitKey, maxFitScale = 2.5, label = "Zoomed view", }) {
+    const stageRef = useRef(null);
+    const contentRef = useRef(null);
+    const [scale, setScale] = useState(1);
+    const [offset, setOffset] = useState({ x: 0, y: 0 });
+    const [ready, setReady] = useState(false);
+    // Live gesture state lives in refs: pointer maths must not wait for a render.
+    const pointers = useRef(new Map());
+    const pinch = useRef(null);
+    const panFrom = useRef(null);
+    const view = useRef({ scale: 1, offset: { x: 0, y: 0 } });
+    /** The scale `fit()` last produced — the baseline double-click toggles against. */
+    const fitScale = useRef(1);
+    /** Set once the user pans/zooms; after that nothing may re-fit behind their back. */
+    const touched = useRef(false);
+    const apply = useCallback((next) => {
+        view.current = next;
+        setScale(next.scale);
+        setOffset(next.offset);
+    }, []);
+    /** Natural (untransformed) size of the content — offsetWidth ignores transforms. */
+    const natural = useCallback(() => {
+        const el = contentRef.current;
+        if (!el || !el.offsetWidth || !el.offsetHeight)
+            return null;
+        return { w: el.offsetWidth, h: el.offsetHeight };
+    }, []);
+    const fit = useCallback(() => {
+        const stage = stageRef.current;
+        const size = natural();
+        if (!stage || !size)
+            return;
+        const pad = 32;
+        const sx = (stage.clientWidth - pad * 2) / size.w;
+        const sy = (stage.clientHeight - pad * 2) / size.h;
+        const next = clampScale(Math.min(maxFitScale, Math.min(sx, sy)));
+        fitScale.current = next;
+        apply({
+            scale: next,
+            offset: {
+                x: (stage.clientWidth - size.w * next) / 2,
+                y: (stage.clientHeight - size.h * next) / 2,
+            },
+        });
+    }, [apply, natural, maxFitScale]);
+    useLayoutEffect(() => {
+        // Re-runs when the content itself changes, which happens while a message is
+        // still streaming — so a user who has already panned keeps their view.
+        if (!touched.current)
+            fit();
+        setReady(true);
+    }, [fit, refitKey]);
+    /** Zoom about a stage-local anchor, so the point under the cursor/fingers stays put. */
+    const zoomAt = useCallback((factor, anchor) => {
+        // Any deliberate zoom counts as touching the view — including the
+        // toolbar buttons and the wheel. Without this, content that is still
+        // streaming would re-fit itself out from under the reader's zoom.
+        touched.current = true;
+        const { scale: prev, offset: prevOffset } = view.current;
+        const next = clampScale(prev * factor);
+        if (next === prev)
+            return;
+        const ratio = next / prev;
+        apply({
+            scale: next,
+            offset: {
+                x: anchor.x - (anchor.x - prevOffset.x) * ratio,
+                y: anchor.y - (anchor.y - prevOffset.y) * ratio,
+            },
+        });
+    }, [apply]);
+    const zoomCenter = useCallback((factor) => {
+        const stage = stageRef.current;
+        if (!stage)
+            return;
+        zoomAt(factor, { x: stage.clientWidth / 2, y: stage.clientHeight / 2 });
+    }, [zoomAt]);
+    const stagePoint = (e) => {
+        const rect = stageRef.current?.getBoundingClientRect();
+        return { x: e.clientX - (rect?.left ?? 0), y: e.clientY - (rect?.top ?? 0) };
+    };
+    // Wheel must be bound manually: React's onWheel is passive, so it cannot
+    // preventDefault, and the page behind would scroll (or the browser would
+    // pinch-zoom the whole PWA on a ctrl+wheel trackpad gesture).
+    useEffect(() => {
+        const stage = stageRef.current;
+        if (!stage)
+            return;
+        const onWheel = (e) => {
+            e.preventDefault();
+            // A trackpad pinch arrives as ctrlKey+wheel with small deltas; a mouse
+            // wheel arrives as coarse notches. Both map to the same exponential.
+            const factor = Math.exp(-e.deltaY * (e.ctrlKey ? 0.01 : 0.0015));
+            zoomAt(factor, stagePoint(e));
+        };
+        stage.addEventListener("wheel", onWheel, { passive: false });
+        return () => stage.removeEventListener("wheel", onWheel);
+    }, [zoomAt]);
+    useEffect(() => {
+        const onKey = (e) => {
+            if (e.key === "Escape")
+                onClose();
+            else if (e.key === "+" || e.key === "=")
+                zoomCenter(1.25);
+            else if (e.key === "-" || e.key === "_")
+                zoomCenter(0.8);
+            else if (e.key === "0")
+                fit();
+        };
+        document.addEventListener("keydown", onKey);
+        return () => document.removeEventListener("keydown", onKey);
+    }, [onClose, zoomCenter, fit]);
+    // Lock body scroll while open.
+    useEffect(() => {
+        const prev = document.body.style.overflow;
+        document.body.style.overflow = "hidden";
+        return () => {
+            document.body.style.overflow = prev;
+        };
+    }, []);
+    // Re-fit on rotation / resize only while the view is untouched, so a resize
+    // never yanks content the user has deliberately panned into place.
+    useEffect(() => {
+        const onResize = () => {
+            if (!touched.current)
+                fit();
+        };
+        window.addEventListener("resize", onResize);
+        return () => window.removeEventListener("resize", onResize);
+    }, [fit]);
+    const onPointerDown = (e) => {
+        e.currentTarget.setPointerCapture(e.pointerId);
+        pointers.current.set(e.pointerId, stagePoint(e));
+        if (pointers.current.size === 2) {
+            const [a, b] = [...pointers.current.values()];
+            pinch.current = {
+                dist: Math.hypot(a.x - b.x, a.y - b.y),
+                center: { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 },
+            };
+            panFrom.current = null;
+        }
+        else if (pointers.current.size === 1) {
+            panFrom.current = { pointer: stagePoint(e), offset: view.current.offset };
+        }
+    };
+    const onPointerMove = (e) => {
+        if (!pointers.current.has(e.pointerId))
+            return;
+        const p = stagePoint(e);
+        pointers.current.set(e.pointerId, p);
+        if (pointers.current.size >= 2 && pinch.current) {
+            const [a, b] = [...pointers.current.values()];
+            const dist = Math.hypot(a.x - b.x, a.y - b.y);
+            const center = { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 };
+            if (pinch.current.dist > 0) {
+                touched.current = true;
+                // Pan and zoom in one step: the midpoint drift moves the content, the
+                // distance ratio scales it about that same midpoint.
+                const drift = {
+                    x: center.x - pinch.current.center.x,
+                    y: center.y - pinch.current.center.y,
+                };
+                // Committed through apply(), not written straight to the ref: two
+                // fingers moving in parallel (or a pinch already clamped at min/max)
+                // produce no scale change, and zoomAt() returns early — the drift
+                // would then be stranded in the ref and nothing would pan.
+                apply({
+                    scale: view.current.scale,
+                    offset: {
+                        x: view.current.offset.x + drift.x,
+                        y: view.current.offset.y + drift.y,
+                    },
+                });
+                zoomAt(dist / pinch.current.dist, center);
+            }
+            pinch.current = { dist, center };
+            return;
+        }
+        if (panFrom.current) {
+            touched.current = true;
+            apply({
+                scale: view.current.scale,
+                offset: {
+                    x: panFrom.current.offset.x + (p.x - panFrom.current.pointer.x),
+                    y: panFrom.current.offset.y + (p.y - panFrom.current.pointer.y),
+                },
+            });
+        }
+    };
+    const endPointer = (e) => {
+        pointers.current.delete(e.pointerId);
+        if (pointers.current.size >= 2) {
+            // Still pinching, but with a DIFFERENT pair (a stray third touch got
+            // lifted). Rebase the baseline, or the next move would compare the new
+            // pair's spread against the old pair's and jump.
+            const [a, b] = [...pointers.current.values()];
+            pinch.current = {
+                dist: Math.hypot(a.x - b.x, a.y - b.y),
+                center: { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 },
+            };
+            return;
+        }
+        pinch.current = null;
+        if (pointers.current.size === 1) {
+            // Lifting one finger of a pinch must not teleport the content: re-anchor
+            // the pan to whichever pointer is still down.
+            const [remaining] = [...pointers.current.values()];
+            panFrom.current = { pointer: remaining, offset: view.current.offset };
+        }
+        else if (pointers.current.size === 0) {
+            panFrom.current = null;
+        }
+    };
+    const onDoubleClick = (e) => {
+        touched.current = true;
+        // Compared against the FIT scale, not against 1: content that fits at 125%
+        // would otherwise read as "already zoomed" and double-click would re-fit it
+        // to exactly where it already was.
+        if (view.current.scale > fitScale.current * 1.05)
+            fit();
+        else
+            zoomAt(2, stagePoint(e));
+    };
+    const btn = "flex h-9 w-9 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-surface-raised hover:text-foreground";
+    // Portalled to <body>: message bubbles animate through framer-motion, and a
+    // transformed ancestor becomes the containing block for `fixed`, which would
+    // pin this overlay to the bubble instead of the viewport.
+    return createPortal(_jsxs("div", { role: "dialog", "aria-modal": "true", "aria-label": label, className: "fixed inset-0 z-50 flex flex-col bg-background/95 backdrop-blur-sm", children: [_jsxs("div", { className: "flex items-center justify-between gap-2 border-b border-border/60 px-3 py-2", style: { paddingTop: "calc(0.5rem + env(safe-area-inset-top))" }, children: [_jsxs("span", { className: "px-1 font-[family-name:var(--font-mono)] text-xs tabular-nums text-muted-foreground", children: [Math.round(scale * 100), "%"] }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx("button", { type: "button", title: "Zoom out", onClick: () => zoomCenter(0.8), className: btn, children: _jsx(Minus, { className: "h-4 w-4" }) }), _jsx("button", { type: "button", title: "Zoom in", onClick: () => zoomCenter(1.25), className: btn, children: _jsx(Plus, { className: "h-4 w-4" }) }), _jsx("button", { type: "button", title: "Fit to screen", onClick: fit, className: btn, children: _jsx(Maximize2, { className: "h-4 w-4" }) }), actions, _jsx("button", { type: "button", title: "Close", onClick: onClose, className: btn, children: _jsx(X, { className: "h-4 w-4" }) })] })] }), _jsx("div", { ref: stageRef, className: "relative flex-1 cursor-grab touch-none overflow-hidden active:cursor-grabbing [&_img]:max-w-none [&_svg]:max-w-none", onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: endPointer, onPointerCancel: endPointer, onDoubleClick: onDoubleClick, children: _jsx("div", { ref: contentRef, className: "absolute left-0 top-0 origin-top-left", style: {
+                        transform: `translate(${offset.x}px, ${offset.y}px) scale(${scale})`,
+                        visibility: ready ? "visible" : "hidden",
+                    }, children: children }) })] }), document.body);
+}
+//# sourceMappingURL=zoom-viewer.js.map

package/dist/components/viewer/zoom-viewer.js.map

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

package/dist/hooks/use-share-intake.d.ts

@@ -0,0 +1,6 @@
+import { type StoredShare } from "@schlessera/brain-ui-sdk/share-target";
+export declare function useShareIntake(): {
+    confirm: (record: StoredShare) => Promise<void>;
+    dismiss: (record: StoredShare) => void;
+};
+//# sourceMappingURL=use-share-intake.d.ts.map

package/dist/hooks/use-share-intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-share-intake.d.ts","sourceRoot":"","sources":["../../src/hooks/use-share-intake.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,uCAAuC,CAAC;AAsD/C,wBAAgB,cAAc,IAAI;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC,CA0HA"}

package/dist/hooks/use-share-intake.js

@@ -0,0 +1,153 @@
+import { useCallback, useEffect } from "react";
+import { SHARE_STASH_TTL_MS, } from "@schlessera/brain-ui-sdk/protocol";
+import { getShareStore, pruneStoredShares, readShareLaunchParams, } from "@schlessera/brain-ui-sdk/share-target";
+import { useChatStore } from "../stores/chat-store.js";
+import { useConnectionStore } from "../stores/connection-store.js";
+import { useShareStore } from "../stores/share-store.js";
+import { detectClientEnvironment } from "../lib/client-environment.js";
+import { buildSharePrompt, describeShareError, describeUploadError, dropShareClaim, persistShareClaim, readShareClaims, shareImagesToAttachments, uploadShare, } from "../lib/share-intake.js";
+import { sendClientMessage } from "./use-websocket.js";
+/**
+ * Pick up shares the service worker stashed, and file them once confirmed.
+ *
+ * Deliberately thin: every decision lives in `lib/share-intake.ts`, which is
+ * testable without a DOM. What is left here is the browser-only part — reading
+ * the launch URL, rewriting it, and driving the stores.
+ */
+/**
+ * Move `?share=<id>` out of the URL and into a durable claim.
+ *
+ * The parameter cannot stay: the shell reloads the page when a new service
+ * worker takes over, a reload preserves the query string, and a second pass
+ * over the same id while the first upload is in flight would file the share
+ * twice. (The claim is belt; `store.take()` is braces — it hands the record to
+ * exactly one caller.)
+ */
+function claimFromLocation() {
+    if (typeof window === "undefined")
+        return { claimed: [] };
+    const { shareId, error } = readShareLaunchParams(window.location.href);
+    if (shareId) {
+        persistShareClaim(shareId);
+        const url = new URL(window.location.href);
+        url.searchParams.delete("share");
+        url.searchParams.delete("share_error");
+        history.replaceState(null, "", url.toString());
+    }
+    else if (error) {
+        const url = new URL(window.location.href);
+        url.searchParams.delete("share_error");
+        history.replaceState(null, "", url.toString());
+    }
+    return {
+        claimed: readShareClaims(),
+        ...(error ? { error: describeShareError(error) } : {}),
+    };
+}
+export function useShareIntake() {
+    const enqueue = useShareStore((s) => s.enqueue);
+    const remove = useShareStore((s) => s.remove);
+    const setBusy = useShareStore((s) => s.setBusy);
+    const setError = useShareStore((s) => s.setError);
+    const setNotes = useShareStore((s) => s.setNotes);
+    useEffect(() => {
+        let disposed = false;
+        const { claimed, error } = claimFromLocation();
+        if (error)
+            setError(error);
+        void (async () => {
+            const store = getShareStore();
+            try {
+                for (const id of claimed) {
+                    const record = await store.take(id);
+                    dropShareClaim(id);
+                    if (record && !disposed)
+                        enqueue(record);
+                }
+                // Orphans: a share whose landing page never ran (the app opened
+                // offline on the fallback page, or the tab was closed before the
+                // parameter was read) leaves a record nobody holds the id for. The
+                // stash is the only place it still exists.
+                for (const record of await store.list()) {
+                    const taken = await store.take(record.id);
+                    if (taken && !disposed)
+                        enqueue(taken);
+                }
+                // The service worker's own prune runs after a stash, so it can never
+                // reach the newest record. This pass can.
+                await pruneStoredShares(store, SHARE_STASH_TTL_MS);
+            }
+            catch (err) {
+                if (!disposed) {
+                    setError(err instanceof Error ? err.message : "Could not read stashed shares");
+                }
+            }
+        })();
+        return () => {
+            disposed = true;
+        };
+    }, [enqueue, setError]);
+    const confirm = useCallback(async (record) => {
+        const share = useShareStore.getState();
+        if (share.busy)
+            return;
+        if (useConnectionStore.getState().wsStatus !== "connected") {
+            setError("Not connected yet — this will work as soon as the app reconnects.");
+            return;
+        }
+        setBusy(true);
+        setError(null);
+        setNotes([]);
+        try {
+            const outcome = await uploadShare(record);
+            if (!outcome.ok) {
+                setError(describeUploadError(outcome));
+                return;
+            }
+            const { attachments, errors } = await shareImagesToAttachments(record.files);
+            if (errors.length)
+                setNotes(errors);
+            const prompt = buildSharePrompt(outcome.result);
+            const chat = useChatStore.getState();
+            // Always start from a fresh draft: `activeSessionId` is restored from
+            // localStorage at store creation, so on a cold boot it already points
+            // at whatever session was last open.
+            chat.clearMessages();
+            // Ownership of the preview URLs transfers to the message here — the
+            // chat store revokes them. Nothing below may revoke them again.
+            chat.addUserMessage(null, prompt, "typed", attachments.length
+                ? attachments.map((a) => ({
+                    previewUrl: a.previewUrl,
+                    mediaType: a.attachment.mediaType,
+                }))
+                : undefined);
+            chat.startAssistantMessage(null);
+            const sent = sendClientMessage({
+                type: "chat_message",
+                text: prompt,
+                ...(attachments.length
+                    ? { attachments: attachments.map((a) => a.attachment) }
+                    : {}),
+                ...(detectClientEnvironment() ? { client: detectClientEnvironment() } : {}),
+            });
+            if (!sent) {
+                setError("The connection dropped before that could be sent.");
+                return;
+            }
+            remove(record.id);
+            dropShareClaim(record.id);
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [remove, setBusy, setError, setNotes]);
+    const dismiss = useCallback((record) => {
+        remove(record.id);
+        dropShareClaim(record.id);
+        setError(null);
+        // Already taken out of the stash when it was claimed; dropping the queue
+        // entry is what discards it.
+    }, [remove, setError]);
+    return { confirm, dismiss };
+}
+//# sourceMappingURL=use-share-intake.js.map

package/dist/hooks/use-share-intake.js.map

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

package/dist/hooks/use-websocket.d.ts

@@ -2,6 +2,19 @@ import type { ServerMessage, ClientMessage } from "@schlessera/brain-ui-sdk/prot
 /** Map a frame to the run-state its session should show in the session list. */
 export declare function runStateForFrame(msg: ServerMessage): "streaming" | "queued" | "idle";
 export declare function handleServerMessage(msg: ServerMessage): void;
+/**
+ * Send on the live socket from outside a component.
+ *
+ * `useWebSocket()` OWNS the socket — its construction guard is a per-instance
+ * ref, so a second caller would build a second client, overwrite this
+ * singleton, and orphan the first; unmounting either one would then close the
+ * socket for both. Anything that needs to send but not to own (the share
+ * intake) goes through here instead of calling the hook again.
+ *
+ * Returns false when there is no open socket, since `WSClient.send` drops
+ * silently in that case and a caller that just staged an upload needs to know.
+ */
+export declare function sendClientMessage(msg: ClientMessage): boolean;
 export declare function useWebSocket(): {
     send: (msg: ClientMessage) => void;
 };

package/dist/hooks/use-websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-websocket.d.ts","sourceRoot":"","sources":["../../src/hooks/use-websocket.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAId,MAAM,mCAAmC,CAAC;AA2E3C,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAOpF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,QA8KrD;AA8GD,wBAAgB,YAAY;gBA2BK,aAAa;EAK7C"}
+{"version":3,"file":"use-websocket.d.ts","sourceRoot":"","sources":["../../src/hooks/use-websocket.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAId,MAAM,mCAAmC,CAAC;AA2E3C,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAOpF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,QAkLrD;AA8GD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAK7D;AAED,wBAAgB,YAAY;gBA2BK,aAAa;EAK7C"}

package/dist/hooks/use-websocket.js

@@ -92,7 +92,10 @@ export function handleServerMessage(msg) {
     // session's pre-binding frames) apply to the buffer in view.
     const frameSessionId = msg.sessionId;
     if (frameSessionId) {
-        state.setRunState(frameSessionId, runStateForFrame(msg));
+        // `detail` on a queued status is the host's queue-pressure note; it rides
+        // along so the session's badge can show WHY it is queued deep.
+        const queueNote = msg.type === "status" && msg.status === "queued" ? msg.detail : undefined;
+        state.setRunState(frameSessionId, runStateForFrame(msg), queueNote);
     }
     // Resolve the target buffer key for this frame.
     let key;
@@ -345,6 +348,26 @@ function handleStatusChange(status) {
 }
 // Singleton client - survives React re-renders
 let wsClient = null;
+/**
+ * Send on the live socket from outside a component.
+ *
+ * `useWebSocket()` OWNS the socket — its construction guard is a per-instance
+ * ref, so a second caller would build a second client, overwrite this
+ * singleton, and orphan the first; unmounting either one would then close the
+ * socket for both. Anything that needs to send but not to own (the share
+ * intake) goes through here instead of calling the hook again.
+ *
+ * Returns false when there is no open socket, since `WSClient.send` drops
+ * silently in that case and a caller that just staged an upload needs to know.
+ */
+export function sendClientMessage(msg) {
+    if (!wsClient)
+        return false;
+    if (useConnectionStore.getState().wsStatus !== "connected")
+        return false;
+    wsClient.send(msg);
+    return true;
+}
 export function useWebSocket() {
     const initialized = useRef(false);
     useEffect(() => {