melonjs 14.5.0 → 15.0.0

package/dist/types/entity/entity.d.ts

@@ -33,7 +33,7 @@ export default class Entity extends Renderable {
         frameheight?: number | undefined;
         type?: string | undefined;
         collisionMask?: number | undefined;
-        shapes?: Line[] | Polygon[] | Ellipse[] | Rect[] | undefined;
+        shapes?: Polygon[] | Line[] | Ellipse[] | Rect[] | undefined;
     });
     /**
      * The array of renderable children of this entity.

package/dist/types/index.d.ts

@@ -64,7 +64,9 @@ import RoundRect from "./geometries/roundrect.js";
 import Tween from "./tweens/tween.js";
 import QuadTree from "./physics/quadtree.js";
 import GLShader from "./video/webgl/glshader.js";
-import WebGLCompositor from "./video/webgl/compositors/webgl_compositor.js";
+import Compositor from "./video/webgl/compositors/compositor.js";
+import PrimitiveCompositor from "./video/webgl/compositors/primitive_compositor.js";
+import QuadCompositor from "./video/webgl/compositors/quad_compositor.js";
 import Renderer from "./video/renderer.js";
 import WebGLRenderer from "./video/webgl/webgl_renderer.js";
 import CanvasRenderer from "./video/canvas/canvas_renderer.js";
@@ -107,4 +109,4 @@ import ParticleEmitterSettings from "./particles/settings.js";
 import Particle from "./particles/particle.js";
 import Entity from "./entity/entity.js";
 import Application from "./application/application.js";
-export { audio, collision, device, event, loader, level, input, Math, plugin, plugins, utils, save, timer, pool, state, video, Color, Vector2d, Vector3d, ObservableVector2d, ObservableVector3d, Matrix2d, Matrix3d, Polygon, Line, Ellipse, Point, Rect, RoundRect, Tween, QuadTree, GLShader, WebGLCompositor, Renderer, WebGLRenderer, CanvasRenderer, TextureAtlas, Renderable, Body, Bounds, Text, BitmapText, BitmapTextData, ColorLayer, ImageLayer, Sprite, NineSliceSprite, UIBaseElement, UITextButton, UISpriteElement, Collectable, Trigger, Light2d, Draggable, DropTarget, TMXRenderer, TMXOrthogonalRenderer, TMXIsometricRenderer, TMXHexagonalRenderer, TMXStaggeredRenderer, Tile, TMXTileset, TMXTilesetGroup, TMXTileMap, TMXLayer, Pointer, Stage, Camera2d, Container, World, ParticleEmitter, ParticleEmitterSettings, Particle, Entity, Application };
+export { audio, collision, device, event, loader, level, input, Math, plugin, plugins, utils, save, timer, pool, state, video, Color, Vector2d, Vector3d, ObservableVector2d, ObservableVector3d, Matrix2d, Matrix3d, Polygon, Line, Ellipse, Point, Rect, RoundRect, Tween, QuadTree, GLShader, Compositor, PrimitiveCompositor, QuadCompositor, Renderer, WebGLRenderer, CanvasRenderer, TextureAtlas, Renderable, Body, Bounds, Text, BitmapText, BitmapTextData, ColorLayer, ImageLayer, Sprite, NineSliceSprite, UIBaseElement, UITextButton, UISpriteElement, Collectable, Trigger, Light2d, Draggable, DropTarget, TMXRenderer, TMXOrthogonalRenderer, TMXIsometricRenderer, TMXHexagonalRenderer, TMXStaggeredRenderer, Tile, TMXTileset, TMXTilesetGroup, TMXTileMap, TMXLayer, Pointer, Stage, Camera2d, Container, World, ParticleEmitter, ParticleEmitterSettings, Particle, Entity, Application };

package/dist/types/renderable/renderable.d.ts

@@ -162,6 +162,12 @@ export default class Renderable extends Rect {
      * ]);
      */
     mask: Rect | RoundRect | Polygon | Line | Ellipse;
