dsh-image-gen 0.10.2 → 0.11.0

package/lib/types/client/gif-i18n.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Copy for the GIF player and the card's saved-file opener, kept apart from
+ * the plugin dictionary so this UI ships as its own files.
+ */
+export declare const GIF_TEXT: {
+    readonly zh: {
+        readonly gifBadge: "GIF 动图";
+        readonly openInSidebar: "在右侧栏打开";
+        readonly notSavedVersion: "这个版本没有保存到工作区";
+        readonly gifControls: "GIF 播放控制";
+        readonly gifPlay: "播放 GIF";
+        readonly gifPause: "暂停 GIF";
+        readonly gifPlayTitle: "播放 GIF（空格）";
+        readonly gifPauseTitle: "暂停 GIF（空格）";
+        readonly gifFrames: "GIF 帧";
+        readonly gifFrameOf: "第 {current} 帧，共 {total} 帧";
+        readonly gifStripHint: "悬停预览，点击停在这一帧，← → 逐帧";
+        readonly gifStripHintGallery: "悬停预览，点击停在这一帧；焦点在这里时 ← → 逐帧，其它时候 ← → 翻页";
+        readonly gifSpeed: "播放速度";
+        readonly gifSpeedHint: "拖动调整播放速度（0.2×–2×），双击恢复 1×";
+        readonly gifFaster: "更快";
+        readonly gifSlower: "更慢";
+        readonly gifDownloadMenu: "下载";
+        readonly gifDownload: "下载 GIF";
+        readonly gifDownloadSpeed: "下载 GIF（{speed}×）";
+        readonly gifDownloadHintOriginal: "原速动图";
+        readonly gifDownloadHintSpeed: "按当前播放速度";
+        readonly gifDownloadOriginal: "下载原速 GIF";
+        readonly gifDownloadOriginalHint: "不改变帧时长";
+        readonly gifDownloadFrame: "下载当前帧（PNG）";
+        readonly gifDownloadFrameHint: "第 {frame} 帧，静态图";
+        readonly gifCopyFrame: "复制当前帧（静态图）";
+        readonly gifCopyFirstFrame: "复制首帧（静态图）";
+        readonly gifCopiedFrame: "已复制第 {current}/{total} 帧（静态图）；要动图请下载或拖出";
+        readonly gifCopiedFirstFrame: "已复制首帧（静态图）；要动图请下载或拖出";
+        readonly gifCopyFailed: "复制失败";
+        readonly gifClose: "关闭（Esc）";
+        readonly gifControlsUnavailable: "此环境不支持逐帧控制，动图仍可下载";
+        readonly gifEdit: "编辑";
+        readonly gifEditChipTitle: "逐帧写修改意见，让 AI 重新画这个动图";
+        readonly gifEditToggle: "编辑帧";
+        readonly gifEditEnterTitle: "暂停在当前帧，点画面写修改意见";
+        readonly gifEditExitTitle: "退出编辑";
+        readonly gifEditTooManyFrames: "超过 16 帧的动图暂不支持按帧修改";
+        readonly gifEditDecodeFailed: "无法解码动图，暂不能按帧修改";
+        readonly gifEditDecoding: "正在解码动图帧…";
+        readonly gifEditNotLoaded: "动图帧尚未加载，暂不能按帧修改";
+        readonly gifEditHint: "在画面上点一下写评论；评论只显示在它所在的那一帧，可以换帧继续加，最后一次发送。";
+        readonly gifEditSheetHint: "所有帧平铺成一张网格图，点任意一格放评论，就是给那一帧写修改意见。";
+        readonly gifEditLayerLabel: "在第 {frame} 帧上放评论";
+        readonly gifEditView: "显示方式";
+        readonly gifGifView: "动图";
+        readonly gifSheetView: "全部帧";
+        readonly gifFrameComments: "第 {current} 帧 · 共 {count} 条评论";
+        readonly gifSheetComments: "共 {total} 帧 · {count} 条评论";
+        readonly gifCommentPlaceholder: "添加评论…";
+        readonly gifCommentNew: "在第 {frame} 帧添加评论";
+        readonly gifCommentPublish: "发表评论";
+        readonly gifCommentPublishTitle: "发表（Enter）";
+        readonly gifCommentEdit: "编辑评论 {index}";
+        readonly gifCommentView: "查看评论";
+        readonly gifCommentSheetTitle: "第 {frame} 帧：{text}";
+        readonly gifCommentLabel: "评论 {index}（第 {frame} 帧）";
+        readonly gifCommentSave: "保存";
+        readonly gifCommentDelete: "删除评论";
+        readonly gifCommentsClear: "清空";
+        readonly gifCommentsClearConfirm: "确定清空全部 {count} 条评论吗？";
+        readonly gifEditCancel: "取消";
+        readonly gifSend: "发送 ({count})";
+        readonly gifSending: "发送中…";
+        readonly gifEditDone: "已按评论重绘";
+        readonly gifEditSaveFailed: "已按评论重绘，但保存到图库失败，请重试";
+        readonly gifEditFailed: "按帧修改失败";
+        readonly gifEditFailedNotice: "按帧修改失败：{reason}";
+        readonly gifEditFailedHint: "通常是该渠道的图生图接口不接受这次请求（如不支持 images/edits 或 GIF 输出）；可改为描述后重新生成。";
+        readonly gifEditStill: "渠道返回的是静态图，动画未保留；评论仍留在上一版本。";
+        readonly gifEditFallbackRegenerate: "改为描述后重新生成（不保留原动画）";
+        readonly gifEditFallbackHint: "评论已改写成文字要求附在提示词后。这会整段重新生成，不保留原动画；可继续修改后确认。";
+        readonly gifSheetTooLarge: "动图太大，无法生成参考拼图";
+    };
+    readonly en: {
+        readonly gifBadge: "Animated GIF";
+        readonly openInSidebar: "Open in the sidebar";
+        readonly notSavedVersion: "This version was not saved to the workspace";
+        readonly gifControls: "GIF playback controls";
+        readonly gifPlay: "Play GIF";
+        readonly gifPause: "Pause GIF";
+        readonly gifPlayTitle: "Play GIF (Space)";
+        readonly gifPauseTitle: "Pause GIF (Space)";
+        readonly gifFrames: "GIF frames";
+        readonly gifFrameOf: "Frame {current} of {total}";
+        readonly gifStripHint: "Hover to preview, click to stop on this frame, ← → to step";
+        readonly gifStripHintGallery: "Hover to preview, click to stop on this frame; ← → step frames while this has focus and turn pages otherwise";
+        readonly gifSpeed: "Playback speed";
+        readonly gifSpeedHint: "Drag to change the playback speed (0.2×–2×); double-click for 1×";
+        readonly gifFaster: "Faster";
+        readonly gifSlower: "Slower";
+        readonly gifDownloadMenu: "Download";
+        readonly gifDownload: "Download GIF";
+        readonly gifDownloadSpeed: "Download GIF ({speed}×)";
+        readonly gifDownloadHintOriginal: "Animation at its own speed";
+        readonly gifDownloadHintSpeed: "At the current playback speed";
+        readonly gifDownloadOriginal: "Download original-speed GIF";
+        readonly gifDownloadOriginalHint: "Frame timing unchanged";
+        readonly gifDownloadFrame: "Download frame (PNG)";
+        readonly gifDownloadFrameHint: "Frame {frame}, still image";
+        readonly gifCopyFrame: "Copy frame (still)";
+        readonly gifCopyFirstFrame: "Copy first frame (still)";
+        readonly gifCopiedFrame: "Frame {current} of {total} copied as a still; download or drag out for the GIF";
+        readonly gifCopiedFirstFrame: "First frame copied as a still; download or drag out for the GIF";
+        readonly gifCopyFailed: "Copy failed";
+        readonly gifClose: "Close (Esc)";
+        readonly gifControlsUnavailable: "Frame-by-frame controls are not available here; the GIF can still be downloaded";
+        readonly gifEdit: "Edit";
+        readonly gifEditChipTitle: "Leave notes on frames and have the AI redraw this animation";
+        readonly gifEditToggle: "Edit frames";
+        readonly gifEditEnterTitle: "Pause on this frame and click the picture to leave notes";
+        readonly gifEditExitTitle: "Leave editing";
+        readonly gifEditTooManyFrames: "Animations with more than 16 frames cannot be edited by frame yet";
+        readonly gifEditDecodeFailed: "The animation could not be decoded, so it cannot be edited by frame";
+        readonly gifEditDecoding: "Decoding the animation frames…";
+        readonly gifEditNotLoaded: "The animation frames are not loaded yet, so it cannot be edited by frame";
+        readonly gifEditHint: "Click the picture to leave a note. A note shows only on its own frame; switch frames to add more, then send them all at once.";
+        readonly gifEditSheetHint: "Every frame laid out in one grid: click a cell to leave a note on that frame.";
+        readonly gifEditLayerLabel: "Place a note on frame {frame}";
+        readonly gifEditView: "View";
+        readonly gifGifView: "GIF";
+        readonly gifSheetView: "All frames";
+        readonly gifFrameComments: "Frame {current} · {count} notes";
+        readonly gifSheetComments: "{total} frames · {count} notes";
+        readonly gifCommentPlaceholder: "Add a note…";
+        readonly gifCommentNew: "New note on frame {frame}";
+        readonly gifCommentPublish: "Post note";
+        readonly gifCommentPublishTitle: "Post (Enter)";
+        readonly gifCommentEdit: "Edit note {index}";
+        readonly gifCommentView: "View note";
+        readonly gifCommentSheetTitle: "Frame {frame}: {text}";
+        readonly gifCommentLabel: "Note {index} (frame {frame})";
+        readonly gifCommentSave: "Save";
+        readonly gifCommentDelete: "Delete note";
+        readonly gifCommentsClear: "Clear";
+        readonly gifCommentsClearConfirm: "Clear all {count} notes?";
+        readonly gifEditCancel: "Cancel";
+        readonly gifSend: "Send ({count})";
+        readonly gifSending: "Sending…";
+        readonly gifEditDone: "Redrawn from your notes";
+        readonly gifEditSaveFailed: "Redrawn from your notes, but saving to the gallery failed. Please retry.";
+        readonly gifEditFailed: "Frame edit failed";
+        readonly gifEditFailedNotice: "Frame edit failed: {reason}";
+        readonly gifEditFailedHint: "Usually the channel's image-editing endpoint did not accept this request (for example, no images/edits or no GIF output); you can regenerate from a description instead.";
+        readonly gifEditStill: "The channel returned a still image, so the animation was not kept; your notes stay on the previous version.";
+        readonly gifEditFallbackRegenerate: "Regenerate from a description instead (the current animation is not kept)";
+        readonly gifEditFallbackHint: "Your notes were rewritten as text requirements after the prompt. This regenerates the whole animation without keeping the current one; edit further, then confirm.";
+        readonly gifSheetTooLarge: "The animation is too large to build a reference sheet";
+    };
+};
+export type GifTextKey = keyof typeof GIF_TEXT.zh;
+export type GifT = (key: GifTextKey, params?: Record<string, string>) => string;
+export declare function gifT(lang: 'zh' | 'en'): GifT;

