Home

Awesome

<p align="center"> <a href="https://github.com/millsp/ts-toolbelt"> <img alt="banner" title="ts-toolbelt" src="https://raw.githubusercontent.com/millsp/ts-toolbelt/master/.github/banner.svg"> </a> <h4 align="center">TypeScript's largest utility library</h4> </p> <p align="center"> <a href="https://www.npmjs.com/package/ts-toolbelt" > <img src="https://img.shields.io/npm/v/ts-toolbelt.svg"> </a> <a href="https://travis-ci.org/millsp/ts-toolbelt" > <img src="https://img.shields.io/travis/millsp/ts-toolbelt.svg"> </a> <a href="#"> <img src="https://img.shields.io/npm/dm/ts-toolbelt.svg"> </a> <a href="https://lgtm.com/projects/g/millsp/ts-toolbelt/context:javascript"> <img alt="Language grade: JavaScript" src="https://img.shields.io/lgtm/grade/javascript/g/millsp/ts-toolbelt.svg?logo=lgtm&logoWidth=-2"/> </a> <a href="#"> <img src="http://isitmaintained.com/badge/resolution/millsp/ts-toolbelt.svg"/> </a> </p> <p align="center"> <a href="https://gitter.im/ts-toolbelt/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link" > <img src="https://img.shields.io/gitter/room/ts-toolbelt/community.svg"> </a> <a href="http://makeapullrequest.com" > <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg"> </a> <a href="https://conventionalcommits.org" > <img src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-green.svg"> </a> <a href="https://github.com/millsp/ts-toolbelt/blob/master/CODE_OF_CONDUCT.md" > <img src="https://img.shields.io/badge/CoC-Contributor%20Covenant-green.svg"> </a> <a href="#"> <img src="https://img.shields.io/npm/l/ts-toolbelt.svg"> </a> </p> <p align="center"> <a href="https://millsp.github.io/ts-toolbelt/">📖 Documentation</a> · <a href="https://github.com/millsp/ts-toolbelt/issues?utf8=✓&q=is%3Aissue+label%3Aannouncement+sort%3Acreated-desc+">📣 Announcements</a> · <a href="https://github.com/millsp/ts-toolbelt/issues/new?template=---bug-report.md" alt="Bug Report">🐞 Report Bug</a> · <a href="https://github.com/millsp/ts-toolbelt/issues/new?template=---feature-request.md" alt="Request Feature">🍩 Request Feature</a> · <a href="https://github.com/millsp/ts-toolbelt/discussions/new" alt="Ask Questions">🤔 Ask Questions</a> </p>

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 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.

<p align="center"> <a href="https://codesandbox.io/s/ts-toolbelt-x4jly?file=/src/index.ts"> <img alt="demo" width="800" title="ts-toolbelt" src="https://raw.githubusercontent.com/millsp/ts-toolbelt/master/.github/demo.svg"> </a> </p>

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!

Getting Started

Prerequisites

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"],
  }
}

Installation

npm install ts-toolbelt --save

Hello World

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.

Documentation ⤢

Imports

The project is organized around TypeScript's main concepts:

AnyBooleanClassFunctionIterationList
NumberObjectObject.PStringUnionTest

TIP How to choose categories? Match your type with them.

There are many ways to import the types into your project:

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.

Utility Index

ANYOBJECTLISTFUNCTIONSTRINGUNIONCLASSBOOLEANNUMBEROBJECT.PITERATION
AwaitAssignAppendAutoPathAtDiffClassAndAbsoluteMergeIteration
AtAtLeastAssignComposeJoinExcludeInstanceNotAddOmitIterationOf
CastCompulsoryAtLeastCurryLengthFilterParametersOrGreaterPickKey
ComputeCompulsoryKeysCompulsoryExactReplaceHasXorGreaterEqReadonlyNext
ContainsDiffCompulsoryKeysFunctionSplitIntersectOfIsNegativeUpdatePos
EqualsEitherConcatLengthLastIsPositiveRecordPrev
ExtendsExcludeDiffNarrowMergeIsZero
KeyExcludeKeysDropNoInferNonNullableLower
KeysFilterEitherParametersNullableLowerEq
KnownKeysFilterKeysExcludePipePopNegate
IsHasExcludeKeysPromisifyReplaceRange
PromiseHasPathExtractReturnSelectSub
TryIncludesFilterUnCurryStrict
TypeIntersectFilterKeysValidPathListOf
xIntersectKeysFlatten
InvertGroup
ListOfHas
MergeHasPath
MergeAllHead
ModifyIncludes
NonNullableIntersect
NonNullableKeysIntersectKeys
NullableKeySet
NullableKeysLast
ObjectLastKey
OmitLength
OptionalList
OptionalKeysLongest
OverwriteMerge
PartialMergeAll
PatchModify
PatchAllNonNullable
PathNonNullableKeys
PathsNullable
PickNullableKeys
ReadonlyObjectOf
ReadonlyKeysOmit
RecordOptional
ReplaceOptionalKeys
RequiredOverwrite
RequiredKeysPartial
SelectPatch
SelectKeysPatchAll
UndefinablePath
UndefinableKeysPaths
UnionizePick
UnionOfPop
UpdatePrepend
WritableReadonly
WritableKeysReadonlyKeys
Remove
Repeat
Replace
Required
RequiredKeys
Reverse
Select
SelectKeys
Shortest
Tail
Take
Undefinable
UndefinableKeys
Unionize
UnionOf
UnNest
Update
Writable
WritableKeys
Zip
ZipObj

Archives ⤢

EXAMPLE https://millsp.github.io/ts-toolbelt/4.2.1/

Good to Know ⤢

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.Add<1, 30>, 31, Test.Pass>(),
    check<Number.Add<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:

Compatibility

The project is maintained to adapt to the constant changes of TypeScript:

ts-toolbelttypescript
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

Related Projects

NameIntro
eledoc🌒 A material dark theme for TypeDoc.
material-candy🍬 A vscode theme to uplift your mood, stay happy and focused.
utility-typesCollection of utility types, complementing TypeScript built-in mapped types and aliases.

License

FOSSA
Status