@vived/core 1.0.0 → 1.1.0

package/dist/types/ValueObjects/ParametricLine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParametricLine.test.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/ParametricLine.test.ts"],"names":[],"mappings":""}

package/dist/types/ValueObjects/ParametricPlane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParametricPlane.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/ParametricPlane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIlD,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qBAAa,eAAe;IAoEd,OAAO,CAAC,KAAK;IAAW,OAAO,CAAC,MAAM;IAnElD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe;IAIxE,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,eAAe;IAS3E,MAAM,CAAC,EAAE,IAAI,eAAe;IAM5B,MAAM,CAAC,EAAE,IAAI,eAAe;IAM5B,MAAM,CAAC,EAAE,IAAI,eAAe;IAM5B,aAAa,IAAI,eAAe;IAkBzB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,SAAS;gBAkB3C,KAAK,EAAE,OAAO,EAAU,MAAM,EAAE,OAAO;CAC5D"}

package/dist/types/ValueObjects/ParametricPlane.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParametricPlane.test.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/ParametricPlane.test.ts"],"names":[],"mappings":""}

package/dist/types/ValueObjects/Quaternion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Quaternion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qBAAa,UAAU;IACrB;;;;;OAKG;WACW,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO;IAQ1D;;;;;;OAMG;WACW,KAAK,CACjB,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,SAAS,SAAQ,GAChB,OAAO;IAkBV;;;;;OAKG;WACW,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU;IAQhE;;;;OAIG;WACW,SAAS,CACrB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACvC,UAAU;IAIb;;;;OAIG;WACW,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU;IAIrD;;;OAGG;WACW,QAAQ,IAAI,UAAU;IAIpC;;;;;OAKG;WACW,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU;WAUtD,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU;IAkCjE;;;;;;OAMG;WACW,gBAAgB,CAC5B,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,KAAK,GACV,UAAU;IAoBb;;;;;;OAMG;WACW,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK;IAIpD;;;;OAIG;WACW,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU;WAIlC,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,KAAK;IAY/D;;;;;;OAMG;WACW,KAAK,CACjB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,UAAU;IAiCb;;;;OAIG;WACW,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,UAAU;WAmDtD,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIxD;;;OAGG;IACH,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAI3C,IAAI,KAAK,IAAI,KAAK,CAGjB;IAED,IAAI,IAAI,IAAI,OAAO,CAKlB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,aAAa,CAEvB;IAED,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;gBAEP,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAMvD"}

package/dist/types/ValueObjects/Quaternion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Quaternion.test.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Quaternion.test.ts"],"names":[],"mappings":""}

package/dist/types/ValueObjects/Rectangle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rectangle.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Rectangle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,SAAS;WACN,OAAO,CAAC,GAAG,EAAE,YAAY,GAAE,SAAS;IAIlD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,IAAI,GAAG,IAAI,YAAY,CAOtB;gBAEW,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMrE"}

package/dist/types/ValueObjects/Rectangle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rectangle.test.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Rectangle.test.ts"],"names":[],"mappings":""}

package/dist/types/ValueObjects/Vector2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vector2.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Vector2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC;AAE1B,qBAAa,OAAO;IAClB;;;OAGG;WACW,IAAI,IAAI,OAAO;IAI7B;;;OAGG;WACW,GAAG,IAAI,OAAO;IAI5B;;;;;OAKG;WACW,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAMpD;;;;OAIG;WACW,OAAO,CAAC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAI7D;;;;;OAKG;WACW,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAIlD;;;;;OAKG;WACW,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAIvD;;;;;;OAMG;IACH,OAAc,KAAK,GACjB,GAAG,OAAO,EACV,GAAG,OAAO,EACV,YAAW,MAAa,KACvB,OAAO,CAMR;IAEF;;;;;OAKG;IACH,OAAc,MAAM,GAAI,KAAK,OAAO,EAAE,OAAO,KAAK,KAAG,OAAO,CAI1D;IAEF;;;;;OAKG;IACH,OAAc,KAAK,GAAI,QAAQ,OAAO,EAAE,OAAO,MAAM,KAAG,OAAO,CAI7D;IAEF;;;;;OAKG;IACH,OAAc,iBAAiB,GAC7B,QAAQ,OAAO,EACf,QAAQ,MAAM,KACb,OAAO,CAKR;IAEF;;;;;OAKG;IACH,OAAc,GAAG,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,MAAM,CAElD;IAEF;;;;;OAKG;IACH,OAAc,YAAY,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,KAAK,CAO1D;IAEF;;;;;OAKG;IACH,OAAc,KAAK,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,MAAM,CAEpD;IAEF,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAMtB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,CASlB;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5B;IAED;;OAEG;IACH,IAAI,GAAG,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAElC;gBAEW,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAIjC"}

