How nodejs/corepack works
Corepack bridges project package-manager declarations to Yarn, npm, or pnpm: CLI invocations are classified, project and environment settings select a compatible release, Corepack obtains and caches it, then launches its binary. Utility commands manage shims, cache contents, global defaults, offline archives, and local package-manager declarations. The source index and excerpts establish the principal wiring; several command implementations and Engine internals were not shown, so those relationships are limited to documented or indexed references.
Main entry points: main.ts CLI dispatcher · Engine.ts Package manager engine · corepackUtils.ts Package manager install and run · Base.ts Command base
Components 25
CLI and dispatch
- CLI dispatcher
sources/main.ts - Package manager engine
sources/Engine.ts
Package selection
- Project spec and env
sources/specUtils.ts - Version matching
sources/semverUtils.ts - Manager definitions
config.json
Download and cache
- Package manager install and run
sources/corepackUtils.ts - Package manager cache
sources/folderUtils.ts - Registry metadata and integrity
sources/npmRegistryUtils.ts - HTTP requests
sources/httpUtils.ts
Management commands
- Command base
sources/commands/Base.ts - Enable shims
sources/commands/Enable.ts - Disable shims
sources/commands/Disable.ts - Cache commands
sources/commands/Cache.ts - Global install
sources/commands/InstallGlobal.ts - Local install
sources/commands/InstallLocal.ts - Offline pack
sources/commands/Pack.ts - Update defaults
sources/commands/Up.ts - Select version
sources/commands/Use.ts - Prepare archive
sources/commands/deprecated/Prepare.ts - Hydrate cache
sources/commands/deprecated/Hydrate.ts
Runtime support
- Node filesystem helpers
sources/nodeUtils.ts - Debug logging
sources/debugUtils.ts
Other components
- Developer
- Package manager binary
- npm registry
Connections 39
- Developer → CLI dispatcher: runs CLI
README.md - CLI dispatcher → Package manager engine: dispatches request
sources/main.ts - CLI dispatcher → Enable shims: registers command
sources/main.ts - CLI dispatcher → Disable shims: registers command
sources/main.ts - CLI dispatcher → Cache commands: registers command
sources/main.ts - CLI dispatcher → Global install: registers command
sources/main.ts - CLI dispatcher → Local install: registers command
sources/main.ts - CLI dispatcher → Offline pack: registers command
sources/main.ts - CLI dispatcher → Update defaults: registers command
sources/main.ts - CLI dispatcher → Select version: registers command
sources/main.ts - CLI dispatcher → Prepare archive: registers command
sources/main.ts - CLI dispatcher → Hydrate cache: registers command
sources/main.ts - CLI dispatcher → Project spec and env: parses manager request
sources/main.ts - Package manager engine → Project spec and env: reads project selection
sources/Engine.ts - Package manager engine → Version matching: matches versions
sources/Engine.ts - Package manager engine → Manager definitions: uses definitions
sources/Engine.ts - Package manager engine → Package manager install and run: installs and runs manager
sources/Engine.ts - Package manager install and run → Package manager cache: uses cache folders
sources/corepackUtils.ts - Package manager install and run → Registry metadata and integrity: resolves package releases
sources/corepackUtils.ts - Registry metadata and integrity → HTTP requests: fetches metadata
sources/npmRegistryUtils.ts - HTTP requests → npm registry: requests registry
sources/httpUtils.ts - Package manager install and run → Package manager binary: loads manager binary
README.md - Command base → Project spec and env: resolves project specs
sources/commands/Base.ts - Command base → Package manager install and run: runs selected manager
sources/commands/Base.ts - Global install → Package manager engine: resolves and installs
sources/commands/InstallGlobal.ts - Prepare archive → Package manager engine: resolves and prepares
sources/commands/deprecated/Prepare.ts - Prepare archive → Project spec and env: reads project spec
sources/commands/deprecated/Prepare.ts - Prepare archive → Package manager cache: archives install paths
sources/commands/deprecated/Prepare.ts - Enable shims → Package manager engine: gets shim binaries
sources/commands/Enable.ts - Enable shims → Package manager binary: creates executable shims
sources/commands/Enable.ts - Cache commands → Package manager cache: clears cache
sources/commands/Cache.ts - Local install → Command base: uses command helpers
sources/commands/InstallLocal.ts - Offline pack → Command base: uses command helpers
sources/commands/Pack.ts - Update defaults → Command base: uses command helpers
sources/commands/Up.ts - Select version → Command base: uses command helpers
sources/commands/Use.ts - Package manager install and run → Node filesystem helpers: uses filesystem helpers
sources/corepackUtils.ts - Project spec and env → Node filesystem helpers: normalizes manifest text
sources/specUtils.ts - Package manager engine → Debug logging: logs resolution
sources/Engine.ts - Package manager install and run → Debug logging: logs installation
sources/corepackUtils.ts