@gct-paas/word 0.1.45 → 0.1.46-beta.0

package/README.md

@@ -169,7 +169,7 @@ Vue 运行时注册函数。建议在 `createApp` 后、`mount` 前调用。
 
 `controller.value` 可用后，主要分为 4 类能力：
 
-1) 状态字段（响应式）：
+1. 状态字段（响应式）：
 
 - `id: string`：当前文档实例 id
 - `mode`：当前渲染模式
@@ -178,12 +178,12 @@ Vue 运行时注册函数。建议在 `createApp` 后、`mount` 前调用。
 - `pages`：当前页面数组
 - `docRuntimeMeta`：运行时元信息（接口返回 + 业务拼接）
 
-2) 查询 API（只读）：
+2. 查询 API（只读）：
 
 - `query.getWidgetByModelId(modelId)`：按模型字段 id 定位组件节点
 - `query.getPaperBySecRefId(id)`：按分节 refId 定位页面
 
-3) 编辑/控制 API：
+3. 编辑/控制 API：
 
 - `execute(command, payload?)`：执行内置命令（高级）
 - `undo()` / `redo()`：撤销与重做
@@ -192,7 +192,7 @@ Vue 运行时注册函数。建议在 `createApp` 后、`mount` 前调用。
 - `rawData()`：获取原始填报数据
 - `reload()`：手动触发文档重载
 
-4) 数据处理 API：
+4. 数据处理 API：
 
 - `validate()`：校验字段，返回错误映射或 `null`
 - `exportModel()`：导出 XmlJson 模型数据
