iflow-engine 3.9.203 → 3.9.212

package/dist/bim-engine.d.ts

@@ -17,6 +17,8 @@ import { SettingDialogManager } from './managers/setting-dialog-manager';
 import { ComponentDetailManager } from './managers/component-detail-manager';
 import { AiChatManager } from './managers/ai-chat-manager';
 import { ConstructTreeManagerBtn } from './managers/construct-tree-manager-btn';
+import { ViewDropdownManager } from './managers/view-dropdown-manager';
+import { HelpPanelManager } from './managers/help-panel-manager';
 import { EngineOptions, ModelLoadOptions } from './components/engine';
 import { LocaleType } from './locales/types';
 import { ThemeType, ThemeConfig } from './themes/types';
@@ -25,9 +27,11 @@ import { RadialMenuItem } from './components/radial-toolbar/types';
 export type { EngineOptions, ModelLoadOptions };
 export type { RadialMenuItem };
 export type { ConstructTreeData, ConstructTreeModelData, ConstructTreeNode, ConstructTreeSearchOptions, ConstructTreeType, } from './managers/engine-manager';
+export type BimEngineMode = 'desktop' | 'mobile' | 'auto';
 export interface BimEngineOptions {
     locale?: LocaleType;
     theme?: ThemeType;
+    mode?: BimEngineMode;
     enableRadialToolbar?: boolean;
     enableConstructTree?: boolean;
     enableRightKeyMenu?: boolean;
@@ -42,11 +46,14 @@ export declare class BimEngine {
     private lastSyncedWidth;
     private lastSyncedHeight;
     private registry;
+    private readonly mode;
     private readonly uiOptions;
     dialog: DialogManager | null;
     engine: EngineManager | null;
     rightKey: RightKeyManager | null;
     radialToolbar: RadialToolbarManager | null;
+    viewDropdown: ViewDropdownManager | null;
+    helpPanel: HelpPanelManager | null;
     bottomDock: BottomDockManager | null;
     measureDock: MeasureDockManager | null;
     sectionDock: SectionDockManager | null;
@@ -76,19 +83,57 @@ export declare class BimEngine {
     getLocale(): LocaleType;
     setTheme(theme: 'dark' | 'light'): void;
     setCustomTheme(theme: ThemeConfig): void;
+    initialize(options?: Omit<EngineOptions, 'container'>): Promise<boolean>;
+    loadModel(urls: string[], options?: ModelLoadOptions): void;
     setPinEditable(editable: boolean): void;
     isPinEditable(): boolean;
     /**
-     * 向右下角径向工具栏追加一个外部按钮。
-     * 需要 enableRadialToolbar 为 true；关闭径向工具栏时该方法会静默忽略。
+     * 向右下角工具栏追加一个外部按钮。
+     * 需要 enableRadialToolbar 为 true；关闭工具栏时该方法会静默忽略。
      */
     addRadialToolbarButton(item: RadialMenuItem): void;
     /**
-     * 设置右下角径向工具栏 toggle 按钮的激活状态。
+     * 设置右下角工具栏 toggle 按钮的激活状态。
      * 仅对 isToggle=true 的按钮生效。
      */
     setRadialToolbarButtonActive(id: string, active: boolean): void;
+    loadModelByViewToken(viewToken: string): Promise<void>;
+    /**
+     * 解析最终运行模式；auto 会根据触摸能力和容器宽度判断桌面端或移动端。
+     */
+    private resolveMode;
+    /**
+     * 判断当前是否运行桌面端 UI；移动端只保留通用引擎能力。
+     */
+    private isDesktopUi;
+    /**
+     * 初始化入口：先加载通用能力，再按 mode 加载对应 UI。
+     */
     private init;
+    /**
+     * 初始化基础容器；移动端不会创建任何桌面端状态栏或调试信息。
+     */
+    private initContainer;
+    /**
+     * 初始化桌面端状态信息，包括版本号、模型统计和容器尺寸。
+     */
+    private initDesktopStatusUi;
+    /**
+     * 初始化桌面端和移动端都需要的通用能力，目前只包含 3D 引擎管理器。
+     */
+    private initCommonManagers;
+    /**
+     * 初始化桌面端 UI；所有现有桌面组件都集中在这里，移动端不会执行。
+     */
+    private initDesktopUi;
+    /**
+     * 初始化移动端 UI；当前移动端不加载任何 UI 组件，只保留模型加载能力。
+     */
+    private initMobileUi;
+    /**
+     * 绑定通用事件和全局服务订阅，桌面端和移动端都会执行。
+     */
+    private bindCommonEvents;
     private updateTheme;
     private updateClientSizeDisplay;
     private updateEngineStats;

package/dist/components/engine/index.d.ts

@@ -47,12 +47,6 @@ export declare class Engine implements IBimComponent {
     private currentSectionMode;
     /** 当前选中的构件信息 */
     private selectedComponent;
-    private viewDropdownTrigger;
-    private viewDropdownMenu;
-    private customViewDropdownButtons;
-    private infoButton;
-    private helpPanel;
-    private unsubscribeLocale;
     readonly calibration: CalibrationController;
     /**
      * 构造函数
@@ -84,6 +78,7 @@ export declare class Engine implements IBimComponent {
      * @param options 加载选项（位置、旋转、缩放）
      */
     loadModel(urls: string[], options?: ModelLoadOptions): void;
+    loadModelByViewToken(viewToken: string): Promise<void>;
     private getRawLabel;
     /** 进入一次 3D 模型选点模式，返回模型世界坐标 */
     pickPoint(): Promise<LabelCoordinate | null>;
@@ -154,18 +149,7 @@ export declare class Engine implements IBimComponent {
     captureScreenshot(): void;
     /** 获取当前视角截图的 base64 data URL */
     captureViewBase64(type?: string, quality?: any): string | null;
-    /** 添加右上角视图下拉菜单按钮，返回取消注册函数 */
-    addViewDropdownButton(config: EngineViewDropdownButtonConfig): () => void;
-    /** 移除右上角视图下拉菜单按钮 */
-    removeViewDropdownButton(key: string): void;
-    private createViewDropdown;
-    private initHelpPanel;
     showHelpPanel(): void;
-    private createInfoButton;
-    private toggleViewDropdown;
-    private closeViewDropdown;
-    private updateViewDropdownText;
-    private getViewDropdownItems;
     /**
      * 订阅原始引擎事件
      * 用于需要访问底层引擎事件的场景（如测量回调、剖切移动等）

package/dist/components/engine-2d/index.d.ts

@@ -64,6 +64,7 @@ export declare class Engine2d implements IBimComponent {
      * @param options 加载选项
      */
     loadDrawing(url: string, options?: DrawingLoadOptions): Promise<void>;
+    loadModelByViewToken(viewToken: string): Promise<void>;
     /**
      * 获取所有图层
      * @returns 图层列表

package/dist/components/engine-720/index.d.ts

@@ -61,6 +61,7 @@ export declare class Engine720 implements IBimComponent {
      * @param _options 加载选项（预留）
      */
     loadPanorama(url: string, _options?: PanoramaLoadOptions): Promise<void>;
+    loadModelByViewToken(viewToken: string): Promise<void>;
     /**
      * 预加载多个全景图
      * @param urls 全景图 URL 列表

package/dist/components/engine-gaussian/index.d.ts

@@ -24,6 +24,7 @@ export declare class EngineGaussian implements IBimComponent {
     init(): void;
     isInitialized(): boolean;
     loadModel(url: string, options?: GaussianLoadOptions): Promise<GaussianSceneInfo | null>;
+    loadModelByViewToken(viewToken: string): Promise<GaussianSceneInfo | null>;
     unloadModel(id: string): Promise<void>;
     clearModels(): Promise<void>;
     setOrientationPreset(preset: GaussianOrientationPreset): void;

package/dist/components/engine-gis/index.d.ts

@@ -86,6 +86,7 @@ export declare class EngineGis implements IBimComponent {
     private initViewDropdown;
     /** 加载 GIS 3D Tiles 模型，对外只接收业务必要参数，其余显示/精度参数按文档默认值内部补齐 */
     load3DTiles(options: EngineGis3DTilesLoadOptions): Promise<EngineGisLoaded3DTilesModel | null>;
+    loadModelByViewToken(viewToken: string): Promise<EngineGisLoaded3DTilesModel | null>;
     /** 获取当前已加载 3D Tiles 模型的校验编辑数据 */
     getModelCalibrationItems(): GisModelCalibrationItem[];
     /** 使用 ENU 偏移和旋转校验 GIS 3D Tiles 模型 */

package/dist/components/view-dropdown/index.d.ts

@@ -1,4 +1,4 @@
-import { ViewDropdownOptions } from './types';
+import { ViewDropdownItem, ViewDropdownOptions } from './types';
 export type { ViewDropdownItem, ViewDropdownOptions } from './types';
 export declare class ViewDropdown {
     private readonly options;
@@ -9,8 +9,10 @@ export declare class ViewDropdown {
     constructor(options: ViewDropdownOptions);
     init(): void;
     destroy(): void;
+    setItems(items: ViewDropdownItem[]): void;
     private toggleMenu;
     private openMenu;
     private closeMenu;
     private updateText;
+    private resolveLabel;
 }

package/dist/components/view-dropdown/types.d.ts

@@ -1,7 +1,9 @@
 export interface ViewDropdownItem {
     key: string;
-    labelKey: string;
-    action: () => void;
+    labelKey?: string;
+    label?: string;
+    action: (event: MouseEvent) => void;
+    closeOnClick?: boolean;
 }
 export interface ViewDropdownOptions {
     container: HTMLElement;

package/dist/core/manager-registry.d.ts

@@ -26,6 +26,8 @@ import { ComponentTreeDrawerManager } from '../managers/component-tree-drawer-ma
 import { Engine2dManager } from '../managers/engine-2d-manager';
 import { EngineGisManager } from '../managers/engine-gis-manager';
 import { EngineGaussianManager } from '../managers/engine-gaussian-manager';
+import { ViewDropdownManager } from '../managers/view-dropdown-manager';
+import { HelpPanelManager } from '../managers/help-panel-manager';
 /**
  * Manager 注册表 - 实例模式
  * 每个 BimEngine 创建独立的 Registry 实例，替代旧的全局单例
@@ -37,6 +39,8 @@ export declare class ManagerRegistry {
     container: HTMLElement | null;
     /** 包装容器元素 */
     wrapper: HTMLElement | null;
+    /** 当前 UI 模式，移动端用来跳过桌面端内置 UI。 */
+    mode: 'desktop' | 'mobile';
     /** 工具栏管理器 */
     toolbar: ToolbarManager | null;
     /** 对话框管理器 */
@@ -77,6 +81,10 @@ export declare class ManagerRegistry {
     setting: SettingDialogManager | null;
     /** 径向工具栏管理器 */
     radialToolbar: RadialToolbarManager | null;
+    /** 右上角视图下拉菜单管理器 */
+    viewDropdown: ViewDropdownManager | null;
+    /** 左下角帮助信息面板管理器 */
+    helpPanel: HelpPanelManager | null;
     bottomDock: BottomDockManager | null;
     measureDock: MeasureDockManager | null;
     sectionDock: SectionDockManager | null;

package/dist/core/sdk-auth.d.ts

@@ -0,0 +1,3 @@
+export declare const INTERNAL_SDK_AUTH: {
+    readonly endpoint: "https://open.iflowbim.cn/openapi";
+};

package/dist/cus-bim-engine.d.ts

@@ -67,6 +67,9 @@ export declare class CusBimEngine {
     getLocale(): LocaleType;
     setTheme(theme: 'dark' | 'light'): void;
     setCustomTheme(theme: ThemeConfig): void;
+    initialize(options?: Omit<EngineOptions, 'container'>): Promise<boolean>;
+    loadModel(urls: string[], options?: ModelLoadOptions): void;
+    loadModelByViewToken(viewToken: string): Promise<void>;
     private init;
     private updateTheme;
     private updateClientSizeDisplay;