import { takeRight as takeRightToolkit } from '../../array/takeRight.ts';
import { toArray } from '../_internal/toArray.ts';
import { isArrayLike } from '../predicate/isArrayLike.ts';
import { toInteger } from '../util/toInteger.ts';

/**
 * Creates a slice of array with n elements taken from the end.
 *
 * @template T
 * @param array - The array to query.
 * @param [n=1] - The number of elements to take.
 * @returns Returns the slice of array.
 *
 * @example
 * takeRight([1, 2, 3]);
 * // => [3]
 *
 * @example
 * takeRight([1, 2, 3], 2);
 * // => [2, 3]
 *
 * @example
 * takeRight([1, 2, 3], 5);
 * // => [1, 2, 3]
 *
 * @example
 * takeRight([1, 2, 3], 0);
 * // => []
 */
export function takeRight<T>(array: ArrayLike<T> | null | undefined, n?: number): T[];

/**
 * Returns a new array containing the last `count` elements from the input array `arr`.
 * If `count` is greater than the length of `arr`, the entire array is returned.
 *
 * @template T - The type of elements in the array.
 * @param arr - The array to take elements from.
 * @param [count=1] - The number of elements to take.
 * @param [guard] - Enables use as an iteratee for methods like `_.map`.
 * @returns A new array containing the last `count` elements from `arr`.
 *
 * @example
 * // Returns [4, 5]
 * takeRight([1, 2, 3, 4, 5], 2);
 *
 * @example
 * // Returns ['b', 'c']
 * takeRight(['a', 'b', 'c'], 2);
 *
 * @example
 * // Returns [1, 2, 3]
 * takeRight([1, 2, 3], 5);
 */
export function takeRight<T>(arr: ArrayLike<T> | null | undefined, count = 1, guard?: unknown): T[] {
  count = guard ? 1 : toInteger(count);
  if (count <= 0 || !isArrayLike(arr)) {
    return [];
  }

  return takeRightToolkit(toArray(arr), count);
}
