feat(storybook): baseline + diff for storybook-screenshots

.github/workflows/ci.yml

@@ -408,6 +408,56 @@ jobs:
           retention-days: 14
           if-no-files-found: ignore
 
+  # -----------------------------------------------------------------------
+  # Storybook visual regression baseline check
+  # -----------------------------------------------------------------------
+  visual-regression-check:
+    needs: [trufflehog, lint, typecheck, unit-tests, audit]
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: '1.3.14'
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: .node-version
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Cache Playwright browsers
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            playwright-${{ runner.os }}-
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps chromium
+
+      - name: Run Storybook visual regression check
+        run: bun run storybook:screenshots:check
+
+      - name: Upload screenshot diff artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: visual-regression-diff
+          path: |
+            tests/e2e/screenshots/desktop/storybook
+            tests/e2e/screenshots/mobile/storybook
+            tests/e2e/storybook-screenshots-baseline
+            tests/e2e/storybook-screenshots-diff
+          retention-days: 7
+          if-no-files-found: ignore
+
   # -----------------------------------------------------------------------
   # Dependency vulnerability audit
   # -----------------------------------------------------------------------

eslint.config.mjs

@@ -108,5 +108,16 @@ export default pluginTs.config(
     files: ['.storybook/**/*.{js,jsx,ts,tsx}'],
     extends: [pluginTs.configs.recommended],
   },
+  // Scripts — Node.js runtime, not browser
+  {
+    name: 'scripts',
+    files: ['scripts/**/*.{js,jsx,ts,tsx}'],
+    extends: [pluginTs.configs.recommended],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+  },
   storybook.configs['flat/recommended'],
 );