Fast, modern, and practical utility library for FP in TypeScript.
## Documentation Full documentation can be found [here](https://mobily.github.io/ts-belt/). ## Features - π built with `ReScript`, which generates highly performant JavaScript code (see the benchmark results [here](https://mobily.github.io/ts-belt/benchmarks/introduction)) - π provides more readable code, due to the `data-first` approach - β¨ supports `TypeScript` and `Flow` - π‘ helps you write safer code with `Option` and `Result` types - π― all functions return immutable data (no side-effects) - π² tree-shakeable - π fully documented ## Getting started ### Installation ```shell yarn add @mobily/ts-belt ``` or with `npm` ```shell npm install @mobily/ts-belt --save ``` ### Usage | Module | Namespace | Description | |--|-----------|--| | [Array](https://mobily.github.io/ts-belt/api/array) | A | Utility functions for `Array`. | | [Boolean](https://mobily.github.io/ts-belt/api/boolean) | B | Utility functions for `Boolean`. | | [Number](https://mobily.github.io/ts-belt/api/number) | N | Utility functions for `Number`. | | [Object (Dict)](https://mobily.github.io/ts-belt/api/object) | D | Utility functions for `Object`. | | [String](https://mobily.github.io/ts-belt/api/string) | S | Utility functions for `String`. | | [Guards](https://mobily.github.io/ts-belt/api/guards) | G | Various TypeScript guards. | | [Option](https://mobily.github.io/ts-belt/api/option) | O | Functions for handling the `Option` data type that represents the existence and nonexistence of a value. | | [Result](https://mobily.github.io/ts-belt/api/result) | R | Functions for describing the result of a certain operation without relying on exceptions. | | [Function](https://mobily.github.io/ts-belt/api/function) | F | Other useful functions. | ```typescript import { A, O, N, pipe } from '@mobily/ts-belt' pipe( [1, 2, 3, 4, 5], // β [1, 2, 3, 4, 5] A.dropExactly(2), // β Some([3, 4, 5]) O.flatMap(A.head), // β Some(3) O.map(N.multiply(10)), // β Some(30) O.getWithDefault(0), // β 30 ) // β 30 ``` ## Contributors