@eva/plugin-renderer-sprite-animation 2.1.0-beta.2 → 2.1.0-beta.3

package/dist/plugin-renderer-sprite-animation.cjs.js

@@ -1,407 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var eva_js = require('@eva/eva.js');
-var inspectorDecorator = require('@eva/inspector-decorator');
-var pluginRenderer = require('@eva/plugin-renderer');
-var rendererAdapter = require('@eva/renderer-adapter');
-var pixi_js = require('pixi.js');
-
-/******************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */
-
-function __decorate(decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.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 __metadata(metadataKey, metadataValue) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
-}
-
-function __awaiter(thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-}
-
-typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-    var e = new Error(message);
-    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-};
-
-/**
- * 精灵动画组件
- *
- * SpriteAnimation 组件用于播放帧动画（序列帧动画）。
- * 通过快速切换精灵图集中的不同帧，实现动画效果，
- * 适用于角色动作、特效、UI 动画等场景。
- *
- * 主要功能：
- * - 支持自动播放和手动控制
- * - 可配置播放速度和循环次数
- * - 支持跳转到指定帧
- * - 提供播放完成事件
- * - 支持 forwards 模式（停在最后一帧）
- *
- * @example
- * ```typescript
- * // 基础用法 - 自动播放
- * const character = new GameObject('character');
- * character.addComponent(new SpriteAnimation({
- *   resource: 'walkAnimation', // 帧动画资源
- *   autoPlay: true,
- *   speed: 100 // 播放速度（毫秒/帧）
- * }));
- *
- * // 控制播放
- * const anim = character.getComponent('SpriteAnimation');
- * anim.play(3); // 播放 3 次
- * anim.play(Infinity); // 无限循环
- * anim.stop(); // 停止播放
- * anim.gotoAndPlay(10); // 跳到第 10 帧并播放
- * anim.gotoAndStop(0); // 跳到第 0 帧并停止
- *
- * // 监听播放完成
- * anim.on('complete', () => {
- *   console.log('动画播放完成');
- * });
- * ```
- */
-class SpriteAnimation$2 extends eva_js.Component {
-    constructor(params) {
-        super(params);
-        /** 帧动画资源名称 */
-        this.resource = '';
-        /** 是否自动播放 */
-        this.autoPlay = true;
-        /** 播放速度（毫秒/帧） */
-        this.speed = 100;
-        /** 是否在最后一帧停止（forwards 模式） */
-        this.forwards = false;
-        /** 命名动画片段，供编辑器和脚本按动作名播放 */
-        this.animations = {};
-        /** 等待播放标志（资源加载前调用 play） */
-        this.waitPlay = false;
-        this.waitLoop = false;
-        /** 等待停止标志 */
-        this.waitStop = false;
-        /** 播放次数 */
-        this.times = Infinity;
-        /** 当前已播放次数 */
-        this.count = 0;
-        /** 是否播放完成 */
-        this.complete = false;
-        this.listenerBound = false;
-        this.init(params);
-    }
-    /**
-     * 初始化组件
-     * @param obj - 初始化参数
-     * @param obj.resource - 帧动画资源名称
-     * @param obj.autoPlay - 是否自动播放
-     * @param obj.speed - 播放速度
-     * @param obj.forwards - 是否停在最后一帧
-     */
-    init(obj) {
-        obj && Object.assign(this, obj);
-        if (!this.listenerBound) {
-            this.listenerBound = true;
-            this.on('loop', () => {
-                var _a;
-                if (++this.count >= this.times) {
-                    if (this.forwards) {
-                        this.gotoAndStop(this.totalFrames - 1);
-                    }
-                    else {
-                        (_a = this.animate) === null || _a === void 0 ? void 0 : _a.stop();
-                    }
-                    this.complete = true;
-                    this.emit('complete');
-                }
-            });
-            this.on('complete', () => {
-                var _a;
-                (_a = this.onComplete) === null || _a === void 0 ? void 0 : _a.call(this);
-            });
-            this.on('frameChange', () => {
-                var _a;
-                (_a = this.onFrameChange) === null || _a === void 0 ? void 0 : _a.call(this, this.currentFrame);
-            });
-        }
-    }
-    play(nameOrTimes = Infinity, loop = false) {
-        let times = typeof nameOrTimes === 'number' ? nameOrTimes : loop ? Infinity : 1;
-        let startFrame;
-        if (typeof nameOrTimes === 'string') {
-            this.currentAnimation = nameOrTimes;
-            const clip = this.animations[nameOrTimes];
-            if (clip) {
-                startFrame = clip.start;
-                if (clip.speed !== undefined)
-                    this.speed = clip.speed;
-            }
-        }
-        if (times === 0) {
-            return;
-        }
-        this.times = times;
-        if (!this.animate) {
-            this.waitPlay = true;
-            this.waitAnimation = typeof nameOrTimes === 'string' ? nameOrTimes : undefined;
-            this.waitLoop = loop;
-        }
-        else {
-            if (this.complete) {
-                this.gotoAndStop(0);
-            }
-            if (startFrame !== undefined) {
-                this.animate.gotoAndPlay(startFrame);
-            }
-            else {
-                this.animate.play();
-            }
-            this.count = 0;
-            this.complete = false;
-        }
-    }
-    stop() {
-        if (!this.animate) {
-            this.waitStop = true;
-        }
-        else {
-            this.animate.stop();
-        }
-    }
-    set animate(val) {
-        this._animate = val;
-        if (this.waitPlay) {
-            this.waitPlay = false;
-            const waitAnimation = this.waitAnimation;
-            this.waitAnimation = undefined;
-            this.play(waitAnimation !== null && waitAnimation !== void 0 ? waitAnimation : this.times, this.waitLoop);
-        }
-        if (this.waitStop) {
-            this.waitStop = false;
-            this.stop();
-        }
-    }
-    get animate() {
-        return this._animate;
-    }
-    gotoAndPlay(frameNumber) {
-        this.animate.gotoAndPlay(frameNumber);
-    }
-    gotoAndStop(frameNumber) {
-        this.animate.gotoAndStop(frameNumber);
-    }
-    get currentFrame() {
-        var _a, _b;
-        return (_b = (_a = this.animate) === null || _a === void 0 ? void 0 : _a.animatedSprite) === null || _b === void 0 ? void 0 : _b.currentFrame;
-    }
-    get totalFrames() {
-        var _a, _b;
-        return (_b = (_a = this.animate) === null || _a === void 0 ? void 0 : _a.animatedSprite) === null || _b === void 0 ? void 0 : _b.totalFrames;
-    }
-}
-/** 组件名称 */
-SpriteAnimation$2.componentName = 'SpriteAnimation';
-__decorate([
-    inspectorDecorator.type('string'),
-    __metadata("design:type", String)
-], SpriteAnimation$2.prototype, "resource", void 0);
-__decorate([
-    inspectorDecorator.type('boolean'),
-    __metadata("design:type", Boolean)
-], SpriteAnimation$2.prototype, "autoPlay", void 0);
-__decorate([
-    inspectorDecorator.type('number'),
-    inspectorDecorator.step(10),
-    __metadata("design:type", Number)
-], SpriteAnimation$2.prototype, "speed", void 0);
-__decorate([
-    inspectorDecorator.type('boolean'),
-    __metadata("design:type", Boolean)
-], SpriteAnimation$2.prototype, "forwards", void 0);
-
-const resourceKeySplit = '_s|r|c_';
-eva_js.resource.registerInstance(eva_js.RESOURCE_TYPE.SPRITE_ANIMATION, ({ name, data }) => {
-    return new Promise(r => {
-        var _a;
-        const textureObj = data.json.data;
-        const texture = data.image instanceof pixi_js.Texture ? data.image : pixi_js.Texture.from(data.image);
-        // Normalize Phaser JSONArray (`frames: [...]`) to PixiJS-compatible hash (`frames: {name: {...}}`).
-        let frames = textureObj.frames || {};
-        if (Array.isArray(frames)) {
-            const hashFrames = {};
-            for (const f of frames) {
-                const key = (_a = f.filename) !== null && _a !== void 0 ? _a : f.name;
-                if (key)
-                    hashFrames[key] = f;
-            }
-            frames = hashFrames;
-        }
-        const animations = textureObj.animations || {};
-        const newAnimations = {};
-        const newFrames = {};
-        for (const key in frames) {
-            const newKey = name + resourceKeySplit + key;
-            newFrames[newKey] = frames[key];
-        }
-        for (const key in animations) {
-            const spriteList = [];
-            if (animations[key] && animations[key].length >= 0) {
-                for (const spriteName of animations[key]) {
-                    const newSpriteName = name + resourceKeySplit + spriteName;
-                    spriteList.push(newSpriteName);
-                }
-            }
-            newAnimations[key] = spriteList;
-        }
-        const spriteSheet = new pixi_js.Spritesheet(texture, Object.assign(Object.assign({}, textureObj), { frames: newFrames, animations: newAnimations }));
-        spriteSheet.parse().then(() => {
-            const { textures } = spriteSheet;
-            const spriteFrames = [];
-            for (const key in textures) {
-                spriteFrames.push(textures[key]);
-            }
-            r(spriteFrames);
-        });
-    });
-});
-eva_js.resource.registerDestroy(eva_js.RESOURCE_TYPE.SPRITE_ANIMATION, ({ instance }) => {
-    if (!instance)
-        return;
-    for (const texture of instance) {
-        texture.destroy(true);
-    }
-});
-let SpriteAnimation = class SpriteAnimation extends pluginRenderer.Renderer {
-    constructor() {
-        super(...arguments);
-        this.name = 'SpriteAnimationSystem';
-        this.animates = {};
-        this.autoPlay = {};
-    }
-    init() {
-        this.renderSystem = this.game.getSystem(pluginRenderer.RendererSystem);
-        this.renderSystem.rendererManager.register(this);
-    }
-    rendererUpdate(gameObject) {
-        const { width, height } = gameObject.transform.size;
-        if (this.animates[gameObject.id]) {
-            this.animates[gameObject.id].animatedSprite.width = width;
-            this.animates[gameObject.id].animatedSprite.height = height;
-        }
-    }
-    componentChanged(changed) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const gameObjectId = changed.gameObject.id;
-            if (changed.componentName === 'SpriteAnimation') {
-                const component = changed.component;
-                this.autoPlay[changed.gameObject.id] = component.autoPlay;
-                if (changed.type === eva_js.OBSERVER_TYPE.ADD) {
-                    const asyncId = this.increaseAsyncId(gameObjectId);
-                    const { instance: frames } = yield eva_js.resource.getResource(component.resource);
-                    if (!this.validateAsyncId(gameObjectId, asyncId))
-                        return;
-                    if (!frames) {
-                        console.error(`GameObject:${changed.gameObject.name}'s Img resource load error`);
-                    }
-                    this.add({
-                        frames: frames,
-                        id: changed.gameObject.id,
-                        component,
-                    });
-                }
-                else if (changed.type === eva_js.OBSERVER_TYPE.CHANGE) {
-                    if (changed.prop && changed.prop.prop[0] === 'speed') {
-                        this.animates[changed.gameObject.id].speed = 1000 / 60 / component.speed;
-                    }
-                    else {
-                        const asyncId = this.increaseAsyncId(gameObjectId);
-                        const { instance: frames } = yield eva_js.resource.getResource(component.resource);
-                        if (!this.validateAsyncId(gameObjectId, asyncId))
-                            return;
-                        if (!frames) {
-                            console.error(`GameObject:${changed.gameObject.name}'s Img resource load error`);
-                        }
-                        this.change({
-                            frames: frames,
-                            id: changed.gameObject.id,
-                            component,
-                        });
-                    }
-                }
-                else if (changed.type === eva_js.OBSERVER_TYPE.REMOVE) {
-                    this.increaseAsyncId(gameObjectId);
-                    this.remove(changed.gameObject.id);
-                }
-            }
-        });
-    }
-    add({ frames, id, component }) {
-        const animate = new rendererAdapter.SpriteAnimation({ frames });
-        this.animates[id] = animate;
-        this.containerManager.getContainer(id).addChildAt(animate.animatedSprite, 0);
-        animate.animatedSprite.onComplete = () => {
-            component.emit('complete');
-        };
-        animate.animatedSprite.onFrameChange = () => {
-            component.emit('frameChange');
-        };
-        animate.animatedSprite.onLoop = () => {
-            component.emit('loop');
-        };
-        component.animate = this.animates[id];
-        this.animates[id].speed = 1000 / 60 / component.speed;
-        if (this.autoPlay[id]) {
-            animate.animatedSprite.play();
-        }
-    }
-    change({ frames, id, component }) {
-        this.remove(id, true);
-        this.add({ frames, id, component });
-    }
-    remove(id, isChange) {
-        const animate = this.animates[id];
-        if (!animate)
-            return;
-        this.autoPlay[id] = animate.animatedSprite.playing;
-        this.containerManager.getContainer(id).removeChild(animate.animatedSprite);
-        animate.animatedSprite.destroy();
-        delete this.animates[id];
-        if (!isChange) {
-            delete this.autoPlay[id];
-        }
-    }
-};
-SpriteAnimation.systemName = 'SpriteAnimationSystem';
-SpriteAnimation = __decorate([
-    eva_js.decorators.componentObserver({
-        SpriteAnimation: ['speed', 'resource'],
-    })
-], SpriteAnimation);
-var SpriteAnimation$1 = SpriteAnimation;
-
-exports.SpriteAnimation = SpriteAnimation$2;
-exports.SpriteAnimationSystem = SpriteAnimation$1;

