melonjs 17.4.0 → 18.0.0

package/src/plugin/plugin.js

@@ -1,163 +0,0 @@
-import { checkVersion } from "./../utils/utils.js";
-import { game, version } from "./../index.js";
-import { warning } from "../lang/console.js";
-
-/**
- * @import Application from "./../application/application.js";
- */
-
-/**
- * Contains all registered plugins.
- * @name cache
- * @memberof plugin
- */
-export let cache = {};
-
-/**
- * @namespace plugin
- */
-
-/**
- * a base Object class for plugin
- * (plugin must be installed using the register function)
- * @class
- * @name BasePlugin
- * @memberof plugin
- */
-export class BasePlugin {
-
-    /**
-     * @param {Application} [app] - a reference to the app/game that registered this plugin
-     */
-    constructor(app = game) {
-        /**
-         * define the minimum required version of melonJS<br>
-         * this can be overridden by the plugin
-         * @type {string}
-         * @default "__VERSION__"
-         */
-        this.version = "__VERSION__";
-
-        /**
-         * a reference to the app/game that registered this plugin
-         * @type {Application}
-         */
-        this.app = app;
-    }
-}
-
-/**
- * @class
- * @name Base
- * @memberof plugin
- * @deprecated since 15.1.6, see {@link plugin.BasePlugin}
- */
-export class Base extends BasePlugin {
-
-    constructor() {
-        warning("plugin.Base", "plugin.BasePlugin", "15.1.6");
-        super();
-    }
-}
-
-/**
- * patch a melonJS function
- * @name patch
- * @memberof plugin
- * @param {object} proto - target object
- * @param {string} name - target function
- * @param {Function} fn - replacement function
- * @example
- * // redefine the me.game.update function with a new one
- * me.plugin.patch(me.game, "update", function () {
- *   // display something in the console
- *   console.log("duh");
- *   // call the original me.game.update function
- *   this._patched();
- * });
- */
-export function patch(proto, name, fn) {
-    // use the object prototype if possible
-    if (typeof proto.prototype !== "undefined") {
-        proto = proto.prototype;
-    }
-    // reuse the logic behind object extends
-    if (typeof(proto[name]) === "function") {
-        // save the original function
-        let _parent = proto[name];
-        // override the function with the new one
-        Object.defineProperty(proto, name, {
-            "configurable" : true,
-            "value" : (function (name, fn) {
-                return function () {
-                    this._patched = _parent;
-                    let ret = fn.apply(this, arguments);
-                    this._patched = null;
-                    return ret;
-                };
-            })(name, fn)
-        });
-    }
-    else {
-        throw new Error(name + " is not an existing function");
-    }
-}
-
-/**
- * Register a plugin.
- * @name register
- * @memberof plugin
- * @param {BasePlugin} plugin - Plugin object to instantiate and register
- * @param {string} [name=plugin.constructor.name] - a unique name for this plugin
- * @param {...*} [args] - all extra parameters will be passed to the plugin constructor
- * @example
- * // register a new plugin
- * me.plugin.register(TestPlugin, "testPlugin");
- * // the `testPlugin` class instance can also be accessed through me.plugin.cache
- * me.plugin.cache.testPlugin.myfunction ();
- */
-export function register(plugin, name = plugin.toString().match(/ (\w+)/)[1]) {
-    // ensure me.plugins[name] is not already "used"
-    if (cache[name]) {
-        throw new Error("plugin " + name + " already registered");
-    }
-
-    // get extra arguments
-    let _args = [];
-    if (arguments.length > 2) {
-        // store extra arguments if any
-        _args = Array.prototype.slice.call(arguments, 1);
-    }
-
-    // try to instantiate the plugin
-    _args[0] = plugin;
-    let instance = new (plugin.bind.apply(plugin, _args))();
-
-    // inheritance check
-    if (typeof instance === "undefined" || !(instance instanceof BasePlugin)) {
-        throw new Error("Plugin should extend the BasePlugin Class !");
-    }
-
-    // compatibility testing
-    if (checkVersion(instance.version, version) > 0) {
-        throw new Error("Plugin version mismatch, expected: " + instance.version + ", got: " + version);
-    }
-
-    // create a reference to the new plugin
-    cache[name] = instance;
-}
-
-/**
- * returns the the plugin instance with the specified class type or registered name
- * @name get
- * @memberof plugin
- * @param {object|string} classType - the Class Object or registered name of the plugin to retreive
- * @returns {BasePlugin} a plugin instance or undefined
- */
-export function get(classType) {
-    for (const name in cache) {
-        if ((typeof classType === "string" && classType === name) || cache[name] instanceof classType) {
-            return cache[name];
-        }
-    }
-}

