[Gradle, JS] generateKotlinExternals option in dsl functions

KT-38331

libraries/tools/kotlin-gradle-plugin-api/src/main/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinNpmDependencyHandler.kt

@@ -12,23 +12,108 @@ interface KotlinNpmDependencyHandler {
     @Deprecated("Declaring NPM dependency without version is forbidden")
     fun npm(name: String): Dependency
 
-    fun npm(name: String, version: String): Dependency
+    fun npm(
+        name: String,
+        version: String,
+        generateKotlinExternals: Boolean
+    ): Dependency
 
-    fun npm(name: String, directory: File): Dependency
+    fun npm(
+        name: String,
+        version: String
+    ): Dependency = npm(
+        name = name,
+        version = version,
+        generateKotlinExternals = DEFAULT_GENERATE_KOTLIN_EXTERNALS
+    )
 
-    fun npm(directory: File): Dependency
+    fun npm(
+        name: String,
+        directory: File,
+        generateKotlinExternals: Boolean
+    ): Dependency
 
-    fun devNpm(name: String, version: String): Dependency
+    fun npm(
+        name: String,
+        directory: File
+    ): Dependency = npm(
+        name = name,
+        directory = directory,
+        generateKotlinExternals = DEFAULT_GENERATE_KOTLIN_EXTERNALS
+    )
 
-    fun devNpm(name: String, directory: File): Dependency
+    fun npm(
+        directory: File,
+        generateKotlinExternals: Boolean
+    ): Dependency
 
-    fun devNpm(directory: File): Dependency
+    fun npm(
+        directory: File
+    ): Dependency = npm(
+        directory = directory,
+        generateKotlinExternals = DEFAULT_GENERATE_KOTLIN_EXTERNALS
+    )
 
-    fun optionalNpm(name: String, version: String): Dependency
+    fun devNpm(
+        name: String,
+        version: String
+    ): Dependency
 
-    fun optionalNpm(name: String, directory: File): Dependency
+    fun devNpm(
+        name: String,
+        directory: File
+    ): Dependency
 
-    fun optionalNpm(directory: File): Dependency
+    fun devNpm(
+        directory: File
+    ): Dependency
 
-    fun peerNpm(name: String, version: String): Dependency
-}
+    fun optionalNpm(
+        name: String,
+        version: String,
+        generateKotlinExternals: Boolean
+    ): Dependency
+
+    fun optionalNpm(
+        name: String,
+        version: String
+    ): Dependency = optionalNpm(
+        name = name,
+        version = version,
+        generateKotlinExternals = DEFAULT_GENERATE_KOTLIN_EXTERNALS
+    )
+
+    fun optionalNpm(
+        name: String,
+        directory: File,
+        generateKotlinExternals: Boolean
+    ): Dependency
+
+    fun optionalNpm(
+        name: String,
+        directory: File
+    ): Dependency = optionalNpm(
+        name = name,
+        directory = directory,
+        generateKotlinExternals = DEFAULT_GENERATE_KOTLIN_EXTERNALS
+    )
+
+    fun optionalNpm(
+        directory: File,
+        generateKotlinExternals: Boolean
+    ): Dependency
+
+    fun optionalNpm(
+        directory: File
+    ): Dependency = optionalNpm(
+        directory = directory,
+        generateKotlinExternals = DEFAULT_GENERATE_KOTLIN_EXTERNALS
+    )
+
+    fun peerNpm(
+        name: String,
+        version: String
+    ): Dependency
+}
+
+const val DEFAULT_GENERATE_KOTLIN_EXTERNALS = true