@jacktea/img-viewer 0.1.3

package/LICENSE

@@ -0,0 +1,25 @@
+This license applies to original source code in this repository, excluding
+third-party components and generated codec binaries listed in
+`THIRD_PARTY_NOTICES.md`.
+
+MIT License
+
+Copyright (c) 2026 zhuzhigang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @jacktea/img-viewer
+
+一款由于 Vue/React 等框架解耦的、无依赖的纯前端图片在线预览器，支持诸如缩放、平移等功能。
+
+## 安装
+
+```bash
+npm install @jacktea/img-viewer
+# 或者
+pnpm add @jacktea/img-viewer
+# 或者
+yarn add @jacktea/img-viewer
+```
+
+## 使用
+
+这是一个基于 Web Components 构建的原生组件，你可以直接在 HTML 当中使用它。
+
+首先，引入脚本和样式：
+
+```html
+<script type="module">
+  import '@jacktea/img-viewer';
+</script>
+<link rel="stylesheet" href="node_modules/@jacktea/img-viewer/dist/style.css">
+```
+
+然后在你的页面中使用 `img-viewer` 组件：
+
+```html
+<img-viewer src="path/to/your/image.jpg" width="800px" height="600px"></img-viewer>
+```
+
+### 属性 (Attributes)
+
+*   `src`: 图片的 URL，支持普通图片，也支持某些特殊格式如并行的 PSD 解析（需要引入对应解析库）。
+*   `width`: 预览器容器的宽度。
+*   `height`: 预览器容器的高度。
+
+## 许可证
+
+MIT

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,44 @@
+## Third-Party License Notice
+
+This repository includes and distributes WebAssembly codec artifacts built from
+third-party libraries. Those components are not covered by the MIT license in
+`LICENSE`.
+
+### Bundled codec components
+
+| Component | Version | Used for | Upstream license |
+| --- | --- | --- | --- |
+| libheif | 1.18.2 | HEIF decode (`packages/core/src/wasm/libheif/*`) | LGPL-3.0-or-later |
+| libde265 | 1.0.15 | HEVC decode backend for libheif | LGPL-3.0-or-later |
+| LibRaw | 0.21.3 | RAW decode (`packages/core/src/wasm/libraw/*`) | Dual: LGPL-2.1 or CDDL-1.0 |
+| libtiff | 4.6.0 | TIFF decode (`packages/core/src/wasm/libtiff/*`) | libtiff license (permissive) |
+| zlib | 1.3.1 | Compression dependency for libtiff build | zlib license |
+
+Version sources:
+- `wasm/docker/toolchains/versions.env`
+- `wasm/docker/scripts/build-libheif.sh`
+- `wasm/docker/scripts/build-libraw.sh`
+- `wasm/docker/scripts/build-libtiff.sh`
+
+### Included license texts
+
+- `third_party/licenses/libheif-LGPL-3.0-or-later.txt`
+- `third_party/licenses/libde265-LGPL-3.0-or-later.txt`
+- `third_party/licenses/libraw-LGPL-2.1.txt`
+- `third_party/licenses/libraw-CDDL-1.0.txt`
+- `third_party/licenses/libtiff-license.txt`
+- `third_party/licenses/zlib-license.txt`
+
+### Distribution compliance notes
+
+- Keep this notice file and the above license texts in redistributions.
+- Keep original copyright and license notices for bundled codec outputs.
+- For LGPL-covered components (libheif/libde265, and LibRaw if you choose the
+  LGPL option), provide corresponding source and build instructions for the
+  shipped binaries and preserve users' rights granted by LGPL.
+- This project already contains build scripts and wrappers under `wasm/docker/`
+  to help satisfy source-availability obligations.
+
+If you ship binaries to end users, review your exact distribution model
+(including static/dynamic linking behavior and packaging) for LGPL/CDDL
+compliance.

