@gct-paas/word 0.1.38 → 0.1.41

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

@@ -57,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 设置数据
@@ -170,6 +174,17 @@ export declare class DataManager {
      * 这样可以保证：参数映射（`[n]`）先铺好默认值，自定义数据源（真实下标）再精确覆盖。
      */
     applyInitData(initDataMap: Record<string, any>): void;
+    /**
+     * 补齐二维/检验表的关联轴子表（如 f_ewblink / f_jianyan2）到动态关联铺砖槽位数。
+     * 不处理主体轴（如 f_ewb / f_jianyan1），避免覆盖接口行或误扩纵向轴。
+     */
+    private syncSubTableRowsToLayout;
+    /** 子表在 rawData 中的行数（支持尚未转成数组的 { data: [] } 接口形态，此时返回 0 且不在此阶段强转） */
+    private countSubTableDataRows;
+    /**
+     * 为检验表关联轴补足铺砖行：占位标记 + __gw_x_uid（与 push/insert 行为一致）。
+     */
+    private ensureCheckTableLinkLayoutRows;
     private applyInitDataCrossWildcard;
     /**
      * 解析子表初始化行数：接口已有行数、版面数据分组槽位。

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/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;