Remove experimentality from serializer(java.lang.Type) function family (#2069)

As it is needed for third-part converter libraries.

Revamp docs for all overloads of serializer().

1 files changed, 20 insertions, 7 deletions

diff --git a/formats/json-tests/commonTest/src/kotlinx/serialization/SerializersLookupTest.kt b/formats/json-tests/commonTest/src/kotlinx/serialization/SerializersLookupTest.kt
index 95b458c9..89e53a7a 100644
--- a/formats/json-tests/commonTest/src/kotlinx/serialization/SerializersLookupTest.kt
+++ b/formats/json-tests/commonTest/src/kotlinx/serialization/SerializersLookupTest.kt
@@ -102,6 +102,20 @@ class SerializersLookupTest : JsonTestBase() {
     }
 
     @Test
+    fun testStarProjectionsAreProhibited() {
+        val expectedMessage = "Star projections in type arguments are not allowed"
+        assertFailsWithMessage<IllegalArgumentException>(expectedMessage) {
+            serializer<Box<*>>()
+        }
+        assertFailsWithMessage<IllegalArgumentException>(expectedMessage) {
+            serializer(typeOf<Box<*>>())
+        }
+        assertFailsWithMessage<IllegalArgumentException>(expectedMessage) {
+            serializerOrNull(typeOf<Box<*>>())
+        }
+    }
+
+    @Test
     fun testNullableTypes() {
         val myList: List<Int?> = listOf(1, null, 3)
         assertSerializedWithType("[1,null,3]", myList)
@@ -121,6 +135,12 @@ class SerializersLookupTest : JsonTestBase() {
     }
 
     @Test
+    fun testLookupDuration() = noLegacyJs {
+        assertNotNull(serializerOrNull(typeOf<Duration>()))
+        assertSame(Duration.serializer(), serializer<Duration>())
+    }
+
+    @Test
     fun testCustomGeneric() = noLegacyJs {
         val intBox = Box(42)
         val intBoxSerializer = serializer<Box<Int>>()
@@ -259,13 +279,6 @@ class SerializersLookupTest : JsonTestBase() {
         }
     }
 
-// TODO uncomment when Kotlin 1.7.20 is released
-//    @Test
-//    fun testLookupDuration() = noLegacyJs {
-//        assertNotNull(serializerOrNull(typeOf<Duration>()))
-//        assertSame(Duration.serializer(), serializer<Duration>())
-//    }
-
     private inline fun <reified T> assertSerializedWithType(
         expected: String,
         value: T,