ci: add storybook deploy job to checks.yml

Move storybook deployment into checks.yml so the deleted
deploy-ghpage.yml and publish-storybook.yml workflows are
fully replaced. DeployStorybook runs only on main push,
after storybook tests pass.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: paddymul

.github/workflows/checks.yml

@@ -6,6 +6,11 @@ on:
     branches: "*"
   workflow_dispatch:
 
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
@@ -316,6 +321,44 @@ jobs:
       - name: Run WASM Marimo Playwright Tests
         run: bash scripts/test_playwright_wasm_marimo.sh
 
+  # ---------------------------------------------------------------------------
+  # Deploy Storybook to GitHub Pages (main only)
+  # ---------------------------------------------------------------------------
+
+  DeployStorybook:
+    name: Deploy Storybook
+    if: github.ref == 'refs/heads/main'
+    needs: [TestStorybook]
+    runs-on: depot-ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9.10.0
+      - name: Setup Node.js with pnpm cache
+        uses: actions/setup-node@v4
+        with:
+          cache: 'pnpm'
+          cache-dependency-path: 'packages/pnpm-lock.yaml'
+      - name: Install pnpm dependencies
+        working-directory: packages
+        run: pnpm install --frozen-lockfile
+      - name: Build Storybook
+        working-directory: packages/buckaroo-js-core
+        run: pnpm build-storybook
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./packages/buckaroo-js-core/dist/storybook
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
   # ---------------------------------------------------------------------------
   # Docs — build documentation and check links
   # ---------------------------------------------------------------------------