@litecanvas/utils 0.13.0 → 0.15.0

package/README.md

@@ -49,4 +49,5 @@ const pos = vec(0, 0)
 - **Actor**: class to represent game entities. [Usage & Docs](https://github.com/litecanvas/utils/tree/main/src/actor)
 - **Grid**: class to handle retangular grid areas. [Usage & Docs](https://github.com/litecanvas/utils/tree/main/src/grid)
 - **Collision** utilities. [Usage & Docs](https://github.com/litecanvas/utils/tree/main/src/collision)
-- And [some math utilities](https://github.com/litecanvas/utils/tree/main/src/math)
+- **Tween** to create animations. [Usage & Docs](https://github.com/litecanvas/utils/tree/main/src/tween)
+- And some [math utilities](https://github.com/litecanvas/utils/tree/main/src/math)...

package/dist/actor.js

@@ -56,12 +56,15 @@
     return new Vector(x, y);
   };
 
+  // node_modules/litecanvas/src/zzfx.js
+  globalThis.zzfxV = 1;
+
   // src/actor/index.js
-  var ANCHOR_CENTER = vec(0.5, 0.5);
-  var ANCHOR_TOP_LEFT = vec(0, 0);
-  var ANCHOR_TOP_RIGHT = vec(1, 0);
-  var ANCHOR_BOT_LEFT = vec(0, 1);
-  var ANCHOR_BOT_RIGHT = vec(1, 1);
+  var ANCHOR_CENTER = /* @__PURE__ */ vec(0.5, 0.5);
+  var ANCHOR_TOP_LEFT = /* @__PURE__ */ vec(0, 0);
+  var ANCHOR_TOP_RIGHT = /* @__PURE__ */ vec(1, 0);
+  var ANCHOR_BOT_LEFT = /* @__PURE__ */ vec(0, 1);
+  var ANCHOR_BOT_RIGHT = /* @__PURE__ */ vec(1, 1);
   var Actor = class {
     /** @type {Image|HTMLCanvasElement|OffscreenCanvas} */
     sprite;
@@ -143,6 +146,26 @@
     get scale() {
       return this._s;
     }
+    /**
+     * Sets the actor scale
+     *
+     * @param {number} x
+     * @param {number} [y]
+     */
+    scaleTo(x, y = x) {
+      this._s.x = x;
+      this._s.y = y;
+    }
+    /**
+     * Multiplies the actor scale
+     *
+     * @param {number} x
+     * @param {number} [y]
+     */
+    scaleBy(x, y = x) {
+      this._s.x *= x;
+      this._s.y *= y;
+    }
     /**
      * @returns {number[]}
      */
@@ -154,16 +177,16 @@
       return [x, y, w, h];
     }
     /**
-     * Update the transformation matrix, sets the opacity and draw the actor sprite image.
+     * Draw the actor
      *
      * @param {LitecanvasInstance} [litecanvas]
      */
-    draw(litecanvas = globalThis) {
+    draw(litecanvas = globalThis, saveContext = true) {
       if (this.hidden || this.opacity <= 0) return;
-      litecanvas.push();
+      if (saveContext) litecanvas.push();
       this.transform(litecanvas);
       this.drawImage(litecanvas);
-      litecanvas.pop();
+      if (saveContext) litecanvas.pop();
     }
     /**
      * @param {LitecanvasInstance} litecanvas
@@ -176,10 +199,10 @@
     /**
      * @param {LitecanvasInstance} litecanvas
      */
-    drawImage(litecanvas) {
+    drawImage(litecanvas, alpha = true) {
       const anchorX = this.sprite.width * this.anchor.x;
       const anchorY = this.sprite.height * this.anchor.y;
-      litecanvas.alpha(this.opacity);
+      if (alpha) litecanvas.alpha(this.opacity);
       litecanvas.image(-anchorX, -anchorY, this.sprite);
     }
   };

package/dist/actor.min.js

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

package/dist/all.js

@@ -23,25 +23,41 @@
     ANCHOR_TOP_LEFT: () => ANCHOR_TOP_LEFT,
     ANCHOR_TOP_RIGHT: () => ANCHOR_TOP_RIGHT,
     Actor: () => Actor,
+    BACK_IN: () => BACK_IN,
+    BACK_IN_OUT: () => BACK_IN_OUT,
+    BACK_OUT: () => BACK_OUT,
+    BOUNCE_IN: () => BOUNCE_IN,
+    BOUNCE_IN_OUT: () => BOUNCE_IN_OUT,
+    BOUNCE_OUT: () => BOUNCE_OUT,
     Camera: () => Camera,
     DOWN: () => DOWN,
+    EASE_IN: () => EASE_IN,
+    EASE_IN_OUT: () => EASE_IN_OUT,
+    EASE_OUT: () => EASE_OUT,
+    ELASTIC_IN: () => ELASTIC_IN,
+    ELASTIC_IN_OUT: () => ELASTIC_IN_OUT,
+    ELASTIC_OUT: () => ELASTIC_OUT,
     Grid: () => Grid,
     LEFT: () => LEFT,
+    LINEAR: () => LINEAR,
     ONE: () => ONE,
     RIGHT: () => RIGHT,
     TypedGrid: () => TypedGrid,
     UP: () => UP,
     Vector: () => Vector,
     ZERO: () => ZERO,
+    advance: () => advance_default,
     diff: () => diff_default,
     fract: () => fract_default,
     intersection: () => intersection_default,
     range: () => range_default,
     resolve: () => resolve_default,
+    tween: () => tween,
     vec: () => vec,
     vecAbs: () => vecAbs,
     vecAdd: () => vecAdd,
     vecAngle: () => vecAngle,
+    vecAngleBetween: () => vecAngleBetween,
     vecCeil: () => vecCeil,
     vecClamp: () => vecClamp,
     vecCross: () => vecCross,
@@ -590,8 +606,8 @@
     if (isVector(x)) {
       return vecDiv(v, x.x, x.y);
     }
-    v.x /= x;
-    v.y /= y;
+    v.x /= x || 1;
+    v.y /= y || 1;
     return v;
   };
   var vecRotate = (v, radians) => {
@@ -637,6 +653,7 @@
     return dx * dx + dy * dy;
   };
   var vecAngle = (v) => Math.atan2(v.y, v.x);
+  var vecAngleBetween = (v1, v2) => Math.atan2(v2.y - v1.y, v2.x - v1.x);
   var vecDot = (a, b) => a.x * b.x + a.y * b.y;
   var vecCross = (a, b) => a.x * b.y - a.y * b.x;
   var vecLerp = (a, b, t) => {
@@ -685,12 +702,15 @@
   var DOWN = /* @__PURE__ */ vec(0, 1);
   var LEFT = /* @__PURE__ */ vec(-1, 0);
 
+  // node_modules/litecanvas/src/zzfx.js
+  globalThis.zzfxV = 1;
+
   // src/actor/index.js
-  var ANCHOR_CENTER = vec(0.5, 0.5);
-  var ANCHOR_TOP_LEFT = vec(0, 0);
-  var ANCHOR_TOP_RIGHT = vec(1, 0);
-  var ANCHOR_BOT_LEFT = vec(0, 1);
-  var ANCHOR_BOT_RIGHT = vec(1, 1);
+  var ANCHOR_CENTER = /* @__PURE__ */ vec(0.5, 0.5);
+  var ANCHOR_TOP_LEFT = /* @__PURE__ */ vec(0, 0);
+  var ANCHOR_TOP_RIGHT = /* @__PURE__ */ vec(1, 0);
+  var ANCHOR_BOT_LEFT = /* @__PURE__ */ vec(0, 1);
+  var ANCHOR_BOT_RIGHT = /* @__PURE__ */ vec(1, 1);
   var Actor = class {
     /** @type {Image|HTMLCanvasElement|OffscreenCanvas} */
     sprite;
@@ -772,6 +792,26 @@
     get scale() {
       return this._s;
     }
+    /**
+     * Sets the actor scale
+     *
+     * @param {number} x
+     * @param {number} [y]
+     */
+    scaleTo(x, y = x) {
+      this._s.x = x;
+      this._s.y = y;
+    }
+    /**
+     * Multiplies the actor scale
+     *
+     * @param {number} x
+     * @param {number} [y]
+     */
+    scaleBy(x, y = x) {
+      this._s.x *= x;
+      this._s.y *= y;
+    }
     /**
      * @returns {number[]}
      */
@@ -783,16 +823,16 @@
       return [x, y, w, h];
     }
     /**
-     * Update the transformation matrix, sets the opacity and draw the actor sprite image.
+     * Draw the actor
      *
      * @param {LitecanvasInstance} [litecanvas]
      */
-    draw(litecanvas = globalThis) {
+    draw(litecanvas = globalThis, saveContext = true) {
       if (this.hidden || this.opacity <= 0) return;
-      litecanvas.push();
+      if (saveContext) litecanvas.push();
       this.transform(litecanvas);
       this.drawImage(litecanvas);
-      litecanvas.pop();
+      if (saveContext) litecanvas.pop();
     }
     /**
      * @param {LitecanvasInstance} litecanvas
@@ -805,10 +845,10 @@
     /**
      * @param {LitecanvasInstance} litecanvas
      */
-    drawImage(litecanvas) {
+    drawImage(litecanvas, alpha = true) {
       const anchorX = this.sprite.width * this.anchor.x;
       const anchorY = this.sprite.height * this.anchor.y;
-      litecanvas.alpha(this.opacity);
+      if (alpha) litecanvas.alpha(this.opacity);
       litecanvas.image(-anchorX, -anchorY, this.sprite);
     }
   };
@@ -825,6 +865,166 @@
   // src/math/range.js
   var range_default = (size) => Array.from(Array(size).keys());
 
+  // src/math/advance.js
+  var advance_default = advance = (position, velocity, acceleration, deltaTime = 1) => {
+    if (acceleration) {
+      velocity.x += acceleration.x * deltaTime;
+      velocity.y += acceleration.y * deltaTime;
+    }
+    position.x += velocity.x * deltaTime;
+    position.y += velocity.y * deltaTime;
+  };
+
+  // src/tween/index.js
+  var HALF_PI = Math.PI / 2;
+  var tween = (object, prop, toValue, duration = 1, easing = LINEAR) => {
+    return new TweenController(object, prop, toValue, duration, easing);
+  };
+  var LINEAR = (n) => n;
+  var EASE_IN = (n) => n * n;
+  var EASE_OUT = (n) => -n * (n - 2);
+  var EASE_IN_OUT = (n) => {
+    if (n < 0.5) {
+      return 2 * n * n;
+    }
+    return -2 * n * n + 4 * n - 1;
+  };
+  var BACK_IN = (n) => n * n * n - n * Math.sin(n * Math.PI);
+  var BACK_OUT = (n) => {
+    let a = 1 - n;
+    return 1 - (a * a * a - a * Math.sin(a * Math.PI));
+  };
+  var BACK_IN_OUT = (n) => {
+    if (n < 0.5) {
+      let a2 = 2 * n;
+      return 0.5 * (a2 * a2 * a2 - a2 * Math.sin(a2 * Math.PI));
+    }
+    let a = 1 - (2 * n - 1);
+    return 0.5 * (1 - (a * a * a - a * Math.sin(n * Math.PI))) + 0.5;
+  };
+  var ELASTIC_IN = (n) => {
+    return Math.sin(13 * HALF_PI * n) * Math.pow(2, 10 * (n - 1));
+  };
+  var ELASTIC_OUT = (n) => {
+    return Math.sin(-13 * HALF_PI * (n + 1)) * Math.pow(2, -10 * n) + 1;
+  };
+  var ELASTIC_IN_OUT = (n) => {
+    if (n < 0.5) {
+      let a2 = Math.sin(13 * HALF_PI * (2 * n));
+      let b2 = Math.pow(2, 10 * (2 * n - 1));
+      return 0.5 * a2 * b2;
+    }
+    let a = Math.sin(-13 * HALF_PI * (2 * n - 1 + 1));
+    let b = Math.pow(2, -10 * (2 * n - 1));
+    return 0.5 * (a * b + 2);
+  };
+  var BOUNCE_IN = (n) => 1 - BOUNCE_OUT(1 - n);
+  var BOUNCE_OUT = (n) => {
+    if (n < 4 / 11) {
+      return 121 * n * n / 16;
+    } else if (n < 8 / 11) {
+      return 363 / 40 * n * n - 99 / 10 * n + 17 / 5;
+    } else if (n < 9 / 10) {
+      return 4356 / 361 * n * n - 35442 / 1805 * n + 16061 / 1805;
+    }
+    return 54 / 5 * n * n - 513 / 25 * n + 268 / 25;
+  };
+  var BOUNCE_IN_OUT = (n) => {
+    if (n < 0.5) {
+      return 0.5 * BOUNCE_IN(n * 2);
+    }
+    return 0.5 * BOUNCE_OUT(n * 2 - 1) + 0.5;
+  };
+  var TweenController = class {
+    /** @type {boolean} */
+    running = false;
+    /** @type {*} */
+    _o;
+    /** @type {string} */
+    _p;
+    /** @type {number} */
+    _x;
+    /** @type {number} */
+    _d;
+    /** @type {(x: number) => number} */
+    _e;
+    /** @type {Function[]} */
+    _cb = [];
+    /** @type {number} */
+    _t = 0;
+    /** @type {Function} */
+    _u = 0;
+    /** @type {LitecanvasInstance} */
+    _lc;
+    /**
+     * @param {*} object
+     * @param {string} prop
+     * @param {number} toValue
+     * @param {number} duration
+     * @param {(x: number) => number} easing
+     */
+    constructor(object, prop, toValue, duration, easing) {
+      this._o = object;
+      this._p = prop;
+      this._x = toValue;
+      this._d = duration;
+      this._e = easing;
+    }
+    /**
+     *
+     * @param {LitecanvasInstance} engine
+     */
+    start(engine = globalThis) {
+      if (!this.running) {
+        this.stop();
+      }
+      const fromValue = this._o[this._p] || 0;
+      this._lc = engine;
+      this._u = engine.listen("update", (dt) => {
+        this._o[this._p] = engine.lerp(
+          fromValue,
+          this._x,
+          this._e(this._t / this._d)
+        );
+        this._t += dt;
+        if (this._t >= this._d) {
+          this._o[this._p] = this._x;
+          this.stop();
+        }
+      });
+      this.running = true;
+      return this;
+    }
+    /**
+     * @param {Function} callback
+     */
+    onEnd(callback) {
+      this._cb.push(callback);
+    }
+    /**
+     * @param {boolean} completed if `false` don't call the `onEnd()` registered callbacks.
+     * @returns
+     */
+    stop(completed = true) {
+      if (!this.running || !this._u) return;
+      this.running = false;
+      this._u();
+      if (completed) {
+        for (const callback of this._cb) {
+          callback(this._o);
+        }
+      }
+    }
+    reset() {
+      this._cb.length = 0;
+      this.stop();
+    }
+    get progress() {
+      return this.running ? this._t / this._d : 0;
+    }
+  };
+
   // src/_web.js
   globalThis.utils = Object.assign(globalThis.utils || {}, src_exports);
 })();
+/*! @litecanvas/utils by Luiz Bills | MIT Licensed */

package/dist/all.min.js

@@ -1,2 +1,3 @@
-(()=>{var $=Object.defineProperty;var V=(e,t)=>{for(var s in t)$(e,s,{get:t[s],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let e in globalThis.utils)e!=="global"&&(globalThis[e]=globalThis.utils[e])};var P={};V(P,{ANCHOR_BOT_LEFT:()=>yt,ANCHOR_BOT_RIGHT:()=>mt,ANCHOR_CENTER:()=>gt,ANCHOR_TOP_LEFT:()=>B,ANCHOR_TOP_RIGHT:()=>_t,Actor:()=>D,Camera:()=>u,DOWN:()=>xt,Grid:()=>_,LEFT:()=>dt,ONE:()=>ft,RIGHT:()=>pt,TypedGrid:()=>H,UP:()=>ut,Vector:()=>p,ZERO:()=>L,diff:()=>F,fract:()=>j,intersection:()=>g,range:()=>N,resolve:()=>O,vec:()=>n,vecAbs:()=>ot,vecAdd:()=>b,vecAngle:()=>tt,vecCeil:()=>rt,vecClamp:()=>ht,vecCross:()=>et,vecDist:()=>Q,vecDist2:()=>v,vecDiv:()=>y,vecDot:()=>W,vecEq:()=>M,vecFloor:()=>nt,vecIsZero:()=>lt,vecLerp:()=>st,vecLimit:()=>K,vecMag:()=>z,vecMag2:()=>Y,vecMove:()=>ct,vecMult:()=>x,vecNorm:()=>A,vecRand:()=>it,vecReflect:()=>Z,vecRotate:()=>U,vecRound:()=>at,vecSet:()=>X,vecSetMag:()=>J,vecSub:()=>I,wave:()=>G});var g=(e,t,s,i,o,r,a,h)=>{let c=Math.max(e,o),C=Math.min(e+s,o+a)-c,d=Math.max(t,r),m=Math.min(t+i,r+h)-d;return[c,d,C,m]};var O=(e,t,s,i,o,r,a,h)=>{let[c,C,d,m]=g(e,t,s,i,o,r,a,h),f="",T=e,w=t;return d<m?e<o?(f="right",T=o-s):(f="left",T=o+a):t<r?(f="bottom",w=r-i):(f="top",w=r+h),{direction:f,x:T,y:w}};var u=class{_engine=null;x=0;y=0;ox=0;oy=0;width=0;height=0;rotation=0;scale=1;_shake={x:0,y:0,removeListener:null};constructor(t=null,s=0,i=0,o=null,r=null){this._engine=t||globalThis,this.ox=s,this.oy=i,this.resize(o||this._engine.WIDTH-s,r||this._engine.HEIGHT-i),this.x=this.width/2,this.y=this.height/2}resize(t,s){this.width=t,this.height=s,this._engine.emit("camera-resized",this)}start(t=!1){this._engine.push(),t&&this._engine.cliprect(this.ox,this.oy,this.width,this.height);let s=this.ox+this.width/2,i=this.oy+this.height/2;this._engine.translate(s,i),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,i={}){let o=Math.cos(-this.rotation),r=Math.sin(-this.rotation);return t=(t-this.width/2-this.ox)/this.scale,s=(s-this.height/2-this.oy)/this.scale,i.x=o*t-r*s+this.x,i.y=r*t+o*s+this.y,i}getCameraPoint(t,s,i={}){let o=Math.cos(-this.rotation),r=Math.sin(-this.rotation);return t=t-this.x,s=s-this.y,t=o*t-r*s,s=r*t+o*s,i.x=t*this.scale+this.width/2+this.ox,i.y=s*this.scale+this.height/2+this.oy,i}getBounds(){return[this.ox,this.oy,this.width,this.height]}viewing(t,s,i,o){let r=this.width/2-this.x,a=this.height/2-this.y,h=this.width/this.scale,c=this.height/this.scale;return this._engine.colrect(t,s,i,o,r,a,h,c)}shake(t=1,s=.3){this.shaking||(this._shake.removeListener=this._engine.listen("update",i=>{this._shake.x=this._engine.randi(-t,t),this._shake.y=this._engine.randi(-t,t),s-=i,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 _=class e{_w;_h;_c;constructor(t,s,i=[]){this._w=Math.max(1,~~t),this._h=Math.max(1,~~s),this._c=i}clear(){this.forEach((t,s)=>this.set(t,s,void 0))}get width(){return this._w}get height(){return this._h}set(t,s,i){this._c[this.pointToIndex(t,s)]=i}get(t,s){return this._c[this.pointToIndex(t,s)]}has(t,s){return this.get(t,s)!=null}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 i=s?this.length-1:0,o=s?-1:this.length,r=s?-1:1;for(;i!==o;){let a=this.indexToPointX(i),h=this.indexToPointY(i),c=this._c[i];if(t(a,h,c,this)===!1)break;i+=r}}fill(t){this.forEach((s,i)=>{this.set(s,i,t)})}clone(){return e.fromArray(this._w,this._h,this._c)}clampX(t){return k(t,0,this._w-1)}clampY(t){return k(t,0,this._h-1)}toArray(){return this._c.slice()}toString(t=" ",s=!0){if(!s)return this._c.join(t);let i=[];return this.forEach((o,r,a)=>{i[r]=i[r]||"",i[r]+=a+t}),i.join(`
-`)}},H=class e extends _{constructor(t,s,i=Uint8Array){super(t,s,null),this._c=new i(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,i,o)=>{t.set(s,i,o)}),t}};function k(e,t,s){return e<t?t:e>s?s:e}var E=Math.sqrt,R=Math.cos,S=Math.sin,q=2*Math.PI,p=class{x;y;constructor(t=0,s=t){this.x=t,this.y=s}toString(){return`Vector (${this.x}, ${this.y})`}},l=e=>e instanceof p,n=(e=0,t=e)=>(l(e)&&(t=e.y,e=e.x),new p(e,t)),M=(e,t,s=t)=>l(t)?M(e,t.x,t.y):e.x===t&&e.y===s,X=(e,t,s=t)=>(l(t)?X(e,t.x,t.y):(e.x=t,e.y=s),e),b=(e,t,s=t)=>l(t)?b(e,t.x,t.y):(e.x+=t,e.y+=s,e),I=(e,t,s=t)=>l(t)?I(e,t.x,t.y):(e.x-=t,e.y-=s,e),x=(e,t,s=t)=>l(t)?x(e,t.x,t.y):(e.x*=t,e.y*=s,e),y=(e,t,s=t)=>l(t)?y(e,t.x,t.y):(e.x/=t,e.y/=s,e),U=(e,t)=>{let s=R(t),i=S(t);return e.x=s*e.x-i*e.y,e.y=i*e.x+s*e.y,e},Z=(e,t)=>{let s=A(n(t));return I(e,x(s,2*W(e,s)))},J=(e,t)=>(A(e),x(e,t),e),z=e=>E(e.x*e.x+e.y*e.y),Y=e=>e.x*e.x+e.y*e.y,A=e=>{let t=z(e);return t>0&&y(e,t),e},K=(e,t=1)=>{let s=Y(e);return s>t*t&&(y(e,E(s)),x(e,t)),e},Q=(e,t)=>{let s=e.x-t.x,i=e.y-t.y;return E(s*s+i*i)},v=(e,t)=>{let s=e.x-t.x,i=e.y-t.y;return s*s+i*i},tt=e=>Math.atan2(e.y,e.x),W=(e,t)=>e.x*t.x+e.y*t.y,et=(e,t)=>e.x*t.y-e.y*t.x,st=(e,t,s)=>(e.x+=(t.x-e.x)*s||0,e.y+=(t.y-e.y)*s||0,e),it=(e=1,t=e,s=globalThis.rand||Math.random)=>{let i=s()*q,o=s()*(t-e)+e;return n(R(i)*o,S(i)*o)},ot=e=>(e.x=Math.abs(e.x),e.y=Math.abs(e.y),e),rt=e=>(e.x=Math.ceil(e.x),e.y=Math.ceil(e.y),e),nt=e=>(e.x=Math.floor(e.x),e.y=Math.floor(e.y),e),at=e=>(e.x=Math.round(e.x),e.y=Math.round(e.y),e),ht=(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),ct=(e,t,s=1)=>b(e,t.x*s,t.y*s),lt=e=>M(e,L),L=n(0,0),ft=n(1,1),ut=n(0,-1),pt=n(1,0),xt=n(0,1),dt=n(-1,0);var gt=n(.5,.5),B=n(0,0),_t=n(1,0),yt=n(0,1),mt=n(1,1),D=class{sprite;pos;_o;_s;angle=0;opacity=1;hidden=!1;constructor(t,s,i=B){this.sprite=t,this.pos=s||n(0),this._o=n(i),this._s=n(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}getBounds(t=!0){let s=this.sprite.width*(t?this._s.x:1),i=this.sprite.height*(t?this._s.y:1),o=this.pos.x-s*this.anchor.x,r=this.pos.y-i*this.anchor.y;return[o,r,s,i]}draw(t=globalThis){this.hidden||this.opacity<=0||(t.push(),this.transform(t),this.drawImage(t),t.pop())}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(this.angle),t.scale(this._s.x,this._s.y)}drawImage(t){let s=this.sprite.width*this.anchor.x,i=this.sprite.height*this.anchor.y;t.alpha(this.opacity),t.image(-s,-i,this.sprite)}};var F=(e,t)=>Math.abs(t-e)||0;var G=(e,t,s,i=Math.sin)=>e+(i(s)+1)/2*(t-e);var j=e=>e%1||0;var N=e=>Array.from(Array(e).keys());globalThis.utils=Object.assign(globalThis.utils||{},P);})();
+(()=>{var J=Object.defineProperty;var Q=(t,e)=>{for(var s in e)J(t,s,{get:e[s],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let t in globalThis.utils)t!=="global"&&(globalThis[t]=globalThis.utils[t])};var k={};Q(k,{ANCHOR_BOT_LEFT:()=>bt,ANCHOR_BOT_RIGHT:()=>At,ANCHOR_CENTER:()=>Mt,ANCHOR_TOP_LEFT:()=>G,ANCHOR_TOP_RIGHT:()=>It,Actor:()=>C,BACK_IN:()=>St,BACK_IN_OUT:()=>Pt,BACK_OUT:()=>kt,BOUNCE_IN:()=>Z,BOUNCE_IN_OUT:()=>Bt,BOUNCE_OUT:()=>S,Camera:()=>u,DOWN:()=>wt,EASE_IN:()=>Ot,EASE_IN_OUT:()=>Dt,EASE_OUT:()=>Ct,ELASTIC_IN:()=>Lt,ELASTIC_IN_OUT:()=>Xt,ELASTIC_OUT:()=>Rt,Grid:()=>g,LEFT:()=>Et,LINEAR:()=>K,ONE:()=>yt,RIGHT:()=>Tt,TypedGrid:()=>M,UP:()=>mt,Vector:()=>p,ZERO:()=>F,advance:()=>q,diff:()=>V,fract:()=>z,intersection:()=>d,range:()=>$,resolve:()=>L,tween:()=>Ht,vec:()=>n,vecAbs:()=>ft,vecAdd:()=>A,vecAngle:()=>nt,vecAngleBetween:()=>ht,vecCeil:()=>ut,vecClamp:()=>xt,vecCross:()=>at,vecDist:()=>rt,vecDist2:()=>ot,vecDiv:()=>y,vecDot:()=>N,vecEq:()=>b,vecFloor:()=>pt,vecIsZero:()=>gt,vecLerp:()=>ct,vecLimit:()=>it,vecMag:()=>U,vecMag2:()=>W,vecMove:()=>dt,vecMult:()=>_,vecNorm:()=>O,vecRand:()=>lt,vecReflect:()=>et,vecRotate:()=>tt,vecRound:()=>_t,vecSet:()=>Y,vecSetMag:()=>st,vecSub:()=>H,wave:()=>j});var d=(t,e,s,i,r,o,h,a)=>{let c=Math.max(t,r),P=Math.min(t+s,r+h)-c,x=Math.max(e,o),T=Math.min(e+i,o+a)-x;return[c,x,P,T]};var L=(t,e,s,i,r,o,h,a)=>{let[c,P,x,T]=d(t,e,s,i,r,o,h,a),f="",w=t,E=e;return x<T?t<r?(f="right",w=r-s):(f="left",w=r+h):e<o?(f="bottom",E=o-i):(f="top",E=o+a),{direction:f,x:w,y:E}};var u=class{_engine=null;x=0;y=0;ox=0;oy=0;width=0;height=0;rotation=0;scale=1;_shake={x:0,y:0,removeListener:null};constructor(e=null,s=0,i=0,r=null,o=null){this._engine=e||globalThis,this.ox=s,this.oy=i,this.resize(r||this._engine.WIDTH-s,o||this._engine.HEIGHT-i),this.x=this.width/2,this.y=this.height/2}resize(e,s){this.width=e,this.height=s,this._engine.emit("camera-resized",this)}start(e=!1){this._engine.push(),e&&this._engine.cliprect(this.ox,this.oy,this.width,this.height);let s=this.ox+this.width/2,i=this.oy+this.height/2;this._engine.translate(s,i),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(e,s){this.x=e,this.y=s}move(e,s){this.x+=e,this.y+=s}zoom(e){this.scale*=e}zoomTo(e){this.scale=e}rotate(e){this.rotation+=e}rotateTo(e){this.rotation=e}getWorldPoint(e,s,i={}){let r=Math.cos(-this.rotation),o=Math.sin(-this.rotation);return e=(e-this.width/2-this.ox)/this.scale,s=(s-this.height/2-this.oy)/this.scale,i.x=r*e-o*s+this.x,i.y=o*e+r*s+this.y,i}getCameraPoint(e,s,i={}){let r=Math.cos(-this.rotation),o=Math.sin(-this.rotation);return e=e-this.x,s=s-this.y,e=r*e-o*s,s=o*e+r*s,i.x=e*this.scale+this.width/2+this.ox,i.y=s*this.scale+this.height/2+this.oy,i}getBounds(){return[this.ox,this.oy,this.width,this.height]}viewing(e,s,i,r){let o=this.width/2-this.x,h=this.height/2-this.y,a=this.width/this.scale,c=this.height/this.scale;return this._engine.colrect(e,s,i,r,o,h,a,c)}shake(e=1,s=.3){this.shaking||(this._shake.removeListener=this._engine.listen("update",i=>{this._shake.x=this._engine.randi(-e,e),this._shake.y=this._engine.randi(-e,e),s-=i,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 g=class t{_w;_h;_c;constructor(e,s,i=[]){this._w=Math.max(1,~~e),this._h=Math.max(1,~~s),this._c=i}clear(){this.forEach((e,s)=>this.set(e,s,void 0))}get width(){return this._w}get height(){return this._h}set(e,s,i){this._c[this.pointToIndex(e,s)]=i}get(e,s){return this._c[this.pointToIndex(e,s)]}has(e,s){return this.get(e,s)!=null}get length(){return this._w*this._h}pointToIndex(e,s){return this.clampX(~~e)+this.clampY(~~s)*this._w}indexToPointX(e){return e%this._w}indexToPointY(e){return Math.floor(e/this._w)}forEach(e,s=!1){let i=s?this.length-1:0,r=s?-1:this.length,o=s?-1:1;for(;i!==r;){let h=this.indexToPointX(i),a=this.indexToPointY(i),c=this._c[i];if(e(h,a,c,this)===!1)break;i+=o}}fill(e){this.forEach((s,i)=>{this.set(s,i,e)})}clone(){return t.fromArray(this._w,this._h,this._c)}clampX(e){return R(e,0,this._w-1)}clampY(e){return R(e,0,this._h-1)}toArray(){return this._c.slice()}toString(e=" ",s=!0){if(!s)return this._c.join(e);let i=[];return this.forEach((r,o,h)=>{i[o]=i[o]||"",i[o]+=h+e}),i.join(`
+`)}},M=class t extends g{constructor(e,s,i=Uint8Array){super(e,s,null),this._c=new i(this._w*this._h)}has(e,s){return this.get(e,s)!==0}clone(){let e=new t(this._w,this._h,this._c.constructor);return this.forEach((s,i,r)=>{e.set(s,i,r)}),e}};function R(t,e,s){return t<e?e:t>s?s:t}var I=Math.sqrt,X=Math.cos,B=Math.sin,v=2*Math.PI,p=class{x;y;constructor(e=0,s=e){this.x=e,this.y=s}toString(){return`Vector (${this.x}, ${this.y})`}},l=t=>t instanceof p,n=(t=0,e=t)=>(l(t)&&(e=t.y,t=t.x),new p(t,e)),b=(t,e,s=e)=>l(e)?b(t,e.x,e.y):t.x===e&&t.y===s,Y=(t,e,s=e)=>(l(e)?Y(t,e.x,e.y):(t.x=e,t.y=s),t),A=(t,e,s=e)=>l(e)?A(t,e.x,e.y):(t.x+=e,t.y+=s,t),H=(t,e,s=e)=>l(e)?H(t,e.x,e.y):(t.x-=e,t.y-=s,t),_=(t,e,s=e)=>l(e)?_(t,e.x,e.y):(t.x*=e,t.y*=s,t),y=(t,e,s=e)=>l(e)?y(t,e.x,e.y):(t.x/=e||1,t.y/=s||1,t),tt=(t,e)=>{let s=X(e),i=B(e);return t.x=s*t.x-i*t.y,t.y=i*t.x+s*t.y,t},et=(t,e)=>{let s=O(n(e));return H(t,_(s,2*N(t,s)))},st=(t,e)=>(O(t),_(t,e),t),U=t=>I(t.x*t.x+t.y*t.y),W=t=>t.x*t.x+t.y*t.y,O=t=>{let e=U(t);return e>0&&y(t,e),t},it=(t,e=1)=>{let s=W(t);return s>e*e&&(y(t,I(s)),_(t,e)),t},rt=(t,e)=>{let s=t.x-e.x,i=t.y-e.y;return I(s*s+i*i)},ot=(t,e)=>{let s=t.x-e.x,i=t.y-e.y;return s*s+i*i},nt=t=>Math.atan2(t.y,t.x),ht=(t,e)=>Math.atan2(e.y-t.y,e.x-t.x),N=(t,e)=>t.x*e.x+t.y*e.y,at=(t,e)=>t.x*e.y-t.y*e.x,ct=(t,e,s)=>(t.x+=(e.x-t.x)*s||0,t.y+=(e.y-t.y)*s||0,t),lt=(t=1,e=t,s=globalThis.rand||Math.random)=>{let i=s()*v,r=s()*(e-t)+t;return n(X(i)*r,B(i)*r)},ft=t=>(t.x=Math.abs(t.x),t.y=Math.abs(t.y),t),ut=t=>(t.x=Math.ceil(t.x),t.y=Math.ceil(t.y),t),pt=t=>(t.x=Math.floor(t.x),t.y=Math.floor(t.y),t),_t=t=>(t.x=Math.round(t.x),t.y=Math.round(t.y),t),xt=(t,e,s)=>(t.x<e.x&&(t.x=e.x),t.x>s.x&&(t.x=s.x),t.y<e.y&&(t.y=e.y),t.y>s.y&&(t.y=s.y),t),dt=(t,e,s=1)=>A(t,e.x*s,e.y*s),gt=t=>b(t,F),F=n(0,0),yt=n(1,1),mt=n(0,-1),Tt=n(1,0),wt=n(0,1),Et=n(-1,0);globalThis.zzfxV=1;var Mt=n(.5,.5),G=n(0,0),It=n(1,0),bt=n(0,1),At=n(1,1),C=class{sprite;pos;_o;_s;angle=0;opacity=1;hidden=!1;constructor(e,s,i=G){this.sprite=e,this.pos=s||n(0),this._o=n(i),this._s=n(1,1)}set x(e){this.pos.x=e}get x(){return this.pos.x}set y(e){this.pos.y=e}get y(){return this.pos.y}set anchor(e){this._o.x=e.x,this._o.y=e.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(e,s=e){this._s.x=e,this._s.y=s}scaleBy(e,s=e){this._s.x*=e,this._s.y*=s}getBounds(e=!0){let s=this.sprite.width*(e?this._s.x:1),i=this.sprite.height*(e?this._s.y:1),r=this.pos.x-s*this.anchor.x,o=this.pos.y-i*this.anchor.y;return[r,o,s,i]}draw(e=globalThis,s=!0){this.hidden||this.opacity<=0||(s&&e.push(),this.transform(e),this.drawImage(e),s&&e.pop())}transform(e){e.translate(this.pos.x,this.pos.y),e.rotate(this.angle),e.scale(this._s.x,this._s.y)}drawImage(e,s=!0){let i=this.sprite.width*this.anchor.x,r=this.sprite.height*this.anchor.y;s&&e.alpha(this.opacity),e.image(-i,-r,this.sprite)}};var V=(t,e)=>Math.abs(e-t)||0;var j=(t,e,s,i=Math.sin)=>t+(i(s)+1)/2*(e-t);var z=t=>t%1||0;var $=t=>Array.from(Array(t).keys());var q=advance=(t,e,s,i=1)=>{s&&(e.x+=s.x*i,e.y+=s.y*i),t.x+=e.x*i,t.y+=e.y*i};var m=Math.PI/2,Ht=(t,e,s,i=1,r=K)=>new D(t,e,s,i,r),K=t=>t,Ot=t=>t*t,Ct=t=>-t*(t-2),Dt=t=>t<.5?2*t*t:-2*t*t+4*t-1,St=t=>t*t*t-t*Math.sin(t*Math.PI),kt=t=>{let e=1-t;return 1-(e*e*e-e*Math.sin(e*Math.PI))},Pt=t=>{if(t<.5){let s=2*t;return .5*(s*s*s-s*Math.sin(s*Math.PI))}let e=1-(2*t-1);return .5*(1-(e*e*e-e*Math.sin(t*Math.PI)))+.5},Lt=t=>Math.sin(13*m*t)*Math.pow(2,10*(t-1)),Rt=t=>Math.sin(-13*m*(t+1))*Math.pow(2,-10*t)+1,Xt=t=>{if(t<.5){let i=Math.sin(13*m*(2*t)),r=Math.pow(2,10*(2*t-1));return .5*i*r}let e=Math.sin(-13*m*(2*t-1+1)),s=Math.pow(2,-10*(2*t-1));return .5*(e*s+2)},Z=t=>1-S(1-t),S=t=>t<4/11?121*t*t/16:t<8/11?363/40*t*t-99/10*t+17/5:t<9/10?4356/361*t*t-35442/1805*t+16061/1805:54/5*t*t-513/25*t+268/25,Bt=t=>t<.5?.5*Z(t*2):.5*S(t*2-1)+.5,D=class{running=!1;_o;_p;_x;_d;_e;_cb=[];_t=0;_u=0;_lc;constructor(e,s,i,r,o){this._o=e,this._p=s,this._x=i,this._d=r,this._e=o}start(e=globalThis){this.running||this.stop();let s=this._o[this._p]||0;return this._lc=e,this._u=e.listen("update",i=>{this._o[this._p]=e.lerp(s,this._x,this._e(this._t/this._d)),this._t+=i,this._t>=this._d&&(this._o[this._p]=this._x,this.stop())}),this.running=!0,this}onEnd(e){this._cb.push(e)}stop(e=!0){if(!(!this.running||!this._u)&&(this.running=!1,this._u(),e))for(let s of this._cb)s(this._o)}reset(){this._cb.length=0,this.stop()}get progress(){return this.running?this._t/this._d:0}};globalThis.utils=Object.assign(globalThis.utils||{},k);})();
+/*! @litecanvas/utils by Luiz Bills | MIT Licensed */

package/dist/math.js

@@ -17,6 +17,7 @@
   // src/math/index.js
   var math_exports = {};
   __export(math_exports, {
+    advance: () => advance_default,
     diff: () => diff_default,
     fract: () => fract_default,
     range: () => range_default,
@@ -35,6 +36,19 @@
   // src/math/range.js
   var range_default = (size) => Array.from(Array(size).keys());
 
+  // src/vector/index.js
+  var PI2 = 2 * Math.PI;
+
+  // src/math/advance.js
+  var advance_default = advance = (position, velocity, acceleration, deltaTime = 1) => {
+    if (acceleration) {
+      velocity.x += acceleration.x * deltaTime;
+      velocity.y += acceleration.y * deltaTime;
+    }
+    position.x += velocity.x * deltaTime;
+    position.y += velocity.y * deltaTime;
+  };
+
   // src/math/_web.js
   globalThis.utils = Object.assign(globalThis.utils || {}, math_exports);
 })();

package/dist/math.min.js

@@ -1 +1 @@
-(()=>{var u=Object.defineProperty;var b=(l,a)=>{for(var t in a)u(l,t,{get:a[t],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let l in globalThis.utils)l!=="global"&&(globalThis[l]=globalThis.utils[l])};var o={};b(o,{diff:()=>s,fract:()=>r,range:()=>e,wave:()=>i});var s=(l,a)=>Math.abs(a-l)||0;var i=(l,a,t,f=Math.sin)=>l+(f(t)+1)/2*(a-l);var r=l=>l%1||0;var e=l=>Array.from(Array(l).keys());globalThis.utils=Object.assign(globalThis.utils||{},o);})();
+(()=>{var a=Object.defineProperty;var p=(t,o)=>{for(var r in o)a(t,r,{get:o[r],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let t in globalThis.utils)t!=="global"&&(globalThis[t]=globalThis.utils[t])};var s={};p(s,{advance:()=>u,diff:()=>n,fract:()=>x,range:()=>y,wave:()=>c});var n=(t,o)=>Math.abs(o-t)||0;var c=(t,o,r,e=Math.sin)=>t+(e(r)+1)/2*(o-t);var x=t=>t%1||0;var y=t=>Array.from(Array(t).keys());var d=2*Math.PI;var u=advance=(t,o,r,e=1)=>{r&&(o.x+=r.x*e,o.y+=r.y*e),t.x+=o.x*e,t.y+=o.y*e};globalThis.utils=Object.assign(globalThis.utils||{},s);})();

package/dist/tween.js

@@ -0,0 +1,190 @@
+(() => {
+  var __defProp = Object.defineProperty;
+  var __export = (target, all) => {
+    for (var name in all)
+      __defProp(target, name, { get: all[name], enumerable: true });
+  };
+
+  // src/_global.js
+  globalThis.utils = globalThis.utils || {};
+  globalThis.utils.global = () => {
+    for (const key in globalThis.utils) {
+      if ("global" === key) continue;
+      globalThis[key] = globalThis.utils[key];
+    }
+  };
+
+  // src/tween/index.js
+  var tween_exports = {};
+  __export(tween_exports, {
+    BACK_IN: () => BACK_IN,
+    BACK_IN_OUT: () => BACK_IN_OUT,
+    BACK_OUT: () => BACK_OUT,
+    BOUNCE_IN: () => BOUNCE_IN,
+    BOUNCE_IN_OUT: () => BOUNCE_IN_OUT,
+    BOUNCE_OUT: () => BOUNCE_OUT,
+    EASE_IN: () => EASE_IN,
+    EASE_IN_OUT: () => EASE_IN_OUT,
+    EASE_OUT: () => EASE_OUT,
+    ELASTIC_IN: () => ELASTIC_IN,
+    ELASTIC_IN_OUT: () => ELASTIC_IN_OUT,
+    ELASTIC_OUT: () => ELASTIC_OUT,
+    LINEAR: () => LINEAR,
+    tween: () => tween
+  });
+
+  // node_modules/litecanvas/src/zzfx.js
+  globalThis.zzfxV = 1;
+
+  // src/tween/index.js
+  var HALF_PI = Math.PI / 2;
+  var tween = (object, prop, toValue, duration = 1, easing = LINEAR) => {
+    return new TweenController(object, prop, toValue, duration, easing);
+  };
+  var LINEAR = (n) => n;
+  var EASE_IN = (n) => n * n;
+  var EASE_OUT = (n) => -n * (n - 2);
+  var EASE_IN_OUT = (n) => {
+    if (n < 0.5) {
+      return 2 * n * n;
+    }
+    return -2 * n * n + 4 * n - 1;
+  };
+  var BACK_IN = (n) => n * n * n - n * Math.sin(n * Math.PI);
+  var BACK_OUT = (n) => {
+    let a = 1 - n;
+    return 1 - (a * a * a - a * Math.sin(a * Math.PI));
+  };
+  var BACK_IN_OUT = (n) => {
+    if (n < 0.5) {
+      let a2 = 2 * n;
+      return 0.5 * (a2 * a2 * a2 - a2 * Math.sin(a2 * Math.PI));
+    }
+    let a = 1 - (2 * n - 1);
+    return 0.5 * (1 - (a * a * a - a * Math.sin(n * Math.PI))) + 0.5;
+  };
+  var ELASTIC_IN = (n) => {
+    return Math.sin(13 * HALF_PI * n) * Math.pow(2, 10 * (n - 1));
+  };
+  var ELASTIC_OUT = (n) => {
+    return Math.sin(-13 * HALF_PI * (n + 1)) * Math.pow(2, -10 * n) + 1;
+  };
+  var ELASTIC_IN_OUT = (n) => {
+    if (n < 0.5) {
+      let a2 = Math.sin(13 * HALF_PI * (2 * n));
+      let b2 = Math.pow(2, 10 * (2 * n - 1));
+      return 0.5 * a2 * b2;
+    }
+    let a = Math.sin(-13 * HALF_PI * (2 * n - 1 + 1));
+    let b = Math.pow(2, -10 * (2 * n - 1));
+    return 0.5 * (a * b + 2);
+  };
+  var BOUNCE_IN = (n) => 1 - BOUNCE_OUT(1 - n);
+  var BOUNCE_OUT = (n) => {
+    if (n < 4 / 11) {
+      return 121 * n * n / 16;
+    } else if (n < 8 / 11) {
+      return 363 / 40 * n * n - 99 / 10 * n + 17 / 5;
+    } else if (n < 9 / 10) {
+      return 4356 / 361 * n * n - 35442 / 1805 * n + 16061 / 1805;
+    }
+    return 54 / 5 * n * n - 513 / 25 * n + 268 / 25;
+  };
+  var BOUNCE_IN_OUT = (n) => {
+    if (n < 0.5) {
+      return 0.5 * BOUNCE_IN(n * 2);
+    }
+    return 0.5 * BOUNCE_OUT(n * 2 - 1) + 0.5;
+  };
+  var TweenController = class {
+    /** @type {boolean} */
+    running = false;
+    /** @type {*} */
+    _o;
+    /** @type {string} */
+    _p;
+    /** @type {number} */
+    _x;
+    /** @type {number} */
+    _d;
+    /** @type {(x: number) => number} */
+    _e;
+    /** @type {Function[]} */
+    _cb = [];
+    /** @type {number} */
+    _t = 0;
+    /** @type {Function} */
+    _u = 0;
+    /** @type {LitecanvasInstance} */
+    _lc;
+    /**
+     * @param {*} object
+     * @param {string} prop
+     * @param {number} toValue
+     * @param {number} duration
+     * @param {(x: number) => number} easing
+     */
+    constructor(object, prop, toValue, duration, easing) {
+      this._o = object;
+      this._p = prop;
+      this._x = toValue;
+      this._d = duration;
+      this._e = easing;
+    }
+    /**
+     *
+     * @param {LitecanvasInstance} engine
+     */
+    start(engine = globalThis) {
+      if (!this.running) {
+        this.stop();
+      }
+      const fromValue = this._o[this._p] || 0;
+      this._lc = engine;
+      this._u = engine.listen("update", (dt) => {
+        this._o[this._p] = engine.lerp(
+          fromValue,
+          this._x,
+          this._e(this._t / this._d)
+        );
+        this._t += dt;
+        if (this._t >= this._d) {
+          this._o[this._p] = this._x;
+          this.stop();
+        }
+      });
+      this.running = true;
+      return this;
+    }
+    /**
+     * @param {Function} callback
+     */
+    onEnd(callback) {
+      this._cb.push(callback);
+    }
+    /**
+     * @param {boolean} completed if `false` don't call the `onEnd()` registered callbacks.
+     * @returns
+     */
+    stop(completed = true) {
+      if (!this.running || !this._u) return;
+      this.running = false;
+      this._u();
+      if (completed) {
+        for (const callback of this._cb) {
+          callback(this._o);
+        }
+      }
+    }
+    reset() {
+      this._cb.length = 0;
+      this.stop();
+    }
+    get progress() {
+      return this.running ? this._t / this._d : 0;
+    }
+  };
+
+  // src/tween/_web.js
+  globalThis.utils = Object.assign(globalThis.utils || {}, tween_exports);
+})();

package/dist/tween.min.js

@@ -0,0 +1 @@
+(()=>{var p=Object.defineProperty;var h=(t,e)=>{for(var o in e)p(t,o,{get:e[o],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let t in globalThis.utils)t!=="global"&&(globalThis[t]=globalThis.utils[t])};var l={};h(l,{BACK_IN:()=>x,BACK_IN_OUT:()=>m,BACK_OUT:()=>E,BOUNCE_IN:()=>f,BOUNCE_IN_OUT:()=>w,BOUNCE_OUT:()=>n,EASE_IN:()=>_,EASE_IN_OUT:()=>T,EASE_OUT:()=>g,ELASTIC_IN:()=>I,ELASTIC_IN_OUT:()=>y,ELASTIC_OUT:()=>b,LINEAR:()=>c,tween:()=>d});globalThis.zzfxV=1;var r=Math.PI/2,d=(t,e,o,s=1,i=c)=>new a(t,e,o,s,i),c=t=>t,_=t=>t*t,g=t=>-t*(t-2),T=t=>t<.5?2*t*t:-2*t*t+4*t-1,x=t=>t*t*t-t*Math.sin(t*Math.PI),E=t=>{let e=1-t;return 1-(e*e*e-e*Math.sin(e*Math.PI))},m=t=>{if(t<.5){let o=2*t;return .5*(o*o*o-o*Math.sin(o*Math.PI))}let e=1-(2*t-1);return .5*(1-(e*e*e-e*Math.sin(t*Math.PI)))+.5},I=t=>Math.sin(13*r*t)*Math.pow(2,10*(t-1)),b=t=>Math.sin(-13*r*(t+1))*Math.pow(2,-10*t)+1,y=t=>{if(t<.5){let s=Math.sin(13*r*(2*t)),i=Math.pow(2,10*(2*t-1));return .5*s*i}let e=Math.sin(-13*r*(2*t-1+1)),o=Math.pow(2,-10*(2*t-1));return .5*(e*o+2)},f=t=>1-n(1-t),n=t=>t<4/11?121*t*t/16:t<8/11?363/40*t*t-99/10*t+17/5:t<9/10?4356/361*t*t-35442/1805*t+16061/1805:54/5*t*t-513/25*t+268/25,w=t=>t<.5?.5*f(t*2):.5*n(t*2-1)+.5,a=class{running=!1;_o;_p;_x;_d;_e;_cb=[];_t=0;_u=0;_lc;constructor(e,o,s,i,u){this._o=e,this._p=o,this._x=s,this._d=i,this._e=u}start(e=globalThis){this.running||this.stop();let o=this._o[this._p]||0;return this._lc=e,this._u=e.listen("update",s=>{this._o[this._p]=e.lerp(o,this._x,this._e(this._t/this._d)),this._t+=s,this._t>=this._d&&(this._o[this._p]=this._x,this.stop())}),this.running=!0,this}onEnd(e){this._cb.push(e)}stop(e=!0){if(!(!this.running||!this._u)&&(this.running=!1,this._u(),e))for(let o of this._cb)o(this._o)}reset(){this._cb.length=0,this.stop()}get progress(){return this.running?this._t/this._d:0}};globalThis.utils=Object.assign(globalThis.utils||{},l);})();

package/dist/vector.js

@@ -19,6 +19,7 @@
     vecAbs: () => vecAbs,
     vecAdd: () => vecAdd,
     vecAngle: () => vecAngle,
+    vecAngleBetween: () => vecAngleBetween,
     vecCeil: () => vecCeil,
     vecClamp: () => vecClamp,
     vecCross: () => vecCross,
@@ -119,8 +120,8 @@
     if (isVector(x)) {
       return vecDiv(v, x.x, x.y);
     }
-    v.x /= x;
-    v.y /= y;
+    v.x /= x || 1;
+    v.y /= y || 1;
     return v;
   };
   var vecRotate = (v, radians) => {
@@ -166,6 +167,7 @@
     return dx * dx + dy * dy;
   };
   var vecAngle = (v) => Math.atan2(v.y, v.x);
+  var vecAngleBetween = (v1, v2) => Math.atan2(v2.y - v1.y, v2.x - v1.x);
   var vecDot = (a, b) => a.x * b.x + a.y * b.y;
   var vecCross = (a, b) => a.x * b.y - a.y * b.x;
   var vecLerp = (a, b, t) => {

package/dist/vector.min.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litecanvas/utils",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Utilities to help build litecanvas games",
   "author": "Luiz Bills <luizbills@pm.me>",
   "license": "MIT",

package/src/_web.js

@@ -1,3 +1,4 @@
+/*! @litecanvas/utils by Luiz Bills | MIT Licensed */
 import "./_global.js"
 import * as utils from "./index.js"
 

package/src/actor/index.js

@@ -1,11 +1,11 @@
 import { Vector, vec } from "../vector/index.js"
 import "litecanvas"
 
-export const ANCHOR_CENTER = vec(0.5, 0.5)
-export const ANCHOR_TOP_LEFT = vec(0, 0)
-export const ANCHOR_TOP_RIGHT = vec(1, 0)
-export const ANCHOR_BOT_LEFT = vec(0, 1)
-export const ANCHOR_BOT_RIGHT = vec(1, 1)
+export const ANCHOR_CENTER = /** @__PURE__ */ vec(0.5, 0.5)
+export const ANCHOR_TOP_LEFT = /** @__PURE__ */ vec(0, 0)
+export const ANCHOR_TOP_RIGHT = /** @__PURE__ */ vec(1, 0)
+export const ANCHOR_BOT_LEFT = /** @__PURE__ */ vec(0, 1)
+export const ANCHOR_BOT_RIGHT = /** @__PURE__ */ vec(1, 1)
 
 export class Actor {
   /** @type {Image|HTMLCanvasElement|OffscreenCanvas} */
@@ -105,6 +105,28 @@ export class Actor {
     return this._s
   }
 
+  /**
+   * Sets the actor scale
+   *
+   * @param {number} x
+   * @param {number} [y]
+   */
+  scaleTo(x, y = x) {
+    this._s.x = x
+    this._s.y = y
+  }
+
+  /**
+   * Multiplies the actor scale
+   *
+   * @param {number} x
+   * @param {number} [y]
+   */
+  scaleBy(x, y = x) {
+    this._s.x *= x
+    this._s.y *= y
+  }
+
   /**
    * @returns {number[]}
    */
@@ -117,19 +139,19 @@ export class Actor {
   }
 
   /**
-   * Update the transformation matrix, sets the opacity and draw the actor sprite image.
+   * Draw the actor
    *
    * @param {LitecanvasInstance} [litecanvas]
    */
-  draw(litecanvas = globalThis) {
+  draw(litecanvas = globalThis, saveContext = true) {
     if (this.hidden || this.opacity <= 0) return
 
-    litecanvas.push()
+    if (saveContext) litecanvas.push()
 
     this.transform(litecanvas)
     this.drawImage(litecanvas)
 
-    litecanvas.pop()
+    if (saveContext) litecanvas.pop()
   }
 
   /**
@@ -144,10 +166,12 @@ export class Actor {
   /**
    * @param {LitecanvasInstance} litecanvas
    */
-  drawImage(litecanvas) {
+  drawImage(litecanvas, alpha = true) {
     const anchorX = this.sprite.width * this.anchor.x
     const anchorY = this.sprite.height * this.anchor.y
-    litecanvas.alpha(this.opacity)
+
+    if (alpha) litecanvas.alpha(this.opacity)
+
     litecanvas.image(-anchorX, -anchorY, this.sprite)
   }
 }

package/src/index.js

@@ -5,3 +5,4 @@ export * from "./grid/index.js"
 export * from "./vector/index.js"
 export * from "./actor/index.js"
 export * from "./math/index.js"
+export * from "./tween/index.js"

package/src/math/advance.js

@@ -0,0 +1,20 @@
+import { Vector, vecMult, vecAdd } from "../vector"
+
+/**
+ * Move a vector (position) using another vectors: velocity and acceleration (optional).
+ * Note: This function changes the position and velocity vectors.
+ *
+ * @param {Vector} position
+ * @param {Vector} velocity
+ * @param {Vector?} acceleration
+ * @param {number?} deltaTime
+ */
+export default advance = (position, velocity, acceleration, deltaTime = 1) => {
+  if (acceleration) {
+    velocity.x += acceleration.x * deltaTime
+    velocity.y += acceleration.y * deltaTime
+  }
+
+  position.x += velocity.x * deltaTime
+  position.y += velocity.y * deltaTime
+}

package/src/math/index.js

@@ -2,3 +2,4 @@ export { default as diff } from "./diff.js"
 export { default as wave } from "./wave.js"
 export { default as fract } from "./fract.js"
 export { default as range } from "./range.js"
+export { default as advance } from "./advance.js"

package/src/tween/README.md

@@ -0,0 +1,175 @@
+# Tween
+
+You can animate object property using the `tween().`
+
+**CDN**: https://unpkg.com/@litecanvas/utils/dist/tween.js
+
+## tween
+
+Animate a object property over time.
+
+Syntax:
+
+```ts
+tween(
+    object: any,
+    prop: string,
+    toValue: number,
+    duration?: number, // default: 1
+    easing?: (n: number) => number // default: LINEAR (see below)
+): TweenController
+```
+
+```js
+// basic example
+// move the rect position x from 100 to 250 over 2 seconds
+import litecanvas from "litecanvas"
+import { tween } from "@litecanvas/utils"
+
+let object
+
+litecanvas()
+
+function init() {
+  pos = {
+    x: 100,
+    y: CENTERY,
+  }
+
+  // create the animation
+  const animation = tween(pos, "x", 250, 2)
+
+  // start the animation
+  animation.start()
+
+  // or just
+  // tween(...).start()
+}
+
+function draw() {
+  cls(0)
+  // draw the animated rect
+  rectfill(pos.x, pos.y, 50, 50, 3)
+}
+```
+
+## TweenController
+
+### TweenController#start()
+
+Starts the animation
+
+Syntax: `.start(engine?: LitecanvasInstance): TweenController`
+
+```js
+// if your litecanvas has config.global = false
+// you need to pass the engine instance to all animations
+const engine = litecanvas({
+    global: false
+})
+
+function init () {
+    engine.tween(...).start(engine)
+}
+```
+
+```js
+// otherwhise, just call `start()` without arguments
+const engine = litecanvas({
+  // global: true // default value
+})
+
+function init () {
+    // just call start
+    engine.tween(...).start()
+}
+```
+
+### TweenController#onEnd()
+
+Enqueues a callback to be executed when the animation finishes.
+
+Syntax: `.onEnd(callback?: (object:any) => void): void`
+
+```js
+// lets imagine a animation
+let anim = tween(...)
+
+// print in console when that tween finishes
+anim.onEnd(() => {
+    console.log('FINISHED')
+})
+```
+
+### TweenController#stop()
+
+Stops the animation.
+
+Syntax: `.stop(complete?: boolean): void`
+
+```js
+// lets imagine a animation with 5 seconds of duration
+let anim = tween(...)
+
+// call `stop()` to interrumpt that animation
+// and call all "onEnd" callbacks
+anim.stop()
+
+// or
+// call `stop()` to interrumpt that animation
+// and NOT call the "onEnd" callbacks
+anim.stop(false)
+```
+
+### TweenController#reset()
+
+Stops the animation and remove all `.onEnd()` registered callbacks.
+
+### TweenController#progress
+
+Returns the percentage of the animation's progress, a number between `0.0` and `1.0`. Where `0` represents 0% and `1` represents 100%.
+
+### Easing Functions
+
+We provide few easing functions:
+
+- `LINEAR` (the default)
+- `BOUNCE_IN`
+- `BOUNCE_OUT`
+- `BOUNCE_IN_OUT`
+- `EASE_IN`
+- `EASE_OUT`
+- `EASE_IN_OUT`
+- `ELASTIC_IN`
+- `ELASTIC_OUT`
+- `ELASTIC_IN_OUT`
+- `BACK_IN`
+- `BACK_OUT`
+- `BACK_IN_OUT`
+
+You should use the `tween()`'s fifth argument to choose a easing function.
+
+```js
+import litecanvas from "litecanvas"
+import { tween, BOUNCE_OUT } from "@litecanvas/utils"
+
+let object
+
+litecanvas()
+
+function init() {
+  pos = {
+    x: 100,
+    y: CENTERY,
+  }
+
+  tween(pos, "x", 250, 2, BOUNCE_OUT).start()
+}
+
+function draw() {
+  cls(0)
+  rectfill(pos.x, pos.y, 50, 50, 3)
+}
+```
+
+[See all Easing Functions in action](https://litecanvas.js.org?c=eJylVN9v2jAQfs9fceuTs2YpbN0LEpMYYwOtAmml2sM0TSY5wJvroNhpQVP%2F951jOxCg28Mkgu63v7vv7MoIqdOVLBZcsjiKskJpA8i1UCsNffgdAdxMpqPBl4Sk0eB29GMybcTZ3fzA3Kg3g9v5ZBgCvXbiDJb3s7vpMJT1yrGrMQyGn0OkFdtmpz61mpjye6Q%2BZoufmJn0F%2B40893FrbiPlcqMKNQ%2B9oHLCg%2BiJYbYYVWWqAyFdpqJkSKFwYyrB66ZHdujyM26B286HQuRV6bQGZfYgyWXGgknjXsZThVKGBbX4y7q4%2F3sKVGJe25jeqAqKZPauO1Bx0k7Lz1F9KcNL23mA2as2%2BnEZEKVe8PXyYf5GF4BORIYjyafxnOnxTY1r0ru%2B%2B%2FC1RVka65WCGYtNE10D7Ta5Nwgy40DK5bAHOC0ARpDiaYqVdQ0k26pbA0u3e6NTQI5zSOiYnVHzuu6u9heOIHaSLdODEi9o8XetxZB3ykiTutzGcbRmZPTQo1Uzmjy%2FXd%2B3mfA2bnbER%2BW2DUd7cj4HPzdAfzdf8I%2FZCEv%2BSPbM%2FDibxRkUrN6FaRQWC8lu647IZZtHeIY%2FeZwWharEVybKMqMedaS0GxCC53A2zj4HTG%2BweA7Ku5gYe5n41OXQsqwO1QhzDWB1ydFOGzKYlWi1rDgJX3aFlNgS5WUVZeiLPq5LX95ynSokMD1OYzKvhPFEjJ%2Ftx0TECZuOcatsYd06du%2FLUeUtWkyfLPB3BPVCry89NQdvSj9%2FtFKpBLVyqxjv52nD5C9%2Bs%2Fdw%2FMbTStVbFj8r22Pnv4AeWDaqw%3D%3D)

package/src/tween/_web.js

@@ -0,0 +1,4 @@
+import "../_global.js"
+import * as tweenUtils from "./index.js"
+
+globalThis.utils = Object.assign(globalThis.utils || {}, tweenUtils)

package/src/tween/index.js

@@ -0,0 +1,170 @@
+import "litecanvas"
+
+const HALF_PI = Math.PI / 2
+
+export const tween = (object, prop, toValue, duration = 1, easing = LINEAR) => {
+  return new TweenController(object, prop, toValue, duration, easing)
+}
+
+export const LINEAR = (n) => n
+
+export const EASE_IN = (n) => n * n
+export const EASE_OUT = (n) => -n * (n - 2.0)
+export const EASE_IN_OUT = (n) => {
+  if (n < 0.5) {
+    return 2.0 * n * n
+  }
+  return -2.0 * n * n + 4.0 * n - 1.0
+}
+
+export const BACK_IN = (n) => n * n * n - n * Math.sin(n * Math.PI)
+export const BACK_OUT = (n) => {
+  let a = 1.0 - n
+  return 1.0 - (a * a * a - a * Math.sin(a * Math.PI))
+}
+export const BACK_IN_OUT = (n) => {
+  if (n < 0.5) {
+    let a = 2.0 * n
+    return 0.5 * (a * a * a - a * Math.sin(a * Math.PI))
+  }
+  let a = 1.0 - (2.0 * n - 1.0)
+  return 0.5 * (1.0 - (a * a * a - a * Math.sin(n * Math.PI))) + 0.5
+}
+
+export const ELASTIC_IN = (n) => {
+  return Math.sin(13 * HALF_PI * n) * Math.pow(2, 10 * (n - 1))
+}
+export const ELASTIC_OUT = (n) => {
+  return Math.sin(-13 * HALF_PI * (n + 1)) * Math.pow(2, -10 * n) + 1
+}
+export const ELASTIC_IN_OUT = (n) => {
+  if (n < 0.5) {
+    let a = Math.sin(13 * HALF_PI * (2 * n))
+    let b = Math.pow(2, 10 * (2 * n - 1))
+    return 0.5 * a * b
+  }
+  let a = Math.sin(-13 * HALF_PI * (2 * n - 1 + 1))
+  let b = Math.pow(2, -10 * (2 * n - 1))
+  return 0.5 * (a * b + 2)
+}
+
+export const BOUNCE_IN = (n) => 1 - BOUNCE_OUT(1 - n)
+export const BOUNCE_OUT = (n) => {
+  if (n < 4.0 / 11.0) {
+    return (121.0 * n * n) / 16.0
+  } else if (n < 8.0 / 11.0) {
+    return (363.0 / 40.0) * n * n - (99.0 / 10.0) * n + 17.0 / 5.0
+  } else if (n < 9.0 / 10.0) {
+    return (4356.0 / 361.0) * n * n - (35442.0 / 1805.0) * n + 16061.0 / 1805.0
+  }
+  return (54.0 / 5.0) * n * n - (513.0 / 25.0) * n + 268.0 / 25.0
+}
+export const BOUNCE_IN_OUT = (n) => {
+  if (n < 0.5) {
+    return 0.5 * BOUNCE_IN(n * 2)
+  }
+  return 0.5 * BOUNCE_OUT(n * 2 - 1) + 0.5
+}
+
+class TweenController {
+  /** @type {boolean} */
+  running = false
+
+  /** @type {*} */
+  _o
+  /** @type {string} */
+  _p
+  /** @type {number} */
+  _x
+  /** @type {number} */
+  _d
+  /** @type {(x: number) => number} */
+  _e
+  /** @type {Function[]} */
+  _cb = []
+  /** @type {number} */
+  _t = 0
+  /** @type {Function} */
+  _u = 0
+  /** @type {LitecanvasInstance} */
+  _lc
+
+  /**
+   * @param {*} object
+   * @param {string} prop
+   * @param {number} toValue
+   * @param {number} duration
+   * @param {(x: number) => number} easing
+   */
+  constructor(object, prop, toValue, duration, easing) {
+    this._o = object
+    this._p = prop
+    this._x = toValue
+    this._d = duration
+    this._e = easing
+  }
+
+  /**
+   *
+   * @param {LitecanvasInstance} engine
+   */
+  start(engine = globalThis) {
+    if (!this.running) {
+      this.stop()
+    }
+
+    const fromValue = this._o[this._p] || 0
+
+    this._lc = engine
+    this._u = engine.listen("update", (dt) => {
+      this._o[this._p] = engine.lerp(
+        fromValue,
+        this._x,
+        this._e(this._t / this._d)
+      )
+      this._t += dt
+      if (this._t >= this._d) {
+        this._o[this._p] = this._x
+        this.stop()
+      }
+    })
+
+    this.running = true
+
+    return this
+  }
+
+  /**
+   * @param {Function} callback
+   */
+  onEnd(callback) {
+    this._cb.push(callback)
+  }
+
+  /**
+   * @param {boolean} completed if `false` don't call the `onEnd()` registered callbacks.
+   * @returns
+   */
+  stop(completed = true) {
+    if (!this.running || !this._u) return
+
+    this.running = false
+
+    this._u()
+
+    if (completed) {
+      for (const callback of this._cb) {
+        callback(this._o)
+      }
+    }
+  }
+
+  reset() {
+    this._cb.length = 0
+    this.stop()
+  }
+
+  get progress() {
+    return this.running ? this._t / this._d : 0
+  }
+}

package/src/vector/index.js

@@ -150,8 +150,9 @@ export const vecDiv = (v, x, y = x) => {
     return vecDiv(v, x.x, x.y)
   }
 
-  v.x /= x
-  v.y /= y
+  // prevent division by zero
+  v.x /= x || 1
+  v.y /= y || 1
 
   return v
 }
@@ -278,6 +279,15 @@ export const vecDist2 = (a, b) => {
  */
 export const vecAngle = (v) => Math.atan2(v.y, v.x)
 
+/**
+ * Calculates the angle between two vectors.
+ *
+ * @param {Vector} v1
+ * @param {Vector} v2
+ * @returns {number}
+ */
+export const vecAngleBetween = (v1, v2) => Math.atan2(v2.y - v1.y, v2.x - v1.x)
+
 /**
  * Calculates the dot product of two vectors.
  *