@duyquangnvx/pixi-game-engine 0.1.5 → 0.1.6

package/README.md

@@ -1,75 +1,75 @@
-# @duyquangnvx/pixi-game-engine
-
-Full-featured PixiJS v7 game engine with TypeScript support.
-
-## Installation
-
-```bash
-pnpm add @duyquangnvx/pixi-game-engine
-```
-
-## Quick Start
-
-```typescript
-import { Engine, Scene, PIXI } from '@duyquangnvx/pixi-game-engine';
-
-class GameScene extends Scene {
-  private player!: PIXI.Sprite;
-
-  onEnter() {
-    this.player = new PIXI.Graphics();
-    this.player.beginFill(0x4ecca3);
-    this.player.drawRect(-25, -25, 50, 50);
-    this.player.x = Engine.screen.width / 2;
-    this.player.y = Engine.screen.height / 2;
-    this.addChild(this.player);
-  }
-
-  onUpdate(delta: number) {
-    const { keyboard } = Engine.input;
-
-    if (keyboard.isDown('ArrowLeft')) this.player.x -= 5 * delta;
-    if (keyboard.isDown('ArrowRight')) this.player.x += 5 * delta;
-    if (keyboard.isDown('ArrowUp')) this.player.y -= 5 * delta;
-    if (keyboard.isDown('ArrowDown')) this.player.y += 5 * delta;
-  }
-
-  onExit() {}
-}
-
-Engine.init({
-  width: 800,
-  height: 600,
-  backgroundColor: 0x1a1a2e,
-});
-
-document.body.appendChild(Engine.view as HTMLCanvasElement);
-Engine.scenes.add('game', GameScene);
-Engine.scenes.start('game');
-```
-
-## Features
-
-| Feature | Module | Description |
-|---------|--------|-------------|
-| Scenes | `SceneManager` | Scene lifecycle, transitions |
-| Input | `InputManager` | Keyboard, mouse, touch, gamepad |
-| Assets | `AssetManager` | Manifest-based loading |
-| Sound | `SoundManager` | @pixi/sound wrapper |
-| Particles | `ParticleManager` | @pixi/particle-emitter |
-| Tweens | `TweenManager` | GSAP + PixiPlugin |
-| UI | `UIManager` | @pixi/ui components |
-| Spine | `SpineManager` | pixi-spine animations |
-
-## Dependencies
-
-- pixi.js ^7.4.2
-- @pixi/sound ^5.2.3
-- @pixi/particle-emitter ^5.0.10
-- @pixi/ui ^1.2.4
-- pixi-spine ^4.0.5
-- gsap ^3.12.x
-
-## License
-
-MIT
+# @duyquangnvx/pixi-game-engine
+
+Full-featured PixiJS v7 game engine with TypeScript support.
+
+## Installation
+
+```bash
+pnpm add @duyquangnvx/pixi-game-engine
+```
+
+## Quick Start
+
+```typescript
+import { Engine, Scene, PIXI } from '@duyquangnvx/pixi-game-engine';
+
+class GameScene extends Scene {
+  private player!: PIXI.Sprite;
+
+  onEnter() {
+    this.player = new PIXI.Graphics();
+    this.player.beginFill(0x4ecca3);
+    this.player.drawRect(-25, -25, 50, 50);
+    this.player.x = Engine.screen.width / 2;
+    this.player.y = Engine.screen.height / 2;
+    this.addChild(this.player);
+  }
+
+  onUpdate(delta: number) {
+    const { keyboard } = Engine.input;
+
+    if (keyboard.isDown('ArrowLeft')) this.player.x -= 5 * delta;
+    if (keyboard.isDown('ArrowRight')) this.player.x += 5 * delta;
+    if (keyboard.isDown('ArrowUp')) this.player.y -= 5 * delta;
+    if (keyboard.isDown('ArrowDown')) this.player.y += 5 * delta;
+  }
+
+  onExit() {}
+}
+
+Engine.init({
+  width: 800,
+  height: 600,
+  backgroundColor: 0x1a1a2e,
+});
+
+document.body.appendChild(Engine.view as HTMLCanvasElement);
+Engine.scenes.add('game', GameScene);
+Engine.scenes.start('game');
+```
+
+## Features
+
+| Feature | Module | Description |
+|---------|--------|-------------|
+| Scenes | `SceneManager` | Scene lifecycle, transitions |
+| Input | `InputManager` | Keyboard, mouse, touch, gamepad |
+| Assets | `AssetManager` | Manifest-based loading |
+| Sound | `SoundManager` | @pixi/sound wrapper |
+| Particles | `ParticleManager` | @pixi/particle-emitter |
+| Tweens | `TweenManager` | GSAP + PixiPlugin |
+| UI | `UIManager` | @pixi/ui components |
+| Spine | `SpineManager` | pixi-spine animations |
+
+## Dependencies
+
+- pixi.js ^7.4.2
+- @pixi/sound ^5.2.3
+- @pixi/particle-emitter ^5.0.10
+- @pixi/ui ^1.2.4
+- pixi-spine ^4.0.5
+- gsap ^3.12.x
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1453,10 +1453,32 @@ var SpineManager = class {
   fromData(skeletonData) {
     return new import_pixi_spine2.Spine(skeletonData);
   }
-  /** Play an animation on a Spine instance */
-  play(spine, animationName, loop = true, trackIndex = 0) {
+  /** Play an animation on a Spine instance.
+   *  By default skips if the same animation is already playing (avoids restart).
+   *  Pass `force: true` to restart from frame 0. */
+  play(spine, animationName, loop = true, trackIndex = 0, options) {
+    if (!options?.force) {
+      const current = spine.state.tracks[trackIndex];
+      if (current?.animation?.name === animationName) return;
+    }
     spine.state.setAnimation(trackIndex, animationName, loop);
   }
+  /** Play a non-looping animation and resolve when it completes. */
+  playOnce(spine, animationName, trackIndex = 0) {
+    return new Promise((resolve) => {
+      spine.state.setAnimation(trackIndex, animationName, false);
+      const listener = {
+        complete: (entry) => {
+          const track = entry;
+          if (track.animation?.name === animationName) {
+            spine.state.removeListener(listener);
+            resolve();
+          }
+        }
+      };
+      spine.state.addListener(listener);
+    });
+  }
   /** Add an animation to the queue */
   queue(spine, animationName, loop = false, delay = 0, trackIndex = 0) {
     spine.state.addAnimation(trackIndex, animationName, loop, delay);
@@ -1490,6 +1512,12 @@ var SpineManager = class {
   setSpeed(spine, speed) {
     spine.state.timeScale = speed;
   }
+  /** Clear tracks, remove listeners, and destroy the spine instance. */
+  destroy(spine) {
+    spine.state.clearTracks();
+    spine.state.clearListeners();
+    spine.destroy({ children: true });
+  }
 };
 
 // src/ui/toast/toast-manager.ts