@gct-paas/word 0.1.12 → 0.1.13

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/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/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";
+};