docs: integrate TypeDocs into vuepress output

# What's changed?

* create sidebar from typedoc output
* use plugin markdown to generate typedoc as markdown

docs/package.json

@@ -4,8 +4,9 @@
   "private": true,
   "scripts": {
     "dev": "vuepress dev src",
-    "build": "vuepress build src",
-    "lint": "eslint --ext \".js,.jsx,.ts,.tsx\" --fix --ignore-path .gitignore ."
+    "build": "vuepress build src && pnpm run typedoc",
+    "lint": "eslint --ext \".js,.jsx,.ts,.tsx\" --fix --ignore-path .gitignore .",
+    "typedoc": "typedoc --options ./typedoc.json"
   },
   "dependencies": {
     "@animxyz/core": "^0.6.6",
@@ -26,6 +27,8 @@
     "@windicss/plugin-scrollbar": "^1.2.3",
     "dotenv": "^16.0.1",
     "ohmyfetch": "^0.4.18",
+    "typedoc": "^0.22.17",
+    "typedoc-plugin-markdown": "^3.12.1",
     "unplugin-auto-import": "^0.6.9",
     "unplugin-icons": "^0.14.3",
     "unplugin-vue-components": "^0.18.5",

docs/src/.vuepress/copy-plugin.ts

@@ -6,7 +6,6 @@ export function copyVueFlowPlugin(): Plugin {
   return {
     name: 'copy-vue-flow',
     generateBundle() {
-      console.log('building')
       const filePath = resolve(
         __dirname,
         '../../node_modules/@braks/vue-flow/dist/vue-flow.es.js'
@@ -14,7 +13,7 @@ export function copyVueFlowPlugin(): Plugin {
       if (!existsSync(filePath)) {
         throw new Error(
           `@braks/vue-flow/dist/vue-flow.es.js not built. ` +
-          `Run "pnpm build" first.`
+          `Run "pnpm -w build" first.`
         )
       }
       this.emitFile({

docs/src/.vuepress/theme/index.ts

@@ -1,10 +1,37 @@
 import { resolve } from 'path'
-import { defaultTheme, Theme } from 'vuepress'
+import { defaultTheme, SidebarConfigArray, Theme } from 'vuepress'
 import { path } from '@vuepress/utils'
 import { useVueFlow } from '@braks/vue-flow'
+import { readdirSync } from 'fs'
 
 const { vueFlowVersion } = useVueFlow()
 
+const typedocSidebarEntries = (): SidebarConfigArray => {
+  const filePath = resolve(
+    __dirname,
+    '../../typedocs'
+  )
+
+  const classes = readdirSync(`${filePath}/classes/`).map(entry => `/typedocs/classes/${entry}`)
+  const enums = readdirSync(`${filePath}/enums/`).map(entry => `/typedocs/enums/${entry}`)
+  const interfaces = readdirSync(`${filePath}/interfaces/`).map(entry => `/typedocs/interfaces/${entry}`)
+  const modules = readdirSync(`${filePath}/modules/`).map(entry => `/typedocs/modules/${entry}`)
+
+  return [
+    {
+      text: 'TypeDocs',
+      link: '/typedocs/',
+      children: [
+        { text: 'Exports', children: ['/typedocs/modules.md'] },
+        { text: 'Modules', children: modules },
+        { text: 'Classes', children: classes },
+        { text: 'Enums', children: enums },
+        { text: 'Interfaces', children: interfaces },
+      ],
+    }
+  ]
+}
+
 export default {
   name: 'vuepress-theme-local',
   extends: defaultTheme({
@@ -61,6 +88,7 @@ export default {
           ],
         },
       ],
+      '/typedocs/': typedocSidebarEntries(),
     },
     navbar: [
       { text: `v${vueFlowVersion.value}`, link: '' },
@@ -70,7 +98,11 @@ export default {
         link: '/examples/',
         activeMatch: '^/examples/',
       },
-      { text: 'TypeDocs', link: 'https://types.vueflow.dev/' },
+      {
+        text: 'TypeDocs',
+        link: '/typedocs/',
+        activeMatch: '^/typedocs/',
+      },
     ],
   }),
   layouts: {

docs/typedoc.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "plugin": "typedoc-plugin-markdown",
+  "entryPoints": ["../packages/vue-flow/src/index.ts"],
+  "out": "src/typedocs",
+  "tsconfig": "../packages/vue-flow/tsconfig.docs.json"
+}