feat: remove deprecated JS compiler option (#4635)

* update: remove deprecated JS compiler option

* Update compatibility guide

* Daniel review

Co-authored-by: Dániel Csorba <[email protected]>

* Daniel review

Co-authored-by: Dániel Csorba <[email protected]>

---------

Co-authored-by: Dániel Csorba <[email protected]>

Author: AlejandraPedroza

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
+> - 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. Instead, you can use the `destinationDirectory`
+> property of the `Kotlin2JsCompile` task 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

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 | | "&lt;buildDir&gt;/js/packages/<project.name>/kotlin/<project.name>.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" |