package/lib/types/client/gif-menus.d.ts

@@ -0,0 +1,36 @@
+import type { GifT } from './gif-i18n.js';
+import { type GifPlayer } from './gif-player.js';
+/**
+ * The speed slider: a native range for keys and assistive tech, drawn as a
+ * vertical track. It carries no numbers; the trigger shows the value.
+ */
+export declare function GifSpeedPanel({ speed, t, onChange }: {
+    speed: number;
+    t: GifT;
+    onChange(speed: number): void;
+}): import("react").JSX.Element;
+/** The speed trigger and its panel: a chip on the card, a button in the lightbox bar. */
+export declare function GifSpeedControl({ player, t, variant, onOpenChange }: {
+    player: GifPlayer;
+    t: GifT;
+    variant: 'chip' | 'bar';
+    onOpenChange?: (open: boolean) => void;
+}): import("react").JSX.Element;
+export type GifDownloadKind = 'gif' | 'original' | 'frame';
+export interface GifDownloadItem {
+    kind: GifDownloadKind;
+    label: string;
+    hint: string;
+    disabled: boolean;
+}
+/** The GIF at the speed it plays, the original timing when that differs, and the frame on screen (one-based). */
+export declare function gifDownloadItems(t: GifT, speed: number, framesReady: boolean, frame: number): GifDownloadItem[];
+export interface GifDownloadMenuProps {
+    player: GifPlayer;
+    t: GifT;
+    /** The card's hover toolbar, the lightbox's top-right actions, or the gallery preview's bottom bar. */
+    variant: 'toolbar' | 'lightbox' | 'gallery';
+    onDownload(kind: GifDownloadKind): void;
+    onOpenChange?: (open: boolean) => void;
+}
+export declare function GifDownloadMenu({ player, t, variant, onDownload, onOpenChange }: GifDownloadMenuProps): import("react").JSX.Element;

