Use pnpm catalogs for shared dependencies (#161)

* Use pnpm catalogs for shared dependencies

Centralize 26 shared dependency versions in pnpm-workspace.yaml catalog
and replace inline versions with catalog: references across all packages.

- Add catalog section to pnpm-workspace.yaml (4 prod deps, 22 dev deps)
- Normalize version inconsistencies across packages (11 deps had mismatches)
- Replace @tony.ganchev/eslint-plugin-header with eslint-plugin-header in SDK
- Add baseline-browser-mapping override to fix stale data warning in eslint

* Add pnpm catalogs note to AGENTS.md

Document that shared dependencies use pnpm catalogs so contributors
know to update pnpm-workspace.yaml rather than individual package.json files.

Author: clavery

AGENTS.md

@@ -82,6 +82,7 @@ The header is enforced by eslint via `eslint-plugin-header`. The canonical defin
 ## Setup/Packaging
 
 - use `pnpm` over `npm` for package management
+- shared dependencies are managed via [pnpm catalogs](https://pnpm.io/catalogs) — versions are defined once in the `catalog:` section of `pnpm-workspace.yaml` and referenced as `"catalog:"` in each package.json. When adding or updating a dependency that is shared across packages, update the catalog entry rather than individual package.json files.
 - the `pnpm run test` commands also run the linter after tests
 - use `pnpm run -r format` (or individually in packages) to format code with prettier
 - use `exports` field in package.json files to define public API surface for packages; use `development` field for nodejs --conditions for development ergonomics (packages/b2c-cli/bin/dev.js will use this condition)

package.json

@@ -29,8 +29,8 @@
   "devDependencies": {
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "prettier": "^3.6.2",
+    "eslint-plugin-prettier": "catalog:",
+    "prettier": "catalog:",
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.9.0",
     "typedoc-vitepress-theme": "^1.1.2",

packages/b2c-cli/package.json

@@ -13,44 +13,44 @@
   },
   "dependencies": {
     "@inquirer/prompts": "8.2.0",
-    "@oclif/core": "4.8.0",
+    "@oclif/core": "catalog:",
     "@oclif/plugin-autocomplete": "3.2.39",
     "@oclif/plugin-help": "6.2.35",
     "@oclif/plugin-not-found": "3.2.72",
     "@oclif/plugin-plugins": "5.4.53",
     "@oclif/plugin-version": "2.2.36",
     "@oclif/plugin-warn-if-update-available": "3.1.52",
     "@salesforce/b2c-tooling-sdk": "workspace:*",
-    "cliui": "9.0.1",
-    "glob": "13.0.0",
+    "cliui": "catalog:",
+    "glob": "catalog:",
     "marked": "15.0.12",
     "marked-terminal": "7.3.0",
-    "open": "11.0.0"
+    "open": "catalog:"
   },
   "devDependencies": {
-    "@eslint/compat": "^1",
-    "@oclif/prettier-config": "^0.2.1",
-    "@oclif/test": "^4",
-    "@salesforce/dev-config": "^4.3.2",
-    "@types/chai": "^4",
-    "@types/mocha": "^10",
-    "@types/node": "^22",
-    "c8": "^10.1.3",
-    "chai": "^4",
-    "eslint": "^9",
-    "eslint-config-oclif": "^6",
-    "eslint-config-prettier": "^10",
-    "eslint-plugin-header": "^3.1.1",
-    "eslint-plugin-prettier": "^5.5.4",
+    "@eslint/compat": "catalog:",
+    "@oclif/prettier-config": "catalog:",
+    "@oclif/test": "catalog:",
+    "@salesforce/dev-config": "catalog:",
+    "@types/chai": "catalog:",
+    "@types/mocha": "catalog:",
+    "@types/node": "catalog:",
+    "c8": "catalog:",
+    "chai": "catalog:",
+    "eslint": "catalog:",
+    "eslint-config-oclif": "catalog:",
+    "eslint-config-prettier": "catalog:",
+    "eslint-plugin-header": "catalog:",
+    "eslint-plugin-prettier": "catalog:",
     "execa": "^9.6.1",
-    "mocha": "^10",
-    "msw": "^2.0.0",
-    "oclif": "^4",
-    "prettier": "^3.6.2",
-    "shx": "^0.3.3",
-    "sinon": "^21.0.1",
-    "tsx": "^4.20.6",
-    "typescript": "^5"
+    "mocha": "catalog:",
+    "msw": "catalog:",
+    "oclif": "catalog:",
+    "prettier": "catalog:",
+    "shx": "catalog:",
+    "sinon": "catalog:",
+    "tsx": "catalog:",
+    "typescript": "catalog:"
   },
   "engines": {
     "node": ">=22.16.0"

packages/b2c-dx-mcp/package.json

@@ -94,36 +94,36 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.26.0",
-    "@oclif/core": "4.8.0",
+    "@oclif/core": "catalog:",
     "@salesforce/b2c-tooling-sdk": "workspace:*",
     "yaml": "2.8.1",
     "zod": "3.25.76"
   },
   "devDependencies": {
-    "@eslint/compat": "^1",
+    "@eslint/compat": "catalog:",
     "@eslint/js": "^9",
     "@modelcontextprotocol/inspector": "^0.18.0",
-    "@oclif/prettier-config": "^0.2.1",
-    "@salesforce/dev-config": "^4.3.2",
-    "@types/chai": "^4",
-    "@types/mocha": "^10",
-    "@types/node": "^22.16.5",
-    "@types/sinon": "^21.0.0",
-    "c8": "^10.1.3",
-    "chai": "^4",
-    "eslint": "^9",
-    "eslint-config-oclif": "^6",
-    "eslint-config-prettier": "^10",
-    "eslint-plugin-header": "^3.1.1",
-    "eslint-plugin-prettier": "^5.5.4",
-    "mocha": "^10",
-    "oclif": "^4",
-    "prettier": "^3.6.2",
-    "shx": "^0.3.3",
-    "sinon": "^21.0.1",
-    "tsx": "^4",
-    "typescript": "^5",
-    "typescript-eslint": "^8"
+    "@oclif/prettier-config": "catalog:",
+    "@salesforce/dev-config": "catalog:",
+    "@types/chai": "catalog:",
+    "@types/mocha": "catalog:",
+    "@types/node": "catalog:",
+    "@types/sinon": "catalog:",
+    "c8": "catalog:",
+    "chai": "catalog:",
+    "eslint": "catalog:",
+    "eslint-config-oclif": "catalog:",
+    "eslint-config-prettier": "catalog:",
+    "eslint-plugin-header": "catalog:",
+    "eslint-plugin-prettier": "catalog:",
+    "mocha": "catalog:",
+    "oclif": "catalog:",
+    "prettier": "catalog:",
+    "shx": "catalog:",
+    "sinon": "catalog:",
+    "tsx": "catalog:",
+    "typescript": "catalog:",
+    "typescript-eslint": "catalog:"
   },
   "engines": {
     "node": ">=22.16.0"

packages/b2c-plugin-example-config/package.json

@@ -32,17 +32,17 @@
     "@oclif/core": "^4"
   },
   "devDependencies": {
-    "@eslint/compat": "^1",
-    "@oclif/core": "^4",
-    "@salesforce/dev-config": "^4.3.2",
-    "@types/node": "^22",
-    "eslint": "^9",
-    "eslint-config-oclif": "^6",
-    "eslint-config-prettier": "^10",
-    "eslint-plugin-header": "^3.1.1",
-    "eslint-plugin-prettier": "^5.5.4",
-    "prettier": "^3.6.2",
-    "typescript": "^5"
+    "@eslint/compat": "catalog:",
+    "@oclif/core": "catalog:",
+    "@salesforce/dev-config": "catalog:",
+    "@types/node": "catalog:",
+    "eslint": "catalog:",
+    "eslint-config-oclif": "catalog:",
+    "eslint-config-prettier": "catalog:",
+    "eslint-plugin-header": "catalog:",
+    "eslint-plugin-prettier": "catalog:",
+    "prettier": "catalog:",
+    "typescript": "catalog:"
   },
   "engines": {
     "node": ">=22.16.0"

packages/b2c-tooling-sdk/eslint.config.mjs

@@ -4,14 +4,15 @@
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
 import {includeIgnoreFile} from '@eslint/compat';
-import headerPlugin from '@tony.ganchev/eslint-plugin-header';
+import headerPlugin from 'eslint-plugin-header';
 import tseslint from 'typescript-eslint';
 import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 
 import {copyrightHeader, sharedRules, chaiTestRules, prettierPlugin} from '../../eslint.config.mjs';
 
 const gitignorePath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '.gitignore');
+headerPlugin.rules.header.meta.schema = false;
 
 export default [
   includeIgnoreFile(gitignorePath),

packages/b2c-tooling-sdk/package.json

@@ -319,33 +319,33 @@
     "generate:docs-index": "tsx scripts/generate-docs-index.ts"
   },
   "devDependencies": {
-    "@eslint/compat": "^1",
-    "@oclif/core": "^4",
-    "@oclif/prettier-config": "^0.2.1",
-    "@oclif/test": "^4.1.14",
-    "@salesforce/dev-config": "^4.3.2",
-    "@tony.ganchev/eslint-plugin-header": "^3.1.11",
+    "@eslint/compat": "catalog:",
+    "@oclif/core": "catalog:",
+    "@oclif/prettier-config": "catalog:",
+    "@oclif/test": "catalog:",
+    "@salesforce/dev-config": "catalog:",
     "@types/archiver": "^7.0.0",
-    "@types/chai": "^4.3.20",
+    "@types/chai": "catalog:",
     "@types/ejs": "^3.1.5",
-    "@types/mocha": "^10.0.10",
-    "@types/node": "^22",
-    "@types/sinon": "^21.0.0",
+    "@types/mocha": "catalog:",
+    "@types/node": "catalog:",
+    "@types/sinon": "catalog:",
     "@types/xml2js": "^0.4.14",
-    "c8": "^10.1.3",
-    "chai": "^4.5.0",
-    "eslint": "^9",
-    "eslint-config-prettier": "^10",
-    "eslint-plugin-prettier": "^5.5.4",
-    "mocha": "^10.8.2",
-    "msw": "^2.12.4",
+    "c8": "catalog:",
+    "chai": "catalog:",
+    "eslint": "catalog:",
+    "eslint-config-prettier": "catalog:",
+    "eslint-plugin-header": "catalog:",
+    "eslint-plugin-prettier": "catalog:",
+    "mocha": "catalog:",
+    "msw": "catalog:",
     "openapi-typescript": "^7.10.1",
-    "prettier": "^3.6.2",
-    "shx": "^0.3.3",
-    "sinon": "^21.0.1",
-    "tsx": "^4.20.6",
-    "typescript": "^5",
-    "typescript-eslint": "^8"
+    "prettier": "catalog:",
+    "shx": "catalog:",
+    "sinon": "catalog:",
+    "tsx": "catalog:",
+    "typescript": "catalog:",
+    "typescript-eslint": "catalog:"
   },
   "peerDependencies": {
     "@oclif/core": "^4"
@@ -362,14 +362,14 @@
     "@salesforce/telemetry": "6.4.6",
     "archiver": "7.0.1",
     "chokidar": "5.0.0",
-    "cliui": "9.0.1",
+    "cliui": "catalog:",
     "ejs": "3.1.10",
     "fuse.js": "7.1.0",
-    "glob": "13.0.0",
+    "glob": "catalog:",
     "i18next": "25.7.4",
     "jszip": "3.10.1",
     "minimatch": "10.1.1",
-    "open": "11.0.0",
+    "open": "catalog:",
     "openapi-fetch": "0.15.0",
     "pino": "10.1.0",
     "pino-pretty": "13.1.2",

packages/b2c-vs-extension/package.json

@@ -77,20 +77,20 @@
     "analyze": "ANALYZE_BUNDLE=1 node scripts/esbuild-bundle.mjs"
   },
   "devDependencies": {
-    "@eslint/compat": "^1",
-    "@types/mocha": "^10.0.10",
-    "@types/node": "^22",
+    "@eslint/compat": "catalog:",
+    "@types/mocha": "catalog:",
+    "@types/node": "catalog:",
     "@types/vscode": "^1.105.1",
     "@vscode/test-cli": "^0.0.12",
     "@vscode/test-electron": "^2.5.2",
     "@vscode/vsce": "^3.7.1",
     "esbuild": "^0.24.0",
-    "eslint": "^9",
-    "eslint-config-prettier": "^10",
-    "eslint-plugin-header": "^3.1.1",
-    "eslint-plugin-prettier": "^5.5.4",
-    "prettier": "^3.6.2",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.54.0"
+    "eslint": "catalog:",
+    "eslint-config-prettier": "catalog:",
+    "eslint-plugin-header": "catalog:",
+    "eslint-plugin-prettier": "catalog:",
+    "prettier": "catalog:",
+    "typescript": "catalog:",
+    "typescript-eslint": "catalog:"
   }
 }