feat: Generate stories from @Preview composables

.github/workflows/ci.yaml

@@ -11,7 +11,7 @@ jobs:
         uses: actions/setup-java@v2
         with:
           distribution: 'adopt'
-          java-version: '17'
+          java-version: '21'
 
       - name: Checkout code
         uses: actions/checkout@v3
@@ -54,4 +54,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

.github/workflows/smokebuild.yaml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/setup-java@v2
         with:
           distribution: 'adopt'
-          java-version: '17'
+          java-version: '21'
 
       - name: Checkout code
         uses: actions/checkout@v3

.github/workflows/spotless.yaml

@@ -16,7 +16,7 @@ jobs:
       - name: Set up JDK
         uses: actions/setup-java@v3
         with:
-          java-version: '17'
+          java-version: '21'
           distribution: 'temurin'
           cache: gradle
 

build.gradle.kts

@@ -11,6 +11,13 @@ plugins {
     alias(libs.plugins.kotlin.jvm) apply false
     alias(libs.plugins.dokka) apply false
     alias(libs.plugins.spotless) apply false
+    alias(libs.plugins.ksp) apply false
+}
+
+buildscript {
+    dependencies {
+        classpath(kotlin("gradle-plugin", version = libs.versions.kotlin.asProvider().get()))
+    }
 }
 
 subprojects {

gallery-demo/build.gradle.kts

@@ -12,6 +12,7 @@ plugins {
     alias(libs.plugins.compose.compiler)
     alias(libs.plugins.serialization)
     id("org.jetbrains.compose.hot-reload") version "1.0.0-alpha03"
+    alias(libs.plugins.ksp)
 }
 
 class StorytaleCompilerPlugin : KotlinCompilerPluginSupportPlugin {
@@ -34,13 +35,36 @@ class StorytaleCompilerPlugin : KotlinCompilerPluginSupportPlugin {
         )
     }
 }
+class MakePreviewPublicCompilerPlugin : KotlinCompilerPluginSupportPlugin {
+    override fun applyToCompilation(kotlinCompilation: KotlinCompilation<*>): Provider<List<SubpluginOption>> {
+        return kotlinCompilation.project.provider { emptyList() }
+    }
+
+    override fun getCompilerPluginId(): String {
+        return "org.jetbrains.compose.compiler.plugins.storytale.preview.public"
+    }
+
+    override fun getPluginArtifact(): SubpluginArtifact {
+        return SubpluginArtifact("org.jetbrains.compose.storytale.preview.public", "local-compiler-plugin")
+    }
+
+    override fun isApplicable(kotlinCompilation: KotlinCompilation<*>): Boolean {
+        return kotlinCompilation.target.platformType in setOf(
+            org.jetbrains.kotlin.gradle.plugin.KotlinPlatformType.jvm,
+            org.jetbrains.kotlin.gradle.plugin.KotlinPlatformType.wasm,
+        )
+    }
+}
 
 apply<StorytaleCompilerPlugin>()
+apply<MakePreviewPublicCompilerPlugin>()
 
 configurations.all {
     resolutionStrategy.dependencySubstitution {
         substitute(module("org.jetbrains.compose.storytale:local-compiler-plugin"))
             .using(project(":modules:compiler-plugin"))
+        substitute(module("org.jetbrains.compose.storytale.preview.public:local-compiler-plugin"))
+            .using(project(":modules:preview-processor"))
     }
 }
 
@@ -107,9 +131,17 @@ kotlin {
     }
 }
 
+dependencies {
+    add("kspCommonMainMetadata", project(":modules:preview-processor"))
+    add("ksp", project(":modules:preview-processor"))
+}
+
 compose.desktop {
     application {
         mainClass = "storytale.gallery.demo.MainKt"
+        buildTypes.release.proguard {
+            isEnabled.set(false)
+        }
     }
 }
 

gallery-demo/src/commonMain/kotlin/storytale/gallery/demo/PreviewCheckbox.kt

@@ -0,0 +1,28 @@
+package storytale.gallery.demo
+
+import androidx.compose.material3.TriStateCheckbox
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.state.ToggleableState
+import androidx.compose.ui.state.ToggleableState.Indeterminate
+import androidx.compose.ui.state.ToggleableState.Off
+import androidx.compose.ui.state.ToggleableState.On
+import org.jetbrains.compose.storytale.previewParameter
+import org.jetbrains.compose.ui.tooling.preview.Preview
+
+@Preview
+@Composable
+@Suppress("ktlint")
+private fun PreviewCheckbox() {
+    var state by previewParameter(ToggleableState.entries)
+
+    TriStateCheckbox(
+        state = state,
+        onClick = {
+            state = when (state) {
+                On -> Indeterminate
+                Off -> On
+                Indeterminate -> Off
+            }
+        },
+    )
+}

gallery-demo/src/desktopMain/kotlin/storytale/gallery/demo/PreviewButton.kt

