fix(build): jitpack hardening and multi-module Dokka for JVM modules

- jitpack.yml: add --no-daemon, skip lint tasks (-x lint -x lintVitalRelease)
- Add configureDokkaForJvm() helper to buildSrc JvmConfiguration.kt
- Apply Dokka to JVM modules (annotations, codegen-core) via helper
- Add no-op stub in composite build's JvmConfiguration.kt
- Switch gradle-dokka.yml to multi-module: generate all 8 modules, merge into combined-docs/

Author: wax911

.github/workflows/gradle-dokka.yml

@@ -23,13 +23,25 @@ jobs:
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
       - name: Generate docs with dokka
-        run: ./gradlew :library:dokkaGeneratePublicationHtml
-        # TODO: Switch to multi-module Dokka. Currently only publishes :library facade docs
-        # (type aliases pointing to co.anitrend.retrofit.graphql.* packages).
-        # Future: use dokkaHtmlMultiModule or a composite task to document all library-type modules.
+        run: |
+          ./gradlew :annotations:dokkaGeneratePublicationHtml \
+                    :api:dokkaGeneratePublicationHtml \
+                    :android-assets:dokkaGeneratePublicationHtml \
+                    :runtime:dokkaGeneratePublicationHtml \
+                    :codegen-core:dokkaGeneratePublicationHtml \
+                    :serialization-gson:dokkaGeneratePublicationHtml \
+                    :serialization-kotlinx:dokkaGeneratePublicationHtml \
+                    :library:dokkaGeneratePublicationHtml
+          # Merge all module docs into combined-docs
+          mkdir -p combined-docs
+          for module in annotations api android-assets runtime codegen-core serialization-gson serialization-kotlinx library; do
+            if [ -d "$module/build/dokka/html" ]; then
+              cp -r "$module/build/dokka/html/"* combined-docs/ 2>/dev/null || true
+            fi
+          done
 
       - name: Deploy 🚀
         uses: JamesIves/github-pages-deploy-action@v4.8.0
         with:
           branch: docs # The branch the action should deploy to.
-          folder: library/build/dokka/html # The folder the action should deploy.
+          folder: combined-docs

annotations/build.gradle.kts

@@ -1,8 +1,10 @@
+import co.anitrend.retrofit.graphql.buildSrc.plugin.components.configureDokkaForJvm
 import co.anitrend.retrofit.graphql.buildSrc.plugin.components.configureSpotlessForJvm
 
 plugins {
     kotlin("jvm")
 }
 
 configureSpotlessForJvm()
+configureDokkaForJvm()
 

buildSrc/src/main/java/co/anitrend/retrofit/graphql/buildSrc/plugin/components/JvmConfiguration.kt

@@ -4,6 +4,7 @@ import co.anitrend.retrofit.graphql.buildSrc.plugin.extensions.libs
 import com.diffplug.gradle.spotless.SpotlessExtension
 import org.gradle.api.Project
 import org.gradle.kotlin.dsl.configure
+import org.jetbrains.dokka.gradle.DokkaExtension
 
 fun Project.configureSpotlessForJvm() {
     plugins.apply("com.diffplug.spotless")
@@ -21,3 +22,17 @@ fun Project.configureSpotlessForJvm() {
         }
     }
 }
+
+fun Project.configureDokkaForJvm() {
+    plugins.apply("org.jetbrains.dokka")
+    extensions.configure<DokkaExtension> {
+        moduleName.set("retrofit-graphql-${this@configureDokkaForJvm.name}")
+        dokkaSourceSets.configureEach {
+            skipDeprecated.set(false)
+            reportUndocumented.set(true)
+            skipEmptyPackages.set(true)
+            jdkVersion.set(21)
+            sourceRoots.from(file("src"))
+        }
+    }
+}

codegen-core/build.gradle.kts

@@ -1,10 +1,12 @@
+import co.anitrend.retrofit.graphql.buildSrc.plugin.components.configureDokkaForJvm
 import co.anitrend.retrofit.graphql.buildSrc.plugin.components.configureSpotlessForJvm
 
 plugins {
     kotlin("jvm")
 }
 
 configureSpotlessForJvm()
+configureDokkaForJvm()
 
 dependencies {
     implementation(libs.graphql.java)

gradle-plugin/buildSrc/src/main/java/co/anitrend/retrofit/graphql/buildSrc/plugin/components/JvmConfiguration.kt

@@ -27,3 +27,12 @@ fun Project.configureSpotlessForJvm() {
         }
     }
 }
+
+/**
+ * Stub for the composite build. Dokka is only needed in the root build
+ * where API docs are generated; this avoids adding a Dokka dependency
+ * to the composite build's buildSrc.
+ */
+fun Project.configureDokkaForJvm() {
+    // No-op: composite build does not generate Dokka for codegen-core
+}

jitpack.yml

@@ -3,8 +3,7 @@ jdk:
 #before_install:
 #   - ./custom_setup.sh
 install:
-  - echo "Running build commands"
-  - ./gradlew build --stacktrace
-  - ./gradlew publishMavenPublicationToMavenLocal
+  - ./gradlew build --stacktrace --no-daemon -x lint -x lintVitalRelease
+  - ./gradlew publishMavenPublicationToMavenLocal --no-daemon
 env:
   CI: "true"