@vived/core 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/dist/cjs/Utilities/LengthConverters.js +21 -0
  2. package/dist/cjs/Utilities/LengthConverters.js.map +1 -0
  3. package/dist/cjs/Utilities/LengthConverters.test.js +24 -0
  4. package/dist/cjs/Utilities/LengthConverters.test.js.map +1 -0
  5. package/dist/cjs/Utilities/LerpNumber.js +85 -0
  6. package/dist/cjs/Utilities/LerpNumber.js.map +1 -0
  7. package/dist/cjs/Utilities/LerpNumber.test.js +90 -0
  8. package/dist/cjs/Utilities/LerpNumber.test.js.map +1 -0
  9. package/dist/cjs/Utilities/degreesToRadians.js +7 -0
  10. package/dist/cjs/Utilities/degreesToRadians.js.map +1 -0
  11. package/dist/cjs/Utilities/degreesToRadians.test.js +9 -0
  12. package/dist/cjs/Utilities/degreesToRadians.test.js.map +1 -0
  13. package/dist/cjs/Utilities/easeFunctions.js +208 -0
  14. package/dist/cjs/Utilities/easeFunctions.js.map +1 -0
  15. package/dist/cjs/Utilities/easeFunctions.test.js +209 -0
  16. package/dist/cjs/Utilities/easeFunctions.test.js.map +1 -0
  17. package/dist/cjs/Utilities/generateUniqueID.js +8 -0
  18. package/dist/cjs/Utilities/generateUniqueID.js.map +1 -0
  19. package/dist/cjs/Utilities/index.js +22 -0
  20. package/dist/cjs/Utilities/index.js.map +1 -0
  21. package/dist/cjs/Utilities/interpolateNumber.js +18 -0
  22. package/dist/cjs/Utilities/interpolateNumber.js.map +1 -0
  23. package/dist/cjs/Utilities/interpolateNumber.test.js +26 -0
  24. package/dist/cjs/Utilities/interpolateNumber.test.js.map +1 -0
  25. package/dist/cjs/index.js +1 -0
  26. package/dist/cjs/index.js.map +1 -1
  27. package/dist/esm/Utilities/LengthConverters.js +15 -0
  28. package/dist/esm/Utilities/LengthConverters.js.map +1 -0
  29. package/dist/esm/Utilities/LengthConverters.test.js +22 -0
  30. package/dist/esm/Utilities/LengthConverters.test.js.map +1 -0
  31. package/dist/esm/Utilities/LerpNumber.js +81 -0
  32. package/dist/esm/Utilities/LerpNumber.js.map +1 -0
  33. package/dist/esm/Utilities/LerpNumber.test.js +88 -0
  34. package/dist/esm/Utilities/LerpNumber.test.js.map +1 -0
  35. package/dist/esm/Utilities/degreesToRadians.js +4 -0
  36. package/dist/esm/Utilities/degreesToRadians.js.map +1 -0
  37. package/dist/esm/Utilities/degreesToRadians.test.js +7 -0
  38. package/dist/esm/Utilities/degreesToRadians.test.js.map +1 -0
  39. package/dist/esm/Utilities/easeFunctions.js +183 -0
  40. package/dist/esm/Utilities/easeFunctions.js.map +1 -0
  41. package/dist/esm/Utilities/easeFunctions.test.js +207 -0
  42. package/dist/esm/Utilities/easeFunctions.test.js.map +1 -0
  43. package/dist/esm/Utilities/generateUniqueID.js +5 -0
  44. package/dist/esm/Utilities/generateUniqueID.js.map +1 -0
  45. package/dist/esm/Utilities/index.js +6 -0
  46. package/dist/esm/Utilities/index.js.map +1 -0
  47. package/dist/esm/Utilities/interpolateNumber.js +15 -0
  48. package/dist/esm/Utilities/interpolateNumber.js.map +1 -0
  49. package/dist/esm/Utilities/interpolateNumber.test.js +24 -0
  50. package/dist/esm/Utilities/interpolateNumber.test.js.map +1 -0
  51. package/dist/esm/index.js +1 -0
  52. package/dist/esm/index.js.map +1 -1
  53. package/dist/tsconfig.cjs.tsbuildinfo +1 -1
  54. package/dist/tsconfig.esm.tsbuildinfo +1 -1
  55. package/dist/types/Utilities/LengthConverters.d.ts +5 -0
  56. package/dist/types/Utilities/LengthConverters.d.ts.map +1 -0
  57. package/dist/types/Utilities/LengthConverters.test.d.ts +2 -0
  58. package/dist/types/Utilities/LengthConverters.test.d.ts.map +1 -0
  59. package/dist/types/Utilities/LerpNumber.d.ts +57 -0
  60. package/dist/types/Utilities/LerpNumber.d.ts.map +1 -0
  61. package/dist/types/Utilities/LerpNumber.test.d.ts +2 -0
  62. package/dist/types/Utilities/LerpNumber.test.d.ts.map +1 -0
  63. package/dist/types/Utilities/degreesToRadians.d.ts +2 -0
  64. package/dist/types/Utilities/degreesToRadians.d.ts.map +1 -0
  65. package/dist/types/Utilities/degreesToRadians.test.d.ts +2 -0
  66. package/dist/types/Utilities/degreesToRadians.test.d.ts.map +1 -0
  67. package/dist/types/Utilities/easeFunctions.d.ts +24 -0
  68. package/dist/types/Utilities/easeFunctions.d.ts.map +1 -0
  69. package/dist/types/Utilities/easeFunctions.test.d.ts +2 -0
  70. package/dist/types/Utilities/easeFunctions.test.d.ts.map +1 -0
  71. package/dist/types/Utilities/generateUniqueID.d.ts +2 -0
  72. package/dist/types/Utilities/generateUniqueID.d.ts.map +1 -0
  73. package/dist/types/Utilities/index.d.ts +6 -0
  74. package/dist/types/Utilities/index.d.ts.map +1 -0
  75. package/dist/types/Utilities/interpolateNumber.d.ts +2 -0
  76. package/dist/types/Utilities/interpolateNumber.d.ts.map +1 -0
  77. package/dist/types/Utilities/interpolateNumber.test.d.ts +2 -0
  78. package/dist/types/Utilities/interpolateNumber.test.d.ts.map +1 -0
  79. package/dist/types/index.d.ts +1 -0
  80. package/dist/types/index.d.ts.map +1 -1
  81. package/package.json +6 -2
  82. package/src/Utilities/LengthConverters.test.ts +30 -0
  83. package/src/Utilities/LengthConverters.ts +18 -0
  84. package/src/Utilities/LerpNumber.test.ts +109 -0
  85. package/src/Utilities/LerpNumber.ts +109 -0
  86. package/src/Utilities/degreesToRadians.test.ts +8 -0
  87. package/src/Utilities/degreesToRadians.ts +3 -0
  88. package/src/Utilities/easeFunctions.test.ts +251 -0
  89. package/src/Utilities/easeFunctions.ts +180 -0
  90. package/src/Utilities/generateUniqueID.ts +5 -0
  91. package/src/Utilities/index.ts +6 -0
  92. package/src/Utilities/interpolateNumber.test.ts +28 -0
  93. package/src/Utilities/interpolateNumber.ts +21 -0
  94. package/src/index.ts +1 -0
