@vlian/framework 1.2.62 → 2.0.1

package/dist/core-bak/types.d.ts

@@ -1,501 +0,0 @@
-import { LogLevel } from '@vlian/logger';
-import type { LangType } from '../library/locale/types';
-import { Container, RootOptions } from 'react-dom/client';
-import { type ComponentType, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';
-import { type InitializationContext } from './initialization';
-import type { StorageOptions } from '../types';
-import type { ThemeConfig } from './app';
-import type { FrameworkError } from '@vlian/utils';
-import type { RouterConfig } from './router/types';
-export type UIProviderConfig = Record<string, unknown>;
-export type UIAppConfig = Record<string, unknown>;
-export type GlobalProviderComponent = ComponentType<PropsWithChildren>;
-export type GlobalProviderLoader = () => Promise<{
-    default: GlobalProviderComponent;
-}>;
-/**
- * 生命周期钩子函数类型
- */
-export type ManagerLifecycle = {
-    /**
-     * 在初始化之前执行
-     */
-    beforeInitialization?: () => Promise<void> | void;
-    /**
-     * 初始化
-     */
-    initialization?: () => Promise<void> | void;
-    /**
-     * 在初始化之后执行
-     *
-     * @param context - 初始化上下文，包含配置、进度、耗时等信息
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   lifecycle: {
-     *     afterInitialization: (context) => {
-     *       console.log('初始化完成', context);
-     *     },
-     *   },
-     * });
-     * ```
-     */
-    afterInitialization?: (context: InitializationContext) => Promise<void> | void;
-};
-/**
- * 启动配置选项
- */
-export interface StartOptions {
-    /**
-     * React 应用的挂载容器
-     *
-     * 用于指定 React 应用渲染的目标 DOM 元素。如果不提供，框架将自动查找页面中
-     * 的根元素（通常为 id="root" 的元素）作为默认容器。
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     *
-     * // 使用默认容器（自动查找 id="root" 的元素）
-     * start({});
-     *
-     * // 指定自定义容器
-     * const container = document.getElementById('app');
-     * start({ container });
-     * ```
-     */
-    container?: Container;
-    /**
-     * React 根节点的配置选项
-     *
-     * 用于配置 React 18+ 的 createRoot 方法的选项，包括：
-     * - `onRecoverableError`: 错误恢复回调函数
-     * - `identifierPrefix`: 用于标识符前缀，用于服务端渲染的 hydration
-     *
-     * 这些选项将传递给 `react-dom/client` 的 `createRoot` 方法。
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     *
-     * start({
-     *   rootOptions: {
-     *     onRecoverableError: (error) => {
-     *       console.error('React 错误恢复:', error);
-     *     },
-     *     identifierPrefix: 'my-app-',
-     *   },
-     * });
-     * ```
-     */
-    rootOptions?: RootOptions;
-    /**
-     * 应用根组件
-     *
-     * 用于指定要渲染的 React 应用根组件。
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     * import App from './App';
-     *
-     * start({
-     *   app: <App />,
-     * });
-     * ```
-     */
-    app?: ReactElement;
-    /**
-     * 是否显示启动页
-     * - 'auto': 自动判断（推荐）
-     * - 'always': 总是显示
-     * - 'never': 从不显示
-     * - 'first-time-only': 仅首次加载显示
-     *
-     * @default 'auto'
-     */
-    showSplashScreen?: 'auto' | 'always' | 'never' | 'first-time-only';
-    /**
-     * 启动页最小显示时间（毫秒）
-     *
-     * 用于避免启动页闪烁，确保用户能看到启动过程。
-     * 如果初始化完成时间小于此值，将等待至最小时间后再隐藏启动页。
-     *
-     * @default 500
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   minSplashScreenTime: 1000, // 至少显示 1 秒
-     * });
-     * ```
-     */
-    minSplashScreenTime?: number;
-    /**
-     * 路由配置
-     *
-     * 配置应用的路由系统，支持内置路由、自定义路由和禁用路由三种模式。
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   router: {
-     *     enabled: true,
-     *     routes: [
-     *       {
-     *         path: '/login',
-     *         page: LoginPage,
-     *       },
-     *       {
-     *         path: '/',
-     *         layout: MainLayout,
-     *         children: [
-     *           {
-     *             path: 'dashboard',
-     *             page: DashboardPage,
-     *             meta: { title: '仪表盘' },
-     *           },
-     *         ],
-     *       },
-     *     ],
-     *   },
-     * });
-     * ```
-     */
-    router?: RouterConfig;
-    /**
-     * 日志级别
-     */
-    loggerLevel?: LogLevel;
-    /**
-     * 生命周期钩子
-     */
-    lifecycle?: ManagerLifecycle;
-    /**
-     * 国际化
-     */
-    locale?: Record<LangType, Record<string, unknown>>;
-    /**
-     * 启动页完成回调
-     * 仅在显示启动页时，启动页完成初始化后调用
-     * 可以在这里执行额外的操作，然后调用 complete() 继续
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   onSplashComplete: (complete, context) => {
-     *     // 执行额外操作
-     *     await doSomething();
-     *     // 完成后继续
-     *     complete();
-     *   },
-     * });
-     * ```
-     */
-    onSplashComplete?: (complete: () => void, context: InitializationContext) => Promise<void> | void;
-    /**
-     * 存储配置
-     */
-    storageOptions?: StorageOptions;
-    /**
-     * IndexedDB 表名
-     */
-    indexedDBTableName?: string;
-    /**
-     * UI Provider 配置（框架无关）
-     * 可由 UI 适配器消费，适配到 antd/shadcn 等实现。
-     */
-    uiProvider?: UIProviderConfig;
-    /**
-     * UI App 基础配置（框架无关）
-     * 可用于通知、弹窗、消息容器等能力的统一注入。
-     */
-    uiApp?: UIAppConfig;
-    /**
-     * 全局 UI 包裹组件懒加载器
-     *
-     * 组件会在 BasicLayout 中统一包裹 children。
-     * 需返回带 default 导出的 React 组件模块。
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   globalProvider: () => import('./components/AntdGlobalProvider'),
-     * });
-     * ```
-     */
-    globalProvider?: GlobalProviderLoader;
-    /**
-     * @deprecated 使用 uiProvider 替代
-     */
-    antd?: Record<string, unknown>;
-    /**
-     * @deprecated 使用 uiApp 替代
-     */
-    antdApp?: Record<string, unknown>;
-    /**
-     * 主题配置
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   theme: {
-     *     mode: 'dark',
-     *     primaryColor: '#1890ff',
-     *   },
-     * });
-     * ```
-     */
-    theme?: ThemeConfig;
-    /**
-     * 运行时安全配置
-     */
-    runtimeSecurity?: import('../utils/runtimeSecurity').RuntimeSecurityOptions;
-    /**
-     * 配置安全选项
-     */
-    configSecurity?: import('../utils/configSecurity').ConfigSecurityOptions;
-    /**
-     * 性能监控配置
-     */
-    performanceMonitor?: import('../utils/performance').PerformanceMonitorConfig;
-    /**
-     * 错误监控配置
-     */
-    errorMonitor?: import('@vlian/monitoring').ErrorMonitorConfig;
-    /**
-     * 分析服务配置
-     */
-    analytics?: import('../utils/analytics').AnalyticsConfig;
-    /**
-     * 状态管理器配置
-     *
-     * 配置框架的状态管理器，支持自定义适配器和作用域设置。
-     * 如果不提供，将使用默认配置创建状态管理器。
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     *
-     * start({
-     *   stateManager: {
-     *     enableRegistry: true,
-     *     defaultScope: 'app',
-     *     devMode: true,
-     *   },
-     * });
-     * ```
-     */
-    stateManager?: import('../state').StateManagerOptions;
-    /**
-     * 事件总线配置
-     *
-     * 配置应用级事件系统，支持事件追踪、性能监控、安全模式等。
-     * 如果不提供，将使用默认配置创建事件总线。
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     *
-     * start({
-     *   eventBus: {
-     *     enableTracking: true,
-     *     maxHistorySize: 200,
-     *     enablePerformanceMonitoring: true,
-     *     namespacePrefix: 'my-app:',
-     *   },
-     * });
-     * ```
-     */
-    eventBus?: {
-        enableTracking?: boolean;
-        maxHistorySize?: number;
-        enableValidation?: boolean;
-        validator?: (event: string, data: unknown) => boolean;
-        enablePerformanceMonitoring?: boolean;
-        namespacePrefix?: string;
-        instanceId?: string;
-        enableSecurityMode?: boolean;
-        allowedSources?: string[];
-    };
-    /**
-     * 自定义启动屏组件
-     *
-     * 如果提供，将使用自定义组件替代默认的启动屏 UI。
-     * 自定义组件将接收初始化进度、当前步骤和初始化状态作为 props。
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     *
-     * const CustomSplashScreen = ({ progress, currentStep, isInitializing }) => {
-     *   return (
-     *     <div>
-     *       <h1>加载中...</h1>
-     *       <div>进度: {progress}%</div>
-     *       <div>步骤: {currentStep}</div>
-     *     </div>
-     *   );
-     * };
-     *
-     * start({
-     *   splashScreen: CustomSplashScreen,
-     * });
-     * ```
-     */
-    splashScreen?: React.ComponentType<SplashScreenCustomProps>;
-    /**
-     * 自定义错误反馈组件
-     *
-     * 如果提供，将使用自定义的错误 UI 替代默认错误 UI。
-     * 自定义组件将接收错误对象和重置函数作为参数。
-     *
-     * @param error - 标准化后的框架错误对象
-     * @param resetError - 重置错误边界的函数，调用后可以尝试重新渲染子组件
-     * @returns 错误 UI 的 React 节点
-     *
-     * @example
-     * ```typescript
-     * import { start } from '@vlian/framework';
-     * start({
-     *   errorFallback: (error, reset) => (
-     *     <div>
-     *       <h2>自定义错误标题</h2>
-     *       <p>{error.message}</p>
-     *       <button onClick={reset}>重试</button>
-     *     </div>
-     *   ),
-     * });
-     * ```
-     */
-    errorFallback?: (error: FrameworkError, resetError: () => void) => ReactNode;
-    /**
-     * 安全配置选项
-     *
-     * 用于配置框架的安全策略，包括 XSS 防护、配置验证等。
-     * 框架默认启用所有安全策略，确保应用安全。
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   security: {
-     *     enableXSSProtection: true, // 默认启用
-     *     validateConfig: true, // 默认启用
-     *     sanitizeUserInput: true, // 默认启用
-     *   },
-     * });
-     * ```
-     */
-    security?: {
-        /**
-         * 是否启用 XSS 防护
-         * @default true
-         */
-        enableXSSProtection?: boolean;
-        /**
-         * 是否验证配置项安全性
-         * @default true
-         */
-        validateConfig?: boolean;
-        /**
-         * 是否清理用户输入
-         * @default true
-         */
-        sanitizeUserInput?: boolean;
-        /**
-         * CSP（内容安全策略）配置
-         */
-        csp?: {
-            defaultSrc?: string[];
-            scriptSrc?: string[];
-            styleSrc?: string[];
-            imgSrc?: string[];
-            connectSrc?: string[];
-            fontSrc?: string[];
-            frameSrc?: string[];
-            allowUnsafeInline?: boolean;
-            allowUnsafeEval?: boolean;
-        };
-        /**
-         * CSRF 防护配置
-         */
-        csrf?: {
-            /**
-             * 是否启用 CSRF 防护
-             * @default true
-             */
-            enabled?: boolean;
-            /**
-             * CSRF Token 获取函数
-             * 如果不提供，框架会自动从 cookie 或 header 中获取
-             */
-            getToken?: () => string | Promise<string>;
-            /**
-             * CSRF Token 验证函数
-             * 如果不提供，框架会使用默认验证逻辑
-             */
-            validateToken?: (token: string) => boolean | Promise<boolean>;
-            /**
-             * CSRF Token 请求头名称
-             * @default 'X-CSRF-Token'
-             */
-            headerName?: string;
-            /**
-             * CSRF Token Cookie 名称
-             * @default 'csrf-token'
-             */
-            cookieName?: string;
-        };
-    };
-    /**
-     * 服务初始化重试配置
-     *
-     * 用于配置服务初始化失败时的重试策略。
-     *
-     * @example
-     * ```typescript
-     * start({
-     *   serviceRetry: {
-     *     maxRetries: 3,
-     *     retryDelay: 1000,
-     *     exponentialBackoff: true,
-     *   },
-     * });
-     * ```
-     */
-    serviceRetry?: {
-        /**
-         * 最大重试次数
-         * @default 3
-         */
-        maxRetries?: number;
-        /**
-         * 重试延迟（毫秒）
-         * @default 1000
-         */
-        retryDelay?: number;
-        /**
-         * 是否启用指数退避
-         * @default true
-         */
-        exponentialBackoff?: boolean;
-    };
-}
-/**
- * 自定义启动屏组件的 Props
- */
-export interface SplashScreenCustomProps {
-    /**
-     * 初始化进度（0-100）
-     */
-    progress: number;
-    /**
-     * 当前步骤描述
-     */
-    currentStep: string;
-    /**
-     * 是否正在初始化
-     */
-    isInitializing: boolean;
-}

package/dist/core-bak/types.js

@@ -1 +0,0 @@
-export{};

package/dist/index.umd.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./index"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/index.umd.d.ts

@@ -1,7 +0,0 @@
-/**
- * UMD 入口文件
- *
- * 此文件用于构建 UMD 格式的包，在浏览器环境中会将框架暴露为 window.vlianFramework
- * Rollup 会自动处理 UMD 格式的导出，此文件只需要重新导出所有内容
- */
-export * from './index';

package/dist/library/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./locale/index"),exports);_export_star(require("./storage/index"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/library/index.d.ts

@@ -1,2 +0,0 @@
-export * from './locale/index';
-export * from './storage/index';

package/dist/library/index.js

@@ -1 +0,0 @@
-export*from"./locale/index";export*from"./storage/index";

package/dist/library/locale/index.cjs

@@ -1 +0,0 @@
-"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 $t(){return $t},get reactI18nextInstance(){return reactI18nextInstance},get setLang(){return setLang},get setupI18n(){return setupI18n}});const _i18next=/*#__PURE__*/_interop_require_default(require("i18next"));const _reacti18next=require("react-i18next");function _interop_require_default(obj){return obj&&obj.__esModule?obj:{default:obj}}const reactI18nextInstance=_i18next.default.use(_reacti18next.initReactI18next);async function setupI18n(options,callback){await reactI18nextInstance.init(options,callback)}const $t=_i18next.default.t;async function setLang(locale,callback){await _i18next.default.changeLanguage(locale,callback)}

package/dist/library/locale/index.d.ts

@@ -1,6 +0,0 @@
-import type { Callback, InitOptions } from "i18next";
-export declare const reactI18nextInstance: import("i18next").i18n;
-/** Setup plugin i18n */
-export declare function setupI18n<T = unknown>(options: InitOptions<T>, callback?: Callback): Promise<void>;
-export declare const $t: import("i18next").TFunction<["translation", ...string[]], undefined>;
-export declare function setLang(locale: string, callback?: Callback): Promise<void>;

package/dist/library/locale/index.js

@@ -1 +0,0 @@
-import i18n from"i18next";import{initReactI18next}from"react-i18next";export const reactI18nextInstance=i18n.use(initReactI18next);export async function setupI18n(options,callback){await reactI18nextInstance.init(options,callback)}export const $t=i18n.t;export async function setLang(locale,callback){await i18n.changeLanguage(locale,callback)}

package/dist/library/locale/langs/en-us/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"default",{enumerable:true,get:function(){return _default}});const local={notfound:{home:"Back to Home"},defaultApp:{title:"Welcome to Secra Framework",description:"Framework has been successfully started! Please provide your app component to get started.",quickStart:{title:"Quick Start",description:"Provide the app option in your startup configuration to render your application:",code:"import { start } from '@vlian/framework';\nimport App from './App';\n\nstart({\n  app: <App />,\n});"},nextSteps:{title:"Next Steps",step1:"Create your application root component (e.g., App.tsx)",step2:"Pass the app option in your startup configuration",step3:"Start developing your application features"},footer:"Secra Framework - Modern Low-Code Frontend Application Framework"}};const _default=local;

