description: Tree-shakeable, zero-dependency utility library for arrays, async control flow, objects, strings, functions, math, dates, money, random, and typed checks. package: toolkit category: utilities keywords: [utility, array, string, object, math, async, debounce, throttle, functional, helpers] related: [] exports: [chunk, debounce, throttle, group, clamp, isEqual, deepClone, currency, retry, sleep]

@vielzeug/toolkit

Tree-shakeable, zero-dependency utility library for arrays, async control flow, objects, strings, functions, math, dates, money, random, and typed checks.

Package: @vielzeug/toolkit  ·  Category: Utilities

Key exports: chunk, debounce, throttle, group, clamp, isEqual, deepClone, currency, retry, sleep

When to use: Tree-shakeable, zero-dependency utility library for arrays, async control flow, objects, strings, functions, math, dates, money, random, and typed checks.

Related: None

@vielzeug/toolkit is part of Vielzeug and ships as a zero-dependency TypeScript package with ESM+CJS output.

Installation

pnpm add @vielzeug/toolkit
npm install @vielzeug/toolkit
yarn add @vielzeug/toolkit

Quick Start

import {
  chunk,
  pick,
  groupBy,
  queue,
  retry,
  deepMerge,
  partial,
  filterMap,
  currency,
  is,
} from '@vielzeug/toolkit';

const pages = chunk([1, 2, 3, 4, 5], 2);
const byRole = groupBy(users, (u) => u.role);
const safe = pick({ id: 1, name: 'Alice', role: 'admin' }, ['id', 'name']);

const q = queue({ concurrency: 2 });
await q.add(() => fetch('/api/a'));

const data = await retry(() => fetch('/api/health').then((r) => r.json()), {
  times: 3,
  delay: 200,
});

const cfg = deepMerge({ api: { host: 'localhost' } }, { api: { port: 3000 } });

const doubleAll = partial((factor: number, values: number[]) => values.map((n) => n * factor), 2);
const doubled = filterMap(doubleAll([1, 2, 3]), (n) => (n > 2 ? n : undefined));

const price = currency({ amount: 123456n, currency: 'USD' }); // $1,234.56

if (is.string(price)) {
  console.log(price.toUpperCase(), safe);
}

Documentation

• Overview
• Usage Guide
• API Reference
• Examples

License

MIT © Helmuth Saatkamp — part of the Vielzeug monorepo.