react-toolkits 2.30.3 → 2.31.0

package/lib/index.d.ts

@@ -1,9 +1,9 @@
 import { ButtonProps, SelectProps, FormInstance, DrawerProps, Button, FormProps, ModalProps } from 'antd';
-import { Options, KyInstance } from 'ky';
 import { FC, PropsWithChildren, Key, ReactNode, ReactElement, Ref, DetailedHTMLProps, ImgHTMLAttributes, ComponentProps } from 'react';
+import { Options, KyInstance } from 'ky';
 import { ParagraphProps } from 'antd/es/typography/Paragraph';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { useLocation } from 'react-router-dom';
+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';
@@ -12,13 +12,160 @@ import { StateCreator } from 'zustand';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { StateStorage } from 'zustand/middleware';
 
+/** 成功响应状态码字段类型 */
+type StatusField = 'code' | 'status' | 'errno';
+/** 响应类型 */
+type ResponseType = 'json' | 'blob' | 'text' | 'arrayBuffer' | 'formData';
+/** 通用请求选项接口 */
+interface RequestOptions extends Options {
+    responseType?: ResponseType;
+    /** 是否使用全局模式（覆盖 context 中的 isGlobalMode） */
+    isGlobalMode?: boolean;
+}
+/** 业务状态码字段配置 */
+interface BusinessStatusCodeConfig {
+    /** 成功状态码列表，默认为 [0, 1, 200] */
+    successCodes?: readonly number[];
+    /** 需要检查的业务状态码字段，默认为 ['code', 'status', 'errno'] */
+    statusFields?: readonly StatusField[];
+}
+/** 错误消息提取配置 */
+interface ErrorMessageConfig {
+    /** 错误消息字段列表（按优先级），默认为 ['msg', 'message', 'error'] */
+    errorFields?: readonly string[];
+    /** 自定义错误消息提取函数，优先级高于 errorFields */
+    extractErrorMessage?: (data: unknown) => string;
+}
+/** HTTP 状态码错误处理回调 */
+interface HttpErrorHandlers {
+    /** 401 未授权处理 */
+    onUnauthorized?: (data?: unknown) => void;
+    /** 403 禁止访问处理 */
+    onForbidden?: (data?: unknown) => void;
+    /** 412 未注册处理 */
+    onUnregistered?: (data?: unknown) => void;
+    /** 其他 HTTP 错误处理 */
+    onError?: (status: number, data?: unknown, errorMessage?: string) => void;
+    /** 网络错误处理 */
+    onNetworkError?: (error: Error) => void;
+}
+/** 响应验证配置 */
+interface ResponseValidationConfig {
+    /** 自定义响应成功判断函数，优先级高于业务状态码配置 */
+    isSuccess?: (data: unknown, status: number) => boolean;
+}
+/** React 上下文信息接口 */
+interface KyClientContext {
+    token?: string;
+    isGlobalMode?: boolean;
+    loginPath?: string;
+    apiBaseUrl?: string;
+    appId?: string | number;
+    clear?: () => void;
+    notifyError?: (title: string, description: string) => void;
+}
+/** KyClient 构造函数配置 */
+interface KyClientOptions extends BusinessStatusCodeConfig, ErrorMessageConfig, HttpErrorHandlers, ResponseValidationConfig {
+    /** 基础 URL */
+    baseURL?: string;
+    /** 是否禁用默认的错误提示（notification），默认为 false */
+    disableDefaultErrorNotification?: boolean;
+    /** React 上下文信息 */
+    context?: KyClientContext;
+}
+/** HTTP客户端方法接口 */
+interface KyMethods {
+    get: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
+    post: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    put: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    delete: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
+    patch: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    options: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
+    head: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
+    request: <T = unknown>(options: RequestOptions & {
+        url: string;
+    }) => Promise<T>;
+    instance: KyInstance;
+}
+/**
+ * Ky HTTP 客户端类
+ * 封装了基于 ky 的 HTTP 请求逻辑，包括认证、错误处理、响应验证等
+ */
+declare class KyClient implements KyMethods {
+    private readonly _instance;
+    private readonly businessConfig;
+    private readonly errorConfig;
+    private readonly errorHandlers;
+    private context?;
+    private readonly disableDefaultErrorNotification;
+    constructor(options?: KyClientOptions);
+    /** 获取 ky 实例（用于高级用法） */
+    get instance(): KyInstance;
+    get: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
+    post: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    put: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    delete: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
+    patch: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    options: <T = unknown>(url: string, requestOptions?: RequestOptions) => Promise<T>;
+    head: <T = unknown>(url: string, requestOptions?: RequestOptions) => Promise<T>;
+    request: <T = unknown>(requestOptions: RequestOptions & {
+        url: string;
+    }) => Promise<T>;
+    /**
+     * 通用请求处理函数
+     */
+    private makeRequest;
+    /**
+     * 创建响应处理函数
+     */
+    private createResponseHandler;
+    /**
+     * 请求前处理：设置认证和 appId headers
+     */
+    private handleBeforeRequest;
+    /**
+     * 错误前处理：处理 HTTP 状态码错误
+     */
+    private handleBeforeError;
+    /**
+     * 处理 HTTP 状态码错误
+     */
+    private handleHttpStatusError;
+    /**
+     * 默认处理未授权错误
+     */
+    private defaultHandleUnauthorized;
+    /**
+     * 默认处理未注册错误
+     */
+    private defaultHandleUnregistered;
+    /**
+     * 默认处理禁止访问错误
+     */
+    private defaultHandleForbidden;
+}
+/**
+ * 在组件中使用 KyClient 的 Hook
+ * 创建新的 KyClient 实例，并从 ToolkitsProvider 获取 context
+ * 这样可以确保每个组件使用正确的 context（特别是 isGlobalMode）
+ *
+ * @example
+ * import { useKyClient } from '@/libs'
+ *
+ * function MyComponent() {
+ *   const { get, post } = useKyClient()
+ *   // 使用 get, post 等方法
+ * }
+ */
+declare function useKyClient(): KyClient;
+
 interface AuthButtonProps extends ButtonProps {
     /** 权限码，支持单个或多个 */
     code?: string | string[];
     /** 加载时是否显示 loading 状态 */
     showLoading?: boolean;
     /** 请求配置 */
-    config?: Options;
+    config?: RequestOptions;
 }
 /**
  * 授权按钮组件
@@ -100,34 +247,12 @@ interface KeepAliveOutletProps {
     disabled?: boolean;
     /** 自定义缓存 key 前缀，用于区分不同的 KeepAliveOutlet 实例 */
     cacheKeyPrefix?: string;
