@jetprint/editor-sdk 1.0.0

package/dist/utils/jsonFileCache.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 带 fileToken 的 JSON 拉取；同一规范化 URL（去掉 fileToken）复用解析结果，减少预览/模板重复请求。
+ * 每次返回深拷贝，避免调用方修改 layerList 等污染缓存。
+ */
+export declare function fetchJsonWithFileTokenCached<T = unknown>(url: string, init?: RequestInit): Promise<T>;
+export declare function clearJsonFileCache(): void;

package/dist/utils/license/api.d.ts

@@ -0,0 +1,74 @@
+export interface LicenseTokenRequest {
+    licenseKey: string;
+    deviceId: string;
+    domain: string;
+}
+export interface LicenseTokenResponse {
+    success: boolean;
+    token?: string;
+    error?: string;
+}
+export interface LicenseVerifyRequest {
+    token: string;
+    deviceId: string;
+    domain: string;
+}
+export interface LicenseRefreshTokenRequest {
+    token: string;
+    deviceId: string;
+    domain: string;
+}
+export interface LicenseRefreshTokenResponse {
+    success: boolean;
+    token?: string;
+    expiresAt?: string;
+    error?: string;
+}
+export interface LicenseVerifyResponse {
+    success: boolean;
+    valid?: boolean;
+    error?: string;
+}
+export interface LicenseDecryptKeyRequest {
+    token: string;
+    deviceId: string;
+    domain: string;
+    nonce?: string;
+    timestamp?: number;
+    signature?: string;
+}
+export interface LicenseDecryptKeyResponse {
+    success: boolean;
+    key?: string;
+    error?: string;
+}
+export declare class LicenseAPI {
+    private http;
+    baseUrl: string;
+    constructor(baseUrl: string, timeout?: number);
+    /**
+     * 生成随机 Nonce（用于防重放攻击）
+     */
+    private generateNonce;
+    /**
+     * 生成请求签名
+     * 使用 token 的签名部分作为签名密钥（token 格式：jwt:signature）
+     */
+    private signRequest;
+    /**
+     * 生成 License Token（新 API: /jet_license/interface/license/token）
+     */
+    generateToken(request: LicenseTokenRequest): Promise<LicenseTokenResponse>;
+    /**
+     * 验证 License Token（新 API: /jet_license/interface/license/verify）
+     */
+    verifyToken(request: LicenseVerifyRequest): Promise<LicenseVerifyResponse>;
+    /**
+     * 刷新 Token（新 API: /jet_license/interface/license/refreshToken）
+     */
+    refreshToken(request: LicenseRefreshTokenRequest): Promise<LicenseRefreshTokenResponse>;
+    /**
+     * 获取代码解密密钥（新 API: /jet_license/interface/license/decrypt-key）
+     */
+    getDecryptionKey(request: LicenseDecryptKeyRequest): Promise<LicenseDecryptKeyResponse>;
+}

package/dist/utils/license/deviceId.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 生成设备唯一标识
+ * 基于浏览器指纹 + LocalStorage 持久化
+ */
+export declare class DeviceID {
+    private static readonly STORAGE_KEY;
+    private static cachedId;
+    /**
+     * 获取设备 ID（如果不存在则生成）
+     */
+    static getDeviceID(): string;
+    /**
+     * 生成设备 ID
+     * 基于浏览器特征生成唯一标识
+     */
+    private static generateDeviceID;
+    /**
+     * 简单的哈希函数
+     */
+    private static simpleHash;
+    /**
+     * 清除设备 ID（用于测试）
+     */
+    static clearDeviceID(): void;
+}

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

@@ -0,0 +1,9 @@
+export { LicenseAPI } from './api';
+export { LicenseManager } from './licenseManager';
+export { DeviceID } from './deviceId';
+export { TokenRefresher } from './tokenRefresh';
+export { withRetry } from './retry';
+export { setLicenseInfo, getLicenseInfo, clearLicenseInfo } from './licenseStore';
+export type { LicenseTokenRequest, LicenseTokenResponse, LicenseVerifyRequest, LicenseVerifyResponse, LicenseDecryptKeyRequest, LicenseDecryptKeyResponse, } from './api';
+export type { TokenRefreshConfig } from './tokenRefresh';
+export type { RetryOptions } from './retry';

package/dist/utils/license/licenseManager.d.ts

