bim_engine/dist/index.d.ts

/**
 * 通用按钮组组件 (BimButtonGroup)
 */
declare class BimButtonGroup implements IBimComponent {
    private container;
    private options;
    private groups;
    private activeBtnIds;
    private btnRefs;
    private dropdownElement;
    private hoverTimeout;
    private customColors;
    private unsubscribeLocale;
    private unsubscribeTheme;
    protected engine: BimEngine | null;
    private readonly DEFAULT_ICON;
    constructor(options: ButtonGroupOptions);
    setEngine(engine: BimEngine): void;
    protected emit<K extends keyof EngineEvents>(event: K, payload: EngineEvents[K]): void;
    private initContainer;
    /**
     * 设置事件拦截，防止事件冒泡到下层元素（如 3D 引擎）
     */
    private setupEventInterception;
    private updatePosition;
    /**
     * 应用样式到容器
     */
    private applyStyles;
    /**
     * 设置主题的primary颜色（用于边框等）
     */
    private setPrimaryColor;
    /**
     * 设置主题颜色
     * 只会应用到没有被用户自定义的颜色属性上
     */
    setTheme(theme: ThemeConfig): void;
    /**
     * 直接设置颜色（强制覆盖）
     * 设置的颜色会被标记为自定义，后续的 setTheme 不会覆盖它们
     */
    setColors(colors: ButtonGroupColors): void;
    init(): Promise<void>;
    setLocales(): void;
    addGroup(groupId: string, beforeGroupId?: string): void;
    addButton(config: ButtonConfig): void;
    private findButton;
    render(): void;
    private renderGroup;
    private renderButton;
    /**
     * 设置按钮的激活状态
     * @param id 按钮 ID
     * @param active 可选，如果不传则切换(toggle)当前状态
     */
    setBtnActive(id: string, active?: boolean): void;
    private handleClick;
    /**
     * 互斥关闭同范围内的其它已激活按钮，并触发它们的 onClick
     * @param button 当前被激活的按钮
     */
    private deactivateExclusiveSiblings;
    private handleMouseEnter;
    private handleMouseLeave;
    private showDropdown;
    private renderDropdownItem;
    private closeDropdown;
    private updateButtonState;
    private getIcon;
    updateButtonVisibility(id: string, visible: boolean): void;
    setShowLabel(show: boolean): void;
    private updateLabelsVisibility;
    private findButtonById;
    setBackgroundColor(color: string): void;
    private isVisible;
    destroy(): void;
}

declare abstract class BimComponent {
    protected engine: BimEngine;
    constructor(engine: BimEngine);
    /**
     * Helper to send events easily
     */
    protected emit<K extends keyof EngineEvents>(event: K, payload: EngineEvents[K]): void;
    /**
     * Helper to listen to events easily
     * Returns an unsubscribe function
     */
    protected on<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): () => void;
    abstract destroy(): void;
}

/**
 * 通用弹窗组件类
 * 支持拖拽、缩放、自定义内容和位置。
 */
declare class BimDialog implements IBimComponent {
    private element;
    private options;
    private container;
    private header;
    private contentArea;
    private _isDestroyed;
    private _isInitialized;
    private unsubscribeTheme;
    private unsubscribeLocale;
    private rafId;
    /**
     * 构造函数
     * @param options 弹窗配置选项
     */
    constructor(options: DialogOptions);
    /**
     * 设置主题
     * @param theme 全局主题配置
     */
    setTheme(theme: ThemeConfig): void;
    /**
     * 初始化组件功能 (接口实现)
     */
    init(): void;
    setLocales(): void;
    /**
     * 创建弹窗的 DOM 结构
     */
    private createDom;
    /**
     * 设置元素尺寸
     */
    private setSize;
    /**
     * 根据内容自动调整弹窗宽度
     * @param recenter 是否重新计算定位（例如保持居中），默认 true
     */
    fitWidth(recenter?: boolean): void;
    /**
     * 根据内容自动调整弹窗高度
     *
     * 设计说明：
     * - 主要用于“内容展开/收起”场景（比如测量面板展开后，Dialog 高度跟随变化）
     * - 默认不改变用户拖拽后的当前位置，只做边界夹紧，避免弹窗超出容器
     *
     * @param recenter 是否根据 options.position 重新定位（默认 false）
     */
    fitHeight(recenter?: boolean): void;
    /**
     * 边界夹紧：保持当前 left/top 不变的前提下，确保弹窗不超出容器
     * 说明：用于 fitHeight / fitWidth 后的“尺寸变化”场景，避免弹窗被裁切。
     */
    private clampToContainer;
    /**
     * 初始化弹窗位置
     */
    private initPosition;
    /**
     * 初始化拖拽功能 (性能优化 + 解决粘手)
     */
    private initDrag;
    /**
     * 初始化缩放功能 (性能优化 + 解决粘手)
     */
    private initResize;
    /**
     * 动态设置内容
     * @param content 内容元素或 HTML 字符串
     */
    setContent(content: HTMLElement | string): void;
    /**
     * 关闭弹窗并销毁
     */
    close(): void;
    /**
     * 销毁组件 (接口实现)
     */
    destroy(): void;
}

