Update dependency org.jetbrains.dokka:dokka-base to v1.9.20

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
org.jetbrains.dokka:dokka-base	1.8.10 -> 1.9.20

---

Release Notes

Kotlin/dokka (org.jetbrains.dokka:dokka-base)

v1.9.20: 1.9.20

General bugfixes

• Fixed sealed interfaces not having the sealed keyword in signatures (https://github.com/Kotlin/dokka/issues/2994)
• Fixed incorrect links in multi-module projects with non-unique package names (https://github.com/Kotlin/dokka/issues/2272). Huge thanks to @​EddieRingle!
• Fixed member extensions not being shown on index pages in certain scenarios (https://github.com/Kotlin/dokka/issues/3187)
• Fixed Java's inner classes not having the inner keyword in Kotlin signatures (https://github.com/Kotlin/dokka/issues/2793)
• Fixed Java's @param tag not working with type parameters (https://github.com/Kotlin/dokka/issues/3199)
• Fixed Dokka failing in KMP projects when the JVM source set is suppressed (https://github.com/Kotlin/dokka/issues/3209)

HTML format

• Provide an ability to add a custom homepage link to the header, more details in https://github.com/Kotlin/dokka/issues/2948#issuecomment-1976723089
• Fixed tab selection resetting after navigating to a different page (https://github.com/Kotlin/dokka/issues/2899)
• Fixed inline code not always being aligned with the surrounding text (https://github.com/Kotlin/dokka/issues/3228)
• Fixed the "No options found" text in search being barely visible (https://github.com/Kotlin/dokka/issues/3281)
• Fixed empty HTML tags being rendered for no reason (https://github.com/Kotlin/dokka/pull/3343, https://github.com/Kotlin/dokka/issues/3095)

Runners

Gradle Plugin

• Mark tasks as not compatible with Gradle configuration cache, second try (https://github.com/Kotlin/dokka/pull/3438). Thanks to @​3flex for noticing and fixing the problem!

Maven Plugin

• Fixed dokka:help being absent (https://github.com/Kotlin/dokka/issues/3035). Thanks to @​aSemy!
• Fixed the source links configuration not working (https://github.com/Kotlin/dokka/pull/3046). Thanks to @​freya022 for fixing this one!

CLI runner

• Allow using relative paths in the sourceRoots configuration option (https://github.com/Kotlin/dokka/issues/2571)

Plugin API

• Provide an extension point to customize the rendering of code blocks in HTML format (https://github.com/Kotlin/dokka/issues/3244)

Other:

• Make sure wasm-js and wasm-wasi targets introduced in Kotlin 1.9.20 are supported (https://github.com/Kotlin/dokka/issues/3310)
• Avoid concurrent invocations of Kotlin compiler's API due to the compiler API itself not always being thread safe (https://github.com/Kotlin/dokka/issues/3151). No noticeable performance loss is expected.
• Bump dependencies to the latest versions (https://github.com/Kotlin/dokka/pull/3231, https://github.com/Kotlin/dokka/pull/3206, https://github.com/Kotlin/dokka/pull/3204)
• Fix a documentation link (https://github.com/Kotlin/dokka/pull/3213). Thanks to @​SubhrajyotiSen for noticing and fixing it!
• Various build and project structure improvements (https://github.com/Kotlin/dokka/pull/3174, https://github.com/Kotlin/dokka/issues/3132). Enormous thanks to @​aSemy for the help!

See Dokka 1.9.20 milestone for the list of all changes.

v1.9.10: 1.9.10

General

• Fix re-emerged code analysis concurrency issues which led to flaky builds (#​1599, #​3143)
• Preserve the order of collection items when deserializing Dokka's configuration (#​3006). Thanks to @​eunwoop!

HTML format

• Fix an indefinite loop in the script that resizes symbol signature blocks (#​3116)

Gradle

• Fix resolution of platform dependencies for Kotlin 1.9 / Gradle 8 (#​3153, #​3147)
• Mark tasks as not compatible with the Gradle configuration cache (#​3070). Thanks to @​BoD!

Java

• Fix Java contravariant types being represented as covariant (#​3091). Thanks to @​juliamcclellan!

v1.9.0: 1.9.0

General improvements

• Generate dedicated pages for type aliases and enhance their presentation (https://github.com/Kotlin/dokka/issues/2862, https://github.com/Kotlin/dokka/issues/2971)
• Add documentation for Enum.entries introduced in Kotlin 1.9.0 (https://github.com/Kotlin/dokka/issues/2762)

HTML format

This release is packed with enhancements and bugfixes that make your API reference docs mobile-friendly!

You may find it a weird direction for improvement — we were just as surprised to find that almost 1/4 of Standard Library's API reference traffic is coming from mobile devices. Thanks to the Kotlin Website team, who contributed these improvements, Dokka now provides a solid experience to such visitors.

Improvements:

• Significantly improve the mobile layout and overall responsiveness (https://github.com/Kotlin/dokka/pull/2836, https://github.com/Kotlin/dokka/pull/3021, https://github.com/Kotlin/dokka/pull/3082, https://github.com/Kotlin/dokka/pull/3018)
• Use JetBrains Sans as the primary text font (https://github.com/Kotlin/dokka/pull/3017)
• Improve the experience of reading the documentation when JavaScript is disabled in the browser (https://github.com/Kotlin/dokka/pull/3020, https://github.com/Kotlin/dokka/pull/2836)

Bugfixes

• Fix a redundant dot in the path of search elements (https://github.com/Kotlin/dokka/issues/2289)
• Fix unknown asset paths leaking into HTML body (https://github.com/Kotlin/dokka/pull/3061)
• Fix invisible/hidden packages for modules with a space in the name (https://github.com/Kotlin/dokka/issues/3011)

Java interoperability

• Fix multi-param methods being classified as field setters (https://github.com/Kotlin/dokka/issues/2992)

Javadoc format

• Add basic support for @author, @since and @return tags (https://github.com/Kotlin/dokka/issues/1770). Thanks to @​irina-turova!

Other

• Decompose Kotlin/Java analysis (https://github.com/Kotlin/dokka/pull/3034)
• Improve copying base-frontend files between subprojects (https://github.com/Kotlin/dokka/pull/2970). Thanks to @​aSemy!

---

Known problems

Some Multiplatform Gradle 8 projects might experience build failures when resolving native/platform dependencies. Please, see https://github.com/Kotlin/dokka/issues/3153 for more details and workarounds.

Breaking changes

This release introduces some breaking changes that are expected to affect only a fraction of Dokka users.

HTML

Note: this section only applies to those customizing Dokka's HTML format by overriding styles or HTML templates. If you are not doing any customizations, you may skip this section.

To lay a solid foundation to making the HTML format responsive, some page layouts and many styles had to be changed in a backward-incompatible manner.

If you are overriding logo-styles.css to provide your own header logo, please update it to be in line with the new styles - there is significantly less position hardcoding now. See this example for how it can be done.

If you are overriding styles.css with your own file, please update the baseline styles to the latest, and see if anything is broken. If you get stuck with adapting your styles to the changes, the diff might help.

If you are overriding base.ftl or header.ftl templates, please update them to the latest, and adapt your changes.

CLI runner

Due to the analysis refactoring needed for the migration to K2 (#​3099), the JARs required to run Dokka have slightly changed.

The following JARs are no longer supported or published:

• dokka-analysis.jar
• kotlin-analysis-intellij.jar
• kotlin-analysis-compiler.jar

Please, replace them with a single JAR:

• analysis-kotlin-descriptors-1.9.0.jar

Plugin API

An internal refactoring of Dokka's analysis API was much needed for the migration to K2, leading to breaking changes in some cases.

If your Dokka plugin compiles without any problems — you may ignore this information, you are likely not affected.

If something doesn't compile or doesn't work anymore, please see #​3099 for more details.

v1.8.20: 1.8.20

Improvements

• Update Kotlin Gradle Plugin to 1.8.10 and Android Gradle Plugin to 4.1.3.
• Move the "Properties" block to be above functions inside the "Members" tab (#​2908)
• Make Javadoc tag parsing case-sensitive as per Javadoc specification (#​2907)
• Improve performance by reducing allocations and thus decreasing time spent in GC (#​2729)

Bugfixes

• Fix unresolved links leading to declarations from another source set #​2878
• Fix Dokka not failing the build if there are errors (#​2934), regression from 1.8.10. Thanks to @​jush!
• Fix TypeNotPresentException thrown in projects without KGP (#​2890), regression from 1.8.10.

Gradle plugin

• Start using kotlin-dsl plugin (#​2702, #​2833). Thanks to @​aSemy!
• Use Gradle filesystem types for task properties and apply default values lazily (#​2707, #​2983). Thanks to @​aSemy!

Plugin API

• Change the default logging level of console apps (DokkaConsoleLogger) to PROGRESS (#​2871)
• Introduce @InternalDokkaApi annotation (#​2904)
• Mark various utility API as Dokka-internal (#​2937)

Infrastructure

Big thanks to @​aSemy, @​Goooler and @​3flex for their valuable contributions and for improving the internal
developer experience when working on Dokka!

• Use convention plugins to configure the subprojects (#​2704 by @​aSemy)
• Use Gradle Version Catalog and type-safe project dependencies (#​2884 by @​aSemy)
• Migrate buildSrc to a composite build (#​2912 by @​Goooler)
• Tidy up build configurations and project files (#​2911, #​2930, #​2909, #​2946, #​2910, #​2705 by @​aSemy)
• Execute unit tests in parallel (#​2953 by @​Goooler)
• Add the ability to use different Java versions for build and test tasks (#​2918 by @​aSemy)
• Add reproducible archive build config (#​2947 by @​aSemy)
• Configure Kotlin compiler options lazily (#​2883 by @​Goooler)
• Improve GitHub Actions workflows (#​2939, #​2938 by @​Goooler)
• Stop testing on Java 15 as it has reached EOL (#​2892 by @​3flex)
• Remove a workaround for a fixed Gradle issue (#​2891 by @​3flex)

Documentation

• Add informational badges to the main README.md (#​2940). Thanks to @​Goooler!
• Fix typos, inconsistencies and incorrect links in documentation (#​2979, #​2973, #​2952). Thanks to @​LiYing2010, @​strangesource and @​ansman!
• Add more information about the infrastructure to CONTRIBUTING.md (#​2952)

Security

• Bump npm dependencies to address various vulnerabilities (#​2894, #​2923)

Other

• Update publication POM links to https (#​2931). Thanks to @​aSemy!
• Tidy up Gradle example projects and warning suppressions (#​2916, #​2975). Thanks to @​aSemy!

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Enabled.

♻ Rebasing: Whenever PR is behind base branch, 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.