iflow-engine 1.5.1 → 2.0.0

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

@@ -0,0 +1,64 @@
+import { DrawingLoadOptions, Drawing2dLayer } from './components/engine-2d/types';
+import { LocaleType } from './locales/types';
+import { ThemeType } from './themes/types';
+import { EngineEvents } from './types/events';
+/**
+ * BimEngine2d 构造选项
+ * 合并引擎配置与主题/语言设置
+ */
+export interface BimEngine2dOptions {
+    /** 语言 */
+    locale?: LocaleType;
+    /** 主题 */
+    theme?: ThemeType;
+    /** 背景颜色（十六进制数值，如 0xffffff） */
+    backgroundColor?: number;
+    /** 是否启用网格 */
+    gridEnabled?: boolean;
+    /** 是否启用坐标轴 */
+    axesEnabled?: boolean;
+    /** 选中构件颜色 */
+    selectionColor?: number;
+    /** 高亮构件颜色 */
+    highlightColor?: number;
+    /** 是否启用性能监控 */
+    enablePerformanceMonitoring?: boolean;
+}
+/**
+ * 独立 2D 图纸引擎
+ *
+ * 内部复用 Engine2d 组件，跳过 Manager 层
+ * 构造时自动初始化，可直接调用 loadDrawing() 加载图纸
+ */
+export declare class BimEngine2d {
+    container: HTMLElement;
+    private registry;
+    private engineComponent;
+    constructor(container: HTMLElement | string, options?: BimEngine2dOptions);
+    /** 加载 2D 图纸 */
+    loadDrawing(url: string, options?: DrawingLoadOptions): Promise<void>;
+    /** 获取所有图层 */
+    getLayers(): Drawing2dLayer[];
+    /** 设置图层可见性 */
+    setLayerVisible(name: string, visible: boolean): void;
+    /** 重置视图 */
+    resetView(): void;
+    /** 适应视图（缩放到全部内容） */
+    fitToView(): void;
+    /** 设置缩放级别 */
+    setZoom(zoom: number): void;
+    /** 获取当前缩放级别 */
+    getZoom(): number;
+    /** 设置主题 */
+    setTheme(theme: 'dark' | 'light'): void;
+    /** 订阅事件 */
+    on<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): () => void;
+    /** 取消订阅事件 */
+    off<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): void;
+    /** 订阅原始 2D 引擎事件 */
+    onRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /** 取消订阅原始 2D 引擎事件 */
+    offRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /** 销毁引擎，释放所有资源 */
+    destroy(): void;
+}

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

@@ -0,0 +1,70 @@
+import { PanoramaLoadOptions } from './components/engine-720/types';
+import { LocaleType } from './locales/types';
+import { ThemeType } from './themes/types';
+import { EngineEvents } from './types/events';
+/**
+ * BimEngine720 构造选项
+ * 合并引擎配置与主题/语言设置
+ */
+export interface BimEngine720Options {
+    /** 语言 */
+    locale?: LocaleType;
+    /** 主题 */
+    theme?: ThemeType;
+    /** 视场角（默认 75） */
+    fov?: number;
+    /** 是否启用缩放（默认 true） */
+    enableZoom?: boolean;
+    /** 是否启用旋转（默认 true） */
+    enableRotate?: boolean;
+    /** 球体半径（默认 500） */
+    sphereRadius?: number;
+    /** 旋转速度 */
+    rotateSpeed?: number;
+    /** 缩放速度 */
+    zoomSpeed?: number;
+    /** 是否启用阻尼 */
+    enableDamping?: boolean;
+    /** 阻尼因子 */
+    dampingFactor?: number;
+    /** 最小视场角 */
+    minFov?: number;
+    /** 最大视场角 */
+    maxFov?: number;
+}
+/**
+ * 独立 720° 全景引擎
+ *
+ * 内部复用 Engine720 组件，跳过 Manager 层
+ * 构造时自动初始化，可直接调用 loadPanorama() 加载全景图
+ */
+export declare class BimEngine720 {
+    container: HTMLElement;
+    private registry;
+    private engineComponent;
+    constructor(container: HTMLElement | string, options?: BimEngine720Options);
+    /** 加载全景图 */
+    loadPanorama(url: string, options?: PanoramaLoadOptions): Promise<void>;
+    /** 预加载多个全景图 */
+    preloadPanoramas(urls: string[]): Promise<void>;
+    /** 设置视场角 */
+    setFov(fov: number): void;
+    /** 获取当前视场角 */
+    getFov(): number;
+    /** 设置相机朝向 */
+    lookAt(phi: number, theta: number, animated?: boolean): void;
+    /** 重置视图 */
+    resetView(): void;
+    /** 设置主题 */
+    setTheme(theme: 'dark' | 'light'): void;
+    /** 订阅事件 */
+    on<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): () => void;
+    /** 取消订阅事件 */
+    off<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): void;
+    /** 订阅原始 720 引擎事件 */
+    onRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /** 取消订阅原始 720 引擎事件 */
+    offRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /** 销毁引擎，释放所有资源 */
+    destroy(): void;
+}

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

