@daiso-tech/core 0.1.4 → 0.2.0

package/dist/types/collection/iterable-collection/iterable-collection.d.ts

@@ -1,8 +1,9 @@
 /**
  * @module Collections
  */
-import { type Collapse, type Comparator, type Predicate, type FindOrSettings, type FindSettings, type ForEach, type GroupBySettings, type CountBySettings, type UniqueSettings, type ICollection, type JoinSettings, type Lazyable, type Map, type Modifier, type PageSettings, type RecordItem, type ReduceSettings, type ReverseSettings, type SliceSettings, type SlidingSettings, type Tap, type Transform, type UpdatedItem } from "../../contracts/collection/_module";
-import { type EnsureType } from "../../_shared/types";
+import { type Collapse, type Comparator, type Predicate, type ForEach, type ICollection, type Map, type Modifier, type Tap, type Transform, type ChangendItem, type Reduce, type CrossJoinResult } from "../../contracts/collection/_module";
+import { type Lazyable, type EnsureType } from "../../_shared/types";
+import { type RecordItem } from "../../_shared/types";
 /**
  * All methods that return <i>{@link ICollection}</i> are executed lazly which means they will be executed when the <i>IterableCollection</i> is iterated with <i>forEach</i> method or "for of" loop.
  * The rest of the methods are executed eagerly.
@@ -10,7 +11,6 @@ import { type EnsureType } from "../../_shared/types";
  */
 export declare class IterableCollection<TInput> implements ICollection<TInput> {
     private iterable;
-    private static THROW_ON_NUMBER_LIMIT;
     private static DEFAULT_CHUNK_SIZE;
     private static makeCollection;
     /**
@@ -19,32 +19,34 @@ export declare class IterableCollection<TInput> implements ICollection<TInput> {
     constructor(iterable: Iterable<TInput>);
     [Symbol.iterator](): Iterator<TInput>;
     toIterator(): Iterator<TInput, void>;
-    entries(throwOnIndexOverflow?: boolean): ICollection<RecordItem<number, TInput>>;
-    keys(throwOnIndexOverflow?: boolean): ICollection<number>;
+    entries(): ICollection<RecordItem<number, TInput>>;
+    keys(): ICollection<number>;
     values(): ICollection<TInput>;
-    filter<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): ICollection<TOutput>;
-    reject<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): ICollection<Exclude<TInput, TOutput>>;
-    map<TOutput>(mapFn: Map<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): ICollection<TOutput>;
-    reduce<TOutput = TInput>(settings: ReduceSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
-    join(settings?: JoinSettings): EnsureType<TInput, string>;
+    filter<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): ICollection<TOutput>;
+    reject<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): ICollection<Exclude<TInput, TOutput>>;
+    map<TOutput>(mapFn: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TOutput>;
+    reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>): TInput;
+    reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>, initialValue: TInput): TInput;
+    reduce<TOutput>(reduceFn: Reduce<TInput, ICollection<TInput>, TOutput>, initialValue: TOutput): TOutput;
+    join(separator?: string): EnsureType<TInput, string>;
     collapse(): ICollection<Collapse<TInput>>;
-    flatMap<TOutput>(mapFn: Map<TInput, ICollection<TInput>, Iterable<TOutput>>, throwOnIndexOverflow?: boolean): ICollection<TOutput>;
-    update<TFilterOutput extends TInput, TMapOutput>(predicateFn: Predicate<TInput, ICollection<TInput>, TFilterOutput>, mapFn: Map<TFilterOutput, ICollection<TInput>, TMapOutput>, throwOnIndexOverflow?: boolean): ICollection<UpdatedItem<TInput, TFilterOutput, TMapOutput>>;
-    page(settings: PageSettings): ICollection<TInput>;
+    flatMap<TOutput>(mapFn: Map<TInput, ICollection<TInput>, Iterable<TOutput>>): ICollection<TOutput>;
+    change<TFilterOutput extends TInput, TMapOutput>(predicateFn: Predicate<TInput, ICollection<TInput>, TFilterOutput>, mapFn: Map<TFilterOutput, ICollection<TInput>, TMapOutput>): ICollection<ChangendItem<TInput, TFilterOutput, TMapOutput>>;
+    page(page: number, pageSize: number): ICollection<TInput>;
     sum(): EnsureType<TInput, number>;
     average(): EnsureType<TInput, number>;
-    median(throwOnIndexOverflow?: boolean): EnsureType<TInput, number>;
+    median(): EnsureType<TInput, number>;
     min(): EnsureType<TInput, number>;
     max(): EnsureType<TInput, number>;
-    percentage(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): number;
-    some<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): boolean;
-    every<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): boolean;
-    take(limit: number, throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    takeUntil(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    takeWhile(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    skip(offset: number, throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    skipUntil(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    skipWhile<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): ICollection<TInput>;
+    percentage(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    some<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;
+    every<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;
+    take(limit: number): ICollection<TInput>;
+    takeUntil(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
+    takeWhile(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
+    skip(offset: number): ICollection<TInput>;
+    skipUntil(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
+    skipWhile<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     when<TExtended = TInput>(condition: boolean, callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     whenEmpty<TExtended = TInput>(callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     whenNot<TExtended = TInput>(condition: boolean, callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
@@ -52,47 +54,47 @@ export declare class IterableCollection<TInput> implements ICollection<TInput> {
     pipe<TOutput = TInput>(callback: Transform<ICollection<TInput>, TOutput>): TOutput;
     tap(callback: Tap<ICollection<TInput>>): ICollection<TInput>;
     chunk(chunkSize: number): ICollection<ICollection<TInput>>;
-    chunkWhile(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): ICollection<ICollection<TInput>>;
-    split(chunkAmount: number, throwOnIndexOverflow?: boolean): ICollection<ICollection<TInput>>;
-    partition(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): ICollection<ICollection<TInput>>;
-    sliding(settings: SlidingSettings): ICollection<ICollection<TInput>>;
-    groupBy<TOutput = TInput>(settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, ICollection<TInput>>>;
-    countBy<TOutput = TInput>(settings?: CountBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, number>>;
-    unique<TOutput>(settings?: UniqueSettings<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
+    chunkWhile(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<ICollection<TInput>>;
+    split(chunkAmount: number): ICollection<ICollection<TInput>>;
+    partition(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<ICollection<TInput>>;
+    sliding(chunkSize: number, step?: number): ICollection<ICollection<TInput>>;
+    groupBy<TOutput = TInput>(selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, ICollection<TInput>>>;
+    countBy<TOutput = TInput>(selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, number>>;
+    unique<TOutput>(selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     difference<TOutput = TInput>(iterable: Iterable<TInput>, mapFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     repeat(amount: number): ICollection<TInput>;
     padStart<TExtended = TInput>(maxLength: number, fillItems: Iterable<TExtended>): ICollection<TInput | TExtended>;
     padEnd<TExtended = TInput>(maxLength: number, fillItems: Iterable<TExtended>): ICollection<TInput | TExtended>;
-    slice(settings?: SliceSettings): ICollection<TInput>;
+    slice(start?: number, end?: number): ICollection<TInput>;
     prepend<TExtended = TInput>(iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
     append<TExtended = TInput>(iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
-    insertBefore<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>, throwOnIndexOverflow?: boolean): ICollection<TInput | TExtended>;
-    insertAfter<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>, throwOnIndexOverflow?: boolean): ICollection<TInput | TExtended>;
-    crossJoin<TExtended = TInput>(...iterables: Array<Iterable<TExtended>>): ICollection<ICollection<TInput | TExtended>>;
+    insertBefore<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
+    insertAfter<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
+    crossJoin<TExtended>(iterable: Iterable<TExtended>): ICollection<CrossJoinResult<TInput, TExtended>>;
     zip<TExtended>(iterable: Iterable<TExtended>): ICollection<RecordItem<TInput, TExtended>>;
     sort(comparator?: Comparator<TInput>): ICollection<TInput>;
-    reverse(settings?: ReverseSettings): ICollection<TInput>;
-    shuffle(): ICollection<TInput>;
-    first<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput | null;
-    firstOr<TOutput extends TInput, TExtended = TInput>(settings: FindOrSettings<TInput, ICollection<TInput>, TOutput, TExtended>): TOutput | TExtended;
-    firstOrFail<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
-    last<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput | null;
-    lastOr<TOutput extends TInput, TExtended = TInput>(settings: FindOrSettings<TInput, ICollection<TInput>, TOutput, TExtended>): TOutput | TExtended;
-    lastOrFail<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
-    before(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): TInput | null;
-    beforeOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): TInput | TExtended;
-    beforeOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): TInput;
-    after(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): TInput | null;
-    afterOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): TInput | TExtended;
-    afterOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): TInput;
-    sole<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, throwOnIndexOverflow?: boolean): TOutput;
+    reverse(chunkSize?: number): ICollection<TInput>;
+    shuffle(mathRandom?: () => number): ICollection<TInput>;
+    first<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | null;
+    firstOr<TOutput extends TInput, TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | TExtended;
+    firstOrFail<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput;
+    last<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | null;
+    lastOr<TOutput extends TInput, TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | TExtended;
+    lastOrFail<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput;
+    before(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | null;
+    beforeOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | TExtended;
+    beforeOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput;
+    after(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | null;
+    afterOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | TExtended;
+    afterOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput;
+    sole<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput;
     nth(step: number): ICollection<TInput>;
-    count(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): number;
-    size(throwOnIndexOverflow?: boolean): number;
+    count(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    size(): number;
     isEmpty(): boolean;
     isNotEmpty(): boolean;
-    searchFirst(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): number;
-    searchLast(predicateFn: Predicate<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): number;
-    forEach(callback: ForEach<TInput, ICollection<TInput>>, throwOnIndexOverflow?: boolean): void;
+    searchFirst(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    searchLast(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    forEach(callback: ForEach<TInput, ICollection<TInput>>): void;
     toArray(): TInput[];
 }

package/dist/types/collection/list-collection/list-collection.d.ts

@@ -1,10 +1,11 @@
 /**
  * @module Collections
  */
-import { type Collapse, type Comparator, type Predicate, type FindOrSettings, type FindSettings, type ForEach, type GroupBySettings, type CountBySettings, type UniqueSettings, type ICollection, type JoinSettings, type Lazyable, type Map, type Modifier, type PageSettings, type RecordItem, type ReduceSettings, type ReverseSettings, type SliceSettings, type SlidingSettings, type Tap, type Transform, type UpdatedItem } from "../../contracts/collection/_module";
-import { EnsureType } from "../../_shared/types";
+import { type Collapse, type Comparator, type Predicate, type ICollection, type Map, type Modifier, type Tap, type Transform, type ChangendItem, type Reduce, type ForEach, type CrossJoinResult } from "../../contracts/collection/_module";
+import { type EnsureType, type Lazyable } from "../../_shared/types";
+import { type RecordItem } from "../../_shared/types";
 /**
- * All methods in <i>ListCollection</i> are executed eagerly. The <i>throwOnIndexOverflow</i> parameter in the <i>ListCollection</i> methods doesnt have any affect.
+ * All methods in <i>ListCollection</i> are executed eagerly.
  * @group Adapters
  */
 export declare class ListCollection<TInput> implements ICollection<TInput> {
@@ -15,32 +16,34 @@ export declare class ListCollection<TInput> implements ICollection<TInput> {
     constructor(iterable?: Iterable<TInput>);
     [Symbol.iterator](): Iterator<TInput>;
     toIterator(): Iterator<TInput, void>;
-    entries(_throwOnIndexOverflow?: boolean): ICollection<RecordItem<number, TInput>>;
-    keys(_throwOnIndexOverflow?: boolean): ICollection<number>;
+    entries(): ICollection<RecordItem<number, TInput>>;
+    keys(): ICollection<number>;
     values(): ICollection<TInput>;
-    filter<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, _throwOnIndexOverflow?: boolean): ICollection<TOutput>;
-    reject<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, _throwOnIndexOverflow?: boolean): ICollection<Exclude<TInput, TOutput>>;
-    map<TOutput>(mapFn: Map<TInput, ICollection<TInput>, TOutput>, _throwOnIndexOverflow?: boolean): ICollection<TOutput>;
-    reduce<TOutput = TInput>(settings: ReduceSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
-    join(settings?: JoinSettings): EnsureType<TInput, string>;
+    filter<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): ICollection<TOutput>;
+    reject<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): ICollection<Exclude<TInput, TOutput>>;
+    map<TOutput>(mapFn: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TOutput>;
+    reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>): TInput;
+    reduce(reduceFn: Reduce<TInput, ICollection<TInput>, TInput>, initialValue: TInput): TInput;
+    reduce<TOutput>(reduceFn: Reduce<TInput, ICollection<TInput>, TOutput>, initialValue: TOutput): TOutput;
+    join(separator?: string): EnsureType<TInput, string>;
     collapse(): ICollection<Collapse<TInput>>;
