feat: add async API compat layer for experimental migration (#183)

Adds async equivalents for all sync methods and marks the sync versions
as `@deprecated`. This lets users migrate to the new async API while
still on the legacy backend, before switching to experimental.

No behavior changes — all new async methods are thin `Promise.async {}`
wrappers around existing sync calls.

Author: mfazekas

android/src/main/java/com/margelo/nitro/rive/HybridRiveFile.kt

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.File
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 import java.lang.ref.WeakReference
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
@@ -85,6 +86,38 @@ class HybridRiveFile : HybridRiveFileSpec() {
     }
   }
 
+  override fun getViewModelNamesAsync(): Promise<Array<String>> {
+    return Promise.async {
+      val file = riveFile ?: return@async emptyArray()
+      val count = file.viewModelCount
+      val names = mutableListOf<String>()
+      for (i in 0 until count) {
+        try {
+          val vm = file.getViewModelByIndex(i)
+          names.add(vm.name)
+        } catch (_: Exception) {
+        }
+      }
+      names.toTypedArray()
+    }
+  }
+
+  override fun viewModelByNameAsync(name: String, validate: Boolean?): Promise<HybridViewModelSpec?> {
+    return Promise.async { viewModelByName(name) }
+  }
+
+  override fun defaultArtboardViewModelAsync(artboardBy: ArtboardBy?): Promise<HybridViewModelSpec?> {
+    return Promise.async { defaultArtboardViewModel(artboardBy) }
+  }
+
+  override fun getArtboardCountAsync(): Promise<Double> {
+    return Promise.async { artboardCount }
+  }
+
+  override fun getArtboardNamesAsync(): Promise<Array<String>> {
+    return Promise.async { artboardNames }
+  }
+
   override fun updateReferencedAssets(referencedAssets: ReferencedAssetsType) {
     val assetsData = referencedAssets.data ?: return
     val cache = referencedAssetCache ?: return

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

@@ -4,6 +4,7 @@ import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModel
 import app.rive.runtime.kotlin.core.errors.ViewModelException
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 
 @Keep
 @DoNotStrip
@@ -51,4 +52,16 @@ class HybridViewModel(private val viewModel: ViewModel) : HybridViewModelSpec()
       return null
     }
   }
+
+  override fun createInstanceByNameAsync(name: String): Promise<HybridViewModelInstanceSpec?> {
+    return Promise.async { createInstanceByName(name) }
+  }
+
+  override fun createDefaultInstanceAsync(): Promise<HybridViewModelInstanceSpec?> {
+    return Promise.async { createDefaultInstance() }
+  }
+
+  override fun createBlankInstanceAsync(): Promise<HybridViewModelInstanceSpec?> {
+    return Promise.async { createInstance() }
+  }
 }

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

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelBooleanProperty
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 
 @Keep
 @DoNotStrip
@@ -15,6 +16,14 @@ class HybridViewModelBooleanProperty(private val viewModelBoolean: ViewModelBool
       viewModelBoolean.value = value
     }
 
+  override fun getValueAsync(): Promise<Boolean> {
+    return Promise.async { value }
+  }
+
+  override fun set(value: Boolean) {
+    viewModelBoolean.value = value
+  }
+
   override fun addListener(onChanged: (value: Boolean) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelBoolean.valueFlow)

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

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelColorProperty
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 
 @Keep
 @DoNotStrip
@@ -15,6 +16,14 @@ class HybridViewModelColorProperty(private val viewModelColor: ViewModelColorPro
       viewModelColor.value = value.toLong().toInt()
     }
 
+  override fun getValueAsync(): Promise<Double> {
+    return Promise.async { value }
+  }
+
+  override fun set(value: Double) {
+    viewModelColor.value = value.toLong().toInt()
+  }
+
   override fun addListener(onChanged: (value: Double) -> Unit): () -> Unit {
     val remover = addListenerInternal { intValue: Int -> onChanged(intValue.toDouble()) }
     ensureValueListenerJob(viewModelColor.valueFlow)

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

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelEnumProperty
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 
 @Keep
 @DoNotStrip
@@ -15,6 +16,14 @@ class HybridViewModelEnumProperty(private val viewModelEnum: ViewModelEnumProper
       viewModelEnum.value = value
     }
 
+  override fun getValueAsync(): Promise<String> {
+    return Promise.async { value }
+  }
+
+  override fun set(value: String) {
+    viewModelEnum.value = value
+  }
+
   override fun addListener(onChanged: (value: String) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelEnum.valueFlow)

android/src/main/java/com/margelo/nitro/rive/HybridViewModelInstance.kt

@@ -4,6 +4,7 @@ import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelInstance
 import app.rive.runtime.kotlin.core.errors.ViewModelException
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 
 @Keep
 @DoNotStrip
@@ -65,4 +66,8 @@ class HybridViewModelInstance(val viewModelInstance: ViewModelInstance) : Hybrid
     val nativeInstance = (instance as HybridViewModelInstance).viewModelInstance
     viewModelInstance.setInstanceProperty(path, nativeInstance)
   }
