feat(ci): run demo tests against local workspace code (#2481)

* feat(ci): run demo tests against local workspace code

Mirrors the examples approach:
- Add pnpm overrides for superdoc and @superdoc-dev/react so demos
  resolve from local workspace instead of npm
- Add demos/* and demos/*/* to pnpm workspace
- Rewrite ci-demos workflow: shared build job with pnpm workspace
  install, expanded path triggers (packages/superdoc, super-editor,
  layout-engine, react), Playwright browser cache
- Increase smoke test timeouts for SPA hydration and dev server startup

* fix(ci): trigger demos CI on root config file changes

Changes to package.json, pnpm-lock.yaml, or pnpm-workspace.yaml
affect workspace resolution and can break demo installs.

* fix(demos): add missing prosemirror-state dependency to toolbar demo

The toolbar demo imports prosemirror-state directly but never declared
it. Worked with npm's flat hoisting but fails with pnpm's strict
module resolution.

Author: caio-pizzol

.github/workflows/ci-demos.yml

@@ -4,10 +4,50 @@ on:
   pull_request:
     paths:
       - 'demos/**'
+      - 'packages/superdoc/**'
+      - 'packages/react/**'
+      - 'packages/super-editor/**'
+      - 'packages/layout-engine/**'
+      - 'shared/**'
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+      - 'pnpm-workspace.yaml'
   workflow_dispatch:
 
 jobs:
-  validate:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build superdoc
+        run: pnpm build:superdoc
+
+      - name: Install Playwright
+        working-directory: demos/__tests__
+        run: npx playwright install chromium
+
+      - name: Cache workspace
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            .
+            ~/.cache/ms-playwright
+          key: demos-workspace-${{ github.sha }}
+
+  smoke-test:
+    needs: build
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -32,21 +72,25 @@ jobs:
           - vanilla
           - vue
     steps:
-      - uses: actions/checkout@v6
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
+      - name: Restore workspace
+        uses: actions/cache/restore@v4
         with:
-          node-version: '20'
-
-      - name: Install demo dependencies
-        working-directory: demos/${{ matrix.demo }}
-        run: npm install
-
-      - name: Install smoke test dependencies
-        working-directory: demos/__tests__
-        run: npm install && npx playwright install chromium
+          path: |
+            .
+            ~/.cache/ms-playwright
+          key: demos-workspace-${{ github.sha }}
 
       - name: Run smoke test
         working-directory: demos/__tests__
         run: DEMO=${{ matrix.demo }} npx playwright test
+
+  validate:
+    if: always()
+    needs: [smoke-test]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check results
+        run: |
+          if [[ "${{ contains(needs.*.result, 'failure') }}" == "true" ]]; then
+            exit 1
+          fi

demos/__tests__/playwright.config.ts

@@ -34,7 +34,7 @@ export default defineConfig({
   webServer: {
     command,
     url: `http://localhost:${port}`,
-    timeout: 30_000,
+    timeout: 120_000,
     reuseExistingServer: !process.env.CI,
   },
   use: {

demos/__tests__/smoke.spec.ts

@@ -15,7 +15,9 @@ test('demo loads without errors', async ({ page }) => {
   );
 
   await page.goto('/');
-  await expect(page.locator('body')).toBeVisible();
+  // SPA frameworks (e.g. Next.js) may hide the body during hydration;
+  // give them enough time to mount before checking visibility.
+  await expect(page.locator('body')).toBeVisible({ timeout: 30_000 });
 
   // Give the app a moment to initialize (SuperDoc is async)
   await page.waitForTimeout(2000);

demos/toolbar/package.json

@@ -7,6 +7,7 @@
     "dev": "vite"
   },
   "dependencies": {
+    "prosemirror-state": "^1.4.3",
     "superdoc": "latest"
   },
   "devDependencies": {