package/lib/types/client/gif-player.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Frame-accurate GIF playback for the conversation card: a small external
+ * store that owns the decoded frames and the clock, a stage that paints the
+ * current frame, and a control bar. Frames are decoded only while a stage is
+ * visible and only within a memory budget; otherwise the GIF plays natively in
+ * an <img>, which still animates but cannot pause, seek or change speed.
+ */
+import { type DragEvent, type MouseEvent } from 'react';
+import { type GifInfo } from '../gif-info.js';
+import type { GifT } from './gif-i18n.js';
+/** Range and step of the speed control: one decimal is enough to fine-tune around 1x. */
+export declare const GIF_SPEED_MIN = 0.2;
+export declare const GIF_SPEED_MAX = 2;
+export declare const GIF_SPEED_STEP = 0.1;
+export declare const DECODE_TOTAL_BUDGET_BYTES: number;
+export declare function nextFrameIndex(index: number, total: number, delta?: number): number;
+/** Delays are rounded to the 10 ms ticks a retimed download stores, so the preview plays at the file's speed. */
+export declare function scheduledDelayMs(delayMs: number, speed: number): number;
+/** A speed on the control's grid and within its range; anything unreadable is 1x. */
+export declare function snapSpeed(speed: number): number;
+export declare function formatSpeed(speed: number): string;
+/**
+ * The delay a browser plays a frame for: its own decoder's duration when it
+ * reports one, else the header delay; either way a delay of at most 10 ms is
+ * shown for 100 ms, as the <img> element and the retimed download do.
+ */
+export declare function playedDelayMs(durationUs: number | null | undefined, headerMs: number): number;
+type GifKeyboardAction = 'toggle' | 'previous' | 'next' | 'first' | 'last';
+/**
+ * The lightbox shortcut for a key, given the element that holds focus. A
+ * focused control keeps only the keys it handles itself (a button its Space
+ * and Enter, the frame scrubber its arrows and Home/End), so stepping still
+ * works after the mouse has clicked a button, while a text field keeps all.
+ */
+export declare function gifKeyboardAction(key: string, target: {
+    tagName: string;
+    type?: string | undefined;
+} | null): GifKeyboardAction | undefined;
+/** File-name suffix for a download at a non-default speed. */
+export declare function speedSuffix(speed: number): string;
+/** "Download GIF", naming the speed only when it is not the file's own. */
+export declare function gifDownloadLabel(t: GifT, speed: number): string;
+/** Judged from the header before anything is decoded: the GIF alone, and together with what other cards already hold; a header without a screen size cannot be judged. */
+export declare function withinDecodeBudget(info: Pick<GifInfo, 'frames' | 'width' | 'height'>, usedBytes: number): boolean;
+type GifPlayerStatus = 'native' | 'decoding' | 'ready' | 'fallback';
+export interface GifPlayerSnapshot {
+    readonly status: GifPlayerStatus;
+    readonly info: GifInfo | undefined;
+    readonly index: number;
+    readonly playing: boolean;
+    /** A pointer is previewing frames on the strip: the clock holds, play state is kept. */
+    readonly scrubbing: boolean;
+    readonly speed: number;
+    /** Composited frames while `ready`; empty otherwise. */
+    readonly frames: readonly ImageBitmap[];
+    readonly delaysMs: readonly number[];
+}
+interface DecodedGif {
+    frames: ImageBitmap[];
+    delaysMs: number[];
+}
+/** Browser services the store relies on; tests inject stand-ins. */
+export interface GifPlayerDeps {
+    /** Resolves undefined when this environment cannot decode frame by frame. */
+    decode(blob: Blob, info: GifInfo): Promise<DecodedGif | undefined>;
+    encodeFrame(frame: ImageBitmap): Promise<Blob | undefined>;
+    hidden(): boolean;
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export interface GifPlayer {
+    readonly blob: Blob;
+    /** Object URL of the raw GIF for native playback and "open in new tab". */
+    readonly url: string | undefined;
+    /** The raw bytes once read; a drag-out needs them synchronously. */
+    bytes(): Uint8Array | undefined;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): GifPlayerSnapshot;
+    /** Each stage reports its own viewport state; frames exist while any stage is visible. */
+    setVisible(stage: unknown, visible: boolean): void;
+    play(): void;
+    pause(): void;
+    toggle(): void;
+    /** Seeking and stepping pause playback, so the chosen frame stays. */
+    seek(index: number): void;
+    /** Show a frame while the pointer is over the strip, without changing play state. */
+    scrub(index: number): void;
+    /** Leave the strip: playback goes on from the frame shown; a paused player returns to the frame it chose. */
+    endScrub(): void;
+    step(delta: number): void;
+    first(): void;
+    last(): void;
+    /** Takes effect on the next tick; nothing is re-decoded. */
+    setSpeed(speed: number): void;
+    /** Encode the frame on screen as PNG, leaving playback as it is; undefined until frames are decoded. */
+    captureFrame(): Promise<Blob | undefined>;
+    dispose(): void;
+}
+export declare function createGifPlayer(blob: Blob, overrides?: Partial<GifPlayerDeps>): GifPlayer;
+/**
+ * Paint one composited frame on the stage canvas. The canvas is cleared first:
+ * a frame can hold transparent pixels after disposal compositing, and
+ * source-over would leave the previous frame showing through them. A bitmap
+ * released between render and effect has zero size; drawing it would throw,
+ * so it is skipped.
+ */
+export declare function paintGifFrame(canvas: HTMLCanvasElement, frame: ImageBitmap): void;
+/** Own a player for the current GIF blob; a new blob replaces and disposes the previous player. */
+export declare function useGifPlayer(blob: Blob | undefined): GifPlayer | undefined;
+/** Status alone, so the card re-renders on readiness rather than on every frame. */
+export declare function useGifStatus(player: GifPlayer | undefined): GifPlayerStatus | undefined;
+export declare function useGifSpeed(player: GifPlayer | undefined): number | undefined;
+export declare function useGifPlaying(player: GifPlayer): boolean;
+/** Whether the file's bytes are read: the speed and a speed-named download need them, frames do not. */
+export declare function useGifReadable(player: GifPlayer | undefined): boolean;
+/** Every change, including each frame; only components that draw the frame should use it. */
+export declare function useGifSnapshot(player: GifPlayer): GifPlayerSnapshot;
+interface GifStageProps {
+    player: GifPlayer;
+    /** The card, the lightbox and the gallery preview are separate stages, each reporting its own visibility. */
+    stage: 'card' | 'lightbox' | 'gallery';
+    className: string;
+    alt: string;
+    /** Still image for a paused player without frames (re-decoding after a scroll), instead of the natively animating GIF. */
+    poster?: string | undefined;
+    onClick?: (event: MouseEvent<HTMLElement>) => void;
+    onDragStart?: (event: DragEvent<HTMLElement>) => void;
+}
+/** Paints the current frame on a canvas once decoded; the raw GIF plays in an <img> until then or when decoding is not possible. */
+export declare function GifStage({ player, stage, className, alt, poster, onClick, onDragStart }: GifStageProps): import("react").JSX.Element;
+export {};