export declare class BimEngine extends EventEmitter {
    container: HTMLElement;
    private wrapper;
    toolbar: ToolbarManager | null;
    constructTreeBtn: ConstructTreeManagerBtn | null;
    buttonGroup: ButtonGroupManager | null;
    dialog: DialogManager | null;
    engine: EngineManager | null;
    rightKey: RightKeyManager | null;
    propertyPanel: PropertyPanelManager | null;
    measure: MeasureDialogManager | null;
    sectionPlane: SectionPlaneDialogManager | null;
    sectionAxis: SectionAxisDialogManager | null;
    sectionBox: SectionBoxDialogManager | null;
    walkControl: WalkControlManager | null;
    map: MapDialogManager | null;
    constructor(container: HTMLElement | string, options?: {
        locale?: LocaleType;
        theme?: ThemeType;
    });
    emit<K extends keyof EngineEvents>(event: K, payload: EngineEvents[K]): void;
    on<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): () => void;
    setLocale(locale: LocaleType): void;
    getLocale(): LocaleType;
    setTheme(theme: 'dark' | 'light'): void;
    setCustomTheme(theme: ThemeConfig): void;
    private init;
    private updateTheme;
    destroy(): void;
}

/**
 * 树节点类
 * 负责渲染单个节点、处理交互和递归
 */
declare class BimTreeNode {
    config: TreeNodeConfig;
    element: HTMLElement;
    children: BimTreeNode[];
    parent: BimTreeNode | null;
    checkState: TreeNodeCheckState;
    private contentEl;
    private switcherEl;
    private checkboxEl;
    private titleEl;
    private actionsEl;
    private childrenContainer;
    private onExpandChange;
    private onCheckChange;
    private onNodeClick;
    private renderActions?;
    constructor(config: TreeNodeConfig, options: TreeOptions, callbacks: {
        onExpand: (n: BimTreeNode) => void;
        onCheck: (n: BimTreeNode) => void;
        onClick: (n: BimTreeNode) => void;
    });
    /**
     * 创建节点 DOM
     */
    private createDom;
    /**
     * 设置高亮选中状态 (Select 模式下)
     */
    setSelected(selected: boolean): void;
    /**
     * 更新显示文本 (国际化支持) -> 移除国际化，直接显示
     */
    updateLabel(): void;
    /**
     * 切换展开状态
     */
    toggleExpand(force?: boolean): void;
    /**
     * 切换选中状态 (用户点击)
     */
    toggleCheck(): void;
    /**
     * 设置选中状态 (API调用或联动)
     * @param state 新状态
     * @param fireEvent 是否触发事件
     */
    setChecked(state: TreeNodeCheckState, fireEvent?: boolean): void;
    /**
     * 更新复选框 UI 样式
     */
    updateCheckboxUI(): void;
    /**
     * 添加子节点实例
     */
    appendChild(childNode: BimTreeNode): void;
    /**
     * 销毁
     */
    destroy(): void;
}

/** 按钮内部文字图标排列 */
declare type ButtonAlign = 'vertical' | 'horizontal';

/** 按钮配置 */
export declare interface ButtonConfig {
    id: string;
    type: ButtonType;
    label: string;
    icon?: string;
    keepActive?: boolean;
    /**
     * 是否互斥（开关互斥）
     *
     * 行为说明：
     * - 当按钮从“未激活”切换到“激活”时，如果该按钮开启了 exclusive，
     *   会自动关闭同互斥范围内的其它已激活按钮，并触发它们的 onClick（用于执行关闭逻辑）。
     * - 一级按钮：互斥范围 = 同 groupId 下的一级按钮
     * - 二级按钮：互斥范围 = 同 groupId 且同 parentId 下的二级按钮
     *
     * 注意：该能力通常与 keepActive 搭配使用。
     */
    exclusive?: boolean;
    isActive?: boolean;
    disabled?: boolean;
    onClick?: (button: OptButton) => void;
    children?: ButtonConfig[];
    groupId?: string;
    parentId?: string;
    /** 按钮内部图标文字排列 (默认 vertical，即图标在上) */
    align?: ButtonAlign;
    /** 图标大小 (正方形，单位 px，默认 32) */
    iconSize?: number;
    /** 按钮最小宽度 (单位 px，默认 50) */
    minWidth?: number;
}

declare interface ButtonGroupColors {
    backgroundColor?: string;
    btnBackgroundColor?: string;
    btnHoverColor?: string;
    btnActiveColor?: string;
    iconColor?: string;
    iconActiveColor?: string;
    textColor?: string;
    textActiveColor?: string;
}

/**
 * 通用按钮组管理器 (ButtonGroupManager)
 * 负责创建和管理通用的按钮组实例。
 */
declare class ButtonGroupManager extends BimComponent {
    private groups;
    private container;
    constructor(engine: BimEngine, container: HTMLElement);
    create(id: string, options: Omit<ButtonGroupOptions, 'container'>): BimButtonGroup;
    get(id: string): BimButtonGroup | undefined;
    updateTheme(theme: ThemeConfig): void;
    destroy(): void;
}

