@gct-paas/excel 0.1.35 → 0.1.37-beta.0

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>;

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

@@ -0,0 +1,3 @@
+/** 更新当前表单的参数配置；未传入配置时清空上次的数据。 */
+export declare function setFormulaParamsConfig(paramsConfig?: Record<string, any> | null): void;
+export declare function registerFormulaFuncs(): void;

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

@@ -2,6 +2,7 @@ import { BaseCoreComponent } from '../types';
 export declare function useDependency(widget: BaseCoreComponent.BasicSchema, props: any): {
     value: import('vue').WritableComputedRef<any, any>;
     formRowData: Readonly<import('vue').Ref<any, any>>;
-    targetFieldId: string | undefined;
+    formRowPath: import('vue').ComputedRef<string>;
+    targetFieldId: string;
     fieldWidget: import('vue').Ref<any, any>;
 };

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

@@ -0,0 +1,4 @@
+/** 仅生成控件样式；不注册、覆盖或删除实例校验规则。 */
+export declare function useFieldPresentation(props: any): {
+    widgetStyles: import('vue').ComputedRef<{}>;
+};

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

@@ -1,15 +1,18 @@
 export declare function useNocodeFormWidget(props: any, emit: any): {
-    getValue: () => any;
-    setValue: (v: any) => void;
     onChange: (callback?: any, valueData?: any, optionDetail?: any) => Promise<void>;
     onBlur: () => void;
     onPressEnter: () => Promise<void>;
     value: import('vue').WritableComputedRef<any, any>;
-    realFieldId: import('vue').ComputedRef<string | undefined>;
+    realFieldId: import('vue').ComputedRef<string>;
+    formStateChangePath: import('vue').ComputedRef<string>;
     annotationInfo: import('vue').ComputedRef<false | {
         annClassList: string[];
-        annFieldId: string | undefined;
+        annFieldId: string;
         showValidatorClass: boolean;
     }>;
     isDynValue: import('vue').ComputedRef<boolean>;
+    setRowField: (fieldKey: string, value: any, source: import('..').FormStateMutationSource) => void;
+    patchRow: (values: Record<string, any>, source: import('..').FormStateMutationSource) => void;
+    getRowFieldPath: (fieldKey: string) => string;
+    markRowFieldUserModified: (fieldKey: string) => void;
 };

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

@@ -1,2 +1,3 @@
-export declare function mergeMarkedTd(): void;
-export declare function waitDomStable(el: HTMLElement, idle?: number, timeout?: number, __isPrintRender?: boolean): Promise<void>;
+export declare function mergeMarkedTd(root?: ParentNode): void;
+/** 等待页面 DOM 静止后合并；就绪由 whenReady 交付，不再用网络心跳影响 Puppeteer。 */
+export declare function waitDomStable(el: HTMLElement, idle?: number, timeout?: number): Promise<void>;

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

