@jetprint/editor-sdk 1.2.4 → 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/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/composables/useBackgroundRemoval.d.ts

@@ -13,7 +13,8 @@ export interface UseBackgroundRemovalOptions {
      */
     publicPath?: string;
     /**
-     * 模型变体。imgly 1.7.0 默认 'isnet_fp16'(84MB)。本地化场景默认 'isnet_quint8'(42MB,质量略低但体积小一半)。
+     * 模型变体(@imgly 1.7.0,与本地自托管 data 配套):'isnet_fp16'(84MB,质量最好) / 'isnet_quint8'(42MB,体积小一半) / 'isnet'。
+     * 默认 'isnet_quint8'。
      */
     model?: 'isnet' | 'isnet_fp16' | 'isnet_quint8';
     /**

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 {};

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

@@ -47,6 +47,8 @@ export declare function usePreviewRenderer(options: {
     getEditorAreaWidth?: () => number;
     /** 当前选中尺码，多尺码时使 fabricScreenshotList id 与 psdJson 一致 */
     getSelectedSize?: () => string;
+    /** 特殊设计模式（none|embroidery|pillow3d）。pillow3d 时把设计截图过伪立体效果，作为预览效果图的设计纹理 */
+    getSpecialMode?: () => string;
     saveCanvasState: (diecutId: string) => Promise<void>;
     generateDiecutScreenshot: (diecutId: string, opts?: {
         multiplier?: number;

package/dist/components/Editor/headless/headlessFontLoader.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 确保给定字体族（来自 fabric 文字对象的 fontFamily）已加载完成。
+ * 传空数组则预热全部内置字体。渲染前调用并 await，避免文字用系统兜底字体。
+ */
+export declare function ensureFontsForCanvas(families: string[]): Promise<void>;
+/** 递归收集 fabric 状态对象（含 group 嵌套）里所有文字对象的 fontFamily。 */
+export declare function collectFontFamilies(objects: any[]): string[];

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

@@ -29,6 +29,7 @@ type EditorProps = {
     onAddToCartSuccess?: (payload?: {
         addedCount?: number;
         psTaskCode?: string;
+        psTaskId?: string;
     }) => void;
     onAddToCartError?: (msg?: string) => void;
     onGoHome?: () => void;
@@ -42,15 +43,15 @@ type EditorProps = {
     /** 左侧栏额外 Tab（竖条 + 内容区由宿主传入 Vue 组件） */
     customSidebarTabs?: CustomSidebarTabDef[];
 };
-declare var __VLS_21: {}, __VLS_27: {}, __VLS_137: {}, __VLS_143: {};
+declare var __VLS_22: {}, __VLS_28: {}, __VLS_141: {}, __VLS_147: {};
 type __VLS_Slots = {} & {
-    'topbar-left'?: (props: typeof __VLS_21) => any;
+    'topbar-left'?: (props: typeof __VLS_22) => any;
 } & {
-    'topbar-right'?: (props: typeof __VLS_27) => any;
+    'topbar-right'?: (props: typeof __VLS_28) => any;
 } & {
-    'topbar-left'?: (props: typeof __VLS_137) => any;
+    'topbar-left'?: (props: typeof __VLS_141) => any;
 } & {
-    'topbar-right'?: (props: typeof __VLS_143) => any;
+    'topbar-right'?: (props: typeof __VLS_147) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<EditorProps, {
     renderAllTemplates: () => Promise<Array<{
@@ -172,6 +173,7 @@ declare const __VLS_component: import("vue").DefineComponent<EditorProps, {
     onAddToCartSuccess: (payload?: {
         addedCount?: number;
         psTaskCode?: string;
+        psTaskId?: string;
     }) => void;
     onAddToCartError: (msg?: string) => void;
     messages: Record<string, string>;

package/dist/components/Editor/utils/editorSizeOptions.d.ts

@@ -1,6 +1,12 @@
 /** 编辑器尺码：与刀板里的 "default" 占位一致，大小写不敏感 */
 /** theme1 产品面板「全部」选项值（颜色 / 尺码共用） */
 export declare const SKU_ALL_VALUE = "all";
+/**
+ * 服务端"默认" SKU（尺码/颜色）的规范值——接口对默认 SKU 统一返回大写 `Default`。
+ * SDK 在【空值兜底 / 输出 / 文件命名】处一律用它，杜绝自造小写 `default` 导致与服务端不一致、第三方匹配不上。
+ * 注意：匹配判断仍走大小写不敏感的 isDefaultSkuLabel；本常量只用于"需要产出一个默认值"的场合。
+ */
+export declare const DEFAULT_SKU_VALUE = "Default";
 export declare function isDefaultSizeLabel(s: string): boolean;
 /** 与 isDefaultSizeLabel 同义，供颜色 SKU 复用 */
 export declare const isDefaultSkuLabel: typeof isDefaultSizeLabel;

package/dist/components/Editor/utils/embroideryStitch.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 刺绣 · 针法纹理渲染（节点③）
+ *
+ * 给定一个「色块形状蒙版」(mask，不透明=该色块) + 颜色 + 针法类型，
+ * 生成一张同尺寸 canvas：在整块范围画出该针法的纹理，再裁剪(destination-in)到色块形状内。
+ * 纯 Canvas 2D，纹理是「视觉效果」近似（非真实绣花机针迹）。
+ */
+export type StitchKey = 'satin' | 'fill' | 'running' | 'cross' | 'frenchKnot' | 'bean' | 'zigzag' | 'estitch' | 'tartan' | 'circular' | 'spiral' | 'meander' | 'contour';
+type RGB = [number, number, number];
+export interface StitchParams {
+    /** 针距/纹理密度基准(px)，越小越密；默认按类型取值 */
+    spacing?: number;
+    /** 绣线角度(度)，默认 45 */
+    angle?: number;
+}
+/** 各针法默认针距（与 drawPattern 内的 ?? 值一致），供面板滑块取初值。 */
+export declare const STITCH_DEFAULT_SPACING: Record<StitchKey, number>;
+/** 哪些针法的「角度」有意义（其余用各自固有朝向，角度无效）。 */
+export declare const STITCH_USES_ANGLE: ReadonlyArray<StitchKey>;
+/**
+ * 渲染某色块的针法纹理 canvas：在 mask 范围内画针法，裁剪到 mask 形状。
+ * @param mask 色块形状蒙版（不透明=该色块），决定输出尺寸与裁剪
+ */
+export declare function renderStitchCanvas(mask: HTMLCanvasElement, color: RGB, type: StitchKey, params?: StitchParams): HTMLCanvasElement;
+export {};

package/dist/components/Editor/utils/pillow3dPreview.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 异形抱枕 · 伪立体预览（P3a，仅预览，不改设计）。
+ *
+ * 输入：一张带透明通道的设计图（抠图后的"扣好的图"，其不透明区域即抱枕的异形轮廓）。
+ * 输出：一张「蓬松毛绒抱枕」效果的离屏 canvas，可直接 toDataURL 显示在预览浮层。
+ *
+ * 纯 Canvas 实现（不依赖 Fabric），管线（由下到上）：
+ *   1) 落地投影  —— 轮廓剪影模糊+下移+变暗，模拟悬浮
+ *   2) 主体设计图
+ *   3) 内阴影    —— 形状边缘内侧变暗，模拟收边/厚度
+ *   4) 中心高光  —— 形状中心提亮，模拟蓬起鼓凸
+ * 蓬起的"高度场"用「模糊轮廓再夹回形状内」近似：中心 alpha 高(亮)、边缘 alpha 低(暗)。
+ */
+export interface Pillow3dOptions {
+    /** 画布四周留白（给投影空间），默认按尺寸自适应 */
+    padding?: number;
+    /** 落地投影颜色 */
+    shadowColor?: string;
+    /** 落地投影模糊半径（px） */
+    shadowBlur?: number;
+    /** 落地投影下移（px） */
+    shadowOffsetY?: number;
+    /** 蓬起强度 0~1.5（影响高度场模糊半径与明暗强度），默认 1 */
+    puff?: number;
+    /** 边缘内阴影色（含 alpha） */
+    edgeDark?: string;
+    /** 中心高光色（含 alpha） */
+    centerLight?: string;
+    /** 边缘褶皱 / 布料纹理强度 0~1（噪声布纹，边缘带加强，模拟收边起褶），默认 0.6；0 = 关闭 */
+    wrinkle?: number;
+    /** 剪影圆角半径（px）：把直角等尖角磨圆，更像抱枕。默认按尺寸自适应（≈minSide*0.04）；0 = 不圆角 */
+    cornerRound?: number;
+}
+/**
+ * 生成伪立体抱枕预览。返回离屏 canvas（含投影 padding）。
+ */
+export declare function buildPillow3dPreview(source: HTMLImageElement | HTMLCanvasElement, opts?: Pillow3dOptions): HTMLCanvasElement;

package/dist/components/Editor/workers/embroidery.worker.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 刺绣 · 颜色量化 + 连通域分割 Worker（节点①）
+ *
+ * 输入：一张图的 RGBA 像素 + 目标色数 k。
+ * 流程：rgb→Lab → K-Means(采样加速)聚类到 k 个「绣线色」→ 像素归类 → 连通域分割(并查集,4 邻接) → 区域汇总。
+ * 输出：量化后 RGBA 图 + 色板(k 色) + 区域列表(id/色号/面积/包围盒)。
+ *
+ * 说明：节点①只做"按相近颜色分块 + 可视化"。区域边界简化 → Fabric Path 留到节点②。
+ */
+type RGB = [number, number, number];
+type Lab = [number, number, number];
+interface QuantizeRequest {
+    id: number;
+    type: 'quantize';
+    pixels: ArrayBuffer;
+    width: number;
+    height: number;
+    k: number;
+    /** 面积小于该像素数的区域过滤掉（碎块），默认按总面积自适应 */
+    minRegionArea?: number;
+    /** alpha 阈值，低于则视为透明不参与，默认 128 */
+    alphaThreshold?: number;
+    /** 相邻区域 Lab 色差(ΔE)小于此值则合并，默认 14；越大合并越激进、图层越少 */
+    mergeColorDist?: number;
+}
+interface RegionSummary {
+    id: number;
+    clusterIdx: number;
+    color: RGB;
+    area: number;
+    bbox: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+declare function srgbToLinear(c: number): number;
+declare function rgbToLab(r: number, g: number, b: number): Lab;
+declare function labDist2(a: Lab, b: Lab): number;
+declare function kMeansLab(labs: Lab[], // 参与聚类的样本（已采样）
+rgbs: RGB[], // 与 labs 一一对应的原始 rgb（用于反推中心色）
+k: number, iters?: number): {
+    centersLab: Lab[];
+    centersRgb: RGB[];
+};
+declare function handleQuantize(req: QuantizeRequest): void;