litecanvas 0.76.0 → 0.78.0

package/dist/dist.dev.js

@@ -30,7 +30,7 @@
 
   // src/index.js
   function litecanvas(settings = {}) {
-    const root = globalThis, PI = Math.PI, TWO_PI = PI * 2, raf = requestAnimationFrame, _browserEventListeners = [], on = (elem, evt, callback) => {
+    const root = globalThis, math = Math, PI = math.PI, TWO_PI = PI * 2, raf = requestAnimationFrame, _browserEventListeners = [], on = (elem, evt, callback) => {
       elem.addEventListener(evt, callback, false);
       _browserEventListeners.push(
         () => elem.removeEventListener(evt, callback, false)
@@ -50,7 +50,7 @@
       animate: true
     };
     settings = Object.assign(defaults, settings);
-    let _initialized = false, _plugins = [], _canvas = settings.canvas || document.createElement("canvas"), _autoscale = settings.autoscale, _animated = settings.animate, _scale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _deltaTime, _accumulated = 0, _rafid, _fontFamily = "sans-serif", _fontSize = 32, _rng_seed = Date.now(), _global = settings.global, _events = {
+    let _initialized = false, _plugins = [], _canvas = settings.canvas || document.createElement("canvas"), _animated = settings.animate, _scale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _deltaTime = 1 / 60, _accumulated = 0, _rafid, _fontFamily = "sans-serif", _fontSize = 18, _rng_seed = Date.now(), _global = settings.global, _events = {
       init: null,
       update: null,
       draw: null,
@@ -135,6 +135,25 @@
         DEV: assert(isFinite(rads), "rad2deg: 1st param must be a number");
         return 180 / PI * rads;
       },
+      /**
+       * Calculates the integer closest to a number and optional precision.
+       *
+       * @param {number} n number to round.
+       * @param {number} [precision] number of decimal digits to round to, default is 0.
+       * @returns {number} rounded number.
+       */
+      round: (n, precision = 0) => {
+        DEV: assert(isFinite(n), "round: 1st param must be a number");
+        DEV: assert(
+          null === precision || isFinite(precision) && precision >= 0,
+          "round: 2nd param must be a positive number or zero"
+        );
+        if (!precision) {
+          return math.round(n);
+        }
+        const multiplier = 10 ** precision;
+        return math.round(n * multiplier) / multiplier;
+      },
       /**
        * Constrains a number between `min` and `max`.
        *
@@ -175,7 +194,7 @@
           max !== min,
           "randi: the 2nd param must be not equal to the 3rd param"
         );
-        return value - (max - min) * Math.floor((value - min) / (max - min));
+        return value - (max - min) * math.floor((value - min) / (max - min));
       },
       /**
        * Re-maps a number from one range to another.
@@ -249,7 +268,7 @@
           max > min,
           "randi: the 1st param must be less than the 2nd param"
         );
-        return Math.floor(instance.rand(min, max + 1));
+        return math.floor(instance.rand(min, max + 1));
       },
       /**
        * If a value is passed, initializes the random number generator with an explicit seed value.
@@ -269,12 +288,12 @@
       /**
        * Clear the game screen with an optional color
        *
-       * @param {number?} color The background color (index) or null (for transparent)
+       * @param {number?} color The background color (index) or null/undefined (for transparent)
        */
       cls(color) {
         DEV: assert(
           null == color || isFinite(color) && color >= 0,
-          "cls: 1st param must be a positive number or zero or null"
+          "cls: 1st param must be a positive number or zero or undefined"
         );
         if (null == color) {
           _ctx.clearRect(0, 0, _ctx.canvas.width, _ctx.canvas.height);
@@ -797,51 +816,6 @@
         DEV: assert(isFinite(value), "volume: 1st param must be a number");
         root.zzfxV = value;
       },
-      /** UTILS API */
-      /**
-       * Check a collision between two rectangles
-       *
-       * @param {number} x1 first rectangle position X
-       * @param {number} y1 first rectangle position Y
-       * @param {number} w1 first rectangle width
-       * @param {number} h1 first rectangle height
-       * @param {number} x2 second rectangle position X
-       * @param {number} y2 second rectangle position Y
-       * @param {number} w2 second rectangle width
-       * @param {number} h2 second rectangle height
-       * @returns {boolean}
-       */
-      colrect: (x1, y1, w1, h1, x2, y2, w2, h2) => {
-        DEV: assert(isFinite(x1), "colrect: 1st param must be a number");
-        DEV: assert(isFinite(y1), "colrect: 2nd param must be a number");
-        DEV: assert(isFinite(w1), "colrect: 3rd param must be a number");
-        DEV: assert(isFinite(h1), "colrect: 4th param must be a number");
-        DEV: assert(isFinite(x2), "colrect: 5th param must be a number");
-        DEV: assert(isFinite(y2), "colrect: 6th param must be a number");
-        DEV: assert(isFinite(w2), "colrect: 7th param must be a number");
-        DEV: assert(isFinite(h2), "colrect: 8th param must be a number");
-        return x1 < x2 + w2 && x1 + w1 > x2 && y1 < y2 + h2 && y1 + h1 > y2;
-      },
-      /**
-       * Check a collision between two circles
-       *
-       * @param {number} x1 first circle position X
-       * @param {number} y1 first circle position Y
-       * @param {number} r1 first circle position radius
-       * @param {number} x2 second circle position X
-       * @param {number} y2 second circle position Y
-       * @param {number} r2 second circle position radius
-       * @returns {boolean}
-       */
-      colcirc: (x1, y1, r1, x2, y2, r2) => {
-        DEV: assert(isFinite(x1), "colcirc: 1st param must be a number");
-        DEV: assert(isFinite(y1), "colcirc: 2nd param must be a number");
-        DEV: assert(isFinite(r1), "colcirc: 3rd param must be a number");
-        DEV: assert(isFinite(x2), "colcirc: 4th param must be a number");
-        DEV: assert(isFinite(y2), "colcirc: 5th param must be a number");
-        DEV: 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 */
       /**
        * Prepares a plugin to be loaded
@@ -982,22 +956,22 @@
        * Stops the litecanvas instance and remove all event listeners.
        */
       quit() {
+        cancelAnimationFrame(_rafid);
         instance.emit("quit");
+        _events = [];
         for (const removeListener of _browserEventListeners) {
           removeListener();
         }
-        cancelAnimationFrame(_rafid);
-        _events = false;
         if (_global) {
           for (const key in instance) {
             delete root[key];
           }
-          delete root.__litecanvas;
+          delete root.ENGINE;
         }
       }
     };
-    for (const k of "PI,sin,cos,atan2,hypot,tan,abs,ceil,round,floor,trunc,min,max,pow,sqrt,sign,exp".split(",")) {
-      instance[k] = Math[k];
+    for (const k of "PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp".split(",")) {
+      instance[k] = math[k];
     }
     function init() {
       _initialized = true;
@@ -1008,7 +982,7 @@
       for (const [callback, config] of _plugins) {
         loadPlugin(callback, config);
       }
-      if (_autoscale) {
+      if (settings.autoscale) {
         on(root, "resize", onResize);
       }
       if (settings.tapEvents) {
@@ -1030,7 +1004,7 @@
           const tap = _taps.get(id) || _registerTap(id);
           tap.x = x;
           tap.y = y;
-        }, _checkTapped = (tap) => tap && performance.now() - tap.ts <= 200, preventDefault = (ev) => ev.preventDefault();
+        }, _checkTapped = (tap) => tap && performance.now() - tap.ts <= 300, preventDefault = (ev) => ev.preventDefault();
         let _pressingMouse = false;
         on(_canvas, "mousedown", (ev) => {
           if (ev.button === 0) {
@@ -1109,22 +1083,59 @@
         });
       }
       if (settings.keyboardEvents) {
-        const _keys = /* @__PURE__ */ new Set();
-        const iskeydown = (key) => {
-          DEV: assert(
-            "string" === typeof key,
-            "iskeydown: 1st param must be a string"
+        const toLowerCase = (s) => s.toLowerCase();
+        const _keysDown = /* @__PURE__ */ new Set();
+        const _keysPress = /* @__PURE__ */ new Set();
+        const keyCheck = (keysSet, key) => {
+          return !key ? keysSet.size > 0 : keysSet.has(
+            "space" === toLowerCase(key) ? " " : toLowerCase(key)
           );
-          return "any" === key ? _keys.size > 0 : _keys.has(key.toLowerCase());
         };
-        instance.setvar("iskeydown", iskeydown);
         on(root, "keydown", (event) => {
-          _keys.add(event.key.toLowerCase());
+          if (!_keysDown.has(toLowerCase(event.key))) {
+            _keysDown.add(toLowerCase(event.key));
+            _keysPress.add(toLowerCase(event.key));
+          }
         });
         on(root, "keyup", (event) => {
-          _keys.delete(event.key.toLowerCase());
+          _keysDown.delete(toLowerCase(event.key));
         });
-        on(root, "blur", () => _keys.clear());
+        on(root, "blur", () => _keysDown.clear());
+        instance.listen("after:draw", () => _keysPress.clear());
+        instance.setvar(
+          "iskeydown",
+          /**
+           * Checks if a which key is pressed (down) on the keyboard.
+           * Note: use `iskeydown()` to check for any key.
+           *
+           * @param {string?} key
+           * @returns {boolean}
+           */
+          (key) => {
+            DEV: assert(
+              null == key || "string" === typeof key,
+              "iskeydown: 1st param must be a string or undefined"
+            );
+            return keyCheck(_keysDown, key);
+          }
+        );
+        instance.setvar(
+          "iskeypressed",
+          /**
+           * Checks if a which key just got pressed on the keyboard.
+           * Note: use `iskeypressed()` to check for any key.
+           *
+           * @param {string?} key
+           * @returns {boolean}
+           */
+          (key) => {
+            DEV: assert(
+              null == key || "string" === typeof key,
+              "iskeypressed: 1st param must be a string or undefined"
+            );
+            return keyCheck(_keysPress, key);
+          }
+        );
       }
       if (settings.pauseOnBlur) {
         on(root, "blur", () => {
@@ -1136,7 +1147,6 @@
           }
         });
       }
-      instance.setfps(60);
       instance.emit("init", instance);
       _lastFrameTime = performance.now();
       _rafid = raf(drawFrame);
@@ -1148,7 +1158,7 @@
       let updated = 0, frameTime = (now - _lastFrameTime) / 1e3;
       _lastFrameTime = now;
       if (frameTime > _deltaTime * 30) {
-        console.log("skipping too long frame");
+        console.warn("skipping too long frame");
       } else {
         _accumulated += frameTime;
         if (!_animated) {
@@ -1199,12 +1209,12 @@
     }
     function onResize() {
       const styles = _canvas.style;
-      if (_autoscale) {
+      if (settings.autoscale) {
         if (!styles.display) {
           styles.display = "block";
           styles.margin = "auto";
         }
-        _scale = Math.min(
+        _scale = math.min(
           root.innerWidth / instance.WIDTH,
           root.innerHeight / instance.HEIGHT
         );
@@ -1238,11 +1248,11 @@
       }
     }
     if (_global) {
-      if (root.__litecanvas) {
-        throw "global litecanvas already instantiated";
+      if (root.ENGINE) {
+        throw "two global litecanvas detected";
       }
       Object.assign(root, instance);
-      root.__litecanvas = instance;
+      root.ENGINE = instance;
     }
     setupCanvas();
     if ("loading" === document.readyState) {

package/dist/dist.js

@@ -25,7 +25,7 @@
 
   // src/index.js
   function litecanvas(settings = {}) {
-    const root = globalThis, PI = Math.PI, TWO_PI = PI * 2, raf = requestAnimationFrame, _browserEventListeners = [], on = (elem, evt, callback) => {
+    const root = globalThis, math = Math, PI = math.PI, TWO_PI = PI * 2, raf = requestAnimationFrame, _browserEventListeners = [], on = (elem, evt, callback) => {
       elem.addEventListener(evt, callback, false);
       _browserEventListeners.push(
         () => elem.removeEventListener(evt, callback, false)
@@ -45,7 +45,7 @@
       animate: true
     };
     settings = Object.assign(defaults, settings);
-    let _initialized = false, _plugins = [], _canvas = settings.canvas || document.createElement("canvas"), _autoscale = settings.autoscale, _animated = settings.animate, _scale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _deltaTime, _accumulated = 0, _rafid, _fontFamily = "sans-serif", _fontSize = 32, _rng_seed = Date.now(), _global = settings.global, _events = {
+    let _initialized = false, _plugins = [], _canvas = settings.canvas || document.createElement("canvas"), _animated = settings.animate, _scale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _deltaTime = 1 / 60, _accumulated = 0, _rafid, _fontFamily = "sans-serif", _fontSize = 18, _rng_seed = Date.now(), _global = settings.global, _events = {
       init: null,
       update: null,
       draw: null,
@@ -125,6 +125,20 @@
       rad2deg: (rads) => {
         return 180 / PI * rads;
       },
+      /**
+       * Calculates the integer closest to a number and optional precision.
+       *
+       * @param {number} n number to round.
+       * @param {number} [precision] number of decimal digits to round to, default is 0.
+       * @returns {number} rounded number.
+       */
+      round: (n, precision = 0) => {
+        if (!precision) {
+          return math.round(n);
+        }
+        const multiplier = 10 ** precision;
+        return math.round(n * multiplier) / multiplier;
+      },
       /**
        * Constrains a number between `min` and `max`.
        *
@@ -147,7 +161,7 @@
        * @returns {number}
        */
       wrap: (value, min, max) => {
-        return value - (max - min) * Math.floor((value - min) / (max - min));
+        return value - (max - min) * math.floor((value - min) / (max - min));
       },
       /**
        * Re-maps a number from one range to another.
@@ -201,7 +215,7 @@
        * @returns {number} the random number
        */
       randi: (min = 0, max = 1) => {
-        return Math.floor(instance.rand(min, max + 1));
+        return math.floor(instance.rand(min, max + 1));
       },
       /**
        * If a value is passed, initializes the random number generator with an explicit seed value.
@@ -217,7 +231,7 @@
       /**
        * Clear the game screen with an optional color
        *
-       * @param {number?} color The background color (index) or null (for transparent)
+       * @param {number?} color The background color (index) or null/undefined (for transparent)
        */
       cls(color) {
         if (null == color) {
@@ -574,37 +588,6 @@
       volume(value) {
         root.zzfxV = value;
       },
-      /** UTILS API */
-      /**
-       * Check a collision between two rectangles
-       *
-       * @param {number} x1 first rectangle position X
-       * @param {number} y1 first rectangle position Y
-       * @param {number} w1 first rectangle width
-       * @param {number} h1 first rectangle height
-       * @param {number} x2 second rectangle position X
-       * @param {number} y2 second rectangle position Y
-       * @param {number} w2 second rectangle width
-       * @param {number} h2 second rectangle height
-       * @returns {boolean}
-       */
-      colrect: (x1, y1, w1, h1, x2, y2, w2, h2) => {
-        return x1 < x2 + w2 && x1 + w1 > x2 && y1 < y2 + h2 && y1 + h1 > y2;
-      },
-      /**
-       * Check a collision between two circles
-       *
-       * @param {number} x1 first circle position X
-       * @param {number} y1 first circle position Y
-       * @param {number} r1 first circle position radius
-       * @param {number} x2 second circle position X
-       * @param {number} y2 second circle position Y
-       * @param {number} r2 second circle position radius
-       * @returns {boolean}
-       */
-      colcirc: (x1, y1, r1, x2, y2, r2) => {
-        return (x2 - x1) * (x2 - x1) + (y2 - y1) * (y2 - y1) <= (r1 + r2) * (r1 + r2);
-      },
       /** PLUGINS API */
       /**
        * Prepares a plugin to be loaded
@@ -700,22 +683,22 @@
        * Stops the litecanvas instance and remove all event listeners.
        */
       quit() {
+        cancelAnimationFrame(_rafid);
         instance.emit("quit");
+        _events = [];
         for (const removeListener of _browserEventListeners) {
           removeListener();
         }
-        cancelAnimationFrame(_rafid);
-        _events = false;
         if (_global) {
           for (const key in instance) {
             delete root[key];
           }
-          delete root.__litecanvas;
+          delete root.ENGINE;
         }
       }
     };
-    for (const k of "PI,sin,cos,atan2,hypot,tan,abs,ceil,round,floor,trunc,min,max,pow,sqrt,sign,exp".split(",")) {
-      instance[k] = Math[k];
+    for (const k of "PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp".split(",")) {
+      instance[k] = math[k];
     }
     function init() {
       _initialized = true;
@@ -726,7 +709,7 @@
       for (const [callback, config] of _plugins) {
         loadPlugin(callback, config);
       }
-      if (_autoscale) {
+      if (settings.autoscale) {
         on(root, "resize", onResize);
       }
       if (settings.tapEvents) {
@@ -748,7 +731,7 @@
           const tap = _taps.get(id) || _registerTap(id);
           tap.x = x;
           tap.y = y;
-        }, _checkTapped = (tap) => tap && performance.now() - tap.ts <= 200, preventDefault = (ev) => ev.preventDefault();
+        }, _checkTapped = (tap) => tap && performance.now() - tap.ts <= 300, preventDefault = (ev) => ev.preventDefault();
         let _pressingMouse = false;
         on(_canvas, "mousedown", (ev) => {
           if (ev.button === 0) {
@@ -827,18 +810,51 @@
         });
       }
       if (settings.keyboardEvents) {
-        const _keys = /* @__PURE__ */ new Set();
-        const iskeydown = (key) => {
-          return "any" === key ? _keys.size > 0 : _keys.has(key.toLowerCase());
+        const toLowerCase = (s) => s.toLowerCase();
+        const _keysDown = /* @__PURE__ */ new Set();
+        const _keysPress = /* @__PURE__ */ new Set();
+        const keyCheck = (keysSet, key) => {
+          return !key ? keysSet.size > 0 : keysSet.has(
+            "space" === toLowerCase(key) ? " " : toLowerCase(key)
+          );
         };
-        instance.setvar("iskeydown", iskeydown);
         on(root, "keydown", (event) => {
-          _keys.add(event.key.toLowerCase());
+          if (!_keysDown.has(toLowerCase(event.key))) {
+            _keysDown.add(toLowerCase(event.key));
+            _keysPress.add(toLowerCase(event.key));
+          }
         });
         on(root, "keyup", (event) => {
-          _keys.delete(event.key.toLowerCase());
+          _keysDown.delete(toLowerCase(event.key));
         });
-        on(root, "blur", () => _keys.clear());
+        on(root, "blur", () => _keysDown.clear());
+        instance.listen("after:draw", () => _keysPress.clear());
+        instance.setvar(
+          "iskeydown",
+          /**
+           * Checks if a which key is pressed (down) on the keyboard.
+           * Note: use `iskeydown()` to check for any key.
+           *
+           * @param {string?} key
+           * @returns {boolean}
+           */
+          (key) => {
+            return keyCheck(_keysDown, key);
+          }
+        );
+        instance.setvar(
+          "iskeypressed",
+          /**
+           * Checks if a which key just got pressed on the keyboard.
+           * Note: use `iskeypressed()` to check for any key.
+           *
+           * @param {string?} key
+           * @returns {boolean}
+           */
+          (key) => {
+            return keyCheck(_keysPress, key);
+          }
+        );
       }
       if (settings.pauseOnBlur) {
         on(root, "blur", () => {
@@ -850,7 +866,6 @@
           }
         });
       }
-      instance.setfps(60);
       instance.emit("init", instance);
       _lastFrameTime = performance.now();
       _rafid = raf(drawFrame);
@@ -896,12 +911,12 @@
     }
     function onResize() {
       const styles = _canvas.style;
-      if (_autoscale) {
+      if (settings.autoscale) {
         if (!styles.display) {
           styles.display = "block";
           styles.margin = "auto";
         }
-        _scale = Math.min(
+        _scale = math.min(
           root.innerWidth / instance.WIDTH,
           root.innerHeight / instance.HEIGHT
         );
@@ -931,11 +946,11 @@
       }
     }
     if (_global) {
-      if (root.__litecanvas) {
-        throw "global litecanvas already instantiated";
+      if (root.ENGINE) {
+        throw "two global litecanvas detected";
       }
       Object.assign(root, instance);
-      root.__litecanvas = instance;
+      root.ENGINE = instance;
     }
     setupCanvas();
     if ("loading" === document.readyState) {

package/dist/dist.min.js

@@ -1 +1 @@
-(()=>{var e=new AudioContext,t=(t=1,a=.05,l=220,n=0,i=0,o=.1,r=0,s=1,c=0,f=0,d=0,p=0,u=0,h=0,g=0,m=0,v=0,E=1,b=0,x=0,T=0)=>{let w=Math,y=2*w.PI,H=c*=500*y/44100/44100,I=l*=(1-a+2*a*w.random(a=[]))*y/44100,S=0,D=0,A=0,k=1,C=0,L=0,X=0,z=T<0?-1:1,P=y*z*T*2/44100,M=w.cos(P),O=w.sin,Y=O(P)/4,F=1+Y,W=-2*M/F,_=(1-Y)/F,R=(1+z*M)/2/F,G=-(z+M)/F,N=0,B=0,U=0,q=0;for(n=44100*n+9,b*=44100,i*=44100,o*=44100,v*=44100,f*=500*y/85766121e6,g*=y/44100,d*=y/44100,p*=44100,u=44100*u|0,t*=.3*(globalThis.zzfxV||1),z=n+b+i+o+v|0;A<z;a[A++]=X*t)++L%(100*m|0)||(X=r?1<r?2<r?3<r?O(S*S):w.max(w.min(w.tan(S),1),-1):1-(2*S/y%2+2)%2:1-4*w.abs(w.round(S/y)-S/y):O(S),X=(u?1-x+x*O(y*A/u):1)*(X<0?-1:1)*w.abs(X)**s*(A<n?A/n:A<n+b?1-(A-n)/b*(1-E):A<n+b+i?E:A<z-v?(z-A-v)/o*E:0),X=v?X/2+(v>A?0:(A<z-v?1:(z-A)/v)*a[A-v|0]/2/t):X,T&&(X=q=R*N+G*(N=B)+R*(B=X)-_*U-W*(U=q))),S+=(P=(l+=c+=f)*w.cos(g*D++))+P*h*O(A**5),k&&++k>p&&(l+=d,I+=d,k=0),!u||++C%u||(l=I,c=H,k=k||1);(t=e.createBuffer(1,z,44100)).getChannelData(0).set(a),(l=e.createBufferSource()).buffer=t,l.connect(e.destination),l.start()},a=["#111","#6a7799","#aec2c2","#FFF1E8","#e83b3b","#fabc20","#155fd9","#3cbcfc","#327345","#63c64d","#6c2c1f","#ac7c00"];globalThis.litecanvas=function(e={}){let l=globalThis,n=Math.PI,i=2*n,o=requestAnimationFrame,r=[],s=(e,t,a)=>{e.addEventListener(t,a,!1),r.push(()=>e.removeEventListener(t,a,!1))};e=Object.assign({width:null,height:null,autoscale:!0,pixelart:!1,antialias:!1,canvas:null,global:!0,loop:null,pauseOnBlur:!0,tapEvents:!0,keyboardEvents:!0,animate:!0},e);let c=!1,f=[],d=e.canvas||document.createElement("canvas"),p=e.autoscale,u=e.animate,h=1,g,m=.5,v=1,E,b,x=0,T,w="sans-serif",y=32,H=Date.now(),I=e.global,S={init:null,update:null,draw:null,resized:null,tap:null,untap:null,tapping:null,tapped:null},D={settings:Object.assign({},e),colors:a},A={WIDTH:e.width,HEIGHT:e.height||e.width,CANVAS:null,ELAPSED:0,CENTERX:0,CENTERY:0,MOUSEX:-1,MOUSEY:-1,DEFAULT_SFX:[.5,,1675,,.06,.2,1,1.8,,,637,.06],TWO_PI:i,HALF_PI:n/2,lerp:(e,t,a)=>a*(t-e)+e,deg2rad:e=>n/180*e,rad2deg:e=>180/n*e,clamp:(e,t,a)=>e<t?t:e>a?a:e,wrap:(e,t,a)=>e-(a-t)*Math.floor((e-t)/(a-t)),map(e,t,a,l,n,i){let o=(e-t)/(a-t)*(n-l)+l;return i?A.clamp(o,l,n):o},norm:(e,t,a)=>A.map(e,t,a,0,1),rand:(e=0,t=1)=>(H=(1664525*H+0x3c6ef35f)%0x100000000)/0x100000000*(t-e)+e,randi:(e=0,t=1)=>Math.floor(A.rand(e,t+1)),seed:e=>null==e?H:H=~~e,cls(e){null==e?g.clearRect(0,0,g.canvas.width,g.canvas.height):A.rectfill(0,0,g.canvas.width,g.canvas.height,e)},rect(e,t,a,l,n,i=null){g.beginPath(),g[i?"roundRect":"rect"](~~e-m,~~t-m,~~a+2*m,~~l+2*m,i),A.stroke(n)},rectfill(e,t,a,l,n,i=null){g.beginPath(),g[i?"roundRect":"rect"](~~e,~~t,~~a,~~l,i),A.fill(n)},circ(e,t,a,l){g.beginPath(),g.arc(~~e,~~t,~~a,0,i),A.stroke(l)},circfill(e,t,a,l){g.beginPath(),g.arc(~~e,~~t,~~a,0,i),A.fill(l)},line(e,t,a,l,n){g.beginPath();let i=.5*(0!==m&&~~e==~~a),o=.5*(0!==m&&~~t==~~l);g.moveTo(~~e+i,~~t+o),g.lineTo(~~a+i,~~l+o),A.stroke(n)},linewidth(e){g.lineWidth=~~e,m=.5*(~~e%2!=0)},linedash(e,t=0){g.setLineDash(e),g.lineDashOffset=t},text(e,t,a,l=3,n="normal"){g.font=`${n} ${y}px ${w}`,g.fillStyle=A.getcolor(l),g.fillText(a,~~e,~~t)},textfont(e){w=e},textsize(e){y=e},textalign(e,t){e&&(g.textAlign=e),t&&(g.textBaseline=t)},image(e,t,a){g.drawImage(a,~~e,~~t)},paint(e,t,a,l={}){let n=l.canvas||new OffscreenCanvas(1,1),i=l.scale||1,o=g;if(n.width=e*i,n.height=t*i,(g=n.getContext("2d")).scale(i,i),a.push){let e=0,t=0;for(let l of(g.imageSmoothingEnabled=!1,a)){for(let a of l)" "!==a&&"."!==a&&A.rectfill(e,t,1,1,parseInt(a,16)),e++;t++,e=0}}else a(g);return g=o,n},ctx:e=>(e&&(g=e),g),push:()=>g.save(),pop:()=>g.restore(),translate:(e,t)=>g.translate(~~e,~~t),scale:(e,t)=>g.scale(e,t||e),rotate:e=>g.rotate(e),alpha(e){g.globalAlpha=A.clamp(e,0,1)},path:e=>new Path2D(e),fill(e,t){g.fillStyle=A.getcolor(e),t?g.fill(t):g.fill()},stroke(e,t){g.strokeStyle=A.getcolor(e),t?g.stroke(t):g.stroke()},clip(e){g.clip(e)},sfx:(e,a=0,n=1)=>!(l.zzfxV<=0)&&(!navigator.userActivation||!!navigator.userActivation.hasBeenActive)&&(e=e||A.DEFAULT_SFX,(0!==a||1!==n)&&((e=e.slice())[0]=n*(e[0]||1),e[10]=~~e[10]+a),t.apply(0,e),e),volume(e){l.zzfxV=e},colrect:(e,t,a,l,n,i,o,r)=>e<n+o&&e+a>n&&t<i+r&&t+l>i,colcirc:(e,t,a,l,n,i)=>(l-e)*(l-e)+(n-t)*(n-t)<=(a+i)*(a+i),use(e,t={}){c?z(e,t):f.push([e,t])},listen:(e,t)=>(S[e]=S[e]||new Set,S[e].add(t),()=>S[e].delete(t)),emit(e,t,a,l,n){c&&(X("before:"+e,t,a,l,n),X(e,t,a,l,n),X("after:"+e,t,a,l,n))},getcolor:e=>a[~~e%a.length],setvar(e,t){A[e]=t,I&&(l[e]=t)},resize(e,t){A.setvar("WIDTH",d.width=e),A.setvar("HEIGHT",d.height=t),A.setvar("CENTERX",A.WIDTH/2),A.setvar("CENTERY",A.HEIGHT/2),L()},timescale(e){v=e},setfps(e){b=1/~~e},quit(){for(let e of(A.emit("quit"),r))e();if(cancelAnimationFrame(T),S=!1,I){for(let e in A)delete l[e];delete l.__litecanvas}}};for(let e of"PI,sin,cos,atan2,hypot,tan,abs,ceil,round,floor,trunc,min,max,pow,sqrt,sign,exp".split(","))A[e]=Math[e];function k(){c=!0;let t=e.loop?e.loop:l;for(let e in S)t[e]&&A.listen(e,t[e]);for(let[e,t]of f)z(e,t);if(p&&s(l,"resize",L),e.tapEvents){let e=(e,t)=>[(e-d.offsetLeft)/h,(t-d.offsetTop)/h],t=new Map,a=(e,a,l)=>{let n={x:a,y:l,startX:a,startY:l,ts:performance.now()};return t.set(e,n),n},n=(e,l,n)=>{let i=t.get(e)||a(e);i.x=l,i.y=n},i=e=>e&&performance.now()-e.ts<=200,o=e=>e.preventDefault(),r=!1;s(d,"mousedown",t=>{if(0===t.button){o(t);let[l,n]=e(t.pageX,t.pageY);A.emit("tap",l,n,0),a(0,l,n),r=!0}}),s(d,"mouseup",a=>{if(0===a.button){o(a);let l=t.get(0),[n,s]=e(a.pageX,a.pageY);i(l)&&A.emit("tapped",l.startX,l.startY,0),A.emit("untap",n,s,0),t.delete(0),r=!1}}),s(d,"mousemove",t=>{o(t);let[a,l]=e(t.pageX,t.pageY);A.setvar("MOUSEX",a),A.setvar("MOUSEY",l),r&&(A.emit("tapping",a,l,0),n(0,a,l))}),s(d,"touchstart",t=>{for(let l of(o(t),t.changedTouches)){let[t,n]=e(l.pageX,l.pageY);A.emit("tap",t,n,l.identifier+1),a(l.identifier+1,t,n)}}),s(d,"touchmove",t=>{for(let a of(o(t),t.changedTouches)){let[t,l]=e(a.pageX,a.pageY);A.emit("tapping",t,l,a.identifier+1),n(a.identifier+1,t,l)}});let c=e=>{o(e);let a=[];if(e.targetTouches.length>0)for(let t of e.targetTouches)a.push(t.identifier+1);for(let[e,l]of t)a.includes(e)||(i(l)&&A.emit("tapped",l.startX,l.startY,e),A.emit("untap",l.x,l.y,e),t.delete(e))};s(d,"touchend",c),s(d,"touchcancel",c),s(l,"blur",()=>{for(let[e,a]of(r=!1,t))A.emit("untap",a.x,a.y,e),t.delete(e)})}if(e.keyboardEvents){let e=new Set;A.setvar("iskeydown",t=>"any"===t?e.size>0:e.has(t.toLowerCase())),s(l,"keydown",t=>{e.add(t.key.toLowerCase())}),s(l,"keyup",t=>{e.delete(t.key.toLowerCase())}),s(l,"blur",()=>e.clear())}e.pauseOnBlur&&(s(l,"blur",()=>{T=cancelAnimationFrame(T)}),s(l,"focus",()=>{T||(T=o(C))})),A.setfps(60),A.emit("init",A),E=performance.now(),T=o(C)}function C(e){u&&(T=o(C));let t=0,a=(e-E)/1e3;if(E=e,a>30*b);else for(x+=a,u||(x=b);x>=b;x-=b)A.emit("update",b*v),A.setvar("ELAPSED",A.ELAPSED+b*v),t++;(t||!u)&&(A.textalign("start","top"),A.emit("draw"))}function L(){let t=d.style;p&&(t.display||(t.display="block",t.margin="auto"),h=Math.min(l.innerWidth/A.WIDTH,l.innerHeight/A.HEIGHT),h=(e.pixelart?~~h:h)||1,t.width=A.WIDTH*h+"px",t.height=A.HEIGHT*h+"px"),(!e.antialias||e.pixelart)&&(g.imageSmoothingEnabled=!1,t.imageRendering="pixelated"),A.emit("resized",h),u||o(C)}function X(e,t,a,l,n){if(S[e])for(let i of S[e])i(t,a,l,n)}function z(e,t){let a=e(A,D,t);for(let e in a)A.setvar(e,a[e])}if(I){if(l.__litecanvas)throw"global litecanvas already instantiated";Object.assign(l,A),l.__litecanvas=A}return d="string"==typeof d?document.querySelector(d):d,A.setvar("CANVAS",d),g=d.getContext("2d"),s(d,"click",()=>l.focus()),d.style="",A.WIDTH||(A.WIDTH=l.innerWidth,A.HEIGHT=l.innerHeight),A.resize(A.WIDTH,A.HEIGHT,!1),d.parentNode||document.body.appendChild(d),"loading"===document.readyState?s(l,"DOMContentLoaded",()=>o(k)):o(k),A}})();
+(()=>{var e=new AudioContext,t=(t=1,a=.05,l=220,n=0,i=0,r=.1,o=0,s=1,c=0,f=0,d=0,u=0,p=0,g=0,h=0,m=0,E=0,v=1,b=0,w=0,x=0)=>{let T=Math,y=2*T.PI,H=c*=500*y/44100/44100,I=l*=(1-a+2*a*T.random(a=[]))*y/44100,S=0,D=0,k=0,A=1,C=0,X=0,z=0,N=x<0?-1:1,P=y*N*x*2/44100,L=T.cos(P),O=T.sin,Y=O(P)/4,F=1+Y,W=-2*L/F,G=(1-Y)/F,M=(1+N*L)/2/F,R=-(N+L)/F,B=0,U=0,q=0,V=0;for(n=44100*n+9,b*=44100,i*=44100,r*=44100,E*=44100,f*=500*y/85766121e6,h*=y/44100,d*=y/44100,u*=44100,p=44100*p|0,t*=.3*(globalThis.zzfxV||1),N=n+b+i+r+E|0;k<N;a[k++]=z*t)++X%(100*m|0)||(z=o?1<o?2<o?3<o?O(S*S):T.max(T.min(T.tan(S),1),-1):1-(2*S/y%2+2)%2:1-4*T.abs(T.round(S/y)-S/y):O(S),z=(p?1-w+w*O(y*k/p):1)*(z<0?-1:1)*T.abs(z)**s*(k<n?k/n:k<n+b?1-(k-n)/b*(1-v):k<n+b+i?v:k<N-E?(N-k-E)/r*v:0),z=E?z/2+(E>k?0:(k<N-E?1:(N-k)/E)*a[k-E|0]/2/t):z,x&&(z=V=M*B+R*(B=U)+M*(U=z)-G*q-W*(q=V))),S+=(P=(l+=c+=f)*T.cos(h*D++))+P*g*O(k**5),A&&++A>u&&(l+=d,I+=d,A=0),!p||++C%p||(l=I,c=H,A=A||1);(t=e.createBuffer(1,N,44100)).getChannelData(0).set(a),(l=e.createBufferSource()).buffer=t,l.connect(e.destination),l.start()},a=["#111","#6a7799","#aec2c2","#FFF1E8","#e83b3b","#fabc20","#155fd9","#3cbcfc","#327345","#63c64d","#6c2c1f","#ac7c00"];globalThis.litecanvas=function(e={}){let l=globalThis,n=Math,i=n.PI,r=2*i,o=requestAnimationFrame,s=[],c=(e,t,a)=>{e.addEventListener(t,a,!1),s.push(()=>e.removeEventListener(t,a,!1))};e=Object.assign({width:null,height:null,autoscale:!0,pixelart:!1,antialias:!1,canvas:null,global:!0,loop:null,pauseOnBlur:!0,tapEvents:!0,keyboardEvents:!0,animate:!0},e);let f=!1,d=[],u=e.canvas||document.createElement("canvas"),p=e.animate,g=1,h,m=.5,E=1,v,b=1/60,w=0,x,T="sans-serif",y=18,H=Date.now(),I=e.global,S={init:null,update:null,draw:null,resized:null,tap:null,untap:null,tapping:null,tapped:null},D={settings:Object.assign({},e),colors:a},k={WIDTH:e.width,HEIGHT:e.height||e.width,CANVAS:null,ELAPSED:0,CENTERX:0,CENTERY:0,MOUSEX:-1,MOUSEY:-1,DEFAULT_SFX:[.5,,1675,,.06,.2,1,1.8,,,637,.06],TWO_PI:r,HALF_PI:i/2,lerp:(e,t,a)=>a*(t-e)+e,deg2rad:e=>i/180*e,rad2deg:e=>180/i*e,round:(e,t=0)=>{if(!t)return n.round(e);let a=10**t;return n.round(e*a)/a},clamp:(e,t,a)=>e<t?t:e>a?a:e,wrap:(e,t,a)=>e-(a-t)*n.floor((e-t)/(a-t)),map(e,t,a,l,n,i){let r=(e-t)/(a-t)*(n-l)+l;return i?k.clamp(r,l,n):r},norm:(e,t,a)=>k.map(e,t,a,0,1),rand:(e=0,t=1)=>(H=(1664525*H+0x3c6ef35f)%0x100000000)/0x100000000*(t-e)+e,randi:(e=0,t=1)=>n.floor(k.rand(e,t+1)),seed:e=>null==e?H:H=~~e,cls(e){null==e?h.clearRect(0,0,h.canvas.width,h.canvas.height):k.rectfill(0,0,h.canvas.width,h.canvas.height,e)},rect(e,t,a,l,n,i=null){h.beginPath(),h[i?"roundRect":"rect"](~~e-m,~~t-m,~~a+2*m,~~l+2*m,i),k.stroke(n)},rectfill(e,t,a,l,n,i=null){h.beginPath(),h[i?"roundRect":"rect"](~~e,~~t,~~a,~~l,i),k.fill(n)},circ(e,t,a,l){h.beginPath(),h.arc(~~e,~~t,~~a,0,r),k.stroke(l)},circfill(e,t,a,l){h.beginPath(),h.arc(~~e,~~t,~~a,0,r),k.fill(l)},line(e,t,a,l,n){h.beginPath();let i=.5*(0!==m&&~~e==~~a),r=.5*(0!==m&&~~t==~~l);h.moveTo(~~e+i,~~t+r),h.lineTo(~~a+i,~~l+r),k.stroke(n)},linewidth(e){h.lineWidth=~~e,m=.5*(~~e%2!=0)},linedash(e,t=0){h.setLineDash(e),h.lineDashOffset=t},text(e,t,a,l=3,n="normal"){h.font=`${n} ${y}px ${T}`,h.fillStyle=k.getcolor(l),h.fillText(a,~~e,~~t)},textfont(e){T=e},textsize(e){y=e},textalign(e,t){e&&(h.textAlign=e),t&&(h.textBaseline=t)},image(e,t,a){h.drawImage(a,~~e,~~t)},paint(e,t,a,l={}){let n=l.canvas||new OffscreenCanvas(1,1),i=l.scale||1,r=h;if(n.width=e*i,n.height=t*i,(h=n.getContext("2d")).scale(i,i),a.push){let e=0,t=0;for(let l of(h.imageSmoothingEnabled=!1,a)){for(let a of l)" "!==a&&"."!==a&&k.rectfill(e,t,1,1,parseInt(a,16)),e++;t++,e=0}}else a(h);return h=r,n},ctx:e=>(e&&(h=e),h),push:()=>h.save(),pop:()=>h.restore(),translate:(e,t)=>h.translate(~~e,~~t),scale:(e,t)=>h.scale(e,t||e),rotate:e=>h.rotate(e),alpha(e){h.globalAlpha=k.clamp(e,0,1)},path:e=>new Path2D(e),fill(e,t){h.fillStyle=k.getcolor(e),t?h.fill(t):h.fill()},stroke(e,t){h.strokeStyle=k.getcolor(e),t?h.stroke(t):h.stroke()},clip(e){h.clip(e)},sfx:(e,a=0,n=1)=>!(l.zzfxV<=0)&&(!navigator.userActivation||!!navigator.userActivation.hasBeenActive)&&(e=e||k.DEFAULT_SFX,(0!==a||1!==n)&&((e=e.slice())[0]=n*(e[0]||1),e[10]=~~e[10]+a),t.apply(0,e),e),volume(e){l.zzfxV=e},use(e,t={}){f?N(e,t):d.push([e,t])},listen:(e,t)=>(S[e]=S[e]||new Set,S[e].add(t),()=>S[e].delete(t)),emit(e,t,a,l,n){f&&(z("before:"+e,t,a,l,n),z(e,t,a,l,n),z("after:"+e,t,a,l,n))},getcolor:e=>a[~~e%a.length],setvar(e,t){k[e]=t,I&&(l[e]=t)},resize(e,t){k.setvar("WIDTH",u.width=e),k.setvar("HEIGHT",u.height=t),k.setvar("CENTERX",k.WIDTH/2),k.setvar("CENTERY",k.HEIGHT/2),X()},timescale(e){E=e},setfps(e){b=1/~~e},quit(){for(let e of(cancelAnimationFrame(x),k.emit("quit"),S=[],s))e();if(I){for(let e in k)delete l[e];delete l.ENGINE}}};for(let e of"PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp".split(","))k[e]=n[e];function A(){f=!0;let t=e.loop?e.loop:l;for(let e in S)t[e]&&k.listen(e,t[e]);for(let[e,t]of d)N(e,t);if(e.autoscale&&c(l,"resize",X),e.tapEvents){let e=(e,t)=>[(e-u.offsetLeft)/g,(t-u.offsetTop)/g],t=new Map,a=(e,a,l)=>{let n={x:a,y:l,startX:a,startY:l,ts:performance.now()};return t.set(e,n),n},n=(e,l,n)=>{let i=t.get(e)||a(e);i.x=l,i.y=n},i=e=>e&&performance.now()-e.ts<=300,r=e=>e.preventDefault(),o=!1;c(u,"mousedown",t=>{if(0===t.button){r(t);let[l,n]=e(t.pageX,t.pageY);k.emit("tap",l,n,0),a(0,l,n),o=!0}}),c(u,"mouseup",a=>{if(0===a.button){r(a);let l=t.get(0),[n,s]=e(a.pageX,a.pageY);i(l)&&k.emit("tapped",l.startX,l.startY,0),k.emit("untap",n,s,0),t.delete(0),o=!1}}),c(u,"mousemove",t=>{r(t);let[a,l]=e(t.pageX,t.pageY);k.setvar("MOUSEX",a),k.setvar("MOUSEY",l),o&&(k.emit("tapping",a,l,0),n(0,a,l))}),c(u,"touchstart",t=>{for(let l of(r(t),t.changedTouches)){let[t,n]=e(l.pageX,l.pageY);k.emit("tap",t,n,l.identifier+1),a(l.identifier+1,t,n)}}),c(u,"touchmove",t=>{for(let a of(r(t),t.changedTouches)){let[t,l]=e(a.pageX,a.pageY);k.emit("tapping",t,l,a.identifier+1),n(a.identifier+1,t,l)}});let s=e=>{r(e);let a=[];if(e.targetTouches.length>0)for(let t of e.targetTouches)a.push(t.identifier+1);for(let[e,l]of t)a.includes(e)||(i(l)&&k.emit("tapped",l.startX,l.startY,e),k.emit("untap",l.x,l.y,e),t.delete(e))};c(u,"touchend",s),c(u,"touchcancel",s),c(l,"blur",()=>{for(let[e,a]of(o=!1,t))k.emit("untap",a.x,a.y,e),t.delete(e)})}if(e.keyboardEvents){let e=e=>e.toLowerCase(),t=new Set,a=new Set,n=(t,a)=>a?t.has("space"===e(a)?" ":e(a)):t.size>0;c(l,"keydown",l=>{t.has(e(l.key))||(t.add(e(l.key)),a.add(e(l.key)))}),c(l,"keyup",a=>{t.delete(e(a.key))}),c(l,"blur",()=>t.clear()),k.listen("after:draw",()=>a.clear()),k.setvar("iskeydown",e=>n(t,e)),k.setvar("iskeypressed",e=>n(a,e))}e.pauseOnBlur&&(c(l,"blur",()=>{x=cancelAnimationFrame(x)}),c(l,"focus",()=>{x||(x=o(C))})),k.emit("init",k),v=performance.now(),x=o(C)}function C(e){p&&(x=o(C));let t=0,a=(e-v)/1e3;if(v=e,a>30*b);else for(w+=a,p||(w=b);w>=b;w-=b)k.emit("update",b*E),k.setvar("ELAPSED",k.ELAPSED+b*E),t++;(t||!p)&&(k.textalign("start","top"),k.emit("draw"))}function X(){let t=u.style;e.autoscale&&(t.display||(t.display="block",t.margin="auto"),g=n.min(l.innerWidth/k.WIDTH,l.innerHeight/k.HEIGHT),g=(e.pixelart?~~g:g)||1,t.width=k.WIDTH*g+"px",t.height=k.HEIGHT*g+"px"),(!e.antialias||e.pixelart)&&(h.imageSmoothingEnabled=!1,t.imageRendering="pixelated"),k.emit("resized",g),p||o(C)}function z(e,t,a,l,n){if(S[e])for(let i of S[e])i(t,a,l,n)}function N(e,t){let a=e(k,D,t);for(let e in a)k.setvar(e,a[e])}if(I){if(l.ENGINE)throw"two global litecanvas detected";Object.assign(l,k),l.ENGINE=k}return u="string"==typeof u?document.querySelector(u):u,k.setvar("CANVAS",u),h=u.getContext("2d"),c(u,"click",()=>l.focus()),u.style="",k.WIDTH||(k.WIDTH=l.innerWidth,k.HEIGHT=l.innerHeight),k.resize(k.WIDTH,k.HEIGHT,!1),u.parentNode||document.body.appendChild(u),"loading"===document.readyState?c(l,"DOMContentLoaded",()=>o(A)):o(A),k}})();

package/package.json

@@ -1,12 +1,12 @@
 {
     "name": "litecanvas",
-    "version": "0.76.0",
+    "version": "0.78.0",
     "description": "Lightweight HTML5 canvas game engine suitable for small projects and creative coding. Inspired by PICO-8 and P5/Processing.",
     "license": "MIT",
     "author": "Luiz Bills <luizbills@pm.me>",
     "contributors": [],
     "devDependencies": {
-        "@swc/core": "^1.11.8",
+        "@swc/core": "^1.11.9",
         "ava": "^6.2.0",
         "esbuild": "^0.25.1",
         "gzip-size": "^7.0.0",

package/src/index.js

@@ -11,7 +11,8 @@ import './types.js'
  */
 export default function litecanvas(settings = {}) {
     const root = globalThis,
-        PI = Math.PI,
+        math = Math,
+        PI = math.PI,
         TWO_PI = PI * 2,
         raf = requestAnimationFrame,
         /** @type {Function[]} */
@@ -50,8 +51,6 @@ export default function litecanvas(settings = {}) {
         /** @type {HTMLCanvasElement|string} _canvas */
         _canvas = settings.canvas || document.createElement('canvas'),
         /** @type {boolean} */
-        _autoscale = settings.autoscale,
-        /** @type {boolean} */
         _animated = settings.animate,
         /** @type {number} */
         _scale = 1,
@@ -64,7 +63,7 @@ export default function litecanvas(settings = {}) {
         /** @type {number} */
         _lastFrameTime,
         /** @type {number} */
-        _deltaTime,
+        _deltaTime = 1 / 60,
         /** @type {number} */
         _accumulated = 0,
         /** @type {number} */
@@ -72,7 +71,7 @@ export default function litecanvas(settings = {}) {
         /** @type {string} */
         _fontFamily = 'sans-serif',
         /** @type {number} */
-        _fontSize = 32,
+        _fontSize = 18,
         /** @type {number} */
         _rng_seed = Date.now(),
         /** @type {boolean} */
@@ -191,6 +190,26 @@ export default function litecanvas(settings = {}) {
             return (180 / PI) * rads
         },
 
+        /**
+         * Calculates the integer closest to a number and optional precision.
+         *
+         * @param {number} n number to round.
+         * @param {number} [precision] number of decimal digits to round to, default is 0.
+         * @returns {number} rounded number.
+         */
+        round: (n, precision = 0) => {
+            DEV: assert(isFinite(n), 'round: 1st param must be a number')
+            DEV: assert(
+                null === precision || (isFinite(precision) && precision >= 0),
+                'round: 2nd param must be a positive number or zero'
+            )
+            if (!precision) {
+                return math.round(n)
+            }
+            const multiplier = 10 ** precision
+            return math.round(n * multiplier) / multiplier
+        },
+
         /**
          * Constrains a number between `min` and `max`.
          *
@@ -234,7 +253,7 @@ export default function litecanvas(settings = {}) {
                 'randi: the 2nd param must be not equal to the 3rd param'
             )
 
-            return value - (max - min) * Math.floor((value - min) / (max - min))
+            return value - (max - min) * math.floor((value - min) / (max - min))
         },
 
         /**
@@ -319,7 +338,7 @@ export default function litecanvas(settings = {}) {
                 'randi: the 1st param must be less than the 2nd param'
             )
 
-            return Math.floor(instance.rand(min, max + 1))
+            return math.floor(instance.rand(min, max + 1))
         },
 
         /**
@@ -342,12 +361,12 @@ export default function litecanvas(settings = {}) {
         /**
          * Clear the game screen with an optional color
          *
-         * @param {number?} color The background color (index) or null (for transparent)
+         * @param {number?} color The background color (index) or null/undefined (for transparent)
          */
         cls(color) {
             DEV: assert(
                 null == color || (isFinite(color) && color >= 0),
-                'cls: 1st param must be a positive number or zero or null'
+                'cls: 1st param must be a positive number or zero or undefined'
             )
 
             if (null == color) {
@@ -955,58 +974,6 @@ export default function litecanvas(settings = {}) {
             root.zzfxV = value
         },
 
-        /** UTILS API */
-        /**
-         * Check a collision between two rectangles
-         *
-         * @param {number} x1 first rectangle position X
-         * @param {number} y1 first rectangle position Y
-         * @param {number} w1 first rectangle width
-         * @param {number} h1 first rectangle height
-         * @param {number} x2 second rectangle position X
-         * @param {number} y2 second rectangle position Y
-         * @param {number} w2 second rectangle width
-         * @param {number} h2 second rectangle height
-         * @returns {boolean}
-         */
-        colrect: (x1, y1, w1, h1, x2, y2, w2, h2) => {
-            DEV: assert(isFinite(x1), 'colrect: 1st param must be a number')
-            DEV: assert(isFinite(y1), 'colrect: 2nd param must be a number')
-            DEV: assert(isFinite(w1), 'colrect: 3rd param must be a number')
-            DEV: assert(isFinite(h1), 'colrect: 4th param must be a number')
-            DEV: assert(isFinite(x2), 'colrect: 5th param must be a number')
-            DEV: assert(isFinite(y2), 'colrect: 6th param must be a number')
-            DEV: assert(isFinite(w2), 'colrect: 7th param must be a number')
-            DEV: assert(isFinite(h2), 'colrect: 8th param must be a number')
-
-            return x1 < x2 + w2 && x1 + w1 > x2 && y1 < y2 + h2 && y1 + h1 > y2
-        },
-
-        /**
-         * Check a collision between two circles
-         *
-         * @param {number} x1 first circle position X
-         * @param {number} y1 first circle position Y
-         * @param {number} r1 first circle position radius
-         * @param {number} x2 second circle position X
-         * @param {number} y2 second circle position Y
-         * @param {number} r2 second circle position radius
-         * @returns {boolean}
-         */
-        colcirc: (x1, y1, r1, x2, y2, r2) => {
-            DEV: assert(isFinite(x1), 'colcirc: 1st param must be a number')
-            DEV: assert(isFinite(y1), 'colcirc: 2nd param must be a number')
-            DEV: assert(isFinite(r1), 'colcirc: 3rd param must be a number')
-            DEV: assert(isFinite(x2), 'colcirc: 4th param must be a number')
-            DEV: assert(isFinite(y2), 'colcirc: 5th param must be a number')
-            DEV: 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 */
         /**
          * Prepares a plugin to be loaded
@@ -1168,25 +1135,34 @@ export default function litecanvas(settings = {}) {
          * Stops the litecanvas instance and remove all event listeners.
          */
         quit() {
+            // stop the renderer
+            cancelAnimationFrame(_rafid)
+
+            // emit "quit" event to manual clean ups
             instance.emit('quit')
+
+            // clear all engine events
+            _events = []
+
+            // clear all browser events
             for (const removeListener of _browserEventListeners) {
                 removeListener()
             }
-            cancelAnimationFrame(_rafid)
-            _events = false
+
+            // maybe clear global context
             if (_global) {
                 for (const key in instance) {
                     delete root[key]
                 }
-                delete root.__litecanvas
+                delete root.ENGINE
             }
         },
     }
 
     // prettier-ignore
-    for (const k of 'PI,sin,cos,atan2,hypot,tan,abs,ceil,round,floor,trunc,min,max,pow,sqrt,sign,exp'.split(',')) {
+    for (const k of 'PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp'.split(',')) {
         // import native Math functions
-        instance[k] = Math[k]
+        instance[k] = math[k]
     }
 
     function init() {
@@ -1204,7 +1180,7 @@ export default function litecanvas(settings = {}) {
         }
 
         // listen window resize event when "autoscale" is enabled
-        if (_autoscale) {
+        if (settings.autoscale) {
             on(root, 'resize', onResize)
         }
 
@@ -1233,7 +1209,7 @@ export default function litecanvas(settings = {}) {
                     tap.y = y
                 },
                 _checkTapped = (tap) =>
-                    tap && performance.now() - tap.ts <= 200,
+                    tap && performance.now() - tap.ts <= 300,
                 preventDefault = (ev) => ev.preventDefault()
 
             let _pressingMouse = false
@@ -1330,40 +1306,76 @@ export default function litecanvas(settings = {}) {
         }
 
         if (settings.keyboardEvents) {
+            const toLowerCase = (s) => s.toLowerCase()
+
             /** @type {Set<string>} */
-            const _keys = new Set()
+            const _keysDown = new Set()
+
+            /** @type {Set<string>} */
+            const _keysPress = new Set()
 
             /**
-             * Checks if a key is currently pressed in your keyboard.
-             * Notes:
-             * - to check the space key use `iskeydown(" ")`.
-             * - you can check if any key is pressed using `iskeydown("any")`.
-             *
-             * @param {string} key
+             * @param {Set<string>} keysSet
+             * @param {string?} key
              * @returns {boolean}
              */
-            const iskeydown = (key) => {
-                DEV: assert(
-                    'string' === typeof key,
-                    'iskeydown: 1st param must be a string'
-                )
-
-                return 'any' === key
-                    ? _keys.size > 0
-                    : _keys.has(key.toLowerCase())
+            const keyCheck = (keysSet, key) => {
+                return !key
+                    ? keysSet.size > 0
+                    : keysSet.has(
+                          'space' === toLowerCase(key) ? ' ' : toLowerCase(key)
+                      )
             }
 
-            instance.setvar('iskeydown', iskeydown)
-
             on(root, 'keydown', (/** @type {KeyboardEvent} */ event) => {
-                _keys.add(event.key.toLowerCase())
+                if (!_keysDown.has(toLowerCase(event.key))) {
+                    _keysDown.add(toLowerCase(event.key))
+                    _keysPress.add(toLowerCase(event.key))
+                }
             })
 
             on(root, 'keyup', (/** @type {KeyboardEvent} */ event) => {
-                _keys.delete(event.key.toLowerCase())
+                _keysDown.delete(toLowerCase(event.key))
             })
 
-            on(root, 'blur', () => _keys.clear())
+            on(root, 'blur', () => _keysDown.clear())
+            instance.listen('after:draw', () => _keysPress.clear())
+
+            instance.setvar(
+                'iskeydown',
+                /**
+                 * Checks if a which key is pressed (down) on the keyboard.
+                 * Note: use `iskeydown()` to check for any key.
+                 *
+                 * @param {string?} key
+                 * @returns {boolean}
+                 */
+                (key) => {
+                    DEV: assert(
+                        null == key || 'string' === typeof key,
+                        'iskeydown: 1st param must be a string or undefined'
+                    )
+                    return keyCheck(_keysDown, key)
+                }
+            )
+
+            instance.setvar(
+                'iskeypressed',
+                /**
+                 * Checks if a which key just got pressed on the keyboard.
+                 * Note: use `iskeypressed()` to check for any key.
+                 *
+                 * @param {string?} key
+                 * @returns {boolean}
+                 */
+                (key) => {
+                    DEV: assert(
+                        null == key || 'string' === typeof key,
+                        'iskeypressed: 1st param must be a string or undefined'
+                    )
+                    return keyCheck(_keysPress, key)
+                }
+            )
         }
 
         // listen browser focus/blur events and pause the update/draw loop
@@ -1379,8 +1391,6 @@ export default function litecanvas(settings = {}) {
             })
         }
 
-        instance.setfps(60)
-
         // start the game loop
         instance.emit('init', instance)
 
@@ -1402,7 +1412,7 @@ export default function litecanvas(settings = {}) {
         _lastFrameTime = now
 
         if (frameTime > _deltaTime * 30) {
-            console.log('skipping too long frame')
+            console.warn('skipping too long frame')
         } else {
             _accumulated += frameTime
 
@@ -1472,13 +1482,13 @@ export default function litecanvas(settings = {}) {
     function onResize() {
         const styles = _canvas.style
 
-        if (_autoscale) {
+        if (settings.autoscale) {
             if (!styles.display) {
                 styles.display = 'block'
                 styles.margin = 'auto'
             }
 
-            _scale = Math.min(
+            _scale = math.min(
                 root.innerWidth / instance.WIDTH,
                 root.innerHeight / instance.HEIGHT
             )
@@ -1526,11 +1536,11 @@ export default function litecanvas(settings = {}) {
     }
 
     if (_global) {
-        if (root.__litecanvas) {
-            throw 'global litecanvas already instantiated'
+        if (root.ENGINE) {
+            throw 'two global litecanvas detected'
         }
         Object.assign(root, instance)
-        root.__litecanvas = instance
+        root.ENGINE = instance
     }
 
     setupCanvas()

package/types/index.d.ts

@@ -487,10 +487,8 @@ declare global {
 
     /** UTILS API */
     /**
-     * Checks if a key is currently pressed in your keyboard.
-     * Notes:
-     * - to check the space key use `iskeydown(" ")`.
-     * - you can check if any key is pressed using `iskeydown("any")`.
+     * Checks if a which key is pressed on the keyboard.
+     * Note: use `iskeydown("any")` to check for any key pressed.
      *
      * @param key
      * @returns `true` if the which key is down

package/types/types.d.ts

@@ -465,10 +465,8 @@ type LitecanvasInstance = {
 
     /** UTILS API */
     /**
-     * Checks if a key is currently pressed in your keyboard.
-     * Notes:
-     * - to check the space key use `iskeydown(" ")`.
-     * - you can check if any key is pressed using `iskeydown("any")`.
+     * Checks if a which key is pressed on the keyboard.
+     * Note: use `iskeydown("any")` to check for any key pressed.
      *
      * @param key
      * @returns `true` if the which key is down