@@ -0,0 +1,63 @@
+import { type RetryOptions } from './retry';
+export interface LicenseConfig {
+    licenseKey: string;
+    apiBaseUrl: string;
+    timeout?: number;
+    enableAutoRefresh?: boolean;
+    refreshThreshold?: number;
+    retryOptions?: RetryOptions;
+    onError?: (error: string) => void;
+    onSuccess?: () => void;
+    onTokenRefresh?: (token: string) => void;
+}
+export declare class LicenseManager {
+    private api;
+    private licenseKey;
+    private token;
+    private deviceId;
+    private domain;
+    private refresher;
+    private retryOptions;
+    private onError?;
+    private onSuccess?;
+    private onTokenRefresh?;
+    private verificationPromise;
+    constructor(config: LicenseConfig);
+    /**
+     * 初始化 License（获取 Token，带重试）
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * 验证 License Token（带重试）
+     */
+    verify(): Promise<boolean>;
+    private doVerify;
+    /**
+     * 手动刷新 Token
+     */
+    refreshToken(): Promise<boolean>;
+    /**
+     * 获取 Token（用于传递给 WASM）
+     */
+    getToken(): string | null;
+    /**
+     * 获取设备 ID
+     */
+    getDeviceID(): string;
+    /**
+     * 获取域名
+     */
+    getDomain(): string;
+    /**
+     * 处理错误
+     */
+    private handleError;
+    /**
+     * 清除 Token（用于登出等场景）
+     */
+    clear(): void;
+    /**
+     * 销毁（清理资源）
+     */
+    destroy(): void;
+}

package/dist/utils/license/licenseStore.d.ts

@@ -0,0 +1,17 @@
+/**
+ * License 共享存储
+ * 供主线程的不同模块使用，避免依赖全局变量
+ */
+export declare function setLicenseInfo(config: {
+    token: string;
+    apiUrl: string;
+    deviceId: string;
+    domain: string;
+}): void;
+export declare function getLicenseInfo(): {
+    token: string | null;
+    apiUrl: string | null;
+    deviceId: string | null;
+    domain: string | null;
+};
+export declare function clearLicenseInfo(): void;

package/dist/utils/license/retry.d.ts

