TypeScript's largest utility library
*
📖 Documentation
·
📣 Announcements
·
🐞 Report Bug
·
🍩 Request Feature
·
🤔 Ask Questions
About
ts-toolbelt is the largest, and most tested type library available right
now, featuring +200 utilities. Our type collection packages some of the most
advanced generic mapped types, conditional types, and recursive types on the
market.
Spend less time, build stronger. Benefit from a wide range of generic type
functions to achieve better type safety - easily.
We are just like lodash, or ramda, but applied to the type system. Our mission
is to provide you with simple ways to generate, transform, and create types. We
abstract all those complex type checks away for you. We provide a standard,
reusable, and simple API to achieve greater things with TypeScript.
ts-toolbelt is a well organized package that can help you perform advanced
operations on union types, object types, function types, and literal types. It
is coherently designed for building robust, flexible, and type safe software.
We answer the question to "How can I do this in TypeScript?". We are a community. Everyone
is welcome to come ask questions about types. We welcome beginners and advanced
developers to come take part. Welcome!
Getting Started
Prerequisites
npm install typescript@^4.1.0 --save-dev
For best results, add this to your tsconfig.json
{
"compilerOptions": {
"strictNullChecks": true,
"strict": true,
"lib": ["es2015"],
}
}
Installation
npm install ts-toolbelt --save
Hello World
import {Object} from "ts-toolbelt"
type merge = Object.Merge<{name: string}, {age?: number}>
type optional = Object.Optional<{id: number, name: string}, "name"}>
You can level-up, and re-code this library from
scratch.
Imports
The project is organized around TypeScript's main concepts:
Any | Boolean | Class | Function | Iteration | List |
---|
Number | Object | Object.P | String | Union | Test |
TIP
How to choose categories? Match your type with them.
There are many ways to import the types into your project:
-
Explicit
import {Any, Boolean, Class, Function, Iteration, List, Number, Object, String, Union} from "ts-toolbelt"
-
Compact
import {A, B, C, F, I, L, N, O, S, U} from "ts-toolbelt"
-
Portable
import tb from "ts-toolbelt"
You can also import our non-official API from the community:
import {Community} from "ts-toolbelt"
TIP
The community API is for our community to publish useful types that
don't see fit in the standard API.
EXAMPLE
https://millsp.github.io/ts-toolbelt/4.2.1/
In this wiki, you will find some extra resources for your learning, and
understanding.
Are you missing something? Participate to the open-wiki by posting your
questions.
Running tests
For this project
To run the lint
& type
tests, simply run:
npm test
For your project
Want to test your own types? Let's get started:
import {Number, Test} from "ts-toolbelt"
const {checks, check} = Test
checks([
check<Number.Plus<"1", "30">, "31", Test.Pass>(),
check<Number.Plus<"5", "-3">, "2", Test.Pass>(),
])
TIP
Place it in a file that won't be executed, it's just for TypeScript
to test types.
Continuous Integration
The releases are done with Travis CI in stages & whenever a branch or PR is
pushed:
- Tests are run with
npm test
- Tests against
DefinitelyTyped
- Releases to npm@[branch-name]
Compatibility
The project is maintained to adapt to the constant changes of
TypeScript:
ts-toolbelt | typescript |
---|
9.x.x | ^4.1.x |
Major version numbers will upgrade whenever TypeScript had breaking changes.
Otherwise, the release versions will naturally follow the semantic versioning.
What's next
-
Automated performance tests
npx tsc --noEmit --extendedDiagnostics
-
Need to write more examples
Related Projects
Name | Intro |
---|
eledoc | 🌒 A material dark theme for TypeDoc |
utility-types | Collection of utility types, complementing TypeScript built-in mapped types and aliases |
License