@rive-app/webgl2 2.20.2 → 2.21.0

package/package.json

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

package/rive.d.ts

@@ -516,6 +516,44 @@ export declare class Rive {
      * @param path the path the input is located at an artboard level
      */
     fireStateAtPath(inputName: string, path: string): void;
+    private retrieveTextAtPath;
+    /**
+     * Retrieves the text value for a specified text run at a given path
+     * @param textName The name of the text run
+     * @param path The path to the text run within the artboard
+     * @returns The text value of the text run, or undefined if not found
+     *
+     * @example
+     * // Get the text value for a text run named "title" at one nested artboard deep
+     * const titleText = riveInstance.getTextRunValueAtPath("title", "artboard1");
+     *
+     * @example
+     * // Get the text value for a text run named "subtitle" within a nested group two artboards deep
+     * const subtitleText = riveInstance.getTextRunValueAtPath("subtitle", "group/nestedGroup");
+     *
+     * @remarks
+     * If the text run cannot be found at the specified path, a warning will be logged to the console.
+     */
+    getTextRunValueAtPath(textName: string, path: string): string | undefined;
+    /**
+     * Sets the text value for a specified text run at a given path
+     * @param textName The name of the text run
+     * @param value The new text value to set
+     * @param path The path to the text run within the artboard
+     * @returns void
+     *
+     * @example
+     * // Set the text value for a text run named "title" at one nested artboard deep
+     * riveInstance.setTextRunValueAtPath("title", "New Title", "artboard1");
+     *
+     * @example
+     * // Set the text value for a text run named "subtitle" within a nested group two artboards deep
+     * riveInstance.setTextRunValueAtPath("subtitle", "New Subtitle", "group/nestedGroup");
+     *
+     * @remarks
+     * If the text run cannot be found at the specified path, a warning will be logged to the console.
+     */
+    setTextRunValueAtPath(textName: string, value: string, path: string): void;
     get playingStateMachineNames(): string[];
     get playingAnimationNames(): string[];
     get pausedAnimationNames(): string[];

package/rive.js

@@ -415,7 +415,7 @@ function Na(a, b) {
     return Ma(c, a, b);
   }));
 }