@@ -0,0 +1,127 @@
+import { ThemeConfig } from '../../themes/types';
+import { IBimComponent } from '../../types/component';
+import { Engine2dOptions, DrawingLoadOptions, Drawing2dLayer } from './types';
+import { ManagerRegistry } from '../../core/manager-registry';
+export type { Engine2dOptions, DrawingLoadOptions, Drawing2dLayer };
+/**
+ * 创建 Engine2d 实例的工厂函数
+ * 兼容旧代码直接 import 的方式
+ */
+export declare const createEngine2d: (options: Engine2dOptions, registry: ManagerRegistry) => Engine2d;
+/**
+ * 2D 图纸引擎组件
+ * 负责创建和管理第三方 2D 引擎实例
+ */
+export declare class Engine2d implements IBimComponent {
+    /** 第三方 2D 引擎实例 */
+    private engine;
+    /** 管理器注册表实例 */
+    private registry;
+    /** 引擎挂载的容器元素 */
+    private container;
+    /** 引擎容器 ID（用于传递给 createEngine2d） */
+    private containerId;
+    /** 引擎配置选项（不包含 container） */
+    private options;
+    /** 是否已初始化 */
+    private _isInitialized;
+    /** 是否已销毁 */
+    private _isDestroyed;
+    /** 主题订阅取消函数 */
+    private unsubscribeTheme;
+    /**
+     * 构造函数
+     * @param options 2D 引擎配置选项
+     * @param registry 管理器注册表
+     */
+    constructor(options: Engine2dOptions, registry: ManagerRegistry);
+    /**
+     * 初始化组件 (接口实现)
+     * 创建 div 容器并初始化 2D 引擎
+     */
+    init(): void;
+    /**
+     * 设置主题 (接口实现)
+     * @param _theme 全局主题配置
+     */
+    setTheme(_theme: ThemeConfig): void;
+    /**
+     * 设置语言 (接口实现)
+     */
+    setLocales(): void;
+    /**
+     * 检查是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 加载 2D 图纸
+     * @param url 图纸文件 URL
+     * @param options 加载选项
+     */
+    loadDrawing(url: string, options?: DrawingLoadOptions): Promise<void>;
+    /**
+     * 获取所有图层
+     * @returns 图层列表
+     */
+    getLayers(): Drawing2dLayer[];
+    /**
+     * 设置图层可见性
+     * @param name 图层名称
+     * @param visible 是否可见
+     */
+    setLayerVisible(name: string, visible: boolean): void;
+    /**
+     * 重置视图（适应画布）
+     */
+    resetView(): void;
+    /**
+     * 适应视图（缩放到全部内容）
+     */
+    fitToView(): void;
+    /**
+     * 设置缩放级别
+     * @param zoom 缩放值
+     */
+    setZoom(zoom: number): void;
+    /**
+     * 获取当前缩放级别
+     * @returns 当前缩放值
+     */
+    getZoom(): number;
+    /**
+     * 设置背景色
+     * @param color 颜色值（十六进制数值）
+     */
+    setBackgroundColor(color: number): void;
+    /**
+     * 清除场景
+     */
+    clearScene(): void;
+    /**
+     * 调整引擎尺寸
+     */
+    resize(): void;
+    /**
+     * 订阅原始 2D 引擎事件
+     * @param event 事件名称
+     * @param handler 事件处理函数
+     */
+    onRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * 取消订阅原始 2D 引擎事件
+     * @param event 事件名称
+     * @param handler 事件处理函数
+     */
+    offRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * 销毁组件 (接口实现)
+     * 清理资源、取消订阅、销毁引擎实例
+     */
+    destroy(): void;
+    /**
+     * 判断颜色字符串是否为深色
+     * @param color CSS 颜色字符串
+     * @returns 是否为深色
+     */
+    private isColorDark;
+}

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

