gajus/eslint-plugin-jsdoc
### [`v35.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.3...v35.2.0)
##### Features
- **`no-missing-syntax`, `no-restricted-syntax`, etc.:** assume `any` context if `context` omitted ([2dcd9ad](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2dcd9ad062b825c06b1e694c97ed802db50e071f))
### [`v35.1.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.2...v35.1.3)
##### Bug Fixes
- **`require-jsdoc`:** `exemptEmptyFunctions` option could trigger problematic return value checking behavior with no-argument functions ([3089a92](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/3089a921ac090dac32fd5289f7e5b519c3d57917))
### [`v35.1.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.1...v35.1.2)
##### Bug Fixes
- update jsdoc-type-pratt-parser ([1745fca](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1745fcaa960dbd97086f2c83f508a5f085acf9ec))
### [`v35.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.0...v35.1.1)
##### Bug Fixes
- update `jsdoc-type-pratt-parser` (liberalizes ID start to support underscores and start/continue to support other Unicode) ([1a6de5e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1a6de5ed9a2aa64f8b095953de38635d3459e0e2))
### [`v35.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.0.0...v35.1.0)
##### Bug Fixes
- **`no-missing-syntax`, `no-restricted-syntax`:** support "any" with comment including global comments ([dc641cc](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/dc641cc129d3964488e30b45388dc3351060cad4))
##### Features
- use `jsdoc-type-pratt-parser` ([647d47e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/647d47e5f6b392a60287b39f8799fa92b229190e))
### [`v35.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.8.2...v35.0.0)
##### Bug Fixes
- **`multiline-blocks`:** Enable (`noZeroLineText` and `noFinalLineText` will apply by default) ([b81e25d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b81e25d14d05c5c65992c9e6f34386fdf14e8d8d))
##### BREAKING CHANGES
- **`multiline-blocks`:** Should have been enabled by default
Also adds newer rules to doc listing
### [`v34.8.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.8.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.8.1...v34.8.2)
##### Bug Fixes
- **`check-line-alignment`:** add multiline type workaround ([#744](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/744)); fixes part of [#743](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/743) ([9928298](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9928298301a7cec0dfef0dcb786c065b5e08dfcd))
### [`v34.8.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.8.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.8.0...v34.8.1)
##### Bug Fixes
- **`tag-lines`:** avoid false positive for "never" when line break occurs in the middle of a tag description. ([3496011](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/34960110f0480e953432f305929cb8e22285f2f4))
- **`tag-lines`:** ensure a middle-of-block empty line doesn't suppress "always" errors ([33aa921](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/33aa92155ed96acb0509546c5cafb816daa73bb7))
### [`v34.8.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.8.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.7.0...v34.8.0)
##### Features
- **`tag-lines`:** add `tags` option to override behavior on a tag-specific basis (including only applying to tag(s)); fixes [#734](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/734) ([6e5e76d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6e5e76d05253d4ce2b097fd9c4d8fb27840c585e))
### [`v34.7.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.7.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.3...v34.7.0)
##### Features
- **`multiline-blocks`:** add `noFinalLineText` option; fixes [#738](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/738) ([03d3f40](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/03d3f40551bfb7cc13f00677e38baff83d13c9f4))
### [`v34.6.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.2...v34.6.3)
##### Bug Fixes
- **`multiline-blocks`:** fix merging of lines to prevent removal of spaces, though removing where needed ([9af6e36](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9af6e3615f318f92d2e108fe5d7a03b837d89ed7))
### [`v34.6.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.1...v34.6.2)
##### Bug Fixes
- **`multiline-blocks`:** ensure `noZeroLineText` checks when `noMultilineBlocks` is `true` but not matching; fixes [#737](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/737) ([19f60ac](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/19f60acf7be67f9abb12307157ab122ccf2c29ac))
### [`v34.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.0...v34.6.1)
##### Bug Fixes
- **`no-multi-asterisks`:** avoid false positives and erring in fixer of single line blocks; fixes [#735](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/735) ([355da58](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/355da58e86fc1127ca86a556bdd74966f694b802))
### [`v34.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.5.0...v34.6.0)
##### Features
- `no-multi-asterisks` rule to prevent multiple asterisks with middle delimiters or at end of blocks ([8848246](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8848246d2475184f98c3e0ccde85955cef75ee94))
### [`v34.5.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.5.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.4.0...v34.5.0)
##### Features
- **`multiline-blocks`:** allow control of how and whether jsdoc blocks can be expressed as single or multiple line blocks ([06bbf37](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/06bbf37183fb33bf2e6610a01d841008f2b5bd2b))
### [`v34.4.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.4.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.3.0...v34.4.0)
##### Features
- new rule `tag-line`; fixes [#93](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/93) ([851e3fe](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/851e3feed6849f1f9a5c76d7e14379a4018973f9))
### [`v34.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.3.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.2.2...v34.3.0)
##### Features
- **`check-values`:** ensure `[@variation](https://togithub.com/variation)` is a positive integer ([56577ce](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/56577cee2cb7b1abe26e67e07cafea02e0770f54))
### [`v34.2.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.2.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.2.1...v34.2.2)
##### Bug Fixes
- **`check-param-names`:** adjusts line numbers to be nearer problematic item ([e6c9ab2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e6c9ab27f41347475263a946c4ad3a0319aa89af))
- **`no-missing-syntax`:** pass in missing `comment` ([a977896](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a9778964a81ce36a54b71eb0a640ca7613013dd3))
### [`v34.2.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.2.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.2.0...v34.2.1)
##### Bug Fixes
- **`require-description`, `require-example`:** for missing description, use tag line number ([310ea75](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/310ea7506cbb0a991447dad63a133518a0c0a8e8))
### [`v34.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.1.0...v34.2.0)
##### Features
- **`no-bad-blocks`:** add `preventAllMultiasteriskBlocks` boolean option to allow reporting of any multi-asterisked multiline comments ([9669fc3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9669fc331bcd9cb7324301de58661b9a372bc7ee))
### [`v34.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.0.2...v34.1.0)
##### Features
- **`check-line-alignment`:** add `preserveMainDescriptionPostDelimiter` option to preserve left-hand side spacings in the main description when using the `always` option. ([54dac34](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/54dac3493d76461065c461e039433e51e2816d21))
### [`v34.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.0.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.0.1...v34.0.2)
##### Bug Fixes
- **`no-bad-blocks`:** avoid allowing 3+ asterisks with tag content (as with only 1 asterisk) ([28397c7](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/28397c7ed54b34a320a9d3961131da2dbf87c534))
### [`v34.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.0.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.0.0...v34.0.1)
##### Bug Fixes
- multiline tag fixers omitting subsequent tag lines with new command-parser API ([8fa7f9b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8fa7f9bba4b2704f776eabc0463b6719bb0dfcdf))
### [`v34.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.3.0...v34.0.0)
##### chore
- require engines Node 12+ ([#726](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/726)) ([a0ee0a6](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a0ee0a66dcffd49dc4e1d2b6315795151ee19aa1))
##### BREAKING CHANGES
- Also:
- Build: Switch to Node 12 target
- Linting: Use `flat` API
- Travis: Add Node 16, remove Node 10
- npm: Update devDep.
### [`v33.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.3.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.2.0...v33.3.0)
##### Features
- **`check-line-alignment`:** allow `tags` option to apply with "always"; [#703](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/703) ([4421e4e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4421e4eac3328c7d1b0c9d8684c1d655c3560aa7))
### [`v33.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.1.1...v33.2.0)
##### Features
- add require-asterisk-prefix rule ([#446](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/446)) ([f892338](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/f8923387b25f9140ccfde52fa35b5fc345c4437f)), closes [#199](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/199)
### [`v33.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.1.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.1.0...v33.1.1)
##### Bug Fixes
- update jsdoccomment to surface fixes ([7de397b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7de397b91e221b44221ed631cc15c83fe1d8e8ae))
### [`v33.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.0.0...v33.1.0)
##### Features
- support comment-selector-based contexts ([f73c72c](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/f73c72c361e704bd600b1c9fc41203c66966fc55))
- support comment-selector-based contexts ([6e835fd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6e835fda2a8eb5aece69b169b7721735044f6e2b))
### [`v33.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.4...v33.0.0)
##### chore
- use external `@es-joy/jsdoccomment` for `getJSDocComment` functionality ([aa77e3b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/aa77e3bdbcf3d5c1642f78825bbcd3e6b6edae85))
##### BREAKING CHANGES
- Should only be breaking for anyone requiring the `getJSDocComment` file.
Also updates Babel devDeps.
### [`v32.3.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.4)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.3...v32.3.4)
##### Bug Fixes
- preserve newlines in tag description comparisons; fixes [#692](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/692) ([7edaed3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7edaed3f9624a27cd78c3286a0be833224b0a7df))
### [`v32.3.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.2...v32.3.3)
##### Bug Fixes
- **`require-param`, `check-param-names`:** do not fail with destructured array pattern containing empty slots; fixes [#716](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/716) ([f19e706](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/f19e70618c962b855402fc1cef4911ba38357a87))
### [`v32.3.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.1...v32.3.2)
##### Bug Fixes
- **`check-line-alignment`:** prevent false never reporting where a space is present (post tag) followed by missing space (from a wholly missing type) and then a space (but a space first preceded by content (a name); fixes [#714](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/714) ([2c31db1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2c31db1413874f08faa634970266f383ceed0f25))
### [`v32.3.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.0...v32.3.1)
##### Bug Fixes
- **`check-examples`:** disable chai-friendly/no-unused-expressions for default expression rules ([06f0112](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/06f0112f76f0eb55b9e1b92703a270be8797d146))
### [`v32.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.2.0...v32.3.0)
##### Features
- **`check-tag-names`:** jsxTags an opt-in option for jsx annotations ([8afb9fc](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8afb9fc75d203d278d21f5d4ca0d8437aad21668))
### [`v32.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.1.1...v32.2.0)
##### Features
- **`check-types`:** check `settings.jsdoc.structuredTags` for an array of permissible types, reporting if not present; fixes [#695](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/695) ([9dad3e0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9dad3e08116a1950578d4f85e3acfc86b10b60f6))
- **`no-undefined-types`:** allow `structuredTags` types to be auto-defined ([b7198e4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b7198e47b79d1a9936e032f43c66b4af730bfeb4))
### [`v32.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.1.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.1.0...v32.1.1)
##### Bug Fixes
- **`check-param-names`, `require-jsdoc`, `require-param`:** avoid erring upon `MemberExpression` or other constructions within dynamic properties; fixes [#699](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/699) ([1cfdeb4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1cfdeb4446a47848db5eb039342da9d9ff187626))
### [`v32.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.3...v32.1.0)
##### Features
- **`require-jsdoc`:** allow checking for getter or setter only; fixes [#515](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/515) ([937d65e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/937d65ed6c0a8e0d34985de25072f988c1fe28e5))
### [`v32.0.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.2...v32.0.3)
##### Bug Fixes
- **`require-jsdoc`:** more accurate and optimized decorator detection; fixes [#697](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/697) ([88655b3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/88655b32a68718f4d010843dba2d5aa683afe638))
### [`v32.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.1...v32.0.2)
##### Bug Fixes
- **`match-description`:** while preserving internal newlines, ensure trailing whitespace is stripped for comparisons; for [#692](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/692) ([27b95b3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/27b95b35a37916a69f9ea1dd75285e2f18a5f278))
### [`v32.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.0...v32.0.1)
##### Bug Fixes
- default to `u` flag for `checkTypesPattern` option for `require-param`, `check-param-names`; for `check-values`, default to `u` flag and allow slashed regexes with own flags; for `match-description`, allow slashed regexs with own flags; for all of the previous (and `check-examples`) allows newlines ([4f0dc8e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4f0dc8ee7d50860050eccf7b0484d409315c006b))
### [`v32.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.6.1...v32.0.0)
##### Bug Fixes
- **check-examples:** change default extension for simulated file name of `[@example](https://togithub.com/example)` from `md` to `md/*.js`. Only applies when `matchingFileName` is not used. ([2cc1227](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2cc12279f35f0136e6b3a68c7d19ae8719e7a061))
##### BREAKING CHANGES
- **check-examples:** Per update to `eslint-plugin-markdown` v2 and its support of ESLint 7's new processor API, fenced blocks can (and must) be targeted separately from the Markdown parent file as a whole, so in order to allow the same `overrides` config to be reusable between Markdown fenced blocks and `@example` tags (since one often wishes to disable the same kind of rules for each, being as that each may deliberately lack full context, e.g., undefined or unused variables), we update the default simulated extension set for `@example` tags by `check-examples` to simulate an expression which will now be a suitable choice for `overrides` in targeting Markdown fenced blocks using the new parser API, as with eslint-plugin-markdown@2 (i.e., "md/\*.js" instead of "md").
If you need to use ESLint 6 (or eslint-plugin-markdown < 2, for example) with `check-examples`, you should be able to manually supply the `matchingFileName` option targeting "md", e.g., set to `'dummy.md`.
This commit also simplifies a testing example to avoid it throwing with changed config not having proper babel support (not meaningful to test anyways)
### [`v31.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.6.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.6.0...v31.6.1)
##### Bug Fixes
- update `comment-parser`; fixes [#686](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/686) ([7e0bbbe](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7e0bbbe82eb4a1d0b0c603ed0c78bd6e685dee20))
### [`v31.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.6.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.5.0...v31.6.0)
##### Bug Fixes
- **`require-returns`, `require-yields`:** support more AST checking ([6fd8a07](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6fd8a070c12a30eec8ccca5486446a06331a3d45))
- **`require-yields`:** avoid checking nested generators (as with functions) ([b9058e4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b9058e493640289e4a585e48a2dad810f0c170a4))
- **`return-yields`, `return-yields-check`:** allow generator detection on exported; handle more AST types; fixes [#682](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/682) ([4e768aa](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4e768aaed4c9fd28496af910e147183a950ce6a1))
##### Features
- **`require-returns-check`:** add `exemptAsync` option ([0ed24c0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0ed24c049919757c15ec80e06e4be8686524c47b))
### [`v31.5.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.5.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.4.0...v31.5.0)
##### Bug Fixes
- **`require-returns`:** check labeled statements ([51f37f1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/51f37f10774ff3d9cd33faecdf829e83610700c5))
- **`require-throws`:** check labeled statements ([ceadcfe](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/ceadcfe7fed67af579fb2de6fb0df8aefe37a115))
- **`require-yields`:** check `test` part of if expression and check conditionals ([db001be](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/db001bebad9ef1b5a27297142fd328cbcc86759f))
- **`require-yields`:** check labeled statements ([aceb7a0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/aceb7a096fadc13939163ec1b77b03e771002477))
##### Features
- **`require-returns`:** if function returns a Promise whose executor resolves with undefined, avoid need to document unless `forceReturnsWithAsync` is set; fixes [#550](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/550) ([565fdbd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/565fdbd410db2127f8272d0896a6768a4a8c95d0))
### [`v31.4.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.4.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.3...v31.4.0)
##### Bug Fixes
- **`check-line-alignment`:** escape user tag name in regex ([c0ae4cb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c0ae4cb193f643b321329d008d4eff80d4ea485a))
##### Features
- **`check-line-alignment`:** allow `tags` option to configure which tags should be aligned. ([780b8b5](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/780b8b50888db2196ec420157b9d3092c202b079))
### [`v31.3.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.2...v31.3.3)
##### Bug Fixes
- **`check-line-alignment`:** apply alignment to return tags and avoid possibility for "never" option to insert extra space with `returns`/`return` as well as handle missing type ([cb39556](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/cb39556cb69be6c9a32e8a2acd725bcd2f354d31))
### [`v31.3.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.1...v31.3.2)
##### Bug Fixes
- while a fix provided for decorator detection and useful for inserting empty jsdoc blocks when fixers are enabled, it appears to have a 25% or so degradation in performance when tested with a large repository, so reverting. ([e08d889](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e08d8891ffbfe15b78830ea6b10230e12df13906))
##### Reverts
- Revert "optimize: ensure with new fix that we avoid checking back too far" ([0fc4663](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0fc466363224e45d2e9b638f124782e0e0d4c40d))
### [`v31.3.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.0...v31.3.1)
##### Bug Fixes
- bug with false positive decorator detection (evident sans semi-colons); e.g., `require-jsdoc` fixer ([6bda6b4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6bda6b47d267982914581bfc03b4de50c9d0da07))
### [`v31.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.3...v31.3.0)
##### Features
- **`check-param-names`:** add options `disableExtraPropertyReporting` to allow extra properties to be documented without error (as long as there are no siblings destructured as for such cases, they will still be expected since the function is not using them) ([8b2d143](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8b2d143e6201fe271b45debbc6c43bcabc03f6a1))
### [`v31.2.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.2...v31.2.3)
##### Bug Fixes
- **`require-param`, `check-param-names`:** add option `useDefaultObjectProperties` for expecting documentation or avoiding reporting of documented; addresses part of [#676](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/676) ([a36faf2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a36faf24005346e0d07cb43c1128ba4ced658b0a))
### [`v31.2.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.1...v31.2.2)
##### Bug Fixes
- **`check-tag-names`:** should have previously auto-allowed `settings.jsdoc.structuredTags` tags ([5f586fd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/5f586fdc10d4619ea98242900ae1444d2babe018))
### [`v31.2.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.0...v31.2.1)
##### Bug Fixes
- caps issue with require-yields-check rule ([6b8d0d8](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6b8d0d826f08655393eacc29d8d90470fa014571))
### [`v31.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.1.0...v31.2.0)
##### Features
- **`require-yields-check`:** add rule to check that `yield` (of proper form) is present in the function body; fixes [#354](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/354) ([acf9529](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/acf95295b62bfb3a88af93df36c350204604d439))
### [`v31.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.8...v31.1.0)
##### Features
- **`require-yields`:** add new rule to check that `yield` has documentation; for [#354](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/354) ([e06fddd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e06fddd65a6529ad683dae0ad0dbb903e78a7fc6))
- **`require-yields`:** add options to check that `next` has documentation ([15daa12](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/15daa12ef23ee4f51d6dbe8385cccdaf868668df))
### [`v31.0.8`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.8)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.7...v31.0.8)
##### Bug Fixes
- **`no-undefined-types`:** support `true` and `false` literals ([b8cb394](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b8cb394876af03512791a44c9efad10d46e43703))
### [`v31.0.7`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.7)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.6...v31.0.7)
##### Bug Fixes
- ensure accurate parsing of names after multi-line types; fixes [#669](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/669) ([7b9c1bd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7b9c1bd8766b60df55dc324ec4848dbb9020eb7c))
### [`v31.0.6`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.6)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.5...v31.0.6)
##### Bug Fixes
- update `comment-parser` to surface restoration of support for equal signs in defaults and multi-line types; fixes [#669](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/669); fixes [#673](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/673) ([081d7eb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/081d7eb63eb5b1022f2ce6a93760ab82f13a8307))
### [`v31.0.5`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.5)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.4...v31.0.5)
##### Bug Fixes
- **`require-description-complete-sentence`:** regression re: not trimming of description for check as relevant to tag description checking; fixes [#672](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/672) ([d81caa2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/d81caa2ee88610e4c7c015bc84ad712e3f57d3cd))
### [`v31.0.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.4)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.3...v31.0.4)
##### Bug Fixes
- restore trim as relevant to tag description checking; fixes [#670](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/670) ([9f69c36](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9f69c366e3da081c27b93b7954d7c5e4d15932e4))
### [`v31.0.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.2...v31.0.3)
##### Bug Fixes
- **`newline-after-description`:** handle description on same line as opening asterisks; fixes [#668](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/668) ([040d177](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/040d1773983aef155f40b63fe9af3a2689eec0ed))
### [`v31.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.1...v31.0.2)
##### Bug Fixes
- **`check-line-alignment`:** implement default `never` options; fixes [#483](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/483) ([b2db226](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b2db2266c15510ab0f8155831a0fbc1128e717bd))
### [`v31.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.0...v31.0.1)
##### Bug Fixes
- **`check-line-alignment`:** handle spaces in type and skip for single line ([@renatho](https://togithub.com/renatho)); closes [#638](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/638) ([577863b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/577863bbb2bbceaa8daa9bf83b7b0c26a6836e33))
### [`v31.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.13...v31.0.0)
##### chore
- update comment-parser; should now cause fixers to preserve original whitespace unless the rule is meant to fix it ([095ff36](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/095ff3670c5a1332ec6a6d251d8355c16a41627e))
##### BREAKING CHANGES
- Tests are not breaking, but as changing the fundamental parser, forcing major bump to be safe.
Also updates:
1. `require-description-complete-sentence` - test to fix output
2. `require-hyphen-before-param-description` - test to preserve whitespace in fixed output (though still minus hyphen)
3. `require-param` - test preserving whitespace
4 `require-jsdoc` - test with no indent
### [`v30.7.13`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.13)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.12...v30.7.13)
##### Bug Fixes
- **`require-hyphen-before-param-description`:** regression failing to only check for hyphen at beginning; fixes [#665](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/665) ([acc3fc1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/acc3fc1c577527ade66f2fa0f4001ea717bfb03a))
### [`v30.7.12`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.12)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.11...v30.7.12)
##### Bug Fixes
- **`require-jsdoc`:** skip past type annotations when seeking backward through decorators; fixes [#659](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/659) ([62abd11](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/62abd1102fc1b953106f03690766f5b84ccdf39b))
### [`v30.7.11`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.11)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.10...v30.7.11)
##### Bug Fixes
- **`no-bad-blocks`:** avoid erring with `/* */` comment ([4e6c73d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4e6c73d87204d0caf24fd210b352fb76172eb2ce))
### [`v30.7.10`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.10)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.9...v30.7.10)
##### Bug Fixes
- **`check-examples`:** disable `no-new` for `check-examples` and default param checking ([590d54e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/590d54e4b4deed2963092da24e38dcb5a71a22f8))
- **`require-hyphen-before-param-description`:** allow whitespace before hyphen when checking for hyphens; fixes [#664](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/664) ([fb906de](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/fb906ded845afb73cbe0047a5ab4b0f7bb96b666))
### [`v30.7.9`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.9)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.8...v30.7.9)
##### Bug Fixes
- **`no-undefined-types`:** allow `this`; fixes [#660](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/660) ([bda5959](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/bda59595c03d7e2b6a596e6864d883d84f04a618))
### [`v30.7.8`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.8)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.7...v30.7.8)
##### Bug Fixes
- **`check-examples`:** allow multiline captions; fixes [#655](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/655) ([8963394](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8963394ee5d5712532607a19b6ab7605d24c5c48))
### [`v30.7.7`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.7)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.6...v30.7.7)
##### Bug Fixes
- **`require-jsdoc`:** regression causing uncommented nested syntax to be reported with `publicOnly` even when export was commented; fixes [#654](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/654) ([bcd465f](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/bcd465f5e1e501865a29827655032984c926abf1))
### [`v30.7.6`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.6)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.5...v30.7.6)
##### Bug Fixes
- **`check-examples`:** disable strict for expressions ([245e4a7](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/245e4a7bcba900ccd971175be91324df1b9c0236))
### [`v30.7.5`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.5)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.4...v30.7.5)
##### Bug Fixes
- ensure all rules marked with recommended status; add table property for recommended status; fixes [#652](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/652) ([4e699c4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4e699c4d2b36fd27cd70905fbc178ce7fe9c2448))
### [`v30.7.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.4)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.3...v30.7.4)
##### Bug Fixes
- **match-description, no-undefined-types, require-description-complete-sentence, require-hyphen-before-param-description, valid-types:** parse `template` properly; fixes [#653](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/653) ([122a9b5](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/122a9b54f8bd93652edf451d014060ef39379dc1))
### [`v30.7.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.2...v30.7.3)
##### Bug Fixes
- **`check-examples`:** Check defaults, params, properties as expressions ([6163f3c](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6163f3c7f8ae8a9ddffcf8736846632d86e566d6))
### [`v30.7.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.1...v30.7.2)
##### Bug Fixes
- **`check-examples`:** use `jsdoc-defaults`, `jsdoc-params`, and `jsdoc-properties` as default extensions to allow these to have their own overrides ([39fb1cb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/39fb1cbaba7d119685d04f37301c0eae9c08fe0e))
### [`v30.7.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.0...v30.7.1)
##### Bug Fixes
- **`check-examples`:** Set `checkDefaults`, `checkParams`, `checkProperties` defaults to `false` ([2de1011](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2de1011a60fdac8fab619a313395947819566c2c))
### [`v30.7.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.5...v30.7.0)
##### Features
- **`check-examples`:** add options `checkDefaults`, `checkParams`, `checkProperties`; fixes [#473](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/473) ([262a474](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/262a47405eeec5cc2e6ef7510702a008ad573d55))
### [`v30.6.5`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.5)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.4...v30.6.5)
##### Bug Fixes
- **`valid-types`:** Ensure `module` tag operates as though `module:` prefix is present (so as to create valid namepath when valid); fixes [#649](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/649) ([2e0f2a6](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2e0f2a620f1e57cd3a69d33e4421b9d482bd8148))
### [`v30.6.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.4)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.3...v30.6.4)
##### Bug Fixes
- **`require-jsdoc`:** for publicOnly ESM, adds direct ancestor check, allowing, e.g., `TSPropertySignature` and `TSMethodSignature`; fixes [#647](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/647) ([2b55275](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2b55275e106a1f20436efa3caa87ebe7d9e409eb))
### [`v30.6.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.2...v30.6.3)
##### Bug Fixes
- **`require-jsdoc`:** Avoid error when comment block above export of `TSDeclareFunction`; fixes [#645](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/645) ([0b95ba5](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0b95ba5d497c8a91a40d2a5cb73dae3ccb0d6d60))
### [`v30.6.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.1...v30.6.2)
##### Bug Fixes
- **`require-jsdoc`:** support `TSTypeAliasDeclaration` with `publicOnly` ([42a9b35](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/42a9b3575b57d0692c54a0e77f023d7531d89c68))
### [`v30.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.0...v30.6.1)
##### Bug Fixes
- **`require-jsdoc`:** support `TSInterfaceDeclaration` with `publicOnly` ([3ae8e61](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/3ae8e61cb6d5c9e12d6f1d4f535380b304931014))
### [`v30.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.3...v30.6.0)
##### Features
- add `ignoreInternal` setting to ignore blocks with `[@internal](https://togithub.com/internal)` tags; fixes [#639](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/639) ([80e16d0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/80e16d0f9bd024e5e77b78af1ba91a700f7919f2))
### [`v30.5.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.2...v30.5.3)
##### Bug Fixes
- **`no-bad-blocks`:** ensure reports bad blocks with descriptions ([9a56863](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9a568638f59960c8008fc2d03e4d83252a1e3072))
### [`v30.5.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.1...v30.5.2)
##### Bug Fixes
- **`require-jsdoc`:** allow `contexts` to be usable in place of `require` items ([a1d95e6](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a1d95e67e7c4c22e5e477458f3a0d6f836151f01))
- **`require-jsdoc`:** support `TSEnumDeclaration` with `publicOnly`; fixes [#640](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/640) ([63ef3bc](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/63ef3bcd16558663abc7dada4f7abc0e9bd668ba))
### [`v30.5.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.0...v30.5.1)
##### Bug Fixes
- rename rule as intended to `check-line-alignment` ([ec71632](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/ec71632eba1e43fd13cd7c4f50b6c0a8392ad778))
### [`v30.5.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.4.2...v30.5.0)
##### Features
- **`check-line-alignment`:** add rule for line alignment ([#636](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/636)) ([6e2b99d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6e2b99da1a0e3e65bfa6eefb7b127b3d30c6e44f))
### [`v30.4.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.4.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.4.1...v30.4.2)
##### Bug Fixes
- **`check-param-names`, `require-param`:** support nested array destructuring ([4f73e9c](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4f73e9c0807c38a91f7b0f9c6c8ddbbcc0c931e8))
### [`v30.4.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.4.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.4.0...v30.4.1)
##### Bug Fixes
- **`check-param-names`, `require-param`:** properly check object parameters with default values; fixes [#635](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/635) ([7fc84e9](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7fc84e9ddaa76984340ea64cc6ee6541ee1c64ba))
### [`v30.4.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.4.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.3...v30.4.0)
##### Features
- **`require-example`:** add `exemptNoArguments` option ([#634](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/634)) ([c750c86](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c750c862670b3fa2c74e79551f4231348328e1eb))
### [`v30.3.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.2...v30.3.3)
##### Bug Fixes
- **`require-param`, `check-param-names`:** check deeply destructured parameters (fixes [#569](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/569)) ([#630](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/630)) ([428174d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/428174d4cc4fe07747a08094dc060a9ca46ed27b))
### [`v30.3.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.1...v30.3.2)
##### Bug Fixes
- **`check-examples`:** disable `jsdoc/require-file-overview` by default; fixes [#633](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/633) ([dd4a985](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/dd4a985bd92a1239a07f328511a01c72db4442d4))
### [`v30.3.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.0...v30.3.1)
##### Bug Fixes
- **`no-undefined-types`:** avoid checking private member of scopeManager; fixes [#629](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/629) ([d900a70](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/d900a70fd5cc71c0373644dfaab53f9a0a6b08b9))
### [`v30.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.4...v30.3.0)
##### Bug Fixes
- **`no-bad-blocks`:** allow TypeScript directive comments ([41dcc19](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/41dcc19eabe345c809c35132e0c0dc6fffe99acd))
##### Features
- **`no-bad-blocks`:** make ignored tags customizable ([a1e0c13](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a1e0c13ea2e4ba0c5f78d5fecfdeccc16e5d635f))
### [`v30.2.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.4)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.3...v30.2.4)
##### Bug Fixes
- **`check-param-names`:** avoid erring upon `TSCallSignatureDeclaration`; fixes [#624](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/624) ([8341f97](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8341f97014449b7054750c630c99cff9a6f4e3b6))
### [`v30.2.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.2...v30.2.3)
##### Bug Fixes
- **`no-defaults`:** adjust fixed AST to fully unset `default` as new `comment-parser` adjustment would otherwise not wholly remove the default; also updates devDeps and tests use of opening jsdoc; fixes [#568](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/568) ([5cbc823](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/5cbc8231d83dd6c30f398c7e994e3b3fc9f88573))
### [`v30.2.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.1...v30.2.2)
##### Bug Fixes
- **`valid-types`:** Parse multiple names in `template` tags for non-jsdoc modes; fixes [#622](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/622) ([7818dde](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7818dde69f5f717fee19b51172116e2edaeabd31))
### [`v30.2.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.0...v30.2.1)
##### Bug Fixes
- **`check-examples`:** disable jsdoc/require-jsdoc ([88c93bb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/88c93bb81841aed1e80a1b2f5fe6601ddf66df2d))
### [`v30.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.1.0...v30.2.0)
##### Features
- **`require-param`:** add `checkDestructuredRoots` option; fixes [#616](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/616) ([3c06f09](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/3c06f0967ac62aee8f6d281a153d36ddbe02e99d))
### [`v30.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.3...v30.1.0)
##### Features
- **`check-param-names`:** add `checkDestructured` option to allow disabling of destructured checking; fixes part of [#616](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/616) ([c4d1b80](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c4d1b801e86da183a2d5ff2adb10ddf0a0eae756))
### [`v30.0.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.2...v30.0.3)
##### Bug Fixes
- **`require-jsdoc`:** handle `MethodDefinition` context without erring when using `exemptEmptyFunctions` and `exemptEmptyConstructors`; fixes [#613](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/613) ([08b5820](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/08b5820cb9e27307123828785883a50f12a1b3b6))
### [`v30.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.1...v30.0.2)
##### Bug Fixes
- **`require-jsdoc`:** ensure conditionally checking `Property`/`ObjectProperty`/`ClassProperty` as parents for arrow function expressions; fixes [#612](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/612) ([eac8357](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/eac8357c0ea7d82a1def12eb914ef5d71faab1c9))
### [`v30.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.0...v30.0.1)
##### Bug Fixes
- **`require-jsdoc`:** avoid error with `checkConstructors: false` when attempting to check tags; fixes [#611](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/611) ([854fb24](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/854fb244be890d5ca5af98bd678580256ca7b984))
### [`v30.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.2.0...v30.0.0)
##### Features
- **`check-types`, `no-undefined-types`, `valid-types`:** Add `structuredTags` setting to control whether the type and namepath portions should be checked for validity and whether such portions are required, and to let user-defined "namepath-defining" tags be added to defined types. Closes [#481](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/481) ([89f2ad0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/89f2ad0f531bcba4b9c7ddf6385eac62f904c479))
- **`valid-types`:** change `allowEmptyNamepaths` default to `false`, ensuring tags which expect names per docs will be reported ([842381a](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/842381a84b5c93594672c105c75538669eb1f732))
##### BREAKING CHANGES
- **`check-types`, `no-undefined-types`, `valid-types`:** Drops `checkSeesForNamepaths` setting. Use `{settings: {jsdoc: {structuredTags: {name: 'namepath', type: false, required: ['name'],}}}}` instead.
Also:
1. Clarifies in more cases where a problem is specific to the mode or not
2. Reports simultaneous invalid name *and* type errors
3. `typdef` now requires `allowEmptyNamepaths: false,` to report empty names (as with other tags)
4. Requires a name for `event` and `external` (and `extends` in jsdoc mode); some tweaking of other tags per docs
### [`v29.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.2.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.4...v29.2.0)
##### Features
- **`require-description`:** report more precisely the action to take when "body" `descriptionStyle` is set and where user has a desc/description tag; fixes [#608](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/608) ([#609](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/609)) ([69fd79d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/69fd79d85c70278d7a199efe7e3d2578fd331346))
### [`v29.1.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.4)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.3...v29.1.4)
##### Bug Fixes
- **`check-types`, `no-undefined-types`, `valid-types`:** In jsdoc mode, ensure `this` only checked for namepath; in TypeScript or Closure, ensure `this` checked only for type ([ef7b294](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/ef7b29451277e06a79bc24510bf27a6e90b8a176))
- **`check-types`, `no-undefined-types`, `valid-types`:** In TypeScript or Closure, add `template` for checking of optional type and namepath ([e305cce](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e305ccedb2e0dd4c0e434f5f7cf9bb753882070f))
### [`v29.1.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.3)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.2...v29.1.3)
##### Bug Fixes
- with fixers, create proper inner indent (of an additional space) when a tab is in use; fixes [#607](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/607) ([4dfbc8d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4dfbc8df497013075028a3964bd546f45fa3abda))
### [`v29.1.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.2)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.1...v29.1.2)
##### Bug Fixes
- **`check-param-names`:** ensure mismatching quoted vs. non-quoted tag name is not treated as an extra property ([0c1c763](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0c1c763346269195b376d23bd4e95c6ecede5209))
- **`require-param`:** Object destructuring in function parameters if key is string | number (quoted or otherwise) ([1842fd2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1842fd2186a479477b00b542fd81b495cb0be726))
### [`v29.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.0...v29.1.1)
##### Bug Fixes
- Object destructuring in function parameters if key is string ([#599](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/599)) ([64e1b64](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/64e1b64beb18867f6c6973c579756c2d20a84a74))
### [`v29.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.0.0...v29.1.0)
##### Features
- **`check-types`:** allow two types (set one to the other in `preferredTypes`); make this the default for typescript with "object"/"Object" ([82ca868](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/82ca86899f1dd25e9ccc9814a676e6e249ca26c5))
### [`v29.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.0.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.7.0...v29.0.0)
##### chore
- update `jsdoctypeparser` ([96dcdce](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/96dcdced66c9a8cfab09387dd76b752cb79d0718))
##### BREAKING CHANGES
- 1. Adds spaces between union items per jsdoctypeparser update.
2. Removes JSDuck support (unions with "/" instead of "|")
Also adds support in typescript mode for `readonly` and intersections (`X & Y`)
### [`v28.7.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.7.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.6.1...v28.7.0)
##### Features
- **`require-jsdoc`:** add `exemptEmptyConstructors` and set `true` as default; fixes [#600](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/600) ([5409f25](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/5409f25a72134b77ae8fdb8772b59036a6de9970))
### [`v28.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.6.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.6.0...v28.6.1)
##### Bug Fixes
- **`require-throws`:** arrow function expressions should check body only; fixes [#597](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/597) ([e5387f1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e5387f17545892bee994915f623ba30ccaf3021d))
### [`v28.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.6.0)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.5.1...v28.6.0)
##### Features
- **`require-jsdoc`:** add `enableFixer` option; if set to `false`, will avoid fixer; fixes [#372](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/372) ([c39fd75](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c39fd758fe5f4f557d5dac0b69c661ab583f0d18))
### [`v28.5.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.5.1)
[Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/
Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
â™» 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.
[ ] If you want to rebase/retry this PR, check this box.
This PR contains the following updates:
23.0.0
->35.2.0
Release Notes
gajus/eslint-plugin-jsdoc
### [`v35.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.3...v35.2.0) ##### Features - **`no-missing-syntax`, `no-restricted-syntax`, etc.:** assume `any` context if `context` omitted ([2dcd9ad](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2dcd9ad062b825c06b1e694c97ed802db50e071f)) ### [`v35.1.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.2...v35.1.3) ##### Bug Fixes - **`require-jsdoc`:** `exemptEmptyFunctions` option could trigger problematic return value checking behavior with no-argument functions ([3089a92](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/3089a921ac090dac32fd5289f7e5b519c3d57917)) ### [`v35.1.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.1...v35.1.2) ##### Bug Fixes - update jsdoc-type-pratt-parser ([1745fca](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1745fcaa960dbd97086f2c83f508a5f085acf9ec)) ### [`v35.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.1.0...v35.1.1) ##### Bug Fixes - update `jsdoc-type-pratt-parser` (liberalizes ID start to support underscores and start/continue to support other Unicode) ([1a6de5e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1a6de5ed9a2aa64f8b095953de38635d3459e0e2)) ### [`v35.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v35.0.0...v35.1.0) ##### Bug Fixes - **`no-missing-syntax`, `no-restricted-syntax`:** support "any" with comment including global comments ([dc641cc](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/dc641cc129d3964488e30b45388dc3351060cad4)) ##### Features - use `jsdoc-type-pratt-parser` ([647d47e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/647d47e5f6b392a60287b39f8799fa92b229190e)) ### [`v35.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v35.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.8.2...v35.0.0) ##### Bug Fixes - **`multiline-blocks`:** Enable (`noZeroLineText` and `noFinalLineText` will apply by default) ([b81e25d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b81e25d14d05c5c65992c9e6f34386fdf14e8d8d)) ##### BREAKING CHANGES - **`multiline-blocks`:** Should have been enabled by default Also adds newer rules to doc listing ### [`v34.8.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.8.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.8.1...v34.8.2) ##### Bug Fixes - **`check-line-alignment`:** add multiline type workaround ([#744](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/744)); fixes part of [#743](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/743) ([9928298](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9928298301a7cec0dfef0dcb786c065b5e08dfcd)) ### [`v34.8.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.8.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.8.0...v34.8.1) ##### Bug Fixes - **`tag-lines`:** avoid false positive for "never" when line break occurs in the middle of a tag description. ([3496011](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/34960110f0480e953432f305929cb8e22285f2f4)) - **`tag-lines`:** ensure a middle-of-block empty line doesn't suppress "always" errors ([33aa921](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/33aa92155ed96acb0509546c5cafb816daa73bb7)) ### [`v34.8.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.8.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.7.0...v34.8.0) ##### Features - **`tag-lines`:** add `tags` option to override behavior on a tag-specific basis (including only applying to tag(s)); fixes [#734](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/734) ([6e5e76d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6e5e76d05253d4ce2b097fd9c4d8fb27840c585e)) ### [`v34.7.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.7.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.3...v34.7.0) ##### Features - **`multiline-blocks`:** add `noFinalLineText` option; fixes [#738](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/738) ([03d3f40](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/03d3f40551bfb7cc13f00677e38baff83d13c9f4)) ### [`v34.6.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.2...v34.6.3) ##### Bug Fixes - **`multiline-blocks`:** fix merging of lines to prevent removal of spaces, though removing where needed ([9af6e36](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9af6e3615f318f92d2e108fe5d7a03b837d89ed7)) ### [`v34.6.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.1...v34.6.2) ##### Bug Fixes - **`multiline-blocks`:** ensure `noZeroLineText` checks when `noMultilineBlocks` is `true` but not matching; fixes [#737](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/737) ([19f60ac](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/19f60acf7be67f9abb12307157ab122ccf2c29ac)) ### [`v34.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.6.0...v34.6.1) ##### Bug Fixes - **`no-multi-asterisks`:** avoid false positives and erring in fixer of single line blocks; fixes [#735](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/735) ([355da58](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/355da58e86fc1127ca86a556bdd74966f694b802)) ### [`v34.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.6.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.5.0...v34.6.0) ##### Features - `no-multi-asterisks` rule to prevent multiple asterisks with middle delimiters or at end of blocks ([8848246](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8848246d2475184f98c3e0ccde85955cef75ee94)) ### [`v34.5.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.5.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.4.0...v34.5.0) ##### Features - **`multiline-blocks`:** allow control of how and whether jsdoc blocks can be expressed as single or multiple line blocks ([06bbf37](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/06bbf37183fb33bf2e6610a01d841008f2b5bd2b)) ### [`v34.4.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.4.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.3.0...v34.4.0) ##### Features - new rule `tag-line`; fixes [#93](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/93) ([851e3fe](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/851e3feed6849f1f9a5c76d7e14379a4018973f9)) ### [`v34.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.3.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.2.2...v34.3.0) ##### Features - **`check-values`:** ensure `[@variation](https://togithub.com/variation)` is a positive integer ([56577ce](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/56577cee2cb7b1abe26e67e07cafea02e0770f54)) ### [`v34.2.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.2.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.2.1...v34.2.2) ##### Bug Fixes - **`check-param-names`:** adjusts line numbers to be nearer problematic item ([e6c9ab2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e6c9ab27f41347475263a946c4ad3a0319aa89af)) - **`no-missing-syntax`:** pass in missing `comment` ([a977896](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a9778964a81ce36a54b71eb0a640ca7613013dd3)) ### [`v34.2.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.2.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.2.0...v34.2.1) ##### Bug Fixes - **`require-description`, `require-example`:** for missing description, use tag line number ([310ea75](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/310ea7506cbb0a991447dad63a133518a0c0a8e8)) ### [`v34.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.1.0...v34.2.0) ##### Features - **`no-bad-blocks`:** add `preventAllMultiasteriskBlocks` boolean option to allow reporting of any multi-asterisked multiline comments ([9669fc3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9669fc331bcd9cb7324301de58661b9a372bc7ee)) ### [`v34.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.0.2...v34.1.0) ##### Features - **`check-line-alignment`:** add `preserveMainDescriptionPostDelimiter` option to preserve left-hand side spacings in the main description when using the `always` option. ([54dac34](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/54dac3493d76461065c461e039433e51e2816d21)) ### [`v34.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.0.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.0.1...v34.0.2) ##### Bug Fixes - **`no-bad-blocks`:** avoid allowing 3+ asterisks with tag content (as with only 1 asterisk) ([28397c7](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/28397c7ed54b34a320a9d3961131da2dbf87c534)) ### [`v34.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.0.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v34.0.0...v34.0.1) ##### Bug Fixes - multiline tag fixers omitting subsequent tag lines with new command-parser API ([8fa7f9b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8fa7f9bba4b2704f776eabc0463b6719bb0dfcdf)) ### [`v34.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v34.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.3.0...v34.0.0) ##### chore - require engines Node 12+ ([#726](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/726)) ([a0ee0a6](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a0ee0a66dcffd49dc4e1d2b6315795151ee19aa1)) ##### BREAKING CHANGES - Also: - Build: Switch to Node 12 target - Linting: Use `flat` API - Travis: Add Node 16, remove Node 10 - npm: Update devDep. ### [`v33.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.3.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.2.0...v33.3.0) ##### Features - **`check-line-alignment`:** allow `tags` option to apply with "always"; [#703](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/703) ([4421e4e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4421e4eac3328c7d1b0c9d8684c1d655c3560aa7)) ### [`v33.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.1.1...v33.2.0) ##### Features - add require-asterisk-prefix rule ([#446](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/446)) ([f892338](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/f8923387b25f9140ccfde52fa35b5fc345c4437f)), closes [#199](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/199) ### [`v33.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.1.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.1.0...v33.1.1) ##### Bug Fixes - update jsdoccomment to surface fixes ([7de397b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7de397b91e221b44221ed631cc15c83fe1d8e8ae)) ### [`v33.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v33.0.0...v33.1.0) ##### Features - support comment-selector-based contexts ([f73c72c](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/f73c72c361e704bd600b1c9fc41203c66966fc55)) - support comment-selector-based contexts ([6e835fd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6e835fda2a8eb5aece69b169b7721735044f6e2b)) ### [`v33.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v33.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.4...v33.0.0) ##### chore - use external `@es-joy/jsdoccomment` for `getJSDocComment` functionality ([aa77e3b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/aa77e3bdbcf3d5c1642f78825bbcd3e6b6edae85)) ##### BREAKING CHANGES - Should only be breaking for anyone requiring the `getJSDocComment` file. Also updates Babel devDeps. ### [`v32.3.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.4) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.3...v32.3.4) ##### Bug Fixes - preserve newlines in tag description comparisons; fixes [#692](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/692) ([7edaed3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7edaed3f9624a27cd78c3286a0be833224b0a7df)) ### [`v32.3.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.2...v32.3.3) ##### Bug Fixes - **`require-param`, `check-param-names`:** do not fail with destructured array pattern containing empty slots; fixes [#716](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/716) ([f19e706](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/f19e70618c962b855402fc1cef4911ba38357a87)) ### [`v32.3.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.1...v32.3.2) ##### Bug Fixes - **`check-line-alignment`:** prevent false never reporting where a space is present (post tag) followed by missing space (from a wholly missing type) and then a space (but a space first preceded by content (a name); fixes [#714](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/714) ([2c31db1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2c31db1413874f08faa634970266f383ceed0f25)) ### [`v32.3.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.3.0...v32.3.1) ##### Bug Fixes - **`check-examples`:** disable chai-friendly/no-unused-expressions for default expression rules ([06f0112](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/06f0112f76f0eb55b9e1b92703a270be8797d146)) ### [`v32.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.3.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.2.0...v32.3.0) ##### Features - **`check-tag-names`:** jsxTags an opt-in option for jsx annotations ([8afb9fc](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8afb9fc75d203d278d21f5d4ca0d8437aad21668)) ### [`v32.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.1.1...v32.2.0) ##### Features - **`check-types`:** check `settings.jsdoc.structuredTags` for an array of permissible types, reporting if not present; fixes [#695](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/695) ([9dad3e0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9dad3e08116a1950578d4f85e3acfc86b10b60f6)) - **`no-undefined-types`:** allow `structuredTags` types to be auto-defined ([b7198e4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b7198e47b79d1a9936e032f43c66b4af730bfeb4)) ### [`v32.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.1.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.1.0...v32.1.1) ##### Bug Fixes - **`check-param-names`, `require-jsdoc`, `require-param`:** avoid erring upon `MemberExpression` or other constructions within dynamic properties; fixes [#699](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/699) ([1cfdeb4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1cfdeb4446a47848db5eb039342da9d9ff187626)) ### [`v32.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.3...v32.1.0) ##### Features - **`require-jsdoc`:** allow checking for getter or setter only; fixes [#515](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/515) ([937d65e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/937d65ed6c0a8e0d34985de25072f988c1fe28e5)) ### [`v32.0.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.2...v32.0.3) ##### Bug Fixes - **`require-jsdoc`:** more accurate and optimized decorator detection; fixes [#697](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/697) ([88655b3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/88655b32a68718f4d010843dba2d5aa683afe638)) ### [`v32.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.1...v32.0.2) ##### Bug Fixes - **`match-description`:** while preserving internal newlines, ensure trailing whitespace is stripped for comparisons; for [#692](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/692) ([27b95b3](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/27b95b35a37916a69f9ea1dd75285e2f18a5f278)) ### [`v32.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v32.0.0...v32.0.1) ##### Bug Fixes - default to `u` flag for `checkTypesPattern` option for `require-param`, `check-param-names`; for `check-values`, default to `u` flag and allow slashed regexes with own flags; for `match-description`, allow slashed regexs with own flags; for all of the previous (and `check-examples`) allows newlines ([4f0dc8e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4f0dc8ee7d50860050eccf7b0484d409315c006b)) ### [`v32.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v32.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.6.1...v32.0.0) ##### Bug Fixes - **check-examples:** change default extension for simulated file name of `[@example](https://togithub.com/example)` from `md` to `md/*.js`. Only applies when `matchingFileName` is not used. ([2cc1227](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2cc12279f35f0136e6b3a68c7d19ae8719e7a061)) ##### BREAKING CHANGES - **check-examples:** Per update to `eslint-plugin-markdown` v2 and its support of ESLint 7's new processor API, fenced blocks can (and must) be targeted separately from the Markdown parent file as a whole, so in order to allow the same `overrides` config to be reusable between Markdown fenced blocks and `@example` tags (since one often wishes to disable the same kind of rules for each, being as that each may deliberately lack full context, e.g., undefined or unused variables), we update the default simulated extension set for `@example` tags by `check-examples` to simulate an expression which will now be a suitable choice for `overrides` in targeting Markdown fenced blocks using the new parser API, as with eslint-plugin-markdown@2 (i.e., "md/\*.js" instead of "md"). If you need to use ESLint 6 (or eslint-plugin-markdown < 2, for example) with `check-examples`, you should be able to manually supply the `matchingFileName` option targeting "md", e.g., set to `'dummy.md`. This commit also simplifies a testing example to avoid it throwing with changed config not having proper babel support (not meaningful to test anyways) ### [`v31.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.6.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.6.0...v31.6.1) ##### Bug Fixes - update `comment-parser`; fixes [#686](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/686) ([7e0bbbe](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7e0bbbe82eb4a1d0b0c603ed0c78bd6e685dee20)) ### [`v31.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.6.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.5.0...v31.6.0) ##### Bug Fixes - **`require-returns`, `require-yields`:** support more AST checking ([6fd8a07](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6fd8a070c12a30eec8ccca5486446a06331a3d45)) - **`require-yields`:** avoid checking nested generators (as with functions) ([b9058e4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b9058e493640289e4a585e48a2dad810f0c170a4)) - **`return-yields`, `return-yields-check`:** allow generator detection on exported; handle more AST types; fixes [#682](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/682) ([4e768aa](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4e768aaed4c9fd28496af910e147183a950ce6a1)) ##### Features - **`require-returns-check`:** add `exemptAsync` option ([0ed24c0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0ed24c049919757c15ec80e06e4be8686524c47b)) ### [`v31.5.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.5.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.4.0...v31.5.0) ##### Bug Fixes - **`require-returns`:** check labeled statements ([51f37f1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/51f37f10774ff3d9cd33faecdf829e83610700c5)) - **`require-throws`:** check labeled statements ([ceadcfe](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/ceadcfe7fed67af579fb2de6fb0df8aefe37a115)) - **`require-yields`:** check `test` part of if expression and check conditionals ([db001be](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/db001bebad9ef1b5a27297142fd328cbcc86759f)) - **`require-yields`:** check labeled statements ([aceb7a0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/aceb7a096fadc13939163ec1b77b03e771002477)) ##### Features - **`require-returns`:** if function returns a Promise whose executor resolves with undefined, avoid need to document unless `forceReturnsWithAsync` is set; fixes [#550](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/550) ([565fdbd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/565fdbd410db2127f8272d0896a6768a4a8c95d0)) ### [`v31.4.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.4.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.3...v31.4.0) ##### Bug Fixes - **`check-line-alignment`:** escape user tag name in regex ([c0ae4cb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c0ae4cb193f643b321329d008d4eff80d4ea485a)) ##### Features - **`check-line-alignment`:** allow `tags` option to configure which tags should be aligned. ([780b8b5](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/780b8b50888db2196ec420157b9d3092c202b079)) ### [`v31.3.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.2...v31.3.3) ##### Bug Fixes - **`check-line-alignment`:** apply alignment to return tags and avoid possibility for "never" option to insert extra space with `returns`/`return` as well as handle missing type ([cb39556](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/cb39556cb69be6c9a32e8a2acd725bcd2f354d31)) ### [`v31.3.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.1...v31.3.2) ##### Bug Fixes - while a fix provided for decorator detection and useful for inserting empty jsdoc blocks when fixers are enabled, it appears to have a 25% or so degradation in performance when tested with a large repository, so reverting. ([e08d889](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e08d8891ffbfe15b78830ea6b10230e12df13906)) ##### Reverts - Revert "optimize: ensure with new fix that we avoid checking back too far" ([0fc4663](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0fc466363224e45d2e9b638f124782e0e0d4c40d)) ### [`v31.3.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.3.0...v31.3.1) ##### Bug Fixes - bug with false positive decorator detection (evident sans semi-colons); e.g., `require-jsdoc` fixer ([6bda6b4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6bda6b47d267982914581bfc03b4de50c9d0da07)) ### [`v31.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.3.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.3...v31.3.0) ##### Features - **`check-param-names`:** add options `disableExtraPropertyReporting` to allow extra properties to be documented without error (as long as there are no siblings destructured as for such cases, they will still be expected since the function is not using them) ([8b2d143](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8b2d143e6201fe271b45debbc6c43bcabc03f6a1)) ### [`v31.2.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.2...v31.2.3) ##### Bug Fixes - **`require-param`, `check-param-names`:** add option `useDefaultObjectProperties` for expecting documentation or avoiding reporting of documented; addresses part of [#676](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/676) ([a36faf2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a36faf24005346e0d07cb43c1128ba4ced658b0a)) ### [`v31.2.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.1...v31.2.2) ##### Bug Fixes - **`check-tag-names`:** should have previously auto-allowed `settings.jsdoc.structuredTags` tags ([5f586fd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/5f586fdc10d4619ea98242900ae1444d2babe018)) ### [`v31.2.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.2.0...v31.2.1) ##### Bug Fixes - caps issue with require-yields-check rule ([6b8d0d8](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6b8d0d826f08655393eacc29d8d90470fa014571)) ### [`v31.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.1.0...v31.2.0) ##### Features - **`require-yields-check`:** add rule to check that `yield` (of proper form) is present in the function body; fixes [#354](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/354) ([acf9529](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/acf95295b62bfb3a88af93df36c350204604d439)) ### [`v31.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.8...v31.1.0) ##### Features - **`require-yields`:** add new rule to check that `yield` has documentation; for [#354](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/354) ([e06fddd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e06fddd65a6529ad683dae0ad0dbb903e78a7fc6)) - **`require-yields`:** add options to check that `next` has documentation ([15daa12](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/15daa12ef23ee4f51d6dbe8385cccdaf868668df)) ### [`v31.0.8`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.8) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.7...v31.0.8) ##### Bug Fixes - **`no-undefined-types`:** support `true` and `false` literals ([b8cb394](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b8cb394876af03512791a44c9efad10d46e43703)) ### [`v31.0.7`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.7) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.6...v31.0.7) ##### Bug Fixes - ensure accurate parsing of names after multi-line types; fixes [#669](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/669) ([7b9c1bd](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7b9c1bd8766b60df55dc324ec4848dbb9020eb7c)) ### [`v31.0.6`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.6) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.5...v31.0.6) ##### Bug Fixes - update `comment-parser` to surface restoration of support for equal signs in defaults and multi-line types; fixes [#669](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/669); fixes [#673](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/673) ([081d7eb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/081d7eb63eb5b1022f2ce6a93760ab82f13a8307)) ### [`v31.0.5`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.5) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.4...v31.0.5) ##### Bug Fixes - **`require-description-complete-sentence`:** regression re: not trimming of description for check as relevant to tag description checking; fixes [#672](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/672) ([d81caa2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/d81caa2ee88610e4c7c015bc84ad712e3f57d3cd)) ### [`v31.0.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.4) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.3...v31.0.4) ##### Bug Fixes - restore trim as relevant to tag description checking; fixes [#670](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/670) ([9f69c36](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9f69c366e3da081c27b93b7954d7c5e4d15932e4)) ### [`v31.0.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.2...v31.0.3) ##### Bug Fixes - **`newline-after-description`:** handle description on same line as opening asterisks; fixes [#668](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/668) ([040d177](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/040d1773983aef155f40b63fe9af3a2689eec0ed)) ### [`v31.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.1...v31.0.2) ##### Bug Fixes - **`check-line-alignment`:** implement default `never` options; fixes [#483](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/483) ([b2db226](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/b2db2266c15510ab0f8155831a0fbc1128e717bd)) ### [`v31.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v31.0.0...v31.0.1) ##### Bug Fixes - **`check-line-alignment`:** handle spaces in type and skip for single line ([@renatho](https://togithub.com/renatho)); closes [#638](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/638) ([577863b](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/577863bbb2bbceaa8daa9bf83b7b0c26a6836e33)) ### [`v31.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v31.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.13...v31.0.0) ##### chore - update comment-parser; should now cause fixers to preserve original whitespace unless the rule is meant to fix it ([095ff36](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/095ff3670c5a1332ec6a6d251d8355c16a41627e)) ##### BREAKING CHANGES - Tests are not breaking, but as changing the fundamental parser, forcing major bump to be safe. Also updates: 1. `require-description-complete-sentence` - test to fix output 2. `require-hyphen-before-param-description` - test to preserve whitespace in fixed output (though still minus hyphen) 3. `require-param` - test preserving whitespace 4 `require-jsdoc` - test with no indent ### [`v30.7.13`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.13) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.12...v30.7.13) ##### Bug Fixes - **`require-hyphen-before-param-description`:** regression failing to only check for hyphen at beginning; fixes [#665](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/665) ([acc3fc1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/acc3fc1c577527ade66f2fa0f4001ea717bfb03a)) ### [`v30.7.12`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.12) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.11...v30.7.12) ##### Bug Fixes - **`require-jsdoc`:** skip past type annotations when seeking backward through decorators; fixes [#659](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/659) ([62abd11](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/62abd1102fc1b953106f03690766f5b84ccdf39b)) ### [`v30.7.11`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.11) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.10...v30.7.11) ##### Bug Fixes - **`no-bad-blocks`:** avoid erring with `/* */` comment ([4e6c73d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4e6c73d87204d0caf24fd210b352fb76172eb2ce)) ### [`v30.7.10`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.10) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.9...v30.7.10) ##### Bug Fixes - **`check-examples`:** disable `no-new` for `check-examples` and default param checking ([590d54e](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/590d54e4b4deed2963092da24e38dcb5a71a22f8)) - **`require-hyphen-before-param-description`:** allow whitespace before hyphen when checking for hyphens; fixes [#664](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/664) ([fb906de](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/fb906ded845afb73cbe0047a5ab4b0f7bb96b666)) ### [`v30.7.9`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.9) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.8...v30.7.9) ##### Bug Fixes - **`no-undefined-types`:** allow `this`; fixes [#660](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/660) ([bda5959](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/bda59595c03d7e2b6a596e6864d883d84f04a618)) ### [`v30.7.8`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.8) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.7...v30.7.8) ##### Bug Fixes - **`check-examples`:** allow multiline captions; fixes [#655](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/655) ([8963394](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8963394ee5d5712532607a19b6ab7605d24c5c48)) ### [`v30.7.7`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.7) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.6...v30.7.7) ##### Bug Fixes - **`require-jsdoc`:** regression causing uncommented nested syntax to be reported with `publicOnly` even when export was commented; fixes [#654](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/654) ([bcd465f](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/bcd465f5e1e501865a29827655032984c926abf1)) ### [`v30.7.6`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.6) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.5...v30.7.6) ##### Bug Fixes - **`check-examples`:** disable strict for expressions ([245e4a7](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/245e4a7bcba900ccd971175be91324df1b9c0236)) ### [`v30.7.5`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.5) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.4...v30.7.5) ##### Bug Fixes - ensure all rules marked with recommended status; add table property for recommended status; fixes [#652](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/652) ([4e699c4](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4e699c4d2b36fd27cd70905fbc178ce7fe9c2448)) ### [`v30.7.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.4) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.3...v30.7.4) ##### Bug Fixes - **match-description, no-undefined-types, require-description-complete-sentence, require-hyphen-before-param-description, valid-types:** parse `template` properly; fixes [#653](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/653) ([122a9b5](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/122a9b54f8bd93652edf451d014060ef39379dc1)) ### [`v30.7.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.2...v30.7.3) ##### Bug Fixes - **`check-examples`:** Check defaults, params, properties as expressions ([6163f3c](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6163f3c7f8ae8a9ddffcf8736846632d86e566d6)) ### [`v30.7.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.1...v30.7.2) ##### Bug Fixes - **`check-examples`:** use `jsdoc-defaults`, `jsdoc-params`, and `jsdoc-properties` as default extensions to allow these to have their own overrides ([39fb1cb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/39fb1cbaba7d119685d04f37301c0eae9c08fe0e)) ### [`v30.7.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.7.0...v30.7.1) ##### Bug Fixes - **`check-examples`:** Set `checkDefaults`, `checkParams`, `checkProperties` defaults to `false` ([2de1011](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2de1011a60fdac8fab619a313395947819566c2c)) ### [`v30.7.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.7.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.5...v30.7.0) ##### Features - **`check-examples`:** add options `checkDefaults`, `checkParams`, `checkProperties`; fixes [#473](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/473) ([262a474](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/262a47405eeec5cc2e6ef7510702a008ad573d55)) ### [`v30.6.5`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.5) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.4...v30.6.5) ##### Bug Fixes - **`valid-types`:** Ensure `module` tag operates as though `module:` prefix is present (so as to create valid namepath when valid); fixes [#649](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/649) ([2e0f2a6](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2e0f2a620f1e57cd3a69d33e4421b9d482bd8148)) ### [`v30.6.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.4) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.3...v30.6.4) ##### Bug Fixes - **`require-jsdoc`:** for publicOnly ESM, adds direct ancestor check, allowing, e.g., `TSPropertySignature` and `TSMethodSignature`; fixes [#647](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/647) ([2b55275](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/2b55275e106a1f20436efa3caa87ebe7d9e409eb)) ### [`v30.6.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.2...v30.6.3) ##### Bug Fixes - **`require-jsdoc`:** Avoid error when comment block above export of `TSDeclareFunction`; fixes [#645](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/645) ([0b95ba5](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0b95ba5d497c8a91a40d2a5cb73dae3ccb0d6d60)) ### [`v30.6.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.1...v30.6.2) ##### Bug Fixes - **`require-jsdoc`:** support `TSTypeAliasDeclaration` with `publicOnly` ([42a9b35](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/42a9b3575b57d0692c54a0e77f023d7531d89c68)) ### [`v30.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.6.0...v30.6.1) ##### Bug Fixes - **`require-jsdoc`:** support `TSInterfaceDeclaration` with `publicOnly` ([3ae8e61](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/3ae8e61cb6d5c9e12d6f1d4f535380b304931014)) ### [`v30.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.6.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.3...v30.6.0) ##### Features - add `ignoreInternal` setting to ignore blocks with `[@internal](https://togithub.com/internal)` tags; fixes [#639](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/639) ([80e16d0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/80e16d0f9bd024e5e77b78af1ba91a700f7919f2)) ### [`v30.5.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.2...v30.5.3) ##### Bug Fixes - **`no-bad-blocks`:** ensure reports bad blocks with descriptions ([9a56863](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/9a568638f59960c8008fc2d03e4d83252a1e3072)) ### [`v30.5.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.1...v30.5.2) ##### Bug Fixes - **`require-jsdoc`:** allow `contexts` to be usable in place of `require` items ([a1d95e6](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a1d95e67e7c4c22e5e477458f3a0d6f836151f01)) - **`require-jsdoc`:** support `TSEnumDeclaration` with `publicOnly`; fixes [#640](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/640) ([63ef3bc](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/63ef3bcd16558663abc7dada4f7abc0e9bd668ba)) ### [`v30.5.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.5.0...v30.5.1) ##### Bug Fixes - rename rule as intended to `check-line-alignment` ([ec71632](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/ec71632eba1e43fd13cd7c4f50b6c0a8392ad778)) ### [`v30.5.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.5.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.4.2...v30.5.0) ##### Features - **`check-line-alignment`:** add rule for line alignment ([#636](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/636)) ([6e2b99d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/6e2b99da1a0e3e65bfa6eefb7b127b3d30c6e44f)) ### [`v30.4.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.4.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.4.1...v30.4.2) ##### Bug Fixes - **`check-param-names`, `require-param`:** support nested array destructuring ([4f73e9c](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4f73e9c0807c38a91f7b0f9c6c8ddbbcc0c931e8)) ### [`v30.4.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.4.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.4.0...v30.4.1) ##### Bug Fixes - **`check-param-names`, `require-param`:** properly check object parameters with default values; fixes [#635](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/635) ([7fc84e9](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7fc84e9ddaa76984340ea64cc6ee6541ee1c64ba)) ### [`v30.4.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.4.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.3...v30.4.0) ##### Features - **`require-example`:** add `exemptNoArguments` option ([#634](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/634)) ([c750c86](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c750c862670b3fa2c74e79551f4231348328e1eb)) ### [`v30.3.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.2...v30.3.3) ##### Bug Fixes - **`require-param`, `check-param-names`:** check deeply destructured parameters (fixes [#569](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/569)) ([#630](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/630)) ([428174d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/428174d4cc4fe07747a08094dc060a9ca46ed27b)) ### [`v30.3.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.1...v30.3.2) ##### Bug Fixes - **`check-examples`:** disable `jsdoc/require-file-overview` by default; fixes [#633](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/633) ([dd4a985](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/dd4a985bd92a1239a07f328511a01c72db4442d4)) ### [`v30.3.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.3.0...v30.3.1) ##### Bug Fixes - **`no-undefined-types`:** avoid checking private member of scopeManager; fixes [#629](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/629) ([d900a70](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/d900a70fd5cc71c0373644dfaab53f9a0a6b08b9)) ### [`v30.3.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.3.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.4...v30.3.0) ##### Bug Fixes - **`no-bad-blocks`:** allow TypeScript directive comments ([41dcc19](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/41dcc19eabe345c809c35132e0c0dc6fffe99acd)) ##### Features - **`no-bad-blocks`:** make ignored tags customizable ([a1e0c13](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/a1e0c13ea2e4ba0c5f78d5fecfdeccc16e5d635f)) ### [`v30.2.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.4) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.3...v30.2.4) ##### Bug Fixes - **`check-param-names`:** avoid erring upon `TSCallSignatureDeclaration`; fixes [#624](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/624) ([8341f97](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/8341f97014449b7054750c630c99cff9a6f4e3b6)) ### [`v30.2.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.2...v30.2.3) ##### Bug Fixes - **`no-defaults`:** adjust fixed AST to fully unset `default` as new `comment-parser` adjustment would otherwise not wholly remove the default; also updates devDeps and tests use of opening jsdoc; fixes [#568](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/568) ([5cbc823](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/5cbc8231d83dd6c30f398c7e994e3b3fc9f88573)) ### [`v30.2.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.1...v30.2.2) ##### Bug Fixes - **`valid-types`:** Parse multiple names in `template` tags for non-jsdoc modes; fixes [#622](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/622) ([7818dde](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/7818dde69f5f717fee19b51172116e2edaeabd31)) ### [`v30.2.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.2.0...v30.2.1) ##### Bug Fixes - **`check-examples`:** disable jsdoc/require-jsdoc ([88c93bb](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/88c93bb81841aed1e80a1b2f5fe6601ddf66df2d)) ### [`v30.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.1.0...v30.2.0) ##### Features - **`require-param`:** add `checkDestructuredRoots` option; fixes [#616](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/616) ([3c06f09](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/3c06f0967ac62aee8f6d281a153d36ddbe02e99d)) ### [`v30.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.3...v30.1.0) ##### Features - **`check-param-names`:** add `checkDestructured` option to allow disabling of destructured checking; fixes part of [#616](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/616) ([c4d1b80](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c4d1b801e86da183a2d5ff2adb10ddf0a0eae756)) ### [`v30.0.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.2...v30.0.3) ##### Bug Fixes - **`require-jsdoc`:** handle `MethodDefinition` context without erring when using `exemptEmptyFunctions` and `exemptEmptyConstructors`; fixes [#613](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/613) ([08b5820](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/08b5820cb9e27307123828785883a50f12a1b3b6)) ### [`v30.0.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.1...v30.0.2) ##### Bug Fixes - **`require-jsdoc`:** ensure conditionally checking `Property`/`ObjectProperty`/`ClassProperty` as parents for arrow function expressions; fixes [#612](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/612) ([eac8357](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/eac8357c0ea7d82a1def12eb914ef5d71faab1c9)) ### [`v30.0.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v30.0.0...v30.0.1) ##### Bug Fixes - **`require-jsdoc`:** avoid error with `checkConstructors: false` when attempting to check tags; fixes [#611](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/611) ([854fb24](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/854fb244be890d5ca5af98bd678580256ca7b984)) ### [`v30.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v30.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.2.0...v30.0.0) ##### Features - **`check-types`, `no-undefined-types`, `valid-types`:** Add `structuredTags` setting to control whether the type and namepath portions should be checked for validity and whether such portions are required, and to let user-defined "namepath-defining" tags be added to defined types. Closes [#481](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/481) ([89f2ad0](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/89f2ad0f531bcba4b9c7ddf6385eac62f904c479)) - **`valid-types`:** change `allowEmptyNamepaths` default to `false`, ensuring tags which expect names per docs will be reported ([842381a](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/842381a84b5c93594672c105c75538669eb1f732)) ##### BREAKING CHANGES - **`check-types`, `no-undefined-types`, `valid-types`:** Drops `checkSeesForNamepaths` setting. Use `{settings: {jsdoc: {structuredTags: {name: 'namepath', type: false, required: ['name'],}}}}` instead. Also: 1. Clarifies in more cases where a problem is specific to the mode or not 2. Reports simultaneous invalid name *and* type errors 3. `typdef` now requires `allowEmptyNamepaths: false,` to report empty names (as with other tags) 4. Requires a name for `event` and `external` (and `extends` in jsdoc mode); some tweaking of other tags per docs ### [`v29.2.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.2.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.4...v29.2.0) ##### Features - **`require-description`:** report more precisely the action to take when "body" `descriptionStyle` is set and where user has a desc/description tag; fixes [#608](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/608) ([#609](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/609)) ([69fd79d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/69fd79d85c70278d7a199efe7e3d2578fd331346)) ### [`v29.1.4`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.4) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.3...v29.1.4) ##### Bug Fixes - **`check-types`, `no-undefined-types`, `valid-types`:** In jsdoc mode, ensure `this` only checked for namepath; in TypeScript or Closure, ensure `this` checked only for type ([ef7b294](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/ef7b29451277e06a79bc24510bf27a6e90b8a176)) - **`check-types`, `no-undefined-types`, `valid-types`:** In TypeScript or Closure, add `template` for checking of optional type and namepath ([e305cce](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e305ccedb2e0dd4c0e434f5f7cf9bb753882070f)) ### [`v29.1.3`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.3) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.2...v29.1.3) ##### Bug Fixes - with fixers, create proper inner indent (of an additional space) when a tab is in use; fixes [#607](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/607) ([4dfbc8d](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/4dfbc8df497013075028a3964bd546f45fa3abda)) ### [`v29.1.2`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.2) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.1...v29.1.2) ##### Bug Fixes - **`check-param-names`:** ensure mismatching quoted vs. non-quoted tag name is not treated as an extra property ([0c1c763](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/0c1c763346269195b376d23bd4e95c6ecede5209)) - **`require-param`:** Object destructuring in function parameters if key is string | number (quoted or otherwise) ([1842fd2](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/1842fd2186a479477b00b542fd81b495cb0be726)) ### [`v29.1.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.1.0...v29.1.1) ##### Bug Fixes - Object destructuring in function parameters if key is string ([#599](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/599)) ([64e1b64](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/64e1b64beb18867f6c6973c579756c2d20a84a74)) ### [`v29.1.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.1.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v29.0.0...v29.1.0) ##### Features - **`check-types`:** allow two types (set one to the other in `preferredTypes`); make this the default for typescript with "object"/"Object" ([82ca868](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/82ca86899f1dd25e9ccc9814a676e6e249ca26c5)) ### [`v29.0.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v29.0.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.7.0...v29.0.0) ##### chore - update `jsdoctypeparser` ([96dcdce](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/96dcdced66c9a8cfab09387dd76b752cb79d0718)) ##### BREAKING CHANGES - 1. Adds spaces between union items per jsdoctypeparser update. 2. Removes JSDuck support (unions with "/" instead of "|") Also adds support in typescript mode for `readonly` and intersections (`X & Y`) ### [`v28.7.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.7.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.6.1...v28.7.0) ##### Features - **`require-jsdoc`:** add `exemptEmptyConstructors` and set `true` as default; fixes [#600](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/600) ([5409f25](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/5409f25a72134b77ae8fdb8772b59036a6de9970)) ### [`v28.6.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.6.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.6.0...v28.6.1) ##### Bug Fixes - **`require-throws`:** arrow function expressions should check body only; fixes [#597](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/597) ([e5387f1](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/e5387f17545892bee994915f623ba30ccaf3021d)) ### [`v28.6.0`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.6.0) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/v28.5.1...v28.6.0) ##### Features - **`require-jsdoc`:** add `enableFixer` option; if set to `false`, will avoid fixer; fixes [#372](https://togithub.com/gajus/eslint-plugin-jsdoc/issues/372) ([c39fd75](https://togithub.com/gajus/eslint-plugin-jsdoc/commit/c39fd758fe5f4f557d5dac0b69c661ab583f0d18)) ### [`v28.5.1`](https://togithub.com/gajus/eslint-plugin-jsdoc/releases/v28.5.1) [Compare Source](https://togithub.com/gajus/eslint-plugin-jsdoc/compare/Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
â™» 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.
This PR has been generated by WhiteSource Renovate. View repository job log here.