@gct-paas/excel 0.1.40-beta.3 → 0.1.40-beta.30

package/dist/src/domain/document-business/types.d.ts

@@ -0,0 +1,24 @@
+import { FIELD_TYPE } from '../../shared/enum';
+import { FieldQueryFilter } from '../field/query-filter';
+/** detail 业务类型、实例参数与当前查询字段；业务规则无需依赖组件。 */
+export interface BusinessFieldQueryContext {
+    businessType?: string;
+    paramsConfig: Readonly<Record<string, unknown>>;
+    fieldType?: string;
+}
+export interface BusinessFieldQueryRule {
+    id: string;
+    match: {
+        fieldType: FIELD_TYPE;
+    };
+    /** 声明结果缓存的依赖参数，由 Runtime 统一执行缓存和请求去重。 */
+    cache?: {
+        key: (context: BusinessFieldQueryContext) => unknown;
+        ttlMs?: number;
+    };
+    resolveFilters: (context: BusinessFieldQueryContext) => Promise<readonly FieldQueryFilter[]>;
+}
+export interface DocumentBusinessProfile {
+    businessType: string;
+    fieldQueries: readonly BusinessFieldQueryRule[];
+}

package/dist/src/domain/field/number/product-release-qty-manifest.d.ts

@@ -0,0 +1,2 @@
+import { FieldMainSetItem } from '../types';
+export declare const manifest: FieldMainSetItem;

package/dist/src/domain/field/query-filter.d.ts

@@ -0,0 +1,15 @@
+/** 下拉接口使用的查询结构，与渲染组件解耦。 */
+export interface FieldQuery {
+    queryData?: Record<string, unknown>;
+    exp?: string;
+}
+/** 空 values 明确表示无候选，空条件列表表示不追加过滤。 */
+export interface FieldQueryFilter {
+    field: string;
+    operator: 'in';
+    values: readonly string[];
+}
+/** 空 in 可能被接口视为不筛选，使用占位值表达无候选。 */
+export declare const EMPTY_QUERY_VALUE = "__excel_no_matching_query_value__";
+/** 附加条件统一按 AND 合并；同字段 IN 条件取交集，保留已有搜索表达式。 */
+export declare function mergeQueryFilters(query: FieldQuery, filters: readonly FieldQueryFilter[]): FieldQuery;

package/dist/src/domain/table/business/material/material-balance/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { BusinessFieldProfile } from '../../../../types';
+export declare const fields: BusinessFieldProfile[];

package/dist/src/domain/table/business/material/material-consume/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { BusinessFieldProfile } from '../../../../types';
+export declare const fields: BusinessFieldProfile[];

package/dist/src/domain/table/business/material/material-substitution/profile/field-keys.d.ts

