@cjser/es-joy__jsdoccomment 0.98.0-cjser.2 → 1.0.0-cjser.2

package/CHANGES.md

@@ -1,5 +1,17 @@
 # CHANGES for `@es-joy/jsdoccomment`
 
+## 1.0.0
+
+- chore: update jsdoc-type-pratt-parser, devDep.
+
+## 0.100.0
+
+- chore: update typescript-eslint/types, jsdoc-type-pratt-parser, devDeps
+
+## 0.99.0
+
+- chore: update typescript-eslint/types, jsdoc-type-pratt-parser, devDeps
+
 ## 0.98.0
 
 - chore: update typescript-eslint/types, comment-parser, jsdoc-type-pratt-parser, devDeps

package/dist-cjser/index.cjs

@@ -27,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/index.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/index.js
 var index_exports = {};
 __export(index_exports, {
   commentHandler: () => commentHandler,
@@ -52,11 +52,11 @@ module.exports = __toCommonJS(index_exports);
 var import_jsdoc_type_pratt_parser4 = require("@cjser/jsdoc-type-pratt-parser");
 __reExport(index_exports, require("@cjser/jsdoc-type-pratt-parser"), module.exports);
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/commentHandler.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/commentHandler.js
 var import_esquery = __toESM(require("esquery"), 1);
 var import_jsdoc_type_pratt_parser2 = require("@cjser/jsdoc-type-pratt-parser");
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/commentParserToESTree.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/commentParserToESTree.js
 var import_jsdoc_type_pratt_parser = require("@cjser/jsdoc-type-pratt-parser");
 var stripEncapsulatingBrackets = (container, isArr) => {
   if (isArr) {
@@ -318,17 +318,18 @@ var commentParserToESTree = (jsdoc, mode = "typescript", {
         }
       }
     }
-    if (end && tag) {
-      ast.terminal = end;
-      ast.hasPreterminalTagDescription = 1;
-      if (ast.terminal === "*/") {
-        ast.preterminalLineBreak = "";
-      }
-      cleanUpLastTag(
-        /** @type {JsdocTag} */
-        lastTag
-      );
+    if (!end || !tag) {
+      return;
+    }
+    ast.terminal = end;
+    ast.hasPreterminalTagDescription = 1;
+    if (ast.terminal === "*/") {
+      ast.preterminalLineBreak = "";
     }
+    cleanUpLastTag(
+      /** @type {JsdocTag} */
+      lastTag
+    );
   });
   ast.lastDescriptionLine = lastDescriptionLine;
   ast.tags = tags;
@@ -342,7 +343,7 @@ var jsdocVisitorKeys = {
   JsdocInlineTag: []
 };
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/commentHandler.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/commentHandler.js
 var commentHandler = (settings, commentParserToESTreeOptions) => {
   return (commentSelector, jsdoc) => {
     const { mode } = settings;
@@ -371,10 +372,10 @@ var commentHandler = (settings, commentParserToESTreeOptions) => {
   };
 };
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/estreeToString.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/estreeToString.js
 var import_jsdoc_type_pratt_parser3 = require("@cjser/jsdoc-type-pratt-parser");
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/inlineTagEscapes.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/inlineTagEscapes.js
 function getLabelDelimiter(format) {
   return format === "prefix" ? "]" : "}";
 }
@@ -418,7 +419,7 @@ function encodeInlineTagText(text, format) {
   return encoded;
 }
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/estreeToString.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/estreeToString.js
 var stringifiers = {
   /* eslint-enable jsdoc/reject-function-type -- Different functions */
   JsdocBlock,
@@ -574,7 +575,7 @@ function JsdocTag(node, opts) {
   return result;
 }
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/jsdoccomment.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/jsdoccomment.js
 var isCommentToken = (token) => {
   return ["Line", "Block", "Shebang"].includes(token.type);
 };
@@ -628,13 +629,10 @@ var getTSFunctionComment = function(astNode) {
         return astNode;
       }
       if (greatGrandparent.type === "VariableDeclarator") {
-        if (!greatGreatGrandparent || !greatGreatGrandparent.parent) {
-          return astNode;
-        }
-        return greatGreatGrandparent.parent;
+        return !greatGreatGrandparent || !greatGreatGrandparent.parent ? astNode : greatGreatGrandparent.parent;
       }
       return astNode;
-    /* v8 ignore stop */
+    /* v8 ignore stop -- End of defensive fallback */
     case "FunctionExpression":
       if (!greatGreatGrandparent) {
         return astNode;
@@ -653,17 +651,14 @@ var getTSFunctionComment = function(astNode) {
   }
   switch (greatGrandparent.type) {
     case "ArrowFunctionExpression":
-      if (greatGreatGrandparent.type === "VariableDeclarator" && greatGreatGrandparent.parent.type === "VariableDeclaration") {
-        return greatGreatGrandparent.parent;
-      }
-      return astNode;
+      return greatGreatGrandparent.type === "VariableDeclarator" && greatGreatGrandparent.parent.type === "VariableDeclaration" ? greatGreatGrandparent.parent : astNode;
     case "FunctionDeclaration":
       return greatGrandparent;
     case "VariableDeclarator":
       if (greatGreatGrandparent.type === "VariableDeclaration") {
         return greatGreatGrandparent;
       }
-    /* v8 ignore next 2 */
+    /* v8 ignore next 2 -- Defensive fallthrough to default */
     // Fallthrough
     default:
       return astNode;
@@ -739,10 +734,7 @@ var getReducedASTNode = function(nodeInput, sourceCode, settings) {
           }
         }
         if (parent && parent.type !== "FunctionDeclaration" && parent.type !== "Program") {
-          if (parent.parent && parent.parent.type === "ExportNamedDeclaration") {
-            return parent.parent;
-          }
-          return parent;
+          return parent.parent && parent.parent.type === "ExportNamedDeclaration" ? parent.parent : parent;
         }
       }
       return node;
@@ -980,7 +972,7 @@ var getFollowingComment = function(sourceCode, astNodeInput) {
           astNode.expression
         );
         break;
-      /* v8 ignore next 3 */
+      /* v8 ignore next 3 -- Defensive: no other node types expected */
       default:
         break;
     }
@@ -988,10 +980,10 @@ var getFollowingComment = function(sourceCode, astNodeInput) {
   return tokenAfter;
 };
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/parseComment.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/parseComment.js
 var import_comment_parser = require("comment-parser");
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/parseInlineTags.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/parseInlineTags.js
 function determineFormat(match) {
   const { separator, text } = match.groups;
   const [, textEnd] = match.indices.groups.text;
@@ -1002,10 +994,7 @@ function determineFormat(match) {
   if (separator === "|") {
     return "pipe";
   }
-  if (textEnd < tagStart) {
-    return "prefix";
-  }
-  return "space";
+  return textEnd < tagStart ? "prefix" : "space";
 }
 function parseDescription(description) {
   const result = [];
@@ -1068,7 +1057,7 @@ function parseInlineTags(block) {
   );
 }
 
-// packages/@cjser/es-joy__jsdoccomment.tmp-26-1789749139393/src/parseComment.js
+// packages/@cjser/es-joy__jsdoccomment.tmp-26-1792686817497/src/parseComment.js
 var {
   name: nameTokenizer,
   tag: tagTokenizer,
@@ -1128,10 +1117,7 @@ var getTokenizers = ({
      * @returns {import('comment-parser').Spec}
      */
     (spec) => {
-      if (noTypes.includes(spec.tag)) {
-        return spec;
-      }
-      return preserveTypeTokenizer(spec);
+      return noTypes.includes(spec.tag) ? spec : preserveTypeTokenizer(spec);
     },
     /**
      * Name tokenizer.
@@ -1167,10 +1153,7 @@ var getTokenizers = ({
         tokens.lineEnd = lineEnd || "";
         return spec;
       }
-      if (noNames.includes(spec.tag) || hasSeeWithLink(spec)) {
-        return spec;
-      }
-      return plainNameTokenizer(spec);
+      return noNames.includes(spec.tag) || hasSeeWithLink(spec) ? spec : plainNameTokenizer(spec);
     },
     /**
      * Description tokenizer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjser/es-joy__jsdoccomment",
-  "version": "0.98.0-cjser.2",
+  "version": "1.0.0-cjser.2",
   "author": "Brett Zamir <brettz9@yahoo.com>",
   "contributors": [],
   "description": "Maintained replacement for ESLint's deprecated SourceCode#getJSDocComment along with other jsdoc utilities",
@@ -45,32 +45,33 @@
   },
   "dependencies": {
     "@types/estree": "^1.0.9",
-    "@typescript-eslint/types": "^8.70.0",
+    "@typescript-eslint/types": "^8.72.0",
     "comment-parser": "1.4.9",
     "esquery": "^1.7.0",
-    "@cjser/jsdoc-type-pratt-parser": "9.2.2-cjser.2"
+    "@cjser/jsdoc-type-pratt-parser": "9.4.0-cjser.2"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
+    "@es-joy/escodegen": "^4.2.0",
     "@node-static/node-static": "^0.10.0",
     "@types/esquery": "^1.5.4",
     "@types/estraverse": "^5.1.7",
-    "@typescript-eslint/visitor-keys": "^8.70.0",
+    "@typescript-eslint/visitor-keys": "^8.72.0",
     "@typhonjs-build-test/esm-d-ts": "0.4.0",
     "@typhonjs-typedoc/typedoc-pkg": "^0.4.2",
-    "@vitest/coverage-v8": "^5.0.1",
-    "@vitest/ui": "^5.0.1",
-    "@webcoder49/code-input": "^2.8.4",
-    "eslint": "^10.10.0",
-    "eslint-config-ash-nazg": "43.1.10",
-    "eslint-plugin-jsdoc": "^64.5.2",
+    "@vitest/coverage-v8": "^5.0.5",
+    "@vitest/ui": "^5.0.5",
+    "@webcoder49/code-input": "^2.9.0",
+    "eslint": "^10.13.0",
+    "eslint-config-ash-nazg": "43.2.4",
+    "eslint-plugin-jsdoc": "^65.4.0",
     "espree": "^11.2.0",
     "estraverse": "^5.3.0",
     "prismjs": "^1.30.0",
     "typedoc": "^0.28.20",
     "typescript": "6.0.3",
-    "typescript-eslint": "^8.70.0",
-    "vitest": "^5.0.1"
+    "typescript-eslint": "^8.72.0",
+    "vitest": "^5.0.5"
   },
   "files": [
     "/dist",
@@ -90,18 +91,18 @@
     "open": "open ./coverage/index.html",
     "test": "npm run lint && npm run build && npm run test-cov",
     "test-ui": "vitest --ui --coverage",
-    "test-cov": "vitest --coverage",
+    "test-cov": "vitest --coverage --run",
     "tsc": "tsc",
     "tsc:ts7": "npx -y -p typescript@^7 -c \"tsc\"",
     "types": "esm-d-ts gen ./src/index.js --output ./dist/index.d.ts"
   },
   "main": "./dist-cjser/index.cjs",
   "cjser": {
-    "sourceVersion": "0.98.0",
+    "sourceVersion": "1.0.0",
     "cjserVersion": 2,
     "original": {
       "name": "@es-joy/jsdoccomment",
-      "version": "0.98.0",
+      "version": "1.0.0",
       "exports": {
         ".": {
           "types": "./dist/index.d.ts",
@@ -114,10 +115,10 @@
       },
       "dependencies": {
         "@types/estree": "^1.0.9",
-        "@typescript-eslint/types": "^8.70.0",
+        "@typescript-eslint/types": "^8.72.0",
         "comment-parser": "1.4.9",
         "esquery": "^1.7.0",
-        "jsdoc-type-pratt-parser": "~9.2.2"
+        "jsdoc-type-pratt-parser": "~9.4.0"
       },
       "files": [
         "/dist",
@@ -136,7 +137,7 @@
         "open": "open ./coverage/index.html",
         "test": "npm run lint && npm run build && npm run test-cov",
         "test-ui": "vitest --ui --coverage",
-        "test-cov": "vitest --coverage",
+        "test-cov": "vitest --coverage --run",
         "tsc": "tsc",
         "tsc:ts7": "npx -y -p typescript@^7 -c \"tsc\"",
         "types": "esm-d-ts gen ./src/index.js --output ./dist/index.d.ts"

package/src/commentParserToESTree.js

@@ -492,17 +492,19 @@ const commentParserToESTree = (jsdoc, mode = 'typescript', {
     }
 
     // Clean-up where last line itself has tag content
-    if (end && tag) {
-      ast.terminal = end;
-      ast.hasPreterminalTagDescription = 1;
+    if (!end || !tag) {
+      return;
+    }
 
-      // Remove terminal line break at end when tag is defined on last line.
-      if (ast.terminal === '*/') {
-        ast.preterminalLineBreak = '';
-      }
+    ast.terminal = end;
+    ast.hasPreterminalTagDescription = 1;
 
-      cleanUpLastTag(/** @type {JsdocTag} */ (lastTag));
+    // Remove terminal line break at end when tag is defined on last line.
+    if (ast.terminal === '*/') {
+      ast.preterminalLineBreak = '';
     }
+
+    cleanUpLastTag(/** @type {JsdocTag} */ (lastTag));
   });
 
   ast.lastDescriptionLine = lastDescriptionLine;

package/src/estreeToString.js

@@ -159,14 +159,14 @@ function JsdocTag (node, opts) {
 
       result += '}';
     }
-    /* v8 ignore start */
+    /* v8 ignore start -- Not covered by tests; JSDoc-specific type handling */
   } else if (parsedType?.type.startsWith('JsdocType')) {
     result += `{${prattStringify(
       /** @type {import('@cjser/jsdoc-type-pratt-parser').RootResult} */ (
         parsedType
       )
     )}}`;
-    /* v8 ignore stop */
+    /* v8 ignore stop -- End of untested JSDoc-specific type handling */
   }
 
   // Check if the name appears on a separate line from the tag/type
@@ -178,7 +178,8 @@ function JsdocTag (node, opts) {
 
     if (descriptionLines.length > 0) {
       const firstDescLine = descriptionLines[0];
-      /* v8 ignore next 3 */
+      /* v8 ignore next 4 -- Defensive: blank first line not
+          expected in practice */
       if (firstDescLine.description === '' && firstDescLine.delimiter === '' &&
           firstDescLine.postDelimiter === '' && firstDescLine.initial === '') {
         // Empty first line, check if there's a second line with formatting
@@ -193,21 +194,22 @@ function JsdocTag (node, opts) {
           }`;
           nameLineOffset = 2;
         } else {
-          /* v8 ignore start */
+          /* v8 ignore start -- Fallback is not expected to occur normally */
           // Fallback: just add name (shouldn't normally happen)
           result += name + postName;
           nameLineOffset = 1;
-          /* v8 ignore stop */
+          /* v8 ignore stop -- End of fallback */
         }
       } else {
-        /* v8 ignore start */
+        // eslint-disable-next-line @stylistic/max-len -- Long
+        /* v8 ignore start -- Not covered by tests; first description line with content */
         // First description line has content, use it for the name line
         const nameLine = descriptionLines[0];
         result += `${nameLine.initial}${
           nameLine.delimiter
         }${nameLine.postDelimiter}${name}${postName}${nameLine.description}`;
         nameLineOffset = 1;
-        /* v8 ignore stop */
+        /* v8 ignore stop -- End of untested branch */
       }
     } else {
       // No description lines, need to construct the name line

package/src/jsdoccomment.js

@@ -90,12 +90,12 @@ const looksLikeExport = function (astNode) {
  */
 const getTSFunctionComment = function (astNode) {
   const {parent} = astNode;
-  /* v8 ignore next 3 */
+  /* v8 ignore next 3 -- Defensive: nodes are expected to have a parent */
   if (!parent) {
     return astNode;
   }
   const grandparent = parent.parent;
-  /* v8 ignore next 3 */
+  /* v8 ignore next 3 -- Defensive: parent is expected to have a parent */
   if (!grandparent) {
     return astNode;
   }
@@ -106,10 +106,10 @@ const getTSFunctionComment = function (astNode) {
       grandparent.type === 'ExportNamedDeclaration'
     ) {
       return grandparent;
-    /* v8 ignore start */
+    /* v8 ignore start -- Defensive: other node types not expected here */
     }
     return astNode;
-    /* v8 ignore stop */
+    /* v8 ignore stop -- End of defensive fallback */
   }
 
   const greatGrandparent = grandparent.parent;
@@ -123,7 +123,8 @@ const getTSFunctionComment = function (astNode) {
   case 'TSPropertySignature':
     return grandparent;
   case 'ArrowFunctionExpression':
-    /* v8 ignore next 3 */
+    // eslint-disable-next-line @stylistic/max-len -- Long
+    /* v8 ignore next 3 -- Defensive: arrow functions are expected to be nested */
     if (!greatGrandparent) {
       return astNode;
     }
@@ -133,17 +134,17 @@ const getTSFunctionComment = function (astNode) {
 
     // && greatGreatGrandparent.parent.type === 'VariableDeclaration'
     ) {
-      /* v8 ignore next 3 */
-      if (!greatGreatGrandparent || !greatGreatGrandparent.parent) {
-        return astNode;
-      }
-      return greatGreatGrandparent.parent;
-    /* v8 ignore start */
+      /* v8 ignore next 3 -- Defensive: missing ancestors are not expected */
+      return !greatGreatGrandparent || !greatGreatGrandparent.parent
+        ? astNode
+        : greatGreatGrandparent.parent;
+    /* v8 ignore start -- Defensive: other parent types not expected here */
     }
     return astNode;
-    /* v8 ignore stop */
+    /* v8 ignore stop -- End of defensive fallback */
   case 'FunctionExpression':
-    /* v8 ignore next 3 */
+    // eslint-disable-next-line @stylistic/max-len -- Long
+    /* v8 ignore next 3 -- Defensive: function expressions are expected to be nested */
     if (!greatGreatGrandparent) {
       return astNode;
     }
@@ -153,38 +154,36 @@ const getTSFunctionComment = function (astNode) {
 
   // Fallthrough
   default:
-    /* v8 ignore next 3 */
+    // eslint-disable-next-line @stylistic/max-len -- Long
+    /* v8 ignore next 3 -- Defensive: other grandparent types not expected here */
     if (grandparent.type !== 'Identifier') {
       return astNode;
     }
   }
 
-  /* v8 ignore next 3 */
+  /* v8 ignore next 3 -- Defensive: ancestor is expected to exist */
   if (!greatGreatGrandparent) {
     return astNode;
   }
 
   switch (greatGrandparent.type) {
   case 'ArrowFunctionExpression':
-    if (
-      greatGreatGrandparent.type === 'VariableDeclarator' &&
+    return greatGreatGrandparent.type === 'VariableDeclarator' &&
       greatGreatGrandparent.parent.type === 'VariableDeclaration'
-    ) {
-      return greatGreatGrandparent.parent;
-    }
-
-    return astNode;
+      ? greatGreatGrandparent.parent
+      : astNode;
   case 'FunctionDeclaration':
     return greatGrandparent;
   case 'VariableDeclarator':
-    /* v8 ignore next */
+    // eslint-disable-next-line @stylistic/max-len -- Long
+    /* v8 ignore next -- Else branch (non-declaration) not expected for variable declarators */
     if (greatGreatGrandparent.type === 'VariableDeclaration') {
       return greatGreatGrandparent;
     }
-    /* v8 ignore next 2 */
+    /* v8 ignore next 2 -- Defensive fallthrough to default */
     // Fallthrough
   default:
-    /* v8 ignore next 3 */
+    /* v8 ignore next 3 -- Defensive default; unreachable in practice */
     return astNode;
   }
 };
@@ -235,7 +234,8 @@ const getReducedASTNode = function (nodeInput, sourceCode, settings) {
   case 'TSEnumDeclaration':
   case 'ClassDeclaration':
   case 'FunctionDeclaration':
-    /* v8 ignore next 3 */
+    // eslint-disable-next-line @stylistic/max-len -- Long
+    /* v8 ignore next 3 -- Defensive: declarations are expected to have a parent */
     if (!parent) {
       return node;
     }
@@ -247,7 +247,8 @@ const getReducedASTNode = function (nodeInput, sourceCode, settings) {
   case 'ArrowFunctionExpression':
   case 'TSEmptyBodyFunctionExpression':
   case 'FunctionExpression':
-    /* v8 ignore next 3 */
+    // eslint-disable-next-line @stylistic/max-len -- Long
+    /* v8 ignore next 3 -- Defensive: function expressions are expected to have a parent */
     if (!parent) {
       return node;
     }
@@ -295,11 +296,10 @@ const getReducedASTNode = function (nodeInput, sourceCode, settings) {
       if (parent && parent.type !== 'FunctionDeclaration' &&
         parent.type !== 'Program'
       ) {
-        if (parent.parent && parent.parent.type === 'ExportNamedDeclaration') {
-          return parent.parent;
-        }
-
-        return parent;
+        return parent.parent &&
+          parent.parent.type === 'ExportNamedDeclaration'
+          ? parent.parent
+          : parent;
       }
     }
 
@@ -365,7 +365,8 @@ const findJSDocComment = (astNode, sourceCode, settings, opts = {}) => {
     break;
   }
 
-  /* v8 ignore next 3 */
+  // eslint-disable-next-line @stylistic/max-len -- Long
+  /* v8 ignore next 3 -- Defensive: tokens and locations are expected to exist */
   if (!tokenBefore || !currentNode.loc || !tokenBefore.loc) {
     return null;
   }
@@ -635,7 +636,8 @@ const getNonJsdocComment = function (sourceCode, node, settings) {
  *   AST node or token to compare
  */
 const compareLocEndToStart = (nodeA, nodeB) => {
-  /* v8 ignore next */
+  // eslint-disable-next-line @stylistic/max-len -- Long
+  /* v8 ignore next -- Defensive: fallback only for nodes lacking location info */
   return (nodeA.loc?.end.line ?? 0) === (nodeB.loc?.start.line ?? 0);
 };
 
@@ -708,7 +710,7 @@ const getFollowingComment = function (sourceCode, astNodeInput) {
       );
       break;
 
-    /* v8 ignore next 3 */
+    /* v8 ignore next 3 -- Defensive: no other node types expected */
     default:
       break;
     }

package/src/parseComment.js

@@ -73,11 +73,7 @@ const getTokenizers = ({
      * @returns {import('comment-parser').Spec}
      */
     (spec) => {
-      if (noTypes.includes(spec.tag)) {
-        return spec;
-      }
-
-      return preserveTypeTokenizer(spec);
+      return noTypes.includes(spec.tag) ? spec : preserveTypeTokenizer(spec);
     },
 
     /**
@@ -127,11 +123,9 @@ const getTokenizers = ({
         return spec;
       }
 
-      if (noNames.includes(spec.tag) || hasSeeWithLink(spec)) {
-        return spec;
-      }
-
-      return plainNameTokenizer(spec);
+      return noNames.includes(spec.tag) || hasSeeWithLink(spec)
+        ? spec
+        : plainNameTokenizer(spec);
     },
 
     /**

package/src/parseInlineTags.js

@@ -21,10 +21,7 @@ function determineFormat (match) {
   if (separator === '|') {
     return 'pipe';
   }
-  if (textEnd < tagStart) {
-    return 'prefix';
-  }
-  return 'space';
+  return textEnd < tagStart ? 'prefix' : 'space';
 }
 
 /**