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

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

@@ -0,0 +1,296 @@
+import { RuntimeFieldInitializer } from './runtime-field-initializer';
+import { RuntimeValidationService } from './runtime-validation-service';
+import { RuntimeInstanceContext } from './runtime-context';
+import { RuntimeInstanceController } from './runtime-instance-controller';
+import { RuntimeRuleCompiler } from './runtime-rule-compiler';
+import { RuntimeFormStateStore } from './runtime-form-state-store';
+import { CodeRunner } from '../interface/code-runner';
+import { RuntimeAsyncTaskCoordinator } from './async-task-coordinator';
+import { RuntimeDependencyService } from './runtime-dependency-service';
+import { RuntimeFieldRegistry, RuntimeFieldMetadata } from './runtime-field-registry';
+import { RuntimeSheetService } from './runtime-sheet-service';
+import { RuntimePersistenceCoordinator } from './runtime-persistence-coordinator';
+import { RuntimeInstanceEventBus } from './runtime-instance-event-bus';
+export interface RuntimeInstanceRecord {
+    /** 实例配置、业务索引和各 Sheet 的响应式状态；数据只由下方 Store 持有 */
+    context: RuntimeInstanceContext;
+    /** 负责切换 Sheet、收口编辑器和发起原子提交；上下文注册后再挂载 */
+    controller?: RuntimeInstanceController;
+    /**
+     * 【库内接入】正式填报宿主提供模式/权限信息后挂载 RuntimeRuleCompiler，常规工厂已接通。
+     * 编译全部 Sheet 的联动与校验规则；校验前通过 prepareValidation 准备，由本注册表负责销毁。
+     */
+    ruleCompiler?: RuntimeRuleCompiler;
+    /** 业务默认值随实例及动态行初始化，不依赖控件挂载。 */
+    fieldInitializer?: RuntimeFieldInitializer;
+    /** 实例唯一的数据写入口，生成 revision、dirty 和字段变更路径 */
+    formState: RuntimeFormStateStore;
+    /** 整份表单共享的脚本执行器，字段通过运行时记录调用，销毁由注册表负责。 */
+    scriptRunner?: CodeRunner;
+    /** 跟踪上传、扫码、远程回填等任务，提交前等待必要任务完成 */
+    asyncTasks: RuntimeAsyncTaskCoordinator;
+    /** 与组件挂载无关的实例级公式、赋值和条件属性调度器 */
+    dependencies: RuntimeDependencyService;
+    /** 汇总全部 Sheet 的字段位置，供校验、分页失效和导航查询 */
+    fields: RuntimeFieldRegistry;
+    /** 统一管理各 Sheet 的分页失效、重新分页及错误/批注定位。 */
+    sheetService: RuntimeSheetService;
+    /** 暂存响应版本保护、稳定提交快照及销毁保护统一由这一实例服务管理。 */
+    persistence: RuntimePersistenceCoordinator;
+    /** 只在当前实例内分发批注等 UI 事件 */
+    events: RuntimeInstanceEventBus;
+    /** 当前实例独占规则、校验任务和错误合并。 */
+    validation: RuntimeValidationService;
+}
+export interface RegisterRuntimeInstanceOptions {
+    /** 初始化脚本、子表和字段组件共同使用的唯一数据 Store。 */
+    formStateStore: RuntimeFormStateStore;
+    /**
+     * 【库内接入】独立注册实例时传入字段扫描结果的 fieldMetadata；常规工厂已接通。
+     * 包含真实控件引用、组合子字段和 value_ 位置，Registry 不再回头扫描节点。
+     */
+    fieldMetadata: RuntimeFieldMetadata;
+    /** 打印副本恢复当前条件输出，不携带规则执行器、脚本或正在运行的任务。 */
+    dependencyOutputs?: Readonly<Record<string, unknown>>;
+    /** 初始化阶段创建并绑定同一 Store 的脚本执行器；无脚本时为空。 */
+    scriptRunner?: CodeRunner;
+}
+/**
+ * 渲染宿主的实例注册表，多 Sheet 运行端的唯一实例入口
+ *
+ * 每个 `uniqueId` 对应一份 `RuntimeInstanceRecord`
+ * 一条记录中包含：
+ * - 整份表单共享的 formState、表单配置和业务索引
+ * - 每个 Sheet 独立的 dataCenter、分页和滚动状态
+ * - 联动、校验、保存、提交、导航等实例级服务
+ *
+ */
+export declare class RuntimeInstanceRegistry {
+    /** 当前渲染入口的加载状态，由工厂更新；PreviewContainer 直接读取，无需宿主额外传参。 */
+    readonly loadState: import('vue').ShallowReactive<{
+        loading: boolean;
+        error: Error | undefined;
+    }>;
+    /**
+     * 顶层对象使用浅响应式：实例新增、删除需要驱动 Vue 更新；record 内的服务类
+     * 不需要被 Vue 深度代理，各自内部负责自己的响应式状态和生命周期
+     */
+    private readonly records;
+    /**
+     * 统一托管订阅、watch 和编译结果的取消函数
+     * 删除实例时先执行这些函数，避免已销毁实例继续响应数据或事件
+     */
+    private readonly disposables;
+    /**
+     * 注册一个已经完成 v1/v2 归一化和业务初始化的表单实例
+     *
+     * 此方法只创建实例级基础设施，不负责请求模板和业务数据。相同 uniqueId
+     * 再次注册时会先完整销毁旧记录，确保不会残留订阅或异步任务
+     */
+    register(context: RuntimeInstanceContext, options: RegisterRuntimeInstanceOptions): RuntimeInstanceRecord;
+    /**
+     * 在页面回调准备完成后挂载实例控制器
+     * Sheet 服务的导航入口依赖控制器切换 Sheet，所以两者必须在这里建立连接
+     */
+    attachController(uniqueId: string, controller: RuntimeInstanceController): RuntimeInstanceController;
+    /** 可选查询：实例尚未完成注册或已卸载时返回 undefined，供页面生命周期读取 */
+    get(uniqueId: string): RuntimeInstanceRecord | undefined;
+    /** 强制查询：核心业务链路缺少实例时立即报错，避免继续产生不完整状态 */
+    require(uniqueId: string): RuntimeInstanceRecord;
+    /** 返回当前宿主已注册的全部实例记录 */
+    values(): RuntimeInstanceRecord[];
+    /** 实例列表只取概要，控制台列举实例时不复制整份填报数据和节点。 */
+    getDebugSummaries(): {
+        uniqueId: string;
+        instanceId: string;
+        templateId: string;
+        schemaVersion: 2 | 1;
+        activeSheetId: string;
+        sheetCount: number;
+        revision: number;
+        dirty: boolean;
+        taskCount: number;
+    }[];
+    /**
+     * 取得查看时刻的调试快照，不暴露 Store 或服务实例的可写引用。
+     * 不执行联动、分页或提交；省略 ID 仅在当前注册表恰好有一份实例时生效。
+     */
+    getDebugSnapshot(uniqueId?: string): {
+        capturedAt: string;
+        uniqueId: string;
+        instanceId: string;
+        templateId: string;
+        schemaVersion: 2 | 1;
+        activeSheetId: string;
+        revision: number;
+        dirty: boolean;
+        controllerAttached: boolean;
+        ruleCompilerAttached: boolean;
+        scriptRunnerAttached: boolean;
+        formState: Record<string, any>;
+        formConfig: Record<string, any>;
+        defaultData: Record<string, any>;
+        businessIndex: import('./runtime-context').RuntimeBusinessIndex;
+        fieldRegistry: {
+            fields: Array<import('./runtime-context').RuntimeFieldLocation & {
+                widget?: import("..").BaseCoreComponent.BasicSchema;
+            }>;
+            widgets: import('./runtime-field-registry').RuntimeWidgetMetadata[];
+            fieldCount: number;
+            businessFieldCount: number;
+            widgetCount: number;
+            compiledWidgetCount: number;
+        };
+        sheets: {
+            sheetId: string;
+            title: string;
+            status: import('./runtime-context').RuntimeSheetStatus;
+            errorMessage: string | undefined;
+            pageCount: number;
+            nodeCount: number;
+            scrollTop: number;
+            paginationDirty: boolean;
+            paginationRevision: number;
+            paginationError: string | undefined;
+            paper: any;
+        }[];
+        asyncTasks: import('./async-task-coordinator').RuntimeAsyncTaskSnapshot[];
+        dependencies: {
+            scheduled: boolean;
+            pendingChangeCount: number;
+            runningRuleIds: string[];
+            rules: {
+                id: string;
+                targetField?: import('./runtime-dependency-service').RuntimeDependencyFieldReference;
+                sheetId?: string;
+                sourceFields?: import('./runtime-dependency-service').RuntimeDependencyFieldReference[];
+                structureFields?: string[];
+            }[];
+            outputs: Record<string, unknown>;
+        };
+        validation: {
+            ruleCount: number;
+            livePending: boolean;
+            displayPending: boolean;
+            bound: boolean;
+        };
+    };
+    /** 详细节点和分页按需复制，避免列举十个 Sheet 时就复制全部模板节点。 */
+    getSheetDebugSnapshot(sheetId?: string, uniqueId?: string): import('./runtime-context').RuntimeSheetContext;
+    /** 字段专项查询直接读取真实注册表，包含业务索引中没有的内部字段和引用位置。 */
+    getFieldDebugSnapshot(uniqueId?: string): {
+        fields: Array<import('./runtime-context').RuntimeFieldLocation & {
+            widget?: import("..").BaseCoreComponent.BasicSchema;
+        }>;
+        widgets: import('./runtime-field-registry').RuntimeWidgetMetadata[];
+        fieldCount: number;
+        businessFieldCount: number;
+        widgetCount: number;
+        compiledWidgetCount: number;
+    };
+    /** 分组打印一份快照并返回它；后续输入不会改变已经展开的日志内容。 */
+    debug(uniqueId?: string): {
+        capturedAt: string;
+        uniqueId: string;
+        instanceId: string;
+        templateId: string;
+        schemaVersion: 2 | 1;
+        activeSheetId: string;
+        revision: number;
+        dirty: boolean;
+        controllerAttached: boolean;
+        ruleCompilerAttached: boolean;
+        scriptRunnerAttached: boolean;
+        formState: Record<string, any>;
+        formConfig: Record<string, any>;
+        defaultData: Record<string, any>;
+        businessIndex: import('./runtime-context').RuntimeBusinessIndex;
+        fieldRegistry: {
+            fields: Array<import('./runtime-context').RuntimeFieldLocation & {
+                widget?: import("..").BaseCoreComponent.BasicSchema;
+            }>;
+            widgets: import('./runtime-field-registry').RuntimeWidgetMetadata[];
+            fieldCount: number;
+            businessFieldCount: number;
+            widgetCount: number;
+            compiledWidgetCount: number;
+        };
+        sheets: {
+            sheetId: string;
+            title: string;
+            status: import('./runtime-context').RuntimeSheetStatus;
+            errorMessage: string | undefined;
+            pageCount: number;
+            nodeCount: number;
+            scrollTop: number;
+            paginationDirty: boolean;
+            paginationRevision: number;
+            paginationError: string | undefined;
+            paper: any;
+        }[];
+        asyncTasks: import('./async-task-coordinator').RuntimeAsyncTaskSnapshot[];
+        dependencies: {
+            scheduled: boolean;
+            pendingChangeCount: number;
+            runningRuleIds: string[];
+            rules: {
+                id: string;
+                targetField?: import('./runtime-dependency-service').RuntimeDependencyFieldReference;
+                sheetId?: string;
+                sourceFields?: import('./runtime-dependency-service').RuntimeDependencyFieldReference[];
+                structureFields?: string[];
+            }[];
+            outputs: Record<string, unknown>;
+        };
+        validation: {
+            ruleCount: number;
+            livePending: boolean;
+            displayPending: boolean;
+            bound: boolean;
+        };
+    };
+    /**
+     * 默认只预览提交前数据，不校验；显式 validate=true 才执行正式提交准备与错误导航。
+     * 两种模式都收口编辑器、等待异步任务并刷新分页，不发送保存或提交请求。
+     * 返回值深拷贝，并用 validated 区分模式，未校验的预览不标记 isValid=true。
+     */
+    debugSubmitData(uniqueId?: string, validate?: boolean): Promise<{
+        isValid: false;
+        revision: number;
+        validation: import('./runtime-persistence-coordinator').RuntimeSubmissionValidationResult;
+        validated: true;
+        uniqueId: string;
+        capturedAt: string;
+    } | {
+        isValid: true;
+        validation: import('./runtime-persistence-coordinator').RuntimeSubmissionValidationResult;
+        revision: number;
+        formState: Readonly<Record<string, any>>;
+        payload: Record<string, any>;
+        validated: true;
+        uniqueId: string;
+        capturedAt: string;
+    } | {
+        revision: number;
+        formState: Readonly<Record<string, any>>;
+        payload: Record<string, any>;
+        validated: false;
+        uniqueId: string;
+        capturedAt: string;
+    }>;
+    private requireDebugRecord;
+    /**
+     * 登记随实例销毁的清理函数，例如 Store 订阅、规则编译结果和 watch
+     * 返回值只撤销本次登记，便于调用方提前停止订阅
+     */
+    registerDisposable(uniqueId: string, dispose: () => void): () => boolean;
+    /**
+     * 销毁单个实例以及它拥有的全部服务
+     * Sheet 切换不会调用这里；只有实例刷新、替换或宿主卸载才会销毁
+     */
+    delete(uniqueId: string): void;
+    /**
+     * useRenderPageFactory 和打印副本容器在卸载时调用，关闭全部脚本、订阅和异步任务。
+     */
+    clear(): void;
+}

