@nudojs/parser 1.4.22 → 1.4.24

package/dist/index.d.ts

@@ -217,6 +217,14 @@ declare function extractDirectivesQuiet(ast: Node): FunctionWithDirectives[];
  * runWithDirectiveDiags 域（无则丢弃，纯查询形态）。
  */
 declare function extractInlineDirectives(node: Node, opts?: ExtractDirectivesOpts): InlineDirective[];
-declare function extractFileDirectives(ast: Node): FileDirective[];
+/**
+ * 从 AST 抽文件级指令（`@nudo:env` / `@nudo:mock-module`，只认行注释）。
+ *
+ * `diags`：调用方自备的诊断累积数组——JSDoc/块注释内错位的文件级指令族
+ * 标签发 nudo:directive-syntax 警告（单次调用内同文案去重）。不传时为
+ * 纯查询形态：诊断丢弃；若外层有 runWithDirectiveDiags 活动域，则落入
+ * 该域并与其共享去重。
+ */
+declare function extractFileDirectives(ast: Node, opts?: ExtractDirectivesOpts): FileDirective[];
 
 export { type AsDirective, type CaseDirective, type Directive, type DirectiveDiag, type EnvDirective, type ExtractDirectivesOpts, type FileDirective, type FunctionWithDirectives, type InlineDirective, type InstanceMethod, type MockDirective, type MockModuleDirective, type PureDirective, type ReplaceDirective, type SampleDirective, type SinonExpression, type SkipDirective, asAssignmentExpression, asExpression, asIdentifier, asMemberExpression, asProgram, classIdName, classInstanceMethods, classMemberKey, classMemberKeyName, exportSpecifierExportedName, exportSpecifierLocalName, extractDirectives, extractDirectivesQuiet, extractFileDirectives, extractInlineDirectives, fnOrClassIdLoc, fnOrClassIdName, getClassMembers, getDeclarations, getDeclaratorId, getDeclaratorInit, getExportDeclaration, getExportSpecifiers, getExpressionStatementExpression, getFirstDeclaratorId, identifierName, isModuleExportsMember, memberObjectName, memberPropertyKey, memberPropertyName, methodFunctionNode, nameOrStringValue, paramDisplayName, paramName, parse, parseCaseArgExpr, programBody, runWithDirectiveDiags, unwrapDefaultExport, unwrapExport };

package/dist/index.js

@@ -1117,11 +1117,37 @@ function findReplaceSeparator(raw) {
 }
 var ENV_REGEX = /^\/?\s*@nudo:env\s+(.+)/;
 var MOCK_MODULE_REGEX = /^\/?\s*@nudo:mock-module\s+(.+)/;
-function extractFileDirectives(ast) {
+var FILE_TAG_IN_BLOCK_REGEX = /(?:^|\n)[ \t]*(?:\*[ \t]*)?@nudo:(env|mock-module)\b/g;
+function warnMisplacedFileTags(blockText) {
+  FILE_TAG_IN_BLOCK_REGEX.lastIndex = 0;
+  let m;
+  while (m = FILE_TAG_IN_BLOCK_REGEX.exec(blockText)) {
+    const tag = m[1];
+    emitDirectiveDiag({
+      code: "nudo:directive-syntax",
+      message: tag === "env" ? `@nudo:env is a file-level directive \u2014 use '/// @nudo:env node' at the top of the file (JSDoc block form is ignored)` : `@nudo:mock-module is a file-level directive \u2014 use '/// @nudo:mock-module "fs" from "./mock-fs.js"' at the top of the file (JSDoc block form is ignored)`
+    });
+  }
+}
+function extractFileDirectives(ast, opts) {
+  if (!opts?.diags) return collectFileDirectives(ast);
+  const prev = activeDiagSink;
+  activeDiagSink = { list: opts.diags, seen: /* @__PURE__ */ new Set() };
+  try {
+    return collectFileDirectives(ast);
+  } finally {
+    activeDiagSink = prev;
+  }
+}
+function collectFileDirectives(ast) {
   const results = [];
   if (ast.type !== "File") return results;
   const comments = ast.comments ?? [];
   for (const comment of comments) {
+    if (comment.type === "CommentBlock") {
+      warnMisplacedFileTags(comment.value);
+      continue;
+    }
     if (comment.type !== "CommentLine") continue;
     const text = comment.value;
     const mockModuleMatch = text.match(MOCK_MODULE_REGEX);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nudojs/parser",
-  "version": "1.4.22",
+  "version": "1.4.24",
   "engines": {
     "node": ">=20"
   },
@@ -39,7 +39,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@nudojs/core": "1.13.0",
+    "@nudojs/core": "1.14.1",
     "@babel/types": "^8.0.6"
   },
   "scripts": {