just-types

Just types

A collection of handy Typescript types.

Contents

• Installation

• List of Types

  • Decrement
  • FieldPath
  • Filter
  • Flatten
  • GetField
  • Increment
  • InsertAt
  • Join
  • MutableTuple
  • Permutation
  • Range
  • Split
  • SubArray
  • Tail

• Contributing

• Changelog

Installation

Install using npm

npm install -D just-types

Or using yarn

yarn add --dev just-types

List of Types

Decrement

Decrement<0> //=> -1
Decrement<1> //=> 0
Decrement<100> //=> 99
Decrement<101> //=> number
Decrement<-10> //=> number

Note: Only handles possitive integers between 0 and 100. Returns number for other integers.

FieldPath

FieldPath<{}> //=> ''
FieldPath<{a: number; b: null}> //=> 'a' | 'b'
FieldPath<{a: number; b: {c: 1; d: 2}; e: {f: {g: {}}}}
//=> 'a' | 'b' | 'b.c' | 'b.d' | 'e' | 'e.f' | 'e.f.g'

Filter

Filter<[1, 2, true, 3, 'foo'], number> //=> [1, 2, 3]
Filter<[1, 2, true, 3, 'foo'], string> //=> ['foo']
Filter<[1, 2, true, 3, 'foo'], boolean | string> //=> [true, 'foo']
Filter<
  [{active: true; data: 1}, {active: false; data: 2}, {active: true; data: 3}, {active: false; data: 4}],
  {active: true}
> //=> [{active: true; data: 1}, {active: true; data: 3}]

Flatten

Flatten<[]> // => []
Flatten<[[1]]> // => [1]
Flatten<[[1], [2]]> // => [1, 2]
Flatten<[[1], [[2, 3]], [[4]]]> // => [1, [2, 3], [4]]
Flatten<[[1], [[2, 3]], [[4]]], 2> // => [1, 2, 3, 4]

GetField

GetField<{a: number; b: null}, 'a'> //=> number
GetField<{a: number; b: null}, 'b'> //=> null
GetField<{a: number; b: {c: 1; d: 2}; e: {f: {g: number}}}, 'e.f.g'> //=> number
GetField<{a: number; b: {c: 1; d: 2}; e: {f: {g: number}}}, 'b'> //=> {c: 1; d: 2}
GetField<{a: number; b: {c: 1; d: 2}; e: {f: {g: number}}}, 'e.f'> //=> {g: number}

Increment

Increment<0> //=> 1
Increment<1> //=> 2
Increment<100> //=> 101
Increment<101> //=> number
Increment<-1> //=> number

Note: Only handles possitive integers between 0 and 100. Returns number for other integers.

InsertAt

InsertAt<'x', 0, ['a', 'b']> // => ['x', 'a', 'b']
InsertAt<'x', 1, ['a', 'b']> // => ['a', 'x', 'b']
InsertAt<'x', 2, ['a', 'b']> // => ['a', 'b', 'x']
InsertAt<'x', 5, ['a', 'b']> // => ['a', 'b', 'x']

Join

Join<[], '-'> // => ''
Join<['a'], '-'> // => 'a'
Join<['a', 'b'], '-'> // => 'a-b'

MutableTuple

MutableTuple<readonly []> // => []
MutableTuple<readonly ['a']> // => ['a']
MutableTuple<readonly ['a', 'b']> // => ['a', 'b']

Permutation

Permutation<[]> // => []
Permutation<['a']> // => ['a']
Permutation<['a', 'b']> // => ['a', 'b'] | ['b', 'a']
Permutation<['a', 'b', 'c']> // => ['a', 'b', 'c'] | ['a', 'c', 'b'] | ['b', 'a', 'c'] | ['b', 'c', 'a'] | ['c', 'a', 'b'] | ['c', 'b', 'a']

Range

Range<3, 3> // => 3
Range<4, 7> // => 4 | 5 | 6 | 7
Range<0, 5> // => 0 | 1 | 2 | 3 | 4 | 5

Split

Split<'foo', '-'> // => ['foo']
Split<'foo-bar-baz', '-'> // => ['foo', 'bar', 'baz']
Split<'foo--', '-'> // => ['foo', '', '']

SubArray

SubArray<['a']> // => ['a']
SubArray<['a', 'b']> // => ['a'] | ['b'] | ['a', 'b']
SubArray<['a', 'b', 'c']> // => ['a'] | ['b'] | ['c'] | ['a', 'b'] | ['a', 'c'] | ['b', 'c'] | ['a', 'b', 'c']

Tail

Tail<[]> //=> []
Tail<['a']> //=> []
Tail<['a', 'b']> //=> ['b']
Tail<['a', 'b', 'c', 'd']> //=> ['b', 'c', 'd']

Contributing

You can contribute to this library in many ways, including:

• Reporting bugs: Simply open an issue and describe the bug. Please include a code snippet to reproduce the bug, it really helps to solve the problem quickly.

• Suggesting new types: If you have a common use case that you think worth having its own custom type, open an issue and we will discuss it. Do you already have an implementation for it? great, make a pull request and I will review it. Please make sure your code is consistent with the rest of the codebase and use Prettier and EditorConfig to format your files.

Those are just examples, any issue or pull request is welcome :)

Changelog

1.4.2 (March 21th 2022)

• Add repository and homepage to package.json (forgot to add them on 1.4.1 :P).

1.4.1 (March 21th 2022)

• Fix issue Tail type gives wrong results in specific recursive scenarios

1.4.0 (January 29th 2022)

• Add Split

1.3.1 (January 9th 2022)

• Export missing types

1.3.0 (January 9th 2022)

• Add Filter
• Add FiledPath
• Add GetField

1.2.0 (January 2nd 2022)

• Add Increment
• Add Decrement
• Add depth parameter to Flatten

1.1.0 (December 01, 2021)

• Add MutableTuple

1.0.0 (November 22, 2021)

The first release containing the 7 types:

• Flatten
• InsertAt
• Join
• Permutation
• Range
• SubArray
• Tail