iflow-engine-base 3.10.1 → 3.10.2

package/dist/chunks/{three-vendor-BislQYFI.js → three-vendor-DTqpDaJq.js}

@@ -43353,7 +43353,7 @@ Mi.add.bind(Mi);
 Mi.remove.bind(Mi);
 Mi.update.bind(Mi);
 export {
-  O1 as $,
+  U1 as $,
   yv as A,
   Ve as B,
   Ae as C,
@@ -43374,76 +43374,78 @@ export {
   b0 as R,
   li as S,
   r0 as T,
-  F1 as U,
+  Xt as U,
   T as V,
   bI as W,
-  N1 as X,
-  Gi as Y,
-  tr as Z,
-  U1 as _,
+  F1 as X,
+  N1 as Y,
+  Gi as Z,
+  tr as _,
   pd as a,
-  Oh as a0,
-  tc as a1,
-  Q1 as a2,
-  xr as a3,
+  q1 as a$,
+  O1 as a0,
+  Oh as a1,
+  tc as a2,
+  Q1 as a3,
   k1 as a4,
   oi as a5,
   kd as a6,
   o0 as a7,
-  Wn as a8,
-  Tf as a9,
-  kn as aA,
-  Cn as aB,
-  Eh as aC,
-  Kn as aD,
-  Tt as aE,
-  qe as aF,
-  yt as aG,
-  Yo as aH,
-  I0 as aI,
-  Es as aJ,
-  Si as aK,
-  Fl as aL,
-  Ll as aM,
-  hh as aN,
-  ec as aO,
-  Vb as aP,
-  h0 as aQ,
-  xx as aR,
-  cr as aS,
-  Ht as aT,
-  Ms as aU,
-  Je as aV,
-  ro as aW,
-  vo as aX,
-  j1 as aY,
-  q1 as aZ,
-  G1 as aa,
-  Km as ab,
-  Rt as ac,
-  Im as ad,
-  k_ as ae,
-  bd as af,
-  Rn as ag,
-  V1 as ah,
-  hi as ai,
-  H1 as aj,
-  po as ak,
-  zf as al,
-  ph as am,
-  Ra as an,
-  on as ao,
+  on as a8,
+  Wn as a9,
+  Bt as aA,
+  kn as aB,
+  Cn as aC,
+  Eh as aD,
+  Kn as aE,
+  Tt as aF,
+  qe as aG,
+  yt as aH,
+  Yo as aI,
+  I0 as aJ,
+  Es as aK,
+  Si as aL,
+  Fl as aM,
+  Ll as aN,
+  hh as aO,
+  ec as aP,
+  Vb as aQ,
+  h0 as aR,
+  xr as aS,
+  xx as aT,
+  cr as aU,
+  Ht as aV,
+  Ms as aW,
+  Je as aX,
+  ro as aY,
+  vo as aZ,
+  j1 as a_,
+  Tf as aa,
+  G1 as ab,
+  Km as ac,
+  Rt as ad,
+  Im as ae,
+  k_ as af,
+  bd as ag,
+  Rn as ah,
+  V1 as ai,
+  hi as aj,
+  H1 as ak,
+  po as al,
+  zf as am,
+  ph as an,
+  Ra as ao,
   Kd as ap,
-  at as aq,
-  z1 as ar,
-  W1 as as,
-  r1 as at,
-  Mg as au,
-  iv as av,
-  vd as aw,
-  ws as ax,
-  qt as ay,
-  Bt as az,
+  mh as aq,
+  at as ar,
+  z1 as as,
+  W1 as at,
+  r1 as au,
+  Mg as av,
+  iv as aw,
+  vd as ax,
+  ws as ay,
+  qt as az,
   Y as b,
   zh as c,
   fr as d,

package/dist/index.d.ts

@@ -640,9 +640,6 @@ declare class CameraModuleGaussian {
     dispose(): void;
 }
 
-/**
- * 相机姿态信息
- */
 declare interface CameraPose {
     theta: number;
     phi: number;
@@ -1415,6 +1412,7 @@ declare interface DWGMetadata {
  */
 declare interface Engine2dOptions {
     containerId: string;
+    interactionMode?: EngineInteractionMode;
     backgroundColor?: number;
     gridEnabled?: boolean;
     axesEnabled?: boolean;
@@ -1439,43 +1437,25 @@ declare interface Engine2dOptions {
     showMouseCoordinates?: boolean;
 }
 
-/**
- * 720 全景引擎配置选项
- */
 declare interface Engine720Options {
-    /** 容器 ID */
     containerId: string;
-    /** 覆盖 SDK 内置资源根路径，默认使用固定 CDN。 */
+    interactionMode?: EngineInteractionMode;
     assetBaseUrl?: string;
-    /** 初始视野角度（默认 75） */
     fov?: number;
-    /** 是否启用缩放（默认 true） */
     enableZoom?: boolean;
-    /** 是否启用旋转（默认 true） */
     enableRotate?: boolean;
-    /** 最小 FOV（默认 30，最大缩放） */
     minFov?: number;
-    /** 最大 FOV（默认 90，最小缩放） */
     maxFov?: number;
-    /** 球体半径（默认 500） */
     sphereRadius?: number;
-    /** 旋转速度（默认 0.5） */
     rotateSpeed?: number;
-    /** 缩放速度（默认 1.0） */
     zoomSpeed?: number;
-    /** 是否启用阻尼效果（默认 true） */
     enableDamping?: boolean;
-    /** 阻尼系数（默认 0.05） */
     dampingFactor?: number;
 }
 
-/**
- * Gaussian 高斯点云引擎配置项。
- * 结构参考 core720，由 EngineKernel 统一装配各模块。
- */
 declare interface EngineGaussianOptions {
     containerId: string;
-    /** 覆盖 SDK 内置资源根路径，默认使用固定 CDN。 */
+    interactionMode?: EngineInteractionMode;
     assetBaseUrl?: string;
     cameraUp?: GaussianVector3;
     initialCameraPosition?: GaussianVector3;
@@ -1490,26 +1470,19 @@ declare interface EngineGaussianOptions {
     viewerOptions?: Record<string, any>;
 }
 
-/**
- * GIS 引擎初始化参数。
- * 默认 provider 为 cesium，后续可在不破坏公开 API 的前提下扩展其他地图内核。
- */
 export declare interface EngineGISOptions extends GISContainerOptions {
-    /** 覆盖 SDK 内置资源根路径，默认使用固定 CDN。 */
+    interactionMode?: EngineInteractionMode;
     assetBaseUrl?: string;
     provider?: 'cesium';
     accessToken?: string;
     cesiumBaseUrl?: string;
     imageryUrl?: string;
-    /** Maximum imagery tile level. Higher zooms reuse this level so imagery stays visible, though blurred. */
     imageryMaximumLevel?: number;
     terrainMode?: GISTerrainMode;
     terrain?: GISTerrainOptions;
     initialView?: GISCameraView;
     showCredit?: boolean;
-    /** 是否显示右上角紧凑性能监视器。 */
     showStats?: boolean;
-    /** 性能监视器详细配置，优先级高于 showStats。 */
     performanceMonitor?: boolean | {
         enabled?: boolean;
         updateInterval?: number;
@@ -1537,6 +1510,8 @@ declare class EngineInfo {
     };
 }
 
+export declare type EngineInteractionMode = 'standard' | 'browse';
+
 declare class EngineKernel2d {
     private options;
     private container;
@@ -1577,6 +1552,7 @@ declare class EngineKernel2d {
     renderer: THREE.WebGLRenderer | null;
     dwgData: DWGData | null;
     version: string;
+    private interactionMode;
     constructor(options: Engine2dOptions);
     /**
      * 初始化引擎
@@ -1687,6 +1663,9 @@ declare class EngineKernel2d {
     getZoom(): number;
     /** 刷新右下角版本号展示，便于外部修改 version 后同步 UI。 */
     updateVersionDisplay(): void;
+    setInteractionMode(mode?: EngineInteractionMode): void;
+    getInteractionMode(): EngineInteractionMode;
+    isModelInteractionEnabled(): boolean;
     /**
      * 获取性能统计
      * @returns 性能统计信息
@@ -1763,6 +1742,7 @@ declare class EngineKernel720 {
     worldToScreen: WorldToScreen;
     private isInitialized;
     private readonly version;
+    private interactionMode;
     constructor(options: Engine720Options);
     /**
      * 初始化引擎
@@ -1876,6 +1856,8 @@ declare class EngineKernel720 {
      * 获取版本
      */
     getVersion(): string;
+    setInteractionMode(mode?: EngineInteractionMode): void;
+    getInteractionMode(): EngineInteractionMode;
     /**
      * 销毁引擎
      */
@@ -1900,8 +1882,11 @@ declare class EngineKernelGaussian {
     private isInitialized;
     private readonly options;
     private readonly version;
+    private interactionMode;
     constructor(options: EngineGaussianOptions);
     private initialize;
+    setInteractionMode(mode?: EngineInteractionMode): void;
+    getInteractionMode(): EngineInteractionMode;
     loadModel(url: string, options?: GaussianSceneOptions): Promise<GaussianSceneInfo>;
     /**
      * 通过 viewToken 解析 Gaussian 资源地址，再复用现有 URL 加载逻辑。
@@ -1938,6 +1923,7 @@ export declare class EngineKernelGIS {
     private isInitialized;
     private readonly version;
     private cameraChangedHandler?;
+    private interactionMode;
     constructor(options: EngineGISOptions);
     /**
      * 初始化 GIS 引擎。
@@ -2072,6 +2058,8 @@ export declare class EngineKernelGIS {
      * 获取 GIS 模块版本。
      */
     getVersion(): string;
+    setInteractionMode(mode?: EngineInteractionMode): void;
+    getInteractionMode(): EngineInteractionMode;
     /**
      * 销毁 GIS 引擎。
      */
@@ -2168,9 +2156,13 @@ declare class EngineKernelV2 {
     };
     version: string;
     private versionEl;
+    private interactionMode;
     private container;
     constructor(options: any);
     updateVersionDisplay(): void;
+    setInteractionMode(mode?: EngineInteractionMode): void;
+    getInteractionMode(): EngineInteractionMode;
+    isModelInteractionEnabled(): boolean;
     /**
      * 通过 viewToken 解析 3D 模型地址，再复用现有 loaderModule URL 加载逻辑。
      */
@@ -2366,6 +2358,7 @@ declare class EngineStatus {
     isFree: boolean;
     isForceFree: boolean;
     isDisableContextMenu: boolean;
+    modelInteractionEnabled: boolean;
     disableModelInteractionHighlight: boolean;
     highlightModels: any[];
     hideModels: any[];
@@ -2974,9 +2967,6 @@ export declare interface GISCalibrationOptions {
     rotationUnit?: 'radians' | 'degrees';
 }
 
-/**
- * GIS 视角参数，统一使用 WGS84 经纬度。
- */
 export declare interface GISCameraView {
     longitude: number;
     latitude: number;
@@ -2986,10 +2976,6 @@ export declare interface GISCameraView {
     roll?: number;
 }
 
-/**
- * GIS 引擎容器配置。
- * 优先支持 HTMLElement，保留 containerId 以贴近 core720 的调用习惯。
- */
 declare interface GISContainerOptions {
     container?: HTMLElement;
     containerId?: string;
@@ -3004,9 +2990,6 @@ export declare interface GISElevationCalibrationOptions {
     heightOffset: number;
 }
 
-/**
- * GIS 事件回调类型。
- */
 export declare type GISEventCallback<T = unknown> = (data: T) => void;
 
 declare type GISGeographicOffset = {
@@ -3534,9 +3517,6 @@ declare interface IDrawingPinState {
     capturePoint?: IDrawingPinCapturePoint | null;
 }
 
-/**
- * GIS 事件模块对外契约。
- */
 export declare interface IGISEventModule {
     on<T = unknown>(event: EventTypeGIS_2 | string, callback: GISEventCallback<T>): void;
     off<T = unknown>(event: EventTypeGIS_2 | string, callback: GISEventCallback<T>): void;
@@ -3561,6 +3541,8 @@ declare class InteractionModule {
     init(): void;
     active(): void;
     disActive(): void;
+    isModelInteractionEnabled(): boolean;
+    shouldSkipRaycast(): boolean;
     dispose(): void;
     handelKeyCtrlUp(): void;
     handelKeyCtrlDown(): void;
@@ -3613,6 +3595,7 @@ declare class InteractionModule2d {
     init(): void;
     active(): void;
     disActive(): void;
+    shouldSkipRaycast(): boolean;
     private oldId;
     handleMouseMove(event: any): void;
     handelKeyEscDown(_event: any): void;
@@ -3626,9 +3609,6 @@ declare class InteractionModule2d {
     dispose(): void;
 }
 
-/**
- * 交互灵敏度等动态配置
- */
 declare interface InteractionOptions720 {
     rotateSpeed?: number;
     zoomSpeed?: number;
@@ -4096,6 +4076,10 @@ declare interface LevelLocationResult {
     isInside: boolean;
 }
 
+/**
+ * 管理场景基础光照和动态阴影相机范围。
+ * 主要职责是创建环境光、补光、投影灯，并随视图和模型范围更新阴影覆盖区域。
+ */
 declare class LightModule {
     private engine;
     private lastShadowHalfSize;
@@ -4103,24 +4087,133 @@ declare class LightModule {
     private lastShadowFar;
     private lastLightPosition;
     private lastLightTarget;
+    private lastShadowIntensity;
+    private shadowCasterPolicyChecked;
+    private lastShadowCasterPolicySceneSize;
+    /**
+     * 创建光照模块。
+     * @param engine BIM 引擎实例，内部会从中读取 scene、controls、octreeBox 等对象。
+     */
     constructor(engine: any);
-    /** 初始化场景基础光照，并保留投影灯的稳定引用。 */
+    /**
+     * 初始化场景基础光照，并把投影灯引用挂到 scene 上供后续更新使用。
+     */
     init(): void;
-    /** 兼容旧调用名：更新定向光阴影的有效覆盖范围。 */
+    /**
+     * 兼容旧调用名：更新定向光阴影的有效覆盖范围。
+     * @param camera 当前渲染相机；传 null 时只按场景范围或默认值更新。
+     */
     updateShadowCameraRange(camera: THREE.Camera | null): void;
-    /** 根据当前视图和模型范围移动投影灯、target 与阴影相机。 */
+    /**
+     * 根据当前视图和模型范围移动投影灯、target 与阴影相机。
+     * @param camera 当前渲染相机，用于估算屏幕可视范围；传 null 时退回到场景范围。
+     */
     updateDirectionalShadow(camera: THREE.Camera | null): void;
+    /**
+     * 计算场景范围对阴影相机半边长的贡献。
+     * @param sceneHalfExtent 场景包围盒最大边的一半，单位为世界坐标。
+     * @param cameraHalfExtent 当前相机可视范围最大半边长，单位为世界坐标。
+     * @returns 阴影相机应考虑的场景半边长。
+     */
     private getSceneShadowHalfSize;
+    /**
+     * 根据阴影相机范围动态调整 bias，平衡阴影条纹和阴影悬浮。
+     * @param light 负责投影的定向光。
+     * @param shadowHalfSize 阴影正交相机半边长，单位为世界坐标。
+     * @param shadowDepthRange 阴影相机深度范围。
+     */
     private updateShadowBias;
+    /**
+     * 计算阴影相机沿光照方向的 near/far 范围。
+     * @param sceneBox 当前场景包围盒；为 null 时使用兜底范围。
+     * @param lightPosition 投影灯世界坐标。
+     * @param target 投影灯 target 世界坐标。
+     * @param sceneDepth 场景包围盒对角线长度，用于兜底 far 估算。
+     * @param shadowHalfSize 阴影相机半边长，用于兜底 far 估算。
+     * @returns 阴影相机深度范围。
+     */
     private getShadowDepthRange;
+    /**
+     * 获取包围盒 8 个顶点。
+     * @param box 需要拆分顶点的 three.js 包围盒。
+     * @returns 包围盒所有角点的世界坐标数组。
+     */
     private getBoxCorners;
+    /**
+     * 从场景中找到当前负责投影的定向光。
+     * @returns 可投影的 DirectionalLight；找不到时返回 null。
+     */
     private getShadowDirectionalLight;
+    /**
+     * 获取当前场景的有效包围盒。
+     * @returns 有效模型包围盒；场景为空或范围异常时返回 null。
+     */
     private getSceneBoundingBox;
+    /**
+     * 规范化包围盒最小点和最大点，兼容 min/max 顺序被反转的输入。
+     * @param min 原始最小点。
+     * @param max 原始最大点。
+     * @returns 规范化后的包围盒；坐标非法或范围异常时返回 null。
+     */
     private normalizeBox;
+    /**
+     * 校验包围盒是否可用于阴影计算。
+     * @param box 候选包围盒。
+     * @returns 有效包围盒；过小、过大或异常时返回 null。
+     */
     private validateBox;
+    /**
+     * 估算当前相机视图在目标点附近需要覆盖的半边长。
+     * @param camera 当前渲染相机。
+     * @param fallbackTarget 没有 controls.target 时用于估算距离的目标点。
+     * @returns 相机视图最大半边长；没有有效相机时返回 0。
+     */
     private getCameraHalfExtent;
+    /**
+     * 解析阴影应跟随的目标点。
+     * @param camera 当前渲染相机。
+     * @param fallbackTarget 优先级低于 controls.target 的兜底目标点。
+     * @returns 用于定位投影灯 target 的世界坐标。
+     */
     private resolveShadowTarget;
+    /**
+     * 获取投影灯相对 target 的方向。
+     * @returns 标准化后的世界空间光源偏移方向。
+     */
     private getLightOffsetDirection;
+    /**
+     * 根据当前视角和阴影贴图密度计算最终显示强度。
+     * @param camera 当前渲染相机。
+     * @param lightDirection 投影灯相对 target 的方向。
+     * @param shadowHalfSize 阴影正交相机半边长。
+     * @param mapWidth 阴影贴图宽度。
+     * @returns 本帧应使用的阴影强度。
+     */
+    private getShadowDisplayIntensity;
+    /**
+     * 把阴影 target 对齐到阴影贴图 texel 网格。
+     * @param target 原始阴影目标点。
+     * @param lightDirection 投影灯相对 target 的方向。
+     * @param shadowHalfSize 阴影正交相机半边长。
+     * @param mapWidth 阴影贴图宽度。
+     * @returns 对齐后的 target，减少相机远距离移动时的阴影采样抖动和规则纹理。
+     */
+    private snapShadowTargetToTexel;
+    /**
+     * 自动降低大面积薄片构件的投影风险。
+     * @param sceneBox 当前场景包围盒，用于判断场景尺寸是否变化。
+     */
+    private updateShadowCasterPolicy;
+    /**
+     * 对单个 mesh 应用投影策略。
+     * @param mesh 候选投影对象。
+     */
+    private applyShadowCasterPolicy;
+    /**
+     * 对仍参与投影的实体使用背面写入阴影，降低封闭体表面的自投影条纹。
+     * @param material mesh 材质或材质数组。
+     */
+    private setBackSideShadowCasting;
 }
 
 /**
@@ -4192,9 +4285,59 @@ declare interface LoaderModel2d {
 }
 
 declare class LoaderModule {
+    private static localRequestMap;
+    private static localObjectUrls;
+    private static interceptorInstalled;
     private engine;
     constructor(engine: any);
+    /**
+     * 批量加载模型 URL。
+     */
     loadModels(urls: string[], options?: LoadModelOptions): Promise<void>;
+    /**
+     * 直接加载用户在浏览器中选择的本地模型文件。
+     * 支持两种输入：
+     * 1. 直接选择 `info / property / edge / lod0...` 这组模型包文件。
+     * 2. 选择一个外层 zip，zip 内部包含上述模型包文件或解压后的同名目录。
+     */
+    loadModelFile(files: File[], options?: LoadModelOptions): Promise<void>;
+    /**
+     * 把浏览器 File 列表整理成现有加载器可识别的本地虚拟模型入口。
+     */
+    private buildLocalModelEntries;
+    /**
+     * 展开输入文件。
+     * 已经是模型包文件时直接保留；仅把“外层容器 zip”解包成内部条目。
+     */
+    private collectSourceEntries;
+    /**
+     * 识别已经打好的模型包文件，例如 `info`、`lod0.zip`。
+     */
+    private parseDirectPackageEntry;
+    /**
+     * 识别解压后的模型目录，例如 `lod0/nodes.json`、`info/info.json`。
+     */
+    private parseExtractedPackageEntry;
+    /**
+     * 把解压目录重新打包成 zip Blob，复用现有按包加载的实现。
+     */
+    private packEntriesAsZip;
+    /**
+     * 注册 axios 拦截器，把虚拟模型地址改写为对应的 Blob URL。
+     */
+    private static ensureLocalRequestInterceptor;
+    /**
+     * 为某个虚拟请求地址生成 Blob URL 映射。
+     */
+    private static registerLocalRequest;
+    /**
+     * 统一规范虚拟请求 key，兼容传入绝对地址或带 query 的地址。
+     */
+    private static normalizeRequestKey;
+    /**
+     * 生成稳定且不会冲突的本地模型虚拟 ID。
+     */
+    private static createLocalModelId;
 }
 
 declare class LoaderModule2d {