@melonjs/spine-plugin 1.3.0 → 1.5.0

package/dist/@melonjs/spine-plugin.js

@@ -1,11 +1,11 @@
 /*!
- * melonJS Spine plugin - v1.3.0
+ * melonJS Spine plugin - v1.5.0
  * http://www.melonjs.org
  * @melonjs/spine-plugin is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
  * @copyright (C) 2011 - 2023 AltByte Pte Ltd
  */
-import { event, video, Color as Color$1, Polygon, Math as Math$1, Renderable as Renderable$1, Vector2d } from 'melonjs';
+import { Color as Color$1, Polygon, Math as Math$1, loader, utils, plugin, Renderable as Renderable$1, Vector2d } from 'melonjs';
 
 /******************************************************************************
  * Spine Runtimes License Agreement
@@ -11276,41 +11276,6 @@ class ManagedWebGLRenderingContext {
             this.restorables.splice(index, 1);
     }
 }
-const ONE = 1;
-const ONE_MINUS_SRC_COLOR = 0x0301;
-const SRC_ALPHA = 0x0302;
-const ONE_MINUS_SRC_ALPHA = 0x0303;
-const ONE_MINUS_DST_ALPHA = 0x0305;
-const DST_COLOR = 0x0306;
-class WebGLBlendModeConverter {
-    static getDestGLBlendMode(blendMode) {
-        switch (blendMode) {
-            case BlendMode.Normal: return ONE_MINUS_SRC_ALPHA;
-            case BlendMode.Additive: return ONE;
-            case BlendMode.Multiply: return ONE_MINUS_SRC_ALPHA;
-            case BlendMode.Screen: return ONE_MINUS_SRC_ALPHA;
-            default: throw new Error("Unknown blend mode: " + blendMode);
-        }
-    }
-    static getSourceColorGLBlendMode(blendMode, premultipliedAlpha = false) {
-        switch (blendMode) {
-            case BlendMode.Normal: return premultipliedAlpha ? ONE : SRC_ALPHA;
-            case BlendMode.Additive: return premultipliedAlpha ? ONE : SRC_ALPHA;
-            case BlendMode.Multiply: return DST_COLOR;
-            case BlendMode.Screen: return ONE;
-            default: throw new Error("Unknown blend mode: " + blendMode);
-        }
-    }
-    static getSourceAlphaGLBlendMode(blendMode) {
-        switch (blendMode) {
-            case BlendMode.Normal: return ONE;
-            case BlendMode.Additive: return ONE;
-            case BlendMode.Multiply: return ONE_MINUS_SRC_ALPHA;
-            case BlendMode.Screen: return ONE_MINUS_SRC_COLOR;
-            default: throw new Error("Unknown blend mode: " + blendMode);
-        }
-    }
-}
 
 /******************************************************************************
  * Spine Runtimes License Agreement
@@ -12760,6 +12725,12 @@ var VertexAttributeType;
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
  * SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *****************************************************************************/
