litecanvas 0.102.2 → 0.103.0

package/dist/dist.dev.js

@@ -19,7 +19,7 @@
   };
 
   // src/version.js
-  var version = "0.102.2";
+  var version = "0.103.0";
 
   // src/index.js
   function litecanvas(settings = {}) {
@@ -37,7 +37,7 @@
       keyboardEvents: true
     };
     settings = Object.assign(defaults, settings);
-    let _initialized = false, _paused = true, _canvas, _scale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _fpsInterval = 1e3 / 60, _accumulated, _rafid, _defaultTextColor = 3, _fontFamily = "sans-serif", _fontSize = 20, _fontLineHeight = 1.2, _rngSeed = Date.now(), _colorPalette = defaultPalette, _colorPaletteState = [], _defaultSound = [0.5, 0, 1750, , , 0.3, 1, , , , 600, 0.1], _coreEvents = "init,update,draw,tap,untap,tapping,tapped,resized", _mathFunctions = "PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp", _eventListeners = {};
+    let _initialized = false, _paused = true, _canvas, _canvasScale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _fpsInterval = 1e3 / 60, _accumulated, _rafid, _defaultTextColor = 3, _fontFamily = "sans-serif", _fontSize = 20, _fontLineHeight = 1.2, _rngSeed = Date.now(), _colorPalette = defaultPalette, _colorPaletteState = [], _defaultSound = [0.5, 0, 1750, , , 0.3, 1, , , , 600, 0.1], _coreEvents = "init,update,draw,tap,untap,tapping,tapped,resized", _mathFunctions = "PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp", _eventListeners = {};
     const instance = {
       /** @type {number} */
       W: 0,
@@ -80,7 +80,7 @@
         DEV: assert(isNumber(start), "[litecanvas] lerp() 1st param must be a number");
         DEV: assert(isNumber(end), "[litecanvas] lerp() 2nd param must be a number");
         DEV: assert(isNumber(t), "[litecanvas] lerp() 3rd param must be a number");
-        return t * (end - start) + start;
+        return start + t * (end - start);
       },
       /**
        * Convert degrees to radians
@@ -143,6 +143,22 @@
         if (value > max) return max;
         return value;
       },
+      /**
+       * Calculates the distance between a point (x1, y1) to another (x2, y2).
+       *
+       * @param {number} x1
+       * @param {number} y1
+       * @param {number} x2
+       * @param {number} y2
+       * @returns {number}
+       */
+      dist: (x1, y1, x2, y2) => {
+        DEV: assert(isNumber(x1), "[litecanvas] dist() 1st param must be a number");
+        DEV: assert(isNumber(y1), "[litecanvas] dist() 2nd param must be a number");
+        DEV: assert(isNumber(x2), "[litecanvas] dist() 3rd param must be a number");
+        DEV: assert(isNumber(y2), "[litecanvas] dist() 4th param must be a number");
+        return math.hypot(x2 - x1, y2 - y1);
+      },
       /**
        * Wraps a number between `min` (inclusive) and `max` (exclusive).
        *
@@ -205,24 +221,6 @@
         );
         return instance.map(value, start, stop, 0, 1);
       },
-      /**
-       * Interpolate between 2 values using a periodic function.
-       *
-       * @param {number} from - the lower bound
-       * @param {number} to - the higher bound
-       * @param {number} t - value passed to the periodic function
-       * @param {(n: number) => number} [fn] - the periodic function (which default to `Math.sin`)
-       */
-      wave: (from, to, t, fn = Math.sin) => {
-        DEV: assert(isNumber(from), "[litecanvas] wave() 1st param must be a number");
-        DEV: assert(isNumber(to), "[litecanvas] wave() 2nd param must be a number");
-        DEV: assert(isNumber(t), "[litecanvas] wave() 3rd param must be a number");
-        DEV: assert(
-          "function" === typeof fn,
-          "[litecanvas] wave() 4rd param must be a function (n: number) => number"
-        );
-        return from + (fn(t) + 1) / 2 * (to - from);
-      },
       /** RNG API */
       /**
        * Generates a pseudorandom float between min (inclusive) and max (exclusive)
@@ -256,7 +254,7 @@
         DEV: assert(isNumber(min), "[litecanvas] randi() 1st param must be a number");
         DEV: assert(isNumber(max), "[litecanvas] randi() 2nd param must be a number");
         DEV: assert(
-          max > min,
+          min <= max,
           "[litecanvas] randi() the 1st param must be less than the 2nd param"
         );
         return math.floor(instance.rand(min, max + 1));
@@ -911,7 +909,7 @@
         eventName = lowerCase(eventName);
         _eventListeners[eventName] = _eventListeners[eventName] || /* @__PURE__ */ new Set();
         _eventListeners[eventName].add(callback);
