@futdevpro/fsm-dynamo 1.10.38 → 1.10.40

package/.github/workflows/main.yml

@@ -21,8 +21,12 @@ jobs:
   notification0:
     name: Discord start Notification
     runs-on: ubuntu-latest
+    outputs:
+      start: ${{ steps.mark_start.outputs.started }}
     steps:
     - uses: actions/checkout@master
+    - id: mark_start
+      run: echo "started=$(date +%s)" >> "$GITHUB_OUTPUT"
     - name: send custom message with args
       uses: appleboy/discord-action@master
       with:
@@ -209,6 +213,12 @@ jobs:
         echo "THIS_VERSION=$RAW_THIS_VERSION" >> $GITHUB_ENV
 
     - uses: actions/checkout@master
+    - id: duration
+      run: |
+        START_TIME=${{ needs.notification0.outputs.start }}
+        END_TIME=$(date +%s)
+        DIFF=$((END_TIME - START_TIME))
+        echo "human=$(printf '%dm %ds' $((DIFF/60)) $((DIFF%60)))" >> "$GITHUB_OUTPUT"
     - name: send custom message with args
       uses: appleboy/discord-action@master
       with:
@@ -224,58 +234,8 @@ jobs:
           - ${{ needs.deploy.result == 'failure' && ':cross_mark:' || needs.deploy.result == 'success' && ':white_check_mark:' || needs.deploy.result == 'skipped' && ':zzz:' || ':question:' }}
           Deploy: ${{ needs.deploy.result }} (${{ env.THIS_VERSION }}) 
           ${{ needs.deploy.result == 'success' && ':rocket:' || '' }}\n\
+          :stopwatch: Duration: ${{ steps.duration.outputs.human }}\n\
           :brick: (${{ github.run_number }}) [:link:](
             https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})"
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-     # - name: Set Package Name
-     #   run: |
-     #     echo "PACKAGE_NAME=$(node -p -e "require('./package.json').name")" >> $GITHUB_ENV
-
-     # - name: Set Versions
-     #   run: |
-     #     RAW_THIS_VERSION=$(node -p -e "require('./package.json').version")
-     #       # replace ALL: 'v0' with '', '01' with '1', '.0' with '.'
-     #     RAW_THIS_VERSION=$(echo $RAW_THIS_VERSION | sed 's:v0::g'  | sed 's:01:1:g' | sed -e 's:\.0:\.:g')
-     #     echo "THIS_VERSION=$RAW_THIS_VERSION" >> $GITHUB_ENV
-     #     echo "LATEST_VERSION=$(npm view ${{ env.PACKAGE_NAME }} version)" >> $GITHUB_ENV
-
-     # - name: Set isPublished
-     #   run: |
-     #     ALL_VERSIONS=$(npm view ${{ env.PACKAGE_NAME }} versions)
-     #     if echo "$ALL_VERSIONS" | grep -q "${{ env.THIS_VERSION }}"; then
-     #       echo "VERSION_PUBLISHED=true" >> $GITHUB_ENV
-     #     else
-     #       echo "VERSION_PUBLISHED=false" >> $GITHUB_ENV          
-     #     fi
-
-     # - name: Unpublish Version
-     #   run: |
-     #     if [ "${{ env.VERSION_PUBLISHED }}" == "true" ]; then
-     #       npm unpublish ${{ env.PACKAGE_NAME }}@${{ env.THIS_VERSION }}
-     #     else
-     #       echo "Version not published"
-     #     fi
-        
-

package/build/_collections/constants/error-defaults.const.d.ts

@@ -1,3 +1,11 @@
 import { DyFM_Error_Defaults } from '../../_models/interfaces/error-defaults.interface';
+/**
+ * Default values used when creating an error object.
+ *
+ * @example
+ * ```ts
+ * console.log(DyFM_error_defaults.message);
+ * ```
+ */
 export declare const DyFM_error_defaults: DyFM_Error_Defaults;
 //# sourceMappingURL=error-defaults.const.d.ts.map

package/build/_collections/constants/error-defaults.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-defaults.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/error-defaults.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAExF,eAAO,MAAM,mBAAmB,EAAE,mBAOjC,CAAC"}
+{"version":3,"file":"error-defaults.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/error-defaults.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAExF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAOjC,CAAC"}