package/dist/library/locale/langs/en-us/index.d.ts

@@ -1,3 +0,0 @@
-import { Schema } from "../../types";
-declare const local: Schema['translation'];
-export default local;

package/dist/library/locale/langs/en-us/index.js

@@ -1 +0,0 @@
-const local={notfound:{home:"Back to Home"},defaultApp:{title:"Welcome to Secra Framework",description:"Framework has been successfully started! Please provide your app component to get started.",quickStart:{title:"Quick Start",description:"Provide the app option in your startup configuration to render your application:",code:"import { start } from '@vlian/framework';\nimport App from './App';\n\nstart({\n  app: <App />,\n});"},nextSteps:{title:"Next Steps",step1:"Create your application root component (e.g., App.tsx)",step2:"Pass the app option in your startup configuration",step3:"Start developing your application features"},footer:"Secra Framework - Modern Low-Code Frontend Application Framework"}};export default local;

package/dist/library/locale/langs/zh-cn/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"default",{enumerable:true,get:function(){return _default}});const local={notfound:{home:"回到首页"},defaultApp:{title:"欢迎使用 Secra Framework",description:"框架已成功启动！请提供您的应用组件以开始使用。",quickStart:{title:"快速开始",description:"在启动配置中提供 app 选项来渲染您的应用：",code:"import { start } from '@vlian/framework';\nimport App from './App';\n\nstart({\n  app: <App />,\n});"},nextSteps:{title:"下一步",step1:"创建您的应用根组件（如 App.tsx）",step2:"在启动配置中传入 app 选项",step3:"开始开发您的应用功能"},footer:"Secra Framework - 现代化的低代码前端应用框架"}};const _default=local;

