Explicitly declare stability levels of declarations in kotlinx.cinterop package

* @ExperimentalForeignApi for all declarations that operate on
    unmanaged memory (i.e. pointers and references)
* @BetaInteropApi for the rest of the interoperability declarations,
    namely Swift/CInterop-specific interfaces and convenience-functions

### Implementation details

* Some typealiases are not marked explicitly because it crashes the compiler,
    yet their experimentality is properly propagated
* License header is adjusted where it previously had been existing
* Deprecated with ERROR interop declarations that are deprecated for more than
    two years are removed
* WASM target interop declarations are deprecated
* Deliberately make Boolean.toByte and Byte.toBoolean foreign-experimental to scare
    people away

^KT-57728 fixed

Merge-request: KT-MR-9788
Merged-by: Vsevolod Tolstopyatov <qwwdfsad@gmail.com>

kotlin-native/backend.native/tests/interop/basics/0.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import sysstat.*
 import kotlinx.cinterop.*
@@ -11,4 +12,4 @@ fun main(args: Array<String>) {
     val res = stat("/", statBuf.ptr)
     println(res)
     println(statBuf.st_uid)
-}
+}

kotlin-native/backend.native/tests/interop/basics/1.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import cstdlib.*
 import kotlinx.cinterop.*
@@ -14,4 +15,4 @@ fun main(args: Array<String>) {
     println(quot)
     println(rem)
 
-}
+}

kotlin-native/backend.native/tests/interop/basics/3.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlinx.cinterop.*
 

kotlin-native/backend.native/tests/interop/basics/4.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import cstdio.*
 import kotlinx.cinterop.*
@@ -19,4 +20,4 @@ fun main(args: Array<String>) {
         val sscanfResult = sscanf("42", "%d%d", aVar.ptr, bVar.ptr)
         printf("%d %d\n", sscanfResult, aVar.value)
     }
-}
+}

kotlin-native/backend.native/tests/interop/basics/5.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import platform.posix.printf
 

kotlin-native/backend.native/tests/interop/basics/arrayPointers.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import carrayPointers.*
 import kotlin.test.*
 import kotlinx.cinterop.*
@@ -13,4 +15,4 @@ fun main() {
         struct.arrayPointer = globalArray
         assertEquals(globalArray[0], struct.arrayPointer!![0])
     }
-}
+}

kotlin-native/backend.native/tests/interop/basics/available_processors.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2021 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlin.native.*
 import kotlin.test.*

kotlin-native/backend.native/tests/interop/basics/bf.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import bitfields.*
 import kotlinx.cinterop.*

kotlin-native/backend.native/tests/interop/basics/callbacksAndVarargs.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlin.test.*
 import kotlinx.cinterop.*

kotlin-native/backend.native/tests/interop/basics/echo_server.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlinx.cinterop.*
 import sockets.*

kotlin-native/backend.native/tests/interop/basics/enums.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2022 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import cenums.*
 import kotlinx.cinterop.*
@@ -27,4 +28,4 @@ fun main() {
 //    assertEquals(entries[0], E.A)
 //    assertEquals(entries[1], E.B)
 //    assertEquals(entries[2], E.C)
-}
+}

kotlin-native/backend.native/tests/interop/basics/funptr.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlinx.cinterop.*
 import cfunptr.*
@@ -43,4 +44,4 @@ fun main(args: Array<String>) {
     printIntPtr(notSoLongSignatureFunction(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0))
 }
 
-fun Boolean.ifThenOneElseZero() = if (this) 1 else 0
+fun Boolean.ifThenOneElseZero() = if (this) 1 else 0

kotlin-native/backend.native/tests/interop/basics/globals.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlinx.cinterop.*
 import cglobals.*

kotlin-native/backend.native/tests/interop/basics/macros.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlin.test.*
 import cmacros.*

kotlin-native/backend.native/tests/interop/basics/opengl_teapot.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlinx.cinterop.*
 import platform.GLUT.*
@@ -113,4 +114,4 @@ fun main(args: Array<String>) {
 
     // run GLUT mainloop
     glutMainLoop()
-}
+}

kotlin-native/backend.native/tests/interop/basics/pinning.kt

@@ -1,7 +1,8 @@
 /*
- * Copyright 2010-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
 
 import kotlin.test.*
 import kotlinx.cinterop.*

kotlin-native/backend.native/tests/interop/basics/structAnonym.kt

@@ -1,3 +1,6 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
+
 import kotlinx.cinterop.*
 import kotlin.test.*
 import structAnonym.*

kotlin-native/backend.native/tests/interop/basics/structs.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import cstructs.*
 import kotlinx.cinterop.*
 import kotlin.test.*
@@ -116,4 +118,4 @@ fun <T : E> checkEnumSubTyping(e: T) = memScoped {
 fun <T : Int> checkIntSubTyping(x: T) = memScoped {
     val s = alloc<Trivial>()
     s.i = x
-}
+}

kotlin-native/backend.native/tests/interop/basics/toKString.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import ctoKString.*
 import kotlinx.cinterop.*
 import kotlin.native.*

kotlin-native/backend.native/tests/interop/basics/types.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import kotlinx.cinterop.*
 import kotlin.native.*
 import kotlin.test.*

kotlin-native/backend.native/tests/interop/basics/union.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import cunion.*
 import kotlinx.cinterop.*
 import kotlin.native.*
@@ -33,4 +35,4 @@ fun main() {
         union.i = 0u
         assertEquals(0u, union.b)
     }
-}
+}

kotlin-native/backend.native/tests/interop/basics/values.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import kotlinx.cinterop.*
 import kotlin.test.*
 import cvalues.*
@@ -7,4 +9,4 @@ fun main() {
     assertTrue(isNullWString(null))
     assertFalse(isNullString("a"))
     assertFalse(isNullWString("b"))
-}
+}

kotlin-native/backend.native/tests/interop/basics/vectors.kt

@@ -1,3 +1,5 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class)
+
 import kotlinx.cinterop.*
 import kotlin.native.*
 import kotlin.test.*

kotlin-native/backend.native/tests/interop/basics/withSpaces.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
+ * Copyright 2010-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */