@litecanvas/utils 0.7.0 → 0.8.1

package/README.md

@@ -2,6 +2,46 @@
 
 Small collection of tools for developing games with [Litecanvas](https://github.com/litecanvas/game-engine).
 
+## Install
+
+### NPM package
+
+```
+npm i @litecanvas/utils
+```
+
+```js
+// import everything
+import * as utils from "@litecanvas/utils"
+
+const pos = utils.vec(0, 0)
+```
+
+```js
+// or import just what you want
+import { vec } from "@litecanvas/utils"
+
+const pos = vec(0, 0)
+```
+
+### CDN
+
+Download from https://unpkg.com/browse/@litecanvas/utils/dist/ and load in a `<script>` tag in your HTML.
+
+```js
+// now the "utils" namespace is created
+const pos = utils.vec(0, 0)
+```
+
+```js
+// also, you can  call this once to
+// expose the components globally
+utils.global()
+
+// now the namescape is not required
+const pos = vec(0, 0)
+```
+
 ## Components
 
 - **Camera**: Move-, zoom- and rotatable camera with shake. [Usage & Docs](https://github.com/litecanvas/utils/tree/main/src/camera)
@@ -10,9 +50,3 @@ Small collection of tools for developing games with [Litecanvas](https://github.
 - **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)
-
-## Install
-
-```
-npm i @litecanvas/utils
-```

package/dist/all.js

@@ -29,6 +29,7 @@
     LEFT: () => LEFT,
     ONE: () => ONE,
     RIGHT: () => RIGHT,
+    TypedGrid: () => TypedGrid,
     UP: () => UP,
     Vector: () => Vector,
     ZERO: () => ZERO,
@@ -222,49 +223,32 @@
     _h;
     /** @type {any[]} The grid cells */
     _c;
-    /**
-     * @static
-     * @param {number} width
-     * @param {number} height
-     * @param {any[]} values
-     */
-    static fromArray(width, height, values) {
-      const grid = new _Grid(width, height);
-      for (let i = 0; i < values.length; i++) {
-        grid._c[i] = values[i];
-      }
-      return grid;
-    }
     /**
      * @param {number} width The grid width
      * @param {number} height The grid height
      */
-    constructor(width, height) {
-      this.width = width;
-      this.height = height;
-      this.clear();
+    constructor(width, height, values = []) {
+      this._w = Math.max(1, ~~width);
+      this._h = Math.max(1, ~~height);
+      this._c = values;
     }
     /**
      * Delete all cell values.
      */
     clear() {
-      this._c = Array(this._w * this._h);
+      this.forEach((x, y) => this.set(x, y, void 0));
     }
     /**
-     * @param {number} value
+     * @returns {number}
+     * @readonly
      */
-    set width(value) {
-      this._w = Math.max(1, ~~value);
-    }
     get width() {
       return this._w;
     }
     /**
-     * @param {number} value
+     * @returns {number}
+     * @readonly
      */
-    set height(value) {
-      this._h = Math.max(1, ~~value);
-    }
     get height() {
       return this._h;
     }
@@ -389,7 +373,7 @@
      * @returns {any[]}
      */
     toArray() {
-      return this._c.slice(0);
+      return this._c.slice();
     }
     /**
      * @param {string} separator
@@ -406,6 +390,34 @@
       return rows.join("\n");
     }
   };
+  var TypedGrid = class _TypedGrid extends Grid {
+    /**
+     * @param {number} width The grid width
+     * @param {number} height The grid height
+     */
+    constructor(width, height, TypedArray = Uint8Array) {
+      super(width, height, null);
+      this._c = new TypedArray(this._w * this._h);
+    }
+    /**
+     * @param {number} x
+     * @param {number} y
+     * @returns {boolean}
+     */
+    has(x, y) {
+      return this.get(x, y) !== 0;
+    }
+    /**
+     * @returns {TypedGrid}
+     */
+    clone() {
+      const copy = new _TypedGrid(this._w, this._h, this._c.constructor);
+      this.forEach((x, y, value) => {
+        copy.set(x, y, value);
+      });
+      return copy;
+    }
+  };
   function _clamp(value, min, max) {
     if (value < min) return min;
     if (value > max) return max;

package/dist/all.min.js

@@ -1,2 +1,2 @@
-(()=>{var L=Object.defineProperty;var G=(e,t)=>{for(var s in t)L(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 I={};G(I,{ANCHOR_BOT_LEFT:()=>rt,ANCHOR_BOT_RIGHT:()=>nt,ANCHOR_CENTER:()=>ot,ANCHOR_TOP_LEFT:()=>W,ANCHOR_TOP_RIGHT:()=>it,Actor:()=>b,Camera:()=>p,DOWN:()=>et,Grid:()=>u,LEFT:()=>st,ONE:()=>K,RIGHT:()=>tt,UP:()=>Q,Vector:()=>d,ZERO:()=>J,diff:()=>D,fract:()=>M,intersection:()=>x,isvector:()=>l,resolve:()=>O,vec:()=>r,vecadd:()=>S,vecconfig:()=>w,veccopy:()=>H,veccross:()=>V,vecdir:()=>q,vecdist:()=>j,vecdist2:()=>$,vecdiv:()=>_,vecdot:()=>N,veceq:()=>k,veclerp:()=>U,veclimit:()=>B,vecmag:()=>R,vecmag2:()=>Y,vecmult:()=>E,vecnorm:()=>F,vecrand:()=>Z,vecrot:()=>v,vecset:()=>z,vecsub:()=>X,wave:()=>P});var D=(e,t)=>Math.abs(t-e)||0;var M=e=>e%1||0;var P=(e,t,s,o=Math.sin)=>e+(o(s)+1)/2*(t-e);var x=(e,t,s,o,n,i,a,c)=>{let h=Math.max(e,n),A=Math.min(e+s,n+a)-h,g=Math.max(t,i),m=Math.min(t+o,i+c)-g;return[h,g,A,m]};var O=(e,t,s,o,n,i,a,c)=>{let[h,A,g,m]=x(e,t,s,o,n,i,a,c),f="",y=e,T=t;return g<m?e<n?(f="right",y=n-s):(f="left",y=n+a):t<i?(f="bottom",T=i-o):(f="top",T=i+c),{direction:f,x:y,y:T}};var p=class{_engine=null;x=0;y=0;width=0;height=0;rotation=0;scale=1;_shake={x:0,y:0,removeListener:null};constructor(t=null){t=t||globalThis,this._engine=t,this.size(t.WIDTH||0,t.HEIGHT||0),this.x=this.width/2,this.y=this.height/2}size(t,s){this.width=t,this.height=s}start(t=!1){let s=this.width/2,o=this.height/2;this._engine.push(),this._engine.translate(s,o),this._engine.scale(this.scale),this._engine.rotate(this.rotation),this._engine.translate(-this.x+this._shake.x,-this.y+this._shake.y),t&&this._engine.cliprect(this.x,this.y,this.width,this.height)}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}shake(t=.3,s=1){this.shaking()||(this._shake.removeListener=this._engine.listen("update",o=>{this._shake.x=this._engine.randi(-s,s),this._shake.y=this._engine.randi(-s,s),t-=o,t<=0&&this.unshake()}))}unshake(){this.shaking()&&(this._shake.removeListener(),this._shake.removeListener=null,this._shake.x=this._shake.y=0)}shaking(){return this._shake.removeListener!==null}};var u=class e{_w;_h;_c;static fromArray(t,s,o){let n=new e(t,s);for(let i=0;i<o.length;i++)n._c[i]=o[i];return n}constructor(t,s){this.width=t,this.height=s,this.clear()}clear(){this._c=Array(this._w*this._h)}set width(t){this._w=Math.max(1,~~t)}get width(){return this._w}set height(t){this._h=Math.max(1,~~t)}get height(){return this._h}set(t,s,o){this._c[this.pointToIndex(t,s)]=o}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 o=s?this.length-1:0,n=s?-1:this.length,i=s?-1:1;for(;o!==n;){let a=this.indexToPointX(o),c=this.indexToPointY(o),h=this._c[o];if(t(a,c,h,this)===!1)break;o+=i}}fill(t){this.forEach((s,o)=>{this.set(s,o,t)})}clone(){return e.fromArray(this._w,this._h,this._c)}clampX(t){return C(t,0,this._w-1)}clampY(t){return C(t,0,this._h-1)}toArray(){return this._c.slice(0)}toString(t=" ",s=!0){if(!s)return this._c.join(t);let o=[];return this.forEach((n,i,a)=>{o[i]=o[i]||"",o[i]+=a+t}),o.join(`
-`)}};function C(e,t,s){return e<t?t:e>s?s:e}var d=class{x;y;constructor(t=0,s=t){this.x=t,this.y=s}toString(){return`Vector (${this.x}, ${this.y})`}},r=(e=0,t=e)=>new d(e,t),k=(e,t,s=t)=>l(t)?k(e,t.x,t.y):e.x===t&&e.y===s,H=e=>r(e.x,e.y),z=(e,t,s=t)=>{l(t)?z(e,t.x,t.y):(e.x=t,e.y=s)},S=(e,t,s=t)=>{l(t)?S(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=(e,t,s=t)=>{l(t)?E(e,t.x,t.y):(e.x*=t,e.y*=s)},_=(e,t,s=t)=>{l(t)?_(e,t.x,t.y):(e.x/=t,e.y/=s)},v=(e,t)=>{let s=Math.cos(t),o=Math.sin(t);e.x=s*e.x-o*e.y,e.y=o*e.x+s*e.y},R=e=>Math.sqrt(e.x*e.x+e.y*e.y),Y=e=>e.x*e.x+e.y*e.y,F=e=>{let t=R(e);t>0&&_(e,t)},B=(e,t)=>{let s=Y(e);s>t*t&&(_(e,Math.sqrt(s)),E(e,t))},j=(e,t)=>{let s=e.x-t.x,o=e.y-t.y;return Math.sqrt(s*s+o*o)},$=(e,t)=>{let s=e.x-t.x,o=e.y-t.y;return s*s+o*o},q=e=>Math.atan2(e.y,e.x),N=(e,t)=>e.x*t.x+e.y*t.y,V=(e,t)=>e.x*t.y-e.y*t.x,U=(e,t,s)=>{e.x+=(t.x-e.x)*s||0,e.y+=(t.y-e.y)*s||0},Z=(e=1,t=e)=>{let s=w.random()*2*Math.PI,o=w.random()*(t-e)+e;return r(Math.cos(s)*o,Math.sin(s)*o)},l=e=>e instanceof d,w={random:()=>globalThis.rand?rand():Math.random()},J=r(0,0),K=r(1,1),Q=r(0,-1),tt=r(1,0),et=r(0,1),st=r(-1,0);var ot=r(.5,.5),W=r(0,0),it=r(1,0),rt=r(0,1),nt=r(1,1),b=class{sprite;pos;_o;_s;angle=0;opacity=1;hidden=!1;constructor(t,s){this.sprite=t,this.pos=s||r(0),this._o=H(W),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.y}get height(){return this.sprite.height*this._s.y}get scale(){return this._s}draw(t=globalThis){if(this.hidden||this.opacity<=0)return;t.push(),this.transform(t);let s=this.sprite.width*this.anchor.x,o=this.sprite.height*this.anchor.y;t.image(-s,-o,this.sprite),t.pop()}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(this.angle),t.scale(this._s.x,this._s.y),t.alpha(this.opacity)}};globalThis.utils=Object.assign(globalThis.utils||{},I);})();
+(()=>{var v=Object.defineProperty;var F=(e,t)=>{for(var s in t)v(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 A={};F(A,{ANCHOR_BOT_LEFT:()=>nt,ANCHOR_BOT_RIGHT:()=>at,ANCHOR_CENTER:()=>it,ANCHOR_TOP_LEFT:()=>L,ANCHOR_TOP_RIGHT:()=>rt,Actor:()=>I,Camera:()=>p,DOWN:()=>st,Grid:()=>g,LEFT:()=>ot,ONE:()=>Q,RIGHT:()=>et,TypedGrid:()=>w,UP:()=>tt,Vector:()=>u,ZERO:()=>K,diff:()=>M,fract:()=>P,intersection:()=>x,isvector:()=>c,resolve:()=>C,vec:()=>i,vecadd:()=>X,vecconfig:()=>H,veccopy:()=>E,veccross:()=>U,vecdir:()=>N,vecdist:()=>$,vecdist2:()=>q,vecdiv:()=>_,vecdot:()=>V,veceq:()=>z,veclerp:()=>Z,veclimit:()=>j,vecmag:()=>Y,vecmag2:()=>W,vecmult:()=>b,vecnorm:()=>B,vecrand:()=>J,vecrot:()=>G,vecset:()=>S,vecsub:()=>R,wave:()=>O});var M=(e,t)=>Math.abs(t-e)||0;var P=e=>e%1||0;var O=(e,t,s,o=Math.sin)=>e+(o(s)+1)/2*(t-e);var x=(e,t,s,o,n,r,a,l)=>{let h=Math.max(e,n),D=Math.min(e+s,n+a)-h,d=Math.max(t,r),m=Math.min(t+o,r+l)-d;return[h,d,D,m]};var C=(e,t,s,o,n,r,a,l)=>{let[h,D,d,m]=x(e,t,s,o,n,r,a,l),f="",y=e,T=t;return d<m?e<n?(f="right",y=n-s):(f="left",y=n+a):t<r?(f="bottom",T=r-o):(f="top",T=r+l),{direction:f,x:y,y:T}};var p=class{_engine=null;x=0;y=0;width=0;height=0;rotation=0;scale=1;_shake={x:0,y:0,removeListener:null};constructor(t=null){t=t||globalThis,this._engine=t,this.size(t.WIDTH||0,t.HEIGHT||0),this.x=this.width/2,this.y=this.height/2}size(t,s){this.width=t,this.height=s}start(t=!1){let s=this.width/2,o=this.height/2;this._engine.push(),this._engine.translate(s,o),this._engine.scale(this.scale),this._engine.rotate(this.rotation),this._engine.translate(-this.x+this._shake.x,-this.y+this._shake.y),t&&this._engine.cliprect(this.x,this.y,this.width,this.height)}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}shake(t=.3,s=1){this.shaking()||(this._shake.removeListener=this._engine.listen("update",o=>{this._shake.x=this._engine.randi(-s,s),this._shake.y=this._engine.randi(-s,s),t-=o,t<=0&&this.unshake()}))}unshake(){this.shaking()&&(this._shake.removeListener(),this._shake.removeListener=null,this._shake.x=this._shake.y=0)}shaking(){return this._shake.removeListener!==null}};var g=class e{_w;_h;_c;constructor(t,s,o=[]){this._w=Math.max(1,~~t),this._h=Math.max(1,~~s),this._c=o}clear(){this.forEach((t,s)=>this.set(t,s,void 0))}get width(){return this._w}get height(){return this._h}set(t,s,o){this._c[this.pointToIndex(t,s)]=o}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 o=s?this.length-1:0,n=s?-1:this.length,r=s?-1:1;for(;o!==n;){let a=this.indexToPointX(o),l=this.indexToPointY(o),h=this._c[o];if(t(a,l,h,this)===!1)break;o+=r}}fill(t){this.forEach((s,o)=>{this.set(s,o,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 o=[];return this.forEach((n,r,a)=>{o[r]=o[r]||"",o[r]+=a+t}),o.join(`
+`)}},w=class e extends g{constructor(t,s,o=Uint8Array){super(t,s,null),this._c=new o(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,o,n)=>{t.set(s,o,n)}),t}};function k(e,t,s){return e<t?t:e>s?s:e}var u=class{x;y;constructor(t=0,s=t){this.x=t,this.y=s}toString(){return`Vector (${this.x}, ${this.y})`}},i=(e=0,t=e)=>new u(e,t),z=(e,t,s=t)=>c(t)?z(e,t.x,t.y):e.x===t&&e.y===s,E=e=>i(e.x,e.y),S=(e,t,s=t)=>{c(t)?S(e,t.x,t.y):(e.x=t,e.y=s)},X=(e,t,s=t)=>{c(t)?X(e,t.x,t.y):(e.x+=t,e.y+=s)},R=(e,t,s=t)=>{c(t)?R(e,t.x,t.y):(e.x-=t,e.y-=s)},b=(e,t,s=t)=>{c(t)?b(e,t.x,t.y):(e.x*=t,e.y*=s)},_=(e,t,s=t)=>{c(t)?_(e,t.x,t.y):(e.x/=t,e.y/=s)},G=(e,t)=>{let s=Math.cos(t),o=Math.sin(t);e.x=s*e.x-o*e.y,e.y=o*e.x+s*e.y},Y=e=>Math.sqrt(e.x*e.x+e.y*e.y),W=e=>e.x*e.x+e.y*e.y,B=e=>{let t=Y(e);t>0&&_(e,t)},j=(e,t)=>{let s=W(e);s>t*t&&(_(e,Math.sqrt(s)),b(e,t))},$=(e,t)=>{let s=e.x-t.x,o=e.y-t.y;return Math.sqrt(s*s+o*o)},q=(e,t)=>{let s=e.x-t.x,o=e.y-t.y;return s*s+o*o},N=e=>Math.atan2(e.y,e.x),V=(e,t)=>e.x*t.x+e.y*t.y,U=(e,t)=>e.x*t.y-e.y*t.x,Z=(e,t,s)=>{e.x+=(t.x-e.x)*s||0,e.y+=(t.y-e.y)*s||0},J=(e=1,t=e)=>{let s=H.random()*2*Math.PI,o=H.random()*(t-e)+e;return i(Math.cos(s)*o,Math.sin(s)*o)},c=e=>e instanceof u,H={random:()=>globalThis.rand?rand():Math.random()},K=i(0,0),Q=i(1,1),tt=i(0,-1),et=i(1,0),st=i(0,1),ot=i(-1,0);var it=i(.5,.5),L=i(0,0),rt=i(1,0),nt=i(0,1),at=i(1,1),I=class{sprite;pos;_o;_s;angle=0;opacity=1;hidden=!1;constructor(t,s){this.sprite=t,this.pos=s||i(0),this._o=E(L),this._s=i(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.y}get height(){return this.sprite.height*this._s.y}get scale(){return this._s}draw(t=globalThis){if(this.hidden||this.opacity<=0)return;t.push(),this.transform(t);let s=this.sprite.width*this.anchor.x,o=this.sprite.height*this.anchor.y;t.image(-s,-o,this.sprite),t.pop()}transform(t){t.translate(this.pos.x,this.pos.y),t.rotate(this.angle),t.scale(this._s.x,this._s.y),t.alpha(this.opacity)}};globalThis.utils=Object.assign(globalThis.utils||{},A);})();

package/dist/grid.js

@@ -1,4 +1,10 @@
 (() => {
+  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 = () => {
@@ -9,6 +15,11 @@
   };
 
   // src/grid/index.js
+  var grid_exports = {};
+  __export(grid_exports, {
+    Grid: () => Grid,
+    TypedGrid: () => TypedGrid
+  });
   var Grid = class _Grid {
     /** @type {number} The grid width */
     _w;
@@ -16,49 +27,32 @@
     _h;
     /** @type {any[]} The grid cells */
     _c;
-    /**
-     * @static
-     * @param {number} width
-     * @param {number} height
-     * @param {any[]} values
-     */
-    static fromArray(width, height, values) {
-      const grid = new _Grid(width, height);
-      for (let i = 0; i < values.length; i++) {
-        grid._c[i] = values[i];
-      }
-      return grid;
-    }
     /**
      * @param {number} width The grid width
      * @param {number} height The grid height
      */
-    constructor(width, height) {
-      this.width = width;
-      this.height = height;
-      this.clear();
+    constructor(width, height, values = []) {
+      this._w = Math.max(1, ~~width);
+      this._h = Math.max(1, ~~height);
+      this._c = values;
     }
     /**
      * Delete all cell values.
      */
     clear() {
-      this._c = Array(this._w * this._h);
+      this.forEach((x, y) => this.set(x, y, void 0));
     }
     /**
-     * @param {number} value
+     * @returns {number}
+     * @readonly
      */
-    set width(value) {
-      this._w = Math.max(1, ~~value);
-    }
     get width() {
       return this._w;
     }
     /**
-     * @param {number} value
+     * @returns {number}
+     * @readonly
      */
-    set height(value) {
-      this._h = Math.max(1, ~~value);
-    }
     get height() {
       return this._h;
     }
@@ -183,7 +177,7 @@
      * @returns {any[]}
      */
     toArray() {
-      return this._c.slice(0);
+      return this._c.slice();
     }
     /**
      * @param {string} separator
@@ -200,6 +194,34 @@
       return rows.join("\n");
     }
   };
+  var TypedGrid = class _TypedGrid extends Grid {
+    /**
+     * @param {number} width The grid width
+     * @param {number} height The grid height
+     */
+    constructor(width, height, TypedArray = Uint8Array) {
+      super(width, height, null);
+      this._c = new TypedArray(this._w * this._h);
+    }
+    /**
+     * @param {number} x
+     * @param {number} y
+     * @returns {boolean}
+     */
+    has(x, y) {
+      return this.get(x, y) !== 0;
+    }
+    /**
+     * @returns {TypedGrid}
+     */
+    clone() {
+      const copy = new _TypedGrid(this._w, this._h, this._c.constructor);
+      this.forEach((x, y, value) => {
+        copy.set(x, y, value);
+      });
+      return copy;
+    }
+  };
   function _clamp(value, min, max) {
     if (value < min) return min;
     if (value > max) return max;
@@ -207,5 +229,5 @@
   }
 
   // src/grid/_web.js
-  globalThis.utils = Object.assign(globalThis.utils || {}, { Grid });
+  globalThis.utils = Object.assign(globalThis.utils || {}, grid_exports);
 })();

package/dist/grid.min.js

@@ -1,2 +1,2 @@
-(()=>{globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let s in globalThis.utils)s!=="global"&&(globalThis[s]=globalThis.utils[s])};var n=class s{_w;_h;_c;static fromArray(t,i,h){let l=new s(t,i);for(let r=0;r<h.length;r++)l._c[r]=h[r];return l}constructor(t,i){this.width=t,this.height=i,this.clear()}clear(){this._c=Array(this._w*this._h)}set width(t){this._w=Math.max(1,~~t)}get width(){return this._w}set height(t){this._h=Math.max(1,~~t)}get height(){return this._h}set(t,i,h){this._c[this.pointToIndex(t,i)]=h}get(t,i){return this._c[this.pointToIndex(t,i)]}has(t,i){return this.get(t,i)!=null}get length(){return this._w*this._h}pointToIndex(t,i){return this.clampX(~~t)+this.clampY(~~i)*this._w}indexToPointX(t){return t%this._w}indexToPointY(t){return Math.floor(t/this._w)}forEach(t,i=!1){let h=i?this.length-1:0,l=i?-1:this.length,r=i?-1:1;for(;h!==l;){let e=this.indexToPointX(h),c=this.indexToPointY(h),a=this._c[h];if(t(e,c,a,this)===!1)break;h+=r}}fill(t){this.forEach((i,h)=>{this.set(i,h,t)})}clone(){return s.fromArray(this._w,this._h,this._c)}clampX(t){return o(t,0,this._w-1)}clampY(t){return o(t,0,this._h-1)}toArray(){return this._c.slice(0)}toString(t=" ",i=!0){if(!i)return this._c.join(t);let h=[];return this.forEach((l,r,e)=>{h[r]=h[r]||"",h[r]+=e+t}),h.join(`
-`)}};function o(s,t,i){return s<t?t:s>i?i:s}globalThis.utils=Object.assign(globalThis.utils||{},{Grid:n});})();
+(()=>{var g=Object.defineProperty;var f=(h,t)=>{for(var i in t)g(h,i,{get:t[i],enumerable:!0})};globalThis.utils=globalThis.utils||{};globalThis.utils.global=()=>{for(let h in globalThis.utils)h!=="global"&&(globalThis[h]=globalThis.utils[h])};var c={};f(c,{Grid:()=>o,TypedGrid:()=>l});var o=class h{_w;_h;_c;constructor(t,i,s=[]){this._w=Math.max(1,~~t),this._h=Math.max(1,~~i),this._c=s}clear(){this.forEach((t,i)=>this.set(t,i,void 0))}get width(){return this._w}get height(){return this._h}set(t,i,s){this._c[this.pointToIndex(t,i)]=s}get(t,i){return this._c[this.pointToIndex(t,i)]}has(t,i){return this.get(t,i)!=null}get length(){return this._w*this._h}pointToIndex(t,i){return this.clampX(~~t)+this.clampY(~~i)*this._w}indexToPointX(t){return t%this._w}indexToPointY(t){return Math.floor(t/this._w)}forEach(t,i=!1){let s=i?this.length-1:0,r=i?-1:this.length,n=i?-1:1;for(;s!==r;){let e=this.indexToPointX(s),a=this.indexToPointY(s),_=this._c[s];if(t(e,a,_,this)===!1)break;s+=n}}fill(t){this.forEach((i,s)=>{this.set(i,s,t)})}clone(){return h.fromArray(this._w,this._h,this._c)}clampX(t){return u(t,0,this._w-1)}clampY(t){return u(t,0,this._h-1)}toArray(){return this._c.slice()}toString(t=" ",i=!0){if(!i)return this._c.join(t);let s=[];return this.forEach((r,n,e)=>{s[n]=s[n]||"",s[n]+=e+t}),s.join(`
+`)}},l=class h extends o{constructor(t,i,s=Uint8Array){super(t,i,null),this._c=new s(this._w*this._h)}has(t,i){return this.get(t,i)!==0}clone(){let t=new h(this._w,this._h,this._c.constructor);return this.forEach((i,s,r)=>{t.set(i,s,r)}),t}};function u(h,t,i){return h<t?t:h>i?i:h}globalThis.utils=Object.assign(globalThis.utils||{},c);})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litecanvas/utils",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Utilities to help build litecanvas games",
   "author": "Luiz Bills <luizbills@pm.me>",
   "license": "MIT",
@@ -17,9 +17,10 @@
   "keywords": [
     "litecanvas",
     "utilities",
+    "helpers",
     "camera",
     "vector",
-    "gamedev"
+    "grid"
   ],
   "scripts": {
     "dev": "esbuild src/_web.js --bundle --watch --outfile=dist/all.js --servedir=.",

package/src/grid/README.md

@@ -1,4 +1,4 @@
-# Grid
+# Grid utils
 
 **CDN**: https://unpkg.com/@litecanvas/utils/dist/grid.js
 
@@ -45,3 +45,17 @@ The result:
 # . . . . . . . . . . . #
 # # # # # # # # # # # # #
 ```
+
+## Typed Grid
+
+You can create a grid structure thats uses a [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Typed_arrays) rather than a "normal" array.
+
+```
+import { TypedGrid } from "@litecanvas/utils"
+
+let u8grid = new TypedGrid(5, 5) // by default, uses Uint8Array
+
+let i16grid = new TypedGrid(5, 5, Int16Array) // or specify your typed array
+```
+
+> Note: `TypedGrid` inherits all methods from `Grid`.

package/src/grid/_web.js

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

package/src/grid/index.js

@@ -1,4 +1,4 @@
-export default class Grid {
+export class Grid {
   /** @type {number} The grid width */
   _w
 
@@ -8,55 +8,35 @@ export default class Grid {
   /** @type {any[]} The grid cells */
   _c
 
-  /**
-   * @static
-   * @param {number} width
-   * @param {number} height
-   * @param {any[]} values
-   */
-  static fromArray(width, height, values) {
-    const grid = new Grid(width, height)
-    for (let i = 0; i < values.length; i++) {
-      grid._c[i] = values[i]
-    }
-    return grid
-  }
-
   /**
    * @param {number} width The grid width
    * @param {number} height The grid height
    */
-  constructor(width, height) {
-    this.width = width
-    this.height = height
-    this.clear()
+  constructor(width, height, values = []) {
+    this._w = Math.max(1, ~~width)
+    this._h = Math.max(1, ~~height)
+    this._c = values
   }
 
   /**
    * Delete all cell values.
    */
   clear() {
-    this._c = Array(this._w * this._h)
+    this.forEach((x, y) => this.set(x, y, undefined))
   }
 
   /**
-   * @param {number} value
+   * @returns {number}
+   * @readonly
    */
-  set width(value) {
-    this._w = Math.max(1, ~~value)
-  }
-
   get width() {
     return this._w
   }
 
   /**
-   * @param {number} value
+   * @returns {number}
+   * @readonly
    */
-  set height(value) {
-    this._h = Math.max(1, ~~value)
-  }
-
   get height() {
     return this._h
   }
@@ -201,7 +181,7 @@ export default class Grid {
    * @returns {any[]}
    */
   toArray() {
-    return this._c.slice(0)
+    return this._c.slice()
   }
 
   /**
@@ -222,6 +202,37 @@ export default class Grid {
   }
 }
 
+export class TypedGrid extends Grid {
+  /**
+   * @param {number} width The grid width
+   * @param {number} height The grid height
+   */
+  constructor(width, height, TypedArray = Uint8Array) {
+    super(width, height, null)
+    this._c = new TypedArray(this._w * this._h)
+  }
+
+  /**
+   * @param {number} x
+   * @param {number} y
+   * @returns {boolean}
+   */
+  has(x, y) {
+    return this.get(x, y) !== 0
+  }
+
+  /**
+   * @returns {TypedGrid}
+   */
+  clone() {
+    const copy = new TypedGrid(this._w, this._h, this._c.constructor)
+    this.forEach((x, y, value) => {
+      copy.set(x, y, value)
+    })
+    return copy
+  }
+}
+
 /**
  * Constrains a number between `min` and `max`.
  *
@@ -235,5 +246,3 @@ function _clamp(value, min, max) {
   if (value > max) return max
   return value
 }
-
-function _fill(x, y) {}

package/src/index.js

@@ -4,6 +4,6 @@ export { default as wave } from "./math/wave.js"
 export { default as resolve } from "./collision/resolve.js"
 export { default as intersection } from "./collision/intersection.js"
 export { default as Camera } from "./camera/index.js"
-export { default as Grid } from "./grid/index.js"
+export * from "./grid/index.js"
 export * from "./vector/index.js"
 export * from "./actor/index.js"