@daiso-tech/core 0.8.0 → 0.9.0

package/dist/types/collection/contracts/async-collection.contract.d.ts

@@ -1,19 +1,13 @@
 /**
  * @module Collection
  */
-import type { AsyncReduce, CrossJoinResult, AsyncPredicate, AsyncForEach, AsyncMap, AsyncModifier, AsyncTap, AsyncTransform, Comparator, ChangendItem } from "../../collection/contracts/_shared";
+import type { AsyncReduce, CrossJoinResult, AsyncPredicate, AsyncForEach, AsyncMap, AsyncModifier, AsyncTap, AsyncTransform, Comparator } from "../../collection/contracts/_shared";
 import type { RecordItem, AsyncLazyable, AsyncIterableValue } from "../../_shared/types";
 import type { TimeSpan } from "../../utilities/_module";
 export type AsyncCollapse<TValue> = TValue extends Array<infer TItem> | Iterable<infer TItem> | IAsyncCollection<infer TItem> ? TItem : TValue;
 /**
  * The <i>IAsyncCollection</i> contract offers a fluent and efficient approach to working with {@link AsyncIterable} objects.
  * <i>IAsyncCollection</i> is immutable.
- * @throws {CollectionError} {@link CollectionError}
- * @throws {UnexpectedCollectionError}
- * @throws {ItemNotFoundCollectionError}
- * @throws {MultipleItemsFoundCollectionError}
- * @throws {TypeCollectionError}
- * @throws {EmptyCollectionError}
  * @group Contracts
  */
 export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
@@ -36,47 +30,56 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>filter</i> method filters the collection using <i>predicateFn</i>, keeping only those items that pass <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6]);
      * const filtered = collection.filter(item => 2 < item && item < 5);
      * await filtered.toArray();
      * // [3, 4]
