iflow-engine 1.0.7 → 1.0.8

package/dist/engine/src/managers/engine-manager.d.ts

@@ -0,0 +1,242 @@
+import { EngineOptions, ModelLoadOptions, EngineInfo } from '../components/engine';
+import { BaseManager } from '../core/base-manager';
+import { RightKeyManager } from './right-key-manager';
+import { MeasureMode } from '../types/measure';
+import { MeasureUnit, MeasurePrecision } from '../components/measure-panel/types';
+import { SectionBoxRange } from '../components/section-box-panel/types';
+/**
+ * 3D 引擎管理器
+ * 封装底层 3D 引擎，提供模型加载、相机控制、测量等功能
+ */
+export declare class EngineManager extends BaseManager {
+    /** 容器元素 */
+    private container;
+    /** 引擎实例 */
+    private engineInstance;
+    /** 右键菜单管理器 */
+    rightKey: RightKeyManager | null;
+    constructor(container: HTMLElement);
+    /**
+     * 初始化 3D 引擎
+     * @param options 引擎配置选项
+     * @returns 是否初始化成功
+     */
+    initialize(options?: Omit<EngineOptions, 'container'>): boolean;
+    /**
+     * 检查引擎是否已初始化
+     * @returns 是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 加载模型
+     * @param url 模型 URL
+     * @param options 加载选项
+     */
+    loadModel(url: string, options?: ModelLoadOptions): void;
+    /**
+     * 获取底层引擎实例
+     * @returns 引擎实例
+     */
+    getEngine(): any;
+    /** 相机回到初始位置 */
+    CameraGoHome(): void;
+    /** 暂停渲染 */
+    pauseRendering(): void;
+    /** 恢复渲染 */
+    resumeRendering(): void;
+    /**
+     * 激活测量模式
+     * @param mode 测量模式
+     */
+    activateMeasure(mode: MeasureMode): void;
+    /** 停用测量模式 */
+    deactivateMeasure(): void;
+    /**
+     * 获取当前测量类型
+     * @returns 当前测量模式
+     */
+    getCurrentMeasureType(): MeasureMode | null;
+    clearAllMeasures(): void;
+    saveMeasureSetting(setting: {
+        unit: MeasureUnit;
+        precision: MeasurePrecision;
+    }): void;
+    activeSection(mode: 'x' | 'y' | 'z' | 'box' | 'face'): void;
+    /**
+     * 获取当前激活的剖切模式
+     * @returns 当前剖切模式，未激活时返回 null
+     */
+    getCurrentSectionMode(): 'x' | 'y' | 'z' | 'box' | 'face' | null;
+    /**
+     * 停用所有剖切功能
+     * @remarks 关闭剖切对话框时调用
+     */
+    deactivateSection(): void;
+    /**
+     * 设置剖切盒范围
+     * @param range 各轴的剖切范围 (百分比 0-100)
+     * @remarks 仅在 'box' 模式下有效
+     */
+    setSectionBoxRange(range: SectionBoxRange): void;
+    /**
+     * 隐藏剖切面（临时隐藏，可恢复）
+     * @remarks 配合 recoverSection() 使用
+     */
+    hideSection(): void;
+    /**
+     * 恢复剖切面（从隐藏状态恢复）
+     * @remarks 恢复被 hideSection() 隐藏的剖切面
+     */
+    recoverSection(): void;
+    fitSectionBoxToModel(): void;
+    /**
+     * 剖切盒适应（缩放到场景整体包围盒）
+     * @remarks 对接底层 clipping.scaleBox()
+     */
+    scaleSectionBox(): void;
+    /**
+     * 反向剖切
+     * @remarks 对接底层 clipping.reverse()
+     */
+    reverseSection(): void;
+    /** 激活框选放大功能 */
+    activateZoomBox(): void;
+    /** 激活第一人称漫游模式 */
+    activateFirstPersonMode(): void;
+    /** 停用第一人称漫游模式 */
+    deactivateFirstPersonMode(): void;
+    setWalkSpeed(speed: number): void;
+    setWalkGravity(enabled: boolean): void;
+    setWalkCollision(enabled: boolean): void;
+    toggleMiniMap(): void;
+    isFirstPersonModeActive(): boolean;
+    /**
+     * 获取当前选中的构件
+     * @returns 选中构件的 URL 和 ID，未选中时返回 null
+     */
+    getSelectedComponent(): {
+        url: string;
+        id: string;
+    } | null;
+    /**
+     * 获取构件属性
+     * @param url 模型 URL
+     * @param id 构件 ID
+     * @param callback 回调函数，接收属性数据
+     */
+    getComponentProperties(url: string, id: string, callback: (data: any) => void): void;
+    getTypeTreeData(): any[];
+    getLevelTreeData(): any[];
+    getMajorTreeData(): any[];
+    getEngineInfo(): EngineInfo | null;
+    /**
+     * 添加漫游点
+     * 将当前相机位置添加为一个漫游点
+     */
+    pathRoamingAddPoint(): void;
+    /**
+     * 删除指定索引的漫游点
+     * @param index 要删除的漫游点索引
+     */
+    pathRoamingRemovePoint(index: number): void;
+    /**
+     * 清除所有漫游点
+     */
+    pathRoamingClearPoints(): void;
+    /**
+     * 获取所有漫游点
+     * @returns 漫游点数组
+     */
+    pathRoamingGetPoints(): any[];
+    /**
+     * 跳转到指定漫游点
+     * @param index 目标漫游点索引
+     */
+    pathRoamingJumpToPoint(index: number): void;
+    /**
+     * 播放漫游
+     * @param options 播放选项，包含时长、循环、回调等配置
+     */
+    pathRoamingPlay(options?: {
+        duration?: number;
+        loop?: boolean;
+        onComplete?: () => void;
+        onPointComplete?: (pointIndex: number) => void;
+    }): void;
+    /**
+     * 停止漫游
+     */
+    pathRoamingStop(): void;
+    /**
+     * 获取当前高亮(选中)的模型
+     * @returns 高亮模型对象,未选中时返回 null
+     */
+    getHighlightModels(): any;
+    /**
+     * 高亮指定模型构件
+     *
+     * @param models - 要高亮的模型数组，格式: [{ url: string, ids: string[] }]
+     *
+     * @example
+     * manager.highlightModel([
+     *   { url: 'https://xxx/models/xxx/', ids: [350518, 350520] }
+     * ]);
+     */
+    highlightModel(models: {
+        url: string;
+        ids: number[];
+    }[]): void;
+    unhighlightAllModels(): void;
+    viewScaleToModel(models: {
+        url: string;
+        ids: number[];
+    }[]): void;
+    hideModels(models: {
+        url: string;
+        ids: number[];
+    }[]): void;
+    showModel(models: {
+        url: string;
+        ids: number[];
+    }[]): void;
+    /**
+     * 半透明指定模型
+     * @param models 要半透明的模型对象
+     */
+    translucentModels(models: any): void;
+    /**
+     * 取消半透明
+     */
+    unTranslucentModel(): void;
+    /**
+     * 隔离指定模型（隐藏其他）
+     * @param models 要隔离的模型对象
+     */
+    isolateModels(models: any): void;
+    /**
+     * 半透明其他构件
+     * @param models 基准模型对象
+     */
+    translucentOtherModels(models: any): void;
+    /**
+     * 显示所有模型
+     */
+    showAllModels(): void;
+    /**
+     * 批量选择同类模型
+     * @param models 基准模型对象
+     */
+    batchSelectSameTypeModel(models: any): void;
+    /**
+     * 批量选择同层模型
+     * @param models 基准模型对象
+     */
+    batchSelectSameLevelModel(models: any): void;
+    /**
+     * 批量选择同层同类模型
+     * @param models 基准模型对象
+     */
+    batchSelectSameLevelTypeModel(models: any): void;
+    /** 销毁引擎管理器 */
+    destroy(): void;
+}

