[Gradle] Add autoMirror configuration support for ImageVectors at multiple levels

Author: egorikftp

README.md

@@ -416,6 +416,13 @@ valkyrie {
   // Optional: Generate during IDE sync for better developer experience (default: false)
   generateAtSync = false
 
+  // Optional: Force all generated ImageVectors to have a specific autoMirror value (default: not specified)
+  // When set to true, all icons will have autoMirror = true
+  // When set to false, all icons will have autoMirror = false
+  // When not specified, the autoMirror value from the original icon file will be preserved
+  // This can be overridden at the icon pack or nested pack level
+  autoMirror = false
+
   // Optional: Code style configuration for generated code
   codeStyle {
     // Add explicit `public` modifier to generated declarations (default: false)
@@ -454,13 +461,22 @@ valkyrie {
     // Optional: Generate flat package structure without subfolders (default: false)
     useFlatPackage = false
 
+    // Optional: Force all ImageVectors in this icon pack to have a specific autoMirror value (default: not specified)
+    // When set, overrides the root level autoMirror setting
+    // This can be overridden at the nested pack level
+    autoMirror = true
+
     // Optional: Nested icon packs configuration
     nested {
       // Required: Name of the nested icon pack object
       name = "Outlined"
 
       // Required: The source folder path containing icons for this nested pack, relative to the `resourceDirectoryName`.
       sourceFolder = "outlined"
+
+      // Optional: Force all ImageVectors in this nested pack to have a specific autoMirror value (default: not specified)
+      // When set, overrides the icon pack level and root level autoMirror settings
+      autoMirror = false
     }
     // You can add more nested packs if necessary
   }
@@ -708,6 +724,50 @@ tasks.register("updateValkyrieIcons") {
 }
 ```
 
+#### AutoMirror configuration
+
+The `autoMirror` parameter controls whether icons should automatically flip horizontally when used in right-to-left (
+RTL) layouts. This is particularly useful for directional icons like arrows, chevrons, or navigation elements.
+
+**Configuration hierarchy:**
+
+The plugin supports a three-level hierarchy for `autoMirror` configuration:
+
+1. **Root level** - applies to all icons across the project
+2. **Icon pack level** - overrides root level for all icons in the pack
+3. **Nested pack level** - overrides both icon pack and root level for icons in the nested pack
+
+For example, to force enable RTL support for icons in the `Navigation` nested pack:
+
+```kotlin
+valkyrie {
+  packageName = "com.example.app.icons"
+
+  iconPack {
+    name = "ValkyrieIcons"
+    targetSourceSet = "commonMain"
+
+    nested {
+      name = "Navigation"
+      sourceFolder = "navigation"
+
+      autoMirror = true
+    }
+
+    nested {
+      name = "Logos"
+      sourceFolder = "logos"
+    }
+  }
+}
+```
+
+In this example:
+
+- Icons in the `Navigation` nested pack will have `autoMirror = true`
+- Icons in the `Logos` nested pack (and any other nested pack without an explicit `autoMirror` setting) will preserve
+  the original `autoMirror` value from the source icon file
+
 ## Other
 
 ### Export formats

tools/gradle-plugin/CHANGELOG.md

@@ -6,6 +6,50 @@
 
 - Automatically handle full qualified imports for icons that conflict with reserved Compose qualified names (`Brush`,
   `Color`, `Offset`)
+- Add `autoMirror` configuration support at root, icon pack, and nested pack levels to control RTL (right-to-left) 
+  layout behavior for generated ImageVectors
+
+The `autoMirror` parameter controls whether icons should automatically flip horizontally when used in RTL layouts.
+This is particularly useful for directional icons like arrows, chevrons, or navigation elements.
+
+Configuration can be set at three levels with override hierarchy:
+1. **Root level** - applies to all icons across the project
+2. **Icon pack level** - overrides root level for all icons in the pack
+3. **Nested pack level** - overrides both icon pack and root level for icons in the nested pack
+
+Example configuration:
+
+```kotlin
+valkyrie {
+  packageName = "com.example.app.icons"
+  
+  // Force all icons to support RTL by default
+  autoMirror = true
+
+  iconPack {
+    name = "ValkyrieIcons"
+    targetSourceSet = "commonMain"
+    
+    // Override: icons in this pack won't auto-mirror
+    autoMirror = false
+
+    nested {
+      name = "Navigation"
+      sourceFolder = "navigation"
+      // Override: navigation icons should auto-mirror for RTL
+      autoMirror = true
+    }
+
+    nested {
+      name = "Logos"
+      sourceFolder = "logos"
+      // Logos inherit autoMirror = false from icon pack level
+    }
+  }
+}
+```
+
+When `autoMirror` is not specified at any level, the original value from the source icon file will be preserved.
 
 ### Changed
 

tools/gradle-plugin/api/gradle-plugin.api

@@ -6,6 +6,7 @@ public abstract class io/github/composegears/valkyrie/gradle/CodeStyleConfigExte
 
 public abstract class io/github/composegears/valkyrie/gradle/IconPackExtension {
 	public fun <init> (Lorg/gradle/api/model/ObjectFactory;)V
+	public final fun getAutoMirror ()Lorg/gradle/api/provider/Property;
 	public final fun getName ()Lorg/gradle/api/provider/Property;
 	public final fun getTargetSourceSet ()Lorg/gradle/api/provider/Property;
 	public final fun getUseFlatPackage ()Lorg/gradle/api/provider/Property;
@@ -23,13 +24,15 @@ public abstract class io/github/composegears/valkyrie/gradle/ImageVectorConfigEx
 
 public abstract class io/github/composegears/valkyrie/gradle/NestedPack {
 	public fun <init> (Lorg/gradle/api/model/ObjectFactory;)V
+	public final fun getAutoMirror ()Lorg/gradle/api/provider/Property;
 	public final fun getName ()Lorg/gradle/api/provider/Property;
 	public final fun getSourceFolder ()Lorg/gradle/api/provider/Property;
 }
 
 public abstract class io/github/composegears/valkyrie/gradle/ValkyrieExtension {
 	public fun <init> (Lorg/gradle/api/model/ObjectFactory;)V
 	public final fun codeStyle (Lkotlin/jvm/functions/Function1;)V
+	public final fun getAutoMirror ()Lorg/gradle/api/provider/Property;
 	public final fun getGenerateAtSync ()Lorg/gradle/api/provider/Property;
 	public final fun getOutputDirectory ()Lorg/gradle/api/file/DirectoryProperty;
 	public final fun getPackageName ()Lorg/gradle/api/provider/Property;

tools/gradle-plugin/src/main/kotlin/io/github/composegears/valkyrie/gradle/IconPackExtension.kt

@@ -9,6 +9,7 @@ import org.gradle.api.provider.ListProperty
 import org.gradle.api.provider.Property
 import org.gradle.api.tasks.Input
 import org.gradle.api.tasks.Nested
+import org.gradle.api.tasks.Optional
 import org.gradle.declarative.dsl.model.annotations.Configuring
 
 abstract class IconPackExtension @Inject constructor(
@@ -40,6 +41,21 @@ abstract class IconPackExtension @Inject constructor(
         .property<Boolean>()
         .convention(false)
 
+    /**
+     * Force all ImageVectors in this icon pack to have a specific autoMirror value.
+     *
+     * When set to `true`, all icons in this pack will have `autoMirror = true`.
+     * When set to `false`, all icons in this pack will have `autoMirror = false`.
+     * When not specified, the autoMirror value from the root extension or the original icon file will be used.
+     *
+     * This can be overridden at the nested pack level.
+     *
+     * Default: not specified
+     */
+    @get:Input
+    @get:Optional
+    val autoMirror: Property<Boolean> = objects.property<Boolean>()
+
     @get:Nested
     internal val nestedPacks: ListProperty<NestedPack> = objects
         .listProperty<NestedPack>()
@@ -92,4 +108,17 @@ abstract class NestedPack @Inject constructor(objects: ObjectFactory) {
      */
     @get:Input
     val sourceFolder: Property<String> = objects.property<String>()
+
+    /**
+     * Force all ImageVectors in this nested pack to have a specific autoMirror value.
+     *
+     * When set to `true`, all icons in this nested pack will have `autoMirror = true`.
+     * When set to `false`, all icons in this nested pack will have `autoMirror = false`.
+     * When not specified, the autoMirror value from the icon pack or root extension will be used.
+     *
+     * Default: not specified
+     */
+    @get:Input
+    @get:Optional
+    val autoMirror: Property<Boolean> = objects.property<Boolean>()
 }

tools/gradle-plugin/src/main/kotlin/io/github/composegears/valkyrie/gradle/ValkyrieExtension.kt

@@ -57,6 +57,20 @@ abstract class ValkyrieExtension @Inject constructor(private val objects: Object
         .property<String>()
         .convention(DEFAULT_RESOURCE_DIRECTORY)
 
+    /**
+     * Force all generated ImageVectors to have a specific autoMirror value.
+     *
+     * When set to `true`, all icons will have `autoMirror = true`.
+     * When set to `false`, all icons will have `autoMirror = false`.
+     * When not specified, the autoMirror value from the original icon file will be preserved.
+     *
+     * This can be overridden at the icon pack or nested pack level.
+     *
+     * Default: not specified
+     */
+    @get:Optional
+    val autoMirror: Property<Boolean> = objects.property<Boolean>()
+
     /**
      * Code style configuration for generated code.
      */

tools/gradle-plugin/src/main/kotlin/io/github/composegears/valkyrie/gradle/internal/TaskRegistry.kt

@@ -42,6 +42,7 @@ internal fun registerTask(
         task.useExplicitMode.convention(extension.codeStyle.useExplicitMode)
         task.addTrailingComma.convention(extension.imageVector.addTrailingComma)
         task.indentSize.convention(extension.codeStyle.indentSize)
+        task.autoMirror.convention(extension.autoMirror)
 
         task.sourceSet.convention(sourceSet.name)
         task.iconPack.convention(extension.iconPack)

tools/gradle-plugin/src/main/kotlin/io/github/composegears/valkyrie/gradle/internal/task/GenerateImageVectorsTask.kt

@@ -61,6 +61,10 @@ internal abstract class GenerateImageVectorsTask : DefaultTask() {
     @get:Input
     abstract val indentSize: Property<Int>
 
+    @get:Optional
+    @get:Input
+    abstract val autoMirror: Property<Boolean>
+
     @get:OutputDirectory
     abstract val outputDirectory: DirectoryProperty
 
@@ -310,8 +314,17 @@ internal abstract class GenerateImageVectorsTask : DefaultTask() {
         nestedPackName: String?,
     ) {
         val parseOutput = SvgXmlParser.toIrImageVector(ParserType.Jvm, Path(file.absolutePath))
+
+        // Apply autoMirror override if specified (nested pack > icon pack > root)
+        val effectiveAutoMirror = resolveAutoMirror(nestedPackName)
+        val irImageVector = if (effectiveAutoMirror != null) {
+            parseOutput.irImageVector.copy(autoMirror = effectiveAutoMirror)
+        } else {
+            parseOutput.irImageVector
+        }
+
         val vectorSpecOutput = ImageVectorGenerator.convert(
-            vector = parseOutput.irImageVector,
+            vector = irImageVector,
             iconName = parseOutput.iconName,
             config = config,
         )
@@ -359,4 +372,24 @@ internal abstract class GenerateImageVectorsTask : DefaultTask() {
     private fun logFileParseError(file: File, error: Throwable) {
         logger.warn("Skipping file ${file.name} due to processing error, details: ${error.message}")
     }
+
+    private fun resolveAutoMirror(nestedPackName: String?): Boolean? {
+        // Priority: nested pack > icon pack > root extension
+        if (iconPack.isPresent && nestedPackName != null) {
+            val nestedPack = iconPack.get().nestedPacks.get().find { it.name.get() == nestedPackName }
+            if (nestedPack?.autoMirror?.isPresent == true) {
+                return nestedPack.autoMirror.get()
+            }
+        }
+
+        if (iconPack.isPresent && iconPack.get().autoMirror.isPresent) {
+            return iconPack.get().autoMirror.get()
+        }
+
+        if (autoMirror.isPresent) {
+            return autoMirror.get()
+        }
+
+        return null
+    }
 }