@gct-paas/word 0.1.74 → 0.2.1

package/dist/runtime/canvas/__common__/widget-container/overlay-render.vue.d.ts

@@ -31,6 +31,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     onEnter?: ((...args: any[]) => any) | undefined;
     onLeave?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    pickerTriggerRef: HTMLDivElement;
     fieldPreviewRef: ({
         $: import('vue').ComponentInternalInstance;
         $data: {};

package/dist/runtime/canvas/inline-image/resize-box.vue.d.ts

@@ -15,13 +15,13 @@ type __VLS_Props = {
     showMoveIcon?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    resize: (payload: any) => any;
     move: (payload: any) => any;
+    resize: (payload: any) => any;
     resizeEnd: () => any;
     moveEnd: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onResize?: ((payload: any) => any) | undefined;
     onMove?: ((payload: any) => any) | undefined;
+    onResize?: ((payload: any) => any) | undefined;
     onResizeEnd?: (() => any) | undefined;
     onMoveEnd?: (() => any) | undefined;
 }>, {

package/dist/runtime/canvas/table/render/label-parse-rule/type.d.ts

@@ -18,12 +18,18 @@ export interface IRuleParseData {
     materialCode?: string;
     /** 设备编码 */
     deviceCode?: string;
-    /** 批号 */
+    /** 批次号 */
     lot: string;
     /** 数量 */
     qty?: number;
     /** 有效期 */
     expiration?: string;
+    /** 唯一码 */
+    uniqueCode?: string;
+    /** 工单编号 */
+    mfgOrderCode?: string;
+    /** 灭菌批次号 */
+    sterilizationLot?: string;
     /** 其他字段 */
     [k: string]: any;
 }

package/dist/runtime/canvas/table/render/material-consume/bom-validator.d.ts

@@ -1,37 +1,59 @@
-import { IBomEntry, IMaterialConsumeData, MaterialConsumptionPatternEnum } from '../../../../../domain/table/business/material/types';
+import { IBomEntry, IMaterialConsumeData } from '../../../../../domain/table/business/material/types';
+/** 提交时定位到单元格的物料消耗表行级错误。 */
+export declare class McRowValidateError extends Error {
+    readonly targetFieldId: 'product_id_' | 'material_no_' | 'qty_' | 'expiration_date_';
+    readonly row: IMaterialConsumeData;
+    constructor(message: string, targetFieldId: 'product_id_' | 'material_no_' | 'qty_' | 'expiration_date_', row: IMaterialConsumeData);
+}
+/** 扫码校验通过后抛给填充层的完整计划（下标相对入参 arr） */
+export interface ScanFillPlan {
+    target: BomEntryValidator;
+    current: BomEntryValidator;
+    needSwitch: boolean;
+    needInsert: boolean;
+    /** 建组时空占位插入下标；无需建组时为 -1 */
+    groupInsertIndex: number;
+    memberIndexes: number[];
+    emptyProductIndexes: number[];
+    emptyLotIndexes: number[];
+    /** 组内再新增一行的下标 */
+    appendIndex: number;
+}
 export declare class BomEntryValidator {
     bomEntry: IBomEntry;
     /** 是否启用顺序投料 */
     enableSequenceLoading: boolean;
-    /** 批次数量 */
-    materialNoNum: number;
+    /** 批次/生产数量读取函数 */
+    private getMaterialNoNum;
     /** 历史填报数据 */
     historyData: IMaterialConsumeData[];
     /** 表单实例的批次号 */
     mainMaterialNo: string;
     /** 物料消耗模式 */
-    mcPattern: MaterialConsumptionPatternEnum;
+    noBomMode: boolean;
     /** 该明细使用到的产品的id集合 */
     productIds: string[];
     /** 物料和code的映射 */
     productCodes: Record<string, string>;
     /** 历史数据中已经消耗的 */
     hasConsumed: number;
-    /** 需求总量 */
-    total: number;
     /** 剩于可消耗数量 */
     get remainingNum(): number;
+    /** 批次/生产数量（用时读取，避免构造快照过期） */
+    get materialNoNum(): number;
+    /** 需求总量 = 数量倍数 × BOM 单位用量 */
+    get total(): number;
     constructor(bomEntry: IBomEntry, 
     /** 是否启用顺序投料 */
     enableSequenceLoading: boolean, 
-    /** 批次数量 */
-    materialNoNum: number, 
+    /** 批次/生产数量读取函数 */
+    getMaterialNoNum: () => number, 
     /** 历史填报数据 */
     historyData: IMaterialConsumeData[], 
     /** 表单实例的批次号 */
     mainMaterialNo: string, 
     /** 物料消耗模式 */
-    mcPattern: MaterialConsumptionPatternEnum);
+    noBomMode: boolean);
     /**
      * 翻译物料的code
      * @param productId
@@ -44,8 +66,29 @@ export declare class BomEntryValidator {
      * @return {*}
      */
     filterGroupData(arr: IMaterialConsumeData[]): IMaterialConsumeData[];
+    /** 行是否属于本 BOM 组（优先 bom_entry_id_，避免跨组 product_id_ 误判） */
+    isRowInGroup(row: IMaterialConsumeData): boolean;
+    /** 组内已选中的物料（整批替代；不排除当前行） */
+    getGroupExistingProductId(tableData: IMaterialConsumeData[]): string | undefined;
+    /**
+     * 本组 product_id_ 下拉可选范围
+     * - 未开替代料：仅主料
+     * - 整批替代：组内已有 → 锁定该物料；否则主料+替代料
+     * - 混用等：主料+替代料
+     */
+    getSelectableProductIds(tableData: IMaterialConsumeData[]): string[];
     validateSubstitute(arr: IMaterialConsumeData[]): void;
     validateLotMixing(arr: IMaterialConsumeData[]): void;
+    /**
+     * 通用校验 3（带即将写入的行）：组内已有行 + row 的批次去重后，是否超过混批次数。
+     * - 非按批次 / 未开混批校验 / row 不属于本组 → 直接通过
+     * - 排除空物料；空批次不计入
+     */
+    validateLotMixingWithRow(row: IMaterialConsumeData, arr: IMaterialConsumeData[]): void;
+    /** 指定物料批次：material_no_ 须在 specified_material_entries_ 的 name_ 范围内 */
+    validateSpecifiedMaterialNo(row: IMaterialConsumeData): void;
+    /** 整组指定批次校验：组内每一行有批次值的都检查 */
+    validateSpecifiedMaterialNoForGroup(arr: IMaterialConsumeData[]): void;
     /**
      * 校验数量
      * @param arr
@@ -63,6 +106,8 @@ export declare class BomEntryValidator {
      * @return {*}
      */
     calcQtyConsumed(arr?: IMaterialConsumeData[]): number;
+    /** 上下限校验优先使用单位转换后的数量，历史数据未转换时兼容原数量。 */
+    calcQtyForBounds(arr: IMaterialConsumeData[]): number;
     /**
      * 计算自定义的数量校验的最大值和最小值
      * @param data
@@ -72,6 +117,12 @@ export declare class BomEntryValidator {
         max: any;
         min: any;
     }>;
+    /**
+     * 通用校验 5：本组上料数量是否满足 qty_validation_rule_。
+     * 前置假设：必填、替代料、混批等已由调用方完成。
+     * @param sequential 是否按顺序上料；eq 规则在非顺序模式下允许少上
+     */
+    validateGroupQty(arr: IMaterialConsumeData[], sequential?: boolean, groupNo?: number): Promise<void>;
     /**
      * 按顺序投料用
      * 检查数据中的当前明细的填报是否已经完成
@@ -83,26 +134,28 @@ export declare class BomEntriesValidator {
     entries: IBomEntry[];
     /** 是否启用顺序投料 */
     enableSequenceLoading: boolean;
-    /** 批次数量 */
-    materialNoNum: number;
+    /** 批次/生产数量读取函数 */
+    getMaterialNoNum: () => number;
     /** 历史填报数据 */
     historyData: IMaterialConsumeData[];
     /** 表单实例的批次号 */
     mainMaterialNo: string;
     /** 物料消耗模式 */
-    mcPattern: MaterialConsumptionPatternEnum;
+    noBomMode: boolean;
     bomEntryValidators: BomEntryValidator[];
     constructor(entries: IBomEntry[], 
     /** 是否启用顺序投料 */
     enableSequenceLoading: boolean, 
-    /** 批次数量 */
-    materialNoNum: number, 
+    /** 批次/生产数量读取函数 */
+    getMaterialNoNum: () => number, 
     /** 历史填报数据 */
     historyData: IMaterialConsumeData[], 
     /** 表单实例的批次号 */
     mainMaterialNo: string, 
     /** 物料消耗模式 */
-    mcPattern: MaterialConsumptionPatternEnum);
+    noBomMode: boolean);
+    /** 当前批次/生产数量 */
+    get materialNoNum(): number;
     /**
      * 翻译物料的code
      * @param productId
@@ -115,13 +168,72 @@ export declare class BomEntriesValidator {
      * @return {*}
      */
     findUtilByProductId(productId: string): BomEntryValidator | undefined;
+    /** 与 Excel 角标一致：只收集可定位到单元格的行级错误。 */
+    collectRowErrors(arr: IMaterialConsumeData[]): McRowValidateError[];
+    /** 编辑行所属组 id；空物料且无 bom_entry_id_ 时返回 null */
+    private getRowGroupId;
+    /**
+     * 是否有正在编辑的组。
+     * 一组可多行同时 !is_confirmed_；正常应只有一组。
+     * @returns 有编辑行且只落在一组 → true；无编辑行 → false；跨多组编辑 → 抛错
+     */
+    hasEditingGroup(arr: IMaterialConsumeData[]): boolean;
+    /** 取当前唯一编辑组的 BOM 明细 id；没有则 undefined */
+    getEditingGroupId(arr: IMaterialConsumeData[]): string | undefined;
+    /**
+     * 行 → BOM 明细在 bomEntryValidators 中的下标，找不到返回 -1
+     */
+    resolveEntryIndex(row: IMaterialConsumeData): number;
+    /**
+     * 行所属组在序号列中的 groupOrderIndex（0-based；-1 未绑 BOM 组）
+     * 与 material-consume-table 序号列逻辑一致
+     */
+    resolveGroupOrderIndex(row: IMaterialConsumeData, arr: IMaterialConsumeData[]): number;
+    /** 已知 BomEntryValidator 时算 groupOrderIndex */
+    resolveGroupOrderIndexByUtil(util: BomEntryValidator, arr: IMaterialConsumeData[]): number;
+    /** 非顺序上料：BOM 组在表中首次出现的顺序（0-based） */
+    private resolveEntryOrderInTable;
+    /**
+     * 定位顺序上料时的当前编辑组对应 BOM 明细。
+     * 编辑行无物料时，用前后组夹出范围，取 (prev, next) 开区间起点。
+     */
+    findSequenceBomEntry(arr: IMaterialConsumeData[]): BomEntryValidator | undefined;
     /**
      * 检验是否符合顺序投料的顺序要求
      * @param row 当前编辑的行
      * @param arr 所有的数据
      * @return {*}
      */
-    validateSequenceLoading(row: IMaterialConsumeData | undefined, arr: IMaterialConsumeData[]): Promise<void>;
+    validateSequenceLoading(row: IMaterialConsumeData, arr: IMaterialConsumeData[]): Promise<void>;
+    /** 表中是否已有该 BOM 组（有物料行或带 bom_entry_id_ 的空行） */
+    private groupExistsInTable;
+    /**
+     * 按 BOM 顺序计算 target 组应插入的下标：
+     * 插到表中「第一个 BOM 下标更大的组」之前；没有则表末。
+     */
+    private resolveBomOrderInsertIndex;
+    /**
+     * 组装扫码填充计划：切组/建组标记 + 相对 arr 的下标。
+     * needInsert 时优先填 groupInsertIndex 占位行，勿再直接用 member/append 下标（会错位）。
+     */
+    private buildScanFillPlan;
+    /**
+     * 通用校验 2：物料是否允许写入目标组（不改动原 validateSubstitute）
+     */
+    private assertGroupSubstitute;
+    /**
+     * 扫码定位目标组 + 通用校验 2，返回填充计划（切组/建组/下标）。
+     * 不改表数据。
+     */
+    validateSequenceScan(row: IMaterialConsumeData, arr: IMaterialConsumeData[]): ScanFillPlan;
+    /**
+     * 单组整组校验（提交编辑态组 / 切组前复用）
+     */
+    validateGroup(arr: IMaterialConsumeData[], util: BomEntryValidator): Promise<void>;
+    /**
+     * 切组前校验当前编辑组：BOM 内 + 必填、有效期、替代料、混批、数量校验
+     */
+    validateCurrentGroupForSwitch(arr: IMaterialConsumeData[], current: BomEntryValidator): Promise<void>;
     /**
      * 校验物料是否在bom里被使用
      * @param row 单行的数据
@@ -142,6 +254,10 @@ export declare class BomEntriesValidator {
      * @param arr
      */
     validateLotMixing(arr: IMaterialConsumeData[]): void;
+    /**
+     * 通用校验 3（扫码/写入前）：用 row + 表内同行组数据对比混批次数，不改动原 validateLotMixing
+     */
+    validateLotMixingWithRow(row: IMaterialConsumeData, arr: IMaterialConsumeData[]): void;
     /**
      * 校验数量
      * @param arr
@@ -158,10 +274,23 @@ export declare class BomEntriesValidator {
      */
     validate(arr: IMaterialConsumeData[]): Promise<void>;
     /**
-     * 检查扫描数据是否可以插入
+     * 检查扫描数据是否可以插入，通过后返回填充计划（记录模式无 plan）
+     */
+    validateScanCanInsert(row: IMaterialConsumeData, arr: IMaterialConsumeData[]): Promise<ScanFillPlan | undefined>;
+    /**
+     * 校验当前编辑行的数据
      * @param arr
+     * @returns
+     */
+    validateEditRow(arr: IMaterialConsumeData[]): Promise<void>;
+    /**
+     * 顺序上料提交：表中最后一组之前，必须上料组不能缺失（仅结构/顺序，不校验数量）
+     */
+    private assertSubmitSequenceOrder;
+    /**
+     * 提交整表校验：必须上料组须存在；顺序上料校验组序；表中存在的组走整组校验（不含库存）
      */
-    validateScanCanInsert(arr: IMaterialConsumeData[]): Promise<void>;
+    validateAllRows(arr: IMaterialConsumeData[]): Promise<void>;
     /**
      * 把扫描数据按情况插入到数组的位置，返回新数组
      * @param row
@@ -174,3 +303,7 @@ export declare class BomEntriesValidator {
      */
     getAllMaterialIds(): (string | undefined)[];
 }
+/** 行是否属于指定 BOM 组（未 deleted_，且 product_id_ 或 bom_entry_id_ 匹配） */
+export declare function isRowInBomGroup(row: IMaterialConsumeData, util: BomEntryValidator): boolean;
+/** 设置整组编辑态：editing=true → is_confirmed_=false */
+export declare function setGroupEditState(table: IMaterialConsumeData[], util: BomEntryValidator, editing: boolean): void;

package/dist/runtime/canvas/table/render/material-consume/context-key.d.ts

@@ -1,2 +1,6 @@
 /** 表单模板 BOM 控制器（物料消耗表） */
 export declare const TMPL_BOM_CONTROLLER: unique symbol;
+/** 数据关联关系 */
+export declare const DATA_RELATION_SHIP: unique symbol;
+/** 表单模板bom控制器映射 */
+export declare const TMPL_BOM_CONTROLLER_MAP: unique symbol;

package/dist/runtime/canvas/table/render/material-consume/derived-qty.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 未选择物料时，已消耗数量与当前行消耗数量保持一致。
+ * 空值统一写为 null，避免数值字段向提交接口传递空字符串。
+ */
+export declare function resolveConsumedQtyWithoutProduct(value: unknown): number | null;

package/dist/runtime/canvas/table/render/material-consume/index.d.ts

@@ -2,3 +2,4 @@ export * from './context-key';
 export * from './tmpl-bom-controller';
 export * from './material-consume-table-controller';
 export * from './material-consume.util';
+export * from './service';

package/dist/runtime/canvas/table/render/material-consume/material-consume-group-merge.d.ts

@@ -0,0 +1,46 @@
+import { IMaterialConsumeData } from '../../../../../domain/table/business/material/types';
+import { BomEntriesValidator } from './bom-validator';
+import { Row } from '../../types/table';
+/** Word 序号组件使用 pageWidgetMeta；业务字段使用 widgetMeta。 */
+export declare function getGroupMergeColumn(cell: Row['cells'][number]): string | undefined;
+/** 按组合并的组级只读字段（不含 qty_） */
+export declare const GROUP_MERGE_FIELDS: Set<keyof IMaterialConsumeData>;
+/** 是否为按组合并列：序号组件 + 组级字段 */
+export declare function isGroupMergeCell(tdInfo: any): boolean;
+/** 连续相同 key 的行属于同一合并组 */
+export declare function getGroupMergeKey(row: IMaterialConsumeData, validator: BomEntriesValidator): string;
+/** 与 Excel 序号组件保持相同的起始值、步长和未绑 BOM 处理。 */
+export declare function formatGroupSerialNumber(groupOrderIndex: number, props: {
+    initialValue?: number;
+    autoAddValue?: number;
+}): string;
+/** 只替换画布序号文本，保留布局节点原型与其他单元格内容。 */
+export declare function withGroupSerialNumber(cell: Row['cells'][number], groupOrderIndex: number): {
+    children: any[];
+    id: string;
+    x: number;
+    layoutX: number;
+    width: number;
+    height: number;
+    mergeFromId?: string;
+    backgroundColor?: string;
+    isNested: boolean;
+    pl: number;
+    pr: number;
+    pt: number;
+    pb: number;
+    rowspan: number;
+    colspan: number;
+    subRenderer?: import('../../../../../core').SubRenderer;
+};
+/**
+ * 当前页可见行的组 rowspan 计划
+ * - spans[i] > 1：组首行，值为 rowspan
+ * - spans[i] === 1：单行组，正常渲染
+ * - spans[i] === 0：组内后续行，跳过该列 td
+ */
+export declare function calcGroupRowSpans(rows: IMaterialConsumeData[], validator: BomEntriesValidator): number[];
+/** 计算某一 BOM 组的总上料数量 */
+export declare function calcGroupQtyConsumedTotal(entryIdx: number, tableData: IMaterialConsumeData[], validator: BomEntriesValidator): number;
+/** 回写全表 qty_consumed_total_（组内每行写相同值，便于提交） */
+export declare function syncGroupQtyConsumedTotals(tableData: IMaterialConsumeData[], validator: BomEntriesValidator): void;

package/dist/runtime/canvas/table/render/material-consume/material-consume-table-controller.d.ts

@@ -1,7 +1,7 @@
-import { MaterialConsumptionPatternEnum, IFormTmplBom, IMaterialConsumeData, ParseRuleProps } from '../../../../../domain/table/business/material/types';
+import { MaterialConsumptionPatternEnum, IFormTmplBom, IMaterialConsumeData, ParseRuleProps, ScanParamType } from '../../../../../domain/table/business/material/types';
 import { FormTmplBomController } from './tmpl-bom-controller';
 import { Ref } from 'vue';
-import { BomEntriesValidator } from './bom-validator';
+import { BomEntriesValidator, McRowValidateError } from './bom-validator';
 import { Doc } from '../../../../../core';
 import { ParsedValuePath } from '../../../../../utils/func/core';
 import { DataManager } from '../../../../../core/data';
@@ -19,8 +19,8 @@ export interface UpdateRowOption {
 /**
  * 物料消耗表字段控制 v2026.6.15
  * - [需求数量、已消耗数量] 始终只读
- * - [有效期、唯一标识、自定义字段] 始终可填（不做控制）
- * - 选择的物料类型是[查看物料]时 [批次、上料数量、工序] 只读
+ * - 编辑态可填写[有效期、唯一标识、自定义字段]；顺序上料的确认态整行只读
+ * - 选择的物料类型是[查看物料]时 [批次、上料数量] 只读（与 Excel calcDisabledFields 一致）
  * - 单行校验通过后（包括暂存后再次编辑）[物料、批次、上料数量、工序、需求数量单位、数量单位、转换后数量、转换数量单位ID、单位转化公式] 只读
  * v2026.7.30
  * - [物料消耗模式]是[记录模式]时，可以填写[需求数量](BOM 模式禁用 需求数量)
@@ -54,6 +54,14 @@ export declare class MCDataUtil {
         rowPath: string;
         disabled: boolean;
     }): void;
+    /**
+     * 编辑态行：按 Excel calcDisabledFields 禁用字段，其余受控字段可填
+     */
+    static applyEditingRowDisablement(option: {
+        dataManager: DataManager;
+        rowPath: string;
+        disabledFields: string[];
+    }): void;
     /**
      * 校验通过后，更新指定字段是否禁用
      * 参顶部[物料消耗表字段控制]
@@ -63,6 +71,7 @@ export declare class MCDataUtil {
         dataManager: DataManager;
         rowPath: string;
         disabled: boolean;
+        row?: IMaterialConsumeData;
     }): void;
     /**
      * 设置行数据的编辑状态
@@ -85,8 +94,23 @@ export declare class MaterialConsumeTableController {
      */
     subTableInfo: ISubTableInfo;
     /** 表单模型控制器 */
-    /** 批次数量 */
-    get materialNoNum(): number;
+    /** 当前 paper 上配置的单位转化规则（由组件 setup 注入） */
+    unitConversionRules: any[];
+    /** 主表 formState（由组件 setup 注入），用于读取主表字段值 */
+    mainFormState: Ref<any>;
+    /** 表单数据状态（由组件 setup 注入）：未填报 / STASH / SUBMIT */
+    dataStatus?: string;
+    /** 表单是否已暂存或提交（已处理过则不再跑初始化） */
+    get isDataProcessed(): boolean;
+    /** 当前控制器已绑定的文档。一个文档可能拆成多个画布表格组件。 */
+    private setupDoc?;
+    /** 脱离分页表格组件生命周期，同一文档只保留一组监听。 */
+    private setupMainUnsubscribe?;
+    /** 监听表格字段变更，确保普通输入组件修改 qty_ 后也会刷新派生数量。 */
+    private setupDataUnsubscribe?;
+    private setupUomUnsubscribe?;
+    /** 批次数量或生产数量 */
+    get materialNoNum(): any;
     /** 物料消耗模式（自身没有配置的话取环境的默认值） */
     get mcPattern(): MaterialConsumptionPatternEnum;
     /**
@@ -99,6 +123,8 @@ export declare class MaterialConsumeTableController {
     };
     /** 解析规则映射配置 */
     scanRuleProps?: ParseRuleProps;
+    /**条码参数配置 */
+    scanParamType: ScanParamType;
     /**
      * 解析规则配置
      */
@@ -125,10 +151,6 @@ export declare class MaterialConsumeTableController {
      * @param id (老数据是id,新数据是json对象字符串)
      */
     protected initScanRule(id: string): Promise<void>;
-    /**
-     * 变更条码规则
-     */
-    changeScanRule(__mainModelKey: string, subModelKey: string): Promise<void>;
     /**
      * 是否人为指定物料
      * @readonly
@@ -143,6 +165,19 @@ export declare class MaterialConsumeTableController {
      * 根据bom明细构造子表数据(初始化时)
      */
     calcFormState(): IMaterialConsumeData[] | undefined;
+    /**
+     * 未填报时初始化消耗表行数据
+     * @param defaultData 子表行默认值（含工序等）
+     */
+    initTableData(dataManager: DataManager, subFieldKey: string, defaultData?: Record<string, any>): number[];
+    /**
+     * 根据数据计算需要禁用的字段
+     * @param row
+     * @return {*}
+     */
+    calcDisabledFields(row: IMaterialConsumeData): (keyof IMaterialConsumeData)[];
+    /** 可编辑行：对齐 Excel getNewTdInfo + calcDisabledFields */
+    syncEditingRowDisablement(dataManager: DataManager, rowPath: string, row: IMaterialConsumeData): void;
     /**
      * 获取是否是 物料查看
      * @param product_id_
@@ -155,22 +190,35 @@ export declare class MaterialConsumeTableController {
      */
     getProductQuery(): {
         'id_.in': (string | undefined)[];
-    };
+    } | undefined;
+    /**
+     * 行级 product_id_ / material_no_ 查询共用入参
+     */
+    private buildProductQueryOptions;
+    /**
+     * 行级 product_id_ 下拉过滤（覆盖全局 id_.in）
+     */
+    getProductQueryForRow(row: IMaterialConsumeData, rowIndex?: number): import('./product-id-query').ProductIdQuery | undefined;
+    /**
+     * 行级 material_no_ 批次过滤：有物料按物料；无物料与 product_id_ 可选范围一致
+     */
+    getMaterialNoQueryForRow(row: IMaterialConsumeData, rowIndex?: number): import('./product-id-query').MaterialNoQuery;
     /**
      * 是否是第一行且物料是空行
      * @return {*}
      */
     isFirstBlankRow(): boolean;
+    /**
+     * 是否有正在编辑的组。
+     * 顺序上料时同时只能有一组处于编辑态；非顺序上料允许多组编辑。
+     */
+    hasEditingGroup(showMessage?: boolean): boolean;
     /**
      * 解析扫码的数据
      * 并判断是否能存入表中,返回对象则表示可以存入
      * @param str
      */
-    protected parseScanStr(str: string, option: {
-        doc: Doc;
-        subModelKey: string;
-        subFieldKey: string;
-    }): Promise<void>;
+    protected parseScanStr(data: any, transformedData: any, doc: Doc): Promise<void>;
     /** 扫描是否已经打开 */
     isScanOpen: boolean;
     /**
@@ -181,41 +229,67 @@ export declare class MaterialConsumeTableController {
         doc: Doc;
         subModelKey: string;
         subFieldKey: string;
+        subFieldOptions: {
+            label: string;
+            value: string;
+        }[];
     }): Promise<void>;
-    /**
-     * 打开 BOM 弹窗
-     */
-    bomModalProps: any;
-    openBomModal(): Promise<void>;
     /**
      * 消耗表组件setup时调用
      * @param opts
      */
     setup(opts: {
+        doc: Doc;
         tableDataRef: Ref<any>;
+        /** 主表响应式数据，用于按生产数量计算需求数量 */
+        mainFormState?: Ref<any>;
         subTableInfo: ISubTableInfo;
+        /** 表单 dataStatus，未填报才允许初始化行数据 */
+        dataStatus?: string;
+        /** 子表行默认值 */
+        defaultRowData?: Record<string, any>;
     }): Promise<void>;
+    /**
+     * 按当前 materialNoNum 回写各行 qty_required_（校验侧 total 已通过 getter 实时读取）
+     */
+    syncQtyRequiredFromBom(doc: Doc): void;
     /** 校验有效期 */
     validateExpiration(row: IMaterialConsumeData): void;
+    /**
+     * 物料+批次查复检日期；缺任一参数不查；无日期放过；小于当天则 throw
+     */
+    private validateReinspectionDate;
     /**
      * 校验数据，并退出编辑
      */
-    confirm(option: UpdateRowOption, subModelKey: string, doc?: Doc): Promise<void>;
     /** 校验确认前：命中单位转换规则则写回转换结果字段 */
     private applyUnitConversionBeforeConfirm;
     /**
-     * 生成校验清单格式的报错
-     * @param message
-     * @return {*}
+     * 对指定行集合应用单位转换规则（低层方法）。
+     * 命中规则则直接写入行对象上的 qty_transfer_ / qty_transfer_uom_id_ / transfer_formula_。
+     */
+    private applyUnitConversionForRows;
+    /**
+     * 提交前对所有有效行应用单位转换规则（兜底：Record 模式 / 非顺序投料无组切换）。
+     * 已命中规则的行写入 qty_transfer_ / qty_transfer_uom_id_ / transfer_formula_。
      */
-    calcErrorObj(message: string): {
+    private applyUnitConversionForAllRows;
+    /** 行级错误映射到 Word 的字段路径，供校验连线定位。 */
+    calcErrorObj(error: McRowValidateError): {
         field: string;
         message: string;
     };
+    /**
+     * 是否是单独一行空数据
+     */
+    isOnlyEmptyRow(): boolean;
     /**
      * 提交的时候的校验
      */
-    submitValidate(): Promise<any>;
+    submitValidate(): Promise<{
+        isValid: boolean;
+        fields?: Record<string, any[]>;
+    }>;
     /**
      * 是否有正在编辑的行
      * @return {*}
@@ -225,7 +299,22 @@ export declare class MaterialConsumeTableController {
      * 选中行开启编辑
      * @param row
      */
-    editRow(option: UpdateRowOption, isBomPattern: boolean): void;
+    editRow(option: UpdateRowOption): Promise<void>;
+    /**
+     * 在当前 BOM 组下方新增一个空组。
+     *
+     * 顺序上料时，新增前需要完整校验当前编辑组；校验通过后将当前组切回确认态。
+     * 返回新行在活跃数据中的下标，调用方据此执行 Word 子表行初始化。
+     */
+    addGroup(option: UpdateRowOption, doc: Doc): Promise<number | undefined>;
+    /**
+     * 组内加一行：当前行下方插入，继承 bom_entry_id_。
+     */
+    addRowForGroup(option: UpdateRowOption, doc: Doc): number | undefined;
+    /**
+     * 仅剩一行时清空内容：保留行身份和默认值，并断开 BOM 组。
+     */
+    clearRow(option: UpdateRowOption, doc: Doc): void;
     /**
      * 更新整个数组的所有行的已消耗数量
      *
@@ -235,6 +324,14 @@ export declare class MaterialConsumeTableController {
      *   - 删除行
      */
     updateRowConsumed(doc: Doc): void;
+    /**
+     * 组级：更新 qty_consumed_total_（同组 qty_ 之和）
+     */
+    updateGroupQtyConsumedTotal(doc: Doc): void;
+    /**
+     * qty 相关派生字段统一入口（改 qty_ / 扫码 / 删行 等都走这里）
+     */
+    updateDerivedQtyFields(doc: Doc): void;
     /**
      * 设置默认值，如工序，需求数量/已消耗数量
      * @param row
@@ -250,5 +347,5 @@ export declare class MaterialConsumeTableController {
         doc: Doc;
         parsed: ParsedValuePath;
         dataIndex: number;
-    }): void;
+    }): Promise<void>;
 }

package/dist/runtime/canvas/table/render/material-consume/material-consume.util.d.ts

@@ -2,10 +2,9 @@ import { Doc } from '../../../../../core';
 import { DocModel } from '../../../../../core/model';
 import { FormTmplBomController } from './tmpl-bom-controller';
 /**
- * 同步[物料消耗表] formTmplBomList 信息到 widgetProps 上
- * 因为 formTmplBomList 有独立存取接口
+ * id：模板 id 或实例 id
  */
-export declare const syncMaterialConsumeTableBomInfo: (templateId: string, docModel: DocModel) => Promise<void>;
+export declare const syncMaterialConsumeBomInfo: (id: string, docModel: DocModel) => Promise<void>;
 /**
  * 处理表单实例上的[物料消耗表]相关配置
  */