/**
 * @description
 * Retrieve the item at index zero of the given array-like or `Set` object.
 * For `Set`s this is based on insertion order, i.e. the first inserted object.
 *
 * @parameters
 * | name | type | description |
 * | :--: | :--: | ----------- |
 * | arrayLike | `array` | Array-like value to access |
 *
 * @returns `any` – first value of the given collection, i.e. `array[0]`
 *
 * @example
 * first([1, 2, 3, 4])
 * // -> 1
 *
 * first(new Set([1, 2, 3, 4]))
 * // -> 1
 *
 * first((function () { return arguments }(1, 2, 3, 4)))
 * // -> 1
 *
 * @see last
 * @since v1.0.0
 * @tag collections
 */
interface First {
  <T> (collection: ArrayLike<T> | Set<T>): T | undefined
}

declare const first: First
export default first