Merge pull request #10 from hildjj/generate-docs

Generate docs server-side

Author: hildjj

.github/workflows/gh-pages.yml

@@ -0,0 +1,34 @@
+name: Deploy to GitHub Pages
+
+on:
+  workflow_dispatch:
+    inputs:
+      branch:
+        type: choice
+        description: Which branch to deploy?
+        required: true
+        options:
+          - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.inputs.branch }}
+      - name: Enable pnpm
+        run: "corepack enable"
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+          cache: pnpm
+      - run: pnpm install
+      - run: npm run build
+      - run: npm run docs
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs

.github/workflows/publish.yml

@@ -24,6 +24,7 @@ jobs:
       - run: pnpm i -r
       - run: npm run build
       - run: npm run test
+      - run: npm run docs
       - run: npm pkg delete devDependencies scripts packageManager
       - name: Deploy Docs
         uses: peaceiris/actions-gh-pages@v4

package.json

@@ -24,6 +24,7 @@
   },
   "scripts": {
     "build": "peggy --format es test/minimal.peggy && tsc",
+    "docs": "typedoc",
     "lint": "eslint .",
     "test": "c8 node --test test/*.test.js"
   },