add cached value loading strategy

gradle.properties

@@ -19,7 +19,7 @@ makeevrserg.java.ktarget=17
 # Project
 makeevrserg.project.name=KStorage
 makeevrserg.project.group=ru.astrainteractive.klibs
-makeevrserg.project.version.string=2.1.0
+makeevrserg.project.version.string=2.2.0
 makeevrserg.project.description=Kotlin wrapper for key-value storage libraries
 makeevrserg.project.developers=makeevrserg|Makeev Roman|makeevrserg@gmail.com
 makeevrserg.project.url=https://github.com/makeevrserg/klibs.kstorage/

kstorage/src/commonMain/kotlin/ru/astrainteractive/klibs/kstorage/api/impl/DefaultMutableKrate.kt

@@ -7,13 +7,21 @@ import ru.astrainteractive.klibs.kstorage.api.provider.ValueSaver
 
 /**
  * This [DefaultMutableKrate] can be used with delegation
+ *
+ * @param requireInstantLoading - if true, will load value into [cachedValue] directly from [loader].
+ * If false will put [factory] value into [cachedValue]
  */
 class DefaultMutableKrate<T>(
     private val factory: ValueFactory<T>,
     private val saver: ValueSaver<T> = ValueSaver.Empty(),
     private val loader: ValueLoader<T>,
+    private val requireInstantLoading: Boolean = true
 ) : MutableKrate<T> {
-    private var _cachedValue: T = loader.loadAndGet() ?: factory.create()
+
+    private var _cachedValue: T = when {
+        requireInstantLoading -> loader.loadAndGet() ?: factory.create()
+        else -> factory.create()
+    }
 
     override val cachedValue: T
         get() = _cachedValue

kstorage/src/commonMain/kotlin/ru/astrainteractive/klibs/kstorage/api/impl/DefaultStateFlowMutableKrate.kt

@@ -10,13 +10,23 @@ import ru.astrainteractive.klibs.kstorage.api.provider.ValueSaver
 
 /**
  * This [DefaultStateFlowMutableKrate] can be used with delegation
+ *
+ * @param requireInstantLoading - if true, will load value into [cachedValue] directly from [loader].
+ * If false will put [factory] value into [cachedValue]
  */
 class DefaultStateFlowMutableKrate<T>(
     private val factory: ValueFactory<T>,
     private val saver: ValueSaver<T> = ValueSaver.Empty(),
     private val loader: ValueLoader<T>,
+    requireInstantLoading: Boolean = true
 ) : StateFlowMutableKrate<T> {
-    private val _stateFlow = MutableStateFlow(loader.loadAndGet() ?: factory.create())
+
+    private val _stateFlow = MutableStateFlow(
+        value = when {
+            requireInstantLoading -> loader.loadAndGet() ?: factory.create()
+            else -> factory.create()
+        }
+    )
 
     override val cachedStateFlow: StateFlow<T> = _stateFlow.asStateFlow()