@jetprint/editor-sdk 1.2.2 → 1.2.4

package/dist/components/Editor/components/EditorSidebar.vue.d.ts

@@ -209,6 +209,21 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 当前选中图层是否为图片（控制抠图按钮显示） */
+    activeLayerIsImage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 抠图处理中：按钮 disabled + 显示 loading */
+    removeBgProcessing: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否显示「自动抠图」按钮（默认隐藏；第三方需显式开启） */
+    showBackgroundRemove: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** actionId → 快捷键展示文案，用于图层工具 title */
     shortcutKeys: {
         type: PropType<Record<string, string>>;
@@ -234,6 +249,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     "apply-image-pattern": (...args: any[]) => void;
     "update-image-pattern-scale": (...args: any[]) => void;
     "crop-layer": (...args: any[]) => void;
+    "remove-bg-layer": (...args: any[]) => void;
     "update:activeTab": (...args: any[]) => void;
     "update:urlInput": (...args: any[]) => void;
     "update:selectedProductIndex": (...args: any[]) => void;
@@ -452,6 +468,21 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 当前选中图层是否为图片（控制抠图按钮显示） */
+    activeLayerIsImage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 抠图处理中：按钮 disabled + 显示 loading */
+    removeBgProcessing: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否显示「自动抠图」按钮（默认隐藏；第三方需显式开启） */
+    showBackgroundRemove: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** actionId → 快捷键展示文案，用于图层工具 title */
     shortcutKeys: {
         type: PropType<Record<string, string>>;
@@ -477,6 +508,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     "onApply-image-pattern"?: ((...args: any[]) => any) | undefined;
     "onUpdate-image-pattern-scale"?: ((...args: any[]) => any) | undefined;
     "onCrop-layer"?: ((...args: any[]) => any) | undefined;
+    "onRemove-bg-layer"?: ((...args: any[]) => any) | undefined;
     "onUpdate:activeTab"?: ((...args: any[]) => any) | undefined;
     "onUpdate:urlInput"?: ((...args: any[]) => any) | undefined;
     "onUpdate:selectedProductIndex"?: ((...args: any[]) => any) | undefined;
@@ -532,6 +564,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     imagePatternScale: number;
     imagePatternScaleEnabled: boolean;
     cropMode: boolean;
+    activeLayerIsImage: boolean;
+    removeBgProcessing: boolean;
+    showBackgroundRemove: boolean;
     visibleTabs: string[];
     showNav: boolean;
     productTotal: number;

package/dist/components/Editor/components/Theme1UploadPanel.vue.d.ts

@@ -40,6 +40,21 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 当前选中图层是否为图片（控制抠图按钮显示） */
+    activeLayerIsImage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 抠图处理中：按钮 disabled + loading */
+    removeBgProcessing: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否显示「自动抠图」按钮（默认隐藏；第三方需显式开启） */
+    showBackgroundRemove: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "move-layer-by-id": (...args: any[]) => void;
     "duplicate-layer": (...args: any[]) => void;
@@ -52,6 +67,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     "apply-image-pattern": (...args: any[]) => void;
     "update-image-pattern-scale": (...args: any[]) => void;
     "crop-layer": (...args: any[]) => void;
+    "remove-bg-layer": (...args: any[]) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     readOnly: {
         type: BooleanConstructor;
@@ -93,6 +109,21 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 当前选中图层是否为图片（控制抠图按钮显示） */
+    activeLayerIsImage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 抠图处理中：按钮 disabled + loading */
+    removeBgProcessing: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否显示「自动抠图」按钮（默认隐藏；第三方需显式开启） */
+    showBackgroundRemove: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>> & Readonly<{
     "onMove-layer-by-id"?: ((...args: any[]) => any) | undefined;
     "onDuplicate-layer"?: ((...args: any[]) => any) | undefined;
@@ -105,6 +136,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     "onApply-image-pattern"?: ((...args: any[]) => any) | undefined;
     "onUpdate-image-pattern-scale"?: ((...args: any[]) => any) | undefined;
     "onCrop-layer"?: ((...args: any[]) => any) | undefined;
+    "onRemove-bg-layer"?: ((...args: any[]) => any) | undefined;
 }>, {
     activeLayerId: string | number | null;
     readOnly: boolean;
@@ -116,5 +148,8 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     imagePatternScale: number;
     imagePatternScaleEnabled: boolean;
     cropMode: boolean;
+    activeLayerIsImage: boolean;
+    removeBgProcessing: boolean;
+    showBackgroundRemove: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/Editor/composables/useBackgroundRemoval.d.ts

@@ -0,0 +1,61 @@
+export type RemoveBackgroundProgress = {
+    /** 0-1,模型下载阶段;推理阶段 imgly 不再回调 */
+    ratio: number;
+    /** 'fetch' | 'compute' */
+    phase: 'fetch' | 'compute';
+    message?: string;
+};
+export interface UseBackgroundRemovalOptions {
+    /**
+     * 模型/wasm 加载基础路径。默认走 @imgly 官方 CDN(staticimgly.com),
+     * 国内可指向本地 public 目录(如 '/imgly/dist/')或自家 OSS。
+     * 相对路径会按当前 origin 解析为绝对 URL,确保 imgly 的 `new URL(chunk, publicPath)` 拼接成功。
+     */
+    publicPath?: string;
+    /**
+     * 模型变体。imgly 1.7.0 默认 'isnet_fp16'(84MB)。本地化场景默认 'isnet_quint8'(42MB,质量略低但体积小一半)。
+     */
+    model?: 'isnet' | 'isnet_fp16' | 'isnet_quint8';
+    /**
+     * 客户端模式:@imgly ESM 运行时的加载 URL(默认 jsdelivr CDN)。
+     * 关键:通过 `import(/* @vite-ignore *​/ url)` 运行时加载,**ort 运行时不会被打进 SDK 包**(包体 -125MB)。
+     * 自建场景可指向自家 CDN/OSS 上托管的 @imgly ESM 产物。
+     */
+    cdnUrl?: string;
+    /**
+     * 服务端抠图提供者。**传入则用它替代客户端 ONNX 推理**——不加载 @imgly、不跑本地模型,SDK 最轻。
+     * 入参为原图 Blob,返回去背景后的图(Blob 或可 fetch 的 URL)。
+     */
+    provider?: (input: Blob) => Promise<Blob | string>;
+}
+export type OpaqueBoundingBox = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/**
+ * 扫描透明通道,把图像裁切到 alpha>0 像素的外接矩形。
+ * - 全透明:返回 null
+ * - bbox 已接近全图:返回 fullSize=true
+ */
+export declare function cropBlobToOpaqueBoundingBox(blob: Blob, alphaThreshold?: number): Promise<{
+    blob: Blob;
+    bbox: OpaqueBoundingBox;
+    fullSize: boolean;
+} | null>;
+export declare function useBackgroundRemoval(options?: UseBackgroundRemovalOptions): {
+    isProcessing: import("vue").Ref<boolean, boolean>;
+    lastError: import("vue").Ref<string | null, string | null>;
+    progress: import("vue").Ref<{
+        ratio: number;
+        phase: "fetch" | "compute";
+        message?: string | undefined;
+    } | null, RemoveBackgroundProgress | {
+        ratio: number;
+        phase: "fetch" | "compute";
+        message?: string | undefined;
+    } | null>;
+    modelLoaded: import("vue").Ref<boolean, boolean>;
+    removeBackground: (input: Blob | string) => Promise<Blob | null>;
+};

package/dist/components/Editor/composables/useBrushRefine.d.ts

@@ -0,0 +1,31 @@
+export type BrushMode = 'erase' | 'restore';
+export interface UseBrushRefineOptions {
+    /** Fabric Canvas 实例提供者 */
+    getCanvas: () => any | null;
+    /**
+     * 退出(无论 commit / cancel)时调用,父组件可用于刷新预览等。
+     * 第二个参数为本次涂抹的目标 fabric 对象(退出时其 element 已 commit),
+     * 供父组件做结果图上传 / savedSrc 持久化(此时内部 targetObj 已清空)。
+     */
+    onExit?: (committed: boolean, obj: any | null) => void;
+}
+export declare function useBrushRefine(options: UseBrushRefineOptions): {
+    isActive: import("vue").Ref<boolean, boolean>;
+    brushSize: import("vue").Ref<number, number>;
+    brushMode: import("vue").Ref<BrushMode, BrushMode>;
+    hasSourceImage: import("vue").Ref<boolean, boolean>;
+    strokeEnabled: import("vue").Ref<boolean, boolean>;
+    strokeWidth: import("vue").Ref<number, number>;
+    strokeGap: import("vue").Ref<number, number>;
+    strokeColor: import("vue").Ref<string, string>;
+    targetObj: import("vue").ShallowRef<any, any>;
+    enter: (obj: any, initElement?: HTMLImageElement | HTMLCanvasElement, srcImage?: HTMLImageElement | HTMLCanvasElement | null) => boolean;
+    exit: (commit?: boolean) => Promise<void>;
+    undo: () => void;
+    setBrushSize: (v: number) => void;
+    setBrushMode: (m: BrushMode) => void;
+    setStrokeEnabled: (v: boolean) => void;
+    setStrokeWidth: (v: number) => void;
+    setStrokeGap: (v: number) => void;
+    setStrokeColor: (v: string) => void;
+};