add: jsdoc-api & vitepress for documentation generation

.gitignore

@@ -74,3 +74,6 @@ typings/
 
 # local version cache
 .wwebjs_cache/
+
+# vitepress local cache
+.vitepress/cache/

.jsdoc.json

@@ -1,26 +1,26 @@
 {
-    "tags": {
-        "allowUnknownTags": true,
-        "dictionaries": ["jsdoc"]
-    },
-    "source": {
-        "include": ["src", "package.json", "README.md"],
-        "includePattern": ".js$",
-        "excludePattern": "(node_modules/|docs)"
-    },
-    "plugins": [
-        "plugins/markdown"
+  "source": {
+    "includeFiles": [
+      "src",
+      "README.md"
     ],
-    "templates": {
-        "cleverLinks": false,
-        "monospaceLinks": true,
-        "useLongnameInNav": false,
-        "showInheritedInNav": true
-    },
-    "opts": {
-        "destination": "./docs/",
-        "encoding": "utf8",
-        "recurse": true,
-        "template": "./node_modules/jsdoc-baseline"
-    }
+    "excludeFiles": [
+      "index.js"
+    ],
+    "includePattern": ".js$"
+  },
+  "versions": {
+    "generateMainBranch": true,
+    "startGenerationAt": "1.24.0",
+    "endGenerationAt": false
+  },
+  "sidebar": {
+    "showVersionSlection": true,
+    "enableTypeSorting": true
+  },
+  "opts": {
+    "destination": "./docs/",
+    "removeEmptyFiles": true,
+    "removeEmptyTages": true
+  }
 }

.npmignore

@@ -18,3 +18,4 @@ yarn-error.log*
 .env
 tools/
 tests/
+cache/

docs/.vitepress/config.js

@@ -0,0 +1,18 @@
+const { head, nav, sidebar } = require('./configs/index.js');
+
+export default {
+  head: head,
+  themeConfig: {
+    logo: "/images/logo.png",
+    siteTitle: "whatsapp-web.js",
+    editLink: false,
+    aside: false,
+    lastUpdated: false,
+    docFooter: {
+      prev: false,
+      next: false
+    },
+    nav: nav,
+    sidebar: sidebar
+  }
+};

docs/.vitepress/configs/head.js

@@ -0,0 +1,5 @@
+export const head = [
+    ['link', { rel: 'icon', href: '/icons/favicon/logo_32x32.png' }],
+    ['link', { rel: 'icon', href: '/icons/favicon/logo_16x16.png' }],
+    ['link', { rel: 'shortcut icon', href: '/icons/favicon/logo_shortcut.ico' }]
+];

docs/.vitepress/configs/index.js

@@ -0,0 +1,3 @@
+export * from './head.js'
+export * from './sidebar.js'
+export * from './nav.js'

docs/.vitepress/configs/nav.js

@@ -0,0 +1,11 @@
+export const nav = [
+    {
+        text: "API",
+        link: "/",
+        activeMatch: "/"
+    },
+    {
+        text: "Version",
+        items: []
+    }
+];

docs/.vitepress/configs/sidebar.js

@@ -0,0 +1 @@
+export const sidebar = [];