@@ -223,7 +223,7 @@ if (!errors) {
 - 初始化 API：`setupPlatformAdapters`、`setupVueRuntime`
 - 引擎/类型：`useWord`、`DocModeTypeConst`、`PageSizeEnumConst`、`BuiltinComponentTypeConst`、`WordRuntime`、`DocController` 等
 - Vue 组件：`DocDesignLayout`、`DocRenderLayout`、`GctLayout`
-- 插件能力：`registerSuite`、`WordSuitePlugin`、`edhrSuitePlugin`
+- 插件能力：`registerSuite`、`WordSuitePlugin`、`edhrSuitePlugin`、`registerPanelSchemas`
 
 ## 插件扩展
 
@@ -262,6 +262,33 @@ const customPlugin: WordSuitePlugin = {
 };
 ```
 
+### 主工程注册属性面板（如数据加载）
+
+`edhrSuitePlugin` 不再内置注册 `data-load.basic`，需在 **edhr 插件之后** 由主工程注册：
+
+```ts
+import { edhrSuitePlugin, registerPanelSchemas, type WordSuitePlugin } from '@gct-paas/word';
+import DataLoadPanel from './panels/data-load/DataLoadPanel.vue';
+
+const hostPanelPlugin: WordSuitePlugin = {
+  key: 'host-panels',
+  install() {
+    registerPanelSchemas('edhr', {
+      'data-load.basic': {
+        key: 'data-load.basic',
+        title: '数据加载',
+        render: DataLoadPanel,
+      },
+    });
+  },
+};
+
+setupPlatformAdapters({
+  // ...
+  plugins: [edhrSuitePlugin, hostPanelPlugin],
+});
+```
+
 ## 最佳实践
 
 - `setupPlatformAdapters` 只在应用启动时调用一次，避免重复注册全局能力。

package/dist/capabilities/panel/schema/registry.d.ts

@@ -2,6 +2,6 @@ import { BaseRegistry } from '../../base/BaseRegistry';
 import { PanelSchema, PanelSchemaKey, PanelSchemaMap } from './types';
 /** 面板组件注册表 */
 export declare class PanelSchemaRegistry extends BaseRegistry<PanelSchemaKey, PanelSchema> {
-    register(suiteKey: SuiteKey, components: PanelSchemaMap): void;
+    register(suiteKey: SuiteKey, components: PanelSchemaMap, override?: boolean): void;
 }
 export declare const panelSchemaRegistry: PanelSchemaRegistry;

package/dist/core/cursor/CursorController.d.ts

@@ -1,3 +1,4 @@
+import { CommandResult } from '../command/types';
 import { Doc } from '../view/Doc';
 import { MoveOpts } from '../event/types';
 import { PointerHitResult } from './hit/types';
@@ -25,10 +26,14 @@ export declare class CursorController {
     }): void;
     private flushDragMove;
     onDragEndAt(_canvasX: number, _canvasY: number, pid: number | null, pos?: Pos): void;
-    /** 将当前光标重新对齐到指定节点 */
-    resolveCursorAtNode(data: any): void;
-    /** 将光标设置为选区对齐到指定节点 */
-    resolveCursorRange(start: any, end: any): void;
+    /** panel / 表单控件正在输入时，避免 layout 后 hidden-input 抢焦点 */
+    private isExternalInputFocused;
+    /** 将解析结果写入 CursorManager，并按需同步 hidden input */
+    private applyResolvedCursorState;
+    /** Command 执行后应用目标光标（与 layout 重锚定共用 resolve 逻辑） */
+    applyCommandCursorResult(result: CommandResult): void;
+    /** layout 重建后，按模式（设计/填报）重锚定光标与 hidden input */
+    realignAfterLayout(): void;
     /** 处理方向键移动 */
     keydownArrowKey(opts: MoveOpts): void;
     clearCursor(): void;

package/dist/core/cursor/composables/useCursorSelection.d.ts

@@ -3,6 +3,7 @@ import { ICursorPosition, ISelectionRange } from '../types/cursor';
 export declare function useCursorSelection(docInstance?: Doc): {
     cursor: import('vue').Ref<{
         nodeId: string;
+        modelId?: string | undefined;
         pageId: string;
         preNodeId: string;
         preLocation: string;
@@ -14,6 +15,7 @@ export declare function useCursorSelection(docInstance?: Doc): {
         phase: "preview" | "commit";
     } | null, ICursorPosition | {
         nodeId: string;
+        modelId?: string | undefined;
         pageId: string;
         preNodeId: string;
         preLocation: string;
@@ -27,6 +29,7 @@ export declare function useCursorSelection(docInstance?: Doc): {
     selection: import('vue').Ref<{
         anchor: {
             nodeId: string;
+            modelId?: string | undefined;
             pageId: string;
             preNodeId: string;
             preLocation: string;
@@ -39,6 +42,7 @@ export declare function useCursorSelection(docInstance?: Doc): {
         };
         focus: {
             nodeId: string;
+            modelId?: string | undefined;
             pageId: string;
             preNodeId: string;
             preLocation: string;
@@ -52,6 +56,7 @@ export declare function useCursorSelection(docInstance?: Doc): {
     } | null, ISelectionRange | {
         anchor: {
             nodeId: string;
+            modelId?: string | undefined;
             pageId: string;
             preNodeId: string;
             preLocation: string;
@@ -64,6 +69,7 @@ export declare function useCursorSelection(docInstance?: Doc): {
         };
         focus: {
             nodeId: string;
+            modelId?: string | undefined;
             pageId: string;
             preNodeId: string;
             preLocation: string;

package/dist/core/cursor/hit/types.d.ts

@@ -4,6 +4,8 @@ import { CursorIntent, Side } from '../types/cursor';
 import { Page } from '../../view/Page';
 export interface HitResult {
     id: string;
+    /** 对应 model 节点的 modelRef.id */
+    modelId?: string;
     offset: number;
     side: Side;
     path: string[];

package/dist/core/cursor/layout/baseMeta.d.ts

@@ -5,6 +5,8 @@ import { BaseMetaNode } from '../../layout/types';
  */
 export declare function getBaseMetaInfo(node: BaseMetaNode): {
     isPlaceholder: boolean;
+    /** model 侧 run 的 id，布局重建后可用于重锚定 */
+    modelId: string | undefined;
     path: string[];
     id: string;
     pathIndex: number[];

package/dist/core/cursor/logic/index.d.ts

@@ -1,6 +1,7 @@
 import { Doc } from '../../view/Doc';
 import { HitIntentResult, HitResult } from '../hit/types';
 import { ICursorPosition } from '../types/cursor';
+export { computeRealignedCursorState, cursorMetaToInput, cursorPositionToInput, resolveCursorPosition, resolveCursorStateFromMeta, resolveSelectionStateFromMeta, type CursorResolveInput, type ResolvedCursorState, } from './resolveCursorState';
 export { getCursorCoords } from './getCursorCoords';
 export { getCursorTextRawList } from './getCursorTextRawList';
 export { getSelectionRects } from './getSelectionRects';

package/dist/core/cursor/logic/resolveCursorState.d.ts

@@ -0,0 +1,24 @@
+import { CursorMeta } from '../../command/types';
+import { Doc } from '../../view/Doc';
+import { ICursorPosition, ISelectionRange } from '../types/cursor';
+/** 统一的光标解析输入（Command meta / 现有光标 / layout 重锚定） */
+export type CursorResolveInput = {
+    nodeId?: string;
+    modelId?: string;
+    offset: number;
+    side: 'before' | 'after';
+    phase: ICursorPosition['phase'];
+    pathIndex?: number[];
+};
+export type ResolvedCursorState = {
+    cursor: ICursorPosition | null;
+    selection: ISelectionRange | null;
+};
+export declare function cursorPositionToInput(cursor: ICursorPosition): CursorResolveInput;
+export declare function cursorMetaToInput(meta: CursorMeta, phase?: ICursorPosition['phase']): CursorResolveInput;
+/** 统一入口：将 meta / 光标 / layout 重锚定输入解析为 ICursorPosition */
+export declare function resolveCursorPosition(doc: Doc, input: CursorResolveInput): ICursorPosition | null;
+export declare function resolveCursorStateFromMeta(doc: Doc, meta: CursorMeta, phase?: ICursorPosition['phase']): ResolvedCursorState | null;
+export declare function resolveSelectionStateFromMeta(doc: Doc, start: CursorMeta, end: CursorMeta, phase?: ICursorPosition['phase']): ResolvedCursorState | null;
+/** layout 后按当前光标状态重锚定 */
+export declare function computeRealignedCursorState(doc: Doc): ResolvedCursorState | null;

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

@@ -4,6 +4,8 @@ export type Side = 'before' | 'after';
 export interface ICursorPosition {
     /** 节点的唯一key */
     nodeId: string;
+    /** 对应 model 节点的 modelRef.id */
+    modelId?: string;
     /** 纸张id */
     pageId: string;
     /** 父节点key */
@@ -14,9 +16,9 @@ export interface ICursorPosition {
     path: string[];
     /** 节点索引路径: 每层在父节点数组中的下标 */
     pathIndex: number[];
-    /** 偏移量 */
+    /** 偏移量（layout run 内的本地字符下标） */
     offset: number;
-    /** 特殊原子节点的光标“在前/在后” */
+    /** 特殊原子节点的光标"在前/在后" */
     side: Side;
     /** 是否是占位符 */
     isPlaceholder: boolean;

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

@@ -5,6 +5,14 @@ export type Data = Record<string, any>;
 export type PartialData = Partial<Data>;
 type JsonPath = string;
 type SubscriptionCallback = (newValue: any, oldValue: any) => void;
+/** 组件依赖按 runtime valuePath 写入的运行时配置（子表各行独立） */
+export type FieldRuntimeSpecificConfig = {
+    newReadonly?: boolean;
+    newRequired?: boolean;
+    newDisabled?: boolean;
+    /** assignment 策略「始终覆盖」时按行不可输入 */
+    cannotInput?: boolean;
+};
 /**
  * 数据管理器
  * 用于保存和操作原始 JSON 数据，支持基于 jsonpath 的读写操作
@@ -17,8 +25,9 @@ export declare class DataManager {
     private depQueue;
     private computing;
     private layoutScheduled;
-    private emitScheduled;
     private emitQueue;
+    /** 串行化 emit 批处理，供 init/refresh 等待 enrich 写回 _href_ 后再排版 */
+    private emitTail;
     private rawData;
     private postChangePipeline?;
     /** 无字段依赖的常量公式（如 true）已执行过的 depKey，防止重复 register 死循环 */
@@ -26,6 +35,11 @@ export declare class DataManager {
     /** 正在执行「注册时立即跑」的依赖，避免 setMultiple 再次走完整 postChange */
     private runningImmediateDep;
     private immediateDepDataTouched;
+    /** flushDependencies 期间由 dependency 写回的字段 path（供 enrichers 补跑） */
+    private flushingDependencies;
+    private dependencyFlushChangedPaths;
+    /** 组件依赖回调写入的运行时配置，按 runtime valuePath 隔离（避免子表行共享 widgetMeta） */
+    private fieldRuntimeConfigByPath;
     /**
      * 默认值 Map
      * key: jsonpath 路径 (支持 [n] 数组索引)
@@ -40,10 +54,35 @@ export declare class DataManager {
      * 调度 layout，自动合并同一微任务队列中的多个操作
      */
     attachPostChangePipeline(ctx: PostChangePipelineContext): void;
+    /** 文档初始化 / 刷新数据后，对已有 value 跑一轮后置 enrich */
+    runInitialPostChangeFlush(paths: JsonPath[]): Promise<void>;
+    /** 等待已入队的 emit 批处理（含 postChange / enrich 写回）全部完成 */
+    whenEmitSettled(): Promise<void>;
+    /**
+     * 对已注册的组件依赖全量重算（refresh 后 depGraph 已重建，需等 readonly/赋值稳定后再 enrich/layout）
+     */
+    flushAllFieldDependencies(): Promise<void>;
     private scheduleLayout;
     getLabelPath(path: JsonPath): JsonPath;
-    /** 供 PostChangePipeline 在同一微任务内刷新公式依赖 */
-    flushDependenciesNow(): Promise<void>;
+    getHrefPath(path: JsonPath): JsonPath;
+    getFieldRuntimeSpecificConfig(path: JsonPath): FieldRuntimeSpecificConfig | undefined;
+    setFieldRuntimeSpecificConfig(path: JsonPath, partial: FieldRuntimeSpecificConfig): void;
+    /** 子表插行后：index 及之后的行配置下标 +1 */
+    private shiftFieldRuntimeConfigAfterRowInsert;
+    /** 子表删行后：移除该行配置，其后行配置下标 -1 */
+    private shiftFieldRuntimeConfigAfterRowRemove;
+    private parseSubtableFieldPath;
+    /** 收集 depGraph 中所有 DepNode（按 key 去重） */
+    private collectDepNodes;
+    /** 依赖图结构变更后按 node.deps + targetPath 重建索引 */
+    private rebuildDepGraphIndex;
+    /** 子表插行后同步依赖 targetPath 下标 */
+    private shiftDependencyGraphAfterRowInsert;
+    /** 子表删行后移除该行依赖，并同步其后行的 targetPath 下标 */
+    private shiftDependencyGraphAfterRowRemove;
+    /** 供 PostChangePipeline 在同一微任务内刷新公式依赖，并返回联动写回的字段 path */
+    flushDependenciesNow(): Promise<JsonPath[]>;
+    private trackDependencyFieldChange;
     /**
      * 根据 jsonpath 获取原始数据（仅返回 rawData 中的值）
      * @param path jsonpath 路径 (例如: "document.body.children[0].text" 或 "user.name")
@@ -57,6 +96,8 @@ export declare class DataManager {
      * @returns 指定路径的标签值或原值，不存在返回 undefined
      */
     getLabel<T = any>(path: JsonPath): T | undefined;
+    /** 获取与 value 并存的超链接 href；无或不可链时为 null/undefined */
+    getHref<T = string>(path: JsonPath): T | null | undefined;
     /** 子表数组路径下未软删行数 */
     countActiveSubtableRows(arrayPath: JsonPath): number;
     /** 版面可见行下标 → rawData 数组实际下标 */
@@ -238,6 +279,8 @@ export declare class DataManager {
      * 调度 emit 事件，自动合并相同 path 的事件
      */
     private emit;
+    /** 排空 emit 队列（同批合并 path，期间新入队项会继续处理） */
+    private processEmitQueue;
     /**
      * 通知订阅者与依赖队列（不触发布局）
      * 实际执行 emit 逻辑

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

@@ -2,6 +2,8 @@
 export declare const LABEL_SUFFIX = "_lb_";
 /** 与 rawData 并存的外链 href 后缀（超链接字段） */
 export declare const HREF_SUFFIX = "_href_";
+/** 版面超链接文字颜色 */
+export declare const HYPERLINK_TEXT_COLOR = "#0563c1";
 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/enrichers/build-field-enrichers.d.ts

@@ -1,6 +1,7 @@
+import { Doc } from '../../view/Doc';
 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[];
+export declare function buildFieldEnricherRegistrations(instances: any[], ctx: PostChangePipelineContext, doc: Doc): DataEnricherRegistration[];
+/** 收集 init 后需 enrich 的运行时路径（按 rawData 实际行数展开） */
+export declare function collectInitialEnrichPaths(instances: Wr[], rawData: Record<string, any>): string[];

package/dist/core/data/enrichers/hyperlink-enricher.d.ts

@@ -0,0 +1,8 @@
+import { Doc } from '../../view/Doc';
+import { WidgetMeta } from '../../widget/widget-meta';
+import { DataEnricherRegistration } from '../enricher-types';
+export type HyperlinkEnricherOptions = Omit<DataEnricherRegistration, 'enrich'> & {
+    doc: Doc;
+    widgetMeta: WidgetMeta;
+};
+export declare function createHyperlinkEnricher(reg: HyperlinkEnricherOptions): DataEnricherRegistration;

package/dist/core/index.d.ts

@@ -3,7 +3,8 @@ export { useDocPubApiContext } from './utils/DocPubApiContext';
 export { useInteraction } from './interaction/useInteraction';
 export { formulaUtils } from './utils/calculate-formula';
 export { TextUtil } from './view/utils/TextUtil';
-export { resolveWidgetState } from './widget/widget-state';
+export { resolveWidgetState, resolveFieldSpecificConfig, isWidgetMetaReadonlyDisplay } from './widget/widget-state';
+export { isFieldHyperlinkMarked, hasFieldHyperlinkHref, shouldShowFieldHyperlink, } from './widget/field-hyperlink';
 export { validateTextWidgetMarker } from './layout/logic/LayoutBuilder';
 export { CommandType } from './command/types';
 export { ModelConverter } from './model';

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

@@ -0,0 +1,13 @@
+import { LayoutContext } from '../LayoutContext';
+import { DataSlotIndex } from '../../view/types';
+/** 子表数据下标解析与 layout modelRef.id 生成 基类 */
+export declare class RunHandlerBase {
+    /** 子表展开时当前单元格对应的数据下标（一维 dataIndex，或二维 horizontal/vertical 单轴下标） */
+    static getSubTableRunIndex(context: LayoutContext): number | undefined;
+    /** 从 subRenderer 生成 Run 上的 dataSlotIndex 快照 */
+    static buildDataSlotIndex(context: LayoutContext): DataSlotIndex | undefined;
+    /** 根据子表展开 / 页眉页脚上下文生成 layout modelRef.id。 */
+    static buildSplitModelRefId(context: LayoutContext, baseId: string): string;
+    /** 是否是交叉区域 */
+    private static buildCrossZoneModelRefId;
+}

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

@@ -1,11 +1,7 @@
 import { WrText } from '../../model/document';
 import { LayoutContext } from '../LayoutContext';
-export declare class TextHandler {
-    static getId(context: LayoutContext, wr: WrText): string;
-    static get2DInfo(context: LayoutContext): {
-        xDataIndex: number | undefined;
-        yDataIndex: number | undefined;
-    };
+import { RunHandlerBase } from './RunHandlerBase';
+export declare class TextHandler extends RunHandlerBase {
     /**
      * 合并部分run
      * @param context

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

@@ -2,22 +2,24 @@ import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextRun } from '../../../view/runs/TextRun';
 import { TextWidget } from '../../../view/runs/TextWidget';
+import { RunHandlerBase } from '../RunHandlerBase';
 import { HandlerContext } from '../../types';
+import { DataSlotIndex } from '../../../view/types';
 type ValueType = string | number | undefined | null;
-export declare class FieldBaseHandler {
+export declare class FieldBaseHandler extends RunHandlerBase {
     static hasValue(value: ValueType): boolean;
-    static getSubTableRunIndex(context: LayoutContext): number | undefined;
-    static getId(context: LayoutContext, wr: WrText): string;
-    static get2DInfo(context: LayoutContext): {
-        xDataIndex: number | undefined;
-        yDataIndex: number | undefined;
-    };
+    static getModelRefId(context: LayoutContext, wr: WrText): string;
+    static getDataSlotIndex(context: LayoutContext): DataSlotIndex | undefined;
     static getValue(ctx: HandlerContext, valuePath: string): any;
     static getLabel(ctx: HandlerContext, valuePath: string): any;
     static getNoValueLabel(ctx: HandlerContext): {
         label: string;
         type: 'placeholder' | 'fieldName' | 'noneLabel' | 'default';
     };
+    /** 存在 href 且（打印态 / 填报只读）时应用超链接排版样式 */
+    static shouldApplyHyperlinkLayoutStyle(ctx: HandlerContext, wr: WrText, templateValuePath: string): boolean;
+    /** 字段文本排版样式（含 rPr + 超链接样式） */
+    static resolveFieldTextLayoutStyle(ctx: HandlerContext, wr: WrText, templateValuePath: string): Partial<TextRun>;
     static formatFieldValue(ctx: HandlerContext, valuePath: string): any;
     /**
      * 渲染组件值 label -> value

package/dist/core/layout/handlers/pageWidgets/TimeDiffHandler.d.ts

@@ -0,0 +1,17 @@
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class TimeDiffHandler extends WidgetBaseHandler {
+    layout(): void;
+    private resolveLabel;
+    private calcTimeDiffLabel;
+    private shouldUsePlaceholder;
+    /** 按当前格式生成占位，如 --天--时--分--秒 */
+    private formatPlaceholder;
+    private resolveTimeMs;
+    private buildValuePath;
+    /**
+     * 解析字段父路径：布局时优先用当前单元格 subRenderer（二维表交叉/横向/纵向、动态表等），
+     * 与 InsertField / LayoutContext.getValuePath 行为一致。
+     */
+    private resolveFieldParentKey;
+    private formatDiff;
+}

package/dist/core/layout/handlers/pageWidgets/WidgetBaseHandler.d.ts

@@ -1,28 +1,19 @@
 import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextRun } from '../../../view/runs/TextRun';
+import { RunHandlerBase } from '../RunHandlerBase';
 import { TableCell } from '../../../view/TableCell';
 import { HandlerContext } from '../../types';
-export declare abstract class WidgetBaseHandler {
+import { DataSlotIndex } from '../../../view/types';
+export declare abstract class WidgetBaseHandler extends RunHandlerBase {
     context: LayoutContext;
     wr: WrText;
     constructor(ctx: HandlerContext);
-    /**
-     * 获取所在单元格
-     * @returns
-     */
+    /** 获取所在单元格 */
     getCell(): TableCell | null;
-    /**
-     * 获取所在子表的数据索引
-     * @returns
-     */
     getDataIndex(init?: 0 | null): number | null;
-    getPaperIndex(): number | null;
-    getId(): string;
-    get2DInfo(): {
-        xDataIndex: number | undefined;
-        yDataIndex: number | undefined;
-    };
+    getModelRefId(): string;
+    getDataSlotIndex(): DataSlotIndex | undefined;
     getLayoutStyle(): ReturnType<typeof TextRun.textStyle2LayoutStyle>;
     abstract layout(): void;
 }

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

@@ -6,3 +6,4 @@ export { PageWidgetImageHandler } from './PageWidgetImageHandler';
 export { DiagonalHandler } from './DiagonalHandler';
 export { PaginationHandler } from './PaginationHandler';
 export { LineHandler } from './LineHandler';
+export { TimeDiffHandler } from './TimeDiffHandler';

package/dist/core/view/base/LayoutNode.d.ts

@@ -7,8 +7,6 @@ type ModelRef = {
     id: string;
     start?: number;
     end?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
 };
 /**
  * 布局节点配置

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

@@ -1,5 +1,6 @@
 import { WidgetMeta } from '../../widget/widget-meta';
 import { ImageRun, IImageRun, ImageRunOptions } from './ImageRun';
+import { DataSlotIndex } from '../types';
 /**
  * 图片运行接口
  */
@@ -10,9 +11,7 @@ export interface IImageWidget extends IImageRun {
     widgetMeta?: WidgetMeta;
     signature?: string;
     pageWidgetMeta?: Record<string, any>;
-    dataIndex?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
+    dataSlotIndex?: DataSlotIndex;
 }
 export interface ImageWidgetOptions extends ImageRunOptions {
     /** 值路径 */
@@ -21,9 +20,7 @@ export interface ImageWidgetOptions extends ImageRunOptions {
     widgetMeta?: WidgetMeta;
     signature?: string;
     pageWidgetMeta?: IImageWidget['pageWidgetMeta'];
-    dataIndex?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
+    dataSlotIndex?: DataSlotIndex;
 }
 /**
  * 图片运行类
@@ -34,8 +31,6 @@ export declare class ImageWidget extends ImageRun implements IImageWidget {
     widgetMeta?: WidgetMeta;
     signature?: string;
     pageWidgetMeta?: IImageWidget['pageWidgetMeta'];
-    dataIndex?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
+    dataSlotIndex?: DataSlotIndex;
     constructor(options: ImageWidgetOptions);
 }

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

@@ -62,8 +62,9 @@ export interface TextRunOptions extends LayoutNodeOptions {
     valuePath?: string;
     ascent: number;
     descent: number;
-    style?: TextStyle;
-    charMetrics: CharMetric[];
+    /** 版面样式（由 textStyle2LayoutStyle 等产出，构造时合并到 run 上） */
+    style?: Partial<TextRun> | TextStyle;
+    charMetrics?: CharMetric[];
 }
 export declare class TextRun extends LayoutNode implements ITextRun {
     component: "text";

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

@@ -1,5 +1,6 @@
 import { WidgetMeta } from '../../widget/widget-meta';
 import { TextRun, ITextRun, TextRunOptions } from './TextRun';
+import { DataSlotIndex } from '../types';
 /**
  * 文本组件接口
  */
@@ -24,9 +25,7 @@ export interface ITextWidget extends ITextRun {
     widgetFieldRightMarker?: boolean;
     /** 页面组件元数据 */
     pageWidgetMeta?: WidgetMeta;
-    dataIndex?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
+    dataSlotIndex?: DataSlotIndex;
 }
 export interface TextWidgetOptions extends TextRunOptions {
     /** 组件元数据 */
@@ -41,10 +40,8 @@ export interface TextWidgetOptions extends TextRunOptions {
     widgetFileItem?: ITextWidget['widgetFileItem'];
     widgetFieldLeftMarker?: boolean;
     widgetFieldRightMarker?: boolean;
-    pageWidgetMeta: ITextWidget['pageWidgetMeta'];
-    dataIndex?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
+    pageWidgetMeta?: ITextWidget['pageWidgetMeta'];
+    dataSlotIndex?: DataSlotIndex;
 }
 export declare class TextWidget extends TextRun implements ITextWidget {
     widgetMeta?: WidgetMeta;
@@ -56,9 +53,7 @@ export declare class TextWidget extends TextRun implements ITextWidget {
     widgetFieldRightMarker?: boolean;
     widgetOption?: ITextWidget['widgetOption'];
     widgetFileItem?: ITextWidget['widgetFileItem'];
-    pageWidgetMeta: ITextWidget['pageWidgetMeta'];
-    dataIndex?: number;
-    xDataIndex?: number;
-    yDataIndex?: number;
+    pageWidgetMeta?: ITextWidget['pageWidgetMeta'];
+    dataSlotIndex?: DataSlotIndex;
     constructor(options: TextWidgetOptions);
 }

package/dist/core/view/types/index.d.ts

@@ -13,5 +13,14 @@ export interface Border {
     width?: number;
     style?: 'solid' | 'dashed' | 'dotted';
 }
+/** 子表展开数据槽下标 */
+export type DataSlotIndex = {
+    /** 一维子表 [n] */
+    dataIndex?: number;
+    /** 二维横向 [n_x] */
+    xDataIndex?: number;
+    /** 二维纵向 [n_y] */
+    yDataIndex?: number;
+};
 export type { BuiltinComponentToLayoutNode, LayoutNodeForComponent, } from './layout-node-by-component';
 export { isLayoutInlineImage, isLayoutOverlayLayout, isLayoutPage, isLayoutParagraph, isLayoutTable, isLayoutTableCell, isLayoutTableRow, isLayoutTextRun, isLayoutTextWidget, } from './layout-node-by-component';

package/dist/core/widget/field-hyperlink.d.ts

@@ -0,0 +1,12 @@
+import { Doc } from '../view/Doc';
+import { WidgetMeta } from './widget-meta';
+/** 静态标记：直接按超链接样式展示，不走 enrich / _href_ */
+export declare function isFieldHyperlinkMarked(widgetMeta: WidgetMeta | undefined | null): boolean;
+/** manifest 规则：依赖 enrich 写入的 path_href_ */
+export declare function hasFieldHyperlinkHref(doc: Doc, runtimePath: string): boolean;
+/**
+ * 是否按超链接展示/点击。
+ * - newHrefSuffix：有展示值 + 只读/打印即显示链接样式，无需 _href_
+ * - manifest hyperlink：需 enrich 写回 _href_ 后
+ */
+export declare function shouldShowFieldHyperlink(doc: Doc, widgetMeta: WidgetMeta | undefined | null, runtimePath: string): boolean;