@jetprint/editor-sdk 1.0.0

package/dist/utils/renderService/workerManager.d.ts

@@ -0,0 +1,33 @@
+import { ISmartObject } from "./types";
+/**
+ * 获取或创建指定 faceId 的 deform worker
+ */
+export declare function getDeformWorker(faceId: number): Worker;
+/**
+ * 规范化 layerData，将 Vue Proxy 对象转换为普通对象
+ */
+export declare function normalizeLayerData(layerData: ISmartObject): ISmartObject;
+/**
+ * 使用 worker 进行变形
+ * @param designBitmap - 设计图
+ * @param layerData - 智能对象数据
+ * @param faceId - 面 ID
+ * @param canvasSize - 画布尺寸（可选，默认使用 layerData.size）
+ */
+export declare function deformWithWorker(designBitmap: ImageBitmap, layerData: ISmartObject, faceId: number, canvasSize?: {
+    width: number;
+    height: number;
+}): Promise<ImageBitmap>;
+/**
+ * 通知所有已创建的 Worker 更新 License
+ */
+export declare function notifyWorkersLicense(config: {
+    licenseToken: string;
+    licenseApiUrl: string;
+    deviceId: string;
+    domain: string;
+}): void;
+/**
+ * 清理所有 deform worker
+ */
+export declare function disposeDeformWorkers(): void;

package/dist/utils/renderedImagesDB.d.ts

@@ -0,0 +1,61 @@
+export type RenderTaskStatus = 'rendering' | 'uploading' | 'done' | 'failed';
+export interface RenderedImage {
+    index: number;
+    blob: Blob;
+    fileName: string;
+}
+/** fabricScreenshotList 中单张截图的 Blob 存储 */
+export interface FabricScreenshotBlob {
+    id: number;
+    name?: string;
+    blob: Blob;
+}
+/** 单个模板的渲染数据（fabricScreenshotList 已提升到 RenderBundle 顶层共享） */
+export interface RenderBundleTemplate {
+    index: number;
+    psdJson: unknown;
+    materialList: Array<{
+        layerName: string;
+        url: string;
+        sourceName?: string;
+    }>;
+    width: number;
+    height: number;
+    baseUrl?: string;
+    /** 当前渲染的目标颜色（如 "Beige"、"Black"），用于过滤 psdJson 中不属于此颜色的图层 */
+    selectedColor?: string;
+    /** 颜色名称，用于图片命名（如 "Black"） */
+    color?: string;
+}
+/** 所有模板的渲染数据包 */
+export interface RenderBundle {
+    taskId: string;
+    designName?: string;
+    /** 所有模板共享的设计截图 Blob（收集一次，避免 N 个模板重复存储） */
+    fabricScreenshotList: FabricScreenshotBlob[];
+    templates: RenderBundleTemplate[];
+}
+export interface RenderTaskRecord {
+    taskId: string;
+    status: RenderTaskStatus;
+    images: RenderedImage[];
+    createdAt: number;
+    uploadedAt?: number;
+    retryCount?: number;
+    error?: string;
+    /** 完整渲染数据包（保存时收集，后台渲染用） */
+    renderBundle?: RenderBundle;
+}
+export declare function putRenderTask(record: RenderTaskRecord): Promise<void>;
+export declare function getRenderTask(taskId: string): Promise<RenderTaskRecord | undefined>;
+export declare function deleteRenderTask(taskId: string): Promise<void>;
+export declare function getAllRenderTasks(): Promise<RenderTaskRecord[]>;
+export declare function getPendingTasks(): Promise<RenderTaskRecord[]>;
+export declare function updateRenderTaskStatus(taskId: string, status: RenderTaskStatus, extra?: Partial<RenderTaskRecord>): Promise<void>;
+/**
+ * 批量查询本地图片，返回 taskId → blob URL 的映射。
+ * 调用方负责在适当时机 revoke 这些 URL。
+ */
+export declare function getLocalImageUrls(taskIds: string[]): Promise<Map<string, string>>;
+export declare function appendRenderedImage(taskId: string, image: RenderedImage): Promise<void>;
+export declare function cleanupOldTasks(maxAgeMs?: number): Promise<void>;

