@oj-module/runtime 0.2.18 → 0.2.23

package/dist/components/access-control/index.d.ts

@@ -9,6 +9,10 @@ interface AccessControlProps {
  * 权限验证组件
  *
  * @param AccessControlProps 权限验证组件的属性
+ * @param AccessControlProps.type 权限类型，默认为 code
+ * @param AccessControlProps.codes 权限值，可以是字符串或字符串数组
+ * @param AccessControlProps.children 有权限时渲染的子组件
+ * @param AccessControlProps.fallback 无权限时显示的内容
  * @returns 若子组件存在，并且传入的权限值有效，则返回子组件；否则返回 null
  */
 export declare function AccessControl({ type, codes, children, fallback }: AccessControlProps): ReactNode;

package/dist/components/fullscreen-button/index.d.ts

@@ -8,10 +8,10 @@ export interface FullscreenButtonProps extends Omit<ButtonProps, "target"> {
 /**
  * 全屏按钮组件
  *
- * @param target 全屏目标元素
- * @param fullscreenIcon 全屏时图标
- * @param fullscreenExitIcon 退出全屏时图标
- * @param restProps 其他属性
+ * @param target 组件属性（解构自 FullscreenButtonProps）
+ * @param target.target 全屏目标元素
+ * @param target.fullscreenIcon 全屏时图标
+ * @param target.fullscreenExitIcon 退出全屏时图标
  * @returns 返回全屏按钮组件
  */
 export declare const FullscreenButton: React.FC<FullscreenButtonProps>;

package/dist/hooks/use-layout-style/index.d.ts

@@ -5,7 +5,7 @@ import type { VisibleDomRect } from "../../utils/dom/index";
  * @en Get the style of the layout content area
  */
 export declare function useLayoutContentStyle(): {
-    contentElement: import("#node_modules/@types/react").RefObject<HTMLDivElement | null>;
+    contentElementRef: import("#node_modules/@types/react").RefObject<HTMLDivElement | null>;
     overlayStyle: CSSProperties;
     visibleDomRect: VisibleDomRect | null;
 };

package/dist/router/extra-info/route-path.d.ts

@@ -17,6 +17,7 @@ export declare const exceptionUnknownComponentPath = "/exception/not-found-compo
  * 子路径部署（/oj/wiki/...）下直接与 loginPath 比较恒为 false，401 时会重复 goLogin。
  * React 组件内请用 `useLocation()`（react-router 已剥离 basename），无需本函数。
  *
+ * @param pathname 原始路径（含部署 base，如 `location.pathname`）
  * @param base 部署 base，恒以 `/` 结尾；缺省取 `resolveSiteBase()`（部署期注入优先，
  * 见 utils/site-base.ts —— runtime 产物里的 `import.meta.env.BASE_URL` 是构建期
  * 内联的 `/`，子路径部署下直接用它恒错）

package/dist/runtime.js

@@ -204,6 +204,7 @@ var init_site_base = __esmMin((() => {
 * 子路径部署（/oj/wiki/...）下直接与 loginPath 比较恒为 false，401 时会重复 goLogin。
 * React 组件内请用 `useLocation()`（react-router 已剥离 basename），无需本函数。
 *
+* @param pathname 原始路径（含部署 base，如 `location.pathname`）
 * @param base 部署 base，恒以 `/` 结尾；缺省取 `resolveSiteBase()`（部署期注入优先，
 * 见 utils/site-base.ts —— runtime 产物里的 `import.meta.env.BASE_URL` 是构建期
 * 内联的 `/`，子路径部署下直接用它恒错）
@@ -303,10 +304,10 @@ function getAppInfo() {
 	return {
 		"pkg": {
 			"name": "@oj-module/runtime",
-			"version": "0.2.18",
+			"version": "0.2.23",
 			"license": "MIT"
 		},
-		"lastBuildTime": "2026-10-21 22:40:24"
+		"lastBuildTime": "2026-10-22 18:50:31"
 	};
 }
 var init_get_app_info = __esmMin((() => {}));
@@ -429,7 +430,7 @@ function PageError({ error, resetErrorBoundary }) {
 	};
 	useEffect(() => {
 		if (enableDynamicTitle) document.title = t("exception.pageErrorTitle");
-	}, [enableDynamicTitle]);
+	}, [enableDynamicTitle, t]);
 	return /* @__PURE__ */ jsx(Result, {
 		status: "error",
 		icon: /* @__PURE__ */ jsx("div", {
@@ -3495,7 +3496,7 @@ function useCurrentRoute() {
 	const matches = useMatches();
 	return useMemo(() => {
 		return matches[matches.length - 1];
-	}, [matches, location]);
+	}, [matches]);
 }
 var init_use_current_route = __esmMin((() => {}));
 //#endregion
@@ -3595,7 +3596,7 @@ function useCssVar(name, root = defaultRoot, options = {}) {
 	}), [name, root]);
 	useEffect(() => {
 		if (options?.initialValue) controls.set(options.initialValue);
-	}, [options?.initialValue]);
+	}, [options?.initialValue, controls]);
 	useEffect(() => {
 		return () => controls.remove();
 	}, [controls]);
@@ -3656,7 +3657,7 @@ var init_dom = __esmMin((() => {}));
 * @en Get the style of the layout content area
 */
 function useLayoutContentStyle() {
-	const contentElement = useRef(null);
+	const contentElementRef = useRef(null);
 	const [visibleDomRect, setVisibleDomRect] = useState(null);
 	const resizeObserverRef = useRef(null);
 	const contentHeightControls = useCssVar(CSS_VARIABLE_LAYOUT_CONTENT_HEIGHT);
@@ -3673,7 +3674,7 @@ function useLayoutContentStyle() {
 		};
 	}, [visibleDomRect]);
 	const debouncedCalcHeight = useDebounceFn((_entries) => {
-		const rect = getElementVisibleRect(contentElement.current);
+		const rect = getElementVisibleRect(contentElementRef.current);
 		setVisibleDomRect(rect);
 		if (rect) {
 			contentHeightControls.set(`${rect.height}px`);
@@ -3681,10 +3682,10 @@ function useLayoutContentStyle() {
 		}
 	}, { wait: 16 });
 	useEffect(() => {
-		if (contentElement.current && !resizeObserverRef.current) {
+		if (contentElementRef.current && !resizeObserverRef.current) {
 			const resizeObserver = new ResizeObserver(debouncedCalcHeight.run);
 			resizeObserverRef.current = resizeObserver;
-			resizeObserver.observe(contentElement.current);
+			resizeObserver.observe(contentElementRef.current);
 		}
 		return () => {
 			resizeObserverRef.current?.disconnect();
@@ -3692,7 +3693,7 @@ function useLayoutContentStyle() {
 		};
 	}, [debouncedCalcHeight]);
 	return {
-		contentElement,
+		contentElementRef,
 		overlayStyle,
 		visibleDomRect
 	};
@@ -4173,7 +4174,7 @@ function KeepAliveLayer() {
 		(aliveRef.current?.getCacheNodes?.())?.forEach((node) => {
 			if (!openTabs.has(node.cacheKey)) aliveRef.current?.destroy(node.cacheKey);
 		});
-	}, [openTabs]);
+	}, [openTabs, aliveRef]);
 	/**
 	* 关闭多 tab 功能时，清空所有非当前页面缓存
 	*/