package/lib/types/client/gif-sheet.d.ts

@@ -0,0 +1,116 @@
+/**
+ * The contact sheet a frame-comment edit sends as its reference image, and the
+ * prompt and request built around it. An edits endpoint takes a still, so
+ * every frame of the animation is tiled into one near-square grid in reading
+ * order; the prompt explains the grid and anchors each note inside its frame.
+ * Pure except for the canvas work, which takes injectable canvas and encoder
+ * stand-ins.
+ */
+import { type StudioGenerateRequest } from '../shared.js';
+import { type RegeneratableImage } from './conversation-regenerate.js';
+export declare const GIF_COMMENT_MAX_CHARS = 500;
+export declare const GIF_COMMENTS_MAX = 32;
+export interface GifComment {
+    /** Creation order; also the number on the pin. */
+    id: number;
+    /** Zero-based frame index. */
+    frame: number;
+    /** Position inside that frame, in percent of its width and height from the top-left corner. */
+    x: number;
+    y: number;
+    text: string;
+}
+export interface GifSheetPlan {
+    cols: number;
+    rows: number;
+    /** Cell size in sheet pixels; the frame size unless the sheet had to shrink. */
+    cellW: number;
+    cellH: number;
+    width: number;
+    height: number;
+    /** Trailing empty cells of the grid. */
+    blanks: number;
+    frames: number;
+}
+export interface SheetEncodeAttempt {
+    scale: number;
+    type: 'image/png' | 'image/jpeg';
+    quality: number;
+}
+export type SheetEncoder = (canvas: HTMLCanvasElement, attempt: SheetEncodeAttempt) => Promise<Blob | undefined>;
+export interface EncodedSheet {
+    blob: Blob;
+    mediaType: 'image/png' | 'image/jpeg';
+    plan: GifSheetPlan;
+}
+/**
+ * Near-square grid: cols = ceil(sqrt(n)). The cells shrink, snapped down to
+ * 16 px, only when the sheet's longest edge would exceed the provider limit.
+ */
+export declare function planGifSheet(frames: number, frameW: number, frameH: number, maxEdge?: number): GifSheetPlan;
+/** The size to show the sheet at: the full sheet scaled into the display edge, so the editor does not hold a second full-size copy. */
+export declare function sheetViewSize(plan: Pick<GifSheetPlan, 'width' | 'height'>, maxEdge?: number): {
+    width: number;
+    height: number;
+};
+/** A point inside one frame, as the same point on the whole sheet (percent, one decimal). */
+export declare function sheetPinPosition(comment: Pick<GifComment, 'frame' | 'x' | 'y'>, plan: GifSheetPlan): {
+    x: number;
+    y: number;
+};
+/** Paint the frames into their cells on a white sheet; blank cells stay white. */
+export declare function drawGifSheet(frames: readonly CanvasImageSource[], plan: GifSheetPlan, createCanvas?: () => HTMLCanvasElement): HTMLCanvasElement;
+/**
+ * First attempt that fits both the host limit and a modest request budget.
+ * The returned plan is scaled with the attempt, so the prompt can name the
+ * cell size that was actually sent.
+ */
+export declare function encodeSheetWithinLimit(canvas: HTMLCanvasElement, plan: GifSheetPlan, maxBytes: number, encode?: SheetEncoder): Promise<EncodedSheet>;
+/**
+ * The edit prompt: the opening instruction, the sheet layout as sent (its
+ * cells may be smaller than the frames) and the frames to produce at the
+ * animation's own size, then the notes grouped by frame the way ChatGPT
+ * writes them: a `Frame #n:` heading and one `(x: X%, y: Y%): note` line each.
+ */
+export declare function composeGifEditPrompt(comments: readonly GifComment[], plan: GifSheetPlan, frame: {
+    width: number;
+    height: number;
+}): string;
+export interface GifEditRequestInput {
+    /** The version being edited: its channel, model, output and the description it was drawn from. */
+    image: RegeneratableImage & {
+        prompt: string;
+    };
+    /** The editing model of the channel, as the workbench would pick it. */
+    model: string;
+    comments: readonly GifComment[];
+    /** The encoded sheet and the plan it was encoded at (scaled with the encoding attempt). */
+    sheet: {
+        mediaType: 'image/png' | 'image/jpeg';
+        data: string;
+        plan: GifSheetPlan;
+    };
+    /** The decoded frames: their size and the delays they play at, as captured when the editor opened. */
+    frame: {
+        width: number;
+        height: number;
+        delaysMs: readonly number[];
+    };
+    /** Playback speed; the delay asked for follows it, like a download does. */
+    speed: number;
+}
+/**
+ * The workbench edit that redraws the animation from the notes: the sheet as
+ * the only reference, and a GIF with the sheet's frame count, the delay the
+ * frames play at retimed by the speed, and the frame size the contract takes.
+ * The prompt is the sheet instruction; the card files the new version under
+ * the animation's own description instead.
+ */
+export declare function gifEditRequest({ image, model, comments, sheet, frame, speed }: GifEditRequestInput): StudioGenerateRequest;
+/**
+ * The same notes for a plain regeneration, which sees neither the previous
+ * animation nor the sheet: no coordinates, the frame only as a time hint.
+ */
+export declare function composeFallbackPrompt(originalPrompt: string, comments: readonly GifComment[], frameTotal: number): string;
+/** The frame delay to ask for: the animation's own delay retimed by the playback speed, within the provider range, in 10 ms steps. */
+export declare function gifEditFrameDurationMs(baseMs: number, speed: number): number | undefined;

package/lib/types/client/gif-style.d.ts

