feat: Add the includeVersion flag

Closes #1175

Author: Gerrit0

src/lib/converter/plugins/PackagePlugin.ts

@@ -21,6 +21,9 @@ export class PackagePlugin extends ConverterComponent {
     @BindOption('readme')
     readme!: string;
 
+    @BindOption('includeVersion')
+    includeVersion!: boolean;
+
     /**
      * The file name of the found readme.md file.
      */
@@ -121,7 +124,10 @@ export class PackagePlugin extends ConverterComponent {
         if (this.packageFile) {
             project.packageInfo = JSON.parse(FS.readFileSync(this.packageFile, 'utf-8'));
             if (!project.name) {
-                project.name = `${project.packageInfo.name} - v${project.packageInfo.version}`;
+                project.name = String(project.packageInfo.name);
+            }
+            if (this.includeVersion) {
+                project.name = `${project.name} - v${project.packageInfo.version}`;
             }
         }
     }

src/lib/utils/options/declaration.ts

@@ -61,6 +61,7 @@ export interface TypeDocOptionMap {
 
     theme: string;
     name: string;
+    includeVersion: boolean;
     readme: string;
     defaultCategory: string;
     categoryOrder: string[];

src/lib/utils/options/sources/typedoc.ts

@@ -108,6 +108,11 @@ export function addTypeDocOptions(options: Options) {
         name: 'name',
         help: 'Set the name of the project that will be used in the header of the template.'
     });
+    options.addDeclaration({
+        name: 'includeVersion',
+        help: 'Add the package version to the project name',
+        type: ParameterType.Boolean
+    });
     options.addDeclaration({
         name: 'readme',
         help: 'Path to the readme file that should be displayed on the index page. Pass `none` to disable the index page and start the documentation on the globals page.'