tk-functional
=============

About
-----

Provides some common helpers for functional-style programming.

Typescript definitions are included.

Issues can be reported on [GitLab](https://gitlab.com/thunderk/tk-serializer/issues).

Functions
---------

**nop** does nothing (useful for some callbacks):

```typescript
new ConstructorWithMandatoryCallback(nop)
```

**identity** returns its argument untouched:

```typescript
a === identity(a)  // => true
```

**partial** applies a partial configuration object as first argument of compatible functions:

```typescript
const sum = (args: {a: number, b: number}) => args.a + args.b
const plus1 = partial({a: 1}, sum);
plus1({b: 8})  // => 9
```

**cmp** simplifies the use of array sorting:

```typescript
[8, 3, 5].sort(cmp())                            // => [3, 5, 8]
[8, 3, 5].sort(cmp({ reverse: true }))             // => [8, 5, 3]
[-2, 8, -7].sort(cmp({ key: Math.abs }))         // => [-2, -7, 8]
```