package/dist/types/ValueObjects/Vector2.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vector2.test.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Vector2.test.ts"],"names":[],"mappings":""}

package/dist/types/ValueObjects/Vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vector3.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Vector3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qBAAa,OAAO;IAClB;;;OAGG;WACW,IAAI;IAIlB;;;OAGG;WACW,GAAG;IAIjB;;;;OAIG;WACW,KAAK,CAAC,MAAM,SAAI;IAI9B;;;;OAIG;WACW,IAAI,CAAC,MAAM,SAAI;IAI7B;;;;OAIG;WACW,EAAE,CAAC,MAAM,SAAI;IAI3B;;;;OAIG;WACW,IAAI,CAAC,MAAM,SAAI;IAI7B;;;;OAIG;WACW,OAAO,CAAC,MAAM,SAAI;IAIhC;;;;OAIG;WACW,QAAQ,CAAC,MAAM,SAAI;IAIjC;;;;OAIG;WACW,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAIlE;;;;OAIG;WACW,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAI/C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAO,CAE5C;IAEF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAO,CAEjD;IAEF;;;;;OAKG;IACH,MAAM,CAAC,KAAK,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAO,CAG9C;IAEF;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,kBAAgB,KAAG,OAAO,CAMhE;IAEF;;;;;OAKG;IACH,MAAM,CAAC,KAAK,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAO,CAK9C;IAEF;;;;;OAKG;IACH,MAAM,CAAC,GAAG,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,MAAM,CAE3C;IAEF;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,GAAI,KAAK,OAAO,EAAE,QAAQ,MAAM,KAAG,OAAO,CAGhE;IAEF,MAAM,CAAC,SAAS,GAAI,QAAQ,OAAO,EAAE,QAAQ,MAAM,KAAG,OAAO,CAa3D;IAEF;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,GACT,SAAS,OAAO,EAChB,OAAO,OAAO,EACd,SAAS,MAAM,KACd,OAAO,CAMR;IAEF,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAIhC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAOtB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,OAAO,CAUlB;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAEpC;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,UAAU,CAEpB;gBAEW,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAK5C"}

package/dist/types/ValueObjects/Vector3.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vector3.test.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/Vector3.test.ts"],"names":[],"mappings":""}

package/dist/types/ValueObjects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ValueObjects/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/{index.d.ts → types/index.d.ts}

@@ -1,5 +1,6 @@
 export * from "./AppObject";
 export * from "./Entities";
 export * from "./Types";
+export * from "./Utilities";
 export * from "./ValueObjects";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -1,13 +1,18 @@
 {
   "name": "@vived/core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Core Components for VIVED Apps and Hosts",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    "import": "./dist/esm/index.js",
+    "require": "./dist/cjs/index.js"
+  },
   "scripts": {
     "test": "jest --watch --config jestconfig.json",
     "testOnce": "jest --config jestconfig.json",
-    "build": "tsc",
+    "build": "tsc --build tsconfig.build.json",
     "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
     "lint": "tslint -p tsconfig.json",
     "prepare": "npm run build",
@@ -28,6 +33,7 @@
   "homepage": "https://bitbucket.org/cyberscience3d/npm_vived_core#readme",
   "devDependencies": {
     "@types/jest": "^29.5.14",
+    "@types/uuid": "^10.0.0",
     "jest": "^29.7.0",
     "prettier": "^3.5.3",
     "ts-jest": "^29.2.6",
@@ -37,5 +43,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "uuid": "^11.1.0"
   }
 }

