@rive-app/canvas 2.16.0 → 2.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/canvas",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Rive's canvas based web api.",
   "main": "rive.js",
   "homepage": "https://rive.app",

package/rive.d.ts

@@ -495,6 +495,27 @@ export declare class Rive {
      * @returns the inputs for the named state machine
      */
     stateMachineInputs(name: string): StateMachineInput[];
+    private retrieveInputAtPath;
+    /**
+     * Set the boolean input with the provided name at the given path with value
+     * @param input the state machine input name
+     * @param value the value to set the input to
+     * @param path the path the input is located at an artboard level
+     */
+    setBooleanStateAtPath(inputName: string, value: boolean, path: string): void;
+    /**
+     * Set the number input with the provided name at the given path with value
+     * @param input the state machine input name
+     * @param value the value to set the input to
+     * @param path the path the input is located at an artboard level
+     */
+    setNumberStateAtPath(inputName: string, value: number, path: string): void;
+    /**
+     * Fire the trigger with the provided name at the given path
+     * @param input the state machine input name
+     * @param path the path the input is located at an artboard level
+     */
+    fireStateAtPath(inputName: string, path: string): void;
     get playingStateMachineNames(): string[];
     get playingAnimationNames(): string[];
     get pausedAnimationNames(): string[];

package/rive.js

@@ -736,7 +736,7 @@ function Ya(a, b) {
     return Xa(c, a, b);
   }));
 }
