pnpm Workspace Dependency Issues

pnpm install

 ERR_PNPM_PEER_DEP_ISSUES  Unmet peer dependencies

.
└─┬ @types/react 19.2.7
  └── ✕ missing peer prop-types@^15.0.0

Peer dependencies that should be installed:
  prop-types@^15.8.1

pnpm add -D prop-types

auto-install-peers=true

{
  "pnpm": {
    "overrides": {
      "prop-types": "^15.8.1"
    }
  }
}

 ERR_PNPM_WORKSPACE_PKG_NOT_FOUND

In sonamu: "workspace:*" is in the dependencies but no package
named "sonamu" is present in the workspace

packages:
  - examples/**/*
  - modules/**/*
  - "!modules/create-sonamu/template/**/*"

# Check all packages in workspace
pnpm ls -r --depth -1

{
  "dependencies": {
    "sonamu": "workspace:*" // sonamu package must exist in workspace
  }
}

 ERR_PNPM_CATALOG_VERSION_MISMATCH

Package "react" has version "19.2.3" in catalog but "18.3.0"
in package.json

{
  "dependencies": {
    "react": "catalog:" // Use version from pnpm-workspace.yaml
  }
}

catalog:
  react: ^19.2.3 # Update to match package.json

# Update all packages' dependencies to catalog version
pnpm update -r

Error: Cannot find module '@types/node'
Require stack:
- /path/to/your/project/src/index.ts

public-hoist-pattern[]=@types/*
public-hoist-pattern[]=eslint-*

shamefully-hoist=true

{
  "devDependencies": {
    "@types/node": "catalog:"
  }
}

import { UserModel } from "@/application/user/user.model";
// Error: Cannot find module '@/application/user/user.model'

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

{
  "ts-node": {
    "require": ["tsconfig-paths/register"]
  }
}

pnpm add -D tsconfig-paths

import _ from "lodash-es"; // Not in package.json

pnpm add lodash-es

# Check phantom dependencies
pnpm ls --depth=Infinity

# Check why a package exists
pnpm why <package-name>

 ERR_PNPM_CANNOT_RESOLVE_OPTIONAL_DEPENDENCY

Could not resolve optional dependency @parcel/watcher

onlyBuiltDependencies:
  - "@parcel/watcher"
  - bcrypt
  - esbuild
  - sharp

# Retry installation
pnpm install --force

# Or specific package only
pnpm add sharp --force

{
  "pnpm": {
    "overrides": {
      "axios": ">=1.0.0"
    }
  }
}

{
  "pnpm": {
    "overrides": {
      "axios@<1.0.0": ">=1.0.0",
      "lodash": "^4.17.21"
    }
  }
}

overrides:
  axios@<0.30.0: ">=0.30.0"
  axios@>=0.8.1 <0.28.0: ">=0.28.0"

# Regenerate lockfile
pnpm install --force

# Check version
pnpm why axios

 ERR_PNPM_WORKSPACE_CYCLE

There is a circular dependency in the workspace:
  @sonamu-kit/react-sui -> @sonamu-kit/ui -> @sonamu-kit/react-sui

// @sonamu-kit/react-sui/package.json
{
  "dependencies": {
    "@sonamu-kit/ui": "workspace:*"  // ❌ react-sui depends on ui
  }
}

// @sonamu-kit/ui/package.json
{
  "dependencies": {
    "@sonamu-kit/react-sui": "workspace:*"  // ❌ ui depends on react-sui
  }
}

// Extract common dependencies into separate package
// Create @sonamu-kit/common, both reference it

{
  "peerDependencies": {
    "@sonamu-kit/ui": "workspace:*"
  }
}

# Verify store
pnpm store prune

# Full cleanup
pnpm store prune --force

# Delete node_modules
rm -rf node_modules

# Reinstall keeping lockfile
pnpm install --frozen-lockfile

# Or fresh install
rm pnpm-lock.yaml
pnpm install