@koalarx/utils/KlArray.d.ts

Biblioteca com validadores, conversores e abstrações de algumas problemáticas

export declare class KlArray<T = any> extends Array<T> {
    constructor(initialValue?: T[]);
    /**
     * Remove valores "falsy" (como `null`, `undefined`, `false`, `0`, `NaN` e strings vazias) do array.
     * @returns Um novo `KlArray` contendo apenas os valores "truthy".
     */
    clearEmptyValues(): KlArray<NonNullable<T>>;
    /**
     * Divide o array em subarrays com um número máximo de elementos especificado.
     * @param maxRowsSplit Número máximo de elementos em cada subarray.
     * @returns Um novo KlArray contendo subarrays do tipo KlArray.
     */
    split(maxRowsSplit: number): KlArray<KlArray<T>>;
    /**
     * Ordena os elementos do array com base em uma propriedade específica e na direção desejada.
     * @param by Nome da propriedade usada para ordenar os elementos.
     * @param direction Direção da ordenação: 'asc' para ascendente (padrão) ou 'desc' para descendente.
     * @returns Um novo KlArray com os elementos ordenados.
     */
    orderBy(by: string, direction?: 'asc' | 'desc'): this;
    /**
     * Embaralha os elementos do array de forma aleatória, garantindo que o resultado seja diferente do original.
     * @returns O próprio KlArray com os elementos embaralhados.
     */
    shuffle(): this;
}