@go-wind/admin-react 0.0.0-stage → 0.1.0

package/dist/preferences/types/preferences-root.d.ts

@@ -0,0 +1,48 @@
+import type { AppPreferences, BreadcrumbPreferences, CopyrightPreferences, FooterPreferences, HeaderPreferences, LogoPreferences, NavigationPreferences, ShortcutKeyPreferences, SidebarPreferences, TabbarPreferences, ThemePreferences, TransitionPreferences, WidgetPreferences } from "./app";
+/**
+ * 偏好设置总接口
+ */
+export interface Preferences {
+    /** 全局配置 */
+    app: AppPreferences;
+    /** 顶栏配置 */
+    breadcrumb: BreadcrumbPreferences;
+    /** 版权配置 */
+    copyright: CopyrightPreferences;
+    /** 底栏配置 */
+    footer: FooterPreferences;
+    /** 面包屑配置 */
+    header: HeaderPreferences;
+    /** logo配置 */
+    logo: LogoPreferences;
+    /** 导航配置 */
+    navigation: NavigationPreferences;
+    /** 快捷键配置 */
+    shortcutKeys: ShortcutKeyPreferences;
+    /** 侧边栏配置 */
+    sidebar: SidebarPreferences;
+    /** 标签页配置 */
+    tabbar: TabbarPreferences;
+    /** 主题配置 */
+    theme: ThemePreferences;
+    /** 动画配置 */
+    transition: TransitionPreferences;
+    /** 功能配置 */
+    widget: WidgetPreferences;
+}
+/**
+ * 偏好设置接口
+ */
+export type PreferencesKeys = keyof Preferences;
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * 偏好设置初始化参数
+ */
+export interface InitialOptions {
+    /** 命名空间 */
+    namespace: string;
+    /** 覆盖默认偏好设置 */
+    overrides?: DeepPartial<Preferences>;
+}

package/dist/preferences/types/theme.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 主题模式
+ * auto 自动
+ * dark 暗色
+ * light 亮色
+ */
+export type ThemeModeType = "auto" | "dark" | "light";
+/**
+ * 内置主题名称
+ * custom 自定义
+ * deep-blue 深蓝
+ * deep-green 深绿
+ * default 默认
+ * gray 灰色
+ * green 绿色
+ * neutral 中性色
+ * orange 橙色
+ * pink 粉色
+ * red 红色
+ * rose 玫红色
+ * sky-blue 天蓝色
+ * slate 石板灰色
+ * stone 石灰色
+ * violet 紫罗兰色
+ * yellow 黄色
+ * zinc 锌色
+ * (Record<never, never> & string) 自定义主题
+ */
+export type BuiltinThemeType = "custom" | "deep-blue" | "deep-green" | "default" | "gray" | "green" | "neutral" | "orange" | "pink" | "red" | "rose" | "sky-blue" | "slate" | "stone" | "violet" | "yellow" | "zinc" | (Record<never, never> & string);

package/dist/preferences/utils/diff.d.ts

@@ -0,0 +1,7 @@
+import type { DeepPartial } from "../types";
+/**
+ * 深度比较 initial 与 current，产出「与出厂默认的增量」对象（只含被改过的叶子值）。
+ * 与 vben 的 diffPreference 同语义：复制偏好设置时导出的是增量 overrides，
+ * 不是全量快照（对齐 framework/effects/layouts/widgets/preferences/preferences-drawer.vue 的 handleCopy）。
+ */
+export declare function diffDeep<T extends object>(initial: T, current: DeepPartial<T>): DeepPartial<T>;

package/dist/preferences/utils/merge.d.ts

@@ -0,0 +1,9 @@
+import type { DeepPartial } from "../types";
+/**
+ * 深度合并对象
+ */
+export declare function mergeDeep<T extends object>(target: T, source: DeepPartial<T>): T;
+/**
+ * 判断是否为普通对象
+ */
+export declare function isPlainObject(value: any): value is Record<string, any>;

package/dist/query-client.d.ts

@@ -0,0 +1,9 @@
+import { QueryClient } from '@tanstack/react-query';
+export declare const queryClient: QueryClient;
+/**
+ * 宿主在 bootstrap 阶段调整 query 行为。
+ * @param options.isDev 开发环境姿态：任何查询错误重试 3 次（默认仅网络错误重试 1 次）
+ */
+export declare function configureQueryClient(options?: {
+    isDev?: boolean;
+}): void;

