vitarx-router 4.0.0-beta.13 → 4.0.0-beta.15

package/dist/components/RouterView.js

@@ -12,7 +12,7 @@ import { __ROUTER_VIEW_DEPTH_KEY__, useRouter } from '../core/index.js';
  * @returns {View} 返回渲染的视图
  */
 export function RouterView(props) {
-    const { children, name = 'default' } = props;
+    const { children } = props;
     // 获取路由实例
     const router = useRouter();
     // 获取父级 index
@@ -20,6 +20,7 @@ export function RouterView(props) {
     const index = parentIndex + 1; // 计算当前视图的索引
     provide(__ROUTER_VIEW_DEPTH_KEY__, index); // 向子组件提供当前索引
     // 匹配的路由线路
+    const viewName = computed(() => props.name || 'default');
     const matchedRoute = computed(() => {
         return router.route.matched[index] ?? null;
     });
@@ -28,8 +29,7 @@ export function RouterView(props) {
         const currentRoute = matchedRoute.value;
         if (!currentRoute)
             return null;
-        const name = props.name || 'default'; // 获取视图名称，默认为 'default'
-        let injectProps = currentRoute.props?.[name] ?? router.config.props ?? false;
+        let injectProps = currentRoute.props?.[viewName.value] ?? router.config.props ?? false;
         if (injectProps === false)
             return null; // 如果属性为 false，返回null
         if (injectProps === true && currentRoute.pattern) {
@@ -52,7 +52,7 @@ export function RouterView(props) {
         const route = matchedRoute.value; // 获取匹配的路由记录
         if (!route)
             return null;
-        return route.component?.[name] ?? null;
+        return route.component?.[viewName.value] ?? null;
     });
     // 如果传入了 children 函数，则调用并返回其结果
     if (isFunction(children)) {
@@ -61,6 +61,7 @@ export function RouterView(props) {
         }
         catch (e) {
             logger.error('[RouterView] Error occurred while executing children function', e);
+            return createCommentView(`router-view:error`);
         }
     }
     let lastView = null;

package/dist/core/common/constant.d.ts

@@ -2,12 +2,11 @@
  * 导航状态
  *
  * 枚举值：
- * 0. success: 导航成功
- * 1. aborted: 导航被阻止
- * 2. cancelled: 导航被取消
- * 3. duplicated: 重复导航
- * 4. notfound: 路由未匹配
- * 5. exception: 捕获到异常
+ * 1. success: 导航成功
+ * 2. aborted: 导航被阻止
+ * 4. cancelled: 导航被取消
+ * 8. duplicated: 重复导航
+ * 16. notfound: 路由未匹配
  */
 export declare enum NavState {
     /**

package/dist/core/common/constant.js

@@ -2,12 +2,11 @@
  * 导航状态
  *
  * 枚举值：
- * 0. success: 导航成功
- * 1. aborted: 导航被阻止
- * 2. cancelled: 导航被取消
- * 3. duplicated: 重复导航
- * 4. notfound: 路由未匹配
- * 5. exception: 捕获到异常
+ * 1. success: 导航成功
+ * 2. aborted: 导航被阻止
+ * 4. cancelled: 导航被取消
+ * 8. duplicated: 重复导航
+ * 16. notfound: 路由未匹配
  */
 export var NavState;
 (function (NavState) {

package/dist/core/router/web.js

@@ -1,4 +1,5 @@
 import { isString, logger } from 'vitarx';
+import { NavState } from '../common/constant.js';
 import { parseHashContent } from '../common/utils.js';
 import { normalizePath, parseQuery } from '../shared/utils.js';
 import { Router } from './router.js';
@@ -49,7 +50,11 @@ export class WebRouter extends Router {
             }
         });
         // 初始化路由
-        this.replace(this.urlToNavigateTarget()).then();
+        this.replace(this.urlToNavigateTarget()).then(res => {
+            if (__VITARX_DEV__ && res.state !== NavState.success && res.state !== NavState.cancelled) {
+                logger.error(`[Router] Initialization failed: ${res.message}`, res);
+            }
+        });
         // 初始化时监听 popstate 事件，处理历史记录返回时的路由恢复
         window.addEventListener('popstate', this.onPopState);
         if (this.config.mode === 'hash') {

package/dist/file-router/config/resolve.d.ts

@@ -1,4 +1,4 @@
-import type { CodeTransformHook, ExtendRouteHook, FileRouterOptions, ImportMode, PageDirOptions, PageSource, PathParser, PathStrategy } from '../types/index.js';
+import type { CodeTransformHook, ExtendRouteHook, FileRouterOptions, ImportMode, PageDirOptions, PageSource, PathParser, PathStrategy, RouteNode } from '../types/index.js';
 export type PageDirConfig = Required<PageDirOptions>;
 /**
  * 规范化后的配置
@@ -14,6 +14,7 @@ export interface ResolvedConfig {
     configFileName: string;
     transform?: CodeTransformHook;
     extendRoute?: ExtendRouteHook;
+    beforeWriteRoutes?: (routes: RouteNode[]) => void | RouteNode[];
     pathParser?: PathParser;
 }
 /**

package/dist/file-router/config/resolve.js

@@ -49,7 +49,7 @@ export function resolvePageConfigs(pages, root) {
  * @returns - 规范化后的配置对象
  */
 export function resolveConfig(options) {
-    const { dts = false, root = process.cwd(), pages = DEFAULT_PAGES_DIR, importMode = 'lazy', injectImports = [], pathStrategy = 'kebab', layoutFileName = DEFAULT_LAYOUT_FILE, configFileName = DEFAULT_CONFIG_FILE, transform, extendRoute, pathParser } = options;
+    const { dts = false, root = process.cwd(), pages = DEFAULT_PAGES_DIR, importMode = 'lazy', injectImports = [], pathStrategy = 'kebab', layoutFileName = DEFAULT_LAYOUT_FILE, configFileName = DEFAULT_CONFIG_FILE, transform, extendRoute, beforeWriteRoutes, pathParser } = options;
     const resolvedPages = resolvePageConfigs(pages, root);
     return {
         dts: typeof dts === 'string' ? dts : dts ? DEFAULT_DTS_FILE : false,
@@ -62,6 +62,7 @@ export function resolveConfig(options) {
         configFileName,
         transform,
         extendRoute,
+        beforeWriteRoutes,
         pathParser
     };
 }

package/dist/file-router/config/validate.js

@@ -207,6 +207,17 @@ function validateExtendRoute(opts) {
         throw new Error('options.extendRoute 必须是函数');
     }
 }
+/**
+ * 验证 beforeWriteRoutes 配置
+ * @param opts
+ */
+function validateBeforeWriteRoutes(opts) {
+    if (opts.beforeWriteRoutes === undefined)
+        return;
+    if (typeof opts.beforeWriteRoutes !== 'function') {
+        throw new Error('options.beforeWriteRoutes 必须是函数');
+    }
+}
 /**
  * 验证 pathParser 配置
  *
@@ -250,5 +261,6 @@ export function validateOptions(opts) {
     validateConfigFileName(opts);
     validateTransform(opts);
     validateExtendRoute(opts);
+    validateBeforeWriteRoutes(opts);
     validatePathParser(opts);
 }

package/dist/file-router/generator/generateRoutes.d.ts

@@ -4,7 +4,7 @@
  * 负责将解析后的页面信息转换为可执行的路由配置代码。
  * 与构建工具无关，可在任何 Node.js 环境中使用。
  */
-import type { ExtendRouteHook, ImportMode, ParsedNode, RouteNode } from '../types/index.js';
+import type { BeforeWriteRoutesHook, ExtendRouteHook, ImportMode, RouteNode, ScanNode } from '../types/index.js';
 /**
  * 路由生成选项
  */
@@ -24,6 +24,11 @@ export interface GenerateRoutesOptions {
      * 在生成每个路由配置时调用，允许开发者自定义扩展路由配置
      */
     extendRoute?: ExtendRouteHook;
+    /**
+     * 路由写入前钩子
+     * 在生成路由代码前调用，允许开发者自定义路由配置
+     */
+    beforeWriteRoutes?: BeforeWriteRoutesHook;
     /**
      * 自定义导入语句
      * 允许向虚拟模块注入自定义的导入语句
@@ -49,7 +54,7 @@ export declare function pathToUniqueName(absolutePath: string): string;
  * @param parent - 父路由
  * @returns 路由配置列表
  */
-export declare function buildRoutes(pages: Iterable<ParsedNode>, extendRoute?: ExtendRouteHook, parent?: RouteNode): RouteNode[];
+export declare function buildRoutes(pages: Iterable<ScanNode>, extendRoute?: ExtendRouteHook, parent?: RouteNode): RouteNode[];
 /**
  * 生成路由代码字符串
  *
@@ -69,4 +74,4 @@ export declare function generateRoutesCode(routes: RouteNode[], importMode?: Imp
  * @param options - 路由生成选项
  * @returns { GenerateResult } 包含routes、code、dts的路由配置结果
  */
-export declare function generateRoutes(pages: ParsedNode[], options: GenerateRoutesOptions): GenerateResult;
+export declare function generateRoutes(pages: ScanNode[], options: GenerateRoutesOptions): GenerateResult;

package/dist/file-router/generator/generateRoutes.js

@@ -59,6 +59,7 @@ function generateRouteName(fullPath) {
 function buildRouteNode(page, extendRoute, parent) {
     // 创建基础路由配置
     const route = {
+        filePath: page.filePath,
         path: page.path,
         fullPath: parent ? normalizeRoutePath(parent.fullPath + '/' + page.path) : page.path
     };
@@ -93,14 +94,14 @@ function buildRouteNode(page, extendRoute, parent) {
             route.alias = Array.isArray(alias) ? Array.from(alias) : alias;
         }
     }
+    // 应用路由扩展钩子
+    if (extendRoute)
+        extendRoute(route);
     // 处理子路由
     if (page.children && page.children.size > 0) {
         // 递归处理子路由
         route.children = buildRoutes(page.children.values(), extendRoute, route);
     }
-    // 应用路由扩展钩子
-    if (extendRoute)
-        extendRoute(route, page);
     // 动态路由不存在name时生成一个name
     if (!route.name && route.fullPath.includes('{')) {
         route.name = generateRouteName(route.fullPath);
@@ -278,7 +279,12 @@ export function generateRoutesCode(routes, importMode = 'lazy', customImports, i
  */
 export function generateRoutes(pages, options) {
     // 构建解析后的路由配置
-    const routes = buildRoutes(pages, options.extendRoute);
+    let routes = buildRoutes(pages, options.extendRoute);
+    if (options.beforeWriteRoutes) {
+        const result = options.beforeWriteRoutes(routes);
+        if (Array.isArray(result))
+            routes = result;
+    }
     // 生成最终的路由代码
     const code = generateRoutesCode(routes, options.importMode, options.imports);
     const dts = options.dts ? generateDtsCode(routes) : '';

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

@@ -8,8 +8,9 @@ import type { GeneratorResult } from '@babel/generator';
 import { ResolvedConfig } from './config/index.js';
 import { type GenerateResult } from './generator/index.js';
 import { type FilterOptions } from './parser/index.js';
-import type { FileRouterOptions, ParsedNode } from './types/index.js';
+import type { FileRouterOptions, ScanNode } from './types/index.js';
 export { resolvePageConfigs } from './config/resolve.js';
+export { mergePageOptions } from './macros/definePage.js';
 export * from './generator/index.js';
 export type * from './types/index.js';
 export * from './utils/logger.js';
@@ -42,13 +43,13 @@ export declare class FileRouter {
     /**
      * 获取节点树
      */
-    get nodeTree(): ParsedNode[];
+    get nodeTree(): ScanNode[];
     /**
      * 获取文件映射表
      *
      * 键为文件或目录路径，值为对应的节点对象
      */
-    get fileMap(): Map<string, ParsedNode>;
+    get fileMap(): Map<string, ScanNode>;
     /**
      * 加载/重新加载文件路由管理器
      *
@@ -60,7 +61,7 @@ export declare class FileRouter {
      *
      * @returns 扫描到的页面文件列表
      */
-    protected scanPages(): ParsedNode[];
+    protected scanPages(): ScanNode[];
     /**
      * 扫描页面目录
      *

package/dist/file-router/index.js

@@ -19,6 +19,7 @@ import { checkDefaultExport, isPageFile, isPageFileInDirs } from './parser/index
 import { parseRoutePath } from './parser/parsePage.js';
 import { applyPathStrategy, info, normalizePathSeparator, readFileContent, resolvePathVariable, validateOptions, warn } from './utils/index.js';
 export { resolvePageConfigs } from './config/resolve.js';
+export { mergePageOptions } from './macros/definePage.js';
 export * from './generator/index.js';
 export * from './utils/logger.js';
 /**
@@ -118,6 +119,7 @@ export class FileRouter {
             }
             if (page.group && page.prefix) {
                 const route = {
+                    isGroup: true,
                     filePath: page.dir,
                     path: this.applyPathStrategy(page.prefix)
                 };
@@ -177,6 +179,7 @@ export class FileRouter {
     processDir(filePath, fileName, page, parent) {
         const pathPrefix = parent ? '' : page.prefix;
         const route = {
+            isGroup: true,
             parent,
             filePath,
             path: this.applyPathStrategy(pathPrefix + fileName)
@@ -194,7 +197,7 @@ export class FileRouter {
      */
     processFile(filePath, page, pageMapping, parent) {
         // 分离出路由 path 和视图命名
-        const { routePath, viewName = 'default' } = parseRoutePath(filePath, this.config.pathParser);
+        const { routePath, viewName = 'default', options } = parseRoutePath(filePath, this.config.pathParser);
         const fileType = this.getPageType(filePath, routePath, page);
         if (fileType === 'ignore')
             return null;
@@ -205,12 +208,7 @@ export class FileRouter {
             const content = this.readFile(filePath);
             const pageOptions = parseDefinePage(content, filePath);
             if (pageOptions) {
-                if (parent.options) {
-                    mergePageOptions([parent.options, pageOptions]);
-                }
-                else {
-                    parent.options = pageOptions;
-                }
+                parent.options = mergePageOptions(parent.options, pageOptions);
                 parent.dirConfigFile = filePath;
                 this.fileMap.set(filePath, parent);
             }
@@ -242,14 +240,17 @@ export class FileRouter {
             return null;
         }
         // 解析页面选项
-        const pageOptions = parseDefinePage(content, filePath);
+        const definePageOptions = parseDefinePage(content, filePath);
+        // 合并页面选项
+        const pageOptions = mergePageOptions(options, definePageOptions);
         // 忽略不具备默认导出，且无重定向配置的文件
-        if (!pageOptions?.redirect && !checkDefaultExport(content, filePath))
+        if (!pageOptions.redirect && !checkDefaultExport(content, filePath))
             return null;
         // 最终 path
         const finalPath = this.applyPathStrategy((parent ? '' : page.prefix) + (routePath === 'index' ? '' : routePath));
         // 创建路由对象
         const route = {
+            isGroup: false,
             parent,
             filePath,
             path: finalPath,
@@ -258,7 +259,7 @@ export class FileRouter {
             }
         };
         // 添加页面选项
-        if (pageOptions)
+        if (Object.keys(pageOptions).length)
             route.options = pageOptions;
         // 添加到子路由映射中
         pageMapping.set(routePath, route);
@@ -345,6 +346,7 @@ export class FileRouter {
             __classPrivateFieldSet(this, _FileRouter_generateResult, generateRoutes(this.nodeTree, {
                 imports: this.config.injectImports,
                 extendRoute: this.config.extendRoute,
+                beforeWriteRoutes: this.config.beforeWriteRoutes,
                 importMode: this.config.importMode,
                 dts: !!this.config.dts
             }), "f");

package/dist/file-router/macros/astValueExtractor.js

@@ -128,8 +128,8 @@ function extractRegExp(node) {
         if (node.callee.type === 'Identifier' && node.callee.name === 'RegExp') {
             const args = node.arguments;
             if (args.length >= 1) {
-                const firstArg = args[0];
-                const secondArg = args[1];
+                const firstArg = args.at(0);
+                const secondArg = args.at(1);
                 let patternStr = null;
                 let flags = '';
                 if (firstArg.type === 'StringLiteral') {

package/dist/file-router/macros/definePage.d.ts

@@ -7,13 +7,14 @@
  */
 import type { GeneratorResult } from '@babel/generator';
 import type { PageOptions } from '../types/index.js';
+type Falsy = false | null | undefined | 0 | '';
 /**
  * 合并多个页面配置
  *
  * @param optionsList - 配置列表
  * @returns 合并后的配置
  */
-export declare function mergePageOptions(optionsList: PageOptions[]): PageOptions;
+export declare function mergePageOptions(...optionsList: (PageOptions | Falsy)[]): PageOptions;
 /**
  * 解析 definePage 宏配置
  *
@@ -43,3 +44,4 @@ export declare function removeDefinePage(code: string, filename: string): Genera
  * @param b
  */
 export declare function isEqualPageOptions(a?: PageOptions | null, b?: PageOptions | null): boolean;
+export {};

package/dist/file-router/macros/definePage.js

@@ -13,9 +13,11 @@ import { extractPageOptions } from './astValueExtractor.js';
  * @param optionsList - 配置列表
  * @returns 合并后的配置
  */
-export function mergePageOptions(optionsList) {
+export function mergePageOptions(...optionsList) {
     const merged = {};
     for (const options of optionsList) {
+        if (!options)
+            continue;
         if (options.name)
             merged.name = options.name;
         if (options.meta)
@@ -74,7 +76,7 @@ export function parseDefinePage(content, filePath) {
         if (routeOptionsList.length > 1) {
             warn('检测到多个 definePage 调用，将合并所有配置，建议每个文件只调用一次 definePage', `in ${filePath}`);
         }
-        return mergePageOptions(routeOptionsList);
+        return mergePageOptions(...routeOptionsList);
     }
     catch (e) {
         error(`解析 definePage 失败 in ${e}`, e);

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

@@ -32,4 +32,4 @@ export declare class PathParseError extends TypeError {
  * @returns 路由路径和视图名称
  * @throws {PathParseError} 当路径解析失败时抛出
  */
-export declare function parseRoutePath(filePath: string, parser?: PathParser): Exclude<PathParseResult, string>;
+export declare function parseRoutePath(filePath: string, parser?: PathParser): PathParseResult;

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

@@ -74,10 +74,10 @@ export class PathParseError extends TypeError {
 export function parseRoutePath(filePath, parser) {
     const { basename } = extractFileInfo(filePath);
     if (!parser) {
-        return parseDefaultRoutePath(basename);
+        return defaultPathParser(basename);
     }
     const result = parser(basename, filePath);
-    return parseCustomRouteResult(result, filePath);
+    return parseCustomResult(result, filePath);
 }
 /**
  * 提取文件信息
@@ -96,24 +96,32 @@ function extractFileInfo(filePath) {
  * @param basename - 文件基本名称
  * @returns 解析结果
  */
-function parseDefaultRoutePath(basename) {
-    const [routePath, viewName] = basename.split('@', 2);
+function defaultPathParser(basename) {
+    const [rawPath, viewName] = basename.split('@', 2);
+    const routePath = normalizeRoutePath(rawPath);
+    if (!routePath) {
+        throw new PathParseError('pathParser returned empty routePath', {
+            filePath: basename,
+            originalValue: rawPath,
+            field: 'routePath'
+        });
+    }
     return {
         routePath,
-        viewName: viewName || 'default'
+        viewName
     };
 }
 /**
- * 解析自定义路由结果
+ * 解析自定义解析器结果
  *
  * @param result - 解析器返回的结果
  * @param filePath - 文件路径（用于错误上下文）
  * @returns 解析结果
  * @throws {PathParseError} 当结果无效时抛出
  */
-function parseCustomRouteResult(result, filePath) {
+function parseCustomResult(result, filePath) {
     if (typeof result === 'string') {
-        return parseStringResult(result, filePath);
+        return defaultPathParser(result);
     }
     if (result && typeof result === 'object' && !Array.isArray(result)) {
         return parseObjectResult(result, filePath);
@@ -124,25 +132,6 @@ function parseCustomRouteResult(result, filePath) {
         field: 'result'
     });
 }
-/**
- * 解析字符串类型的结果
- *
- * @param result - 字符串结果
- * @param filePath - 文件路径
- * @returns 解析结果
- * @throws {PathParseError} 当路径无效时抛出
- */
-function parseStringResult(result, filePath) {
-    const routePath = normalizeRoutePath(result);
-    if (!routePath) {
-        throw new PathParseError('pathParser returned empty routePath', {
-            filePath,
-            originalValue: result,
-            field: 'routePath'
-        });
-    }
-    return { routePath, viewName: 'default' };
-}
 /**
  * 解析对象类型的结果
  *
@@ -152,7 +141,7 @@ function parseStringResult(result, filePath) {
  * @throws {PathParseError} 当结果无效时抛出
  */
 function parseObjectResult(result, filePath) {
-    const { routePath: rawRoutePath, viewName } = result;
+    const { routePath: rawRoutePath, viewName, options } = result;
     validateRoutePathType(rawRoutePath, filePath);
     const routePath = normalizeRoutePath(rawRoutePath);
     if (!routePath) {
@@ -163,9 +152,10 @@ function parseObjectResult(result, filePath) {
         });
     }
     validateViewName(viewName, filePath);
+    validateOptions(options, filePath);
     return {
-        routePath,
-        viewName: viewName || 'default'
+        ...result,
+        routePath
     };
 }
 /**
@@ -207,14 +197,32 @@ function validateViewName(viewName, filePath) {
         });
     }
 }
+/**
+ * 验证选项
+ *
+ * @param options - 选项
+ * @param filePath - 文件路径
+ */
+function validateOptions(options, filePath) {
+    if (options !== undefined && Object.prototype.toString.call(options) !== '[object Object]') {
+        throw new PathParseError('pathParser returned invalid options type', {
+            filePath,
+            originalValue: options,
+            field: 'options'
+        });
+    }
+}
 /**
  * 标准化路由路径
  *
- * 去除路径首尾空白和开头的斜杠。
+ * 去除路径首尾空白和首尾的斜杠，将 . # 等不利于 URL 的字符替换为 -。
  *
  * @param routePath - 原始路由路径
  * @returns 标准化后的路由路径
  */
 function normalizeRoutePath(routePath) {
-    return routePath.trim().replace(/^\/+/, '');
+    return routePath
+        .trim()
+        .replace(/^\/+|\/+$/g, '')
+        .replace(/[.#]/g, '-');
 }

package/dist/file-router/types/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { ParsedNode, RouteNode } from './route.js';
+import type { RouteNode } from './route.js';
 /**
  * 扩展路由的钩子
  *
@@ -7,7 +7,11 @@ import type { ParsedNode, RouteNode } from './route.js';
  * @param route - 生成的路由节点
  * @param parsed - 解析的路由节点
  */
-export type ExtendRouteHook = (route: RouteNode, parsed: Readonly<ParsedNode>) => void;
+export type ExtendRouteHook = (route: RouteNode) => void;
+/**
+ * 写入路由文件前的钩子
+ */
+export type BeforeWriteRoutesHook = (routes: RouteNode[]) => void | RouteNode[];
 /**
  * 代码转换函数
  *

package/dist/file-router/types/options.d.ts

@@ -1,4 +1,5 @@
-import type { CodeTransformHook, ExtendRouteHook } from './hooks.js';
+import type { BeforeWriteRoutesHook, CodeTransformHook, ExtendRouteHook } from './hooks.js';
+import type { PageOptions } from './route.js';
 /**
  * 自定义导入模式函数的上下文
  */
@@ -53,10 +54,14 @@ export type PageSource = string | PageDirOptions;
 /**
  * 路径解析结果
  */
-export type PathParseResult = string | {
-    /** 解析后的路径 */
+export type PathParseResult = {
+    /** 解析后的路径 如：home.jsx -> 'home' */
     routePath: string;
-    /** 视图名称 */
+    /**
+     * 页面相关可配置选项
+     */
+    options?: PageOptions;
+    /** 视图名称 如：home.nav.jsx -> 'nav' */
     viewName?: string;
 };
 /**
@@ -64,9 +69,9 @@ export type PathParseResult = string | {
  *
  * @param basename - 文件名称（不包含扩展名)
  * @param filePath - 完整的文件路径
- * @returns {PathParseResult} 路径解析结果包含路径和视图名称
+ * @returns {PathParseResult | string} 如果返回字符串则交由内置的pathParser继续处理，否则返回`PathParseResult`对象
  */
-export type PathParser = (basename: string, filePath: string) => PathParseResult;
+export type PathParser = (basename: string, filePath: string) => string | PathParseResult;
 /**
  * 页面目录选项
  */
@@ -212,6 +217,10 @@ export interface FileRouterOptions {
      * ```
      */
     extendRoute?: ExtendRouteHook;
+    /**
+     * 写入路由之前
+     */
+    beforeWriteRoutes?: BeforeWriteRoutesHook;
     /**
      * 路径解析器
      *

package/dist/file-router/types/route.d.ts

@@ -39,13 +39,17 @@ export interface PageOptions {
     alias?: string | string[];
 }
 /**
- * 解析的节点 - 核心 IR 节点
+ * 扫描的节点 - 核心 IR 节点
  */
-export interface ParsedNode {
+export interface ScanNode {
     /**
      * 目录配置文件
      */
     dirConfigFile?: string;
+    /**
+     * 是否为分组
+     */
+    readonly isGroup: boolean;
     /**
      * 文件绝对路径
      */
@@ -57,11 +61,11 @@ export interface ParsedNode {
     /**
      * 父节点
      */
-    parent?: ParsedNode;
+    parent?: ScanNode;
     /**
      * 子节点映射
      */
-    children?: Set<ParsedNode>;
+    children?: Set<ScanNode>;
     /**
      * 组件映射（命名视图）
      */
@@ -75,18 +79,22 @@ export interface ParsedNode {
  * 路由节点 - 解析后的路由节点
  */
 export interface RouteNode extends PageOptions {
+    /**
+     * 文件绝对路径
+     */
+    filePath: string;
     /**
      * 当前 path（不含父级）
      */
-    readonly path: string;
+    path: string;
     /**
      * 完整 path（含父级）
      */
-    readonly fullPath: string;
+    fullPath: string;
     /**
-     * 子节点映射
+     * 子节点
      */
-    children?: readonly RouteNode[];
+    children?: RouteNode[];
     /**
      * 组件映射（命名视图）
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitarx-router",
-  "version": "4.0.0-beta.13",
+  "version": "4.0.0-beta.15",
   "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",