feat: experimental iOS API support (getEnums via SPM)

RNRive.podspec

@@ -24,11 +24,17 @@ if !rive_ios_version && package['runtimeVersions'] && package['runtimeVersions']
   rive_ios_version = package['runtimeVersions']['ios']
 end
 
-if !rive_ios_version
+use_rive_spm = ENV['USE_RIVE_SPM'] == '1' || (defined?($UseRiveSPM) && $UseRiveSPM)
+
+if !use_rive_spm && !rive_ios_version
   raise "Internal Error: Failed to determine Rive iOS SDK version. Please ensure package.json contains 'runtimeVersions.ios'"
 end
 
-Pod::UI.puts "@rive-app/react-native: Rive iOS SDK #{rive_ios_version}"
+if use_rive_spm
+  Pod::UI.puts "@rive-app/react-native: Using RiveRuntime via Swift Package Manager"
+else
+  Pod::UI.puts "@rive-app/react-native: Rive iOS SDK #{rive_ios_version}"
+end
 
 Pod::Spec.new do |s|
   s.name         = "RNRive"
@@ -47,7 +53,19 @@ Pod::Spec.new do |s|
   load 'nitrogen/generated/ios/RNRive+autolinking.rb'
   add_nitrogen_files(s)
 
-  s.dependency "RiveRuntime", rive_ios_version
+  if use_rive_spm
+    spm_dependency(s,
+      url: 'https://github.com/rive-app/rive-ios.git',
+      requirement: {kind: 'upToNextMajorVersion', minimumVersion: '6.15.0'},
+      products: ['RiveRuntime']
+    )
+  else
+    s.dependency "RiveRuntime", rive_ios_version
+  end
 
  install_modules_dependencies(s)
+
+  if use_rive_spm
+    s.xcconfig = { 'OTHER_SWIFT_FLAGS' => '$(inherited) -DRIVE_EXPERIMENTAL_API' }
+  end
 end

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
@@ -96,6 +97,22 @@ class HybridRiveFile : HybridRiveFileSpec() {
     }
   }
 
+  override fun getEnums(): Promise<Array<RiveEnumDefinition>> {
+    return Promise.async {
+      val file = riveFile ?: return@async emptyArray()
+      try {
+        file.enums.map { enum ->
+          RiveEnumDefinition(
+            name = enum.name,
+            values = enum.values.toTypedArray()
+          )
+        }.toTypedArray()
+      } catch (e: NoSuchMethodError) {
+        throw UnsupportedOperationException("getEnums requires rive-android SDK with enums support")
+      }
+    }
+  }
+
   override fun dispose() {
     scope.cancel()
     weakViews.clear()

example/__tests__/viewmodel-properties.harness.ts

@@ -1,5 +1,8 @@
 import { describe, it, expect } from 'react-native-harness';
-import type { ViewModelInstance } from '@rive-app/react-native';
+import type {
+  ViewModelInstance,
+  RiveEnumDefinition,
+} from '@rive-app/react-native';
 import { RiveFileFactory } from '@rive-app/react-native';
 
 const DATABINDING = require('../assets/rive/databinding.riv');
@@ -225,3 +228,18 @@ describe('Property Listeners', () => {
     expect(() => cleanup2()).not.toThrow();
   });
 });
+
+describe('RiveFile Enums', () => {
+  const expectedEnums: RiveEnumDefinition[] = [
+    { name: 'Pets', values: ['chipmunk', 'rat', 'frog', 'owl', 'cat', 'dog'] },
+  ];
+
+  it('getEnums returns enum definitions from file', async () => {
+    const file = await RiveFileFactory.fromSource(DATABINDING, undefined);
+    const enums = await file.getEnums();
+
+    expect(enums.length).toBe(expectedEnums.length);
+    expect(enums[0]?.name).toBe(expectedEnums[0]?.name);
+    expect(enums[0]?.values).toEqual(expectedEnums[0]?.values);
+  });
+});

example/ios/Podfile

@@ -1,5 +1,7 @@
 ENV['RCT_NEW_ARCH_ENABLED'] = '1'
 
