TypeStrong/TypeDoc (typedoc)
### [`v0.25.1`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0251-2023-09-04)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.25.0...v0.25.1)
##### Features
- Added `stripYamlFrontmatter` config option to remove YAML frontmatter from README.md, [#2381](https://togithub.com/TypeStrong/TypeDoc/issues/2381).
- Added `--excludeCategories` config option to remove reflections present in any excluded category, [#1407](https://togithub.com/TypeStrong/TypeDoc/issues/1407).
- If no tsconfig.json file is present, TypeDoc will now attempt to compile without setting any compiler options, [#2304](https://togithub.com/TypeStrong/TypeDoc/issues/2304).
- Navigation is now written to a JS file and built dynamically, which significantly decreases document generation time
with large projects and also provides large space benefits. Themes may now override `DefaultTheme.buildNavigation`
to customize the displayed navigation tree, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
Note: This change renders `navigation.fullTree` obsolete. If you set it, TypeDoc will warn that it is being ignored.
It will be removed in v0.26.
- The search index is now compressed before writing, which reduces most search index sizes by ~5-10x.
- TypeDoc will now attempt to cache icons when `DefaultThemeRenderContext.icons` is overwritten by a custom theme.
Note: To perform this optimization, TypeDoc relies on `DefaultThemeRenderContext.iconCache` being rendered within
each page. TypeDoc does it in the `defaultLayout` template.
- Cache URL derivation during generation, [#2386](https://togithub.com/TypeStrong/TypeDoc/issues/2386).
##### Bug Fixes
- `@property` now works as expected if used to override a method's documentation.
- Deprecated functions/methods are now correctly rendered with a struck-out name.
- `--watch` mode works again, [#2378](https://togithub.com/TypeStrong/TypeDoc/issues/2378).
- Improved support for optional names within JSDoc types, [#2384](https://togithub.com/TypeStrong/TypeDoc/issues/2384).
- Fixed duplicate rendering of reflection flags on signature parameters, [#2385](https://togithub.com/TypeStrong/TypeDoc/issues/2385).
- TypeDoc now handles the `intrinsic` keyword if TS intrinsic types are included in documentation.
- `--exclude` is now respected when expanding globs in entry points, [#2376](https://togithub.com/TypeStrong/TypeDoc/issues/2376).
##### Thanks!
- [@ajesshope](https://togithub.com/ajesshope)
- [@HemalPatil](https://togithub.com/HemalPatil)
- [@hrueger](https://togithub.com/hrueger)
- [@typhonrt](https://togithub.com/typhonrt)
### [`v0.25.0`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0250-2023-08-25)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.8...v0.25.0)
##### Breaking Changes
- Bump minimum Node version to 16.
- Removed `legacy-packages` option for `--entryPointStrategy`.
- Changed default value of `--categorizeByGroup` to `false`.
- Specifying a link as the `gitRemote` is no longer supported.
- An `Application` instance must now be retrieved via `Application.bootstrap` or `Application.bootstrapWithPlugins`, [#2268](https://togithub.com/TypeStrong/TypeDoc/issues/2268).
- Removed `ReflectionKind.ObjectLiteral` that was never used by TypeDoc.
- Removed deprecated members `DefaultThemeRenderContext.comment` and `DefaultThemeRenderContext.attemptExternalResolution`.
##### Features
- Added support for TypeScript 5.2, [#2373](https://togithub.com/TypeStrong/TypeDoc/issues/2373).
- TypeDoc config files now support options default-exported from an ESM config file, [#2268](https://togithub.com/TypeStrong/TypeDoc/issues/2268).
- TypeDoc config files may now export a promise containing configuration, [#2268](https://togithub.com/TypeStrong/TypeDoc/issues/2268).
- Added `--preserveLinkText` option (defaults to true) which determines whether the reflection name or full link text is included
in the output when no override is specified, [#2355](https://togithub.com/TypeStrong/TypeDoc/issues/2355).
- Added a no-results placeholder when no search results are available, [#2347](https://togithub.com/TypeStrong/TypeDoc/issues/2347).
- Implemented several miscellaneous performance improvements to generate docs faster, this took the time to generate TypeDoc's
site from ~5.6 seconds to ~5.4 seconds.
- Added `--disableGit` option to prevent TypeDoc from using Git to try to determine if sources can be linked, [#2326](https://togithub.com/TypeStrong/TypeDoc/issues/2326).
- Added support for tags `@showGroups`, `@hideGroups`, `@showCategories`, `@hideCategories` to configure the navigation pane on a
per-reflection basis, [#2329](https://togithub.com/TypeStrong/TypeDoc/issues/2329).
- With `--jsDocCompatibility.defaultTags` set, `@defaultValue` is now implicitly a code block if the text contains no code, [#2370](https://togithub.com/TypeStrong/TypeDoc/issues/2370).
##### Bug Fixes
- Fixed link discovery if nested (`Foo#bar`) links were used and `--useTsLinkResolution` is enabled in some cases, [#2360](https://togithub.com/TypeStrong/TypeDoc/issues/2360).
- Links with invalid declaration references will no longer silently link to the wrong page in some cases, [#2360](https://togithub.com/TypeStrong/TypeDoc/issues/2360).
- Fixed duplicate definitions in type hierarchy when using packages mode, [#2327](https://togithub.com/TypeStrong/TypeDoc/issues/2327).
- `@inheritDoc` was not properly resolved across packages in packages mode, [#2331](https://togithub.com/TypeStrong/TypeDoc/issues/2331).
- Added warning for attempted `@interface` use on union types, [#2352](https://togithub.com/TypeStrong/TypeDoc/issues/2352).
- Fixed misleading type annotation on `Theme.getUrls`, [#2318](https://togithub.com/TypeStrong/TypeDoc/issues/2318).
- Fixed duplicate namespace in documentation if `@namespace` is used on a variable with an associated namespace, [#2364](https://togithub.com/TypeStrong/TypeDoc/issues/2364).
- Fixed `@namespace` property discovery if merged with a type and the type was declared first [#2364](https://togithub.com/TypeStrong/TypeDoc/issues/2364).
- Tables in markdown are now styled, [#2366](https://togithub.com/TypeStrong/TypeDoc/issues/2366).
- Sidebar links no longer open in a new tab, [#2353](https://togithub.com/TypeStrong/TypeDoc/issues/2353).
- Headers now include some padding before rendering text, [#2316](https://togithub.com/TypeStrong/TypeDoc/issues/2316).
- Symbol locations for signatures on `reflection.sources` now considers the node's name like non-signature location discovery does.
##### Thanks!
- [@camc314](https://togithub.com/camc314)
- [@cprussin](https://togithub.com/cprussin)
- [@roggervalf](https://togithub.com/roggervalf)
- [@Th3S4mur41](https://togithub.com/Th3S4mur41)
#### v0.24.8 (2023-06-04)
##### Features
- Added support for TypeScript 5.1, [#2296](https://togithub.com/TypeStrong/TypeDoc/issues/2296).
- Added `navigation.fullTree` to control rendering the full navigation tree on each page, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
This option will likely be replaced in 0.25 with dynamic loading of the full tree.
- TypeDoc's `--pretty` option now also controls whether generated HTML contains line breaks, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
- Optimized icon caching to reduce file size in generated HTML documentation, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
- Render property description of "roughly top level" object types, [#2276](https://togithub.com/TypeStrong/TypeDoc/issues/2276).
- Added `MarkdownEvent.INCLUDE` for plugins, [#2284](https://togithub.com/TypeStrong/TypeDoc/issues/2284).
##### Bug Fixes
- When rendering functions/methods, TypeDoc will now render the comment summary above the parameters/return type,
and any other block tags in the order they are defined in the comment, [#2285](https://togithub.com/TypeStrong/TypeDoc/issues/2285).
- Comments are no longer removed from classes/interfaces containing call signatures, [#2290](https://togithub.com/TypeStrong/TypeDoc/issues/2290).
##### Thanks!
- [@krisztianb](https://togithub.com/krisztianb)
- [@WikiRik](https://togithub.com/WikiRik)
#### v0.24.7 (2023-05-08)
##### Features
- TypeDoc will now allow conversion without any entry points to support "readme only" packages, [#2264](https://togithub.com/TypeStrong/TypeDoc/issues/2264).
##### Bug Fixes
- Category children are now sorted according to the `sort` option, [#2272](https://togithub.com/TypeStrong/TypeDoc/issues/2272).
- Inline tags no longer require a space after the tag name to be parsed as a tag, [#2273](https://togithub.com/TypeStrong/TypeDoc/issues/2273).
- Fixed module/namespace links in navigation when viewed in Safari, [#2275](https://togithub.com/TypeStrong/TypeDoc/issues/2275).
#### v0.24.6 (2023-04-24)
##### Features
- Improved error messaging if a provided entry point could not be converted into a documented module reflection, [#2242](https://togithub.com/TypeStrong/TypeDoc/issues/2242).
- API: Added support for `g`, `circle`, `ellipse`, `polygon`, and `polyline` svg elements, [#2259](https://togithub.com/TypeStrong/TypeDoc/issues/2259).
- Extended `jsDocCompatibility` option with `inheritDocTag` to ignore fully lowercase `inheritDoc` tags and
`ignoreUnescapedBraces` to disable warnings about unescaped `{` and `}` characters in comments.
##### Bug Fixes
- `--useTsLinkResolution` is no longer ignored within block tags, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260).
- The current namespace will also be expanded in the navigation on page load, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260).
- Fixed flicker of navigation pane when reloading a page caused by updating expansion state after the page was loaded.
- Fixed an infinite loop if more than one entry point was provided, and all entry points were the same.
##### Thanks!
- [@FlippieCoetser](https://togithub.com/FlippieCoetser)
#### v0.24.5 (2023-04-22)
##### Features
- Categories and groups can now be shown in the navigation, added `--navigation.includeCategories`
and `--navigation.includeGroups` to control this behavior. The `--categorizeByGroup` option also
effects this behavior. If `categorizeByGroup` is set (the default) and `navigation.includeGroups` is
*not* set, the value of `navigation.includeCategories` will be effectively ignored since categories
will be created only within groups, [#1532](https://togithub.com/TypeStrong/TypeDoc/issues/1532).
- Added support for discovering a "module" comment on global files, [#2165](https://togithub.com/TypeStrong/TypeDoc/issues/2165).
- Added copy code to clipboard button, [#2153](https://togithub.com/TypeStrong/TypeDoc/issues/2153).
- Function `@returns` blocks will now be rendered with the return type, [#2180](https://togithub.com/TypeStrong/TypeDoc/issues/2180).
- Added `--groupOrder` option to specify the sort order of groups, [#2251](https://togithub.com/TypeStrong/TypeDoc/issues/2251).
##### Bug Fixes
- Type parameter constraints now respect the `--hideParameterTypesInTitle` option, [#2226](https://togithub.com/TypeStrong/TypeDoc/issues/2226).
- Even more contrast fixes, [#2248](https://togithub.com/TypeStrong/TypeDoc/issues/2248).
- Fix semantic highlighting for predicate type's parameter references, [#2249](https://togithub.com/TypeStrong/TypeDoc/issues/2249).
- Fixed broken links to heading titles.
- Fixed inconsistent styling between type parameter lists and parameter lists.
- TypeDoc will now warn if more than one `@returns` block is is present in a function, and ignore the duplicate blocks as specified by TSDoc.
##### Thanks!
- [@FlippieCoetser](https://togithub.com/FlippieCoetser)
#### v0.24.4 (2023-04-16)
##### Bug Fixes
- Fixed broken semantic coloring, [#2247](https://togithub.com/TypeStrong/TypeDoc/issues/2247).
- Increased contrast for parameter titles in dark mode to meet WCAG AA contrast requirements, [#2244](https://togithub.com/TypeStrong/TypeDoc/issues/2244).
- Underline color of index links now matches the text color, [#2245](https://togithub.com/TypeStrong/TypeDoc/issues/2245).
- Increased contract for active menu item text in dark mode.
#### v0.24.3 (2023-04-16)
##### Bug Fixes
- Fixed path expansion on Windows preventing generation, [#2243](https://togithub.com/TypeStrong/TypeDoc/issues/2243) and [#2241](https://togithub.com/TypeStrong/TypeDoc/issues/2241).
#### v0.24.2 (2023-04-15)
##### Features
- Added semantic link coloring for reflection names & links, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227).
Note: This resulted in function signatures becoming too busy for easy scanning with even slightly
complicated signatures as such, TypeDoc now only renders parameter names in the signature title
and includes the type in the parameter details as usual. This can be controlled with the new
`--hideParameterTypesInTitle` option.
- Conditional types will now render their branches on the next line for easier comprehension.
##### Bug Fixes
- Fixed `&` showing as `&` and HTML text showing up in page contents navigation, [#2224](https://togithub.com/TypeStrong/TypeDoc/issues/2224).
- Increased padding between sections when one navigation column is displayed, [#2225](https://togithub.com/TypeStrong/TypeDoc/issues/2225).
- Correct padding for navigation elements with a displayed icon, [#2229](https://togithub.com/TypeStrong/TypeDoc/issues/2229).
- Fixed `source-order` sort strategy failing to compare reflections within a file.
- Added `enum-member-source-order` specialization of the `source-order` sort strategy which only compares enum members, [#2237](https://togithub.com/TypeStrong/TypeDoc/issues/2237).
- Updated highlight colors for semantic links to meet WCAG AA contrast requirements, [#2228](https://togithub.com/TypeStrong/TypeDoc/issues/2228).
- Type parameters are now highlighted consistently, [#2230](https://togithub.com/TypeStrong/TypeDoc/issues/2230).
- Fixed semantic coloring in type and function signatures, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227).
- Fixed issue where removing a reflection indirectly containing an object/function type would only partially remove the reflection, [#2231](https://togithub.com/TypeStrong/TypeDoc/issues/2231).
- Fixed "Implementation of X.y" links if a mixture of methods and property-methods are used, [#2233](https://togithub.com/TypeStrong/TypeDoc/issues/2233).
- "Implementation of" text to symbol-properties not contained in the documentation will now use the resolved name instead of a `__@` symbol name, [#2234](https://togithub.com/TypeStrong/TypeDoc/issues/2234).
- Fix expansion of globs if a single entry point is provided, [#2235](https://togithub.com/TypeStrong/TypeDoc/issues/2235).
- Validation will no longer be skipped for sub packages when running with `--entryPointStrategy packages`.
- Fixed broken theme toggle if the page contained a member named "theme".
##### Thanks!
- [@RunDevelopment](https://togithub.com/RunDevelopment)
#### v0.24.1 (2023-04-09)
##### Bug Fixes
- Improve detection for legacy JSDoc `@example` tags, [#2222](https://togithub.com/TypeStrong/TypeDoc/issues/2222).
- The page footer will now appear at the bottom of the page even if the page is short, [#2223](https://togithub.com/TypeStrong/TypeDoc/issues/2223).
### [`v0.24.8`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0248-2023-06-04)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.7...v0.24.8)
##### Features
- Added support for TypeScript 5.1, [#2296](https://togithub.com/TypeStrong/TypeDoc/issues/2296).
- Added `navigation.fullTree` to control rendering the full navigation tree on each page, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
This option will likely be replaced in 0.25 with dynamic loading of the full tree.
- TypeDoc's `--pretty` option now also controls whether generated HTML contains line breaks, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
- Optimized icon caching to reduce file size in generated HTML documentation, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287).
- Render property description of "roughly top level" object types, [#2276](https://togithub.com/TypeStrong/TypeDoc/issues/2276).
- Added `MarkdownEvent.INCLUDE` for plugins, [#2284](https://togithub.com/TypeStrong/TypeDoc/issues/2284).
##### Bug Fixes
- When rendering functions/methods, TypeDoc will now render the comment summary above the parameters/return type,
and any other block tags in the order they are defined in the comment, [#2285](https://togithub.com/TypeStrong/TypeDoc/issues/2285).
- Comments are no longer removed from classes/interfaces containing call signatures, [#2290](https://togithub.com/TypeStrong/TypeDoc/issues/2290).
##### Thanks!
- [@krisztianb](https://togithub.com/krisztianb)
- [@WikiRik](https://togithub.com/WikiRik)
### [`v0.24.7`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0247-2023-05-08)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.6...v0.24.7)
##### Features
- TypeDoc will now allow conversion without any entry points to support "readme only" packages, [#2264](https://togithub.com/TypeStrong/TypeDoc/issues/2264).
##### Bug Fixes
- Category children are now sorted according to the `sort` option, [#2272](https://togithub.com/TypeStrong/TypeDoc/issues/2272).
- Inline tags no longer require a space after the tag name to be parsed as a tag, [#2273](https://togithub.com/TypeStrong/TypeDoc/issues/2273).
- Fixed module/namespace links in navigation when viewed in Safari, [#2275](https://togithub.com/TypeStrong/TypeDoc/issues/2275).
### [`v0.24.6`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0246-2023-04-24)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.5...v0.24.6)
##### Features
- Improved error messaging if a provided entry point could not be converted into a documented module reflection, [#2242](https://togithub.com/TypeStrong/TypeDoc/issues/2242).
- API: Added support for `g`, `circle`, `ellipse`, `polygon`, and `polyline` svg elements, [#2259](https://togithub.com/TypeStrong/TypeDoc/issues/2259).
- Extended `jsDocCompatibility` option with `inheritDocTag` to ignore fully lowercase `inheritDoc` tags and
`ignoreUnescapedBraces` to disable warnings about unescaped `{` and `}` characters in comments.
##### Bug Fixes
- `--useTsLinkResolution` is no longer ignored within block tags, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260).
- The current namespace will also be expanded in the navigation on page load, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260).
- Fixed flicker of navigation pane when reloading a page caused by updating expansion state after the page was loaded.
- Fixed an infinite loop if more than one entry point was provided, and all entry points were the same.
##### Thanks!
- [@FlippieCoetser](https://togithub.com/FlippieCoetser)
### [`v0.24.5`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0245-2023-04-22)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.4...v0.24.5)
##### Features
- Categories and groups can now be shown in the navigation, added `--navigation.includeCategories`
and `--navigation.includeGroups` to control this behavior. The `--categorizeByGroup` option also
effects this behavior. If `categorizeByGroup` is set (the default) and `navigation.includeGroups` is
*not* set, the value of `navigation.includeCategories` will be effectively ignored since categories
will be created only within groups, [#1532](https://togithub.com/TypeStrong/TypeDoc/issues/1532).
- Added support for discovering a "module" comment on global files, [#2165](https://togithub.com/TypeStrong/TypeDoc/issues/2165).
- Added copy code to clipboard button, [#2153](https://togithub.com/TypeStrong/TypeDoc/issues/2153).
- Function `@returns` blocks will now be rendered with the return type, [#2180](https://togithub.com/TypeStrong/TypeDoc/issues/2180).
- Added `--groupOrder` option to specify the sort order of groups, [#2251](https://togithub.com/TypeStrong/TypeDoc/issues/2251).
##### Bug Fixes
- Type parameter constraints now respect the `--hideParameterTypesInTitle` option, [#2226](https://togithub.com/TypeStrong/TypeDoc/issues/2226).
- Even more contrast fixes, [#2248](https://togithub.com/TypeStrong/TypeDoc/issues/2248).
- Fix semantic highlighting for predicate type's parameter references, [#2249](https://togithub.com/TypeStrong/TypeDoc/issues/2249).
- Fixed broken links to heading titles.
- Fixed inconsistent styling between type parameter lists and parameter lists.
- TypeDoc will now warn if more than one `@returns` block is is present in a function, and ignore the duplicate blocks as specified by TSDoc.
##### Thanks!
- [@FlippieCoetser](https://togithub.com/FlippieCoetser)
### [`v0.24.4`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0244-2023-04-16)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.3...v0.24.4)
##### Bug Fixes
- Fixed broken semantic coloring, [#2247](https://togithub.com/TypeStrong/TypeDoc/issues/2247).
- Increased contrast for parameter titles in dark mode to meet WCAG AA contrast requirements, [#2244](https://togithub.com/TypeStrong/TypeDoc/issues/2244).
- Underline color of index links now matches the text color, [#2245](https://togithub.com/TypeStrong/TypeDoc/issues/2245).
- Increased contract for active menu item text in dark mode.
### [`v0.24.3`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0243-2023-04-16)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.2...v0.24.3)
##### Bug Fixes
- Fixed path expansion on Windows preventing generation, [#2243](https://togithub.com/TypeStrong/TypeDoc/issues/2243) and [#2241](https://togithub.com/TypeStrong/TypeDoc/issues/2241).
### [`v0.24.2`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0242-2023-04-15)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.1...v0.24.2)
##### Features
- Added semantic link coloring for reflection names & links, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227).
Note: This resulted in function signatures becoming too busy for easy scanning with even slightly
complicated signatures as such, TypeDoc now only renders parameter names in the signature title
and includes the type in the parameter details as usual. This can be controlled with the new
`--hideParameterTypesInTitle` option.
- Conditional types will now render their branches on the next line for easier comprehension.
##### Bug Fixes
- Fixed `&` showing as `&` and HTML text showing up in page contents navigation, [#2224](https://togithub.com/TypeStrong/TypeDoc/issues/2224).
- Increased padding between sections when one navigation column is displayed, [#2225](https://togithub.com/TypeStrong/TypeDoc/issues/2225).
- Correct padding for navigation elements with a displayed icon, [#2229](https://togithub.com/TypeStrong/TypeDoc/issues/2229).
- Fixed `source-order` sort strategy failing to compare reflections within a file.
- Added `enum-member-source-order` specialization of the `source-order` sort strategy which only compares enum members, [#2237](https://togithub.com/TypeStrong/TypeDoc/issues/2237).
- Updated highlight colors for semantic links to meet WCAG AA contrast requirements, [#2228](https://togithub.com/TypeStrong/TypeDoc/issues/2228).
- Type parameters are now highlighted consistently, [#2230](https://togithub.com/TypeStrong/TypeDoc/issues/2230).
- Fixed semantic coloring in type and function signatures, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227).
- Fixed issue where removing a reflection indirectly containing an object/function type would only partially remove the reflection, [#2231](https://togithub.com/TypeStrong/TypeDoc/issues/2231).
- Fixed "Implementation of X.y" links if a mixture of methods and property-methods are used, [#2233](https://togithub.com/TypeStrong/TypeDoc/issues/2233).
- "Implementation of" text to symbol-properties not contained in the documentation will now use the resolved name instead of a `__@` symbol name, [#2234](https://togithub.com/TypeStrong/TypeDoc/issues/2234).
- Fix expansion of globs if a single entry point is provided, [#2235](https://togithub.com/TypeStrong/TypeDoc/issues/2235).
- Validation will no longer be skipped for sub packages when running with `--entryPointStrategy packages`.
- Fixed broken theme toggle if the page contained a member named "theme".
##### Thanks!
- [@RunDevelopment](https://togithub.com/RunDevelopment)
### [`v0.24.1`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0241-2023-04-09)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.0...v0.24.1)
##### Bug Fixes
- Improve detection for legacy JSDoc `@example` tags, [#2222](https://togithub.com/TypeStrong/TypeDoc/issues/2222).
- The page footer will now appear at the bottom of the page even if the page is short, [#2223](https://togithub.com/TypeStrong/TypeDoc/issues/2223).
### [`v0.24.0`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0240-2023-04-08)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.23.28...v0.24.0)
##### Breaking Changes
- `@link`, `@linkcode` and `@linkplain` tags will now be resolved with TypeScript's link resolution by default. The `useTsLinkResolution` option
can be used to turn this behavior off, but be aware that doing so will mean your links will be resolved differently by editor tooling and TypeDoc.
- TypeDoc will no longer automatically load plugins from `node_modules`. Specify the `--plugin` option to indicate which modules should be loaded.
- The `packages` entry point strategy will now run TypeDoc in each provided package directory and then merge the results together.
The previous `packages` strategy has been preserved under `legacy-packages` and will be removed in 0.25. If the new strategy does not work
for your use case, please open an issue.
- Removed `--logger` option, to disable all logging, set the `logLevel` option to `none`.
- Dropped support for legacy `[[link]]`s, removed deprecated `Reflection.findReflectionByName`.
- Added `@overload` to default ignored tags.
##### API Breaking Changes
- The `label` property on `Reflection` has moved to `Comment`.
- The default value of the `out` option has been changed from `""` to `"./docs"`, [#2195](https://togithub.com/TypeStrong/TypeDoc/issues/2195).
- Renamed `DeclarationReflection#version` to `DeclarationReflection#projectVersion` to match property on `ProjectReflection`.
- Removed unused `Reflection#originalName`.
- Removed `Reflection#kindString`, use `ReflectionKind.singularString(reflection.kind)` or `ReflectionKind.pluralString(reflection.kind)` instead.
- The `named-tuple-member` and `template-literal` type kind have been replaced with `namedTupleMember` and `templateLiteral`, [#2100](https://togithub.com/TypeStrong/TypeDoc/issues/2100).
- Properties related to rendering are no longer stored on `Reflection`, including `url`, `anchor`, `hasOwnDocument`, and `cssClasses`.
- `Application.bootstrap` will no longer load plugins. If you want to load plugins, use `Application.bootstrapWithPlugins` instead, [#1635](https://togithub.com/TypeStrong/TypeDoc/issues/1635).
- The options passed to `Application.bootstrap` will now be applied both before *and* after reading options files, which may cause a change in configuration
if using a custom script to run TypeDoc that includes some options, but other options are set in config files.
- Moved `sources` property previously declared on base `Reflection` class to `DeclarationReflection` and `SignatureReflection`.
- Moved `relevanceBoost` from `ContainerReflection` to `DeclarationReflection` since setting it on the parent class has no effect.
- Removed internal `ReferenceType.getSymbol`, reference types no longer reference the `ts.Symbol` to enable generation from serialized JSON.
- `OptionsReader.priority` has been renamed to `OptionsReader.order` to more accurately reflect how it works.
- `ReferenceType`s which point to type parameters will now always be intentionally broken since they were never linked and should not be warned about when validating exports.
- `ReferenceType`s now longer include an `id` property for their target. They now instead include a `target` property.
- Removed `Renderer.addExternalSymbolResolver`, use `Converter.addExternalSymbolResolver` instead.
- Removed `CallbackLogger`.
- Removed `SerializeEventData` from serialization events.
- A `PageEvent` is now required for `getRenderContext`. If caching the context object, `page` must be updated when `getRenderContext` is called.
- `PageEvent` no longer includes the `template` property. The `Theme.render` method is now expected to take the template to render the page with as its second argument.
- Removed `secondaryNavigation` member on `DefaultThemeRenderContext`.
- Renamed `navigation` to `sidebar` on `DefaultThemeRenderContext` and `navigation.begin`/`navigation.end` hooks to `sidebar.begin`/`sidebar.end`.
##### Features
- Added `--useTsLinkResolution` option (on by default) which tells TypeDoc to use TypeScript's `@link` resolution.
- Added `--jsDocCompatibility` option (on by default) which controls TypeDoc's automatic detection of code blocks in `@example` and `@default` tags.
- Reworked default theme navigation to add support for a page table of contents, [#1478](https://togithub.com/TypeStrong/TypeDoc/issues/1478), [#2189](https://togithub.com/TypeStrong/TypeDoc/issues/2189).
- Added support for `@interface` on type aliases to tell TypeDoc to convert the fully resolved type as an interface, [#1519](https://togithub.com/TypeStrong/TypeDoc/issues/1519)
- Added support for `@namespace` on variable declarations to tell TypeDoc to convert the variable as a namespace, [#2055](https://togithub.com/TypeStrong/TypeDoc/issues/2055).
- Added support for `@prop`/`@property` to specify documentation for a child property of a symbol, intended for use with `@interface`.
- TypeDoc will now produce more informative error messages for options which cannot be set from the cli, [#2022](https://togithub.com/TypeStrong/TypeDoc/issues/2022).
- TypeDoc will now attempt to guess what option you may have meant if given an invalid option name.
- Plugins may now return a `Promise` from their `load` function, [#185](https://togithub.com/TypeStrong/TypeDoc/issues/185).
- TypeDoc now supports plugins written with ESM, [#1635](https://togithub.com/TypeStrong/TypeDoc/issues/1635).
- Added `Renderer.preRenderAsyncJobs` and `Renderer.postRenderAsyncJobs`, which may be used by plugins to perform async processing for rendering, [#185](https://togithub.com/TypeStrong/TypeDoc/issues/185).
Note: Conversion is still intentionally a synchronous process to ensure stability of converted projects between runs.
- TypeDoc options may now be set under the `typedocOptions` key in `package.json`, [#2112](https://togithub.com/TypeStrong/TypeDoc/issues/2112).
- Added `--cacheBust` option to tell TypeDoc to include include the generation time in files, [#2124](https://togithub.com/TypeStrong/TypeDoc/issues/2124).
- Added `--excludeReferences` option to tell TypeDoc to omit re-exports of a symbol already included from the documentation.
- Introduced new render hooks `pageSidebar.begin` and `pageSidebar.end`.
##### Bug Fixes
- TypeDoc will now ignore package.json files not containing a `name` field, [#2190](https://togithub.com/TypeStrong/TypeDoc/issues/2190).
- Fixed `@inheritDoc` on signatures (functions, methods, constructors, getters, setters) being unable to inherit from a non-signature.
- Interfaces/classes created via extending a module will no longer contain variables/functions where the member should have been converted as properties/methods, [#2150](https://togithub.com/TypeStrong/TypeDoc/issues/2150).
- TypeDoc will now ignore a leading `v` in versions, [#2212](https://togithub.com/TypeStrong/TypeDoc/issues/2212).
- Category titles now render with the same format in the page index and heading title, [#2196](https://togithub.com/TypeStrong/TypeDoc/issues/2196).
- Fixed crash when using `typeof` on a reference with type arguments, [#2220](https://togithub.com/TypeStrong/TypeDoc/issues/2220).
- Fixed broken anchor links generated to signatures nested within objects.
##### Thanks!
- [@bodil](https://togithub.com/bodil)
- [@futurGH](https://togithub.com/futurGH)
- [@jm4rtinez](https://togithub.com/jm4rtinez)
- [@muratgozel](https://togithub.com/muratgozel)
#### v0.23.28 (2023-03-19)
##### Features
- Added support for TypeScript 5.0, [#2201](https://togithub.com/TypeStrong/TypeDoc/issues/2201).
- `const` type parameters.
- JSDoc `@overload` tag.
- JSDoc `@satisfies` tag.
#### v0.23.27 (2023-03-16)
##### Features
- Added `--treatValidationWarningsAsErrors` to treat only validation warnings as errors without treating all warnings as errors, [#2199](https://togithub.com/TypeStrong/TypeDoc/issues/2199).
##### Bug Fixes
- Fixed a bug where optional properties were not appropriately marked as optional, [#2200](https://togithub.com/TypeStrong/TypeDoc/issues/2200).
- Fixed shifted navigation pane on devices 1024px wide, [#2191](https://togithub.com/TypeStrong/TypeDoc/issues/2191).
- Add missing `@private` and `@protected` tags to `typedoc/tsdoc.json`, [#2187](https://togithub.com/TypeStrong/TypeDoc/issues/2187).
##### Thanks!
- [@futurGH](https://togithub.com/futurGH)
#### v0.23.26 (2023-02-26)
##### Features
- Added `Application.EVENT_VALIDATE_PROJECT` event for plugins which implement custom validation, [#2183](https://togithub.com/TypeStrong/TypeDoc/issues/2183).
- Plugins may now return an object from external symbol resolvers, [#2066](https://togithub.com/TypeStrong/TypeDoc/issues/2066).
- Expose `Comment.displayPartsToMarkdown` on for themes overwriting the `comment` helper, [#2115](https://togithub.com/TypeStrong/TypeDoc/issues/2115).
##### Bug Fixes
- Fix crash when converting `export default undefined`, [#2175](https://togithub.com/TypeStrong/TypeDoc/issues/2175).
- Fix error in console when clicking on headings in the readme, [#2170](https://togithub.com/TypeStrong/TypeDoc/issues/2170).
- TypeDoc will now ignore parameters of callback parameters when validating that all parameters have documentation, [#2154](https://togithub.com/TypeStrong/TypeDoc/issues/2154).
##### Thanks!
- [@captain-torch](https://togithub.com/captain-torch)
- [@loopingz](https://togithub.com/loopingz)
- [@RebeccaStevens](https://togithub.com/RebeccaStevens)
#### v0.23.25 (2023-02-11)
##### Breaking Changes
- Upgraded Shiki, if your highlight theme was set to `material-`, the value will need to be changed to
`material-theme-`, see the [Shiki release notes](https://togithub.com/shikijs/shiki/blob/main/CHANGELOG.md#0130--2023-01-27).
##### Features
- Added new `excludeNotDocumentedKinds` variable to control which reflection types can be removed
by the `excludeNotDocumented` option, [#2162](https://togithub.com/TypeStrong/TypeDoc/issues/2162).
- Added `typedoc.jsonc`, `typedoc.config.js`, `typedoc.config.cjs`, `typedoc.cjs` to the list of files
which TypeDoc will automatically use as configuration files.
##### Bug Fixes
- Entry points under `node_modules` will no longer be ignored, [#2151](https://togithub.com/TypeStrong/TypeDoc/issues/2151).
- Corrected behavior of `excludeNotDocumented` on arrow function-variables, [#2156](https://togithub.com/TypeStrong/TypeDoc/issues/2156).
- Added `package.json` to exports declaration.
##### Thanks!
- [@boneskull](https://togithub.com/boneskull)
- [@Mikkal24](https://togithub.com/Mikkal24)
- [@zamiell](https://togithub.com/zamiell)
#### v0.23.24 (2023-01-07)
##### Bug Fixes
- Fixed an issue where signature comments were preferred over property comments for indirectly created function-properties, [#2135](https://togithub.com/TypeStrong/TypeDoc/issues/2135).
- Fixed symlink handling when expanding entry points, [#2130](https://togithub.com/TypeStrong/TypeDoc/issues/2130).
##### Thanks!
- [@boneskull](https://togithub.com/boneskull)
#### v0.23.23 (2022-12-18)
##### Features
- Added `ts.Signature` to emitted `EVENT_CREATE_SIGNATURE` event, [#2002](https://togithub.com/TypeStrong/TypeDoc/issues/2002).
##### Bug Fixes
- Links to members hidden by filter settings now temporarily override the filter, [#2092](https://togithub.com/TypeStrong/TypeDoc/issues/2092).
- If `src/` and `src/x` are specified as entry points, `src/` will no longer be ignored, [#2121](https://togithub.com/TypeStrong/TypeDoc/issues/2121).
#### v0.23.22 (2022-12-11)
##### Features
- Add support for defining the kind sort order, [#2109](https://togithub.com/TypeStrong/TypeDoc/issues/2109).
##### Bug Fixes
- Normalize all file paths on Windows, [#2113](https://togithub.com/TypeStrong/TypeDoc/issues/2113).
- Fix `@link` tags within lists, [#2103](https://togithub.com/TypeStrong/TypeDoc/issues/2103).
#### v0.23.21 (2022-11-14)
##### Features
- Added support for a catch-all wildcard in `externalSymbolLinkMappings`, [#2102](https://togithub.com/TypeStrong/TypeDoc/issues/2102).
- Added support for TypeScript 4.9.
##### Thanks!
- [@mistic100](https://togithub.com/mistic100)
#### v0.23.20 (2022-11-03)
##### Bug Fixes
- Fixed comment discovery for `@inheritDoc` if inheriting from a function type alias, [#2087](https://togithub.com/TypeStrong/TypeDoc/issues/2087).
#### v0.23.19 (2022-10-28)
##### Bug Fixes
- Fixed title link if `titleLink` option was not specified, [#2085](https://togithub.com/TypeStrong/TypeDoc/issues/2085).
##### Thanks!
- [@krisztianb](https://togithub.com/krisztianb)
#### v0.23.18 (2022-10-23)
##### Features
- Improved error reporting when failing to find entry points, [#2080](https://togithub.com/TypeStrong/TypeDoc/issues/2080), [#2082](https://togithub.com/TypeStrong/TypeDoc/issues/2082).
##### Bug Fixes
- Constructor parameter-properties will now use the `@param` comment for the parameter if available, [#1261](https://togithub.com/TypeStrong/TypeDoc/issues/1261).
- Fixed display of object types containing methods, [#1788](https://togithub.com/TypeStrong/TypeDoc/issues/1788).
- Fixed conversion of intrinsic string mapping types when converting without a type node, [#2079](https://togithub.com/TypeStrong/TypeDoc/issues/2079).
#### v0.23.17 (2022-10-18)
##### Features
- Added `titleLink`, `navigationLinks` and `sidebarLinks` options to add additional links to the rendered output, [#1830](https://togithub.com/TypeStrong/TypeDoc/issues/1830).
- Added `sourceLinkTemplate` option to allow more flexible specification of remote urls.
Deprecated now redundant `gitRevision` detection starting with `https?://` introduced in v0.23.16, [#2068](https://togithub.com/TypeStrong/TypeDoc/issues/2068).
##### Thanks!
- [@futurGH](https://togithub.com/futurGH)
#### v0.23.16 (2022-10-10)
##### Features
- Object types will now be pretty printed, [#1793](https://togithub.com/TypeStrong/TypeDoc/issues/1793).
- Added support for specifying the tsconfig.json file in packages mode with `{ "typedoc": { "tsconfig": "tsconfig.lib.json" }}` in package.json, [#2061](https://togithub.com/TypeStrong/TypeDoc/issues/2061).
- In packages mode, readme files will now be automatically included if present, [#2065](https://togithub.com/TypeStrong/TypeDoc/issues/2065).
- Added support for specifying the base file url for links to source code, [#2068](https://togithub.com/TypeStrong/TypeDoc/issues/2068).
##### Bug Fixes
- Private parameter properties will no longer be ignored, [#2064](https://togithub.com/TypeStrong/TypeDoc/issues/2064).
##### Thanks!
- [@captainTorch](https://togithub.com/captainTorch)
#### v0.23.15 (2022-09-18)
##### Features
- TypeDoc will now treat `@typedef {import("foo").Bar} Baz` type declarations which forward type parameters to the imported
symbol as re-exports of that symbol, [#2044](https://togithub.com/TypeStrong/TypeDoc/issues/2044).
##### Bug Fixes
- TypeDoc will now prefer comments on variable declarations over signature comments, [#2042](https://togithub.com/TypeStrong/TypeDoc/issues/2042).
- Fixed double rendering of "Type Parameters" header, [#2054](https://togithub.com/TypeStrong/TypeDoc/issues/2054).
- Fixed double rendering of "Hierarchy" header, [#2053](https://togithub.com/TypeStrong/TypeDoc/issues/2053).
- Removed unused `widgets.png` and `widgets@2x.png` files from generated assets folder.
#### v0.23.14 (2022-09-03)
##### Features
- Added support for defining one-off external link mappings with `externalSymbolLinkMappings` see
[the documentation](https://typedoc.org/options/comments/#externalsymbollinkmappings) for usage examples and caveats, [#2030](https://togithub.com/TypeStrong/TypeDoc/issues/2030).
- External link resolvers defined with `addUnknownSymbolResolver` will now be checked when resolving `@link` tags, [#2030](https://togithub.com/TypeStrong/TypeDoc/issues/2030).
Note: To support this, resolution will now happen during conversion, and as such, `Renderer.addUnknownSymbolResolver` has been
soft deprecated in favor of `Converter.addUnknownSymbolResolver`. Plugins should update to use the method on `Converter`.
`DefaultThemeRenderContext.attemptExternalResolution` has also been deprecated since it will repeat work done during conversion,
use `ReferenceType.externalUrl` instead.
- Added `Converter.addUnknownSymbolResolver` for use by plugins supporting external links.
##### Bug Fixes
- Fixed conversion of object literal types containing construct signatures, [#2036](https://togithub.com/TypeStrong/TypeDoc/issues/2036).
- Fixed centering of title bar on wide displays, actually this time, [#2046](https://togithub.com/TypeStrong/TypeDoc/issues/2046).
#### v0.23.13 (2022-09-01)
##### Bug Fixes
- Fixed packages mode bug introduced in 0.23.12, [#2043](https://togithub.com/TypeStrong/TypeDoc/issues/2043).
#### v0.23.12 (2022-08-31)
##### Features
- Added a new `ParameterType.Object` for declaring object options which will be shallowly merged when read from user configuration.
- Added a new `Application.EVENT_BOOTSTRAP_END` event emitted when `Application.bootstrap` is called.
##### Bug Fixes
- TypeDoc will now work properly in packages mode when converting packages outside the current working directory, [#2043](https://togithub.com/TypeStrong/TypeDoc/issues/2043).
- Fixed deprecation warning for `isIdentifierOrPrivateIdentifier`.
- Fixed centering of title bar on wide displays, [#2046](https://togithub.com/TypeStrong/TypeDoc/issues/2046).
##### Thanks!
- [@citkane](https://togithub.com/citkane)
#### v0.23.11 (2022-08-26)
##### Features
- Added support for TypeScript 4.8.
- Introduced a `skipErrorChecking` option which instructs TypeDoc to not ask TypeScript for compiler errors
before attempting to generate documentation. Turning this on may improve generation speed, but could also
cause a crash if your code contains compiler errors.
- Added support for JS entry points when using packages mode, [#2037](https://togithub.com/TypeStrong/TypeDoc/issues/2037).
##### Bug Fixes
- Fixed crash when converting abstract mixin class, [#2011](https://togithub.com/TypeStrong/TypeDoc/issues/2011).
- Readme files within monorepos now have `@link` tags resolved, [#2029](https://togithub.com/TypeStrong/TypeDoc/issues/2029).
- Correctly resolve unqualified links to class members within parameters, [#2031](https://togithub.com/TypeStrong/TypeDoc/issues/2031).
- TypeDoc will now consider other reflections with the same name as parents when resolving links, [#2033](https://togithub.com/TypeStrong/TypeDoc/issues/2033).
- The "Hierarchy" and "Type Parameters" helpers on `DefaultThemeRenderContext` now contain all the HTML for their sections of the page, [#2038](https://togithub.com/TypeStrong/TypeDoc/issues/2038).
##### Thanks!
- [@citkane](https://togithub.com/citkane)
- [@kaphula](https://togithub.com/kaphula)
#### v0.23.10 (2022-07-31)
##### Features
- Added support for detecting comments directly before parameters as the parameter comment, [#2019](https://togithub.com/TypeStrong/TypeDoc/issues/2019).
- Added support for using the comment directly before a constructor parameter that declares a property as the property comment, [#2019](https://togithub.com/TypeStrong/TypeDoc/issues/2019).
- Improved schema generation to give better autocomplete for the `sort` option.
- Optional properties are now visually distinguished in the index/sidebar by rendering `prop` as `prop?`, [#2023](https://togithub.com/TypeStrong/TypeDoc/issues/2023).
- `DefaultThemeRenderContext.markdown` now also accepts a `CommentDisplayPart[]` for rendering, [#2004](https://togithub.com/TypeStrong/TypeDoc/issues/2004).
- Expose `Converter.resolveLinks` method for use with `Converter.parseRawComment`, [#2004](https://togithub.com/TypeStrong/TypeDoc/issues/2004).
##### Bug Fixes
- Fixed schema URL for TSDoc preventing the use of `typedoc/tsdoc.json` in TSDoc extends, [#2015](https://togithub.com/TypeStrong/TypeDoc/issues/2015).
- Improved detection of package names in repositories using pnpm, [#2017](https://togithub.com/TypeStrong/TypeDoc/issues/2017).
- Fixed missing JSDoc style `@typedef` comments for properties, [#2020](https://togithub.com/TypeStrong/TypeDoc/issues/2020).
##### Thanks!
- [@bodil](https://togithub.com/bodil)
- [@nazarhussain](https://togithub.com/nazarhussain)
#### v0.23.9 (2022-07-24)
##### Bug Fixes
- TypeDoc will no longer skip entry points which have no exports, [#2007](https://togithub.com/TypeStrong/TypeDoc/issues/2007).
If using `"entryPointStrategy": "expand"`, this change may result in new pages being added to your documentation.
If this is not desired, you can use the `exclude` option to filter them out.
- Fixed missing comments on callable variable-functions constructed indirectly, [#2008](https://togithub.com/TypeStrong/TypeDoc/issues/2008).
- Packages mode will now respect the `--includeVersion` flag, [#2010](https://togithub.com/TypeStrong/TypeDoc/issues/2010).
- Fixed multiple reflections mapping to the same file name on case insensitive file systems, [#2012](https://togithub.com/TypeStrong/TypeDoc/issues/2012).
#### v0.23.8 (2022-07-17)
##### Features
- Added defined in links for classes, enums, [#180](https://togithub.com/TypeStrong/TypeDoc/issues/180).
- Added support for `*.ghe.com` and `*.github.us` GitHub enterprise domains for source links, [#2001](https://togithub.com/TypeStrong/TypeDoc/issues/2001).
- Expose `Converter.parseRawComment` for plugins to parse additional markdown files, [#2004](https://togithub.com/TypeStrong/TypeDoc/issues/2004).
##### Bug Fixes
- TypeDoc will no longer emit a warning for `{@link}` containing a URL, [#1980](https://togithub.com/TypeStrong/TypeDoc/issues/1980).
- `excludeNotDocumented` will no longer remove functions/methods/accessors which are documented, [#1994](https://togithub.com/TypeStrong/TypeDoc/issues/1994).
- Fixed missing `sources` property on signature reflections [#1996](https://togithub.com/TypeStrong/TypeDoc/issues/1996).
##### Thanks!
- [@cary-hu](https://togithub.com/cary-hu)
- [@chadhietala](https://togithub.com/chadhietala)
#### v0.23.7 (2022-07-09)
##### Bug Fixes
- Tags must now contain whitespace after the tag name to be parsed as a tag, `@jest/globals` in a comment will no longer be parsed as a tag [#1990](https://togithub.com/TypeStrong/TypeDoc/issues/1990).
- The private member visibility option will now be respected in generated sites, [#1992](https://togithub.com/TypeStrong/TypeDoc/issues/1992).
- Overload rendering will no longer be broken if JavaScript is disabled, [#453](https://togithub.com/TypeStrong/TypeDoc/issues/453).
- All overloads are now shown at once rather than requiring clicks to see the documentation for each signature, [#1100](https://togithub.com/TypeStrong/TypeDoc/issues/1100).
#### v0.23.6 (2022-07-08)
##### Features
- Improved support for `--entryPointStrategy Packages`. TypeDoc will now load package-specific configurations from `package.json` `typedoc` field. This configuration allows configuring a custom display name (`typedoc.displayName`) field, entry point (`typedoc.entryPoint` - this is equivalent and will override `typedocMain`), and path to a readme file to be rendered at the top of the package page (`typedoc.readmeFile`), [#1658](https://togithub.com/TypeStrong/TypeDoc/issues/1658).
- The `--includeVersion` option will now be respected by `--entryPointStrategy Packages`. Also, for this combination, missing `version` field in the root `package.json` will not issue a warning.
- The `navigation` partial will now call the new `settings`, `primaryNavigation`, and `secondaryNavigation` partials, [#1987](https://togithub.com/TypeStrong/TypeDoc/issues/1987).
##### Bug Fixes
- All warnings will be reported instead of only the first warning of a given type, [#1981](https://togithub.com/TypeStrong/TypeDoc/issues/1981).
- Include references will no longer be incorrectly parsed as links, [#1986](https://togithub.com/TypeStrong/TypeDoc/issues/1986).
- The generated schema.json on the website will now use enum values rather than enum names if possible.
##### Thanks!
- [@akphi](https://togithub.com/akphi)
- [@zamiell](https://togithub.com/zamiell)
#### v0.23.5 (2022-07-02)
##### Features
- The `DEBUG_SEARCH_WEIGHTS` global variable can now be set on `window` to add search scoring information in the search results.
- TypeDoc's icons are now available on `DefaultThemeRenderContext.icons` for use/modification by themes.
#### v0.23.4 (2022-07-02)
##### Bug Fixes
- TypeDoc no longer ignores project references if `--entryPointStrategy Packages` is set, [#1976](https://togithub.com/TypeStrong/TypeDoc/issues/1976).
- Boost computations are now done when creating the search index, resulting in a smaller `search.js` generated file.
##### Features
- The `--exclude` option will now be respected by `--entryPointStrategy Packages` and can be used to exclude package directories, [#1959](https://togithub.com/TypeStrong/TypeDoc/issues/1959).
- TypeDoc now emits an `IndexEvent` on the `Renderer` when preparing the search index, [#1953](https://togithub.com/TypeStrong/TypeDoc/issues/1953).
- Added new `--searchInComments` option to include comment text in the search index, [#1553](https://togithub.com/TypeStrong/TypeDoc/issues/1553).
Turning this option on will increase the size of your search index, potentially by an order of magnitude.
#### v0.23.3 (2022-07-01)
##### Bug Fixes
- Function properties in type space will no longer be interpreted as methods, [#1637](https://togithub.com/TypeStrong/TypeDoc/issues/1637).
- TypeDoc will no longer crash if a comment contains an empty `@example` tag, [#1967](https://togithub.com/TypeStrong/TypeDoc/issues/1967).
- TypeDoc will now detect attempted inheritance from accessors and inherit from the getter or setter, [#1968](https://togithub.com/TypeStrong/TypeDoc/issues/1968).
- `intentionallyNotExported` will now properly respect qualified names, [#1972](https://togithub.com/TypeStrong/TypeDoc/issues/1972).
- Fixed missing namespace comments on `export * as NS` declarations, [#1973](https://togithub.com/TypeStrong/TypeDoc/issues/1973).
- Fixed missing comments on `export const x = () => 123` function variables, [#1973](https://togithub.com/TypeStrong/TypeDoc/issues/1973).
- Exported variable functions with properties will now be converted as a function+namespace instead of a variable+namespace, [#1651](https://togithub.com/TypeStrong/TypeDoc/issues/1651).
- Validation warnings caused by missing documentation will now be formatted like other warnings which reference a declaration.
- TypeDoc will no longer warn if both the `get` and `set` signatures of an accessor have a comment.
##### Features
- Added `--htmlLang` option to set the [`lang`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang) attribute in the generated HTML. Defaults to `en`, [#1951](https://togithub.com/TypeStrong/TypeDoc/issues/1951).
- Added `--basePath` option to override TypeDoc's detected root directory, [#1924](https://togithub.com/TypeStrong/TypeDoc/issues/1924).
- Added support for TypeDoc specific `:getter` and `:setter` meaning keywords in declaration references.
- Warnings caused by comment contents will now do a better job of including the location of the text that caused the warning.
#### v0.23.2 (2022-06-28)
##### Bug Fixes
- Module comments will no longer be inappropriately attached to signatures, [#1962](https://togithub.com/TypeStrong/TypeDoc/issues/1962).
- Projects with a single entry point will now parse `@module` comments in the entry point, [#1963](https://togithub.com/TypeStrong/TypeDoc/issues/1963).
- Removed duplicate "in comment" warning when parsing comments, [#1964](https://togithub.com/TypeStrong/TypeDoc/issues/1964).
- Reflections with a boost of `<= 0` due to `searchCategoryBoosts` or `searchGroupBoosts` will be excluded from search.
#### v0.23.1 (2022-06-26)
##### Bug Fixes
- If a declaration has multiple comments associated with it, the last one should be used, [#1961](https://togithub.com/TypeStrong/TypeDoc/issues/1961).
### [`v0.23.28`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v02328-2023-03-19)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.23.27...v0.23.28)
##### Features
- Added support for TypeScript 5.0, [#2201](https://togithub.com/TypeStrong/TypeDoc/issues/2201).
- `const` type parameters.
- JSDoc `@overload` tag.
- JSDoc `@satisfies` tag.
### [`v0.23.27`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v02327-2023-03-16)
[Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.23.26...v0.23.27)
##### Features
- Added `--treatValidationWarningsAsErrors` to treat only validation warnings as errors without treating all warnings as errors, [#2199](https://togithub.com/TypeStrong/TypeDoc/issues/2199).
##### Bug Fixes
- Fixed a bug where optional properties were not appropriately marked as optional, [#2200](https://togithub.com/TypeStrong/TypeDoc/issues/2200).
- Fixed shifted navigation pane on devices 1024px wide, [#2191](https://togithub.com/TypeStrong/TypeDoc/issues/2191).
- Add missing `@private` and `@protected` tags to `typedoc/tsdoc.json`, [#2187](https://togithub.com/TypeStrong/TypeDoc/issues/2187).
##### Thanks!
- [@futurGH](https://togithub.com/futurGH)
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
0.23.26
->0.25.1
Release Notes
TypeStrong/TypeDoc (typedoc)
### [`v0.25.1`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0251-2023-09-04) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.25.0...v0.25.1) ##### Features - Added `stripYamlFrontmatter` config option to remove YAML frontmatter from README.md, [#2381](https://togithub.com/TypeStrong/TypeDoc/issues/2381). - Added `--excludeCategories` config option to remove reflections present in any excluded category, [#1407](https://togithub.com/TypeStrong/TypeDoc/issues/1407). - If no tsconfig.json file is present, TypeDoc will now attempt to compile without setting any compiler options, [#2304](https://togithub.com/TypeStrong/TypeDoc/issues/2304). - Navigation is now written to a JS file and built dynamically, which significantly decreases document generation time with large projects and also provides large space benefits. Themes may now override `DefaultTheme.buildNavigation` to customize the displayed navigation tree, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). Note: This change renders `navigation.fullTree` obsolete. If you set it, TypeDoc will warn that it is being ignored. It will be removed in v0.26. - The search index is now compressed before writing, which reduces most search index sizes by ~5-10x. - TypeDoc will now attempt to cache icons when `DefaultThemeRenderContext.icons` is overwritten by a custom theme. Note: To perform this optimization, TypeDoc relies on `DefaultThemeRenderContext.iconCache` being rendered within each page. TypeDoc does it in the `defaultLayout` template. - Cache URL derivation during generation, [#2386](https://togithub.com/TypeStrong/TypeDoc/issues/2386). ##### Bug Fixes - `@property` now works as expected if used to override a method's documentation. - Deprecated functions/methods are now correctly rendered with a struck-out name. - `--watch` mode works again, [#2378](https://togithub.com/TypeStrong/TypeDoc/issues/2378). - Improved support for optional names within JSDoc types, [#2384](https://togithub.com/TypeStrong/TypeDoc/issues/2384). - Fixed duplicate rendering of reflection flags on signature parameters, [#2385](https://togithub.com/TypeStrong/TypeDoc/issues/2385). - TypeDoc now handles the `intrinsic` keyword if TS intrinsic types are included in documentation. - `--exclude` is now respected when expanding globs in entry points, [#2376](https://togithub.com/TypeStrong/TypeDoc/issues/2376). ##### Thanks! - [@ajesshope](https://togithub.com/ajesshope) - [@HemalPatil](https://togithub.com/HemalPatil) - [@hrueger](https://togithub.com/hrueger) - [@typhonrt](https://togithub.com/typhonrt) ### [`v0.25.0`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0250-2023-08-25) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.8...v0.25.0) ##### Breaking Changes - Bump minimum Node version to 16. - Removed `legacy-packages` option for `--entryPointStrategy`. - Changed default value of `--categorizeByGroup` to `false`. - Specifying a link as the `gitRemote` is no longer supported. - An `Application` instance must now be retrieved via `Application.bootstrap` or `Application.bootstrapWithPlugins`, [#2268](https://togithub.com/TypeStrong/TypeDoc/issues/2268). - Removed `ReflectionKind.ObjectLiteral` that was never used by TypeDoc. - Removed deprecated members `DefaultThemeRenderContext.comment` and `DefaultThemeRenderContext.attemptExternalResolution`. ##### Features - Added support for TypeScript 5.2, [#2373](https://togithub.com/TypeStrong/TypeDoc/issues/2373). - TypeDoc config files now support options default-exported from an ESM config file, [#2268](https://togithub.com/TypeStrong/TypeDoc/issues/2268). - TypeDoc config files may now export a promise containing configuration, [#2268](https://togithub.com/TypeStrong/TypeDoc/issues/2268). - Added `--preserveLinkText` option (defaults to true) which determines whether the reflection name or full link text is included in the output when no override is specified, [#2355](https://togithub.com/TypeStrong/TypeDoc/issues/2355). - Added a no-results placeholder when no search results are available, [#2347](https://togithub.com/TypeStrong/TypeDoc/issues/2347). - Implemented several miscellaneous performance improvements to generate docs faster, this took the time to generate TypeDoc's site from ~5.6 seconds to ~5.4 seconds. - Added `--disableGit` option to prevent TypeDoc from using Git to try to determine if sources can be linked, [#2326](https://togithub.com/TypeStrong/TypeDoc/issues/2326). - Added support for tags `@showGroups`, `@hideGroups`, `@showCategories`, `@hideCategories` to configure the navigation pane on a per-reflection basis, [#2329](https://togithub.com/TypeStrong/TypeDoc/issues/2329). - With `--jsDocCompatibility.defaultTags` set, `@defaultValue` is now implicitly a code block if the text contains no code, [#2370](https://togithub.com/TypeStrong/TypeDoc/issues/2370). ##### Bug Fixes - Fixed link discovery if nested (`Foo#bar`) links were used and `--useTsLinkResolution` is enabled in some cases, [#2360](https://togithub.com/TypeStrong/TypeDoc/issues/2360). - Links with invalid declaration references will no longer silently link to the wrong page in some cases, [#2360](https://togithub.com/TypeStrong/TypeDoc/issues/2360). - Fixed duplicate definitions in type hierarchy when using packages mode, [#2327](https://togithub.com/TypeStrong/TypeDoc/issues/2327). - `@inheritDoc` was not properly resolved across packages in packages mode, [#2331](https://togithub.com/TypeStrong/TypeDoc/issues/2331). - Added warning for attempted `@interface` use on union types, [#2352](https://togithub.com/TypeStrong/TypeDoc/issues/2352). - Fixed misleading type annotation on `Theme.getUrls`, [#2318](https://togithub.com/TypeStrong/TypeDoc/issues/2318). - Fixed duplicate namespace in documentation if `@namespace` is used on a variable with an associated namespace, [#2364](https://togithub.com/TypeStrong/TypeDoc/issues/2364). - Fixed `@namespace` property discovery if merged with a type and the type was declared first [#2364](https://togithub.com/TypeStrong/TypeDoc/issues/2364). - Tables in markdown are now styled, [#2366](https://togithub.com/TypeStrong/TypeDoc/issues/2366). - Sidebar links no longer open in a new tab, [#2353](https://togithub.com/TypeStrong/TypeDoc/issues/2353). - Headers now include some padding before rendering text, [#2316](https://togithub.com/TypeStrong/TypeDoc/issues/2316). - Symbol locations for signatures on `reflection.sources` now considers the node's name like non-signature location discovery does. ##### Thanks! - [@camc314](https://togithub.com/camc314) - [@cprussin](https://togithub.com/cprussin) - [@roggervalf](https://togithub.com/roggervalf) - [@Th3S4mur41](https://togithub.com/Th3S4mur41) #### v0.24.8 (2023-06-04) ##### Features - Added support for TypeScript 5.1, [#2296](https://togithub.com/TypeStrong/TypeDoc/issues/2296). - Added `navigation.fullTree` to control rendering the full navigation tree on each page, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). This option will likely be replaced in 0.25 with dynamic loading of the full tree. - TypeDoc's `--pretty` option now also controls whether generated HTML contains line breaks, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). - Optimized icon caching to reduce file size in generated HTML documentation, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). - Render property description of "roughly top level" object types, [#2276](https://togithub.com/TypeStrong/TypeDoc/issues/2276). - Added `MarkdownEvent.INCLUDE` for plugins, [#2284](https://togithub.com/TypeStrong/TypeDoc/issues/2284). ##### Bug Fixes - When rendering functions/methods, TypeDoc will now render the comment summary above the parameters/return type, and any other block tags in the order they are defined in the comment, [#2285](https://togithub.com/TypeStrong/TypeDoc/issues/2285). - Comments are no longer removed from classes/interfaces containing call signatures, [#2290](https://togithub.com/TypeStrong/TypeDoc/issues/2290). ##### Thanks! - [@krisztianb](https://togithub.com/krisztianb) - [@WikiRik](https://togithub.com/WikiRik) #### v0.24.7 (2023-05-08) ##### Features - TypeDoc will now allow conversion without any entry points to support "readme only" packages, [#2264](https://togithub.com/TypeStrong/TypeDoc/issues/2264). ##### Bug Fixes - Category children are now sorted according to the `sort` option, [#2272](https://togithub.com/TypeStrong/TypeDoc/issues/2272). - Inline tags no longer require a space after the tag name to be parsed as a tag, [#2273](https://togithub.com/TypeStrong/TypeDoc/issues/2273). - Fixed module/namespace links in navigation when viewed in Safari, [#2275](https://togithub.com/TypeStrong/TypeDoc/issues/2275). #### v0.24.6 (2023-04-24) ##### Features - Improved error messaging if a provided entry point could not be converted into a documented module reflection, [#2242](https://togithub.com/TypeStrong/TypeDoc/issues/2242). - API: Added support for `g`, `circle`, `ellipse`, `polygon`, and `polyline` svg elements, [#2259](https://togithub.com/TypeStrong/TypeDoc/issues/2259). - Extended `jsDocCompatibility` option with `inheritDocTag` to ignore fully lowercase `inheritDoc` tags and `ignoreUnescapedBraces` to disable warnings about unescaped `{` and `}` characters in comments. ##### Bug Fixes - `--useTsLinkResolution` is no longer ignored within block tags, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260). - The current namespace will also be expanded in the navigation on page load, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260). - Fixed flicker of navigation pane when reloading a page caused by updating expansion state after the page was loaded. - Fixed an infinite loop if more than one entry point was provided, and all entry points were the same. ##### Thanks! - [@FlippieCoetser](https://togithub.com/FlippieCoetser) #### v0.24.5 (2023-04-22) ##### Features - Categories and groups can now be shown in the navigation, added `--navigation.includeCategories` and `--navigation.includeGroups` to control this behavior. The `--categorizeByGroup` option also effects this behavior. If `categorizeByGroup` is set (the default) and `navigation.includeGroups` is *not* set, the value of `navigation.includeCategories` will be effectively ignored since categories will be created only within groups, [#1532](https://togithub.com/TypeStrong/TypeDoc/issues/1532). - Added support for discovering a "module" comment on global files, [#2165](https://togithub.com/TypeStrong/TypeDoc/issues/2165). - Added copy code to clipboard button, [#2153](https://togithub.com/TypeStrong/TypeDoc/issues/2153). - Function `@returns` blocks will now be rendered with the return type, [#2180](https://togithub.com/TypeStrong/TypeDoc/issues/2180). - Added `--groupOrder` option to specify the sort order of groups, [#2251](https://togithub.com/TypeStrong/TypeDoc/issues/2251). ##### Bug Fixes - Type parameter constraints now respect the `--hideParameterTypesInTitle` option, [#2226](https://togithub.com/TypeStrong/TypeDoc/issues/2226). - Even more contrast fixes, [#2248](https://togithub.com/TypeStrong/TypeDoc/issues/2248). - Fix semantic highlighting for predicate type's parameter references, [#2249](https://togithub.com/TypeStrong/TypeDoc/issues/2249). - Fixed broken links to heading titles. - Fixed inconsistent styling between type parameter lists and parameter lists. - TypeDoc will now warn if more than one `@returns` block is is present in a function, and ignore the duplicate blocks as specified by TSDoc. ##### Thanks! - [@FlippieCoetser](https://togithub.com/FlippieCoetser) #### v0.24.4 (2023-04-16) ##### Bug Fixes - Fixed broken semantic coloring, [#2247](https://togithub.com/TypeStrong/TypeDoc/issues/2247). - Increased contrast for parameter titles in dark mode to meet WCAG AA contrast requirements, [#2244](https://togithub.com/TypeStrong/TypeDoc/issues/2244). - Underline color of index links now matches the text color, [#2245](https://togithub.com/TypeStrong/TypeDoc/issues/2245). - Increased contract for active menu item text in dark mode. #### v0.24.3 (2023-04-16) ##### Bug Fixes - Fixed path expansion on Windows preventing generation, [#2243](https://togithub.com/TypeStrong/TypeDoc/issues/2243) and [#2241](https://togithub.com/TypeStrong/TypeDoc/issues/2241). #### v0.24.2 (2023-04-15) ##### Features - Added semantic link coloring for reflection names & links, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227). Note: This resulted in function signatures becoming too busy for easy scanning with even slightly complicated signatures as such, TypeDoc now only renders parameter names in the signature title and includes the type in the parameter details as usual. This can be controlled with the new `--hideParameterTypesInTitle` option. - Conditional types will now render their branches on the next line for easier comprehension. ##### Bug Fixes - Fixed `&` showing as `&` and HTML text showing up in page contents navigation, [#2224](https://togithub.com/TypeStrong/TypeDoc/issues/2224). - Increased padding between sections when one navigation column is displayed, [#2225](https://togithub.com/TypeStrong/TypeDoc/issues/2225). - Correct padding for navigation elements with a displayed icon, [#2229](https://togithub.com/TypeStrong/TypeDoc/issues/2229). - Fixed `source-order` sort strategy failing to compare reflections within a file. - Added `enum-member-source-order` specialization of the `source-order` sort strategy which only compares enum members, [#2237](https://togithub.com/TypeStrong/TypeDoc/issues/2237). - Updated highlight colors for semantic links to meet WCAG AA contrast requirements, [#2228](https://togithub.com/TypeStrong/TypeDoc/issues/2228). - Type parameters are now highlighted consistently, [#2230](https://togithub.com/TypeStrong/TypeDoc/issues/2230). - Fixed semantic coloring in type and function signatures, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227). - Fixed issue where removing a reflection indirectly containing an object/function type would only partially remove the reflection, [#2231](https://togithub.com/TypeStrong/TypeDoc/issues/2231). - Fixed "Implementation of X.y" links if a mixture of methods and property-methods are used, [#2233](https://togithub.com/TypeStrong/TypeDoc/issues/2233). - "Implementation of" text to symbol-properties not contained in the documentation will now use the resolved name instead of a `__@` symbol name, [#2234](https://togithub.com/TypeStrong/TypeDoc/issues/2234). - Fix expansion of globs if a single entry point is provided, [#2235](https://togithub.com/TypeStrong/TypeDoc/issues/2235). - Validation will no longer be skipped for sub packages when running with `--entryPointStrategy packages`. - Fixed broken theme toggle if the page contained a member named "theme". ##### Thanks! - [@RunDevelopment](https://togithub.com/RunDevelopment) #### v0.24.1 (2023-04-09) ##### Bug Fixes - Improve detection for legacy JSDoc `@example` tags, [#2222](https://togithub.com/TypeStrong/TypeDoc/issues/2222). - The page footer will now appear at the bottom of the page even if the page is short, [#2223](https://togithub.com/TypeStrong/TypeDoc/issues/2223). ### [`v0.24.8`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0248-2023-06-04) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.7...v0.24.8) ##### Features - Added support for TypeScript 5.1, [#2296](https://togithub.com/TypeStrong/TypeDoc/issues/2296). - Added `navigation.fullTree` to control rendering the full navigation tree on each page, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). This option will likely be replaced in 0.25 with dynamic loading of the full tree. - TypeDoc's `--pretty` option now also controls whether generated HTML contains line breaks, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). - Optimized icon caching to reduce file size in generated HTML documentation, [#2287](https://togithub.com/TypeStrong/TypeDoc/issues/2287). - Render property description of "roughly top level" object types, [#2276](https://togithub.com/TypeStrong/TypeDoc/issues/2276). - Added `MarkdownEvent.INCLUDE` for plugins, [#2284](https://togithub.com/TypeStrong/TypeDoc/issues/2284). ##### Bug Fixes - When rendering functions/methods, TypeDoc will now render the comment summary above the parameters/return type, and any other block tags in the order they are defined in the comment, [#2285](https://togithub.com/TypeStrong/TypeDoc/issues/2285). - Comments are no longer removed from classes/interfaces containing call signatures, [#2290](https://togithub.com/TypeStrong/TypeDoc/issues/2290). ##### Thanks! - [@krisztianb](https://togithub.com/krisztianb) - [@WikiRik](https://togithub.com/WikiRik) ### [`v0.24.7`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0247-2023-05-08) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.6...v0.24.7) ##### Features - TypeDoc will now allow conversion without any entry points to support "readme only" packages, [#2264](https://togithub.com/TypeStrong/TypeDoc/issues/2264). ##### Bug Fixes - Category children are now sorted according to the `sort` option, [#2272](https://togithub.com/TypeStrong/TypeDoc/issues/2272). - Inline tags no longer require a space after the tag name to be parsed as a tag, [#2273](https://togithub.com/TypeStrong/TypeDoc/issues/2273). - Fixed module/namespace links in navigation when viewed in Safari, [#2275](https://togithub.com/TypeStrong/TypeDoc/issues/2275). ### [`v0.24.6`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0246-2023-04-24) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.5...v0.24.6) ##### Features - Improved error messaging if a provided entry point could not be converted into a documented module reflection, [#2242](https://togithub.com/TypeStrong/TypeDoc/issues/2242). - API: Added support for `g`, `circle`, `ellipse`, `polygon`, and `polyline` svg elements, [#2259](https://togithub.com/TypeStrong/TypeDoc/issues/2259). - Extended `jsDocCompatibility` option with `inheritDocTag` to ignore fully lowercase `inheritDoc` tags and `ignoreUnescapedBraces` to disable warnings about unescaped `{` and `}` characters in comments. ##### Bug Fixes - `--useTsLinkResolution` is no longer ignored within block tags, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260). - The current namespace will also be expanded in the navigation on page load, [#2260](https://togithub.com/TypeStrong/TypeDoc/issues/2260). - Fixed flicker of navigation pane when reloading a page caused by updating expansion state after the page was loaded. - Fixed an infinite loop if more than one entry point was provided, and all entry points were the same. ##### Thanks! - [@FlippieCoetser](https://togithub.com/FlippieCoetser) ### [`v0.24.5`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0245-2023-04-22) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.4...v0.24.5) ##### Features - Categories and groups can now be shown in the navigation, added `--navigation.includeCategories` and `--navigation.includeGroups` to control this behavior. The `--categorizeByGroup` option also effects this behavior. If `categorizeByGroup` is set (the default) and `navigation.includeGroups` is *not* set, the value of `navigation.includeCategories` will be effectively ignored since categories will be created only within groups, [#1532](https://togithub.com/TypeStrong/TypeDoc/issues/1532). - Added support for discovering a "module" comment on global files, [#2165](https://togithub.com/TypeStrong/TypeDoc/issues/2165). - Added copy code to clipboard button, [#2153](https://togithub.com/TypeStrong/TypeDoc/issues/2153). - Function `@returns` blocks will now be rendered with the return type, [#2180](https://togithub.com/TypeStrong/TypeDoc/issues/2180). - Added `--groupOrder` option to specify the sort order of groups, [#2251](https://togithub.com/TypeStrong/TypeDoc/issues/2251). ##### Bug Fixes - Type parameter constraints now respect the `--hideParameterTypesInTitle` option, [#2226](https://togithub.com/TypeStrong/TypeDoc/issues/2226). - Even more contrast fixes, [#2248](https://togithub.com/TypeStrong/TypeDoc/issues/2248). - Fix semantic highlighting for predicate type's parameter references, [#2249](https://togithub.com/TypeStrong/TypeDoc/issues/2249). - Fixed broken links to heading titles. - Fixed inconsistent styling between type parameter lists and parameter lists. - TypeDoc will now warn if more than one `@returns` block is is present in a function, and ignore the duplicate blocks as specified by TSDoc. ##### Thanks! - [@FlippieCoetser](https://togithub.com/FlippieCoetser) ### [`v0.24.4`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0244-2023-04-16) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.3...v0.24.4) ##### Bug Fixes - Fixed broken semantic coloring, [#2247](https://togithub.com/TypeStrong/TypeDoc/issues/2247). - Increased contrast for parameter titles in dark mode to meet WCAG AA contrast requirements, [#2244](https://togithub.com/TypeStrong/TypeDoc/issues/2244). - Underline color of index links now matches the text color, [#2245](https://togithub.com/TypeStrong/TypeDoc/issues/2245). - Increased contract for active menu item text in dark mode. ### [`v0.24.3`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0243-2023-04-16) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.2...v0.24.3) ##### Bug Fixes - Fixed path expansion on Windows preventing generation, [#2243](https://togithub.com/TypeStrong/TypeDoc/issues/2243) and [#2241](https://togithub.com/TypeStrong/TypeDoc/issues/2241). ### [`v0.24.2`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0242-2023-04-15) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.1...v0.24.2) ##### Features - Added semantic link coloring for reflection names & links, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227). Note: This resulted in function signatures becoming too busy for easy scanning with even slightly complicated signatures as such, TypeDoc now only renders parameter names in the signature title and includes the type in the parameter details as usual. This can be controlled with the new `--hideParameterTypesInTitle` option. - Conditional types will now render their branches on the next line for easier comprehension. ##### Bug Fixes - Fixed `&` showing as `&` and HTML text showing up in page contents navigation, [#2224](https://togithub.com/TypeStrong/TypeDoc/issues/2224). - Increased padding between sections when one navigation column is displayed, [#2225](https://togithub.com/TypeStrong/TypeDoc/issues/2225). - Correct padding for navigation elements with a displayed icon, [#2229](https://togithub.com/TypeStrong/TypeDoc/issues/2229). - Fixed `source-order` sort strategy failing to compare reflections within a file. - Added `enum-member-source-order` specialization of the `source-order` sort strategy which only compares enum members, [#2237](https://togithub.com/TypeStrong/TypeDoc/issues/2237). - Updated highlight colors for semantic links to meet WCAG AA contrast requirements, [#2228](https://togithub.com/TypeStrong/TypeDoc/issues/2228). - Type parameters are now highlighted consistently, [#2230](https://togithub.com/TypeStrong/TypeDoc/issues/2230). - Fixed semantic coloring in type and function signatures, [#2227](https://togithub.com/TypeStrong/TypeDoc/issues/2227). - Fixed issue where removing a reflection indirectly containing an object/function type would only partially remove the reflection, [#2231](https://togithub.com/TypeStrong/TypeDoc/issues/2231). - Fixed "Implementation of X.y" links if a mixture of methods and property-methods are used, [#2233](https://togithub.com/TypeStrong/TypeDoc/issues/2233). - "Implementation of" text to symbol-properties not contained in the documentation will now use the resolved name instead of a `__@` symbol name, [#2234](https://togithub.com/TypeStrong/TypeDoc/issues/2234). - Fix expansion of globs if a single entry point is provided, [#2235](https://togithub.com/TypeStrong/TypeDoc/issues/2235). - Validation will no longer be skipped for sub packages when running with `--entryPointStrategy packages`. - Fixed broken theme toggle if the page contained a member named "theme". ##### Thanks! - [@RunDevelopment](https://togithub.com/RunDevelopment) ### [`v0.24.1`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0241-2023-04-09) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.24.0...v0.24.1) ##### Bug Fixes - Improve detection for legacy JSDoc `@example` tags, [#2222](https://togithub.com/TypeStrong/TypeDoc/issues/2222). - The page footer will now appear at the bottom of the page even if the page is short, [#2223](https://togithub.com/TypeStrong/TypeDoc/issues/2223). ### [`v0.24.0`](https://togithub.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0240-2023-04-08) [Compare Source](https://togithub.com/TypeStrong/TypeDoc/compare/v0.23.28...v0.24.0) ##### Breaking Changes - `@link`, `@linkcode` and `@linkplain` tags will now be resolved with TypeScript's link resolution by default. The `useTsLinkResolution` option can be used to turn this behavior off, but be aware that doing so will mean your links will be resolved differently by editor tooling and TypeDoc. - TypeDoc will no longer automatically load plugins from `node_modules`. Specify the `--plugin` option to indicate which modules should be loaded. - The `packages` entry point strategy will now run TypeDoc in each provided package directory and then merge the results together. The previous `packages` strategy has been preserved under `legacy-packages` and will be removed in 0.25. If the new strategy does not work for your use case, please open an issue. - Removed `--logger` option, to disable all logging, set the `logLevel` option to `none`. - Dropped support for legacy `[[link]]`s, removed deprecated `Reflection.findReflectionByName`. - Added `@overload` to default ignored tags. ##### API Breaking Changes - The `label` property on `Reflection` has moved to `Comment`. - The default value of the `out` option has been changed from `""` to `"./docs"`, [#2195](https://togithub.com/TypeStrong/TypeDoc/issues/2195). - Renamed `DeclarationReflection#version` to `DeclarationReflection#projectVersion` to match property on `ProjectReflection`. - Removed unused `Reflection#originalName`. - Removed `Reflection#kindString`, use `ReflectionKind.singularString(reflection.kind)` or `ReflectionKind.pluralString(reflection.kind)` instead. - The `named-tuple-member` and `template-literal` type kind have been replaced with `namedTupleMember` and `templateLiteral`, [#2100](https://togithub.com/TypeStrong/TypeDoc/issues/2100). - Properties related to rendering are no longer stored on `Reflection`, including `url`, `anchor`, `hasOwnDocument`, and `cssClasses`. - `Application.bootstrap` will no longer load plugins. If you want to load plugins, use `Application.bootstrapWithPlugins` instead, [#1635](https://togithub.com/TypeStrong/TypeDoc/issues/1635). - The options passed to `Application.bootstrap` will now be applied both before *and* after reading options files, which may cause a change in configuration if using a custom script to run TypeDoc that includes some options, but other options are set in config files. - Moved `sources` property previously declared on base `Reflection` class to `DeclarationReflection` and `SignatureReflection`. - Moved `relevanceBoost` from `ContainerReflection` to `DeclarationReflection` since setting it on the parent class has no effect. - Removed internal `ReferenceType.getSymbol`, reference types no longer reference the `ts.Symbol` to enable generation from serialized JSON. - `OptionsReader.priority` has been renamed to `OptionsReader.order` to more accurately reflect how it works. - `ReferenceType`s which point to type parameters will now always be intentionally broken since they were never linked and should not be warned about when validating exports. - `ReferenceType`s now longer include an `id` property for their target. They now instead include a `target` property. - Removed `Renderer.addExternalSymbolResolver`, use `Converter.addExternalSymbolResolver` instead. - Removed `CallbackLogger`. - Removed `SerializeEventData` from serialization events. - A `PageEvent` is now required for `getRenderContext`. If caching the context object, `page` must be updated when `getRenderContext` is called. - `PageEvent` no longer includes the `template` property. The `Theme.render` method is now expected to take the template to render the page with as its second argument. - Removed `secondaryNavigation` member on `DefaultThemeRenderContext`. - Renamed `navigation` to `sidebar` on `DefaultThemeRenderContext` and `navigation.begin`/`navigation.end` hooks to `sidebar.begin`/`sidebar.end`. ##### Features - Added `--useTsLinkResolution` option (on by default) which tells TypeDoc to use TypeScript's `@link` resolution. - Added `--jsDocCompatibility` option (on by default) which controls TypeDoc's automatic detection of code blocks in `@example` and `@default` tags. - Reworked default theme navigation to add support for a page table of contents, [#1478](https://togithub.com/TypeStrong/TypeDoc/issues/1478), [#2189](https://togithub.com/TypeStrong/TypeDoc/issues/2189). - Added support for `@interface` on type aliases to tell TypeDoc to convert the fully resolved type as an interface, [#1519](https://togithub.com/TypeStrong/TypeDoc/issues/1519) - Added support for `@namespace` on variable declarations to tell TypeDoc to convert the variable as a namespace, [#2055](https://togithub.com/TypeStrong/TypeDoc/issues/2055). - Added support for `@prop`/`@property` to specify documentation for a child property of a symbol, intended for use with `@interface`. - TypeDoc will now produce more informative error messages for options which cannot be set from the cli, [#2022](https://togithub.com/TypeStrong/TypeDoc/issues/2022). - TypeDoc will now attempt to guess what option you may have meant if given an invalid option name. - Plugins may now return a `PromiseConfiguration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.