@@ -30,6 +30,8 @@ export declare const F: {
     readonly targetMaterialNoLb: "target_material_no__lb_";
     /** 替换物料 */
     readonly targetProduct: "target_product_id_";
+    /** 替换物料展示值 */
+    readonly targetProductLb: "target_product_id__lb_";
     /** 替换物料名称 */
     readonly targetProductName: "target_product_id_name_";
     /** 替换物料编码 */
@@ -44,53 +46,66 @@ export type MaterialSubstitutionFieldKey = (typeof F)[keyof typeof F];
 export declare const DISABLED_INPUT_FIELDS: readonly ["source_material_no_", "source_product_id_name_", "source_product_id_code_", "source_product_id_spec_", "source_qty_consumed_", "target_product_id_name_", "target_product_id_code_", "target_product_id_spec_"];
 export declare const CLEAR_ON_SOURCE_PRODUCT_EMPTY: readonly ["source_material_no_", "source_material_no__lb_", "source_product_id__lb_", "source_product_id_name_", "source_product_id_code_", "source_product_id_spec_", "source_qty_consumed_"];
 /** 替换物料批号清空 / 手输时需清空的物料字段 */
-export declare const CLEAR_ON_TARGET_MATERIAL_NO_EMPTY: readonly ["target_product_id_name_", "target_product_id_code_", "target_product_id_spec_"];
+export declare const CLEAR_ON_TARGET_MATERIAL_NO_EMPTY: readonly ["target_product_id_", "target_product_id__lb_", "target_product_id_name_", "target_product_id_code_", "target_product_id_spec_"];
 /** 历史消耗选项 → 被替换物料行字段 */
 export declare const FILL_FROM_SOURCE_PRODUCT_OPTION: readonly [{
     readonly optionField: "material_name_";
     readonly toField: "source_material_no_";
+    readonly name: "物料批号";
 }, {
     readonly optionField: "product_id_.name_";
     readonly toField: "source_product_id_name_";
+    readonly name: "物料名称";
 }, {
     readonly optionField: "product_id_.code_";
     readonly toField: "source_product_id_code_";
+    readonly name: "物料编码";
 }, {
     readonly optionField: "product_id_.spec_";
     readonly toField: "source_product_id_spec_";
+    readonly name: "物料规格";
 }, {
     readonly optionField: "qty_consumed_";
     readonly toField: "source_qty_consumed_";
+    readonly name: "已消耗数量";
 }];
 /** 替换物料批号选项 → 替换物料信息 */
 export declare const FILL_FROM_TARGET_MATERIAL_NO_OPTION: readonly [{
+    readonly optionField: "product_id_";
+    readonly toField: "target_product_id_";
+    readonly name: "物料";
+}, {
     readonly optionField: "product_id_name_";
     readonly toField: "target_product_id_name_";
+    readonly name: "物料名称";
 }, {
     readonly optionField: "product_id_code_";
     readonly toField: "target_product_id_code_";
+    readonly name: "物料编码";
 }, {
     readonly optionField: "product_id_spec_";
     readonly toField: "target_product_id_spec_";
+    readonly name: "物料规格";
 }];
 /** SN / 工序不影响扫码结果能否复用当前空行。 */
 export declare const SCAN_ROW_CONTENT_FIELDS: readonly ["source_material_no_", "source_product_id_", "target_material_no_", "target_product_id_"];
-/** 历史消耗选项 → 替换物料行字段 */
+/** LOT/SN 选项 → 替换物料行字段；替换数量保留用户输入。 */
 export declare const FILL_FROM_TARGET_PRODUCT_OPTION: readonly [{
-    readonly optionField: "material_name_";
+    readonly optionField: "name_";
     readonly toField: "target_material_no_";
+    readonly name: "物料批号";
 }, {
-    readonly optionField: "product_id_.name_";
+    readonly optionField: "product_id_name_";
     readonly toField: "target_product_id_name_";
+    readonly name: "物料名称";
 }, {
-    readonly optionField: "product_id_.code_";
+    readonly optionField: "product_id_code_";
     readonly toField: "target_product_id_code_";
+    readonly name: "物料编码";
 }, {
-    readonly optionField: "product_id_.spec_";
+    readonly optionField: "product_id_spec_";
     readonly toField: "target_product_id_spec_";
-}, {
-    readonly optionField: "qty_consumed_";
-    readonly toField: "target_qty_consumed_";
+    readonly name: "物料规格";
 }];
 /** 替换物料清空时同步清除批次、物料信息和数量。 */
-export declare const CLEAR_ON_TARGET_PRODUCT_EMPTY: readonly ["target_material_no_", "target_material_no__id_", "target_material_no__lb_", "target_product_id_name_", "target_product_id_code_", "target_product_id_spec_", "target_qty_consumed_"];
+export declare const CLEAR_ON_TARGET_PRODUCT_EMPTY: readonly ["target_product_id__lb_", "target_material_no_", "target_material_no__id_", "target_material_no__lb_", "target_product_id_name_", "target_product_id_code_", "target_product_id_spec_", "target_qty_consumed_"];

package/dist/src/domain/table/business/material/material-substitution/runtime/row-change-handlers.d.ts

@@ -1,3 +1,7 @@
+/** 工序切换或清空后，原工序下选择的历史消耗信息失效。 */
+export declare function handleRoutingOperationChange(ctx: {
+    rowData: Record<string, any>;
+}): void;
 export declare function handleSourceProductChange(ctx: {
     rowData: Record<string, any>;
 }): void;

package/dist/src/domain/table/business/material/material-substitution/runtime/select-loaders.d.ts

@@ -0,0 +1,8 @@
+import { RefCustomLoader } from '../../../../../../nocode-base/src/interface/ref-loader';
+export declare function flattenMaterialConsumeRecord(item: Record<string, any>): Record<string, any>;
+/** 同一条选中记录的批次名称、ID 和展示名必须一起回填。 */
+export declare function buildTargetMaterialSelectionPatch(record: Record<string, any>): Record<string, unknown>;
+/** 历史消耗只使用当前行生产 SN，未选、LOT 或无法确认类型时阻断查询。 */
+export declare function createMaterialConsumeHistoryLoader(rowData: Record<string, any>, fieldName?: string): RefCustomLoader;
+/** 替换料从 LOT/SN 选择，保存产品 ID，批次身份由行内批号字段保存。 */
+export declare function createTargetMaterialLoader(rowData: Record<string, any>): RefCustomLoader;

package/dist/src/domain/table/business/preprocess/pretreatment-list/profile/field-keys.d.ts

@@ -51,7 +51,7 @@ export declare const CLEAR_ON_MATERIAL_CONTAINER_SELECT: readonly ["production_c
 export declare const CLEAR_ON_PRODUCT_EMPTY: readonly ["product_id_name_", "product_id_code_", "product_id_spec_"];
 /** 相关字段变更时需重算物料禁用态 */
 export declare const PRODUCT_EDITABILITY_WATCH: readonly ["material_container_no_", "material_container_no__id_", "mfg_order_id_", "production_container_id_"];
-/** 生产批次 / 物料批 选项回填 */
+/** 生产批次 / 物料批选项回填：仅带出工单号，工单选择项保持互斥 */
 export declare const FILL_FROM_CONTAINER_OPTION: readonly [{
     readonly optionField: "product_id_";
     readonly toField: "product_id_";
@@ -64,9 +64,6 @@ export declare const FILL_FROM_CONTAINER_OPTION: readonly [{
 }, {
     readonly optionField: "product_id_spec_";
     readonly toField: "product_id_spec_";
-}, {
-    readonly optionField: "mfg_order_id_";
-    readonly toField: "mfg_order_id_";
 }, {
     readonly optionField: "mfg_order_code_";
     readonly toField: "mfg_order_code_";
@@ -127,9 +124,6 @@ export declare const fillFromOption: readonly [{
 }, {
     readonly optionField: "product_id_spec_";
     readonly toField: "product_id_spec_";
-}, {
-    readonly optionField: "mfg_order_id_";
-    readonly toField: "mfg_order_id_";
 }, {
     readonly optionField: "mfg_order_code_";
     readonly toField: "mfg_order_code_";

package/dist/src/domain/table/business/sterilize/entrust-steril-batch-list/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { BusinessFieldProfile } from '../../../../types';
+export declare const fields: BusinessFieldProfile[];

package/dist/src/domain/table/business/warehouse/shared/autofill-source-labels.d.ts

@@ -0,0 +1,19 @@
+/** 备件业务表的自定义选项字段不一定存在于关联模型元数据中。 */
+export declare const PART_OPTION_FIELD_LABELS: {
+    readonly part_name_: "备件名称";
+    readonly part_code_: "备件编码";
+    readonly specification_: "备件规格";
+    readonly unit_: "数量单位";
+};
+export declare const INVENTORY_OPTION_FIELD_LABELS: {
+    readonly id_: "库存记录";
+    readonly part_id_name_: "备件名称";
+    readonly part_id_code_: "备件编码";
+    readonly part_id_spec_: "备件规格";
+    readonly warehouse_id_: "仓库";
+    readonly storage_zone_id_: "库区";
+    readonly location_id_: "库位";
+    readonly uom_id_: "数量单位";
+    readonly validate_: "有效期";
+    readonly stock_num_: "库存数量";
+};

package/dist/src/domain/table/design/autofill-expander.d.ts

@@ -4,6 +4,8 @@ import { AutofillTemplate } from '../types';
  * @example product_id_ → product_id → product_id_name_
  */
 export declare function normalizeRefFieldKey(fieldKey: string): string;
+/** 将 AutofillTemplate 中的 toField 解析为字符串 */
+export declare function resolveAutofillToField(template: AutofillTemplate, sourceFieldKey: string): string;
 interface ExpandAutofillContext {
     /** 拖入的源字段 key，如 product_id_ */
     sourceFieldKey: string;

package/dist/src/domain/table/design/hooks/on-field-attach.d.ts

@@ -6,6 +6,12 @@ interface ApplyFieldProfileInput {
     /** 子表 SubTableType 或业务子模型 refModelType */
     subModelType?: string;
 }
+/** 设计态展示用的内置填充映射，与拖入字段时写入的模板共用一份 Profile。 */
+export declare function getBuiltInAutofillRules(field: ApplyFieldProfileInput): {
+    fromField: string;
+    toField: string;
+    fromFieldLabel: string | undefined;
+}[];
 /**
  * 按子表类型 + 字段 key 应用 Profile，返回合并后的 widget 配置片段
  */

package/dist/src/domain/table/index.d.ts

@@ -1,6 +1,6 @@
 export { getBusinessRibbonMenuGroups, getDataRibbonMenuItems } from './design/ribbon-options';
 export { resolveSubTableCreate, resolvePanelTypeByTableType } from './design/create-subtable';
-export { applyFieldProfileOnAttach } from './design/hooks/on-field-attach';
+export { applyFieldProfileOnAttach, getBuiltInAutofillRules } from './design/hooks/on-field-attach';
 export { SUB_TABLE_PANEL_TYPE_NAME, isDynamicSubTablePanelType, isFixedSubTablePanelType, isRepeatingSubTablePanelType, } from './design/panel-type';
 export { resolveDesignPanelFeatures, BIZ_TABLE_CONFIG_SEED_TYPES } from './design/panel-features';
 export { resolveTableLabelKey } from './design/label';

package/dist/src/domain/table/types.d.ts

@@ -44,6 +44,8 @@ export interface ContextAssignmentDef {
 /** 数据填充模板：拖入关联字段时展开为 autofillRules（设计态消费） */
 export interface AutofillTemplate {
     fromField: string;
+    /** 自定义选项数据源中的字段名称；设计态展示内置规则时使用 */
+    fromFieldLabel?: string;
     toField: string | ((ctx: {
         sourceFieldKey: string;
     }) => string);

package/dist/src/index.d.ts

@@ -19,6 +19,8 @@ export { calcUsedFields, isReverseModelingEnabled, FieldSceneType, scanField, }
 export { FIELD_TYPE_LABEL_MAP, FieldTypeToCellWidgetMap, } from './online-form/src/views/designer/constants';
 export { XlsxParser } from './online-form/src/views/designer/utils/xlsx-parser';
 export { DomParser } from './online-form/src/views/designer/utils/dom-parser';
+export { getPlacedFieldsByType, getPlacedSealFields, } from './online-form/src/views/designer/utils/template-placed-fields';
+export type { PlacedFormField } from './online-form/src/views/designer/utils/placed-fields';
 export { VersionSelect } from './shared/components/version-select';
 export { OnlineFormModelSelect, OnlineFormModelModal, } from './shared/components/online-form-model-select';
 export { openVersionDiff, VersionDiffPreviewRouter, } from './online-form/src/components/version-diff';

package/dist/src/nocode-base/src/components/document-sub-table-action/dynamic-table-action.vue.d.ts

@@ -14,8 +14,6 @@ type __VLS_Props = {
     showEditBtn: boolean;
     /** 是否是物料消耗 */
     isMaterialConsume: boolean;
-    /** 是否显示查看Bom */
-    showBom?: boolean;
     /** 是否显示扫描 */
     showScanBtn?: boolean;
     /** 是否显示确认按钮 */

package/dist/src/nocode-base/src/components/document-sub-table-action/sub-table-action.vue.d.ts

@@ -10,8 +10,6 @@ type __VLS_Props = {
     showEditBtn?: boolean;
     /** 是否是物料消耗 */
     isMaterialConsume?: boolean;
-    /** 是否显示查看Bom */
-    showBom?: boolean;
     /** 是否显示扫描 */
     showScanBtn?: boolean;
     /** 是否显示确认按钮 */
@@ -36,7 +34,6 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     showInsertMultiple: boolean;
     showEditBtn: boolean;
     isMaterialConsume: boolean;
-    showBom: boolean;
     showScanBtn: boolean;
     showConfirmBtn: boolean;
     noPopover: boolean;

package/dist/src/nocode-base/src/components/document-sub-table-action/type.d.ts

@@ -24,10 +24,6 @@ export declare enum SubTableActionEnum {
     CONFIRM = "CONFIRM",
     /** 条码扫描 */
     SCAN = "SCAN",
-    /** 查看BOM信息 */
-    VIEW_BOM = "VIEW_BOM",
-    /** 变更解析规则 */
-    CHANGE_PARSE_RULE = "CHANGE_PARSE_RULE",
     /** 行编辑 */
     RowEdit = "rowEdit",
     /** 加一组 */

package/dist/src/nocode-base/src/components/material-consume/types.d.ts

@@ -7,9 +7,5 @@ export declare enum MaterialConsumeActionType {
     /** 确认 */
     CONFIRM = "CONFIRM",
     /** 条码扫描 */
-    SCAN = "SCAN",
-    /** 查看BOM信息 */
-    VIEW_BOM = "VIEW_BOM",
-    /** 变更解析规则 */
-    CHANGE_PARSE_RULE = "CHANGE_PARSE_RULE"
+    SCAN = "SCAN"
 }

package/dist/src/nocode-base/src/core/factory/sub-table-factory.d.ts

@@ -35,6 +35,8 @@ export declare class SubTableCoreFactory {
     initSubTableCore(context: RuntimePageCtx): void;
     /** 通过tid获取子表核心 */
     getSubCoreByTid(tid: string): SubTableCore | undefined;
+    /** 只按已注册的业务类型识别，普通数据表及未知类型不参与空行过滤。 */
+    getBusinessTableFields(): string[];
     /**
      * 初始化表单数据
      * @param params

package/dist/src/nocode-base/src/core/sub-table/allocate-table-core.d.ts

@@ -5,13 +5,14 @@ import { ScanModalInput } from './utils/scan';
  * 库存调拨表 Core
  * - Profile：禁用字段 / 行默认值 / 物料清空
  * - 物料走库存选择（allocateProduct）+ FILL_FROM_INVENTORY_OPTION
- * - 扫码：库存匹配，连续扫码每次新增一行
+ * - 扫码：库存匹配，优先填充物料和批次均为空的行，否则新增一行
  */
 export declare class AllocateTableCore extends ProfileDrivenSubTableCore {
     /** 绘制UI相关工具 */
     get render(): import('../..').ISubTableRender;
     /** 指定的仓库id */
     get warehouseId(): any;
+    protected isEmptyScanRow(row: Record<string, unknown>): boolean;
     handleFieldTd: SubTableCore['handleFieldTd'];
     calcFieldQuery: SubTableCore['calcFieldQuery'];
     calcSubTableActionMenu: SubTableCore['calcSubTableActionMenu'];

package/dist/src/nocode-base/src/core/sub-table/profile-driven-sub-table-core.d.ts

@@ -80,9 +80,9 @@ export declare class MaterialRequisitionTableCore extends ProfileDrivenSubTableC
 }
 /**
  * 物料替换表 Core
- * - 原物料和替换料均从历史消耗中选择，并按当前 SN / 工序过滤
- * - 选择后回填对应批号、物料信息和消耗数量
- * - 替换物料批号回填替换物料信息
+ * - 被替换物料从当前行生产 SN 的历史消耗中选择，可按行内工序过滤
+ * - 替换物料从 LOT/SN 中选择，回填批次和物料信息，保留替换数量
+ * - 替换物料批号回填替换物料及其信息
  * - 条码映射结果优先填充空行，否则追加新行
  */
 export declare class MaterialSubstitutionTableCore extends ProfileDrivenSubTableCore {

package/dist/src/nocode-base/src/core/sub-table/sub-table-core.d.ts

@@ -3,6 +3,7 @@ import { SubTableActionEnum } from '../../components/document-sub-table-action';
 import { IDefaultValueMap, IFieldStatus, IRuntimeSubTableCtx } from '../types';
 import { TdHandler } from '../utils/td-handler';
 import { SubTableCoreFactory } from '../factory/sub-table-factory';
+import { ScanRecordPickerOptions } from '../../types/render/sub-table-render';
 import { FormModelController } from '../../hooks/form-model';
 import { RefCustomLoader } from '../../interface/ref-loader';
 /**
@@ -165,10 +166,6 @@ export declare class SubTableCore {
     };
     /** 解析规则配置对象 */
     scanRuleProps: ParseRuleProps;
-    /**
-     * 变更条码规则
-     */
-    changeScanRule(): Promise<void>;
     /**
      * 打开扫描弹窗
      * @param opts
@@ -188,7 +185,7 @@ export declare class SubTableCore {
     /**
      * 扫码多条候选时选择一行（1 条自动选中）
      */
-    protected pickScanRecord(records: Record<string, unknown>[]): Promise<Record<string, unknown> | undefined>;
+    protected pickScanRecord(records: Record<string, unknown>[], options?: ScanRecordPickerOptions): Promise<Record<string, unknown> | undefined>;
     /**
      * 处理扫码弹窗回调
      * 参数由扫码弹窗决定

package/dist/src/nocode-base/src/hooks/form-model/form-model-controller.d.ts

@@ -53,6 +53,8 @@ export declare class FormModelController {
     isPresetField(field: FieldMetaDTO): boolean;
     /** 是否是系统字段 */
     isSystemField(field: FieldMetaDTO): boolean;
+    /** 是否是对象字段类型 */
+    isObjectField(field: FieldMetaDTO): boolean;
     /**
      * 获取主模型里子表字段对应的子模型key
      *

package/dist/src/nocode-base/src/hooks/inspection-module-qty.d.ts

@@ -0,0 +1,4 @@
+/** 检验数量只读取 inspection_number_，兼容原始记录、data 及 data.data 返回。 */
+export declare function parseInspectionModuleQty(res: unknown): number | undefined;
+/** 使用表单 detail 的交易实例 id；不能以表单 id 或 paramsConfig 中的 id 代替。 */
+export declare function fetchInspectionModuleQty(txnInstId?: string): Promise<number | undefined>;

package/dist/src/nocode-base/src/hooks/material-consume/bom-validator.d.ts

@@ -107,8 +107,8 @@ export declare class BomEntryValidator {
      * @return {*}
      */
     calcCustomNumberLimit(data: IMaterialConsumeData): Promise<{
-        max: any;
-        min: any;
+        max: number | undefined;
+        min: number | undefined;
     }>;
     /**
      * 通用校验 5：本组上料数量是否满足 qty_validation_rule_。

package/dist/src/nocode-base/src/hooks/material-consume/material-consume-table-controller.d.ts

@@ -42,16 +42,17 @@ export declare class MaterialConsumeTableController {
     mainFormState: Ref<any>;
     /** 表单数据状态（由 factory bindRuntime 注入）：未填报 / STASH / SUBMIT */
     dataStatus?: string;
-    /** factory 是否已绑定过运行时（避免重复 initTableData） */
-    private runtimeBound;
-    /** 多 Sheet / 同屏多实例下，弹层和异步交互使用该键隔离。 */
-    private runtimeOwnerId;
+    /** 实例数据只在 LOADED 前准备一次，运行时绑定不再重新生成行。 */
+    private initialDataPrepared;
+    /** 最近一次同步需求数量时使用的数量依赖。 */
+    private syncedMaterialNoNum;
     /** 表单是否已暂存或提交（已处理过则不再跑初始化） */
     get isDataProcessed(): boolean;
     /** 批次数量或生产数量 */
     get materialNoNum(): any;
     /** 物料消耗模式（自身没有配置的话取环境的默认值） */
     get mcPattern(): MaterialConsumptionPatternEnum;
+    get hasFormInstance(): boolean;
     /**
      * 解析规则数据对象
      */
@@ -97,10 +98,6 @@ export declare class MaterialConsumeTableController {
      * @param id (老数据是id,新数据是json对象字符串)
      */
     protected initScanRule(id: string): Promise<void>;
-    /**
-     * 变更条码规则
-     */
-    changeScanRule(): Promise<void>;
     /**
      * 是否人为指定物料
      * @readonly
@@ -171,21 +168,20 @@ export declare class MaterialConsumeTableController {
     openScanModal(opts: {
         title: string;
     }): Promise<void>;
-    /**
-     * 打开扫描弹窗
-     * @param opts
-     */
-    openBomModal(): Promise<void>;
-    /**
-     * 表单加载时由 factory 调用：绑定稳定数据源并初始化行数据。
-     * 不在分页组件 setup 中调用，避免跨页挂载重复 init。
-     */
+    /** Store 创建前准备物料行和数量，全部 Sheet 的 LOADED 共用这份数据。 */
+    prepareInitialData(opts: {
+        formState: Record<string, any>;
+        field: string;
+        dataStatus?: string;
+        defaultRowData?: Record<string, any>;
+    }): void;
+    /** 数量依赖实际变化时才重算，避免首次绑定覆盖 LOADED 中的回填。 */
+    syncQtyRequiredFromBomIfChanged(): void;
+    /** 只绑定运行时 Store，不重新生成行或修改行内容。 */
     bindRuntime(opts: {
-        ownerId: string;
         tableDataRef: Ref<any>;
         mainFormState?: Ref<any>;
         dataStatus?: string;
-        defaultRowData?: Record<string, any>;
     }): void;
     /**
      * 消耗表组件挂载时调用：只同步视图依赖，不初始化数据、不注册 watch。
@@ -265,8 +261,10 @@ export declare class MaterialConsumeTableController {
      * qty 相关派生字段统一入口（改 qty_ / 扫码 / 删行 等都走这里）
      */
     updateDerivedQtyFields(): void;
+    /** 同步 BOM 主物料的需求数量单位，未关联 BOM 的行保留原单位。 */
+    private syncRequiredUomFromBom;
     /**
-     * 设置默认值，如工序，需求数量/已消耗数量
+     * 设置默认值，如工序，需求数量/需求数量单位/已消耗数量
      * @param row
      */
     setDefaultValue(row: IMaterialConsumeData): void;

package/dist/src/nocode-base/src/hooks/material-consume/mc-render.d.ts

@@ -15,8 +15,6 @@ export declare class MCRender implements IMcRender {
         type: 'error' | 'warning';
         content: string;
     }): void;
-    /** 每个表单实例独立维护 BOM 弹层参数。 */
-    private readonly bomModalProps;
     openScanModal(opts: {
         title: string;
         subModelKey?: string;
@@ -30,31 +28,6 @@ export declare class MCRender implements IMcRender {
             transformedData?: any;
         }) => void;
     }): Promise<void>;
-    /**
-     * 实际打开UIModal的函数
-     */
-    protected _openBomModal(reactiveOpts: {
-        ownerId: string;
-        bomList: any[];
-        onSubstitute: Function;
-    }): Promise<void>;
-    openBomModal(opts: {
-        ownerId: string;
-        bomList: any[];
-        onSubstitute: Function;
-    }): Promise<void>;
-    /**
-     * 打开修改条码解析规则的modal
-     * 返回空或者修改后的规则字段id
-     * @param opts \
-     * - config 回显用的配置对象
-     * @return {*}
-     */
-    openChangeRuleModal(opts: {
-        config: ParseRuleProps;
-        subModelKey?: string;
-        formModelController: FormModelController;
-    }): Promise<ParseRuleProps | undefined>;
     /**
      * 扫码返回多条候选时，弹窗选择其中一条
      * 取消返回 undefined
@@ -64,7 +37,7 @@ export declare class MCRender implements IMcRender {
         title?: string;
     }): Promise<any | undefined>;
     /**
-     * 销毁所有固定的模态
+     * 关闭当前页面的 form-base 弹层
      */
     destroyAllModals(_ownerId: string): void;
 }

package/dist/src/nocode-base/src/hooks/material-consume/tmpl-bom-controller.d.ts

@@ -1,5 +1,5 @@
 import { IBomEntry, IFormTmplBom, IMaterialConsumeData } from './types';
-import { BaseCoreComponent } from '../../types';
+import { BaseCoreComponent, IMaterialConsumeTableInfo } from '../../types';
 import { MaterialConsumeTableController } from './material-consume-table-controller';
 import { FormInstBomResponse } from '@gct-paas/api/apaas';
 import { MaterialConsumptionPatternEnum } from '../../constant';
@@ -25,6 +25,10 @@ export declare class FormTmplBomController {
     field2TableMap: Record<string, string>;
     /** 默认物料消耗模式 */
     defaultMCPattern: MaterialConsumptionPatternEnum;
+    /** 表单实例身份与 BOM 数据是否存在无关，模板展示也会创建完整控制器。 */
+    hasFormInstance: boolean;
+    /** 按页面中的表解析后的配置，页面与打印共用。 */
+    private resolvedTmplBomList;
     constructor();
     /**
      * 创建独立的打印展示控制器：不请求 BOM/历史消耗，不初始化或修正已填报行。
@@ -57,13 +61,14 @@ export declare class FormTmplBomController {
      * @readonly
      */
     get enableSequenceLoading(): boolean;
-    /**
-     * 初始化模板的物料消耗的配置
-     */
+    private createDefaultConfig;
+    /** 有实例时读取实例配置，无实例时仅创建默认展示控制器。 */
     init(data: {
-        formInstBom: FormInstBomResponse;
-        operationId: string;
-        materialNo: string;
+        formInstBom?: FormInstBomResponse | null;
+        materialConsumeTableList: IMaterialConsumeTableInfo[];
+        hasFormInstance: boolean;
+        operationId?: string;
+        materialNo?: string;
         productQty?: number;
     }): Promise<void>;
     /**
@@ -84,6 +89,14 @@ export declare class FormTmplBomController {
      * @param defaultMap
      */
     handleDefaultMap(defaultMap: Record<string, any>): void;
+    /** 全部 Sheet 的消耗表统一在 LOADED 前准备。 */
+    initializeFormState(opts: {
+        formState: Record<string, any>;
+        dataStatus?: string;
+        defaultDataMap: Record<string, any>;
+    }): void;
+    /** 钩子若修改数量依赖，在创建 Store 和分页前按原规则重算。 */
+    finalizeInitialQuantities(): void;
     submitValidate(): Promise<{
         isValid: boolean;
         fields: Record<string, any[]> | undefined;

package/dist/src/nocode-base/src/hooks/material-consume/types.d.ts

@@ -18,6 +18,8 @@ export interface IBomEntry {
     product_spec_: string;
     /** 单位用量 */
     qty_required_: number;
+    /** 主物料配置的需求数量单位 */
+    uom_id_?: string;
     /** 删除标记 */
     deleted_?: boolean;
     /** 上料方式 */

package/dist/src/nocode-base/src/hooks/material-consume-object/bom-validator.d.ts

@@ -62,9 +62,10 @@ export declare function getObjectBomMaterialLotQuery(opts: {
 } | null;
 /**
  * 表单提交：校验所有物料消耗对象（失败打在对应单元格，收集全部错误）
- * - 记录模式 / 人为指定 / 无配置：不校 BOM
- * - 未开人为指定：有物料则必须在实例 BOM 中
- * - 数量为空留给字段必填；有值且开了数量校验才校数量 vs 需求数量
+ * - 物料范围：无配置 / 人为指定 / 记录模式，不校验物料是否属于 BOM
+ * - 记录模式：仅开启人为指定时，继续执行数量校验
+ * - BOM 模式未开人为指定：有物料则必须在实例 BOM 中
+ * - 数量与需求数量均有值、非查看类型且开启数量校验时，执行数量规则
  * - 人为指定：用 objectBom.entries_[0]；否则用 bomEntries 中与对象物料匹配的明细
  */
 export declare function validateObjectBomQtyOnSubmit(opts: {