Add @SinceKotlin and KDoc for ContextFunctionTypeParams

Initially, it was added accidentally as part of e3f987459c
and missed all out processes.

Adding @SinceKotlin("1.7") after the annotation has already been
published before is not really a problem, because it only may be used
with an experimental `-Xcontext-receivers` flag, thus it doesn't have
to be a part of our regular backward compatibility routine.

^KT-55226 Fixed

compiler/fir/analysis-tests/testData/builtIns/kotlin.txt

@@ -361,7 +361,7 @@ public abstract interface Comparable<in T> : R|kotlin/Any| {
 
 }
 
-@R|kotlin/annotation/Target|(allowedTargets = <implicitArrayOf>(R|kotlin/annotation/AnnotationTarget.TYPE|())) @R|kotlin/annotation/MustBeDocumented|() public final annotation class ContextFunctionTypeParams : R|kotlin/Annotation| {
+@R|kotlin/annotation/Target|(allowedTargets = <implicitArrayOf>(R|kotlin/annotation/AnnotationTarget.TYPE|())) @R|kotlin/annotation/MustBeDocumented|() @R|kotlin/SinceKotlin|(version = String(1.7)) public final annotation class ContextFunctionTypeParams : R|kotlin/Annotation| {
     public final val count: R|kotlin/Int|
         public get(): R|kotlin/Int|
 

compiler/testData/builtin-classes/default/kotlin.txt

@@ -200,7 +200,7 @@ public interface Comparable</*0*/ in T> {
     public abstract operator fun compareTo(/*0*/ other: T): kotlin.Int
 }
 
-@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
+@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented @kotlin.SinceKotlin(version = "1.7") public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
     /*primary*/ public constructor ContextFunctionTypeParams(/*0*/ count: kotlin.Int)
     public final val count: kotlin.Int
         public final fun `<get-count>`(): kotlin.Int

compiler/testData/builtin-classes/java6/kotlin.txt

@@ -208,7 +208,7 @@ public interface Comparable</*0*/ in T> {
     public abstract operator fun compareTo(/*0*/ other: T): kotlin.Int
 }
 
-@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
+@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented @kotlin.SinceKotlin(version = "1.7") public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
     /*primary*/ public constructor ContextFunctionTypeParams(/*0*/ count: kotlin.Int)
     public final val count: kotlin.Int
         public final fun `<get-count>`(): kotlin.Int

compiler/testData/builtin-classes/java8/kotlin.txt

@@ -210,7 +210,7 @@ public interface Comparable</*0*/ in T> {
     public abstract operator fun compareTo(/*0*/ other: T): kotlin.Int
 }
 
-@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
+@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented @kotlin.SinceKotlin(version = "1.7") public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
     /*primary*/ public constructor ContextFunctionTypeParams(/*0*/ count: kotlin.Int)
     public final val count: kotlin.Int
         public final fun `<get-count>`(): kotlin.Int

compiler/testData/builtin-classes/newMethods/kotlin.txt

@@ -208,7 +208,7 @@ public interface Comparable</*0*/ in T> {
     public abstract operator fun compareTo(/*0*/ other: T): kotlin.Int
 }
 
-@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
+@kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE}) @kotlin.annotation.MustBeDocumented @kotlin.SinceKotlin(version = "1.7") public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
     /*primary*/ public constructor ContextFunctionTypeParams(/*0*/ count: kotlin.Int)
     public final val count: kotlin.Int
         public final fun `<get-count>`(): kotlin.Int

core/builtins/src/kotlin/Annotations.kt

@@ -97,8 +97,20 @@ public enum class DeprecationLevel {
 @MustBeDocumented
 public annotation class ExtensionFunctionType
 
+/**
+ * Signifies that the annotated functional type has the prefix of size `count` for context receivers.
+ * Thus, `@ContextFunctionTypeParams(2) @ExtensionFunctionType Function4<String, Int, Double, Byte, Unit>` is a normalized representation of
+ * `context(String, Int) Double.(Byte) -> Unit`.
+ *
+ * Just the same as @ExtensionFunctionType, this annotation is not assumed to be used in source code, preferring the explicit function type
+ * syntax, like in the example above.
+ *
+ * There's no need in any additional opt-in limitations because this annotation might only be referenced by users
+ * who turned on an experimental `-Xcontext-receivers` compiler flag, for which there are no backward/forward compatibilities guarantees.
+ */
 @Target(TYPE)
 @MustBeDocumented
+@SinceKotlin("1.7")
 public annotation class ContextFunctionTypeParams(val count: Int)
 
 /**
@@ -174,4 +186,4 @@ public annotation class DslMarker
 @Retention(AnnotationRetention.BINARY)
 @MustBeDocumented
 @SinceKotlin("1.1")
-public annotation class PublishedApi
+public annotation class PublishedApi

libraries/stdlib/api/js-v1/kotlin.kt

@@ -1336,6 +1336,7 @@ public open class ConcurrentModificationException : kotlin.RuntimeException {
 
 @kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE})
 @kotlin.annotation.MustBeDocumented
+@kotlin.SinceKotlin(version = "1.7")
 public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
     public constructor ContextFunctionTypeParams(count: kotlin.Int)
 
@@ -3767,4 +3768,4 @@ public open class UnsupportedOperationException : kotlin.RuntimeException {
     public constructor UnsupportedOperationException(message: kotlin.String?, cause: kotlin.Throwable?)
 
     public constructor UnsupportedOperationException(cause: kotlin.Throwable?)
-}
+}

libraries/stdlib/api/js/kotlin.kt

@@ -1229,6 +1229,7 @@ public open class ConcurrentModificationException : kotlin.RuntimeException {
 
 @kotlin.annotation.Target(allowedTargets = {AnnotationTarget.TYPE})
 @kotlin.annotation.MustBeDocumented
+@kotlin.SinceKotlin(version = "1.7")
 public final annotation class ContextFunctionTypeParams : kotlin.Annotation {
     public constructor ContextFunctionTypeParams(count: kotlin.Int)
 
@@ -3358,4 +3359,4 @@ public open class UnsupportedOperationException : kotlin.RuntimeException {
     public constructor UnsupportedOperationException(message: kotlin.String?, cause: kotlin.Throwable?)
 
     public constructor UnsupportedOperationException(cause: kotlin.Throwable?)
-}
+}