@vlian/infrastructure 0.9.10

package/dist/types/managers/SystemConfigManager/types.d.ts

@@ -0,0 +1,435 @@
+/**
+ * SystemConfigManager 类型定义
+ * 完全泛型化的系统配置管理类型
+ */
+/**
+ * @vlian/framework AppEventBus 类型声明
+ */
+export interface AppEventBus {
+    on<T = unknown>(event: string, listener: (data: T, metadata: EventMetadata) => void | Promise<void>, options?: EventListenerOptions): () => void;
+    off<T = unknown>(event: string, listener?: (data: T, metadata: EventMetadata) => void | Promise<void>): void;
+    once<T = unknown>(event: string, listener: (data: T, metadata: EventMetadata) => void | Promise<void>, options?: Omit<EventListenerOptions, 'once'>): () => void;
+    emit<T = unknown>(event: string, data: T, metadata?: Partial<EventMetadata>): void | Promise<void>;
+}
+/**
+ * @vlian/framework Logger 类型声明
+ */
+export interface Logger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+}
+/**
+ * @vlian/framework MonitoringService 类型声明
+ */
+export interface MonitoringService {
+    captureError(error: unknown, context?: Record<string, unknown>): void;
+    trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+    reportPerformance(metrics: Record<string, number>, context?: Record<string, unknown>): void;
+}
+/**
+ * @vlian/framework StorageInstance 类型声明
+ */
+export interface StorageInstance {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * @vlian/framework StateManagerInstance 类型声明
+ */
+export interface StateManagerInstance {
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T): void;
+    remove(key: string): void;
+    subscribe<T>(key: string, callback: (value: T) => void): () => void;
+}
+/**
+ * 存储策略
+ */
+export type StorageStrategy = 'local' | 'session' | 'indexedDB' | 'memory';
+/**
+ * 环境类型
+ */
+export type Environment = 'browser' | 'node' | 'ssr' | 'worker' | 'unknown';
+/**
+ * 系统配置事件类型枚举
+ */
+export declare enum SystemConfigEventType {
+    CONFIG_LOADED = "system_config:loaded",
+    CONFIG_UPDATED = "system_config:updated",
+    CONFIG_REFRESHED = "system_config:refreshed",
+    CONFIG_CACHED = "system_config:cached",
+    CONFIG_CACHE_CLEARED = "system_config:cache:cleared",
+    CONFIG_SYNC_STARTED = "system_config:sync:started",
+    CONFIG_SYNC_COMPLETED = "system_config:sync:completed",
+    CONFIG_SYNC_FAILED = "system_config:sync:failed"
+}
+/**
+ * 事件元数据
+ */
+export interface EventMetadata {
+    timestamp: number;
+    instanceId?: string;
+    [key: string]: unknown;
+}
+/**
+ * 事件监听器选项
+ */
+export interface EventListenerOptions {
+    once?: boolean;
+    priority?: number;
+}
+/**
+ * 配置更新事件数据
+ */
+export interface ConfigUpdatedEventData {
+    key: string;
+    value: unknown;
+    previousValue?: unknown;
+    consistencyLevel?: ConsistencyLevel;
+    timestamp: number;
+}
+/**
+ * 配置批量更新事件数据
+ */
+export interface ConfigBatchUpdatedEventData {
+    configs: Record<string, unknown>;
+    previousConfigs?: Record<string, unknown>;
+    diff?: ConfigDiff<Record<string, unknown>>;
+    timestamp: number;
+}
+/**
+ * 一致性级别类型
+ */
+export type ConsistencyLevel = 'local' | 'synced' | 'eventual';
+/**
+ * 配置差异信息
+ * @template TConfig 配置对象类型
+ */
+export interface ConfigDiff<TConfig = Record<string, unknown>> {
+    /**
+     * 新增的配置项（键名 -> 配置值）
+     */
+    added: Partial<TConfig>;
+    /**
+     * 删除的配置项（键名 -> 配置值）
+     */
+    removed: Partial<TConfig>;
+    /**
+     * 变更的配置项（键名 -> 变更前后的值）
+     */
+    changed: Record<string, {
+        before: unknown;
+        after: unknown;
+    }>;
+}
+/**
+ * 配置类型定义
+ */
+export interface ConfigTypeDefinition {
+    /**
+     * 类型名称
+     */
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'any';
+    /**
+     * 是否必填（默认：false）
+     */
+    required?: boolean;
+    /**
+     * 默认值（可选）
+     */
+    defaultValue?: unknown;
+    /**
+     * 值范围验证（可选）
+     */
+    validator?: (value: unknown) => true | string;
+    /**
+     * 子类型定义（对象或数组类型时使用）
+     */
+    schema?: Record<string, ConfigTypeDefinition> | ConfigTypeDefinition;
+}
+/**
+ * SystemConfigManager 配置选项
+ * @template TConfig 配置对象类型，完全由用户定义
+ */
+export interface SystemConfigOptions<TConfig = Record<string, unknown>> {
+    /**
+     * @vlian/framework Storage 配置（可选）
+     */
+    storage?: {
+        instance?: StorageInstance;
+        strategy?: StorageStrategy;
+    };
+    /**
+     * @vlian/framework StateManager 配置（可选）
+     */
+    stateManager?: {
+        instance?: StateManagerInstance;
+        namespace?: string;
+    };
+    /**
+     * 是否启用日志（默认：false）
+     */
+    enableLogging?: boolean;
+    /**
+     * @vlian/framework Logger 实例（可选）
+     */
+    logger?: Logger;
+    /**
+     * 是否启用监控（默认：false）
+     */
+    enableMonitoring?: boolean;
+    /**
+     * @vlian/framework MonitoringService 实例（可选）
+     */
+    monitoring?: MonitoringService;
+    /**
+     * 是否启用事件（默认：false）
+     */
+    enableEvents?: boolean;
+    /**
+     * @vlian/framework AppEventBus 实例（可选）
+     */
+    eventBus?: AppEventBus;
+    /**
+     * 实例隔离模式（默认：'isolated'）
+     */
+    isolationMode?: 'isolated' | 'shared' | 'hybrid';
+    /**
+     * 配置获取函数（可选）
+     */
+    configFetcher?: (key?: string) => Promise<TConfig | unknown>;
+    /**
+     * 配置更新函数（可选）
+     */
+    configUpdater?: (key: string, value: unknown) => Promise<void>;
+    /**
+     * 批量配置更新函数（可选）
+     */
+    configBatchUpdater?: (configs: Partial<TConfig>) => Promise<void>;
+    /**
+     * 配置数据配置（可选）
+     */
+    configData?: TConfig;
+    /**
+     * 默认配置（可选）
+     */
+    defaultConfig?: Partial<TConfig>;
+    /**
+     * 配置数据存储键名前缀（默认：'system_config:'）
+     */
+    configKeyPrefix?: string;
+    /**
+     * 是否启用持久化缓存（默认：false）
+     */
+    enablePersistentCache?: boolean;
+    /**
+     * 事件命名空间前缀（默认：'system_config:'）
+     */
+    eventNamespace?: string;
+    /**
+     * 配置验证函数（可选）
+     */
+    configValidator?: (key: string, value: unknown) => true | string;
+    /**
+     * 配置类型定义（可选）
+     */
+    configTypes?: Record<string, ConfigTypeDefinition>;
+    /**
+     * 是否启用配置缓存（默认：true）
+     */
+    enableCache?: boolean;
+    /**
+     * 缓存过期时间（毫秒，默认：不过期）
+     */
+    cacheExpiry?: number;
+    /**
+     * 同步策略（默认：'queue'）
+     */
+    syncStrategy?: 'immediate' | 'batch' | 'queue';
+    /**
+     * 批量同步延迟（毫秒，默认：1000）
+     */
+    batchSyncDelay?: number;
+    /**
+     * 同步失败重试配置
+     */
+    syncRetryConfig?: {
+        maxRetries?: number;
+        retryDelay?: number;
+        backoffMultiplier?: number;
+    };
+    /**
+     * 是否启用离线队列（默认：true）
+     */
+    enableOfflineQueue?: boolean;
+    /**
+     * 是否启用详细性能指标（默认：false）
+     */
+    enableDetailedMetrics?: boolean;
+    /**
+     * 并发控制策略（默认：'auto'）
+     */
+    concurrencyStrategy?: 'auto' | 'queue' | 'latest';
+    /**
+     * 队列最大长度（默认：100）
+     */
+    maxQueueSize?: number;
+    /**
+     * 操作超时时间（毫秒，默认：30000）
+     */
+    operationTimeout?: number;
+    /**
+     * 实例 ID（可选）
+     */
+    instanceId?: string;
+    /**
+     * 是否启用开发模式（默认：自动检测）
+     */
+    devMode?: boolean;
+    /**
+     * 是否启用配置验证（默认：true）
+     */
+    validateConfig?: boolean;
+    /**
+     * 是否启用一致性级别管理（默认：true）
+     */
+    enableConsistencyLevel?: boolean;
+    /**
+     * 是否启用配置差异计算（默认：true）
+     */
+    enableDiff?: boolean;
+    /**
+     * 配置项变更检测函数（可选）
+     */
+    configChangeDetector?: (before: unknown, after: unknown) => boolean;
+}
+/**
+ * 获取配置选项（异步）
+ */
+export interface GetConfigOptions {
+    /**
+     * 是否强制刷新（忽略缓存）
+     */
+    force?: boolean;
+    /**
+     * 是否使用持久化缓存
+     */
+    usePersistentCache?: boolean;
+    /**
+     * 并发策略（可选，覆盖全局配置）
+     */
+    concurrencyStrategy?: 'auto' | 'queue' | 'latest';
+}
+/**
+ * 获取配置选项（同步）
+ */
+export interface GetConfigSyncOptions {
+    /**
+     * 如果缓存中不存在，是否返回 null/默认值（默认：true）
+     */
+    returnEmptyIfNotCached?: boolean;
+}
+/**
+ * 更新配置选项
+ */
+export interface UpdateConfigOptions {
+    /**
+     * 是否跳过验证（默认：false）
+     */
+    skipValidation?: boolean;
+    /**
+     * 是否立即同步（默认：根据 syncStrategy 决定）
+     */
+    immediateSync?: boolean;
+    /**
+     * 并发策略（可选，覆盖全局配置）
+     */
+    concurrencyStrategy?: 'auto' | 'queue' | 'latest';
+}
+/**
+ * 验证结果
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: Record<string, string>;
+}
+/**
+ * 批量更新结果
+ */
+export interface BatchUpdateResult {
+    success: boolean;
+    updated: string[];
+    failed: Record<string, string>;
+}
+/**
+ * 健康检查结果
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    checks: {
+        storage?: {
+            available: boolean;
+            error?: string;
+        };
+        stateManager?: {
+            available: boolean;
+            error?: string;
+        };
+        eventBus?: {
+            available: boolean;
+            error?: string;
+        };
+        logger?: {
+            available: boolean;
+            error?: string;
+        };
+        monitoring?: {
+            available: boolean;
+            error?: string;
+        };
+    };
+}
+/**
+ * 性能指标
+ */
+export interface PerformanceMetrics {
+    operation: string;
+    duration: number;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 缓存统计信息
+ */
+export interface CacheStatistics {
+    hits: number;
+    misses: number;
+    size: number;
+    hitRate: number;
+}
+/**
+ * 系统配置错误代码
+ */
+export declare enum SystemConfigErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND",
+    CONCURRENCY_ERROR = "CONCURRENCY_ERROR",
+    SYNC_ERROR = "SYNC_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR"
+}
+/**
+ * 系统配置错误
+ */
+export declare class SystemConfigError extends Error {
+    code: SystemConfigErrorCode;
+    context?: Record<string, unknown> | undefined;
+    originalError?: unknown | undefined;
+    constructor(message: string, code: SystemConfigErrorCode, context?: Record<string, unknown> | undefined, originalError?: unknown | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/managers/SystemConfigManager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/managers/SystemConfigManager/types.ts"],"names":[],"mappings":"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"}

package/dist/types/managers/ThemeManager/ThemeManager.d.ts

@@ -0,0 +1,120 @@
+/**
+ * ThemeManager - 主题管理器
+ *
+ * 完全泛型化的主题管理，支持任意主题配置类型
+ * 基于 @vlian/framework 的 Storage、StateManager 和 AppEventBus
+ */
+import type { ThemeOptions, ThemeConfig, HealthCheckResult, PerformanceMetrics, CacheStatistics, BatchUpdateItem, BatchUpdateResult } from './types';
+import { ThemeEventType } from './types';
+/**
+ * ThemeManager 类
+ */
+export declare class ThemeManager<TThemeConfig = unknown> {
+    private options;
+    private environment;
+    private isProduction;
+    private instanceId;
+    private isolationConfig;
+    private storageManager;
+    private stateManager?;
+    private errorHandler;
+    private loggingManager;
+    private monitoringManager;
+    private performanceMonitor;
+    private eventManager;
+    private cssVariableGenerator;
+    private validator;
+    private configManager;
+    private concurrencyController;
+    private themeCore;
+    private hookManager;
+    /**
+     * 构造函数
+     */
+    constructor(options: ThemeOptions<TThemeConfig>);
+    /**
+     * 初始化模块
+     */
+    private initializeModules;
+    /**
+     * 初始化默认主题
+     */
+    private initializeDefaultTheme;
+    /**
+     * 设置当前主题
+     */
+    setTheme(theme: string): Promise<void>;
+    /**
+     * 获取当前主题
+     */
+    getTheme(): Promise<string | null>;
+    /**
+     * 获取可用主题列表
+     */
+    getAvailableThemes(): string[];
+    /**
+     * 获取主题配置
+     */
+    getThemeConfig(theme?: string): Promise<ThemeConfig<TThemeConfig> | null>;
+    /**
+     * 更新主题配置
+     */
+    updateThemeConfig(theme: string, config: Partial<TThemeConfig>): Promise<TThemeConfig>;
+    /**
+     * 设置主题配置
+     */
+    setThemeConfig(theme: string, config: TThemeConfig): Promise<TThemeConfig>;
+    /**
+     * 生成 CSS 变量字符串
+     */
+    generateCssVariables(theme?: string): Promise<string>;
+    /**
+     * 生成 CSS 变量对象
+     */
+    generateCssVariableObject(theme?: string): Promise<Record<string, string>>;
+    /**
+     * 清除主题配置缓存
+     */
+    clearCache(theme?: string): Promise<void>;
+    /**
+     * 预加载主题配置
+     */
+    preloadThemeConfigs(themes: string[]): Promise<void>;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * 获取性能指标
+     */
+    getPerformanceMetrics(): PerformanceMetrics[];
+    /**
+     * 订阅事件
+     */
+    on<EventData = unknown>(eventType: ThemeEventType, listener: (data: EventData, metadata: any) => void | Promise<void>): () => void;
+    /**
+     * 取消订阅事件
+     */
+    off<EventData = unknown>(eventType: ThemeEventType, listener?: (data: EventData, metadata: any) => void | Promise<void>): void;
+    /**
+     * 一次性订阅事件
+     */
+    once<EventData = unknown>(eventType: ThemeEventType, listener: (data: EventData, metadata: any) => void | Promise<void>): () => void;
+    /**
+     * 批量更新主题配置
+     */
+    batchUpdateThemeConfigs(updates: BatchUpdateItem<TThemeConfig>[]): Promise<BatchUpdateResult<TThemeConfig>>;
+    /**
+     * 获取缓存统计信息
+     */
+    getCacheStatistics(): CacheStatistics;
+    /**
+     * 重置缓存统计信息
+     */
+    resetCacheStatistics(): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=ThemeManager.d.ts.map

package/dist/types/managers/ThemeManager/ThemeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeManager.d.ts","sourceRoot":"","sources":["../../../../src/managers/ThemeManager/ThemeManager.ts"],"names":[],"mappings":"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"}

package/dist/types/managers/ThemeManager/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ThemeManager 常量定义
+ */
+import type { ThemeOptions } from './types';
+/**
+ * 默认配置选项
+ */
+export declare const DEFAULT_OPTIONS: Required<Omit<ThemeOptions<unknown>, 'storage' | 'stateManager' | 'eventBus' | 'logger' | 'monitoring' | 'themeConfigs' | 'defaultThemeConfig' | 'availableThemes' | 'defaultTheme' | 'themeConfigValidator' | 'cssVariableFormatter' | 'instanceId' | 'hooks'>>;
+/**
+ * 生产环境覆盖配置
+ */
+export declare const PRODUCTION_OVERRIDES: Partial<ThemeOptions<unknown>>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/managers/ThemeManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/managers/ThemeManager/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAC/D,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GACjE,cAAc,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,cAAc,GAC1E,sBAAsB,GAAG,sBAAsB,GAAG,YAAY,GAAG,OAAO,CACzE,CA+BA,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAG/D,CAAC"}

package/dist/types/managers/ThemeManager/core/CacheManager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 缓存管理模块
+ * 负责内存缓存管理
+ */
+/**
+ * 缓存管理器
+ */
+export declare class CacheManager<T> {
+    private cache;
+    private defaultTTL?;
+    private maxSize?;
+    private hits;
+    private misses;
+    constructor(options?: {
+        defaultTTL?: number;
+        maxSize?: number;
+    });
+    /**
+     * 获取缓存值
+     */
+    get(key: string): T | null;
+    /**
+     * 设置缓存值
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * 检查是否存在
+     */
+    has(key: string): boolean;
+    /**
+     * 删除缓存
+     */
+    delete(key: string): boolean;
+    /**
+     * 清除所有缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存大小
+     */
+    size(): number;
+    /**
+     * 获取所有键
+     */
+    keys(): string[];
+    /**
+     * 获取最旧的键
+     */
+    private getOldestKey;
+    /**
+     * 获取缓存统计信息
+     */
+    getStatistics(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+        keys: string[];
+    };
+    /**
+     * 重置统计信息
+     */
+    resetStatistics(): void;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/types/managers/ThemeManager/core/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/ThemeManager/core/CacheManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAKD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAkB1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAyB9C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB;IAaD;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB"}