feat: add setValueAsync to all scalar ViewModel property types (#291)

Stacked on #289.

Adds `setValueAsync(value)` to Number, String, Boolean, Color, and Enum
property types across all 4 backends (iOS experimental, iOS legacy,
Android experimental, Android legacy).

On iOS experimental, this is a proper async write — the promise resolves
only after the SDK `setValue` call completes on the main actor, giving
ordering guarantees and error propagation. On legacy and Android,
`set()` is already synchronous so `setValueAsync` is a thin wrapper that
makes the API consistent.

Includes harness tests covering all 5 property types.

Author: mfazekas

android/src/legacy/java/com/margelo/nitro/rive/HybridViewModelBooleanProperty.kt

@@ -24,6 +24,10 @@ class HybridViewModelBooleanProperty(private val viewModelBoolean: ViewModelBool
     viewModelBoolean.value = value
   }
 
+  override fun setValueAsync(value: Boolean): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun addListener(onChanged: (value: Boolean) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelBoolean.valueFlow)

android/src/legacy/java/com/margelo/nitro/rive/HybridViewModelColorProperty.kt

@@ -24,6 +24,10 @@ class HybridViewModelColorProperty(private val viewModelColor: ViewModelColorPro
     viewModelColor.value = value.toLong().toInt()
   }
 
+  override fun setValueAsync(value: Double): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun addListener(onChanged: (value: Double) -> Unit): () -> Unit {
     val remover = addListenerInternal { intValue: Int -> onChanged(intValue.toDouble()) }
     ensureValueListenerJob(viewModelColor.valueFlow)

android/src/legacy/java/com/margelo/nitro/rive/HybridViewModelEnumProperty.kt

@@ -24,6 +24,10 @@ class HybridViewModelEnumProperty(private val viewModelEnum: ViewModelEnumProper
     viewModelEnum.value = value
   }
 
+  override fun setValueAsync(value: String): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun addListener(onChanged: (value: String) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelEnum.valueFlow)

android/src/legacy/java/com/margelo/nitro/rive/HybridViewModelNumberProperty.kt

@@ -25,6 +25,10 @@ class HybridViewModelNumberProperty(private val viewModelNumber: ViewModelNumber
     viewModelNumber.value = value.toFloat()
   }
 
+  override fun setValueAsync(value: Double): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun addListener(onChanged: (value: Double) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelNumber.valueFlow.map { it.toDouble() })

android/src/legacy/java/com/margelo/nitro/rive/HybridViewModelStringProperty.kt

@@ -24,6 +24,10 @@ class HybridViewModelStringProperty(private val viewModelString: ViewModelString
     viewModelString.value = value
   }
 
+  override fun setValueAsync(value: String): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun addListener(onChanged: (value: String) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelString.valueFlow)

android/src/new/java/com/margelo/nitro/rive/HybridViewModel.kt

@@ -15,7 +15,7 @@ import kotlinx.coroutines.runBlocking
 class HybridViewModel(
   private val riveFile: RiveFile,
   private val riveWorker: CommandQueue,
-  private val viewModelName: String?,
+  private val viewModelName: String,
   private val parentFile: HybridRiveFile,
   private val vmSource: ViewModelSource
 ) : HybridViewModelSpec() {
@@ -24,10 +24,9 @@ class HybridViewModel(
   }
 
   override fun getPropertiesAsync(): Promise<Array<ViewModelPropertyInfo>> {
-    val name = viewModelName ?: return Promise.resolved(emptyArray())
     return Promise.async {
       riveFile
-        .getViewModelProperties(name)
+        .getViewModelProperties(viewModelName)
         .map { prop ->
         ViewModelPropertyInfo(name = prop.name, type = mapPropertyType(prop.type))
       }.toTypedArray()
@@ -37,9 +36,8 @@ class HybridViewModel(
   override val propertyCount: Double
     get() {
       DeprecationWarning.warn("propertyCount", "getPropertyCountAsync")
-      val name = viewModelName ?: throw UnsupportedOperationException("ViewModel name is unavailable")
       return try {
-        runBlocking { riveFile.getViewModelProperties(name) }.size.toDouble()
+        runBlocking { riveFile.getViewModelProperties(viewModelName) }.size.toDouble()
       } catch (e: Exception) {
         RiveLog.e(TAG, "propertyCount failed: ${e.message}")
         0.0
@@ -49,71 +47,60 @@ class HybridViewModel(
   override val instanceCount: Double
     get() {
       DeprecationWarning.warn("instanceCount", "getInstanceCountAsync")
-      val name = viewModelName ?: throw UnsupportedOperationException("ViewModel name is unavailable")
       return try {
-        runBlocking { riveFile.getViewModelInstanceNames(name) }.size.toDouble()
+        runBlocking { riveFile.getViewModelInstanceNames(viewModelName) }.size.toDouble()
       } catch (e: Exception) {
         RiveLog.e(TAG, "instanceCount failed: ${e.message}")
         0.0
       }
     }
 
   override val modelName: String
-    get() = viewModelName ?: throw UnsupportedOperationException("ViewModel name is unavailable")
+    get() = viewModelName
 
   override fun getPropertyCountAsync(): Promise<Double> {
-    val name = viewModelName ?: return Promise.rejected(UnsupportedOperationException("ViewModel name is unavailable"))
-    return Promise.async { riveFile.getViewModelProperties(name).size.toDouble() }
+    return Promise.async { riveFile.getViewModelProperties(viewModelName).size.toDouble() }
   }
 
   override fun getInstanceCountAsync(): Promise<Double> {
-    val name = viewModelName ?: return Promise.rejected(UnsupportedOperationException("ViewModel name is unavailable"))
-    return Promise.async { riveFile.getViewModelInstanceNames(name).size.toDouble() }
+    return Promise.async { riveFile.getViewModelInstanceNames(viewModelName).size.toDouble() }
   }
 
   // Deprecated: Use createInstanceByNameAsync instead
   override fun createInstanceByIndex(index: Double): HybridViewModelInstanceSpec? {
     DeprecationWarning.warn("createInstanceByIndex", "createInstanceByNameAsync")
-    val name = viewModelName ?: throw UnsupportedOperationException("ViewModel name is unavailable")
     return try {
       val idx = index.toInt()
-      val instanceNames = runBlocking { riveFile.getViewModelInstanceNames(name) }
+      val instanceNames = runBlocking { riveFile.getViewModelInstanceNames(viewModelName) }
       if (idx < 0 || idx >= instanceNames.size) return null
       val instanceName = instanceNames[idx]
       runBlocking { createInstanceByNameImpl(instanceName) }
-    } catch (e: UnsupportedOperationException) {
-      throw e
     } catch (e: Exception) {
       RiveLog.e(TAG, "createInstanceByIndex($index) failed: ${e.message}")
       null
     }
   }
 
   private suspend fun createInstanceByNameImpl(instanceName: String): HybridViewModelInstanceSpec? {
-    val name = viewModelName ?: throw UnsupportedOperationException("ViewModel name is unavailable")
-    val instanceNames = riveFile.getViewModelInstanceNames(name)
+    val instanceNames = riveFile.getViewModelInstanceNames(viewModelName)
     if (!instanceNames.contains(instanceName)) return null
     val source = vmSource.namedInstance(instanceName)
     val vmi = ViewModelInstance.fromFile(riveFile, source)
-    return HybridViewModelInstance(vmi, riveWorker, parentFile, name, instanceName)
+    return HybridViewModelInstance(vmi, riveWorker, parentFile, viewModelName, instanceName)
   }
 
   // Deprecated: Use createInstanceByNameAsync instead
   override fun createInstanceByName(name: String): HybridViewModelInstanceSpec? {
     DeprecationWarning.warn("createInstanceByName", "createInstanceByNameAsync")
-    if (viewModelName == null) throw UnsupportedOperationException("ViewModel name is unavailable")
     return try {
       runBlocking { createInstanceByNameImpl(name) }
-    } catch (e: UnsupportedOperationException) {
-      throw e
     } catch (e: Exception) {
       RiveLog.e(TAG, "createInstanceByName('$name') failed: ${e.message}")
       null
     }
   }
 
   override fun createInstanceByNameAsync(name: String): Promise<HybridViewModelInstanceSpec?> {
-    if (viewModelName == null) return Promise.rejected(UnsupportedOperationException("ViewModel name is unavailable"))
     return Promise.async { createInstanceByNameImpl(name) }
   }
 

android/src/new/java/com/margelo/nitro/rive/HybridViewModelBooleanProperty.kt

@@ -37,6 +37,10 @@ class HybridViewModelBooleanProperty(
     instance.setBoolean(path, value)
   }
 
+  override fun setValueAsync(value: Boolean): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun getValueAsync(): Promise<Boolean> {
     return Promise.async { instance.getBooleanFlow(path).first() }
   }

android/src/new/java/com/margelo/nitro/rive/HybridViewModelColorProperty.kt

@@ -37,6 +37,10 @@ class HybridViewModelColorProperty(
     instance.setColor(path, value.toLong().toInt())
   }
 
+  override fun setValueAsync(value: Double): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun getValueAsync(): Promise<Double> {
     return Promise.async { instance.getColorFlow(path).first().toDouble() }
   }

android/src/new/java/com/margelo/nitro/rive/HybridViewModelEnumProperty.kt

@@ -37,6 +37,10 @@ class HybridViewModelEnumProperty(
     instance.setEnum(path, value)
   }
 
+  override fun setValueAsync(value: String): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun getValueAsync(): Promise<String> {
     return Promise.async { instance.getEnumFlow(path).first() }
   }

android/src/new/java/com/margelo/nitro/rive/HybridViewModelNumberProperty.kt

@@ -37,6 +37,10 @@ class HybridViewModelNumberProperty(
     instance.setNumber(path, value.toFloat())
   }
 
+  override fun setValueAsync(value: Double): Promise<Unit> {
+    return Promise.async { set(value) }
+  }
+
   override fun getValueAsync(): Promise<Double> {
     return Promise.async { instance.getNumberFlow(path).first().toDouble() }
   }