vitarx-router 4.0.3 → 4.0.4

package/dist/file-router/manager/file-processor.d.ts

@@ -9,7 +9,7 @@
  */
 import { type PageDirConfig, type ResolvedConfig } from '../config/index.js';
 import { type FileInfo } from '../parser/parsePage.js';
-import type { PageOptions, PageParseResult, ScanNode } from '../types/index.js';
+import type { PageParseResult, ScanNode } from '../types/index.js';
 /**
  * 扫描阶段的目录配置
  *
@@ -97,24 +97,4 @@ export interface ProcessPageFileParams {
  * @returns 新创建的路由节点；合并到已有路由时返回 null
  */
 export declare function processPageFile(params: ProcessPageFileParams, context: ProcessorContext): ScanNode | null;
-/**
- * 解析分组目录的自定义路径和选项
- *
- * 通过 groupParser 解析目录名，支持两种返回格式：
- * 1. 字符串：仅自定义路径
- * 2. 对象：自定义路径 + 路由选项（如 meta、name 等）
- *
- * 未配置 groupParser 时，直接使用原始目录名作为路径。
- *
- * @param fileName - 目录名
- * @param filePath - 目录完整路径
- * @param groupParser - 分组解析器，可选
- * @returns 解析后的路径和选项
- */
-export declare function parseGroupResult(fileName: string, filePath: string, groupParser?: (dirName: string, dirPath: string) => string | {
-    path: string;
-    options?: PageOptions;
-}): {
-    routePath: string;
-    options?: PageOptions;
-};
+export { parseGroupResult } from '../utils/groupParser.js';

package/dist/file-router/manager/file-processor.js

@@ -104,27 +104,5 @@ export function processPageFile(params, context) {
     pageMapping.set(parsed.path, route);
     return route;
 }
-/**
- * 解析分组目录的自定义路径和选项
- *
- * 通过 groupParser 解析目录名，支持两种返回格式：
- * 1. 字符串：仅自定义路径
- * 2. 对象：自定义路径 + 路由选项（如 meta、name 等）
- *
- * 未配置 groupParser 时，直接使用原始目录名作为路径。
- *
- * @param fileName - 目录名
- * @param filePath - 目录完整路径
- * @param groupParser - 分组解析器，可选
- * @returns 解析后的路径和选项
- */
-export function parseGroupResult(fileName, filePath, groupParser) {
-    if (!groupParser) {
-        return { routePath: fileName };
-    }
-    const result = groupParser(fileName, filePath);
-    if (typeof result === 'string') {
-        return { routePath: result };
-    }
-    return { routePath: result.path, options: result.options };
-}
+// parseGroupResult 已移至 utils/groupParser.ts，此处重新导出以保持向后兼容
+export { parseGroupResult } from '../utils/groupParser.js';

package/dist/file-router/manager/index.js

@@ -122,6 +122,7 @@ export class FileRouter {
             fileMap: this.fileMap,
             pages: this.config.pages,
             pageParser: this.config.pageParser,
+            groupParser: this.config.groupParser,
             pathStrategy: this.config.pathStrategy
         });
     }

package/dist/file-router/parser/routePath.d.ts

@@ -1,10 +1,11 @@
 import { type PageDirConfig } from '../config/resolve.js';
-import type { PageParser, PathStrategy, ScanNode } from '../types/index.js';
+import type { GroupParser, PageParser, PathStrategy, ScanNode } from '../types/index.js';
 import { type FileInfo } from './parsePage.js';
 interface RouteFullPathContext {
     fileMap: Map<string, ScanNode>;
     pages: readonly PageDirConfig[];
     pageParser?: PageParser;
+    groupParser?: GroupParser;
     pathStrategy: PathStrategy;
 }
 /**

package/dist/file-router/parser/routePath.js

@@ -5,6 +5,7 @@
  * 支持已跟踪（在路由树中）和未跟踪（尚未扫描）两种场景。
  */
 import nodePath from 'node:path';
+import { parseGroupResult } from '../utils/groupParser.js';
 import { applyPathStrategy } from '../utils/pathStrategy.js';
 import { normalizeRoutePath, resolvePathVariable } from '../utils/pathUtils.js';
 import { isPageFileInDirs } from './filterUtils.js';
