chore: Upgrade jsdoc-api to v9

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
jsdoc-api	8.1.1 -> 9.3.1

---

Release Notes

jsdoc2md/jsdoc-api (jsdoc-api)

v9.3.1

Compare Source

v9.3.0

Compare Source

Non breaking changes since v9.2.0

• The minimum supported Node version has been restored to v12.17.
  • In version v9.0.0, I upgraded file-set (a dependency of this project) to use the latest version of node-glob to avoid deprecation messages. However, the minimum Node version required by node-glob is v20, subsequently forcing jsdoc-api to require Node v20. I wasn't comfortable with this so I rewrote file-set to use fast-glob v3 which supports Node v12.

v9.2.0

Compare Source

New features since v9.1.0

• If you need to use a specific jsdoc version or fork, specify its path via JSDOC_PATH and jsdoc-api will use it instead of the default. #​29

$ export JSDOC_PATH=./node_modules/.bin/jsdoc # An alternative jsdoc version you installed
$ node my-jsdoc-api-script.js                 # Run your jsdoc-api app as usual

v9.1.0

Compare Source

Non-breaking changes since v9.0.2

• To avoid this jsdoc issue (regarding jsdoc failing if a directory contains underscores), jsdoc-api now uses its own bespoke cache directory at ~/.jsdoc-api/cache instead of os.tmpdir(). See #​19.
• While running the underlying jsdoc child process, the maxBuffer used is now 100MB to help users processing huge amounts of input #​24

v9.0.2

Compare Source

v9.0.1

Compare Source

v9.0.0

Compare Source

There are no changes to the jsdoc-api output.

Breaking changes since v8.1.1

• The minimum required Node version is now v20.
  • A change imposed upon the project by node-glob (used, via file-set, by this lib). It was necessary to upgrade node-glob to the latest version to avoid using a deprecated, unsupported old version.
  • 30th Aug 2024: Update! Support for Node v12 was restored in jsdoc-api v9.3.0
• Removed all synchronous methods. Both .explain() and .render() are now async-only.
• Previously, passing either option.files or option.source was mandatory. Now, it is either option.files, option.source or option.configure. #​27

Non-breaking changes

• Fixed an issue where setting { pedantic: false } confused the underlying jsdoc. #​22
• Can now pass an array of strings to .source. #​11

Other improvements

• Jsdoc-api is now an ES Module.
• Dependency tree cleaned up
  • Coveralls, collect-json, collect-all, fs-then-native and temp-path all factored out of the project.
  • Many others upgraded to the latest versions, removing deprecation warnings.
• Readme examples improved
• Example code added in the /examples folder.
• Codebase simplified, in general.

Upgrade notes

• Update your code replacing any use of explainSync() with await explain() and renderSync() with await render().
• Ensure you're on Node v20 or above
• That's it. There are no changes to the jsdoc-api output - your generated documentation should look the same.

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - 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 was generated by Mend Renovate. View the repository job log.

[renovate]

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.

You can manually request rebase by checking the rebase/retry box above.

⚠️ Warning: custom changes will be lost.