@tidyjs/tidy 2.4.5 → 2.5.1

package/dist/tidy.d.ts

@@ -125,12 +125,12 @@ declare function summarizeAll<T extends object, F extends SummaryKeyFn<T>>(summa
 declare function summarizeIf<T extends object, F extends SummaryKeyFn<T>>(predicateFn: (vector: Vector<T>) => boolean, summaryFn: F): TidyFn<T, A.Compute<Record<keyof T, SummaryFnOutput<T, F>>>>;
 declare function summarizeAt<T extends object, Keys extends (keyof T)[], F extends SummaryKeyFn<T, Keys[number]>>(keys: Keys, summaryFn: F): TidyFn<T, A.Compute<Record<Keys[number], SummaryFnOutput<T, F>>>>;
 
-declare type MutateSpecValue<T, O = any> = ((item: T) => O) | NonFunctionValue;
+declare type MutateSpecValue<T, O = any> = ((item: T, index: number, array: Iterable<T>) => O) | NonFunctionValue;
 declare type MutateSpec<T> = Record<Key, MutateSpecValue<T>>;
 declare type ResolvedObj<Obj extends Record<Key, MutateSpecValue<any>>> = {
     [K in keyof Obj]: Obj[K] extends (...args: any) => any ? ReturnType<Obj[K]> extends any[] ? ReturnType<Obj[K]>[number] : ReturnType<Obj[K]> : Obj[K];
 };
-declare type Mutated<T, MSpec extends MutateSpec<T>> = T & ResolvedObj<MSpec>;
+declare type Mutated<T extends object, MSpec extends MutateSpec<T>> = O.Merge<ResolvedObj<MSpec>, T>;
 declare type Compute<T> = A.Compute<T>;
 /**
  * Mutates items, one item at a time. For mutating across multiple items,
@@ -238,16 +238,16 @@ interface GroupByOptions {
 declare type GK<T extends object> = SingleOrArray<keyof T | ((d: T) => any)>;
 declare type F<I extends object, O extends object> = TidyFn<I, O>;
 declare type MergeGroupKeys<T extends object, Out extends object, Keys extends GK<T>> = Keys extends keyof T ? O.Merge<Pick<T, Keys>, Out> : Keys extends (keyof T)[] ? O.Merge<Pick<T, Keys[number]>, Out> : Out;
-declare type WithGroupKeys<T extends object, Out extends object, Keys extends GK<T>, Opts extends GroupByOptions | undefined> = NonNullable<Opts>['addGroupKeys'] extends false ? Out : MergeGroupKeys<T, Out, Keys>;
+declare type WithGroupKeys<T extends object, Out extends object, Keys extends GK<T>, Opts extends GroupByOptions> = NonNullable<Opts>['addGroupKeys'] extends false ? Out : MergeGroupKeys<T, Out, Keys>;
 /**
  * output varies based on export options
  */
-declare type GroupByOutput<T extends object, O extends object, Keys extends GK<T>, Opts extends GroupByOptions | undefined> = A.Compute<NonNullable<Opts>['export'] extends 'grouped' ? Grouped<WithGroupKeys<T, O, Keys, Opts>> : NonNullable<Opts>['export'] extends 'entries' ? EntriesOutput : NonNullable<Opts>['export'] extends 'entries-object' ? EntriesObjectOutput : NonNullable<Opts>['export'] extends 'object' ? ObjectOutput : NonNullable<Opts>['export'] extends 'map' ? Map<any, any> : NonNullable<Opts>['export'] extends 'keys' ? KeysOutput : NonNullable<Opts>['export'] extends 'values' ? ValuesOutput : NonNullable<Opts>['export'] extends 'levels' ? any : WithGroupKeys<T, O, Keys, Opts>[]>;
+declare type GroupByOutput<T extends object, O extends object, Keys extends GK<T>, Opts extends GroupByOptions> = A.Compute<NonNullable<Opts>['export'] extends 'grouped' ? Grouped<WithGroupKeys<T, O, Keys, Opts>> : NonNullable<Opts>['export'] extends 'entries' ? EntriesOutput : NonNullable<Opts>['export'] extends 'entries-object' ? EntriesObjectOutput : NonNullable<Opts>['export'] extends 'object' ? ObjectOutput : NonNullable<Opts>['export'] extends 'map' ? Map<any, any> : NonNullable<Opts>['export'] extends 'keys' ? KeysOutput : NonNullable<Opts>['export'] extends 'values' ? ValuesOutput : NonNullable<Opts>['export'] extends 'levels' ? any : WithGroupKeys<T, O, Keys, Opts>[]>;
 declare type GroupByFn<T extends object, O extends object, Keys extends GK<T>, Opts extends GroupByOptions> = Opts['export'] extends 'grouped' | 'entries' | 'entries-object' | 'object' | 'map' | 'keys' | 'values' | 'levels' ? TidyGroupExportFn<T, GroupByOutput<T, O, Keys, Opts>> : TidyFn<T, WithGroupKeys<T, O, Keys, Opts>>;
 /**
  * Nests the data by the specified groupings
  */
-declare function groupBy<T extends object, T1 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: F<T, T1>, options?: Opts): GroupByFn<T, T1, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: F<T, T1>, options: Opts): GroupByFn<T, T1, Keys, Opts>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -331,7 +331,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, T6 extends object, T7 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>, F<T5, T6>, F<T6, T7>], options?: Opts): GroupByFn<T, T7, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: F<T, T1>): GroupByFn<T, T1, Keys, GroupByOptions>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -415,7 +415,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, T6 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>, F<T5, T6>], options?: Opts): GroupByFn<T, T6, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, T6 extends object, T7 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>, F<T5, T6>, F<T6, T7>], options: Opts): GroupByFn<T, T7, Keys, Opts>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -499,7 +499,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>], options?: Opts): GroupByFn<T, T5, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, T6 extends object, T7 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>, F<T5, T6>, F<T6, T7>]): GroupByFn<T, T7, Keys, GroupByOptions>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -583,7 +583,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>], options?: Opts): GroupByFn<T, T4, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, T6 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>, F<T5, T6>], options: Opts): GroupByFn<T, T6, Keys, Opts>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -667,7 +667,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>], options?: Opts): GroupByFn<T, T3, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, T6 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>, F<T5, T6>]): GroupByFn<T, T6, Keys, GroupByOptions>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -751,7 +751,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, T2 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>], options?: Opts): GroupByFn<T, T2, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>], options: Opts): GroupByFn<T, T5, Keys, Opts>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -835,7 +835,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, T1 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>], options?: Opts): GroupByFn<T, T1, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, T5 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>, F<T4, T5>]): GroupByFn<T, T5, Keys, GroupByOptions>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -919,7 +919,7 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [], options?: Opts): GroupByFn<T, T, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>], options: Opts): GroupByFn<T, T4, Keys, Opts>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -1003,7 +1003,847 @@ declare namespace groupBy {
         readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
     };
 }