package/dist/library/locale/langs/zh-cn/index.d.ts

@@ -1,3 +0,0 @@
-import { Schema } from "../../types";
-declare const local: Schema['translation'];
-export default local;

package/dist/library/locale/langs/zh-cn/index.js

@@ -1 +0,0 @@
-const local={notfound:{home:"回到首页"},defaultApp:{title:"欢迎使用 Secra Framework",description:"框架已成功启动！请提供您的应用组件以开始使用。",quickStart:{title:"快速开始",description:"在启动配置中提供 app 选项来渲染您的应用：",code:"import { start } from '@vlian/framework';\nimport App from './App';\n\nstart({\n  app: <App />,\n});"},nextSteps:{title:"下一步",step1:"创建您的应用根组件（如 App.tsx）",step2:"在启动配置中传入 app 选项",step3:"开始开发您的应用功能"},footer:"Secra Framework - 现代化的低代码前端应用框架"}};export default local;

package/dist/library/locale/types.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});

package/dist/library/locale/types.d.ts

@@ -1,38 +0,0 @@
-export type LangType = 'en-US' | 'zh-CN';
-export type Schema = {
-    translation: {
-        notfound: {
-            home: string;
-        };
-        defaultApp: {
-            title: string;
-            description: string;
-            quickStart: {
-                title: string;
-                description: string;
-                code: string;
-            };
-            nextSteps: {
-                title: string;
-                step1: string;
-                step2: string;
-                step3: string;
-            };
-            footer: string;
-        };
-    };
-};
-export type GetI18nKey<T extends Record<string, unknown>, K extends keyof T = keyof T> = K extends string ? T[K] extends Record<string, unknown> ? `${K}.${GetI18nKey<T[K]>}` : K : never;
-export type I18nKey = GetI18nKey<Schema['translation']>;
-export type TranslateOptions<Locales extends string> = import('react-i18next').TranslationProps<Locales>;
-export interface $T {
-    (key: I18nKey): string;
-    (key: I18nKey, plural: number, options?: TranslateOptions<LangType>): string;
-    (key: I18nKey, defaultMsg: string, options?: TranslateOptions<I18nKey>): string;
-    (key: I18nKey, list: unknown[], options?: TranslateOptions<I18nKey>): string;
-    (key: I18nKey, list: unknown[], plural: number): string;
-    (key: I18nKey, list: unknown[], defaultMsg: string): string;
-    (key: I18nKey, named: Record<string, unknown>, options?: TranslateOptions<LangType>): string;
-    (key: I18nKey, named: Record<string, unknown>, plural: number): string;
-    (key: I18nKey, named: Record<string, unknown>, defaultMsg: string): string;
-}