@@ -0,0 +1,2 @@
+/** Styles of the GIF player (card overlays, the lightbox player, its menus, the gallery hover) and of the card's saved-file link. */
+export declare const GIF_STYLE = "\n/* The host draws corners as superellipses; circles and pills here say corner-shape:round, as the host's own do. */\n.dsh-ig-savedto-open{appearance:none;display:inline-block;max-width:calc(100% - 5em);margin:0;padding:0;border:0;background:none;font:inherit;color:var(--dsw-alias-link,#3b6cf0);text-align:left;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;vertical-align:bottom;cursor:pointer}\n.dsh-ig-savedto-open:hover{text-decoration:underline}\n.dsh-ig-container.is-gif-open{overflow:visible}\n.dsh-ig-toolbar.is-pinned{opacity:1;pointer-events:auto}\n/* Above the chips only while its own menu is open, so it never covers the speed panel. */\n.dsh-ig-toolbar:has(.dsh-ig-dl-menu){z-index:4}\n.dsh-ig-toolbar .dsh-ig-tool-btn:disabled{opacity:.4;cursor:default;background:transparent}\n.dsh-ig-gif-badge{margin-left:8px;vertical-align:middle;font-size:11px;font-weight:600}\n.dsh-ig-gif-chip-slot{position:absolute;left:12px;bottom:12px;z-index:3;line-height:normal}\n.dsh-ig-gif-chip{corner-shape:round;appearance:none;border:0;min-width:44px;height:36px;padding:0 10px;border-radius:999px;background:rgba(17,20,26,0.6);color:#fff;font-size:13px;font-weight:600;font-variant-numeric:tabular-nums;cursor:pointer;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px)}\n.dsh-ig-gif-chip:hover:not(:disabled){background:rgba(17,20,26,0.8)}\n.dsh-ig-gif-chip:disabled{opacity:.55;cursor:default}\n.dsh-ig-speed{position:relative;display:inline-flex}\n.dsh-ig-speed-panel{corner-shape:round;position:absolute;bottom:calc(100% + 10px);left:50%;transform:translateX(-50%);width:52px;height:212px;box-sizing:border-box;padding:10px 0;border-radius:26px;background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-tertiary,#8a8f99);box-shadow:0 10px 30px rgba(15,23,42,0.18),0 0 0 1px rgba(15,23,42,0.06);display:flex;flex-direction:column;align-items:center;gap:8px;z-index:20;line-height:normal}\n.dsh-ig-speed-bar .dsh-ig-speed-panel{bottom:calc(100% + 12px);background:rgba(32,35,42,0.96);color:rgba(255,255,255,0.6);box-shadow:0 10px 30px rgba(0,0,0,0.45)}\n.dsh-ig-speed-bar .dsh-ig-speed-rail{background:rgba(255,255,255,0.18)}\n.dsh-ig-speed-bar .dsh-ig-speed-fill{background:#5b8cff}\n.dsh-ig-speed-bar .dsh-ig-speed-one{background:rgba(255,255,255,0.45)}\n.dsh-ig-speed-chip .dsh-ig-speed-panel{left:0;transform:none}\n.dsh-ig-speed-icon{display:flex}\n.dsh-ig-speed-track{position:relative;width:28px;height:150px}\n.dsh-ig-speed-rail,.dsh-ig-speed-fill{corner-shape:round;position:absolute;left:11px;width:6px;border-radius:3px}\n.dsh-ig-speed-rail{top:0;bottom:0;background:rgba(127,127,127,0.25)}\n.dsh-ig-speed-fill{bottom:0;height:var(--dsh-ig-speed-pct);background:var(--dsw-alias-state-business-primary,#3b6cf0)}\n.dsh-ig-speed-one{position:absolute;left:7px;width:14px;height:2px;border-radius:1px;top:calc(var(--dsh-ig-speed-one) - 1px);background:rgba(127,127,127,0.55)}\n.dsh-ig-speed-knob{corner-shape:round;position:absolute;left:4px;width:20px;height:20px;border-radius:50%;bottom:calc(var(--dsh-ig-speed-pct) - 10px);background:#fff;box-shadow:0 1px 4px rgba(15,23,42,0.35);pointer-events:none}\n.dsh-ig-speed-track:focus-within .dsh-ig-speed-knob{box-shadow:0 0 0 3px rgba(59,108,240,0.45),0 1px 4px rgba(15,23,42,0.35)}\n.dsh-ig-speed-input{position:absolute;inset:0;width:28px;height:150px;margin:0;opacity:0;writing-mode:vertical-lr;direction:rtl;cursor:pointer}\n.dsh-ig-dl{position:relative;display:inline-flex}\n.dsh-ig-dl-menu{position:absolute;top:calc(100% + 8px);left:0;width:236px;box-sizing:border-box;padding:6px;border-radius:12px;background:var(--dsw-alias-bg-layer-3,#fff);box-shadow:0 10px 30px rgba(15,23,42,0.18),0 0 0 1px rgba(15,23,42,0.06);z-index:20;line-height:normal}\n.dsh-ig-dl-lightbox .dsh-ig-dl-menu{left:auto;right:0;box-shadow:0 10px 30px rgba(0,0,0,0.4)}\n.dsh-ig-dl-item{appearance:none;display:flex;flex-direction:column;align-items:flex-start;gap:2px;width:100%;min-height:44px;padding:8px 14px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-primary,#1f2329);font:inherit;font-size:14px;text-align:left;cursor:pointer}\n.dsh-ig-dl-item>span:first-child{font-weight:500}\n.dsh-ig-dl-item:hover:not(:disabled){background:var(--dsw-alias-bg-layer-2,#f2f4f7)}\n.dsh-ig-dl-item:disabled{opacity:.45;cursor:default}\n.dsh-ig-dl-hint{font-size:12px;color:var(--dsw-alias-label-tertiary,#8a8f99)}\n/* The lightbox and the gallery preview are always dark: their menus stay light whatever the host theme. */\n.dsh-ig-dl-lightbox .dsh-ig-dl-menu,.dsh-ig-dl-gallery .dsh-ig-dl-menu{background:#fff}\n.dsh-ig-dl-lightbox .dsh-ig-dl-item,.dsh-ig-dl-gallery .dsh-ig-dl-item{color:#1f2329}\n.dsh-ig-dl-lightbox .dsh-ig-dl-item:hover:not(:disabled),.dsh-ig-dl-gallery .dsh-ig-dl-item:hover:not(:disabled){background:#f2f4f7}\n.dsh-ig-dl-lightbox .dsh-ig-dl-hint,.dsh-ig-dl-gallery .dsh-ig-dl-hint{color:#8a8f99}\n.dsh-ig-gif-actions{position:absolute;top:20px;right:20px;display:flex;align-items:center;gap:10px;z-index:10}\n.dsh-ig-gif-action{corner-shape:round;appearance:none;border:0;height:40px;min-width:40px;padding:0 12px;border-radius:999px;background:rgba(255,255,255,0.12);color:#fff;display:inline-flex;align-items:center;justify-content:center;gap:4px;font-size:13px;cursor:pointer}\n.dsh-ig-gif-action:hover{background:rgba(255,255,255,0.22)}\n.dsh-ig-gif-toast{position:absolute;top:72px;right:20px;font-size:12px;color:rgba(255,255,255,0.8);z-index:10}\n/* The lightbox is always dark, so its accents use a fixed blue: the host's brand colour is neutral (near-black, or near-white in its dark theme). */\n.dsh-ig-gif-dock{position:absolute;bottom:28px;left:50%;transform:translateX(-50%);display:flex;flex-direction:column;align-items:stretch;gap:10px;max-width:calc(100vw - 48px);z-index:10;cursor:default}\n.dsh-ig-gif-bar{corner-shape:round;display:flex;align-items:center;gap:10px;padding:6px;border-radius:999px;background:rgba(255,255,255,0.1);box-shadow:0 0 0 1px rgba(255,255,255,0.08);-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);box-sizing:border-box;max-width:calc(100vw - 48px);color:#fff;line-height:normal}\n/* No z-index: the gallery's bottom bar, later in the page, paints over this one, so its download menu opens on top. */\n.dsh-ig-gif-bar-gallery{position:absolute;bottom:128px;left:50%;transform:translateX(-50%)}\n.dsh-ig-gif-play{corner-shape:round;appearance:none;flex:none;width:44px;height:44px;border:0;border-radius:50%;background:#fff;color:#0d0f13;display:inline-flex;align-items:center;justify-content:center;cursor:pointer}\n.dsh-ig-gif-play:disabled{opacity:.5;cursor:default}\n.dsh-ig-gif-bar .dsh-ig-speed-trigger{corner-shape:round;appearance:none;min-width:56px;height:44px;padding:0 12px;border:0;border-radius:999px;background:rgba(255,255,255,0.12);color:#fff;font-size:15px;font-weight:600;font-variant-numeric:tabular-nums;cursor:pointer}\n.dsh-ig-gif-bar .dsh-ig-speed-trigger:disabled{opacity:.5;cursor:default}\n.dsh-ig-gif-strip{position:relative;flex:0 1 auto;width:350px;min-width:160px;height:44px;border-radius:8px;overflow:hidden;background:rgba(255,255,255,0.12);cursor:pointer;touch-action:none;outline:none}\n.dsh-ig-gif-strip:focus-visible{box-shadow:0 0 0 2px #fff}\n.dsh-ig-gif-strip[aria-disabled=\"true\"]{cursor:default;animation:dsh-ig-gif-pulse 1.2s ease-in-out infinite}\n.dsh-ig-gif-strip canvas{display:block;width:100%;height:100%}\n.dsh-ig-gif-strip-head{position:absolute;top:0;bottom:0;width:2px;margin-left:-1px;background:#5b8cff;pointer-events:none}\n@keyframes dsh-ig-gif-pulse{50%{opacity:.6}}\n.dsh-ig-gif-strip-mark{corner-shape:round;position:absolute;top:3px;width:7px;height:7px;margin-left:-3.5px;border-radius:50%;background:#5b8cff;box-shadow:0 0 0 1.5px #fff;pointer-events:none}\n/* The frame stays clear of the bars under it: it is lifted by their measured height (--dsh-ig-gif-dock-h) and sized to fit above them. */\n.dsh-ig-gif-wrap{position:relative;max-height:none;margin-bottom:calc(var(--dsh-ig-gif-dock-h,56px) + 52px)}\n.dsh-ig-gif-wrap .dsh-ig-lightbox-img,.dsh-ig-gif-sheet{display:block;max-height:calc(100vh - var(--dsh-ig-gif-dock-h,56px) - 192px)}\n.dsh-ig-gif-wrap.is-editing{border-radius:10px;box-shadow:0 0 0 3px #3b6cf0}\n.dsh-ig-gif-wrap.is-sheet .dsh-ig-gif-stage{position:absolute;inset:0;overflow:hidden;opacity:0;pointer-events:none}\n.dsh-ig-gif-sheet{display:block;max-width:86vw;border-radius:10px;background:#1b1e24}\n.dsh-ig-gif-edit-chip-slot{position:absolute;right:12px;bottom:12px;z-index:3;line-height:normal}\n.dsh-ig-container:has(.dsh-ig-version-nav) .dsh-ig-gif-edit-chip-slot{bottom:48px}\n.dsh-ig-gif-edit-chip{display:inline-flex;align-items:center;gap:6px;padding:0 12px}\n.dsh-ig-gif-edit-toggle{corner-shape:round;appearance:none;flex:none;height:44px;padding:0 18px;border-radius:999px;border:1.5px solid rgba(255,255,255,0.45);background:transparent;color:#fff;font:inherit;font-size:14px;font-weight:600;cursor:pointer}\n.dsh-ig-gif-edit-toggle.is-active{background:#3b6cf0;border-color:#3b6cf0}\n.dsh-ig-gif-edit-toggle:disabled{opacity:.5;cursor:default}\n/* The edit bar takes the player bar's width rather than widening it, and wraps its text. */\n.dsh-ig-gif-edit{contain:inline-size;box-sizing:border-box;padding:10px 12px;border-radius:14px;background:rgba(255,255,255,0.08);color:#fff;display:grid;gap:8px;line-height:normal}\n.dsh-ig-gif-edit-hint{margin:0;font-size:12px;line-height:1.45;color:rgba(255,255,255,0.6)}\n.dsh-ig-gif-edit-row{display:flex;align-items:center;gap:8px}\n.dsh-ig-gif-edit-counter{flex:1;min-width:0;font-size:13px;color:rgba(255,255,255,0.85);font-variant-numeric:tabular-nums;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}\n.dsh-ig-gif-view{corner-shape:round;display:flex;flex:none;padding:3px;border-radius:999px;background:rgba(255,255,255,0.08)}\n.dsh-ig-gif-view button{corner-shape:round;appearance:none;height:32px;padding:0 12px;border:0;border-radius:999px;background:transparent;font:inherit;font-size:13px;color:rgba(255,255,255,0.7);cursor:pointer}\n.dsh-ig-gif-view button[aria-pressed=\"true\"]{background:rgba(255,255,255,0.18);color:#fff;font-weight:600}\n.dsh-ig-gif-edit-ghost,.dsh-ig-gif-edit-send{corner-shape:round;appearance:none;flex:none;height:36px;border-radius:999px;font:inherit;font-size:13px;cursor:pointer}\n.dsh-ig-gif-edit-ghost{padding:0 12px;border:1px solid rgba(255,255,255,0.25);background:transparent;color:#fff}\n.dsh-ig-gif-edit-send{padding:0 14px;border:0;background:#3b6cf0;color:#fff;font-weight:600}\n.dsh-ig-gif-edit-ghost:disabled,.dsh-ig-gif-edit-send:disabled{opacity:.5;cursor:default}\n.dsh-ig-gif-edit-notice,.dsh-ig-gif-edit-error{display:grid;gap:6px;justify-items:start;padding:8px 10px;border-radius:8px;font-size:12px;line-height:1.45;white-space:pre-wrap;word-break:break-word}\n.dsh-ig-gif-edit-notice{margin:6px 0;background:var(--dsw-alias-bg-layer-2,rgba(0,0,0,0.05));color:var(--dsw-alias-label-secondary,inherit)}\n.dsh-ig-gif-edit-error{background:rgba(239,68,68,0.16);color:#fca5a5}\n/* The cursor is the pin it places, its sharp corner on the point, as ChatGPT draws it. */\n.dsh-ig-gif-edit-layer{position:absolute;inset:0;z-index:3;margin:0;padding:0;border:0;border-radius:10px;background:transparent;cursor:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24'%3E%3Cpath d='M2 22V12A10 10 0 0 1 22 12A10 10 0 0 1 12 22Z' fill='%233b6cf0' stroke='white' stroke-width='1.5'/%3E%3C/svg%3E\") 2 22,crosshair}\n/* While a note is being written, a click on the picture only closes it, so the cursor is the plain one. */\n.dsh-ig-gif-wrap:has(.dsh-ig-gif-note.is-new,.dsh-ig-gif-note.is-edit) :is(.dsh-ig-gif-edit-layer,.dsh-ig-gif-sheet-cell){cursor:default}\n.dsh-ig-gif-edit-layer:focus-visible{outline:2px solid #fff;outline-offset:-2px}\n.dsh-ig-gif-sheet-cell{position:absolute;z-index:3;box-sizing:border-box;margin:0;padding:0;border:0;background:transparent;outline:1px solid #0d0f13;outline-offset:-1px;cursor:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24'%3E%3Cpath d='M2 22V12A10 10 0 0 1 22 12A10 10 0 0 1 12 22Z' fill='%233b6cf0' stroke='white' stroke-width='1.5'/%3E%3C/svg%3E\") 2 22,crosshair}\n.dsh-ig-gif-sheet-cell.is-current{outline:2px solid #3b6cf0;outline-offset:-2px}\n.dsh-ig-gif-sheet-cell.is-blank{cursor:default;background:#1b1e24}\n.dsh-ig-gif-sheet-cell:focus-visible{outline:2px solid #fff;outline-offset:-2px}\n.dsh-ig-gif-sheet-cell span{position:absolute;left:4px;top:4px;padding:1px 5px;border-radius:4px;background:rgba(0,0,0,0.6);color:#fff;font-size:11px;font-weight:600;line-height:1.4;pointer-events:none}\n.dsh-ig-gif-pin{corner-shape:round;position:absolute;z-index:4;min-width:28px;height:28px;margin:-28px 0 0;box-sizing:border-box;padding:0 7px;border:2px solid #fff;border-radius:14px 14px 14px 0;background:#3b6cf0;color:#fff;font:inherit;font-size:13px;font-weight:700;line-height:24px;text-align:center;box-shadow:0 2px 6px rgba(0,0,0,0.4);cursor:pointer}\n.dsh-ig-gif-pin.is-small{min-width:20px;height:20px;margin-top:-20px;padding:0 4px;border-width:1.5px;border-radius:10px 10px 10px 0;font-size:11px;line-height:17px}\n.dsh-ig-gif-pin.is-active{box-shadow:0 0 0 3px rgba(59,108,240,0.55),0 2px 6px rgba(0,0,0,0.4)}\n.dsh-ig-gif-pin.is-draft{pointer-events:none}\n.dsh-ig-gif-note{corner-shape:round;position:absolute;z-index:5;width:292px;max-width:calc(100vw - 32px);box-sizing:border-box;background:#2f2f2f;color:#fff;box-shadow:0 12px 32px rgba(0,0,0,0.5),0 0 0 1px rgba(255,255,255,0.1);transform:translate(30px,-36px);line-height:normal;cursor:default}\n.dsh-ig-gif-note:focus{outline:none}\n.dsh-ig-gif-note.is-left{transform:translate(calc(-100% - 8px),-36px)}\n.dsh-ig-gif-note.is-up{transform:translate(30px,calc(-100% + 8px))}\n.dsh-ig-gif-note.is-left.is-up{transform:translate(calc(-100% - 8px),calc(-100% + 8px))}\n.dsh-ig-gif-note.is-new{height:44px;display:flex;align-items:center;gap:8px;padding:0 4px 0 18px;border-radius:999px}\n.dsh-ig-gif-note.is-edit{padding:4px 6px 6px 16px;border-radius:22px}\n.dsh-ig-gif-note.is-view{min-height:44px;display:flex;align-items:center;padding:10px 18px;border-radius:22px}\n.dsh-ig-gif-note.is-view p{margin:0;flex:1;font-size:15px;line-height:1.5;word-break:break-word}\n.dsh-ig-gif-note-field{height:40px;display:flex;align-items:center}\n.dsh-ig-gif-note-input{flex:1;min-width:0;width:100%;height:36px;margin:0;padding:0;border:0;outline:0;background:transparent;color:#fff;font:inherit;font-size:15px}\n.dsh-ig-gif-note-input::placeholder{color:rgba(255,255,255,0.5)}\n.dsh-ig-gif-note-actions{display:flex;align-items:center;gap:6px}\n.dsh-ig-gif-note-actions span{flex:1}\n.dsh-ig-gif-note-icon,.dsh-ig-gif-note-post{corner-shape:round;appearance:none;flex:none;width:36px;height:36px;margin:0;padding:0;border:0;border-radius:50%;display:flex;align-items:center;justify-content:center;cursor:pointer}\n.dsh-ig-gif-note-icon{margin-left:-8px;background:transparent;color:#fff}\n.dsh-ig-gif-note-icon:hover{background:rgba(255,255,255,0.1)}\n.dsh-ig-gif-note-post{background:#fff;color:#1f2329}\n.dsh-ig-gif-note-post:disabled{background:#8a8a8a;color:#2f2f2f;cursor:default}\n.dsh-ig-gif-note-ghost,.dsh-ig-gif-note-save{corner-shape:round;appearance:none;flex:none;height:36px;border-radius:999px;font:inherit;font-size:14px;cursor:pointer}\n.dsh-ig-gif-note-ghost{padding:0 14px;border:1px solid rgba(255,255,255,0.2);background:rgba(255,255,255,0.06);color:#fff}\n.dsh-ig-gif-note-save{padding:0 16px;border:0;background:#fff;color:#1f2329;font-weight:600}\n.dsh-ig-gif-note-save:disabled{opacity:.45;cursor:default}\n.dsh-ig-gallery-gif-badge{position:absolute;left:10px;top:10px;padding:2px 7px;border-radius:6px;background:rgba(17,20,26,0.66);color:#fff;font-size:11px;font-weight:700;line-height:16px;letter-spacing:.3px;pointer-events:none;z-index:2;transition:opacity .15s ease}\n.dsh-ig-gallery-card:hover .dsh-ig-gallery-gif-badge,.dsh-ig-gallery-card.is-manage-mode .dsh-ig-gallery-gif-badge,.dsh-ig-gallery-card.is-selected .dsh-ig-gallery-gif-badge{opacity:0}\n.dsh-ig-gallery-gif-hover{position:absolute;inset:0;pointer-events:none}\n.dsh-ig-lightbox-img.dsh-ig-gallery-gif-img{max-height:calc(100vh - 400px)}\n.dsh-ig-dl-gallery .dsh-ig-dl-menu{top:auto;bottom:calc(100% + 8px);box-shadow:0 10px 30px rgba(0,0,0,0.4)}\n.dsh-ig-dl-gallery svg{width:14px;height:14px}\n";