package/dist/src/nocode-base/src/runtime/runtime-persistence-coordinator.d.ts

@@ -0,0 +1,93 @@
+import { RuntimeAsyncTaskCoordinator } from './async-task-coordinator';
+import { RuntimeFormStateStore } from './runtime-form-state-store';
+import { RuntimeSheetService } from './runtime-sheet-service';
+/** 保存令牌可随宿主请求传递；实例重新注册后，旧令牌不能用于新实例。 */
+export interface RuntimeSaveToken {
+    readonly coordinatorId: string;
+    readonly sequence: number;
+    readonly revision: number;
+}
+export interface RuntimeSubmissionValidationResult {
+    isValid: boolean;
+    fields?: Record<string, any[]>;
+    [key: string]: any;
+}
+/** 转换前后共用同一 revision 的数据快照；此结构本身不表示已通过校验。 */
+export interface RuntimeSubmissionDataSnapshot<TPayload = Record<string, any>> {
+    revision: number;
+    /** 脱离 Vue 响应式对象的稳定数据快照。 */
+    formState: Readonly<Record<string, any>>;
+    payload: TPayload;
+}
+export interface RuntimeSubmissionSnapshot<TPayload = Record<string, any>> extends RuntimeSubmissionDataSnapshot<TPayload> {
+    isValid: true;
+    validation: RuntimeSubmissionValidationResult;
+}
+/** 校验失败也返回本轮结果，宿主不能从失败分支读取业务 payload。 */
+export interface RuntimeSubmissionFailure {
+    isValid: false;
+    revision: number;
+    validation: RuntimeSubmissionValidationResult;
+}
+export type RuntimeSubmissionResult<TPayload = Record<string, any>> = RuntimeSubmissionSnapshot<TPayload> | RuntimeSubmissionFailure;
+export interface PrepareRuntimeSubmissionOptions<TPayload> {
+    flushEditors: () => void | Promise<void>;
+    validate: () => RuntimeSubmissionValidationResult | undefined | Promise<RuntimeSubmissionValidationResult | undefined>;
+    transform: (formState: Record<string, any>) => TPayload;
+}
+/**
+ * 实例唯一的持久化协调器，统一拥有暂存版本保护和提交准备的生命周期。
+ *
+ * 暂存只记录请求序号/revision，不运行提交校验；提交等待编辑器、必要异步任务和分页，
+ * 再对同一数据版本校验、转换。服务不发送网络请求，实际保存和提交由宿主接入。
+ * Registry 每次注册创建新协调器，销毁后旧请求不能清除脏标记或生成提交快照。
+ */
+export declare class RuntimePersistenceCoordinator {
+    private readonly formState;
+    private readonly asyncTasks;
+    private readonly sheets;
+    /** 区分同 uniqueId 的不同注册生命周期；可序列化令牌不依赖对象引用。 */
+    private readonly coordinatorId;
+    /** 当前实例最后发起的保存序号；不再重复维护 started/completed 两套计数。 */
+    private saveSequence;
+    /** 同一实例的业务写请求串行发送，避免较早的暂存最后落库覆盖较新的提交。 */
+    private saveTail;
+    private preparingSubmission?;
+    private disposed;
+    constructor(formState: RuntimeFormStateStore, asyncTasks: RuntimeAsyncTaskCoordinator, sheets: RuntimeSheetService);
+    /** 导航等异步 UI 工作结束后，Controller 再确认返回快照仍属于当前数据版本。 */
+    isCurrentRevision(revision: number): boolean;
+    /** 【宿主接入·已接通】业务按钮用快照 revision 创建令牌，交给 runSave 串行发送。 */
+    beginSave(expectedRevision?: number): RuntimeSaveToken;
+    /** 只有同一注册生命周期中最后发起、且数据版本未变化的响应才有效。 */
+    isLatestSave(token: RuntimeSaveToken): boolean;
+    /** runSave 和保存后回填共同使用；false 表示过期，不能回填或更新保存基准。 */
+    completeSave(token: RuntimeSaveToken): boolean;
+    /**
+     * 宿主提供实际请求；队列开始及响应回来均检查令牌。失败不确认保存，且不阻塞下一次重试。
+     * dhr-kit 的按钮、暂存及自动保存统一使用此入口，服务不拼装业务 API 参数。
+     */
+    runSave(token: RuntimeSaveToken, send: () => Promise<unknown>): Promise<boolean>;
+    /**
+     * 提交事务：编辑器收口、异步任务、分页、校验和业务转换必须消费同一 revision。
+     * 校验期间数据继续变化时整轮重做，调用方不会再拿到“校验旧数据、提交新数据”的结果。
+     */
+    prepareSubmission<TPayload>(options: PrepareRuntimeSubmissionOptions<TPayload>): Promise<RuntimeSubmissionResult<TPayload>>;
+    /**
+     * 仅预览转换后的数据，不校验、不导航、不写入正式提交缓存。
+     * 编辑器、异步任务及分页仍先收敛，转换逻辑与正式提交共用同一个快照生成方法。
+     */
+    prepareDataSnapshot<TPayload>(options: Pick<PrepareRuntimeSubmissionOptions<TPayload>, 'flushEditors' | 'transform'>): Promise<RuntimeSubmissionDataSnapshot<TPayload>>;
+    /**
+     * 打印与调试共用的稳定读取事务：收口输入、等待任务及全部 Sheet 分页，
+     * 再同步捕获数据和版式。不会校验、保存或写入正式提交缓存。
+     */
+    prepareReadSnapshot<T>(flushEditors: () => void | Promise<void>, capture: (formState: Record<string, any>, revision: number) => T): Promise<T>;
+    private prepareSubmissionUntilStable;
+    /** 预览和正式提交使用同一转换入口，转换期间数据变化则丢弃本轮结果。 */
+    private createDataSnapshot;
+    private prepareUntilStable;
+    /** 同时关闭暂存确认和提交准备；已发送的业务请求仍由宿主处理。 */
+    dispose(): void;
+    private assertAlive;
+}

