melonjs 14.4.0 → 15.0.0

package/dist/types/video/webgl/buffer/vertex.d.ts

@@ -5,9 +5,9 @@
  * @ignore
  */
 export default class VertexArrayBuffer {
-    constructor(vertex_size: any, vertex_per_quad: any);
+    constructor(vertex_size: any, vertex_per_obj: any);
     vertexSize: any;
-    quadSize: any;
+    objSize: any;
     maxVertex: number;
     vertexCount: number;
     buffer: ArrayBuffer;
@@ -27,7 +27,7 @@ export default class VertexArrayBuffer {
      * resize the vertex buffer, retaining its original contents
      * @ignore
      */
-    resize(): VertexArrayBuffer;
+    resize(vertexCount: any): VertexArrayBuffer;
     /**
      * push a new vertex to the buffer
      * @ignore

package/dist/types/video/webgl/compositors/compositor.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @classdesc
+ * A base Compositor object.
+ */
+export default class Compositor {
+    /**
+     * @param {WebGLRenderer} renderer - the current WebGL renderer session
+     * @param {Object} settings - additional settings to initialize this compositors
+     * @param {object[]} attribute - an array of attributes definition
+     * @param {string} attribute.name - name of the attribute in the vertex shader
+     * @param {number} attribute.size - number of components per vertex attribute. Must be 1, 2, 3, or 4.
+     * @param {GLenum} attribute.type - data type of each component in the array
+     * @param {boolean} attribute.normalized - whether integer data values should be normalized into a certain range when being cast to a float
+     * @param {number} attribute.offset - offset in bytes of the first component in the vertex attribute array
+     * @param {object} shader - an array of attributes definition
+     * @param {string} shader.vertex - a string containing the GLSL source code to set
+     * @param {string} shader.fragment - a string containing the GLSL source code to set
+     */
+    constructor(renderer: WebGLRenderer, settings: Object);
+    /**
+     * Initialize the compositor
+     * @ignore
+     */
+    init(renderer: any, settings: any): void;
+    renderer: any;
+    gl: any;
+    color: any;
+    viewMatrix: any;
+    /**
+     * the default shader created by this compositor
+     * @type {GLShader}
+     */
+    defaultShader: GLShader | undefined;
+    /**
+     * the shader currently used by this compositor
+     * @type {GLShader}
+     */
+    currentShader: GLShader | undefined;
+    /**
+     * primitive type to render (gl.POINTS, gl.LINE_STRIP, gl.LINE_LOOP, gl.LINES, gl.TRIANGLE_STRIP, gl.TRIANGLE_FAN, gl.TRIANGLES)
+     * @type {number}
+     * @default gl.TRIANGLES
+     */
+    mode: number | undefined;
+    /**
+     * an array of vertex attribute properties
+     * @see WebGLCompositor.addAttribute
+     * @type {Array}
+     */
+    attributes: any[] | undefined;
+    /**
+     * the size of a single vertex in bytes
+     * (will automatically be calculated as attributes definitions are added)
+     * @see WebGLCompositor.addAttribute
+     * @type {number}
+     */
+    vertexByteSize: number | undefined;
+    /**
+     * the size of a single vertex in floats
+     * (will automatically be calculated as attributes definitions are added)
+     * @see WebGLCompositor.addAttribute
+     * @type {number}
+     */
+    vertexSize: number | undefined;
+    /**
+     * the vertex data buffer used by this compositor
+     * @type {VertexArrayBuffer}
+     */
+    vertexData: VertexArrayBuffer | undefined;
+    /**
+     * Reset compositor internal state
+     * @ignore
+     */
+    reset(): void;
+    /**
+     * @ignore
+     * called by the WebGL renderer when a compositor become the current one
+     */
+    bind(): void;
+    /**
+     * Select the shader to use for compositing
+     * @see GLShader
+     * @param {GLShader} shader - a reference to a GLShader instance
+     */
+    useShader(shader: GLShader): void;
+    /**
+     * add vertex attribute property definition to the compositor
+     * @param {string} name - name of the attribute in the vertex shader
+     * @param {number} size - number of components per vertex attribute. Must be 1, 2, 3, or 4.
+     * @param {GLenum} type - data type of each component in the array
+     * @param {boolean} normalized - whether integer data values should be normalized into a certain range when being cast to a float
+     * @param {number} offset - offset in bytes of the first component in the vertex attribute array
+     */
+    addAttribute(name: string, size: number, type: GLenum, normalized: boolean, offset: number): void;
+    /**
+     * set/change the current projection matrix
+     * @param {Matrix3d} matrix
+     */
+    setProjection(matrix: Matrix3d): void;
+    /**
+     * Flush batched vertex data to the GPU
+     * @param {number} [mode=gl.TRIANGLES] - the GL drawing mode
+     */
+    flush(mode?: number | undefined): void;
+}
+import GLShader from "../glshader.js";
+import VertexArrayBuffer from "../buffer/vertex.js";

package/dist/types/video/webgl/compositors/primitive_compositor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @classdesc
+ * A WebGL Compositor object. This class handles all of the WebGL state<br>
+ * Pushes texture regions or shape geometry into WebGL buffers, automatically flushes to GPU
+ * @augments Compositor
+ */
+export default class PrimitiveCompositor extends Compositor {
+    /**
+     * Initialize the compositor
+     * @ignore
+     */
+    init(renderer: any): void;
+    /**
+     * Draw an array of vertices
+     * @param {GLenum} mode - primitive type to render (gl.POINTS, gl.LINE_STRIP, gl.LINE_LOOP, gl.LINES, gl.TRIANGLE_STRIP, gl.TRIANGLE_FAN, gl.TRIANGLES)
+     * @param {Point[]} verts - an array of vertices
+     * @param {number} [vertexCount=verts.length] - amount of points defined in the points array
+     */
+    drawVertices(mode: GLenum, verts: Point[], vertexCount?: number | undefined): void;
+    mode: any;
+}
+import Compositor from "./compositor.js";

package/dist/types/video/webgl/compositors/quad_compositor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @classdesc
+ * A WebGL Compositor object. This class handles all of the WebGL state<br>
+ * Pushes texture regions or shape geometry into WebGL buffers, automatically flushes to GPU
+ * @augments Compositor
+ */
+export default class QuadCompositor extends Compositor {
+    /**
+     * Initialize the compositor
+     * @ignore
+     */
+    init(renderer: any): void;
+    currentTextureUnit: any;
+    boundTextures: any[] | undefined;
+    /**
+     * Create a WebGL texture from an image
+     * @param {number} unit - Destination texture unit
+     * @param {Image|HTMLCanvasElement|ImageData|Uint8Array[]|Float32Array[]} [pixels=null] - Source image
+     * @param {number} filter - gl.LINEAR or gl.NEAREST
+     * @param {string} [repeat="no-repeat"] - Image repeat behavior (see {@link ImageLayer#repeat})
+     * @param {number} [w=pixels.width] - Source image width (Only use with UInt8Array[] or Float32Array[] source image)
+     * @param {number} [h=pixels.height] - Source image height (Only use with UInt8Array[] or Float32Array[] source image)
+     * @param {boolean} [premultipliedAlpha=true] - Multiplies the alpha channel into the other color channels
+     * @param {boolean} [mipmap=true] - Whether mipmap levels should be generated for this texture
+     * @returns {WebGLTexture} a WebGL texture
+     */
+    createTexture2D(unit: number, pixels?: HTMLCanvasElement | ImageData | (new (width?: number | undefined, height?: number | undefined) => HTMLImageElement) | Uint8Array[] | Float32Array[] | undefined, filter: number, repeat?: string | undefined, w?: number | undefined, h?: number | undefined, premultipliedAlpha?: boolean | undefined, mipmap?: boolean | undefined): WebGLTexture;
+    /**
+     * delete the given WebGL texture
+     * @param {WebGLTexture} [texture] - a WebGL texture to delete
+     * @param {number} [unit] - Texture unit to delete
+     */
+    deleteTexture2D(texture?: WebGLTexture | undefined): void;
+    /**
+     * returns the WebGL texture associated to the given texture unit
+     * @param {number} unit - Texture unit to which a texture is bound
+     * @returns {WebGLTexture} texture a WebGL texture
+     */
+    getTexture2D(unit: number): WebGLTexture;
+    /**
+     * assign the given WebGL texture to the current batch
+     * @param {WebGLTexture} texture - a WebGL texture
+     * @param {number} unit - Texture unit to which the given texture is bound
+     */
+    bindTexture2D(texture: WebGLTexture, unit: number): void;
+    /**
+     * unbind the given WebGL texture, forcing it to be reuploaded
+     * @param {WebGLTexture} [texture] - a WebGL texture
+     * @param {number} [unit] - a WebGL texture
+     * @returns {number} unit the unit number that was associated with the given texture
+     */
+    unbindTexture2D(texture?: WebGLTexture | undefined, unit?: number | undefined): number;
+    /**
+     * @ignore
+     */
+    uploadTexture(texture: any, w: any, h: any, force?: boolean): any;
+    /**
+     * Add a textured quad
+     * @param {TextureAtlas} texture - Source texture atlas
+     * @param {number} x - Destination x-coordinate
+     * @param {number} y - Destination y-coordinate
+     * @param {number} w - Destination width
+     * @param {number} h - Destination height
+     * @param {number} u0 - Texture UV (u0) value.
+     * @param {number} v0 - Texture UV (v0) value.
+     * @param {number} u1 - Texture UV (u1) value.
+     * @param {number} v1 - Texture UV (v1) value.
+     * @param {number} tint - tint color to be applied to the texture in UINT32 (argb) format
+     */
+    addQuad(texture: TextureAtlas, x: number, y: number, w: number, h: number, u0: number, v0: number, u1: number, v1: number, tint: number): void;
+}
+import Compositor from "./compositor.js";

package/dist/types/video/webgl/compositors/webgl_compositor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @classdesc
+ * A WebGL Compositor object. This class handles all of the WebGL state<br>
+ * Pushes texture regions or shape geometry into WebGL buffers, automatically flushes to GPU
+ * @augments Compositor
+ */
+export default class WebGLCompositor extends Compositor {
+    currentTextureUnit: any;
+    boundTextures: any[] | undefined;
+    primitiveShader: GLShader | undefined;
+    quadShader: GLShader | undefined;
+    vertexBuffer: VertexArrayBuffer | undefined;
+    /**
+     * Create a WebGL texture from an image
+     * @param {number} unit - Destination texture unit
+     * @param {Image|HTMLCanvasElement|ImageData|Uint8Array[]|Float32Array[]} image - Source image
+     * @param {number} filter - gl.LINEAR or gl.NEAREST
+     * @param {string} [repeat="no-repeat"] - Image repeat behavior (see {@link ImageLayer#repeat})
+     * @param {number} [w] - Source image width (Only use with UInt8Array[] or Float32Array[] source image)
+     * @param {number} [h] - Source image height (Only use with UInt8Array[] or Float32Array[] source image)
+     * @param {number} [b] - Source image border (Only use with UInt8Array[] or Float32Array[] source image)
+     * @param {boolean} [premultipliedAlpha=true] - Multiplies the alpha channel into the other color channels
+     * @param {boolean} [mipmap=true] - Whether mipmap levels should be generated for this texture
+     * @returns {WebGLTexture} a WebGL texture
+     */
+    createTexture2D(unit: number, image: (new (width?: number | undefined, height?: number | undefined) => HTMLImageElement) | HTMLCanvasElement | ImageData | Uint8Array[] | Float32Array[], filter: number, repeat?: string | undefined, w?: number | undefined, h?: number | undefined, b?: number | undefined, premultipliedAlpha?: boolean | undefined, mipmap?: boolean | undefined): WebGLTexture;
+    /**
+     * delete the given WebGL texture
+     * @param {WebGLTexture} [texture] - a WebGL texture to delete
+     * @param {number} [unit] - Texture unit to delete
+     */
+    deleteTexture2D(texture?: WebGLTexture | undefined): void;
+    /**
+     * returns the WebGL texture associated to the given texture unit
+     * @param {number} unit - Texture unit to which a texture is bound
+     * @returns {WebGLTexture} texture a WebGL texture
+     */
+    getTexture2D(unit: number): WebGLTexture;
+    /**
+     * assign the given WebGL texture to the current batch
+     * @param {WebGLTexture} texture - a WebGL texture
+     * @param {number} unit - Texture unit to which the given texture is bound
+     */
+    bindTexture2D(texture: WebGLTexture, unit: number): void;
+    /**
+     * unbind the given WebGL texture, forcing it to be reuploaded
+     * @param {WebGLTexture} [texture] - a WebGL texture
+     * @param {number} [unit] - a WebGL texture
+     * @returns {number} unit the unit number that was associated with the given texture
+     */
+    unbindTexture2D(texture?: WebGLTexture | undefined, unit?: number | undefined): number;
+    /**
+     * @ignore
+     */
+    uploadTexture(texture: any, w: any, h: any, b: any, force?: boolean): any;
+    /**
+     * Select the shader to use for compositing
+     * @see GLShader
+     * @param {GLShader} shader - a reference to a GLShader instance
+     */
+    useShader(shader: GLShader): void;
+    /**
+     * Add a textured quad
+     * @param {TextureAtlas} texture - Source texture atlas
+     * @param {number} x - Destination x-coordinate
+     * @param {number} y - Destination y-coordinate
+     * @param {number} w - Destination width
+     * @param {number} h - Destination height
+     * @param {number} u0 - Texture UV (u0) value.
+     * @param {number} v0 - Texture UV (v0) value.
+     * @param {number} u1 - Texture UV (u1) value.
+     * @param {number} v1 - Texture UV (v1) value.
+     * @param {number} tint - tint color to be applied to the texture in UINT32 (argb) format
+     */
+    addQuad(texture: TextureAtlas, x: number, y: number, w: number, h: number, u0: number, v0: number, u1: number, v1: number, tint: number): void;
+    /**
+     * Draw an array of vertices
+     * @param {GLenum} mode - primitive type to render (gl.POINTS, gl.LINE_STRIP, gl.LINE_LOOP, gl.LINES, gl.TRIANGLE_STRIP, gl.TRIANGLE_FAN, gl.TRIANGLES)
+     * @param {Point[]} verts - an array of vertices
+     * @param {number} [vertexCount=verts.length] - amount of points defined in the points array
+     */
+    drawVertices(mode: GLenum, verts: Point[], vertexCount?: number | undefined): void;
+}
+import Compositor from "./compositor.js";
+import GLShader from "../glshader.js";
+import VertexArrayBuffer from "../buffer/vertex.js";

package/dist/types/video/webgl/webgl_compositor.d.ts

@@ -151,10 +151,10 @@ export default class WebGLCompositor {
     /**
      * Draw an array of vertices
      * @param {GLenum} mode - primitive type to render (gl.POINTS, gl.LINE_STRIP, gl.LINE_LOOP, gl.LINES, gl.TRIANGLE_STRIP, gl.TRIANGLE_FAN, gl.TRIANGLES)
-     * @param {Vector2d[]} verts - vertices
+     * @param {Point[]} verts - an array of vertices
      * @param {number} [vertexCount=verts.length] - amount of points defined in the points array
      */
-    drawVertices(mode: GLenum, verts: Vector2d[], vertexCount?: number | undefined): void;
+    drawVertices(mode: GLenum, verts: Point[], vertexCount?: number | undefined): void;
     /**
      * Clear the frame buffer
      * @param {number} [alpha = 0.0] - the alpha value used when clearing the framebuffer
@@ -171,4 +171,3 @@ export default class WebGLCompositor {
 }
 import GLShader from "./glshader.js";
 import VertexArrayBuffer from "./buffer/vertex.js";
-import Vector2d from "./../../math/vector2.js";

package/dist/types/video/webgl/webgl_renderer.d.ts

@@ -18,7 +18,7 @@ export default class WebGLRenderer extends Renderer {
      * @param {string} [options.powerPreference="default"] - a hint to the user agent indicating what configuration of GPU is suitable for the WebGL context ("default", "high-performance", "low-power"). To be noted that Safari and Chrome (since version 80) both default to "low-power" to save battery life and improve the user experience on these dual-GPU machines.
      * @param {number} [options.zoomX=width] - The actual width of the canvas with scaling applied
      * @param {number} [options.zoomY=height] - The actual height of the canvas with scaling applied
-     * @param {WebGLCompositor} [options.compositor] - A class that implements the compositor API
+     * @param {Compositor} [options.compositor] - A class that implements the compositor API for sprite rendering
      */
     constructor(options: {
         width: number;
@@ -33,7 +33,7 @@ export default class WebGLRenderer extends Renderer {
         powerPreference?: string | undefined;
         zoomX?: number | undefined;
         zoomY?: number | undefined;
-        compositor?: WebGLCompositor | undefined;
+        compositor?: any;
     });
     /**
      * The WebGL version used by this renderer (1 or 2)
@@ -45,14 +45,14 @@ export default class WebGLRenderer extends Renderer {
     /**
      * The vendor string of the underlying graphics driver.
      * @type {string}
-     * @default null
+     * @default undefined
      * @readonly
      */
     readonly GPUVendor: string;
     /**
      * The renderer string of the underlying graphics driver.
      * @type {string}
-     * @default null
+     * @default undefined
      * @readonly
      */
     readonly GPURenderer: string;
@@ -63,6 +63,11 @@ export default class WebGLRenderer extends Renderer {
      */
     context: WebGLRenderingContext;
     gl: WebGLRenderingContext;
+    /**
+     * the vertex buffer used by this WebGL Renderer
+     * @type {WebGLBuffer}
+     */
+    vertexBuffer: WebGLBuffer;
     /**
      * Maximum number of texture unit supported under the current context
      * @type {number}
@@ -95,33 +100,36 @@ export default class WebGLRenderer extends Renderer {
      * @type {WebGLCompositor}
      */
     currentCompositor: WebGLCompositor;
+    /**
+     * a reference to the current shader program used by the renderer
+     * @type {WebGLProgram}
+     */
+    currentProgram: WebGLProgram;
     /**
      * The list of active compositors
      * @type {Map<WebGLCompositor>}
      */
     compositors: Map<WebGLCompositor, any>;
+    customShader: any;
     cache: TextureCache;
+    /**
+     * add a new compositor to this renderer
+     * @param {Compositor} compositor - a compositor instance
+     * @param {String} name - a name uniquely identifying this compositor
+     * @param {Boolean} [activate=false] - true if the given compositor should be set as the active one
+     */
+    addCompositor(compositor: Compositor, name?: string, activate?: boolean | undefined): void;
     /**
      * set the active compositor for this renderer
-     * @param {WebGLCompositor|string} compositor - a compositor name or instance
+     * @param {String} name - a compositor name
+     * @param {GLShader} [shader] - an optional shader program to be used, instead of the default one, when activating the compositor
+     * @return {Compositor} an instance to the current active compositor
      */
-    setCompositor(compositor?: WebGLCompositor | string): void;
+    setCompositor(name?: string, shader?: any): Compositor;
     /**
      * Reset the gl transform to identity
      */
     resetTransform(): void;
-    /**
-     * @ignore
-     */
-    createFontTexture(cache: any): void;
-    /**
-     * @ignore
-     */
-    fontContext2D: CanvasRenderingContext2D | undefined;
-    /**
-     * @ignore
-     */
-    fontTexture: TextureAtlas | undefined;
     /**
      * Create a pattern with the specified repetition
      * @param {Image} image - Source image
@@ -140,6 +148,14 @@ export default class WebGLRenderer extends Renderer {
      * @param {Matrix3d} matrix
      */
     setProjection(matrix: Matrix3d): void;
+    /**
+     * Sets the WebGL viewport, which specifies the affine transformation of x and y from normalized device coordinates to window coordinates
+     * @param {number} [x = 0] - x the horizontal coordinate for the lower left corner of the viewport origin
+     * @param {number} [y = 0] - y the vertical coordinate for the lower left corner of the viewport origin
+     * @param {number} [w = width of the canvas] - the width of viewport
+     * @param {number} [h = height of the canvas] - the height of viewport
+     */
+    setViewport(x?: number | undefined, y?: number | undefined, w?: number | undefined, h?: number | undefined): void;
     /**
      * Clears the gl context with the given color.
      * @param {Color|string} [color="#000000"] - CSS color.
@@ -154,10 +170,6 @@ export default class WebGLRenderer extends Renderer {
      * @param {number} height - The rectangle's height.
      */
     clearRect(x: number, y: number, width: number, height: number): void;
-    /**
-     * @ignore
-     */
-    drawFont(bounds: any): void;
     /**
      * Draw an image to the gl context
      * @param {Image} image - An element to draw into the context. The specification permits any canvas image source (CanvasImageSource), specifically, a CSSImageValue, an HTMLImageElement, an SVGImageElement, an HTMLVideoElement, an HTMLCanvasElement, an ImageBitmap, or an OffscreenCanvas.
@@ -218,11 +230,6 @@ export default class WebGLRenderer extends Renderer {
      */
     setBlendMode(mode?: string | undefined, gl?: WebGLRenderingContext | undefined): void;
     currentBlendMode: any;
-    /**
-     * return a reference to the font 2d Context
-     * @ignore
-     */
-    getFontContext(): CanvasRenderingContext2D | undefined;
     /**
      * restores the canvas context
      */
@@ -423,7 +430,6 @@ export default class WebGLRenderer extends Renderer {
 }
 import Renderer from "./../renderer.js";
 import Matrix2d from "./../../math/matrix2.js";
-import WebGLCompositor from "./webgl_compositor.js";
 import TextureCache from "./../texture/cache.js";
 import { TextureAtlas } from "./../texture/atlas.js";
 import Color from "./../../math/color.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melonjs",
-  "version": "14.4.0",
+  "version": "15.0.0",
   "description": "melonJS Game Engine",
   "homepage": "http://www.melonjs.org/",
   "type": "module",
@@ -53,44 +53,44 @@
   ],
   "dependencies": {
     "@teppeis/multimaps": "^2.0.0",
-    "core-js": "^3.27.1",
+    "core-js": "^3.29.1",
     "earcut": "2.2.4",
     "eventemitter3": "^5.0.0",
     "howler": "2.2.3"
   },
   "devDependencies": {
-    "@babel/eslint-parser": "^7.19.1",
+    "@babel/eslint-parser": "^7.21.3",
     "@babel/plugin-syntax-import-assertions": "^7.20.0",
-    "@fastify/static": "^6.6.0",
+    "@fastify/static": "^6.9.0",
     "@melonjs/webdoc-theme": "^1.1.1",
-    "@rollup/plugin-commonjs": "^24.0.0",
-    "@rollup/plugin-image": "^3.0.1",
+    "@rollup/plugin-commonjs": "^24.0.1",
+    "@rollup/plugin-image": "^3.0.2",
     "@rollup/plugin-node-resolve": "^15.0.1",
     "@rollup/plugin-replace": "^5.0.2",
-    "@types/offscreencanvas": "^2019.7.0",
     "@webdoc/cli": "^2.2.0",
-    "chromedriver": "^108.0.0",
+    "chromedriver": "^111.0.0",
     "cross-env": "^7.0.3",
     "del-cli": "^5.0.0",
-    "eslint": "^8.31.0",
-    "eslint-plugin-jsdoc": "^39.6.4",
-    "expect": "^29.3.1",
-    "expect-mocha-image-snapshot": "^3.0.1",
-    "fastify": "^4.11.0",
+    "eslint": "^8.36.0",
+    "eslint-plugin-jsdoc": "^40.0.3",
+    "expect": "^29.5.0",
+    "expect-mocha-image-snapshot": "^3.0.3",
+    "fastify": "^4.14.1",
     "mocha": "^10.2.0",
     "npm-self-link": "^1.1.7",
-    "puppeteer": "^19.5.0",
-    "rollup": "^3.9.1",
+    "puppeteer": "^19.7.5",
+    "rollup": "^3.19.1",
     "rollup-plugin-bundle-size": "^1.0.3",
     "rollup-plugin-string": "^3.0.0",
-    "terser": "^5.16.1",
-    "typescript": "^4.9.4"
+    "terser": "^5.16.6",
+    "typescript": "^5.0.2"
   },
   "scripts": {
     "build": "npm run lint && rollup -c --silent",
+    "build:cd": "npm run lint && rollup -c --failAfterWarnings",
     "dist": " npm run build && mkdirp dist && cp -fR build/*.* dist/ && npm run types",
     "lint": "eslint src/** rollup.config.mjs",
-    "pretest": "cp -f ./build/melonjs.module.js ./tests/browser/public/lib",
+    "pretest": "mkdirp tests/browser/public/lib && cp -f build/melonjs.module.js tests/browser/public/lib",
     "test": "npm run test-node && mocha ./tests/browser/spec/*.js --reporter spec --bail --timeout 10000",
     "test-node": "node build/melonjs.module.js",
     "doc-prod": "mkdirp docs && webdoc --quiet --site-root melonJS/docs -R README.md",

package/src/audio/audio.js

@@ -1,7 +1,7 @@
 // external import
 import {Howl, Howler} from "howler";
 import {clamp} from "./../math/math.js";
-import loader from "./../loader/loader.js";
+import { nocache, withCredentials} from "./../loader/settings.js";
 import { isDataUrl } from "./../utils/string.js";
 
 /**
@@ -154,7 +154,7 @@ export function load(sound, html5, onload_cb, onerror_cb) {
         urls.push(sound.src);
     } else {
         for (var i = 0; i < audioExts.length; i++) {
-            urls.push(sound.src + sound.name + "." + audioExts[i] + loader.nocache);
+            urls.push(sound.src + sound.name + "." + audioExts[i] + nocache);
         }
     }
 
@@ -162,7 +162,7 @@ export function load(sound, html5, onload_cb, onerror_cb) {
         src : urls,
         volume : Howler.volume(),
         html5 : html5 === true,
-        xhrWithCredentials : loader.withCredentials,
+        xhrWithCredentials : withCredentials,
         /**
          * @ignore
          */
@@ -455,9 +455,7 @@ export function getVolume() {
  * // mute the background music
  * me.audio.mute("awesome_music");
  */
-export function mute(sound_name, id, mute) {
-    // if not defined : true
-    mute = (typeof(mute) === "undefined" ? true : !!mute);
+export function mute(sound_name, id, mute = true) {
     var sound = audioTracks[sound_name];
     if (sound && typeof(sound) !== "undefined") {
         sound.mute(mute, id);

package/src/entity/entity.js

@@ -53,10 +53,10 @@ import Body from "./../physics/body.js";
 
         // Update anchorPoint
         if (settings.anchorPoint) {
-            this.anchorPoint.set(settings.anchorPoint.x, settings.anchorPoint.y);
+            this.anchorPoint.setMuted(settings.anchorPoint.x, settings.anchorPoint.y);
         } else {
             // for backward compatibility
-            this.anchorPoint.set(0, 0);
+            this.anchorPoint.setMuted(0, 0);
         }
 
         // set the sprite name if specified
@@ -140,6 +140,7 @@ import Body from "./../physics/body.js";
         if (value instanceof Renderable) {
             this.children[0] = value;
             this.children[0].ancestor = this;
+            this.updateBounds();
         } else {
             throw new Error(value + "should extend me.Renderable");
         }
@@ -154,17 +155,50 @@ import Body from "./../physics/body.js";
     }
 
     /**
-     * update the bounds position when the body is modified
+     * update the bounding box for this entity.
+     * @param {boolean} [absolute=true] - update the bounds size and position in (world) absolute coordinates
+     * @returns {Bounds} this entity bounding box Rectangle object
+     */
+    updateBounds(absolute = true) {
+        var bounds = this.getBounds();
+
+        bounds.clear();
+        bounds.addFrame(
+            0,
+            0,
+            this.width,
+            this.height
+        );
+
+        // add each renderable bounds
+        if (this.children && this.children.length > 0) {
+            bounds.addBounds(this.children[0].getBounds());
+        }
+
+        if (this.body) {
+            bounds.addBounds(this.body.getBounds());
+        }
+
+        if (absolute === true) {
+            bounds.centerOn(this.pos.x + bounds.x + bounds.width / 2,  this.pos.y + bounds.y + bounds.height / 2);
+             if (typeof this.ancestor !== "undefined" && typeof this.ancestor.addChild === "function" && this.floating !== true) {
+                 bounds.translate(this.ancestor.getAbsolutePosition());
+             }
+
+        }
+
+        return bounds;
+    }
+
+    /**
+     * update the bounds when the body is modified
      * @ignore
      * @name onBodyUpdate
      * @memberof Entity
      * @param {Body} body - the body whose bounds to update
      */
-    onBodyUpdate(body) {
-        // update the entity bounds to include the body bounds
-        this.getBounds().addBounds(body.getBounds(), true);
-        // update the bounds pos
-        this.updateBoundsPos(this.pos.x, this.pos.y);
+    onBodyUpdate() {
+        this.updateBounds();
     }
 
     preDraw(renderer) {

package/src/geometries/ellipse.js

@@ -126,8 +126,7 @@ import pool from "./../system/pooling.js";
      * @param {number} [y=x]
      * @returns {Ellipse} Reference to this object for method chaining
      */
-    scale(x, y) {
-        y = typeof (y) !== "undefined" ? y : x;
+    scale(x, y = x) {
         return this.setShape(
             this.pos.x,
             this.pos.y,