Getting Started

Documented version

v2.0.0 — npm · Changelog

Installation

Install all helpers at once:

pnpm add @helpers4/all
# or: npm install @helpers4/all

# Pin to a specific version:
# pnpm add @helpers4/all@2.0.0

Or install only the categories you need:

pnpm add @helpers4/array @helpers4/date @helpers4/url

Available packages: @helpers4/array, @helpers4/date, @helpers4/function, @helpers4/math, @helpers4/number, @helpers4/object, @helpers4/observable, @helpers4/promise, @helpers4/string, @helpers4/type, @helpers4/url, @helpers4/version.

Quick Start

import { chunk, unique } from '@helpers4/array';
import { compare } from '@helpers4/date';
import { debounce } from '@helpers4/function';

const chunks = chunk([1, 2, 3, 4, 5], 2);
const uniqueItems = unique([1, 1, 2, 2, 3]);
const diff = compare(new Date('2024-01-01'), new Date('2024-12-31'));
const debouncedFn = debounce(() => console.log('done!'), 300);

All imports are tree-shakable — your bundler will only include the functions you actually use.

CommonJS

const { chunk } = require('@helpers4/array');

Resolving Name Conflicts

Some helpers share the same name across categories (compact, compare, difference, shallowEquals). When you need two of them in the same file, rename at the import site using as — suffix with 4{category}:

import { compact as compact4array } from '@helpers4/array';
import { compact as compact4object } from '@helpers4/object';

import { compare as compare4date } from '@helpers4/date';
import { compare as compare4version } from '@helpers4/version';

See the full list and resolution patterns in Name Conflicts.

Ensure your tsconfig.json targets modern JavaScript:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "lib": ["ES2022"],
    "strict": true,
    "skipLibCheck": true,
    "esModuleInterop": true
  }
}

TypeScript Support

All helpers are fully typed with TypeScript and support strict mode:

import { deepMerge } from '@helpers4/object';

// Full type inference
const result = deepMerge({ a: 1 }, { b: 2 });
// result is { a: number, b: number }

Runtime Compatibility

Runtime	Support	Notes
Browser	ES2022+	Chrome 93+, Firefox 90+, Safari 15+, Edge 93+
Frameworks	✅	React, Vue, Svelte, Angular, and more
Node.js	>=24.0.0
Deno	✅
Bun	✅

Quality Standards

Every helper ships with:

• 100% code coverage (lines, branches, functions, statements)
• Property-based tests (fast-check) — invariants validated against thousands of random inputs
• Contract tests — formal behavioral guarantees
• Boundary tests — edge values and limit conditions covered explicitly
• Security edge case tests — inputs like prototype pollution or injected keys
• Mutation testing (Stryker) — >90% score; view dashboard
• Benchmarks (Vitest Bench) — performance tracked per build
• Dependency security audit — pnpm audit on every PR and release
• OpenSSF Scorecard — view report

Next Steps

• Browse the Categories
• View the GitHub Repository

Contributing

Found a bug? Want to add a helper? Check out the GitHub repository for contribution guidelines.

License

LGPL-3.0 — See LICENSE for details.