@futdevpro/fsm-dynamo 1.14.10 → 1.14.12

package/build/_collections/utils/math/box-bounds.util.js

@@ -7,9 +7,15 @@ const vector2_util_1 = require("./vector2.util");
  * is that static functions return new BoxBounds,
  * while instance functions change the current BoxBounds and returns itself.
  * (if this is not true, report it as a bug)
+ *
+ * @example
+ * ```ts
+ * const boxBounds = new DyFM_BoxBounds_Util({ x: 0, y: 0 }, { x: 10, y: 10 });
+ * boxBounds.pos = { x: 5, y: 5 };
+ * console.log(boxBounds.pos);
+ * ```
  */
 class DyFM_BoxBounds_Util {
-    _pos;
     /**
      * setting the position will also recalculate the center and centerMargin
      */
@@ -23,7 +29,6 @@ class DyFM_BoxBounds_Util {
     get pos() {
         return this._pos;
     }
-    _size;
     /**
      * setting the size will also recalculate the center and centerMargin
      */
@@ -37,7 +42,6 @@ class DyFM_BoxBounds_Util {
     get size() {
         return this._size;
     }
-    _center;
     /**
      * getting the center will return the center as a DyFM_Vector2_Util
      * (this is calculated from the position and size every time they are set)
@@ -45,7 +49,6 @@ class DyFM_BoxBounds_Util {
     get center() {
         return this._center;
     }
-    _centerMargin;
     /**
      * getting the centerMargin will return the centerMargin as a DyFM_Vector2_Util
      * (this is calculated from the size every time it is set)
@@ -58,6 +61,8 @@ class DyFM_BoxBounds_Util {
     position, 
     /** height and width */
     size) {
+        this.getBoxBounds = this.get;
+        this.toBoxBounds = this.get;
         this._pos = new vector2_util_1.DyFM_Vector2_Util(position);
         this._size = new vector2_util_1.DyFM_Vector2_Util(size);
         this.calcCenter();
@@ -71,6 +76,12 @@ class DyFM_BoxBounds_Util {
     /**
      * sets the position and size of the box bounds
      * (this will also recalculate the center and centerMargin)
+     *
+     * @example
+     * ```ts
+     * const boxBounds = new DyFM_BoxBounds_Util({ x: 0, y: 0 }, { x: 10, y: 10 });
+     * boxBounds.newValues({ x: 5, y: 5 }, { x: 20, y: 20 });
+     * ```
      */
     newValues(position, size) {
         if (position === undefined) {
@@ -85,6 +96,14 @@ class DyFM_BoxBounds_Util {
     }
     /**
      * returns true if the position is within the box bounds
+     *
+     * @example
+     * ```ts
+     * const boxBounds = new DyFM_BoxBounds_Util({ x: 0, y: 0 }, { x: 10, y: 10 });
+     * const position = new DyFM_Vector2({ x: 5, y: 5 });
+     * const isWithinBounds = DyFM_BoxBounds_Util.bounds(boxBounds, position);
+     * console.log(isWithinBounds);
+     * ```
      */
     static bounds(box, position) {
         return box.pos.x <= position.x && position.x <= box.pos.x + box.size.x &&
@@ -92,12 +111,21 @@ class DyFM_BoxBounds_Util {
     }
     /**
      * returns true if the position is within the box bounds
+     *
+     * @example
+     * ```ts
+     * const boxBounds = new DyFM_BoxBounds_Util({ x: 0, y: 0 }, { x: 10, y: 10 });
+     * const isWithinBounds = boxBounds.bounds(new DyFM_Vector2({ x: 5, y: 5 });
+     * console.log(isWithinBounds);
+     * ```
      */
     bounds(position) {
         return DyFM_BoxBounds_Util.bounds(this, position);
     }
     /**
      * calculates the center and centerMargin of the box bounds
+     *
+     * only usable inside the class
      */
     calcCenter() {
         const halfSize = vector2_util_1.DyFM_Vector2_Util.divide(this.size, 2);
@@ -115,10 +143,14 @@ class DyFM_BoxBounds_Util {
             centerMargin: this._centerMargin.get()
         };
     }
-    getBoxBounds = this.get;
-    toBoxBounds = this.get;
     /**
      * returns a new DyFM_BoxBounds_Util with the same position and size
+     *
+     * @example
+     * ```ts
+     * const boxBounds = new DyFM_BoxBounds_Util({ x: 0, y: 0 }, { x: 10, y: 10 });
+     * const clonedBoxBounds = boxBounds.clone();
+     * ```
      */
     clone() {
         return new DyFM_BoxBounds_Util(this._pos.clone(), this._size.clone());

package/build/_collections/utils/math/box-bounds.util.js.map

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

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

@@ -4,47 +4,83 @@
 export declare class DyFM_Math {
     /**
      * returns true if the value is between the min and max
+     *
+     * @example
+     * ```ts
+     * const isBetween = DyFM_Math.between(5, 1, 10);
+     * console.log(isBetween);
+     * ```
      */
     static between(value: number, minExclusive: number, maxExclusive: number): boolean;
     /**
      * returns true if the value is between the target and the range
+     *
+     * @example
+     * ```ts
+     * const isAround = DyFM_Math.around(5, 5, 1);
+     * console.log(isAround);
+     * ```
      */
     static around(value: number, target: number, range: number): boolean;
-    /**
-     * returns a random integer between the min and max
-     */
-    static getRandomInt(
-    /**
-     * the minimum value (inclusive)
-     */
-    min: number, 
-    /**
-     * the maximum value (inclusive)
-     */
-    max: number): number;
     static readonly toFixed: typeof DyFM_Math.round;
     /**
      * returns a number rounded to the specified number of decimals
+     *
+     * @example
+     * ```ts
+     * const roundedNumber = DyFM_Math.round(1.2345, 2);
+     * console.log(roundedNumber); // 1.23
+     * ```
      */
     static round(value: number, decimals?: number): number;
     /**
      * returns a number with spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const numberWithSpaces = DyFM_Math.numberWithSpaces(1000);
+     * console.log(numberWithSpaces); // '1 000'
+     * ```
      */
     static numberWithSpaces(x: number): string;
     /**
      * returns a number with shorter units
+     *
+     * @example
+     * ```ts
+     * const numberWithShorters = DyFM_Math.numberWithShorters(1000);
+     * console.log(numberWithShorters); // '1.0k'
+     * ```
      */
     static numberWithShorters(x: number): string;
     /**
      * returns a number with shorter units and spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const numberWithShortersAndSpaces = DyFM_Math.numberWithShortersAndSpaces(1000);
+     * console.log(numberWithShortersAndSpaces); // '1.0k'
+     * ```
      */
     static numberWithShortersAndSpaces(x: number): string;
     /**
      * returns a number with spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const floatingNumberWithSpaces = DyFM_Math.floatingNumberWithSpaces(1234.567);
+     * console.log(floatingNumberWithSpaces); // '1 234.567'
+     * ```
      */
     static floatingNumberWithSpaces(x: number): string;
     /**
      * returns a number with spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const decimals = DyFM_Math.decimals(1234.567, ',');
+     * console.log(decimals); // '1,234.567'
+     * ```
      */
     static decimals(x: number, useSpacer?: string): string;
 }

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

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

@@ -1,4 +1,5 @@
 "use strict";
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_Math = void 0;
 /**
@@ -7,33 +8,36 @@ exports.DyFM_Math = void 0;
 class DyFM_Math {
     /**
      * returns true if the value is between the min and max
+     *
+     * @example
+     * ```ts
+     * const isBetween = DyFM_Math.between(5, 1, 10);
+     * console.log(isBetween);
+     * ```
      */
     static between(value, minExclusive, maxExclusive) {
         return minExclusive < value && value < maxExclusive;
     }
     /**
      * returns true if the value is between the target and the range
+     *
+     * @example
+     * ```ts
+     * const isAround = DyFM_Math.around(5, 5, 1);
+     * console.log(isAround);
+     * ```
      */
     static around(value, target, range) {
         return this.between(value, target - range, target + range);
     }
-    /**
-     * returns a random integer between the min and max
-     */
-    static getRandomInt(
-    /**
-     * the minimum value (inclusive)
-     */
-    min, 
-    /**
-     * the maximum value (inclusive)
-     */
-    max) {
-        return min + Math.round((max - min) * Math.random());
-    }
-    static toFixed = this.round;
     /**
      * returns a number rounded to the specified number of decimals
+     *
+     * @example
+     * ```ts
+     * const roundedNumber = DyFM_Math.round(1.2345, 2);
+     * console.log(roundedNumber); // 1.23
+     * ```
      */
     static round(value, decimals = 2) {
         if (0 <= decimals) {
@@ -46,12 +50,24 @@ class DyFM_Math {
     }
     /**
      * returns a number with spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const numberWithSpaces = DyFM_Math.numberWithSpaces(1000);
+     * console.log(numberWithSpaces); // '1 000'
+     * ```
      */
     static numberWithSpaces(x) {
         return x?.toString()?.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
     }
     /**
      * returns a number with shorter units
+     *
+     * @example
+     * ```ts
+     * const numberWithShorters = DyFM_Math.numberWithShorters(1000);
+     * console.log(numberWithShorters); // '1.0k'
+     * ```
      */
     static numberWithShorters(x) {
         if (x < 1000) {
@@ -69,12 +85,24 @@ class DyFM_Math {
     }
     /**
      * returns a number with shorter units and spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const numberWithShortersAndSpaces = DyFM_Math.numberWithShortersAndSpaces(1000);
+     * console.log(numberWithShortersAndSpaces); // '1.0k'
+     * ```
      */
     static numberWithShortersAndSpaces(x) {
         return this.numberWithShorters(x)?.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
     }
     /**
      * returns a number with spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const floatingNumberWithSpaces = DyFM_Math.floatingNumberWithSpaces(1234.567);
+     * console.log(floatingNumberWithSpaces); // '1 234.567'
+     * ```
      */
     static floatingNumberWithSpaces(x) {
         const parts = x?.toString()?.split('.');
@@ -83,6 +111,12 @@ class DyFM_Math {
     }
     /**
      * returns a number with spaces between the thousands
+     *
+     * @example
+     * ```ts
+     * const decimals = DyFM_Math.decimals(1234.567, ',');
+     * console.log(decimals); // '1,234.567'
+     * ```
      */
     static decimals(x, useSpacer = ',') {
         const parts = x?.toString()?.split('.');
@@ -91,4 +125,6 @@ class DyFM_Math {
     }
 }
 exports.DyFM_Math = DyFM_Math;
+_a = DyFM_Math;
+DyFM_Math.toFixed = _a.round;
 //# sourceMappingURL=math.util.js.map

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/math.util.spec.js

@@ -29,15 +29,6 @@ describe('| DyFM_Math', () => {
             expect(math_util_1.DyFM_Math.around(7, 5, 1)).toBeFalse();
         });
     });
-    describe('| getRandomInt', () => {
-        it('| should return an integer within the specified range', () => {
-            const min = 1;
-            const max = 10;
-            const result = math_util_1.DyFM_Math.getRandomInt(min, max);
-            expect(result).toBeGreaterThanOrEqual(min);
-            expect(result).toBeLessThanOrEqual(max);
-        });
-    });
     describe('| round', () => {
         it('| should round a number to the specified number of decimals', () => {
             expect(math_util_1.DyFM_Math.round(1.2345, 2)).toBe(1.23);

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

@@ -1 +1 @@
-{"version":3,"file":"math.util.spec.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/math.util.spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"math.util.spec.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/math.util.spec.ts"],"names":[],"mappings":";;AACA,2CAAwC;AAExC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAE3B,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;YAChF,MAAM,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,CAAC,qBAAS,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,CAAC,qBAAS,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,GAAG,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACpE,MAAM,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7C,MAAM,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7C,MAAM,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7C,MAAM,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;YACvE,MAAM,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAC9C,MAAM,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,MAAM,CAAC,qBAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,CAAC,qBAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACzE,MAAM,CAAC,qBAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,qBAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;YACvF,MAAM,CAAC,qBAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,CAAC,qBAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,MAAM,CAAC,qBAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,CAAC,qBAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,CAAC,qBAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,CAAC,qBAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,CAAC,qBAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5D,MAAM,CAAC,qBAAS,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,CAAC,qBAAS,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjE,MAAM,CAAC,qBAAS,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrE,MAAM,CAAC,qBAAS,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;YAC9E,MAAM,CAAC,qBAAS,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACvE,MAAM,CAAC,qBAAS,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,CAAC,qBAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5D,MAAM,CAAC,qBAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AAEL,CAAC,CAAC,CAAC"}

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

@@ -5,6 +5,16 @@ import { DyFM_RandomWeight } from '../../../_models/interfaces/random-weight.int
 export declare class DyFM_Random {
     /**
      * returns a random weighted integer between the min and max
+     *
+     * @example
+     * ```ts
+     * const randomWeightedInt = DyFM_Random.getRandomWeightedInt(1, 10, [
+     *   { chance: 0.1, result: 1 },
+     *   { chance: 0.3, result: 2 },
+     *   { chance: 0.6, result: 3 }
+     * ]);
+     * console.log(randomWeightedInt);
+     * ```
      */
     static getRandomWeightedInt(min: number, max: number, weights: DyFM_RandomWeight<number>[]): number;
     /**
@@ -12,12 +22,24 @@ export declare class DyFM_Random {
      * @param min - the minimum value (inclusive)
      * @param max - the maximum value (inclusive)
      * @returns a random integer between the min and max
+     *
+     * @example
+     * ```ts
+     * const randomInt = DyFM_Random.getRandomInt(1, 10);
+     * console.log(randomInt); // 5
+     * ```
      */
     static getRandomInt(min: number, max: number): number;
     /**
      * returns null if list is empty
      * @param list
      * @returns
+     *
+     * @example
+     * ```ts
+     * const randomListElement = DyFM_Random.getRandomListElement([1, 2, 3, 4, 5]);
+     * console.log(randomListElement); // 3
+     * ```
      */
     static getRandomListElement<T>(list: T[]): T | null;
     /**
@@ -25,6 +47,14 @@ export declare class DyFM_Random {
      * (returns null if list is empty)
      * @param weights
      * @returns
+     *
+     * @example
+     * ```ts
+     * const randomWeightedElement = DyFM_Random.getRandomWeighted([
+     *   { chance: 0.1, result: '1' },
+     *   { chance: 0.3, result: '2' },
+     *   { chance: 0.6, result: '3' }
+     * ]);
      */
     static getRandomWeighted<T>(weights: DyFM_RandomWeight<T>[]): T | null;
 }

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;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;;;;;OAKG;IACH,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"}
+{"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;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,GACnC,MAAM;IA6BT;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IAQnD;;;;;;;;;;;;;OAaG;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

@@ -8,6 +8,16 @@ const log_util_1 = require("../log.util");
 class DyFM_Random {
     /**
      * returns a random weighted integer between the min and max
+     *
+     * @example
+     * ```ts
+     * const randomWeightedInt = DyFM_Random.getRandomWeightedInt(1, 10, [
+     *   { chance: 0.1, result: 1 },
+     *   { chance: 0.3, result: 2 },
+     *   { chance: 0.6, result: 3 }
+     * ]);
+     * console.log(randomWeightedInt);
+     * ```
      */
     static getRandomWeightedInt(min, max, weights) {
         weights = weights.sort((a, b) => b.chance - a.chance);
@@ -37,6 +47,12 @@ class DyFM_Random {
      * @param min - the minimum value (inclusive)
      * @param max - the maximum value (inclusive)
      * @returns a random integer between the min and max
+     *
+     * @example
+     * ```ts
+     * const randomInt = DyFM_Random.getRandomInt(1, 10);
+     * console.log(randomInt); // 5
+     * ```
      */
     static getRandomInt(min, max) {
         return min + Math.round((max - min) * Math.random());
@@ -45,6 +61,12 @@ class DyFM_Random {
      * returns null if list is empty
      * @param list
      * @returns
+     *
+     * @example
+     * ```ts
+     * const randomListElement = DyFM_Random.getRandomListElement([1, 2, 3, 4, 5]);
+     * console.log(randomListElement); // 3
+     * ```
      */
     static getRandomListElement(list) {
         if (0 < list.length) {
@@ -59,6 +81,14 @@ class DyFM_Random {
      * (returns null if list is empty)
      * @param weights
      * @returns
+     *
+     * @example
+     * ```ts
+     * const randomWeightedElement = DyFM_Random.getRandomWeighted([
+     *   { chance: 0.1, result: '1' },
+     *   { chance: 0.3, result: '2' },
+     *   { chance: 0.6, result: '3' }
+     * ]);
      */
     static getRandomWeighted(weights) {
         if (!weights?.length) {

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/trigonometry.util.d.ts

@@ -9,6 +9,12 @@ export declare class DyFM_Trigonometry {
      * @param c átfogó
      * @param angle a befogó oldallal szemközti szög (fokban)
      * @returns befogó
+     *
+     * @example
+     * ```ts
+     * const clamp = DyFM_Trigonometry.getClamp(10, 30);
+     * console.log(clamp); // 5
+     * ```
      */
     static getClamp(c: number, angle?: number): number;
     /**
@@ -17,6 +23,12 @@ export declare class DyFM_Trigonometry {
      * @param a befogó
      * @param c átfogó
      * @returns befogó
+     *
+     * @example
+     * ```ts
+     * const clamp = DyFM_Trigonometry.getClampByClampAndHypotenuse(6, 10);
+     * console.log(clamp); // 8
+     * ```
      */
     static getClampByClampAndHypotenuse(a: number, c: number): number;
     /**
@@ -27,18 +39,36 @@ export declare class DyFM_Trigonometry {
      * @param a egyik befogó
      * @param b másik befogó
      * @returns átfogó
+     *
+     * @example
+     * ```ts
+     * const hypotenuse = DyFM_Trigonometry.getHypotenuse(3, 4);
+     * console.log(hypotenuse); // 5
+     * ```
      */
     static getHypotenuse(a: number, b?: number): number;
     /**
      * Szög fokmértéket átalakítja radiánsra
      * @param angle szög fok
      * @returns szög radiáns
+     *
+     * @example
+     * ```ts
+     * const radians = DyFM_Trigonometry.angleToRadians(180);
+     * console.log(radians); // 3.141592653589793
+     * ```
      */
     static angleToRadians(angle: number): number;
     /**
      * Szög radiáns mértéket átalakítja fokra
      * @param radians szög radiáns
      * @returns szög fok
+     *
+     * @example
+     * ```ts
+     * const angle = DyFM_Trigonometry.radiansToAngle(3.141592653589793);
+     * console.log(angle); // 180
+     * ```
      */
     static radiansToAngle(radians: number): number;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"trigonometry.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/trigonometry.util.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAC1C,MAAM,MAAM,MAAM,GAAG,iBAAiB,CAAC;AACvC,qBAAa,iBAAiB;IAE5B;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAMlD;;;;;;OAMG;IACH,MAAM,CAAC,4BAA4B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAYjE;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnD;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5C;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAG/C"}
+{"version":3,"file":"trigonometry.util.d.ts","sourceRoot":"","sources":["../../../../src/_collections/utils/math/trigonometry.util.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAC1C,MAAM,MAAM,MAAM,GAAG,iBAAiB,CAAC;AACvC,qBAAa,iBAAiB;IAE5B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAMlD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,4BAA4B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAYjE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAG/C"}