dsh-image-gen 0.10.2 → 0.10.3

package/lib/types/client/browser-image-utils.d.ts

@@ -21,3 +21,9 @@ export interface ZipFileInput {
  * Zero external dependencies, pure browser ArrayBuffer/Blob, fast and universally compatible with OS extractors.
  */
 export declare function createZipBlob(files: ZipFileInput[]): Blob;
+/**
+ * Downscale an image for the gallery grid.
+ * Returns the source blob when the browser lacks the needed canvas APIs, so
+ * callers can always render something without extra capability branches.
+ */
+export declare function createImageThumbnail(source: Blob, width: number): Promise<Blob>;

package/lib/types/client/datalist-scroll-fix.d.ts

@@ -0,0 +1,32 @@
+/** Close plugin datalist popups on deliberate scrolling without stealing new focus. */
+type Listener = (event?: {
+    key?: string;
+    target?: unknown;
+}) => void;
+interface EventTargetLike {
+    addEventListener(type: string, listener: Listener, capture?: boolean): void;
+    removeEventListener(type: string, listener: Listener, capture?: boolean): void;
+}
+export interface FocusableElement {
+    tagName: string;
+    hasAttribute(name: string): boolean;
+    blur(): void;
+}
+export interface DatalistScrollFixEnvironment {
+    window: EventTargetLike & Record<string, unknown>;
+    document: EventTargetLike & {
+        activeElement: FocusableElement | null;
+    };
+    /** Return a cancellation callback when the scheduler supports cancellation. */
+    schedule?: (callback: Listener) => void | (() => void);
+    ownsInput?: (element: FocusableElement) => boolean;
+}
+export declare function isDatalistInput(element: FocusableElement | null): boolean;
+export declare function closeDatalistPopup(element: FocusableElement | null): boolean;
+/**
+ * Automatic scrolling after Tab/focus or virtual-keyboard resize must not blur
+ * the input. Only scrolling preceded by a wheel/touch/scrollbar/key gesture can
+ * dismiss the popup, and its original focus must still be current.
+ */
+export declare function installDatalistScrollFix(environment?: DatalistScrollFixEnvironment): false | (() => void);
+export {};

package/lib/types/client/gallery-batch-bar.d.ts

@@ -0,0 +1,8 @@
+/** The two gallery tabs that render the selectable grid. */
+export type BatchBarTab = 'gallery' | 'studio' | 'inspiration' | 'favorites';
+/**
+ * The batch bar is a fixed overlay at the page root, so it must only render on
+ * the grid tabs; leaving them (studio/inspiration) hides it even if manage mode
+ * or a selection somehow survives a tab switch.
+ */
+export declare function shouldShowBatchBar(activeTab: BatchBarTab, isManageMode: boolean, selectedCount: number): boolean;

package/lib/types/client/gallery-card.d.ts

@@ -0,0 +1,21 @@
+import { type MouseEvent } from 'react';
+import type { GalleryItem } from './gallery-store.js';
+import type { DictKey } from './gallery-i18n.js';
+/** Stable dispatchers shared by every card, so memoized cards never re-render for selection changes. */
+export interface GalleryCardActions {
+    click: (item: GalleryItem, index: number, event: MouseEvent) => void;
+    toggleSelect: (item: GalleryItem, index: number, event: MouseEvent) => void;
+    requestDelete: (item: GalleryItem) => void;
+    preview: (item: GalleryItem, blob?: Blob) => void;
+    toast: (message: string) => void;
+}
+export interface GalleryCardProps {
+    lang: 'zh' | 'en';
+    item: GalleryItem;
+    index: number;
+    isManageMode: boolean;
+    isSelected: boolean;
+    t: (key: DictKey, params?: Record<string, string>) => string;
+    actions: GalleryCardActions;
+}
+export declare const GalleryCard: import("react").MemoExoticComponent<({ lang, item, index, isManageMode, isSelected, t, actions, }: GalleryCardProps) => import("react").JSX.Element>;

package/lib/types/client/gallery-format.d.ts

@@ -0,0 +1,7 @@
+import type { GalleryItem } from './gallery-store.js';
+import type { DictKey } from './gallery-i18n.js';
+export declare function formatRelativeTime(timestamp: number, t: (key: DictKey, params?: Record<string, string>) => string): string;
+/** Extract standard aspect ratio for precise filtering */
+export declare function getItemRatio(item: GalleryItem): string;
+/** Format aspect ratio or dimensions for card metadata (e.g., 1024×1024 or 16:9) */
+export declare function formatCardMeta(item: GalleryItem): string;

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

@@ -0,0 +1,236 @@
+/** Gallery copy for the zh/en dictionaries and their key union. */
+export declare const DICT: {
+    readonly zh: {
+        readonly tabGallery: "图库";
+        readonly tabStudio: "工作台";
+        readonly tabInspiration: "灵感";
+        readonly tabFavorites: "收藏";
+        readonly tabCompare: "对比";
+        readonly tabTasks: "任务";
+        readonly filterAllProviders: "全部提供商";
+        readonly filterGoogle: "Google Gemini";
+        readonly filterOpenAI: "OpenAI";
+        readonly filterOpenAICompat: "OpenAI 兼容";
+        readonly filterSeedream: "字节 Seedream";
+        readonly filterDashScope: "阿里 DashScope";
+        readonly filterXAI: "xAI Grok";
+        readonly filterZhipu: "智谱 GLM";
+        readonly filterComfyUI: "本地 ComfyUI";
+        readonly filterImport: "导入";
+        readonly importImages: "导入图片";
+        readonly importAdded: "已导入 {count} 张图片";
+        readonly importPartial: "导入 {count} 张，{fail} 张失败";
+        readonly importFailed: "导入失败";
+        readonly importPickHint: "选择要导入的图片（PNG/JPG/WebP/GIF）";
+        readonly filterAllModels: "全部模型";
+        readonly filterAllRatios: "全部比例";
+        readonly searchPlaceholder: "搜索 Prompt、标签…";
+        readonly filterCurrentWorkspace: "仅看此工作区";
+        readonly filterCurrentWorkspaceHint: "只展示属于当前工作区的生图记录与物理文件";
+        readonly sortNewest: "最新生成";
+        readonly sortOldest: "最早生成";
+        readonly totalCount: "共 {count} 张生成图片";
+        readonly emptyTitle: "暂无生图记录";
+        readonly emptyDesc: "在对话中让 Agent 生图后，生成的图片会自动收录到这里。";
+        readonly favEmptyTitle: "暂无收藏图片";
+        readonly favEmptyDesc: "在图库中点击卡片右下角的 ♡ 按钮，即可将喜爱的图片收录到这里。";
+        readonly noMatchTitle: "未找到匹配结果";
+        readonly noMatchDesc: "尝试更换搜索关键词或调整筛选条件。";
+        readonly copiedPrompt: "已复制 Prompt";
+        readonly copiedImage: "已复制图片";
+        readonly copyFailed: "复制失败";
+        readonly favoriteAdded: "已添加到收藏";
+        readonly favoriteRemoved: "已取消收藏";
+        readonly preview: "查看大图";
+        readonly download: "下载图片";
+        readonly copyImg: "复制图片";
+        readonly copyPpt: "复制 Prompt";
+        readonly regenerate: "重新生成";
+        readonly regenerateTitle: "重新生成图片";
+        readonly regenerateHint: "可按需修改 Prompt，基于当前模型和比例在画廊生成一张新图片。";
+        readonly confirmRegenerate: "开始生成";
+        readonly regenerating: "正在重新生成…";
+        readonly regenerateSuccess: "已生成新图片并收录到画廊";
+        readonly regenerateSaveFailed: "图片已生成，但保存到图库失败，请重试";
+        readonly regenerateFailed: "重新生成失败";
+        readonly delete: "从画廊删除";
+        readonly confirmDelete: "确定要从画廊中删除这张图片吗？若它是导入时被归一化/转码的原图，且没有其他图库或浏览器引用，原图也会永久删除。（不会影响原聊天记录）";
+        readonly deleted: "已从画廊删除";
+        readonly model: "模型";
+        readonly prompt: "Prompt";
+        readonly close: "关闭 (Esc)";
+        readonly prevImage: "上一张 (←)";
+        readonly nextImage: "下一张 (→)";
+        readonly manage: "批量管理";
+        readonly exitManage: "退出选择";
+        readonly selectedCount: "已选 {n} 项";
+        readonly selectAll: "全选";
+        readonly invertSelect: "反选";
+        readonly clearSelect: "清空";
+        readonly batchFavorite: "批量收藏";
+        readonly batchUnfavorite: "批量取消收藏";
+        readonly batchFavoritedToast: "已将 {count} 张图片加入收藏";
+        readonly batchUnfavoritedToast: "已取消 {count} 张图片的收藏";
+        readonly batchFavoriteFailed: "收藏操作失败，请重试";
+        readonly batchDownload: "批量下载";
+        readonly batchDownloading: "打包中 ({current}/{total})…";
+        readonly batchDownloadSingleToast: "已下载 1 张图片";
+        readonly batchDownloadZipToast: "已开始下载 {count} 张图片（ZIP）";
+        readonly batchDownloadComplete: "已下载 {count} 张图片（ZIP）";
+        readonly batchDownloadFailed: "批量下载失败，请重试";
+        readonly batchDownloadLimit: "选择过大：一次最多导出 2000 张，请分批下载";
+        readonly batchDelete: "批量删除";
+        readonly batchDeleteTitle: "确认批量删除选中的 {count} 张图片？";
+        readonly batchDeleteTitleSingle: "确认从画廊中删除这张图片？";
+        readonly batchDeleteDesc: "将从画廊历史记录中移除所选图片；其中导入时被归一化/转码的原图，若没有其他引用也会永久删除。";
+        readonly deleteWorkspaceFilesOpt: "同时清理工作区磁盘物理文件（不可恢复）";
+        readonly cancel: "取消";
+        readonly confirmBatchDelete: "确认删除 ({count})";
+        readonly confirmDeleteSingle: "确认删除";
+        readonly batchDeletedToast: "已删除 {count} 张图片";
+        readonly storageTitle: "存储占用";
+        readonly storageScanning: "扫描中…";
+        readonly storageAttachments: "附件对象";
+        readonly storageThumbs: "缩略图缓存（本地回退）";
+        readonly storageRequestCache: "请求图缓存";
+        readonly storageOrphans: "画廊未引用附件";
+        readonly storageItems: "{n} 个文件";
+        readonly storageOrphanHint: "只统计本图库记录未引用的对象；其他会话、画布或上传仍可能引用，导出清单不代表可安全删除。";
+        readonly storageThumbsHint: "服务端缩略图正常时，本地回退缓存保持为空；320px 缩略图计入请求图缓存。";
+        readonly storageExport: "导出孤儿清单";
+        readonly storageScanFailed: "存储统计失败";
+        readonly storageClose: "关闭";
+        readonly batchDeletedWithFilesToast: "已删除 {count} 张图片，并清理了 {files} 个工作区文件";
+        readonly deleteFailedFileLocked: "已删除 {count} 张图片，但有 {files} 个文件因被系统占用未能删除";
+        readonly deleteFailedDatabase: "删除失败：本地数据库操作异常";
+        readonly justNow: "刚刚";
+        readonly minutesAgo: "{n} 分钟前";
+        readonly hoursAgo: "{n} 小时前";
+        readonly daysAgo: "{n} 天前";
+        readonly studioTitle: "AI 图像工作台 (Studio)";
+        readonly studioDesc: "工作台模块正在紧锣密鼓开发中。在此你将体验大图精修、变体生成 (Variations)、参数重调并一键将生成结果无缝插回 DSH 正在进行的对话。";
+        readonly studioTip: "💡 提示：目前你可以在“图库”中点击任意图片，在弹窗中进行查看、复制与下载。";
+        readonly compareTitle: "多模型横向对比 (Compare)";
+        readonly compareDesc: "支持单个 Prompt 一键同时调度 Gemini、Seedream、DashScope 及本地 ComfyUI 模型并排生成，直观横评画质与细节。";
+        readonly tasksTitle: "异步任务队列 (Tasks)";
+        readonly tasksDesc: "集中管理后台批量生图、多模型并发生成与本地 ComfyUI 耗时任务。支持状态追踪、失败重试与执行耗时分析。";
+        readonly comingSoonBadge: "即将推出";
+    };
+    readonly en: {
+        readonly tabGallery: "Gallery";
+        readonly tabStudio: "Studio";
+        readonly tabInspiration: "Inspiration";
+        readonly tabFavorites: "Favorites";
+        readonly tabCompare: "Compare";
+        readonly tabTasks: "Tasks";
+        readonly filterAllProviders: "All Providers";
+        readonly filterGoogle: "Google Gemini";
+        readonly filterOpenAI: "OpenAI";
+        readonly filterOpenAICompat: "OpenAI-compatible";
+        readonly filterSeedream: "ByteDance Seedream";
+        readonly filterDashScope: "Aliyun DashScope";
+        readonly filterXAI: "xAI Grok";
+        readonly filterZhipu: "Zhipu GLM";
+        readonly filterComfyUI: "Local ComfyUI";
+        readonly filterImport: "Imported";
+        readonly importImages: "Import images";
+        readonly importAdded: "Imported {count} images";
+        readonly importPartial: "Imported {count}, {fail} failed";
+        readonly importFailed: "Import failed";
+        readonly importPickHint: "Choose images to import (PNG/JPG/WebP/GIF)";
+        readonly filterAllModels: "All Models";
+        readonly filterAllRatios: "All Ratios";
+        readonly searchPlaceholder: "Search prompt, tags…";
+        readonly filterCurrentWorkspace: "Current workspace only";
+        readonly filterCurrentWorkspaceHint: "Only show images belonging to the active workspace";
+        readonly sortNewest: "Newest first";
+        readonly sortOldest: "Oldest first";
+        readonly totalCount: "{count} images total";
+        readonly emptyTitle: "No images generated yet";
+        readonly emptyDesc: "Images generated during conversations will automatically appear here.";
+        readonly favEmptyTitle: "No favorite images yet";
+        readonly favEmptyDesc: "Click the ♡ button on any card in the gallery to collect your favorite images here.";
+        readonly noMatchTitle: "No matching images";
+        readonly noMatchDesc: "Try a different search keyword or adjust filter criteria.";
+        readonly copiedPrompt: "Prompt copied";
+        readonly copiedImage: "Image copied";
+        readonly copyFailed: "Copy failed";
+        readonly favoriteAdded: "Added to favorites";
+        readonly favoriteRemoved: "Removed from favorites";
+        readonly preview: "Full Preview";
+        readonly download: "Download";
+        readonly copyImg: "Copy Image";
+        readonly copyPpt: "Copy Prompt";
+        readonly regenerate: "Regenerate";
+        readonly regenerateTitle: "Regenerate Image";
+        readonly regenerateHint: "Edit prompt if needed. A new image will be generated and added to the gallery.";
+        readonly confirmRegenerate: "Generate";
+        readonly regenerating: "Regenerating…";
+        readonly regenerateSuccess: "New image generated and added to gallery";
+        readonly regenerateSaveFailed: "Image generated, but saving to the gallery failed. Please retry.";
+        readonly regenerateFailed: "Regeneration failed";
+        readonly delete: "Delete from gallery";
+        readonly confirmDelete: "Remove this image from the gallery? If it is a normalized imported original with no other gallery or browser references, the stored original will also be permanently deleted. (Chat history is unaffected.)";
+        readonly deleted: "Deleted from gallery";
+        readonly model: "Model";
+        readonly prompt: "Prompt";
+        readonly close: "Close (Esc)";
+        readonly prevImage: "Previous (←)";
+        readonly nextImage: "Next (→)";
+        readonly manage: "Batch Manage";
+        readonly exitManage: "Done";
+        readonly selectedCount: "{n} selected";
+        readonly selectAll: "Select All";
+        readonly invertSelect: "Invert";
+        readonly clearSelect: "Clear";
+        readonly batchFavorite: "Batch Favorite";
+        readonly batchUnfavorite: "Batch Unfavorite";
+        readonly batchFavoritedToast: "Added {count} images to favorites";
+        readonly batchUnfavoritedToast: "Removed {count} images from favorites";
+        readonly batchFavoriteFailed: "Favorite operation failed, please retry";
+        readonly batchDownload: "Batch Download";
+        readonly batchDownloading: "Packaging ({current}/{total})…";
+        readonly batchDownloadSingleToast: "Downloaded 1 image";
+        readonly batchDownloadZipToast: "Started downloading {count} images (ZIP)";
+        readonly batchDownloadComplete: "Downloaded {count} images (ZIP)";
+        readonly batchDownloadFailed: "Batch download failed, please retry";
+        readonly batchDownloadLimit: "Selection too large: up to 2000 images per export. Please split it.";
+        readonly batchDelete: "Batch Delete";
+        readonly batchDeleteTitle: "Delete {count} selected images?";
+        readonly batchDeleteTitleSingle: "Delete this image from gallery?";
+        readonly batchDeleteDesc: "These images will be removed from gallery history; normalized imported originals will also be permanently deleted when no other references remain.";
+        readonly deleteWorkspaceFilesOpt: "Also delete files from workspace disk (cannot be undone)";
+        readonly cancel: "Cancel";
+        readonly confirmBatchDelete: "Delete ({count})";
+        readonly confirmDeleteSingle: "Delete";
+        readonly batchDeletedToast: "Deleted {count} images";
+        readonly storageTitle: "Storage usage";
+        readonly storageScanning: "Scanning…";
+        readonly storageAttachments: "Attachment objects";
+        readonly storageThumbs: "Thumbnail cache (local fallback)";
+        readonly storageRequestCache: "Request-image cache";
+        readonly storageOrphans: "Gallery-unreferenced attachments";
+        readonly storageItems: "{n} files";
+        readonly storageOrphanHint: "Counts objects not referenced by this gallery; other sessions, the canvas, or uploads may still use them. The exported list is not a safe-deletion list.";
+        readonly storageThumbsHint: "The local fallback stays empty while server thumbnails work; 320px thumbnails count as request-image cache.";
+        readonly storageExport: "Export orphan list";
+        readonly storageScanFailed: "Storage scan failed";
+        readonly storageClose: "Close";
+        readonly batchDeletedWithFilesToast: "Deleted {count} images and cleaned {files} workspace files";
+        readonly deleteFailedFileLocked: "Deleted {count} images, but {files} files could not be deleted (busy/locked)";
+        readonly deleteFailedDatabase: "Failed to delete: local database error";
+        readonly justNow: "Just now";
+        readonly minutesAgo: "{n}m ago";
+        readonly hoursAgo: "{n}h ago";
+        readonly daysAgo: "{n}d ago";
+        readonly studioTitle: "AI Image Studio";
+        readonly studioDesc: "Studio workbench is under active development. Fine-tune prompts, generate variations (2x/4x), and inject images directly into DSH chat.";
+        readonly studioTip: "💡 Tip: You can currently click any image in the Gallery to preview, copy, or download it.";
+        readonly compareTitle: "Model Comparison (Compare)";
+        readonly compareDesc: "Side-by-side multi-model benchmarking coming soon. Test Gemini, Seedream, DashScope, and ComfyUI with a single prompt.";
+        readonly tasksTitle: "Task Queue (Tasks)";
+        readonly tasksDesc: "Centralized view for batch generation, asynchronous ComfyUI runs, live progress tracking, and retry controls.";
+        readonly comingSoonBadge: "Coming Soon";
+    };
+};
+export type DictKey = keyof typeof DICT.zh;

package/lib/types/client/gallery-media.d.ts

@@ -0,0 +1,46 @@
+import type { GalleryItem } from './gallery-store.js';
+/** Hover prefetch stops pulling raw originals above this size; drag-out then uses the attachment. */
+export declare const GALLERY_PREFETCH_ORIGINAL_MAX_BYTES: number;
+/** Stable per-browser-profile identity; the vault registry unions all profiles. */
+export declare function vaultProfileId(): string | undefined;
+/** Sync this profile's references; the server never deletes originals here. */
+export declare function syncVaultRefs(keys: string[]): Promise<void>;
+/** Manual gallery deletion: remove originals only after the server checks every profile. */
+export declare function deleteVaultOriginals(deleteKeys: string[], remainingKeys: string[]): void;
+export declare function vaultKeysOf(items: readonly GalleryItem[]): string[];
+/** Full bytes for copy/download/drag: raw vault first, normalized attachment fallback. */
+export declare function fetchGalleryItemBlob(item: GalleryItem): Promise<Blob>;
+export interface GalleryStorageStats {
+    attachments: {
+        count: number;
+        bytes: number;
+    };
+    requestImages: {
+        count: number;
+        bytes: number;
+    };
+    thumbs: {
+        count: number;
+        bytes: number;
+    };
+    orphans: {
+        count: number;
+        bytes: number;
+        ids: string[];
+    };
+    scannedAt: number;
+}
+export declare function formatStorageBytes(bytes: number): string;
+/** Desktop pickers can omit `File.type` for UNC/temp paths; fall back to the extension. */
+export declare function imageMediaTypeOf(file: File): string | undefined;
+/** Probe once whether this host can stream ZIP exports (older hosts 404 the route). */
+export declare function canUseServerZip(): Promise<boolean>;
+export declare function extensionFor(mediaType: string): string;
+/** Download names must follow the resolved bytes, including vault fallbacks. */
+export declare function galleryDownloadName(item: GalleryItem, blob: Blob): string;
+/**
+ * Ask the host to stream the archive through a hidden form post.
+ * A real form navigation would replace the SPA, so the response lands in an
+ * off-screen iframe and the browser download manager owns the transfer.
+ */
+export declare function postZipDownload(items: GalleryItem[], token: string): void;

package/lib/types/client/gallery-merge.d.ts

@@ -0,0 +1,15 @@
+import type { GalleryItem } from './gallery-store.js';
+/** Content addressing makes these five fields the complete attachment identity. */
+export declare function sameAttachment(a: GalleryItem['attachment'], b: GalleryItem['attachment']): boolean;
+/**
+ * Field-by-field comparison for one gallery record. Keep this list in sync with
+ * GalleryItem: a field added there but missing here would silently keep the old
+ * object and show stale data after a reload.
+ */
+export declare function sameGalleryItem(a: GalleryItem, b: GalleryItem): boolean;
+/**
+ * Reuse the previous object for every unchanged record so memoized cards keep
+ * their identity after a full-table reload; only changed records get new
+ * objects. The order always follows the incoming list.
+ */
+export declare function mergeGalleryItems(prev: readonly GalleryItem[], next: readonly GalleryItem[]): GalleryItem[];

package/lib/types/client/gallery-store.d.ts

@@ -3,8 +3,9 @@
  * Stores lightweight metadata indexes; image binaries remain managed by DSH Attachment service.
  * Supports tombstones to ensure deleted items are never resurrected when revisiting conversations.
  */
-import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { ImageAttachmentRef, ImageMediaType } from '@deepseek-ai/dsh-attachment';
 import type { ImageProvider, StudioWatermark } from '../shared.js';
+export { GALLERY_THUMB_MAX_AGE_MS, GALLERY_THUMB_MAX_BYTES, GALLERY_THUMB_WIDTH, galleryThumbKey, getGalleryThumb, getGalleryThumbStats, pruneGalleryThumbs, putGalleryThumb, } from './gallery-thumbs.js';
 export interface GalleryItem {
     id: string;
     attachment: ImageAttachmentRef;
@@ -36,6 +37,12 @@ export interface GalleryItem {
     sessionId?: string | undefined;
     /** Attachment ids of the source images this image was edited from; used by the canvas to rebuild edit chains. Optional so records written by older versions stay readable. */
     sourceAttachmentIds?: string[] | undefined;
+    /** Raw pre-normalization bytes, present only when the attachment layer changed the import. */
+    original?: {
+        key: string;
+        bytes: number;
+        mediaType: ImageMediaType;
+    } | undefined;
 }
 /** A user-created folder grouping favorite prompts. */
 export interface FavoriteFolder {
@@ -53,6 +60,13 @@ export interface FavoritePrompt {
     /** Owning folder id; absent entries are unfiled and appear under "all". */
     folderId?: string;
 }
+/** Age at which timestamp metadata can be compacted; deleted IDs never expire. */
+export declare const TOMBSTONE_TTL_MS: number;
+/**
+ * Compact old tombstones to permanent IDs. Removing an ID would let an old
+ * conversation silently reinsert a deleted image. No IDs are removed.
+ */
+export declare function pruneTombstones(maxAgeMs?: number): Promise<number>;
 type GalleryListener = () => void;
 /**
  * Subscribe to gallery mutations (insert/delete/clear).
@@ -72,6 +86,12 @@ export declare function saveGalleryItem(item: Omit<GalleryItem, 'createdAt'> & {
  * Retrieve all gallery records sorted by createdAt descending.
  */
 export declare function getGalleryItems(): Promise<GalleryItem[]>;
+/**
+ * Like getGalleryItems, but rejects when IndexedDB is unavailable. Maintenance
+ * callers must not treat a read failure as an empty gallery (that would make
+ * vault gc delete every original).
+ */
+export declare function getGalleryItemsStrict(): Promise<GalleryItem[]>;
 /**
  * Toggle favorite status of a gallery item.
  * Returns the new favorite status (true if favorited, false if unfavorited).
@@ -128,4 +148,3 @@ export declare function deleteFavoriteFolder(id: string): Promise<void>;
 export declare function moveFavoritePrompt(id: string, folderId: string | undefined): Promise<boolean>;
 /** Rewrite a favorite prompt's text in place, keeping its id stable. */
 export declare function updateFavoritePrompt(id: string, text: string): Promise<boolean>;
-export {};

package/lib/types/client/gallery-thumbs.d.ts

@@ -0,0 +1,24 @@
+/** Disposable IndexedDB cache for grid thumbnails. */
+export declare const GALLERY_THUMB_MAX_BYTES: number;
+export declare const GALLERY_THUMB_MAX_AGE_MS: number;
+export declare const GALLERY_THUMB_WIDTH = 320;
+/** Cache key for one attachment thumbnail. */
+export declare function galleryThumbKey(attachmentId: string, width?: number): string;
+/** Read a cached thumbnail; resolves undefined when it was never generated. */
+export declare function getGalleryThumb(key: string): Promise<Blob | undefined>;
+/** Persist a generated thumbnail. Failures are non-fatal: the grid falls back to the original. */
+export declare function putGalleryThumb(key: string, blob: Blob): Promise<void>;
+/** Aggregate size of the disposable thumbnail cache (storage panel). */
+export declare function getGalleryThumbStats(): Promise<{
+    count: number;
+    bytes: number;
+}>;
+/** Drop cached thumbnails for deleted records. Best-effort: the cache is disposable. */
+export declare function deleteGalleryThumbs(ids: string[]): Promise<void>;
+/**
+ * Drop cached thumbnails whose attachment is no longer in the gallery.
+ * Returns how many entries were removed.
+ */
+export declare function pruneGalleryThumbs(validAttachmentIds: Iterable<string>, maxBytes?: number, maxAgeMs?: number): Promise<number>;
+/** Drop every cached thumbnail (used when the gallery is cleared). */
+export declare function clearGalleryThumbs(): Promise<void>;