[K/JS] Introduce a compiler argument to enable export of suspend functions

^KT-82668 Fixed

Author: JSMonk

compiler/arguments/resources/kotlin-compiler-arguments.json

@@ -7251,6 +7251,37 @@
                                                     "removedVersion": null
                                                 }
                                             },
+                                            {
+                                                "name": "Xenable-suspend-function-exporting",
+                                                "shortName": null,
+                                                "deprecatedName": null,
+                                                "description": {
+                                                    "current": "Enable exporting suspend functions to JavaScript/TypeScript.",
+                                                    "valueInVersions": []
+                                                },
+                                                "delimiter": null,
+                                                "valueType": {
+                                                    "type": "org.jetbrains.kotlin.arguments.dsl.types.BooleanType",
+                                                    "isNullable": {
+                                                        "current": false,
+                                                        "valueInVersions": []
+                                                    },
+                                                    "defaultValue": {
+                                                        "current": false,
+                                                        "valueInVersions": []
+                                                    }
+                                                },
+                                                "valueDescription": {
+                                                    "current": null,
+                                                    "valueInVersions": []
+                                                },
+                                                "releaseVersionsMetadata": {
+                                                    "introducedVersion": "2.3.0",
+                                                    "stabilizedVersion": null,
+                                                    "deprecatedVersion": null,
+                                                    "removedVersion": null
+                                                }
+                                            },
                                             {
                                                 "name": "Xes-arrow-functions",
                                                 "shortName": null,

compiler/arguments/src/org/jetbrains/kotlin/arguments/description/JsCompilerArguments.kt

@@ -472,6 +472,18 @@ val actualJsArguments by compilerArgumentsLevel(CompilerArgumentsLevelNames.jsAr
         )
     }
 
+    compilerArgument {
+        name = "Xenable-suspend-function-exporting"
+        compilerName = "allowExportingSuspendFunctions"
+        description = "Enable exporting suspend functions to JavaScript/TypeScript.".asReleaseDependent()
+        valueType = BooleanType.defaultFalse
+        additionalAnnotations(Enables(LanguageFeature.JsAllowExportingSuspendFunctions))
+
+        lifecycle(
+            introducedVersion = KotlinReleaseVersion.v2_3_0,
+        )
+    }
+
     compilerArgument {
         name = "Xfake-override-validator"
         description = "Enable the IR fake override validator.".asReleaseDependent()

compiler/cli/cli-common/gen/org/jetbrains/kotlin/cli/common/arguments/ConfigureJsLanguageFeatures.kt

@@ -10,4 +10,8 @@ internal fun MutableMap<LanguageFeature, LanguageFeature.State>.configureJsLangu
     if (arguments.extensionFunctionsInExternals) {
         put(LanguageFeature.JsEnableExtensionFunctionInExternals, LanguageFeature.State.ENABLED)
     }
+
+    if (arguments.allowExportingSuspendFunctions) {
+        put(LanguageFeature.JsAllowExportingSuspendFunctions, LanguageFeature.State.ENABLED)
+    }
 }

compiler/cli/cli-common/gen/org/jetbrains/kotlin/cli/common/arguments/K2JSCompilerArguments.kt

@@ -34,6 +34,17 @@ class K2JSCompilerArguments : K2WasmCompilerArguments() {
             field = value
         }
 
+    @Argument(
+        value = "-Xenable-suspend-function-exporting",
+        description = "Enable exporting suspend functions to JavaScript/TypeScript.",
+    )
+    @Enables(LanguageFeature.JsAllowExportingSuspendFunctions)
+    var allowExportingSuspendFunctions: Boolean = false
+        set(value) {
+            checkFrozen()
+            field = value
+        }
+
     @Argument(
         value = "-Xes-arrow-functions",
         description = "Use ES2015 arrow functions in the JavaScript code generated for Kotlin lambdas. Enabled by default in case of ES2015 target usage",

compiler/cli/cli-common/gen/org/jetbrains/kotlin/cli/common/arguments/K2JSCompilerArgumentsCopyGenerated.kt

@@ -10,6 +10,7 @@ package org.jetbrains.kotlin.cli.common.arguments
 fun copyK2JSCompilerArguments(from: K2JSCompilerArguments, to: K2JSCompilerArguments): K2JSCompilerArguments {
     copyK2WasmCompilerArguments(from, to)
 
+    to.allowExportingSuspendFunctions = from.allowExportingSuspendFunctions
     to.cacheDirectory = from.cacheDirectory
     to.compileLongAsBigInt = from.compileLongAsBigInt
     to.extensionFunctionsInExternals = from.extensionFunctionsInExternals

compiler/testData/cli/js/jsExtraHelp.out

@@ -3,6 +3,8 @@ where advanced options include:
   -Xcache-directory=<path>   Path to the cache directory.
   -Xenable-extension-functions-in-externals
                              Enable extension function members in external interfaces.
+  -Xenable-suspend-function-exporting
+                             Enable exporting suspend functions to JavaScript/TypeScript.
   -Xes-arrow-functions       Use ES2015 arrow functions in the JavaScript code generated for Kotlin lambdas. Enabled by default in case of ES2015 target usage
   -Xes-classes               Let generated JavaScript code use ES2015 classes. Enabled by default in case of ES2015 target usage
   -Xes-generators            Enable ES2015 generator functions usage inside the compiled code. Enabled by default in case of ES2015 target usage