+    /** 是否启用路由切换过渡动画，默认 true */
+    enableTransition?: boolean;
+    /** 过渡动画时长（毫秒），默认 200 */
+    transitionDuration?: number;
 }
-/**
- * KeepAliveOutlet 组件
- * 路由级别的 KeepAlive，自动缓存所有通过 Outlet 渲染的组件
- * 使用 React 19 Activity API 实现，避免路由切换时组件被销毁
- * 支持嵌套路由，每个层级的 outlet 都有独立的缓存
- *
- * @example
- * ```tsx
- * // 单层路由
- * <Route path="/" element={<Layout />}>
- *   <KeepAliveProvider maxCache={10}>
- *     <KeepAliveOutlet />
- *   </KeepAliveProvider>
- * </Route>
- *
- * // 嵌套路由
- * <Route path="/" element={<Layout />}>
- *   <KeepAliveProvider maxCache={10}>
- *     <KeepAliveOutlet />
- *     <Route path="list" element={<ListLayout />}>
- *       <KeepAliveOutlet /> // 嵌套的 outlet，会自动使用不同的缓存 key
- *     </Route>
- *   </KeepAliveProvider>
- * </Route>
- * ```
- */
-declare const KeepAliveOutlet: ({ disabled, cacheKeyPrefix }: KeepAliveOutletProps) => react_jsx_runtime.JSX.Element;
+declare const KeepAliveOutlet: ({ disabled, cacheKeyPrefix, enableTransition, transitionDuration, }: KeepAliveOutletProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * KeepAlive 缓存项
@@ -219,29 +344,16 @@ type Merge<Object1, Object2> = Prettify<Omit<Object1, keyof Object2> & Object2>;
 
 type MarkRequired<Type, Keys extends keyof Type> = Type extends Type ? Prettify<Type & Required<Omit<Type, Exclude<keyof Type, Keys>>>> : never;
 
-type Area = 'all' | 'cn' | 'global';
-type ScreenOrientation = 0 | 1;
 interface Game {
-    id: number;
     game_id: string | number;
-    game_group: string;
-    name: string;
-    screen_type: ScreenOrientation;
-    area: Area;
-    icon: string;
-    auth: string;
-    ctime: string;
-    mtime: string;
-    is_delete: 0 | 1;
-    is_new_game: 0 | 1;
-    server_type: string;
+    [key: string]: any;
 }
 /**
  * 导航菜单项类型
  * 扩展 antd MenuItemType，添加路由支持
  */
 type NavMenuItemType = Merge<MenuItemType, {
-    /** react-router-dom 路由地址，用于菜单项点击时跳转 */
+    /** react-router 路由地址，用于菜单项点击时跳转 */
     route?: string;
 }>;
 /**
@@ -294,15 +406,19 @@ interface NavigationConfig {
     /** 菜单加载状态 */
     loading?: boolean;
 }