@@ -48,27 +49,39 @@ function computeNodeFullPath(node) {
  * @returns 完整路由路径，非页面文件返回 null
  */
 export function computeRouteFullPath(filePath, fileInfo, context) {
-    const { fileMap, pages, pageParser, pathStrategy } = context;
+    const { fileMap, pages, pageParser, groupParser, pathStrategy } = context;
+    // 场景一：文件已在路由树中，直接沿 parent 链计算 fullPath
     const node = fileMap.get(filePath);
     if (node) {
         return computeNodeFullPath(node);
     }
+    // 场景二：文件尚未被扫描跟踪，需要从文件路径手动计算
     const page = isPageFileInDirs(filePath, pages);
     if (!page)
         return null;
+    // 解析文件名得到路径段（index 文件不产生路径段）
     const parsed = parsePageFile(filePath, pageParser, fileInfo);
-    const pathSegment = parsed.path === 'index' ? '' : applyFullPathStrategy(parsed.path, pathStrategy);
+    const pathSegment = parsed.path === 'index' ? '' : parsed.path;
     const segments = pathSegment ? [pathSegment] : [];
+    // 从文件所在目录向上遍历至 pages.dir 根目录，逐级收集路径段
     let dirPath = nodePath.dirname(filePath);
     while (dirPath.length > page.dir.length) {
         const dirNode = fileMap.get(dirPath);
         if (dirNode) {
+            // 目录已在路由树中，直接复用其 fullPath 作为前缀，无需继续向上遍历
             const parentFullPath = computeNodeFullPath(dirNode);
-            return normalizeRoutePath(parentFullPath + '/' + segments.join('/'));
+            segments.unshift(parentFullPath);
+            return normalizeRoutePath(applyFullPathStrategy(segments.join('/'), pathStrategy));
         }
-        segments.unshift(applyFullPathStrategy(nodePath.basename(dirPath), pathStrategy));
+        // 目录未被跟踪，通过 groupParser 解析目录名（如 "1.user" → "user"），再作为路径段
+        const dirName = nodePath.basename(dirPath);
+        const { routePath: parsedDirName } = parseGroupResult(dirName, dirPath, groupParser);
+        segments.unshift(parsedDirName);
         dirPath = nodePath.dirname(dirPath);
     }
-    const prefix = page.prefix ? applyFullPathStrategy(page.prefix, pathStrategy) : '';
-    return normalizeRoutePath(prefix + '/' + segments.join('/'));
+    // 顶层路由拼接 prefix
+    if (page.prefix)
+        segments.unshift(page.prefix);
+    // 统一应用路径策略（命名转换 + 动态参数转换）并规范化
+    return normalizeRoutePath(applyFullPathStrategy(segments.join('/'), pathStrategy));
 }

package/dist/file-router/utils/groupParser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview 分组目录解析工具
+ *
+ * 提供 groupParser 的调用封装，将目录名解析为路由路径和选项。
+ * 供扫描器和路径计算等模块共同使用。
+ */
+import type { PageOptions } from '../types/index.js';
+/**
+ * 解析分组目录的自定义路径和选项
+ *
+ * 通过 groupParser 解析目录名，支持两种返回格式：
+ * 1. 字符串：仅自定义路径
+ * 2. 对象：自定义路径 + 路由选项（如 meta、name 等）
+ *
+ * 未配置 groupParser 时，直接使用原始目录名作为路径。
+ *
+ * @param fileName - 目录名
+ * @param filePath - 目录完整路径
+ * @param groupParser - 分组解析器，可选
+ * @returns 解析后的路径和选项
+ */
+export declare function parseGroupResult(fileName: string, filePath: string, groupParser?: (dirName: string, dirPath: string) => string | {
+    path: string;
+    options?: PageOptions;
+}): {
+    routePath: string;
+    options?: PageOptions;
+};

package/dist/file-router/utils/groupParser.js

@@ -0,0 +1,24 @@
+/**
+ * 解析分组目录的自定义路径和选项
+ *
+ * 通过 groupParser 解析目录名，支持两种返回格式：
+ * 1. 字符串：仅自定义路径
+ * 2. 对象：自定义路径 + 路由选项（如 meta、name 等）
+ *
+ * 未配置 groupParser 时，直接使用原始目录名作为路径。
+ *
+ * @param fileName - 目录名
+ * @param filePath - 目录完整路径
+ * @param groupParser - 分组解析器，可选
+ * @returns 解析后的路径和选项
+ */
+export function parseGroupResult(fileName, filePath, groupParser) {
+    if (!groupParser) {
+        return { routePath: fileName };
+    }
+    const result = groupParser(fileName, filePath);
+    if (typeof result === 'string') {
+        return { routePath: result };
+    }
+    return { routePath: result.path, options: result.options };
+}

package/dist/file-router/utils/index.d.ts

@@ -10,3 +10,4 @@ export * from './pathStrategy.js';
 export * from '../config/validate.js';
 export * from './fileReader.js';
 export * from './findRoute.js';
+export * from './groupParser.js';

package/dist/file-router/utils/index.js

@@ -10,3 +10,4 @@ export * from './pathStrategy.js';
 export * from '../config/validate.js';
 export * from './fileReader.js';
 export * from './findRoute.js';
+export * from './groupParser.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitarx-router",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "description": "Official routing solution for Vitarx framework with declarative routing, navigation guards, dynamic routes, file-based routing with HMR, and full TypeScript support.",
   "author": "ZhuChonglin <8210856@qq.com>",
   "license": "MIT",