iflow-engine 1.0.6 → 1.0.8

package/dist/engine/src/themes/presets.d.ts

@@ -0,0 +1,15 @@
+import { ThemeConfig } from './types';
+/**
+ * Tailwind CSS 调色板参考（维护者参考）
+ *
+ * Slate: #f8fafc #f1f5f9 #e2e8f0 #cbd5e1 #94a3b8 #64748b #475569 #334155 #1e293b #0f172a
+ * Blue:  #eff6ff #dbeafe #bfdbfe #93c5fd #60a5fa #3b82f6 #2563eb #1d4ed8 #1e40af #1e3a8a
+ * Green: #f0fdf4 #dcfce7 #bbf7d0 #86efac #4ade80 #22c55e #16a34a #15803d #166534 #14532d
+ * Amber: #fffbeb #fef3c7 #fde68a #fcd34d #fbbf24 #f59e0b #d97706 #b45309 #92400e #78350f
+ * Red:   #fef2f2 #fee2e2 #fecaca #fca5a5 #f87171 #ef4444 #dc2626 #b91c1c #991b1b #7f1d1d
+ * Cyan:  #ecfeff #cffafe #a5f3fc #67e8f9 #22d3ee #06b6d4 #0891b2 #0e7490 #155e75 #164e63
+ */
+export declare const lightTheme: ThemeConfig;
+export declare const darkTheme: ThemeConfig;
+export declare function createThemeFromPartial(base: ThemeConfig, partial: Partial<ThemeConfig>): ThemeConfig;
+export declare function getThemeByName(name: string): ThemeConfig;

package/dist/engine/src/themes/types.d.ts

