feat(rest): add rest helper which is the opposite of first

Author: tdreyno

docs/functions.md

@@ -312,6 +312,28 @@ type last = <T>(items: T[]) => T | undefined
 {% endtab %}
 {% endtabs %}
 
+## rest
+
+Given an array, return every item except the first.
+
+{% tabs %}
+{% tab title="Usage" %}
+
+```typescript
+rest([1, 2, 3]) // [2, 3]
+```
+
+{% endtab %}
+
+{% tab title="Type Definition" %}
+
+```typescript
+type rest = <T>(items: T[]) => T[]
+```
+
+{% endtab %}
+{% endtabs %}
+
 ## greaterThan
 
 Create a predicate which checks whether a value is greater than a number.

src/__tests__/rest.spec.ts

@@ -0,0 +1,7 @@
+import { rest } from "../index"
+
+describe("rest", () => {
+  test("gets the rest item in an array", () => {
+    expect(rest([0, 1, 2, 3])).toEqual([1, 2, 3])
+  })
+})

src/index.ts

@@ -7,6 +7,8 @@ export const first = index(0)
 
 export const last = <T>(items: T[]): T => items[items.length - 1]
 
+export const rest = <T>([, ...remaining]: T[]) => remaining
+
 export const constant = <T>(value: T) => () => value
 
 export const identity = <T>(value: T) => value