From 0583de07bac21620b6c8eec7684a12bb6a63760f Mon Sep 17 00:00:00 2001 From: alepedroza <39709865+AlejandraPedroza@users.noreply.github.com> Date: Mon, 6 Jan 2025 12:22:07 -0600 Subject: [PATCH 1/4] update: remove deprecated JS compiler option --- docs/topics/gradle/gradle-compiler-options.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/topics/gradle/gradle-compiler-options.md b/docs/topics/gradle/gradle-compiler-options.md index 4935a9c7973..4d181dc50dd 100644 --- a/docs/topics/gradle/gradle-compiler-options.md +++ b/docs/topics/gradle/gradle-compiler-options.md @@ -192,6 +192,9 @@ Note that with the Gradle Kotlin DSL, you should get the task from the project's Use the `Kotlin2JsCompile` and `KotlinCompileCommon` types for JS and common targets, respectively. +You can see the list of JavaScript compilation tasks by running the `gradlew tasks --all` command in the terminal +and searching for `compile*KotlinJS` task names in the `Other tasks` group. + ## All Kotlin compilation tasks It is also possible to configure all the Kotlin compilation tasks in the project: @@ -367,7 +370,6 @@ Also, see [Types for compiler options](#types-for-compiler-options). | `main` | Define whether the `main` function should be called upon execution | "call", "noCall". Also, see [Types for compiler options](#types-for-compiler-options) | "call" | | `metaInfo` | Generate .meta.js and .kjsm files with metadata. Use to create a library | | true | | `moduleKind` | The kind of JS module generated by the compiler | "umd", "commonjs", "amd", "plain", "es". Also, see [Types for compiler options](#types-for-compiler-options) | "umd" | -| `outputFile` | Destination *.js file for the compilation result | | "<buildDir>/js/packages//kotlin/.js" | | `sourceMap` | Generate source map | | true | | `sourceMapEmbedSources` | Embed source files into the source map | "never", "always", "inlining". Also, see [Types for compiler options](#types-for-compiler-options) | | | `sourceMapNamesPolicy` | Add variable and function names that you declared in Kotlin code into the source map. For more information on the behavior, see our [compiler reference](compiler-reference.md#source-map-names-policy-simple-names-fully-qualified-names-no). | "simple-names", "fully-qualified-names", "no". Also, see [Types for compiler options](#types-for-compiler-options) | "simple-names" | From 12e3235ee670643731c17c9c1035a72c0b1b442c Mon Sep 17 00:00:00 2001 From: alepedroza <39709865+AlejandraPedroza@users.noreply.github.com> Date: Tue, 7 Jan 2025 10:43:16 -0600 Subject: [PATCH 2/4] Update compatibility guide --- .../compatibility-guide-20.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/topics/compatibility-guides/compatibility-guide-20.md b/docs/topics/compatibility-guides/compatibility-guide-20.md index b7eb4105d44..2a1bebcd6fa 100644 --- a/docs/topics/compatibility-guides/compatibility-guide-20.md +++ b/docs/topics/compatibility-guides/compatibility-guide-20.md @@ -688,4 +688,21 @@ perspective > **Deprecation cycle**: > > - 1.3: the platform plugin IDs are deprecated -> - 2.0.0: the platform plugin IDs are no longer supported \ No newline at end of file +> - 2.0.0: the platform plugin IDs are no longer supported + +### Remove outputFile JavaScript compiler option + +> **Issue**: [KT-61116](https://youtrack.jetbrains.com/issue/KT-61116) +> +> **Component**: Gradle +> +> **Incompatible change type**: source +> +> **Short summary**: The `outputFile` JavaScript compiler option has been removed. Now, the `destinationDirectory` +> property of the `Kotlin2JsCompile` task is available to specify the directory where the compiled JavaScript output files +> are written. +> +> **Deprecation cycle**: +> +> - 1.9.25: the `outputFile` compiler option is deprecated +> - 2.0.0: the `outputFile` compiler option is removed \ No newline at end of file From 3ae9c357c4ee8cea336cb2d7853c5b807605a576 Mon Sep 17 00:00:00 2001 From: alejandrapedroza <39709865+AlejandraPedroza@users.noreply.github.com> Date: Wed, 8 Jan 2025 16:27:21 +0100 Subject: [PATCH 3/4] Daniel review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Dániel Csorba <150924204+daniCsorbaJB@users.noreply.github.com> --- docs/topics/compatibility-guides/compatibility-guide-20.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/topics/compatibility-guides/compatibility-guide-20.md b/docs/topics/compatibility-guides/compatibility-guide-20.md index 2a1bebcd6fa..092dec6682d 100644 --- a/docs/topics/compatibility-guides/compatibility-guide-20.md +++ b/docs/topics/compatibility-guides/compatibility-guide-20.md @@ -698,7 +698,7 @@ perspective > > **Incompatible change type**: source > -> **Short summary**: The `outputFile` JavaScript compiler option has been removed. Now, the `destinationDirectory` +> **Short summary**: The `outputFile` JavaScript compiler option has been removed. Instead, you can use the `destinationDirectory` > property of the `Kotlin2JsCompile` task is available to specify the directory where the compiled JavaScript output files > are written. > From ae0aa9ad49710314425bea31daebb207a8a86b7e Mon Sep 17 00:00:00 2001 From: alejandrapedroza <39709865+AlejandraPedroza@users.noreply.github.com> Date: Wed, 8 Jan 2025 16:27:31 +0100 Subject: [PATCH 4/4] Daniel review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Dániel Csorba <150924204+daniCsorbaJB@users.noreply.github.com> --- docs/topics/compatibility-guides/compatibility-guide-20.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/topics/compatibility-guides/compatibility-guide-20.md b/docs/topics/compatibility-guides/compatibility-guide-20.md index 092dec6682d..8c6a5de557f 100644 --- a/docs/topics/compatibility-guides/compatibility-guide-20.md +++ b/docs/topics/compatibility-guides/compatibility-guide-20.md @@ -699,7 +699,7 @@ perspective > **Incompatible change type**: source > > **Short summary**: The `outputFile` JavaScript compiler option has been removed. Instead, you can use the `destinationDirectory` -> property of the `Kotlin2JsCompile` task is available to specify the directory where the compiled JavaScript output files +> property of the `Kotlin2JsCompile` task to specify the directory where the compiled JavaScript output files > are written. > > **Deprecation cycle**: