import { Comparator, Getter, type Nullable, type Predicate } from '../types/index.js';
/** type-safe `Array.isArray` wrapper  */
export declare function isArray<T>(value: any): value is T[];
export declare function arrayCompareG<T>(arr: ReadonlyArray<T> | null | undefined, cond: (current: T, previous: T | null) => boolean): T | null;
export declare function arrayCompare(arr: ReadonlyArray<number> | null | undefined, absolute: boolean, cond: (i: number, t: number) => boolean): number | null;
export declare function arrayMax(arr: ReadonlyArray<number>, absolute?: boolean): number | null;
export declare function arrayMin(arr: ReadonlyArray<number>, absolute?: boolean): number | null;
export declare function arrayAverage(arr: ReadonlyArray<number> | null | undefined, absolute?: boolean): number;
export declare function arrayCount<T>(arr: ReadonlyArray<T> | null | undefined, condition: (o: T) => boolean): number;
type KeyOf<T> = {
    [K in keyof T]: T[K] extends string | number ? K : never;
}[(string & keyof T)];
/** @returns count of items in array per key, filtered off by predicate */
export declare function arrayCountByKey<T, TKey extends KeyOf<T>>(arr: ReadonlyArray<T>, key: TKey, predicate?: Predicate<T>): Record<string | number, number>;
export declare function arrayFirstResult<T, V>(arr: ReadonlyArray<T> | null | undefined, mapper: (o: T) => V | null | false): V | null | false;
export declare function arraysCompare<T>(base: ReadonlyArray<T> | null | undefined, target: readonly T[], comparator?: Comparator<T>): {
    missing: T[];
    extra: T[];
    diff: number;
} | null;
export declare function arraysCompareDistinct<T>(base: ReadonlyArray<T> | null | undefined, target: ReadonlyArray<T> | null | undefined): {
    missing: T[];
    extra: T[];
    diff: number;
} | null;
export declare function arrayDistinct<T>(arr: ReadonlyArray<T> | null | undefined): T[];
export declare function normalize(arr: number[]): number[];
export declare function randomArrayItem<T>(arr: ReadonlyArray<T>): T | null;
export declare function arraySwap<T>(arr: T[], i1: number, i2: number): void;
export declare function shuffle<T>(arr: null | undefined, slice: any): T[];
export declare function shuffle<T>(arr: T[], slice: false): T[];
export declare function shuffle<T>(arr: Nullable<ReadonlyArray<T>>): T[];
export declare function shuffle<T>(arr: Nullable<ReadonlyArray<T>>, slice: true): T[];
export declare function groupBy<T, K extends string | number>(arr: ReadonlyArray<T>, grouper: (item: T) => K): Partial<Record<K, T[]>>;
export declare function groupOneBy<T, K extends string | number>(arr: ReadonlyArray<T>, grouper: (item: T) => K): Partial<Record<K, T>>;
export declare function arraySplit<T>(arr: ReadonlyArray<T>, predicate: (t: T) => boolean): [T[], T[]];
export declare function findIndexLeast(num: number, arr: number[], sort?: boolean): number;
export declare function findLastIndex<T>(arr: Nullable<ReadonlyArray<T>>, predicate: Predicate<T>): number;
export declare function findLast<T>(arr: Nullable<ReadonlyArray<T>>, predicate: Predicate<T>): T | null;
type NonFunction<T> = T extends Function ? never : T;
export declare function removeItem<T>(array: T[], item: NonFunction<T> | Predicate<T>): T | null;
export declare function arrayRepeat<T>(factory: Getter<T>, count?: number): T[];
export declare function chunkify<T>(array: T[], size: number): T[][];
export {};