vitarx-router 4.0.1 → 4.0.3

package/LICENSE

@@ -1,27 +1,21 @@
-# MIT License
-
-## 版权声明
-
-版权所有 (c) 2024-present 朱冲林
-
-## 许可条款
-
-特此授予任何获得本软件及相关文档文件（以下简称“软件”）副本的个人或组织以下权利，且不受限制地行使以下权利：
-
-1. **使用**：允许在任何用途中使用本软件。
-2. **复制**：允许复制本软件。
-3. **修改**：允许修改本软件。
-4. **合并**：允许将本软件合并到其他作品中。
-5. **发布**：允许发布本软件。
-6. **分发**：允许分发本软件。
-7. **再许可**：允许对本软件进行再许可。
-8. **销售**：允许销售本软件的副本。
-
-## 条件
-
-上述版权声明和本许可声明须包含在本软件的所有副本或实质性部分中。
-
-## 免责声明
-
-本软件按“原样”提供，不提供任何形式的明示或暗示担保，包括但不限于对适销性、特定用途适用性和非侵权性的担保。
-在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他行为中产生的，还是与本软件或使用本软件有关的。
+MIT License
+
+Copyright (c) 2024 - present, ZhuChongLin <8210856@qq.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -6,10 +6,22 @@
  */
 import type * as BabelTypes from '@babel/types';
 import type { PageOptions } from '../types/index.js';
+/**
+ * 不支持节点的警告信息
+ */
+export interface UnsupportedNodeWarning {
+    /** 不支持的 AST 节点类型 */
+    nodeType: string;
+    /** 属性访问路径，如 "meta.nav.items[0].label" */
+    path: string;
+    /** 修复建议 */
+    suggestion: string;
+}
 /**
  * 从对象表达式提取页面配置
  *
  * @param node - 对象表达式节点
- * @returns 页面配置
+ * @param warnings - 警告收集器（可选，不传则不收集警告）
+ * @returns 页面配置和警告列表
  */
-export declare function extractPageOptions(node: BabelTypes.ObjectExpression): PageOptions;
+export declare function extractPageOptions(node: BabelTypes.ObjectExpression, warnings?: UnsupportedNodeWarning[]): PageOptions;

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

@@ -1,12 +1,46 @@
+/**
+ * 不支持节点类型到修复建议的映射
+ */
+const UNSUPPORTED_NODE_SUGGESTIONS = {
+    Identifier: '不支持变量引用，请使用字面量值。例如将 { name: myVar } 改为 { name: "value" }',
+    MemberExpression: '不支持属性访问表达式，请使用字面量值。例如将 { api: config.url } 改为 { api: "https://example.com" }',
+    CallExpression: '不支持函数调用，请使用字面量值。例如将 { id: genId() } 改为 { id: "static-id" }',
+    ArrowFunctionExpression: '不支持箭头函数，请使用字面量值。例如将 { handler: () => {} } 改为 { handler: "handlerName" }',
+    FunctionExpression: '不支持函数表达式，请使用字面量值。例如将 { handler: function() {} } 改为 { handler: "handlerName" }',
+    NewExpression: '不支持 new 表达式（除 new RegExp 外），请使用字面量值',
+    SpreadElement: '不支持展开运算符，请显式列出所有属性',
+    ConditionalExpression: '不支持三元表达式，请使用字面量值。例如将 { val: cond ? "a" : "b" } 改为 { val: "a" }',
+    BinaryExpression: '不支持二元运算表达式，请使用字面量值。例如将 { val: 1 + 2 } 改为 { val: 3 }',
+    LogicalExpression: '不支持逻辑运算表达式，请使用字面量值。例如将 { val: a || "default" } 改为 { val: "default" }',
+    SequenceExpression: '不支持逗号表达式，请使用字面量值',
+    AssignmentExpression: '不支持赋值表达式，请使用字面量值',
+    UpdateExpression: '不支持更新表达式，请使用字面量值。例如将 { val: i++ } 改为 { val: 1 }',
+    TaggedTemplateExpression: '不支持标签模板字符串，请使用普通字符串字面量',
+    ClassExpression: '不支持类表达式，请使用字面量值',
+    ObjectMethod: '不支持对象方法定义，请使用字面量值。例如将 { fn() {} } 改为 { fn: "methodName" }'
+};
+/**
+ * 获取不支持节点的修复建议
+ *
+ * @param nodeType - AST 节点类型
+ * @returns 修复建议
+ */
+function getSuggestion(nodeType) {
+    return (UNSUPPORTED_NODE_SUGGESTIONS[nodeType] ??
+        `不支持 ${nodeType} 类型的表达式，definePage 配置仅支持静态字面量值（字符串、数字、布尔、null、对象、数组、正则、一元表达式、简单模板字符串）`);
+}
 /**
  * 提取字面量值
  *
  * 从 AST 节点提取 JavaScript 字面量值。
+ * 遇到不支持的节点类型时，将警告信息收集到 warnings 数组中。
  *
  * @param node - AST 节点
+ * @param currentPath - 当前属性访问路径
+ * @param warnings - 警告收集器
  * @returns 提取的值
  */
