@gct-paas/word 0.1.13 → 0.1.15

package/dist/core/view/TableRow.d.ts

@@ -3,10 +3,12 @@ import { Table } from './Table';
 import { TableCell } from './TableCell';
 import { Wtr } from '../model/document';
 export interface TableRowOptions extends LayoutGroupOptions {
+    allowRowSplit?: boolean;
 }
 export declare class TableRow extends LayoutGroup<TableCell> {
     component: "tableRow";
     parent: Table;
+    allowRowSplit: boolean;
     constructor(options: TableRowOptions);
     get width(): number;
     get height(): number;

package/dist/core/view/base/BandContainer.d.ts

@@ -0,0 +1,49 @@
+import { LayoutGroup, LayoutNode, LayoutGroupOptions } from '.';
+import { Page } from '../Page';
+export interface BandContainerOptions extends LayoutGroupOptions {
+    page: Page;
+    type: 'header' | 'footer';
+}
+/**
+ * 页眉 / 页脚容器
+ */
+export declare class BandContainer extends LayoutGroup<LayoutNode> {
+    type: 'header' | 'footer';
+    /** 节点类型 */
+    component: import('../..').BuiltinComponentType;
+    constructor(options: BandContainerOptions);
+    get page(): Page;
+    /**
+     * 宽度 = 页面正文宽度
+     */
+    get contentMaxWidth(): number;
+    /**
+     * 页眉页脚不限制高度
+     */
+    get contentMaxHeight(): number;
+    /** 获取页眉页脚内容高度 */
+    getContentHeight(): number;
+    /** 当前真正推开正文的 inset 高度 */
+    get actualInsetHeight(): number;
+    /** 获取剩余空间 */
+    getRemainingSize(): number;
+    layout(x: number, y: number): void;
+    /** 距离页面边缘的安全间距（页眉/页脚与页面边缘的距离） */
+    get spacingFromEdge(): number;
+    /** 页眉/页脚与正文的分界线 Y 坐标（相对整页） */
+    get guideLineY(): number;
+    /** 页眉/页脚占位矩形（用于辅助线渲染），相对整页 */
+    get guideRect(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** 双击开启/关闭页眉页脚编辑的命中区域（相对整页） */
+    get hitAreaRect(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}

package/dist/core/view/base/LayoutGroup.d.ts

@@ -32,6 +32,17 @@ export declare abstract class LayoutGroup<T extends LayoutNode = LayoutNode> ext
      * @param child 要插入的子节点
      */
     insertChild(index: number, child: T): void;
+    /**
+     * 批量添加子节点
+     * @param children 要添加的子节点数组
+     */
+    addChildren(children: T[]): void;
+    /**
+     * 在指定位置批量插入子节点
+     * @param index 插入位置
+     * @param children 要插入的子节点数组
+     */
+    insertChildren(index: number, children: T[]): void;
     /**
      * 移除子节点
      * @param child 要移除的子节点

package/dist/core/view/base/LayoutNode.d.ts

@@ -2,6 +2,7 @@ import { Page } from '../Page';
 import { Doc } from '../Doc';
 import { BuiltinComponentType } from '../../constants';
 import { LayoutGroup } from './LayoutGroup';
+import { OverlayLayout } from './OverlayLayout';
 type ModelRef = {
     id: string;
     start?: number;
@@ -52,6 +53,7 @@ export declare abstract class LayoutNode {
     set height(value: number);
     get page(): Page | undefined;
     get isWidgetRun(): boolean;
+    get isPageWidgetRun(): boolean;
     get isSubRenderer(): boolean;
     get isPlaceholderRun(): boolean;
     /**
@@ -60,6 +62,7 @@ export declare abstract class LayoutNode {
      * @returns
      */
     getPage(): Page | undefined;
+    getOverlayLayout(): OverlayLayout | undefined;
     /**
      * 布局方法：计算并设置节点的绝对位置
      * @param x 绝对 X 坐标

package/dist/core/view/base/OverlayContainer.d.ts

@@ -0,0 +1,31 @@
+import { LayoutNode } from './LayoutNode';
+import { OverlayLayout } from './OverlayLayout';
+import { Page } from '../Page';
+import { LayoutGroup, LayoutGroupOptions } from './LayoutGroup';
+export interface OverlayContainerOptions extends LayoutGroupOptions {
+    page: Page;
+}
+/**
+ * 悬浮层容器（浮层绘制层）
+ */
+export declare class OverlayContainer extends LayoutGroup<LayoutNode> {
+    component: "overlay-container";
+    parent: Page;
+    constructor(options: OverlayContainerOptions);
+    get page(): Page;
+    get width(): number;
+    get height(): number;
+    createOverlayLayout({ x, y, width, height, modelRef, }: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        modelRef: {
+            id: string;
+        };
+    }): OverlayLayout;
+    /**
+     * 悬浮层不参与文档流布局
+     */
+    layout(): void;
+}

package/dist/core/view/base/OverlayLayout.d.ts

@@ -0,0 +1,19 @@
+import { LayoutGroup, LayoutGroupOptions } from './LayoutGroup';
+import { LayoutNode } from './LayoutNode';
+export interface OverlayLayoutOptions extends LayoutGroupOptions {
+}
+/**
+ * 悬浮层内容布局
+ */
+export declare class OverlayLayout extends LayoutGroup<LayoutNode> {
+    component: "overlay-layout";
+    constructor(options: OverlayLayoutOptions);
+    /**
+     * 获取可用宽度
+     */
+    get contentMaxWidth(): number;
+    /**
+     * 悬浮层不参与文档流布局,但是要设置 layoutX和 layoutY
+     */
+    layout(): void;
+}

package/dist/core/view/base/index.d.ts

@@ -1,2 +1,4 @@
 export { LayoutNode, type LayoutNodeOptions } from './LayoutNode';
 export { LayoutGroup, type LayoutGroupOptions } from './LayoutGroup';
+export { BandContainer, type BandContainerOptions } from './BandContainer';
+export { OverlayContainer, type OverlayContainerOptions } from './OverlayContainer';

package/dist/core/view/runs/ImageRun.d.ts

@@ -3,8 +3,17 @@ import { LayoutNode, LayoutNodeOptions } from '../base';
  * 图片运行接口
  */
 export interface IImageRun {
+    readonly id: string;
     /** 组件类型 */
     readonly component: string;
+    /** 组件宽度 */
+    readonly width: number;
+    /** 组件高度 */
+    readonly height: number;
+    /** 组件坐标位置 */
+    readonly x: number;
+    /** 组件坐标位置 */
+    readonly y: number;
     /** 图片源地址 */
     src: string;
     /** 是否保持等比 */

package/dist/core/view/runs/ImageWidget.d.ts

@@ -5,25 +5,31 @@ import { ImageRun, IImageRun, ImageRunOptions } from './ImageRun';
  */
 export interface IImageWidget extends IImageRun {
     /** 值路径 */
-    valuePath: string;
+    valuePath?: string;
     /** 组件元数据 */
-    widgetMeta: WidgetMeta;
+    widgetMeta?: WidgetMeta;
     signature?: string;
+    pageWidgetMeta?: Record<string, any>;
+    dataIndex?: number;
 }
 export interface ImageWidgetOptions extends ImageRunOptions {
     /** 值路径 */
-    valuePath: string;
+    valuePath?: string;
     /** 组件元数据 */
-    widgetMeta: WidgetMeta;
+    widgetMeta?: WidgetMeta;
     signature?: string;
+    pageWidgetMeta?: IImageWidget['pageWidgetMeta'];
+    dataIndex?: number;
 }
 /**
  * 图片运行类
  * 用于处理文档中的图片
  */
 export declare class ImageWidget extends ImageRun implements IImageWidget {
-    valuePath: string;
-    widgetMeta: WidgetMeta;
+    valuePath?: string;
+    widgetMeta?: WidgetMeta;
     signature?: string;
+    pageWidgetMeta?: IImageWidget['pageWidgetMeta'];
+    dataIndex?: number;
     constructor(options: ImageWidgetOptions);
 }

package/dist/core/view/runs/TextRun.d.ts

@@ -2,9 +2,6 @@ import { LayoutNode, LayoutNodeOptions } from '../base';
 import { TextStyle } from '../../model/types/style';
 import { default as Konva } from 'konva';
 import { Doc } from '../Doc';
-/**
- * 文本对齐方式
- */
 export type TextAlign = 'left' | 'center' | 'right' | 'justify';
 /**
  * 字符度量信息
@@ -21,6 +18,14 @@ export interface ITextRun {
     readonly id: string;
     /** 组件类型 */
     readonly component: string;
+    /** 组件宽度 */
+    readonly width: number;
+    /** 组件高度 */
+    readonly height: number;
+    /** 组件坐标位置 */
+    readonly x: number;
+    /** 组件坐标位置 */
+    readonly y: number;
     /** 文本内容 */
     text: string;
     /** 字号 */
@@ -56,6 +61,7 @@ export interface TextRunOptions extends LayoutNodeOptions {
     ascent: number;
     descent: number;
     style?: TextStyle;
+    charMetrics: CharMetric[];
 }
 export declare class TextRun extends LayoutNode implements ITextRun {
     component: "text";
@@ -87,12 +93,29 @@ export declare class TextRun extends LayoutNode implements ITextRun {
     descent: number;
     style?: TextStyle;
     constructor(options: TextRunOptions);
+    /**
+     * 计算文字大小 度量
+     * 优化版本
+     * @param payload
+     * @returns
+     */
     static measureText(payload: Konva.TextConfig): {
         width: number;
         height: number;
         ascent: number;
         descent: number;
     };
+    /**
+     * 计算文字大小 度量
+     * @param payload
+     * @returns
+     */
+    static __measureText(payload: Konva.TextConfig): {
+        width: number;
+        height: number;
+        ascent: number;
+        descent: number;
+    };
     static createEmptyRun(doc: Doc): TextRun;
     /**TextStyle（样式体系的样式）转换为 Layout 层的样式
      * @param textStyle 经过继承计算的有效字符样式

package/dist/core/view/runs/TextWidget.d.ts

@@ -4,10 +4,10 @@ import { TextRun, ITextRun, TextRunOptions } from './TextRun';
  * 文本组件接口
  */
 export interface ITextWidget extends ITextRun {
-    /** 组件元数据 */
-    widgetMeta: WidgetMeta;
+    /** 字段组件元数据 */
+    widgetMeta?: WidgetMeta;
     /** 值路径 */
-    valuePath: string;
+    valuePath?: string;
     /** 是否为空占位符 */
     isEmptyPlaceholder: boolean;
     isIconPlaceholder: boolean;
@@ -20,26 +20,39 @@ export interface ITextWidget extends ITextRun {
         index: number;
         value: string;
     };
+    widgetFieldLeftMarker?: boolean;
+    widgetFieldRightMarker?: boolean;
+    /** 页面组件元数据 */
+    pageWidgetMeta?: WidgetMeta;
+    dataIndex?: number;
 }
 export interface TextWidgetOptions extends TextRunOptions {
     /** 组件元数据 */
-    widgetMeta: WidgetMeta;
+    widgetMeta?: WidgetMeta;
     /** 值路径 */
-    valuePath: string;
+    valuePath?: string;
     /** 是否为空占位符 */
     isEmptyPlaceholder?: boolean;
     isIconPlaceholder?: boolean;
     isSpacePlaceholder?: boolean;
     widgetOption?: ITextWidget['widgetOption'];
     widgetFileItem?: ITextWidget['widgetFileItem'];
+    widgetFieldLeftMarker?: boolean;
+    widgetFieldRightMarker?: boolean;
+    pageWidgetMeta: ITextWidget['pageWidgetMeta'];
+    dataIndex?: number;
 }
 export declare class TextWidget extends TextRun implements ITextWidget {
-    widgetMeta: WidgetMeta;
-    valuePath: string;
+    widgetMeta?: WidgetMeta;
+    valuePath?: string;
     isEmptyPlaceholder: boolean;
     isIconPlaceholder: boolean;
     isSpacePlaceholder: boolean;
+    widgetFieldLeftMarker?: boolean;
+    widgetFieldRightMarker?: boolean;
     widgetOption?: ITextWidget['widgetOption'];
     widgetFileItem?: ITextWidget['widgetFileItem'];
+    pageWidgetMeta: ITextWidget['pageWidgetMeta'];
+    dataIndex?: number;
     constructor(options: TextWidgetOptions);
 }

package/dist/core/view/utils/EventUtil.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 事件类 - 管理事件的注册、注销和触发
+ */
+export declare class EventUtil {
+    private listeners;
+    /**
+     * 注册监听器
+     */
+    on(listener: (payload?: any) => void): void;
+    /**
+     * 注销监听器
+     */
+    off(listener: () => void): void;
+    /**
+     * 清空所有监听器
+     */
+    clear(): void;
+    /**
+     * 触发事件
+     */
+    emit(payload?: any): void;
+}

package/dist/core/view/utils/TextUtil.d.ts

@@ -0,0 +1,47 @@
+import { default as Konva } from 'konva';
+export declare class TextUtil {
+    /** 字体度量缓存限制 */
+    private static readonly FONT_METRICS_CACHE_LIMIT;
+    /** 布局大小缓存限制 */
+    private static readonly LAYOUT_SIZE_CACHE_LIMIT;
+    private static fontMetricsCache;
+    private static layoutSizeCache;
+    /**
+     * 验证中文字符
+     * @param char
+     * @returns
+     */
+    static isHanChar(char: string): boolean;
+    /**
+     * 计算度量 - 基于 JSON 序列化的缓存（LRU）
+     * 将最终的 config 序列化为缓存键，相同配置直接返回缓存结果
+     * 最近使用的项会被移到末尾，超限时删除最古老的项
+     * @param payload
+     * @returns
+     */
+    static getFontMetrics(payload: Konva.TextConfig): {
+        ascent: number;
+        descent: number;
+    };
+    /**
+     * 计算单个字符布局大小 - 基于 JSON 序列化的缓存（LRU）
+     * @param payload
+     * @returns
+     */
+    static getLayoutSize(payload: Konva.TextConfig): {
+        width: number;
+        height: number;
+    };
+    /**
+     * 清除度量结果缓存
+     */
+    static clearMeasureCache(): void;
+    /**
+     * 获取缓存大小信息
+     * @returns 返回测量缓存的大小 {fontMetrics, layoutSize}
+     */
+    static getMeasureCacheSize(): {
+        fontMetrics: number;
+        layoutSize: number;
+    };
+}

package/dist/core/widget/widget-meta.d.ts

@@ -1,4 +1,5 @@
 import { FieldDataBindingMeta } from '../../domain/field/field-binding';
+import { PaperWidgetDataBindingMeta } from '../../domain/paper-widget/widget-binding';
 import { ExternalComponentType } from '../../domain/widget/component-type';
 /** 组件基础信息 */
 interface WidgetMetaBase {
@@ -32,6 +33,8 @@ interface WidgetBehaviorMeta {
     removable?: boolean;
     /** 是否允许作为容器 */
     droppable?: boolean;
+    /** 是否允许脱离文档流 */
+    outOfFlow?: boolean;
     /** 事件映射 */
     events?: Record<string, {
         action: string;
@@ -61,6 +64,8 @@ export interface WidgetMeta extends WidgetMetaBase {
     style?: WidgetStyleMeta;
     /** 字段信息 */
     field?: FieldDataBindingMeta;
+    /** 页面组件信息 */
+    widget?: PaperWidgetDataBindingMeta;
     /** 扩展能力 */
     extra?: WidgetExtraMeta;
 }

package/dist/domain/active/active-types.d.ts

@@ -2,18 +2,24 @@
 export type PanelType = 
 /** 纸张 */
 'panel:paper'
-/** 页眉 */
- | 'panel:paper-header'
-/** 页脚 */
- | 'panel:paper-footer'
+/** 页眉页脚 */
+ | 'panel:paper-header-footer'
 /** 数据初始化 */
  | 'panel:data-init'
+/** 数据加载 */
+ | 'panel:data-load'
 /** 动态表 */
  | 'panel:dynamic-table'
+/** 二维表 */
+ | 'panel:2d-table'
 /** 固定表 */
  | 'panel:fixed-table'
+/** 检验表 */
+ | 'panel:check-table'
 /** 数据分组 */
  | 'panel:data-group'
+/** 动态关联 */
+ | 'panel:data-group-2d'
 /** 表头 */
  | 'panel:table-header'
 /** 组件 */
@@ -22,13 +28,13 @@ type ActiveContext = {
     mainModelKey: string;
     subFieldKey: string | undefined;
     regionId: string;
+    /** 章节引用 id */
+    secRefId: string;
 };
 /** 选中的面板信息 */
 export interface ActivePanelData {
     /** 面板类型 */
     panelType: PanelType;
-    /** widget 标识 */
-    widgetId?: string;
     /** widget 对应底层的 model id */
     modelId?: string;
     /** 上下文信息 */

package/dist/domain/constants/enum.d.ts

@@ -170,3 +170,37 @@ export declare const ViewTypeConst: {
     VIEW_JS: string;
 };
 export type ViewType = ValueOf<typeof ViewTypeConst>;
+/** 条码二维码类型 */
+export declare const BwipCodeTypeConst: {
+    Code39: string;
+    Code128: string;
+    QRCode: string;
+    GS1DataMatrix: string;
+};
+export type BwipCodeType = ValueOf<typeof BwipCodeTypeConst>;
+/** 条码二维码内容类型 */
+export declare const ValueTypeConst: {
+    /** 固定值 */
+    Fixed: string;
+    /** 字段 */
+    Field: string;
+    /** 公式 */
+    Formula: string;
+};
+export type ValueType = ValueOf<typeof ValueTypeConst>;
+/** 图片组件高宽呈现模式 */
+export declare const ImageSizeModeTypeConst: {
+    /** 自适应，响应式的适应外层容器的大小 */
+    RESPONSIVE: string;
+    /** 固定值，高宽设了多少就是多少 */
+    FIXED: string;
+};
+export type ImageSizeModeType = ValueOf<typeof ImageSizeModeTypeConst>;
+/** 分栏的方向 */
+export declare const DiagonalDirectionTypeConst: {
+    /** 从左上到右下  */
+    Forward: string;
+    /** 从右上到左下 / */
+    Backward: string;
+};
+export type DiagonalDirectionType = ValueOf<typeof DiagonalDirectionTypeConst>;

package/dist/domain/constants/options.d.ts

@@ -29,3 +29,7 @@ export declare const AssignmentStrategyTypeOptions: {
     label: string;
     value: string;
 }[];
+export declare const PaginationFormatOptions: {
+    value: string;
+    label: string;
+}[];

package/dist/domain/field/field-props-schema-type.d.ts

@@ -1,5 +1,5 @@
 /** 字段配置-渲染组件标识 */
-export type FieldPropsSchemaKey = 'schema:field-text' | 'schema:field-boolean' | 'schema:field-number' | 'schema:field-datetime' | 'schema:field-user' | 'schema:field-org' | 'schema:field-sign' | 'schema:field-enum' | 'schema:field-file' | 'schema:field-trace' | 'schema:field-business';
+export type FieldPropsSchemaKey = 'schema:field-text' | 'schema:field-boolean' | 'schema:field-number' | 'schema:field-datetime' | 'schema:field-user' | 'schema:field-org' | 'schema:field-sign' | 'schema:field-enum' | 'schema:field-file' | 'schema:field-image' | 'schema:field-trace' | 'schema:field-business';
 /** 优先级规则 */
 export interface PriorityRule {
     type: 'priority';

package/dist/domain/paper-widget/paper-widget-props-schema-type.d.ts

@@ -0,0 +1,2 @@
+/** 页面组件配置-渲染组件标识 */
+export type PaperWidgetPropsSchemaKey = 'schema:widget-image' | 'schema:widget-barcode' | 'schema:widget-qrcode' | 'schema:widget-diagonal' | 'schema:widget-serialnumber' | 'schema:widget-pagination' | 'schema:widget-line';