@@ -0,0 +1,43 @@
+/**
+ * 2D 引擎类型定义
+ * 定义 2D CAD/DWG 图纸引擎的配置选项和相关类型
+ */
+/**
+ * 2D 引擎配置选项
+ */
+export interface Engine2dOptions {
+    /** 引擎挂载的容器元素 */
+    container: HTMLElement;
+    /** 背景颜色（十六进制数值，如 0xffffff） */
+    backgroundColor?: number;
+    /** 是否启用网格 */
+    gridEnabled?: boolean;
+    /** 是否启用坐标轴 */
+    axesEnabled?: boolean;
+    /** 选中构件颜色 */
+    selectionColor?: number;
+    /** 高亮构件颜色 */
+    highlightColor?: number;
+    /** 是否启用性能监控 */
+    enablePerformanceMonitoring?: boolean;
+}
+/**
+ * 2D 图纸加载选项
+ */
+export interface DrawingLoadOptions {
+    /** 分块大小 */
+    chunkSize?: number;
+    /** 是否启用分块加载 */
+    enableChunkedLoading?: boolean;
+    /** 是否启用数据校验 */
+    enableValidation?: boolean;
+}
+/**
+ * 2D 图纸图层信息
+ */
+export interface Drawing2dLayer {
+    /** 图层名称 */
+    name: string;
+    /** 图层是否可见 */
+    visible: boolean;
+}

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

