thi-ng/umbrella

import type { Comparator, Maybe } from "@thi.ng/api";
import { compare } from "@thi.ng/compare/compare";
import type { Reducer } from "./api.js";

/**
 * Similar to {@link push}, but sorts result array upon completion using
 * optionally given comparator (default
 * [`compare()`](https://docs.thi.ng/umbrella/compare/functions/compare.html)).
 *
 * @param cmp -
 */
export function pushSort<T>(cmp?: Comparator<T>): Reducer<T, T[]>;
export function pushSort<T>(cmp: Maybe<Comparator<T>>, src: Iterable<T>): T[];
export function pushSort<T>(
    cmp: Comparator<T> = compare,
    src?: Iterable<T>
): any {
    return src
        ? [...src].sort(cmp)
        : <Reducer<T, T[]>>[
                () => [],
                (acc) => acc.sort(cmp),
                (acc, x) => (acc.push(x), acc),
          ];
}