fallback for string file path in kotlin syntax

Author: Picazsoo

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/extensions/OpenApiGeneratorGenerateExtension.kt

@@ -434,8 +434,9 @@ open class OpenApiGeneratorGenerateExtension(private val project: Project) {
     }
 
     // ========================================================================
-    // Backwards-compatibility bridge setters for Groovy/Kotlin DSL
-    // These allow users to continue assigning paths as standard strings.
+    // Backwards-compatibility bridge setters for Groovy DSL
+    // These allow Groovy users to use assignment syntax: inputSpec = "path"
+    // For Kotlin DSL, use the extension functions below instead.
     // ========================================================================
 
     /** Backwards-compatibility bridge for outputDir */

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/extensions/OpenApiGeneratorGeneratorsExtension.kt

@@ -46,8 +46,8 @@ open class OpenApiGeneratorGeneratorsExtension(project: Project) {
     }
 
     // ========================================================================
-    // Backwards-compatibility bridge setter for Groovy/Kotlin DSL
-    // Allows users to continue assigning lists directly via `=`
+    // Backwards-compatibility bridge setter for Groovy DSL
+    // This allows Groovy users to use assignment syntax: include = ...
     // ========================================================================
     fun setInclude(items: Iterable<String>) {
         include.set(items)

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/extensions/OpenApiGeneratorMetaExtension.kt

@@ -51,8 +51,9 @@ open class OpenApiGeneratorMetaExtension(private val project: Project) {
     }
 
     // ========================================================================
-    // Backwards-compatibility bridge setter for Groovy/Kotlin DSL
-    // Allows users to continue assigning paths as standard strings.
+    // Backwards-compatibility bridge setter for Groovy DSL
+    // This allows Groovy users to use assignment syntax: outputFolder = "path"
+    // For Kotlin DSL, use the extension function below instead.
     // ========================================================================
 
     /** Backwards-compatibility bridge for outputFolder */

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/extensions/OpenApiGeneratorValidateExtension.kt

@@ -49,8 +49,9 @@ open class OpenApiGeneratorValidateExtension(private val project: Project) {
     val treatWarningsAsErrors: Property<Boolean> = project.objects.property<Boolean>().convention(false)
 
     // ========================================================================
-    // Backwards-compatibility bridge setters for Groovy/Kotlin DSL
-    // These allow users to continue assigning paths as standard strings.
+    // Backwards-compatibility bridge setter for Groovy DSL
+    // This allows Groovy users to use assignment syntax: inputSpec = "path"
+    // For Kotlin DSL, use the extension function below instead.
     // ========================================================================
 
     /** Backwards-compatibility bridge for inputSpec */