vitarx-router 4.0.0-beta.2 → 4.0.0-beta.21

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

@@ -5,7 +5,7 @@
  * 用于解析 definePage 宏的配置参数。
  */
 import type * as BabelTypes from '@babel/types';
-import type { PageOptions } from '../types.js';
+import type { PageOptions } from '../types/index.js';
 /**
  * 从对象表达式提取页面配置
  *

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

@@ -47,7 +47,11 @@ function extractStringRecord(node) {
     for (const prop of node.properties) {
         if (prop.type !== 'ObjectProperty')
             continue;
-        const key = prop.key.type === 'Identifier' ? prop.key.name : null;
+        const key = prop.key.type === 'Identifier'
+            ? prop.key.name
+            : prop.key.type === 'StringLiteral'
+                ? prop.key.value
+                : null;
         if (!key)
             continue;
         if (prop.value.type === 'StringLiteral') {
@@ -69,7 +73,11 @@ function extractMetaValue(node) {
     for (const prop of node.properties) {
         if (prop.type !== 'ObjectProperty')
             continue;
-        const key = prop.key.type === 'Identifier' ? prop.key.name : null;
+        const key = prop.key.type === 'Identifier'
+            ? prop.key.name
+            : prop.key.type === 'StringLiteral'
+                ? prop.key.value
+                : null;
         if (!key)
             continue;
         meta[key] = extractAstLiteralValue(prop.value);
@@ -91,7 +99,11 @@ function extractPatternValue(node) {
     for (const prop of node.properties) {
         if (prop.type !== 'ObjectProperty')
             continue;
-        const key = prop.key.type === 'Identifier' ? prop.key.name : null;
+        const key = prop.key.type === 'Identifier'
+            ? prop.key.name
+            : prop.key.type === 'StringLiteral'
+                ? prop.key.value
+                : null;
         if (!key)
             continue;
         const value = prop.value;
@@ -116,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') {
@@ -158,7 +170,11 @@ function extractRedirectValue(node) {
         for (const prop of node.properties) {
             if (prop.type !== 'ObjectProperty')
                 continue;
-            const key = prop.key.type === 'Identifier' ? prop.key.name : null;
+            const key = prop.key.type === 'Identifier'
+                ? prop.key.name
+                : prop.key.type === 'StringLiteral'
+                    ? prop.key.value
+                    : null;
             if (!key)
                 continue;
             if (key === 'index' && prop.value.type === 'StringLiteral') {
@@ -209,7 +225,11 @@ export function extractPageOptions(node) {
     for (const prop of node.properties) {
         if (prop.type !== 'ObjectProperty')
             continue;
-        const key = prop.key.type === 'Identifier' ? prop.key.name : null;
+        const key = prop.key.type === 'Identifier'
+            ? prop.key.name
+            : prop.key.type === 'StringLiteral'
+                ? prop.key.value
+                : null;
         if (!key)
             continue;
         switch (key) {

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

@@ -6,17 +6,26 @@
  * definePage 作为全局宏使用，无需导入，因此只需移除调用语句。
  */
 import type { GeneratorResult } from '@babel/generator';
-import type { PageOptions } from '../types.js';
+import type { PageOptions } from '../types/index.js';
+type Falsy = false | null | undefined | 0 | '';
+/**
+ * 合并多个页面配置
+ *
+ * @param optionsList - 配置列表
+ * @returns 合并后的配置
+ */
+export declare function mergePageOptions(...optionsList: (PageOptions | Falsy)[]): PageOptions;
 /**
  * 解析 definePage 宏配置
  *
  * definePage 作为全局宏使用，无需导入。
  * 直接查找代码中的 definePage 调用并提取配置。
  *
- * @param filePath - 页面文件路径
+ * @param content - 源代码
+ * @param filePath - 文件路径
  * @returns 解析出的页面配置，解析失败返回 null
  */
-export declare function parseDefinePage(filePath: string): PageOptions | null;
+export declare function parseDefinePage(content: string, filePath: string): PageOptions | null;
 /**
  * 移除 definePage 宏调用（仅在构建模式下）
  *
@@ -28,3 +37,11 @@ export declare function parseDefinePage(filePath: string): PageOptions | null;
  * @returns 转换后的代码，无需转换返回 null
  */
 export declare function removeDefinePage(code: string, filename: string): GeneratorResult | null;
+/**
+ * 判断两个页面配置是否相等
+ *
+ * @param a
+ * @param b
+ */
+export declare function isEqualPageOptions(a?: PageOptions | null, b?: PageOptions | null): boolean;
+export {};

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

