iflow-engine-base 4.0.0 → 4.0.10

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { Path } from 'fabric';
 import { Rect } from 'fabric';
 import { RenderPipeline } from 'three/webgpu';
 import { Resource } from 'cesium';
+import { Scene } from 'three';
 import * as THREE from 'three';
 import { Viewer } from 'cesium';
 import { WebGPURenderer } from 'three/webgpu';
@@ -1824,60 +1825,42 @@ declare class Clipping {
     private setPlaneConstantsHigh;
 }
 
+/** Public V3 clipping facade. Runtime clipping is applied through WebGPU clipping groups. */
 declare class Clipping_2 {
-    private engine;
-    private readonly clippingTolerance;
-    sectionBox: any;
-    sectionFace: any;
+    private readonly engine;
+    private readonly state;
+    private viewRangePlanes;
+    readonly sectionPlane: THREE.Plane[];
+    readonly sectionBox: WebGPUSectionBox;
+    readonly sectionFace: WebGPUSectionFace;
     clippingStencil: any;
-    clippingCSGSimple: ClippingCSGOptimizedSimple_2 | null;
+    clippingCSGSimple: ReturnType<typeof createWebGPUFillAdapter>;
     currentClippingMode: string;
     sectionCatchFace: any;
     fillCutFace: boolean;
-    private viewRangePlanes;
     constructor(engine: any);
     init(): void;
     scaleBox(): void;
-    setFillCutFace(b: boolean): void;
+    setFillCutFace(enabled: boolean): void;
     getFillCutFace(): boolean;
-    clippingModel(models: any): void;
+    clippingModel(models: any[]): void;
     updateClippingValue(value: any): void;
     active(type: string): void;
     disabled(): void;
     recover(): void;
     reverse(): void;
     disActive(): void;
+    /** 释放剖切覆盖层和指针监听。 */
+    dispose(): void;
     isPointInClippingRange(point: any, tolerance?: number): boolean;
     filterIntersectionsByClipping<T extends {
         point?: any;
-    }>(intersections: T[] | null | undefined, tolerance?: number): T[];
-    /**
-     * 判断包围盒是否仍与当前可见剖切区域相交。
-     * 只要包围盒被任一剖切平面完全裁掉，就可以在八叉树阶段提前跳过。
-     */
+    }>(items: T[] | null | undefined, tolerance?: number): T[];
     doesBoxIntersectClippingRange(box: THREE.Box3 | {
         min: any;
         max: any;
     } | null | undefined, tolerance?: number): boolean;
     getClippedBoundingBox(baseBox?: THREE.Box3): THREE.Box3 | null;