package/dist/library/locale/types.js

@@ -1 +0,0 @@
-export{};

package/dist/library/storage/cache.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"MultiLevelCache",{enumerable:true,get:function(){return MultiLevelCache}});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}let MultiLevelCache=class MultiLevelCache{moveToHead(node){const nodeAsUnknown=node;if(nodeAsUnknown===this.head){return}if(node.prev){node.prev.next=node.next}if(node.next){node.next.prev=node.prev}if(nodeAsUnknown===this.tail){this.tail=node.prev}node.prev=null;node.next=this.head;if(this.head){this.head.prev=nodeAsUnknown}this.head=nodeAsUnknown;if(!this.tail){this.tail=nodeAsUnknown}}removeTail(){if(!this.tail){return}const key=this.tail.key;this.memoryCache.delete(key);if(this.tail.prev){this.tail.prev.next=null;this.tail=this.tail.prev}else{this.head=null;this.tail=null}}async get(key){const node=this.memoryCache.get(key);if(node){const item=node.value;if(item.expiresAt>Date.now()){this.moveToHead(node);return item.data}else{this.memoryCache.delete(key);if(node===this.head){this.head=node.next}if(node===this.tail){this.tail=node.prev}if(node.prev){node.prev.next=node.next}if(node.next){node.next.prev=node.prev}}}try{const stored=await this.storage.get(key);if(stored){const item=JSON.parse(stored);if(item.expiresAt>Date.now()){this.setInMemory(key,item);return item.data}else{await this.storage.remove(key)}}}catch(error){}return null}setInMemory(key,item){let node=this.memoryCache.get(key);if(node){node.value=item;this.moveToHead(node)}else{node={key,value:item,prev:null,next:this.head};if(this.head){this.head.prev=node}this.head=node;if(!this.tail){this.tail=node}this.memoryCache.set(key,node);if(this.memoryCache.size>this.config.maxSize){this.removeTail()}}}async set(key,data,ttl){const expiresAt=Date.now()+(ttl||this.config.defaultTTL);const item={data,expiresAt,createdAt:Date.now()};this.setInMemory(key,item);try{await this.storage.set(key,item)}catch(error){}}async delete(key){const node=this.memoryCache.get(key);if(node){if(node.prev){node.prev.next=node.next}if(node.next){node.next.prev=node.prev}if(node===this.head){this.head=node.next}if(node===this.tail){this.tail=node.prev}this.memoryCache.delete(key)}try{await this.storage.remove(key)}catch(error){}}async clear(){this.memoryCache.clear()}async cleanup(){const now=Date.now();const keysToDelete=[];const nodesToRemove=[];for(const[key,node]of this.memoryCache.entries()){if(node.value.expiresAt<=now){keysToDelete.push(key);nodesToRemove.push(node)}}if(keysToDelete.length>0){for(const node of nodesToRemove){if(node.prev){node.prev.next=node.next}if(node.next){node.next.prev=node.prev}if(node===this.head){this.head=node.next}if(node===this.tail){this.tail=node.prev}}keysToDelete.forEach(key=>this.memoryCache.delete(key))}}constructor(storage,config={}){_define_property(this,"memoryCache",new Map);_define_property(this,"storage",void 0);_define_property(this,"config",void 0);_define_property(this,"head",null);_define_property(this,"tail",null);this.storage=storage;this.config={defaultTTL:config.defaultTTL??24*60*60*1e3,maxSize:config.maxSize??100}}};