package/dist/utils/storage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 统一的 Storage 工具类
+ * 处理 localStorage 的安全访问和环境检查
+ */
+export declare class StorageUtil {
+    private static hasStorage;
+    /**
+     * 获取存储项
+     */
+    static getItem(key: string): string | null;
+    /**
+     * 设置存储项
+     */
+    static setItem(key: string, value: string): boolean;
+    /**
+     * 移除存储项
+     */
+    static removeItem(key: string): boolean;
+    /**
+     * 清空所有存储项
+     */
+    static clear(): boolean;
+    /**
+     * 检查是否支持 Storage
+     */
+    static isAvailable(): boolean;
+}

package/dist/utils/threeRenderService/index.d.ts

@@ -0,0 +1,6 @@
+import type { IRenderByJson, IRenderByJsonResult } from '../renderService/types';
+export declare function preloadThreeScenesByJson(data: IRenderByJson): Promise<{
+    sceneCount: number;
+    cacheSize: number;
+}>;
+export declare function renderByJsonWithThree(data: IRenderByJson): Promise<IRenderByJsonResult>;

package/dist/utils/url.d.ts

@@ -0,0 +1,39 @@
+/**
+ * URL 工具类
+ */
+export declare class UrlUtil {
+    /**
+     * 安全地解析 URL
+     */
+    static parse(url: string): URL | null;
+    /**
+     * 添加查询参数
+     */
+    static addParam(url: string, key: string, value: string): string;
+    /**
+     * 移除查询参数
+     */
+    static removeParam(url: string, key: string): string;
+    /**
+     * 检查是否有指定参数
+     */
+    static hasParam(url: string, key: string): boolean;
+    /**
+     * 格式化 URL（保持原始格式）
+     */
+    private static formatUrl;
+    /**
+     * 检查是否为数据 URL
+     */
+    static isDataUrl(url: string): boolean;
+    /**
+     * 检查是否为 Blob URL
+     */
+    static isBlobUrl(url: string): boolean;
+}
+/**
+ * 为图片 URL 追加或覆盖 OSS 缩放参数。
+ * - 未传 width（null/undefined）或 width 无效（NaN、≤0）时按原图处理：去掉 x-oss-process（若有）
+ * - 否则：若已有 image/resize 则去掉 ,h_数字、再替换 w_数字；否则追加 x-oss-process=image/resize,w_<width>
+ */
+export declare function appendOssResize(url: string | null | undefined, width?: number | null): string;

package/dist/utils/workerBase.d.ts

@@ -0,0 +1,38 @@
+export interface WorkerMessage<T = any> {
+    id?: number;
+    type?: string;
+    data?: T;
+    error?: string;
+}
+export interface WorkerRequestHandler<TRequest = any, TResponse = any> {
+    resolve: (value: TResponse) => void;
+    reject: (reason?: any) => void;
+}
+/**
+ * Worker 管理基类
+ */
+export declare class WorkerManager<TRequest = any, TResponse = any> {
+    protected workers: Map<string | number, Worker>;
+    protected requests: Map<number, WorkerRequestHandler<TRequest, TResponse>>;
+    protected requestId: number;
+    /**
+     * 创建 Worker
+     */
+    protected createWorker(workerPath: string, isDev: boolean): Worker;
+    /**
+     * 设置 Worker 消息处理
+     */
+    protected setupWorkerHandlers(worker: Worker, onMessage: (data: any) => void): void;
+    /**
+     * 发送消息到 Worker
+     */
+    protected sendMessage(worker: Worker, message: WorkerMessage<TRequest>, transfer?: Transferable[]): Promise<TResponse>;
+    /**
+     * 处理 Worker 响应
+     */
+    protected handleResponse(id: number, data: TResponse, error?: string): void;
+    /**
+     * 清理所有 Workers
+     */
+    dispose(): void;
+}