package/dist/src/nocode-base/src/runtime/runtime-rule-compiler.d.ts

@@ -0,0 +1,37 @@
+import { IBasicInfoItem } from '../types';
+import { RuntimeInstanceRecord } from './runtime-instance-registry';
+export type RuntimeRuleBasicInfo = Pick<IBasicInfoItem, 'renderModeType' | 'modelKey' | 'formType' | 'bpmnType' | 'bpmnFieldAuthMap'> & Partial<Pick<IBasicInfoItem, 'annSwitchStatus'>> & Partial<Pick<IBasicInfoItem, 'formChangeStatus' | 'formChangeOriginData' | 'formChangeNewData'>>;
+/**
+ * 一个表单实例共用一个规则编译器，覆盖所有 Sheet，包括尚未打开的页面。
+ * - 静态联动配置只注册一次，执行交给 RuntimeDependencyService。
+ * - 校验规则随行/列结构、条件结果和渲染模式刷新，验证执行仍由校验模块负责。
+ * - 从 RuntimeFieldRegistry 读取元数据，不扫描 dataCenter；切换 Sheet 无需重新编译。
+ * - 它是规则唯一生产者，组件只显示样式；整份规则完成后原子发布。
+ * 由 RuntimeInstanceRecord 持有，实例销毁时统一清理订阅、effect 和实例规则。
+ */
+export declare class RuntimeRuleCompiler {
+    private readonly record;
+    private basicInfo;
+    private readonly unregisters;
+    private validationScheduled;
+    private disposed;
+    private renderModeType;
+    constructor(record: RuntimeInstanceRecord, basicInfo: RuntimeRuleBasicInfo);
+    /** 查看/编辑模式或权限配置变化时即时刷新，不重复注册联动 effect。 */
+    refreshValidation(basicInfo?: RuntimeRuleBasicInfo): void;
+    /** 校验执行前的明确准备入口，等待联动完成后同步生成当前规则，替代挂载数量轮询。 */
+    prepareValidation(): Promise<void>;
+    /** 实例销毁时删除全部规则，组件生命周期不再参与规则清理。 */
+    dispose(): void;
+    /** 同一微任务内的结构和条件变化只生成一次规则；销毁后排队任务直接结束。 */
+    private scheduleValidation;
+    private getStructureSignature;
+    /** 只记录会改变规则的行身份与业务状态；普通输入值不会造成全量重编译。 */
+    private getValidationSignature;
+    /** 注册条件属性和赋值规则；异步计算结束后检查编译器是否已随实例销毁。 */
+    private compileWidgetDependencies;
+    private canWriteFormulas;
+    private getWritableRow;
+    /** 公式变更记录也属于实例生命周期，未打开的 Sheet 不再漏记。 */
+    private recordFormulaChange;
+}

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