package/src/Utilities/LengthConverters.test.ts

@@ -0,0 +1,30 @@
+import {
+  feetToMeters,
+  inchesToMeters,
+  metersToFeet,
+  metersToInches,
+} from "./LengthConverters";
+
+test("Converting inches to meters", () => {
+  expect(inchesToMeters(0)).toEqual(0);
+  expect(inchesToMeters(12)).toEqual(0.30479983540808886);
+  expect(inchesToMeters(-12)).toEqual(-0.30479983540808886);
+});
+
+test("Converting meters to inches", () => {
+  expect(metersToInches(0)).toEqual(0);
+  expect(metersToInches(2)).toEqual(78.7402);
+  expect(metersToInches(-2)).toEqual(-78.7402);
+});
+
+test("Converting feet to meters", () => {
+  expect(feetToMeters(0)).toEqual(0);
+  expect(feetToMeters(5)).toEqual(1.5239999512320015);
+  expect(feetToMeters(-5)).toEqual(-1.5239999512320015);
+});
+
+test("Converting meters to feet", () => {
+  expect(metersToFeet(0)).toEqual(0);
+  expect(metersToFeet(2)).toEqual(6.56168);
+  expect(metersToFeet(-2)).toEqual(-6.56168);
+});

package/src/Utilities/LengthConverters.ts

@@ -0,0 +1,18 @@
+const inchesPerMeter = 39.3701;
+const feetPerMeter = 3.28084;
+
+export function inchesToMeters(inches: number): number {
+  return inches / inchesPerMeter;
+}
+
+export function metersToInches(meters: number): number {
+  return meters * inchesPerMeter;
+}
+
+export function feetToMeters(feet: number): number {
+  return feet / feetPerMeter;
+}
+
+export function metersToFeet(meters: number): number {
+  return meters * feetPerMeter;
+}

package/src/Utilities/LerpNumber.test.ts

@@ -0,0 +1,109 @@
+import { LerpNumber } from "./LerpNumber";
+
+describe("Lerp Number", () => {
+  let lerpNumber: LerpNumber;
+  let updateFn: jest.Mock;
+
+  beforeEach(() => {
+    lerpNumber = new LerpNumber();
+    updateFn = jest.fn();
+    jest.useFakeTimers();
+  });
+
+  afterEach(() => {
+    jest.useRealTimers();
+  });
+
+  it("should lerp from start to end value", async () => {
+    lerpNumber.defaultDurationMS = 1000;
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+    });
+
+    // Test middle point (should have multiple updates by this point)
+    jest.advanceTimersByTime(500);
+    expect(updateFn).toHaveBeenCalledWith(expect.closeTo(50, 5)); // Allow some margin due to interval timing
+
+    // Complete animation
+    jest.advanceTimersByTime(500);
+    await promise;
+
+    expect(updateFn).toHaveBeenCalledWith(0); // Start value
+    expect(updateFn).toHaveBeenLastCalledWith(100); // End value
+  });
+
+  it("should cancel lerp when requested", async () => {
+    const onCancel = jest.fn();
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      onCancel,
+    });
+
+    expect(lerpNumber.isLerping).toBe(true);
+
+    lerpNumber.cancel();
+    jest.advanceTimersByTime(10); // Allow interval to execute
+    await promise;
+
+    expect(lerpNumber.isLerping).toBe(false);
+    expect(onCancel).toHaveBeenCalled();
+  });
+
+  it("should respect custom duration", async () => {
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      durationMS: 500,
+    });
+
+    jest.advanceTimersByTime(250); // Half way
+    expect(updateFn).toHaveBeenLastCalledWith(expect.any(Number));
+
+    jest.advanceTimersByTime(250); // Complete
+    await promise;
+
+    expect(updateFn).toHaveBeenLastCalledWith(100);
+  });
+
+  it("should call onComplete when finished", async () => {
+    const onComplete = jest.fn();
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      onComplete,
+    });
+
+    jest.advanceTimersByTime(1000);
+    await promise;
+
+    expect(onComplete).toHaveBeenCalled();
+  });
+
+  it("should cancel existing lerp when starting a new one", async () => {
+    const onCancel = jest.fn();
+    const firstPromise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      onCancel,
+    });
+
+    const secondPromise = lerpNumber.lerp({
+      start: 200,
+      end: 300,
+      update: updateFn,
+    });
+
+    jest.advanceTimersByTime(1000);
+    await Promise.all([firstPromise, secondPromise]);
+
+    expect(onCancel).toHaveBeenCalled();
+    expect(updateFn).toHaveBeenLastCalledWith(300);
+  });
+});

