litecanvas 0.401.0 → 0.402.0

package/dist/dist.dev.js

@@ -115,7 +115,15 @@
   var assert = (condition, message = "Assertion failed") => {
     if (!condition) throw new Error("[Litecanvas] " + message);
   };
-  var version = "0.401.0";
+  var version = "0.402.0";
+  var mulberry32 = (seed) => {
+    return () => {
+      let t = (seed += 1831565813);
+      t = Math.imul(t ^ (t >>> 15), t | 1);
+      t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+      return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+  };
   function litecanvas(settings = {}) {
     const root = window,
       math = Math,
@@ -166,6 +174,7 @@
       _fontSize = 20,
       _fontLineHeight = 1.2,
       _rngSeed = Date.now(),
+      _rngNext = mulberry32(_rngSeed >>> 0),
       _currentPalette = defaultPalette,
       _lastPalette = defaultPalette,
       _colorPaletteState = [],
@@ -177,6 +186,32 @@
       T: 0,
       MX: -1,
       MY: -1,
+      rand: (min = 0, max = 1) => {
+        DEV: assert(isNumber(min), "rand() 1st argument must be a number");
+        DEV: assert(isNumber(max), "rand() 2nd argument must be a number");
+        DEV: assert(
+          max >= min,
+          "rand() the 1st argument must be less than the 2nd argument",
+        );
+        return min + _rngNext() * (max - min);
+      },
+      randi: (min = 0, max = 1) => {
+        DEV: assert(isNumber(min), "randi() 1st argument must be a number");
+        DEV: assert(isNumber(max), "randi() 2nd argument must be a number");
+        DEV: assert(
+          max >= min,
+          "randi() the 1st argument must be less than the 2nd argument",
+        );
+        return ~~instance.rand(min, max + 1);
+      },
+      rseed(value) {
+        DEV: assert(
+          isNumber(value) && value >= 0,
+          "rseed() 1st argument must be a non-negative integer",
+        );
+        _rngSeed = value;
+        _rngNext = mulberry32(_rngSeed >>> 0);
+      },
       TAU,
       lerp: (start, end, t) => {
         DEV: assert(isNumber(start), "lerp() 1st argument must be a number");
@@ -265,35 +300,6 @@
         );
         return instance.map(value, start, stop, 0, 1);
       },
-      rand: (min = 0, max = 1) => {
-        DEV: assert(isNumber(min), "rand() 1st argument must be a number");
-        DEV: assert(isNumber(max), "rand() 2nd argument must be a number");
-        DEV: assert(
-          max >= min,
-          "rand() the 1st argument must be less than the 2nd argument",
-        );
-        const a = 1664525;
-        const c = 1013904223;
-        const m = 4294967296;
-        _rngSeed = (a * _rngSeed + c) % m;
-        return (_rngSeed / m) * (max - min) + min;
-      },
-      randi: (min = 0, max = 1) => {
-        DEV: assert(isNumber(min), "randi() 1st argument must be a number");
-        DEV: assert(isNumber(max), "randi() 2nd argument must be a number");
-        DEV: assert(
-          max >= min,
-          "randi() the 1st argument must be less than the 2nd argument",
-        );
-        return ~~instance.rand(min, max + 1);
-      },
-      rseed(value) {
-        DEV: assert(
-          isNumber(value) && value >= 0,
-          "rseed() 1st argument must be a non-negative integer",
-        );
-        _rngSeed = ~~value;
-      },
       cls(color) {
         DEV: assert(
           null == color ||
@@ -1221,3 +1227,16 @@
   }
   window.litecanvas = litecanvas;
 })();
+/**
+ * Mulberry32 is a 32-bit pseudo-random number generator (PRNG).
+ * You provide a 32-bit seed, and it produces a deterministic sequence of values.
+ * The same seed always gives the same sequence.
+ *
+ * @copyright https://gist.github.com/tommyettinger/46a874533244883189143505d203312c
+ * @license CC0-1.0 (Public Domain)
+ *
+ * @param {number} seed an unsigned 32-bit integer
+ * @param {number} t
+ * @param {typeof Math.imul} i
+ * @returns {() => number}
+ */