-declare function groupBy<T extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, options?: Opts): GroupByFn<T, T, Keys, Opts>;
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, T4 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>, F<T3, T4>]): GroupByFn<T, T4, Keys, GroupByOptions>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>], options: Opts): GroupByFn<T, T3, Keys, Opts>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, T1 extends object, T2 extends object, T3 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>, F<T2, T3>]): GroupByFn<T, T3, Keys, GroupByOptions>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, T1 extends object, T2 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>], options: Opts): GroupByFn<T, T2, Keys, Opts>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, T1 extends object, T2 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>, F<T1, T2>]): GroupByFn<T, T2, Keys, GroupByOptions>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, T1 extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [F<T, T1>], options: Opts): GroupByFn<T, T1, Keys, Opts>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, T1 extends object, Keys extends GK<T>>(groupKeys: Keys, fns: [F<T, T1>]): GroupByFn<T, T1, Keys, GroupByOptions>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, fns: [], options: Opts): GroupByFn<T, T, Keys, Opts>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, Keys extends GK<T>>(groupKeys: Keys, fns: []): GroupByFn<T, T, Keys, GroupByOptions>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, Keys extends GK<T>, Opts extends GroupByOptions>(groupKeys: Keys, options: Opts): GroupByFn<T, T, Keys, Opts>;
+declare namespace groupBy {
+    var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "grouped";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entries: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var entriesObject: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "entries-object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var object: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "object";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var map: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "map";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var keys: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "keys";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var values: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
+        readonly export: "values";
+        readonly flat?: boolean | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+    var levels: (options?: Omit<GroupByOptions, "export"> | undefined) => {
+        readonly export: "levels";
+        readonly flat?: boolean | undefined;
+        readonly levels?: ("object" | "map" | "entries" | "keys" | "values" | LevelSpec | "entries-object")[] | undefined;
+        readonly addGroupKeys?: boolean | undefined;
+        readonly compositeKey?: ((keys: any[]) => string) | undefined;
+        readonly single?: boolean | undefined;
+        readonly mapLeaf?: ((value: any) => any) | undefined;
+        readonly mapLeaves?: ((values: any[]) => any) | undefined;
+        readonly mapEntry?: ((entry: [any, any], level: number) => any) | undefined;
+    };
+}
+declare function groupBy<T extends object, Keys extends GK<T>>(groupKeys: Keys): GroupByFn<T, T, Keys, GroupByOptions>;
 declare namespace groupBy {
     var grouped: (options?: Omit<GroupByOptions, "levels" | "export"> | undefined) => {
         readonly export: "grouped";
@@ -1269,19 +2109,25 @@ declare type Options = {
 declare function debug<T extends object>(label?: string | null | undefined, options?: Options | null | undefined): TidyFn<T>;
 
 declare type RateOptions<T> = {
-    predicate?: (d: T) => boolean;
+    predicate?: (d: T, index: number, array: Iterable<T>) => boolean;
     allowDivideByZero?: boolean;
 };
 /**
  * Returns a function that computes a rate (numerator / denominator), setting the value to
  * 0 if denominator = 0 and numerator = 0.
  */
-declare function rate<T extends object>(numerator: keyof T | ((d: T) => number), denominator: keyof T | ((d: T) => number), options?: RateOptions<T>): (d: T) => number | undefined;
+declare function rate<T extends object>(numerator: keyof T | ((d: T, index: number, array: Iterable<T>) => number), denominator: keyof T | ((d: T, index: number, array: Iterable<T>) => number), options?: RateOptions<T>): (d: T, index: number, array: Iterable<T>) => number | undefined;
 
-declare function cumsum<T extends object>(key: keyof T | ((d: T) => number | null | undefined)): (items: T[]) => Float64Array;
+declare function cumsum<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number | null | undefined)): (items: T[]) => Float64Array;
 
 declare type RollOptions = {
     partial?: boolean;
+    /** which direction the window is aligned to (default: right, looking back)
+     * - right: current row is the last item [1,2,**3**]
+     * - left: current row is the first item [**1**,2,3]
+     * - center: current row is the center item [1,**2**,3]
+     */
+    align?: 'left' | 'center' | 'right';
 };
 /**
  * Returns a function that computes the a rolling value (e.g. moving average) by
@@ -1304,7 +2150,7 @@ declare type LagOptions = {
  * @param key The key or accessor to lag
  * @param options Options to configure roll. e.g. whether to run on partial windows.
  */
-declare function lag<T extends object>(key: keyof T | ((d: T) => any), options?: LagOptions | undefined | null): (items: any[]) => any[];
+declare function lag<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => any), options?: LagOptions | undefined | null): (items: T[]) => any[];
 
 declare type LeadOptions = {
     /** Number of positions to lead by (default: 1) */
@@ -1318,67 +2164,82 @@ declare type LeadOptions = {
  * @param key The key or accessor to lead
  * @param options Options to configure roll. e.g. whether to run on partial windows.
  */
-declare function lead<T extends object>(key: keyof T | ((d: T) => any), options?: LeadOptions | undefined | null): (items: any[]) => any[];
+declare function lead<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => any), options?: LeadOptions | undefined | null): (items: T[]) => any[];
+
+declare type RowNumberOptions = {
+    /** what to start row numbers at, default is 0 */
+    startAt?: number;
+};
+/**
+ * Returns a vector of row numbers, starting at 0
+ */
+declare function rowNumber<T>(options?: RowNumberOptions): (items: T[]) => number[];
 