+    /**
+      * (Experimental) an optional shader, to be used instead of the default built-in one, when drawing this renderable (WebGL only)
+      * @type {GLShader}
+      * @default undefined
+    */
+    shader: GLShader;
     /**
      * the blend mode to be applied to this renderable (see renderer setBlendMode for available blend mode)
      * @type {string}

package/dist/types/renderable/ui/uitextbutton.d.ts

@@ -18,7 +18,6 @@ export default class UITextButton extends UIBaseElement {
      * @param {string} [settings.backgroundColor] - The css value of a background color
      * @param {string} [settings.hoverColor] - The css value of a color to be used if the pointer hovers over the button
      * @param {string} [settings.borderStrokeColor] - The css value of a color to be used to draw the border
-     * @param {boolean} [settings.offScreenCanvas] - Weather to use an offScreen canvas or not
      * @param {string} [settings.fillStyle] - The css value of a tint color to be used to tint the text
      * @param {number} [settings.borderWidth] - Width of the button
      * @param {number} [settings.borderHeight] - Height of the button

package/dist/types/text/text.d.ts

@@ -12,12 +12,11 @@ export default class Text extends Renderable {
      * @param {number|string} settings.size - size, or size + suffix (px, em, pt)
      * @param {Color|string} [settings.fillStyle="#000000"] - a CSS color value
      * @param {Color|string} [settings.strokeStyle="#000000"] - a CSS color value
-     * @param {number} [settings.lineWidth=1] - line width, in pixels, when drawing stroke
+     * @param {number} [settings.lineWidth=0] - line width, in pixels, when drawing stroke
      * @param {string} [settings.textAlign="left"] - horizontal text alignment
      * @param {string} [settings.textBaseline="top"] - the text baseline
      * @param {number} [settings.lineHeight=1.0] - line spacing height
      * @param {Vector2d} [settings.anchorPoint={x:0.0, y:0.0}] - anchor point to draw the text at
-     * @param {boolean} [settings.offScreenCanvas=false] - whether to draw the font to an individual "cache" texture first
      * @param {number} [settings.wordWrapWidth] - the maximum length in CSS pixel for a single segment of text
      * @param {(string|string[])} [settings.text=""] - a string, or an array of strings
      * @example
@@ -33,7 +32,6 @@ export default class Text extends Renderable {
         textBaseline?: string | undefined;
         lineHeight?: number | undefined;
         anchorPoint?: any;
-        offScreenCanvas?: boolean | undefined;
         wordWrapWidth?: number | undefined;
         text?: string | string[] | undefined;
     });
@@ -45,7 +43,7 @@ export default class Text extends Renderable {
      * sets the current line width, in pixels, when drawing stroke
      * @public
      * @type {number}
-     * @default 1
+     * @default 0
      */
     public lineWidth: number | undefined;
     /**
@@ -72,15 +70,6 @@ export default class Text extends Renderable {
      * @default 1.0
      */
     public lineHeight: number | undefined;
-    /**
-     * whether to draw the font to a indidividual offscreen canvas texture first <br>
-     * Note: this will improve performances when using WebGL, but will impact
-     * memory consumption as every text element will have its own canvas texture
-     * @public
-     * @type {boolean}
-     * @default false
-     */
-    public offScreenCanvas: boolean | undefined;
     /**
      * the maximum length in CSS pixel for a single segment of text.
      * (use -1 to disable word wrapping)
@@ -144,13 +133,11 @@ export default class Text extends Renderable {
      * @param {string} [text]
      * @param {number} [x]
      * @param {number} [y]
-     * @param {boolean} [stroke=false] - draw stroke the the text if true
      */
-    draw(renderer: CanvasRenderer | WebGLRenderer, text?: string | undefined, x?: number | undefined, y?: number | undefined, stroke?: boolean | undefined): void;
+    draw(renderer: CanvasRenderer | WebGLRenderer, text?: string | undefined, x?: number | undefined, y?: number | undefined): void;
     /**
-     * draw a stroke text at the specified coord, as defined <br>
-     * by the `lineWidth` and `fillStroke` properties. <br>
-     * Note : using drawStroke is not recommended for performance reasons
+     * draw a stroke text at the specified coord, as defined by the `lineWidth` and `fillStroke` properties.
+     * @deprecated since 15.0.0
      * @param {CanvasRenderer|WebGLRenderer} renderer - Reference to the destination renderer instance
      * @param {string} text
      * @param {number} x
@@ -160,7 +147,7 @@ export default class Text extends Renderable {
     /**
      * @ignore
      */
