@vlian/framework 1.0.0

package/dist/core/index.js

@@ -0,0 +1,66 @@
+import { storage } from "../library";
+import { startApp } from "./startup/startApp";
+import { getAppInstanceManager } from "./startup/AppInstance";
+/**
+ * 启动框架
+ * 
+ * @param options - 启动配置选项
+ * @returns Promise<void>
+ * 
+ * @example
+ * ```typescript
+ * import { start } from '@vlian/framework';
+ * 
+ * start({
+ *   loggerLevel: LogLevel.DEBUG,
+ *   lifecycle: {
+ *     beforeInitialization: async () => {
+ *       console.log('初始化前执行');
+ *     },
+ *   },
+ * });
+ * ```
+ */ /**
+ * 启动框架（向后兼容的API）
+ * 
+ * @param options - 启动配置选项
+ * @returns Promise<void>
+ * 
+ * @deprecated 建议使用 startApp 函数，支持多实例
+ */ const start = async (options = {})=>{
+    // 使用新的启动函数，保持向后兼容
+    await startApp(options);
+};
+// 导出新的启动函数
+export { startApp } from "./startup/startApp";
+export { getAppInstanceManager } from "./startup/AppInstance";
+// 导出向后兼容的start函数
+export { start, storage };
+// 导出getStateManager（向后兼容）
+export const getStateManager = ()=>{
+    const instanceManager = getAppInstanceManager();
+    const instance = instanceManager.getInstance();
+    if (instance) {
+        return instance.getServices().stateManager;
+    }
+    return null;
+};
+// 导出应用上下文相关功能
+export { AppContextProvider, useAppContext, useTheme, useLocale, useConfig, useStateManager } from "./app";
+// 导出错误边界
+export { ErrorBoundary, withErrorBoundary, useErrorHandler } from "./error";
+// 导出应用配置单例
+export { appConfig } from "./config/AppConfig";
+// 导出中间件
+export { MiddlewareManager, middlewareManager } from "./middleware";
+// 导出插件
+export { PluginManager, pluginManager } from "./plugin";
+// 导出启动相关模块
+export * from "./startup";
+export * from "./config";
+// 导出路由相关模块
+export * from "./router";
+// 导出开发工具
+export { DevTools, DevToolsTrigger } from "./dev/DevTools";
+
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/index.tsx"],"sourcesContent":["import type { StartOptions } from \"./types\";\nimport { storage } from '../library';\nimport { StateManager } from '../state';\nimport { startApp } from './startup/startApp';\nimport { getAppInstanceManager } from './startup/AppInstance';\n\n\n/**\n * 启动框架\n * \n * @param options - 启动配置选项\n * @returns Promise<void>\n * \n * @example\n * ```typescript\n * import { start } from '@vlian/framework';\n * \n * start({\n *   loggerLevel: LogLevel.DEBUG,\n *   lifecycle: {\n *     beforeInitialization: async () => {\n *       console.log('初始化前执行');\n *     },\n *   },\n * });\n * ```\n */\n/**\n * 启动框架（向后兼容的API）\n * \n * @param options - 启动配置选项\n * @returns Promise<void>\n * \n * @deprecated 建议使用 startApp 函数，支持多实例\n */\nconst start = async (options: StartOptions = {}): Promise<void> => {\n    // 使用新的启动函数，保持向后兼容\n    await startApp(options);\n};\n\n// 导出新的启动函数\nexport { startApp } from './startup/startApp';\nexport { getAppInstanceManager } from './startup/AppInstance';\nexport type { AppInstance } from './startup/AppInstance';\n\n// 导出向后兼容的start函数\nexport {\n    start,\n    storage,\n};\n\n// 导出getStateManager（向后兼容）\nexport const getStateManager = (): StateManager | null => {\n    const instanceManager = getAppInstanceManager();\n    const instance = instanceManager.getInstance();\n    if (instance) {\n        return instance.getServices().stateManager;\n    }\n    return null;\n};\n\n// 导出应用上下文相关功能\nexport {\n    AppContextProvider,\n    useAppContext,\n    useTheme,\n    useLocale,\n    useConfig,\n    useStateManager,\n} from './app';\n\n// 导出错误边界\nexport { ErrorBoundary, withErrorBoundary, useErrorHandler } from './error';\nexport type { ErrorBoundaryProps } from './error';\n\n// 导出应用配置单例\nexport { appConfig } from './config/AppConfig';\n\n// 导出初始化相关类型\nexport type {\n    InitializationContext,\n    ConfigStrategy,\n    InitializationOptions,\n    ProgressCallback,\n} from './initialization';\n\n// 导出中间件\nexport { MiddlewareManager, middlewareManager } from './middleware';\nexport type { Middleware } from './middleware';\n\n// 导出插件\nexport { PluginManager, pluginManager } from './plugin';\nexport type { Plugin } from './plugin';\n\n// 导出应用上下文相关类型\nexport type {\n    AppContextValue,\n    ThemeContextValue,\n    LocaleContextValue,\n    ConfigContextValue,\n    StateManagerContextValue,\n    ThemeConfig,\n    AppConfig,\n    AppContextProviderProps,\n} from './app';\n\n// 导出启动配置相关类型\nexport type { StartOptions, ManagerLifecycle, SplashScreenCustomProps } from './types';\n\n// 导出启动相关模块\nexport * from './startup';\nexport * from './config';\n\n// 导出路由相关模块\nexport * from './router';\n\n// 导出开发工具\nexport { DevTools, DevToolsTrigger } from './dev/DevTools';"],"names":["storage","startApp","getAppInstanceManager","start","options","getStateManager","instanceManager","instance","getInstance","getServices","stateManager","AppContextProvider","useAppContext","useTheme","useLocale","useConfig","useStateManager","ErrorBoundary","withErrorBoundary","useErrorHandler","appConfig","MiddlewareManager","middlewareManager","PluginManager","pluginManager","DevTools","DevToolsTrigger"],"mappings":"AACA,SAASA,OAAO,QAAQ,aAAa;AAErC,SAASC,QAAQ,QAAQ,qBAAqB;AAC9C,SAASC,qBAAqB,QAAQ,wBAAwB;AAG9D;;;;;;;;;;;;;;;;;;;CAmBC,GACD;;;;;;;CAOC,GACD,MAAMC,QAAQ,OAAOC,UAAwB,CAAC,CAAC;IAC3C,kBAAkB;IAClB,MAAMH,SAASG;AACnB;AAEA,WAAW;AACX,SAASH,QAAQ,QAAQ,qBAAqB;AAC9C,SAASC,qBAAqB,QAAQ,wBAAwB;AAG9D,iBAAiB;AACjB,SACIC,KAAK,EACLH,OAAO,GACT;AAEF,0BAA0B;AAC1B,OAAO,MAAMK,kBAAkB;IAC3B,MAAMC,kBAAkBJ;IACxB,MAAMK,WAAWD,gBAAgBE,WAAW;IAC5C,IAAID,UAAU;QACV,OAAOA,SAASE,WAAW,GAAGC,YAAY;IAC9C;IACA,OAAO;AACX,EAAE;AAEF,cAAc;AACd,SACIC,kBAAkB,EAClBC,aAAa,EACbC,QAAQ,EACRC,SAAS,EACTC,SAAS,EACTC,eAAe,QACZ,QAAQ;AAEf,SAAS;AACT,SAASC,aAAa,EAAEC,iBAAiB,EAAEC,eAAe,QAAQ,UAAU;AAG5E,WAAW;AACX,SAASC,SAAS,QAAQ,qBAAqB;AAU/C,QAAQ;AACR,SAASC,iBAAiB,EAAEC,iBAAiB,QAAQ,eAAe;AAGpE,OAAO;AACP,SAASC,aAAa,EAAEC,aAAa,QAAQ,WAAW;AAkBxD,WAAW;AACX,cAAc,YAAY;AAC1B,cAAc,WAAW;AAEzB,WAAW;AACX,cAAc,WAAW;AAEzB,SAAS;AACT,SAASC,QAAQ,EAAEC,eAAe,QAAQ,iBAAiB"}

