@tsingroc/tsingroc-components 2.4.0 → 2.5.1

package/dist/components/Auth.d.ts

@@ -84,7 +84,7 @@ export interface UserInfo {
     /** 用户的全名（显示名）。*/
     name: string;
     /** 短用户名（登录名）。*/
-    prefered_username: string;
+    prefered_username?: string;
     /** 用户的邮件地址。*/
     email?: string;
     /** 用户的邮件地址是否已确认。*/
@@ -100,7 +100,10 @@ export interface UserInfo {
     /** 用户的角色。*/
     roles: string[];
 }
-/** 获取用户信息。必须在开启了 `onlineCheck` 的 {@linkcode AuthProvider} 内部使用，否则返回 `undefined`。*/
+/**
+ * 获取用户信息。必须在开启了 {@linkcode AuthProviderProps.onlineCheck | onlineCheck}
+ * 的 {@linkcode AuthProvider} 内部使用，否则返回 `undefined`。
+ */
 export declare function useUserInfo(): UserInfo | undefined;
 export interface AuthProviderProps {
     /**
@@ -116,7 +119,7 @@ export interface AuthProviderProps {
      */
     onlineCheck?: boolean;
     /**
-     * 如果开启了 `onlineCheck`，在检查过程中时向用户显示的加载界面。
+     * 如果开启了 {@linkcode AuthProviderProps.onlineCheck | onlineCheck}，在检查过程中时向用户显示的加载界面。
      * @default "正在登录……"
      */
     loading?: ReactNode;
@@ -160,3 +163,9 @@ export interface AuthCallbackProps {
 }
 /** 登录的回调页面。*/
 export declare function AuthCallback(props: AuthCallbackProps): ReactNode;
+/**
+ * 获得一个用于登出账号的函数。必须在 {@linkcode AuthProvider} 内部使用，否则在登出后将不会自动跳转。
+ *
+ * **注意**：登出后默认会自动跳转到登录页面！为了更好的用户体验，最好在调用登出之后立即跳转到网站主页或者其它合适的页面。
+ */
+export declare function useLogout(): () => void;

package/dist/components/Auth.js

@@ -19,16 +19,23 @@ export function getDecodedAccessToken() {
         return;
     return jwtDecode(token);
 }
-const AuthContext = createContext(undefined);
-/** 获取用户信息。必须在开启了 `onlineCheck` 的 {@linkcode AuthProvider} 内部使用，否则返回 `undefined`。*/
+const AuthContext = createContext({
+    recheckToken: () => { },
+});
+/**
+ * 获取用户信息。必须在开启了 {@linkcode AuthProviderProps.onlineCheck | onlineCheck}
+ * 的 {@linkcode AuthProvider} 内部使用，否则返回 `undefined`。
+ */
 export function useUserInfo() {
-    return useContext(AuthContext);
+    const { userInfo } = useContext(AuthContext);
+    return userInfo;
 }
 /**
  * 确保只有已登录的用户可以访问到内部的内容，未登录的用户将被重定向到登录界面。
  */
 export function AuthProvider(props) {
     const sdk = getCasdoorSdk(props.sdkConfig);
+    const [, recheckToken] = useState(0);
     const token = getAccessToken();
     const [userInfo, setUserInfo] = useState();
     useEffect(() => {
@@ -50,7 +57,7 @@ export function AuthProvider(props) {
             }
         }
     }, [token, props.onlineCheck]);
-    return token === null ? ("正在跳转到登录页……") : props.onlineCheck && userInfo === undefined ? ((props.loading ?? "正在登录……")) : (_jsx(AuthContext.Provider, { value: userInfo, children: props.children }));
+    return token === null ? ("正在跳转到登录页……") : props.onlineCheck && userInfo === undefined ? ((props.loading ?? "正在登录……")) : (_jsx(AuthContext.Provider, { value: { userInfo, recheckToken: () => recheckToken((i) => i + 1) }, children: props.children }));
 }
 /** 登录的回调页面。*/
 export function AuthCallback(props) {
@@ -80,4 +87,16 @@ export function AuthCallback(props) {
             : error.toString()
         : (props.children ?? "正在跳转……");
 }
+/**
+ * 获得一个用于登出账号的函数。必须在 {@linkcode AuthProvider} 内部使用，否则在登出后将不会自动跳转。
+ *
+ * **注意**：登出后默认会自动跳转到登录页面！为了更好的用户体验，最好在调用登出之后立即跳转到网站主页或者其它合适的页面。
+ */
+export function useLogout() {
+    const { recheckToken } = useContext(AuthContext);
+    return () => {
+        localStorage.removeItem("access_token");
+        recheckToken();
+    };
+}
 //# sourceMappingURL=Auth.js.map

package/dist/components/Auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"Auth.js","sourceRoot":"","sources":["../../src/components/Auth.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Auth.js","sourceRoot":"","sources":["../../src/components/Auth.tsx"],"names":[],"mappings":"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"}

package/dist/components/ImageBackground.d.ts

@@ -2,7 +2,7 @@ export interface ImageBackgroundProps extends React.HTMLAttributes<HTMLDivElemen
     /**
      * 图片的 URL。
      *
-     * 建议导入图片，然后将导入得到的地址填入 `url`，而不要硬编码地址。
+     * 建议导入图片，然后填入导入得到的地址，而不要硬编码地址。
      *
      * ```jsx
      * import img from "../public/image.png";

package/dist/components/Sidebar.d.ts

@@ -13,20 +13,23 @@ export interface SidebarProps extends MenuProps {
      */
     collapsible?: boolean;
     /**
-     * 网站 Logo 的 URL。
+     * 网站 logo 的 URL。
      *
-     * 建议导入图片，然后将导入得到的地址填入 `logo`，而不要硬编码地址。
+     * 建议导入图片，然后填入导入得到的地址，而不要硬编码地址。
      */
     logo?: string;
     /** 侧边栏的标题。*/
     title?: string;
     /**
      * 侧边栏头部（logo 和标题部分）的高度。
-     * @default 98
+     * @default 116
      */
     headerHeight?: number | string;
     /**
-     * 侧边栏的头部（logo 和标题部分）。这个属性将替换掉 `logo`、`title` 和 `headerHeight`。
+     * 侧边栏的头部（logo 和标题部分）。设置了该属性时，
+     * {@linkcode SidebarProps.logo | logo}、
+     * {@linkcode SidebarProps.title | title} 和
+     * {@linkcode SidebarProps.headerHeight | headerHeight} 将失去作用。
      * 参数 `collapsed` 表示侧边栏是否收起。
      */
     header?: (collapsed: boolean) => ReactNode;
@@ -46,11 +49,17 @@ export interface SidebarProps extends MenuProps {
     onSelect?: MenuProps["onSelect"];
     /** 子菜单展开/收起时的回调函数。 */
     onOpenChange?: MenuProps["onOpenChange"];
-    /** 侧边栏底部的额外内容。参数 `collapsed` 表示侧边栏是否收起。*/
+    /**
+     * 侧边栏底部的额外内容。参数 `collapsed` 表示侧边栏是否收起。
+     * 默认情况下使用 {@linkcode UserButton} 组件。
+     * @default (collapsed) => <UserButton compact={collapsed} />
+     */
     footer?: (collapsed: boolean) => ReactNode;
 }
 /**
  * 出自 TMS 系统的侧边栏组件。该组件需要放置在 [Ant Design 的 `Layout` 组件][1]内部才能正常工作。
+ * 如果没有提供 {@linkcode SidebarProps.footer | footer} 属性，
+ * 那么还需要包裹在 {@linkcode AuthProvider} 内才能正常显示边栏底部的用户信息按钮。
  *
  * 一般来说，使用该组件时至少需要提供 `logo`、`items` 和 `onSelect` 三个属性，具体用法请参照范例。
  *

package/dist/components/Sidebar.js

@@ -3,6 +3,9 @@ import { BarChartOutlined, LeftOutlined, RightOutlined, SwapOutlined, TeamOutlin
 import { Button, Flex, Layout, Menu } from "antd";
 import { useState } from "react";
 import { createStyles } from "antd-style";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { AuthProvider } from "./Auth";
+import UserButton from "./UserButton";
 const { Sider } = Layout;
 const menuItem = (label, key, icon, children) => ({ key, icon, children, label });
 /** 默认菜单项配置，可以作为参考或默认值 */
@@ -24,51 +27,71 @@ const DEFAULT_MENU_ITEMS = [
         menuItem("购电合约管理", "purchase-contract"),
     ]),
 ];