package/dist/utils/workerLoader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 运行时 Worker 加载工具
+ *
+ * 注意：此模块仅在生产环境（!import.meta.env.DEV）下被使用
+ * 在开发环境下，所有 Worker 都通过 new Worker(new URL(..., import.meta.url)) 创建
+ *
+ * 使用固定文件名 + 版本号参数实现缓存控制，避免复杂的映射管理
+ */
+/**
+ * 获取 Worker 的最终 URL
+ * @param workerPath 源码中的 Worker 相对路径
+ *
+ * 使用固定文件名 + SDK 版本号参数实现缓存控制
+ * - 文件名：将 .ts 替换为 .js（如 renderWorker.ts -> renderWorker.js）
+ * - 版本号：添加 ?v=版本号 实现缓存破坏
+ * - 路径：统一使用 /sdk-workers/ 绝对路径
+ */
+export declare function getWorkerUrl(workerPath: string): string;
+/**
+ * 创建 Worker 实例
+ * @param workerPath 源码中的 Worker 相对路径
+ * @param options Worker 构造参数
+ */
+export declare function createWorker(workerPath: string, options?: WorkerOptions): Worker;

package/dist/wasm/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * WASM 模块导出
+ */
+export { PerspectiveWasm, type PerspectivePoint, type PerspectiveMatrix } from './perspectiveLoader';
+export { PerspectiveWasmWorker } from './perspectiveLoader.worker';

package/dist/wasm/perspectiveLoader.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 透视变换 WASM 模块加载器
+ * 用于加载和调用 TinyGo 编译的 WASM 模块
+ */
+export interface PerspectivePoint {
+    x: number;
+    y: number;
+}
+export interface PerspectiveMatrix {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    e: number;
+    f: number;
+    g: number;
+    h: number;
+    i?: number;
+}
+export declare class PerspectiveWasm {
+    private static instance;
+    private wasmReady;
+    private go;
+    private wasmModule;
+    private constructor();
+    static getInstance(): PerspectiveWasm;
+    /**
+     * 加载 WASM 模块
+     * @param wasmUrl WASM 文件路径（默认: /assets/perspective.wasm）
+     * @param wasmExecUrl wasm_exec.js 路径（默认: /assets/wasm_exec.js）
+     */
+    load(wasmUrl?: string, wasmExecUrl?: string): Promise<void>;
+    /**
+     * 验证授权
+     */
+    verifyLicense(token: string): Promise<boolean>;
+    /**
+     * 计算透视变换矩阵
+     */
+    calcPerspectiveMatrix(points: PerspectivePoint[]): PerspectiveMatrix;
+    /**
+     * 矩阵求逆
+     */
+    invertMatrix(matrix: PerspectiveMatrix): PerspectiveMatrix;
+    /**
+     * 应用透视变换到单个点
+     */
+    applyPerspective(u: number, v: number, matrix: PerspectiveMatrix): PerspectivePoint;
+    /**
+     * 应用逆透视变换到单个点
+     */
+    applyInversePerspective(x: number, y: number, matrix: PerspectiveMatrix): PerspectivePoint;
+    /**
+     * 批量变换点（高性能）
+     */
+    transformPoints(points: PerspectivePoint[], matrix: PerspectiveMatrix, inverse?: boolean): PerspectivePoint[];
+    /**
+     * 检查 WASM 是否已加载
+     */
+    isReady(): boolean;
+    /**
+     * 调用 WASM 函数
+     */
+    private call;
+    /**
+     * 加载外部脚本
+     */
+    private loadScript;
+}
+export default PerspectiveWasm;

