@rive-app/react-native 0.2.3 → 0.2.4

package/nitrogen/generated/ios/RNRive-Swift-Cxx-Bridge.hpp

@@ -30,6 +30,8 @@ namespace margelo::nitro::rive { class HybridRiveFileSpec; }
 namespace margelo::nitro::rive { class HybridRiveImageFactorySpec; }
 // Forward declaration of `HybridRiveImageSpec` to properly resolve imports.
 namespace margelo::nitro::rive { class HybridRiveImageSpec; }
+// Forward declaration of `HybridRiveRuntimeSpec` to properly resolve imports.
+namespace margelo::nitro::rive { class HybridRiveRuntimeSpec; }
 // Forward declaration of `HybridRiveSpec` to properly resolve imports.
 namespace margelo::nitro::rive { class HybridRiveSpec; }
 // Forward declaration of `HybridRiveViewSpec` to properly resolve imports.
@@ -82,6 +84,8 @@ namespace RNRive { class HybridRiveFileSpec_cxx; }
 namespace RNRive { class HybridRiveImageFactorySpec_cxx; }
 // Forward declaration of `HybridRiveImageSpec_cxx` to properly resolve imports.
 namespace RNRive { class HybridRiveImageSpec_cxx; }
+// Forward declaration of `HybridRiveRuntimeSpec_cxx` to properly resolve imports.
+namespace RNRive { class HybridRiveRuntimeSpec_cxx; }
 // Forward declaration of `HybridRiveSpec_cxx` to properly resolve imports.
 namespace RNRive { class HybridRiveSpec_cxx; }
 // Forward declaration of `HybridRiveViewSpec_cxx` to properly resolve imports.
@@ -123,6 +127,7 @@ namespace RNRive { class HybridViewModelTriggerPropertySpec_cxx; }
 #include "HybridRiveFileSpec.hpp"
 #include "HybridRiveImageFactorySpec.hpp"
 #include "HybridRiveImageSpec.hpp"
+#include "HybridRiveRuntimeSpec.hpp"
 #include "HybridRiveSpec.hpp"
 #include "HybridRiveViewSpec.hpp"
 #include "HybridViewModelArtboardPropertySpec.hpp"
@@ -530,6 +535,61 @@ namespace margelo::nitro::rive::bridge::swift {
     return Result<std::shared_ptr<Promise<std::shared_ptr<HybridRiveImageSpec>>>>::withError(error);
   }
   
