@gct-paas/word 0.1.37 → 0.1.39

package/dist/core/command/commands/Backspace.d.ts

@@ -30,6 +30,8 @@ export declare class Backspace extends CommandBase<'backspace'> {
      * 处理组件 run 的删除
      */
     private handleWidgetRun;
+    /** 处理表格内联纸张组件（时间差/序号等）：整段删除，不按 char 删模型 */
+    private handleInlinePageWidgetRun;
     /** 处理悬浮 run 的删除 */
     private handleOverlayPageWidgetRun;
     /**

package/dist/core/data/DataManager.d.ts

@@ -1,4 +1,6 @@
 import { Doc } from '../view/Doc';
+import { PostChangePipelineContext } from './post-change-pipeline';
+export type EmitSource = 'user' | 'dependency' | 'enrichment' | 'parent';
 export type Data = Record<string, any>;
 export type PartialData = Partial<Data>;
 type JsonPath = string;
@@ -13,12 +15,17 @@ export declare class DataManager {
     private subscriptions;
     private depGraph;
     private depQueue;
-    private depScheduled;
     private computing;
     private layoutScheduled;
     private emitScheduled;
     private emitQueue;
     private rawData;
+    private postChangePipeline?;
+    /** 无字段依赖的常量公式（如 true）已执行过的 depKey，防止重复 register 死循环 */
+    private ranImmediateDepKeys;
+    /** 正在执行「注册时立即跑」的依赖，避免 setMultiple 再次走完整 postChange */
+    private runningImmediateDep;
+    private immediateDepDataTouched;
     /**
      * 默认值 Map
      * key: jsonpath 路径 (支持 [n] 数组索引)
@@ -32,8 +39,11 @@ export declare class DataManager {
     /**
      * 调度 layout，自动合并同一微任务队列中的多个操作
      */
+    attachPostChangePipeline(ctx: PostChangePipelineContext): void;
     private scheduleLayout;
     getLabelPath(path: JsonPath): JsonPath;
+    /** 供 PostChangePipeline 在同一微任务内刷新公式依赖 */
+    flushDependenciesNow(): Promise<void>;
     /**
      * 根据 jsonpath 获取原始数据（仅返回 rawData 中的值）
      * @param path jsonpath 路径 (例如: "document.body.children[0].text" 或 "user.name")
@@ -47,6 +57,10 @@ export declare class DataManager {
      * @returns 指定路径的标签值或原值，不存在返回 undefined
      */
     getLabel<T = any>(path: JsonPath): T | undefined;
+    /** 子表数组路径下未软删行数 */
+    countActiveSubtableRows(arrayPath: JsonPath): number;
+    /** 版面可见行下标 → rawData 数组实际下标 */
+    resolveSubtableVisibleIndex(arrayPath: JsonPath, visibleIndex: number): number;
     private assignField;
     /**
      * 根据 jsonpath 设置数据
@@ -54,7 +68,7 @@ export declare class DataManager {
      * @param value 要设置的值
      * @returns 是否设置成功
      */
-    set(path: JsonPath, value: any, source?: 'user' | 'dependency'): boolean;
+    set(path: JsonPath, value: any, source?: EmitSource): boolean;
     /**
      * 从带数字下标的 path 推断二维坐标（供 setMultiple / patch / 业务回填等无 modelRef 的场景）
      * - 单轴：$.f_ewb[0].f_name → y=0；$.f_ewblink[1].x → x=1（需能从 rawData 的交叉 key 识别轴，或命中 link 命名启发）
@@ -106,7 +120,9 @@ export declare class DataManager {
      * @param updates 路径与值的映射对象
      * @returns 是否全部设置成功
      */
-    setMultiple(updates: Record<JsonPath, any>, source?: 'user' | 'dependency'): boolean;
+    setMultiple(updates: Record<JsonPath, any>, source?: EmitSource): boolean;
+    /** 依赖赋值写回 rawData，不触发 emit（用于注册期常量公式立即执行） */
+    private applyDependencyWrites;
     /**
      * 在数组末尾添加一个或多个元素
      * @param path 数组的 jsonpath 路径
@@ -158,6 +174,17 @@ export declare class DataManager {
      * 这样可以保证：参数映射（`[n]`）先铺好默认值，自定义数据源（真实下标）再精确覆盖。
      */
     applyInitData(initDataMap: Record<string, any>): void;
+    /**
+     * 仅补齐检验表关联轴子表（如 f_jianyan2）到动态关联铺砖槽位数。
+     * 不处理检验项主体（f_jianyan1）与二维表，避免覆盖接口行或误扩纵向轴。
+     */
+    private syncSubTableRowsToLayout;
+    /** 子表在 rawData 中的行数（支持尚未转成数组的 { data: [] } 接口形态，此时返回 0 且不在此阶段强转） */
+    private countSubTableDataRows;
+    /**
+     * 为检验表关联轴补足铺砖行：占位标记 + __gw_x_uid（与 push/insert 行为一致）。
+     */
+    private ensureCheckTableLinkLayoutRows;
     private applyInitDataCrossWildcard;
     /**
      * 解析子表初始化行数：接口已有行数、版面数据分组槽位。
@@ -210,9 +237,10 @@ export declare class DataManager {
      */
     private emit;
     /**
+     * 通知订阅者与依赖队列（不触发布局）
      * 实际执行 emit 逻辑
      */
-    private doEmit;
+    private doEmitNotify;
     /**
      * 获取父路径
      */
@@ -256,6 +284,8 @@ export declare class DataManager {
     private collectDependencies;
     /** 统一执行组件依赖 */
     private flushDependencies;
+    /** 注册时立即执行无依赖的常量公式（true / 显示值等） */
+    private runImmediateDependency;
     /** 执行依赖 */
     private runDepsByPath;
     /** 运行公式 */

package/dist/core/data/data-path-suffix.d.ts

@@ -0,0 +1,7 @@
+/** 与 rawData 并存的 label 后缀（展示用） */
+export declare const LABEL_SUFFIX = "_lb_";
+/** 与 rawData 并存的外链 href 后缀（超链接字段） */
+export declare const HREF_SUFFIX = "_href_";
+export declare function getLabelPath(path: string): string;
+export declare function getHrefPath(path: string): string;
+export declare function isDerivedDataPath(path: string): boolean;

package/dist/core/data/enricher-types.d.ts

@@ -0,0 +1,6 @@
+export type DataEnricherRegistration = {
+    id: string;
+    valuePathTemplate: string;
+    match: (path: string) => boolean;
+    enrich: (path: string, value: unknown) => Promise<Record<string, unknown> | void>;
+};

package/dist/core/data/enrichers/build-field-enrichers.d.ts

@@ -0,0 +1,6 @@
+import { Wr } from '../../model/document';
+import { PostChangePipelineContext } from '../post-change-pipeline';
+import { DataEnricherRegistration } from '../enricher-types';
+export declare function buildFieldEnricherRegistrations(instances: Wr[], ctx: PostChangePipelineContext): DataEnricherRegistration[];
+/** 收集 init 后需 enrich 的运行时路径（将 [n] 等占位替换为 0） */
+export declare function collectInitialEnrichPaths(instances: Wr[]): string[];

package/dist/core/data/post-change-pipeline.d.ts

@@ -0,0 +1,102 @@
+import { FIELD_TYPE } from '../../domain/field/field-type';
+import { FieldManifest } from '../../capabilities/field-manifest';
+import { FieldMeta } from '../../capabilities/model-field-runtime';
+import { Doc } from '../view/Doc';
+import { DataManager, EmitSource } from './DataManager';
+/**
+ * Pipeline 运行时上下文
+ *
+ * 主要给 enrichers 使用：
+ * - 获取字段 manifest
+ * - 动态加载字段 meta
+ */
+export type PostChangePipelineContext = {
+    /**
+     * 根据字段类型获取 manifest
+     */
+    getFieldManifest: (type: FIELD_TYPE) => FieldManifest | undefined;
+    /**
+     * 根据模型 key + 字段 key 获取字段 meta
+     */
+    loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
+};
+/**
+ * 数据变更后的处理流水线
+ *
+ * 主要职责：
+ * 1. 等待依赖字段刷新完成
+ * 2. 根据 changedPaths 找到对应 enrichers
+ * 3. 执行 enrich 逻辑
+ * 4. 将 enrich 结果再次写回 DataManager
+ *
+ * 典型场景：
+ * - 自动填充字段
+ * - 字段联动
+ * - 数据增强
+ * - 根据某字段自动计算其它字段
+ */
+export declare class PostChangePipeline {
+    /**
+     * 数据管理器
+     */
+    private dataManager;
+    /**
+     * 文档实例
+     */
+    private doc;
+    /**
+     * 当前注册的 enrichers
+     *
+     * 每个 enricher：
+     * - match(path) 判断是否处理该字段
+     * - enrich(path, value) 生成补充数据
+     */
+    private enrichers;
+    /**
+     * 防止同一路径重复并发执行
+     *
+     * key:
+     *   path
+     *
+     * value:
+     *   当前执行中的 Promise
+     */
+    private inFlight;
+    /**
+     * pipeline 上下文
+     */
+    private pipelineCtx?;
+    constructor(
+    /**
+     * 数据管理器
+     */
+    dataManager: DataManager, 
+    /**
+     * 文档实例
+     */
+    doc: Doc);
+    /**
+     * 设置 pipeline 上下文
+     *
+     * 设置后会重新构建 enrichers
+     */
+    setContext(ctx: PostChangePipelineContext): void;
+    /**
+     * 重建 enricher 注册列表
+     *
+     * 从当前文档中的 widget instances
+     * 动态生成 enrichers
+     */
+    rebuildRegistrations(): void;
+    /**
+     * 变更后执行流水线
+     *
+     * @param changedPaths 本次变化的字段路径
+     * @param source       变更来源
+     */
+    flush(changedPaths: string[], source: EmitSource): Promise<void>;
+    /**
+     * 执行某个 path 对应的 enrichers
+     */
+    private runEnrichersForPath;
+}

package/dist/core/data/subtable-row.d.ts

@@ -0,0 +1,17 @@
+/** 子表行软删 / 可见下标与存储下标映射（与后端 deleted_ 约定一致） */
+type AxisType = 'x' | 'y';
+export type PersistedSubtableRowContext = {
+    rawData?: Record<string, any>;
+    /** 子表 key，如 f_ewb、f_ewblink（不含 $.） */
+    tableKey?: string;
+    axis?: AxisType;
+};
+/** 是否应软删（打 deleted_）而非 splice */
+export declare function isPersistedSubtableRow(row: Record<string, any> | undefined | null, ctx?: PersistedSubtableRowContext): boolean;
+/** 未软删的行数；空数组返回 0 */
+export declare function countActiveSubtableRows(rows: unknown): number;
+/** 版面可见行下标 → rawData 数组中的实际下标 */
+export declare function resolveSubtableStorageIndex(rows: any[], visibleIndex: number): number;
+/** 在可见下标处插入时对应的 splice 位置 */
+export declare function resolveSubtableInsertIndex(rows: any[], visibleIndex: number): number;
+export {};

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

@@ -48,6 +48,8 @@ export declare class LayoutContext {
      */
     getParagraphRemainingSize(): number;
     addRun(run: LayoutNode): void;
+    /** 子表可见行下标 → rawData 存储下标（跳过 deleted_ 行） */
+    private mapSubtableVisibleIndex;
     /**
      * 根据 dataIndex 替换 path 中的 [n] 为实际值
      * @param path 包含 [n] 的路径，如 "$.items[n].name"

package/dist/core/layout/handlers/FieldHandler.d.ts

@@ -2,4 +2,6 @@ import { WrText } from '../../model/document';
 import { LayoutContext } from '../LayoutContext';
 export declare class FieldHandler {
     static layout(context: LayoutContext, wr: WrText): void;
+    /** 检验表交叉区 value_：按同行检验项 type_ 渲染，值路径固定 value_ */
+    private static layoutCheckTableCrossValue;
 }

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

@@ -3,3 +3,4 @@ export { FieldImageHandler } from './FieldImageHandler';
 export { SignatureHandler } from './SignatureHandler';
 export { InputHandler } from './InputHandler';
 export { AttachmentHandler } from './AttachmentHandler';
+export { FieldBaseHandler } from './FieldBaseHandler';

package/dist/core/layout/logic/LayoutBuilder.d.ts

@@ -1,4 +1,5 @@
 import { BuiltinComponentType } from '../../constants';
+import { LayoutNode } from '../../view/base';
 import { TextWidget } from '../../view/runs/TextWidget';
 import { Page } from '../../view/Page';
 import { BaseMetaNode, LineInfo } from '../types';
@@ -30,3 +31,6 @@ export declare function validateTextWidgetMarker(raw: TextWidget, checkMarker: b
  * @param node - 节点
  */
 export declare function isClickPaperWidgetAllNode(node: BaseMetaNode): boolean;
+export declare function isOverlayPageWidgetType(type?: string): boolean;
+/** 表格内联纸张组件（时间差/序号等），布局为多 char run、模型为 WrPageWidget */
+export declare function isInlineTextPageWidgetRun(run?: LayoutNode | null): run is TextWidget;

package/dist/core/model/DocModel.d.ts

@@ -69,8 +69,8 @@ export declare class DocModel {
      * 根据版面数据分组 / 动态关联铺砖，计算子表字段在 rawData 中应初始化的行数。
      *
      * - 固定表：槽位归 subFieldKey（bounded + itemRegion）
-     * - 二维表 / 检验表：动态分组铺砖在关联轴，槽位归 linkFieldKey（如 f_ewblink）；
-     *   纵向 subFieldKey（如 f_ewb）不由 itemRegion 撑行，返回 0
+     * - 二维表 / 检验表：动态分组铺砖槽位归 linkFieldKey（如 f_jianyan2）；
+     *   纵向 subFieldKey（如 f_jianyan1）由检验项条数撑行，返回 0
      * - 其它子表无分组：返回 1
      */
     getSubTableLayoutSlotCount(subFieldKey: string): number;

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

@@ -110,6 +110,10 @@ export declare class WrText extends ModelNode {
     cloneWithId(id: string): WrText;
     /** 需要进行拼接成运行时的 modelId */
     cloneWithSuffix(suffix: string, index: string | undefined): WrText;
+    /**
+     * 按 layout run 的 modelRef.id 拼接运行时后缀（$p 页眉页脚 / @ 数据分组与动态关联）
+     */
+    cloneWithRuntimeRefFrom(runtimeModelRefId: string): WrText;
     /**
      * 从原始 XML JSON 转换为 WrText 实例
      * @param json w:r XML JSON 对象

package/dist/core/utils/expand.d.ts

@@ -116,6 +116,16 @@ export declare class TableExpander {
     private getFillEndColForRegion;
     private findLinkSubTableRegionForCell;
     private resolveLinkSubTableCellMeta;
+    /**
+     * 检验表纵向主体下标（对应 subValuePath 上的 [n] / 交叉区 [n_y]）。
+     * 二维表由 repeat 展开赋值；检验表由接口预扩行，按主体行在 region 内的偏移计算。
+     */
+    private applyCheckTableYDataIndex;
+    private resolveCheckTableYDataIndex;
+    /** 检验表主体数据条数（与二维表 repeatCount 同源） */
+    private getCheckTableDataCount;
+    /** 单条数据占用的主体模板行数（接口预扩行后由「扩后行数 / 数据条数」反推） */
+    private getCheckTableTemplateBodyRowStride;
     /** 根据主单元格的 rowspan/colspan，为被覆盖的从属单元格设置 mergeFromId */
     private transformMergeRelations;
     /**