package/dist/components/file-info.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 文件信息面板 - 显示图片基础信息和 EXIF 元数据
+ */
+import { LoadedImage } from '../types';
+import { I18nMessages } from '../i18n';
+/** EXIF 数据 */
+export interface ExifData {
+    cameraMake?: string;
+    cameraModel?: string;
+    dateTime?: string;
+    exposureTime?: string;
+    fNumber?: string;
+    iso?: string;
+    focalLength?: string;
+    gps?: string;
+}
+export declare class FileInfoPanel {
+    private container;
+    private overlay;
+    private messages;
+    constructor(container: HTMLElement, messages: I18nMessages);
+    updateMessages(messages: I18nMessages): void;
+    show(image: LoadedImage): Promise<void>;
+    hide(): void;
+    private createRow;
+    destroy(): void;
+}
+//# sourceMappingURL=file-info.d.ts.map

package/dist/components/file-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.d.ts","sourceRoot":"","sources":["../../src/components/file-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,cAAc;AACd,MAAM,WAAW,QAAQ;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAe;gBAEnB,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY;IAK1D,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAItC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8F7C,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,SAAS;IAUjB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/components/magnifier.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 放大镜组件 - 跟随鼠标的圆形放大区域
+ */
+export declare class Magnifier {
+    private container;
+    private lens;
+    private canvas;
+    private ctx;
+    private image;
+    private zoom;
+    private radius;
+    private enabled;
+    private boundMouseMove;
+    private boundMouseLeave;
+    constructor(container: HTMLElement, options?: {
+        zoom?: number;
+        radius?: number;
+        enabled?: boolean;
+    });
+    setImage(image: HTMLImageElement): void;
+    enable(): void;
+    disable(): void;
+    toggle(): void;
+    setZoom(zoom: number): void;
+    setRadius(radius: number): void;
+    private onMouseMove;
+    private onMouseLeave;
+    private drawMagnified;
+    destroy(): void;
+}
+//# sourceMappingURL=magnifier.d.ts.map

package/dist/components/magnifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magnifier.d.ts","sourceRoot":"","sources":["../../src/components/magnifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,eAAe,CAAa;gBAGlC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;IA+BrE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAKvC,MAAM,IAAI,IAAI;IAQd,OAAO,IAAI,IAAI;IAWf,MAAM,IAAI,IAAI;IAQd,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;IAyCrB,OAAO,IAAI,IAAI;CAIhB"}

package/dist/components/toolbar.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 工具栏组件 - SVG 图标按钮
+ */
+import { ViewMode, ToolbarConfig } from '../types';
+import { I18nMessages } from '../i18n';
+/** 工具栏事件 */
+export interface ToolbarEvents {
+    onRotateLeft: () => void;
+    onRotateRight: () => void;
+    onFlipX: () => void;
+    onFlipY: () => void;
+    onZoomIn: () => void;
+    onZoomOut: () => void;
+    onResetZoom: () => void;
+    onToggleMagnifier: (enabled: boolean) => void;
+    onModeChange: (mode: ViewMode) => void;
+    onFullscreen: () => void;
+    onDownload: () => void;
+    onPrev: () => void;
+    onNext: () => void;
+    onInfo: () => void;
+}
+export declare class Toolbar {
+    private element;
+    private events;
+    private isReadonly;
+    private hasMultiple;
+    private currentMode;
+    private magnifierEnabled;
+    private config;
+    private messages;
+    constructor(container: HTMLElement, events: Partial<ToolbarEvents>, options?: {
+        readonly?: boolean;
+        hasMultiple?: boolean;
+        currentMode?: ViewMode;
+        magnifierEnabled?: boolean;
+        toolbar?: ToolbarConfig;
+        messages?: I18nMessages;
+    });
+    private applyToolbarClasses;
+    private render;
+    private filterItems;
+    private renderItem;
+    /** 浮动模式：单按钮循环切换模式 */
+    private renderCyclicModeButton;
+    private renderModeButtons;
+    private createGroup;
+    private addButton;
+    private updateModeButtons;
+    update(options: {
+        readonly?: boolean;
+        hasMultiple?: boolean;
+        currentMode?: ViewMode;
+        magnifierEnabled?: boolean;
+        toolbar?: ToolbarConfig;
+        messages?: I18nMessages;
+    }): void;
+    destroy(): void;
+}
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/components/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/components/toolbar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAA6D,MAAM,UAAU,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAuBD,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAe;gBAG7B,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,EAC9B,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,QAAQ,CAAC;QACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;KACpB;IA4BR,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,MAAM;IA2Bd,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,UAAU;IA4DlB,qBAAqB;IACrB,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,iBAAiB;IAOzB,MAAM,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,QAAQ,CAAC;QACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;KACzB,GAAG,IAAI;IAWR,OAAO,IAAI,IAAI;CAGhB"}

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

