iflow-engine-base 3.12.3 → 3.12.5

package/dist/index.d.ts

@@ -551,17 +551,24 @@ declare class Calibration {
     private static readonly sourceColor;
     private static readonly targetColor;
     private readonly matrices;
+    private readonly histories;
+    private readonly historyOrder;
     private pointCalibrationUrl;
     private pointCalibrationPoints;
+    private pointCalibrationCallback;
     private behavior;
+    private readonly onKeyDown;
     /** 供 handelBehaved 判断不同工具切换时释放当前鼠标监听。 */
     readonly type = "point-calibration";
     constructor(engine: any);
+    /** 释放校准管理器的全局快捷键监听。 */
+    dispose(): void;
     /**
      * 应用模型校准矩阵。
      * flat 16 数组按 Three.js 列主序处理；二维 4x4 数组按常见行主序处理。
      */
     apply(options: CalibrationOptions): boolean;
+    private applyInternal;
     /**
      * 兼容业务侧更直观的命名。
      */
@@ -605,18 +612,57 @@ declare class Calibration {
     /**
      * 清除指定模型的校准。
      */
-    clear(url: string): boolean;
+    clear(url: string, onChange?: CalibrationChangeCallback): boolean;
+    /** 撤回最近一次模型校准；传 url 时只撤回指定模型，不传时撤回最后变更的模型。 */
+    undo(url?: string, onChange?: CalibrationChangeCallback): boolean;
+    private pushHistory;
+    private findLatestHistoryUrl;
+    private notifyChange;
+    private createChangeEvent;
+    private handleKeyDown;
+    /** Ctrl+Z / Command+Z 撤回最近一次主模型校准，输入框焦点下保留原生编辑行为。 */
+    private isUndoShortcut;
     private updateCachedModelBox;
     private clearRuntimeWorldBoxCache;
     private toThreeMatrix;
     private toVector3;
 }
 
+export declare type CalibrationChangeCallback = (event: CalibrationChangeEvent) => void;
+
+/** 3D 主模型校准变化回调数据。 */
+export declare interface CalibrationChangeEvent {
+    url: string;
+    source: CalibrationChangeSource;
+    /** 模型根节点当前平移值，单位沿用引擎世界坐标。 */
+    offset: CalibrationVector3Array;
+    /** 模型根节点当前欧拉角，单位为角度，数组第 4 位保留 Three.js 的旋转顺序。 */
+    rotation: CalibrationEulerArray;
+    /** 模型根节点当前欧拉角，单位为弧度，供需要 Three.js 原始单位的业务使用。 */
+    rotationRadians: CalibrationEulerArray;
+    /** 便于 UI 直接显示的三轴角度制旋转值。 */
+    rotationDegrees: CalibrationVector3Array;
+    /** 模型根节点当前缩放，矩阵校准包含缩放时用于业务侧兜底保存。 */
+    scale: CalibrationVector3Array;
+    /** 当前 4x4 校准矩阵，按 Three.js 列主序导出。 */
+    matrix: number[];
+    /** 本次变更前的 4x4 校准矩阵，按 Three.js 列主序导出。 */
+    previousMatrix: number[];
+    /** 是否由 Ctrl+Z 或 undo 触发。 */
+    isUndo: boolean;
+}
+
+export declare type CalibrationChangeSource = 'apply' | 'segment' | 'point' | 'clear' | 'undo';
+
+declare type CalibrationEulerArray = [number, number, number, THREE.EulerOrder];
+
 declare type CalibrationMatrixInput = THREE.Matrix4 | number[] | ArrayLike<number> | number[][];
 
 export declare interface CalibrationOptions {
     url: string;
     matrix: CalibrationMatrixInput;
+    /** 校准成功后返回当前模型的偏移、旋转和矩阵，便于业务侧保存手动调节结果。 */
+    onChange?: CalibrationChangeCallback;
 }
 
 declare type CalibrationPointInput = THREE.Vector3 | [number, number, number] | {
@@ -634,6 +680,8 @@ declare interface CalibrationSegmentInput {
     end: CalibrationPointInput;
 }
 
+declare type CalibrationVector3Array = [number, number, number];
+
 declare class CameraModule {
     private static readonly MIN_VISIBLE_HEIGHT;
     private static readonly MIN_CAMERA_DISTANCE;
@@ -2480,6 +2528,10 @@ declare class EngineKernelV2 {
     modelPlace: ModelPlace;
     /** 基于当前引擎作为基准版本的模型差异比较器。 */
     modelComparison: ModelComparison;
+    /** 管理模型炸开代理对象，并保持炸开后的构件交互身份。 */
+    modelExplode: ModelExplode;
+    /** 材质编辑器，提供 DOM 面板、材质修改记录读取和一键还原能力。 */
+    materialTool: MaterialTool;
     models: any[];
     reactBoundingClientRect: {
         left: number;
@@ -2941,6 +2993,7 @@ export declare enum EventType {
     Click = "click",// data: ModelClickEventItem[]
     MouseMove = "mouse-move",// data: MouseEventData - 鼠标移动事件
     ModelPlaceSelected = "model-place-selected",
+    ModelCalibrationChanged = "model-calibration-changed",
     CameraChanged = "camera-changed",// 相机移动时持续触发
     CameraIdle = "camera-idle",// 相机静止后触发
     ViewportResize = "viewport-resize",// 窗口大小变化
@@ -4022,6 +4075,9 @@ declare class InteractionModule {
     private intersectsRect;
     private getMergedBox;
     private getSceneModel;
+    /** 从射线命中的对象还原真实构件 ID，兼容炸开代理和普通模型对象。 */
+    private getHitModelId;
+    private getEngineNode;
 }
 
 declare class InteractionModule2d {
@@ -4673,6 +4729,8 @@ declare class LinkElement2d3d {
     private disActive;
     dispose(): void;
     private readonly listenElementClick;
+    /** 二三维模型联动开启时保持 3D 引擎全帧渲染，避免等待空闲限帧间隔。 */
+    private readonly listenLinkStateChange;
 }
 
 declare class LinkView2d3d {
@@ -5089,6 +5147,132 @@ declare interface Markup2dStyle {
 
 declare type Markup2dType = 'line' | 'arrow' | 'rect' | 'ellipse' | 'text' | 'polygon' | 'cloudline';
 
+export declare interface MaterialEditorMaterialInfo {
+    id: string;
+    name: string;
+    type: string;
+    color?: string;
+    opacity: number;
+    transparent: boolean;
+    roughness?: number;
+    metalness?: number;
+    emissive?: string;
+    emissiveIntensity?: number;
+    side: number;
+    wireframe?: boolean;
+    textures: MaterialTextureInfo[];
+}
+
+export declare interface MaterialEditorOptions {
+    visible?: boolean;
+    title?: string;
+    width?: number;
+}
+
+export declare interface MaterialEditorTarget {
+    url: string;
+    ids?: Array<string | number>;
+}
+
+export declare type MaterialMapSlot = 'map' | 'normalMap' | 'roughnessMap' | 'metalnessMap' | 'alphaMap' | 'aoMap' | 'bumpMap' | 'emissiveMap';
+
+export declare interface MaterialModificationRecord {
+    id: string;
+    name: string;
+    type: string;
+    objectNames: string[];
+    changes: Record<string, {
+        before: unknown;
+        after: unknown;
+    }>;
+}
+
+declare interface MaterialOption {
+    material: THREE.Material;
+    materials?: THREE.Material[];
+    owners: THREE.Object3D[];
+}
+
+export declare interface MaterialTextureInfo {
+    slot: MaterialMapSlot;
+    name: string;
+    url: string;
+    hasTexture: boolean;
+}
+
+/** 材质编辑器入口，负责对外 API、事件绑定和材质资源生命周期。 */
+export declare class MaterialTool {
+    private readonly engine;
+    options: Required<MaterialEditorOptions>;
+    selectedMaterials: MaterialOption[];
+    selectedMaterialId: string | null;
+    targetText: string;
+    visible: boolean;
+    private readonly textureLoader;
+    private readonly ownedTextures;
+    private readonly objectUrls;
+    private readonly collector;
+    private readonly snapshots;
+    private readonly panel;
+    private isDisposed;
+    private eventsBound;
+    private readonly handleSelectionChanged;
+    private readonly handleClick;
+    private readonly handleLoadingCompleted;
+    constructor(engine: any, options?: MaterialEditorOptions);
+    /** 初始化 DOM 和事件监听；默认隐藏，业务可调用 show() 打开。 */
+    init(options?: MaterialEditorOptions): void;
+    /** 显示编辑器，可同时传入目标对象或构件选择信息。 */
+    show(target?: THREE.Object3D | MaterialEditorTarget): void;
+    /** 隐藏编辑器但保留已有修改记录。 */
+    hide(): void;
+    /** 切换编辑器显示状态。 */
+    toggle(target?: THREE.Object3D | MaterialEditorTarget): void;
+    /** 根据场景对象读取其下所有材质并刷新面板。 */
+    selectObject(object: THREE.Object3D): MaterialEditorMaterialInfo[];
+    /** 根据当前引擎选择数据读取构件材质。 */
+    selectTarget(target: MaterialEditorTarget): MaterialEditorMaterialInfo[];
+    /** 只读取目标对象材质，不改变当前 UI 选择。 */
+    getMaterialsByObject(object: THREE.Object3D): MaterialEditorMaterialInfo[];
+    /** 只读取指定构件材质，不改变当前 UI 选择。 */
+    getMaterialsByTarget(target: MaterialEditorTarget): MaterialEditorMaterialInfo[];
+    /** 读取当前场景中所有可编辑材质。 */
+    getAllSceneMaterials(): MaterialEditorMaterialInfo[];
+    /** 返回当前选择对象上可编辑的材质信息。 */
+    getSelectedMaterials(): MaterialEditorMaterialInfo[];
+    /** 返回全场景相对快照发生变化的材质信息。 */
+    getModifiedMaterials(): MaterialModificationRecord[];
+    /** 重建当前场景基准快照；通常在模型加载完成后由编辑器自动调用。 */
+    captureSceneSnapshot(): void;
+    /** 批量更新材质参数。 */
+    updateMaterial(materialId: string, patch: Partial<Record<string, unknown>>): void;
+    /** 通过 URL 或 File 修改指定贴图槽；传入 null 时清除贴图。 */
+    setTexture(materialId: string, slot: MaterialMapSlot, source: string | File | null): Promise<void>;
+    /** 一键还原所有有基准快照的场景材质。 */
+    restoreAll(): void;
+    /** 兼容常见命名：重置所有材质修改。 */
+    resetAll(): void;
+    /** 还原单个材质。 */
+    restoreMaterial(materialId: string): void;
+    /** 获取当前面板正在编辑的材质。 */
+    getActiveMaterial(): THREE.Material | null;
+    /** 刷新 DOM 面板。 */
+    render(): void;
+    /** 销毁 DOM、事件监听和编辑器创建的贴图资源。 */
+    dispose(): void;
+    private bindEvents;
+    private setSelectedMaterials;
+    /** 内容完全相同的材质只保留一个卡片，并合并它关联的对象和实际材质实例。 */
+    private dedupeMaterials;
+    private collectSceneMaterials;
+    private findMaterialById;
+    private findMaterialGroupById;
+    private replaceTexture;
+    private loadTexture;
+    private requestRender;
+    private disposeOwnedTextures;
+}
+
 declare class Measure {
     private isActive;
     private engine;
@@ -5546,6 +5730,9 @@ declare class ModelEdge {
     private indexes;
     private highlightIndexes;
     private highlightEdgeSyncVersion;
+    private explodeHidden;
+    private groupVisibleBeforeExplode;
+    private highlightVisibleBeforeExplode;
     private getModelEntry;
     private getOrCreateItemIndex;
     private getEdgePointsByIndex;
@@ -5556,6 +5743,8 @@ declare class ModelEdge {
     disActive(): void;
     isEnabled(): boolean;
     getOpacity(): number;
+    /** 炸开期间临时隐藏所有边线；退出炸开时恢复进入炸开前的可见状态。 */
+    setExplodeHidden(hidden: boolean): void;
     update(): void;
     private hasPendingModelEdges;
     private loadZipJsonAsync;
@@ -5579,6 +5768,242 @@ declare class ModelEdge {
     showModelEdge(url: string, id: Number): void;
 }
 
+/**
+ * 模型炸开管理器。
+ *
+ * 设计目标：
+ * 1. 炸开期间不直接修改原始构件顶点，而是创建临时代理网格承载位移。
+ * 2. 代理对象保留原始 url/id，点选、高亮、显隐、框选和双击定位仍按完整构件工作。
+ * 3. 原始渲染对象被临时隐藏或拆分隐藏，避免原位模型与代理模型重复显示。
+ * 4. 炸开期间临时隐藏边线，避免边线与代理模型出现错位。
+ */
+declare class ModelExplode {
+    private engine;
+    /** 当前是否处于炸开模式；供外部滑块、交互模块判断是否需要走代理逻辑。 */
+    private active;
+    /** 当前炸开倍数。真实代理位移 = record.offsetLocal * factor。 */
+    private factor;
+    /** 本轮炸开创建的所有代理记录，按渲染片段保存。 */
+    private records;
+    /** 非空时表示动画仍在推进，EngineKernel 每帧会调用 update。 */
+    private animation;
+    /** 炸开期间被临时隐藏的高亮/透明/自定义颜色运行时对象，reset 时恢复可见性。 */
+    private hiddenRuntimeObjects;
+    /** 炸开代理专用高亮材质，避免复用原高亮对象导致位置不同步。 */
+    private readonly highlightMaterial;
+    /** 炸开代理专用半透明材质，与原模型透明状态保持一致。 */
+    private readonly translucentMaterial;
+    /** 初始化代理材质，并继承当前剖切平面配置。 */
+    constructor(engine: any);
+    /**
+     * 启动炸开模式。
+     *
+     * 流程：
+     * 1. 清理上一轮代理并恢复边线显示状态，保证重复调用不会叠加状态。
+     * 2. 解析目标构件，未指定 targets 时默认对所有已加载模型执行整模型炸开。
+     * 3. 基于目标包围盒计算每个构件的基础世界位移 offsetWorld。
+     * 4. 为普通网格或实例网格创建代理对象，并隐藏对应原始渲染片段。
+     * 5. 同步当前高亮、隐藏、半透明、自定义颜色状态，并在炸开期间隐藏边线。
+     */
+    explode(options?: ModelExplodeOptions): void;
+    /**
+     * 设置炸开系数，常用于外部滑杆实时控制。
+     *
+     * factor 只改变代理 position，不重新创建代理，因此拖动滑块时不会破坏
+     * 构件的交互身份和材质状态。
+     */
+    setFactor(factor: number): void;
+    /**
+     * 每帧推进炸开动画；由 EngineKernel 的主渲染循环调用。
+     * 动画本质上只是在 from/to 之间插值 factor，最终仍复用 setFactor 的统一同步链路。
+     */
+    update(): void;
+    /**
+     * 清理炸开代理并按当前构件状态恢复原始渲染对象。
+     *
+     * reset 不简单地把所有原对象显示出来，而是重新检查隐藏/高亮/半透明/自定义颜色状态，
+     * 避免用户在炸开期间执行显隐或改色后，退出炸开时丢失业务状态。
+     */
+    reset(): void;
+    /** 释放炸开管理器持有的专用材质，通常由 EngineKernel 销毁时调用。 */
+    dispose(): void;
+    /** 返回当前是否处于炸开模式。 */
+    isActive(): boolean;
+    /**
+     * 判断某个构件是否已由炸开代理接管。
+     * 八叉树、拾取和框选逻辑可据此跳过原位对象，避免命中已隐藏但仍存在于场景中的源构件。
+     */
+    hasRecord(url: string, id: any): boolean;
+    /**
+     * 从命中的代理对象还原真实构件 ID，避免 Object3D.name 字符串化造成 nodesMap 查询失败。
+     */
+    getObjectComponentId(object: any): string | number | null;
+    /**
+     * 返回炸开后用于悬浮高亮的代理网格。
+     * 一个构件可能拆成多个代理片段，调用方应把返回数组整体当作一个完整构件处理。
+     */
+    getCatchMeshes(url: string, id: any): THREE.Mesh[];
+    /**
+     * 返回炸开后的构件世界包围盒，供框选、双击定位等交互使用。
+     * 这里以代理对象的实时 matrixWorld 为准，因此滑块拖动和动画过程中也能得到正确位置。
+     */
+    getExplodedWorldBox(url: string, id: any): THREE.Box3 | null;
+    /**
+     * 对炸开代理做独立射线拾取；返回结构与 three.js Raycaster 结果兼容。
+     * 调用方命中代理后，需要再通过 getObjectComponentId 还原真实构件 id。
+     */
+    raycast(raycaster: THREE.Raycaster): THREE.Intersection[];
+    /**
+     * 同步当前高亮、隐藏、半透明和自定义颜色状态到炸开代理。
+     * 该方法在模型工具模块改变状态后调用，保证炸开期间仍支持完整构件交互。
+     */
+    syncVisualState(): void;
+    private resolveTargets;
+    /**
+     * 构建本轮炸开需要的空间上下文。
+     * 这里提前缓存整体包围盒、模型中心和分组包围盒，避免每个构件重复遍历 nodesMap。
+     */
+    private buildExplodeContext;
+    /**
+     * 计算单个构件或分组的基础世界位移。
+     *
+     * radial/type/major 模式按爆炸原点到构件中心的原始向量移动：
+     * newCenter = origin + (center - origin) * (1 + factor)，
+     * 因此真正应用到代理上的位移是 (center - origin) * factor。
+     */
+    private computeOffset;
+    /** 获取本模型的爆炸原点；优先使用业务传入的世界坐标 origin。 */
+    private getExplodeCenter;
+    /**
+     * 根据构件索引创建一条炸开记录。
+     * node.indexes 中的每一项对应一个普通合并网格 group 或一个 InstancedMesh 实例。
+     */
+    private createRecord;
+    /** 为普通合并网格中的单个构件片段创建代理网格。 */
+    private createMeshProxy;
+    /**
+     * 为 InstancedMesh 中的单个实例创建代理网格。
+     * 实例矩阵会被烘焙进 geometry，后续炸开只移动代理 position，拾取也按普通 Mesh 处理。
+     */
+    private createInstanceProxy;
+    /** 给代理对象写入稳定交互身份，避免依赖 name 的字符串化 id。 */
+    private assignProxyIdentity;
+    /**
+     * 隐藏源渲染片段，避免与代理对象重复显示。
+     * 普通合并网格通过重建 geometry groups 隐藏局部片段，实例网格通过零缩放矩阵隐藏单个实例。
+     */
+    private hideSource;
+    /**
+     * 恢复源渲染片段。
+     * 如果构件在炸开期间仍处于隐藏、高亮、半透明或自定义颜色状态，实例源对象继续保持隐藏，
+     * 由对应状态对象负责显示，避免 reset 后出现原模型和状态模型叠加。
+     */
+    private restoreSource;
+    /**
+     * 确保普通合并网格已进入可按构件片段控制的拆分状态。
+     * 第一次拆分时保存原始片段状态，后续重复同步不覆盖 sourceState。
+     */
+    private ensureSplitState;
+    /**
+     * 根据每个构件片段的可见性和材质槽位重建 geometry groups。
+     * 连续且材质一致的片段会被合并成一个 group，减少炸开期间状态切换带来的 draw call。
+     */
+    private rebuildSplitModelGroups;
+    /**
+     * 将业务状态映射到代理对象。
+     * 代理对象不能依赖原场景中的高亮/透明临时对象，因为那些对象仍位于原模型位置。
+     */
+    private applyProxyVisualState;
+    /**
+     * 生成代理专用自定义颜色材质。
+     * 颜色和透明度相同的请求复用 record.customMaterial，避免滑块或状态同步时反复创建材质。
+     */
+    private getCustomMaterial;
+    /**
+     * 隐藏原模型位置上的运行时状态对象。
+     * 高亮、半透明和自定义颜色模块通常会创建额外 mesh；炸开时这些 mesh 不会自动跟随代理，
+     * 因此这里临时隐藏它们，并由代理自己承载相同视觉状态。
+     */
+    private hideRuntimeObjectsForExplodedRecords;
+    /** 恢复 hideRuntimeObjectsForExplodedRecords 临时隐藏的运行时对象。 */
+    private restoreRuntimeObjects;
+    /** 从场景中移除代理对象，并释放代理持有的 geometry 和材质资源。 */
+    private removeProxy;
+    /**
+     * 克隆源材质用于代理。
+     * 当前普通构件代理以主材质为准；高亮、半透明和自定义颜色会在 applyProxyVisualState 中覆盖。
+     */
+    private cloneProxyMaterial;
+    /**
+     * 读取构件节点的世界包围盒。
+     * 节点 box 通常是模型局部坐标，返回前统一乘以模型组的 matrixWorld。
+     */
+    private getNodeWorldBox;
+    /** 计算单个模型在世界坐标下的整体包围盒，作为默认爆炸原点的依据。 */
+    private getModelWorldBox;
+    /** 兼容数字 id 和字符串 id 的 nodesMap 查询。 */
+    private getNode;
+    /** 按 url 从引擎模型列表中查找模型条目。 */
+    private getEngineModel;
+    /**
+     * 获取分组 key。
+     * radial/axis 使用构件自身作为分组；level/type/major 使用映射信息让同组构件共享位移方向。
+     */
+    private getGroupKey;
+    /**
+     * 获取 InstancedMesh 单个实例的原始矩阵。
+     * 优先读取加载器缓存的 matrixsClone/matrixs，避免 getMatrixAt 读到已被隐藏流程改写后的零矩阵。
+     */
+    private getInstanceMatrix;
+    /**
+     * 将世界坐标位移转换成某个父节点下的局部位移。
+     * 代理对象挂在源 mesh 的父节点下，直接使用世界位移会在模型组存在变换时产生偏差。
+     */
+    private worldDeltaToLocalDelta;
+    /** 判断构件当前是否处于高亮状态。 */
+    private isHighlighted;
+    /** 判断构件当前是否处于隐藏状态。 */
+    private isHidden;
+    /** 判断构件当前是否处于半透明状态。 */
+    private isTranslucent;
+    /**
+     * reset 时判断实例源对象是否仍应保持隐藏。
+     * 某些状态由独立运行时对象或代理承担显示，如果直接恢复原实例会造成重复显示。
+     */
+    private shouldKeepOriginalInstanceHidden;
+    /** 统一比较构件 id，兼容业务侧传入数字或字符串。 */
+    private isSameId;
+    /** 归一化炸开系数，非法值按 0 处理，负数不允许反向收缩。 */
+    private normalizeFactor;
+    /** 将任意值转为稳定数字，用于 level 模式缺少可靠排序时生成确定性偏移。 */
+    private getStableNumber;
+}
+
+export declare type ModelExplodeAxis = 'x' | 'y' | 'z';
+
+export declare type ModelExplodeMode = 'radial' | 'axis' | 'level' | 'type' | 'major';
+
+/**
+ * 炸开配置。
+ * factor 表示炸开位移倍数：0 为原位，1 为基础位移，2 为基础位移的两倍。
+ * origin 用世界坐标表达，未传时默认使用模型自身包围盒中心。
+ */
+export declare type ModelExplodeOptions = {
+    targets?: ModelExplodeTarget[];
+    factor?: number;
+    mode?: ModelExplodeMode;
+    axis?: ModelExplodeAxis;
+    origin?: THREE.Vector3;
+    animate?: boolean;
+    duration?: number;
+};
+
+/** 炸开目标。未传 ids 时表示对该 url 下的所有构件执行炸开。 */
+export declare type ModelExplodeTarget = {
+    url: string;
+    ids?: Array<string | number>;
+};
+
 /**
  * 通过 window CustomEvent 实现同页面内多个 3D 引擎实例的轻量联动。
  */
@@ -5616,6 +6041,8 @@ declare class ModelLink3d {
     isApplyingLinkedEvent(): boolean;
     dispose(): void;
     private normalizeOptions;
+    /** 模型联动开启后需要持续响应外部视图变化，不能进入空闲限帧。 */
+    private syncIdleFrameRateExempt;
     private createViewerGuid;
     private wrapModelToolMethods;
     private restoreModelToolMethods;
@@ -5907,6 +6334,8 @@ declare class ModelToolModule {
     private getModelGuids;
     private restoreSplitModelsOnIdle;
     getSceneModel(index: number): any;
+    /** 炸开模式下，原模型状态变化后需要同步到代理构件，保证交互语义一致。 */
+    private syncExplodeVisualState;
     getModelCenter(models?: any[]): THREE.Vector3 | null;
     updateMaterial(): void;
     private syncHighlightModelEdges;
@@ -6642,6 +7071,8 @@ declare interface PerformanceStats {
 /** 启动四点捕捉校准所需参数。 */
 export declare interface PointCalibrationOptions {
     url: string;
+    /** 四点采集完成并应用校准后触发。 */
+    onChange?: CalibrationChangeCallback;
 }
 
 /**
@@ -7324,6 +7755,8 @@ export declare interface SegmentCalibrationOptions {
     url: string;
     source: CalibrationSegmentInput;
     target: CalibrationSegmentInput;
+    /** 校准成功后返回当前模型的偏移、旋转和矩阵，便于业务侧保存手动调节结果。 */
+    onChange?: CalibrationChangeCallback;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iflow-engine-base",
-  "version": "3.12.3",
+  "version": "3.12.5",
   "description": "BIM Engine SDK for Vue2, Vue3, React and HTML",
   "main": "./dist/bim-engine-sdk.umd.js",
   "module": "./dist/bim-engine-sdk.es.js",