@rive-app/react-native 0.1.2 → 0.1.4

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

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

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

@@ -0,0 +1,68 @@
+///
+/// HybridViewModelArtboardPropertySpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 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
+
+// Forward declaration of `HybridBindableArtboardSpec` to properly resolve imports.
+namespace margelo::nitro::rive { class HybridBindableArtboardSpec; }
+// Forward declaration of `HybridViewModelPropertySpec` to properly resolve imports.
+namespace margelo::nitro::rive { class HybridViewModelPropertySpec; }
+
+#include <memory>
+#include "HybridBindableArtboardSpec.hpp"
+#include <optional>
+#include "HybridViewModelPropertySpec.hpp"
+
+namespace margelo::nitro::rive {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `ViewModelArtboardProperty`
+   * Inherit this class to create instances of `HybridViewModelArtboardPropertySpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridViewModelArtboardProperty: public HybridViewModelArtboardPropertySpec {
+   * public:
+   *   HybridViewModelArtboardProperty(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridViewModelArtboardPropertySpec: public virtual HybridObject, public virtual HybridViewModelPropertySpec {
+    public:
+      // Constructor
+      explicit HybridViewModelArtboardPropertySpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridViewModelArtboardPropertySpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual void set(const std::optional<std::shared_ptr<HybridBindableArtboardSpec>>& artboard) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "ViewModelArtboardProperty";
+  };
+
+} // namespace margelo::nitro::rive

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

@@ -2,7 +2,7 @@
 /// HybridViewModelBooleanPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelBooleanPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelBooleanPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelColorPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelColorPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelColorPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelEnumPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelEnumPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelEnumPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelImagePropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelImagePropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelImagePropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelInstanceSpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelInstanceSpec.hpp"
@@ -23,6 +23,9 @@ namespace margelo::nitro::rive {
       prototype.registerHybridMethod("triggerProperty", &HybridViewModelInstanceSpec::triggerProperty);
       prototype.registerHybridMethod("imageProperty", &HybridViewModelInstanceSpec::imageProperty);
       prototype.registerHybridMethod("listProperty", &HybridViewModelInstanceSpec::listProperty);
+      prototype.registerHybridMethod("artboardProperty", &HybridViewModelInstanceSpec::artboardProperty);
+      prototype.registerHybridMethod("viewModel", &HybridViewModelInstanceSpec::viewModel);
+      prototype.registerHybridMethod("replaceViewModel", &HybridViewModelInstanceSpec::replaceViewModel);
     });
   }
 

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

@@ -2,7 +2,7 @@
 /// HybridViewModelInstanceSpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -29,6 +29,10 @@ namespace margelo::nitro::rive { class HybridViewModelTriggerPropertySpec; }
 namespace margelo::nitro::rive { class HybridViewModelImagePropertySpec; }
 // Forward declaration of `HybridViewModelListPropertySpec` to properly resolve imports.
 namespace margelo::nitro::rive { class HybridViewModelListPropertySpec; }
+// Forward declaration of `HybridViewModelArtboardPropertySpec` to properly resolve imports.
+namespace margelo::nitro::rive { class HybridViewModelArtboardPropertySpec; }
+// Forward declaration of `HybridViewModelInstanceSpec` to properly resolve imports.
+namespace margelo::nitro::rive { class HybridViewModelInstanceSpec; }
 
 #include <string>
 #include <memory>
@@ -41,6 +45,8 @@ namespace margelo::nitro::rive { class HybridViewModelListPropertySpec; }
 #include "HybridViewModelTriggerPropertySpec.hpp"
 #include "HybridViewModelImagePropertySpec.hpp"
 #include "HybridViewModelListPropertySpec.hpp"
+#include "HybridViewModelArtboardPropertySpec.hpp"
+#include "HybridViewModelInstanceSpec.hpp"
 
 namespace margelo::nitro::rive {
 
@@ -81,6 +87,9 @@ namespace margelo::nitro::rive {
       virtual std::optional<std::shared_ptr<HybridViewModelTriggerPropertySpec>> triggerProperty(const std::string& path) = 0;
       virtual std::optional<std::shared_ptr<HybridViewModelImagePropertySpec>> imageProperty(const std::string& path) = 0;
       virtual std::optional<std::shared_ptr<HybridViewModelListPropertySpec>> listProperty(const std::string& path) = 0;
+      virtual std::optional<std::shared_ptr<HybridViewModelArtboardPropertySpec>> artboardProperty(const std::string& path) = 0;
+      virtual std::optional<std::shared_ptr<HybridViewModelInstanceSpec>> viewModel(const std::string& path) = 0;
+      virtual void replaceViewModel(const std::string& path, const std::shared_ptr<HybridViewModelInstanceSpec>& instance) = 0;
 
     protected:
       // Hybrid Setup

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

@@ -2,7 +2,7 @@
 /// HybridViewModelListPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelListPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelListPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelNumberPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelNumberPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelNumberPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelSpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelSpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelSpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelStringPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelStringPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelStringPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// HybridViewModelTriggerPropertySpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridViewModelTriggerPropertySpec.hpp"

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

@@ -2,7 +2,7 @@
 /// HybridViewModelTriggerPropertySpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// ReferencedAssetsType.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// ResolvedReferencedAsset.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// RiveError.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// RiveErrorType.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// RiveEventType.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

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

@@ -2,7 +2,7 @@
 /// UnifiedRiveEvent.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/views/HybridRiveViewComponent.cpp

@@ -2,7 +2,7 @@
 /// HybridRiveViewComponent.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridRiveViewComponent.hpp"

package/nitrogen/generated/shared/c++/views/HybridRiveViewComponent.hpp

@@ -2,7 +2,7 @@
 /// HybridRiveViewComponent.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/react-native",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Rive React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -189,5 +189,9 @@
     "languages": "kotlin-swift",
     "type": "nitro-module",
     "version": "0.50.2"
+  },
+  "resolutions": {
+    "core-js-compat": "^3.40.0",
+    "browserslist": "^4.24.4"
   }
 }

package/src/hooks/useRiveFile.ts

@@ -16,6 +16,12 @@ import type {
 export type { ReferencedAssets, ResolvedReferencedAssets };
 export type RiveFileInput = number | { uri: string } | string | ArrayBuffer;
 
+function isUriInput(
+  input: RiveFileInput | undefined
+): input is { uri: string } {
+  return input != null && typeof input === 'object' && 'uri' in input;
+}
+
 export type UseRiveFileOptions = {
   referencedAssets?: ReferencedAssets;
 };
@@ -101,12 +107,18 @@ export function useRiveFile(
   );
   const initialReferencedAssets = useRef(referencedAssets);
 
+  const inputKind = isUriInput(input) ? 'uri' : 'primitive';
+  const inputValue = isUriInput(input) ? input.uri : input;
+
   useEffect(() => {
     let currentFile: RiveFile | null = null;
 
     const loadRiveFile = async () => {
       try {
-        const currentInput = input;
+        const currentInput =
+          inputKind === 'uri'
+            ? { uri: inputValue as string }
+            : (inputValue as Exclude<RiveFileInput, { uri: string }>);
 
         if (currentInput == null) {
           setResult({
@@ -164,7 +176,7 @@ export function useRiveFile(
         callDispose(currentFile);
       }
     };
-  }, [input]);
+  }, [inputKind, inputValue]);
 
   const { riveFile } = result;
   useEffect(() => {

package/src/hooks/useRiveProperty.ts

@@ -34,15 +34,7 @@ export function useRiveProperty<P extends ViewModelProperty, T>(
   Error | null,
   P | undefined,
 ] {
-  const [value, setValue] = useState<T | undefined>(undefined);
-  const [error, setError] = useState<Error | null>(null);
-
-  // Clear error when path or instance changes
-  useEffect(() => {
-    setError(null);
-  }, [path, viewModelInstance]);
-
-  // Get the property
+  // Get the property first so we can read its initial value
   const property = useMemo(() => {
     if (!viewModelInstance) return;
     return options.getProperty(
@@ -51,6 +43,22 @@ export function useRiveProperty<P extends ViewModelProperty, T>(
     ) as unknown as ObservableViewModelProperty<T>;
   }, [options, viewModelInstance, path]);
 
+  // Initialize state with property's current value (if available)
+  const [value, setValue] = useState<T | undefined>(() => property?.value);
+  const [error, setError] = useState<Error | null>(null);
+
+  // Sync value when property reference changes (path or instance changed)
+  useEffect(() => {
+    if (property) {
+      setValue(property.value);
+    }
+  }, [property]);
+
+  // Clear error when path or instance changes
+  useEffect(() => {
+    setError(null);
+  }, [path, viewModelInstance]);
+
   // Set error if property is not found
   useEffect(() => {
     if (viewModelInstance && !property) {

package/src/index.tsx

@@ -31,7 +31,9 @@ export type {
   ViewModelTriggerProperty,
   ViewModelImageProperty,
   ViewModelListProperty,
+  ViewModelArtboardProperty,
 } from './specs/ViewModel.nitro';
+export type { BindableArtboard } from './specs/BindableArtboard.nitro';
 export { Fit } from './core/Fit';
 export { Alignment } from './core/Alignment';
 export { RiveFileFactory } from './core/RiveFile';

package/src/specs/BindableArtboard.nitro.ts

@@ -0,0 +1,14 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+/**
+ * A bindable artboard that can be assigned to a {@link ViewModelArtboardProperty}.
+ * Created via {@link RiveFile.getBindableArtboard}.
+ *
+ * Used for data binding artboards - swapping artboard sources at runtime.
+ * @see {@link https://rive.app/docs/runtimes/data-binding Rive Data Binding Documentation}
+ */
+export interface BindableArtboard
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  /** The name of the artboard */
+  readonly artboardName: string;
+}

package/src/specs/RiveFile.nitro.ts

@@ -2,6 +2,7 @@ import type { HybridObject } from 'react-native-nitro-modules';
 import type { ViewModel } from './ViewModel.nitro';
 import type { ArtboardBy } from './ArtboardBy';
 import type { RiveImage } from './RiveImage.nitro';
+import type { BindableArtboard } from './BindableArtboard.nitro';
 
 export type ResolvedReferencedAsset = {
   sourceUrl?: string;
@@ -30,6 +31,17 @@ export interface RiveFile
   /** Returns the default view model for the provided artboard */
   defaultArtboardViewModel(artboardBy?: ArtboardBy): ViewModel | undefined;
   updateReferencedAssets(referencedAssets: ReferencedAssetsType): void;
+
+  /** The number of artboards in the Rive file */
+  readonly artboardCount: number;
+  /** The names of all artboards in the Rive file */
+  readonly artboardNames: string[];
+  /**
+   * Get a bindable artboard by name for use with data binding.
+   * @throws Error if artboard with the given name is not found
+   * @see {@link https://rive.app/docs/runtimes/data-binding Rive Data Binding Documentation}
+   */
+  getBindableArtboard(name: string): BindableArtboard;
 }
 
 export interface RiveFileFactory

package/src/specs/ViewModel.nitro.ts

@@ -1,5 +1,6 @@
 import type { HybridObject } from 'react-native-nitro-modules';
 import type { RiveImage } from './RiveImage.nitro';
+import type { BindableArtboard } from './BindableArtboard.nitro';
 
 /**
  * A Rive View Model as created in the Rive editor.
@@ -55,6 +56,22 @@ export interface ViewModelInstance
 
   /** Get a list property from the view model instance at the given path */
   listProperty(path: string): ViewModelListProperty | undefined;
+
+  /** Get an artboard property from the view model instance at the given path */
+  artboardProperty(path: string): ViewModelArtboardProperty | undefined;
+
+  /**
+   * Get a nested ViewModel instance at the given path.
+   * Supports path notation with "/" for nested access (e.g., "Parent/Child").
+   */
+  viewModel(path: string): ViewModelInstance | undefined;
+
+  /**
+   * Replace the ViewModel instance at the given path with a new instance.
+   * The replacement instance must be compatible with the expected ViewModel type.
+   * @throws Error if path not found or types incompatible
+   */
+  replaceViewModel(path: string, instance: ViewModelInstance): void;
 }
 
 export interface ViewModelProperty
@@ -152,3 +169,16 @@ export interface ViewModelListProperty
   /** Add a listener to be notified when the list changes. Returns a function to remove the listener. */
   addListener(onChanged: () => void): () => void;
 }
+
+/**
+ * An artboard property that allows swapping artboards at runtime.
+ * This is a write-only property - artboards can be set but not read.
+ * @see {@link https://rive.app/docs/runtimes/data-binding Rive Data Binding Documentation}
+ */
+export interface ViewModelArtboardProperty extends ViewModelProperty {
+  /**
+   * Set the artboard for this property.
+   * Pass undefined to clear the currently bound artboard.
+   */
+  set(artboard: BindableArtboard | undefined): void;
+}