-    flatMap<TOutput>(mapFn: Map<TInput, ICollection<TInput>, Iterable<TOutput>>, _throwOnIndexOverflow?: boolean): ICollection<TOutput>;
-    update<TFilterOutput extends TInput, TMapOutput>(predicateFn: Predicate<TInput, ICollection<TInput>, TFilterOutput>, mapFn: Map<TFilterOutput, ICollection<TInput>, TMapOutput>, _throwOnIndexOverflow?: boolean): ICollection<UpdatedItem<TInput, TFilterOutput, TMapOutput>>;
-    page(settings: PageSettings): ICollection<TInput>;
+    flatMap<TOutput>(mapFn: Map<TInput, ICollection<TInput>, Iterable<TOutput>>): ICollection<TOutput>;
+    change<TFilterOutput extends TInput, TMapOutput>(predicateFn: Predicate<TInput, ICollection<TInput>, TFilterOutput>, mapFn: Map<TFilterOutput, ICollection<TInput>, TMapOutput>): ICollection<ChangendItem<TInput, TFilterOutput, TMapOutput>>;
+    page(page: number, pageSize: number): ICollection<TInput>;
     sum(): EnsureType<TInput, number>;
     average(): EnsureType<TInput, number>;
-    median(_throwOnIndexOverflow?: boolean): EnsureType<TInput, number>;
+    median(): EnsureType<TInput, number>;
     min(): EnsureType<TInput, number>;
     max(): EnsureType<TInput, number>;