package/lib/types/client/image-result-node.d.ts

@@ -1,5 +1,5 @@
 /** Modern DSH conversation node that keeps image artifacts outside Tool process folding. */
-import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { ImageAttachmentRef, ImageMediaType } from '@deepseek-ai/dsh-attachment';
 export declare const IMAGE_RESULT_NODE_KIND = "dsh-image-result";
 export interface ImageResultPresentation {
     readonly attachment: ImageAttachmentRef;
@@ -13,6 +13,12 @@ export interface ImageResultPresentation {
     readonly seed?: number;
     /** Attachment ids of the edit sources when this image came from edit_image; used to rebuild canvas edit chains. */
     readonly sourceAttachmentIds?: readonly string[];
+    /** Raw bytes in the vault when the attachment is a normalized copy; today only an animated GIF. */
+    readonly original?: {
+        readonly key: string;
+        readonly bytes: number;
+        readonly mediaType: ImageMediaType;
+    };
 }
 interface ImageResultState {
     /** Owning conversation turn; PTC (run_code) sub-call results carry no turn. */
@@ -72,4 +78,16 @@ export declare function imageResultsFromMeta(value: unknown): readonly ImageResu
 export declare function imageResultFromPtcDispatch(event: EventLike): ImageResultPresentation | undefined;
 /** Pair each rendered image with its own summary, including batches with failed items. */
 export declare function imageResultsFromPtcDispatch(event: EventLike): readonly ImageResultPresentation[];
+/**
+ * The identity of one image version. A still is its attachment; an animated
+ * result is also its vault original, because the host normalizes a GIF to a
+ * still of its first frame and two animations that differ only after that
+ * frame share one attachment. Keying versions, gallery records and frame notes
+ * by the attachment alone would merge such animations into one.
+ */
+export declare function imageVersionKey(attachmentId: string, original: {
+    readonly key: string;
+} | undefined): string;
+/** Parse a vault reference; anything malformed drops the reference, never the image that carries it. */
+export declare function originalFromMeta(value: unknown): ImageResultPresentation['original'];
 export {};

package/lib/types/client/image-result-view.d.ts

@@ -0,0 +1,26 @@
+import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type ImageResultPresentation } from './image-result-node.js';
+import { type LocaleService } from './gallery-view.js';
+export interface ImageCardFace {
+    locale?: LocaleService | undefined;
+    promoted: boolean;
+}
+export type ImageCardProps = PropsRuntime<'tool.call.toolview'> & InjectFace<ImageCardFace> & {
+    sessionId?: string | undefined;
+};
+export interface ImageResultNodeProps {
+    node: {
+        data: {
+            results: readonly ImageResultPresentation[];
+        };
+    };
+    locale?: LocaleService | undefined;
+    sessionId?: string | undefined;
+    /** The host's file opener, the one reply file links use; hosts that do not pass it get the plain path. */
+    openFile?: ((path: string) => void) | undefined;
+}
+export declare function GeneratedImageCard(props: ImageCardProps): import("react").JSX.Element;
+/** Suppress the folded duplicate on modern hosts; render every image on legacy hosts. */
+export declare function GeneratedImagesCard(props: ImageCardProps): import("react").JSX.Element;
+/** Render modern image artifacts as final conversation output instead of Tool process content. */
+export declare function PromotedImageResultNode(props: ImageResultNodeProps): import("react").JSX.Element;

package/lib/types/client/index.d.ts

@@ -11,7 +11,7 @@ export interface SettingsScope<T> {
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type ComfyUIWorkflowEntry, type OpenAICompatChannel, type ImageProvider } from '../shared.js';
 import { type LocaleService } from './gallery-view.js';
-import { type ImageResultPresentation } from './image-result-node.js';
+export { GeneratedImageCard, GeneratedImagesCard, PromotedImageResultNode } from './image-result-view.js';
 type Provider = ImageProvider;
 interface ImageSettings {
     provider?: Provider;
@@ -95,20 +95,7 @@ interface SettingsFace {
     locale?: LocaleService | undefined;
     credentialEvents?: CredentialEvents | undefined;
 }
-interface ImageCardFace {
-    locale?: LocaleService | undefined;
-    promoted: boolean;
-}
 type SettingsCardProps = PropsRuntime<'settings.plugins.tab'> & InjectFace<SettingsFace>;
-type ImageCardProps = PropsRuntime<'tool.call.toolview'> & InjectFace<ImageCardFace>;
-interface ImageResultNodeProps {
-    node: {
-        data: {
-            results: readonly ImageResultPresentation[];
-        };
-    };
-    locale?: LocaleService | undefined;
-}
 /**
  * Required browser services. The settings form reader is deliberately absent:
  * DSH 0.1.7 serves it as `configForms` (keyed by the Loader entry id) while
@@ -121,9 +108,3 @@ export declare const inject: string[];
 export declare function apply(ctx: Context): void;
 /** Edit each provider independently, pick an explicit default, and verify keys inline. */
 export declare function ImageGenerationSettingsCard(props: SettingsCardProps): import("react").JSX.Element;
-/** Keep the legacy Tool row for old DSH and hand modern results to the independent Chat node. */
-export declare function GeneratedImageCard(props: ImageCardProps): import("react").JSX.Element;
-/** Suppress the folded duplicate on modern hosts; render every image on legacy hosts. */
-export declare function GeneratedImagesCard(props: ImageCardProps): import("react").JSX.Element;
-/** Render modern image artifacts as final conversation output instead of Tool process content. */
-export declare function PromotedImageResultNode(props: ImageResultNodeProps): import("react").JSX.Element;