Support @Preview locale metadata in thumbnail rendering (#8)

skydoves · web-flow · commit 96d28470de74 · 2026-06-13T06:12:33.000+09:00
The KSP processor captures the preview's locale qualifier (direct or via a multipreview meta-annotation) into the manifest, and both render backends apply it: Layoutlib through the renderer's preview params, Robolectric through a composition-scoped configuration-context override with the matching layout direction. Also fixes the generated navgraph.version resource staying stale across a VERSION_NAME bump, which made consumers auto-wire the previous release. Fixes #7
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+- **`@Preview(locale = …)` support for thumbnails** ([#7](https://github.com/skydoves/compose-nav-graph/issues/7)): the KSP processor now captures the preview's locale qualifier (declared directly or via a multipreview meta-annotation) into the manifest, and both render backends apply it (Layoutlib through the renderer's preview params, Robolectric through a composition-scoped configuration-context override), so localized previews render with the same resources Android Studio shows.
+
+### Fixed
+- The generated `navgraph.version` resource (which pins the auto-wired `compose-nav-graph-annotations` / `compose-nav-graph-ksp` / `compose-nav-graph-testing` versions) is regenerated when `VERSION_NAME` changes instead of staying stale.
+
 ## [0.1.0] - 2026-06-01
 
 ### Added
diff --git a/compose-nav-graph-annotations/api/android/compose-nav-graph-annotations.api b/compose-nav-graph-annotations/api/android/compose-nav-graph-annotations.api
@@ -220,17 +220,19 @@ public final class com/github/skydoves/navgraph/model/NavPreviewParam$Companion
 
 public final class com/github/skydoves/navgraph/model/NavPreviewRef {
 	public static final field Companion Lcom/github/skydoves/navgraph/model/NavPreviewRef$Companion;
-	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;Z)V
-	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;)V
+	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Ljava/lang/String;
 	public final fun component3 ()Ljava/lang/String;
 	public final fun component4 ()Ljava/util/List;
 	public final fun component5 ()Ljava/lang/String;
 	public final fun component6 ()Z
-	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;Z)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
-	public static synthetic fun copy$default (Lcom/github/skydoves/navgraph/model/NavPreviewRef;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZILjava/lang/Object;)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
+	public final fun component7 ()Ljava/lang/String;
+	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
+	public static synthetic fun copy$default (Lcom/github/skydoves/navgraph/model/NavPreviewRef;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;ILjava/lang/Object;)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
 	public fun equals (Ljava/lang/Object;)Z
+	public final fun getLocale ()Ljava/lang/String;
 	public final fun getPreviewFqn ()Ljava/lang/String;
 	public final fun getPreviewMethodFqn ()Ljava/lang/String;
 	public final fun getPreviewName ()Ljava/lang/String;
diff --git a/compose-nav-graph-annotations/api/jvm/compose-nav-graph-annotations.api b/compose-nav-graph-annotations/api/jvm/compose-nav-graph-annotations.api
@@ -220,17 +220,19 @@ public final class com/github/skydoves/navgraph/model/NavPreviewParam$Companion
 
 public final class com/github/skydoves/navgraph/model/NavPreviewRef {
 	public static final field Companion Lcom/github/skydoves/navgraph/model/NavPreviewRef$Companion;
-	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;Z)V
-	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;)V
+	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Ljava/lang/String;
 	public final fun component3 ()Ljava/lang/String;
 	public final fun component4 ()Ljava/util/List;
 	public final fun component5 ()Ljava/lang/String;
 	public final fun component6 ()Z
-	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;Z)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
-	public static synthetic fun copy$default (Lcom/github/skydoves/navgraph/model/NavPreviewRef;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZILjava/lang/Object;)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
+	public final fun component7 ()Ljava/lang/String;
+	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
+	public static synthetic fun copy$default (Lcom/github/skydoves/navgraph/model/NavPreviewRef;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/lang/String;ZLjava/lang/String;ILjava/lang/Object;)Lcom/github/skydoves/navgraph/model/NavPreviewRef;
 	public fun equals (Ljava/lang/Object;)Z