package/dist/core/initialization/InitializationErrorThrower.cjs

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "InitializationErrorThrower", {
+    enumerable: true,
+    get: function() {
+        return InitializationErrorThrower;
+    }
+});
+const _react = /*#__PURE__*/ _interop_require_wildcard(require("react"));
+const _initializationErrorState = require("./initializationErrorState");
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+const InitializationErrorThrower = ()=>{
+    const [error, setError] = (0, _react.useState)(null);
+    (0, _react.useEffect)(()=>{
+        // 检查初始错误
+        const currentError = _initializationErrorState.initializationErrorState.getError();
+        if (currentError) {
+            setError(currentError);
+            return;
+        }
+        // 订阅错误变化
+        const unsubscribe = _initializationErrorState.initializationErrorState.subscribe(()=>{
+            const newError = _initializationErrorState.initializationErrorState.getError();
+            setError(newError);
+        });
+        return unsubscribe;
+    }, []);
+    // 如果有错误，抛出错误给 ErrorBoundary
+    if (error) {
+        throw error;
+    }
+    return null;
+};
+
+//# sourceMappingURL=InitializationErrorThrower.js.map

package/dist/core/initialization/InitializationErrorThrower.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/initialization/InitializationErrorThrower.tsx"],"sourcesContent":["import React, { useEffect, useState } from 'react';\nimport { initializationErrorState } from './initializationErrorState';\nimport type { FrameworkError } from '../../utils/errors';\n\n/**\n * 初始化错误抛出组件\n * \n * 当检测到初始化错误时，主动抛出错误给 ErrorBoundary 捕获\n */\nexport const InitializationErrorThrower: React.FC = () => {\n  const [error, setError] = useState<FrameworkError | null>(null);\n\n  useEffect(() => {\n    // 检查初始错误\n    const currentError = initializationErrorState.getError();\n    if (currentError) {\n      setError(currentError);\n      return;\n    }\n\n    // 订阅错误变化\n    const unsubscribe = initializationErrorState.subscribe(() => {\n      const newError = initializationErrorState.getError();\n      setError(newError);\n    });\n\n    return unsubscribe;\n  }, []);\n\n  // 如果有错误，抛出错误给 ErrorBoundary\n  if (error) {\n    throw error;\n  }\n\n  return null;\n};\n"],"names":["InitializationErrorThrower","error","setError","useState","useEffect","currentError","initializationErrorState","getError","unsubscribe","subscribe","newError"],"mappings":";;;;+BASaA;;;eAAAA;;;+DAT8B;0CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQlC,MAAMA,6BAAuC;IAClD,MAAM,CAACC,OAAOC,SAAS,GAAGC,IAAAA,eAAQ,EAAwB;IAE1DC,IAAAA,gBAAS,EAAC;QACR,SAAS;QACT,MAAMC,eAAeC,kDAAwB,CAACC,QAAQ;QACtD,IAAIF,cAAc;YAChBH,SAASG;YACT;QACF;QAEA,SAAS;QACT,MAAMG,cAAcF,kDAAwB,CAACG,SAAS,CAAC;YACrD,MAAMC,WAAWJ,kDAAwB,CAACC,QAAQ;YAClDL,SAASQ;QACX;QAEA,OAAOF;IACT,GAAG,EAAE;IAEL,4BAA4B;IAC5B,IAAIP,OAAO;QACT,MAAMA;IACR;IAEA,OAAO;AACT"}

package/dist/core/initialization/InitializationErrorThrower.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * 初始化错误抛出组件
+ *
+ * 当检测到初始化错误时，主动抛出错误给 ErrorBoundary 捕获
+ */
+export declare const InitializationErrorThrower: React.FC;
+//# sourceMappingURL=InitializationErrorThrower.d.ts.map

package/dist/core/initialization/InitializationErrorThrower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InitializationErrorThrower.d.ts","sourceRoot":"","sources":["../../../src/core/initialization/InitializationErrorThrower.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,EA0B9C,CAAC"}

package/dist/core/initialization/InitializationErrorThrower.js

@@ -0,0 +1,30 @@
+import React, { useEffect, useState } from "react";
+import { initializationErrorState } from "./initializationErrorState";
+/**
+ * 初始化错误抛出组件
+ * 
+ * 当检测到初始化错误时，主动抛出错误给 ErrorBoundary 捕获
+ */ export const InitializationErrorThrower = ()=>{
+    const [error, setError] = useState(null);
+    useEffect(()=>{
+        // 检查初始错误
+        const currentError = initializationErrorState.getError();
+        if (currentError) {
+            setError(currentError);
+            return;
+        }
+        // 订阅错误变化
+        const unsubscribe = initializationErrorState.subscribe(()=>{
+            const newError = initializationErrorState.getError();
+            setError(newError);
+        });
+        return unsubscribe;
+    }, []);
+    // 如果有错误，抛出错误给 ErrorBoundary
+    if (error) {
+        throw error;
+    }
+    return null;
+};
+
+//# sourceMappingURL=InitializationErrorThrower.js.map

package/dist/core/initialization/InitializationErrorThrower.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/initialization/InitializationErrorThrower.tsx"],"sourcesContent":["import React, { useEffect, useState } from 'react';\nimport { initializationErrorState } from './initializationErrorState';\nimport type { FrameworkError } from '../../utils/errors';\n\n/**\n * 初始化错误抛出组件\n * \n * 当检测到初始化错误时，主动抛出错误给 ErrorBoundary 捕获\n */\nexport const InitializationErrorThrower: React.FC = () => {\n  const [error, setError] = useState<FrameworkError | null>(null);\n\n  useEffect(() => {\n    // 检查初始错误\n    const currentError = initializationErrorState.getError();\n    if (currentError) {\n      setError(currentError);\n      return;\n    }\n\n    // 订阅错误变化\n    const unsubscribe = initializationErrorState.subscribe(() => {\n      const newError = initializationErrorState.getError();\n      setError(newError);\n    });\n\n    return unsubscribe;\n  }, []);\n\n  // 如果有错误，抛出错误给 ErrorBoundary\n  if (error) {\n    throw error;\n  }\n\n  return null;\n};\n"],"names":["React","useEffect","useState","initializationErrorState","InitializationErrorThrower","error","setError","currentError","getError","unsubscribe","subscribe","newError"],"mappings":"AAAA,OAAOA,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAQ;AACnD,SAASC,wBAAwB,QAAQ,6BAA6B;AAGtE;;;;CAIC,GACD,OAAO,MAAMC,6BAAuC;IAClD,MAAM,CAACC,OAAOC,SAAS,GAAGJ,SAAgC;IAE1DD,UAAU;QACR,SAAS;QACT,MAAMM,eAAeJ,yBAAyBK,QAAQ;QACtD,IAAID,cAAc;YAChBD,SAASC;YACT;QACF;QAEA,SAAS;QACT,MAAME,cAAcN,yBAAyBO,SAAS,CAAC;YACrD,MAAMC,WAAWR,yBAAyBK,QAAQ;YAClDF,SAASK;QACX;QAEA,OAAOF;IACT,GAAG,EAAE;IAEL,4BAA4B;IAC5B,IAAIJ,OAAO;QACT,MAAMA;IACR;IAEA,OAAO;AACT,EAAE"}

package/dist/core/initialization/index.cjs

@@ -0,0 +1,28 @@
+/**
+ * 初始化模块统一导出
+ */ "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 InitializationErrorThrower () {
+        return _InitializationErrorThrower.InitializationErrorThrower;
+    },
+    get initialization () {
+        return _initialization.initialization;
+    },
+    get initializationErrorState () {
+        return _initializationErrorState.initializationErrorState;
+    }
+});
+const _initialization = require("./initialization");
+const _InitializationErrorThrower = require("./InitializationErrorThrower");
+const _initializationErrorState = require("./initializationErrorState");
+
+//# sourceMappingURL=index.js.map

package/dist/core/initialization/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/initialization/index.ts"],"sourcesContent":["/**\n * 初始化模块统一导出\n */\n\nexport { initialization } from './initialization';\nexport type {\n  InitializationContext,\n  ConfigStrategy,\n  InitializationOptions,\n  ProgressCallback,\n} from './initialization';\nexport { InitializationErrorThrower } from './InitializationErrorThrower';\nexport { initializationErrorState } from './initializationErrorState';\n"],"names":["InitializationErrorThrower","initialization","initializationErrorState"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QASQA;eAAAA,sDAA0B;;QAP1BC;eAAAA,8BAAc;;QAQdC;eAAAA,kDAAwB;;;gCARF;4CAOY;0CACF"}

package/dist/core/initialization/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 初始化模块统一导出
+ */
+export { initialization } from './initialization';
+export type { InitializationContext, ConfigStrategy, InitializationOptions, ProgressCallback, } from './initialization';
+export { InitializationErrorThrower } from './InitializationErrorThrower';
+export { initializationErrorState } from './initializationErrorState';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/initialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/initialization/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/core/initialization/index.js

@@ -0,0 +1,7 @@
+/**
+ * 初始化模块统一导出
+ */ export { initialization } from "./initialization";
+export { InitializationErrorThrower } from "./InitializationErrorThrower";
+export { initializationErrorState } from "./initializationErrorState";
+
+//# sourceMappingURL=index.js.map

package/dist/core/initialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/initialization/index.ts"],"sourcesContent":["/**\n * 初始化模块统一导出\n */\n\nexport { initialization } from './initialization';\nexport type {\n  InitializationContext,\n  ConfigStrategy,\n  InitializationOptions,\n  ProgressCallback,\n} from './initialization';\nexport { InitializationErrorThrower } from './InitializationErrorThrower';\nexport { initializationErrorState } from './initializationErrorState';\n"],"names":["initialization","InitializationErrorThrower","initializationErrorState"],"mappings":"AAAA;;CAEC,GAED,SAASA,cAAc,QAAQ,mBAAmB;AAOlD,SAASC,0BAA0B,QAAQ,+BAA+B;AAC1E,SAASC,wBAAwB,QAAQ,6BAA6B"}

package/dist/core/initialization/initialization.cjs

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "initialization", {
+    enumerable: true,
+    get: function() {
+        return initialization;
+    }
+});
+const _utils = require("../../utils");
+const _library = require("../../library");
+const _errors = require("../../utils/errors");
+const _configSecurity = require("../../utils/configSecurity");
+const _plugin = require("../plugin");
+/**
+ * 配置缓存键
+ */ const CONFIG_CACHE_KEY = '__framework_config_cache__';
+/**
+ * 加载配置（带超时、重试和缓存）
+ */ async function loadConfigWithRetry(loadConfig, strategy, fallbackConfig) {
+    const timeout = strategy.configTimeout ?? 5000;
+    const retryCount = strategy.retryCount ?? 3;
+    const retryDelay = strategy.retryDelay ?? 1000;
+    const enableCache = strategy.enableCache ?? true;
+    const cacheTTL = strategy.cacheTTL ?? 5 * 60 * 1000; // 5分钟
+    const configVersion = strategy.configVersion;
+    // 检查缓存
+    if (enableCache && _library.storage.localCache) {
+        try {
+            const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;
+            const cached = await _library.storage.localCache.get(cacheKey);
+            if (cached && (!configVersion || cached.version === configVersion)) {
+                _utils.logger.debug('使用缓存的配置');
+                return cached.data;
+            }
+        } catch (error) {
+            _utils.logger.warn('读取配置缓存失败:', error);
+        }
+    }
+    // 重试加载配置
+    let lastError = null;
+    for(let attempt = 0; attempt <= retryCount; attempt++){
+        try {
+            if (attempt > 0) {
+                _utils.logger.debug(`配置加载重试 ${attempt}/${retryCount}`);
+                // 指数退避
+                await new Promise((resolve)=>setTimeout(resolve, retryDelay * Math.pow(2, attempt - 1)));
+            }
+            const configPromise = loadConfig();
+            const timeoutPromise = new Promise((_, reject)=>setTimeout(()=>reject(new _errors.NetworkError('配置加载超时')), timeout));
+            const config = await Promise.race([
+                configPromise,
+                timeoutPromise
+            ]);
+            // 保存到缓存
+            if (enableCache && _library.storage.localCache) {
+                try {
+                    const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;
+                    await _library.storage.localCache.set(cacheKey, {
+                        data: config,
+                        version: configVersion
+                    }, cacheTTL);
+                } catch (error) {
+                    _utils.logger.warn('保存配置缓存失败:', error);
+                }
+            }
+            return config;
+        } catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            _utils.logger.warn(`配置加载失败 (尝试 ${attempt + 1}/${retryCount + 1}):`, lastError);
+        }
+    }
+    // 所有重试都失败，使用降级配置
+    _utils.logger.warn('配置加载失败，使用降级配置:', lastError);
+    return fallbackConfig || {};
+}
+async function initialization(options, onProgress) {
+    const startTime = Date.now();
+    let config = {};
+    try {
+        // 0. 执行插件初始化前钩子
+        await _plugin.pluginManager.executeBeforeInit(options);
+        // 1. 设置日志级别
+        onProgress?.(5, '初始化日志系统...');
+        _utils.logger.setLevel(options.loggerLevel ?? _utils.LogLevel.INFO);
+        // 2. 加载关键配置
+        if (options.configStrategy?.loadCriticalConfig) {
+            onProgress?.(10, '加载关键配置...');
+            try {
+                config = await loadConfigWithRetry(options.configStrategy.loadCriticalConfig, options.configStrategy, options.configStrategy.fallbackConfig);
+                // 验证配置安全性
+                if (options.configSecurity) {
+                    const securityResult = await _configSecurity.ConfigSecurity.validateConfigSecurity(config, options.configSecurity);
+                    if (!securityResult.valid) {
+                        _utils.logger.warn('配置安全验证失败:', securityResult.errors);
+                    // 根据安全策略决定是否继续
+                    }
+                }
+                options.configStrategy.onConfigLoaded?.(config);
+                onProgress?.(30, '关键配置加载完成');
+            } catch (error) {
+                _utils.logger.warn('关键配置加载失败，使用默认配置:', error);
+                config = options.configStrategy.fallbackConfig || {};
+                options.configStrategy.onConfigLoaded?.(config);
+                onProgress?.(30, '使用默认配置');
+            }
+        } else {
+            onProgress?.(30);
+        }
+        // 2.5. 渐进式加载非关键配置（在应用渲染后异步加载）
+        if (options.configStrategy?.loadNonCriticalConfig) {
+            // 智能延迟加载：根据网络状况动态调整延迟时间
+            const getDelayTime = ()=>{
+                if (typeof navigator === 'undefined' || !('connection' in navigator)) {
+                    return 1000; // 默认延迟
+                }
+                const connection = navigator.connection;
+                if (!connection) {
+                    return 1000;
+                }
+                // 根据网络类型调整延迟
+                const effectiveType = connection.effectiveType;
+                switch(effectiveType){
+                    case 'slow-2g':
+                    case '2g':
+                        return 3000; // 慢网络延迟更久
+                    case '3g':
+                        return 2000;
+                    case '4g':
+                    default:
+                        return 500; // 快网络可以更快加载
+                }
+            };
+            // 使用 requestIdleCallback 在空闲时加载
+            if (typeof requestIdleCallback !== 'undefined') {
+                requestIdleCallback(async ()=>{
+                    try {
+                        const nonCriticalConfig = await loadConfigWithRetry(options.configStrategy.loadNonCriticalConfig, options.configStrategy, {});
+                        // 合并到主配置
+                        config = {
+                            ...config,
+                            ...nonCriticalConfig
+                        };
+                        options.configStrategy?.onConfigLoaded?.(config);
+                        _utils.logger.debug('非关键配置加载完成');
+                    } catch (error) {
+                        _utils.logger.warn('非关键配置加载失败:', error);
+                    }
+                }, {
+                    timeout: getDelayTime()
+                });
+            } else {
+                // 降级方案：智能延迟加载
+                setTimeout(async ()=>{
+                    try {
+                        const nonCriticalConfig = await loadConfigWithRetry(options.configStrategy.loadNonCriticalConfig, options.configStrategy, {});
+                        config = {
+                            ...config,
+                            ...nonCriticalConfig
+                        };
+                        options.configStrategy?.onConfigLoaded?.(config);
+                        _utils.logger.debug('非关键配置加载完成');
+                    } catch (error) {
+                        _utils.logger.warn('非关键配置加载失败:', error);
+                    }
+                }, getDelayTime());
+            }
+        }
+        // 3. 初始化之前回调
+        if (options.lifecycle?.beforeInitialization) {
+            onProgress?.(35, '执行初始化前回调...');
+            await options.lifecycle.beforeInitialization();
+        }
+        // 4. 国际化设置
+        onProgress?.(40, '设置国际化...');
+        (0, _library.setupI18n)(options.locale || undefined);
+        // 5. 核心初始化
+        if (options.lifecycle?.initialization) {
+            onProgress?.(50, '初始化核心功能...');
+            await options.lifecycle.initialization();
+            onProgress?.(70, '核心功能初始化完成');
+        } else {
+            onProgress?.(70);
+        }
+        onProgress?.(80, '准备完成...');
+        const duration = Date.now() - startTime;
+        const context = {
+            config,
+            progress: 100,
+            isReady: true,
+            duration
+        };
+        // 执行插件初始化钩子
+        await _plugin.pluginManager.executeInit(options, context);
+        // 执行插件初始化后钩子
+        await _plugin.pluginManager.executeAfterInit(options, context);
+        // 6. 初始化之后回调（在 context 创建后执行，可以访问完整的初始化上下文）
+        if (options.lifecycle?.afterInitialization) {
+            onProgress?.(90, '执行初始化后回调...');
+            await options.lifecycle.afterInitialization(context);
+        }
+        onProgress?.(100, '初始化完成');
+        return context;
+    } catch (error) {
+        _utils.logger.error('初始化失败:', error);
+        throw error;
+    }
+}
+
+//# sourceMappingURL=initialization.js.map

package/dist/core/initialization/initialization.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/initialization/initialization.ts"],"sourcesContent":["import { logger, LogLevel } from '../../utils';\nimport { setupI18n } from '../../library';\nimport { storage } from '../../library';\nimport type { LangType } from '../../library/locale/types';\nimport type { ManagerLifecycle, StartOptions } from '../types';\nimport { NetworkError } from '../../utils/errors';\nimport { ConfigSecurity } from '../../utils/configSecurity';\nimport { pluginManager } from '../plugin';\n\n/**\n * 初始化上下文\n */\nexport interface InitializationContext {\n  /**\n   * 已加载的配置\n   */\n  config: Record<string, unknown>;\n\n  /**\n   * 初始化进度（0-100）\n   */\n  progress: number;\n\n  /**\n   * 是否准备就绪\n   */\n  isReady: boolean;\n\n  /**\n   * 初始化耗时（毫秒）\n   */\n  duration: number;\n}\n\n/**\n * 配置加载策略\n */\nexport interface ConfigStrategy {\n  /**\n   * 加载关键配置\n   * 这些配置必须在应用渲染前加载完成\n   */\n  loadCriticalConfig?: () => Promise<Record<string, unknown>>;\n\n  /**\n   * 加载非关键配置\n   * 这些配置可以在应用渲染后异步加载\n   */\n  loadNonCriticalConfig?: () => Promise<Record<string, unknown>>;\n\n  /**\n   * 配置降级方案\n   * 当配置加载失败时使用的默认配置\n   */\n  fallbackConfig?: Record<string, unknown>;\n\n  /**\n   * 配置超时时间（毫秒）\n   * 默认 5000ms，超时后使用降级配置\n   */\n  configTimeout?: number;\n\n  /**\n   * 配置版本号（用于缓存失效）\n   */\n  configVersion?: string;\n\n  /**\n   * 配置加载完成回调\n   */\n  onConfigLoaded?: (config: Record<string, unknown>) => void;\n\n  /**\n   * 是否启用缓存\n   * @default true\n   */\n  enableCache?: boolean;\n\n  /**\n   * 缓存过期时间（毫秒）\n   * @default 5 * 60 * 1000 (5分钟)\n   */\n  cacheTTL?: number;\n\n  /**\n   * 重试次数\n   * @default 3\n   */\n  retryCount?: number;\n\n  /**\n   * 重试延迟（毫秒）\n   * @default 1000\n   */\n  retryDelay?: number;\n}\n\n/**\n * 初始化选项\n */\nexport interface InitializationOptions {\n  /**\n   * 日志级别\n   */\n  loggerLevel?: LogLevel;\n\n  /**\n   * 国际化配置\n   */\n  locale?: Record<LangType, Record<string, unknown>>;\n\n  /**\n   * 生命周期钩子\n   */\n  lifecycle?: ManagerLifecycle;\n\n  /**\n   * 配置加载策略\n   */\n  configStrategy?: ConfigStrategy;\n}\n\n/**\n * 进度回调函数\n */\nexport type ProgressCallback = (progress: number, step?: string) => void;\n\n/**\n * 配置缓存键\n */\nconst CONFIG_CACHE_KEY = '__framework_config_cache__';\n\n/**\n * 加载配置（带超时、重试和缓存）\n */\nasync function loadConfigWithRetry(\n  loadConfig: () => Promise<Record<string, unknown>>,\n  strategy: ConfigStrategy,\n  fallbackConfig?: Record<string, unknown>\n): Promise<Record<string, unknown>> {\n  const timeout = strategy.configTimeout ?? 5000;\n  const retryCount = strategy.retryCount ?? 3;\n  const retryDelay = strategy.retryDelay ?? 1000;\n  const enableCache = strategy.enableCache ?? true;\n  const cacheTTL = strategy.cacheTTL ?? 5 * 60 * 1000; // 5分钟\n  const configVersion = strategy.configVersion;\n\n  // 检查缓存\n  if (enableCache && storage.localCache) {\n    try {\n      const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;\n      const cached = await storage.localCache.get<{ data: Record<string, unknown>; version?: string }>(cacheKey);\n      if (cached && (!configVersion || cached.version === configVersion)) {\n        logger.debug('使用缓存的配置');\n        return cached.data;\n      }\n    } catch (error) {\n      logger.warn('读取配置缓存失败:', error);\n    }\n  }\n\n  // 重试加载配置\n  let lastError: Error | null = null;\n  for (let attempt = 0; attempt <= retryCount; attempt++) {\n    try {\n      if (attempt > 0) {\n        logger.debug(`配置加载重试 ${attempt}/${retryCount}`);\n        // 指数退避\n        await new Promise((resolve) => setTimeout(resolve, retryDelay * Math.pow(2, attempt - 1)));\n      }\n\n      const configPromise = loadConfig();\n      const timeoutPromise = new Promise<Record<string, unknown>>((_, reject) =>\n        setTimeout(() => reject(new NetworkError('配置加载超时')), timeout)\n      );\n\n      const config = await Promise.race([configPromise, timeoutPromise]);\n\n      // 保存到缓存\n      if (enableCache && storage.localCache) {\n        try {\n          const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;\n          await storage.localCache.set(cacheKey, { data: config, version: configVersion }, cacheTTL);\n        } catch (error) {\n          logger.warn('保存配置缓存失败:', error);\n        }\n      }\n\n      return config;\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n      logger.warn(`配置加载失败 (尝试 ${attempt + 1}/${retryCount + 1}):`, lastError);\n    }\n  }\n\n  // 所有重试都失败，使用降级配置\n  logger.warn('配置加载失败，使用降级配置:', lastError);\n  return fallbackConfig || {};\n}\n\n/**\n * 初始化方法\n * \n * 这是核心的初始化逻辑，可被启动页或直接调用\n * \n * @param options - 初始化选项\n * @param onProgress - 进度回调函数（可选）\n * @returns Promise<InitializationContext>\n * \n * @example\n * ```typescript\n * const context = await initialization({\n *   loggerLevel: LogLevel.INFO,\n *   lifecycle: {\n *     initialization: async () => {\n *       // 初始化逻辑\n *     },\n *   },\n * }, (progress, step) => {\n *   console.log(`进度: ${progress}%, 步骤: ${step}`);\n * });\n * ```\n */\nexport async function initialization(\n  options: StartOptions,\n  onProgress?: ProgressCallback\n): Promise<InitializationContext> {\n  const startTime = Date.now();\n  let config: Record<string, unknown> = {};\n\n  try {\n    // 0. 执行插件初始化前钩子\n    await pluginManager.executeBeforeInit(options);\n\n    // 1. 设置日志级别\n    onProgress?.(5, '初始化日志系统...');\n    logger.setLevel(options.loggerLevel ?? LogLevel.INFO);\n\n    // 2. 加载关键配置\n    if (options.configStrategy?.loadCriticalConfig) {\n      onProgress?.(10, '加载关键配置...');\n      try {\n        config = await loadConfigWithRetry(\n          options.configStrategy.loadCriticalConfig,\n          options.configStrategy,\n          options.configStrategy.fallbackConfig\n        );\n\n        // 验证配置安全性\n        if (options.configSecurity) {\n          const securityResult = await ConfigSecurity.validateConfigSecurity(\n            config,\n            options.configSecurity\n          );\n          if (!securityResult.valid) {\n            logger.warn('配置安全验证失败:', securityResult.errors);\n            // 根据安全策略决定是否继续\n          }\n        }\n\n        options.configStrategy.onConfigLoaded?.(config);\n        onProgress?.(30, '关键配置加载完成');\n      } catch (error) {\n        logger.warn('关键配置加载失败，使用默认配置:', error);\n        config = options.configStrategy.fallbackConfig || {};\n        options.configStrategy.onConfigLoaded?.(config);\n        onProgress?.(30, '使用默认配置');\n      }\n    } else {\n      onProgress?.(30);\n    }\n\n    // 2.5. 渐进式加载非关键配置（在应用渲染后异步加载）\n    if (options.configStrategy?.loadNonCriticalConfig) {\n      // 智能延迟加载：根据网络状况动态调整延迟时间\n      const getDelayTime = (): number => {\n        if (typeof navigator === 'undefined' || !('connection' in navigator)) {\n          return 1000; // 默认延迟\n        }\n\n        const connection = (navigator as any).connection;\n        if (!connection) {\n          return 1000;\n        }\n\n        // 根据网络类型调整延迟\n        const effectiveType = connection.effectiveType;\n        switch (effectiveType) {\n          case 'slow-2g':\n          case '2g':\n            return 3000; // 慢网络延迟更久\n          case '3g':\n            return 2000;\n          case '4g':\n          default:\n            return 500; // 快网络可以更快加载\n        }\n      };\n\n      // 使用 requestIdleCallback 在空闲时加载\n      if (typeof requestIdleCallback !== 'undefined') {\n        requestIdleCallback(\n          async () => {\n            try {\n              const nonCriticalConfig = await loadConfigWithRetry(\n                options.configStrategy!.loadNonCriticalConfig!,\n                options.configStrategy!,\n                {}\n              );\n              // 合并到主配置\n              config = { ...config, ...nonCriticalConfig };\n              options.configStrategy?.onConfigLoaded?.(config);\n              logger.debug('非关键配置加载完成');\n            } catch (error) {\n              logger.warn('非关键配置加载失败:', error);\n            }\n          },\n          { timeout: getDelayTime() }\n        );\n      } else {\n        // 降级方案：智能延迟加载\n        setTimeout(async () => {\n          try {\n            const nonCriticalConfig = await loadConfigWithRetry(\n              options.configStrategy!.loadNonCriticalConfig!,\n              options.configStrategy!,\n              {}\n            );\n            config = { ...config, ...nonCriticalConfig };\n            options.configStrategy?.onConfigLoaded?.(config);\n            logger.debug('非关键配置加载完成');\n          } catch (error) {\n            logger.warn('非关键配置加载失败:', error);\n          }\n        }, getDelayTime());\n      }\n    }\n\n    // 3. 初始化之前回调\n    if (options.lifecycle?.beforeInitialization) {\n      onProgress?.(35, '执行初始化前回调...');\n      await options.lifecycle.beforeInitialization();\n    }\n\n    // 4. 国际化设置\n    onProgress?.(40, '设置国际化...');\n    setupI18n(options.locale || undefined);\n\n    // 5. 核心初始化\n    if (options.lifecycle?.initialization) {\n      onProgress?.(50, '初始化核心功能...');\n      await options.lifecycle.initialization();\n      onProgress?.(70, '核心功能初始化完成');\n    } else {\n      onProgress?.(70);\n    }\n\n    onProgress?.(80, '准备完成...');\n\n    const duration = Date.now() - startTime;\n\n    const context: InitializationContext = {\n      config,\n      progress: 100,\n      isReady: true,\n      duration,\n    };\n\n    // 执行插件初始化钩子\n    await pluginManager.executeInit(options, context);\n\n    // 执行插件初始化后钩子\n    await pluginManager.executeAfterInit(options, context);\n\n    // 6. 初始化之后回调（在 context 创建后执行，可以访问完整的初始化上下文）\n    if (options.lifecycle?.afterInitialization) {\n      onProgress?.(90, '执行初始化后回调...');\n      await options.lifecycle.afterInitialization(context);\n    }\n\n    onProgress?.(100, '初始化完成');\n\n    return context;\n  } catch (error) {\n    logger.error('初始化失败:', error);\n    throw error;\n  }\n}\n"],"names":["initialization","CONFIG_CACHE_KEY","loadConfigWithRetry","loadConfig","strategy","fallbackConfig","timeout","configTimeout","retryCount","retryDelay","enableCache","cacheTTL","configVersion","storage","localCache","cacheKey","cached","get","version","logger","debug","data","error","warn","lastError","attempt","Promise","resolve","setTimeout","Math","pow","configPromise","timeoutPromise","_","reject","NetworkError","config","race","set","Error","String","options","onProgress","startTime","Date","now","pluginManager","executeBeforeInit","setLevel","loggerLevel","LogLevel","INFO","configStrategy","loadCriticalConfig","configSecurity","securityResult","ConfigSecurity","validateConfigSecurity","valid","errors","onConfigLoaded","loadNonCriticalConfig","getDelayTime","navigator","connection","effectiveType","requestIdleCallback","nonCriticalConfig","lifecycle","beforeInitialization","setupI18n","locale","undefined","duration","context","progress","isReady","executeInit","executeAfterInit","afterInitialization"],"mappings":"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"}

package/dist/core/initialization/initialization.d.ts

@@ -0,0 +1,127 @@
+import { LogLevel } from '../../utils';
+import type { LangType } from '../../library/locale/types';
+import type { ManagerLifecycle, StartOptions } from '../types';
+/**
+ * 初始化上下文
+ */
+export interface InitializationContext {
+    /**
+     * 已加载的配置
+     */
+    config: Record<string, unknown>;
+    /**
+     * 初始化进度（0-100）
+     */
+    progress: number;
+    /**
+     * 是否准备就绪
+     */
+    isReady: boolean;
+    /**
+     * 初始化耗时（毫秒）
+     */
+    duration: number;
+}
+/**
+ * 配置加载策略
+ */
+export interface ConfigStrategy {
+    /**
+     * 加载关键配置
+     * 这些配置必须在应用渲染前加载完成
+     */
+    loadCriticalConfig?: () => Promise<Record<string, unknown>>;
+    /**
+     * 加载非关键配置
+     * 这些配置可以在应用渲染后异步加载
+     */
+    loadNonCriticalConfig?: () => Promise<Record<string, unknown>>;
+    /**
+     * 配置降级方案
+     * 当配置加载失败时使用的默认配置
+     */
+    fallbackConfig?: Record<string, unknown>;
+    /**
+     * 配置超时时间（毫秒）
+     * 默认 5000ms，超时后使用降级配置
+     */
+    configTimeout?: number;
+    /**
+     * 配置版本号（用于缓存失效）
+     */
+    configVersion?: string;
+    /**
+     * 配置加载完成回调
+     */
+    onConfigLoaded?: (config: Record<string, unknown>) => void;
+    /**
+     * 是否启用缓存
+     * @default true
+     */
+    enableCache?: boolean;
+    /**
+     * 缓存过期时间（毫秒）
+     * @default 5 * 60 * 1000 (5分钟)
+     */
+    cacheTTL?: number;
+    /**
+     * 重试次数
+     * @default 3
+     */
+    retryCount?: number;
+    /**
+     * 重试延迟（毫秒）
+     * @default 1000
+     */
+    retryDelay?: number;
+}
+/**
+ * 初始化选项
+ */
+export interface InitializationOptions {
+    /**
+     * 日志级别
+     */
+    loggerLevel?: LogLevel;
+    /**
+     * 国际化配置
+     */
+    locale?: Record<LangType, Record<string, unknown>>;
+    /**
+     * 生命周期钩子
+     */
+    lifecycle?: ManagerLifecycle;
+    /**
+     * 配置加载策略
+     */
+    configStrategy?: ConfigStrategy;
+}
+/**
+ * 进度回调函数
+ */
+export type ProgressCallback = (progress: number, step?: string) => void;
+/**
+ * 初始化方法
+ *
+ * 这是核心的初始化逻辑，可被启动页或直接调用
+ *
+ * @param options - 初始化选项
+ * @param onProgress - 进度回调函数（可选）
+ * @returns Promise<InitializationContext>
+ *
+ * @example
+ * ```typescript
+ * const context = await initialization({
+ *   loggerLevel: LogLevel.INFO,
+ *   lifecycle: {
+ *     initialization: async () => {
+ *       // 初始化逻辑
+ *     },
+ *   },
+ * }, (progress, step) => {
+ *   console.log(`进度: ${progress}%, 步骤: ${step}`);
+ * });
+ * ```
+ */
+export declare function initialization(options: StartOptions, onProgress?: ProgressCallback): Promise<InitializationContext>;
+//# sourceMappingURL=initialization.d.ts.map

package/dist/core/initialization/initialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../../src/core/initialization/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/D;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAE3D;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnD;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AA2EzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAiKhC"}