@litecanvas/utils 0.38.0 → 0.40.0

package/dist/actor.js

@@ -30,17 +30,13 @@
   // src/vector/index.js
   var PI2 = 2 * Math.PI;
   var Vector = class {
-    /** @type {number} */
-    x;
-    /** @type {number} */
-    y;
     /**
      * @param {number} [x=0]
      * @param {number} [y]
      */
     constructor(x = 0, y = x) {
-      this.x = x;
-      this.y = y;
+      this.x = parseFloat(x) || 0;
+      this.y = parseFloat(y) || 0;
     }
     /**
      * @returns {string}
@@ -89,7 +85,7 @@
      * @param {Vector} anchor
      */
     constructor(sprite, position, anchor = ANCHOR_TOP_LEFT) {
-      this.sprite = sprite;
+      this.sprite = sprite || { width: 0, height: 0 };
       this.pos = position || vec(0);
       this._o = vec(anchor);
       this._s = vec(1, 1);
@@ -182,35 +178,36 @@
     /**
      * Draw the actor
      *
-     * @param {LitecanvasInstance} [litecanvas]
+     * @param {LitecanvasInstance} [engine]
      */
-    draw(litecanvas = globalThis, saveContext = true) {
-      if (this.hidden || this.opacity <= 0) return;
-      if (saveContext) litecanvas.push();
-      this.transform(litecanvas);
-      this.drawImage(litecanvas);
-      if (saveContext) litecanvas.pop();
+    draw(engine = globalThis, saveContext = true) {
+      if (saveContext) engine.push();
+      this.transform(engine);
+      if (this.sprite.width && this.sprite.height && !this.hidden && this.opacity > 0) {
+        this.drawImage(engine);
+      }
+      if (saveContext) engine.pop();
     }
     /**
-     * @param {LitecanvasInstance} litecanvas
+     * @param {LitecanvasInstance} engine
      */
-    transform(litecanvas) {
-      litecanvas.translate(this.pos.x, this.pos.y);
-      litecanvas.rotate(litecanvas.deg2rad(this.angle));
-      litecanvas.scale(
+    transform(engine) {
+      engine.translate(this.pos.x, this.pos.y);
+      engine.rotate(engine.deg2rad(this.angle));
+      engine.scale(
         (this.flipX ? -1 : 1) * this._s.x,
         (this.flipY ? -1 : 1) * this._s.y
       );
     }
     /**
-     * @param {LitecanvasInstance} litecanvas
+     * @param {LitecanvasInstance} engine
      */
-    drawImage(litecanvas, alpha = true) {
+    drawImage(engine, alpha = true) {
       const anchor = this.anchor;
       const x = -this.sprite.width * (this.flipX ? 1 - anchor.x : anchor.x);
       const y = -this.sprite.height * (this.flipY ? 1 - anchor.y : anchor.y);
-      if (alpha) litecanvas.alpha(this.opacity);
-      litecanvas.image(x, y, this.sprite);
+      if (alpha) engine.alpha(this.opacity);
+      engine.image(x, y, this.sprite);
     }
   };
 

package/dist/actor.min.js

@@ -1 +1 @@
-(()=>{var x=Object.defineProperty;var u=(o,t)=>{for(var s in t)x(o,s,{get:t[s],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(o=!0)=>{for(let t in globalThis.utils)t!=="global"&&(o||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var p={};u(p,{ANCHOR_BOT_LEFT:()=>g,ANCHOR_BOT_RIGHT:()=>_,ANCHOR_CENTER:()=>a,ANCHOR_TOP_LEFT:()=>y,ANCHOR_TOP_RIGHT:()=>f,Actor:()=>h});var T=2*Math.PI,i=class{x;y;constructor(t=0,s=t){this.x=t,this.y=s}toString(){return`Vector (${this.x}, ${this.y})`}},l=o=>o instanceof i,r=(o=0,t=o)=>(l(o)&&(t=o.y,o=o.x),new i(o,t));var a=r(.5,.5),y=r(0,0),f=r(1,0),g=r(0,1),_=r(1,1),h=class{sprite;pos;_o;_s;flipX=!1;flipY=!1;angle=0;opacity=1;hidden=!1;constructor(t,s,e=y){this.sprite=t,this.pos=s||r(0),this._o=r(e),this._s=r(1,1)}set x(t){this.pos.x=t}get x(){return this.pos.x}set y(t){this.pos.y=t}get y(){return this.pos.y}set anchor(t){this._o.x=t.x,this._o.y=t.y}get anchor(){return this._o}get width(){return this.sprite.width*this._s.x}get height(){return this.sprite.height*this._s.y}get scale(){return this._s}scaleTo(t,s=t){this._s.x=t,this._s.y=s}scaleBy(t,s=t){this._s.x*=t,this._s.y*=s}getBounds(t=!0){let s=this.sprite.width*(t?this._s.x:1),e=this.sprite.height*(t?this._s.y:1),n=this.pos.x-s*this.anchor.x,c=this.pos.y-e*this.anchor.y;return[n,c,s,e]}draw(t=globalThis,s=!0){this.hidden||this.opacity<=0||(s&&t.push(),this.transform(t),this.drawImage(t),s&&t.pop())}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(t.deg2rad(this.angle)),t.scale((this.flipX?-1:1)*this._s.x,(this.flipY?-1:1)*this._s.y)}drawImage(t,s=!0){let e=this.anchor,n=-this.sprite.width*(this.flipX?1-e.x:e.x),c=-this.sprite.height*(this.flipY?1-e.y:e.y);s&&t.alpha(this.opacity),t.image(n,c,this.sprite)}};globalThis.utils=Object.assign(globalThis.utils||{},p);})();
+(()=>{var x=Object.defineProperty;var a=(o,t)=>{for(var s in t)x(o,s,{get:t[s],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(o=!0)=>{for(let t in globalThis.utils)t!=="global"&&(o||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var p={};a(p,{ANCHOR_BOT_LEFT:()=>g,ANCHOR_BOT_RIGHT:()=>d,ANCHOR_CENTER:()=>u,ANCHOR_TOP_LEFT:()=>y,ANCHOR_TOP_RIGHT:()=>f,Actor:()=>h});var T=2*Math.PI,i=class{constructor(t=0,s=t){this.x=parseFloat(t)||0,this.y=parseFloat(s)||0}toString(){return`Vector (${this.x}, ${this.y})`}},l=o=>o instanceof i,e=(o=0,t=o)=>(l(o)&&(t=o.y,o=o.x),new i(o,t));var u=e(.5,.5),y=e(0,0),f=e(1,0),g=e(0,1),d=e(1,1),h=class{sprite;pos;_o;_s;flipX=!1;flipY=!1;angle=0;opacity=1;hidden=!1;constructor(t,s,r=y){this.sprite=t||{width:0,height:0},this.pos=s||e(0),this._o=e(r),this._s=e(1,1)}set x(t){this.pos.x=t}get x(){return this.pos.x}set y(t){this.pos.y=t}get y(){return this.pos.y}set anchor(t){this._o.x=t.x,this._o.y=t.y}get anchor(){return this._o}get width(){return this.sprite.width*this._s.x}get height(){return this.sprite.height*this._s.y}get scale(){return this._s}scaleTo(t,s=t){this._s.x=t,this._s.y=s}scaleBy(t,s=t){this._s.x*=t,this._s.y*=s}getBounds(t=!0){let s=this.sprite.width*(t?this._s.x:1),r=this.sprite.height*(t?this._s.y:1),c=this.pos.x-s*this.anchor.x,n=this.pos.y-r*this.anchor.y;return[c,n,s,r]}draw(t=globalThis,s=!0){s&&t.push(),this.transform(t),this.sprite.width&&this.sprite.height&&!this.hidden&&this.opacity>0&&this.drawImage(t),s&&t.pop()}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(t.deg2rad(this.angle)),t.scale((this.flipX?-1:1)*this._s.x,(this.flipY?-1:1)*this._s.y)}drawImage(t,s=!0){let r=this.anchor,c=-this.sprite.width*(this.flipX?1-r.x:r.x),n=-this.sprite.height*(this.flipY?1-r.y:r.y);s&&t.alpha(this.opacity),t.image(c,n,this.sprite)}};globalThis.utils=Object.assign(globalThis.utils||{},p);})();

package/dist/all.js

@@ -102,11 +102,13 @@
     vecNorm: () => vecNorm,
     vecRand: () => vecRand,
     vecReflect: () => vecReflect,
+    vecRem: () => vecRem,
     vecRotate: () => vecRotate,
     vecRound: () => vecRound,
     vecSet: () => vecSet,
     vecSetMag: () => vecSetMag,
-    vecSub: () => vecSub
+    vecSub: () => vecSub,
+    vecToArray: () => vecToArray
   });
 
   // src/camera/index.js
@@ -318,7 +320,7 @@
         resolveY = y2 + h2;
       }
     }
-    return { direction, x: resolveX, y: resolveY };
+    return { dir: direction, x: resolveX, y: resolveY };
   };
 
   // src/debug/assert.js
@@ -488,7 +490,7 @@
      * @param {number} y
      * @param {any} value
      * @param {Grid} grid
-     * @returns {boolean?} returns `false` to stop/break the loop
+     * @returns {false|void} returns `false` to stop/break the loop
      *
      * @param {GridForEachCallback} callback
      * @param {boolean} [reverse=false]
@@ -585,17 +587,13 @@
   var sin = Math.sin;
   var PI2 = 2 * Math.PI;
   var Vector = class {
-    /** @type {number} */
-    x;
-    /** @type {number} */
-    y;
     /**
      * @param {number} [x=0]
      * @param {number} [y]
      */
     constructor(x = 0, y = x) {
-      this.x = x;
-      this.y = y;
+      this.x = parseFloat(x) || 0;
+      this.y = parseFloat(y) || 0;
     }
     /**
      * @returns {string}
@@ -612,12 +610,6 @@
     }
     return new Vector(x, y);
   };
-  var vecEq = (v, x, y = x) => {
-    if (isVector(x)) {
-      return vecEq(v, x.x, x.y);
-    }
-    return v.x === x && v.y === y;
-  };
   var vecSet = (v, x, y = x) => {
     if (isVector(x)) {
       vecSet(v, x.x, x.y);
@@ -708,11 +700,6 @@
     a.y += (b.y - a.y) * t || 0;
     return a;
   };
-  var vecRand = (minlength = 1, maxlength = minlength, rng = globalThis.rand || Math.random) => {
-    const angle = rng() * PI2;
-    const radius = rng() * (maxlength - minlength) + minlength;
-    return vec(cos(angle) * radius, sin(angle) * radius);
-  };
   var vecAbs = (v) => {
     v.x = Math.abs(v.x);
     v.y = Math.abs(v.y);
@@ -740,8 +727,25 @@
     if (v.y > max.y) v.y = max.y;
     return v;
   };
+  var vecRem = (v, value) => {
+    v.x %= value;
+    v.y %= value;
+    return v;
+  };
   var vecMove = (from, to, delta = 1) => vecAdd(from, to.x * delta, to.y * delta);
+  var vecEq = (v, x, y = x) => {
+    if (isVector(x)) {
+      return vecEq(v, x.x, x.y);
+    }
+    return v.x === x && v.y === y;
+  };
   var vecIsZero = (v) => vecEq(v, ZERO);
+  var vecToArray = (v) => [v.x, v.y];
+  var vecRand = (minlength = 1, maxlength = minlength, rng = globalThis.rand || Math.random) => {
+    const angle = rng() * PI2;
+    const radius = rng() * (maxlength - minlength) + minlength;
+    return vec(cos(angle) * radius, sin(angle) * radius);
+  };
   var ZERO = /* @__PURE__ */ vec(0, 0);
   var ONE = /* @__PURE__ */ vec(1, 1);
   var UP = /* @__PURE__ */ vec(0, -1);
@@ -780,7 +784,7 @@
      * @param {Vector} anchor
      */
     constructor(sprite, position, anchor = ANCHOR_TOP_LEFT) {
-      this.sprite = sprite;
+      this.sprite = sprite || { width: 0, height: 0 };
       this.pos = position || vec(0);
       this._o = vec(anchor);
       this._s = vec(1, 1);
@@ -873,35 +877,36 @@
     /**
      * Draw the actor
      *
-     * @param {LitecanvasInstance} [litecanvas]
+     * @param {LitecanvasInstance} [engine]
      */
-    draw(litecanvas = globalThis, saveContext = true) {
-      if (this.hidden || this.opacity <= 0) return;
-      if (saveContext) litecanvas.push();
-      this.transform(litecanvas);
-      this.drawImage(litecanvas);
-      if (saveContext) litecanvas.pop();
+    draw(engine = globalThis, saveContext = true) {
+      if (saveContext) engine.push();
+      this.transform(engine);
+      if (this.sprite.width && this.sprite.height && !this.hidden && this.opacity > 0) {
+        this.drawImage(engine);
+      }
+      if (saveContext) engine.pop();
     }
     /**
-     * @param {LitecanvasInstance} litecanvas
+     * @param {LitecanvasInstance} engine
      */
-    transform(litecanvas) {
-      litecanvas.translate(this.pos.x, this.pos.y);
-      litecanvas.rotate(litecanvas.deg2rad(this.angle));
-      litecanvas.scale(
+    transform(engine) {
+      engine.translate(this.pos.x, this.pos.y);
+      engine.rotate(engine.deg2rad(this.angle));
+      engine.scale(
         (this.flipX ? -1 : 1) * this._s.x,
         (this.flipY ? -1 : 1) * this._s.y
       );
     }
     /**
-     * @param {LitecanvasInstance} litecanvas
+     * @param {LitecanvasInstance} engine
      */
-    drawImage(litecanvas, alpha = true) {
+    drawImage(engine, alpha = true) {
       const anchor = this.anchor;
       const x = -this.sprite.width * (this.flipX ? 1 - anchor.x : anchor.x);
       const y = -this.sprite.height * (this.flipY ? 1 - anchor.y : anchor.y);
-      if (alpha) litecanvas.alpha(this.opacity);
-      litecanvas.image(x, y, this.sprite);
+      if (alpha) engine.alpha(this.opacity);
+      engine.image(x, y, this.sprite);
     }
   };
 
@@ -936,6 +941,7 @@
 
   // src/math/sum.js
   var sum_default = (values) => {
+    DEV: assert_default(Array.isArray(values), "1st param must be an array");
     let result = 0;
     for (let i = 0; i < values.length; i++) {
       result += values[i];
@@ -945,11 +951,13 @@
 
   // src/math/mean.js
   var mean_default = (values) => {
+    DEV: assert_default(Array.isArray(values), "1st param must be an array");
     return sum_default(values) / values.length;
   };
 
   // src/math/median.js
-  var median_default = (...values) => {
+  var median_default = (values) => {
+    DEV: assert_default(Array.isArray(values), "1st param must be an array");
     const sorted = values.sort((a, b) => a - b);
     const middle = Math.floor(sorted.length / 2);
     if (sorted.length % 2 === 0) {

package/dist/all.min.js

@@ -1,3 +1,3 @@
-(()=>{var bt=Object.defineProperty;var Pt=(e,t)=>{for(var s in t)bt(e,s,{get:t[s],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(e=!0)=>{for(let t in globalThis.utils)t!=="global"&&(e||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var Z={};Pt(Z,{ANCHOR_BOT_LEFT:()=>Jt,ANCHOR_BOT_RIGHT:()=>Qt,ANCHOR_CENTER:()=>$t,ANCHOR_TOP_LEFT:()=>v,ANCHOR_TOP_RIGHT:()=>Gt,Actor:()=>O,BACK_IN:()=>re,BACK_IN_OUT:()=>oe,BACK_OUT:()=>ie,BOUNCE_IN:()=>pt,BOUNCE_IN_OUT:()=>le,BOUNCE_OUT:()=>B,Camera:()=>y,DOWN:()=>zt,EASE_IN:()=>te,EASE_IN_OUT:()=>se,EASE_OUT:()=>ee,ELASTIC_IN:()=>he,ELASTIC_IN_OUT:()=>ae,ELASTIC_OUT:()=>ne,Grid:()=>w,LEFT:()=>Kt,LINEAR:()=>ct,Noise:()=>Y,ONE:()=>Vt,RIGHT:()=>jt,TypedGrid:()=>T,UP:()=>qt,Vector:()=>I,ZERO:()=>Q,advance:()=>st,choose:()=>yt,colcirc:()=>X,colrect:()=>W,diff:()=>tt,dist:()=>it,flipImage:()=>ut,formatTime:()=>wt,fract:()=>et,head:()=>It,intersection:()=>E,last:()=>Mt,lerpAngle:()=>at,mag:()=>ot,makeCircle:()=>xt,makeRectangle:()=>dt,mean:()=>ht,median:()=>nt,mod:()=>rt,percent:()=>lt,range:()=>mt,resolverect:()=>H,scaleImage:()=>ft,shuffle:()=>gt,sum:()=>P,tail:()=>Et,tintImage:()=>_t,tween:()=>vt,vec:()=>h,vecAbs:()=>Yt,vecAdd:()=>A,vecAngle:()=>St,vecAngleBetween:()=>Ot,vecCeil:()=>Zt,vecClamp:()=>Wt,vecCross:()=>Ct,vecDist:()=>Lt,vecDist2:()=>kt,vecDiv:()=>k,vecDot:()=>J,vecEq:()=>N,vecFloor:()=>Ut,vecHeading:()=>G,vecIsZero:()=>Dt,vecLerp:()=>Bt,vecLimit:()=>At,vecMag:()=>K,vecMag2:()=>$,vecMove:()=>Xt,vecMult:()=>b,vecNorm:()=>S,vecRand:()=>Ft,vecReflect:()=>Nt,vecRotate:()=>Tt,vecRound:()=>Ht,vecSet:()=>j,vecSetMag:()=>z,vecSub:()=>L});var y=class{_engine=null;x=0;y=0;ox=0;oy=0;width=0;height=0;rotation=0;scale=1;constructor(t=null,s=0,r=0,i=null,o=null){this._engine=t||globalThis,this.ox=s,this.oy=r,this.resize(i||this._engine.W-s,o||this._engine.H-r),this.x=this.width/2,this.y=this.height/2,this._shake={x:0,y:0,removeListener:null}}resize(t,s){this.width=t,this.height=s,this._engine.emit("camera-resized",this)}start(t=!1){this._engine.push(),t&&this._engine.clip(i=>{i.rect(this.ox,this.oy,this.width,this.height)});let s=this.ox+this.width/2,r=this.oy+this.height/2;this._engine.translate(s,r),this._engine.scale(this.scale),this._engine.rotate(this.rotation),this._engine.translate(-this.x+this._shake.x,-this.y+this._shake.y)}end(){this._engine.pop()}lookAt(t,s){this.x=t,this.y=s}move(t,s){this.x+=t,this.y+=s}zoom(t){this.scale*=t}zoomTo(t){this.scale=t}rotate(t){this.rotation+=t}rotateTo(t){this.rotation=t}getWorldPoint(t,s,r={}){let i=Math.cos(-this.rotation),o=Math.sin(-this.rotation);return t=(t-this.width/2-this.ox)/this.scale,s=(s-this.height/2-this.oy)/this.scale,r.x=i*t-o*s+this.x,r.y=o*t+i*s+this.y,r}getCameraPoint(t,s,r={}){let i=Math.cos(-this.rotation),o=Math.sin(-this.rotation);return t=t-this.x,s=s-this.y,t=i*t-o*s,s=o*t+i*s,r.x=t*this.scale+this.width/2+this.ox,r.y=s*this.scale+this.height/2+this.oy,r}getBounds(){return[this.ox,this.oy,this.width,this.height]}shake(t=1,s=.3){this.shaking||(this._shake.removeListener=this._engine.listen("update",r=>{this._shake.x=this._engine.randi(-t,t),this._shake.y=this._engine.randi(-t,t),s-=r,s<=0&&this.unshake()}))}unshake(){this.shaking&&(this._shake.removeListener(),this._shake.removeListener=null,this._shake.x=this._shake.y=0)}get shaking(){return this._shake.removeListener!==null}};var E=(e,t,s,r,i,o,n,a)=>{let l=Math.max(e,i),x=Math.min(e+s,i+n)-l,p=Math.max(t,o),d=Math.min(t+r,o+a)-p;return[l,p,x,d]};var H=(e,t,s,r,i,o,n,a)=>{let[l,x,p,d]=E(e,t,s,r,i,o,n,a),_="",g=e,c=t;return p<d?e<i?(_="right",g=i-s):(_="left",g=i+n):t<o?(_="bottom",c=o-r):(_="top",c=o+a),{direction:_,x:g,y:c}};var W=(e,t,s,r,i,o,n,a)=>e<i+n&&e+s>i&&t<o+a&&t+r>o;var X=(e,t,s,r,i,o)=>(r-e)*(r-e)+(i-t)*(i-t)<=(s+o)*(s+o);var w=class e{_w;_h;_c;constructor(t,s,r=[]){this._w=Math.max(1,~~t),this._h=Math.max(1,~~s),this._c=r}[Symbol.iterator](){let t=0;return{next:()=>({value:[this.indexToPointX(t),this.indexToPointY(t),this._c[t++]],done:t>this._c.length})}}clone(){return new e(this._w,this._h,this._c)}clear(){this.forEach((t,s)=>this.set(t,s,void 0))}get width(){return this._w}get height(){return this._h}set(t,s,r){this._c[this.pointToIndex(t,s)]=r}get(t,s){return this._c[this.pointToIndex(t,s)]}has(t,s){return this.get(t,s)!=null}check(t,s){return t>=0&&t<this._w&&s>=0&&s<this._h}get length(){return this._w*this._h}pointToIndex(t,s){return this.clampX(~~t)+this.clampY(~~s)*this._w}indexToPointX(t){return t%this._w}indexToPointY(t){return Math.floor(t/this._w)}forEach(t,s=!1){let r=s?this.length-1:0,i=s?-1:this.length,o=s?-1:1;for(;r!==i;){let n=this.indexToPointX(r),a=this.indexToPointY(r),l=this._c[r];if(t(n,a,l,this)===!1)break;r+=o}}fill(t){this.forEach((s,r)=>{this.set(s,r,t)})}clampX(t){return D(t,0,this._w-1)}clampY(t){return D(t,0,this._h-1)}toArray(){return this._c.slice()}toString(t=" ",s=!0){if(!s)return this._c.join(t);let r=[];return this.forEach((i,o,n)=>{r[o]=r[o]||"",r[o]+=n+t}),r.join(`
-`)}},T=class e extends w{constructor(t,s,r=Uint8Array){super(t,s,null),this._c=new r(this._w*this._h)}has(t,s){return this.get(t,s)!==0}clone(){let t=new e(this._w,this._h,this._c.constructor);return this.forEach((s,r,i)=>{t.set(s,r,i)}),t}};function D(e,t,s){return e<t?t:e>s?s:e}var V=Math.cos,q=Math.sin,Rt=2*Math.PI,I=class{x;y;constructor(t=0,s=t){this.x=t,this.y=s}toString(){return`Vector (${this.x}, ${this.y})`}},m=e=>e instanceof I,h=(e=0,t=e)=>(m(e)&&(t=e.y,e=e.x),new I(e,t)),N=(e,t,s=t)=>m(t)?N(e,t.x,t.y):e.x===t&&e.y===s,j=(e,t,s=t)=>(m(t)?j(e,t.x,t.y):(e.x=t,e.y=s),e),A=(e,t,s=t)=>m(t)?A(e,t.x,t.y):(e.x+=t,e.y+=s,e),L=(e,t,s=t)=>m(t)?L(e,t.x,t.y):(e.x-=t,e.y-=s,e),b=(e,t,s=t)=>m(t)?b(e,t.x,t.y):(e.x*=t,e.y*=s,e),k=(e,t,s=t)=>m(t)?k(e,t.x,t.y):(e.x/=t||1,e.y/=s||1,e),Tt=(e,t)=>{let s=V(t),r=q(t);return e.x=s*e.x-r*e.y,e.y=r*e.x+s*e.y,e},Nt=(e,t)=>{let s=S(h(t));return L(e,b(s,2*J(e,s)))},z=(e,t)=>(S(e),b(e,t),e),K=e=>Math.hypot(e.x,e.y),$=e=>e.x*e.x+e.y*e.y,S=e=>{let t=K(e);return t>0&&k(e,t),e},At=(e,t=1)=>($(e)>t*t&&z(e,t),e),Lt=(e,t)=>Math.hypot(t.x-e.x,t.y-e.y),kt=(e,t)=>{let s=e.x-t.x,r=e.y-t.y;return s*s+r*r},G=e=>Math.atan2(e.y,e.x),St=e=>G(e),Ot=(e,t)=>Math.atan2(t.y-e.y,t.x-e.x),J=(e,t)=>e.x*t.x+e.y*t.y,Ct=(e,t)=>e.x*t.y-e.y*t.x,Bt=(e,t,s)=>(e.x+=(t.x-e.x)*s||0,e.y+=(t.y-e.y)*s||0,e),Ft=(e=1,t=e,s=globalThis.rand||Math.random)=>{let r=s()*Rt,i=s()*(t-e)+e;return h(V(r)*i,q(r)*i)},Yt=e=>(e.x=Math.abs(e.x),e.y=Math.abs(e.y),e),Zt=e=>(e.x=Math.ceil(e.x),e.y=Math.ceil(e.y),e),Ut=e=>(e.x=Math.floor(e.x),e.y=Math.floor(e.y),e),Ht=e=>(e.x=Math.round(e.x),e.y=Math.round(e.y),e),Wt=(e,t,s)=>(e.x<t.x&&(e.x=t.x),e.x>s.x&&(e.x=s.x),e.y<t.y&&(e.y=t.y),e.y>s.y&&(e.y=s.y),e),Xt=(e,t,s=1)=>A(e,t.x*s,t.y*s),Dt=e=>N(e,Q),Q=h(0,0),Vt=h(1,1),qt=h(0,-1),jt=h(1,0),zt=h(0,1),Kt=h(-1,0);var $t=h(.5,.5),v=h(0,0),Gt=h(1,0),Jt=h(0,1),Qt=h(1,1),O=class{sprite;pos;_o;_s;flipX=!1;flipY=!1;angle=0;opacity=1;hidden=!1;constructor(t,s,r=v){this.sprite=t,this.pos=s||h(0),this._o=h(r),this._s=h(1,1)}set x(t){this.pos.x=t}get x(){return this.pos.x}set y(t){this.pos.y=t}get y(){return this.pos.y}set anchor(t){this._o.x=t.x,this._o.y=t.y}get anchor(){return this._o}get width(){return this.sprite.width*this._s.x}get height(){return this.sprite.height*this._s.y}get scale(){return this._s}scaleTo(t,s=t){this._s.x=t,this._s.y=s}scaleBy(t,s=t){this._s.x*=t,this._s.y*=s}getBounds(t=!0){let s=this.sprite.width*(t?this._s.x:1),r=this.sprite.height*(t?this._s.y:1),i=this.pos.x-s*this.anchor.x,o=this.pos.y-r*this.anchor.y;return[i,o,s,r]}draw(t=globalThis,s=!0){this.hidden||this.opacity<=0||(s&&t.push(),this.transform(t),this.drawImage(t),s&&t.pop())}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(t.deg2rad(this.angle)),t.scale((this.flipX?-1:1)*this._s.x,(this.flipY?-1:1)*this._s.y)}drawImage(t,s=!0){let r=this.anchor,i=-this.sprite.width*(this.flipX?1-r.x:r.x),o=-this.sprite.height*(this.flipY?1-r.y:r.y);s&&t.alpha(this.opacity),t.image(i,o,this.sprite)}};var tt=(e,t)=>Math.abs(t-e)||0;var et=e=>e%1||0;var st=(e,t,s,r=1)=>{s&&(t.x+=s.x*r,t.y+=s.y*r),e.x+=t.x*r,e.y+=t.y*r};var rt=(e,t)=>(t+e%t)%t;var it=(e,t,s,r)=>Math.hypot(s-e,r-t);var ot=(e,t)=>Math.hypot(e,t);var P=e=>{let t=0;for(let s=0;s<e.length;s++)t+=e[s];return t};var ht=e=>P(e)/e.length;var nt=(...e)=>{let t=e.sort((r,i)=>r-i),s=Math.floor(t.length/2);return t.length%2===0?(t[s-1]+t[s])/2:t[s]};var at=(e,t,s)=>{let r=(t-e)%360;return r>180?r-=360:r<-180&&(r+=360),e+r*s};var lt=(e,t=0,s=1)=>s-t?(e-t)/(s-t):0;var R=Math.PI/2,vt=(e,t,s,r=1,i=ct)=>new C(e,t,s,r,i),ct=e=>e,te=e=>e*e,ee=e=>-e*(e-2),se=e=>e<.5?2*e*e:-2*e*e+4*e-1,re=e=>e*e*e-e*Math.sin(e*Math.PI),ie=e=>{let t=1-e;return 1-(t*t*t-t*Math.sin(t*Math.PI))},oe=e=>{if(e<.5){let s=2*e;return .5*(s*s*s-s*Math.sin(s*Math.PI))}let t=1-(2*e-1);return .5*(1-(t*t*t-t*Math.sin(e*Math.PI)))+.5},he=e=>Math.sin(13*R*e)*Math.pow(2,10*(e-1)),ne=e=>Math.sin(-13*R*(e+1))*Math.pow(2,-10*e)+1,ae=e=>{if(e<.5){let r=Math.sin(13*R*(2*e)),i=Math.pow(2,10*(2*e-1));return .5*r*i}let t=Math.sin(-13*R*(2*e-1+1)),s=Math.pow(2,-10*(2*e-1));return .5*(t*s+2)},pt=e=>1-B(1-e),B=e=>e<4/11?121*e*e/16:e<8/11?363/40*e*e-99/10*e+17/5:e<9/10?4356/361*e*e-35442/1805*e+16061/1805:54/5*e*e-513/25*e+268/25,le=e=>e<.5?.5*pt(e*2):.5*B(e*2-1)+.5,C=class{running=!1;_o;_p;_x;_d;_w;_e;_rel;_cb=[];_t=0;_u=0;_ch=this;_cu=this;_lc;constructor(t,s,r,i,o){this._o=t,this._p=s,this._x=r,this._d=i,this._e=o,this._w=0}start(t){if(this.running)return this;this._cu.stop(!1),this._ch=this._cu=this,this.running=!0;let s=this._o[this._p]||0,r=this._rel?s+this._x:this._x;return this._lc=this._lc||t||globalThis,this._u=this._lc.listen("update",i=>{if(this._t<=this._w){this._t+=i;return}let o=this._t-this._w;this._o[this._p]=this._lc.lerp(s,r,this._e(o/this._d)),this._t+=i,o>=this._d&&(this._o[this._p]=r,this.stop())}),this}stop(t=!0){if(!this._u)return this;if(this.running=!1,this._u(),this._t=0,t)for(let s of this._cb)s(this._o);return this}restart(t=null,s=!1){return this.stop(s).restart(t)}onEnd(t){return this._cb.push(t),this}chain(t){return this._ch.onEnd(()=>{this._cu=t.start(this._lc)}),this._ch=t,this}reset(){return this._cb.length=0,this.stop()}relative(t=!0){return this._rel=t,this}delay(t){return this._w=t,this}get current(){return this._cu}get progress(){return this.running&&this._t>this._w?(this._t-this._w)/this._d:0}};var F=e=>.5*(1-Math.cos(e*Math.PI)),Y=class{_p=[];_po=4;_pf=.5;_e=null;constructor(t){this._e=t||globalThis,this.noiseSeed()}noise(t,s=0,r=0){t<0&&(t=-t),s<0&&(s=-s),r<0&&(r=-r);let i=Math.floor(t),o=Math.floor(s),n=Math.floor(r),a=t-i,l=s-o,x=r-n,p,d,_=0,g=.5,c,u,M;for(let U=0;U<this._po;U++){let f=i+(o<<4)+(n<<8);p=F(a),d=F(l),c=this._p[f&4095],c+=p*(this._p[f+1&4095]-c),u=this._p[f+16&4095],u+=p*(this._p[f+16+1&4095]-u),c+=d*(u-c),f+=256,u=this._p[f&4095],u+=p*(this._p[f+1&4095]-u),M=this._p[f+16&4095],M+=p*(this._p[f+16+1&4095]-M),u+=d*(M-u),c+=F(x)*(u-c),_+=c*g,g*=this._pf,i<<=1,a*=2,o<<=1,l*=2,n<<=1,x*=2,a>=1&&(i++,a--),l>=1&&(o++,l--),x>=1&&(n++,x--)}return _}noiseDetail(t,s){t>0&&(this._po=t),s>0&&(this._pf=s)}noiseSeed(t=null){t!=null&&this._e.rseed(t);let s=this._e.rand||Math.random;for(let r=0;r<4096;r++)this._p[r]=s()}};var ut=(e,t=!0,s=!1,r=globalThis)=>r.paint(e.width,e.height,i=>{r.push(),r.scale(t?-1:1,s?-1:1),r.image(t?-e.width:0,s?-e.height:0,e),r.pop()});var ft=(e,t,s=!0,r=globalThis)=>r.paint(e.width*t,e.height*t,i=>{r.push(),i.imageSmoothingEnabled=!s,r.scale(t),r.image(0,0,e),r.pop()});var _t=(e,t,s=1,r=globalThis)=>r.paint(e.width,e.height,i=>{r.push(),r.alpha(s),r.rectfill(0,0,e.width,e.height,t),i.globalCompositeOperation="destination-atop",r.alpha(1),r.image(0,0,e),r.pop()});var xt=(e,t,{borderWidth:s=0,borderColor:r=0,engine:i=globalThis}={})=>{let o=e*2+s;return i.paint(o,o,()=>{i.circfill(o/2,o/2,e,t),s>0&&(i.linewidth(s),i.stroke(r))})};var dt=(e,t,s,{borderWidth:r=0,borderColor:i=0,engine:o=globalThis}={})=>{let n=e+r*2,a=t+r*2;return o.paint(n,a,()=>{let l=r>0;l&&o.cls(i),o.rectfill(l?r:0,l?r:0,e,t,s)})};var mt=(e,t=0,s=1)=>[...new Array(e).keys()].map(r=>t+s*r);var gt=(e,t=globalThis.rand||Math.random)=>{e=[...e];for(let s=e.length-1;s>0;s--){let r=Math.floor(t()*(s+1)),i=e[s];e[s]=e[r],e[r]=i}return e};var yt=(e,t=globalThis.rand||Math.random)=>e[Math.floor(t()*e.length)];var It=e=>e[0];var Mt=e=>e[e.length-1];var Et=e=>e.slice(1);var wt=e=>~~(e/60)+":"+(e%60<10?"0":"")+~~(e%60);globalThis.utils=Object.assign(globalThis.utils||{},Z);})();
+(()=>{var bt=Object.defineProperty;var Pt=(s,t)=>{for(var e in t)bt(s,e,{get:t[e],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(s=!0)=>{for(let t in globalThis.utils)t!=="global"&&(s||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var Z={};Pt(Z,{ANCHOR_BOT_LEFT:()=>vt,ANCHOR_BOT_RIGHT:()=>ts,ANCHOR_CENTER:()=>Jt,ANCHOR_TOP_LEFT:()=>v,ANCHOR_TOP_RIGHT:()=>Qt,Actor:()=>O,BACK_IN:()=>os,BACK_IN_OUT:()=>as,BACK_OUT:()=>hs,BOUNCE_IN:()=>pt,BOUNCE_IN_OUT:()=>ps,BOUNCE_OUT:()=>C,Camera:()=>g,DOWN:()=>$t,EASE_IN:()=>es,EASE_IN_OUT:()=>is,EASE_OUT:()=>rs,ELASTIC_IN:()=>ns,ELASTIC_IN_OUT:()=>cs,ELASTIC_OUT:()=>ls,Grid:()=>w,LEFT:()=>Gt,LINEAR:()=>ct,Noise:()=>Y,ONE:()=>qt,RIGHT:()=>Kt,TypedGrid:()=>T,UP:()=>zt,Vector:()=>I,ZERO:()=>Q,advance:()=>et,choose:()=>gt,colcirc:()=>X,colrect:()=>W,diff:()=>tt,dist:()=>it,flipImage:()=>ut,formatTime:()=>wt,fract:()=>st,head:()=>It,intersection:()=>M,last:()=>Et,lerpAngle:()=>nt,mag:()=>ot,makeCircle:()=>xt,makeRectangle:()=>mt,mean:()=>ht,median:()=>at,mod:()=>rt,percent:()=>lt,range:()=>dt,resolverect:()=>H,scaleImage:()=>ft,shuffle:()=>yt,sum:()=>P,tail:()=>Mt,tintImage:()=>_t,tween:()=>ss,vec:()=>h,vecAbs:()=>Bt,vecAdd:()=>A,vecAngle:()=>St,vecAngleBetween:()=>Ot,vecCeil:()=>Yt,vecClamp:()=>Ht,vecCross:()=>Ft,vecDist:()=>Lt,vecDist2:()=>kt,vecDiv:()=>L,vecDot:()=>J,vecEq:()=>S,vecFloor:()=>Zt,vecHeading:()=>G,vecIsZero:()=>Dt,vecLerp:()=>Ct,vecLimit:()=>Nt,vecMag:()=>K,vecMag2:()=>$,vecMove:()=>Xt,vecMult:()=>b,vecNorm:()=>k,vecRand:()=>jt,vecReflect:()=>At,vecRem:()=>Wt,vecRotate:()=>Tt,vecRound:()=>Ut,vecSet:()=>q,vecSetMag:()=>z,vecSub:()=>N,vecToArray:()=>Vt});var g=class{_engine=null;x=0;y=0;ox=0;oy=0;width=0;height=0;rotation=0;scale=1;constructor(t=null,e=0,r=0,i=null,o=null){this._engine=t||globalThis,this.ox=e,this.oy=r,this.resize(i||this._engine.W-e,o||this._engine.H-r),this.x=this.width/2,this.y=this.height/2,this._shake={x:0,y:0,removeListener:null}}resize(t,e){this.width=t,this.height=e,this._engine.emit("camera-resized",this)}start(t=!1){this._engine.push(),t&&this._engine.clip(i=>{i.rect(this.ox,this.oy,this.width,this.height)});let e=this.ox+this.width/2,r=this.oy+this.height/2;this._engine.translate(e,r),this._engine.scale(this.scale),this._engine.rotate(this.rotation),this._engine.translate(-this.x+this._shake.x,-this.y+this._shake.y)}end(){this._engine.pop()}lookAt(t,e){this.x=t,this.y=e}move(t,e){this.x+=t,this.y+=e}zoom(t){this.scale*=t}zoomTo(t){this.scale=t}rotate(t){this.rotation+=t}rotateTo(t){this.rotation=t}getWorldPoint(t,e,r={}){let i=Math.cos(-this.rotation),o=Math.sin(-this.rotation);return t=(t-this.width/2-this.ox)/this.scale,e=(e-this.height/2-this.oy)/this.scale,r.x=i*t-o*e+this.x,r.y=o*t+i*e+this.y,r}getCameraPoint(t,e,r={}){let i=Math.cos(-this.rotation),o=Math.sin(-this.rotation);return t=t-this.x,e=e-this.y,t=i*t-o*e,e=o*t+i*e,r.x=t*this.scale+this.width/2+this.ox,r.y=e*this.scale+this.height/2+this.oy,r}getBounds(){return[this.ox,this.oy,this.width,this.height]}shake(t=1,e=.3){this.shaking||(this._shake.removeListener=this._engine.listen("update",r=>{this._shake.x=this._engine.randi(-t,t),this._shake.y=this._engine.randi(-t,t),e-=r,e<=0&&this.unshake()}))}unshake(){this.shaking&&(this._shake.removeListener(),this._shake.removeListener=null,this._shake.x=this._shake.y=0)}get shaking(){return this._shake.removeListener!==null}};var M=(s,t,e,r,i,o,a,n)=>{let l=Math.max(s,i),x=Math.min(s+e,i+a)-l,p=Math.max(t,o),m=Math.min(t+r,o+n)-p;return[l,p,x,m]};var H=(s,t,e,r,i,o,a,n)=>{let[l,x,p,m]=M(s,t,e,r,i,o,a,n),_="",y=s,c=t;return p<m?s<i?(_="right",y=i-e):(_="left",y=i+a):t<o?(_="bottom",c=o-r):(_="top",c=o+n),{dir:_,x:y,y:c}};var W=(s,t,e,r,i,o,a,n)=>s<i+a&&s+e>i&&t<o+n&&t+r>o;var X=(s,t,e,r,i,o)=>(r-s)*(r-s)+(i-t)*(i-t)<=(e+o)*(e+o);var w=class s{_w;_h;_c;constructor(t,e,r=[]){this._w=Math.max(1,~~t),this._h=Math.max(1,~~e),this._c=r}[Symbol.iterator](){let t=0;return{next:()=>({value:[this.indexToPointX(t),this.indexToPointY(t),this._c[t++]],done:t>this._c.length})}}clone(){return new s(this._w,this._h,this._c)}clear(){this.forEach((t,e)=>this.set(t,e,void 0))}get width(){return this._w}get height(){return this._h}set(t,e,r){this._c[this.pointToIndex(t,e)]=r}get(t,e){return this._c[this.pointToIndex(t,e)]}has(t,e){return this.get(t,e)!=null}check(t,e){return t>=0&&t<this._w&&e>=0&&e<this._h}get length(){return this._w*this._h}pointToIndex(t,e){return this.clampX(~~t)+this.clampY(~~e)*this._w}indexToPointX(t){return t%this._w}indexToPointY(t){return Math.floor(t/this._w)}forEach(t,e=!1){let r=e?this.length-1:0,i=e?-1:this.length,o=e?-1:1;for(;r!==i;){let a=this.indexToPointX(r),n=this.indexToPointY(r),l=this._c[r];if(t(a,n,l,this)===!1)break;r+=o}}fill(t){this.forEach((e,r)=>{this.set(e,r,t)})}clampX(t){return D(t,0,this._w-1)}clampY(t){return D(t,0,this._h-1)}toArray(){return this._c.slice()}toString(t=" ",e=!0){if(!e)return this._c.join(t);let r=[];return this.forEach((i,o,a)=>{r[o]=r[o]||"",r[o]+=a+t}),r.join(`
+`)}},T=class s extends w{constructor(t,e,r=Uint8Array){super(t,e,null),this._c=new r(this._w*this._h)}has(t,e){return this.get(t,e)!==0}clone(){let t=new s(this._w,this._h,this._c.constructor);return this.forEach((e,r,i)=>{t.set(e,r,i)}),t}};function D(s,t,e){return s<t?t:s>e?e:s}var V=Math.cos,j=Math.sin,Rt=2*Math.PI,I=class{constructor(t=0,e=t){this.x=parseFloat(t)||0,this.y=parseFloat(e)||0}toString(){return`Vector (${this.x}, ${this.y})`}},d=s=>s instanceof I,h=(s=0,t=s)=>(d(s)&&(t=s.y,s=s.x),new I(s,t)),q=(s,t,e=t)=>(d(t)?q(s,t.x,t.y):(s.x=t,s.y=e),s),A=(s,t,e=t)=>d(t)?A(s,t.x,t.y):(s.x+=t,s.y+=e,s),N=(s,t,e=t)=>d(t)?N(s,t.x,t.y):(s.x-=t,s.y-=e,s),b=(s,t,e=t)=>d(t)?b(s,t.x,t.y):(s.x*=t,s.y*=e,s),L=(s,t,e=t)=>d(t)?L(s,t.x,t.y):(s.x/=t||1,s.y/=e||1,s),Tt=(s,t)=>{let e=V(t),r=j(t);return s.x=e*s.x-r*s.y,s.y=r*s.x+e*s.y,s},At=(s,t)=>{let e=k(h(t));return N(s,b(e,2*J(s,e)))},z=(s,t)=>(k(s),b(s,t),s),K=s=>Math.hypot(s.x,s.y),$=s=>s.x*s.x+s.y*s.y,k=s=>{let t=K(s);return t>0&&L(s,t),s},Nt=(s,t=1)=>($(s)>t*t&&z(s,t),s),Lt=(s,t)=>Math.hypot(t.x-s.x,t.y-s.y),kt=(s,t)=>{let e=s.x-t.x,r=s.y-t.y;return e*e+r*r},G=s=>Math.atan2(s.y,s.x),St=s=>G(s),Ot=(s,t)=>Math.atan2(t.y-s.y,t.x-s.x),J=(s,t)=>s.x*t.x+s.y*t.y,Ft=(s,t)=>s.x*t.y-s.y*t.x,Ct=(s,t,e)=>(s.x+=(t.x-s.x)*e||0,s.y+=(t.y-s.y)*e||0,s),Bt=s=>(s.x=Math.abs(s.x),s.y=Math.abs(s.y),s),Yt=s=>(s.x=Math.ceil(s.x),s.y=Math.ceil(s.y),s),Zt=s=>(s.x=Math.floor(s.x),s.y=Math.floor(s.y),s),Ut=s=>(s.x=Math.round(s.x),s.y=Math.round(s.y),s),Ht=(s,t,e)=>(s.x<t.x&&(s.x=t.x),s.x>e.x&&(s.x=e.x),s.y<t.y&&(s.y=t.y),s.y>e.y&&(s.y=e.y),s),Wt=(s,t)=>(s.x%=t,s.y%=t,s),Xt=(s,t,e=1)=>A(s,t.x*e,t.y*e),S=(s,t,e=t)=>d(t)?S(s,t.x,t.y):s.x===t&&s.y===e,Dt=s=>S(s,Q),Vt=s=>[s.x,s.y],jt=(s=1,t=s,e=globalThis.rand||Math.random)=>{let r=e()*Rt,i=e()*(t-s)+s;return h(V(r)*i,j(r)*i)},Q=h(0,0),qt=h(1,1),zt=h(0,-1),Kt=h(1,0),$t=h(0,1),Gt=h(-1,0);var Jt=h(.5,.5),v=h(0,0),Qt=h(1,0),vt=h(0,1),ts=h(1,1),O=class{sprite;pos;_o;_s;flipX=!1;flipY=!1;angle=0;opacity=1;hidden=!1;constructor(t,e,r=v){this.sprite=t||{width:0,height:0},this.pos=e||h(0),this._o=h(r),this._s=h(1,1)}set x(t){this.pos.x=t}get x(){return this.pos.x}set y(t){this.pos.y=t}get y(){return this.pos.y}set anchor(t){this._o.x=t.x,this._o.y=t.y}get anchor(){return this._o}get width(){return this.sprite.width*this._s.x}get height(){return this.sprite.height*this._s.y}get scale(){return this._s}scaleTo(t,e=t){this._s.x=t,this._s.y=e}scaleBy(t,e=t){this._s.x*=t,this._s.y*=e}getBounds(t=!0){let e=this.sprite.width*(t?this._s.x:1),r=this.sprite.height*(t?this._s.y:1),i=this.pos.x-e*this.anchor.x,o=this.pos.y-r*this.anchor.y;return[i,o,e,r]}draw(t=globalThis,e=!0){e&&t.push(),this.transform(t),this.sprite.width&&this.sprite.height&&!this.hidden&&this.opacity>0&&this.drawImage(t),e&&t.pop()}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(t.deg2rad(this.angle)),t.scale((this.flipX?-1:1)*this._s.x,(this.flipY?-1:1)*this._s.y)}drawImage(t,e=!0){let r=this.anchor,i=-this.sprite.width*(this.flipX?1-r.x:r.x),o=-this.sprite.height*(this.flipY?1-r.y:r.y);e&&t.alpha(this.opacity),t.image(i,o,this.sprite)}};var tt=(s,t)=>Math.abs(t-s)||0;var st=s=>s%1||0;var et=(s,t,e,r=1)=>{e&&(t.x+=e.x*r,t.y+=e.y*r),s.x+=t.x*r,s.y+=t.y*r};var rt=(s,t)=>(t+s%t)%t;var it=(s,t,e,r)=>Math.hypot(e-s,r-t);var ot=(s,t)=>Math.hypot(s,t);var P=s=>{let t=0;for(let e=0;e<s.length;e++)t+=s[e];return t};var ht=s=>P(s)/s.length;var at=s=>{let t=s.sort((r,i)=>r-i),e=Math.floor(t.length/2);return t.length%2===0?(t[e-1]+t[e])/2:t[e]};var nt=(s,t,e)=>{let r=(t-s)%360;return r>180?r-=360:r<-180&&(r+=360),s+r*e};var lt=(s,t=0,e=1)=>e-t?(s-t)/(e-t):0;var R=Math.PI/2,ss=(s,t,e,r=1,i=ct)=>new F(s,t,e,r,i),ct=s=>s,es=s=>s*s,rs=s=>-s*(s-2),is=s=>s<.5?2*s*s:-2*s*s+4*s-1,os=s=>s*s*s-s*Math.sin(s*Math.PI),hs=s=>{let t=1-s;return 1-(t*t*t-t*Math.sin(t*Math.PI))},as=s=>{if(s<.5){let e=2*s;return .5*(e*e*e-e*Math.sin(e*Math.PI))}let t=1-(2*s-1);return .5*(1-(t*t*t-t*Math.sin(s*Math.PI)))+.5},ns=s=>Math.sin(13*R*s)*Math.pow(2,10*(s-1)),ls=s=>Math.sin(-13*R*(s+1))*Math.pow(2,-10*s)+1,cs=s=>{if(s<.5){let r=Math.sin(13*R*(2*s)),i=Math.pow(2,10*(2*s-1));return .5*r*i}let t=Math.sin(-13*R*(2*s-1+1)),e=Math.pow(2,-10*(2*s-1));return .5*(t*e+2)},pt=s=>1-C(1-s),C=s=>s<4/11?121*s*s/16:s<8/11?363/40*s*s-99/10*s+17/5:s<9/10?4356/361*s*s-35442/1805*s+16061/1805:54/5*s*s-513/25*s+268/25,ps=s=>s<.5?.5*pt(s*2):.5*C(s*2-1)+.5,F=class{running=!1;_o;_p;_x;_d;_w;_e;_rel;_cb=[];_t=0;_u=0;_ch=this;_cu=this;_lc;constructor(t,e,r,i,o){this._o=t,this._p=e,this._x=r,this._d=i,this._e=o,this._w=0}start(t){if(this.running)return this;this._cu.stop(!1),this._ch=this._cu=this,this.running=!0;let e=this._o[this._p]||0,r=this._rel?e+this._x:this._x;return this._lc=this._lc||t||globalThis,this._u=this._lc.listen("update",i=>{if(this._t<=this._w){this._t+=i;return}let o=this._t-this._w;this._o[this._p]=this._lc.lerp(e,r,this._e(o/this._d)),this._t+=i,o>=this._d&&(this._o[this._p]=r,this.stop())}),this}stop(t=!0){if(!this._u)return this;if(this.running=!1,this._u(),this._t=0,t)for(let e of this._cb)e(this._o);return this}restart(t=null,e=!1){return this.stop(e).restart(t)}onEnd(t){return this._cb.push(t),this}chain(t){return this._ch.onEnd(()=>{this._cu=t.start(this._lc)}),this._ch=t,this}reset(){return this._cb.length=0,this.stop()}relative(t=!0){return this._rel=t,this}delay(t){return this._w=t,this}get current(){return this._cu}get progress(){return this.running&&this._t>this._w?(this._t-this._w)/this._d:0}};var B=s=>.5*(1-Math.cos(s*Math.PI)),Y=class{_p=[];_po=4;_pf=.5;_e=null;constructor(t){this._e=t||globalThis,this.noiseSeed()}noise(t,e=0,r=0){t<0&&(t=-t),e<0&&(e=-e),r<0&&(r=-r);let i=Math.floor(t),o=Math.floor(e),a=Math.floor(r),n=t-i,l=e-o,x=r-a,p,m,_=0,y=.5,c,u,E;for(let U=0;U<this._po;U++){let f=i+(o<<4)+(a<<8);p=B(n),m=B(l),c=this._p[f&4095],c+=p*(this._p[f+1&4095]-c),u=this._p[f+16&4095],u+=p*(this._p[f+16+1&4095]-u),c+=m*(u-c),f+=256,u=this._p[f&4095],u+=p*(this._p[f+1&4095]-u),E=this._p[f+16&4095],E+=p*(this._p[f+16+1&4095]-E),u+=m*(E-u),c+=B(x)*(u-c),_+=c*y,y*=this._pf,i<<=1,n*=2,o<<=1,l*=2,a<<=1,x*=2,n>=1&&(i++,n--),l>=1&&(o++,l--),x>=1&&(a++,x--)}return _}noiseDetail(t,e){t>0&&(this._po=t),e>0&&(this._pf=e)}noiseSeed(t=null){t!=null&&this._e.rseed(t);let e=this._e.rand||Math.random;for(let r=0;r<4096;r++)this._p[r]=e()}};var ut=(s,t=!0,e=!1,r=globalThis)=>r.paint(s.width,s.height,i=>{r.push(),r.scale(t?-1:1,e?-1:1),r.image(t?-s.width:0,e?-s.height:0,s),r.pop()});var ft=(s,t,e=!0,r=globalThis)=>r.paint(s.width*t,s.height*t,i=>{r.push(),i.imageSmoothingEnabled=!e,r.scale(t),r.image(0,0,s),r.pop()});var _t=(s,t,e=1,r=globalThis)=>r.paint(s.width,s.height,i=>{r.push(),r.alpha(e),r.rectfill(0,0,s.width,s.height,t),i.globalCompositeOperation="destination-atop",r.alpha(1),r.image(0,0,s),r.pop()});var xt=(s,t,{borderWidth:e=0,borderColor:r=0,engine:i=globalThis}={})=>{let o=s*2+e;return i.paint(o,o,()=>{i.circfill(o/2,o/2,s,t),e>0&&(i.linewidth(e),i.stroke(r))})};var mt=(s,t,e,{borderWidth:r=0,borderColor:i=0,engine:o=globalThis}={})=>{let a=s+r*2,n=t+r*2;return o.paint(a,n,()=>{let l=r>0;l&&o.cls(i),o.rectfill(l?r:0,l?r:0,s,t,e)})};var dt=(s,t=0,e=1)=>[...new Array(s).keys()].map(r=>t+e*r);var yt=(s,t=globalThis.rand||Math.random)=>{s=[...s];for(let e=s.length-1;e>0;e--){let r=Math.floor(t()*(e+1)),i=s[e];s[e]=s[r],s[r]=i}return s};var gt=(s,t=globalThis.rand||Math.random)=>s[Math.floor(t()*s.length)];var It=s=>s[0];var Et=s=>s[s.length-1];var Mt=s=>s.slice(1);var wt=s=>~~(s/60)+":"+(s%60<10?"0":"")+~~(s%60);globalThis.utils=Object.assign(globalThis.utils||{},Z);})();
 /*! @litecanvas/utils by Luiz Bills | MIT Licensed */

package/dist/collision.js

@@ -66,7 +66,7 @@
         resolveY = y2 + h2;
       }
     }
-    return { direction, x: resolveX, y: resolveY };
+    return { dir: direction, x: resolveX, y: resolveY };
   };
 
   // src/debug/assert.js

package/dist/collision.min.js

@@ -1 +1 @@
-(()=>{var x=Object.defineProperty;var w=(e,t)=>{for(var i in t)x(e,i,{get:t[i],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(e=!0)=>{for(let t in globalThis.utils)t!=="global"&&(e||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var h={};w(h,{colcirc:()=>T,colrect:()=>F,intersection:()=>c,resolverect:()=>g});var c=(e,t,i,a,r,s,o,l)=>{let u=Math.max(e,r),d=Math.min(e+i,r+o)-u,n=Math.max(t,s),b=Math.min(t+a,s+l)-n;return[u,n,d,b]};var g=(e,t,i,a,r,s,o,l)=>{let[u,d,n,b]=c(e,t,i,a,r,s,o,l),m="",p=e,f=t;return n<b?e<r?(m="right",p=r-i):(m="left",p=r+o):t<s?(m="bottom",f=s-a):(m="top",f=s+l),{direction:m,x:p,y:f}};var F=(e,t,i,a,r,s,o,l)=>e<r+o&&e+i>r&&t<s+l&&t+a>s;var T=(e,t,i,a,r,s)=>(a-e)*(a-e)+(r-t)*(r-t)<=(i+s)*(i+s);globalThis.utils=Object.assign(globalThis.utils||{},h);})();
+(()=>{var x=Object.defineProperty;var w=(e,t)=>{for(var i in t)x(e,i,{get:t[i],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(e=!0)=>{for(let t in globalThis.utils)t!=="global"&&(e||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var h={};w(h,{colcirc:()=>T,colrect:()=>F,intersection:()=>c,resolverect:()=>g});var c=(e,t,i,a,r,s,o,l)=>{let u=Math.max(e,r),d=Math.min(e+i,r+o)-u,n=Math.max(t,s),b=Math.min(t+a,s+l)-n;return[u,n,d,b]};var g=(e,t,i,a,r,s,o,l)=>{let[u,d,n,b]=c(e,t,i,a,r,s,o,l),m="",p=e,f=t;return n<b?e<r?(m="right",p=r-i):(m="left",p=r+o):t<s?(m="bottom",f=s-a):(m="top",f=s+l),{dir:m,x:p,y:f}};var F=(e,t,i,a,r,s,o,l)=>e<r+o&&e+i>r&&t<s+l&&t+a>s;var T=(e,t,i,a,r,s)=>(a-e)*(a-e)+(r-t)*(r-t)<=(i+s)*(i+s);globalThis.utils=Object.assign(globalThis.utils||{},h);})();

package/dist/grid.js

@@ -159,7 +159,7 @@
      * @param {number} y
      * @param {any} value
      * @param {Grid} grid
-     * @returns {boolean?} returns `false` to stop/break the loop
+     * @returns {false|void} returns `false` to stop/break the loop
      *
      * @param {GridForEachCallback} callback
      * @param {boolean} [reverse=false]

package/dist/math.js

@@ -64,8 +64,14 @@
     return Math.hypot(x, y);
   };
 
+  // src/debug/assert.js
+  var assert_default = (condition, message = "Assertion failed") => {
+    if (!condition) throw new Error(message);
+  };
+
   // src/math/sum.js
   var sum_default = (values) => {
+    DEV: assert_default(Array.isArray(values), "1st param must be an array");
     let result = 0;
     for (let i = 0; i < values.length; i++) {
       result += values[i];
@@ -75,11 +81,13 @@
 
   // src/math/mean.js
   var mean_default = (values) => {
+    DEV: assert_default(Array.isArray(values), "1st param must be an array");
     return sum_default(values) / values.length;
   };
 
   // src/math/median.js
-  var median_default = (...values) => {
+  var median_default = (values) => {
+    DEV: assert_default(Array.isArray(values), "1st param must be an array");
     const sorted = values.sort((a, b) => a - b);
     const middle = Math.floor(sorted.length / 2);
     if (sorted.length % 2 === 0) {

package/dist/math.min.js

@@ -1 +1 @@
-(()=>{var M=Object.defineProperty;var g=(e,t)=>{for(var r in t)M(e,r,{get:t[r],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(e=!0)=>{for(let t in globalThis.utils)t!=="global"&&(e||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var n={};g(n,{advance:()=>u,diff:()=>c,dist:()=>l,fract:()=>x,lerpAngle:()=>i,mag:()=>a,mean:()=>f,median:()=>y,mod:()=>p,percent:()=>h,sum:()=>s});var c=(e,t)=>Math.abs(t-e)||0;var x=e=>e%1||0;var R=2*Math.PI;var u=(e,t,r,o=1)=>{r&&(t.x+=r.x*o,t.y+=r.y*o),e.x+=t.x*o,e.y+=t.y*o};var p=(e,t)=>(t+e%t)%t;var l=(e,t,r,o)=>Math.hypot(r-e,o-t);var a=(e,t)=>Math.hypot(e,t);var s=e=>{let t=0;for(let r=0;r<e.length;r++)t+=e[r];return t};var f=e=>s(e)/e.length;var y=(...e)=>{let t=e.sort((o,d)=>o-d),r=Math.floor(t.length/2);return t.length%2===0?(t[r-1]+t[r])/2:t[r]};var i=(e,t,r)=>{let o=(t-e)%360;return o>180?o-=360:o<-180&&(o+=360),e+o*r};var h=(e,t=0,r=1)=>r-t?(e-t)/(r-t):0;globalThis.utils=Object.assign(globalThis.utils||{},n);})();
+(()=>{var m=Object.defineProperty;var g=(r,t)=>{for(var e in t)m(r,e,{get:t[e],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=(r=!0)=>{for(let t in globalThis.utils)t!=="global"&&(r||globalThis[t]===void 0)&&(globalThis[t]=globalThis.utils[t])};var n={};g(n,{advance:()=>x,diff:()=>a,dist:()=>u,fract:()=>c,lerpAngle:()=>i,mag:()=>l,mean:()=>f,median:()=>y,mod:()=>p,percent:()=>h,sum:()=>s});var a=(r,t)=>Math.abs(t-r)||0;var c=r=>r%1||0;var T=2*Math.PI;var x=(r,t,e,o=1)=>{e&&(t.x+=e.x*o,t.y+=e.y*o),r.x+=t.x*o,r.y+=t.y*o};var p=(r,t)=>(t+r%t)%t;var u=(r,t,e,o)=>Math.hypot(e-r,o-t);var l=(r,t)=>Math.hypot(r,t);var s=r=>{let t=0;for(let e=0;e<r.length;e++)t+=r[e];return t};var f=r=>s(r)/r.length;var y=r=>{let t=r.sort((o,d)=>o-d),e=Math.floor(t.length/2);return t.length%2===0?(t[e-1]+t[e])/2:t[e]};var i=(r,t,e)=>{let o=(t-r)%360;return o>180?o-=360:o<-180&&(o+=360),r+o*e};var h=(r,t=0,e=1)=>e-t?(r-t)/(e-t):0;globalThis.utils=Object.assign(globalThis.utils||{},n);})();

package/dist/vector.js

@@ -40,27 +40,25 @@
     vecNorm: () => vecNorm,
     vecRand: () => vecRand,
     vecReflect: () => vecReflect,
+    vecRem: () => vecRem,
     vecRotate: () => vecRotate,
     vecRound: () => vecRound,
     vecSet: () => vecSet,
     vecSetMag: () => vecSetMag,
-    vecSub: () => vecSub
+    vecSub: () => vecSub,
+    vecToArray: () => vecToArray
   });
   var cos = Math.cos;
   var sin = Math.sin;
   var PI2 = 2 * Math.PI;
   var Vector = class {
-    /** @type {number} */
-    x;
-    /** @type {number} */
-    y;
     /**
      * @param {number} [x=0]
      * @param {number} [y]
      */
     constructor(x = 0, y = x) {
-      this.x = x;
-      this.y = y;
+      this.x = parseFloat(x) || 0;
+      this.y = parseFloat(y) || 0;
     }
     /**
      * @returns {string}
@@ -77,12 +75,6 @@
     }
     return new Vector(x, y);
   };
-  var vecEq = (v, x, y = x) => {
-    if (isVector(x)) {
-      return vecEq(v, x.x, x.y);
-    }
-    return v.x === x && v.y === y;
-  };
   var vecSet = (v, x, y = x) => {
     if (isVector(x)) {
       vecSet(v, x.x, x.y);
@@ -173,11 +165,6 @@
     a.y += (b.y - a.y) * t || 0;
     return a;
   };
-  var vecRand = (minlength = 1, maxlength = minlength, rng = globalThis.rand || Math.random) => {
-    const angle = rng() * PI2;
-    const radius = rng() * (maxlength - minlength) + minlength;
-    return vec(cos(angle) * radius, sin(angle) * radius);
-  };
   var vecAbs = (v) => {
     v.x = Math.abs(v.x);
     v.y = Math.abs(v.y);
@@ -205,8 +192,25 @@
     if (v.y > max.y) v.y = max.y;
     return v;
   };
+  var vecRem = (v, value) => {
+    v.x %= value;
+    v.y %= value;
+    return v;
+  };
   var vecMove = (from, to, delta = 1) => vecAdd(from, to.x * delta, to.y * delta);
+  var vecEq = (v, x, y = x) => {
+    if (isVector(x)) {
+      return vecEq(v, x.x, x.y);
+    }
+    return v.x === x && v.y === y;
+  };
   var vecIsZero = (v) => vecEq(v, ZERO);
+  var vecToArray = (v) => [v.x, v.y];
+  var vecRand = (minlength = 1, maxlength = minlength, rng = globalThis.rand || Math.random) => {
+    const angle = rng() * PI2;
+    const radius = rng() * (maxlength - minlength) + minlength;
+    return vec(cos(angle) * radius, sin(angle) * radius);
+  };
   var ZERO = /* @__PURE__ */ vec(0, 0);
   var ONE = /* @__PURE__ */ vec(1, 1);
   var UP = /* @__PURE__ */ vec(0, -1);

package/dist/vector.min.js

@@ -1 +1 @@
-(()=>{var C=Object.defineProperty;var E=(t,e)=>{for(var o in e)C(t,o,{get:e[o],enumerable:!0})};var h={};E(h,{DOWN:()=>K,LEFT:()=>Q,ONE:()=>k,RIGHT:()=>J,UP:()=>z,Vector:()=>s,ZERO:()=>A,vec:()=>r,vecAbs:()=>Z,vecAdd:()=>p,vecAngle:()=>P,vecAngleBetween:()=>w,vecCeil:()=>$,vecClamp:()=>G,vecCross:()=>F,vecDist:()=>L,vecDist2:()=>N,vecDiv:()=>i,vecDot:()=>T,vecEq:()=>y,vecFloor:()=>j,vecHeading:()=>D,vecIsZero:()=>W,vecLerp:()=>H,vecLimit:()=>b,vecMag:()=>R,vecMag2:()=>q,vecMove:()=>V,vecMult:()=>x,vecNorm:()=>a,vecRand:()=>U,vecReflect:()=>S,vecRotate:()=>O,vecRound:()=>B,vecSet:()=>d,vecSetMag:()=>g,vecSub:()=>u});var M=Math.cos,f=Math.sin,I=2*Math.PI,s=class{x;y;constructor(e=0,o=e){this.x=e,this.y=o}toString(){return`Vector (${this.x}, ${this.y})`}},n=t=>t instanceof s,r=(t=0,e=t)=>(n(t)&&(e=t.y,t=t.x),new s(t,e)),y=(t,e,o=e)=>n(e)?y(t,e.x,e.y):t.x===e&&t.y===o,d=(t,e,o=e)=>(n(e)?d(t,e.x,e.y):(t.x=e,t.y=o),t),p=(t,e,o=e)=>n(e)?p(t,e.x,e.y):(t.x+=e,t.y+=o,t),u=(t,e,o=e)=>n(e)?u(t,e.x,e.y):(t.x-=e,t.y-=o,t),x=(t,e,o=e)=>n(e)?x(t,e.x,e.y):(t.x*=e,t.y*=o,t),i=(t,e,o=e)=>n(e)?i(t,e.x,e.y):(t.x/=e||1,t.y/=o||1,t),O=(t,e)=>{let o=M(e),c=f(e);return t.x=o*t.x-c*t.y,t.y=c*t.x+o*t.y,t},S=(t,e)=>{let o=a(r(e));return u(t,x(o,2*T(t,o)))},g=(t,e)=>(a(t),x(t,e),t),R=t=>Math.hypot(t.x,t.y),q=t=>t.x*t.x+t.y*t.y,a=t=>{let e=R(t);return e>0&&i(t,e),t},b=(t,e=1)=>(q(t)>e*e&&g(t,e),t),L=(t,e)=>Math.hypot(e.x-t.x,e.y-t.y),N=(t,e)=>{let o=t.x-e.x,c=t.y-e.y;return o*o+c*c},D=t=>Math.atan2(t.y,t.x),P=t=>D(t),w=(t,e)=>Math.atan2(e.y-t.y,e.x-t.x),T=(t,e)=>t.x*e.x+t.y*e.y,F=(t,e)=>t.x*e.y-t.y*e.x,H=(t,e,o)=>(t.x+=(e.x-t.x)*o||0,t.y+=(e.y-t.y)*o||0,t),U=(t=1,e=t,o=globalThis.rand||Math.random)=>{let c=o()*I,l=o()*(e-t)+t;return r(M(c)*l,f(c)*l)},Z=t=>(t.x=Math.abs(t.x),t.y=Math.abs(t.y),t),$=t=>(t.x=Math.ceil(t.x),t.y=Math.ceil(t.y),t),j=t=>(t.x=Math.floor(t.x),t.y=Math.floor(t.y),t),B=t=>(t.x=Math.round(t.x),t.y=Math.round(t.y),t),G=(t,e,o)=>(t.x<e.x&&(t.x=e.x),t.x>o.x&&(t.x=o.x),t.y<e.y&&(t.y=e.y),t.y>o.y&&(t.y=o.y),t),V=(t,e,o=1)=>p(t,e.x*o,e.y*o),W=t=>y(t,A),A=r(0,0),k=r(1,1),z=r(0,-1),J=r(1,0),K=r(0,1),Q=r(-1,0);globalThis.utils=Object.assign(globalThis.utils||{},h);})();
+(()=>{var E=Object.defineProperty;var F=(t,e)=>{for(var o in e)E(t,o,{get:e[o],enumerable:!0})};var h={};F(h,{DOWN:()=>X,LEFT:()=>Y,ONE:()=>J,RIGHT:()=>Q,UP:()=>K,Vector:()=>s,ZERO:()=>C,vec:()=>r,vecAbs:()=>U,vecAdd:()=>y,vecAngle:()=>N,vecAngleBetween:()=>P,vecCeil:()=>Z,vecClamp:()=>B,vecCross:()=>w,vecDist:()=>q,vecDist2:()=>L,vecDiv:()=>u,vecDot:()=>D,vecEq:()=>a,vecFloor:()=>$,vecHeading:()=>A,vecIsZero:()=>W,vecLerp:()=>H,vecLimit:()=>b,vecMag:()=>R,vecMag2:()=>T,vecMove:()=>V,vecMult:()=>x,vecNorm:()=>i,vecRand:()=>z,vecReflect:()=>S,vecRem:()=>G,vecRotate:()=>O,vecRound:()=>j,vecSet:()=>d,vecSetMag:()=>g,vecSub:()=>p,vecToArray:()=>k});var M=Math.cos,f=Math.sin,I=2*Math.PI,s=class{constructor(e=0,o=e){this.x=parseFloat(e)||0,this.y=parseFloat(o)||0}toString(){return`Vector (${this.x}, ${this.y})`}},n=t=>t instanceof s,r=(t=0,e=t)=>(n(t)&&(e=t.y,t=t.x),new s(t,e)),d=(t,e,o=e)=>(n(e)?d(t,e.x,e.y):(t.x=e,t.y=o),t),y=(t,e,o=e)=>n(e)?y(t,e.x,e.y):(t.x+=e,t.y+=o,t),p=(t,e,o=e)=>n(e)?p(t,e.x,e.y):(t.x-=e,t.y-=o,t),x=(t,e,o=e)=>n(e)?x(t,e.x,e.y):(t.x*=e,t.y*=o,t),u=(t,e,o=e)=>n(e)?u(t,e.x,e.y):(t.x/=e||1,t.y/=o||1,t),O=(t,e)=>{let o=M(e),c=f(e);return t.x=o*t.x-c*t.y,t.y=c*t.x+o*t.y,t},S=(t,e)=>{let o=i(r(e));return p(t,x(o,2*D(t,o)))},g=(t,e)=>(i(t),x(t,e),t),R=t=>Math.hypot(t.x,t.y),T=t=>t.x*t.x+t.y*t.y,i=t=>{let e=R(t);return e>0&&u(t,e),t},b=(t,e=1)=>(T(t)>e*e&&g(t,e),t),q=(t,e)=>Math.hypot(e.x-t.x,e.y-t.y),L=(t,e)=>{let o=t.x-e.x,c=t.y-e.y;return o*o+c*c},A=t=>Math.atan2(t.y,t.x),N=t=>A(t),P=(t,e)=>Math.atan2(e.y-t.y,e.x-t.x),D=(t,e)=>t.x*e.x+t.y*e.y,w=(t,e)=>t.x*e.y-t.y*e.x,H=(t,e,o)=>(t.x+=(e.x-t.x)*o||0,t.y+=(e.y-t.y)*o||0,t),U=t=>(t.x=Math.abs(t.x),t.y=Math.abs(t.y),t),Z=t=>(t.x=Math.ceil(t.x),t.y=Math.ceil(t.y),t),$=t=>(t.x=Math.floor(t.x),t.y=Math.floor(t.y),t),j=t=>(t.x=Math.round(t.x),t.y=Math.round(t.y),t),B=(t,e,o)=>(t.x<e.x&&(t.x=e.x),t.x>o.x&&(t.x=o.x),t.y<e.y&&(t.y=e.y),t.y>o.y&&(t.y=o.y),t),G=(t,e)=>(t.x%=e,t.y%=e,t),V=(t,e,o=1)=>y(t,e.x*o,e.y*o),a=(t,e,o=e)=>n(e)?a(t,e.x,e.y):t.x===e&&t.y===o,W=t=>a(t,C),k=t=>[t.x,t.y],z=(t=1,e=t,o=globalThis.rand||Math.random)=>{let c=o()*I,l=o()*(e-t)+t;return r(M(c)*l,f(c)*l)},C=r(0,0),J=r(1,1),K=r(0,-1),Q=r(1,0),X=r(0,1),Y=r(-1,0);globalThis.utils=Object.assign(globalThis.utils||{},h);})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litecanvas/utils",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "Utilities to help build litecanvas games",
   "author": "Luiz Bills <luizbills@pm.me>",
   "license": "MIT",
@@ -37,7 +37,7 @@
     "litecanvas": "latest"
   },
   "devDependencies": {
-    "esbuild": "^0.25.8",
+    "esbuild": "^0.25.9",
     "gzip-size": "^7.0.0",
     "prettier": "^3.6.2"
   }

package/src/actor/index.js

@@ -40,7 +40,7 @@ export class Actor {
    * @param {Vector} anchor
    */
   constructor(sprite, position, anchor = ANCHOR_TOP_LEFT) {
-    this.sprite = sprite
+    this.sprite = sprite || { width: 0, height: 0 }
     this.pos = position || vec(0)
     this._o = vec(anchor) // clone the anchor vector
     this._s = vec(1, 1)
@@ -146,40 +146,46 @@ export class Actor {
   /**
    * Draw the actor
    *
-   * @param {LitecanvasInstance} [litecanvas]
+   * @param {LitecanvasInstance} [engine]
    */
-  draw(litecanvas = globalThis, saveContext = true) {
-    if (this.hidden || this.opacity <= 0) return
+  draw(engine = globalThis, saveContext = true) {
+    if (saveContext) engine.push()
 
-    if (saveContext) litecanvas.push()
+    this.transform(engine)
 
-    this.transform(litecanvas)
-    this.drawImage(litecanvas)
+    if (
+      this.sprite.width &&
+      this.sprite.height &&
+      !this.hidden &&
+      this.opacity > 0
+    ) {
+      this.drawImage(engine)
+    }
 
-    if (saveContext) litecanvas.pop()
+    if (saveContext) engine.pop()
   }
 
   /**
-   * @param {LitecanvasInstance} litecanvas
+   * @param {LitecanvasInstance} engine
    */
-  transform(litecanvas) {
-    litecanvas.translate(this.pos.x, this.pos.y)
-    litecanvas.rotate(litecanvas.deg2rad(this.angle))
-    litecanvas.scale(
+  transform(engine) {
+    engine.translate(this.pos.x, this.pos.y)
+    engine.rotate(engine.deg2rad(this.angle))
+    engine.scale(
       (this.flipX ? -1 : 1) * this._s.x,
       (this.flipY ? -1 : 1) * this._s.y
     )
   }
 
   /**
-   * @param {LitecanvasInstance} litecanvas
+   * @param {LitecanvasInstance} engine
    */
-  drawImage(litecanvas, alpha = true) {
+  drawImage(engine, alpha = true) {
     const anchor = this.anchor
     const x = -this.sprite.width * (this.flipX ? 1 - anchor.x : anchor.x)
     const y = -this.sprite.height * (this.flipY ? 1 - anchor.y : anchor.y)
 
-    if (alpha) litecanvas.alpha(this.opacity)
-    litecanvas.image(x, y, this.sprite)
+    if (alpha) engine.alpha(this.opacity)
+    engine.image(x, y, this.sprite)
   }
 }

package/src/collision/resolverect.js

@@ -12,7 +12,7 @@ import intersection from "./intersection.js"
  * @param {number} y2
  * @param {number} w2
  * @param {number} h2
- * @returns {{direction: string, x: number, y: number}} An object containing the direction of the collision and the new position (X and Y) of the first rectangle.
+ * @returns {{dir: string, x: number, y: number}} An object containing the direction of the collision and the new position (X and Y) of the first rectangle.
  */
 export default (x1, y1, w1, h1, x2, y2, w2, h2) => {
   // get the intersection area
@@ -49,5 +49,5 @@ export default (x1, y1, w1, h1, x2, y2, w2, h2) => {
     }
   }
 
-  return { direction, x: resolveX, y: resolveY }
+  return { dir: direction, x: resolveX, y: resolveY }
 }

package/src/grid/index.js

@@ -152,7 +152,7 @@ export class Grid {
    * @param {number} y
    * @param {any} value
    * @param {Grid} grid
-   * @returns {boolean?} returns `false` to stop/break the loop
+   * @returns {false|void} returns `false` to stop/break the loop
    *
    * @param {GridForEachCallback} callback
    * @param {boolean} [reverse=false]

package/src/math/advance.js

@@ -6,8 +6,8 @@ import { Vector } from "../vector/index.js"
  *
  * @param {Vector} position
  * @param {Vector} velocity
- * @param {Vector?} [acceleration]
- * @param {number?} [deltaTime]
+ * @param {Vector} [acceleration]
+ * @param {number} [deltaTime]
  */
 export default (position, velocity, acceleration, deltaTime = 1) => {
   if (acceleration) {

package/src/math/mean.js

@@ -1,3 +1,4 @@
+import assert from "../debug/assert.js"
 import sum from "./sum.js"
 
 /**
@@ -7,5 +8,6 @@ import sum from "./sum.js"
  * @returns {number}
  */
 export default (values) => {
+  DEV: assert(Array.isArray(values), "1st param must be an array")
   return sum(values) / values.length
 }

package/src/math/median.js

@@ -1,3 +1,5 @@
+import assert from "../debug/assert"
+
 /**
  * Compute the median of the values. The values are sorted and the middle value is returned.
  * In case of an even number of values, the average of the two middle values is returned
@@ -5,7 +7,8 @@
  * @param {number[]} values
  * @returns {number}
  */
-export default (...values) => {
+export default (values) => {
+  DEV: assert(Array.isArray(values), "1st param must be an array")
   const sorted = values.sort((a, b) => a - b)
   const middle = Math.floor(sorted.length / 2)
 

package/src/math/sum.js

@@ -1,10 +1,15 @@
+import assert from "../debug/assert"
+
 /**
  * Computes the sum of the values in a array.
  *
+ * usage: `sum([2,3,5]) // returns 10`
+ *
  * @param {number[]} values list of numbers
  * @returns {number}
  */
 export default (values) => {
+  DEV: assert(Array.isArray(values), "1st param must be an array")
   let result = 0
   for (let i = 0; i < values.length; i++) {
     result += values[i]

package/src/vector/README.md

@@ -129,17 +129,19 @@ Returns the distance between two points represented by vectors squared.
 
 Syntax: `vecDist2(a: Vector, b: Vector): number`
 
-## vecAngle
+## vecHeading
 
 Calculates the angle a vector makes with the positive x-axis.
 
-Syntax: `vecAngle(v: Vector): number`
+Syntax: `vecHeading(v: Vector): number`
 
 ```js
-const a = vecAngle(vec(1, 0)) // outputs 0 (zero)
-const b = vecAngle(vec(0, 1)) // outputs ~1.571 (same as Math.PI / 2)
+const a = vecHeading(vec(1, 0)) // outputs 0 (zero)
+const b = vecHeading(vec(0, 1)) // outputs ~1.571 (same as Math.PI/2 or 90°)
 ```
 
+> Note: `vecAngle` is alias of `vecHeading`.
+
 ## vecDot
 
 Calculates the dot product of two vectors.
@@ -163,6 +165,12 @@ values equal to the new vector's.
 
 Syntax: `vecLerp(a: Vector, b: Vector, atm: number): Lerp`
 
+## vecRem
+
+Performs modulo (remainder) division with a vector's components.
+
+Syntax: `vecRem(v: Vector, divisor: number): Vector`
+
 ## vecRand
 
 Creates a vector with random direction and (optional) length.

package/src/vector/index.js

@@ -1,21 +1,15 @@
-const sqrt = Math.sqrt,
-  cos = Math.cos,
+const cos = Math.cos,
   sin = Math.sin,
   PI2 = 2 * Math.PI
 
 export class Vector {
-  /** @type {number} */
-  x
-  /** @type {number} */
-  y
-
   /**
    * @param {number} [x=0]
    * @param {number} [y]
    */
   constructor(x = 0, y = x) {
-    this.x = x
-    this.y = y
+    this.x = parseFloat(x) || 0
+    this.y = parseFloat(y) || 0
   }
 
   /**
@@ -47,21 +41,6 @@ export const vec = (x = 0, y = x) => {
   return new Vector(x, y)
 }
 
-/**
- * Checks whether two vectors are equal.
- *
- * @param {Vector} v
- * @param {number|Vector} x
- * @param {number} [y]
- * @returns {boolean}
- */
-export const vecEq = (v, x, y = x) => {
-  if (isVector(x)) {
-    return vecEq(v, x.x, x.y)
-  }
-  return v.x === x && v.y === y
-}
-
 /**
  * Assigns new values to a vector.
  *
@@ -187,7 +166,7 @@ export const vecReflect = (v, normal) => {
 }
 
 /**
- * Reflects a vector about a line (second argument).
+ * Sets a vector's magnitude to value.
  *
  * @param {Vector} v
  * @param {Vector} normal
@@ -338,27 +317,6 @@ export const vecLerp = (a, b, t) => {
   return a
 }
 
-/**
- * Sample a vector with random direction and (optional) length.
- *
- * If the `litecanvas#rand()` not is globally explosed, uses `Math.random()`.
- * You can set `vecconfig.random` to set your own "random" function.
- *
- * @param {number} [minlength]
- * @param {number} [maxlength]
- * @param {() => number} [randomFn]
- * @returns {Vector}
- */
-export const vecRand = (
-  minlength = 1,
-  maxlength = minlength,
-  rng = globalThis.rand || Math.random
-) => {
-  const angle = rng() * PI2
-  const radius = rng() * (maxlength - minlength) + minlength
-  return vec(cos(angle) * radius, sin(angle) * radius)
-}
-
 /**
  * @param {Vector} v
  * @returns {Vector}
@@ -421,6 +379,19 @@ export const vecClamp = (v, min, max) => {
   return v
 }
 
+/**
+ * Performs modulo (remainder) division with a vector's components.
+ *
+ * @param {Vector} v
+ * @param {number} value
+ * @returns {Vector}
+ */
+export const vecRem = (v, value) => {
+  v.x %= value
+  v.y %= value
+  return v
+}
+
 /**
  * @param {Vector} from
  * @param {Vector} to
@@ -430,8 +401,56 @@ export const vecClamp = (v, min, max) => {
 export const vecMove = (from, to, delta = 1) =>
   vecAdd(from, to.x * delta, to.y * delta)
 
+/**
+ * Checks whether two vectors are equal.
+ *
+ * @param {Vector} v
+ * @param {number|Vector} x
+ * @param {number} [y]
+ * @returns {boolean}
+ */
+export const vecEq = (v, x, y = x) => {
+  if (isVector(x)) {
+    return vecEq(v, x.x, x.y)
+  }
+  return v.x === x && v.y === y
+}
+
+/**
+ * Checks if the vector's components are zero.
+ *
+ * @param {Vector} v
+ * @returns {boolean}
+ */
 export const vecIsZero = (v) => vecEq(v, ZERO)
 
+/**
+ * Returns the vector's components as an array of numbers.
+ *
+ * @returns {number[]}
+ */
+export const vecToArray = (v) => [v.x, v.y]
+
+/**
+ * Sample a vector with random direction and (optional) length.
+ *
+ * If the `litecanvas#rand()` not is globally explosed, uses `Math.random()`.
+ *
+ * @param {number} [minlength]
+ * @param {number} [maxlength]
+ * @param {() => number} [randomFn]
+ * @returns {Vector}
+ */
+export const vecRand = (
+  minlength = 1,
+  maxlength = minlength,
+  rng = globalThis.rand || Math.random
+) => {
+  const angle = rng() * PI2
+  const radius = rng() * (maxlength - minlength) + minlength
+  return vec(cos(angle) * radius, sin(angle) * radius)
+}
+
 // constants
 export const ZERO = /** @__PURE__ */ vec(0, 0)
 export const ONE = /** @__PURE__ */ vec(1, 1)