Releases

Versioning

This section should help you understand the versioning rules of the plugin and its compatibility with TypeDoc.

Package Version

Please note that TypeDoc is still released within the 0.x.x range and may include breaking changes within each minor version release.

A new minor version of the plugin and be released with each minor TypeDoc version, and we will attempt to release in a non-breaking manner.

Besides the TypeDoc release versions, we aim to follow semantic versioning for the plugin:

• Bug fixes including minor UI tweaks will be released as patch versions.
• New features/options will be released as minor versions.
• UI changes implemented in a non-breaking manner will be released as minor versions.
• Breaking changes including option changes and fundamental UI changes will be released as major versions.

Compatibility Table

We will follow the Node.js and TypeScript versions as specified in the TypeDoc package.json file.

Version compatibility for the plugin and TypeDoc is as follows:

For more information please visit TypeDoc requirements .

Migration Guides

v4

v4.0 is a major release that includes a number of bug fixes, new features and UX improvements.

Architectural Changes

• Handlebars as a dependency has been removed.
• Updated customization model with the ability to set hooks, events and custom theming.
• Improved test and linting coverage.

New Features

• Updated output file structure.
• Improved and cleaner UX configurable with options.
• Exported option types and JSON schema.
• Exposed navigation structure.
• Ability to customize static text.
• Comprehensive documentation and examples repository.

Non-Breaking Changes

• Each module member is now output to its own file by default. See outputFileStrategy. To achieve the same output as v3 (whereby only Classes, Enums and Interfaces have their own file), set the membersWithOwnFile option.
• Parameters are output as a list by default. To achieve the same output as v3 (where parameters are output as a table), use the table key of parametersFormat.
• Comment @ tags are now displayed as headings.

Breaking Changes

• The output file structure has changed so you may need to update any cross references into your docs from external sources.
• Setting theme to "markdown" is not required and should be removed.
• The option indexTitle has been removed. Please use the "title.indexPage" key with textContentMappings.
• The option allReflectionsHaveOwnDocument has been removed (this behaviour is now the default). Please see See outputFileStrategy.
• The option entryDocument has been renamed to entryFileName to better reflect its purpose.
• The option namedAnchors has been renamed to useHTMLAnchors to better reflect its purpose.
• The option hideInPageTOC has been removed. In-page TOC are no longer included by default. You can include in-page TOCs by using typedoc-plugin-remark and the remark-toc plugin.
• The option objectLiteralTypeDeclarationStyle has been removed. Please use the list key of typeDeclarationFormat.