+const GL_ONE = 1;
+const GL_ONE_MINUS_SRC_COLOR = 0x0301;
+const GL_SRC_ALPHA = 0x0302;
+const GL_ONE_MINUS_SRC_ALPHA = 0x0303;
+const GL_ONE_MINUS_DST_ALPHA = 0x0305;
+const GL_DST_COLOR = 0x0306;
 class PolygonBatcher {
     constructor(context, twoColorTint = true, maxVertices = 10920) {
         this.drawCalls = 0;
@@ -12797,7 +12768,11 @@ class PolygonBatcher {
                 gl.disable(gl.CULL_FACE);
         }
     }
-    setBlendMode(srcColorBlend, srcAlphaBlend, dstBlend) {
+    setBlendMode(blendMode, premultipliedAlpha) {
+        const blendModeGL = PolygonBatcher.blendModesGL[blendMode];
+        const srcColorBlend = premultipliedAlpha ? blendModeGL.srcRgbPma : blendModeGL.srcRgb;
+        const srcAlphaBlend = blendModeGL.srcAlpha;
+        const dstBlend = blendModeGL.dstRgb;
         if (this.srcColorBlend == srcColorBlend && this.srcAlphaBlend == srcAlphaBlend && this.dstBlend == dstBlend)
             return;
         this.srcColorBlend = srcColorBlend;
@@ -12805,9 +12780,9 @@ class PolygonBatcher {
         this.dstBlend = dstBlend;
         if (this.isDrawing) {
             this.flush();
-            let gl = this.context.gl;
-            gl.blendFuncSeparate(srcColorBlend, dstBlend, srcAlphaBlend, dstBlend);
         }
+        let gl = this.context.gl;
+        gl.blendFuncSeparate(srcColorBlend, dstBlend, srcAlphaBlend, dstBlend);
     }
     draw(texture, vertices, indices) {
         if (texture != this.lastTexture) {
@@ -12873,6 +12848,12 @@ class PolygonBatcher {
 }
 PolygonBatcher.disableCulling = false;
 PolygonBatcher.globalDrawCalls = 0;
+PolygonBatcher.blendModesGL = [
+    { srcRgb: GL_SRC_ALPHA, srcRgbPma: GL_ONE, dstRgb: GL_ONE_MINUS_SRC_ALPHA, srcAlpha: GL_ONE },
+    { srcRgb: GL_SRC_ALPHA, srcRgbPma: GL_ONE, dstRgb: GL_ONE, srcAlpha: GL_ONE },
+    { srcRgb: GL_DST_COLOR, srcRgbPma: GL_DST_COLOR, dstRgb: GL_ONE_MINUS_SRC_ALPHA, srcAlpha: GL_ONE },
+    { srcRgb: GL_ONE, srcRgbPma: GL_ONE, dstRgb: GL_ONE_MINUS_SRC_COLOR, srcAlpha: GL_ONE }
+];
 
 /******************************************************************************
  * Spine Runtimes License Agreement
@@ -13493,10 +13474,6 @@ let SkeletonRenderer$2 = class SkeletonRenderer {
         let premultipliedAlpha = this.premultipliedAlpha;
         let twoColorTint = this.twoColorTint;
         let blendMode = null;
-        let tempPos = this.temp;
-        let tempUv = this.temp2;
-        let tempLight = this.temp3;
-        let tempDark = this.temp4;
         let renderable = this.renderable;
         let uvs;
         let triangles;
@@ -13589,7 +13566,7 @@ let SkeletonRenderer$2 = class SkeletonRenderer {
                 let slotBlendMode = slot.data.blendMode;
                 if (slotBlendMode != blendMode) {
                     blendMode = slotBlendMode;
-                    batcher.setBlendMode(WebGLBlendModeConverter.getSourceColorGLBlendMode(blendMode, premultipliedAlpha), WebGLBlendModeConverter.getSourceAlphaGLBlendMode(blendMode), WebGLBlendModeConverter.getDestGLBlendMode(blendMode));
+                    batcher.setBlendMode(blendMode, premultipliedAlpha);
                 }
                 if (clipper.isClipping()) {
                     clipper.clipTriangles(renderable.vertices, renderable.numFloats, triangles, triangles.length, uvs, finalColor, darkColor, twoColorTint);
@@ -14185,7 +14162,7 @@ class LoadingScreen {
         let gl = renderer.context.gl;
         renderer.resize(ResizeMode.Expand);
         renderer.camera.position.set(canvas.width / 2, canvas.height / 2, 0);
-        renderer.batcher.setBlendMode(gl.ONE, gl.ONE, gl.ONE_MINUS_SRC_ALPHA);
+        renderer.batcher.setBlendMode(BlendMode.Normal, true);
         if (complete) {
             this.fadeOut += this.timeKeeper.delta * (this.timeKeeper.totalTime < 1 ? 2 : 1);
             if (this.fadeOut > FADE_OUT)
@@ -14259,8 +14236,10 @@ let SPINE_LOGO_DATA = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKUAAABsCAY
 class SpineCanvas {
     /** Constructs a new spine canvas, rendering to the provided HTML canvas. */
     constructor(canvas, config) {
+        this.config = config;
         /** Tracks the current time, delta, and other time related statistics. */
         this.time = new TimeKeeper();
+        this.disposed = false;
         if (!config.pathPrefix)
             config.pathPrefix = "";
         if (!config.app)
@@ -14270,6 +14249,7 @@ class SpineCanvas {
                 update: () => { },
                 render: () => { },
                 error: () => { },
+                dispose: () => { },
             };
         if (!config.webglConfig)
             config.webglConfig = { alpha: true };
@@ -14282,6 +14262,8 @@ class SpineCanvas {
         if (config.app.loadAssets)
             config.app.loadAssets(this);
         let loop = () => {
+            if (this.disposed)
+                return;
             requestAnimationFrame(loop);
             this.time.update();
             if (config.app.update)
@@ -14290,6 +14272,8 @@ class SpineCanvas {
                 config.app.render(this);
         };
         let waitForAssets = () => {
+            if (this.disposed)
+                return;
             if (this.assetManager.isLoadingComplete()) {
                 if (this.assetManager.hasErrors()) {
                     if (config.app.error)
@@ -14311,6 +14295,12 @@ class SpineCanvas {
         this.gl.clearColor(r, g, b, a);
         this.gl.clear(this.gl.COLOR_BUFFER_BIT);
     }
+    /** Disposes the app, so the update() and render() functions are no longer called. Calls the dispose() callback.*/
+    dispose() {
+        if (this.config.app.dispose)
+            this.config.app.dispose(this);
+        this.disposed = true;
+    }
 }
 
 var spineWebGL = {
@@ -14462,7 +14452,6 @@ var spineWebGL = {
     VertexAttachment: VertexAttachment,
     VertexAttribute: VertexAttribute,
     get VertexAttributeType () { return VertexAttributeType; },
-    WebGLBlendModeConverter: WebGLBlendModeConverter,
     WindowedMean: WindowedMean
 };
 
@@ -14890,45 +14879,6 @@ var spineCanvas = {
     WindowedMean: WindowedMean
 };
 
-class AssetManager {
-    asset_manager;
-    pathPrefix;
-
-    constructor(pathPrefix = "") {
-        event.once(event.VIDEO_INIT, this.initAssetManager.bind(this));
-        this.pathPrefix = pathPrefix;
-    }
-
-    initAssetManager() {
-        if (video.renderer.WebGLVersion >= 1) {
-            this.asset_manager = new AssetManager$2(video.renderer.getContext(), this.pathPrefix);
-        } else {
-            // canvas renderer
-            this.asset_manager = new AssetManager$1(this.pathPrefix);
-        }
-    }
-
-    setPrefix(pathPrefix) {
-        this.asset_manager.pathPrefix = pathPrefix;
-    }
-
-    loadAsset(atlas, skel) {
-        if (atlas) {
-            this.asset_manager.loadTextureAtlas(atlas);
-        }
-
-        if (skel.endsWith(".skel")) {
-            this.asset_manager.loadBinary(skel);
-        } else {
-            this.asset_manager.loadText(skel);
-        }
-    }
-
-    loadAll() {
-        return this.asset_manager.loadAll();
-    }
-}
-
 const vertexSize = 2 + 2 + 4;
 const blendModeLUT = ["normal", "additive", "multiply", "screen"];
 const regionDebugColor = "green";
@@ -15147,28 +15097,347 @@ class SkeletonRenderer {
     }
 }
 
-let assetManager = new AssetManager();
+var name = "@melonjs/spine-plugin";
+var version = "1.5.0";
+var description = "melonJS Spine plugin";
+var homepage = "https://github.com/melonjs/spine-plugin#readme";
+var type = "module";
+var keywords = [
+	"2D",
+	"HTML5",
+	"javascript",
+	"TypeScript",
+	"ES6",
+	"Canvas",
+	"WebGL",
+	"WebGL2",
+	"melonjs",
+	"plugin",
+	"spine",
+	"spine-runtimes",
+	"spine-animation",
+	"esotericsoftware"
+];
+var repository = {
+	type: "git",
+	url: "git+https://github.com/melonjs/spine-plugin.git"
+};
+var bugs = {
+	url: "https://github.com/melonjs/spine-plugin/issues"
+};
+var license = "MIT";
+var author = "AltByte Pte Ltd";
+var funding = "https://github.com/sponsors/melonjs";
+var engines = {
+	node: ">= 19"
+};
+var main = "dist/@melonjs/spine-plugin.js";
+var module = "dist/@melonjs/spine-plugin.js";
+var types = "dist/@melonjs/spine-plugin.d.ts";
+var sideEffects = false;
+var files = [
+	"dist/",
+	"src/",
+	"package.json",
+	"README.md",
+	"LICENSE",
+	"CHANGELOG.md"
+];
+var peerDependencies = {
+	melonjs: "^15.12.0"
+};
+var dependencies = {
+	"@esotericsoftware/spine-canvas": "^4.2.23",
+	"@esotericsoftware/spine-core": "^4.2.23",
+	"@esotericsoftware/spine-webgl": "^4.2.23"
+};
+var devDependencies = {
+	"@babel/eslint-parser": "^7.22.15",
+	"@babel/plugin-syntax-import-assertions": "^7.22.5",
+	"@rollup/plugin-commonjs": "^25.0.4",
+	"@rollup/plugin-json": "^6.0.0",
+	"@rollup/plugin-node-resolve": "^15.2.1",
+	"@rollup/plugin-replace": "^5.0.2",
+	"del-cli": "^5.1.0",
+	eslint: "^8.50.0",
+	"eslint-plugin-jsdoc": "^46.8.2",
+	rollup: "^3.29.2",
+	"rollup-plugin-bundle-size": "^1.0.3",
+	typescript: "^5.2.2"
+};
+var scripts = {
+	build: "npm run clean && npm run lint && rollup -c --silent && npm run types",
+	lint: "eslint src/**.js rollup.config.mjs",
+	serve: "python3 -m http.server",
+	test: "npm run serve",
+	prepublishOnly: "npm run build",
+	clean: "del-cli --force dist/*",
+	types: "tsc"
+};
+var _package = {
+	name: name,
+	version: version,
+	description: description,
+	homepage: homepage,
+	type: type,
+	keywords: keywords,
+	repository: repository,
+	bugs: bugs,
+	license: license,
+	author: author,
+	funding: funding,
+	engines: engines,
+	main: main,
+	module: module,
+	types: types,
+	sideEffects: sideEffects,
+	files: files,
+	peerDependencies: peerDependencies,
+	dependencies: dependencies,
+	devDependencies: devDependencies,
+	scripts: scripts
+};
 
+/**
+ * @classdesc
+ * An Asset Manager class to load spine assets
+ */
+class AssetManager {
+    asset_manager;
+    pathPrefix;
+
+    /**
+     * @param {CanvasRenderer|WebGLRenderer} renderer - a melonJS renderer instance
+     * @param {string} [pathPrefix=""] - a default path prefix for assets location
+     */
+    constructor(renderer, pathPrefix = "") {
+        this.pathPrefix = pathPrefix;
+        if (renderer.WebGLVersion >= 1) {
+            this.asset_manager = new AssetManager$2(renderer.getContext(), this.pathPrefix);
+        } else {
+            // canvas renderer
+            this.asset_manager = new AssetManager$1(this.pathPrefix);
+        }
+
+        // set the spine custom parser
+        loader.setParser("spine", (data, onload, onerror) => {
+            // decompose data.src for the spine loader
+            const ext = utils.file.getExtension(data.src);
+            const basename = utils.file.getBasename(data.src);
+            const path = utils.file.getPath(data.src);
+            const filename = basename + "." + ext;
+
+            this.setPrefix(path);
+
+            // load asset
+            switch (ext) {
+                case "atlas":
+                    this.loadTextureAtlas(filename, onload, onerror);
+                    break;
+                case "json":
+                    this.loadText(filename, onload, onerror);
+                    break;
+                case "skel":
+                    this.loadBinary(filename, onload, onerror);
+                    break;
+                default:
+                    throw "Spine plugin: unknown extension when preloading spine assets";
+            }
+
+            return 1;
+        });
+
+    }
+
+    /**
+     * set a default path prefix for assets location
+     * @see loadAsset
+     * @param {string} pathPrefix
+     */
+    setPrefix(pathPrefix) {
+        this.asset_manager.pathPrefix =  this.pathPrefix = pathPrefix;
+    }
+
+    /**
+     * define all spine assets to be loaded
+     * @see setPrefix
+     * @see loadAll
+     * @param {string} atlas
+     * @param {string} skel
+     * @example
+     * // "manually" load spine assets
+     * Spine.assetManager.setPrefix("data/spine/");
+     * Spine.assetManager.loadAsset("alien.atlas", "alien-ess.json");
+     * await Spine.assetManager.loadAll();
+     */
+    loadAsset(atlas, skel) {
+        if (atlas) {
+            this.loadTextureAtlas(atlas);
+        }
+
+        if (skel.endsWith(".skel")) {
+            this.loadBinary(skel);
+        } else {
+            this.loadText(skel);
+        }
+    }
+
+    /**
+     * load the given texture atlas
+     * @param {string} atlas
+     */
+    loadTextureAtlas(atlas, onload, onerror) {
+        return this.asset_manager.loadTextureAtlas(atlas, onload, onerror);
+    }
+
+
+    /**
+     * load the given skeleton .skel file
+     * @param {string} skel
+     */
+    loadBinary(skel, onload, onerror) {
+        return this.asset_manager.loadBinary(skel, onload, onerror);
+    }
+
+    /**
+     * load the given skeleton binary file
+     * @param {string} skel
+     */
+    loadText(skel, onload, onerror) {
+        return this.asset_manager.loadText(skel, onload, onerror);
+    }
+
+    /**
+     * load all defined spine assets
+     * @see loadAsset
+     */
+    loadAll() {
+        return this.asset_manager.loadAll();
+    }
+
+    /**
+     * get the loaded skeleton data
+     * @param {string} path
+     */
+    require(path) {
+        return this.asset_manager.require(path);
+    }
+}
+
+/**
+ * @classdesc
+ * a Spine 4.x plugin implementation for melonJS
+ * @augments plugin.BasePlugin
+ */
+class SpinePlugin extends plugin.BasePlugin {
+    constructor() {
+        // call the super constructor
+        super();
+
+        // minimum melonJS version expected to run this plugin
+        this.version = peerDependencies["melonjs"];
+
+        // hello world
+        console.log(`${name} ${version} - spine runtime ${dependencies["@esotericsoftware/spine-core"]} | ${homepage}`);
+
+        // instantiate the asset manager
+        this.assetManager = new AssetManager(this.app.renderer);
+    }
+}
+
+// a temporary array used for skeleton.getBounds();
+let tempArray = [];
+
+/**
+ * @classdesc
+ * An renderable object to render Spine animated skeleton.
+ * @augments Renderable
+ */
 class Spine extends Renderable$1 {
     runtime;
     skeleton;
+    plugin;
+    renderer;
     animationState;
     skeletonRenderer;
-    assetManager;
     root;
     boneOffset;
     boneSize;
+    isSpineFlipped = {
+        x : false,
+        y : false
+    };
 
+    /**
+     * Stores settings and other state for the playback of the current animation (if any).
+     * @type {TrackEntry}
+     * @see http://en.esotericsoftware.com/spine-api-reference#TrackEntry
+     * @see setAnimation
+     * @default undefined
+     * @example
+     * // set a default animation to "run"
+     * this.setAnimation(0, "run", true);
+     * ...
+     * ...
+     * // pause the animation
+     * this.currentTrack.timeScale = 0;
+     * ...
+     * ...
+     * // resume the animation
+     * this.currentTrack.timeScale = 1;
+     */
+    currentTrack;
+
+    /**
+     * @param {number} x - the x coordinates of the Spine object
+     * @param {number} y - the y coordinates of the Spine object
+     * @param {object} settings - Configuration parameters for the Spine object
+     * @param {number} [settings.atlasFile] - the name of the atlasFile to be used to create this spine animation
+     * @param {number} [settings.jsonFile] - the name of the atlasFile to be used to create this spine animation
+     * @param {number} [settings.mixTime = 0.2] - the default mix duration to use when no mix duration has been defined between two animations.
+     * @example
+    * import * as Spine from '@melonjs/spine-plugin';
+    * import * as me from 'melonjs';
+    *
+    * // prepare/declare assets for the preloader
+    * const DataManifest = [
+    *     {
+    *         "name": "alien-ess.json",
+    *         "type": "spine",
+    *         "src": "data/spine/alien-ess.json"
+    *     },
+    *     {
+    *         "name": "alien.atlas",
+    *         "type": "spine",
+    *         "src": "data/spine/alien.atlas"
+    *     },
+    * ]
+    *
+    * // create a new Spine Renderable
+    * let spineAlien = new Spine(100, 100, {atlasFile: "alien.atlas", jsonFile: "alien-ess.json"});
+    *
+    * // set default animation
+    * spineAlien.setAnimation(0, "death", true);
+    *
+    * // add it to the game world
+    * me.game.world.addChild(spineAlien);
+    */
     constructor(x, y, settings) {
         super(x, y, settings.width, settings.height);
 
-        if (video.renderer.WebGLVersion >= 1) {
+        // ensure plugin was properly registered
+        this.plugin = plugin.get(SpinePlugin);
+        if (typeof this.plugin === "undefined") {
+            throw "Spine plugin: plugin needs to be registered first using plugin.register";
+        }
+        this.renderer = this.plugin.app.renderer;
+
+        if (this.renderer.WebGLVersion >= 1) {
             this.runtime = spineWebGL;
         } else {
             this.runtime = spineCanvas;
         }
 
-        this.assetManager = assetManager.asset_manager;
         this.skeletonRenderer = new SkeletonRenderer(this.runtime);
 
         // force anchorPoint to 0,0
@@ -15179,20 +15448,26 @@ class Spine extends Renderable$1 {
             this.pos.z = settings.z;
         }
 
-        this.scaleValue = {x: 1, y: 1};
+        // use internally when calulcating bounds
         this.boneOffset = new Vector2();
         this.boneSize = new Vector2();
 
-        this.mixTime = settings.mixTime || 0.2;
+        // default mixTime
+        this.mixTime = typeof settings.mixTime !== "undefined" ? settings.mixTime :  0.2;
+
 
         if (settings.jsonFile) {
             this.jsonFile = settings.jsonFile;
             this.atlasFile = settings.atlasFile;
-
             this.setSkeleton(this.atlasFile, this.jsonFile);
         }
     }
 
+    /**
+     * Whether to enabler the debug mode when rendering the spine object
+     * @default false
+     * @type {boolean}
+     */
     get debugRendering() {
         return this.skeletonRenderer.debugRendering;
     }
@@ -15201,43 +15476,107 @@ class Spine extends Renderable$1 {
         this.skeletonRenderer.debugRendering = value;
     }
 
+    /**
+     * set and load the given skeleton atlas and json definition files
+     * (use this if you did not specify any json or atlas through the constructor)
+     * @param {number} [atlasFile] - the name of the atlasFile to be used to create this spine animation
+     * @param {number} [jsonFile] - the name of the atlasFile to be used to create this spine animation
+     * @example
+     * // create a new Spine Renderable
+     * let spineAlien = new Spine(100, 100);
+     *
+     * // set the skeleton
+     * spineAlien.setSkeleton("alien.atlas", "alien-ess.json");
+     *
+     * // set default animation
+     * spineAlien.setAnimation(0, "death", true);
+     *
+     * // add it to the game world
+     * me.game.world.addChild(spineAlien);
+     */
     setSkeleton(atlasFile, jsonFile) {
-        this.loadSpineAssets(atlasFile, jsonFile);
-        this.root = this.skeleton.getRootBone();
-         // Spine uses Y-up, melonJS uses Y-down
-        this.root.scaleY *= -1;
-    }
-
-    loadSpineAssets(atlasFile, jsonFile) {
         // Create the texture atlas and skeleton data.
-        let atlas = this.assetManager.require(atlasFile);
+        let atlas = this.plugin.assetManager.require(atlasFile);
         let atlasLoader = new this.runtime.AtlasAttachmentLoader(atlas);
         let skeletonJson = new this.runtime.SkeletonJson(atlasLoader);
-        let skeletonData = skeletonJson.readSkeletonData(this.assetManager.require(jsonFile));
+        let skeletonData = skeletonJson.readSkeletonData(this.plugin.assetManager.require(jsonFile));
 
         // Instantiate a new skeleton based on the atlas and skeleton data.
         this.skeleton = new this.runtime.Skeleton(skeletonData);
-        this.skeleton.setToSetupPose();
-        this.skeleton.updateWorldTransform();
+
+        this.setToSetupPose();
 
         // Setup an animation state with a default mix of 0.2 seconds.
         var animationStateData = new this.runtime.AnimationStateData(this.skeleton.data);
         animationStateData.defaultMix = this.mixTime;
         this.animationState = new this.runtime.AnimationState(animationStateData);
+
+        // get a reference to the root bone
+        this.root = this.skeleton.getRootBone();
+    }
+
+    /**
+     * flip the Spine skeleton on the horizontal axis (around its center)
+     * @param {boolean} [flip=true] - `true` to flip this Spine object.
+     * @returns {Spine} Reference to this object for method chaining
+     */
+    flipX(flip = true) {
+        if (this.isSpineFlipped.x !== flip) {
+            this.isSpineFlipped.x = flip;
+            this.root.scaleX *= -1;
+            this.isDirty = true;
+        }
+        return this;
+    }
+
+    /**
+     * flip the Spine skeleton on the vertical axis (around its center)
+     * @param {boolean} [flip=true] - `true` to flip this Spine object.
+     * @returns {Spine} Reference to this object for method chaining
+     */
+    flipY(flip = true) {
+        if (this.isSpineFlipped.y !== flip) {
+            this.isSpineFlipped.y = flip;
+            this.root.scaleY *= -1;
+            this.isDirty = true;
+        }
+        return this;
     }
 
+     /**
+     * Rotate this Spine object by the specified angle (in radians).
+     * @param {number} angle - The angle to rotate (in radians)
+     * @param {Vector2d|ObservableVector2d} [v] - an optional point to rotate around
+     * @returns {Spine} Reference to this object for method chaining
+     */
     rotate(angle, v) {
         // rotation for rootBone is in degrees (anti-clockwise)
         this.skeleton.getRootBone().rotation -= Math$1.radToDeg(angle) + 90;
         // melonJS rotate method takes radians
-        super.rotate(angle, v);
+        return super.rotate(angle, v);
     }
 
+     /**
+     * scale the Spine object around his anchor point.  Scaling actually applies changes
+     * to the currentTransform member wich is used by the renderer to scale the object
+     * when rendering.  It does not scale the object itself.  For example if the renderable
+     * is an image, the image.width and image.height properties are unaltered but the currentTransform
+     * member will be changed.
+     * @param {number} x - a number representing the abscissa of the scaling vector.
+     * @param {number} [y=x] - a number representing the ordinate of the scaling vector.
+     * @returns {Spine} Reference to this object for method chaining
+     */
     scale(x, y = x) {
-        this.scaleValue = {x, y};
-        super.scale(x, y);
+        // untested
+        return super.scale(x, y);
     }
 
+    /**
+     * update the bounding box for this spine object.
+     * (this will automatically update the bounds of the entire skeleton animation)
+     * @param {boolean} [absolute=true] - update the bounds size and position in (world) absolute coordinates
+     * @returns {Bounds} this shape bounding box Rectangle object
+     */
     updateBounds(absolute = true) {
         if (this.isRenderable) {
             let bounds = this.getBounds();
@@ -15250,13 +15589,16 @@ class Spine extends Renderable$1 {
                 let boneOffset = this.boneOffset;
                 let boneSize = this.boneSize;
 
-                this.skeleton.getBounds(boneOffset, boneSize);
+                this.skeleton.getBounds(boneOffset, boneSize, tempArray);
+
+                let minX = boneOffset.x - rootBone.x,
+                    minY = boneOffset.y - rootBone.y;
 
                 bounds.addFrame(
-                    boneOffset.x - rootBone.x,
-                    boneOffset.y - rootBone.y,
-                    boneSize.x + boneOffset.x - rootBone.x,
-                    boneSize.y + boneOffset.y  - rootBone.y,
+                    minX,
+                    minY,
+                    minX + boneSize.x,
+                    minY + boneSize.y,
                     !isIdentity ? this.currentTransform : undefined
                 );
             } else {
@@ -15271,6 +15613,7 @@ class Spine extends Renderable$1 {
 
             if (absolute === true) {
                 var absPos = this.getAbsolutePosition();
+                //bounds.translate(absPos.x, absPos.y);
                 bounds.centerOn(absPos.x + bounds.centerX,  absPos.y + bounds.centerY);
             }
             return bounds;
@@ -15290,22 +15633,24 @@ class Spine extends Renderable$1 {
     update(dt) {
         if (typeof this.skeleton !== "undefined") {
             let rootBone = this.skeleton.getRootBone();
-
-            // update the root bone position
-            if (rootBone.x !== this.pos.x) {
-                rootBone.x = this.pos.x;
-            }
-            if (rootBone.y !== this.pos.y) {
-                rootBone.y = this.pos.y;
-            }
+            //let height = this.renderer.getHeight();
 
             // Update and apply the animation state, update the skeleton's
-            // world transforms and render the skeleton.
             this.animationState.update(dt / 1000);
             this.animationState.apply(this.skeleton);
+
+            // update the root bone position
+            rootBone.x = this.pos.x;
+            rootBone.y = this.pos.y;
+
+            // world transforms
             this.skeleton.updateWorldTransform();
 
+            // update Bounds
             this.updateBounds();
+
+            // world transforms
+            //this.skeleton.updateWorldTransform();
         }
         return true;
     }
@@ -15313,9 +15658,6 @@ class Spine extends Renderable$1 {
 
     /**
      * draw this spine object
-     * @name draw
-     * @memberof Spine
-     * @protected
      * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
      * @param {Camera2d} [viewport] - the viewport to (re)draw
      */
@@ -15323,23 +15665,60 @@ class Spine extends Renderable$1 {
         this.skeletonRenderer.draw(renderer, this.skeleton);
     }
 
+    /**
+     * Sets the current animation for a track, discarding any queued animations.
+     * @param {number} [track_index] -  If the formerly current track entry was never applied to a skeleton, it is replaced (not mixed from). In either case trackEnd determines when the track is cleared.
+     * @param {number} [index] - the animation index
+     * @param {boolean} [loop= false] - If true, the animation will repeat. If false it will not, instead its last frame is applied if played beyond its duration.
+     * @returns {TrackEntry} A track entry to allow further customization of animation playback. References to the track entry must not be kept after the dispose event occurs.
+     */
     setAnimationByIndex(track_index, index, loop = false) {
         if (index < 0 || index >= this.skeleton.data.animations.length) {
             return (console.log("Animation Index not found"));
         } else {
-            this.animationState.setAnimation(track_index, this.skeleton.data.animations[index].name, loop);
+            return this.setAnimation(track_index, this.skeleton.data.animations[index].name, loop);
         }
     }
 
+    /**
+     * Sets the current animation for a track, discarding any queued animations.
+     * @param {number} [track_index] -  If the formerly current track entry was never applied to a skeleton, it is replaced (not mixed from). In either case trackEnd determines when the track is cleared.
+     * @param {string} [name] - the animation name
+     * @param {boolean} [loop= false] - If true, the animation will repeat. If false it will not, instead its last frame is applied if played beyond its duration.
+     * @returns {TrackEntry} A track entry to allow further customization of animation playback. References to the track entry must not be kept after the dispose event occurs.
+     * @example
+     * // set the current animation
+     * spineAlien.setAnimation(0, "death", true);
+     */
     setAnimation(track_index, name, loop = false) {
-        this.animationState.setAnimation(track_index, name, loop);
+        this.currentTrack = this.animationState.setAnimation(track_index, name, loop);
+        return this.currentTrack;
     }
 
+    /**
+     * return true if the given animation name is the current running animation for the current track.
+     * @name isCurrentAnimation
+     * @param {string} name - animation name
+     * @returns {boolean}
+     * @example
+     * if (!this.isCurrentAnimation("death")) {
+     *     // do something funny...
+     * }
+     */
+    isCurrentAnimation(name) {
+        return typeof this.currentTrack !== "undefined" && this.currentTrack.animation.name === name;
+    }
+
+    /**
+     * Adds an animation to be played after the current or last queued animation for a track, and sets the track entry's mixDuration.
+     * @param {number} [delay=0] - If > 0, sets delay. If <= 0, the delay set is the duration of the previous track entry minus any mix duration plus the specified `delay` (ie the mix ends at (`delay` = 0) or before (`delay` < 0) the previous track entry duration). If the previous entry is looping, its next loop completion is used instead of its duration.
+     * @return {TrackEntry} A track entry to allow further customization of animation playback. References to the track entry must not be kept after the dispose} event occurs.
+     */
     addAnimationByIndex(track_index, index, loop = false, delay = 0) {
         if (index < 0 || index >= this.skeleton.data.animations.length) {
             return (console.log("Animation Index not found"));
         } else {
-            this.animationState.addAnimation(track_index, this.skeleton.data.animations[index].name, loop, delay);
+            return this.addAnimation(track_index, this.skeleton.data.animations[index].name, loop, delay);
         }
     }
 
@@ -15363,21 +15742,57 @@ class Spine extends Renderable$1 {
         };
     }
 
+    /**
+     * Set the default mix duration to use when no mix duration has been defined between two animations.
+     * @param {number} mixTime
+     */
     setDefaultMixTime(mixTime) {
-        this.animationState.data.defaultMix = mixTime;
+        this.animationState.data.defaultMix = this.mixTime = mixTime;
     }
 
+    /**
+     * Sets a mix duration by animation name.
+     */
     setTransitionMixTime(firstAnimation, secondAnimation, mixTime) {
         this.animationState.setMix(firstAnimation, secondAnimation, mixTime);
     }
 
+    /**
+     * Sets a skin by name.
+     * @param {string} skinName
+     * @example
+     * // create a new Spine Renderable
+     * let spineAlien = new Spine(100, 100, {atlasFile: "mix-and-match-pma.atlas", jsonFile: "mix-and-match-pro.json"});
+     *
+     * // set default animation
+     * spineAlien.setAnimation(0, "dance", true);
+     *
+     * // set default skin
+     * spineAlien.setSkinByName("full-skins/girl");
+     *
+     * // add it to the game world
+     * me.game.world.addChild(spineAlien);
+     */
     setSkinByName(skinName) {
         this.skeleton.setSkinByName(skinName);
     }
 
+    /**
+     * Reset this slot to the setup pose.
+     */
     setToSetupPose() {
         this.skeleton.setToSetupPose();
+        // Spine uses Y-up, melonJS uses Y-down
+        this.skeleton.getRootBone().scaleY *= -1;
+        this.skeleton.updateWorldTransform();
+        // reset flip flags
+        this.isSpineFlipped.y = false;
+        this.isSpineFlipped.x = false;
+        // reset reference to current track entry
+        this.currentTrack = undefined;
+        // mark the object as dirty
+        this.isDirty = true;
     }
 }
 
-export { assetManager, Spine as default };
+export { SpinePlugin, Spine as default };