@gct-paas/excel 0.1.36 → 0.1.37-beta.1

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

@@ -1,6 +1,7 @@
 import { SubTableCore } from './sub-table-core';
 import { BusinessSubTableProfile } from '../../../../domain/table';
 import { IDefaultValueMap, IFieldStatus } from '../types';
+import { ScanModalInput } from './utils/scan';
 /**
  * Profile 驱动的子表 Core 基类
  *
@@ -74,6 +75,27 @@ export declare class DevicePartConsumeTableCore extends ProfileDrivenSubTableCor
         option?: any;
     }): void;
 }
-/** 生产收料表 Core */
+/** 产线收料表 Core */
 export declare class MaterialRequisitionTableCore extends ProfileDrivenSubTableCore {
 }
+/**
+ * 物料替换表 Core
+ * - 被替换物料从历史消耗中选择，并按当前 SN / 工序过滤
+ * - 选择后回填批号、物料信息和原上料数量
+ * - 替换物料批号回填替换物料信息
+ * - 条码映射结果优先填充空行，否则追加新行
+ */
+export declare class MaterialSubstitutionTableCore extends ProfileDrivenSubTableCore {
+    protected isEmptyScanRow(row: Record<string, unknown>): boolean;
+    handleFieldTd: SubTableCore['handleFieldTd'];
+    calcFieldQuery: SubTableCore['calcFieldQuery'];
+    calcFieldDataSource: SubTableCore['calcFieldDataSource'];
+    handleChange(params: {
+        rowData: any;
+        field: string;
+        value: any;
+        option?: any;
+    }): void;
+    calcSubTableActionMenu: SubTableCore['calcSubTableActionMenu'];
+    protected onScan(input: ScanModalInput): Promise<void>;
+}

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

