@rive-app/webgl 2.23.1 → 2.23.3

package/package.json

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

package/rive.d.ts

@@ -73,6 +73,7 @@ export declare class RuntimeLoader {
     static getInstance(callback: RuntimeCallback): void;
     static awaitInstance(): Promise<rc.RiveCanvas>;
     static setWasmUrl(url: string): void;
+    static getWasmUrl(): string;
 }
 export declare enum StateMachineInputType {
     Number = 56,
@@ -662,26 +663,26 @@ export declare class Rive {
     /**
      * The width of the artboard.
      *
-     * This will return undefined if the artboard is not loaded yet and a custom
+     * This will return 0 if the artboard is not loaded yet and a custom
      * width has not been set.
      *
      * Do not set this value manually when using {@link resizeDrawingSurfaceToCanvas}
      * with a {@link Layout.fit} of {@link Fit.Layout}, as the artboard width is
      * automatically set.
      */
-    get artboardWidth(): number | undefined;
+    get artboardWidth(): number;
     set artboardWidth(value: number);
     /**
      * The height of the artboard.
      *
-     * This will return undefined if the artboard is not loaded yet and a custom
+     * This will return 0 if the artboard is not loaded yet and a custom
      * height has not been set.
      *
      * Do not set this value manually when using {@link resizeDrawingSurfaceToCanvas}
      * with a {@link Layout.fit} of {@link Fit.Layout}, as the artboard height is
      * automatically set.
      */
-    get artboardHeight(): number | undefined;
+    get artboardHeight(): number;
     set artboardHeight(value: number);
     /**
      * Reset the artboard size to its original values.

package/rive.js

@@ -408,7 +408,7 @@ function Qa(a, b) {
     return Pa(c, a, b);
   }));
 }
-var Ra, Sa, Wa = {696428:(a, b, c, d, e) => {
+var Ra, Sa, Wa = {696588:(a, b, c, d, e) => {
   if ("undefined" === typeof window || void 0 === (window.AudioContext || window.webkitAudioContext)) {
     return 0;
   }
@@ -471,9 +471,9 @@ var Ra, Sa, Wa = {696428:(a, b, c, d, e) => {
   }
   window.h.Ea += 1;
   return 1;
-}, 698606:() => {
+}, 698766:() => {
   "undefined" !== typeof window.h && (--window.h.Ea, 0 === window.h.Ea && delete window.h);
-}, 698770:() => void 0 !== navigator.mediaDevices && void 0 !== navigator.mediaDevices.getUserMedia, 698874:() => {
+}, 698930:() => void 0 !== navigator.mediaDevices && void 0 !== navigator.mediaDevices.getUserMedia, 699034:() => {
   try {
     var a = new (window.AudioContext || window.webkitAudioContext)(), b = a.sampleRate;
     a.close();
@@ -481,7 +481,7 @@ var Ra, Sa, Wa = {696428:(a, b, c, d, e) => {
   } catch (c) {
     return 0;
   }
-}, 699045:(a, b, c, d, e, f) => {
+}, 699205:(a, b, c, d, e, f) => {
   if ("undefined" === typeof window.h) {
     return -1;
   }
@@ -527,7 +527,7 @@ var Ra, Sa, Wa = {696428:(a, b, c, d, e) => {
   a == window.h.H.Ca && g.X.connect(g.I.destination);
   g.lb = f;
   return window.h.nc(g);
-}, 701922:a => window.h.ta(a).I.sampleRate, 701995:a => {
+}, 702082:a => window.h.ta(a).I.sampleRate, 702155:a => {
   a = window.h.ta(a);
   void 0 !== a.X && (a.X.onaudioprocess = function() {
   }, a.X.disconnect(), a.X = void 0);
@@ -535,13 +535,13 @@ var Ra, Sa, Wa = {696428:(a, b, c, d, e) => {
   a.I.close();
   a.I = void 0;
   a.lb = void 0;
-}, 702395:a => {
+}, 702555:a => {
   window.h.xb(a);
-}, 702445:a => {
+}, 702605:a => {
   a = window.h.ta(a);
   a.I.resume();
   a.state = window.h.ha.sb;
-}, 702584:a => {
+}, 702744:a => {
   a = window.h.ta(a);
   a.I.suspend();
   a.state = window.h.ha.stopped;
@@ -4061,7 +4061,7 @@ Je();
 /* 2 */
 /***/ ((module) => {
 
-module.exports = JSON.parse('{"name":"@rive-app/webgl","version":"2.23.1","description":"Rive\'s webgl 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.wasm","rive_fallback.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/webgl","version":"2.23.3","description":"Rive\'s webgl 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.wasm","rive_fallback.wasm","rive.js.map","rive.d.ts","rive_advanced.mjs.d.ts"],"typings":"rive.d.ts","dependencies":{},"browser":{"fs":false,"path":false}}');
 
 /***/ }),
 /* 3 */
@@ -4726,20 +4726,44 @@ var RuntimeLoader = /** @class */ (function () {
                 (_a = RuntimeLoader.callBackQueue.shift()) === null || _a === void 0 ? void 0 : _a(RuntimeLoader.runtime);
             }
         })
-            .catch(function () {
+            .catch(function (error) {
+            // Capture specific error details
+            var errorDetails = {
+                message: (error === null || error === void 0 ? void 0 : error.message) || "Unknown error",
+                type: (error === null || error === void 0 ? void 0 : error.name) || "Error",
+                // Some browsers may provide additional WebAssembly-specific details
+                wasmError: error instanceof WebAssembly.CompileError ||
+                    error instanceof WebAssembly.RuntimeError,
+                originalError: error,
+            };
+            // Log detailed error for debugging
+            console.debug("Rive WASM load error details:", errorDetails);
             // In case unpkg fails, or the wasm was not supported, we try to load the fallback module from jsdelivr.
             // This `rive_fallback.wasm` is compiled to support older architecture.
             // TODO: (Gordon): preemptively test browser support and load the correct wasm file. Then use jsdelvr only if unpkg fails.
             var backupJsdelivrUrl = "https://cdn.jsdelivr.net/npm/".concat(package_json__WEBPACK_IMPORTED_MODULE_1__.name, "@").concat(package_json__WEBPACK_IMPORTED_MODULE_1__.version, "/rive_fallback.wasm");
             if (RuntimeLoader.wasmURL.toLowerCase() !== backupJsdelivrUrl) {
-                console.warn("Failed to load WASM from ".concat(RuntimeLoader.wasmURL, ", trying jsdelivr as a backup"));
+                console.warn("Failed to load WASM from ".concat(RuntimeLoader.wasmURL, " (").concat(errorDetails.message, "), trying jsdelivr as a backup"));
                 RuntimeLoader.setWasmUrl(backupJsdelivrUrl);
                 RuntimeLoader.loadRuntime();
             }
             else {
-                console.error("Could not load Rive WASM file from unpkg or jsdelivr, network connection may be down, or \
-        you may need to call set a new WASM source via RuntimeLoader.setWasmUrl() and call \
-        RuntimeLoader.loadRuntime() again");
+                var errorMessage = [
+                    "Could not load Rive WASM file from ".concat(RuntimeLoader.wasmURL, " or ").concat(backupJsdelivrUrl, "."),
+                    "Possible reasons:",
+                    "- Network connection is down",
+                    "- WebAssembly is not supported in this environment",
+                    "- The WASM file is corrupted or incompatible",
+                    "\nError details:",
+                    "- Type: ".concat(errorDetails.type),
+                    "- Message: ".concat(errorDetails.message),
+                    "- WebAssembly-specific error: ".concat(errorDetails.wasmError),
+                    "\nTo resolve, you may need to:",
+                    "1. Check your network connection",
+                    "2. Set a new WASM source via RuntimeLoader.setWasmUrl()",
+                    "3. Call RuntimeLoader.loadRuntime() again",
+                ].join("\n");
+                console.error(errorMessage);
             }
         });
     };
@@ -4767,6 +4791,10 @@ var RuntimeLoader = /** @class */ (function () {
     RuntimeLoader.setWasmUrl = function (url) {
         RuntimeLoader.wasmURL = url;
     };
+    // Gets the current wasm url
+    RuntimeLoader.getWasmUrl = function () {
+        return RuntimeLoader.wasmURL;
+    };
     // Flag to indicate that loading has started/completed
     RuntimeLoader.isLoading = false;
     // List of callbacks for the runtime that come in while loading
@@ -6973,7 +7001,7 @@ var Rive = /** @class */ (function () {
         /**
          * The width of the artboard.
          *
-         * This will return undefined if the artboard is not loaded yet and a custom
+         * This will return 0 if the artboard is not loaded yet and a custom
          * width has not been set.
          *
          * Do not set this value manually when using {@link resizeDrawingSurfaceToCanvas}
@@ -6981,10 +7009,11 @@ var Rive = /** @class */ (function () {
          * automatically set.
          */
         get: function () {
+            var _a;
             if (this.artboard) {
                 return this.artboard.width;
             }
-            return this._artboardWidth;
+            return (_a = this._artboardWidth) !== null && _a !== void 0 ? _a : 0;
         },
         set: function (value) {
             this._artboardWidth = value;
@@ -6999,7 +7028,7 @@ var Rive = /** @class */ (function () {
         /**
          * The height of the artboard.
          *
-         * This will return undefined if the artboard is not loaded yet and a custom
+         * This will return 0 if the artboard is not loaded yet and a custom
          * height has not been set.
          *
          * Do not set this value manually when using {@link resizeDrawingSurfaceToCanvas}
@@ -7007,10 +7036,11 @@ var Rive = /** @class */ (function () {
          * automatically set.
          */
         get: function () {
+            var _a;
             if (this.artboard) {
                 return this.artboard.height;
             }
-            return this._artboardHeight;
+            return (_a = this._artboardHeight) !== null && _a !== void 0 ? _a : 0;
         },
         set: function (value) {
             this._artboardHeight = value;