litecanvas 0.208.0 → 0.300.0

package/README.md

@@ -342,8 +342,7 @@ Like `MX` and `MY`, Litecanvas also declares these other variables:
 - `H`: the height of the game canvas
 - `T`: the amount of seconds since the game started
 - `PI`: approximately 3.14 radians (or 180 degrees)
-- `TWO_PI`: approximately 6.28 radians (or 360 degrees)
-- `HALF_PI`: approximately 1.57 radians (or 90 degrees)
+- `TAU`: approximately 6.28 radians (or 360 degrees)
 
 ### And much more!
 

package/dist/dist.dev.js

@@ -115,12 +115,12 @@
   var assert = (condition, message = "Assertion failed") => {
     if (!condition) throw new Error("[Litecanvas] " + message);
   };
-  var version = "0.208.0";
+  var version = "0.300.0";
   function litecanvas(settings = {}) {
     const root = window,
       math = Math,
       perf = performance,
-      TWO_PI = math.PI * 2,
+      TAU = math.PI * 2,
       raf = requestAnimationFrame,
       isNumber = Number.isFinite,
       _browserEventListeners = [],
@@ -176,8 +176,7 @@
       T: 0,
       MX: -1,
       MY: -1,
-      TWO_PI,
-      HALF_PI: TWO_PI / 4,
+      TAU,
       lerp: (start, end, t) => {
         DEV: assert(isNumber(start), "lerp() 1st parameter must be a number");
         DEV: assert(isNumber(end), "lerp() 2nd parameter must be a number");
@@ -377,7 +376,7 @@
           "oval() 5th parameter must be a non-negative number",
         );
         beginPath(_ctx);
-        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TWO_PI);
+        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TAU);
         instance.stroke(color);
       },
       ovalfill(x, y, radiusX, radiusY, color) {
@@ -396,7 +395,7 @@
           "ovalfill() 5th parameter must be a non-negative number",
         );
         beginPath(_ctx);
-        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TWO_PI);
+        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TAU);
         instance.fill(color);
       },
       circ(x, y, radius, color) {
@@ -562,18 +561,19 @@
           "string" === typeof pixels,
           "spr() 3rd parameter must be a string",
         );