@@ -0,0 +1,2 @@
1
+ export declare function degreesToRadians(deg: number): number;
2
+ //# sourceMappingURL=degreesToRadians.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"degreesToRadians.d.ts","sourceRoot":"","sources":["../../../src/Utilities/degreesToRadians.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAE,MAAM,CAEnD"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=degreesToRadians.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"degreesToRadians.test.d.ts","sourceRoot":"","sources":["../../../src/Utilities/degreesToRadians.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,24 @@
1
+ import { EaseFn } from "../Types";
2
+ export declare const easeLinear: EaseFn;
3
+ export declare const quadIn: EaseFn;
4
+ export declare const quadOut: EaseFn;
5
+ export declare const quadInOut: EaseFn;
6
+ export declare const cubicIn: EaseFn;
7
+ export declare const cubicOut: EaseFn;
8
+ export declare const cubicInOut: EaseFn;
9
+ export declare const expoIn: EaseFn;
10
+ export declare const expoOut: EaseFn;
11
+ export declare const expoInOut: EaseFn;
12
+ export declare const sinIn: EaseFn;
13
+ export declare const sinOut: EaseFn;
14
+ export declare const sinInOut: EaseFn;
15
+ export declare const quartIn: EaseFn;
16
+ export declare const quartOut: EaseFn;
17
+ export declare const quartInOut: EaseFn;
18
+ export declare const quintIn: EaseFn;
19
+ export declare const quintOut: EaseFn;
20
+ export declare const quintInOut: EaseFn;
21
+ export declare const circIn: EaseFn;
22
+ export declare const circOut: EaseFn;
23
+ export declare const circInOut: EaseFn;
24
+ //# sourceMappingURL=easeFunctions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"easeFunctions.d.ts","sourceRoot":"","sources":["../../../src/Utilities/easeFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MASvB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAWxB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,MAKnB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MASxB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MASxB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MASvB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=easeFunctions.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"easeFunctions.test.d.ts","sourceRoot":"","sources":["../../../src/Utilities/easeFunctions.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export declare function generateUniqueID(): string;
2
+ //# sourceMappingURL=generateUniqueID.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generateUniqueID.d.ts","sourceRoot":"","sources":["../../../src/Utilities/generateUniqueID.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}
@@ -0,0 +1,6 @@
1
+ export * from "./degreesToRadians";
2
+ export * from "./LengthConverters";
3
+ export * from "./generateUniqueID";
4
+ export * from "./easeFunctions";
5
+ export * from "./interpolateNumber";
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function interpolateNumber(start: number, end: number, percent: number, clamp?: boolean): number;
2
+ //# sourceMappingURL=interpolateNumber.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interpolateNumber.d.ts","sourceRoot":"","sources":["../../../src/Utilities/interpolateNumber.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,OAAe,GACrB,MAAM,CAeR"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=interpolateNumber.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interpolateNumber.test.d.ts","sourceRoot":"","sources":["../../../src/Utilities/interpolateNumber.test.ts"],"names":[],"mappings":""}
@@ -1,5 +1,6 @@
1
1
  export * from "./AppObject";
