@chatbi-v/core 2.1.6 → 2.1.7

package/dist/index.d.ts

@@ -529,64 +529,6 @@ interface PluginMetadata {
     }[];
 }
 
-/**
- * 服务注册中心 (Service Registry)
- * @description 核心应用层服务，作为微内核架构中的“中枢调度员”。
- * 主要职责：
- * 1. 服务解耦：允许插件将其内部功能暴露为“服务”，而无需与其他插件产生物理依赖。
- * 2. 动态发现：提供按名称查找服务的能力，支持服务热插拔。
- * 3. 依赖协调：通过 `waitFor` 机制解决插件间由于加载顺序导致的初始化依赖问题。
- *
- * 建议的服务命名规范: `pluginId.serviceName` (例如: `auth.sessionService`)
- */
-declare class ServiceRegistry {
-    /** 存储已注册服务的 Map 对象 */
-    private services;
-    /** 存储正在等待特定服务的监听器集合 */
-    private listeners;
-    /**
-     * 注册一个服务实现
-     * @param name - 唯一的服务名称
-     * @param service - 服务实例或对象
-     */
-    register(name: string, service: any): void;
-    /**
-     * 同步获取服务实例
-     * @template T - 服务类型的泛型
-     * @param name - 服务名称
-     * @returns 服务实例，若不存在则返回 undefined
-     */
-    get<T = any>(name: string): T | undefined;
-    /**
-     * 异步等待并获取服务
-     * @description 如果服务尚未注册，将返回一个 Promise，直到该服务被注册时 resolve。
-     * 支持设置超时时间，防止因插件加载失败导致的永久挂起。
-     *
-     * @template T - 服务类型的泛型
-     * @param name - 待等待的服务名称
-     * @param timeout - 超时时间 (毫秒)，默认 10000ms (10秒)。若为 0 则永不超时。
-     * @returns 包含服务实例的 Promise
-     * @throws {Error} 若在规定时间内服务未注册，则抛出超时异常。
-     */
-    waitFor<T = any>(name: string, timeout?: number): Promise<T>;
-    /**
-     * 检查服务是否已注册
-     * @param name - 服务名称
-     */
-    has(name: string): boolean;
-    /**
-     * 注销特定的服务
-     * @param name - 服务名称
-     */
-    unregister(name: string): void;
-    /**
-     * 清除所有已注册的服务和监听器
-     * @description 通常仅在系统重置或大型热更新时使用。
-     */
-    clear(): void;
-}
-declare const serviceRegistry: ServiceRegistry;
-
 /**
  * 基于 Axios 的默认请求适配器
  */
