v0.28.1

Features

• The TypeDocOptions interface now marks options as optional so it no longer has to be wrapped in Partial
  for use in config files, #2901.
• API: Expose control methods for deferred conversion for plugin use (typedoc-plugin-missing-exports)
• API: Expose method to disable TypeDoc usage of localStorage without clearing it, #2908.

Bug Fixes

• --watch can now infer entry points from package.json as supported in non-watch mode, #2899.
• @include with regions now works on files with CRLF line endings, #2902.
• Generated page names now correctly handles UTF-8 characters requiring more than 16 bits #2905.
• Fixed a crash when converting module.exports = [], #2909.
• Fixed URL generation which introduced a superfluous ./ in relative links, #2910.

Thanks!

• @jsmith2-coveo
• @romainmnr

v0.28.0

Breaking Changes

• TypeDoc now expects all input globs paths to be specified with / path separators, #2825.
• TypeDoc's --entryPointStrategy merge mode now requires JSON from at least version 0.28.0.
• Removed jp translations from lang, to migrate switch to ja.
• File name references in intentionallyNotExported now use a package name/package relative path instead of an absolute path for matching.
• The source-order sort ordering now considers package names / package relative paths instead of using the absolute paths to a file.
• TypeDoc will only check for a project README file next to the discovered package.json file if --readme is not set
  this change improves handling of monorepo setups where some packages have readme files and others do not, #2875.
• Function-like variable exports will now only be automatically converted as function types if
  they are initialized with a function expression. TypeDoc can be instructed to convert them as functions
  with the @function tag, #2881.
• Object literal type alias types will now be converted in a way which causes them to be rendered more similarly
  to how interfaces are rendered, #2817.

API Breaking Changes

• ProjectReflection.getReflectionFromSymbol and ProjectReflection.getSymbolFromReflection have been moved to Context
• Path and PathArray parameter types now always contain normalized paths.
• Introduced a Router which is used for URL creation. Reflection.url,
  Reflection.anchor, and Reflection.hasOwnDocument have been removed.
• Deserializer.reviveProject(s) no longer accepts an option to add project documents.
• Deserializer.reviveProjects now requires an alwaysCreateEntryPointModule option.
• Comment.serializeDisplayParts no longer requires a serializer argument.
• ReflectionSymbolId.fileName is now optional, TypeDoc now stores a combination of a package name and package relative path instead.
  The fileName property will be present when initially created, but is not serialized.
• Removed DeclarationReflection.relevanceBoost attribute which was added for plugins, but never used.
• i18n proxy is no longer passed to many functions, instead, reference i18n exported from the module directly.
• ReflectionKind.singularString and ReflectionKind.pluralString now returns translated strings.
  The methods on Internationalization to do this previously have been removed.
• The HTML output structure for the search box has changed to support the new modal.
• DefaultThemeRenderContext's typeDeclaration and typeDetailsIfUseful
  methods now require both a reflection and a type in order to support
  @expandType

Features

• Add support for TypeScript 5.8.x
• The search modal in the HTML output has been rewritten to provide better mobile support
• Added a --router option which can be used to modify TypeDoc's output folder
  structure. This can be extended with plugins, #2111.
• Introduced the @primaryExport modifier tag to provide more fine grained
  control over export conversion order, #2856
• Introduced packagesRequiringDocumentation option for validation.notDocumented, TypeDoc will expect comments to be present for symbols in the specified packages.
• TypeDoc now exports a typedoc/browser entrypoint for parsing and using serialized JSON files, #2528.
• Type packageOptions as Partial<TypeDocOptions>, #2878.
• TypeDoc will now warn if an option which should only be set at the root level is set in packageOptions, #2878.
• Introduced @function tag to force TypeDoc to convert variable declarations with a type annotation as functions, #2881.
• Exposed a TypeDoc global object in the HTML theme which can be used to prevent TypeDoc from using localStorage, #2872.
• Introduced @preventInline and @inlineType tags for further control extending the @inline tag, #2862.
• Introduced @preventExpand and @expandType tags for further control extending the @expand tag, #2862.
• API: Introduced DefaultThemeRenderContext.reflectionIcon for more granular control over displayed reflection icons.