@@ -0,0 +1,261 @@
+/**
+ * BIM Engine SDK - Unified Theme System
+ *
+ * Design Principles:
+ * 1. Semantic naming - colors describe PURPOSE, not appearance
+ * 2. Hierarchical structure - organized by category for scalability
+ * 3. Complete coverage - all UI states and component needs
+ * 4. Accessibility - ensures proper contrast ratios
+ * 5. Glassmorphism support - includes transparency and blur values
+ *
+ * Color Palette Reference: Tailwind CSS (slate, blue, red, green, amber)
+ */
+/**
+ * Semantic Color Token
+ * Represents a single color value with optional transparency
+ */
+type ColorToken = string;
+/**
+ * Shadow Token
+ * CSS box-shadow value
+ */
+type ShadowToken = string;
+/**
+ * Blur Token
+ * CSS backdrop-filter blur value (e.g., '24px')
+ */
+type BlurToken = string;
+/**
+ * Complete Theme Configuration Interface
+ *
+ * All colors use semantic naming to describe their purpose.
+ * Components should map these to their internal CSS variables.
+ */
+export interface ThemeConfig {
+    /** Theme identifier: 'dark' | 'light' | custom name */
+    name: string;
+    /** Primary brand color - used for key actions, links, active states */
+    primary: ColorToken;
+    /** Primary color on hover */
+    primaryHover: ColorToken;
+    /** Primary color when pressed/active */
+    primaryActive: ColorToken;
+    /** Subtle primary for backgrounds (e.g., selected row) */
+    primarySubtle: ColorToken;
+    /** Success color - confirmations, completed states */
+    success: ColorToken;
+    /** Success color on hover */
+    successHover: ColorToken;
+    /** Subtle success for backgrounds */
+    successSubtle: ColorToken;
+    /** Warning color - caution, pending states */
+    warning: ColorToken;
+    /** Warning color on hover */
+    warningHover: ColorToken;
+    /** Subtle warning for backgrounds */
+    warningSubtle: ColorToken;
+    /** Danger/Error color - destructive actions, errors */
+    danger: ColorToken;
+    /** Danger color on hover */
+    dangerHover: ColorToken;
+    /** Subtle danger for backgrounds */
+    dangerSubtle: ColorToken;
+    /** Info color - informational states */
+    info: ColorToken;
+    /** Info color on hover */
+    infoHover: ColorToken;
+    /** Subtle info for backgrounds */
+    infoSubtle: ColorToken;
+    /** Base/canvas background - the deepest layer (app background) */
+    bgBase: ColorToken;
+    /** Elevated surface - panels, cards, dialogs floating above base */
+    bgElevated: ColorToken;
+    /** Overlay background - modals, dropdowns, popovers */
+    bgOverlay: ColorToken;
+    /** Inset/recessed background - inputs, wells, sunken areas */
+    bgInset: ColorToken;
+    /**
+     * Glassmorphism surface - semi-transparent with blur
+     * Used for floating toolbars, modern panels
+     */
+    bgGlass: ColorToken;
+    /** Glassmorphism blur amount */
+    bgGlassBlur: BlurToken;
+    /** Primary text - headings, body text, high emphasis */
+    textPrimary: ColorToken;
+    /** Secondary text - descriptions, labels, medium emphasis */
+    textSecondary: ColorToken;
+    /** Tertiary text - placeholders, hints, low emphasis */
+    textTertiary: ColorToken;
+    /** Disabled text - inactive elements */
+    textDisabled: ColorToken;
+    /** Inverted text - text on primary/dark backgrounds */
+    textInverse: ColorToken;
+    /** Link text color */
+    textLink: ColorToken;
+    /** Link text on hover */
+    textLinkHover: ColorToken;
+    /** Default icon color */
+    iconDefault: ColorToken;
+    /** Icon on hover */
+    iconHover: ColorToken;
+    /** Active/selected icon */
+    iconActive: ColorToken;
+    /** Disabled icon */
+    iconDisabled: ColorToken;
+    /** Inverted icon (on colored backgrounds) */
+    iconInverse: ColorToken;
+    /** Default border - inputs, cards, containers */
+    borderDefault: ColorToken;
+    /** Subtle border - dividers, separators */
+    borderSubtle: ColorToken;
+    /** Strong border - focus rings, emphasis */
+    borderStrong: ColorToken;
+    /** Disabled border */
+    borderDisabled: ColorToken;
+    /** Divider color - horizontal/vertical separators */
+    divider: ColorToken;
+    /**
+     * Component Background States
+     * Used for buttons, list items, interactive elements
+     */
+    /** Default component background (often transparent) */
+    componentBg: ColorToken;
+    /** Component background on hover */
+    componentBgHover: ColorToken;
+    /** Component background when pressed */
+    componentBgActive: ColorToken;
+    /** Component background when selected */
+    componentBgSelected: ColorToken;
+    /** Disabled component background */
+    componentBgDisabled: ColorToken;
+    /** Focus ring color */
+    focusRing: ColorToken;
+    /** Focus ring offset color (for contrast) */
+    focusRingOffset: ColorToken;
+    /** Selection background (text selection, highlighted items) */
+    selectionBg: ColorToken;
+    /** Selection text color */
+    selectionText: ColorToken;
+    /** Small shadow - subtle elevation (buttons, small cards) */
+    shadowSm: ShadowToken;
+    /** Medium shadow - moderate elevation (dropdowns, popovers) */
+    shadowMd: ShadowToken;
+    /** Large shadow - high elevation (modals, dialogs) */
+    shadowLg: ShadowToken;
+    /** Extra large shadow - maximum elevation */
+    shadowXl: ShadowToken;
+    /** Glow shadow for active/highlighted elements */
+    shadowGlow: ShadowToken;
+    /** Scrollbar track background */
+    scrollbarTrack: ColorToken;
+    /** Scrollbar thumb */
+    scrollbarThumb: ColorToken;
+    /** Scrollbar thumb on hover */
+    scrollbarThumbHover: ColorToken;
+    /** 浮动容器背景 (支持 rgba 实现毛玻璃效果) */
+    floatingBg: ColorToken;
+    /** 浮动容器边框 */
+    floatingBorder: ColorToken;
+    /** 浮动容器阴影 */
+    floatingShadow: ShadowToken;
+    /** 浮动按钮背景 */
+    floatingBtnBg: ColorToken;
+    /** 浮动按钮边框 */
+    floatingBtnBorder: ColorToken;
+    /** 浮动按钮阴影 */
+    floatingBtnShadow: ShadowToken;
+    /** 浮动按钮悬停背景 */
+    floatingBtnBgHover: ColorToken;
+    /** 浮动按钮悬停阴影 */
+    floatingBtnShadowHover: ShadowToken;
+    /** 浮动组件图标颜色 */
+    floatingIconColor: ColorToken;
+    /** 浮动组件图标悬停颜色 */
+    floatingIconColorHover: ColorToken;
+    /** 面板背景 (支持毛玻璃) */
+    panelBg: ColorToken;
+    /** 面板边框 */
+    panelBorder: ColorToken;
+    /** 面板 Header 背景 */
+    panelHeaderBg: ColorToken;
+    /** 面板圆角 */
+    panelRadius: string;
+    /** Tab 容器背景 */
+    tabBg: ColorToken;
+    /** Tab 项背景 */
+    tabItemBg: ColorToken;
+    /** Tab 项悬停背景 */
+    tabItemBgHover: ColorToken;
+    /** Tab 激活项背景 */
+    tabItemBgActive: ColorToken;
+    /** Tab 激活项文字颜色 */
+    tabItemTextActive: ColorToken;
+    /**
+     * Component-specific overrides
+     * Only define these when absolutely necessary
+     */
+    overrides?: {
+        /** Dialog specific colors */
+        dialog?: {
+            headerBg?: ColorToken;
+            footerBg?: ColorToken;
+        };
+        /** Toolbar specific colors */
+        toolbar?: {
+            bg?: ColorToken;
+            buttonBg?: ColorToken;
+            buttonBgHover?: ColorToken;
+            buttonBgActive?: ColorToken;
+        };
+        /** Input specific colors */
+        input?: {
+            bg?: ColorToken;
+            bgFocus?: ColorToken;
+            placeholder?: ColorToken;
+        };
+    };
+}
+/**
+ * Partial theme config for customization
+ * Allows users to override only specific tokens
+ */
+export type PartialThemeConfig = Partial<ThemeConfig> & {
+    name: string;
+};
+/**
+ * Theme type definition
+ */
+export type ThemeType = 'dark' | 'light' | 'custom';
+/**
+ * CSS Variable Name Mapping
+ *
+ * All CSS variables follow the pattern: --bim-{category}-{property}
+ *
+ * Categories:
+ * - primary, success, warning, danger, info (semantic colors)
+ * - bg (backgrounds)
+ * - text (typography)
+ * - icon (iconography)
+ * - border (borders)
+ * - component (interactive states)
+ * - shadow (elevation)
+ * - focus (focus states)
+ * - scrollbar (scrollbar styling)
+ */
+export declare const CSS_VAR_MAP: Record<keyof Omit<ThemeConfig, 'name' | 'overrides'>, string>;
+/**
+ * Maps old ThemeConfig properties to new ones
+ * Used for backward compatibility during migration
+ */
+export interface LegacyThemeMapping {
+    /** Old property name -> New property name */
+    background: 'bgBase';
+    panelBackground: 'bgElevated';
+    border: 'borderDefault';
+    icon: 'iconDefault';
+    componentBackground: 'componentBg';
+    componentHover: 'componentBgHover';
+    componentActive: 'componentBgActive';
+}
+export {};

