🔧 chore(deps): update gradle and library versions

- update gradle wrapper to version 9.7.1
- update exposed library version from 1.4.0 to 1.5.0
- update version in gradle.properties from 2.3.3 to 2.3.4

Author: twisti-dev

build.gradle.kts

@@ -1,8 +1,11 @@
 import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar.Companion.shadowJar
 import dev.slne.surf.api.gradle.util.slneReleases
+import org.gradle.api.artifacts.MinimalExternalModuleDependency
+import org.jetbrains.dokka.gradle.tasks.DokkaGenerateTask
 
 plugins {
     id("dev.slne.surf.api.gradle.core") version "+"
+    id("org.jetbrains.dokka-javadoc") version "2.2.0"
 }
 
 surfCoreApi {
@@ -34,6 +37,155 @@ shadow {
     addShadowVariantIntoJavaComponent = false
 }
 
+val relocationPrefix = "dev.slne.surf.database.libs"
+val relocationPrefixPath = relocationPrefix.replace('.', '/')
+
+val relocationExtraDepth = relocationPrefixPath.split('/').size
+
+val shadedRoots = listOf(
+    "org.jetbrains.exposed",
+    "io.r2dbc",
+    "io.netty",
+    "org.mariadb",
+    "com.ongres",
+    "org.jspecify",
+    "kotlinx.datetime",
+    "reactor.netty",
+    "reactor.pool",
+)
+
+val relocationRewrites = shadedRoots.flatMap { root ->
+    listOf(
+        root to "$relocationPrefix.$root",
+        root.replace('.', '/') to "$relocationPrefixPath/${root.replace('.', '/')}",
+    )
+}
+
+fun String.applyRelocations(): String {
+    var rewritten = this
+    for ((from, to) in relocationRewrites) {
+        if (rewritten.contains(from)) rewritten = rewritten.replace(from, to)
+    }
+    return rewritten
+}
+
+fun docsConfiguration(
+    configurationName: String,
+    classifier: String,
+    modules: List<Provider<MinimalExternalModuleDependency>>,
+): Configuration {
+    val configuration = configurations.create(configurationName) {
+        isCanBeConsumed = false
+        isCanBeResolved = true
+        isTransitive = false
+    }
+
+    dependencies {
+        modules.forEach { module ->
+            add(configurationName, variantOf(module) { classifier(classifier) })
+        }
+    }
+
+    return configuration
+}
+
+fun registerDocsRelocation(
+    taskName: String,
+    source: Configuration,
+    outputDirectory: String,
+    includes: List<String>,
+    textFileSuffixes: List<String>,
+    rewriteLinkDepth: Boolean,
+) = tasks.register<Sync>(taskName) {
+    description = "Rewrites bundled dependency documentation onto the shaded package names."
+    group = JavaBasePlugin.DOCUMENTATION_GROUP
+
+    into(layout.buildDirectory.dir(outputDirectory))
+    includeEmptyDirs = false
+    filteringCharset = Charsets.UTF_8.name()
+
+    inputs.property("relocationRewrites", relocationRewrites.toString())
+    inputs.property("rewriteLinkDepth", rewriteLinkDepth)
+
+    from(source.elements.map { jars -> jars.map(::zipTree) }) {
+        includes.forEach { include(it) }
+
+        eachFile {
+            val depth = relativePath.segments.size - 1
+
+            if (textFileSuffixes.any { name.endsWith(it) }) {
+                filter { line ->
+                    val relinked = if (rewriteLinkDepth) {
+                        line.replace(
+                            "../".repeat(depth),
+                            "../".repeat(depth + relocationExtraDepth),
+                        )
+                    } else {
+                        line
+                    }
+
+                    relinked.applyRelocations()
+                }
+            }
+
+            path = "$relocationPrefixPath/$path"
+        }
+    }
+}
+
+val sourceDocModules = listOf(
+    libs.exposed.core,
+    libs.exposed.r2dbc,
+    libs.exposed.java.time,
+    libs.exposed.json,
+    libs.exposed.migration.r2dbc,
+    libs.r2dbc.pool,
+    libs.r2dbc.mariadb,
+    libs.r2dbc.postgresql,
+)
+
+val javadocDocModules = listOf(
+    libs.r2dbc.pool,
+    libs.r2dbc.mariadb,
+    libs.r2dbc.postgresql,
+)
+
+val relocateDependencySources = registerDocsRelocation(
+    taskName = "relocateDependencySources",
+    source = docsConfiguration("dependencyDocsSources", "sources", sourceDocModules),
+    outputDirectory = "docs/relocated-sources",
+    includes = listOf("org/jetbrains/exposed/**", "io/r2dbc/**", "org/mariadb/**"),
+    textFileSuffixes = listOf(".kt", ".java"),
+    rewriteLinkDepth = false,
+)
+
+val relocateDependencyJavadoc = registerDocsRelocation(
+    taskName = "relocateDependencyJavadoc",
+    source = docsConfiguration("dependencyDocsJavadoc", "javadoc", javadocDocModules),
+    outputDirectory = "docs/relocated-javadoc",
+    includes = listOf("io/r2dbc/**", "org/mariadb/**"),
+    textFileSuffixes = listOf(".html"),
+    rewriteLinkDepth = true,
+)
+
+tasks.javadoc {
+    setSource(files())
+    setDestinationDir(layout.buildDirectory.dir("docs/javadoc-unused").get().asFile)
+}
+
+tasks.named<Jar>("javadocJar") {
+    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+
+    from(tasks.named<DokkaGenerateTask>("dokkaGeneratePublicationJavadoc").flatMap { it.outputDirectory })
+    from(relocateDependencyJavadoc)
+}
+
+tasks.named<Jar>("sourcesJar") {
+    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+
+    from(relocateDependencySources)
+}
+
 java {
     withSourcesJar()
     withJavadocJar()
@@ -50,6 +202,10 @@ tasks {
     }
 }
 
+val shadowComponent = components["shadow"] as AdhocComponentWithVariants
+shadowComponent.addVariantsFromConfiguration(configurations["sourcesElements"]) {}
+shadowComponent.addVariantsFromConfiguration(configurations["javadocElements"]) {}
+
 publishing {
     publications {
         create<MavenPublication>("shadow") {
@@ -64,13 +220,13 @@ publishing {
 
 
 /**
- * Only publish shadow variant
+ * Only publish the shadow variant; the auto-created pluginMaven publication would claim the same
+ * coordinates.
  */
 afterEvaluate {
-    tasks.named("publishPluginMavenPublicationToSlne-repository-releasesRepository") {
-        enabled = false
-    }
-    tasks.named("publishPluginMavenPublicationToMavenLocal") {
-        enabled = false
+    tasks.withType<AbstractPublishToMaven>().configureEach {
+        onlyIf("only the shadow publication owns these coordinates") {
+            publication.name != "pluginMaven"
+        }
     }
-}
+}

gradle.properties

@@ -3,4 +3,4 @@ kotlin.stdlib.default.dependency=false
 org.gradle.parallel=true
 #org.gradle.caching=true
 #org.gradle.configureondemand=true
-version=2.3.3
+version=2.3.4

gradle/libs.versions.toml

@@ -1,5 +1,5 @@
 [versions]
-exposed = "1.4.0"
+exposed = "1.5.0"
 r2dbc-mariadb = "1.4.1"
 r2dbc-postgresql = "1.1.2.RELEASE"
 r2dbc-pool = "1.0.2.RELEASE"

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.7.1-bin.zip
 networkTimeout=10000
 retries=0
 retryBackOffMs=500