package/dist/dist.js

@@ -112,6 +112,14 @@
     };
   };
   var defaultPalette = ["#211e20", "#555568", "#a0a08b", "#e9efec"];
+  var mulberry32 = (seed) => {
+    return () => {
+      let t = (seed += 1831565813);
+      t = Math.imul(t ^ (t >>> 15), t | 1);
+      t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+      return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+  };
   function litecanvas(settings = {}) {
     const root = window,
       math = Math,
@@ -158,6 +166,7 @@
       _fontSize = 20,
       _fontLineHeight = 1.2,
       _rngSeed = Date.now(),
+      _rngNext = mulberry32(_rngSeed >>> 0),
       _currentPalette = defaultPalette,
       _lastPalette = defaultPalette,
       _colorPaletteState = [],
@@ -169,6 +178,16 @@
       T: 0,
       MX: -1,
       MY: -1,
+      rand: (min = 0, max = 1) => {
+        return min + _rngNext() * (max - min);
+      },
+      randi: (min = 0, max = 1) => {
+        return ~~instance.rand(min, max + 1);
+      },
+      rseed(value) {
+        _rngSeed = value;
+        _rngNext = mulberry32(_rngSeed >>> 0);
+      },
       TAU,
       lerp: (start, end, t) => {
         return start + t * (end - start);
@@ -208,19 +227,6 @@
       norm: (value, start, stop) => {
         return instance.map(value, start, stop, 0, 1);
       },
-      rand: (min = 0, max = 1) => {
-        const a = 1664525;
-        const c = 1013904223;
-        const m = 4294967296;
-        _rngSeed = (a * _rngSeed + c) % m;
-        return (_rngSeed / m) * (max - min) + min;
-      },
-      randi: (min = 0, max = 1) => {
-        return ~~instance.rand(min, max + 1);
-      },
-      rseed(value) {
-        _rngSeed = ~~value;
-      },
       cls(color) {
         if (null == color) {
           _ctx.clearRect(0, 0, instance.W, instance.H);
@@ -754,3 +760,16 @@
   }
   window.litecanvas = litecanvas;
 })();
+/**
+ * Mulberry32 is a 32-bit pseudo-random number generator (PRNG).
+ * You provide a 32-bit seed, and it produces a deterministic sequence of values.
+ * The same seed always gives the same sequence.
+ *
+ * @copyright https://gist.github.com/tommyettinger/46a874533244883189143505d203312c
+ * @license CC0-1.0 (Public Domain)
+ *
+ * @param {number} seed an unsigned 32-bit integer
+ * @param {number} t
+ * @param {typeof Math.imul} i
+ * @returns {() => number}
+ */

package/dist/dist.min.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "litecanvas",
-    "version": "0.401.0",
+    "version": "0.402.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>",
@@ -32,10 +32,10 @@
         "creative coding"
     ],
     "devDependencies": {
-        "@happy-dom/global-registrator": "^21.0.1",
+        "@happy-dom/global-registrator": "^21.0.3",
         "@size-limit/preset-small-lib": "^14.2.0",
         "@swc/core": "^1.16.18",
-        "ava": "^8.0.1",
+        "ava": "^8.1.0",
         "esbuild": "^0.28.2",
         "genversion": "^3.2.0",
         "gzip-size": "^7.0.0",

package/src/index.js

@@ -3,6 +3,7 @@ import { setupZzFX } from './zzfx.js'
 import { defaultPalette } from './palette.js'
 import { assert } from './dev.js'
 import { version } from './version.js'
+import { mulberry32 } from './mulberry32.js'
 
 /**
  * The litecanvas constructor
@@ -84,13 +85,15 @@ export default function litecanvas(settings = {}) {
         _fontLineHeight = 1.2,
         /** @type {number} */
         _rngSeed = Date.now(),
+        /** @type {() => number} */
+        _rngNext = mulberry32(_rngSeed >>> 0),
         /** @type {string[]} */
         _currentPalette = defaultPalette,
         /** @type {string[]} */
         _lastPalette = defaultPalette,
         /** @type {number[]} */
         _colorPaletteState = [],
-        /** @type {number[]} */
+        /** @type {(number|undefined)[]} */
         _defaultSound = [0.5, 0, 1750, , , 0.3, 1, , , , 600, 0.1],
         /**
          * @type {Object<string,Set<Function>>} game event listeners
@@ -114,6 +117,54 @@ export default function litecanvas(settings = {}) {
         /** @type {number} */
         MY: -1,
 
+        /** RNG API */
+        /**
+         * Generates a pseudo random float between min (inclusive) and max (exclusive)
+         * using the Mulberry32 algorithm.
+         *
+         * @param {number} [min=0.0]
+         * @param {number} [max=1.0]
+         * @returns {number} the random number
+         */
+        rand: (min = 0.0, max = 1.0) => {
+            DEV: assert(isNumber(min), 'rand() 1st argument must be a number')
+            DEV: assert(isNumber(max), 'rand() 2nd argument must be a number')
+            DEV: assert(max >= min, 'rand() the 1st argument must be less than the 2nd argument')
+
+            return min + _rngNext() * (max - min)
+        },
+
+        /**
+         * Generates a pseudo random integer between min (inclusive) and max (inclusive).
+         *
+         * @param {number} [min=0]
+         * @param {number} [max=1]
+         * @returns {number} the random number
+         */
+        randi: (min = 0, max = 1) => {
+            DEV: assert(isNumber(min), 'randi() 1st argument must be a number')
+            DEV: assert(isNumber(max), 'randi() 2nd argument must be a number')
+            DEV: assert(max >= min, 'randi() the 1st argument must be less than the 2nd argument')
+
+            return ~~instance.rand(min, max + 1)
+        },
+
+        /**
+         * Initializes the random number generator with an explicit seed value.
+         *
+         * Note: The seed should be a integer number greater than or equal to zero.
+         *
+         * @param {number} value
+         */
+        rseed(value) {
+            DEV: assert(
+                isNumber(value) && value >= 0,
+                'rseed() 1st argument must be a non-negative integer'
+            )
+            _rngSeed = value
+            _rngNext = mulberry32(_rngSeed >>> 0)
+        },
+
         /** MATH API */
         /**
          * Twice the value of the mathematical constant PI (π).
@@ -306,60 +357,6 @@ export default function litecanvas(settings = {}) {
             return instance.map(value, start, stop, 0, 1)
         },
 
-        /** RNG API */
-        /**
-         * Generates a pseudorandom float between min (inclusive) and max (exclusive)
-         * using the Linear Congruential Generator (LCG) algorithm.
-         *
-         * @param {number} [min=0.0]
-         * @param {number} [max=1.0]
-         * @returns {number} the random number
-         */
-        rand: (min = 0.0, max = 1.0) => {
-            DEV: assert(isNumber(min), 'rand() 1st argument must be a number')
-            DEV: assert(isNumber(max), 'rand() 2nd argument must be a number')
-            DEV: assert(max >= min, 'rand() the 1st argument must be less than the 2nd argument')
-
-            const a = 1664525
-            const c = 1013904223
-            const m = 4294967296
-
-            _rngSeed = (a * _rngSeed + c) % m
-
-            return (_rngSeed / m) * (max - min) + min
-        },
-
-        /**
-         * Generates a pseudorandom integer between min (inclusive) and max (inclusive)
-         *
-         * @param {number} [min=0]
-         * @param {number} [max=1]
-         * @returns {number} the random number
-         */
-        randi: (min = 0, max = 1) => {
-            DEV: assert(isNumber(min), 'randi() 1st argument must be a number')
-            DEV: assert(isNumber(max), 'randi() 2nd argument must be a number')
-            DEV: assert(max >= min, 'randi() the 1st argument must be less than the 2nd argument')
-
-            return ~~instance.rand(min, max + 1)
-        },
-
-        /**
-         * Initializes the random number generator with an explicit seed value.
-         *
-         * Note: The seed should be a integer number greater than or equal to zero.
-         *
-         * @param {number} value
-         */
-        rseed(value) {
-            DEV: assert(
-                isNumber(value) && value >= 0,
-                'rseed() 1st argument must be a non-negative integer'
-            )
-
-            _rngSeed = ~~value
-        },
-
         /** BASIC GRAPHICS API */
         /**
          * Clear the game screen with an optional color.

package/src/mulberry32.js

@@ -0,0 +1,21 @@
+/**
+ * Mulberry32 is a 32-bit pseudo-random number generator (PRNG).
+ * You provide a 32-bit seed, and it produces a deterministic sequence of values.
+ * The same seed always gives the same sequence.
+ *
+ * @copyright https://gist.github.com/tommyettinger/46a874533244883189143505d203312c
+ * @license CC0-1.0 (Public Domain)
+ *
+ * @param {number} seed an unsigned 32-bit integer
+ * @param {number} t
+ * @param {typeof Math.imul} i
+ * @returns {() => number}
+ */
+export const mulberry32 = (seed) => {
+    return () => {
+        let t = (seed += 0x6d2b79f5)
+        t = Math.imul(t ^ (t >>> 15), t | 1)
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61)
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296
+    }
+}

package/src/version.js

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

package/types/global.d.ts

@@ -186,7 +186,8 @@ declare global {
 
     /** RNG API */
     /**
-     * Generates a pseudorandom float between min (inclusive) and max (exclusive)
+     * Generates a pseudo random float between min (inclusive) and max (exclusive)
+     * using the Mulberry32 algorithm.
      *
      * @param [min=0.0]
      * @param [max=1.0]
@@ -194,7 +195,7 @@ declare global {
      */
     function rand(min?: number, max?: number): number
     /**
-     * Generates a pseudorandom integer between min (inclusive) and max (inclusive)
+     * Generates a pseudo random integer between min (inclusive) and max (inclusive).
      *
      * @param [min=0]
      * @param [max=1]
@@ -204,9 +205,7 @@ declare global {
     /**
      * Initializes the random number generator with an explicit seed value.
      *
-     * Note: The seed should be a integer number greater than or equal to zero.
-     *
-     * @param value
+     * @param value the PRNG seed. Must be an non-negative number.
      */
     function rseed(value: number): void
 

package/types/types.d.ts

@@ -180,7 +180,8 @@ type LitecanvasInstance = {
 
     /** RNG API */
     /**
-     * Generates a pseudorandom float between min (inclusive) and max (exclusive)
+     * Generates a pseudo random float between min (inclusive) and max (exclusive)
+     * using the Mulberry32 algorithm.
      *
      * @param [min=0.0]
      * @param [max=1.0]
@@ -188,7 +189,7 @@ type LitecanvasInstance = {
      */
     rand(min?: number, max?: number): number
     /**
-     * Generates a pseudorandom integer between min (inclusive) and max (inclusive)
+     * Generates a pseudo random integer between min (inclusive) and max (inclusive)
      *
      * @param [min=0]
      * @param [max=1]
@@ -196,11 +197,11 @@ type LitecanvasInstance = {
      */
     randi(min?: number, max?: number): number
     /**
-     * Initializes the random number generator with an explicit seed value.
+     * Generates a pseudo random integer between min (inclusive) and max (inclusive).
      *
-     * Note: The seed should be a integer number greater than or equal to zero.
-     *
-     * @param value
+     * @param [min=0]
+     * @param [max=1]
+     * @returns the random number
      */
     rseed(value: number): void