-    _drawFont(context: any, text: any, x: any, y: any, stroke?: boolean): TextMetrics | undefined;
+    _drawFont(context: any, text: any, x: any, y: any): TextMetrics | undefined;
     /**
      * Destroy function
      * @ignore
@@ -169,5 +156,4 @@ export default class Text extends Renderable {
 }
 import Renderable from "./../renderable/renderable.js";
 import TextMetrics from "./textmetrics.js";
-import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
 import Color from "./../math/color.js";

package/dist/types/text/textstyle.d.ts

@@ -2,4 +2,4 @@
  * apply the current text style to the given context
  * @ignore
  */
-export default function setContextStyle(context: any, style: any, stroke?: boolean): void;
+export default function setContextStyle(context: any, style: any): void;

package/dist/types/video/canvas/canvas_renderer.d.ts

@@ -263,11 +263,6 @@ export default class CanvasRenderer extends Renderer {
      * @param {number} height
      */
     fillPoint(x: number, y: number): void;
-    /**
-     * return a reference to the font 2d Context
-     * @ignore
-     */
-    getFontContext(): CanvasRenderingContext2D | WebGLRenderingContext;
     /**
      * save the canvas context
      * @name save

package/dist/types/video/renderer.d.ts

@@ -188,7 +188,7 @@ export default class Renderer {
      * @param {Rect|RoundRect|Polygon|Line|Ellipse} [mask] - the shape defining the mask to be applied
      * @param {boolean} [invert=false] - either the given shape should define what is visible (default) or the opposite
      */
-    setMask(mask?: Polygon | Rect | Ellipse | RoundRect | Line | undefined): void;
+    setMask(mask?: Polygon | Line | Ellipse | Rect | RoundRect | undefined): void;
     /**
      * disable (remove) the rendering mask set through setMask.
      * @see Renderer#setMask
@@ -205,10 +205,6 @@ export default class Renderer {
      * @see Renderer#setTint
      */
     clearTint(): void;
-    /**
-     * @ignore
-     */
-    drawFont(): void;
 }
 import Vector2d from "../math/vector2.js";
 import Path2D from "./../geometries/path2d.js";

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

@@ -5,22 +5,37 @@
 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);
+    constructor(renderer: WebGLRenderer, settings: Object);
     /**
      * Initialize the compositor
      * @ignore
      */
-    init(renderer: any): void;
+    init(renderer: any, settings: any): void;
     renderer: any;
     gl: any;
     color: any;
     viewMatrix: any;
     /**
-     * a reference to the active WebGL shader
+     * the default shader created by this compositor
      * @type {GLShader}
      */
