@galacean/engine-spine 4.2.1 → 4.2.3

package/dist/main.js

@@ -43,6 +43,97 @@ function __decorate(decorators, target, key, desc) {
     else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
+function __generator(thisArg, body) {
+    var _ = {
+        label: 0,
+        sent: function sent() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
 typeof SuppressedError === "function" ? SuppressedError : function _SuppressedError(error, suppressed, message) {
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
@@ -202,8 +293,9 @@ var Color = /*#__PURE__*/ function() {
         color.g = ((value & 0x0000ff00) >>> 8) / 255;
         color.b = (value & 0x000000ff) / 255;
     };
-    Color.fromString = function fromString(hex) {
-        return new Color().setFromString(hex);
+    Color.fromString = function fromString(hex, color) {
+        if (color === void 0) color = new Color();
+        return color.setFromString(hex);
     };
     return Color;
 }();
@@ -2827,18 +2919,16 @@ function _create_class(Constructor, protoProps, staticProps) {
         var finished = this.updateMixingFrom(from, delta);
         from.animationLast = from.nextAnimationLast;
         from.trackLast = from.nextTrackLast;
-        if (to.nextTrackLast != -1) {
-            var discard = to.mixTime == 0 && from.mixTime == 0; // Discard the from entry when neither have advanced yet.
-            if (to.mixTime >= to.mixDuration || discard) {
-                // Require totalAlpha == 0 to ensure mixing is complete or the transition is a single frame or discarded.
-                if (from.totalAlpha == 0 || to.mixDuration == 0 || discard) {
-                    to.mixingFrom = from.mixingFrom;
-                    if (from.mixingFrom != null) from.mixingFrom.mixingTo = to;
-                    to.interruptAlpha = from.interruptAlpha;
-                    this.queue.end(from);
-                }
-                return finished;
+        // The from entry was applied at least once and the mix is complete.
+        if (to.nextTrackLast != -1 && to.mixTime >= to.mixDuration) {
+            // Mixing is complete for all entries before the from entry or the mix is instantaneous.
+            if (from.totalAlpha == 0 || to.mixDuration == 0) {
+                to.mixingFrom = from.mixingFrom;
+                if (from.mixingFrom != null) from.mixingFrom.mixingTo = to;
+                to.interruptAlpha = from.interruptAlpha;
+                this.queue.end(from);
             }
+            return finished;
         }
         from.trackTime += delta * from.timeScale;
         to.mixTime += delta;
@@ -3203,10 +3293,11 @@ function _create_class(Constructor, protoProps, staticProps) {
         if (!last) {
             this.setCurrent(trackIndex, entry, true);
             this.queue.drain();
+            if (delay < 0) delay = 0;
         } else {
             last.next = entry;
             entry.previous = last;
-            if (delay <= 0) delay += last.getTrackComplete() - entry.mixDuration;
+            if (delay <= 0) delay = Math.max(delay + last.getTrackComplete() - entry.mixDuration, 0);
         }
         entry.delay = delay;
         return entry;
@@ -3245,7 +3336,7 @@ function _create_class(Constructor, protoProps, staticProps) {
         if (mixDuration === void 0) mixDuration = 0;
         if (delay === void 0) delay = 0;
         var entry = this.addAnimationWith(trackIndex, AnimationState.emptyAnimation(), false, delay);
-        if (delay <= 0) entry.delay += entry.mixDuration - mixDuration;
+        if (delay <= 0) entry.delay = Math.max(entry.delay + entry.mixDuration - mixDuration, 0);
         entry.mixDuration = mixDuration;
         entry.trackEnd = mixDuration;
         return entry;
@@ -3499,7 +3590,10 @@ AnimationState._emptyAnimation = new Animation("<empty>", [], 0);
     var _proto = TrackEntry.prototype;
     _proto.setMixDurationWithDelay = function setMixDurationWithDelay(mixDuration, delay) {
         this._mixDuration = mixDuration;
-        if (this.previous != null && delay <= 0) delay += this.previous.getTrackComplete() - mixDuration;
+        if (delay <= 0) {
+            if (this.previous != null) delay = Math.max(delay + this.previous.getTrackComplete() - mixDuration, 0);
+            else delay = 0;
+        }
         this.delay = delay;
     };
     _proto.reset = function reset() {
@@ -3722,17 +3816,17 @@ var CURRENT = 2;
 
 /******************************************************************************
  * Spine Runtimes License Agreement
- * Last updated July 28, 2023. Replaces all prior versions.
+ * Last updated April 5, 2025. Replaces all prior versions.
  *
- * Copyright (c) 2013-2023, Esoteric Software LLC
+ * Copyright (c) 2013-2025, Esoteric Software LLC
  *
  * Integration of the Spine Runtimes into software or otherwise creating
  * derivative works of the Spine Runtimes is permitted under the terms and
  * conditions of Section 2 of the Spine Editor License Agreement:
  * http://esotericsoftware.com/spine-editor-license
  *
- * Otherwise, it is permitted to integrate the Spine Runtimes into software or
- * otherwise create derivative works of the Spine Runtimes (collectively,
+ * Otherwise, it is permitted to integrate the Spine Runtimes into software
+ * or otherwise create derivative works of the Spine Runtimes (collectively,
  * "Products"), provided that each user of the Products must obtain their own
  * Spine Editor license and redistribution of the Products in any form must
  * include this license and copyright notice.
@@ -3745,8 +3839,8 @@ var CURRENT = 2;
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
- * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/ /** Stores mix (crossfade) durations to be applied when {@link AnimationState} animations are changed. */ var AnimationStateData = /*#__PURE__*/ function() {
     function AnimationStateData(skeletonData) {
         this.animationToMixTime = {};
@@ -4198,7 +4292,7 @@ var TextureAtlasRegion = /*#__PURE__*/ function(TextureRegion) {
         this.copyTo(copy);
         copy.regionUVs = new Array(this.regionUVs.length);
         Utils.arrayCopy(this.regionUVs, 0, copy.regionUVs, 0, this.regionUVs.length);
-        copy.uvs = new Array(this.uvs.length);
+        copy.uvs = _instanceof1(this.uvs, Float32Array) ? Utils.newFloatArray(this.uvs.length) : new Array(this.uvs.length);
         Utils.arrayCopy(this.uvs, 0, copy.uvs, 0, this.uvs.length);
         copy.triangles = new Array(this.triangles.length);
         Utils.arrayCopy(this.triangles, 0, copy.triangles, 0, this.triangles.length);
@@ -4862,17 +4956,17 @@ RegionAttachment.V4 = 31;
 
 /******************************************************************************
  * Spine Runtimes License Agreement
- * Last updated July 28, 2023. Replaces all prior versions.
+ * Last updated April 5, 2025. Replaces all prior versions.
  *
- * Copyright (c) 2013-2023, Esoteric Software LLC
+ * Copyright (c) 2013-2025, Esoteric Software LLC
  *
  * Integration of the Spine Runtimes into software or otherwise creating
  * derivative works of the Spine Runtimes is permitted under the terms and
  * conditions of Section 2 of the Spine Editor License Agreement:
  * http://esotericsoftware.com/spine-editor-license
  *
- * Otherwise, it is permitted to integrate the Spine Runtimes into software or
- * otherwise create derivative works of the Spine Runtimes (collectively,
+ * Otherwise, it is permitted to integrate the Spine Runtimes into software
+ * or otherwise create derivative works of the Spine Runtimes (collectively,
  * "Products"), provided that each user of the Products must obtain their own
  * Spine Editor license and redistribution of the Products in any form must
  * include this license and copyright notice.
@@ -4885,8 +4979,8 @@ RegionAttachment.V4 = 31;
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
- * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/ /** The base class for all constraint datas. */ var ConstraintData = function ConstraintData(name, order, skinRequired) {
     this.name = name;
     this.order = order;
@@ -4894,12 +4988,41 @@ RegionAttachment.V4 = 31;
 } 
 ;
 
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) resolve(value);
+    else Promise.resolve(value).then(_next, _throw);
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+
 var AssetManagerBase = /*#__PURE__*/ function() {
     function AssetManagerBase(textureLoader, pathPrefix, downloader) {
         if (pathPrefix === void 0) pathPrefix = "";
         if (downloader === void 0) downloader = new Downloader();
         this.pathPrefix = "";
         this.assets = {};
+        this.assetsRefCount = {};
+        this.assetsLoaded = {};
         this.errors = {};
         this.toLoad = 0;
         this.loaded = 0;
@@ -4916,6 +5039,7 @@ var AssetManagerBase = /*#__PURE__*/ function() {
         this.toLoad--;
         this.loaded++;
         this.assets[path] = asset;
+        this.assetsRefCount[path] = (this.assetsRefCount[path] || 0) + 1;
         if (callback) callback(path, asset);
     };
     _proto.error = function error(callback, path, message) {
@@ -4947,10 +5071,16 @@ var AssetManagerBase = /*#__PURE__*/ function() {
         if (success === void 0) success = function() {};
         if (error === void 0) error = function() {};
         path = this.start(path);
-        this.downloader.downloadBinary(path, function(data) {
-            _this.success(success, path, data);
-        }, function(status, responseText) {
-            _this.error(error, path, "Couldn't load binary " + path + ": status " + status + ", " + responseText);
+        if (this.reuseAssets(path, success, error)) return;
+        this.assetsLoaded[path] = new Promise(function(resolve, reject) {
+            _this.downloader.downloadBinary(path, function(data) {
+                _this.success(success, path, data);
+                resolve(data);
+            }, function(status, responseText) {
+                var errorMsg = "Couldn't load binary " + path + ": status " + status + ", " + responseText;
+                _this.error(error, path, errorMsg);
+                reject(errorMsg);
+            });
         });
     };
     _proto.loadText = function loadText(path, success, error) {
@@ -4969,46 +5099,79 @@ var AssetManagerBase = /*#__PURE__*/ function() {
         if (success === void 0) success = function() {};
         if (error === void 0) error = function() {};
         path = this.start(path);
-        this.downloader.downloadJson(path, function(data) {
-            _this.success(success, path, data);
-        }, function(status, responseText) {
-            _this.error(error, path, "Couldn't load JSON " + path + ": status " + status + ", " + responseText);
+        if (this.reuseAssets(path, success, error)) return;
+        this.assetsLoaded[path] = new Promise(function(resolve, reject) {
+            _this.downloader.downloadJson(path, function(data) {
+                _this.success(success, path, data);
+                resolve(data);
+            }, function(status, responseText) {
+                var errorMsg = "Couldn't load JSON " + path + ": status " + status + ", " + responseText;
+                _this.error(error, path, errorMsg);
+                reject(errorMsg);
+            });
         });
     };
-    _proto.loadTexture = function loadTexture(path, success, error) {
+    _proto.reuseAssets = function reuseAssets(path, success, error) {
         var _this = this;
         if (success === void 0) success = function() {};
         if (error === void 0) error = function() {};
-        path = this.start(path);
-        var isBrowser = !!(typeof window !== 'undefined' && typeof navigator !== 'undefined' && window.document);
-        var isWebWorker = !isBrowser; // && typeof importScripts !== 'undefined';
-        if (isWebWorker) {
-            fetch(path, {
-                mode: "cors"
-            }).then(function(response) {
-                if (response.ok) return response.blob();
-                _this.error(error, path, "Couldn't load image: " + path);
-                return null;
-            }).then(function(blob) {
-                return blob ? createImageBitmap(blob, {
-                    premultiplyAlpha: "none",
-                    colorSpaceConversion: "none"
-                }) : null;
-            }).then(function(bitmap) {
-                if (bitmap) _this.success(success, path, _this.textureLoader(bitmap));
+        var loadedStatus = this.assetsLoaded[path];
+        var alreadyExistsOrLoading = loadedStatus !== undefined;
+        if (alreadyExistsOrLoading) {
+            loadedStatus.then(function(data) {
+                return _this.success(success, path, data);
+            }).catch(function(errorMsg) {
+                return _this.error(error, path, errorMsg);
             });
-        } else {
-            var image = new Image();
-            image.crossOrigin = "anonymous";
-            image.onload = function() {
-                _this.success(success, path, _this.textureLoader(image));
-            };
-            image.onerror = function() {
-                _this.error(error, path, "Couldn't load image: " + path);
-            };
-            if (this.downloader.rawDataUris[path]) path = this.downloader.rawDataUris[path];
-            image.src = path;
         }
+        return alreadyExistsOrLoading;
+    };
+    _proto.loadTexture = function loadTexture(path, success, error) {
+        var _this = this;
+        if (success === void 0) success = function() {};
+        if (error === void 0) error = function() {};
+        path = this.start(path);
+        if (this.reuseAssets(path, success, error)) return;
+        this.assetsLoaded[path] = new Promise(function(resolve, reject) {
+            var isBrowser = !!(typeof window !== 'undefined' && typeof navigator !== 'undefined' && window.document);
+            var isWebWorker = !isBrowser; // && typeof importScripts !== 'undefined';
+            if (isWebWorker) {
+                fetch(path, {
+                    mode: "cors"
+                }).then(function(response) {
+                    if (response.ok) return response.blob();
+                    var errorMsg = "Couldn't load image: " + path;
+                    _this.error(error, path, "Couldn't load image: " + path);
+                    reject(errorMsg);
+                }).then(function(blob) {
+                    return blob ? createImageBitmap(blob, {
+                        premultiplyAlpha: "none",
+                        colorSpaceConversion: "none"
+                    }) : null;
+                }).then(function(bitmap) {
+                    if (bitmap) {
+                        var texture = _this.textureLoader(bitmap);
+                        _this.success(success, path, texture);
+                        resolve(texture);
+                    }
+                });
+            } else {
+                var image = new Image();
+                image.crossOrigin = "anonymous";
+                image.onload = function() {
+                    var texture = _this.textureLoader(image);
+                    _this.success(success, path, texture);
+                    resolve(texture);
+                };
+                image.onerror = function() {
+                    var errorMsg = "Couldn't load image: " + path;
+                    _this.error(error, path, errorMsg);
+                    reject(errorMsg);
+                };
+                if (_this.downloader.rawDataUris[path]) path = _this.downloader.rawDataUris[path];
+                image.src = path;
+            }
+        });
     };
     _proto.loadTextureAtlas = function loadTextureAtlas(path, success, error, fileAlias) {
         var _this = this;
@@ -5017,30 +5180,159 @@ var AssetManagerBase = /*#__PURE__*/ function() {
         var index = path.lastIndexOf("/");
         var parent = index >= 0 ? path.substring(0, index + 1) : "";
         path = this.start(path);
-        this.downloader.downloadText(path, function(atlasText) {
-            try {
-                var _loop = function() {
-                    var page = _step.value;
-                    _this.loadTexture(!fileAlias ? parent + page.name : fileAlias[page.name], function(imagePath, texture) {
-                        if (!abort) {
-                            page.setTexture(texture);
-                            if (--toLoad == 0) _this.success(success, path, atlas);
-                        }
-                    }, function(imagePath, message) {
-                        if (!abort) _this.error(error, path, "Couldn't load texture atlas " + path + " page image: " + imagePath);
-                        abort = true;
-                    });
-                };
-                var atlas = new TextureAtlas(atlasText);
-                var toLoad = atlas.pages.length, abort = false;
-                for(var _iterator = _create_for_of_iterator_helper_loose(atlas.pages), _step; !(_step = _iterator()).done;)_loop();
-            } catch (e) {
-                _this.error(error, path, "Couldn't parse texture atlas " + path + ": " + e.message);
-            }
-        }, function(status, responseText) {
-            _this.error(error, path, "Couldn't load texture atlas " + path + ": status " + status + ", " + responseText);
+        if (this.reuseAssets(path, success, error)) return;
+        this.assetsLoaded[path] = new Promise(function(resolve, reject) {
+            _this.downloader.downloadText(path, function(atlasText) {
+                try {
+                    var _loop = function() {
+                        var page = _step.value;
+                        _this.loadTexture(!fileAlias ? parent + page.name : fileAlias[page.name], function(imagePath, texture) {
+                            if (!abort) {
+                                page.setTexture(texture);
+                                if (--toLoad == 0) {
+                                    _this.success(success, path, atlas);
+                                    resolve(atlas);
+                                }
+                            }
+                        }, function(imagePath, message) {
+                            if (!abort) {
+                                var errorMsg = "Couldn't load texture atlas " + path + " page image: " + imagePath;
+                                _this.error(error, path, errorMsg);
+                                reject(errorMsg);
+                            }
+                            abort = true;
+                        });
+                    };
+                    var atlas = new TextureAtlas(atlasText);
+                    var toLoad = atlas.pages.length, abort = false;
+                    for(var _iterator = _create_for_of_iterator_helper_loose(atlas.pages), _step; !(_step = _iterator()).done;)_loop();
+                } catch (e) {
+                    var errorMsg = "Couldn't parse texture atlas " + path + ": " + e.message;
+                    _this.error(error, path, errorMsg);
+                    reject(errorMsg);
+                }
+            }, function(status, responseText) {
+                var errorMsg = "Couldn't load texture atlas " + path + ": status " + status + ", " + responseText;
+                _this.error(error, path, errorMsg);
+                reject(errorMsg);
+            });
+        });
+    };
+    _proto.loadTextureAtlasButNoTextures = function loadTextureAtlasButNoTextures(path, success, error, fileAlias) {
+        var _this = this;
+        if (success === void 0) success = function() {};
+        if (error === void 0) error = function() {};
+        path = this.start(path);
+        if (this.reuseAssets(path, success, error)) return;
+        this.assetsLoaded[path] = new Promise(function(resolve, reject) {
+            _this.downloader.downloadText(path, function(atlasText) {
+                try {
+                    var atlas = new TextureAtlas(atlasText);
+                    _this.success(success, path, atlas);
+                    resolve(atlas);
+                } catch (e) {
+                    var errorMsg = "Couldn't parse texture atlas " + path + ": " + e.message;
+                    _this.error(error, path, errorMsg);
+                    reject(errorMsg);
+                }
+            }, function(status, responseText) {
+                var errorMsg = "Couldn't load texture atlas " + path + ": status " + status + ", " + responseText;
+                _this.error(error, path, errorMsg);
+                reject(errorMsg);
+            });
         });
     };
+    // Promisified versions of load function
+    _proto.loadBinaryAsync = function loadBinaryAsync(path) {
+        return _async_to_generator(function() {
+            var _this;
+            return __generator(this, function(_state) {
+                _this = this;
+                return [
+                    2,
+                    new Promise(function(resolve, reject) {
+                        _this.loadBinary(path, function(_, binary) {
+                            return resolve(binary);
+                        }, function(_, message) {
+                            return reject(message);
+                        });
+                    })
+                ];
+            });
+        }).call(this);
+    };
+    _proto.loadJsonAsync = function loadJsonAsync(path) {
+        return _async_to_generator(function() {
+            var _this;
+            return __generator(this, function(_state) {
+                _this = this;
+                return [
+                    2,
+                    new Promise(function(resolve, reject) {
+                        _this.loadJson(path, function(_, object) {
+                            return resolve(object);
+                        }, function(_, message) {
+                            return reject(message);
+                        });
+                    })
+                ];
+            });
+        }).call(this);
+    };
+    _proto.loadTextureAsync = function loadTextureAsync(path) {
+        return _async_to_generator(function() {
+            var _this;
+            return __generator(this, function(_state) {
+                _this = this;
+                return [
+                    2,
+                    new Promise(function(resolve, reject) {
+                        _this.loadTexture(path, function(_, texture) {
+                            return resolve(texture);
+                        }, function(_, message) {
+                            return reject(message);
+                        });
+                    })
+                ];
+            });
+        }).call(this);
+    };
+    _proto.loadTextureAtlasAsync = function loadTextureAtlasAsync(path) {
+        return _async_to_generator(function() {
+            var _this;
+            return __generator(this, function(_state) {
+                _this = this;
+                return [
+                    2,
+                    new Promise(function(resolve, reject) {
+                        _this.loadTextureAtlas(path, function(_, atlas) {
+                            return resolve(atlas);
+                        }, function(_, message) {
+                            return reject(message);
+                        });
+                    })
+                ];
+            });
+        }).call(this);
+    };
+    _proto.loadTextureAtlasButNoTexturesAsync = function loadTextureAtlasButNoTexturesAsync(path) {
+        return _async_to_generator(function() {
+            var _this;
+            return __generator(this, function(_state) {
+                _this = this;
+                return [
+                    2,
+                    new Promise(function(resolve, reject) {
+                        _this.loadTextureAtlasButNoTextures(path, function(_, atlas) {
+                            return resolve(atlas);
+                        }, function(_, message) {
+                            return reject(message);
+                        });
+                    })
+                ];
+            });
+        }).call(this);
+    };
     _proto.get = function get(path) {
         return this.assets[this.pathPrefix + path];
     };
@@ -5056,14 +5348,18 @@ var AssetManagerBase = /*#__PURE__*/ function() {
         var asset = this.assets[path];
         if (asset.dispose) asset.dispose();
         delete this.assets[path];
+        delete this.assetsRefCount[path];
+        delete this.assetsLoaded[path];
         return asset;
     };
     _proto.removeAll = function removeAll() {
-        for(var key in this.assets){
-            var asset = this.assets[key];
+        for(var path in this.assets){
+            var asset = this.assets[path];
             if (asset.dispose) asset.dispose();
         }
         this.assets = {};
+        this.assetsLoaded = {};
+        this.assetsRefCount = {};
     };
     _proto.isLoadingComplete = function isLoadingComplete() {
         return this.toLoad == 0;
@@ -5077,6 +5373,12 @@ var AssetManagerBase = /*#__PURE__*/ function() {
     _proto.dispose = function dispose() {
         this.removeAll();
     };
+    // dispose asset only if it's not used by others
+    _proto.disposeAsset = function disposeAsset(path) {
+        if (--this.assetsRefCount[path] === 0) {
+            this.remove(path);
+        }
+    };
     _proto.hasErrors = function hasErrors() {
         return Object.keys(this.errors).length > 0;
     };
@@ -5124,10 +5426,11 @@ var Downloader = /*#__PURE__*/ function() {
     _proto.downloadText = function downloadText(url, success, error) {
         var _this = this;
         if (this.start(url, success, error)) return;
-        if (this.rawDataUris[url]) {
+        var rawDataUri = this.rawDataUris[url];
+        // we assume if a "." is included in a raw data uri, it is used to rewrite an asset URL
+        if (rawDataUri && !rawDataUri.includes(".")) {
             try {
-                var dataUri = this.rawDataUris[url];
-                this.finish(url, 200, this.dataUriToString(dataUri));
+                this.finish(url, 200, this.dataUriToString(rawDataUri));
             } catch (e) {
                 this.finish(url, 400, JSON.stringify(e));
             }
@@ -5135,7 +5438,7 @@ var Downloader = /*#__PURE__*/ function() {
         }
         var request = new XMLHttpRequest();
         request.overrideMimeType("text/html");
-        request.open("GET", url, true);
+        request.open("GET", rawDataUri ? rawDataUri : url, true);
         var done = function() {
             _this.finish(url, request.status, request.responseText);
         };
@@ -5151,17 +5454,18 @@ var Downloader = /*#__PURE__*/ function() {
     _proto.downloadBinary = function downloadBinary(url, success, error) {
         var _this = this;
         if (this.start(url, success, error)) return;
-        if (this.rawDataUris[url]) {
+        var rawDataUri = this.rawDataUris[url];
+        // we assume if a "." is included in a raw data uri, it is used to rewrite an asset URL
+        if (rawDataUri && !rawDataUri.includes(".")) {
             try {
-                var dataUri = this.rawDataUris[url];
-                this.finish(url, 200, this.dataUriToUint8Array(dataUri));
+                this.finish(url, 200, this.dataUriToUint8Array(rawDataUri));
             } catch (e) {
                 this.finish(url, 400, JSON.stringify(e));
             }
             return;
         }
         var request = new XMLHttpRequest();
-        request.open("GET", url, true);
+        request.open("GET", rawDataUri ? rawDataUri : url, true);
         request.responseType = "arraybuffer";
         var onerror = function() {
             _this.finish(url, request.status, request.response);
@@ -5199,17 +5503,17 @@ var Downloader = /*#__PURE__*/ function() {
 
 /******************************************************************************
  * Spine Runtimes License Agreement
- * Last updated July 28, 2023. Replaces all prior versions.
+ * Last updated April 5, 2025. Replaces all prior versions.
  *
- * Copyright (c) 2013-2023, Esoteric Software LLC
+ * Copyright (c) 2013-2025, Esoteric Software LLC
  *
  * Integration of the Spine Runtimes into software or otherwise creating
  * derivative works of the Spine Runtimes is permitted under the terms and
  * conditions of Section 2 of the Spine Editor License Agreement:
  * http://esotericsoftware.com/spine-editor-license
  *
- * Otherwise, it is permitted to integrate the Spine Runtimes into software or
- * otherwise create derivative works of the Spine Runtimes (collectively,
+ * Otherwise, it is permitted to integrate the Spine Runtimes into software
+ * or otherwise create derivative works of the Spine Runtimes (collectively,
  * "Products"), provided that each user of the Products must obtain their own
  * Spine Editor license and redistribution of the Products in any form must
  * include this license and copyright notice.
@@ -5222,8 +5526,8 @@ var Downloader = /*#__PURE__*/ function() {
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
- * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/ /** Stores the current pose values for an {@link Event}.
  *
  * See Timeline {@link Timeline#apply()},
@@ -5243,17 +5547,17 @@ var Downloader = /*#__PURE__*/ function() {
 
 /******************************************************************************
  * Spine Runtimes License Agreement
- * Last updated July 28, 2023. Replaces all prior versions.
+ * Last updated April 5, 2025. Replaces all prior versions.
  *
- * Copyright (c) 2013-2023, Esoteric Software LLC
+ * Copyright (c) 2013-2025, Esoteric Software LLC
  *
  * Integration of the Spine Runtimes into software or otherwise creating
  * derivative works of the Spine Runtimes is permitted under the terms and
  * conditions of Section 2 of the Spine Editor License Agreement:
  * http://esotericsoftware.com/spine-editor-license
  *
- * Otherwise, it is permitted to integrate the Spine Runtimes into software or
- * otherwise create derivative works of the Spine Runtimes (collectively,
+ * Otherwise, it is permitted to integrate the Spine Runtimes into software
+ * or otherwise create derivative works of the Spine Runtimes (collectively,
  * "Products"), provided that each user of the Products must obtain their own
  * Spine Editor license and redistribution of the Products in any form must
  * include this license and copyright notice.
@@ -5266,8 +5570,8 @@ var Downloader = /*#__PURE__*/ function() {
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
- * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/ /** Stores the setup pose values for an {@link Event}.
  *
  * See [Events](http://esotericsoftware.com/spine-events) in the Spine User Guide. */ var EventData = function EventData(name) {
@@ -6127,7 +6431,7 @@ PathConstraint.epsilon = 0.00001;
                         }
                         if (a >= t) {
                             d = Math.pow(this.damping, 60 * t);
-                            var m = this.massInverse * t, e = this.strength, w = this.wind * f, g = (Skeleton.yDown ? -this.gravity : this.gravity) * f;
+                            var m = this.massInverse * t, e = this.strength, w = this.wind * f * skeleton.scaleX, g = this.gravity * f * skeleton.scaleY;
                             do {
                                 if (x) {
                                     this.xVelocity += (w - this.xOffset * e) * m;
@@ -6969,10 +7273,10 @@ PathConstraint.epsilon = 0.00001;
         })) != null ? _this_physicsConstraints_find : null;
     };
     /** Returns the axis aligned bounding box (AABB) of the region and mesh attachments for the current pose as `{ x: number, y: number, width: number, height: number }`.
-     * Note that this method will create temporary objects which can add to garbage collection pressure. Use `getBounds()` if garbage collection is a concern. */ _proto.getBoundsRect = function getBoundsRect() {
+     * Note that this method will create temporary objects which can add to garbage collection pressure. Use `getBounds()` if garbage collection is a concern. */ _proto.getBoundsRect = function getBoundsRect(clipper) {
         var offset = new Vector2();
         var size = new Vector2();
-        this.getBounds(offset, size);
+        this.getBounds(offset, size, undefined, clipper);
         return {
             x: offset.x,
             y: offset.y,
@@ -7101,17 +7405,17 @@ Skeleton.yDown = false;
 
 /******************************************************************************
  * Spine Runtimes License Agreement
- * Last updated July 28, 2023. Replaces all prior versions.
+ * Last updated April 5, 2025. Replaces all prior versions.
  *
- * Copyright (c) 2013-2023, Esoteric Software LLC
+ * Copyright (c) 2013-2025, Esoteric Software LLC
  *
  * Integration of the Spine Runtimes into software or otherwise creating
  * derivative works of the Spine Runtimes is permitted under the terms and
  * conditions of Section 2 of the Spine Editor License Agreement:
  * http://esotericsoftware.com/spine-editor-license
  *
- * Otherwise, it is permitted to integrate the Spine Runtimes into software or
- * otherwise create derivative works of the Spine Runtimes (collectively,
+ * Otherwise, it is permitted to integrate the Spine Runtimes into software
+ * or otherwise create derivative works of the Spine Runtimes (collectively,
  * "Products"), provided that each user of the Products must obtain their own
  * Spine Editor license and redistribution of the Products in any form must
  * include this license and copyright notice.
@@ -7124,18 +7428,16 @@ Skeleton.yDown = false;
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
- * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/ /** Stores the setup pose and all of the stateless data for a skeleton.
  *
  * See [Data objects](http://esotericsoftware.com/spine-runtime-architecture#Data-objects) in the Spine Runtimes
  * Guide. */ var SkeletonData = /*#__PURE__*/ function() {
     function SkeletonData() {
         /** The skeleton's name, which by default is the name of the skeleton data file, if possible. May be null. */ this.name = null;
-        /** The skeleton's bones, sorted parent first. The root bone is always the first bone. */ this.bones = new Array() // Ordered parents first.
-        ;
-        /** The skeleton's slots in the setup pose draw order. */ this.slots = new Array() // Setup pose draw order.
-        ;
+        /** The skeleton's bones, sorted parent first. The root bone is always the first bone. */ this.bones = new Array(); // Ordered parents first.
+        /** The skeleton's slots in the setup pose draw order. */ this.slots = new Array(); // Setup pose draw order.
         this.skins = new Array();
         /** The skeleton's default skin. By default this skin contains all attachments that were not in a skin in Spine.
      *
@@ -7278,8 +7580,7 @@ Skeleton.yDown = false;
         this.attachments = new Array();
         this.bones = Array();
         this.constraints = new Array();
-        /** The color of the skin as it was in Spine, or a default color if nonessential data was not exported. */ this.color = new Color(0.99607843, 0.61960787, 0.30980393, 1) // fe9e4fff
-        ;
+        /** The color of the skin as it was in Spine, or a default color if nonessential data was not exported. */ this.color = new Color(0.99607843, 0.61960787, 0.30980393, 1); // fe9e4fff
         if (!name) throw new Error("name cannot be null.");
         this.name = name;
     }
@@ -10437,17 +10738,17 @@ function getValue(map, property, defaultValue) {
 
 /******************************************************************************
  * Spine Runtimes License Agreement
- * Last updated July 28, 2023. Replaces all prior versions.
+ * Last updated April 5, 2025. Replaces all prior versions.
  *
- * Copyright (c) 2013-2023, Esoteric Software LLC
+ * Copyright (c) 2013-2025, Esoteric Software LLC
  *
  * Integration of the Spine Runtimes into software or otherwise creating
  * derivative works of the Spine Runtimes is permitted under the terms and
  * conditions of Section 2 of the Spine Editor License Agreement:
  * http://esotericsoftware.com/spine-editor-license
  *
- * Otherwise, it is permitted to integrate the Spine Runtimes into software or
- * otherwise create derivative works of the Spine Runtimes (collectively,
+ * Otherwise, it is permitted to integrate the Spine Runtimes into software
+ * or otherwise create derivative works of the Spine Runtimes (collectively,
  * "Products"), provided that each user of the Products must obtain their own
  * Spine Editor license and redistribution of the Products in any form must
  * include this license and copyright notice.
@@ -10460,8 +10761,8 @@ function getValue(map, property, defaultValue) {
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
- * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/ (function() {
     if (typeof Math.fround === "undefined") {
         Math.fround = function(array) {
@@ -10610,55 +10911,6 @@ function getValue(map, property, defaultValue) {
     return LoaderUtils;
 }();
 
-var SourceAlpha = engine.BlendFactor.SourceAlpha, One = engine.BlendFactor.One, DestinationColor = engine.BlendFactor.DestinationColor, Zero = engine.BlendFactor.Zero, OneMinusSourceColor = engine.BlendFactor.OneMinusSourceColor, OneMinusSourceAlpha = engine.BlendFactor.OneMinusSourceAlpha;
-var Add = engine.BlendOperation.Add;
-function setBlendMode(material, blendMode, premultipliedAlpha) {
-    var target = material.renderState.blendState.targetBlendState;
-    switch(blendMode){
-        case exports.BlendMode.Additive:
-            target.sourceColorBlendFactor = premultipliedAlpha ? One : SourceAlpha;
-            target.destinationColorBlendFactor = One;
-            target.sourceAlphaBlendFactor = One;
-            target.destinationAlphaBlendFactor = One;
-            target.colorBlendOperation = target.alphaBlendOperation = Add;
-            break;
-        case exports.BlendMode.Multiply:
-            target.sourceColorBlendFactor = DestinationColor;
-            target.destinationColorBlendFactor = OneMinusSourceAlpha;
-            target.sourceAlphaBlendFactor = One;
-            target.destinationAlphaBlendFactor = OneMinusSourceAlpha;
-            target.colorBlendOperation = target.alphaBlendOperation = Add;
-            break;
-        case exports.BlendMode.Screen:
-            target.sourceColorBlendFactor = One;
-            target.destinationColorBlendFactor = OneMinusSourceColor;
-            target.sourceAlphaBlendFactor = One;
-            target.destinationAlphaBlendFactor = OneMinusSourceColor;
-            target.colorBlendOperation = target.alphaBlendOperation = Add;
-            break;
-        default:
-            target.sourceColorBlendFactor = premultipliedAlpha ? One : SourceAlpha;
-            target.destinationColorBlendFactor = OneMinusSourceAlpha;
-            target.sourceAlphaBlendFactor = One;
-            target.destinationAlphaBlendFactor = OneMinusSourceAlpha;
-            target.colorBlendOperation = target.alphaBlendOperation = Add;
-            break;
-    }
-}
-function getBlendMode(material) {
-    var target = material.renderState.blendState.targetBlendState;
-    if (target.sourceColorBlendFactor === SourceAlpha && target.destinationColorBlendFactor === One && target.sourceAlphaBlendFactor === One && target.destinationAlphaBlendFactor === One && target.colorBlendOperation === Add && target.alphaBlendOperation === Add) {
-        return exports.BlendMode.Additive;
-    }
-    if (target.sourceColorBlendFactor === DestinationColor && target.destinationColorBlendFactor === Zero && target.sourceAlphaBlendFactor === One && target.destinationAlphaBlendFactor === Zero && target.colorBlendOperation === Add && target.alphaBlendOperation === Add) {
-        return exports.BlendMode.Multiply;
-    }
-    if (target.sourceColorBlendFactor === One && target.destinationColorBlendFactor === OneMinusSourceColor && target.sourceAlphaBlendFactor === One && target.destinationAlphaBlendFactor === OneMinusSourceColor && target.colorBlendOperation === Add && target.alphaBlendOperation === Add) {
-        return exports.BlendMode.Screen;
-    }
-    return exports.BlendMode.Normal;
-}
-
 var ClearablePool = /*#__PURE__*/ function() {
     function ClearablePool(type) {
         this._usedElementCount = 0;
@@ -10719,11 +10971,11 @@ var SubRenderItem = function SubRenderItem() {
     }
     var _proto = SpineGenerator.prototype;
     _proto.buildPrimitive = function buildPrimitive(skeleton, renderer) {
-        var _indices = renderer._indices, _vertices = renderer._vertices, _localBounds = renderer._localBounds, _vertexCount = renderer._vertexCount, _subPrimitives = renderer._subPrimitives, engine = renderer.engine, zSpacing = renderer.zSpacing, premultipliedAlpha = renderer.premultipliedAlpha;
+        var _indices = renderer._indices, _vertices = renderer._vertices, _localBounds = renderer._localBounds, _vertexCount = renderer._vertexCount, _subPrimitives = renderer._subPrimitives, zSpacing = renderer.zSpacing, premultipliedAlpha = renderer.premultipliedAlpha, tintBlack = renderer.tintBlack;
         _localBounds.min.set(Infinity, Infinity, Infinity);
         _localBounds.max.set(-Infinity, -Infinity, -Infinity);
         var _this = this, _clipper = _this._clipper, _separateSlots = _this._separateSlots, _subRenderItems = _this._subRenderItems, _separateSlotTextureMap = _this._separateSlotTextureMap;
-        var tempVerts = SpineGenerator.tempVerts, subRenderItemPool = SpineGenerator.subRenderItemPool, subPrimitivePool = SpineGenerator.subPrimitivePool, VERTEX_SIZE = SpineGenerator.VERTEX_SIZE;
+        var tempVerts = SpineGenerator.tempVerts, subRenderItemPool = SpineGenerator.subRenderItemPool, subPrimitivePool = SpineGenerator.subPrimitivePool, vertexStrideWithTint = SpineGenerator.vertexStrideWithTint, vertexStrideWithoutTint = SpineGenerator.vertexStrideWithoutTint;
         _subRenderItems.length = 0;
         subRenderItemPool.clear();
         var triangles;
@@ -10753,13 +11005,28 @@ var SubRenderItem = function SubRenderItem() {
             var isClipping = _clipper.isClipping();
             var numFloats = 0;
             var attachmentColor = null;
-            var vertexSize = isClipping ? 2 : VERTEX_SIZE;
+            // This vertexSize will be passed to spine-core's computeWorldVertices function.
+            //
+            // Expected format by computeWorldVertices:
+            // - Without tintBlack: [x, y, u, v, r, g, b, a] = 8 components
+            // - With tintBlack:    [x, y, u, v, r, g, b, a, dr, dg, db, da] = 12 components
+            //
+            // Our actual vertex buffer format:
+            // - vertexStrideWithoutTint: [x, y, z, u, v, r, g, b, a] = 9 components
+            // - vertexStrideWithTint:    [x, y, z, u, v, r, g, b, a, dr, dg, db] = 12 components
+            //   (Note: we optimized 'da' as uniform instead of buffer attribute)
+            //
+            // Calculation:
+            // - Without tintBlack: 9 - 1 (remove z) = 8 ✓
+            // - With tintBlack:    12 - 1 (remove z) + 1 (add back da) = 12 ✓
+            var vertexSize = tintBlack ? vertexStrideWithTint : vertexStrideWithoutTint - 1;
+            var clippedVertexSize = isClipping ? 2 : vertexSize;
             switch(attachment.constructor){
                 case RegionAttachment:
                     var regionAttachment = attachment;
                     attachmentColor = regionAttachment.color;
-                    numFloats = vertexSize * 4;
-                    regionAttachment.computeWorldVertices(slot, tempVerts, 0, vertexSize);
+                    numFloats = clippedVertexSize << 2;
+                    regionAttachment.computeWorldVertices(slot, tempVerts, 0, clippedVertexSize);
                     triangles = SpineGenerator.QUAD_TRIANGLES;
                     uvs = regionAttachment.uvs;
                     texture = regionAttachment.region.texture;
@@ -10767,11 +11034,11 @@ var SubRenderItem = function SubRenderItem() {
                 case MeshAttachment:
                     var meshAttachment = attachment;
                     attachmentColor = meshAttachment.color;
-                    numFloats = (meshAttachment.worldVerticesLength >> 1) * vertexSize;
+                    numFloats = (meshAttachment.worldVerticesLength >> 1) * clippedVertexSize;
                     if (numFloats > _vertices.length) {
                         SpineGenerator.tempVerts = new Array(numFloats);
                     }
-                    meshAttachment.computeWorldVertices(slot, 0, meshAttachment.worldVerticesLength, tempVerts, 0, vertexSize);
+                    meshAttachment.computeWorldVertices(slot, 0, meshAttachment.worldVerticesLength, tempVerts, 0, clippedVertexSize);
                     triangles = meshAttachment.triangles;
                     uvs = meshAttachment.uvs;
                     texture = meshAttachment.region.texture;
@@ -10803,8 +11070,21 @@ var SubRenderItem = function SubRenderItem() {
                     finalColor.g *= finalAlpha;
                     finalColor.b *= finalAlpha;
                 }
+                var darkColor = SpineGenerator.tempDark;
+                var slotDarkColor = slot.darkColor;
+                if (!slotDarkColor) {
+                    darkColor.set(0, 0, 0, 1);
+                } else {
+                    if (premultipliedAlpha) {
+                        darkColor.r = slotDarkColor.r * finalAlpha;
+                        darkColor.g = slotDarkColor.g * finalAlpha;
+                        darkColor.b = slotDarkColor.b * finalAlpha;
+                    } else {
+                        darkColor.setFromColor(slotDarkColor);
+                    }
+                }
                 if (isClipping) {
-                    _clipper.clipTriangles(tempVerts, triangles, triangles.length, uvs, finalColor, SpineGenerator.tempDark, false);
+                    _clipper.clipTriangles(tempVerts, triangles, triangles.length, uvs, finalColor, darkColor, tintBlack);
                     finalVertices = _clipper.clippedVertices;
                     finalVerticesLength = finalVertices.length;
                     finalIndices = _clipper.clippedTriangles;
@@ -10818,6 +11098,12 @@ var SubRenderItem = function SubRenderItem() {
                         tempVerts[v + 3] = a;
                         tempVerts[v + 4] = uvs[u];
                         tempVerts[v + 5] = uvs[u + 1];
+                        if (tintBlack) {
+                            tempVerts[v + 6] = darkColor.r;
+                            tempVerts[v + 7] = darkColor.g;
+                            tempVerts[v + 8] = darkColor.b;
+                            tempVerts[v + 9] = darkColor.a;
+                        }
                     }
                     finalVertices = tempVerts;
                     finalVerticesLength = numFloats;
@@ -10828,7 +11114,8 @@ var SubRenderItem = function SubRenderItem() {
                     _clipper.clipEndWithSlot(slot);
                     continue;
                 }
-                var indexStart = verticesLength / SpineGenerator.VERTEX_STRIDE;
+                var stride = tintBlack ? vertexStrideWithTint : vertexStrideWithoutTint;
+                var indexStart = verticesLength / stride;
                 var i = verticesLength;
                 var j = 0;
                 for(; j < finalVerticesLength;){
@@ -10837,12 +11124,18 @@ var SubRenderItem = function SubRenderItem() {
                     _vertices[i++] = x;
                     _vertices[i++] = y;
                     _vertices[i++] = z;
-                    _vertices[i++] = finalVertices[j++];
-                    _vertices[i++] = finalVertices[j++];
-                    _vertices[i++] = finalVertices[j++];
-                    _vertices[i++] = finalVertices[j++];
-                    _vertices[i++] = finalVertices[j++];
-                    _vertices[i++] = finalVertices[j++];
+                    _vertices[i++] = finalVertices[j++]; // u
+                    _vertices[i++] = finalVertices[j++]; // v
+                    _vertices[i++] = finalVertices[j++]; // r
+                    _vertices[i++] = finalVertices[j++]; // g
+                    _vertices[i++] = finalVertices[j++]; // b
+                    _vertices[i++] = finalVertices[j++]; // a
+                    if (tintBlack) {
+                        _vertices[i++] = finalVertices[j++]; // darkR
+                        _vertices[i++] = finalVertices[j++]; // darkG
+                        _vertices[i++] = finalVertices[j++]; // darkB
+                        j++; // darkA
+                    }
                     this._expandBounds(x, y, z, _localBounds);
                 }
                 verticesLength = i;
@@ -10899,27 +11192,24 @@ var SubRenderItem = function SubRenderItem() {
             subPrimitivePool.return(item);
         }
         renderer._clearSubPrimitives();
-        var materialCache = SpineAnimationRenderer._materialCache;
         for(var i2 = 0, l = curLen; i2 < l; ++i2){
             var item1 = _subRenderItems[i2];
             var slotName1 = item1.slotName, blendMode = item1.blendMode, texture1 = item1.texture;
             renderer._addSubPrimitive(item1.subPrimitive);
             var subTexture = _separateSlotTextureMap.get(slotName1) || texture1.getImage();
-            var key = subTexture.instanceId + "_" + blendMode + "_" + premultipliedAlpha;
-            var material = materialCache.get(key);
-            if (!material) {
-                material = this._createMaterialForTexture(subTexture, engine, blendMode, premultipliedAlpha);
-                materialCache.set(key, material);
-            }
+            var material = renderer._getMaterial(subTexture, blendMode);
             renderer.setMaterial(i2, material);
         }
-        if (indicesLength > _vertexCount) {
+        if (indicesLength > _vertexCount || renderer._needResizeBuffer) {
             renderer._createAndBindBuffer(indicesLength);
+            renderer._needResizeBuffer = false;
             this.buildPrimitive(skeleton, renderer);
             return;
         }
-        renderer._vertexBuffer.setData(_vertices);
-        renderer._indexBuffer.setData(_indices);
+        if (renderer._vertexBuffer) {
+            renderer._vertexBuffer.setData(_vertices);
+            renderer._indexBuffer.setData(_indices);
+        }
     };
     _proto.addSeparateSlot = function addSeparateSlot(slotName) {
         this._separateSlots.set(slotName, slotName);
@@ -10927,12 +11217,6 @@ var SubRenderItem = function SubRenderItem() {
     _proto.addSeparateSlotTexture = function addSeparateSlotTexture(slotName, texture) {
         this._separateSlotTextureMap.set(slotName, texture);
     };
-    _proto._createMaterialForTexture = function _createMaterialForTexture(texture, engine, blendMode, premultipliedAlpha) {
-        var material = SpineAnimationRenderer._getDefaultMaterial(engine);
-        material.shaderData.setTexture("material_SpineTexture", texture);
-        setBlendMode(material, blendMode, premultipliedAlpha);
-        return material;
-    };
     _proto._createRenderItem = function _createRenderItem(subPrimitives, primitiveIndex, start, count, texture, blend, slotName) {
         var subPrimitivePool = SpineGenerator.subPrimitivePool, subRenderItemPool = SpineGenerator.subRenderItemPool;
         var origin = subPrimitives[primitiveIndex];
@@ -10957,8 +11241,8 @@ var SubRenderItem = function SubRenderItem() {
     };
     return SpineGenerator;
 }();
-SpineGenerator.VERTEX_SIZE = 8;
-SpineGenerator.VERTEX_STRIDE = 9;
+SpineGenerator.vertexStrideWithoutTint = 9;
+SpineGenerator.vertexStrideWithTint = 12;
 SpineGenerator.tempDark = new Color();
 SpineGenerator.tempColor = new Color();
 SpineGenerator.tempVerts = new Array(8);
@@ -10973,25 +11257,92 @@ SpineGenerator.QUAD_TRIANGLES = [
 SpineGenerator.subPrimitivePool = new ReturnablePool(engine.SubPrimitive);
 SpineGenerator.subRenderItemPool = new ClearablePool(SubRenderItem);
 
+var SourceAlpha = engine.BlendFactor.SourceAlpha, One = engine.BlendFactor.One, DestinationColor = engine.BlendFactor.DestinationColor, OneMinusSourceColor = engine.BlendFactor.OneMinusSourceColor, OneMinusSourceAlpha = engine.BlendFactor.OneMinusSourceAlpha;
+var Add = engine.BlendOperation.Add;
 var SpineMaterial = /*#__PURE__*/ function(Material) {
     _inherits(SpineMaterial, Material);
     function SpineMaterial(engine$1) {
         var _this;
         var shader = engine.Shader.find("galacean-spine-shader") || engine.Shader.create("galacean-spine-shader", SpineMaterial._spineVS, SpineMaterial._spineFS);
-        _this = Material.call(this, engine$1, shader) || this;
+        _this = Material.call(this, engine$1, shader) || this, _this._blendMode = exports.BlendMode.Normal;
         var renderState = _this.renderState;
         var target = renderState.blendState.targetBlendState;
         target.enabled = true;
-        setBlendMode(_this, exports.BlendMode.Normal, false);
+        _this._setBlendMode(exports.BlendMode.Normal, false);
         renderState.depthState.writeEnabled = false;
         renderState.rasterState.cullMode = engine.CullMode.Off;
         renderState.renderQueueType = engine.RenderQueueType.Transparent;
         return _this;
     }
+    var _proto = SpineMaterial.prototype;
+    /**
+   * @internal
+   */ _proto._setTintBlack = function _setTintBlack(enabled) {
+        if (enabled) {
+            this.shaderData.enableMacro("RENDERER_TINT_BLACK");
+        } else {
+            this.shaderData.disableMacro("RENDERER_TINT_BLACK");
+        }
+    };
+    /**
+   * @internal
+   */ _proto._setPremultipliedAlpha = function _setPremultipliedAlpha(enabled) {
+        if (enabled) {
+            this.shaderData.setFloat("renderer_PremultipliedAlpha", 1);
+        } else {
+            this.shaderData.setFloat("renderer_PremultipliedAlpha", 0);
+        }
+    };
+    /**
+   * @internal
+   */ _proto._setTexture = function _setTexture(value) {
+        this.shaderData.setTexture("material_SpineTexture", value);
+    };
+    /**
+   * @internal
+   */ _proto._setBlendMode = function _setBlendMode(blendMode, premultipliedAlpha) {
+        var target = this.renderState.blendState.targetBlendState;
+        this._blendMode = blendMode;
+        switch(blendMode){
+            case exports.BlendMode.Additive:
+                target.sourceColorBlendFactor = premultipliedAlpha ? One : SourceAlpha;
+                target.destinationColorBlendFactor = One;
+                target.sourceAlphaBlendFactor = One;
+                target.destinationAlphaBlendFactor = One;
+                target.colorBlendOperation = target.alphaBlendOperation = Add;
+                break;
+            case exports.BlendMode.Multiply:
+                target.sourceColorBlendFactor = DestinationColor;
+                target.destinationColorBlendFactor = OneMinusSourceAlpha;
+                target.sourceAlphaBlendFactor = One;
+                target.destinationAlphaBlendFactor = OneMinusSourceAlpha;
+                target.colorBlendOperation = target.alphaBlendOperation = Add;
+                break;
+            case exports.BlendMode.Screen:
+                target.sourceColorBlendFactor = One;
+                target.destinationColorBlendFactor = OneMinusSourceColor;
+                target.sourceAlphaBlendFactor = One;
+                target.destinationAlphaBlendFactor = OneMinusSourceColor;
+                target.colorBlendOperation = target.alphaBlendOperation = Add;
+                break;
+            default:
+                target.sourceColorBlendFactor = premultipliedAlpha ? One : SourceAlpha;
+                target.destinationColorBlendFactor = OneMinusSourceAlpha;
+                target.sourceAlphaBlendFactor = One;
+                target.destinationAlphaBlendFactor = OneMinusSourceAlpha;
+                target.colorBlendOperation = target.alphaBlendOperation = Add;
+                break;
+        }
+    };
+    /**
+   * @internal
+   */ _proto._getBlendMode = function _getBlendMode() {
+        return this._blendMode;
+    };
     return SpineMaterial;
 }(engine.Material);
-SpineMaterial._spineVS = "\n    uniform mat4 renderer_MVPMat;\n\n    attribute vec3 POSITION;\n    attribute vec2 TEXCOORD_0;\n    attribute vec4 COLOR_0;\n    \n    varying vec2 v_uv;\n    varying vec4 v_color;\n    \n    void main()\n    {\n      gl_Position = renderer_MVPMat * vec4(POSITION, 1.0);\n    \n      v_uv = TEXCOORD_0;\n      v_color = COLOR_0;\n    }\n  ";
-SpineMaterial._spineFS = "\n    uniform sampler2D material_SpineTexture;\n\n    varying vec2 v_uv;\n    varying vec4 v_color;\n    \n    void main()\n    {\n        vec4 baseColor = texture2D(material_SpineTexture, v_uv);\n        gl_FragColor = baseColor * v_color;\n    }\n   ";
+SpineMaterial._spineVS = "\n    uniform mat4 renderer_MVPMat;\n\n    attribute vec3 POSITION;\n    attribute vec2 TEXCOORD_0;\n    attribute vec4 LIGHT_COLOR;\n    \n    varying vec2 v_uv;\n    varying vec4 v_lightColor;\n\n    #ifdef RENDERER_TINT_BLACK\n      attribute vec3 DARK_COLOR;\n      varying vec3 v_darkColor;\n    #endif\n    \n    void main()\n    {\n      gl_Position = renderer_MVPMat * vec4(POSITION, 1.0);\n    \n      v_uv = TEXCOORD_0;\n      v_lightColor = LIGHT_COLOR;\n\n      #ifdef RENDERER_TINT_BLACK\n        v_darkColor = DARK_COLOR;\n      #endif\n    }\n  ";
+SpineMaterial._spineFS = "\n    #include <common>\n    uniform sampler2D material_SpineTexture;\n    uniform float renderer_PremultipliedAlpha;\n\n    varying vec2 v_uv;\n    varying vec4 v_lightColor;\n\n    #ifdef RENDERER_TINT_BLACK\n      varying vec3 v_darkColor;\n    #endif\n    \n    void main()\n    {\n      vec4 texColor = texture2D(material_SpineTexture, v_uv);\n      vec4 lightColor = sRGBToLinear(v_lightColor);\n      #ifdef RENDERER_TINT_BLACK\n        vec4 darkColor = sRGBToLinear(vec4(v_darkColor, 1.0));\n        vec3 dark_premult = (texColor.a - texColor.rgb) * darkColor.rgb;\n        vec3 dark_nonpremult = (1.0 - texColor.rgb) * darkColor.rgb;\n        vec3 dark = mix(dark_nonpremult, dark_premult, renderer_PremultipliedAlpha);\n        vec3 light = texColor.rgb * lightColor.rgb;\n        gl_FragColor.rgb = dark + light;\n        gl_FragColor.a = texColor.a * lightColor.a;\n      #else\n        gl_FragColor = texColor * lightColor;\n      #endif\n    }\n  ";
 
 /**
  * Spine animation renderer, capable of rendering spine animations and providing functions for animation and skeleton manipulation.
@@ -11006,15 +11357,16 @@ SpineMaterial._spineFS = "\n    uniform sampler2D material_SpineTexture;\n\n
    * When enabled, vertex color values are multiplied by the alpha channel.
    * @remarks
  If this option is enabled, the Spine editor must export textures with "Premultiply Alpha" checked.
-   */ _this.premultipliedAlpha = false, /**
+   */ _this.premultipliedAlpha = false, _this._tintBlack = false, /**
    * Default state for spine animation.
    * Contains the default animation name to be played, whether this animation should loop, the default skin name.
    */ _this.defaultConfig = new SpineAnimationDefaultConfig(), /** @internal */ _this._subPrimitives = [], /** @internal */ _this._vertices = new Float32Array(), /** @internal */ _this._indices = new Uint16Array(), /** @internal */ _this._needResizeBuffer = false, /** @internal */ _this._vertexCount = 0, /** @internal */ _this._localBounds = new engine.BoundingBox(new engine.Vector3(Infinity, Infinity, Infinity), new engine.Vector3(-Infinity, -Infinity, -Infinity));
         var primitive = new engine.Primitive(_this._engine);
         _this._primitive = primitive;
         primitive.addVertexElement(SpineAnimationRenderer._positionVertexElement);
-        primitive.addVertexElement(SpineAnimationRenderer._colorVertexElement);
+        primitive.addVertexElement(SpineAnimationRenderer._lightColorVertexElement);
         primitive.addVertexElement(SpineAnimationRenderer._uvVertexElement);
+        primitive.addVertexElement(SpineAnimationRenderer._darkColorVertexElement);
         return _this;
     }
     var _proto = SpineAnimationRenderer.prototype;
@@ -11108,9 +11460,10 @@ SpineMaterial._spineFS = "\n    uniform sampler2D material_SpineTexture;\n\n
    */ _proto._createAndBindBuffer = function _createAndBindBuffer(vertexCount) {
         var _this = this, _engine = _this._engine, _primitive = _this._primitive;
         this._vertexCount = vertexCount;
-        this._vertices = new Float32Array(vertexCount * SpineGenerator.VERTEX_STRIDE);
+        var stride = this.tintBlack ? SpineGenerator.vertexStrideWithTint : SpineGenerator.vertexStrideWithoutTint;
+        this._vertices = new Float32Array(vertexCount * stride);
         this._indices = new Uint16Array(vertexCount);
-        var vertexStride = SpineGenerator.VERTEX_STRIDE * 4;
+        var vertexStride = stride << 2;
         var vertexBuffer = new engine.Buffer(_engine, engine.BufferBindFlag.VertexBuffer, this._vertices, engine.BufferUsage.Dynamic);
         var indexBuffer = new engine.Buffer(_engine, engine.BufferBindFlag.IndexBuffer, this._indices, engine.BufferUsage.Dynamic);
         this._indexBuffer = indexBuffer;
@@ -11130,14 +11483,34 @@ SpineMaterial._spineFS = "\n    uniform sampler2D material_SpineTexture;\n\n
    */ _proto._clearSubPrimitives = function _clearSubPrimitives() {
         this._subPrimitives.length = 0;
     };
+    /**
+   * @internal
+   */ _proto._getMaterial = function _getMaterial(texture, blendMode) {
+        var engine = this._engine;
+        var premultipliedAlpha = this.premultipliedAlpha;
+        var tintBlack = this.tintBlack;
+        var key = texture.instanceId + "_" + blendMode + "_" + (premultipliedAlpha ? 1 : 0);
+        var cached = SpineAnimationRenderer._materialCacheMap[key];
+        if (!cached) {
+            cached = new SpineMaterial(engine);
+            cached.isGCIgnored = true;
+            SpineAnimationRenderer._materialCacheMap.set(key, cached);
+        }
+        cached._setBlendMode(blendMode, premultipliedAlpha);
+        cached._setTexture(texture);
+        cached._setTintBlack(tintBlack);
+        cached._setPremultipliedAlpha(premultipliedAlpha);
+        return cached;
+    };
     _proto._clearMaterialCache = function _clearMaterialCache() {
-        var materialCache = SpineAnimationRenderer._materialCache;
-        var _this = this, materials = _this._materials;
+        var materialCache = SpineAnimationRenderer._materialCacheMap;
+        var premultipliedAlpha = this.premultipliedAlpha;
+        var materials = this._materials;
         for(var i = 0, len = materials.length; i < len; i += 1){
             var material = materials[i];
             var texture = material.shaderData.getTexture("material_SpineTexture");
-            var blendMode = getBlendMode(material);
-            var key = texture.instanceId + "_" + blendMode;
+            var blendMode = material._getBlendMode();
+            var key = texture.instanceId + "_" + blendMode + "_" + (premultipliedAlpha ? 1 : 0);
             materialCache.delete(key);
         }
     };
@@ -11154,22 +11527,23 @@ SpineMaterial._spineFS = "\n    uniform sampler2D material_SpineTexture;\n\n
             }
         }
     };
-    /** @internal */ SpineAnimationRenderer._getDefaultMaterial = function _getDefaultMaterial(engine) {
-        var defaultMaterial = this._defaultMaterial;
-        if (defaultMaterial) {
-            if (defaultMaterial.engine === engine) {
-                return defaultMaterial.clone();
-            } else {
-                defaultMaterial.destroy(true);
-                defaultMaterial = null;
-            }
-        }
-        defaultMaterial = new SpineMaterial(engine);
-        defaultMaterial.isGCIgnored = true;
-        this._defaultMaterial = defaultMaterial;
-        return defaultMaterial.clone();
-    };
     _create_class(SpineAnimationRenderer, [
+        {
+            key: "tintBlack",
+            get: /**
+   * Whether to enable tint black feature for dark color tinting.
+   *
+   * @remarks Should be enabled when using "Tint Black" feature in Spine editor.
+   */ function get() {
+                return this._tintBlack;
+            },
+            set: function set(value) {
+                if (this._tintBlack !== value) {
+                    this._tintBlack = value;
+                    this._needResizeBuffer = true;
+                }
+            }
+        },
         {
             key: "state",
             get: /**
@@ -11223,15 +11597,19 @@ SpineMaterial._spineFS = "\n    uniform sampler2D material_SpineTexture;\n\n
 }(engine.Renderer);
 SpineAnimationRenderer._spineGenerator = new SpineGenerator();
 SpineAnimationRenderer._positionVertexElement = new engine.VertexElement("POSITION", 0, engine.VertexElementFormat.Vector3, 0);
-SpineAnimationRenderer._colorVertexElement = new engine.VertexElement("COLOR_0", 12, engine.VertexElementFormat.Vector4, 0);
+SpineAnimationRenderer._lightColorVertexElement = new engine.VertexElement("LIGHT_COLOR", 12, engine.VertexElementFormat.Vector4, 0);
 SpineAnimationRenderer._uvVertexElement = new engine.VertexElement("TEXCOORD_0", 28, engine.VertexElementFormat.Vector2, 0);
-/** @internal */ SpineAnimationRenderer._materialCache = new Map();
+SpineAnimationRenderer._darkColorVertexElement = new engine.VertexElement("DARK_COLOR", 36, engine.VertexElementFormat.Vector3, 0);
+/** @internal */ SpineAnimationRenderer._materialCacheMap = new Map();
 __decorate([
     engine.assignmentClone
 ], SpineAnimationRenderer.prototype, "zSpacing", void 0);
 __decorate([
     engine.assignmentClone
 ], SpineAnimationRenderer.prototype, "premultipliedAlpha", void 0);
+__decorate([
+    engine.assignmentClone
+], SpineAnimationRenderer.prototype, "_tintBlack", void 0);
 __decorate([
     engine.deepClone
 ], SpineAnimationRenderer.prototype, "defaultConfig", void 0);
@@ -11632,7 +12010,7 @@ for(var key in RendererObject){
 for(var key1 in LoaderObject){
     engine.Loader.registerClass(key1, LoaderObject[key1]);
 }
-var version = "4.2.1";
+var version = "4.2.3";
 console.log("Galacean spine version: " + version);
 
 exports.AlphaTimeline = AlphaTimeline;