melonjs 10.10.0 → 10.11.0

package/src/tweens/tween.js

@@ -4,7 +4,7 @@ import { world, lastUpdate } from "./../game.js";
 import { Easing } from "./easing.js";
 import { Interpolation } from "./interpolation.js";
 
-/**
+/*
  * Tween.js - Licensed under the MIT license
  * https://github.com/tweenjs/tween.js
  */
@@ -121,7 +121,6 @@ class Tween {
      * @name to
      * @memberof Tween
      * @public
-     * @function
      * @param {object} properties hash of properties
      * @param {object|number} [options] object of tween properties, or a duration if a numeric value is passed
      * @param {number} [options.duration] tween duration
@@ -163,7 +162,6 @@ class Tween {
      * @name start
      * @memberof Tween
      * @public
-     * @function
      * @param {number} [time] the current time when the tween was started
      * @returns {Tween} this instance for object chaining
      */
@@ -210,7 +208,6 @@ class Tween {
      * @name stop
      * @memberof Tween
      * @public
-     * @function
      * @returns {Tween} this instance for object chaining
      */
     stop() {
@@ -224,7 +221,6 @@ class Tween {
      * @name delay
      * @memberof Tween
      * @public
-     * @function
      * @param {number} amount delay amount expressed in milliseconds
      * @returns {Tween} this instance for object chaining
      */
@@ -240,7 +236,6 @@ class Tween {
      * @name repeat
      * @memberof Tween
      * @public
-     * @function
      * @param {number} times amount of times the tween should be repeated
      * @returns {Tween} this instance for object chaining
      */
@@ -257,7 +252,6 @@ class Tween {
      * @name yoyo
      * @memberof Tween
      * @public
-     * @function
      * @see Tween#repeat
      * @param {boolean} yoyo
      * @returns {Tween} this instance for object chaining
@@ -274,7 +268,6 @@ class Tween {
      * @name easing
      * @memberof Tween
      * @public
-     * @function
      * @param {Tween.Easing} easing easing function
      * @returns {Tween} this instance for object chaining
      */
@@ -291,7 +284,6 @@ class Tween {
      * @name interpolation
      * @memberof Tween
      * @public
-     * @function
      * @param {Tween.Interpolation} interpolation interpolation function
      * @returns {Tween} this instance for object chaining
      */
@@ -305,7 +297,6 @@ class Tween {
      * @name chain
      * @memberof Tween
      * @public
-     * @function
      * @param {...Tween} chainedTween Tween(s) to be chained
      * @returns {Tween} this instance for object chaining
      */
@@ -319,7 +310,6 @@ class Tween {
      * @name onStart
      * @memberof Tween
      * @public
-     * @function
      * @param {Function} onStartCallback callback
      * @returns {Tween} this instance for object chaining
      */
@@ -333,7 +323,6 @@ class Tween {
      * @name onUpdate
      * @memberof Tween
      * @public
-     * @function
      * @param {Function} onUpdateCallback callback
      * @returns {Tween} this instance for object chaining
      */
@@ -347,7 +336,6 @@ class Tween {
      * @name onComplete
      * @memberof Tween
      * @public
-     * @function
      * @param {Function} onCompleteCallback callback
      * @returns {Tween} this instance for object chaining
      */

package/src/utils/agent.js

@@ -9,13 +9,12 @@ import { capitalize } from "./string.js";
  * Known agent vendors
  * @ignore
  */
-var vendors = [ "ms", "MS", "moz", "webkit", "o" ];
+const vendors = [ "ms", "MS", "moz", "webkit", "o" ];
 
 /**
  * Get a vendor-prefixed property
  * @public
  * @name prefixed
- * @function
  * @param {string} name Property name
  * @param {object} [obj=globalThis] Object or element reference to access
  * @returns {string} Value of property
@@ -41,7 +40,6 @@ export function prefixed(name, obj) {
  * Set a vendor-prefixed property
  * @public
  * @name setPrefixed
- * @function
  * @param {string} name Property name
  * @param {string} value Property value
  * @param {object} [obj=globalThis] Object or element reference to access

package/src/utils/array.js

@@ -8,7 +8,6 @@ import {random as mathRandom, weightedRandom as mathWeightedRandom} from "./../m
 /**
  * Remove the specified object from the given Array
  * @public
- * @function
  * @memberof utils.array
  * @name remove
  * @param {Array} arr array from which to remove an object
@@ -29,7 +28,6 @@ export function remove(arr, obj) {
 /**
  * return a random array element
  * @public
- * @function
  * @memberof utils.array
  * @name random
  * @param {Array} arr array to pick a element
@@ -46,7 +44,6 @@ export function random(arr) {
 /**
  * return a weighted random array element, favoring the earlier entries
  * @public
- * @function
  * @memberof utils.array
  * @name weightedRandom
  * @param {Array} arr array to pick a element

package/src/utils/file.js

@@ -12,7 +12,6 @@ const REMOVE_EXT = /\.[^\.]*$/;
 /**
  * return the base name of the file without path info
  * @public
- * @function
  * @memberof utils.file
  * @name getBasename
  * @param  {string} path path containing the filename
@@ -25,7 +24,6 @@ export function getBasename(path) {
 /**
  * return the extension of the file in the given path
  * @public
- * @function
  * @memberof utils.file
  * @name getExtension
  * @param  {string} path path containing the filename

package/src/utils/function.js

@@ -6,7 +6,6 @@
 /**
  * Executes a function as soon as the interpreter is idle (stack empty).
  * @public
- * @function
  * @memberof utils.function
  * @name defer
  * @param {Function} func The function to be deferred.
@@ -27,7 +26,6 @@ export function defer(func, thisArg, ...args) {
  * returns a function that, when invoked will only be triggered at most
  * once during a given window of time
  * @public
- * @function
  * @memberof utils.function
  * @name throttle
  * @param {Function} fn the function to be throttled.

package/src/utils/string.js

@@ -6,7 +6,6 @@
 /**
  * converts the first character of the given string to uppercase
  * @public
- * @function
  * @memberof utils.string
  * @name capitalize
  * @param {string} str the string to be capitalized
@@ -19,7 +18,6 @@ export function capitalize(str) {
 /**
  * returns the string stripped of whitespace from the left.
  * @public
- * @function
  * @memberof utils.string
  * @name trimLeft
  * @param {string} str the string to be trimmed
@@ -32,7 +30,6 @@ export function trimLeft(str) {
 /**
  * returns the string stripped of whitespace from the right.
  * @public
- * @function
  * @memberof utils.string
  * @name trimRight
  * @param {string} str the string to be trimmed
@@ -45,7 +42,6 @@ export function trimRight(str) {
 /**
  * returns true if the given string contains a numeric integer or float value
  * @public
- * @function
  * @memberof utils.string
  * @name isNumeric
  * @param {string} str the string to be tested
@@ -61,7 +57,6 @@ export function isNumeric(str) {
 /**
  * returns true if the given string contains a true or false
  * @public
- * @function
  * @memberof utils.string
  * @name isBoolean
  * @param {string} str the string to be tested
@@ -75,7 +70,6 @@ export function isBoolean(str) {
 /**
  * convert a string to the corresponding hexadecimal value
  * @public
- * @function
  * @memberof utils.string
  * @name toHex
  * @param {string} str the string to be converted

package/src/utils/utils.js

@@ -27,7 +27,6 @@ var utils = {
     /**
      * Get image pixels
      * @public
-     * @function
      * @memberof utils
      * @name getPixels
      * @param {HTMLImageElement|HTMLCanvasElement} image Image to read
@@ -50,7 +49,6 @@ var utils = {
     /**
      * Compare two version strings
      * @public
-     * @function
      * @memberof utils
      * @name checkVersion
      * @param {string} first First version string to compare
@@ -83,7 +81,6 @@ var utils = {
     /**
      * parse the fragment (hash) from a URL and returns them into
      * @public
-     * @function
      * @memberof utils
      * @name getUriFragment
      * @param {string} [url=document.location] an optional params string or URL containing fragment (hash) params to be parsed

package/src/video/canvas/canvas_renderer.js

@@ -3,10 +3,10 @@ import Renderer from "./../renderer.js";
 import TextureCache from "./../texture/cache.js";
 import Ellipse from "./../../geometries/ellipse.js";
 import RoundRect from "./../../geometries/roundrect.js";
+import Rect from "./../../geometries/rectangle.js";
 import Bounds from "./../../physics/bounds.js";
 import { createCanvas } from "./../video.js";
-
-
+import * as event from "./../../system/event.js";
 
 /**
  * @classdesc
@@ -74,7 +74,6 @@ class CanvasRenderer extends Renderer {
      * Reset context state
      * @name reset
      * @memberof CanvasRenderer
-     * @function
      */
     reset() {
         super.reset();
@@ -85,7 +84,6 @@ class CanvasRenderer extends Renderer {
      * Reset the canvas transform to identity
      * @name resetTransform
      * @memberof CanvasRenderer
-     * @function
      */
     resetTransform() {
         this.backBufferContext2D.setTransform(1, 0, 0, 1, 0, 0);
@@ -105,7 +103,6 @@ class CanvasRenderer extends Renderer {
      * @name setBlendMode
      * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
      * @memberof CanvasRenderer
-     * @function
      * @param {string} [mode="normal"] blend mode : "normal", "multiply", "lighter, "additive", "screen"
      * @param {CanvasRenderingContext2D} [context]
      */
@@ -143,7 +140,6 @@ class CanvasRenderer extends Renderer {
      * prepare the framebuffer for drawing a new frame
      * @name clear
      * @memberof CanvasRenderer
-     * @function
      */
     clear() {
         if (this.settings.transparent) {
@@ -155,7 +151,6 @@ class CanvasRenderer extends Renderer {
      * render the main framebuffer on screen
      * @name flush
      * @memberof CanvasRenderer
-     * @function
      */
     flush() {
         if (this.settings.doubleBuffering) {
@@ -167,7 +162,6 @@ class CanvasRenderer extends Renderer {
      * Clears the main framebuffer with the given color
      * @name clearColor
      * @memberof CanvasRenderer
-     * @function
      * @param {Color|string} [color="#000000"] CSS color.
      * @param {boolean} [opaque=false] Allow transparency [default] or clear the surface completely [true]
      */
@@ -184,7 +178,6 @@ class CanvasRenderer extends Renderer {
      * Erase the pixels in the given rectangular area by setting them to transparent black (rgba(0,0,0,0)).
      * @name clearRect
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x x axis of the coordinate for the rectangle starting point.
      * @param {number} y y axis of the coordinate for the rectangle starting point.
      * @param {number} width The rectangle's width.
@@ -198,7 +191,6 @@ class CanvasRenderer extends Renderer {
      * Create a pattern with the specified repetition
      * @name createPattern
      * @memberof CanvasRenderer
-     * @function
      * @param {Image} image Source image
      * @param {string} repeat Define how the pattern should be repeated
      * @returns {CanvasPattern}
@@ -217,7 +209,6 @@ class CanvasRenderer extends Renderer {
      * Draw an image onto the main using the canvas api
      * @name drawImage
      * @memberof CanvasRenderer
-     * @function
      * @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.
      * @param {number} sx The X coordinate of the top left corner of the sub-rectangle of the source image to draw into the destination context.
      * @param {number} sy The Y coordinate of the top left corner of the sub-rectangle of the source image to draw into the destination context.
@@ -281,7 +272,6 @@ class CanvasRenderer extends Renderer {
      * Draw a pattern within the given rectangle.
      * @name drawPattern
      * @memberof CanvasRenderer
-     * @function
      * @param {CanvasPattern} pattern Pattern object
      * @param {number} x
      * @param {number} y
@@ -305,7 +295,6 @@ class CanvasRenderer extends Renderer {
      * Stroke an arc at the specified coordinates with given radius, start and end points
      * @name strokeArc
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x arc center point x-axis
      * @param {number} y arc center point y-axis
      * @param {number} radius
@@ -332,7 +321,6 @@ class CanvasRenderer extends Renderer {
      * Fill an arc at the specified coordinates with given radius, start and end points
      * @name fillArc
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x arc center point x-axis
      * @param {number} y arc center point y-axis
      * @param {number} radius
@@ -348,7 +336,6 @@ class CanvasRenderer extends Renderer {
      * Stroke an ellipse at the specified coordinates with given radius
      * @name strokeEllipse
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x ellipse center point x-axis
      * @param {number} y ellipse center point y-axis
      * @param {number} w horizontal radius of the ellipse
@@ -390,7 +377,6 @@ class CanvasRenderer extends Renderer {
      * Fill an ellipse at the specified coordinates with given radius
      * @name fillEllipse
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x ellipse center point x-axis
      * @param {number} y ellipse center point y-axis
      * @param {number} w horizontal radius of the ellipse
@@ -404,7 +390,6 @@ class CanvasRenderer extends Renderer {
      * Stroke a line of the given two points
      * @name strokeLine
      * @memberof CanvasRenderer
-     * @function
      * @param {number} startX the start x coordinate
      * @param {number} startY the start y coordinate
      * @param {number} endX the end x coordinate
@@ -416,6 +401,8 @@ class CanvasRenderer extends Renderer {
             return;
         }
 
+        var context = this.getContext();
+
         context.beginPath();
         context.moveTo(startX, startY);
         context.lineTo(endX, endY);
@@ -426,7 +413,6 @@ class CanvasRenderer extends Renderer {
      * Fill a line of the given two points
      * @name fillLine
      * @memberof CanvasRenderer
-     * @function
      * @param {number} startX the start x coordinate
      * @param {number} startY the start y coordinate
      * @param {number} endX the end x coordinate
@@ -440,7 +426,6 @@ class CanvasRenderer extends Renderer {
      * Stroke the given me.Polygon on the screen
      * @name strokePolygon
      * @memberof CanvasRenderer
-     * @function
      * @param {Polygon} poly the shape to draw
      * @param {boolean} [fill=false] also fill the shape with the current color if true
      */
@@ -469,7 +454,6 @@ class CanvasRenderer extends Renderer {
      * Fill the given me.Polygon on the screen
      * @name fillPolygon
      * @memberof CanvasRenderer
-     * @function
      * @param {Polygon} poly the shape to draw
      */
     fillPolygon(poly) {
@@ -480,7 +464,6 @@ class CanvasRenderer extends Renderer {
      * Stroke a rectangle at the specified coordinates
      * @name strokeRect
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} width
@@ -501,7 +484,6 @@ class CanvasRenderer extends Renderer {
      * Draw a filled rectangle at the specified coordinates
      * @name fillRect
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} width
@@ -515,7 +497,6 @@ class CanvasRenderer extends Renderer {
      * Stroke a rounded rectangle at the specified coordinates
      * @name strokeRoundRect
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} width
@@ -539,7 +520,6 @@ class CanvasRenderer extends Renderer {
      * Draw a rounded filled rectangle at the specified coordinates
      * @name fillRoundRect
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} width
@@ -555,7 +535,6 @@ class CanvasRenderer extends Renderer {
      * return a reference to the system 2d Context
      * @name getContext
      * @memberof CanvasRenderer
-     * @function
      * @returns {CanvasRenderingContext2D}
      */
     getContext() {
@@ -575,7 +554,6 @@ class CanvasRenderer extends Renderer {
      * save the canvas context
      * @name save
      * @memberof CanvasRenderer
-     * @function
      */
     save() {
         this.backBufferContext2D.save();
@@ -585,7 +563,6 @@ class CanvasRenderer extends Renderer {
      * restores the canvas context
      * @name restore
      * @memberof CanvasRenderer
-     * @function
      */
     restore() {
         this.backBufferContext2D.restore();
@@ -600,7 +577,6 @@ class CanvasRenderer extends Renderer {
      * rotates the canvas context
      * @name rotate
      * @memberof CanvasRenderer
-     * @function
      * @param {number} angle in radians
      */
     rotate(angle) {
@@ -611,7 +587,6 @@ class CanvasRenderer extends Renderer {
      * scales the canvas context
      * @name scale
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      */
@@ -624,7 +599,6 @@ class CanvasRenderer extends Renderer {
      * By default, or upon reset, the value is set to #000000.
      * @name setColor
      * @memberof CanvasRenderer
-     * @function
      * @param {Color|string} color css color value
      */
     setColor(color) {
@@ -640,7 +614,6 @@ class CanvasRenderer extends Renderer {
      * Set the global alpha
      * @name setGlobalAlpha
      * @memberof CanvasRenderer
-     * @function
      * @param {number} alpha 0.0 to 1.0 values accepted.
      */
     setGlobalAlpha(alpha) {
@@ -651,7 +624,6 @@ class CanvasRenderer extends Renderer {
      * Return the global alpha
      * @name getGlobalAlpha
      * @memberof CanvasRenderer
-     * @function
      * @returns {number} global alpha value
      */
     getGlobalAlpha() {
@@ -662,7 +634,6 @@ class CanvasRenderer extends Renderer {
      * Set the line width on the context
      * @name setLineWidth
      * @memberof CanvasRenderer
-     * @function
      * @param {number} width Line width
      */
     setLineWidth(width) {
@@ -674,7 +645,6 @@ class CanvasRenderer extends Renderer {
      * identity one, and then apply the given transformation matrix.
      * @name setTransform
      * @memberof CanvasRenderer
-     * @function
      * @param {Matrix2d} mat2d Matrix to transform by
      */
     setTransform(mat2d) {
@@ -686,7 +656,6 @@ class CanvasRenderer extends Renderer {
      * Multiply given matrix into the renderer tranformation matrix
      * @name transform
      * @memberof CanvasRenderer
-     * @function
      * @param {Matrix2d} mat2d Matrix to transform by
      */
     transform(mat2d) {
@@ -710,7 +679,6 @@ class CanvasRenderer extends Renderer {
      * Translates the context to the given position
      * @name translate
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      */
@@ -730,7 +698,6 @@ class CanvasRenderer extends Renderer {
      * (<u>this is an experimental feature !</u>)
      * @name clipRect
      * @memberof CanvasRenderer
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} width
@@ -763,7 +730,6 @@ class CanvasRenderer extends Renderer {
      * Mask are not preserved through renderer context save and restore.
      * @name setMask
      * @memberof CanvasRenderer
-     * @function
      * @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
      */
@@ -829,7 +795,6 @@ class CanvasRenderer extends Renderer {
      * @name clearMask
      * @see CanvasRenderer#setMask
      * @memberof CanvasRenderer
-     * @function
      */
     clearMask() {
         if (this.maskLevel > 0) {