chore: migrate from npm to pnpm (#120)

* replace package-lock.json with pnpm-lock.yaml

* update ci to use pnpm

* update renovate config to use pnpm

* update contributing.md

Author: henchaves

.github/workflows/ci.yml

@@ -24,17 +24,20 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Set up pnpm
+        uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
+
       - name: Set up Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
           node-version: 24.16.0
-          cache: npm
+          cache: pnpm
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Build site
-        run: npm run build:ci
+        run: pnpm run build:ci
 
   doc_tests:
     name: Test and update notebooks
@@ -58,14 +61,17 @@ jobs:
       - name: Install Python deps
         run: uv sync --all-extras
 
+      - name: Set up pnpm
+        uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
+
       - name: Set up Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
           node-version: "24.16.0"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install Node deps
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run notebook tests
         env:

.pre-commit-config.yaml

@@ -31,5 +31,7 @@ repos:
             \.secrets\.baseline$|
             \.python-version$|
             venv\.lock$|
-            version\.json$
+            version\.json$|
+            pnpm-lock\.yaml$|
+            package-lock\.json$
           )$

Makefile

@@ -5,12 +5,12 @@ pre-commit-install: ## Setup pre-commit hooks
 .PHONY: pre-commit-install
 
 install: ## Install project dependencies
-	uv sync --all-extras && npm install
+	uv sync --all-extras && pnpm install
 .PHONY: setup
 
 
 dev: ## Start development server
-	npm run dev
+	pnpm dev
 .PHONY: dev
 
 test-docs-nb: ## Run notebook E2E tests (overwrites outputs by default; set OVERWRITE_NB=0 to skip)

README.md

@@ -5,20 +5,21 @@ Documentation site built with [Astro](https://astro.build) + [Starlight](https:/
 ## Requirements
 
 - Node.js 18+
-- Python 3 + `black` (optional — only needed for `npm run format`)
+- [pnpm](https://pnpm.io/) (auto-managed via the `packageManager` field in `package.json`; enable with `corepack enable`)
+- Python 3 + `black` (optional, only needed for `pnpm run format`)
 
 ## Commands
 
-| Command                 | Description                                                           |
-| :---------------------- | :-------------------------------------------------------------------- |
-| `npm install`           | Install dependencies                                                  |
-| `npm run dev`           | Start local dev server at `localhost:4321` (converts notebooks first) |
-| `npm run build`         | Format, convert notebooks, and build production site to `dist/`       |
-| `npm run build:ci`      | Convert notebooks and build without formatting — use this in CI       |
-| `npm run preview`       | Preview the production build locally                                  |
-| `npm run format`        | Run Prettier + black on all `.md`/`.mdx` files                        |
-| `npm run format:prose`  | Run Prettier only                                                     |
-| `npm run format:code`   | Run black on Python code blocks only                                  |
+| Command                | Description                                                           |
+| :--------------------- | :-------------------------------------------------------------------- |
+| `pnpm install`         | Install dependencies                                                  |
+| `pnpm dev`             | Start local dev server at `localhost:4321` (converts notebooks first) |
+| `pnpm build`           | Format, convert notebooks, and build production site to `dist/`       |
+| `pnpm build:ci`        | Convert notebooks and build without formatting (use this in CI)       |
+| `pnpm preview`         | Preview the production build locally                                  |
+| `pnpm format`          | Run Prettier + black on all `.md`/`.mdx` files                        |
+| `pnpm format:prose`    | Run Prettier only                                                     |
+| `pnpm format:code`     | Run black on Python code blocks only                                  |
 
 ## Project structure
 
@@ -44,7 +45,7 @@ Documentation site built with [Astro](https://astro.build) + [Starlight](https:/
 ## Adding content
 
 - **Markdown/MDX pages**: drop `.md` or `.mdx` files into `src/content/docs/`. The URL mirrors the file path.
-- **Jupyter notebooks**: add `.ipynb` files alongside other content. Running `npm run dev` or `npm run build:ci` converts them to `.mdx` automatically. The generated `.mdx` files are git-ignored — do not commit them.
+- **Jupyter notebooks**: add `.ipynb` files alongside other content. Running `pnpm dev` or `pnpm build:ci` converts them to `.mdx` automatically. The generated `.mdx` files are git-ignored — do not commit them.
 - **Sidebar ordering**: controlled by `_meta.yaml` files in each content directory (via `starlight-auto-sidebar`).
 
 ## Notebook conventions