litecanvas 0.75.0 → 0.75.1

package/dist/dist.js

@@ -106,11 +106,6 @@
        * @tutorial https://gamedev.net/tutorials/programming/general-and-gameplay-programming/a-brief-introduction-to-lerp-r4954/
        */
       lerp: (start, end, t) => {
-        if (false) {
-          assert(isFinite(start), "lerp: 1st param must be a number");
-          assert(isFinite(end), "lerp: 2nd param must be a number");
-          assert(isFinite(t), "lerp: 3rd param must be a number");
-        }
         return t * (end - start) + start;
       },
       /**
@@ -120,9 +115,6 @@
        * @returns {number} the value in radians
        */
       deg2rad: (degs) => {
-        if (false) {
-          assert(isFinite(degs), "deg2rad: 1st param must be a number");
-        }
         return PI / 180 * degs;
       },
       /**
@@ -132,9 +124,6 @@
        * @returns {number} the value in degrees
        */
       rad2deg: (rads) => {
-        if (false) {
-          assert(isFinite(rads), "rad2deg: 1st param must be a number");
-        }
         return 180 / PI * rads;
       },
       /**
@@ -146,15 +135,6 @@
        * @returns {number}
        */
       clamp: (value, min, max) => {
-        if (false) {
-          assert(isFinite(value), "clamp: 1st param must be a number");
-          assert(isFinite(min), "clamp: 2nd param must be a number");
-          assert(isFinite(max), "clamp: 3rd param must be a number");
-          assert(
-            max > min,
-            "randi: the 2nd param must be less than the 3rd param"
-          );
-        }
         if (value < min) return min;
         if (value > max) return max;
         return value;
@@ -168,19 +148,6 @@
        * @returns {number}
        */
       wrap: (value, min, max) => {
-        if (false) {
-          assert(isFinite(value), "wrap: 1st param must be a number");
-          assert(isFinite(min), "wrap: 2nd param must be a number");
-          assert(isFinite(max), "wrap: 3rd param must be a number");
-          assert(
-            max > min,
-            "randi: the 2nd param must be less than the 3rd param"
-          );
-          assert(
-            max !== min,
-            "randi: the 2nd param must be not equal to the 3rd param"
-          );
-        }
         return value - (max - min) * Math.floor((value - min) / (max - min));
       },
       /**
@@ -195,13 +162,6 @@
        * @returns {number} the remapped number
        */
       map(value, start1, stop1, start2, stop2, withinBounds) {
-        if (false) {
-          assert(isFinite(value), "map: 1st param must be a number");
-          assert(isFinite(start1), "map: 2nd param must be a number");
-          assert(isFinite(stop1), "map: 3rd param must be a number");
-          assert(isFinite(start2), "map: 4th param must be a number");
-          assert(isFinite(stop2), "map: 5th param must be a number");
-        }
         const result = (value - start1) / (stop1 - start1) * (stop2 - start2) + start2;
         return withinBounds ? instance.clamp(result, start2, stop2) : result;
       },
@@ -216,11 +176,6 @@
        * @returns {number} the normalized number.
        */
       norm: (value, start, stop) => {
-        if (false) {
-          assert(isFinite(value), "norm: 1st param must be a number");
-          assert(isFinite(start), "norm: 2nd param must be a number");
-          assert(isFinite(stop), "norm: 3rd param must be a number");
-        }
         return instance.map(value, start, stop, 0, 1);
       },
       /** RNG API */
@@ -233,14 +188,6 @@
        * @returns {number} the random number
        */
       rand: (min = 0, max = 1) => {
-        if (false) {
-          assert(isFinite(min), "rand: 1st param must be a number");
-          assert(isFinite(max), "rand: 2nd param must be a number");
-          assert(
-            max > min,
-            "rand: the 1st param must be less than the 2nd param"
-          );
-        }
         const a = 1664525;
         const c = 1013904223;
         const m = 4294967296;
@@ -255,14 +202,6 @@
        * @returns {number} the random number
        */
       randi: (min = 0, max = 1) => {
-        if (false) {
-          assert(isFinite(min), "randi: 1st param must be a number");
-          assert(isFinite(max), "randi: 2nd param must be a number");
-          assert(
-            max > min,
-            "randi: the 1st param must be less than the 2nd param"
-          );
-        }
         return Math.floor(instance.rand(min, max + 1));
       },
       /**
@@ -273,12 +212,6 @@
        * @returns {number} the seed state
        */
       seed: (value) => {
-        if (false) {
-          assert(
-            null == value || isFinite(value) && value >= 0,
-            "seed: 1st param must be a positive number or zero"
-          );
-        }
         return null == value ? _rng_seed : _rng_seed = ~~value;
       },
       /** BASIC GRAPHICS API */
@@ -288,12 +221,6 @@
        * @param {number?} color The background color (index) or null (for transparent)
        */
       cls(color) {
-        if (false) {
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "cls: 1st param must be a positive number or zero or null"
-          );
-        }
         if (null == color) {
           _ctx.clearRect(0, 0, _ctx.canvas.width, _ctx.canvas.height);
         } else {
@@ -317,26 +244,6 @@
        * @param {number|number[]} [radii] A number or list specifying the radii used to draw a rounded-borders rectangle
        */
       rect(x, y, width, height, color, radii = null) {
-        if (false) {
-          assert(isFinite(x), "rect: 1st param must be a number");
-          assert(isFinite(y), "rect: 2nd param must be a number");
-          assert(
-            isFinite(width) && width > 0,
-            "rect: 3rd param must be a positive number"
-          );
-          assert(
-            isFinite(height) && height >= 0,
-            "rect: 4th param must be a positive number or zero"
-          );
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "rect: 5th param must be a positive number or zero"
-          );
-          assert(
-            null == radii || isFinite(radii) || Array.isArray(radii) && radii.length >= 1,
-            "rect: 6th param must be a number or array of numbers"
-          );
-        }
         _ctx.beginPath();
         _ctx[radii ? "roundRect" : "rect"](
           ~~x - _outline_fix,
@@ -358,26 +265,6 @@
        * @param {number|number[]} [radii] A number or list specifying the radii used to draw a rounded-borders rectangle
        */
       rectfill(x, y, width, height, color, radii = null) {
-        if (false) {
-          assert(isFinite(x), "rectfill: 1st param must be a number");
-          assert(isFinite(y), "rectfill: 2nd param must be a number");
-          assert(
-            isFinite(width) && width >= 0,
-            "rectfill: 3rd param must be a positive number or zero"
-          );
-          assert(
-            isFinite(height) && height >= 0,
-            "rectfill: 4th param must be a positive number or zero"
-          );
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "rectfill: 5th param must be a positive number or zero"
-          );
-          assert(
-            null == radii || isFinite(radii) || Array.isArray(radii) && radii.length >= 1,
-            "rectfill: 6th param must be a number or array of at least 2 numbers"
-          );
-        }
         _ctx.beginPath();
         _ctx[radii ? "roundRect" : "rect"](
           ~~x,
@@ -397,18 +284,6 @@
        * @param {number} [color=0] the color index
        */
       circ(x, y, radius, color) {
-        if (false) {
-          assert(isFinite(x), "circ: 1st param must be a number");
-          assert(isFinite(y), "circ: 2nd param must be a number");
-          assert(
-            isFinite(radius) && radius >= 0,
-            "circ: 3rd param must be a positive number or zero"
-          );
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "circ: 4th param must be a positive number or zero"
-          );
-        }
         _ctx.beginPath();
         _ctx.arc(~~x, ~~y, ~~radius, 0, TWO_PI);
         instance.stroke(color);
@@ -422,18 +297,6 @@
        * @param {number} [color=0] the color index
        */
       circfill(x, y, radius, color) {
-        if (false) {
-          assert(isFinite(x), "circfill: 1st param must be a number");
-          assert(isFinite(y), "circfill: 2nd param must be a number");
-          assert(
-            isFinite(radius) && radius >= 0,
-            "circfill: 3rd param must be a positive number or zero"
-          );
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "circfill: 4th param must be a positive number or zero"
-          );
-        }
         _ctx.beginPath();
         _ctx.arc(~~x, ~~y, ~~radius, 0, TWO_PI);
         instance.fill(color);
@@ -448,22 +311,6 @@
        * @param {number} [color=0] the color index
        */
       line(x1, y1, x2, y2, color) {
-        if (false) {
-          assert(isFinite(x1), "line: 1st param must be a number");
-          assert(isFinite(y1), "line: 2nd param must be a number");
-          assert(
-            isFinite(x2),
-            "line: 3rd param must be a positive number or zero"
-          );
-          assert(
-            isFinite(y2),
-            "line: 4th param must be a positive number or zero"
-          );
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "line: 5th param must be a positive number or zero"
-          );
-        }
         _ctx.beginPath();
         let xfix = _outline_fix !== 0 && ~~x1 === ~~x2 ? 0.5 : 0;
         let yfix = _outline_fix !== 0 && ~~y1 === ~~y2 ? 0.5 : 0;
@@ -478,12 +325,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineWidth
        */
       linewidth(value) {
-        if (false) {
-          assert(
-            isFinite(value) && ~~value > 0,
-            "linewidth: 1st param must be a positive number"
-          );
-        }
         _ctx.lineWidth = ~~value;
         _outline_fix = ~~value % 2 === 0 ? 0 : 0.5;
       },
@@ -496,13 +337,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineDashOffset
        */
       linedash(segments, offset = 0) {
-        if (false) {
-          assert(
-            Array.isArray(segments) && segments.length > 0,
-            "linedash: 1st param must be an array of numbers"
-          );
-          assert(isFinite(offset), "linedash: 2nd param must be a number");
-        }
         _ctx.setLineDash(segments);
         _ctx.lineDashOffset = offset;
       },
@@ -517,18 +351,6 @@
        * @param {string} [fontStyle] can be "normal" (default), "italic" and/or "bold".
        */
       text(x, y, message, color = 3, fontStyle = "normal") {
-        if (false) {
-          assert(isFinite(x), "text: 1st param must be a number");
-          assert(isFinite(y), "text: 2nd param must be a number");
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "text: 4th param must be a positive number or zero"
-          );
-          assert(
-            "string" === typeof fontStyle,
-            "text: 5th param must be a string"
-          );
-        }
         _ctx.font = `${fontStyle} ${_fontSize}px ${_fontFamily}`;
         _ctx.fillStyle = instance.getcolor(color);
         _ctx.fillText(message, ~~x, ~~y);
@@ -539,12 +361,6 @@
        * @param {string} family
        */
       textfont(family) {
-        if (false) {
-          assert(
-            "string" === typeof family,
-            "textfont: 1st param must be a string"
-          );
-        }
         _fontFamily = family;
       },
       /**
@@ -553,9 +369,6 @@
        * @param {number} size
        */
       textsize(size) {
-        if (false) {
-          assert(isFinite(size), "textsize: 1st param must be a number");
-        }
         _fontSize = size;
       },
       /**
@@ -567,25 +380,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/textAlign
        */
       textalign(align, baseline) {
-        if (false) {
-          assert(
-            null == align || ["left", "right", "center", "start", "end"].includes(
-              align
-            ),
-            "textalign: 1st param must be a string"
-          );
-          assert(
-            null == baseline || [
-              "top",
-              "bottom",
-              "middle",
-              "hanging",
-              "alphabetic",
-              "ideographic"
-            ].includes(baseline),
-            "textalign: 2nd param must be a string"
-          );
-        }
         if (align) _ctx.textAlign = align;
         if (baseline) _ctx.textBaseline = baseline;
       },
@@ -598,10 +392,6 @@
        * @param {OffscreenCanvas|HTMLImageElement|HTMLCanvasElement} source
        */
       image(x, y, source) {
-        if (false) {
-          assert(isFinite(x), "image: 1st param must be a number");
-          assert(isFinite(y), "image: 2nd param must be a number");
-        }
         _ctx.drawImage(source, ~~x, ~~y);
       },
       /**
@@ -617,18 +407,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/OffscreenCanvas
        */
       paint(width, height, drawing, options = {}) {
-        if (false) {
-          assert(isFinite(width), "paint: 1st param must be a number");
-          assert(isFinite(height), "paint: 2nd param must be a number");
-          assert(
-            "function" === typeof drawing || Array.isArray(drawing),
-            "paint: 3rd param must be a function or array"
-          );
-          assert(
-            options && !options.scale || isFinite(options.scale),
-            "paint: 4th param (options.scale) must be a number"
-          );
-        }
         const canvas = options.canvas || new OffscreenCanvas(1, 1), scale = options.scale || 1, contextOriginal = _ctx;
         canvas.width = width * scale;
         canvas.height = height * scale;
@@ -662,8 +440,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D
        */
       ctx(context) {
-        if (false) {
-        }
         if (context) {
           _ctx = context;
         }
@@ -688,10 +464,6 @@
        * @param {number} y
        */
       translate: (x, y) => {
-        if (false) {
-          assert(isFinite(x), "translate: 1st param must be a number");
-          assert(isFinite(y), "translate: 2nd param must be a number");
-        }
         return _ctx.translate(~~x, ~~y);
       },
       /**
@@ -701,13 +473,6 @@
        * @param {number} [y]
        */
       scale: (x, y) => {
-        if (false) {
-          assert(isFinite(x), "scale: 1st param must be a number");
-          assert(
-            y == null || isFinite(y),
-            "scale: 2nd param must be a number"
-          );
-        }
         return _ctx.scale(x, y || x);
       },
       /**
@@ -716,9 +481,6 @@
        * @param {number} radians
        */
       rotate: (radians) => {
-        if (false) {
-          assert(isFinite(radians), "rotate: 1st param must be a number");
-        }
         return _ctx.rotate(radians);
       },
       /**
@@ -728,9 +490,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalAlpha
        */
       alpha(value) {
-        if (false) {
-          assert(isFinite(value), "alpha: 1st param must be a number");
-        }
         _ctx.globalAlpha = instance.clamp(value, 0, 1);
       },
       /**
@@ -743,12 +502,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/Path2D/Path2D
        */
       path: (arg) => {
-        if (false) {
-          assert(
-            null == arg || "string" === typeof arg || arg instanceof Path2D,
-            "path: 1st param must be a string or a Path2D instance"
-          );
-        }
         return new Path2D(arg);
       },
       /**
@@ -758,16 +511,6 @@
        * @param {Path2D} [path]
        */
       fill(color, path) {
-        if (false) {
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "fill: 1st param must be a positive number or zero"
-          );
-          assert(
-            null == path || path instanceof Path2D,
-            "fill: 2nd param must be a Path2D instance"
-          );
-        }
         _ctx.fillStyle = instance.getcolor(color);
         if (path) {
           _ctx.fill(path);
@@ -782,16 +525,6 @@
        * @param {Path2D} [path]
        */
       stroke(color, path) {
-        if (false) {
-          assert(
-            null == color || isFinite(color) && color >= 0,
-            "stroke: 1st param must be a positive number or zero"
-          );
-          assert(
-            null == path || path instanceof Path2D,
-            "stroke: 2nd param must be a Path2D instance"
-          );
-        }
         _ctx.strokeStyle = instance.getcolor(color);
         if (path) {
           _ctx.stroke(path);
@@ -806,12 +539,6 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/clip
        */
       clip(path) {
-        if (false) {
-          assert(
-            path instanceof Path2D,
-            "clip: 1st param must be a Path2D instance"
-          );
-        }
         _ctx.clip(path);
       },
       /** SOUND API */
@@ -827,17 +554,6 @@
        * @see https://github.com/KilledByAPixel/ZzFX
        */
       sfx(zzfxParams, pitchSlide = 0, volumeFactor = 1) {
-        if (false) {
-          assert(
-            null == zzfxParams || Array.isArray(zzfxParams),
-            "sfx: 1st param must be an array"
-          );
-          assert(isFinite(pitchSlide), "sfx: 2nd param must be a number");
-          assert(
-            isFinite(volumeFactor),
-            "sfx: 3rd param must be a number"
-          );
-        }
         if (root.zzfxV <= 0 || navigator.userActivation && !navigator.userActivation.hasBeenActive) {
           return false;
         }
@@ -857,9 +573,6 @@
        * @param {number} value
        */
       volume(value) {
-        if (false) {
-          assert(isFinite(value), "volume: 1st param must be a number");
-        }
         root.zzfxV = value;
       },
       /** UTILS API */
@@ -877,16 +590,6 @@
        * @returns {boolean}
        */
       colrect: (x1, y1, w1, h1, x2, y2, w2, h2) => {
-        if (false) {
-          assert(isFinite(x1), "colrect: 1st param must be a number");
-          assert(isFinite(y1), "colrect: 2nd param must be a number");
-          assert(isFinite(w1), "colrect: 3rd param must be a number");
-          assert(isFinite(h1), "colrect: 4th param must be a number");
-          assert(isFinite(x2), "colrect: 5th param must be a number");
-          assert(isFinite(y2), "colrect: 6th param must be a number");
-          assert(isFinite(w2), "colrect: 7th param must be a number");
-          assert(isFinite(h2), "colrect: 8th param must be a number");
-        }
         return x1 < x2 + w2 && x1 + w1 > x2 && y1 < y2 + h2 && y1 + h1 > y2;
       },
       /**
@@ -901,14 +604,6 @@
        * @returns {boolean}
        */
       colcirc: (x1, y1, r1, x2, y2, r2) => {
-        if (false) {
-          assert(isFinite(x1), "colcirc: 1st param must be a number");
-          assert(isFinite(y1), "colcirc: 2nd param must be a number");
-          assert(isFinite(r1), "colcirc: 3rd param must be a number");
-          assert(isFinite(x2), "colcirc: 4th param must be a number");
-          assert(isFinite(y2), "colcirc: 5th param must be a number");
-          assert(isFinite(r2), "colcirc: 6th param must be a number");
-        }
         return (x2 - x1) * (x2 - x1) + (y2 - y1) * (y2 - y1) <= (r1 + r2) * (r1 + r2);
       },
       /** PLUGINS API */
@@ -918,16 +613,6 @@
        * @param {pluginCallback} callback
        */
       use(callback, config = {}) {
-        if (false) {
-          assert(
-            "function" === typeof callback,
-            "use: 1st param must be a function"
-          );
-          assert(
-            "object" === typeof config,
-            "use: 2nd param must be an object"
-          );
-        }
         _initialized ? loadPlugin(callback, config) : _plugins.push([callback, config]);
       },
       /**
@@ -938,16 +623,6 @@
        * @returns {Function} a function to remove the listener
        */
       listen(eventName, callback) {
-        if (false) {
-          assert(
-            "string" === typeof eventName,
-            "listen: 1st param must be a string"
-          );
-          assert(
-            "function" === typeof callback,
-            "listen: 2nd param must be a function"
-          );
-        }
         _events[eventName] = _events[eventName] || /* @__PURE__ */ new Set();
         _events[eventName].add(callback);
         return () => _events[eventName].delete(callback);
@@ -962,12 +637,6 @@
        * @param {*} [arg4] any data to be passed over the listeners
        */
       emit(eventName, arg1, arg2, arg3, arg4) {
-        if (false) {
-          assert(
-            "string" === typeof eventName,
-            "emit: 1st param must be a string"
-          );
-        }
         triggerEvent("before:" + eventName, arg1, arg2, arg3, arg4);
         triggerEvent(eventName, arg1, arg2, arg3, arg4);
         triggerEvent("after:" + eventName, arg1, arg2, arg3, arg4);
@@ -979,12 +648,6 @@
        * @returns {string} the color code
        */
       getcolor: (index) => {
-        if (false) {
-          assert(
-            null == index || isFinite(index) && index >= 0,
-            "getcolor: 1st param must be a number"
-          );
-        }
         return colors[~~index % colors.length];
       },
       /**
@@ -994,13 +657,7 @@
        * @param {*} value
        */
       setvar(key, value) {
-        if (false) {
-          assert(
-            "string" === typeof key,
-            "setvar: 1st param must be a string"
-          );
-          if (value == null) {
-          }
+        if (value == null) {
         }
         instance[key] = value;
         if (_global) {
@@ -1014,10 +671,6 @@
        * @param {number} height
        */
       resize(width, height) {
-        if (false) {
-          assert(isFinite(width), "resize: 1st param must be a number");
-          assert(isFinite(height), "resize: 2nd param must be a number");
-        }
         instance.setvar("WIDTH", _canvas.width = width);
         instance.setvar("HEIGHT", _canvas.height = height);
         pageResized();
@@ -1030,9 +683,6 @@
        * @param {number} value
        */
       timescale(value) {
-        if (false) {
-          assert(isFinite(value), "timescale: 1st param must be a number");
-        }
         _timeScale = value;
       },
       /**
@@ -1041,12 +691,6 @@
        * @param {number} value
        */
       setfps(value) {
-        if (false) {
-          assert(
-            isFinite(value) && value >= 1,
-            "setfps: 1st param must be a positive number"
-          );
-        }
         _deltaTime = 1 / ~~value;
       },
       /**
@@ -1183,12 +827,6 @@
       if (settings.keyboardEvents) {
         const _keys = /* @__PURE__ */ new Set();
         const iskeydown = (key) => {
-          if (false) {
-            assert(
-              "string" === typeof key,
-              "iskeydown: 1st param must be a string"
-            );
-          }
           return "any" === key ? _keys.size > 0 : _keys.has(key.toLowerCase());
         };
         instance.setvar("iskeydown", iskeydown);
@@ -1242,20 +880,6 @@
     }
     function setupCanvas() {
       _canvas = "string" === typeof _canvas ? document.querySelector(_canvas) : _canvas;
-      if (false) {
-        assert(
-          _canvas && _canvas.tagName === "CANVAS",
-          "Invalid canvas element"
-        );
-        assert(
-          null === instance.WIDTH || instance.WIDTH > 0,
-          `Litecanvas' "width" option should be null or a positive number`
-        );
-        assert(
-          null === instance.HEIGHT || instance.HEIGHT > 0,
-          `Litecanvas' "width" option should be null or a positive number`
-        );
-      }
       instance.setvar("CANVAS", _canvas);
       _ctx = _canvas.getContext("2d");
       on(_canvas, "click", () => root.focus());
@@ -1304,12 +928,6 @@
     }
     function loadPlugin(callback, config) {
       const pluginData = callback(instance, _helpers, config);
-      if (false) {
-        assert(
-          null == pluginData || "object" === typeof pluginData,
-          "Litecanvas plugins should return an object or nothing"
-        );
-      }
       for (const key in pluginData) {
         instance.setvar(key, pluginData[key]);
       }