Merge main into stable

.github/scripts/agent-docs-l1.mjs

@@ -24,21 +24,17 @@ export const CONFIG = {
     '.git',
     '.tmp',
     'dist',
-    'devtools/visual-testing/node_modules',
     'tests/consumer-typecheck/node_modules',
   ],
   intentionalDifferentPairs: ['packages/superdoc/AGENTS.md:packages/superdoc/CLAUDE.md'],
   canonicalSymlinkTarget: 'AGENTS.md',
   knownCommands: [
     'pnpm test',
     'pnpm test:behavior',
-    'pnpm test:layout',
-    'pnpm test:visual',
     'pnpm dev',
     'pnpm build',
-    'pnpm corpus:upload',
-    'pnpm corpus:pull',
-    'pnpm layout:compare',
+    'pnpm docs:download',
+    'pnpm docs:upload',
   ],
   docBasenames: new Set(['AGENTS.md', 'CLAUDE.md', 'CLAUDE.local.md']),
   rulesDir: '.claude/rules',

.github/workflows/ci-demos.yml

@@ -3,13 +3,17 @@ name: CI Demos
 on:
   pull_request:
     paths:
+      - '.github/workflows/ci-demos.yml'
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+      - 'pnpm-workspace.yaml'
+      - '.nvmrc'
       - 'demos/**'
       - 'packages/superdoc/**'
       - 'packages/react/**'
       - 'packages/super-editor/**'
       - 'packages/layout-engine/**'
       - 'shared/**'
-      - 'package.json'
   workflow_dispatch:
 
 jobs:
@@ -19,12 +23,15 @@ jobs:
       - uses: actions/checkout@v6
 
       - uses: pnpm/action-setup@v4
+        with:
+          package_json_file: package.json
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
           node-version: '20'
           cache: 'pnpm'
+          cache-dependency-path: pnpm-lock.yaml
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -37,17 +44,15 @@ jobs:
         # Other demos don't need this; cheap enough to run unconditionally.
         run: pnpm --filter @superdoc-dev/react run build
 
-      - name: Install Playwright
-        working-directory: demos/__tests__
-        run: npx playwright install chromium
+      - name: Pack build artifact
+        run: tar -czf demos-build-dist.tgz packages/superdoc/dist packages/react/dist
 
-      - name: Cache workspace
-        uses: actions/cache/save@v4
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
         with:
-          path: |
-            .
-            ~/.cache/ms-playwright
-          key: demos-workspace-${{ github.sha }}
+          name: demos-build-dist-${{ github.run_id }}
+          path: demos-build-dist.tgz
+          if-no-files-found: error
 
   smoke-test:
     needs: build
@@ -65,15 +70,52 @@ jobs:
           - linked-sections
           - nextjs-ssr
     steps:
-      - name: Restore workspace
-        uses: actions/cache/restore@v4
-        with:
-          path: |
-            .
-            ~/.cache/ms-playwright
-          key: demos-workspace-${{ github.sha }}
+      - uses: actions/checkout@v6
 
       - uses: pnpm/action-setup@v4
+        with:
+          package_json_file: package.json
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: demos-build-dist-${{ github.run_id }}
+          path: .
+
+      - name: Restore build artifact
+        run: tar -xzf demos-build-dist.tgz
+
+      - name: Resolve Playwright version
+        id: playwright-version
+        working-directory: demos/__tests__
+        run: echo "version=$(pnpm exec playwright --version | awk '{print $2}')" >> "$GITHUB_OUTPUT"
+
+      - name: Restore Playwright Chromium cache
+        id: playwright-cache
+        uses: actions/cache@v5
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ steps.playwright-version.outputs.version }}-chromium
+
+      - name: Install Playwright Chromium
+        if: steps.playwright-cache.outputs.cache-hit != 'true'
+        working-directory: demos/__tests__
+        run: pnpm exec playwright install --with-deps chromium
+
+      - name: Install Playwright system dependencies
+        if: steps.playwright-cache.outputs.cache-hit == 'true'
+        working-directory: demos/__tests__
+        run: pnpm exec playwright install-deps chromium
 
       - name: Run smoke test
         working-directory: demos/__tests__