Inicio Explorar Axuda
Iniciar sesión
user5
/
forge_admin
1
0
Fork 0
Ficheiros Incidencias 0 Pull Requests 0 Wiki
Árbore: 03bf2029e2
Ramas Etiquetas
forge_admin
/
forge-admin-ui
/
.turing_coder_rules
/
vue-best-practices
/
rules
/
module-resolution-bundler.md

module-resolution-bundler.md 2.2 KB
Histórico Raw

title: moduleResolution Bundler Migration Issues impact: HIGH impactDescription: fixes "Cannot find module" errors after @vue/tsconfig upgrade type: capability

tags: moduleResolution, bundler, tsconfig, vue-tsconfig, node, esm

moduleResolution Bundler Migration Issues

Impact: HIGH - fixes "Cannot find module" errors after @vue/tsconfig upgrade

Recent versions of @vue/tsconfig changed moduleResolution from "node" to "bundler". This can break existing projects with errors like "Cannot find module 'vue'" or issues with resolveJsonModule.

Symptoms

  • Cannot find module 'vue' or other packages
  • Option '--resolveJsonModule' cannot be specified without 'node' module resolution
  • Errors appear after updating @vue/tsconfig
  • Some third-party packages no longer resolve

Root Cause

moduleResolution: "bundler" requires:

  1. TypeScript 5.0+
  2. Packages to have proper exports field in package.json
  3. Different resolution rules than Node.js classic resolution

Fix

Option 1: Ensure TypeScript 5.0+ everywhere

npm install -D typescript@^5.0.0

In monorepos, ALL packages must use TypeScript 5.0+.

Option 2: Add compatibility workaround

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "bundler",
    "resolvePackageJsonExports": false
  }
}

Setting resolvePackageJsonExports: false restores compatibility with packages that don't have proper exports.

Option 3: Revert to Node resolution

{
  "compilerOptions": {
    "moduleResolution": "node"
  }
}

Which Packages Break?

Packages break if they:

  • Lack exports field in package.json
  • Have incorrect exports configuration
  • Rely on Node.js-specific resolution behavior

Diagnosis

# Check which resolution is being used
cat tsconfig.json | grep moduleResolution

# Test if a specific module resolves
npx tsc --traceResolution 2>&1 | grep "module-name"

Reference