@@ -0,0 +1,99 @@
+import { RuntimeFieldRegistry } from './runtime-field-registry';
+import { RuntimeInstanceContext } from './runtime-context';
+import { RuntimeInstanceController } from './runtime-instance-controller';
+import { RuntimeFormStateStore } from './runtime-form-state-store';
+import { IPageData } from '../types';
+import { RuntimeNodeMap } from './multi-sheet-runtime';
+export interface RuntimeNavigationTarget {
+    sheetId?: string;
+    nodeId?: string;
+    widgetId?: string;
+    rowKey?: string;
+    fieldId?: string;
+    subFieldKey?: string;
+    modelKey?: string;
+    subModelKey?: string;
+    validationPath?: string;
+    annotationLocation?: string;
+}
+export interface ResolvedRuntimeNavigationTarget extends RuntimeNavigationTarget {
+    sheetId: string;
+}
+export interface RuntimeNavigationHost {
+    reveal(target: ResolvedRuntimeNavigationTarget): void | Promise<void>;
+}
+/** 宿主提供渲染位置，服务按业务字段、模型及稳定行键进行精确匹配。 */
+export interface RuntimeRenderedFieldLocation {
+    sheetId?: string;
+    nodeId?: string;
+    widgetId?: string;
+    fieldId?: string;
+    subFieldKey?: string;
+    rowKey?: string;
+    modelKey?: string;
+    subModelKey?: string;
+}
+/**
+ * 每份实例唯一的 Sheet 展示服务：订阅数据变更、标记分页失效、重新分页和定位控件。
+ *
+ * 分页状态只保存在 context.sheets，不再额外维护一份 dirty Set。
+ * Controller 负责编辑器收口和切换竞态；本服务负责分页版本检查与业务坐标解析。
+ * DOM 滚动、聚焦由宿主通过 bindHost 接入，实例销毁时统一停止订阅并解除绑定。
+ */
+export declare class RuntimeSheetService {
+    private readonly context;
+    private readonly fields;
+    /** 分页及行定位读取实例唯一的 Store，避免上下文另挂一份数据入口。 */
+    private readonly formState;
+    /**
+     * 运行时内部的分页算法入口，初始化与后续重新分页均调用此方法。
+     * 只接收目标 Sheet 节点和实例共享数据，业务宿主无需注入或配置算法。
+     */
+    static calculatePages(dataCenter: RuntimeNodeMap, formState: Record<string, any>): IPageData[];
+    private controller?;
+    private host?;
+    private disposed;
+    /** 同一轮用户输入、公式和行增删只排一次当前 Sheet 分页；未打开页面保持懒计算。 */
+    private paginationTimer?;
+    private calculatingDepth;
+    private automaticPaginationRunning;
+    /** 分页算法自身改写数据时允许有限次数重算，避免错误算法持续占用事件循环。 */
+    private automaticPaginationRounds;
+    private readonly unsubscribe;
+    constructor(context: RuntimeInstanceContext, fields: RuntimeFieldRegistry, 
+    /** 分页及行定位读取实例唯一的 Store，避免上下文另挂一份数据入口。 */
+    formState: RuntimeFormStateStore);
+    /** 当前 Sheet 自动合并重算；其他 Sheet 保持失效标记，在切换或提交时消费。 */
+    markDirty(sheetId: string): void;
+    markAllDirty(): void;
+    isDirty(sheetId: string): boolean;
+    /** 按模板顺序返回失效 Sheet，保证批量分页顺序稳定。 */
+    listDirtySheetIds(): string[];
+    /** 分页异常或计算期间 Store 被修改时保留失效标记，下一轮使用最新数据重算。 */
+    recalculateSheet(sheetId?: string): IPageData[];
+    /**
+     * 分页只由实例服务调度，不依赖子表组件挂载或宿主 provide 回调。
+     * 使用下一轮任务合并本轮同步写入和公式微任务；执行时重新读取活动 Sheet，防止旧任务刷新错页。
+     */
+    private scheduleActivePagination;
+    /** 提交事务消费本轮失效 Sheet；分页引发新修改时由事务再进入下一轮。 */
+    flush(): Promise<void>;
+    private handleChange;
+    bindController(controller: RuntimeInstanceController): void;
+    /**
+     * 【库内接入】PreviewContainer 已绑定 DOM 定位；自行实现渲染容器的宿主需绑定
+     * reveal，并在卸载时调用返回的解除函数。服务准备布局和位置，不直接操作宿主 DOM。
+     */
+    bindHost(host: RuntimeNavigationHost): () => void;
+    /** 全量校验按 Sheet 创建顺序定位首个可解析错误；子表行和二维列继续按稳定身份解析。 */
+    navigateFirstError(paths: string[]): Promise<boolean>;
+    navigate(target: RuntimeNavigationTarget): Promise<boolean>;
+    resolve(target: RuntimeNavigationTarget): ResolvedRuntimeNavigationTarget | undefined;
+    /**
+     * 【库内接入】自定义容器可复用此方法匹配真实控件，避免自行忽略子表行或二维列。
+     * 固定表展开后 widgetId 可能变化，模型 + 业务字段 + 行键才是数据位置。
+     */
+    matchesRenderedTarget(target: ResolvedRuntimeNavigationTarget, location: RuntimeRenderedFieldLocation): boolean;
+    dispose(): void;
+    private assertAlive;
+}

