@flow97/react-toolkit 0.0.10 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # react-toolkits
 
+## 0.1.1
+
+### Patch Changes
+
+- 70ab18a:
+
+## 0.1.0
+
+### Minor Changes
+
+- c968c89: refactor: enhance navigation component with permission support
+
+### Patch Changes
+
+- 5dbf4e5: refactor: enhance QueryList component with error handling configuration
+
 ## 0.0.10
 
 ### Patch Changes

package/lib/index.d.ts

@@ -246,11 +246,13 @@ interface Game {
 }
 /**
  * 导航菜单项类型
- * 扩展 antd MenuItemType，添加路由支持
+ * 扩展 antd MenuItemType，添加路由和权限支持
  */
 type NavMenuItemType = Merge<MenuItemType, {
     /** react-router 路由地址，用于菜单项点击时跳转 */
     route?: string;
+    /** 权限码，用于 useAuth 检测，无权限时该项自动隐藏 */
+    code?: string;
 }>;
 /**
  * 导航子菜单类型
@@ -259,6 +261,8 @@ type NavMenuItemType = Merge<MenuItemType, {
 interface NavSubMenuType extends Omit<SubMenuType, 'children'> {
     /** 子菜单项数组，支持嵌套结构 */
     children?: NavItem[];
+    /** 权限码，用于 useAuth 检测，无权限时该子菜单及子项自动隐藏 */
+    code?: string;
 }
 /**
  * 导航菜单组类型
@@ -267,6 +271,8 @@ interface NavSubMenuType extends Omit<SubMenuType, 'children'> {
 interface NavMenuItemGroupType extends Omit<MenuItemGroupType, 'children'> {
     /** 菜单组内的菜单项数组 */
     children?: NavItem[];
+    /** 权限码，用于 useAuth 检测，无权限时该菜单组及子项自动隐藏 */
+    code?: string;
 }
 /**
  * 导航项联合类型
@@ -687,6 +693,15 @@ interface QueryListDataAdapter<Item extends AnyObject = AnyObject> {
  * @template Data 响应数据类型
  */
 type QueryListDataAdapterConfig<Item extends AnyObject = AnyObject, Data = ListResponse<Item>> = QueryListDataAdapter<Item> | ((data: Data) => QueryListDataAdapter<Item>);
+/**
+ * 错误处理配置
+ * - formatError: 抛错时，返回 string 则显示，null 则不显示；未提供则用默认逻辑并显示
+ * - getErrorFromSuccess: 成功响应中检测业务错误，返回非空 string 则显示并转为错误
+ */
+interface QueryListErrorConfig<Data = unknown> {
+    formatError?: (error: Error, data?: unknown) => string | null;
+    getErrorFromSuccess?: (data: Data) => string | null;
+}
 /**
  * QueryList 组件的 Props
  * @template Item 列表项类型
@@ -722,6 +737,8 @@ interface QueryListProps<Item extends AnyObject = AnyObject, Values = AnyObject,
     dataAdapter?: QueryListDataAdapterConfig<Item, Data>;
     /** 表格底部内容 */
     footer?: (data: Data | undefined) => ReactNode;
+    /** 错误处理配置 */
+    errorConfig?: QueryListErrorConfig<Data>;
 }
 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>>;
@@ -1508,4 +1525,4 @@ declare function useAuth(code?: string | string[], config?: RequestOptions): {
 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 AuthConfig, AuthMode, CheckEndpoint, 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, ToolkitProvider, type ToolkitProviderProps, 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, toolkitStore, useAuth, useAuthConfig, useAuthMode, useDrawer, useDrawerStore, useFormDrawer, useFormModal, useGames, useInfiniteListStore, useIsDirectRole, useIsGameScoped, useIsGroupBased, useIsRoleWithGame, useKeepAlive, useKeepAliveContext, useMenuList, useModal, useModalStore, useQueryListStore, useToolkitStore };
+export { APP_ID_HEADER, AuthButton, type AuthButtonProps, type AuthConfig, AuthMode, CheckEndpoint, 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 QueryListErrorConfig, 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, ToolkitProvider, type ToolkitProviderProps, 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, toolkitStore, useAuth, useAuthConfig, useAuthMode, useDrawer, useDrawerStore, useFormDrawer, useFormModal, useGames, useInfiniteListStore, useIsDirectRole, useIsGameScoped, useIsGroupBased, useIsRoleWithGame, useKeepAlive, useKeepAliveContext, useMenuList, useModal, useModalStore, useQueryListStore, useToolkitStore };