@gct-paas/word 0.1.47-beta.1 → 0.1.47-beta.10

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

@@ -15,7 +15,7 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     focus: () => void;
     blur: () => void;
     select: () => void;
-    inputRef: import('vue').Ref<HTMLInputElement | HTMLTextAreaElement | null, HTMLInputElement | HTMLTextAreaElement | null>;
+    inputRef: import('vue').Ref<HTMLTextAreaElement | HTMLInputElement | null, HTMLTextAreaElement | HTMLInputElement | null>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     input: (value: string | number, event: Event) => any;
     search: (value: string | number) => any;
@@ -25,8 +25,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     keydown: (event: KeyboardEvent) => any;
     keypress: (event: KeyboardEvent) => any;
     keyup: (event: KeyboardEvent) => any;
-    "update:modelValue": (value: string | number) => any;
     clear: () => any;
+    "update:modelValue": (value: string | number) => any;
     pressEnter: (event: KeyboardEvent) => any;
 }, string, import('vue').PublicProps, Readonly<GctInputProps> & Readonly<{
     onInput?: ((value: string | number, event: Event) => any) | undefined;
@@ -37,8 +37,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onKeypress?: ((event: KeyboardEvent) => any) | undefined;
     onKeyup?: ((event: KeyboardEvent) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
 }>, {
     name: string;
@@ -47,6 +47,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     readonly: boolean;
     disabled: boolean;
     size: import('./types').InputSize;
+    autocomplete: string;
+    spellcheck: boolean;
     placeholder: string;
     modelValue: string | number;
     prefix: string;
@@ -58,11 +60,9 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     showPasswordToggle: boolean;
     maxLength: number;
     autofocus: boolean;
-    autocomplete: string;
     rows: number;
     bordered: boolean;
     showSearchButton: boolean;
-    spellcheck: boolean;
     customStyle: Record<string, string | number>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     inputRef: HTMLInputElement;

package/dist/base/input/src/text-area.vue.d.ts

@@ -23,8 +23,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     keydown: (event: KeyboardEvent) => any;
     keypress: (event: KeyboardEvent) => any;
     keyup: (event: KeyboardEvent) => any;
-    "update:modelValue": (value: string | number) => any;
     clear: () => any;
+    "update:modelValue": (value: string | number) => any;
     pressEnter: (event: KeyboardEvent) => any;
 }, string, import('vue').PublicProps, Readonly<GctInputProps> & Readonly<{
     onInput?: ((value: string | number, event: Event) => any) | undefined;
@@ -35,23 +35,23 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onKeypress?: ((event: KeyboardEvent) => any) | undefined;
     onKeyup?: ((event: KeyboardEvent) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
 }>, {
     name: string;
     readonly: boolean;
     disabled: boolean;
+    autocomplete: string;
+    spellcheck: boolean;
     placeholder: string;
     modelValue: string | number;
     allowClear: boolean;
     showCount: boolean;
     maxLength: number;
     autofocus: boolean;
-    autocomplete: string;
     rows: number;
     bordered: boolean;
-    spellcheck: boolean;
     customStyle: Record<string, string | number>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     textareaRef: HTMLTextAreaElement;

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

@@ -1,11 +1,21 @@
+import { ActivePanelData } from '../../../domain/active/active-types';
+import { AttachFieldTarget } from '../../../domain/field/attach-field';
+export type PanelBreadcrumbItem = {
+    key: string;
+    value: string;
+};
+export type PanelTitle = string | PanelBreadcrumbItem[];
+export type PanelTitleContext = {
+    active: ActivePanelData | null;
+    attachFieldTarget: AttachFieldTarget | null;
+};
 export interface PanelSchema {
     /** schema 唯一 key */
     key: PanelSchemaKey;
     /** 面板标题 */
-    title: string | Array<{
-        key: string;
-        value: string;
-    }>;
+    title: PanelTitle;
+    /** 按当前上下文解析标题（如引用字段面包屑） */
+    resolveTitle?: (ctx: PanelTitleContext) => PanelTitle;
     /** 实际渲染组件 */
     render: any;
 }

package/dist/core/command/base/CommandBase.d.ts

@@ -3,6 +3,7 @@ import { Doc } from '../../view/Doc';
 import { Wr, Wp, Wtbl, Wtr, Wtc } from '../../model/document';
 import { RawElement } from '../../model/types/raw';
 import { CursorManager } from '../../cursor/CursorManager';
+import { LayoutNode } from '../../view/base/LayoutNode';
 export declare const SelectionMode: {
     readonly PP: "PP";
     readonly PTr: "PTr";
@@ -209,5 +210,7 @@ export declare abstract class CommandBase<T extends CommandType = CommandType> i
         modelIndex: number;
         modelParent: Wp;
     } | undefined;
+    /** 设计态删除字段组件后，清理 DataManager 中该字段的 defaults / rawData / 依赖 */
+    protected cleanupDesignFieldBinding(run?: LayoutNode): void;
 }
 export {};

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

@@ -0,0 +1,7 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class SetMaterialConsumeTable extends CommandBase<'setMaterialConsumeTable'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['setMaterialConsumeTable']);
+    protected execute(): Promise<PostCommandContext>;
+}

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

