litecanvas 0.58.2 → 0.59.0

package/dist/dist.js

@@ -59,7 +59,7 @@
       keyboardEvents: true
     };
     settings = Object.assign(defaults, settings);
-    let _initialized = false, _plugins = [], _canvas = settings.canvas || document.createElement("canvas"), _fullscreen = settings.fullscreen, _autoscale = settings.autoscale, _scale = 1, _mouseX, _mouseY, _ctx, _timeScale = 1, _lastFrame, _step = 1 / settings.fps, _stepMs = _step * 1e3, _accumulated = 0, _rafid, _drawCount = 0, _drawTime = 0, _fontFamily = "sans-serif", _fontStyle = "", _fontSize = 32, _rng_seed = Date.now(), _events = {
+    let _initialized = false, _plugins = [], _canvas = settings.canvas || document.createElement("canvas"), _fullscreen = settings.fullscreen, _autoscale = settings.autoscale, _scale = 1, _ctx, _timeScale = 1, _lastFrame, _step = 1 / settings.fps, _stepMs = _step * 1e3, _accumulated = 0, _rafid, _drawCount = 0, _drawTime = 0, _fontFamily = "sans-serif", _fontStyle = "", _fontSize = 32, _rng_seed = Date.now(), _events = {
       init: false,
       update: false,
       draw: false,
@@ -84,9 +84,13 @@
       /** @type {number} */
       FPS: settings.fps,
       /** @type {number} */
-      CENTERX: null,
+      CENTERX: 0,
       /** @type {number} */
-      CENTERY: null,
+      CENTERY: 0,
+      /** @type {number} */
+      MOUSEX: -1,
+      /** @type {number} */
+      MOUSEY: -1,
       /** @type {number[]} */
       DEFAULT_SFX: [0.5, , 1675, , 0.06, 0.2, 1, 1.8, , , 637, 0.06],
       /** MATH API */
@@ -209,7 +213,7 @@
        * @param {number} [max=1]
        * @returns {number} the random number
        */
-      randi: (min = 0, max = 1) => instance.floor(instance.rand() * (max - min + 1) + min),
+      randi: (min = 0, max = 1) => instance.floor(instance.rand(min, max + 1)),
       /**
        * If a value is passed, initializes the random number generator with an explicit seed value.
        * Otherwise, returns the current seed state.
@@ -337,7 +341,7 @@
        * @param {number} [color=3] the color index (generally from 0 to 7)
        */
       text(x, y, text, color = 3) {
-        _ctx.font = `${_fontStyle || ""} ${_fontSize}px ${_fontFamily}`;
+        _ctx.font = `${_fontStyle} ${_fontSize}px ${_fontFamily}`;
         _ctx.fillStyle = instance.getcolor(color);
         _ctx.fillText(text, ~~x, ~~y);
       },
@@ -358,12 +362,12 @@
         _fontSize = size;
       },
       /**
-       * Sets whether a font should be styled with a normal, italic, or bold.
+       * Sets whether a font should be styled with a "normal", "italic", or "bold".
        *
        * @param {string} style
        */
       textstyle(style) {
-        _fontStyle = style;
+        _fontStyle = style || "";
       },
       /**
        * Sets the alignment used when drawing texts
@@ -385,8 +389,8 @@
        * @returns {TextMetrics}
        * @see https://developer.mozilla.org/en-US/docs/Web/API/TextMetrics
        */
-      textmetrics(text, size) {
-        _ctx.font = `${_fontStyle || ""} ${size || _fontSize}px ${_fontFamily}`;
+      textmetrics(text, size = _fontSize) {
+        _ctx.font = `${_fontStyle} ${size}px ${_fontFamily}`;
         const metrics = _ctx.measureText(text);
         metrics.height = metrics.actualBoundingBoxAscent + metrics.actualBoundingBoxDescent;
         return metrics;
@@ -413,7 +417,7 @@
        * @see https://developer.mozilla.org/en-US/docs/Web/API/OffscreenCanvas
        */
       paint(width, height, draw, options = {}) {
-        const oc = options.canvas || new OffscreenCanvas(0, 0), scale = options.scale || 1, contextBackup = _ctx;
+        const oc = options.canvas || new OffscreenCanvas(1, 1), scale = options.scale || 1, contextBackup = _ctx;
         oc.width = width * scale;
         oc.height = height * scale;
         _ctx = oc.getContext("2d");
@@ -453,16 +457,18 @@
       },
       /**
        * saves the current drawing style settings and transformations
+       *
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/save
        */
       push: () => _ctx.save(),
       /**
        * restores the drawing style settings and transformations
+       *
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/restore
        */
       pop: () => _ctx.restore(),
       /**
-       * Adds a translation transformation to the current matrix
+       * Adds a translation to the transformation matrix.
        *
        * @param {number} x
        * @param {number} y
@@ -476,14 +482,12 @@
        */
       scale: (x, y) => _ctx.scale(x, y || x),
       /**
-       * Adds a rotation to the transformation matrix
+       * Adds a rotation to the transformation matrix.
        *
        * @param {number} radians
        */
       rotate: (radians) => _ctx.rotate(radians),
       /**
-       * Adds a transformation that skews to the transformation matrix
-       *
        * @param {number} a
        * @param {number} b
        * @param {number} c
@@ -491,7 +495,9 @@
        * @param {number} e
        * @param {number} f
        * @param {boolean} [resetFirst=true] `false` to use _ctx.transform(); by default use _ctx.setTransform()
+       *
        * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setTransform
+       * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/transform
        */
       transform: (a, b, c, d, e, f, resetFirst = true) => _ctx[resetFirst ? "setTransform" : "transform"](a, b, c, d, e, f),
       /**
@@ -521,7 +527,11 @@
        */
       fill(color, path) {
         _ctx.fillStyle = instance.getcolor(color);
-        _ctx.fill(path);
+        if (path) {
+          _ctx.fill(path);
+        } else {
+          _ctx.fill();
+        }
       },
       /**
        * Outlines the current or given path with a given color.
@@ -531,7 +541,11 @@
        */
       stroke(color, path) {
         _ctx.strokeStyle = instance.getcolor(color);
-        path ? _ctx.stroke(path) : _ctx.stroke();
+        if (path) {
+          _ctx.stroke(path);
+        } else {
+          _ctx.stroke();
+        }
       },
       /**
        * Create a retangular clipping region.
@@ -568,16 +582,6 @@
         _ctx.arc(x, y, radius, 0, TWO_PI);
         _ctx.clip();
       },
-      /**
-       * Sets the type of compositing operation to apply when drawing new shapes.
-       * Default value = 'source-over'.
-       *
-       * @param {string} value
-       * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
-       */
-      blendmode(value) {
-        _ctx.globalCompositeOperation = value;
-      },
       /** SOUND API */
       /**
        * Play a sound effects using ZzFX library.
@@ -639,11 +643,6 @@
        * @returns {boolean}
        */
       colcirc: (x1, y1, r1, x2, y2, r2) => (x2 - x1) ** 2 + (y2 - y1) ** 2 <= (r1 + r2) ** 2,
-      /**
-       * Get the mouse position
-       * @returns number[]
-       */
-      mousepos: () => [_mouseX, _mouseY],
       /**
        * The scale of the game's delta time (dt).
        * Values higher than 1 increase the speed of time, while values smaller than 1 decrease it.
@@ -788,7 +787,9 @@
         });
         on(_canvas, "mousemove", (ev) => {
           ev.preventDefault();
-          const [x, y] = [_mouseX, _mouseY] = _getXY(ev.pageX, ev.pageY);
+          const [x, y] = _getXY(ev.pageX, ev.pageY);
+          instance.setvar("MOUSEX", x);
+          instance.setvar("MOUSEY", y);
           if (!_pressingMouse) return;
           instance.emit("tapping", x, y, 0);
           _updateTap(0, x, y);
@@ -843,7 +844,6 @@
         on(_canvas, "touchcancel", _touchEndHandler);
         on(root, "blur", () => {
           _pressingMouse = false;
-          if (_taps.size === 0) return;
           for (const [id, tap] of _taps) {
             instance.emit("untap", tap.x, tap.y, id);
             _taps.delete(id);
@@ -926,7 +926,7 @@
           pageWidth / instance.WIDTH,
           pageHeight / instance.HEIGHT
         );
-        _scale = settings.pixelart ? Math.floor(_scale) : _scale;
+        _scale = (settings.pixelart ? ~~_scale : _scale) || 1;
         _canvas.style.width = instance.WIDTH * _scale + "px";
         _canvas.style.height = instance.HEIGHT * _scale + "px";
       }

package/dist/dist.min.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "litecanvas",
-    "version": "0.58.2",
+    "version": "0.59.0",
     "description": "Lightweight HTML5 canvas engine suitable for small games and animations.",
     "license": "MIT",
     "author": "Luiz Bills <luizbills@pm.me>",

package/src/index.js

@@ -46,10 +46,6 @@ export default function litecanvas(settings = {}) {
         _autoscale = settings.autoscale,
         /** @type {number} */
         _scale = 1,
-        /** @type {number?} */
-        _mouseX,
-        /** @type {number?} */
-        _mouseY,
         /** @type {CanvasRenderingContext2D} */
         _ctx,
         /** @type {number} */
@@ -117,10 +113,16 @@ export default function litecanvas(settings = {}) {
         FPS: settings.fps,
 
         /** @type {number} */
-        CENTERX: null,
+        CENTERX: 0,
 
         /** @type {number} */
-        CENTERY: null,
+        CENTERY: 0,
+
+        /** @type {number} */
+        MOUSEX: -1,
+
+        /** @type {number} */
+        MOUSEY: -1,
 
         /** @type {number[]} */
         DEFAULT_SFX: [0.5, , 1675, , 0.06, 0.2, 1, 1.8, , , 637, 0.06],
@@ -261,7 +263,7 @@ export default function litecanvas(settings = {}) {
          * @returns {number} the random number
          */
         randi: (min = 0, max = 1) =>
-            instance.floor(instance.rand() * (max - min + 1) + min),
+            instance.floor(instance.rand(min, max + 1)),
 
         /**
          * If a value is passed, initializes the random number generator with an explicit seed value.
@@ -399,7 +401,7 @@ export default function litecanvas(settings = {}) {
          * @param {number} [color=3] the color index (generally from 0 to 7)
          */
         text(x, y, text, color = 3) {
-            _ctx.font = `${_fontStyle || ''} ${_fontSize}px ${_fontFamily}`
+            _ctx.font = `${_fontStyle} ${_fontSize}px ${_fontFamily}`
             _ctx.fillStyle = instance.getcolor(color)
             _ctx.fillText(text, ~~x, ~~y)
         },
@@ -423,12 +425,12 @@ export default function litecanvas(settings = {}) {
         },
 
         /**
-         * Sets whether a font should be styled with a normal, italic, or bold.
+         * Sets whether a font should be styled with a "normal", "italic", or "bold".
          *
          * @param {string} style
          */
         textstyle(style) {
-            _fontStyle = style
+            _fontStyle = style || ''
         },
 
         /**
@@ -452,9 +454,9 @@ export default function litecanvas(settings = {}) {
          * @returns {TextMetrics}
          * @see https://developer.mozilla.org/en-US/docs/Web/API/TextMetrics
          */
-        textmetrics(text, size) {
+        textmetrics(text, size = _fontSize) {
             // prettier-ignore
-            _ctx.font = `${_fontStyle || ''} ${(size || _fontSize)}px ${_fontFamily}`
+            _ctx.font = `${_fontStyle} ${size}px ${_fontFamily}`
             const metrics = _ctx.measureText(text)
             metrics.height =
                 metrics.actualBoundingBoxAscent +
@@ -485,7 +487,7 @@ export default function litecanvas(settings = {}) {
          * @see https://developer.mozilla.org/en-US/docs/Web/API/OffscreenCanvas
          */
         paint(width, height, draw, options = {}) {
-            const oc = options.canvas || new OffscreenCanvas(0, 0),
+            const oc = options.canvas || new OffscreenCanvas(1, 1),
                 scale = options.scale || 1,
                 contextBackup = _ctx
 
@@ -539,18 +541,20 @@ export default function litecanvas(settings = {}) {
 
         /**
          * saves the current drawing style settings and transformations
+         *
          * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/save
          */
         push: () => _ctx.save(),
 
         /**
          * restores the drawing style settings and transformations
+         *
          * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/restore
          */
         pop: () => _ctx.restore(),
 
         /**
-         * Adds a translation transformation to the current matrix
+         * Adds a translation to the transformation matrix.
          *
          * @param {number} x
          * @param {number} y
@@ -566,15 +570,13 @@ export default function litecanvas(settings = {}) {
         scale: (x, y) => _ctx.scale(x, y || x),
 
         /**
-         * Adds a rotation to the transformation matrix
+         * Adds a rotation to the transformation matrix.
          *
          * @param {number} radians
          */
         rotate: (radians) => _ctx.rotate(radians),
 
         /**
-         * Adds a transformation that skews to the transformation matrix
-         *
          * @param {number} a
          * @param {number} b
          * @param {number} c
@@ -582,7 +584,9 @@ export default function litecanvas(settings = {}) {
          * @param {number} e
          * @param {number} f
          * @param {boolean} [resetFirst=true] `false` to use _ctx.transform(); by default use _ctx.setTransform()
+         *
          * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setTransform
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/transform
          */
         transform: (a, b, c, d, e, f, resetFirst = true) =>
             _ctx[resetFirst ? 'setTransform' : 'transform'](a, b, c, d, e, f),
@@ -616,7 +620,11 @@ export default function litecanvas(settings = {}) {
          */
         fill(color, path) {
             _ctx.fillStyle = instance.getcolor(color)
-            _ctx.fill(path)
+            if (path) {
+                _ctx.fill(path)
+            } else {
+                _ctx.fill()
+            }
         },
 
         /**
@@ -627,7 +635,11 @@ export default function litecanvas(settings = {}) {
          */
         stroke(color, path) {
             _ctx.strokeStyle = instance.getcolor(color)
-            path ? _ctx.stroke(path) : _ctx.stroke()
+            if (path) {
+                _ctx.stroke(path)
+            } else {
+                _ctx.stroke()
+            }
         },
 
         /**
@@ -667,17 +679,6 @@ export default function litecanvas(settings = {}) {
             _ctx.clip()
         },
 
-        /**
-         * Sets the type of compositing operation to apply when drawing new shapes.
-         * Default value = 'source-over'.
-         *
-         * @param {string} value
-         * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
-         */
-        blendmode(value) {
-            _ctx.globalCompositeOperation = value
-        },
-
         /** SOUND API */
         /**
          * Play a sound effects using ZzFX library.
@@ -754,12 +755,6 @@ export default function litecanvas(settings = {}) {
         colcirc: (x1, y1, r1, x2, y2, r2) =>
             (x2 - x1) ** 2 + (y2 - y1) ** 2 <= (r1 + r2) ** 2,
 
-        /**
-         * Get the mouse position
-         * @returns number[]
-         */
-        mousepos: () => [_mouseX, _mouseY],
-
         /**
          * The scale of the game's delta time (dt).
          * Values higher than 1 increase the speed of time, while values smaller than 1 decrease it.
@@ -931,8 +926,13 @@ export default function litecanvas(settings = {}) {
 
             on(_canvas, 'mousemove', (ev) => {
                 ev.preventDefault()
-                const [x, y] = ([_mouseX, _mouseY] = _getXY(ev.pageX, ev.pageY))
+
+                const [x, y] = _getXY(ev.pageX, ev.pageY)
+                instance.setvar('MOUSEX', x)
+                instance.setvar('MOUSEY', y)
+
                 if (!_pressingMouse) return
+
                 instance.emit('tapping', x, y, 0)
                 _updateTap(0, x, y)
             })
@@ -996,9 +996,6 @@ export default function litecanvas(settings = {}) {
 
             on(root, 'blur', () => {
                 _pressingMouse = false
-
-                if (_taps.size === 0) return
-
                 for (const [id, tap] of _taps) {
                     instance.emit('untap', tap.x, tap.y, id)
                     _taps.delete(id)
@@ -1128,7 +1125,7 @@ export default function litecanvas(settings = {}) {
                 pageWidth / instance.WIDTH,
                 pageHeight / instance.HEIGHT
             )
-            _scale = settings.pixelart ? Math.floor(_scale) : _scale
+            _scale = (settings.pixelart ? ~~_scale : _scale) || 1
             _canvas.style.width = instance.WIDTH * _scale + 'px'
             _canvas.style.height = instance.HEIGHT * _scale + 'px'
         }

package/types/index.d.ts

@@ -24,6 +24,10 @@ declare global {
     var CENTERX: number
     /** the center Y of the game screen */
     var CENTERY: number
+    /** The current mouse's horizontal (X) position or -1 (if the mouse was not used or detected) */
+    var MOUSEX: number | null
+    /** The current mouse's vertical (Y) position or -1 (if the mouse was not used or detected) */
+    var MOUSEY: number | null
     /** the default `sfx()` sound */
     var DEFAULT_SFX: number[]
 
@@ -418,8 +422,6 @@ declare global {
      */
     function rotate(radians: number): void
     /**
-     * Adds a transformation that skews to the transformation matrix
-     *
      * @param {number} a
      * @param {number} b
      * @param {number} c
@@ -427,7 +429,9 @@ declare global {
      * @param {number} e
      * @param {number} f
      * @param {boolean} [resetFirst=true] `false` to use _ctx.transform(); by default use _ctx.setTransform()
+     *
      * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setTransform
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/transform
      */
     function transform(
         a: number,
@@ -496,14 +500,6 @@ declare global {
      * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/clip
      */
     function clipcirc(x: number, y: number, radius: number): void
-    /**
-     * Sets the type of compositing operation to apply when drawing new shapes.
-     * Default value = 'source-over'.
-     *
-     * @param {string} value
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
-     */
-    function blendmode(value: string): void
 
     /** SOUND API */
     /**
@@ -583,12 +579,6 @@ declare global {
         y2: number,
         r2: number
     ): boolean
-    /**
-     * Get the mouse position
-     *
-     * @returns number[]
-     */
-    function mousepos(): number[]
     /**
      * The scale of the game's delta time (dt).
      * Values higher than 1 increase the speed of time, while values smaller than 1 decrease it.

package/types/types.d.ts

@@ -13,6 +13,10 @@ type LitecanvasInstance = {
     CENTERX: number
     /** the center Y of the game screen */
     CENTERY: number
+    /** The current mouse's horizontal (X) position or -1 (if the mouse was not used or detected) */
+    MOUSEX: number
+    /** The current mouse's vertical (Y) position or -1 (if the mouse was not used or detected) */
+    MOUSEY: number
     /** the default `sfx()` sound */
     DEFAULT_SFX: number[]
 
@@ -401,8 +405,6 @@ type LitecanvasInstance = {
      */
     rotate(radians: number): void
     /**
-     * Adds a transformation that skews to the transformation matrix
-     *
      * @param {number} a
      * @param {number} b
      * @param {number} c
@@ -410,7 +412,9 @@ type LitecanvasInstance = {
      * @param {number} e
      * @param {number} f
      * @param {boolean} [resetFirst=true] `false` to use _ctx.transform(); by default use _ctx.setTransform()
+     *
      * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setTransform
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/transform
      */
     transform(
         a: number,
@@ -479,14 +483,6 @@ type LitecanvasInstance = {
      * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/clip
      */
     clipcirc(x: number, y: number, radius: number): void
-    /**
-     * Sets the type of compositing operation to apply when drawing new shapes.
-     * Default value = 'source-over'.
-     *
-     * @param {string} value
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
-     */
-    blendmode(value: string): void
 
     /** SOUND API */
     /**
@@ -567,12 +563,6 @@ type LitecanvasInstance = {
         y2: number,
         r2: number
     ): boolean
-    /**
-     * Get the mouse position
-     *
-     * @returns number[]
-     */
-    mousepos(): number[]
     /**
      * The scale of the game's delta time (dt).
      * Values higher than 1 increase the speed of time, while values smaller than 1 decrease it.