export declare interface ButtonGroupOptions extends ButtonGroupColors {
    container: HTMLElement | string;
    /** 屏幕位置 (如 top-left) */
    position?: GroupPosition;
    /** 按钮组排列方向 (默认 row) */
    direction?: GroupDirection;
    /** 按钮内部图标文字排列 (默认 vertical) */
    align?: ButtonAlign;
    /** 菜单展开方向 */
    expand?: ExpandDirection;
    showLabel?: boolean;
    visibility?: Record<string, boolean>;
    className?: string;
}

declare type ButtonType = 'button' | 'menu';

/**
 * 角色模型类型
 */
declare type CharacterModel = 'office-male' | 'construction-worker';

export declare interface CollapseItemConfig {
    /** 唯一标识符 */
    id: string;
    /** 标题文本的翻译键 (例如 'panel.attributes') */
    title: string;
    /** 内容: HTML字符串 或 HTMLElement */
    content: string | HTMLElement;
    /** 标题栏左侧图标 (SVG 字符串, 可选) */
    icon?: string;
    /** 标题栏右侧额外内容 (可选) */
    extra?: string | HTMLElement;
    /** 是否禁用 */
    disabled?: boolean;
    /** 自定义类名 */
    className?: string;
}

export declare interface CollapseOptions {
    /** 挂载容器 */
    container: HTMLElement | string;
    /** 面板项列表 */
    items: CollapseItemConfig[];
    /** 是否开启手风琴模式 (默认 false) */
    accordion?: boolean;
    /** 初始展开的面板 ID 列表 */
    activeIds?: string[];
    /** 是否显示边框 (默认 true) */
    bordered?: boolean;
    /** 是否幽灵模式 (默认 false) */
    ghost?: boolean;
    /** 自定义类名 */
    className?: string;
    /** 切换面板时的回调 */
    onChange?: (activeIds: string[]) => void;
}

/**
 * 底部工具栏管理器 (ToolbarManager)
 * 仅负责管理底部工具栏实例。
 */
declare class ConstructTreeManagerBtn extends BimComponent {
    private toolbar;
    private toolbarContainer;
    private container;
    private dialog;
    constructor(engine: BimEngine, container: HTMLElement);
    private init;
    openConstructTreeDialog(): void;
    refresh(): void;
    destroy(): void;
    addGroup(groupId: string, beforeGroupId?: string): void;
    addButton(config: ButtonConfig): void;
    setButtonVisibility(id: string, v: boolean): void;
    setShowLabel(show: boolean): void;
    setVisible(visible: boolean): void;
    setBackgroundColor(color: string): void;
    setColors(colors: ButtonGroupColors): void;
}

/**
 * 描述列表项配置
 */
export declare interface DescriptionItem {
    /** 标签文本 (直接显示，组件内部不翻译) */
    label: string;
    /** 内容文本或元素 */
    value: string | HTMLElement;
    /** 行级自定义标签颜色 */
    labelColor?: string;
    /** 行级自定义内容颜色 */
    valueColor?: string;
    /** 自定义类名 */
    className?: string;
}

/**
 * 描述列表组件配置
 */
export declare interface DescriptionOptions {
    /** 挂载容器 */
    container: HTMLElement | string;
    /** 数据项列表 */
    items: DescriptionItem[];
    /**
     * 是否显示边框 (默认 false)
     * 开启后，将显示行间分割线以及 Key-Value 之间的纵向分割线
     */
    bordered?: boolean;
    /** 标签固定宽度 (例如 '80px')，若不设置则自适应 */
    labelWidth?: string;
    /** 全局标签颜色 */
    labelColor?: string;
    /** 全局内容颜色 */
    valueColor?: string;
    /** 全局字体大小 */
    fontSize?: string;
    /** 标签内边距 (默认 '0 4px') */
    labelPadding?: string;
    /** 内容内边距 (默认 '0 4px') */
    valuePadding?: string;
    /** 自定义类名 */
    className?: string;
}

/**
 * 弹窗颜色配置
 */
declare interface DialogColors {
    /** 窗体背景颜色，默认 rgba(17, 17, 17, 0.95) */
    backgroundColor?: string;
    /** 标题栏背景颜色，默认 #2a2a2a */
    headerBackgroundColor?: string;
    /** 标题文字颜色，默认 #fff */
    titleColor?: string;
    /** 内容文字颜色，默认 #ccc */
    textColor?: string;
    /** 边框颜色，默认 #444 */
    borderColor?: string;
}

/**
 * 弹窗管理器
 * 负责创建和管理应用中的各类弹窗。
 */
