@futdevpro/fsm-dynamo 1.14.10 → 1.14.11

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

@@ -7,33 +7,37 @@ 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('.');

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":"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"}

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":";;;AAGA,0CAAuC;AAEvC;;GAEG;AACH,MAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAW,EACX,GAAW,EACX,OAAoC;QAEpC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAU,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAQ,EAAE,GAAG,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzE,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC;YACxB,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,YAAY,GAAW,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,IAAI,MAA0B,CAAC;QAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YAChE,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAE7B,IAAI,YAAY,GAAG,OAAO,EAAE,CAAC;gBAC3B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAW,EAAE,GAAW;QAC1C,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAI,IAAS;QACtC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAI,OAA+B;QACzD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAU,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAQ,EAAE;YAC/B,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAQ,EAAE;YAChC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,eAAe,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAW,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,IAAI,MAAqB,CAAC;QAC1B,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YAChE,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAE7B,IAAI,YAAY,GAAG,OAAO,EAAE,CAAC;gBAC3B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,mBAAQ,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApGD,kCAoGC"}
+{"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"}

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

@@ -10,6 +10,12 @@ 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, angle) {
         angle = angle !== undefined ? angle : 45;
@@ -21,6 +27,12 @@ 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, c) {
         if (a > c) {
@@ -38,6 +50,12 @@ 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, b) {
         b = b !== undefined ? b : a;
@@ -47,6 +65,12 @@ class DyFM_Trigonometry {
      * 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) {
         return angle * Math.PI / 180;
@@ -55,6 +79,12 @@ class DyFM_Trigonometry {
      * 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) {
         return radians / Math.PI * 180;

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

@@ -1 +1 @@
-{"version":3,"file":"trigonometry.util.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/trigonometry.util.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAE5B;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAS,EAAE,KAAc;QACvC,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,4BAA4B,CAAC,CAAS,EAAE,CAAS;QACtD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAEV,MAAM;gBACJ,YAAY,EACV,0EAA0E,CAAC,QAAQ,CAAC,GAAG;aAC1F,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,CAAC,CAAS,EAAE,CAAU;QACxC,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,KAAa;QACjC,OAAO,KAAK,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,OAAO,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;IACjC,CAAC;CACF;AApED,8CAoEC"}
+{"version":3,"file":"trigonometry.util.js","sourceRoot":"","sources":["../../../../src/_collections/utils/math/trigonometry.util.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAE5B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAS,EAAE,KAAc;QACvC,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,4BAA4B,CAAC,CAAS,EAAE,CAAS;QACtD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAEV,MAAM;gBACJ,YAAY,EACV,0EAA0E,CAAC,QAAQ,CAAC,GAAG;aAC1F,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,aAAa,CAAC,CAAS,EAAE,CAAU;QACxC,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,KAAa;QACjC,OAAO,KAAK,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,OAAO,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;IACjC,CAAC;CACF;AAlGD,8CAkGC"}