Start on TS support for JSDoc

.github/workflows/publish-github-pages.yml

@@ -30,7 +30,7 @@ jobs:
           pnpm i
           pnpm build
       - name: Build docs
-        run: pnpm docs
+        run: pnpm run docs
       - name: Publish site and docs
         uses: peaceiris/actions-gh-pages@v3
         with:

.jsdoc.js

@@ -8,16 +8,24 @@ module.exports = {
   source: {
     include: [
       'package.json',
-      'README.md',
       './src/shepherd.ts',
       './src/step.ts',
       './src/tour.ts'
-    ]
+    ],
+    includePattern: '\\.(json|js|ts)$'
   },
-  plugins: [
-    'plugins/markdown'
-  ],
+  plugins: ['plugins/markdown', 'node_modules/better-docs/typescript'],
   sourceType: 'module',
+  opts: {
+    destination: './site/docs/',
+    encoding: 'utf8',
+    // Do not include functions marked `@private`
+    private: false,
+    readme: 'README.md',
+    recurse: true,
+    template: './node_modules/jsdoc-template-ship-shape',
+    tutorials: './docs-src/tutorials'
+  },
   templates: {
     referenceTitle: 'Shepherd.js',
     favicon: '/landing/public/favicons/favicon-32x32.png',
@@ -28,15 +36,18 @@ module.exports = {
     collapse: false,
     resources: {
       Demo: 'https://shepherdjs.dev/'
+    },
+    'better-docs': {
+      navLinks: [
+        {
+          label: 'Demo',
+          href: 'https://shepherdjs.dev/'
+        },
+        {
+          label: 'GitHub',
+          href: 'https://github.com/shepherd-pro/shepherd'
+        }
+      ]
     }
-  },
-  opts: {
-    destination: './site/docs/',
-    encoding: 'utf8',
-    // Do not include functions marked `@private`
-    private: false,
-    recurse: true,
-    template: './node_modules/jsdoc-template-ship-shape',
-    tutorials: './docs-src/tutorials'
   }
 };

package.json

@@ -67,6 +67,7 @@
     "babel-core": "^7.0.0-bridge.0",
     "babel-jest": "^29.7.0",
     "babel-plugin-transform-es2015-modules-commonjs": "^6.26.2",
+    "better-docs": "^2.7.3",
     "chai": "^4.3.10",
     "codeclimate-test-reporter": "^0.5.1",
     "cssnano": "^6.0.3",