@jetprint/editor-sdk 1.2.3 → 1.2.5

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;
@@ -195,10 +197,34 @@ export type EditorOptions = {
     uiTheme?: EditorUiTheme;
     /** 为 true 时在顶栏「清空画布」右侧显示界面主题下拉，变更时向宿主 emit `update:uiTheme` */
     showUiThemeSelect?: boolean;
+    /** 为 true 时在图层操作区显示「自动抠图」按钮（默认隐藏；第三方需显式开启） */
+    showBackgroundRemove?: boolean;
+    /**
+     * 自动抠图 · 服务端模式：传入则用它替代客户端 ONNX 推理（不加载 @imgly、不跑本地模型，最轻）。
+     * 入参原图 Blob，返回去背景后的图（Blob 或可 fetch 的 URL）。
+     */
+    backgroundRemoveProvider?: (input: Blob) => Promise<Blob | string>;
+    /**
+     * 自动抠图 · 客户端模式：@imgly ESM 运行时 URL（默认 jsdelivr CDN）。
+     * ort 运行时由此 URL 在运行时加载，**不进 SDK 包**；可指向自家 CDN/OSS 托管的 @imgly ESM 产物。
+     */
+    backgroundRemoveCdnUrl?: string;
+    /**
+     * 自动抠图 · 客户端模式：模型/wasm 加载基址（publicPath）。默认走 @imgly 官方 CDN；
+     * 可指向自家 OSS 或本地 public 目录（如 '/imgly/dist/'）。
+     */
+    backgroundRemoveModelUrl?: string;
+    /** 自动抠图 · 模型变体（@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)` 加入画布。
      */
     onTheme1UploadLocalFiles?: (file: File) => void | Promise<void>;
+    /**
+     * 无 galleryApi 的第三方：抠图（+描边）完成后回调最终结果图（File + 建议文件名）。
+     * 返回字符串(URL)则 SDK 用它作图层 savedSrc 持久化；返回 void 则由第三方自行保存、图层保留内存结果。
+     */
+    onBackgroundRemoveResult?: (file: File, suggestedName: string) => Promise<string | void> | string | void;
     /**
      * 内置加购弹窗：注入 fetchDetail + submit 后，顶栏与 theme1 Mockup「加购」走 SDK 弹窗。
      * 配置后不再调用 props.onAddToCart（由宿主只传 adapter + 成功/失败回调即可）。
@@ -251,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) 处理 */
@@ -370,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-22T08:13:45.537Z
+ * 生成时间: 2026-06-24T10:34:52.116Z
  * 构建模式: production
  * 加密模块数量: 13
  * 构建种子: Kx9mP2qR5s... (已隐藏)

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

@@ -0,0 +1,148 @@
+/** 同时兼容浏览器主线程与 Worker 两种 2D canvas */
+export type CanvasLike = HTMLCanvasElement | OffscreenCanvas;
+/** ag-psd 风格的数值: 可能是裸 number,也可能是 {value} 包装(可带 unit) */
+export type NumLike = number | {
+    value: number;
+    unit?: string;
+} | null | undefined;
+/** 颜色 {r,g,b}(0-255) */
+export interface EffectColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/** bevel 纹理参数(由调用方从 lfx2 解析后传入;本模块不解析 PSD) */
+export interface BevelTex {
+    depth: number;
+    scale?: number;
+    invert?: boolean;
+    align?: boolean;
+}
+/** 图案引用 */
+export interface PatternRef {
+    id?: string;
+}
+/** 相位(图案偏移) */
+export interface EffectPhase {
+    x?: number;
+    y?: number;
+}
+/** 投影 / 内阴影 */
+export interface ShadowEffect {
+    enabled?: boolean;
+    color?: EffectColor;
+    blendMode?: string;
+    opacity?: number;
+    angle?: NumLike;
+    distance?: NumLike;
+    size?: NumLike;
+}
+/** 外发光 / 内发光 */
+export interface GlowEffect {
+    enabled?: boolean;
+    color?: EffectColor;
+    blendMode?: string;
+    opacity?: number;
+    size?: NumLike;
+}
+/** 颜色叠加 */
+export interface SolidFillEffect {
+    enabled?: boolean;
+    color?: EffectColor;
+    blendMode?: string;
+    opacity?: number;
+}
+/** 图案叠加 */
+export interface PatternOverlayEffect {
+    enabled?: boolean;
+    pattern?: PatternRef;
+    blendMode?: string;
+    opacity?: number;
+    scale?: NumLike;
+    phase?: EffectPhase;
+}
+/** 光泽(satin) */
+export interface SatinEffect {
+    enabled?: boolean;
+    color?: EffectColor;
+    blendMode?: string;
+    opacity?: number;
+    angle?: NumLike;
+    distance?: NumLike;
+    size?: NumLike;
+}
+/** 斜面与浮雕(bevel) */
+export interface BevelEffect {
+    enabled?: boolean;
+    size?: NumLike;
+    soften?: NumLike;
+    strength?: NumLike;
+    depth?: NumLike;
+    angle?: NumLike;
+    altitude?: NumLike;
+    localLightingAngle?: NumLike;
+    localLightingAltitude?: NumLike;
+    technique?: string;
+    useShape?: boolean;
+    useTexture?: boolean;
+    pattern?: PatternRef;
+    scale?: NumLike;
+    phase?: EffectPhase;
+    highlightColor?: EffectColor;
+    shadowColor?: EffectColor;
+    highlightBlendMode?: string;
+    shadowBlendMode?: string;
+    highlightOpacity?: number;
+    shadowOpacity?: number;
+}
+/**
+ * 图层效果数据(由后端 JSON 提供,本模块仅消费)。
+ * 经 filterEnabledEffects 归一化后,multis 字段统一为数组。
+ * 原始后端数据中 patternOverlay 可能是单对象、solidFill/gradientOverlay 可能是数组,
+ * 这里用宽松类型同时兼容(filterEnabledEffects 负责统一)。
+ */
+export interface LayerEffects {
+    scale?: NumLike;
+    dropShadow?: ShadowEffect | ShadowEffect[];
+    outerGlow?: GlowEffect;
+    innerGlow?: GlowEffect;
+    innerShadow?: ShadowEffect | ShadowEffect[];
+    solidFill?: SolidFillEffect | SolidFillEffect[];
+    patternOverlay?: PatternOverlayEffect | PatternOverlayEffect[];
+    satin?: SatinEffect;
+    bevel?: BevelEffect;
+    gradientOverlay?: unknown;
+    stroke?: unknown;
+    [k: string]: unknown;
+}
+/** 归一化后的 effects(multis 已转数组) */
+interface NormalizedEffects extends LayerEffects {
+    dropShadow?: ShadowEffect[];
+    innerShadow?: ShadowEffect[];
+    solidFill?: SolidFillEffect[];
+    patternOverlay?: PatternOverlayEffect[];
+}
+/** applyLayerEffects 选项: pattern/bevelTex 来源回调 + scale */
+export interface ApplyEffectsOptions {
+    /** 取图案位图(patternOverlay / bevel useTexture);源码中的 g_bridgeData.patterns.get(id) */
+    getPatternCanvas?: (id: string) => CanvasLike | null;
+    /** 取 bevel 真实纹理参数;源码中的 g_bridgeData.bevelTex.get(id) */
+    getBevelTex?: (id: string) => BevelTex | null;
+    /** 额外缩放(可选,覆盖 eff.scale;不传则用 eff.scale) */
+    scale?: number;
+}
+/** 可绘制源(canvas 或 image),用作 drawImage 的输入 */
+type Drawable = CanvasLike | HTMLImageElement | ImageBitmap;
+export declare function _clamp01(v: number): number;
+export declare function _vividLight(b: number, s: number): number;
+export declare function _blendCh(mode: string, b: number, s: number): number;
+export declare function filterEnabledEffects(eff: LayerEffects | null | undefined): NormalizedEffects | undefined;
+/**
+ * 对"变形后 canvas"应用图层效果,返回新 canvas(供上层合成时 drawImage)。
+ * 每个效果独立 try/catch,失败不影响其余效果。
+ * pattern/bevelTex 通过 opts 回调传入(本模块不解析 PSD)。
+ * 行为与源码一致:假定 eff 已是 filterEnabledEffects 的输出(multis 为数组)。
+ */
+export declare function applyLayerEffects(bodyCanvas: Drawable, eff: LayerEffects | null | undefined, W: number, H: number, opts?: ApplyEffectsOptions): CanvasLike;
+export declare function getBlendMode(m?: string): GlobalCompositeOperation;
+export {};

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

@@ -1,3 +1,4 @@
+import type { LayerEffects } from './layerEffects';
 export declare enum EPartType {
     Drawing = 0,// 可绘制插画
     Material = 1
@@ -75,6 +76,7 @@ export interface ISmartObject {
     filterList?: IFilter[];
     opacity?: number;
     clipping?: boolean;
+    effects?: LayerEffects;
 }
 /** 裁片部位数据 */
 export interface IPart {
@@ -105,6 +107,7 @@ export interface IPsdPartData {
     opacity?: number;
     clipping?: boolean;
     layerOrder?: number;
+    effects?: LayerEffects;
 }
 /** 模特图数据 */
 export interface IPsdModelData {
@@ -146,6 +149,7 @@ export interface IPsdJsonLayer {
     id?: number;
     opacity?: number;
     clipping?: boolean;
+    effects?: LayerEffects;
 }
 export interface IPsdJsonData {
     canvasWidth: number;

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.3",
+  "version": "1.2.5",
   "type": "module",
   "private": false,
   "scripts": {