@@ -748,6 +690,64 @@ interface ApiProviderProps {
 declare const ApiProvider: React.FC<ApiProviderProps>;
 declare const useApi: () => ApiEngine;
 
+/**
+ * 服务注册中心 (Service Registry)
+ * @description 核心应用层服务，作为微内核架构中的“中枢调度员”。
+ * 主要职责：
+ * 1. 服务解耦：允许插件将其内部功能暴露为“服务”，而无需与其他插件产生物理依赖。
+ * 2. 动态发现：提供按名称查找服务的能力，支持服务热插拔。
+ * 3. 依赖协调：通过 `waitFor` 机制解决插件间由于加载顺序导致的初始化依赖问题。
+ *
+ * 建议的服务命名规范: `pluginId.serviceName` (例如: `auth.sessionService`)
+ */
+declare class ServiceRegistry {
+    /** 存储已注册服务的 Map 对象 */
+    private services;
+    /** 存储正在等待特定服务的监听器集合 */
+    private listeners;
+    /**
+     * 注册一个服务实现
+     * @param name - 唯一的服务名称
+     * @param service - 服务实例或对象
+     */
+    register(name: string, service: any): void;
+    /**
+     * 同步获取服务实例
+     * @template T - 服务类型的泛型
+     * @param name - 服务名称
+     * @returns 服务实例，若不存在则返回 undefined
+     */
+    get<T = any>(name: string): T | undefined;
+    /**
+     * 异步等待并获取服务
+     * @description 如果服务尚未注册，将返回一个 Promise，直到该服务被注册时 resolve。
+     * 支持设置超时时间，防止因插件加载失败导致的永久挂起。
+     *
+     * @template T - 服务类型的泛型
+     * @param name - 待等待的服务名称
+     * @param timeout - 超时时间 (毫秒)，默认 10000ms (10秒)。若为 0 则永不超时。
+     * @returns 包含服务实例的 Promise
+     * @throws {Error} 若在规定时间内服务未注册，则抛出超时异常。
+     */
+    waitFor<T = any>(name: string, timeout?: number): Promise<T>;
+    /**
+     * 检查服务是否已注册
+     * @param name - 服务名称
+     */
+    has(name: string): boolean;
+    /**
+     * 注销特定的服务
+     * @param name - 服务名称
+     */
+    unregister(name: string): void;
+    /**
+     * 清除所有已注册的服务和监听器
+     * @description 通常仅在系统重置或大型热更新时使用。
+     */
+    clear(): void;
+}
+declare const serviceRegistry: ServiceRegistry;
+
 /**
  * 配置管理器
  * @description 核心工具类，负责管理应用的全局系统配置以及各插件的初始化业务配置。
@@ -1546,6 +1546,36 @@ declare class ProxySandbox {
     private patchGlobalEffects;
 }
 
+/**
+ * 日期时间格式化工具类
+ */
+declare const dateUtils: {
+    /**
+     * 格式化日期为 YYYY-MM-DD
+     */
+    formatDate(date?: dayjs.ConfigType): string;
+    /**
+     * 格式化时间为 HH:mm:ss
+     */
+    formatTime(date?: dayjs.ConfigType): string;
+    /**
+     * 格式化日期时间为 YYYY-MM-DD HH:mm:ss
+     */
+    formatDateTime(date?: dayjs.ConfigType): string;
+    /**
+     * 获取当前时间戳（毫秒）
+     */
+    now(): number;
+    /**
+     * 获取相对时间（例如：几分钟前）
+     */
+    fromNow(date: dayjs.ConfigType): string;
+    /**
+     * 原始 dayjs 对象，用于更复杂的场景
+     */
+    dayjs: typeof dayjs;
+};
+
 /**
  * 日志等级枚举
  */
@@ -1655,36 +1685,6 @@ declare const logger: Logger;
  */
 declare const createLogger: (prefix: string) => Logger;
 
-/**
- * 日期时间格式化工具类
- */
-declare const dateUtils: {
-    /**
-     * 格式化日期为 YYYY-MM-DD
-     */
-    formatDate(date?: dayjs.ConfigType): string;
-    /**
-     * 格式化时间为 HH:mm:ss
-     */
-    formatTime(date?: dayjs.ConfigType): string;
-    /**
-     * 格式化日期时间为 YYYY-MM-DD HH:mm:ss
-     */
-    formatDateTime(date?: dayjs.ConfigType): string;
-    /**
-     * 获取当前时间戳（毫秒）
-     */
-    now(): number;
-    /**
-     * 获取相对时间（例如：几分钟前）
-     */
-    fromNow(date: dayjs.ConfigType): string;
-    /**
-     * 原始 dayjs 对象，用于更复杂的场景
-     */
-    dayjs: typeof dayjs;
-};
-
 type KeepStrategy = 'first' | 'last' | 'search' | 'hash';
 /**
  * 把当前地址中所有出现的参数合并成一份。
@@ -1703,22 +1703,6 @@ declare function cleanUrlParams(keysToRemove: string[]): string;
 
 declare const version = "1.0.0";
 
-/**
- * Hook 配置选项
- */
-interface UseStorageStateOptions<T> {
-    defaultValue?: T;
-    scope?: 'plugin' | 'shared';
-}
-/**
- * 统一存储状态 Hook
- * @description 提供与 StorageManager 和 Schema Registry 集成的持久化状态 Hook。
- * @param pluginId 定义该 Key 的插件 ID
- * @param key 存储键名 (必须在 Schema 中注册)
- * @param options 配置项，包含默认值和作用域
- */
-declare function useStorageState<T>(pluginId: string, key: string, options?: UseStorageStateOptions<T>): [T, (value: T | ((val: T) => T)) => void];
-
 /** 插件加载 Hook 的配置选项 */
 interface PluginLoaderOptions {
     /** 插件发现规则，定义如何从模块列表中识别插件 */
@@ -1755,4 +1739,20 @@ declare const usePluginLoader: (options: PluginLoaderOptions) => {
     pluginVersion: number;
 };
 
+/**
+ * Hook 配置选项
+ */
+interface UseStorageStateOptions<T> {
+    defaultValue?: T;
+    scope?: 'plugin' | 'shared';
+}
+/**
+ * 统一存储状态 Hook
+ * @description 提供与 StorageManager 和 Schema Registry 集成的持久化状态 Hook。
+ * @param pluginId 定义该 Key 的插件 ID
+ * @param key 存储键名 (必须在 Schema 中注册)
+ * @param options 配置项，包含默认值和作用域
+ */
+declare function useStorageState<T>(pluginId: string, key: string, options?: UseStorageStateOptions<T>): [T, (value: T | ((val: T) => T)) => void];
+
 export { type ApiAdapter, type ApiConfig, type ApiEndpointConfig, ApiEngine, type ApiInterceptor, ApiProvider, type ApiProviderProps, type ApiRequestConfig, type ApiResponseContext, AvatarSkeleton, AxiosAdapter, BasePlugin, type BaseResponse, BlockSkeleton, ConfigManager, DefaultEventBus, type DiscoveryRule, type ErrorStrategy, type EventBus, type EventBusPort, type EventCallback, type HttpMethod, LocalStorageAdapter, LogLevel, Logger, PLUGIN_TYPES, type Plugin, type PluginCapabilities, type PluginConfigItem, type PluginContext, PluginErrorBoundary, type PluginExtension, type PluginLifecycle, type PluginLoaderOptions, PluginManager, type PluginMetadata, PluginProvider, type PluginProviderProps, type PluginRegistry, PluginRuntime, PluginSandbox, PluginSlot, type PluginStorage, type PluginType, ProxySandbox, type RequestOptions, type RouteConfig, SUCCESS_CODE, type Scene, ScopedStorageAdapter, ServiceRegistry, SidebarIconSkeleton, Slot, type SlotPosition, SlotSkeletons, type SlotType, StatusBarItemSkeleton, type StorageItemSchema, StorageManager, type StoragePort, type StreamCallbacks, type TypedStorage, type UseStorageStateOptions, apiEngine, cleanUrlParams, configManager, createLogger, dateUtils, definePlugin, isMockMode, logger, normalizeParams, pluginManager, resolveApiModules, resolvePluginRegistry, serviceRegistry, useApi, usePluginLoader, usePluginManager, useStorageState, version };