@@ -7,7 +7,6 @@ import { ScanModalInput } from './utils/scan';
 export declare class SterilizeBatchTableCore extends SubTableCore {
     /** 绘制UI相关工具，复用调拨表扫码弹窗 */
     get render(): import('../..').ISubTableRender;
-    compUnmount(): Promise<void>;
     init(): Promise<void>;
     calcSubTableActionMenu: SubTableCore['calcSubTableActionMenu'];
     handleFieldTd: SubTableCore['handleFieldTd'];

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

@@ -13,7 +13,6 @@ export declare class StocktakeTableCore extends ProfileDrivenSubTableCore {
     get isGroupByWarehouse(): boolean;
     get paramsWarehouseId(): any;
     get render(): import('../..').ISubTableRender;
-    compUnmount(): Promise<void>;
     /**
      * 运行态禁用优先按 row_source_（manual / auto / scan），
      * Profile READONLY_INFO_FIELDS 作为基线由 super 合并。

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

@@ -51,15 +51,10 @@ export declare class SubTableCore {
      * 实际使用的数据（过滤掉打deleted_标签的数据)
      */
     get showTableData(): any[];
-    /** 更新页面 */
-    updateCalcCallback: Function;
     /** 子表组件的setup的时候 */
     compSetup(params: {
         formState: any;
-        updateCalcCallback: Function;
     }): Promise<void>;
-    /** 子表组件的unmount的时候 */
-    compUnmount(): Promise<void>;
     /**
      * 计算子表字段的默认值映射
      * - key是字段的key

package/dist/src/nocode-base/src/core/types/index.d.ts

@@ -7,6 +7,8 @@ export * from './sub-table';
  * @interface RuntimePageCtx
  */
 export interface RuntimePageCtx {
+    /** 多 Sheet 下的归属标识；v1 会使用归一化后的虚拟 sheetId。 */
+    sheetId: string;
     /** 单据信息 */
     docInfo: any;
     /** 外部环境参数 */
@@ -25,6 +27,8 @@ export interface RuntimePageCtx {
  * @interface IRuntimeSubTableCtx
  */
 export interface IRuntimeSubTableCtx {
+    /** 多 Sheet 运行时中子表所属的工作表。 */
+    sheetId: string;
     /** 子表运行时组件对象 */
     widget: ISubTable;
 }

package/dist/src/nocode-base/src/emit/enum.d.ts

@@ -2,26 +2,16 @@
 export declare enum NCB_PROVIDE {
     /** 后端pdf */
     IS_PDF = "NCB_IsPdf",
-    /** 渲染数据 */
-    FROM_DATA = "NCB_FromState",
-    /** 字段默认值数据 */
-    DEFAULT_FIELD_DATA = "NCB_DefaultFieldData",
+    /** 当前渲染宿主的实例注册表 */
+    RUNTIME_INSTANCE_REGISTRY = "NCB_RuntimeInstanceRegistry",
     /** 数据关联关系 */
     DATA_RELATION_SHIP = "NCB_DataRelationShip",
-    /** 修改分页信息 */
-    PAGE_DATA_CALL_BACK = "NCB_PageDataCallback",
-    /** 表单实例信息 */
-    FORM_INST_LIST = "NCB_FormInstList",
     /** 移动端填报字段弹框 */
     MOBILE_FILL_FIELDS_POPUP = "NCB_MobileFillFieldsPopup",
-    /** 表单模板bom控制器映射 */
-    TMPL_BOM_CONTROLLER_MAP = "NCB_TmplBomControllerMap",
     /** 物料消耗表控制器 */
     MATERIAL_CONSUME_TABLE_CONTROLLER = "NCB_MaterialConsumeTableController",
     /** 检验表单元格列索引（PC 脚本事件等） */
     CHECK_TABLE_COL_INDEX = "NCB_CheckTableColIndex",
-    /** 动态子表核心工厂集合 */
-    SUB_TABLE_CORE_FACTORY_MAP = "NCB_SubTableCoreFactoryMap",
     /** 动态子表核心(字段用) */
     SUB_TABLE_CORE = "NCB_SubTableCore",
     /** widgetCenter中的 pager 信息  */

package/dist/src/nocode-base/src/hooks/annotation/form-change-row.d.ts

@@ -1,6 +1,8 @@
 import { IBasicInfoItem } from '../../types';
 type FormChangeRowOp = 'ADD' | 'DEL';
 export interface FormChangeRowDetailMeta {
+    /** 多 Sheet 下用于先激活子表所属工作表；旧记录没有该值时仍按 cellLocation 回退。 */
+    sheetId?: string;
     cellLocation: string;
     cellType: string;
     op: FormChangeRowOp;
@@ -15,17 +17,17 @@ export declare function getFormChangeRowOp(cellLocation?: string): FormChangeRow
 export declare function isAnnLocationSelected(selectId: string | string[] | undefined, loc?: string): boolean;
 /** 幽灵 / 软删展示行：不做字段批注与必填校验 */
 export declare function isFormChangeGhostRow(row: Record<string, any> | null | undefined): boolean;
-export declare function buildStableFieldLocation(subFieldId: string, rowKey: string, fieldId: string, colIdx?: number): string;
 export declare function resolveAnnotationFieldLocation(options: {
     annList?: string[];
     subFieldId?: string;
     fieldId: string;
+    modelKey?: string;
+    subModelKey?: string;
     row?: Record<string, any>;
-    colIdx?: number;
 }): string | undefined;
-export declare function isRowAddedInCurrentFormChange(dataRelationShip: IBasicInfoItem | undefined, subFieldId: string | undefined, row: Record<string, any> | null | undefined): boolean;
-export declare function recordSubtableRowAdd(dataRelationShip: IBasicInfoItem | undefined, subFieldId: string, rows: Record<string, any>[]): void;
-export declare function recordSubtableRowDelete(dataRelationShip: IBasicInfoItem | undefined, subFieldId: string, row: Record<string, any>): void;
+export declare function isRowAddedInCurrentFormChange(dataRelationShip: Pick<IBasicInfoItem, 'formChangeStatus' | 'formChangeNewData'> | undefined, subFieldId: string | undefined, row: Record<string, any> | null | undefined): boolean;
+export declare function recordSubtableRowAdd(dataRelationShip: IBasicInfoItem | undefined, subFieldId: string, rows: Record<string, any>[], sheetId?: string): void;
+export declare function recordSubtableRowDelete(dataRelationShip: IBasicInfoItem | undefined, subFieldId: string, row: Record<string, any>, sheetId?: string): void;
 /** 提交前刷新快照 */
 export declare function enrichFormChangeRowDetails(formChangeNewData: Record<string, any> | undefined, formState: Record<string, any> | undefined): Record<string, any> | undefined;
 export declare function extractFormChangeRowDetails(items: any[] | undefined): FormChangeRowDetailMeta[];

package/dist/src/nocode-base/src/hooks/annotation/runtime-annotation-binding.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+import { IBasicInfoItem } from '../../types';
+import { RenderModeEnum } from '../../constant';
+import { RuntimeInstanceRegistry, RuntimeNavigationTarget } from '../../runtime';
+import { FormChangeRowDetailMeta } from './form-change-row';
+import { IProps, IPayload } from '../render-page/types';
+export declare function createRuntimeAnnotationBinding(runtimeRegistry: RuntimeInstanceRegistry, basicInfoList: Ref<IBasicInfoItem[]>, props: IProps, payload: IPayload, updateRenderModeType: (uniqueId: string, mode: RenderModeEnum, updateButton?: boolean) => Promise<unknown>): {
+    normalizeAnnotationLocation: (uniqueId: string, path: string, sheetId?: string) => string;
+    navigateRuntimeLocation: (uniqueId: string, target: RuntimeNavigationTarget) => Promise<boolean>;
+    setFromEditStatus: (uniqueId: string) => Promise<boolean>;
+    setAnnotationViewStatus: (uniqueId: string, status: boolean, config?: string[] | {
+        locations?: string[];
+        rowDetails?: FormChangeRowDetailMeta[];
+    }) => boolean;
+    setFormChangeRowViewDetails: (uniqueId: string, rowDetails?: FormChangeRowDetailMeta[] | null) => Promise<boolean>;
+    getAnnotationContentList: (uniqueId: string, options?: {}) => any[];
+};

package/dist/src/nocode-base/src/hooks/device-link/controller.d.ts

@@ -7,18 +7,12 @@ import { DeviceInterconnectionResponse } from '@gct-paas/api/platform';
  * @class DeviceLinkTmplController
  */
 export declare class DeviceLinkTmplUtil {
-    static readonly DEFAULT_RECOMMENDED_PROMPT = "\u4EFB\u52A1\uFF1A\u56FE\u7247OCR\u6587\u5B57\u63D0\u53D6\n\u89C4\u5219\uFF1A\u4E0D\u865A\u6784\u5185\u5BB9\uFF0C\u627E\u4E0D\u5230\u6570\u636E\u8FD4\u56DE\u7A7A\uFF0C\u4EC5\u8F93\u51FA\u63D0\u53D6\u7ED3\u679C\n\u7ED3\u679C\u586B\u5145\u81F3${\u76EE\u6807\u5B57\u6BB5}\n\u586B\u5199\u63D0\u53D6\u89C4\u5219\uFF1A";
     /**
      * 创建模板数据
      * @param type
      * @return {*}
      */
     static createTmpl(type: DeviceLink.TmplTypeEnum): DeviceLink.BasicTmpl;
-    /**
-     * 补齐 OCR 模板新增字段，并保持历史配置的原有行为。
-     * 历史模板没有提示词模式时按原来的普通模式处理。
-     */
-    static normalizeAIOcrTmpl(tmpl: DeviceLink.AIOcrTmpl): DeviceLink.AIOcrTmpl;
     /**
      * 推荐模式保存时转成运行提示词：文案保持 ${字段名}，
      * 按插入时记下的字段补上与普通模式相同的 JSON 回写格式。

package/dist/src/nocode-base/src/hooks/form-tmpl-config/device-connector.d.ts

@@ -15,7 +15,7 @@ export declare class DeviceConnector {
     state: {
         unMqttTopicMap: Record<string, Function | undefined>;
         focusFieldKey: string | null;
-        focusSubRowIndex?: number | null | undefined;
+        focusSubRowKey?: string | null | undefined;
         cacheFieldData: Record<string, CacheFocusData>;
     };
     /** 初始化连接器,重置清空数据 */

package/dist/src/nocode-base/src/hooks/index.d.ts

@@ -1,13 +1,14 @@
+export { useFieldPresentation } from './useFieldPresentation';
 export { useStyles } from './useStyles';
 export { useRenderPageFactory, type IProps, type IPayload } from './useRenderPageFactory';
-export { useCurrentPageFormState, useWidgetStaticAttrs, useCalculateFormula, setSelectAnnotationId, setSelectValidatorId, setSelectMobileTdId, getSubTableQuickFillInfo, } from './useRenderData';
-export { useValidator, validate, clearFormRules, deleteSubtableRow, insertSubtableRows, settleAndValidateDisplay, requestFullValidation, requestDisplayValidation, registerValidationContext, unregisterValidationContext, } from './useValidator';
+export { useWidgetStaticAttrs, setSelectAnnotationId, setSelectValidatorId, setSelectMobileTdId, getSubTableQuickFillInfo, } from './useRenderData';
 export { relocateDeletedRowsToEnd } from './validation/utils';
 export { useNocodeEmitter } from './useNocodeEmitter';
 export { useNocodeFormWidget } from './useFormHook';
+export { useRuntimeRowState, type RuntimeRowWriter } from './useRuntimeRowState';
 export { useEbrWikiFactoryV2 } from './useEbrWikiFactoryV2';
-export { useFormulaExpWatcher } from './useFormulaExpWatcher';
 export { useDependency } from './useDependency';
+export { useRuntimeInstanceServices, useRuntimeEditorFlusher } from './useRuntimeInstanceServices';
 export * from './annotation';
 export * from './device-link';
 export * from './form-model';
@@ -18,3 +19,4 @@ export * from './label-parse-rule';
 export * from './material-balance';
 export * from './app-info';
 export * from './operation-receive-qty';
+export * from './udi';

package/dist/src/nocode-base/src/hooks/inspection-decision-rule/evaluator.d.ts

@@ -0,0 +1,11 @@
+import { IDecisionRuleGroup, IInspectionDecisionRule } from '../../types';
+type FormRow = Record<string, any>;
+/** 安全解析设计端保存的规则树；无效或空配置不命中。 */
+export declare function parseInspectionDecisionRuleTree(dataRuleConfig?: string): IDecisionRuleGroup | null;
+/**
+ * 计算规则树。同一子表的条件绑定到同一候选行；引用多个子表时按行组合判断。
+ * 子表为空时保留空绑定，使 OR 分组中的主表条件仍可以独立命中。
+ */
+export declare function evaluateDecisionRuleTree(root: IDecisionRuleGroup, formState: FormRow): boolean;
+export declare function evaluateInspectionDecisionRule(rule: IInspectionDecisionRule | null | undefined, formState: FormRow | null | undefined): boolean;
+export {};

package/dist/src/nocode-base/src/hooks/material-balance/mb-render.d.ts

@@ -5,6 +5,6 @@ import { IMBRender } from '../../types';
  * @class MBRender
  */
 export declare class MBRender implements IMBRender {
-    openConsumeModal(data: any[]): Promise<void>;
-    destoryConsumeModal(): Promise<void>;
+    openConsumeModal(_ownerId: string, _data: any[]): Promise<void>;
+    destoryConsumeModal(_ownerId: string): void;
 }

package/dist/src/nocode-base/src/hooks/material-balance/useMaterialBalance.d.ts

@@ -1,9 +1,9 @@
 export declare function useMaterialBalance(): {
-    getConsumeData: ({ cloneRuntimeJson, operationId, materialNo }: {
-        cloneRuntimeJson: any;
+    getConsumeData: ({ balanceTables, operationId, materialNo }: {
+        balanceTables: any;
         operationId: any;
         materialNo: any;
     }) => Promise<any>;
-    openConsumeModal: (data: any) => void;
-    destoryConsumeModal: () => void;
+    openConsumeModal: (ownerId: string, data: any) => void;
+    destoryConsumeModal: (ownerId: string) => void;
 };

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

@@ -31,6 +31,8 @@ export declare class BomEntryValidator {
     mainMaterialNo: string;
     /** 物料消耗模式 */
     noBomMode: boolean;
+    /** 自定义需求数量，由表格行手动填写 */
+    isCustomRequiredQty: boolean;
     /** 该明细使用到的产品的id集合 */
     productIds: string[];
     /** 物料和code的映射 */
@@ -53,7 +55,9 @@ export declare class BomEntryValidator {
     /** 表单实例的批次号 */
     mainMaterialNo: string, 
     /** 物料消耗模式 */
-    noBomMode: boolean);
+    noBomMode: boolean, 
+    /** 自定义需求数量，由表格行手动填写 */
+    isCustomRequiredQty?: boolean);
     /**
      * 翻译物料的code
      * @param productId
@@ -125,6 +129,8 @@ export declare class BomEntriesValidator {
     mainMaterialNo: string;
     /** 物料消耗模式 */
     noBomMode: boolean;
+    /** 需求数量由表格行手动填写 */
+    isCustomRequiredQty: boolean;
     bomEntryValidators: BomEntryValidator[];
     constructor(entries: IBomEntry[], 
     /** 是否启用顺序投料 */
@@ -136,7 +142,9 @@ export declare class BomEntriesValidator {
     /** 表单实例的批次号 */
     mainMaterialNo: string, 
     /** 物料消耗模式 */
-    noBomMode: boolean);
+    noBomMode: boolean, 
+    /** 需求数量由表格行手动填写 */
+    isCustomRequiredQty?: boolean);
     /**
      * 翻译物料的code
      * @param productId

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

@@ -1,4 +1,4 @@
-import { IBomEntry, IFormTmplBom, IMaterialConsumeData } from './types';
+import { IFormTmplBom, IMaterialConsumeData } from './types';
 import { FormTmplBomController } from './tmpl-bom-controller';
 import { Ref } from 'vue';
 import { BomEntriesValidator, McRowValidateError } from './bom-validator';
@@ -8,28 +8,6 @@ import { FormModelController } from '../form-model/form-model-controller';
 import { MaterialConsumptionPatternEnum } from '../../constant';
 export declare class MCDataUtil {
     static allFields: Array<keyof IMaterialConsumeData>;
-    static editMCTable(row: IMaterialConsumeData, data: IMaterialConsumeData['_MCTABLE']): void;
-    /**
-     * 数组转对象并付统一的值
-     * @static
-     * @param arr
-     * @param [keyVal=true]
-     * @return {*}
-     */
-    static arrToObj(arr: string[], keyVal?: any): any;
-    /**
-     * 设置禁用字段
-     * @static
-     * @param opts 参数
-     */
-    static setFieldsDisabled(opts: {
-        /** 数据 */
-        row: IMaterialConsumeData;
-        /** 属性key集合(不给则默认全部) */
-        keys?: Array<keyof IMaterialConsumeData>;
-        /** 设置的值(不给则true) */
-        disabled?: boolean;
-    }): void;
     /**
      * 设置行数据的编辑状态
      * @static
@@ -66,6 +44,8 @@ export declare class MaterialConsumeTableController {
     dataStatus?: string;
     /** factory 是否已绑定过运行时（避免重复 initTableData） */
     private runtimeBound;
+    /** 多 Sheet / 同屏多实例下，弹层和异步交互使用该键隔离。 */
+    private runtimeOwnerId;
     /** 表单是否已暂存或提交（已处理过则不再跑初始化） */
     get isDataProcessed(): boolean;
     /** 批次数量或生产数量 */
@@ -102,7 +82,14 @@ export declare class MaterialConsumeTableController {
      * 修改表格数据（保留打deleted_标签的数据）
      */
     set actualTableData(value: IMaterialConsumeData[]);
-    constructor(tmplBomController: FormTmplBomController, tmplBom: IFormTmplBom);
+    constructor(tmplBomController: FormTmplBomController, tmplBom: IFormTmplBom, options?: {
+        printOnly?: boolean;
+    });
+    get isCustomRequiredQty(): boolean;
+    private getBomGroupForRow;
+    /** 自定义规则的需求数量在同一 BOM 组内保持一致。 */
+    getCustomGroupRequiredQty(row: IMaterialConsumeData): number | undefined;
+    setCustomGroupRequiredQty(row: IMaterialConsumeData, qty: number | undefined): void;
     /** 错误信息 */
     error(message: string): void;
     /**
@@ -123,7 +110,7 @@ export declare class MaterialConsumeTableController {
      * 实际使用的bom明细信息(排序)
      * @readonly
      */
-    get actualBomEntries(): IBomEntry[];
+    get actualBomEntries(): import('./types').IBomEntry[];
     /**
      * 根据bom明细构造子表数据(初始化时)
      */
@@ -194,6 +181,7 @@ export declare class MaterialConsumeTableController {
      * 不在分页组件 setup 中调用，避免跨页挂载重复 init。
      */
     bindRuntime(opts: {
+        ownerId: string;
         tableDataRef: Ref<any>;
         mainFormState?: Ref<any>;
         dataStatus?: string;

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

@@ -15,11 +15,8 @@ export declare class MCRender implements IMcRender {
         type: 'error' | 'warning';
         content: string;
     }): void;
-    /**
-     * 已经打开的bom的modal的参数对象
-     * @static
-     */
-    static bomModalProps: any;
+    /** 每个表单实例独立维护 BOM 弹层参数。 */
+    private readonly bomModalProps;
     openScanModal(opts: {
         title: string;
         subModelKey?: string;
@@ -37,10 +34,12 @@ export declare class MCRender implements IMcRender {
      * 实际打开UIModal的函数
      */
     protected _openBomModal(reactiveOpts: {
+        ownerId: string;
         bomList: any[];
         onSubstitute: Function;
     }): Promise<void>;
     openBomModal(opts: {
+        ownerId: string;
         bomList: any[];
         onSubstitute: Function;
     }): Promise<void>;
@@ -67,5 +66,5 @@ export declare class MCRender implements IMcRender {
     /**
      * 销毁所有固定的模态
      */
-    destroyAllModals(): void;
+    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, IPaper } from '../../types';
+import { BaseCoreComponent } from '../../types';
 import { MaterialConsumeTableController } from './material-consume-table-controller';
 import { FormInstBomResponse } from '@gct-paas/api/apaas';
 import { MaterialConsumptionPatternEnum } from '../../constant';
@@ -26,12 +26,18 @@ export declare class FormTmplBomController {
     /** 默认物料消耗模式 */
     defaultMCPattern: MaterialConsumptionPatternEnum;
     constructor();
+    /**
+     * 创建独立的打印展示控制器：不请求 BOM/历史消耗，不初始化或修正已填报行。
+     * 表格挂载会 bindView，因此不能把填报中的 tableControllers 直接交给打印组件。
+     */
+    createPrintView(formState: Record<string, any>): FormTmplBomController;
     /**
      * 判断使用场景，不符合的报错提示
      * @param opts
      */
     judgeScene(opts: {
-        cloneRuntimeJson: any;
+        materialConsumeTableList: any[];
+        materialBalanceTableList: any[];
         selfInfo: any;
     }): void;
     /**
@@ -66,8 +72,6 @@ export declare class FormTmplBomController {
      * @return {*}
      */
     findTableControllerByField(field: string): any;
-    /** 计算表单数据(需求废弃，不初始化了) */
-    calcFormState(paper: IPaper): any;
     /**
      * 处理字段组件
      * - 补充物料字段的额外查询条件

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

@@ -1,3 +1,2 @@
-export * from './use-tmpl-bom';
 export * from './bom-validator';
 export * from './product-lot-link';

package/dist/src/nocode-base/src/hooks/material-consume-object/product-lot-link.d.ts

@@ -1,6 +1,7 @@
 import { FormInstBomResponse } from '@gct-paas/api/apaas';
 import { IMaterialConsumeObjectInfo } from '../../types';
 import { ObjectFieldKeys, ObjectSubField } from './bom-validator';
+import { RuntimeRowWriter } from '../useRuntimeRowState';
 export declare function isBlank(value: unknown): boolean;
 /** 优先 objectFieldList（used），缺哪个 key 用 masterFields 补哪个 */
 export declare function resolveObjectFieldKeys(opts: {
@@ -19,6 +20,8 @@ export type ApplyConsumeObjectTraceChangeOpts = {
     prevProduct?: unknown;
     option?: any | null;
     formData: Record<string, any>;
+    /** formData 只用于读取，所有关联写入由当前组件的显式行入口提交。 */
+    rowWriter: RuntimeRowWriter;
     objectFieldList?: IMaterialConsumeObjectInfo[];
     fallbackFields?: ObjectSubField[];
     /** 表单实例 BOM（用于写入 bom_entry_id_） */

package/dist/src/nocode-base/src/hooks/render-page/initialize-runtime.d.ts

@@ -0,0 +1,56 @@
+import { RenderModeEnum, FormTypeEnum, PlatformEnum } from '../../constant';
+import { RuntimeFormStateStore, RuntimeInstanceRegistry, RuntimeInstanceRecord } from '../../runtime';
+import { IProps, IPayload, RuntimeInstanceSource } from './types';
+import { useMaterialBalance } from '../material-balance/useMaterialBalance';
+export declare function createRuntimeInstanceInitializer(props: IProps, payload: IPayload, getConsumeData: ReturnType<typeof useMaterialBalance>['getConsumeData']): (id: string, result: RuntimeInstanceSource) => Promise<{
+    runtimeContext: import('../..').RuntimeInstanceContext;
+    runtimeFormStateStore: RuntimeFormStateStore;
+    runtimeFieldMetadata: import('../..').RuntimeFieldMetadata;
+    scriptRunner: any;
+    basicInfo: {
+        key: string;
+        tid: string;
+        uniqueId: string;
+        modelKey: string;
+        formType: FormTypeEnum;
+        platformType: PlatformEnum;
+        isMockReport: boolean;
+        renderModeType: RenderModeEnum;
+        btnRenderModeType: RenderModeEnum;
+        bpmnType: import('../..').BpmnNodeTypeEnum | undefined;
+        bpmnFieldAuthMap: Record<string, any> | undefined;
+        gct_stashData: boolean;
+        formChangeStatus: boolean;
+        formChangeOriginData: {};
+        formChangeNewData: {};
+        annSwitchStatus: boolean;
+        annCellLocationList: never[];
+        annSelectId: undefined;
+        annRowDetails: never[];
+        validatorLocationList: never[];
+        validatorMessageMap: {};
+        mcValidatorLocationList: never[];
+        mcValidatorMessageMap: {};
+        mobileTdIdGroups: Map<any, any>;
+        mobileSelectTdId: undefined;
+        contentHighlight: {
+            trace: any[];
+        } | {
+            trace?: undefined;
+        };
+        productSearchFields: string;
+        showPrintFieldBg: any;
+        paramsConfig: Record<string, any> | undefined;
+        instanceStatus: any;
+    };
+    selfInfo: {
+        formType: FormTypeEnum;
+        viewType: import('../..').ViewTypeEnum;
+        modelKey: string;
+        bindKey?: string;
+    } & Record<string, any>;
+} | undefined>;
+export type PreparedRuntimeInstance = NonNullable<Awaited<ReturnType<ReturnType<typeof createRuntimeInstanceInitializer>>>>;
+/** 过期请求和批量初始化失败的结果未注册，资源在此释放，不影响当前页面的实例。 */
+export declare function disposePreparedRuntime(instance: PreparedRuntimeInstance): void;
+export declare function bindRuntimeBusinessServices(runtimeRegistry: RuntimeInstanceRegistry, record: RuntimeInstanceRecord, dataStatus?: string): void;

package/dist/src/nocode-base/src/hooks/render-page/runtime-request.d.ts

@@ -0,0 +1,24 @@
+import { RuntimeInstanceRegistry, RuntimeSaveToken } from '../../runtime';
+import { IProps, IPayload, RuntimeSelfInfo, RuntimeInstanceSource } from './types';
+import { PreparedRuntimeInstance } from './initialize-runtime';
+export declare function createRuntimeRequestSource(props: IProps, payload: IPayload): (ids: string[]) => Promise<RuntimeInstanceSource[]>;
+/** 等全部初始化结束后再决定是否安装；失败时释放同批已成功准备的资源。 */
+export declare function prepareRuntimeBatch(instances: RuntimeInstanceSource[], initialize: (id: string, source: RuntimeInstanceSource) => Promise<PreparedRuntimeInstance | undefined>): Promise<PreparedRuntimeInstance[]>;
+/** 加载序号覆盖请求、实例准备和安装全过程；过期错误与完成通知都不会影响新页面。 */
+export declare function createRuntimeLoadPipeline(state: {
+    loading: boolean;
+    error: Error | undefined;
+}, options: {
+    request(ids: string[]): Promise<RuntimeInstanceSource[]>;
+    prepare(sources: RuntimeInstanceSource[]): Promise<PreparedRuntimeInstance[]>;
+    install(prepared: PreparedRuntimeInstance[], isCurrent: () => boolean): Promise<void>;
+}): {
+    load(ids: string[]): Promise<boolean>;
+    invalidate(): void;
+};
+/** 保存后回填与附件读取共用实例索引，不再接收或生成 newBackupInfo 副本。 */
+export declare function createRuntimePersistenceAccess(runtimeRegistry: RuntimeInstanceRegistry, props: IProps, payload: IPayload): {
+    quickSearchRenderData: (uniqueId: string, currentSelfInfo: RuntimeSelfInfo, saveToken?: RuntimeSaveToken) => Promise<boolean>;
+    getAppendixInfos: (uniqueId: string, types?: any[]) => string[];
+    getPdfInfos: (uniqueId: string) => any;
+};

package/dist/src/nocode-base/src/hooks/render-page/runtime-validation.d.ts

@@ -0,0 +1,17 @@
+import { IBasicInfoItem, ValidateFieldErrorMap } from '../../types';
+import { RenderModeEnum, PlatformEnum } from '../../constant';
+import { RuntimeInstanceRecord, RuntimeInstanceRegistry } from '../../runtime';
+import { ValidationCommentMap } from '../validation/types';
+/** 普通字段和物料消耗错误共用更新算法，原生 Error.message 变化也要更新。 */
+export declare function applyValidationComments(info: IBasicInfoItem | undefined, comments: ValidationCommentMap, kind: 'field' | 'material'): void;
+export declare function createRuntimeValidationBinding(runtimeRegistry: RuntimeInstanceRegistry, getInfo: (uniqueId: string) => IBasicInfoItem | undefined, platformType: PlatformEnum): {
+    bindRuntimeValidation: (uniqueId: string) => void;
+    bindFormValidationSync: (uniqueId: string) => void;
+    runSubmissionValidation: (uniqueId: string) => Promise<{
+        /** 是否通过校验 */
+        isValid: boolean;
+        fields?: ValidateFieldErrorMap;
+    } | undefined>;
+    updateRenderModeType: (uniqueId: string, mode: RenderModeEnum, updateButton?: boolean) => Promise<void>;
+    prepareInitialView: (record: RuntimeInstanceRecord) => Promise<void>;
+};

package/dist/src/nocode-base/src/hooks/render-page/types.d.ts

@@ -0,0 +1,64 @@
+import { RenderModeEnum, PlatformEnum, BpmnNodeTypeEnum } from '../../constant';
+import { baseDataUtils } from '../../interface';
+import { RuntimeFormStateStore } from '../../runtime';
+export interface IProps {
+    /** 模板实例id或者模板id */
+    selfId: string | string[] | undefined;
+    /** 批次号 */
+    materialNo?: string;
+    /** 查询条件 */
+    query?: Record<string, any>;
+}
+interface ITemplatePayload {
+    /** 渲染模式类型 */
+    renderModeType?: RenderModeEnum;
+}
+interface IInstancePayload {
+    /** 是否是详情页面 */
+    isDetailPage?: boolean | (() => boolean);
+    /** 获取按钮显示规则 */
+    getBtnDisplayRules?: boolean | (() => boolean);
+    /** 组件传进来的参数 */
+    paramExtraProps?: Record<string, any>;
+}
+interface IDeviceConfig {
+    /** 默认的用户id */
+    defaultUserId: string | undefined;
+    /** 默认的部门id */
+    defaultOrgId: string | undefined;
+    /** 默认的物料查询条件 */
+    defaultProductSearchFields: string;
+}
+export interface IPayload extends ITemplatePayload, IInstancePayload {
+    /** 工厂类型 */
+    factoryType: 'template' | 'instance' | 'batchInstance' | 'batchTemplate';
+    /** 请求接口函数 */
+    requestCallback: (...args: any[]) => any;
+    /** 平台参数类型 */
+    platformType: PlatformEnum;
+    /** 是否是模拟填报 */
+    isMockReport: boolean;
+    /** 设备配置信息 */
+    deviceConfig?: IDeviceConfig;
+    /**所有数据更新加载完后 */
+    onFinisher?: (...args: any[]) => unknown;
+    /**表单打印方法 */
+    formPrint?: (...args: any[]) => unknown;
+    /** 实例注册/保存回填完成后交付当前 Store，宿主用于建立自身的自动保存基准。 */
+    onFormStateReady?: (store: RuntimeFormStateStore) => unknown;
+}
+/** 不同平台接口的开放业务元信息；不是运行时索引或提交数据的副本。 */
+export type RuntimeSelfInfo = Parameters<typeof baseDataUtils.requestRenderData>[0]['info'];
+/** 请求适配后的内部初始化输入，单个/批量入口使用同一约定。 */
+export interface RuntimeInstanceSource {
+    id?: string;
+    tid: string;
+    selfInfo: RuntimeSelfInfo;
+    paramsConfig?: Record<string, any>;
+    fillModeType: RenderModeEnum;
+    btnModelType?: RenderModeEnum;
+    bpmnType?: BpmnNodeTypeEnum;
+    bpmnFieldAuthMap?: Record<string, any>;
+    query?: Record<string, any>;
+}
+export {};

package/dist/src/nocode-base/src/hooks/udi.d.ts

@@ -0,0 +1,6 @@
+/** paramsConfig 中 containerId 优先；没有时使用 snId。 */
+export declare function resolveUdiQuery(paramsConfig?: Record<string, unknown>): Record<string, string> | undefined;
+/** listAll 返回第一条 UDI；兼容接口返回 data / data.data 的历史形态。 */
+export declare function parseUdi(res: unknown): string | undefined;
+/** 请求本身不缓存；默认值服务按实例合并请求并管理生命周期。 */
+export declare function fetchUdi(paramsConfig?: Record<string, unknown>): Promise<string | undefined>;