iflow-engine-base 3.12.8 → 3.12.9

package/dist/index.d.ts

@@ -20,7 +20,6 @@ declare class AngleMeasure2d extends BaseMeasureTool2d {
     handleMove(point: THREE.Vector3): void;
 }
 
-/** 统一管理点线面体标记、特效和原生 HTML 窗体。 */
 declare class Annotation3d {
     private readonly engine;
     private readonly rootGroup;
@@ -29,64 +28,36 @@ declare class Annotation3d {
     private readonly occlusionRaycaster;
     private readonly normalizer;
     private readonly materialFactory;
-    private readonly geometryBuilder;
+    private readonly overlayController;
+    private readonly interactionController;
     private readonly effectsController;
-    private readonly panelLayer;
-    private readonly interaction;
+    private readonly visibilityController;
+    private readonly markerRegistry;
+    private readonly recordFactory;
     private currentTime;
-    /** 初始化标记根节点、DOM 面板层以及交互控制器。 */
     constructor(engine: any);
-    /** 新增单个标记并返回最终 id。 */
     add(config: Annotation3dData): string;
-    /** 批量新增标记。 */
     addMany(configs: Annotation3dData[]): string[];
-    /**
-     * 进入模型选点状态，点击模型后返回用于创建标记的世界坐标；取消或不可用时返回 null。
-     */
     pickPoint(): Promise<AnnotationPoint3d | null>;
-    /** 更新标记时直接重建几何和窗体，保持内部状态简单且可预测。 */
     update(id: string, patch: Partial<Annotation3dData>): boolean;
-    /** 删除单个标记。 */
     remove(id: string): boolean;
-    /** 清空所有标记及其 DOM 面板。 */
     clear(): void;
-    /** 获取单个运行时实例。 */
     get(id: string): Annotation3dInstance | undefined;
-    /** 获取全部运行时实例。 */
     getAll(): Annotation3dInstance[];
-    /** 显示指定标记。 */
     show(id: string): boolean;
-    /** 隐藏指定标记。 */
     hide(id: string): boolean;
-    /** 统一控制标记显隐，并同步其面板状态。 */
     setVisible(id: string, visible: boolean): boolean;
-    /** 手动打开面板，适用于 manual / click 等模式。 */
     showPanel(id: string): boolean;
-    /** 手动关闭面板。 */
     hidePanel(id: string): boolean;
-    /** 切换面板开关状态。 */
     togglePanel(id: string): boolean;
-    /** 更新面板文本、HTML、样式或 actions。 */
     updatePanel(id: string, patch: Partial<Annotation3dPanel>): boolean;
-    /** 导出纯数据快照，供保存和恢复。 */
     getData(): Annotation3dData[];
-    /** 从纯数据快照恢复整套标记。 */
     restoreData(data: Annotation3dData[]): void;
-    /** 每帧刷新特效和窗体投影位置。 */
     updateFrame(deltaTime?: number): void;
-    /** 释放事件、几何和 DOM 资源。 */
     dispose(): void;
-    /** 组装运行时记录，并将几何与面板初始化好。 */
-    private buildRecord;
-    /** 新记录统一走同一挂载流程，减少 add / update 重复代码。 */
     private attachRecord;
-    /** 内部删除会负责资源回收和 hover 状态清理。 */
     private removeInternal;
-    /** 标记显隐变化时，同时同步渲染顺序和面板显示。 */
-    private applyVisibility;
-    /** 统一生成对外事件 payload。 */
     private toEventPayload;
-    /** 统一向引擎事件总线派发标记事件。 */
     private emit;
 }
 
@@ -159,13 +130,15 @@ export declare interface Annotation3dStyle {
     fillColor?: string;
     fillOpacity?: number;
     point?: AnnotationPointStyle;
+    leaderPoint?: AnnotationLeaderPointStyle;
     line?: AnnotationLineStyle;
+    curve?: AnnotationCurveStyle;
     polygon?: AnnotationPolygonStyle;
     volume?: AnnotationVolumeStyle;
 }
 
 /** 支持的三维标记类型。 */
-export declare type Annotation3dType = 'point' | 'polyline' | 'polygon' | 'extrudePolygon' | 'box';
+export declare type Annotation3dType = 'point' | 'leaderPoint' | 'polyline' | 'curve3d' | 'polygon' | 'extrudePolygon' | 'box';
 
 /** 面板 action 回调上下文。 */
 export declare interface AnnotationActionContext {
@@ -189,6 +162,15 @@ declare interface AnnotationBaseRingEffect {
  */
 declare type AnnotationConfig720 = IconAnnotationConfig | TextAnnotationConfig | LinkAnnotationConfig;
 
+/** 3D 曲线样式。 */
+declare interface AnnotationCurveStyle {
+    interpolation?: 'catmullRom' | 'centripetal' | 'chordal';
+    tension?: number;
+    tubularSegments?: number;
+    radialSegments?: number;
+    closed?: boolean;
+}
+
 /** 流动效果配置。 */
 declare interface AnnotationFlowEffect {
     enabled: boolean;
@@ -244,6 +226,32 @@ declare interface AnnotationLayersEffect {
     offsetY?: number;
 }
 
+/** 带引线点标记样式。 */
+declare interface AnnotationLeaderPointStyle {
+    variant?: 'vertical' | 'elbow' | 'flag';
+    side?: 'left' | 'right';
+    height?: number;
+    armLength?: number;
+    offsetX?: number;
+    offsetZ?: number;
+    stemWidth?: number;
+    showAnchor?: boolean;
+    showBoard?: boolean;
+    boardWidth?: number;
+    boardHeight?: number;
+    boardOpacity?: number;
+    strokeColor?: string;
+    strokeOpacity?: number;
+    backgroundColor?: string;
+    backgroundOpacity?: number;
+    borderColor?: string;
+    borderWidth?: number;
+    anchorColor?: string;
+    anchorRingColor?: string;
+    iconBackgroundColor?: string;
+    iconBackgroundOpacity?: number;
+}
+
 /** 线样式。 */
 declare interface AnnotationLineStyle {
     dashed?: boolean;
@@ -688,6 +696,7 @@ declare class CameraModule {
     private engine;
     perspectiveCamera: THREE.PerspectiveCamera;
     orthographicCamera: THREE.OrthographicCamera;
+    private cameraAnimationFrame;
     constructor(engine: any);
     /** 视图跳转前统一退出图钉查看态，避免批注锁定与相机动画冲突。 */
     private exitDrawingPinView;
@@ -719,7 +728,9 @@ declare class CameraModule {
         x: number;
         y: number;
         z: number;
-    }, stableUp?: any, distanceOverride?: number | null): void;
+    }, stableUp?: any, distanceOverride?: number | null, animationDuration?: number, onComplete?: () => void): void;
+    private applyCameraPose;
+    private animateCameraToTarget;
 }
 
 declare class CameraModule2d {
@@ -6373,8 +6384,8 @@ declare class ModelToolModule {
     unhighlightAllModels(isClear?: boolean): void;
     hideModel(models: any): void;
     showModel(models: any, skipStateCleanup?: boolean): void;
-    isolateModel(models: any): void;
-    translucentOtherModel(models: any): void;
+    isolateModel(models: any, opacity?: number): void;
+    translucentOtherModel(models: any, opacity?: number): void;
     /** 设置构件自定义颜色，入参与高亮接口一致：[{ url, ids }]，同时兼容旧的直接 Mesh 入参。 */
     setModelColor(models: any, color?: THREE.ColorRepresentation, opacity?: number): void;
     /** 恢复指定构件的自定义颜色，入参与高亮接口一致：[{ url, ids }]。 */
@@ -6418,7 +6429,7 @@ declare class ModelToolModule {
     private createCustomInstanceBatch;
     private normalizeOpacity;
     private clearMaterialTextures;
-    translucentModel(models: any[]): void;
+    translucentModel(models: any[], opacity?: number): void;
     unTranslucentModel(): void;
     hideAllModels(): void;
     showAllModels(): void;
@@ -8189,7 +8200,7 @@ declare class ViewCube {
     show(): void;
     CameraGoHome(time: number): void;
     cameraGoHome(time: number): void;
-    zoomToModel(box: any): void;
+    zoomToModel(box: any, time?: number): void;
     zoomToModels(m: any): void;
     flyToModels(ms?: any[]): void;
     saveMainViewPort(): any;
@@ -8305,6 +8316,7 @@ declare class ViewerModuleGIS {
 }
 
 declare class ViewTree {
+    private static readonly OPEN_VIEW_ANIMATION_DURATION;
     private engine;
     private dynamicElevationViewGenerator;
     /** 管理模型原生视图与运行时动态视图的统一入口。 */

package/package.json

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