chore: Move to PNPM v11 (#602)

patricklafrance · web-flow · commit 5ecd7b3fdb59 · 2026-05-12T17:44:20.000-04:00
* chore: Move to PNPM v11

* fix: pin terser-webpack-plugin to version 5.4.0 to avoid issues with swc-minify options

* chore: pin node version to 24 in workflows to avoid issues with localStorage in tests
diff --git a/.github/workflows/changeset.yml b/.github/workflows/changeset.yml
@@ -30,7 +30,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: pnpm
           cache-dependency-path: pnpm-lock.yaml
@@ -45,10 +45,10 @@ jobs:
           # Using SHA will usually provide cache hit on subsequent commits in a PR
           # but will not provide cache hits between PRs, meaning the first run of a PR
           # will usually only be cache misses.
-          key: ${{ runner.os }}-turbo-changeset-${{ github.sha }}
+          key: ${{ runner.os }}-turbo-changeset-v11-${{ github.sha }}
           restore-keys: |
-            ${{ runner.os }}-turbo-changeset-
-            ${{ runner.os }}-turbo-
+            ${{ runner.os }}-turbo-changeset-v11-
+            ${{ runner.os }}-turbo-v11-
           path: .turbo
 
       - name: Build packages
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -34,7 +34,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-            node-version: ">=24.0.0"
+            node-version: "24"
             check-latest: true
             cache: pnpm
             cache-dependency-path: pnpm-lock.yaml
@@ -49,10 +49,10 @@ jobs:
           # Using SHA will usually provide cache hit on subsequent commits in a PR
           # but will not provide cache hits between PRs, meaning the first run of a PR
           # will usually only be cache misses.
-          key: ${{ runner.os }}-turbo-ci-${{ github.sha }}
+          key: ${{ runner.os }}-turbo-ci-v11-${{ github.sha }}
           restore-keys: |
-            ${{ runner.os }}-turbo-ci-
-            ${{ runner.os }}-turbo-
+            ${{ runner.os }}-turbo-ci-v11-
+            ${{ runner.os }}-turbo-v11-
           path: .turbo
 
       - name: Build packages
diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml
@@ -38,7 +38,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: pnpm
           cache-dependency-path: pnpm-lock.yaml
@@ -50,10 +50,10 @@ jobs:
         id: cache-turborepo-restore
         uses: actions/cache/restore@v5
         with:
-          key: ${{ runner.os }}-turbo-claude-${{ github.sha }}
+          key: ${{ runner.os }}-turbo-claude-v11-${{ github.sha }}
           restore-keys: |
-            ${{ runner.os }}-turbo-claude-
-            ${{ runner.os }}-turbo-
+            ${{ runner.os }}-turbo-claude-v11-
+            ${{ runner.os }}-turbo-v11-
           path: .turbo
 
       - name: Run Claude
diff --git a/.github/workflows/dogfood.yml b/.github/workflows/dogfood.yml
@@ -30,7 +30,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: pnpm
           cache-dependency-path: pnpm-lock.yaml
diff --git a/.github/workflows/pr-pkg.yml b/.github/workflows/pr-pkg.yml
@@ -31,7 +31,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-            node-version: ">=24.0.0"
+            node-version: "24"
             check-latest: true
             cache: pnpm
             cache-dependency-path: pnpm-lock.yaml
@@ -46,10 +46,10 @@ jobs:
           # Using SHA will usually provide cache hit on subsequent commits in a PR
           # but will not provide cache hits between PRs, meaning the first run of a PR
           # will usually only be cache misses.
-          key: ${{ runner.os }}-turbo-pr-pkg-${{ github.sha }}
+          key: ${{ runner.os }}-turbo-pr-pkg-v11-${{ github.sha }}
           restore-keys: |
-            ${{ runner.os }}-turbo-pr-pkg-
-            ${{ runner.os }}-turbo-
+            ${{ runner.os }}-turbo-pr-pkg-v11-
+            ${{ runner.os }}-turbo-v11-
           path: .turbo
 
       - name: Build packages
diff --git a/.github/workflows/smoke-test.yml b/.github/workflows/smoke-test.yml
@@ -36,7 +36,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: pnpm
           cache-dependency-path: pnpm-lock.yaml
diff --git a/.github/workflows/sync-agent-skill.yml b/.github/workflows/sync-agent-skill.yml
@@ -62,7 +62,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: 'pnpm'
 
diff --git a/.github/workflows/update-agent-docs.yml b/.github/workflows/update-agent-docs.yml
@@ -86,7 +86,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: 'pnpm'
 
diff --git a/.github/workflows/update-dependencies.yml b/.github/workflows/update-dependencies.yml
@@ -31,7 +31,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ">=24.0.0"
+          node-version: "24"
           check-latest: true
           cache: pnpm
           cache-dependency-path: pnpm-lock.yaml
diff --git a/agent-docs/references/ci-cd.md b/agent-docs/references/ci-cd.md
@@ -42,6 +42,10 @@ The main CI workflow (`ci.yml`) runs on `ubuntu-latest` with:
 - Incremental builds on PRs (only diverging packages)
 - Full builds on main branch pushes
 
+## Node version pin
+
+All workflows pin `node-version: "24"` (not `">=24.0.0"`). Reason: Node 26 exposes a native global `localStorage` that returns `undefined` unless `--localstorage-file` is provided. happy-dom 20.x does not override Node's native getter, so vitest tests touching `localStorage` (e.g. `localStorage.clear()` in `beforeEach`) crash with `Cannot read properties of undefined (reading 'clear')` when CI's `setup-node` picks the latest. Revisit once happy-dom handles Node's native `localStorage` (see PR #602 / commit 51037089b for the discovery).
+
 ## Concurrency
 
 - CI uses `ci-${{ github.ref }}` group with cancel-in-progress
diff --git a/docs/integrations/setup-launch-darkly.md b/docs/integrations/setup-launch-darkly.md
@@ -7,9 +7,17 @@ label: Setup LaunchDarkly
 
 Squide integrates with [LaunchDarkly](https://launchdarkly.com/) to attach feature flags to the [FireflyRuntime](../reference/runtime/FireflyRuntime.md) instance and automatically update [deferred registrations](../essentials/register-deferred-nav-items.md) whenever a flag value changes.
 
+## Install the packages
+
+To set up LaunchDarkly, first, open a terminal at the root of the host application and install the client:
+
+```bash
+pnpm add launchdarkly-js-client-sdk
+```
+
 ## Initialize the client
 
-To setup LaunchDarkly, first refer to the [create an host application](../introduction/create-host.md) guide as a starting point and update the host application bootstrapping code to create and initialize a LaunchDarkly SDK [client](https://launchdarkly.com/docs/sdk/client-side/javascript) instance:
+Then, to setup LaunchDarkly, first refer to the [create an host application](../introduction/create-host.md) guide as a starting point and update the host application bootstrapping code to create and initialize a LaunchDarkly SDK [client](https://launchdarkly.com/docs/sdk/client-side/javascript) instance:
 
 ```tsx !#7-14,18,25
 import { FireflyProvider, initializeFirefly } from "@squide/firefly";
diff --git a/package.json b/package.json
@@ -55,15 +55,15 @@
         "cross-env": "10.1.0",
         "eslint": "9.39.2",
         "pkg-pr-new": "0.0.66",
-        "retypeapp": "4.5.2",
+        "retypeapp": "4.5.3",
         "syncpack": "14.3.0",
         "turbo": "2.9.5",
         "typescript": "6.0.2",
         "typescript-eslint": "8.54.0"
     },
     "engines": {
         "node": ">=24.0.0",
-        "pnpm": ">=10"
+        "pnpm": ">=11"
     },
-    "packageManager": "pnpm@10.30.1"
+    "packageManager": "pnpm@11.0.8"
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
diff --git a/retype.yml b/retype.yml
diff --git a/templates/getting-started-remote/pnpm-workspace.yaml b/templates/getting-started-remote/pnpm-workspace.yaml
diff --git a/templates/getting-started/pnpm-workspace.yaml b/templates/getting-started/pnpm-workspace.yaml