declare class DialogManager extends BimComponent {
    /** 弹窗挂载的父容器 */
    private container;
    /** 活跃的弹窗实例列表 */
    private activeDialogs;
    /**
     * 构造函数
     * @param engine 引擎实例
     * @param container 弹窗挂载的目标容器
     */
    constructor(engine: BimEngine, container: HTMLElement);
    /**
     * 创建一个通用弹窗
     * @param options 弹窗配置选项（不需要传 container，自动使用管理器绑定的容器）
     * @returns BimDialog 实例
     */
    create(options: Omit<DialogOptions, 'container'>): BimDialog;
    /**
     * 显示二次封装的模型信息弹窗
     * 演示如何调用特定的业务弹窗组件
     */
    showInfoDialog(): void;
    /**
     * 响应全局主题变更
     * @param theme 全局主题配置
     */
    updateTheme(theme: ThemeConfig): void;
    destroy(): void;
}

/**
 * 弹窗配置选项接口
 */
export declare interface DialogOptions extends DialogColors {
    /** 弹窗挂载的父容器 */
    container: HTMLElement;
    /** 弹窗标题 */
    title?: string;
    /** 弹窗内容，支持 HTML 字符串或 HTMLElement */
    content?: HTMLElement | string;
    /** 弹窗宽度，数字（像素）或字符串（如 '50%'） */
    width?: number | string;
    /** 弹窗高度 */
    height?: number | string;
    /** 弹窗位置 */
    position?: DialogPosition;
    /** 是否可拖拽 */
    draggable?: boolean;
    /** 是否可调整大小 */
    resizable?: boolean;
    /** 最小宽度限制 */
    minWidth?: number;
    /** 最小高度限制 */
    minHeight?: number;
    /** 关闭时的回调函数 */
    onClose?: () => void;
    /** 打开时的回调函数 */
    onOpen?: () => void;
    /** 弹窗唯一标识 ID (可选) */
    id?: string;
}

/**
 * 弹窗位置类型定义
 * 可以是预设的字符串位置（如 'center', 'top-left' 等），
 * 也可以是具体的坐标对象 { x, y }
 */
export declare type DialogPosition = 'center' | 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | {
    x: number;
    y: number;
};

export declare interface EngineEvents {
    'ui:open-dialog': {
        id: string;
        data?: any;
    };
    'ui:close-dialog': {
        id: string;
    };
    'engine:model-loaded': {
        url: string;
    };
    'engine:object-clicked': {
        objectId: string;
        position: {
            x: number;
            y: number;
            z: number;
        };
    };
    'ui:tree-node-check': {
        id: string;
        checked: boolean;
        node: any;
    };
    'ui:tree-node-select': {
        id: string;
        selected: boolean;
        node: any;
    };
    'ui:tree-node-expand': {
        id: string;
        expanded: boolean;
    };
    'ui:collapse-change': {
        activeIds: string[];
    };
    'sys:theme-changed': {
        theme: string;
    };
    'sys:locale-changed': {
        locale: string;
    };
    'walk:path-mode-toggle': {
        isActive: boolean;
    };
    'walk:walk-mode-toggle': {
        isActive: boolean;
    };
    'walk:plan-view-toggle': {
        isActive: boolean;
    };
    'walk:speed-change': {
        speed: number;
    };
    'walk:gravity-toggle': {
        enabled: boolean;
    };
    'walk:collision-toggle': {
        enabled: boolean;
    };
    'map:opened': {};
    'map:closed': {};
}

/**
 * 3D 引擎管理器
 * 负责连接 Engine 组件和 BimEngine，向外部暴露简化的 API
 * 采用延迟初始化模式，用户需主动调用 initialize() 方法
 */
declare class EngineManager extends BimComponent {
    /** 3D 引擎挂载的父容器 */
    private container;
    /** 3D 引擎组件实例 */
    private engineInstance;
    rightKey: RightKeyManager | null;
    /**
     * 构造函数
     * @param engine 引擎实例
     * @param container 3D 引擎挂载的目标容器
     */
    constructor(engine: BimEngine, container: HTMLElement);
    /**
     * 初始化 3D 引擎
     * @param options 引擎配置选项（可选，如果不提供则使用默认配置）
     * @returns 是否初始化成功
     */
    initialize(options?: Omit<EngineOptions, 'container'>): boolean;
    /**
     * 检<EFBFBD><EFBFBD><EFBFBD> 3D 引擎是否已初始化
     */
    isInitialized(): boolean;
    /**
     * 加载 3D 模型
     * @param url 模型文件 URL
     * @param options 加载选项（位置、旋转、缩放）
     */
    loadModel(url: string, options?: ModelLoadOptions): void;
    /**
     * 获取原始 3D 引擎实例
     * 用于直接调用第三方引擎的其他 API
     */
    getEngine(): any;
    /**
     * 回到主视角
     */
    CameraGoHome(): void;
    /**
     * 激活测量功能
     * @param mode 测量类型
     */
    activateMeasure(mode: MeasureMode): void;
    /**
     * 停用测量功能
     */
    deactivateMeasure(): void;
    /**
     * 获取当前激活的测量类型
     */
    getCurrentMeasureType(): MeasureMode | null;
    /**
     * 销毁 3D 引擎实例
     */
    destroy(): void;
}