package/build/_collections/constants/error-defaults.const.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_error_defaults = void 0;
+/**
+ * Default values used when creating an error object.
+ *
+ * @example
+ * ```ts
+ * console.log(DyFM_error_defaults.message);
+ * ```
+ */
 exports.DyFM_error_defaults = {
     errorCode: 'NO-ERROR-CODE',
     message: 'NO-ERROR-MESSAGE',

package/build/_collections/constants/error-defaults.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-defaults.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/error-defaults.const.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAwB;IACtD,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,4BAA4B;IACzC,MAAM,EAAE,gBAAgB;IACxB,aAAa,EAAE,wBAAwB;IACvC,YAAY,EAAE,uBAAuB;CACtC,CAAC"}
+{"version":3,"file":"error-defaults.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/error-defaults.const.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACU,QAAA,mBAAmB,GAAwB;IACtD,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,4BAA4B;IACzC,MAAM,EAAE,gBAAgB;IACxB,aAAa,EAAE,wBAAwB;IACvC,YAAY,EAAE,uBAAuB;CACtC,CAAC"}

package/build/_collections/constants/global-settings.const.d.ts

@@ -1,3 +1,11 @@
 import { DyFM_Global_Settings } from '../../_models/interfaces/environment/global-settings.interface';
+/**
+ * Default global settings for the application.
+ *
+ * @example
+ * ```ts
+ * console.log(DyFM_global_settings.baseUrl);
+ * ```
+ */
 export declare const DyFM_global_settings: DyFM_Global_Settings;
 //# sourceMappingURL=global-settings.const.d.ts.map

package/build/_collections/constants/global-settings.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACrB,MAAM,gEAAgE,CAAC;AAIxE,eAAO,MAAM,oBAAoB,EAAE,oBAMlC,CAAC"}
+{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACrB,MAAM,gEAAgE,CAAC;AAIxE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,oBAMlC,CAAC"}

package/build/_collections/constants/global-settings.const.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_global_settings = void 0;
+/**
+ * Default global settings for the application.
+ *
+ * @example
+ * ```ts
+ * console.log(DyFM_global_settings.baseUrl);
+ * ```
+ */
 exports.DyFM_global_settings = {
     systemShortCodeName: 'DyFM_UNKNOWN_SYSTEM',
     baseUrl: '/api',

package/build/_collections/constants/global-settings.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":";;;AAQa,QAAA,oBAAoB,GAAyB;IACxD,mBAAmB,EAAE,qBAAqB;IAE1C,OAAO,EAAE,MAAM;IAEf,YAAY,EAAE,EAAE;CACjB,CAAC"}
+{"version":3,"file":"global-settings.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":";;;AAQA;;;;;;;GAOG;AACU,QAAA,oBAAoB,GAAyB;IACxD,mBAAmB,EAAE,qBAAqB;IAE1C,OAAO,EAAE,MAAM;IAEf,YAAY,EAAE,EAAE;CACjB,CAAC"}

package/build/_collections/constants/numbers.const.d.ts

@@ -1,5 +1,37 @@
+/**
+ * Multiplier representing one thousand.
+ *
+ * @example
+ * ```ts
+ * const kilobytes = 32 * kilo; // 32000
+ * ```
+ */
 export declare const kilo = 1000;
+/**
+ * Multiplier representing one million.
+ *
+ * @example
+ * ```ts
+ * const population = 5 * million;
+ * ```
+ */
 export declare const million: number;
+/**
+ * Multiplier representing one billion.
+ *
+ * @example
+ * ```ts
+ * const views = 2 * billion;
+ * ```
+ */
 export declare const billion: number;
+/**
+ * Multiplier representing one trillion.
+ *
+ * @example
+ * ```ts
+ * const nationalDebt = 30 * trillion;
+ * ```
+ */
 export declare const trillion: number;
 //# sourceMappingURL=numbers.const.d.ts.map

package/build/_collections/constants/numbers.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/numbers.const.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,IAAI,OAAO,CAAC;AACzB,eAAO,MAAM,OAAO,QAAc,CAAC;AACnC,eAAO,MAAM,OAAO,QAAiB,CAAC;AACtC,eAAO,MAAM,QAAQ,QAAiB,CAAC"}
+{"version":3,"file":"numbers.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/numbers.const.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,OAAO,CAAC;AACzB;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,QAAc,CAAC;AACnC;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,QAAiB,CAAC;AACtC;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,QAAiB,CAAC"}

package/build/_collections/constants/numbers.const.js

@@ -1,8 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trillion = exports.billion = exports.million = exports.kilo = void 0;
+/**
+ * Multiplier representing one thousand.
+ *
+ * @example
+ * ```ts
+ * const kilobytes = 32 * kilo; // 32000
+ * ```
+ */
 exports.kilo = 1000;
+/**
+ * Multiplier representing one million.
+ *
+ * @example
+ * ```ts
+ * const population = 5 * million;
+ * ```
+ */
 exports.million = exports.kilo * exports.kilo;
+/**
+ * Multiplier representing one billion.
+ *
+ * @example
+ * ```ts
+ * const views = 2 * billion;
+ * ```
+ */
 exports.billion = exports.million * exports.kilo;
+/**
+ * Multiplier representing one trillion.
+ *
+ * @example
+ * ```ts
+ * const nationalDebt = 30 * trillion;
+ * ```
+ */
 exports.trillion = exports.billion * exports.kilo;
 //# sourceMappingURL=numbers.const.js.map

package/build/_collections/constants/numbers.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/numbers.const.ts"],"names":[],"mappings":";;;AACa,QAAA,IAAI,GAAG,IAAI,CAAC;AACZ,QAAA,OAAO,GAAG,YAAI,GAAG,YAAI,CAAC;AACtB,QAAA,OAAO,GAAG,eAAO,GAAG,YAAI,CAAC;AACzB,QAAA,QAAQ,GAAG,eAAO,GAAG,YAAI,CAAC"}
+{"version":3,"file":"numbers.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/numbers.const.ts"],"names":[],"mappings":";;;AACA;;;;;;;GAOG;AACU,QAAA,IAAI,GAAG,IAAI,CAAC;AACzB;;;;;;;GAOG;AACU,QAAA,OAAO,GAAG,YAAI,GAAG,YAAI,CAAC;AACnC;;;;;;;GAOG;AACU,QAAA,OAAO,GAAG,eAAO,GAAG,YAAI,CAAC;AACtC;;;;;;;GAOG;AACU,QAAA,QAAQ,GAAG,eAAO,GAAG,YAAI,CAAC"}

package/build/_collections/constants/times.const.d.ts

@@ -1,8 +1,39 @@
+/**
+ * Milliseconds in one second.
+ *
+ * @example
+ * ```ts
+ * setTimeout(cb, 5 * second);
+ * ```
+ */
 export declare const second = 1000;
+/**
+ * Milliseconds in one minute.
+ *
+ * @example
+ * ```ts
+ * const timeout = 2 * minute;
+ * ```
+ */
 export declare const minute: number;
+/**
+ * Milliseconds in one hour.
+ */
 export declare const hour: number;
+/**
+ * Milliseconds in one day.
+ */
 export declare const day: number;
+/**
+ * Milliseconds in one week.
+ */
 export declare const week: number;
+/**
+ * Average milliseconds in one month.
+ */
 export declare const month: number;
+/**
+ * Average milliseconds in one year.
+ */
 export declare const year: number;
 //# sourceMappingURL=times.const.d.ts.map

package/build/_collections/constants/times.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"times.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/times.const.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,MAAM,OAAO,CAAC;AAC3B,eAAO,MAAM,MAAM,QAAc,CAAC;AAClC,eAAO,MAAM,IAAI,QAAc,CAAC;AAChC,eAAO,MAAM,GAAG,QAAY,CAAC;AAC7B,eAAO,MAAM,IAAI,QAAU,CAAC;AAC5B,eAAO,MAAM,KAAK,QAAmB,CAAC;AACtC,eAAO,MAAM,IAAI,QAAmB,CAAC"}
+{"version":3,"file":"times.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/times.const.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,OAAO,CAAC;AAE3B;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,QAAc,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,IAAI,QAAc,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,GAAG,QAAY,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,IAAI,QAAU,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,KAAK,QAAmB,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,IAAI,QAAmB,CAAC"}

package/build/_collections/constants/times.const.js

@@ -1,11 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.year = exports.month = exports.week = exports.day = exports.hour = exports.minute = exports.second = void 0;
+/**
+ * Milliseconds in one second.
+ *
+ * @example
+ * ```ts
+ * setTimeout(cb, 5 * second);
+ * ```
+ */
 exports.second = 1000;
+/**
+ * Milliseconds in one minute.
+ *
+ * @example
+ * ```ts
+ * const timeout = 2 * minute;
+ * ```
+ */
 exports.minute = exports.second * 60;
+/**
+ * Milliseconds in one hour.
+ */
 exports.hour = exports.minute * 60;
+/**
+ * Milliseconds in one day.
+ */
 exports.day = exports.hour * 24;
+/**
+ * Milliseconds in one week.
+ */
 exports.week = exports.day * 7;
+/**
+ * Average milliseconds in one month.
+ */
 exports.month = exports.day * 30.4368499;
+/**
+ * Average milliseconds in one year.
+ */
 exports.year = exports.day * 365.242199;
 //# sourceMappingURL=times.const.js.map

package/build/_collections/constants/times.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"times.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/times.const.ts"],"names":[],"mappings":";;;AACa,QAAA,MAAM,GAAG,IAAI,CAAC;AACd,QAAA,MAAM,GAAG,cAAM,GAAG,EAAE,CAAC;AACrB,QAAA,IAAI,GAAG,cAAM,GAAG,EAAE,CAAC;AACnB,QAAA,GAAG,GAAG,YAAI,GAAG,EAAE,CAAC;AAChB,QAAA,IAAI,GAAG,WAAG,GAAG,CAAC,CAAC;AACf,QAAA,KAAK,GAAG,WAAG,GAAG,UAAU,CAAC;AACzB,QAAA,IAAI,GAAG,WAAG,GAAG,UAAU,CAAC"}
+{"version":3,"file":"times.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/times.const.ts"],"names":[],"mappings":";;;AACA;;;;;;;GAOG;AACU,QAAA,MAAM,GAAG,IAAI,CAAC;AAE3B;;;;;;;GAOG;AACU,QAAA,MAAM,GAAG,cAAM,GAAG,EAAE,CAAC;AAElC;;GAEG;AACU,QAAA,IAAI,GAAG,cAAM,GAAG,EAAE,CAAC;AAEhC;;GAEG;AACU,QAAA,GAAG,GAAG,YAAI,GAAG,EAAE,CAAC;AAE7B;;GAEG;AACU,QAAA,IAAI,GAAG,WAAG,GAAG,CAAC,CAAC;AAE5B;;GAEG;AACU,QAAA,KAAK,GAAG,WAAG,GAAG,UAAU,CAAC;AAEtC;;GAEG;AACU,QAAA,IAAI,GAAG,WAAG,GAAG,UAAU,CAAC"}

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