2
2
  export * from "./Entities";
3
3
  export * from "./Types";
4
+ export * from "./Utilities";
4
5
  export * from "./ValueObjects";
5
6
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
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,gBAAgB,CAAC"}
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 CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "@vived/core",
3
- "version": "1.0.1",
3
+ "version": "1.1.0",
4
4
  "description": "Core Components for VIVED Apps and Hosts",
5
5
  "main": "dist/cjs/index.js",
6
- "module": "dist/esm/index.js",
6
+ "module": "dist/esm/index.js",
7
7
  "types": "dist/types/index.d.ts",
8
8
  "exports": {
9
9
  "import": "./dist/esm/index.js",
@@ -33,6 +33,7 @@
33
33
  "homepage": "https://bitbucket.org/cyberscience3d/npm_vived_core#readme",
34
34
  "devDependencies": {
35
35
  "@types/jest": "^29.5.14",
36
+ "@types/uuid": "^10.0.0",
36
37
  "jest": "^29.7.0",
37
38
  "prettier": "^3.5.3",
38
39
  "ts-jest": "^29.2.6",
@@ -42,5 +43,8 @@
42
43
  },
43
44
  "publishConfig": {
44
45
  "access": "public"
46
+ },
47
+ "dependencies": {
48
+ "uuid": "^11.1.0"
45
49
  }
46
50
  }