package/dist/src/nocode-base/src/runtime/runtime-validation-service.d.ts

@@ -0,0 +1,44 @@
+import { RuntimeFormStateStore } from './runtime-form-state-store';
+import { PlatformEnum } from '../constant';
+import { FormRuleEntry, ValidationRunMode, ValidationCommentMap, ValidateResult } from '../hooks/validation/types';
+export interface RuntimeValidationBinding {
+    platformType?: PlatformEnum;
+    prepareRules(): void | Promise<void>;
+    getKeepExceptionHighlight?(): boolean | null | undefined;
+    applyComments(comments: ValidationCommentMap): void;
+    getComments(): ValidationCommentMap;
+}
+export declare class RuntimeValidationService {
+    private readonly store;
+    private entries;
+    private binding?;
+    private disposed;
+    private generation;
+    private liveTimer?;
+    private displayTimer?;
+    private pendingLive?;
+    private liveRunning;
+    constructor(store: RuntimeFormStateStore);
+    /** 工厂连接模式/权限和错误展示；此绑定只属于当前服务实例，不按业务 ID 全局注册。 */
+    bind(binding: RuntimeValidationBinding): void;
+    /** 编译成功才原子替换规则；子表行删除后同步清理失效的错误位置。 */
+    replaceRules(entries: Map<string, FormRuleEntry>): void;
+    listRuleKeys(): string[];
+    /** 调试及规则核对使用只读描述；规则函数仍由服务持有。 */
+    getDebugSnapshot(): {
+        ruleCount: number;
+        livePending: boolean;
+        displayPending: boolean;
+        bound: boolean;
+    };
+    validate(mode?: ValidationRunMode, paths?: Iterable<string>): Promise<ValidateResult | undefined>;
+    /** 只有失焦由组件触发；change 由 Store 订阅触发，同轮请求合并，运行中再输入也会补跑。 */
+    requestLive(trigger?: 'change' | 'blur', immediate?: boolean): void;
+    private flushLive;
+    requestDisplay(immediate?: boolean): void;
+    pruneComments(): void;
+    settleAfterModeSwitch(runChangeLive?: boolean): Promise<void>;
+    private cancelScheduled;
+    dispose(): void;
+    private assertAlive;
+}

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

