@futdevpro/fsm-dynamo 1.10.37 → 1.10.39

package/build/_collections/utils/math/math.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/math.util.ts"],"names":[],"mappings":"AASA,qBAAa,SAAS;IAEpB,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAIlF,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpE,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrD,MAAM,CAAC,QAAQ,CAAC,OAAO,yBAAc;IACrC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM;IAUzD,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1C,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAY5C,MAAM,CAAC,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrD,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAQlD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM;CAO5D"}
+{"version":3,"file":"math.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/math.util.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,SAAS;IAEpB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAIlF;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrD,MAAM,CAAC,QAAQ,CAAC,OAAO,yBAAc;IACrC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM;IAUzD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1C;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAY5C;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrD;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAQlD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM;CAO5D"}

package/build/_collections/utils/math/math.util.js

@@ -1,17 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_Math = void 0;
+/**
+ * this class is a collection of static methods for mathematical operations
+ */
 class DyFM_Math {
+    /**
+     * returns true if the value is between the min and max
+     */
     static between(value, minExclusive, maxExclusive) {
         return minExclusive < value && value < maxExclusive;
     }
+    /**
+     * returns true if the value is between the target and the range
+     */
     static around(value, target, range) {
         return this.between(value, target - range, target + range);
     }
+    /**
+     * returns a random integer between the min and max
+     */
     static getRandomInt(min, max) {
         return min + Math.round((max - min) * Math.random());
     }
     static toFixed = this.round;
+    /**
+     * returns a number rounded to the specified number of decimals
+     */
     static round(value, decimals = 2) {
         if (0 <= decimals) {
             return Number(value.toFixed(decimals));
@@ -21,9 +36,15 @@ class DyFM_Math {
             return Math.round(value / factor) * factor;
         }
     }
+    /**
+     * returns a number with spaces between the thousands
+     */
     static numberWithSpaces(x) {
         return x?.toString()?.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
     }
+    /**
+     * returns a number with shorter units
+     */
     static numberWithShorters(x) {
         if (x < 1000) {
             return x?.toString();
@@ -38,14 +59,23 @@ class DyFM_Math {
             return (x / 1000000000)?.toFixed(3) + 'B';
         }
     }
+    /**
+     * returns a number with shorter units and spaces between the thousands
+     */
     static numberWithShortersAndSpaces(x) {
         return this.numberWithShorters(x)?.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
     }
+    /**
+     * returns a number with spaces between the thousands
+     */
     static floatingNumberWithSpaces(x) {
         const parts = x?.toString()?.split('.');
         parts[0] = parts?.[0]?.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
         return parts?.join('.');
     }
+    /**
+     * returns a number with spaces between the thousands
+     */
     static decimals(x, useSpacer = ',') {
         const parts = x?.toString()?.split('.');
         parts[0] = parts?.[0]?.replace(/\B(?=(\d{3})+(?!\d))/g, useSpacer);

package/build/_collections/utils/math/math.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.util.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/math.util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"math.util.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/math.util.ts"],"names":[],"mappings":"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"}

package/build/_collections/utils/math/random.util.d.ts

@@ -1,8 +1,25 @@
 import { DyFM_RandomWeight } from '../../../_models/interfaces/random-weight.interface';
+/**
+ * this class is a collection of static methods for random operations
+ */
 export declare class DyFM_Random {
+    /**
+     * returns a random weighted integer between the min and max
+     */
     static getRandomWeightedInt(min: number, max: number, weights: DyFM_RandomWeight<number>[]): number;
     static getRandomInt(min: number, max: number): number;
-    static getRandomListElement<T>(list: T[]): T;
-    static getRandomWeighted<T>(weights: DyFM_RandomWeight<T>[]): T;
+    /**
+     * returns null if list is empty
+     * @param list
+     * @returns
+     */
+    static getRandomListElement<T>(list: T[]): T | null;
+    /**
+     * returns a random weighted element from the list
+     * (returns null if list is empty)
+     * @param weights
+     * @returns
+     */
+    static getRandomWeighted<T>(weights: DyFM_RandomWeight<T>[]): T | null;
 }
 //# sourceMappingURL=random.util.d.ts.map

package/build/_collections/utils/math/random.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"random.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/random.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAExF,qBAAa,WAAW;IACtB,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,GACnC,MAAM;IA6BT,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrD,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC;IAQ5C,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;CA6BhE"}
+{"version":3,"file":"random.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/random.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAGxF;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,GACnC,MAAM;IA6BT,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrD;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IAQnD;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;CAkCvE"}

package/build/_collections/utils/math/random.util.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_Random = void 0;
+const log_util_1 = require("../log.util");
+/**
+ * this class is a collection of static methods for random operations
+ */
 class DyFM_Random {
+    /**
+     * returns a random weighted integer between the min and max
+     */
     static getRandomWeightedInt(min, max, weights) {
         weights = weights.sort((a, b) => b.chance - a.chance);
         let weightChanceSum = 0;
@@ -28,6 +35,11 @@ class DyFM_Random {
     static getRandomInt(min, max) {
         return min + Math.round((max - min) * Math.random());
     }
+    /**
+     * returns null if list is empty
+     * @param list
+     * @returns
+     */
     static getRandomListElement(list) {
         if (0 < list.length) {
             return list[this.getRandomInt(0, list.length - 1)];
@@ -36,6 +48,12 @@ class DyFM_Random {
             return null;
         }
     }
+    /**
+     * returns a random weighted element from the list
+     * (returns null if list is empty)
+     * @param weights
+     * @returns
+     */
     static getRandomWeighted(weights) {
         if (!weights?.length) {
             return null;
@@ -57,6 +75,10 @@ class DyFM_Random {
                 result = weights[i].result;
             }
         }
+        if (result === undefined) {
+            log_util_1.DyFM_Log.error('DyFM_Random failed to get a random weighted element from the list');
+            return null;
+        }
         return result;
     }
 }

package/build/_collections/utils/math/random.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"random.util.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/random.util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"random.util.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/random.util.ts"],"names":[],"mappings":"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"}

package/build/_collections/utils/math/random.util.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"random.util.spec.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/random.util.spec.ts"],"names":[],"mappings":";;AACA,+CAA4C;AAG5C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,MAAM,OAAO,GAAgC;gBAC3C,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC1B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC1B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;aAC3B,CAAC;YACF,MAAM,MAAM,GAAG,yBAAW,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,OAAO,GAAgC;gBAC3C,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC1B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC1B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;aAC3B,CAAC;YACF,MAAM,MAAM,GAAG,yBAAW,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;YAC/E,MAAM,OAAO,GAAgC;gBAC3C,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;gBACxB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;gBACxB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;aACzB,CAAC;YACF,MAAM,MAAM,GAAG,yBAAW,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,MAAM,GAAG,GAAG,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,yBAAW,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,yBAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,yBAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,OAAO,GAAgC;gBAC3C,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;gBAC5B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;gBAC5B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;aAC7B,CAAC;YACF,MAAM,MAAM,GAAG,yBAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,OAAO,GAAgC,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,yBAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"random.util.spec.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/random.util.spec.ts"],"names":[],"mappings":"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"}

package/build/_collections/utils/math/vector2.util.d.ts

@@ -26,69 +26,191 @@ export declare class DyFM_Vector2_Util implements DyFM_Vector2 {
     get y(): number;
     private _magintude;
     get magintude(): number;
+    /**
+     * zero vector
+     */
     static readonly zero: DyFM_Vector2;
+    /**
+     * up vector
+     */
     static readonly up: DyFM_Vector2;
+    /**
+     * down vector
+     */
     static readonly down: DyFM_Vector2;
+    /**
+     * right vector
+     */
     static readonly right: DyFM_Vector2;
+    /**
+     * left vector
+     */
     static readonly left: DyFM_Vector2;
     constructor(xOrXyOrVector?: number | DyFM_Vector2, y?: number);
+    /**
+     * returns true if the vector is constructed
+     */
     constructed?(): boolean;
+    /**
+     * returns the distance between two vectors
+     */
     static distance(a: DyFM_Vector2, b: DyFM_Vector2): number;
-    distance?(to: DyFM_Vector2): number;
+    distance(to: DyFM_Vector2): number;
+    /**
+     * returns a new vector with the negative values of the original vector
+     */
     static minus(a: DyFM_Vector2, minusB: DyFM_Vector2): DyFM_Vector2_Util;
-    minus?(vector: DyFM_Vector2): this;
+    minus(vector: DyFM_Vector2): this;
+    /**
+     * returns a new vector with the sum of two vectors
+     */
     static plus(a: DyFM_Vector2, plusB: DyFM_Vector2): DyFM_Vector2_Util;
-    plus?(vector: DyFM_Vector2): this;
+    plus(vector: DyFM_Vector2): this;
     static readonly add: typeof DyFM_Vector2_Util.plus;
-    readonly add?: (vector: DyFM_Vector2) => this;
+    readonly add: (vector: DyFM_Vector2) => this;
     /** returns new multiplied Vector2 */
     static multiply(v: DyFM_Vector2, n: number): DyFM_Vector2_Util;
-    multiply?(n: number): this;
+    multiply(n: number): this;
     /** returns new divided Vector2 */
     static divide(v: DyFM_Vector2, divideBy: number): DyFM_Vector2_Util;
-    divide?(n: number): this;
+    divide(n: number): this;
     static negative(v: DyFM_Vector2): DyFM_Vector2_Util;
     /** this returns a new instance */
-    getNegative?(): DyFM_Vector2_Util;
-    negate?(): this;
+    getNegative(): DyFM_Vector2_Util;
+    negate(): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
     static rebase(v: DyFM_Vector2, baseFrom: DyFM_Vector2, baseTo: DyFM_Vector2): DyFM_Vector2_Util;
-    rebase?(baseFrom: DyFM_Vector2, baseTo: DyFM_Vector2): this;
+    rebase(baseFrom: DyFM_Vector2, baseTo: DyFM_Vector2): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
     static rotate(vector: DyFM_Vector2, angle: number): DyFM_Vector2_Util;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
     static rotateRad(vector: DyFM_Vector2, rad: number): DyFM_Vector2_Util;
-    rotate?(angle: number): this;
-    rotateRad?(rad: number): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
+    rotate(angle: number): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
+    rotateRad(rad: number): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
     newValues(newV: DyFM_Vector2): this;
-    newXY?(newX: number, newY: number): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
+    newXY(newX: number, newY: number): this;
+    /**
+     * returns a new vector with the sum of a vector and the difference of two vectors
+     */
+    static newValues(to: DyFM_Vector2, newV: DyFM_Vector2): DyFM_Vector2;
+    static readonly newXY: typeof DyFM_Vector2_Util.newValues;
+    /**
+     * returns the angle between two vectors
+     */
     static angle(from: DyFM_Vector2, to: DyFM_Vector2): number;
+    /**
+     * returns the angle between two vectors in radians
+     */
     static angleRad(from: DyFM_Vector2, to: DyFM_Vector2): number;
-    angle?(from: DyFM_Vector2, to: DyFM_Vector2): number;
+    /**
+     * returns the angle between two vectors
+     */
+    angle(from: DyFM_Vector2, to: DyFM_Vector2): number;
+    /**
+     * returns the angle between two vectors in degrees
+     */
     static deg(vector: DyFM_Vector2): number;
+    /**
+     * returns the angle between two vectors in radians
+     */
     static rad(vector: DyFM_Vector2): number;
-    deg?(): number;
+    /**
+     * returns the angle between two vectors in degrees
+     */
+    deg(): number;
+    /**
+     * returns math floor of the vector
+     */
     static floor(v: DyFM_Vector2): DyFM_Vector2_Util;
-    floor?(): DyFM_Vector2_Util;
+    /**
+     * returns math floor of the vector
+     */
+    floor(): DyFM_Vector2_Util;
+    /**
+     * returns the direction vector from one point to another
+     */
     static direction(from: DyFM_Vector2, to: DyFM_Vector2): DyFM_Vector2_Util;
-    direction?(to: DyFM_Vector2): DyFM_Vector2_Util;
+    /**
+     * returns the direction vector from one point to another
+     */
+    direction(to: DyFM_Vector2): DyFM_Vector2_Util;
+    /**
+     * returns a normalized vector
+     */
     static normalize(v: DyFM_Vector2): DyFM_Vector2_Util;
-    normalize?(): void;
+    /**
+     * returns a normalized vector
+     */
+    normalize(): void;
     /**
      * this will return a new instance,
      * if you want to change the current instance, use normalize()
     */
-    normalized?(): DyFM_Vector2_Util;
+    normalized(): DyFM_Vector2_Util;
+    /**
+     * returns the magnitude of the vector
+     */
     private calcMagnitude;
-    clone?(): DyFM_Vector2_Util;
+    /**
+     * returns a new vector with the same values
+     */
+    clone(): DyFM_Vector2_Util;
+    /**
+     * returns true if the vector has changed
+     */
     static isChanged(a: DyFM_Vector2_Util, b: DyFM_Vector2_Util): boolean;
+    /**
+     * returns true if the vectors are equal
+     */
     static isEqual(a: DyFM_Vector2, b: DyFM_Vector2): boolean;
+    /**
+     * returns true if the vectors are equal
+     */
     static vectorChanged(a: DyFM_Vector2, b: DyFM_Vector2): boolean;
+    /**
+     * returns true if the vectors are equal
+     */
     static equals(a: DyFM_Vector2, b: DyFM_Vector2): boolean;
+    /**
+     * returns a new vector with the absolute values of the original vector
+     */
     static abs(v: DyFM_Vector2): DyFM_Vector2_Util;
-    abs?(): this;
+    abs(): this;
+    /**
+     * returns a new vector with the rounded values of the original vector
+     */
     static round(v: DyFM_Vector2, decimals?: number): DyFM_Vector2_Util;
+    /**
+     * returns a instance of DyFM_Vector2 from a DyFM_Vector2_Util
+     */
     static toVector2(v: DyFM_Vector2_Util): DyFM_Vector2;
+    /**
+     * returns a instance of DyFM_Vector2 from a DyFM_Vector2_Util
+     */
     get(): DyFM_Vector2;
     getVector2: () => DyFM_Vector2;
     toVector2: () => DyFM_Vector2;
+    /**
+     * returns a new vector with the same values
+     */
     static clone(v: DyFM_Vector2): DyFM_Vector2;
 }
 //# sourceMappingURL=vector2.util.d.ts.map

package/build/_collections/utils/math/vector2.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector2.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/vector2.util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vector2.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/vector2.util.ts"],"names":[],"mappings":"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"}