-    private getEffectiveClippingPlanes;
-    private toBox3;
-    private getBoxBoundaryPlanes;
-    private intersectThreePlanes;
-    private isPointInsidePlanes;
-    /**
-     * 取包围盒在平面法线方向上的最远顶点；
-     * 如果这个点仍落在平面外侧，说明整个包围盒都已经被该平面剔除。
-     */
-    private isBoxVisibleAgainstPlane;
-    private pushUniquePoint;
-    private isVector3Like;
-    /**
-     * 按视图原点与视线方向设置剖面（用于打开剖面视图）
-     * 剖切面过 origin，法向指向相机侧，并生成与场景包围盒同大的剖切面
-     * @param origin 剖面上的点 {x, y, z}（与视图 Origin 一致）
-     * @param viewDirection 视线方向 {x, y, z}（与视图 ViewDirection 一致）
-     */
     setSectionByView(origin: {
         x: number;
         y: number;
@@ -1887,14 +1870,10 @@ declare class Clipping_2 {
         y: number;
         z: number;
     }): void;
-    /**
-     * 按 Revit 视图范围生成的 6 个平面启用剖切范围。
-     * 平面方向约定为 THREE.Plane 的可见半空间：distanceToPoint(point) >= 0。
-     */
     setSectionPlanesByViewRange(planes: THREE.Plane[]): void;
-    private applyStoredViewRangePlanes;
-    private applySectionPlanesToModelMeshes;
-    private setPlaneConstantsHigh;
+    private toBox3;
+    private getBoxBoundaryPlanes;
+    private intersectThreePlanes;
 }
 
 /**
@@ -2032,140 +2011,7 @@ declare class ClippingCSGOptimizedSimple {
     private getPlaneBasis;
 }
 
-/**
- * ClippingCSGOptimizedSimple
- *
- * 作用：
- * 1. 根据剖切平面，计算模型与“薄片平面体”的 CSG 相交结果。
- * 2. 从相交结果中提取贴近平面的帽面三角形（cap）。
- * 3. 合并 cap 几何并加入场景，作为剖切补面。
- *
- * 设计要点：
- * - 先粗筛（octree box / mesh box），再做重计算（CSG），避免全量布尔运算。
- * - 对补面做极小偏移，避免补面材质本身也挂 clippingPlanes 时被同平面裁掉。
- * - 每次更新前先 clear，保证场景中只存在当前补面。
- */
-declare class ClippingCSGOptimizedSimple_2 {
-    /** 引擎实例（包含 scene / models / engineStatus / octreeBox 等） */
-    private engine;
-    /** three-bvh-csg 计算器，负责执行布尔操作 */
-    private readonly evaluator;
-    /** 场景中补面 Mesh 的统一名前缀 */
-    private readonly fillMeshName;
-    /**
-     * 当前生成的补面集合。
-     * key：平面唯一键（face 或 plane-i-name）
-     * value：对应补面 Mesh
-     */
-    private readonly fillMeshes;
-    /** 单次最多参与 CSG 的候选 Mesh 数量（保护性能） */
-    private readonly maxCandidates;
-    /** 单个 mesh 最大三角面阈值（过大直接跳过，保护实时交互） */
-    private readonly maxTriangleCountPerMesh;
-    /** 补面统一材质（由你在构造器中挂了 clippingPlanes） */
-    private fillMaterial;
-    private readonly fillTextureRepeat;
-    private readonly fillTextureRotation;
-    constructor(engine: any);
-    /**
-     * 清理当前所有补面。
-     * - 从 scene 移除 mesh
-     * - 释放 geometry / material 资源
-     */
-    clear(): void;
-    /**
-     * 单平面补面入口（face/x/y/z 模式可用）。
-     * 每次调用先 clear，再构建当前平面的补面。
-     */
-    updataFace(plane: any): void;
-    /**
-     * 多平面补面入口（box 模式可用）。
-     * 约定：传入的每个合法平面都分别生成一份补面。
-     */
-    updataFaces(planes: any[]): void;
-    /**
-     * 构建某一个平面的补面。
-     *
-     * 主流程：
-     * 1) 拿场景包围盒，确定平面体尺寸。
-     * 2) 基于 octree 与 plane 相交，筛候选 mesh。
-     * 3) 再按 mesh world box 与复杂度做二次筛选。
-     * 4) 对每个候选 mesh 执行 CSG INTERSECTION。
-     * 5) 从交集几何中提取贴近平面的 cap 三角形。
-     * 6) 合并 cap，做轻微偏移，创建补面 mesh。
-     */
-    private buildSinglePlaneFill;
-    /**
-     * 获取补面偏移距离。
-     * - 可通过 engine.engineStatus.clippingFaceOffset 覆盖
-     * - 默认按模型尺度自适应并带最小值
-     */
-    private getFaceOffsetDistance;
-    /**
-     * 获取补面偏移方向。
-     * - 可通过 engine.engineStatus.clippingFaceOffsetSign 指定（1/-1）
-     * - 默认 -1，即沿 -normal 方向偏移
-     */
-    private getFaceOffsetSign;
-    /**
-     * 使用 octree + plane 相交快速收集候选 mesh。
-     *
-     * 过程：
-     * - 遍历 engineStatus.models -> lod.octreeBox
-     * - 只取与 plane 相交的 octree 节点元素 id
-     * - 跳过隐藏/半透明/实例化节点
-     * - 收集节点 infos 里的 mesh，并按 uuid 去重
-     */
-    private collectCandidateMeshesFromOctree;
-    /**
-     * 收集当前 model url 下需要忽略的元素 id（隐藏 + 半透明）。
-     */
-    private getIgnoredIds;
-    /**
-     * 深度遍历 octree，返回与 plane 相交节点中的 element id 集合。
-     */
-    private collectIntersectElementIds;
-    /**
-     * 将引擎 octree 节点坐标转换为 three.js 的 Box3（含单位/坐标系转换）。
-     */
-    private octreeNodeToBox3;
-    /**
-     * 候选 mesh 二次筛选：
-     * - 必须存在有效 position
-     * - 三角面数不能超过阈值
-     * - world bbox 必须与 plane 相交
-     */
-    private filterMeshesByBoxAndComplexity;
-    /**
-     * 构造“薄片平面体” Brush：
-     * - 几何为 BoxGeometry(size, size, thickness)
-     * - 旋转到 plane.normal
-     * - 平移到 plane 上
-     */
-    private createPlaneBrush;
-    /**
-     * 将场景 mesh 转为世界坐标 Brush。
-     */
-    private createWorldBrushFromMesh;
-    /**
-     * 统一 CSG 输入属性，避免属性不一致报错（例如 uv 缺失）。
-     * 目标属性固定为：position / normal / uv
-     */
-    private toCsgReadyGeometry;
-    /**
-     * 从 CSG 相交结果中提取补面三角形。
-     *
-     * 判定条件：
-     * - 三角形法线与 plane.normal 足够平行（|dot| >= 0.9）
-     * - 三角形顶点到平面的距离 spread 足够小
-     * - 三角形平均距离落在薄片附近，且位于有效侧
-     *
-     * 提取后将三角形顶点投影回 plane，保证补面共面。
-     */
-    private extractPlaneCapGeometry;
-    private applyPlanarUv;
-    private getPlaneBasis;
-}
+declare type ClippingMode = 'x' | 'y' | 'z' | 'box' | 'face' | 'viewRange' | '';
 
 declare class Collector {
     private engine;
@@ -2227,6 +2073,10 @@ declare class ComposerModule_2 {
     get composer(): RenderPipeline | null;
     /** 返回持久化的 WebGPU RenderPipeline。 */
     get renderPipeline(): RenderPipeline | null;
+    /** 后期效果之外的背景场景，供天空等无限远背景使用。 */
+    get postProcessingBackgroundScene(): Scene;
+    /** 后期效果之外的叠加场景，供剖切面和交互辅助对象使用。 */
+    get postProcessingOverlayScene(): Scene;
     /** 返回当前 SSGI 节点。 */
     get ssgiPass(): any;
     /** 返回当前 VXGI 体素锥追踪节点。 */
@@ -2537,6 +2387,7 @@ declare class ControlModule_2 {
     private handelBehaved;
     private pendingThirdPersonOptions;
     private prevContainerCursor;
+    private suspendedControl;
     private roamLookDirection;
     private isDragging;
     private isDown;
@@ -2567,7 +2418,7 @@ declare class ControlModule_2 {
     private createThirdPersonControl;
     private beginThirdPersonPlacement;
     isWaitingThirdPersonPlacement(): boolean;
-    applyThirdPersonPlacement(point: THREE.Vector3): boolean;
+    applyThirdPersonPlacement(point: THREE.Vector3, normal?: THREE.Vector3): boolean;
     setThirdPersonAvatar(model: any, options?: any): void;
     setThirdPersonMoveSpeed(value: number): void;
     setThirdPersonApplyCollision(value: boolean): void;
@@ -2648,6 +2499,13 @@ export declare function createEngineGaussian(options: any): Promise<EngineKernel
  */
 export declare function createEngineGIS(options: any): Promise<EngineKernelGIS>;
 
+/** V2 补面接口的兼容适配器；WebGPU 路径不再执行逐帧 CSG。 */
+declare function createWebGPUFillAdapter(): {
+    clear(): void;
+    updataFace(_plane: THREE.Plane): void;
+    updataFaces(_planes: THREE.Plane[]): void;
+};
+
 export declare const DEFAULT_AUTO_EXPOSURE_OPTIONS: ResolvedAutoExposureOptions;
 
 export declare const DEFAULT_LIGHTING_PRESETS: readonly LightingPreset[];
@@ -4423,7 +4281,10 @@ declare interface EngineSettings_2 {
     environment: {
         type: EnvironmentType_2;
         hdrId: string;
+        /** 兼容字段：历史版本表示环境亮度。 */
         hdrIntensity: number;
+        hdrBackgroundIntensity: number;
+        hdrEnvironmentIntensity: number;
         skyPreset: SkyPresetName_2;
         skyParams: SkyParams_2;
         skyIntensity: number;
@@ -5950,6 +5811,7 @@ declare class Hdr_2 {
     private currentHdrId;
     private isVisible;
     private currentIntensity;
+    private currentBackgroundIntensity;
     private currentTexture;
     private currentEnvironmentTexture;
     private skybox;
@@ -5969,7 +5831,10 @@ declare class Hdr_2 {
     getCurrentHdrId(): string;
     getVisible(): boolean;
     setIntensity(intensity: number): void;
+    /** 设置 HDR 背景亮度，不改变场景材质使用的环境光强度。 */
+    setBackgroundIntensity(intensity: number): void;
     getIntensity(): number;
+    getBackgroundIntensity(): number;
     addHdrItem(item: HdrItem_2): void;
     dispose(): void;
     private _loadHdr;
@@ -8738,8 +8603,9 @@ declare class MiniMap_2 {
 }
 
 declare interface MobileMemoryProfile {
-    readonly maxTextureSize: 2048 | 3096 | 4096;
-    readonly samples: 1 | 2 | 4;
+    readonly maxTextureSize: 2 | 2048 | 4096 | 10240;
+    readonly samples: 0 | 2 | 4 | 6;
+    readonly restrictTextureSize: boolean;
 }
 
 export declare interface ModelAnimationInfo {
@@ -12272,8 +12138,6 @@ declare class RenderModule_2 {
     /** WebGPU 设备初始化是异步的，初始化顺序之外保持与 v2 一致。 */
     initRenderer(): Promise<WebGPURenderer>;
     disposeRenderer(): void;
-    /** 未显式配置背景时，使用内置 HDR 作为 v3 默认背景。 */
-    private initializeDefaultBackground;
     /**
      * 在最终渲染结果上追加 canvas 内嵌水印。
      */
@@ -12810,6 +12674,205 @@ export declare type SearchTheme3d = 'light' | 'dark';
 
 declare type SearchTheme3d_2 = 'light' | 'dark';
 
+declare class SectionBox {
+    private engine;
+    private isActive;
+    private isCtrlDown;
+    private listenersAttached;
+    private box;
+    private pickPoint;
+    private pickNormal;
+    private pickMesh;
+    private box_;
+    private plane;
+    private meshs;
+    private isDrag;
+    maxBox: any;
+    private readonly faceIdleOpacity;
+    private readonly faceHoverOpacity;
+    private readonly mobileLongPressDelay;
+    private readonly mobileLongPressMoveTolerance;
+    private touchLongPressTimer;
+    private touchLongPressActive;
+    private touchStartPosition;
+    private touchLatestEvent;
+    private readonly transformControls;
+    private readonly transformAnchors;
+    private readonly transformHelpers;
+    private readonly faceMetaMap;
+    private isSyncingTransform;
+    private readonly transformHandleSize;
+    private readonly transformHandleColor;
+    private readonly transformHandleHoverColor;
+    private readonly handleNativeMouseDown;
+    private readonly handleNativeMouseMove;
+    private readonly handleNativeMouseUp;
+    private readonly handleNativeTouchStart;
+    private readonly handleNativeTouchMove;
+    private readonly handleNativeTouchEnd;
+    private readonly handleNativeKeyDown;
+    private readonly handleNativeKeyUp;
+    constructor(engine: any, options?: {
+        useCsgClipping?: boolean;
+    });
+    active(): void;
+    disActive(): void;
+    disabled(): void;
+    recover(): void;
+    init(updateFill?: boolean): void;
+    getboxXyz(): {
+        minX: any;
+        minY: any;
+        minZ: any;
+        maxX: any;
+        maxY: any;
+        maxZ: any;
+    };
+    setboxXyz(xyz: any): void;
+    setBox(box: any): void;
+    reverseBox(): void;
+    handleMouseDown(event: any): void;
+    handleMouseUp(_event: any, updateFill?: boolean): void;
+    private clampVector3;
+    handleMouseMove(event: any): void;
+    calculate_ratio(): void;
+    private toPercent;
+    private getInteractiveMeshes;
+    private createRaycasterFromMouseEvent;
+    private isMobileDevice;
+    private getTouchPoint;
+    private createMouseEventFromTouch;
+    private clearTouchLongPressTimer;
+    private resetTouchLongPressState;
+    private attachListeners;
+    private detachListeners;
+    private resetMeshOpacity;
+    private updateClippingBoxFill;
+    private clearClippingBoxFill;
+    private getFaceTransformOffset;
+    private keepSingleDirectionArrow;
+    private setTransformControlsVisible;
+    private ensureFaceTransformControl;
+    private updateFaceTransformControl;
+    private getDominantAxis;
+    private handleTransformObjectChange;
+    updata_face(box: any): void;
+    private createFace;
+}
+
+declare class SectionFace {
+    private engine;
+    private isActive;
+    private isDrag;
+    private isCtrlDown;
+    private listenersAttached;
+    private meshs;
+    private box;
+    private pickPoint;
+    private pickNormal;
+    private plane;
+    private angleX;
+    private angleY;
+    private angleZ;
+    private direction;
+    private normal;
+    private distance;
+    private center;
+    private current_center;
+    private dragStartDistance;
+    private dragStartCenter;
+    private readonly idleOpacity;
+    private readonly hoverOpacity;
+    private transformControl;
+    private transformAnchor;
+    private transformHelper;
+    private rotateControl;
+    private rotateAnchor;
+    private rotateHelper;
+    private rotatePivot;
+    private isSyncingTransformControl;
+    private isSyncingRotateControl;
+    private activeControlMode;
+    private readonly moveEpsilon;
+    private readonly transformHandleSize;
+    private readonly rotateHandleSize;
+    private readonly transformHandleColor;
+    private readonly transformHandleHoverColor;
+    private readonly mobileLongPressDelay;
+    private readonly mobileLongPressMoveTolerance;
+    private touchLongPressTimer;
+    private touchLongPressActive;
+    private touchStartPosition;
+    private touchLatestEvent;
+    private readonly handleNativePointerDown;
+    private readonly handleNativePointerUp;
+    private readonly handleNativeMouseDown;
+    private readonly handleNativeMouseMove;
+    private readonly handleNativeMouseUp;
+    private readonly handleNativeTouchStart;
+    private readonly handleNativeTouchMove;
+    private readonly handleNativeTouchEnd;
+    private readonly handleNativeKeyDown;
+    private readonly handleNativeKeyUp;
+    private readonly handleTransformObjectChange;
+    private readonly handleRotateObjectChange;
+    constructor(engine: any);
+    active(): void;
+    disActive(): void;
+    init(skipFaceCreation?: boolean): void;
+    disabled(): void;
+    recover(): void;
+    setFaceAngle(angleX: any, angleY: any, angleZ: any): void;
+    setFaceNormal(normal: any, dis?: any): void;
+    setFaceNormalPlaneOnly(normal: any, dis: any): void;
+    activateClippingOnly(): void;
+    reverse(): void;
+    getFaceAngle(): {
+        angleX: any;
+        angleY: any;
+        angleZ: any;
+        direction: any;
+    };
+    updata_face(dis: any, planeCenter?: THREE.Vector3): void;
+    private createFace;
+    private getDirectionSign;
+    private getEffectiveNormal;
+    private applyClippingToModelMeshes;
+    private applyClippingToMaterial;
+    private requestShadowRefresh;
+    private lockControlMode;
+    private releaseControlModeLock;
+    private applyControlModeLock;
+    private pickControlModeFromPointer;
+    private raycastTransformControlPicker;
+    private getPlaneBasis;
+    private getBoxCorners;
+    private getDistanceRange;
+    private getInteractiveMeshes;
+    private getTransformHandleOffset;
+    private getPlaneQuaternion;
+    private keepSingleDirectionArrow;
+    private ensureTransformControl;
+    private ensureRotateControl;
+    private setTransformControlVisible;
+    private updateTransformControl;
+    private updateRotateControl;
+    private createRaycasterFromMouseEvent;
+    private isMobileDevice;
+    private getTouchPoint;
+    private createMouseEventFromTouch;
+    private clearTouchLongPressTimer;
+    private resetTouchLongPressState;
+    private attachListeners;
+    private detachListeners;
+    private resetMeshOpacity;
+    private updateClippingFaceFill;
+    private clearClippingFaceFill;
+    handleMouseDown(event: any): void;
+    handleMouseUp(_event: any, updateFill?: boolean): void;
+    handleMouseMove(event: any): void;
+}
+
 export declare interface SegmentCalibrationOptions {
     url: string;
     source: CalibrationSegmentInput;
@@ -12989,6 +13052,10 @@ declare class Setting_2 {
     setHdrId(id: string): Promise<void>;
     /** 璁剧疆 HDR 寮哄害锛?~100锛夛紝浠呭湪 hdr 妯″紡涓嬬敓鏁?*/
     setHdrIntensity(value: number): void;
+    /** 设置 HDR 背景亮度（0~100），不改变模型受环境光影响的亮度。 */
+    setHdrBackgroundIntensity(value: number): void;
+    /** 设置 HDR 环境亮度（0~100），不改变背景显示亮度。 */
+    setHdrEnvironmentIntensity(value: number): void;
     /** 璁剧疆澶╃┖棰勮鏂规锛屽綋鍓嶇幆澧冧负 sky 鏃剁珛鍗崇敓鏁?*/
     setSkyPreset(preset: SkyPresetName_2): void;
     /** 璁剧疆澶╃┖鑷畾涔夊弬鏁帮紝褰撳墠鐜涓?sky 鏃剁珛鍗崇敓鏁?*/
@@ -13091,15 +13158,16 @@ declare class SkyManager {
     private _setUniformValue;
 }
 
+/** 管理 v3 WebGPU 物理天空、动态云层和场景环境光。 */
 declare class SkyManager_2 {
-    private engine;
+    private readonly engine;
     private sky;
-    private sun;
+    private readonly sun;
     private params;
     private currentPreset;
     private currentIntensity;
     private currentEnvironmentTarget;
-    private readonly skyScale;
+    private environmentRefreshTimer;
     private readonly skyName;
     private savedCameraFar;
     private previousBackground;
@@ -13110,18 +13178,25 @@ declare class SkyManager_2 {
     private previousToneMappingExposure;
     private hasCapturedSceneState;
     constructor(engine: any);
+    /** 启用天空；重复调用只恢复现有资源，不重复创建几何体和材质。 */
     activate(): void;
+    /** 关闭天空；remove=false 时保留 GPU 资源，便于频繁切换环境。 */
     close(remove?: boolean): void;
     isActive(): boolean;
     getParams(): Readonly<Required<SkyParams_2>>;
+    /** 合并并约束增量参数，防止非法数值导致 TSL 着色结果出现 NaN。 */
     setParams(params: SkyParams_2): void;
     setPreset(name: SkyPresetName_2): void;
     getCurrentPreset(): SkyPresetName_2;
     getPresetNames(): SkyPresetName_2[];
     getPresetList(): SkyPresetInfo_2[];
+    /** 设置天空生成的 IBL 环境光强度。 */
     setIntensity(intensity: number): void;
     getIntensity(): number;
-    update(time?: number): void;
+    /** 在渲染前让天空跟随相机，避免大世界坐标精度损失。 */
+    update(_time?: number): void;
+    private _getBackgroundScene;
+    private _syncSkyToCamera;
     private _isOrthographicCamera;
     private _getEffectiveExposure;
     private _expandCameraFarForSky;
@@ -13129,9 +13204,13 @@ declare class SkyManager_2 {
     private _applyParamsToSky;
     private _captureSceneState;
     private _restoreSceneState;
+    private _scheduleEnvironmentRefresh;
+    private _cancelEnvironmentRefresh;
     private _refreshEnvironmentMap;
     private _disposeEnvironmentTarget;
-    private _setUniformValue;
+    private _updateAnimationState;
+    private _resolveParams;
+    private _requestRender;
 }
 
 declare interface SkyParams {
@@ -13158,6 +13237,8 @@ declare interface SkyParams_2 {
     azimuth?: number;
     exposure?: number;
     orthoExposureScale?: number;
+    cloudScale?: number;
+    cloudSpeed?: number;
     cloudCoverage?: number;
     cloudDensity?: number;
     cloudElevation?: number;
@@ -13647,6 +13728,19 @@ export declare interface VXGIPostProcessingSettings {
     updateOnChange: boolean;
 }
 
+/** WebGPU 剖切状态：平面对象沿用 V2，模型裁剪由原生 ClippingGroup 接管。 */
+declare class WebGPUClippingState {
+    readonly planes: THREE.Plane[];
+    mode: ClippingMode;
+    fillCutFace: boolean;
+    private readonly engine;
+    constructor(engine: any, planes: THREE.Plane[]);
+    /** 将当前模式的平面同步到所有模型根节点。平面对象不复制，V2 拖动后可立即生效。 */
+    apply(): void;
+    clear(): void;
+    getActivePlanes(): THREE.Plane[];
+}
+
 /** 一次性更新多个后期效果，避免质量档切换时重复重建节点图。 */
 declare interface WebGPUPostProcessingConfiguration {
     effects?: Partial<EffectState>;
@@ -13682,6 +13776,31 @@ export declare interface WebGPUPostProcessingSettings {
     colorGrading: ColorGradingSettings;
 }
 
+/**
+ * V2 剖切框的完整交互实现：TransformControls、Ctrl 拾取、触摸长按、边界限制和比例回调均原样保留。
+ * WebGPU 只替换最终的模型裁剪通道，避免重新实现已经验证过的交互逻辑。
+ */
+declare class WebGPUSectionBox extends SectionBox {
+    private readonly webgpuState;
+    private readonly interactionScene;
+    constructor(engine: any, state: WebGPUClippingState);
+    /** V2 每次重建六个面后同步 WebGPU ClippingGroup，并唤醒按需渲染。 */
+    updata_face(box: any): void;
+    /** 释放 V2 覆盖层，防止引擎销毁后控制器继续响应。 */
+    dispose(): void;
+}
+
+/** V2 剖切面的完整平移/旋转控制器实现，裁剪结果由 WebGPU 平面状态提供。 */
+declare class WebGPUSectionFace extends SectionFace {
+    private readonly webgpuState;
+    private readonly interactionScene;
+    constructor(engine: any, state: WebGPUClippingState);
+    /** V2 每次移动或旋转剖切面后同步 WebGPU 平面。 */
+    updata_face(distance: any, planeCenter?: THREE.Vector3): void;
+    /** 释放剖切面、平移控制器和旋转控制器。 */
+    dispose(): void;
+}
+
 /**
  * 世界坐标与屏幕坐标转换工具类
  * 提供世界坐标（3D空间坐标）与屏幕坐标（2D像素坐标）之间的双向转换功能

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iflow-engine-base",
-  "version": "4.0.0",
+  "version": "4.0.10",
   "description": "BIM Engine SDK for Vue2, Vue3, React and HTML",
   "main": "./dist/bim-engine-sdk.umd.js",
   "module": "./dist/bim-engine-sdk.es.js",
@@ -42,6 +42,7 @@
     "build:720": "vite build --mode 720",
     "build:gis": "vite build --mode gis",
     "test:v3-ordinary-mesh": "node --experimental-strip-types --test scripts/check-v3-ordinary-mesh-optimization.mjs",
+    "test:v3-sky": "node --experimental-strip-types --test scripts/check-v3-sky-manager.mjs",
     "test:v2-mobile-memory": "node --experimental-strip-types --test scripts/check-v2-mobile-memory-profile.mjs",
     "build:dwg-preview": "vite build --mode 2d",
     "build:2d": "vite build --mode 2d",