-    percentage(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): number;
-    some<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, _throwOnIndexOverflow?: boolean): boolean;
-    every<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, _throwOnIndexOverflow?: boolean): boolean;
-    take(limit: number, _throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    takeUntil(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    takeWhile(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    skip(offset: number, _throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    skipUntil(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): ICollection<TInput>;
-    skipWhile(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): ICollection<TInput>;
+    percentage(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    some<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;
+    every<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): boolean;
+    take(limit: number): ICollection<TInput>;
+    takeUntil(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
+    takeWhile(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
+    skip(offset: number): ICollection<TInput>;
+    skipUntil(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
+    skipWhile(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<TInput>;
     when<TExtended = TInput>(condition: boolean, callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     whenEmpty<TExtended = TInput>(callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
     whenNot<TExtended = TInput>(condition: boolean, callback: Modifier<ICollection<TInput>, ICollection<TExtended>>): ICollection<TInput | TExtended>;
@@ -48,47 +51,47 @@ export declare class ListCollection<TInput> implements ICollection<TInput> {
     pipe<TOutput = TInput>(callback: Transform<ICollection<TInput>, TOutput>): TOutput;
     tap(callback: Tap<ICollection<TInput>>): ICollection<TInput>;
     chunk(chunkSize: number): ICollection<ICollection<TInput>>;
-    chunkWhile(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): ICollection<ICollection<TInput>>;
-    split(chunkAmount: number, _throwOnIndexOverflow?: boolean): ICollection<ICollection<TInput>>;
-    partition(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): ICollection<ICollection<TInput>>;
-    sliding(settings: SlidingSettings): ICollection<ICollection<TInput>>;
-    groupBy<TOutput = TInput>(settings?: GroupBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, ICollection<TInput>>>;
-    countBy<TOutput = TInput>(settings?: CountBySettings<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, number>>;
-    unique<TOutput = TInput>(settings?: UniqueSettings<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
+    chunkWhile(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<ICollection<TInput>>;
+    split(chunkAmount: number): ICollection<ICollection<TInput>>;
+    partition(predicateFn: Predicate<TInput, ICollection<TInput>>): ICollection<ICollection<TInput>>;
+    sliding(chunkSize: number, step?: number): ICollection<ICollection<TInput>>;
+    groupBy<TOutput = TInput>(selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, ICollection<TInput>>>;
+    countBy<TOutput = TInput>(selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<RecordItem<TOutput, number>>;
+    unique<TOutput = TInput>(selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     difference<TOutput = TInput>(iterable: Iterable<TInput>, selectFn?: Map<TInput, ICollection<TInput>, TOutput>): ICollection<TInput>;
     repeat(amount: number): ICollection<TInput>;
     padStart<TExtended = TInput>(maxLength: number, fillItems: Iterable<TExtended>): ICollection<TInput | TExtended>;
     padEnd<TExtended = TInput>(maxLength: number, fillItems: Iterable<TExtended>): ICollection<TInput | TExtended>;
-    slice(settings?: SliceSettings): ICollection<TInput>;
+    slice(start?: number, end?: number): ICollection<TInput>;
     prepend<TExtended = TInput>(iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
     append<TExtended = TInput>(iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
-    insertBefore<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>, _throwOnIndexOverflow?: boolean): ICollection<TInput | TExtended>;
-    insertAfter<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>, _throwOnIndexOverflow?: boolean): ICollection<TInput | TExtended>;
-    crossJoin<TExtended = TInput>(...iterables: Array<Iterable<TExtended>>): ICollection<ICollection<TInput | TExtended>>;
+    insertBefore<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
+    insertAfter<TExtended = TInput>(predicateFn: Predicate<TInput, ICollection<TInput>>, iterable: Iterable<TInput | TExtended>): ICollection<TInput | TExtended>;
+    crossJoin<TExtended>(iterable: Iterable<TExtended>): ICollection<CrossJoinResult<TInput, TExtended>>;
     zip<TExtended>(iterable: Iterable<TExtended>): ICollection<RecordItem<TInput, TExtended>>;
     sort(comparator?: Comparator<TInput>): ICollection<TInput>;
-    reverse(_settings?: ReverseSettings): ICollection<TInput>;
-    shuffle(): ICollection<TInput>;
-    first<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput | null;
-    firstOr<TOutput extends TInput, TExtended = TInput>(settings: FindOrSettings<TInput, ICollection<TInput>, TOutput, TExtended>): TOutput | TExtended;
-    firstOrFail<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
-    last<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput | null;
-    lastOr<TOutput extends TInput, TExtended = TInput>(settings: FindOrSettings<TInput, ICollection<TInput>, TOutput, TExtended>): TOutput | TExtended;
-    lastOrFail<TOutput extends TInput>(settings?: FindSettings<TInput, ICollection<TInput>, TOutput>): TOutput;
-    before(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): TInput | null;
-    beforeOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): TInput | TExtended;
-    beforeOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): TInput;
-    after(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): TInput | null;
-    afterOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): TInput | TExtended;
-    afterOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): TInput;
-    sole<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>, _throwOnIndexOverflow?: boolean): TOutput;
+    reverse(_chunkSize?: number): ICollection<TInput>;
+    shuffle(mathRandom?: () => number): ICollection<TInput>;
+    first<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | null;
+    firstOr<TOutput extends TInput, TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | TExtended;
+    firstOrFail<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput;
+    last<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | null;
+    lastOr<TOutput extends TInput, TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput | TExtended;
+    lastOrFail<TOutput extends TInput>(predicateFn?: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput;
+    before(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | null;
+    beforeOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | TExtended;
+    beforeOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput;
+    after(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | null;
+    afterOr<TExtended = TInput>(defaultValue: Lazyable<TExtended>, predicateFn: Predicate<TInput, ICollection<TInput>>): TInput | TExtended;
+    afterOrFail(predicateFn: Predicate<TInput, ICollection<TInput>>): TInput;
+    sole<TOutput extends TInput>(predicateFn: Predicate<TInput, ICollection<TInput>, TOutput>): TOutput;
     nth(step: number): ICollection<TInput>;
-    count(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): number;
-    size(_throwOnIndexOverflow?: boolean): number;
+    count(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    size(): number;
     isEmpty(): boolean;
     isNotEmpty(): boolean;
-    searchFirst(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): number;
-    searchLast(predicateFn: Predicate<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): number;
-    forEach(callback: ForEach<TInput, ICollection<TInput>>, _throwOnIndexOverflow?: boolean): void;
+    searchFirst(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    searchLast(predicateFn: Predicate<TInput, ICollection<TInput>>): number;
+    forEach(callback: ForEach<TInput, ICollection<TInput>>): void;
     toArray(): TInput[];
 }

package/dist/types/contracts/collection/_shared.d.ts

@@ -16,147 +16,42 @@ export declare class UnexpectedCollectionError extends CollectionError {
 /**
  * @group Errors
  */
-export declare class IndexOverflowError extends CollectionError {
+export declare class ItemNotFoundCollectionError extends CollectionError {
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class ItemNotFoundError extends CollectionError {
+export declare class MultipleItemsFoundCollectionError extends CollectionError {
     constructor(message: string, cause?: unknown);
 }
 /**
  * @group Errors
  */
-export declare class MultipleItemsFoundError extends CollectionError {
+export declare class TypeCollectionError extends CollectionError {
     constructor(message: string, cause?: unknown);
 }
-export type UpdatedItem<TInput, TFilterOutput, TMapOutput> = TInput | TFilterOutput | TMapOutput;
-export type RecordItem<TKey, TValue> = [key: TKey, value: TValue];
-export type ReverseSettings = {
-    /**
-     * @defaultValue 1024
-     */
-    chunkSize?: number;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type PageSettings = {
-    page: number;
-    pageSize: number;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type JoinSettings = {
-    /**
-     * @defaultValue ","
-     */
-    seperator?: string;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type SliceSettings = {
-    /**
-     * @defaultValue 0
-     */
-    start?: number;
-    /**
-     * @defaultValue the size of the collection
-     */
-    end?: number;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type SlidingSettings = {
-    chunkSize: number;
-    /**
-     * @defaultValue SlidingSettings.chunkSize - 1
-     */
-    step?: number;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
+/**
+ * @group Errors
+ */
+export declare class EmptyCollectionError extends CollectionError {
+    constructor(message: string, cause?: unknown);
+}
+export type ChangendItem<TInput, TFilterOutput, TMapOutput> = TInput | TFilterOutput | TMapOutput;
 export type Comparator<TItem> = (itemA: TItem, itemB: TItem) => number;
 export type Predicate_<TInput, TCollection> = (item: TInput, index: number, collection: TCollection) => boolean;
 export type PredicateGuard<TInput, TCollection, TOutput extends TInput = TInput> = (item: TInput, index: number, collection: TCollection) => item is TOutput;
 export type Predicate<TInput, TCollection, TOutput extends TInput = TInput> = Predicate_<TInput, TCollection> | PredicateGuard<TInput, TCollection, TOutput>;
 export type Reduce<TInput, TCollection, TOutput> = (output: TOutput, item: TInput, index: number, collection: TCollection) => TOutput;
-export type ReduceSettings<TInput, TCollection, TOutput> = {
-    reduceFn: Reduce<TInput, TCollection, TOutput>;
-    initialValue?: TOutput;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
 export type Map<TInput, TCollection, TOutput> = (item: TInput, index: number, collection: TCollection) => TOutput;
 export type ForEach<TInput, TCollection> = (item: TInput, index: number, collection: TCollection) => void;
 export type Modifier<TInput, TOutput> = (collection: TInput) => TOutput;
 export type Tap<TCollection> = (collection: TCollection) => void;
 export type Transform<TInput, TOutput> = (value: TInput) => TOutput;
-export type Lazyable<TValue> = TValue | (() => TValue);
-export type FindSettings<TInput, TCollection, TOutput extends TInput> = {
-    predicateFn?: Predicate<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type FindOrSettings<TInput, TCollection, TOutput extends TInput, TDefault> = FindSettings<TInput, TCollection, TOutput> & {
-    defaultValue: Lazyable<TDefault>;
-};
-export type GroupBySettings<TInput, TCollection, TOutput> = {
-    /**
-     * @defaultValue (item: TInput) => item
-     */
-    selectFn?: Map<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type CountBySettings<TInput, TCollection, TOutput> = {
-    /**
-     * @defaultValue (item: TInput) => item
-     */
-    selectFn?: Map<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type UniqueSettings<TInput, TCollection, TOutput> = {
-    /**
-     * @defaultValue (item: TInput) => item
-     */
-    selectFn?: Map<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
 export type AsyncPredicate_<TInput, TCollection> = (item: TInput, index: number, collection: TCollection) => Promise<boolean>;
 export type AsyncPredicate<TInput, TCollection, TOutput extends TInput = TInput> = AsyncPredicate_<TInput, TCollection> | Predicate<TInput, TCollection, TOutput>;
 export type AsyncReduce_<TInput, TCollection, TOutput> = (output: TOutput, item: TInput, index: number, collection: TCollection) => Promise<TOutput>;
 export type AsyncReduce<TInput, TCollection, TOutput> = AsyncReduce_<TInput, TCollection, TOutput> | Reduce<TInput, TCollection, TOutput>;
-export type AsyncReduceSettings<TInput, TCollection, TOutput> = {
-    reduceFn: AsyncReduce<TInput, TCollection, TOutput>;
-    initialValue?: TOutput;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
 export type AsyncMap_<TInput, TCollection, TOutput> = (item: TInput, index: number, collection: TCollection) => Promise<TOutput>;
 export type AsyncMap<TInput, TCollection, TOutput> = AsyncMap_<TInput, TCollection, TOutput> | Map<TInput, TCollection, TOutput>;
 export type AsyncForEach_<TInput, TCollection> = (item: TInput, index: number, collection: TCollection) => Promise<void>;
@@ -167,46 +62,7 @@ export type AsyncTap_<TCollection> = (collection: TCollection) => Promise<void>;
 export type AsyncTap<TCollection> = Tap<TCollection> | AsyncTap_<TCollection>;
 export type AsyncTransform_<TInput, TOutput> = (value: TInput) => Promise<TOutput>;
 export type AsyncTransform<TInput, TOutput> = Transform<TInput, TOutput> | AsyncTransform_<TInput, TOutput>;
-export type AsyncLazyable_<TValue> = TValue | (() => Promise<TValue>);
-export type AsyncLazyable<TValue> = AsyncLazyable_<TValue> | Lazyable<TValue>;
-export type AsyncFindSettings<TInput, TCollection, TOutput extends TInput> = {
-    predicateFn?: AsyncPredicate<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type AsyncFindOrSettings<TInput, TCollection, TOutput extends TInput, TDefault> = AsyncFindSettings<TInput, TCollection, TOutput> & {
-    defaultValue: AsyncLazyable<TDefault>;
-};
-export type AsyncGroupBySettings<TInput, TCollection, TOutput> = {
-    /**
-     * @defaultValue (item: TInput) => item
-     */
-    selectFn?: AsyncMap<TInput, TCollection, TOutput>;
-    chunkSize?: number;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type AsyncCountBySettings<TInput, TCollection, TOutput> = {
-    /**
-     * @defaultValue (item: TInput) => item
-     */
-    selectFn?: AsyncMap<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
-export type AsyncUniqueSettings<TInput, TCollection, TOutput> = {
-    /**
-     * @defaultValue (item: TInput) => item
-     */
-    selectFn?: AsyncMap<TInput, TCollection, TOutput>;
-    /**
-     * @defaultValue false
-     */
-    throwOnIndexOverflow?: boolean;
-};
+export type CrossJoinResult<TInput, TExtended> = TInput extends [
+    infer R,
+    ...infer L
+] ? [R, ...L, TExtended] : [TInput, TExtended];