Typedoc Versions Save

Documentation generator for TypeScript projects.

v0.25.3

6 months ago

Features

  • Added --sourceLinkExternal option to render source code links as external, #2415.
  • TypeDoc no longer requires the declarationMap option to be set to true to handle cross-package links in packages mode, #2416.
  • Added external-last option for the --sort option, #2418.

Bug Fixes

  • TypeDoc now attempts to correct local anchor links in readme files which are broken by its deconfliction logic, #2413.
  • TypeDoc now finds comments on index signatures again, #2414.
  • TypeDoc now does a better job of detecting properties when destructured function arguments are used.
  • Quotes will now be properly escaped in HTML attribute values.

Thanks!

  • @mogelbrod
  • @rsanchez

v0.25.2

7 months ago

Features

  • Added navigationLeaves option to remove branches from the navigation tree, #2382.
  • Added sortEntryPoints option (defaults to true) to allow disabling entry point sorting, #2393.
  • Improved support for multi-word searches, #2400.

Bug Fixes

  • Fixed conversion of @template constraints on JSDoc defined type parameters, #2389.
  • Invalid link validation is now correctly suppressed before all projects have been converted in packages mode, #2403.
  • Fixed tsconfig handling for projects using a solution-style tsconfig, #2406.
  • Fixed broken settings icons caused by icon caching introduced in 0.25.1, #2408.
  • Corrected module comment handling on declaration files containing a single declare module "foo", #2401.

Thanks!

  • @schiem

v0.25.1

8 months ago

Features

  • Added stripYamlFrontmatter config option to remove YAML frontmatter from README.md, #2381.
  • Added --excludeCategories config option to remove reflections present in any excluded category, #1407.
  • If no tsconfig.json file is present, TypeDoc will now attempt to compile without setting any compiler options, #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. 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.

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.
  • Improved support for optional names within JSDoc types, #2384.
  • Fixed duplicate rendering of reflection flags on signature parameters, #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.

Thanks!

  • @ajesshope
  • @HemalPatil
  • @hrueger
  • @typhonrt

v0.25.0

8 months ago

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.
  • Removed ReflectionKind.ObjectLiteral that was never used by TypeDoc.
  • Removed deprecated members DefaultThemeRenderContext.comment and DefaultThemeRenderContext.attemptExternalResolution.

Features

  • Added support for TypeScript 5.2
  • TypeDoc config files now support options default-exported from an ESM config file, #2268.
  • TypeDoc config files may now export a promise containing configuration, #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.
  • Added a no-results placeholder when no search results are available, #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.
  • Added support for tags @showGroups, @hideGroups, @showCategories, @hideCategories to configure the navigation pane on a per-reflection basis, #2329.
  • With --jsDocCompatibility.defaultTags set, @defaultValue is now implicitly a code block if the text contains no code, #2370.

Bug Fixes

  • Fixed link discovery if nested (Foo#bar) links were used and --useTsLinkResolution is enabled in some cases, #2360.
  • Links with invalid declaration references will no longer silently link to the wrong page in some cases, #2360.
  • Fixed duplicate definitions in type hierarchy when using packages mode, #2327.
  • @inheritDoc was not properly resolved across packages in packages mode, #2331.
  • Added warning for attempted @interface use on union types, #2352.
  • Fixed misleading type annotation on Theme.getUrls, #2318.
  • Fixed duplicate namespace in documentation if @namespace is used on a variable with an associated namespace, #2364.
  • Fixed @namespace property discovery if merged with a type and the type was declared first #2364.
  • Tables in markdown are now styled, #2366.
  • Sidebar links no longer open in a new tab, #2353.
  • Headers now include some padding before rendering text, #2316.
  • Symbol locations for signatures on reflection.sources now considers the node's name like non-signature location discovery does.

Thanks!

  • @camc314
  • @cprussin
  • @roggervalf
  • @Th3S4mur41

v0.24.8

11 months ago

Features

  • Added support for TypeScript 5.1, #2296.
  • Added navigation.fullTree to control rendering the full navigation tree on each page, #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.
  • Optimized icon caching to reduce file size in generated HTML documentation, #2287.
  • Render property description of "roughly top level" object types, #2276.
  • Added MarkdownEvent.INCLUDE for plugins, #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.
  • Comments are no longer removed from classes/interfaces containing call signatures, #2290.

Thanks!

  • @krisztianb
  • @WikiRik

v0.24.7

1 year ago

Features

  • TypeDoc will now allow conversion without any entry points to support "readme only" packages, #2264.

Bug Fixes

  • Category children are now sorted according to the sort option, #2272.
  • Inline tags no longer require a space after the tag name to be parsed as a tag, #2273.
  • Fixed module/namespace links in navigation when viewed in Safari, #2275.

v0.24.6

1 year ago

Features

  • Improved error messaging if a provided entry point could not be converted into a documented module reflection, #2242.
  • API: Added support for g, circle, ellipse, polygon, and polyline svg elements, #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.
  • The current namespace will also be expanded in the navigation on page load, #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

v0.24.5

1 year ago

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.
  • Added support for discovering a "module" comment on global files, #2165.
  • Added copy code to clipboard button, #2153.
  • Function @returns blocks will now be rendered with the return type, #2180.
  • Added --groupOrder option to specify the sort order of groups, #2251.

Bug Fixes

  • Type parameter constraints now respect the --hideParameterTypesInTitle option, #2226.
  • Even more contrast fixes, #2248.
  • Fix semantic highlighting for predicate type's parameter references, #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

v0.24.4

1 year ago

Bug Fixes

  • Fixed broken semantic coloring, #2247.
  • Increased contrast for parameter titles in dark mode to meet WCAG AA contrast requirements, #2244.
  • Underline color of index links now matches the text color, #2245.
  • Increased contract for active menu item text in dark mode.

v0.24.3

1 year ago

Bug Fixes

  • Fixed path expansion on Windows preventing generation, #2243 and #2241.