@marko/language-server 1.0.12 → 1.0.13

package/dist/index.js

@@ -1343,6 +1343,156 @@ function patch(ts2, configFile, extractCache2, resolutionCache, host, ps) {
   }
 }
 
+// src/service/script/util/print-jsdoc-tag.ts
+var REG_BACK_TICK = /`/g;
+var REG_LINE = /\r\n|\n/;
+var REG_CODE_BLOCK = /^\s*[~`]{3}/m;
+var REG_CAPTION = /^<caption>(.*?)<\/caption>\s*(\r\n|\n)/;
+function printJSDocTag(tag) {
+  var _a;
+  switch (tag.name) {
+    case "augments":
+    case "extends":
+    case "param":
+    case "template": {
+      const body = getTagBodyParts(tag);
+      if ((body == null ? void 0 : body.length) === 3) {
+        const [, param, text] = body;
+        return `${printTagName(tag.name)} \`${param}\`${printTagBody(
+          replaceLinks(text)
+        )}`;
+      }
+      break;
+    }
+    case "return":
+    case "returns": {
+      if (!((_a = tag.text) == null ? void 0 : _a.length))
+        return void 0;
+      break;
+    }
+  }
+  return printTagName(tag.name) + printTagBody(getTagBodyText(tag));
+}
+function getTagBodyParts(tag) {
+  if (tag.name === "template") {
+    const parts = tag.text;
+    if (parts) {
+      const params = parts.filter((p) => p.kind === "typeParameterName").map((p) => p.text).join(", ");
+      const docs2 = parts.filter((p) => p.kind === "text").map((p) => convertLinkTags(p.text.replace(/^\s*-?\s*/, ""))).join(" ");
+      return params ? ["", params, docs2] : void 0;
+    }
+  }
+  return convertLinkTags(tag.text).split(/^(\S+)\s*-?\s*/);
+}
+function getTagBodyText(tag) {
+  if (!tag.text)
+    return "";
+  const text = convertLinkTags(tag.text);
+  switch (tag.name) {
+    case "example": {
+      const captionTagMatches = REG_CAPTION.exec(text);
+      if (captionTagMatches) {
+        const [captionMatch, captionText] = captionTagMatches;
+        return `${captionText}
+${ensureCodeblock(
+          captionText.slice(captionMatch.length)
+        )}`;
+      } else {
+        return ensureCodeblock(text);
+      }
+    }
+    case "author": {
+      const emailMatch = text.match(/(.+)\s<([-.\w]+@[-.\w]+)>/);
+      if (emailMatch) {
+        return `${emailMatch[1]} ${emailMatch[2]}`;
+      }
+      return text;
+    }
+    case "default":
+      return ensureCodeblock(text);
+  }
+  return replaceLinks(text);
+}
+function convertLinkTags(parts) {
+  if (!parts)
+    return "";
+  if (typeof parts === "string")
+    return parts;
+  let result = "";
+  let currentLink;
+  for (const part of parts) {
+    switch (part.kind) {
+      case "link":
+        if (currentLink) {
+          if (currentLink.target) {
+            const linkText = currentLink.text ? currentLink.text : escapeBackTicks(currentLink.name ?? "");
+            result += `[${currentLink.linkcode ? "`" + linkText + "`" : linkText}](${currentLink.target.file})`;
+          } else {
+            const text = currentLink.text ?? currentLink.name;
+            if (text) {
+              if (/^https?:/.test(text)) {
+                const parts2 = text.split(" ");
+                if (parts2.length === 1) {
+                  result += parts2[0];
+                } else if (parts2.length > 1) {
+                  const linkText = escapeBackTicks(parts2.slice(1).join(" "));
+                  result += `[${currentLink.linkcode ? "`" + linkText + "`" : linkText}](${parts2[0]})`;
+                }
+              } else {
+                result += escapeBackTicks(text);
+              }
+            }
+          }
+          currentLink = void 0;
+        } else {
+          currentLink = {
+            linkcode: part.text === "{@linkcode "
+          };
+        }
+        break;
+      case "linkName":
+        if (currentLink) {
+          currentLink.name = part.text;
+          currentLink.target = part.target;
+        }
+        break;
+      case "linkText":
+        if (currentLink) {
+          currentLink.text = part.text;
+        }
+        break;
+      default:
+        result += part.text;
+        break;
+    }
+  }
+  return replaceLinks(result);
+}
+function replaceLinks(text) {
+  return text.replace(
+    /\{@(link|linkplain|linkcode) (https?:\/\/[^ |}]+?)(?:[| ]([^{}\n]+?))?\}/gi,
+    (_, tag, link, text2) => {
+      const alt = text2 ? text2.trim() : link;
+      return `[${tag === "linkcode" ? `\`${alt}\`` : alt}](${link})`;
+    }
+  );
+}
+function printTagBody(text) {
+  if (text) {
+    return (REG_LINE.test(text) ? "  \n" : " \u2014 ") + text;
+  }
+  return "";
+}
+function printTagName(name) {
+  return `*@${name}*`;
+}
+function ensureCodeblock(text) {
+  return REG_CODE_BLOCK.test(text) ? text : "```\n" + text + "\n```";
+}
+function escapeBackTicks(text) {
+  return text.replace(REG_BACK_TICK, "\\$&");
+}
+
 // src/service/script/index.ts
 var IGNORE_DIAG_REG = /^(?:(?:Expression|Identifier|['"][^\w]['"]) expected|Invalid character)\b/i;
 var extractCache = /* @__PURE__ */ new Map();
@@ -2026,14 +2176,15 @@ async function getPreferences(scriptLang) {
 }
 function printDocumentation(docs2, tags) {
   let result = "";
+  let sep = "";
   if (docs2) {
     result += import_tsserverlibrary.default.displayPartsToString(docs2);
+    sep = "  \n\n";
   }
   if (tags) {
     for (const tag of tags) {
-      const text = import_tsserverlibrary.default.displayPartsToString(tag.text);
-      result += `*@${tag.name}*${text ? /\n/.test(text) ? `
-${text}` : `- ${text}` : ""}`;
+      result += sep + printJSDocTag(tag);
+      sep = "  \n\n";
     }
   }
   return result;