@kurot/spine-4.3 0.2.3

package/dist/kurot/Track.js

@@ -0,0 +1,203 @@
+import { EventEmitter } from './EventEmitter.js';
+/**
+ * Manages a queue of animations on a single Spine track.
+ *
+ * Animations are played sequentially. Each entry can specify a loop count
+ * and lifecycle callbacks. Promise-based helpers allow `await`-ing events.
+ *
+ * @example
+ * ```ts
+ * const track = hero.start(0);
+ * track.add('idle', 0);           // loop forever
+ * track.add('attack', 1);         // play once, then continue queue
+ * await track.waitPlayEnd();
+ * ```
+ */
+export class Track extends EventEmitter {
+    // ── Instance fields ───────────────────────────────────────────────────────
+    trackID;
+    skelAnimation;
+    trackEntry;
+    _animations = [];
+    _disposed = false;
+    _loop = 0;
+    _stateListener;
+    // ── Constructor ───────────────────────────────────────────────────────────
+    constructor(skelAnimation, trackID) {
+        super();
+        this.trackID = trackID;
+        this.skelAnimation = skelAnimation;
+        this._stateListener = {
+            complete: () => this._onComplete(),
+            interrupt: () => this._onInterrupt(),
+            event: (_, event) => this._onCustomEvent(event),
+            start: undefined,
+            end: undefined,
+            dispose: undefined,
+        };
+    }
+    // ── Public methods ────────────────────────────────────────────────────────
+    /**
+     * Add an animation to the queue.
+     * @param name Animation name as defined in the Spine editor.
+     * @param loop Number of times to play. 0 = loop forever.
+     * @param listener Optional lifecycle callbacks for this animation.
+     */
+    add(name, loop = 1, listener) {
+        if (!this._disposed && this._animations) {
+            this._animations.push({ name, loop, listener });
+            if (this._animations.length === 1) {
+                this._playNext();
+            }
+        }
+        return this;
+    }
+    /**
+     * Jump the track entry to its last frame.
+     */
+    setToLastFrame() {
+        const entry = this.trackEntry;
+        if (entry) {
+            entry['animationStart'] = entry['animationLast'] = entry['animationEnd'];
+        }
+    }
+    // ── Promise helpers ───────────────────────────────────────────────────────
+    /**
+     * Resolves when the current animation's first loop begins.
+     */
+    waitPlayStart() {
+        return new Promise(resolve => this.once(0 /* SpineEvent.PlayStart */, resolve));
+    }
+    /**
+     * Resolves when the current animation finishes all its loops.
+     */
+    waitPlayEnd() {
+        return new Promise(resolve => this.once(1 /* SpineEvent.PlayEnd */, resolve));
+    }
+    /**
+     * Resolves at the start of each loop iteration.
+     */
+    waitLoopStart() {
+        return new Promise(resolve => this.once(2 /* SpineEvent.LoopStart */, resolve));
+    }
+    /**
+     * Resolves at the end of each loop iteration.
+     */
+    waitLoopEnd() {
+        return new Promise(resolve => this.once(3 /* SpineEvent.LoopEnd */, resolve));
+    }
+    /**
+     * Resolves when the track is interrupted by another animation.
+     */
+    waitInterrupt() {
+        return new Promise(resolve => this.once(4 /* SpineEvent.Interrupt */, resolve));
+    }
+    /**
+     * Resolves when the entire animation queue is exhausted.
+     */
+    waitTrackEnd() {
+        return new Promise(resolve => this.once(6 /* SpineEvent.TrackEnd */, resolve));
+    }
+    /**
+     * Resolves on the next Spine frame event.
+     */
+    waitEvent() {
+        return new Promise(resolve => this.once(5 /* SpineEvent.Custom */, resolve));
+    }
+    /**
+     * Resolves when a Spine frame event with the given name fires.
+     */
+    waitNamedEvent(name) {
+        return new Promise(resolve => {
+            const callback = (event) => {
+                const e = event;
+                if (e?.data?.name === name) {
+                    this.off(5 /* SpineEvent.Custom */, callback);
+                    resolve(event);
+                }
+            };
+            this.on(5 /* SpineEvent.Custom */, callback);
+        });
+    }
+    // ── Private methods ───────────────────────────────────────────────────────
+    _playNext() {
+        if (this._disposed || this._animations.length === 0)
+            return;
+        const { name, listener } = this._animations[0];
+        if (listener) {
+            if (listener.playStart)
+                this.on(0 /* SpineEvent.PlayStart */, listener.playStart, listener);
+            if (listener.playEnd)
+                this.on(1 /* SpineEvent.PlayEnd */, listener.playEnd, listener);
+            if (listener.loopStart)
+                this.on(2 /* SpineEvent.LoopStart */, listener.loopStart, listener);
+            if (listener.loopEnd)
+                this.on(3 /* SpineEvent.LoopEnd */, listener.loopEnd, listener);
+            if (listener.interrupt)
+                this.on(4 /* SpineEvent.Interrupt */, listener.interrupt, listener);
+            if (listener.custom)
+                this.on(5 /* SpineEvent.Custom */, listener.custom, listener);
+        }
+        this._loop = 0;
+        this._setAnimation(name, false);
+        this.emit(0 /* SpineEvent.PlayStart */);
+        this.emit(2 /* SpineEvent.LoopStart */);
+    }
+    _setAnimation(name, loop) {
+        const entry = this.trackEntry;
+        if (entry) {
+            entry['listener'] = undefined;
+        }
+        this.trackEntry = this.skelAnimation.state.setAnimation(this.trackID, name, loop);
+        const newEntry = this.trackEntry;
+        newEntry['listener'] = this._stateListener;
+        this.skelAnimation.renderer.update(0);
+    }
+    _onComplete() {
+        if (this._disposed)
+            return;
+        const animation = this._animations[0];
+        this.emit(3 /* SpineEvent.LoopEnd */);
+        if (++this._loop !== animation.loop) {
+            this._setAnimation(animation.name, false);
+            this.emit(2 /* SpineEvent.LoopStart */);
+        }
+        else {
+            const { listener } = animation;
+            this.emit(1 /* SpineEvent.PlayEnd */);
+            this._animations.shift();
+            if (listener) {
+                this.off(0 /* SpineEvent.PlayStart */, listener.playStart);
+                this.off(1 /* SpineEvent.PlayEnd */, listener.playEnd);
+                this.off(2 /* SpineEvent.LoopStart */, listener.loopStart);
+                this.off(3 /* SpineEvent.LoopEnd */, listener.loopEnd);
+                this.off(4 /* SpineEvent.Interrupt */, listener.interrupt);
+                this.off(5 /* SpineEvent.Custom */, listener.custom);
+            }
+            if (this._animations.length > 0) {
+                this._playNext();
+            }
+            else {
+                const entry = this.trackEntry;
+                if (entry)
+                    entry['listener'] = undefined;
+                this.trackEntry = undefined;
+                this._disposed = true;
+                this.emit(6 /* SpineEvent.TrackEnd */);
+            }
+        }
+    }
+    _onInterrupt() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        this._animations.length = 0;
+        this.emit(4 /* SpineEvent.Interrupt */);
+    }
+    _onCustomEvent(event) {
+        if (!this._disposed) {
+            this.emit(5 /* SpineEvent.Custom */, event);
+        }
+    }
+}
+//# sourceMappingURL=Track.js.map

package/dist/kurot/Track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Track.js","sourceRoot":"","sources":["../../src/kurot/Track.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@kurot/spine-4.3",
+	"version": "0.2.3",
+	"description": "Spine 4.3 runtime for the Kurot engine",
+	"author": "",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist/**/*"
+	],
+	"scripts": {
+		"build": "tsc --build",
+		"dev": "tsc --watch",
+		"example": "vite --config vite.config.ts",
+		"clean": "rm -rf dist",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"dependencies": {
+		"@esotericsoftware/spine-core": "~4.3.0"
+	},
+	"peerDependencies": {
+		"@kurot/core": "^1.0.12"
+	},
+	"devDependencies": {
+		"@kurot/core": "^1.0.12",
+		"@types/node": "^22.0.0",
+		"typescript": "^5.6.0",
+		"vite": "^8.0.8"
+	},
+	"keywords": [
+		"kurot",
+		"spine",
+		"h5-game",
+		"typescript"
+	],
+	"packageManager": "pnpm@10.33.0",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kurot-engine/kurot.git",
+		"directory": "packages/spine-4.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}