package/dist/wasm/perspectiveLoader.worker.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 透视变换 WASM 模块加载器 (Worker 版本)
+ * 用于在 Web Worker 环境中加载和调用 TinyGo 编译的 WASM 模块
+ */
+export interface PerspectivePoint {
+    x: number;
+    y: number;
+}
+export interface PerspectiveMatrix {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    e: number;
+    f: number;
+    g: number;
+    h: number;
+    i?: number;
+}
+export declare class PerspectiveWasmWorker {
+    private static instance;
+    private wasmReady;
+    private go;
+    private wasmModule;
+    private constructor();
+    private isDebugEnabled;
+    private debugLog;
+    private debugWarn;
+    static getInstance(): PerspectiveWasmWorker;
+    /**
+     * 在 Worker 环境中加载 WASM 模块
+     * @param wasmUrl WASM 文件路径
+     * @param wasmExecUrl wasm_exec.js 路径
+     */
+    load(wasmUrl?: string, wasmExecUrl?: string): Promise<void>;
+    /**
+     * 在 Worker 中加载 wasm_exec.js
+     * Module Worker 不支持 importScripts()，仅 Classic Worker 可尝试 importScripts，否则用 fetch + eval
+     */
+    private loadWasmExec;
+    /**
+     * 验证授权（通过 API）
+     */
+    verifyLicense(token: string, apiUrl?: string): Promise<boolean>;
+    /**
+     * 获取设备 ID（从全局变量或生成）
+     */
+    private getDeviceID;
+    /**
+     * 获取域名（从全局变量或使用默认值）
+     */
+    private getDomain;
+    /**
+     * 计算透视变换矩阵
+     */
+    calcPerspectiveMatrix(points: PerspectivePoint[]): PerspectiveMatrix;
+    /**
+     * 矩阵求逆
+     */
+    invertMatrix(matrix: PerspectiveMatrix): PerspectiveMatrix;
+    /**
+     * 应用透视变换到单个点
+     */
+    applyPerspective(u: number, v: number, matrix: PerspectiveMatrix): PerspectivePoint;
+    /**
+     * 应用逆透视变换到单个点
+     */
+    applyInversePerspective(x: number, y: number, matrix: PerspectiveMatrix): PerspectivePoint;
+    /**
+     * 批量变换点（高性能）
+     */
+    transformPoints(points: PerspectivePoint[], matrix: PerspectiveMatrix, inverse?: boolean): PerspectivePoint[];
+    /**
+     * 检查 WASM 是否已加载
+     */
+    isReady(): boolean;
+    /**
+     * 双三次插值点计算
+     */
+    getBicubicPoint(u: number, v: number, points: PerspectivePoint[]): PerspectivePoint;
+    /**
+     * 双线性插值点计算
+     */
+    getBilinearPoint(u: number, v: number, points: PerspectivePoint[]): PerspectivePoint;
+    /**
+     * 任意网格点插值计算
+     */
+    getArbitraryMeshPoint(u: number, v: number, points: PerspectivePoint[], dim: number): PerspectivePoint;
+    /**
+     * 批量双三次插值（高性能优化）
+     * 一次性处理多个坐标，避免频繁的 JS/WASM 边界调用
+     */
+    batchBicubicInterpolation(coords: Array<{
+        u: number;
+        v: number;
+    }>, controlPoints: PerspectivePoint[]): PerspectivePoint[];
+    /**
+     * 批量双线性插值（高性能优化）
+     */
+    batchBilinearInterpolation(coords: Array<{
+        u: number;
+        v: number;
+    }>, controlPoints: PerspectivePoint[]): PerspectivePoint[];
+    /**
+     * 批量任意网格插值（高性能优化）
+     */
+    batchArbitraryMeshInterpolation(coords: Array<{
+        u: number;
+        v: number;
+    }>, meshPoints: PerspectivePoint[], dim: number): PerspectivePoint[];
+    /**
+     * 调用 WASM 函数
+     */
+    private call;
+}
+export default PerspectiveWasmWorker;

package/dist/zoneScreenshotWorker.js

