@rive-app/react-native 0.1.1-beta.1 → 0.1.2

package/ios/HybridViewModelListProperty.swift

@@ -0,0 +1,62 @@
+import RiveRuntime
+
+class HybridViewModelListProperty: HybridViewModelListPropertySpec, ValuedPropertyProtocol {
+  var property: ListPropertyType!
+  lazy var helper = PropertyListenerHelper(property: property!)
+
+  init(property: ListPropertyType) {
+    self.property = property
+    super.init()
+  }
+
+  var length: Double {
+    Double(property.count)
+  }
+
+  func getInstanceAt(index: Double) throws -> (any HybridViewModelInstanceSpec)? {
+    guard let instance = property.instance(at: Int32(index)) else { return nil }
+    return HybridViewModelInstance(viewModelInstance: instance)
+  }
+
+  private func requireViewModelInstance(_ instance: any HybridViewModelInstanceSpec) throws -> RiveDataBindingViewModel.Instance {
+    guard let hybridInstance = instance as? HybridViewModelInstance,
+          let viewModelInstance = hybridInstance.viewModelInstance else {
+      throw NSError(domain: "HybridViewModelListProperty", code: 1,
+                    userInfo: [NSLocalizedDescriptionKey: "Expected HybridViewModelInstance with valid viewModelInstance"])
+    }
+    return viewModelInstance
+  }
+
+  func addInstance(instance: any HybridViewModelInstanceSpec) throws {
+    let viewModelInstance = try requireViewModelInstance(instance)
+    property.append(viewModelInstance)
+  }
+
+  func addInstanceAt(instance: any HybridViewModelInstanceSpec, index: Double) throws -> Bool {
+    let viewModelInstance = try requireViewModelInstance(instance)
+    return property.insert(viewModelInstance, at: Int32(index))
+  }
+
+  func removeInstance(instance: any HybridViewModelInstanceSpec) throws {
+    let viewModelInstance = try requireViewModelInstance(instance)
+    property.remove(viewModelInstance)
+  }
+
+  func removeInstanceAt(index: Double) throws {
+    property.remove(at: Int32(index))
+  }
+
+  func swap(index1: Double, index2: Double) throws -> Bool {
+    let idx1 = UInt32(index1)
+    let idx2 = UInt32(index2)
+    guard idx1 < property.count && idx2 < property.count else {
+      return false
+    }
+    property.swap(at: idx1, with: idx2)
+    return true
+  }
+
+  func addListener(onChanged: @escaping () -> Void) throws -> () -> Void {
+    helper.addListener({ _ in onChanged() })
+  }
+}

package/ios/HybridViewModelNumberProperty.swift

@@ -9,14 +9,6 @@ class HybridViewModelNumberProperty: HybridViewModelNumberPropertySpec, ValuedPr
     super.init()
   }
 
-  /// ⚠️ DO NOT REMOVE
-  /// Nitro requires a parameterless initializer for JS bridging.
-  /// This is invoked automatically during hybrid module construction.
-  /// Internally we always use `init(property:)`
-  override init() {
-    super.init()
-  }
-
   var value: Double {
     get {
       return Double(property.value)
@@ -26,10 +18,7 @@ class HybridViewModelNumberProperty: HybridViewModelNumberPropertySpec, ValuedPr
     }
   }
 
-  // Custom addListener needed because ListenerValueType (Float) != ValueType (Double)
-  func addListener(onChanged: @escaping (Double) -> Void) throws {
-    helper.addListener { (value: Float) in
-      onChanged(Double(value))
-    }
+  func addListener(onChanged: @escaping (Double) -> Void) throws -> () -> Void {
+    return helper.addListener({ floatValue in onChanged(Double(floatValue)) })
   }
 }

package/ios/HybridViewModelStringProperty.swift

@@ -9,15 +9,7 @@ class HybridViewModelStringProperty: HybridViewModelStringPropertySpec, ValuedPr
     self.property = property
     super.init()
   }
