build: upgrade Kotlin to 2.4.0

Bump the Kotlin version in the catalog from 2.3.21 to 2.4.0. The version is the
single source of truth for the kotlin("jvm") plugin and kotlin-reflect, so the
one change applies to every module.

Add org.jetbrains:annotations 26.0.2 as a compile-only dependency on every Kotlin
module (alongside slf4j-api). kotlin-stdlib transitively pins the ancient
annotations 13.0, which predates @UnknownNullability; the 2.4.0 toolchain
materialises inferred platform types with that annotation, and resolving it
against 13.0 fails ("type annotation class ... is inaccessible"). Keeping it
compile-only keeps it out of the published POM and the binary-compat ABI snapshots.

Verified with a full ./gradlew build (ktlint, detekt, apiCheck, Kover floor, and
the R8 shrink-survival guard all pass).

Author: OmarAlJarrah

build.gradle.kts

@@ -142,6 +142,11 @@ allprojects {
 
         dependencies {
             add("compileOnly", libs.slf4j.api)
+            // Modern nullability annotations on the compile classpath. kotlin-stdlib pins the ancient
+            // org.jetbrains:annotations:13.0 transitively, which lacks @UnknownNullability; Kotlin 2.4.0
+            // tooling materialises inferred platform types with that annotation and reports it as
+            // inaccessible against 13.0. compileOnly keeps it out of the published POM and ABI.
+            add("compileOnly", libs.jetbrains.annotations)
         }
     }
 

gradle/libs.versions.toml

@@ -1,7 +1,11 @@
 [versions]
-kotlin = "2.3.21"
+kotlin = "2.4.0"
 kotlinx-coroutines = "1.11.0"
 slf4j = "2.0.18"
+# Compile-only nullability annotations (@NotNull/@Nullable/@UnknownNullability). kotlin-stdlib drags
+# in the ancient 13.0 transitively, which predates UnknownNullability; Kotlin 2.4.0 tooling materialises
+# inferred platform types with that annotation, so a modern version must be on the compile classpath.
+jetbrains-annotations = "26.0.2"
 okio = "3.17.0"
 okhttp = "5.0.0"
 mockwebserver = "5.0.0"
@@ -19,6 +23,7 @@ detekt = "1.23.6"
 
 [libraries]
 kotlin-reflect = { module = "org.jetbrains.kotlin:kotlin-reflect", version.ref = "kotlin" }
+jetbrains-annotations = { module = "org.jetbrains:annotations", version.ref = "jetbrains-annotations" }
 slf4j-api = { module = "org.slf4j:slf4j-api", version.ref = "slf4j" }
 slf4j-nop = { module = "org.slf4j:slf4j-nop", version.ref = "slf4j" }
 kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinx-coroutines" }