@@ -0,0 +1,30 @@
1
+ import {
2
+ feetToMeters,
3
+ inchesToMeters,
4
+ metersToFeet,
5
+ metersToInches,
6
+ } from "./LengthConverters";
7
+
8
+ test("Converting inches to meters", () => {
9
+ expect(inchesToMeters(0)).toEqual(0);
10
+ expect(inchesToMeters(12)).toEqual(0.30479983540808886);
11
+ expect(inchesToMeters(-12)).toEqual(-0.30479983540808886);
12
+ });
13
+
14
+ test("Converting meters to inches", () => {
15
+ expect(metersToInches(0)).toEqual(0);
16
+ expect(metersToInches(2)).toEqual(78.7402);
17
+ expect(metersToInches(-2)).toEqual(-78.7402);
18
+ });
19
+
20
+ test("Converting feet to meters", () => {
21
+ expect(feetToMeters(0)).toEqual(0);
22
+ expect(feetToMeters(5)).toEqual(1.5239999512320015);
23
+ expect(feetToMeters(-5)).toEqual(-1.5239999512320015);
24
+ });
25
+
26
+ test("Converting meters to feet", () => {
27
+ expect(metersToFeet(0)).toEqual(0);
28
+ expect(metersToFeet(2)).toEqual(6.56168);
29
+ expect(metersToFeet(-2)).toEqual(-6.56168);
30
+ });
@@ -0,0 +1,18 @@
1
+ const inchesPerMeter = 39.3701;
2
+ const feetPerMeter = 3.28084;
3
+
4
+ export function inchesToMeters(inches: number): number {
5
+ return inches / inchesPerMeter;
6
+ }
7
+
8
+ export function metersToInches(meters: number): number {
9
+ return meters * inchesPerMeter;
10
+ }
11
+
12
+ export function feetToMeters(feet: number): number {
13
+ return feet / feetPerMeter;
14
+ }
15
+
16
+ export function metersToFeet(meters: number): number {
17
+ return meters * feetPerMeter;
18
+ }
@@ -0,0 +1,109 @@
1
+ import { LerpNumber } from "./LerpNumber";
2
+
3
+ describe("Lerp Number", () => {
4
+ let lerpNumber: LerpNumber;
5
+ let updateFn: jest.Mock;
6
+
7
+ beforeEach(() => {
8
+ lerpNumber = new LerpNumber();
9
+ updateFn = jest.fn();
10
+ jest.useFakeTimers();
11
+ });
12
+
13
+ afterEach(() => {
14
+ jest.useRealTimers();
15
+ });
16
+
17
+ it("should lerp from start to end value", async () => {
18
+ lerpNumber.defaultDurationMS = 1000;
19
+ const promise = lerpNumber.lerp({
20
+ start: 0,
21
+ end: 100,
22
+ update: updateFn,
23
+ });
24
+
25
+ // Test middle point (should have multiple updates by this point)
26
+ jest.advanceTimersByTime(500);
27
+ expect(updateFn).toHaveBeenCalledWith(expect.closeTo(50, 5)); // Allow some margin due to interval timing
28
+
29
+ // Complete animation
30
+ jest.advanceTimersByTime(500);
31
+ await promise;
32
+
33
+ expect(updateFn).toHaveBeenCalledWith(0); // Start value
34
+ expect(updateFn).toHaveBeenLastCalledWith(100); // End value
35
+ });
36
+
37
+ it("should cancel lerp when requested", async () => {
38
+ const onCancel = jest.fn();
39
+ const promise = lerpNumber.lerp({
40
+ start: 0,
41
+ end: 100,
42
+ update: updateFn,
43
+ onCancel,
44
+ });
45
+
46
+ expect(lerpNumber.isLerping).toBe(true);
47
+
48
+ lerpNumber.cancel();
49
+ jest.advanceTimersByTime(10); // Allow interval to execute
50
+ await promise;
51
+
52
+ expect(lerpNumber.isLerping).toBe(false);
53
+ expect(onCancel).toHaveBeenCalled();
54
+ });
55
+
56
+ it("should respect custom duration", async () => {
57
+ const promise = lerpNumber.lerp({
58
+ start: 0,
59
+ end: 100,
60
+ update: updateFn,
61
+ durationMS: 500,
62
+ });
63
+
64
+ jest.advanceTimersByTime(250); // Half way
65
+ expect(updateFn).toHaveBeenLastCalledWith(expect.any(Number));
66
+
67
+ jest.advanceTimersByTime(250); // Complete
68
+ await promise;
69
+
70
+ expect(updateFn).toHaveBeenLastCalledWith(100);
71
+ });
72
+
73
+ it("should call onComplete when finished", async () => {
74
+ const onComplete = jest.fn();
75
+ const promise = lerpNumber.lerp({
76
+ start: 0,
77
+ end: 100,
78
+ update: updateFn,
79
+ onComplete,
80
+ });
81
+
82
+ jest.advanceTimersByTime(1000);
83
+ await promise;
84
+
85
+ expect(onComplete).toHaveBeenCalled();
86
+ });
87
+
88
+ it("should cancel existing lerp when starting a new one", async () => {
89
+ const onCancel = jest.fn();
90
+ const firstPromise = lerpNumber.lerp({
91
+ start: 0,
92
+ end: 100,
93
+ update: updateFn,
94
+ onCancel,
95
+ });
96
+
97
+ const secondPromise = lerpNumber.lerp({
98
+ start: 200,
99
+ end: 300,
100
+ update: updateFn,
101
+ });
102
+
103
+ jest.advanceTimersByTime(1000);
104
+ await Promise.all([firstPromise, secondPromise]);
105
+
106
+ expect(onCancel).toHaveBeenCalled();
107
+ expect(updateFn).toHaveBeenLastCalledWith(300);
108
+ });
109
+ });
@@ -0,0 +1,109 @@
1
+ import { EaseFn } from "../Types";
2
+ import { quintInOut } from "./easeFunctions";
3
+
4
+ /**
5
+ * Configuration object for performing a linear interpolation (lerp) operation.
6
+ * @interface LerpNumberDTO
7
+ */
8
+ export interface LerpNumberDTO {
9
+ /** Starting value of the lerp */
10
+ start: number;
11
+ /** Target/ending value of the lerp */
12
+ end: number;
13
+ /** Callback function that receives the interpolated value on each update */
14
+ update: (value: number) => void;
15
+ /** Duration of the lerp in milliseconds. Defaults to LerpNumber.defaultDurationMS */
16
+ durationMS?: number;
17
+ /** Easing function to modify the interpolation curve. Defaults to LerpNumber.defaultEase */
18
+ ease?: EaseFn;
19
+ /** Optional callback function called when lerp completes naturally */
20
+ onComplete?: () => void;
21
+ /** Optional callback function called when lerp is cancelled */
22
+ onCancel?: () => void;
23
+ }
24
+
25
+ /**
26
+ * Utility class for smoothly interpolating between two numbers over time.
27
+ * Uses requestAnimationFrame for smooth animation and supports custom easing functions.
28
+ *
29
+ * @example
30
+ * const lerper = new LerpNumber();
31
+ * // Animate from 0 to 100 over 2 seconds
32
+ * await lerper.lerp({
33
+ * start: 0,
34
+ * end: 100,
35
+ * durationMS: 2000,
36
+ * update: (value) => console.log(value)
37
+ * });
38
+ */
39
+ export class LerpNumber {
40
+ public defaultDurationMS = 1000;
41
+ public defaultEase: EaseFn = quintInOut;
42
+
43
+ public get isLerping() {
44
+ return this._isLerping;
45
+ }
46
+ private _isLerping = false;
47
+
48
+ /**
49
+ * Cancels the current lerp operation if one is in progress.
50
+ * Triggers the onCancel callback if provided in the original lerp configuration.
51
+ */
52
+ public cancel() {
53
+ if (!this._isLerping) return;
54
+
55
+ this._cancelLerp = true;
56
+ }
57
+
58
+ private _cancelLerp = false;
59
+
60
+ /**
61
+ * Initiates a lerp (linear interpolation) operation.
62
+ * If a lerp is already in progress, it will be cancelled before starting the new one.
63
+ *
64
+ * @param data - Configuration object for the lerp operation
65
+ * @returns Promise that resolves when the lerp completes or is cancelled
66
+ * @throws Never throws, but may reject if the update function throws
67
+ */
68
+ lerp = (data: LerpNumberDTO): Promise<void> => {
69
+ if (this._isLerping) {
70
+ this.cancel();
71
+ }
72
+ const { start, end, durationMS, ease, onComplete, update, onCancel } = data;
73
+
74
+ const durationToUse = durationMS ?? this.defaultDurationMS;
75
+ const easeToUse = ease ?? this.defaultEase;
76
+
77
+ return new Promise((resolve) => {
78
+ const startTime = performance.now();
79
+ this._isLerping = true;
80
+
81
+ update(start);
82
+
83
+ const interval = setInterval(() => {
84
+ if (this._cancelLerp) {
85
+ clearInterval(interval);
86
+ this._isLerping = false;
87
+ this._cancelLerp = false;
88
+ if (onCancel) onCancel();
89
+ return resolve();
90
+ }
91
+
92
+ const currentTime = performance.now();
93
+ const elapsedTime = currentTime - startTime;
94
+ const progress = Math.min(elapsedTime / durationToUse, 1);
95
+ const easedProgress = easeToUse(progress);
96
+ const value = start + (end - start) * easedProgress;
97
+ update(value);
98
+
99
+ if (progress >= 1) {
100
+ clearInterval(interval);
101
+ this._isLerping = false;
102
+ update(end);
103
+ if (onComplete) onComplete();
104
+ resolve();
105
+ }
106
+ }, 10);
107
+ });
108
+ };
109
+ }
@@ -0,0 +1,8 @@
1
+ import { degreesToRadians } from "./degreesToRadians"
2
+
3
+ test("Converting degrees to radians", ()=>{
4
+ expect(degreesToRadians(0)).toEqual(0);
5
+ expect(degreesToRadians(180)).toBeCloseTo(Math.PI);
6
+ expect(degreesToRadians(-90)).toBeCloseTo(-Math.PI/2);
7
+ })
8
+
@@ -0,0 +1,3 @@
1
+ export function degreesToRadians(deg: number):number{
2
+ return deg * Math.PI / 180;
3
+ }
@@ -0,0 +1,251 @@
1
+ import {
2
+ easeLinear,
3
+ quadIn,
4
+ quadInOut,
5
+ quadOut,
6
+ cubicIn,
7
+ cubicInOut,
8
+ cubicOut,
9
+ expoIn,
10
+ expoInOut,
11
+ expoOut,
12
+ sinIn,
13
+ sinInOut,
14
+ sinOut,
15
+ quartIn,
16
+ quartInOut,
17
+ quartOut,
18
+ quintIn,
19
+ quintInOut,
20
+ quintOut,
21
+ circIn,
22
+ circInOut,
23
+ circOut,
24
+ } from "./easeFunctions";
25
+
26
+ it("Returns the proper values for ease linear", () => {
27
+ expect(easeLinear(-1)).toEqual(0);
28
+ expect(easeLinear(0)).toEqual(0);
29
+ expect(easeLinear(0.25)).toEqual(0.25);
30
+ expect(easeLinear(0.5)).toEqual(0.5);
31
+ expect(easeLinear(0.75)).toEqual(0.75);
32
+ expect(easeLinear(1)).toEqual(1);
33
+ expect(easeLinear(2)).toEqual(1);
34
+ });
35
+
36
+ // Quad
37
+ it("Returns the proper val for quad in", () => {
38
+ expect(quadIn(-1)).toEqual(0);
39
+ expect(quadIn(0)).toEqual(0);
40
+ expect(quadIn(0.25)).toEqual(0.0625);
41
+ expect(quadIn(0.5)).toEqual(0.25);
42
+ expect(quadIn(0.75)).toEqual(0.5625);
43
+ expect(quadIn(1)).toEqual(1);
44
+ expect(quadIn(2)).toEqual(1);
45
+ });
46
+
47
+ it("Returns the proper val for quad out", () => {
48
+ expect(quadOut(-1)).toEqual(0);
49
+ expect(quadOut(0)).toEqual(0);
50
+ expect(quadOut(0.25)).toEqual(0.4375);
51
+ expect(quadOut(0.5)).toEqual(0.75);
52
+ expect(quadOut(0.75)).toEqual(0.9375);
53
+ expect(quadOut(1)).toEqual(1);
54
+ expect(quadOut(2)).toEqual(1);
55
+ });
56
+
57
+ it("Returns the proper val for quad in out", () => {
58
+ expect(quadInOut(-1)).toEqual(0);
59
+ expect(quadInOut(0)).toEqual(0);
60
+ expect(quadInOut(0.25)).toEqual(0.125);
61
+ expect(quadInOut(0.5)).toEqual(0.5);
62
+ expect(quadInOut(0.75)).toEqual(0.875);
63
+ expect(quadInOut(1)).toEqual(1);
64
+ expect(quadInOut(2)).toEqual(1);
65
+ });
66
+
67
+ // Cubic
68
+ it("Returns the proper val for cubic in", () => {
69
+ expect(cubicIn(-1)).toEqual(0);
70
+ expect(cubicIn(0)).toEqual(0);
71
+ expect(cubicIn(0.25)).toEqual(0.015625);
72
+ expect(cubicIn(0.5)).toEqual(0.125);
73
+ expect(cubicIn(0.75)).toEqual(0.421875);
74
+ expect(cubicIn(1)).toEqual(1);
75
+ expect(cubicIn(2)).toEqual(1);
76
+ });
77
+
78
+ it("Returns the proper val for cubic out", () => {
79
+ expect(cubicOut(-1)).toEqual(0);
80
+ expect(cubicOut(0)).toEqual(0);
81
+ expect(cubicOut(0.25)).toEqual(0.578125);
82
+ expect(cubicOut(0.5)).toEqual(0.875);
83
+ expect(cubicOut(0.75)).toEqual(0.984375);
84
+ expect(cubicOut(1)).toEqual(1);
85
+ expect(cubicOut(2)).toEqual(1);
86
+ });
87
+
88
+ it("Returns the proper val for cubic in out", () => {
89
+ expect(cubicInOut(-1)).toEqual(0);
90
+ expect(cubicInOut(0)).toEqual(0);
91
+ expect(cubicInOut(0.25)).toEqual(0.0625);
92
+ expect(cubicInOut(0.5)).toEqual(0.5);
93
+ expect(cubicInOut(0.75)).toEqual(0.9375);
94
+ expect(cubicInOut(1)).toEqual(1);
95
+ expect(cubicInOut(2)).toEqual(1);
96
+ });
97
+
98
+ // Expo
99
+ it("Returns the proper val for Expo in", () => {
100
+ expect(expoIn(-1)).toEqual(0);
101
+ expect(expoIn(0)).toEqual(0);
102
+ expect(expoIn(0.25)).toEqual(0.005524271728019902);
103
+ expect(expoIn(0.5)).toEqual(0.03125);
104
+ expect(expoIn(0.75)).toEqual(0.17677669529663687);
105
+ expect(expoIn(1)).toEqual(1);
106
+ expect(expoIn(2)).toEqual(1);
107
+ });
108
+
109
+ it("Returns the proper val for Expo out", () => {
110
+ expect(expoOut(-1)).toEqual(0);
111
+ expect(expoOut(0)).toEqual(0);
112
+ expect(expoOut(0.25)).toEqual(0.8232233047033631);
113
+ expect(expoOut(0.5)).toEqual(0.96875);
114
+ expect(expoOut(0.75)).toEqual(0.99447572827198);
115
+ expect(expoOut(1)).toEqual(1);
116
+ expect(expoOut(2)).toEqual(1);
117
+ });
118
+
119
+ it("Returns the proper val for Expo in out", () => {
120
+ expect(expoInOut(-1)).toEqual(0);
121
+ expect(expoInOut(0)).toEqual(0);
122
+ expect(expoInOut(0.25)).toEqual(0.015625);
123
+ expect(expoInOut(0.5)).toEqual(0.5);
124
+ expect(expoInOut(0.75)).toEqual(0.984375);
125
+ expect(expoInOut(1)).toEqual(1);
126
+ expect(expoInOut(2)).toEqual(1);
127
+ });
128
+
129
+ // Sin
130
+ it("Returns the proper val for Sin in", () => {
131
+ expect(sinIn(-1)).toEqual(0);
132
+ expect(sinIn(0)).toEqual(0);
133
+ expect(sinIn(0.25)).toEqual(0.07612046748871326);
134
+ expect(sinIn(0.5)).toEqual(0.2928932188134524);
135
+ expect(sinIn(0.75)).toEqual(0.6173165676349102);
136
+ expect(sinIn(1)).toEqual(1);
137
+ expect(sinIn(2)).toEqual(1);
138
+ });
139
+
140
+ it("Returns the proper val for Sin out", () => {
141
+ expect(sinOut(-1)).toEqual(0);
142
+ expect(sinOut(0)).toEqual(0);
143
+ expect(sinOut(0.25)).toEqual(0.3826834323650898);
144
+ expect(sinOut(0.5)).toEqual(0.7071067811865475);
145
+ expect(sinOut(0.75)).toEqual(0.9238795325112867);
146
+ expect(sinOut(1)).toEqual(1);
147
+ expect(sinOut(2)).toEqual(1);
148
+ });
149
+
150
+ it("Returns the proper val for Sin in out", () => {
151
+ expect(sinInOut(-1)).toEqual(0);
152
+ expect(sinInOut(0)).toEqual(0);
153
+ expect(sinInOut(0.25)).toEqual(0.1464466094067262);
154
+ expect(sinInOut(0.5)).toBeCloseTo(0.5);
155
+ expect(sinInOut(0.75)).toEqual(0.8535533905932737);
156
+ expect(sinInOut(1)).toEqual(1);
157
+ expect(sinInOut(2)).toEqual(1);
158
+ });
159
+
160
+ // Quart
161
+ it("Returns the proper val for Quart in", () => {
162
+ expect(quartIn(-1)).toEqual(0);
163
+ expect(quartIn(0)).toEqual(0);
164
+ expect(quartIn(0.25)).toEqual(0.00390625);
165
+ expect(quartIn(0.5)).toEqual(0.0625);
166
+ expect(quartIn(0.75)).toEqual(0.31640625);
167
+ expect(quartIn(1)).toEqual(1);
168
+ expect(quartIn(2)).toEqual(1);
169
+ });
170
+
171
+ it("Returns the proper val for Quart out", () => {
172
+ expect(quartOut(-1)).toEqual(0);
173
+ expect(quartOut(0)).toEqual(0);
174
+ expect(quartOut(0.25)).toEqual(0.68359375);
175
+ expect(quartOut(0.5)).toEqual(0.9375);
176
+ expect(quartOut(0.75)).toEqual(0.99609375);
177
+ expect(quartOut(1)).toEqual(1);
178
+ expect(quartOut(2)).toEqual(1);
179
+ });
180
+
181
+ it("Returns the proper val for Quart in out", () => {
182
+ expect(quartInOut(-1)).toEqual(0);
183
+ expect(quartInOut(0)).toEqual(0);
184
+ expect(quartInOut(0.25)).toEqual(0.03125);
185
+ expect(quartInOut(0.5)).toBeCloseTo(0.5);
186
+ expect(quartInOut(0.75)).toEqual(0.96875);
187
+ expect(quartInOut(1)).toEqual(1);
188
+ expect(quartInOut(2)).toEqual(1);
189
+ });
190
+
191
+ // Quint
192
+ it("Returns the proper val for Quint in", () => {
193
+ expect(quintIn(-1)).toEqual(0);
194
+ expect(quintIn(0)).toEqual(0);
195
+ expect(quintIn(0.25)).toEqual(0.0009765625);
196
+ expect(quintIn(0.5)).toEqual(0.03125);
197
+ expect(quintIn(0.75)).toEqual(0.2373046875);
198
+ expect(quintIn(1)).toEqual(1);
199
+ expect(quintIn(2)).toEqual(1);
200
+ });
201
+
202
+ it("Returns the proper val for Quint out", () => {
203
+ expect(quintOut(-1)).toEqual(0);
204
+ expect(quintOut(0)).toEqual(0);
205
+ expect(quintOut(0.25)).toEqual(0.7626953125);
206
+ expect(quintOut(0.5)).toEqual(0.96875);
207
+ expect(quintOut(0.75)).toEqual(0.9990234375);
208
+ expect(quintOut(1)).toEqual(1);
209
+ expect(quintOut(2)).toEqual(1);
210
+ });
211
+
212
+ it("Returns the proper val for Quint in out", () => {
213
+ expect(quintInOut(-1)).toEqual(0);
214
+ expect(quintInOut(0)).toEqual(0);
215
+ expect(quintInOut(0.25)).toEqual(0.015625);
216
+ expect(quintInOut(0.5)).toBeCloseTo(0.5);
217
+ expect(quintInOut(0.75)).toEqual(0.984375);
218
+ expect(quintInOut(1)).toEqual(1);
219
+ expect(quintInOut(2)).toEqual(1);
220
+ });
221
+
222
+ // Circ
223
+ it("Returns the proper val for Circ in", () => {
224
+ expect(circIn(-1)).toEqual(0);
225
+ expect(circIn(0)).toEqual(0);
226
+ expect(circIn(0.25)).toEqual(0.031754163448145745);
227
+ expect(circIn(0.5)).toEqual(0.1339745962155614);
228
+ expect(circIn(0.75)).toEqual(0.3385621722338523);
229
+ expect(circIn(1)).toEqual(1);
230
+ expect(circIn(2)).toEqual(1);
231
+ });
232
+
233
+ it("Returns the proper val for Circ out", () => {
234
+ expect(circOut(-1)).toEqual(0);
235
+ expect(circOut(0)).toEqual(0);
236
+ expect(circOut(0.25)).toEqual(0.6614378277661477);
237
+ expect(circOut(0.5)).toEqual(0.8660254037844386);
238
+ expect(circOut(0.75)).toEqual(0.9682458365518543);
239
+ expect(circOut(1)).toEqual(1);
240
+ expect(circOut(2)).toEqual(1);
241
+ });
242
+
243
+ it("Returns the proper val for Circ in out", () => {
244
+ expect(circInOut(-1)).toEqual(0);
245
+ expect(circInOut(0)).toEqual(0);
246
+ expect(circInOut(0.25)).toEqual(0.0669872981077807);
247
+ expect(circInOut(0.5)).toBeCloseTo(0.5);
248
+ expect(circInOut(0.75)).toEqual(0.9330127018922193);
249
+ expect(circInOut(1)).toEqual(1);
250
+ expect(circInOut(2)).toEqual(1);
251
+ });