+     * ```
      */
     filter<TOutput extends TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<TOutput>;
     /**
      * The <i>reject</i> method filters the collection using <i>predicateFn</i>, keeping only those items that not pass <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6]);
      * const filtered = collection.reject(item => 2 < item && item < 5);
      * await filtered.toArray();
      * // [1, 2, 5, 6]
+     * ```
      */
     reject<TOutput extends TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<Exclude<TInput, TOutput>>;
     /**
      * The <i>map</i> method iterates through the collection and passes each item to <i>mapFn</i>.
      * The <i>mapFn</i> is free to modify the item and return it, thus forming a new collection of modified items.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]);
      * const mapped = collection.map(item => item * 2);
      * await mapped.toArray();
      * // [2, 4, 6, 8, 10]
+     * ```
      */
     map<TOutput>(mapFn: AsyncMap<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<TOutput>;
     /**
      * The <i>reduce</i> method executes <i> reduceFn </i> function on each item of the array, passing in the return value from the calculation on the preceding item.
      * The final result of running the reducer across all items of the array is a single value.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * await collection.reduce((sum, item) => sum + item);
      * // 6
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c"]);
@@ -88,6 +91,7 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      *   {} as Record<number, string>
      * );
      * // { 0: "a", 1: "b", 2: "c" }
+     * ```
      */
     reduce(reduceFn: AsyncReduce<TInput, IAsyncCollection<TInput>, TInput>): PromiseLike<TInput>;
     reduce(reduceFn: AsyncReduce<TInput, IAsyncCollection<TInput>, TInput>, initialValue: TInput): PromiseLike<TInput>;
@@ -96,72 +100,139 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>join</i> method joins the collection's items with <i> separator </i>. An error will be thrown when if a none string item is encounterd.
      * @throws {TypeCollectionError}
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.map(item => item.toString()).join();
      * // "1,2,3,4"
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.map(item => item.toString()).join("_");
      * // "1_2_3_4"
+     * ```
      */
     join(separator?: string): PromiseLike<Extract<TInput, string>>;
     /**
      * The <i>collapse</i> method collapses a collection of iterables into a single, flat collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([[1, 2], [3, 4]]);
      * const collapsed = collection.collapse();
      * await collapsed.toArray();
      * // [1, 2, 3, 4]
+     * ```
      */
     collapse(): IAsyncCollection<AsyncCollapse<TInput>>;
     /**
      * The <i>flatMap</i> method returns a new array formed by applying <i>mapFn</i> to each item of the array, and then collapses the result by one level.
      * It is identical to a <i>map</i> method followed by a <i>collapse</i> method.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([["a", "b"], ["c", "d"]]).flatMap(item => [item.length, ...item]);
      * await collection.toArray();
      * // [2, "a", "b", 2, "c", "d"]
+     * ```
      */
     flatMap<TOutput>(mapFn: AsyncMap<TInput, IAsyncCollection<TInput>, Iterable<TOutput>>): IAsyncCollection<TOutput>;
     /**
      * The <i>change</i> method changes only the items that passes <i>predicateFn</i> using <i>mapFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]);
      * const newCollection = collection.change(item => item % 2 === 0, item => item * 2);
      * await newCollection.toArray();
      * // [1, 4, 3, 8, 5]
+     * ```
      */
-    change<TFilterOutput extends TInput, TMapOutput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TFilterOutput>, mapFn: AsyncMap<TFilterOutput, IAsyncCollection<TInput>, TMapOutput>): IAsyncCollection<ChangendItem<TInput, TFilterOutput, TMapOutput>>;
+    change<TFilterOutput extends TInput, TMapOutput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TFilterOutput>, mapFn: AsyncMap<TFilterOutput, IAsyncCollection<TInput>, TMapOutput>): IAsyncCollection<TInput | TFilterOutput | TMapOutput>;
+    /**
+     * The <i>set</i> method changes a item by i>index</i> using <i>value</i>.
+     * @example
+     * ```ts
+     * import { AsyncIterableCollection } from "@daiso-tech/core";;
+     *
+     * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]);
+     * const newCollection = collection.set(1, -1);
+     * await newCollection.toArray();
+     * // [1, -1, 3, 4, 5]
+     * ```
+     * @example
+     * ```ts
+     * import { AsyncIterableCollection } from "@daiso-tech/core";;
+     *
+     * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]);
+     * const newCollection = collection.set(1, (prevValue) => prevValue - 2);
+     * await newCollection.toArray();
+     * // [1, 0, 3, 4, 5]
+     * ```
+     */
+    set(index: number, value: TInput | AsyncMap<TInput, IAsyncCollection<TInput>, TInput>): IAsyncCollection<TInput>;
+    /**
+     * The <i>get</i> method returns the item by index. If the item is not found null will returned.
+     * @example
+     * ```ts
+     * import { AsyncIterableCollection } from "@daiso-tech/core";;
+     *
+     * const collection = new AsyncIterableCollection([1, 4, 2, 8, -2]);
+     * // Will be 2
+     * await collection.get(2);
+     *
+     * // Will be null
+     * await collection.get(5);
+     * ```
+     */
+    get(index: number): PromiseLike<TInput | null>;
+    /**
+     * The <i>getOrFail</i> method returns the item by index. If the item is not found an error will be thrown.
+     * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
+     * @throws {ItemNotFoundCollectionError} {@link ItemNotFoundCollectionError}
+     * @example
+     * ```ts
+     * import { AsyncIterableCollection } from "@daiso-tech/core";;
+     *
+     * const collection = new AsyncIterableCollection([1, 4, 2, 8, -2]);
+     * // Will be 2
+     * await collection.getOrFail(2);
+     *
+     * // An error will thrown
+     * await collection.getOrFail(5);
+     * ```
+     */
+    getOrFail(index: number): PromiseLike<TInput>;
     /**
      * The <i>page</i> method returns a new collection containing the items that would be present on <i> page </i> with custom <i> pageSize </i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6, 7, 8, 9]);
      * const page = collection.page(2, 3);
      * await page.toArray();
      * // [4, 5, 6]
+     * ```
      */
     page(page: number, pageSize: number): IAsyncCollection<TInput>;
     /**
      * The <i>sum</i> method returns the sum of all items in the collection. If the collection includes other than number items an error will be thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * await collection.sum();
      * // 6
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {TypeCollectionError} {@link TypeCollectionError}
      * @throws {EmptyCollectionError} {@link EmptyCollectionError}
@@ -170,12 +241,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>average</i> method returns the average of all items in the collection. If the collection includes other than number items an error will be thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * await collection.average();
      * // 2
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {TypeCollectionError} {@link TypeCollectionError}
      * @throws {EmptyCollectionError} {@link EmptyCollectionError}
@@ -184,12 +256,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>median</i> method returns the median of all items in the collection. If the collection includes other than number items an error will be thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * await collection.median();
      * // 2
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {TypeCollectionError} {@link TypeCollectionError}
      * @throws {EmptyCollectionError} {@link EmptyCollectionError}
@@ -198,12 +271,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>min</i> method returns the min of all items in the collection. If the collection includes other than number items an error will be thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * await collection.min();
      * // 1
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {TypeCollectionError} {@link TypeCollectionError}
      * @throws {EmptyCollectionError} {@link EmptyCollectionError}
@@ -212,12 +286,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>max</i> method returns the max of all items in the collection. If the collection includes other than number items an error will be thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * await collection.max();
      * // 3
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {TypeCollectionError} {@link TypeCollectionError}
      * @throws {EmptyCollectionError} {@link EmptyCollectionError}
@@ -226,12 +301,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>percentage</i> method may be used to quickly determine the percentage of items in the collection that pass <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 1, 2, 2, 2, 3]);
      * await collection.percentage(value => value === 1);
      * // 33.333
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {EmptyCollectionError} {@link EmptyCollectionError}
      */
