@oj-module/runtime 0.1.20 → 0.1.21

package/dist/hooks/use-tab-key/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 本页自己的页签 key（`removeTrailingSlash(pathname)`），供 `setTableTitle` /
+ * `resetTableTitle` / `addTab` 定位页签。
+ *
+ * keepAlive 陷阱：keepalive-for-react 把页面缓存在隐藏 portal 里，而 LocationContext
+ * 在 KeepAlive **之上**——切 tab 时缓存树随**激活页**位置重渲染，缓存页里的
+ * `useLocation()` 返回的是别家页签的路径。若拿它当页签 key，`setTableTitle` 会把
+ * 本页标题写到当前激活页签上（最后打开的文档页把之后切换到的每个页签都改成自己的标题）。
+ *
+ * 页签存活期内 key 不变（宿主 cacheKey = pathname+search，一页一路径），故首渲染
+ * （此时本页必是激活页）捕获一次即可；缓存树后续多少次重渲染都不会漂移。
+ * 需要跟随导航的位置信息请直接用 `useLocation`，不要用本 hook。
+ */
+export declare function useTabKey(): string;

package/dist/index.d.ts

@@ -26,6 +26,7 @@ export { PageError } from "./components/page-error";
 export * from "./constants/options";
 export * from "./hooks/use-access";
 export { usePreferences } from "./hooks/use-preferences";
+export { useTabKey } from "./hooks/use-tab-key";
 export * from "./icons";
 export { LayoutEffects } from "./layout/layout-effects";
 export { setupI18n } from "./locales";

package/dist/runtime.js

@@ -255,10 +255,10 @@ function getAppInfo() {
 	return {
 		"pkg": {
 			"name": "@oj-module/runtime",
-			"version": "0.1.20",
+			"version": "0.1.21",
 			"license": "MIT"
 		},
-		"lastBuildTime": "2026-10-15 16:50:57"
+		"lastBuildTime": "2026-10-15 18:45:29"
 	};
 }
 var init_get_app_info = __esmMin((() => {}));
@@ -9372,6 +9372,28 @@ function getBooleanOptions(t) {
 	}];
 }
 //#endregion
+//#region src/hooks/use-tab-key/index.ts
+init_remove_trailing_slash();
+/**
+* 本页自己的页签 key（`removeTrailingSlash(pathname)`），供 `setTableTitle` /
+* `resetTableTitle` / `addTab` 定位页签。
+*
+* keepAlive 陷阱：keepalive-for-react 把页面缓存在隐藏 portal 里，而 LocationContext
+* 在 KeepAlive **之上**——切 tab 时缓存树随**激活页**位置重渲染，缓存页里的
+* `useLocation()` 返回的是别家页签的路径。若拿它当页签 key，`setTableTitle` 会把
+* 本页标题写到当前激活页签上（最后打开的文档页把之后切换到的每个页签都改成自己的标题）。
+*
+* 页签存活期内 key 不变（宿主 cacheKey = pathname+search，一页一路径），故首渲染
+* （此时本页必是激活页）捕获一次即可；缓存树后续多少次重渲染都不会漂移。
+* 需要跟随导航的位置信息请直接用 `useLocation`，不要用本 hook。
+*/
+function useTabKey() {
+	const { pathname } = useLocation();
+	const keyRef = useRef(void 0);
+	if (keyRef.current === void 0) keyRef.current = removeTrailingSlash(pathname);
+	return keyRef.current;
+}
+//#endregion
 //#region src/module-loader/define-module.ts
 /**
 * 声明一个模块。
@@ -27441,4 +27463,4 @@ init_ri();
 init_menu_icons();
 init_tree();
 //#endregion
-export { AccessControl, AccessControlRoles, AntdApp, BasicButton, BasicContent, BasicTable, EmbeddedIcon, ErrorBoundary, ExternalIcon, FormAvatarItem, FormTreeItem, Iframe, LayoutCenterIcon, LayoutEffects, LayoutLeftIcon, LayoutRightIcon, MixedNavigationIcon, OutsidePageIcon, PageError, ProfileCardIcon, RiAccountCircleLine, RiContrastFill, RiFullscreenExitLine, RiFullscreenLine, RiMailCheckLine, RiMoonIcon, RiReactjsLine, RiSunIcon, RiUserSettingsLine, ServerErrorIcon, SideNavigationIcon, TopNavigationIcon, TwoColumnNavigationIcon, accessControlCodes, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLogin, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, handleTree, loadAll, mapTree, menuIcons, notify, permissionPrefix, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useTabsStore, useUserStore, external_exports as z };
+export { AccessControl, AccessControlRoles, AntdApp, BasicButton, BasicContent, BasicTable, EmbeddedIcon, ErrorBoundary, ExternalIcon, FormAvatarItem, FormTreeItem, Iframe, LayoutCenterIcon, LayoutEffects, LayoutLeftIcon, LayoutRightIcon, MixedNavigationIcon, OutsidePageIcon, PageError, ProfileCardIcon, RiAccountCircleLine, RiContrastFill, RiFullscreenExitLine, RiFullscreenLine, RiMailCheckLine, RiMoonIcon, RiReactjsLine, RiSunIcon, RiUserSettingsLine, ServerErrorIcon, SideNavigationIcon, TopNavigationIcon, TwoColumnNavigationIcon, accessControlCodes, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLogin, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, handleTree, loadAll, mapTree, menuIcons, notify, permissionPrefix, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useTabKey, useTabsStore, useUserStore, external_exports as z };

package/package.json

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