Improve UI performance by marking composeable stable via .conf

Author: SimonSchubert

composeApp/build.gradle.kts

@@ -93,6 +93,10 @@ android {
     sourceSets["main"].assets.setSrcDirs(listOf("../assets"))
 }
 
+composeCompiler {
+    stabilityConfigurationFiles.add(project.layout.projectDirectory.file("stability_config.conf"))
+}
+
 compose.resources {
     publicResClass = true
     packageOfResClass = "com.linuxcommandlibrary.app.resources"

composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/data/TipsRepository.kt

@@ -1,18 +1,11 @@
 package com.linuxcommandlibrary.app.data
 
 import com.linuxcommandlibrary.shared.MarkdownParser
-import com.linuxcommandlibrary.shared.TextElement
+import com.linuxcommandlibrary.shared.TipInfo
 import com.linuxcommandlibrary.shared.TipSectionElement
 import com.linuxcommandlibrary.shared.platform.AssetReader
-import kotlinx.collections.immutable.ImmutableList
 import kotlinx.collections.immutable.toImmutableList
 
-data class TipInfo(
-    val id: Long,
-    val title: String,
-    val sections: ImmutableList<TipSectionElement>,
-)
-
 class TipsRepository(private val assetReader: AssetReader) {
 
     fun getTips(): List<TipInfo> = try {

composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/composables/TableView.kt

@@ -25,11 +25,12 @@ import androidx.compose.ui.text.withStyle
 import androidx.compose.ui.unit.dp
 import com.linuxcommandlibrary.app.NavEvent
 import com.linuxcommandlibrary.shared.TextElement
+import kotlinx.collections.immutable.ImmutableList
 
 @Composable
 fun TableView(
-    headers: List<List<TextElement>>,
-    rows: List<List<List<TextElement>>>,
+    headers: ImmutableList<ImmutableList<TextElement>>,
+    rows: ImmutableList<ImmutableList<ImmutableList<TextElement>>>,
     onNavigate: (NavEvent) -> Unit = {},
     modifier: Modifier = Modifier,
 ) {

composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/composables/TipSectionContent.kt

@@ -21,6 +21,7 @@ import androidx.compose.ui.unit.dp
 import com.linuxcommandlibrary.app.NavEvent
 import com.linuxcommandlibrary.shared.TextElement
 import com.linuxcommandlibrary.shared.TipSectionElement
+import kotlinx.collections.immutable.ImmutableList
 
 fun buildTextElementString(
     elements: List<TextElement>,
@@ -81,7 +82,7 @@ fun buildTextElementString(
 
 @Composable
 fun TipSectionContent(
-    sections: List<TipSectionElement>,
+    sections: ImmutableList<TipSectionElement>,
     onNavigate: (NavEvent) -> Unit,
     textColor: Color = Color.Unspecified,
     commandVerticalPadding: Dp = 0.dp,

composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/screens/tips/TipsScreen.kt

@@ -18,7 +18,7 @@ import androidx.compose.runtime.getValue
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.unit.dp
 import com.linuxcommandlibrary.app.NavEvent
-import com.linuxcommandlibrary.app.data.TipInfo
+import com.linuxcommandlibrary.shared.TipInfo
 import com.linuxcommandlibrary.app.ui.composables.SectionTitle
 import com.linuxcommandlibrary.app.ui.composables.TipSectionContent
 import kotlinx.collections.immutable.ImmutableList
@@ -46,7 +46,7 @@ fun TipsContent(
             .background(MaterialTheme.colorScheme.background)
             .fillMaxSize(),
         columns = StaggeredGridCells.Adaptive(minSize = 300.dp),
-        contentPadding = PaddingValues(horizontal = 4.dp),
+        contentPadding = PaddingValues(horizontal = 4.dp, vertical = 4.dp),
     ) {
         items(
             items = tips,
@@ -59,7 +59,9 @@ fun TipsContent(
 }
 
 @Composable
-private fun TipItemCard(tip: TipInfo, onNavigate: (NavEvent) -> Unit) {
+private fun TipItemCard(
+    tip: TipInfo,
+    onNavigate: (NavEvent) -> Unit) {
     Card(
         elevation = CardDefaults.cardElevation(defaultElevation = 4.dp),
         modifier = Modifier

composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/screens/tips/TipsViewModel.kt

@@ -1,6 +1,6 @@
 package com.linuxcommandlibrary.app.ui.screens.tips
 
-import com.linuxcommandlibrary.app.data.TipInfo
+import com.linuxcommandlibrary.shared.TipInfo
 import com.linuxcommandlibrary.app.data.TipsRepository
 import com.linuxcommandlibrary.app.platform.showAndroidTerminalTip
 import com.linuxcommandlibrary.shared.TextElement

composeApp/stability_config.conf

@@ -0,0 +1,15 @@
+// Classes from the common module that should be considered stable
+com.linuxcommandlibrary.shared.TipSectionElement
+com.linuxcommandlibrary.shared.TipSectionElement.*
+com.linuxcommandlibrary.shared.TextElement
+com.linuxcommandlibrary.shared.TextElement.*
+com.linuxcommandlibrary.shared.CommandElement
+com.linuxcommandlibrary.shared.CommandElement.*
+com.linuxcommandlibrary.shared.TipInfo
+com.linuxcommandlibrary.shared.BasicInfo
+com.linuxcommandlibrary.shared.BasicGroup
+com.linuxcommandlibrary.shared.CommandInfo
+com.linuxcommandlibrary.shared.CommandSectionInfo
+
+// AndroidX Navigation
+androidx.navigation.NavDestination