feat: migration to context parameters

- deleted annotation DeprecatedWithContextParameters

- modified typealias MutableBsonArrayLike
- added typealias BsonArrayBuilder
- modified typealias BsonArrayBlock to use context parameters
- deprecated function toMutableBsonArray
- deprecated function asMutableBsonArray
- deprecated functions mutableBsonArrayOf
- deleted interface IMutableBsonArrayLike and moved its members to toplevel

- modified typealias MutableBsonDocumentLike
- added typealias BsonDocumentBuilder
- modified typealias BsonDocumentBlock to use context parameters
- deprecated function toMutableBsonDocument
- deprecated function asMutableBsonDocument
- deprecated functions mutableBsonDocumentOf
- deleted interface MutableBsonMapField
- deleted interface IMutableBsonDocumentLike and move its members to toplevel

Author: lsafer-meemer

module-bsonkt/build.gradle.kts

@@ -7,6 +7,7 @@ plugins {
 
 kotlin {
     compilerOptions {
+        freeCompilerArgs.add("-Xcontext-parameters")
         optIn.add("kotlin.time.ExperimentalTime")
     }
     jvm()

module-bsonkt/src/commonMain/kotlin/Annotations.kt

@@ -15,19 +15,25 @@
  */
 package org.cufy.bson
 
-/**
- * Marks the annotated component as deprecated
- * only after context parameters are stable.
- */
-annotation class DeprecatedWithContextParameters
-
 /**
  * INTERNAL: A marker for bson build functions.
  *
  * @author LSafer
  * @since 2.0.0
  */
 @DslMarker
+@Target(
+    AnnotationTarget.CLASS,
+    AnnotationTarget.PROPERTY,
+    AnnotationTarget.FIELD,
+    AnnotationTarget.LOCAL_VARIABLE,
+    AnnotationTarget.VALUE_PARAMETER,
+    AnnotationTarget.CONSTRUCTOR,
+    AnnotationTarget.FUNCTION,
+    AnnotationTarget.PROPERTY_GETTER,
+    AnnotationTarget.PROPERTY_SETTER,
+    AnnotationTarget.TYPEALIAS,
+)
 annotation class BsonMarker2
 
 /**

module-bsonkt/src/commonMain/kotlin/BsonArray.kt

@@ -72,7 +72,7 @@ inline fun BsonArray(): BsonArray {
  * function will result to an undefined behaviour.**
  */
 inline fun BsonArray(block: BsonArrayBlock): BsonArray {
-    val content = mutableBsonArrayOf()
+    val content = mutableListOf<BsonElement>()
     content.apply(block)
     return BsonArray(content)
 }