@gct-paas/word 0.1.11 → 0.1.13

package/dist/core/layout/handlers/fields/OptionHandler.d.ts

@@ -0,0 +1,15 @@
+import { BaseHandler, HandlerContext } from './BaseHandler';
+import { WrText } from '../../../model/document';
+import { LayoutContext } from '../../LayoutContext';
+import { TextRun } from '../../../view/runs/TextRun';
+type WidgetOption = {
+    value: any;
+    label: string;
+};
+export declare class OptionHandler extends BaseHandler {
+    static layout(ctx: HandlerContext): void;
+    static isVerticalLayout(wr: WrText): boolean;
+    static layoutField(ctx: HandlerContext): void;
+    static layoutOptionItem(context: LayoutContext, wr: WrText, option: WidgetOption, optionIndex: number, layoutStyle: ReturnType<typeof TextRun.textStyle2LayoutStyle>): void;
+}
+export {};

package/dist/core/layout/handlers/fields/SignatureHandler.d.ts

@@ -0,0 +1,24 @@
+import { BaseHandler, HandlerContext } from './BaseHandler';
+import { ImageWidgetOptions } from '../../../view/runs/ImageWidget';
+export declare class SignatureHandler extends BaseHandler {
+    static layout(ctx: HandlerContext): void;
+    /**
+     * 获取签名装饰信息
+     * @param ctx
+     * @param width
+     * @param height
+     * @param time
+     * @returns
+     */
+    static getDecorationsInfo(ctx: HandlerContext, width: number, height: number, time: number): {
+        render: boolean;
+        rectWidth: number;
+        rectHeight: number;
+        decorations?: ImageWidgetOptions['decorations'];
+    };
+    /**
+     * 签名字段处理
+     * @param ctx
+     */
+    static layoutField(ctx: HandlerContext): void;
+}

package/dist/core/layout/handlers/fields/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseHandler, type HandlerContext } from './BaseHandler';
+export { OptionHandler } from './OptionHandler';
+export { ImgHandler } from './ImgHandler';
+export { SignatureHandler } from './SignatureHandler';
+export { InputHandler } from './InputHandler';
+export { AttachmentHandler } from './AttachmentHandler';

package/dist/core/model/document/WrField.d.ts