-        const rows = pixels.trim().split("\n");
-        for (let row = 0; row < rows.length; row++) {
-          const chars = rows[row].trim();
-          for (let col = 0; col < chars.length; col++) {
-            const char = chars[col];
-            if (char !== "." && char !== " ") {
+        const rows = pixels
+          .replace(/[^\w.\n]/g, "")
+          .split("\n")
+          .filter((s) => s);
+        for (let i = 0; i < rows.length; i++) {
+          for (let j = 0; j < rows[i].length; j++) {
+            if (rows[i][j] !== ".") {
               instance.rectfill(
-                x + col,
-                y + row,
+                x + j,
+                y + i,
                 1,
                 1,
-                parseInt(char, 36) || 0,
+                parseInt(rows[i][j], 36) || 0,
               );
             }
           }
@@ -877,6 +877,9 @@
         );
         return internals[index];
       },
+      ispaused() {
+        return _paused;
+      },
       pause() {
         if (!_paused) {
           _paused = true;
@@ -895,9 +898,6 @@
           instance.emit("resumed");
         }
       },
-      ispaused() {
-        return _paused;
-      },
       quit() {
         instance.emit("quit");
         instance.pause();
@@ -930,6 +930,7 @@
       }
     }
     function init() {
+      resizeCanvas();
       if (settings.autoscale) {
         on(root, "resize", resizeCanvas);
       }
@@ -1109,12 +1110,11 @@
       );
       _ctx = _canvas.getContext("2d");
       on(_canvas, "click", () => focus());
-      resizeCanvas();
       if (!_canvas.parentNode) {
         d.body.appendChild(_canvas);
       }
-      _canvas.style.imageRendering = "pixelated";
       _canvas.oncontextmenu = () => false;
+      resizeCanvas();
     }
     function resizeCanvas() {
       DEV: assert(
@@ -1131,6 +1131,11 @@
         null == settings.height || (settings.width > 0 && settings.height > 0),
         'litecanvas() option "width" is required when the option "height" is defined',
       );
+      DEV: assert(
+        "boolean" === typeof settings.autoscale ||
+          (isNumber(settings.autoscale) && settings.autoscale > 1),
+        'litecanvas() option "autoscale" must be boolean or a number > 1',
+      );
       const width = settings.width > 0 ? settings.width : innerWidth,
         height =
           settings.width > 0 ? settings.height || settings.width : innerHeight;
@@ -1138,6 +1143,7 @@
       instance.def("H", height);
       _canvas.width = width;
       _canvas.height = height;
+      _canvas.style = "image-rendering:pixelated";
       if (settings.autoscale) {
         let maxScale = +settings.autoscale;
         if (!_canvas.style.display) {

package/dist/dist.js

@@ -116,7 +116,7 @@
     const root = window,
       math = Math,
       perf = performance,
-      TWO_PI = math.PI * 2,
+      TAU = math.PI * 2,
       raf = requestAnimationFrame,
       isNumber = Number.isFinite,
       _browserEventListeners = [],
@@ -168,8 +168,7 @@
       T: 0,
       MX: -1,
       MY: -1,
-      TWO_PI,
-      HALF_PI: TWO_PI / 4,
+      TAU,
       lerp: (start, end, t) => {
         return start + t * (end - start);
       },
@@ -246,12 +245,12 @@
       },
       oval(x, y, radiusX, radiusY, color) {
         beginPath(_ctx);
-        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TWO_PI);
+        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TAU);
         instance.stroke(color);
       },
       ovalfill(x, y, radiusX, radiusY, color) {
         beginPath(_ctx);
-        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TWO_PI);
+        _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TAU);
         instance.fill(color);
       },
       circ(x, y, radius, color) {
@@ -316,18 +315,19 @@
         _ctx.drawImage(source, ~~x, ~~y);
       },
       spr(x, y, pixels) {
-        const rows = pixels.trim().split("\n");
-        for (let row = 0; row < rows.length; row++) {
-          const chars = rows[row].trim();
-          for (let col = 0; col < chars.length; col++) {
-            const char = chars[col];
-            if (char !== "." && char !== " ") {
+        const rows = pixels
+          .replace(/[^\w.\n]/g, "")
+          .split("\n")
+          .filter((s) => s);
+        for (let i = 0; i < rows.length; i++) {
+          for (let j = 0; j < rows[i].length; j++) {
+            if (rows[i][j] !== ".") {
               instance.rectfill(
-                x + col,
-                y + row,
+                x + j,
+                y + i,
                 1,
                 1,
-                parseInt(char, 36) || 0,
+                parseInt(rows[i][j], 36) || 0,
               );
             }
           }
@@ -485,6 +485,9 @@
         ];
         return internals[index];
       },
+      ispaused() {
+        return _paused;
+      },
       pause() {
         if (!_paused) {
           _paused = true;
@@ -499,9 +502,6 @@
           instance.emit("resumed");
         }
       },
-      ispaused() {
-        return _paused;
-      },
       quit() {
         instance.emit("quit");
         instance.pause();
@@ -531,6 +531,7 @@
       }
     }
     function init() {
+      resizeCanvas();
       if (settings.autoscale) {
         on(root, "resize", resizeCanvas);
       }
@@ -694,12 +695,11 @@
       _canvas = _canvas || d.createElement("canvas");
       _ctx = _canvas.getContext("2d");
       on(_canvas, "click", () => focus());
-      resizeCanvas();
       if (!_canvas.parentNode) {
         d.body.appendChild(_canvas);
       }
-      _canvas.style.imageRendering = "pixelated";
       _canvas.oncontextmenu = () => false;
+      resizeCanvas();
     }
     function resizeCanvas() {
       const width = settings.width > 0 ? settings.width : innerWidth,
@@ -709,6 +709,7 @@
       instance.def("H", height);
       _canvas.width = width;
       _canvas.height = height;
+      _canvas.style = "image-rendering:pixelated";
       if (settings.autoscale) {
         let maxScale = +settings.autoscale;
         if (!_canvas.style.display) {

package/dist/dist.min.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "litecanvas",
-    "version": "0.208.0",
+    "version": "0.300.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>",
@@ -34,13 +34,13 @@
     "devDependencies": {
         "@happy-dom/global-registrator": "^20.9.0",
         "@size-limit/preset-small-lib": "^12.1.0",
-        "@swc/core": "^1.15.33",
-        "ava": "^7.0.0",
+        "@swc/core": "^1.15.40",
+        "ava": "^8.0.1",
         "esbuild": "^0.28.0",
         "genversion": "^3.2.0",
         "gzip-size": "^7.0.0",
         "prettier": "^3.8.3",
-        "sinon": "^21.1.2",
+        "sinon": "^22.0.0",
         "size-limit": "^12.1.0",
         "tap-min": "^3.0.0"
     },

package/src/index.js

@@ -14,7 +14,7 @@ export default function litecanvas(settings = {}) {
     const root = window,
         math = Math,
         perf = performance,
-        TWO_PI = math.PI * 2,
+        TAU = math.PI * 2,
         raf = requestAnimationFrame,
         isNumber = Number.isFinite,
         /** @type {Function[]} */
@@ -117,20 +117,9 @@ export default function litecanvas(settings = {}) {
          * Twice the value of the mathematical constant PI (π).
          * Approximately 6.28318
          *
-         * Note: TWO_PI radians equals 360°, PI radians equals 180°,
-         * HALF_PI radians equals 90°, and HALF_PI/2 radians equals 45°.
-         *
          * @type {number}
          */
-        TWO_PI,
-
-        /**
-         * Half the value of the mathematical constant PI (π).
-         * Approximately 1.57079
-         *
-         * @type {number}
-         */
-        HALF_PI: TWO_PI / 4,
+        TAU,
 
         /**
          * Calculates a linear (interpolation) value over t%.
@@ -181,9 +170,6 @@ export default function litecanvas(settings = {}) {
          * @param {number} a dividend
          * @param {number} b divisor
          * @returns {number} the remainder
-         * @example
-         *      mod(-1, 5) // => 4
-         *      -1 % 5 // => -1
          */
         mod(a, b) {
             DEV: assert(isNumber(a), 'mod() 1st parameter must be a number')
@@ -499,7 +485,7 @@ export default function litecanvas(settings = {}) {
 
             beginPath(_ctx)
 
-            _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TWO_PI)
+            _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TAU)
             instance.stroke(color)
         },
 
@@ -530,7 +516,7 @@ export default function litecanvas(settings = {}) {
 
             beginPath(_ctx)
 
-            _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TWO_PI)
+            _ctx.ellipse(~~x, ~~y, ~~radiusX, ~~radiusY, 0, 0, TAU)
             instance.fill(color)
         },
 
@@ -776,7 +762,11 @@ export default function litecanvas(settings = {}) {
         },
 
         /**
-         * Draw a sprite pixel by pixel represented by a string. Each pixel must be a base 36 number (0-9 or a-z) or a dot.
+         * Draw a sprite, using a string of rows and columns representing a bitmask.
+         * - Each colored pixel must be a base 36 number (0-9 or a-z).
+         * - Use "." (dot) for transparent pixels.
+         * - Any other characters (like symbols) are ignored.
+         * - empty lines are ignored
          *
          * @param {number} x
          * @param {number} y
@@ -787,14 +777,15 @@ export default function litecanvas(settings = {}) {
             DEV: assert(isNumber(y), 'spr() 2nd parameter must be a number')
             DEV: assert('string' === typeof pixels, 'spr() 3rd parameter must be a string')
 
-            const rows = pixels.trim().split('\n')
+            const rows = pixels
+                .replace(/[^\w.\n]/g, '')
+                .split('\n')
+                .filter((s) => s)
 
-            for (let row = 0; row < rows.length; row++) {
-                const chars = rows[row].trim()
-                for (let col = 0; col < chars.length; col++) {
-                    const char = chars[col]
-                    if (char !== '.' && char !== ' ') {
-                        instance.rectfill(x + col, y + row, 1, 1, parseInt(char, 36) || 0)
+            for (let i = 0; i < rows.length; i++) {
+                for (let j = 0; j < rows[i].length; j++) {
+                    if (rows[i][j] !== '.') {
+                        instance.rectfill(x + j, y + i, 1, 1, parseInt(rows[i][j], 36) || 0)
                     }
                 }
             }
@@ -1331,6 +1322,15 @@ export default function litecanvas(settings = {}) {
             return internals[index]
         },
 
+        /**
+         * Returns `true` if the engine loop is paused.
+         *
+         * @returns {boolean}
+         */
+        ispaused() {
+            return _paused
+        },
+
         /**
          * Pauses the engine loop (update & draw).
          */
@@ -1358,15 +1358,6 @@ export default function litecanvas(settings = {}) {
             }
         },
 
-        /**
-         * Returns `true` if the engine loop is paused.
-         *
-         * @returns {boolean}
-         */
-        ispaused() {
-            return _paused
-        },
-
         /**
          * Shutdown the litecanvas instance and remove all event listeners.
          */
@@ -1416,6 +1407,8 @@ export default function litecanvas(settings = {}) {
     }
 
     function init() {
+        resizeCanvas()
+
         // listen window resize event when "autoscale" is enabled
         if (settings.autoscale) {
             on(root, 'resize', resizeCanvas)
@@ -1743,16 +1736,14 @@ export default function litecanvas(settings = {}) {
 
         on(_canvas, 'click', () => focus())
 
-        resizeCanvas()
-
         if (!_canvas.parentNode) {
             d.body.appendChild(_canvas)
         }
 
-        _canvas.style.imageRendering = 'pixelated'
-
         // disable default browser's right click in canvas
         _canvas.oncontextmenu = () => false
+
+        resizeCanvas()
     }
 
     function resizeCanvas() {
@@ -1769,6 +1760,11 @@ export default function litecanvas(settings = {}) {
 
             'litecanvas() option "width" is required when the option "height" is defined'
         )
+        DEV: assert(
+            'boolean' === typeof settings.autoscale ||
+                (isNumber(settings.autoscale) && settings.autoscale > 1),
+            'litecanvas() option "autoscale" must be boolean or a number > 1'
+        )
 
         const width = settings.width > 0 ? settings.width : innerWidth,
             height = settings.width > 0 ? settings.height || settings.width : innerHeight
@@ -1779,6 +1775,9 @@ export default function litecanvas(settings = {}) {
         _canvas.width = width
         _canvas.height = height
 
+        /** @ts-ignore */
+        _canvas.style = 'image-rendering:pixelated'
+
         if (settings.autoscale) {
             let maxScale = +settings.autoscale
             if (!_canvas.style.display) {

package/src/version.js

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

package/types/global.d.ts

@@ -25,16 +25,8 @@ declare global {
     /**
      * Twice the value of the mathematical constant PI (π).
      * Approximately 6.28318
-     *
-     * Note: TWO_PI radians equals 360°, PI radians equals 180°,
-     * HALF_PI radians equals 90°, and HALF_PI/2 radians equals 45°.
-     */
-    var TWO_PI: number
-    /**
-     * Half the value of the mathematical constant PI (π).
-     * Approximately 1.57079
      */
-    var HALF_PI: number
+    var TAU: number
     /**
      * Calculates a linear (interpolation) value over t%.
      *
@@ -68,8 +60,8 @@ declare global {
      * @param b divisor
      * @returns the remainder
      * @example
-     *      mod(-1, 5) // => 4
-     *      -1 % 5 // => -1
+     * mod(-1, 5) // => 4
+     * -1 % 5 // => -1
      */
     function mod(a: number, b: number): number
     /**
@@ -401,15 +393,32 @@ declare global {
      */
     function image(x: number, y: number, source: CanvasImageSource): void
     /**
-     * Draw a sprite pixel by pixel represented by a string. Each pixel must be a base 36 number or a dot:
-     *
-     * - A base 36 number (`0-9` or `a-z`) represent a pixel color (supporting color palettes with max 36 colors).
-     * - A dot (`.`) represent a transparent pixel.
-     * - Spaces are ignored and can be used to improve the visualization.
+     * Draw a sprite, using a string of rows and columns representing a bitmask.
+     * - Each colored pixel must be a base 36 number (0-9 or a-z).
+     * - Use "." (dot) for transparent pixels.
+     * - Any other characters (like symbols) are ignored.
+     * - empty lines are ignored
      *
-     * @param x the position X of the first pixel
-     * @param y the position Y of the first pixel
+     * @param x
+     * @param y
      * @param pixels
+     * @see https://litecanvas.js.org/tools/pixel-art-editor.html
+     * @example
+     * function draw() {
+     *   // a little white key 8x8 sprite
+     *   const littleKeySprite = `
+     *     ........
+     *     .3......
+     *     323.....
+     *     3.333333
+     *     3.322323
+     *     232..2.2
+     *     .2......
+     *     ........
+     *   `
+     *   // draw the sprite pixels at position x=10, y=10
+     *   spr(10, 10, littleKeySprite)
+     * }
      */
     function spr(x: number, y: number, pixels: string): void
     /**

package/types/types.d.ts

@@ -19,16 +19,8 @@ type LitecanvasInstance = {
     /**
      * Twice the value of the mathematical constant PI (π).
      * Approximately 6.28318
-     *
-     * Note: TWO_PI radians equals 360°, PI radians equals 180°,
-     * HALF_PI radians equals 90°, and HALF_PI/2 radians equals 45°.
-     */
-    TWO_PI: number
-    /**
-     * Half the value of the mathematical constant PI (π).
-     * Approximately 1.57079
      */
-    HALF_PI: number
+    TAU: number
     /**
      * Calculates a linear (interpolation) value over t%.
      *
@@ -62,8 +54,8 @@ type LitecanvasInstance = {
      * @param b divisor
      * @returns the remainder
      * @example
-     *      mod(-1, 5) // => 4
-     *      -1 % 5 // => -1
+     * mod(-1, 5) // => 4
+     * -1 % 5 // => -1
      */
     mod(a: number, b: number): number
     /**
@@ -389,15 +381,32 @@ type LitecanvasInstance = {
      */
     image(x: number, y: number, source: CanvasImageSource): void
     /**
-     * Draw a sprite pixel by pixel represented by a string. Each pixel must be a base 36 number or a dot:
-     *
-     * - A base 36 number (`0-9` or `a-z`) represent a pixel color (supporting color palettes with max 36 colors).
-     * - A dot (`.`) represent a transparent pixel.
-     * - Spaces are ignored and can be used to improve the visualization.
+     * Draw a sprite, using a string of rows and columns representing a bitmask.
+     * - Each colored pixel must be a base 36 number (0-9 or a-z).
+     * - Use "." (dot) for transparent pixels.
+     * - Any other characters (like symbols) are ignored.
+     * - empty lines are ignored
      *
-     * @param x the position X of the first pixel
-     * @param y the position Y of the first pixel
+     * @param x
+     * @param y
      * @param pixels
+     * @see https://litecanvas.js.org/tools/pixel-art-editor.html
+     * @example
+     * function draw() {
+     *   // a little white key 8x8 sprite
+     *   const littleKeySprite = `
+     *     ........
+     *     .3......
+     *     323.....
+     *     3.333333
+     *     3.322323
+     *     232..2.2
+     *     .2......
+     *     ........
+     *   `
+     *   // draw the sprite pixels at position x=10, y=10
+     *   spr(10, 10, littleKeySprite)
+     * }
      */
     spr(x: number, y: number, pixels: string): void
     /**