fix(47391): omit | token from jsdoc linkTag text

Author: a-tarasyuk

src/services/utilities.ts

@@ -2307,13 +2307,18 @@ namespace ts {
             : "linkplain";
         const parts = [linkPart(`{@${prefix} `)];
         if (!link.name) {
-            if (link.text) parts.push(linkTextPart(link.text));
+            if (link.text) {
+                const text = skipSeparatorFromLinkText(link.text);
+                if (text) {
+                    parts.push(linkTextPart(text));
+                }
+            }
         }
         else {
             const symbol = checker?.getSymbolAtLocation(link.name);
             const suffix = findLinkNameEnd(link.text);
             const name = getTextOfNode(link.name) + link.text.slice(0, suffix);
-            const text = link.text.slice(suffix);
+            const text = skipSeparatorFromLinkText(link.text.slice(suffix));
             const decl = symbol?.valueDeclaration || symbol?.declarations?.[0];
             if (decl) {
                 parts.push(linkNamePart(name, decl));
@@ -2327,6 +2332,15 @@ namespace ts {
         return parts;
     }
 
+    function skipSeparatorFromLinkText(text: string) {
+        let pos = 0;
+        if (text.charCodeAt(pos++) === CharacterCodes.bar) {
+            while (pos < text.length && text.charCodeAt(pos) === CharacterCodes.space) pos++;
+            return text.slice(pos);
+        }
+        return text;
+    }
+
     function findLinkNameEnd(text: string) {
         if (text.indexOf("()") === 0) return 2;
         if (text[0] !== "<") return 0;

tests/baselines/reference/jsdocLink1.baseline

@@ -141,7 +141,7 @@
               }
             },
             {
-              "text": "|postfix text",
+              "text": "postfix text",
               "kind": "linkText"
             },
             {

tests/baselines/reference/jsdocLink2.baseline

@@ -141,7 +141,7 @@
               }
             },
             {
-              "text": "|postfix text",
+              "text": "postfix text",
               "kind": "linkText"
             },
             {

tests/baselines/reference/jsdocLink3.baseline

@@ -141,7 +141,7 @@
               }
             },
             {
-              "text": "|postfix text",
+              "text": "postfix text",
               "kind": "linkText"
             },
             {

tests/baselines/reference/quickInfoLink4.baseline

@@ -0,0 +1,76 @@
+[
+  {
+    "marker": {
+      "fileName": "/tests/cases/fourslash/quickInfoLink4.ts",
+      "position": 67,
+      "name": ""
+    },
+    "quickInfo": {
+      "kind": "const",
+      "kindModifiers": "",
+      "textSpan": {
+        "start": 67,
+        "length": 1
+      },
+      "displayParts": [
+        {
+          "text": "const",
+          "kind": "keyword"
+        },
+        {
+          "text": " ",
+          "kind": "space"
+        },
+        {
+          "text": "B",
+          "kind": "localName"
+        },
+        {
+          "text": ":",
+          "kind": "punctuation"
+        },
+        {
+          "text": " ",
+          "kind": "space"
+        },
+        {
+          "text": "456",
+          "kind": "stringLiteral"
+        }
+      ],
+      "documentation": [
+        {
+          "text": "See ",
+          "kind": "text"
+        },
+        {
+          "text": "{@link ",
+          "kind": "link"
+        },
+        {
+          "text": "A",
+          "kind": "linkName",
+          "target": {
+            "fileName": "/tests/cases/fourslash/quickInfoLink4.ts",
+            "textSpan": {
+              "start": 6,
+              "length": 7
+            }
+          }
+        },
+        {
+          "text": "constant A",
+          "kind": "linkText"
+        },
+        {
+          "text": "}",
+          "kind": "link"
+        },
+        {
+          "text": " instead",
+          "kind": "text"
+        }
+      ]
+    }
+  }
+]

tests/baselines/reference/quickInfoLink5.baseline

@@ -0,0 +1,61 @@
+[
+  {
+    "marker": {
+      "fileName": "/tests/cases/fourslash/quickInfoLink5.ts",
+      "position": 61,
+      "name": ""
+    },
+    "quickInfo": {
+      "kind": "const",
+      "kindModifiers": "",
+      "textSpan": {
+        "start": 61,
+        "length": 1
+      },
+      "displayParts": [
+        {
+          "text": "const",
+          "kind": "keyword"
+        },
+        {
+          "text": " ",
+          "kind": "space"
+        },
+        {
+          "text": "B",
+          "kind": "localName"
+        },
+        {
+          "text": ":",
+          "kind": "punctuation"
+        },
+        {
+          "text": " ",
+          "kind": "space"
+        },
+        {
+          "text": "456",
+          "kind": "stringLiteral"
+        }
+      ],
+      "documentation": [
+        {
+          "text": "See ",
+          "kind": "text"
+        },
+        {
+          "text": "{@link ",
+          "kind": "link"
+        },
+        {
+          "text": "}",
+          "kind": "link"
+        },
+        {
+          "text": " instead",
+          "kind": "text"
+        }
+      ]
+    }
+  }
+]

tests/cases/fourslash/quickInfoLink4.ts

@@ -0,0 +1,9 @@
+/// <reference path="fourslash.ts" />
+
+////const A = 123;
+/////**
+//// * See {@link A | constant A} instead
+//// */
+////const /**/B = 456;
+
+verify.baselineQuickInfo();

tests/cases/fourslash/quickInfoLink5.ts

@@ -0,0 +1,9 @@
+/// <reference path="fourslash.ts" />
+
+////const A = 123;
+/////**
+//// * See {@link |       } instead
+//// */
+////const /**/B = 456;
+
+verify.baselineQuickInfo();