From 8e5c63d035ef44a269b8c43430f43f5c8eebfb63 Mon Sep 17 00:00:00 2001 From: Ignat Beresnev Date: Fri, 10 Nov 2023 11:46:54 +0100 Subject: Restructure the project to utilize included builds (#3174) * Refactor and simplify artifact publishing * Update Gradle to 8.4 * Refactor and simplify convention plugins and build scripts Fixes #3132 --------- Co-authored-by: Adam <897017+aSemy@users.noreply.github.com> Co-authored-by: Oleg Yukhnevich --- .github/workflows/preview-publish-ga.yml | 6 +- .github/workflows/preview-publish-web-s3.yml | 12 +- .github/workflows/tests-smoke.yml | 5 +- .github/workflows/tests-thorough.yml | 5 +- .gitmodules | 6 +- build-logic/README.md | 21 +- .../src/main/kotlin/dokkabuild.base.gradle.kts | 23 + .../kotlin/dokkabuild.gradle-plugin.gradle.kts | 35 + .../src/main/kotlin/dokkabuild.java.gradle.kts | 40 + .../main/kotlin/dokkabuild.kotlin-jvm.gradle.kts | 36 + .../main/kotlin/dokkabuild.publish-base.gradle.kts | 95 + .../dokkabuild.publish-gradle-plugin.gradle.kts | 36 + .../main/kotlin/dokkabuild.publish-jvm.gradle.kts | 19 + .../kotlin/dokkabuild.publish-shadow.gradle.kts | 31 + ...dokkabuild.setup-html-frontend-files.gradle.kts | 33 + .../kotlin/dokkabuild.setup-maven-cli.gradle.kts | 102 + .../kotlin/dokkabuild.test-integration.gradle.kts | 74 + .../src/main/kotlin/dokkabuild.test-k2.gradle.kts | 41 + .../main/kotlin/dokkabuild/DokkaBuildProperties.kt | 58 + .../src/main/kotlin/dokkabuild/PublicationUtils.kt | 27 + .../internal/GradleKotlinDslAccessors.kt | 41 + .../kotlin/org/jetbrains/DokkaBuildProperties.kt | 58 - .../org/jetbrains/DokkaPublicationChannel.kt | 66 - .../src/main/kotlin/org/jetbrains/DokkaVersion.kt | 23 - .../main/kotlin/org/jetbrains/DokkaVersionType.kt | 12 - .../kotlin/org/jetbrains/ValidatePublications.kt | 49 - .../org/jetbrains/conventions/base-java.gradle.kts | 42 - .../conventions/base-unit-test.gradle.kts | 43 - .../org/jetbrains/conventions/base.gradle.kts | 30 - .../dokka-html-frontend-files.gradle.kts | 35 - .../conventions/dokka-integration-test.gradle.kts | 81 - .../org/jetbrains/conventions/dokka.gradle.kts | 17 - .../jetbrains/conventions/gradle-plugin.gradle.kts | 13 - .../jetbrains/conventions/kotlin-jvm.gradle.kts | 58 - .../conventions/maven-cli-setup.gradle.kts | 104 - .../jetbrains/conventions/maven-publish.gradle.kts | 72 - .../jetbrains/internal/gradleKotlinDslAccessors.kt | 41 - .../src/main/kotlin/org/jetbrains/projectUtils.kt | 20 - .../src/main/kotlin/org/jetbrains/publication.kt | 125 - .../src/main/kotlin/org/jetbrains/taskUtils.kt | 26 - build.gradle.kts | 98 +- core/.gitignore | 1 - core/api/core.api | 4745 ----- core/build.gradle.kts | 43 - .../api/content-matcher-test-utils.api | 81 - core/content-matcher-test-utils/build.gradle.kts | 14 - .../kotlin/matchers/content/ContentMatchersDsl.kt | 191 - .../kotlin/matchers/content/contentMatchers.kt | 191 - core/src/main/kotlin/ConfigurationJsonUtils.kt | 54 - core/src/main/kotlin/CoreExtensions.kt | 43 - core/src/main/kotlin/DokkaBootstrap.kt | 15 - core/src/main/kotlin/DokkaBootstrapImpl.kt | 69 - core/src/main/kotlin/DokkaException.kt | 7 - core/src/main/kotlin/DokkaGenerator.kt | 89 - core/src/main/kotlin/DokkaVersion.kt | 15 - core/src/main/kotlin/InternalDokkaApi.kt | 28 - core/src/main/kotlin/configuration.kt | 280 - core/src/main/kotlin/defaultConfiguration.kt | 100 - core/src/main/kotlin/defaultExternalLinks.kt | 33 - core/src/main/kotlin/generation/Generation.kt | 19 - core/src/main/kotlin/links/DRI.kt | 146 - core/src/main/kotlin/model/CompositeSourceSetID.kt | 46 - core/src/main/kotlin/model/DisplaySourceSet.kt | 61 - core/src/main/kotlin/model/Documentable.kt | 540 - core/src/main/kotlin/model/JvmField.kt | 14 - core/src/main/kotlin/model/WithChildren.kt | 98 - core/src/main/kotlin/model/additionalExtras.kt | 142 - core/src/main/kotlin/model/ancestryNode.kt | 18 - core/src/main/kotlin/model/classKinds.kt | 24 - core/src/main/kotlin/model/defaultValues.kt | 34 - core/src/main/kotlin/model/doc/DocTag.kt | 372 - .../src/main/kotlin/model/doc/DocumentationNode.kt | 9 - core/src/main/kotlin/model/doc/TagWrapper.kt | 36 - .../main/kotlin/model/documentableProperties.kt | 71 - core/src/main/kotlin/model/documentableUtils.kt | 27 - core/src/main/kotlin/model/extraModifiers.kt | 68 - core/src/main/kotlin/model/jvmName.kt | 11 - .../kotlin/model/properties/PropertyContainer.kt | 69 - .../src/main/kotlin/model/properties/properties.kt | 36 - core/src/main/kotlin/pages/ContentNodes.kt | 436 - core/src/main/kotlin/pages/PageNodes.kt | 200 - core/src/main/kotlin/pages/Pages.kt | 15 - core/src/main/kotlin/pages/RendererSpecificPage.kt | 52 - .../src/main/kotlin/pages/contentNodeProperties.kt | 37 - core/src/main/kotlin/pages/utils.kt | 63 - core/src/main/kotlin/plugability/DokkaContext.kt | 235 - .../src/main/kotlin/plugability/DokkaJavaPlugin.kt | 78 - core/src/main/kotlin/plugability/DokkaPlugin.kt | 114 - core/src/main/kotlin/plugability/LazyEvaluated.kt | 21 - core/src/main/kotlin/plugability/extensions.kt | 110 - core/src/main/kotlin/renderers/PostAction.kt | 7 - core/src/main/kotlin/renderers/Renderer.kt | 11 - .../documentation/DefaultDocumentableMerger.kt | 307 - .../documentation/DocumentableMerger.kt | 12 - .../documentation/DocumentableToPageTranslator.kt | 13 - .../documentation/DocumentableTransformer.kt | 12 - .../PreMergeDocumentableTransformer.kt | 39 - .../main/kotlin/transformers/pages/PageCreator.kt | 15 - .../kotlin/transformers/pages/PageTransformer.kt | 11 - .../transformers/pages/PageTransformerBuilders.kt | 27 - .../sources/AsyncSourceToDocumentableTranslator.kt | 20 - .../sources/SourceToDocumentableTranslator.kt | 13 - core/src/main/kotlin/utilities/Collections.kt | 29 - core/src/main/kotlin/utilities/DokkaLogging.kt | 90 - core/src/main/kotlin/utilities/Html.kt | 23 - .../utilities/SelfRepresentingSingletonSet.kt | 27 - core/src/main/kotlin/utilities/ServiceLocator.kt | 99 - core/src/main/kotlin/utilities/Uri.kt | 46 - .../main/kotlin/utilities/associateWithNotNull.kt | 13 - core/src/main/kotlin/utilities/cast.kt | 12 - core/src/main/kotlin/utilities/json.kt | 65 - .../utilities/parallelCollectionOperations.kt | 26 - .../main/kotlin/validity/PreGenerationChecker.kt | 17 - core/src/main/resources/META-INF/MANIFEST.MF | 1 - .../META-INF/dokka/dokka-version.properties | 5 - .../test/kotlin/model/CompositeSourceSetIDTest.kt | 76 - core/src/test/kotlin/model/DisplaySourceSetTest.kt | 63 - core/src/test/kotlin/model/DocumentableTest.kt | 115 - .../kotlin/utilities/DokkaConfigurationJsonTest.kt | 72 - core/src/test/kotlin/utilities/JsonKtTest.kt | 80 - core/test-api/api/test-api.api | 198 - core/test-api/build.gradle.kts | 20 - .../src/main/kotlin/testApi/context/MockContext.kt | 53 - .../src/main/kotlin/testApi/logger/TestLogger.kt | 58 - .../testRunner/TestDokkaConfigurationBuilder.kt | 219 - .../main/kotlin/testApi/testRunner/TestRunner.kt | 235 - docs-developer/build.gradle.kts | 5 +- .../extension_points/core_extension_points.md | 2 +- dokka-integration-tests/aws_sync.sh | 38 + dokka-integration-tests/build.gradle.kts | 34 + dokka-integration-tests/cli/build.gradle.kts | 64 + .../main/java/it/basic/java/SampleJavaClass.java | 17 + .../src/main/kotlin/it/basic/EmptyPackage.kt | 1 + .../it-cli/src/main/kotlin/it/basic/PublicClass.kt | 57 + .../src/main/kotlin/it/internal/InternalClass.kt | 7 + .../it/overriddenVisibility/VisiblePrivateClass.kt | 12 + .../src/main/kotlin/it/protected/ProtectedClass.kt | 10 + .../jetbrains/dokka/it/cli/CliIntegrationTest.kt | 377 + .../org/jetbrains/dokka/it/cli/jsonBuilder.kt | 56 + .../cli/src/integrationTest/resources/my-file.json | 0 .../dokka/it/cli/AbstractCliIntegrationTest.kt | 40 + dokka-integration-tests/gradle.properties | 12 + dokka-integration-tests/gradle/README.md | 21 + dokka-integration-tests/gradle/build.gradle.kts | 37 + .../gradle/projects/coroutines/coroutines.diff | 96 + .../gradle/projects/coroutines/kotlinx-coroutines | 1 + .../projects/coroutines/template.root.gradle.kts | 1 + .../coroutines/template.settings.gradle.kts | 1 + .../gradle/projects/it-android-0/build.gradle.kts | 22 + .../gradle/projects/it-android-0/gradle.properties | 7 + .../it-android-0/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-android-0/gradlew | 183 + .../gradle/projects/it-android-0/gradlew.bat | 100 + .../projects/it-android-0/settings.gradle.kts | 9 + .../it-android-0/src/main/AndroidManifest.xml | 5 + .../main/java/it/android/AndroidSpecificClass.kt | 16 + .../java/it/android/IntegrationTestActivity.kt | 22 + .../gradle/projects/it-basic-groovy/build.gradle | 54 + .../projects/it-basic-groovy/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58910 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-basic-groovy/gradlew | 185 + .../gradle/projects/it-basic-groovy/gradlew.bat | 104 + .../projects/it-basic-groovy/settings.gradle.kts | 9 + .../main/java/it/basic/java/SampleJavaClass.java | 17 + .../src/main/kotlin/it/basic/PublicClass.kt | 48 + .../gradle/projects/it-basic/build.gradle.kts | 67 + .../it-basic/customResources/custom-resource.svg | 7 + .../customResources/custom-style-to-add.css | 5 + .../it-basic/customResources/logo-styles.css | 7 + .../gradle/projects/it-basic/gradle.properties | 5 + .../it-basic/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58910 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-basic/gradlew | 185 + .../gradle/projects/it-basic/gradlew.bat | 104 + .../gradle/projects/it-basic/settings.gradle.kts | 9 + .../main/java/it/basic/java/SampleJavaClass.java | 17 + .../it-basic/src/main/kotlin/RootPackageClass.kt | 8 + .../src/main/kotlin/it/basic/PublicClass.kt | 69 + .../src/main/kotlin/it/internal/InternalClass.kt | 7 + .../it/overriddenVisibility/VisiblePrivateClass.kt | 12 + .../src/main/kotlin/it/protected/ProtectedClass.kt | 10 + .../it/suppressedByPackage/SuppressedByPackage.kt | 7 + .../kotlin/it/suppressedByPath/SuppressedByPath.kt | 7 + .../it-basic/src/test/kotlin/it/basic/TestClass.kt | 17 + .../projects/it-collector-0/build.gradle.kts | 5 + .../projects/it-collector-0/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-collector-0/gradlew | 183 + .../gradle/projects/it-collector-0/gradlew.bat | 100 + .../it-collector-0/moduleA/build.gradle.kts | 10 + .../it-collector-0/moduleA/moduleB/README.md | 2 + .../moduleA/moduleB/build.gradle.kts | 8 + .../org/jetbrains/dokka/it/moduleB/ModuleB.kt | 6 + .../it-collector-0/moduleA/moduleC/README.md | 2 + .../moduleA/moduleC/build.gradle.kts | 8 + .../org/jetbrains/dokka/it/moduleC/ModuleC.kt | 6 + .../projects/it-collector-0/settings.gradle.kts | 9 + .../gradle/projects/it-configuration/README.md | 5 + .../projects/it-configuration/build.gradle.kts | 33 + .../projects/it-configuration/gradle.properties | 7 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58910 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-configuration/gradlew | 185 + .../gradle/projects/it-configuration/gradlew.bat | 104 + .../projects/it-configuration/settings.gradle.kts | 7 + .../kotlin/it/ClassWithUndocumentedDeclarations.kt | 12 + .../gradle/projects/it-js-ir-0/build.gradle.kts | 25 + .../gradle/projects/it-js-ir-0/gradle.properties | 6 + .../it-js-ir-0/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58910 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-js-ir-0/gradlew | 185 + .../gradle/projects/it-js-ir-0/gradlew.bat | 104 + .../gradle/projects/it-js-ir-0/settings.gradle.kts | 9 + .../it-js-ir-0/src/main/kotlin/RootPackageClass.kt | 26 + .../src/main/kotlin/it/basic/PublicClass.kt | 53 + .../src/main/kotlin/it/internal/InternalClass.kt | 7 + .../it/suppressedByPackage/SuppressedByPackage.kt | 7 + .../kotlin/it/suppressedByPath/SuppressedByPath.kt | 7 + .../projects/it-multimodule-0/build.gradle.kts | 5 + .../projects/it-multimodule-0/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-multimodule-0/gradlew | 183 + .../gradle/projects/it-multimodule-0/gradlew.bat | 100 + .../it-multimodule-0/moduleA/build.gradle.kts | 21 + .../it-multimodule-0/moduleA/moduleB/Module.md | 6 + .../moduleA/moduleB/build.gradle.kts | 17 + .../org/jetbrains/dokka/it/moduleB/ModuleB.kt | 6 + .../it-multimodule-0/moduleA/moduleC/Module.md | 2 + .../moduleA/moduleC/build.gradle.kts | 16 + .../org/jetbrains/dokka/it/moduleC/ModuleC.kt | 6 + .../moduleA/moduleD/build.gradle.kts | 10 + .../org/jetbrains/dokka/it/moduleD/ModuleC.kt | 6 + .../projects/it-multimodule-0/settings.gradle.kts | 10 + .../gradle/projects/it-multimodule-1/build.gradle | 18 + .../projects/it-multimodule-1/first/build.gradle | 0 .../first/src/main/kotlin/foo/FirstClass.kt | 11 + .../first/src/main/kotlin/foo/FirstSubclass.kt | 12 + .../first/src/main/kotlin/foo/Main.kt | 8 + .../first/src/main/kotlin/noPackage.kt | 3 + .../projects/it-multimodule-1/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58910 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-multimodule-1/gradlew | 185 + .../gradle/projects/it-multimodule-1/gradlew.bat | 104 + .../projects/it-multimodule-1/second/build.gradle | 14 + .../second/src/main/kotlin/NoPackageClass.kt | 1 + .../second/src/main/kotlin/bar/SecondClass.kt | 21 + .../second/src/main/kotlin/foo/ThirdClass.kt | 11 + .../projects/it-multimodule-1/settings.gradle.kts | 8 + .../it-multimodule-versioning-0/build.gradle | 43 + .../it-multimodule-versioning-0/first/build.gradle | 0 .../first/src/main/kotlin/foo/FirstClass.kt | 11 + .../it-multimodule-versioning-0/gradle.properties | 6 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 61574 bytes .../gradle/wrapper/gradle-wrapper.properties | 10 + .../projects/it-multimodule-versioning-0/gradlew | 244 + .../it-multimodule-versioning-0/gradlew.bat | 92 + .../second/build.gradle | 3 + .../second/src/main/kotlin/bar/SecondClass.kt | 21 + .../settings.gradle.kts | 8 + .../projects/it-multiplatform-0/build.gradle.kts | 52 + .../projects/it-multiplatform-0/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-multiplatform-0/gradlew | 183 + .../gradle/projects/it-multiplatform-0/gradlew.bat | 100 + .../it-multiplatform-0/settings.gradle.kts | 6 + .../commonMain/kotlin/it/mpp0/CommonMainClass.kt | 8 + .../src/commonMain/kotlin/it/mpp0/ExpectedClass.kt | 5 + .../src/commonMain/kotlin/it/mpp0/coroutines.kt | 5 + .../kotlin/it/mpp0/CPointerExtension.kt | 11 + .../desktopMain/kotlin/it/mpp0/ExpectedClass.kt | 5 + .../src/jsMain/kotlin/it/mpp0/ExpectedClass.kt | 5 + .../src/jsMain/kotlin/it/mpp0/runBlocking.kt | 7 + .../src/jvmMain/kotlin/it/mpp0/ExpectedClass.kt | 11 + .../src/jvmMain/kotlin/it/mpp0/JvmOnlyClass.kt | 13 + .../src/jvmMain/kotlin/it/mpp0/runBlocking.kt | 7 + .../linuxMain/kotlin/it/mpp0/CPointerExtension.kt | 11 + .../src/linuxMain/kotlin/it/mpp0/ExpectedClass.kt | 5 + .../src/linuxMain/kotlin/it/mpp0/runBlocking.kt | 13 + .../src/macosMain/kotlin/it/mpp0/ExpectedClass.kt | 5 + .../src/macosMain/kotlin/it/mpp0/runBlocking.kt | 7 + .../build.gradle.kts | 44 + .../gradle.properties | 6 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58910 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../it-sequential-tasks-execution-stress/gradlew | 185 + .../gradlew.bat | 104 + .../settings.gradle.kts | 9 + .../main/java/it/basic/java/SampleJavaClass.java | 17 + .../src/main/kotlin/RootPackageClass.kt | 8 + .../gradle/projects/it-wasm-basic/build.gradle.kts | 51 + .../projects/it-wasm-basic/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-wasm-basic/gradlew | 183 + .../gradle/projects/it-wasm-basic/gradlew.bat | 100 + .../projects/it-wasm-basic/settings.gradle.kts | 6 + .../src/wasmMain/kotlin/RootPackageClass.kt | 30 + .../src/wasmMain/kotlin/it/basic/PublicClass.kt | 53 + .../wasmMain/kotlin/it/internal/InternalClass.kt | 7 + .../it/suppressedByPackage/SuppressedByPackage.kt | 7 + .../kotlin/it/suppressedByPath/SuppressedByPath.kt | 7 + .../it-wasm-js-wasi-basic/build.gradle.kts | 40 + .../it-wasm-js-wasi-basic/gradle.properties | 5 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + .../gradle/projects/it-wasm-js-wasi-basic/gradlew | 183 + .../projects/it-wasm-js-wasi-basic/gradlew.bat | 100 + .../it-wasm-js-wasi-basic/settings.gradle.kts | 6 + .../src/wasmJsMain/kotlin/RootPackageClass.kt | 30 + .../src/wasmJsMain/kotlin/it/basic/PublicClass.kt | 53 + .../wasmJsMain/kotlin/it/internal/InternalClass.kt | 7 + .../it/suppressedByPackage/SuppressedByPackage.kt | 7 + .../kotlin/it/suppressedByPath/SuppressedByPath.kt | 7 + .../src/wasmWasiMain/kotlin/RootPackageClass.kt | 10 + .../wasmWasiMain/kotlin/it/basic/PublicClass.kt | 53 + .../kotlin/it/internal/InternalClass.kt | 7 + .../it/suppressedByPackage/SuppressedByPackage.kt | 7 + .../kotlin/it/suppressedByPath/SuppressedByPath.kt | 7 + .../projects/serialization/kotlinx-serialization | 1 + .../projects/serialization/serialization.diff | 29 + .../serialization/template.root.gradle.kts | 1 + .../serialization/template.settings.gradle.kts | 1 + .../gradle/projects/template.root.gradle.kts | 29 + .../gradle/projects/template.settings.gradle.kts | 45 + .../dokka/it/StdLibDocumentationIntegrationTest.kt | 42 + .../gradle/AbstractGradleCachingIntegrationTest.kt | 142 + .../it/gradle/Android0GradleIntegrationTest.kt | 100 + .../dokka/it/gradle/BasicCachingIntegrationTest.kt | 74 + .../dokka/it/gradle/BasicGradleIntegrationTest.kt | 201 + .../dokka/it/gradle/BasicGroovyIntegrationTest.kt | 96 + .../dokka/it/gradle/Collector0IntegrationTest.kt | 83 + .../jetbrains/dokka/it/gradle/ConfigurationTest.kt | 76 + .../GradleRelocatedCachingIntegrationTest.kt | 38 + .../dokka/it/gradle/JsIRGradleIntegrationTest.kt | 67 + .../dokka/it/gradle/MultiModule0IntegrationTest.kt | 103 + .../dokka/it/gradle/MultiModule1IntegrationTest.kt | 58 + .../gradle/Multiplatform0GradleIntegrationTest.kt | 57 + .../gradle/SequentialTasksExecutionStressTest.kt | 48 + .../jetbrains/dokka/it/gradle/TestedVersions.kt | 72 + .../dokka/it/gradle/Versioning0IntegrationTest.kt | 87 + .../dokka/it/gradle/WasmGradleIntegrationTest.kt | 66 + .../it/gradle/WasmJsWasiGradleIntegrationTest.kt | 65 + .../kotlin/CoroutinesGradleIntegrationTest.kt | 70 + .../kotlin/SerializationGradleIntegrationTest.kt | 64 + .../it/gradle/AbstractGradleIntegrationTest.kt | 84 + .../org/jetbrains/dokka/it/gradle/BuildVersions.kt | 52 + .../jetbrains/dokka/it/gradle/TestEnvironment.kt | 18 + dokka-integration-tests/maven/build.gradle.kts | 35 + .../maven/projects/biojava/biojava | 1 + .../maven/projects/biojava/biojava.diff | 37 + .../it-maven/customResources/custom-resource.svg | 7 + .../customResources/custom-style-to-add.css | 5 + .../it-maven/customResources/logo-styles.css | 7 + .../maven/projects/it-maven/pom.xml | 192 + .../main/java/it/basic/java/SampleJavaClass.java | 22 + .../src/main/kotlin/it/basic/PublicClass.kt | 57 + .../src/main/kotlin/it/internal/InternalClass.kt | 7 + .../it/overriddenVisibility/VisiblePrivateClass.kt | 12 + .../src/main/kotlin/it/protected/ProtectedClass.kt | 10 + .../dokka/it/maven/BiojavaIntegrationTest.kt | 63 + .../dokka/it/maven/MavenIntegrationTest.kt | 219 + dokka-integration-tests/settings.gradle.kts | 42 + dokka-integration-tests/utilities/build.gradle.kts | 17 + .../jetbrains/dokka/it/AbstractIntegrationTest.kt | 168 + .../org/jetbrains/dokka/it/TestOutputCopier.kt | 20 + .../org/jetbrains/dokka/it/gitSubmoduleUtils.kt | 43 + .../kotlin/org/jetbrains/dokka/it/processUtils.kt | 55 + dokka-runners/runner-cli/api/runner-cli.api | 100 + dokka-runners/runner-cli/build.gradle.kts | 26 + dokka-runners/runner-cli/gradle.properties | 11 + dokka-runners/runner-cli/settings.gradle.kts | 31 + .../kotlin/org/jetbrains/dokka/CliArgumentTypes.kt | 97 + .../kotlin/org/jetbrains/dokka/GlobalArguments.kt | 168 + .../main/kotlin/org/jetbrains/dokka/LinkMapper.kt | 41 + .../org/jetbrains/dokka/PackageOptionsParser.kt | 38 + .../jetbrains/dokka/SourceSetArgumentsParser.kt | 165 + .../src/main/kotlin/org/jetbrains/dokka/main.kt | 32 + .../src/test/kotlin/org/jetbrains/dokka/CliTest.kt | 46 + .../resources/my-file-no-sourceset-options.json | 13 + .../runner-cli/src/test/resources/my-file.json | 51 + .../runner-gradle-plugin-classic/MIGRATION.md | 167 + .../api/runner-gradle-plugin-classic.api | 186 + .../runner-gradle-plugin-classic/build.gradle.kts | 69 + .../runner-gradle-plugin-classic/gradle.properties | 13 + .../settings.gradle.kts | 31 + .../org/jetbrains/dokka/gradle/DokkaArtifacts.kt | 29 + .../dokka/gradle/DokkaMultiModuleFileLayout.kt | 94 + .../org/jetbrains/dokka/gradle/DokkaPlugin.kt | 131 + .../org/jetbrains/dokka/gradle/DokkaProperty.kt | 10 + .../jetbrains/dokka/gradle/DokkaSourceSetMapper.kt | 76 + .../dokka/gradle/GradleDokkaSourceSetBuilder.kt | 483 + .../GradleDokkaSourceSetBuilderExtensions.kt | 36 + .../gradle/GradleDokkaSourceSetBuilderFactory.kt | 12 + .../GradleExternalDocumentationLinkBuilder.kt | 86 + .../dokka/gradle/GradlePackageOptionsBuilder.kt | 113 + .../dokka/gradle/GradleSourceLinkBuilder.kt | 108 + .../gradle/TaskDependencyInternalWithAdditions.kt | 22 + .../jetbrains/dokka/gradle/automagicTypedProxy.kt | 49 + .../dokka/gradle/checkChildDokkaTasksIsNotEmpty.kt | 47 + .../dokka/gradle/checkDependentSourceSets.kt | 28 + .../dokka/gradle/dokkaBootstrapFactory.kt | 22 + .../dokka/gradle/dokkaDefaultOutputDirectory.kt | 17 + .../dokka/gradle/dokkaSourceSetIDFactory.kt | 18 + .../jetbrains/dokka/gradle/gradleConfigurations.kt | 53 + .../gradle/internal/AbstractDokkaTaskExtensions.kt | 28 + .../gradle/kotlin/KotlinGradlePluginVersion.kt | 34 + .../kotlin/KotlinNativeDistributionAccessor.kt | 39 + .../dokka/gradle/kotlin/KotlinSourceSetGist.kt | 33 + .../dokka/gradle/kotlin/isMainSourceSet.kt | 32 + .../dokka/gradle/kotlin/kotlinClasspathUtils.kt | 109 + .../dokka/gradle/kotlin/kotlinCompilationUtils.kt | 81 + .../dokka/gradle/kotlin/kotlinSourceSetUtils.kt | 17 + .../dokka/gradle/kotlin/platformOfSourceSet.kt | 17 + .../gradle/sourceSetKotlinGistConfiguration.kt | 32 + .../dokka/gradle/tasks/AbstractDokkaLeafTask.kt | 41 + .../dokka/gradle/tasks/AbstractDokkaParentTask.kt | 107 + .../dokka/gradle/tasks/AbstractDokkaTask.kt | 257 + .../dokka/gradle/tasks/DokkaCollectorTask.kt | 41 + .../dokka/gradle/tasks/DokkaMultiModuleTask.kt | 115 + .../org/jetbrains/dokka/gradle/tasks/DokkaTask.kt | 29 + .../dokka/gradle/tasks/DokkaTaskPartial.kt | 32 + .../kotlin/org/jetbrains/dokka/gradle/utils.kt | 49 + .../dokka/gradle/AbstractDokkaParentTaskTest.kt | 204 + .../dokka/gradle/AndroidAutoConfigurationTest.kt | 88 + .../jetbrains/dokka/gradle/AutomagicProxyTest.kt | 52 + .../dokka/gradle/CheckSourceSetDependenciesTest.kt | 71 + .../gradle/ConfigureWithKotlinSourceSetGistTest.kt | 170 + .../dokka/gradle/DokkaConfigurationJsonTest.kt | 72 + .../gradle/DokkaConfigurationSerializableTest.kt | 78 + .../dokka/gradle/DokkaMultiModuleFileLayoutTest.kt | 138 + .../jetbrains/dokka/gradle/DokkaPluginApplyTest.kt | 153 + .../dokka/gradle/GradleDokkaSourceSetBuilder.kt | 14 + .../gradle/GradleDokkaSourceSetBuilderTest.kt | 494 + .../gradle/KotlinDslDokkaTaskConfigurationTest.kt | 103 + .../dokka/gradle/KotlinSourceSetGistTest.kt | 248 + .../gradle/kotlin/KotlinGradlePluginVersionTest.kt | 79 + .../dokka/gradle/tasks/DokkaCollectorTaskTest.kt | 113 + .../dokka/gradle/tasks/DokkaMultiModuleTaskTest.kt | 244 + .../jetbrains/dokka/gradle/tasks/DokkaTaskTest.kt | 51 + .../gradle/utils/samWithReceiverWorkarounds.kt | 73 + .../api/runner-maven-plugin.api | 141 + dokka-runners/runner-maven-plugin/build.gradle.kts | 137 + .../runner-maven-plugin/gradle.properties | 9 + dokka-runners/runner-maven-plugin/pom.template.xml | 56 + .../runner-maven-plugin/settings.gradle.kts | 30 + .../kotlin/org/jetbrains/dokka/maven/DokkaMojo.kt | 615 + .../maven/ExternalDocumentationLinkBuilder.kt | 68 + .../org/jetbrains/dokka/maven/MavenDokkaLogger.kt | 44 + .../org/jetbrains/dokka/maven/PackageOptions.kt | 89 + .../org/jetbrains/dokka/maven/SourceLinkMapItem.kt | 69 + dokka-subprojects/README.md | 16 + dokka-subprojects/analysis-java-psi/README.md | 5 + .../analysis-java-psi/api/analysis-java-psi.api | 152 + .../analysis-java-psi/build.gradle.kts | 22 + .../java/DefaultPsiToDocumentableTranslator.kt | 87 + .../dokka/analysis/java/JavaAnalysisPlugin.kt | 110 + .../jetbrains/dokka/analysis/java/JavadocTag.kt | 54 + .../java/SynheticElementDocumentationProvider.kt | 46 + .../dokka/analysis/java/doccomment/DocComment.kt | 18 + .../analysis/java/doccomment/DocCommentCreator.kt | 13 + .../analysis/java/doccomment/DocCommentFactory.kt | 24 + .../analysis/java/doccomment/DocCommentFinder.kt | 68 + .../java/doccomment/DocumentationContent.kt | 15 + .../analysis/java/doccomment/JavaDocComment.kt | 88 + .../java/doccomment/JavaDocCommentCreator.kt | 15 + .../java/doccomment/PsiDocumentationContent.kt | 26 + .../java/parsers/CommentResolutionContext.kt | 13 + .../analysis/java/parsers/DocCommentParser.kt | 16 + .../dokka/analysis/java/parsers/DokkaPsiParser.kt | 803 + .../analysis/java/parsers/JavaDocCommentParser.kt | 232 + .../dokka/analysis/java/parsers/JavadocParser.kt | 28 + .../java/parsers/doctag/DocTagParserContext.kt | 51 + .../java/parsers/doctag/HtmlToDocTagConverter.kt | 118 + .../parsers/doctag/InheritDocTagContentProvider.kt | 14 + .../java/parsers/doctag/InheritDocTagResolver.kt | 118 + .../java/parsers/doctag/PsiDocTagParser.kt | 43 + .../parsers/doctag/PsiElementToHtmlConverter.kt | 218 + .../dokka/analysis/java/util/CoreCopyPaste.kt | 24 + .../dokka/analysis/java/util/NoopIntellijLogger.kt | 47 + .../analysis/java/util/PropertiesConventionUtil.kt | 105 + .../java/util/PsiAccessorConventionUtil.kt | 102 + .../dokka/analysis/java/util/PsiCommentsUtils.kt | 53 + .../jetbrains/dokka/analysis/java/util/PsiUtil.kt | 126 + .../dokka/analysis/java/util/StdlibUtil.kt | 37 + .../dokka/analysis/java/util/resolveToGetDri.kt | 11 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + dokka-subprojects/analysis-kotlin-api/README.md | 10 + .../api/analysis-kotlin-api.api | 85 + .../analysis-kotlin-api/build.gradle.kts | 36 + .../dokka/analysis/kotlin/KotlinAnalysisPlugin.kt | 21 + .../internal/DocumentableSourceLanguageParser.kt | 20 + .../internal/ExternalDocumentablesProvider.kt | 28 + .../kotlin/internal/FullClassHierarchyBuilder.kt | 21 + .../analysis/kotlin/internal/InheritanceBuilder.kt | 25 + .../internal/InternalKotlinAnalysisPlugin.kt | 38 + .../kotlin/internal/KotlinToJavaService.kt | 29 + .../ModuleAndPackageDocumentationReader.kt | 19 + .../analysis/kotlin/internal/SampleProvider.kt | 36 + .../internal/SyntheticDocumentableDetector.kt | 15 + .../test/jvm/java/SampleJavaAnalysisTest.kt | 49 + .../test/jvm/kotlin/SampleKotlinJvmAnalysisTest.kt | 43 + .../test/jvm/mixed/SampleMixedJvmAnalysisTest.kt | 81 + .../moduledocs/PackageDocumentationAnalysisTest.kt | 66 + .../analysis/test/sample/SampleAnalysisTest.kt | 55 + .../jetbrains/dokka/analysis/test/api/TestData.kt | 21 + .../dokka/analysis/test/api/TestDataFile.kt | 37 + .../dokka/analysis/test/api/TestProject.kt | 97 + .../dokka/analysis/test/api/TestProjectFactory.kt | 67 + .../test/api/analysis/TestAnalysisContext.kt | 36 + .../test/api/analysis/TestAnalysisServices.kt | 20 + .../test/api/analysis/TestProjectAnalyzer.kt | 223 + .../api/configuration/TestDokkaConfiguration.kt | 171 + .../configuration/TestDokkaConfigurationBuilder.kt | 145 + .../configuration/TestDokkaConfigurationMapper.kt | 177 + .../test/api/jvm/java/JavaConfigurationBuilder.kt | 61 + .../analysis/test/api/jvm/java/JavaFileCreator.kt | 25 + .../analysis/test/api/jvm/java/JavaTestData.kt | 54 + .../analysis/test/api/jvm/java/JavaTestDataFile.kt | 27 + .../analysis/test/api/jvm/java/JavaTestProject.kt | 73 + .../jvm/kotlin/KotlinJvmConfigurationBuilder.kt | 56 + .../api/jvm/kotlin/KotlinJvmDependencyUtils.kt | 22 + .../test/api/jvm/kotlin/KotlinJvmTestProject.kt | 93 + .../api/jvm/mixed/MixedJvmConfigurationBuilder.kt | 69 + .../test/api/jvm/mixed/MixedJvmTestData.kt | 47 + .../test/api/jvm/mixed/MixedJvmTestProject.kt | 80 + .../analysis/test/api/kotlin/KotlinTestData.kt | 48 + .../analysis/test/api/kotlin/KotlinTestDataFile.kt | 27 + .../analysis/test/api/kotlin/KtFileCreator.kt | 32 + .../api/kotlin/sample/KotlinSampleFileCreator.kt | 32 + .../test/api/kotlin/sample/KotlinSampleTestData.kt | 44 + .../api/kotlin/sample/KotlinSampleTestDataFile.kt | 27 + .../analysis/test/api/markdown/MarkdownTestData.kt | 40 + .../test/api/markdown/MarkdownTestDataFile.kt | 26 + .../analysis/test/api/markdown/MdFileCreator.kt | 28 + .../analysis/test/api/util/CollectionUtils.kt | 18 + .../dokka/analysis/test/api/util/DslApiUtils.kt | 9 + .../dokka/analysis/test/api/util/FileUtils.kt | 41 + .../analysis-kotlin-descriptors-compiler/README.md | 9 + .../api/analysis-kotlin-descriptors-compiler.api | 126 + .../build.gradle.kts | 24 + .../descriptors/compiler/AnalysisContextCreator.kt | 24 + .../compiler/CompilerDescriptorAnalysisPlugin.kt | 156 + .../CompilerDocumentableSourceLanguageParser.kt | 27 + .../compiler/CompilerExtensionPointProvider.kt | 18 + .../descriptors/compiler/DescriptorFinder.kt | 14 + .../kotlin/descriptors/compiler/KDocFinder.kt | 34 + .../kotlin/descriptors/compiler/KLibService.kt | 27 + .../descriptors/compiler/MockApplicationHack.kt | 13 + .../compiler/configuration/AbsolutePathString.kt | 7 + .../compiler/configuration/AnalysisContext.kt | 102 + .../compiler/configuration/AnalysisEnvironment.kt | 595 + .../compiler/configuration/CallableFactory.kt | 35 + .../compiler/configuration/DRIFactory.kt | 53 + .../compiler/configuration/DRITargetFactory.kt | 46 + .../compiler/configuration/Documentable.kt | 28 + .../configuration/JvmDependenciesIndexImpl.kt | 257 + .../compiler/configuration/KotlinAnalysis.kt | 106 + .../configuration/KotlinCliJavaFileManagerImpl.kt | 301 + .../compiler/configuration/TypeReferenceFactory.kt | 72 + .../configuration/resolve/CommonKlibModuleInfo.kt | 29 + .../resolve/DokkaJsKlibLibraryInfo.kt | 34 + .../resolve/DokkaJsResolverForModuleFactory.kt | 133 + .../resolve/DokkaKlibLibraryDependencyResolver.kt | 21 + .../configuration/resolve/DokkaKlibLibraryInfo.kt | 14 + .../DokkaKlibMetadataCommonDependencyContainer.kt | 140 + .../resolve/DokkaNativeKlibLibraryInfo.kt | 54 + .../resolve/DokkaNativeResolverForModuleFactory.kt | 88 + .../impl/DescriptorFullClassHierarchyBuilder.kt | 89 + .../compiler/impl/DescriptorInheritanceBuilder.kt | 95 + .../compiler/impl/DescriptorKotlinToJavaMapper.kt | 35 + .../DescriptorSyntheticDocumentableDetector.kt | 37 + .../compiler/impl/KotlinSampleProvider.kt | 119 + .../IllegalModuleAndPackageDocumentation.kt | 11 + .../moduledocs/ModuleAndPackageDocumentation.kt | 15 + .../ModuleAndPackageDocumentationFragment.kt | 13 + .../ModuleAndPackageDocumentationParsingContext.kt | 75 + .../ModuleAndPackageDocumentationReader.kt | 117 + .../ModuleAndPackageDocumentationSource.kt | 18 + .../parseModuleAndPackageDocumentation.kt | 16 + .../parseModuleAndPackageDocumentationFragments.kt | 59 + .../java/DescriptorDocumentationContent.kt | 20 + .../compiler/java/DescriptorKotlinDocComment.kt | 83 + .../java/DescriptorKotlinDocCommentCreator.kt | 30 + .../java/DescriptorKotlinDocCommentParser.kt | 58 + .../compiler/java/KotlinAnalysisProjectProvider.kt | 20 + .../java/KotlinAnalysisSourceRootsExtractor.kt | 31 + .../java/KotlinInheritDocTagContentProvider.kt | 35 + .../compiler/translator/CollectionExtensions.kt | 16 + .../DefaultDescriptorToDocumentableTranslator.kt | 1284 ++ .../DefaultExternalDocumentablesProvider.kt | 47 + .../translator/DescriptorAccessorConventionUtil.kt | 148 + .../translator/ExternalClasslikesTranslator.kt | 16 + .../compiler/translator/KdocMarkdownParser.kt | 105 + .../SyntheticDescriptorDocumentationProvider.kt | 82 + .../compiler/translator/annotationsValue.kt | 7 + .../descriptors/compiler/translator/isException.kt | 22 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + ...seModuleAndPackageDocumentationFragmentsTest.kt | 287 + .../analysis-kotlin-descriptors-ide/README.md | 11 + .../api/analysis-kotlin-descriptors-ide.api | 4 + .../build.gradle.kts | 17 + .../descriptors/ide/CoreKotlinCacheService.kt | 58 + .../descriptors/ide/DokkaResolutionFacade.kt | 128 + .../descriptors/ide/IdeAnalysisContextCreator.kt | 33 + .../descriptors/ide/IdeDescriptorAnalysisPlugin.kt | 38 + .../kotlin/descriptors/ide/IdeDescriptorFinder.kt | 24 + .../kotlin/descriptors/ide/IdeKLibService.kt | 58 + .../descriptors/ide/IdeMockApplicationHack.kt | 16 + .../kotlin/descriptors/ide/IdePluginKDocFinder.kt | 54 + .../ide/ResolutionFacadeAnalysisContext.kt | 34 + .../kotlin/caches/resolve/KotlinCacheService.kt | 45 + .../caches/resolve/PlatformAnalysisSettings.kt | 22 + .../idea/caches/resolve/ExtendedResolutionApi.kt | 78 + .../org/jetbrains/kotlin/idea/kdoc/findKDoc.kt | 129 + .../jetbrains/kotlin/idea/kdoc/resolveKDocLink.kt | 311 + .../idea/klib/CachingIdeKlibMetadataLoader.kt | 56 + .../kotlin/idea/klib/KlibCompatibilityInfo.kt | 48 + .../kotlin/idea/klib/KlibLoadingMetadataCache.kt | 114 + .../kotlin/idea/resolve/ResolutionFacade.kt | 61 + .../org/jetbrains/kotlin/idea/util/CallType.kt | 96 + .../jetbrains/kotlin/idea/util/ExtensionsUtils.kt | 51 + .../jetbrains/kotlin/idea/util/FuzzyTypeUtils.kt | 154 + .../kotlin/resolve/lazy/BodyResolveMode.kt | 30 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + .../analysis-kotlin-descriptors/README.md | 21 + .../api/analysis-kotlin-descriptors.api | 0 .../analysis-kotlin-descriptors/build.gradle.kts | 29 + .../analysis-kotlin-symbols/README.md | 18 + .../api/analysis-kotlin-symbols.api | 19 + .../analysis-kotlin-symbols/build.gradle.kts | 91 + .../analysis/kotlin/symbols/kdoc/KDocProvider.kt | 174 + .../kotlin/symbols/kdoc/KdocMarkdownParser.kt | 101 + .../kotlin/symbols/kdoc/ResolveKDocLink.kt | 61 + .../kotlin/symbols/kdoc/SyntheticKDocProvider.kt | 65 + .../kdoc/java/DescriptorDocumentationContent.kt | 19 + .../kdoc/java/DescriptorKotlinDocCommentCreator.kt | 20 + .../kotlin/symbols/kdoc/java/KotlinDocComment.kt | 85 + .../symbols/kdoc/java/KotlinDocCommentParser.kt | 52 + .../java/KotlinInheritDocTagContentProvider.kt | 35 + .../IllegalModuleAndPackageDocumentation.kt | 11 + .../moduledocs/ModuleAndPackageDocumentation.kt | 15 + .../ModuleAndPackageDocumentationFragment.kt | 13 + .../ModuleAndPackageDocumentationParsingContext.kt | 63 + .../ModuleAndPackageDocumentationReader.kt | 114 + .../ModuleAndPackageDocumentationSource.kt | 18 + .../parseModuleAndPackageDocumentation.kt | 16 + .../parseModuleAndPackageDocumentationFragments.kt | 59 + .../kotlin/symbols/plugin/AnalysisContext.kt | 53 + .../kotlin/symbols/plugin/KotlinAnalysis.kt | 175 + .../kotlin/symbols/plugin/SymbolsAnalysisPlugin.kt | 126 + .../services/KotlinAnalysisProjectProvider.kt | 20 + .../services/KotlinAnalysisSourceRootsExtractor.kt | 16 + .../KotlinDocumentableSourceLanguageParser.kt | 30 + .../symbols/services/KotlinSampleProvider.kt | 100 + .../symbols/services/KtPsiDocumentableSource.kt | 24 + .../SymbolExternalDocumentablesProvider.kt | 37 + .../services/SymbolFullClassHierarchyBuilder.kt | 148 + .../symbols/services/SymbolInheritanceBuilder.kt | 89 + .../symbols/services/SymbolKotlinToJavaMapper.kt | 38 + .../SymbolSyntheticDocumentableDetector.kt | 45 + .../symbols/translators/AnnotationTranslator.kt | 147 + .../kotlin/symbols/translators/DRIFactory.kt | 144 + .../DefaultSymbolToDocumentableTranslator.kt | 957 + .../kotlin/symbols/translators/TranslatorError.kt | 33 + .../symbols/translators/TypeReferenceFactory.kt | 82 + .../kotlin/symbols/translators/TypeTranslator.kt | 201 + .../analysis/kotlin/symbols/utils/isException.kt | 22 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + dokka-subprojects/analysis-markdown-jb/README.md | 7 + .../api/analysis-markdown-jb.api | 28 + .../analysis-markdown-jb/build.gradle.kts | 19 + .../dokka/analysis/markdown/jb/MarkdownApi.kt | 12 + .../dokka/analysis/markdown/jb/MarkdownParser.kt | 554 + .../dokka/analysis/markdown/jb/ParseUtils.kt | 43 + .../jetbrains/dokka/analysis/markdown/jb/Parser.kt | 135 + .../jb/factories/DocTagsFromIElementFactory.kt | 90 + dokka-subprojects/build.gradle.kts | 8 + .../api/core-content-matcher-test-utils.api | 81 + .../build.gradle.kts | 14 + .../tools/matchers/content/ContentMatchersDsl.kt | 191 + .../test/tools/matchers/content/contentMatchers.kt | 191 + .../core-test-api/api/core-test-api.api | 198 + dokka-subprojects/core-test-api/build.gradle.kts | 18 + .../jetbrains/dokka/testApi/context/MockContext.kt | 53 + .../jetbrains/dokka/testApi/logger/TestLogger.kt | 58 + .../testRunner/TestDokkaConfigurationBuilder.kt | 219 + .../dokka/testApi/testRunner/TestRunner.kt | 235 + dokka-subprojects/core/.gitignore | 1 + dokka-subprojects/core/api/dokka-core.api | 4745 +++++ dokka-subprojects/core/build.gradle.kts | 40 + .../org/jetbrains/dokka/ConfigurationJsonUtils.kt | 54 + .../kotlin/org/jetbrains/dokka/CoreExtensions.kt | 43 + .../kotlin/org/jetbrains/dokka/DokkaBootstrap.kt | 15 + .../org/jetbrains/dokka/DokkaBootstrapImpl.kt | 69 + .../kotlin/org/jetbrains/dokka/DokkaException.kt | 7 + .../kotlin/org/jetbrains/dokka/DokkaGenerator.kt | 89 + .../kotlin/org/jetbrains/dokka/DokkaVersion.kt | 15 + .../kotlin/org/jetbrains/dokka/InternalDokkaApi.kt | 28 + .../kotlin/org/jetbrains/dokka/configuration.kt | 280 + .../org/jetbrains/dokka/defaultConfiguration.kt | 100 + .../org/jetbrains/dokka/defaultExternalLinks.kt | 33 + .../org/jetbrains/dokka/generation/Generation.kt | 19 + .../main/kotlin/org/jetbrains/dokka/links/DRI.kt | 146 + .../jetbrains/dokka/model/CompositeSourceSetID.kt | 46 + .../org/jetbrains/dokka/model/DisplaySourceSet.kt | 61 + .../org/jetbrains/dokka/model/Documentable.kt | 540 + .../kotlin/org/jetbrains/dokka/model/JvmField.kt | 14 + .../org/jetbrains/dokka/model/WithChildren.kt | 98 + .../org/jetbrains/dokka/model/additionalExtras.kt | 142 + .../org/jetbrains/dokka/model/ancestryNode.kt | 18 + .../kotlin/org/jetbrains/dokka/model/classKinds.kt | 24 + .../org/jetbrains/dokka/model/defaultValues.kt | 34 + .../kotlin/org/jetbrains/dokka/model/doc/DocTag.kt | 372 + .../jetbrains/dokka/model/doc/DocumentationNode.kt | 9 + .../org/jetbrains/dokka/model/doc/TagWrapper.kt | 36 + .../dokka/model/documentableProperties.kt | 71 + .../org/jetbrains/dokka/model/documentableUtils.kt | 27 + .../org/jetbrains/dokka/model/extraModifiers.kt | 68 + .../kotlin/org/jetbrains/dokka/model/jvmName.kt | 11 + .../dokka/model/properties/PropertyContainer.kt | 69 + .../jetbrains/dokka/model/properties/properties.kt | 36 + .../org/jetbrains/dokka/pages/ContentNodes.kt | 436 + .../kotlin/org/jetbrains/dokka/pages/PageNodes.kt | 200 + .../main/kotlin/org/jetbrains/dokka/pages/Pages.kt | 15 + .../jetbrains/dokka/pages/RendererSpecificPage.kt | 52 + .../jetbrains/dokka/pages/contentNodeProperties.kt | 37 + .../main/kotlin/org/jetbrains/dokka/pages/utils.kt | 63 + .../jetbrains/dokka/plugability/DokkaContext.kt | 235 + .../jetbrains/dokka/plugability/DokkaJavaPlugin.kt | 78 + .../org/jetbrains/dokka/plugability/DokkaPlugin.kt | 114 + .../jetbrains/dokka/plugability/LazyEvaluated.kt | 21 + .../org/jetbrains/dokka/plugability/extensions.kt | 110 + .../org/jetbrains/dokka/renderers/PostAction.kt | 7 + .../org/jetbrains/dokka/renderers/Renderer.kt | 11 + .../documentation/DefaultDocumentableMerger.kt | 307 + .../documentation/DocumentableMerger.kt | 12 + .../documentation/DocumentableToPageTranslator.kt | 13 + .../documentation/DocumentableTransformer.kt | 12 + .../PreMergeDocumentableTransformer.kt | 39 + .../dokka/transformers/pages/PageCreator.kt | 15 + .../dokka/transformers/pages/PageTransformer.kt | 11 + .../transformers/pages/PageTransformerBuilders.kt | 27 + .../sources/AsyncSourceToDocumentableTranslator.kt | 20 + .../sources/SourceToDocumentableTranslator.kt | 13 + .../org/jetbrains/dokka/utilities/Collections.kt | 29 + .../org/jetbrains/dokka/utilities/DokkaLogging.kt | 90 + .../kotlin/org/jetbrains/dokka/utilities/Html.kt | 23 + .../utilities/SelfRepresentingSingletonSet.kt | 27 + .../jetbrains/dokka/utilities/ServiceLocator.kt | 99 + .../kotlin/org/jetbrains/dokka/utilities/Uri.kt | 46 + .../dokka/utilities/associateWithNotNull.kt | 13 + .../kotlin/org/jetbrains/dokka/utilities/cast.kt | 12 + .../kotlin/org/jetbrains/dokka/utilities/json.kt | 65 + .../utilities/parallelCollectionOperations.kt | 26 + .../dokka/validity/PreGenerationChecker.kt | 17 + .../core/src/main/resources/META-INF/MANIFEST.MF | 1 + .../META-INF/dokka/dokka-version.properties | 5 + .../test/kotlin/model/CompositeSourceSetIDTest.kt | 76 + .../src/test/kotlin/model/DisplaySourceSetTest.kt | 63 + .../core/src/test/kotlin/model/DocumentableTest.kt | 115 + .../kotlin/utilities/DokkaConfigurationJsonTest.kt | 72 + .../core/src/test/kotlin/utilities/JsonKtTest.kt | 80 + .../plugin-all-modules-page/README.md | 7 + .../api/plugin-all-modules-page.api | 87 + .../plugin-all-modules-page/build.gradle.kts | 32 + .../allModulesPage/AllModulesPageGeneration.kt | 80 + .../dokka/allModulesPage/AllModulesPagePlugin.kt | 58 + .../allModulesPage/ExternalModuleLinkResolver.kt | 79 + .../allModulesPage/MultimoduleLocationProvider.kt | 59 + .../dokka/allModulesPage/MultimodulePageCreator.kt | 115 + .../allModulesPage/ResolveLinkCommandHandler.kt | 49 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + .../MultiModuleDokkaTestGenerator.kt | 98 + .../templates/MultiModuleDocumentationTest.kt | 75 + .../templates/ResolveLinkCommandResolutionTest.kt | 109 + .../ResolveLinkGfmCommandResolutionTest.kt | 76 + .../templates/mockedPackageListFactory.kt | 16 + .../plugin-android-documentation/README.md | 10 + .../api/plugin-android-documentation.api | 11 + .../plugin-android-documentation/build.gradle.kts | 31 + .../dokka/android/AndroidDocumentationPlugin.kt | 26 + .../transformers/HideTagDocumentableFilter.kt | 18 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + .../transformers/HideTagDocumentableFilterTest.kt | 75 + dokka-subprojects/plugin-base-frontend/.gitignore | 2 + .../plugin-base-frontend/build.gradle.kts | 52 + .../plugin-base-frontend/package-lock.json | 19352 +++++++++++++++++++ .../plugin-base-frontend/package.json | 61 + .../plugin-base-frontend/postcss.config.js | 20 + .../src/main/components/app/index.scss | 30 + .../src/main/components/app/index.tsx | 15 + .../src/main/components/assets/clear.svg | 7 + .../src/main/components/assets/searchIcon.svg | 7 + .../src/main/components/root.tsx | 22 + .../main/components/search/dokkaFuzzyFilter.tsx | 101 + .../main/components/search/dokkaSearchAnchor.tsx | 32 + .../src/main/components/search/search.scss | 118 + .../src/main/components/search/search.tsx | 74 + .../src/main/components/search/searchResultRow.tsx | 36 + .../src/main/components/search/types.ts | 55 + .../src/main/components/utils/hotkey.ts | 62 + .../src/main/components/utils/os.ts | 18 + .../src/main/components/utils/requests.tsx | 11 + .../plugin-base-frontend/src/main/scss/index.scss | 10 + .../src/main/types/@jetbrains/index.d.ts | 9 + .../plugin-base-frontend/stylelint.config.js | 8 + .../plugin-base-frontend/tsconfig.json | 31 + .../plugin-base-frontend/webpack.config.js | 83 + .../api/plugin-base-test-utils.api | 199 + .../plugin-base-test-utils/build.gradle.kts | 32 + .../testApi/renderers/RenderingOnlyTestBase.kt | 12 + .../dokka/base/testApi/renderers/TestPage.kt | 59 + .../base/testApi/signatures/SignatureUtils.kt | 23 + .../dokka/base/testApi/testRunner/baseTestApi.kt | 124 + .../dokka/base/testApi/utils/JsoupUtils.kt | 79 + .../dokka/base/testApi/utils/TestOutputWriter.kt | 47 + .../utils/assertHtmlEqualsIgnoringWhitespace.kt | 24 + dokka-subprojects/plugin-base/README.md | 21 + dokka-subprojects/plugin-base/api/plugin-base.api | 1541 ++ dokka-subprojects/plugin-base/build.gradle.kts | 80 + .../kotlin/org/jetbrains/dokka/base/DokkaBase.kt | 299 + .../jetbrains/dokka/base/DokkaBaseConfiguration.kt | 28 + .../base/deprecated/AnalysisApiDeprecatedError.kt | 16 + .../base/deprecated/KotlinAnalysisDeprecatedApi.kt | 77 + .../dokka/base/deprecated/ParsersDeprecatedAPI.kt | 42 + .../deprecated/ParsersFactoriesDeprecatedAPI.kt | 24 + .../TranslatorDescriptorsDeprecatedAPI.kt | 50 + .../base/deprecated/TranslatorPsiDeprecatedAPI.kt | 25 + .../base/generation/SingleModuleGeneration.kt | 131 + .../dokka/base/renderers/DefaultRenderer.kt | 257 + .../jetbrains/dokka/base/renderers/FileWriter.kt | 109 + .../jetbrains/dokka/base/renderers/OutputWriter.kt | 11 + .../dokka/base/renderers/PackageListService.kt | 80 + .../dokka/base/renderers/TabSortingStrategy.kt | 11 + .../dokka/base/renderers/contentTypeChecking.kt | 24 + .../dokka/base/renderers/html/HtmlContent.kt | 18 + .../dokka/base/renderers/html/HtmlRenderer.kt | 1013 + .../base/renderers/html/NavigationDataProvider.kt | 134 + .../dokka/base/renderers/html/NavigationPage.kt | 129 + .../base/renderers/html/SearchbarDataInstaller.kt | 128 + .../jetbrains/dokka/base/renderers/html/Tags.kt | 82 + .../consumers/ImmediateResolutionTagConsumer.kt | 37 + .../html/command/consumers/PathToRootConsumer.kt | 26 + .../command/consumers/ReplaceVersionsConsumer.kt | 29 + .../html/command/consumers/ResolveLinkConsumer.kt | 34 + .../base/renderers/html/htmlFormatingUtils.kt | 67 + .../dokka/base/renderers/html/htmlPreprocessors.kt | 172 + .../innerTemplating/DefaultTemplateModelFactory.kt | 234 + .../innerTemplating/DefaultTemplateModelMerger.kt | 20 + .../html/innerTemplating/HtmlTemplater.kt | 82 + .../html/innerTemplating/TemplateModelFactory.kt | 19 + .../html/innerTemplating/TemplateModelMerger.kt | 9 + .../renderers/html/shouldRenderSourceSetBubbles.kt | 20 + .../org/jetbrains/dokka/base/renderers/pageId.kt | 31 + .../dokka/base/renderers/preprocessors.kt | 41 + .../dokka/base/resolvers/anchors/AnchorsHint.kt | 19 + .../external/DefaultExternalLocationProvider.kt | 46 + .../DefaultExternalLocationProviderFactory.kt | 28 + .../external/Dokka010ExternalLocationProvider.kt | 46 + .../resolvers/external/ExternalLocationProvider.kt | 18 + .../external/ExternalLocationProviderFactory.kt | 11 + .../ExternalLocationProviderFactoryWithCache.kt | 21 + .../javadoc/AndroidExternalLocationProvider.kt | 18 + .../javadoc/JavadocExternalLocationProvider.kt | 62 + .../JavadocExternalLocationProviderFactory.kt | 39 + .../resolvers/local/DefaultLocationProvider.kt | 82 + .../resolvers/local/DokkaBaseLocationProvider.kt | 27 + .../base/resolvers/local/DokkaLocationProvider.kt | 182 + .../local/DokkaLocationProviderFactory.kt | 26 + .../dokka/base/resolvers/local/LocationProvider.kt | 47 + .../resolvers/local/LocationProviderFactory.kt | 11 + .../base/resolvers/shared/ExternalDocumentation.kt | 9 + .../dokka/base/resolvers/shared/LinkFormat.kt | 10 + .../dokka/base/resolvers/shared/PackageList.kt | 83 + .../base/resolvers/shared/RecognizedLinkFormat.kt | 29 + .../jetbrains/dokka/base/resolvers/shared/utils.kt | 41 + .../dokka/base/signatures/JvmSignatureUtils.kt | 231 + .../base/signatures/KotlinSignatureProvider.kt | 503 + .../dokka/base/signatures/KotlinSignatureUtils.kt | 86 + .../dokka/base/signatures/SignatureProvider.kt | 12 + .../base/templating/AddToNavigationCommand.kt | 9 + .../jetbrains/dokka/base/templating/AddToSearch.kt | 12 + .../base/templating/AddToSourcesetDependencies.kt | 10 + .../org/jetbrains/dokka/base/templating/Command.kt | 15 + .../templating/ImmediateHtmlCommandConsumer.kt | 17 + .../dokka/base/templating/InsertTemplateExtra.kt | 16 + .../templating/PathToRootSubstitutionCommand.kt | 10 + .../templating/ProjectNameSubstitutionCommand.kt | 10 + .../base/templating/ReplaceVersionsCommand.kt | 7 + .../dokka/base/templating/ResolveLinkCommand.kt | 11 + .../dokka/base/templating/jsonMapperForPlugins.kt | 62 + .../documentables/ActualTypealiasAdder.kt | 127 + .../documentables/ClashingDriIdentifier.kt | 12 + .../documentables/DefaultDocumentableMerger.kt | 0 .../DeprecatedDocumentableFilterTransformer.kt | 62 + .../DocumentableReplacerTransformer.kt | 239 + .../DocumentableVisibilityFilterTransformer.kt | 388 + .../documentables/EmptyModulesFilterTransformer.kt | 14 + .../EmptyPackagesFilterTransformer.kt | 30 + .../documentables/ExtensionExtractorTransformer.kt | 160 + ...nheritedEntriesDocumentableFilterTransformer.kt | 23 + .../InheritorsExtractorTransformer.kt | 91 + .../KotlinArrayDocumentableReplacerTransformer.kt | 68 + .../ModuleAndPackageDocumentationTransformer.kt | 47 + ...bviousFunctionsDocumentableFilterTransformer.kt | 17 + .../documentables/ReportUndocumentedTransformer.kt | 143 + .../documentables/SuppressTagDocumentableFilter.kt | 17 + ...ssedByConditionDocumentableFilterTransformer.kt | 146 + ...ByConfigurationDocumentableFilterTransformer.kt | 57 + .../dokka/base/transformers/documentables/utils.kt | 35 + .../pages/DefaultSamplesTransformer.kt | 117 + .../pages/annotations/SinceKotlinTransformer.kt | 186 + .../pages/comments/CommentsToContentConverter.kt | 22 + .../pages/comments/DocTagToContentConverter.kt | 270 + .../pages/merger/FallbackPageMergerStrategy.kt | 22 + .../base/transformers/pages/merger/PageMerger.kt | 40 + .../pages/merger/PageMergerStrategy.kt | 13 + .../merger/SameMethodNamePageMergerStrategy.kt | 68 + .../merger/SourceSetMergingPageTransformer.kt | 43 + .../pages/sourcelinks/SourceLinksTransformer.kt | 140 + .../pages/tags/CustomTagContentProvider.kt | 63 + .../pages/tags/SinceKotlinTagContentProvider.kt | 38 + .../DefaultDocumentableToPageTranslator.kt | 34 + .../documentables/DefaultPageCreator.kt | 779 + .../documentables/DeprecationSectionCreator.kt | 194 + .../documentables/DescriptionSections.kt | 349 + .../translators/documentables/DriClashAwareName.kt | 13 + .../documentables/PageContentBuilder.kt | 781 + .../documentables/briefFromContentNodes.kt | 62 + .../dokka/base/utils/CollectionExtensions.kt | 16 + .../dokka/base/utils/alphabeticalOrder.kt | 11 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + .../dokka/docs/javadoc/EnumValueOf.java.template | 12 + .../dokka/docs/javadoc/EnumValues.java.template | 8 + .../dokka/docs/kdoc/EnumEntries.kt.template | 3 + .../dokka/docs/kdoc/EnumValueOf.kt.template | 4 + .../dokka/docs/kdoc/EnumValues.kt.template | 3 + .../src/main/resources/dokka/format/gfm.properties | 6 + .../resources/dokka/format/html-as-java.properties | 6 + .../main/resources/dokka/format/html.properties | 6 + .../dokka/format/java-layout-html.properties | 6 + .../main/resources/dokka/format/jekyll.properties | 6 + .../dokka/format/kotlin-website-html.properties | 6 + .../resources/dokka/format/markdown.properties | 6 + .../resources/dokka/images/anchor-copy-button.svg | 8 + .../src/main/resources/dokka/images/arrow_down.svg | 7 + .../src/main/resources/dokka/images/burger.svg | 9 + .../src/main/resources/dokka/images/copy-icon.svg | 7 + .../dokka/images/copy-successful-icon.svg | 7 + .../resources/dokka/images/footer-go-to-link.svg | 7 + .../main/resources/dokka/images/go-to-top-icon.svg | 8 + .../src/main/resources/dokka/images/homepage.svg | 5 + .../src/main/resources/dokka/images/logo-icon.svg | 14 + .../images/nav-icons/abstract-class-kotlin.svg | 26 + .../dokka/images/nav-icons/abstract-class.svg | 20 + .../dokka/images/nav-icons/annotation-kotlin.svg | 13 + .../dokka/images/nav-icons/annotation.svg | 7 + .../dokka/images/nav-icons/class-kotlin.svg | 13 + .../resources/dokka/images/nav-icons/class.svg | 7 + .../dokka/images/nav-icons/enum-kotlin.svg | 13 + .../main/resources/dokka/images/nav-icons/enum.svg | 7 + .../dokka/images/nav-icons/exception-class.svg | 7 + .../dokka/images/nav-icons/field-value.svg | 10 + .../dokka/images/nav-icons/field-variable.svg | 10 + .../resources/dokka/images/nav-icons/function.svg | 7 + .../dokka/images/nav-icons/interface-kotlin.svg | 13 + .../resources/dokka/images/nav-icons/interface.svg | 7 + .../resources/dokka/images/nav-icons/object.svg | 13 + .../dokka/images/nav-icons/typealias-kotlin.svg | 13 + .../main/resources/dokka/images/theme-toggle.svg | 7 + .../inbound-link-resolver/dokka-default.properties | 6 + .../java-layout-html.properties | 6 + .../dokka/inbound-link-resolver/javadoc.properties | 6 + .../src/main/resources/dokka/scripts/clipboard.js | 56 + .../resources/dokka/scripts/navigation-loader.js | 95 + .../dokka/scripts/platform-content-handler.js | 400 + .../src/main/resources/dokka/scripts/prism.js | 22 + .../scripts/symbol-parameters-wrapper_deferred.js | 64 + .../resources/dokka/styles/font-jb-sans-auto.css | 36 + .../main/resources/dokka/styles/logo-styles.css | 9 + .../src/main/resources/dokka/styles/prism.css | 217 + .../src/main/resources/dokka/styles/style.css | 1513 ++ .../src/main/resources/dokka/templates/base.ftl | 44 + .../resources/dokka/templates/includes/footer.ftl | 7 + .../resources/dokka/templates/includes/header.ftl | 31 + .../dokka/templates/includes/page_metadata.ftl | 6 + .../templates/includes/source_set_selector.ftl | 9 + .../AbortGracefullyOnMissingDocumentablesTest.kt | 22 + .../plugin-base/src/test/kotlin/basic/DRITest.kt | 351 + .../src/test/kotlin/basic/DokkaBasicTests.kt | 46 + .../src/test/kotlin/basic/FailOnWarningTest.kt | 128 + .../src/test/kotlin/basic/LoggerTest.kt | 48 + .../kotlin/content/ContentInDescriptionTest.kt | 142 + .../src/test/kotlin/content/HighlightingTest.kt | 83 + .../annotations/ContentForAnnotationsTest.kt | 351 + .../content/annotations/FileLevelJvmNameTest.kt | 115 + .../content/annotations/JavaDeprecatedTest.kt | 144 + .../content/annotations/KotlinDeprecatedTest.kt | 401 + .../kotlin/content/annotations/SinceKotlinTest.kt | 350 + .../content/exceptions/ContentForExceptions.kt | 439 + .../content/functions/ContentForBriefTest.kt | 388 + .../content/functions/ContentForConstructors.kt | 53 + .../content/inheritors/ContentForInheritorsTest.kt | 499 + .../kotlin/content/params/ContentForParamsTest.kt | 1529 ++ .../ContentForClassWithParamsAndPropertiesTest.kt | 272 + .../content/receiver/ContentForReceiverTest.kt | 61 + .../content/samples/ContentForSamplesTest.kt | 207 + .../content/seealso/ContentForSeeAlsoTest.kt | 866 + .../signatures/ConstructorsSignaturesTest.kt | 469 + .../content/signatures/ContentForSignaturesTest.kt | 515 + .../kotlin/content/typealiases/TypealiasTest.kt | 83 + .../src/test/kotlin/enums/JavaEnumsTest.kt | 75 + .../src/test/kotlin/enums/KotlinEnumsTest.kt | 471 + .../src/test/kotlin/expect/AbstractExpectTest.kt | 109 + .../src/test/kotlin/expect/ExpectGenerator.kt | 17 + .../src/test/kotlin/expect/ExpectTest.kt | 28 + .../src/test/kotlin/expect/ExpectUtils.kt | 32 + .../test/kotlin/expectActuals/ExpectActualsTest.kt | 179 + .../test/kotlin/filter/DeprecationFilterTest.kt | 264 + .../test/kotlin/filter/EmptyPackagesFilterTest.kt | 70 + .../src/test/kotlin/filter/JavaFileFilterTest.kt | 40 + .../test/kotlin/filter/JavaVisibilityFilterTest.kt | 308 + .../filter/KotlinArrayDocumentableReplacerTest.kt | 211 + .../src/test/kotlin/filter/VisibilityFilterTest.kt | 755 + .../src/test/kotlin/issues/IssuesTest.kt | 59 + .../kotlin/linkableContent/LinkableContentTest.kt | 418 + .../test/kotlin/linking/EnumValuesLinkingTest.kt | 142 + .../AndroidExternalLocationProviderTest.kt | 109 + .../DefaultExternalLocationProviderTest.kt | 78 + .../Dokka010ExternalLocationProviderTest.kt | 123 + .../locationProvider/DokkaLocationProviderTest.kt | 126 + .../JavadocExternalLocationProviderTest.kt | 85 + .../locationProvider/MultiModuleLinkingTest.kt | 74 + .../src/test/kotlin/markdown/KDocTest.kt | 51 + .../src/t