@jetprint/editor-sdk 1.0.4 → 1.0.6

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

@@ -101,6 +101,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 「查看大图」预览（单图大图 / theme1 mockup 画廊）打开时为 true：隐藏选中悬浮键，避免叠在大图上 */
+    previewOverlayOpen: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** default 主题标尺：Fabric 实例（由 Editor 传入） */
     getFabricCanvas: {
         type: PropType<() => FabricCanvas | null>;
@@ -205,6 +210,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 「查看大图」预览（单图大图 / theme1 mockup 画廊）打开时为 true：隐藏选中悬浮键，避免叠在大图上 */
+    previewOverlayOpen: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** default 主题标尺：Fabric 实例（由 Editor 传入） */
     getFabricCanvas: {
         type: PropType<() => FabricCanvas | null>;
@@ -249,5 +259,6 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     copying: boolean;
     loadingDesign: boolean;
     modeSwitchDisabled: boolean;
+    previewOverlayOpen: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

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

@@ -122,6 +122,41 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: NumberConstructor;
         default: number;
     };
+    /** theme1 查看大图：可勾选的具体尺码列表（已去掉 SKU_ALL 等占位） */
+    sizeOptions: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    /** theme1 查看大图：已设计尺码集合（不在此集合且 isPerSizeDesign 时尺码禁用勾选） */
+    designedSizes: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    /** theme1 查看大图：是否按尺码区分设计（COMMON 同版共享时为 false，则不禁用任何尺码） */
+    isPerSizeDesign: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * theme1 查看大图：批量出图方法（来自 index.vue renderEffectImagesForSizesColors）。
+     * 给定尺码/颜色集合，返回每张成品效果图 { size, color, index（模板序号）, blob }。
+     */
+    renderEffectImages: {
+        type: PropType<(sizes: string[], colors: string[], onImage?: (img: {
+            size: string;
+            color: string;
+            index: number;
+            name?: string;
+            blob: Blob;
+        }) => void) => Promise<Array<{
+            size: string;
+            color: string;
+            index: number;
+            name?: string;
+            blob: Blob;
+        }>>>;
+        default: null;
+    };
     theme1LayersExpanded: {
         type: PropType<boolean>;
     };
@@ -146,6 +181,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "toggle-preview-render-mode": (...args: any[]) => void;
     "request-save-design": (...args: any[]) => void;
     "request-add-to-cart": (...args: any[]) => void;
+    "preview-overlay-change": (...args: any[]) => void;
     "update:theme1LayersExpanded": (value: boolean) => void;
     "update:theme1PreviewExpanded": (value: boolean) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -257,6 +293,41 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: NumberConstructor;
         default: number;
     };
+    /** theme1 查看大图：可勾选的具体尺码列表（已去掉 SKU_ALL 等占位） */
+    sizeOptions: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    /** theme1 查看大图：已设计尺码集合（不在此集合且 isPerSizeDesign 时尺码禁用勾选） */
+    designedSizes: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    /** theme1 查看大图：是否按尺码区分设计（COMMON 同版共享时为 false，则不禁用任何尺码） */
+    isPerSizeDesign: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * theme1 查看大图：批量出图方法（来自 index.vue renderEffectImagesForSizesColors）。
+     * 给定尺码/颜色集合，返回每张成品效果图 { size, color, index（模板序号）, blob }。
+     */
+    renderEffectImages: {
+        type: PropType<(sizes: string[], colors: string[], onImage?: (img: {
+            size: string;
+            color: string;
+            index: number;
+            name?: string;
+            blob: Blob;
+        }) => void) => Promise<Array<{
+            size: string;
+            color: string;
+            index: number;
+            name?: string;
+            blob: Blob;
+        }>>>;
+        default: null;
+    };
     theme1LayersExpanded: {
         type: PropType<boolean>;
     };
@@ -273,12 +344,14 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "onToggle-preview-render-mode"?: ((...args: any[]) => any) | undefined;
     "onRequest-save-design"?: ((...args: any[]) => any) | undefined;
     "onRequest-add-to-cart"?: ((...args: any[]) => any) | undefined;