@@ -0,0 +1,43 @@
+/**
+ * 轮播图模式 - 水平滑动切换，带指示器
+ *
+ * 首尾衔接采用"克隆哨兵"方案：
+ * Track 布局:
+ *   [clone-last] [real-0] [real-1] ... [real-n-1] [clone-first]
+ *   trackPos: 0      1        2    ...     n          n+1
+ */
+import { LoadedImage } from '../types';
+export declare class ViewerCarousel {
+    private container;
+    private track;
+    private indicators;
+    private images;
+    /** 当前逻辑索引（0-based，对应真实图片） */
+    private currentIndex;
+    /** 当前 track 中的位置（含哨兵偏移，1-based 为第一张真实图） */
+    private trackPos;
+    private autoPlayTimer;
+    private onChange?;
+    constructor(container: HTMLElement, onChange?: (index: number) => void);
+    setImages(images: LoadedImage[]): void;
+    goTo(index: number): void;
+    prev(): void;
+    next(): void;
+    startAutoPlay(interval?: number): void;
+    stopAutoPlay(): void;
+    getCurrentIndex(): number;
+    /**
+     * 如果当前停在哨兵位，立即（无动画）跳转到真实位置。
+     * 这样快速点击时，新的动画从正确的位置开始。
+     */
+    private snapIfNeeded;
+    private renderSlides;
+    private createSlide;
+    private renderIndicators;
+    private moveTo;
+    private onTransitionEnd;
+    private updateIndicators;
+    private bindSwipe;
+    destroy(): void;
+}
+//# sourceMappingURL=viewer-carousel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-carousel.d.ts","sourceRoot":"","sources":["../../src/components/viewer-carousel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,6BAA6B;IAC7B,OAAO,CAAC,YAAY,CAAa;IACjC,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,QAAQ,CAAC,CAA0B;gBAE/B,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAoCtE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAStC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASzB,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IASZ,aAAa,CAAC,QAAQ,GAAE,MAAa,GAAG,IAAI;IAK5C,YAAY,IAAI,IAAI;IAOpB,eAAe,IAAI,MAAM;IAMzB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,SAAS;IAoBjB,OAAO,IAAI,IAAI;CAIhB"}

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

@@ -0,0 +1,27 @@
+/**
+ * 相册模式 - 缩略图网格 + 大图查看
+ */
+import { LoadedImage } from '../types';
+export declare class ViewerGallery {
+    private container;
+    private grid;
+    private lightbox;
+    private lightboxImg;
+    private lightboxCounter;
+    private images;
+    private currentIndex;
+    private isLightboxOpen;
+    private onChange?;
+    constructor(container: HTMLElement, onChange?: (index: number) => void);
+    setImages(images: LoadedImage[]): void;
+    getCurrentIndex(): number;
+    private renderGrid;
+    private openLightbox;
+    private closeLightbox;
+    private updateLightbox;
+    private lightboxPrev;
+    private lightboxNext;
+    private bindLightboxEvents;
+    destroy(): void;
+}
+//# sourceMappingURL=viewer-gallery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-gallery.d.ts","sourceRoot":"","sources":["../../src/components/viewer-gallery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAA0B;gBAE/B,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAoCtE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAKtC,eAAe,IAAI,MAAM;IAIzB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,IAAI,IAAI;CAIhB"}

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

