feat: rename public TS API to RiveLog, hook into iOS SDK's pluggable logger

Renames the exported namespace from RiveLogger to RiveLog to match the
native SDK naming convention. Implements RiveRuntime.RiveLog.Logger on iOS
to unify C++ runtime logs through our bridge logging system (parity with
Android's RiveErrorLogger).

Author: mfazekas

ios/new/HybridRiveFileFactory.swift

@@ -6,7 +6,12 @@ final class HybridRiveFileFactory: HybridRiveFileFactorySpec, @unchecked Sendabl
 
   // All files must share the same Worker so artboard handles are valid across files
   // (each Worker has its own C++ command server with its own m_artboards map)
-  private static let sharedWorkerTask = Task { @MainActor in try await Worker() }
+  private static let sharedWorkerTask = Task { @MainActor in
+    if !(RiveRuntime.RiveLog.logger is RiveRuntimeLogger) {
+      RiveRuntime.RiveLog.logger = RiveRuntimeLogger()
+    }
+    return try await Worker()
+  }
 
   func fromURL(url: String, loadCdn: Bool, referencedAssets: ReferencedAssetsType?) throws
     -> Promise<(any HybridRiveFileSpec)>

ios/new/RiveRuntimeLogger.swift

@@ -0,0 +1,39 @@
+@_spi(RiveExperimental) import RiveRuntime
+
+/// Implements the Rive iOS SDK's `RiveLog.Logger` protocol and forwards all
+/// C++ runtime logs through our bridge-level `RiveLog` utility, giving JS
+/// visibility into file, artboard, state machine, and view model diagnostics.
+final class RiveRuntimeLogger: RiveRuntime.RiveLog.Logger, @unchecked Sendable {
+    func notice(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.i(tag.category, message())
+    }
+
+    func debug(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.d(tag.category, message())
+    }
+
+    func trace(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.d(tag.category, message())
+    }
+
+    func info(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.i(tag.category, message())
+    }
+
+    func error(tag: RiveRuntime.RiveLog.Tag, error: (any Error)?, _ message: @escaping () -> String) {
+        let suffix = error.map { " (\($0.localizedDescription))" } ?? ""
+        RiveLog.e(tag.category, "\(message())\(suffix)")
+    }
+
+    func warning(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.w(tag.category, message())
+    }
+
+    func fault(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.e(tag.category, message())
+    }
+
+    func critical(tag: RiveRuntime.RiveLog.Tag, _ message: @escaping () -> String) {
+        RiveLog.e(tag.category, message())
+    }
+}

src/core/RiveLogger.ts

@@ -16,7 +16,7 @@ function defaultHandler(level: string, tag: string, message: string) {
 
 _logger.setHandler(defaultHandler);
 
-export namespace RiveLogger {
+export namespace RiveLog {
   export function setHandler(
     handler: (level: string, tag: string, message: string) => void
   ) {

src/index.tsx

@@ -66,5 +66,5 @@ export { useRiveFile, type UseRiveFileResult } from './hooks/useRiveFile';
 export { type RiveFileInput } from './hooks/useRiveFile';
 export { type SetValueAction } from './types';
 export { RiveRuntime } from './core/RiveRuntime';
-export { RiveLogger } from './core/RiveLogger';
+export { RiveLog } from './core/RiveLogger';
 export { DataBindMode };