fix(ios): warn on unsupported updateReferencedAssets, add asset types to OOB example

Experimental backend logs a warning when updateReferencedAssets is called
since the concurrency API cannot update already-bound artboard assets.
Add explicit type fields to OutOfBandAssets example to suppress inference
warnings. Bundle kanit_regular.ttf font in expo examples via expo-font.

Author: mfazekas

example/src/exercisers/OutOfBandAssets.tsx

@@ -22,26 +22,17 @@ export default function OutOfBandAssetsExample() {
       referencedAssets: {
         'Inter-594377': {
           source: require('../../assets/fonts/Inter-594377.ttf'),
-          // source: {
-          //   fileName: 'Inter-594377.ttf',
-          //   path: 'fonts', // only needed for Android assets
-          // },
+          type: 'font',
         },
         'referenced-image-2929282': {
           source: {
             uri: uri,
           },
-          // source: {
-          //   fileName: 'referenced-image-2929282.png',
-          //   path: 'images', // only needed for Android assets
-          // },
+          type: 'image',
         },
         'referenced_audio-2929340': {
           source: require('../../assets/audio/referenced_audio-2929340.wav'),
-          // source: {
-          //   fileName: 'referenced_audio-2929340.wav',
-          //   path: 'audio', // only needed for Android assets
-          // },
+          type: 'audio',
         },
       },
     }

expo-example/app.config.js

@@ -47,6 +47,12 @@ module.exports = {
           assets: ['../example/assets/rive/rewards.riv'],
         },
       ],
+      [
+        'expo-font',
+        {
+          fonts: ['./assets/kanit_regular.ttf'],
+        },
+      ],
     ],
     experiments: {
       typedRoutes: true,

expo55-example/app.config.js

@@ -47,6 +47,12 @@ module.exports = {
           assets: ['../example/assets/rive/rewards.riv'],
         },
       ],
+      [
+        'expo-font',
+        {
+          fonts: ['./assets/kanit_regular.ttf'],
+        },
+      ],
     ],
     experiments: {
       typedRoutes: true,

ios/new/ExperimentalAssetLoader.swift

@@ -1,4 +1,4 @@
-@_spi(RiveExperimental) import RiveRuntime
+import RiveRuntime
 import NitroModules
 
 enum AssetType {
@@ -37,25 +37,33 @@ final class ExperimentalAssetLoader {
     _ referencedAssets: ReferencedAssetsType?,
     on worker: Worker
   ) async {
-    guard let assets = referencedAssets?.data else { return }
+    guard let assets = referencedAssets?.data else {
+      RCTLog("[ExperimentalAssetLoader] registerAssets: no assets (data is nil)")
+      return
+    }
+    RCTLog("[ExperimentalAssetLoader] registerAssets: \(assets.count) assets to register: \(Array(assets.keys))")
 
-    await withTaskGroup(of: Void.self) { group in
-      for (name, asset) in assets {
-        group.addTask { @MainActor in
-          await self.loadAndRegisterAsset(name: name, asset: asset, worker: worker)
-        }
-      }
+    // Register sequentially to ensure all command queue operations
+    // (decode → register) complete in order before File load.
+    for (name, asset) in assets {
+      await self.loadAndRegisterAsset(name: name, asset: asset, worker: worker)
     }
+    RCTLog("[ExperimentalAssetLoader] registerAssets: done")
   }
 
   private static func loadAndRegisterAsset(
     name: String,
     asset: ResolvedReferencedAsset,
     worker: Worker
   ) async {
+    RCTLog("[ExperimentalAssetLoader] loadAndRegister '\(name)': sourceUrl=\(asset.sourceUrl ?? "nil"), sourceAsset=\(asset.sourceAsset ?? "nil"), sourceAssetId=\(asset.sourceAssetId ?? "nil"), type=\(String(describing: asset.type))")
     do {
       let data = try await loadAssetData(asset)
-      guard !data.isEmpty else { return }
+      RCTLog("[ExperimentalAssetLoader] loadAndRegister '\(name)': loaded \(data.count) bytes")
+      guard !data.isEmpty else {
+        RCTLog("[ExperimentalAssetLoader] loadAndRegister '\(name)': empty data, skipping")
+        return
+      }
 
       // Prefer an explicit type provided by the caller.
       let resolvedType: AssetType?
@@ -81,8 +89,10 @@ final class ExperimentalAssetLoader {
 
   private static func loadAssetData(_ asset: ResolvedReferencedAsset) async throws -> Data {
     guard let dataSource = try DataSourceResolver.resolve(from: asset) else {
+      RCTLog("[ExperimentalAssetLoader] loadAssetData: DataSourceResolver returned nil")
       return Data()
     }
+    RCTLog("[ExperimentalAssetLoader] loadAssetData: resolved to \(type(of: dataSource))")
     return try await dataSource.createLoader().load(from: dataSource)
   }
 

ios/new/HybridRiveFile.swift

@@ -1,4 +1,4 @@
-@_spi(RiveExperimental) import RiveRuntime
+import RiveRuntime
 import NitroModules
 
 class HybridRiveFile: HybridRiveFileSpec {
@@ -149,14 +149,7 @@ class HybridRiveFile: HybridRiveFileSpec {
   }
 
   func updateReferencedAssets(referencedAssets: ReferencedAssetsType) {
-    guard let worker = worker else {
-      RCTLogWarn("HybridRiveFile.updateReferencedAssets: No worker available")
-      return
-    }
-    RCTLogInfo("HybridRiveFile.updateReferencedAssets: Updating \(referencedAssets.data?.count ?? 0) assets (note: existing artboards won't refresh)")
-    Task { @MainActor in
-      await ExperimentalAssetLoader.registerAssets(referencedAssets, on: worker)
-    }
+    RCTLogWarn("[Rive] updateReferencedAssets is not supported with the experimental backend — already-rendered artboards cannot be updated. Use the legacy backend for runtime asset swapping.")
   }
 
   func getEnums() throws -> Promise<[RiveEnumDefinition]> {