/**
 * 引擎配置选项
 * 用于 Engine 组件的初始化
 */
export declare interface EngineOptions {
    /** 容器元素 */
    container: HTMLElement;
    /** 背景颜色（十六进制数字如 0x333333，或 CSS 字符串如 'linear-gradient(...)'） */
    backgroundColor?: number | string;
    /** WebGL 版本 */
    version?: 'v1' | 'v2';
    /** 是否显示性能统计 */
    showStats?: boolean;
    /** 是否显示视图立方体 */
    showViewCube?: boolean;
}

declare class EventEmitter {
    private events;
    on(event: string, listener: Listener): () => void;
    off(event: string, listener: Listener): void;
    emit(event: string, payload?: any): void;
    clear(): void;
}

/** 二级菜单展开方向 */
declare type ExpandDirection = 'up' | 'down' | 'left' | 'right';

/** 按钮组排列方向 (Flex-direction) */
declare type GroupDirection = 'row' | 'column';

/** 弹窗/按钮组位置 */
declare type GroupPosition = 'center' | 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | {
    x: number;
    y: number;
} | 'static';

/**
 * BIM 引擎组件通用接口
 * 所有受引擎管理的 UI 组件都必须实现此接口
 */
export declare interface IBimComponent {
    /**
     * 初始化组件
     * 用于创建 DOM、绑定事件、加载资源等
     * 支持同步或异步操作
     */
    init(): void | Promise<void>;
    /**
     * 设置主题
     * 组件应在此方法中将 ThemeConfig 映射为自身的 CSS 变量或样式
     */
    setTheme(theme: ThemeConfig): void;
    /**
     * 设置语言
     */
    setLocales(): void;
    /**
     * 销毁组件
     * 清理 DOM 事件监听、定时器和引用
     */
    destroy(): void;
}

declare type Listener<T = any> = (payload: T) => void;

/**
 * 语言<EFBFBD><EFBFBD>码类型
 */
declare type LocaleType = 'zh-CN' | 'en-US';

/**
 * 地图弹窗管理器（独立通用组件）
 */
declare class MapDialogManager extends BimComponent {
    private dialogId;
    private dialog;
    private panel;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示弹窗
     */
    show(): void;
    /**
     * 隐藏弹窗
     */
    hide(): void;
    /**
     * 检查地图是否打开
     */
    isOpen(): boolean;
    /**
     * 销毁弹窗和面板
     */
    destroy(): void;
}

/**
 * 测量配置项（由组件内部维护默认值，并读取/写入缓存）
 */
declare interface MeasureConfig {
    unit: MeasureUnit;
    precision: MeasurePrecision;
}

/**
 * 测量弹窗管理器
 */
declare class MeasureDialogManager extends BimComponent {
    private dialogId;
    private dialog;
    private panel;
    /**
     * 测量配置项（单位/精度）
     * 说明：MeasurePanel 会自行从缓存加载默认配置，Manager 这里只做“对外读取/设置”的镜像。
     */
    private config;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示测量弹窗
     */
    show(): void;
    /**
     * 获取当前测量方式
     * 说明：如果面板未创建，则返回 null
     */
    getActiveMode(): MeasureMode | null;
    /**
     * 切换测量方式（你要求的“切换类型的方法”）
     * @param mode 测量方式
     */
    switchMode(mode: MeasureMode): void;
    /**
     * 设置测量结果（推荐使用的新方法名）
     * 说明：内部直接调用 MeasurePanel.setResult()
     * @param result 测量结果；传 null 表示清空
     */
    setMeasureResult(result: MeasureResult | null): void;
    /**
     * 获取测量配置（单位/精度）
     * - 如果面板存在：返回面板当前配置
     * - 否则：返回 Manager 缓存的最后一次配置（可能为 null）
     */
    getConfig(): MeasureConfig | null;
    /**
     * 设置测量配置（单位/精度）
     * @param partial 部分更新
     * @param persist 是否写入缓存（默认 true）
     */
    setConfig(partial: Partial<MeasureConfig>, persist?: boolean): void;
    /**
     * 删除全部（仅清空 UI；真实测量清理逻辑后续再接）
     */
    clearAll(): void;
    /**
     * 打开设置（仅预留方法/回调）
     */
    openSettings(): void;
    destroy(): void;
}

/**
 * 测量相关的通用类型定义
 *
 * 说明：
 * - 这些类型定义在通用 types 目录下，避免组件间直接耦合
 * - Engine 组件、MeasurePanel 组件、Manager 都可以引用这些类型
 */
/**
 * 测量方式（8 种）
 *
 * 说明：
 * - id 采用英文驼峰/小写，便于程序内部使用
 * - 显示名称必须通过国际化 key 获取（见 locales）
 */
declare type MeasureMode = 'distance' | 'minDistance' | 'angle' | 'elevation' | 'volume' | 'laserDistance' | 'slope' | 'spaceVolume';

/**
 * 精度（小数位数）
 * - 0   -> 0
 * - 1   -> 0.0
 * - 2   -> 0.00
 * - 3   -> 0.000
 */
