Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

typedoc-plugin-missing-exports

Gerrit0417.3kMIT4.0.0

Include non-exported types in TypeDoc documentation

typedoc-plugin

readme

typedoc-plugin-missing-exports

Automatically document symbols which aren't exported but are referenced.

Supports TypeDoc ^0.28.1

TypeDoc looks at each entry point provided and documents all exports from that entry point.

For libraries which export their full exposed API, this works well, but some packages are extremely resistant to exporting everything. This plugin is for them. After TypeDoc has finished converting packages, it will look for types which are referenced, but not exported, and place them into an internal module for that entry point (called <internal> by default).

If your project references classes which are built into the language (e.g. HTMLElement), this package will result in those types being documented too. If you want to prevent this, set TypeDoc's excludeExternals option to true. The default pattern for determining if a symbol is external will exclude everything within node_modules.

Usage

npm install typedoc-plugin-missing-exports --save-dev
npx typedoc --plugin typedoc-plugin-missing-exports

Options

  • internalModule - Define the name of the module that internal symbols which are not exported should be placed into, defaults to <internal>.
  • collapseInternalModule - Include JS in the page to collapse all <internal> entries in the navigation on page load.
  • placeInternalsInOwningModule - Disable creating a module for internal symbols, and instead place them into the referencing module.

Additional Reading

changelog

4.0.0 (2025-03-21)

  • BREAKING: Drop support for TypeDoc <0.28.1.
  • Support TypeDoc ^0.28.1, #31.

3.1.0 (2024-11-24)

  • Support TypeDoc 0.27

3.0.2 (2024-10-15)

  • Do not include the file extension in derived module names.

3.0.1 (2024-10-15)

  • Fixed an issue where modules could be created by this plugin with names including an absolute path, #12.

3.0.0 (2024-06-22)

  • Support TypeDoc 0.26
  • BREAKING: Drop support for TypeDoc before 0.26.

2.3.0 (2024-06-12)

  • Added --collapseInternalModule option.

2.2.0 (2024-01-14)

  • Fixed an issue where if a re-exported symbol referenced an internal symbol, and more than one entry point was provided to TypeDoc, this plugin would add the internal symbol to the last module, rather than the one it was associated with, #22.
  • Added --placeInternalsInOwningModule option.

2.1.0 (2023-08-25)

  • Added support for TypeDoc 0.25.x

2.0.1 (2023-07-29)

  • Fixed memory leak when running in watch mode / packages mode, TypeStrong/typedoc#2339

2.0.0 (2023-04-15)

  • BREAKING: Drop support for TypeDoc 0.22 and 0.23

1.0.0 (2022-08-12)

  • BREAKING: Will now create an <internals> module rather than a namespace to allow support for referenced default exports, #15.
  • BREAKING: Renamed internalNamespace option to internalModule

0.23.0 (2022-06-26)

  • Add support for TypeDoc 0.23.x
  • Dropped support for Node 12.

0.22.6 (2021-11-24)

  • Fix crash if @types/node is installed and Global is referenced, #5.

0.22.5 (2021-11-24)

  • Fix crash if @types/node is installed and Date is referenced, #5.

0.22.4 (2021-11-6)

  • Fix crash if a module without types is referenced as a type, #3.

0.22.3 (2021-09-15)

  • Fix broken published package again.

0.22.2 (2021-09-15)

  • Fix broken published package.

0.22.1 (2021-09-15)

  • Add repo info for linking to plugin from npm.