@daiso-tech/core 0.1.0 → 0.1.2

package/{src/contracts/collection/collection.contract.ts → dist/types/contracts/collection/collection.contract.d.ts}

@@ -1,46 +1,9 @@
-import {
-    type SliceSettings,
-    type SlidingSettings,
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    type CollectionError,
-    type Comparator,
-    type Filter,
-    type FindOrSettings,
-    type FindSettings,
-    type ForEach,
-    type GroupBySettings,
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    type ItemNotFoundError,
-    type JoinSettings,
-    type Lazyable,
-    type Map,
-    type Modifier,
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    type MultipleItemsFoundError,
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    type IndexOverflowError,
-    type PageSettings,
-    type RecordItem,
-    type ReduceSettings,
-    type ReverseSettings,
-    type Tap,
-    type Transform,
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    type UnexpectedCollectionError,
-    type UpdatedItem,
-} from "@/contracts/collection/_shared";
-import { type EnsureType } from "@/types";
-
+import { type SliceSettings, type SlidingSettings, type Comparator, type Filter, type FindOrSettings, type FindSettings, type ForEach, type GroupBySettings, type JoinSettings, type Lazyable, type Map, type Modifier, type PageSettings, type RecordItem, type ReduceSettings, type ReverseSettings, type Tap, type Transform, type UpdatedItem } from "../../contracts/collection/_shared";
+import { type EnsureType } from "../../types";
 /**
  * @group Collections
  */
