feat: Automatically add @source tag

Resolves #15

Author: Gerrit0

README.md

@@ -76,6 +76,8 @@ Block tags are output as "title case" headings in the final output. If you would
 
 ### Handling "unknown block tag" warning
 
+If you specify custom tags for TypeDoc via a `tsdoc.json` file or through TypeDoc's
+`blockTags` options, then you will need to add `@source` to the block tags list.
 When using the tag, TypeDoc (since 0.26) will generate the following warning:
 
 ```shell

package-lock.json

@@ -8,8 +8,17 @@ import {
 } from 'typedoc';
 import ts from 'typescript';
 import plugin from './plugin.js';
+import { TAG_NAME } from './constants.js';
 
 export function load(app: Application) {
+  app.on(Application.EVENT_BOOTSTRAP_END, () => {
+    if (!app.options.isSet('blockTags')) {
+      app.options.setValue('blockTags', [
+        ...app.options.getValue('blockTags'),
+        TAG_NAME
+      ]);
+    }
+  });
   app.converter.on(
     Converter.EVENT_CREATE_DECLARATION,
     (context: Context, reflection: DeclarationReflection) => {

src/index.ts

@@ -1,13 +1,13 @@
 import { Context, Reflection } from 'typedoc';
 import ts from 'typescript';
 import { getValueDeclaration, parseTag } from './helpers.js';
+import { TAG_NAME } from './constants.js';
 
 export default (
   context: Context,
   reflection: Reflection,
   sig?: ts.SignatureDeclaration,
 ) => {
-  const TAG_NAME = '@source';
 
   // ignore projects
   if (reflection.isProject()) return;