@@ -1,27 +1,156 @@
 import { DyFM_Paged } from '../../_models/interfaces/paged.interface';
 export type DyFM_List = DyFM_Array;
 export declare class DyFM_Array {
+    /**
+     * Asynchronously iterates over an array and applies a function to each element.
+     * @param list - The array to iterate over.
+     * @param func - The function to apply to each element.
+     * @returns A promise that resolves when all elements have been processed.
+     */
     static asyncForEach<T>(list: T[], func: (element: T, index?: number, array?: T[]) => Promise<void>): Promise<void>;
+    /**
+     * Asynchronously iterates over an array and applies a function to each element, returning a single result.
+     * @param startData - The initial data to pass to the function.
+     * @param list - The array to iterate over.
+     * @param func - The function to apply to each element.
+     * @returns A promise that resolves to the final result.
+     */
     static asyncForEachReturnToOne<T, K>(startData: K, list: T[], func: (element: T, dataCurrent: K, index?: number, array?: T[]) => Promise<K>): Promise<K>;
+    /**
+     * Asynchronously iterates over an array and applies a function to each element, returning an array of results.
+     * @param list - The array to iterate over.
+     * @param func - The function to apply to each element.
+     * @returns A promise that resolves to an array of results.
+     */
     static asyncForEachReturnToAll<T, K>(list: T[], func: (element: T, index?: number, array?: T[]) => Promise<K>): Promise<K[]>;
+    /**
+     * Asynchronously iterates over an array and applies a function to each element, returning an array of results.
+     * @param list - The array to iterate over.
+     * @param func - The function to apply to each element.
+     * @returns A promise that resolves to an array of results.
+     */
     static asyncForEachAllAtOnce<T, R>(list: T[], func: (element: T, index?: number, array?: T[]) => Promise<R>): Promise<R[]>;
+    /**
+     * Asynchronously filters an array based on a function.
+     * @param list - The array to filter.
+     * @param filterFunc - The function to apply to each element.
+     * @returns A promise that resolves to an array of results.
+     */
     static asyncFilter<T>(list: T[], filterFunc: (element: T, index?: number, array?: T[]) => Promise<boolean>): Promise<T[]>;
+    /**
+     * Asynchronously maps an array based on a function.
+     * @param list - The array to map.
+     * @param mapFunc - The function to apply to each element.
+     * @returns A promise that resolves to an array of results.
+     */
     static asyncMap<T, R>(list: T[], mapFunc: (element: T, index?: number, array?: T[]) => Promise<R>): Promise<R[]>;
-    static last<T>(array: T[]): T;
-    static lastString(array: string): string;
-    static first<T>(array: T[]): T;
+    /**
+     * Returns the last element of an array.
+     * @param array - The array to get the last element from.
+     * @returns The last element of the array, or null if the array is empty.
+     */
+    static last<T>(array: T[]): T | null;
+    /**
+     * Returns the last character of a string.
+     * @param string - The string to get the last character from.
+     * @returns The last character of the string, or null if the string is empty.
+     */
+    static lastCharacter(string: string): string | null;
+    /**
+     * Returns the first element of an array.
+     * @param array - The array to get the first element from.
+     * @returns The first element of the array, or null if the array is empty.
+     */
+    static first<T>(array: T[]): T | null;
+    /**
+     * Removes an element from an array.
+     * @param array - The array to remove the element from.
+     * @param element - The element to remove from the array.
+     * @returns The array with the element removed.
+     */
     static remove<T>(array: T[], element: T): T[];
+    /**
+     * Finds an element in an array and removes it.
+     * @param array - The array to find and remove the element from.
+     * @param func - The function to apply to each element.
+     * @returns The array with the element removed.
+     */
     static findNRemove<T>(array: T[], func: (element: T, index?: number, array?: T[]) => boolean): T[];
+    /**
+     * Shuffles an array.
+     * @param array - The array to shuffle.
+     * @returns The shuffled array.
+     */
     static shuffle<T>(array: T[]): T[];
+    /**
+     * Pages an array.
+     * @param array - The array to page.
+     * @param pageIndex - The index of the page to return.
+     * @param pageSize - The size of the page.
+     * @returns The page of the array.
+     */
     static page<T>(array: T[], pageIndex: number, pageSize: number): T[];
+    /**
+     * Pages an array.
+     * @param array - The array to page.
+     * @param pageIndex - The index of the page to return.
+     * @param pageSize - The size of the page.
+     * @returns The page of the array.
+     */
     static paged<T>(array: T[], pageIndex: number, pageSize: number): DyFM_Paged<T>;
+    /**
+     * Swaps two elements in an array.
+     * @param array - The array to swap the elements in.
+     * @param indexA - The index of the first element to swap.
+     * @param indexB - The index of the second element to swap.
+     * @returns The array with the elements swapped.
+     */
     static swap<T>(array: T[], indexA: number, indexB: number): T[];
+    /**
+     * Checks if a string list has multiplications.
+     * @param stringList - The string list to check.
+     * @returns True if the string list has multiplications, false otherwise.
+     */
     static stringListHasMultiplications(stringList: string[]): boolean;
+    /**
+     * Filters a string list to remove multiplications.
+     * @param stringList - The string list to filter.
+     * @returns The filtered string list.
+     */
     static filterStringMultiplications(stringList: string[]): string[];
+    /**
+     * Gathers multiplications from a string list.
+     * @param stringList - The string list to gather multiplications from.
+     * @returns The gathered multiplications.
+     */
     static gatherStringMultiplications(stringList: string[]): string[][];
-    static haveMultiplications<T extends object>(dataList: T[], byKey?: string): boolean;
-    static filterMultiplications<T extends object>(dataList: T[], byKey?: string): T[];
-    static gatherMultiplications<T extends object>(dataList: T[], byKey?: string): T[][];
-    static findFromEnd<T>(array: T[], func: (element: T, index?: number, array?: T[]) => boolean): T;
+    /**
+     * Checks if a data list has multiplications.
+     * @param dataList - The data list to check.
+     * @param byKey - The key to check for multiplications.
+     * @returns True if the data list has multiplications, false otherwise.
+     */
+    static haveMultiplications<T extends object>(dataList: T[], byKey?: keyof T): boolean;
+    /**
+     * Filters a data list to remove multiplications.
+     * @param dataList - The data list to filter.
+     * @param byKey - The key to filter for multiplications.
+     * @returns The filtered data list.
+     */
+    static filterMultiplications<T extends object>(dataList: T[], byKey?: keyof T): T[];
+    /**
+     * Gathers multiplications from a data list.
+     * @param dataList - The data list to gather multiplications from.
+     * @param byKey - The key to gather multiplications from.
+     * @returns The gathered multiplications.
+     */
+    static gatherMultiplications<T extends object>(dataList: T[], byKey?: keyof T): T[][];
+    /**
+     * Finds an element in an array from the end.
+     * @param array - The array to find the element in.
+     * @param func - The function to apply to each element.
+     * @returns The element found, or null if no element is found.
+     */
+    static findFromEnd<T>(array: T[], func: (element: T, index?: number, array?: T[]) => boolean): T | null;
 }
 //# sourceMappingURL=array.util.d.ts.map

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

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