Add experimental annotations

instance-keeper/src/commonMain/kotlin/com/arkivanov/essenty/instancekeeper/ExperimentalInstanceKeeperApi.kt

@@ -0,0 +1,9 @@
+package com.arkivanov.essenty.instancekeeper
+
+/**
+ * Marks experimental API in Essenty. An experimental API can be changed or removed at any time.
+ */
+@RequiresOptIn(level = RequiresOptIn.Level.WARNING)
+@Retention(AnnotationRetention.BINARY)
+@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION)
+annotation class ExperimentalInstanceKeeperApi

instance-keeper/src/commonMain/kotlin/com/arkivanov/essenty/instancekeeper/InstanceKeeperExt.kt

@@ -1,7 +1,6 @@
 package com.arkivanov.essenty.instancekeeper
 
 import com.arkivanov.essenty.instancekeeper.InstanceKeeper.SimpleInstance
-import com.arkivanov.essenty.utils.internal.ExperimentalEssentyApi
 import kotlin.reflect.typeOf
 
 /**
@@ -29,14 +28,14 @@ inline fun <reified T : InstanceKeeper.Instance> InstanceKeeper.getOrCreate(fact
 /**
  * A convenience function for [InstanceKeeper.getOrCreate].
  */
-@ExperimentalEssentyApi
+@ExperimentalInstanceKeeperApi
 inline fun <reified T : InstanceKeeper.Instance> InstanceKeeperOwner.retainedInstance(key: Any, factory: () -> T): T =
     instanceKeeper.getOrCreate(key = key, factory = factory)
 
 /**
  * A convenience function for [InstanceKeeper.getOrCreate].
  */
-@ExperimentalEssentyApi
+@ExperimentalInstanceKeeperApi
 inline fun <reified T : InstanceKeeper.Instance> InstanceKeeperOwner.retainedInstance(factory: () -> T): T =
     instanceKeeper.getOrCreate(factory = factory)
 
@@ -62,13 +61,13 @@ inline fun <reified T> InstanceKeeper.getOrCreateSimple(factory: () -> T): T =
 /**
  * A convenience function for [InstanceKeeper.getOrCreateSimple].
  */
-@ExperimentalEssentyApi
+@ExperimentalInstanceKeeperApi
 inline fun <reified T> InstanceKeeperOwner.retainedSimpleInstance(key: Any, factory: () -> T): T =
     instanceKeeper.getOrCreateSimple(key = key, factory = factory)
 
 /**
  * A convenience function for [InstanceKeeper.getOrCreateSimple].
  */
-@ExperimentalEssentyApi
+@ExperimentalInstanceKeeperApi
 inline fun <reified T> InstanceKeeperOwner.retainedSimpleInstance(factory: () -> T): T =
     instanceKeeper.getOrCreateSimple(factory = factory)

state-keeper/src/commonMain/kotlin/com/arkivanov/essenty/statekeeper/ExperimentalStateKeeperApi.kt

@@ -0,0 +1,9 @@
+package com.arkivanov.essenty.statekeeper
+
+/**
+ * Marks experimental API in Essenty. An experimental API can be changed or removed at any time.
+ */
+@RequiresOptIn(level = RequiresOptIn.Level.WARNING)
+@Retention(AnnotationRetention.BINARY)
+@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION)
+annotation class ExperimentalStateKeeperApi

state-keeper/src/commonMain/kotlin/com/arkivanov/essenty/statekeeper/PolymorphicSerializer.kt

@@ -1,6 +1,5 @@
 package com.arkivanov.essenty.statekeeper
 
-import com.arkivanov.essenty.utils.internal.ExperimentalEssentyApi
 import kotlinx.serialization.ExperimentalSerializationApi
 import kotlinx.serialization.KSerializer
 import kotlinx.serialization.descriptors.SerialDescriptor
@@ -18,15 +17,15 @@ import kotlin.reflect.KClass
 /**
  * Creates a polymorphic [KSerializer] for the specified class of type [T] using the specified [module].
  */
-@ExperimentalEssentyApi
+@ExperimentalStateKeeperApi
 @ExperimentalSerializationApi
 inline fun <reified T : Any> polymorphicSerializer(module: SerializersModule): KSerializer<T> =
     polymorphicSerializer(baseClass = T::class, module = module)
 
 /**
  * Creates a polymorphic [KSerializer] for the specified [baseClass] class using the specified [module].
  */