@@ -239,100 +315,117 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>some</i> method determines whether at least one item in the collection matches <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([0, 1, 2, 3, 4, 5]);
      * await collection.some(item => item === 1);
      * // true
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     some<TOutput extends TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): PromiseLike<boolean>;
     /**
      * The <i>every</i> method determines whether all items in the collection matches <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([0, 1, 2, 3, 4, 5]);
      * await collection.every(item => item < 6);
      * // true
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     every<TOutput extends TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): PromiseLike<boolean>;
     /**
      * The <i>take</i> method takes the first <i>limit</i> items.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([0, 1, 2, 3, 4, 5]);
      * const chunk = collection.take(3);
      * await chunk.toArray();
      * // [0, 1, 2]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([0, 1, 2, 3, 4, 5]);
      * const chunk = collection.take(-2);
      * await chunk.toArray();
      * // [0, 1, 2, 3]
+     * ```
      */
     take(limit: number): IAsyncCollection<TInput>;
     /**
      * The <i>takeUntil</i> method takes items until <i>predicateFn</i> returns true.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * const chunk = collection.takeUntil(item => item >= 3);
      * await chunk.toArray();
      * // [1, 2]
+     * ```
      */
     takeUntil(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): IAsyncCollection<TInput>;
     /**
      * The <i>takeWhile</i> method takes items until <i>predicateFn</i> returns false.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * const chunk = collection.takeWhile(item => item < 4);
      * await chunk.toArray();
      * // [1, 2, 3]
+     * ```
      */
     takeWhile(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): IAsyncCollection<TInput>;
     /**
      * The <i>skip</i> method skips the first <i>offset</i> items.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]).skip(4);
      * await collection.toArray();
      * // [5, 6, 7, 8, 9, 10]
+     * ```
      */
     skip(offset: number): IAsyncCollection<TInput>;
     /**
      * The <i>skipUntil</i> method skips items until <i>predicateFn</i> returns true.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]).skipUntil(item => item >= 3);
      * await collection.toArray();
      * // [3, 4]
+     * ```
      */
     skipUntil(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): IAsyncCollection<TInput>;
     /**
      * The <i>skipWhile</i> method skips items until <i>predicateFn</i> returns false.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]).skipWhile(item => item <= 3);
      * await collection.toArray();
      * // [4]
+     * ```
      */
     skipWhile(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): IAsyncCollection<TInput>;
     /**
      * The <i>when</i> method will execute <i>callback</i> when <i>condition</i> evaluates to true.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4])
@@ -340,29 +433,35 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      *  .when(false, collection => collection.append([20]));
      * await collection.toArray();
      * // [1, 2, 3, 4, -3]
+     * ```
      */
     when<TExtended = TInput>(condition: boolean, callback: AsyncModifier<IAsyncCollection<TInput>, IAsyncCollection<TExtended>>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>whenEmpty</i> method will execute <i>callback</i> when the collection is empty.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([])
      *  .whenEmpty(collection => collection.append([-3]))
      * await collection.toArray();
      * // [-3]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1])
      *  .whenEmpty(collection => collection.append([-3]))
      * await collection.toArray();
      * // [1]
+     * ```
      */
     whenEmpty<TExtended = TInput>(callback: AsyncModifier<IAsyncCollection<TInput>, IAsyncCollection<TExtended>>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>whenNot</i> method will execute <i>callback</i> when <i>condition</i> evaluates to false.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4])
@@ -370,30 +469,36 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      *  .whenNot(false, collection => collection.append([20]));
      * await collection.toArray();
      * // [1, 2, 3, 4, 20]
+     * ```
      */
     whenNot<TExtended = TInput>(condition: boolean, callback: AsyncModifier<IAsyncCollection<TInput>, IAsyncCollection<TExtended>>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>whenNotEmpty</i> method will execute <i>callback</i> when the collection is not empty.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([])
      *  .whenNotEmpty(collection => collection.append([-3]))
      * await collection.toArray();
      * // []
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1])
      *  .whenNotEmpty(collection => collection.append([-3]))
      * await collection.toArray();
      * // [1, -3]