-function extractAstLiteralValue(node) {
+function extractAstLiteralValue(node, currentPath, warnings) {
     switch (node.type) {
         case 'StringLiteral':
             return node.value;
@@ -16,11 +50,57 @@ function extractAstLiteralValue(node) {
             return node.value;
         case 'NullLiteral':
             return null;
+        case 'RegExpLiteral':
+            return new RegExp(node.pattern, node.flags || '');
+        case 'TemplateLiteral': {
+            // 仅支持无表达式的简单模板字符串，如 `hello`
+            if (node.quasis.length === 1 && node.expressions.length === 0) {
+                return node.quasis[0].value.cooked;
+            }
+            warnings.push({
+                nodeType: node.type,
+                path: currentPath,
+                suggestion: '不支持带插值表达式的模板字符串，请使用纯字符串字面量。例如将 `Hello ${name}` 改为 "Hello World"'
+            });
+            return undefined;
+        }
+        case 'UnaryExpression': {
+            const arg = extractAstLiteralValue(node.argument, currentPath, warnings);
+            if (arg === undefined || arg === null)
+                return undefined;
+            switch (node.operator) {
+                case '-':
+                    return -arg;
+                case '+':
+                    return +arg;
+                case '!':
+                    return !arg;
+                case '~':
+                    return ~arg;
+                case 'void':
+                    return undefined;
+                default:
+                    warnings.push({
+                        nodeType: node.type,
+                        path: currentPath,
+                        suggestion: `不支持 "${node.operator}" 一元运算符，仅支持 -, +, !, ~, void`
+                    });
+                    return undefined;
+            }
+        }
         case 'ArrayExpression':
-            return node.elements.map(elem => (elem ? extractAstLiteralValue(elem) : null));
+            return node.elements.map((elem, index) => elem ? extractAstLiteralValue(elem, `${currentPath}[${index}]`, warnings) : null);
         case 'ObjectExpression': {
             const obj = {};
             for (const prop of node.properties) {
+                if (prop.type === 'ObjectMethod') {
+                    warnings.push({
+                        nodeType: 'ObjectMethod',
+                        path: currentPath,
+                        suggestion: getSuggestion('ObjectMethod')
+                    });
+                    continue;
+                }
                 if (prop.type !== 'ObjectProperty')
                     continue;
                 const key = prop.key.type === 'Identifier'
@@ -29,13 +109,19 @@ function extractAstLiteralValue(node) {
                         ? prop.key.value
                         : null;
                 if (key) {
-                    obj[key] = extractAstLiteralValue(prop.value);
+                    obj[key] = extractAstLiteralValue(prop.value, `${currentPath}.${key}`, warnings);
                 }
             }
             return obj;
         }
-        default:
+        default: {
+            warnings.push({
+                nodeType: node.type,
+                path: currentPath,
+                suggestion: getSuggestion(node.type)
+            });
             return undefined;
+        }
     }
 }
 /**
@@ -68,9 +154,11 @@ function extractStringRecord(node) {
  * 提取 meta 值
  *
  * @param node - AST 节点
+ * @param currentPath - 当前属性访问路径
+ * @param warnings - 警告收集器
  * @returns meta 对象
  */
-function extractMetaValue(node) {
+function extractMetaValue(node, currentPath, warnings) {
     if (node.type !== 'ObjectExpression')
         return undefined;
     const meta = {};
@@ -84,7 +172,7 @@ function extractMetaValue(node) {
                 : null;
         if (!key)
             continue;
-        meta[key] = extractAstLiteralValue(prop.value);
+        meta[key] = extractAstLiteralValue(prop.value, `${currentPath}.${key}`, warnings);
     }
     return meta;
 }
@@ -222,10 +310,12 @@ function extractAliasValue(node) {
  * 从对象表达式提取页面配置
  *
  * @param node - 对象表达式节点
- * @returns 页面配置
+ * @param warnings - 警告收集器（可选，不传则不收集警告）
+ * @returns 页面配置和警告列表
  */
-export function extractPageOptions(node) {
+export function extractPageOptions(node, warnings) {
     const options = {};
+    const warnList = warnings ?? [];
     for (const prop of node.properties) {
         if (prop.type !== 'ObjectProperty')
             continue;
@@ -243,7 +333,7 @@ export function extractPageOptions(node) {
                 }
                 break;
             case 'meta':
-                options.meta = extractMetaValue(prop.value);
+                options.meta = extractMetaValue(prop.value, 'meta', warnList);
                 break;
             case 'pattern':
                 options.pattern = extractPatternValue(prop.value);

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

@@ -56,6 +56,7 @@ export function parseDefinePage(content, filePath) {
     try {
         const ast = parseCode(content);
         const routeOptionsList = [];
+        const warnings = [];
         babelTraverse(ast, {
             CallExpression(nodePath) {
                 const { node } = nodePath;
@@ -66,7 +67,7 @@ export function parseDefinePage(content, filePath) {
                 if (!arg || arg.type !== 'ObjectExpression') {
                     return;
                 }
-                const options = extractPageOptions(arg);
+                const options = extractPageOptions(arg, warnings);
                 routeOptionsList.push(options);
             }
         });
@@ -76,6 +77,10 @@ export function parseDefinePage(content, filePath) {
         if (routeOptionsList.length > 1) {
             warn('检测到多个 definePage 调用，将合并所有配置，建议每个文件只调用一次 definePage', `in ${filePath}`);
         }
+        // 输出不支持节点的警告
+        for (const w of warnings) {
+            warn(`definePage 配置解析警告: 路径 "${w.path}" 处遇到不支持的 ${w.nodeType} 节点，该属性值将被忽略。${w.suggestion}`, `in ${filePath}`);
+        }
         return mergePageOptions(...routeOptionsList);
     }
     catch (e) {

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

@@ -6,16 +6,14 @@
  */
 export function findRoute(routes, path) {
     for (const route of routes) {
-        if (!route.isGroup && route.fullPath === path)
-            return route;
-        if (route.isGroup && route.children) {
-            for (const child of route.children) {
-                if (child.fullPath === path)
-                    return route;
-                if (child.isGroup && child.children) {
-                    return findRoute(child.children, path);
-                }
-            }
+        if (!route.isGroup) {
+            if (route.fullPath === path)
+                return route;
+        }
+        else if (route.children) {
+            const result = findRoute(route.children, path);
+            if (result)
+                return result;
         }
     }
     return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitarx-router",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "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",