package/dist/plugin-renderer-sprite-animation.cjs.prod.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),i=require("@eva/plugin-renderer"),n=require("@eva/renderer-adapter"),s=require("pixi.js");function a(e,t,i,n){var s,a=arguments.length,o=a<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,i):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,t,i,n);else for(var r=e.length-1;r>=0;r--)(s=e[r])&&(o=(a<3?s(o):a>3?s(t,i,o):s(t,i))||o);return a>3&&o&&Object.defineProperty(t,i,o),o}function o(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)}function r(e,t,i,n){return new(i||(i=Promise))(function(s,a){function o(e){try{m(n.next(e))}catch(e){a(e)}}function r(e){try{m(n.throw(e))}catch(e){a(e)}}function m(e){var t;e.done?s(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(o,r)}m((n=n.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class m extends e.Component{constructor(e){super(e),this.resource="",this.autoPlay=!0,this.speed=100,this.forwards=!1,this.animations={},this.waitPlay=!1,this.waitLoop=!1,this.waitStop=!1,this.times=1/0,this.count=0,this.complete=!1,this.listenerBound=!1,this.init(e)}init(e){e&&Object.assign(this,e),this.listenerBound||(this.listenerBound=!0,this.on("loop",()=>{var e;++this.count>=this.times&&(this.forwards?this.gotoAndStop(this.totalFrames-1):null===(e=this.animate)||void 0===e||e.stop(),this.complete=!0,this.emit("complete"))}),this.on("complete",()=>{var e;null===(e=this.onComplete)||void 0===e||e.call(this)}),this.on("frameChange",()=>{var e;null===(e=this.onFrameChange)||void 0===e||e.call(this,this.currentFrame)}))}play(e=1/0,t=!1){let i,n="number"==typeof e?e:t?1/0:1;if("string"==typeof e){this.currentAnimation=e;const t=this.animations[e];t&&(i=t.start,void 0!==t.speed&&(this.speed=t.speed))}0!==n&&(this.times=n,this.animate?(this.complete&&this.gotoAndStop(0),void 0!==i?this.animate.gotoAndPlay(i):this.animate.play(),this.count=0,this.complete=!1):(this.waitPlay=!0,this.waitAnimation="string"==typeof e?e:void 0,this.waitLoop=t))}stop(){this.animate?this.animate.stop():this.waitStop=!0}set animate(e){if(this._animate=e,this.waitPlay){this.waitPlay=!1;const e=this.waitAnimation;this.waitAnimation=void 0,this.play(null!=e?e:this.times,this.waitLoop)}this.waitStop&&(this.waitStop=!1,this.stop())}get animate(){return this._animate}gotoAndPlay(e){this.animate.gotoAndPlay(e)}gotoAndStop(e){this.animate.gotoAndStop(e)}get currentFrame(){var e,t;return null===(t=null===(e=this.animate)||void 0===e?void 0:e.animatedSprite)||void 0===t?void 0:t.currentFrame}get totalFrames(){var e,t;return null===(t=null===(e=this.animate)||void 0===e?void 0:e.animatedSprite)||void 0===t?void 0:t.totalFrames}}m.componentName="SpriteAnimation",a([t.type("string"),o("design:type",String)],m.prototype,"resource",void 0),a([t.type("boolean"),o("design:type",Boolean)],m.prototype,"autoPlay",void 0),a([t.type("number"),t.step(10),o("design:type",Number)],m.prototype,"speed",void 0),a([t.type("boolean"),o("design:type",Boolean)],m.prototype,"forwards",void 0);const c="_s|r|c_";e.resource.registerInstance(e.RESOURCE_TYPE.SPRITE_ANIMATION,({name:e,data:t})=>new Promise(i=>{var n;const a=t.json.data,o=t.image instanceof s.Texture?t.image:s.Texture.from(t.image);let r=a.frames||{};if(Array.isArray(r)){const e={};for(const t of r){const i=null!==(n=t.filename)&&void 0!==n?n:t.name;i&&(e[i]=t)}r=e}const m=a.animations||{},p={},d={};for(const t in r){d[e+c+t]=r[t]}for(const t in m){const i=[];if(m[t]&&m[t].length>=0)for(const n of m[t]){const t=e+c+n;i.push(t)}p[t]=i}const h=new s.Spritesheet(o,Object.assign(Object.assign({},a),{frames:d,animations:p}));h.parse().then(()=>{const{textures:e}=h,t=[];for(const i in e)t.push(e[i]);i(t)})})),e.resource.registerDestroy(e.RESOURCE_TYPE.SPRITE_ANIMATION,({instance:e})=>{if(e)for(const t of e)t.destroy(!0)});let p=class extends i.Renderer{constructor(){super(...arguments),this.name="SpriteAnimationSystem",this.animates={},this.autoPlay={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size;this.animates[e.id]&&(this.animates[e.id].animatedSprite.width=t,this.animates[e.id].animatedSprite.height=i)}componentChanged(t){return r(this,void 0,void 0,function*(){const i=t.gameObject.id;if("SpriteAnimation"===t.componentName){const n=t.component;if(this.autoPlay[t.gameObject.id]=n.autoPlay,t.type===e.OBSERVER_TYPE.ADD){const s=this.increaseAsyncId(i),{instance:a}=yield e.resource.getResource(n.resource);if(!this.validateAsyncId(i,s))return;a||console.error(`GameObject:${t.gameObject.name}'s Img resource load error`),this.add({frames:a,id:t.gameObject.id,component:n})}else if(t.type===e.OBSERVER_TYPE.CHANGE)if(t.prop&&"speed"===t.prop.prop[0])this.animates[t.gameObject.id].speed=1e3/60/n.speed;else{const s=this.increaseAsyncId(i),{instance:a}=yield e.resource.getResource(n.resource);if(!this.validateAsyncId(i,s))return;a||console.error(`GameObject:${t.gameObject.name}'s Img resource load error`),this.change({frames:a,id:t.gameObject.id,component:n})}else t.type===e.OBSERVER_TYPE.REMOVE&&(this.increaseAsyncId(i),this.remove(t.gameObject.id))}})}add({frames:e,id:t,component:i}){const s=new n.SpriteAnimation({frames:e});this.animates[t]=s,this.containerManager.getContainer(t).addChildAt(s.animatedSprite,0),s.animatedSprite.onComplete=()=>{i.emit("complete")},s.animatedSprite.onFrameChange=()=>{i.emit("frameChange")},s.animatedSprite.onLoop=()=>{i.emit("loop")},i.animate=this.animates[t],this.animates[t].speed=1e3/60/i.speed,this.autoPlay[t]&&s.animatedSprite.play()}change({frames:e,id:t,component:i}){this.remove(t,!0),this.add({frames:e,id:t,component:i})}remove(e,t){const i=this.animates[e];i&&(this.autoPlay[e]=i.animatedSprite.playing,this.containerManager.getContainer(e).removeChild(i.animatedSprite),i.animatedSprite.destroy(),delete this.animates[e],t||delete this.autoPlay[e])}};p.systemName="SpriteAnimationSystem",p=a([e.decorators.componentObserver({SpriteAnimation:["speed","resource"]})],p);var d=p;exports.SpriteAnimation=m,exports.SpriteAnimationSystem=d;

package/dist/plugin-renderer-sprite-animation.d.ts

@@ -1,147 +0,0 @@
-import { Component } from '@eva/eva.js';
-import { ComponentChanged } from '@eva/eva.js';
-import { ContainerManager } from '@eva/plugin-renderer';
-import { GameObject } from '@eva/eva.js';
-import { Renderer } from '@eva/plugin-renderer';
-import { RendererManager } from '@eva/plugin-renderer';
-import { RendererSystem } from '@eva/plugin-renderer';
-import { SpriteAnimation as SpriteAnimation_2 } from '@eva/renderer-adapter';
-
-/**
- * 精灵动画组件
- *
- * SpriteAnimation 组件用于播放帧动画（序列帧动画）。
- * 通过快速切换精灵图集中的不同帧，实现动画效果，
- * 适用于角色动作、特效、UI 动画等场景。
- *
- * 主要功能：
- * - 支持自动播放和手动控制
- * - 可配置播放速度和循环次数
- * - 支持跳转到指定帧
- * - 提供播放完成事件
- * - 支持 forwards 模式（停在最后一帧）
- *
- * @example
- * ```typescript
- * // 基础用法 - 自动播放
- * const character = new GameObject('character');
- * character.addComponent(new SpriteAnimation({
- *   resource: 'walkAnimation', // 帧动画资源
- *   autoPlay: true,
- *   speed: 100 // 播放速度（毫秒/帧）
- * }));
- *
- * // 控制播放
- * const anim = character.getComponent('SpriteAnimation');
- * anim.play(3); // 播放 3 次
- * anim.play(Infinity); // 无限循环
- * anim.stop(); // 停止播放
- * anim.gotoAndPlay(10); // 跳到第 10 帧并播放
- * anim.gotoAndStop(0); // 跳到第 0 帧并停止
- *
- * // 监听播放完成
- * anim.on('complete', () => {
- *   console.log('动画播放完成');
- * });
- * ```
- */
-export declare class SpriteAnimation extends Component<SpriteAnimationParams> {
-    /** 组件名称 */
-    static componentName: string;
-    /** 帧动画资源名称 */
-    resource: string;
-    /** 是否自动播放 */
-    autoPlay: boolean;
-    /** 播放速度（毫秒/帧） */
-    speed: number;
-    /** 是否在最后一帧停止（forwards 模式） */
-    forwards: boolean;
-    /** 命名动画片段，供编辑器和脚本按动作名播放 */
-    animations: Record<string, SpriteAnimationClip>;
-    /** 当前正在播放或等待播放的动画名 */
-    currentAnimation?: string;
-    /** 动画完成事件回调 */
-    onComplete?: () => void;
-    /** 帧变化事件回调 */
-    onFrameChange?: (frame?: number) => void;
-    /** 动画引擎实例 */
-    _animate: SpriteAnimation_2;
-    /** 等待播放标志（资源加载前调用 play） */
-    private waitPlay;
-    private waitAnimation?;
-    private waitLoop;
-    /** 等待停止标志 */
-    private waitStop;
-    /** 播放次数 */
-    private times;
-    /** 当前已播放次数 */
-    private count;
-    /** 是否播放完成 */
-    private complete;
-    private listenerBound;
-    constructor(params?: SpriteAnimationParams);
-    /**
-     * 初始化组件
-     * @param obj - 初始化参数
-     * @param obj.resource - 帧动画资源名称
-     * @param obj.autoPlay - 是否自动播放
-     * @param obj.speed - 播放速度
-     * @param obj.forwards - 是否停在最后一帧
-     */
-    init(obj?: SpriteAnimationParams): void;
-    play(nameOrTimes?: string | number, loop?: boolean): void;
-    stop(): void;
-    set animate(val: SpriteAnimation_2);
-    get animate(): SpriteAnimation_2;
-    gotoAndPlay(frameNumber: any): void;
-    gotoAndStop(frameNumber: any): void;
-    get currentFrame(): number;
-    get totalFrames(): number;
-}
-
-declare interface SpriteAnimationClip {
-    start: number;
-    end: number;
-    speed?: number;
-}
-
-export declare interface SpriteAnimationParams {
-    resource: string;
-    autoPlay?: boolean;
-    speed?: number;
-    /** Stop at last frame */
-    forwards?: boolean;
-    animations?: Record<string, SpriteAnimationClip>;
-    onComplete?: () => void;
-    onFrameChange?: (frame?: number) => void;
-}
-
-export declare class SpriteAnimationSystem extends Renderer {
-    static systemName: string;
-    name: string;
-    animates: {
-        [propName: number]: SpriteAnimation_2;
-    };
-    autoPlay: {
-        [propName: number]: boolean;
-    };
-    renderSystem: RendererSystem;
-    rendererManager: RendererManager;
-    containerManager: ContainerManager;
-    init(): void;
-    rendererUpdate(gameObject: GameObject): void;
-    componentChanged(changed: ComponentChanged): Promise<void>;
-    add({ frames, id, component }: {
-        frames: any;
-        id: any;
-        component: any;
-    }): void;
-    change({ frames, id, component }: {
-        frames: any;
-        id: any;
-        component: any;
-    }): void;
-    remove(id: any, isChange?: boolean): void;
-}
-
-export { }