[Wasm] Rename JsHandle to JsReference

Decision to do this was made at Kotlin/Wasm interop design meeting

libraries/stdlib/wasm/internal/kotlin/wasm/internal/ExternalWrapper.kt

@@ -126,8 +126,8 @@ private fun externrefEquals(lhs: ExternalInterfaceType, rhs: ExternalInterfaceTy
 
 private external fun tryGetOrSetExternrefBox(
     ref: ExternalInterfaceType,
-    ifNotCached: JsHandle<JsExternalBox>
-): JsHandle<JsExternalBox>?
+    ifNotCached: JsReference<JsExternalBox>
+): JsReference<JsExternalBox>?
 
 @WasmNoOpCast
 @Suppress("unused")
@@ -174,7 +174,7 @@ internal fun externRefToAny(ref: ExternalInterfaceType): Any? {
     // If we have Null in notNullRef -- return null
     // If we already have a box -- return it,
     // otherwise -- remember new box and return it.
-    return tryGetOrSetExternrefBox(ref, JsExternalBox(ref).toJsHandle())
+    return tryGetOrSetExternrefBox(ref, JsExternalBox(ref).toJsReference())
 }
 
 

libraries/stdlib/wasm/src/kotlin/Dynamic.kt

@@ -16,8 +16,8 @@ public external interface Dynamic : JsAny
 /**
  * Reinterprets this value as a value of the Dynamic type.
  */
-@Deprecated("If value is a subtype of JsAny, use JsAny instead. Otherwise, use toJsHandle", level = DeprecationLevel.ERROR)
-fun Any.asDynamic(): JsAny = this.toJsHandle()
+@Deprecated("If value is a subtype of JsAny, use JsAny instead. Otherwise, use toJsReference", level = DeprecationLevel.ERROR)
+fun Any.asDynamic(): JsAny = this.toJsReference()
 
 /**
  * Reinterprets this value as a value of the Dynamic type.

libraries/stdlib/wasm/src/kotlin/js/JsReference.kt

@@ -10,20 +10,20 @@ import kotlin.wasm.internal.implementedAsIntrinsic
 import kotlin.wasm.internal.returnArgumentIfItIsKotlinAny
 
 /**
- * JavaScript value that can serve as a handle for any Kotlin value.
+ * JavaScript value that can serve as a reference for any Kotlin value.
  *
  * In JavaScript, it behaves like an immutable empty object with a null prototype.
  * When passed back to Kotlin/Wasm, the original value can be retrieved using the [get] method.
  */
 @Suppress("WRONG_JS_INTEROP_TYPE")  // Exception to the rule
-public sealed external interface JsHandle<out T : Any> : JsAny
+public sealed external interface JsReference<out T : Any> : JsAny
 
 @WasmOp(WasmOp.EXTERN_EXTERNALIZE)
-public fun <T : Any> T.toJsHandle(): JsHandle<T> =
+public fun <T : Any> T.toJsReference(): JsReference<T> =
     implementedAsIntrinsic
 
-/** Retrieve original Kotlin value from JsHandle */
-public fun <T : Any> JsHandle<T>.get(): T {
+/** Retrieve original Kotlin value from JsReference */
+public fun <T : Any> JsReference<T>.get(): T {
     returnArgumentIfItIsKotlinAny(this)
-    throw ClassCastException("JsHandle doesn't contain a Kotlin type")
+    throw ClassCastException("JsReference doesn't contain a Kotlin type")
 }

libraries/stdlib/wasm/test/js/AsyncTest.kt

@@ -57,6 +57,6 @@ class AsyncTest {
     @Test
     fun testJsValueToThrowableOrNull2() {
         val e = MyThrowable()
-        assertEquals((e.toJsHandle()).toThrowableOrNull(), e)
+        assertEquals((e.toJsReference()).toThrowableOrNull(), e)
     }
 }