@@ -0,0 +1,51 @@
+package storytale.gallery.demo
+
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.AddCircle
+import androidx.compose.material3.ExtendedFloatingActionButton
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.SegmentedButton
+import androidx.compose.material3.SegmentedButtonDefaults
+import androidx.compose.material3.SingleChoiceSegmentedButtonRow
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.mutableIntStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+import org.jetbrains.compose.storytale.previewParameter
+
+@org.jetbrains.compose.ui.tooling.preview.Preview
+@Composable
+@Suppress("ktlint")
+private fun PreviewExtendedFAB() {
+    val bgColor by previewParameter(MaterialTheme.colorScheme.primary)
+
+    ExtendedFloatingActionButton(onClick = {}, containerColor = bgColor) {
+        Icon(imageVector = Icons.Default.AddCircle, contentDescription = null)
+        Spacer(Modifier.padding(4.dp))
+        Text("Extended")
+    }
+}
+
+@androidx.compose.desktop.ui.tooling.preview.Preview
+@Composable
+@Suppress("ktlint")
+private fun PreviewSegmentedButton() {
+    val selectedIndex = remember { mutableIntStateOf(0) }
+
+    SingleChoiceSegmentedButtonRow {
+        repeat(3) { index ->
+            SegmentedButton(
+                selected = index == selectedIndex.value,
+                onClick = { selectedIndex.value = index },
+                shape = SegmentedButtonDefaults.itemShape(index, 3),
+            ) {
+                Text("Button $index", modifier = Modifier.padding(4.dp))
+            }
+        }
+    }
+}

gradle/libs.versions.toml

@@ -21,10 +21,12 @@ dokka = "1.9.10"
 kotlinx-html = "0.7.3"
 junit = "5.10.1"
 jsoup = "1.16.1"
+ksp = "2.1.20-2.0.1"
 
 [libraries]
 assertj-core = { module = "org.assertj:assertj-core", version.ref = "assertj" }
 kotlinCompileTesting-core = { module = "dev.zacsweers.kctfork:core", version.ref = "kotlinCompileTesting" }
+kotlinCompileTesting-ksp = { module = "dev.zacsweers.kctfork:ksp", version.ref = "kotlinCompileTesting" }
 junit = { module = "junit:junit", version.ref = "junitVersion" }
 kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin" }
 androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "androidx-activityCompose" }
@@ -45,6 +47,7 @@ junit-api = { module = "org.junit.jupiter:junit-jupiter-api", version.ref = "jun
 jsoup = { module = "org.jsoup:jsoup", version.ref = "jsoup" }
 ktlint = "com.pinterest.ktlint:ktlint-cli:1.5.0"
 composeRules = "io.nlopez.compose.rules:ktlint:0.4.22"
+ksp-api = { module = "com.google.devtools.ksp:symbol-processing-api", version.ref = "ksp" }
 
 [plugins]
 androidApplication = { id = "com.android.application", version.ref = "agp" }
@@ -57,6 +60,6 @@ buildTimeConfig = { id = "dev.limebeck.build-time-config", version.ref = "build-
 storytale = { id = "org.jetbrains.compose.storytale", version.ref = "storytale" }
 kotlinDsl = { id = "kotlin-dsl" }
 spotless = { id = "com.diffplug.spotless", version.ref = "spotless" }
-
+ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
 kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
 dokka = { id = "org.jetbrains.dokka", version.ref = "dokka" }

modules/preview-processor-test/.gitignore

@@ -0,0 +1 @@
+/build

modules/preview-processor-test/build.gradle.kts

@@ -0,0 +1,70 @@
+import org.gradle.kotlin.dsl.compileOnly
+import org.gradle.kotlin.dsl.kotlin
+import org.gradle.kotlin.dsl.project
+import org.gradle.kotlin.dsl.withType
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask
+
+plugins {
+    alias(libs.plugins.kotlinMultiplatform)
+    alias(libs.plugins.androidLibrary)
+    alias(libs.plugins.jetbrainsCompose)
+    alias(libs.plugins.compose.compiler)
+}
+
+kotlin {
+    jvm()
+    androidTarget()
+
+    sourceSets {
+        val commonMain by getting {
+            dependencies {
+                compileOnly(compose.runtime)
+            }
+        }
+        val jvmMain by getting {
+            dependencies {
+                implementation(compose.components.uiToolingPreview)
+                implementation(project(":modules:preview-processor"))
+                implementation(kotlin("test"))
+
+                implementation(compose.runtime)
+                implementation(kotlin("compiler-embeddable"))
+                implementation(kotlin("compose-compiler-plugin-embeddable"))
+                implementation(kotlin("test"))
+                implementation(libs.assertj.core)
+                implementation(libs.junit)
+                implementation(libs.kotlinCompileTesting.ksp)
+                implementation(project(":modules:runtime-api"))
+            }
+        }
+        val androidUnitTest by getting {
+            dependsOn(jvmMain)
+
+            dependencies {
+                implementation("androidx.compose.ui:ui-tooling-preview-android:1.7.0")
+            }
+        }
+        val jvmTest by getting {
+            dependencies {
+                implementation("androidx.compose.ui:ui-tooling-preview-desktop:1.7.0")
+            }
+        }
+    }
+}
+
+android {
+    compileSdk = 35
+    namespace = "org.jetbrains.compose.storytale.preview.processor.test"
+    sourceSets["main"].manifest.srcFile("src/androidMain/AndroidManifest.xml")
+    defaultConfig {
+        minSdk = 24
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_21
+        targetCompatibility = JavaVersion.VERSION_21
+    }
+}
+
+tasks.withType<KotlinCompilationTask<*>>().configureEach {
+    compilerOptions.optIn.add("org.jetbrains.kotlin.compiler.plugin.ExperimentalCompilerApi")
+}