+  // pragma MARK: std::shared_ptr<Promise<void>>
+  /**
+   * Specialized version of `std::shared_ptr<Promise<void>>`.
+   */
+  using std__shared_ptr_Promise_void__ = std::shared_ptr<Promise<void>>;
+  inline std::shared_ptr<Promise<void>> create_std__shared_ptr_Promise_void__() noexcept {
+    return Promise<void>::create();
+  }
+  inline PromiseHolder<void> wrap_std__shared_ptr_Promise_void__(std::shared_ptr<Promise<void>> promise) noexcept {
+    return PromiseHolder<void>(std::move(promise));
+  }
+  
+  // pragma MARK: std::function<void()>
+  /**
+   * Specialized version of `std::function<void()>`.
+   */
+  using Func_void = std::function<void()>;
+  /**
+   * Wrapper class for a `std::function<void()>`, this can be used from Swift.
+   */
+  class Func_void_Wrapper final {
+  public:
+    explicit Func_void_Wrapper(std::function<void()>&& func): _function(std::make_unique<std::function<void()>>(std::move(func))) {}
+    inline void call() const noexcept {
+      _function->operator()();
+    }
+  private:
+    std::unique_ptr<std::function<void()>> _function;
+  } SWIFT_NONCOPYABLE;
+  Func_void create_Func_void(void* NON_NULL swiftClosureWrapper) noexcept;
+  inline Func_void_Wrapper wrap_Func_void(Func_void value) noexcept {
+    return Func_void_Wrapper(std::move(value));
+  }
+  
+  // pragma MARK: std::shared_ptr<HybridRiveRuntimeSpec>
+  /**
+   * Specialized version of `std::shared_ptr<HybridRiveRuntimeSpec>`.
+   */
+  using std__shared_ptr_HybridRiveRuntimeSpec_ = std::shared_ptr<HybridRiveRuntimeSpec>;
+  std::shared_ptr<HybridRiveRuntimeSpec> create_std__shared_ptr_HybridRiveRuntimeSpec_(void* NON_NULL swiftUnsafePointer) noexcept;
+  void* NON_NULL get_std__shared_ptr_HybridRiveRuntimeSpec_(std__shared_ptr_HybridRiveRuntimeSpec_ cppType);
+  
+  // pragma MARK: std::weak_ptr<HybridRiveRuntimeSpec>
+  using std__weak_ptr_HybridRiveRuntimeSpec_ = std::weak_ptr<HybridRiveRuntimeSpec>;
+  inline std__weak_ptr_HybridRiveRuntimeSpec_ weakify_std__shared_ptr_HybridRiveRuntimeSpec_(const std::shared_ptr<HybridRiveRuntimeSpec>& strong) noexcept { return strong; }
+  
+  // pragma MARK: Result<std::shared_ptr<Promise<void>>>
+  using Result_std__shared_ptr_Promise_void___ = Result<std::shared_ptr<Promise<void>>>;
+  inline Result_std__shared_ptr_Promise_void___ create_Result_std__shared_ptr_Promise_void___(const std::shared_ptr<Promise<void>>& value) noexcept {
+    return Result<std::shared_ptr<Promise<void>>>::withValue(value);
+  }
+  inline Result_std__shared_ptr_Promise_void___ create_Result_std__shared_ptr_Promise_void___(const std::exception_ptr& error) noexcept {
+    return Result<std::shared_ptr<Promise<void>>>::withError(error);
+  }
+  
   // pragma MARK: std::optional<bool>
   /**
    * Specialized version of `std::optional<bool>`.
@@ -708,40 +768,6 @@ namespace margelo::nitro::rive::bridge::swift {
     return *optional;
   }
   
-  // pragma MARK: std::shared_ptr<Promise<void>>
-  /**
-   * Specialized version of `std::shared_ptr<Promise<void>>`.
-   */
-  using std__shared_ptr_Promise_void__ = std::shared_ptr<Promise<void>>;
-  inline std::shared_ptr<Promise<void>> create_std__shared_ptr_Promise_void__() noexcept {
-    return Promise<void>::create();
-  }
-  inline PromiseHolder<void> wrap_std__shared_ptr_Promise_void__(std::shared_ptr<Promise<void>> promise) noexcept {
-    return PromiseHolder<void>(std::move(promise));
-  }
-  
-  // pragma MARK: std::function<void()>
-  /**
-   * Specialized version of `std::function<void()>`.
-   */
-  using Func_void = std::function<void()>;
-  /**
-   * Wrapper class for a `std::function<void()>`, this can be used from Swift.
-   */
-  class Func_void_Wrapper final {
-  public:
-    explicit Func_void_Wrapper(std::function<void()>&& func): _function(std::make_unique<std::function<void()>>(std::move(func))) {}
-    inline void call() const noexcept {
-      _function->operator()();
-    }
-  private:
-    std::unique_ptr<std::function<void()>> _function;
-  } SWIFT_NONCOPYABLE;
-  Func_void create_Func_void(void* NON_NULL swiftClosureWrapper) noexcept;
-  inline Func_void_Wrapper wrap_Func_void(Func_void value) noexcept {
-    return Func_void_Wrapper(std::move(value));
-  }
-  
   // pragma MARK: std::variant<bool, std::string, double>
   /**
    * Wrapper struct for `std::variant<bool, std::string, double>`.
@@ -869,15 +895,6 @@ namespace margelo::nitro::rive::bridge::swift {
     return Result<std::optional<std::shared_ptr<HybridViewModelInstanceSpec>>>::withError(error);
   }
   
-  // pragma MARK: Result<std::shared_ptr<Promise<void>>>
-  using Result_std__shared_ptr_Promise_void___ = Result<std::shared_ptr<Promise<void>>>;
-  inline Result_std__shared_ptr_Promise_void___ create_Result_std__shared_ptr_Promise_void___(const std::shared_ptr<Promise<void>>& value) noexcept {
-    return Result<std::shared_ptr<Promise<void>>>::withValue(value);
-  }
-  inline Result_std__shared_ptr_Promise_void___ create_Result_std__shared_ptr_Promise_void___(const std::exception_ptr& error) noexcept {
-    return Result<std::shared_ptr<Promise<void>>>::withError(error);
-  }
-  
   // pragma MARK: Result<bool>
   using Result_bool_ = Result<bool>;
   inline Result_bool_ create_Result_bool_(bool value) noexcept {

package/nitrogen/generated/ios/RNRive-Swift-Cxx-Umbrella.hpp

@@ -30,6 +30,8 @@ namespace margelo::nitro::rive { class HybridRiveFileSpec; }
 namespace margelo::nitro::rive { class HybridRiveImageFactorySpec; }
 // Forward declaration of `HybridRiveImageSpec` to properly resolve imports.
 namespace margelo::nitro::rive { class HybridRiveImageSpec; }
+// Forward declaration of `HybridRiveRuntimeSpec` to properly resolve imports.
+namespace margelo::nitro::rive { class HybridRiveRuntimeSpec; }
 // Forward declaration of `HybridRiveSpec` to properly resolve imports.
 namespace margelo::nitro::rive { class HybridRiveSpec; }
 // Forward declaration of `HybridRiveViewSpec` to properly resolve imports.
@@ -83,6 +85,7 @@ namespace margelo::nitro::rive { struct UnifiedRiveEvent; }
 #include "HybridRiveFileSpec.hpp"
 #include "HybridRiveImageFactorySpec.hpp"
 #include "HybridRiveImageSpec.hpp"
+#include "HybridRiveRuntimeSpec.hpp"
 #include "HybridRiveSpec.hpp"
 #include "HybridRiveViewSpec.hpp"
 #include "HybridViewModelArtboardPropertySpec.hpp"
@@ -135,6 +138,8 @@ namespace RNRive { class HybridRiveFileSpec_cxx; }
 namespace RNRive { class HybridRiveImageFactorySpec_cxx; }
 // Forward declaration of `HybridRiveImageSpec_cxx` to properly resolve imports.
 namespace RNRive { class HybridRiveImageSpec_cxx; }
+// Forward declaration of `HybridRiveRuntimeSpec_cxx` to properly resolve imports.
+namespace RNRive { class HybridRiveRuntimeSpec_cxx; }
 // Forward declaration of `HybridRiveSpec_cxx` to properly resolve imports.
 namespace RNRive { class HybridRiveSpec_cxx; }
 // Forward declaration of `HybridRiveViewSpec_cxx` to properly resolve imports.

package/nitrogen/generated/ios/RNRiveAutolinking.mm

@@ -15,6 +15,7 @@
 #include "HybridRiveFileSpecSwift.hpp"
 #include "HybridRiveViewSpecSwift.hpp"
 #include "HybridRiveImageFactorySpecSwift.hpp"
+#include "HybridRiveRuntimeSpecSwift.hpp"
 
 @interface RNRiveAutolinking : NSObject
 @end
@@ -60,6 +61,13 @@
       return hybridObject;
     }
   );
+  HybridObjectRegistry::registerHybridObjectConstructor(
+    "RiveRuntime",
+    []() -> std::shared_ptr<HybridObject> {
+      std::shared_ptr<HybridRiveRuntimeSpec> hybridObject = RNRive::RNRiveAutolinking::createRiveRuntime();
+      return hybridObject;
+    }
+  );
 }
 
 @end

package/nitrogen/generated/ios/RNRiveAutolinking.swift

@@ -71,4 +71,16 @@ public final class RNRiveAutolinking {
   public static func isRiveImageFactoryRecyclable() -> Bool {
     return HybridRiveImageFactory.self is any RecyclableView.Type
   }
+  
+  public static func createRiveRuntime() -> bridge.std__shared_ptr_HybridRiveRuntimeSpec_ {
+    let hybridObject = HybridRiveRuntime()
+    return { () -> bridge.std__shared_ptr_HybridRiveRuntimeSpec_ in
+      let __cxxWrapped = hybridObject.getCxxWrapper()
+      return __cxxWrapped.getCxxPart()
+    }()
+  }
+  
+  public static func isRiveRuntimeRecyclable() -> Bool {
+    return HybridRiveRuntime.self is any RecyclableView.Type
+  }
 }

package/nitrogen/generated/ios/c++/HybridRiveRuntimeSpecSwift.cpp

@@ -0,0 +1,11 @@
+///
+/// HybridRiveRuntimeSpecSwift.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridRiveRuntimeSpecSwift.hpp"
+
+namespace margelo::nitro::rive {
+} // namespace margelo::nitro::rive

package/nitrogen/generated/ios/c++/HybridRiveRuntimeSpecSwift.hpp

@@ -0,0 +1,90 @@
+///
+/// HybridRiveRuntimeSpecSwift.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include "HybridRiveRuntimeSpec.hpp"
+
+// Forward declaration of `HybridRiveRuntimeSpec_cxx` to properly resolve imports.
+namespace RNRive { class HybridRiveRuntimeSpec_cxx; }
+
+
+
+#include <string>
+#include <optional>
+#include <NitroModules/Promise.hpp>
+
+#include "RNRive-Swift-Cxx-Umbrella.hpp"
+
+namespace margelo::nitro::rive {
+
+  /**
+   * The C++ part of HybridRiveRuntimeSpec_cxx.swift.
+   *
+   * HybridRiveRuntimeSpecSwift (C++) accesses HybridRiveRuntimeSpec_cxx (Swift), and might
+   * contain some additional bridging code for C++ <> Swift interop.
+   *
+   * Since this obviously introduces an overhead, I hope at some point in
+   * the future, HybridRiveRuntimeSpec_cxx can directly inherit from the C++ class HybridRiveRuntimeSpec
+   * to simplify the whole structure and memory management.
+   */
+  class HybridRiveRuntimeSpecSwift: public virtual HybridRiveRuntimeSpec {
+  public:
+    // Constructor from a Swift instance
+    explicit HybridRiveRuntimeSpecSwift(const RNRive::HybridRiveRuntimeSpec_cxx& swiftPart):
+      HybridObject(HybridRiveRuntimeSpec::TAG),
+      _swiftPart(swiftPart) { }
+
+  public:
+    // Get the Swift part
+    inline RNRive::HybridRiveRuntimeSpec_cxx& getSwiftPart() noexcept {
+      return _swiftPart;
+    }
+
+  public:
+    inline size_t getExternalMemorySize() noexcept override {
+      return _swiftPart.getMemorySize();
+    }
+    bool equals(const std::shared_ptr<HybridObject>& other) override {
+      if (auto otherCast = std::dynamic_pointer_cast<HybridRiveRuntimeSpecSwift>(other)) {
+        return _swiftPart.equals(otherCast->_swiftPart);
+      }
+      return false;
+    }
+    void dispose() noexcept override {
+      _swiftPart.dispose();
+    }
+    std::string toString() override {
+      return _swiftPart.toString();
+    }
+
+  public:
+    // Properties
+    inline bool getIsInitialized() noexcept override {
+      return _swiftPart.isInitialized();
+    }
+    inline std::optional<std::string> getInitError() noexcept override {
+      auto __result = _swiftPart.getInitError();
+      return __result;
+    }
+
+  public:
+    // Methods
+    inline std::shared_ptr<Promise<void>> initialize() override {
+      auto __result = _swiftPart.initialize();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+
+  private:
+    RNRive::HybridRiveRuntimeSpec_cxx _swiftPart;
+  };
+
+} // namespace margelo::nitro::rive

