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 <whyoleg@gmail.com>

8 files changed, 215 insertions, 0 deletions

diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/Clock.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/Clock.kt
new file mode 100644
index 00000000..5459b2d7
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/Clock.kt
@@ -0,0 +1,19 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+/**
+ * Documentation for expected class Clock
+ * in common module
+ */
+expect open class Clock() {
+    fun getTime(): String
+    /**
+     * Time in minis
+     */
+    fun getTimesInMillis(): String
+    fun getYear(): String
+}
+
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/House.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/House.kt
new file mode 100644
index 00000000..e79e2904
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/House.kt
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+class House(val street: String, val number: Int) {
+
+    /**
+     * The owner of the house
+     */
+    var owner: String = ""
+
+    /**
+     * The owner of the house
+     */
+    val differentOwner: String = ""
+
+    fun addFloor() {}
+
+    class Basement {
+        val pickles : List<Any> = mutableListOf()
+    }
+
+    companion object {
+        val DEFAULT = House("",0)
+    }
+}
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jsMain/kotlin/Clock.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jsMain/kotlin/Clock.kt
new file mode 100644
index 00000000..aad5787d
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jsMain/kotlin/Clock.kt
@@ -0,0 +1,32 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+import greeteer.Greeter
+import kotlin.js.Date
+
+/**
+ * Documentation for actual class Clock in JS
+ */
+actual open class Clock {
+    actual fun getTime() = Date.now().toString()
+    fun onlyJsFunction(): Int = 42
+
+    /**
+     * JS implementation of getTimeInMillis
+     */
+    actual fun getTimesInMillis(): String = Date.now().toString()
+
+    /**
+     * JS custom kdoc
+     */
+    actual fun getYear(): String {
+        TODO("not implemented") //To change body of created functions use File | Settings | File Templates.
+    }
+}
+
+fun main() {
+    Greeter().greet().also { println(it) }
+}
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmAndJsSecondCommonMain/kotlin/Greeter.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmAndJsSecondCommonMain/kotlin/Greeter.kt
new file mode 100644
index 00000000..e9e15d0b
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmAndJsSecondCommonMain/kotlin/Greeter.kt
@@ -0,0 +1,14 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package greeteer
+
+import example.Clock
+
+class Greeter {
+    /**
+     * Some docs for the [greet] function
+     */
+    fun greet() = Clock().let{ "Hello there! THe time is ${it.getTime()}" }
+}
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/Clock.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/Clock.kt
new file mode 100644
index 00000000..f38ff749
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/Clock.kt
@@ -0,0 +1,43 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+import greeteer.Greeter
+
+/**
+ * Documentation for actual class Clock in JVM
+ */
+actual open class Clock {
+    actual fun getTime(): String = System.currentTimeMillis().toString()
+
+    /**
+     * Time in minis
+     */
+    actual fun getTimesInMillis(): String = System.currentTimeMillis().toString()
+
+    /**
+     * Documentation for onlyJVMFunction on...
+     * wait for it...
+     * ...JVM!
+     */
+    fun onlyJVMFunction(): Double = 2.5
+
+    open fun getDayOfTheWeek(): String {
+        TODO("not implemented")
+    }
+
+    /**
+     * JVM custom kdoc
+     */
+    actual fun getYear(): String {
+        TODO("not implemented")
+    }
+}
+
+fun clockList() = listOf(Clock())
+
+fun main() {
+    Greeter().greet().also { println(it) }
+}
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ClockDays.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ClockDays.kt
new file mode 100644
index 00000000..e96acf1c
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ClockDays.kt
@@ -0,0 +1,19 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+/**
+ * frgergergrthe
+ * */
+enum class ClockDays {
+    /**
+     * dfsdfsdfds
+     * */
+    FIRST,
+    SECOND, // test2
+    THIRD,  // test3
+    FOURTH,  // test4
+    FIFTH // test5
+}
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/HtmlTest.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/HtmlTest.kt
new file mode 100644
index 00000000..2fa3622b
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/HtmlTest.kt
@@ -0,0 +1,24 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+/**
+ * <!-- this shouldn't be visible -->
+ */
+class HtmlTest {
+    /**
+     * This is an example <!-- not visible --> of html
+     */
+    fun test(){
+
+    }
+
+    /**
+     * This is an <b> documentation </b>
+     */
+    fun testP(){
+
+    }
+}
diff --git a/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ParticularClock.kt b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ParticularClock.kt
new file mode 100644
index 00000000..3b7a403d
--- /dev/null
+++ b/dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ParticularClock.kt
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package example
+
+import greeteer.Greeter
+
+class ParticularClock(private val clockDay: ClockDays) : Clock() {
+
+    /**
+     * Rings bell [times]
+     */
+    fun ringBell(times: Int) {}
+
+    /**
+     * Uses provider [greeter]
+     */
+    fun useGreeter(greeter: Greeter) {
+
+    }
+
+    /**
+     * Day of the week
+     */
+    override fun getDayOfTheWeek() = clockDay.name
+}
+
+/**
+ * A sample extension function
+ * When $a \ne 0$, there are two solutions to \(ax^2 + bx + c = 0\) and they are $$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$
+ * @usesMathJax
+ */
+fun Clock.extensionFun() {
+
+}