@jetprint/editor-sdk 1.2.4 → 1.2.6

package/dist/types.d.ts

@@ -139,6 +139,8 @@ export type AddToCartSubmitResult = {
     msg?: string;
     addedCount?: number;
     psTaskCode?: string;
+    /** 后端 PS 任务的设计字符串 ID（加购接口返回），宿主用于后台渲染 record 归属与恢复回报 */
+    psTaskId?: string;
 };
 export type AddToCartFetchDetailResult = {
     ok: true;
@@ -212,7 +214,7 @@ export type EditorOptions = {
      * 可指向自家 OSS 或本地 public 目录（如 '/imgly/dist/'）。
      */
     backgroundRemoveModelUrl?: string;
-    /** 自动抠图 · 模型变体，默认 'isnet_quint8'（42MB，体积小一半）。 */
+    /** 自动抠图 · 模型变体（@imgly 1.7.0）：'isnet_fp16' 质量最好(84MB) / 'isnet_quint8' 体积小一半(42MB) / 'isnet'。默认 'isnet_quint8'。 */
     backgroundRemoveModel?: 'isnet' | 'isnet_fp16' | 'isnet_quint8';
     /**
      * theme1「上传」Tab：用户通过内置 file input 选图后，将 `File` 交给宿主上传；完成后请调用编辑器 `defineExpose` 的 `addImageFromUrl(url)` 加入画布。
@@ -275,6 +277,33 @@ export type DiecutStateMapResult = {
     selectedSizes?: string[];
     /** 当前模板模式：'COMPLETE'（单片）或 'SPLIT'（多片） */
     selectedMode: 'COMPLETE' | 'SPLIT';
+    /** 特殊设计模式：none(正常) | embroidery(刺绣) | pillow3d(异形抱枕)；P1 模式开关，随设计保存、加载还原 */
+    specialMode?: 'none' | 'embroidery' | 'pillow3d';
+    /** typeModel = specialMode 别名；Go 还原生成图时据此分派三种模式生成不同生产图 */
+    typeModel?: 'none' | 'embroidery' | 'pillow3d';
+    /** 刺绣意图数据（仅 specialMode==='embroidery'）：色块+针法+量化参数，供后端确定性重建区域并生成刺绣文件 */
+    embroidery?: {
+        version: number;
+        /** 被刺绣化的原图来源 src */
+        sourceSrc: string;
+        /** 量化色数 + 颜色组合并阈值(Lab ΔE) + 工作尺寸；后端用同参数对原图确定性重量化得到相同色组 */
+        colorCount: number;
+        mergeColorDist: number;
+        maxWorkSize: number;
+        /** 每个颜色组：色值 / 面积 / 包围盒 / 所选针法 */
+        groups: Array<{
+            id: number;
+            color: [number, number, number];
+            area: number;
+            bbox: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            stitch: string;
+        }>;
+    };
     /** fabric 逻辑画布宽度（与导出 JSON 坐标系一致） */
     designCanvasSize: number;
     /** fabric 逻辑画布高度；缺省还原时按 CANVAS_LOGICAL_HEIGHT(2000) 处理 */
@@ -394,6 +423,7 @@ export type EditorProps = {
     onAddToCartSuccess?: (payload?: {
         addedCount?: number;
         psTaskCode?: string;
+        psTaskId?: string;
     }) => void;
     /** 内置加购失败或校验失败；仅 options.addToCart 生效时由 Editor 调用 */
     onAddToCartError?: (msg?: string) => void;

package/dist/utils/backgroundRenderer.d.ts

@@ -2,6 +2,8 @@ import { type RenderBundle, type FabricScreenshotBlob } from './renderedImagesDB
 import { getLicenseInfo } from './license/licenseStore';
 export interface BackgroundRenderJob {
     taskId: string;
+    /** 后端 PS 任务的设计字符串 ID（保存/加购接口返回），随 record 持久化，恢复渲染时回报后端用 */
+    psTaskId?: string;
     /** 完整渲染数据包（优先使用：后台直接调用 renderByJson 合成） */
     renderBundle?: RenderBundle;
     /** 旧路径：由编辑器实时渲染（renderBundle 不存在时回退） */
@@ -9,12 +11,13 @@ export interface BackgroundRenderJob {
         index: number;
         blob: Blob;
     }>>;
-    /** 由调用方提供的图片上传函数，避免 SDK 依赖主项目 API */
+    /** 由调用方提供的图片上传函数，避免 SDK 依赖主项目 API。
+     *  第三参 psTaskId 为后端任务 ID，恢复渲染时用它拼 /ps/task/{psTaskId}/images 回报后端。 */
     uploadImages?: (taskId: string, images: Array<{
         index: number;
         blob: Blob;
         fileName: string;
-    }>) => Promise<void>;
+    }>, psTaskId?: string) => Promise<void>;
     /** 所有模板渲染完成且 cover 图片上传完成后调用，用于上传 fabricScreenshotList */
     onDesignScreenshotsReady?: (taskId: string, fabricScreenshots: FabricScreenshotBlob[]) => Promise<void>;
     /**
@@ -45,7 +48,7 @@ export interface BackgroundRenderJob {
  * 保存成功后立刻写入占位任务（rendering、images: []），再异步 collectRenderBundle。
  * 避免用户先于 collect 进入「我的设计」时 IndexedDB 尚无记录，getRenderTask 为空、列表无法轮询。
  */
-export declare function putRenderTaskPlaceholder(taskId: string): Promise<void>;
+export declare function putRenderTaskPlaceholder(taskId: string, psTaskId?: string): Promise<void>;
 export declare function startBackgroundRender(job: BackgroundRenderJob): Promise<void>;
 /** 将 renderBundle 内所有模板合成为 Blob 列表（不写 IndexedDB，供多颜色同步渲染） */
 export declare function renderBundleToBlobs(bundle: RenderBundle, licenseSnapshot?: ReturnType<typeof getLicenseInfo>, onBlob?: (img: {

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

@@ -3,7 +3,7 @@
  * 此文件由 vite-plugins/serverEncrypt.ts 在构建时自动生成
  * 请勿手动编辑
  *
- * 生成时间: 2026-06-22T16:24:29.264Z
+ * 生成时间: 2026-06-24T13:33:49.380Z
  * 构建模式: production
  * 加密模块数量: 13
  * 构建种子: Kx9mP2qR5s... (已隐藏)

package/dist/utils/renderedImagesDB.d.ts

@@ -37,6 +37,9 @@ export interface RenderBundle {
 }
 export interface RenderTaskRecord {
     taskId: string;
+    /** 后端 PS 任务的设计字符串 ID（保存/加购接口返回的 data.psTaskId），用于后端对账；
+     *  恢复渲染时按此 ID 回报 /ps/task/{psTaskId}/images，而非本地拼接的 taskId。 */
+    psTaskId?: string;
     status: RenderTaskStatus;
     images: RenderedImage[];
     createdAt: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetprint/editor-sdk",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "type": "module",
   "private": false,
   "scripts": {