@@ -1,14 +1,6 @@
 export declare enum EmitterEnum {
-    /** 打开单个批注详情 */
-    __on__open_single_annotation_detail_ = "__on__open_single_annotation_detail_",
-    /** 更新页面 */
-    __on__update_page_dom_ = "__on__update_page_dom_",
     /** 电子批记录选择单据实例id */
-    __on_select_ebr_doc_instance_id = "__on_select_ebr_doc_instance_id",
-    /** 循环自动保存 */
-    __on_looper_auto_save = "__on_looper_auto_save",
-    /** 电子批记录比对formstate */
-    __on_diff_ebr_form_state = "__on_diff_ebr_form_state"
+    __on_select_ebr_doc_instance_id = "__on_select_ebr_doc_instance_id"
 }
 export declare function useNocodeEmitter(): {
     emitter: import('../../../shared/utils/mitt').Emitter<Record<import('../../../shared/utils/mitt').EventType, unknown>>;

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

@@ -1,9 +1,6 @@
 import { MobileFillTypeEnum } from '../constant';
-import { BaseCoreComponent, IBasicInfoItem, IParseFormulaVar, ITd, ICheckTable2DInfo } from '../types';
-/** 获取当前页面的formState */
-export declare function useCurrentPageFormState(): {
-    currentPageFormState: import('vue').ComputedRef<any>;
-};
+import { BaseCoreComponent, IBasicInfoItem, ITd, ICheckTable2DInfo } from '../types';
+import { RuntimeInstanceEventBus } from '../runtime';
 /** 获取组件静态属性 */
 export declare function useWidgetStaticAttrs(widget: any): {
     field: any;
@@ -14,7 +11,7 @@ export declare function useWidgetStaticAttrs(widget: any): {
     refModelKey: any;
     isFieldModel: any;
     fieldLink: any;
-    targetFieldId: any;
+    targetFieldId: string;
     placeholder: any;
     bindCompStyleType: any;
     /** 字段名称 */
@@ -22,11 +19,11 @@ export declare function useWidgetStaticAttrs(widget: any): {
     /** 字段所属模型名称 */
     showModelName: any;
     /** 是否必填 */
-    showRequired: import('vue').Ref<any, any>;
+    showRequired: import('vue').ComputedRef<boolean>;
     /** 是否禁用 */
-    showDisabled: import('vue').ComputedRef<any>;
+    showDisabled: import('vue').ComputedRef<boolean>;
     /** 显示状态 */
-    showDisplayStatus: import('vue').ComputedRef<"readonly-text" | "readonly-component" | "edit-component">;
+    showDisplayStatus: import('vue').ComputedRef<string>;
     /** 下拉列表 */
     options: any;
     /** 附件、图片配置项 */
@@ -59,23 +56,10 @@ export declare function useWidgetStaticAttrs(widget: any): {
     /** 序列号 */
     newSnNo: any;
 };
-/** 公式计算 */
-export declare function useCalculateFormula(): {
-    identify: (...args: any[]) => string[];
-    getParseFormulaVarInfos: (expr?: string) => {
-        rowArgs: string[];
-        parseInfos: IParseFormulaVar[];
-    };
-    calculateFormula: (expr: string, formData: any, currentPageFormState: any) => Promise<any>;
-    getMergeParseInfos: (options: {
-        minFormulaExpr: string;
-        maxFormulaExpr: string;
-    }) => IParseFormulaVar[];
-};
 /** 选择批注 id；传入 event 且点在三角上时，汇总同格/组合字段内全部变更坐标 */
-export declare function setSelectAnnotationId(id: string | undefined, basicInfoItem: IBasicInfoItem | undefined, event?: MouseEvent): void;
+export declare function setSelectAnnotationId(id: string | undefined, basicInfoItem: IBasicInfoItem | undefined, event?: MouseEvent, eventBus?: RuntimeInstanceEventBus): void;
 /** 关闭所有校验 Popover，避免旧锚点残留导致位置漂移 */
-export declare function closeValidatorPopovers(): void;
+export declare function closeValidatorPopovers(uniqueId: string): void;
 /** 选择校验错误信息id */
 export declare function setSelectValidatorId(event: MouseEvent, basicInfoItem: IBasicInfoItem | undefined): void;
 /** 选择移动端tdId */

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

@@ -1,77 +1,26 @@
-import { RenderModeEnum, FormTypeEnum, PlatformEnum, BpmnNodeTypeEnum } from '../constant';
-import { IPageData, IBasicInfoItem, ValidateFieldErrorMap } from '../types';
-import { FormTmplBomController } from './material-consume';
-import { SubTableCoreFactory } from '../core/factory/sub-table-factory';
-import { FormChangeRowDetailMeta } from './annotation/form-change-row';
-export interface IProps {
-    /** 模板实例id或者模板id */
-    selfId: string | string[] | undefined;
-    /** 批次号 */
-    materialNo?: string;
-    /** 查询条件 */
-    query?: Record<string, any>;
-}
-interface ITemplatePayload {
-    /** 渲染模式类型 */
-    renderModeType?: RenderModeEnum;
-}
-interface IInstancePayload {
-    /** 是否是详情页面 */
-    isDetailPage?: boolean | Function;
-    /** 获取按钮显示规则 */
-    getBtnDisplayRules?: boolean | Function;
-    /** 组件传进来的参数 */
-    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: Function;
-    /** 平台参数类型 */
-    platformType: PlatformEnum;
-    /** 是否是模拟填报 */
-    isMockReport: boolean;
-    /** 设备配置信息 */
-    deviceConfig?: IDeviceConfig;
-    /**所有数据更新加载完后 */
-    onFinisher?: Function;
-    /**表单打印方法 */
-    formPrint?: Function;
-    /** 初始化加载数据之后 */
-    afterProcessData?: Function;
-}
+import { IBasicInfoItem } from '../types';
+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): {
     counter: import('vue').Ref<number, number>;
     finisher: import('vue').Ref<number, number>;
-    loading: import('vue').Ref<boolean, boolean>;
-    dataCenterMap: import('vue').Ref<Record<string, any>, Record<string, any>>;
-    pageDataMap: import('vue').Ref<Record<string, IPageData[]>, Record<string, IPageData[]>>;
-    formStateMap: import('vue').Ref<Record<string, Record<string, any>>, Record<string, Record<string, any>>>;
-    defaultDataMap: import('vue').Ref<Record<string, any>, Record<string, any>>;
+    loading: import('vue').ComputedRef<boolean>;
+    runtimeRegistry: RuntimeInstanceRegistry;
     basicInfoList: import('vue').Ref<{
         key: string;
         tid: string;
         uniqueId: string;
         modelKey: string;
-        formType: FormTypeEnum;
-        platformType: PlatformEnum;
+        formType: import('..').FormTypeEnum;
+        platformType: import('..').PlatformEnum;
         posType?: import('..').PosEnum | undefined;
-        renderModeType: RenderModeEnum;
-        btnRenderModeType: RenderModeEnum;
+        renderModeType: import('..').RenderModeEnum;
+        btnRenderModeType: import('..').RenderModeEnum;
         isMockReport: boolean;
         gct_stashData: boolean;
-        bpmnType?: BpmnNodeTypeEnum | undefined;
+        bpmnType?: import('..').BpmnNodeTypeEnum | undefined;
         bpmnFieldAuthMap?: Record<string, import('../types/common/base').IBpmnFieldAuthItem> | undefined;
-        eventInstance?: any;
         formChangeStatus: boolean;
         formChangeOriginData: Record<string, any>;
         formChangeNewData: Record<string, any>;
@@ -79,6 +28,7 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         annCellLocationList: Array<string>;
         annSelectId?: string | string[] | undefined;
         annRowDetails?: {
+            sheetId?: string | undefined;
             cellLocation: string;
             cellType: string;
             op: "ADD" | "DEL";
@@ -95,7 +45,7 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         mobileSelectTdId?: string | undefined;
         contentHighlight: Record<string, any>;
         productSearchFields: string;
-        __isPrintRender?: boolean | undefined;
+        renderPurpose?: "print" | "pdf" | undefined;
         showPrintFieldBg?: boolean | undefined;
         paramsConfig?: Record<string, any> | undefined;
         instanceStatus?: string | undefined;
@@ -104,16 +54,15 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         tid: string;
         uniqueId: string;
         modelKey: string;
-        formType: FormTypeEnum;
-        platformType: PlatformEnum;
+        formType: import('..').FormTypeEnum;
+        platformType: import('..').PlatformEnum;
         posType?: import('..').PosEnum | undefined;
-        renderModeType: RenderModeEnum;
-        btnRenderModeType: RenderModeEnum;
+        renderModeType: import('..').RenderModeEnum;
+        btnRenderModeType: import('..').RenderModeEnum;
         isMockReport: boolean;
         gct_stashData: boolean;
-        bpmnType?: BpmnNodeTypeEnum | undefined;
+        bpmnType?: import('..').BpmnNodeTypeEnum | undefined;
         bpmnFieldAuthMap?: Record<string, import('../types/common/base').IBpmnFieldAuthItem> | undefined;
-        eventInstance?: any;
         formChangeStatus: boolean;
         formChangeOriginData: Record<string, any>;
         formChangeNewData: Record<string, any>;
@@ -121,6 +70,7 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         annCellLocationList: Array<string>;
         annSelectId?: string | string[] | undefined;
         annRowDetails?: {
+            sheetId?: string | undefined;
             cellLocation: string;
             cellType: string;
             op: "ADD" | "DEL";
@@ -137,31 +87,51 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         mobileSelectTdId?: string | undefined;
         contentHighlight: Record<string, any>;
         productSearchFields: string;
-        __isPrintRender?: boolean | undefined;
+        renderPurpose?: "print" | "pdf" | undefined;
         showPrintFieldBg?: boolean | undefined;
         paramsConfig?: Record<string, any> | undefined;
         instanceStatus?: string | undefined;
     }[]>;
-    selfInfoList: import('vue').Ref<any, any>;
-    tmplBomCMap: import('vue').Ref<Record<string, FormTmplBomController>, Record<string, FormTmplBomController>>;
-    subTableCoreFactoryMap: import('vue').Ref<Record<string, SubTableCoreFactory>, Record<string, SubTableCoreFactory>>;
+    selfInfoList: import('vue').Ref<{
+        [x: string]: any;
+        formType: import('..').FormTypeEnum;
+        viewType: import('..').ViewTypeEnum;
+        modelKey: string;
+        bindKey?: string | undefined;
+    }[], ({
+        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;
+    }[]>;
     hasData: import('vue').ComputedRef<boolean>;
-    findFormInsInfo: (id: string) => any;
+    findFormInsInfo: (id: string) => {
+        [x: string]: any;
+        formType: import('..').FormTypeEnum;
+        viewType: import('..').ViewTypeEnum;
+        modelKey: string;
+        bindKey?: string | undefined;
+    } | undefined;
     findBasicInsInfo: (id: string) => {
         key: string;
         tid: string;
         uniqueId: string;
         modelKey: string;
-        formType: FormTypeEnum;
-        platformType: PlatformEnum;
+        formType: import('..').FormTypeEnum;
+        platformType: import('..').PlatformEnum;
         posType?: import('..').PosEnum | undefined;
-        renderModeType: RenderModeEnum;
-        btnRenderModeType: RenderModeEnum;
+        renderModeType: import('..').RenderModeEnum;
+        btnRenderModeType: import('..').RenderModeEnum;
         isMockReport: boolean;
         gct_stashData: boolean;
-        bpmnType?: BpmnNodeTypeEnum | undefined;
+        bpmnType?: import('..').BpmnNodeTypeEnum | undefined;
         bpmnFieldAuthMap?: Record<string, import('../types/common/base').IBpmnFieldAuthItem> | undefined;
-        eventInstance?: any;
         formChangeStatus: boolean;
         formChangeOriginData: Record<string, any>;
         formChangeNewData: Record<string, any>;
@@ -169,6 +139,7 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         annCellLocationList: Array<string>;
         annSelectId?: string | string[] | undefined;
         annRowDetails?: {
+            sheetId?: string | undefined;
             cellLocation: string;
             cellType: string;
             op: "ADD" | "DEL";
@@ -185,29 +156,22 @@ export declare function useRenderPageFactory(props: IProps, payload: IPayload):
         mobileSelectTdId?: string | undefined;
         contentHighlight: Record<string, any>;
         productSearchFields: string;
-        __isPrintRender?: boolean | undefined;
+        renderPurpose?: "print" | "pdf" | undefined;
         showPrintFieldBg?: boolean | undefined;
         paramsConfig?: Record<string, any> | undefined;
         instanceStatus?: string | undefined;
     } | undefined;
-    updatePageData: (uniqueId: string) => void;
-    updateRenderModeType: (uniqueId: string, newRenderModeType: RenderModeEnum, updateButton?: boolean) => void;
-    validate: (uniqueId: any) => Promise<{
-        /** 是否通过校验 */
-        isValid: boolean;
-        fields?: ValidateFieldErrorMap;
-    } | undefined>;
-    getFormState: (uniqueId: any) => Partial<{}>;
-    setFromEditStatus: (uniqueId: any) => Promise<boolean>;
-    setAnnotationViewStatus: (uniqueId: any, status: any, config?: string[] | {
+    updateRenderModeType: (uniqueId: string, mode: import('..').RenderModeEnum, updateButton?: boolean) => Promise<void>;
+    setFromEditStatus: (uniqueId: string) => Promise<boolean>;
+    setAnnotationViewStatus: (uniqueId: string, status: boolean, config?: string[] | {
         locations?: string[];
-        rowDetails?: FormChangeRowDetailMeta[];
+        rowDetails?: import('./annotation').FormChangeRowDetailMeta[];
     }) => boolean;
-    setFormChangeRowViewDetails: (uniqueId: string, rowDetails?: FormChangeRowDetailMeta[] | null, _historyId?: string | null) => boolean;
-    getAnnotationContentList: (uniqueId: any, options?: {}) => any[];
-    setValidatorViewStatus: (uniqueId: any, config: any) => boolean;
-    quickSearchRenderData: (uniqueId: any, currentSelfInfo: any) => Promise<void>;
-    getAppendixInfos: (uniqueId: any, currentSelfInfo: any, types?: any) => string[];
-    getPdfInfos: (uniqueId: any) => any;
+    setFormChangeRowViewDetails: (uniqueId: string, rowDetails?: import('./annotation').FormChangeRowDetailMeta[] | null) => Promise<boolean>;
+    navigateRuntimeLocation: (uniqueId: string, target: import('..').RuntimeNavigationTarget) => Promise<boolean>;
+    normalizeAnnotationLocation: (uniqueId: string, path: string, sheetId?: string) => string;
+    getAnnotationContentList: (uniqueId: string, options?: {}) => any[];
+    quickSearchRenderData: (uniqueId: string, currentSelfInfo: import('./render-page/types').RuntimeSelfInfo, saveToken?: import('..').RuntimeSaveToken) => Promise<boolean>;
+    getAppendixInfos: (uniqueId: string, types?: any[]) => string[];
+    getPdfInfos: (uniqueId: string) => any;
 };
-export {};

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

@@ -0,0 +1,44 @@
+import { RuntimeEditorFlusher } from '../runtime/runtime-instance-controller';
+type RuntimeInstanceIdSource = () => string | undefined;
+/**
+ * 组件获取实例配置、控制器和共享服务的统一入口，按需解构返回的 computed 引用。
+ * 默认从字段上下文取实例 ID；宿主或纸张组件可传入 ID getter，跟随 props 切换。
+ * 所有引用共享一次实例解析，服务仍由 Registry 创建和销毁，Hook 只负责读取。
+ */
+export declare function useRuntimeInstanceServices(uniqueIdSource?: RuntimeInstanceIdSource): {
+    instance: import('vue').ComputedRef<import('..').RuntimeInstanceRecord | undefined>;
+    /** 控制器负责 Sheet 切换、编辑器收口和提交；尚未挂载时为空。 */
+    controller: import('vue').ComputedRef<import('..').RuntimeInstanceController | undefined>;
+    /** 表单级配置独立于 Sheet 的 paper；实例未注册时提供空配置。 */
+    formConfig: import('vue').ComputedRef<Record<string, any>>;
+    /** 实例切换时重新取对应 Store；读取数据使用 .value.state，写入使用 Store 方法。 */
+    formStateStore: import('vue').ComputedRef<import('..').RuntimeFormStateStore | undefined>;
+    /**
+     * 实例级异步任务协调器：上传、扫码和远程回填通过 .value.run() 登记任务。
+     * 同 key 的新任务使旧结果失效；提交前等待 required 任务，所有 Sheet 共用同一份。
+     */
+    asyncTasks: import('vue').ComputedRef<import('..').RuntimeAsyncTaskCoordinator | undefined>;
+    /**
+     * 实例级联动调度器：监听 Store 变更，统一执行公式、赋值及条件必填/禁用规则。
+     * 组件通过 .value.getOutput() 读取条件结果，未挂载的 Sheet 也参与联动计算。
+     */
+    dependencies: import('vue').ComputedRef<import('..').RuntimeDependencyService | undefined>;
+    /**
+     * 实例级字段注册表：按模型 + 字段身份查询控件及其 Sheet、节点和数据路径。
+     * 供校验、联动、分页失效及导航定位使用；只维护位置索引，不保存填报数据或错误。
+     */
+    fields: import('vue').ComputedRef<import('..').RuntimeFieldRegistry | undefined>;
+    /** 分页与业务位置导航共用同一实例服务。 */
+    sheetService: import('vue').ComputedRef<import('..').RuntimeSheetService | undefined>;
+    /** 暂存与提交共享同一协调器，实例替换时整体切换。 */
+    persistence: import('vue').ComputedRef<import('..').RuntimePersistenceCoordinator | undefined>;
+    /** 校验规则及调度由当前实例持有，签名和失焦校验直接调用此服务。 */
+    validation: import('vue').ComputedRef<import('..').RuntimeValidationService | undefined>;
+    /** 实例共享的业务 BOM 控制器，打印副本持有独立展示控制器。 */
+    tmplBomController: import('vue').ComputedRef<import('./material-consume').FormTmplBomController | undefined>;
+    /** 当前实例的 UI 事件总线，批注等展示事件不会跨实例传播。 */
+    events: import('vue').ComputedRef<import('..').RuntimeInstanceEventBus | undefined>;
+};
+/** 注册需要在 Sheet 切换前提交内部状态的编辑器 */
+export declare function useRuntimeEditorFlusher(flusher: RuntimeEditorFlusher): void;
+export {};

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

@@ -0,0 +1,16 @@
+import { FormStateMutationSource } from '../runtime/runtime-form-state-store';
+/** 字段组件和业务辅助函数共用的显式行写入口，调用时必须声明修改来源。 */
+export interface RuntimeRowWriter {
+    setRowField(fieldKey: string, value: any, source: FormStateMutationSource): void;
+    patchRow(values: Record<string, any>, source: FormStateMutationSource): void;
+}
+/**
+ * 组件只读取 formData，写入通过此 Hook
+ * 每次调用都重新读取当前行和实例，避免动态表换行或草稿恢复后继续修改旧对象
+ */
+export declare function useRuntimeRowState(rowSource: () => Record<string, any>): {
+    setRowField: (fieldKey: string, value: any, source: FormStateMutationSource) => void;
+    patchRow: (values: Record<string, any>, source: FormStateMutationSource) => void;
+    getRowFieldPath: (fieldKey: string) => string;
+    markRowFieldUserModified: (fieldKey: string) => void;
+};

package/dist/src/nocode-base/src/hooks/validation/attach.d.ts

@@ -1,21 +1,15 @@
-import { FormRuleMeta } from './types';
-/** 规则上挂载的引用字段上下文 */
+import { FormRuleAttach } from './types';
+/** 公式校验器通过 rule 取得当前行，仅保留稳定行定位信息。 */
 export type AttachRuleContext = {
-    _belongFieldId?: string;
-    _optionValue?: any;
-    _multiple?: boolean;
     _subtableFieldId?: string;
-    _realRowIndex?: number;
-    _childSubTableDataIndex?: number;
+    _rowKey?: string;
 };
 /** 取规则对应的当前行 / 主表 formData */
 export declare function getCurrentFormData(_rule: AttachRuleContext, options: {
     formData?: any;
 }): any;
-/** 从 rule 或 meta.attach 解析上下文 */
-export declare function resolveAttachContext(rule: AttachRuleContext | undefined, metaAttach?: FormRuleMeta['attach']): AttachRuleContext | undefined;
 /** 引用字段是否处于激活选项下 */
-export declare function isAttachFieldActive(rule: AttachRuleContext | undefined, formData: Record<string, any> | undefined): boolean;
+export declare function isAttachFieldActive(attach: FormRuleAttach | null | undefined, formData: Record<string, any> | undefined): boolean;
 /** 当前行数据下引用字段是否应对用户呈现 */
 export declare function isReferenceOptionActive(referenceInfo: {
     belongFieldId?: string;

package/dist/src/nocode-base/src/hooks/validation/createValidateFactory.d.ts

@@ -5,6 +5,7 @@ type AssembleRulesInput = {
     fieldType?: string;
     validatorInfo: Record<string, any>;
     props: {
+        bizType?: string;
         minlength?: number | null;
         maxlength?: number | null;
         regex?: string;

package/dist/src/nocode-base/src/hooks/validation/runValidation.d.ts

@@ -1,17 +1,14 @@
-import { IPaper } from '../../types';
-import { ValidationRunMode, ValidateResult } from './types';
+import { ValidationRunMode, ValidateResult, FormRuleEntry } from './types';
 type RunValidationOptions = {
+    entries: ReadonlyMap<string, FormRuleEntry>;
     mode?: ValidationRunMode;
     /** 表单级 keepExceptionHighlight */
     keepExceptionHighlight?: boolean | null;
+    /** 可选的目标字段路径；未传时校验当前表单的全部已注册字段 */
+    paths?: Iterable<string>;
 };
 /**
  * 按 mode 过滤规则并执行 async-validator
  */
-export declare function runValidation(formData: Record<string, any>, paper: IPaper, options?: RunValidationOptions): Promise<ValidateResult | undefined>;
-/** 供 merge 使用：取某 path 当前值与规则 */
-export declare function resolvePayloadForPath(path: string, flatData: Record<string, any>): {
-    value: any;
-    rules: any[];
-} | null;
+export declare function runValidation(formData: Record<string, any>, options: RunValidationOptions): Promise<ValidateResult>;
 export {};

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

@@ -12,20 +12,22 @@ export type ValidateTrigger = 'change' | 'blur' | 'manual';
  * - display: 展示用（只读含必填；可编辑不含必填），不拦提交
  */
 export type ValidationRunMode = ValidateTrigger | 'all' | 'display';
+export interface FormRuleAttach {
+    belongFieldId: string;
+    optionValue: any;
+    multiple?: boolean;
+    subtableFieldId?: string;
+    rowKey?: string;
+    /** 嵌套引用条件从内层向外层串联，任一未激活就跳过当前字段。 */
+    parent?: FormRuleAttach;
+}
 export type FormRuleMeta = {
     /** 禁用 / 只读，不可编辑 */
     blocked: boolean;
     /** 字段级：是否在 display 时保留异常标红；未配置时跟随表单 */
     keepExceptionHighlight?: boolean;
     /** 布尔/枚举引用字段附着上下文（门禁用，不依赖 rule 对象上的挂载字段） */
-    attach?: {
-        belongFieldId: string;
-        optionValue: any;
-        multiple?: boolean;
-        subtableFieldId?: string;
-        realRowIndex?: number;
-        childSubTableDataIndex?: number;
-    } | null;
+    attach?: FormRuleAttach | null;
 };
 export type ValidateResult = {
     isValid: boolean;
@@ -42,3 +44,8 @@ export type ValidateResult = {
     flatData?: Record<string, any>;
 };
 export type ValidationCommentMap = Record<string, any[]> | null;
+/** 实例编译器原子发布的一条字段规则及门禁元数据。 */
+export interface FormRuleEntry {
+    rules: any[];
+    meta: FormRuleMeta;
+}

package/dist/src/nocode-base/src/hooks/validation/utils.d.ts

@@ -9,6 +9,12 @@ export declare const rangeCompareMessage: (op: RangeCompareOp, val: any) => stri
  */
 export declare const toUnixTimestamp: (input: any) => number | null;
 export declare const buildError: (validatorInfo: any, message: string) => string;
+/**
+ * 比较错误内容时显式包含 message：async-validator 的公式规则可能返回原生 Error，
+ * 其 message 不可枚举，直接 JSON.stringify 会漏掉变化后的上下限文案。
+ * 普通字段和业务校验共用此比较，保留字段及其他错误信息原有的变化判断。
+ */
+export declare function areValidationCommentsEqual(left: any[] | undefined, right: any[] | undefined): boolean;
 export declare const createRule: (validator: Function, message: string, trigger?: ValidateTrigger) => {
     required: boolean;
     validator: Function;

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

@@ -5,3 +5,5 @@ export * from './components';
 export * from './interface';
 export * from './emit';
 export * from './core';
+export { ensureFrontRowKey, ensureTableRowKeys } from './_utils_/uuid';
+export * from './runtime';

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

@@ -33,5 +33,5 @@ export declare const calcUtils: {
     pageListRecursion: (realDealWithList: Array<IDealWithItem | IDealWithItem[]>, maxHeight: number) => IPageItem[];
     /** 获取分页数据列表 */
     getPageData: (pageList: any, baseMarketObj: any) => IPageData[];
-    initCalc: (runtimeJson: any, formState: any) => IPageData[];
+    initCalc: (runtimeJson: any, formState: any) => any;
 };