@jetprint/editor-sdk 1.2.5 → 1.2.7

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

@@ -30,5 +30,6 @@ export declare function getSplitChildrenWithBounds(layerList: any[], layerName?:
 /**
  * @param fabricScreenshotList 每分片印刷位图（{id,name,blob}）
  * @param productJson 生产图布局：{ canvasWidth, canvasHeight?, layerList(含 split 分组 bounds) }
+ * @param typeModel 设计模式：'pillow3d' 时每分片沿轮廓描 5px 红边（异形抱枕裁切引导线）
  */
-export declare function composeProductionImage(fabricScreenshotList: FabricScreenshotItem[], productJson: any, format?: 'png' | 'jpeg'): Promise<ComposeResult>;
+export declare function composeProductionImage(fabricScreenshotList: FabricScreenshotItem[], productJson: any, format?: 'png' | 'jpeg', typeModel?: string): Promise<ComposeResult>;

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

@@ -8,10 +8,13 @@
  * 是 @jetprint/editor-sdk 包的一部分（随 SDK 版本同步），Go 侧 `npm i @jetprint/editor-sdk` 后 go:embed 此文件即可。
  */
 import { generateProductionImage, type GenerateProductionImageInput } from './productionRender';
+import { generateEmbroideryStitches, type GenerateEmbroideryStitchesInput, type EmbroideryStitchResult } from './productionRender';
 declare global {
     interface Window {
         generateProductionImage?: (input: GenerateProductionImageInput) => Promise<Blob>;
+        /** 刺绣针迹生成（typeModel=embroidery）：返回各色块机器针迹坐标，供 Go 写 DST/PES */
+        generateEmbroideryStitches?: (input: GenerateEmbroideryStitchesInput) => Promise<EmbroideryStitchResult>;
     }
 }
-export { generateProductionImage };
-export type { GenerateProductionImageInput };
+export { generateProductionImage, generateEmbroideryStitches };
+export type { GenerateProductionImageInput, GenerateEmbroideryStitchesInput, EmbroideryStitchResult };

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

@@ -45,3 +45,38 @@ export declare function resolveSizePieceTasks(fabric: any, mode: 'COMPLETE' | 'S
 export declare function renderDiecutPieceBitmaps(tasks: DiecutPieceRenderTask[], fileToken?: string, restoreOnly?: boolean): Promise<FabricScreenshotItem[]>;
 /** 自包含生产图：解析 → 每分片渲染 → productJson 拼贴。 */
 export declare function generateProductionImage(input: GenerateProductionImageInput): Promise<Blob>;
+export interface GenerateEmbroideryStitchesInput {
+    /** 保存的画布 JSON（含 typeModel='embroidery' + embroidery 数据）：URL 或对象 */
+    fabricJson: string | Record<string, unknown>;
+    /** 资源访问 token */
+    fileToken?: string;
+}
+export interface EmbroideryStitchColor {
+    /** 该色块绣线色 */
+    color: [number, number, number];
+    /** 针法类型 */
+    stitchType: string;
+    /** 针距(px,工作坐标系) */
+    spacing: number;
+    /** 角度(度) */
+    angle: number;
+    /** 有序落针点(工作坐标系,px)；空段由后端按距离插跳针 */
+    stitches: Array<[number, number]>;
+}
+export interface EmbroideryStitchResult {
+    /** 工作坐标系尺寸(px)——与 stitches 坐标同系 */
+    width: number;
+    height: number;
+    /** 原图来源 */
+    sourceSrc: string;
+    /** 量化参数(后端可据此复现) */
+    colorCount: number;
+    mergeColorDist: number;
+    /** 按缝制/换线顺序的色块针迹 */
+    colors: EmbroideryStitchColor[];
+}
+/**
+ * 自包含刺绣针迹：解析 embroidery 数据 → 载原图按 maxWorkSize 量化(与编辑器同算法,确定性) →
+ * 按颜色匹配存档色块的针法/针距/角度 → 逐色块生成机器针迹坐标。Go 拿到后写 DST/PES。
+ */
+export declare function generateEmbroideryStitches(input: GenerateEmbroideryStitchesInput): Promise<EmbroideryStitchResult>;

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

@@ -0,0 +1,47 @@
+/**
+ * 刺绣 · 颜色量化内核（共享模块，无 Worker / 无 DOM 依赖）
+ *
+ * 从 embroidery.worker.ts 抽出，供：① 编辑器 Worker（分块预览）② 无头渲染 generateEmbroideryStitches（出针迹）共用。
+ * 算法确定性（K-Means++ 用黄金比散列初始化，无随机）→ 后端用相同 colorCount/mergeColorDist 重量化得到**完全相同**的色块。
+ *
+ * 流程：rgb→Lab → K-Means 聚类到 k 个「绣线色」→ 全图归类 → 调色板相近色合并(union-find, Lab ΔE) → 每像素颜色组 id + 组汇总。
+ */
+export type RGB = [number, number, number];
+export type Lab = [number, number, number];
+export interface QuantizeOptions {
+    /** 目标色数（K-Means 簇数） */
+    k: number;
+    /** 面积小于该像素数的颜色组过滤掉，默认按总面积自适应 max(16, total*0.0004) */
+    minRegionArea?: number;
+    /** alpha 阈值，低于则视为透明不参与，默认 128 */
+    alphaThreshold?: number;
+    /** 相邻调色板颜色 Lab 色差(ΔE) 小于此则合并为同一组，默认 14 */
+    mergeColorDist?: number;
+}
+export interface QuantizeRegion {
+    id: number;
+    color: RGB;
+    area: number;
+    bbox: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+export interface QuantizeResult {
+    width: number;
+    height: number;
+    /** 每像素颜色组 id（-1=透明/被过滤）；length = width*height */
+    regionIds: Int32Array;
+    /** 颜色组列表（已过滤极小组），按 id 升序 */
+    regions: QuantizeRegion[];
+    /** K-Means 色板（k 个绣线色，合并前） */
+    palette: RGB[];
+}
+export declare function rgbToLab(r: number, g: number, b: number): Lab;
+/**
+ * 对一张 RGBA 图量化分块。输入像素 + 尺寸 + 选项，输出每像素颜色组 id 与组汇总。
+ * @param pixels RGBA Uint8ClampedArray（length = width*height*4）
+ */
+export declare function quantizeImage(pixels: Uint8ClampedArray, width: number, height: number, options: QuantizeOptions): QuantizeResult;

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

@@ -0,0 +1,41 @@
+/**
+ * 刺绣 · 针迹路径生成（机器针迹，非视觉纹理）
+ *
+ * 给定量化后的「每像素颜色组 id」(regionIds) + 某颜色组 id + 针法类型 + 针距/角度，
+ * 生成该色块的**真实针迹坐标序列**（工作坐标系，单位=像素），供后端写 DST/PES。
+ *
+ * 与 embroideryStitch.ts（视觉纹理）不同：这里产出的是「每一针的落针点」，机器照此走针。
+ * 13 种针法按几何族实现：
+ *  - 扫描线填充族 fill/tartan/zigzag/estitch/meander → 平行线往返填充
+ *  - 缎面 satin                                      → 密集扫描线
+ *  - 走线/轮廓族 running/bean                         → 外轮廓追踪（bean 三重）
+ *  - 同心族 contour/circular                          → 同心内缩轮廓
+ *  - 图元族 cross/frenchKnot/spiral                   → 网格图元 / 螺旋
+ */
+import type { StitchKey } from './embroideryStitch';
+export type Point = [number, number];
+export interface RegionStitchOptions {
+    regionIds: Int32Array;
+    width: number;
+    height: number;
+    /** 目标颜色组 id（regionIds 中等于它的像素=该色块） */
+    targetId: number;
+    /** 色块包围盒（来自量化 regions），缩小遍历范围 */
+    bbox: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    stitchType: StitchKey;
+    /** 针距（px）；默认按针法取 STITCH_DEFAULT_SPACING */
+    spacing: number;
+    /** 角度（度），仅 fill/satin/running/bean 有意义 */
+    angle: number;
+    /** 单针最大步长（px），长于此在填充线上细分落针。默认 = max(2.5, spacing*0.6) */
+    stitchLen?: number;
+}
+/**
+ * 生成某色块的针迹序列（工作坐标系落针点）。空段由后端按距离插跳针。
+ */
+export declare function generateRegionStitches(o: RegionStitchOptions): Point[];