misc: plannedRemoval annotation (#1415)

Author: 0marperez

runtime/runtime-core/api/runtime-core.api

@@ -36,6 +36,11 @@ public abstract interface annotation class aws/smithy/kotlin/runtime/Experimenta
 public abstract interface annotation class aws/smithy/kotlin/runtime/InternalApi : java/lang/annotation/Annotation {
 }
 
+public abstract interface annotation class aws/smithy/kotlin/runtime/PlannedRemoval : java/lang/annotation/Annotation {
+	public abstract fun major ()I
+	public abstract fun minor ()I
+}
+
 public abstract interface class aws/smithy/kotlin/runtime/ProtocolResponse {
 	public abstract fun getSummary ()Ljava/lang/String;
 }

runtime/runtime-core/common/src/aws/smithy/kotlin/runtime/Annotations.kt

@@ -58,3 +58,16 @@ public annotation class ExperimentalApi
  */
 @DslMarker
 public annotation class SdkDsl
+
+/**
+ * Indicates that the annotated API is deprecated and scheduled for removal in an upcoming version.
+ * Any code using this API should migrate to the suggested replacement as soon as possible.
+ */
+@RequiresOptIn(
+    message = "This API is deprecated and scheduled for removal in an upcoming version.",
+    level = RequiresOptIn.Level.WARNING,
+)
+public annotation class PlannedRemoval(
+    val major: Int,
+    val minor: Int,
+)