@@ -0,0 +1,36 @@
+/**
+ * 单图查看器 - 显示单张图片，支持拖拽平移和滚轮缩放
+ */
+import { LoadedImage } from '../types';
+import { TransformManager } from '../core/transform';
+import { Magnifier } from './magnifier';
+export declare class ViewerSingle {
+    private container;
+    private wrapper;
+    private imgElement;
+    private transform;
+    private magnifier;
+    private currentImage;
+    private isDragging;
+    private dragStartX;
+    private dragStartY;
+    private lastOffsetX;
+    private lastOffsetY;
+    constructor(container: HTMLElement, magnifierOptions?: {
+        zoom?: number;
+        radius?: number;
+        enabled?: boolean;
+    });
+    /**
+     * 显示图片
+     */
+    show(image: LoadedImage): void;
+    getTransform(): TransformManager;
+    getMagnifier(): Magnifier;
+    getImageElement(): HTMLImageElement;
+    private applyTransform;
+    private bindEvents;
+    private getTouchDistance;
+    destroy(): void;
+}
+//# sourceMappingURL=viewer-single.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-single.d.ts","sourceRoot":"","sources":["../../src/components/viewer-single.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAA4B;IAGhD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;gBAGtB,SAAS,EAAE,WAAW,EACtB,gBAAgB,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IA4B1E;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAS9B,YAAY,IAAI,gBAAgB;IAIhC,YAAY,IAAI,SAAS;IAIzB,eAAe,IAAI,gBAAgB;IAInC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,UAAU;IAyGlB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,IAAI,IAAI;CAKhB"}

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

@@ -0,0 +1,28 @@
+/**
+ * 幻灯片模式 - 全屏淡入淡出展示
+ */
+import { LoadedImage } from '../types';
+export declare class ViewerSlideshow {
+    private container;
+    private viewport;
+    private counter;
+    private images;
+    private currentIndex;
+    private autoPlayTimer;
+    private slides;
+    private onChange?;
+    constructor(container: HTMLElement, onChange?: (index: number) => void);
+    setImages(images: LoadedImage[]): void;
+    goTo(index: number): void;
+    prev(): void;
+    next(): void;
+    startAutoPlay(interval?: number): void;
+    stopAutoPlay(): void;
+    getCurrentIndex(): number;
+    private renderSlides;
+    private updateCounter;
+    private bindKeyboard;
+    private bindClick;
+    destroy(): void;
+}
+//# sourceMappingURL=viewer-slideshow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-slideshow.d.ts","sourceRoot":"","sources":["../../src/components/viewer-slideshow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,CAA0B;gBAE/B,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAuBtE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAOtC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAoBzB,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,aAAa,CAAC,QAAQ,GAAE,MAAa,GAAG,IAAI;IAK5C,YAAY,IAAI,IAAI;IAOpB,eAAe,IAAI,MAAM;IAIzB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,SAAS;IASjB,OAAO,IAAI,IAAI;CAIhB"}

