@flow97/react-toolkit 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,1448 @@
+import { ButtonProps, SelectProps, FormInstance, DrawerProps, Button, FormProps, ModalProps } from 'antd';
+import { FC, PropsWithChildren, Key, ReactNode, ReactElement, CSSProperties, Ref, DetailedHTMLProps, ImgHTMLAttributes, ComponentProps } from 'react';
+import { Options } from 'ky';
+import { ParagraphProps } from 'antd/es/typography/Paragraph';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { useLocation, PathPattern } from 'react-router';
+import { ItemType, SubMenuType, MenuItemGroupType, MenuItemType } from 'antd/es/menu/interface';
+import { AnyObject } from 'antd/es/_util/type';
+import { TableProps } from 'antd/es/table';
+import * as zustand from 'zustand';
+import { StateCreator } from 'zustand';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { StateStorage } from 'zustand/middleware';
+
+/** 响应类型 */
+type ResponseType = 'json' | 'blob' | 'text' | 'arrayBuffer' | 'formData';
+/** 通用请求选项接口 */
+interface RequestOptions extends Options {
+    /** 响应类型 */
+    responseType?: ResponseType;
+    /** 是否使用全局模式，为 true 时 app-id header 设置为 global */
+    isGlobalMode?: boolean;
+}
+
+interface AuthButtonProps extends ButtonProps {
+    /** 权限码，支持单个或多个 */
+    code?: string | string[];
+    /** 加载时是否显示 loading 状态 */
+    showLoading?: boolean;
+    /** 请求配置 */
+    config?: RequestOptions;
+}
+/**
+ * 授权按钮组件
+ * 根据权限码自动控制按钮的启用/禁用状态
+ * - 有权限：正常显示可点击按钮
+ * - 无权限：显示禁用按钮并带有提示
+ * - 加载中：显示加载状态
+ */
+declare const AuthButton: FC<PropsWithChildren<AuthButtonProps>>;
+
+interface DynamicTagsProps {
+    initialTags?: string[];
+    addable?: boolean;
+    removable?: boolean;
+    addCallback?: (addedTag: string) => Promise<boolean>;
+    removeCallback?: (removedTag: string) => Promise<boolean>;
+}
+declare const DynamicTags: FC<DynamicTagsProps>;
+
+type ExpandableParagraphProps = Omit<ParagraphProps, 'ellipsis' | 'className'>;
+declare const ExpandableParagraph: FC<ExpandableParagraphProps>;
+
+interface FilterFormWrapperProps extends PropsWithChildren {
+    onConfirm?: () => void | Promise<void>;
+    onReset?: () => void;
+    extras?: {
+        key: Key;
+        children: ReactNode;
+    }[];
+    isConfirming?: boolean;
+    buttonsAlign?: 'left' | 'right' | 'bottom';
+    showReset?: boolean;
+}
+declare const FilterFormWrapper: (props: FilterFormWrapperProps) => react_jsx_runtime.JSX.Element;
+
+interface HighlightProps extends PropsWithChildren {
+    texts: Array<string | number>;
+}
+declare const Highlight: (props: HighlightProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * KeepAlive Props
+ */
+interface KeepAliveProps {
+    /** 缓存的唯一标识，如果不提供则使用当前路由路径 */
+    cacheKey?: string;
+    /** 需要缓存的子组件 */
+    children: ReactElement;
+    /** 是否禁用缓存，默认 false */
+    disabled?: boolean;
+    /** 自定义缓存 key 生成函数 */
+    getCacheKey?: (location: ReturnType<typeof useLocation>) => string;
+}
+/**
+ * KeepAlive 组件
+ * 使用 React 19 Activity API 实现组件状态缓存，避免路由切换时重新挂载
+ * 支持路由级别的自动缓存：如果不提供 cacheKey，会自动使用当前路由路径作为缓存 key
+ *
+ * @example
+ * ```tsx
+ * // 手动指定缓存 key
+ * <KeepAlive cacheKey="/list/pagination">
+ *   <PaginationList />
+ * </KeepAlive>
+ *
+ * // 自动使用路由路径作为缓存 key
+ * <KeepAlive>
+ *   <PaginationList />
+ * </KeepAlive>
+ * ```
+ */
+declare const KeepAlive: ({ cacheKey, children, disabled, getCacheKey }: KeepAliveProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * KeepAliveOutlet Props
+ */
+interface KeepAliveOutletProps {
+    /** 是否禁用缓存，默认 false */
+    disabled?: boolean;
+    /** 自定义缓存 key 前缀，用于区分不同的 KeepAliveOutlet 实例 */
+    cacheKeyPrefix?: string;
+    /** 是否启用路由切换过渡动画，默认 true */
+    enableTransition?: boolean;
+    /** 过渡动画时长（毫秒），默认 200 */
+    transitionDuration?: number;
+}
+declare const KeepAliveOutlet: ({ disabled, cacheKeyPrefix, enableTransition, transitionDuration, }: KeepAliveOutletProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * KeepAlive 缓存项
+ */
+interface KeepAliveCacheItem {
+    /** 缓存的组件 */
+    element: ReactNode;
+    /** 是否激活 */
+    active: boolean;
+    /** 缓存时间戳 */
+    timestamp: number;
+}
+/**
+ * KeepAlive 上下文类型
+ */
+interface KeepAliveContextType {
+    /** 缓存映射 */
+    cache: Map<string, KeepAliveCacheItem>;
+    /** 添加缓存 */
+    addCache: (key: string, element: ReactNode) => void;
+    /** 移除缓存 */
+    removeCache: (key: string) => void;
+    /** 清除所有缓存 */
+    clearCache: () => void;
+    /** 激活缓存项 */
+    activateCache: (key: string) => void;
+    /** 停用缓存项 */
+    deactivateCache: (key: string) => void;
+    /** 获取缓存项 */
+    getCache: (key: string) => KeepAliveCacheItem | undefined;
+}
+/**
+ * KeepAlive Provider Props
+ */
+interface KeepAliveProviderProps {
+    /** 子组件 */
+    children: ReactNode;
+    /** 最大缓存数量，默认 10 */
+    maxCache?: number;
+    /** 是否在组件卸载时清除缓存，默认 false */
+    clearOnUnmount?: boolean;
+}
+/**
+ * KeepAlive Provider
+ * 提供 KeepAlive 缓存管理功能
+ */
+declare const KeepAliveProvider: ({ children, maxCache, clearOnUnmount }: KeepAliveProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * 使用 KeepAlive 上下文
+ */
+declare function useKeepAliveContext(): KeepAliveContextType;
+
+/**
+ * useKeepAlive Hook
+ * 用于控制 KeepAlive 缓存
+ *
+ * @example
+ * ```tsx
+ * const { clearCache, removeCache, getCacheKeys } = useKeepAlive()
+ *
+ * const handleClearAll = () => {
+ *   clearCache() // 清除所有缓存
+ * }
+ *
+ * const handleClearSpecific = () => {
+ *   removeCache('/list/pagination') // 清除特定缓存
+ * }
+ * ```
+ */
+declare function useKeepAlive(): {
+    cache: Map<string, KeepAliveCacheItem>;
+    removeCache: (key: string) => void;
+    clearCache: () => void;
+    clearCacheByPath: (path: string) => void;
+    clearCurrentCache: () => void;
+    getCacheKeys: () => string[];
+    getAllCache: () => [string, KeepAliveCacheItem][];
+    getCache: (key: string) => KeepAliveCacheItem | undefined;
+    activateCache: (key: string) => void;
+    deactivateCache: (key: string) => void;
+};
+type UseKeepAliveReturn = ReturnType<typeof useKeepAlive>;
+
+type Primitive = string | number | boolean | bigint | symbol | undefined | null;
+
+type Builtin = Primitive | Function | Date | Error | RegExp;
+
+type Prettify<Type> = Type extends Function ? Type : Extract<{
+    [Key in keyof Type]: Type[Key];
+}, Type>;
+
+type Merge<Object1, Object2> = Prettify<Omit<Object1, keyof Object2> & Object2>;
+
+type IsAny<Type> = 0 extends 1 & Type ? true : false;
+
+type IsUnknown<Type> = IsAny<Type> extends true ? false : unknown extends Type ? true : false;
+
+type MarkRequired<Type, Keys extends keyof Type> = Type extends Type ? Prettify<Type & Required<Omit<Type, Exclude<keyof Type, Keys>>>> : never;
+
+type IsTuple<Type> = Type extends readonly any[] ? (any[] extends Type ? never : Type) : never;
+
+type DeepPartial<Type> = Type extends Exclude<Builtin, Error> ? Type : Type extends Map<infer Keys, infer Values> ? Map<DeepPartial<Keys>, DeepPartial<Values>> : Type extends ReadonlyMap<infer Keys, infer Values> ? ReadonlyMap<DeepPartial<Keys>, DeepPartial<Values>> : Type extends WeakMap<infer Keys, infer Values> ? WeakMap<DeepPartial<Keys>, DeepPartial<Values>> : Type extends Set<infer Values> ? Set<DeepPartial<Values>> : Type extends ReadonlySet<infer Values> ? ReadonlySet<DeepPartial<Values>> : Type extends WeakSet<infer Values> ? WeakSet<DeepPartial<Values>> : Type extends ReadonlyArray<infer Values> ? Type extends IsTuple<Type> ? {
+    [Key in keyof Type]?: DeepPartial<Type[Key]>;
+} : Type extends Array<Values> ? Array<DeepPartial<Values> | undefined> : ReadonlyArray<DeepPartial<Values> | undefined> : Type extends Promise<infer Value> ? Promise<DeepPartial<Value>> : Type extends {} ? {
+    [Key in keyof Type]?: DeepPartial<Type[Key]>;
+} : IsUnknown<Type> extends true ? unknown : Partial<Type>;
+
+interface Game {
+    game_id: string | number;
+    [key: string]: any;
+}
+/**
+ * 导航菜单项类型
+ * 扩展 antd MenuItemType，添加路由支持
+ */
+type NavMenuItemType = Merge<MenuItemType, {
+    /** react-router 路由地址，用于菜单项点击时跳转 */
+    route?: string;
+}>;
+/**
+ * 导航子菜单类型
+ * 使用接口来支持递归类型定义，允许嵌套子菜单
+ */
+interface NavSubMenuType extends Omit<SubMenuType, 'children'> {
+    /** 子菜单项数组，支持嵌套结构 */
+    children?: NavItem[];
+}
+/**
+ * 导航菜单组类型
+ * 用于将多个菜单项分组显示，菜单组本身不计入路径
+ */
+interface NavMenuItemGroupType extends Omit<MenuItemGroupType, 'children'> {
+    /** 菜单组内的菜单项数组 */
+    children?: NavItem[];
+}
+/**
+ * 导航项联合类型
+ * 包含所有支持的导航项类型：
+ * - 特殊项（如分割线）
+ * - 普通菜单项（NavMenuItemType）
+ * - 子菜单（NavSubMenuType）
+ * - 菜单组（NavMenuItemGroupType）
+ */
+type NavItem = Exclude<ItemType, SubMenuType | MenuItemGroupType | MenuItemType> | NavMenuItemType | NavSubMenuType | NavMenuItemGroupType;
+
+interface GameSelectProps<T extends Game = Game> {
+    filter?: (game: T) => boolean;
+    options?: (data?: T[]) => SelectProps['options'];
+    onChange?: (value: string) => void;
+}
+
+/** Header 扩展项配置 */
+type HeaderExtra = {
+    key: Key;
+    children: ReactNode;
+};
+/** Header 扩展区域配置 */
+interface HeaderExtraConfig {
+    /** 左侧扩展项 */
+    left?: HeaderExtra[];
+    /** 右侧扩展项 */
+    right?: HeaderExtra[];
+}
+/** 导航配置 */
+interface NavigationConfig {
+    /** 导航菜单项 */
+    items?: NavItem[];
+    /** 菜单加载状态 */
+    loading?: boolean;
+}
+/** 路由匹配规则类型
+ * 支持：
+ * - PathPattern 对象（React Router 路由模式，支持 caseSensitive 和 end 选项）
+ * - 正则表达式（用于更复杂的匹配需求）
+ */
+type RouteMatchRule = PathPattern | RegExp;
+/** 游戏选择器配置 */
+interface GameSelectConfig<T extends Game = Game> {
+    /** 游戏过滤函数 */
+    filter?: GameSelectProps<T>['filter'];
+    /** 选项自定义函数 */
+    options?: GameSelectProps<T>['options'];
+    /** 在这些路由路径下隐藏游戏选择器（支持 PathPattern 对象或正则表达式） */
+    hideOnRoutes?: RouteMatchRule[];
+    /** 游戏切换时的回调函数 */
+    onChange?: (value: string | number) => void;
+}
+/** Layout 组件属性 */
+interface LayoutProps<T extends Game = Game> {
+    /** 应用标题（显示在侧边栏顶部） */
+    title?: string;
+    /** 应用标题样式 */
+    titleStyle?: CSSProperties;
+    /** 应用副标题（显示在标题下方） */
+    subtitle?: string;
+    /** 导航配置 */
+    navigation?: NavigationConfig;
+    /** 游戏选择器配置 */
+    gameSelect?: GameSelectConfig<T>;
+    /** Header 扩展区域配置 */
+    headerExtra?: HeaderExtraConfig;
+}
+declare const Layout: <T extends Game = Game>(props: PropsWithChildren<LayoutProps<T>>) => react_jsx_runtime.JSX.Element;
+
+/**
+ * 列表组件的公共类型定义
+ */
+/**
+ * HTTP 请求方法
+ */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * React Query 缓存配置
+ */
+interface CacheConfig {
+    /** 缓存时间（毫秒），数据在缓存中保留的时间 */
+    cacheTime?: number;
+    /** 过期时间（毫秒），数据在过期前被认为是新鲜的 */
+    staleTime?: number;
+}
+/**
+ * 基础 Payload 接口
+ * @template Values 筛选条件的类型
+ */
+interface BaseListPayload<Values = any> {
+    /** 当前页码 */
+    page?: number;
+    /** 表单筛选条件 */
+    filters?: Values;
+}
+/**
+ * QueryList 的 Payload（包含 size）
+ * @template Values 筛选条件的类型
+ */
+interface QueryListPayload<Values = any> extends BaseListPayload<Values> {
+    /** 每页数量 */
+    size?: number;
+}
+/**
+ * InfiniteList 的 Payload
+ * @template Values 表单值的类型
+ */
+type InfiniteListPayload<Values = any> = BaseListPayload<Values>;
+/**
+ * 状态同步回调函数类型
+ * @template Payload Payload 类型
+ */
+type StateSyncCallback<Payload> = (payload: Payload) => void;
+/**
+ * Query 更新函数类型
+ */
+type QueryRefetchFunction = () => void | Promise<unknown>;
+/**
+ * Infinite Query 的 fetchNextPage 函数类型
+ */
+type InfiniteQueryFetchNextPageFunction = () => void | Promise<unknown>;
+
+/**
+ * 分页参数类型，支持多种分页方式：
+ * - number: 页码分页
+ * - string: 游标分页（cursor）
+ * - object: 复杂分页参数对象
+ * - undefined: 无下一页
+ */
+type PageParam = number | string | Record<string, any> | undefined;
+/**
+ * 请求体解析器
+ * 可以是静态值，也可以是动态函数
+ * @template Values 表单值的类型
+ * @template PageParamType 分页参数的类型（可能是 undefined，表示第一页）
+ */
+type RequestBodyResolver<Values = any, PageParamType = PageParam> = FormData | Record<string | number, any> | ((payload: InfiniteListPayload<Values>, pageParam: PageParamType | undefined) => FormData | Record<string | number, any>);
+/**
+ * 请求参数解析器（用于 URL 查询参数）
+ * 可以是静态值，也可以是动态函数
+ * @template Values 表单值的类型
+ * @template PageParamType 分页参数的类型（可能是 undefined，表示第一页）
+ */
+type RequestParamsResolver<Values = any, PageParamType = PageParam> = Record<string | number, any> | ((payload: InfiniteListPayload<Values>, pageParam: PageParamType | undefined) => Record<string | number, any>);
+/**
+ * 无限列表请求配置
+ * @template Values 表单值的类型
+ * @template PageParamType 分页参数的类型
+ */
+interface InfiniteListRequestConfig<Values = any, PageParamType = PageParam> extends CacheConfig {
+    /** 请求 URL */
+    url: string;
+    /** HTTP 请求方法，默认为 GET */
+    method?: HttpMethod;
+    /** 请求体（用于 POST、PUT、PATCH、DELETE 等方法） */
+    body?: RequestBodyResolver<Values, PageParamType>;
+    /** URL 查询参数 */
+    searchParams?: RequestParamsResolver<Values, PageParamType>;
+    /** 请求头，可以是静态对象或动态函数 */
+    headers?: Record<string, string> | ((form: FormInstance<Values>) => Record<string, string>);
+    /** 是否为全局模式请求 */
+    isGlobalMode?: boolean;
+}
+/**
+ * 无限列表请求配置类型
+ * 支持字符串、对象或函数形式：
+ * - string: 仅指定 url，其他参数使用默认值
+ * - 对象: 完整配置
+ * - 函数: 根据 payload 和 pageParam 动态生成配置
+ * @template Values 表单值的类型
+ * @template PageParamType 分页参数的类型
+ */
+type InfiniteListRequestConfigType<Values = any, PageParamType = PageParam> = string | InfiniteListRequestConfig<Values, PageParamType> | ((payload: InfiniteListPayload<Values>, pageParam: PageParamType | undefined) => InfiniteListRequestConfig<Values, PageParamType>);
+/**
+ * 数据适配器，用于转换和适配后端返回的数据格式
+ * @template Item 列表项类型
+ * @template Values 表单值类型
+ * @template Data 后端返回的数据类型
+ * @template PageParamType 分页参数的类型
+ */
+interface InfiniteListDataAdapter<Item = any, Values = any, Data = any, PageParamType = PageParam> {
+    /**
+     * 从后端数据中提取列表项
+     * @param data 所有已加载的页面数据
+     * @param form 表单实例
+     * @returns 提取的列表项数组
+     */
+    items?: (data: Data[] | undefined, form: FormInstance<Values>) => Item[] | undefined;
+    /**
+     * 判断是否还有更多数据
+     * @param lastPage 最后一页的数据
+     * @param allPages 所有已加载的页面数据
+     * @returns 是否还有更多数据
+     */
+    hasMore?: (lastPage: Data | undefined, allPages: Data[]) => boolean;
+    /**
+     * 计算下一页的分页参数
+     * @param lastPage 最后一页的数据
+     * @param allPages 所有已加载的页面数据
+     * @param pageParam 当前的分页参数
+     * @returns 下一页的分页参数，返回 undefined 表示没有下一页
+     */
+    nextPageParam?: (lastPage: Data | undefined, allPages: Data[], pageParam: PageParamType) => PageParamType | undefined;
+}
+/**
+ * InfiniteList 组件的引用对象，提供外部访问的 API
+ * @template Item 列表项类型
+ * @template Values 表单值类型
+ * @template Data 后端返回的数据类型
+ */
+interface InfiniteListRef<Item = any, Values = any, Data = any> {
+    /** 所有已加载的页面数据 */
+    data: Data[] | undefined;
+    /** 处理后的列表数据源 */
+    dataSource: Item[] | undefined;
+    /** 表单实例 */
+    form: FormInstance<Values>;
+    /** 重新获取数据 */
+    refetch: () => void;
+    /** 获取下一页数据 */
+    fetchNextPage: () => void;
+    /** 是否还有下一页 */
+    hasNextPage: boolean;
+    /** 是否正在获取下一页 */
+    isFetchingNextPage: boolean;
+}
+/**
+ * InfiniteList 组件的属性
+ * @template Item 列表项类型
+ * @template Values 表单值类型
+ * @template Data 后端返回的数据类型
+ * @template PageParamType 分页参数的类型
+ */
+interface InfiniteListProps<Item, Values, Data, PageParamType = PageParam> extends Omit<TableProps<Item>, 'pagination' | 'dataSource' | 'loading' | 'footer'>, Pick<FilterFormWrapperProps, 'buttonsAlign' | 'showReset'> {
+    /** 唯一标识符，用于在 store 中区分不同的列表实例 */
+    identifier?: string;
+    /** 权限代码，用于权限控制 */
+    code?: string;
+    /** 表单实例，如果不提供则内部创建 */
+    form?: FormInstance<Values>;
+    /** 自动刷新间隔（毫秒），0 表示不自动刷新 */
+    refreshInterval?: number;
+    /** 请求配置，可以是静态配置或动态函数 */
+    request: InfiniteListRequestConfigType<Values, PageParamType>;
+    /** 表格额外内容，可以是静态内容或动态函数 */
+    tableExtra?: ReactNode | ((form: FormInstance<Values>, data?: Data[]) => ReactNode);
+    /** 自定义表单渲染函数 */
+    renderForm?: (form: FormInstance<Values>) => ReactElement;
+    /** 请求成功后的回调 */
+    afterSuccess?: (form: FormInstance<Values>, data?: Data[]) => void;
+    /** 请求失败后的回调 */
+    afterError?: (error: Error, form: FormInstance<Values>) => void;
+    /** 数据适配器，用于转换后端数据格式 */
+    dataAdapter?: InfiniteListDataAdapter<Item, Values, Data, PageParamType>;
+    /** 初始分页参数，默认为 0 */
+    initialPageParam?: PageParamType;
+    /** 表格底部内容，可以是静态内容或动态函数 */
+    footer?: (data: Data[] | undefined) => ReactNode;
+}
+/**
+ * InfiniteList 组件
+ * @template Item 列表项类型
+ * @template Values 表单值类型
+ * @template Data 后端返回的数据类型
+ * @template PageParamType 分页参数的类型
+ */
+declare function InfiniteListComponent<Item extends AnyObject = AnyObject, Values extends object | undefined = undefined, Data = any, PageParamType = PageParam>(props: InfiniteListProps<Item, Values, Data, PageParamType> & {
+    ref?: Ref<InfiniteListRef<Item, Values, Data>>;
+}): ReactElement;
+declare const InfiniteList: typeof InfiniteListComponent;
+
+/**
+ * 通用列表实例接口
+ * @template Payload Payload 类型
+ * @template ExtraMethods 额外的实例方法（如 fetchNextPage）
+ */
+interface BaseListInstance<Payload, ExtraMethods = Record<string, unknown>> {
+    id: string;
+    url: string;
+    queryKey: readonly unknown[];
+    payload: Payload;
+    refetch: QueryRefetchFunction;
+    syncCallback?: StateSyncCallback<Payload>;
+    /** 额外的实例方法 */
+    extraMethods?: ExtraMethods;
+}
+/**
+ * 通用列表状态接口
+ * @template Payload Payload 类型
+ * @template Instance 实例类型
+ */
+interface BaseListState<Payload, Instance extends BaseListInstance<Payload>> {
+    instances: Map<string, Instance>;
+    registerInstance(instance: Omit<Instance, 'payload'>): void;
+    unregisterInstance(id: string): void;
+    updatePayload(id: string, payload: Partial<Payload>, syncToComponent?: boolean): void;
+    getPayload(id: string): Payload;
+    refetch(id: string, payload?: Partial<Payload>): Promise<void>;
+    getInstance(id: string): Instance | undefined;
+    getAllInstances(): Instance[];
+}
+
+/**
+ * InfiniteList 实例的额外方法
+ */
+interface InfiniteListExtraMethods extends Record<string, unknown> {
+    fetchNextPage: InfiniteQueryFetchNextPageFunction;
+}
+/**
+ * InfiniteList 实例信息
+ */
+interface InfiniteListInstance extends BaseListInstance<InfiniteListPayload, InfiniteListExtraMethods> {
+    refetch: QueryRefetchFunction;
+    fetchNextPage: InfiniteQueryFetchNextPageFunction;
+    syncCallback?: StateSyncCallback<InfiniteListPayload>;
+}
+declare const baseStore$1: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<BaseListState<InfiniteListPayload, InfiniteListInstance>>, "setState" | "devtools"> & {
+    setState(partial: BaseListState<InfiniteListPayload, InfiniteListInstance> | Partial<BaseListState<InfiniteListPayload, InfiniteListInstance>> | ((state: BaseListState<InfiniteListPayload, InfiniteListInstance>) => BaseListState<InfiniteListPayload, InfiniteListInstance> | Partial<BaseListState<InfiniteListPayload, InfiniteListInstance>>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: BaseListState<InfiniteListPayload, InfiniteListInstance> | ((state: BaseListState<InfiniteListPayload, InfiniteListInstance>) => BaseListState<InfiniteListPayload, InfiniteListInstance>), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "subscribe"> & {
+    subscribe: {
+        (listener: (selectedState: BaseListState<InfiniteListPayload, InfiniteListInstance>, previousSelectedState: BaseListState<InfiniteListPayload, InfiniteListInstance>) => void): () => void;
+        <U>(selector: (state: BaseListState<InfiniteListPayload, InfiniteListInstance>) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+            equalityFn?: ((a: U, b: U) => boolean) | undefined;
+            fireImmediately?: boolean;
+        } | undefined): () => void;
+    };
+}>;
+declare const useInfiniteListStore: typeof baseStore$1 & {
+    registerInstance(id: string, url: string, queryKey: readonly unknown[], refetch: QueryRefetchFunction, fetchNextPage: InfiniteQueryFetchNextPageFunction, syncCallback?: StateSyncCallback<InfiniteListPayload>): void;
+    fetchNextPage: (id: string) => Promise<void>;
+    getQueryKey(id: string): readonly unknown[] | undefined;
+};
+
+/**
+ * 标准列表响应格式
+ * @template T 列表项类型
+ */
+interface ListResponse<T = any> {
+    code: number;
+    data: {
+        list: T[];
+        total: number;
+    };
+    msg: string;
+}
+/**
+ * 请求配置
+ * 支持配置 URL、方法、请求体、查询参数等
+ */
+interface QueryListRequestConfig extends CacheConfig {
+    url: string;
+    method?: HttpMethod;
+    body?: FormData | Record<string | number, any>;
+    searchParams?: Record<string | number, any>;
+    headers?: Record<string, string>;
+    /** 是否使用全局模式（覆盖 ToolkitsProvider 中的 isGlobalMode） */
+    isGlobalMode?: boolean;
+}
+/**
+ * 请求配置类型
+ * 支持字符串、对象或函数形式：
+ * - string: 仅指定 url，其他参数使用默认值
+ * - 对象: 完整配置
+ * - 函数: 根据 payload 动态生成配置
+ *
+ * @template Values 筛选条件的类型
+ */
+type QueryListRequestConfigType<Values = any> = string | QueryListRequestConfig | ((payload: QueryListPayload<Values>) => QueryListRequestConfig);
+/**
+ * 操作类型枚举
+ * 用于在回调函数中区分操作来源
+ */
+declare enum QueryListAction {
+    Confirm = 0,// 确认搜索
+    Reset = 1,// 重置表单
+    Jump = 2,// 跳转页码
+    Init = 3
+}
+/**
+ * QueryList 组件通过 ref 暴露的接口
+ * @template Item 列表项类型
+ * @template Values 表单值类型
+ * @template Data 响应数据类型
+ */
+interface QueryListRef<Item extends AnyObject = AnyObject, Values = AnyObject, Data = ListResponse<Item>> {
+    data: Data | undefined;
+    dataSource: Item[] | undefined;
+    form: FormInstance<Values>;
+}
+/**
+ * 数据适配器配置
+ * 用于从响应数据中提取列表项和总数
+ * @template Item 列表项类型
+ */
+interface QueryListDataAdapter<Item extends AnyObject = AnyObject> {
+    total?: number;
+    items?: Item[];
+}
+/**
+ * 数据适配器配置类型
+ * 支持对象或函数形式，函数形式可以根据响应数据动态提取
+ * @template Item 列表项类型
+ * @template Data 响应数据类型
+ */
+type QueryListDataAdapterConfig<Item extends AnyObject = AnyObject, Data = ListResponse<Item>> = QueryListDataAdapter<Item> | ((data: Data) => QueryListDataAdapter<Item>);
+/**
+ * QueryList 组件的 Props
+ * @template Item 列表项类型
+ * @template Values 表单值类型
+ * @template Data 响应数据类型
+ */
+interface QueryListProps<Item extends AnyObject = AnyObject, Values = AnyObject, Data = ListResponse<Item>> extends Omit<TableProps<Item>, 'pagination' | 'dataSource' | 'loading' | 'footer'>, Pick<FilterFormWrapperProps, 'buttonsAlign' | 'showReset'> {
+    /** 可选的标识符，用于标识和外部控制，未提供时自动生成 */
+    identifier?: string;
+    /** 权限代码，用于权限检查 */
+    code?: string;
+    /** 表单实例，如果不提供会自动创建 */
+    form?: FormInstance<Values>;
+    /** 轮询间隔（毫秒），0 表示不轮询 */
+    refreshInterval?: number;
+    /** 是否无分页，为 true 时不显示分页组件 */
+    onePage?: boolean;
+    /** 默认每页数量 */
+    defaultSize?: number;
+    /** 每页数量选项 */
+    pageSizeOptions?: number[];
+    /** 请求配置，支持对象或函数形式 */
+    request: QueryListRequestConfigType<Values>;
+    /** 表格额外内容，支持节点或函数形式 */
+    tableExtra?: ReactNode | ((form: FormInstance<Values>, data?: Data) => ReactNode);
+    /** 表单渲染函数 */
+    renderForm?: (form: FormInstance<Values>) => ReactElement;
+    /** 请求成功后的回调 */
+    afterSuccess?: (action: QueryListAction, form: FormInstance<Values>, data?: Data) => void;
+    /** 请求失败后的回调 */
+    afterError?: (error: Error, action: QueryListAction, form: FormInstance<Values>) => void;
+    /** 数据适配器，用于从响应数据中提取列表项和总数 */
+    dataAdapter?: QueryListDataAdapterConfig<Item, Data>;
+    /** 表格底部内容 */
+    footer?: (data: Data | undefined) => ReactNode;
+}
+declare const QueryList: <Item extends AnyObject = AnyObject, Values extends object | undefined = undefined, Data = any>(props: QueryListProps<Item, Values, Data> & {
+    ref?: Ref<QueryListRef<Item, Values, Data>>;
+}) => ReactElement;
+
+/**
+ * QueryList 实例信息
+ */
+interface QueryListInstance extends BaseListInstance<QueryListPayload> {
+    refetch: QueryRefetchFunction;
+    syncCallback?: StateSyncCallback<QueryListPayload>;
+}
+declare const baseStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<BaseListState<QueryListPayload<any>, QueryListInstance>>, "setState" | "devtools"> & {
+    setState(partial: BaseListState<QueryListPayload<any>, QueryListInstance> | Partial<BaseListState<QueryListPayload<any>, QueryListInstance>> | ((state: BaseListState<QueryListPayload<any>, QueryListInstance>) => BaseListState<QueryListPayload<any>, QueryListInstance> | Partial<BaseListState<QueryListPayload<any>, QueryListInstance>>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: BaseListState<QueryListPayload<any>, QueryListInstance> | ((state: BaseListState<QueryListPayload<any>, QueryListInstance>) => BaseListState<QueryListPayload<any>, QueryListInstance>), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "subscribe"> & {
+    subscribe: {
+        (listener: (selectedState: BaseListState<QueryListPayload<any>, QueryListInstance>, previousSelectedState: BaseListState<QueryListPayload<any>, QueryListInstance>) => void): () => void;
+        <U>(selector: (state: BaseListState<QueryListPayload<any>, QueryListInstance>) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+            equalityFn?: ((a: U, b: U) => boolean) | undefined;
+            fireImmediately?: boolean;
+        } | undefined): () => void;
+    };
+}>;
+declare const useQueryListStore: typeof baseStore & {
+    registerInstance(id: string, url: string, queryKey: readonly unknown[], refetch: QueryRefetchFunction, syncCallback?: StateSyncCallback<QueryListPayload>): void;
+    getQueryKey(id: string): readonly unknown[] | undefined;
+};
+
+type LogoProps = Omit<DetailedHTMLProps<ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, 'src' | 'alt'>;
+declare const Logo: FC<LogoProps>;
+
+interface RequireAuthProps {
+    /** 权限码 */
+    code: string;
+    /** 请求配置 */
+    config?: RequestOptions;
+    /** 无权限时点击返回按钮跳转的路径，默认为首页 '/' */
+    redirectPath?: string;
+}
+/**
+ * 授权保护组件
+ * 根据权限码控制子组件的访问权限
+ * - 有权限：渲染子组件
+ * - 无权限：显示 403 无权限页面，可点击按钮返回指定路径
+ * - 加载中：显示加载动画
+ */
+declare const RequireAuth: FC<PropsWithChildren<RequireAuthProps>>;
+
+declare const RequireGame: FC<PropsWithChildren>;
+
+type BaseValue = string | number;
+type InternalValue<V extends BaseValue> = V | string;
+type InternalValueArray<V extends BaseValue> = Array<InternalValue<V>>;
+interface SelectAllProps<V extends BaseValue = string> extends Omit<SelectProps<InternalValueArray<V>>, 'mode' | 'options' | 'value' | 'onChange'> {
+    /** antd Select options（支持分组） */
+    options: NonNullable<SelectProps<V>['options']>;
+    /** 当前选中值（多选） */
+    value?: V[];
+    /** 选中值变化回调（不会包含“全选”占位 value） */
+    onChange?: (value: V[], option: unknown) => void;
+    /** Select mode，默认 multiple */
+    mode?: 'multiple' | 'tags';
+    /** “全选”显示文案 */
+    allLabel?: ReactNode;
+    /** “全选”的占位 value，需避免与业务 value 冲突 */
+    allValue?: string;
+    /** 计算“全选”时是否包含 disabled 的选项，默认 false */
+    includeDisabledInAll?: boolean;
+}
+declare const SelectAll: <V extends BaseValue = string>(props: SelectAllProps<V>) => react_jsx_runtime.JSX.Element;
+
+declare const SSO_URL = "https://idaas.ifunplus.cn/enduser/api/application/plugin_FunPlus/sso/v1";
+declare const APP_ID_HEADER = "App-ID";
+declare const FRONTEND_ROUTE_PREFIX = "/console/";
+/**
+ * 认证系统模式枚举
+ * - GAME_SCOPED: 游戏范围权限（角色权限包含游戏信息）
+ * - GROUP_BASED: 基于项目组的权限（需要先选择项目组才能选择游戏）
+ * - DIRECT_GAME: 直接游戏权限（不需要项目组，直接选择游戏）
+ */
+declare enum AuthMode {
+    /** 游戏范围权限：角色权限包含游戏范围信息 */
+    GAME_SCOPED = "game_scoped",
+    /** 基于项目组的权限：权限依赖项目组，需要先选择项目组才能选择游戏 */
+    GROUP_BASED = "group_based",
+    /** 直接游戏权限：权限直接选择游戏，不需要项目组作为中间层 */
+    DIRECT_GAME = "direct_game"
+}
+declare const WILDCARD = "*";
+
+type Locale = {
+    global: {
+        noEntitlement: string;
+        name: string;
+        creationTime: string;
+        operation: string;
+        update: string;
+        edit: string;
+        delete: string;
+        selectAll: string;
+        game: string;
+        user: string;
+        role: string;
+        username: string;
+        password: string;
+        label: string;
+        method: string;
+        route: string;
+        request: string;
+        response: string;
+        add: string;
+        signIn: string;
+        projectGroup: string;
+        view: string;
+        back: string;
+    };
+    SignIn: {
+        title: string;
+        signInWithIDass: string;
+        unregistered: string;
+        welcome: string;
+    };
+    NotFound: {
+        subTitle: string;
+        buttonText: string;
+    };
+    FilterFormWrapper: {
+        confirmText: string;
+        resetText: string;
+    };
+    FormModal: {
+        confirmText: string;
+        cancelText: string;
+    };
+    GameSelect: {
+        label: string;
+        placeholder: string;
+    };
+    RequireGame: {
+        description: string;
+    };
+    UserDropdown: {
+        signOutText: string;
+    };
+    User: {
+        createTitle: string;
+        createSuccessfully: string;
+        updateTitle: string;
+        updateSuccessfully: string;
+        deleteTitle: string;
+        deleteContent: string;
+        deleteSuccessfully: string;
+    };
+    Role: {
+        createTitle: string;
+        createSuccessfully: string;
+        updateTitle: string;
+        updateSuccessfully: string;
+        deleteTitle: string;
+        deleteContent: string;
+        deleteSuccessfully: string;
+    };
+    PermissionList: {
+        failedDescription: string;
+        baseSectionTitle: string;
+        gameSectionTitle: string;
+        gameSectionDescription: string;
+        gameSelectPlaceholder: string;
+        removeText: string;
+        addText: string;
+    };
+    RoleDetail: {
+        title: string;
+    };
+    InfiniteList: {
+        loadingText: string;
+        reachEndText: string;
+        loadMoreText: string;
+    };
+};
+
+interface ContextSlice {
+    /** 是否使用游戏 API V2 版本 */
+    useGameApiV2: boolean;
+    /** 接口基础路径 */
+    apiBaseUrl?: string;
+    /** 登录页路径 */
+    loginPath: string;
+    /** 首页地址 */
+    homePath: string;
+    /** 侧边栏宽度 */
+    sidebarWidth?: number;
+    /** 侧边栏是否可折叠 */
+    sidebarCollapsible?: boolean;
+    /** 数据是否按游戏划分范围，默认为 false */
+    gameScoped?: boolean;
+    /** 本地化语言包 */
+    locale: Locale;
+    /** 认证模式 */
+    authMode: AuthMode;
+}
+
+interface GameSlice {
+    appId?: string | number;
+    setAppId: (id?: string | number) => void;
+}
+
+interface LayoutSlice {
+    collapsed: boolean;
+    toggleCollapsed: () => void;
+}
+
+/**
+ * 导航菜单状态接口
+ */
+interface NavSlice {
+    /** 当前展开的菜单项 key 数组 */
+    openKeys: string[];
+    /** 当前选中的菜单项 key 数组 */
+    selectedKeys: string[];
+    /** 设置展开的菜单项 */
+    setOpenKeys: (keys: string[]) => void;
+    /** 设置选中的菜单项 */
+    setSelectedKeys: (keys: string[]) => void;
+}
+
+/**
+ * JWT Token 解密后的用户信息
+ */
+interface UserInfo {
+    authorityId: string;
+    exp: number;
+}
+interface TokenSlice {
+    /** JWT Token */
+    token?: string;
+    user: UserInfo | null;
+    setToken: (token: string) => void;
+    clearToken: () => void;
+}
+
+type ToolkitsState = {
+    context: ContextSlice;
+    token: TokenSlice;
+    game: GameSlice;
+    layout: LayoutSlice;
+    nav: NavSlice;
+    clear: () => void;
+};
+
+declare function useToolkitsStore(): ToolkitsState;
+declare function useToolkitsStore<T>(selector: (state: ToolkitsState) => T): T;
+type ToolkitsProviderProps = PropsWithChildren<DeepPartial<ContextSlice>>;
+/**
+ * ToolkitsProvider 组件
+ *
+ * 支持嵌套使用，子 Provider 会从最近的父 Provider 继承 context 配置。
+ * 子 Provider 的 props 会覆盖父 Provider 的对应配置。
+ *
+ * 当父级 context 或当前 props 发生变化时，会重新创建 store 以确保配置同步。
+ *
+ * @example
+ * 外层 Provider 和内层 Provider 嵌套使用示例：
+ * - 外层：loginPath="/login" apiBaseUrl="https://api.example.com"
+ * - 内层：apiBaseUrl="https://api-v2.example.com" (会覆盖外层的 apiBaseUrl)
+ */
+declare const ToolkitsProvider: FC<ToolkitsProviderProps>;
+
+declare const UserDropdown: FC;
+
+/** 抽屉操作对象 */
+interface UseDrawerOperation {
+    /** 隐藏抽屉 */
+    hide: () => void;
+}
+/** useDrawer 的配置选项 */
+interface UseDrawerProps extends Omit<DrawerProps, 'open' | 'confirmLoading' | 'onClose' | 'footer'> {
+    /** 抽屉内容，可以是 ReactNode 或函数 */
+    content?: ReactNode | ((operation: UseDrawerOperation) => ReactNode);
+    /** 确认回调 */
+    onConfirm?: () => void | Promise<void>;
+    /** 打开后回调 */
+    afterOpen?: () => void | Promise<void>;
+    /** 关闭后回调 */
+    afterClose?: () => void | Promise<void>;
+    /** 自定义底部（传 null 隐藏底部） */
+    footer?: ReactNode | null;
+    /** 确认按钮文本 */
+    confirmText?: string;
+    /** 取消按钮文本 */
+    cancelText?: string;
+    /** 确认按钮配置 */
+    confirmButtonProps?: ComponentProps<typeof Button>;
+    /** 取消按钮配置 */
+    cancelButtonProps?: ComponentProps<typeof Button>;
+}
+declare function useDrawer(props: UseDrawerProps): {
+    id: number;
+    show: () => Promise<void>;
+    hide: () => void;
+    confirmLoading: boolean;
+    drawer: react_jsx_runtime.JSX.Element;
+};
+
+interface Permission {
+    label: string;
+    value: string;
+    route: string;
+    method?: string;
+}
+interface MenuListItem {
+    id: number;
+    category: string;
+    is_common: boolean;
+    is_model: boolean;
+    model_name: string;
+    permissions: Permission[];
+    front_route: string;
+    order: number;
+    scheme: string;
+    ext: string;
+}
+type RecursivePartial<T> = NonNullable<T> extends object ? {
+    [P in keyof T]?: NonNullable<T[P]> extends (infer U)[] ? RecursivePartial<U>[] : NonNullable<T[P]> extends object ? RecursivePartial<T[P]> : T[P];
+} : T;
+interface JsonResponse<T> {
+    code: number;
+    message: string;
+    data: T;
+}
+
+/**
+ * 条件类型：根据 ExtraValues 是否为默认空对象，决定 extraValues 是否必传
+ * - 如果 ExtraValues 是 Record<string, unknown>，extraValues 为可选
+ * - 如果 ExtraValues 是具体类型（有明确字段），extraValues 为必传
+ */
+type BaseShowFormOptions$1<Values extends AnyObject, ExtraValues> = {
+    initialValues?: RecursivePartial<Values>;
+    extraValues?: ExtraValues;
+};
+type ShowFormOptions$1<Values extends AnyObject, ExtraValues> = Record<string, unknown> extends ExtraValues ? BaseShowFormOptions$1<Values, ExtraValues> : MarkRequired<BaseShowFormOptions$1<Values, ExtraValues>, 'extraValues'>;
+/**
+ * useFormDrawer 的配置选项
+ * @template Values 表单值类型
+ * @template ExtraValues 额外参数类型，如果指定具体类型（非 Record<string, unknown>），调用 show 时必须传入
+ */
+interface UseFormDrawerProps<Values extends AnyObject = AnyObject, ExtraValues = Record<string, unknown>> extends Omit<UseDrawerProps, 'onConfirm' | 'content' | 'afterClose'> {
+    /** 表单配置 */
+    formProps?: Omit<FormProps, 'form'>;
+    /** 表单实例（可选，不传则自动创建） */
+    form?: FormInstance<Values>;
+    /** 抽屉内容，可以是 ReactNode 或函数 */
+    content?: ReactNode | ((extraValues: ExtraValues, operation: UseDrawerOperation) => ReactNode);
+    /** 表单提交回调 */
+    onConfirm?: (values: Values, extraValues: ExtraValues) => void | Promise<void>;
+    /** 提交成功回调 */
+    onSuccess?: () => void;
+    /** 关闭后回调 */
+    afterClose?: (form: FormInstance<Values>) => void;
+}
+/**
+ * useFormDrawer 的返回值
+ * @template Values 表单值类型
+ * @template ExtraValues 额外参数类型
+ */
+interface UseFormDrawerReturn<Values extends AnyObject, ExtraValues> {
+    /** 抽屉唯一标识 */
+    id: number;
+    /** 显示抽屉，根据 ExtraValues 类型自动判断参数是否必传 */
+    show: (options?: ShowFormOptions$1<Values, ExtraValues>) => void;
+    /** 隐藏抽屉 */
+    hide: () => void;
+    /** 抽屉组件 */
+    drawer: ReactNode;
+}
+declare function useFormDrawer<Values extends AnyObject = AnyObject, ExtraValues = Record<string, unknown>>(props: UseFormDrawerProps<Values, ExtraValues>): UseFormDrawerReturn<Values, ExtraValues>;
+
+interface VisibilityState {
+    open: Map<number, boolean>;
+    usedIds: Set<number>;
+    isOpen: (uuid: number) => boolean;
+    show: (uuid: number) => void;
+    hide: (uuid: number) => void;
+    hideAll: () => void;
+    checkUniqueness: (uuid: number) => boolean;
+    registerIds: (uuid: number) => boolean;
+    cleanup: (uuid: number) => void;
+}
+/**
+ * 创建可见性管理的 Zustand store 配置
+ * 这是一个纯函数，返回 store 的配置对象
+ * 使用函数形式延迟执行，避免模块初始化顺序问题
+ */
+declare function createVisibilityStoreConfig(): StateCreator<VisibilityState, [], [], VisibilityState>;
+
+declare const generateId: () => number;
+
+/**
+ * 混合存储策略
+ * - 优先从 SessionStorage 读取数据，防止多开页面时的数据冲突
+ * - 写入时同时更新 SessionStorage 和 LocalStorage
+ * - SessionStorage 不存在时，fallback 到 LocalStorage
+ */
+declare const mixedStorage: StateStorage;
+
+/**
+ * Drawer store hook
+ * 使用 lazy initialization 确保 create 函数在调用时已经准备好
+ */
+declare function useDrawerStore(): VisibilityState;
+
+/** 模态框操作对象 */
+interface UseModalOperation {
+    /** 隐藏模态框 */
+    hide: () => void;
+}
+/** useModal 的配置选项 */
+interface UseModalProps extends Omit<ModalProps, 'open' | 'confirmLoading' | 'onOk' | 'onCancel'> {
+    /** 模态框内容，可以是 ReactNode 或函数 */
+    content?: ReactNode | ((operation: UseModalOperation) => ReactNode);
+    /** 确认回调 */
+    onConfirm?: () => void | Promise<void>;
+    /** 打开后回调 */
+    afterOpen?: () => void | Promise<void>;
+    /** 关闭后回调 */
+    afterClose?: () => void | Promise<void>;
+}
+declare function useModal(props: UseModalProps): {
+    id: number;
+    show: () => Promise<void>;
+    hide: () => void;
+    modal: react_jsx_runtime.JSX.Element;
+};
+
+/**
+ * 条件类型：根据 ExtraValues 是否为默认空对象，决定 extraValues 是否必传
+ * - 如果 ExtraValues 是 Record<string, unknown>，extraValues 为可选
+ * - 如果 ExtraValues 是具体类型（有明确字段），extraValues 为必传
+ */
+type BaseShowFormOptions<Values extends AnyObject, ExtraValues> = {
+    initialValues?: RecursivePartial<Values>;
+    extraValues?: ExtraValues;
+};
+type ShowFormOptions<Values extends AnyObject, ExtraValues> = Record<string, unknown> extends ExtraValues ? BaseShowFormOptions<Values, ExtraValues> : MarkRequired<BaseShowFormOptions<Values, ExtraValues>, 'extraValues'>;
+/**
+ * useFormModal 的配置选项
+ * @template Values 表单值类型
+ * @template ExtraValues 额外参数类型，如果指定具体类型（非 Record<string, unknown>），调用 show 时必须传入
+ */
+interface UseFormModalProps<Values extends AnyObject = AnyObject, ExtraValues = Record<string, unknown>> extends Omit<UseModalProps, 'onConfirm' | 'content' | 'afterClose'> {
+    /** 表单配置 */
+    formProps?: Omit<FormProps, 'form'>;
+    /** 表单实例（可选，不传则自动创建） */
+    form?: FormInstance<Values>;
+    /** 模态框内容，可以是 ReactNode 或函数 */
+    content?: ReactNode | ((extraValues: ExtraValues, operation: UseModalOperation) => ReactNode);
+    /** 表单提交回调 */
+    onConfirm?: (values: Values, extraValues: ExtraValues) => void | Promise<void>;
+    /** 提交成功回调 */
+    onSuccess?: () => void;
+    /** 关闭后回调 */
+    afterClose?: (form: FormInstance<Values>) => void;
+}
+/**
+ * useFormModal 的返回值
+ * @template Values 表单值类型
+ * @template ExtraValues 额外参数类型
+ */
+interface UseFormModalReturn<Values extends AnyObject, ExtraValues> {
+    /** 模态框唯一标识 */
+    id: number;
+    /** 显示模态框，根据 ExtraValues 类型自动判断参数是否必传 */
+    show: (options?: ShowFormOptions<Values, ExtraValues>) => void;
+    /** 隐藏模态框 */
+    hide: () => void;
+    /** 模态框组件 */
+    modal: ReactNode;
+}
+declare function useFormModal<Values extends AnyObject = AnyObject, ExtraValues = Record<string, unknown>>(props: UseFormModalProps<Values, ExtraValues>): UseFormModalReturn<Values, ExtraValues>;
+
+/**
+ * Modal store hook
+ * 使用 lazy initialization 确保 create 函数在调用时已经准备好
+ */
+declare function useModalStore(): VisibilityState;
+
+interface NotFoundProps {
+    redirectUrl?: string;
+}
+declare const NotFound: FC<NotFoundProps>;
+
+declare const OperationLogList: FC;
+
+interface SignInProps {
+    extra?: ReactNode;
+    title?: string;
+    titleStyle?: CSSProperties;
+}
+declare const SignIn: FC<SignInProps>;
+
+/**
+ * 菜单管理路由配置
+ * 用于在 React Router 的 createRoutesFromElements 中使用
+ *
+ * @example
+ * ```tsx
+ * import { menuRoutes } from '@flow97/react-toolkit'
+ * import { createRoutesFromElements, Outlet, Route } from 'react-router'
+ *
+ * createRoutesFromElements(
+ *   <Route path="menu/*">
+ *     {menuRoutes}
+ *   </Route>
+ * )
+ * ```
+ */
+declare const _default$1: react_jsx_runtime.JSX.Element;
+
+/**
+ * 权限管理路由配置
+ * 用于在 React Router 的 createRoutesFromElements 中使用
+ *
+ * @example
+ * ```tsx
+ * import { permissionRoutes, PermissionRoutesWrapper } from '@flow97/react-toolkit'
+ * import { createRoutesFromElements, Route } from 'react-router'
+ *
+ * createRoutesFromElements(
+ *   <Route path="permission/*" element={<PermissionRoutesWrapper />}>
+ *     {permissionRoutes}
+ *   </Route>
+ * )
+ * ```
+ */
+declare const _default: react_jsx_runtime.JSX.Element;
+
+declare function useAuth(code?: string | string[], config?: RequestOptions): {
+    data: boolean | Record<string, boolean>;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, boolean> & {
+        has_all?: boolean;
+    }, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Record<string, boolean> & {
+        has_all?: boolean;
+    }>;
+} | {
+    data: boolean | Record<string, boolean>;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, boolean> & {
+        has_all?: boolean;
+    }, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Record<string, boolean> & {
+        has_all?: boolean;
+    }>;
+} | {
+    data: boolean | Record<string, boolean>;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, boolean> & {
+        has_all?: boolean;
+    }, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Record<string, boolean> & {
+        has_all?: boolean;
+    }>;
+} | {
+    data: boolean | Record<string, boolean>;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, boolean> & {
+        has_all?: boolean;
+    }, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Record<string, boolean> & {
+        has_all?: boolean;
+    }>;
+} | {
+    data: boolean | Record<string, boolean>;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, boolean> & {
+        has_all?: boolean;
+    }, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Record<string, boolean> & {
+        has_all?: boolean;
+    }>;
+} | {
+    data: boolean | Record<string, boolean>;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, boolean> & {
+        has_all?: boolean;
+    }, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Record<string, boolean> & {
+        has_all?: boolean;
+    }>;
+};
+declare function useMenuList(): _tanstack_react_query.UseQueryResult<MenuListItem[], Error>;
+declare const useGames: () => _tanstack_react_query.UseQueryResult<Game[], Error>;
+
+export { APP_ID_HEADER, AuthButton, type AuthButtonProps, AuthMode, DynamicTags, type DynamicTagsProps, ExpandableParagraph, type ExpandableParagraphProps, FRONTEND_ROUTE_PREFIX, FilterFormWrapper, type FilterFormWrapperProps, type Game, type GameSelectConfig, type GameSelectProps, type HeaderExtra, type HeaderExtraConfig, Highlight, type HighlightProps, InfiniteList, type InfiniteListDataAdapter, type InfiniteListPayload, type InfiniteListProps, type InfiniteListRef, type InfiniteListRequestConfig, type InfiniteListRequestConfigType, type JsonResponse, KeepAlive, type KeepAliveCacheItem, KeepAliveOutlet, type KeepAliveOutletProps, type KeepAliveProps, KeepAliveProvider, type KeepAliveProviderProps, Layout, type LayoutProps, Logo, type LogoProps, type MenuListItem, type NavItem, type NavMenuItemGroupType, type NavMenuItemType, type NavSubMenuType, type NavigationConfig, NotFound, OperationLogList, type PageParam, type Permission, QueryList, QueryListAction, type QueryListPayload, type QueryListProps, type QueryListRef, type RecursivePartial, RequireAuth, type RequireAuthProps, RequireGame, type RouteMatchRule, SSO_URL, SelectAll, type SelectAllProps, type ShowFormOptions$1 as ShowFormDrawerOptions, type ShowFormOptions as ShowFormModalOptions, SignIn, ToolkitsProvider, type ToolkitsProviderProps, type UseDrawerOperation, type UseDrawerProps, type UseFormDrawerProps, type UseFormDrawerReturn, type UseFormModalProps, type UseFormModalReturn, type UseKeepAliveReturn, type UseModalOperation, type UseModalProps, UserDropdown, type VisibilityState, WILDCARD, createVisibilityStoreConfig, generateId, _default$1 as menuRoutes, mixedStorage, _default as permissionRoutes, useAuth, useDrawer, useDrawerStore, useFormDrawer, useFormModal, useGames, useInfiniteListStore, useKeepAlive, useKeepAliveContext, useMenuList, useModal, useModalStore, useQueryListStore, useToolkitsStore };