ci: docs build (#2382)

Author: mikeldking

.github/workflows/gh-pages.yml

@@ -27,13 +27,52 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.11.0
+
+      - name: Install dependencies
+        run: |
+          cd js
+          pnpm install --frozen-lockfile
+
+      - name: Prebuild packages
+        run: |
+          cd js
+          pnpm run -r prebuild
+
+      - name: Build packages
+        run: |
+          cd js
+          pnpm run -r build
+
       - name: Setup Pages
         uses: actions/configure-pages@v5
+
       - name: Build with Jekyll
         uses: actions/jekyll-build-pages@v1
         with:
           source: ./
           destination: ./_site
+
+      - name: Build TypeDoc documentation
+        run: |
+          cd js
+          pnpm run docs:generate
+
+      - name: Copy TypeDoc to js subpath
+        run: |
+          sudo chown -R $USER:$USER _site
+          mkdir -p _site/js
+          cp -r js/docs/* _site/js/
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
 

_config.yml

@@ -0,0 +1,16 @@
+# Jekyll configuration for GitHub Pages
+exclude:
+  - node_modules
+  - js/node_modules
+  - js/packages/*/node_modules
+  - js/examples/*/node_modules
+  - js/examples/*/backend/node_modules
+  - js/examples/*/frontend/node_modules
+  - .git
+  - .github
+  - Gemfile
+  - Gemfile.lock
+  - README.md
+  - LICENSE
+  - .gitignore
+  - .nojekyll