@gct-paas/word 0.2.5-beta.0 → 0.2.5-beta.3

package/dist/assets/svgs/table/index.d.ts

@@ -24,6 +24,7 @@ export declare const TABLE_BUSINESS_SVG: {
     readonly 'material-consume': string;
     readonly 'material-balance': string;
     readonly 'material-requisition': string;
+    readonly 'material-substitution': string;
     readonly 'check-table': string;
     readonly 'pretreatment-list': string;
     readonly 'entrust-steril-batch-list': string;

package/dist/base/modal/src/modal.type.d.ts

@@ -5,7 +5,7 @@ export interface IModalInstance {
     setLoading: (v: boolean) => void;
 }
 export interface IModalContext extends IModalInstance {
-    setOnConfirm: (fn: any) => void;
+    setOnConfirm: (fn: (ins: IModalInstance) => Promise<void> | void) => void;
 }
 export interface IModalOptions {
     title?: string;
@@ -13,6 +13,8 @@ export interface IModalOptions {
     bodyProps?: any;
     width?: number;
     height?: number;
+    /** 弹框最大高度，数字按 px，字符串可传 90vh 等 CSS 值。 */
+    maxHeight?: number | string;
     zIndex?: number;
     className?: string;
     closable?: boolean;

package/dist/base/utils/image-size-util.d.ts

@@ -35,10 +35,10 @@ export declare function computeContainLayout(natural: ImageSize, box: ImageSize)
  */
 export declare function computeContainDisplaySize(natural: ImageSize, box: ImageSize): ImageSize;
 /** 同步取无图签名缓存（布局重建时可避免先闪占位再异步补图） */
-export declare function getCachedSignatureImage(name: string, width?: number, height?: number, time?: number | string): HTMLImageElement | null;
+export declare function getCachedSignatureImage(name: string, width?: number, height?: number, time?: number | string, fallbackSignType?: string, signatureImageDirection?: string): HTMLImageElement | null;
 /**
- * 创建无图签名兜底图（用户名 + 电子签名 + 验证日期）
- * 按字段宽高绘制，显示框设多大，字就按多大排
+ * 创建无图签名兜底图
+ * 默认用户名 + 电子签名 + 验证日期；仅用户名时只绘制姓名
  */
-export declare function createSignatureImageDataUrl(name: string, width?: number, height?: number, time?: number | string): string;
-export declare function createSignatureImage(name: string, width?: number, height?: number, time?: number | string): Promise<HTMLImageElement>;
+export declare function createSignatureImageDataUrl(name: string, width?: number, height?: number, time?: number | string, fallbackSignType?: string, signatureImageDirection?: string): string;
+export declare function createSignatureImage(name: string, width?: number, height?: number, time?: number | string, fallbackSignType?: string, signatureImageDirection?: string): Promise<HTMLImageElement>;

package/dist/core/data/DataManager.d.ts

@@ -1,5 +1,5 @@
 import { Doc } from '../view/Doc';
-import { EmitSource, Data, PartialData, FieldRuntimeSpecificConfig, PostChangePipelineContext } from './types';
+import { EmitSource, Data, PartialData, FieldRuntimeConstraint, FieldRuntimeSpecificConfig, PostChangePipelineContext } from './types';
 type JsonPath = string;
 type SubscriptionCallback = (newValue: any, oldValue: any) => void;
 /**
@@ -72,6 +72,11 @@ export declare class DataManager {
     setRuntimeSpecificConfig(entries: any): void;
     getFieldRuntimeSpecificConfig(path: JsonPath): FieldRuntimeSpecificConfig | undefined;
     setFieldRuntimeSpecificConfig(path: JsonPath, partial: FieldRuntimeSpecificConfig): void;
+    /**
+     * 原子替换某一功能来源施加的全部字段约束。
+     * 未出现在 constraintsByPath 中的旧约束会被清理，其他来源和普通运行时配置不受影响。
+     */
+    replaceFieldRuntimeConstraints(source: string, constraintsByPath: ReadonlyMap<JsonPath, FieldRuntimeConstraint>): void;
     /** 子表插行后：index 及之后的行配置下标 +1 */
     private shiftFieldRuntimeConfigAfterRowInsert;
     /** 子表删行后：移除该行配置，其后行配置下标 -1 */

package/dist/core/data/enrichers/udi-enricher.d.ts

@@ -0,0 +1,23 @@
+import { Doc } from '../../view/Doc';
+import { DataEnricherRegistration } from '../types';
+import { FIELD_TYPE } from '../../../domain/field/field-type';
+export interface UdiWidgetTarget {
+    valuePath: string;
+}
+type UdiWidgetInstance = {
+    widgetMeta?: {
+        field?: {
+            fieldType?: FIELD_TYPE;
+        };
+    };
+    valuePath?: string;
+};
+/** paramsConfig 中 containerId 优先；没有时使用 snId。 */
+export declare function resolveUdiQuery(doc: Doc): Record<string, string> | undefined;
+/** listAll 返回第一条 UDI；兼容接口返回 udi / name_ 的历史形态。 */
+export declare function parseUdi(res: unknown): string | undefined;
+/** 从单个 widget 实例解析 UDI enrich 目标。 */
+export declare function tryCollectUdiTarget(instance: UdiWidgetInstance): UdiWidgetTarget | null;
+/** UDI：按 paramsConfig.containerId / snId 查询并回填尚未赋值的字段。 */
+export declare function createUdiEnricher(doc: Doc, targets: UdiWidgetTarget[]): DataEnricherRegistration;
+export {};

package/dist/core/data/types/runtime-config.d.ts

@@ -1,8 +1,19 @@
+/**
+ * 独立运行时功能施加的字段约束。
+ *
+ * 多个来源互不覆盖，最终状态按“任一来源为 true”聚合。
+ */
+export type FieldRuntimeConstraint = {
+    readonly?: boolean;
+    disabled?: boolean;
+};
 /** 组件依赖按 runtime valuePath 写入的运行时配置（子表各行独立） */
 export type FieldRuntimeSpecificConfig = {
     newReadonly?: boolean;
     newRequired?: boolean;
     newDisabled?: boolean;
+    /** 按功能来源隔离的强制约束，避免解除某项约束时覆盖其他运行时规则 */
+    runtimeConstraints?: Record<string, FieldRuntimeConstraint>;
     /** assignment 策略「始终覆盖」时按行不可输入 */
     cannotInput?: boolean;
     /** 实例数字段：用户手填后不再被 API 回填覆盖 */

package/dist/core/index.d.ts

@@ -9,6 +9,8 @@ export { validateTextWidgetMarker } from './layout/logic/LayoutBuilder';
 export { CommandType } from './command/types';
 export { ModelConverter } from './model';
 export { DocumentEventBridge } from './event/DocumentEventBridge';
+export { DocumentRuntimeManager } from './runtime/DocumentRuntimeManager';
+export type { DocumentRuntimeExtension, DocumentValidationContext, DocumentValidationDecision, } from './runtime/DocumentRuntimeManager';
 export { DocModeTypeConst, PaperSizeConst, BuiltinComponentTypeConst } from './constants';
 export { default as CursorOverlay } from './cursor/render/cursor-overlay.vue';
 export { default as HiddenInput } from './cursor/render/hidden-input.vue';

package/dist/core/model/document/wtcRegionRef.d.ts

@@ -29,7 +29,7 @@ export declare const SUB_TABLE_REGION_TYPES: readonly ["repeating", "bounded", "
  * 子表 layout 类型
  * Ribbon 面板、子表主题色均使用此类型；主题配置见 @/domain/table 各 Profile.theme
  */
-export type SubTableLayoutType = 'dynamic-table' | 'fixed-table' | '2d-table' | 'check-table' | 'material-consume-table' | 'material-balance-table' | 'material-requisition-table' | 'warehouse-in-table' | 'warehouse-inbound-table' | 'warehouse-out-table' | 'warehouse-outbound-table' | 'warehouse-in-out-table' | 'warehouse-inventory-table' | 'part-stocktake-table' | 'device-part-consume-table' | 'warehouse-allocate-table' | 'pretreatment-list-table' | 'entrust-steril-batch-list-table';
+export type SubTableLayoutType = 'dynamic-table' | 'fixed-table' | '2d-table' | 'check-table' | 'material-consume-table' | 'material-balance-table' | 'material-requisition-table' | 'material-substitution-table' | 'warehouse-in-table' | 'warehouse-inbound-table' | 'warehouse-out-table' | 'warehouse-outbound-table' | 'warehouse-in-out-table' | 'warehouse-inventory-table' | 'part-stocktake-table' | 'device-part-consume-table' | 'warehouse-allocate-table' | 'pretreatment-list-table' | 'entrust-steril-batch-list-table';
 /** 表头 layout 类型 */
 export type TableHeaderLayoutType = 'table-header';
 /** 所有子表表格 layout 类型 */

package/dist/core/model/logic/subtable/repeating/RepeatingRegion.d.ts

@@ -63,11 +63,14 @@ export type MaterialBalanceTableProps = RepeatingWidgetPropsBase & {
 export type MaterialRequisitionTableProps = RepeatingWidgetPropsBase & {
     layoutType: 'material-requisition-table';
 };
+export type MaterialSubstitutionTableProps = RepeatingWidgetPropsBase & {
+    layoutType: 'material-substitution-table';
+};
 export type WarehouseAllocateTableProps = RepeatingWidgetPropsBase & {
     layoutType: 'warehouse-allocate-table';
     barcode_parsing_rules_id_?: string;
 };
-export type RepeatingWidgetPropsMeta = DynamicTableProps | WarehouseInTableProps | WarehouseInboundTableProps | WarehouseOutTableProps | WarehouseOutboundTableProps | WarehouseInOutTableProps | WarehouseInventoryTableProps | PartStocktakeTableProps | DevicePartConsumeTableProps | WarehouseAllocateTableProps | MaterialBalanceTableProps | MaterialRequisitionTableProps | EntrustSterilBatchListTableProps | PretreatmentListTableProps;
+export type RepeatingWidgetPropsMeta = DynamicTableProps | WarehouseInTableProps | WarehouseInboundTableProps | WarehouseOutTableProps | WarehouseOutboundTableProps | WarehouseInOutTableProps | WarehouseInventoryTableProps | PartStocktakeTableProps | DevicePartConsumeTableProps | WarehouseAllocateTableProps | MaterialBalanceTableProps | MaterialRequisitionTableProps | MaterialSubstitutionTableProps | EntrustSterilBatchListTableProps | PretreatmentListTableProps;
 export type RepeatingWidgetMeta = {
     props: RepeatingWidgetPropsMeta;
 };

package/dist/core/runtime/DocumentRuntimeManager.d.ts

@@ -0,0 +1,34 @@
+import { FieldChangeMap, EmitSource } from '../data';
+export interface DocumentValidationContext {
+    scene: 'submit';
+}
+export interface DocumentValidationDecision {
+    skipValidation: boolean;
+    reason?: string;
+}
+/**
+ * 文档级运行时扩展。
+ *
+ * 表格、对象及文档规则都通过同一生命周期接入，避免业务能力分别挂在
+ * composable / DataManager / 校验入口中。
+ */
+export interface DocumentRuntimeExtension {
+    onInit?(): void | Promise<void>;
+    onHydrate?(): void | Promise<void>;
+    onFieldChanges?(changedMap: FieldChangeMap, options: {
+        batchSource: EmitSource;
+    }): void | Promise<void>;
+    beforeValidate?(context: DocumentValidationContext): DocumentValidationDecision | void | Promise<DocumentValidationDecision | void>;
+    destroy?(): void;
+}
+export declare class DocumentRuntimeManager {
+    private readonly extensions;
+    register(extension: DocumentRuntimeExtension): void;
+    onInit(): Promise<void>;
+    onHydrate(): Promise<void>;
+    onFieldChanges(changedMap: FieldChangeMap, options: {
+        batchSource: EmitSource;
+    }): Promise<void>;
+    beforeValidate(context: DocumentValidationContext): Promise<DocumentValidationDecision>;
+    destroy(): void;
+}

package/dist/core/view/Doc.d.ts

@@ -11,6 +11,7 @@ import { DocModeType } from '../constants';
 import { CommandPayloadMap, RequiredPayloadCommands, OptionalPayloadCommands } from '../command/types';
 import { DocModel } from '../model';
 import { DocRuntimeMeta, FieldModelQuery, IDeviceConfig } from '../../sdk/types';
+import { DocumentRuntimeManager } from '../runtime/DocumentRuntimeManager';
 export interface DocInitOptions {
     mode?: DocModeType;
     model?: DocModel;
@@ -67,6 +68,8 @@ export declare class Doc {
     eventManager: EventManager;
     dataManager: DataManager;
     interactionManager: InteractionManager;
+    /** 文档级业务运行时统一生命周期。 */
+    runtimeManager: DocumentRuntimeManager;
     pageSize: {
         width: number;
         height: number;

package/dist/domain/active/active-types.d.ts

@@ -32,8 +32,10 @@ export type PanelType =
  | 'panel:device-part-consume-table'
 /** 物料平衡表 */
  | 'panel:material-balance-table'
-/** 生产收料表 */
+/** 产线收料表 */
  | 'panel:material-requisition-table'
+/** 物料替换表 */
+ | 'panel:material-substitution-table'
 /** 库存调拨表 */
  | 'panel:warehouse-allocate-table'
 /** 二维表 */

package/dist/domain/constants/enum/signature.d.ts

@@ -28,3 +28,17 @@ export declare const SignDisplayTypeConst: {
     /** 水平显示 */
     HORIZONTAL: string;
 };
+/** 兜底签名配置：个人无上传/手写签名素材时，密码校验通过后展示的样式 */
+export declare const FallbackSignTypeConst: {
+    /** 仅用户名 */
+    NAME_ONLY: string;
+    /** 用户名 + 签署日期 */
+    NAME_AND_DATE: string;
+};
+/** 签名图片方向 */
+export declare const SignatureImageDirectionConst: {
+    /** 横向签名 */
+    HORIZONTAL: string;
+    /** 竖向签名 */
+    VERTICAL: string;
+};

package/dist/domain/document-rule/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './runtime/decision-rule-evaluator';
+export * from './runtime/document-rule-runtime';

package/dist/domain/document-rule/runtime/decision-rule-evaluator.d.ts

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

package/dist/domain/document-rule/runtime/document-rule-runtime.d.ts

@@ -0,0 +1,19 @@
+import { Doc } from '../../../core/view/Doc';
+import { DocumentRuntimeExtension, DocumentValidationContext, DocumentValidationDecision } from '../../../core/runtime/DocumentRuntimeManager';
+import { FieldChangeMap } from '../../../core/data';
+export declare const DOCUMENT_RULE_PROMPT_EVENT = "document-rule:prompt";
+export interface DocumentRulePromptPayload {
+    rule: 'inspection-decision';
+    message: string;
+}
+/** 文档级规则运行时：统一处理状态迁移、提示事件及提交前裁决。 */
+export declare class DocumentRuleRuntime implements DocumentRuntimeExtension {
+    private readonly doc;
+    private inspectionDecisionMatched;
+    constructor(doc: Doc);
+    /** 装载和整表换数只建立状态基线，不弹提示。 */
+    onHydrate(): void;
+    onFieldChanges(changedMap: FieldChangeMap): void;
+    beforeValidate(context: DocumentValidationContext): DocumentValidationDecision;
+    private evaluateInspectionDecision;
+}

package/dist/domain/document-rule/types.d.ts

@@ -0,0 +1,50 @@
+export type DecisionRuleRelation = 'AND' | 'OR';
+export type DecisionRuleValueType = 'FIXED' | 'FIELD';
+/** 判定规则字段。保留所属模型/容器信息，供运行时准确取值。 */
+export interface DecisionRuleField {
+    id: string;
+    key: string;
+    name: string;
+    type: string;
+    modelKey: string;
+    modelName?: string;
+    /** 主表 / 子表 / 对象字段 */
+    scope: 'main' | 'sub' | 'object';
+    subFieldKey?: string;
+    objectFieldKey?: string;
+    options?: Array<{
+        label: string;
+        value: string | number | boolean;
+    }>;
+}
+export interface DecisionRuleRightValue {
+    valueType: DecisionRuleValueType;
+    result?: string | number | boolean;
+    /** FIELD 类型右值的完整字段信息。 */
+    field?: DecisionRuleField;
+}
+export interface DecisionRuleCondition {
+    key: string;
+    pid: string;
+    level: number;
+    firstRow?: boolean;
+    class?: string;
+    leftValue?: DecisionRuleField;
+    operatorValue?: string;
+    rightValue?: DecisionRuleRightValue[];
+}
+export interface DecisionRuleGroup {
+    key: string;
+    pid: string;
+    level: number;
+    class?: string;
+    type: 'group';
+    operatorType: DecisionRuleRelation;
+    children: Array<DecisionRuleGroup | DecisionRuleCondition>;
+}
+export interface InspectionDecisionRule {
+    dataRuleEnabled: boolean;
+    dataRule: string;
+    dataRuleConfig: string;
+    prompt: string;
+}

package/dist/domain/field/field-type.d.ts

@@ -418,6 +418,10 @@ export declare const BUSINESS_FIELD_TYPE: {
      * 表单实例数
      */
     readonly OF_INST_NUM: "of_inst_num";
+    /**
+     * 医疗器械唯一标识
+     */
+    readonly UDI: "udi";
     /**
      * 生产数量
      */
@@ -638,6 +642,10 @@ export declare const FIELD_TYPE: {
      * 表单实例数
      */
     readonly OF_INST_NUM: "of_inst_num";
+    /**
+     * 医疗器械唯一标识
+     */
+    readonly UDI: "udi";
     /**
      * 生产数量
      */

package/dist/domain/table/business/device/maintenance/index.d.ts

@@ -0,0 +1 @@
+export { profile as maintenanceProfile } from './profile';

package/dist/domain/table/business/device/maintenance/profile/field-keys.d.ts

@@ -0,0 +1,9 @@
+/** 设备保养表内置字段 key */
+export declare const F: {
+    /** 点检日期 */
+    readonly inspectionDate: "inspection_date_";
+    /** 点检人 */
+    readonly inspector: "inspector_";
+    /** 复核人 */
+    readonly reviewer: "reviewer_";
+};

package/dist/domain/table/business/device/maintenance/profile/fields.d.ts

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

package/dist/domain/table/business/device/maintenance/profile/index.d.ts

@@ -0,0 +1,3 @@
+import { BusinessSubTableProfile } from '../../../../types';
+export declare const TABLE_TYPE: "maintenance";
+export declare const profile: BusinessSubTableProfile;

package/dist/domain/table/business/device/point-inspection/index.d.ts

@@ -0,0 +1 @@
+export { profile as pointInspectionProfile } from './profile';

package/dist/domain/table/business/device/point-inspection/profile/field-keys.d.ts

@@ -0,0 +1,9 @@
+/** 设备点检表内置字段 key */
+export declare const F: {
+    /** 点检日期 */
+    readonly inspectionDate: "inspection_date_";
+    /** 点检人 */
+    readonly inspector: "inspector_";
+    /** 复核人 */
+    readonly reviewer: "reviewer_";
+};

package/dist/domain/table/business/device/point-inspection/profile/fields.d.ts

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

package/dist/domain/table/business/device/point-inspection/profile/index.d.ts

@@ -0,0 +1,3 @@
+import { BusinessSubTableProfile } from '../../../../types';
+export declare const TABLE_TYPE: "point-inspection";
+export declare const profile: BusinessSubTableProfile;

package/dist/domain/table/business/device/runtime/device-signature-lock-engine.d.ts

@@ -0,0 +1,13 @@
+import { Doc } from '../../../../../core';
+/**
+ * 设备点检/保养签字锁定引擎。
+ *
+ * 由 TableRuntime 生命周期驱动，只在初始化、行初始化或用户数据变更后重算；
+ * 不依赖组件是否已挂载，也不在渲染过程中反向写状态。
+ */
+export declare class DeviceSignatureLockEngine {
+    private readonly doc;
+    constructor(doc: Doc);
+    apply(): void;
+    private collectConstraint;
+}

package/dist/domain/table/business/device/signature-lock.d.ts

@@ -0,0 +1,26 @@
+import { Doc } from '../../../../core';
+export type DeviceOperationControlField = 'inspector_' | 'reviewer_';
+export interface FixedDeviceOperationConfig {
+    /** 签名后一并锁定的主表字段 */
+    mainFieldBindings?: string[];
+    /** 触发当前行数据锁定的签名字段 */
+    dataLockControlField?: DeviceOperationControlField;
+}
+export interface FixedDeviceOperationFieldState {
+    disabled?: boolean;
+    readonly?: boolean;
+}
+export interface FixedDeviceOperationTable {
+    subFieldKey: string;
+    config: FixedDeviceOperationConfig;
+}
+/** 签名字段有有效数据时，认为该行已进入锁定状态。 */
+export declare function hasSignatureValue(value: unknown): boolean;
+export declare function isSignatureLockActive(config: FixedDeviceOperationConfig | undefined, rowData: Record<string, any> | undefined): boolean;
+/** 已保存的固定表行，其控制签名不可再删除。 */
+export declare function isPersistedSignatureLockActive(config: FixedDeviceOperationConfig | undefined, rowData: Record<string, any> | undefined): boolean;
+export declare function getFixedDeviceOperationTables(doc: Doc): FixedDeviceOperationTable[];
+/** 根据字段实际运行时路径解析设备点检/保养表的动态禁用、只读状态。 */
+export declare function resolveFixedDeviceOperationFieldState(doc: Doc, runtimeValuePath: string): FixedDeviceOperationFieldState;
+/** 组装设备点检/保养控制签名前需校验的主表与当前行字段路径。 */
+export declare function resolveDeviceSignatureValidationPaths(doc: Doc, runtimeValuePath: string, candidatePaths: Iterable<string>): string[];

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

@@ -1,5 +1,5 @@
 /**
- * 生产收料表（MATERIAL_REQUISITION）字段 key
+ * 产线收料表（MATERIAL_REQUISITION）字段 key
  */
 export declare const F: {
     /** 物料 */

package/dist/domain/table/business/material/material-substitution/actions/scan.d.ts

@@ -0,0 +1,3 @@
+import { BusinessScanHandler } from '../../../shared/scan-action';
+/** 物料替换表：按条码解析规则映射结果填充空行，否则新增一行。 */
+export declare const handleMaterialSubstitutionScan: BusinessScanHandler;

package/dist/domain/table/business/material/material-substitution/index.d.ts

@@ -0,0 +1,3 @@
+export { profile as materialSubstitutionProfile, TABLE_TYPE } from './profile';
+export * from './profile';
+export { handleMaterialSubstitutionScan } from './actions/scan';

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

@@ -0,0 +1,39 @@
+/**
+ * 物料替换表（MATERIAL_SUBSTITUTION）字段 key
+ */
+export declare const F: {
+    /** 工序节点 */
+    readonly routingOperation: "routing_operation_id_";
+    /** SN */
+    readonly productionContainer: "production_container_id_";
+    /** 被替换物料批号 */
+    readonly sourceMaterialNo: "source_material_no_";
+    /** 被替换物料 */
+    readonly sourceProduct: "source_product_id_";
+    /** 被替换物料名称 */
+    readonly sourceProductName: "source_product_id_name_";
+    /** 被替换物料编码 */
+    readonly sourceProductCode: "source_product_id_code_";
+    /** 被替换物料规格 */
+    readonly sourceProductSpec: "source_product_id_spec_";
+    /** 原上料数量 */
+    readonly sourceQtyConsumed: "source_qty_consumed_";
+    /** 替换物料批号 */
+    readonly targetMaterialNo: "target_material_no_";
+    /** 替换物料 */
+    readonly targetProduct: "target_product_id_";
+    /** 替换物料名称 */
+    readonly targetProductName: "target_product_id_name_";
+    /** 替换物料编码 */
+    readonly targetProductCode: "target_product_id_code_";
+    /** 替换物料规格 */
+    readonly targetProductSpec: "target_product_id_spec_";
+    /** 替换数量 */
+    readonly targetQtyConsumed: "target_qty_consumed_";
+};
+export type MaterialSubstitutionFieldKey = (typeof F)[keyof typeof F];
+/** 设计态固定禁用、运行态只读的物料信息字段 */
+export declare const DISABLED_INPUT_FIELDS: readonly ["source_material_no_", "source_product_id_name_", "source_product_id_code_", "source_product_id_spec_", "source_qty_consumed_", "target_product_id_name_", "target_product_id_code_", "target_product_id_spec_"];
+export declare const CLEAR_ON_SOURCE_PRODUCT_EMPTY: readonly ["source_material_no_", "source_product_id_name_", "source_product_id_code_", "source_product_id_spec_", "source_qty_consumed_"];
+/** 替换物料批号清空 / 手输时需清空的物料字段 */
+export declare const CLEAR_ON_TARGET_MATERIAL_NO_EMPTY: readonly ["target_product_id_name_", "target_product_id_code_", "target_product_id_spec_"];

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

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

package/dist/domain/table/business/material/material-substitution/profile/index.d.ts

@@ -0,0 +1,4 @@
+import { BusinessSubTableProfile } from '../../../../types';
+export declare const TABLE_TYPE: "material-substitution";
+export declare const profile: BusinessSubTableProfile;
+export { profile as materialSubstitutionProfile };

package/dist/domain/table/business/material/material-substitution/runtime/register-handlers.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,3 @@
+import { Doc } from '../../../../../../core';
+export declare function handleTargetMaterialNoChange(doc: Doc, subFieldKey: string, rowIndex: number): void;
+export declare function handleSourceProductChange(doc: Doc, subFieldKey: string, rowIndex: number): void;

package/dist/domain/table/design/hooks/on-bounded-default-props.d.ts

@@ -0,0 +1,3 @@
+import { BoundedWidgetPropsMeta } from '../../../../core/model/logic/subtable/bounded/BoundedRegion';
+/** 根据所选子模型解析固定表创建时的默认配置。 */
+export declare function getDefaultBoundedWidgetProps(refModelType?: string): BoundedWidgetPropsMeta;

package/dist/domain/table/design/ribbon-options.d.ts

@@ -7,6 +7,8 @@ export interface RibbonTableOptionsParams {
     suiteKey?: string;
     /** 套件级需从 Ribbon 隐藏的业务表类型 */
     hiddenBusinessTableTypes?: BusinessSubTableType[];
+    /** 是否可使用仅向 eDHR Max / Ultra 开放的业务表 */
+    canUseMaxEditionTables?: boolean;
 }
 /** 生成 Ribbon「数据表」「业务表」下拉选项 */
 export declare function getRibbonTableOptions(params?: RibbonTableOptionsParams): {

package/dist/domain/table/design/sub-model-matcher.d.ts

@@ -1,5 +1,7 @@
 import { FieldMeta } from '../../../capabilities/model-field-runtime';
 import { DropdownOption } from '../../../base';
+/** 是否为仅能通过固定表入口选择的业务子模型。 */
+export declare function isFixedOnlyBusinessRefModelType(refModelType: string | undefined | null): boolean;
 /**
  * 生成「选择子模型」下拉选项
  * @param tableTypeOrRibbonAction 表类型或 Ribbon action

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

@@ -13,5 +13,7 @@ export * from './runtime/table-runtime';
 export * from './design/hooks/on-subtable-create';
 export * from './design/hooks/on-field-attach';
 export * from './design/hooks/on-repeating-default-props';
+export * from './design/hooks/on-bounded-default-props';
 export * from './design/validate-table-selection';
 export * from './design/validate-nested-table-region';
+export * from './business/device/signature-lock';

package/dist/domain/table/registry.d.ts

@@ -15,5 +15,5 @@ export declare function getProfileByLayoutType(layoutType: string): TableProfile
  */
 export declare function getAllBusinessRefModelTypes(): string[];
 /** 按 refModelType 获取业务表 Profile */
-export declare function getBusinessProfileByRefModelType(refModelType: string): BusinessSubTableProfile | undefined;
+export declare function getBusinessProfileByRefModelType(refModelType: string | undefined | null): BusinessSubTableProfile | undefined;
 export { ALL_TABLE_PROFILES };

package/dist/domain/table/runtime/table-runtime.d.ts

@@ -36,6 +36,7 @@ export declare class TableRuntime {
     private readonly remoteSync;
     private readonly initLoad;
     private readonly mainFieldBind;
+    private readonly deviceSignatureLock;
     constructor(doc: Doc);
     /** 文档是否包含业务子表 */
     get hasBusinessTables(): boolean;

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

@@ -1,5 +1,6 @@
 import { FIELD_TYPE } from '../field/field-type';
 import { SubTableLayoutType } from '../../core/model/document/wtcRegionRef';
+import { RequiredQtyCalcRule } from './business/material/types';
 /**
  * 数据表类型
  * @property dynamic-table - 动态表
@@ -20,12 +21,15 @@ export type DataTableType = 'dynamic-table' | 'fixed-table' | 'two-d-table';
  * @property warehouse-allocate  - 库存调拨表
  * @property material-consume    - 物料消耗表
  * @property material-balance    - 物料平衡表
- * @property material-requisition - 生产收料表
+ * @property material-requisition - 产线收料表
+ * @property material-substitution - 物料替换表
+ * @property point-inspection    - 设备点检表（固定表业务模型）
+ * @property maintenance         - 设备保养表（固定表业务模型）
  * @property check-table         - 检验表
  * @property pretreatment-list   - 预处理表
  * @property entrust-steril-batch-list - 委托灭菌生产批次表
  */
-export type BusinessSubTableType = 'warehouse-in' | 'warehouse-inbound' | 'warehouse-out' | 'warehouse-outbound' | 'warehouse-in-out' | 'warehouse-inventory' | 'part-stocktake' | 'device-part-consume' | 'warehouse-allocate' | 'material-consume' | 'material-balance' | 'material-requisition' | 'check-table' | 'pretreatment-list' | 'entrust-steril-batch-list';
+export type BusinessSubTableType = 'warehouse-in' | 'warehouse-inbound' | 'warehouse-out' | 'warehouse-outbound' | 'warehouse-in-out' | 'warehouse-inventory' | 'part-stocktake' | 'device-part-consume' | 'warehouse-allocate' | 'material-consume' | 'material-balance' | 'material-requisition' | 'material-substitution' | 'point-inspection' | 'maintenance' | 'check-table' | 'pretreatment-list' | 'entrust-steril-batch-list';
 /** 所有子表类型（数据表 + 业务表） */
 export type TableType = DataTableType | BusinessSubTableType;
 /**
@@ -105,8 +109,10 @@ export interface BusinessSubTableProfile extends TableProfileBase {
     category: 'business';
     type: BusinessSubTableType;
     match: BusinessTableMatchRule;
+    /** fixed-table-model 不注册独立 Ribbon 入口，仅借用固定表选择业务子模型。 */
+    entry?: 'ribbon' | 'fixed-table-model';
     /** Ribbon 业务表分组名 */
-    ribbonGroup: string;
+    ribbonGroup?: string;
     ribbonGroupDivider?: boolean;
     /** 仅在这些套件的 Ribbon 中展示；省略则所有套件可见（仍受 suite hidden 列表约束） */
     ribbonSuites?: SuiteKey[];
@@ -471,6 +477,8 @@ export type RuleTrigger = 'always' | 'onRowInit' | 'onFieldChange' | 'onRowConfi
 export interface RuleContext {
     /** 当前文档是否为模拟填报 */
     isMockReport: boolean;
+    /** 物料消耗表的需求数量计算规则 */
+    requiredQtyCalcRule?: RequiredQtyCalcRule;
     /** 子表在 rawData 中的 fieldKey */
     subFieldKey: string;
     /** 业务子模型 refModelType */