@oj-module/runtime 0.2.2 → 0.2.5

package/dist/api/rbac/helpers.d.ts

@@ -1,3 +1,4 @@
+import type { RbacSettingItem } from "./types";
 /** 展示名：title 缺省回落机器名。 */
 export declare function roleLabel(role: {
     name: string;
@@ -26,3 +27,20 @@ export declare function groupByModule<T extends {
     module: string;
     items: T[];
 }>;
+/** 设置卡片（系统设置页三层嵌套渲染单元，R20）：框架卡 module=null，方案卡带所属方案名。 */
+export interface RbacSettingCard {
+    /** 方案模块名；框架卡为 null（标题走 system:setting.group.*，与 C4 现状一致） */
+    module: string | null;
+    /** settings 组 id（sys_setting.group 列） */
+    group: string;
+    /** 卡片标题 i18n key：方案卡 = `<module>:settings.group.<group>`（C2-22 组标题契约）；框架卡 null */
+    label_key: string | null;
+    items: RbacSettingItem[];
+}
+/**
+ * 设置行按模块三层嵌套分组（R20/R24，纯函数）：框架卡在前（按 group 列聚合、保持服务端
+ * `order by group, key` 次序），方案卡在后（module 名升序、组内按 group 列聚合）。
+ * 不按 key 首段切组——框架 seed 存在无点号键（ldap_base_dn），首段不是其模块名；
+ * module 列是落库的所有权真源。空行降级返回空数组。
+ */
+export declare function groupSettingsByModule(rows: RbacSettingItem[]): RbacSettingCard[];

package/dist/api/rbac/index.d.ts

@@ -1,4 +1,4 @@
-import type { AuthSessionPayload, LoginMethods, RbacContact, RbacOplogPage, RbacPermission, RbacRole, RbacSettingGroup, RbacUser } from "./types";
+import type { AuthSessionPayload, LoginMethods, RbacContact, RbacOplogPage, RbacOplogWrite, RbacPermission, RbacRole, RbacSettingGroup, RbacUser, SolutionRouteRow } from "./types";
 export * from "./types";
 export declare const fetchRbacRoleList: () => Promise<RbacRole[]>;
 export declare const fetchRbacPermissionList: () => Promise<RbacPermission[]>;
@@ -25,8 +25,12 @@ export declare function fetchRbacOplog(query: {
     module?: string;
     limit?: number;
 }): Promise<RbacOplogPage>;
+export declare const fetchRbacOplogPost: (body: RbacOplogWrite) => Promise<{
+    ok: boolean;
+}>;
 export declare const fetchRbacSettings: () => Promise<RbacSettingGroup[]>;
 export declare const fetchRbacUpdateSetting: (key: string, value: string) => Promise<unknown>;
+export declare const fetchSolutionRoutes: () => Promise<SolutionRouteRow[]>;
 export declare function fetchRbacContacts(keyword: string, limit?: number): Promise<RbacContact[]>;
 export declare const fetchRbacContactDetail: (id: number) => Promise<RbacContact & {
     email: string | null;

package/dist/api/rbac/types.d.ts

@@ -61,9 +61,30 @@ export interface RbacSettingGroup {
     group: string;
     items: RbacSettingItem[];
 }
+/** 方案路由行（GET /api/_platform/solutions/routes；P1-14/R21 前端归并数据源，登录即可只读端点） */
+export interface SolutionRouteRow {
+    path: string;
+    module: string;
+    category: "main" | "admin" | "hidden";
+    order: number;
+    title_key: string | null;
+    /** 仅供深检对比，前端不做权限级菜单过滤（R22：后端 403 硬执行） */
+    required_permission: string | null;
+    /** false = 禁用：仅菜单层过滤（hideInMenu），路由可达性归装载层（D12） */
+    enabled: boolean;
+}
 export interface LoginMethods {
     methods: Array<"local" | "ldap" | "sso">;
 }
+/** 操作日志写端入参（POST /api/system/oplog；module 为调用方自身模块名）。脱敏红线：detail 不得含口令/密钥/token。 */
+export interface RbacOplogWrite {
+    action: string;
+    module: string;
+    version?: string;
+    target?: string;
+    detail?: unknown;
+    level?: number;
+}
 /** 登录响应（auth/login、auth/refresh、auth/password 同形） */
 export interface AuthSessionPayload {
     access_token: string;

package/dist/api/user/types.d.ts

@@ -6,6 +6,11 @@ export interface AuthType {
 export interface LoginInfo {
     username: string;
     password: string;
+    /**
+     * 登录方式：local=本地口令（默认），ldap=目录登录；sso 走重定向不参与本载荷。
+     * 仅用于把 POST 路由到正确后端端点（auth/login vs auth/ldap-login），默认 local。
+     */
+    method?: "local" | "ldap" | "sso";
 }
 export interface UserInfoType {
     id: string;

package/dist/index.d.ts

@@ -42,12 +42,14 @@ export type { NotificationsApiProvider, SystemApiProvider, UploadApiProvider, }
 export { useAuthStore } from "./store/auth";
 export type { AuthProvider } from "./store/auth-provider";
 export type { HeaderProvider } from "./store/header-provider";
+export { useSolutionRoutes } from "./store/solution-routes";
 export { useTabsStore } from "./store/tabs";
 export { useUserStore } from "./store/user";
 export type { AppInfo } from "./types/app-info";
 export { getAllExpandedKeys } from "./utils/get-all-expanded-keys";
 export { getAppInfo } from "./utils/get-app-info";
 export { getRedirectPath } from "./utils/get-redirect-path";
+export { request } from "./utils/request";
 export * from "./utils/tree";
 export type { NoticeCategory, NoticeItem, PushBroadcastInput, PushInput, } from "@oj-module/runtime/notify";
 export { ErrorBoundary } from "react-error-boundary";

package/dist/router/routes/index.d.ts

@@ -23,6 +23,7 @@ declare const baseRoutes: ({
         login?: boolean;
         internal?: boolean;
         hideInMenu?: boolean;
+        category?: "main" | "admin" | "hidden";
         iframeLink?: string;
         externalLink?: string;
         ignoreAccess?: boolean;
@@ -71,6 +72,7 @@ declare const baseRoutes: ({
         login?: boolean;
         internal?: boolean;
         hideInMenu?: boolean;
+        category?: "main" | "admin" | "hidden";
         iframeLink?: string;
         externalLink?: string;
         ignoreAccess?: boolean;

package/dist/router/types.d.ts

@@ -61,6 +61,12 @@ export interface RouteMeta {
      * 是否在菜单中隐藏，用于控制某些路由不在侧边栏菜单中显示
      */
     hideInMenu?: boolean;
+    /**
+     * 方案路由分类（P1-14/R21 三值归并，源自 sys_solution_route.category，经
+     * mergeSolutionCategories 注写）：main=常规组、admin=管理组、hidden=不进菜单。
+     * 框架/后端路由未归并时缺省。
+     */
+    category?: "main" | "admin" | "hidden";
     /**
      * iframe链接，如果路由需要在iframe中加载外部页面时使用
      */

package/dist/router/utils/ascending.d.ts

@@ -12,6 +12,7 @@ export declare function ascending(arr: AppRouteRecordRaw[]): ({
         login?: boolean;
         internal?: boolean;
         hideInMenu?: boolean;
+        category?: "main" | "admin" | "hidden";
         iframeLink?: string;
         externalLink?: string;
         ignoreAccess?: boolean;
@@ -60,6 +61,7 @@ export declare function ascending(arr: AppRouteRecordRaw[]): ({
         login?: boolean;
         internal?: boolean;
         hideInMenu?: boolean;
+        category?: "main" | "admin" | "hidden";
         iframeLink?: string;
         externalLink?: string;
         ignoreAccess?: boolean;

package/dist/router/utils/merge-solution-categories.d.ts

@@ -0,0 +1,21 @@
+import type { SolutionRouteRow } from "../../api/rbac/types";
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * 归并产物：路由 + 方案分类注记（P1-14/R21 三值归并）。
+ * 形状与 AppRouteRecordRaw 相同，handle 上多出 category（及 hideInMenu/order 覆写）。
+ */
+export type AnnotatedRoute = AppRouteRecordRaw;
+/**
+ * 方案路由归并（纯函数，R21）：按 path 把 sys_solution_route 行注记到已注册路由上。
+ *
+ * - 三值 category 原样落 handle.category（main=常规组、admin=管理组、hidden=不进菜单）；
+ * - hidden 与 enabled=0（禁用）复用既有 hideInMenu 通路——只过滤菜单层，路由仍可达
+ *   （禁用的路由摘除归装载层三处同写，D12）；
+ * - order 覆写为声明序：框架项保留 100 间隔带、方案项从 200 起编，共用一条序轴；
+ * - 未匹配路由（框架/后端）原样保留（同一对象引用），入参不突变；
+ * - solRoutes 为空（端点失败/未登录降级空表）时原样返回——降级不阻断，路由照常。
+ *
+ * title 不在此覆写：entry.ts 是模块元数据唯一来源（module-loader 既有惯例），
+ * title_key 随行下发仅供深检对比。
+ */
+export declare function mergeSolutionCategories(routes: AppRouteRecordRaw[], solRoutes: SolutionRouteRow[]): AnnotatedRoute[];

package/dist/runtime.js

@@ -201,7 +201,8 @@ function mapAuthPayload(data) {
 	};
 }
 function fetchLogin(data) {
-	return request.post("auth/login", { json: data }).json().then((env) => mapAuthPayload(env.data));
+	const path = data.method === "ldap" ? "auth/ldap-login" : "auth/login";
+	return request.post(path, { json: data }).json().then((env) => mapAuthPayload(env.data));
 }
 function fetchLogout(data) {
 	return request.post("auth/logout", { json: { refresh_token: data?.refreshToken ?? "" } }).json().then(() => {});
@@ -255,10 +256,10 @@ function getAppInfo() {
 	return {
 		"pkg": {
 			"name": "@oj-module/runtime",
-			"version": "0.2.2",
+			"version": "0.2.5",
 			"license": "MIT"
 		},
-		"lastBuildTime": "2026-10-16 22:08:56"
+		"lastBuildTime": "2026-10-19 10:55:08"
 	};
 }
 var init_get_app_info = __esmMin((() => {}));
@@ -8321,6 +8322,39 @@ function generateMenuItemsFromRoutes(routeList, parentPath = "/") {
 }
 var init_generate_menu_items_from_routes = __esmMin((() => {}));
 //#endregion
+//#region src/router/utils/merge-solution-categories.ts
+/**
+* 方案路由归并（纯函数，R21）：按 path 把 sys_solution_route 行注记到已注册路由上。
+*
+* - 三值 category 原样落 handle.category（main=常规组、admin=管理组、hidden=不进菜单）；
+* - hidden 与 enabled=0（禁用）复用既有 hideInMenu 通路——只过滤菜单层，路由仍可达
+*   （禁用的路由摘除归装载层三处同写，D12）；
+* - order 覆写为声明序：框架项保留 100 间隔带、方案项从 200 起编，共用一条序轴；
+* - 未匹配路由（框架/后端）原样保留（同一对象引用），入参不突变；
+* - solRoutes 为空（端点失败/未登录降级空表）时原样返回——降级不阻断，路由照常。
+*
+* title 不在此覆写：entry.ts 是模块元数据唯一来源（module-loader 既有惯例），
+* title_key 随行下发仅供深检对比。
+*/
+function mergeSolutionCategories(routes, solRoutes) {
+	if (solRoutes.length === 0) return routes;
+	const byPath = new Map(solRoutes.map((r) => [r.path, r]));
+	return routes.map((route) => {
+		const row = route.path ? byPath.get(route.path) : void 0;
+		if (!row) return route;
+		return {
+			...route,
+			handle: {
+				...route.handle,
+				category: row.category,
+				order: row.order,
+				hideInMenu: row.category === "hidden" || !row.enabled || (route.handle.hideInMenu ?? false)
+			}
+		};
+	});
+}
+var init_merge_solution_categories = __esmMin((() => {}));
+//#endregion
 //#region src/router/utils/resolve-login-route.ts
 /**
 * 内外 login 路由去重（P3，login 模块化）：唯一合成入口（SRP/DRY），
@@ -8380,18 +8414,20 @@ var init_access = __esmMin((() => {
 	init_ascending();
 	init_flatten_routes();
 	init_generate_menu_items_from_routes();
+	init_merge_solution_categories();
 	init_resolve_login_route();
 	initialState$1 = {
 		wholeMenus: generateMenuItemsFromRoutes(baseRoutes),
 		routeList: baseRoutes,
 		flatRouteList: flattenRoutes(baseRoutes),
-		isAccessChecked: false
+		isAccessChecked: false,
+		solutionRoutes: []
 	};
 	lastRegisteredRoutes = [];
-	useAccessStore = create((set) => ({
+	useAccessStore = create((set, get) => ({
 		...initialState$1,
 		setAccessStore: (routes) => {
-			const newRoutes = ascending([...resolveLoginRoute(baseRoutes, routes, router, rootRoute), ...routes]);
+			const newRoutes = ascending([...resolveLoginRoute(baseRoutes, routes, router, rootRoute), ...mergeSolutionCategories(routes, get().solutionRoutes)]);
 			router.patchRoutes(ROOT_ROUTE_ID, routes);
 			const flatRouteList = flattenRoutes(newRoutes);
 			const newState = {
@@ -8404,6 +8440,10 @@ var init_access = __esmMin((() => {
 			set(() => newState);
 			return newState;
 		},
+		setSolutionRoutes: (rows) => {
+			set({ solutionRoutes: rows });
+			if (lastRegisteredRoutes.length > 0) get().setAccessStore(lastRegisteredRoutes);
+		},
 		reset: () => {
 			router._internalSetRoutes(rootRoute);
 			set(initialState$1);
@@ -8739,7 +8779,10 @@ var init_request = __esmMin((() => {
 							}
 						}
 						return refreshTokenAndRetry(request, options, refreshToken);
-					} else return handleErrorResponse(response);
+					} else {
+						if (options.silentError) return response;
+						return handleErrorResponse(response);
+					}
 				}
 				return response;
 			}]
@@ -8777,11 +8820,13 @@ function fetchRbacOplog(query) {
 	for (const [k, v] of Object.entries(query)) if (v != null && v !== "") sp.set(k, String(v));
 	return get(`system/oplog?${sp.toString()}`);
 }
+var fetchRbacOplogPost = (body) => post("system/oplog", body);
 var fetchRbacSettings = () => get("system/settings");
 var fetchRbacUpdateSetting = (key, value) => put("system/settings", {
 	key,
 	value
 });
+var fetchSolutionRoutes = () => get("_platform/solutions/routes");
 function fetchRbacContacts(keyword, limit) {
 	return get(`_platform/contacts?keyword=${encodeURIComponent(keyword)}${limit ? `&limit=${limit}` : ""}`);
 }
@@ -8827,6 +8872,46 @@ function groupByModule(items) {
 		items
 	}));
 }
+/**
+* 框架自有设置模块（seed.sql 现行集合；新增框架设置模块须同步）。
+* 方案设置经安装预检强制 `moduleOf(key)===name`（R24），落库 module 列即方案名——
+* 据此把 sys_setting 行二分为框架区（维持按 group 聚合的现状渲染）与方案区（按模块三层嵌套）。
+*/
+var FRAMEWORK_SETTING_MODULES = /* @__PURE__ */ new Set([
+	"framework",
+	"market",
+	"ldap",
+	"sso"
+]);
+/**
+* 设置行按模块三层嵌套分组（R20/R24，纯函数）：框架卡在前（按 group 列聚合、保持服务端
+* `order by group, key` 次序），方案卡在后（module 名升序、组内按 group 列聚合）。
+* 不按 key 首段切组——框架 seed 存在无点号键（ldap_base_dn），首段不是其模块名；
+* module 列是落库的所有权真源。空行降级返回空数组。
+*/
+function groupSettingsByModule(rows) {
+	const framework = /* @__PURE__ */ new Map();
+	const solutions = /* @__PURE__ */ new Map();
+	for (const item of rows) if (FRAMEWORK_SETTING_MODULES.has(item.module)) (framework.get(item.group) ?? framework.set(item.group, []).get(item.group)).push(item);
+	else {
+		const groups = solutions.get(item.module) ?? solutions.set(item.module, /* @__PURE__ */ new Map()).get(item.module);
+		(groups.get(item.group) ?? groups.set(item.group, []).get(item.group)).push(item);
+	}
+	const cards = [];
+	for (const [group, items] of framework) cards.push({
+		module: null,
+		group,
+		label_key: null,
+		items
+	});
+	for (const module of [...solutions.keys()].sort()) for (const [group, items] of solutions.get(module)) cards.push({
+		module,
+		group,
+		label_key: `${module}:settings.group.${group}`,
+		items
+	});
+	return cards;
+}
 //#endregion
 //#region src/api/system/menu/index.ts
 init_api_provider();
@@ -9545,6 +9630,55 @@ function defineModule(definition) {
 	return definition;
 }
 //#endregion
+//#region src/store/solution-routes.ts
+init_access();
+init_auth();
+var useSolutionRoutes = create((set) => ({
+	routes: [],
+	loaded: false,
+	refresh: async () => {
+		try {
+			const routes = await fetchSolutionRoutes();
+			set({
+				routes,
+				loaded: true
+			});
+			useAccessStore.getState().setSolutionRoutes(routes);
+		} catch {
+			set({
+				routes: [],
+				loaded: true
+			});
+			useAccessStore.getState().setSolutionRoutes([]);
+		}
+	},
+	reset: () => {
+		set({
+			routes: [],
+			loaded: false
+		});
+		useAccessStore.getState().setSolutionRoutes([]);
+	}
+}));
+/**
+* token 就绪监视（R21）：登录成功（token 翻转）强制重拉一次；登出清空行并解除归并。
+* 幂等（armed 防重），模块导入即武装——宿主链（shell 无 AuthGuard）同样生效。
+*/
+var armed = false;
+function watchTokenReady() {
+	if (armed) return;
+	armed = true;
+	let lastToken = useAuthStore.getState().token;
+	if (lastToken) useSolutionRoutes.getState().refresh();
+	useAuthStore.subscribe((state) => {
+		if (state.token === lastToken) return;
+		lastToken = state.token;
+		if (state.token) useSolutionRoutes.getState().refresh();
+		else useSolutionRoutes.getState().reset();
+	});
+}
+watchTokenReady();
+//#endregion
 //#region src/utils/get-all-expanded-keys/index.ts
 function getAllExpandedKeys(data, fieldName = "key") {
 	return data.flatMap((item) => [item[fieldName], ...item.children?.length ? getAllExpandedKeys(item.children, fieldName) : []]);
@@ -27594,10 +27728,11 @@ init_tabs();
 init_user();
 init_get_app_info();
 init_get_redirect_path();
+init_request();
 init_user$1();
 init_local_icons();
 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, bindingDiff, canAssignRole, canDeleteRole, canEditRoleBindings, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchChangePassword, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLdapLogin, fetchLogin, fetchLoginMethods, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRbacAdminResetPassword, fetchRbacContactDetail, fetchRbacContacts, fetchRbacCreateRole, fetchRbacCreateUser, fetchRbacDeleteRole, fetchRbacOplog, fetchRbacPermissionList, fetchRbacRoleList, fetchRbacSetForbidden, fetchRbacSettings, fetchRbacUpdateBindings, fetchRbacUpdateSetting, fetchRbacUpdateUserRoles, fetchRbacUserList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, groupByModule, handleTree, loadAll, mapTree, menuIcons, notify, permissionPrefix, roleLabel, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useTabKey, 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, bindingDiff, canAssignRole, canDeleteRole, canEditRoleBindings, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchChangePassword, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLdapLogin, fetchLogin, fetchLoginMethods, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRbacAdminResetPassword, fetchRbacContactDetail, fetchRbacContacts, fetchRbacCreateRole, fetchRbacCreateUser, fetchRbacDeleteRole, fetchRbacOplog, fetchRbacOplogPost, fetchRbacPermissionList, fetchRbacRoleList, fetchRbacSetForbidden, fetchRbacSettings, fetchRbacUpdateBindings, fetchRbacUpdateSetting, fetchRbacUpdateUserRoles, fetchRbacUserList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchSolutionRoutes, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, groupByModule, groupSettingsByModule, handleTree, loadAll, mapTree, menuIcons, notify, permissionPrefix, request, roleLabel, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useSolutionRoutes, useTabKey, useTabsStore, useUserStore, external_exports as z };

package/dist/store/access.d.ts

@@ -1,3 +1,4 @@
+import type { SolutionRouteRow } from "../api/rbac/types";
 import type { MenuItemType } from "../layout/layout-menu/types";
 import type { AppRouteRecordRaw } from "../router/types";
 interface AccessState {
@@ -5,9 +6,12 @@ interface AccessState {
     routeList: AppRouteRecordRaw[];
     flatRouteList: Record<string, AppRouteRecordRaw>;
     isAccessChecked: boolean;
+    solutionRoutes: SolutionRouteRow[];
 }
 interface AccessAction {
-    setAccessStore: (routes: AppRouteRecordRaw[]) => AccessState;
+    setAccessStore: (routes: AppRouteRecordRaw[]) => Omit<AccessState, "solutionRoutes">;
+    /** 方案路由行推送（useSolutionRoutes 就绪/清空时调用），推送后按快照重归并（R21） */
+    setSolutionRoutes: (rows: SolutionRouteRow[]) => void;
     reset: () => void;
 }
 export declare const useAccessStore: import("zustand").UseBoundStore<import("zustand").StoreApi<AccessState & AccessAction>>;

package/dist/store/solution-routes.d.ts

@@ -0,0 +1,21 @@
+import type { SolutionRouteRow } from "../api/rbac/types";
+/**
+ * 方案路由归并 store（P1-14，R21 独立缓存 store）。
+ *
+ * 职责：登录即可只读端点（GET /api/_platform/solutions/routes）的唯一前端消费口——
+ * - token 就绪强制重拉一次（首登会话归并补齐；现状菜单登记在登录前且 alreadyRegistered
+ *   跳过，无此补拉则首登永久降级为无分类，R21）；
+ * - 端点失败/未登录降级空表不炸（按无分类渲染，路由照常，R21 降级不阻断）；
+ * - 行就绪即推送 access store（setSolutionRoutes）触发按快照重归并。
+ */
+interface SolutionRoutesState {
+    /** 未 deprecated 方案路由行（降级时为空表） */
+    routes: SolutionRouteRow[];
+    /** 已完成过一次拉取（成功或失败） */
+    loaded: boolean;
+    refresh: () => Promise<void>;
+    reset: () => void;
+}
+export declare const useSolutionRoutes: import("zustand").UseBoundStore<import("zustand").StoreApi<SolutionRoutesState>>;
+export declare function watchTokenReady(): void;
+export {};

package/package.json

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