Maintained replacement for ESLint's deprecated SourceCode#getJSDocComment along with other jsdoc utilities
Last release 3 days ago
24 Aug 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
163 releases · first in 2021
Release timeline
163 releases since 202120222023202420252026
Releases
- 0.18.026 Jan 2022
Release notes2 sources agree
Open source →User-impacting
- feat: add non-visitable
endLineproperty (so can detect line number when no description present) - feat: supply
indentdefault forparseComment - fix: ensure
postNamegets a space for@templatewith a description - fix: converting JSDoc comment with tag on same line as end (e.g., single line) to AST
- chore: update
jsdoc-type-pratt-parser
Dev-impacting
- docs: add jsdoc blocks internally
- chore: update devDeps.
- test: avoid need for
expect - test: complete coverage for
commentHandler,parseCommenttests
- feat: add non-visitable
- 0.17.09 Jan 2022
Release notes2 sources agree
Open source →User-impacting
- Enhancement: Re-export
jsdoc-type-pratt-parser - Update:
jsdoc-type-pratt-parserto 2.2.1
Dev-impacting
- npm: Update devDeps.
- Enhancement: Re-export
- 0.16.09 Jan 2022
Release notes2 sources agree
Open source →User-impacting
- Update:
jsdoc-type-pratt-parserto 2.2.0
Dev-impacting
- npm: Update devDeps.
- Update:
- 0.15.08 Jan 2022
Release notes2 sources agree
Open source →User-impacting
- Update:
jsdoc-type-pratt-parserto 2.1.0
Dev-impacting
- npm: Update devDeps.
- Update:
- 0.14.23 Jan 2022
Release notes2 sources agree
Open source →User-impacting
- Fix: Find comments previous to parentheses (used commonly in TypeScript)
Dev-impacting
- npm: Update devDeps.
- 0.14.128 Dec 2021
- 0.14.028 Dec 2021
Release notes2 sources agree
Open source →User-impacting
- Update:
jsdoc-type-pratt-parserto 2.0.1
Dev-impacting
- npm: Update devDeps.
- Update:
- 0.13.09 Dec 2021
Release notes2 sources agree
Open source →User-impacting
- Update:
comment-parserto 1.3.0 - Fix: Allow comment on
ExportDefaultDeclaration
- Update:
- 0.12.022 Oct 2021
Release notes2 sources agree
Open source →User-impacting
- Update:
jsdoc-type-pratt-parserto 2.0.0 - Enhancement: Support Node 17 (@timgates42)
- Docs: Typo (@timgates42)
Dev-impacting
- Linting: As per latest ash-nazg
- npm: Update devDeps.
- Update:
- 0.11.012 Oct 2021
Release notes2 sources agree
Open source →- Update: For
@typescript/eslint-parser@5, addPropertyDefinition
- Update: For
- 0.10.825 Aug 2021
Release notes2 sources agree
Open source →User-impacting
- npm: Liberalize
enginesas percomment-parserchange - npm: Bump
comment-parser
Dev-impacting
- Linting: As per latest ash-nazg
- npm: Update devDeps.
- npm: Liberalize
- 0.10.728 Jul 2021
Release notes2 sources agree
Open source →- npm: Update comment-parser with CJS fix and re-exports
- npm: Update devDeps.
- 0.10.627 Jul 2021
Release notes2 sources agree
Open source →- Fix: Ensure copying latest build of
comment-parser's ESM utils
- Fix: Ensure copying latest build of
- 0.10.527 Jul 2021
- 0.10.427 Jul 2021
Release notes2 sources agree
Open source →- Fix: Bundle
comment-parsernested imports so that IDEs (like Atom) bundling older Node versions can still work. Still mirroring the strictercomment-parserenginesfor now, however.
- Fix: Bundle
- 0.10.327 Jul 2021
Release notes2 sources agree
Open source →- npm: Avoid exporting nested subpaths for sake of older Node versions
- 0.10.226 Jul 2021
Release notes2 sources agree
Open source →- npm: Specify exact supported range:
^12.20 || ^14.14.0 || ^16
- npm: Specify exact supported range:
- 0.10.126 Jul 2021
- 0.10.026 Jul 2021
- 0.9.0-alpha.625 Jul 2021pre-release
Release notes2 sources agree
Open source →User-impacting
- Update: For
comment-parserupdate, addlineEnd
- Update: For
- 0.9.0-alpha.524 Jul 2021pre-release
Release notes2 sources agree
Open source →User-impacting
- npm: Bump
comment-parser(for true ESM) - Update: Remove extensions for packages for native ESM in
comment-parserfix
Dev-impacting
- npm: Update devDeps.
- npm: Bump
- 0.9.0-alpha.422 Jul 2021pre-release
- 0.9.0-alpha.322 Jul 2021pre-release
Release notes2 sources agree
Open source →- Fix: Due to
comment-parserstill needing changes, revert for now to alpha.1
- Fix: Due to
- 0.9.0-alpha.222 Jul 2021pre-release
Release notes2 sources agree
Open source →User-impacting
- npm: Bump
comment-parser(for true ESM) - Update: Remove extensions for packages for native ESM in
comment-parserfix
Dev-impacting
- npm: Update devDeps.
- npm: Bump
- 0.9.0-alpha.16 Jul 2021pre-release
Release notes2 sources agree
Open source →User-impacting
- Breaking change: Indicate minimum for
enginesas Node >= 12 - npm: Bump
comment-parser
Dev-impacting
- npm: Lint cjs files
- npm: Fix eslint script
- npm: Update devDeps.
- Breaking change: Indicate minimum for
- 0.8.021 Jun 2021
Release notes2 sources agree
Open source →User-impacting
- npm: Update
jsdoc-type-pratt-parser(prerelease to stable patch)
Dev-impacting
- npm: Update devDeps.
- npm: Update
- 0.8.0-alpha.228 May 2021pre-release
- 0.8.0-alpha.124 May 2021pre-release
Release notes2 sources agree
Open source →- Breaking change: Export globally as
JsdocComment - Breaking change: Change
JSDocprefixes of all node types toJsdoc - Breaking change: Drop
jsdoctypeparserToESTree - Breaking enhancement: Switch to
jsdoc-type-pratt-parser(toward greater TypeScript expressivity and compatibility/support with catharsis) - Enhancement: Export
jsdocTypeVisitorKeys(fromjsdoc-type-pratt-parser)
- Breaking change: Export globally as
- 0.7.222 May 2021
- 0.7.122 May 2021
- 0.7.021 May 2021
Release notes2 sources agree
Open source →- Enhancement: Allow specifying
noNamesandnoTypesonparseCommentto override (or add to) tags which should have no names or types. - Enhancement: Export
hasSeeWithLinkutility anddefaultNoTypesanddefaultNoNames.
- Enhancement: Allow specifying
- 0.6.015 May 2021
- 0.5.112 May 2021
Release notes2 sources agree
Open source →- Fix: Avoid setting
variationname (just the description) (including in dist) - npm: Add
prepublishOnlyscript
- Fix: Avoid setting
- 0.5.012 May 2021
- 0.4.49 May 2021
Release notes2 sources agree
Open source →- Fix: Avoid setting
nameanddescriptionfor simple@template SomeName
- Fix: Avoid setting
- 0.4.35 May 2021
- 0.4.25 May 2021
Release notes2 sources agree
Open source →- Fix: Ensure replacement of camel-casing (used in
jsdoctypeparsernodes and visitor keys is global. The practical effect is thatJSDocTypeNamed_parameter->JSDocTypeNamedParameter,JSDocTypeRecord_entry->JSDocTypeRecordEntryJSDocTypeNot_nullable->JSDocTypeNotNullableJSDocTypeInner_member->JSDocTypeInnerMemberJSDocTypeInstance_member->JSDocTypeInstanceMemberJSDocTypeString_value->JSDocTypeStringValueJSDocTypeNumber_value->JSDocTypeNumberValueJSDocTypeFile_path->JSDocTypeFilePathJSDocTypeType_query->JSDocTypeTypeQueryJSDocTypeKey_query->JSDocTypeKeyQuery - Fix: Add missing
JSDocTypeLineto visitor keys - Docs: Explain AST structure/differences
- Fix: Ensure replacement of camel-casing (used in
- 0.4.13 May 2021
Release notes2 sources agree
Open source →- Docs: Indicate available methods with brief summary on README
- 0.4.03 May 2021
- 0.3.03 May 2021
Release notes2 sources agree
Open source →- Enhancement: Expose
toCamelCaseas new method rather than within a utility file.
- Enhancement: Expose
- 0.2.03 May 2021
Release notes2 sources agree
Open source →- Enhancement: Exposes new methods:
commentHandler,commentParserToESTree,jsdocVisitorKeys,jsdoctypeparserToESTree,jsdocTypeVisitorKeys,
- Enhancement: Exposes new methods:
- 0.1.130 Apr 2021
- 0.1.030 Apr 2021