iflow-engine-base 3.12.3 → 3.12.4

package/dist/chunks/{engine-720-pqkCEN7l.js → engine-720-Bk8EPFS9.js}

@@ -1,5 +1,5 @@
 import { n as R, at as S, h as E, aN as b, j as x, t as A, E as k, Q as F, p as I, W as y, a as v, T as f, i as P, Y as m, V as p, b as D } from "./three-vendor-Bx2tSp_D.js";
-import { C as L, W as w, E as T, c as z, r as _ } from "./sdk-runtime-Bw8B0I-e.js";
+import { C as L, W as w, E as T, c as z, r as _ } from "./sdk-runtime-B4l79tmQ.js";
 class V {
   scene;
   panoramaSphere = null;

package/dist/chunks/{engine-gaussian-B4ULOHAm.js → engine-gaussian-3AV9YIVN.js}

@@ -1,5 +1,5 @@
 import { n as Js, C as st, t as Zs, V as v, b as N, O as $s, W as en, M as J, Q as ge, a as tn, f as qt, j as be, B as sn, h as ft, r as it, aO as ze, aP as Pt, aQ as at, X as Bt, aR as ms, aS as yn, aT as xn, aU as In, aV as Tn, U as wn, aW as En, aX as Bn, l as lt, aY as As, aZ as gs, a_ as vn, k as Cs, a$ as Fn, aw as Je, at as Ss, D as Kt, aj as bn, aN as ys, q as Dn, y as We, b0 as qe, aB as xs, s as Mn, b1 as Rn, a9 as Pn, b2 as On, b3 as nn, aD as Is, b4 as kn, ag as Ln, b5 as Ne, b6 as mt, p as Hn } from "./three-vendor-Bx2tSp_D.js";
-import { C as Un, c as zn, E as _n, r as Qn } from "./sdk-runtime-Bw8B0I-e.js";
+import { C as Un, c as zn, E as _n, r as Qn } from "./sdk-runtime-B4l79tmQ.js";
 var De = /* @__PURE__ */ ((m) => (m.LoadStart = "gaussian-load-start", m.LoadProgress = "gaussian-load-progress", m.Loaded = "gaussian-loaded", m.LoadError = "gaussian-load-error", m.SceneRemoved = "gaussian-scene-removed", m.FpsUpdated = "gaussian-fps-updated", m.ViewChanged = "gaussian-view-changed", m))(De || {});
 class Nn {
   listeners = /* @__PURE__ */ new Map();

package/dist/chunks/{engine-gis-Cx9rI4U4.js → engine-gis-j4GvT41d.js}

@@ -1,6 +1,6 @@
-import { g as xX, J as KN } from "./sdk-vendor-DwLu476l.js";
+import { g as xX, J as KN } from "./sdk-vendor-VZI0bEcg.js";
 import { b7 as Ii, b8 as TX } from "./three-vendor-Bx2tSp_D.js";
-import { l as vX, L as EX, E as CX, d as JN, e as wX, c as $C, a as SX, f as IX, r as DX, h as XC } from "./sdk-runtime-Bw8B0I-e.js";
+import { l as vX, L as EX, E as CX, d as JN, e as wX, c as $C, a as SX, f as IX, r as DX, h as XC } from "./sdk-runtime-B4l79tmQ.js";
 var QN = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
 function Fb(e) {
   return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;

package/dist/chunks/{sdk-assets-bsmej2W5.js → sdk-assets-Cr-wEweL.js}

@@ -2,7 +2,7 @@ import { b9 as w } from "./three-vendor-Bx2tSp_D.js";
 const S = "__BIM_ENGINE_SDK_ASSET_BASE__", b = "__BIM_ENGINE_SDK_ASSET_FILE_MAP__", g = "__BIM_ENGINE_SDK_ASSET_FILE_URLS__", A = "__BIM_ENGINE_SDK_ASSET_FILE_SESSION__", j = "https://unpkg.com/iflow-engine-base@3.9.20/dist/", L = "https://__bim_engine_sdk_asset__/", M = ["assets/", "fonts/", "draco/", "basis/", "texture/", "prompt/"];
 let _ = null;
 async function R() {
-  return _ || (_ = import("./sdk-vendor-DwLu476l.js").then((t) => t.j).then((t) => t.default ?? t)), _;
+  return _ || (_ = import("./sdk-vendor-VZI0bEcg.js").then((t) => t.j).then((t) => t.default ?? t)), _;
 }
 function a() {
   return typeof globalThis < "u" ? globalThis : null;

package/dist/chunks/{sdk-runtime-Bw8B0I-e.js → sdk-runtime-B4l79tmQ.js}

@@ -1,5 +1,5 @@
 import { R as ve, b as B, V as ce, t as Te, ba as Ce } from "./three-vendor-Bx2tSp_D.js";
-import { a as pe, J as ne, p as Ae, l as J } from "./sdk-vendor-DwLu476l.js";
+import { a as pe, J as ne, p as Ae, l as J } from "./sdk-vendor-VZI0bEcg.js";
 class It {
   /**
    * 构造函数
@@ -1056,7 +1056,7 @@ class jt {
     e.stopImmediatePropagation();
   };
 }
-const ot = "3.12.3", st = {
+const ot = "3.12.4", st = {
   version: ot
 }, V = st.version;
 function se() {

package/dist/chunks/{sdk-vendor-DwLu476l.js → sdk-vendor-VZI0bEcg.js}

@@ -1,4 +1,4 @@
-import { c as ja, g as X0, a as f1 } from "./engine-gis-Cx9rI4U4.js";
+import { c as ja, g as X0, a as f1 } from "./engine-gis-j4GvT41d.js";
 function d1(t, e) {
   for (var r = 0; r < e.length; r++) {
     const i = e[r];

package/dist/index.d.ts

@@ -2480,6 +2480,8 @@ declare class EngineKernelV2 {
     modelPlace: ModelPlace;
     /** 基于当前引擎作为基准版本的模型差异比较器。 */
     modelComparison: ModelComparison;
+    /** 管理模型炸开代理对象，并保持炸开后的构件交互身份。 */
+    modelExplode: ModelExplode;
     models: any[];
     reactBoundingClientRect: {
         left: number;
@@ -4022,6 +4024,9 @@ declare class InteractionModule {
     private intersectsRect;
     private getMergedBox;
     private getSceneModel;
+    /** 从射线命中的对象还原真实构件 ID，兼容炸开代理和普通模型对象。 */
+    private getHitModelId;
+    private getEngineNode;
 }
 
 declare class InteractionModule2d {
@@ -5546,6 +5551,9 @@ declare class ModelEdge {
     private indexes;
     private highlightIndexes;
     private highlightEdgeSyncVersion;
+    private explodeHidden;
+    private groupVisibleBeforeExplode;
+    private highlightVisibleBeforeExplode;
     private getModelEntry;
     private getOrCreateItemIndex;
     private getEdgePointsByIndex;
@@ -5556,6 +5564,8 @@ declare class ModelEdge {
     disActive(): void;
     isEnabled(): boolean;
     getOpacity(): number;
+    /** 炸开期间临时隐藏所有边线；退出炸开时恢复进入炸开前的可见状态。 */
+    setExplodeHidden(hidden: boolean): void;
     update(): void;
     private hasPendingModelEdges;
     private loadZipJsonAsync;
@@ -5579,6 +5589,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 引擎实例的轻量联动。
  */
@@ -5907,6 +6153,8 @@ declare class ModelToolModule {
     private getModelGuids;
     private restoreSplitModelsOnIdle;
     getSceneModel(index: number): any;
+    /** 炸开模式下，原模型状态变化后需要同步到代理构件，保证交互语义一致。 */
+    private syncExplodeVisualState;
     getModelCenter(models?: any[]): THREE.Vector3 | null;
     updateMaterial(): void;
     private syncHighlightModelEdges;

package/package.json

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