package/src/polyfill/console.js

@@ -1,11 +0,0 @@
-if (typeof globalThis !== "undefined") {
-    if (typeof globalThis.console === "undefined") {
-        globalThis.console = {};
-        globalThis.console.log = function() {};
-        globalThis.console.assert = function() {};
-        globalThis.console.warn = function() {};
-        globalThis.console.error = function() {
-            alert(Array.prototype.slice.call(arguments).join(", "));
-        };
-    }
-}

package/src/polyfill/index.js

@@ -1,13 +0,0 @@
-// https://github.com/melonjs/melonJS/issues/1092
-import "core-js/proposals/global-this";
-
-// es10 string trim functions
-import "core-js/es/string/trim-start";
-import "core-js/es/string/trim-end";
-
-// "built-in" polyfills
-import "./console.js";
-import "./roundrect.js";
-
-// fetch polyfill
-import "whatwg-fetch";

package/src/polyfill/roundrect.js

@@ -1,237 +0,0 @@
-/*
- * based on https://www.npmjs.com/package/canvas-roundrect-polyfill
- * @version 0.0.1
- */
-(() => {
-
-    "use strict";
-
-    /** @ignore */
-    function roundRect(x, y, w, h, radii) {
-
-        if (!([x, y, w, h].every((input) => Number.isFinite(input)))) {
-
-            return;
-
-        }
-
-        radii = parseRadiiArgument(radii);
-
-        let upperLeft, upperRight, lowerRight, lowerLeft;
-
-        if (radii.length === 4) {
-
-            upperLeft = toCornerPoint(radii[0]);
-            upperRight = toCornerPoint(radii[1]);
-            lowerRight = toCornerPoint(radii[2]);
-            lowerLeft = toCornerPoint(radii[3]);
-
-        } else if (radii.length === 3) {
-
-            upperLeft = toCornerPoint(radii[0]);
-            upperRight = toCornerPoint(radii[1]);
-            lowerLeft = toCornerPoint(radii[1]);
-            lowerRight = toCornerPoint(radii[2]);
-
-        } else if (radii.length === 2) {
-
-            upperLeft = toCornerPoint(radii[0]);
-            lowerRight = toCornerPoint(radii[0]);
-            upperRight = toCornerPoint(radii[1]);
-            lowerLeft = toCornerPoint(radii[1]);
-
-        } else if (radii.length === 1) {
-
-            upperLeft = toCornerPoint(radii[0]);
-            upperRight = toCornerPoint(radii[0]);
-            lowerRight = toCornerPoint(radii[0]);
-            lowerLeft = toCornerPoint(radii[0]);
-
-        } else {
-
-            throw new Error(radii.length + " is not a valid size for radii sequence.");
-
-        }
-
-        const corners = [upperLeft, upperRight, lowerRight, lowerLeft];
-        const negativeCorner = corners.find(({x, y}) => x < 0 || y < 0);
-        //const negativeValue = negativeCorner?.x < 0 ? negativeCorner.x : negativeCorner?.y
-
-        if (corners.some(({x, y}) => !Number.isFinite(x) || !Number.isFinite(y))) {
-
-            return;
-
-        }
-
-        if (negativeCorner) {
-
-            throw new Error("Radius value " + negativeCorner + " is negative.");
-
-        }
-
-        fixOverlappingCorners(corners);
-
-        if (w < 0 && h < 0) {
-
-            this.moveTo(x - upperLeft.x, y);
-            this.ellipse(x + w + upperRight.x, y - upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI * 1.5, -Math.PI);
-            this.ellipse(x + w + lowerRight.x, y + h + lowerRight.y, lowerRight.x, lowerRight.y, 0, -Math.PI, -Math.PI / 2);
-            this.ellipse(x - lowerLeft.x, y + h + lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, -Math.PI / 2, 0);
-            this.ellipse(x - upperLeft.x, y - upperLeft.y, upperLeft.x, upperLeft.y, 0, 0, -Math.PI / 2);
-
-        } else if (w < 0) {
-
-            this.moveTo(x - upperLeft.x, y);
-            this.ellipse(x + w + upperRight.x, y + upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI / 2, -Math.PI, 1);
-            this.ellipse(x + w + lowerRight.x, y + h - lowerRight.y, lowerRight.x, lowerRight.y, 0, -Math.PI, -Math.PI * 1.5, 1);
-            this.ellipse(x - lowerLeft.x, y + h - lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, Math.PI / 2, 0, 1);
-            this.ellipse(x - upperLeft.x, y + upperLeft.y, upperLeft.x, upperLeft.y, 0, 0, -Math.PI / 2, 1);
-
-        } else if (h < 0) {
-
-            this.moveTo(x + upperLeft.x, y);
-            this.ellipse(x + w - upperRight.x, y - upperRight.y, upperRight.x, upperRight.y, 0, Math.PI / 2, 0, 1);
-            this.ellipse(x + w - lowerRight.x, y + h + lowerRight.y, lowerRight.x, lowerRight.y, 0, 0, -Math.PI / 2, 1);
-            this.ellipse(x + lowerLeft.x, y + h + lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, -Math.PI / 2, -Math.PI, 1);
-            this.ellipse(x + upperLeft.x, y - upperLeft.y, upperLeft.x, upperLeft.y, 0, -Math.PI, -Math.PI * 1.5, 1);
-
-        } else {
-
-            this.moveTo(x + upperLeft.x, y);
-            this.ellipse(x + w - upperRight.x, y + upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI / 2, 0);
-            this.ellipse(x + w - lowerRight.x, y + h - lowerRight.y, lowerRight.x, lowerRight.y, 0, 0, Math.PI / 2);
-            this.ellipse(x + lowerLeft.x, y + h - lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, Math.PI / 2, Math.PI);
-            this.ellipse(x + upperLeft.x, y + upperLeft.y, upperLeft.x, upperLeft.y, 0, Math.PI, Math.PI * 1.5);
-
-        }
-
-        this.closePath();
-        this.moveTo(x, y);
-
-        /** @ignore */
-        function toDOMPointInit(value) {
-
-            const {x, y, z, w} = value;
-            return {x, y, z, w};
-
-        }
-
-        /** @ignore */
-        function parseRadiiArgument(value) {
-
-            // https://webidl.spec.whatwg.org/#es-union
-            // with 'optional (unrestricted double or DOMPointInit
-            //   or sequence<(unrestricted double or DOMPointInit)>) radii = 0'
-            const type = typeof value;
-
-            if (type === "undefined" || value === null) {
-
-                return [0];
-
-            }
-            if (type === "function") {
-
-                return [NaN];
-
-            }
-            if (type === "object") {
-
-                if (typeof value[Symbol.iterator] === "function") {
-
-                    return [...value].map((elem) => {
-                        // https://webidl.spec.whatwg.org/#es-union
-                        // with '(unrestricted double or DOMPointInit)'
-                        const elemType = typeof elem;
-                        if (elemType === "undefined" || elem === null) {
-                            return 0;
-                        }
-                        if (elemType === "function") {
-                            return NaN;
-                        }
-                        if (elemType === "object") {
-                            return toDOMPointInit(elem);
-                        }
-                        return toUnrestrictedNumber(elem);
-                    });
-
-                }
-
-                return [toDOMPointInit(value)];
-
-            }
-
-            return [toUnrestrictedNumber(value)];
-
-        }
-
-        /** @ignore */
-        function toUnrestrictedNumber(value) {
-
-            return +value;
-
-        }
-
-        /** @ignore */
-        function toCornerPoint(value) {
-
-            const asNumber = toUnrestrictedNumber(value);
-            if (Number.isFinite(asNumber)) {
-
-                return {
-                    x: asNumber,
-                    y: asNumber
-                };
-
-            }
-            if (Object(value) === value) {
-
-                return {
-                    x: toUnrestrictedNumber(value.x || 0),
-                    y: toUnrestrictedNumber(value.y || 0)
-                };
-
-            }
-
-            return {
-                x: NaN,
-                y: NaN
-            };
-
-        }
-
-        /** @ignore */
-        function fixOverlappingCorners(corners) {
-            const [upperLeft, upperRight, lowerRight, lowerLeft] = corners;
-            const factors = [
-                Math.abs(w) / (upperLeft.x + upperRight.x),
-                Math.abs(h) / (upperRight.y + lowerRight.y),
-                Math.abs(w) / (lowerRight.x + lowerLeft.x),
-                Math.abs(h) / (upperLeft.y + lowerLeft.y)
-            ];
-            const minFactor = Math.min(...factors);
-            if (minFactor <= 1) {
-                corners.forEach((radii) => {
-                    radii.x *= minFactor;
-                    radii.y *= minFactor;
-                });
-            }
-        }
-    }
-
-    if (globalThis.CanvasRenderingContext2D) {
-        if (typeof globalThis.Path2D.prototype.roundRect === "undefined") {
-            globalThis.Path2D.prototype.roundRect = roundRect;
-        }
-    }
-    if (globalThis.CanvasRenderingContext2D) {
-        if (typeof globalThis.CanvasRenderingContext2D.prototype.roundRect === "undefined") {
-            globalThis.CanvasRenderingContext2D.prototype.roundRect = roundRect;
-        }
-    }
-    if (globalThis.OffscreenCanvasRenderingContext2D) {
-        if (typeof globalThis.OffscreenCanvasRenderingContext2D.prototype.roundRect === "undefined") {
-            globalThis.OffscreenCanvasRenderingContext2D.prototype.roundRect = roundRect;
-        }
-    }
-
-})();

