@lcap/nasl-language-server-core 4.0.0-beta.26 → 4.0.0-beta.28

package/README.md

@@ -1,3 +1,88 @@
 # Nasl Language Server
 
 Nasl 语言服务
+
+## 描述
+
+NetEase Application Specific Language (NASL) 语言服务器核心包，提供 NASL 语言的类型检查、语法分析和其他语言服务功能。
+
+## 技术栈
+
+### 核心技术
+- **TypeScript 5.4.4** - 主要开发语言
+- **Node.js 18+** - 运行环境
+
+### 主要依赖
+- **@lcap/nasl-concepts** - NASL 概念定义
+- **@lcap/nasl-types** - NASL 类型系统
+- **@lcap/nasl-utils** - NASL 工具库
+- **decimal.js** - 精确数值计算
+- **json5** - JSON5 格式支持
+- **lodash** - 实用工具库
+- **mnemonist** - 数据结构库
+
+### 开发工具
+- **Vitest 3.2.4** - 现代测试框架
+- **Chai 4.3.7** - 断言库
+- **Mocha** - 传统测试框架（通过 @lcap/nasl-test-toolkit）
+
+## 开发
+
+### 构建
+```bash
+# 清理输出目录
+npm run clear
+
+# 构建项目
+npm run build
+
+# 监听模式构建
+npm run watch
+```
+
+### 测试
+
+#### Vitest 测试（推荐）
+```bash
+# 运行所有 Vitest 测试
+npm run test:vite
+
+# 监听模式运行测试
+npm run test:watch
+
+# 启动测试 UI 界面
+npm run test:ui
+```
+
+#### Mocha 测试 (遗留)
+
+注意:
+- Mocha 测试框架已经废弃，对于新的单元测试的编写，请使用 Vitest 测试框架。
+- Mocha 测试框架的测试用例，请迁移到 Vitest 测试框架。请参考 [TESTING_MIGRATION.md](./tests/TESTING_MIGRATION.md) 文件，让LLM自动化地完成迁移。
+
+```bash
+# 运行标准 Mocha 测试套件
+npm run test
+
+# 运行应用测试
+npm run test:apps
+
+# 运行 CI 测试
+npm run test:ci
+
+# 更新测试快照
+npm run test:update
+
+# 运行性能测试
+npm run test:perf
+```
+
+### 其他工具
+```bash
+# 压缩测试数据
+npm run compress-test-data
+```
+
+## 许可证
+
+MIT

package/out/checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../src/checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAU0F,GAAG,EAMvG,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACgE,cAAc,EAGpF,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAIhE,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGpE,oBAAY,QAAQ;IAClB,IAAI,YAAY;IAChB,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAEnE,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAMF,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAMrE,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAqBF,KAAK,eAAe,GAAG;IACrB,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,yBAAyB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAiQF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe;oCAmlIpB,OAAO;sDAPW,gBAAgB,EAAE;;;;sBAhBjD,UAAU,GAAG,SAAS;;;8BA4Df,UAAU;2BAuBb,UAAU;;kBAvlInB,UAAU,WAAW,MAAM,YAAY,YAAY;EAymIzE;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACrC,mBAAmB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,qBAAqB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,6BAA6B,aAAc,UAAU,sCAAoC,MAAM,gBAAgB,CAmC3H,CAAA;AAMD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../src/checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAU0F,GAAG,EAMvG,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACgE,cAAc,EAGpF,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAIhE,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAIpE,oBAAY,QAAQ;IAClB,IAAI,YAAY;IAChB,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAEnE,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAMF,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAMrE,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAqBF,KAAK,eAAe,GAAG;IACrB,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,yBAAyB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAiQF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe;oCAmmIpB,OAAO;sDAPW,gBAAgB,EAAE;;;;sBAhBjD,UAAU,GAAG,SAAS;;;8BA4Df,UAAU;2BAuBb,UAAU;;kBAvmInB,UAAU,WAAW,MAAM,YAAY,YAAY;EAynIzE;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACrC,mBAAmB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,qBAAqB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,6BAA6B,aAAc,UAAU,sCAAoC,MAAM,gBAAgB,CAmC3H,CAAA;AAMD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/out/checker.js

