Cannot find module '??' or its corresponding type declarations.

[Gobd]

This happens when a dependency's package.json looks like this:

  "exports": {
    ".": {
      "node": {
        "types": "./dist/index.d.ts",
        "module": "./dist/index.module.js",
        "require": "./dist/index.js",
        "import": "./dist/index.mjs"
      },
      "browser": {
        "types": "./dist/index.d.ts",
        "import": "./dist/index.module.js",
        "require": "./dist/index.js"
      },
      "default": "./dist/index.module.js",
    },
    "./package.json": "./package.json"
  },

if you add "types": "./dist/index.d.ts" after the default the issue is fixed. This does not match regular typescript.

[RyanCavanaugh]

We really need a fully cloneable repo in order to diagnose these, can you please provide one? Thanks!

[prochri]

I think I ran into a similar issue. I created a minimal repo here: https://github.com/prochri/typescript-go-test

The imports work fine with JS tsc, but error on Go tsc:

src/file.ts:3:28 - error TS2307: Cannot find module 'three/examples/jsm/loaders/GLTFLoader' or its corresponding type declarations.

3 import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader"
                             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

src/file.ts:4:24 - error TS2307: Cannot find module 'swiper' or its corresponding type declarations.

4 import { Swiper } from "swiper"
                         ~~~~~~~~

The exports field in package.json of threejs, for example, looks like this:

  "exports": {
    ".": {
      "import": "./build/three.module.js",
      "require": "./build/three.cjs"
    },
    "./examples/fonts/*": "./examples/fonts/*",
    "./examples/jsm/*": "./examples/jsm/*",
    "./addons": "./examples/jsm/Addons.js",
    "./addons/*": "./examples/jsm/*",
    "./src/*": "./src/*",
    "./webgpu": "./build/three.webgpu.js",
    "./tsl": "./build/three.tsl.js"
  },

[EdwardIrby]

I ran into a similar issue with "@descope/nextjs-sdk" in a projecrt. TSGO is unable to resolve the imports field when the imported packages package.json export look like this:

"exports": {
  ".": {
    "import": {
      "types": "./dist/types/index.d.ts",
      "default": "./dist/esm/index.js"
    },
    "require": "./dist/cjs/index.js"
  },

However when modded to this it is able to resolve modules and types:

"exports": {
  ".": {
     "types": "./dist/types/index.d.ts",
     "default": "./dist/esm/index.js""
  },

[jrmyio]

Same is happening in vite for me:

test.ts:3:10 - error TS2305: Module '"node_modules/.pnpm/vite@6.3.5/node_modules/vite/index"' has no exported member 'searchForWorkspaceRoot'.
 import { searchForWorkspaceRoot } from "vite";

While in the editor the non tsgo version uses
"node_modules/.pnpm/vite@6.3.5/node_modules/vite/dist/node/index" instead of '"node_modules/.pnpm/vite@6.3.5/node_modules/vite/index"'.

Looking at the vite package.json:

{
  "name": "vite",
  "version": "6.3.5",
  "type": "module",
  "license": "MIT",
  "author": "Evan You",
  "description": "Native-ESM powered web dev build tool",
  "bin": {
    "vite": "bin/vite.js"
  },
  "keywords": [
    "frontend",
    "framework",
    "hmr",
    "dev-server",
    "build-tool",
    "vite"
  ],
  "main": "./dist/node/index.js",
  "types": "./dist/node/index.d.ts",
  "exports": {
    ".": {
      "module-sync": "./dist/node/index.js",
      "import": "./dist/node/index.js",
      "require": "./index.cjs"
    },
    "./client": {
      "types": "./client.d.ts"
    },
    "./module-runner": "./dist/node/module-runner.js",
    "./dist/client/*": "./dist/client/*",
    "./types/*": {
      "types": "./types/*"
    },
    "./types/internal/*": null,
    "./package.json": "./package.json"
  },
  "typesVersions": {
    "*": {
      "module-runner": [
        "dist/node/module-runner.d.ts"
      ]
    }
  },
  "imports": {
    "#module-sync-enabled": {
      "module-sync": "./misc/true.js",
      "default": "./misc/false.js"
    }
  },
  "files": [
    "bin",
    "dist",
    "misc/**/*.js",
    "client.d.ts",
    "index.cjs",
    "index.d.cts",
    "types"
  ],
  "engines": {
    "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
  },
  "repository": {
    "type": "git",
    "url": "git+https://github.com/vitejs/vite.git",
    "directory": "packages/vite"
  },
  "bugs": {
    "url": "https://github.com/vitejs/vite/issues"
  },
  "homepage": "https://vite.dev",
  "funding": "https://github.com/vitejs/vite?sponsor=1",
  "//": "READ CONTRIBUTING.md to understand what to put under deps vs. devDeps!",
  "dependencies": {....},
  "optionalDependencies": {....},
  "devDependencies": {....},
  "peerDependencies": {....},
  "peerDependenciesMeta": {....},
  "scripts": {....}
}

I had to add "types": "./dist/node/index.d.ts", just AFTER "import": "./dist/node/index.js", and BEFORE "require": "./index.cjs" at exports["./"].

So the following snippet worked for me to remove the error (I didn't test building, just type checking):

  "types": "./dist/node/index.d.ts",
  "exports": {
    ".": {
      "module-sync": "./dist/node/index.js",
      "import": "./dist/node/index.js",
      "types": "./dist/node/index.d.ts", // ADDED THIS
      "require": "./index.cjs"
    },
    "./client": {
      "types": "./client.d.ts"
    },
    "./module-runner": "./dist/node/module-runner.js",
    "./dist/client/*": "./dist/client/*",
    "./types/*": {
      "types": "./types/*"
    },
    "./types/internal/*": null,
    "./package.json": "./package.json"
  },

[mizchi]

I found same error with rolldown-vite

Work around: pnpm patch
https://github.com/mizchi/play-rolldown-vite-tsgo/blob/main/patches/rolldown-vite.patch

[Cellule]

I had a similar issue when trying to import a file not defined in the package.json exports definition

https://github.com/MaintainX/yarn-plugin-workspace-lockfile/blob/8ae38c8799320b043f0db5cd1be3d81048711564/src/index.ts#L1-L14

// InstallOptions is not exported from `@yarnpkg/core` so just go get it from its definition
import { InstallOptions } from "@yarnpkg/core/lib/Project";

This works fine in normal typescript

[jakebailey]

@mizchi's repro in #518 (comment) was the same as #904, now fixed.

In @prochri's repro in #518 (comment), things are behaving "as expected" because that repo is attempting to use the old/bad node10 module resolution mode. Flip the repro to nodenext, bundler, etc, and even TS 5.8 complains.

The same applies to @Cellule's repro above: #518 (comment)

That's also using the old node10 resolution. Flipping it to nodenext shows the same exact problem in 5.8.

npx tsc
src/index.ts:12:32 - error TS2307: Cannot find module '@yarnpkg/core/lib/Project' or its corresponding type declarations.

12 import { InstallOptions } from "@yarnpkg/core/lib/Project";
                                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~


Found 1 error in src/index.ts:12

So, these are all just down to "we are not bringing the very-not-recommended node10 resolution forward".