| 1 | # Change Log - @microsoft/tsdoc
|
| 2 |
|
| 3 | This log was last generated on Sat, 09 Apr 2022 02:28:41 GMT and should not be manually modified.
|
| 4 |
|
| 5 | ## 0.14.1
|
| 6 | Sat, 09 Apr 2022 02:28:41 GMT
|
| 7 |
|
| 8 | ### Patches
|
| 9 |
|
| 10 | - Rename the "master" branch to "main."
|
| 11 |
|
| 12 | ## 0.14.0
|
| 13 | Thu, 07 Apr 2022 22:51:07 GMT
|
| 14 |
|
| 15 | ### Minor changes
|
| 16 |
|
| 17 | - Add `supportedHtmlElements` and `reportUnsupportedHtmlElements` options and corresponding validation
|
| 18 | - Convert "const enum" APIs to be regular enums to enable compatibility with isolatedModules=true (GitHub #306)
|
| 19 |
|
| 20 | ## 0.13.2
|
| 21 | Tue, 20 Apr 2021 04:25:13 GMT
|
| 22 |
|
| 23 | ### Patches
|
| 24 |
|
| 25 | - Fix an issue where "tsdoc-inline-tag-missing-braces" and "tsdoc-tag-should-not-have-braces" were reported incorrectly
|
| 26 |
|
| 27 | ## 0.13.1
|
| 28 | Mon, 19 Apr 2021 21:22:32 GMT
|
| 29 |
|
| 30 | ### Patches
|
| 31 |
|
| 32 | - Add a new TSDocMessageId definition used by @microsoft/tsdoc-config
|
| 33 |
|
| 34 | ## 0.13.0
|
| 35 | Fri, 22 Jan 2021 18:07:19 GMT
|
| 36 |
|
| 37 | ### Minor changes
|
| 38 |
|
| 39 | - Update tsdoc.json schema to add a new field "noStandardTags"
|
| 40 | - Add new APIs: TSDocConfiguration.clear() and TSDocTagDefinition.validateTSDocTagName()
|
| 41 | - Add new "supportForTags" field to tsdoc.json schema
|
| 42 |
|
| 43 | ### Patches
|
| 44 |
|
| 45 | - Update doc comments to fix some syntax issues
|
| 46 |
|
| 47 | ## 0.12.24
|
| 48 | Thu, 03 Dec 2020 08:07:55 GMT
|
| 49 |
|
| 50 | ### Patches
|
| 51 |
|
| 52 | - Add a missing declaration file
|
| 53 |
|
| 54 | ## 0.12.23
|
| 55 | Thu, 03 Dec 2020 04:31:52 GMT
|
| 56 |
|
| 57 | ### Patches
|
| 58 |
|
| 59 | - Add a definition for the `@decorator` block tag (RFC 271)
|
| 60 |
|
| 61 | ## 0.12.22
|
| 62 | Mon, 30 Nov 2020 06:16:21 GMT
|
| 63 |
|
| 64 | ### Patches
|
| 65 |
|
| 66 | - Update documentation to reference the new website URL
|
| 67 | - Upgrade build tools and configuration
|
| 68 | - Fix typo
|
| 69 |
|
| 70 | ## 0.12.21
|
| 71 | Fri, 04 Sep 2020 15:53:27 GMT
|
| 72 |
|
| 73 | ### Patches
|
| 74 |
|
| 75 | - Fix an issue where the line extractor's trailing whitespace trimming sometimes trimmed a non-whitespace character (GitHub #258)
|
| 76 | - Update build system
|
| 77 |
|
| 78 | ## 0.12.20
|
| 79 | Wed, 20 May 2020 22:33:27 GMT
|
| 80 |
|
| 81 | ### Patches
|
| 82 |
|
| 83 | - Add support for `@see` tag
|
| 84 | - Improve documentation for `@inheritDoc`
|
| 85 |
|
| 86 | ## 0.12.19
|
| 87 | Fri, 27 Mar 2020 23:14:53 GMT
|
| 88 |
|
| 89 | ### Patches
|
| 90 |
|
| 91 | - Add some missing entries to TSDocConfiguration.allTsdocMessageIds() which were breaking eslint-plugin-tsdoc
|
| 92 | - Fix an issue where "h1" was not allowed as an HTML element name
|
| 93 |
|
| 94 | ## 0.12.18
|
| 95 | Sat, 22 Feb 2020 20:44:16 GMT
|
| 96 |
|
| 97 | ### Patches
|
| 98 |
|
| 99 | - Fix an issue where JSDoc optional params were not parsed correctly
|
| 100 |
|
| 101 | ## 0.12.17
|
| 102 | Sat, 22 Feb 2020 02:55:07 GMT
|
| 103 |
|
| 104 | ### Patches
|
| 105 |
|
| 106 | - Improve the parsing of `@param` and `@typeParam` tags to recognize legacy syntaxes
|
| 107 |
|
| 108 | ## 0.12.16
|
| 109 | Tue, 19 Nov 2019 22:01:56 GMT
|
| 110 |
|
| 111 | ### Patches
|
| 112 |
|
| 113 | - Add some new TSDocMessageId definitions used by @microsoft/tsdoc-config
|
| 114 |
|
| 115 | ## 0.12.15
|
| 116 | Sat, 09 Nov 2019 05:55:42 GMT
|
| 117 |
|
| 118 | ### Patches
|
| 119 |
|
| 120 | - Add new API TSDocConfiguration.allTsdocMessageIds
|
| 121 |
|
| 122 | ## 0.12.14
|
| 123 | Wed, 04 Sep 2019 03:30:10 GMT
|
| 124 |
|
| 125 | ### Patches
|
| 126 |
|
| 127 | - Fix a regression where some API signatures were incompatible with TypeScript versions prior to 3.4
|
| 128 |
|
| 129 | ## 0.12.13
|
| 130 | Fri, 30 Aug 2019 18:38:59 GMT
|
| 131 |
|
| 132 | ### Patches
|
| 133 |
|
| 134 | - Fix an invalid regular expression.
|
| 135 |
|
| 136 | ## 0.12.12
|
| 137 | Wed, 07 Aug 2019 23:06:02 GMT
|
| 138 |
|
| 139 | ### Patches
|
| 140 |
|
| 141 | - Improve DeclarationReference.parse for module sources
|
| 142 | - Add a definition for the `@throws` block tag (RFC 171)
|
| 143 |
|
| 144 | ## 0.12.11
|
| 145 | Wed, 24 Jul 2019 00:38:18 GMT
|
| 146 |
|
| 147 | ### Patches
|
| 148 |
|
| 149 | - Add new meanings to DeclarationReference and fix some parsing bugs
|
| 150 |
|
| 151 | ## 0.12.10
|
| 152 | Fri, 19 Jul 2019 02:47:09 GMT
|
| 153 |
|
| 154 | ### Patches
|
| 155 |
|
| 156 | - Add beta implementation of new DeclarationReference API
|
| 157 |
|
| 158 | ## 0.12.9
|
| 159 | Thu, 11 Apr 2019 03:58:35 GMT
|
| 160 |
|
| 161 | ### Patches
|
| 162 |
|
| 163 | - Improve the wording of the error messages involving character sequences that look like TSDoc tags
|
| 164 |
|
| 165 | ## 0.12.8
|
| 166 | Tue, 12 Mar 2019 23:18:11 GMT
|
| 167 |
|
| 168 | ### Patches
|
| 169 |
|
| 170 | - Fix an issue where tsdoc-param-tag-with-invalid-name was sometimes incorrectly reported certain identifiers (issue #148)
|
| 171 |
|
| 172 | ## 0.12.7
|
| 173 | Fri, 01 Mar 2019 06:39:52 GMT
|
| 174 |
|
| 175 | ### Patches
|
| 176 |
|
| 177 | - Add new API TSDocConfiguration.isKnownMessageId()
|
| 178 |
|
| 179 | ## 0.12.6
|
| 180 | Thu, 28 Feb 2019 01:29:39 GMT
|
| 181 |
|
| 182 | ### Patches
|
| 183 |
|
| 184 | - Add a new API ParserMessage.messageId with a unique ID useful for filtering and searching for errors
|
| 185 |
|
| 186 | ## 0.12.5
|
| 187 | Tue, 29 Jan 2019 22:49:58 GMT
|
| 188 |
|
| 189 | ### Patches
|
| 190 |
|
| 191 | - Update parser to allow `$` character in `@param` names, since ECMAScript allows this in unquoted identifiers
|
| 192 | - Allow `$` character in declaration reference member identifiers (Example: `{@link Button.$render}`)
|
| 193 |
|
| 194 | ## 0.12.4
|
| 195 | Tue, 20 Nov 2018 21:23:06 GMT
|
| 196 |
|
| 197 | ### Patches
|
| 198 |
|
| 199 | - Add new interface `IStringBuilder`
|
| 200 |
|
| 201 | ## 0.12.3
|
| 202 | Tue, 20 Nov 2018 07:42:17 GMT
|
| 203 |
|
| 204 | ### Patches
|
| 205 |
|
| 206 | - Add a new API `PlainTextEmitter.hasAnyTextContent()`
|
| 207 |
|
| 208 | ## 0.12.2
|
| 209 | Fri, 09 Nov 2018 15:13:13 GMT
|
| 210 |
|
| 211 | ### Patches
|
| 212 |
|
| 213 | - Improve trimming of spacing for link text in `{@link}` tags
|
| 214 |
|
| 215 | ## 0.12.1
|
| 216 | Tue, 06 Nov 2018 01:37:22 GMT
|
| 217 |
|
| 218 | ### Patches
|
| 219 |
|
| 220 | - Allow HTML in a `DocSection` node
|
| 221 | - Fix a bug where `TSDocEmitter.renderHtmlTag()` and `TSDocEmitter.renderDeclarationReference()` were including comment framing
|
| 222 | - Add `DocSection.appendNodesInParagraph()` API
|
| 223 |
|
| 224 | ## 0.12.0
|
| 225 | Sat, 03 Nov 2018 02:07:10 GMT
|
| 226 |
|
| 227 | ### Minor changes
|
| 228 |
|
| 229 | - (API change) `DocErrorText` is no longer allowed in `DocSection`; instead it must be part of a `DocParagraph`
|
| 230 | - (API change) Rename `TSDocParserConfiguration` to `TSDocConfiguration`
|
| 231 | - (API change) Require an associated `TSDocConfiguration` to be included with the parameters for every `DocNode` constructor
|
| 232 | - Introduce `TSDocConfiguration.docNodeManager` for registering custom `DocNode` subclasses and their container relationships
|
| 233 |
|
| 234 | ### Patches
|
| 235 |
|
| 236 | - Add `DocDeclarationReference.emitAsTsdoc()`, `DocHtmlStartTag.emitAsHtml()`, and `DocHtmlEndTag.emitAsHtml()`
|
| 237 | - Child nodes can now be specified as a second constructor parameter for `DocNodeContainer`
|
| 238 |
|
| 239 | ## 0.11.0
|
| 240 | Sat, 27 Oct 2018 04:52:23 GMT
|
| 241 |
|
| 242 | ### Minor changes
|
| 243 |
|
| 244 | - (API change) Introduce `DocParamCollection` to enable efficient lookups of parameters by name
|
| 245 | - (API change) Rename `DocComment.typeParamBlocks` --> `DocComment.typeParams`
|
| 246 | - (API change) Rename `DocComment.paramBlocks` --> `DocComment.params`
|
| 247 |
|
| 248 | ## 0.10.0
|
| 249 | Fri, 26 Oct 2018 08:42:51 GMT
|
| 250 |
|
| 251 | ### Minor changes
|
| 252 |
|
| 253 | - Add new APIs `DocComment.emitAsTsdoc()`, `TSDocEmitter`, and `StringBuilder`
|
| 254 |
|
| 255 | ## 0.9.3
|
| 256 | Thu, 25 Oct 2018 08:29:36 GMT
|
| 257 |
|
| 258 | ### Patches
|
| 259 |
|
| 260 | - Fix issue where `DocErrorText.text` returned `[object Object]` instead of the text
|
| 261 |
|
| 262 | ## 0.9.2
|
| 263 | Wed, 17 Oct 2018 13:41:54 GMT
|
| 264 |
|
| 265 | ### Patches
|
| 266 |
|
| 267 | - Fix stack overflow in DocFencedCode.language property getter
|
| 268 |
|
| 269 | ## 0.9.1
|
| 270 | Wed, 17 Oct 2018 12:49:01 GMT
|
| 271 |
|
| 272 | ### Patches
|
| 273 |
|
| 274 | - Fix a regression where the paragraph splitter was sometimes skipping blocks
|
| 275 |
|
| 276 | ## 0.9.0
|
| 277 | Wed, 17 Oct 2018 04:47:19 GMT
|
| 278 |
|
| 279 | ### Minor changes
|
| 280 |
|
| 281 | - (API change) Change `DocBlock` to have a `DocSection` property rather than inheriting from `DocSection`; this eliminates confusion about which nodes belong to the container
|
| 282 | - (API change) Rename `DocParticle` to `DocExcerpt`, and eliminate the `Excerpt` class
|
| 283 | - (API change) Eliminate `DocNodeLeaf`, since now `DocExcerpt` is the only class that can represent excerpts
|
| 284 | - (API change) Remove `DocNode.updateParameters()` because it is no longer needed
|
| 285 | - (API change) Spacing is now represented as a normal `DocExcerpt`, rather than via a special `Excerpt.spacingAfterContent`
|
| 286 | - (API change) Simplify `DocNodeTransforms.trimSpacesInParagraph()` to no longer merge/remap excerpts during the transformation. If we need this information, we will track it differently.
|
| 287 |
|
| 288 | ## 0.8.1
|
| 289 | Sun, 07 Oct 2018 06:30:34 GMT
|
| 290 |
|
| 291 | ### Patches
|
| 292 |
|
| 293 | - Improve error reporting for declaration references that are probably missing a `"#"` delimiter
|
| 294 | - Rename `DocCodeFence` to `DocFencedCode`
|
| 295 |
|
| 296 | ## 0.8.0
|
| 297 | Wed, 03 Oct 2018 02:43:47 GMT
|
| 298 |
|
| 299 | ### Minor changes
|
| 300 |
|
| 301 | - Introduce a distinction between "defined" tags (i.e. recognized) versus "supported" tags (i.e. implemented by the tool)
|
| 302 | - The parser optionally reports usage of undefined tags
|
| 303 | - The parser optionally reports usage of unsupported tags
|
| 304 | - The parser reports usage of inline/block syntax that is inconsistent with the tag definition
|
| 305 | - Code spans are now allowed to be adjacent to other text, but must contain at least one character
|
| 306 | - An `@deprecated` block must contain a deprecation message
|
| 307 | - If `@inheritDoc` is used, then the summary section must be empty, and there must not be an `@remarks` block
|
| 308 |
|
| 309 | ## 0.7.0
|
| 310 | Tue, 02 Oct 2018 02:35:35 GMT
|
| 311 |
|
| 312 | ### Minor changes
|
| 313 |
|
| 314 | - Add support for `@defaultValue` tag
|
| 315 | - Add support for `@typeParam` tag
|
| 316 |
|
| 317 | ## 0.6.0
|
| 318 | Mon, 01 Oct 2018 22:11:24 GMT
|
| 319 |
|
| 320 | ### Minor changes
|
| 321 |
|
| 322 | - Add support for `@link` tags using the new declaration reference syntax
|
| 323 | - Add support for `@inheritDoc` tags
|
| 324 | - Add new APIs: `DocDeclarationReference`, `DocInheritDocTag`, `DocLinkTag`, `DocMemberIdentifier`, `DocMemberReference`, `DocMemberSelector`, `DocMemberSymbol`
|
| 325 | - Remove `ParserContext.verbatimNodes`
|
| 326 | - Add `DocParticle.particleId` property
|
| 327 |
|
| 328 | ## 0.5.0
|
| 329 | Tue, 25 Sep 2018 03:04:06 GMT
|
| 330 |
|
| 331 | ### Minor changes
|
| 332 |
|
| 333 | - Add a new API `DocNode.updateParameters()` that allows a `DocNode` object to be updated after it was created; the tree nodes are no longer immutable
|
| 334 | - Add `DocNodeTransforms.trimSpacesInParagraphNodes()` for collapsing whitespace inside `DocParagraph` subtrees
|
| 335 | - Extract the `DocNode.excerpt` property into a new abstract base class `DocNodeLeaf`
|
| 336 |
|
| 337 | ## 0.4.1
|
| 338 | Fri, 31 Aug 2018 03:32:18 GMT
|
| 339 |
|
| 340 | ### Patches
|
| 341 |
|
| 342 | - Improve the error location reporting for DocErrorText objects
|
| 343 | - Separate the **api-demo** sample into a "simple" scenario which parses a simple text string, and an "advanced" scenario which uses the TypeScript compiler API to extract comments and parse custom TSDoc tags
|
| 344 |
|
| 345 | ## 0.4.0
|
| 346 | Tue, 28 Aug 2018 03:17:20 GMT
|
| 347 |
|
| 348 | ### Minor changes
|
| 349 |
|
| 350 | - Rename `DocCodeSpan.text` to `DocCodeSpan.code` and model the delimiters using particles
|
| 351 | - Add support for code fences (`DocCodeFence`)
|
| 352 | - `DocSection` content is now grouped into `DocParagraph` nodes; blank lines are used to indicate paragraph boundaries
|
| 353 | - Rename `DocComment.deprecated` to `deprecatedBlock`
|
| 354 |
|
| 355 | ## 0.3.0
|
| 356 | Sat, 25 Aug 2018 05:53:56 GMT
|
| 357 |
|
| 358 | ### Minor changes
|
| 359 |
|
| 360 | - Add TextRange.isEmpty()
|
| 361 | - Improve the ModifierTagSet API
|
| 362 | - Implement the @privateRemarks and @deprecated tags
|
| 363 |
|
| 364 | ## 0.2.0
|
| 365 | Fri, 24 Aug 2018 01:19:56 GMT
|
| 366 |
|
| 367 | ### Minor changes
|
| 368 |
|
| 369 | - Rename `CoreTags` to `StandardTags` so we can include non-core tags in the standard definitions
|
| 370 | - Rename `CoreModifierTagSet` to `StandardModifierTagSet` and convert properties to functions
|
| 371 | - Categorize the standard tags according to a `Standardization` enum, and document them
|
| 372 | - Add more standard tag definitions: `@deprecated`, `@eventProperty`, `@example`, `@inheritDoc`, `@link`, `@override`, `@packageDocumentation`, `@public`, `@privateRemarks`, `@sealed`, `@virtual`
|
| 373 | - Replace TSDocTagDefinition.singleton with TSDocTagDefinition.allowMultiple, since in practice most tags are single-usage
|
| 374 |
|
| 375 | ## 0.1.0
|
| 376 | Thu, 16 Aug 2018 18:18:02 GMT
|
| 377 |
|
| 378 | ### Minor changes
|
| 379 |
|
| 380 | - Initial release of the TSDoc library! :-)
|
| 381 |
|