package/dist/rolldown-runtime-BbCBk-LD.js

@@ -0,0 +1,19 @@
+// \0rolldown/runtime.js
+var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || (e((t = { exports: {} }).exports, t, t.exports), e = null), t.exports), s = (e, n) => {
+	let r = {};
+	for (var i in e) t(r, i, {
+		get: e[i],
+		enumerable: !0
+	});
+	return n || t(r, Symbol.toStringTag, { value: "Module" }), r;
+}, c = (e, i, o, s) => {
+	if (i && typeof i == "object" || typeof i == "function") for (var c = r(i), l = 0, u = c.length, d; l < u; l++) d = c[l], !a.call(e, d) && d !== o && t(e, d, {
+		get: ((e) => i[e]).bind(null, d),
+		enumerable: !(s = n(i, d)) || s.enumerable
+	});
+	return e;
+}, l = (e, t, n) => (c(e, t, "default"), n && c(n, t, "default")), u = (n, r, o) => (o = n == null ? {} : e(i(n)), c(r || !n || !n.__esModule || !a.call(n, "default") ? t(o, "default", {
+	value: n,
+	enumerable: !0
+}) : o, n));
+export { u as i, s as n, l as r, o as t };

package/dist/router/factory.d.ts

@@ -0,0 +1,7 @@
+import { createBrowserRouter } from 'react-router-dom';
+import type { GenerateMenuAndRoutesOptions, AppRouteObject } from './types';
+import type { AccessModeType } from '../preferences';
+export declare const createAccessibleRouter: (mode: AccessModeType, options: GenerateMenuAndRoutesOptions) => Promise<{
+    router: ReturnType<typeof createBrowserRouter>;
+    routes: AppRouteObject[];
+}>;

package/dist/router/generators/generate-menus.d.ts

@@ -0,0 +1,13 @@
+import type { AppMenu, AppRouteObject } from "../../router/types";
+/**
+ * 根据路由配置生成菜单列表
+ * @param routes - 路由配置数组（AppRouteObject[]，含 meta）
+ * @param getAllRoutes - 获取完整路由树的函数（用于解析动态路径）
+ * @returns 菜单树数组（AppMenu[]），可直接传给 ProLayout
+ */
+export declare function generateMenus(routes: AppRouteObject[], getAllRoutes: () => AppRouteObject[]): Promise<AppMenu[]>;
+/**
+ * 工具：判断菜单是否应该显示（权限 + 配置）
+ * 可用于二次过滤
+ */
+export declare const shouldShowMenu: (menu: AppMenu, permissions: string[]) => boolean;

package/dist/router/generators/generate-routes-backend.d.ts

@@ -0,0 +1,12 @@
+import type { AppRouteObject, GenerateRoutesOptions } from "../../router/types";
+/**
+ * 动态生成路由 - 后端方式（React 版本）
+ * @param options - 配置选项
+ * @returns 转换后的路由树（AppRouteObject[]），可直接传入 createBrowserRouter
+ */
+export declare function generateRoutesByBackend(options: GenerateRoutesOptions): Promise<AppRouteObject[]>;
+/**
+ * 标准化视图路径（适配 React 目录结构）
+ * @param path - 后端返回的组件路径，如 "./views/system/user" 或 "/views/dashboard"
+ */
+export declare function normalizeViewPath(path: string): string;

package/dist/router/generators/generate-routes-frontend.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { AppRouteObject } from "../../router/types";
+/**
+ * 动态生成路由 - 前端权限过滤方式
+ * @param routes - 静态路由表（AppRouteObject[]，含 meta）
+ * @param permissions - 用户权限码列表
+ * @param forbiddenElement - 无权限时渲染的元素（<Forbidden />）
+ */
+export declare function generateRoutesByFrontend(routes: AppRouteObject[], permissions: string[], forbiddenElement?: ReactNode): Promise<AppRouteObject[]>;
+/**
+ * 判断路由是否有权限访问
+ * @param route - 路由对象
+ * @param permissions - 用户权限码列表
+ * @returns 是否允许访问
+ */
+declare function hasPermission(route: AppRouteObject, permissions: string[]): boolean;
+export { hasPermission };

package/dist/router/generators/index.d.ts

@@ -0,0 +1,3 @@
+export * from './generate-routes-backend';
+export * from './generate-routes-frontend';
+export * from './generate-menus';

package/dist/router/index.d.ts

@@ -0,0 +1,5 @@
+export * from './factory';
+export * from './generators';
+export * from './routes-context';
+export * from './types';
+export * from './utils';

package/dist/router/routes-context.d.ts

@@ -0,0 +1,8 @@
+import type { AppRouteObject } from "./types";
+/**
+ * 当前实际挂载的路由树（createAccessibleRouter 的产物）：
+ * 后端模式=后端下发路由；前端模式=权限过滤后的静态路由。
+ * 侧栏等消费方必须镜像此树保证"菜单即路由"——后端模式下若回退静态全量表，
+ * 会出现未授权菜单可见、点击 404 的越权观感。
+ */
+export declare const AccessibleRoutesContext: import("react").Context<AppRouteObject[] | null>;

package/dist/router/types/index.d.ts

@@ -0,0 +1,207 @@
+import type { RouteObject } from "react-router-dom";
+import React, { type ComponentType } from "react";
+import type { ReactNode } from "react";
+export type IconName = string;
+export type IconType = IconName | ComponentType<{
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'destructive' | string;
+export type BadgeType = 'dot' | 'normal';
+export type { AccessModeType } from '../../preferences/types/layout';
+/**
+ * 后端返回的路由对象（组件路径为字符串）
+ */
+export interface BackendRoute extends Omit<AppRouteObject, 'element' | 'children'> {
+    component?: string;
+    children?: BackendRoute[];
+}
+/**
+ * generateRoutesByBackend 的选项。只声明后端生成器实际消费的字段——
+ * 此前这里的 staticRoutes/mode 等字段从未被消费，形成"传了也没用"的误导性签名。
+ */
+export interface GenerateRoutesOptions {
+    /** 从后端拉取菜单路由树（component 为字符串路径） */
+    fetchMenuListAsync?: () => Promise<BackendRoute[]>;
+    /** 布局组件映射（component 字符串 → React 组件） */
+    layoutMap?: ComponentRecord;
+    /** 页面组件映射（view 路径 → React 组件） */
+    pageMap?: ComponentRecord;
+}
+export interface GenerateRoutesResult {
+    routes: AppRouteObject[];
+    menus: AppMenu[];
+}
+export interface RouteMeta {
+    title?: string;
+    icon?: IconType;
+    activeIcon?: IconType;
+    authority?: string[];
+    ignoreAccess?: boolean;
+    hideInMenu?: boolean;
+    hideInTab?: boolean;
+    hideInBreadcrumb?: boolean;
+    hideChildrenInMenu?: boolean;
+    menuVisibleWithForbidden?: boolean;
+    activePath?: string;
+    affixTab?: boolean;
+    affixTabOrder?: number;
+    keepAlive?: boolean;
+    loaded?: boolean;
+    link?: string;
+    iframeSrc?: string;
+    openInNewWindow?: boolean;
+    order?: number;
+    query?: Record<string, any>;
+    maxNumOfOpenTab?: number;
+    badge?: string;
+    badgeType?: 'dot' | 'normal';
+    badgeVariants?: BadgeVariant;
+    [key: string]: any;
+}
+export interface AppRoute extends Omit<RouteObject, 'meta' | 'children' | 'element'> {
+    name: string;
+    path: string;
+    redirect?: string;
+    index?: boolean;
+    meta?: RouteMeta;
+    children?: AppRoute[];
+    element?: ReactNode;
+    componentPath?: string;
+    parent?: string;
+    parents?: string[];
+}
+/**
+ * AppRouteObject = RouteObject + meta + 业务字段
+ * 用于替代原生的 RouteObject，携带业务元数据
+ */
+export interface AppRouteObject extends Omit<RouteObject, 'children'> {
+    name?: string;
+    path?: string;
+    meta?: RouteMeta;
+    redirect?: string;
+    icon?: IconType;
+    activeIcon?: IconType;
+    disabled?: boolean;
+    show?: boolean;
+    order?: number;
+    children?: AppRouteObject[];
+    parent?: string;
+    parents?: string[];
+    componentPath?: string;
+    element?: ReactNode;
+}
+export interface AppMenuBadge {
+    badge?: string;
+    badgeType?: BadgeType;
+    badgeVariants?: BadgeVariant;
+}
+export interface AppMenu extends AppMenuBadge {
+    name: string;
+    path: string;
+    label: string;
+    icon?: IconType;
+    activeIcon?: IconType;
+    order?: number;
+    badge?: string;
+    badgeType?: 'dot' | 'normal';
+    badgeVariants?: BadgeVariant;
+    disabled?: boolean;
+    show?: boolean;
+    parent?: string;
+    parents?: string[];
+    children?: AppMenu[];
+    authority?: string[];
+    menuVisibleWithForbidden?: boolean;
+    meta?: RouteMeta;
+    [key: string]: any;
+}
+export type ComponentRecordType = Record<string, ComponentType<any>>;
+export type ComponentRecord = Record<string, ComponentType<any>>;
+export interface GenerateMenuAndRoutesOptions {
+    fetchMenuListAsync?: () => Promise<BackendRoute[]>;
+    forbiddenElement?: React.ReactNode;
+    layoutMap?: ComponentRecordType;
+    pageMap?: ComponentRecordType;
+    permissions?: string[];
+    roles?: string[];
+    routes: AppRouteObject[];
+    autoInjectRedirect?: boolean;
+    autoSort?: boolean;
+    /** 登录落地兜底路径（宿主注入，如 ROUTES.DEFAULT_HOME）；后端模式下无可见菜单时使用 */
+    defaultHomePath?: string;
+}
+/**
+ * 路由模块的默认导出类型
+ * 每个动态导入的路由文件应默认导出 AppRouteObject[]
+ */
+export interface RouteModuleType {
+    default: AppRouteObject[];
+}
+/**
+ * Vite glob 导入的动态模块类型
+ * 兼容 .tsx/.ts 文件 + 默认导出
+ */
+export type RouteModuleRecord = Record<string, RouteModuleType | AppRouteObject[] | (() => Promise<RouteModuleType>)>;
+export declare const isAppRoute: (route: any) => route is AppRouteObject;
+export interface MenuRecordBadgeRaw {
+    /**
+     * 徽标
+     */
+    badge?: string;
+    /**
+     * 徽标类型
+     */
+    badgeType?: "dot" | "normal";
+    /**
+     * 徽标颜色
+     */
+    badgeVariants?: "destructive" | "primary" | string;
+}
+/**
+ * 菜单原始对象
+ */
+export interface MenuRecordRaw extends MenuRecordBadgeRaw {
+    /**
+     * 激活时的图标名
+     */
+    activeIcon?: string;
+    /**
+     * 子菜单
+     */
+    children?: MenuRecordRaw[];
+    /**
+     * 是否禁用菜单
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 图标名
+     */
+    icon?: IconType;
+    /**
+     * 菜单名
+     */
+    name: string;
+    /**
+     * 排序号
+     */
+    order?: number;
+    /**
+     * 父级路径
+     */
+    parent?: string;
+    /**
+     * 所有父级路径
+     */
+    parents?: string[];
+    /**
+     * 菜单路径，唯一，可当作key
+     */
+    path: string;
+    /**
+     * 是否显示菜单
+     * @default true
+     */
+    show?: boolean;
+}

package/dist/router/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './inject-redirect';
+export * from './lazy';
+export * from './loader';
+export * from './menu';
+export * from './merge-route-modules';
+export * from './reset-routes';
+export * from './sort-routes';
+export * from './transform-meta-to-handle';

package/dist/router/utils/inject-redirect.d.ts

@@ -0,0 +1,6 @@
+import type { AppRoute } from "../../router/types";
+/**
+ * 自动注入重定向
+ * 规则：父路由有子路由且未配置 redirect 时，指向第一个子路由
+ */
+export declare const injectRedirects: (routes: AppRoute[]) => AppRoute[];

package/dist/router/utils/lazy.d.ts

@@ -0,0 +1,11 @@
+import { type ComponentType } from 'react';
+/**
+ * 创建懒加载路由元素
+ * 自动包裹 Suspense + Spin fallback
+ *
+ * @param loader Vite 动态导入函数，如 () => import('@/pages/dashboard')
+ * @returns 可直接赋值给 route.element 的 ReactNode
+ */
+export declare const createLazyRoute: (loader: () => Promise<{
+    default: ComponentType<any>;
+}>) => import("react").JSX.Element;

package/dist/router/utils/loader.d.ts

@@ -0,0 +1,14 @@
+import type { AppRouteObject } from '../types';
+/**
+ * 展平模块导出（兼容 default / 具名导出）
+ * 纯函数，无副作用，可单元测试
+ */
+export declare const extractRoutes: (module: any) => AppRouteObject[];
+/**
+ * 过滤无效路由（开发环境调试用）
+ */
+export declare const filterValidRoutes: (routes: AppRouteObject[]) => AppRouteObject[];
+/**
+ * 根据权限过滤路由树
+ */
+export declare const filterRoutesByPermission: (routes: AppRouteObject[], permissions: string[]) => AppRouteObject[];

package/dist/router/utils/menu.d.ts

@@ -0,0 +1,5 @@
+import type { ProLayoutProps } from '@ant-design/pro-components';
+import type { AppRouteObject } from '../../router/types';
+type MenuRoute = AppRouteObject;
+export declare const transformRoutesToMenu: (routes: MenuRoute[], permissions: string[], parentPath?: string) => NonNullable<ProLayoutProps["route"]>["routes"];
+export {};

package/dist/router/utils/merge-route-modules.d.ts

@@ -0,0 +1,23 @@
+import type { AppRouteObject, RouteModuleRecord, RouteModuleType } from "../../router";
+/**
+ * 合并动态路由模块的默认导出
+ *
+ * @param routeModules - Vite import.meta.glob 返回的模块对象
+ * @param options - 可选配置
+ * @returns 合并后的路由配置数组（AppRouteObject[]）
+ *
+ * @example
+ *
+ */
+export declare function mergeRouteModules(routeModules: RouteModuleRecord, options?: {
+    /** 是否过滤空模块 */
+    filterEmpty?: boolean;
+    /** 是否按路径排序 */
+    sortByPath?: boolean;
+}): AppRouteObject[];
+/**
+ * 异步合并动态路由模块（用于 lazy 加载）
+ * @param routeModules - Vite import.meta.glob 返回的异步模块对象
+ * @returns Promise<AppRouteObject[]>
+ */
+export declare function mergeRouteModulesAsync(routeModules: Record<string, () => Promise<RouteModuleType | AppRouteObject[]>>): Promise<AppRouteObject[]>;

package/dist/router/utils/reset-routes.d.ts

@@ -0,0 +1,18 @@
+import type { AppRouteObject } from "../../router/types";
+/**
+ * 重置可访问路由（保留白名单）
+ *
+ * ⚠️ React Router v6+ 不支持运行时修改路由，
+ * 此函数返回过滤后的路由树，需配合 createBrowserRouter 重新创建 router
+ *
+ * @param allRoutes - 当前完整路由树（含动态路由）
+ * @param staticRouteNames - 静态路由白名单（保留这些路由）
+ * @returns 过滤后的路由树（仅含白名单路由）
+ */
+export declare function resetAccessibleRoutes(allRoutes: AppRouteObject[], staticRouteNames: string[]): AppRouteObject[];
+/**
+ * 提取路由树中所有有效的 name（用于生成白名单）
+ * @param routes - 路由树
+ * @returns 有效的路由 name 数组
+ */
+export declare function extractRouteNames(routes: AppRouteObject[]): string[];

package/dist/router/utils/sort-routes.d.ts

@@ -0,0 +1,5 @@
+import type { AppRoute } from "../../router/types";
+/**
+ * 递归排序路由树（按 meta.order 升序）
+ */
+export declare const sortRoutes: (routes: AppRoute[]) => AppRoute[];

package/dist/router/utils/transform-meta-to-handle.d.ts

@@ -0,0 +1,11 @@
+import type { AppRouteObject, RouteMeta } from '../types';
+import type { RouteHandle } from '../../types';
+/**
+ * 将 meta 转换为 React Router 的 handle
+ * 这样 useMatches() 就能获取到路由元数据
+ */
+export declare function transformMetaToHandle(meta?: RouteMeta): RouteHandle | undefined;
+/**
+ * 递归转换路由配置，将 meta 映射到 handle
+ */
+export declare function transformRoutesWithHandle(routes: AppRouteObject[]): AppRouteObject[];

package/dist/storage/index.d.ts

@@ -0,0 +1,2 @@
+export { StorageManager } from "./storage.class";
+export * from "./storage.types";

package/dist/storage/storage.class.d.ts

@@ -0,0 +1,125 @@
+import type { BatchGetOptions, BatchProgressCallback, BatchResult, BatchSetItem, IStorageCache, StorageManagerOptions, StorageMetrics, SyncMessage } from "./storage.types";
+declare class StorageManager implements IStorageCache {
+    private readonly prefix;
+    private readonly storage;
+    private readonly options;
+    private readonly defaultTTL?;
+    private readonly tabId;
+    private channel;
+    private metrics;
+    private metricsDebounceTimer;
+    private readonly onMetricsCallback?;
+    private onSyncCallback?;
+    constructor(options?: StorageManagerOptions);
+    /**
+     * 获取完整存储键（安全添加前缀）
+     */
+    private getFullKey;
+    private getMetaKey;
+    private readMeta;
+    private writeMeta;
+    /**
+     * 访问时更新元数据（访问次数和最后访问时间）
+     */
+    private updateMetaOnAccess;
+    /**
+     * 设置时更新元数据
+     */
+    private updateMetaOnSet;
+    /**
+     * 移除元数据
+     */
+    private removeMeta;
+    private getAllMeta;
+    /**
+     * 安全解析存储值
+     */
+    private parseValue;
+    /**
+     * 序列化存储值
+     */
+    private serializeValue;
+    /**
+     * 获取存储项
+     */
+    getItem<T>(key: string, defaultValue?: T | null): T | null;
+    /**
+     * 设置存储项
+     */
+    setItem<T>(key: string, value: T, ttl?: number | null): void;
+    /**
+     * 移除存储项
+     */
+    removeItem(key: string): void;
+    /**
+     * 检查键是否存在且未过期
+     */
+    hasItem(key: string): boolean;
+    /**
+     * 清除所有带前缀的项（使用倒序遍历避免索引错位）
+     */
+    clear(): void;
+    /**
+     * 清除所有过期项
+     */
+    clearExpiredItems(): void;
+    /**
+     * 获取存储键（带前缀过滤）
+     */
+    key(index: number): string | null;
+    /**
+     * 获取有效存储项数量（带前缀过滤）
+     */
+    length(): number;
+    /**
+     * 获取底层 Storage 实例（用于高级操作）
+     */
+    getRawStorage(): Storage | null;
+    /**
+     * 批量获取存储项
+     * @param keys 要获取的键数组
+     * @param options 获取选项
+     * @param onProgress 进度回调（每处理完一个项触发）
+     * @returns Promise<Record<string, T | null>> 键值映射
+     */
+    getItems<T>(keys: string[], options?: BatchGetOptions, onProgress?: BatchProgressCallback): Promise<Record<string, T | null>>;
+    /**
+     * 批量设置存储项
+     * @param items 键值对映射，值可以是普通值或 BatchSetItem 配置
+     * @param onProgress 进度回调
+     * @returns Promise<BatchResult<T>> 操作结果统计
+     */
+    setItems<T>(items: Record<string, T | BatchSetItem<T>>, onProgress?: BatchProgressCallback): Promise<BatchResult<T>>;
+    /**
+     * 批量移除存储项
+     * @param keys 要移除的键数组
+     * @returns Promise<{ removed: string[]; failed: Record<string, Error> }>
+     */
+    removeItems(keys: string[]): Promise<{
+        removed: string[];
+        failed: Record<string, Error>;
+    }>;
+    /**
+     * 批量检查键是否存在（且未过期）
+     * @param keys 要检查的键数组
+     * @returns Promise<Record<string, boolean>>
+     */
+    hasItems(keys: string[]): Promise<Record<string, boolean>>;
+    /**
+     * 内部方法：标准化批量设置的值配置
+     */
+    private _normalizeBatchValue;
+    private checkAndEvict;
+    private sortByEvictionPriority;
+    private initSync;
+    private handleSyncMessage;
+    private broadcast;
+    onSync(callback: (event: SyncMessage) => void): () => void;
+    private trackMetric;
+    private updateHitRate;
+    private debounceReportMetrics;
+    private updateQuotaUsage;
+    getMetrics(): StorageMetrics;
+    resetMetrics(): void;
+}
+export { StorageManager };