@@ -0,0 +1,23 @@
+/** 二维子行与关联列行的运行时关系；提交前剥离，后端仍保存原 rowRefFieldKey。 */
+export declare const RUNTIME_COLUMN_ROW_KEY = "_column_row_key_";
+export interface RuntimeTableRelation {
+    rowSubFieldKey: string;
+    colSubFieldKey?: string;
+    rowRefFieldKey?: string;
+    colRefFieldKey?: string;
+    crossFieldKeys?: string[];
+}
+/** 查找普通/固定业务行或二维子行，禁止按下标回退；删除行不参与当前填报。 */
+export declare function findRuntimeTableRow(rows: any, rowKey: string | undefined): Record<string, any> | undefined;
+/** 由子行键查所属外层行，检验项类型、行级签名及变更基准均复用此查询。 */
+export declare function findRuntimeParentRow(rows: any, rowKey: string | undefined): Record<string, any> | undefined;
+/** 根据关联列行的稳定键取二维单元格，列或子行重排都不会改变绑定关系。 */
+export declare function findRuntimeTableCell(parent: any, columnRowKey: string | undefined): any;
+/** 模板坐标只选择当前展示的列行，取业务单元格则按列行键匹配，不能按子数组下标配对。 */
+export declare function getRenderedRuntimeTableCell(state: Record<string, any>, info: RuntimeTableRelation | undefined, parent: any, displayColumn: number): any;
+/**
+ * 初始化边界建立二维关联：已有关系直接保留；已保存记录按业务引用值匹配列行。
+ * 新建的空单元格按模板创建顺序与列行建立一次关系，之后只按列行键查询。
+ * 这是把模板版式转成行身份的唯一边界，运行时重排和提交不再按数组位置配对。
+ */
+export declare function bindRuntimeTableColumns(state: Record<string, any>, relations: readonly RuntimeTableRelation[]): string[];

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