+
+  override fun viewModelAsync(path: String): Promise<HybridViewModelInstanceSpec?> {
+    return Promise.async { viewModel(path) }
+  }
 }

android/src/main/java/com/margelo/nitro/rive/HybridViewModelListProperty.kt

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelListProperty
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 import kotlinx.coroutines.flow.map
 
 @Keep
@@ -56,6 +57,14 @@ class HybridViewModelListProperty(private val listProperty: ViewModelListPropert
     return true
   }
 
+  override fun getLengthAsync(): Promise<Double> {
+    return Promise.async { length }
+  }
+
+  override fun getInstanceAtAsync(index: Double): Promise<HybridViewModelInstanceSpec?> {
+    return Promise.async { getInstanceAt(index) }
+  }
+
   override fun addListener(onChanged: () -> Unit): () -> Unit {
     val remover = addListenerInternal { _ -> onChanged() }
     ensureValueListenerJob(listProperty.valueFlow.map { })

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

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelNumberProperty
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 import kotlinx.coroutines.flow.map
 
 @Keep
@@ -16,6 +17,14 @@ class HybridViewModelNumberProperty(private val viewModelNumber: ViewModelNumber
       viewModelNumber.value = value.toFloat()
     }
 
+  override fun getValueAsync(): Promise<Double> {
+    return Promise.async { value }
+  }
+
+  override fun set(value: Double) {
+    viewModelNumber.value = value.toFloat()
+  }
+
   override fun addListener(onChanged: (value: Double) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelNumber.valueFlow.map { it.toDouble() })

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

@@ -3,6 +3,7 @@ package com.margelo.nitro.rive
 import androidx.annotation.Keep
 import app.rive.runtime.kotlin.core.ViewModelStringProperty
 import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
 
 @Keep
 @DoNotStrip
@@ -15,6 +16,14 @@ class HybridViewModelStringProperty(private val viewModelString: ViewModelString
       viewModelString.value = value
     }
 
+  override fun getValueAsync(): Promise<String> {
+    return Promise.async { value }
+  }
+
+  override fun set(value: String) {
+    viewModelString.value = value
+  }
+
   override fun addListener(onChanged: (value: String) -> Unit): () -> Unit {
     val remover = addListenerInternal(onChanged)
     ensureValueListenerJob(viewModelString.valueFlow)

ios/HybridRiveFile.swift

@@ -1,3 +1,4 @@
+import NitroModules
 import RiveRuntime
 
 typealias ReferencedAssetCache = [String: RiveFileAsset]
@@ -88,6 +89,36 @@ class HybridRiveFile: HybridRiveFileSpec, RiveViewSource {
     return HybridBindableArtboard(bindableArtboard: bindable)
   }
 
+  func getViewModelNamesAsync() throws -> Promise<[String]> {
+    return Promise.async {
+      guard let file = self.riveFile else { return [] }
+      let count = file.viewModelCount
+      var names: [String] = []
+      for i in 0..<count {
+        if let vm = file.viewModel(at: UInt(i)) {
+          names.append(vm.name)
+        }
+      }
+      return names
+    }
+  }
+
+  func viewModelByNameAsync(name: String, validate: Bool?) throws -> Promise<(any HybridViewModelSpec)?> {
+    return Promise.async { try self.viewModelByName(name: name) }
+  }
+
+  func defaultArtboardViewModelAsync(artboardBy: ArtboardBy?) throws -> Promise<(any HybridViewModelSpec)?> {
+    return Promise.async { try self.defaultArtboardViewModel(artboardBy: artboardBy) }
+  }
+
+  func getArtboardCountAsync() throws -> Promise<Double> {
+    return Promise.async { self.artboardCount }
+  }
+
+  func getArtboardNamesAsync() throws -> Promise<[String]> {
+    return Promise.async { self.artboardNames }
+  }
+
   func updateReferencedAssets(referencedAssets: ReferencedAssetsType) {
     guard let assetsData = referencedAssets.data,
           let cache = referencedAssetCache,