declare type MeasurePrecision = 0 | 1 | 2 | 3;

/**
 * 测量结果数据
 *
 * 说明：
 * - 真实测量未实现，因此结果由外部通过 setResult 传入。
 * - 不同测量方式对应不同字段；未传入则 UI 显示 “--”。
 */
declare interface MeasureResult {
    /** 距离（单位：mm） */
    distanceMm?: number;
    /** 最小距离（单位：mm） */
    minDistanceMm?: number;
    /** 角度（单位：deg） */
    angleDeg?: number;
    /** 标高（单位：mm） */
    elevationMm?: number;
    /** 体积（单位：m³） */
    volumeM3?: number;
    /** 激光测距（单位：mm） */
    laserDistanceMm?: number;
    /** 坡度（单位：%） */
    slopePercent?: number;
    /** 空间体积（单位：m³） */
    spaceVolumeM3?: number;
    /** 可选：展示测量点/结果点坐标（单位由引擎侧定义，这里只负责显示） */
    xyz?: MeasureXYZ;
}

/**
 * 距离/标高等“长度类”单位
 */
declare type MeasureUnit = 'm' | 'cm' | 'mm' | 'km';

/**
 * 3D 坐标（可选展示）
 */
declare interface MeasureXYZ {
    x: number;
    y: number;
    z: number;
}

/**
 * 菜单项配置接口 (用于简化的对象配置)
 */
declare interface MenuItemConfig {
    id: string;
    label: string;
    onClick?: () => void;
    icon?: string;
    group?: string;
    order?: number;
    children?: MenuItemConfig[];
    disabled?: boolean;
    visible?: boolean;
}

/**
 * 模型加载选项
 * 用于配置模型的位置、旋转和缩放
 */
export declare interface ModelLoadOptions {
    /** 模型初始位置 [x, y, z] */
    position?: [number, number, number];
    /** 模型初始旋转 [x, y, z]（弧度） */
    rotation?: [number, number, number];
    /** 模型初始缩放 [x, y, z] */
    scale?: [number, number, number];
    /** 模型 ID（可选，如果不提供则自动生成） */
    id?: string;
}

/**
 * 节点点击行为类型
 */
export declare type NodeClickAction = 'select' | 'expand';

declare interface OptButton extends ButtonConfig {
    children?: OptButton[];
}

/**
 * 属性面板管理器
 * 负责展示和管理属性面板弹窗 (演示 Tab + Collapse + Description 组件)
 */
declare class PropertyPanelManager extends BimComponent {
    private dialogId;
    private dialog;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示属性面板
     */
    show(): void;
    /**
     * 创建"属性"标签页的内容 (包含 Collapse)
     */
    private createPropsTabContent;
    /**
     * 创建"材质"标签页的内容 (包含 Collapse)
     */
    private createMaterialTabContent;
    private createBaseInfoContent;
    private createAdvancedInfoContent;
    private createMaterialContent;
    /**
     * 检查属性面板是否打开
     */
    isOpen(): boolean;
    /**
     * 隐藏属性面板
     */
    hide(): void;
    destroy(): void;
}

/**
 * 右键菜单管理器 (RightKeyManager)
 * 负责协调右键交互流程：
 * 1. 监听 Canvas/容器的 contextmenu 事件
 * 2. 通过注册的处理器 (Handler) 获取需要显示的菜单项
 * 3. 实例化 Menu 组件并装载到 RightKey 容器中显示
 */
declare class RightKeyManager extends BimComponent {
    private container;
    private rightKeyPanel;
    private contextHandlers;
    constructor(engine: BimEngine, container: HTMLElement);
    destroy(): void;
    /**
     * 注册上下文菜单处理器
     * @param handler 处理函数，接收鼠标事件，返回菜单项数组
     */
    registerHandler(handler: (e: MouseEvent) => MenuItemConfig[] | null): void;
    /**
     * 手动显示菜单
     * 允许外部直接调用以显示特定的菜单，不一定依赖右键事件
     * @param x 屏幕 X 坐标
     * @param y 屏幕 Y 坐标
     * @param items 菜单项列表
     * @param groupOrder 可选的分组顺序
     */
    showMenu(x: number, y: number, items: MenuItemConfig[], groupOrder?: string[]): void;
    /**
     * 隐藏右键菜单
     */
    hide(): void;
    /**
     * 处理右键点击事件
     * 由 BimRightKey 组件在检测到有效右键点击时调用
     */
    private handleContextMenu;
}

/**
 * 轴向类型
 */
declare type SectionAxis = 'x' | 'y' | 'z';

/**
 * 轴向剖切弹窗管理器
 */
declare class SectionAxisDialogManager extends BimComponent {
    private dialogId;
    private dialog;
    private panel;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示弹窗
     */
    show(): void;
    /**
     * 隐藏弹窗
     */
    hide(): void;
    /**
     * 获取隐藏状态
     */
    getHiddenState(): boolean;
    /**
     * 设置隐藏状态
     */
    setHiddenState(isHidden: boolean): void;
    /**
     * 获取当前激活的轴向
     */
    getActiveAxis(): SectionAxis;
    /**
     * 设置激活的轴向
     */
    setActiveAxis(axis: SectionAxis): void;
    /**
     * 销毁弹窗和面板
     */
    destroy(): void;
}