-export type Collapse<TValue> = TValue extends
-    | Array<infer TItem>
-    | Iterable<infer TItem>
-    | ICollection<infer TItem>
-    ? TItem
-    : TValue;
-
+export type Collapse<TValue> = TValue extends Array<infer TItem> | Iterable<infer TItem> | ICollection<infer TItem> ? TItem : TValue;
 /**
  * ICollection is immutable and all the methods return new copies
  * @throws {CollectionError}
@@ -53,15 +16,9 @@ export type Collapse<TValue> = TValue extends
  */
 export type ICollection<TInput> = Iterable<TInput> & {
     iterator(): Iterator<TInput, void>;
-
-    entries(
-        throwOnNumberLimit?: boolean,
-    ): ICollection<RecordItem<number, TInput>>;
-
+    entries(throwOnNumberLimit?: boolean): ICollection<RecordItem<number, TInput>>;
     keys(throwOnNumberLimit?: boolean): ICollection<number>;
-
     values(): ICollection<TInput>;
-
     /**
      * The filter method filters the collection using the given callback, keeping only those items that pass a given truth test:
      * @example
@@ -70,11 +27,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * filtered.toArray();
      * // [3, 4]
      */
-    filter<TOutput extends TInput>(
-        filter: Filter<TInput, ICollection<TInput>, TOutput>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TOutput>;
-
+    filter<TOutput extends TInput>(filter: Filter<TInput, ICollection<TInput>, TOutput>, throwOnNumberLimit?: boolean): ICollection<TOutput>;
     /**
      * The map method iterates through the collection and passes each value to the given callback.
      * The mapFunction is free to modify the item and return it, thus forming a new collection of modified items:
@@ -84,20 +37,12 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * mapped.toArray();
      * // [2, 4, 6, 8, 10]
      */
-    map<TOutput>(
-        map: Map<TInput, ICollection<TInput>, TOutput>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TOutput>;
-
-    reduce<TOutput = TInput>(
-        settings: ReduceSettings<TInput, ICollection<TInput>, TOutput>,
-    ): TOutput;
-
+    map<TOutput>(map: Map<TInput, ICollection<TInput>, TOutput>, throwOnNumberLimit?: boolean): ICollection<TOutput>;
+    reduce<TOutput = TInput>(settings: ReduceSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
     /**
      * @throws {TypeError}
      */
     join(settings?: JoinSettings): string;
-
     /**
      * The collapse method collapses a collection of arrays into a single, flat collection:
      * @example
@@ -107,7 +52,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [1, 2, 3, 4]
      */
     collapse(): ICollection<Collapse<TInput>>;
-
     /**
      * The flatMap method returns a new array formed by applying a given callback function to each element of the array, and then collapses the result by one level.
      * It is identical to a map() followed by a collapse()
@@ -116,11 +60,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [2, "a", "b", 2, "c", "d"]
      */
-    flatMap<TOutput>(
-        map: Map<TInput, ICollection<TInput>, Iterable<TOutput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TOutput>;
-
+    flatMap<TOutput>(map: Map<TInput, ICollection<TInput>, Iterable<TOutput>>, throwOnNumberLimit?: boolean): ICollection<TOutput>;
     /**
      * The update method filters the collection using the given callback, keeping only those items that pass a given truth test and thereafter updates the filtered items:
      * @example
@@ -129,12 +69,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * updateCollection.toArray();
      * // [1, 4, 3, 8, 5]
      */
-    update<TFilterOutput extends TInput, TMapOutput>(
-        filter: Filter<TInput, ICollection<TInput>, TFilterOutput>,
-        map: Map<TFilterOutput, ICollection<TInput>, TMapOutput>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<UpdatedItem<TInput, TFilterOutput, TMapOutput>>;
-
+    update<TFilterOutput extends TInput, TMapOutput>(filter: Filter<TInput, ICollection<TInput>, TFilterOutput>, map: Map<TFilterOutput, ICollection<TInput>, TMapOutput>, throwOnNumberLimit?: boolean): ICollection<UpdatedItem<TInput, TFilterOutput, TMapOutput>>;
     /**
      * The page method returns a new collection containing the items that would be present on a given page number.
      * The method accepts the page number as its first argument and the number of items to show per page as its second argument:
@@ -148,7 +83,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [4, 5, 6]
      */
     page(settings: PageSettings): ICollection<TInput>;
-
     /**
      * The sum method returns the sum of all items in the collection. If the collection contains nested arrays or objects,
      * you should pass a map function that returns a number to be used in sum calculation.
@@ -159,11 +93,9 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // 6
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
-     * @throws {IndexOverflowError} {@link IndexOverflowError}
      * @throws {TypeError} {@link TypeError}
      */
-    sum(throwOnNumberLimit?: boolean): EnsureType<TInput, number>;
-
+    sum(): EnsureType<TInput, number>;
     /**
      * The average method returns the average of all items in the collection. If the collection contains nested arrays or objects,
      * you should pass a map function that returns a number to be used in average calculation.
@@ -174,11 +106,9 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // 2
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
-     * @throws {IndexOverflowError} {@link IndexOverflowError}
      * @throws {TypeError} {@link TypeError}
      */
-    average(throwOnNumberLimit?: boolean): EnsureType<TInput, number>;
-
+    average(): EnsureType<TInput, number>;
     /**
      * The median method returns the median of all items in the collection. If the collection contains nested arrays or objects,
      * you should pass a map function that returns a number to be used in median calculation.
@@ -193,7 +123,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {TypeError} {@link TypeError}
      */
     median(throwOnNumberLimit?: boolean): EnsureType<TInput, number>;
-
     /**
      * The min method returns the min of all items in the collection. If the collection contains nested arrays or objects,
      * you should pass a map function that returns a number to be used in min calculation.
@@ -207,7 +136,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {TypeError} {@link TypeError}
      */
     min(): EnsureType<TInput, number>;
-
     /**
      * The max method returns the max of all items in the collection. If the collection contains nested arrays or objects,
      * you should pass a map function that returns a number to be used in max calculation.
@@ -221,7 +149,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {TypeError} {@link TypeError}
      */
     max(): EnsureType<TInput, number>;
-
     /**
      * The percentage method may be used to quickly determine the percentage of items in the collection that pass a given truth test
      * @example
@@ -232,11 +159,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    percentage(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): number;
-
+    percentage(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): number;
     /**
      * The some method determines whether the collection has a given item.
      * You must pass a closure to the some method to determine if an element exists in the collection matching a given truth test:
@@ -248,11 +171,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    some<TOutput extends TInput>(
-        filter: Filter<TInput, ICollection<TInput>, TOutput>,
-        throwOnNumberLimit?: boolean,
-    ): boolean;
-
+    some<TOutput extends TInput>(filter: Filter<TInput, ICollection<TInput>, TOutput>, throwOnNumberLimit?: boolean): boolean;
     /**
      * The every method may be used to verify that all elements of a collection pass a given truth test:
      * @example
@@ -263,11 +182,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    every<TOutput extends TInput>(
-        filter: Filter<TInput, ICollection<TInput>, TOutput>,
-        throwOnNumberLimit?: boolean,
-    ): boolean;
-
+    every<TOutput extends TInput>(filter: Filter<TInput, ICollection<TInput>, TOutput>, throwOnNumberLimit?: boolean): boolean;
     /**
      * The take method returns items in the collection until the given callback returns true:
      * @example
@@ -282,7 +197,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [4, 5]
      */
     take(limit: number, throwOnNumberLimit?: boolean): ICollection<TInput>;
-
     /**
      * The takeUntil method returns items in the collection until the given callback returns true:
      * @example
@@ -291,11 +205,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * chunk.toArray();
      * // [1, 2]
      */
-    takeUntil(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TInput>;
-
+    takeUntil(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): ICollection<TInput>;
     /**
      * The takeWhile method returns items in the collection until the given callback returns false:
      * @example
@@ -304,11 +214,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * chunk.toArray();
      * // [1, 2]
      */
-    takeWhile(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TInput>;
-
+    takeWhile(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): ICollection<TInput>;
     /**
      * The skip method returns a new collection, with the given number of elements removed from the beginning of the collection:
      * @example
@@ -317,7 +223,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [5, 6, 7, 8, 9, 10]
      */
     skip(offset: number, throwOnNumberLimit?: boolean): ICollection<TInput>;
-
     /**
      * The skipUntil method skips over items from the collection until the given callback returns true
      * and then returns the remaining items in the collection as a new collection instance:
@@ -326,11 +231,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [3, 4]
      */
-    skipUntil(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TInput>;
-
+    skipUntil(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): ICollection<TInput>;
     /**
      * The skipWhile method skips over items from the collection while the given callback returns false and then returns the remaining items in the collection as a new collection:
      * @example
@@ -338,11 +239,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [4]
      */
-    skipWhile(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TInput>;
-
+    skipWhile(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): ICollection<TInput>;
     /**
      * The when method will execute the given callback when the first argument given to the method evaluates to true:
      * @example
@@ -352,11 +249,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1, 2, 3, 4, -3]
      */
-    when<TExtended = TInput>(
-        condition: boolean,
-        callback: Modifier<ICollection<TInput>, ICollection<TExtended>>,
-    ): ICollection<TInput | TExtended>;
-
+    when<TExtended = TInput>(condition: boolean, callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     /**
      * The whenEmpty method will execute the given callback when the collection is empty:
      * @example
@@ -370,10 +263,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1]
      */
-    whenEmpty<TExtended = TInput>(
-        callback: Modifier<ICollection<TInput>, ICollection<TExtended>>,
-    ): ICollection<TInput | TExtended>;
-
+    whenEmpty<TExtended = TInput>(callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     /**
      * The whenNot method will execute the given callback when the first argument given to the method evaluates to false:
      * @example
@@ -383,11 +273,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1, 2, 3, 4, 20]
      */
-    whenNot<TExtended = TInput>(
-        condition: boolean,
-        callback: Modifier<ICollection<TInput>, ICollection<TExtended>>,
-    ): ICollection<TInput | TExtended>;
-
+    whenNot<TExtended = TInput>(condition: boolean, callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     /**
      * The whenNotEmpty method will execute the given callback when the collection is empty:
      * @example
@@ -401,10 +287,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1, -3]
      */
-    whenNotEmpty<TExtended = TInput>(
-        callback: Modifier<ICollection<TInput>, ICollection<TExtended>>,
-    ): ICollection<TInput | TExtended>;
-
+    whenNotEmpty<TExtended = TInput>(callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     /**
      * The pipe method passes the collection to the given closure and returns the result of the executed closure:
      * @example
@@ -412,10 +295,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * const piped = collection.pipe(collection => collection.sum());
      * // 6
      */
-    pipe<TOutput = TInput>(
-        callback: Transform<ICollection<TInput>, TOutput>,
-    ): TOutput;
-
+    pipe<TOutput = TInput>(callback: Transform<ICollection<TInput>, TOutput>): TOutput;
     /**
      * The tap method passes the collection to the given callback, allowing you to "tap" into the collection at a specific point
      * and do something with the items while not affecting the collection itself.The collection is then returned by the tap method:
@@ -430,7 +310,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [1, 2, 3, 4, 5, 6]
      */
     tap(callback: Tap<ICollection<TInput>>): ICollection<TInput>;
-
     /**
      * The chunk method breaks the collection into multiple, smaller collections of a given size:
      * @example
@@ -440,7 +319,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [[1, 2, 3, 4], [5, 6, 7]]
      */
     chunk(chunkSize: number): ICollection<ICollection<TInput>>;
-
     /**
      * The chunkWhile method breaks the collection into multiple, smaller collections based on the evaluation of the given callback.
      * The chunk variable passed to the closure may be used to inspect the previous element:
@@ -452,11 +330,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * chunks.toArray();
      * //  [["A", "A"], ["B", "B"], ["C", "C", "C"], ["D"]]
      */
-    chunkWhile(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<ICollection<TInput>>;
-
+    chunkWhile(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): ICollection<ICollection<TInput>>;
     /**
      * The split method breaks a collection into the given number of groups:
      * @example
@@ -465,11 +339,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * chunks.toArray();
      * // [[1, 2], [3, 4], [5]]
      */
-    split(
-        chunkAmount: number,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<ICollection<TInput>>;
-
+    split(chunkAmount: number, throwOnNumberLimit?: boolean): ICollection<ICollection<TInput>>;
     /**
      * The partition method is used to separate elements that pass a given truth test from those that do not:
      * @example
@@ -477,11 +347,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.partition(item => item < 3);
      * // [[1, 2], [3, 4, 5, 6]]
      */
-    partition(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<ICollection<TInput>>;
-
+    partition(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): ICollection<ICollection<TInput>>;
     /**
      * The sliding method returns a new collection of chunks representing a "sliding window" view of the items in the collection:
      * @experimental
@@ -491,7 +357,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [[1, 2], [2, 3], [3, 4], [4, 5]]
      */
     sliding(settings: SlidingSettings): ICollection<ICollection<TInput>>;
-
     /**
      * The groupBy method groups the collection's items by a given map function:
      * @example
@@ -507,10 +372,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      *   .map(([key, value]) => [key, value.toArray()]);
      * // [["gmail.com", ["alice@gmail.com", "carlos@gmail.com"]], ["yahoo.com", ["bob@yahoo.com"]]]
      */
-    groupBy<TOutput = TInput>(
-        settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>,
-    ): ICollection<RecordItem<TOutput, ICollection<TInput>>>;
-
+    groupBy<TOutput = TInput>(settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, ICollection<TInput>>>;
     /**
      * The countBy method counts the occurrences of values in the collection.
      * By default, the method counts the occurrences of every element, allowing you to count certain "types" of elements in the collection:
@@ -523,10 +385,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * const count = collection.countBy(item => item.split("@")[1])
      * // [["gmail.com", 2], ["yahoo.com", 1]]
      */
-    countBy<TOutput = TInput>(
-        settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>,
-    ): ICollection<RecordItem<TOutput, number>>;
-
+    countBy<TOutput = TInput>(settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, number>>;
     /**
      * The unique method removes all duplicate values from the collection:
      * @example
@@ -548,10 +407,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      *   { name: "Galaxy S6", brand: "Samsung", type: "phone" },
      * ]
      */
-    unique<TOutput = TInput>(
-        settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>,
-    ): ICollection<TInput>;
-
+    unique<TOutput = TInput>(settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     /**
      * The diff method will return the values in the original collection that are not present in the given iterable:
      * @example
@@ -560,11 +416,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * difference.toArray();
      * // [1, 3, 5]
      */
-    difference<TOutput = TInput>(
-        iterable: Iterable<TInput>,
-        map?: Map<TInput, ICollection<TInput>, TOutput>,
-    ): ICollection<TInput>;
-
+    difference<TOutput = TInput>(iterable: Iterable<TInput>, map?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     /**
      * The repeat method will repat the current collection given amount
      * @example
@@ -574,7 +426,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // [1, 2, 3,  1, 2, 3,  1, 2, 3]
      */
     repeat(amount: number): ICollection<TInput>;
-
     /**
      * The padStart method pads this collection with another item (multiple times, if needed) until the resulting collection reaches the given length.
      * The padding is applied from the start of this collection:
@@ -591,11 +442,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * new ListCollection("abc").padStart(1, "_").join({ seperator: ""});
      * // "abc"
      */
-    padStart<TExtended = TInput>(
-        maxLength: number,
-        fillItems: Iterable<TExtended>,
-    ): ICollection<TInput | TExtended>;
-
+    padStart<TExtended = TInput>(maxLength: number, fillItems: Iterable<TExtended>): ICollection<TInput | TExtended>;
     /**
      * The padEnd method pads this collection with another item (multiple times, if needed) until the resulting collection reaches the given length.
      * The padding is applied from the end of this collection:
@@ -612,17 +459,12 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * new ListCollection("abc").padEnd(1, "_").join({ seperator: ""});
      * // "abc"
      */
-    padEnd<TExtended = TInput>(
-        maxLength: number,
-        fillItems: Iterable<TExtended>,
-    ): ICollection<TInput | TExtended>;
-
+    padEnd<TExtended = TInput>(maxLength: number, fillItems: Iterable<TExtended>): ICollection<TInput | TExtended>;
     /**
      * The slice is the same as Array.slice method. Se documentation on mdn:
      * @link {https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice}
      */
     slice(settings?: SliceSettings): ICollection<TInput>;
-
     /**
      * The prepend method adds items to the beginning of the collection:
      * @example
@@ -630,10 +472,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [-1, 20, 1, 2, 3, 4, 5]
      */
-    prepend<TExtended = TInput>(
-        iterable: Iterable<TInput | TExtended>,
-    ): ICollection<TInput | TExtended>;
-
+    prepend<TExtended = TInput>(iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
     /**
      * The append method adds items to the end of the collection:
      * @example
@@ -641,10 +480,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1, 2, 3, 4, 5, -1, -2,]
      */
-    append<TExtended = TInput>(
-        iterable: Iterable<TInput | TExtended>,
-    ): ICollection<TInput | TExtended>;
-
+    append<TExtended = TInput>(iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
     /**
      * The insertBefore method adds items before a specific filtered item:
      * @example
@@ -652,12 +488,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1, -1, 20, 2, 2, 3, 4, 5]
      */
-    insertBefore<TExtended = TInput>(
-        filter: Filter<TInput, ICollection<TInput>>,
-        iterable: Iterable<TInput | TExtended>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TInput | TExtended>;
-
+    insertBefore<TExtended = TInput>(filter: Filter<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>, throwOnNumberLimit?: boolean): ICollection<TInput | TExtended>;
     /**
      * The insertAfter method adds items after a specific filtered item:
      * @example
@@ -665,12 +496,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * collection.toArray();
      * // [1, 2, -1, 20, 2, 3, 4, 5]
      */
-    insertAfter<TExtended = TInput>(
-        filter: Filter<TInput, ICollection<TInput>>,
-        iterable: Iterable<TInput | TExtended>,
-        throwOnNumberLimit?: boolean,
-    ): ICollection<TInput | TExtended>;
-
+    insertAfter<TExtended = TInput>(filter: Filter<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>, throwOnNumberLimit?: boolean): ICollection<TInput | TExtended>;
     /**
      * The crossJoin method cross joins the collection's values among the given arrays or collections, returning a Cartesian product with all possible permutations:
      * @example
@@ -698,10 +524,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * //  [2, "b", "II"],
      * // ]
      */
-    crossJoin<TExtended = TInput>(
-        ...iterables: Array<Iterable<TExtended>>
-    ): ICollection<ICollection<TInput | TExtended>>;
-
+    crossJoin<TExtended = TInput>(...iterables: Array<Iterable<TExtended>>): ICollection<ICollection<TInput | TExtended>>;
     /**
      * The zip method merges together the values of the given array with the values of the original collection at their corresponding index:
      * @example
@@ -710,16 +533,10 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * zipped.toArray();
      * // [["Chari", 100], ["Desk", 200]]
      */
-    zip<TExtended>(
-        iterable: Iterable<TExtended>,
-    ): ICollection<RecordItem<TInput, TExtended>>;
-
+    zip<TExtended>(iterable: Iterable<TExtended>): ICollection<RecordItem<TInput, TExtended>>;
     sort(compare?: Comparator<TInput>): ICollection<TInput>;
-
     reverse(settings?: ReverseSettings): ICollection<TInput>;
-
     shuffle(): ICollection<TInput>;
-
     /**
      * The first method returns the first element in the collection that passes a given truth test. By default it will get the first element:
      * @example
@@ -730,25 +547,14 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      * // 3
      */
-    first<TOutput extends TInput>(
-        settings?: FindSettings<TInput, ICollection<TInput>, TOutput>,
-    ): TOutput | null;
-
+    first<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput | null;
     /**
      * The firstOr method is the same as first method but will return a provided default value if not found
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    firstOr<TOutput extends TInput, TExtended = TInput>(
-        settings: FindOrSettings<
-            TInput,
-            ICollection<TInput>,
-            TOutput,
-            TExtended
-        >,
-    ): TOutput | TExtended;
-
+    firstOr<TOutput extends TInput, TExtended = TInput>(settings: FindOrSettings<TInput, ICollection<TInput>, TOutput, TExtended>): TOutput | TExtended;
     /**
      * The firstOrFail method is the same as first method but will throw an Error if not found
      * @throws {CollectionError} {@link CollectionError}
@@ -756,10 +562,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {ItemNotFoundError} {@link ItemNotFoundError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    firstOrFail<TOutput extends TInput>(
-        settings?: FindSettings<TInput, ICollection<TInput>, TOutput>,
-    ): TOutput;
-
+    firstOrFail<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
     /**
      * The last method returns the last element in the collection that passes a given truth test. By default it will get the last element:
      * @example
@@ -770,25 +573,14 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    last<TOutput extends TInput>(
-        settings?: FindSettings<TInput, ICollection<TInput>, TOutput>,
-    ): TOutput | null;
-
+    last<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput | null;
     /**
      * The lastOr method is the same as last method but will return a provided default value if not found
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    lastOr<TOutput extends TInput, TExtended = TInput>(
-        settings: FindOrSettings<
-            TInput,
-            ICollection<TInput>,
-            TOutput,
-            TExtended
-        >,
-    ): TOutput | TExtended;
-
+    lastOr<TOutput extends TInput, TExtended = TInput>(settings: FindOrSettings<TInput, ICollection<TInput>, TOutput, TExtended>): TOutput | TExtended;
     /**
      * The lastOrFail method is the same as last method but will throw an Error if not found
      * @throws {CollectionError} {@link CollectionError}
@@ -796,10 +588,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {ItemNotFoundError} {@link ItemNotFoundError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    lastOrFail<TOutput extends TInput>(
-        settings?: FindSettings<TInput, ICollection<TInput>, TOutput>,
-    ): TOutput;
-
+    lastOrFail<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
     /**
      * The before method is the opposite of the after method. It returns the item before the given item. null is returned if the given item is not found or is the first item:
      * @example
@@ -814,23 +603,14 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    before(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): TInput | null;
-
+    before(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): TInput | null;
     /**
      * The beforeOr method is the same as before method but will return a provided default value if not found
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    beforeOr<TExtended = TInput>(
-        defaultValue: Lazyable<TExtended>,
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): TInput | TExtended;
-
+    beforeOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): TInput | TExtended;
     /**
      * The beforeOrFail method is the same as before method but will throw an Error if not found
      * @throws {CollectionError} {@link CollectionError}
@@ -838,11 +618,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {ItemNotFoundError} {@link ItemNotFoundError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    beforeOrFail(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): TInput;
-
+    beforeOrFail(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): TInput;
     /**
      * The after method returns the item after the given item. null is returned if the given item is not found or is the last item:
      * @example
@@ -857,23 +633,14 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    after(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): TInput | null;
-
+    after(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): TInput | null;
     /**
      * The afterOr method is the same as after method but will return a provided default value if not found
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    afterOr<TExtended = TInput>(
-        defaultValue: Lazyable<TExtended>,
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): TInput | TExtended;
-
+    afterOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): TInput | TExtended;
     /**
      * The afterOrFail method is the same as after method but will throw an Error if not found
      * @throws {CollectionError} {@link CollectionError}
@@ -881,11 +648,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {ItemNotFoundError} {@link ItemNotFoundError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    afterOrFail(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): TInput;
-
+    afterOrFail(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): TInput;
     /**
      * The sole method returns the first element in the collection that passes a given truth test, but only if the truth test matches exactly one element:
      * @example
@@ -898,11 +661,7 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {MultipleItemsFoundError} {@link MultipleItemsFoundError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    sole<TOutput extends TInput>(
-        filter: Filter<TInput, ICollection<TInput>, TOutput>,
-        throwOnNumberLimit?: boolean,
-    ): TOutput;
-
+    sole<TOutput extends TInput>(filter: Filter<TInput, ICollection<TInput>, TOutput>, throwOnNumberLimit?: boolean): TOutput;
     /**
      * The nth method creates a new collection consisting of every n-th element:
      * @example
@@ -911,7 +670,6 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * // ["a", "e"]
      */
     nth(step: number): ICollection<TInput>;
-
     /**
      * The count method returns the total number of items in the collection:
      * @example
@@ -922,53 +680,38 @@ export type ICollection<TInput> = Iterable<TInput> & {
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    count(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): number;
-
+    count(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): number;
     /**
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
     size(throwOnNumberLimit?: boolean): number;
-
     /**
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
     empty(): boolean;
-
     /**
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
     notEmpty(): boolean;
-
     /**
      * The search method searches the collection for the given value and returns its index if found. If the item is not found, -1 is returned:
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    search(
-        filter: Filter<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): number;
-
+    search(filter: Filter<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): number;
     /**
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {IndexOverflowError} {@link IndexOverflowError}
      */
-    forEach(
-        callback: ForEach<TInput, ICollection<TInput>>,
-        throwOnNumberLimit?: boolean,
-    ): void;
-
+    forEach(callback: ForEach<TInput, ICollection<TInput>>, throwOnNumberLimit?: boolean): void;
     /**
      * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}