@gct-paas/word 0.1.73 → 0.1.74-beta.1

package/dist/core/interaction/types.d.ts

@@ -23,31 +23,26 @@ export type InteractionState = {
     panelData: ActivePanelData | null;
     /** 引用字段配置定位（与 panel:attach-field 配合） */
     attachFieldTarget: AttachFieldTarget | null;
-    /** 字段校验批注信息集合（提交/可编辑字段；进校验清单） */
+    /** 字段填写校验批 */
     validationCommentMap: Record<string, Array<{
         field: string;
         fieldValue: any;
         message: string;
     }>> | null;
-    /**
-     * 禁用/只读字段上下限标红（仅展示，不进校验清单、不挡提交）
-     * 与 validationCommentMap 分离，避免提交全量替换时冲掉标红
-     */
-    rangeHighlightMap: Record<string, Array<{
-        field: string;
-        fieldValue: any;
-        message: string;
-    }>> | null;
     /** 当前 focus 的字段校验批注信息  */
     focusValidation: string | '';
     /** 页眉页脚配置开关 */
     isHeaderFooterEdit: boolean;
     /** 记录变更的字段列表 */
     annotationIds: string[] | null;
+    /** 变更查看模式已开启 */
+    annotationViewActive: boolean;
     /** 当前点击的记录变更 id */
     focusAnnotationId: string | null;
-    /** 记录变更的详情信息列表 */
-    annotationList: any[] | null;
+    /** 行变更预览明细 */
+    formChangeRowDetails: any[] | null;
+    /** 行变更预览前的 rawData 备份 */
+    formChangeRowPreviewBackup: Record<string, any[]> | null;
     /** 扫码字段模式记忆（true=扫码，false=搜索） */
     scanModeMap: Record<string, boolean>;
 };

package/dist/core/interaction/useInteraction.d.ts

@@ -46,18 +46,15 @@ export declare function useInteraction(docRef: Ref<Doc | null>): {
             readonly message: string;
         }[];
     } | null | undefined;
-    readonly rangeHighlightMap?: {
-        readonly [x: string]: readonly {
-            readonly field: string;
-            readonly fieldValue: any;
-            readonly message: string;
-        }[];
-    } | null | undefined;
     readonly focusValidation?: string | undefined;
     readonly isHeaderFooterEdit?: boolean | undefined;
     readonly annotationIds?: readonly string[] | null | undefined;
+    readonly annotationViewActive?: boolean | undefined;
     readonly focusAnnotationId?: string | null | undefined;
-    readonly annotationList?: readonly any[] | null | undefined;
+    readonly formChangeRowDetails?: readonly any[] | null | undefined;
+    readonly formChangeRowPreviewBackup?: {
+        readonly [x: string]: readonly any[];
+    } | null | undefined;
     readonly scanModeMap?: {
         readonly [x: string]: boolean;
     } | undefined;

package/dist/core/layout/LayoutContext.d.ts

