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

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/input/src/input-number.vue.d.ts

@@ -21,6 +21,7 @@ type __VLS_Props = {
     emptyValue?: string | number;
     /** 小数截取处理规则 */
     roundingMode?: 1 | 4 | 6;
+    maxlength?: number;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;

package/dist/base/message/src/Message.vue.d.ts

@@ -3,8 +3,10 @@ interface MessageItem {
     id: number;
     type: 'info' | 'success' | 'warning' | 'error';
     message: string | VNode;
+    title?: string;
     closeable: boolean;
     duration: number;
+    key?: string;
     timer?: number;
     startTime?: number;
     remaining: number;

package/dist/base/message/src/message.d.ts

@@ -2,8 +2,10 @@ import { VNode } from 'vue';
 export interface MessageOptions {
     type?: 'info' | 'success' | 'warning' | 'error';
     message: string | VNode | (() => VNode);
+    title?: string;
     duration?: number;
     closeable?: boolean;
+    key?: string;
 }
 declare function GctMessage(options: MessageOptions): void;
 declare namespace GctMessage {

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/select/src/basic-select.vue.d.ts

@@ -42,6 +42,10 @@ type __VLS_Props = {
     allowCreate?: boolean;
     /** 下拉选项是否可搜索 */
     searchable?: boolean;
+    /** 由外部请求搜索结果，跳过本地过滤 */
+    remote?: boolean;
+    /** 当前选中项的回显信息，可不在搜索结果中 */
+    selectedOption?: DropdownOption;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -58,6 +62,7 @@ declare function __VLS_template(): {
         'option-icon'?(_: {
             option: DropdownOption;
         }): any;
+        'bottom-bar'?(_: {}): any;
     };
     refs: {
         dropdownRef: import('vue').CreateComponentPublicInstanceWithMixins<Record<string, any> & {}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, {}, {}, string, {}, any, import('vue').ComponentProvideOptions, {
@@ -79,15 +84,21 @@ type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     getRef: import('vue').Ref<any, any>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    search: (keyword: string) => any;
     edit: (option: DropdownOption) => any;
     click: (evt: any) => any;
-    "update:modelValue": (val: string | number | (string | number)[]) => any;
-    change: (val: string | number | (string | number)[], item?: DropdownOption | undefined) => any;
+    "update:modelValue": (val: string | number | (string | number)[] | undefined) => any;
+    change: (val: string | number | (string | number)[] | undefined, item?: DropdownOption | undefined) => any;
+    "dropdown-show": () => any;
+    "reach-bottom": () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSearch?: ((keyword: string) => any) | undefined;
     onEdit?: ((option: DropdownOption) => any) | undefined;
     onClick?: ((evt: any) => any) | undefined;
-    "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
-    onChange?: ((val: string | number | (string | number)[], item?: DropdownOption | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((val: string | number | (string | number)[] | undefined) => any) | undefined;
+    onChange?: ((val: string | number | (string | number)[] | undefined, item?: DropdownOption | undefined) => any) | undefined;
+    "onDropdown-show"?: (() => any) | undefined;
+    "onReach-bottom"?: (() => any) | undefined;
 }>, {
     disabled: boolean;
     options: DropdownOption[];
@@ -96,6 +107,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     allowClear: boolean;
     unremovableValues: Array<string | number>;
     searchable: boolean;
+    remote: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     dropdownRef: import('vue').CreateComponentPublicInstanceWithMixins<Record<string, any> & {}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, {}, {}, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};

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

@@ -18,6 +18,11 @@ export interface ImageCropRect {
     width: number;
     height: number;
 }
+/** 固定 360×204 兜底图同一比例，按 2 倍像素绘制 */
+export declare const FALLBACK_SIGN_DISPLAY_SIZE: {
+    readonly width: 180;
+    readonly height: 102;
+};
 /**
  * 根据图片原始尺寸 + 配置，计算最终显示尺寸
  */
@@ -34,11 +39,11 @@ export declare function computeContainLayout(natural: ImageSize, box: ImageSize)
  * 在目标框内等比缩放（contain），不压缩、不拉伸
  */
 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/capabilities/model-field-runtime/types/field.d.ts

@@ -16,6 +16,10 @@ export interface FieldMeta {
     bizType?: FIELD_TYPE;
     /** 是否必填 */
     required?: boolean;
+    /** 建字段时配置的默认值，拖入表单时用于初始化组件 */
+    defaultValue?: {
+        value?: unknown;
+    } | null;
     /** 字段创建类型 */
     createType: CreateType;
     /** 映射类型(公式,函数等实际映射的类型) */

package/dist/core/command/base/FloatingFieldCommand.d.ts

@@ -0,0 +1,9 @@
+import { CommandBase } from './CommandBase';
+import { CommandType } from '../types';
+/** Existing commands snapshot only the body; floating field commands also own their overlays. */
+export declare abstract class FloatingFieldCommand<T extends CommandType> extends CommandBase<T> {
+    private overlays?;
+    private overlayIdentities?;
+    protected saveSnapshot(): import('../../model/types').RawElement | undefined;
+    protected restoreSnapshot(): void;
+}

package/dist/core/command/commands/DeleteRow.d.ts

@@ -4,7 +4,7 @@ import { CommandBase, PostCommandContext } from '../base/CommandBase';
 /**
  * 表格行删除命令
  *
- * 删除指定索引处的行
+ * 删除指定行，或当前选区中同一表格的连续多行
  */
 export declare class DeleteRow extends CommandBase<'deleteRow'> {
     constructor(doc: Doc, payload?: CommandPayloadMap['deleteRow']);

package/dist/core/command/commands/InsertFloatingField.d.ts

@@ -0,0 +1,9 @@
+import { FloatingFieldCommand } from '../base/FloatingFieldCommand';
+import { WrField } from '../../model/document';
+export declare class InsertFloatingField extends FloatingFieldCommand<'insertFloatingField'> {
+    protected execute(): Promise<{
+        wr: WrField;
+        pos: number;
+        side: "before";
+    } | null>;
+}

package/dist/core/command/commands/MoveFloatingField.d.ts

@@ -0,0 +1,10 @@
+import { FloatingFieldCommand } from '../base/FloatingFieldCommand';
+export declare class MoveFloatingField extends FloatingFieldCommand<'moveFloatingField'> {
+    private fieldId?;
+    protected execute(): Promise<{
+        wr: import('../../model/document').WrField;
+        pos: number;
+        side: "after";
+    } | null>;
+    protected afterUndo(): import('../types').CursorMeta | null;
+}

package/dist/core/command/commands/RemoveFloatingField.d.ts

@@ -0,0 +1,12 @@
+import { FloatingFieldCommand } from '../base/FloatingFieldCommand';
+export declare class RemoveFloatingField extends FloatingFieldCommand<'removeFloatingField'> {
+    private fieldId?;
+    private bindingSnapshot;
+    protected execute(): Promise<{
+        wp: import('../../model/document').Wp;
+        pos: number;
+        side: "before";
+    } | null>;
+    protected restoreSnapshot(): void;
+    protected afterUndo(): import('../types').CursorMeta | null;
+}

package/dist/core/command/types.d.ts

@@ -39,6 +39,9 @@ export declare const CommandType: {
     readonly insertField: "insertField";
     readonly insertPaperWidget: "insertPaperWidget";
     readonly insertFloatingOverlay: "insertFloatingOverlay";
+    readonly insertFloatingField: "insertFloatingField";
+    readonly moveFloatingField: "moveFloatingField";
+    readonly removeFloatingField: "removeFloatingField";
     readonly delete: "delete";
     readonly backspace: "backspace";
     readonly enter: "enter";
@@ -111,6 +114,17 @@ export type CommandPayloadMap = {
         hit: PointerHitResult;
         pageWidgetMeta: WidgetMeta;
     };
+    insertFloatingField: CommandPayload & {
+        hit: PointerHitResult;
+        widgetMeta: WidgetMeta;
+    };
+    moveFloatingField: CommandPayload & {
+        id: string;
+        position: import('../../domain/field/seal/seal-value').SealPosition;
+    };
+    removeFloatingField: CommandPayload & {
+        id: string;
+    };
     delete: CommandPayload & Record<string, never>;
     backspace: CommandPayload & Record<string, never>;
     enter: CommandPayload & Record<string, never>;

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/formula/business-functions.d.ts

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

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/event/handlers/IMEHandler.d.ts

@@ -16,6 +16,7 @@ export declare class IMEHandler implements IEventHandler {
     private handleInput;
     private handlePaste;
     private handleKeydown;
+    private tryRemoveSelectedSeal;
     /** 入队文本，延迟批量执行 InsertText */
     private enqueueInsert;
     private handleCommitValidate;

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/layout/handlers/fields/signature-decoration-layout.d.ts

@@ -0,0 +1,14 @@
+/** 签名与日期的组合区域。未设置样式的旧模板按上下排列。 */
+export declare function getSignatureDecorationPlacement(width: number, height: number, textWidth: number, textHeight: number, gap: number, signDisplayStyle?: string): {
+    position: "right";
+    rectWidth: number;
+    rectHeight: number;
+    x: number;
+    y: number;
+} | {
+    position: "bottom";
+    rectWidth: number;
+    rectHeight: number;
+    x: number;
+    y: number;
+};

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/model/logic/subtable/shared/merged-table-range.d.ts

@@ -0,0 +1,4 @@
+import { Wtbl } from '../../../document';
+import { TableRange } from './dataGroupSlotCount';
+/** 补齐业务模板覆盖的合并格底层范围，兼容旧表单只记录主格坐标的范围。 */
+export declare function expandMergedTableRange(table: Wtbl, range: TableRange): TableRange;

package/dist/core/model/overlays/Wlayout.d.ts

@@ -9,6 +9,7 @@ export type WlayoutXmlJson = RawElement & {
         width?: number;
         height?: number;
         zIndex?: number;
+        pageIndex?: number;
     };
 };
 export interface WlayoutOptions extends ModelGroupOptions<ModelNode> {
@@ -18,6 +19,7 @@ export interface WlayoutOptions extends ModelGroupOptions<ModelNode> {
     width?: number;
     height?: number;
     zIndex?: number;
+    pageIndex?: number;
 }
 /**
  * 布局容器
@@ -34,6 +36,7 @@ export declare class Wlayout extends ModelGroup<ModelNode> {
     width?: number;
     height?: number;
     zIndex: number;
+    pageIndex?: number;
     parent?: ModelNode;
     constructor(options: WlayoutOptions);
     /**
@@ -66,5 +69,6 @@ export declare class Wlayout extends ModelGroup<ModelNode> {
         width: number;
         height: number;
         zIndex: number;
+        pageIndex?: number;
     }): Wlayout;
 }

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;
@@ -56,6 +57,8 @@ export declare class Doc {
     refer: boolean;
     /** 是否是模拟填报 */
     isMockReport: boolean;
+    /** 已进入表单变更编辑；由 enterBaseline 设置，随文档实例销毁。 */
+    isFormChangeEditing: boolean;
     /** 填报内容区底色开关配置 */
     showPrintFieldBg: boolean;
     model?: DocModel;
@@ -67,6 +70,8 @@ export declare class Doc {
     eventManager: EventManager;
     dataManager: DataManager;
     interactionManager: InteractionManager;
+    /** 文档级业务运行时统一生命周期。 */
+    runtimeManager: DocumentRuntimeManager;
     pageSize: {
         width: number;
         height: number;

package/dist/core/view/runs/ImageRun.d.ts

@@ -10,14 +10,20 @@ export interface IImageRun {
     readonly width: number;
     /** 组件高度 */
     readonly height: number;
+    /** 图片本身的宽高（不包含日期装饰） */
+    readonly imageWidth: number;
+    readonly imageHeight: number;
     /** 组件坐标位置 */
     readonly x: number;
     /** 组件坐标位置 */
     readonly y: number;
     /** 图片源地址 */
     src: string;
+    decorations?: ImageRunOptions['decorations'];
     /** 是否保持等比 */
     keepAspect: boolean;
+    /** 下方文字比图片宽时，图片在组合区域中的水平偏移 */
+    readonly imageOffsetX: number;
 }
 export interface ImageRunOptions extends LayoutNodeOptions {
     src: string;
@@ -45,6 +51,9 @@ export declare class ImageRun extends LayoutNode implements IImageRun {
     decorations?: ImageRunOptions['decorations'];
     get width(): number;
     set width(value: number);
+    get imageWidth(): number;
+    get imageHeight(): number;
+    get imageOffsetX(): number;
     get height(): number;
     set height(value: number);
     constructor(options: ImageRunOptions);

package/dist/core/widget/types.d.ts

@@ -1,7 +1,7 @@
 import { FIELD_TYPE } from '../../domain/field/field-type';
-export type ExternalComponentType = 'cascade' | 'fw:input' | 'fw:number' | 'fw:double' | 'fw:enum' | 'fw:enum-multiple' | 'fw:date-time' | 'fw:date' | 'fw:time' | 'fw:select' | 'fw:select-multiple' | 'fw:tree-select' | 'fw:tree-select-multiple' | 'fw:table-select' | 'fw:rdo-table-select' | 'fw:signature' | 'fw:image' | 'fw:file' | 'pw:image' | 'pw:barcode' | 'pw:qrcode' | 'pw:diagonal' | 'pw:serialnumber' | 'pw:pagination' | 'pw:line' | 'pw:timediff';
+export type ExternalComponentType = 'cascade' | 'fw:input' | 'fw:number' | 'fw:double' | 'fw:enum' | 'fw:enum-multiple' | 'fw:date-time' | 'fw:date' | 'fw:time' | 'fw:select' | 'fw:select-multiple' | 'fw:tree-select' | 'fw:tree-select-multiple' | 'fw:table-select' | 'fw:rdo-table-select' | 'fw:signature' | 'fw:seal' | 'fw:image' | 'fw:file' | 'pw:image' | 'pw:barcode' | 'pw:qrcode' | 'pw:diagonal' | 'pw:serialnumber' | 'pw:pagination' | 'pw:line' | 'pw:timediff';
 /** 渲染组件标识 后续支持自定义组件 */
-export type ExternalNodeType = 'render:gct-placeholder' | 'render:gct-control' | 'render:gct-space' | 'render:gct-text' | 'render:gct-image' | 'render:gct-signature' | 'render:gct-leftMarker' | 'render:gct-rightMarker' | 'render:pw-barcode' | 'render:pw-qrcode' | 'render:pw-image' | 'render:pw-diagonal' | 'render:pw-pagination' | 'render:pw-line';
+export type ExternalNodeType = 'render:gct-placeholder' | 'render:gct-control' | 'render:gct-space' | 'render:gct-text' | 'render:gct-image' | 'render:gct-signature' | 'render:gct-seal' | 'render:gct-leftMarker' | 'render:gct-rightMarker' | 'render:pw-barcode' | 'render:pw-qrcode' | 'render:pw-image' | 'render:pw-diagonal' | 'render:pw-pagination' | 'render:pw-line';
 /** 渲染节点集合 */
 export interface FieldNodeRenderers {
     /** 暗提示节点 */

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