@jacktea/img-viewer 0.1.3

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @jacktea/img-viewer - 图片预览组件
+ *
+ * 支持多种预览模式，本地/远程文件加载，格式自动转换
+ */
+export { ImgViewerElement } from './img-viewer';
+export { configureNativeWasm, getNativeWasmOptions, resetNativeWasmOptions, type NativeWasmCodec, type NativeWasmOptions, } from './core/native-wasm-codecs';
+export type { ImageSource, ViewMode, ViewerConfig, TransformState, MagnifierConfig, LoadedImage, LoadingState, ViewerEventMap, ToolbarConfig, ToolbarItem, ToolbarPosition, ToolbarMode, DecoderType, DecoderConfig, } from './types';
+export { DEFAULT_CONFIG, DEFAULT_TRANSFORM, NATIVE_IMAGE_TYPES } from './types';
+export type { ThemeName } from './types';
+export type { I18nMessages, LocaleName } from './i18n';
+export { getMessages, registerLocale } from './i18n';
+import { ImgViewerElement } from './img-viewer';
+/**
+ * 手动注册自定义元素（使用自定义标签名）
+ */
+export declare function defineImgViewer(tagName?: string): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'img-viewer': ImgViewerElement;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGhF,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMhD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAqB,GAAG,IAAI,CAIpE;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,gBAAgB,CAAC;KAChC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,153 @@
+/**
+ * @jacktea/img-viewer - 图片预览组件类型定义
+ */
+import type { LocaleName } from './i18n';
+/** 主题名 */
+export type ThemeName = 'dark' | 'light' | 'auto';
+/** 图片来源 */
+export interface ImageSource {
+    /** 来源类型 */
+    type: 'file' | 'url' | 'base64';
+    /**
+     * 数据：
+     * - file: File 对象
+     * - url: 图片 URL 字符串
+     * - base64: base64 编码字符串
+     */
+    data: File | string;
+    /** 可选的文件名 */
+    name?: string;
+    /** 可选的 MIME 类型 */
+    mimeType?: string;
+}
+/** 预览模式 */
+export type ViewMode = 'single' | 'carousel' | 'slideshow' | 'gallery';
+/** 原生 wasm 解码模式 */
+export type DecoderType = 'auto' | 'rgba8' | 'rgba16';
+/** 解码配置 */
+export interface DecoderConfig {
+    /**
+     * 解码模式：
+     * - auto: 使用 rgba8 解码
+     * - rgba8: 强制 8-bit 解码
+     * - rgba16: 优先 16-bit 解码
+     */
+    type: DecoderType;
+    /**
+     * 当 type='rgba16' 且 16-bit 解码失败时，是否回退到 rgba8。
+     * 默认 true。
+     */
+    fallbackToRgba8: boolean;
+}
+/** 变换状态 */
+export interface TransformState {
+    /** 旋转角度 (0, 90, 180, 270) */
+    rotation: number;
+    /** 水平翻转 */
+    flipX: boolean;
+    /** 垂直翻转 */
+    flipY: boolean;
+    /** 缩放比例 */
+    scale: number;
+    /** X 轴偏移 */
+    offsetX: number;
+    /** Y 轴偏移 */
+    offsetY: number;
+}
+/** 放大镜配置 */
+export interface MagnifierConfig {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 放大倍率，默认 2 */
+    zoom: number;
+    /** 镜片半径(px)，默认 80 */
+    radius: number;
+}
+/** 工具栏按钮项 */
+export type ToolbarItem = 'rotateLeft' | 'rotateRight' | 'flipX' | 'flipY' | 'zoomIn' | 'zoomOut' | 'reset' | 'prev' | 'next' | 'fullscreen' | 'download' | 'magnifier' | 'info' | 'mode';
+/** 工具栏位置 */
+export type ToolbarPosition = 'top' | 'bottom';
+/** 工具栏显示模式 */
+export type ToolbarMode = 'fixed' | 'float';
+/** 工具栏配置 */
+export interface ToolbarConfig {
+    items: ToolbarItem[];
+    /** 工具栏位置，默认 'bottom' */
+    position?: ToolbarPosition;
+    /** 工具栏显示模式，默认 'fixed' */
+    mode?: ToolbarMode;
+}
+/** 查看器配置 */
+export interface ViewerConfig {
+    /** 预览模式，默认 'single' */
+    mode: ViewMode;
+    /** 只读模式（禁止复制、下载），默认 false */
+    readonly: boolean;
+    /** 放大镜配置 */
+    magnifier: MagnifierConfig;
+    /** 幻灯片/轮播自动播放，默认 false */
+    autoPlay: boolean;
+    /** 自动播放间隔(ms)，默认 3000 */
+    interval: number;
+    /** 是否显示工具栏，默认 true */
+    showToolbar: boolean;
+    /** 工具栏配置 */
+    toolbar: ToolbarConfig;
+    /** 是否启用渐进式加载，默认 true */
+    progressiveLoading: boolean;
+    /** 渐进式加载阈值(字节)，默认 1MB */
+    progressiveThreshold: number;
+    /** 主题，默认 'dark' */
+    theme: ThemeName;
+    /** 语言，默认 'zh-CN' */
+    locale: LocaleName | string;
+    /** 解码配置 */
+    decoder: DecoderConfig;
+}
+/** 图片加载状态 */
+export type LoadingState = 'idle' | 'loading' | 'loaded' | 'error';
+/** 内部使用 - 已加载的图片 */
+export interface LoadedImage {
+    /** 原始来源 */
+    source: ImageSource;
+    /** 可显示的 blob URL */
+    blobUrl: string;
+    /** 图片宽度 */
+    width: number;
+    /** 图片高度 */
+    height: number;
+    /** 文件大小(字节) */
+    size: number;
+    /** 文件名 */
+    name: string;
+    /** 是否经过格式转换 */
+    converted: boolean;
+}
+/** 查看器事件 */
+export interface ViewerEventMap {
+    'image-load': CustomEvent<{
+        index: number;
+        image: LoadedImage;
+    }>;
+    'image-error': CustomEvent<{
+        index: number;
+        error: Error;
+    }>;
+    'image-change': CustomEvent<{
+        index: number;
+        image: LoadedImage;
+    }>;
+    'mode-change': CustomEvent<{
+        mode: ViewMode;
+    }>;
+    'transform-change': CustomEvent<{
+        transform: TransformState;
+    }>;
+}
+/** 默认配置 */
+export declare const DEFAULT_CONFIG: ViewerConfig;
+/** 默认变换状态 */
+export declare const DEFAULT_TRANSFORM: TransformState;
+/** 浏览器原生支持的图片 MIME 类型 */
+export declare const NATIVE_IMAGE_TYPES: Set<string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@jacktea/img-viewer",
+  "version": "0.1.3",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/img-viewer.umd.cjs",
+  "module": "dist/img-viewer.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/img-viewer.js",
+      "require": "./dist/img-viewer.umd.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "third_party/licenses"
+  ],
+  "dependencies": {
+    "@webtoon/psd": "^0.4.0"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && tsc --emitDeclarationOnly --outDir dist"
+  }
+}