package/dist/engine/src/managers/measure-dialog-manager.d.ts

@@ -0,0 +1,24 @@
+import { BaseDialogManager } from '../core/base-dialog-manager';
+import { MeasureConfig, MeasureResult } from '../components/measure-panel/types';
+import { MeasureMode } from '../types/measure';
+export declare class MeasureDialogManager extends BaseDialogManager {
+    private panel;
+    private config;
+    private unsubscribeMeasureChanged;
+    protected get dialogId(): string;
+    protected get dialogTitle(): string;
+    protected get dialogWidth(): number;
+    protected createContent(): HTMLElement;
+    protected onDialogCreated(): void;
+    private handleMeasureChanged;
+    private convertToMeasureResult;
+    protected onDialogClose(): void;
+    protected onBeforeDestroy(): void;
+    getActiveMode(): MeasureMode | null;
+    switchMode(mode: MeasureMode): void;
+    setMeasureResult(result: MeasureResult | null): void;
+    getConfig(): MeasureConfig | null;
+    setConfig(partial: Partial<MeasureConfig>, persist?: boolean): void;
+    clearAll(): void;
+    openSettings(): void;
+}

package/dist/engine/src/managers/right-key-manager.d.ts

@@ -0,0 +1,34 @@
+import { BaseManager } from '../core/base-manager';
+import { MenuItemConfig } from '../components/menu/item';
+/**
+ * 右键菜单管理器
+ * 支持注册多个上下文处理器，动态生成右键菜单
+ */
+export declare class RightKeyManager extends BaseManager {
+    /** 容器元素 */
+    private container;
+    /** 右键面板实例 */
+    private rightKeyPanel;
+    /** 上下文处理器列表 */
+    private contextHandlers;
+    constructor(container: HTMLElement);
+    /** 销毁管理器 */
+    destroy(): void;
+    /**
+     * 注册上下文处理器
+     * @param handler 处理器函数，返回菜单项配置
+     */
+    registerHandler(handler: (e: MouseEvent) => MenuItemConfig[] | null): void;
+    /**
+     * 显示菜单
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param items 菜单项配置
+     * @param groupOrder 分组顺序
+     */
+    showMenu(x: number, y: number, items: MenuItemConfig[], groupOrder?: string[]): void;
+    /** 隐藏菜单 */
+    hide(): void;
+    /** 处理右键点击事件 */
+    private handleContextMenu;
+}