@@ -4181,10 +4182,18 @@ function KeepAliveLayer() {
 		if (!tabbarEnable) (aliveRef.current?.getCacheNodes?.())?.forEach((node) => {
 			if (node.cacheKey !== cacheKey) aliveRef.current?.destroy(node.cacheKey);
 		});
-	}, [tabbarEnable]);
+	}, [
+		tabbarEnable,
+		aliveRef,
+		cacheKey
+	]);
 	useEffect(() => {
 		if (tabbarEnable && isRefresh) aliveRef.current?.refresh();
-	}, [isRefresh]);
+	}, [
+		isRefresh,
+		aliveRef,
+		tabbarEnable
+	]);
 	const keepAliveExclude = useMemo(() => {
 		/**
 		* 不开启多 tab 时不需要 KeepAlive，把所有路由放进 exclude 仅保留切换动画
@@ -4212,7 +4221,7 @@ var init_keep_alive_layer = __esmMin((() => {
 //#region src/layout/layout-content/index.tsx
 function LayoutContent() {
 	const { token: { colorBgLayout } } = theme.useToken();
-	const { contentElement } = useLayoutContentStyle();
+	const { contentElementRef } = useLayoutContentStyle();
 	const enableFooter = usePreferencesStore((state) => state.enableFooter);
 	const fixedFooter = usePreferencesStore((state) => state.fixedFooter);
 	/**
@@ -4221,7 +4230,7 @@ function LayoutContent() {
 	*/
 	return /* @__PURE__ */ jsx("main", {
 		id: ELEMENT_ID_MAIN_CONTENT,
-		ref: contentElement,
+		ref: contentElementRef,
 		className: "relative overflow-y-auto overflow-x-hidden grow",
 		style: { backgroundColor: colorBgLayout },
 		children: /* @__PURE__ */ jsx(Scrollbar, { children: /* @__PURE__ */ jsx(GlobalSpin, { children: /* @__PURE__ */ jsxs("div", {
@@ -4447,7 +4456,11 @@ function GlobalSearch() {
 	useKeyPress("downarrow", handleDown);
 	useEffect(() => {
 		if (!keyword.length && Array.isArray(searchHistory)) setResultOptions(searchMenuList.filter((item) => searchHistory?.includes(item.key)));
-	}, [keyword, searchHistory]);
+	}, [
+		keyword,
+		searchHistory,
+		searchMenuList
+	]);
 	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("div", {
 		onClick: () => setOpen((open) => !open),
 		className: "group flex justify-center items-center gap-2 md:bg-colorBgLayout px-3 py-1.5 rounded-full cursor-pointer text-colorTextSecondary hover:text-colorText md:mr-2.5",
@@ -5113,18 +5126,18 @@ function Sidebar() {
 				name: item.name,
 				checked: item.value,
 				onChange: handleChange,
-				children: item.label,
-				disabled: item.disabled
+				disabled: item.disabled,
+				children: item.label
 			}, item.name);
 		}),
 		/* @__PURE__ */ jsx(SwitchItem, {
 			name: "sidebarTheme",
 			checked: sidebarTheme === "light",
 			onChange: (name, value) => setPreferences(name, value ? "light" : "dark"),
-			children: t("preferences.sidebar.sidebarTheme"),
 			disabled: !sidebarEnable,
 			unCheckedChildren: /* @__PURE__ */ jsx(RiContrastFill, {}),
-			checkedChildren: /* @__PURE__ */ jsx(RiMoonIcon, {})
+			checkedChildren: /* @__PURE__ */ jsx(RiMoonIcon, {}),
+			children: t("preferences.sidebar.sidebarTheme")
 		}),
 		/* @__PURE__ */ jsx(NumberInputSpinner, {
 			min: 40,
@@ -5702,7 +5715,7 @@ function UserMenu({ ...restProps }) {
 		}
 		if (key === "personal-center") navigate("/personal-center/my-profile");
 	};
-	const altView = useMemo(() => isWindowsOs() ? "Alt" : "⌥", [isWindowsOs]);
+	const altView = useMemo(() => isWindowsOs() ? "Alt" : "⌥", []);
 	const items = [{
 		label: t("personal-center:menu.personalCenter"),
 		key: "personal-center",
@@ -5973,7 +5986,7 @@ function LayoutMenu({ mode = "inline", autoExpandCurrentMenu, handleMenuSelect,
 		isMobile,
 		sidebarCollapsed
 	]);
-	const handleOpenChange = (keys) => {
+	const handleOpenChange = useCallback((keys) => {
 		/**
 		* 1. 手风琴模式，点击菜单项，自动关闭其他菜单
 		* 2. 非手风琴模式且菜单是收起的，鼠标悬浮菜单自动关闭其他菜单
@@ -5992,7 +6005,12 @@ function LayoutMenu({ mode = "inline", autoExpandCurrentMenu, handleMenuSelect,
 				if (currentCloseKey) setOpenKeys(menuParentKeys[currentCloseKey]);
 			}
 		} else setOpenKeys(keys);
-	};
+	}, [
+		accordion,
+		sidebarCollapsed,
+		openKeys,
+		menuParentKeys
+	]);
 	const menuOpenProps = useMemo(() => {
 		if (autoExpandCurrentMenu) return {
 			openKeys,
@@ -6019,7 +6037,8 @@ function LayoutMenu({ mode = "inline", autoExpandCurrentMenu, handleMenuSelect,
 	}, [
 		matches,
 		sidebarCollapsed,
-		getSelectedKeys
+		getSelectedKeys,
+		accordion
 	]);
 	return /* @__PURE__ */ jsx(Menu, {
 		/**
@@ -6552,7 +6571,6 @@ function useDropdownMenu() {
 	}, [
 		t,
 		activeKey,
-		homePath,
 		openTabs
 	]);
 	/**
@@ -6569,6 +6587,8 @@ function useDropdownMenu() {
 		[TabActionKeys.CLOSE_OTHERS]: closeOtherTabs,
 		[TabActionKeys.CLOSE_ALL]: closeAllTabs
 	}), [
+		refresh,
+		setIsRefresh,
 		removeTab,
 		closeRightTabs,
 		closeLeftTabs,
@@ -6814,7 +6834,7 @@ function LayoutTabbar() {
 			hash: ""
 		};
 		navigate(key + historyState.search + historyState.hash);
-	}, [openTabs]);
+	}, [openTabs, navigate]);
 	/**
 	* 处理标签页编辑（关闭）
 	* @param {React.MouseEvent | React.KeyboardEvent | string} key - 被编辑的标签页的key
@@ -6941,7 +6961,8 @@ function LayoutTabbar() {
 		location,
 		currentRoute,
 		setActiveKey,
-		addTab
+		addTab,
+		activeKey
 	]);
 	return /* @__PURE__ */ jsx("div", {
 		className: classes.tabsContainer,
@@ -7023,7 +7044,7 @@ function ContainerLayout() {
 		if (screens.lg && !screens.xl) setPreferences("sidebarCollapsed", true);
 		else if (screens.xl) setPreferences("sidebarCollapsed", false);
 		else if (screens.xs || screens.sm && !screens.md) setPreferences("sidebarCollapsed", false);
-	}, [screens]);
+	}, [screens, setPreferences]);
 	const sidebarEnableState = useMemo(() => !isTopNav && sidebarEnable, [isTopNav, sidebarEnable]);
 	const computedSidebarWidth = useMemo(() => {
 		if (isMaximize || isMobile) return 0;
@@ -7049,7 +7070,7 @@ function ContainerLayout() {
 		let height = 48;
 		if (tabbarEnable) height += 35;
 		return height;
-	}, [tabbarEnable, 35]);
+	}, [tabbarEnable]);
 	useEffect(() => {
 		setLayoutHeaderHeight(isMaximize ? 35 : headerWrapperHeight);
 	}, [headerWrapperHeight, isMaximize]);
@@ -7934,7 +7955,7 @@ async function generateRoutesFromBackend(backendRoutes) {
 	/**
 	* 转换路由配置
 	* @param route 原始路由配置
-	* @param parentPath 父级路径（用于嵌套路由）
+	* @param parentComponentPath 父级组件路径（用于嵌套路由）
 	* @returns 转换后的路由配置
 	*/
 	const transformRoute = async (route, parentComponentPath) => {
@@ -8918,8 +8939,6 @@ var init_remember_route = __esmMin((() => {
 * 必须带上部署 base（`resolveSiteBase()`）：子路径部署下 `location.href = "/login"`
 * 会跳到宿主机根，而不是 `/oj/login`。不能用 `import.meta.env.BASE_URL`——预构建
 * 产物里它是构建期内联的 `/`。
-*
-* @returns 无返回值
 */
 function goLogin() {
 	useAuthStore.getState().reset();
@@ -9022,6 +9041,8 @@ function onRefreshFailed(error) {
 * 订阅者对象应包含 resolve 和 reject 方法。
 *
 * @param subscriber 订阅者对象，包含 resolve 和 reject 方法
+* @param subscriber.resolve 当 token 刷新成功时调用的函数，传入新的 token
+* @param subscriber.reject 当 token 刷新失败时调用的函数，传入错误信息
 */
 function addRefreshSubscriber(subscriber) {
 	refreshSubscribers.push(subscriber);
@@ -9447,6 +9468,10 @@ function useAccess() {
 * 权限验证组件
 *
 * @param AccessControlProps 权限验证组件的属性
+* @param AccessControlProps.type 权限类型，默认为 code
+* @param AccessControlProps.codes 权限值，可以是字符串或字符串数组
+* @param AccessControlProps.children 有权限时渲染的子组件
+* @param AccessControlProps.fallback 无权限时显示的内容
 * @returns 若子组件存在，并且传入的权限值有效，则返回子组件；否则返回 null
 */
 function AccessControl({ type = "code", codes, children, fallback }) {
@@ -9800,7 +9825,7 @@ function BasicTable(props) {
 		if (enableFooter && fixedFooter) return 40;
 		return 0;
 	}, [enableFooter, fixedFooter]);
-	const getPaginationProps = () => {
+	const getPaginationProps = useCallback(() => {
 		if (props.pagination === false) return false;
 		return {
 			placement: ["bottomStart"],
@@ -9810,7 +9835,7 @@ function BasicTable(props) {
 			showTotal: (total) => t("common.pagination", { total }),
 			...props.pagination
 		};
-	};
+	}, [props.pagination, t]);
 	/**
 	* @description 计算分页器的高度
 	* 如果分页器被禁用，则返回 0，否则根据分页器的大小返回相应的高度

package/dist/utils/request/go-login.d.ts

@@ -4,7 +4,5 @@
  * 必须带上部署 base（`resolveSiteBase()`）：子路径部署下 `location.href = "/login"`
  * 会跳到宿主机根，而不是 `/oj/login`。不能用 `import.meta.env.BASE_URL`——预构建
  * 产物里它是构建期内联的 `/`。
- *
- * @returns 无返回值
  */
 export declare function goLogin(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oj-module/runtime",
   "type": "module",
-  "version": "0.2.18",
+  "version": "0.2.23",
   "description": "React Antd Admin 框架运行时，供模块工程消费",
   "license": "MIT",
   "imports": {