feat: add @stable annotation to domain models for Compose stability

- Add compose-runtime dependency to core module (compileOnly)
- Add @stable annotation to: Book, Category, Line, TocEntry, AltTocEntry, AltTocStructure

This enables Compose compiler to recognize these models as stable,
preventing unnecessary recompositions when passed to composables.

Author: kdroidFilter

core/build.gradle.kts

@@ -22,6 +22,8 @@ kotlin {
         commonMain.dependencies {
             implementation(libs.kotlinx.serialization.json)
             implementation(libs.kotlinx.serialization.protobuf)
+            // Compose runtime for @Stable annotation (used by consuming Compose apps)
+            compileOnly(libs.compose.runtime)
         }
 
         commonTest.dependencies {

core/src/commonMain/kotlin/io/github/kdroidfilter/seforimlibrary/core/models/AltToc.kt

@@ -1,11 +1,13 @@
 package io.github.kdroidfilter.seforimlibrary.core.models
 
+import androidx.compose.runtime.Stable
 import kotlinx.serialization.Serializable
 
 /**
  * Describes an alternative TOC structure available for a book
  * (e.g., Parasha/Aliyah alongside the primary chapter/verse).
  */
+@Stable
 @Serializable
 data class AltTocStructure(
     val id: Long = 0,
@@ -18,6 +20,7 @@ data class AltTocStructure(
 /**
  * Single entry inside an alternative TOC tree.
  */
+@Stable
 @Serializable
 data class AltTocEntry(
     val id: Long = 0,

core/src/commonMain/kotlin/io/github/kdroidfilter/seforimlibrary/core/models/Book.kt

@@ -1,5 +1,6 @@
 package io.github.kdroidfilter.seforimlibrary.core.models
 
+import androidx.compose.runtime.Stable
 import kotlinx.serialization.Serializable
 
 /**
@@ -20,6 +21,7 @@ import kotlinx.serialization.Serializable
  * @property hasTeamim Indicates if the book contains biblical cantillation marks (teamim)
  * @property hasNekudot Indicates if the book contains vowel points (nikud/nekudot)
  */
+@Stable
 @Serializable
 data class Book(
     val id: Long = 0,

core/src/commonMain/kotlin/io/github/kdroidfilter/seforimlibrary/core/models/Category.kt

@@ -1,5 +1,6 @@
 package io.github.kdroidfilter.seforimlibrary.core.models
 
+import androidx.compose.runtime.Stable
 import kotlinx.serialization.Serializable
 
 /**
@@ -11,6 +12,7 @@ import kotlinx.serialization.Serializable
  * @property level The level of the category in the hierarchy (0 for root categories)
  * @property order The display order of the category (lower values appear first)
  */
+@Stable
 @Serializable
 data class Category(
     val id: Long = 0,

core/src/commonMain/kotlin/io/github/kdroidfilter/seforimlibrary/core/models/Line.kt

@@ -1,5 +1,6 @@
 package io.github.kdroidfilter.seforimlibrary.core.models
 
+import androidx.compose.runtime.Stable
 import kotlinx.serialization.Serializable
 
 /**
@@ -11,6 +12,7 @@ import kotlinx.serialization.Serializable
  * @property content The original HTML content of the line
  * @property heRef The Hebrew reference/citation (e.g., "בראשית א, א")
  */
+@Stable
 @Serializable
 data class Line(
     val id: Long = 0,

core/src/commonMain/kotlin/io/github/kdroidfilter/seforimlibrary/core/models/TocEntry.kt

@@ -1,5 +1,6 @@
 package io.github.kdroidfilter.seforimlibrary.core.models
 
+import androidx.compose.runtime.Stable
 import kotlinx.serialization.Serializable
 
 /**
@@ -14,6 +15,7 @@ import kotlinx.serialization.Serializable
  * @property lineId The identifier of the associated line, or null if not linked to a specific line
  * @property isLastChild Indicates if this TOC entry is the last child of its parent
  */
+@Stable
 @Serializable
 data class TocEntry(
     val id: Long = 0,

gradle/libs.versions.toml

@@ -41,6 +41,7 @@ commons-compress = { module = "org.apache.commons:commons-compress", version.ref
 zstd = { module = "com.github.luben:zstd-jni", version.ref = "zstd-jni" }
 androidx-activityCompose = { module = "androidx.activity:activity-compose", version.ref = "androidx-activityCompose" }
 jsoup = { module = "org.jsoup:jsoup", version.ref = "jsoup" }
+compose-runtime = { module = "org.jetbrains.compose.runtime:runtime", version.ref = "compose" }
 
 [plugins]