package/dist/core/format-converter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 格式转换器 - 按需转换不支持的图片格式（native wasm only）
+ * HEIF/TIFF/RAW: 自编译 wasm
+ */
+import { type NativeDecodeMode } from './native-wasm-codecs';
+export interface ConverterDecodeConfig {
+    mode: NativeDecodeMode;
+    fallbackToRgba8: boolean;
+}
+export declare class FormatConverter {
+    private decodeConfig;
+    constructor(config?: Partial<ConverterDecodeConfig>);
+    setDecodeConfig(config: Partial<ConverterDecodeConfig>): void;
+    getDecodeConfig(): ConverterDecodeConfig;
+    /**
+     * 将不支持的格式转为可显示的 WebP
+     */
+    convertToDisplayable(blob: Blob, mimeType: string): Promise<Blob>;
+    private isHeifMime;
+    private isRawMime;
+    private isTiffMime;
+    private isPsdMime;
+    private convertNativeToBlob;
+    private rgbaToWebpBlob;
+    private imageDataToWebpBlob;
+    private convertPsdToBlob;
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=format-converter.d.ts.map

package/dist/core/format-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-converter.d.ts","sourceRoot":"","sources":["../../src/core/format-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AA6B9B,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAOD,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAwB;gBAEhC,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAOvD,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAO7D,eAAe,IAAI,qBAAqB;IAIxC;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;YAQH,mBAAmB;YAoBnB,cAAc;IAU5B,OAAO,CAAC,mBAAmB;YAsBb,gBAAgB;IAmBxB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/core/image-loader.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 图片加载器 - 支持本地文件和远程 URL
+ */
+import { ImageSource, LoadedImage, type DecoderConfig } from '../types';
+export declare class ImageLoader {
+    private converter;
+    constructor(decoderConfig?: Partial<DecoderConfig>);
+    setDecoderConfig(config: Partial<DecoderConfig>): void;
+    /**
+     * 加载图片
+     */
+    load(source: ImageSource): Promise<LoadedImage>;
+    /**
+     * 批量加载图片
+     */
+    loadAll(sources: ImageSource[], onProgress?: (loaded: number, total: number) => void): Promise<LoadedImage[]>;
+    /**
+     * 释放已加载图片的资源
+     */
+    release(image: LoadedImage): void;
+    /**
+     * 检查 MIME 类型是否原生支持
+     */
+    private isNativelySupported;
+    /**
+     * 从 URL 提取文件名
+     */
+    private getFileNameFromUrl;
+    /**
+     * 根据文件名推测 MIME 类型
+     */
+    private guessMimeType;
+    /**
+     * base64 转 Blob
+     */
+    private base64ToBlob;
+    /**
+     * 获取图片尺寸
+     */
+    private getImageDimensions;
+}
+//# sourceMappingURL=image-loader.d.ts.map

package/dist/core/image-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-loader.d.ts","sourceRoot":"","sources":["../../src/core/image-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAsB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAG5F,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAkB;gBAEvB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAOlD,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAOtD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA4DrD;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACnD,OAAO,CAAC,WAAW,EAAE,CAAC;IAczB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/core/native-wasm-codecs.d.ts

@@ -0,0 +1,25 @@
+export type NativeWasmCodec = 'heif' | 'tiff' | 'raw';
+export type NativeDecodeMode = 'auto' | 'rgba8' | 'rgba16';
+export interface NativeWasmOptions {
+    enabled: boolean;
+    preferNative: boolean;
+    baseUrl: string;
+    codecs: NativeWasmCodec[];
+}
+export interface NativeDecodeRequest {
+    mode?: NativeDecodeMode;
+    fallbackToRgba8?: boolean;
+}
+export interface NativeDecodeResult {
+    width: number;
+    height: number;
+    rgba: Uint8ClampedArray;
+    backend: string;
+    decodeMode: Exclude<NativeDecodeMode, 'auto'>;
+    bitDepth: number;
+}
+export declare function configureNativeWasm(options: Partial<NativeWasmOptions>): void;
+export declare function resetNativeWasmOptions(): void;
+export declare function getNativeWasmOptions(): NativeWasmOptions;
+export declare function decodeWithNativeWasm(codec: NativeWasmCodec, blob: Blob, request?: NativeDecodeRequest): Promise<NativeDecodeResult | null>;
+//# sourceMappingURL=native-wasm-codecs.d.ts.map

package/dist/core/native-wasm-codecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-wasm-codecs.d.ts","sourceRoot":"","sources":["../../src/core/native-wasm-codecs.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IAEtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqFD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAO7E;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AA4UD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiCpC"}

package/dist/core/progressive-loader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 渐进式加载 - 大图先显示模糊缩略图，然后逐步加载清晰版本
+ */
+export declare class ProgressiveLoader {
+    private threshold;
+    constructor(threshold?: number);
+    /**
+     * 判断图片是否需要渐进式加载
+     */
+    needsProgressiveLoading(size: number): boolean;
+    /**
+     * 创建模糊缩略图
+     */
+    createThumbnail(blobUrl: string, maxSize?: number): Promise<string>;
+    /**
+     * 渐进式加载 URL 图片
+     * 通过 fetch + ReadableStream 实现
+     */
+    loadProgressive(url: string, onProgress?: (loaded: number, total: number) => void): Promise<Blob>;
+    private loadImage;
+}
+//# sourceMappingURL=progressive-loader.d.ts.map

package/dist/core/progressive-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-loader.d.ts","sourceRoot":"","sources":["../../src/core/progressive-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,GAAE,MAAoB;IAI3C;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAW,GACnB,OAAO,CAAC,MAAM,CAAC;IAiBlB;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACnD,OAAO,CAAC,IAAI,CAAC;IAgChB,OAAO,CAAC,SAAS;CAQlB"}

package/dist/core/transform.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 图片变换管理 - 旋转、翻转、缩放
+ */
+import { TransformState } from '../types';
+export declare class TransformManager {
+    private state;
+    private onChange?;
+    constructor(onChange?: (state: TransformState) => void);
+    get current(): TransformState;
+    /**
+     * 旋转（顺时针）
+     */
+    rotateRight(): void;
+    /**
+     * 旋转（逆时针）
+     */
+    rotateLeft(): void;
+    /**
+     * 水平翻转
+     */
+    flipHorizontal(): void;
+    /**
+     * 垂直翻转
+     */
+    flipVertical(): void;
+    /**
+     * 设置缩放
+     */
+    setScale(scale: number): void;
+    /**
+     * 放大
+     */
+    zoomIn(step?: number): void;
+    /**
+     * 缩小
+     */
+    zoomOut(step?: number): void;
+    /**
+     * 设置偏移
+     */
+    setOffset(x: number, y: number): void;
+    /**
+     * 重置所有变换
+     */
+    reset(): void;
+    /**
+     * 生成 CSS transform 字符串
+     */
+    toCSSTransform(): string;
+    private notify;
+}
+//# sourceMappingURL=transform.d.ts.map

package/dist/core/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/core/transform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAqB,MAAM,UAAU,CAAC;AAE7D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAkC;gBAEvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI;IAKtD,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,MAAM,CAAC,IAAI,GAAE,MAAa,GAAG,IAAI;IAIjC;;OAEG;IACH,OAAO,CAAC,IAAI,GAAE,MAAa,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,cAAc,IAAI,MAAM;IAexB,OAAO,CAAC,MAAM;CAGf"}

package/dist/i18n.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 国际化支持
+ */
+/** 翻译消息接口 */
+export interface I18nMessages {
+    rotateLeft: string;
+    rotateRight: string;
+    flipX: string;
+    flipY: string;
+    zoomIn: string;
+    zoomOut: string;
+    reset: string;
+    prev: string;
+    next: string;
+    fullscreen: string;
+    download: string;
+    magnifier: string;
+    info: string;
+    modeSingle: string;
+    modeCarousel: string;
+    modeSlideshow: string;
+    modeGallery: string;
+    loading: string;
+    loadingProgress: string;
+    loadError: string;
+    fileInfo: string;
+    fileName: string;
+    fileSize: string;
+    imageDimensions: string;
+    mimeType: string;
+    metadata: string;
+    cameraMake: string;
+    cameraModel: string;
+    dateTime: string;
+    exposureTime: string;
+    fNumber: string;
+    iso: string;
+    focalLength: string;
+    gps: string;
+    close: string;
+    dropHint: string;
+}
+/** 获取指定 locale 的消息，不存在则回退到 zh-CN */
+export declare function getMessages(locale: string): I18nMessages;
+/** 支持的语言列表 */
+export type LocaleName = 'zh-CN' | 'en';
+/** 注册自定义语言包 */
+export declare function registerLocale(name: string, messages: I18nMessages): void;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,aAAa;AACb,MAAM,WAAW,YAAY;IAE3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IAGb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IAGpB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IAGd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgGD,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAExD;AAED,cAAc;AACd,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;AAExC,eAAe;AACf,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAEzE"}