Add @since to the default list of recognized tags

Resolves #2614

Author: Gerrit0

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Unreleased
 
+### Features
+
+-   Added `@since` to the default list of recognized tags, #2614.
+
 ## v0.26.2 (2024-06-24)
 
 ### Features

src/lib/utils/options/tsdoc-defaults.ts

@@ -32,8 +32,9 @@ export const blockTags = [
     "@property",
     "@return",
     "@satisfies",
+    "@since",
     "@template", // Alias for @typeParam
-    "@type", // Because TypeScript is important!
+    "@type",
     "@typedef",
 ] as const;
 

src/test/converter2/issues/gh2614.ts

@@ -0,0 +1,4 @@
+/**
+ * @since 1.0.0
+ */
+export function foo() {}

src/test/issues.c2.test.ts

@@ -1625,4 +1625,15 @@ describe("Issue Tests", () => {
         convert();
         logger.expectNoOtherMessages();
     });
+
+    it("#2614 supports @since tag", () => {
+        const project = convert();
+        const foo = querySig(project, "foo");
+        equal(
+            foo.comment?.getTag("@since"),
+            new CommentTag("@since", [{ kind: "text", text: "1.0.0" }]),
+        );
+
+        logger.expectNoOtherMessages();
+    });
 });

tsdoc.json

@@ -115,6 +115,10 @@
             "tagName": "@satisfies",
             "syntaxKind": "block"
         },
+        {
+            "tagName": "@since",
+            "syntaxKind": "block"
+        },
         {
             "tagName": "@license",
             "syntaxKind": "block"