package/src/renderable/collectable.js

@@ -1,51 +0,0 @@
-import Sprite from "./sprite.js";
-import Body from "./../physics/body.js";
-import collision from "./../physics/collision.js";
-import pool from "./../system/pooling.js";
-
-/**
- * @classdesc
- * a basic collectable helper class for immovable object (e.g. a coin)
- * @augments Sprite
- */
-export default class Collectable extends Sprite {
-    /**
-     * @param {number} x - the x coordinates of the collectable
-     * @param {number} y - the y coordinates of the collectable
-     * @param {object} settings - See {@link Sprite}
-     */
-    constructor(x, y, settings) {
-
-        // call the super constructor
-        super(x, y, settings);
-
-        this.name = settings.name;
-        this.type = settings.type;
-        this.id = settings.id;
-
-        // add and configure the physic body
-        let shape = settings.shapes;
-        if (typeof shape === "undefined") {
-            shape = pool.pull("Polygon", 0, 0, [
-                pool.pull("Vector2d", 0,          0),
-                pool.pull("Vector2d", this.width, 0),
-                pool.pull("Vector2d", this.width, this.height)
-            ]);
-        }
-        this.body = new Body(this, shape);
-        this.body.collisionType = collision.types.COLLECTABLE_OBJECT;
-        // by default only collides with PLAYER_OBJECT
-        this.body.setCollisionMask(collision.types.PLAYER_OBJECT);
-        this.body.setStatic(true);
-
-        // Update anchorPoint
-        if (settings.anchorPoint) {
-            this.anchorPoint.set(settings.anchorPoint.x, settings.anchorPoint.y);
-        } else {
-            // for backward compatibility
-            this.anchorPoint.set(0, 0);
-        }
-
-    }
-
-}

