@gct-paas/word 0.1.36 → 0.1.38

package/dist/base/select/src/basic-select.vue.d.ts

@@ -18,6 +18,8 @@ type __VLS_Props = {
     class?: string;
     /** 是否只读 */
     readonly?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
     /** 不显示右侧箭头 */
     noArrow?: boolean;
     /** 是否需要分组展示 */
@@ -64,6 +66,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     onEdit?: ((option: DropdownOption) => any) | undefined;
     "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
 }>, {
+    disabled: boolean;
     options: DropdownOption[];
     placeholder: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {

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")
@@ -54,7 +64,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 +116,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 路径
@@ -210,9 +222,10 @@ export declare class DataManager {
      */
     private emit;
     /**
+     * 通知订阅者与依赖队列（不触发布局）
      * 实际执行 emit 逻辑
      */
-    private doEmit;
+    private doEmitNotify;
     /**
      * 获取父路径
      */
@@ -256,6 +269,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/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/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;
     /**