Skip to content

Commit bd518ea

Browse files
chore(deps): update dependency typedoc to ^0.24.0 (#4468)
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com) This PR contains the following updates: | Package | Change | Age | Adoption | Passing | Confidence | |---|---|---|---|---|---| | [typedoc](https://typedoc.org) ([source](https://github.com/TypeStrong/TypeDoc)) | [`^0.23.26` -> `^0.24.0`](https://renovatebot.com/diffs/npm/typedoc/0.23.28/0.24.1) | [![age](https://badges.renovateapi.com/packages/npm/typedoc/0.24.1/age-slim)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://badges.renovateapi.com/packages/npm/typedoc/0.24.1/adoption-slim)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://badges.renovateapi.com/packages/npm/typedoc/0.24.1/compatibility-slim/0.23.28)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://badges.renovateapi.com/packages/npm/typedoc/0.24.1/confidence-slim/0.23.28)](https://docs.renovatebot.com/merge-confidence/) | --- ### Release Notes <details> <summary>TypeStrong/TypeDoc</summary> ### [`v0.24.1`](https://github.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0241-2023-04-09) [Compare Source](https://github.com/TypeStrong/TypeDoc/compare/v0.24.0...v0.24.1) ##### Bug Fixes - Improve detection for legacy JSDoc `@example` tags, [#&#8203;2222](https://github.com/TypeStrong/TypeDoc/issues/2222). - The page footer will now appear at the bottom of the page even if the page is short, [#&#8203;2223](https://github.com/TypeStrong/TypeDoc/issues/2223). ### [`v0.24.0`](https://github.com/TypeStrong/TypeDoc/blob/HEAD/CHANGELOG.md#v0240-2023-04-08) [Compare Source](https://github.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"`, [#&#8203;2195](https://github.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`, [#&#8203;2100](https://github.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, [#&#8203;1635](https://github.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, [#&#8203;1478](https://github.com/TypeStrong/TypeDoc/issues/1478), [#&#8203;2189](https://github.com/TypeStrong/TypeDoc/issues/2189). - Added support for `@interface` on type aliases to tell TypeDoc to convert the fully resolved type as an interface, [#&#8203;1519](https://github.com/TypeStrong/TypeDoc/issues/1519) - Added support for `@namespace` on variable declarations to tell TypeDoc to convert the variable as a namespace, [#&#8203;2055](https://github.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, [#&#8203;2022](https://github.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<void>` from their `load` function, [#&#8203;185](https://github.com/TypeStrong/TypeDoc/issues/185). - TypeDoc now supports plugins written with ESM, [#&#8203;1635](https://github.com/TypeStrong/TypeDoc/issues/1635). - Added `Renderer.preRenderAsyncJobs` and `Renderer.postRenderAsyncJobs`, which may be used by plugins to perform async processing for rendering, [#&#8203;185](https://github.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`, [#&#8203;2112](https://github.com/TypeStrong/TypeDoc/issues/2112). - Added `--cacheBust` option to tell TypeDoc to include include the generation time in files, [#&#8203;2124](https://github.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, [#&#8203;2190](https://github.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, [#&#8203;2150](https://github.com/TypeStrong/TypeDoc/issues/2150). - TypeDoc will now ignore a leading `v` in versions, [#&#8203;2212](https://github.com/TypeStrong/TypeDoc/issues/2212). - Category titles now render with the same format in the page index and heading title, [#&#8203;2196](https://github.com/TypeStrong/TypeDoc/issues/2196). - Fixed crash when using `typeof` on a reference with type arguments, [#&#8203;2220](https://github.com/TypeStrong/TypeDoc/issues/2220). - Fixed broken anchor links generated to signatures nested within objects. ##### Thanks! - [@&#8203;bodil](https://github.com/bodil) - [@&#8203;futurGH](https://github.com/futurGH) - [@&#8203;jm4rtinez](https://github.com/jm4rtinez) - [@&#8203;muratgozel](https://github.com/muratgozel) #### v0.23.28 (2023-03-19) ##### Features - Added support for TypeScript 5.0, [#&#8203;2201](https://github.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, [#&#8203;2199](https://github.com/TypeStrong/TypeDoc/issues/2199). ##### Bug Fixes - Fixed a bug where optional properties were not appropriately marked as optional, [#&#8203;2200](https://github.com/TypeStrong/TypeDoc/issues/2200). - Fixed shifted navigation pane on devices 1024px wide, [#&#8203;2191](https://github.com/TypeStrong/TypeDoc/issues/2191). - Add missing `@private` and `@protected` tags to `typedoc/tsdoc.json`, [#&#8203;2187](https://github.com/TypeStrong/TypeDoc/issues/2187). ##### Thanks! - [@&#8203;futurGH](https://github.com/futurGH) #### v0.23.26 (2023-02-26) ##### Features - Added `Application.EVENT_VALIDATE_PROJECT` event for plugins which implement custom validation, [#&#8203;2183](https://github.com/TypeStrong/TypeDoc/issues/2183). - Plugins may now return an object from external symbol resolvers, [#&#8203;2066](https://github.com/TypeStrong/TypeDoc/issues/2066). - Expose `Comment.displayPartsToMarkdown` on for themes overwriting the `comment` helper, [#&#8203;2115](https://github.com/TypeStrong/TypeDoc/issues/2115). ##### Bug Fixes - Fix crash when converting `export default undefined`, [#&#8203;2175](https://github.com/TypeStrong/TypeDoc/issues/2175). - Fix error in console when clicking on headings in the readme, [#&#8203;2170](https://github.com/TypeStrong/TypeDoc/issues/2170). - TypeDoc will now ignore parameters of callback parameters when validating that all parameters have documentation, [#&#8203;2154](https://github.com/TypeStrong/TypeDoc/issues/2154). ##### Thanks! - [@&#8203;captain-torch](https://github.com/captain-torch) - [@&#8203;loopingz](https://github.com/loopingz) - [@&#8203;RebeccaStevens](https://github.com/RebeccaStevens) #### v0.23.25 (2023-02-11) ##### Breaking Changes - Upgraded Shiki, if your highlight theme was set to `material-<theme>`, the value will need to be changed to `material-theme-<theme>`, see the [Shiki release notes](https://github.com/shikijs/shiki/blob/main/CHANGELOG.md#&#8203;0130--2023-01-27). ##### Features - Added new `excludeNotDocumentedKinds` variable to control which reflection types can be removed by the `excludeNotDocumented` option, [#&#8203;2162](https://github.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, [#&#8203;2151](https://github.com/TypeStrong/TypeDoc/issues/2151). - Corrected behavior of `excludeNotDocumented` on arrow function-variables, [#&#8203;2156](https://github.com/TypeStrong/TypeDoc/issues/2156). - Added `package.json` to exports declaration. ##### Thanks! - [@&#8203;boneskull](https://github.com/boneskull) - [@&#8203;Mikkal24](https://github.com/Mikkal24) - [@&#8203;zamiell](https://github.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, [#&#8203;2135](https://github.com/TypeStrong/TypeDoc/issues/2135). - Fixed symlink handling when expanding entry points, [#&#8203;2130](https://github.com/TypeStrong/TypeDoc/issues/2130). ##### Thanks! - [@&#8203;boneskull](https://github.com/boneskull) #### v0.23.23 (2022-12-18) ##### Features - Added `ts.Signature` to emitted `EVENT_CREATE_SIGNATURE` event, [#&#8203;2002](https://github.com/TypeStrong/TypeDoc/issues/2002). ##### Bug Fixes - Links to members hidden by filter settings now temporarily override the filter, [#&#8203;2092](https://github.com/TypeStrong/TypeDoc/issues/2092). - If `src/` and `src/x` are specified as entry points, `src/` will no longer be ignored, [#&#8203;2121](https://github.com/TypeStrong/TypeDoc/issues/2121). #### v0.23.22 (2022-12-11) ##### Features - Add support for defining the kind sort order, [#&#8203;2109](https://github.com/TypeStrong/TypeDoc/issues/2109). ##### Bug Fixes - Normalize all file paths on Windows, [#&#8203;2113](https://github.com/TypeStrong/TypeDoc/issues/2113). - Fix `@link` tags within lists, [#&#8203;2103](https://github.com/TypeStrong/TypeDoc/issues/2103). #### v0.23.21 (2022-11-14) ##### Features - Added support for a catch-all wildcard in `externalSymbolLinkMappings`, [#&#8203;2102](https://github.com/TypeStrong/TypeDoc/issues/2102). - Added support for TypeScript 4.9. ##### Thanks! - [@&#8203;mistic100](https://github.com/mistic100) #### v0.23.20 (2022-11-03) ##### Bug Fixes - Fixed comment discovery for `@inheritDoc` if inheriting from a function type alias, [#&#8203;2087](https://github.com/TypeStrong/TypeDoc/issues/2087). #### v0.23.19 (2022-10-28) ##### Bug Fixes - Fixed title link if `titleLink` option was not specified, [#&#8203;2085](https://github.com/TypeStrong/TypeDoc/issues/2085). ##### Thanks! - [@&#8203;krisztianb](https://github.com/krisztianb) #### v0.23.18 (2022-10-23) ##### Features - Improved error reporting when failing to find entry points, [#&#8203;2080](https://github.com/TypeStrong/TypeDoc/issues/2080), [#&#8203;2082](https://github.com/TypeStrong/TypeDoc/issues/2082). ##### Bug Fixes - Constructor parameter-properties will now use the `@param` comment for the parameter if available, [#&#8203;1261](https://github.com/TypeStrong/TypeDoc/issues/1261). - Fixed display of object types containing methods, [#&#8203;1788](https://github.com/TypeStrong/TypeDoc/issues/1788). - Fixed conversion of intrinsic string mapping types when converting without a type node, [#&#8203;2079](https://github.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, [#&#8203;1830](https://github.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, [#&#8203;2068](https://github.com/TypeStrong/TypeDoc/issues/2068). ##### Thanks! - [@&#8203;futurGH](https://github.com/futurGH) #### v0.23.16 (2022-10-10) ##### Features - Object types will now be pretty printed, [#&#8203;1793](https://github.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, [#&#8203;2061](https://github.com/TypeStrong/TypeDoc/issues/2061). - In packages mode, readme files will now be automatically included if present, [#&#8203;2065](https://github.com/TypeStrong/TypeDoc/issues/2065). - Added support for specifying the base file url for links to source code, [#&#8203;2068](https://github.com/TypeStrong/TypeDoc/issues/2068). ##### Bug Fixes - Private parameter properties will no longer be ignored, [#&#8203;2064](https://github.com/TypeStrong/TypeDoc/issues/2064). ##### Thanks! - [@&#8203;captainTorch](https://github.com/captainTorch) #### v0.23.15 (2022-09-18) ##### Features - TypeDoc will now treat `@typedef {import("foo").Bar<Z>} Baz` type declarations which forward type parameters to the imported symbol as re-exports of that symbol, [#&#8203;2044](https://github.com/TypeStrong/TypeDoc/issues/2044). ##### Bug Fixes - TypeDoc will now prefer comments on variable declarations over signature comments, [#&#8203;2042](https://github.com/TypeStrong/TypeDoc/issues/2042). - Fixed double rendering of "Type Parameters" header, [#&#8203;2054](https://github.com/TypeStrong/TypeDoc/issues/2054). - Fixed double rendering of "Hierarchy" header, [#&#8203;2053](https://github.com/TypeStrong/TypeDoc/issues/2053). - Removed unused `widgets.png` and `[email protected]` 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/guides/options/#externalsymbollinkmappings) for usage examples and caveats, [#&#8203;2030](https://github.com/TypeStrong/TypeDoc/issues/2030). - External link resolvers defined with `addUnknownSymbolResolver` will now be checked when resolving `@link` tags, [#&#8203;2030](https://github.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, [#&#8203;2036](https://github.com/TypeStrong/TypeDoc/issues/2036). - Fixed centering of title bar on wide displays, actually this time, [#&#8203;2046](https://github.com/TypeStrong/TypeDoc/issues/2046). #### v0.23.13 (2022-09-01) ##### Bug Fixes - Fixed packages mode bug introduced in 0.23.12, [#&#8203;2043](https://github.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, [#&#8203;2043](https://github.com/TypeStrong/TypeDoc/issues/2043). - Fixed deprecation warning for `isIdentifierOrPrivateIdentifier`. - Fixed centering of title bar on wide displays, [#&#8203;2046](https://github.com/TypeStrong/TypeDoc/issues/2046). ##### Thanks! - [@&#8203;citkane](https://github.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, [#&#8203;2037](https://github.com/TypeStrong/TypeDoc/issues/2037). ##### Bug Fixes - Fixed crash when converting abstract mixin class, [#&#8203;2011](https://github.com/TypeStrong/TypeDoc/issues/2011). - Readme files within monorepos now have `@link` tags resolved, [#&#8203;2029](https://github.com/TypeStrong/TypeDoc/issues/2029). - Correctly resolve unqualified links to class members within parameters, [#&#8203;2031](https://github.com/TypeStrong/TypeDoc/issues/2031). - TypeDoc will now consider other reflections with the same name as parents when resolving links, [#&#8203;2033](https://github.com/TypeStrong/TypeDoc/issues/2033). - The "Hierarchy" and "Type Parameters" helpers on `DefaultThemeRenderContext` now contain all the HTML for their sections of the page, [#&#8203;2038](https://github.com/TypeStrong/TypeDoc/issues/2038). ##### Thanks! - [@&#8203;citkane](https://github.com/citkane) - [@&#8203;kaphula](https://github.com/kaphula) #### v0.23.10 (2022-07-31) ##### Features - Added support for detecting comments directly before parameters as the parameter comment, [#&#8203;2019](https://github.com/TypeStrong/TypeDoc/issues/2019). - Added support for using the comment directly before a constructor parameter that declares a property as the property comment, [#&#8203;2019](https://github.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?`, [#&#8203;2023](https://github.com/TypeStrong/TypeDoc/issues/2023). - `DefaultThemeRenderContext.markdown` now also accepts a `CommentDisplayPart[]` for rendering, [#&#8203;2004](https://github.com/TypeStrong/TypeDoc/issues/2004). - Expose `Converter.resolveLinks` method for use with `Converter.parseRawComment`, [#&#8203;2004](https://github.com/TypeStrong/TypeDoc/issues/2004). ##### Bug Fixes - Fixed schema URL for TSDoc preventing the use of `typedoc/tsdoc.json` in TSDoc extends, [#&#8203;2015](https://github.com/TypeStrong/TypeDoc/issues/2015). - Improved detection of package names in repositories using pnpm, [#&#8203;2017](https://github.com/TypeStrong/TypeDoc/issues/2017). - Fixed missing JSDoc style `@typedef` comments for properties, [#&#8203;2020](https://github.com/TypeStrong/TypeDoc/issues/2020). ##### Thanks! - [@&#8203;bodil](https://github.com/bodil) - [@&#8203;nazarhussain](https://github.com/nazarhussain) #### v0.23.9 (2022-07-24) ##### Bug Fixes - TypeDoc will no longer skip entry points which have no exports, [#&#8203;2007](https://github.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, [#&#8203;2008](https://github.com/TypeStrong/TypeDoc/issues/2008). - Packages mode will now respect the `--includeVersion` flag, [#&#8203;2010](https://github.com/TypeStrong/TypeDoc/issues/2010). - Fixed multiple reflections mapping to the same file name on case insensitive file systems, [#&#8203;2012](https://github.com/TypeStrong/TypeDoc/issues/2012). #### v0.23.8 (2022-07-17) ##### Features - Added defined in links for classes, enums, [#&#8203;180](https://github.com/TypeStrong/TypeDoc/issues/180). - Added support for `*.ghe.com` and `*.github.us` GitHub enterprise domains for source links, [#&#8203;2001](https://github.com/TypeStrong/TypeDoc/issues/2001). - Expose `Converter.parseRawComment` for plugins to parse additional markdown files, [#&#8203;2004](https://github.com/TypeStrong/TypeDoc/issues/2004). ##### Bug Fixes - TypeDoc will no longer emit a warning for `{@&#8203;link}` containing a URL, [#&#8203;1980](https://github.com/TypeStrong/TypeDoc/issues/1980). - `excludeNotDocumented` will no longer remove functions/methods/accessors which are documented, [#&#8203;1994](https://github.com/TypeStrong/TypeDoc/issues/1994). - Fixed missing `sources` property on signature reflections [#&#8203;1996](https://github.com/TypeStrong/TypeDoc/issues/1996). ##### Thanks! - [@&#8203;cary-hu](https://github.com/cary-hu) - [@&#8203;chadhietala](https://github.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 [#&#8203;1990](https://github.com/TypeStrong/TypeDoc/issues/1990). - The private member visibility option will now be respected in generated sites, [#&#8203;1992](https://github.com/TypeStrong/TypeDoc/issues/1992). - Overload rendering will no longer be broken if JavaScript is disabled, [#&#8203;453](https://github.com/TypeStrong/TypeDoc/issues/453). - All overloads are now shown at once rather than requiring clicks to see the documentation for each signature, [#&#8203;1100](https://github.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`), [#&#8203;1658](https://github.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, [#&#8203;1987](https://github.com/TypeStrong/TypeDoc/issues/1987). ##### Bug Fixes - All warnings will be reported instead of only the first warning of a given type, [#&#8203;1981](https://github.com/TypeStrong/TypeDoc/issues/1981). - Include references will no longer be incorrectly parsed as links, [#&#8203;1986](https://github.com/TypeStrong/TypeDoc/issues/1986). - The generated schema.json on the website will now use enum values rather than enum names if possible. ##### Thanks! - [@&#8203;akphi](https://github.com/akphi) - [@&#8203;zamiell](https://github.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, [#&#8203;1976](https://github.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, [#&#8203;1959](https://github.com/TypeStrong/TypeDoc/issues/1959). - TypeDoc now emits an `IndexEvent` on the `Renderer` when preparing the search index, [#&#8203;1953](https://github.com/TypeStrong/TypeDoc/issues/1953). - Added new `--searchInComments` option to include comment text in the search index, [#&#8203;1553](https://github.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, [#&#8203;1637](https://github.com/TypeStrong/TypeDoc/issues/1637). - TypeDoc will no longer crash if a comment contains an empty `@example` tag, [#&#8203;1967](https://github.com/TypeStrong/TypeDoc/issues/1967). - TypeDoc will now detect attempted inheritance from accessors and inherit from the getter or setter, [#&#8203;1968](https://github.com/TypeStrong/TypeDoc/issues/1968). - `intentionallyNotExported` will now properly respect qualified names, [#&#8203;1972](https://github.com/TypeStrong/TypeDoc/issues/1972). - Fixed missing namespace comments on `export * as NS` declarations, [#&#8203;1973](https://github.com/TypeStrong/TypeDoc/issues/1973). - Fixed missing comments on `export const x = () => 123` function variables, [#&#8203;1973](https://github.com/TypeStrong/TypeDoc/issues/1973). - Exported variable functions with properties will now be converted as a function+namespace instead of a variable+namespace, [#&#8203;1651](https://github.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`, [#&#8203;1951](https://github.com/TypeStrong/TypeDoc/issues/1951). - Added `--basePath` option to override TypeDoc's detected root directory, [#&#8203;1924](https://github.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, [#&#8203;1962](https://github.com/TypeStrong/TypeDoc/issues/1962). - Projects with a single entry point will now parse `@module` comments in the entry point, [#&#8203;1963](https://github.com/TypeStrong/TypeDoc/issues/1963). - Removed duplicate "in comment" warning when parsing comments, [#&#8203;1964](https://github.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, [#&#8203;1961](https://github.com/TypeStrong/TypeDoc/issues/1961). </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Enabled. ♻ **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. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://app.renovatebot.com/dashboard#github/SAP/ui5-webcomponents-react). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNS4zNy4xIiwidXBkYXRlZEluVmVyIjoiMzUuMzcuMSJ9--> --------- Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: Marcus Notheis <[email protected]>
1 parent b900a8c commit bd518ea

File tree

3 files changed

+6
-20
lines changed

3 files changed

+6
-20
lines changed

package.json

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,8 +82,7 @@
8282
"rimraf": "^4.0.4",
8383
"storybook": "7.0.2",
8484
"turndown": "^7.0.0",
85-
"typedoc": "^0.23.26",
86-
"typedoc-plugin-markdown": "^3.14.0",
85+
"typedoc": "^0.24.0",
8786
"typescript": "5.0.4",
8887
"vite": "^4.1.1",
8988
"vite-plugin-istanbul": "^4.0.0",

typedoc.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@
33
"entryPoints": ["packages/cypress-commands"],
44
"entryPointStrategy": "expand",
55
"out": "temp/typedoc",
6-
"plugin": ["typedoc-plugin-markdown"],
76
"exclude": ["**/dist/**/*", "**/test/**/*"],
87
"excludePrivate": true,
98
"json": "./packages/cypress-commands/api.json"

yarn.lock

Lines changed: 5 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -21171,20 +21171,9 @@ __metadata:
2117121171
languageName: node
2117221172
linkType: hard
2117321173

21174-
"typedoc-plugin-markdown@npm:^3.14.0":
21175-
version: 3.14.0
21176-
resolution: "typedoc-plugin-markdown@npm:3.14.0"
21177-
dependencies:
21178-
handlebars: ^4.7.7
21179-
peerDependencies:
21180-
typedoc: ">=0.23.0"
21181-
checksum: 6205600052185b4b193ab8a253d9df5ccbc95002c948a07f9024bcd26f0f23fbcc089fda4d6b4c8f4172f4eaca2bf9c32129989f6baaace7261cf4a0e41c976b
21182-
languageName: node
21183-
linkType: hard
21184-
21185-
"typedoc@npm:^0.23.26":
21186-
version: 0.23.28
21187-
resolution: "typedoc@npm:0.23.28"
21174+
"typedoc@npm:^0.24.0":
21175+
version: 0.24.1
21176+
resolution: "typedoc@npm:0.24.1"
2118821177
dependencies:
2118921178
lunr: ^2.3.9
2119021179
marked: ^4.2.12
@@ -21194,7 +21183,7 @@ __metadata:
2119421183
typescript: 4.6.x || 4.7.x || 4.8.x || 4.9.x || 5.0.x
2119521184
bin:
2119621185
typedoc: bin/typedoc
21197-
checksum: 40eb4e207aac1b734e09400cf03f543642cc7b11000895198dd5a0d3166315759ccf4ac30a2915153597c5c186101c72bac2f1fc12b428184a9274d3a0e44c5e
21186+
checksum: 49ecc56060a9d37fd3da4fb57f0a848bf618f3b97542ef503dad67e805a611359ad2453a625da0e2dd7a2d9eb7992bcefded58115b5cb3ddc98780b548e6dfd5
2119821187
languageName: node
2119921188
linkType: hard
2120021189

@@ -21323,8 +21312,7 @@ __metadata:
2132321312
storybook: 7.0.2
2132421313
tocbot: ^4.12.0
2132521314
turndown: ^7.0.0
21326-
typedoc: ^0.23.26
21327-
typedoc-plugin-markdown: ^3.14.0
21315+
typedoc: ^0.24.0
2132821316
typescript: 5.0.4
2132921317
vite: ^4.1.1
2133021318
vite-plugin-istanbul: ^4.0.0

0 commit comments

Comments
 (0)