/**
 * 剖切盒轴向范围
 */
declare interface SectionBoxAxisRange {
    /** 最小值（0-100的百分比） */
    min: number;
    /** 最大值（0-100的百分比） */
    max: number;
}

/**
 * 剖切盒弹窗管理器
 */
declare class SectionBoxDialogManager extends BimComponent {
    private dialogId;
    private dialog;
    private panel;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示弹窗
     */
    show(): void;
    /**
     * 隐藏弹窗
     */
    hide(): void;
    /**
     * 获取隐藏状态
     */
    getHiddenState(): boolean;
    /**
     * 设置隐藏状态
     */
    setHiddenState(isHidden: boolean): void;
    /**
     * 获取反向状态
     */
    getReversedState(): boolean;
    /**
     * 设置反向状态
     */
    setReversedState(isReversed: boolean): void;
    /**
     * 获取范围值
     */
    getRange(): SectionBoxRange | null;
    /**
     * 设置范围值
     */
    setRange(range: Partial<SectionBoxRange>): void;
    /**
     * 销毁弹窗和面板
     */
    destroy(): void;
}

/**
 * 剖切盒范围数据
 */
declare interface SectionBoxRange {
    /** X轴范围 */
    x: SectionBoxAxisRange;
    /** Y轴范围 */
    y: SectionBoxAxisRange;
    /** Z轴范围 */
    z: SectionBoxAxisRange;
}

/**
 * 拾取面剖切弹窗管理器
 */
declare class SectionPlaneDialogManager extends BimComponent {
    private dialogId;
    private dialog;
    private panel;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示拾取面剖切弹窗
     */
    show(): void;
    /**
     * 隐藏弹窗
     */
    hide(): void;
    /**
     * 销毁弹窗
     */
    destroy(): void;
}

/**
 * 全局主题配置接口
 * 定义系统通用的语义化颜色
 */
export declare interface ThemeConfig {
    /** 主题名称 */
    name: string;
    /** 品牌色/主色 */
    primary: string;
    /** 主色悬停/激活态 */
    primaryHover: string;
    /** 基础背景色 (应用整体背景) */
    background: string;
    /** 面板背景色 (工具栏、弹窗背景) */
    panelBackground: string;
    /** 主要文字颜色 */
    textPrimary: string;
    /** 次要文字颜色 */
    textSecondary: string;
    /** 边框/分割线颜色 */
    border: string;
    /** 图标默认颜色 */
    icon: string;
    /** 图标激活颜色 */
    iconActive: string;
    /** 交互组件背景 (如按钮默认背景) */
    componentBackground: string;
    /** 交互组件悬停背景 */
    componentHover: string;
    /** 交互组件激活背景 */
    componentActive: string;
}

/**
 * 主题类型定义
 */
export declare type ThemeType = 'dark' | 'light' | 'custom';

/**
 * 底部工具栏管理器 (ToolbarManager)
 * 仅负责管理底部工具栏实例。
 */
declare class ToolbarManager extends BimComponent {
    private toolbar;
    private toolbarContainer;
    private container;
    constructor(engine: BimEngine, container: HTMLElement);
    private init;
    updateTheme(theme: ThemeConfig): void;
    refresh(): void;
    destroy(): void;
    addGroup(groupId: string, beforeGroupId?: string): void;
    addButton(config: ButtonConfig): void;
    setButtonVisibility(id: string, v: boolean): void;
    setShowLabel(show: boolean): void;
    setBtnActive(id: string, active?: boolean): void;
    setVisible(visible: boolean): void;
    setBackgroundColor(color: string): void;
    setColors(colors: ButtonGroupColors): void;
    /**
     * 隐藏工具栏
     */
    hide(): void;
    /**
     * 显示工具栏
     */
    show(): void;
    /**
     * 获取工具栏容器
     */
    getContainer(): HTMLElement | null;
}

/**
 * 节点勾选状态枚举
 */
export declare enum TreeNodeCheckState {
    Unchecked = 0,
    Checked = 1,
    Indeterminate = 2
}

/**
 * 树节点配置接口
 */
export declare interface TreeNodeConfig {
    /** 唯一标识符 */
    id: string;
    /** 显示文本的翻译键 */
    label: string;
    /** 节点图标 (SVG string 或 URL) */
    icon?: string;
    /** 子节点列表 */
    children?: TreeNodeConfig[];
    /** 初始展开状态 (默认 false) */
    expanded?: boolean;
    /** 初始选中状态 (默认 false) */
    checked?: boolean;
    /** 是否禁用 (默认 false) */
    disabled?: boolean;
    /** 自定义业务数据 */
    data?: any;
    /** 是否是叶子节点 (用于异步加载场景，暂留接口) */
    isLeaf?: boolean;
    /** 点击整行的行为 (默认 'select') */
    clickAction?: NodeClickAction;
}

