@vlian/framework 1.0.0

package/dist/core/startup/AppInstance.js

@@ -0,0 +1,218 @@
+/**
+ * 应用实例管理模块
+ * 支持多实例隔离
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { AppRenderer } from "./renderApp";
+import { PerformanceTracker } from "./performanceTracker";
+/**
+ * 应用实例
+ */ export class AppInstance {
+    /**
+   * 初始化应用实例
+   * 
+   * @param container - React应用的挂载容器
+   * @param services - 服务实例
+   */ initialize(container, services) {
+        if (this.initialized) {
+            throw new Error(`应用实例 ${this.id} 已经初始化`);
+        }
+        if (this.destroyed) {
+            throw new Error(`应用实例 ${this.id} 已销毁，无法重新初始化`);
+        }
+        this.services = services;
+        this.renderer.initialize(container, this.options.rootOptions);
+        this.performanceTracker = new PerformanceTracker(services.monitoring);
+        this.performanceTracker.collectWebVitals();
+        this.initialized = true;
+    }
+    /**
+   * 获取渲染器
+   */ getRenderer() {
+        if (!this.initialized) {
+            throw new Error(`应用实例 ${this.id} 未初始化`);
+        }
+        return this.renderer;
+    }
+    /**
+   * 获取服务实例
+   */ getServices() {
+        if (!this.services) {
+            throw new Error(`应用实例 ${this.id} 未初始化`);
+        }
+        return this.services;
+    }
+    /**
+   * 获取性能追踪器
+   */ getPerformanceTracker() {
+        return this.performanceTracker;
+    }
+    /**
+   * 获取启动配置
+   */ getOptions() {
+        return this.options;
+    }
+    /**
+   * 是否已初始化
+   */ isInitialized() {
+        return this.initialized;
+    }
+    /**
+   * 是否已销毁
+   */ isDestroyed() {
+        return this.destroyed;
+    }
+    /**
+   * 销毁应用实例
+   */ destroy() {
+        if (this.destroyed) {
+            return;
+        }
+        this.renderer.destroy();
+        this.services = null;
+        this.performanceTracker = null;
+        this.destroyed = true;
+    }
+    constructor(id, options){
+        /**
+   * 实例ID
+   */ _define_property(this, "id", void 0);
+        /**
+   * 应用渲染器
+   */ _define_property(this, "renderer", void 0);
+        /**
+   * 服务实例
+   */ _define_property(this, "services", null);
+        /**
+   * 性能追踪器
+   */ _define_property(this, "performanceTracker", null);
+        /**
+   * 启动配置
+   */ _define_property(this, "options", void 0);
+        /**
+   * 是否已初始化
+   */ _define_property(this, "initialized", false);
+        /**
+   * 是否已销毁
+   */ _define_property(this, "destroyed", false);
+        this.id = id;
+        this.options = options;
+        this.renderer = new AppRenderer();
+    }
+}
+/**
+ * 应用实例管理器
+ */ export class AppInstanceManager {
+    /**
+   * 获取单例实例
+   */ static getInstance() {
+        if (!AppInstanceManager.instance) {
+            AppInstanceManager.instance = new AppInstanceManager();
+        }
+        return AppInstanceManager.instance;
+    }
+    /**
+   * 创建应用实例
+   * 
+   * @param id - 实例ID，如果不提供则自动生成
+   * @param options - 启动配置选项
+   * @returns 应用实例
+   */ createInstance(id, options = {}) {
+        const instanceId = id || `app-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        if (this.instances.has(instanceId)) {
+            throw new Error(`应用实例 ${instanceId} 已存在`);
+        }
+        const instance = new AppInstance(instanceId, options);
+        this.instances.set(instanceId, instance);
+        // 如果没有默认实例，设置为默认实例
+        if (!this.defaultInstanceId) {
+            this.defaultInstanceId = instanceId;
+        }
+        return instance;
+    }
+    /**
+   * 获取应用实例
+   * 
+   * @param id - 实例ID，如果不提供则返回默认实例
+   * @returns 应用实例或undefined
+   */ getInstance(id) {
+        const instanceId = id || this.defaultInstanceId;
+        if (!instanceId) {
+            return undefined;
+        }
+        return this.instances.get(instanceId);
+    }
+    /**
+   * 销毁应用实例
+   * 
+   * @param id - 实例ID，如果不提供则销毁默认实例
+   */ destroyInstance(id) {
+        const instanceId = id || this.defaultInstanceId;
+        if (!instanceId) {
+            return;
+        }
+        const instance = this.instances.get(instanceId);
+        if (instance) {
+            instance.destroy();
+            this.instances.delete(instanceId);
+            // 如果销毁的是默认实例，重新设置默认实例
+            if (this.defaultInstanceId === instanceId) {
+                const remainingInstances = Array.from(this.instances.keys());
+                this.defaultInstanceId = remainingInstances.length > 0 ? remainingInstances[0] : null;
+            }
+        }
+    }
+    /**
+   * 获取所有实例
+   */ getAllInstances() {
+        return Array.from(this.instances.values());
+    }
+    /**
+   * 设置默认实例
+   * 
+   * @param id - 实例ID
+   */ setDefaultInstance(id) {
+        if (!this.instances.has(id)) {
+            throw new Error(`应用实例 ${id} 不存在`);
+        }
+        this.defaultInstanceId = id;
+    }
+    /**
+   * 获取默认实例ID
+   */ getDefaultInstanceId() {
+        return this.defaultInstanceId;
+    }
+    /**
+   * 清空所有实例
+   */ clear() {
+        for (const instance of this.instances.values()){
+            instance.destroy();
+        }
+        this.instances.clear();
+        this.defaultInstanceId = null;
+    }
+    constructor(){
+        _define_property(this, "instances", new Map());
+        _define_property(this, "defaultInstanceId", null);
+    // 私有构造函数
+    }
+}
+_define_property(AppInstanceManager, "instance", null);
+/**
+ * 获取应用实例管理器
+ */ export function getAppInstanceManager() {
+    return AppInstanceManager.getInstance();
+}
+
+//# sourceMappingURL=AppInstance.js.map

package/dist/core/startup/AppInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/startup/AppInstance.ts"],"sourcesContent":["/**\n * 应用实例管理模块\n * 支持多实例隔离\n */\n\nimport type { Container } from 'react-dom/client';\nimport type { StartOptions } from '../types';\nimport { AppRenderer } from './renderApp';\nimport type { ServicesInitResult } from './initializeServices';\nimport { PerformanceTracker } from './performanceTracker';\n\n/**\n * 应用实例\n */\nexport class AppInstance {\n  /**\n   * 实例ID\n   */\n  readonly id: string;\n\n  /**\n   * 应用渲染器\n   */\n  private renderer: AppRenderer;\n\n  /**\n   * 服务实例\n   */\n  private services: ServicesInitResult | null = null;\n\n  /**\n   * 性能追踪器\n   */\n  private performanceTracker: PerformanceTracker | null = null;\n\n  /**\n   * 启动配置\n   */\n  private options: StartOptions;\n\n  /**\n   * 是否已初始化\n   */\n  private initialized = false;\n\n  /**\n   * 是否已销毁\n   */\n  private destroyed = false;\n\n  constructor(id: string, options: StartOptions) {\n    this.id = id;\n    this.options = options;\n    this.renderer = new AppRenderer();\n  }\n\n  /**\n   * 初始化应用实例\n   * \n   * @param container - React应用的挂载容器\n   * @param services - 服务实例\n   */\n  initialize(container: Container, services: ServicesInitResult): void {\n    if (this.initialized) {\n      throw new Error(`应用实例 ${this.id} 已经初始化`);\n    }\n\n    if (this.destroyed) {\n      throw new Error(`应用实例 ${this.id} 已销毁，无法重新初始化`);\n    }\n\n    this.services = services;\n    this.renderer.initialize(container, this.options.rootOptions);\n    this.performanceTracker = new PerformanceTracker(services.monitoring);\n    this.performanceTracker.collectWebVitals();\n    this.initialized = true;\n  }\n\n  /**\n   * 获取渲染器\n   */\n  getRenderer(): AppRenderer {\n    if (!this.initialized) {\n      throw new Error(`应用实例 ${this.id} 未初始化`);\n    }\n    return this.renderer;\n  }\n\n  /**\n   * 获取服务实例\n   */\n  getServices(): ServicesInitResult {\n    if (!this.services) {\n      throw new Error(`应用实例 ${this.id} 未初始化`);\n    }\n    return this.services;\n  }\n\n  /**\n   * 获取性能追踪器\n   */\n  getPerformanceTracker(): PerformanceTracker | null {\n    return this.performanceTracker;\n  }\n\n  /**\n   * 获取启动配置\n   */\n  getOptions(): StartOptions {\n    return this.options;\n  }\n\n  /**\n   * 是否已初始化\n   */\n  isInitialized(): boolean {\n    return this.initialized;\n  }\n\n  /**\n   * 是否已销毁\n   */\n  isDestroyed(): boolean {\n    return this.destroyed;\n  }\n\n  /**\n   * 销毁应用实例\n   */\n  destroy(): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.renderer.destroy();\n    this.services = null;\n    this.performanceTracker = null;\n    this.destroyed = true;\n  }\n}\n\n/**\n * 应用实例管理器\n */\nexport class AppInstanceManager {\n  private static instance: AppInstanceManager | null = null;\n  private instances: Map<string, AppInstance> = new Map();\n  private defaultInstanceId: string | null = null;\n\n  private constructor() {\n    // 私有构造函数\n  }\n\n  /**\n   * 获取单例实例\n   */\n  static getInstance(): AppInstanceManager {\n    if (!AppInstanceManager.instance) {\n      AppInstanceManager.instance = new AppInstanceManager();\n    }\n    return AppInstanceManager.instance;\n  }\n\n  /**\n   * 创建应用实例\n   * \n   * @param id - 实例ID，如果不提供则自动生成\n   * @param options - 启动配置选项\n   * @returns 应用实例\n   */\n  createInstance(id?: string, options: StartOptions = {}): AppInstance {\n    const instanceId = id || `app-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n    \n    if (this.instances.has(instanceId)) {\n      throw new Error(`应用实例 ${instanceId} 已存在`);\n    }\n\n    const instance = new AppInstance(instanceId, options);\n    this.instances.set(instanceId, instance);\n\n    // 如果没有默认实例，设置为默认实例\n    if (!this.defaultInstanceId) {\n      this.defaultInstanceId = instanceId;\n    }\n\n    return instance;\n  }\n\n  /**\n   * 获取应用实例\n   * \n   * @param id - 实例ID，如果不提供则返回默认实例\n   * @returns 应用实例或undefined\n   */\n  getInstance(id?: string): AppInstance | undefined {\n    const instanceId = id || this.defaultInstanceId;\n    if (!instanceId) {\n      return undefined;\n    }\n    return this.instances.get(instanceId);\n  }\n\n  /**\n   * 销毁应用实例\n   * \n   * @param id - 实例ID，如果不提供则销毁默认实例\n   */\n  destroyInstance(id?: string): void {\n    const instanceId = id || this.defaultInstanceId;\n    if (!instanceId) {\n      return;\n    }\n\n    const instance = this.instances.get(instanceId);\n    if (instance) {\n      instance.destroy();\n      this.instances.delete(instanceId);\n\n      // 如果销毁的是默认实例，重新设置默认实例\n      if (this.defaultInstanceId === instanceId) {\n        const remainingInstances = Array.from(this.instances.keys());\n        this.defaultInstanceId = remainingInstances.length > 0 ? remainingInstances[0] : null;\n      }\n    }\n  }\n\n  /**\n   * 获取所有实例\n   */\n  getAllInstances(): AppInstance[] {\n    return Array.from(this.instances.values());\n  }\n\n  /**\n   * 设置默认实例\n   * \n   * @param id - 实例ID\n   */\n  setDefaultInstance(id: string): void {\n    if (!this.instances.has(id)) {\n      throw new Error(`应用实例 ${id} 不存在`);\n    }\n    this.defaultInstanceId = id;\n  }\n\n  /**\n   * 获取默认实例ID\n   */\n  getDefaultInstanceId(): string | null {\n    return this.defaultInstanceId;\n  }\n\n  /**\n   * 清空所有实例\n   */\n  clear(): void {\n    for (const instance of this.instances.values()) {\n      instance.destroy();\n    }\n    this.instances.clear();\n    this.defaultInstanceId = null;\n  }\n}\n\n/**\n * 获取应用实例管理器\n */\nexport function getAppInstanceManager(): AppInstanceManager {\n  return AppInstanceManager.getInstance();\n}\n"],"names":["AppRenderer","PerformanceTracker","AppInstance","initialize","container","services","initialized","Error","id","destroyed","renderer","options","rootOptions","performanceTracker","monitoring","collectWebVitals","getRenderer","getServices","getPerformanceTracker","getOptions","isInitialized","isDestroyed","destroy","AppInstanceManager","getInstance","instance","createInstance","instanceId","Date","now","Math","random","toString","substr","instances","has","set","defaultInstanceId","undefined","get","destroyInstance","delete","remainingInstances","Array","from","keys","length","getAllInstances","values","setDefaultInstance","getDefaultInstanceId","clear","Map","getAppInstanceManager"],"mappings":"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"}

package/dist/core/startup/environment.cjs

@@ -0,0 +1,171 @@
+/**
+ * 环境检测模块
+ * 负责检测运行环境和提供适配能力
+ */ /**
+ * 运行环境类型
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get EnvironmentDetector () {
+        return EnvironmentDetector;
+    },
+    get RuntimeEnvironment () {
+        return RuntimeEnvironment;
+    },
+    get getEnvironmentDetector () {
+        return getEnvironmentDetector;
+    }
+});
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+var RuntimeEnvironment = /*#__PURE__*/ function(RuntimeEnvironment) {
+    /**
+   * 浏览器环境
+   */ RuntimeEnvironment["BROWSER"] = "browser";
+    /**
+   * 服务端渲染环境（SSR）
+   */ RuntimeEnvironment["SSR"] = "ssr";
+    /**
+   * 微前端容器环境
+   */ RuntimeEnvironment["MICRO_FRONTEND"] = "micro-frontend";
+    /**
+   * Node.js环境
+   */ RuntimeEnvironment["NODE"] = "node";
+    /**
+   * 未知环境
+   */ RuntimeEnvironment["UNKNOWN"] = "unknown";
+    return RuntimeEnvironment;
+}({});
+let EnvironmentDetector = class EnvironmentDetector {
+    /**
+   * 获取单例实例
+   */ static getInstance() {
+        if (!EnvironmentDetector.instance) {
+            EnvironmentDetector.instance = new EnvironmentDetector();
+        }
+        return EnvironmentDetector.instance;
+    }
+    /**
+   * 检测微前端环境
+   */ detectMicroFrontend() {
+        if (typeof window === 'undefined') {
+            return false;
+        }
+        // 检测是否在微前端容器中
+        // 常见的微前端框架标识
+        return !!(window.__POWERED_BY_QIANKUN__ || window.__MICRO_APP_ENVIRONMENT__ || window.singleSpa || window.__SINGLE_SPA__);
+    }
+    /**
+   * 检测运行环境
+   */ detectEnvironment() {
+        if (this.isMicroFrontend) {
+            return "micro-frontend";
+        }
+        if (this.isSSR) {
+            return "ssr";
+        }
+        if (this.isBrowser) {
+            return "browser";
+        }
+        if (typeof process !== 'undefined') {
+            return "node";
+        }
+        return "unknown";
+    }
+    /**
+   * 获取当前运行环境
+   */ getEnvironment() {
+        return this.environment;
+    }
+    /**
+   * 是否为浏览器环境
+   */ isBrowserEnvironment() {
+        return this.isBrowser;
+    }
+    /**
+   * 是否为SSR环境
+   */ isSSREnvironment() {
+        return this.isSSR;
+    }
+    /**
+   * 是否为微前端环境
+   */ isMicroFrontendEnvironment() {
+        return this.isMicroFrontend;
+    }
+    /**
+   * 安全获取DOM元素（支持SSR）
+   * 
+   * @param selector - 选择器或元素ID
+   * @returns DOM元素或null
+   */ safeGetElement(selector) {
+        if (!this.isBrowser) {
+            return null;
+        }
+        if (typeof selector === 'function') {
+            try {
+                return selector();
+            } catch  {
+                return null;
+            }
+        }
+        try {
+            if (selector.startsWith('#')) {
+                return document.getElementById(selector.slice(1));
+            }
+            return document.querySelector(selector);
+        } catch  {
+            return null;
+        }
+    }
+    /**
+   * 安全执行浏览器API（支持SSR）
+   * 
+   * @param fn - 要执行的函数
+   * @param fallback - 非浏览器环境的回退值
+   * @returns 执行结果或回退值
+   */ safeExecuteBrowserAPI(fn, fallback) {
+        if (!this.isBrowser) {
+            return fallback;
+        }
+        try {
+            return fn();
+        } catch  {
+            return fallback;
+        }
+    }
+    constructor(){
+        _define_property(this, "environment", void 0);
+        _define_property(this, "isBrowser", void 0);
+        _define_property(this, "isSSR", void 0);
+        _define_property(this, "isMicroFrontend", void 0);
+        this.isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+        this.isSSR = typeof window === 'undefined' && typeof process !== 'undefined';
+        this.isMicroFrontend = this.detectMicroFrontend();
+        this.environment = this.detectEnvironment();
+    }
+};
+_define_property(EnvironmentDetector, "instance", null);
+function getEnvironmentDetector() {
+    return EnvironmentDetector.getInstance();
+}
+
+//# sourceMappingURL=environment.js.map

package/dist/core/startup/environment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/startup/environment.ts"],"sourcesContent":["/**\n * 环境检测模块\n * 负责检测运行环境和提供适配能力\n */\n\n/**\n * 运行环境类型\n */\nexport enum RuntimeEnvironment {\n  /**\n   * 浏览器环境\n   */\n  BROWSER = 'browser',\n\n  /**\n   * 服务端渲染环境（SSR）\n   */\n  SSR = 'ssr',\n\n  /**\n   * 微前端容器环境\n   */\n  MICRO_FRONTEND = 'micro-frontend',\n\n  /**\n   * Node.js环境\n   */\n  NODE = 'node',\n\n  /**\n   * 未知环境\n   */\n  UNKNOWN = 'unknown',\n}\n\n/**\n * 环境检测器\n */\nexport class EnvironmentDetector {\n  private static instance: EnvironmentDetector | null = null;\n  private environment: RuntimeEnvironment;\n  private isBrowser: boolean;\n  private isSSR: boolean;\n  private isMicroFrontend: boolean;\n\n  private constructor() {\n    this.isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';\n    this.isSSR = typeof window === 'undefined' && typeof process !== 'undefined';\n    this.isMicroFrontend = this.detectMicroFrontend();\n    this.environment = this.detectEnvironment();\n  }\n\n  /**\n   * 获取单例实例\n   */\n  static getInstance(): EnvironmentDetector {\n    if (!EnvironmentDetector.instance) {\n      EnvironmentDetector.instance = new EnvironmentDetector();\n    }\n    return EnvironmentDetector.instance;\n  }\n\n  /**\n   * 检测微前端环境\n   */\n  private detectMicroFrontend(): boolean {\n    if (typeof window === 'undefined') {\n      return false;\n    }\n\n    // 检测是否在微前端容器中\n    // 常见的微前端框架标识\n    return !!(\n      (window as any).__POWERED_BY_QIANKUN__ ||\n      (window as any).__MICRO_APP_ENVIRONMENT__ ||\n      (window as any).singleSpa ||\n      (window as any).__SINGLE_SPA__\n    );\n  }\n\n  /**\n   * 检测运行环境\n   */\n  private detectEnvironment(): RuntimeEnvironment {\n    if (this.isMicroFrontend) {\n      return RuntimeEnvironment.MICRO_FRONTEND;\n    }\n\n    if (this.isSSR) {\n      return RuntimeEnvironment.SSR;\n    }\n\n    if (this.isBrowser) {\n      return RuntimeEnvironment.BROWSER;\n    }\n\n    if (typeof process !== 'undefined') {\n      return RuntimeEnvironment.NODE;\n    }\n\n    return RuntimeEnvironment.UNKNOWN;\n  }\n\n  /**\n   * 获取当前运行环境\n   */\n  getEnvironment(): RuntimeEnvironment {\n    return this.environment;\n  }\n\n  /**\n   * 是否为浏览器环境\n   */\n  isBrowserEnvironment(): boolean {\n    return this.isBrowser;\n  }\n\n  /**\n   * 是否为SSR环境\n   */\n  isSSREnvironment(): boolean {\n    return this.isSSR;\n  }\n\n  /**\n   * 是否为微前端环境\n   */\n  isMicroFrontendEnvironment(): boolean {\n    return this.isMicroFrontend;\n  }\n\n  /**\n   * 安全获取DOM元素（支持SSR）\n   * \n   * @param selector - 选择器或元素ID\n   * @returns DOM元素或null\n   */\n  safeGetElement(selector: string | (() => HTMLElement | null)): HTMLElement | null {\n    if (!this.isBrowser) {\n      return null;\n    }\n\n    if (typeof selector === 'function') {\n      try {\n        return selector();\n      } catch {\n        return null;\n      }\n    }\n\n    try {\n      if (selector.startsWith('#')) {\n        return document.getElementById(selector.slice(1));\n      }\n      return document.querySelector(selector);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * 安全执行浏览器API（支持SSR）\n   * \n   * @param fn - 要执行的函数\n   * @param fallback - 非浏览器环境的回退值\n   * @returns 执行结果或回退值\n   */\n  safeExecuteBrowserAPI<T>(\n    fn: () => T,\n    fallback?: T\n  ): T | undefined {\n    if (!this.isBrowser) {\n      return fallback;\n    }\n\n    try {\n      return fn();\n    } catch {\n      return fallback;\n    }\n  }\n}\n\n/**\n * 获取环境检测器实例\n */\nexport function getEnvironmentDetector(): EnvironmentDetector {\n  return EnvironmentDetector.getInstance();\n}\n"],"names":["EnvironmentDetector","RuntimeEnvironment","getEnvironmentDetector","getInstance","instance","detectMicroFrontend","window","__POWERED_BY_QIANKUN__","__MICRO_APP_ENVIRONMENT__","singleSpa","__SINGLE_SPA__","detectEnvironment","isMicroFrontend","isSSR","isBrowser","process","getEnvironment","environment","isBrowserEnvironment","isSSREnvironment","isMicroFrontendEnvironment","safeGetElement","selector","startsWith","document","getElementById","slice","querySelector","safeExecuteBrowserAPI","fn","fallback"],"mappings":"AAAA;;;CAGC,GAED;;CAEC;;;;;;;;;;;QA+BYA;eAAAA;;QA9BDC;eAAAA;;QAkLIC;eAAAA;;;;;;;;;;;;;;;;AAlLT,IAAA,AAAKD,4CAAAA;IACV;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;WAvBSA;;AA8BL,IAAA,AAAMD,sBAAN,MAAMA;IAcX;;GAEC,GACD,OAAOG,cAAmC;QACxC,IAAI,CAACH,oBAAoBI,QAAQ,EAAE;YACjCJ,oBAAoBI,QAAQ,GAAG,IAAIJ;QACrC;QACA,OAAOA,oBAAoBI,QAAQ;IACrC;IAEA;;GAEC,GACD,AAAQC,sBAA+B;QACrC,IAAI,OAAOC,WAAW,aAAa;YACjC,OAAO;QACT;QAEA,cAAc;QACd,aAAa;QACb,OAAO,CAAC,CACN,CAAA,AAACA,OAAeC,sBAAsB,IACtC,AAACD,OAAeE,yBAAyB,IACzC,AAACF,OAAeG,SAAS,IACzB,AAACH,OAAeI,cAAc,AAAD;IAEjC;IAEA;;GAEC,GACD,AAAQC,oBAAwC;QAC9C,IAAI,IAAI,CAACC,eAAe,EAAE;YACxB;QACF;QAEA,IAAI,IAAI,CAACC,KAAK,EAAE;YACd;QACF;QAEA,IAAI,IAAI,CAACC,SAAS,EAAE;YAClB;QACF;QAEA,IAAI,OAAOC,YAAY,aAAa;YAClC;QACF;QAEA;IACF;IAEA;;GAEC,GACDC,iBAAqC;QACnC,OAAO,IAAI,CAACC,WAAW;IACzB;IAEA;;GAEC,GACDC,uBAAgC;QAC9B,OAAO,IAAI,CAACJ,SAAS;IACvB;IAEA;;GAEC,GACDK,mBAA4B;QAC1B,OAAO,IAAI,CAACN,KAAK;IACnB;IAEA;;GAEC,GACDO,6BAAsC;QACpC,OAAO,IAAI,CAACR,eAAe;IAC7B;IAEA;;;;;GAKC,GACDS,eAAeC,QAA6C,EAAsB;QAChF,IAAI,CAAC,IAAI,CAACR,SAAS,EAAE;YACnB,OAAO;QACT;QAEA,IAAI,OAAOQ,aAAa,YAAY;YAClC,IAAI;gBACF,OAAOA;YACT,EAAE,OAAM;gBACN,OAAO;YACT;QACF;QAEA,IAAI;YACF,IAAIA,SAASC,UAAU,CAAC,MAAM;gBAC5B,OAAOC,SAASC,cAAc,CAACH,SAASI,KAAK,CAAC;YAChD;YACA,OAAOF,SAASG,aAAa,CAACL;QAChC,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA;;;;;;GAMC,GACDM,sBACEC,EAAW,EACXC,QAAY,EACG;QACf,IAAI,CAAC,IAAI,CAAChB,SAAS,EAAE;YACnB,OAAOgB;QACT;QAEA,IAAI;YACF,OAAOD;QACT,EAAE,OAAM;YACN,OAAOC;QACT;IACF;IAvIA,aAAsB;QALtB,uBAAQb,eAAR,KAAA;QACA,uBAAQH,aAAR,KAAA;QACA,uBAAQD,SAAR,KAAA;QACA,uBAAQD,mBAAR,KAAA;QAGE,IAAI,CAACE,SAAS,GAAG,OAAOR,WAAW,eAAe,OAAOkB,aAAa;QACtE,IAAI,CAACX,KAAK,GAAG,OAAOP,WAAW,eAAe,OAAOS,YAAY;QACjE,IAAI,CAACH,eAAe,GAAG,IAAI,CAACP,mBAAmB;QAC/C,IAAI,CAACY,WAAW,GAAG,IAAI,CAACN,iBAAiB;IAC3C;AAmIF;AA9IE,iBADWX,qBACII,YAAuC;AAmJjD,SAASF;IACd,OAAOF,oBAAoBG,WAAW;AACxC"}

package/dist/core/startup/environment.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 环境检测模块
+ * 负责检测运行环境和提供适配能力
+ */
+/**
+ * 运行环境类型
+ */
+export declare enum RuntimeEnvironment {
+    /**
+     * 浏览器环境
+     */
+    BROWSER = "browser",
+    /**
+     * 服务端渲染环境（SSR）
+     */
+    SSR = "ssr",
+    /**
+     * 微前端容器环境
+     */
+    MICRO_FRONTEND = "micro-frontend",
+    /**
+     * Node.js环境
+     */
+    NODE = "node",
+    /**
+     * 未知环境
+     */
+    UNKNOWN = "unknown"
+}
+/**
+ * 环境检测器
+ */
+export declare class EnvironmentDetector {
+    private static instance;
+    private environment;
+    private isBrowser;
+    private isSSR;
+    private isMicroFrontend;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): EnvironmentDetector;
+    /**
+     * 检测微前端环境
+     */
+    private detectMicroFrontend;
+    /**
+     * 检测运行环境
+     */
+    private detectEnvironment;
+    /**
+     * 获取当前运行环境
+     */
+    getEnvironment(): RuntimeEnvironment;
+    /**
+     * 是否为浏览器环境
+     */
+    isBrowserEnvironment(): boolean;
+    /**
+     * 是否为SSR环境
+     */
+    isSSREnvironment(): boolean;
+    /**
+     * 是否为微前端环境
+     */
+    isMicroFrontendEnvironment(): boolean;
+    /**
+     * 安全获取DOM元素（支持SSR）
+     *
+     * @param selector - 选择器或元素ID
+     * @returns DOM元素或null
+     */
+    safeGetElement(selector: string | (() => HTMLElement | null)): HTMLElement | null;
+    /**
+     * 安全执行浏览器API（支持SSR）
+     *
+     * @param fn - 要执行的函数
+     * @param fallback - 非浏览器环境的回退值
+     * @returns 执行结果或回退值
+     */
+    safeExecuteBrowserAPI<T>(fn: () => T, fallback?: T): T | undefined;
+}
+/**
+ * 获取环境检测器实例
+ */
+export declare function getEnvironmentDetector(): EnvironmentDetector;
+//# sourceMappingURL=environment.d.ts.map

package/dist/core/startup/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/core/startup/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,kBAAkB;IAC5B;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,GAAG,QAAQ;IAEX;;OAEG;IACH,cAAc,mBAAmB;IAEjC;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAC3D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,eAAe,CAAU;IAEjC,OAAO;IAOP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,cAAc,IAAI,kBAAkB;IAIpC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,0BAA0B,IAAI,OAAO;IAIrC;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI;IAuBjF;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,EACrB,EAAE,EAAE,MAAM,CAAC,EACX,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,GAAG,SAAS;CAWjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D"}

package/dist/core/startup/environment.js

@@ -0,0 +1,154 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 环境检测模块
+ * 负责检测运行环境和提供适配能力
+ */ /**
+ * 运行环境类型
+ */ export var RuntimeEnvironment = /*#__PURE__*/ function(RuntimeEnvironment) {
+    /**
+   * 浏览器环境
+   */ RuntimeEnvironment["BROWSER"] = "browser";
+    /**
+   * 服务端渲染环境（SSR）
+   */ RuntimeEnvironment["SSR"] = "ssr";
+    /**
+   * 微前端容器环境
+   */ RuntimeEnvironment["MICRO_FRONTEND"] = "micro-frontend";
+    /**
+   * Node.js环境
+   */ RuntimeEnvironment["NODE"] = "node";
+    /**
+   * 未知环境
+   */ RuntimeEnvironment["UNKNOWN"] = "unknown";
+    return RuntimeEnvironment;
+}({});
+/**
+ * 环境检测器
+ */ export class EnvironmentDetector {
+    /**
+   * 获取单例实例
+   */ static getInstance() {
+        if (!EnvironmentDetector.instance) {
+            EnvironmentDetector.instance = new EnvironmentDetector();
+        }
+        return EnvironmentDetector.instance;
+    }
+    /**
+   * 检测微前端环境
+   */ detectMicroFrontend() {
+        if (typeof window === 'undefined') {
+            return false;
+        }
+        // 检测是否在微前端容器中
+        // 常见的微前端框架标识
+        return !!(window.__POWERED_BY_QIANKUN__ || window.__MICRO_APP_ENVIRONMENT__ || window.singleSpa || window.__SINGLE_SPA__);
+    }
+    /**
+   * 检测运行环境
+   */ detectEnvironment() {
+        if (this.isMicroFrontend) {
+            return "micro-frontend";
+        }
+        if (this.isSSR) {
+            return "ssr";
+        }
+        if (this.isBrowser) {
+            return "browser";
+        }
+        if (typeof process !== 'undefined') {
+            return "node";
+        }
+        return "unknown";
+    }
+    /**
+   * 获取当前运行环境
+   */ getEnvironment() {
+        return this.environment;
+    }
+    /**
+   * 是否为浏览器环境
+   */ isBrowserEnvironment() {
+        return this.isBrowser;
+    }
+    /**
+   * 是否为SSR环境
+   */ isSSREnvironment() {
+        return this.isSSR;
+    }
+    /**
+   * 是否为微前端环境
+   */ isMicroFrontendEnvironment() {
+        return this.isMicroFrontend;
+    }
+    /**
+   * 安全获取DOM元素（支持SSR）
+   * 
+   * @param selector - 选择器或元素ID
+   * @returns DOM元素或null
+   */ safeGetElement(selector) {
+        if (!this.isBrowser) {
+            return null;
+        }
+        if (typeof selector === 'function') {
+            try {
+                return selector();
+            } catch  {
+                return null;
+            }
+        }
+        try {
+            if (selector.startsWith('#')) {
+                return document.getElementById(selector.slice(1));
+            }
+            return document.querySelector(selector);
+        } catch  {
+            return null;
+        }
+    }
+    /**
+   * 安全执行浏览器API（支持SSR）
+   * 
+   * @param fn - 要执行的函数
+   * @param fallback - 非浏览器环境的回退值
+   * @returns 执行结果或回退值
+   */ safeExecuteBrowserAPI(fn, fallback) {
+        if (!this.isBrowser) {
+            return fallback;
+        }
+        try {
+            return fn();
+        } catch  {
+            return fallback;
+        }
+    }
+    constructor(){
+        _define_property(this, "environment", void 0);
+        _define_property(this, "isBrowser", void 0);
+        _define_property(this, "isSSR", void 0);
+        _define_property(this, "isMicroFrontend", void 0);
+        this.isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+        this.isSSR = typeof window === 'undefined' && typeof process !== 'undefined';
+        this.isMicroFrontend = this.detectMicroFrontend();
+        this.environment = this.detectEnvironment();
+    }
+}
+_define_property(EnvironmentDetector, "instance", null);
+/**
+ * 获取环境检测器实例
+ */ export function getEnvironmentDetector() {
+    return EnvironmentDetector.getInstance();
+}
+
+//# sourceMappingURL=environment.js.map