chore: migrate repository workflows to pnpm

.github/workflows/ci.yml

@@ -20,27 +20,30 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - uses: pnpm/action-setup@v4
+
       - uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node }}
-          cache: npm
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
 
-      - run: npm ci
+      - run: pnpm install --frozen-lockfile
 
       - name: Typecheck
-        run: npm run typecheck
+        run: pnpm run typecheck
 
       - name: Lint
-        run: npm run lint
+        run: pnpm run lint
 
       - name: Format check
-        run: npm run format:check
+        run: pnpm run format:check
 
       - name: Test
-        run: npm run test:coverage
+        run: pnpm run test:coverage
 
       - name: Build
-        run: npm run build
+        run: pnpm run build
 
       - name: Upload coverage
         if: matrix.node == 22

.github/workflows/release.yml

@@ -15,22 +15,18 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - uses: pnpm/action-setup@v4
+
       - uses: actions/setup-node@v6
         with:
           node-version: 24
           registry-url: https://registry.npmjs.org
           package-manager-cache: false
 
-      - run: npm ci
-
-      - name: Typecheck
-        run: npm run typecheck
+      - run: pnpm install --frozen-lockfile
 
-      - name: Lint
-        run: npm run lint
-
-      - name: Test
-        run: npm run test:run
+      - name: Verify release contract
+        run: pnpm run release:check
 
       - name: Verify tag matches package.json version
         run: |
@@ -41,8 +37,7 @@ jobs:
             exit 1
           fi
 
-      - name: Build
-        run: npm run build
-
       - name: Publish to npm
-        run: npm publish --access public
+        # Tag checkouts use a detached HEAD, so pnpm's branch check cannot apply;
+        # the explicit tag/package-version check above remains authoritative.
+        run: pnpm publish --access public --provenance --no-git-checks

CHANGELOG.md

@@ -76,5 +76,5 @@ All notable changes to this project will be documented in this file.
 - `once` option (default: `true`) — run effect only once or on every predicate match
 - `onSkip` option — callback when predicate returns false
 - Full TypeScript generics, no `any` or type assertions
-- Release verification via `npm run release:check`
+- Release verification via `pnpm run release:check`
 - Predictable React 18 Strict Mode behavior per mount lifecycle

README.md

@@ -753,12 +753,25 @@ public documentation for package usage.
 - In React Strict Mode, behavior is still scoped per mount lifecycle. A real remount is treated as a fresh hook instance.
 - Public imports are exposed from the package root. Subpath imports are not required for the documented API.
 
+## Development
+
+```bash
+pnpm install --frozen-lockfile
+pnpm run typecheck
+pnpm run lint
+pnpm run format:check
+pnpm run test:run
+pnpm run test:coverage
+pnpm run build
+pnpm pack --pack-destination /tmp/react-effect-when-pack
+```
+
 ## Publish Checklist
 
-Before publishing a new version, make sure this command passes:
+Before publishing a new version, make sure the combined release check passes:
 
 ```bash
-npm run release:check
+pnpm run release:check
 ```
 
 ## License