@@ -1,131 +1,8 @@
-import { Wp } from './Wp';
-import { TextStyle, RawElement, WordHighlight } from '../types';
-import { WidgetMeta } from '../../widget/widget-meta';
-import { WrPr } from './WrPr';
-import { ModelNode, ModelNodeOptions } from '../base';
-type IElement = ModelNode | RawElement;
-/**
- * 文本块实例类
- */
-export declare class WrField extends ModelNode {
-    name: 'w:r';
-    type: "element";
-    handler: "field";
-    /** 父节点引用 */
-    parent?: Wp;
-    rPr?: WrPr;
-    text: string;
-    isComposition?: boolean;
-    isPlaceholder?: boolean;
-    elements?: IElement[];
-    widgetMeta?: WidgetMeta;
-    valuePath?: string;
-    constructor(options: ModelNodeOptions & {
-        text: string;
-        rPr?: WrPr;
-        elements?: IElement[];
-        isComposition?: boolean;
-        isPlaceholder?: boolean;
-        widgetMeta?: WidgetMeta;
-        valuePath?: string;
-    });
-    /**
-     * 在指定位置插入文本
-     * @param text 要插入的文本
-     * @param position 插入位置，默认在末尾
-     */
-    insertText(text: string, position?: number): void;
-    /**
-     * 删除指定范围的文本
-     * @param start 开始位置
-     * @param length 删除长度，默认为 1
-     */
-    deleteText(start: number, length?: number): void;
-    /**
-     * 替换指定范围的文本
-     * @param start 开始位置
-     * @param length 替换长度
-     * @param newText 新文本
-     */
-    replaceText(start: number, length: number, newText: string): void;
-    /**
-     * 确保 rPr 实例存在，如果不存在则创建一个新的 WrPr 实例
-     */
-    private ensureRPr;
-    /**
-     * 设置高亮
-     * @param highlight 颜色值（hex 格式，如 '#ff0000'）
-     */
-    setHighlight(highlight: WordHighlight): void;
-    /**
-     * 设置文本颜色
-     * @param color 颜色值（hex 格式，如 '#ff0000'）
-     */
-    setColor(color: string): void;
-    /**
-     * 设置文本加粗
-     * @param bold 是否加粗
-     */
-    setBold(bold: boolean): void;
-    /**
-     * 设置文本斜体
-     * @param italic 是否斜体
-     */
-    setItalic(italic: boolean): void;
-    /**
-     * 设置文本下划线
-     * @param underline 下划线类型（'none' | 'single' | 'double' 等）
-     */
-    setUnderline(underline?: string): void;
-    /**
-     * 设置文本删除线
-     * @param strike 是否删除线
-     */
-    setStrike(strike: boolean): void;
-    /**
-     * 设置字体
-     * @param fontFamily 字体名称
-     */
-    setFont(fontFamily: string): void;
-    /**
-     * 设置字号
-     * @param fontSize 字号大小（半磅单位）
-     */
-    setFontSize(fontSize: number): void;
-    /**
-     * 设置样式
-     * @param styleUpdates 要更新的样式对象（只更新指定的属性）
-     */
-    updateStyle(styleUpdates: Partial<TextStyle>): void;
-    /**
-     * 在指定字符位置拆分文本节点
-     * @param index 拆分位置（在此字符之前分割）
-     * @returns 返回 [beforeText, afterText]，边界情况返回 null
-     * @example
-     * const text = new WrText('Hello World');
-     * const [before, after] = text.splitAt(5);
-     * // before: WrText('Hello')，after: WrText(' World')
-     * const [n, all] = text.splitAt(0);
-     * // n 为 null，all 为 this（无分割）
-     */
-    splitAt(index: number): [WrText | null, WrText | null];
-    /**
-     * 从原始 XML JSON 转换为 WrText 实例
-     * @param json w:r XML JSON 对象
-     * @returns WrText 实例
-     */
+import { RawElement } from '../types';
+import { WrText } from './WrText';
+export declare class WrField extends WrText {
     static fromXmlJson(json: RawElement & {
         valuePath?: string;
         widgetMeta?: any;
     }): WrField;
-    /**
-     * 将实例转换为 XML JSON 格式
-     * 结构：w:r
-     *   ├── w:rPr（如果存在）
-     *   ├── w:t（文本内容）
-     *   └── 其他元素
-     * @returns XML JSON 对象
-     */
-    toXmlJson(): RawElement;
 }
-export {};

package/dist/core/model/document/WsecPr.d.ts

@@ -73,4 +73,43 @@ export declare class WsecPr extends ModelNode {
      * 获取有效的左边距（考虑装订线）
      */
     getEffectiveLeftMargin(): number | undefined;
+    setOrient(val: 'portrait' | 'landscape'): void;
+    /**
+     * 设置为横向（宽 > 高）
+     * 通过交换宽高数据实现
+     */
+    setLandscape(): void;
+    /**
+     * 设置为纵向（高 > 宽）
+     * 通过交换宽高数据实现
+     */
+    setPortrait(): void;
+    /**
+     * 设置上边距 (margin top)
+     * @param value 边距值，单位：twip（1/20点）
+     */
+    setMarginTop(value: number): void;
+    /**
+     * 设置下边距 (margin bottom)
+     * @param value 边距值，单位：twip（1/20点）
+     */
+    setMarginBottom(value: number): void;
+    /**
+     * 设置左边距 (margin left)
+     * @param value 边距值，单位：twip（1/20点）
+     */
+    setMarginLeft(value: number): void;
+    /**
+     * 设置右边距 (margin right)
+     * @param value 边距值，单位：twip（1/20点）
+     */
+    setMarginRight(value: number): void;
+    /**
+     * 同时设置四个边距
+     * @param top 上边距值，单位：twip（1/20点）
+     * @param bottom 下边距值，单位：twip（1/20点）
+     * @param left 左边距值，单位：twip（1/20点）
+     * @param right 右边距值，单位：twip（1/20点）
+     */
+    setMargins(top: number, bottom: number, left: number, right: number): void;
 }

package/dist/core/sdk/types/public-types.d.ts

@@ -28,6 +28,8 @@ export interface DocInfo {
     updateTick: number;
 }
 export interface SelfInfo {
+    /** 唯一 id */
+    id: string;
     /** 父id */
     baseId: string;
     /** 绑定key */

package/dist/core/utils/calculate-formula.d.ts

@@ -0,0 +1,5 @@
+export declare const formulaUtils: {
+    buildFormulaVariables: (deps: string[], rawData: any, subRowData: any) => Record<string, any>;
+    calculateFormula: (expr: string, rawData: any, subRowData: any) => Promise<any>;
+    executeFormula: (expr: string, data: any) => Promise<any>;
+};

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

@@ -14,6 +14,7 @@ import { DocModel } from '../model';
 export interface DocInitOptions {
     mode?: DocModeType;
     model?: DocModel;
+    preview?: boolean;
     mainModelKey: ModelKey;
     pageSize?: {
         width: number;
@@ -25,7 +26,10 @@ export interface DocInitOptions {
 }
 export declare class Doc {
     id: string;
+    /** 渲染模式 */
     mode: DocModeType;
+    /** 是否是预览模式 */
+    preview: boolean;
     model?: DocModel;
     sections: Section[];
     pages: Page[];
@@ -71,6 +75,7 @@ export declare class Doc {
     getFirstPage(): Page | null;
     getLastPage(): Page | null;
     setModel(model: DocModel): void;
+    setMode(modeType: DocModeType): void;
     /** 触发布局计算 */
     layout(): void;
     /** 渲染文档 */

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

@@ -3,7 +3,6 @@ import { Table } from './Table';
 import { LayoutGroup, LayoutGroupOptions } from './base';
 import { IContainerMetrics } from './types';
 import { Section } from './Section';
-import { VOrientationType } from '../../domain/constants/enum';
 export type PageChild = Paragraph | Table;
 export interface PageOptions extends LayoutGroupOptions {
     section: Section;
@@ -21,7 +20,5 @@ export declare class Page extends LayoutGroup<PageChild> implements IContainerMe
     get contentMaxHeight(): number;
     getContentHeight(): number;
     getRemainingSize(): number;
-    setOrient(orient: VOrientationType): void;
-    setPadding(padding: [number, number, number, number]): void;
     layout(): void;
 }

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

@@ -6,20 +6,22 @@ export type SectionOption = {
     };
     pagePadding?: [number, number, number, number];
     bgColor?: string;
+    refId: string;
 };
 export declare class Section {
     id: string;
     pageSize: SectionOption['pageSize'];
     pagePadding: SectionOption['pagePadding'];
     bgColor?: string;
-    constructor(options?: SectionOption);
+    refId: string;
+    constructor(options?: Partial<SectionOption>);
     /**
      * 从 WsecPr 模型创建 Section 视图
      * @param json Word 文档的分节模型
      * @param dpi 屏幕 DPI（默认 96）
      * @returns Section 视图实例
      */
-    static fromXML(json: WsecPr, dpi?: number): Section;
+    static fromModel(json: WsecPr, dpi?: number): Section;
     /**
      * 获取内容区域宽度（页面宽度 - 左边距 - 右边距）
      * @returns 内容宽度（px）
@@ -30,22 +32,6 @@ export declare class Section {
      * @returns 内容高度（px）
      */
     getContentHeight(): number;
-    /**
-     * 解析数值：支持多种单位格式
-     * @param value 数值字符串或数字
-     * @param defaultUnit 默认单位（'twip' | 'px' | 'mm' | 'cm' | 'inch'）
-     * @param dpi 屏幕 DPI（默认 96）
-     * @returns 转换后的 px 值
-     */
-    static parseValue(value: string | number, defaultUnit?: 'twip' | 'px' | 'mm' | 'cm' | 'inch', dpi?: number): number;
-    /**
-     * 单位转换为 px
-     * @param value 数值
-     * @param unit 单位
-     * @param dpi 屏幕 DPI（默认 96）
-     * @returns px 值
-     */
-    private static convertToPixel;
     /**
      * 获取页面尺寸信息（用于调试）
      * @returns 格式化的页面信息

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

@@ -12,6 +12,15 @@ export interface IImageRun {
 }
 export interface ImageRunOptions extends LayoutNodeOptions {
     src: string;
+    decorations?: Array<{
+        text: string;
+        width: number;
+        height: number;
+        fontSize: number;
+        x: number;
+        y: number;
+        position: 'right' | 'bottom';
+    }>;
 }
 /**
  * 图片运行类
@@ -22,5 +31,8 @@ export declare class ImageRun extends LayoutNode implements IImageRun {
     src: string;
     /** 是否保持等比 */
     keepAspect: boolean;
+    decorations?: ImageRunOptions['decorations'];
+    get width(): number;
+    get height(): number;
     constructor(options: ImageRunOptions);
 }

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

@@ -8,12 +8,14 @@ export interface IImageWidget extends IImageRun {
     valuePath: string;
     /** 组件元数据 */
     widgetMeta: WidgetMeta;
+    signature?: string;
 }
 export interface ImageWidgetOptions extends ImageRunOptions {
     /** 值路径 */
     valuePath: string;
     /** 组件元数据 */
     widgetMeta: WidgetMeta;
+    signature?: string;
 }
 /**
  * 图片运行类
@@ -22,5 +24,6 @@ export interface ImageWidgetOptions extends ImageRunOptions {
 export declare class ImageWidget extends ImageRun implements IImageWidget {
     valuePath: string;
     widgetMeta: WidgetMeta;
+    signature?: string;
     constructor(options: ImageWidgetOptions);
 }

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

@@ -85,6 +85,7 @@ export declare class TextRun extends LayoutNode implements ITextRun {
     lineHeight: number;
     ascent: number;
     descent: number;
+    style?: TextStyle;
     constructor(options: TextRunOptions);
     static measureText(payload: Konva.TextConfig): {
         width: number;

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

@@ -16,6 +16,10 @@ export interface ITextWidget extends ITextRun {
         id: string;
         value: any;
     };
+    widgetFileItem?: {
+        index: number;
+        value: string;
+    };
 }
 export interface TextWidgetOptions extends TextRunOptions {
     /** 组件元数据 */
@@ -26,10 +30,8 @@ export interface TextWidgetOptions extends TextRunOptions {
     isEmptyPlaceholder?: boolean;
     isIconPlaceholder?: boolean;
     isSpacePlaceholder?: boolean;
-    widgetOption?: {
-        id: string;
-        value: any;
-    };
+    widgetOption?: ITextWidget['widgetOption'];
+    widgetFileItem?: ITextWidget['widgetFileItem'];
 }
 export declare class TextWidget extends TextRun implements ITextWidget {
     widgetMeta: WidgetMeta;
@@ -37,9 +39,7 @@ export declare class TextWidget extends TextRun implements ITextWidget {
     isEmptyPlaceholder: boolean;
     isIconPlaceholder: boolean;
     isSpacePlaceholder: boolean;
-    widgetOption?: {
-        id: string;
-        value: any;
-    };
+    widgetOption?: ITextWidget['widgetOption'];
+    widgetFileItem?: ITextWidget['widgetFileItem'];
     constructor(options: TextWidgetOptions);
 }

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

@@ -0,0 +1,21 @@
+export interface WidgetStateContext {
+    docMode: string;
+    isEditMode: boolean;
+    isPrintMode: boolean;
+    formType?: string;
+    viewState?: string;
+    required?: boolean;
+    newRequired?: boolean;
+    readonly?: boolean;
+    newReadonly?: boolean;
+    disabled?: boolean;
+    newDisabled?: boolean;
+    cannotInput?: boolean;
+    isLinkedModelField?: boolean;
+}
+export declare function resolveWidgetState(ctx: WidgetStateContext): {
+    required: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    displayStatus: "readonly-component" | "readonly-text" | "edit-component";
+};

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

@@ -19,7 +19,6 @@ export type PanelType =
 /** 组件 */
  | 'panel:widget';
 type ActiveContext = {
-    pageName: string;
     mainModelKey: string;
     subFieldKey: string | undefined;
     regionId: string;

package/dist/domain/widget/component-type.d.ts

@@ -1,6 +1,6 @@
 export type ExternalComponentType = 'fw:input' | 'fw:number' | 'fw:double' | 'fw:enum' | 'fw:enum-multiple' | 'fw:date-time' | 'fw:date' | 'fw:time' | 'fw:select' | 'fw:select-multiple' | 'fw:tree-select' | 'fw:tree-select-multiple' | 'fw:table-select' | 'fw:rdo-table-select' | 'fw:signature' | 'fw:image' | 'fw:file' | 'pw:image' | 'pw:barcode' | 'pw:qrcode' | 'pw:diagonal' | 'pw:serialnumber';
 /** 渲染组件标识 后续支持自定义组件 */
-export type ExternalNodeType = 'render:gct-placeholder' | 'render:gct-control' | 'render:gct-space' | 'render:gct-text' | 'render:gct-image';
+export type ExternalNodeType = 'render:gct-placeholder' | 'render:gct-control' | 'render:gct-space' | 'render:gct-text' | 'render:gct-image' | 'render:gct-signature';
 /** 渲染节点集合 */
 export interface FieldNodeRenderers {
     /** 暗提示节点 */

package/dist/index.d.ts

@@ -4,5 +4,7 @@ export { default as DocRenderLayout } from './runtime/renderer/doc-render-layout
 export { GctLayout } from './base';
 export { registerEdhrSuite } from './suites/edhr';
 export { useDocEngine } from './runtime/useDocEngine';
+export { getSubmitFormData } from './runtime/interface/utils';
+export { validateAllFields } from './runtime/factories/useFormValidator';
 export * from './setup';
 export type { DocModeType, CompleteComponentType, BuiltinComponentType } from './core';