package/nitrogen/generated/ios/swift/HybridRiveRuntimeSpec.swift

@@ -0,0 +1,57 @@
+///
+/// HybridRiveRuntimeSpec.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+
+/// See ``HybridRiveRuntimeSpec``
+public protocol HybridRiveRuntimeSpec_protocol: HybridObject {
+  // Properties
+  var isInitialized: Bool { get }
+  var initError: String? { get }
+
+  // Methods
+  func initialize() throws -> Promise<Void>
+}
+
+public extension HybridRiveRuntimeSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject RiveRuntime]"
+  }
+}
+
+/// See ``HybridRiveRuntimeSpec``
+open class HybridRiveRuntimeSpec_base {
+  private weak var cxxWrapper: HybridRiveRuntimeSpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridRiveRuntimeSpec_cxx {
+  #if DEBUG
+    guard self is any HybridRiveRuntimeSpec else {
+      fatalError("`self` is not a `HybridRiveRuntimeSpec`! Did you accidentally inherit from `HybridRiveRuntimeSpec_base` instead of `HybridRiveRuntimeSpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridRiveRuntimeSpec_cxx(self as! any HybridRiveRuntimeSpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the RiveRuntime HybridObject.
+ * Implement this protocol to create Swift-based instances of RiveRuntime.
+ * ```swift
+ * class HybridRiveRuntime : HybridRiveRuntimeSpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridRiveRuntimeSpec = HybridRiveRuntimeSpec_protocol & HybridRiveRuntimeSpec_base

package/nitrogen/generated/ios/swift/HybridRiveRuntimeSpec_cxx.swift

@@ -0,0 +1,164 @@
+///
+/// HybridRiveRuntimeSpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+
+/**
+ * A class implementation that bridges HybridRiveRuntimeSpec over to C++.
+ * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
+ *
+ * Also, some Swift types need to be bridged with special handling:
+ * - Enums need to be wrapped in Structs, otherwise they cannot be accessed bi-directionally (Swift bug: https://github.com/swiftlang/swift/issues/75330)
+ * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
+ * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
+ */
+open class HybridRiveRuntimeSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::rive::bridge::swift`)
+   * from `RNRive-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.rive.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridRiveRuntimeSpec` Swift protocol.
+   */
+  private var __implementation: any HybridRiveRuntimeSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridRiveRuntimeSpec_
+
+  /**
+   * Create a new `HybridRiveRuntimeSpec_cxx` that wraps the given `HybridRiveRuntimeSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridRiveRuntimeSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridRiveRuntimeSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridRiveRuntimeSpec() -> any HybridRiveRuntimeSpec {
+    return __implementation
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `HybridRiveRuntimeSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridRiveRuntimeSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridRiveRuntimeSpec_cxx {
+    return Unmanaged<HybridRiveRuntimeSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridRiveRuntimeSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridRiveRuntimeSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridRiveRuntimeSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridRiveRuntimeSpec_(newCxxPart)
+      return newCxxPart
+    }
+  }
+
+  
+
+  /**
+   * Get the memory size of the Swift class (plus size of any other allocations)
+   * so the JS VM can properly track it and garbage-collect the JS object if needed.
+   */
+  @inline(__always)
+  public var memorySize: Int {
+    return MemoryHelper.getSizeOf(self.__implementation) + self.__implementation.memorySize
+  }
+
+  /**
+   * Compares this object with the given [other] object for reference equality.
+   */
+  @inline(__always)
+  public func equals(other: HybridRiveRuntimeSpec_cxx) -> Bool {
+    return self.__implementation === other.__implementation
+  }
+
+  /**
+   * Call dispose() on the Swift class.
+   * This _may_ be called manually from JS.
+   */
+  @inline(__always)
+  public func dispose() {
+    self.__implementation.dispose()
+  }
+
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
+  // Properties
+  public final var isInitialized: Bool {
+    @inline(__always)
+    get {
+      return self.__implementation.isInitialized
+    }
+  }
+  
+  public final var initError: bridge.std__optional_std__string_ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__string_ in
+        if let __unwrappedValue = self.__implementation.initError {
+          return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+
+  // Methods
+  @inline(__always)
+  public final func initialize() -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.initialize()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+}

package/nitrogen/generated/shared/c++/HybridRiveRuntimeSpec.cpp

@@ -0,0 +1,23 @@
+///
+/// HybridRiveRuntimeSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridRiveRuntimeSpec.hpp"
+
+namespace margelo::nitro::rive {
+
+  void HybridRiveRuntimeSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("isInitialized", &HybridRiveRuntimeSpec::getIsInitialized);
+      prototype.registerHybridGetter("initError", &HybridRiveRuntimeSpec::getInitError);
+      prototype.registerHybridMethod("initialize", &HybridRiveRuntimeSpec::initialize);
+    });
+  }
+
+} // namespace margelo::nitro::rive