-var Za, $a, db = {430204:(a, b, c, d, e) => {
+var Za, $a, db = {430252:(a, b, c, d, e) => {
   if ("undefined" === typeof window || void 0 === (window.AudioContext || window.webkitAudioContext)) {
     return 0;
   }
@@ -799,9 +799,9 @@ var Za, $a, db = {430204:(a, b, c, d, e) => {
   }
   window.h.Aa += 1;
   return 1;
-}, 432382:() => {
+}, 432430:() => {
   "undefined" !== typeof window.h && (--window.h.Aa, 0 === window.h.Aa && delete window.h);
-}, 432546:() => void 0 !== navigator.mediaDevices && void 0 !== navigator.mediaDevices.getUserMedia, 432650:() => {
+}, 432594:() => void 0 !== navigator.mediaDevices && void 0 !== navigator.mediaDevices.getUserMedia, 432698:() => {
   try {
     var a = new (window.AudioContext || window.webkitAudioContext)(), b = a.sampleRate;
     a.close();
@@ -809,7 +809,7 @@ var Za, $a, db = {430204:(a, b, c, d, e) => {
   } catch (c) {
     return 0;
   }
-}, 432821:(a, b, c, d, e, f) => {
+}, 432869:(a, b, c, d, e, f) => {
   if ("undefined" === typeof window.h) {
     return -1;
   }
@@ -855,7 +855,7 @@ var Za, $a, db = {430204:(a, b, c, d, e) => {
   a == window.h.H.ya && g.Z.connect(g.I.destination);
   g.pb = f;
   return window.h.yc(g);
-}, 435698:a => window.h.ra(a).I.sampleRate, 435771:a => {
+}, 435746:a => window.h.ra(a).I.sampleRate, 435819:a => {
   a = window.h.ra(a);
   void 0 !== a.Z && (a.Z.onaudioprocess = function() {
   }, a.Z.disconnect(), a.Z = void 0);
@@ -863,13 +863,13 @@ var Za, $a, db = {430204:(a, b, c, d, e) => {
   a.I.close();
   a.I = void 0;
   a.pb = void 0;
-}, 436171:a => {
+}, 436219:a => {
   window.h.Cb(a);
-}, 436221:a => {
+}, 436269:a => {
   a = window.h.ra(a);
   a.I.resume();
   a.state = window.h.ga.xb;
-}, 436360:a => {
+}, 436408:a => {
   a = window.h.ra(a);
   a.I.suspend();
   a.state = window.h.ga.stopped;
@@ -3355,7 +3355,7 @@ Zd();
 /* 2 */
 /***/ ((module) => {
 
-module.exports = JSON.parse('{"name":"@rive-app/canvas","version":"2.16.0","description":"Rive\'s canvas based web api.","main":"rive.js","homepage":"https://rive.app","repository":{"type":"git","url":"https://github.com/rive-app/rive-wasm/tree/master/js"},"keywords":["rive","animation"],"author":"Rive","contributors":["Luigi Rosso <luigi@rive.app> (https://rive.app)","Maxwell Talbot <max@rive.app> (https://rive.app)","Arthur Vivian <arthur@rive.app> (https://rive.app)","Umberto Sonnino <umberto@rive.app> (https://rive.app)","Matthew Sullivan <matt.j.sullivan@gmail.com> (mailto:matt.j.sullivan@gmail.com)"],"license":"MIT","files":["rive.js","rive.js.map","rive.wasm","rive_fallback.wasm","rive.d.ts","rive_advanced.mjs.d.ts"],"typings":"rive.d.ts","dependencies":{},"browser":{"fs":false,"path":false}}');
+module.exports = JSON.parse('{"name":"@rive-app/canvas","version":"2.17.0","description":"Rive\'s canvas based web api.","main":"rive.js","homepage":"https://rive.app","repository":{"type":"git","url":"https://github.com/rive-app/rive-wasm/tree/master/js"},"keywords":["rive","animation"],"author":"Rive","contributors":["Luigi Rosso <luigi@rive.app> (https://rive.app)","Maxwell Talbot <max@rive.app> (https://rive.app)","Arthur Vivian <arthur@rive.app> (https://rive.app)","Umberto Sonnino <umberto@rive.app> (https://rive.app)","Matthew Sullivan <matt.j.sullivan@gmail.com> (mailto:matt.j.sullivan@gmail.com)"],"license":"MIT","files":["rive.js","rive.js.map","rive.wasm","rive_fallback.wasm","rive.d.ts","rive_advanced.mjs.d.ts"],"typings":"rive.d.ts","dependencies":{},"browser":{"fs":false,"path":false}}');
 
 /***/ }),
 /* 3 */
@@ -5746,6 +5746,73 @@ var Rive = /** @class */ (function () {
         var stateMachine = this.animator.stateMachines.find(function (m) { return m.name === name; });
         return stateMachine === null || stateMachine === void 0 ? void 0 : stateMachine.inputs;
     };
+    // Returns the input with the provided name at the given path
+    Rive.prototype.retrieveInputAtPath = function (name, path) {
+        if (!name) {
+            console.warn("No input name provided for path '".concat(path, "'"));
+            return;
+        }
+        if (!this.artboard) {
+            console.warn("Tried to access input: '".concat(name, "', at path: '").concat(path, "', but the Artboard is null"));
+            return;
+        }
+        var input = this.artboard.inputByPath(name, path);
+        if (!input) {
+            console.warn("Could not access an input with name: '".concat(name, "', at path:'").concat(path, "'"));
+            return;
+        }
+        return input;
+    };
+    /**
+     * Set the boolean input with the provided name at the given path with value
+     * @param input the state machine input name
+     * @param value the value to set the input to
+     * @param path the path the input is located at an artboard level
+     */
+    Rive.prototype.setBooleanStateAtPath = function (inputName, value, path) {
+        var input = this.retrieveInputAtPath(inputName, path);
+        if (!input)
+            return;
+        if (input.type === StateMachineInputType.Boolean) {
+            input.asBool().value = value;
+        }
+        else {
+            console.warn("Input with name: '".concat(inputName, "', at path:'").concat(path, "' is not a boolean"));
+        }
+    };
+    /**
+     * Set the number input with the provided name at the given path with value
+     * @param input the state machine input name
+     * @param value the value to set the input to
+     * @param path the path the input is located at an artboard level
+     */
+    Rive.prototype.setNumberStateAtPath = function (inputName, value, path) {
+        var input = this.retrieveInputAtPath(inputName, path);
+        if (!input)
+            return;
+        if (input.type === StateMachineInputType.Number) {
+            input.asNumber().value = value;
+        }
+        else {
+            console.warn("Input with name: '".concat(inputName, "', at path:'").concat(path, "' is not a number"));
+        }
+    };
+    /**
+     * Fire the trigger with the provided name at the given path
+     * @param input the state machine input name
+     * @param path the path the input is located at an artboard level
+     */
+    Rive.prototype.fireStateAtPath = function (inputName, path) {
+        var input = this.retrieveInputAtPath(inputName, path);
+        if (!input)
+            return;
+        if (input.type === StateMachineInputType.Trigger) {
+            input.asTrigger().fire();
+        }
+        else {
+            console.warn("Input with name: '".concat(inputName, "', at path:'").concat(path, "' is not a trigger"));
+        }
+    };
     Object.defineProperty(Rive.prototype, "playingStateMachineNames", {
         // Returns a list of playing machine names
         get: function () {