@@ -3,7 +3,7 @@ import { Doc } from '../view/Doc';
 import { WidgetMeta } from '../widget/widget-meta';
 import { WordHighlight } from '../model/types';
 import { PointerHitResult } from '../cursor/hit/types';
-import { SubTableBodyType } from '../model/document/wtcRegionRef';
+import { SubTableRegionType } from '../model/document/wtcRegionRef';
 export interface CursorMeta {
     nodeId: string;
     offset: number;
@@ -53,6 +53,7 @@ export declare const CommandType: {
     readonly deleteTableHeader: "deleteTableHeader";
     readonly setRepeating: "setRepeating";
     readonly set2DTable: "set2DTable";
+    readonly setMaterialConsumeTable: "setMaterialConsumeTable";
     readonly setBounded: "setBounded";
     readonly setBoundedItem: "setBoundedItem";
     readonly setCheckTable: "setCheckTable";
@@ -160,6 +161,10 @@ export type CommandPayloadMap = {
         name: string;
         valuePath: string;
     };
+    setMaterialConsumeTable: CommandPayload & {
+        name: string;
+        valuePath: string;
+    };
     setBounded: CommandPayload & {
         name: string;
         valuePath: string;
@@ -179,7 +184,7 @@ export type CommandPayloadMap = {
     deleteSubTable: CommandPayload & {
         tableId: string;
         regionId: string;
-        regionType: SubTableBodyType;
+        regionType: SubTableRegionType;
     };
     deleteBoundedItem: CommandPayload & {
         tableId: string;

package/dist/core/cursor/render/cursor-renderer.vue.d.ts

@@ -9,10 +9,10 @@ type __VLS_Props = {
     visible?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    visible: boolean;
-    caretColor: string;
     caretWidth: number;
+    caretColor: string;
     blinkInterval: number;
     alwaysVisibleAfterEventMs: number;
+    visible: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -65,6 +65,7 @@ export declare class DataManager {
     private scheduleLayout;
     getLabelPath(path: JsonPath): JsonPath;
     getHrefPath(path: JsonPath): JsonPath;
+    getFieldRuntimeSpecificConfigKeys(): string[];
     getFieldRuntimeSpecificConfig(path: JsonPath): FieldRuntimeSpecificConfig | undefined;
     setFieldRuntimeSpecificConfig(path: JsonPath, partial: FieldRuntimeSpecificConfig): void;
     /** 子表插行后：index 及之后的行配置下标 +1 */
@@ -290,6 +291,18 @@ export declare class DataManager {
      * 获取父路径
      */
     private getParentPath;
+    /**
+     * 设计态删除字段后，清理该字段在 DataManager 中的绑定数据
+     * @param designValuePath 设计时 valuePath（可含 [n] / [n_y][n_x] 通配符）
+     * @param runtimeValuePath 版面解析后的具体路径（可选）
+     */
+    removeFieldBindingData(designValuePath: JsonPath, runtimeValuePath?: JsonPath): void;
+    /** 收集与字段绑定相关的路径（含 value / label / href 及通配符变体） */
+    private collectFieldBindingPaths;
+    /** 收集可从 rawData 删除的具体路径（跳过含通配符的设计路径） */
+    private collectConcreteRawDataPaths;
+    /** 移除字段注册的组件依赖 */
+    private removeFieldDependencies;
     /**
      * 设置默认值
      * @param path jsonpath 路径 (支持 [n] 数组索引和 [n] 通配符)

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

@@ -1,4 +1,5 @@
 import { ActivePanelData } from '../../domain/active/active-types';
+import { AttachFieldTarget } from '../../domain/field/attach-field';
 export type ITableSelection = {
     tableId: string;
     axis: 'row' | 'col' | 'all';
@@ -20,6 +21,8 @@ export type InteractionState = {
     focusTick: number | undefined;
     /** 当前点击的组件 右侧面板 */
     panelData: ActivePanelData | null;
+    /** 引用字段配置定位（与 panel:attach-field 配合） */
+    attachFieldTarget: AttachFieldTarget | null;
     /** 字段校验批注信息集合 */
     validationCommentMap: Record<string, Array<{
         field: string;

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

@@ -18,11 +18,27 @@ export declare function useInteraction(docRef: Ref<Doc | null>): {
         readonly context: {
             readonly mainModelKey?: string | undefined;
             readonly subFieldKey?: string | undefined;
+            readonly parentModelId?: string | undefined;
             readonly isDataGroup2DClicked?: boolean | undefined;
             readonly regionId?: string | undefined;
             readonly secRefId?: string | undefined;
         };
     } | null | undefined;
+    readonly attachFieldTarget?: {
+        readonly kind: "boolean";
+        readonly itemsKey: "trueAttachFields" | "falseAttachFields";
+        readonly parentModelId: string;
+        readonly itemId: string;
+        readonly attachFieldLabel: string;
+        readonly subFieldKey?: string | undefined;
+    } | {
+        readonly kind: "enum-option";
+        readonly optionId: string;
+        readonly parentModelId: string;
+        readonly itemId: string;
+        readonly attachFieldLabel: string;
+        readonly subFieldKey?: string | undefined;
+    } | null | undefined;
     readonly validationCommentMap?: {
         readonly [x: string]: readonly {
             readonly field: string;

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

@@ -16,10 +16,14 @@ export declare class LayoutMapper {
     /** 组件信息中心 */
     widgetMetaMap: Map<string, any>;
     modelMap: Map<string, ModelMode>;
+    /** 布局期生成的 model 节点（如布尔/枚举引用字段），不在 doc.model 树中 */
+    runtimeModelMap: Map<string, ModelMode>;
     modelSplitMap: Map<string, string[]>;
     /** 扁平处理 layout 数据 */
     buildLayoutIndex(): void;
     buildModelMap(): void;
+    /** 注册布局期生成的 model 节点，供 getModelNodeById 查找 */
+    registerRuntimeModelNode(node: ModelMode): void;
     getBaseMetaNodeById<T extends BaseMetaNode>(id?: string): T | undefined;
     getBaseMetaNodeByIds<T extends BaseMetaNode>(ids: 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;

package/dist/core/layout/attach-field/AttachFieldContext.d.ts

@@ -0,0 +1,59 @@
+import { Doc } from '../..';
+import { BaseMetaNode } from '../types';
+import { WidgetMeta } from '../../widget/widget-meta';
+import { MultipleItem } from '../../../suites/shared/panel/config/editor/attach-fields-editor/types';
+import { AttachFieldTarget } from '../../../domain/field/attach-field';
+import { AttachFieldParentMeta, WidgetOptionLike } from './types';
+export type AttachFieldCursorPin = {
+    nodeId: string;
+    side: 'before' | 'after';
+};
+/**
+ * 引用字段（attach field）运行时上下文。
+ */
+export declare class AttachFieldContext {
+    /** `widgetMeta.extra.biz` 上标识「此为引用字段」的键 */
+    static readonly BIZ_FLAG: "isAttachField";
+    /**
+     * 为布局生成的 widgetMeta.extra 打上引用字段标记。
+     */
+    static markAttachFieldMeta(extra?: WidgetMeta['extra']): WidgetMeta['extra'];
+    /** 当前 widget 是否为引用字段（非画布拖入的独立字段组件） */
+    static isAttachFieldWidget(widgetMeta: WidgetMeta | undefined | null): boolean;
+    /** 读取布局阶段写入的「父选项」绑定信息，非引用字段返回 null */
+    static getParentMeta(widgetMeta: WidgetMeta | undefined | null): AttachFieldParentMeta | null;
+    /** 由父字段 props 与选项值解析列表定位，供面板与画布点击共用 */
+    private static resolveListContext;
+    /** 根据引用字段 widgetMeta.id 解析画布上的 modelRef.id */
+    static resolveAttachFieldModelId(doc: Doc, itemId: string): string | null;
+    /** 画布点击引用字段时，生成与 panel 列表点击一致的 `attachFieldTarget` */
+    static resolveAttachFieldTarget(doc: Doc, widgetMeta: WidgetMeta): AttachFieldTarget | null;
+    private static isFieldMarkerRun;
+    /** 引用字段 model 分组内的正文字符 run（排除 [ ] 与间距占位） */
+    private static getAttachFieldContentNodes;
+    /** 取节点内最后一个字符索引（单字节点为 0） */
+    private static getNodeLastCharOffset;
+    /**
+     * 点击引用字段【/】时，落到内侧首尾字符：
+     * 【 → 首字 before；】 → 末字 after
+     */
+    static resolveAttachFieldMarkerContentPin(doc: Doc, modelId: string, marker: 'left' | 'right'): (AttachFieldCursorPin & {
+        offset: number;
+    }) | null;
+    static getModelSplitNodes(doc: Doc, modelId: string): BaseMetaNode[];
+    /**
+     * 从父组件 props 解析某一选项下的引用字段列表。
+     * - 布尔：`trueAttachFields` / `falseAttachFields`
+     * - 枚举：选项对象上的 `attachFields`（通常来自 computedOptions）
+     */
+    static getOptionAttachFields(widgetProps: Record<string, any> | undefined, option: WidgetOptionLike): MultipleItem[];
+    /**
+     * 父字段当前值是否包含本引用字段绑定的选项值。
+     * 用于条件校验、overlay 禁用等：未选中对应选项时不应要求填写引用字段。
+     */
+    private static isParentOptionActive;
+    /** 引用字段当前是否处于可填报 / 可校验状态。无父绑定信息时视为普通字段，恒为 true。 */
+    static isActive(doc: Doc, widgetMeta: WidgetMeta | undefined | null): boolean;
+    /** 枚举 / 布尔选项值相等比较（布尔走 toBoolean，其余按字符串） */
+    private static isSameOptionValue;
+}

package/dist/core/layout/attach-field/index.d.ts

@@ -0,0 +1,2 @@
+export { AttachFieldContext } from './AttachFieldContext';
+export type { AttachFieldParentMeta, WidgetOptionLike } from './types';

package/dist/core/layout/attach-field/types.d.ts

@@ -0,0 +1,20 @@
+import { MultipleItem } from '../../../suites/shared/panel/config/editor/attach-fields-editor/types';
+/** 布局时写入引用字段 widgetMeta 的父选项绑定（见 AttachFieldHandler） */
+export type AttachFieldParentMeta = {
+    /** 父字段 layout modelRef.id，设计态 hover 委托用 */
+    parentModelRefId: string;
+    /** 父字段运行时 valuePath，用于读取当前选中值 */
+    parentRuntimeValuePath: string;
+    /** 本引用字段绑定的选项值（true/false 或枚举项 value） */
+    parentOptionValue: unknown;
+    /** 父字段是否为多选枚举（fw:enum-multiple） */
+    isMultiple: boolean;
+    /** 父字段子表 subFieldKey，设计态面板 extra 用 */
+    parentSubFieldKey?: string;
+};
+/** 布局解析 computedOptions 时的选项结构（含 attachFields） */
+export type WidgetOptionLike = {
+    value: unknown;
+    label: string;
+    attachFields?: MultipleItem[];
+};

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

@@ -0,0 +1,10 @@
+import { FieldBaseHandler } from './FieldBaseHandler';
+import { TextRun } from '../../../view/runs/TextRun';
+import { HandlerContext } from '../../types';
+import { WidgetOptionLike } from '../../attach-field/types';
+/** 布尔 / 枚举选项后的引用字段布局 */
+export declare class AttachFieldHandler extends FieldBaseHandler {
+    static layoutOptionAttachFields(ctx: HandlerContext, option: WidgetOptionLike, layoutStyle: ReturnType<typeof TextRun.textStyle2LayoutStyle>): void;
+    private static buildWidgetMeta;
+    private static layoutItem;
+}

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

@@ -3,9 +3,11 @@ import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextRun } from '../../../view/runs/TextRun';
 import { HandlerContext } from '../../types';
+import { MultipleItem } from '../../../../suites/shared/panel/config/editor/attach-fields-editor/types';
 type WidgetOption = {
     value: any;
     label: string;
+    attachFields?: MultipleItem[];
 };
 export declare class OptionHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;

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

@@ -4,3 +4,4 @@ export { SignatureHandler } from './SignatureHandler';
 export { InputHandler } from './InputHandler';
 export { AttachmentHandler } from './AttachmentHandler';
 export { FieldBaseHandler } from './FieldBaseHandler';
+export { AttachFieldHandler } from './AttachFieldHandler';

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

@@ -16,6 +16,10 @@ export declare class WtblCalculation {
      * 处理 2d-table 数据
      */
     private static process2DTable;
+    /**
+     * 处理 materialConsumeTable 数据
+     */
+    private static processMaterialConsumeTable;
     /**
      * 处理 bounded 数据
      */

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

@@ -1,4 +1,4 @@
-import { BoundedRegionOptions, CheckTableRegionOptions, RepeatingRegionOptions, TableRegion, TableHeaderRegionOptions, SubTableHeaderRegionOptions, _2DTableRegionOptions, BoundedRegion, CheckTableRegion, RepeatingRegion, TableHeaderRegion, SubTableHeaderRegion, _2DTableRegion } from '../../logic';
+import { BoundedRegionOptions, CheckTableRegionOptions, RepeatingRegionOptions, TableRegion, TableHeaderRegionOptions, SubTableHeaderRegionOptions, _2DTableRegionOptions, MaterialConsumeTableRegionOptions, MaterialConsumeTableRegion, BoundedRegion, CheckTableRegion, RepeatingRegion, TableHeaderRegion, SubTableHeaderRegion, _2DTableRegion } from '../../logic';
 import { Wtbl } from '../Wtbl';
 /** 矩形区域边界（行/列起止索引） */
 type RegionBounds = Pick<TableRegion, 'start' | 'end'>;
@@ -33,6 +33,10 @@ export declare class WtblRegionManager {
      * 设置二维表区域
      */
     static set2DTable(table: Wtbl, options: Omit<_2DTableRegionOptions, 'table'>): _2DTableRegion;
+    /**
+     * 设置物料消耗表
+     */
+    static setMaterialConsumeTable(table: Wtbl, options: Omit<MaterialConsumeTableRegionOptions, 'table'>): MaterialConsumeTableRegion;
     /**
      * 设置有界区域（子表体）
      */

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

@@ -3,7 +3,7 @@ import { Wbody } from './Wbody';
 import { Wtr } from './Wtr';
 import { Wtc } from './Wtc';
 import { ModelGroup, ModelGroupOptions } from '../base';
-import { TableRegion, BoundedRegionOptions, CheckTableRegionOptions, RepeatingRegionOptions, _2DTableRegionOptions, TableHeaderRegion, SubTableHeaderRegion, TableHeaderRegionOptions, SubTableHeaderRegionOptions, CheckTableRegion, BoundedRegion, RepeatingRegion, _2DTableRegion } from '../logic';
+import { TableRegion, BoundedRegionOptions, CheckTableRegionOptions, RepeatingRegionOptions, _2DTableRegionOptions, TableHeaderRegion, SubTableHeaderRegion, TableHeaderRegionOptions, SubTableHeaderRegionOptions, CheckTableRegion, MaterialConsumeTableRegion, MaterialConsumeTableRegionOptions, BoundedRegion, RepeatingRegion, _2DTableRegion } from '../logic';
 import { WtblPr } from './WtblPr';
 export declare class Wtbl extends ModelGroup {
     name: 'w:tbl';
@@ -27,6 +27,9 @@ export declare class Wtbl extends ModelGroup {
     get _2DTable(): _2DTableRegion[];
     get2DTableById(id: string): _2DTableRegion | undefined;
     get has2DTable(): boolean;
+    get materialConsumeTable(): MaterialConsumeTableRegion[];
+    getMaterialConsumeTableById(id: string): MaterialConsumeTableRegion | undefined;
+    get hasMaterialConsumeTable(): boolean;
     get bounded(): BoundedRegion[];
     getBoundedById(id: string): BoundedRegion | undefined;
     get hasBounded(): boolean;
@@ -59,6 +62,7 @@ export declare class Wtbl extends ModelGroup {
     splitAt(index: number): [Wtbl | null, Wtbl | null];
     setRepeating(options: Omit<RepeatingRegionOptions, 'table'>): RepeatingRegion;
     set2DTable(options: Omit<_2DTableRegionOptions, 'table'>): _2DTableRegion;
+    setMaterialConsumeTable(options: Omit<MaterialConsumeTableRegionOptions, 'table'>): MaterialConsumeTableRegion;
     setBounded(options: Omit<BoundedRegionOptions, 'table'>): BoundedRegion;
     setCheckTable(options: Omit<CheckTableRegionOptions, 'table'>): CheckTableRegion;
     setTableHeader(options: Omit<TableHeaderRegionOptions, 'table'>): TableHeaderRegion;

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

@@ -3,7 +3,7 @@ import { Wtr } from './Wtr';
 import { Wp } from './Wp';
 import { ModelGroup, ModelGroupOptions } from '../base';
 import { Wtbl } from './Wtbl';
-import { SubTableBodyType, SubTableItemType, TableHeaderRefType, WtcHeaderRef, WtcSubTableItemRef, WtcSubTableRef } from './wtcRegionRef';
+import { SubTableRegionType, SubTableItemType, TableHeaderRegionType, WtcHeaderRef, WtcSubTableItemRef, WtcSubTableRef } from './wtcRegionRef';
 /** 单元格上需随行列复制同步的引用字段 */
 export declare const WTC_REF_KEYS: readonly ["mergeId", "subTable", "subTableItem", "header"];
 /**
@@ -78,11 +78,11 @@ export declare class Wtc extends ModelGroup {
          */
         isRoot: boolean;
     };
-    setSubTable(type: SubTableBodyType, regionId: string): void;
+    setSubTable(type: SubTableRegionType, regionId: string): void;
     clearSubTable(): void;
     setSubTableItem(type: SubTableItemType, regionId: string): void;
     clearSubTableItem(): void;
-    setHeaderRef(type: TableHeaderRefType, regionId: string): void;
+    setHeaderRef(type: TableHeaderRegionType, regionId: string): void;
     clearHeaderRef(): void;
     /** 按 regionId 清除单元格上的子表 / 表头引用 */
     clearRegionRef(regionId: string): void;

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

@@ -1,10 +1,15 @@
 /** 子表主体类型（repeating 在 layout 层映射为 dynamic-table） */
-export type SubTableBodyType = 'repeating' | 'bounded' | '2d-table' | 'check-table';
+export type SubTableRegionType = 'repeating' | 'bounded' | '2d-table' | 'check-table' | 'material-consume-table';
+export type TableHeaderRegionType = 'table-header' | 'sub-table-header';
+export type TableRegionType = SubTableRegionType | TableHeaderRegionType;
+export declare const SUB_TABLE_REGION_TYPES: string[];
+export type SubTableLayoutType = 'dynamic-table' | 'fixed-table' | '2d-table' | 'check-table' | 'material-consume-table';
+export type TableHeaderLayoutType = 'table-header';
+export type TableLayoutType = SubTableLayoutType | TableHeaderLayoutType;
 /** 子表内数据分组 / 数据关联 */
 export type SubTableItemType = 'bounded-item' | 'data-group-2d';
-export type TableHeaderRefType = 'table-header' | 'sub-table-header';
 export type WtcSubTableRef = {
-    type: SubTableBodyType;
+    type: SubTableRegionType;
     regionId: string;
 };
 export type WtcSubTableItemRef = {
@@ -12,9 +17,8 @@ export type WtcSubTableItemRef = {
     regionId: string;
 };
 export type WtcHeaderRef = {
-    type: TableHeaderRefType;
+    type: TableHeaderRegionType;
     regionId: string;
 };
-export type LayoutSubTableType = 'dynamic-table' | 'fixed-table' | '2d-table' | 'check-table' | 'table-header';
-export declare function bodyTypeToLayoutType(type: SubTableBodyType): LayoutSubTableType;
-export declare function headerTypeToLayoutType(type: TableHeaderRefType): 'table-header';
+export declare function tableRegionTypeToLayoutType(type: SubTableRegionType): SubTableLayoutType;
+export declare function headerRegionTypeToLayoutType(type: TableHeaderRegionType): TableHeaderLayoutType;

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

@@ -6,6 +6,8 @@ export type { TableHeaderRegionOptions } from './header/TableHeaderRegion';
 export type { SubTableHeaderRegionOptions } from './header/SubTableHeaderRegion';
 export { RepeatingRegion } from './subtable/repeating/RepeatingRegion';
 export type { RepeatingRegionOptions, RepeatingWidgetMeta } from './subtable/repeating/RepeatingRegion';
+export { MaterialConsumeTableRegion } from './subtable/repeating/MaterialConsumeTableRegion';
+export type { MaterialConsumeTableRegionOptions, MaterialConsumeTableWidgetMeta } from './subtable/repeating/MaterialConsumeTableRegion';
 export { BoundedRegion } from './subtable/bounded/BoundedRegion';
 export { BoundedItemRegion } from './subtable/bounded/BoundedItemRegion';
 export type { BoundedRegionOptions, BoundedWidgetMeta } from './subtable/bounded/BoundedRegion';

package/dist/core/model/logic/subtable/repeating/MaterialConsumeTableRegion.d.ts

@@ -0,0 +1,37 @@
+import { Wtbl } from '../../../document';
+import { Region, RegionOptions } from '../../base/Region';
+import { RegionJson } from '../../../types';
+export type MaterialConsumeTableWidgetPropsMeta = {
+    table_key_: string;
+    barcode_parsing_rules_id_?: string;
+    personal_bom_enabled_?: boolean;
+    entries_?: any[];
+    sequence_loading_enabled_?: boolean;
+    [key: string]: any;
+};
+export type MaterialConsumeTableWidgetMeta = {
+    props: MaterialConsumeTableWidgetPropsMeta;
+};
+export type MaterialConsumeTableRegionOptions = RegionOptions & {
+    name: string;
+    valuePath: string;
+    widgetMeta: MaterialConsumeTableWidgetMeta;
+};
+export type MaterialConsumeTableRegionJson = RegionJson & {
+    name: string;
+    valuePath: string;
+    widgetMeta: MaterialConsumeTableWidgetMeta;
+};
+export declare class MaterialConsumeTableRegion extends Region {
+    type: "material-consume-table";
+    name: string;
+    valuePath: string;
+    widgetMeta: MaterialConsumeTableWidgetMeta;
+    constructor(options: MaterialConsumeTableRegionOptions);
+    get subFieldKey(): string;
+    get linkFieldKey(): string;
+    get subValuePath(): string;
+    get linkValuePath(): string;
+    toJSON(): MaterialConsumeTableRegionJson;
+    static fromJSON(json: MaterialConsumeTableRegionJson, table: Wtbl): MaterialConsumeTableRegion;
+}

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

@@ -4,7 +4,8 @@ import { CheckTableRegion } from './subtable/link/CheckTableRegion';
 import { TableHeaderRegion } from './header/TableHeaderRegion';
 import { SubTableHeaderRegion } from './header/SubTableHeaderRegion';
 import { _2DTableRegion } from './subtable/link/_2DTableRegion';
-/** 表格上可注册的全部逻辑区域 */
-export type TableRegion = RepeatingRegion | _2DTableRegion | BoundedRegion | CheckTableRegion | TableHeaderRegion | SubTableHeaderRegion;
+import { MaterialConsumeTableRegion } from './subtable/repeating/MaterialConsumeTableRegion';
 /** 可作为子表体的区域类型 */
-export type SubTableRegion = RepeatingRegion | BoundedRegion;
+export type SubTableRegion = RepeatingRegion | BoundedRegion | CheckTableRegion | _2DTableRegion | MaterialConsumeTableRegion;
+/** 表格上可注册的全部逻辑区域 */
+export type TableRegion = SubTableRegion | TableHeaderRegion | SubTableHeaderRegion;

package/dist/core/utils/expand.d.ts

@@ -1,6 +1,6 @@
 import { DataManager } from '../data/DataManager';
 import { Wtr, Wtbl, Wtc } from '../model/document';
-import { RepeatingRegion, BoundedRegion, TableHeaderRegion, SubTableHeaderRegion, CheckTableRegion, _2DTableRegion } from '../model/logic';
+import { RepeatingRegion, BoundedRegion, TableHeaderRegion, SubTableHeaderRegion, CheckTableRegion, _2DTableRegion, MaterialConsumeTableRegion, SubTableRegion } from '../model/logic';
 import { LinkSubTableCellZone } from '../layout/linkSubTableLayout';
 import { Doc } from '../view/Doc';
 /** 表格矩形范围（含起止行列，均为闭区间） */
@@ -27,6 +27,7 @@ export type CellFragment = {
     yDataIndex?: number;
     repeatingId?: string;
     _2DTableId?: string;
+    materialConsumeTableId?: string;
     boundedId?: string;
     checkTableId?: string;
     mergeFromId?: string;
@@ -46,7 +47,6 @@ type IndexMap = Map<string, {
     refPos?: string;
     refCellId?: string;
 }>;
-type SubTableRegion = RepeatingRegion | BoundedRegion | CheckTableRegion | _2DTableRegion;
 export declare class TableExpander {
     table: Wtbl;
     doc: Doc;
@@ -58,6 +58,7 @@ export declare class TableExpander {
     /** 模板行索引 → 各类逻辑区域（用于按行分发展开策略） */
     rowIndexRepeatingMapper: Map<number, RepeatingRegion>;
     rowIndex2DTableMapper: Map<number, _2DTableRegion>;
+    rowIndexMaterialConsumeTableMapper: Map<number, MaterialConsumeTableRegion>;
     rowIndexBoundedMapper: Map<number, BoundedRegion>;
     rowIndexCheckTableMapper: Map<number, CheckTableRegion>;
     rowIndexTableHeaderMapper: Map<number, TableHeaderRegion | SubTableHeaderRegion>;
@@ -92,9 +93,10 @@ export declare class TableExpander {
     private mergeIndexMap;
     private initializeRows;
     /** 编辑模式只展开一份；预览/填报模式按数据路径长度重复 */
-    getRepeatCount(region: RepeatingRegion | _2DTableRegion): number;
+    getRepeatCount(region: RepeatingRegion | _2DTableRegion | MaterialConsumeTableRegion): number;
     private initializeRepeatingRowsInRange;
     private initialize2DTableRowsInRange;
+    private initializeMaterialConsumeTableRowsInRange;
     /**
      * 循环子表与二维子表共用的纵向展开逻辑：
      * 按数据条数复制行块，区域外最后一行单元格需合并 rowspan 以覆盖重复产生的额外行。

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

@@ -3,8 +3,9 @@ import { LayoutGroup, LayoutGroupOptions } from './base';
 import { IContainerMetrics, Border } from './types';
 import { Table } from './Table';
 import { TableRow } from './TableRow';
-import { RepeatingWidgetMeta, BoundedWidgetMeta, CheckTableWidgetMeta, _2DTableWidgetMeta } from '../model/logic';
+import { RepeatingWidgetMeta, BoundedWidgetMeta, CheckTableWidgetMeta, _2DTableWidgetMeta, MaterialConsumeTableWidgetMeta } from '../model/logic';
 import { LinkSubTableCellZone } from '../layout/linkSubTableLayout';
+import { TableLayoutType } from '../model/document/wtcRegionRef';
 export interface TableCellOptions extends LayoutGroupOptions {
     colspan?: number;
     rowspan?: number;
@@ -16,10 +17,11 @@ export interface TableCellOptions extends LayoutGroupOptions {
 }
 export type SubRenderer = {
     id: string;
-    type: 'dynamic-table' | '2d-table' | 'fixed-table' | 'check-table' | 'table-header';
+    type: TableLayoutType;
+    tableName?: string;
     dataIndex?: number;
     valuePath: string;
-    widgetMeta?: RepeatingWidgetMeta | BoundedWidgetMeta | CheckTableWidgetMeta | _2DTableWidgetMeta;
+    widgetMeta?: RepeatingWidgetMeta | BoundedWidgetMeta | CheckTableWidgetMeta | _2DTableWidgetMeta | MaterialConsumeTableWidgetMeta;
     xDataIndex?: number;
     yDataIndex?: number;
     /** 用来标记二维表的子类型 交叉 / 横向 / 纵向 */