-const useStyles = createStyles(({ token, css, cx, prefixCls }) => {
+const useStyles = createStyles(({ token, css, cx, prefixCls }, collapsed) => {
+    const sidebarHeader = css `
+      margin-top: ${token.marginXXS}px;
+
+      > img {
+        width: 40%;
+      }
+
+      > h1 {
+        margin: ${collapsed ? 0 : token.marginXXS}px 0 0 0;
+        font-size: ${collapsed ? 0 : token.fontSize}px;
+        font-weight: normal;
+        line-height: 1;
+        transition:
+          margin-top ${token.motionDurationMid},
+          font-size ${token.motionDurationMid};
+      }
+    `;
     const sidebarMenu = css `
-    flex-basis: 100%;
-    overflow-y: auto;
-  `;
+      flex-basis: 100%;
+      overflow-y: auto;
+    `;
     const sidebarBtn = css `
-    position: absolute;
-    top: 75%;
-    right: 0;
-    transform: translate(50%, -50%);
+      position: absolute;
+      top: 75%;
+      right: 0;
+      transform: translate(50%, -50%);
 
-    font-size: ${token.sizeSM}px;
+      font-size: ${token.sizeSM}px;
 
-    transition: opacity ${token.motionDurationMid};
-    opacity: 0%;
-  `;
+      transition: opacity ${token.motionDurationMid};
+      opacity: 0%;
+    `;
     const sidebar = css `
-    position: relative;
-    box-shadow: rgba(0, 0, 0, 0.15) 0 2px 8px;
+      position: relative;
+      box-shadow: rgba(0, 0, 0, 0.15) 0 2px 8px;
 
-    & .${prefixCls}-layout-sider-children {
-      display: flex;
-      flex-direction: column;
-    }
+      > .${prefixCls}-layout-sider-children {
+        display: flex;
+        flex-direction: column;
+      }
 
-    /* 为了提高权重 */
-    & .${cx(sidebarBtn)} {
-      width: ${token.controlHeightXS}px;
-    }
-    & .${cx(sidebarMenu)}.${cx(sidebarMenu)} {
-      border-inline-end: none;
-    }
+      /* 为了提高权重 */
+      & .${cx(sidebarBtn)} {
+        width: ${token.controlHeightXS}px;
+      }
+      & .${cx(sidebarMenu)}.${cx(sidebarMenu)} {
+        border-inline-end: none;
+      }
 
-    &:hover .${cx(sidebarBtn)} {
-      opacity: 100%;
-    }
-  `;
+      &:hover .${cx(sidebarBtn)} {
+        opacity: 100%;
+      }
+    `;
     return {
         sidebar,
+        sidebarHeader,
         sidebarMenu,
         sidebarBtn,
     };
 });
 /**
  * 出自 TMS 系统的侧边栏组件。该组件需要放置在 [Ant Design 的 `Layout` 组件][1]内部才能正常工作。
+ * 如果没有提供 {@linkcode SidebarProps.footer | footer} 属性，
+ * 那么还需要包裹在 {@linkcode AuthProvider} 内才能正常显示边栏底部的用户信息按钮。
  *
  * 一般来说，使用该组件时至少需要提供 `logo`、`items` 和 `onSelect` 三个属性，具体用法请参照范例。
  *
@@ -78,13 +101,10 @@ const useStyles = createStyles(({ token, css, cx, prefixCls }) => {
  * [2]: https://ant-design.antgroup.com/components/menu-cn
  */
 function Sidebar(props) {
-    const { width = 260, collapsible = false, logo, title, headerHeight = 98, header, items = DEFAULT_MENU_ITEMS, selectedKeys, openKeys, onSelect, onOpenChange, footer, ...rest } = props;
-    const { cx, styles, theme } = useStyles();
+    const { width = 260, collapsible = false, logo, title, headerHeight = 116, header, items = DEFAULT_MENU_ITEMS, selectedKeys, openKeys, onSelect, onOpenChange, footer = (collapsed) => _jsx(UserButton, { compact: collapsed }), ...rest } = props;
     const [collapsed, setCollapsed] = useState(false);
-    return (_jsxs(Sider, { theme: "light", width: width, collapsed: collapsible ? collapsed : false, collapsible: collapsible, trigger: null, className: cx(styles.sidebar), children: [header ? (header(collapsed)) : (_jsxs(Flex, { vertical: true, align: "center", justify: "center", style: { height: headerHeight }, children: [_jsx("img", { alt: "logo", src: logo, style: { width: "40%" } }), _jsx("h1", { style: {
-                            fontSize: collapsed ? theme.fontSizeSM : theme.fontSize,
-                            transition: `font-size ${theme.motionDurationMid}`,
-                        }, children: title })] })), _jsx(Menu, { mode: "inline", selectedKeys: selectedKeys, openKeys: openKeys, onSelect: onSelect, onOpenChange: onOpenChange, items: items, inlineCollapsed: collapsible ? collapsed : false, className: cx(styles.sidebarMenu, rest.className), ...rest }), footer?.(collapsed), collapsible && (_jsx(Button, { className: cx(styles.sidebarBtn), icon: collapsed ? _jsx(RightOutlined, {}) : _jsx(LeftOutlined, {}), onClick: () => setCollapsed(!collapsed) }))] }));
+    const { cx, styles } = useStyles(collapsed);
+    return (_jsxs(Sider, { theme: "light", width: width, collapsed: collapsible ? collapsed : false, collapsible: collapsible, trigger: null, className: cx(styles.sidebar), children: [header ? (header(collapsed)) : (_jsxs(Flex, { vertical: true, align: "center", justify: "center", className: cx(styles.sidebarHeader), style: { height: headerHeight }, children: [_jsx("img", { alt: "logo", src: logo }), _jsx("h1", { children: title })] })), _jsx(Menu, { mode: "inline", selectedKeys: selectedKeys, openKeys: openKeys, onSelect: onSelect, onOpenChange: onOpenChange, items: items, inlineCollapsed: collapsible ? collapsed : false, className: cx(styles.sidebarMenu, rest.className), ...rest }), footer?.(collapsed), collapsible && (_jsx(Button, { className: cx(styles.sidebarBtn), icon: collapsed ? _jsx(RightOutlined, {}) : _jsx(LeftOutlined, {}), onClick: () => setCollapsed(!collapsed) }))] }));
 }
 export default Sidebar;
 //# sourceMappingURL=Sidebar.js.map

package/dist/components/Sidebar.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.js","sourceRoot":"","sources":["../../src/components/Sidebar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Sidebar.js","sourceRoot":"","sources":["../../src/components/Sidebar.tsx"],"names":[],"mappings":"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"}

package/dist/components/TsingrocTheme.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+export interface TsingrocThemeProps {
+    /** 是否开启黑暗模式。*/
+    dark?: boolean;
+    /** 主题覆盖的页面内容。*/
+    children: ReactNode;
+}
+/**
+ * 清鹏智能的公共 Ant Design 主题，会影响内部的所有 Ant Design 组件的样式。
+ * 请将该组件放置在整个 React 项目的顶层。
+ */
+declare function TsingrocTheme(props: TsingrocThemeProps): import("react/jsx-runtime").JSX.Element;
+export default TsingrocTheme;

package/dist/components/TsingrocTheme.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ConfigProvider, theme } from "antd";
+/**
+ * 清鹏智能的公共 Ant Design 主题，会影响内部的所有 Ant Design 组件的样式。
+ * 请将该组件放置在整个 React 项目的顶层。
+ */
+function TsingrocTheme(props) {
+    // Ant Design 主题编辑器链接：
+    // https://ant-design.antgroup.com/theme-editor-cn
+    // 色板设计工具链接：
+    // https://huetone.ardov.me/?palette=N4IgdghgtgpiBcICiAPaAHANjABABQmwBcjcBjAe3QE8QAaEACwFcYBnBAbVElgRDwBLMAGt6ISpgoAnDvE4gAxADMADDAAmygCzjFmjTGUBOPRuMAjAIww4DRWTIAOMjF32yAJgBs3jU70Lb20AVjJvPWMYTwsIdyUnAGZVVScIQNCYCwD7CDJki0S9J21ExKdTe29EmN89bW1PVW0I%2B0SQq2NE1qVPbStGkJAAXQBfOh5oOEQAQTAiABFxSRk5BX1vHWVlQIgYVW3IqzIIQ6rLKzOlbVVjTZ37K28AdmerxVuQp3M9J9f3xLOKI5JR-N4PUEhELaCAaX7QqzPOyQmohCy-KyeaFDR5WKwQTxkEajYYMIgUMDsLggAAyqnENKsDM8DKKDBp8RpONpPUA3HKADIzAE5B4gWPQW3IW8QWbJACxZDAWTIV9LGQA
+    return (_jsx(ConfigProvider, { theme: {
+            algorithm: props.dark ? theme.darkAlgorithm : theme.defaultAlgorithm,
+            token: props.dark
+                ? {
+                    colorPrimaryBg: "#241425",
+                    colorPrimaryBgHover: "#351936",
+                    colorPrimaryBorder: "#442046",
+                    colorPrimaryBorderHover: "#632b66",
+                    colorPrimaryHover: "#b45eb8",
+                    colorPrimary: "#b93fc0",
+                    colorPrimaryActive: "#843389",
+                    colorPrimaryTextHover: "#b45eb8",
+                    colorInfo: "#b93fc0",
+                    colorPrimaryTextActive: "#843389",
+                    colorLinkHover: "#632b66",
+                    colorLinkActive: "#843389",
+                }
+                : {
+                    colorPrimaryBg: "#f3f0f7",
+                    colorPrimaryBgHover: "#eddef9",
+                    colorPrimaryBorder: "#d9b1ee",
+                    colorPrimaryBorderHover: "#cc8ce4",
+                    colorPrimaryHover: "#c266d8",
+                    colorPrimary: "#b645c6",
+                    colorPrimaryActive: "#9e2ba4",
+                    colorPrimaryTextHover: "#c266d8",
+                    colorInfo: "#b645c6",
+                    colorPrimaryTextActive: "#9e2ba4",
+                    colorLinkHover: "#cc8ce4",
+                    colorLinkActive: "#9e2ba4",
+                },
+        }, children: props.children }));
+}
+export default TsingrocTheme;
+//# sourceMappingURL=TsingrocTheme.js.map

package/dist/components/TsingrocTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsingrocTheme.js","sourceRoot":"","sources":["../../src/components/TsingrocTheme.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAU7C;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAyB;IAC9C,sBAAsB;IACtB,kDAAkD;IAClD,YAAY;IACZ,oeAAoe;IACpe,OAAO,CACL,KAAC,cAAc,IACb,KAAK,EAAE;YACL,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB;YACpE,KAAK,EAAE,KAAK,CAAC,IAAI;gBACf,CAAC,CAAC;oBACE,cAAc,EAAE,SAAS;oBACzB,mBAAmB,EAAE,SAAS;oBAC9B,kBAAkB,EAAE,SAAS;oBAC7B,uBAAuB,EAAE,SAAS;oBAClC,iBAAiB,EAAE,SAAS;oBAC5B,YAAY,EAAE,SAAS;oBACvB,kBAAkB,EAAE,SAAS;oBAC7B,qBAAqB,EAAE,SAAS;oBAChC,SAAS,EAAE,SAAS;oBACpB,sBAAsB,EAAE,SAAS;oBACjC,cAAc,EAAE,SAAS;oBACzB,eAAe,EAAE,SAAS;iBAC3B;gBACH,CAAC,CAAC;oBACE,cAAc,EAAE,SAAS;oBACzB,mBAAmB,EAAE,SAAS;oBAC9B,kBAAkB,EAAE,SAAS;oBAC7B,uBAAuB,EAAE,SAAS;oBAClC,iBAAiB,EAAE,SAAS;oBAC5B,YAAY,EAAE,SAAS;oBACvB,kBAAkB,EAAE,SAAS;oBAC7B,qBAAqB,EAAE,SAAS;oBAChC,SAAS,EAAE,SAAS;oBACpB,sBAAsB,EAAE,SAAS;oBACjC,cAAc,EAAE,SAAS;oBACzB,eAAe,EAAE,SAAS;iBAC3B;SACN,YAEA,KAAK,CAAC,QAAQ,GACA,CAClB,CAAC;AACJ,CAAC;AAED,eAAe,aAAa,CAAC"}

package/dist/components/UserButton.d.ts

@@ -0,0 +1,45 @@
+import { type ButtonProps, type DropdownProps } from "antd";
+import { type UserInfo } from "./Auth";
+export interface UserButtonProps extends ButtonProps {
+    /**
+     * 是否显示为缩小形态（只显示头像）。
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * 用户的信息。
+     *
+     * 若省略，则将通过 {@linkcode useUserInfo} 获取，
+     * 这意味着该组件必须放置在启用了 {@linkcode AuthProviderProps.onlineCheck | onlineCheck}
+     * 的 {@linkcode AuthProvider} 内部。
+     *
+     * @default useUserInfo()
+     */
+    userInfo?: Partial<UserInfo>;
+    /** 打开账户页面的回调。若省略，将不显示弹出菜单中的“账户”选项。*/
+    onOpenProfile?: () => void;
+    /**
+     * 登出操作的回调。
+     *
+     * 若省略，则将使用 {@linkcode useLogout}，这意味着该组件必须放置在 {@linkcode AuthProvider} 内部。
+     *
+     * @default useLogout()
+     */
+    onLogout?: () => void;
+    /**
+     * 下拉菜单的属性，见 [Ant Design 文档][1]。
+     *
+     * [1]: https://ant-design.antgroup.com/components/dropdown-cn
+     */
+    dropdownProps?: DropdownProps;
+}
+/**
+ * 显示用户信息的按钮，点击弹出登出或跳转到账户页的菜单。
+ * 默认设置下，该组件必须包裹在 {@linkcode AuthProvider} 内才能正常工作。
+ *
+ * 除了文档中列出的属性以外，该组件会把额外的属性传递给内部的 [`Button`][1] 组件。
+ *
+ * [1]: https://ant-design.antgroup.com/components/button-cn
+ */
+declare function UserButton(props: UserButtonProps): import("react/jsx-runtime").JSX.Element;
+export default UserButton;

package/dist/components/UserButton.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, Button, Dropdown, theme, } from "antd";
+import { LogoutOutlined, UpOutlined, UserOutlined } from "@ant-design/icons";
+import { 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+AuthProvider, useLogout, useUserInfo, } from "./Auth";
+/**
+ * 显示用户信息的按钮，点击弹出登出或跳转到账户页的菜单。
+ * 默认设置下，该组件必须包裹在 {@linkcode AuthProvider} 内才能正常工作。
+ *
+ * 除了文档中列出的属性以外，该组件会把额外的属性传递给内部的 [`Button`][1] 组件。
+ *
+ * [1]: https://ant-design.antgroup.com/components/button-cn
+ */
+function UserButton(props) {
+    const { token } = theme.useToken();
+    const { compact, 
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    userInfo = useUserInfo(), onOpenProfile, 
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    onLogout = useLogout(), dropdownProps, ...rest } = props;
+    return (_jsx(Dropdown, { trigger: ["click"], placement: "topLeft", ...dropdownProps, menu: {
+            items: [
+                onOpenProfile
+                    ? {
+                        key: "profile",
+                        label: _jsx(_Fragment, { children: "\u8D26\u6237" }), // 如果使用字符串，在缩小时会被裁剪，即使宽度足够
+                        icon: _jsx(UserOutlined, {}),
+                        title: "", // 若不设置，在缩小时总是会显示工具提示，即使宽度足够
+                        onClick: onOpenProfile,
+                    }
+                    : null,
+                {
+                    key: "logout",
+                    icon: _jsx(LogoutOutlined, {}),
+                    label: _jsx(_Fragment, { children: "\u767B\u51FA" }),
+                    title: "",
+                    onClick: onLogout,
+                },
+            ],
+            ...dropdownProps?.menu,
+            style: {
+                minWidth: "100%",
+                ...dropdownProps?.menu?.style,
+            },
+        }, children: _jsx(Button, { type: "text", icon: _jsx(Avatar, { src: userInfo?.picture, icon: _jsx(UserOutlined, {}) }), ...rest, style: {
+                width: "auto",
+                margin: token.marginXXS,
+                padding: token.paddingXXS,
+                ...rest.styles,
+            }, children: !compact && (_jsxs(_Fragment, { children: [userInfo?.name ?? userInfo?.prefered_username ?? "平台用户", _jsx(UpOutlined, { style: { marginLeft: token.marginXXS } })] })) }) }));
+}
+export default UserButton;
+//# sourceMappingURL=UserButton.js.map

package/dist/components/UserButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserButton.js","sourceRoot":"","sources":["../../src/components/UserButton.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,MAAM,EACN,MAAM,EAEN,QAAQ,EAER,KAAK,GACN,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO;AACL,6DAA6D;AAC7D,YAAY,EAGZ,SAAS,EAET,WAAW,GACZ,MAAM,QAAQ,CAAC;AAoChB;;;;;;;GAOG;AACH,SAAS,UAAU,CAAC,KAAsB;IACxC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IACnC,MAAM,EACJ,OAAO;IACP,sDAAsD;IACtD,QAAQ,GAAG,WAAW,EAAE,EACxB,aAAa;IACb,sDAAsD;IACtD,QAAQ,GAAG,SAAS,EAAE,EACtB,aAAa,EACb,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IACV,OAAO,CACL,KAAC,QAAQ,IACP,OAAO,EAAE,CAAC,OAAO,CAAC,EAClB,SAAS,EAAC,SAAS,KACf,aAAa,EACjB,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,aAAa;oBACX,CAAC,CAAC;wBACE,GAAG,EAAE,SAAS;wBACd,KAAK,EAAE,6CAAO,EAAE,0BAA0B;wBAC1C,IAAI,EAAE,KAAC,YAAY,KAAG;wBACtB,KAAK,EAAE,EAAE,EAAE,4BAA4B;wBACvC,OAAO,EAAE,aAAa;qBACvB;oBACH,CAAC,CAAC,IAAI;gBACR;oBACE,GAAG,EAAE,QAAQ;oBACb,IAAI,EAAE,KAAC,cAAc,KAAG;oBACxB,KAAK,EAAE,6CAAO;oBACd,KAAK,EAAE,EAAE;oBACT,OAAO,EAAE,QAAQ;iBAClB;aACF;YACD,GAAG,aAAa,EAAE,IAAI;YACtB,KAAK,EAAE;gBACL,QAAQ,EAAE,MAAM;gBAChB,GAAG,aAAa,EAAE,IAAI,EAAE,KAAK;aAC9B;SACF,YAED,KAAC,MAAM,IACL,IAAI,EAAC,MAAM,EACX,IAAI,EAAE,KAAC,MAAM,IAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAC,YAAY,KAAG,GAAI,KAC5D,IAAI,EACR,KAAK,EAAE;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,KAAK,CAAC,SAAS;gBACvB,OAAO,EAAE,KAAK,CAAC,UAAU;gBACzB,GAAG,IAAI,CAAC,MAAM;aACf,YAEA,CAAC,OAAO,IAAI,CACX,8BACG,QAAQ,EAAE,IAAI,IAAI,QAAQ,EAAE,iBAAiB,IAAI,MAAM,EACxD,KAAC,UAAU,IAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,GAAI,IACrD,CACJ,GACM,GACA,CACZ,CAAC;AACJ,CAAC;AAED,eAAe,UAAU,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { getCasdoorSdk, getAccessToken, getDecodedAccessToken, useUserInfo, AuthProvider, type AuthProviderProps, AuthCallback, type AuthCallbackProps, } from "./components/Auth";
+export { getCasdoorSdk, getAccessToken, getDecodedAccessToken, useUserInfo, AuthProvider, type AuthProviderProps, AuthCallback, type AuthCallbackProps, useLogout, } from "./components/Auth";
 export { default as Calendar, type CalendarProps } from "./components/Calendar";
 export { default as CircularProgress, type CircularProgressProps, } from "./components/CircularProgress";
 export { default as ImageBackground, type ImageBackgroundProps, } from "./components/ImageBackground";
@@ -10,3 +10,5 @@ default as TmsSidebar, type SidebarProps,
 /** @deprecated 该名称已弃用，请改为导入 `SidebarProps`。*/
 type SidebarProps as TmsSidebarProps, } from "./components/Sidebar";
 export { default as TsingrocDatePicker, type DatePickerProps, } from "./components/TsingrocDatePicker";
+export { default as TsingrocTheme, type TsingrocThemeProps, } from "./components/TsingrocTheme";
+export { default as UserButton, type UserButtonProps, } from "./components/UserButton";

package/dist/index.js

@@ -1,4 +1,4 @@
-export { getCasdoorSdk, getAccessToken, getDecodedAccessToken, useUserInfo, AuthProvider, AuthCallback, } from "./components/Auth";
+export { getCasdoorSdk, getAccessToken, getDecodedAccessToken, useUserInfo, AuthProvider, AuthCallback, useLogout, } from "./components/Auth";
 export { default as Calendar } from "./components/Calendar";
 export { default as CircularProgress, } from "./components/CircularProgress";
 export { default as ImageBackground, } from "./components/ImageBackground";
@@ -8,4 +8,6 @@ export { default as Sidebar,
 /** @deprecated 该名称已弃用，请改为导入 `Sidebar`。*/
 default as TmsSidebar, } from "./components/Sidebar";
 export { default as TsingrocDatePicker, } from "./components/TsingrocDatePicker";
+export { default as TsingrocTheme, } from "./components/TsingrocTheme";
+export { default as UserButton, } from "./components/UserButton";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,YAAY,EAEZ,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAsB,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EACL,OAAO,IAAI,gBAAgB,GAE5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,OAAO,IAAI,eAAe,GAE3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,OAAO,IAAI,oBAAoB,GAEhC,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,OAAO,IAAI,gBAAgB,EAC3B,gBAAgB,GAEjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,OAAO,IAAI,OAAO;AAClB,yCAAyC;AACzC,OAAO,IAAI,UAAU,GAItB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,OAAO,IAAI,kBAAkB,GAE9B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,YAAY,EAEZ,YAAY,EAEZ,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAsB,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EACL,OAAO,IAAI,gBAAgB,GAE5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,OAAO,IAAI,eAAe,GAE3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,OAAO,IAAI,oBAAoB,GAEhC,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,OAAO,IAAI,gBAAgB,EAC3B,gBAAgB,GAEjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,OAAO,IAAI,OAAO;AAClB,yCAAyC;AACzC,OAAO,IAAI,UAAU,GAItB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,OAAO,IAAI,kBAAkB,GAE9B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,OAAO,IAAI,aAAa,GAEzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,OAAO,IAAI,UAAU,GAEtB,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsingroc/tsingroc-components",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,21 +38,21 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",
-    "@rsbuild/core": "^1.3.7",
+    "@rsbuild/core": "^1.3.9",
     "@rsbuild/plugin-react": "^1.2.0",
     "@rspress/plugin-preview": "^2.0.0-alpha.0",
     "@types/node": "^22.14.1",
     "@types/react": "^18.3.20",
     "@types/react-dom": "^18.3.6",
     "echarts-for-react": "^3.0.2",
-    "eslint": "^9.24.0",
+    "eslint": "^9.25.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "globals": "^16.0.0",
     "prettier": "^3.5.3",
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1",
     "rspress": "^2.0.0-alpha.8",
-    "typedoc": "^0.28.2",
+    "typedoc": "^0.28.3",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.30.1"
   },