📖 Documentation · 📣 Announcements · 🐞 Report Bug · 🍩 Request Feature · 🤔 Ask Questions
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 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.
We work just like lodash, or ramda, but applied to the type system. Our mission is to provide you with simple ways to compute, change, and create types. We abstract all those complex type checks away for you. We provide a simple, reusable, and standard API to help you get more done with TypeScript.
ts-toolbelt is a well organized package that can help you perform advanced operations on object types, union types, as well as function, and literal types. It is carefully and coherently designed for building robust, flexible, and type-safe software.
We are a community and a knowledge base. Everyone is welcome to ask questions about types. If you are stuck or you misunderstand something, you came to the right place!. We welcome beginners and advanced developers to come take part. Welcome!
npm install typescript@^4.1.0 --save-dev
For best results, add this to your tsconfig.json
{
"compilerOptions": {
// highly recommended (required by few utilities)
"strictNullChecks": true,
// this is optional, but enable whenever possible
"strict": true,
// this is the lowest supported standard library
"lib": ["es2015"],
}
}
npm install ts-toolbelt --save
import {Object} from "ts-toolbelt"
// Check the docs below for more
// Merge two `object` together
type merge = Object.Merge<{name: string}, {age?: number}>
// {name: string, age?: number}
// Make a field of an `object` optional
type optional = Object.Optional<{id: number, name: string}, "name">
// {id: number, name?: string}
You can level-up, and re-code this library from scratch.
The project is organized around TypeScript's main concepts:
| Any | Boolean | Class | Function | Iteration | List |
|---|---|---|---|---|---|
| Number | Object | Object.P | String | Union | Test |
TIPHow to choose categories? Match your type with them.
There are many ways to import the types into your project:
Explicit
ts
import {Any, Boolean, Class, Function, Iteration, List, Number, Object, String, Union} from "ts-toolbelt"
Compact
ts
import {A, B, C, F, I, L, N, O, S, U} from "ts-toolbelt"
Portable
ts
import tb from "ts-toolbelt"
You can also import our non-official API from the community:
ts
import {Community} from "ts-toolbelt"
TIPThe community API is for our community to publish useful types that don't see fit in the standard API.
| ANY | OBJECT | LIST | FUNCTION | STRING | UNION | CLASS | BOOLEAN | NUMBER | OBJECT.P | ITERATION |
|---|---|---|---|---|---|---|---|---|---|---|
| Await | Assign | Append | AutoPath | At | Diff | Class | And | Absolute | Merge | Iteration |
| At | AtLeast | Assign | Compose | Join | Exclude | Instance | Not | Add | Omit | IterationOf |
| Cast | Compulsory | AtLeast | Curry | Length | Filter | Parameters | Or | Greater | Pick | Key |
| Compute | CompulsoryKeys | Compulsory | Exact | Replace | Has | Xor | GreaterEq | Readonly | Next | |
| Contains | Diff | CompulsoryKeys | Function | Split | IntersectOf | IsNegative | Update | Pos | ||
| Equals | Either | Concat | Length | Last | IsPositive | Record | Prev | |||
| Extends | Exclude | Diff | Narrow | Merge | IsZero | |||||
| Key | ExcludeKeys | Drop | NoInfer | NonNullable | Lower | |||||
| Keys | Filter | Either | Parameters | Nullable | LowerEq | |||||
| KnownKeys | FilterKeys | Exclude | Pipe | Pop | Negate | |||||
| Is | Has | ExcludeKeys | Promisify | Replace | Range | |||||
| Promise | HasPath | Extract | Return | Select | Sub | |||||
| Try | Includes | Filter | UnCurry | Strict | ||||||
| Type | Intersect | FilterKeys | ValidPath | ListOf | ||||||
| x | [IntersectKeys](https://millsp.github.io/ts-toolbelt/modules/object |
$ claude mcp add ts-toolbelt \
-- python -m otcore.mcp_server <graph>