@@ -28,6 +28,8 @@ export declare class LayoutContext {
     modelRef?: {
         id: string;
     };
+    /** 当前行内布局等待应用到下一个 run 的间距（等价于 flex gap，不生成占位节点） */
+    private pendingInlineGap;
     onPageCreated?: (page: Page) => void;
     /** 当前 section 内的页码 */
     constructor(options: ContextOptions);
@@ -38,7 +40,9 @@ export declare class LayoutContext {
     ensureCellParagraphSpace(itemWidth: number): void;
     ensurePageParagraphSpace(itemWidth: number, itemHeight: number): void;
     ensureParagraphSpace(itemWidth: number, itemHeight: number): void;
-    insertLineBreak(): void;
+    insertLineBreak(blockGap?: number): void;
+    /** 设置下一个 run 与当前 run 之间的行内 gap。 */
+    setInlineGap(gap: number): void;
     createNewPage(payload?: Partial<PageOptions>): Page;
     createNewParagraph(y?: number): Paragraph;
     resetModelRef(id: string): void;

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

@@ -4,12 +4,9 @@ import { HandlerContext } from '../../types';
 export declare class AttachmentHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;
     static layoutField(ctx: HandlerContext): void;
-    static layoutFileItem(payload: {
+    static layoutFileSummary(payload: {
         ctx: HandlerContext;
-        item: string;
-        itemIndex: number;
+        count: number;
         layoutStyle: ReturnType<typeof TextRun.textStyle2LayoutStyle>;
-        itemIsFirst: boolean;
-        itemIsLast: boolean;
     }): void;
 }

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

@@ -10,11 +10,21 @@ export declare class FieldBaseHandler extends RunHandlerBase {
     static hasValue(value: ValueType): boolean;
     /** 将展示文案拆成逐字 run；空串 split 会得到 []，需单独处理 */
     static toLayoutChars(label: unknown): string[];
+    static isPrint(ctx: HandlerContext): boolean;
     /**
      * 展示内容为空时补一个带 widgetMeta/valuePath 的占位 run
      * 避免段落只剩默认 TextRun（isPlaceholder=true）导致 getWidgetInstances 收集不到
      */
     static ensureFieldWidgetAnchor(ctx: HandlerContext, layoutStyle: Partial<TextRun>, extra?: Partial<TextWidget>): void;
+    /** 详情页：字段内容左右各留 2px，给底色内边距占位 */
+    static addPrintFieldPad(ctx: HandlerContext): void;
+    /**
+     * 详情页：字段背景之间的 2px 间距。
+     * 不带 widgetMeta，避免被算进字段分组底色。
+     */
+    static addPrintFieldGap(ctx: HandlerContext): void;
+    static beginPrintField(ctx: HandlerContext, hasContent: boolean): void;
+    static endPrintField(ctx: HandlerContext, hasContent: boolean): void;
     static getModelRefId(context: LayoutContext, wr: WrText): string;
     static getDataSlotIndex(context: LayoutContext): DataSlotIndex | undefined;
     static getValue(ctx: HandlerContext, valuePath: string): any;

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

@@ -1,7 +1,27 @@
 import { FieldBaseHandler } from './FieldBaseHandler';
+import { ImageWidget } from '../../../view/runs/ImageWidget';
 import { HandlerContext } from '../../types';
+import { Paragraph } from '../../../view/Paragraph';
+import { TableCell } from '../../../view/TableCell';
+import { LayoutNode } from '../../../view/base';
 /** 表单字段 fw:image 的布局处理 */
 export declare class FieldImageHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;
     static layoutField(ctx: HandlerContext): void;
+    /** 非自适应：固定 24×24；自适应：沿用配置宽高 */
+    static resolveImageSize(props: {
+        width?: number;
+        height?: number;
+    } | undefined, adaptiveInCell: boolean): {
+        width: number;
+        height: number;
+    };
+    /** 自适应宽度：单元格内容宽减去填报模式左右 [] */
+    static resolveAdaptiveImageWidth(cell: TableCell, paragraph: Paragraph): number;
+    /** 段落内左右字段括号占用宽度（打印模式无括号则为 0） */
+    static getFieldMarkersWidth(paragraph: Paragraph): number;
+    static isFieldMarker(node: LayoutNode): boolean;
+    static findImageRun(paragraph: Paragraph): ImageWidget | undefined;
+    /** 按子 run 宽度从左到右重排 x，避免图片变宽后右括号留在原位置 */
+    static reflowParagraphRuns(paragraph: Paragraph): void;
 }

package/dist/core/model/logic/subtable/repeating/MaterialConsumeTableRegion.d.ts

@@ -8,6 +8,10 @@ export type MaterialConsumeTableWidgetPropsMeta = {
     personal_bom_enabled_?: boolean;
     entries_?: any[];
     sequence_loading_enabled_?: boolean;
+    /** 删除二次确认 */
+    confirmBeforeDelete: boolean;
+    /** 删除二次确认提示 */
+    confirmBeforeDeleteTip: string;
     [key: string]: any;
 };
 export type MaterialConsumeTableWidgetMeta = {

package/dist/core/model/logic/subtable/repeating/RepeatingRegion.d.ts

@@ -5,6 +5,10 @@ import { SubTableLayoutType } from '../../../document/wtcRegionRef';
 export type RepeatingWidgetPropsBase = {
     /** 快速填报 */
     quickFill: boolean;
+    /** 删除二次确认 */
+    confirmBeforeDelete: boolean;
+    /** 删除二次确认提示 */
+    confirmBeforeDeleteTip: string;
 };
 export type DynamicTableProps = RepeatingWidgetPropsBase & {
     layoutType?: 'dynamic-table';

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

@@ -15,6 +15,8 @@ export interface DocInitOptions {
     mode?: DocModeType;
     model?: DocModel;
     preview?: boolean;
+    /** 是否是模拟填报 */
+    isMockReport?: boolean;
     mainModelKey: ModelKey;
     /** 文档运行时元信息（接口数据 + 业务数据） */
     docRuntimeMeta: DocRuntimeMeta;
@@ -45,6 +47,10 @@ export declare class Doc {
     btnRenderModeType: DocModeType;
     /** 是否是设计器预览模式 */
     preview: boolean;
+    /** 是否是模拟填报 */
+    isMockReport: boolean;
+    /** 填报内容区底色开关配置 */
+    showPrintFieldBg: boolean;
     model?: DocModel;
     pages: Page[];
     commandManager: CommandManager;
@@ -125,6 +131,8 @@ export declare class Doc {
     isInFillMode(): boolean;
     /** 是否是打印模式 */
     isInPrintMode(): boolean;
+    /** 打印时临时开关填报内容区底色 */
+    setShowPrintFieldBg(show: boolean): void;
     bumpUpdateTick(): void;
     increaseTextRunCount(): void;
     /**

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

@@ -20,6 +20,7 @@ export declare class Paragraph extends LayoutGroup<LayoutNode> {
     baseline: number;
     /** 上次 layout 应用的水平对齐偏移，避免重复 layout 时累加 */
     private _alignmentOffset;
+    private _inlineGapWidth;
     splitFillEvent: EventUtil;
     constructor(options: ParagraphOptions);
     /**
@@ -30,9 +31,12 @@ export declare class Paragraph extends LayoutGroup<LayoutNode> {
      * 子节点添加后的钩子
      * @param child 新添加的子节点
      */
-    protected onChildAdded(child: LayoutNode): void;
+    protected onChildAdded(_child: LayoutNode): void;
+    private measureContentLineHeight;
+    private hasImageLikeRun;
     get width(): number;
     getContextWidth(): number;
+    addInlineGap(gap: number): void;
     /**
      * 获取剩余空间
      */

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

@@ -40,6 +40,8 @@ export declare class ImageRun extends LayoutNode implements IImageRun {
     src: string;
     /** 是否保持等比 */
     keepAspect: boolean;
+    /** 签名/图片行高，略高于内容本身，避免贴行 */
+    lineHeight: number;
     decorations?: ImageRunOptions['decorations'];
     get width(): number;
     set width(value: number);

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

@@ -63,6 +63,18 @@ export declare const RangeValidateModeTypeConst: {
     Variable_Validate: string;
 };
 export type RangeValidateModeType = ValueOf<typeof RangeValidateModeTypeConst>;
+/** 日期上下限比较运算符 */
+export declare const RangeCompareOpTypeConst: {
+    /** 小于等于 */
+    readonly LE: "le";
+    /** 小于 */
+    readonly LT: "lt";
+    /** 大于等于 */
+    readonly GE: "ge";
+    /** 大于 */
+    readonly GT: "gt";
+};
+export type RangeCompareOpType = ValueOf<typeof RangeCompareOpTypeConst>;
 /** 字段默认值系统变量 */
 export declare const FieldSysVarDefaultValueConst: {
     NULL: string;

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

@@ -16,7 +16,7 @@ export declare const ValueTypeConst: {
     Formula: string;
 };
 export type ValueType = ValueOf<typeof ValueTypeConst>;
-/** 分栏的方向 */
+/** 分栏的方向（两栏） */
 export declare const DiagonalDirectionTypeConst: {
     /** 从左上到右下  */
     Forward: string;
@@ -24,6 +24,18 @@ export declare const DiagonalDirectionTypeConst: {
     Backward: string;
 };
 export type DiagonalDirectionType = ValueOf<typeof DiagonalDirectionTypeConst>;
+/** 分栏放射顶点（三栏） */
+export declare const DiagonalVertexTypeConst: {
+    readonly TopLeft: "topLeft";
+    readonly TopRight: "topRight";
+    readonly BottomLeft: "bottomLeft";
+    readonly BottomRight: "bottomRight";
+};
+export type DiagonalVertexType = ValueOf<typeof DiagonalVertexTypeConst>;
+/** 将旧版三栏分栏方向迁移为放射顶点 */
+export declare function migrateDiagonalDirectionToVertex(direction: DiagonalDirectionType): DiagonalVertexType;
+/** 解析三栏放射顶点，兼容未设置 vertex 的老数据 */
+export declare function resolveDiagonalVertex(size: number, direction: DiagonalDirectionType, vertex?: DiagonalVertexType, hasVertexKey?: boolean): DiagonalVertexType | undefined;
 /** 时间差格式类型 */
 export declare const TimeDiffFormatTypeConst: {
     /** 天时分秒 */

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

@@ -217,6 +217,10 @@ export declare enum FIELD_TYPE {
      * 车间
      */
     SHOPFLOOR = "shopfloor",
+    /**
+     * 建模关联
+    */
+    MODEL_RELATION = "model_relation",
     /**
      * 记录单号
      */

package/dist/domain/field/option-spacing.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_ICON_LABEL_SPACE = 8;
+export declare const DEFAULT_OPTION_SPACING = 12;
+/** 将清空或异常的间距恢复为设计默认值，避免配置与画布出现空值。 */
+export declare function resolveSpacingValue(value: unknown, defaultValue: number): number;
+/** 新配置使用 optionSpacing；缺失时继续兼容历史 controlEnumSpace。 */
+export declare function resolveOptionSpacing(optionSpacing: unknown, legacyOptionSpacing?: unknown): number;
+/** 纵向排列时仅在相邻选项行之间添加 gap，最后一项后不额外留白。 */
+export declare function resolveVerticalOptionGap(optionIndex: number, optionCount: number, optionSpacing: unknown, legacyOptionSpacing?: unknown): number;

package/dist/domain/table/business/check/check-table/actions/fetch-check-items.d.ts

@@ -1,9 +1,11 @@
 import { CheckTableItemInfosPayload, CheckTableRegionRef } from '../types';
+import { ICheckTableConfig } from '../front-config';
 /**
- * 按已扫描的检验表 region 并行拉取检验项详情。
- * @returns infosMap / countMap（count 至少为 1，用于占位行）
+ * 按已扫描的检验表 region 并行解析检验项（有快照用快照，否则请求）。
+ * @returns infosMap / countMap（count 至少为 1，用于占位行）/ 待落库 byTable 快照
  */
-export declare function fetchCheckItemsForRegions(instanceId: string, regions: CheckTableRegionRef[]): Promise<{
+export declare function fetchCheckItemsForRegions(instanceId: string, regions: CheckTableRegionRef[], checkTableConfig?: ICheckTableConfig): Promise<{
     infosMap: Record<string, CheckTableItemInfosPayload>;
     countMap: Record<string, number>;
+    pendingCheckTableConfig?: ICheckTableConfig;
 }>;

package/dist/domain/table/business/check/check-table/front-config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 表单实例 frontConfig
+ *
+ * Word 检验表按 regionId 写入 checkTableConfig.byTable；
+ * shared 预留给后续若接入 MedPro M08 整页共用源。
+ */
+export interface ICheckTableConfig {
+    /** MedPro 整页共用原始检验项；字段存在即锁定（可空数组） */
+    shared?: Record<string, unknown>[];
+    /** 按检验表 regionId 分表快照；key 存在即锁定（可空数组） */
+    byTable?: Record<string, Record<string, unknown>[]>;
+}
+export interface IFrontConfig {
+    checkTableConfig?: ICheckTableConfig;
+    otherConfig?: Record<string, unknown>;
+}
+export declare function parseFrontConfig(frontConfig?: string | null): IFrontConfig;
+export declare function hasByTableCheckTableSnapshot(config: ICheckTableConfig | undefined, regionId: string): boolean;
+export declare function hasAnyCheckTableSnapshot(config?: ICheckTableConfig): boolean;
+/** 从 frontConfig 字符串取出检验表快照 */
+export declare function getCheckTableConfigFromFrontConfig(frontConfig?: string | null): ICheckTableConfig | undefined;

package/dist/domain/table/business/check/check-table/index.d.ts

@@ -2,4 +2,5 @@ export { profile as checkTableProfile } from './profile';
 export { CHECK_TABLE_TYPE_TO_VALUE_FIELD } from './profile/field-keys';
 export * from './runtime';
 export * from './actions';
+export * from './front-config';
 export * from './types';

package/dist/domain/table/business/check/check-table/runtime/prepare-check-table-init.d.ts

@@ -1,13 +1,20 @@
 import { CheckTableItemInfosPayload, CheckTableRegionRef } from '../types';
-/**
- * 文档初始化前：一次扫描 → 并行拉检验项 → 原地扩 runtimeJson。
- * 须在 ModelConverter.toModel 之前调用；传入的 runtimeJson 须已是可写副本。
- */
-export declare function prepareCheckTableRuntimeJson<T extends Record<string, unknown>>(instanceId: string, runtimeJson: T): Promise<{
+import { ICheckTableConfig } from '../front-config';
+export type PrepareCheckTableRuntimeJsonResult<T extends Record<string, unknown>> = {
     runtimeJson: T;
     infosMap: Record<string, CheckTableItemInfosPayload>;
     regions: CheckTableRegionRef[];
-}>;
+    /** 本次打开解析/拉取到的检验表快照，保存时写入 frontConfig.checkTableConfig */
+    pendingCheckTableConfig?: ICheckTableConfig;
+};
+/**
+ * 文档初始化前：一次扫描 → 并行拉检验项（或读快照）→ 原地扩 runtimeJson。
+ * 须在 ModelConverter.toModel 之前调用；传入的 runtimeJson 须已是可写副本。
+ */
+export declare function prepareCheckTableRuntimeJson<T extends Record<string, unknown>>(instanceId: string, runtimeJson: T, options?: {
+    /** 实例已落库的 frontConfig（JSON 字符串） */
+    frontConfig?: string | null;
+}): Promise<PrepareCheckTableRuntimeJsonResult<T>>;
 /**
  * 文档初始化中：将检验项配置写入 defaultsMap（字段路径展开）。
  * 优先使用 prepare 返回的 regions，避免再次扫描 runtimeJson。