@rive-app/react-native 0.1.1-beta.0

package/lib/module/core/RiveColor.js

@@ -0,0 +1,90 @@
+"use strict";
+
+/* eslint-disable no-bitwise */
+
+/**
+ * Represents a color in RGBA format for use with Rive color data binding.
+ * Each channel (r, g, b, a) is represented as a number between 0-255.
+ */
+export class RiveColor {
+  /**
+   * Creates a new RiveColor instance.
+   * @param r - Red channel (0-255)
+   * @param g - Green channel (0-255)
+   * @param b - Blue channel (0-255)
+   * @param a - Alpha channel (0-255, where 255 is fully opaque)
+   */
+  constructor(r, g, b, a) {
+    this.r = r;
+    this.g = g;
+    this.b = b;
+    this.a = a;
+  }
+
+  /**
+   * Compares this color with another RiveColor instance.
+   * @param other - The RiveColor to compare with
+   * @returns true if the colors are equal, false otherwise
+   */
+  equals(other) {
+    if (!other) return false;
+    return this.r === other.r && this.g === other.g && this.b === other.b && this.a === other.a;
+  }
+
+  /**
+   * Creates a RiveColor instance from a hex color string.
+   * Supports both 6-digit (#RRGGBB) and 8-digit (#RRGGBBAA) formats.
+   * @param color - Hex color string (e.g., '#FF0000' or '#FF000080')
+   * @returns A new RiveColor instance
+   * @throws Will return black (0,0,0,255) with a warning if the hex string is invalid
+   */
+  static fromHexString(color) {
+    const hex = color.replace(/^#/, '');
+    const isValidHex = /^[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/.test(hex);
+    if (!isValidHex) {
+      console.warn(`Rive invalid hex color: ${color}`);
+      return new RiveColor(0, 0, 0, 255);
+    }
+    let r = parseInt(hex.slice(0, 2), 16),
+      g = parseInt(hex.slice(2, 4), 16),
+      b = parseInt(hex.slice(4, 6), 16),
+      a = 255;
+
+    // Optionally parse alpha channel if present
+    if (hex.length === 8) {
+      a = parseInt(hex.slice(6, 8), 16);
+    }
+    return new RiveColor(r, g, b, a);
+  }
+
+  /**
+   * Creates a RiveColor instance from a 32-bit integer.
+   * The integer should be in ARGB format where:
+   * - Bits 24-31: Alpha channel
+   * - Bits 16-23: Red channel
+   * - Bits 8-15: Green channel
+   * - Bits 0-7: Blue channel
+   * @param colorValue - 32-bit integer representing the color
+   * @returns A new RiveColor instance
+   */
+  static fromInt(colorValue) {
+    const a = colorValue >> 24 & 0xff;
+    const r = colorValue >> 16 & 0xff;
+    const g = colorValue >> 8 & 0xff;
+    const b = colorValue & 0xff;
+    return new RiveColor(r, g, b, a);
+  }
+
+  /**
+   * Converts this color to a 32-bit integer in ARGB format.
+   * @returns A 32-bit integer where:
+   * - Bits 24-31: Alpha channel
+   * - Bits 16-23: Red channel
+   * - Bits 8-15: Green channel
+   * - Bits 0-7: Blue channel
+   */
+  toInt() {
+    return (this.a & 0xff) << 24 | (this.r & 0xff) << 16 | (this.g & 0xff) << 8 | this.b & 0xff;
+  }
+}
+//# sourceMappingURL=RiveColor.js.map

package/lib/module/core/RiveColor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RiveColor","constructor","r","g","b","a","equals","other","fromHexString","color","hex","replace","isValidHex","test","console","warn","parseInt","slice","length","fromInt","colorValue","toInt"],"sourceRoot":"../../../src","sources":["core/RiveColor.ts"],"mappings":";;AAAA;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMA,SAAS,CAAC;EACrB;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CACOC,CAAS,EACTC,CAAS,EACTC,CAAS,EACTC,CAAS,EACzB;IAAA,KAJgBH,CAAS,GAATA,CAAS;IAAA,KACTC,CAAS,GAATA,CAAS;IAAA,KACTC,CAAS,GAATA,CAAS;IAAA,KACTC,CAAS,GAATA,CAAS;EACxB;;EAEH;AACF;AACA;AACA;AACA;EACEC,MAAMA,CAACC,KAA4B,EAAW;IAC5C,IAAI,CAACA,KAAK,EAAE,OAAO,KAAK;IACxB,OACE,IAAI,CAACL,CAAC,KAAKK,KAAK,CAACL,CAAC,IAClB,IAAI,CAACC,CAAC,KAAKI,KAAK,CAACJ,CAAC,IAClB,IAAI,CAACC,CAAC,KAAKG,KAAK,CAACH,CAAC,IAClB,IAAI,CAACC,CAAC,KAAKE,KAAK,CAACF,CAAC;EAEtB;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACE,OAAOG,aAAaA,CAACC,KAAa,EAAa;IAC7C,MAAMC,GAAG,GAAGD,KAAK,CAACE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IAEnC,MAAMC,UAAU,GAAG,mCAAmC,CAACC,IAAI,CAACH,GAAG,CAAC;IAChE,IAAI,CAACE,UAAU,EAAE;MACfE,OAAO,CAACC,IAAI,CAAC,2BAA2BN,KAAK,EAAE,CAAC;MAChD,OAAO,IAAIT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;IACpC;IAEA,IAAIE,CAAC,GAAGc,QAAQ,CAACN,GAAG,CAACO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;MACnCd,CAAC,GAAGa,QAAQ,CAACN,GAAG,CAACO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;MACjCb,CAAC,GAAGY,QAAQ,CAACN,GAAG,CAACO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;MACjCZ,CAAC,GAAG,GAAG;;IAET;IACA,IAAIK,GAAG,CAACQ,MAAM,KAAK,CAAC,EAAE;MACpBb,CAAC,GAAGW,QAAQ,CAACN,GAAG,CAACO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACnC;IAEA,OAAO,IAAIjB,SAAS,CAACE,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,CAAC;EAClC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOc,OAAOA,CAACC,UAAkB,EAAa;IAC5C,MAAMf,CAAC,GAAIe,UAAU,IAAI,EAAE,GAAI,IAAI;IACnC,MAAMlB,CAAC,GAAIkB,UAAU,IAAI,EAAE,GAAI,IAAI;IACnC,MAAMjB,CAAC,GAAIiB,UAAU,IAAI,CAAC,GAAI,IAAI;IAClC,MAAMhB,CAAC,GAAGgB,UAAU,GAAG,IAAI;IAC3B,OAAO,IAAIpB,SAAS,CAACE,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,CAAC;EAClC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEgB,KAAKA,CAAA,EAAW;IACd,OACG,CAAC,IAAI,CAAChB,CAAC,GAAG,IAAI,KAAK,EAAE,GACrB,CAAC,IAAI,CAACH,CAAC,GAAG,IAAI,KAAK,EAAG,GACtB,CAAC,IAAI,CAACC,CAAC,GAAG,IAAI,KAAK,CAAE,GACrB,IAAI,CAACC,CAAC,GAAG,IAAK;EAEnB;AACF","ignoreList":[]}

package/lib/module/core/RiveFile.js

@@ -0,0 +1,64 @@
+"use strict";
+
+import { NitroModules } from 'react-native-nitro-modules';
+import { Image } from 'react-native';
+const RiveFileInternal = NitroModules.createHybridObject('RiveFileFactory');
+
+/**
+ * Factory namespace for creating RiveFile instances from different sources.
+ * Provides static methods to load Rive files from URLs, resources, or raw bytes.
+ */
+export let RiveFileFactory;
+(function (_RiveFileFactory) {
+  async function fromURL(url, referencedAssets, loadCdn = true) {
+    return RiveFileInternal.fromURL(url, loadCdn, referencedAssets ? {
+      data: referencedAssets
+    } : undefined);
+  }
+  _RiveFileFactory.fromURL = fromURL;
+  async function fromFileURL(fileURL, referencedAssets = undefined, loadCdn = true) {
+    return RiveFileInternal.fromFileURL(fileURL, loadCdn, referencedAssets ? {
+      data: referencedAssets
+    } : undefined);
+  }
+  _RiveFileFactory.fromFileURL = fromFileURL;
+  async function fromResource(resource, referencedAssets, loadCdn = true) {
+    return RiveFileInternal.fromResource(resource, loadCdn, referencedAssets ? {
+      data: referencedAssets
+    } : undefined);
+  }
+  _RiveFileFactory.fromResource = fromResource;
+  async function fromBytes(bytes, referencedAssets, loadCdn = true) {
+    return RiveFileInternal.fromBytes(bytes, loadCdn, referencedAssets ? {
+      data: referencedAssets
+    } : undefined);
+  }
+  _RiveFileFactory.fromBytes = fromBytes;
+  async function fromSource(source, referencedAssets, loadCdn = true) {
+    const assetID = typeof source === 'number' ? source : null;
+    const sourceURI = typeof source === 'object' ? source.uri : null;
+    const assetURI = assetID ? Image.resolveAssetSource(assetID)?.uri : sourceURI;
+    if (!assetURI) {
+      throw new Error(`Invalid source provided, ${source} is not a valid asset ID or URI`);
+    }
+    try {
+      // handle http address and dev server
+      if (assetURI.match(/https?:\/\//)) {
+        return RiveFileFactory.fromURL(assetURI, referencedAssets, loadCdn);
+      }
+
+      // handle iOS bundled asset
+      if (assetURI.match(/file:\/\//)) {
+        return RiveFileFactory.fromFileURL(assetURI, referencedAssets, loadCdn);
+      }
+
+      // handle Android bundled asset or resource name uri
+      return RiveFileFactory.fromResource(assetURI, referencedAssets, loadCdn);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to load Rive file from source: ${errorMessage}`);
+    }
+  }
+  _RiveFileFactory.fromSource = fromSource;
+})(RiveFileFactory || (RiveFileFactory = {}));
+//# sourceMappingURL=RiveFile.js.map

package/lib/module/core/RiveFile.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NitroModules","Image","RiveFileInternal","createHybridObject","RiveFileFactory","_RiveFileFactory","fromURL","url","referencedAssets","loadCdn","data","undefined","fromFileURL","fileURL","fromResource","resource","fromBytes","bytes","fromSource","source","assetID","sourceURI","uri","assetURI","resolveAssetSource","Error","match","error","errorMessage","message","String"],"sourceRoot":"../../../src","sources":["core/RiveFile.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAMzD,SAASC,KAAK,QAAQ,cAAc;AAGpC,MAAMC,gBAAgB,GACpBF,YAAY,CAACG,kBAAkB,CAA0B,iBAAiB,CAAC;;AAE7E;AACA;AACA;AACA;AAHA,WAIiBC,eAAe;AAAA,WAAAC,gBAAA;EAOvB,eAAeC,OAAOA,CAC3BC,GAAW,EACXC,gBAAsD,EACtDC,OAAgB,GAAG,IAAI,EACJ;IACnB,OAAOP,gBAAgB,CAACI,OAAO,CAC7BC,GAAG,EACHE,OAAO,EACPD,gBAAgB,GAAG;MAAEE,IAAI,EAAEF;IAAiB,CAAC,GAAGG,SAClD,CAAC;EACH;EAACN,gBAAA,CAAAC,OAAA,GAAAA,OAAA;EAQM,eAAeM,WAAWA,CAC/BC,OAAe,EACfL,gBAAsD,GAAGG,SAAS,EAClEF,OAAgB,GAAG,IAAI,EACJ;IACnB,OAAOP,gBAAgB,CAACU,WAAW,CACjCC,OAAO,EACPJ,OAAO,EACPD,gBAAgB,GAAG;MAAEE,IAAI,EAAEF;IAAiB,CAAC,GAAGG,SAClD,CAAC;EACH;EAACN,gBAAA,CAAAO,WAAA,GAAAA,WAAA;EAQM,eAAeE,YAAYA,CAChCC,QAAgB,EAChBP,gBAAsD,EACtDC,OAAgB,GAAG,IAAI,EACJ;IACnB,OAAOP,gBAAgB,CAACY,YAAY,CAClCC,QAAQ,EACRN,OAAO,EACPD,gBAAgB,GAAG;MAAEE,IAAI,EAAEF;IAAiB,CAAC,GAAGG,SAClD,CAAC;EACH;EAACN,gBAAA,CAAAS,YAAA,GAAAA,YAAA;EAQM,eAAeE,SAASA,CAC7BC,KAAkB,EAClBT,gBAAsD,EACtDC,OAAgB,GAAG,IAAI,EACJ;IACnB,OAAOP,gBAAgB,CAACc,SAAS,CAC/BC,KAAK,EACLR,OAAO,EACPD,gBAAgB,GAAG;MAAEE,IAAI,EAAEF;IAAiB,CAAC,GAAGG,SAClD,CAAC;EACH;EAACN,gBAAA,CAAAW,SAAA,GAAAA,SAAA;EAwBM,eAAeE,UAAUA,CAC9BC,MAAgC,EAChCX,gBAAsD,EACtDC,OAAgB,GAAG,IAAI,EACJ;IACnB,MAAMW,OAAO,GAAG,OAAOD,MAAM,KAAK,QAAQ,GAAGA,MAAM,GAAG,IAAI;IAC1D,MAAME,SAAS,GAAG,OAAOF,MAAM,KAAK,QAAQ,GAAGA,MAAM,CAACG,GAAG,GAAG,IAAI;IAEhE,MAAMC,QAAQ,GAAGH,OAAO,GACpBnB,KAAK,CAACuB,kBAAkB,CAACJ,OAAO,CAAC,EAAEE,GAAG,GACtCD,SAAS;IAEb,IAAI,CAACE,QAAQ,EAAE;MACb,MAAM,IAAIE,KAAK,CACb,4BAA4BN,MAAM,iCACpC,CAAC;IACH;IAEA,IAAI;MACF;MACA,IAAII,QAAQ,CAACG,KAAK,CAAC,aAAa,CAAC,EAAE;QACjC,OAAOtB,eAAe,CAACE,OAAO,CAACiB,QAAQ,EAAEf,gBAAgB,EAAEC,OAAO,CAAC;MACrE;;MAEA;MACA,IAAIc,QAAQ,CAACG,KAAK,CAAC,WAAW,CAAC,EAAE;QAC/B,OAAOtB,eAAe,CAACQ,WAAW,CAACW,QAAQ,EAAEf,gBAAgB,EAAEC,OAAO,CAAC;MACzE;;MAEA;MACA,OAAOL,eAAe,CAACU,YAAY,CAACS,QAAQ,EAAEf,gBAAgB,EAAEC,OAAO,CAAC;IAC1E,CAAC,CAAC,OAAOkB,KAAc,EAAE;MACvB,MAAMC,YAAY,GAChBD,KAAK,YAAYF,KAAK,GAAGE,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC;MACxD,MAAM,IAAIF,KAAK,CAAC,yCAAyCG,YAAY,EAAE,CAAC;IAC1E;EACF;EAACvB,gBAAA,CAAAa,UAAA,GAAAA,UAAA;AAAA,GAnIcd,eAAe,KAAfA,eAAe","ignoreList":[]}

package/lib/module/core/RiveImages.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { NitroModules } from 'react-native-nitro-modules';
+export const RiveImages = NitroModules.createHybridObject('RiveImageFactory');
+//# sourceMappingURL=RiveImages.js.map

package/lib/module/core/RiveImages.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NitroModules","RiveImages","createHybridObject"],"sourceRoot":"../../../src","sources":["core/RiveImages.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAGzD,OAAO,MAAMC,UAAU,GACrBD,YAAY,CAACE,kBAAkB,CAAmB,kBAAkB,CAAC","ignoreList":[]}

package/lib/module/core/RiveView.js

@@ -0,0 +1,51 @@
+"use strict";
+
+import { NitroRiveView } from "./NitroRiveViewComponent.js";
+import { RiveErrorType } from "./Errors.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const defaultOnError = error => console.error(`[${RiveErrorType[error.type]}] ${error.message}`);
+
+/**
+ * RiveView is a React Native component that renders Rive graphics.
+ * It provides a seamless way to display and control Rive graphics in your app.
+ *
+ * @example
+ * ```tsx
+ * <RiveView
+ *   file={riveFile}
+ *   artboardName="New Artboard"
+ *   stateMachineName="State Machine 1"
+ *   autoPlay={true}
+ *   fit={Fit.Contain}
+ *   style={styles.riveContainer}
+ * />
+ * ```
+ *
+ * @property {RiveFile} file - The Rive file to be displayed
+ * @property {string} [artboardName] - Name of the artboard to display from the Rive file
+ * @property {string} [stateMachineName] - Name of the state machine to play
+ * @property {ViewModelInstance | DataBindMode | DataBindByName} [dataBind] - Data binding configuration for the state machine, defaults to DataBindMode.Auto
+ * @property {boolean} [autoPlay=true] - Whether to automatically start playing the state machine
+ * @property {Alignment} [alignment] - How the Rive graphic should be aligned within its container
+ * @property {Fit} [fit] - How the Rive graphic should fit within its container
+ * @property {Object} [style] - React Native style object for container customization
+ * @property {(error: RiveError) => void} [onError] - Callback function that is called when an error occurs
+ *
+ * The component also exposes methods for controlling playback:
+ * - play(): Starts playing the Rive graphic
+ * - pause(): Pauses the Rive graphic
+ */
+export function RiveView(props) {
+  const {
+    onError,
+    ...rest
+  } = props;
+  const wrappedOnError = onError ?? defaultOnError;
+  return /*#__PURE__*/_jsx(NitroRiveView, {
+    ...rest,
+    onError: {
+      f: wrappedOnError
+    }
+  });
+}
+//# sourceMappingURL=RiveView.js.map

package/lib/module/core/RiveView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NitroRiveView","RiveErrorType","jsx","_jsx","defaultOnError","error","console","type","message","RiveView","props","onError","rest","wrappedOnError","f"],"sourceRoot":"../../../src","sources":["core/RiveView.tsx"],"mappings":";;AACA,SAASA,aAAa,QAAQ,6BAA0B;AACxD,SAASC,aAAa,QAAwB,aAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAOzD,MAAMC,cAAc,GAAIC,KAAgB,IACtCC,OAAO,CAACD,KAAK,CAAC,IAAIJ,aAAa,CAACI,KAAK,CAACE,IAAI,CAAC,KAAKF,KAAK,CAACG,OAAO,EAAE,CAAC;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAACC,KAAoB,EAAE;EAC7C,MAAM;IAAEC,OAAO;IAAE,GAAGC;EAAK,CAAC,GAAGF,KAAK;EAClC,MAAMG,cAAc,GAAGF,OAAO,IAAIP,cAAc;EAEhD,oBAAOD,IAAA,CAACH,aAAa;IAAA,GAAKY,IAAI;IAAED,OAAO,EAAE;MAAEG,CAAC,EAAED;IAAe;EAAE,CAAE,CAAC;AACpE","ignoreList":[]}

package/lib/module/core/callDispose.js

@@ -0,0 +1,15 @@
+"use strict";
+
+const NITRO_DISPOSE_ERROR = 'failed to define internal native state property';
+/** Safely calls dispose(), ignoring errors from https://github.com/mrousavy/nitro/issues/1083 */
+export function callDispose(obj) {
+  try {
+    obj.dispose();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error ?? '');
+    if (!message.includes(NITRO_DISPOSE_ERROR)) {
+      throw error;
+    }
+  }
+}
+//# sourceMappingURL=callDispose.js.map

package/lib/module/core/callDispose.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NITRO_DISPOSE_ERROR","callDispose","obj","dispose","error","message","Error","String","includes"],"sourceRoot":"../../../src","sources":["core/callDispose.ts"],"mappings":";;AAAA,MAAMA,mBAAmB,GAAG,iDAAiD;AAM7E;AACA,OAAO,SAASC,WAAWA,CAACC,GAAe,EAAQ;EACjD,IAAI;IACFA,GAAG,CAACC,OAAO,CAAC,CAAC;EACf,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,MAAMC,OAAO,GACXD,KAAK,YAAYE,KAAK,GAAGF,KAAK,CAACC,OAAO,GAAGE,MAAM,CAACH,KAAK,IAAI,EAAE,CAAC;IAC9D,IAAI,CAACC,OAAO,CAACG,QAAQ,CAACR,mBAAmB,CAAC,EAAE;MAC1C,MAAMI,KAAK;IACb;EACF;AACF","ignoreList":[]}

package/lib/module/hooks/useRive.js

@@ -0,0 +1,51 @@
+"use strict";
+
+import { useRef, useCallback, useState } from 'react';
+export function useRive() {
+  const riveRef = useRef(null);
+  const [riveViewRef, setRiveViewRef] = useState(null);
+  const timeoutRef = useRef(null);
+  const setRef = useCallback(node => {
+    if (riveRef.current !== node) {
+      riveRef.current = node;
+
+      // Clear any existing timeout
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+      }
+      const timeout = new Promise((_, reject) => {
+        timeoutRef.current = setTimeout(() => {
+          reject(new Error('Rive view ready timeout'));
+        }, 5000);
+      });
+
+      // TODO: Need to clear out the awaitViewReady promise if it times out
+      // or add this timeout natively and return false
+      Promise.race([node?.awaitViewReady(), timeout]).then(result => {
+        if (result === true) {
+          setRiveViewRef(node);
+        } else {
+          console.warn('Rive view ready check returned false');
+          setRiveViewRef(null);
+        }
+      }).catch(error => {
+        console.warn('Failed to initialize Rive view:', error);
+        setRiveViewRef(null);
+      }).finally(() => {
+        // Clear the timeout in both success and error cases
+        if (timeoutRef.current) {
+          clearTimeout(timeoutRef.current);
+          timeoutRef.current = null;
+        }
+      });
+    }
+  }, []);
+  return {
+    riveRef,
+    riveViewRef,
+    setHybridRef: {
+      f: setRef
+    }
+  };
+}
+//# sourceMappingURL=useRive.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useRef","useCallback","useState","useRive","riveRef","riveViewRef","setRiveViewRef","timeoutRef","setRef","node","current","clearTimeout","timeout","Promise","_","reject","setTimeout","Error","race","awaitViewReady","then","result","console","warn","catch","error","finally","setHybridRef","f"],"sourceRoot":"../../../src","sources":["hooks/useRive.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,WAAW,EAAEC,QAAQ,QAAQ,OAAO;AAGrD,OAAO,SAASC,OAAOA,CAAA,EAAG;EACxB,MAAMC,OAAO,GAAGJ,MAAM,CAAc,IAAI,CAAC;EACzC,MAAM,CAACK,WAAW,EAAEC,cAAc,CAAC,GAAGJ,QAAQ,CAAqB,IAAI,CAAC;EACxE,MAAMK,UAAU,GAAGP,MAAM,CAAuC,IAAI,CAAC;EAErE,MAAMQ,MAAM,GAAGP,WAAW,CAAEQ,IAAwB,IAAK;IACvD,IAAIL,OAAO,CAACM,OAAO,KAAKD,IAAI,EAAE;MAC5BL,OAAO,CAACM,OAAO,GAAGD,IAAI;;MAEtB;MACA,IAAIF,UAAU,CAACG,OAAO,EAAE;QACtBC,YAAY,CAACJ,UAAU,CAACG,OAAO,CAAC;MAClC;MAEA,MAAME,OAAO,GAAG,IAAIC,OAAO,CAAC,CAACC,CAAC,EAAEC,MAAM,KAAK;QACzCR,UAAU,CAACG,OAAO,GAAGM,UAAU,CAAC,MAAM;UACpCD,MAAM,CAAC,IAAIE,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC9C,CAAC,EAAE,IAAI,CAAC;MACV,CAAC,CAAC;;MAEF;MACA;MACAJ,OAAO,CAACK,IAAI,CAAC,CAACT,IAAI,EAAEU,cAAc,CAAC,CAAC,EAAEP,OAAO,CAAC,CAAC,CAC5CQ,IAAI,CAAEC,MAAM,IAAK;QAChB,IAAIA,MAAM,KAAK,IAAI,EAAE;UACnBf,cAAc,CAACG,IAAI,CAAC;QACtB,CAAC,MAAM;UACLa,OAAO,CAACC,IAAI,CAAC,sCAAsC,CAAC;UACpDjB,cAAc,CAAC,IAAI,CAAC;QACtB;MACF,CAAC,CAAC,CACDkB,KAAK,CAAEC,KAAK,IAAK;QAChBH,OAAO,CAACC,IAAI,CAAC,iCAAiC,EAAEE,KAAK,CAAC;QACtDnB,cAAc,CAAC,IAAI,CAAC;MACtB,CAAC,CAAC,CACDoB,OAAO,CAAC,MAAM;QACb;QACA,IAAInB,UAAU,CAACG,OAAO,EAAE;UACtBC,YAAY,CAACJ,UAAU,CAACG,OAAO,CAAC;UAChCH,UAAU,CAACG,OAAO,GAAG,IAAI;QAC3B;MACF,CAAC,CAAC;IACN;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLN,OAAO;IACPC,WAAW;IACXsB,YAAY,EAAE;MACZC,CAAC,EAAEpB;IACL;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/hooks/useRiveBoolean.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { useRiveProperty } from "./useRiveProperty.js";
+const BOOLEAN_PROPERTY_OPTIONS = {
+  getProperty: (vmi, p) => vmi.booleanProperty(p)
+};
+
+/**
+ * Hook for interacting with boolean ViewModel instance properties.
+ *
+ * @param path - The path to the boolean property
+ * @param viewModelInstance - The ViewModelInstance containing the boolean property to operate on
+ * @returns An object with the boolean value, a setter function, and an error if the property is not found
+ */
+export function useRiveBoolean(path, viewModelInstance) {
+  const [value, setValue, error] = useRiveProperty(viewModelInstance, path, BOOLEAN_PROPERTY_OPTIONS);
+  return {
+    value,
+    setValue,
+    error
+  };
+}
+//# sourceMappingURL=useRiveBoolean.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useRiveProperty","BOOLEAN_PROPERTY_OPTIONS","getProperty","vmi","p","booleanProperty","useRiveBoolean","path","viewModelInstance","value","setValue","error"],"sourceRoot":"../../../src","sources":["hooks/useRiveBoolean.ts"],"mappings":";;AAKA,SAASA,eAAe,QAAQ,sBAAmB;AAEnD,MAAMC,wBAAwB,GAAG;EAC/BC,WAAW,EAAEA,CAACC,GAAsB,EAAEC,CAAS,KAAKD,GAAG,CAACE,eAAe,CAACD,CAAC;AAC3E,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,cAAcA,CAC5BC,IAAY,EACZC,iBAA4C,EACZ;EAChC,MAAM,CAACC,KAAK,EAAEC,QAAQ,EAAEC,KAAK,CAAC,GAAGX,eAAe,CAG9CQ,iBAAiB,EAAED,IAAI,EAAEN,wBAAwB,CAAC;EACpD,OAAO;IAAEQ,KAAK;IAAEC,QAAQ;IAAEC;EAAM,CAAC;AACnC","ignoreList":[]}

package/lib/module/hooks/useRiveColor.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { useRiveProperty } from "./useRiveProperty.js";
+import { RiveColor } from "../core/RiveColor.js";
+const COLOR_PROPERTY_OPTIONS = {
+  getProperty: (vmi, p) => vmi.colorProperty(p)
+};
+
+/**
+ * Hook for interacting with color ViewModel instance properties.
+ *
+ * @param path - The path to the color property
+ * @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 function useRiveColor(path, viewModelInstance) {
+  const [rawValue, setRawValue, error] = useRiveProperty(viewModelInstance, path, COLOR_PROPERTY_OPTIONS);
+  const value = rawValue !== undefined ? RiveColor.fromInt(rawValue) : undefined;
+  const setValue = useCallback(newValue => {
+    const color = typeof newValue === 'string' ? RiveColor.fromHexString(newValue) : newValue;
+    setRawValue(color.toInt());
+  }, [setRawValue]);
+  return {
+    value,
+    setValue,
+    error
+  };
+}
+//# sourceMappingURL=useRiveColor.js.map

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

@@ -0,0 +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":[]}

package/lib/module/hooks/useRiveEnum.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { useRiveProperty } from "./useRiveProperty.js";
+
+/**
+ * Hook for interacting with enum ViewModel instance properties.
+ *
+ * @param path - The path to the enum property
+ * @param viewModelInstance - The ViewModelInstance containing the enum property to operate on
+ * @returns An object with the enum value, a setter function, and an error if the property is not found
+ */
+export function useRiveEnum(path, viewModelInstance) {
+  const [value, setValue, error] = useRiveProperty(viewModelInstance, path, {
+    getProperty: useCallback((vmi, p) => vmi.enumProperty(p), [])
+  });
+  return {
+    value,
+    setValue,
+    error
+  };
+}
+//# sourceMappingURL=useRiveEnum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useRiveProperty","useRiveEnum","path","viewModelInstance","value","setValue","error","getProperty","vmi","p","enumProperty"],"sourceRoot":"../../../src","sources":["hooks/useRiveEnum.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AAMnC,SAASC,eAAe,QAAQ,sBAAmB;;AAEnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CACzBC,IAAY,EACZC,iBAA4C,EACb;EAC/B,MAAM,CAACC,KAAK,EAAEC,QAAQ,EAAEC,KAAK,CAAC,GAAGN,eAAe,CAG9CG,iBAAiB,EAAED,IAAI,EAAE;IACzBK,WAAW,EAAER,WAAW,CAAC,CAACS,GAAG,EAAEC,CAAC,KAAKD,GAAG,CAACE,YAAY,CAACD,CAAC,CAAC,EAAE,EAAE;EAC9D,CAAC,CAAC;EACF,OAAO;IAAEL,KAAK;IAAEC,QAAQ;IAAEC;EAAM,CAAC;AACnC","ignoreList":[]}

package/lib/module/hooks/useRiveFile.js

@@ -0,0 +1,128 @@
+"use strict";
+
+import { useState, useEffect, useMemo, useRef } from 'react';
+import { Image } from 'react-native';
+import { RiveFileFactory } from "../core/RiveFile.js";
+import { callDispose } from "../core/callDispose.js";
+function isRiveImage(value) {
+  return value !== null && typeof value === 'object' && '__type' in value && value.__type === 'HybridObject<RiveImage>';
+}
+function parsePossibleSources(asset) {
+  if (isRiveImage(asset)) {
+    return {
+      image: asset
+    };
+  }
+  const source = asset.source;
+  if (typeof source === 'number') {
+    const resolvedAsset = Image.resolveAssetSource(source);
+    if (resolvedAsset && resolvedAsset.uri) {
+      return {
+        sourceAssetId: resolvedAsset.uri
+      };
+    } else {
+      throw new Error('Invalid asset source provided.');
+    }
+  }
+  const uri = source.uri;
+  if (typeof source === 'object' && uri) {
+    return {
+      sourceUrl: uri
+    };
+  }
+  const fileName = source.fileName;
+  const path = source.path;
+  if (typeof source === 'object' && fileName) {
+    const result = {
+      sourceAsset: fileName
+    };
+    if (path) {
+      result.path = path;
+    }
+    return result;
+  }
+  throw new Error('Invalid source provided.');
+}
+function transformFilesHandledMapping(mapping) {
+  const transformedMapping = {};
+  if (mapping === undefined) {
+    return undefined;
+  }
+  Object.entries(mapping).forEach(([key, asset]) => {
+    transformedMapping[key] = parsePossibleSources(asset);
+  });
+  return transformedMapping;
+}
+export function useRiveFile(input, options = {}) {
+  const [result, setResult] = useState({
+    riveFile: null,
+    isLoading: true,
+    error: null
+  });
+  const referencedAssets = useMemo(() => transformFilesHandledMapping(options.referencedAssets), [options.referencedAssets]);
+  const initialReferencedAssets = useRef(referencedAssets);
+  useEffect(() => {
+    let currentFile = null;
+    const loadRiveFile = async () => {
+      try {
+        const currentInput = input;
+        if (currentInput == null) {
+          setResult({
+            riveFile: null,
+            isLoading: false,
+            error: 'No Rive file input provided.'
+          });
+          return;
+        }
+        if (typeof currentInput === 'string') {
+          if (currentInput.startsWith('http://') || currentInput.startsWith('https://')) {
+            currentFile = await RiveFileFactory.fromURL(currentInput, initialReferencedAssets.current);
+          } else {
+            currentFile = await RiveFileFactory.fromResource(currentInput, initialReferencedAssets.current);
+          }
+        } else if (typeof currentInput === 'number' || 'uri' in currentInput) {
+          currentFile = await RiveFileFactory.fromSource(currentInput, initialReferencedAssets.current);
+        } else if (currentInput instanceof ArrayBuffer) {
+          currentFile = await RiveFileFactory.fromBytes(currentInput, initialReferencedAssets.current);
+        }
+        setResult({
+          riveFile: currentFile,
+          isLoading: false,
+          error: null
+        });
+      } catch (err) {
+        console.error(err);
+        setResult({
+          riveFile: null,
+          isLoading: false,
+          error: err instanceof Error ? err.message || 'Unknown error' : 'Failed to load Rive file'
+        });
+      }
+    };
+    loadRiveFile();
+    return () => {
+      if (currentFile) {
+        callDispose(currentFile);
+      }
+    };
+  }, [input]);
+  const {
+    riveFile
+  } = result;
+  useEffect(() => {
+    if (initialReferencedAssets.current !== referencedAssets) {
+      if (riveFile && referencedAssets) {
+        riveFile.updateReferencedAssets({
+          data: referencedAssets
+        });
+        initialReferencedAssets.current = referencedAssets;
+      }
+    }
+  }, [referencedAssets, riveFile]);
+  return {
+    riveFile: result.riveFile,
+    isLoading: result.isLoading,
+    error: result.error
+  };
+}
+//# sourceMappingURL=useRiveFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useEffect","useMemo","useRef","Image","RiveFileFactory","callDispose","isRiveImage","value","__type","parsePossibleSources","asset","image","source","resolvedAsset","resolveAssetSource","uri","sourceAssetId","Error","sourceUrl","fileName","path","result","sourceAsset","transformFilesHandledMapping","mapping","transformedMapping","undefined","Object","entries","forEach","key","useRiveFile","input","options","setResult","riveFile","isLoading","error","referencedAssets","initialReferencedAssets","currentFile","loadRiveFile","currentInput","startsWith","fromURL","current","fromResource","fromSource","ArrayBuffer","fromBytes","err","console","message","updateReferencedAssets","data"],"sourceRoot":"../../../src","sources":["hooks/useRiveFile.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useRiveNumber.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { useRiveProperty } from "./useRiveProperty.js";
+const NUMBER_PROPERTY_OPTIONS = {
+  getProperty: (vmi, p) => vmi.numberProperty(p)
+};
+
+/**
+ * Hook for interacting with number ViewModel instance properties.
+ *
+ * @param path - The path to the number property
+ * @param viewModelInstance - The ViewModelInstance containing the number property to operate on
+ * @returns An object with the number value, a setter function, and an error if the property is not found
+ */
+export function useRiveNumber(path, viewModelInstance) {
+  const [value, setValue, error] = useRiveProperty(viewModelInstance, path, NUMBER_PROPERTY_OPTIONS);
+  return {
+    value,
+    setValue,
+    error
+  };
+}
+//# sourceMappingURL=useRiveNumber.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useRiveProperty","NUMBER_PROPERTY_OPTIONS","getProperty","vmi","p","numberProperty","useRiveNumber","path","viewModelInstance","value","setValue","error"],"sourceRoot":"../../../src","sources":["hooks/useRiveNumber.ts"],"mappings":";;AAKA,SAASA,eAAe,QAAQ,sBAAmB;AAEnD,MAAMC,uBAAuB,GAAG;EAC9BC,WAAW,EAAEA,CAACC,GAAsB,EAAEC,CAAS,KAAKD,GAAG,CAACE,cAAc,CAACD,CAAC;AAC1E,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAC3BC,IAAY,EACZC,iBAA4C,EACb;EAC/B,MAAM,CAACC,KAAK,EAAEC,QAAQ,EAAEC,KAAK,CAAC,GAAGX,eAAe,CAG9CQ,iBAAiB,EAAED,IAAI,EAAEN,uBAAuB,CAAC;EACnD,OAAO;IAAEQ,KAAK;IAAEC,QAAQ;IAAEC;EAAM,CAAC;AACnC","ignoreList":[]}

package/lib/module/hooks/useRiveProperty.js

@@ -0,0 +1,79 @@
+"use strict";
+
+import { useCallback, useEffect, useState, useMemo } from 'react';
+/**
+ * Base hook for all ViewModelInstance property interactions.
+ * This hook provides a unified interface for working with different types of
+ * Rive properties (boolean, number, string, enum, trigger) while maintaining
+ * type safety and proper cleanup.
+ *
+ * @template P - The type of the property (e.g., ViewModelBooleanProperty, ViewModelNumberProperty)
+ * @template T - The primitive type of the property value (number, boolean, string)
+ *
+ * @param viewModelInstance - The source ViewModelInstance
+ * @param path - Property path in the ViewModelInstance
+ * @param options - Configuration for working with the property
+ * @returns A tuple containing [value, setter, error, property]
+ */
+export function useRiveProperty(viewModelInstance, path, options) {
+  const [value, setValue] = useState(undefined);
+  const [error, setError] = useState(null);
+
+  // Clear error when path or instance changes
+  useEffect(() => {
+    setError(null);
+  }, [path, viewModelInstance]);
+
+  // Get the property
+  const property = useMemo(() => {
+    if (!viewModelInstance) return;
+    return options.getProperty(viewModelInstance, path);
+  }, [options, viewModelInstance, path]);
+
+  // Set error if property is not found
+  useEffect(() => {
+    if (viewModelInstance && !property) {
+      setError(new Error(`Property "${path}" not found in the ViewModel instance`));
+    }
+  }, [viewModelInstance, property, path]);
+
+  // Add listener for changes to the property
+  useEffect(() => {
+    if (!property) return;
+
+    // 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
+    return () => {
+      property.removeListeners();
+      property.dispose();
+    };
+  }, [options, property]);
+
+  // Set the value of the property
+  const setPropertyValue = useCallback(newValue => {
+    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 {
+      property.value = newValue;
+    }
+  }, [property, path]);
+  return [value, setPropertyValue, error, property];
+}
+
+/**
+ * This interface extends the ViewModelProperty and ObservableProperty interfaces.
+ * It adds the addListener and value as known properties.
+ *
+ * @template T - The primitive type of the property value (number, boolean, string)
+ */
+//# sourceMappingURL=useRiveProperty.js.map