Summary

If the dts files are not bundled, users may use "moduleResolution": "Node16" in their tsconfig.json, and TypeScript only allow import paths in *.d.ts to include the .js extension, otherwise the dts module resolution will be broken.

Current:

// foo.d.ts
import { bar } from './bar'; 

TS expected (with: "moduleResolution": "Node16")

// foo.d.ts
import { bar } from './bar.js'; 

Solution

• Bundle dts files for ESM packages can solve this issue.
• Complete the /compiled/package/index.js paths, because the type of compiled packages are not bundled into index.d.ts.

Related Links

• [Feature]: Provode .mjs artifact  #99
• https://www.typescriptlang.org/docs/handbook/modules/theory.html#module-resolution-for-libraries

Checklist

• Tests updated (or not required).
• Documentation updated (or not required).