@@ -11,7 +11,14 @@ export interface IBusinessScanConfig {
     disableBarcodeParsing?: boolean;
     scanParamType?: ScanParamType;
 }
-export type IBizTableConfig = IStocktakeConfig | ISterilizeBatchConfig | IPretreatmentListConfig | IBusinessScanConfig;
+/** 设备点检/保养固定表配置 */
+export interface IFixedDeviceOperationConfig {
+    /** 已拖入表单的主表绑定字段 key */
+    mainFieldBindings?: string[];
+    /** 签名后触发数据锁定的子表内置字段 key */
+    dataLockControlField?: 'inspector_' | 'reviewer_';
+}
+export type IBizTableConfig = IStocktakeConfig | ISterilizeBatchConfig | IPretreatmentListConfig | IBusinessScanConfig | IFixedDeviceOperationConfig;
 export * from './allocate';
 export * from './sterilize-batch';
 export * from './pretreatment-list';

package/dist/src/nocode-base/src/types/calc/i-calc.d.ts

@@ -114,6 +114,9 @@ export interface IPageItem {
     dynHeights: Map<string, number | number[]>;
 }
 export interface IPageData {
+    /** 浮动字段使用的稳定 sheet/页定位 */
+    sheetId?: string;
+    pageIndex?: number;
     /** 唯一key */
     uuid: string;
     /** 当前页内容trId集合 */