x-print-designer 0.4.7 → 0.4.8

package/dist/web-component.d.ts

@@ -12,6 +12,9 @@ import type {
   LocalPrinterCaps,
   RemoteClientInfo
 } from './composables/usePrintSettings';
+import type { Page } from './types';
+import type { LoopExpandContext } from './utils/loopExpand';
+import type { DefineComponent } from 'vue';
 
 export type EndpointConfig = string | {
   url: string;
@@ -88,9 +91,17 @@ export interface PrintDesignerElement extends HTMLElement {
   refreshTemplates(options?: { includeData?: boolean }): Promise<Array<{ id: string; name: string; updatedAt: number } | any>>;
   getTemplate(id: string): any | null;
   upsertTemplate(template: { id?: string; name: string; data?: any; updatedAt?: number; [key: string]: any }, options?: { setCurrent?: boolean }): Promise<string | null>;
-  setTemplates(templates: Array<{ id: string; name: string; data?: any; updatedAt?: number; [key: string]: any }>, options?: { currentTemplateId?: string }): void;
+  /**
+   * 写入模板列表并加载 currentTemplateId 对应模板。
+   * 返回的 Promise 在 pages 填充完成后 resolve，调用方可据此消除时序竞态。
+   */
+  setTemplates(templates: Array<{ id: string; name: string; data?: any; updatedAt?: number; [key: string]: any }>, options?: { currentTemplateId?: string }): Promise<void>;
   deleteTemplate(id: string, options?: { confirm?: boolean }): Promise<void>;
-  loadTemplate(id: string): boolean;
+  /**
+   * 加载指定模板并填充画布。
+   * @returns Promise<boolean>，resolve 时 pages 已填充；false 表示因前置条件未触发。
+   */
+  loadTemplate(id: string): Promise<boolean>;
 
   getCustomElements(options?: { includeElement?: boolean }): Array<{ id: string; name: string } | any>;
   refreshCustomElements(options?: { includeElement?: boolean }): Promise<Array<{ id: string; name: string } | any>>;
@@ -104,8 +115,21 @@ export interface PrintDesignerElement extends HTMLElement {
   setTemplateTagResolver(resolver: DesignerTemplateTagResolver): void;
   clearTemplateTagResolver(): void;
 
-  setCrudMode(mode: 'local' | 'remote'): void;
+  setCrudMode(mode: 'local' | 'remote', options?: { skipAutoLoad?: boolean }): void;
   setCrudEndpoints(endpoints: CrudEndpoints, options?: { baseUrl?: string; headers?: Record<string, string>; fetcher?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response> }): void;
+
+  /**
+   * 循环页展开：按 page.loopDataVariable + ctx 数组数据，把 1 个模板页展开成 N 个渲染页。
+   * 不传 ctx 时默认使用当前 store 的 testData/variables（按导出语义解析）。
+   */
+  expandLoopPages(pages: Page[], ctx?: LoopExpandContext): Page[];
+  /** 判断页面数组中是否含循环页（任一 page 带 loopDataVariable） */
+  hasLoopPage(pages: Page[] | undefined | null): boolean;
+  /**
+   * 折叠已展开的循环页，还原为带 loopDataVariable 的单个模板页。
+   * 适用于报告模式保存前还原模板结构。
+   */
+  collapseLoopPages(currentPages: Page[], originalTemplatePages: Page[]): Page[];
 }
 
 declare global {
@@ -114,4 +138,33 @@ declare global {
   }
 }
 
+// ============================================================
+// 独立命名导出（src/index.ts）
+// 允许宿主 `import { PreviewPage, expandLoopPages, ... } from 'x-print-designer'`
+// 作为普通 Vue 组件 / 纯函数使用，无需挂载完整 Web Component。
+// ============================================================
+
+/** 轻量预览组件：接收 pages + testData + variables，渲染只读预览（含循环页展开 + report 表格分页） */
+export const PreviewPage: DefineComponent<{
+  autoRender?: boolean;
+  pages?: any[];
+  canvasSize?: { width: number; height: number };
+  canvasBackground?: string;
+  testData?: Record<string, any>;
+  variables?: Record<string, any>;
+  watermark?: any;
+  autoRenderTrigger?: number;
+  mode?: 'template' | 'report';
+  headerHeight?: number;
+  footerHeight?: number;
+  showHeaderLine?: boolean;
+  showFooterLine?: boolean;
+  pageSpacingY?: number;
+}>;
+
+// 循环页展开 / 折叠纯函数
+export function expandLoopPages(pages: Page[], ctx: LoopExpandContext): Page[];
+export function collapseLoopPages(currentPages: Page[], originalTemplatePages: Page[]): Page[];
+export function hasLoopPage(pages: Page[] | undefined | null): boolean;
+
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x-print-designer",
   "private": false,
-  "version": "0.4.7",
+  "version": "0.4.8",
   "license": "AGPL-3.0-only",
   "type": "module",
   "main": "dist/print-designer.umd.js",