-/** 路由匹配规则类型 */
-type RouteMatchRule = string | RegExp;
+/** 路由匹配规则类型
+ * 支持：
+ * - 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[];
 }
 /** Layout 组件属性 */
@@ -411,6 +527,8 @@ interface InfiniteListRequestConfig<Values = any, PageParamType = PageParam> ext
     searchParams?: RequestParamsResolver<Values, PageParamType>;
     /** 请求头，可以是静态对象或动态函数 */
     headers?: Record<string, string> | ((form: FormInstance<Values>) => Record<string, string>);
+    /** 是否为全局模式请求 */
+    isGlobalMode?: boolean;
 }
 /**
  * 无限列表请求配置类型
@@ -614,6 +732,8 @@ interface QueryListRequestConfig extends CacheConfig {
     body?: FormData | Record<string | number, any>;
     searchParams?: Record<string | number, any>;
     headers?: Record<string, string>;
+    /** 是否使用全局模式（覆盖 ToolkitsProvider 中的 isGlobalMode） */
+    isGlobalMode?: boolean;
 }
 /**
  * 请求配置类型
@@ -1171,146 +1291,6 @@ declare function useFormModal<Values extends AnyObject = AnyObject, ExtraValues
  */
 declare function useModalStore(): VisibilityState;
 
