3.2.0 (#166)

Author: Nek-12

.claude/agents/feature-planner.md

@@ -178,3 +178,4 @@ docs/javadocs/**
 /.intellijPlatform/
 **/*.jks
 /.idea/ChatHistory_schema_v2.xml
+**/tmp/**

.gitignore

@@ -11,10 +11,21 @@ FlowMVI is a Kotlin Multiplatform MVI (Model-View-Intent) framework built on cor
 ## Main Directories:
 
 - `core/src/commonMain/kotlin/pro/respawn/flowmvi` - core logic, main module
-  - ./plugins - default plugins and implementation samples.
   - ./StoreImpl.kt - core store implementation
-  - ./modules/ - various store components, like code on how plugins work,
-  - ./api/ - public API interfaces and contract.
+  - ./api/ - public API interfaces and contracts (Store, State, Intent, Action, etc.)
+  - ./dsl/ - DSL builders for stores, plugins, and configurations
+  - ./modules/ - internal store modules (intent, state, action, recovery, lifecycle)
+  - ./plugins/ - built-in plugins (logging, undo/redo, caching, job management, etc.)
+    - ./delegate/ - delegate plugins for composition
+  - ./decorators/ - public api intent decorators (retry, batch, conflate, timeout)
+  - ./decorator/ - decorator framework and builders
+  - ./impl/ - internal implementations
+    - ./plugin/ - plugin execution machinery
+    - ./store/ - store internals
+  - ./util/ - utility classes (locks, dispatchers, collections)
+  - ./exceptions/ - custom exceptions
+  - ./annotation/ - API annotations (@ExperimentalFlowMVIAPI, etc.)
+  - ./logging/ - logging framework and implementations
 - `android/` - Android ViewModel integration
 - `compose/` - Compose Multiplatform integration with lifecycle-aware subscriptions
 - `savedstate/` - Cross-platform state persistence
@@ -43,3 +54,12 @@ FlowMVI is a Kotlin Multiplatform MVI (Model-View-Intent) framework built on cor
 - Document public code ONLY via kdocs.
 - Do not run `assemble` on the entire project, that task can take hours, use more granular tasks
 - Avoid source breaking changes. Deprecate public api instead of removing it.
+
+## Commit Guidelines
+
+Format: `<type>[!]: [description]` where scope is optional, `!` = breaking change
+
+**Types:** `feat` (→🚀 Features), `fix` (→🐞 Fixes), `feat!`/`breaking`/`api` (→🧨 Breaking), `docs` (→📚 Docs), 
+`perf`, `refactor`, `test`, `chore`, `build`, `ci`, `style`, `revert`
+
+Examples: `feat: add state recovery`, `fix: resolve lifecycle conflict`, `feat!: change Saver API`

CLAUDE.md

@@ -170,3 +170,11 @@ rootProject.plugins.withType<YarnPlugin>().configureEach {
         yarnLockAutoReplace = true
     }
 }
+
+gradle.taskGraph.whenReady {
+    val lastTask = allTasks.lastOrNull()
+    lastTask?.doLast {
+        if (this.state.failure != null) return@doLast
+        println("✅ TASK SUCCESSFUL. Some messages suppressed by logging.level=warn")
+    }
+}

build.gradle.kts

@@ -20,8 +20,8 @@ object Config {
     const val majorRelease = 3
     const val minorRelease = 2
     const val patch = 0
-    const val postfix = "-alpha06" // include dash (-)
-    const val versionCode = 11
+    const val postfix = "" // include dash (-)
+    const val versionCode = 12
 
     const val majorVersionName = "$majorRelease.$minorRelease.$patch"
     const val versionName = "$majorVersionName$postfix"
@@ -53,6 +53,11 @@ object Config {
         "-Xconsistent-data-class-copy-visibility",
         "-Xwarning-level=NOTHING_TO_INLINE:disabled",
         "-Xwarning-level=UNUSED_ANONYMOUS_PARAMETER:disabled",
+        "-Xcontext-sensitive-resolution",
+        "-Xcontext-parameters",
+        // "-Xwhen-guards",
+        "-Xallow-reified-type-in-catch",
+        "-Xdata-flow-based-exhaustiveness",
     )
     val jvmCompilerArgs = buildList {
         add("-Xjvm-default=all") // enable all jvm optimizations

buildSrc/src/main/kotlin/Config.kt

@@ -33,7 +33,7 @@ public val StoreLogLevel.asSymbol: String
     }
 
 /**
- * Write a message to [StoreLogger]. Tag is the [Store.name] by default.
+ * Write a message to [StoreLogger]. Tag is the [pro.respawn.flowmvi.api.Store.name] by default.
  */
 public fun PipelineContext<*, *, *>.log(
     level: StoreLogLevel = StoreLogLevel.Debug,
@@ -42,7 +42,7 @@ public fun PipelineContext<*, *, *>.log(
 ): Unit = config.logger(level, tag, message)
 
 /**
- * Write a message to [StoreLogger]. Tag is the [Store.name] by default.
+ * Write a message to [StoreLogger]. Tag is the [pro.respawn.flowmvi.api.Store.name] by default.
  */
 public fun PipelineContext<*, *, *>.log(
     e: Exception,
@@ -87,3 +87,59 @@ public fun StoreLogger.warn(tag: String? = null, message: () -> String): Unit =
  */
 public fun StoreLogger.error(tag: String? = null, message: () -> String): Unit =
     log(StoreLogLevel.Error, tag, message)
+
+/**
+ * Shorthand for [log] with [StoreLogLevel.Trace] as the log level.
+ */
+public fun PipelineContext<*, *, *>.logt(
+    tag: String? = config.name,
+    message: () -> String
+): Unit = log(StoreLogLevel.Trace, tag, message)
+
+/**
+ * Shorthand for [log] with [StoreLogLevel.Debug] as the log level.
+ */
+public fun PipelineContext<*, *, *>.logd(
+    tag: String? = config.name,
+    message: () -> String
+): Unit = log(StoreLogLevel.Debug, tag, message)
+
+/**
+ * Shorthand for [log] with [StoreLogLevel.Info] as the log level.
+ */
+public fun PipelineContext<*, *, *>.logi(
+    tag: String? = config.name,
+    message: () -> String
+): Unit = log(StoreLogLevel.Info, tag, message)
+
+/**
+ * Shorthand for [log] with [StoreLogLevel.Warn] as the log level.
+ */
+public fun PipelineContext<*, *, *>.logw(
+    tag: String? = config.name,
+    message: () -> String
+): Unit = log(StoreLogLevel.Warn, tag, message)
+
+/**
+ * Shorthand for [log] with [StoreLogLevel.Error] as the log level.
+ */
+public fun PipelineContext<*, *, *>.loge(
+    tag: String? = config.name,
+    message: () -> String
+): Unit = log(StoreLogLevel.Error, tag, message)
+
+/**
+ * Shorthand for logging an exception with [StoreLogLevel.Error] as the log level.
+ */
+public fun PipelineContext<*, *, *>.loge(
+    e: Exception,
+    tag: String? = config.name
+): Unit = log(e, StoreLogLevel.Error, tag)
+
+/**
+ * Shorthand for logging an exception with [StoreLogLevel.Warn] as the log level.
+ */
+public fun PipelineContext<*, *, *>.logw(
+    e: Exception,
+    tag: String? = config.name
+): Unit = log(e, StoreLogLevel.Warn, tag)

core/src/commonMain/kotlin/pro/respawn/flowmvi/logging/LoggingDsl.kt

@@ -1,4 +1,6 @@
 @file:Suppress("UnusedParameter", "UNUSED_PARAMETER")
+@file:OptIn(ExperimentalWasmJsInterop::class)
+
 package pro.respawn.flowmvi.logging
 
 private fun log(message: String): Unit = js("""console.log(message)""")

core/src/wasmJsMain/kotlin/pro/respawn/flowmvi/logging/PlatformStoreLogger.FlowMVI.core.wasmJs.kt

@@ -1,7 +1,7 @@
 @file:Suppress("UnstableApiUsage")
 
-import org.jetbrains.intellij.platform.gradle.IntelliJPlatformType
 import kotlin.text.replace
+import org.jetbrains.intellij.platform.gradle.IntelliJPlatformType
 
 plugins {
     kotlin("jvm")
@@ -41,7 +41,9 @@ intellijPlatform {
     }
     pluginVerification {
         ides {
-            props["plugin.local.ide.path"]?.toString()?.let(::local) ?: create(
+            // TODO: https://github.com/JetBrains/intellij-platform-gradle-plugin/issues/1965
+            // props["plugin.local.ide.path"]?.toString()?.let(::local)
+            create(
                 IntelliJPlatformType.IntellijIdeaCommunity,
                 libs.versions.intellij.idea.get()
             )
@@ -115,6 +117,7 @@ dependencies {
     implementation(applibs.bundles.koin)
 
     intellijPlatform {
+        @Suppress("DEPRECATION") // crashes without this usage :D
         intellijIdeaCommunity(libs.versions.intellij.idea)
         pluginVerifier()
         zipSigner()

debugger/ideplugin/build.gradle.kts

@@ -9,24 +9,24 @@ import pro.respawn.flowmvi.api.MVIAction
 import pro.respawn.flowmvi.api.MVIIntent
 import pro.respawn.flowmvi.api.MVIState
 import pro.respawn.flowmvi.debugger.server.BuildFlags
+import pro.respawn.flowmvi.debugger.server.platform.FileManager
 import pro.respawn.flowmvi.dsl.StoreBuilder
 import pro.respawn.flowmvi.plugins.enableLogging
 import pro.respawn.flowmvi.savedstate.api.Saver
 import pro.respawn.flowmvi.savedstate.dsl.CompressedFileSaver
 import pro.respawn.flowmvi.savedstate.dsl.JsonSaver
 import pro.respawn.flowmvi.savedstate.plugins.saveStatePlugin
-import java.io.File
 
 internal class DefaultStoreConfiguration(
     private val json: Json,
+    private val fileManager: FileManager,
 ) : StoreConfiguration {
 
     override fun <S : MVIState> saver(
         serializer: KSerializer<S>,
         fileName: String,
     ) = CompressedFileSaver(
-        // TODO: Abstract away
-        path = { File(".cache").apply { mkdirs() }.resolve("$fileName.json.gz").absolutePath }
+        path = { fileManager.cacheFile("states", "$fileName.json.gz") }
     ).let { JsonSaver(json, serializer, it) }
 
     override operator fun <S : MVIState, I : MVIIntent, A : MVIAction> StoreBuilder<S, I, A>.invoke(

debugger/server/src/commonMain/kotlin/pro/respawn/flowmvi/debugger/server/arch/configuration/DefaultStoreConfiguration.kt

@@ -11,7 +11,7 @@ import pro.respawn.flowmvi.debugger.server.ui.screens.timeline.TimelineContainer
 
 val appModule = module {
     single { DefaultJson }
-    single<StoreConfiguration> { DefaultStoreConfiguration(get()) }
+    single<StoreConfiguration> { DefaultStoreConfiguration(get(), get()) }
     container { new(::ConnectContainer) }
     container { new(::TimelineContainer) }
     container { new(::StoreDetailsContainer) }