litecanvas 0.90.0 → 0.92.0

package/README.md

@@ -28,22 +28,16 @@ Litecanvas is a lightweight HTML5 canvas 2D engine suitable for small web games,
 
 ## Getting Started
 
-You can try our [online playground](https://litecanvas.github.io) or just installing the [basic template](https://github.com/litecanvas/template):
+You can try our [online playground](https://litecanvas.github.io) or install the [basic template](https://github.com/litecanvas/template):
 
 ```sh
-# requires Node.js
+# requires Node.js & NPM
 npx tiged litecanvas/template my-game
 cd my-game
 npm install
 npm run dev
 ```
 
-If you prefer, you can manually install via [NPM](https://www.npmjs.com/package/litecanvas):
-
-```
-npm install litecanvas
-```
-
 ### Show me the code!
 
 ```js

package/dist/dist.dev.js

@@ -32,7 +32,7 @@
   };
 
   // src/version.js
-  var version = "0.90.0";
+  var version = "0.92.0";
 
   // src/index.js
   function litecanvas(settings = {}) {
@@ -811,10 +811,7 @@
         );
         DEV: assert(isNumber(pitchSlide), "[litecanvas] sfx() 2nd param must be a number");
         DEV: assert(isNumber(volumeFactor), "[litecanvas] sfx() 3rd param must be a number");
-        if (
-          // @ts-ignore
-          root.zzfxV <= 0 || navigator.userActivation && !navigator.userActivation.hasBeenActive
-        ) {
+        if (root.zzfxV <= 0 || navigator.userActivation && !navigator.userActivation.hasBeenActive) {
           return false;
         }
         zzfxParams = zzfxParams || _defaultSound;
@@ -926,7 +923,9 @@
       def(key, value) {
         DEV: assert("string" === typeof key, "[litecanvas] def() 1st param must be a string");
         DEV: if (null == value) {
-          console.warn(`def: key "${key}" was defined as ${value} but now is null`);
+          console.warn(
+            `[litecanvas] def() changed the key "${key}" to null (previous value was ${instance[key]})`
+          );
         }
         instance[key] = value;
         if (settings.global) {
@@ -985,8 +984,7 @@
           // 7
           _timeScale,
           // 8
-          // @ts-ignore
-          root.zzfxV || 1,
+          root.zzfxV,
           // 9
           _rngSeed,
           // 10
@@ -1060,12 +1058,11 @@
       if (settings.tapEvents) {
         const _getXY = (
           /**
-           * @param {number} pageX
-           * @param {number} pageY
+           * @param {MouseEvent | Touch} ev
            */
-          (pageX, pageY) => [
-            (pageX - _canvas.offsetLeft) / _scale,
-            (pageY - _canvas.offsetTop) / _scale
+          (ev) => [
+            (ev.pageX - _canvas.offsetLeft) / _scale,
+            (ev.pageY - _canvas.offsetTop) / _scale
           ]
         ), _taps = /* @__PURE__ */ new Map(), _registerTap = (
           /**
@@ -1121,7 +1118,7 @@
           (ev) => {
             if (ev.button === 0) {
               preventDefault(ev);
-              const [x, y] = _getXY(ev.pageX, ev.pageY);
+              const [x, y] = _getXY(ev);
               instance.emit("tap", x, y, 0);
               _registerTap(0, x, y);
               _pressingMouse = true;
@@ -1138,7 +1135,7 @@
             if (ev.button === 0) {
               preventDefault(ev);
               const tap = _taps.get(0);
-              const [x, y] = _getXY(ev.pageX, ev.pageY);
+              const [x, y] = _getXY(ev);
               if (_checkTapped(tap)) {
                 instance.emit("tapped", tap.xi, tap.yi, 0);
               }
@@ -1149,14 +1146,14 @@
           }
         );
         on(
-          _canvas,
+          root,
           "mousemove",
           /**
            * @param {MouseEvent} ev
            */
           (ev) => {
             preventDefault(ev);
-            const [x, y] = _getXY(ev.pageX, ev.pageY);
+            const [x, y] = _getXY(ev);
             instance.def("MX", x);
             instance.def("MY", y);
             if (!_pressingMouse) return;
@@ -1174,7 +1171,7 @@
             preventDefault(ev);
             const touches = ev.changedTouches;
             for (const touch of touches) {
-              const [x, y] = _getXY(touch.pageX, touch.pageY);
+              const [x, y] = _getXY(touch);
               instance.emit("tap", x, y, touch.identifier + 1);
               _registerTap(touch.identifier + 1, x, y);
             }
@@ -1190,7 +1187,7 @@
             preventDefault(ev);
             const touches = ev.changedTouches;
             for (const touch of touches) {
-              const [x, y] = _getXY(touch.pageX, touch.pageY);
+              const [x, y] = _getXY(touch);
               instance.emit("tapping", x, y, touch.identifier + 1);
               _updateTap(touch.identifier + 1, x, y);
             }

package/dist/dist.js

@@ -558,10 +558,7 @@
        * @see https://github.com/KilledByAPixel/ZzFX
        */
       sfx(zzfxParams, pitchSlide = 0, volumeFactor = 1) {
-        if (
-          // @ts-ignore
-          root.zzfxV <= 0 || navigator.userActivation && !navigator.userActivation.hasBeenActive
-        ) {
+        if (root.zzfxV <= 0 || navigator.userActivation && !navigator.userActivation.hasBeenActive) {
           return false;
         }
         zzfxParams = zzfxParams || _defaultSound;
@@ -694,8 +691,7 @@
           // 7
           _timeScale,
           // 8
-          // @ts-ignore
-          root.zzfxV || 1,
+          root.zzfxV,
           // 9
           _rngSeed,
           // 10
@@ -766,12 +762,11 @@
       if (settings.tapEvents) {
         const _getXY = (
           /**
-           * @param {number} pageX
-           * @param {number} pageY
+           * @param {MouseEvent | Touch} ev
            */
-          (pageX, pageY) => [
-            (pageX - _canvas.offsetLeft) / _scale,
-            (pageY - _canvas.offsetTop) / _scale
+          (ev) => [
+            (ev.pageX - _canvas.offsetLeft) / _scale,
+            (ev.pageY - _canvas.offsetTop) / _scale
           ]
         ), _taps = /* @__PURE__ */ new Map(), _registerTap = (
           /**
@@ -827,7 +822,7 @@
           (ev) => {
             if (ev.button === 0) {
               preventDefault(ev);
-              const [x, y] = _getXY(ev.pageX, ev.pageY);
+              const [x, y] = _getXY(ev);
               instance.emit("tap", x, y, 0);
               _registerTap(0, x, y);
               _pressingMouse = true;
@@ -844,7 +839,7 @@
             if (ev.button === 0) {
               preventDefault(ev);
               const tap = _taps.get(0);
-              const [x, y] = _getXY(ev.pageX, ev.pageY);
+              const [x, y] = _getXY(ev);
               if (_checkTapped(tap)) {
                 instance.emit("tapped", tap.xi, tap.yi, 0);
               }
@@ -855,14 +850,14 @@
           }
         );
         on(
-          _canvas,
+          root,
           "mousemove",
           /**
            * @param {MouseEvent} ev
            */
           (ev) => {
             preventDefault(ev);
-            const [x, y] = _getXY(ev.pageX, ev.pageY);
+            const [x, y] = _getXY(ev);
             instance.def("MX", x);
             instance.def("MY", y);
             if (!_pressingMouse) return;
@@ -880,7 +875,7 @@
             preventDefault(ev);
             const touches = ev.changedTouches;
             for (const touch of touches) {
-              const [x, y] = _getXY(touch.pageX, touch.pageY);
+              const [x, y] = _getXY(touch);
               instance.emit("tap", x, y, touch.identifier + 1);
               _registerTap(touch.identifier + 1, x, y);
             }
@@ -896,7 +891,7 @@
             preventDefault(ev);
             const touches = ev.changedTouches;
             for (const touch of touches) {
-              const [x, y] = _getXY(touch.pageX, touch.pageY);
+              const [x, y] = _getXY(touch);
               instance.emit("tapping", x, y, touch.identifier + 1);
               _updateTap(touch.identifier + 1, x, y);
             }

package/dist/dist.min.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "litecanvas",
-    "version": "0.90.0",
+    "version": "0.92.0",
     "description": "Lightweight HTML5 canvas 2D game engine suitable for small projects and creative coding. Inspired by PICO-8 and P5/Processing.",
     "license": "MIT",
     "author": "Luiz Bills <luizbills@pm.me>",
@@ -14,8 +14,25 @@
         "url": "https://github.com/litecanvas/game-engine/issues"
     },
     "type": "module",
-    "main": "src/index.js",
-    "types": "types/index.d.ts",
+    "main": "./src/index.js",
+    "module": "./src/index.js",
+    "types": "./types/index.d.ts",
+    "exports": {
+        ".": {
+            "import": {
+                "types": "./types/index.d.ts",
+                "default": "./src/index.js"
+            }
+        },
+        "./global": "./src/index.js"
+    },
+    "typesVersions": {
+        "*": {
+            "./global": [
+                "./types/global.d.ts"
+            ]
+        }
+    },
     "keywords": [
         "canvas",
         "2d",
@@ -33,7 +50,7 @@
         "@size-limit/preset-small-lib": "^11.2.0",
         "@swc/core": "^1.12.11",
         "@types/jsdom": "^21.1.7",
-        "ava": "^6.4.0",
+        "ava": "^6.4.1",
         "esbuild": "^0.25.6",
         "genversion": "^3.2.0",
         "gzip-size": "^7.0.0",

package/src/index.js

@@ -87,7 +87,7 @@ export default function litecanvas(settings = {}) {
          */
         _eventListeners = {}
 
-    /** @type {Omit<LitecanvasInstance,'PI'|'sin'|'cos'|'atan2'|'hypot'|'tan'|'abs'|'ceil'|'floor'|'trunc'|'min'|'max'|'pow'|'sqrt'|'sign'|'exp'|'iskeydown'|'iskeypressed'>} */
+    /** @type {LitecanvasInstance} */
     const instance = {
         /** @type {number} */
         W: 0,
@@ -945,7 +945,6 @@ export default function litecanvas(settings = {}) {
             DEV: assert(isNumber(volumeFactor), '[litecanvas] sfx() 3rd param must be a number')
 
             if (
-                // @ts-ignore
                 root.zzfxV <= 0 ||
                 (navigator.userActivation && !navigator.userActivation.hasBeenActive)
             ) {
@@ -975,7 +974,6 @@ export default function litecanvas(settings = {}) {
         volume(value) {
             DEV: assert(isNumber(value), '[litecanvas] volume() 1st param must be a number')
 
-            // @ts-ignore
             root.zzfxV = value
         },
 
@@ -1082,7 +1080,9 @@ export default function litecanvas(settings = {}) {
         def(key, value) {
             DEV: assert('string' === typeof key, '[litecanvas] def() 1st param must be a string')
             DEV: if (null == value) {
-                console.warn(`def: key "${key}" was defined as ${value} but now is null`)
+                console.warn(
+                    `[litecanvas] def() changed the key "${key}" to null (previous value was ${instance[key]})`
+                )
             }
 
             instance[key] = value
@@ -1148,8 +1148,7 @@ export default function litecanvas(settings = {}) {
                 // 7
                 _timeScale,
                 // 8
-                // @ts-ignore
-                root.zzfxV || 1,
+                root.zzfxV,
                 // 9
                 _rngSeed,
                 // 10
@@ -1189,7 +1188,6 @@ export default function litecanvas(settings = {}) {
                 for (const key in instance) {
                     delete root[key]
                 }
-                // @ts-ignore
                 delete root.ENGINE
             }
 
@@ -1254,12 +1252,11 @@ export default function litecanvas(settings = {}) {
         if (settings.tapEvents) {
             const _getXY =
                     /**
-                     * @param {number} pageX
-                     * @param {number} pageY
+                     * @param {MouseEvent | Touch} ev
                      */
-                    (pageX, pageY) => [
-                        (pageX - _canvas.offsetLeft) / _scale,
-                        (pageY - _canvas.offsetTop) / _scale,
+                    (ev) => [
+                        (ev.pageX - _canvas.offsetLeft) / _scale,
+                        (ev.pageY - _canvas.offsetTop) / _scale,
                     ],
                 _taps = new Map(),
                 _registerTap =
@@ -1317,7 +1314,7 @@ export default function litecanvas(settings = {}) {
                 (ev) => {
                     if (ev.button === 0) {
                         preventDefault(ev)
-                        const [x, y] = _getXY(ev.pageX, ev.pageY)
+                        const [x, y] = _getXY(ev)
                         instance.emit('tap', x, y, 0)
                         _registerTap(0, x, y)
                         _pressingMouse = true
@@ -1335,7 +1332,7 @@ export default function litecanvas(settings = {}) {
                     if (ev.button === 0) {
                         preventDefault(ev)
                         const tap = _taps.get(0)
-                        const [x, y] = _getXY(ev.pageX, ev.pageY)
+                        const [x, y] = _getXY(ev)
                         if (_checkTapped(tap)) {
                             instance.emit('tapped', tap.xi, tap.yi, 0)
                         }
@@ -1347,7 +1344,7 @@ export default function litecanvas(settings = {}) {
             )
 
             on(
-                _canvas,
+                root,
                 'mousemove',
                 /**
                  * @param {MouseEvent} ev
@@ -1355,7 +1352,7 @@ export default function litecanvas(settings = {}) {
                 (ev) => {
                     preventDefault(ev)
 
-                    const [x, y] = _getXY(ev.pageX, ev.pageY)
+                    const [x, y] = _getXY(ev)
                     instance.def('MX', x)
                     instance.def('MY', y)
 
@@ -1377,7 +1374,7 @@ export default function litecanvas(settings = {}) {
                     /** @type {TouchList} touches */
                     const touches = ev.changedTouches
                     for (const touch of touches) {
-                        const [x, y] = _getXY(touch.pageX, touch.pageY)
+                        const [x, y] = _getXY(touch)
                         instance.emit('tap', x, y, touch.identifier + 1)
                         _registerTap(touch.identifier + 1, x, y)
                     }
@@ -1394,7 +1391,7 @@ export default function litecanvas(settings = {}) {
                     preventDefault(ev)
                     const touches = ev.changedTouches
                     for (const touch of touches) {
-                        const [x, y] = _getXY(touch.pageX, touch.pageY)
+                        const [x, y] = _getXY(touch)
                         instance.emit('tapping', x, y, touch.identifier + 1)
                         _updateTap(touch.identifier + 1, x, y)
                     }
@@ -1569,7 +1566,7 @@ export default function litecanvas(settings = {}) {
 
         on(_canvas, 'click', () => root.focus())
 
-        // @ts-ignore
+        /** @ts-ignore */
         _canvas.style = ''
 
         resizeCanvas()
@@ -1658,7 +1655,6 @@ export default function litecanvas(settings = {}) {
      * @param {*} config
      */
     function loadPlugin(callback, config) {
-        // @ts-ignore
         const pluginData = callback(instance, config)
 
         DEV: assert(
@@ -1672,12 +1668,10 @@ export default function litecanvas(settings = {}) {
     }
 
     if (settings.global) {
-        // @ts-ignore
         if (root.ENGINE) {
             throw new Error('only one global litecanvas is allowed')
         }
         Object.assign(root, instance)
-        // @ts-ignore
         root.ENGINE = instance
     }
 
@@ -1692,6 +1686,5 @@ export default function litecanvas(settings = {}) {
         raf(init)
     }
 
-    // @ts-ignore
     return instance
 }

package/src/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '0.90.0';
+export const version = '0.92.0';

package/src/web.js

@@ -1,6 +1,3 @@
 import litecanvas from './index.js'
 
-/**
- * @global
- */
 globalThis.litecanvas = litecanvas