# toolbox-ts

> my toolbox

Latest version **0.5.2** (published 2026-11-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install toolbox-ts
pnpm add toolbox-ts
yarn add toolbox-ts
bun add toolbox-ts
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.5.2 |
| Published | 2026-11-12 |
| First published | 2022-02-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 38.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Lambig |
| Maintainers | lambig |

## Links

- npm: https://www.npmjs.com/package/toolbox-ts
- Repository: https://github.com/lambig/toolbox-ts
- Homepage: https://github.com/lambig/toolbox-ts#readme
- Issues: https://github.com/lambig/toolbox-ts/issues
- npm.io page: https://npm.io/package/toolbox-ts

## Recent versions

- 0.5.2 (latest) — 2026-11-12
- 0.5.1 — 2022-09-13
- 0.5.0 — 2022-06-30
- 0.4.2 — 2022-06-28
- 0.4.1 — 2022-06-28
- 0.4.0 — 2022-06-28
- 0.3.0 — 2022-06-17
- 0.2.0 — 2022-02-01

## README

[![Node CI](https://github.com/lambig/toolbox-ts/actions/workflows/node-ci.yml/badge.svg?branch=main)](https://github.com/lambig/toolbox-ts/actions/workflows/node-ci.yml)
# toolbox-ts

## Package entry points

In Node.js, both `require('toolbox-ts')` and a bare package import use
the CommonJS `main` entry. For an ES module consumer, use the default import:

```javascript
import toolbox from 'toolbox-ts';
const { notNull } = toolbox;
```

The `module` field describes the separate ESM build for bundlers that honor
that field. Node does not use it when resolving the package name. Package tests
check Node's bare import through CommonJS and separately import the ESM file
to verify that artifact; they do not certify a particular bundler integration.
Existing subpath imports and `package.json` access remain available without an
`exports` map.

See [Node package entry points](https://nodejs.org/api/packages.html#package-entry-points).
## all / any / none / notAll

Very simple functions to express logical evaluations.  
Evaluates boolean or function that returns boolean.

### usage
```
all(
    true,
    any(
        () => false,
        notAll(true, () => false)
    ),
    none(
        false,
        () => false
    )
)) // true
```
Not only variable arguments but also arrays can be evaluated.
```
all([
    true,
    any([
        () => false,
        notAll(true, () => false)
    ]),
    none(
        false,
        () => true
    )]
) // false
```
Short-circuit evaluation is used.
```
notAll(
    true,
    false,
    () => { throw new Error("unexpected evaluation"); }
)) // true
```

## Patterns

Makes conditions/values easy to be expressed in patterns.  
(NOTE: This is probably the next best thing, as a proper separation of concern should make implementation more concise. )

### Condition
- boolean
- function returns boolean (Proposition)
- function evaluates argument (Predicate)

### Value
- value
- function returns value (Supplier)

### usage

You can get value of the first pattern which satisfied by given value (or an undefined).
```
Patterns
    .of(
        [false, "some phrase"],
        [() => false, "another phrase"],
        [(target: string) => target.length > 5, returnOf(() => "yet another phrase")])
    .firstSatisfiedBy("abcdef")); // "yet another phrase"
```

You can define default value or its Supplier.
```
patterns(
    [false, "word"],
    [() => false, "some phrase"],
    [() => false, "another phrase"],
    [(target: string) => target.length < 5, returnOf(() => "yet another phrase")],
    orElse("default phrase"))
    .firstSatisfiedBy("abcdef")); // "default phrase"
```

Also, you can collect all values of the patterns which satisfied by given value as an array.
```
patterns(
    [false, "word"],
    [() => true, "some phrase"],
    [() => false, "another phrase"],
    [(target: string) => target.length > 5, returnOf(() => "yet another phrase")])
    .allSatisfiedBy("abcdef")) // ["some phrase", "yet another phrase"]
```

## toApplicationTo
```
[
    (a: number): string => `${a + 1}`,
    (a: number): string => `${a + 2}`,
    (a: number): string => `${a + 3}`,
    (a: number): string => `${a + 4}`,
    (a: number): string => `${a + 5}`
]
    .map(toApplicationTo(1)) // ["2", "3", "4", "5", "6"]
```

---
_Source: https://npm.io/package/toolbox-ts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
