vitarx-router 4.0.0-beta.8 → 4.0.0-beta.9

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

@@ -106,6 +106,27 @@ export function buildRoutes(pages, extendRoute, parent) {
     }
     return routes;
 }
+/**
+ * 解析组件导入表达式
+ *
+ * @param file - 组件文件路径
+ * @param importPath - JSON.stringify 后的文件路径
+ * @param mode - 解析后的导入模式（'lazy' | 'sync' | 自定义表达式）
+ * @param importLines - 导入语句集合
+ * @returns 组件表达式代码
+ */
+function resolveComponentExpr(file, importPath, mode, importLines) {
+    if (mode === 'sync') {
+        const expr = pathToUniqueName(file);
+        importLines.add(`import ${expr} from ${importPath}`);
+        return expr;
+    }
+    if (mode === 'lazy') {
+        importLines.add(`import { lazy } from 'vitarx'`);
+        return `lazy(() => import(${importPath}))`;
+    }
+    return mode;
+}
 /**
  * 格式化组件表达式
  *
@@ -117,21 +138,14 @@ export function buildRoutes(pages, extendRoute, parent) {
 function formatComponent(component, importMode, importLines) {
     const entries = Object.entries(component).map(([name, file]) => {
         const importPath = JSON.stringify(file);
-        let expr;
-        if (importMode === 'sync') {
-            expr = pathToUniqueName(file);
-            importLines.add(`import ${expr} from ${importPath}`);
-        }
-        else if (importMode === 'lazy') {
-            expr = `lazy(() => import(${importPath}))`;
-        }
-        else {
-            expr = importMode({
+        const mode = typeof importMode === 'function'
+            ? importMode({
                 importPath,
                 filePath: file,
                 addImport: statement => importLines.add(statement)
-            });
-        }
+            })
+            : importMode;
+        const expr = resolveComponentExpr(file, importPath, mode, importLines);
         return `${JSON.stringify(name)}: ${expr}`;
     });
     return `{ ${entries.join(', ')} }`;
@@ -221,9 +235,6 @@ function generateRouteCode(route, indent, isLast, importMode, importLines) {
 export function generateRoutesCode(routes, importMode = 'lazy', customImports, indent = '  ') {
     const importLines = new Set();
     const codeLines = [];
-    if (importMode === 'lazy') {
-        importLines.add(`import { lazy } from 'vitarx'`);
-    }
     if (customImports && customImports.length > 0) {
         customImports.forEach(imp => importLines.add(imp));
     }

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

@@ -32,8 +32,9 @@ export declare class FileRouter {
      * 创建文件路由管理器
      *
      * @param options - 配置选项
+     * @param [init = true] - 是否初始化加载
      */
-    constructor(options?: FileRouterOptions);
+    constructor(options?: FileRouterOptions, init?: boolean);
     /**
      * 获取项目根目录
      */
@@ -48,6 +49,12 @@ export declare class FileRouter {
      * 键为文件或目录路径，值为对应的节点对象
      */
     get fileMap(): Map<string, ParsedNode>;
+    /**
+     * 加载/重新加载文件路由管理器
+     *
+     * @returns {FileRouter} 文件路由管理器实例
+     */
+    reload(): this;
     /**
      * 构建路由数组
      *
@@ -125,10 +132,6 @@ export declare class FileRouter {
      * 清空生成结果
      */
     clearGenerateResult(): void;
-    /**
-     * 重新加载
-     */
-    reload(): void;
     /**
      * 移除 definePage 宏
      *

package/dist/file-router/index.js

@@ -29,8 +29,9 @@ export class FileRouter {
      * 创建文件路由管理器
      *
      * @param options - 配置选项
+     * @param [init = true] - 是否初始化加载
      */
-    constructor(options = {}) {
+    constructor(options = {}, init = true) {
         /**
          * 配置项
          */
@@ -65,11 +66,12 @@ export class FileRouter {
          * 创建文件路由管理器
          *
          * @param options - 配置选项
+         * @param [init = true] - 是否初始化加载
          */
         );
         validateOptions(options);
         this.config = resolveConfig(options);
-        __classPrivateFieldSet(this, _FileRouter_nodeTree, this.scanPages(), "f");
+        __classPrivateFieldSet(this, _FileRouter_nodeTree, init ? this.scanPages() : [], "f");
     }
     /**
      * 获取项目根目录
@@ -91,6 +93,17 @@ export class FileRouter {
     get fileMap() {
         return __classPrivateFieldGet(this, _FileRouter_fileMap, "f");
     }
+    /**
+     * 加载/重新加载文件路由管理器
+     *
+     * @returns {FileRouter} 文件路由管理器实例
+     */
+    reload() {
+        this.clearGenerateResult();
+        __classPrivateFieldGet(this, _FileRouter_fileMap, "f").clear();
+        __classPrivateFieldSet(this, _FileRouter_nodeTree, this.scanPages(), "f");
+        return this;
+    }
     /**
      * 构建路由数组
      *
@@ -345,14 +358,6 @@ export class FileRouter {
     clearGenerateResult() {
         __classPrivateFieldSet(this, _FileRouter_generateResult, null, "f");
     }
-    /**
-     * 重新加载
-     */
-    reload() {
-        this.clearGenerateResult();
-        __classPrivateFieldGet(this, _FileRouter_fileMap, "f").clear();
-        __classPrivateFieldSet(this, _FileRouter_nodeTree, this.scanPages(), "f");
-    }
     /**
      * 移除 definePage 宏
      *

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

@@ -21,18 +21,22 @@ export interface ImportModeContext {
  * 自定义导入模式函数
  *
  * @param context - 导入上下文
- * @returns 组件表达式代码
+ * @returns 'lazy' | 'sync' | 表达式字符串
  *
  * @example
  * ```ts
- * // 自定义导入模式：使用 React.lazy
+ * // 返回预设模式
+ * (context) => 'lazy'
+ * (context) => 'sync'
+ *
+ * // 返回自定义表达式
  * (context) => {
- *   context.addImport(`import { lazy } from 'react'`)
+ *   context.addImport(`import { lazy } from 'vitarx'`)
  *   return `lazy(() => import(${context.importPath}))`
  * }
  * ```
  */
-export type ImportModeFunction = (context: ImportModeContext) => string;
+export type ImportModeFunction = (context: ImportModeContext) => 'lazy' | 'sync' | string;
 /**
  * 组件导入模式。
  *
@@ -134,7 +138,7 @@ export interface FileRouterOptions {
      *
      * // 使用自定义函数
      * importMode: (context) => {
-     *   context.addImport(`import { lazy } from 'react'`)
+     *   context.addImport(`import { lazy } from 'vitarx'`)
      *   return `lazy(() => import(${context.importPath}))`
      * }
      * ```

package/package.json

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