Release v4.0.0-alpha.5 · asciidoctor/asciidoctor.js

Summary

Released on: 2026-05-26
Released by: github-actions[bot]
Published by: GitHub

Fix 8 TypeDoc warnings about DSL interface types referenced but not included in the documentation — patch-jsdoc.js now converts export type X = import("./extensions.js").X re-exports in types/index.d.ts to export type { X } from './extensions.js' so TypeDoc follows the re-export chain and documents the definitions inline
Add CLI doc generation and copy step to the docs job in build.yml so the main-branch docs push (under /main/) also includes the CLI API docs under /main/cli/, consistent with the release workflow
Restore CLI extensibility — Options and Invoker classes are now exported from asciidoctor/cli, allowing third-party tools to extend the CLI by subclassing: add custom options via Options#addOption() and override Invoker#invoke(), Invoker#version(), or Invoker#convertFiles() to customize behavior
Add JSDoc to the Options and Invoker classes and generate TypeScript declarations (types/cli.d.ts) via tsc — the asciidoctor/cli export now ships with types
Publish CLI API documentation to gh-pages under /{version}/cli/ alongside the core API docs, with cross-navigation links between the two sites
Lower the minimum required Node.js version from 24 to 20 — the engines.node field in all packages is now >=20; Node.js 22 remains the recommended version (current LTS/maintenance); Node.js 20 is EOL but the library has no runtime dependency on any API introduced after Node.js 20