@@ -0,0 +1,82 @@
+async function _(s) {
+  const { bitmap: t, quality: e } = s, i = new OffscreenCanvas(t.width, t.height), o = i.getContext("2d");
+  if (!o) throw new Error("Failed to create OffscreenCanvas 2d context");
+  o.drawImage(t, 0, 0);
+  try {
+    t.close?.();
+  } catch {
+  }
+  const r = await i.convertToBlob({ type: "image/webp", quality: e });
+  return { id: s.id, type: "ENCODE_WEBP_RESULT", blob: r };
+}
+async function A(s) {
+  const {
+    baseBitmap: t,
+    viewportTransform: e,
+    canvasWidth: i,
+    canvasHeight: o,
+    exportExt: r,
+    multiplier: c
+  } = s, a = e, E = a[0], x = a[4], y = a[5], R = Math.abs(E - 1) < 0.01 && Math.abs(x) < 0.5 && Math.abs(y) < 0.5;
+  let d;
+  if (R) {
+    const h = Math.max(1, Math.round(i * c)), f = Math.max(1, Math.round(o * c));
+    d = await createImageBitmap(t, {
+      resizeWidth: h,
+      resizeHeight: f,
+      resizeQuality: "medium"
+    });
+  } else {
+    const h = Math.max(1, r.width), f = Math.max(1, r.height), u = new OffscreenCanvas(h, f), p = u.getContext("2d");
+    if (!p) throw new Error("Failed to create OffscreenCanvas context");
+    const w = a[0], g = a[1], v = a[2], M = a[3], l = a[4], b = a[5], n = w * M - g * v;
+    if (Math.abs(n) < 1e-9) throw new Error("Singular viewport matrix");
+    const B = M / n, T = -g / n, O = -v / n, C = w / n, I = (v * b - M * l) / n, S = (g * l - w * b) / n, m = t.width / i || 1;
+    p.setTransform(
+      B / m,
+      T / m,
+      O / m,
+      C / m,
+      I - r.minL,
+      S - r.minT
+    ), p.drawImage(t, 0, 0);
+    const W = Math.max(1, Math.round(h * c)), z = Math.max(1, Math.round(f * c));
+    d = await createImageBitmap(u, {
+      resizeWidth: W,
+      resizeHeight: z,
+      resizeQuality: "medium"
+    });
+  }
+  return { id: s.id, type: "TRANSFORM_BITMAP_RESULT", bitmap: d };
+}
+self.onmessage = async (s) => {
+  const t = s.data;
+  if (t) {
+    if (t.type === "TRANSFORM_BITMAP") {
+      try {
+        const e = await A(t);
+        self.postMessage(e, [e.bitmap]);
+      } catch (e) {
+        self.postMessage({
+          id: t.id,
+          type: "ERROR",
+          error: e instanceof Error ? e.message : String(e)
+        });
+      }
+      return;
+    }
+    if (t.type === "ENCODE_WEBP") {
+      try {
+        const e = await _(t);
+        self.postMessage(e);
+      } catch (e) {
+        self.postMessage({
+          id: t.id,
+          type: "ERROR",
+          error: e instanceof Error ? e.message : String(e)
+        });
+      }
+      return;
+    }
+  }
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@jetprint/editor-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "private": false,
+  "scripts": {
+    "build:wasm": "node wasm-build/build.js",
+    "build:sdk": "vite build",
+    "build": "npm run build:wasm && npm run build:sdk",
+    "build:prod": "cross-env NODE_ENV=production npm run build",
+    "dev": "vite"
+  },
+  "main": "./dist/editor-sdk.es.js",
+  "module": "./dist/editor-sdk.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/editor-sdk.es.js",
+      "require": "./dist/editor-sdk.es.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "element-plus": "^2.13.0",
+    "fabric": "^7.1.0",
+    "pinia": "^3.0.0",
+    "vue": "^3.5.0"
+  },
+  "dependencies": {
+    "ali-oss": "^6.23.0",
+    "axios": "^1.13.2",
+    "crypto-js": "^4.2.0",
+    "idb": "^8.0.3",
+    "jszip": "^3.10.1",
+    "mathjs": "^12.1.0",
+    "three": "^0.184.0",
+    "vue-draggable-plus": "^0.6.1"
+  },
+  "devDependencies": {
+    "@types/three": "^0.184.0",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "cross-env": "^7.0.3",
+    "javascript-obfuscator": "^5.3.0",
+    "rollup-plugin-obfuscator": "^1.1.0",
+    "typescript": "^5.7.3",
+    "vite": "^7.2.4",
+    "vue": "^3.5.24"
+  }
+}