@@ -0,0 +1,11 @@
+export interface RetryOptions {
+    maxRetries?: number;
+    retryDelay?: number;
+    retryDelayMultiplier?: number;
+    retryableErrors?: string[];
+}
+export declare class RetryableError extends Error {
+    retryable: boolean;
+    constructor(message: string, retryable?: boolean);
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;

package/dist/utils/license/tokenRefresh.d.ts

@@ -0,0 +1,34 @@
+export interface TokenRefreshConfig {
+    apiBaseUrl: string;
+    licenseKey: string;
+    refreshThreshold: number;
+    onRefresh?: (token: string) => void;
+    onError?: (error: string) => void;
+}
+export declare class TokenRefresher {
+    private api;
+    private deviceId;
+    private domain;
+    private refreshThreshold;
+    private refreshTimer;
+    private currentToken;
+    private onRefresh?;
+    private onError?;
+    constructor(config: TokenRefreshConfig);
+    /**
+     * 解析 Token 获取过期时间
+     */
+    private getTokenExpiry;
+    /**
+     * 启动自动刷新
+     */
+    startAutoRefresh(currentToken: string): void;
+    /**
+     * 停止自动刷新
+     */
+    stopAutoRefresh(): void;
+    /**
+     * 刷新 Token（调用新 API: /jet_license/interface/license/refreshToken）
+     */
+    refreshToken(): Promise<string | null>;
+}

package/dist/utils/mediaBlobCache.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 带 fileToken 的图片拉取；同一规范化 URL（去掉 fileToken）复用 Blob，减少预览/Worker 重复请求。
+ * 仅应在图片/二进制媒体路径使用，勿用于 JSON API。
+ */
+export declare function fetchMediaBlobCached(url: string, init?: RequestInit): Promise<Blob>;
+export declare function clearMediaBlobCache(): void;

package/dist/utils/protection/encryptedModules.generated.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 自动生成的加密模块文件
+ * 此文件由 vite-plugins/serverEncrypt.ts 在构建时自动生成
+ * 请勿手动编辑
+ *
+ * 生成时间: 2026-06-10T06:49:14.030Z
+ * 构建模式: production
+ * 加密模块数量: 13
+ * 构建种子: Kx9mP2qR5s... (已隐藏)
+ *
+ * 加密模块列表：
+ * 第一阶段（6个）：
+ * - deform.ts, render.ts, psdConverter.ts, image.ts, blend.ts, mask.ts
+ *
+ * 第二阶段（3个）：
+ * - prepareRenderData.ts, workerManager.ts, types.ts
+ *
+ * 第三阶段（2个）：
+ * - perspectiveLoader.ts, workerLoader.ts
+ *
+ * 第四阶段（2个）：
+ * - renderService/index.ts, wasm/index.ts
+ */
+export declare const ENCRYPTED_MODULES: Record<string, {
+    data: string;
+    hash: string;
+}>;

package/dist/utils/protection/moduleLoader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 加密模块加载器
+ * 从服务端获取解密密钥，解密并加载加密的核心模块
+ */
+/**
+ * 从服务端获取解密密钥
+ */
+export declare function fetchDecryptionKey(apiBaseUrl: string, token: string, deviceId: string, domain: string): Promise<string>;
+/**
+ * 加载加密模块
+ * @param modulePath - 模块路径（相对于 src 目录）
+ */
+export declare function loadEncryptedModule(modulePath: string): Promise<any>;
+/**
+ * 清除解密密钥和缓存（用于登出等场景）
+ */
+export declare function clearDecryptionCache(): void;

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

@@ -0,0 +1,4 @@
+/**
+ * 转换混合模式（参考 HTML 文件中的 getBlendMode 函数）
+ */
+export declare function convertBlendMode(blendMode?: string): GlobalCompositeOperation;

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

@@ -0,0 +1,21 @@
+import { ISmartObject } from "./types";
+/**
+ * 变形渲染封装函数
+ * @param image - 输入图片，支持 URL、HTMLImageElement 或 ImageBitmap
+ * @param smartObject - 部位数据（智能对象配置）
+ * @param faceId - 面 ID，用于标识 worker（可选，默认为 0）
+ * @returns 变形后的图片 HTMLImageElement
+ */
+export declare function deformImage(image: string | HTMLImageElement | ImageBitmap, smartObject: ISmartObject, faceId?: number, maxImageSize?: number, baseUrl?: string): Promise<HTMLImageElement>;
+/**
+ * 变形渲染封装函数（返回 ImageBitmap）
+ * @param image - 输入图片，支持 URL、HTMLImageElement 或 ImageBitmap
+ * @param smartObject - 部位数据（智能对象配置）
+ * @param faceId - 面 ID，用于标识 worker（可选，默认为 0）
+ * @param canvasSize - 画布尺寸（可选，默认使用 smartObject.size）
+ * @returns 变形后的 ImageBitmap
+ */
+export declare function deformImageBitmap(image: string | HTMLImageElement | ImageBitmap, smartObject: ISmartObject, faceId?: number, canvasSize?: {
+    width: number;
+    height: number;
+}, maxImageSize?: number, baseUrl?: string): Promise<ImageBitmap>;

package/dist/utils/renderService/deform.worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * deform.worker.ts - 变形 Web Worker
+ *
+ * 包含所有变形算法（透视变换、网格变形、Puppet Warp等）
+ * 支持 WASM 加速（TinyGo 编译的核心算法）
+ */
+export {};

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

@@ -0,0 +1,8 @@
+/**
+ * 将输入图片转换为 ImageBitmap
+ */
+export declare function toImageBitmap(image: string | HTMLImageElement | ImageBitmap, maxImageSize?: number, baseUrl?: string): Promise<ImageBitmap>;
+/**
+ * 加载图片为 ImageBitmap
+ */
+export declare function loadImageBitmap(url: string, maxImageSize?: number, baseUrl?: string): Promise<ImageBitmap>;

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

@@ -0,0 +1,12 @@
+/**
+ * renderService - 渲染服务
+ * 按功能拆分到多个文件，本文件仅做统一导出
+ */
+export * from "./types";
+export * from "./psdConverter";
+export * from "./mask";
+export * from "./image";
+export * from "./blend";
+export * from "./workerManager";
+export * from "./deform";
+export * from "./render";

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

@@ -0,0 +1,13 @@
+import { IMaskData, ISmartObject } from "./types";
+/**
+ * 智能获取蒙版数据
+ */
+export declare function getMaskFromData(data: ISmartObject): IMaskData | null;
+/**
+ * 规范化蒙版数据（转换 Vue Proxy 对象为普通对象）
+ */
+export declare function normalizeMaskData(maskData?: IMaskData | null): IMaskData | null;
+/**
+ * 应用矢量蒙版到 canvas
+ */
+export declare function applyVectorMask(ctx: CanvasRenderingContext2D, maskData: IMaskData | null): void;

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

@@ -0,0 +1,2 @@
+import type { IRenderByJson } from './types';
+export declare function prepareRenderDataWithFileToken(renderData: IRenderByJson): Promise<IRenderByJson>;

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

@@ -0,0 +1,6 @@
+import { IConvertPsdInput, IConvertPsdOptions, IModelData } from "./types";
+/**
+ * 将 PSD JSON 转换为模型数据（核心算法，需要加密）
+ * @encrypt
+ */
+export declare function convertPsdJsonToModelData(psdJsonList: IConvertPsdInput[], options: IConvertPsdOptions): IModelData;

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

@@ -0,0 +1,14 @@
+import { IDeformResult, IRenderByJsonResult, TLayerExtrasByName } from "./types";
+import type { IPsdJsonData, IRenderByJson } from "./types";
+/**
+ * 根据 JSON 和 layerExtrasByName 进行变形（核心算法）
+ */
+export declare function deformByJson(psdJson: IPsdJsonData, layerExtrasByName: TLayerExtrasByName): Promise<IDeformResult[]>;
+/**
+ * 根据 JSON 和 layerExtrasByName 渲染所有图层到 canvas（核心算法）
+ */
+export declare function renderByJson(data: IRenderByJson): Promise<IRenderByJsonResult>;
+/**
+ * 下载 canvas 为图片
+ */
+export declare function downloadCanvas(canvas: HTMLCanvasElement | OffscreenCanvas, filename?: string): Promise<void>;

package/dist/utils/renderService/render.worker.d.ts

@@ -0,0 +1,17 @@
+export type IMaskData = {
+    type: "bezier";
+    paths: Array<{
+        open: boolean;
+        knots: Array<{
+            linked: boolean;
+            points: number[];
+        }>;
+    }>;
+} | {
+    type: "simple";
+    points: Array<{
+        x: number;
+        y: number;
+        type?: number;
+    }>;
+};

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

@@ -0,0 +1,236 @@
+export declare enum EPartType {
+    Drawing = 0,// 可绘制插画
+    Material = 1
+}
+/** 2D顶点,相对于画布的坐标系 */
+export interface IPoint {
+    x: number;
+    y: number;
+    type?: number;
+}
+/** 矢量蒙版节点，包含贝塞尔曲线控制点 */
+export interface IVectorKnot {
+    linked: boolean;
+    points: number[];
+}
+/** 矢量路径 */
+export interface IVectorPath {
+    open: boolean;
+    knots: IVectorKnot[];
+    fillRule?: string;
+    operation?: string;
+}
+/** 矢量蒙版 */
+export interface IVectorMask {
+    paths: IVectorPath[];
+    points?: IPoint[];
+    invert?: boolean;
+    notLink?: boolean;
+    disable?: boolean;
+    fillStartsWithAllPixels?: boolean;
+}
+export interface IBounds {
+    top: number;
+    left: number;
+    bottom?: number;
+    right?: number;
+    width: number;
+    height: number;
+}
+export interface IPuppetShape {
+    originalVertexArray: IPoint[];
+    deformedVertexArray: IPoint[];
+    indexArray: number[];
+}
+export interface IFilter {
+    type: string;
+    enabled: boolean;
+    filter?: {
+        puppetShapeList?: IPuppetShape[];
+    };
+}
+export interface ISmartObject {
+    name?: string;
+    type?: string;
+    blendMode?: string;
+    transform: number[];
+    meshPoints?: IPoint[];
+    bounds: IBounds;
+    isSmartObject?: boolean;
+    size?: {
+        width: number;
+        height: number;
+    };
+    originalWidth?: number;
+    originalHeight?: number;
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    layerOrder?: number;
+    imagePath?: string;
+    vectorMask?: IVectorMask;
+    placedLayer?: {
+        width: number;
+        height: number;
+    };
+    filterList?: IFilter[];
+    opacity?: number;
+    clipping?: boolean;
+}
+/** 裁片部位数据 */
+export interface IPart {
+    id: number;
+    name: string;
+    url?: string;
+    designArea?: string;
+    pureUrl?: string;
+    width?: number;
+    height?: number;
+    partType?: EPartType;
+}
+export declare enum EPsdDataType {
+    Group = 0,// 部件组
+    Layer = 1
+}
+/** psd部位数据 */
+export interface IPsdPartData {
+    id: number;
+    partId?: number;
+    name: string;
+    blendMode?: string;
+    vectorMaskPath?: IPoint[];
+    smartObjects?: ISmartObject[];
+    type: EPsdDataType;
+    url?: string;
+    bounds?: IBounds;
+    opacity?: number;
+    clipping?: boolean;
+    layerOrder?: number;
+}
+/** 模特图数据 */
+export interface IPsdModelData {
+    width: number;
+    height: number;
+    psdPartData?: IPsdPartData[];
+}
+/** 版型数据 */
+export interface IModelData {
+    parts: IPart[];
+    models: IPsdModelData[];
+}
+export type PsdLayerType = "Layer" | "Group";
+export interface IPsdJsonLayer {
+    name: string;
+    type: PsdLayerType;
+    blendMode?: string;
+    bounds?: IBounds;
+    layerOrder?: number;
+    imagePath?: string;
+    vectorMask?: IVectorMask;
+    children?: IPsdJsonLayer[];
+    isSmartObject?: boolean;
+    size?: {
+        width: number;
+        height: number;
+    };
+    placedLayer?: {
+        width: number;
+        height: number;
+    };
+    originalWidth?: number;
+    originalHeight?: number;
+    meshPoints?: IPoint[];
+    transform?: number[];
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    filterList?: IFilter[];
+    id?: number;
+    opacity?: number;
+    clipping?: boolean;
+}
+export interface IPsdJsonData {
+    canvasWidth: number;
+    canvasHeight: number;
+    layerList: IPsdJsonLayer[];
+}
+export interface ILayerExtras {
+    id?: number;
+    partId?: number;
+    url?: string;
+    /** 变形部位对应的设计图片（URL、HTMLImageElement 或 ImageBitmap） */
+    designImage?: string | HTMLImageElement | ImageBitmap;
+}
+export interface IConvertPsdOptions {
+    parts: IPart[];
+    defaultIdStart?: number;
+}
+export interface IConvertPsdInput {
+    psdJson: IPsdJsonData;
+    layerExtrasByName?: Record<string, ILayerExtras>;
+}
+/** 蒙版数据类型 */
+export type IMaskData = {
+    type: "bezier";
+    paths: IVectorPath[];
+} | {
+    type: "simple";
+    points: IPoint[];
+};
+/** 图层额外信息类型（包含变形图片） */
+export interface ILayerExtrasWithImage {
+    id?: number;
+    partId?: number;
+    url?: string;
+    designImage?: string | HTMLImageElement | ImageBitmap;
+    /** 可选：内容版本，用于 Three 变形结果缓存判断图片内容是否变化。 */
+    contentVersion?: number | string;
+}
+/** layerExtrasByName 类型 */
+export type TLayerExtrasByName = Record<string, ILayerExtrasWithImage>;
+/** 变形结果 */
+export interface IDeformResult {
+    layerName: string;
+    partId?: number;
+    imageBitmap: ImageBitmap;
+}
+/** 渲染结果 */
+export interface IRenderByJsonResult {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    width: number;
+    height: number;
+}
+export interface IMaterial {
+    layerName: string;
+    url: string;
+    sourceName?: string;
+}
+export interface IFabricScreenshot {
+    id: number;
+    /** Optional part/group name, used to remap screenshots across mockup PSDs whose group ids differ. */
+    name?: string;
+    url: string;
+    /** 可选：拖动实时预览使用的内存图源，优先级高于 url。 */
+    designImage?: ImageBitmap;
+    /** 可选：内容版本（用于避免仅 url 变化导致缓存击穿）。 */
+    contentVersion?: number | string;
+}
+export interface IRenderByJson {
+    psdJson: IPsdJsonData;
+    materialList: IMaterial[];
+    fabricScreenshotList: IFabricScreenshot[];
+    width?: number;
+    height?: number;
+    /** 可选：图片资源的基准 URL，用于解析相对路径 */
+    baseUrl?: string;
+    /** 拖动实时预览的渲染层级：fast 只用于跟手反馈，hd 用于松手后的清晰结果 */
+    previewTier?: 'fast' | 'hd';
+    /** fast 预览之后是否还需要补一帧高清结果 */
+    hasPendingHdFollowup?: boolean;
+    /** 限制图片解码长边，降低拖动中 worker 解码成本 */
+    maxImageSize?: number;
+    /** 可选：预览渲染质量，quick 用于拖动中的低分辨率快速反馈 */
+    previewQuality?: 'quick' | 'normal';
+    /** 为 true 时跳过智能对象网格变形，直接用纹理四边形（拖动快速预览时启用以节省 11-80ms） */
+    skipDeform?: boolean;
+    /** 当前渲染的目标颜色，用于过滤 psdJson 中不属于此颜色的图层（如 "Beige"、"Black"） */
+    selectedColor?: string;
+}