v3.0.0-beta.1

This release is the first beta for the next major version of asciidoctorj.

Breaking changes

Improvement:

• Fix Macro APIs to take StructuralNodes and return Phrase- or StructuralNodes. (#1084)
• Allow Preprocessor extensions to create new Readers and replace the original Reader. (#1081)
• Set Java 11 as the minimal version (#1151) (@abelsromero)
• Remove deprecated methods in Options, OptionsBuilder, Attributes & AttributesBuilder (#1199) (@abelsromero)
• Remove deprecated methods from Asciidoctor interface (#1201) (@abelsromero)
• Remove deprecated methods from Document interface (#1202) (@abelsromero)
• Remove deprecated methods and constants from extension package (#1203) (@abelsromero)
• Remove deprecated methods from ast package (#1204) (@abelsromero)
• Add Automatic-Module-Name manifest entry to core, api, and cli for reserving stable JPMS module names (#1240) (@leadpony)
• Remove Java 'requires open access' module warning in modern Java versions (#1246)
• Add Reader.getSource() and Reader.getSourceLines() (#1262)

Bug Fixes:

• -s CLI option should be changed to -e to align with Asciidoctor (#1237) (@mojavelinux)
• Column#setWidth is ignored (#1265) (@Vampire)
• Fix unresolvable dependency of JRuby Gradle plugin. (#1275)

Compatible changes

Improvement:

• Add setContext function to StructuralNode.
• Add command line option --failure-level to force non-zero exit code from AsciidoctorJ CLI if specified logging level is reached. (#1114)
• Upgrade to asciidoctorj 2.0.23 (#1280)
• Upgrade to asciidoctorj-pdf 2.3.18 (#1280)
• Upgrade to asciidoctorj-revealjs 5.1.0 (#1256)
• Upgrade to asciidoctorj-diagram 2.3.1 (#1280)
• Upgrade to JRuby 9.4.8.0 (#1280)
• Upgrade to tilt 2.0.11 (#1109)
• Upgrade to asciimath 2.0.4 (#1109)
• Expose sectnum property in Section interface (#1121)
• Replace use of deprecated 'numbered' attribute by 'sectnums' (#1123) (@abelsromero)
• Expose source and source_lines use of deprecated 'numbered' in Document interface (#1145) (@abelsromero)
• Accept 'null' as valid input (same as empty string) for load and convert String methods (#1148) (@abelsromero)
• Create asciidoctorj-cli module to prevent unnecessary dependencies to asciidoctorj jar consumers (#1149)
• Add required --add-opens to cli launch script to remove Jdk warnings (#1155) (@abelsromero)
• Rename deprecated headerFooter option to the new standalone with same functionality (#1155) (@abelsromero)
• Remove class AsciidoctorUtils to remove complexity and unused logging (#1169) (@abelsromero)
• Expose ImageReferences in the catalog (#1166) (@abelsromero)
• Return Document AST when using convert or convertFile with appropriate options (#1171) (@abelsromero)
• Expose Links in the catalog (#1183) (@abelsromero)

Bug Fixes:

• Cell nodes do not inherit from StructuralNode (#1086) (@rahmanusta)
• Avoid throwing an exception when using AsciidoctorJ CLI and reading input from stdin (#1105) (@AlexCzar)
• Remove destinationDir Option from API (use toDir instead) (#853, #941) (@abelsromero)
• Fix CLI target file location for source files relative to source dir (#1135) (@AlexCzar)
• Fix ConcurrentModificationException when converting to stream concurrently (#1158) (@rocketraman)
• 'UnsupportedOperationException' when passing immutable Map as options to 'createPhraseNode' (#1221) (@abelsromero)

Build Improvement:

• Upgrade build to Gradle 8.5 (#1256)
• Upgrade Spring Boot test to 3.0.0 (#1134)
• Fix upstream tests forcing SNAPSHOT on Asciidoctor gem installation (#1123) (@abelsromero)
• Fix upstream build removing the explicit plugin repository (#1131)
• Set JUnit5 as default test engine (#1186) (@abelsromero)
• Removed pollutedTest Gradle task using junit-pioneer (#1193) (@abelsromero)
• Ignore 'docs/**' changes in CI (#1225) (@abelsromero)
• Add test for ensuring that asciidoctor version is available in CLI (#1230) (@abelsromero)
• Run tests on Java 21 (#1236) (@abelsromero)

Documentation:

• Fix invalid 'http://asciidoctor.org' references in docs and JavaDocs (#1195) (@abelsromero)