+$UseRiveSPM = ENV['USE_RIVE_SPM'] == '1'
+
 # Resolve react_native_pods.rb with node to allow for hoisting
 require Pod::Executable.execute_command('node', ['-p',
   'require.resolve(

ios/HybridRiveFile.swift

@@ -1,14 +1,27 @@
+import NitroModules
 import RiveRuntime
+#if RIVE_EXPERIMENTAL_API
+@_spi(RiveExperimental) import RiveRuntime
+#endif
 
 typealias ReferencedAssetCache = [String: RiveFileAsset]
 
+/// Source for creating experimental File instances
+enum ExperimentalFileSource {
+  case data(Data)
+  case resource(String)
+}
+
 class HybridRiveFile: HybridRiveFileSpec, RiveViewSource {
   var riveFile: RiveFile?
   var referencedAssetCache: ReferencedAssetCache?
   var assetLoader: ReferencedAssetLoader?
   var cachedFactory: RiveFactory?
   private var weakViews: [Weak<RiveReactNativeView>] = []
 
+  /// Source for experimental API - stored to create experimental File on demand
+  var experimentalSource: ExperimentalFileSource?
+
   public func setRiveFile(_ riveFile: RiveFile) {
     self.riveFile = riveFile
   }
@@ -118,6 +131,42 @@ class HybridRiveFile: HybridRiveFileSpec, RiveViewSource {
     }
   }
 
+  func getEnums() throws -> Promise<[RiveEnumDefinition]> {
+    return Promise.async { [weak self] in
+      #if RIVE_EXPERIMENTAL_API
+      guard let source = self?.experimentalSource else {
+        throw NSError(
+          domain: "RiveError",
+          code: 1,
+          userInfo: [NSLocalizedDescriptionKey: "getEnums requires experimental API. Use USE_RIVE_SPM=1 with pod install."]
+        )
+      }
+
+      // Create worker and experimental file on demand
+      let worker = await Worker()
+      let experimentalSource: Source
+      switch source {
+      case .data(let data):
+        experimentalSource = .data(data)
+      case .resource(let name):
+        experimentalSource = .local(name, nil)
+      }
+
+      let file = try await File(source: experimentalSource, worker: worker)
+      let viewModelEnums = try await file.getViewModelEnums()
+      return viewModelEnums.map { vmEnum in
+        RiveEnumDefinition(name: vmEnum.name, values: vmEnum.values)
+      }
+      #else
+      throw NSError(
+        domain: "RiveError",
+        code: 1,
+        userInfo: [NSLocalizedDescriptionKey: "getEnums requires RiveRuntime 6.15.0+ with experimental API. Use USE_RIVE_SPM=1 with pod install."]
+      )
+      #endif
+    }
+  }
+
   func dispose() {
     weakViews.removeAll()
     referencedAssetCache = nil

ios/HybridRiveFileFactory.swift

@@ -16,19 +16,22 @@
   ///   - fileWithCustomAssetLoader: Closure to load the file with a custom asset loader.
   ///   - file: Closure to load the file without a custom asset loader.
   ///   - referencedAssets: Optional referenced assets.
+  ///   - experimentalSource: Closure to extract the experimental source from the prepared result.
   /// - Returns: A promise resolving to a `HybridRiveFileSpec`.
   /// - Throws: Runtime errors if any step fails.
   func genericFrom<CheckResult, Prepared>(
     check: @escaping () throws -> CheckResult,
     prepare: @escaping (CheckResult) async throws -> Prepared,
     fileWithCustomAssetLoader: @escaping (Prepared, @escaping LoadAsset) throws -> RiveFile,
     file: @escaping (Prepared) throws -> RiveFile,
-    referencedAssets: ReferencedAssetsType?
+    referencedAssets: ReferencedAssetsType?,
+    experimentalSource: @escaping (Prepared) -> ExperimentalFileSource?
   ) throws -> Promise<(any HybridRiveFileSpec)> {
     return Promise.async {
       do {
         let checked = try check()
         let prepared = try await prepare(checked)
+        let expSource = experimentalSource(prepared)
 
         let result = try await withCheckedThrowingContinuation { continuation in
           DispatchQueue.global(qos: .userInitiated).async {
@@ -73,6 +76,7 @@
           hybridRiveFile.cachedFactory = factory
         }
         hybridRiveFile.assetLoader = result.loader
+        hybridRiveFile.experimentalSource = expSource
         return hybridRiveFile
       } catch let error as NSError {
         throw RuntimeError.error(
@@ -98,7 +102,8 @@
         try RiveFile(data: data, loadCdn: loadCdn, customAssetLoader: loader)
       },
       file: { (data) in try RiveFile(data: data, loadCdn: loadCdn) },
-      referencedAssets: referencedAssets
+      referencedAssets: referencedAssets,
+      experimentalSource: { data in .data(data) }
     )
   }
 
@@ -119,7 +124,8 @@
         try RiveFile(data: data, loadCdn: loadCdn, customAssetLoader: loader)
       },
       file: { (data) in try RiveFile(data: data, loadCdn: loadCdn) },
-      referencedAssets: referencedAssets
+      referencedAssets: referencedAssets,
+      experimentalSource: { data in .data(data) }
     )
   }
 
@@ -137,7 +143,8 @@
         try RiveFile(resource: resource, loadCdn: loadCdn, customAssetLoader: loader)
       },
       file: { (resource) in try RiveFile(resource: resource, loadCdn: loadCdn) },
-      referencedAssets: referencedAssets
+      referencedAssets: referencedAssets,
+      experimentalSource: { resource in .resource(resource) }
     )
   }
 
@@ -157,7 +164,8 @@
         try RiveFile(data: data, loadCdn: loadCdn, customAssetLoader: loader)
       },
       file: { (data) in try RiveFile(data: data, loadCdn: loadCdn) },
-      referencedAssets: referencedAssets
+      referencedAssets: referencedAssets,
+      experimentalSource: { data in .data(data) }
     )
   }
 }