@eva/spine-base 2.0.1-beta.3 → 2.0.1-beta.31

package/dist/EVA.plugin.spineBase.js

@@ -1,7 +1,7 @@
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 globalThis.EVA = globalThis.EVA || {};
 globalThis.EVA.plugin = globalThis.EVA.plugin || {};
-var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer, pixi_js) {
+var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer) {
   'use strict';
   function __decorate(decorators, target, key, desc) {
     var c = arguments.length,
@@ -61,6 +61,7 @@ var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer, pixi_js) {
       this.scale = 1;
       this.animationName = '';
       this.autoPlay = true;
+      this.keepResource = false;
       this.waitExecuteInfos = [];
     }
     set armature(val) {
@@ -176,6 +177,7 @@ var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer, pixi_js) {
   __decorate([type('number')], Spine.prototype, "scale", void 0);
   __decorate([type('string')], Spine.prototype, "animationName", void 0);
   __decorate([type('boolean')], Spine.prototype, "autoPlay", void 0);
+  __decorate([type('boolean')], Spine.prototype, "keepResource", void 0);
   let dataMap = {};
   function createSpineData(name, data, scale, pixiSpine) {
     const skeletonAsset = data.ske;
@@ -215,14 +217,6 @@ var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer, pixi_js) {
     data.ref--;
     setTimeout(() => __awaiter(this, void 0, void 0, function* () {
       if (data.ref <= 0) {
-        yield pixi_js.Assets.unload([res.src.image.url, res.src.atlas.url, res.src.ske.url]);
-        const resolver = pixi_js.Assets.resolver;
-        delete resolver._assetMap[res.src.image.url];
-        delete resolver._assetMap[res.src.atlas.url];
-        delete resolver._assetMap[res.src.ske.url];
-        delete resolver._resolverHash[res.src.image.url];
-        delete resolver._resolverHash[res.src.atlas.url];
-        delete resolver._resolverHash[res.src.ske.url];
         eva_js.resource.destroy(resourceName);
         delete dataMap[resourceName];
       }
@@ -396,9 +390,11 @@ var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer, pixi_js) {
           component.armature.destroy({
             children: true
           });
-          const res = yield eva_js.resource.getResource(component.lastResource);
-          ((_d = (_c = res.data) === null || _c === void 0 ? void 0 : _c.image) === null || _d === void 0 ? void 0 : _d.src) || ((_f = (_e = res.data) === null || _e === void 0 ? void 0 : _e.image) === null || _f === void 0 ? void 0 : _f.label);
-          releaseSpineData(res);
+          if (!component.keepResource) {
+            const res = yield eva_js.resource.getResource(component.lastResource);
+            ((_d = (_c = res.data) === null || _c === void 0 ? void 0 : _c.image) === null || _d === void 0 ? void 0 : _d.src) || ((_f = (_e = res.data) === null || _e === void 0 ? void 0 : _e.image) === null || _f === void 0 ? void 0 : _f.label);
+            releaseSpineData(res);
+          }
         }
         component.armature = null;
         delete this.armatures[changed.gameObject.id];
@@ -418,5 +414,5 @@ var _EVA_IIFE_spineBase = function (exports, eva_js, pluginRenderer, pixi_js) {
     value: true
   });
   return exports;
-}({}, EVA, EVA.plugin.renderer, PIXI);
+}({}, EVA, EVA.plugin.renderer);
 globalThis.EVA.plugin.spineBase = globalThis.EVA.plugin.spineBase || _EVA_IIFE_spineBase;

package/dist/EVA.plugin.spineBase.min.js

@@ -1 +1 @@
-function _extends(){return _extends=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var a in r)({}).hasOwnProperty.call(r,a)&&(e[a]=r[a])}return e},_extends.apply(null,arguments)}globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{};var _EVA_IIFE_spineBase=function(e,t,r,a){"use strict";function n(e,t,r,a){var n,i=arguments.length,s=i<3?t:null===a?a=Object.getOwnPropertyDescriptor(t,r):a;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,a);else for(var o=e.length-1;o>=0;o--)(n=e[o])&&(s=(i<3?n(s):i>3?n(t,r,s):n(t,r))||s);return i>3&&s&&Object.defineProperty(t,r,s),s}function i(e,t,r,a){return new(r||(r=Promise))((function(n,i){function s(e){try{c(a.next(e))}catch(e){i(e)}}function o(e){try{c(a.throw(e))}catch(e){i(e)}}function c(e){var t;e.done?n(e.value):(t=e.value,t instanceof r?t:new r((function(e){e(t)}))).then(s,o)}c((a=a.apply(e,t||[])).next())}))}function s(e){return function(t,r){var a=function(e,t){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[t]||(e.constructor.IDEProps[t]={}),e.constructor.IDEProps[t]}(t,r);a.key=r,a.type=e}}class o extends t.Component{constructor(){super(...arguments),this.resource="",this.scale=1,this.animationName="",this.autoPlay=!0,this.waitExecuteInfos=[]}set armature(e){if(this._armature=e,e){this.autoPlay&&this.play(this.animationName);for(const e of this.waitExecuteInfos)if(e.playType){const{name:t,loop:r,track:a}=e;this.play(t,r,a)}else this.stop(e.track);this.waitExecuteInfos=[]}}get armature(){return this._armature}init(e){e&&_extends(this,e)}onDestroy(){this.destroied=!0}play(e,t,r){try{const a=null!=t?t:this.autoPlay;e&&(this.animationName=e),this.armature?(void 0===r&&(r=0),this.armature.state.setAnimation(r,this.animationName,a)):this.waitExecuteInfos.push({playType:!0,name:e,loop:a,track:r})}catch(e){console.log(e)}}stop(e){this.armature?(void 0===e&&(e=0),this.armature.state.setEmptyAnimation(e,0)):this.waitExecuteInfos.push({playType:!1,track:e})}addAnimation(e,t,r,a){try{this.armature&&(void 0===a&&(a=0),this.armature.state.addAnimation(a,e,r,t))}catch(e){console.log(e)}}setMix(e,t,r){this.armature&&this.armature.state.data.setMix(e,t,r)}getAnim(e=0){try{if(this.armature)return this.armature.state.tracks[e].animation.name}catch(e){console.log(e)}}setDefaultMix(e){this.armature&&(this.armature.state.data.defaultMix=e)}setAttachment(e,t){this.armature&&this.armature.skeleton.setAttachment(e,t)}getBone(e){if(this.armature)return this.armature.skeleton.findBone(e)}}o.componentName="Spine",n([s("string")],o.prototype,"resource",void 0),n([s("number")],o.prototype,"scale",void 0),n([s("string")],o.prototype,"animationName",void 0),n([s("boolean")],o.prototype,"autoPlay",void 0);let c={};function u(e,t,r){return i(this,void 0,void 0,(function*(){let a=c[e.name];if(!a)if(e.complete)a=function(e,t,r,a){const n=t.ske,i=t.atlas,s=new a.AtlasAttachmentLoader(i),o=n instanceof Uint8Array?new a.SkeletonBinary(s):new a.SkeletonJson(s);o.scale=r||1;const u={spineData:o.readSkeletonData(n),ref:0,imageSrc:t.image.label};return c[e]=u,u}(e.name,e.data,t,r);else if(!a)return;return a.ref++,a.spineData}))}let l=class extends r.Renderer{constructor(){super(...arguments),this.armatures={}}init({pixiSpine:e}){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this),this.pixiSpine=e,this.game.canvas.addEventListener("webglcontextrestored",(()=>{const e=this.game.gameObjects;let r=[];for(let a in this.armatures){const n=+a;for(let a=0;a<e.length;++a){let i=e[a];if(i.id===n){let e=i.getComponent(o);e&&(this.remove({type:t.OBSERVER_TYPE.REMOVE,gameObject:i,component:e,componentName:o.componentName}),r.push({type:t.OBSERVER_TYPE.ADD,gameObject:i,component:e,componentName:o.componentName}));break}}}setTimeout((()=>{r.forEach((e=>{this.add(e)}))}),1e3)}),!1)}update(e){for(let t in this.armatures)this.armatures[t].update(.001*e.deltaTime);super.update()}componentChanged(e){return i(this,void 0,void 0,(function*(){if("Spine"===e.componentName)if(e.type===t.OBSERVER_TYPE.ADD)this.add(e);else if(e.type===t.OBSERVER_TYPE.CHANGE){if("resource"===e.prop.prop[0])this.change(e)}else e.type===t.OBSERVER_TYPE.REMOVE&&this.remove(e)}))}add(e,r){var a,n;return i(this,void 0,void 0,(function*(){const i=e.component;clearTimeout(i.addHandler);const s=e.gameObject.id,o=this.increaseAsyncId(s),c=yield t.resource.getResource(i.resource);if(!this.validateAsyncId(s,o))return;const l=yield u(c,i.scale,this.pixiSpine);if(!this.validateAsyncId(s,o))return;if(!l)return void(i.addHandler=setTimeout((()=>{i.destroied||(void 0===r&&(r=20),--r>0?this.add(e,r):console.log("retry exceed max times",i.resource))}),1e3));this.remove(e);const m=null===(n=null===(a=this.renderSystem)||void 0===a?void 0:a.containerManager)||void 0===n?void 0:n.getContainer(e.gameObject.id);if(!m)return;i.lastResource=i.resource;const d=new this.pixiSpine.Spine({skeletonData:l,autoUpdate:!1});if(this.armatures[e.gameObject.id]=d,e.gameObject&&e.gameObject.transform){const t=e.gameObject.transform;d.x=t.size.width*t.origin.x,d.y=t.size.height*t.origin.y}m.addChildAt(d,0),d.update(),i.armature=d,i.emit("loaded",{resource:i.resource}),d.state.addListener({start:(e,t)=>{i.emit("start",{track:e,name:e.animation.name})},complete:(e,t)=>{i.emit("complete",{track:e,name:e.animation.name})},interrupt:(e,t)=>{i.emit("interrupt",{track:e,name:e.animation.name})},end:(e,t)=>{i.emit("end",{track:e,name:e.animation.name})},event:(e,t)=>{i.emit("event",e,t)}})}))}change(e){this.remove(e),this.add(e)}remove(e){var r,n,s,o,u,l;return i(this,void 0,void 0,(function*(){this.increaseAsyncId(e.gameObject.id);const m=e.component;clearTimeout(m.addHandler);const d=this.armatures[e.gameObject.id],h=null===(n=null===(r=this.renderSystem)||void 0===r?void 0:r.containerManager)||void 0===n?void 0:n.getContainer(e.gameObject.id);if(h&&d&&h.removeChild(d),m.armature){m.armature.destroy({children:!0});const e=yield t.resource.getResource(m.lastResource);(null===(o=null===(s=e.data)||void 0===s?void 0:s.image)||void 0===o?void 0:o.src)||null===(l=null===(u=e.data)||void 0===u?void 0:u.image)||void 0===l||l.label,function(e){const r=e.name,n=c[r];n&&(n.ref--,setTimeout((()=>i(this,void 0,void 0,(function*(){if(n.ref<=0){yield a.Assets.unload([e.src.image.url,e.src.atlas.url,e.src.ske.url]);const n=a.Assets.resolver;delete n._assetMap[e.src.image.url],delete n._assetMap[e.src.atlas.url],delete n._assetMap[e.src.ske.url],delete n._resolverHash[e.src.image.url],delete n._resolverHash[e.src.atlas.url],delete n._resolverHash[e.src.ske.url],t.resource.destroy(r),delete c[r]}}))),100))}(e)}m.armature=null,delete this.armatures[e.gameObject.id],e.type,t.OBSERVER_TYPE.CHANGE}))}};l.systemName="SpineSystem",l=n([t.decorators.componentObserver({Spine:["resource"]})],l);var m=l;return t.resource.registerResourceType("SPINE"),e.Spine=o,e.SpineSystem=m,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,PIXI);globalThis.EVA.plugin.spineBase=globalThis.EVA.plugin.spineBase||_EVA_IIFE_spineBase;
+function _extends(){return _extends=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var a in n)({}).hasOwnProperty.call(n,a)&&(e[a]=n[a])}return e},_extends.apply(null,arguments)}globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{};var _EVA_IIFE_spineBase=function(e,t,n){"use strict";function a(e,t,n,a){var i,r=arguments.length,o=r<3?t:null===a?a=Object.getOwnPropertyDescriptor(t,n):a;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,t,n,a);else for(var s=e.length-1;s>=0;s--)(i=e[s])&&(o=(r<3?i(o):r>3?i(t,n,o):i(t,n))||o);return r>3&&o&&Object.defineProperty(t,n,o),o}function i(e,t,n,a){return new(n||(n=Promise))((function(i,r){function o(e){try{c(a.next(e))}catch(e){r(e)}}function s(e){try{c(a.throw(e))}catch(e){r(e)}}function c(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(o,s)}c((a=a.apply(e,t||[])).next())}))}function r(e){return function(t,n){var a=function(e,t){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[t]||(e.constructor.IDEProps[t]={}),e.constructor.IDEProps[t]}(t,n);a.key=n,a.type=e}}class o extends t.Component{constructor(){super(...arguments),this.resource="",this.scale=1,this.animationName="",this.autoPlay=!0,this.keepResource=!1,this.waitExecuteInfos=[]}set armature(e){if(this._armature=e,e){this.autoPlay&&this.play(this.animationName);for(const e of this.waitExecuteInfos)if(e.playType){const{name:t,loop:n,track:a}=e;this.play(t,n,a)}else this.stop(e.track);this.waitExecuteInfos=[]}}get armature(){return this._armature}init(e){e&&_extends(this,e)}onDestroy(){this.destroied=!0}play(e,t,n){try{const a=null!=t?t:this.autoPlay;e&&(this.animationName=e),this.armature?(void 0===n&&(n=0),this.armature.state.setAnimation(n,this.animationName,a)):this.waitExecuteInfos.push({playType:!0,name:e,loop:a,track:n})}catch(e){console.log(e)}}stop(e){this.armature?(void 0===e&&(e=0),this.armature.state.setEmptyAnimation(e,0)):this.waitExecuteInfos.push({playType:!1,track:e})}addAnimation(e,t,n,a){try{this.armature&&(void 0===a&&(a=0),this.armature.state.addAnimation(a,e,n,t))}catch(e){console.log(e)}}setMix(e,t,n){this.armature&&this.armature.state.data.setMix(e,t,n)}getAnim(e=0){try{if(this.armature)return this.armature.state.tracks[e].animation.name}catch(e){console.log(e)}}setDefaultMix(e){this.armature&&(this.armature.state.data.defaultMix=e)}setAttachment(e,t){this.armature&&this.armature.skeleton.setAttachment(e,t)}getBone(e){if(this.armature)return this.armature.skeleton.findBone(e)}}o.componentName="Spine",a([r("string")],o.prototype,"resource",void 0),a([r("number")],o.prototype,"scale",void 0),a([r("string")],o.prototype,"animationName",void 0),a([r("boolean")],o.prototype,"autoPlay",void 0),a([r("boolean")],o.prototype,"keepResource",void 0);let s={};function c(e,t,n){return i(this,void 0,void 0,(function*(){let a=s[e.name];if(!a)if(e.complete)a=function(e,t,n,a){const i=t.ske,r=t.atlas,o=new a.AtlasAttachmentLoader(r),c=i instanceof Uint8Array?new a.SkeletonBinary(o):new a.SkeletonJson(o);c.scale=n||1;const u={spineData:c.readSkeletonData(i),ref:0,imageSrc:t.image.label};return s[e]=u,u}(e.name,e.data,t,n);else if(!a)return;return a.ref++,a.spineData}))}let u=class extends n.Renderer{constructor(){super(...arguments),this.armatures={}}init({pixiSpine:e}){this.renderSystem=this.game.getSystem(n.RendererSystem),this.renderSystem.rendererManager.register(this),this.pixiSpine=e,this.game.canvas.addEventListener("webglcontextrestored",(()=>{const e=this.game.gameObjects;let n=[];for(let a in this.armatures){const i=+a;for(let a=0;a<e.length;++a){let r=e[a];if(r.id===i){let e=r.getComponent(o);e&&(this.remove({type:t.OBSERVER_TYPE.REMOVE,gameObject:r,component:e,componentName:o.componentName}),n.push({type:t.OBSERVER_TYPE.ADD,gameObject:r,component:e,componentName:o.componentName}));break}}}setTimeout((()=>{n.forEach((e=>{this.add(e)}))}),1e3)}),!1)}update(e){for(let t in this.armatures)this.armatures[t].update(.001*e.deltaTime);super.update()}componentChanged(e){return i(this,void 0,void 0,(function*(){if("Spine"===e.componentName)if(e.type===t.OBSERVER_TYPE.ADD)this.add(e);else if(e.type===t.OBSERVER_TYPE.CHANGE){if("resource"===e.prop.prop[0])this.change(e)}else e.type===t.OBSERVER_TYPE.REMOVE&&this.remove(e)}))}add(e,n){var a,r;return i(this,void 0,void 0,(function*(){const i=e.component;clearTimeout(i.addHandler);const o=e.gameObject.id,s=this.increaseAsyncId(o),u=yield t.resource.getResource(i.resource);if(!this.validateAsyncId(o,s))return;const m=yield c(u,i.scale,this.pixiSpine);if(!this.validateAsyncId(o,s))return;if(!m)return void(i.addHandler=setTimeout((()=>{i.destroied||(void 0===n&&(n=20),--n>0?this.add(e,n):console.log("retry exceed max times",i.resource))}),1e3));this.remove(e);const d=null===(r=null===(a=this.renderSystem)||void 0===a?void 0:a.containerManager)||void 0===r?void 0:r.getContainer(e.gameObject.id);if(!d)return;i.lastResource=i.resource;const l=new this.pixiSpine.Spine({skeletonData:m,autoUpdate:!1});if(this.armatures[e.gameObject.id]=l,e.gameObject&&e.gameObject.transform){const t=e.gameObject.transform;l.x=t.size.width*t.origin.x,l.y=t.size.height*t.origin.y}d.addChildAt(l,0),l.update(),i.armature=l,i.emit("loaded",{resource:i.resource}),l.state.addListener({start:(e,t)=>{i.emit("start",{track:e,name:e.animation.name})},complete:(e,t)=>{i.emit("complete",{track:e,name:e.animation.name})},interrupt:(e,t)=>{i.emit("interrupt",{track:e,name:e.animation.name})},end:(e,t)=>{i.emit("end",{track:e,name:e.animation.name})},event:(e,t)=>{i.emit("event",e,t)}})}))}change(e){this.remove(e),this.add(e)}remove(e){var n,a,r,o,c,u;return i(this,void 0,void 0,(function*(){this.increaseAsyncId(e.gameObject.id);const m=e.component;clearTimeout(m.addHandler);const d=this.armatures[e.gameObject.id],l=null===(a=null===(n=this.renderSystem)||void 0===n?void 0:n.containerManager)||void 0===a?void 0:a.getContainer(e.gameObject.id);if(l&&d&&l.removeChild(d),m.armature&&(m.armature.destroy({children:!0}),!m.keepResource)){const e=yield t.resource.getResource(m.lastResource);(null===(o=null===(r=e.data)||void 0===r?void 0:r.image)||void 0===o?void 0:o.src)||null===(u=null===(c=e.data)||void 0===c?void 0:c.image)||void 0===u||u.label,function(e){const n=e.name,a=s[n];a&&(a.ref--,setTimeout((()=>i(this,void 0,void 0,(function*(){a.ref<=0&&(t.resource.destroy(n),delete s[n])}))),100))}(e)}m.armature=null,delete this.armatures[e.gameObject.id],e.type,t.OBSERVER_TYPE.CHANGE}))}};u.systemName="SpineSystem",u=a([t.decorators.componentObserver({Spine:["resource"]})],u);var m=u;return t.resource.registerResourceType("SPINE"),e.Spine=o,e.SpineSystem=m,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer);globalThis.EVA.plugin.spineBase=globalThis.EVA.plugin.spineBase||_EVA_IIFE_spineBase;

