@jetprint/editor-sdk 1.2.3 → 1.2.4

package/dist/types.d.ts

@@ -195,10 +195,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;
+    /** 自动抠图 · 模型变体，默认 'isnet_quint8'（42MB，体积小一半）。 */
+    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 + 成功/失败回调即可）。

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

@@ -3,7 +3,7 @@
  * 此文件由 vite-plugins/serverEncrypt.ts 在构建时自动生成
  * 请勿手动编辑
  *
- * 生成时间: 2026-06-22T08:13:45.537Z
+ * 生成时间: 2026-06-22T16:24:29.264Z
  * 构建模式: 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/package.json

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