package/src/renderable/colorlayer.js

@@ -1,74 +0,0 @@
-import pool from "./../system/pooling.js";
-import Renderable from "./renderable.js";
-
-/**
- * additional import for TypeScript
- * @import Color from "./../math/color.js";
- * @import CanvasRenderer from "./../video/canvas/canvas_renderer.js";
- * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
- * @import Camera2d from "./../camera/camera2d.js";
- */
-
-/**
- * @classdesc
- * a generic Color Layer Object.  Fills the entire Canvas with the color not just the container the object belongs to.
- * @augments Renderable
- */
-export default class ColorLayer extends Renderable {
-    /**
-     * @param {string} name - Layer name
-     * @param {Color|string} color - CSS color
-     * @param {number} [z = 0] - z-index position
-     */
-    constructor(name, color, z) {
-        // parent constructor
-        super(0, 0, Infinity, Infinity);
-
-        /**
-         * the layer color component
-         * @public
-         * @type {Color}
-         * @name color
-         * @memberof ColorLayer#
-         */
-        this.color = pool.pull("Color").parseCSS(color);
-
-        this.onResetEvent(name, color, z);
-
-    }
-
-    onResetEvent(name, color, z = 0) {
-        // apply given parameters
-        this.name = name;
-        this.pos.z = z;
-        this.floating = true;
-        // string (#RGB, #ARGB, #RRGGBB, #AARRGGBB)
-        this.color.parseCSS(color);
-    }
-
-    /**
-     * draw this color layer (automatically called by melonJS)
-     * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
-     * @param {Camera2d} [viewport] - the viewport to (re)draw
-     */
-    draw(renderer, viewport) {
-        renderer.save();
-        renderer.clipRect(
-            0, 0,
-            viewport.width, viewport.height
-        );
-        renderer.clearColor(this.color);
-        renderer.restore();
-    }
-
-    /**
-     * Destroy function
-     * @ignore
-     */
-    destroy() {
-        pool.push(this.color);
-        this.color = undefined;
-        super.destroy();
-    }
-
-}