Version 1.8.0-RC

CHANGES.md

@@ -1,5 +1,20 @@
 # Change log for kotlinx.coroutines
 
+## Version 1.8.0-RC
+
+* Implement the library for the Web Assembly (Wasm) for JavaScript (#3713). Thanks @igoriakovlev!
+* On Android, ensure that `Dispatchers.Main != Dispatchers.Main.immediate` (#3545, #3963).
+* `kotlinx-coroutines-debug` is published with the incorrect Java 9 module info (#3944).
+* Major Kotlin version update: was 1.8.20, became 1.9.21.
+* `kotlinx-coroutines-test`: set the default timeout of `runTest` to 60 seconds, added the ability to configure it on the JVM with the `kotlinx.coroutines.test.default_timeout=10s` (#3800).
+* `kotlinx-coroutines-test`: fixed a bug that could lead to not all uncaught exceptions being reported after some tests failed (#3800).
+* `delay(Duration)` rounds nanoseconds up to whole milliseconds and not down (#3920). Thanks @kevincianfarini!
+* `Dispatchers.Default` and the default thread for background work are guaranteed to use the same context classloader as the object containing it them (#3832).
+* It is guaranteed that by the time `SharedFlow.collect` suspends for the first time, it's registered as a subscriber for that `SharedFlow` (#3885). Before, it was also true, but not documented.
+* Atomicfu version is updated to 0.23.1, and Kotlin/Native atomic transformations are enabled, reducing the footprint of coroutine-heavy code (#3954).
+* Added a workaround for miscompilation of `withLock` on JS (#3881). Thanks @CLOVIS-AI!
+* Small tweaks and documentation fixes.
+
 ## Version 1.7.3
 
 * Disabled the publication of the multiplatform library metadata for the old (1.6 and earlier) KMP Gradle plugin (#3809).

README.md

@@ -3,12 +3,12 @@
 [![Kotlin Stable](https://kotl.in/badges/stable.svg)](https://kotlinlang.org/docs/components-stability.html)
 [![JetBrains official project](https://jb.gg/badges/official.svg)](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
 [![GitHub license](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat)](https://www.apache.org/licenses/LICENSE-2.0)
-[![Download](https://img.shields.io/maven-central/v/org.jetbrains.kotlinx/kotlinx-coroutines-core/1.7.3)](https://central.sonatype.com/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-core/1.7.3)
-[![Kotlin](https://img.shields.io/badge/kotlin-1.8.20-blue.svg?logo=kotlin)](http://kotlinlang.org)
+[![Download](https://img.shields.io/maven-central/v/org.jetbrains.kotlinx/kotlinx-coroutines-core/1.8.0-RC)](https://central.sonatype.com/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-core/1.8.0-RC)
+[![Kotlin](https://img.shields.io/badge/kotlin-1.9.21-blue.svg?logo=kotlin)](http://kotlinlang.org)
 [![Slack channel](https://img.shields.io/badge/chat-slack-green.svg?logo=slack)](https://kotlinlang.slack.com/messages/coroutines/)
 
 Library support for Kotlin coroutines with [multiplatform](#multiplatform) support.
-This is a companion version for the Kotlin `1.8.20` release.
+This is a companion version for the Kotlin `1.9.21` release.
 
 ```kotlin
 suspend fun main() = coroutineScope {
@@ -85,15 +85,15 @@ Add dependencies (you can also add other modules that you need):
 <dependency>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines-core</artifactId>
-    <version>1.7.3</version>
+    <version>1.8.0-RC</version>
 </dependency>
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```xml
 <properties>
-    <kotlin.version>1.8.20</kotlin.version>
+    <kotlin.version>1.9.21</kotlin.version>
 </properties>
 ```
 
@@ -103,7 +103,7 @@ Add dependencies (you can also add other modules that you need):
 
 ```kotlin
 dependencies {
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0-RC")
 }
 ```
 
@@ -112,10 +112,10 @@ And make sure that you use the latest Kotlin version:
 ```kotlin
 plugins {
     // For build.gradle.kts (Kotlin DSL)
-    kotlin("jvm") version "1.8.20"
+    kotlin("jvm") version "1.9.21"
 
     // For build.gradle (Groovy DSL)
-    id "org.jetbrains.kotlin.jvm" version "1.8.20"
+    id "org.jetbrains.kotlin.jvm" version "1.9.21"
 }
 ```
 
@@ -133,7 +133,7 @@ Add [`kotlinx-coroutines-android`](ui/kotlinx-coroutines-android)
 module as a dependency when using `kotlinx.coroutines` on Android:
 
 ```kotlin
-implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
+implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.0-RC")
 ```
 
 This gives you access to the Android [Dispatchers.Main]
@@ -168,7 +168,7 @@ In common code that should get compiled for different platforms, you can add a d
 ```kotlin
 commonMain {
     dependencies {
-        implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
+        implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0-RC")
     }
 }
 ```
@@ -180,7 +180,7 @@ Platform-specific dependencies are recommended to be used only for non-multiplat
 #### JS
 
 Kotlin/JS version of `kotlinx.coroutines` is published as 
-[`kotlinx-coroutines-core-js`](https://central.sonatype.com/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-core-js/1.7.3)
+[`kotlinx-coroutines-core-js`](https://central.sonatype.com/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-core-js/1.8.0-RC)
 (follow the link to get the dependency declaration snippet) and as [`kotlinx-coroutines-core`](https://www.npmjs.com/package/kotlinx-coroutines-core) NPM package. 
 
 #### Native
@@ -215,7 +215,7 @@ See [Contributing Guidelines](CONTRIBUTING.md).
 [Dispatchers.IO]: https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-i-o.html
 [asCoroutineDispatcher]: https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/as-coroutine-dispatcher.html
 [Promise.await]: https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/await.html
-[promise]: https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/promise.html
+[promise]: https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/[js]promise.html
 [Window.asCoroutineDispatcher]: https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/as-coroutine-dispatcher.html
 
 <!--- INDEX kotlinx.coroutines.flow -->

build.gradle

@@ -6,8 +6,6 @@
 import org.jetbrains.kotlin.config.KotlinCompilerVersion
 import org.jetbrains.kotlin.gradle.plugin.KotlinPlatformType
 import org.jetbrains.kotlin.gradle.targets.js.nodejs.NodeJsRootExtension
-import org.jetbrains.kotlin.gradle.targets.js.nodejs.NodeJsRootPlugin
-import org.jetbrains.kotlin.gradle.targets.js.yarn.YarnPlugin
 import org.jetbrains.kotlin.gradle.targets.js.yarn.YarnRootExtension
 import org.jetbrains.kotlin.konan.target.HostManager
 import org.jetbrains.dokka.gradle.DokkaTaskPartial
@@ -63,7 +61,6 @@ buildscript {
         classpath "org.jetbrains.dokka:dokka-gradle-plugin:$dokka_version"
         classpath "org.jetbrains.kotlinx:atomicfu-gradle-plugin:$atomicfu_version"
         classpath "org.jetbrains.kotlinx:kotlinx-knit:$knit_version"
-        classpath "com.github.node-gradle:gradle-node-plugin:$gradle_node_version"
         classpath "org.jetbrains.kotlinx:binary-compatibility-validator:$binary_compatibility_validator_version"
         classpath "ru.vyarus:gradle-animalsniffer-plugin:1.5.4" // Android API check
         classpath "org.jetbrains.kotlin:atomicfu:$kotlin_version"
@@ -160,8 +157,12 @@ configure(subprojects.findAll { !sourceless.contains(it.name) && it.name != core
             apply from: rootProject.file("gradle/compile-native-multiplatform.gradle")
         }
 
+        apply from: rootProject.file("gradle/compile-jsAndWasmShared-multiplatform.gradle")
+
         apply from: rootProject.file("gradle/compile-js-multiplatform.gradle")
-        apply from: rootProject.file("gradle/publish-npm-js.gradle")
+
+        apply from: rootProject.file("gradle/compile-wasm-multiplatform.gradle")
+
         kotlin.sourceSets.commonMain.dependencies {
             api project(":$coreModule")
         }
@@ -181,6 +182,7 @@ configure(subprojects.findAll { !sourceless.contains(it.name) && it.name != core
 
 apply plugin: "bom-conventions"
 apply plugin: "java-modularity-conventions"
+apply plugin: "version-file-conventions"
 
 if (build_snapshot_train) {
     println "Hacking test tasks, removing stress and flaky tests"
@@ -256,40 +258,6 @@ configure(subprojects.findAll { !unpublished.contains(it.name) }) {
             }
         }
     }
-
-    def thisProject = it
-    if (thisProject.name in sourceless) {
-        return
-    }
-
-    def versionFileTask = thisProject.tasks.register("versionFileTask") {
-        def name = thisProject.name.replace("-", "_")
-        def versionFile = thisProject.layout.buildDirectory.file("${name}.version")
-        it.outputs.file(versionFile)
-
-        it.doLast {
-            versionFile.get().asFile.text = version.toString()
-        }
-    }
-
-    List<String> jarTasks
-    if (isMultiplatform(it)) {
-        jarTasks = ["jvmJar"]
-    } else if (it.name == "kotlinx-coroutines-debug") {
-        // We shadow debug module instead of just packaging it
-        jarTasks = ["shadowJar"]
-    } else {
-        jarTasks = ["jar"]
-    }
-
-    for (name in jarTasks) {
-        thisProject.tasks.named(name, Jar) {
-            it.dependsOn versionFileTask
-            it.from(versionFileTask) {
-                into("META-INF")
-            }
-        }
-    }
 }
 
 // Report Kotlin compiler version when building project
@@ -303,7 +271,7 @@ allprojects {
 
 // --------------- Configure sub-projects that are published ---------------
 
-def publishTasks = getTasksByName("publish", true) + getTasksByName("publishNpm", true)
+def publishTasks = getTasksByName("publish", true)
 
 task deploy(dependsOn: publishTasks)
 
@@ -372,3 +340,17 @@ if (CacheRedirector.enabled) {
         nodeJsExtension.nodeDownloadBaseUrl = CacheRedirector.maybeRedirect(nodeJsExtension.nodeDownloadBaseUrl)
     }
 }
+
+// Drop this configuration when the Node.JS version in KGP will support wasm gc milestone 4
+// check it here:
+// https://github.com/JetBrains/kotlin/blob/master/libraries/tools/kotlin-gradle-plugin/src/common/kotlin/org/jetbrains/kotlin/gradle/targets/js/nodejs/NodeJsRootExtension.kt
+extensions.findByType(org.jetbrains.kotlin.gradle.targets.js.nodejs.NodeJsRootExtension.class).with {
+    // canary nodejs that supports recent Wasm GC changes
+    it.nodeVersion = "21.0.0-v8-canary202309167e82ab1fa2"
+    it.nodeDownloadBaseUrl = "https://nodejs.org/download/v8-canary"
+}
+
+// Drop this when node js version become stable
+tasks.withType(org.jetbrains.kotlin.gradle.targets.js.npm.tasks.KotlinNpmInstallTask).configureEach {
+    args.add("--ignore-engines")
+}

buildSrc/src/main/kotlin/CommunityProjectsBuild.kt

@@ -15,7 +15,7 @@ private val LOGGER: Logger = Logger.getLogger("Kotlin settings logger")
  * Functions in this file are responsible for configuring kotlinx.coroutines build against a custom dev version
  * of Kotlin compiler.
  * Such configuration is used in a composite community build of Kotlin in order to check whether not-yet-released changes
- * are compatible with our libraries (aka "integration testing that substitues lack of unit testing").
+ * are compatible with our libraries (aka "integration testing that substitutes lack of unit testing").
  */
 
 /**

buildSrc/src/main/kotlin/VersionFile.kt

@@ -0,0 +1,29 @@
+/*
+ * Copyright 2016-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+import org.gradle.api.*
+import org.gradle.api.tasks.*
+
+/**
+ * Adds 'module_name.version' file to the project's JAR META-INF
+ * for the better toolability. See #2941
+ */
+object VersionFile {
+    fun registerVersionFileTask(project: Project): TaskProvider<Task> {
+        val versionFile = project.layout.buildDirectory.file("${project.name.replace('-', '_')}.version")
+        val version = project.version.toString()
+        return project.tasks.register("versionFileTask") {
+            outputs.file(versionFile)
+            doLast {
+                versionFile.get().asFile.writeText(version)
+            }
+        }
+    }
+
+    fun fromVersionFile(target: AbstractCopyTask, versionFileTask: TaskProvider<Task>) {
+        target.from(versionFileTask) {
+            into("META-INF")
+        }
+    }
+}

buildSrc/src/main/kotlin/configure-compilation-conventions.gradle.kts

@@ -10,7 +10,7 @@ configure(subprojects) {
     if (name in sourceless) return@configure
     apply(plugin = "kotlinx-atomicfu")
     tasks.withType<KotlinCompile<*>>().configureEach {
-        val isMainTaskName = name == "compileKotlin" || name == "compileKotlinJvm"
+        val isMainTaskName = name.startsWith("compileKotlin")
         kotlinOptions {
             languageVersion = getOverriddenKotlinLanguageVersion(project)
             apiVersion = getOverriddenKotlinApiVersion(project)
@@ -19,13 +19,16 @@ configure(subprojects) {
             }
             val newOptions =
                 listOf(
-                    "-progressive", "-Xno-param-assertions", "-Xno-receiver-assertions",
-                    "-Xno-call-assertions"
+                    "-progressive",
+                    "-Xno-param-assertions",
+                    "-Xno-receiver-assertions",
+                    "-Xexpect-actual-classes",
+                    "-Xno-call-assertions",
                 ) + optInAnnotations.map { "-opt-in=$it" }
             freeCompilerArgs = freeCompilerArgs + newOptions
         }
     }
 }
 
 val KotlinCommonOptions.versionsAreNotOverridden: Boolean
-    get() = languageVersion == null && apiVersion == null
+    get() = languageVersion == null && apiVersion == null

buildSrc/src/main/kotlin/kotlin-js-conventions.gradle.kts

@@ -5,6 +5,7 @@
 // Platform-specific configuration to compile JS modules
 
 import org.jetbrains.kotlin.gradle.dsl.KotlinJsCompile
+import org.jetbrains.kotlin.gradle.targets.js.*
 
 plugins {
     kotlin("js")
@@ -15,7 +16,7 @@ dependencies {
 }
 
 kotlin {
-    js(LEGACY) {
+    js(IR) {
         moduleName = project.name.removeSuffix("-js")
     }
 
@@ -35,6 +36,5 @@ tasks.withType<KotlinJsCompile> {
     kotlinOptions {
         moduleKind = "umd"
         sourceMap = true
-        metaInfo = true
     }
 }

buildSrc/src/main/kotlin/version-file-conventions.gradle.kts

@@ -0,0 +1,17 @@
+import org.gradle.api.tasks.bundling.*
+
+configure(subprojects.filter { !unpublished.contains(it.name) && it.name !in sourceless }) {
+    val project = this
+    val jarTaskName = when {
+        project.name == "kotlinx-coroutines-debug" -> {
+            project.apply(plugin = "com.github.johnrengelman.shadow")
+            "shadowJar"
+        }
+        isMultiplatform -> "jvmJar"
+        else -> "jar"
+    }
+    val versionFileTask = VersionFile.registerVersionFileTask(project)
+    tasks.withType(Jar::class.java).named(jarTaskName) {
+        VersionFile.fromVersionFile(this, versionFileTask)
+    }
+}

gradle.properties

@@ -3,14 +3,14 @@
 #
 
 # Kotlin
-version=1.7.3-SNAPSHOT
+version=1.8.0-RC-SNAPSHOT
 group=org.jetbrains.kotlinx
-kotlin_version=1.8.20
+kotlin_version=1.9.21
 
 # Dependencies
 junit_version=4.12
 junit5_version=5.7.0
-atomicfu_version=0.21.0
+atomicfu_version=0.23.1
 knit_version=0.5.0-Beta
 html_version=0.7.2
 lincheck_version=2.18.1
@@ -33,18 +33,6 @@ androidx_annotation_version=1.1.0
 robolectric_version=4.9
 baksmali_version=2.2.7
 
-# JS
-kotlin.js.compiler=both
-gradle_node_version=3.1.1
-node_version=10.0.0
-npm_version=5.7.1
-mocha_version=6.2.2
-mocha_headless_chrome_version=1.8.2
-mocha_teamcity_reporter_version=3.0.0
-source_map_support_version=0.5.16
-jsdom_version=15.2.1
-jsdom_global_version=3.0.2
-
 # Settings
 kotlin.incremental.multiplatform=true
 kotlin.native.ignoreDisabledTargets=true
@@ -58,3 +46,4 @@ kotlinx.atomicfu.enableJvmIrTransformation=true
 # When the flag below is set to `true`, AtomicFU cannot process
 # usages of `moveForward` in `ConcurrentLinkedList.kt` correctly.
 kotlinx.atomicfu.enableJsIrTransformation=false
+kotlinx.atomicfu.enableNativeIrTransformation=true