-        return () => _eventListeners && _eventListeners[eventName].delete(callback);
+        return () => _eventListeners[eventName]?.delete(callback);
       },
       /**
        * Call all listeners attached to a game event
@@ -1041,7 +1039,7 @@
           // 2
           _fpsInterval / 1e3,
           // 3
-          _scale,
+          _canvasScale,
           // 4
           _eventListeners,
           // 5
@@ -1130,8 +1128,8 @@
            * @param {MouseEvent | Touch} ev
            */
           (ev) => [
-            (ev.pageX - _canvas.offsetLeft) / _scale,
-            (ev.pageY - _canvas.offsetTop) / _scale
+            (ev.pageX - _canvas.offsetLeft) / _canvasScale,
+            (ev.pageY - _canvas.offsetTop) / _canvasScale
           ]
         ), _taps = /* @__PURE__ */ new Map(), _registerTap = (
           /**
@@ -1342,8 +1340,8 @@
         );
       }
       _initialized = true;
-      instance.emit("init", instance);
       instance.resume();
+      instance.emit("init", instance);
     }
     function drawFrame() {
       _rafid = raf(drawFrame);
@@ -1417,14 +1415,14 @@
           _canvas.style.display = "block";
           _canvas.style.margin = "auto";
         }
-        _scale = math.min(innerWidth / width, innerHeight / height);
-        _scale = maxScale > 1 && _scale > maxScale ? maxScale : _scale;
-        _canvas.style.width = width * _scale + "px";
-        _canvas.style.height = height * _scale + "px";
+        _canvasScale = math.min(innerWidth / width, innerHeight / height);
+        _canvasScale = maxScale > 1 && _canvasScale > maxScale ? maxScale : _canvasScale;
+        _canvas.style.width = width * _canvasScale + "px";
+        _canvas.style.height = height * _canvasScale + "px";
       }
       _ctx.imageSmoothingEnabled = false;
       instance.textalign("start", "top");
-      instance.emit("resized", _scale);
+      instance.emit("resized", _canvasScale);
     }
     function triggerEvent(eventName, arg1, arg2, arg3, arg4) {
       if (!_eventListeners[eventName]) return;

package/dist/dist.js

@@ -29,7 +29,7 @@
       keyboardEvents: true
     };
     settings = Object.assign(defaults, settings);
-    let _initialized = false, _paused = true, _canvas, _scale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _fpsInterval = 1e3 / 60, _accumulated, _rafid, _defaultTextColor = 3, _fontFamily = "sans-serif", _fontSize = 20, _fontLineHeight = 1.2, _rngSeed = Date.now(), _colorPalette = defaultPalette, _colorPaletteState = [], _defaultSound = [0.5, 0, 1750, , , 0.3, 1, , , , 600, 0.1], _coreEvents = "init,update,draw,tap,untap,tapping,tapped,resized", _mathFunctions = "PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp", _eventListeners = {};
+    let _initialized = false, _paused = true, _canvas, _canvasScale = 1, _ctx, _outline_fix = 0.5, _timeScale = 1, _lastFrameTime, _fpsInterval = 1e3 / 60, _accumulated, _rafid, _defaultTextColor = 3, _fontFamily = "sans-serif", _fontSize = 20, _fontLineHeight = 1.2, _rngSeed = Date.now(), _colorPalette = defaultPalette, _colorPaletteState = [], _defaultSound = [0.5, 0, 1750, , , 0.3, 1, , , , 600, 0.1], _coreEvents = "init,update,draw,tap,untap,tapping,tapped,resized", _mathFunctions = "PI,sin,cos,atan2,hypot,tan,abs,ceil,floor,trunc,min,max,pow,sqrt,sign,exp", _eventListeners = {};
     const instance = {
       /** @type {number} */
       W: 0,
@@ -69,7 +69,7 @@
        * @tutorial https://gamedev.net/tutorials/programming/general-and-gameplay-programming/a-brief-introduction-to-lerp-r4954/
        */
       lerp: (start, end, t) => {
-        return t * (end - start) + start;
+        return start + t * (end - start);
       },
       /**
        * Convert degrees to radians
@@ -118,6 +118,18 @@
         if (value > max) return max;
         return value;
       },
+      /**
+       * Calculates the distance between a point (x1, y1) to another (x2, y2).
+       *
+       * @param {number} x1
+       * @param {number} y1
+       * @param {number} x2
+       * @param {number} y2
+       * @returns {number}
+       */
+      dist: (x1, y1, x2, y2) => {
+        return math.hypot(x2 - x1, y2 - y1);
+      },
       /**
        * Wraps a number between `min` (inclusive) and `max` (exclusive).
        *
@@ -157,17 +169,6 @@
       norm: (value, start, stop) => {
         return instance.map(value, start, stop, 0, 1);
       },
-      /**
-       * Interpolate between 2 values using a periodic function.
-       *
-       * @param {number} from - the lower bound
-       * @param {number} to - the higher bound
-       * @param {number} t - value passed to the periodic function
-       * @param {(n: number) => number} [fn] - the periodic function (which default to `Math.sin`)
-       */
-      wave: (from, to, t, fn = Math.sin) => {
-        return from + (fn(t) + 1) / 2 * (to - from);
-      },
       /** RNG API */
       /**
        * Generates a pseudorandom float between min (inclusive) and max (exclusive)
@@ -627,7 +628,7 @@
         eventName = lowerCase(eventName);
         _eventListeners[eventName] = _eventListeners[eventName] || /* @__PURE__ */ new Set();
         _eventListeners[eventName].add(callback);
-        return () => _eventListeners && _eventListeners[eventName].delete(callback);
+        return () => _eventListeners[eventName]?.delete(callback);
       },
       /**
        * Call all listeners attached to a game event
@@ -719,7 +720,7 @@
           // 2
           _fpsInterval / 1e3,
           // 3
-          _scale,
+          _canvasScale,
           // 4
           _eventListeners,
           // 5
@@ -803,8 +804,8 @@
            * @param {MouseEvent | Touch} ev
            */
           (ev) => [
-            (ev.pageX - _canvas.offsetLeft) / _scale,
-            (ev.pageY - _canvas.offsetTop) / _scale
+            (ev.pageX - _canvas.offsetLeft) / _canvasScale,
+            (ev.pageY - _canvas.offsetTop) / _canvasScale
           ]
         ), _taps = /* @__PURE__ */ new Map(), _registerTap = (
           /**
@@ -1007,8 +1008,8 @@
         );
       }
       _initialized = true;
-      instance.emit("init", instance);
       instance.resume();
+      instance.emit("init", instance);
     }
     function drawFrame() {
       _rafid = raf(drawFrame);
@@ -1059,14 +1060,14 @@
           _canvas.style.display = "block";
           _canvas.style.margin = "auto";
         }
-        _scale = math.min(innerWidth / width, innerHeight / height);
-        _scale = maxScale > 1 && _scale > maxScale ? maxScale : _scale;
-        _canvas.style.width = width * _scale + "px";
-        _canvas.style.height = height * _scale + "px";
+        _canvasScale = math.min(innerWidth / width, innerHeight / height);
+        _canvasScale = maxScale > 1 && _canvasScale > maxScale ? maxScale : _canvasScale;
+        _canvas.style.width = width * _canvasScale + "px";
+        _canvas.style.height = height * _canvasScale + "px";
       }
       _ctx.imageSmoothingEnabled = false;
       instance.textalign("start", "top");
-      instance.emit("resized", _scale);
+      instance.emit("resized", _canvasScale);
     }
     function triggerEvent(eventName, arg1, arg2, arg3, arg4) {
       if (!_eventListeners[eventName]) return;

package/dist/dist.min.js

@@ -1 +1 @@
-(()=>{var e=["#211e20","#555568","#a0a08b","#e9efec"];window.litecanvas=function(t={}){let a,l=window,n=Math,i=2*n.PI,o=requestAnimationFrame,r=[],s=(e,t,a)=>{e.addEventListener(t,a,!1),r.push(()=>e.removeEventListener(t,a,!1))},f=(a=new AudioContext,l.zzfxV=1,(e=1,t=.05,n=220,i=0,o=0,r=.1,s=0,f=1,d=0,c=0,u=0,p=0,h=0,g=0,m=0,v=0,w=0,x=1,y=0,b=0,k=0)=>{let z=Math,D=2*z.PI,E=d*=500*D/44100/44100,P=n*=(1-t+2*t*z.random(t=[]))*D/44100,T=0,C=0,I=0,L=1,S=0,A=0,M=0,N=k<0?-1:1,q=D*N*k*2/44100,B=z.cos(q),H=z.sin,O=H(q)/4,V=1+O,W=-2*B/V,R=(1-O)/V,F=(1+N*B)/2/V,G=-(N+B)/V,X=0,Y=0,$=0,j=0;for(i=44100*i+9,y*=44100,o*=44100,r*=44100,w*=44100,c*=500*D/85766121e6,m*=D/44100,u*=D/44100,p*=44100,h=44100*h|0,e*=.3*l.zzfxV,N=i+y+o+r+w|0;I<N;t[I++]=M*e)++A%(100*v|0)||(M=s?1<s?2<s?3<s?H(T*T):z.max(z.min(z.tan(T),1),-1):1-(2*T/D%2+2)%2:1-4*z.abs(z.round(T/D)-T/D):H(T),M=(h?1-b+b*H(D*I/h):1)*(M<0?-1:1)*z.abs(M)**f*(I<i?I/i:I<i+y?1-(I-i)/y*(1-x):I<i+y+o?x:I<N-w?(N-I-w)/r*x:0),M=w?M/2+(w>I?0:(I<N-w?1:(N-I)/w)*t[I-w|0]/2/e):M,k&&(M=j=F*X+G*(X=Y)+F*(Y=M)-R*$-W*($=j))),T+=(q=(n+=d+=c)*z.cos(m*C++))+q*g*H(I**5),L&&++L>p&&(n+=u,P+=u,L=0),!h||++S%h||(n=P,d=E,L=L||1);(e=a.createBuffer(1,N,44100)).getChannelData(0).set(t),(n=a.createBufferSource()).buffer=e,n.connect(a.destination),n.start()});t=Object.assign({width:null,height:null,autoscale:!0,canvas:null,global:!0,loop:null,tapEvents:!0,keyboardEvents:!0},t);let d=!1,c=!0,u,p=1,h,g=.5,m=1,v,w=1e3/60,x,y,b=3,k="sans-serif",z=20,D=1.2,E=Date.now(),P=e,T=[],C=[.5,0,1750,,,.3,1,,,,600,.1],I={},L={W:0,H:0,T:0,MX:-1,MY:-1,TWO_PI:i,HALF_PI:i/4,lerp:(e,t,a)=>a*(t-e)+e,deg2rad:e=>n.PI/180*e,rad2deg:e=>180/n.PI*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 o=(e-t)/(a-t)*(n-l)+l;return i?L.clamp(o,l,n):o},norm:(e,t,a)=>L.map(e,t,a,0,1),wave:(e,t,a,l=Math.sin)=>e+(l(a)+1)/2*(t-e),rand:(e=0,t=1)=>(E=(1664525*E+0x3c6ef35f)%0x100000000)/0x100000000*(t-e)+e,randi:(e=0,t=1)=>n.floor(L.rand(e,t+1)),rseed(e){E=~~e},cls(e){null==e?h.clearRect(0,0,h.canvas.width,h.canvas.height):L.rectfill(0,0,h.canvas.width,h.canvas.height,e)},rect(e,t,a,l,n,i){h.beginPath(),h[i?"roundRect":"rect"](~~e-g,~~t-g,~~a+2*g,~~l+2*g,i),L.stroke(n)},rectfill(e,t,a,l,n,i){h.beginPath(),h[i?"roundRect":"rect"](~~e,~~t,~~a,~~l,i),L.fill(n)},circ(e,t,a,l){h.beginPath(),h.arc(~~e,~~t,~~a,0,i),L.stroke(l)},circfill(e,t,a,l){h.beginPath(),h.arc(~~e,~~t,~~a,0,i),L.fill(l)},oval(e,t,a,l,n){h.beginPath(),h.ellipse(~~e,~~t,~~a,~~l,0,0,i),L.stroke(n)},ovalfill(e,t,a,l,n){h.beginPath(),h.ellipse(~~e,~~t,~~a,~~l,0,0,i),L.fill(n)},shape(e){h.beginPath();for(let t=0;t<e.length;t+=2)0===t?h.moveTo(~~e[t],~~e[t+1]):h.lineTo(~~e[t],~~e[t+1]);h.lineTo(~~e[0],~~e[1])},line(e,t,a,l,n){h.beginPath();let i=.5*(0!==g&&~~e==~~a),o=.5*(0!==g&&~~t==~~l);h.moveTo(~~e+i,~~t+o),h.lineTo(~~a+i,~~l+o),L.stroke(n)},linewidth(e){h.lineWidth=~~e,g=.5*(0!=~~e%2)},linedash(e,t=0){h.setLineDash(e),h.lineDashOffset=t},text(e,t,a,l=b,n="normal"){h.font=`${n} ${z}px ${k}`,h.fillStyle=q(l);let i=(""+a).split("\n");for(let a=0;a<i.length;a++)h.fillText(i[a],~~e,~~t+z*D*a)},textgap(e){D=e},textfont(e){k=e},textsize(e){z=e},textalign(e,t){e&&(h.textAlign=e),t&&(h.textBaseline=t)},image(e,t,a){h.drawImage(a,~~e,~~t)},spr(e,t,a){let l=a.trim().split("\n");for(let a=0;a<l.length;a++){let n=l[a].trim();for(let l=0;l<n.length;l++){let i=n[l];"."!==i&&" "!==i&&L.rectfill(e+l,t+a,1,1,parseInt(i,36)||0)}}},paint(e,t,a,l={}){let n=l.canvas||new OffscreenCanvas(1,1),i=l.scale||1,o=h;return n.width=e*i,n.height=t*i,(h=n.getContext("2d")).scale(i,i),a(h),h=o,n.transferToImageBitmap()},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=L.clamp(e,0,1)},fill(e){h.fillStyle=q(e),h.fill()},stroke(e){h.strokeStyle=q(e),h.stroke()},clip(e){h.beginPath(),e(h),h.clip()},sfx:(e,t=0,a=1)=>!!l.zzfxV&&(!navigator.userActivation||!!navigator.userActivation.hasBeenActive)&&(e=e||C,(0!==t||1!==a)&&((e=e.slice())[0]=a*(e[0]||1),e[10]=~~e[10]+t),f.apply(0,e),e),volume(e){l.zzfxV=e},canvas:()=>u,use(e,t={}){var a=e,l=t;let n=a(L,l);for(let e in n)L.def(e,n[e])},listen:(e,t)=>(I[e=e.toLowerCase()]=I[e]||new Set,I[e].add(t),()=>I&&I[e].delete(t)),emit(e,t,a,l,n){d&&(N("before:"+(e=e.toLowerCase()),t,a,l,n),N(e,t,a,l,n),N("after:"+e,t,a,l,n))},pal(t,a=3){P=t||e,T=[],b=a},palc(e,t){null==e?T=[]:T[e]=t},def(e,a){L[e]=a,t.global&&(l[e]=a)},timescale(e){m=e},framerate(e){w=1e3/~~e},stat(e){let a={index:e,value:[t,d,w/1e3,p,I,P,C,m,l.zzfxV,E,z,k,T,D][e]};return L.emit("stat",a),a.value},pause(){c=!0,cancelAnimationFrame(y)},resume(){d&&c&&(c=!1,x=w,v=Date.now(),y=o(A))},paused:()=>c,quit(){for(let e of(L.emit("quit"),L.pause(),d=!1,I={},r))e();if(t.global){for(let e in L)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(","))L[e]=n[e];function S(){if(t.autoscale&&s(l,"resize",M),t.tapEvents){let e=e=>[(e.pageX-u.offsetLeft)/p,(e.pageY-u.offsetTop)/p],t=new Map,a=(e,a,l)=>{let n={x:a,y:l,xi:a,yi:l,t:Date.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&&Date.now()-e.t<=300,o=!1;s(u,"mousedown",t=>{if(0===t.button){t.preventDefault();let[l,n]=e(t);L.emit("tap",l,n,0),a(0,l,n),o=!0}}),s(u,"mouseup",a=>{if(0===a.button){a.preventDefault();let l=t.get(0),[n,r]=e(a);i(l)&&L.emit("tapped",l.xi,l.yi,0),L.emit("untap",n,r,0),t.delete(0),o=!1}}),s(l,"mousemove",t=>{t.preventDefault();let[a,l]=e(t);L.def("MX",a),L.def("MY",l),o&&(L.emit("tapping",a,l,0),n(0,a,l))}),s(u,"touchstart",t=>{for(let l of(t.preventDefault(),t.changedTouches)){let[t,n]=e(l);L.emit("tap",t,n,l.identifier+1),a(l.identifier+1,t,n)}}),s(u,"touchmove",t=>{for(let a of(t.preventDefault(),t.changedTouches)){let[t,l]=e(a);L.emit("tapping",t,l,a.identifier+1),n(a.identifier+1,t,l)}});let r=e=>{e.preventDefault();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)&&L.emit("tapped",l.xi,l.yi,e),L.emit("untap",l.x,l.y,e),t.delete(e))};s(u,"touchend",r),s(u,"touchcancel",r),s(l,"blur",()=>{for(let[e,a]of(o=!1,t))L.emit("untap",a.x,a.y,e),t.delete(e)})}if(t.keyboardEvents){let e=new Set,t=new Set,a=(e,t="")=>(t=t.toLowerCase())?e.has("space"===t?" ":t):e.size>0,n="";s(l,"keydown",a=>{let l=a.key.toLowerCase();e.has(l)||(e.add(l),t.add(l),n=" "===l?"space":l)}),s(l,"keyup",t=>{e.delete(t.key.toLowerCase())}),s(l,"blur",()=>e.clear()),L.listen("after:update",()=>t.clear()),L.def("iskeydown",t=>a(e,t)),L.def("iskeypressed",e=>a(t,e)),L.def("lastkey",()=>n)}d=!0,L.emit("init",L),L.resume()}function A(){y=o(A);let e=Date.now(),t=0,a=e-v;for(v=e,x+=a<100?a:w;x>=w;){t++,x-=w;let e=w/1e3*m;L.emit("update",e,t),L.def("T",L.T+e)}t&&(L.emit("draw",h),t>1&&(x=0))}function M(){let e=t.width>0?t.width:innerWidth,a=t.width>0?t.height||t.width:innerHeight;if(L.def("W",e),L.def("H",a),u.width=e,u.height=a,t.autoscale){let l=+t.autoscale;u.style.display||(u.style.display="block",u.style.margin="auto"),p=n.min(innerWidth/e,innerHeight/a),p=l>1&&p>l?l:p,u.style.width=e*p+"px",u.style.height=a*p+"px"}h.imageSmoothingEnabled=!1,L.textalign("start","top"),L.emit("resized",p)}function N(e,t,a,l,n){if(I[e])for(let i of I[e])i(t,a,l,n)}function q(e){return P[~~(T[e]??e)%P.length]}if(t.global){if(l.ENGINE)throw Error("only one global litecanvas is allowed");Object.assign(l,L),l.ENGINE=L}h=(u=(u="string"==typeof t.canvas?document.querySelector(t.canvas):t.canvas)||document.createElement("canvas")).getContext("2d"),s(u,"click",()=>focus()),M(),u.parentNode||document.body.appendChild(u),u.style.imageRendering="pixelated",u.oncontextmenu=()=>!1;let B=t.loop?t.loop:l;for(let e of"init,update,draw,tap,untap,tapping,tapped,resized".split(","))B[e]&&L.listen(e,B[e]);return"loading"===document.readyState?s(l,"DOMContentLoaded",()=>o(S)):y=o(S),L}})();
+(()=>{var e=["#211e20","#555568","#a0a08b","#e9efec"];window.litecanvas=function(t={}){let a,l=window,n=Math,i=2*n.PI,o=requestAnimationFrame,r=[],s=(e,t,a)=>{e.addEventListener(t,a,!1),r.push(()=>e.removeEventListener(t,a,!1))},f=(a=new AudioContext,l.zzfxV=1,(e=1,t=.05,n=220,i=0,o=0,r=.1,s=0,f=1,d=0,c=0,p=0,u=0,h=0,g=0,m=0,v=0,w=0,x=1,y=0,b=0,k=0)=>{let z=Math,D=2*z.PI,E=d*=500*D/44100/44100,P=n*=(1-t+2*t*z.random(t=[]))*D/44100,T=0,C=0,I=0,L=1,S=0,A=0,M=0,N=k<0?-1:1,q=D*N*k*2/44100,B=z.cos(q),H=z.sin,O=H(q)/4,V=1+O,W=-2*B/V,R=(1-O)/V,F=(1+N*B)/2/V,G=-(N+B)/V,X=0,Y=0,$=0,j=0;for(i=44100*i+9,y*=44100,o*=44100,r*=44100,w*=44100,c*=500*D/85766121e6,m*=D/44100,p*=D/44100,u*=44100,h=44100*h|0,e*=.3*l.zzfxV,N=i+y+o+r+w|0;I<N;t[I++]=M*e)++A%(100*v|0)||(M=s?1<s?2<s?3<s?H(T*T):z.max(z.min(z.tan(T),1),-1):1-(2*T/D%2+2)%2:1-4*z.abs(z.round(T/D)-T/D):H(T),M=(h?1-b+b*H(D*I/h):1)*(M<0?-1:1)*z.abs(M)**f*(I<i?I/i:I<i+y?1-(I-i)/y*(1-x):I<i+y+o?x:I<N-w?(N-I-w)/r*x:0),M=w?M/2+(w>I?0:(I<N-w?1:(N-I)/w)*t[I-w|0]/2/e):M,k&&(M=j=F*X+G*(X=Y)+F*(Y=M)-R*$-W*($=j))),T+=(q=(n+=d+=c)*z.cos(m*C++))+q*g*H(I**5),L&&++L>u&&(n+=p,P+=p,L=0),!h||++S%h||(n=P,d=E,L=L||1);(e=a.createBuffer(1,N,44100)).getChannelData(0).set(t),(n=a.createBufferSource()).buffer=e,n.connect(a.destination),n.start()});t=Object.assign({width:null,height:null,autoscale:!0,canvas:null,global:!0,loop:null,tapEvents:!0,keyboardEvents:!0},t);let d=!1,c=!0,p,u=1,h,g=.5,m=1,v,w=1e3/60,x,y,b=3,k="sans-serif",z=20,D=1.2,E=Date.now(),P=e,T=[],C=[.5,0,1750,,,.3,1,,,,600,.1],I={},L={W:0,H:0,T:0,MX:-1,MY:-1,TWO_PI:i,HALF_PI:i/4,lerp:(e,t,a)=>e+a*(t-e),deg2rad:e=>n.PI/180*e,rad2deg:e=>180/n.PI*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,dist:(e,t,a,l)=>n.hypot(a-e,l-t),wrap:(e,t,a)=>e-(a-t)*n.floor((e-t)/(a-t)),map(e,t,a,l,n,i){let o=(e-t)/(a-t)*(n-l)+l;return i?L.clamp(o,l,n):o},norm:(e,t,a)=>L.map(e,t,a,0,1),rand:(e=0,t=1)=>(E=(1664525*E+0x3c6ef35f)%0x100000000)/0x100000000*(t-e)+e,randi:(e=0,t=1)=>n.floor(L.rand(e,t+1)),rseed(e){E=~~e},cls(e){null==e?h.clearRect(0,0,h.canvas.width,h.canvas.height):L.rectfill(0,0,h.canvas.width,h.canvas.height,e)},rect(e,t,a,l,n,i){h.beginPath(),h[i?"roundRect":"rect"](~~e-g,~~t-g,~~a+2*g,~~l+2*g,i),L.stroke(n)},rectfill(e,t,a,l,n,i){h.beginPath(),h[i?"roundRect":"rect"](~~e,~~t,~~a,~~l,i),L.fill(n)},circ(e,t,a,l){h.beginPath(),h.arc(~~e,~~t,~~a,0,i),L.stroke(l)},circfill(e,t,a,l){h.beginPath(),h.arc(~~e,~~t,~~a,0,i),L.fill(l)},oval(e,t,a,l,n){h.beginPath(),h.ellipse(~~e,~~t,~~a,~~l,0,0,i),L.stroke(n)},ovalfill(e,t,a,l,n){h.beginPath(),h.ellipse(~~e,~~t,~~a,~~l,0,0,i),L.fill(n)},shape(e){h.beginPath();for(let t=0;t<e.length;t+=2)0===t?h.moveTo(~~e[t],~~e[t+1]):h.lineTo(~~e[t],~~e[t+1]);h.lineTo(~~e[0],~~e[1])},line(e,t,a,l,n){h.beginPath();let i=.5*(0!==g&&~~e==~~a),o=.5*(0!==g&&~~t==~~l);h.moveTo(~~e+i,~~t+o),h.lineTo(~~a+i,~~l+o),L.stroke(n)},linewidth(e){h.lineWidth=~~e,g=.5*(0!=~~e%2)},linedash(e,t=0){h.setLineDash(e),h.lineDashOffset=t},text(e,t,a,l=b,n="normal"){h.font=`${n} ${z}px ${k}`,h.fillStyle=q(l);let i=(""+a).split("\n");for(let a=0;a<i.length;a++)h.fillText(i[a],~~e,~~t+z*D*a)},textgap(e){D=e},textfont(e){k=e},textsize(e){z=e},textalign(e,t){e&&(h.textAlign=e),t&&(h.textBaseline=t)},image(e,t,a){h.drawImage(a,~~e,~~t)},spr(e,t,a){let l=a.trim().split("\n");for(let a=0;a<l.length;a++){let n=l[a].trim();for(let l=0;l<n.length;l++){let i=n[l];"."!==i&&" "!==i&&L.rectfill(e+l,t+a,1,1,parseInt(i,36)||0)}}},paint(e,t,a,l={}){let n=l.canvas||new OffscreenCanvas(1,1),i=l.scale||1,o=h;return n.width=e*i,n.height=t*i,(h=n.getContext("2d")).scale(i,i),a(h),h=o,n.transferToImageBitmap()},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=L.clamp(e,0,1)},fill(e){h.fillStyle=q(e),h.fill()},stroke(e){h.strokeStyle=q(e),h.stroke()},clip(e){h.beginPath(),e(h),h.clip()},sfx:(e,t=0,a=1)=>!!l.zzfxV&&(!navigator.userActivation||!!navigator.userActivation.hasBeenActive)&&(e=e||C,(0!==t||1!==a)&&((e=e.slice())[0]=a*(e[0]||1),e[10]=~~e[10]+t),f.apply(0,e),e),volume(e){l.zzfxV=e},canvas:()=>p,use(e,t={}){var a=e,l=t;let n=a(L,l);for(let e in n)L.def(e,n[e])},listen:(e,t)=>(I[e=e.toLowerCase()]=I[e]||new Set,I[e].add(t),()=>I[e]?.delete(t)),emit(e,t,a,l,n){d&&(N("before:"+(e=e.toLowerCase()),t,a,l,n),N(e,t,a,l,n),N("after:"+e,t,a,l,n))},pal(t,a=3){P=t||e,T=[],b=a},palc(e,t){null==e?T=[]:T[e]=t},def(e,a){L[e]=a,t.global&&(l[e]=a)},timescale(e){m=e},framerate(e){w=1e3/~~e},stat(e){let a={index:e,value:[t,d,w/1e3,u,I,P,C,m,l.zzfxV,E,z,k,T,D][e]};return L.emit("stat",a),a.value},pause(){c=!0,cancelAnimationFrame(y)},resume(){d&&c&&(c=!1,x=w,v=Date.now(),y=o(A))},paused:()=>c,quit(){for(let e of(L.emit("quit"),L.pause(),d=!1,I={},r))e();if(t.global){for(let e in L)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(","))L[e]=n[e];function S(){if(t.autoscale&&s(l,"resize",M),t.tapEvents){let e=e=>[(e.pageX-p.offsetLeft)/u,(e.pageY-p.offsetTop)/u],t=new Map,a=(e,a,l)=>{let n={x:a,y:l,xi:a,yi:l,t:Date.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&&Date.now()-e.t<=300,o=!1;s(p,"mousedown",t=>{if(0===t.button){t.preventDefault();let[l,n]=e(t);L.emit("tap",l,n,0),a(0,l,n),o=!0}}),s(p,"mouseup",a=>{if(0===a.button){a.preventDefault();let l=t.get(0),[n,r]=e(a);i(l)&&L.emit("tapped",l.xi,l.yi,0),L.emit("untap",n,r,0),t.delete(0),o=!1}}),s(l,"mousemove",t=>{t.preventDefault();let[a,l]=e(t);L.def("MX",a),L.def("MY",l),o&&(L.emit("tapping",a,l,0),n(0,a,l))}),s(p,"touchstart",t=>{for(let l of(t.preventDefault(),t.changedTouches)){let[t,n]=e(l);L.emit("tap",t,n,l.identifier+1),a(l.identifier+1,t,n)}}),s(p,"touchmove",t=>{for(let a of(t.preventDefault(),t.changedTouches)){let[t,l]=e(a);L.emit("tapping",t,l,a.identifier+1),n(a.identifier+1,t,l)}});let r=e=>{e.preventDefault();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)&&L.emit("tapped",l.xi,l.yi,e),L.emit("untap",l.x,l.y,e),t.delete(e))};s(p,"touchend",r),s(p,"touchcancel",r),s(l,"blur",()=>{for(let[e,a]of(o=!1,t))L.emit("untap",a.x,a.y,e),t.delete(e)})}if(t.keyboardEvents){let e=new Set,t=new Set,a=(e,t="")=>(t=t.toLowerCase())?e.has("space"===t?" ":t):e.size>0,n="";s(l,"keydown",a=>{let l=a.key.toLowerCase();e.has(l)||(e.add(l),t.add(l),n=" "===l?"space":l)}),s(l,"keyup",t=>{e.delete(t.key.toLowerCase())}),s(l,"blur",()=>e.clear()),L.listen("after:update",()=>t.clear()),L.def("iskeydown",t=>a(e,t)),L.def("iskeypressed",e=>a(t,e)),L.def("lastkey",()=>n)}d=!0,L.resume(),L.emit("init",L)}function A(){y=o(A);let e=Date.now(),t=0,a=e-v;for(v=e,x+=a<100?a:w;x>=w;){t++,x-=w;let e=w/1e3*m;L.emit("update",e,t),L.def("T",L.T+e)}t&&(L.emit("draw",h),t>1&&(x=0))}function M(){let e=t.width>0?t.width:innerWidth,a=t.width>0?t.height||t.width:innerHeight;if(L.def("W",e),L.def("H",a),p.width=e,p.height=a,t.autoscale){let l=+t.autoscale;p.style.display||(p.style.display="block",p.style.margin="auto"),u=n.min(innerWidth/e,innerHeight/a),u=l>1&&u>l?l:u,p.style.width=e*u+"px",p.style.height=a*u+"px"}h.imageSmoothingEnabled=!1,L.textalign("start","top"),L.emit("resized",u)}function N(e,t,a,l,n){if(I[e])for(let i of I[e])i(t,a,l,n)}function q(e){return P[~~(T[e]??e)%P.length]}if(t.global){if(l.ENGINE)throw Error("only one global litecanvas is allowed");Object.assign(l,L),l.ENGINE=L}h=(p=(p="string"==typeof t.canvas?document.querySelector(t.canvas):t.canvas)||document.createElement("canvas")).getContext("2d"),s(p,"click",()=>focus()),M(),p.parentNode||document.body.appendChild(p),p.style.imageRendering="pixelated",p.oncontextmenu=()=>!1;let B=t.loop?t.loop:l;for(let e of"init,update,draw,tap,untap,tapping,tapped,resized".split(","))B[e]&&L.listen(e,B[e]);return"loading"===document.readyState?s(l,"DOMContentLoaded",()=>o(S)):y=o(S),L}})();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "litecanvas",
-    "version": "0.102.2",
+    "version": "0.103.0",
     "description": "Lightweight HTML5 canvas 2D game engine suitable for small projects and creative coding. Inspired by PICO-8 and p5.js/Processing.",
     "license": "MIT",
     "author": "Luiz Bills <luizbills@pm.me>",
@@ -31,16 +31,16 @@
         "creative coding"
     ],
     "devDependencies": {
-        "@happy-dom/global-registrator": "^18.0.1",
-        "@size-limit/preset-small-lib": "^11.2.0",
-        "@swc/core": "^1.15.8",
+        "@happy-dom/global-registrator": "^20.7.0",
+        "@size-limit/preset-small-lib": "^12.0.0",
+        "@swc/core": "^1.15.13",
         "ava": "^6.4.1",
-        "esbuild": "^0.25.12",
+        "esbuild": "^0.27.3",
         "genversion": "^3.2.0",
         "gzip-size": "^7.0.0",
-        "prettier": "^3.7.4",
+        "prettier": "^3.8.1",
         "sinon": "^21.0.1",
-        "size-limit": "^11.2.0",
+        "size-limit": "^12.0.0",
         "tap-min": "^3.0.0"
     },
     "trustedDependencies": [

package/src/index.js

@@ -53,7 +53,7 @@ export default function litecanvas(settings = {}) {
         /** @type {HTMLCanvasElement} _canvas */
         _canvas,
         /** @type {number} */
-        _scale = 1,
+        _canvasScale = 1,
         /** @type {CanvasRenderingContext2D|OffscreenCanvasRenderingContext2D} */
         _ctx,
         /** @type {number} */
@@ -145,7 +145,7 @@ export default function litecanvas(settings = {}) {
             DEV: assert(isNumber(end), '[litecanvas] lerp() 2nd param must be a number')
             DEV: assert(isNumber(t), '[litecanvas] lerp() 3rd param must be a number')
 
-            return t * (end - start) + start
+            return start + t * (end - start)
         },
 
         /**
@@ -187,6 +187,7 @@ export default function litecanvas(settings = {}) {
                 isNumber(precision) && precision >= 0,
                 '[litecanvas] round() 2nd param must be a positive number or zero'
             )
+
             if (!precision) {
                 return math.round(n)
             }
@@ -216,6 +217,24 @@ export default function litecanvas(settings = {}) {
             return value
         },
 
+        /**
+         * Calculates the distance between a point (x1, y1) to another (x2, y2).
+         *
+         * @param {number} x1
+         * @param {number} y1
+         * @param {number} x2
+         * @param {number} y2
+         * @returns {number}
+         */
+        dist: (x1, y1, x2, y2) => {
+            DEV: assert(isNumber(x1), '[litecanvas] dist() 1st param must be a number')
+            DEV: assert(isNumber(y1), '[litecanvas] dist() 2nd param must be a number')
+            DEV: assert(isNumber(x2), '[litecanvas] dist() 3rd param must be a number')
+            DEV: assert(isNumber(y2), '[litecanvas] dist() 4th param must be a number')
+
+            return math.hypot(x2 - x1, y2 - y1)
+        },
+
         /**
          * Wraps a number between `min` (inclusive) and `max` (exclusive).
          *
@@ -285,25 +304,6 @@ export default function litecanvas(settings = {}) {
             return instance.map(value, start, stop, 0, 1)
         },
 
-        /**
-         * Interpolate between 2 values using a periodic function.
-         *
-         * @param {number} from - the lower bound
-         * @param {number} to - the higher bound
-         * @param {number} t - value passed to the periodic function
-         * @param {(n: number) => number} [fn] - the periodic function (which default to `Math.sin`)
-         */
-        wave: (from, to, t, fn = Math.sin) => {
-            DEV: assert(isNumber(from), '[litecanvas] wave() 1st param must be a number')
-            DEV: assert(isNumber(to), '[litecanvas] wave() 2nd param must be a number')
-            DEV: assert(isNumber(t), '[litecanvas] wave() 3rd param must be a number')
-            DEV: assert(
-                'function' === typeof fn,
-                '[litecanvas] wave() 4rd param must be a function (n: number) => number'
-            )
-            return from + ((fn(t) + 1) / 2) * (to - from)
-        },
-
         /** RNG API */
         /**
          * Generates a pseudorandom float between min (inclusive) and max (exclusive)
@@ -341,7 +341,7 @@ export default function litecanvas(settings = {}) {
             DEV: assert(isNumber(min), '[litecanvas] randi() 1st param must be a number')
             DEV: assert(isNumber(max), '[litecanvas] randi() 2nd param must be a number')
             DEV: assert(
-                max > min,
+                min <= max,
                 '[litecanvas] randi() the 1st param must be less than the 2nd param'
             )
 
@@ -360,6 +360,7 @@ export default function litecanvas(settings = {}) {
                 isNumber(value) && value >= 0,
                 '[litecanvas] rseed() 1st param must be a positive integer or zero'
             )
+
             _rngSeed = ~~value
         },
 
@@ -1084,7 +1085,7 @@ export default function litecanvas(settings = {}) {
             _eventListeners[eventName].add(callback)
 
             // return a function to remove this event listener
-            return () => _eventListeners && _eventListeners[eventName].delete(callback)
+            return () => _eventListeners[eventName]?.delete(callback)
         },
 
         /**
@@ -1229,7 +1230,7 @@ export default function litecanvas(settings = {}) {
                 // 2
                 _fpsInterval / 1000,
                 // 3
-                _scale,
+                _canvasScale,
                 // 4
                 _eventListeners,
                 // 5
@@ -1345,8 +1346,8 @@ export default function litecanvas(settings = {}) {
                      * @param {MouseEvent | Touch} ev
                      */
                     (ev) => [
-                        (ev.pageX - _canvas.offsetLeft) / _scale,
-                        (ev.pageY - _canvas.offsetTop) / _scale,
+                        (ev.pageX - _canvas.offsetLeft) / _canvasScale,
+                        (ev.pageY - _canvas.offsetTop) / _canvasScale,
                     ],
                 _taps = new Map(),
                 _registerTap =
@@ -1595,8 +1596,8 @@ export default function litecanvas(settings = {}) {
 
         // start the engine
         _initialized = true
-        instance.emit('init', instance)
         instance.resume()
+        instance.emit('init', instance)
     }
 
     function drawFrame() {
@@ -1695,11 +1696,11 @@ export default function litecanvas(settings = {}) {
                 _canvas.style.margin = 'auto'
             }
 
-            _scale = math.min(innerWidth / width, innerHeight / height)
-            _scale = maxScale > 1 && _scale > maxScale ? maxScale : _scale
+            _canvasScale = math.min(innerWidth / width, innerHeight / height)
+            _canvasScale = maxScale > 1 && _canvasScale > maxScale ? maxScale : _canvasScale
 
-            _canvas.style.width = width * _scale + 'px'
-            _canvas.style.height = height * _scale + 'px'
+            _canvas.style.width = width * _canvasScale + 'px'
+            _canvas.style.height = height * _canvasScale + 'px'
         }
 
         // set canvas image rendering properties
@@ -1710,7 +1711,7 @@ export default function litecanvas(settings = {}) {
 
         // trigger "resized" event
         // note: not triggered before the "init" event
-        instance.emit('resized', _scale)
+        instance.emit('resized', _canvasScale)
     }
 
     /**

package/src/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '0.102.2'
+export const version = '0.103.0'

package/types/global.d.ts

@@ -116,14 +116,15 @@ declare global {
      */
     function norm(value: number, start: number, stop: number): number
     /**
-     * Interpolate between 2 values using a periodic function.
+     * Calculates the distance between a point (x1, y1) to another (x2, y2).
      *
-     * @param from - the lower bound
-     * @param to - the higher bound
-     * @param t - the value passed to the periodic function
-     * @param fn= - the periodic function (which default to `Math.sin`)
+     * @param x1
+     * @param y1
+     * @param x2
+     * @param y2
+     * @returns the distance
      */
-    function wave(from: number, to: number, t: number, fn?: (n: number) => number): number
+    function dist(x1: number, y1: number, x2: number, y2: number): number
     /**
      * Returns the sine of a number in radians
      */

package/types/types.d.ts

@@ -110,14 +110,15 @@ type LitecanvasInstance = {
      */
     norm(value: number, start: number, stop: number): number
     /**
-     * Interpolate between 2 values using a periodic function.
+     * Calculates the distance between a point (x1, y1) to another (x2, y2).
      *
-     * @param from - the lower bound
-     * @param to - the higher bound
-     * @param t - the value passed to the periodic function
-     * @param fn - the periodic function (which default to `Math.sin`)
+     * @param x1
+     * @param y1
+     * @param x2
+     * @param y2
+     * @returns the distance
      */
-    wave(from: number, to: number, t: number, fn?: (n: number) => number): number
+    dist(x1: number, y1: number, x2: number, y2: number): number
     /**
      * Returns the sine of a number in radians
      */