+declare type SumOptions<T> = {
+    predicate?: (d: T, index: number, array: Iterable<T>) => boolean;
+};
 /**
  * Returns a function that computes the sum over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function sum<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number;
+declare function sum<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number), options?: SumOptions<T>): (items: T[]) => number;
 
 /**
  * Returns a function that computes the min over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function min<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function min<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
 /**
  * Returns a function that computes the max over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function max<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function max<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
 /**
  * Returns a function that computes the mean over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function mean<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function mean<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
 /**
  * Returns a function that computes the mean of a rate over an array of items
  * @param numerator A string key of the object or an accessor converting the object to a number
  * @param denominator A string key of the object or an accessor converting the object to a number
  */
-declare function meanRate<T extends object>(numerator: keyof T | ((d: T) => number), denominator: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function meanRate<T extends object>(numerator: keyof T | ((d: T, index: number, array: Iterable<T>) => number), denominator: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
 /**
  * Returns a function that computes the median over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function median<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function median<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
 /**
  * Returns a function that computes the deviation over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function deviation<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function deviation<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
 /**
  * Returns a function that computes the variance over an array of items
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function variance<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function variance<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => number)): (items: T[]) => number | undefined;
 
+declare type NOptions<T> = {
+    predicate?: (d: T, index: number, array: Iterable<T>) => boolean;
+};
 /**
  * Returns a function that computes the count over an array of items
  */
-declare function n(): (items: any[]) => number;
+declare function n<T>(options?: NOptions<T>): (items: T[]) => number;
 
 /**
  * Returns a function that computes the distinct count for a key
  * over an array of items. By default it counts nulls but not undefined
  */
-declare function nDistinct<T extends object>(key: keyof T | ((d: T) => any), options?: {
+declare function nDistinct<T extends object>(key: keyof T | ((d: T, index: number, array: Iterable<T>) => any), options?: {
     includeNull?: boolean;
     includeUndefined?: boolean;
 }): (items: T[]) => number;
@@ -1387,13 +2248,13 @@ declare function nDistinct<T extends object>(key: keyof T | ((d: T) => any), opt
  * Returns a function that returns the first value for the specified key
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function first<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function first<T extends object>(key: keyof T | ((d: T) => any)): (items: T[]) => any;
 
 /**
  * Returns a function that returns the last value for the specified key
  * @param key A string key of the object or an accessor converting the object to a number
  */
-declare function last<T extends object>(key: keyof T | ((d: T) => number)): (items: T[]) => number | undefined;
+declare function last<T extends object>(key: keyof T | ((d: T) => any)): (items: T[]) => any;
 
 /**
  * Returns all keys
@@ -1448,4 +2309,4 @@ declare namespace math {
   };
 }
 
-export { Comparator, Datum, Granularity, GroupKey, Grouped, Key, KeyOrFn, LevelSpec, NonFunctionValue, Primitive, SummarizeOptions, SummarizeSpec, math as TMath, TidyContext, TidyFn, TidyGroupExportFn, Vector, addRows as addItems, addRows, arrange, asc, complete, contains, count, cumsum, debug, desc, deviation, distinct, endsWith, everything, expand, fill, filter, first, fixedOrder, fullJoin, fullSeq, fullSeqDate, fullSeqDateISOString, groupBy, innerJoin, lag, last, lead, leftJoin, map, matches, max, mean, meanRate, median, min, mutate, mutateWithSummary, n, nDistinct, negate, numRange, select as pick, pivotLonger, pivotWider, rate, rename, replaceNully, roll, select, slice, sliceHead, sliceMax, sliceMin, sliceSample, sliceTail, arrange as sort, startsWith, sum, summarize, summarizeAll, summarizeAt, summarizeIf, tally, tidy, total, totalAll, totalAt, totalIf, transmute, variance, vectorSeq, vectorSeqDate, when };
+export { Comparator, Datum, Granularity, GroupKey, Grouped, Key, KeyOrFn, LevelSpec, NonFunctionValue, Primitive, SummarizeOptions, SummarizeSpec, math as TMath, TidyContext, TidyFn, TidyGroupExportFn, Vector, addRows as addItems, addRows, arrange, asc, complete, contains, count, cumsum, debug, desc, deviation, distinct, endsWith, everything, expand, fill, filter, first, fixedOrder, fullJoin, fullSeq, fullSeqDate, fullSeqDateISOString, groupBy, innerJoin, lag, last, lead, leftJoin, map, matches, max, mean, meanRate, median, min, mutate, mutateWithSummary, n, nDistinct, negate, numRange, select as pick, pivotLonger, pivotWider, rate, rename, replaceNully, roll, rowNumber, select, slice, sliceHead, sliceMax, sliceMin, sliceSample, sliceTail, arrange as sort, startsWith, sum, summarize, summarizeAll, summarizeAt, summarizeIf, tally, tidy, total, totalAll, totalAt, totalIf, transmute, variance, vectorSeq, vectorSeqDate, when };