package/src/Utilities/LerpNumber.ts

@@ -0,0 +1,109 @@
+import { EaseFn } from "../Types";
+import { quintInOut } from "./easeFunctions";
+
+/**
+ * Configuration object for performing a linear interpolation (lerp) operation.
+ * @interface LerpNumberDTO
+ */
+export interface LerpNumberDTO {
+  /** Starting value of the lerp */
+  start: number;
+  /** Target/ending value of the lerp */
+  end: number;
+  /** Callback function that receives the interpolated value on each update */
+  update: (value: number) => void;
+  /** Duration of the lerp in milliseconds. Defaults to LerpNumber.defaultDurationMS */
+  durationMS?: number;
+  /** Easing function to modify the interpolation curve. Defaults to LerpNumber.defaultEase */
+  ease?: EaseFn;
+  /** Optional callback function called when lerp completes naturally */
+  onComplete?: () => void;
+  /** Optional callback function called when lerp is cancelled */
+  onCancel?: () => void;
+}
+
+/**
+ * Utility class for smoothly interpolating between two numbers over time.
+ * Uses requestAnimationFrame for smooth animation and supports custom easing functions.
+ *
+ * @example
+ * const lerper = new LerpNumber();
+ * // Animate from 0 to 100 over 2 seconds
+ * await lerper.lerp({
+ *   start: 0,
+ *   end: 100,
+ *   durationMS: 2000,
+ *   update: (value) => console.log(value)
+ * });
+ */
+export class LerpNumber {
+  public defaultDurationMS = 1000;
+  public defaultEase: EaseFn = quintInOut;
+
+  public get isLerping() {
+    return this._isLerping;
+  }
+  private _isLerping = false;
+
+  /**
+   * Cancels the current lerp operation if one is in progress.
+   * Triggers the onCancel callback if provided in the original lerp configuration.
+   */
+  public cancel() {
+    if (!this._isLerping) return;
+
+    this._cancelLerp = true;
+  }
+
+  private _cancelLerp = false;
+
+  /**
+   * Initiates a lerp (linear interpolation) operation.
+   * If a lerp is already in progress, it will be cancelled before starting the new one.
+   *
+   * @param data - Configuration object for the lerp operation
+   * @returns Promise that resolves when the lerp completes or is cancelled
+   * @throws Never throws, but may reject if the update function throws
+   */
+  lerp = (data: LerpNumberDTO): Promise<void> => {
+    if (this._isLerping) {
+      this.cancel();
+    }
+    const { start, end, durationMS, ease, onComplete, update, onCancel } = data;
+
+    const durationToUse = durationMS ?? this.defaultDurationMS;
+    const easeToUse = ease ?? this.defaultEase;
+
+    return new Promise((resolve) => {
+      const startTime = performance.now();
+      this._isLerping = true;
+
+      update(start);
+
+      const interval = setInterval(() => {
+        if (this._cancelLerp) {
+          clearInterval(interval);
+          this._isLerping = false;
+          this._cancelLerp = false;
+          if (onCancel) onCancel();
+          return resolve();
+        }
+
+        const currentTime = performance.now();
+        const elapsedTime = currentTime - startTime;
+        const progress = Math.min(elapsedTime / durationToUse, 1);
+        const easedProgress = easeToUse(progress);
+        const value = start + (end - start) * easedProgress;
+        update(value);
+
+        if (progress >= 1) {
+          clearInterval(interval);
+          this._isLerping = false;
+          update(end);
+          if (onComplete) onComplete();
+          resolve();
+        }
+      }, 10);
+    });
+  };
+}