package/dist/library/storage/cache.d.ts

@@ -1,57 +0,0 @@
-import type { StorageInstance } from '@vlian/utils';
-/**
- * 缓存配置
- */
-export interface CacheConfig {
-    /**
-     * 默认过期时间（毫秒）
-     */
-    defaultTTL?: number;
-    /**
-     * 最大缓存项数量
-     */
-    maxSize?: number;
-}
-/**
- * 多级缓存管理器（使用 LRU 策略）
- */
-export declare class MultiLevelCache {
-    private memoryCache;
-    private storage;
-    private config;
-    private head;
-    private tail;
-    constructor(storage: StorageInstance, config?: CacheConfig);
-    /**
-     * 将节点移到链表头部（最近使用）
-     */
-    private moveToHead;
-    /**
-     * 移除尾部节点（最久未使用）
-     */
-    private removeTail;
-    /**
-     * 获取缓存
-     */
-    get<T>(key: string): Promise<T | null>;
-    /**
-     * 在内存中设置缓存（LRU）
-     */
-    private setInMemory;
-    /**
-     * 设置缓存
-     */
-    set<T>(key: string, data: T, ttl?: number): Promise<void>;
-    /**
-     * 删除缓存
-     */
-    delete(key: string): Promise<void>;
-    /**
-     * 清空缓存
-     */
-    clear(): Promise<void>;
-    /**
-     * 清理过期项（优化版本：批量删除，减少 DOM 操作）
-     */
-    cleanup(): Promise<void>;
-}