-var Oa, Pa, Ta = {482388:(a, b, c, d, e) => {
+var Oa, Pa, Ta = {482484:(a, b, c, d, e) => {
   if ("undefined" === typeof window || void 0 === (window.AudioContext || window.webkitAudioContext)) {
     return 0;
   }
@@ -478,9 +478,9 @@ var Oa, Pa, Ta = {482388:(a, b, c, d, e) => {
   }
   window.h.Da += 1;
   return 1;
-}, 484566:() => {
+}, 484662:() => {
   "undefined" !== typeof window.h && (--window.h.Da, 0 === window.h.Da && delete window.h);
-}, 484730:() => void 0 !== navigator.mediaDevices && void 0 !== navigator.mediaDevices.getUserMedia, 484834:() => {
+}, 484826:() => void 0 !== navigator.mediaDevices && void 0 !== navigator.mediaDevices.getUserMedia, 484930:() => {
   try {
     var a = new (window.AudioContext || window.webkitAudioContext)(), b = a.sampleRate;
     a.close();
@@ -488,7 +488,7 @@ var Oa, Pa, Ta = {482388:(a, b, c, d, e) => {
   } catch (c) {
     return 0;
   }
-}, 485005:(a, b, c, d, e, f) => {
+}, 485101:(a, b, c, d, e, f) => {
   if ("undefined" === typeof window.h) {
     return -1;
   }
@@ -534,7 +534,7 @@ var Oa, Pa, Ta = {482388:(a, b, c, d, e) => {
   a == window.h.I.Ba && g.Y.connect(g.J.destination);
   g.jb = f;
   return window.h.lc(g);
-}, 487882:a => window.h.va(a).J.sampleRate, 487955:a => {
+}, 487978:a => window.h.va(a).J.sampleRate, 488051:a => {
   a = window.h.va(a);
   void 0 !== a.Y && (a.Y.onaudioprocess = function() {
   }, a.Y.disconnect(), a.Y = void 0);
@@ -542,13 +542,13 @@ var Oa, Pa, Ta = {482388:(a, b, c, d, e) => {
   a.J.close();
   a.J = void 0;
   a.jb = void 0;
-}, 488355:a => {
+}, 488451:a => {
   window.h.wb(a);
-}, 488405:a => {
+}, 488501:a => {
   a = window.h.va(a);
   a.J.resume();
   a.state = window.h.ha.rb;
-}, 488544:a => {
+}, 488640:a => {
   a = window.h.va(a);
   a.J.suspend();
   a.state = window.h.ha.stopped;
@@ -3459,8 +3459,8 @@ n.dynCall_viijii = (a, b, c, d, e, f, g) => (n.dynCall_viijii = B.dynCall_viijii
 n.dynCall_iiiiij = (a, b, c, d, e, f, g) => (n.dynCall_iiiiij = B.dynCall_iiiiij)(a, b, c, d, e, f, g);
 n.dynCall_iiiiijj = (a, b, c, d, e, f, g, m, p) => (n.dynCall_iiiiijj = B.dynCall_iiiiijj)(a, b, c, d, e, f, g, m, p);
 n.dynCall_iiiiiijj = (a, b, c, d, e, f, g, m, p, l) => (n.dynCall_iiiiiijj = B.dynCall_iiiiiijj)(a, b, c, d, e, f, g, m, p, l);
-n.___start_em_js = 479764;
-n.___stop_em_js = 482388;
+n.___start_em_js = 479860;
+n.___stop_em_js = 482484;
 var Wd;
 Ga = function Xd() {
   Wd || Yd();
@@ -3520,7 +3520,7 @@ Yd();
 /* 2 */
 /***/ ((module) => {
 
-module.exports = JSON.parse('{"name":"@rive-app/webgl2","version":"2.20.2","description":"Rive\'s webgl2 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)","Chris Dalton <chris@rive.app> (https://rive.app)"],"license":"MIT","files":["rive.js","rive.wasm","rive.js.map","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/webgl2","version":"2.21.0","description":"Rive\'s webgl2 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)","Chris Dalton <chris@rive.app> (https://rive.app)"],"license":"MIT","files":["rive.js","rive.wasm","rive.js.map","rive.d.ts","rive_advanced.mjs.d.ts"],"typings":"rive.d.ts","dependencies":{},"browser":{"fs":false,"path":false}}');
 
 /***/ }),
 /* 3 */
@@ -6062,6 +6062,78 @@ var Rive = /** @class */ (function () {
             console.warn("Input with name: '".concat(inputName, "', at path:'").concat(path, "' is not a trigger"));
         }
     };
+    // Returns the TextValueRun object for the provided name at the given path
+    Rive.prototype.retrieveTextAtPath = function (name, path) {
+        if (!name) {
+            console.warn("No text name provided for path '".concat(path, "'"));
+            return;
+        }
+        if (!path) {
+            console.warn("No path provided for text '".concat(name, "'"));
+            return;
+        }
+        if (!this.artboard) {
+            console.warn("Tried to access text: '".concat(name, "', at path: '").concat(path, "', but the Artboard is null"));
+            return;
+        }
+        var text = this.artboard.textByPath(name, path);
+        if (!text) {
+            console.warn("Could not access text with name: '".concat(name, "', at path:'").concat(path, "'"));
+            return;
+        }
+        return text;
+    };
+    /**
+     * Retrieves the text value for a specified text run at a given path
+     * @param textName The name of the text run
+     * @param path The path to the text run within the artboard
+     * @returns The text value of the text run, or undefined if not found
+     *
+     * @example
+     * // Get the text value for a text run named "title" at one nested artboard deep
+     * const titleText = riveInstance.getTextRunValueAtPath("title", "artboard1");
+     *
+     * @example
+     * // Get the text value for a text run named "subtitle" within a nested group two artboards deep
+     * const subtitleText = riveInstance.getTextRunValueAtPath("subtitle", "group/nestedGroup");
+     *
+     * @remarks
+     * If the text run cannot be found at the specified path, a warning will be logged to the console.
+     */
+    Rive.prototype.getTextRunValueAtPath = function (textName, path) {
+        var run = this.retrieveTextAtPath(textName, path);
+        if (!run) {
+            console.warn("Could not get text with name: '".concat(textName, "', at path:'").concat(path, "'"));
+            return;
+        }
+        return run.text;
+    };
+    /**
+     * Sets the text value for a specified text run at a given path
+     * @param textName The name of the text run
+     * @param value The new text value to set
+     * @param path The path to the text run within the artboard
+     * @returns void
+     *
+     * @example
+     * // Set the text value for a text run named "title" at one nested artboard deep
+     * riveInstance.setTextRunValueAtPath("title", "New Title", "artboard1");
+     *
+     * @example
+     * // Set the text value for a text run named "subtitle" within a nested group two artboards deep
+     * riveInstance.setTextRunValueAtPath("subtitle", "New Subtitle", "group/nestedGroup");
+     *
+     * @remarks
+     * If the text run cannot be found at the specified path, a warning will be logged to the console.
+     */
+    Rive.prototype.setTextRunValueAtPath = function (textName, value, path) {
+        var run = this.retrieveTextAtPath(textName, path);
+        if (!run) {
+            console.warn("Could not set text with name: '".concat(textName, "', at path:'").concat(path, "'"));
+            return;
+        }
+        run.text = value;
+    };
     Object.defineProperty(Rive.prototype, "playingStateMachineNames", {
         // Returns a list of playing machine names
         get: function () {