-@ExperimentalEssentyApi
+@ExperimentalStateKeeperApi
 @ExperimentalSerializationApi
 fun <T : Any> polymorphicSerializer(baseClass: KClass<T>, module: SerializersModule): KSerializer<T> =
     PolymorphicSerializer(baseClass = baseClass, module = module)

state-keeper/src/commonMain/kotlin/com/arkivanov/essenty/statekeeper/StateKeeperExt.kt

@@ -1,6 +1,5 @@
 package com.arkivanov.essenty.statekeeper
 
-import com.arkivanov.essenty.utils.internal.ExperimentalEssentyApi
 import kotlinx.serialization.KSerializer
 import kotlin.properties.PropertyDelegateProvider
 import kotlin.properties.ReadOnlyProperty
@@ -21,7 +20,7 @@ import kotlin.reflect.KProperty
  * returns an object of type [T].
  * @return [PropertyDelegateProvider] of type [T], typically used to define a delegated property.
  */
-@ExperimentalEssentyApi
+@ExperimentalStateKeeperApi
 inline fun <T, S : Any> StateKeeper.saveable(
     serializer: KSerializer<S>,
     crossinline state: (T) -> S,
@@ -49,7 +48,7 @@ inline fun <T, S : Any> StateKeeper.saveable(
  * returns an object of type [T].
  * @return [PropertyDelegateProvider] of type [T], typically used to define a delegated property.
  */
-@ExperimentalEssentyApi
+@ExperimentalStateKeeperApi
 inline fun <T, S : Any> StateKeeperOwner.saveable(
     serializer: KSerializer<S>,
     crossinline state: (T) -> S,
@@ -74,7 +73,7 @@ inline fun <T, S : Any> StateKeeperOwner.saveable(
  * @param init a function returning the initial value of type [T].
  * @return [PropertyDelegateProvider] of type [T], typically used to define a delegated property.
  */
-@ExperimentalEssentyApi
+@ExperimentalStateKeeperApi
 inline fun <T : Any> StateKeeper.saveable(
     serializer: KSerializer<T>,
     key: String? = null,
@@ -106,7 +105,7 @@ inline fun <T : Any> StateKeeper.saveable(
  * @param init a function returning the initial value of type [T].
  * @return [PropertyDelegateProvider] of type [T], typically used to define a delegated property.
  */
-@ExperimentalEssentyApi
+@ExperimentalStateKeeperApi
 inline fun <T : Any> StateKeeperOwner.saveable(
     serializer: KSerializer<T>,
     key: String? = null,

state-keeper/src/commonTest/kotlin/com/arkivanov/essenty/statekeeper/PolymorphicSerializerTest.kt

@@ -1,6 +1,5 @@
 package com.arkivanov.essenty.statekeeper
 
-import com.arkivanov.essenty.utils.internal.ExperimentalEssentyApi
 import kotlinx.serialization.ExperimentalSerializationApi
 import kotlinx.serialization.KSerializer
 import kotlinx.serialization.Serializable
@@ -30,7 +29,7 @@ class PolymorphicSerializerTest {
     @Serializable
     private data class Some2(val data: SerializableData) : Some
 
-    @OptIn(ExperimentalEssentyApi::class, ExperimentalSerializationApi::class)
+    @OptIn(ExperimentalStateKeeperApi::class, ExperimentalSerializationApi::class)
     private object SomeSerializer : KSerializer<Some> by polymorphicSerializer(
         SerializersModule {
             polymorphic(Some::class) {

state-keeper/src/commonTest/kotlin/com/arkivanov/essenty/statekeeper/StateKeeperExtTest.kt

@@ -1,11 +1,10 @@
 package com.arkivanov.essenty.statekeeper
 
-import com.arkivanov.essenty.utils.internal.ExperimentalEssentyApi
 import kotlinx.serialization.builtins.serializer
 import kotlin.test.Test
 import kotlin.test.assertEquals
 
-@OptIn(ExperimentalEssentyApi::class)
+@OptIn(ExperimentalStateKeeperApi::class)
 class StateKeeperExtTest {
 
     @Test