@@ -5,8 +5,7 @@
  *
  * definePage 作为全局宏使用，无需导入，因此只需移除调用语句。
  */
-import fs from 'node:fs';
-import { babelGenerate, babelTraverse, parseCode, warn } from '../utils/index.js';
+import { babelGenerate, babelTraverse, error, parseCode, warn } from '../utils/index.js';
 import { extractPageOptions } from './astValueExtractor.js';
 /**
  * 合并多个页面配置
@@ -14,23 +13,19 @@ import { extractPageOptions } from './astValueExtractor.js';
  * @param optionsList - 配置列表
  * @returns 合并后的配置
  */
-function mergePageOptions(optionsList) {
+export function mergePageOptions(...optionsList) {
     const merged = {};
-    // 遍历所有配置，按优先级合并
     for (const options of optionsList) {
-        // 名称直接覆盖
+        if (!options)
+            continue;
         if (options.name)
             merged.name = options.name;
-        // meta 合并
         if (options.meta)
             merged.meta = { ...merged.meta, ...options.meta };
-        // pattern 合并
         if (options.pattern)
             merged.pattern = { ...merged.pattern, ...options.pattern };
-        // 重定向直接覆盖
         if (options.redirect)
             merged.redirect = options.redirect;
-        // 别名合并（支持字符串和数组形式）
         if (options.alias) {
             if (!merged.alias) {
                 merged.alias = options.alias;
@@ -50,55 +45,41 @@ function mergePageOptions(optionsList) {
  * definePage 作为全局宏使用，无需导入。
  * 直接查找代码中的 definePage 调用并提取配置。
  *
- * @param filePath - 页面文件路径
+ * @param content - 源代码
+ * @param filePath - 文件路径
  * @returns 解析出的页面配置，解析失败返回 null
  */
-export function parseDefinePage(filePath) {
-    // 检查文件是否存在
-    if (!fs.existsSync(filePath)) {
-        return null;
-    }
-    const content = fs.readFileSync(filePath, 'utf-8');
-    // 快速检查是否包含 definePage 调用
+export function parseDefinePage(content, filePath) {
     if (!content.includes('definePage')) {
         return null;
     }
     try {
-        // 解析代码为 AST
         const ast = parseCode(content);
-        const pageOptionsList = [];
-        // 遍历 AST 查找 definePage 调用
+        const routeOptionsList = [];
         babelTraverse(ast, {
             CallExpression(nodePath) {
                 const { node } = nodePath;
-                // 检查是否是 definePage 调用
                 if (node.callee.type !== 'Identifier' || node.callee.name !== 'definePage') {
                     return;
                 }
-                // 检查参数是否为对象表达式
                 const arg = node.arguments[0];
                 if (!arg || arg.type !== 'ObjectExpression') {
                     return;
                 }
-                // 提取页面配置
                 const options = extractPageOptions(arg);
-                pageOptionsList.push(options);
+                routeOptionsList.push(options);
             }
         });
-        // 没有找到 definePage 调用
-        if (pageOptionsList.length === 0) {
+        if (routeOptionsList.length === 0) {
             return null;
         }
-        // 处理多个 definePage 调用的情况
-        if (pageOptionsList.length > 1) {
-            warn('检测到多个 definePage 调用，将合并所有配置', '建议每个文件只调用一次 definePage');
+        if (routeOptionsList.length > 1) {
+            warn('检测到多个 definePage 调用，将合并所有配置，建议每个文件只调用一次 definePage', `in ${filePath}`);
         }
-        // 合并所有配置
-        return mergePageOptions(pageOptionsList);
+        return mergePageOptions(...routeOptionsList);
     }
     catch (e) {
-        // 解析失败，返回 null
-        warn('解析 definePage 失败', `${filePath}: ${e?.toString()}`);
+        error(`解析 definePage 失败 in ${e}`, e);
         return null;
     }
 }
@@ -113,29 +94,22 @@ export function parseDefinePage(filePath) {
  * @returns 转换后的代码，无需转换返回 null
  */
 export function removeDefinePage(code, filename) {
-    // 快速检查是否包含 definePage 调用
     if (!code.includes('definePage')) {
         return null;
     }
-    // 解析代码为 AST
     const ast = parseCode(code);
     let hasDefinePage = false;
-    // 遍历 AST 查找并移除 definePage 调用
     babelTraverse(ast, {
         CallExpression(nodePath) {
             const { node } = nodePath;
-            // 检查是否是 definePage 调用
             if (node.callee.type === 'Identifier' && node.callee.name === 'definePage') {
                 hasDefinePage = true;
-                // 移除节点
                 nodePath.remove();
             }
         }
     });
-    // 没有找到 definePage 调用
     if (!hasDefinePage)
         return null;
-    // 生成转换后的代码
     return babelGenerate(ast, {
         retainLines: false,
         compact: false,
@@ -144,3 +118,109 @@ export function removeDefinePage(code, filename) {
         sourceFileName: filename
     });
 }
+/** 普通 Record<string, string> 比较 */
+function recordEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    const keys = Object.keys(a);
+    if (keys.length !== Object.keys(b).length)
+        return false;
+    for (let i = 0; i < keys.length; i++) {
+        const k = keys[i];
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+}
+/** RegExp 结构比较 */
+function patternEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    const keys = Object.keys(a);
+    if (keys.length !== Object.keys(b).length)
+        return false;
+    for (let i = 0; i < keys.length; i++) {
+        const k = keys[i];
+        const ra = a[k];
+        const rb = b[k];
+        if (!rb)
+            return false;
+        // 关键：比较正则内容 + flags
+        if (ra.source !== rb.source || ra.flags !== rb.flags) {
+            return false;
+        }
+    }
+    return true;
+}
+/** redirect: string | Record */
+function redirectEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    const ta = typeof a;
+    const tb = typeof b;
+    // 类型不同，直接不等
+    if (ta !== tb)
+        return false;
+    // string
+    if (ta === 'string') {
+        return a === b;
+    }
+    // RedirectConfig
+    const ra = a;
+    const rb = b;
+    if (ra.index !== rb.index)
+        return false;
+    if (!recordEqual(ra.query, rb.query))
+        return false;
+    return recordEqual(ra.params, rb.params);
+}
+/** alias: string | string[] */
+function aliasEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    const arrA = Array.isArray(a) ? a : [a];
+    const arrB = Array.isArray(b) ? b : [b];
+    const len = arrA.length;
+    if (len !== arrB.length)
+        return false;
+    // ⚠️ 默认：顺序敏感（更安全，避免隐藏 bug）
+    for (let i = 0; i < len; i++) {
+        if (arrA[i] !== arrB[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * 判断两个页面配置是否相等
+ *
+ * @param a
+ * @param b
+ */
+export function isEqualPageOptions(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    // name
+    if (a.name !== b.name)
+        return false;
+    // meta
+    if (!recordEqual(a.meta, b.meta))
+        return false;
+    // pattern (RegExp)
+    if (!patternEqual(a.pattern, b.pattern))
+        return false;
+    // redirect
+    if (!redirectEqual(a.redirect, b.redirect))
+        return false;
+    // alias
+    return aliasEqual(a.alias, b.alias);
+}

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

@@ -1,27 +1,8 @@
-/**
- * 默认导出检测结果
- */
-export interface DefaultExportCheckResult {
-    /** 是否有默认导出 */
-    hasDefaultExport: boolean;
-    /** 默认导出是否为函数或类 */
-    isFunctionOrClass: boolean;
-    /** 导出名称（如果有） */
-    exportName: string | null;
-    /** 警告信息 */
-    warning: string | null;
-}
 /**
  * 检测文件是否具有有效的默认导出函数组件
  *
- * @param filePath - 文件路径
- * @returns 检测结果
- */
-export declare function checkDefaultExport(filePath: string): DefaultExportCheckResult;
-/**
- * 检查文件扩展名是否需要导出检测
- *
- * @param ext - 文件扩展名
- * @returns 是否需要检测
+ * @param content - 文件内容
+ * @param file - 文件路径
+ * @returns {boolean} 检测结果
  */
-export declare function shouldCheckExport(ext: string): boolean;
+export declare function checkDefaultExport(content: string, file: string): boolean;

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

@@ -1,7 +1,4 @@
-import fs from 'node:fs';
-import { parseCode, babelTraverse } from '../utils/babelUtils.js';
-/** 需要进行默认导出检测的文件扩展名 */
-const CHECK_EXPORT_EXTENSIONS = ['.tsx', '.ts', '.jsx', '.js'];
+import { babelTraverse, debug, parseCode, warn } from '../utils/index.js';
 /**
  * 收集变量声明
  *
@@ -23,9 +20,6 @@ function createVariableDeclarationVisitor(variableDeclarations) {
                     else if (node.init.type === 'FunctionExpression') {
                         variableDeclarations.set(name, 'function');
                     }
-                    else if (node.init.type === 'ClassExpression') {
-                        variableDeclarations.set(name, 'class');
-                    }
                     else {
                         variableDeclarations.set(name, 'unknown');
                     }
@@ -37,12 +31,6 @@ function createVariableDeclarationVisitor(variableDeclarations) {
             if (node.id) {
                 variableDeclarations.set(node.id.name, 'function');
             }
-        },
-        ClassDeclaration(nodePath) {
-            const { node } = nodePath;
-            if (node.id) {
-                variableDeclarations.set(node.id.name, 'class');
-            }
         }
     };
 }
@@ -62,16 +50,15 @@ function createExportDeclarationVisitor(result, variableDeclarations) {
             switch (declaration.type) {
                 case 'FunctionDeclaration':
                 case 'FunctionExpression':
+                case 'ArrowFunctionExpression':
                     result.isFunction = true;
-                    result.exportName = declaration.id?.name || null;
                     break;
-                case 'ArrowFunctionExpression':
+                case 'CallExpression':
                     result.isFunction = true;
                     break;
                 case 'Identifier':
-                    result.exportName = declaration.name;
                     const varType = variableDeclarations.get(declaration.name);
-                    if (varType === 'function' || varType === 'arrow' || varType === 'class') {
+                    if (varType === 'function' || varType === 'arrow') {
                         result.isFunction = true;
                     }
                     break;
@@ -110,11 +97,6 @@ function processNamedExportDeclarationNode(declaration, variableDeclarations) {
             variableDeclarations.set(declaration.id.name, 'function');
         }
     }
-    else if (declaration.type === 'ClassDeclaration') {
-        if (declaration.id) {
-            variableDeclarations.set(declaration.id.name, 'class');
-        }
-    }
     else if (declaration.type === 'VariableDeclaration') {
         for (const decl of declaration.declarations) {
             if (decl.id.type === 'Identifier') {
@@ -126,9 +108,6 @@ function processNamedExportDeclarationNode(declaration, variableDeclarations) {
                     else if (decl.init.type === 'FunctionExpression') {
                         variableDeclarations.set(name, 'function');
                     }
-                    else if (decl.init.type === 'ClassExpression') {
-                        variableDeclarations.set(name, 'class');
-                    }
                 }
             }
         }
@@ -149,9 +128,8 @@ function processExportSpecifiers(specifiers, result, variableDeclarations) {
                 : specifier.exported.value;
             if (exportedName === 'default') {
                 result.hasDefaultExport = true;
-                result.exportName = specifier.local.name;
                 const varType = variableDeclarations.get(specifier.local.name);
-                if (varType === 'function' || varType === 'arrow' || varType === 'class') {
+                if (varType === 'function' || varType === 'arrow') {
                     result.isFunction = true;
                 }
             }
@@ -161,68 +139,49 @@ function processExportSpecifiers(specifiers, result, variableDeclarations) {
 /**
  * 检测文件是否具有有效的默认导出函数组件
  *
- * @param filePath - 文件路径
- * @returns 检测结果
+ * @param content - 文件内容
+ * @param file - 文件路径
+ * @returns {boolean} 检测结果
  */
-export function checkDefaultExport(filePath) {
-    if (!fs.existsSync(filePath)) {
-        return {
-            hasDefaultExport: false,
-            isFunctionOrClass: false,
-            exportName: null,
-            warning: `文件不存在: ${filePath}`
-        };
-    }
-    const content = fs.readFileSync(filePath, 'utf-8');
-    if (!content.includes('export')) {
-        return {
-            hasDefaultExport: false,
-            isFunctionOrClass: false,
-            exportName: null,
-            warning: `未检测到默认导出 (default export)，该文件将被跳过。请确保导出一个函数组件。`
-        };
+export function checkDefaultExport(content, file) {
+    // 快速检测，避免对文件进行复杂的解析
+    if (!content.includes('export default')) {
+        debug(`⚠️ 未检测到默认导出 (default export)，该文件可能被跳过。请确保导出一个函数组件。`, `in ${file}`);
+        return false;
     }
+    // 解析文件内容为 AST 进行精确检查
+    const ast = parseCode(content);
+    const variableDeclarations = new Map();
+    const result = {
+        hasDefaultExport: false,
+        isFunction: false
+    };
     try {
-        const ast = parseCode(content);
-        const variableDeclarations = new Map();
-        const result = {
-            hasDefaultExport: false,
-            isFunction: false,
-            exportName: null
-        };
         babelTraverse(ast, {
             ...createVariableDeclarationVisitor(variableDeclarations),
-            ...createExportDeclarationVisitor(result, variableDeclarations)
+            ...createExportDeclarationVisitor(result, variableDeclarations),
+            CallExpression(nodePath) {
+                const { node } = nodePath;
+                if (node.callee.type === 'Identifier' && node.callee.name === 'console') {
+                    nodePath.remove();
+                }
+            }
         });
-        let warning = null;
+        let debugInfo = null;
         if (!result.hasDefaultExport) {
-            warning = `未检测到默认导出 (default export)，该文件将被跳过。请确保导出一个函数组件。`;
+            debugInfo = `⚠️ 未检测到默认导出 (default export)，该文件可能被跳过。请确保导出一个函数组件。`;
         }
         else if (!result.isFunction) {
-            warning = `默认导出不是函数或类，该文件将被跳过。请确保导出一个有效的 React 组件。`;
+            debugInfo = `⚠️ 默认导出的不是函数，该文件可能被跳过。请确保导出一个有效的函数组件。`;
         }
-        return {
-            hasDefaultExport: result.hasDefaultExport,
-            isFunctionOrClass: result.isFunction,
-            exportName: result.exportName,
-            warning
-        };
+        if (debugInfo) {
+            debug(debugInfo, `in ${file}`);
+            return false;
+        }
+        return true;
     }
-    catch (error) {
-        return {
-            hasDefaultExport: false,
-            isFunctionOrClass: false,
-            exportName: null,
-            warning: `解析文件失败: ${error instanceof Error ? error.message : String(error)}`
-        };
+    catch (e) {
+        warn(`⚠️ 无法解析文件 ${file}`, `${e instanceof Error ? e.message : String(e)}`);
+        return false;
     }
 }
-/**
- * 检查文件扩展名是否需要导出检测
- *
- * @param ext - 文件扩展名
- * @returns 是否需要检测
- */
-export function shouldCheckExport(ext) {
-    return CHECK_EXPORT_EXTENSIONS.includes(ext);
-}

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

@@ -0,0 +1,25 @@
+export interface FilterOptions {
+    dir: string;
+    include: readonly string[];
+    exclude: readonly string[];
+}
+/**
+ * 检查文件是否为页面文件（单目录版本）
+ *
+ * 支持 glob 模式匹配包含和排除规则。
+ *
+ * @param file - 文件路径
+ * @param options - 页面目录配置
+ * @returns 如果是有效的页面文件返回 true
+ */
+export declare function isPageFile(file: string, options: FilterOptions): boolean;
+/**
+ * 检查文件是否为页面文件（多目录版本）
+ *
+ * 遍历所有页面目录配置，检查文件是否属于任一目录。
+ *
+ * @param file - 文件路径
+ * @param pages - 页面目录配置列表
+ * @returns 如果是有效的页面文件返回 true
+ */
+export declare function isPageFileInDirs(file: string, pages: readonly FilterOptions[]): FilterOptions | false;

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

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview 文件过滤工具模块
+ *
+ * 提供基于 glob 模式的文件包含/排除过滤功能。
+ * 从 scanPages.ts 中提取，消除重复代码。
+ */
+import micromatch from 'micromatch';
+import path from 'node:path';
+import { normalizePathSeparator } from '../utils/index.js';
+/**
+ * 检查文件是否为页面文件（单目录版本）
+ *
+ * 支持 glob 模式匹配包含和排除规则。
+ *
+ * @param file - 文件路径
+ * @param options - 页面目录配置
+ * @returns 如果是有效的页面文件返回 true
+ */
+export function isPageFile(file, options) {
+    const { dir, include, exclude } = options;
+    if (!file.startsWith(dir))
+        return false;
+    const normalizedPath = normalizePathSeparator(path.relative(dir, file));
+    if (include.length === 0)
+        return true;
+    return micromatch.isMatch(normalizedPath, include, { dot: true, noext: true, ignore: exclude });
+}
+/**
+ * 检查文件是否为页面文件（多目录版本）
+ *
+ * 遍历所有页面目录配置，检查文件是否属于任一目录。
+ *
+ * @param file - 文件路径
+ * @param pages - 页面目录配置列表
+ * @returns 如果是有效的页面文件返回 true
+ */
+export function isPageFileInDirs(file, pages) {
+    for (const page of pages) {
+        if (isPageFile(file, page))
+            return page;
+    }
+    return false;
+}

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

@@ -3,4 +3,5 @@
  *
  * 导出所有解析相关功能，提供统一的访问入口。
  */
-export * from './parsePage.js';
+export * from './exportChecker.js';
+export * from './filterUtils.js';

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

@@ -3,4 +3,5 @@
  *
  * 导出所有解析相关功能，提供统一的访问入口。
  */
-export * from './parsePage.js';
+export * from './exportChecker.js';
+export * from './filterUtils.js';