-/** 成功响应状态码字段类型 */
-type StatusField = 'code' | 'status' | 'errno';
-/** 响应类型 */
-type ResponseType = 'json' | 'blob' | 'text' | 'arrayBuffer' | 'formData';
-/** 通用请求选项接口 */
-interface RequestOptions extends Options {
-    responseType?: ResponseType;
-}
-/** 业务状态码字段配置 */
-interface BusinessStatusCodeConfig {
-    /** 成功状态码列表，默认为 [0, 1, 200] */
-    successCodes?: readonly number[];
-    /** 需要检查的业务状态码字段，默认为 ['code', 'status', 'errno'] */
-    statusFields?: readonly StatusField[];
-}
-/** 错误消息提取配置 */
-interface ErrorMessageConfig {
-    /** 错误消息字段列表（按优先级），默认为 ['msg', 'message', 'error'] */
-    errorFields?: readonly string[];
-    /** 自定义错误消息提取函数，优先级高于 errorFields */
-    extractErrorMessage?: (data: unknown) => string;
-}
-/** HTTP 状态码错误处理回调 */
-interface HttpErrorHandlers {
-    /** 401 未授权处理 */
-    onUnauthorized?: (data?: unknown) => void;
-    /** 403 禁止访问处理 */
-    onForbidden?: (data?: unknown) => void;
-    /** 412 未注册处理 */
-    onUnregistered?: (data?: unknown) => void;
-    /** 其他 HTTP 错误处理 */
-    onError?: (status: number, data?: unknown, errorMessage?: string) => void;
-    /** 网络错误处理 */
-    onNetworkError?: (error: Error) => void;
-}
-/** 响应验证配置 */
-interface ResponseValidationConfig {
-    /** 自定义响应成功判断函数，优先级高于业务状态码配置 */
-    isSuccess?: (data: unknown, status: number) => boolean;
-}
-/** React 上下文信息接口 */
-interface KyClientContext {
-    token?: string;
-    isGlobalMode?: boolean;
-    loginPath?: string;
-    apiBaseUrl?: string;
-    appId?: string | number;
-    clear?: () => void;
-    notifyError?: (title: string, description: string) => void;
-}
-/** KyClient 构造函数配置 */
-interface KyClientOptions extends BusinessStatusCodeConfig, ErrorMessageConfig, HttpErrorHandlers, ResponseValidationConfig {
-    /** 基础 URL */
-    baseURL?: string;
-    /** 是否禁用默认的错误提示（notification），默认为 false */
-    disableDefaultErrorNotification?: boolean;
-    /** React 上下文信息 */
-    context?: KyClientContext;
-}
-/** HTTP客户端方法接口 */
-interface KyMethods {
-    get: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
-    post: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    put: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    delete: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
-    patch: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    options: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
-    head: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
-    request: <T = unknown>(options: RequestOptions & {
-        url: string;
-    }) => Promise<T>;
-    instance: KyInstance;
-}
-/**
- * Ky HTTP 客户端类
- * 封装了基于 ky 的 HTTP 请求逻辑，包括认证、错误处理、响应验证等
- */
-declare class KyClient implements KyMethods {
-    private readonly _instance;
-    private readonly businessConfig;
-    private readonly errorConfig;
-    private readonly errorHandlers;
-    private context?;
-    private readonly disableDefaultErrorNotification;
-    constructor(options?: KyClientOptions);
-    /** 获取 ky 实例（用于高级用法） */
-    get instance(): KyInstance;
-    get: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
-    post: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    put: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    delete: <T = unknown>(url: string, options?: RequestOptions) => Promise<T>;
-    patch: <T = unknown>(url: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    options: <T = unknown>(url: string, requestOptions?: RequestOptions) => Promise<T>;
-    head: <T = unknown>(url: string, requestOptions?: RequestOptions) => Promise<T>;
-    request: <T = unknown>(requestOptions: RequestOptions & {
-        url: string;
-    }) => Promise<T>;
-    /**
-     * 通用请求处理函数
-     */
-    private makeRequest;
-    /**
-     * 创建响应处理函数
-     */
-    private createResponseHandler;
-    /**
-     * 请求前处理：设置认证和 appId headers
-     */
-    private handleBeforeRequest;
-    /**
-     * 错误前处理：处理 HTTP 状态码错误
-     */
-    private handleBeforeError;
-    /**
-     * 处理 HTTP 状态码错误
-     */
-    private handleHttpStatusError;
-    /**
-     * 默认处理未授权错误
-     */
-    private defaultHandleUnauthorized;
-    /**
-     * 默认处理未注册错误
-     */
-    private defaultHandleUnregistered;
-    /**
-     * 默认处理禁止访问错误
-     */
-    private defaultHandleForbidden;
-    /**
-     * 更新上下文信息
-     * 用于在运行时更新 context（例如在 React 组件中从 context 获取最新信息）
-     */
-    updateContext(context: KyClientContext): void;
-}
-
-declare const _default$1: react_jsx_runtime.JSX.Element;
-
-declare const _default: react_jsx_runtime.JSX.Element;
-
 interface NotFoundProps {
     redirectUrl?: string;
 }
@@ -1324,7 +1304,43 @@ interface SignInProps {
 }
 declare const SignIn: FC<SignInProps>;
 
-declare function useAuth(code?: string | string[], config?: Options): {
+/**
+ * 菜单管理路由配置
+ * 用于在 React Router 的 createRoutesFromElements 中使用
+ *
+ * @example
+ * ```tsx
+ * import { menuRoutes } from 'react-toolkits'
+ * 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 'react-toolkits'
+ * 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;
@@ -1514,4 +1530,4 @@ declare function useAuth(code?: string | string[], config?: Options): {
 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, type BusinessStatusCodeConfig, DynamicTags, type DynamicTagsProps, type ErrorMessageConfig, ExpandableParagraph, type ExpandableParagraphProps, FRONTEND_ROUTE_PREFIX, FilterFormWrapper, type FilterFormWrapperProps, type Game, type GameSelectConfig, type GameSelectProps, type HeaderExtra, type HeaderExtraConfig, Highlight, type HighlightProps, type HttpErrorHandlers, 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, KyClient, type KyClientContext, type KyClientOptions, Layout, type LayoutProps, Logo, type LogoProps, type MenuListItem, type NavItem, type NavMenuItemGroupType, type NavMenuItemType, type NavSubMenuType, type NavigationConfig, NotFound, OperationLogList, type PageParam, type Permission, PermissionMode, QueryList, QueryListAction, type QueryListPayload, type QueryListProps, type QueryListRef, type RecursivePartial, RequireAuth, type RequireAuthProps, RequireGame, type ResponseType, type ResponseValidationConfig, 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 menu, mixedStorage, _default as permission, useAuth, useDrawer, useDrawerStore, useFormDrawer, useFormModal, useGames, useInfiniteListStore, useKeepAlive, useKeepAliveContext, useMenuList, useModal, useModalStore, useQueryListStore, useToolkitsStore };
+export { APP_ID_HEADER, AuthButton, type AuthButtonProps, type BusinessStatusCodeConfig, DynamicTags, type DynamicTagsProps, type ErrorMessageConfig, ExpandableParagraph, type ExpandableParagraphProps, FRONTEND_ROUTE_PREFIX, FilterFormWrapper, type FilterFormWrapperProps, type Game, type GameSelectConfig, type GameSelectProps, type HeaderExtra, type HeaderExtraConfig, Highlight, type HighlightProps, type HttpErrorHandlers, 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, KyClient, type KyClientContext, type KyClientOptions, Layout, type LayoutProps, Logo, type LogoProps, type MenuListItem, type NavItem, type NavMenuItemGroupType, type NavMenuItemType, type NavSubMenuType, type NavigationConfig, NotFound, OperationLogList, type PageParam, type Permission, PermissionMode, QueryList, QueryListAction, type QueryListPayload, type QueryListProps, type QueryListRef, type RecursivePartial, RequireAuth, type RequireAuthProps, RequireGame, type ResponseType, type ResponseValidationConfig, 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, useKyClient, useMenuList, useModal, useModalStore, useQueryListStore, useToolkitsStore };