+	public final fun getLocale ()Ljava/lang/String;
 	public final fun getPreviewFqn ()Ljava/lang/String;
 	public final fun getPreviewMethodFqn ()Ljava/lang/String;
 	public final fun getPreviewName ()Ljava/lang/String;
diff --git a/compose-nav-graph-annotations/src/commonMain/kotlin/com/github/skydoves/navgraph/model/NavGraphModels.kt b/compose-nav-graph-annotations/src/commonMain/kotlin/com/github/skydoves/navgraph/model/NavGraphModels.kt
@@ -126,6 +126,10 @@ public data class NavArg(
  *   The device-free renderer needs each provider to instantiate the composable's sample value — without them a
  *   parameterized `@NavPreview` (very common in real apps) can't render and yields a blank/failed thumbnail.
  * @property primary whether this is the canonical thumbnail for the route (`@NavPreview.primary`).
+ * @property locale the `@Preview(locale = …)` resource qualifier (e.g. `"ko"`, `"fr-rFR"`) the function's
+ *   `@Preview` declares, directly or via a multipreview meta-annotation; null when none is declared. Both
+ *   render backends apply it so the thumbnail matches what Android Studio's preview shows. Additive since
+ *   schema 1 (absent in older manifests → null).
  */
 @Serializable
 public data class NavPreviewRef(
@@ -135,6 +139,7 @@ public data class NavPreviewRef(
   val previewParameters: List<NavPreviewParam> = emptyList(),
   val thumbnail: String? = null,
   val primary: Boolean = false,
+  val locale: String? = null,
 )
 
 /**
diff --git a/compose-nav-graph-gradle/build.gradle.kts b/compose-nav-graph-gradle/build.gradle.kts
@@ -37,6 +37,9 @@ tasks.withType<Test>().configureEach { useJUnit() }
 val generateNavGraphVersion = tasks.register("generateNavGraphVersion") {
   val outDir = layout.buildDirectory.dir("generated/navgraphversion")
   val versionValue = version.toString()
+  // Without this input the task stays UP-TO-DATE across a VERSION_NAME bump, leaving a stale
+  // resource — consumers would then auto-wire the previous release's artifacts.
+  inputs.property("version", versionValue)
   outputs.dir(outDir)
   doLast {
     outDir.get().file("navgraph.version").asFile.apply {
diff --git a/compose-nav-graph-gradle/gradle.properties b/compose-nav-graph-gradle/gradle.properties
@@ -1,7 +1,7 @@
 # compose-nav-graph-gradle is a standalone (included) build, so it carries its own publishing coordinates
 # rather than inheriting the root gradle.properties.
 GROUP=com.github.skydoves
-VERSION_NAME=0.1.0
+VERSION_NAME=0.1.1-SNAPSHOT
 
 POM_NAME=Compose Navigation Graph Gradle Plugin
 POM_ARTIFACT_ID=compose-nav-graph-gradle
diff --git a/compose-nav-graph-gradle/src/main/kotlin/com/github/skydoves/navgraph/gradle/LayoutlibRenderTask.kt b/compose-nav-graph-gradle/src/main/kotlin/com/github/skydoves/navgraph/gradle/LayoutlibRenderTask.kt
@@ -114,6 +114,7 @@ public abstract class LayoutlibRenderTask : DefaultTask() {
     val methodFqn: String,
     val id: String,
     val params: List<HPreviewParam>,
+    val locale: String?,
   )
 
   @TaskAction
@@ -135,7 +136,10 @@ public abstract class LayoutlibRenderTask : DefaultTask() {
             )
           } else {
             add(
-              Shot(node.id, pv.previewName, pv.primary, method, "nav${i++}", pv.previewParameters),
+              Shot(
+                node.id, pv.previewName, pv.primary, method, "nav${i++}",
+                pv.previewParameters, pv.locale,
+              ),
             )
           }
         }
@@ -205,6 +209,9 @@ public abstract class LayoutlibRenderTask : DefaultTask() {
             putJsonObject("previewParams") {
               put("apiLevel", apiLevel.get())
               put("device", PREVIEW_DEVICE)
+              // The @Preview(locale = …) qualifier, extracted by KSP (a multipreview's meta-annotation isn't
+              // visible to the renderer itself, so it must be passed explicitly).
+              s.locale?.let { put("locale", it) }
             }
             put("previewId", s.id)
           }
diff --git a/compose-nav-graph-gradle/src/main/kotlin/com/github/skydoves/navgraph/gradle/NavManifest.kt b/compose-nav-graph-gradle/src/main/kotlin/com/github/skydoves/navgraph/gradle/NavManifest.kt
@@ -65,6 +65,7 @@ internal data class HPreview(
   val previewParameters: List<HPreviewParam> = emptyList(),
   val thumbnail: String? = null,
   val primary: Boolean = false,
+  val locale: String? = null,
 )
 
 internal data class HPreviewParam(val name: String = "", val provider: String = "")
@@ -107,6 +108,7 @@ internal fun parseGraph(text: String): HGraph {
           },
           thumbnail = po.str("thumbnail"),
           primary = po.bool("primary"),
+          locale = po.str("locale"),
         )
       },
       start = o.bool("start"),
diff --git a/compose-nav-graph-gradle/src/main/kotlin/com/github/skydoves/navgraph/gradle/RobolectricRenderListTask.kt b/compose-nav-graph-gradle/src/main/kotlin/com/github/skydoves/navgraph/gradle/RobolectricRenderListTask.kt
@@ -29,7 +29,7 @@ import org.gradle.api.tasks.TaskAction
 import org.gradle.work.DisableCachingByDefault
 
 /**
- * Writes the TSV render-list (`methodFqn\tnodeId\tpreviewName\tprimary`, one preview per line) that the
+ * Writes the TSV render-list (`methodFqn\tnodeId\tpreviewName\tprimary[\tlocale]`, one preview per line) that the
  * generated `NavGraphRobolectricRenderTest` reads via the `navgraph.renderList` system property. In `ROBOLECTRIC` mode
  * every `@NavPreview` is listed; in `AUTO` mode only the previews Layoutlib **failed** to render are listed —
  * derived from the Layoutlib `results.json` ([readLayoutlibResults] + [isLayoutlibSuccess]), the single source
@@ -81,14 +81,15 @@ public abstract class RobolectricRenderListTask : DefaultTask() {
       val primary: Boolean,
       val methodFqn: String,
       val id: String,
+      val locale: String?,
     )
     val shots = buildList {
       var i = 0
       graph.nodes.forEach { node ->
         node.previews.forEach { pv ->
           val method = pv.previewMethodFqn
           if (!method.isNullOrBlank()) {
-            add(Shot(node.id, pv.previewName, pv.primary, method, "nav${i++}"))
+            add(Shot(node.id, pv.previewName, pv.primary, method, "nav${i++}", pv.locale))
           }
         }
       }
@@ -115,9 +116,14 @@ public abstract class RobolectricRenderListTask : DefaultTask() {
 
     val out = renderList.get().asFile
     out.parentFile.mkdirs()
+    // TSV fields are TRAILING-additive only: NavPreviewRenderer in compose-nav-graph-testing parses this
+    // line format, and the plugin auto-wires that artifact at its own version, so both sides move in step.
+    // The locale field is emitted only when present, keeping locale-less lines byte-identical to the
+    // 4-field format an older, explicitly-pinned testing artifact still parses correctly.
     out.writeText(
       selected.joinToString("") { s ->
-        "${s.methodFqn}\t${s.nodeId}\t${s.previewName}\t${s.primary}\n"
+        "${s.methodFqn}\t${s.nodeId}\t${s.previewName}\t${s.primary}" +
+          "${s.locale?.let { "\t$it" }.orEmpty()}\n"
       },
     )
     logger.lifecycle(
diff --git a/compose-nav-graph-ksp/src/main/kotlin/com/github/skydoves/navgraph/ksp/NavGraphProcessor.kt b/compose-nav-graph-ksp/src/main/kotlin/com/github/skydoves/navgraph/ksp/NavGraphProcessor.kt
@@ -135,6 +135,7 @@ internal class NavGraphProcessor(
               previewMethodFqn = jvmMethodFqn(fn),
               previewParameters = previewParametersOf(fn),
               primary = ann.boolArg("primary"),
+              locale = previewLocaleOf(fn),
             ),
           )
         }
@@ -324,6 +325,7 @@ internal class NavGraphProcessor(
             previewMethodFqn = method,
             previewParameters = previewParametersOf(fn),
             primary = false,
+            locale = previewLocaleOf(fn),
           )
         }
       // The slug is lossy (two packages/modules differing only by `_` vs `.`/`-`/`:` collapse to one), so append
@@ -374,6 +376,33 @@ internal class NavGraphProcessor(
     }
   }
 
+  /**
+   * The `@Preview(locale = …)` qualifier the function's preview declares, or null. Walks the function's
+   * annotations in declaration order — recursing into multipreview meta-annotations depth-first (same cycle
+   * guard as [isPreviewAnnotation]) — and returns the FIRST non-blank locale found. A function whose
+   * `@Preview`s disagree on locale renders one thumbnail, so one locale has to win, and declaration order is
+   * the deterministic choice (a meta-annotation listed before a direct `@Preview` wins).
+   */
+  private fun previewLocaleOf(fn: KSFunctionDeclaration): String? =
+    firstPreviewLocale(fn.annotations, mutableSetOf())
+
+  private fun firstPreviewLocale(
+    annotations: Sequence<KSAnnotation>,
+    visited: MutableSet<String>,
+  ): String? {
+    for (ann in annotations) {
+      val decl = ann.annotationType.resolve().declaration as? KSClassDeclaration ?: continue
+      val name = decl.qualifiedName?.asString() ?: continue
+      if (name == PREVIEW) {
+        ann.stringArg("locale")?.takeIf(String::isNotBlank)?.let { return it }
+        continue
+      }
+      if (!visited.add(name)) continue
+      firstPreviewLocale(decl.annotations, visited)?.let { return it }
+    }
+    return null
+  }
+
   /**
    * Serializable properties = the navigation arguments: primary-constructor properties (in ctor order) then
    * body `val/var` with backing fields (declared order), excluding `@Transient`. Uses *declared* (not
diff --git a/compose-nav-graph-ksp/src/test/kotlin/com/github/skydoves/navgraph/ksp/NavGraphProcessorTest.kt b/compose-nav-graph-ksp/src/test/kotlin/com/github/skydoves/navgraph/ksp/NavGraphProcessorTest.kt
@@ -316,6 +316,56 @@ class NavGraphProcessorTest {
     assertEquals("com.app.ProfilePreview", preview.previewFqn)
     assertEquals("com.app.PreviewsKt.ProfilePreview", preview.previewMethodFqn)
     assertTrue(preview.primary)
+    assertEquals("a preview without @Preview(locale) carries none", null, preview.locale)
+  }
+
+  @Test
+  fun navPreview_carriesDirectPreviewLocale() {
+    val graph = compileNavGraph(
+      SourceFile.kotlin(
+        "Previews.kt",
+        """
+        package com.app
+        import androidx.compose.ui.tooling.preview.Preview
+        import androidx.navigation3.runtime.NavKey
+        import com.github.skydoves.navgraph.annotations.NavPreview
+        class Profile : NavKey
+        @Preview(locale = "ko")
+        @NavPreview(route = Profile::class, primary = true)
+        fun ProfilePreview() {}
+        """.trimIndent(),
+      ),
+      PREVIEW_STUB,
+    )
+
+    assertEquals("ko", graph.node("Profile").previews.single().locale)
+  }
+
+  @Test
+  fun navPreview_carriesLocaleFromMultipreviewMetaAnnotation() {
+    val graph = compileNavGraph(
+      SourceFile.kotlin(
+        "Previews.kt",
+        """
+        package com.app
+        import androidx.compose.ui.tooling.preview.Preview
+        import androidx.navigation3.runtime.NavKey
+        import com.github.skydoves.navgraph.annotations.NavPreview
+
+        @Preview(name = "Light", locale = "fr-rFR")
+        @Preview(name = "Dark", locale = "fr-rFR")
+        annotation class DevicePreview
+
+        class Profile : NavKey
+        @DevicePreview
+        @NavPreview(route = Profile::class, primary = true)
+        fun ProfilePreview() {}
+        """.trimIndent(),
+      ),
+      PREVIEW_STUB,
+    )
+
+    assertEquals("fr-rFR", graph.node("Profile").previews.single().locale)
   }
 
   @Test
diff --git a/compose-nav-graph-ksp/src/test/kotlin/com/github/skydoves/navgraph/ksp/NavGraphTestSupport.kt b/compose-nav-graph-ksp/src/test/kotlin/com/github/skydoves/navgraph/ksp/NavGraphTestSupport.kt
@@ -34,6 +34,20 @@ private val NAV_KEY_STUB = SourceFile.kotlin(
   """.trimIndent(),
 )
 
+/** Mirrors androidx's `@Preview` FQN + the params the processor reads — the real artifact isn't on the
+ *  test classpath, and KSP matches annotations by qualified name only. */
+internal val PREVIEW_STUB = SourceFile.kotlin(
+  "Preview.kt",
+  """
+  package androidx.compose.ui.tooling.preview
+  @Repeatable
+  annotation class Preview(
+    val name: String = "",
+    val locale: String = "",
+  )
+  """.trimIndent(),
+)
+
 private val DECODER = Json { ignoreUnknownKeys = true }
 
 internal fun compileNavGraph(
diff --git a/compose-nav-graph-testing/api/compose-nav-graph-testing.api b/compose-nav-graph-testing/api/compose-nav-graph-testing.api
@@ -12,6 +12,6 @@ public final class com/github/skydoves/navgraph/testing/NavPreviewRenderer {
 }
 
 public final class com/github/skydoves/navgraph/testing/NavPreviewWrapperKt {
-	public static final fun NavPreviewWrapper (Lkotlin/jvm/functions/Function2;Landroidx/compose/runtime/Composer;I)V
+	public static final fun NavPreviewWrapper (Ljava/lang/String;Lkotlin/jvm/functions/Function2;Landroidx/compose/runtime/Composer;II)V
 }
 
diff --git a/compose-nav-graph-testing/src/main/kotlin/com/github/skydoves/navgraph/testing/NavPreviewRenderer.kt b/compose-nav-graph-testing/src/main/kotlin/com/github/skydoves/navgraph/testing/NavPreviewRenderer.kt
@@ -59,7 +59,7 @@ public object NavPreviewRenderer {
       val entry = current
       if (entry != null) {
         key(entry.methodFqn) {
-          NavPreviewWrapper {
+          NavPreviewWrapper(locale = entry.locale) {
             ComposableInvoker.invokeComposable(
               entry.methodFqn.substringBeforeLast('.'),
               entry.methodFqn.substringAfterLast('.'),
@@ -101,8 +101,9 @@ public object NavPreviewRenderer {
     }
   }
 
-  /** Read one render job's TSV (`methodFqn\tnodeId\tpreviewName\tprimary`, one preview per line) plus its output
-   *  thumbs dir + preview index from the given system properties; an absent/blank list or dir yields no entries
+  /** Read one render job's TSV (`methodFqn\tnodeId\tpreviewName\tprimary[\tlocale]`, one preview per line —
+   *  fields are trailing-additive; a 4-field line from an older plugin still parses) plus its output thumbs
+   *  dir + preview index from the given system properties; an absent/blank list or dir yields no entries
    *  (the job is skipped). */
   private fun readJob(listProp: String, thumbsProp: String, indexProp: String): List<RenderEntry> {
     val listPath = System.getProperty(listProp)?.takeIf { it.isNotBlank() } ?: return emptyList()
@@ -112,9 +113,9 @@ public object NavPreviewRenderer {
       ?: return emptyList()
     return File(listPath).takeIf { it.isFile }?.readLines().orEmpty().mapNotNull { line ->
       if (line.isBlank()) return@mapNotNull null
-      val parts = line.split("\t", limit = 4)
+      val parts = line.split("\t", limit = 5)
       if (parts.size < 4) return@mapNotNull null
-      RenderEntry(parts[0], parts[1], parts[2], parts[3], thumbs, index)
+      RenderEntry(parts[0], parts[1], parts[2], parts[3], parts.getOrNull(4), thumbs, index)
     }
   }
 
@@ -123,6 +124,7 @@ public object NavPreviewRenderer {
     val nodeId: String,
     val previewName: String,
     val primary: String,
+    val locale: String?,
     val thumbsDir: File,
     val previewIndex: File,
   )
diff --git a/compose-nav-graph-testing/src/main/kotlin/com/github/skydoves/navgraph/testing/NavPreviewWrapper.kt b/compose-nav-graph-testing/src/main/kotlin/com/github/skydoves/navgraph/testing/NavPreviewWrapper.kt
diff --git a/docs/gradle-plugin/annotations.md b/docs/gradle-plugin/annotations.md
diff --git a/gradle.properties b/gradle.properties
diff --git a/samples/sample/src/main/kotlin/com/github/skydoves/navgraph/sample/SettingsScreen.kt b/samples/sample/src/main/kotlin/com/github/skydoves/navgraph/sample/SettingsScreen.kt
diff --git a/samples/sample/src/main/res/values-ko/strings.xml b/samples/sample/src/main/res/values-ko/strings.xml
diff --git a/samples/sample/src/main/res/values/strings.xml b/samples/sample/src/main/res/values/strings.xml

Original file line number	Diff line number	Diff line change
`@@ -114,6 +114,7 @@ public abstract class LayoutlibRenderTask : DefaultTask() {`
`114`	`114`	`val methodFqn: String,`
`115`	`115`	`val id: String,`
`116`	`116`	`val params: List<HPreviewParam>,`
	`117`	`+ val locale: String?,`
`117`	`118`	`)`
`118`	`119`
`119`	`120`	`@TaskAction`
`@@ -135,7 +136,10 @@ public abstract class LayoutlibRenderTask : DefaultTask() {`
`135`	`136`	`)`
`136`	`137`	`} else {`
`137`	`138`	`add(`
`138`		`- Shot(node.id, pv.previewName, pv.primary, method, "nav${i++}", pv.previewParameters),`
	`139`	`+ Shot(`
	`140`	`+ node.id, pv.previewName, pv.primary, method, "nav${i++}",`
	`141`	`+ pv.previewParameters, pv.locale,`
	`142`	`+ ),`
`139`	`143`	`)`
`140`	`144`	`}`
`141`	`145`	`}`
`@@ -205,6 +209,9 @@ public abstract class LayoutlibRenderTask : DefaultTask() {`
`205`	`209`	`putJsonObject("previewParams") {`
`206`	`210`	`put("apiLevel", apiLevel.get())`
`207`	`211`	`put("device", PREVIEW_DEVICE)`
	`212`	`+ // The @Preview(locale = …) qualifier, extracted by KSP (a multipreview's meta-annotation isn't`
	`213`	`+ // visible to the renderer itself, so it must be passed explicitly).`
	`214`	`+ s.locale?.let { put("locale", it) }`
`208`	`215`	`}`
`209`	`216`	`put("previewId", s.id)`
`210`	`217`	`}`
Original file line number	Diff line number	Diff line change
`@@ -65,6 +65,7 @@ internal data class HPreview(`
`65`	`65`	`val previewParameters: List<HPreviewParam> = emptyList(),`
`66`	`66`	`val thumbnail: String? = null,`
`67`	`67`	`val primary: Boolean = false,`
	`68`	`+ val locale: String? = null,`
`68`	`69`	`)`
`69`	`70`
`70`	`71`	`internal data class HPreviewParam(val name: String = "", val provider: String = "")`
`@@ -107,6 +108,7 @@ internal fun parseGraph(text: String): HGraph {`
`107`	`108`	`},`
`108`	`109`	`thumbnail = po.str("thumbnail"),`
`109`	`110`	`primary = po.bool("primary"),`
	`111`	`+ locale = po.str("locale"),`
`110`	`112`	`)`
`111`	`113`	`},`
`112`	`114`	`start = o.bool("start"),`