WASM target implementation (#3849)

Fixes #3713

Author: igoriakovlev

README.md

@@ -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

@@ -157,7 +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/compile-wasm-multiplatform.gradle")
+
         kotlin.sourceSets.commonMain.dependencies {
             api project(":$coreModule")
         }
@@ -335,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/KotlinVersion.kt

@@ -12,6 +12,13 @@ kotlin {
     }
 
     sourceSets {
+        jsMain {
+            dependsOn(jsAndWasmSharedMain)
+        }
+        jsTest {
+            dependsOn(jsAndWasmSharedTest)
+        }
+
         jsTest.dependencies {
             api "org.jetbrains.kotlin:kotlin-test-js:$kotlin_version"
         }

gradle/compile-js-multiplatform.gradle

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2016-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+kotlin {
+    sourceSets {
+        jsAndWasmSharedMain {
+            dependsOn(commonMain)
+        }
+        jsAndWasmSharedTest {
+            dependsOn(commonTest)
+        }
+    }
+}
+
+// Disable intermediate sourceSet compilation because we do not need js-wasmJs artifact
+tasks.configureEach {
+    if (name == 'compileJsAndWasmSharedMainKotlinMetadata') {
+        enabled = false
+    }
+}

gradle/compile-jsAndWasmShared-multiplatform.gradle

@@ -1,5 +1,3 @@
-import static KotlinVersion.isKotlinVersionAtLeast
-
 /*
  * Copyright 2016-2021 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
  */

gradle/compile-native-multiplatform.gradle

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2016-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+kotlin {
+    wasmJs {
+        moduleName = project.name
+        nodejs()
+        compilations['main']?.dependencies {
+            api "org.jetbrains.kotlinx:atomicfu-wasm-js:$atomicfu_version"
+        }
+    }
+
+    sourceSets {
+        wasmJsMain {
+            dependsOn(jsAndWasmSharedMain)
+        }
+        wasmJsTest {
+            dependsOn(jsAndWasmSharedTest)
+        }
+
+        wasmJsTest.dependencies {
+            api "org.jetbrains.kotlin:kotlin-test-wasm-js:$kotlin_version"
+        }
+    }
+}

gradle/compile-wasm-multiplatform.gradle

@@ -45,6 +45,8 @@ tasks.withType(DokkaTaskPartial::class).configureEach {
     }
 }
 
+val kotlin_version: String by project
+
 if (project.name == "kotlinx-coroutines-core") {
     // Custom configuration for MPP modules
     tasks.withType(DokkaTaskPartial::class).configureEach {
@@ -64,6 +66,10 @@ if (project.name == "kotlinx-coroutines-core") {
             val jvmMain by getting {
                 makeLinkMapping(project.file("jvm"))
             }
+
+            val wasmJsMain by getting {
+                makeLinkMapping(project.file("wasm"))
+            }
         }
     }
 }

gradle/dokka.gradle.kts

@@ -179,3 +179,8 @@ compileKotlin {
         jvmTarget = "1.8"
     }
 }
+
+// Drop this when node js version become stable
+tasks.withType(org.jetbrains.kotlin.gradle.targets.js.npm.tasks.KotlinNpmInstallTask.class).configureEach {
+    it.args.add("--ignore-engines")
+}

integration-testing/build.gradle

@@ -3,17 +3,20 @@ plugins {
 }
 
 repositories {
-    // Coroutines from the outer project are published by previous CI buils step
-    mavenLocal()
     mavenCentral()
     maven { url "https://maven.pkg.jetbrains.space/kotlin/p/kotlin/dev" }
+    // Coroutines from the outer project are published by previous CI buils step
+    mavenLocal()
 }
 
 kotlin {
     jvm()
     js(IR) {
         nodejs()
     }
+    wasmJs() {
+        nodejs()
+    }
 
     sourceSets {
         commonMain {
@@ -34,6 +37,11 @@ kotlin {
                 implementation kotlin('test-js')
             }
         }
+        wasmJsTest {
+            dependencies {
+                implementation kotlin('test-wasm-js')
+            }
+        }
         jvmTest {
             dependencies {
                 implementation kotlin('test')
@@ -50,3 +58,11 @@ kotlin {
     }
 }
 
+// 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
+rootProject.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"
+}