Bug Fixes

• TypeDoc will now only create references for symbols re-exported from modules.
• Variable-functions will now prefer placing the comment on the signature if there is only one signature present, #2824.
• User filter settings will no longer sometimes cause the search to have fewer visible results than expected.
• Fixed handling of expando functions which were also merged with a namespace, #2876.
• Fixed rendering of function types within arrays and union types, #2892.
• Fixed an issue where if the theme JS didn't load, the page wouldn't be shown, #2894.

Thanks!

• @crimx
• @jsmith2-coveo
• @phoneticallySAARTHaK
• @XeroAlpha

v0.28.0-beta.2

See #2868 (comment) for discussion of changes

v0.28.0-beta.1

See #2868 (comment) for discussion of changes

v0.27.9

This will be the last v0.27.x release, see #2868 for discussion on the 0.28 beta.

Features

• Added support for TypeScript 5.8

v0.28.0-beta.0

See #2868 for discussion of changes

v0.27.8

Features

• The visibilityFilter option now supports individual signatures, #2846.
• The favicon option may now be given a link starting with https?:// instead of a path, #2851.
• TypeDoc now supports specifying # as the link in externalSymbolLinkMappings to indicate the type should not be linked to, #2853.

Bug Fixes

• Fixed an issue where unrecognized languages would incorrectly be listed in the list of languages with translations, #2852.
• Unresolved external type references will no longer incorrectly linked to undefined, #2854.

Thanks!

• @pjeby
• @XeroAlpha

v0.27.7

Features

• @includeCode and @inline can now inject parts of files using region
  names or line numbers, #2816.
• Introduced ja translation options, deprecated jp in favor of ja, #2843.
• Improved TypeDoc's --watch option to support watching files not caught by
  TypeScript's watch mode, #2675.
• The @inline tag now works in more places for generic types.
• Visibility filters now consider individual signatures, #2846.

Bug Fixes

• Fixed an issue where TypeDoc would incorrectly ignore type arguments in references, #2823.
• Improved narrator support for labeling icons, #2832.
• Fixed an issue with @class incorrectly handling mapped types, #2842.
• TypeDoc will now consider symbols to be external only if all of their declarations are external
  so that declaration merged members with global symbols can be documented, #2844.
• Fixed an issue where TypeDoc would constantly rebuild, #2844.
• Fixed an issue where the dropdown arrow in the index group would not respect the state of the dropdown, #2845.

Thanks!

• @pjeby
• @shawninder
• @tats-u
• @XeroAlpha

v0.27.6

Features

• Added ignoredHighlightLanguages option to specify languages which will be
  allowed in code blocks but not highlighted, #2819.

Bug Fixes

• @include and @includeCode now work in the readme file, #2814.
• TypeDoc will now avoid making references to references, #2811.
• Fixed output specific option specification, #2818.
• Improved type reference conversion to avoid including defaulted type arguments, #2820.
• Fixed parsing of declaration references which include a module and a local reference, #2810.
• Improved link resolution logic to prioritize type alias properties with the
  same symbol over type literal properties within function parameters.

v0.27.5

Bug Fixes

• Possibly Breaking: TypeDoc will no longer render anchors within the page for
  deeply nested properties. This only affects links to properties of
  properties of types, which did not have a clickable link exposed so are
  unlikely to have been linked to. Furthermore, these links were not always
  created by TypeDoc, only being created if all parent properties contained
  comments, #2808.
• TypeDoc will now warn if a property which does not have a URL within the
  rendered document and the parent property/page will be linked to instead,
  #2808. These warnings can be disabled with the validation.rewrittenLink
  option.
• Fix restoration of groups/categories including documents, #2801.
• Fixed missed relative paths within markdown link references in documents.
• Improved handling of incomplete inline code blocks within markdown.
• Direct https:// links under the hostedBaseUrl option's URL will no
  longer be treated as external, #2809.

Thanks!

• @SacDeNoeuds