+    "onPreview-overlay-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:theme1LayersExpanded"?: ((value: boolean) => any) | undefined;
     "onUpdate:theme1PreviewExpanded"?: ((value: boolean) => any) | undefined;
 }>, {
     selectedColor: string;
     templateIndex: number;
     selectedSize: string;
+    sizeOptions: string[];
     colorOptions: string[];
     colorLabelByValue: Record<string, string>;
     loadingDesign: boolean;
@@ -302,6 +375,21 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     renderInvalidationKey: string | number;
     useLiveWebglPreview: boolean;
     liveWebglInternalRenderSize: number;
+    designedSizes: string[];
+    isPerSizeDesign: boolean;
+    renderEffectImages: (sizes: string[], colors: string[], onImage?: (img: {
+        size: string;
+        color: string;
+        index: number;
+        name?: string;
+        blob: Blob;
+    }) => void) => Promise<Array<{
+        size: string;
+        color: string;
+        index: number;
+        name?: string;
+        blob: Blob;
+    }>>;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

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

@@ -22,6 +22,7 @@ export interface UseCopyToDiecutsOptions {
         targetJsonMap: Record<string, any>;
         objectIndex: number;
         targetScaleMap?: Record<string, number>;
+        patternScaleMap?: Record<string, number>;
         sourceCenter?: {
             x: number;
             y: number;

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

@@ -0,0 +1,34 @@
+/**
+ * approach B 生产图拼贴（SDK 自包含渲染器内部层）：把每分片印刷位图按 productJson 槽位 cover 拼成生产图。
+ * 移植自手工镜像 editor-preview.html 的 composeProductionImageToBlob(非 fabricDirect 分支)——拼贴层本就稳定无 bug，
+ * 喂入的是真实 SDK 渲染的分片位图。按分片 name 映射(回退 id)，不依赖 guideline 中转。
+ */
+export interface FabricScreenshotItem {
+    id: number | string;
+    name?: string;
+    blob: Blob;
+}
+export interface PartBounds {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface SplitChild {
+    id: number;
+    name: string;
+    bounds: PartBounds;
+}
+export interface ComposeResult {
+    blob: Blob;
+    canvasWidth: number;
+    canvasHeight: number;
+    drawn: string[];
+    skipped: string[];
+}
+export declare function getSplitChildrenWithBounds(layerList: any[], layerName?: string): SplitChild[];
+/**
+ * @param fabricScreenshotList 每分片印刷位图（{id,name,blob}）
+ * @param productJson 生产图布局：{ canvasWidth, canvasHeight?, layerList(含 split 分组 bounds) }
+ */
+export declare function composeProductionImage(fabricScreenshotList: FabricScreenshotItem[], productJson: any, format?: 'png' | 'jpeg'): Promise<ComposeResult>;

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

@@ -0,0 +1,17 @@
+/**
+ * 无头生产图渲染 —— 独立打包入口（自包含：内联 Fabric，不含 Vue/编辑器）。
+ *
+ * 构建产物 `dist/headless.global.js` 暴露 `window.generateProductionImage`，供 Go 切图服务的无头 host 页
+ * 在 chromedp 中加载调用：
+ *   window.generateProductionImage({ fabricJson, productJson, fileToken, size, imageFormat }) → Promise<Blob>
+ *
+ * 是 @jetprint/editor-sdk 包的一部分（随 SDK 版本同步），Go 侧 `npm i @jetprint/editor-sdk` 后 go:embed 此文件即可。
+ */
+import { generateProductionImage, type GenerateProductionImageInput } from './productionRender';
+declare global {
+    interface Window {
+        generateProductionImage?: (input: GenerateProductionImageInput) => Promise<Blob>;
+    }
+}
+export { generateProductionImage };
+export type { GenerateProductionImageInput };

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

@@ -0,0 +1,47 @@
+import { type FabricScreenshotItem } from './composeProductionImage';
+export interface GenerateProductionImageInput {
+    /** 保存的画布 JSON：URL 字符串 或 已解析对象 */
+    fabricJson: string | Record<string, unknown>;
+    /** 生产图布局 JSON：URL 字符串 或 已解析对象 */
+    productJson: string | Record<string, unknown>;
+    /** 资源访问 token（拼到 img.r480.cn 等资源 URL） */
+    fileToken?: string;
+    /** 要渲染的尺码（多尺码必传；旧单尺码/COMMON 可空） */
+    size?: string;
+    /** 输出格式，默认 png */
+    imageFormat?: 'png' | 'jpeg';
+    /**
+     * 调试：整稿还原模式（复用旧 ?fabric_direct=1 链路）。true 时每分片只做 fabric 还原，
+     * 跳过刀模 MASK 与裁切，按分片画布原样拼贴 —— 用于在切图前核对图层还原是否正确。
+     */
+    fabricDirect?: boolean;
+}
+/** 一个待渲染分片：设计状态 + 该分片保存时画布尺寸 + 刀模/引导信息 */
+export interface DiecutPieceRenderTask {
+    /** 分片 groupId（与 productJson 槽位按 name/id 对应） */
+    groupId: string;
+    name: string;
+    /** 该分片的设计状态（fabric stateMap entry：{version, objects, ...}） */
+    state: Record<string, unknown>;
+    /** 该分片保存时的画布逻辑宽高（新格式每分片自带；旧格式回退顶层/默认） */
+    savedCanvasW: number;
+    savedCanvasH: number;
+    /** 该分片对应的刀模资源（MASK / DOTTED_LINE 等，含 url/width/height） */
+    resources: any[];
+    /** 该尺码刀模模板的 guideline（PSD 结构，含 split 分片 bounds），用于裁切几何 */
+    guideline: any;
+}
+/**
+ * 解析 fabricJson 并按 size 取该尺码各分片的渲染任务。兼容新/旧格式：
+ * - stateMap 键：新=`${groupId}::${size}` 复合键；旧=裸 `${groupId}`（单尺码）。
+ * - 每分片画布尺寸：新=entry.designCanvasSize/Height；旧=回退顶层 designCanvasSize/Height，再回退默认。
+ * - data[]：按 size 取该尺码的刀模模板（含内联 guideline 与 resources）；旧=default/COMMON。
+ */
+export declare function resolveSizePieceTasks(fabric: any, mode: 'COMPLETE' | 'SPLIT', size?: string): DiecutPieceRenderTask[];
+/**
+ * 每个分片离屏还原 → 应用刀模 mask → 裁切 → 印刷位图。复用 SDK 真实渲染核心（PatternLayer）+ 每分片画布尺寸（免缩放）。
+ * 注：当前为 SPLIT 单片路径（每 task=一分片）。COMPLETE 单稿→多分片裁切为下一步。
+ */
+export declare function renderDiecutPieceBitmaps(tasks: DiecutPieceRenderTask[], fileToken?: string, restoreOnly?: boolean): Promise<FabricScreenshotItem[]>;
+/** 自包含生产图：解析 → 每分片渲染 → productJson 拼贴。 */
+export declare function generateProductionImage(input: GenerateProductionImageInput): Promise<Blob>;

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

@@ -42,15 +42,15 @@ type EditorProps = {
     /** 左侧栏额外 Tab（竖条 + 内容区由宿主传入 Vue 组件） */
     customSidebarTabs?: CustomSidebarTabDef[];
 };
-declare var __VLS_21: {}, __VLS_27: {}, __VLS_134: {}, __VLS_140: {};
+declare var __VLS_21: {}, __VLS_27: {}, __VLS_135: {}, __VLS_141: {};
 type __VLS_Slots = {} & {
     'topbar-left'?: (props: typeof __VLS_21) => any;
 } & {
     'topbar-right'?: (props: typeof __VLS_27) => any;
 } & {
-    'topbar-left'?: (props: typeof __VLS_134) => any;
+    'topbar-left'?: (props: typeof __VLS_135) => any;
 } & {
-    'topbar-right'?: (props: typeof __VLS_140) => any;
+    'topbar-right'?: (props: typeof __VLS_141) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<EditorProps, {
     renderAllTemplates: () => Promise<Array<{
@@ -66,7 +66,13 @@ declare const __VLS_component: import("vue").DefineComponent<EditorProps, {
         color: string;
         bundle: any;
     }>>;
-    renderEffectImagesForSizesColors: (sizes?: string[], colors?: string[]) => Promise<Array<{
+    renderEffectImagesForSizesColors: (sizes?: string[], colors?: string[], onImage?: (img: {
+        size: string;
+        color: string;
+        index: number;
+        name?: string;
+        blob: Blob;
+    }) => void) => Promise<Array<{
         size: string;
         color: string;
         index: number;

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

@@ -8,6 +8,8 @@ type CopyDiecutsWorkerRequest = {
     targetJsonMap: Record<string, any>;
     objectIndex: number;
     targetScaleMap?: Record<string, number>;
+    /** 平铺专用：每个目标分片的「最长边比例」(源最长边/目标最长边)，平铺 rect 的瓦片+cover 按此缩放（物理一致） */
+    patternScaleMap?: Record<string, number>;
     /** 源分片在画布上 contain-fit 矩形中心；与 targetCenterMap 配合按"在分片内的相对位置"映射 */
     sourceCenter?: Vec2;
     /** 各目标分片在画布上 contain-fit 矩形中心 */
@@ -20,7 +22,7 @@ type CopyDiecutsWorkerRequest = {
  * - 缩放保持原 contain-fit 比例换算（scaleFactor）。
  * - 位置按"在源分片内的相对位置"映射到目标分片对应位置（sourceCenter → targetCenter）。
  */
-declare const cloneForCopy: (obj: any, startId: number, scaleFactor: number, sourceCenter?: Vec2, targetCenter?: Vec2) => {
+declare const cloneForCopy: (obj: any, startId: number, scaleFactor: number, sourceCenter?: Vec2, targetCenter?: Vec2, patternFactor?: number) => {
     cloned: any;
     nextId: number;
 };

package/dist/copyDiecuts.worker.js

@@ -1,67 +1,77 @@
-const B = (t, i, s, c, r) => {
-  const n = JSON.parse(JSON.stringify(t));
-  n.customData || (n.customData = {}), n.customData.id = i;
-  const a = C(n), f = (a.minL + a.maxR) / 2, l = (a.minT + a.maxB) / 2, o = !!n.customData?.isPatternRect;
-  if (s !== 1 && !o && (n.scaleX = (n.scaleX ?? 1) * s, n.scaleY = (n.scaleY ?? 1) * s), c && r) {
-    const e = C(n), x = (e.minL + e.maxR) / 2, g = (e.minT + e.maxB) / 2, p = r.x + (f - c.x) * s, y = r.y + (l - c.y) * s;
-    n.left = (n.left ?? 0) + p - x, n.top = (n.top ?? 0) + y - g;
+const D = (e, l, i, o, f, r = 1) => {
+  const t = JSON.parse(JSON.stringify(e));
+  t.customData || (t.customData = {}), t.customData.id = l;
+  const m = T(t), h = (m.minL + m.maxR) / 2, a = (m.minT + m.maxB) / 2, n = !!t.customData?.isPatternRect, p = n ? r : i;
+  if (!n)
+    i !== 1 && (t.scaleX = (t.scaleX ?? 1) * i, t.scaleY = (t.scaleY ?? 1) * i);
+  else if (r !== 1) {
+    const s = t.customData;
+    Number(s.patternTileWidth) > 0 && (s.patternTileWidth = Number(s.patternTileWidth) * r), Number(s.patternTileHeight) > 0 && (s.patternTileHeight = Number(s.patternTileHeight) * r), Number(t.width) > 0 && (t.width = Number(t.width) * r), Number(t.height) > 0 && (t.height = Number(t.height) * r);
   }
-  return { cloned: n, nextId: i + 1 };
-}, A = (t) => t === "left" || t === "top" ? -0.5 : t === "center" ? 0 : t === "right" || t === "bottom" ? 0.5 : 0, C = (t) => {
-  const i = t.left ?? 0, s = t.top ?? 0, c = (t.width ?? 0) * (t.scaleX ?? 1), r = (t.height ?? 0) * (t.scaleY ?? 1), a = (t.angle ?? 0) * Math.PI / 180, f = Math.cos(a), l = Math.sin(a), o = -A(t.originX ?? "left") * c, e = -A(t.originY ?? "top") * r, x = i + o * f - e * l, g = s + o * l + e * f, p = c / 2, y = r / 2, d = [-p, p].flatMap(
-    (m) => [-y, y].map((M) => ({
-      x: x + m * f - M * l,
-      y: g + m * l + M * f
+  if (o && f) {
+    const s = T(t), d = (s.minL + s.maxR) / 2, y = (s.minT + s.maxB) / 2, g = f.x + (h - o.x) * p, u = f.y + (a - o.y) * p;
+    if (t.left = (t.left ?? 0) + g - d, t.top = (t.top ?? 0) + u - y, n && t.customData) {
+      const c = t.customData;
+      typeof c.patternPhaseX == "number" && (c.patternPhaseX = f.x + (c.patternPhaseX - o.x) * p), typeof c.patternPhaseY == "number" && (c.patternPhaseY = f.y + (c.patternPhaseY - o.y) * p);
+    }
+  }
+  return { cloned: t, nextId: l + 1 };
+}, M = (e) => e === "left" || e === "top" ? -0.5 : e === "center" ? 0 : e === "right" || e === "bottom" ? 0.5 : 0, T = (e) => {
+  const l = e.left ?? 0, i = e.top ?? 0, o = (e.width ?? 0) * (e.scaleX ?? 1), f = (e.height ?? 0) * (e.scaleY ?? 1), t = (e.angle ?? 0) * Math.PI / 180, m = Math.cos(t), h = Math.sin(t), a = -M(e.originX ?? "left") * o, n = -M(e.originY ?? "top") * f, p = l + a * m - n * h, s = i + a * h + n * m, d = o / 2, y = f / 2, g = [-d, d].flatMap(
+    (x) => [-y, y].map((N) => ({
+      x: p + x * m - N * h,
+      y: s + x * h + N * m
     }))
   );
-  let h = 1 / 0, u = 1 / 0, b = -1 / 0, I = -1 / 0;
-  for (const m of d)
-    m.x < h && (h = m.x), m.y < u && (u = m.y), m.x > b && (b = m.x), m.y > I && (I = m.y);
-  return { minL: h, minT: u, maxR: b, maxB: I };
-}, O = (t, i, s) => {
-  if (!t.length) return;
-  let c = 1 / 0, r = 1 / 0, n = -1 / 0, a = -1 / 0;
-  for (const o of t) {
-    const e = C(o);
-    e.minL < c && (c = e.minL), e.minT < r && (r = e.minT), e.maxR > n && (n = e.maxR), e.maxB > a && (a = e.maxB);
+  let u = 1 / 0, c = 1 / 0, I = -1 / 0, b = -1 / 0;
+  for (const x of g)
+    x.x < u && (u = x.x), x.y < c && (c = x.y), x.x > I && (I = x.x), x.y > b && (b = x.y);
+  return { minL: u, minT: c, maxR: I, maxB: b };
+}, P = (e, l, i) => {
+  if (!e.length) return;
+  let o = 1 / 0, f = 1 / 0, r = -1 / 0, t = -1 / 0;
+  for (const a of e) {
+    const n = T(a);
+    n.minL < o && (o = n.minL), n.minT < f && (f = n.minT), n.maxR > r && (r = n.maxR), n.maxB > t && (t = n.maxB);
   }
-  const f = i - (c + n) / 2, l = s - (r + a) / 2;
-  for (const o of t)
-    o.left = (o.left ?? 0) + f, o.top = (o.top ?? 0) + l;
-}, R = (t) => {
+  const m = l - (o + r) / 2, h = i - (f + t) / 2;
+  for (const a of e)
+    a.left = (a.left ?? 0) + m, a.top = (a.top ?? 0) + h;
+}, w = (e) => {
   const {
-    sourceObjects: i,
-    targetJsonMap: s,
-    objectIndex: c,
-    targetScaleMap: r,
-    sourceCenter: n,
-    targetCenterMap: a,
-    canvasCenter: f
-  } = t;
-  let l = Number.isFinite(c) ? c : 1;
-  const o = {};
-  return Object.entries(s || {}).forEach(([e, x]) => {
-    const g = Array.isArray(x?.objects) ? x.objects : [], p = r?.[e] ?? 1, y = a?.[e], d = [];
-    i.forEach((h) => {
-      const u = B(h, l, p, n, y);
-      d.push(u.cloned), l = u.nextId;
-    }), (!n || !y) && f && d.length && O(d, f.x, f.y), o[e] = { ...x, objects: [...g, ...d] };
-  }), { updates: o, nextObjectIndex: l };
+    sourceObjects: l,
+    targetJsonMap: i,
+    objectIndex: o,
+    targetScaleMap: f,
+    patternScaleMap: r,
+    sourceCenter: t,
+    targetCenterMap: m,
+    canvasCenter: h
+  } = e;
+  let a = Number.isFinite(o) ? o : 1;
+  const n = {};
+  return Object.entries(i || {}).forEach(([p, s]) => {
+    const d = Array.isArray(s?.objects) ? s.objects : [], y = f?.[p] ?? 1, g = r?.[p] ?? 1, u = m?.[p], c = [];
+    l.forEach((I) => {
+      const b = D(I, a, y, t, u, g);
+      c.push(b.cloned), a = b.nextId;
+    }), (!t || !u) && h && c.length && P(c, h.x, h.y), n[p] = { ...s, objects: [...d, ...c] };
+  }), { updates: n, nextObjectIndex: a };
 };
-self.onmessage = (t) => {
-  const i = t.data;
+self.onmessage = (e) => {
+  const l = e.data;
   try {
-    const s = R(i);
+    const i = w(l);
     self.postMessage({
-      id: i.id,
+      id: l.id,
       ok: !0,
-      data: s
+      data: i
     });
-  } catch (s) {
+  } catch (i) {
     self.postMessage({
-      id: i.id,
+      id: l.id,
       ok: !1,
-      error: s instanceof Error ? s.message : String(s)
+      error: i instanceof Error ? i.message : String(i)
     });
   }
 };