@jetprint/editor-sdk 1.2.3 → 1.2.5

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

@@ -12,6 +12,7 @@ type __VLS_Props = {
     onSuccess?: (payload?: {
         addedCount?: number;
         psTaskCode?: string;
+        psTaskId?: string;
     }) => void;
 };
 type __VLS_PublicProps = __VLS_Props & {

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/EditorTopbar.vue.d.ts

@@ -16,6 +16,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 特殊设计模式受控值：none|embroidery(刺绣)|pillow3d(异形抱枕)，由父组件 specialMode 传入 */
+    specialMode: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 是否显示「刺绣 / 异形抱枕」互斥模式开关（default 与 theme1 均可显示） */
+    showSpecialMode: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     colorOptions: {
         type: PropType<string[]>;
         default: () => never[];
@@ -154,6 +164,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "toggle-grid": (...args: any[]) => void;
     "clear-canvas": (...args: any[]) => void;
     "clear-guides": (...args: any[]) => void;
+    "update:special-mode": (...args: any[]) => void;
     "download-png": (...args: any[]) => void;
     "switch-to-gallery": (...args: any[]) => void;
     "open-shortcuts": (...args: any[]) => void;
@@ -174,6 +185,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 特殊设计模式受控值：none|embroidery(刺绣)|pillow3d(异形抱枕)，由父组件 specialMode 传入 */
+    specialMode: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 是否显示「刺绣 / 异形抱枕」互斥模式开关（default 与 theme1 均可显示） */
+    showSpecialMode: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     colorOptions: {
         type: PropType<string[]>;
         default: () => never[];
@@ -312,6 +333,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "onToggle-grid"?: ((...args: any[]) => any) | undefined;
     "onClear-canvas"?: ((...args: any[]) => any) | undefined;
     "onClear-guides"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:special-mode"?: ((...args: any[]) => any) | undefined;
     "onDownload-png"?: ((...args: any[]) => any) | undefined;
     "onSwitch-to-gallery"?: ((...args: any[]) => any) | undefined;
     "onOpen-shortcuts"?: ((...args: any[]) => any) | undefined;
@@ -330,6 +352,8 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     sizeOptions: string[];
     colorOptions: string[];
     productName: string;
+    specialMode: string;
+    showSpecialMode: boolean;
     colorLabelByValue: Record<string, string>;
     multiSku: boolean;
     selectedColors: string[];

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

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    /** useEmbroidery() 的返回对象 */
+    embroidery: any;
+    variant?: 'default' | 'theme1';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: "default" | "theme1";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -364,6 +364,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     sizeOptions: string[];
     colorOptions: string[];
     colorLabelByValue: Record<string, string>;
+    variant: "default" | "theme1";
     loadingDesign: boolean;
     renderData: IRenderByJson | null;
     previewTitle: string;
@@ -378,7 +379,6 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     getAllDiecutFabricData: () => Promise<Record<string, unknown>>;
     usePreviewEffect: boolean;
     showDownloadButton: boolean;
-    variant: "default" | "theme1";
     mockupShowSave: boolean;
     mockupShowCart: boolean;
     backgroundRenderPaused: boolean;

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,62 @@
+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,与本地自托管 data 配套):'isnet_fp16'(84MB,质量最好) / 'isnet_quint8'(42MB,体积小一半) / 'isnet'。
+     * 默认 'isnet_quint8'。
+     */
+    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;
+};

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

@@ -22,6 +22,14 @@ export interface CanvasStateOptions {
     getSelectedSize?: () => string;
     /** 加载 JSON 完成后调用，用于从 customData 重建图案矩形 fill（Fabric 序列化会丢失 Pattern source） */
     afterLoadCanvasJson?: (canvas: any) => void | Promise<void>;
+    /**
+     * restore（loadFromJSON）完成、onDone 末尾触发：按存档画布尺寸重算对象坐标到当前画布尺寸。
+     * 参数 savedCanvasWidth = 存档时的画布逻辑宽度（state.designCanvasSize）。
+     * 根因：存档 json 无原生 width/height，loadFromJSON 不改画布尺寸（画布尺寸由容器决定），
+     * 故 objects 的 left/top（存档尺寸下的绝对像素）与「当前容器尺寸」画布不匹配 → 整体平移。
+     * 详见 viewport-restore-realign-design.md。
+     */
+    onAfterRestore?: (savedCanvasWidth: number) => void | Promise<void>;
     /** 将 HTTP 图片 URL 解析为 blob URL（通过 fetchWithFileToken 加载），用于 loadFromJSON 前预处理 */
     resolveImageUrl?: (url: string) => Promise<string>;
 }

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

@@ -70,6 +70,7 @@ export declare function useCanvasViewport(options: CanvasViewportOptions): {
     zoomOut: () => void;
     fitCanvas: () => void;
     handleWrapResize: () => void;
+    rescaleObjectsFromSavedSize: (savedWidth: number) => void;
     refreshGuideResourcesCentered: () => void;
     setupWindowResize: () => void;
     removeWindowResize: () => void;

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

@@ -0,0 +1,57 @@
+import { type StitchKey } from '../utils/embroideryStitch';
+type RGB = [number, number, number];
+export interface EmbroideryRegion {
+    id: number;
+    clusterIdx: number;
+    color: RGB;
+    area: number;
+    bbox: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+export type EmbroideryStitchKey = StitchKey;
+/** 针法清单（移植自 Ink/Stitch 可纹理化的部分）。 */
+export declare const EMBROIDERY_STITCH_TYPES: ReadonlyArray<{
+    key: EmbroideryStitchKey;
+    label: string;
+}>;
+export interface UseEmbroideryOptions {
+    /** 取 Fabric 画布实例 */
+    getCanvas: () => any;
+    /** 工作尺寸上限（长边像素），超过则缩放后处理，默认 1000 */
+    maxWorkSize?: number;
+}
+export declare function useEmbroidery(options: UseEmbroideryOptions): {
+    isActive: import("vue").Ref<boolean, boolean>;
+    isProcessing: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<string | null, string | null>;
+    colorCount: import("vue").Ref<number, number>;
+    mergeColorDist: import("vue").Ref<number, number>;
+    palette: import("vue").Ref<[number, number, number][], RGB[] | [number, number, number][]>;
+    regions: import("vue").ShallowRef<EmbroideryRegion[], EmbroideryRegion[]>;
+    regionCount: import("vue").Ref<number, number>;
+    regionStitch: import("vue").Ref<Record<number, StitchKey>, Record<number, StitchKey>>;
+    regionParams: import("vue").Ref<Record<number, {
+        spacing?: number;
+        angle?: number;
+    }>, Record<number, {
+        spacing?: number;
+        angle?: number;
+    }>>;
+    selectedRegionId: import("vue").Ref<number | null, number | null>;
+    activate: () => Promise<boolean>;
+    deactivate: () => Promise<void>;
+    setColorCount: (k: number) => Promise<void>;
+    selectRegion: (regionId: number) => void;
+    setRegionStitch: (regionId: number, type: EmbroideryStitchKey) => void;
+    setRegionParams: (regionId: number, patch: {
+        spacing?: number;
+        angle?: number;
+    }) => void;
+    getEmbroideryData: () => Record<string, unknown> | null;
+    dispose: () => void;
+};
+export {};