package/dist/engine/src/types/component.d.ts

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

package/dist/engine/src/types/events.d.ts

@@ -0,0 +1,104 @@
+export 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;
+    };
+    'component:selected': {
+        url: string;
+        id: string;
+    };
+    'component:deselected': {};
+    'menu:show-all': {};
+    'section:move': {
+        x?: {
+            min: number;
+            max: number;
+        };
+        y?: {
+            min: number;
+            max: number;
+        };
+        z?: {
+            min: number;
+            max: number;
+        };
+    };
+    'measure:changed': {
+        type: string;
+        value: number;
+        unit: string;
+        points?: {
+            x: number;
+            y: number;
+            z: number;
+        }[];
+    };
+    'aiChat:opened': {};
+    'aiChat:closed': {};
+    'aiChat:message-sent': {
+        message: string;
+    };
+    'aiChat:question-answered': {
+        questionId: string;
+        optionId: string;
+        customAnswer?: string;
+    };
+    'aiChat:new-chat': {};
+    'aiChat:history-opened': {};
+    'aiChat:settings-opened': {};
+}

package/dist/engine/src/types/measure.d.ts

@@ -0,0 +1,57 @@
+export declare const MEASURE_TYPES: {
+    readonly distance: {
+        readonly key: "distance";
+        readonly callBackType: "distance";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><g transform=\"translate(0 4.197)\"><path fill=\"currentColor\" d=\"M29.692,3.03,27.55.919a.529.529,0,0,1-.014-.756A.549.549,0,0,1,28.3.15l.014.013,3.067,3.023a.529.529,0,0,1,0,.756L28.317,6.966a.549.549,0,0,1-.767.013.529.529,0,0,1-.014-.756l.014-.013L29.692,4.1H2.31L4.452,6.21a.528.528,0,0,1,.013.756.547.547,0,0,1-.766.013l-.014-.013L.616,3.942a.531.531,0,0,1,0-.756L3.685.163a.548.548,0,0,1,.767.014.528.528,0,0,1,0,.742L2.31,3.03ZM24.136,15.055H23.051V18H21.966v-2.94H20.882V18H19.8v-2.94H18.712V18H17.627v-2.94H16.543v5.078H15.458V15.055H14.373V18H13.288v-2.94H12.2V18H11.119v-2.94H10.034V18H8.949v-2.94H7.865V18H6.78v-2.94H5.7v5.078H4.61V15.055H1.9a.27.27,0,0,0-.272.268v6.413A.269.269,0,0,0,1.9,22H30.1a.268.268,0,0,0,.271-.267V15.323a.269.269,0,0,0-.271-.268H27.39v5.078H26.305V15.055H25.221V18H24.136Zm5.966-1.6A1.884,1.884,0,0,1,32,15.323v6.413a1.885,1.885,0,0,1-1.9,1.871H1.9A1.885,1.885,0,0,1,0,21.736V15.323a1.885,1.885,0,0,1,1.9-1.871Z\"/></g></svg>";
+        readonly order: 0;
+    };
+    readonly clearHeight: {
+        readonly key: "clearHeight";
+        readonly callBackType: "clear-height";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><text x=\"16\" y=\"20\" text-anchor=\"middle\" fill=\"currentColor\" font-size=\"12\" font-family=\"system-ui, sans-serif\">净高</text></svg>";
+        readonly order: 1;
+    };
+    readonly clearDistance: {
+        readonly key: "clearDistance";
+        readonly callBackType: "clear-distance";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><text x=\"16\" y=\"20\" text-anchor=\"middle\" fill=\"currentColor\" font-size=\"12\" font-family=\"system-ui, sans-serif\">净距</text></svg>";
+        readonly order: 2;
+    };
+    readonly elevation: {
+        readonly key: "elevation";
+        readonly callBackType: "elevation";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M84.131,193.119a1.056,1.056,0,0,1,1.116.982v7.857a1.056,1.056,0,0,1-1.116.982H54.367a1.056,1.056,0,0,1-1.116-.982V194.1a1.056,1.056,0,0,1,1.116-.982Zm-1.116,1.964H55.483v5.893H83.015Zm1.116-13.749a1.064,1.064,0,0,1,1.114.935,1.032,1.032,0,0,1-1.007,1.025l-.107,0H71.2l-7.858,6.914a1.227,1.227,0,0,1-1.578,0l-8.185-7.2-.018-.016-.032-.031.049.047a1.107,1.107,0,0,1-.092-.092l-.011-.014a.869.869,0,0,1-.182-.857l0-.008L53.31,182l.012-.029.02-.045.019-.035a1.1,1.1,0,0,1,.891-.552h.007q.053,0,.107,0ZM68.043,183.3H57.06l5.492,4.831Z\" transform=\"translate(-53.247 -176.136)\"/></svg>";
+        readonly order: 3;
+    };
+    readonly point: {
+        readonly key: "point";
+        readonly callBackType: "point";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><text x=\"16\" y=\"20\" text-anchor=\"middle\" fill=\"currentColor\" font-size=\"12\" font-family=\"system-ui, sans-serif\">坐标</text></svg>";
+        readonly order: 4;
+    };
+    readonly angle: {
+        readonly key: "angle";
+        readonly callBackType: "angle";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M39.587,50.766h13.7a1,1,0,0,1,0,2H23.171a1,1,0,0,1,0-2h1.418l6.582-7.006v-.006a.517.517,0,0,1,.14-.357.456.456,0,0,1,.337-.144l12.1-12.876a.451.451,0,0,1,.665,0,.524.524,0,0,1,0,.708L32.883,43.355a8.3,8.3,0,0,1,6.7,7.411Zm-.949,0a7.254,7.254,0,0,0-6.611-6.5l-6.108,6.5Z\" transform=\"translate(-22.229 -26.489)\"/></svg>";
+        readonly order: 5;
+    };
+    readonly area: {
+        readonly key: "area";
+        readonly callBackType: "area";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><text x=\"16\" y=\"20\" text-anchor=\"middle\" fill=\"currentColor\" font-size=\"12\" font-family=\"system-ui, sans-serif\">面积</text></svg>";
+        readonly order: 6;
+    };
+    readonly slope: {
+        readonly key: "slope";
+        readonly callBackType: "slope";
+        readonly icon: "<svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M202.1,188.337l2.629-2.191-8.447-3.106,1.533,8.871,2.629-2.194,9.341,11.209,1.656-1.379Zm-13.726-.435a1.075,1.075,0,0,0-1.07-.341,1.057,1.057,0,0,0-.5.277l-5.11,4.08a1.08,1.08,0,0,0-.406.84l-.007,17.386a1.079,1.079,0,0,0,1.077,1.077L205.7,211.2a1.078,1.078,0,0,0,.822-1.774Zm-4.934,21.164.007-15.788,3.968-3.171,15.974,18.941Z\" transform=\"translate(-180.36 -181.131)\"/></svg>";
+        readonly order: 7;
+    };
+};
+export type MeasureMode = keyof typeof MEASURE_TYPES;
+export type CallBackType = typeof MEASURE_TYPES[MeasureMode]['callBackType'];
+export type MeasureTypeConfig = typeof MEASURE_TYPES[MeasureMode];
+export type MeasureValueType = 'length' | 'area' | 'angle' | 'percent' | 'point';
+export declare const MEASURE_MODES_ORDERED: MeasureMode[];
+export declare function getValueType(key: MeasureMode): MeasureValueType;
+export declare function getModeBycallBackType(callBackType: CallBackType): MeasureMode | undefined;

package/dist/engine/src/utils/icon-manager.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 图标管理器
+ * 统一管理所有 SVG 图标
+ */
+/**
+ * 获取图标
+ * @param name 图标名称
+ * @returns SVG 字符串，如果找不到返回默认图标
+ */
+export declare function getIcon(name: string): string;