iflow-engine 1.0.7 → 1.0.8

package/dist/engine/src/components/button-group/index.d.ts

@@ -0,0 +1,89 @@
+import { ButtonGroupOptions, ButtonConfig, ButtonGroupColors } from './index.type';
+import { ThemeConfig } from '../../themes/types';
+import { IBimComponent } from '../../types/component';
+import { EngineEvents } from '../../types/events';
+export 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;
+    private readonly DEFAULT_ICON;
+    constructor(options: ButtonGroupOptions);
+    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;
+    /**
+     * 应用主题系统的 CSS 变量到容器
+     * 供 glass-pill 等样式变体使用
+     */
+    private applyThemeCssVars;
+    /**
+     * 同步 CSS 变量到所有 dropdown 元素
+     * dropdown 被添加到 body，无法继承容器的 CSS 变量
+     */
+    private syncDropdownCssVars;
+    /**
+     * 直接设置颜色（强制覆盖）
+     * 设置的颜色会被标记为自定义，后续的 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;
+    setType(type: 'default' | 'glass-pill'): void;
+    getType(): 'default' | 'glass-pill';
+    destroy(): void;
+}

package/dist/engine/src/components/button-group/index.type.d.ts

@@ -0,0 +1,84 @@
+export type ButtonType = 'button' | 'menu';
+/** 按钮组样式类型 */
+export type ButtonGroupType = 'default' | 'glass-pill';
+/** 按钮配置 */
+export 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;
+}
+export interface OptButton extends ButtonConfig {
+    children?: OptButton[];
+}
+export interface ButtonGroup {
+    id: string;
+    buttons: OptButton[];
+}
+export interface ButtonGroupColors {
+    backgroundColor?: string;
+    btnBackgroundColor?: string;
+    btnHoverColor?: string;
+    btnActiveColor?: string;
+    iconColor?: string;
+    iconActiveColor?: string;
+    textColor?: string;
+    textActiveColor?: string;
+}
+/** 弹窗/按钮组位置 */
+export type GroupPosition = 'center' | 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | {
+    x: number;
+    y: number;
+} | 'static';
+/** 按钮组排列方向 (Flex-direction) */
+export type GroupDirection = 'row' | 'column';
+/** 按钮内部文字图标排列 */
+export type ButtonAlign = 'vertical' | 'horizontal';
+/** 二级菜单展开方向 */
+export type ExpandDirection = 'up' | 'down' | 'left' | 'right';
+export interface ButtonGroupOptions extends ButtonGroupColors {
+    container: HTMLElement | string;
+    /** 样式类型 (默认 'default') */
+    type?: ButtonGroupType;
+    /** 屏幕位置 (如 top-left) */
+    position?: GroupPosition;
+    /** 按钮组排列方向 (默认 row) */
+    direction?: GroupDirection;
+    /** 按钮内部图标文字排列 (默认 vertical) */
+    align?: ButtonAlign;
+    /** 菜单展开方向 */
+    expand?: ExpandDirection;
+    showLabel?: boolean;
+    visibility?: Record<string, boolean>;
+    className?: string;
+}
+export interface ClickPayload {
+    button: OptButton;
+    action: 'activate' | 'deactivate' | 'trigger';
+    isActive?: boolean;
+}

package/dist/engine/src/components/button-group/toolbar/buttons/ai-chat/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createAiChatButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/fullscreen/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createFullscreenButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/home/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createHomeButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/info/icon.d.ts

@@ -0,0 +1 @@
+export declare const infoIcon = "<svg viewBox=\"0 0 1024 1024\"><path d=\"M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm0 820c-205.4 0-372-166.6-372-372s166.6-372 372-372 372 166.6 372 372-166.6 372-372 372z\" fill=\"currentColor\"/><path d=\"M464 336a48 48 0 1 0 96 0 48 48 0 1 0-96 0zm72 112h-48c-4.4 0-8 3.6-8 8v272c0 4.4 3.6 8 8 8h48c4.4 0 8-3.6 8-8V456c0-4.4-3.6-8-8-8z\" fill=\"currentColor\"/></svg>";

