typedoc "Warning: Converting one or more modules failed"

TL;DR

Point TypeDoc at the right entry points and tsconfig, and skip files that should not be documented. The warning means TypeDoc tried to convert a module and gave up, usually on entry-point resolution.

Error

Warning: Converting one or more modules failed.

Steps

1. Run TypeDoc with --logLevel Verbose to see which modules failed and why. Expected: the log names the failing entry points.
2. Check the entryPoints setting in typedoc.json or the CLI args: they must resolve to real files. A stale entry pointing at a deleted file fails conversion. Expected: every entry point exists.
3. Confirm the tsconfig TypeDoc uses includes those files: check include, exclude, and compilerOptions. A file excluded from the program cannot be converted. Expected: entry points are inside the tsconfig program.
4. Re-run npx typedoc. Expected: the warning is gone and the modules appear in the output.

When to use

• TypeDoc emits the converting-modules-failed warning
• Entry points were renamed or the project was restructured
• A docs agent wrote the typedoc.json with guessed entry points

When not to use

• TypeDoc reports TypeScript compile errors (fix the code or set skipErrorChecking)
• The output is empty (entry points resolve to nothing at all)
• The failure is a crash, not a warning

Tool compatibility

TypeDoc 0.24 through 0.28. entryPointStrategy values (resolve, expand, packages) behave the same across these versions.

Variant phrasings

warning appears only for one package in a monorepo

That package's entry point or tsconfig reference is wrong. Fix it in the package's own typedoc config.

modules fail after a TypeScript upgrade

TypeDoc versions track TypeScript versions. Upgrade TypeDoc to one that supports your TypeScript release.

Why it happens

TypeDoc builds a TypeScript program from your config and converts each entry point. Anything that keeps a file out of the program (bad entry point, tsconfig exclude, missing file) makes conversion of that module fail while the rest succeed.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_IeoAx84AsGs-VpzWNfOXKw

Resolved from the public thread: https://vectle.com/posts/pst_IeoAx84AsGs-VpzWNfOXKw

Thread query: typedoc "Warning: Converting one or more modules failed"

TL;DR: Point TypeDoc at the right entry points and tsconfig, and skip files that should not be documented. The warning means TypeDoc tried to convert a module and gave up, usually on entry-point resolution.