docs: add plugins to improve documentation

Author: aminya

.github/workflows/docs.yml

@@ -67,7 +67,7 @@ jobs:
       - name: Build Documentation
         run: |
           pnpm install
-          pnpm run build.doc
+          pnpm run docs.build
 
       - name: Deploy Documentation
         uses: Cecilapp/GitHub-Pages-deploy@v3

package.json

@@ -54,9 +54,13 @@
     "proper-lockfile": "^4.1.2",
     "rimraf": "^6.0.1",
     "semver": "^7.6.3",
+    "servor": "^4.0.2",
     "shx": "^0.3.4",
     "ts-node": "~10.9.2",
     "typedoc": "^0.27.6",
+    "typedoc-plugin-dt-links": "^1.1.6",
+    "typedoc-plugin-inline-sources": "^1.2.0",
+    "typedoc-plugin-mdn-links": "^4.0.7",
     "typescript": "~4.9.5",
     "which": "^5.0.0"
   },
@@ -95,8 +99,10 @@
     "clean.temp": "rimraf ./tmp && shx mkdir -p ./tmp",
     "build.js": "run-s clean.lib && tsc -p ./src/tsconfig.json && run-s build.downlevel",
     "build.downlevel": "downlevel-dts ./lib ./lib/ts3.7",
-    "build.doc": "rimraf docs && typedoc --options ./typedoc.json && minify-all -s docs-unminified -d docs --jsCompressor terser && rimraf docs-unminified",
-    "deploy.doc": "run-s build.doc && gh-pages --dist \"./docs\"",
+    "docs.build": "rimraf docs && typedoc --options ./typedoc.json && minify-all -s docs-unminified -d docs --jsCompressor terser && rimraf docs-unminified",
+    "docs.preview": "servor --browse --reload docs",
+    "docs.dev": "run-s docs.build docs.preview",
+    "docs.deploy": "run-s docs.build && gh-pages --dist \"./docs\"",
     "build.native": "cmake-ts nativeonly",
     "build.native.debug": "cross-env npm_config_zmq_enable_sanitizer_undefined=true cmake-ts dev-os-only",
     "build": "run-p build.js build.native",

pnpm-lock.yaml

@@ -27,5 +27,9 @@
   ],
   "cleanOutputDir": true,
   "pretty": false,
-  "githubPages": true
+  "githubPages": true,
+  "plugin": [
+    "typedoc-plugin-dt-links",
+    "typedoc-plugin-mdn-links",
+  ]
 }