@jetprint/editor-sdk 1.0.5 → 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

@@ -142,7 +142,13 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
      * 给定尺码/颜色集合，返回每张成品效果图 { size, color, index（模板序号）, blob }。
      */
     renderEffectImages: {
-        type: PropType<(sizes: string[], colors: string[]) => Promise<Array<{
+        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;
@@ -175,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<{
@@ -306,7 +313,13 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
      * 给定尺码/颜色集合，返回每张成品效果图 { size, color, index（模板序号）, blob }。
      */
     renderEffectImages: {
-        type: PropType<(sizes: string[], colors: string[]) => Promise<Array<{
+        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;
@@ -331,6 +344,7 @@ 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;
 }>, {
@@ -363,7 +377,13 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     liveWebglInternalRenderSize: number;
     designedSizes: string[];
     isPerSizeDesign: boolean;
-    renderEffectImages: (sizes: string[], colors: string[]) => Promise<Array<{
+    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;

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;