package/dist/spine-base.cjs.js

@@ -5,7 +5,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var eva_js = require('@eva/eva.js');
 var pluginRenderer = require('@eva/plugin-renderer');
 var inspectorDecorator = require('@eva/inspector-decorator');
-var pixi_js = require('pixi.js');
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation. All rights reserved.
@@ -38,15 +37,80 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
+/**
+ * Spine 骨骼动画组件
+ *
+ * Spine 组件用于播放 Esoteric Software 的 Spine 骨骼动画。
+ * 支持骨骼动画播放控制、动画混合、附件替换等高级功能，
+ * 适用于角色动画、复杂特效等需要骨骼动画的场景。
+ *
+ * 主要功能：
+ * - 骨骼动画播放和控制
+ * - 动画轨道管理（多动画并行）
+ * - 动画混合过渡
+ * - 骨骼和附件访问
+ * - 支持 Spine 3.6 和 3.8 版本
+ *
+ * @example
+ * ```typescript
+ * // 创建 Spine 动画
+ * const character = new GameObject('character');
+ * const spine = new Spine({
+ *   resource: 'heroSpine', // Spine 资源
+ *   animationName: 'idle', // 默认动画
+ *   autoPlay: true, // 自动播放
+ *   scale: 0.5 // 缩放比例
+ * });
+ * character.addComponent(spine);
+ *
+ * // 播放动画
+ * spine.play('walk', true); // 循环播放 walk 动画
+ *
+ * // 停止动画
+ * spine.stop();
+ *
+ * // 动画混合
+ * spine.setMix('idle', 'walk', 0.3); // 设置过渡时间
+ * spine.play('walk');
+ *
+ * // 添加动画队列
+ * spine.play('attack', false); // 播放攻击动画
+ * spine.addAnimation('idle', 0, true); // 攻击完成后回到 idle
+ *
+ * // 替换附件（换装）
+ * spine.setAttachment('weapon', 'sword'); // 将武器槽替换为剑
+ *
+ * // 访问骨骼
+ * const headBone = spine.getBone('head');
+ * if (headBone) {
+ *   headBone.rotation = 15; // 旋转头部
+ * }
+ *
+ * // 多轨道动画
+ * spine.play('walk', true, 0); // 轨道0：身体动画
+ * spine.play('shoot', false, 1); // 轨道1：上半身动画
+ * ```
+ */
 class Spine extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** Spine 资源名称 */
         this.resource = '';