@@ -0,0 +1,119 @@
+import { ThemeConfig } from '../../themes/types';
+import { IBimComponent } from '../../types/component';
+import { Engine720Options, PanoramaLoadOptions, PanoramaAnnotation } from './types';
+import { ManagerRegistry } from '../../core/manager-registry';
+export type { Engine720Options, PanoramaLoadOptions, PanoramaAnnotation };
+/**
+ * 创建 Engine720 实例的工厂函数
+ * 兼容旧代码直接 import 的方式
+ */
+export declare const createEngine720: (options: Engine720Options, registry: ManagerRegistry) => Engine720;
+/**
+ * 720° 全景引擎组件
+ * 负责创建和管理第三方 720 全景引擎实例
+ */
+export declare class Engine720 implements IBimComponent {
+    /** 第三方 720 引擎实例 */
+    private engine;
+    /** 管理器注册表实例 */
+    private registry;
+    /** 引擎挂载的容器元素 */
+    private container;
+    /** 引擎容器 ID（用于传递给 createEngine720） */
+    private containerId;
+    /** 引擎配置选项（不包含 container） */
+    private options;
+    /** 是否已初始化 */
+    private _isInitialized;
+    /** 是否已销毁 */
+    private _isDestroyed;
+    /** 主题订阅取消函数 */
+    private unsubscribeTheme;
+    /**
+     * 构造函数
+     * @param options 720 引擎配置选项
+     * @param registry 管理器注册表
+     */
+    constructor(options: Engine720Options, registry: ManagerRegistry);
+    /**
+     * 初始化组件 (接口实现)
+     * 创建 div 容器并初始化 720 引擎
+     */
+    init(): void;
+    /**
+     * 设置主题 (接口实现)
+     * @param _theme 全局主题配置
+     */
+    setTheme(_theme: ThemeConfig): void;
+    /**
+     * 设置语言 (接口实现)
+     */
+    setLocales(): void;
+    /**
+     * 检查是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 加载全景图
+     * @param url 全景图片 URL
+     * @param _options 加载选项（预留）
+     */
+    loadPanorama(url: string, _options?: PanoramaLoadOptions): Promise<void>;
+    /**
+     * 预加载多个全景图
+     * @param urls 全景图 URL 列表
+     */
+    preloadPanoramas(urls: string[]): Promise<void>;
+    /**
+     * 设置视场角
+     * @param fov 视场角值
+     */
+    setFov(fov: number): void;
+    /**
+     * 获取当前视场角
+     * @returns 当前视场角值
+     */
+    getFov(): number;
+    /**
+     * 设置相机朝向
+     * @param phi 水平角度
+     * @param theta 垂直角度
+     * @param animated 是否动画过渡
+     */
+    lookAt(phi: number, theta: number, animated?: boolean): void;
+    /**
+     * 重置视图
+     */
+    resetView(): void;
+    /**
+     * 暂停渲染
+     */
+    pauseRendering(): void;
+    /**
+     * 恢复渲染
+     */
+    resumeRendering(): void;
+    /**
+     * 调整引擎尺寸
+     * @param width 宽度
+     * @param height 高度
+     */
+    resize(width?: number, height?: number): void;
+    /**
+     * 订阅原始 720 引擎事件
+     * @param event 事件名称
+     * @param handler 事件处理函数
+     */
+    onRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * 取消订阅原始 720 引擎事件
+     * @param event 事件名称
+     * @param handler 事件处理函数
+     */
+    offRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * 销毁组件 (接口实现)
+     * 清理资源、取消订阅、销毁引擎实例
+     */
+    destroy(): void;
+}

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

@@ -0,0 +1,53 @@
+/**
+ * 720 全景引擎类型定义
+ * 定义 720° 全景查看引擎的配置选项和相关类型
+ */
+/**
+ * 720 全景引擎配置选项
+ */
+export interface Engine720Options {
+    /** 引擎挂载的容器元素 */
+    container: HTMLElement;
+    /** 视场角（默认 75） */
+    fov?: number;
+    /** 是否启用缩放（默认 true） */
+    enableZoom?: boolean;
+    /** 是否启用旋转（默认 true） */
+    enableRotate?: boolean;
+    /** 球体半径（默认 500） */
+    sphereRadius?: number;
+    /** 旋转速度 */
+    rotateSpeed?: number;
+    /** 缩放速度 */
+    zoomSpeed?: number;
+    /** 是否启用阻尼（惯性） */
+    enableDamping?: boolean;
+    /** 阻尼因子 */
+    dampingFactor?: number;
+    /** 最小视场角 */
+    minFov?: number;
+    /** 最大视场角 */
+    maxFov?: number;
+}
+/**
+ * 全景加载选项
+ */
+export interface PanoramaLoadOptions {
+    /** 加载超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * 全景标注信息
+ */
+export interface PanoramaAnnotation {
+    /** 标注 ID */
+    id: string;
+    /** 标注位置（球面坐标 phi） */
+    phi?: number;
+    /** 标注位置（球面坐标 theta） */
+    theta?: number;
+    /** 标注文本 */
+    text?: string;
+    /** 自定义数据 */
+    data?: any;
+}