/** * Randomly shuffles an array using the Fisher-Yates algorithm. * * @template T - The type of elements in the array. * @param array - The array to shuffle. * @param inPlace - Whether to shuffle in-place or return a new array (default: false). * @returns A shuffled array. * * @throws {Error} If array is empty. * * @example * // Shuffle and return new array * randomShuffle([1, 2, 3, 4, 5]); // [3, 1, 5, 2, 4] * * @example * // Shuffle in-place * const arr = [1, 2, 3, 4, 5]; * randomShuffle(arr, true); // arr is now shuffled * * @note Uses Fisher-Yates shuffle for uniform distribution. * * @complexity Time: O(n), Space: O(n) for new array or O(1) for in-place */ export declare function randomShuffle(array: T[], inPlace?: boolean): T[]; //# sourceMappingURL=randomShuffle.d.ts.map