NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2813 most downloaded on npm
A parser for the TypeScript doc comment syntax
Last release 5 days ago
29 Sep 2026
Release timing varies
gaps range from 2 weeks to 1.7 years
Nearly every release is documented
notes for 52 of 53 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
53 releases · first in 2018
@microsoft/tsdoc-config v0.17.1
@microsoft/tsdoc-config v0.17.1
Tue, 29 Sep 2026 18:52:33 GMT
TSDocEmitter dropped a line break that appeared before an inline node such as a code span, {@link} tag, or HTML element, joining the adjacent words.@microsoft/tsdoc-config v0.17.0
@microsoft/tsdoc-config v0.17.0
One column per quarter.
Wed, 16 Sep 2026 01:24:29 GMT
@microsoft/tsdoc v0.16.0
@microsoft/tsdoc v0.16.0
Tue, 11 Nov 2025 00:51:42 GMT
@jsx, @jsxRuntime, @jsxFrag, @jsxImportSource tags.@defaultValue tags.@microsoft/tsdoc v0.15.1
@microsoft/tsdoc v0.15.1
Sat, 23 Nov 2024 00:23:35 GMT
Eliminate remaining const enums.
Tue, 28 May 2024 21:34:19 GMT
Update an internal type import to avoid a circular reference (GitHub #327 and #328)
Wed, 14 Sep 2022 02:55:06 GMT
Rename the "master" branch to "main."
Sat, 09 Apr 2022 02:28:41 GMT
Add supportedHtmlElements and reportUnsupportedHtmlElements options and corresponding validation
Thu, 07 Apr 2022 22:51:07 GMT
supportedHtmlElements and reportUnsupportedHtmlElements options and corresponding validationFix an issue where "tsdoc-inline-tag-missing-braces" and "tsdoc-tag-should-not-have-braces" were reported incorrectly
Tue, 20 Apr 2021 04:25:13 GMT
Add a new TSDocMessageId definition used by @microsoft/tsdoc-config
Mon, 19 Apr 2021 21:22:32 GMT
Update tsdoc.json schema to add a new field "noStandardTags"
Fri, 22 Jan 2021 18:07:19 GMT
Thu, 03 Dec 2020 08:07:55 GMT ### Patches - Add a missing declaration file
Thu, 03 Dec 2020 08:07:55 GMT
Add a definition for the @decorator block tag (RFC 271)
Thu, 03 Dec 2020 04:31:52 GMT
@decorator block tag (RFC 271)Update documentation to reference the new website URL
Mon, 30 Nov 2020 06:16:21 GMT
Fix an issue where the line extractor's trailing whitespace trimming sometimes trimmed a non-whitespace character (GitHub #258)
Fri, 04 Sep 2020 15:53:27 GMT
Improve documentation for @inheritDoc
Wed, 20 May 2020 22:33:27 GMT
@see tag@inheritDocAdd some missing entries to TSDocConfiguration.allTsdocMessageIds() which were breaking eslint-plugin-tsdoc
Fri, 27 Mar 2020 23:14:53 GMT
Fix an issue where JSDoc optional params were not parsed correctly
Sat, 22 Feb 2020 20:44:16 GMT
Improve the parsing of @param and @typeParam tags to recognize legacy syntaxes
Sat, 22 Feb 2020 02:55:07 GMT
@param and @typeParam tags to recognize legacy syntaxesAdd some new TSDocMessageId definitions used by @microsoft/tsdoc-config
Tue, 19 Nov 2019 22:01:56 GMT
Add new API TSDocConfiguration.allTsdocMessageIds
Sat, 09 Nov 2019 05:55:42 GMT
Fix a regression where some API signatures were incompatible with TypeScript versions prior to 3.4
Wed, 04 Sep 2019 03:30:10 GMT
Fix an invalid regular expression.
Fri, 30 Aug 2019 18:38:59 GMT
Improve DeclarationReference.parse for module sources
Wed, 07 Aug 2019 23:06:02 GMT
@throws block tag (RFC 171)Add new meanings to DeclarationReference and fix some parsing bugs
Wed, 24 Jul 2019 00:38:18 GMT
Add beta implementation of new DeclarationReference API
Fri, 19 Jul 2019 02:47:09 GMT
Improve the wording of the error messages involving character sequences that look like TSDoc tags
Thu, 11 Apr 2019 03:58:35 GMT
Fix an issue where tsdoc-param-tag-with-invalid-name was sometimes incorrectly reported certain identifiers (issue #148)
Tue, 12 Mar 2019 23:18:11 GMT
Add new API TSDocConfiguration.isKnownMessageId()
Fri, 01 Mar 2019 06:39:52 GMT
Add a new API ParserMessage.messageId with a unique ID useful for filtering and searching for errors
Thu, 28 Feb 2019 01:29:39 GMT
Update parser to allow $ character in @param names, since ECMAScript allows this in unquoted identifiers
Tue, 29 Jan 2019 22:49:58 GMT
$ character in @param names, since ECMAScript allows this in unquoted identifiers$ character in declaration reference member identifiers (Example: {@link Button.$render})Add new interface IStringBuilder
Tue, 20 Nov 2018 21:23:06 GMT
IStringBuilderAdd a new API PlainTextEmitter.hasAnyTextContent()
Tue, 20 Nov 2018 07:42:17 GMT
PlainTextEmitter.hasAnyTextContent()Improve trimming of spacing for link text in {@link} tags
Fri, 09 Nov 2018 15:13:13 GMT
{@link} tagsAllow HTML in a DocSection node
Tue, 06 Nov 2018 01:37:22 GMT
DocSection nodeTSDocEmitter.renderHtmlTag() and TSDocEmitter.renderDeclarationReference() were including comment framingDocSection.appendNodesInParagraph() API(API change) DocErrorText is no longer allowed in DocSection; instead it must be part of a DocParagraph
Sat, 03 Nov 2018 02:07:10 GMT
DocErrorText is no longer allowed in DocSection; instead it must be part of a DocParagraphTSDocParserConfiguration to TSDocConfigurationTSDocConfiguration to be included with the parameters for every DocNode constructorTSDocConfiguration.docNodeManager for registering custom DocNode subclasses and their container relationshipsDocDeclarationReference.emitAsTsdoc(), DocHtmlStartTag.emitAsHtml(), and DocHtmlEndTag.emitAsHtml()DocNodeContainer(API change) Introduce DocParamCollection to enable efficient lookups of parameters by name
Sat, 27 Oct 2018 04:52:23 GMT
DocParamCollection to enable efficient lookups of parameters by nameDocComment.typeParamBlocks --> DocComment.typeParamsDocComment.paramBlocks --> DocComment.paramsAdd new APIs DocComment.emitAsTsdoc(), TSDocEmitter, and StringBuilder
Fri, 26 Oct 2018 08:42:51 GMT
DocComment.emitAsTsdoc(), TSDocEmitter, and StringBuilderFix issue where DocErrorText.text returned [object Object] instead of the text
Thu, 25 Oct 2018 08:29:36 GMT
DocErrorText.text returned [object Object] instead of the textFix stack overflow in DocFencedCode.language property getter
Wed, 17 Oct 2018 13:41:54 GMT
Fix a regression where the paragraph splitter was sometimes skipping blocks
Wed, 17 Oct 2018 12:49:01 GMT
(API change) Change DocBlock to have a DocSection property rather than inheriting from DocSection; this eliminates confusion about which nodes belong
Wed, 17 Oct 2018 04:47:19 GMT
DocBlock to have a DocSection property rather than inheriting from DocSection; this eliminates confusion about which nodes belong to the containerDocParticle to DocExcerpt, and eliminate the Excerpt classDocNodeLeaf, since now DocExcerpt is the only class that can represent excerptsDocNode.updateParameters() because it is no longer neededDocExcerpt, rather than via a special Excerpt.spacingAfterContentDocNodeTransforms.trimSpacesInParagraph() to no longer merge/remap excerpts during the transformation. If we need this information, we will track it differently.Improve error reporting for declaration references that are probably missing a "#" delimiter
Sun, 07 Oct 2018 06:30:34 GMT
"#" delimiterDocCodeFence to DocFencedCodeAn @deprecated block must contain a deprecation message
Wed, 03 Oct 2018 02:43:47 GMT
@deprecated block must contain a deprecation message@inheritDoc is used, then the summary section must be empty, and there must not be an @remarks blockAdd support for @defaultValue tag
Tue, 02 Oct 2018 02:35:35 GMT
@defaultValue tag@typeParam tagAdd support for @link tags using the new declaration reference syntax
Mon, 01 Oct 2018 22:11:24 GMT
@link tags using the new declaration reference syntax@inheritDoc tagsDocDeclarationReference, DocInheritDocTag, DocLinkTag, DocMemberIdentifier, DocMemberReference, DocMemberSelector, DocMemberSymbolParserContext.verbatimNodesDocParticle.particleId propertyAdd a new API DocNode.updateParameters() that allows a DocNode object to be updated after it was created; the tree nodes are no longer immutable
Tue, 25 Sep 2018 03:04:06 GMT
DocNode.updateParameters() that allows a DocNode object to be updated after it was created; the tree nodes are no longer immutableDocNodeTransforms.trimSpacesInParagraphNodes() for collapsing whitespace inside DocParagraph subtreesDocNode.excerpt property into a new abstract base class DocNodeLeafTue, 11 Nov 2025 00:51:42 GMT
Improve the error location reporting for DocErrorText objects
Fri, 31 Aug 2018 03:32:18 GMT
Rename DocComment.deprecated to deprecatedBlock
Tue, 28 Aug 2018 03:17:20 GMT
DocCodeSpan.text to DocCodeSpan.code and model the delimiters using particlesDocCodeFence)DocSection content is now grouped into DocParagraph nodes; blank lines are used to indicate paragraph boundariesDocComment.deprecated to deprecatedBlockSat, 23 Nov 2024 00:23:35 GMT
parserOptions.tsConfigRootDir to reduce file system probing. This field is commonly used when eslint is configured with @typescript-eslint/parser.Implement the @privateRemarks and @deprecated tags
Sat, 25 Aug 2018 05:53:56 GMT
Tue, 28 May 2024 21:34:19 GMT
Add more standard tag definitions: @deprecated, @eventProperty, @example, @inheritDoc, @link, @override, @packageDocumentation, @public, @privateRemar…
Fri, 24 Aug 2018 01:19:56 GMT
CoreTags to StandardTags so we can include non-core tags in the standard definitionsCoreModifierTagSet to StandardModifierTagSet and convert properties to functionsStandardization enum, and document them@deprecated, @eventProperty, @example, @inheritDoc, @link, @override, @packageDocumentation, @public, @privateRemarks, @sealed, @virtualTue, 19 Nov 2019 22:01:56 GMT
Initial release of the TSDoc library! :-)
Thu, 16 Aug 2018 18:18:02 GMT
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →