@jetprint/editor-sdk 1.2.3 → 1.2.5

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;