-    activeShader: any;
+    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}
@@ -47,11 +62,27 @@ export default class Compositor {
      * @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
@@ -61,41 +92,16 @@ export default class Compositor {
      * @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;
-    /**
-     * Sets the viewport
-     * @param {number} x - x position of viewport
-     * @param {number} y - y position of viewport
-     * @param {number} w - width of viewport
-     * @param {number} h - height of viewport
-     */
-    setViewport(x: number, y: number, w: number, h: number): void;
     /**
      * set/change the current projection matrix
      * @param {Matrix3d} matrix
      */
     setProjection(matrix: Matrix3d): void;
     /**
-     * Select the shader to use for compositing
-     * @see GLShader
-     * @param {GLShader} shader - a reference to a GLShader instance
-     */
-    useShader(shader: GLShader): void;
-    /**
-     * Flush batched texture operations to the GPU
+     * Flush batched vertex data to the GPU
      * @param {number} [mode=gl.TRIANGLES] - the GL drawing mode
      */
     flush(mode?: number | undefined): void;
-    /**
-     * Clear the frame buffer
-     * @param {number} [alpha = 0.0] - the alpha value used when clearing the framebuffer
-     */
-    clear(alpha?: number | undefined): void;
-    /**
-     * Specify the color values used when clearing color buffers. The values are clamped between 0 and 1.
-     * @param {number} [r = 0] - the red color value used when the color buffers are cleared
-     * @param {number} [g = 0] - the green color value used when the color buffers are cleared
-     * @param {number} [b = 0] - the blue color value used when the color buffers are cleared
-     * @param {number} [a = 0] - the alpha color value used when the color buffers are cleared
-     */
-    clearColor(r?: number | undefined, g?: number | undefined, b?: number | undefined, a?: 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/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 "./compositors/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.5.0",
+  "version": "15.0.0",
   "description": "melonJS Game Engine",
   "homepage": "http://www.melonjs.org/",
   "type": "module",
@@ -53,13 +53,13 @@
   ],
   "dependencies": {
     "@teppeis/multimaps": "^2.0.0",
-    "core-js": "^3.27.2",
+    "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.9.0",
     "@melonjs/webdoc-theme": "^1.1.1",
@@ -67,24 +67,23 @@
     "@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": "^110.0.0",
+    "chromedriver": "^111.0.0",
     "cross-env": "^7.0.3",
     "del-cli": "^5.0.0",
-    "eslint": "^8.34.0",
-    "eslint-plugin-jsdoc": "^40.0.0",
-    "expect": "^29.4.2",
-    "expect-mocha-image-snapshot": "^3.0.1",
-    "fastify": "^4.13.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.6.3",
-    "rollup": "^3.15.0",
+    "puppeteer": "^19.7.5",
+    "rollup": "^3.19.1",
     "rollup-plugin-bundle-size": "^1.0.3",
     "rollup-plugin-string": "^3.0.0",
-    "terser": "^5.16.3",
-    "typescript": "^4.9.5"
+    "terser": "^5.16.6",
+    "typescript": "^5.0.2"
   },
   "scripts": {
     "build": "npm run lint && rollup -c --silent",

package/src/audio/audio.js

@@ -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/geometries/path2d.js

@@ -242,9 +242,6 @@ import earcut from "earcut";
             points.push(pool.pull("Point", _x2, _y2));
             angle += direction * dangle;
         }
-        //var x1 = radiusX * Math.cos(endAngle);
-        //var y1 = radiusY * Math.sin(endAngle);
-        //points.push(pool.pull("Point", x + x1 * cos_rotation - y1 * sin_rotation, y + x1 * sin_rotation + y1 * cos_rotation));
     }
 
     /**
@@ -257,8 +254,11 @@ import earcut from "earcut";
     rect(x, y, width, height) {
         this.moveTo(x, y);
         this.lineTo(x + width, y);
+        this.moveTo(x + width, y);
         this.lineTo(x + width, y + height);
+        this.moveTo(x + width, y + height);
         this.lineTo(x, y + height);
+        this.moveTo(x, y + height);
         this.lineTo(x, y);
     }
 

package/src/index.js

@@ -20,7 +20,9 @@ import Body from "./physics/body.js";
 import Bounds from "./physics/bounds.js";
 import Tween from "./tweens/tween.js";
 import GLShader from "./video/webgl/glshader.js";
-import WebGLCompositor from "./video/webgl/compositors/webgl_compositor.js";
+import Compositor from "./video/webgl/compositors/compositor.js";
+import PrimitiveCompositor from "./video/webgl/compositors/primitive_compositor.js";
+import QuadCompositor from "./video/webgl/compositors/quad_compositor.js";
 import Renderer from "./video/renderer.js";
 import WebGLRenderer from "./video/webgl/webgl_renderer.js";
 import CanvasRenderer from "./video/canvas/canvas_renderer.js";
@@ -127,7 +129,9 @@ export {
     Tween,
     QuadTree,
     GLShader,
-    WebGLCompositor,
+    Compositor,
+    PrimitiveCompositor,
+    QuadCompositor,
     Renderer,
     WebGLRenderer,
     CanvasRenderer,