@@ -338,6 +338,15 @@ function createErrorDiagnoser(context) {
         }
         else { }
     }
+    function scopedError(node, message, context) {
+        const scope = node?.constructor?.nodeTitle;
+        if (scope) {
+            error(node, `${scope}：${message}`, context);
+        }
+        else {
+            error(node, message, context);
+        }
+    }
     /**
      * 获取当前错误信息
      * @param node
@@ -691,7 +700,7 @@ function createErrorDiagnoser(context) {
      * @returns
      */
     function isNonRequiredParam(param) {
-        return param?.defaultValue?.expression || param?.defaultExpression || param?.optional || param?.spread || (nasl_concepts_1.asserts.isInterfaceParam(param) && !param.required);
+        return param?.defaultValue?.expression || param?.defaultExpression || param?.optional || (nasl_concepts_1.asserts.isInterfaceParam(param) && !param.required);
     }
     /**
      * 确定函数签名中所需的最小参数数量
@@ -701,6 +710,9 @@ function createErrorDiagnoser(context) {
         let minArgsCount = 0;
         for (let i = 0; i < paramLen; i++) {
             const param = params[i];
+            if (param?.spread) {
+                continue;
+            }
             if (!isNonRequiredParam(param)) {
                 minArgsCount++; // 如果参数有默认值，则跳过
             }
@@ -823,13 +835,17 @@ function createErrorDiagnoser(context) {
         }
         yield* (0, nasl_utils_1.wrapForEachToGenerator)(args, function* (arg, index) {
             const param = params?.[index];
-            if (!param)
-                return;
-            const isParamRequired = !(hasSpreadParam && index > spreadParamIndex) && !isNonRequiredParam(param);
+            // 若 param 的定义不存在，则默认是必填的。
+            const isParamRequired = param ? !isNonRequiredParam(param) : true;
             arg.paramRequired = isParamRequired;
+            // 即便是 param 的定义不存在，也需要检查 arg。这样可以检查出 arg 是否引用了一些未定义的变量
+            const argType = yield* checkNode(arg);
+            if (!param) {
+                return;
+            }
             const paramType = param.typeAnnotation ??
                 (nasl_concepts_1.asserts.isTypeAnnotation(param) ? param : env.getType(param));
-            const argType = yield* checkNode(arg);
+            // 检查高阶函数参数个数是否匹配
             if (paramType?.typeKind === 'function' && argType?.typeKind === 'function') {
                 const argTypeArgs = argType?.typeArguments || [];
                 const paramTypeArgs = paramType?.typeArguments || [];
@@ -3268,14 +3284,6 @@ function createErrorDiagnoser(context) {
                 }
                 else {
                     const { name } = node;
-                    // 之前有一些脏数据，先兼容
-                    // if (['true', 'false'].includes(name)) {
-                    //   return new TypeAnnotation({
-                    //     typeKind: 'primitive',
-                    //     typeName: 'Boolean',
-                    //     typeNamespace: 'nasl.core',
-                    //   });
-                    // }
                     if (
                     // name 是 A.B.C
                     name?.split('.')?.length > 1
@@ -3290,6 +3298,13 @@ function createErrorDiagnoser(context) {
                     return errorType;
                 }
             }
+            if (node.namespace === 'app.enums' &&
+                node.parentNode?.concept !== 'MemberExpression' &&
+                node.parentNode?.concept !== 'SelectMembers') {
+                // 判断枚举类是否直接被使用
+                scopedError(node, `${node.toNaturalTS()} 枚举类不能直接使用，请取它的枚举项`);
+                return errorType;
+            }
             // 检查使用范围
             yield* checkScopeOfUse(node, ref);
             return env.getType(node);