@litianxiang/portal-core 0.2.0 → 0.2.1

package/README.md

@@ -16,6 +16,26 @@ pnpm add @litianxiang/portal-core
 npm i @litianxiang/portal-core
 ```
 
+## 升级说明
+
+### 0.2.0（Breaking Change）
+
+- 移除 `createPortalHttpClient`。
+- 统一使用 `createAuthHttpClient`。
+- 业务项目原来通过 `createPortalHttpClient` 传入的 `baseURL: ''`、`timeout: 10000` 可以不再显式传递，`createAuthHttpClient` 内部已提供相同默认值。
+
+迁移示例：
+
+```ts
+import { createAuthHttpClient } from '@litianxiang/portal-core'
+
+const { http, logoutToAuth } = createAuthHttpClient({
+  getUserStore: () => useUserStore(),
+  getLoadingStore: () => useLoadingStore(),
+  onShowError: (msg) => console.error(msg)
+})
+```
+
 ## 快速开始
 
 ### 1) 路由接入
@@ -73,6 +93,8 @@ setupPortalApp({
 ### router
 
 - `createAppRouter(options)`：创建统一路由实例，内置登录态校验、菜单动态挂载、首屏跳转逻辑。
+  - 菜单类别为 `page` 的动态路由会挂载到 `main` 下。
+  - 菜单类别为 `flow-page` 的动态路由会挂载为顶级路由（不进入 `main` 主框架）。
 
 最小示例：
 

package/dist/index.js

@@ -212,7 +212,8 @@ function createAppRouter(options) {
   const resolveRouteAndView = (item) => {
     const [rawPath] = (item.path || "").split("?");
     const normalizedPath = rawPath.startsWith("/") ? rawPath : `/${rawPath}`;
-    const routePath = normalizedPath.slice(1);
+    const childPath = normalizedPath.slice(1);
+    const rootPath = normalizedPath;
     const candidates = [
       `/main${normalizedPath}`,
       // /views/main/system/user.vue
@@ -231,40 +232,44 @@ function createAppRouter(options) {
       const fallbackPath = `/main${normalizedPath}`;
       viewKey = `/src/views${fallbackPath}.vue`;
     }
-    return { routePath, viewKey };
+    return { childPath, rootPath, viewKey };
   };
-  const transformRoutes = (menuItems) => {
+  const collectDynamicRoutes = (menuItems) => {
     const routes = [];
-    for (const item of menuItems) {
-      if (item.category === "button") continue;
-      const { routePath, viewKey } = resolveRouteAndView(item);
-      const isPage = item.category === "page" || item.category === "flow-page";
-      if (!registeredPaths.has(routePath)) {
-        registeredPaths.add(routePath);
-        routes.push({
-          path: routePath,
-          name: `menu_${item.id}`,
-          component: isPage ? modules[viewKey] : void 0,
-          meta: {
-            id: item.id,
-            parent_id: item.parent_id,
-            icon: item.icon,
-            category: item.category,
-            keepAlive: true,
-            title: item.name,
-            fullPath: item.path
-          },
-          children: item.children ? transformRoutes(item.children) : []
-        });
-      } else if (item.children?.length) {
-        routes.push(...transformRoutes(item.children));
+    for (const item of menuItems || []) {
+      if (item?.children?.length) {
+        routes.push(...collectDynamicRoutes(item.children));
       }
+      const isDynamicPage = item?.category === "page" || item?.category === "flow-page";
+      if (!isDynamicPage) continue;
+      const { childPath, rootPath, viewKey } = resolveRouteAndView(item);
+      const routePath = item?.category === "flow-page" ? rootPath : childPath;
+      if (registeredPaths.has(routePath)) continue;
+      registeredPaths.add(routePath);
+      routes.push({
+        path: routePath,
+        name: `menu_${item.id}`,
+        component: modules[viewKey],
+        meta: {
+          id: item.id,
+          parent_id: item.parent_id,
+          icon: item.icon,
+          category: item.category,
+          keepAlive: true,
+          title: item.name,
+          fullPath: item.path
+        }
+      });
     }
     return routes;
   };
   const addDynamicRoutes = (menuData) => {
-    const dynamicRoutes = transformRoutes(menuData);
+    const dynamicRoutes = collectDynamicRoutes(menuData);
     dynamicRoutes.forEach((route) => {
+      if (route.meta?.category === "flow-page") {
+        router.addRoute(route);
+        return;
+      }
       router.addRoute("main", route);
     });
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litianxiang/portal-core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "type": "module",
   "main": "dist/index.js",