/**
 * 树组件配置选项
 */
export declare interface TreeOptions {
    /** 树的数据源 */
    data: TreeNodeConfig[];
    /** 是否显示复选框 (默认 true) */
    checkable?: boolean;
    /**
     * 父子节点选中状态是否关联 (默认 true)
     * true: 选中父选子，子全选自动选父
     * false: 独立选中
     */
    checkStrictly?: boolean;
    /** 默认展开所有节点 (默认 false) */
    defaultExpandAll?: boolean;
    /** 缩进宽度 (像素，默认 24) */
    indent?: number;
    /** 是否启用搜索功能 (默认 false) */
    enableSearch?: boolean;
    /** 搜索框占位符 */
    searchPlaceholder?: string;
    /** 节点勾选回调 */
    onNodeCheck?: (node: BimTreeNode) => void;
    /** 节点选择回调 */
    onNodeSelect?: (node: BimTreeNode) => void;
    /** 节点展开/折叠回调 */
    onNodeExpand?: (node: BimTreeNode) => void;
    /**
     * 选中时显示的自定义操作栏渲染函数
     * 返回 HTML 字符串或 HTMLElement
     */
    renderActions?: (node: TreeNodeConfig) => HTMLElement | string;
}

/**
 * 漫游控制管理器
 */
declare class WalkControlManager extends BimComponent {
    panel: WalkControlPanel | null;
    private pathManager;
    constructor(engine: BimEngine);
    init(): void;
    /**
     * 显示漫游控制面板
     */
    show(): void;
    /**
     * 隐藏漫游控制面板
     */
    hide(): void;
    /**
     * 销毁管理器
     */
    destroy(): void;
}

/**
 * 漫游控制模式
 */
declare type WalkControlMode = 'none' | 'path' | 'walk';

declare class WalkControlPanel implements IBimComponent {
    element: HTMLElement;
    private options;
    private state;
    private planViewBtn;
    private pathModeBtn;
    private walkModeBtn;
    private settingsContainer;
    private speedControl;
    private speedDecreaseBtn;
    private speedIncreaseBtn;
    private speedDisplay;
    private gravityCheckbox;
    private gravityLabel;
    private collisionCheckbox;
    private collisionLabel;
    private characterModelSelect;
    private characterModelLabel;
    private walkModeSelect;
    private walkModeLabel;
    private exitBtn;
    private unsubscribeLocale;
    private unsubscribeTheme;
    constructor(options?: WalkControlPanelOptions);
    init(): void;
    setPlanViewActive(active: boolean): void;
    setPathModeActive(active: boolean): void;
    getState(): WalkControlState;
    private createPanel;
    private createLeftButtons;
    private createSettingsContainer;
    private createSpeedControl;
    private createIconButton;
    private createExitButton;
    private setMode;
    private updateButtonStates;
    private updateSettingsView;
    private updateSpeedDisplay;
    private updateSpeedButtonStates;
    private getIconSVG;
    setLocales(): void;
    setTheme(theme: ThemeConfig): void;
    destroy(): void;
}

/**
 * 漫游控制面板配置选项
 */
declare interface WalkControlPanelOptions {
    /** 平面图切换回调 */
    onPlanViewToggle?: (isActive: boolean) => void;
    /** 路径漫游模式切换回调 */
    onPathModeToggle?: (isActive: boolean) => void;
    /** 漫游模式切换回调 */
    onWalkModeToggle?: (isActive: boolean) => void;
    /** 速度变化回调 */
    onSpeedChange?: (speed: number) => void;
    /** 重力切换回调 */
    onGravityToggle?: (enabled: boolean) => void;
    /** 碰撞切换回调 */
    onCollisionToggle?: (enabled: boolean) => void;
    /** 角色模型变化回调 */
    onCharacterModelChange?: (model: CharacterModel) => void;
    /** 行走模式变化回调 */
    onWalkModeChange?: (mode: WalkMode) => void;
    /** 退出回调 */
    onExit?: () => void;
    /** 默认速度 (0-100) */
    defaultSpeed?: number;
    /** 默认重力状态 */
    defaultGravity?: boolean;
    /** 默认碰撞状态 */
    defaultCollision?: boolean;
    /** 默认角色模型 */
    defaultCharacterModel?: CharacterModel;
    /** 默认行走模式 */
    defaultWalkMode?: WalkMode;
}

/**
 * 漫游控制状态
 */
declare interface WalkControlState {
    /** 当前模式 */
    mode: WalkControlMode;
    /** 平面图是否激活 */
    isPlanViewActive: boolean;
    /** 移动速度 (0-100) */
    speed: number;
    /** 重力是否启用 */
    gravity: boolean;
    /** 碰撞是否启用 */
    collision: boolean;
    /** 当前角色模型 */
    characterModel: CharacterModel;
    /** 当前行走模式 */
    walkMode: WalkMode;
}

/**
 * 行走模式类型
 */
declare type WalkMode = 'walk' | 'run';

export { }