+        /** 动画缩放比例 */
         this.scale = 1;
+        /** 当前播放的动画名称 */
         this.animationName = '';
+        /** 是否自动播放动画 */
         this.autoPlay = true;
+        /** 是否保留资源（销毁时不释放） */
+        this.keepResource = false;
+        /** 等待执行的动画操作队列 */
         this.waitExecuteInfos = [];
     }
+    /**
+     * 设置骨架实例
+     * 当骨架加载完成后自动执行等待队列中的动画操作
+     */
     set armature(val) {
         this._armature = val;
         if (!val)
@@ -65,17 +129,36 @@ class Spine extends eva_js.Component {
         }
         this.waitExecuteInfos = [];
     }
+    /** 获取骨架实例 */
     get armature() {
         return this._armature;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - Spine 资源名称
+     * @param obj.animationName - 默认动画名称
+     * @param obj.scale - 缩放比例
+     * @param obj.autoPlay - 是否自动播放
+     */
     init(obj) {
         if (!obj)
             return;
         Object.assign(this, obj);
     }
+    /** 组件销毁时调用 */
     onDestroy() {
         this.destroied = true;
     }
+    /**
+     * 播放指定动画
+     *
+     * 如果骨架尚未加载完成，动画操作将被加入等待队列。
+     *
+     * @param name - 动画名称，不指定则使用 animationName 属性
+     * @param loopAnimation - 是否循环播放，默认跟随 autoPlay 属性
+     * @param track - 动画轨道编号，默认为 0
+     */
     play(name, loopAnimation, track) {
         try {
             const loop = loopAnimation !== null && loopAnimation !== void 0 ? loopAnimation : this.autoPlay;
@@ -85,6 +168,12 @@ class Spine extends eva_js.Component {
                 this.waitExecuteInfos.push({
                     playType: true,
                     name,
+                    /**
+                     * 在 v1.2.2 之前，Spine 动画的 autoPlay 为 true，动画会循环播放 https://github.com/eva-engine/eva.js/pull/164/files#diff-46e9ae36c04e7a0abedc1e14fd9d1c4e81d8386e9bb851f85971ccdba8957804L131
+                     * 在 v1.2.2 之前，Spine 动画在每加载完( armature 设置之前)调用 play 是不生效的， 在 v1.2.2 [#164](https://github.com/eva-engine/eva.js/pull/164) 解决了这个问题
+                     * 解决了不生效的问题以后，加载完成之前调用 play 默认循环是false，导致 autoPlay 下本来循环动画不循环了，和之前表现不一致
+                     * 为了解决这个问题，在 autoPlay 的情况下，未加载完之前调用 play ，默认循环播放，除非设置不循环参数
+                     */
                     loop,
                     track,
                 });
@@ -100,6 +189,13 @@ class Spine extends eva_js.Component {
             console.log(e);
         }
     }
+    /**
+     * 停止指定轨道的动画
+     *
+     * 如果骨架尚未加载完成，停止操作将被加入等待队列。
+     *
+     * @param track - 动画轨道编号，默认为 0
+     */
     stop(track) {
         if (!this.armature) {
             this.waitExecuteInfos.push({
@@ -113,6 +209,16 @@ class Spine extends eva_js.Component {
         }
         this.armature.state.setEmptyAnimation(track, 0);
     }
+    /**
+     * 在当前动画之后添加新动画到队列
+     *
+     * 用于创建动画序列，当前动画播放完毕后自动播放下一个动画。
+     *
+     * @param name - 动画名称
+     * @param delay - 延迟时间（秒）
+     * @param loop - 是否循环播放
+     * @param track - 动画轨道编号，默认为 0
+     */
     addAnimation(name, delay, loop, track) {
         try {
             if (!this.armature) {
@@ -128,12 +234,27 @@ class Spine extends eva_js.Component {
             console.log(e);
         }
     }
+    /**
+     * 设置两个动画之间的混合过渡时间
+     *
+     * 当从一个动画切换到另一个动画时，会在指定时间内进行平滑过渡。
+     *
+     * @param from - 起始动画名称
+     * @param to - 目标动画名称
+     * @param duration - 过渡时长（秒）
+     */
     setMix(from, to, duration) {
         if (!this.armature) ;
         else {
             this.armature.state.data.setMix(from, to, duration);
         }
     }
+    /**
+     * 获取指定轨道当前播放的动画名称
+     *
+     * @param track - 动画轨道编号，默认为 0
+     * @returns 动画名称，如果未找到则返回 undefined
+     */
     getAnim(track = 0) {
         try {
             if (!this.armature) {
@@ -146,18 +267,41 @@ class Spine extends eva_js.Component {
             console.log(e);
         }
     }
+    /**
+     * 设置默认的动画混合时间
+     *
+     * 当没有为特定动画对指定混合时间时，将使用此默认值。
+     *
+     * @param duration - 默认混合时长（秒）
+     */
     setDefaultMix(duration) {
         if (!this.armature) ;
         else {
             this.armature.state.data.defaultMix = duration;
         }
     }
+    /**
+     * 替换指定插槽的附件
+     *
+     * 用于换装、武器切换等场景。
+     *
+     * @param slotName - 插槽名称
+     * @param attachmentName - 附件名称
+     */
     setAttachment(slotName, attachmentName) {
         if (!this.armature) {
             return;
         }
         this.armature.skeleton.setAttachment(slotName, attachmentName);
     }
+    /**
+     * 获取指定名称的骨骼
+     *
+     * 可用于直接操作骨骼的位置、旋转、缩放等属性。
+     *
+     * @param boneName - 骨骼名称
+     * @returns 骨骼对象，如果未找到则返回 undefined
+     */
     getBone(boneName) {
         if (!this.armature) {
             return;
@@ -165,6 +309,7 @@ class Spine extends eva_js.Component {
         return this.armature.skeleton.findBone(boneName);
     }
 }
+/** 组件名称 */
 Spine.componentName = 'Spine';
 __decorate([
     inspectorDecorator.type('string')
@@ -177,7 +322,10 @@ __decorate([
 ], Spine.prototype, "animationName", void 0);
 __decorate([
     inspectorDecorator.type('boolean')
-], Spine.prototype, "autoPlay", void 0);
+], Spine.prototype, "autoPlay", void 0);
+__decorate([
+    inspectorDecorator.type('boolean')
+], Spine.prototype, "keepResource", void 0);
 
 let dataMap = {};
 function createSpineData(name, data, scale, pixiSpine) {
@@ -217,14 +365,6 @@ function releaseSpineData(res, _imageSrc) {
     data.ref--;
     setTimeout(() => __awaiter(this, void 0, void 0, function* () {
         if (data.ref <= 0) {
-            yield pixi_js.Assets.unload([res.src.image.url, res.src.atlas.url, res.src.ske.url]);
-            const resolver = pixi_js.Assets.resolver;
-            delete resolver._assetMap[res.src.image.url];
-            delete resolver._assetMap[res.src.atlas.url];
-            delete resolver._assetMap[res.src.ske.url];
-            delete resolver._resolverHash[res.src.image.url];
-            delete resolver._resolverHash[res.src.atlas.url];
-            delete resolver._resolverHash[res.src.ske.url];
             eva_js.resource.destroy(resourceName);
             delete dataMap[resourceName];
         }
@@ -232,17 +372,39 @@ function releaseSpineData(res, _imageSrc) {
 }
 
 const MaxRetryCount = 20;
+/**
+ * Spine 骨骼动画系统
+ *
+ * SpineSystem 负责管理所有 Spine 组件的骨架创建、动画更新和资源管理。
+ * 系统会监听 Spine 组件的变化，自动加载骨骼数据并创建动画实例，
+ * 并在每帧更新所有活跃的 Spine 动画。
+ *
+ * 主要功能：
+ * - 骨骼数据加载和缓存
+ * - 动画实例创建和销毁
+ * - 每帧动画状态更新
+ * - WebGL 上下文恢复处理
+ * - 资源重试机制
+ */
 let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
     constructor() {
         super(...arguments);
+        /** 骨架实例映射表（游戏对象 ID -> 骨架容器） */
         this.armatures = {};
     }
+    /**
+     * 初始化系统
+     * @param obj - 初始化参数
+     * @param obj.pixiSpine - PixiJS Spine 插件实例
+     */
     init({ pixiSpine }) {
         this.renderSystem = this.game.getSystem(pluginRenderer.RendererSystem);
         this.renderSystem.rendererManager.register(this);
         this.pixiSpine = pixiSpine;
         this.game.canvas.addEventListener('webglcontextrestored', () => {
+            // 重建所有spine
             const objs = this.game.gameObjects;
+            // clearCache();
             let toAdd = [];
             for (let k in this.armatures) {
                 const id = +k;
@@ -275,8 +437,14 @@ let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
             }, 1000);
         }, false);
     }
+    /**
+     * 每帧更新所有 Spine 动画
+     * @param e - 更新参数，包含帧间隔时间
+     */
     update(e) {
         for (let key in this.armatures) {
+            // TODO: 类型
+            // @ts-ignore
             this.armatures[key].update(e.deltaTime * 0.001);
         }
         super.update();
@@ -317,6 +485,7 @@ let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
                 component.addHandler = setTimeout(() => {
                     if (!component.destroied) {
                         if (count === undefined) {
+                            // 最大重试次数
                             count = MaxRetryCount;
                         }
                         count--;
@@ -333,9 +502,11 @@ let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
             this.remove(changed);
             const container = (_b = (_a = this.renderSystem) === null || _a === void 0 ? void 0 : _a.containerManager) === null || _b === void 0 ? void 0 : _b.getContainer(changed.gameObject.id);
             if (!container) {
+                // console.warn('添加spine的container不存在');
                 return;
             }
             component.lastResource = component.resource;
+            // @ts-ignore
             const armature = new this.pixiSpine.Spine({
                 skeletonData: spineData,
                 autoUpdate: false,
@@ -347,23 +518,30 @@ let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
                 armature.y = tran.size.height * tran.origin.y;
             }
             container.addChildAt(armature, 0);
+            /** 保证第一帧显示正常 */
             armature.update();
             component.armature = armature;
+            // @ts-ignore
             component.emit('loaded', { resource: component.resource });
             armature.state.addListener({
+                // @ts-ignore
                 start: (track, event) => {
                     component.emit('start', { track, name: track.animation.name });
                 },
+                // @ts-ignore
                 complete: (track, event) => {
                     component.emit('complete', { track, name: track.animation.name });
                 },
+                // @ts-ignore
                 interrupt: (track, event) => {
                     component.emit('interrupt', { track, name: track.animation.name });
                 },
-                end: (track, event) => {
+                end: (track, // @ts-ignore
+                event) => {
                     component.emit('end', { track, name: track.animation.name });
                 },
                 event: (track, event) => {
+                    // @ts-ignore
                     component.emit('event', track, event);
                 },
             });
@@ -386,9 +564,11 @@ let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
             }
             if (component.armature) {
                 component.armature.destroy({ children: true });
-                const res = yield eva_js.resource.getResource(component.lastResource);
-                ((_d = (_c = res.data) === null || _c === void 0 ? void 0 : _c.image) === null || _d === void 0 ? void 0 : _d.src) || ((_f = (_e = res.data) === null || _e === void 0 ? void 0 : _e.image) === null || _f === void 0 ? void 0 : _f.label);
-                releaseSpineData(res);
+                if (!component.keepResource) {
+                    const res = yield eva_js.resource.getResource(component.lastResource);
+                    ((_d = (_c = res.data) === null || _c === void 0 ? void 0 : _c.image) === null || _d === void 0 ? void 0 : _d.src) || ((_f = (_e = res.data) === null || _e === void 0 ? void 0 : _e.image) === null || _f === void 0 ? void 0 : _f.label);
+                    releaseSpineData(res);
+                }
             }
             component.armature = null;
             delete this.armatures[changed.gameObject.id];
@@ -396,6 +576,7 @@ let SpineSystem = class SpineSystem extends pluginRenderer.Renderer {
         });
     }
 };
+/** 系统名称 */
 SpineSystem.systemName = 'SpineSystem';
 SpineSystem = __decorate([
     eva_js.decorators.componentObserver({

package/dist/spine-base.cjs.prod.js

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/plugin-renderer"),a=require("@eva/inspector-decorator"),r=require("pixi.js");
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/plugin-renderer"),a=require("@eva/inspector-decorator");
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation. All rights reserved.
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
@@ -13,4 +13,4 @@ MERCHANTABLITY OR NON-INFRINGEMENT.
 See the Apache Version 2.0 License for specific language governing permissions
 and limitations under the License.
 ***************************************************************************** */
-function i(e,t,a,r){var i,s=arguments.length,n=s<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,a):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)n=Reflect.decorate(e,t,a,r);else for(var o=e.length-1;o>=0;o--)(i=e[o])&&(n=(s<3?i(n):s>3?i(t,a,n):i(t,a))||n);return s>3&&n&&Object.defineProperty(t,a,n),n}function s(e,t,a,r){return new(a||(a=Promise))((function(i,s){function n(e){try{c(r.next(e))}catch(e){s(e)}}function o(e){try{c(r.throw(e))}catch(e){s(e)}}function c(e){e.done?i(e.value):new a((function(t){t(e.value)})).then(n,o)}c((r=r.apply(e,t||[])).next())}))}class n extends e.Component{constructor(){super(...arguments),this.resource="",this.scale=1,this.animationName="",this.autoPlay=!0,this.waitExecuteInfos=[]}set armature(e){if(this._armature=e,e){this.autoPlay&&this.play(this.animationName);for(const e of this.waitExecuteInfos)if(e.playType){const{name:t,loop:a,track:r}=e;this.play(t,a,r)}else this.stop(e.track);this.waitExecuteInfos=[]}}get armature(){return this._armature}init(e){e&&Object.assign(this,e)}onDestroy(){this.destroied=!0}play(e,t,a){try{const r=null!=t?t:this.autoPlay;e&&(this.animationName=e),this.armature?(void 0===a&&(a=0),this.armature.state.setAnimation(a,this.animationName,r)):this.waitExecuteInfos.push({playType:!0,name:e,loop:r,track:a})}catch(e){console.log(e)}}stop(e){this.armature?(void 0===e&&(e=0),this.armature.state.setEmptyAnimation(e,0)):this.waitExecuteInfos.push({playType:!1,track:e})}addAnimation(e,t,a,r){try{this.armature&&(void 0===r&&(r=0),this.armature.state.addAnimation(r,e,a,t))}catch(e){console.log(e)}}setMix(e,t,a){this.armature&&this.armature.state.data.setMix(e,t,a)}getAnim(e=0){try{if(this.armature)return this.armature.state.tracks[e].animation.name}catch(e){console.log(e)}}setDefaultMix(e){this.armature&&(this.armature.state.data.defaultMix=e)}setAttachment(e,t){this.armature&&this.armature.skeleton.setAttachment(e,t)}getBone(e){if(this.armature)return this.armature.skeleton.findBone(e)}}n.componentName="Spine",i([a.type("string")],n.prototype,"resource",void 0),i([a.type("number")],n.prototype,"scale",void 0),i([a.type("string")],n.prototype,"animationName",void 0),i([a.type("boolean")],n.prototype,"autoPlay",void 0);let o={};function c(e,t,a){return s(this,void 0,void 0,(function*(){let r=o[e.name];if(!r)if(e.complete)r=function(e,t,a,r){const i=t.ske,s=t.atlas,n=new r.AtlasAttachmentLoader(s),c=i instanceof Uint8Array?new r.SkeletonBinary(n):new r.SkeletonJson(n);c.scale=a||1;const m={spineData:c.readSkeletonData(i),ref:0,imageSrc:t.image.label};return o[e]=m,m}(e.name,e.data,t,a);else if(!r)return;return r.ref++,r.spineData}))}let m=class extends t.Renderer{constructor(){super(...arguments),this.armatures={}}init({pixiSpine:a}){this.renderSystem=this.game.getSystem(t.RendererSystem),this.renderSystem.rendererManager.register(this),this.pixiSpine=a,this.game.canvas.addEventListener("webglcontextrestored",(()=>{const t=this.game.gameObjects;let a=[];for(let r in this.armatures){const i=+r;for(let r=0;r<t.length;++r){let s=t[r];if(s.id===i){let t=s.getComponent(n);t&&(this.remove({type:e.OBSERVER_TYPE.REMOVE,gameObject:s,component:t,componentName:n.componentName}),a.push({type:e.OBSERVER_TYPE.ADD,gameObject:s,component:t,componentName:n.componentName}));break}}}setTimeout((()=>{a.forEach((e=>{this.add(e)}))}),1e3)}),!1)}update(e){for(let t in this.armatures)this.armatures[t].update(.001*e.deltaTime);super.update()}componentChanged(t){return s(this,void 0,void 0,(function*(){if("Spine"===t.componentName)if(t.type===e.OBSERVER_TYPE.ADD)this.add(t);else if(t.type===e.OBSERVER_TYPE.CHANGE){if("resource"===t.prop.prop[0])this.change(t)}else t.type===e.OBSERVER_TYPE.REMOVE&&this.remove(t)}))}add(t,a){var r,i;return s(this,void 0,void 0,(function*(){const s=t.component;clearTimeout(s.addHandler);const n=t.gameObject.id,o=this.increaseAsyncId(n),m=yield e.resource.getResource(s.resource);if(!this.validateAsyncId(n,o))return;const u=yield c(m,s.scale,this.pixiSpine);if(!this.validateAsyncId(n,o))return;if(!u)return void(s.addHandler=setTimeout((()=>{s.destroied||(void 0===a&&(a=20),--a>0?this.add(t,a):console.log("retry exceed max times",s.resource))}),1e3));this.remove(t);const d=null===(i=null===(r=this.renderSystem)||void 0===r?void 0:r.containerManager)||void 0===i?void 0:i.getContainer(t.gameObject.id);if(!d)return;s.lastResource=s.resource;const l=new this.pixiSpine.Spine({skeletonData:u,autoUpdate:!1});if(this.armatures[t.gameObject.id]=l,t.gameObject&&t.gameObject.transform){const e=t.gameObject.transform;l.x=e.size.width*e.origin.x,l.y=e.size.height*e.origin.y}d.addChildAt(l,0),l.update(),s.armature=l,s.emit("loaded",{resource:s.resource}),l.state.addListener({start:(e,t)=>{s.emit("start",{track:e,name:e.animation.name})},complete:(e,t)=>{s.emit("complete",{track:e,name:e.animation.name})},interrupt:(e,t)=>{s.emit("interrupt",{track:e,name:e.animation.name})},end:(e,t)=>{s.emit("end",{track:e,name:e.animation.name})},event:(e,t)=>{s.emit("event",e,t)}})}))}change(e){this.remove(e),this.add(e)}remove(t){var a,i,n,c,m,u;return s(this,void 0,void 0,(function*(){this.increaseAsyncId(t.gameObject.id);const d=t.component;clearTimeout(d.addHandler);const l=this.armatures[t.gameObject.id],h=null===(i=null===(a=this.renderSystem)||void 0===a?void 0:a.containerManager)||void 0===i?void 0:i.getContainer(t.gameObject.id);if(h&&l&&h.removeChild(l),d.armature){d.armature.destroy({children:!0});const t=yield e.resource.getResource(d.lastResource);(null===(c=null===(n=t.data)||void 0===n?void 0:n.image)||void 0===c?void 0:c.src)||null===(u=null===(m=t.data)||void 0===m?void 0:m.image)||void 0===u||u.label,function(t){const a=t.name,i=o[a];i&&(i.ref--,setTimeout((()=>s(this,void 0,void 0,(function*(){if(i.ref<=0){yield r.Assets.unload([t.src.image.url,t.src.atlas.url,t.src.ske.url]);const i=r.Assets.resolver;delete i._assetMap[t.src.image.url],delete i._assetMap[t.src.atlas.url],delete i._assetMap[t.src.ske.url],delete i._resolverHash[t.src.image.url],delete i._resolverHash[t.src.atlas.url],delete i._resolverHash[t.src.ske.url],e.resource.destroy(a),delete o[a]}}))),100))}(t)}d.armature=null,delete this.armatures[t.gameObject.id],t.type,e.OBSERVER_TYPE.CHANGE}))}};m.systemName="SpineSystem",m=i([e.decorators.componentObserver({Spine:["resource"]})],m);var u=m;e.resource.registerResourceType("SPINE"),exports.Spine=n,exports.SpineSystem=u;
+function i(e,t,a,i){var r,n=arguments.length,o=n<3?t:null===i?i=Object.getOwnPropertyDescriptor(t,a):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,t,a,i);else for(var s=e.length-1;s>=0;s--)(r=e[s])&&(o=(n<3?r(o):n>3?r(t,a,o):r(t,a))||o);return n>3&&o&&Object.defineProperty(t,a,o),o}function r(e,t,a,i){return new(a||(a=Promise))((function(r,n){function o(e){try{c(i.next(e))}catch(e){n(e)}}function s(e){try{c(i.throw(e))}catch(e){n(e)}}function c(e){e.done?r(e.value):new a((function(t){t(e.value)})).then(o,s)}c((i=i.apply(e,t||[])).next())}))}class n extends e.Component{constructor(){super(...arguments),this.resource="",this.scale=1,this.animationName="",this.autoPlay=!0,this.keepResource=!1,this.waitExecuteInfos=[]}set armature(e){if(this._armature=e,e){this.autoPlay&&this.play(this.animationName);for(const e of this.waitExecuteInfos)if(e.playType){const{name:t,loop:a,track:i}=e;this.play(t,a,i)}else this.stop(e.track);this.waitExecuteInfos=[]}}get armature(){return this._armature}init(e){e&&Object.assign(this,e)}onDestroy(){this.destroied=!0}play(e,t,a){try{const i=null!=t?t:this.autoPlay;e&&(this.animationName=e),this.armature?(void 0===a&&(a=0),this.armature.state.setAnimation(a,this.animationName,i)):this.waitExecuteInfos.push({playType:!0,name:e,loop:i,track:a})}catch(e){console.log(e)}}stop(e){this.armature?(void 0===e&&(e=0),this.armature.state.setEmptyAnimation(e,0)):this.waitExecuteInfos.push({playType:!1,track:e})}addAnimation(e,t,a,i){try{this.armature&&(void 0===i&&(i=0),this.armature.state.addAnimation(i,e,a,t))}catch(e){console.log(e)}}setMix(e,t,a){this.armature&&this.armature.state.data.setMix(e,t,a)}getAnim(e=0){try{if(this.armature)return this.armature.state.tracks[e].animation.name}catch(e){console.log(e)}}setDefaultMix(e){this.armature&&(this.armature.state.data.defaultMix=e)}setAttachment(e,t){this.armature&&this.armature.skeleton.setAttachment(e,t)}getBone(e){if(this.armature)return this.armature.skeleton.findBone(e)}}n.componentName="Spine",i([a.type("string")],n.prototype,"resource",void 0),i([a.type("number")],n.prototype,"scale",void 0),i([a.type("string")],n.prototype,"animationName",void 0),i([a.type("boolean")],n.prototype,"autoPlay",void 0),i([a.type("boolean")],n.prototype,"keepResource",void 0);let o={};function s(e,t,a){return r(this,void 0,void 0,(function*(){let i=o[e.name];if(!i)if(e.complete)i=function(e,t,a,i){const r=t.ske,n=t.atlas,s=new i.AtlasAttachmentLoader(n),c=r instanceof Uint8Array?new i.SkeletonBinary(s):new i.SkeletonJson(s);c.scale=a||1;const m={spineData:c.readSkeletonData(r),ref:0,imageSrc:t.image.label};return o[e]=m,m}(e.name,e.data,t,a);else if(!i)return;return i.ref++,i.spineData}))}let c=class extends t.Renderer{constructor(){super(...arguments),this.armatures={}}init({pixiSpine:a}){this.renderSystem=this.game.getSystem(t.RendererSystem),this.renderSystem.rendererManager.register(this),this.pixiSpine=a,this.game.canvas.addEventListener("webglcontextrestored",(()=>{const t=this.game.gameObjects;let a=[];for(let i in this.armatures){const r=+i;for(let i=0;i<t.length;++i){let o=t[i];if(o.id===r){let t=o.getComponent(n);t&&(this.remove({type:e.OBSERVER_TYPE.REMOVE,gameObject:o,component:t,componentName:n.componentName}),a.push({type:e.OBSERVER_TYPE.ADD,gameObject:o,component:t,componentName:n.componentName}));break}}}setTimeout((()=>{a.forEach((e=>{this.add(e)}))}),1e3)}),!1)}update(e){for(let t in this.armatures)this.armatures[t].update(.001*e.deltaTime);super.update()}componentChanged(t){return r(this,void 0,void 0,(function*(){if("Spine"===t.componentName)if(t.type===e.OBSERVER_TYPE.ADD)this.add(t);else if(t.type===e.OBSERVER_TYPE.CHANGE){if("resource"===t.prop.prop[0])this.change(t)}else t.type===e.OBSERVER_TYPE.REMOVE&&this.remove(t)}))}add(t,a){var i,n;return r(this,void 0,void 0,(function*(){const r=t.component;clearTimeout(r.addHandler);const o=t.gameObject.id,c=this.increaseAsyncId(o),m=yield e.resource.getResource(r.resource);if(!this.validateAsyncId(o,c))return;const u=yield s(m,r.scale,this.pixiSpine);if(!this.validateAsyncId(o,c))return;if(!u)return void(r.addHandler=setTimeout((()=>{r.destroied||(void 0===a&&(a=20),--a>0?this.add(t,a):console.log("retry exceed max times",r.resource))}),1e3));this.remove(t);const d=null===(n=null===(i=this.renderSystem)||void 0===i?void 0:i.containerManager)||void 0===n?void 0:n.getContainer(t.gameObject.id);if(!d)return;r.lastResource=r.resource;const l=new this.pixiSpine.Spine({skeletonData:u,autoUpdate:!1});if(this.armatures[t.gameObject.id]=l,t.gameObject&&t.gameObject.transform){const e=t.gameObject.transform;l.x=e.size.width*e.origin.x,l.y=e.size.height*e.origin.y}d.addChildAt(l,0),l.update(),r.armature=l,r.emit("loaded",{resource:r.resource}),l.state.addListener({start:(e,t)=>{r.emit("start",{track:e,name:e.animation.name})},complete:(e,t)=>{r.emit("complete",{track:e,name:e.animation.name})},interrupt:(e,t)=>{r.emit("interrupt",{track:e,name:e.animation.name})},end:(e,t)=>{r.emit("end",{track:e,name:e.animation.name})},event:(e,t)=>{r.emit("event",e,t)}})}))}change(e){this.remove(e),this.add(e)}remove(t){var a,i,n,s,c,m;return r(this,void 0,void 0,(function*(){this.increaseAsyncId(t.gameObject.id);const u=t.component;clearTimeout(u.addHandler);const d=this.armatures[t.gameObject.id],l=null===(i=null===(a=this.renderSystem)||void 0===a?void 0:a.containerManager)||void 0===i?void 0:i.getContainer(t.gameObject.id);if(l&&d&&l.removeChild(d),u.armature&&(u.armature.destroy({children:!0}),!u.keepResource)){const t=yield e.resource.getResource(u.lastResource);(null===(s=null===(n=t.data)||void 0===n?void 0:n.image)||void 0===s?void 0:s.src)||null===(m=null===(c=t.data)||void 0===c?void 0:c.image)||void 0===m||m.label,function(t){const a=t.name,i=o[a];i&&(i.ref--,setTimeout((()=>r(this,void 0,void 0,(function*(){i.ref<=0&&(e.resource.destroy(a),delete o[a])}))),100))}(t)}u.armature=null,delete this.armatures[t.gameObject.id],t.type,e.OBSERVER_TYPE.CHANGE}))}};c.systemName="SpineSystem",c=i([e.decorators.componentObserver({Spine:["resource"]})],c);var m=c;e.resource.registerResourceType("SPINE"),exports.Spine=n,exports.SpineSystem=m;

package/dist/spine-base.d.ts

@@ -8,28 +8,172 @@ import { RendererManager } from '@eva/plugin-renderer';
 import { RendererSystem } from '@eva/plugin-renderer';
 import { UpdateParams } from '@eva/eva.js';
 
+/**
+ * Spine 骨骼动画组件
+ *
+ * Spine 组件用于播放 Esoteric Software 的 Spine 骨骼动画。
+ * 支持骨骼动画播放控制、动画混合、附件替换等高级功能，
+ * 适用于角色动画、复杂特效等需要骨骼动画的场景。
+ *
+ * 主要功能：
+ * - 骨骼动画播放和控制
+ * - 动画轨道管理（多动画并行）
+ * - 动画混合过渡
+ * - 骨骼和附件访问
+ * - 支持 Spine 3.6 和 3.8 版本
+ *
+ * @example
+ * ```typescript
+ * // 创建 Spine 动画
+ * const character = new GameObject('character');
+ * const spine = new Spine({
+ *   resource: 'heroSpine', // Spine 资源
+ *   animationName: 'idle', // 默认动画
+ *   autoPlay: true, // 自动播放
+ *   scale: 0.5 // 缩放比例
+ * });
+ * character.addComponent(spine);
+ *
+ * // 播放动画
+ * spine.play('walk', true); // 循环播放 walk 动画
+ *
+ * // 停止动画
+ * spine.stop();
+ *
+ * // 动画混合
+ * spine.setMix('idle', 'walk', 0.3); // 设置过渡时间
+ * spine.play('walk');
+ *
+ * // 添加动画队列
+ * spine.play('attack', false); // 播放攻击动画
+ * spine.addAnimation('idle', 0, true); // 攻击完成后回到 idle
+ *
+ * // 替换附件（换装）
+ * spine.setAttachment('weapon', 'sword'); // 将武器槽替换为剑
+ *
+ * // 访问骨骼
+ * const headBone = spine.getBone('head');
+ * if (headBone) {
+ *   headBone.rotation = 15; // 旋转头部
+ * }
+ *
+ * // 多轨道动画
+ * spine.play('walk', true, 0); // 轨道0：身体动画
+ * spine.play('shoot', false, 1); // 轨道1：上半身动画
+ * ```
+ */
 export declare class Spine extends Component<SpineParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** Spine 资源名称 */
     resource: string;
+    /** 动画缩放比例 */
     scale: number;
+    /** 当前播放的动画名称 */
     animationName: string;
+    /** 是否自动播放动画 */
     autoPlay: boolean;
+    /** 是否保留资源（销毁时不释放） */
+    keepResource: boolean;
+    /** Spine 骨架实例（内部使用） */
     private _armature;
+    /** 等待执行的动画操作队列 */
     private waitExecuteInfos;
+    /**
+     * 设置骨架实例
+     * 当骨架加载完成后自动执行等待队列中的动画操作
+     */
     set armature(val: any);
+    /** 获取骨架实例 */
     get armature(): any;
+    /** 组件是否已销毁 */
     destroied: boolean;
+    /** 动画事件处理器 */
     addHandler: any;
+    /** 上一次使用的资源名称 */
     lastResource: string;
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - Spine 资源名称
+     * @param obj.animationName - 默认动画名称
+     * @param obj.scale - 缩放比例
+     * @param obj.autoPlay - 是否自动播放
+     */
     init(obj?: SpineParams): void;
+    /** 组件销毁时调用 */
     onDestroy(): void;
+    /**
+     * 播放指定动画
+     *
+     * 如果骨架尚未加载完成，动画操作将被加入等待队列。
+     *
+     * @param name - 动画名称，不指定则使用 animationName 属性
+     * @param loopAnimation - 是否循环播放，默认跟随 autoPlay 属性
+     * @param track - 动画轨道编号，默认为 0
+     */
     play(name?: string, loopAnimation?: boolean, track?: number): void;
+    /**
+     * 停止指定轨道的动画
+     *
+     * 如果骨架尚未加载完成，停止操作将被加入等待队列。
+     *
+     * @param track - 动画轨道编号，默认为 0
+     */
     stop(track?: number): void;
+    /**
+     * 在当前动画之后添加新动画到队列
+     *
+     * 用于创建动画序列，当前动画播放完毕后自动播放下一个动画。
+     *
+     * @param name - 动画名称
+     * @param delay - 延迟时间（秒）
+     * @param loop - 是否循环播放
+     * @param track - 动画轨道编号，默认为 0
+     */
     addAnimation(name?: string, delay?: number, loop?: boolean, track?: number): void;
+    /**
+     * 设置两个动画之间的混合过渡时间
+     *
+     * 当从一个动画切换到另一个动画时，会在指定时间内进行平滑过渡。
+     *
+     * @param from - 起始动画名称
+     * @param to - 目标动画名称
+     * @param duration - 过渡时长（秒）
+     */
     setMix(from: string, to: string, duration: number): void;
+    /**
+     * 获取指定轨道当前播放的动画名称
+     *
+     * @param track - 动画轨道编号，默认为 0
+     * @returns 动画名称，如果未找到则返回 undefined
+     */
     getAnim(track?: number): any;
+    /**
+     * 设置默认的动画混合时间
+     *
+     * 当没有为特定动画对指定混合时间时，将使用此默认值。
+     *
+     * @param duration - 默认混合时长（秒）
+     */
     setDefaultMix(duration: number): void;
+    /**
+     * 替换指定插槽的附件
+     *
+     * 用于换装、武器切换等场景。
+     *
+     * @param slotName - 插槽名称
+     * @param attachmentName - 附件名称
+     */
     setAttachment(slotName: string, attachmentName: string): void;
+    /**
+     * 获取指定名称的骨骼
+     *
+     * 可用于直接操作骨骼的位置、旋转、缩放等属性。
+     *
+     * @param boneName - 骨骼名称
+     * @returns 骨骼对象，如果未找到则返回 undefined
+     */
     getBone(boneName: string): any;
 }
 
@@ -40,16 +184,45 @@ export declare interface SpineParams {
     autoPlay?: boolean;
 }
 
+/**
+ * Spine 骨骼动画系统
+ *
+ * SpineSystem 负责管理所有 Spine 组件的骨架创建、动画更新和资源管理。
+ * 系统会监听 Spine 组件的变化，自动加载骨骼数据并创建动画实例，
+ * 并在每帧更新所有活跃的 Spine 动画。
+ *
+ * 主要功能：
+ * - 骨骼数据加载和缓存
+ * - 动画实例创建和销毁
+ * - 每帧动画状态更新
+ * - WebGL 上下文恢复处理
+ * - 资源重试机制
+ */
 export declare class SpineSystem extends Renderer {
+    /** 系统名称 */
     static systemName: string;
+    /** 骨架实例映射表（游戏对象 ID -> 骨架容器） */
     armatures: Record<number, Container>;
+    /** 渲染系统引用 */
     renderSystem: RendererSystem;
+    /** 渲染器管理器 */
     rendererManager: RendererManager;
+    /** 容器管理器 */
     containerManager: ContainerManager;
+    /** PixiJS Spine 插件实例 */
     pixiSpine: any;
+    /**
+     * 初始化系统
+     * @param obj - 初始化参数
+     * @param obj.pixiSpine - PixiJS Spine 插件实例
+     */
     init({ pixiSpine }: {
         pixiSpine: any;
     }): void;
+    /**
+     * 每帧更新所有 Spine 动画
+     * @param e - 更新参数，包含帧间隔时间
+     */
     update(e: UpdateParams): void;
     componentChanged(changed: ComponentChanged): Promise<void>;
     add(changed: ComponentChanged, count?: number): Promise<void>;

package/dist/spine-base.esm.js

@@ -1,7 +1,6 @@
 import { Component, resource, OBSERVER_TYPE, decorators } from '@eva/eva.js';
 import { Renderer, RendererSystem } from '@eva/plugin-renderer';
 import { type } from '@eva/inspector-decorator';
-import { Assets } from 'pixi.js';
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation. All rights reserved.
@@ -34,15 +33,80 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
+/**
+ * Spine 骨骼动画组件
+ *
+ * Spine 组件用于播放 Esoteric Software 的 Spine 骨骼动画。
+ * 支持骨骼动画播放控制、动画混合、附件替换等高级功能，
+ * 适用于角色动画、复杂特效等需要骨骼动画的场景。
+ *
+ * 主要功能：
+ * - 骨骼动画播放和控制
+ * - 动画轨道管理（多动画并行）
+ * - 动画混合过渡
+ * - 骨骼和附件访问
+ * - 支持 Spine 3.6 和 3.8 版本
+ *
+ * @example
+ * ```typescript
+ * // 创建 Spine 动画
+ * const character = new GameObject('character');
+ * const spine = new Spine({
+ *   resource: 'heroSpine', // Spine 资源
+ *   animationName: 'idle', // 默认动画
+ *   autoPlay: true, // 自动播放
+ *   scale: 0.5 // 缩放比例
+ * });
+ * character.addComponent(spine);
+ *
+ * // 播放动画
+ * spine.play('walk', true); // 循环播放 walk 动画
+ *
+ * // 停止动画
+ * spine.stop();
+ *
+ * // 动画混合
+ * spine.setMix('idle', 'walk', 0.3); // 设置过渡时间
+ * spine.play('walk');
+ *
+ * // 添加动画队列
+ * spine.play('attack', false); // 播放攻击动画
+ * spine.addAnimation('idle', 0, true); // 攻击完成后回到 idle
+ *
+ * // 替换附件（换装）
+ * spine.setAttachment('weapon', 'sword'); // 将武器槽替换为剑
+ *
+ * // 访问骨骼
+ * const headBone = spine.getBone('head');
+ * if (headBone) {
+ *   headBone.rotation = 15; // 旋转头部
+ * }
+ *
+ * // 多轨道动画
+ * spine.play('walk', true, 0); // 轨道0：身体动画
+ * spine.play('shoot', false, 1); // 轨道1：上半身动画
+ * ```
+ */
 class Spine extends Component {
     constructor() {
         super(...arguments);
+        /** Spine 资源名称 */
         this.resource = '';
+        /** 动画缩放比例 */
         this.scale = 1;
+        /** 当前播放的动画名称 */
         this.animationName = '';
+        /** 是否自动播放动画 */
         this.autoPlay = true;
+        /** 是否保留资源（销毁时不释放） */
+        this.keepResource = false;
+        /** 等待执行的动画操作队列 */
         this.waitExecuteInfos = [];
     }
+    /**
+     * 设置骨架实例
+     * 当骨架加载完成后自动执行等待队列中的动画操作
+     */
     set armature(val) {
         this._armature = val;
         if (!val)
@@ -61,17 +125,36 @@ class Spine extends Component {
         }
         this.waitExecuteInfos = [];
     }
+    /** 获取骨架实例 */
     get armature() {
         return this._armature;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - Spine 资源名称
+     * @param obj.animationName - 默认动画名称
+     * @param obj.scale - 缩放比例
+     * @param obj.autoPlay - 是否自动播放
+     */
     init(obj) {
         if (!obj)
             return;
         Object.assign(this, obj);
     }
+    /** 组件销毁时调用 */
     onDestroy() {
         this.destroied = true;
     }
+    /**
+     * 播放指定动画
+     *
+     * 如果骨架尚未加载完成，动画操作将被加入等待队列。
+     *
+     * @param name - 动画名称，不指定则使用 animationName 属性
+     * @param loopAnimation - 是否循环播放，默认跟随 autoPlay 属性
+     * @param track - 动画轨道编号，默认为 0
+     */
     play(name, loopAnimation, track) {
         try {
             const loop = loopAnimation !== null && loopAnimation !== void 0 ? loopAnimation : this.autoPlay;
@@ -81,6 +164,12 @@ class Spine extends Component {
                 this.waitExecuteInfos.push({
                     playType: true,
                     name,
+                    /**
+                     * 在 v1.2.2 之前，Spine 动画的 autoPlay 为 true，动画会循环播放 https://github.com/eva-engine/eva.js/pull/164/files#diff-46e9ae36c04e7a0abedc1e14fd9d1c4e81d8386e9bb851f85971ccdba8957804L131
+                     * 在 v1.2.2 之前，Spine 动画在每加载完( armature 设置之前)调用 play 是不生效的， 在 v1.2.2 [#164](https://github.com/eva-engine/eva.js/pull/164) 解决了这个问题
+                     * 解决了不生效的问题以后，加载完成之前调用 play 默认循环是false，导致 autoPlay 下本来循环动画不循环了，和之前表现不一致
+                     * 为了解决这个问题，在 autoPlay 的情况下，未加载完之前调用 play ，默认循环播放，除非设置不循环参数
+                     */
                     loop,
                     track,
                 });
@@ -96,6 +185,13 @@ class Spine extends Component {
             console.log(e);
         }
     }
+    /**
+     * 停止指定轨道的动画
+     *
+     * 如果骨架尚未加载完成，停止操作将被加入等待队列。
+     *
+     * @param track - 动画轨道编号，默认为 0
+     */
     stop(track) {
         if (!this.armature) {
             this.waitExecuteInfos.push({
@@ -109,6 +205,16 @@ class Spine extends Component {
         }
         this.armature.state.setEmptyAnimation(track, 0);
     }
+    /**
+     * 在当前动画之后添加新动画到队列
+     *
+     * 用于创建动画序列，当前动画播放完毕后自动播放下一个动画。
+     *
+     * @param name - 动画名称
+     * @param delay - 延迟时间（秒）
+     * @param loop - 是否循环播放
+     * @param track - 动画轨道编号，默认为 0
+     */
     addAnimation(name, delay, loop, track) {
         try {
             if (!this.armature) {
@@ -124,12 +230,27 @@ class Spine extends Component {
             console.log(e);
         }
     }
+    /**
+     * 设置两个动画之间的混合过渡时间
+     *
+     * 当从一个动画切换到另一个动画时，会在指定时间内进行平滑过渡。
+     *
+     * @param from - 起始动画名称
+     * @param to - 目标动画名称
+     * @param duration - 过渡时长（秒）
+     */
     setMix(from, to, duration) {
         if (!this.armature) ;
         else {
             this.armature.state.data.setMix(from, to, duration);
         }
     }
+    /**
+     * 获取指定轨道当前播放的动画名称
+     *
+     * @param track - 动画轨道编号，默认为 0
+     * @returns 动画名称，如果未找到则返回 undefined
+     */
     getAnim(track = 0) {
         try {
             if (!this.armature) {
@@ -142,18 +263,41 @@ class Spine extends Component {
             console.log(e);
         }
     }
+    /**
+     * 设置默认的动画混合时间
+     *
+     * 当没有为特定动画对指定混合时间时，将使用此默认值。
+     *
+     * @param duration - 默认混合时长（秒）
+     */
     setDefaultMix(duration) {
         if (!this.armature) ;
         else {
             this.armature.state.data.defaultMix = duration;
         }
     }
+    /**
+     * 替换指定插槽的附件
+     *
+     * 用于换装、武器切换等场景。
+     *
+     * @param slotName - 插槽名称
+     * @param attachmentName - 附件名称
+     */
     setAttachment(slotName, attachmentName) {
         if (!this.armature) {
             return;
         }
         this.armature.skeleton.setAttachment(slotName, attachmentName);
     }
+    /**
+     * 获取指定名称的骨骼
+     *
+     * 可用于直接操作骨骼的位置、旋转、缩放等属性。
+     *
+     * @param boneName - 骨骼名称
+     * @returns 骨骼对象，如果未找到则返回 undefined
+     */
     getBone(boneName) {
         if (!this.armature) {
             return;
@@ -161,6 +305,7 @@ class Spine extends Component {
         return this.armature.skeleton.findBone(boneName);
     }
 }
+/** 组件名称 */
 Spine.componentName = 'Spine';
 __decorate([
     type('string')
@@ -173,7 +318,10 @@ __decorate([
 ], Spine.prototype, "animationName", void 0);
 __decorate([
     type('boolean')
-], Spine.prototype, "autoPlay", void 0);
+], Spine.prototype, "autoPlay", void 0);
+__decorate([
+    type('boolean')
+], Spine.prototype, "keepResource", void 0);
 
 let dataMap = {};
 function createSpineData(name, data, scale, pixiSpine) {
@@ -213,14 +361,6 @@ function releaseSpineData(res, _imageSrc) {
     data.ref--;
     setTimeout(() => __awaiter(this, void 0, void 0, function* () {
         if (data.ref <= 0) {
-            yield Assets.unload([res.src.image.url, res.src.atlas.url, res.src.ske.url]);
-            const resolver = Assets.resolver;
-            delete resolver._assetMap[res.src.image.url];
-            delete resolver._assetMap[res.src.atlas.url];
-            delete resolver._assetMap[res.src.ske.url];
-            delete resolver._resolverHash[res.src.image.url];
-            delete resolver._resolverHash[res.src.atlas.url];
-            delete resolver._resolverHash[res.src.ske.url];
             resource.destroy(resourceName);
             delete dataMap[resourceName];
         }
@@ -228,17 +368,39 @@ function releaseSpineData(res, _imageSrc) {
 }
 
 const MaxRetryCount = 20;
+/**
+ * Spine 骨骼动画系统
+ *
+ * SpineSystem 负责管理所有 Spine 组件的骨架创建、动画更新和资源管理。
+ * 系统会监听 Spine 组件的变化，自动加载骨骼数据并创建动画实例，
+ * 并在每帧更新所有活跃的 Spine 动画。
+ *
+ * 主要功能：
+ * - 骨骼数据加载和缓存
+ * - 动画实例创建和销毁
+ * - 每帧动画状态更新
+ * - WebGL 上下文恢复处理
+ * - 资源重试机制
+ */
 let SpineSystem = class SpineSystem extends Renderer {
     constructor() {
         super(...arguments);
+        /** 骨架实例映射表（游戏对象 ID -> 骨架容器） */
         this.armatures = {};
     }
+    /**
+     * 初始化系统
+     * @param obj - 初始化参数
+     * @param obj.pixiSpine - PixiJS Spine 插件实例
+     */
     init({ pixiSpine }) {
         this.renderSystem = this.game.getSystem(RendererSystem);
         this.renderSystem.rendererManager.register(this);
         this.pixiSpine = pixiSpine;
         this.game.canvas.addEventListener('webglcontextrestored', () => {
+            // 重建所有spine
             const objs = this.game.gameObjects;
+            // clearCache();
             let toAdd = [];
             for (let k in this.armatures) {
                 const id = +k;
@@ -271,8 +433,14 @@ let SpineSystem = class SpineSystem extends Renderer {
             }, 1000);
         }, false);
     }
+    /**
+     * 每帧更新所有 Spine 动画
+     * @param e - 更新参数，包含帧间隔时间
+     */
     update(e) {
         for (let key in this.armatures) {
+            // TODO: 类型
+            // @ts-ignore
             this.armatures[key].update(e.deltaTime * 0.001);
         }
         super.update();
@@ -313,6 +481,7 @@ let SpineSystem = class SpineSystem extends Renderer {
                 component.addHandler = setTimeout(() => {
                     if (!component.destroied) {
                         if (count === undefined) {
+                            // 最大重试次数
                             count = MaxRetryCount;
                         }
                         count--;
@@ -329,9 +498,11 @@ let SpineSystem = class SpineSystem extends Renderer {
             this.remove(changed);
             const container = (_b = (_a = this.renderSystem) === null || _a === void 0 ? void 0 : _a.containerManager) === null || _b === void 0 ? void 0 : _b.getContainer(changed.gameObject.id);
             if (!container) {
+                // console.warn('添加spine的container不存在');
                 return;
             }
             component.lastResource = component.resource;
+            // @ts-ignore
             const armature = new this.pixiSpine.Spine({
                 skeletonData: spineData,
                 autoUpdate: false,
@@ -343,23 +514,30 @@ let SpineSystem = class SpineSystem extends Renderer {
                 armature.y = tran.size.height * tran.origin.y;
             }
             container.addChildAt(armature, 0);
+            /** 保证第一帧显示正常 */
             armature.update();
             component.armature = armature;
+            // @ts-ignore
             component.emit('loaded', { resource: component.resource });
             armature.state.addListener({
+                // @ts-ignore
                 start: (track, event) => {
                     component.emit('start', { track, name: track.animation.name });
                 },
+                // @ts-ignore
                 complete: (track, event) => {
                     component.emit('complete', { track, name: track.animation.name });
                 },
+                // @ts-ignore
                 interrupt: (track, event) => {
                     component.emit('interrupt', { track, name: track.animation.name });
                 },
-                end: (track, event) => {
+                end: (track, // @ts-ignore
+                event) => {
                     component.emit('end', { track, name: track.animation.name });
                 },
                 event: (track, event) => {
+                    // @ts-ignore
                     component.emit('event', track, event);
                 },
             });
@@ -382,9 +560,11 @@ let SpineSystem = class SpineSystem extends Renderer {
             }
             if (component.armature) {
                 component.armature.destroy({ children: true });
-                const res = yield resource.getResource(component.lastResource);
-                ((_d = (_c = res.data) === null || _c === void 0 ? void 0 : _c.image) === null || _d === void 0 ? void 0 : _d.src) || ((_f = (_e = res.data) === null || _e === void 0 ? void 0 : _e.image) === null || _f === void 0 ? void 0 : _f.label);
-                releaseSpineData(res);
+                if (!component.keepResource) {
+                    const res = yield resource.getResource(component.lastResource);
+                    ((_d = (_c = res.data) === null || _c === void 0 ? void 0 : _c.image) === null || _d === void 0 ? void 0 : _d.src) || ((_f = (_e = res.data) === null || _e === void 0 ? void 0 : _e.image) === null || _f === void 0 ? void 0 : _f.label);
+                    releaseSpineData(res);
+                }
             }
             component.armature = null;
             delete this.armatures[changed.gameObject.id];
@@ -392,6 +572,7 @@ let SpineSystem = class SpineSystem extends Renderer {
         });
     }
 };
+/** 系统名称 */
 SpineSystem.systemName = 'SpineSystem';
 SpineSystem = __decorate([
     decorators.componentObserver({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eva/spine-base",
-  "version": "2.0.1-beta.3",
+  "version": "2.0.1-beta.31",
   "description": "@eva/spine-base",
   "main": "index.js",
   "module": "dist/spine-base.esm.js",
@@ -18,8 +18,8 @@
   "license": "MIT",
   "homepage": "https://eva.js.org",
   "dependencies": {
-    "@eva/eva.js": "2.0.1-beta.3",
-    "@eva/plugin-renderer": "2.0.1-beta.3",
+    "@eva/eva.js": "2.0.1-beta.31",
+    "@eva/plugin-renderer": "2.0.1-beta.31",
     "@eva/inspector-decorator": "^0.0.5",
     "pixi.js": "^8.8.1"
   }