package/src/Utilities/degreesToRadians.test.ts

@@ -0,0 +1,8 @@
+import { degreesToRadians } from "./degreesToRadians"
+
+test("Converting degrees to radians", ()=>{
+  expect(degreesToRadians(0)).toEqual(0);
+  expect(degreesToRadians(180)).toBeCloseTo(Math.PI);
+  expect(degreesToRadians(-90)).toBeCloseTo(-Math.PI/2);
+})
+

package/src/Utilities/degreesToRadians.ts

@@ -0,0 +1,3 @@
+export function degreesToRadians(deg: number):number{
+  return deg * Math.PI / 180;
+}

package/src/Utilities/easeFunctions.test.ts

@@ -0,0 +1,251 @@
+import {
+  easeLinear,
+  quadIn,
+  quadInOut,
+  quadOut,
+  cubicIn,
+  cubicInOut,
+  cubicOut,
+  expoIn,
+  expoInOut,
+  expoOut,
+  sinIn,
+  sinInOut,
+  sinOut,
+  quartIn,
+  quartInOut,
+  quartOut,
+  quintIn,
+  quintInOut,
+  quintOut,
+  circIn,
+  circInOut,
+  circOut,
+} from "./easeFunctions";
+
+it("Returns the proper values for ease linear", () => {
+  expect(easeLinear(-1)).toEqual(0);
+  expect(easeLinear(0)).toEqual(0);
+  expect(easeLinear(0.25)).toEqual(0.25);
+  expect(easeLinear(0.5)).toEqual(0.5);
+  expect(easeLinear(0.75)).toEqual(0.75);
+  expect(easeLinear(1)).toEqual(1);
+  expect(easeLinear(2)).toEqual(1);
+});
+
+// Quad
+it("Returns the proper val for quad in", () => {
+  expect(quadIn(-1)).toEqual(0);
+  expect(quadIn(0)).toEqual(0);
+  expect(quadIn(0.25)).toEqual(0.0625);
+  expect(quadIn(0.5)).toEqual(0.25);
+  expect(quadIn(0.75)).toEqual(0.5625);
+  expect(quadIn(1)).toEqual(1);
+  expect(quadIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for quad out", () => {
+  expect(quadOut(-1)).toEqual(0);
+  expect(quadOut(0)).toEqual(0);
+  expect(quadOut(0.25)).toEqual(0.4375);
+  expect(quadOut(0.5)).toEqual(0.75);
+  expect(quadOut(0.75)).toEqual(0.9375);
+  expect(quadOut(1)).toEqual(1);
+  expect(quadOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for quad in out", () => {
+  expect(quadInOut(-1)).toEqual(0);
+  expect(quadInOut(0)).toEqual(0);
+  expect(quadInOut(0.25)).toEqual(0.125);
+  expect(quadInOut(0.5)).toEqual(0.5);
+  expect(quadInOut(0.75)).toEqual(0.875);
+  expect(quadInOut(1)).toEqual(1);
+  expect(quadInOut(2)).toEqual(1);
+});
+
+// Cubic
+it("Returns the proper val for cubic in", () => {
+  expect(cubicIn(-1)).toEqual(0);
+  expect(cubicIn(0)).toEqual(0);
+  expect(cubicIn(0.25)).toEqual(0.015625);
+  expect(cubicIn(0.5)).toEqual(0.125);
+  expect(cubicIn(0.75)).toEqual(0.421875);
+  expect(cubicIn(1)).toEqual(1);
+  expect(cubicIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for cubic out", () => {
+  expect(cubicOut(-1)).toEqual(0);
+  expect(cubicOut(0)).toEqual(0);
+  expect(cubicOut(0.25)).toEqual(0.578125);
+  expect(cubicOut(0.5)).toEqual(0.875);
+  expect(cubicOut(0.75)).toEqual(0.984375);
+  expect(cubicOut(1)).toEqual(1);
+  expect(cubicOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for cubic in out", () => {
+  expect(cubicInOut(-1)).toEqual(0);
+  expect(cubicInOut(0)).toEqual(0);
+  expect(cubicInOut(0.25)).toEqual(0.0625);
+  expect(cubicInOut(0.5)).toEqual(0.5);
+  expect(cubicInOut(0.75)).toEqual(0.9375);
+  expect(cubicInOut(1)).toEqual(1);
+  expect(cubicInOut(2)).toEqual(1);
+});
+
+// Expo
+it("Returns the proper val for Expo in", () => {
+  expect(expoIn(-1)).toEqual(0);
+  expect(expoIn(0)).toEqual(0);
+  expect(expoIn(0.25)).toEqual(0.005524271728019902);
+  expect(expoIn(0.5)).toEqual(0.03125);
+  expect(expoIn(0.75)).toEqual(0.17677669529663687);
+  expect(expoIn(1)).toEqual(1);
+  expect(expoIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for Expo out", () => {
+  expect(expoOut(-1)).toEqual(0);
+  expect(expoOut(0)).toEqual(0);
+  expect(expoOut(0.25)).toEqual(0.8232233047033631);
+  expect(expoOut(0.5)).toEqual(0.96875);
+  expect(expoOut(0.75)).toEqual(0.99447572827198);
+  expect(expoOut(1)).toEqual(1);
+  expect(expoOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for Expo in out", () => {
+  expect(expoInOut(-1)).toEqual(0);
+  expect(expoInOut(0)).toEqual(0);
+  expect(expoInOut(0.25)).toEqual(0.015625);
+  expect(expoInOut(0.5)).toEqual(0.5);
+  expect(expoInOut(0.75)).toEqual(0.984375);
+  expect(expoInOut(1)).toEqual(1);
+  expect(expoInOut(2)).toEqual(1);
+});
+
+// Sin
+it("Returns the proper val for Sin in", () => {
+  expect(sinIn(-1)).toEqual(0);
+  expect(sinIn(0)).toEqual(0);
+  expect(sinIn(0.25)).toEqual(0.07612046748871326);
+  expect(sinIn(0.5)).toEqual(0.2928932188134524);
+  expect(sinIn(0.75)).toEqual(0.6173165676349102);
+  expect(sinIn(1)).toEqual(1);
+  expect(sinIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for Sin out", () => {
+  expect(sinOut(-1)).toEqual(0);
+  expect(sinOut(0)).toEqual(0);
+  expect(sinOut(0.25)).toEqual(0.3826834323650898);
+  expect(sinOut(0.5)).toEqual(0.7071067811865475);
+  expect(sinOut(0.75)).toEqual(0.9238795325112867);
+  expect(sinOut(1)).toEqual(1);
+  expect(sinOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for Sin in out", () => {
+  expect(sinInOut(-1)).toEqual(0);
+  expect(sinInOut(0)).toEqual(0);
+  expect(sinInOut(0.25)).toEqual(0.1464466094067262);
+  expect(sinInOut(0.5)).toBeCloseTo(0.5);
+  expect(sinInOut(0.75)).toEqual(0.8535533905932737);
+  expect(sinInOut(1)).toEqual(1);
+  expect(sinInOut(2)).toEqual(1);
+});
+
+// Quart
+it("Returns the proper val for Quart in", () => {
+  expect(quartIn(-1)).toEqual(0);
+  expect(quartIn(0)).toEqual(0);
+  expect(quartIn(0.25)).toEqual(0.00390625);
+  expect(quartIn(0.5)).toEqual(0.0625);
+  expect(quartIn(0.75)).toEqual(0.31640625);
+  expect(quartIn(1)).toEqual(1);
+  expect(quartIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for Quart out", () => {
+  expect(quartOut(-1)).toEqual(0);
+  expect(quartOut(0)).toEqual(0);
+  expect(quartOut(0.25)).toEqual(0.68359375);
+  expect(quartOut(0.5)).toEqual(0.9375);
+  expect(quartOut(0.75)).toEqual(0.99609375);
+  expect(quartOut(1)).toEqual(1);
+  expect(quartOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for Quart in out", () => {
+  expect(quartInOut(-1)).toEqual(0);
+  expect(quartInOut(0)).toEqual(0);
+  expect(quartInOut(0.25)).toEqual(0.03125);
+  expect(quartInOut(0.5)).toBeCloseTo(0.5);
+  expect(quartInOut(0.75)).toEqual(0.96875);
+  expect(quartInOut(1)).toEqual(1);
+  expect(quartInOut(2)).toEqual(1);
+});
+
+// Quint
+it("Returns the proper val for Quint in", () => {
+  expect(quintIn(-1)).toEqual(0);
+  expect(quintIn(0)).toEqual(0);
+  expect(quintIn(0.25)).toEqual(0.0009765625);
+  expect(quintIn(0.5)).toEqual(0.03125);
+  expect(quintIn(0.75)).toEqual(0.2373046875);
+  expect(quintIn(1)).toEqual(1);
+  expect(quintIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for Quint out", () => {
+  expect(quintOut(-1)).toEqual(0);
+  expect(quintOut(0)).toEqual(0);
+  expect(quintOut(0.25)).toEqual(0.7626953125);
+  expect(quintOut(0.5)).toEqual(0.96875);
+  expect(quintOut(0.75)).toEqual(0.9990234375);
+  expect(quintOut(1)).toEqual(1);
+  expect(quintOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for Quint in out", () => {
+  expect(quintInOut(-1)).toEqual(0);
+  expect(quintInOut(0)).toEqual(0);
+  expect(quintInOut(0.25)).toEqual(0.015625);
+  expect(quintInOut(0.5)).toBeCloseTo(0.5);
+  expect(quintInOut(0.75)).toEqual(0.984375);
+  expect(quintInOut(1)).toEqual(1);
+  expect(quintInOut(2)).toEqual(1);
+});
+
+// Circ
+it("Returns the proper val for Circ in", () => {
+  expect(circIn(-1)).toEqual(0);
+  expect(circIn(0)).toEqual(0);
+  expect(circIn(0.25)).toEqual(0.031754163448145745);
+  expect(circIn(0.5)).toEqual(0.1339745962155614);
+  expect(circIn(0.75)).toEqual(0.3385621722338523);
+  expect(circIn(1)).toEqual(1);
+  expect(circIn(2)).toEqual(1);
+});
+
+it("Returns the proper val for Circ out", () => {
+  expect(circOut(-1)).toEqual(0);
+  expect(circOut(0)).toEqual(0);
+  expect(circOut(0.25)).toEqual(0.6614378277661477);
+  expect(circOut(0.5)).toEqual(0.8660254037844386);
+  expect(circOut(0.75)).toEqual(0.9682458365518543);
+  expect(circOut(1)).toEqual(1);
+  expect(circOut(2)).toEqual(1);
+});
+
+it("Returns the proper val for Circ in out", () => {
+  expect(circInOut(-1)).toEqual(0);
+  expect(circInOut(0)).toEqual(0);
+  expect(circInOut(0.25)).toEqual(0.0669872981077807);
+  expect(circInOut(0.5)).toBeCloseTo(0.5);
+  expect(circInOut(0.75)).toEqual(0.9330127018922193);
+  expect(circInOut(1)).toEqual(1);
+  expect(circInOut(2)).toEqual(1);
+});