feat: add parseDocComment

Author: velut

bun.lock

@@ -22,6 +22,7 @@
         "jsdom": "^27.1.0",
         "lodash-es": "^4.17.21",
         "marked": "^16.4.2",
+        "memoize": "^10.2.0",
         "nanoid": "^5.1.6",
         "new-github-issue-url": "^1.1.0",
         "pathe": "^2.0.3",

lib/components/parse-doc-comment.test.ts

@@ -0,0 +1,6 @@
+import { expect, test } from "vitest";
+import { parseDocComment } from "./parse-doc-comment.ts";
+
+test("parses doc comment", () => {
+	expect(parseDocComment("/** @internal */").modifierTagSet.isInternal()).toBe(true);
+});

lib/components/parse-doc-comment.ts

@@ -0,0 +1,7 @@
+import { TSDocParser, type DocComment } from "@microsoft/tsdoc";
+import memoize from "memoize";
+
+export const parseDocComment = memoize((comment: string): DocComment => {
+	const parser = new TSDocParser();
+	return parser.parseString(comment).docComment;
+});

package.json

@@ -35,6 +35,7 @@
 		"jsdom": "^27.1.0",
 		"lodash-es": "^4.17.21",
 		"marked": "^16.4.2",
+		"memoize": "^10.2.0",
 		"nanoid": "^5.1.6",
 		"new-github-issue-url": "^1.1.0",
 		"pathe": "^2.0.3",

src/components/DocComment.astro

@@ -1,12 +1,12 @@
 ---
-import { parseDocComment } from "@jsdocs-io/extractor";
 import { StandardTags } from "@microsoft/tsdoc";
 import DocCommentInherit from "./DocCommentInherit.astro";
 import DocNodeContainer from "./DocNodeContainer.astro";
+import { parseDocComment } from "../../lib/components/parse-doc-comment";
 
-type Props = {
+interface Props {
 	doc: string;
-};
+}
 
 const { doc } = Astro.props;
 const {