@gct-paas/word 0.1.74-beta.9 → 0.2.1

package/README.md

@@ -158,7 +158,10 @@ Vue 运行时注册函数。建议在 `createApp` 后、`mount` 前调用。
 - `options.factoryType`：`'template' | 'instance'`
 - `options.modelKey`：主模型 key
 - `options.suiteKey?`：套件 key（默认常用 `edhr`）
-- `options.isPreview?` / `options.isDetailPage?` / `options.renderModeType?`：运行模式控制
+- `options.isPreview?` / `options.isRefer?` / `options.isDetailPage?` / `options.renderModeType?`：运行模式控制
+  - `isPreview`：设计器预览，隐藏 ribbon / toolkit / panel
+  - `isRefer`：设计器引用只读（对齐 Excel `DesignMode.Refer`），仅保留右侧属性 panel（隐藏 ribbon / toolkit），禁止编辑
+  - `isPreview` 与 `isRefer` **互斥**；同时为 true 时忽略 `isPreview`，仅启用 `isRefer`
 
 返回值：
 

package/dist/assets/svgs/table/index.d.ts

@@ -13,12 +13,17 @@ export declare const TABLE_DATA_SVG: {
 /** 业务表下拉项图标（按 tableType） */
 export declare const TABLE_BUSINESS_SVG: {
     readonly 'warehouse-in': string;
+    readonly 'warehouse-inbound': string;
     readonly 'warehouse-out': string;
+    readonly 'warehouse-outbound': string;
     readonly 'warehouse-in-out': string;
     readonly 'warehouse-inventory': string;
+    readonly 'part-stocktake': string;
+    readonly 'device-part-consume': string;
     readonly 'warehouse-allocate': string;
     readonly 'material-consume': string;
     readonly 'material-balance': string;
+    readonly 'material-requisition': string;
     readonly 'check-table': string;
     readonly 'pretreatment-list': string;
     readonly 'entrust-steril-batch-list': string;

package/dist/base/modal/src/ModalRoot.vue.d.ts

@@ -2,6 +2,7 @@ import { IModalProps } from './modal.type';
 declare const _default: import('vue').DefineComponent<IModalProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<IModalProps> & Readonly<{}>, {
     body: import('vue').Component | null;
     title: string;
+    readonly: boolean;
     width: number;
     zIndex: number;
     className: string;

package/dist/base/modal/src/modal.type.d.ts

@@ -30,6 +30,11 @@ export interface IModalOptions {
     draggable?: boolean;
     /** 是否显示遮罩，draggable 时默认 false */
     showMask?: boolean;
+    /**
+     * 只读查看：隐藏取消/继续确认，确认按钮变为「关闭」且不落盘；
+     * body 内容入口锁，仅可滚动查看。
+     */
+    readonly?: boolean;
     onConfirm?: (ins: IModalInstance) => Promise<void> | void;
     onConfirmContinue?: (ins: IModalInstance) => Promise<void> | void;
     onCancel?: (ins: IModalInstance) => Promise<void> | void;

package/dist/base/rdo-tree-select/src/rdo-tree-select-more.vue.d.ts

@@ -1,8 +1,15 @@
-declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+type __VLS_Props = {
+    label?: string;
+    muted?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "load-more": () => any;
-}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onLoad-more"?: (() => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+}>, {
+    label: string;
+    muted: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     targetRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/base/rdo-tree-select/src/rdo-tree-select-panel.vue.d.ts

@@ -7,6 +7,9 @@ type __VLS_Props = {
     disabledParent?: boolean;
     parentToDefault?: boolean;
     emptyText?: string;
+    loadMoreLabel?: string;
+    mutedLoadMore?: boolean;
+    maxHeight?: number;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     select: (node: RdoTreeNode) => any;
@@ -16,5 +19,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     onSelect?: ((node: RdoTreeNode) => any) | undefined;
     onToggle?: ((key: string | number) => any) | undefined;
     "onLoad-more"?: (() => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+}>, {
+    maxHeight: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/base/rdo-tree-select/src/rdo-tree-select.vue.d.ts

@@ -24,8 +24,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
 }>, {
     modelCategory: string;
     disabled: boolean;
-    placeholder: string;
     pageSize: number;
+    placeholder: string;
     popperWidth: number;
     allowClear: boolean;
     disabledParent: boolean;

package/dist/base/scrollbar/src/scrollbar.vue.d.ts

@@ -4,7 +4,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: boolean;
     };
     wrapStyle: {
-        type: (ArrayConstructor | StringConstructor | ObjectConstructor)[];
+        type: (ArrayConstructor | ObjectConstructor | StringConstructor)[];
         default: string;
     };
     wrapClass: {
@@ -46,7 +46,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: boolean;
     };
     wrapStyle: {
-        type: (ArrayConstructor | StringConstructor | ObjectConstructor)[];
+        type: (ArrayConstructor | ObjectConstructor | StringConstructor)[];
         default: string;
     };
     wrapClass: {

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

@@ -22,14 +22,22 @@ type __VLS_Props = {
     disabled?: boolean;
     /** 不显示右侧箭头 */
     noArrow?: boolean;
+    /** 多选模式下也显示右侧箭头 */
+    multipleArrow?: boolean;
     /** 是否允许清除 */
     allowClear?: boolean;
+    /** 多选时不可从标签或清空操作移除的值 */
+    unremovableValues?: Array<string | number>;
+    /** 多选标签最大显示数量，responsive 时根据容器宽度自动折叠 */
+    maxTagCount?: number | 'responsive';
     /** 弹窗选择模式：编辑态外观，点击不展开下拉 */
     picker?: boolean;
     /** 是否需要分组展示 */
     grouped?: boolean;
     /** 是否支持输入创建 tag */
     allowCreate?: boolean;
+    /** 下拉选项是否可搜索 */
+    searchable?: boolean;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -57,6 +65,8 @@ declare function __VLS_template(): {
             Defaults: {};
         }, Record<string, any> & {}, {}, {}, {}, {}, {}> | null;
         triggerRef: HTMLDivElement;
+        measureTagRefs: HTMLSpanElement[];
+        measureRestRef: HTMLSpanElement;
         inputRef: HTMLInputElement;
     };
     rootEl: HTMLDivElement;
@@ -79,6 +89,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     options: DropdownOption[];
     placeholder: string;
     allowClear: boolean;
+    unremovableValues: Array<string | number>;
+    searchable: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     dropdownRef: import('vue').CreateComponentPublicInstanceWithMixins<Record<string, any> & {}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, {}, {}, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
@@ -89,6 +101,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
         Defaults: {};
     }, Record<string, any> & {}, {}, {}, {}, {}, {}> | null;
     triggerRef: HTMLDivElement;
+    measureTagRefs: HTMLSpanElement[];
+    measureRestRef: HTMLSpanElement;
     inputRef: HTMLInputElement;
 }, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/base/utils/image-size-util.d.ts

@@ -34,6 +34,8 @@ export declare function computeContainLayout(natural: ImageSize, box: ImageSize)
  * 在目标框内等比缩放（contain），不压缩、不拉伸
  */
 export declare function computeContainDisplaySize(natural: ImageSize, box: ImageSize): ImageSize;
+/** 同步取无图签名缓存（布局重建时可避免先闪占位再异步补图） */
+export declare function getCachedSignatureImage(name: string, width?: number, height?: number, time?: number | string): HTMLImageElement | null;
 /**
  * 创建无图签名兜底图（用户名 + 电子签名 + 验证日期）
  * 按字段宽高绘制，显示框设多大，字就按多大排

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

@@ -5,5 +5,9 @@ import { Wtbl } from '../../model/document';
 export declare class InsertTable extends CommandBase<'insertTable'> {
     constructor(doc: Doc, payload?: CommandPayloadMap['insertTable']);
     protected createTable(width: number, rowCount?: number, colCount?: number): Wtbl;
+    private resolveBlockedTableLabel;
     protected execute(): Promise<PostCommandContext>;
+    private insertAtCursor;
+    private insertIntoBody;
+    private insertIntoCell;
 }

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

@@ -14,5 +14,9 @@ export declare class UnmergeCells extends CommandBase<'unmergeCells'> {
         pos: number;
         side: string;
         wp?: undefined;
-    } | null | undefined>;
+    } | null>;
+    /** 光标落在合并格内时，解析其 merge root */
+    private resolveRootsFromCursor;
+    /** 框选单元格时，收集选区内的 merge roots */
+    private resolveRootsFromSelection;
 }

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

@@ -151,6 +151,7 @@ export type CommandPayloadMap = {
     };
     setFontSize: CommandPayload & {
         fontSize: number;
+        fontSizeOption?: string;
     };
     setUnderline: CommandPayload & {
         underline?: string;

package/dist/core/constants/index.d.ts

@@ -2,3 +2,4 @@ export * from './common';
 export * from './component';
 export * from './doc-mode';
 export * from './paper';
+export * from './table';

package/dist/core/constants/table.d.ts

@@ -0,0 +1,11 @@
+/** 外表列/单元格最小宽度（像素），与手动拖列宽下限一致 */
+export declare const MIN_TABLE_COL_WIDTH_PX = 30;
+/** 外表列/单元格最小宽度（DXA） */
+export declare const MIN_TABLE_COL_WIDTH_DXA: number;
+/** 嵌套表内单列最小宽度（DXA，约 0.5"） */
+export declare const MIN_NESTED_TABLE_COL_WIDTH_DXA = 720;
+/**
+ * 业务表 / 数据表 region 类型集合。
+ * 用于：嵌套表插入拦截、内外表业务数据标记互斥。
+ */
+export declare const BUSINESS_DATA_REGION_TYPES: ReadonlySet<string>;

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

@@ -1,6 +1,19 @@
 import { Doc } from '../../view/Doc';
 import { ISelectionRange, Rect } from '../types/cursor';
 /**
- * 将 selection（逻辑选区）转换成一组视觉矩形（canvas 绝对坐标）
+ * 将 selection（逻辑选区）转换成一组视觉矩形（canvas 绝对坐标）和单元格 ID 集合。
+ *
+ * 高亮策略（按模式）：
+ *  - cell-range / cell-full / mixed(表格行部分)
+ *      → cellRangeIds：由 table-cell.vue 在内容层渲染选中背景，
+ *        内表格单元格的白色背景会自然覆盖外格蓝色，无需额外处理。
+ *  - cell-inner
+ *      → rects：cursor 覆盖层渲染文字级别高亮；
+ *        只保留属于 selectionTableId 的原子节点（过滤掉内表格 atoms，解决 Q6 场景）。
+ *  - mixed(段落部分) / 纯段落
+ *      → rects：cursor 覆盖层渲染。
  */
-export declare function getSelectionRects(doc: Doc, selection: ISelectionRange, upgrade: boolean): Rect[];
+export declare function getSelectionRects(doc: Doc, selection: ISelectionRange, upgrade: boolean): {
+    rects: Rect[];
+    cellRangeIds: string[];
+};

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

@@ -5,7 +5,8 @@ export { computeRealignedCursorState, cursorMetaToInput, cursorPositionToInput,
 export { getCursorCoords } from './getCursorCoords';
 export { getCursorTextRawList } from './getCursorTextRawList';
 export { getSelectionRects } from './getSelectionRects';
-export { getSelectLinesInfo } from './selectionAnalyzer';
+export { getSelectLinesInfo, resolveSelectionTableScope, resolveTableScopeFromCursor, resolveTableScopeFromModelNode, resolveWpFromCursor, } from './selectionAnalyzer';
+export type { TableScope } from '../../model/document/Wtbl';
 export { getImmediateNeighborNode, findFirstAtomBeyond, isAtBoundaryOfNode, findTargetLineId, locateByX, } from './layoutNavigation';
 /**
  * 将命中结果转换为光标位置

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

@@ -1,12 +1,32 @@
-import { BaseMetaNode, LineInfo, TableSelectionMode } from '../../layout/types';
+import { BaseMetaNode, LineInfo } from '../../layout/types';
 import { Doc } from '../../view/Doc';
 import { ISelectionRange } from '../types/cursor';
+import { ModelNode } from '../../model/base';
+import { TableScope } from '../../model/document/Wtbl';
+import { Wp } from '../../model/document';
+/** 从 model 节点向上解析当前表格作用域 */
+export declare function resolveTableScopeFromModelNode(node: ModelNode): TableScope | undefined;
+/** 从光标定位当前 Wtbl 作用域（含嵌套表内光标） */
+export declare function resolveTableScopeFromCursor(doc: Doc): TableScope | undefined;
+/** 从当前选区解析表格作用域（仅单表，跨内外表时返回 undefined） */
+export declare function resolveSelectionTableScope(doc: Doc): TableScope | undefined;
+/** 从光标向上解析所在段落的 Wp（兼容 placeholder 空行） */
+export declare function resolveWpFromCursor(doc: Doc): Wp | undefined;
 /**
+ * 计算选区的行级信息（scopedSelectedLines、tableMode、rangeWidgetIds 等）。
  *
- * @param doc
- * @param selection
- * @param upgrade 单元格是否升级成单个单元格选中
- * @returns
+ * 过滤规则：
+ *  - anchor 在嵌套表格内 → 严格夹紧在该嵌套表，不纳入外部行/段落
+ *  - 其他情况         → 纳入所有顶层表格行 + 所有段落
+ *
+ * tableMode 决定策略：
+ *  - mixed      → 多张顶层表 OR (表格行 + 段落) → 选整行；段落单独生成 rect
+ *  - cell-range → 单张表、多行或跨列
+ *  - cell-inner → 单张表、单行、同一列（单格内文字选区）
+ *  - cell-full  → cell-inner 升级：选中整格（isCellUpgrade）
+ *  - none       → 纯段落 / 空
+ *
+ * @param upgrade 鼠标在 cellHitPoint 角上，允许 cell-inner → cell-full 升级
  */
 export declare function getSelectLinesInfo(doc: Doc, selection: ISelectionRange, upgrade: boolean): {
     normalized: import('../types/cursor').INormalizedRange;
@@ -16,8 +36,13 @@ export declare function getSelectLinesInfo(doc: Doc, selection: ISelectionRange,
     startPageIdx: number;
     endPageIdx: number;
     selectedLines: LineInfo[];
-    tableMode: TableSelectionMode;
+    tableMode: "none" | "mixed" | "cell-range" | "cell-full" | "cell-inner";
     overlapIds: string[];
     widgetRunMap: Map<string, BaseMetaNode[]>;
     rangeWidgetIds: string[];
+    selectionTableId: string | undefined;
+    anchorCellIndex: number | undefined;
+    focusCellIndex: number | undefined;
+    /** focus 越界夹紧方向：true=夹末列，false=夹首列，undefined=已有精确值 */
+    focusClampToLast: boolean | undefined;
 } | undefined;

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

@@ -1,5 +1,5 @@
 import { Doc } from '../../view/Doc';
-import { PostChangePipelineContext, DataEnricherRegistration } from '../types';
+import { DataEnricherRegistration, PostChangePipelineContext } from '../types';
 import { FieldComputedConfig } from '../../../domain/field/field-props-schema-type';
 /**
  * 解析 enricher 用的 widget props

package/dist/core/data/enrichers/lot-parent-label-enricher.d.ts

@@ -0,0 +1,12 @@
+import { Doc } from '../../view/Doc';
+import { DataEnricherRegistration } from '../types';
+export type LotParentLookupBy = 'name' | 'id';
+/** 生产 LOT/SN 字段保存子批次 ID 时，解析其子批次名称。 */
+export declare function resolveProductionContainerChildName(childId: unknown): Promise<string | undefined>;
+type LotParentLabelEnricherOptions = {
+    doc: Doc;
+    valuePath: string;
+    lookupBy?: LotParentLookupBy;
+};
+export declare function createLotParentLabelEnricher(options: LotParentLabelEnricherOptions): DataEnricherRegistration;
+export {};

package/dist/core/data/enrichers/operation-receive-qty-enricher.d.ts

@@ -0,0 +1,19 @@
+import { Doc } from '../..';
+import { DataEnricherRegistration } from '..';
+import { FIELD_TYPE } from '../../../domain/field/field-type';
+export interface OperationReceiveQtyWidgetTarget {
+    valuePath: string;
+}
+type OperationReceiveQtyWidgetInstance = {
+    widgetMeta?: {
+        field?: {
+            fieldType?: FIELD_TYPE;
+        };
+    };
+    valuePath?: string;
+};
+/** 从单个 widget 实例解析工序接收数量 enrich 目标 */
+export declare function tryCollectOperationReceiveQtyTarget(instance: OperationReceiveQtyWidgetInstance): OperationReceiveQtyWidgetTarget | null;
+/** 工序接收数量：getOne query 取 container_id_ / routing_operation_id_，空值时拉取 qty_current_ */
+export declare function createOperationReceiveQtyEnricher(doc: Doc, targets: OperationReceiveQtyWidgetTarget[]): DataEnricherRegistration;
+export {};

package/dist/core/data/submit/form-state.d.ts

@@ -26,4 +26,4 @@ export declare function conversionFormState(payload: {
 /** 从模型子表元信息解析二维/检验表交叉区 key；无元信息时回退为 formData 中含 `:` 的 key */
 export declare function resolveSubmitCrossKeys(formData: Record<string, any>, subTableInfoList?: SubTableInfo[]): string[];
 /** 数据转成真实提交数据 */
-export declare function getSubmitFormData(formData: any, subTableInfoList?: SubTableInfo[]): any;
+export declare function getSubmitFormData(formData: any, subTableInfoList?: SubTableInfo[], fieldList?: FieldMeta[]): any;

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

@@ -65,4 +65,4 @@ export type MoveOpts = Pick<KeydownOpts, 'dir' | 'shift' | 'ctrl'>;
  * 定义了系统中所有需要进行分发/调度的事件类型标识
  */
 export type DispatchEventType = 'ime:compositionstart' | 'ime:compositionupdate' | 'ime:compositionend' | 'ime:input' | 'ime:paste' | 'ime:focus' | 'ime:blur' | 'ime:keydown' | 'caret:locate' | 'konva:click' | 'konva:dragstart' | 'konva:dragmove' | 'konva:dragend' | 'konva:contextmenu' | 'inter:str' | 'inter:stc' | 'inter:stall' | 'inter:active' | 'inter:chg-hmid';
-export type EventBusType = 'autoScroll:start' | 'autoScroll:move' | 'autoScroll:stop' | 'caret:changed' | 'caret:requestScroll' | 'cursor:change' | 'cursor:changed' | 'tableSelection:change' | 'activeTableId:change' | 'dragHoverId:change' | 'hoverModelId:change' | 'focusModelId:change' | 'panelData:change';
+export type EventBusType = 'autoScroll:start' | 'autoScroll:move' | 'autoScroll:stop' | 'caret:changed' | 'caret:requestScroll' | 'cursor:change' | 'cursor:changed' | 'tableSelection:change' | 'activeTableId:change' | 'activeTableScope:change' | 'dragHoverId:change' | 'hoverModelId:change' | 'focusModelId:change' | 'panelData:change';

package/dist/core/index.d.ts

@@ -29,7 +29,7 @@ export type { WrPageWidget } from './model/document';
 export type { Border, Paragraph } from './view/Paragraph';
 export type { OverlayLayout } from './view/base/OverlayLayout';
 export type { Table } from './view/Table';
-export type { SubRenderer } from './view/TableCell';
+export type { SubRenderer, TableCellContent } from './view/TableCell';
 export type { Wtbl } from './model/document';
 export type { BoundedRegion, CheckTableRegion, _2DTableRegion } from './model/logic';
 export type { WidgetStateContext } from './widget/state';

package/dist/core/interaction/InteractionController.d.ts

@@ -1,6 +1,7 @@
 import { ActivePanelData, PanelType } from '../../domain/active/active-types';
 import { Doc } from '../view/Doc';
 import { ContextMenuParams } from '../../runtime/canvas/__common__/context-menu/index.type';
+import { ActiveTableScopeState } from './types';
 export declare class InteractionController {
     doc: Doc;
     constructor(doc: Doc);
@@ -16,10 +17,20 @@ export declare class InteractionController {
     onSelectTableAll(payload: {
         id: string;
     }): void;
+    /**
+     * 根据行/列范围设置 cursor selection，驱动 cellRangeIds 内容层高亮。
+     *
+     * @param tableId  目标表格 layout ID
+     * @param options.rowRange  [startRowIdx, endRowIdx]（默认全表）
+     * @param options.colRange  [startColIdx, endColIdx]（默认全列）
+     */
+    private _setTableCursorSelection;
     clearTableSelection(): void;
     onChangeDragHoverId(hitId: string): void;
     onSetActiveTableId(tableId: string): void;
+    onSetActiveTableScope(scope: ActiveTableScopeState): void;
     clearActiveTableId(): void;
+    clearActiveTableScope(): void;
     /** 解析字段批注 key */
     private resolveFieldCommentKey;
     /**

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

@@ -1,16 +1,24 @@
 import { ActivePanelData } from '../../domain/active/active-types';
 import { AttachFieldTarget } from '../../domain/field/attach-field';
+import { TableScope } from '../model/document/Wtbl';
 export type ITableSelection = {
     tableId: string;
     axis: 'row' | 'col' | 'all';
     index: number;
     realRowIndex?: number;
 } | null;
+export type ActiveTableScopeState = Pick<TableScope, 'depth'> & {
+    wtblId: string;
+    rootWtblId: string;
+    hostCellId?: string;
+};
 export type InteractionState = {
     /** 表格选择（行 / 列 / 全选） */
     tableSelection: ITableSelection | null;
     /** 当前激活表格 id（仅用于 table overlay 显示） */
     activeTableId: string;
+    /** 当前激活表格作用域（内外表隔离） */
+    activeTableScope: ActiveTableScopeState | null;
     /** 拖拽的id 用来进行处理单个单元格选中 */
     dragHoverId: string;
     /** hover 模型的模型 id */

package/dist/core/interaction/useInteraction.d.ts

@@ -8,6 +8,12 @@ export declare function useInteraction(docRef: Ref<Doc | null>): {
         readonly realRowIndex?: number | undefined;
     } | null | undefined;
     readonly activeTableId?: string | undefined;
+    readonly activeTableScope?: {
+        readonly depth: number;
+        readonly wtblId: string;
+        readonly rootWtblId: string;
+        readonly hostCellId?: string | undefined;
+    } | null | undefined;
     readonly dragHoverId?: string | undefined;
     readonly hoverModelId?: string | undefined;
     readonly focusModelId?: string | undefined;

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

@@ -25,7 +25,11 @@ export declare class LayoutManager {
      */
     private layoutTable;
     /**
-     * 布局单元格内容
+     * 构建表格 layout 节点（不含分页）
+     */
+    private buildTableLayout;
+    /**
+     * 布局单元格内容（段落 + 嵌套表 block 混排）
      */
     private layoutCellContent;
     /**

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

@@ -8,6 +8,8 @@ import { DataSlotIndex } from '../../../view/types';
 type ValueType = string | number | undefined | null;
 export declare class FieldBaseHandler extends RunHandlerBase {
     static hasValue(value: ValueType): boolean;
+    /** 图片/附件 url 列表：兼容逗号串、字符串数组、以及 {url|path|fileUrl} 对象 */
+    static normalizeUrlSources(raw: unknown): string[];
     /** 将展示文案拆成逐字 run；空串 split 会得到 []，需单独处理 */
     static toLayoutChars(label: unknown): string[];
     static isPrint(ctx: HandlerContext): boolean;

package/dist/core/layout/providers/TableInfoProvider.d.ts

@@ -1,4 +1,4 @@
-import { Wtbl, Wtc, Wtr } from '../../model/document';
+import { Wtbl, Wtc, Wtr, Wp } from '../../model/document';
 import { TableExpander, CellFragment } from '../table/table-expand';
 import { SubRenderer } from '../../view/TableCell';
 export declare class TableInfoProvider {
@@ -10,7 +10,7 @@ export declare class TableInfoProvider {
         expandFromId: string;
         cells: CellFragment[];
     }[];
-    getCellContent(cell: any): any[];
+    getCellContent(cell: CellFragment): Array<Wp | Wtbl>;
     getRowModelRef(row: any): {
         id: string;
     };

package/dist/core/layout/table/split-table.d.ts

@@ -21,6 +21,16 @@ import { Table } from '../../view/Table';
  * 当前页: Row 0 原样 + Row 1 上半部分
  * 下一页: 新建 Cell A_next + Row 1 下半部分引用新源单元格
  */
+/**
+ * 行内切分最小顶部剩余高度（像素）
+ *
+ * 仅约束「留在当前页的上半截」不能过薄：remainHeight < 此值时整行下移。
+ * 不再用几何 bottomHeight（rowH - remain）否决切分——那只是切分前的余量，
+ * 真正高度由 fillCells + redistribute 按内容重算；用它拦切分会导致
+ * 「差几像素超页却整行跳页」的悬崖效应。
+ */
+declare const MIN_SPLIT_REMAINING_HEIGHT = 20;
+export { MIN_SPLIT_REMAINING_HEIGHT };
 export declare class TableSplitter {
     private readonly table;
     private readonly maxHeight;

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

@@ -50,6 +50,8 @@ export interface LineInfo {
         /** 当前行的绝对位置 - 下边 */
         lineBottom: number;
     }>;
+    /** 所属表格的 layout id（仅 tablerow 类型有值） */
+    tableId?: string;
 }
 export interface Bounds {
     left: number;

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

@@ -26,6 +26,10 @@ export declare class Wbody extends ModelGroup<Child> {
      * @returns Wbody 实例
      */
     static fromXmlJson(json: RawElement): Wbody;
+    /**
+     * 规范化：确保 body 中每个 Wtbl 前后都紧跟一个 Wp。
+     */
+    ensureParagraphsAroundTables(): void;
     /**
      * 实例转换为原始 XML JSON
      *

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

@@ -94,6 +94,8 @@ export declare class WrText extends ModelNode {
      * @param fontSize 字号大小（半磅单位）
      */
     setFontSize(fontSize: number): void;
+    /** 记录 Ribbon 选中的字号项，用于同磅值下区分「小六」与「6.5」 */
+    setFontSizeOption(fontSizeOption: string): void;
     /**
      * 在指定字符位置拆分文本节点
      * @param index 拆分位置（在此字符之前分割）

package/dist/core/model/document/Wtbl/Calculation.d.ts

@@ -25,7 +25,13 @@ export declare class WtblCalculation {
      */
     private static processBounded;
     /**
-     * 处理 boundedItem 数据
+     * 按 itemRegion.id 查找嵌套的数据分组 / 动态关联区域
+     * （itemRegion 不在 table.regions 顶层，不能用 findRegionById）
+     */
+    private static findItemRegionById;
+    private static applyBoundsToItemRegion;
+    /**
+     * 处理 boundedItem 数据（更新父级 bounded 的 itemRegion 边界）
      */
     private static processBoundedItem;
     /**
@@ -33,7 +39,7 @@ export declare class WtblCalculation {
      */
     private static processCheckTable;
     /**
-     * 处理 dataGroup2D 数据
+     * 处理 dataGroup2D 数据（更新检验表 / 二维表上的 itemRegion 边界）
      */
     private static processDataGroup2D;
 }

package/dist/core/model/document/Wtbl/RowColumnOps.d.ts

@@ -4,12 +4,28 @@ import { Wtbl } from '../Wtbl';
  * 提供插入和删除行列的功能
  */
 export declare class WtblRowColumnOps {
+    /** 外表删除前，显式移除受影响单元格中的嵌套表，避免孤儿节点残留 */
+    private static detachNestedTablesFromCells;
+    /** 仅外表需要做「删除行/列/表时联动删除嵌套表」 */
+    private static detachNestedTablesFromOuterTable;
     /**
-     * 新单元格同步引用信息
-     * refCell: 参考单元格 (above | left)
-     * nextRefCell: 后参考单元格 (below | right )，如果传入，需要跟 refCell 比对一致后同步
+     * 新单元格同步引用信息（mergeId / subTable / subTableItem / header）
+     *
+     * 必须两侧参考单元格都存在，且对应字段一致，才写入新格。
+     * 单侧缺失（表边界、子表外侧空行）不同步，避免检验表等 region
+     * 在「上一行/下一行插入」时被错误扩大，进而触发重叠校验误报。
      */
     private static syncRefInfo;
+    /**
+     * 在 insertIndex 处插入一行后，将落在该行及以下的 region / itemRegion 行号整体 +1。
+     * 否则仅靠单元格标记回写时，动态关联 itemRegion 若未能匹配 id，边界会留在原行，
+     * 设计端字段与背景框就不会随检验表下移。
+     */
+    private static shiftRegionsForRowInsert;
+    /**
+     * 在 insertIndex 处插入一列后，将落在该列及右侧的 region / itemRegion 列号整体 +1。
+     */
+    private static shiftRegionsForColInsert;
     /**
      * 在指定行位置插入新行
      */
@@ -55,6 +71,11 @@ export declare class WtblRowColumnOps {
      * 如果有右侧列，右侧列会相应调整以保持表格总宽度不变
      */
     static resizeCol(table: Wtbl, colIndex: number, width: number): void;
+    /**
+     * 从其他列借宽度给指定列跨度，保持表格总宽不变。
+     * 优先借右侧列，再借左侧；被借列不低于 minWidth。
+     */
+    static stealWidthToColumn(table: Wtbl, startCol: number, colSpan: number, extra: number, minWidth?: number): number;
     /**
      * 调整行高
      */