vitarx-router 4.0.0-beta.27 → 4.0.0-beta.28

package/dist/auto-routes/handleHotUpdate.d.ts

@@ -1,4 +1,5 @@
 import type { Route, Router } from '../core/index.js';
+export { default as routes } from 'virtual:vitarx-router:routes';
 /**
  * 处理路由热更新函数
  *

package/dist/auto-routes/handleHotUpdate.js

@@ -1,3 +1,4 @@
+export { default as routes } from 'virtual:vitarx-router:routes';
 /**
  * 处理路由热更新函数
  *
@@ -32,9 +33,10 @@
  */
 export function handleHotUpdate(router, onRoutesUpdated) {
     if (import.meta.hot) {
-        import.meta.hot.on('vitarx-router:routes-change', async () => {
-            const modules = await import('virtual:vitarx-router:routes');
-            const routes = modules.default;
+        import.meta.hot.accept('virtual:vitarx-router:routes', newModule => {
+            if (!newModule)
+                return;
+            const routes = newModule.default;
             if (routes && typeof routes === 'object') {
                 router.manager.clearRoutes();
                 for (const route of routes) {
@@ -44,6 +46,15 @@ export function handleHotUpdate(router, onRoutesUpdated) {
                 if (onRoutesUpdated) {
                     onRoutesUpdated(routes);
                 }
+                // 强制重新导航到当前路由
+                router
+                    .replace({
+                    index: router.route.matched.at(-1)?.name || router.route.path,
+                    params: { ...router.route.params },
+                    query: { ...router.route.query },
+                    hash: router.route.hash
+                })
+                    .then();
             }
         });
     }

package/dist/auto-routes/index.d.ts

@@ -15,5 +15,4 @@
  * }
  * ```
  */
-export { default as routes } from 'virtual:vitarx-router:routes';
-export { handleHotUpdate } from './handleHotUpdate.js';
+export { handleHotUpdate, routes } from './handleHotUpdate.js';

package/dist/auto-routes/index.js

@@ -15,5 +15,4 @@
  * }
  * ```
  */
-export { default as routes } from 'virtual:vitarx-router:routes';
-export { handleHotUpdate } from './handleHotUpdate.js';
+export { handleHotUpdate, routes } from './handleHotUpdate.js';

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

@@ -19,8 +19,8 @@ import { extractFileInfo } from '../parser/parsePage.js';
 import { computeRouteFullPath } from '../parser/routePath.js';
 import { applyPathStrategy, info, readFileContent, resolvePathVariable, validateOptions } from '../utils/index.js';
 import { checkIsPageFile, getPageType } from './file-classifier.js';
-import { scanPages } from './scanner.js';
 import { addPage, removePage, updatePage } from './route-updater.js';
+import { scanPages } from './scanner.js';
 /**
  * 文件路由管理器
  *

package/dist/file-router/manager/route-updater.d.ts

@@ -1,5 +1,5 @@
-import { type ProcessorContext } from './file-processor.js';
 import type { ScanNode } from '../types/index.js';
+import { type ProcessorContext } from './file-processor.js';
 /**
  * 增量更新上下文
  *

package/dist/file-router/manager/route-updater.js

@@ -9,11 +9,11 @@
  * 仅修改受影响的路由节点，保持其余路由不变。
  */
 import nodePath from 'node:path';
-import { processConfigFile, processLayoutFile, processPageFile } from './file-processor.js';
-import { resolveFile } from './file-classifier.js';
 import { isEqualPageOptions, parseDefinePage } from '../macros/index.js';
 import { checkDefaultExport, isPageFileInDirs } from '../parser/index.js';
 import { parsePageFile } from '../parser/parsePage.js';
+import { resolveFile } from './file-classifier.js';
+import { processConfigFile, processLayoutFile, processPageFile } from './file-processor.js';
 /**
  * 添加页面文件到路由树
  *
@@ -185,7 +185,7 @@ export function updatePage(filePath, context) {
             return true;
         }
         // 选项未变化，无需更新
-        if (isEqualPageOptions(route.options, newOptions)) {
+        if (isEqualPageOptions(route.options || null, newOptions)) {
             return false;
         }
         // 更新路由选项

package/dist/plugin-vite/index.d.ts

@@ -1,4 +1,4 @@
 import vitarxRouter from './plugin.js';
 export * from './constant.js';
-export * from './watcher.js';
+export * from './utils.js';
 export default vitarxRouter;

package/dist/plugin-vite/index.js

@@ -1,4 +1,4 @@
 import vitarxRouter from './plugin.js';
 export * from './constant.js';
-export * from './watcher.js';
+export * from './utils.js';
 export default vitarxRouter;

package/dist/plugin-vite/plugin.js

@@ -1,6 +1,6 @@
 import { FileRouter, info, warn } from '../file-router/index.js';
 import { RESOLVED_ROUTES_ID, VIRTUAL_ROUTES_ID } from './constant.js';
-import { setupWatcher } from './watcher.js';
+import { invalidateVirtualModule, setupWatcher } from './utils.js';
 /** 插件名称，用于日志输出和调试 */
 const PLUGIN_NAME = 'vite-plugin-vitarx-router';
 /**
@@ -155,14 +155,7 @@ export default function vitarxRouter(options = {}) {
                     const isRouteAffected = router.handleChange(event, file);
                     if (!isRouteAffected)
                         return;
-                    // 1. 获取虚拟模块在依赖图中的节点
-                    const virtualMod = server.moduleGraph.getModuleById(RESOLVED_ROUTES_ID);
-                    if (!virtualMod || virtualMod.importers.size === 0)
-                        return;
-                    // 2. 使虚拟模块缓存失效
-                    server.moduleGraph.invalidateModule(virtualMod);
-                    // 3. 向客户端发送自定义 HMR 更新信号
-                    server.ws.send({ type: 'custom', event: 'vitarx-router:routes-change' });
+                    invalidateVirtualModule(server, VIRTUAL_ROUTES_ID);
                 }
                 catch (error) {
                     warn(`Failed to handle file change for ${file}:`, error);

package/dist/plugin-vite/utils.d.ts

@@ -0,0 +1,47 @@
+import type { ModuleNode, ViteDevServer } from 'vite';
+import { FileRouter, type FileWatcherEvent } from '../file-router/index.js';
+/**
+ * 设置文件监听器
+ *
+ * 为开发服务器配置文件监听，监听页面目录下的文件变化。
+ * 当文件发生变化时，自动更新路由配置并触发 HMR。
+ *
+ * @param router - 文件路由管理器实例
+ * @param server - Vite 开发服务器实例
+ * @param handleFileChange - 文件变化处理函数
+ * @param delay - 节流延迟时间（毫秒）
+ * @returns 文件监听器处理函数，用于后续清理
+ */
+export declare function setupWatcher(router: FileRouter, server: ViteDevServer, handleFileChange: (event: FileWatcherEvent, file: string) => void, delay?: number): (event: FileWatcherEvent, file: string) => void;
+/**
+ * 递归收集模块的所有物理文件依赖者
+ *
+ * 从指定模块出发，沿着 importer 链向上递归遍历，
+ * 收集所有物理文件模块（排除虚拟模块和带查询参数的模块）。
+ * 用于 HMR 更新时找到所有需要接收更新通知的物理文件。
+ *
+ * 例如对于依赖链：`router/index.ts → auto-routes/index.ts → virtual:routes`
+ * 从 `virtual:routes` 出发，会收集到 `auto-routes/index.ts` 和 `router/index.ts`
+ *
+ * @param mod - 起始模块节点
+ * @param [visited] - 已访问模块集合，防止循环引用
+ * @returns 物理文件模块节点数组
+ */
+export declare function collectPhysicalImporters(mod: ModuleNode, visited?: Set<ModuleNode>): ModuleNode[];
+/**
+ * 触发虚拟路由模块的 HMR 更新
+ *
+ * 使虚拟模块缓存失效，并递归收集所有物理文件依赖者，
+ * 向它们发送 HMR 更新信号，使客户端能接收到路由变化。
+ *
+ * 处理流程：
+ * 1. 获取虚拟模块在依赖图中的节点
+ * 2. 使虚拟模块缓存失效
+ * 3. 递归收集所有物理文件依赖者（支持 barrel 文件 re-export 场景）
+ * 4. 向每个物理文件依赖者发送 js-update 信号
+ *
+ * @param server - Vite 开发服务器实例
+ * @param virtualId - 虚拟模块的原始 ID（如 `virtual:vitarx-router:routes`）
+ * @returns 是否成功发送了 HMR 更新
+ */
+export declare function invalidateVirtualModule(server: ViteDevServer, virtualId: string): boolean;

package/dist/plugin-vite/utils.js

@@ -0,0 +1,138 @@
+/**
+ * 创建批量节流处理函数
+ *
+ * 在指定时间窗口内收集所有变化事件，然后批量处理。
+ * 同一文件的多次变更会被合并，只保留最后一次事件。
+ * 这可以避免在短时间内多次触发路由重新生成，同时确保
+ * 所有文件变化都被正确处理，不会丢失任何更新。
+ *
+ * @param callback - 需要节流的回调函数
+ * @param delay - 节流延迟时间（毫秒）
+ * @returns 节流后的处理函数
+ *
+ * @example
+ * ```typescript
+ * const batchHandler = createBatchThrottledHandler(
+ *   (event, file) => console.log(event, file),
+ *   100
+ * )
+ *
+ * // 快速调用多次，同文件变更会被合并
+ * batchHandler('change', 'a.ts')
+ * batchHandler('change', 'b.ts')
+ * batchHandler('unlink', 'a.ts')  // 覆盖之前的 a.ts change
+ * // 100ms 后，只处理 a.ts unlink 和 b.ts change
+ * ```
+ */
+function createBatchThrottledHandler(callback, delay) {
+    let pending = false;
+    const pendingChanges = new Map();
+    return (event, file) => {
+        pendingChanges.set(file, event);
+        if (pending)
+            return;
+        pending = true;
+        setTimeout(() => {
+            pending = false;
+            const changes = new Map(pendingChanges);
+            pendingChanges.clear();
+            for (const [f, e] of changes) {
+                callback(e, f);
+            }
+        }, delay);
+    };
+}
+/**
+ * 设置文件监听器
+ *
+ * 为开发服务器配置文件监听，监听页面目录下的文件变化。
+ * 当文件发生变化时，自动更新路由配置并触发 HMR。
+ *
+ * @param router - 文件路由管理器实例
+ * @param server - Vite 开发服务器实例
+ * @param handleFileChange - 文件变化处理函数
+ * @param delay - 节流延迟时间（毫秒）
+ * @returns 文件监听器处理函数，用于后续清理
+ */
+export function setupWatcher(router, server, handleFileChange, delay = 100) {
+    const pagesDirs = router.config.pages;
+    for (const dirConfig of pagesDirs) {
+        server.watcher.add(dirConfig.dir);
+    }
+    const handler = createBatchThrottledHandler(handleFileChange, delay);
+    server.watcher.on('all', handler);
+    return handler;
+}
+/**
+ * 递归收集模块的所有物理文件依赖者
+ *
+ * 从指定模块出发，沿着 importer 链向上递归遍历，
+ * 收集所有物理文件模块（排除虚拟模块和带查询参数的模块）。
+ * 用于 HMR 更新时找到所有需要接收更新通知的物理文件。
+ *
+ * 例如对于依赖链：`router/index.ts → auto-routes/index.ts → virtual:routes`
+ * 从 `virtual:routes` 出发，会收集到 `auto-routes/index.ts` 和 `router/index.ts`
+ *
+ * @param mod - 起始模块节点
+ * @param [visited] - 已访问模块集合，防止循环引用
+ * @returns 物理文件模块节点数组
+ */
+export function collectPhysicalImporters(mod, visited = new Set()) {
+    const result = [];
+    for (const importer of mod.importers) {
+        if (visited.has(importer))
+            continue;
+        visited.add(importer);
+        const isPhysical = !importer.url.startsWith('\0') && !importer.url.includes('?');
+        if (isPhysical) {
+            result.push(importer);
+        }
+        // 继续向上递归查找（无论当前是否为物理文件，都继续遍历）
+        result.push(...collectPhysicalImporters(importer, visited));
+    }
+    return result;
+}
+/**
+ * 触发虚拟路由模块的 HMR 更新
+ *
+ * 使虚拟模块缓存失效，并递归收集所有物理文件依赖者，
+ * 向它们发送 HMR 更新信号，使客户端能接收到路由变化。
+ *
+ * 处理流程：
+ * 1. 获取虚拟模块在依赖图中的节点
+ * 2. 使虚拟模块缓存失效
+ * 3. 递归收集所有物理文件依赖者（支持 barrel 文件 re-export 场景）
+ * 4. 向每个物理文件依赖者发送 js-update 信号
+ *
+ * @param server - Vite 开发服务器实例
+ * @param virtualId - 虚拟模块的原始 ID（如 `virtual:vitarx-router:routes`）
+ * @returns 是否成功发送了 HMR 更新
+ */
+export function invalidateVirtualModule(server, virtualId) {
+    // 1. 获取虚拟模块在依赖图中的节点
+    const virtualMod = server.moduleGraph.getModuleById(`\0${virtualId}`);
+    if (!virtualMod || virtualMod.importers.size === 0)
+        return false;
+    // 2. 使虚拟模块缓存失效
+    server.moduleGraph.invalidateModule(virtualMod);
+    // 3. 递归收集虚拟模块的所有物理文件依赖者
+    const physicalImporters = collectPhysicalImporters(virtualMod);
+    if (physicalImporters.length === 0)
+        return false;
+    // 4. 向每个物理文件依赖者发送 HMR 更新信号
+    // acceptedPath 必须与 Vite 客户端内部的模块 ID 转换规则一致：
+    // 客户端 import.meta.hot.accept('virtual:xxx', cb) 注册时，
+    // Vite 会将 'virtual:xxx' 转换为 '/@id/__x00__virtual:xxx' 作为 accept 的 key，
+    // 所以 HMR update 中的 acceptedPath 也必须使用这个转换后的路径。
+    // 注意：/@id/ 和 __x00__ 是 Vite 内部约定，非公开 API，升级时需验证。
+    const acceptedPath = `/@id/__x00__${virtualId}`;
+    const timestamp = Date.now();
+    const updates = physicalImporters.map(importer => ({
+        type: 'js-update',
+        path: importer.url,
+        acceptedPath,
+        timestamp
+    }));
+    server.ws.send({ type: 'update', updates });
+    return true;
+}

package/package.json

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

package/dist/plugin-vite/watcher.d.ts

@@ -1,15 +0,0 @@
-import type { ViteDevServer } from 'vite';
-import { FileRouter, type FileWatcherEvent } from '../file-router/index.js';
-/**
- * 设置文件监听器
- *
- * 为开发服务器配置文件监听，监听页面目录下的文件变化。
- * 当文件发生变化时，自动更新路由配置并触发 HMR。
- *
- * @param router - 文件路由管理器实例
- * @param server - Vite 开发服务器实例
- * @param handleFileChange - 文件变化处理函数
- * @param delay - 节流延迟时间（毫秒）
- * @returns 文件监听器处理函数，用于后续清理
- */
-export declare function setupWatcher(router: FileRouter, server: ViteDevServer, handleFileChange: (event: FileWatcherEvent, file: string) => void, delay?: number): (event: FileWatcherEvent, file: string) => void;

package/dist/plugin-vite/watcher.js

@@ -1,65 +0,0 @@
-/**
- * 创建批量节流处理函数
- *
- * 在指定时间窗口内收集所有变化事件，然后批量处理。
- * 同一文件的多次变更会被合并，只保留最后一次事件。
- * 这可以避免在短时间内多次触发路由重新生成，同时确保
- * 所有文件变化都被正确处理，不会丢失任何更新。
- *
- * @param callback - 需要节流的回调函数
- * @param delay - 节流延迟时间（毫秒）
- * @returns 节流后的处理函数
- *
- * @example
- * ```typescript
- * const batchHandler = createBatchThrottledHandler(
- *   (event, file) => console.log(event, file),
- *   100
- * )
- *
- * // 快速调用多次，同文件变更会被合并
- * batchHandler('change', 'a.ts')
- * batchHandler('change', 'b.ts')
- * batchHandler('unlink', 'a.ts')  // 覆盖之前的 a.ts change
- * // 100ms 后，只处理 a.ts unlink 和 b.ts change
- * ```
- */
-function createBatchThrottledHandler(callback, delay) {
-    let pending = false;
-    const pendingChanges = new Map();
-    return (event, file) => {
-        pendingChanges.set(file, event);
-        if (pending)
-            return;
-        pending = true;
-        setTimeout(() => {
-            pending = false;
-            const changes = new Map(pendingChanges);
-            pendingChanges.clear();
-            for (const [f, e] of changes) {
-                callback(e, f);
-            }
-        }, delay);
-    };
-}
-/**
- * 设置文件监听器
- *
- * 为开发服务器配置文件监听，监听页面目录下的文件变化。
- * 当文件发生变化时，自动更新路由配置并触发 HMR。
- *
- * @param router - 文件路由管理器实例
- * @param server - Vite 开发服务器实例
- * @param handleFileChange - 文件变化处理函数
- * @param delay - 节流延迟时间（毫秒）
- * @returns 文件监听器处理函数，用于后续清理
- */
-export function setupWatcher(router, server, handleFileChange, delay = 100) {
-    const pagesDirs = router.config.pages;
-    for (const dirConfig of pagesDirs) {
-        server.watcher.add(dirConfig.dir);
-    }
-    const handler = createBatchThrottledHandler(handleFileChange, delay);
-    server.watcher.on('all', handler);
-    return handler;
-}