package/dist/engine/src/components/button-group/toolbar/buttons/info/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createInfoButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/map/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createMapButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/measure/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createMeasureButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/property/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createPropertyButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/section/section-axis/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createSectionAxisButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/section/section-box/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createSectionBoxButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/section/section-menu/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createSectionMenuButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/section/section-plane/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createSectionPlaneButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/setting/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createSettingButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/walk/walk-bird/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createWalkBirdButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/walk/walk-menu/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createWalkMenuButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/walk/walk-person/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../../index.type';
+export declare const createWalkPersonButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/buttons/zoom-box/index.d.ts

@@ -0,0 +1,2 @@
+import { ButtonConfig } from '../../../index.type';
+export declare const createZoomBoxButton: () => ButtonConfig;

package/dist/engine/src/components/button-group/toolbar/index.d.ts

@@ -0,0 +1,4 @@
+import { BimButtonGroup } from '../index';
+export declare class Toolbar extends BimButtonGroup {
+    init(): Promise<void>;
+}

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

@@ -0,0 +1,21 @@
+import { CollapseOptions } from './types';
+import { IBimComponent } from '../../types/component';
+import { ThemeConfig } from '../../themes/types';
+/**
+ * 折叠面板组件
+ */
+export declare class BimCollapse implements IBimComponent {
+    private element;
+    private options;
+    private items;
+    private activeIds;
+    private unsubscribeLocale;
+    private unsubscribeTheme;
+    constructor(options: CollapseOptions);
+    init(): void;
+    toggleItem(id: string): void;
+    private refreshState;
+    setTheme(theme: ThemeConfig): void;
+    setLocales(): void;
+    destroy(): void;
+}

package/dist/engine/src/components/collapse/types.d.ts

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

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

@@ -0,0 +1,25 @@
+import { DescriptionOptions, DescriptionItem } from './types';
+import { IBimComponent } from '../../types/component';
+import { ThemeConfig } from '../../themes/types';
+/**
+ * 描述列表组件
+ * 用于展示一组 Key-Value 数据
+ * 注意：本组件为纯展示组件，不处理国际化，请在外部传入处理好的文本。
+ */
+export declare class BimDescription implements IBimComponent {
+    private element;
+    private options;
+    private unsubscribeTheme;
+    constructor(options: DescriptionOptions);
+    init(): void;
+    private createDom;
+    private applyCustomStyles;
+    private renderItems;
+    /**
+     * 动态更新数据
+     */
+    setItems(items: DescriptionItem[]): void;
+    setTheme(theme: ThemeConfig): void;
+    setLocales(): void;
+    destroy(): void;
+}

package/dist/engine/src/components/description/types.d.ts

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

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

@@ -0,0 +1,87 @@
+import { DialogOptions } from './index.type';
+import { ThemeConfig } from '../../themes/types';
+import { IBimComponent } from '../../types/component';
+/**
+ * 通用弹窗组件类
+ * 支持拖拽、缩放、自定义内容和位置。
+ */
+export 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;
+}

package/dist/engine/src/components/dialog/index.type.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 弹窗位置类型定义
+ * 可以是预设的字符串位置（如 'center', 'top-left' 等），
+ * 也可以是具体的坐标对象 { x, y }
+ */
+export type DialogPosition = 'center' | 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | {
+    x: number;
+    y: number;
+};
+/**
+ * 弹窗颜色配置
+ */
+export interface DialogColors {
+    /** 窗体背景颜色，默认 rgba(17, 17, 17, 0.95) */
+    backgroundColor?: string;
+    /** 标题栏背景颜色，默认 #2a2a2a */
+    headerBackgroundColor?: string;
+    /** 标题文字颜色，默认 #fff */
+    titleColor?: string;
+    /** 内容文字颜色，默认 #ccc */
+    textColor?: string;
+    /** 边框颜色，默认 #444 */
+    borderColor?: string;
+}
+/**
+ * 弹窗配置选项接口
+ */
+export 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;
+    /** 底部偏移量（用于避开底部工具栏），默认 70px */
+    bottomOffset?: number;
+    /** 关闭时的回调函数 */
+    onClose?: () => void;
+    /** 打开时的回调函数 */
+    onOpen?: () => void;
+    /** 弹窗唯一标识 ID (可选) */
+    id?: string;
+}