Releases: TypeStrong/typedoc
Releases · TypeStrong/typedoc
v0.28.4
Features
- The navigation in the default theme will now attempt to break long names onto multiple lines, #2940.
- Added German (de) localization, #2941.
Bug Fixes
- TypeDoc's default theme now uses the same chevron for all collapsible elements, #2924
ThechevronSmallhelper is now deprecated and will be removed with v0.29.0. - Classes/interfaces marked with
@hiddenwill no longer appear in the
"Hierarchy" section of the docs. - TypeDoc now handles wildcard JSDoc types, #2949.
Thanks!
v0.28.3
Bug Fixes
@inlinenow functions when referencing tuple types, #2932.@linklinks to the current page are now rendered, #2934.@includeCodenow supports regions in TypeScript files with.mtsand.ctsfile extensions, #2935.- Aliased symbols (re-exports) are now resolved before checking if they are excluded/external, #2937.
- Improved error reporting when paths including Windows separators are provided as globs, #2938.
v0.28.2
Features
@group noneand@category nonewill now render their children without a section
heading in the default theme, #2922.- Added
@disableGroupstag to completely disable the grouping mechanism for a
given reflection, #2922.
Bug Fixes
- Variables using
@classnow correctly handle@category, #2914. - Variables using
@classnow include constructor parameters, #2914. - Variables using
@classwith a generic first constructor function now adopt
that function's type parameters as the class type parameters, #2914. - When printing entry point globs which fail to match any paths, TypeDoc will no longer normalize the glob, #2918.
- Inlining types can now handle more type variants, #2920.
- Fixed behavior of
externalSymbolLinkMappingsoption when URL is set to#, #2921. - Fixed broken links within module pages when structure-dir router was used, #2928.
- Type parameters on JS classes defined with
@typedefnow correctly handle the constraint, #2929. - API:
toStringon types containing index signatures now behave correctly, #2917. - Added
@inlineTypeto the list of tags excluded by default.
v0.28.1
Features
- The
TypeDocOptionsinterface now marks options as optional so it no longer has to be wrapped inPartial
for use in config files, #2901. - API: Expose control methods for deferred conversion for plugin use (typedoc-plugin-missing-exports)
- API: Expose method to disable TypeDoc usage of
localStoragewithout clearing it, #2908.
Bug Fixes
--watchcan now infer entry points frompackage.jsonas supported in non-watch mode, #2899.@includewith regions now works on files with CRLF line endings, #2902.- Generated page names now correctly handles UTF-8 characters requiring more than 16 bits #2905.
- Fixed a crash when converting
module.exports = [], #2909. - Fixed URL generation which introduced a superfluous
./in relative links, #2910.
Thanks!
v0.28.0
Breaking Changes
- TypeDoc now expects all input globs paths to be specified with
/path separators, #2825. - TypeDoc's
--entryPointStrategy mergemode now requires JSON from at least version 0.28.0. - Removed
jptranslations fromlang, to migrate switch toja. - File name references in
intentionallyNotExportednow use a package name/package relative path instead of an absolute path for matching. - The
source-ordersort ordering now considers package names / package relative paths instead of using the absolute paths to a file. - TypeDoc will only check for a project README file next to the discovered
package.jsonfile if--readmeis not set
this change improves handling of monorepo setups where some packages have readme files and others do not, #2875. - Function-like variable exports will now only be automatically converted as function types if
they are initialized with a function expression. TypeDoc can be instructed to convert them as functions
with the@functiontag, #2881. - Object literal type alias types will now be converted in a way which causes them to be rendered more similarly
to how interfaces are rendered, #2817.
API Breaking Changes
ProjectReflection.getReflectionFromSymbolandProjectReflection.getSymbolFromReflectionhave been moved toContextPathandPathArrayparameter types now always contain normalized paths.- Introduced a
Routerwhich is used for URL creation.Reflection.url,
Reflection.anchor, andReflection.hasOwnDocumenthave been removed. Deserializer.reviveProject(s)no longer accepts an option to add project documents.Deserializer.reviveProjectsnow requires analwaysCreateEntryPointModuleoption.Comment.serializeDisplayPartsno longer requires a serializer argument.ReflectionSymbolId.fileNameis now optional, TypeDoc now stores a combination of a package name and package relative path instead.
ThefileNameproperty will be present when initially created, but is not serialized.- Removed
DeclarationReflection.relevanceBoostattribute which was added for plugins, but never used. i18nproxy is no longer passed to many functions, instead, referencei18nexported from the module directly.ReflectionKind.singularStringandReflectionKind.pluralStringnow returns translated strings.
The methods onInternationalizationto do this previously have been removed.- The HTML output structure for the search box has changed to support the new modal.
DefaultThemeRenderContext'stypeDeclarationandtypeDetailsIfUseful
methods now require both a reflection and a type in order to support
@expandType
Features
- Add support for TypeScript 5.8.x
- The search modal in the HTML output has been rewritten to provide better mobile support
- Added a
--routeroption which can be used to modify TypeDoc's output folder
structure. This can be extended with plugins, #2111. - Introduced the
@primaryExportmodifier tag to provide more fine grained
control over export conversion order, #2856 - Introduced
packagesRequiringDocumentationoption forvalidation.notDocumented, TypeDoc will expect comments to be present for symbols in the specified packages. - TypeDoc now exports a
typedoc/browserentrypoint for parsing and using serialized JSON files, #2528. - Type
packageOptionsasPartial<TypeDocOptions>, #2878. - TypeDoc will now warn if an option which should only be set at the root level is set in
packageOptions, #2878. - Introduced
@functiontag to force TypeDoc to convert variable declarations with a type annotation as functions, #2881. - Exposed a
TypeDocglobal object in the HTML theme which can be used to prevent TypeDoc from usinglocalStorage, #2872. - Introduced
@preventInlineand@inlineTypetags for further control extending the@inlinetag, #2862. - Introduced
@preventExpandand@expandTypetags for further control extending the@expandtag, #2862. - API: Introduced
DefaultThemeRenderContext.reflectionIconfor more granular control over displayed reflection icons.
Bug Fixes
- TypeDoc will now only create references for symbols re-exported from modules.
- Variable-functions will now prefer placing the comment on the signature if there is only one signature present, #2824.
- User filter settings will no longer sometimes cause the search to have fewer visible results than expected.
- Fixed handling of expando functions which were also merged with a namespace, #2876.
- Fixed rendering of function types within arrays and union types, #2892.
- Fixed an issue where if the theme JS didn't load, the page wouldn't be shown, #2894.
Thanks!
v0.28.0-beta.2
See #2868 (comment) for discussion of changes
v0.28.0-beta.1
See #2868 (comment) for discussion of changes
v0.27.9
v0.28.0-beta.0
See #2868 for discussion of changes
v0.27.8
Features
- The
visibilityFilteroption now supports individual signatures, #2846. - The
faviconoption may now be given a link starting withhttps?://instead of a path, #2851. - TypeDoc now supports specifying
#as the link inexternalSymbolLinkMappingsto indicate the type should not be linked to, #2853.
Bug Fixes
- Fixed an issue where unrecognized languages would incorrectly be listed in the list of languages with translations, #2852.
- Unresolved external type references will no longer incorrectly linked to
undefined, #2854.