@gct-paas/excel 0.1.40-beta.9 → 0.1.40

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 的历史消耗中选择，可按行内工序过滤
- * - 替换物料从 LOT/SN 中选择，回填批次和物料信息，保留替换数量
- * - 替换物料批号回填替换物料及其信息
+ * - 被替换物料从历史消耗中选择，并按当前 SN / 工序过滤
+ * - 选择后回填批号、物料信息和原上料数量
+ * - 替换物料批号回填替换物料信息
  * - 条码映射结果优先填充空行，否则追加新行
  */
 export declare class MaterialSubstitutionTableCore extends ProfileDrivenSubTableCore {

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

@@ -110,7 +110,6 @@ export declare class SubTableCore {
     calcFieldStatus(params: {
         rowData: any;
         field: string;
-        formChangeStatus?: boolean;
     }): IFieldStatus;
     /**
      * 计算字段的查询条件，如果返回值有值则修改到td的newQueryData里

package/dist/src/nocode-base/src/core/sub-table/utils/sterilize/field-keys.d.ts

@@ -28,7 +28,8 @@ export declare const F: {
     /** 生产日期 */
     readonly productionDate: "production_date_";
 };
-export { LOCKED_INPUT_FIELDS as STERILIZE_ALWAYS_DISABLED_FIELDS } from '../../../../../../domain/table/business/sterilize/entrust-steril-batch-list/profile/field-keys';
+/** 业务部灭菌表：必然禁用字段（由生产批次号回填，禁止手填） */
+export declare const STERILIZE_ALWAYS_DISABLED_FIELDS: readonly ["product_id_", "product_id_code_", "product_id_spec_", "product_id_name_", "mfg_order_code_", "mfg_order_id_"];
 /** 行变更 handler：生产批次号清空时的字段集 */
 export declare const CLEAR_ON_PROD_CONTAINER_EMPTY: readonly ["product_id_", "product_id__lb_", "product_id_name_", "product_id_code_", "product_id_spec_", "qty_", "mfg_order_code_", "mfg_order_id_", "mfg_order_id__lb_", "production_date_"];
 export declare const fillFromOption: ({

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

@@ -1,4 +1,5 @@
 import { IBomEntry, IMaterialConsumeData } from './types';
+type ConsumeDataSource = 'current' | 'history';
 /** 行级校验错误：提交时挂到对应单元格，扫码/切组仍可读 message */
 export declare class McRowValidateError extends Error {
     readonly targetFieldId: 'product_id_' | 'material_no_' | 'qty_' | 'expiration_date_';
@@ -69,9 +70,9 @@ export declare class BomEntryValidator {
      * @param arr
      * @return {*}
      */
-    filterGroupData(arr: IMaterialConsumeData[]): IMaterialConsumeData[];
-    /** 行是否属于本 BOM 组（优先 bom_entry_id_，避免跨组 product_id_ 误判） */
-    isRowInGroup(row: IMaterialConsumeData): boolean;
+    filterGroupData(arr: IMaterialConsumeData[], source?: ConsumeDataSource): IMaterialConsumeData[];
+    /** 按数据来源优先匹配关联标识，无关联标识时按物料判断。 */
+    isRowInGroup(row: IMaterialConsumeData, source?: ConsumeDataSource): boolean;
     /** 组内已选中的物料（整批替代；不排除当前行） */
     getGroupExistingProductId(tableData: IMaterialConsumeData[]): string | undefined;
     /**
@@ -98,17 +99,17 @@ export declare class BomEntryValidator {
      * @param arr
      * @return {*}
      */
-    calcQtyConsumed(arr?: IMaterialConsumeData[]): number;
+    calcQtyConsumed(arr?: IMaterialConsumeData[], source?: ConsumeDataSource): number;
     /** 上下限校验统一按需求单位口径取转换数量，历史数据未转换时兼容原数量。 */
-    calcQtyForBounds(arr: IMaterialConsumeData[]): number;
+    calcQtyForBounds(arr: IMaterialConsumeData[], source?: ConsumeDataSource): number;
     /**
      * 计算自定义的数量校验的最大值和最小值
      * @param data
      * @return {*}
      */
     calcCustomNumberLimit(data: IMaterialConsumeData): Promise<{
-        max: any;
-        min: any;
+        max: number | undefined;
+        min: number | undefined;
     }>;
     /**
      * 通用校验 5：本组上料数量是否满足 qty_validation_rule_。
@@ -249,3 +250,4 @@ export declare class BomEntriesValidator {
 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;
+export {};

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

@@ -42,8 +42,10 @@ export declare class MaterialConsumeTableController {
     mainFormState: Ref<any>;
     /** 表单数据状态（由 factory bindRuntime 注入）：未填报 / STASH / SUBMIT */
     dataStatus?: string;
-    /** factory 是否已绑定过运行时（避免重复 initTableData） */
-    private runtimeBound;
+    /** 实例数据只在 LOADED 前准备一次，运行时绑定不再重新生成行。 */
+    private initialDataPrepared;
+    /** 最近一次同步需求数量时使用的数量依赖。 */
+    private syncedMaterialNoNum;
     /** 多 Sheet / 同屏多实例下，弹层和异步交互使用该键隔离。 */
     private runtimeOwnerId;
     /** 表单是否已暂存或提交（已处理过则不再跑初始化） */
@@ -172,21 +174,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。
@@ -266,8 +267,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/tmpl-bom-controller.d.ts

@@ -89,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

@@ -4,6 +4,8 @@ import { RequiredQtyCalcRule, ScanParamType } from '../../types/common/base';
 export interface IBomEntry {
     /** 明细id */
     id_: string;
+    /** 父级关联 ID */
+    parent_id_?: string;
     /** 排序字段 */
     sort_num_: number;
     /** 物料id */
@@ -18,6 +20,8 @@ export interface IBomEntry {
     product_spec_: string;
     /** 单位用量 */
     qty_required_: number;
+    /** 主物料配置的需求数量单位 */
+    uom_id_?: string;
     /** 删除标记 */
     deleted_?: boolean;
     /** 上料方式 */
@@ -160,6 +164,8 @@ export interface IMaterialConsumeData {
     deleted_?: boolean;
     /** 后端需要的bom明细id */
     bom_entry_id_?: string;
+    /** 历史消耗的 BOM 父级关联标识，用于匹配 BOM 明细的 parent_id_ */
+    bom_entry_parent_id_?: string;
     /** 扫码未回填 product_id_ 的兜底行标记（记录模式内部瞬态，行生命周期内持久，不向后端提交） */
     _scanFallback?: boolean;
     /** 本次上料汇总数量 */

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

@@ -9,9 +9,11 @@ interface Options {
     fields: readonly unknown[];
     objectInitialValues?: readonly {
         objectField: string;
+        objectFieldName?: string;
         values?: Record<string, any>;
     }[];
+    onWarning?: (message: string) => void;
 }
 /** 只解析对象物料默认值、查询对应详情；赋值和填充统一由默认值入口执行。 */
-export declare function prepareObjectProductDefaults({ enabled, fields, objectInitialValues, }: Options): Promise<ObjectProductDefaultMap>;
+export declare function prepareObjectProductDefaults({ enabled, fields, objectInitialValues, onWarning, }: Options): Promise<ObjectProductDefaultMap>;
 export {};

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

@@ -1,6 +1,6 @@
 import { RenderModeEnum, FormTypeEnum, PlatformEnum } from '../../constant';
 import { RuntimeFormStateStore, RuntimeInstanceRegistry, RuntimeInstanceRecord } from '../../runtime';
-import { IProps, IPayload, RuntimeInstanceSource, RuntimeSelfInfo } from './types';
+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;
@@ -41,10 +41,14 @@ export declare function createRuntimeInstanceInitializer(props: IProps, payload:
         productSearchFields: string;
         showPrintFieldBg: any;
         paramsConfig: Record<string, any> | undefined;
-        businessType: any;
         instanceStatus: any;
     };
-    selfInfo: RuntimeSelfInfo;
+    selfInfo: {
+        formType: FormTypeEnum;
+        viewType: import('../..').ViewTypeEnum;
+        modelKey: string;
+        bindKey?: string;
+    } & Record<string, any>;
 } | undefined>;
 export type PreparedRuntimeInstance = NonNullable<Awaited<ReturnType<ReturnType<typeof createRuntimeInstanceInitializer>>>>;
 /** 过期请求和批量初始化失败的结果未注册，资源在此释放，不影响当前页面的实例。 */

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

@@ -1,7 +1,6 @@
 import { RenderModeEnum, PlatformEnum, BpmnNodeTypeEnum } from '../../constant';
 import { baseDataUtils } from '../../interface';
 import { RuntimeFormStateStore } from '../../runtime';
-import { DataSourceManagerOptions } from '@gct-paas/form-base';
 export interface IProps {
     /** 模板实例id或者模板id */
     selfId: string | string[] | undefined;
@@ -33,8 +32,6 @@ interface IDeviceConfig {
 export interface IPayload extends ITemplatePayload, IInstancePayload {
     /** 工厂类型 */
     factoryType: 'template' | 'instance' | 'batchInstance' | 'batchTemplate';
-    /** 表单、实体和业务数源的宿主查询适配器。 */
-    dataSourceAdapters?: DataSourceManagerOptions['adapters'];
     /** 请求接口函数 */
     requestCallback: (...args: any[]) => any;
     /** 平台参数类型 */
@@ -51,10 +48,7 @@ export interface IPayload extends ITemplatePayload, IInstancePayload {
     onFormStateReady?: (store: RuntimeFormStateStore) => unknown;
 }
 /** 不同平台接口的开放业务元信息；不是运行时索引或提交数据的副本。 */
-export type RuntimeSelfInfo = Parameters<typeof baseDataUtils.requestRenderData>[0]['info'] & {
-    /** detail 返回的交易实例 id，供检验数量查询使用。 */
-    txnInstId?: string;
-};
+export type RuntimeSelfInfo = Parameters<typeof baseDataUtils.requestRenderData>[0]['info'];
 /** 请求适配后的内部初始化输入，单个/批量入口使用同一约定。 */
 export interface RuntimeInstanceSource {
     id?: string;

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

@@ -1,9 +1,3 @@
-export { setFormulaParamsConfig } from './formula-params-cache';
-interface DeviceParamConfig {
-    customFieldKey: string;
-    lowerLimit?: number | string | null;
-    upperLimit?: number | string | null;
-}
-type FetchDeviceParamLimits = (id: any) => Promise<DeviceParamConfig[] | null>;
-export declare function configureDeviceParamCheck(fetcher: FetchDeviceParamLimits): void;
+/** 更新当前表单的参数配置；未传入配置时清空上次的数据。 */
+export declare function setFormulaParamsConfig(paramsConfig?: Record<string, any> | null): void;
 export declare function registerFormulaFuncs(): void;

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

@@ -3,45 +3,6 @@ import { RuntimeInstanceRegistry } from '../runtime';
 import { IProps, IPayload } from './render-page/types';
 export type { IProps, IPayload } from './render-page/types';
 export declare function useRenderPageFactory(props: IProps, payload: IPayload): {
-    dataSourceManagerMap: import('vue').ShallowRef<Record<string, {
-        getSources: () => import('@gct-paas/form-base').DataSourceConfig[];
-        getContext: () => Record<string, unknown>;
-        canExecute: () => boolean;
-        reload: (key: string) => Promise<unknown>;
-        reloadAll: () => Promise<PromiseSettledResult<unknown>[]>;
-        states: {
-            readonly [x: string]: {
-                readonly status: import('@gct-paas/form-base').DataSourceQueryStatus;
-                readonly data?: Readonly<unknown> | undefined;
-                readonly error?: string | undefined;
-            };
-        };
-        query: (key: string, parameters?: import('@gct-paas/form-base').DataSourceParameters) => Promise<unknown>;
-        cancel: (key: string) => boolean;
-        getResult(key: string): unknown;
-        initialize: () => Promise<PromiseSettledResult<unknown>[]>;
-        queryOnValueChange(keys: readonly string[]): Promise<PromiseSettledResult<unknown>[]>;
-        dispose(): void;
-    }>, Record<string, {
-        getSources: () => import('@gct-paas/form-base').DataSourceConfig[];
-        getContext: () => Record<string, unknown>;
-        canExecute: () => boolean;
-        reload: (key: string) => Promise<unknown>;
-        reloadAll: () => Promise<PromiseSettledResult<unknown>[]>;
-        states: {
-            readonly [x: string]: {
-                readonly status: import('@gct-paas/form-base').DataSourceQueryStatus;
-                readonly data?: Readonly<unknown> | undefined;
-                readonly error?: string | undefined;
-            };
-        };
-        query: (key: string, parameters?: import('@gct-paas/form-base').DataSourceParameters) => Promise<unknown>;
-        cancel: (key: string) => boolean;
-        getResult(key: string): unknown;
-        initialize: () => Promise<PromiseSettledResult<unknown>[]>;
-        queryOnValueChange(keys: readonly string[]): Promise<PromiseSettledResult<unknown>[]>;
-        dispose(): void;
-    }>>;
     counter: import('vue').Ref<number, number>;
     finisher: import('vue').Ref<number, number>;
     loading: import('vue').ComputedRef<boolean>;
@@ -87,7 +48,6 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         renderPurpose?: "print" | "pdf" | undefined;
         showPrintFieldBg?: boolean | undefined;
         paramsConfig?: Record<string, any> | undefined;
-        businessType?: string | undefined;
         instanceStatus?: string | undefined;
     }[], IBasicInfoItem[] | {
         key: string;
@@ -130,7 +90,6 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         renderPurpose?: "print" | "pdf" | undefined;
         showPrintFieldBg?: boolean | undefined;
         paramsConfig?: Record<string, any> | undefined;
-        businessType?: string | undefined;
         instanceStatus?: string | undefined;
     }[]>;
     selfInfoList: import('vue').Ref<{
@@ -139,14 +98,17 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         viewType: import('..').ViewTypeEnum;
         modelKey: string;
         bindKey?: string | undefined;
-        txnInstId?: string | undefined;
-    }[], import('./render-page/types').RuntimeSelfInfo[] | {
+    }[], ({
+        formType: import('..').FormTypeEnum;
+        viewType: import('..').ViewTypeEnum;
+        modelKey: string;
+        bindKey?: string;
+    } & Record<string, any>)[] | {
         [x: string]: any;
         formType: import('..').FormTypeEnum;
         viewType: import('..').ViewTypeEnum;
         modelKey: string;
         bindKey?: string | undefined;
-        txnInstId?: string | undefined;
     }[]>;
     hasData: import('vue').ComputedRef<boolean>;
     findFormInsInfo: (id: string) => {
@@ -155,7 +117,6 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         viewType: import('..').ViewTypeEnum;
         modelKey: string;
         bindKey?: string | undefined;
-        txnInstId?: string | undefined;
     } | undefined;
     findBasicInsInfo: (id: string) => {
         key: string;
@@ -198,7 +159,6 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         renderPurpose?: "print" | "pdf" | undefined;
         showPrintFieldBg?: boolean | undefined;
         paramsConfig?: Record<string, any> | undefined;
-        businessType?: string | undefined;
         instanceStatus?: string | undefined;
     } | undefined;
     updateRenderModeType: (uniqueId: string, mode: import('..').RenderModeEnum, updateButton?: boolean) => Promise<void>;

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

@@ -9,27 +9,6 @@ export declare function useRuntimeInstanceServices(uniqueIdSource?: RuntimeInsta
     instance: import('vue').ComputedRef<import('..').RuntimeInstanceRecord | undefined>;
     /** 控制器负责 Sheet 切换、编辑器收口和提交；尚未挂载时为空。 */
     controller: import('vue').ComputedRef<import('..').RuntimeInstanceController | undefined>;
-    /** 全部 Sheet 共享的数源管理器，随实例注册与销毁。 */
-    dataSourceManager: import('vue').ComputedRef<{
-        getSources: () => import('@gct-paas/form-base').DataSourceConfig[];
-        getContext: () => Record<string, unknown>;
-        canExecute: () => boolean;
-        reload: (key: string) => Promise<unknown>;
-        reloadAll: () => Promise<PromiseSettledResult<unknown>[]>;
-        states: {
-            readonly [x: string]: {
-                readonly status: import('@gct-paas/form-base').DataSourceQueryStatus;
-                readonly data?: Readonly<unknown> | undefined;
-                readonly error?: string | undefined;
-            };
-        };
-        query: (key: string, parameters?: import('@gct-paas/form-base').DataSourceParameters) => Promise<unknown>;
-        cancel: (key: string) => boolean;
-        getResult(key: string): unknown;
-        initialize: () => Promise<PromiseSettledResult<unknown>[]>;
-        queryOnValueChange(keys: readonly string[]): Promise<PromiseSettledResult<unknown>[]>;
-        dispose(): void;
-    } | undefined>;
     /** 表单级配置独立于 Sheet 的 paper；实例未注册时提供空配置。 */
     formConfig: import('vue').ComputedRef<Record<string, any>>;
     /** 实例切换时重新取对应 Store；读取数据使用 .value.state，写入使用 Store 方法。 */

package/dist/src/nocode-base/src/interface/ref-loader.d.ts

@@ -34,18 +34,7 @@ export type RefCustomLoaderRawResult = RefLoaderNormalizedResult | {
     dict?: any;
     pageSize?: number;
 } | any[];
-export type RefCustomLoader = ((params: RefCustomLoaderParams) => Promise<RefCustomLoaderRawResult>) & {
-    /** 下拉展开前校验；未通过时由字段组件弹出 message 并阻止展开。 */
-    beforeOpen?: () => Promise<{
-        allowed: boolean;
-        message?: string;
-    }>;
-    /** 选项关联同一物料时，仍按批次等独立身份高亮。 */
-    getSelectedKey?: () => string | undefined;
-    getOptionKey?: (option: RefLoaderNormalizedResult['options'][number]) => string;
-    /** 选中后立即与主字段一起回填的关联数据。 */
-    getSelectionPatch?: (record: Record<string, any>) => Record<string, unknown>;
-};
+export type RefCustomLoader = (params: RefCustomLoaderParams) => Promise<RefCustomLoaderRawResult>;
 /** 从 queryData 中提取快捷搜索关键字 */
 export declare function extractKeywordFromQueryData(queryData?: Record<string, any>): any;
 /** 将自定义数据源返回值标准化为 ref 组件消费结构 */

package/dist/src/nocode-base/src/interface/transform.d.ts

@@ -147,6 +147,11 @@ export declare const transformUtils: {
     };
     /** 数据转成真实提交数据（二维表要平铺）；layout 是所有 Sheet 的业务表汇总索引。 */
     getSubmitFormData: (formData: any, layout: {
+        subTableInfo?: {
+            field: string;
+            key?: string;
+        }[];
+        businessTableFields?: readonly string[];
         subTable2DList?: any[];
         checkTable2DList?: any[];
         materialConsumeTableList?: any[];

package/dist/src/nocode-base/src/runtime/conversions/v1-runtime.d.ts

@@ -3,7 +3,7 @@ import { NormalizedRuntimeDocument, RuntimeNodeMap } from '../multi-sheet-runtim
 export declare const LEGACY_RUNTIME_SHEET_ID = "__legacy_sheet__";
 export declare const LEGACY_RUNTIME_SHEET_TITLE = "\u5DE5\u4F5C\u8868 1";
 /** 历史 runtimeJson 中存放在 paper.props、实际属于整份实例的配置。 */
-export declare const LEGACY_RUNTIME_FORM_CONFIG_KEYS: readonly ["globalParams", "paramsMapList", "unitConversionRules", "inspectionDecisionRule", "customDataSource", "dataSources", "fieldFills", "objectInitialValues", "javascript", "checkSignatureConfig", "keepExceptionHighlight", "objectFieldList", "dateObjects"];
+export declare const LEGACY_RUNTIME_FORM_CONFIG_KEYS: readonly ["globalParams", "paramsMapList", "unitConversionRules", "inspectionDecisionRule", "customDataSource", "objectInitialValues", "javascript", "checkSignatureConfig", "keepExceptionHighlight", "objectFieldList", "dateObjects"];
 /** 历史运行时：paper 和所有节点都直接放在文档顶层。 */
 export interface RuntimeDocumentV1 extends RuntimeNodeMap {
     schemaVersion?: 1;

package/dist/src/nocode-base/src/runtime/formula-utils.d.ts

@@ -3,5 +3,7 @@ export declare const getParseFormulaVarInfos: (expr?: string) => {
     rowArgs: string[];
     parseInfos: IParseFormulaVar[];
 };
+/** 计算与变更比较共用同一份输入解析，避免关联字段、空值及聚合的取值语义分叉。 */
+export declare const resolveFormulaData: (expr: string, formData: any, instanceFormState: any) => Record<string, any>;
 /** 当前行变量从 formData 解析；主表及子表汇总变量从完整实例解析，可跨 Sheet 引用。 */
 export declare const calculateFormula: (expr: string, formData: any, instanceFormState: any) => Promise<any>;

package/dist/src/nocode-base/src/runtime/multi-sheet-runtime.d.ts

@@ -1,3 +1,4 @@
+import { FormTypeEnum } from '../constant';
 /** 当前真实多 Sheet 运行时格式版本。缺少版本号的历史数据按 v1 解析。 */
 export declare const MULTI_SHEET_SCHEMA_VERSION: 2;
 export declare const MAX_RUNTIME_SHEETS = 100;
@@ -30,10 +31,11 @@ export interface NormalizedRuntimeDocument {
  * 将历史 v1 和真实多 Sheet v2 统一为同一种读取结构。
  *
  * - v1：顶层 paper + nodes，包装成一个固定标识的虚拟 Sheet。
+ * - 文件表单：历史空模板补一个内存中的空根节点，以复用实例 Store 和提交服务。
  * - v2：读取有序 sheets，并为现有单 Sheet 渲染器组装 dataCenter。
  * - 未知版本：直接报错，避免旧客户端误写更高版本数据。
  */
-export declare function normalizeRuntime(runtime: unknown): NormalizedRuntimeDocument;
+export declare function normalizeRuntime(runtime: unknown, formType?: FormTypeEnum): NormalizedRuntimeDocument;
 /**
  * 将各 Sheet 独立编译得到的旧式 dataCenter 封装为 v2 文档。
  * 保存前复用统一解析器，保证整份模板的节点唯一性和引用完整性。

package/dist/src/nocode-base/src/runtime/runtime-context.d.ts

@@ -1,4 +1,5 @@
 import { IPageData } from '../types';
+import { FormTypeEnum } from '../constant';
 import { NormalizedRuntimeDocument, RuntimeNodeMap } from './multi-sheet-runtime';
 import { SubTableCoreFactory } from '../core/factory/sub-table-factory';
 import { FormTmplBomController } from '../hooks/material-consume/tmpl-bom-controller';
@@ -100,6 +101,8 @@ export interface RuntimeInstanceContext {
     uniqueId: string;
     instanceId: string;
     templateId: string;
+    /** 文件表单由 PDF 组件分页，不参与工作表布局计算。 */
+    formType?: FormTypeEnum;
     schemaVersion: NormalizedRuntimeDocument['schemaVersion'];
     formConfig: Record<string, any>;
     defaultData: Record<string, any>;
@@ -116,6 +119,7 @@ export interface CreateRuntimeInstanceContextOptions {
     uniqueId: string;
     instanceId: string;
     templateId: string;
+    formType?: FormTypeEnum;
     runtime: NormalizedRuntimeDocument;
     defaultData: Record<string, any>;
     activeSheetId?: string;

package/dist/src/nocode-base/src/runtime/runtime-field-initializer.d.ts

@@ -4,7 +4,6 @@ type InitializerMetadata = {
     materialNo?: string;
     params?: string;
     instanceStatus?: string;
-    txnInstId?: string;
 };
 export declare class RuntimeFieldInitializer {
     private readonly record;

package/dist/src/nocode-base/src/runtime/runtime-field-state.d.ts

@@ -1,11 +1,8 @@
 import { IBasicInfoItem } from '../types';
 import { RuntimeInstanceRecord } from './runtime-instance-registry';
 export type RuntimeFieldStateInfo = Pick<IBasicInfoItem, 'renderModeType' | 'modelKey' | 'formType' | 'bpmnType' | 'bpmnFieldAuthMap'> & Partial<Pick<IBasicInfoItem, 'annSwitchStatus' | 'renderPurpose'>>;
-/**
- * Core 提供业务规则，这里统一合并到静态配置；二维交叉字段使用所属父行的业务状态。
- * 表单变更跳过签名锁定，保留字段本身、业务 Profile 和组件依赖施加的限制。
- */
-export declare function resolveRuntimeFieldProps(record: RuntimeInstanceRecord, props: Record<string, any>, widgetId: string, row?: Record<string, any>, parentRow?: Record<string, any>, formChangeStatus?: boolean): {
+/** Core 提供业务规则，这里统一合并到静态配置；二维交叉字段使用所属父行的业务状态。 */
+export declare function resolveRuntimeFieldProps(record: RuntimeInstanceRecord, props: Record<string, any>, widgetId: string, row?: Record<string, any>, parentRow?: Record<string, any>): {
     [x: string]: any;
 };
 /** 只读展示方式、禁用和校验 blocked 由同一结果派生，UI 与未挂载字段使用相同权限语义。 */

package/dist/src/nocode-base/src/runtime/runtime-form-state-store.d.ts

@@ -8,6 +8,8 @@ export interface FormStateChange {
     paths: string[];
     /** 整个事务的变更来源。 */
     source: FormStateMutationSource;
+    /** 局部恢复只触发实际变更字段的联动；缺省仍按整份数据恢复处理。 */
+    restoreScope?: 'fields';
 }
 export type FormStateSubscriber = (change: FormStateChange) => void;
 /**
@@ -35,7 +37,7 @@ export declare class RuntimeFormStateStore {
     private readonly reactiveState;
     /** 每次成功提交一批变更递增一次，保存和提交用它判断快照是否过期。 */
     revision: number;
-    /** 是否存在尚未保存的变更；restore 来源不会把实例标记为脏。 */
+    /** 是否存在尚未保存的变更；数据恢复及保存回填不会把实例标记为脏。 */
     dirty: boolean;
     /** 当前嵌套事务深度；只有最外层事务结束时才递增 revision 并通知订阅方。 */
     private mutationDepth;
@@ -43,6 +45,7 @@ export declare class RuntimeFormStateStore {
     private pendingPaths;
     /** 最外层事务的变更来源，嵌套写入沿用该来源。 */
     private pendingSource;
+    private pendingRestoreScope?;
     /** 联动、分页失效、自动保存等实例服务登记的变更监听器。 */
     private readonly subscribers;
     /** 用户主动修改过的业务路径，供公式和自动填充执行“不覆盖用户输入”策略。 */
@@ -89,6 +92,7 @@ export declare class RuntimeFormStateStore {
     /**
      * 保存后只回填后端身份元数据，不能用仅含 id_/front_row_key_ 的数组覆盖当前业务行。
      * 二维内置复合键可通过原始子行键匹配保存前的本地行。
+     * 保存回填只通知实际变化的字段，不作为整份数据恢复触发全部赋值规则。
      */
     patchSavedMetadata(values: Record<string, any>): void;
     /**
@@ -100,7 +104,7 @@ export declare class RuntimeFormStateStore {
      * 将多次深层写入合并成一次变更提交。
      * 嵌套事务只累计路径，最外层 finally 统一递增 revision 并通知订阅方。
      */
-    transaction<T>(source: FormStateMutationSource, callback: (state: Record<string, any>) => T): T;
+    transaction<T>(source: FormStateMutationSource, callback: (state: Record<string, any>) => T, options?: Pick<FormStateChange, 'restoreScope'>): T;
     /** 登记路径和来源后执行底层修改，是所有显式 Store 写方法的统一入口。 */
     mutate<T>(paths: string[], source: FormStateMutationSource, callback: () => T): T;
     /** 查询某业务路径是否曾由用户主动修改。 */

package/dist/src/nocode-base/src/runtime/runtime-instance-registry.d.ts

@@ -11,7 +11,6 @@ import { RuntimeFieldRegistry, RuntimeFieldMetadata } from './runtime-field-regi
 import { RuntimeSheetService } from './runtime-sheet-service';
 import { RuntimePersistenceCoordinator } from './runtime-persistence-coordinator';
 import { RuntimeInstanceEventBus } from './runtime-instance-event-bus';
-import { DataSourceManager } from '@gct-paas/form-base';
 export interface RuntimeInstanceRecord {
     /** 实例配置、业务索引和各 Sheet 的响应式状态；数据只由下方 Store 持有 */
     context: RuntimeInstanceContext;
@@ -24,8 +23,6 @@ export interface RuntimeInstanceRecord {
     ruleCompiler?: RuntimeRuleCompiler;
     /** 业务默认值随实例及动态行初始化，不依赖控件挂载。 */
     fieldInitializer?: RuntimeFieldInitializer;
-    /** 整份表单共享的数源管理器；字段事件通过当前实例取用。 */
-    dataSourceManager?: DataSourceManager;
     /** 实例唯一的数据写入口，生成 revision、dirty 和字段变更路径 */
     formState: RuntimeFormStateStore;
     /** 整份表单共享的脚本执行器，字段通过运行时记录调用，销毁由注册表负责。 */
@@ -74,7 +71,10 @@ export declare class RuntimeInstanceRegistry {
         loading: boolean;
         error: Error | undefined;
     }>;
-    /** 顶层容器和记录都只做浅响应式；服务类仍保持原始引用。 */
+    /**
+     * 顶层对象使用浅响应式：实例新增、删除需要驱动 Vue 更新；record 内的服务类
+     * 不需要被 Vue 深度代理，各自内部负责自己的响应式状态和生命周期
+     */
     private readonly records;
     /**
      * 统一托管订阅、watch 和编译结果的取消函数
@@ -87,7 +87,7 @@ export declare class RuntimeInstanceRegistry {
      * 此方法只创建实例级基础设施，不负责请求模板和业务数据。相同 uniqueId
      * 再次注册时会先完整销毁旧记录，确保不会残留订阅或异步任务
      */
-    register(context: RuntimeInstanceContext, options: RegisterRuntimeInstanceOptions): import('vue').ShallowReactive<RuntimeInstanceRecord>;
+    register(context: RuntimeInstanceContext, options: RegisterRuntimeInstanceOptions): RuntimeInstanceRecord;
     /**
      * 在页面回调准备完成后挂载实例控制器
      * Sheet 服务的导航入口依赖控制器切换 Sheet，所以两者必须在这里建立连接

package/dist/src/nocode-base/src/runtime/table-row-identity.d.ts

@@ -9,6 +9,8 @@ export declare function decodeTableCellRowKey(rowKey: unknown): PersistedTableCe
 /** 未配置业务引用或引用值为空时，将子行与列行身份共同持久化到已有字段。 */
 export declare function encodeTableCellRowKey(cellRowKey: unknown, columnRowKey: unknown): string;
 export declare function isTableRowKeyMatch(rowKey: unknown, expected: unknown): boolean;
+/** 内置二维行键自带点号，路径匹配时仍须作为一个完整行身份处理。 */
+export declare function splitRuntimeDataPath(path: string): string[];
 export interface RuntimeTableRelation {
     rowSubFieldKey: string;
     colSubFieldKey?: string;

package/dist/src/nocode-base/src/types/common/base.d.ts

@@ -106,8 +106,6 @@ export declare namespace BaseCoreComponent {
          * 组件依赖
          */
         componentDependency?: DisplayProps;
-        /** 字段值变化时查询的数源 KEY。 */
-        valueChangeDataSourceKeys?: string[];
         /** 是否是物料消耗表的字段 */
         isMaterialConsumeField?: boolean;
         /** 自定义组件的绘制标记 */
@@ -377,8 +375,6 @@ export interface IBasicInfoItem {
     showPrintFieldBg?: boolean;
     /** 填报入参（selfInfo.params + paramExtraProps） */
     paramsConfig?: Record<string, any>;
-    /** detail 返回的单据业务类型，供业务字段查询匹配场景。 */
-    businessType?: string;
     /** 实例状态 */
     instanceStatus?: string;
 }

package/dist/src/online-form/src/components/device/device-select.vue.d.ts

@@ -13,8 +13,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
     "onSelected-change"?: ((value: DeviceInterconnectionResponse) => any) | undefined;
 }>, {
-    trigger: Array<"click" | "hover" | "contextmenu">;
     modelValue: string;
+    trigger: Array<"click" | "hover" | "contextmenu">;
     showColumns: Array<keyof DeviceLink.IDeviceLinkParams>;
     styleMode: "button" | "link";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;