package/dist/engine/src/managers/section-axis-dialog-manager.d.ts

@@ -0,0 +1,55 @@
+import { BaseDialogManager } from '../core/base-dialog-manager';
+import { SectionAxis } from '../components/section-axis-panel/types';
+/**
+ * 轴向剖切对话框管理器
+ * 继承自 BaseDialogManager，提供 X/Y/Z 轴向剖切的对话框管理功能
+ */
+export declare class SectionAxisDialogManager extends BaseDialogManager {
+    /** 轴向剖切面板实例 */
+    private panel;
+    /** 对话框唯一标识 */
+    protected get dialogId(): string;
+    /** 对话框标题（国际化 key） */
+    protected get dialogTitle(): string;
+    /** 对话框宽度 */
+    protected get dialogWidth(): number;
+    /**
+     * 获取对话框位置
+     * 定位在容器右下角
+     */
+    protected getDialogPosition(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * 创建对话框内容
+     * 初始化轴向剖切面板并设置回调
+     */
+    protected createContent(): HTMLElement;
+    /** 对话框创建后的回调，自适应高度 */
+    protected onDialogCreated(): void;
+    /** 对话框关闭时的回调，取消工具栏按钮激活状态 */
+    protected onDialogClose(): void;
+    /** 销毁前的清理，销毁面板实例 */
+    protected onBeforeDestroy(): void;
+    /**
+     * 获取剖切面隐藏状态
+     * @returns 是否隐藏
+     */
+    getHiddenState(): boolean;
+    /**
+     * 设置剖切面隐藏状态
+     * @param isHidden 是否隐藏
+     */
+    setHiddenState(isHidden: boolean): void;
+    /**
+     * 获取当前激活的剖切轴向
+     * @returns 当前轴向 'x' | 'y' | 'z'
+     */
+    getActiveAxis(): SectionAxis;
+    /**
+     * 设置剖切轴向
+     * @param axis 目标轴向
+     */
+    setActiveAxis(axis: SectionAxis): void;
+}

package/dist/engine/src/managers/section-box-dialog-manager.d.ts

@@ -0,0 +1,58 @@
+import { BaseDialogManager } from '../core/base-dialog-manager';
+import { SectionBoxRange } from '../components/section-box-panel/types';
+export declare class SectionBoxDialogManager extends BaseDialogManager {
+    private panel;
+    private unsubscribeSectionMove;
+    /** 对话框唯一标识 */
+    protected get dialogId(): string;
+    /** 对话框标题（国际化 key） */
+    protected get dialogTitle(): string;
+    /** 对话框宽度 */
+    protected get dialogWidth(): number;
+    /**
+     * 获取对话框位置
+     * 定位在容器右下角
+     */
+    protected getDialogPosition(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * 创建对话框内容
+     * 初始化剖切盒面板并设置回调
+     */
+    protected createContent(): HTMLElement;
+    protected onDialogCreated(): void;
+    protected onDialogClose(): void;
+    protected onBeforeDestroy(): void;
+    /**
+     * 获取剖切盒隐藏状态
+     * @returns 是否隐藏
+     */
+    getHiddenState(): boolean;
+    /**
+     * 设置剖切盒隐藏状态
+     * @param isHidden 是否隐藏
+     */
+    setHiddenState(isHidden: boolean): void;
+    /**
+     * 获取剖切盒反向状态
+     * @returns 是否反向（显示盒内/盒外）
+     */
+    getReversedState(): boolean;
+    /**
+     * 设置剖切盒反向状态
+     * @param isReversed 是否反向
+     */
+    setReversedState(isReversed: boolean): void;
+    /**
+     * 获取剖切盒范围
+     * @returns 六面体范围 { minX, maxX, minY, maxY, minZ, maxZ }
+     */
+    getRange(): SectionBoxRange | null;
+    /**
+     * 设置剖切盒范围
+     * @param range 部分或全部范围值
+     */
+    setRange(range: Partial<SectionBoxRange>): void;
+}

package/dist/engine/src/managers/section-plane-dialog-manager.d.ts

@@ -0,0 +1,35 @@
+import { BaseDialogManager } from '../core/base-dialog-manager';
+/**
+ * 拾取面剖切对话框管理器
+ * 继承自 BaseDialogManager，提供拾取面剖切功能的对话框管理
+ */
+export declare class SectionPlaneDialogManager extends BaseDialogManager {
+    /** 剖切面板实例 */
+    private panel;
+    /** 对话框唯一标识 */
+    protected get dialogId(): string;
+    /** 对话框标题（国际化 key） */
+    protected get dialogTitle(): string;
+    /** 对话框宽度 */
+    protected get dialogWidth(): number;
+    /** 对话框高度 */
+    protected get dialogHeight(): number;
+    /** 初始化 */
+    init(): void;
+    /**
+     * 获取对话框位置
+     * 定位在容器右下角
+     */
+    protected getDialogPosition(): {
+        x: number;
+        y: number;
+    };
+    /** 创建对话框内容 */
+    protected createContent(): HTMLElement;
+    /** 对话框创建后的回调 */
+    protected onDialogCreated(): void;
+    /** 对话框关闭时的回调 */
+    protected onDialogClose(): void;
+    /** 销毁前的清理 */
+    protected onBeforeDestroy(): void;
+}

package/dist/engine/src/managers/toolbar-manager.d.ts

@@ -0,0 +1,81 @@
+import { ButtonGroupColors, ButtonConfig } from '../components/button-group/index.type';
+import { ThemeConfig } from '../themes/types';
+import { BaseManager } from '../core/base-manager';
+/**
+ * 工具栏管理器
+ * 提供工具栏按钮的添加、显示/隐藏、主题更新等功能
+ */
+export declare class ToolbarManager extends BaseManager {
+    /** 工具栏实例 */
+    private toolbar;
+    /** 工具栏容器元素 */
+    private toolbarContainer;
+    /** 主容器元素 */
+    private container;
+    constructor(container: HTMLElement);
+    /** 初始化工具栏 */
+    private init;
+    /**
+     * 更新工具栏主题
+     * @param theme 主题配置
+     */
+    updateTheme(theme: ThemeConfig): void;
+    /** 刷新工具栏渲染 */
+    refresh(): void;
+    /** 销毁工具栏 */
+    destroy(): void;
+    /**
+     * 添加按钮组
+     * @param groupId 组 ID
+     * @param beforeGroupId 插入到指定组之前
+     */
+    addGroup(groupId: string, beforeGroupId?: string): void;
+    /**
+     * 添加按钮
+     * @param config 按钮配置
+     */
+    addButton(config: ButtonConfig): void;
+    /**
+     * 设置按钮可见性
+     * @param id 按钮 ID
+     * @param v 是否可见
+     */
+    setButtonVisibility(id: string, v: boolean): void;
+    /**
+     * 设置是否显示标签
+     * @param show 是否显示
+     */
+    setShowLabel(show: boolean): void;
+    /**
+     * 设置按钮激活状态
+     * @param id 按钮 ID
+     * @param active 是否激活
+     */
+    setBtnActive(id: string, active?: boolean): void;
+    /**
+     * 设置工具栏可见性
+     * @param visible 是否可见
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 设置背景颜色
+     * @param color 颜色值
+     */
+    setBackgroundColor(color: string): void;
+    /**
+     * 设置按钮组颜色
+     * @param colors 颜色配置
+     */
+    setColors(colors: ButtonGroupColors): void;
+    /** 隐藏工具栏 */
+    hide(): void;
+    /** 显示工具栏 */
+    show(): void;
+    /**
+     * 获取工具栏容器
+     * @returns 容器元素
+     */
+    getContainer(): HTMLElement | null;
+    setType(type: 'default' | 'glass-pill'): void;
+    getType(): 'default' | 'glass-pill';
+}

package/dist/engine/src/managers/walk-control-manager.d.ts

@@ -0,0 +1,21 @@
+import { BaseManager } from '../core/base-manager';
+import { WalkControlPanel } from '../components/walk-control-panel';
+/**
+ * 漫游控制管理器
+ * 提供第一人称漫游、路径漫游等功能的控制界面
+ */
+export declare class WalkControlManager extends BaseManager {
+    /** 漫游控制面板实例 */
+    panel: WalkControlPanel | null;
+    /** 路径漫游对话框管理器 */
+    private pathManager;
+    constructor();
+    /** 初始化管理器 */
+    init(): void;
+    /** 显示漫游控制面板 */
+    show(): void;
+    /** 隐藏漫游控制面板 */
+    hide(): void;
+    /** 销毁管理器 */
+    destroy(): void;
+}

package/dist/engine/src/managers/walk-path-dialog-manager.d.ts

@@ -0,0 +1,33 @@
+import { BaseDialogManager } from '../core/base-dialog-manager';
+/**
+ * 漫游路径对话框管理器
+ * 继承自 BaseDialogManager，提供漫游路径配置的对话框管理功能
+ */
+export declare class WalkPathDialogManager extends BaseDialogManager {
+    /** 漫游路径面板实例 */
+    private panel;
+    /** 对话框唯一标识 */
+    protected get dialogId(): string;
+    /** 对话框标题（国际化 key） */
+    protected get dialogTitle(): string;
+    /** 对话框宽度 */
+    protected get dialogWidth(): number;
+    /** 对话框高度 */
+    protected get dialogHeight(): number;
+    /** 初始化 */
+    init(): void;
+    /**
+     * 获取对话框位置
+     * 定位在容器右上角
+     */
+    protected getDialogPosition(): {
+        x: number;
+        y: number;
+    };
+    /** 创建对话框内容 */
+    protected createContent(): HTMLElement;
+    /** 对话框关闭时的回调 */
+    protected onDialogClose(): void;
+    /** 销毁前的清理 */
+    protected onBeforeDestroy(): void;
+}

package/dist/engine/src/managers/walk-plan-view-dialog-manager.d.ts

@@ -0,0 +1,33 @@
+import { BaseDialogManager } from '../core/base-dialog-manager';
+/**
+ * 漫游平面图对话框管理器
+ * 继承自 BaseDialogManager，提供漫游平面图的对话框管理功能
+ */
+export declare class WalkPlanViewDialogManager extends BaseDialogManager {
+    /** 漫游平面图面板实例 */
+    private panel;
+    /** 对话框唯一标识 */
+    protected get dialogId(): string;
+    /** 对话框标题（国际化 key） */
+    protected get dialogTitle(): string;
+    /** 对话框宽度 */
+    protected get dialogWidth(): number;
+    /** 对话框高度 */
+    protected get dialogHeight(): number;
+    /** 初始化 */
+    init(): void;
+    /**
+     * 获取对话框位置
+     * 定位在容器左下角
+     */
+    protected getDialogPosition(): {
+        x: number;
+        y: number;
+    };
+    /** 创建对话框内容 */
+    protected createContent(): HTMLElement;
+    /** 对话框关闭时的回调 */
+    protected onDialogClose(): void;
+    /** 销毁前的清理 */
+    protected onBeforeDestroy(): void;
+}

package/dist/engine/src/services/locale.d.ts

@@ -0,0 +1,35 @@
+import { LocaleType } from '../locales/types';
+type LocaleChangeListener = (locale: LocaleType) => void;
+/**
+ * 语言管理器类
+ */
+export declare class LocaleManager {
+    private currentLocale;
+    private messages;
+    private listeners;
+    constructor();
+    /**
+     * 获取当前语言
+     */
+    getLocale(): LocaleType;
+    /**
+     * 切换语言
+     */
+    setLocale(locale: LocaleType): void;
+    /**
+     * 翻译核心方法
+     */
+    t(key: string): string;
+    /**
+     * 订阅变更
+     */
+    subscribe(listener: LocaleChangeListener): () => void;
+    private notifyListeners;
+}
+export declare const localeManager: LocaleManager;
+/**
+ * 全局翻译函数
+ * @param key 键路径 (如 'toolbar.home')
+ */
+export declare const t: (key: string) => string;
+export {};

package/dist/engine/src/services/theme.d.ts

@@ -0,0 +1,35 @@
+import { ThemeConfig } from '../themes/types';
+type ThemeChangeListener = (theme: ThemeConfig) => void;
+/**
+ * 主题管理器 (单例)
+ */
+export declare class ThemeManager {
+    private currentTheme;
+    private listeners;
+    constructor();
+    /**
+     * 获取当前主题配置
+     */
+    getTheme(): ThemeConfig;
+    /**
+     * 切换预设主题
+     * @param themeName 'dark' | 'light'
+     */
+    setTheme(themeName: 'dark' | 'light'): void;
+    /**
+     * 应用自定义主题配置
+     * @param theme 配置对象
+     */
+    setCustomTheme(theme: ThemeConfig): void;
+    /**
+     * 内部应用主题逻辑
+     */
+    private applyTheme;
+    /**
+     * 订阅主题变更
+     */
+    subscribe(listener: ThemeChangeListener): () => void;
+    private notifyListeners;
+}
+export declare const themeManager: ThemeManager;
+export {};