+     * ```
      */
     whenNotEmpty<TExtended = TInput>(callback: AsyncModifier<IAsyncCollection<TInput>, IAsyncCollection<TExtended>>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>pipe</i> method passes the orignal collection to <i>callback</i> and returns the result from <i>callback</i>.
      * This method is useful when you want compose multiple smaller functions.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, "2", "a", 1, 3, {}]);
@@ -410,11 +515,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * const piped = await collection.pipe(toNbrs).then(nbrToStr);
      * console.log(piped);
      * // [ 1, 2, 1, 3 ]
+     * ```
      */
     pipe<TOutput = TInput>(callback: AsyncTransform<IAsyncCollection<TInput>, TOutput>): PromiseLike<TOutput>;
     /**
      * The <i>tap</i> method passes a copy of the original collection to <i>callback</i>, allowing you to do something with the items while not affecting the original collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = await new AsyncIterableCollection([1, 2, 3, 4, 5, 6])
@@ -425,24 +532,28 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      *   })
      *   .toArray();
      * // [1, 2, 3, 4, 5, 6]
+     * ```
      */
     tap(callback: AsyncTap<IAsyncCollection<TInput>>): IAsyncCollection<TInput>;
     /**
      * The <i>chunk</i> method breaks the collection into multiple, smaller collections of size <i>chunkSize</i>.
      * If <i>chunkSize</i> is not divisible with total number of items then the last chunk will contain the remaining items.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6, 7]);
      * const chunks = collection.chunk(4);
      * await chunks.map(chunk => chunk.toArray()).toArray();
      * // [[1, 2, 3, 4], [5, 6, 7]]
+     * ```
      */
     chunk(chunkSize: number): IAsyncCollection<IAsyncCollection<TInput>>;
     /**
      * The <i>chunkWhile</i> method breaks the collection into multiple, smaller collections based on the evaluation of <i>predicateFn</i>.
      * The chunk variable passed to the <i>predicateFn</i> may be used to inspect the previous item.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection("AABBCCCD");
@@ -451,25 +562,31 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * });
      * await chunks.map(chunk => chunk.toArray()).toArray();
      * //  [["A", "A"], ["B", "B"], ["C", "C", "C"], ["D"]]
+     * ```
      */
     chunkWhile(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): IAsyncCollection<IAsyncCollection<TInput>>;
     /**
      * The <i>split</i> method breaks a collection evenly into <i>chunkAmount</i> of chunks.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]);
      * const chunks = collection.split(3);
      * await chunks.map(chunk => chunk.toArray()).toArray();
      * // [[1, 2], [3, 4], [5]]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6]);
      * const chunks = collection.split(3);
      * await chunks.map(chunk => chunk.toArray()).toArray();
      * // [[1, 2], [3, 4], [5, 6]]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6, 7]);
@@ -481,29 +598,34 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>partition</i> method is used to separate items that pass <i>predicateFn</i> from those that do not.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6]);
      * const chunks = collection.partition(item => item < 3);
      * await chunks.map(chunk => chunk.toArray()).toArray();
      * // [[1, 2], [3, 4, 5, 6]]
+     * ```
      */
     partition(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): IAsyncCollection<IAsyncCollection<TInput>>;
     /**
      * The <i>sliding</i> method returns a new collection of chunks representing a "sliding window" view of the items in the collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5])
      * const chunks = collection.sliding(2);
      * await chunks.map(chunk => chunk.toArray()).toArray();
      * // [[1, 2], [2, 3], [3, 4], [4, 5]]
+     * ```
      */
     sliding(chunkSize: number, step?: number): IAsyncCollection<IAsyncCollection<TInput>>;
     /**
      * The <i>groupBy</i> method groups the collection's items by <i> selectFn </i>.
      * By default the equality check occurs on the item.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "a", "a", "b", "b", "c"]);
@@ -525,7 +647,9 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //    ["c"]
      * //  ]
      * // ]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["alice@gmail.com", "bob@yahoo.com", "carlos@gmail.com"]);
@@ -543,12 +667,14 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //     ["bob@yahoo.com"]
      * //   ]
      * // ]
+     * ```
      */
     groupBy<TOutput = TInput>(selectFn?: AsyncMap<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<RecordItem<TOutput, IAsyncCollection<TInput>>>;
     /**
      * The <i>countBy</i> method counts the occurrences of values in the collection by <i> selectFn </i>.
      * By default the equality check occurs on the item.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "a", "a", "b", "b", "c"]);
@@ -561,7 +687,9 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //  ["b", 2],
      * //  ["c", 1]
      * // ]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["alice@gmail.com", "bob@yahoo.com", "carlos@gmail.com"]);
@@ -572,18 +700,22 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //   ["gmail.com", 2],
      * //   ["yahoo.com", 1]
      * // ]
+     * ```
      */
     countBy<TOutput = TInput>(selectFn?: AsyncMap<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<RecordItem<TOutput, number>>;
     /**
      * The <i>unique</i> method removes all duplicate values from the collection by <i> selectFn </i>.
      * By default the equality check occurs on the item.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 1, 2, 2, 3, 4, 2]);
      * await collection.unique().toArray();
      * // [1, 2, 3, 4]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([
@@ -600,19 +732,23 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //   { name: "iPhone 6", brand: "Apple", type: "phone" },
      * //   { name: "Galaxy S6", brand: "Samsung", type: "phone" },
      * // ]
+     * ```
      */
     unique<TOutput = TInput>(selectFn?: AsyncMap<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<TInput>;
     /**
      * The <i>difference</i> method will return the values in the original collection that are not present in <i>iterable</i>.
      * By default the equality check occurs on the item.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 2, 3, 4, 5]);
      * const difference = collection.difference([2, 4, 6, 8]);
      * await difference.toArray();
      * // [1, 3, 5]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([
@@ -634,23 +770,27 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //   { name: "iPhone 5", brand: "Apple", type: "phone" },
      * //   { name: "Galaxy S6", brand: "Samsung", type: "phone" },
      * // ]
+     * ```
      */
     difference<TOutput = TInput>(iterable: AsyncIterableValue<TInput>, selectFn?: AsyncMap<TInput, IAsyncCollection<TInput>, TOutput>): IAsyncCollection<TInput>;
     /**
      * The <i>repeat</i> method will repeat the original collection <i>amount</i> times.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3]);
      * const newCollection = collection.repeat(3);
      * await newCollection.toArray();
      * // [1, 2, 3,  1, 2, 3,  1, 2, 3]
+     * ```
      */
     repeat(amount: number): IAsyncCollection<TInput>;
     /**
      * The <i>padStart</i> method pads this collection with <i>fillItems</i> until the resulting collection size reaches <i>maxLength</i>.
      * The padding is applied from the start of this collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * await new AsyncIterableCollection("abc").padStart(10, "foo").join("");
@@ -664,12 +804,14 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      *
      * await new AsyncIterableCollection("abc").padStart(1, "_").join("");
      * // "abc"
+     * ```
      */
     padStart<TExtended = TInput>(maxLength: number, fillItems: AsyncIterableValue<TExtended>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>padEnd</i> method pads this collection with <i>fillItems</i> until the resulting collection size reaches <i>maxLength</i>.
      * The padding is applied from the end of this collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * await new AsyncIterableCollection("abc").padEnd(10, "foo").join("");
@@ -683,92 +825,114 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      *
      * await new AsyncIterableCollection("abc").padEnd(1, "_").join("");
      * // "abc"
+     * ```
      */
     padEnd<TExtended = TInput>(maxLength: number, fillItems: AsyncIterableValue<TExtended>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>slice</i> method creates porition of the original collection selected from <i>start</i> and <i>end</i>
      * where <i>start</i> and <i>end</i> (end not included) represent the index of items in the collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]);
      * await collection.slice(3).toArray();
      * // ["d", "e", "f"]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]);
      * await collection.slice(undefined, 2).toArray();
      * // ["a", "b"]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]);
      * await collection.slice(2, 5).toArray();
      * // ["c", "d", "e"]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]);
      * await collection.slice(-2).toArray();
      * // ["e", "f"]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]);
      * await collection.slice(undefined, -2).toArray();
      * // ["a", "b", "c", "d"]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]);
      * await collection.slice(-4, -2).toArray();
      * // ["c", "d"]
+     * ```
      */
     slice(start?: number, end?: number): IAsyncCollection<TInput>;
     /**
      * The <i>prepend</i> method adds <i>iterable</i> to the beginning of the collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]).prepend([-1, 20]);
      * await collection.toArray();
      * // [-1, 20, 1, 2, 3, 4, 5]
+     * ```
      */
     prepend<TExtended = TInput>(iterable: AsyncIterableValue<TInput | TExtended>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>append</i> method adds <i>iterable</i> to the end of the collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]).append([-1, -2]);
      * await collection.toArray();
      * // [1, 2, 3, 4, 5, -1, -2,]
+     * ```
      */
     append<TExtended = TInput>(iterable: AsyncIterableValue<TInput | TExtended>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>insertBefore</i> method adds <i>iterable</i> before the first item that matches <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 2, 3, 4, 5]).insertBefore(item => item === 2, [-1, 20]);
      * await collection.toArray();
      * // [1, -1, 20, 2, 2, 3, 4, 5]
+     * ```
      */
     insertBefore<TExtended = TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>, iterable: AsyncIterableValue<TInput | TExtended>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>insertAfter</i> method adds <i>iterable</i> after the first item that matches <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 2, 3, 4, 5]).insertAfter(item => item === 2, [-1, 20]);
      * await collection.toArray();
      * // [1, 2, -1, 20, 2, 3, 4, 5]
+     * ```
      */
     insertAfter<TExtended = TInput>(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>, iterable: AsyncIterableValue<TInput | TExtended>): IAsyncCollection<TInput | TExtended>;
     /**
      * The <i>crossJoin</i> method cross joins the collection's values among <i>iterables</i>, returning a Cartesian product with all possible permutations.
      * @example
+     * ```ts
      * import { ListCollection } from "@daiso-tech/core";;
      *
      * const collection = new ListCollection([1, 2]);
@@ -780,7 +944,9 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //  [2, "a"],
      * //  [2, "b"],
      * // ]
+     * ```
      * @example
+     * ```ts
      * import { ListCollection } from "@daiso-tech/core";;
      *
      * const collection = new ListCollection([1, 2]);
@@ -796,43 +962,53 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //  [2, "b", "I"],
      * //  [2, "b", "II"],
      * // ]
+     * ```
      */
     crossJoin<TExtended>(iterable: AsyncIterableValue<TExtended>): IAsyncCollection<CrossJoinResult<TInput, TExtended>>;
     /**
      * The <i>zip</i> method merges together the values of <i>iterable</i> with the values of the collection at their corresponding index.
      * The returned collection has size of the shortest collection.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["Chair", "Desk"]);
      * const zipped = collection.zip([100, 200]);
      * await zipped.toArray();
      * // [["Chair", 100], ["Desk", 200]]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["Chair", "Desk", "Couch"]);
      * const zipped = collection.zip([100, 200]);
      * await zipped.toArray();
      * // [["Chair", 100], ["Desk", 200]]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["Chair", "Desk"]);
      * const zipped = collection.zip([100, 200, 300]);
      * await zipped.toArray();
      * // [["Chair", 100], ["Desk", 200]]
+     * ```
      */
     zip<TExtended>(iterable: AsyncIterableValue<TExtended>): IAsyncCollection<RecordItem<TInput, TExtended>>;
     /**
      * The <i>sort</i> method sorts the collection. You can provide a <i>comparator</i> function.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([-1, 2, 4, 3]);
      * await collection.sort().toArray();
      * // [-1, 2, 3, 4]
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([
@@ -848,17 +1024,20 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * //   { name: "Hasan", age: 25 },
      * //   { name: "Anders", age: 30 },
      * // ]
+     * ```
      */
     sort(comparator?: Comparator<TInput>): IAsyncCollection<TInput>;
     /**
      * The <i>reverse</i> method will reverse the order of the collection.
      * The reversing of the collection will be applied in chunks that are the size of <i> chunkSize </i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([-1, 2, 4, 3]);
      * await collection.reverse().toArray();
      * // [3, 4, 2, -1]
+     * ```
      */
     reverse(chunkSize?: number): IAsyncCollection<TInput>;
     /**
@@ -869,24 +1048,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>first</i> method returns the first item in the collection that passes <i> predicateFn </i>.
      * By default it will get the first item. If the collection is empty or no items passes <i> predicateFn </i> than null i returned.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.first();
      * // 1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.first(item => item > 2);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.first(item => item > 10);
      * // null
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * // 3
      */
@@ -895,30 +1079,37 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>firstOr</i> method returns the first item in the collection that passes <i> predicateFn </i>
      * By default it will get the first item. If the collection is empty or no items passes <i> predicateFn </i> than <i> defaultValue </i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOr(-1);
      * // 1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOr(-1, item => item > 2);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOr(-1, item => item > 10);
      * // -1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOr(() => -1, item => item > 10);
      * // -1
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     firstOr<TOutput extends TInput, TExtended = TInput>(defaultValue: AsyncLazyable<TExtended>, predicateFn?: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): PromiseLike<TOutput | TExtended>;
@@ -926,24 +1117,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>firstOrFail</i> method returns the first item in the collection that passes <i> predicateFn </i>.
      * By default it will get the first item. If the collection is empty or no items passes <i> predicateFn </i> than error is thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOrFail();
      * // 1
      * @example
+     * ```
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOrFail(item => item > 2);
      * // 3
      * @example
+     * ```
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.firstOrFail(item => item > 10);
      * // throws an error
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {ItemNotFoundCollectionError} {@link ItemNotFoundCollectionError}
      */
@@ -952,24 +1148,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>last</i> method returns the last item in the collection that passes <i> predicateFn </i>.
      * By default it will get the last item. If the collection is empty or no items passes <i> predicateFn </i> than null i returned.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.last();
      * // 4
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.last(item => item < 4);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.last(item => item > 10);
      * // null
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * // 3
      */
@@ -978,30 +1179,37 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>lastOr</i> method returns the last item in the collection that passes <i> predicateFn </i>.
      * By default it will get the last item. If the collection is empty or no items passes <i> predicateFn </i> than <i> defaultValue </i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOr(-1);
      * // 4
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOr(-1, item => item < 4);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOr(-1, item => item > 10);
      * // -1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOr(() => -1, item => item > 10);
      * // -1
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     lastOr<TOutput extends TInput, TExtended = TInput>(defaultValue: AsyncLazyable<TExtended>, predicateFn?: AsyncPredicate<TInput, IAsyncCollection<TInput>, TOutput>): PromiseLike<TOutput | TExtended>;
@@ -1009,24 +1217,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>lastOrFail</i> method returns the last item in the collection that passes <i> predicateFn </i>.
      * By default it will get the last item. If the collection is empty or no items passes <i> predicateFn </i> than error is thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOrFail();
      * // 4
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOrFail(item => item < 4);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.lastOrFail(item => item > 10);
      * // throws an error
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {ItemNotFoundCollectionError} {@link ItemNotFoundCollectionError}
      */
@@ -1035,18 +1248,21 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>before</i> method returns the item that comes before the first item that matches <i>predicateFn</i>.
      * If the <i>predicateFn</i> does not match or matches the first item then null is returned.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.before(item => item === 2);
      * // 1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.before(item => item === 1);
      * // null
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     before(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<TInput | null>;
@@ -1054,24 +1270,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>beforeOr</i> method returns the item that comes before the first item that matches <i>predicateFn</i>.
      * If the collection is empty or the <i>predicateFn</i> does not match or matches the first item then <i>defaultValue</i> is returned.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.beforeOr(-1, item => item === 2);
      * // 1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.beforeOr(-1, item => item === 1);
      * // -1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.beforeOr(() => -1, item => item === 1);
      * // -1
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     beforeOr<TExtended = TInput>(defaultValue: AsyncLazyable<TExtended>, predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<TInput | TExtended>;
@@ -1079,18 +1300,21 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>beforeOrFail</i> method returns the item that comes before the first item that matches <i>predicateFn</i>.
      * If the collection is empty or the <i>predicateFn</i> does not match or matches the first item then an error is thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.beforeOrFail(item => item === 2);
      * // 1
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.beforeOrFail(item => item === 1);
      * // error is thrown
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {ItemNotFoundCollectionError} {@link ItemNotFoundCollectionError}
      */
@@ -1099,18 +1323,21 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>after</i> method returns the item that comes after the first item that matches <i>predicateFn</i>.
      * If the collection is empty or the <i>predicateFn</i> does not match or matches the last item then null is returned.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.after(item => item === 2);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.after(item => item === 4);
      * // null
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     after(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<TInput | null>;
@@ -1118,24 +1345,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>afterOr</i> method returns the item that comes after the first item that matches <i>predicateFn</i>.
      * If the collection is empty or the <i>predicateFn</i> does not match or matches the last item then <i>defaultValue</i> is returned.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.afterOr(-1, item => item === 2);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.afterOr(-1, item => item === 4);
      * // -1
      * @example
+     * ```
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.afterOr(() => -1, item => item === 4);
      * // -1
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     afterOr<TExtended = TInput>(defaultValue: AsyncLazyable<TExtended>, predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<TInput | TExtended>;
@@ -1143,18 +1375,21 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>afterOrFail</i> method returns the item that comes after the first item that matches <i>predicateFn</i>.
      * If the collection is empty or the <i>predicateFn</i> does not match or matches the last item then an error is thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.afterOrFail(item => item === 2);
      * // 3
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4]);
      * await collection.afterOrFail(item => item === 4);
      * // error is thrown
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {ItemNotFoundCollectionError} {@link ItemNotFoundCollectionError}
      */
@@ -1163,24 +1398,29 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>sole</i> method returns the first item in the collection that passes <i>predicateFn</i>, but only if <i>predicateFn</i> matches exactly one item.
      * If no items matches or multiple items are found an error will be thrown.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5]);
      * await collection.sole(item => item === 4);
      * // 4
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 4, 5]);
      * await collection.sole(item => item === 4);
      * // error is thrown
+     * ```
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 5]);
      * await collection.sole(item => item === 4);
      * // error is thrown
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      * @throws {ItemNotFoundCollectionError} {@link ItemNotFoundCollectionError}
      * @throws {MultipleItemsFoundCollectionError} {@link MultipleItemsFoundCollectionError}
@@ -1189,76 +1429,76 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
     /**
      * The <i>nth</i> method creates a new collection consisting of every n-th item.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "c", "d", "e", "f"]).nth(4);
      * await collection.toArray();
      * // ["a", "e"]
+     * ```
      */
     nth(step: number): IAsyncCollection<TInput>;
     /**
      * The <i>count</i> method returns the total number of items in the collection that passes <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection([1, 2, 3, 4, 5, 6]);
      * await collection.count(value => value % 2 === 0);
      * // 3
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     count(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<number>;
     /**
      * The <i>size</i> returns the size of the collection.
-     * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     size(): PromiseLike<number>;
     /**
      * The <i>isEmpty</i> returns true if the collection is empty.
-     * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     isEmpty(): PromiseLike<boolean>;
     /**
      * The <i>isNotEmpty</i> returns true if the collection is not empty.
-     * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     isNotEmpty(): PromiseLike<boolean>;
     /**
      * The <i>searchFirst</i> return the index of the first item that matches <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "b", "c"]);
      * await collection.searchFirst(item => item === "b");
      * // 1
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     searchFirst(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<number>;
     /**
      * The <i>searchLast</i> return the index of the last item that matches <i>predicateFn</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * const collection = new AsyncIterableCollection(["a", "b", "b", "c"]);
      * await collection.searchLast(item => item === "b");
      * // 2
-     * @throws {CollectionError} {@link CollectionError}
+     * ```
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     searchLast(predicateFn: AsyncPredicate<TInput, IAsyncCollection<TInput>>): PromiseLike<number>;
     /**
      * The <i>forEach</i> method iterates through all items in the collection.
-     * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     forEach(callback: AsyncForEach<TInput, IAsyncCollection<TInput>>): PromiseLike<void>;
     /**
      * The <i>toArray</i> method converts the collection to a new array.
-     * @throws {CollectionError} {@link CollectionError}
      * @throws {UnexpectedCollectionError} {@link UnexpectedCollectionError}
      */
     toArray(): PromiseLike<TInput[]>;
@@ -1266,6 +1506,7 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * The <i>delay</i> method will add delay between each iteration.
      * This method is especially useful for situations where you may be interacting with external APIs that rate limit incoming requests:
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * // An iterator that will fetch all users from a specific api
@@ -1273,11 +1514,13 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * const apiIterator = new ApiIterator();
      * const collection = new AsyncIterableCollection(apiIterator);
      * await collection.delay(1000).forEach(user => console.log(user))
+     * ```
      */
     delay(time: TimeSpan): IAsyncCollection<TInput>;
     /**
      * The <i>abort</i> method will abort iteration of the collection by passing <i>{@link AbortSignal}</i>.
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * // An iterator that will fetch all users from a specific api
@@ -1285,12 +1528,14 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * const apiIterator = new ApiIterator();
      * const collection = new AsyncIterableCollection(apiIterator);
      * await collection.delay(1000).forEach(user => console.log(user))
+     * ```
      */
     takeUntilAbort(abortSignal: AbortSignal, shouldThrow?: boolean): IAsyncCollection<TInput>;
     /**
      * The <I>timeout</i> method returns a new collection that will iterate values until the specified time.
      * After that time, the collection will then stop iterating:
      * @example
+     * ```ts
      * import { AsyncIterableCollection } from "@daiso-tech/core";;
      *
      * class AsyncInfiniteIterable implements AsyncIterable<number> {
@@ -1305,6 +1550,7 @@ export type IAsyncCollection<TInput> = AsyncIterable<TInput> & {
      * await collection
      *  .timeout(1000)
      *  .forEach(nbr => console.log(nbr))
+     * ```
      */
     takeUntilTimeout(timeInMs: TimeSpan, shouldThrow?: boolean): IAsyncCollection<TInput>;
 };