-  
-  /// ⚠️ DO NOT REMOVE
-  /// Nitro requires a parameterless initializer for JS bridging.
-  /// This is invoked automatically during hybrid module construction.
-  /// Internally we always use `init(property:)`
-  override init() {
-    super.init()
-  }
-  
+
   var value: String {
     get {
       return property.value

package/ios/HybridViewModelTriggerProperty.swift

@@ -4,27 +4,18 @@ import RiveRuntime
 class HybridViewModelTriggerProperty: HybridViewModelTriggerPropertySpec, ValuedPropertyProtocol {
   internal var property: TriggerPropertyType!
   lazy var helper = PropertyListenerHelper(property: property!)
-
   private var listenerIds: [UUID] = []
 
-  func addListener(onChanged: @escaping () -> Void) throws {
-    try addListener(onChanged: { _ in onChanged() })
-  }
-
   init(property: TriggerPropertyType) {
     self.property = property
     super.init()
   }
-  
-  /// ⚠️ DO NOT REMOVE
-  /// Nitro requires a parameterless initializer for JS bridging.
-  /// This is invoked automatically during hybrid module construction.
-  /// Internally we always use `init(property:)`
-  override init() {
-    super.init()
-  }
-  
+
   func trigger() {
     property.trigger()
   }
+
+  func addListener(onChanged: @escaping () -> Void) throws -> () -> Void {
+    try addListener(onChanged: { _ in onChanged() })
+  }
 }

package/ios/RiveReactNativeView.swift

@@ -58,6 +58,8 @@ class RiveReactNativeView: UIView, RiveStateMachineDelegate {
   func configure(_ config: ViewConfiguration, dataBindingChanged: Bool = false, reload: Bool = false, initialUpdate: Bool = false) throws {
     if reload {
       cleanup()
+      try validateConfiguration(config)
+
       let model = RiveModel(riveFile: config.riveFile)
       baseViewModel = RiveViewModel(model, stateMachineName: config.stateMachineName, autoPlay: config.autoPlay, artboardName: config.artboardName)
       createViewFromViewModel()
@@ -322,4 +324,38 @@ class RiveReactNativeView: UIView, RiveStateMachineDelegate {
 
     return try onSuccess(input)
   }
+
+  private func validateConfiguration(_ config: ViewConfiguration) throws {
+    try validateArtboardName(config.artboardName, in: config.riveFile)
+    try validateStateMachineName(config.stateMachineName, artboardName: config.artboardName, in: config.riveFile)
+  }
+
+  private func validateArtboardName(_ artboardName: String?, in riveFile: RiveFile) throws {
+    guard let artboardName = artboardName else { return }
+    let artboardNames = riveFile.artboardNames()
+    if !artboardNames.contains(artboardName) {
+      throw NSError(
+        domain: RiveErrorDomain,
+        code: Int(RiveErrorCode.noArtboardFound.rawValue),
+        userInfo: [NSLocalizedDescriptionKey: "Artboard '\(artboardName)' not found. Available: \(artboardNames.joined(separator: ", "))"]
+      )
+    }
+  }
+
+  private func validateStateMachineName(_ stateMachineName: String?, artboardName: String?, in riveFile: RiveFile) throws {
+    guard let stateMachineName = stateMachineName else { return }
+    let artboard = artboardName != nil
+      ? try? riveFile.artboard(fromName: artboardName!)
+      : try? riveFile.artboard()
+
+    guard let artboard = artboard else { return }
+    let stateMachineNames = artboard.stateMachineNames()
+    if !stateMachineNames.contains(stateMachineName) {
+      throw NSError(
+        domain: RiveErrorDomain,
+        code: Int(RiveErrorCode.noStateMachineFound.rawValue),
+        userInfo: [NSLocalizedDescriptionKey: "State machine '\(stateMachineName)' not found. Available: \(stateMachineNames.joined(separator: ", "))"]
+      )
+    }
+  }
 }

package/lib/module/hooks/useRiveColor.js

@@ -6,7 +6,6 @@ import { RiveColor } from "../core/RiveColor.js";
 const COLOR_PROPERTY_OPTIONS = {
   getProperty: (vmi, p) => vmi.colorProperty(p)
 };
-
 /**
  * Hook for interacting with color ViewModel instance properties.
  *

package/lib/module/hooks/useRiveColor.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useRiveProperty","RiveColor","COLOR_PROPERTY_OPTIONS","getProperty","vmi","p","colorProperty","useRiveColor","path","viewModelInstance","rawValue","setRawValue","error","value","undefined","fromInt","setValue","newValue","color","fromHexString","toInt"],"sourceRoot":"../../../src","sources":["hooks/useRiveColor.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AAMnC,SAASC,eAAe,QAAQ,sBAAmB;AACnD,SAASC,SAAS,QAAQ,sBAAmB;AAE7C,MAAMC,sBAAsB,GAAG;EAC7BC,WAAW,EAAEA,CAACC,GAAsB,EAAEC,CAAS,KAAKD,GAAG,CAACE,aAAa,CAACD,CAAC;AACzE,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,YAAYA,CAC1BC,IAAY,EACZC,iBAA4C,EAG5C;EACA,MAAM,CAACC,QAAQ,EAAEC,WAAW,EAAEC,KAAK,CAAC,GAAGZ,eAAe,CAGpDS,iBAAiB,EAAED,IAAI,EAAEN,sBAAsB,CAAC;EAElD,MAAMW,KAAK,GACTH,QAAQ,KAAKI,SAAS,GAAGb,SAAS,CAACc,OAAO,CAACL,QAAQ,CAAC,GAAGI,SAAS;EAElE,MAAME,QAAQ,GAAGjB,WAAW,CACzBkB,QAA4B,IAAK;IAChC,MAAMC,KAAK,GACT,OAAOD,QAAQ,KAAK,QAAQ,GACxBhB,SAAS,CAACkB,aAAa,CAACF,QAAQ,CAAC,GACjCA,QAAQ;IACdN,WAAW,CAACO,KAAK,CAACE,KAAK,CAAC,CAAC,CAAC;EAC5B,CAAC,EACD,CAACT,WAAW,CACd,CAAC;EAED,OAAO;IAAEE,KAAK;IAAEG,QAAQ;IAAEJ;EAAM,CAAC;AACnC","ignoreList":[]}
+{"version":3,"names":["useCallback","useRiveProperty","RiveColor","COLOR_PROPERTY_OPTIONS","getProperty","vmi","p","colorProperty","useRiveColor","path","viewModelInstance","rawValue","setRawValue","error","value","undefined","fromInt","setValue","newValue","color","fromHexString","toInt"],"sourceRoot":"../../../src","sources":["hooks/useRiveColor.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AAKnC,SAASC,eAAe,QAAQ,sBAAmB;AACnD,SAASC,SAAS,QAAQ,sBAAmB;AAE7C,MAAMC,sBAAsB,GAAG;EAC7BC,WAAW,EAAEA,CAACC,GAAsB,EAAEC,CAAS,KAAKD,GAAG,CAACE,aAAa,CAACD,CAAC;AACzE,CAAC;AAQD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,YAAYA,CAC1BC,IAAY,EACZC,iBAA4C,EACxB;EACpB,MAAM,CAACC,QAAQ,EAAEC,WAAW,EAAEC,KAAK,CAAC,GAAGZ,eAAe,CAGpDS,iBAAiB,EAAED,IAAI,EAAEN,sBAAsB,CAAC;EAElD,MAAMW,KAAK,GACTH,QAAQ,KAAKI,SAAS,GAAGb,SAAS,CAACc,OAAO,CAACL,QAAQ,CAAC,GAAGI,SAAS;EAElE,MAAME,QAAQ,GAAGjB,WAAW,CACzBkB,QAA4B,IAAK;IAChC,MAAMC,KAAK,GACT,OAAOD,QAAQ,KAAK,QAAQ,GACxBhB,SAAS,CAACkB,aAAa,CAACF,QAAQ,CAAC,GACjCA,QAAQ;IACdN,WAAW,CAACO,KAAK,CAACE,KAAK,CAAC,CAAC,CAAC;EAC5B,CAAC,EACD,CAACT,WAAW,CACd,CAAC;EAED,OAAO;IAAEE,KAAK;IAAEG,QAAQ;IAAEJ;EAAM,CAAC;AACnC","ignoreList":[]}

package/lib/module/hooks/useRiveList.js

@@ -0,0 +1,71 @@
+"use strict";
+
+import { useCallback, useEffect, useState, useMemo } from 'react';
+/**
+ * Hook for interacting with list ViewModel instance properties.
+ *
+ * @param path - The path to the list property
+ * @param viewModelInstance - The ViewModelInstance containing the list property
+ * @returns An object with list length, manipulation methods, and error state
+ */
+export function useRiveList(path, viewModelInstance) {
+  const [error, setError] = useState(null);
+  const [revision, setRevision] = useState(0);
+  useEffect(() => {
+    setError(null);
+  }, [path, viewModelInstance]);
+  const property = useMemo(() => {
+    if (!viewModelInstance) return undefined;
+    return viewModelInstance.listProperty(path);
+  }, [viewModelInstance, path]);
+  useEffect(() => {
+    if (viewModelInstance && !property) {
+      setError(new Error(`List property "${path}" not found in the ViewModel instance`));
+    }
+  }, [viewModelInstance, property, path]);
+  useEffect(() => {
+    if (!property) return;
+    const removeListener = property.addListener(() => {
+      setRevision(r => r + 1);
+    });
+    return () => {
+      removeListener();
+      property.removeListeners();
+      property.dispose();
+    };
+  }, [property]);
+  const length = useMemo(() => {
+    // revision is used to trigger re-computation when list changes
+    revision;
+    return property?.length ?? 0;
+  }, [property, revision]);
+  const getInstanceAt = useCallback(index => {
+    return property?.getInstanceAt(index);
+  }, [property]);
+  const addInstance = useCallback(instance => {
+    property?.addInstance(instance);
+  }, [property]);
+  const addInstanceAt = useCallback((instance, index) => {
+    return property?.addInstanceAt(instance, index) ?? false;
+  }, [property]);
+  const removeInstance = useCallback(instance => {
+    property?.removeInstance(instance);
+  }, [property]);
+  const removeInstanceAt = useCallback(index => {
+    property?.removeInstanceAt(index);
+  }, [property]);
+  const swap = useCallback((index1, index2) => {
+    return property?.swap(index1, index2) ?? false;
+  }, [property]);
+  return {
+    length,
+    getInstanceAt,
+    addInstance,
+    addInstanceAt,
+    removeInstance,
+    removeInstanceAt,
+    swap,
+    error
+  };
+}
+//# sourceMappingURL=useRiveList.js.map

package/lib/module/hooks/useRiveList.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useState","useMemo","useRiveList","path","viewModelInstance","error","setError","revision","setRevision","property","undefined","listProperty","Error","removeListener","addListener","r","removeListeners","dispose","length","getInstanceAt","index","addInstance","instance","addInstanceAt","removeInstance","removeInstanceAt","swap","index1","index2"],"sourceRoot":"../../../src","sources":["hooks/useRiveList.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useRiveProperty.js

@@ -43,27 +43,21 @@ export function useRiveProperty(viewModelInstance, path, options) {
 
     // If an override callback is provided, use it.
     // Otherwise, use the default callback.
-    if (options.onPropertyEventOverride) {
-      property.addListener(options.onPropertyEventOverride);
-    } else {
-      property.addListener(newValue => {
-        setValue(newValue);
-      });
-    }
-
-    // Cleanup: Remove listeners and dispose of the property
-    // This ensures proper cleanup of event listeners and resources
+    const removeListener = options.onPropertyEventOverride ? property.addListener(options.onPropertyEventOverride) : property.addListener(newValue => {
+      setValue(newValue);
+    });
     return () => {
-      property.removeListeners();
+      removeListener();
       property.dispose();
     };
   }, [options, property]);
 
   // Set the value of the property
-  const setPropertyValue = useCallback(newValue => {
+  const setPropertyValue = useCallback(valueOrUpdater => {
     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.`));
     } else {
+      const newValue = typeof valueOrUpdater === 'function' ? valueOrUpdater(property.value) : valueOrUpdater;
       property.value = newValue;
     }
   }, [property, path]);

package/lib/module/hooks/useRiveProperty.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useEffect","useState","useMemo","useRiveProperty","viewModelInstance","path","options","value","setValue","undefined","error","setError","property","getProperty","Error","onPropertyEventOverride","addListener","newValue","removeListeners","dispose","setPropertyValue"],"sourceRoot":"../../../src","sources":["hooks/useRiveProperty.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,QAAQ,OAAO;AAOjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7BC,iBAAuD,EACvDC,IAAY,EACZC,OAKC,EACiE;EAClE,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGP,QAAQ,CAAgBQ,SAAS,CAAC;EAC5D,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGV,QAAQ,CAAe,IAAI,CAAC;;EAEtD;EACAD,SAAS,CAAC,MAAM;IACdW,QAAQ,CAAC,IAAI,CAAC;EAChB,CAAC,EAAE,CAACN,IAAI,EAAED,iBAAiB,CAAC,CAAC;;EAE7B;EACA,MAAMQ,QAAQ,GAAGV,OAAO,CAAC,MAAM;IAC7B,IAAI,CAACE,iBAAiB,EAAE;IACxB,OAAOE,OAAO,CAACO,WAAW,CACxBT,iBAAiB,EACjBC,IACF,CAAC;EACH,CAAC,EAAE,CAACC,OAAO,EAAEF,iBAAiB,EAAEC,IAAI,CAAC,CAAC;;EAEtC;EACAL,SAAS,CAAC,MAAM;IACd,IAAII,iBAAiB,IAAI,CAACQ,QAAQ,EAAE;MAClCD,QAAQ,CACN,IAAIG,KAAK,CAAC,aAAaT,IAAI,uCAAuC,CACpE,CAAC;IACH;EACF,CAAC,EAAE,CAACD,iBAAiB,EAAEQ,QAAQ,EAAEP,IAAI,CAAC,CAAC;;EAEvC;EACAL,SAAS,CAAC,MAAM;IACd,IAAI,CAACY,QAAQ,EAAE;;IAEf;IACA;IACA,IAAIN,OAAO,CAACS,uBAAuB,EAAE;MACnCH,QAAQ,CAACI,WAAW,CAACV,OAAO,CAACS,uBAAuB,CAAC;IACvD,CAAC,MAAM;MACLH,QAAQ,CAACI,WAAW,CAAEC,QAAQ,IAAK;QACjCT,QAAQ,CAACS,QAAQ,CAAC;MACpB,CAAC,CAAC;IACJ;;IAEA;IACA;IACA,OAAO,MAAM;MACXL,QAAQ,CAACM,eAAe,CAAC,CAAC;MAC1BN,QAAQ,CAACO,OAAO,CAAC,CAAC;IACpB,CAAC;EACH,CAAC,EAAE,CAACb,OAAO,EAAEM,QAAQ,CAAC,CAAC;;EAEvB;EACA,MAAMQ,gBAAgB,GAAGrB,WAAW,CACjCkB,QAAW,IAAK;IACf,IAAI,CAACL,QAAQ,EAAE;MACbD,QAAQ,CACN,IAAIG,KAAK,CACP,kCAAkCT,IAAI,sGACxC,CACF,CAAC;IACH,CAAC,MAAM;MACLO,QAAQ,CAACL,KAAK,GAAGU,QAAQ;IAC3B;EACF,CAAC,EACD,CAACL,QAAQ,EAAEP,IAAI,CACjB,CAAC;EAED,OAAO,CAACE,KAAK,EAAEa,gBAAgB,EAAEV,KAAK,EAAEE,QAAQ,CAAiB;AACnE;;AAEA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["useCallback","useEffect","useState","useMemo","useRiveProperty","viewModelInstance","path","options","value","setValue","undefined","error","setError","property","getProperty","Error","removeListener","onPropertyEventOverride","addListener","newValue","dispose","setPropertyValue","valueOrUpdater"],"sourceRoot":"../../../src","sources":["hooks/useRiveProperty.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,QAAQ,OAAO;AAOjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7BC,iBAAuD,EACvDC,IAAY,EACZC,OAKC,EAMD;EACA,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGP,QAAQ,CAAgBQ,SAAS,CAAC;EAC5D,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGV,QAAQ,CAAe,IAAI,CAAC;;EAEtD;EACAD,SAAS,CAAC,MAAM;IACdW,QAAQ,CAAC,IAAI,CAAC;EAChB,CAAC,EAAE,CAACN,IAAI,EAAED,iBAAiB,CAAC,CAAC;;EAE7B;EACA,MAAMQ,QAAQ,GAAGV,OAAO,CAAC,MAAM;IAC7B,IAAI,CAACE,iBAAiB,EAAE;IACxB,OAAOE,OAAO,CAACO,WAAW,CACxBT,iBAAiB,EACjBC,IACF,CAAC;EACH,CAAC,EAAE,CAACC,OAAO,EAAEF,iBAAiB,EAAEC,IAAI,CAAC,CAAC;;EAEtC;EACAL,SAAS,CAAC,MAAM;IACd,IAAII,iBAAiB,IAAI,CAACQ,QAAQ,EAAE;MAClCD,QAAQ,CACN,IAAIG,KAAK,CAAC,aAAaT,IAAI,uCAAuC,CACpE,CAAC;IACH;EACF,CAAC,EAAE,CAACD,iBAAiB,EAAEQ,QAAQ,EAAEP,IAAI,CAAC,CAAC;;EAEvC;EACAL,SAAS,CAAC,MAAM;IACd,IAAI,CAACY,QAAQ,EAAE;;IAEf;IACA;IACA,MAAMG,cAAc,GAAGT,OAAO,CAACU,uBAAuB,GAClDJ,QAAQ,CAACK,WAAW,CAACX,OAAO,CAACU,uBAAuB,CAAC,GACrDJ,QAAQ,CAACK,WAAW,CAAEC,QAAQ,IAAK;MACjCV,QAAQ,CAACU,QAAQ,CAAC;IACpB,CAAC,CAAC;IAEN,OAAO,MAAM;MACXH,cAAc,CAAC,CAAC;MAChBH,QAAQ,CAACO,OAAO,CAAC,CAAC;IACpB,CAAC;EACH,CAAC,EAAE,CAACb,OAAO,EAAEM,QAAQ,CAAC,CAAC;;EAEvB;EACA,MAAMQ,gBAAgB,GAAGrB,WAAW,CACjCsB,cAAqD,IAAK;IACzD,IAAI,CAACT,QAAQ,EAAE;MACbD,QAAQ,CACN,IAAIG,KAAK,CACP,kCAAkCT,IAAI,sGACxC,CACF,CAAC;IACH,CAAC,MAAM;MACL,MAAMa,QAAQ,GACZ,OAAOG,cAAc,KAAK,UAAU,GAC/BA,cAAc,CACbT,QAAQ,CAACL,KACX,CAAC,GACDc,cAAc;MACpBT,QAAQ,CAACL,KAAK,GAAGW,QAAQ;IAC3B;EACF,CAAC,EACD,CAACN,QAAQ,EAAEP,IAAI,CACjB,CAAC;EAED,OAAO,CAACE,KAAK,EAAEa,gBAAgB,EAAEV,KAAK,EAAEE,QAAQ,CAAiB;AACnE;;AAEA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/module/hooks/useViewModelInstance.js

@@ -0,0 +1,139 @@
+"use strict";
+
+import { useMemo, useEffect, useRef } from 'react';
+import { callDispose } from "../core/callDispose.js";
+function isRiveViewRef(source) {
+  return source !== null && source !== undefined && 'getViewModelInstance' in source;
+}
+function isRiveFile(source) {
+  return source !== null && source !== undefined && 'defaultArtboardViewModel' in source;
+}
+function createInstance(source, name, useNew) {
+  if (!source) {
+    return {
+      instance: null,
+      needsDispose: false
+    };
+  }
+  if (isRiveViewRef(source)) {
+    const vmi = source.getViewModelInstance();
+    return {
+      instance: vmi ?? null,
+      needsDispose: false
+    };
+  }
+  if (isRiveFile(source)) {
+    const viewModel = source.defaultArtboardViewModel();
+    const vmi = viewModel?.createDefaultInstance();
+    return {
+      instance: vmi ?? null,
+      needsDispose: true
+    };
+  }
+
+  // ViewModel source
+  let vmi;
+  if (name) {
+    vmi = source.createInstanceByName(name);
+  } else if (useNew) {
+    vmi = source.createInstance();
+  } else {
+    vmi = source.createDefaultInstance();
+  }
+  return {
+    instance: vmi ?? null,
+    needsDispose: true
+  };
+}
+
+/**
+ * Hook for getting a ViewModelInstance from a RiveFile, ViewModel, or RiveViewRef.
+ *
+ * @param source - The RiveFile, ViewModel, or RiveViewRef to get an instance from
+ * @param params - Configuration for which instance to retrieve (only used with ViewModel)
+ * @returns The ViewModelInstance or null if not found
+ *
+ * @example
+ * ```tsx
+ * // From RiveFile (get default instance)
+ * const { riveFile } = useRiveFile(require('./animation.riv'));
+ * const instance = useViewModelInstance(riveFile);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // From RiveViewRef (get auto-bound instance)
+ * const { riveViewRef, setHybridRef } = useRive();
+ * const instance = useViewModelInstance(riveViewRef);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // From ViewModel
+ * const viewModel = file.viewModelByName('main');
+ * const instance = useViewModelInstance(viewModel);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Create a new blank instance from ViewModel
+ * const viewModel = file.viewModelByName('TodoItem');
+ * const newInstance = useViewModelInstance(viewModel, { useNew: true });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With required: true (throws if null, use with Error Boundary)
+ * const instance = useViewModelInstance(riveFile, { required: true });
+ * // instance is guaranteed to be non-null here
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With onInit to set initial values synchronously
+ * const instance = useViewModelInstance(riveFile, {
+ *   onInit: (vmi) => {
+ *     vmi.numberProperty('count').set(initialCount);
+ *     vmi.stringProperty('name').set(userName);
+ *   }
+ * });
+ * // Values are already set here
+ * ```
+ */
+
+export function useViewModelInstance(source, params) {
+  const name = params?.name;
+  const useNew = params?.useNew ?? false;
+  const required = params?.required ?? false;
+  const onInit = params?.onInit;
+  const prevInstanceRef = useRef(null);
+  const result = useMemo(() => {
+    const created = createInstance(source, name, useNew);
+    if (created.instance && onInit) {
+      onInit(created.instance);
+    }
+    return created;
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- onInit excluded intentionally
+  }, [source, name, useNew]);
+
+  // Dispose previous instance if it changed and needed disposal
+  if (prevInstanceRef.current && prevInstanceRef.current.instance !== result.instance && prevInstanceRef.current.needsDispose && prevInstanceRef.current.instance) {
+    callDispose(prevInstanceRef.current.instance);
+  }
+  prevInstanceRef.current = result;
+
+  // Cleanup on unmount
+  useEffect(() => {
+    return () => {
+      if (prevInstanceRef.current?.needsDispose && prevInstanceRef.current.instance) {
+        callDispose(prevInstanceRef.current.instance);
+        prevInstanceRef.current = null;
+      }
+    };
+  }, []);
+  if (required && result.instance === null) {
+    throw new Error('useViewModelInstance: Failed to get ViewModelInstance. ' + 'Ensure the source has a valid ViewModel and instance available.');
+  }
+  return result.instance;
+}
+//# sourceMappingURL=useViewModelInstance.js.map

package/lib/module/hooks/useViewModelInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useEffect","useRef","callDispose","isRiveViewRef","source","undefined","isRiveFile","createInstance","name","useNew","instance","needsDispose","vmi","getViewModelInstance","viewModel","defaultArtboardViewModel","createDefaultInstance","createInstanceByName","useViewModelInstance","params","required","onInit","prevInstanceRef","result","created","current","Error"],"sourceRoot":"../../../src","sources":["hooks/useViewModelInstance.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -23,6 +23,8 @@ export { useRiveBoolean } from "./hooks/useRiveBoolean.js";
 export { useRiveEnum } from "./hooks/useRiveEnum.js";
 export { useRiveColor } from "./hooks/useRiveColor.js";
 export { useRiveTrigger } from "./hooks/useRiveTrigger.js";
+export { useRiveList } from "./hooks/useRiveList.js";
+export { useViewModelInstance } from "./hooks/useViewModelInstance.js";
 export { useRiveFile } from "./hooks/useRiveFile.js";
 export { DataBindMode };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["DataBindMode","DataBindByName","constructor","name","byName","NitroRiveView","RiveView","Fit","Alignment","RiveFileFactory","RiveImages","RiveColor","RiveEventType","RiveErrorType","ArtboardByIndex","ArtboardByName","useRive","useRiveNumber","useRiveString","useRiveBoolean","useRiveEnum","useRiveColor","useRiveTrigger","useRiveFile"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AACA,SAIEA,YAAY,QAEP,2BAAwB;AAE/B,OAAO,MAAMC,cAAc,CAAoC;EAE7DC,WAAWA,CAACC,IAAY,EAAE;IACxB,IAAI,CAACC,MAAM,GAAGD,IAAI;EACpB;AACF;AAEA,SAASE,aAAa,QAAQ,kCAA+B;AAE7D,SAASC,QAAQ,QAA4B,oBAAiB;AAe9D,SAASC,GAAG,QAAQ,eAAY;AAChC,SAASC,SAAS,QAAQ,qBAAkB;AAC5C,SAASC,eAAe,QAAQ,oBAAiB;AACjD,SAASC,UAAU,QAAQ,sBAAmB;AAE9C,SAASC,SAAS,QAAQ,qBAAkB;AAC5C,SAAyBC,aAAa,QAAQ,kBAAe;AAC7D,SAAyBC,aAAa,QAAQ,kBAAe;AAC7D,SAASC,eAAe,EAAEC,cAAc,QAAQ,uBAAoB;AACpE,SAASC,OAAO,QAAQ,oBAAiB;AACzC,SAASC,aAAa,QAAQ,0BAAuB;AACrD,SAASC,aAAa,QAAQ,0BAAuB;AACrD,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,WAAW,QAAQ,wBAAqB;AACjD,SAASC,YAAY,QAAQ,yBAAsB;AACnD,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,WAAW,QAAQ,wBAAqB;AAEjD,SAASvB,YAAY","ignoreList":[]}
+{"version":3,"names":["DataBindMode","DataBindByName","constructor","name","byName","NitroRiveView","RiveView","Fit","Alignment","RiveFileFactory","RiveImages","RiveColor","RiveEventType","RiveErrorType","ArtboardByIndex","ArtboardByName","useRive","useRiveNumber","useRiveString","useRiveBoolean","useRiveEnum","useRiveColor","useRiveTrigger","useRiveList","useViewModelInstance","useRiveFile"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AACA,SAIEA,YAAY,QAEP,2BAAwB;AAE/B,OAAO,MAAMC,cAAc,CAAoC;EAE7DC,WAAWA,CAACC,IAAY,EAAE;IACxB,IAAI,CAACC,MAAM,GAAGD,IAAI;EACpB;AACF;AAEA,SAASE,aAAa,QAAQ,kCAA+B;AAE7D,SAASC,QAAQ,QAA4B,oBAAiB;AAgB9D,SAASC,GAAG,QAAQ,eAAY;AAChC,SAASC,SAAS,QAAQ,qBAAkB;AAC5C,SAASC,eAAe,QAAQ,oBAAiB;AACjD,SAASC,UAAU,QAAQ,sBAAmB;AAE9C,SAASC,SAAS,QAAQ,qBAAkB;AAC5C,SAAyBC,aAAa,QAAQ,kBAAe;AAC7D,SAAyBC,aAAa,QAAQ,kBAAe;AAC7D,SAASC,eAAe,EAAEC,cAAc,QAAQ,uBAAoB;AACpE,SAASC,OAAO,QAAQ,oBAAiB;AACzC,SAASC,aAAa,QAAQ,0BAAuB;AACrD,SAASC,aAAa,QAAQ,0BAAuB;AACrD,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,WAAW,QAAQ,wBAAqB;AACjD,SAASC,YAAY,QAAQ,yBAAsB;AACnD,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,WAAW,QAAQ,wBAAqB;AACjD,SAASC,oBAAoB,QAAQ,iCAA8B;AACnE,SAASC,WAAW,QAAQ,wBAAqB;AAGjD,SAASzB,YAAY","ignoreList":[]}

package/lib/typescript/src/hooks/useRiveColor.d.ts

@@ -1,6 +1,10 @@
 import type { ViewModelInstance } from '../specs/ViewModel.nitro';
-import { type UseRivePropertyResult } from '../types';
 import { RiveColor } from '../core/RiveColor';
+export interface UseRiveColorResult {
+    value: RiveColor | undefined;
+    setValue: (value: RiveColor | string) => void;
+    error: Error | null;
+}
 /**
  * Hook for interacting with color ViewModel instance properties.
  *
@@ -8,7 +12,5 @@ import { RiveColor } from '../core/RiveColor';
  * @param viewModelInstance - The ViewModelInstance containing the color property to operate on
  * @returns An object with the color value as RGBA, a setter function that accepts either RGBA or hex string, and an error if the property is not found
  */
-export declare function useRiveColor(path: string, viewModelInstance?: ViewModelInstance | null): UseRivePropertyResult<RiveColor> & {
-    setValue: (value: RiveColor | string) => void;
-};
+export declare function useRiveColor(path: string, viewModelInstance?: ViewModelInstance | null): UseRiveColorResult;
 //# sourceMappingURL=useRiveColor.d.ts.map

package/lib/typescript/src/hooks/useRiveColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRiveColor.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useRiveColor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAM9C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAC3C,qBAAqB,CAAC,SAAS,CAAC,GAAG;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC;CAC/C,CAqBA"}
+{"version":3,"file":"useRiveColor.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useRiveColor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAM9C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC;IAC9C,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAC3C,kBAAkB,CAqBpB"}

package/lib/typescript/src/hooks/useRiveList.d.ts

@@ -0,0 +1,11 @@
+import type { ViewModelInstance } from '../specs/ViewModel.nitro';
+import type { UseRiveListResult } from '../types';
+/**
+ * Hook for interacting with list ViewModel instance properties.
+ *
+ * @param path - The path to the list property
+ * @param viewModelInstance - The ViewModelInstance containing the list property
+ * @returns An object with list length, manipulation methods, and error state
+ */
+export declare function useRiveList(path: string, viewModelInstance?: ViewModelInstance | null): UseRiveListResult;
+//# sourceMappingURL=useRiveList.d.ts.map

package/lib/typescript/src/hooks/useRiveList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRiveList.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useRiveList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAC3C,iBAAiB,CA6FnB"}

package/lib/typescript/src/hooks/useRiveProperty.d.ts

@@ -18,5 +18,10 @@ export declare function useRiveProperty<P extends ViewModelProperty, T>(viewMode
     getProperty: (vm: ViewModelInstance, path: string) => P | undefined;
     /** Optional override callback for property events (mainly used by triggers) */
     onPropertyEventOverride?: (...args: any[]) => void;
-}): [T | undefined, (value: T) => void, Error | null, P | undefined];
+}): [
+    T | undefined,
+    (value: T | ((prevValue: T | undefined) => T)) => void,
+    Error | null,
+    P | undefined
+];
 //# sourceMappingURL=useRiveProperty.d.ts.map

package/lib/typescript/src/hooks/useRiveProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRiveProperty.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useRiveProperty.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,EAC5D,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EACvD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,4DAA4D;IAC5D,WAAW,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACpE,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACpD,GACA,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAkElE"}
+{"version":3,"file":"useRiveProperty.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useRiveProperty.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,EAC5D,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EACvD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,4DAA4D;IAC5D,WAAW,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACpE,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACpD,GACA;IACD,CAAC,GAAG,SAAS;IACb,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC,KAAK,IAAI;IACtD,KAAK,GAAG,IAAI;IACZ,CAAC,GAAG,SAAS;CACd,CAoEA"}

package/lib/typescript/src/hooks/useViewModelInstance.d.ts

@@ -0,0 +1,86 @@
+import type { ViewModel, ViewModelInstance } from '../specs/ViewModel.nitro';
+import type { RiveFile } from '../specs/RiveFile.nitro';
+import type { RiveViewRef } from '../index';
+export interface UseViewModelInstanceParams {
+    /**
+     * Get a specifically named instance from the ViewModel.
+     */
+    name?: string;
+    /**
+     * Create a new (blank) instance from the ViewModel.
+     */
+    useNew?: boolean;
+    /**
+     * If true, throws an error when the instance cannot be obtained.
+     * This is useful with Error Boundaries and ensures TypeScript knows
+     * the return value is non-null.
+     */
+    required?: boolean;
+    /**
+     * Called synchronously when a new instance is created, before the hook returns.
+     * Use this to set initial values that need to be available immediately.
+     * Note: This callback is excluded from deps - changing it won't recreate the instance.
+     */
+    onInit?: (instance: ViewModelInstance) => void;
+}
+type ViewModelSource = ViewModel | RiveFile | RiveViewRef;
+/**
+ * Hook for getting a ViewModelInstance from a RiveFile, ViewModel, or RiveViewRef.
+ *
+ * @param source - The RiveFile, ViewModel, or RiveViewRef to get an instance from
+ * @param params - Configuration for which instance to retrieve (only used with ViewModel)
+ * @returns The ViewModelInstance or null if not found
+ *
+ * @example
+ * ```tsx
+ * // From RiveFile (get default instance)
+ * const { riveFile } = useRiveFile(require('./animation.riv'));
+ * const instance = useViewModelInstance(riveFile);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // From RiveViewRef (get auto-bound instance)
+ * const { riveViewRef, setHybridRef } = useRive();
+ * const instance = useViewModelInstance(riveViewRef);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // From ViewModel
+ * const viewModel = file.viewModelByName('main');
+ * const instance = useViewModelInstance(viewModel);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Create a new blank instance from ViewModel
+ * const viewModel = file.viewModelByName('TodoItem');
+ * const newInstance = useViewModelInstance(viewModel, { useNew: true });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With required: true (throws if null, use with Error Boundary)
+ * const instance = useViewModelInstance(riveFile, { required: true });
+ * // instance is guaranteed to be non-null here
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With onInit to set initial values synchronously
+ * const instance = useViewModelInstance(riveFile, {
+ *   onInit: (vmi) => {
+ *     vmi.numberProperty('count').set(initialCount);
+ *     vmi.stringProperty('name').set(userName);
+ *   }
+ * });
+ * // Values are already set here
+ * ```
+ */
+export declare function useViewModelInstance(source: ViewModelSource, params: UseViewModelInstanceParams & {
+    required: true;
+}): ViewModelInstance;
+export declare function useViewModelInstance(source: ViewModelSource | null, params?: UseViewModelInstanceParams): ViewModelInstance | null;
+export {};
+//# sourceMappingURL=useViewModelInstance.d.ts.map