package/nitrogen/generated/shared/c++/HybridRiveRuntimeSpec.hpp

@@ -0,0 +1,65 @@
+///
+/// HybridRiveRuntimeSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+#include <NitroModules/Promise.hpp>
+
+namespace margelo::nitro::rive {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `RiveRuntime`
+   * Inherit this class to create instances of `HybridRiveRuntimeSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridRiveRuntime: public HybridRiveRuntimeSpec {
+   * public:
+   *   HybridRiveRuntime(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridRiveRuntimeSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridRiveRuntimeSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridRiveRuntimeSpec() override = default;
+
+    public:
+      // Properties
+      virtual bool getIsInitialized() = 0;
+      virtual std::optional<std::string> getInitError() = 0;
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<void>> initialize() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "RiveRuntime";
+  };
+
+} // namespace margelo::nitro::rive

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/react-native",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Rive React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/core/RiveRuntime.ts

@@ -0,0 +1,23 @@
+import { NitroModules } from 'react-native-nitro-modules';
+import type { RiveRuntime as RiveRuntimeSpec } from '../specs/RiveRuntime.nitro';
+
+const RiveRuntimeInternal =
+  NitroModules.createHybridObject<RiveRuntimeSpec>('RiveRuntime');
+
+export namespace RiveRuntime {
+  export async function initialize(): Promise<void> {
+    await RiveRuntimeInternal.initialize();
+    if (!RiveRuntimeInternal.isInitialized) {
+      throw new Error(
+        `Rive initialization failed: ${RiveRuntimeInternal.initError ?? 'Unknown error'}`
+      );
+    }
+  }
+
+  export function getStatus(): { isInitialized: boolean; error?: string } {
+    return {
+      isInitialized: RiveRuntimeInternal.isInitialized,
+      error: RiveRuntimeInternal.initError ?? undefined,
+    };
+  }
+}

package/src/hooks/useRiveProperty.ts

@@ -86,15 +86,11 @@ export function useRiveProperty<P extends ViewModelProperty, T>(
     };
   }, [options, property]);
 
-  // Set the value of the property
+  // Set the value of the property (no-op if property isn't available yet)
   const setPropertyValue = useCallback(
     (valueOrUpdater: T | ((prevValue: T | undefined) => T)) => {
       if (!property) {
-        setError(
-          new Error(
-            `Cannot set value for property "${path}" because it was not found. Your view model instance may be undefined, or the path may be incorrect.`
-          )
-        );
+        return;
       } else {
         const newValue =
           typeof valueOrUpdater === 'function'
@@ -105,7 +101,7 @@ export function useRiveProperty<P extends ViewModelProperty, T>(
         property.value = newValue;
       }
     },
-    [property, path]
+    [property]
   );
 
   return [value, setPropertyValue, error, property as unknown as P];