@gct-paas/word 0.1.22 → 0.1.23

package/dist/capabilities/model-field-runtime/provider/FieldProviderRuntime.d.ts

@@ -9,6 +9,10 @@ export declare abstract class FieldProviderRuntime {
     private idMap;
     constructor(base: FieldProviderBase, modelKey: ModelKey);
     fetchFields(params?: FieldQueryParams): Promise<FieldListResult>;
+    /** 同步获取字段 */
+    getFieldByKeySync(key: FieldKey): FieldMeta | undefined;
+    /** 同步获取字段 */
+    getFieldByIdSync(id: FieldId): FieldMeta | undefined;
     getFieldByKey(key: FieldKey): Promise<FieldMeta | undefined>;
     getFieldById(id: FieldId): Promise<FieldMeta | undefined>;
     getFieldList(): FieldMeta[];

package/dist/capabilities/model-field-runtime/service/FieldService.d.ts

@@ -13,6 +13,8 @@ export declare class FieldService {
     queryFieldList(modelKey: ModelKey, params?: any): Promise<FieldListResult>;
     queryFieldByKey(modelKey: ModelKey, fieldKey: FieldKey): Promise<FieldMeta | undefined>;
     queryFieldById(modelKey: ModelKey, id: FieldId): Promise<FieldMeta | undefined>;
+    queryFieldByKeySync(modelKey: ModelKey, fieldKey: FieldKey): FieldMeta | undefined;
+    queryFieldByIdSync(modelKey: ModelKey, id: FieldId): FieldMeta | undefined;
     getFieldList(modelKey: ModelKey): FieldMeta[];
     clear(modelKey: ModelKey): void;
     dispose(): void;

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

@@ -0,0 +1,50 @@
+/** 特殊原子节点位置 */
+export type Side = 'before' | 'after';
+/** 光标信息 */
+export interface ICursorPosition {
+    /** 节点的唯一key */
+    nodeId: string;
+    /** 纸张id */
+    pageId: string;
+    /** 父节点key */
+    preNodeId: string;
+    /** 归属节点key */
+    preLocation: string;
+    /** 节点路径，从根到当前节点 */
+    path: string[];
+    /** 节点索引路径: 每层在父节点数组中的下标 */
+    pathIndex: number[];
+    /** 偏移量 */
+    offset: number;
+    /** 特殊原子节点的光标“在前/在后” */
+    side: Side;
+    /** 是否是占位符 */
+    isPlaceholder: boolean;
+    /** 光标阶段 */
+    phase: 'preview' | 'commit';
+}
+/** 选区信息 */
+export interface ISelectionRange {
+    /** 起始点 */
+    anchor: ICursorPosition;
+    /** 结束点 */
+    focus: ICursorPosition;
+}
+/** 真正的文档选区 */
+export interface INormalizedRange {
+    rangeStart: ICursorPosition;
+    rangeEnd: ICursorPosition;
+}
+export type Rect = {
+    pageId: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export interface CursorIntent {
+    kind: 'boundary' | 'point' | 'continue';
+    offset: number;
+    side: Side;
+    dir?: 'left' | 'right' | 'up' | 'down';
+}

package/dist/core/index.d.ts

@@ -15,6 +15,8 @@ export type { DocInitOptions } from './view/Doc';
 export type { WidgetMeta } from './widget/widget-meta';
 export type { DocModeType, CompleteComponentType, BuiltinComponentType } from './constants';
 export type { LayoutNode } from './view/base/LayoutNode';
+export type { BuiltinComponentToLayoutNode, LayoutNodeForComponent } from './view/types';
+export { isLayoutInlineImage, isLayoutOverlayLayout, isLayoutPage, isLayoutParagraph, isLayoutTable, isLayoutTableCell, isLayoutTableRow, isLayoutTextRun, isLayoutTextWidget, } from './view/types';
 export type { Page } from './view/Page';
 export type { TextRun } from './view/runs/TextRun';
 export type { ImageRun } from './view/runs/ImageRun';

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

@@ -1,7 +1,7 @@
 import { Doc } from '../view/Doc';
 import { BaseMetaNode, LineInfo } from './types';
-import { LayoutNode } from '../view/base';
 import { Wp, Wtbl, Wtr, Wtc, Wr } from '../model/document';
+import { Page } from '../view/Page';
 type ModelMode = Wp | Wtbl | Wtr | Wtc | Wr;
 export declare class LayoutMapper {
     readonly doc: Doc;
@@ -22,7 +22,7 @@ export declare class LayoutMapper {
     buildModelMap(): void;
     getBaseMetaNodeById<T extends BaseMetaNode>(id?: string): T | undefined;
     getBaseMetaNodeByIds<T extends BaseMetaNode>(ids: string[]): T[] | undefined;
-    getLayoutNodeById<T extends LayoutNode>(id: string): T | undefined;
+    getLayoutNodeById(id: string): Page | import('../view/base').BandContainer | import('..').Paragraph | import('..').Table | import('../view/TableCell').TableCell | import('../view/TableRow').TableRow | import('..').OverlayLayout | import('../view/base').OverlayContainer | import('..').TextRun | import('..').ImageRun | undefined;
     getAllPageIds(): string[];
     getLineIdsByPageId(pageId: string): string[];
     getLineInfoById(lineId: string): LineInfo | undefined;

package/dist/core/layout/handlers/{ImageHandler.d.ts → InlineImageLayoutHandler.d.ts}

@@ -1,10 +1,9 @@
 import { WrImage } from '../../model/document';
 import { LayoutContext } from '../LayoutContext';
 /**
- * 图片 Run 布局策略
- * 负责图片尺寸计算和布局（整体处理）
+ * 行内 OOXML 图片（WrImage）布局策略：尺寸计算与 ImageRun 创建
  */
-export declare class ImageHandler {
+export declare class InlineImageLayoutHandler {
     static emuToPixels(emu: number): number;
     private static resolveImageQuery;
     static layout(context: LayoutContext, wr: WrImage): void;

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

@@ -1,6 +1,7 @@
-import { BaseHandler, HandlerContext } from './BaseHandler';
+import { FieldBaseHandler } from './FieldBaseHandler';
 import { TextRun } from '../../../view/runs/TextRun';
-export declare class AttachmentHandler extends BaseHandler {
+import { HandlerContext } from '../../types';
+export declare class AttachmentHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;
     static layoutField(ctx: HandlerContext): void;
     static layoutFileItem(payload: {

package/dist/core/layout/handlers/fields/{BaseHandler.d.ts → FieldBaseHandler.d.ts}

@@ -1,12 +1,9 @@
 import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextWidget } from '../../../view/runs/TextWidget';
+import { HandlerContext } from '../../types';
 type ValueType = string | number | undefined | null;
-export type HandlerContext = {
-    context: LayoutContext;
-    wr: WrText;
-};
-export declare class BaseHandler {
+export declare class FieldBaseHandler {
     static hasValue(value: ValueType): boolean;
     static getId(context: LayoutContext, wr: WrText): string;
     static get2DInfo(context: LayoutContext): {

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

@@ -0,0 +1,7 @@
+import { FieldBaseHandler } from './FieldBaseHandler';
+import { HandlerContext } from '../../types';
+/** 表单字段 fw:image 的布局处理 */
+export declare class FieldImageHandler extends FieldBaseHandler {
+    static layout(ctx: HandlerContext): void;
+    static layoutField(ctx: HandlerContext): void;
+}

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

@@ -1,5 +1,6 @@
-import { BaseHandler, HandlerContext } from './BaseHandler';
-export declare class InputHandler extends BaseHandler {
+import { FieldBaseHandler } from './FieldBaseHandler';
+import { HandlerContext } from '../../types';
+export declare class InputHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;
     static layoutField(ctx: HandlerContext): void;
 }

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

@@ -1,12 +1,13 @@
-import { BaseHandler, HandlerContext } from './BaseHandler';
+import { FieldBaseHandler } from './FieldBaseHandler';
 import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextRun } from '../../../view/runs/TextRun';
+import { HandlerContext } from '../../types';
 type WidgetOption = {
     value: any;
     label: string;
 };
-export declare class OptionHandler extends BaseHandler {
+export declare class OptionHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;
     static isVerticalLayout(wr: WrText): boolean;
     static layoutField(ctx: HandlerContext): void;

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

@@ -1,6 +1,7 @@
-import { BaseHandler, HandlerContext } from './BaseHandler';
+import { FieldBaseHandler } from './FieldBaseHandler';
 import { ImageWidgetOptions } from '../../../view/runs/ImageWidget';
-export declare class SignatureHandler extends BaseHandler {
+import { HandlerContext } from '../../types';
+export declare class SignatureHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;
     /**
      * 获取签名装饰信息

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

@@ -1,6 +1,5 @@
-export { BaseHandler, type HandlerContext } from './BaseHandler';
 export { OptionHandler } from './OptionHandler';
-export { ImageHandler } from './ImageHandler';
+export { FieldImageHandler } from './FieldImageHandler';
 export { SignatureHandler } from './SignatureHandler';
 export { InputHandler } from './InputHandler';
 export { AttachmentHandler } from './AttachmentHandler';

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

@@ -1,4 +1,4 @@
 export * from './TextHandler';
-export * from './ImageHandler';
+export * from './InlineImageLayoutHandler';
 export * from './FieldHandler';
 export * from './PageWidgetHandler';

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

@@ -1,6 +1,6 @@
-import { BaseHandler } from '../base/BaseHandler';
+import { WidgetBaseHandler } from './WidgetBaseHandler';
 import { ImageWidgetOptions } from '../../../view/runs/ImageWidget';
-export declare class BarcodeHandler extends BaseHandler {
+export declare class BarcodeHandler extends WidgetBaseHandler {
     getDecorationsInfo(width: number, height: number, label?: string): {
         render: boolean;
         rectWidth: number;

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

@@ -1,4 +1,4 @@
-import { BaseHandler } from '../base/BaseHandler';
-export declare class DefaultHandler extends BaseHandler {
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class DefaultHandler extends WidgetBaseHandler {
     layout(): void;
 }

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

@@ -1,4 +1,4 @@
-import { BaseHandler } from '../base/BaseHandler';
-export declare class DiagonalHandler extends BaseHandler {
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class DiagonalHandler extends WidgetBaseHandler {
     layout(): void;
 }

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

@@ -1,4 +1,4 @@
-import { BaseHandler } from '../base/BaseHandler';
-export declare class LineHandler extends BaseHandler {
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class LineHandler extends WidgetBaseHandler {
     layout(): void;
 }

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

@@ -0,0 +1,5 @@
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+/** 纸张组件 pw:image 的布局处理 */
+export declare class PageWidgetImageHandler extends WidgetBaseHandler {
+    layout(): void;
+}

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

@@ -1,5 +1,5 @@
-import { BaseHandler } from '../base/BaseHandler';
-export declare class PaginationHandler extends BaseHandler {
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class PaginationHandler extends WidgetBaseHandler {
     layout(): void;
     /** 解析 ${no} ${total} */
     private parseTokens;

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

@@ -1,4 +1,4 @@
-import { BaseHandler } from '../base/BaseHandler';
-export declare class QrCodeHandler extends BaseHandler {
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class QrCodeHandler extends WidgetBaseHandler {
     layout(): void;
 }

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

@@ -1,4 +1,4 @@
-import { BaseHandler } from '../base/BaseHandler';
-export declare class SerialNumberHandler extends BaseHandler {
+import { WidgetBaseHandler } from './WidgetBaseHandler';
+export declare class SerialNumberHandler extends WidgetBaseHandler {
     layout(): void;
 }

package/dist/core/layout/handlers/{base/BaseHandler.d.ts → pageWidgets/WidgetBaseHandler.d.ts}

@@ -2,11 +2,8 @@ import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextRun } from '../../../view/runs/TextRun';
 import { TableCell } from '../../../view/TableCell';
-export type HandlerContext = {
-    context: LayoutContext;
-    wr: WrText;
-};
-export declare abstract class BaseHandler {
+import { HandlerContext } from '../../types';
+export declare abstract class WidgetBaseHandler {
     context: LayoutContext;
     wr: WrText;
     constructor(ctx: HandlerContext);

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

@@ -2,7 +2,7 @@ export { SerialNumberHandler } from './SerialNumberHandler';
 export { DefaultHandler } from './DefaultHandler';
 export { QrCodeHandler } from './QrCodeHandler';
 export { BarcodeHandler } from './BarcodeHandler';
-export { ImageHandler } from './ImageHandler';
+export { PageWidgetImageHandler } from './PageWidgetImageHandler';
 export { DiagonalHandler } from './DiagonalHandler';
 export { PaginationHandler } from './PaginationHandler';
 export { LineHandler } from './LineHandler';

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

@@ -11,7 +11,7 @@ export declare function buildLayoutMeta(pages: Page[]): {
 /** 是否是原子组件 */
 export declare function isAtom(component: BuiltinComponentType): boolean;
 /** 判断是否为占位符文本原子节点 */
-export declare function isPlaceholderNode(node: any): boolean;
+export declare function isPlaceholderNode(node: BaseMetaNode): boolean;
 /**
  * 判断是否点击是字段组件节点
  * @param node - 节点

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

@@ -1,6 +1,12 @@
 import { BuiltinComponentType } from '../../constants';
-import { LayoutNode } from '../../view/base';
 import { TextRun } from '../../view/runs/TextRun';
+import { LayoutNodeForComponent } from '../../view/types/layout-node-by-component';
+import { LayoutContext } from '../LayoutContext';
+import { WrText } from '../../model/document';
+export type HandlerContext = {
+    context: LayoutContext;
+    wr: WrText;
+};
 export type LineType = 'paragraph' | 'tablerow' | undefined;
 export interface BuildCtx {
     currentPageId: string;
@@ -52,13 +58,15 @@ export interface Bounds {
     bottom: number;
 }
 export type TableSelectionMode = 'none' | 'mixed' | 'row-range' | 'cell-range' | 'cell-full' | 'cell-inner';
-export interface BaseMetaNode {
+/**
+ * 布局元数据公共字段（不含 `component` / `raw`）。
+ *
+ * **重要**：画布上的节点是 `LayoutNode` 子类实例，**没有** `raw` 属性。
+ * 仅在本结构的 `raw`（见 {@link BaseMetaNode}）上挂对应画布节点；不要用 `run.raw`。
+ */
+export interface BaseMetaNodeBase {
     /** 节点 id */
     id: string;
-    /** 组件类型 */
-    component: BuiltinComponentType;
-    /** 组件节点信息 */
-    raw?: LayoutNode;
     /** 章节引用 id */
     secRefId: string;
     /** 纸张 id */
@@ -126,3 +134,12 @@ export interface BaseMetaNode {
     lineTop?: number;
     lineBottom?: number;
 }
+/**
+ * 布局元数据：与 `component` 判别联合，`raw` 类型随 `component` 收窄（见 {@link LayoutNodeForComponent}）。
+ */
+export type BaseMetaNode = {
+    [C in BuiltinComponentType]: BaseMetaNodeBase & {
+        component: C;
+        raw?: LayoutNodeForComponent<C>;
+    };
+}[BuiltinComponentType];

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

@@ -1,4 +1,4 @@
-import { Wdocument } from './document';
+import { Wdocument, Wtbl } from './document';
 import { Wstyles } from './styles';
 import { Wimages } from './images';
 import { Wsettings } from './settings/Wsettings';
@@ -7,6 +7,7 @@ import { Wfooters } from './footers/Wfooters';
 import { Woverlays } from './overlays/Woverlays';
 import { Wr } from './document/Wp';
 import { Section } from '../view/Section';
+import { Child } from './document/Wbody';
 /**
  * Word 文档模型
  * 包含文档的所有组件（document、styles、images 等）
@@ -48,11 +49,22 @@ export declare class DocModel {
      * @returns 原始 JSON 格式 (可用于 xml2js 反向转换)
      */
     toXmlJson(): any;
+    /** 获取所有 children */
+    getAllChildren(): Child[];
+    /** 获取所有表格 */
+    getAllTables(): Wtbl[];
     /**
      * 获取所有同时存在 widgetMeta 和 valuePath 的实例
      * @returns Wr 实例数组（包含 widgetMeta 和 valuePath 的文本或图片 run）
      */
     getWidgetInstances(): Wr[];
+    /** 获取子表信息列表 */
+    getSubTableInfoList(): {
+        field: string;
+        key: string;
+        name: string;
+        subType: string;
+    }[];
     /** 根据 pageIndex 获取页眉实例 */
     getHeader(pageIndex: number, section: Section): import('./headers/Wheader').Wheader | null;
     /** 根据 pageIndex 获取页脚实例 */

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

@@ -1,5 +1,4 @@
 export * from './element';
 export * from './style';
 export * from './raw';
-export * from './model';
 export * from './region';

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

@@ -10,7 +10,7 @@ import { InteractionManager } from '../interaction/InteractionManager';
 import { DocModeType } from '../constants';
 import { CommandPayloadMap, RequiredPayloadCommands, OptionalPayloadCommands } from '../command/types';
 import { DocModel } from '../model';
-import { DocRuntimeMeta } from '../../sdk';
+import { DocRuntimeMeta, FieldModelQuery } from '../../sdk/types';
 export interface DocInitOptions {
     mode?: DocModeType;
     model?: DocModel;
@@ -27,6 +27,11 @@ export interface DocInitOptions {
     pagePadding?: [number, number, number, number];
     onLayoutChange?: (doc: Doc) => void;
     onSelectionChange?: (doc: Doc) => void;
+    /**
+     * 字段/模型查询（与套件 `SuiteRuntime` 同源）。
+     * 由文档工厂传入后，命令与布局等纯 TS 代码可通过 `doc.fieldModelQuery` 访问，无需 Vue inject。
+     */
+    fieldModelQuery: FieldModelQuery;
 }
 export declare class Doc {
     id: string;
@@ -56,6 +61,8 @@ export declare class Doc {
     docRuntimeMeta: DocRuntimeMeta;
     /** 外部的参数配置 */
     paramsConfig: Record<string, any>;
+    /** 字段/模型查询（由上层注入 `SuiteRuntime` 等实现） */
+    fieldModelQuery: FieldModelQuery;
     /** 安全距离-上下 */
     SAFE_DIST_Y: number;
     /** 安全距离-左右 */

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

@@ -65,6 +65,10 @@ export declare abstract class LayoutNode {
      * @returns
      */
     getPage(): Page | undefined;
+    /**
+     * 获取实例对应的 悬浮层
+     * @returns
+     */
     getOverlayLayout(): OverlayLayout | undefined;
     /**
      * 布局方法：计算并设置节点的绝对位置

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

@@ -32,6 +32,8 @@ export interface ITextRun {
     fontSize: number;
     /** 字体 */
     fontFamily: string;
+    /** 高亮 */
+    highlight: string;
     /** 文字颜色 */
     color: string;
     /** 加粗 */
@@ -71,6 +73,8 @@ export declare class TextRun extends LayoutNode implements ITextRun {
     fontSize: number;
     /** 字体 */
     fontFamily: string;
+    /** 高亮 */
+    highlight: string;
     /** 文字颜色 */
     color: string;
     /** 加粗 */

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

@@ -13,3 +13,5 @@ export interface Border {
     width?: number;
     style?: 'solid' | 'dashed' | 'dotted';
 }
+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/view/types/layout-node-by-component.d.ts

@@ -0,0 +1,38 @@
+import { BuiltinComponentType, BuiltinComponentTypeConst } from '../../constants';
+import { LayoutNode } from '../base/LayoutNode';
+import { BandContainer } from '../base/BandContainer';
+import { OverlayContainer } from '../base/OverlayContainer';
+import { OverlayLayout } from '../base/OverlayLayout';
+import { Page } from '../Page';
+import { Paragraph } from '../Paragraph';
+import { Table } from '../Table';
+import { TableRow } from '../TableRow';
+import { TableCell } from '../TableCell';
+import { TextRun } from '../runs/TextRun';
+import { TextWidget } from '../runs/TextWidget';
+import { ImageRun } from '../runs/ImageRun';
+/** 内置 `component` 取值到画布节点类型的映射（用于 `getLayoutNodeById(id, component)` 等） */
+export interface BuiltinComponentToLayoutNode {
+    [BuiltinComponentTypeConst.Paper]: Page;
+    [BuiltinComponentTypeConst.Header]: BandContainer;
+    [BuiltinComponentTypeConst.Footer]: BandContainer;
+    [BuiltinComponentTypeConst.OverlayContainer]: OverlayContainer;
+    [BuiltinComponentTypeConst.OverlayLayout]: OverlayLayout;
+    [BuiltinComponentTypeConst.Paragraph]: Paragraph;
+    [BuiltinComponentTypeConst.Text]: TextRun;
+    [BuiltinComponentTypeConst.InlineImage]: ImageRun;
+    [BuiltinComponentTypeConst.Table]: Table;
+    [BuiltinComponentTypeConst.TableRow]: TableRow;
+    [BuiltinComponentTypeConst.TableCell]: TableCell;
+}
+export type LayoutNodeForComponent<C extends BuiltinComponentType> = C extends keyof BuiltinComponentToLayoutNode ? BuiltinComponentToLayoutNode[C] : LayoutNode;
+export declare function isLayoutTextRun(node: LayoutNode | undefined | null): node is TextRun;
+/** 字段/页面文本组件（`TextWidget` 子类）；普通纯文本 run 为 `TextRun` 而非此类 */
+export declare function isLayoutTextWidget(node: LayoutNode | undefined | null): node is TextWidget;
+export declare function isLayoutInlineImage(node: LayoutNode | undefined | null): node is ImageRun;
+export declare function isLayoutParagraph(node: LayoutNode | undefined | null): node is Paragraph;
+export declare function isLayoutTable(node: LayoutNode | undefined | null): node is Table;
+export declare function isLayoutTableRow(node: LayoutNode | undefined | null): node is TableRow;
+export declare function isLayoutTableCell(node: LayoutNode | undefined | null): node is TableCell;
+export declare function isLayoutPage(node: LayoutNode | undefined | null): node is Page;
+export declare function isLayoutOverlayLayout(node: LayoutNode | undefined | null): node is OverlayLayout;

package/dist/core/view/utils/TextUtil.d.ts

@@ -8,6 +8,17 @@ export declare class TextUtil {
     private static readonly EAST_ASIAN_FULL_WIDTH_REGEX;
     /** 表单/文档中常见的几何符号 */
     private static readonly FULL_WIDTH_SYMBOL_REGEX;
+    /**
+     * 视觉间距系数
+     * 值 = fontSize * ratio
+     *
+     * 解决：
+     * - N·m
+     * - N/A
+     * - kg·m²
+     * 等符号贴太近的问题
+     */
+    private static readonly VISUAL_SPACING_MAP;
     private static fontMetricsCache;
     private static layoutSizeCache;
     /**
@@ -22,6 +33,25 @@ export declare class TextUtil {
      * @returns
      */
     static isFullWidthChar(char: string): boolean;
+    /**
+     * 获取字符视觉间距
+     *
+     * 注意：
+     * 这里不是 glyph width
+     * 而是用于排版推进的额外 advance width
+     *
+     * 例如：
+     * - N·m
+     * - N/A
+     *
+     * 中间符号真实宽度很小，
+     * 但视觉上需要 breathing space
+     *
+     * @param char
+     * @param fontSize
+     * @returns
+     */
+    static getVisualSpacing(char: string, fontSize: number): number;
     /**
      * 生成文本度量缓存键
      * @param payload
@@ -30,9 +60,9 @@ export declare class TextUtil {
      */
     private static getMeasureCacheKey;
     /**
-     * 计算度量 - 基于 JSON 序列化的缓存（LRU）
-     * 将最终的 config 序列化为缓存键，相同配置直接返回缓存结果
-     * 最近使用的项会被移到末尾，超限时删除最古老的项
+     * 计算字体度量
+     * ascent / descent
+     *
      * @param payload
      * @returns
      */
@@ -41,7 +71,31 @@ export declare class TextUtil {
         descent: number;
     };
     /**
-     * 计算单个字符布局大小 - 基于 JSON 序列化的缓存（LRU）
+     * 获取字符排版推进宽度
+     *
+     * 注意：
+     * 这里返回的是：
+     * advance width
+     *
+     * 而不是：
+     * glyph width
+     *
+     * 用于：
+     * - 自动换行
+     * - 光标推进
+     * - 文本布局
+     * - selection
+     *
+     * @param payload
+     * @returns
+     */
+    static getAdvanceWidth(payload: Konva.TextConfig): number;
+    /**
+     * 计算单字符布局大小
+     *
+     * 注意：
+     * width 使用 advance width
+     *
      * @param payload
      * @returns
      */
@@ -50,12 +104,12 @@ export declare class TextUtil {
         height: number;
     };
     /**
-     * 清除度量结果缓存
+     * 清除度量缓存
      */
     static clearMeasureCache(): void;
     /**
-     * 获取缓存大小信息
-     * @returns 返回测量缓存的大小 {fontMetrics, layoutSize}
+     * 获取缓存大小
+     * @returns
      */
     static getMeasureCacheSize(): {
         fontMetrics: number;