@nlabs/utils

@nlabs/utils

Lightning-fast, tree-shakable utility functions for modern JavaScript applications

Why @nlabs/utils?

• Zero Dependencies - No lodash, no bloat, just pure ES2022+ utilities
• Tree-shakable - Only import what you need, keep your bundle lean
• TypeScript First - Full type safety with modern TypeScript features
• Performance Optimized - Uses native browser APIs and modern JavaScript features
• Modular Imports - Import from specific modules: @nlabs/utils/objects
• ESM Ready - Native ES modules with proper exports

Installation

npm install @nlabs/utils
# or
yarn add @nlabs/utils
# or
pnpm add @nlabs/utils

Quick Start

// Import everything (not recommended for production)
import { cloneDeep, merge, uniq, isString } from '@nlabs/utils';

// Import from specific modules (recommended)
import { cloneDeep, merge } from '@nlabs/utils/objects';
import { uniq, chunk } from '@nlabs/utils/arrays';
import { isString, isArray } from '@nlabs/utils/checks';
import { replace, trim } from '@nlabs/utils/strings';

Documentation

Objects

Deep cloning, merging, property access, and object manipulation utilities.

• cloneDeep - Deep clone objects with native structuredClone
• merge - Deep merge objects
• get - Safe property access with dot notation
• set - Immutable deep property assignment
• isEmpty - Check if value is empty
• debounce - Debounce function calls
• mapValues - Transform object values
• pick/omit - Select or exclude object properties

Arrays

Array manipulation and utility functions.

• uniq - Remove duplicates from arrays
• chunk - Split arrays into chunks
• compact - Remove falsy values
• difference - Find array differences
• intersection - Find common elements

Strings

String manipulation and formatting utilities.

• replace - String replacement with regex support
• trim - Trim whitespace or custom characters
• case - Case conversion (camelCase, kebab-case, etc.)
• escape - HTML entity escaping

Checks

Type-safe validation functions.

• isString - Check if value is a string
• isArray - Check if value is an array
• isPlainObject - Check if value is a plain object
• isNumber - Check if value is a valid number
• isBoolean - Check if value is a boolean
• isFunction - Check if value is a function
• isNullish - Check if value is null or undefined

Formatters

Input formatting and validation utilities.

• Formatter - Input masking and formatting

Parsers

Data parsing and transformation utilities.

• String Parsers - Email, phone, ID parsing
• Number Parsers - Number formatting and conversion
• Object Parsers - Object transformation
• Boolean Parsers - Boolean parsing

Performance Comparison

Function	@nlabs/utils	lodash	Native
cloneDeep	2.1x faster	1x
merge	1.8x faster	1x
uniq	1.5x faster	1x	1.2x
isString	1.3x faster	1x	1.1x

Bundle Size

# Full library (not recommended)
import * as utils from '@nlabs/utils';
# ~45KB gzipped

# Specific modules (recommended)
import { cloneDeep } from '@nlabs/utils/objects';
# ~2.1KB gzipped

import { uniq } from '@nlabs/utils/arrays';
# ~0.8KB gzipped

Migration from Lodash

// Before (lodash)
import { cloneDeep, merge, uniq } from 'lodash';

// After (@nlabs/utils)
import { cloneDeep, merge } from '@nlabs/utils/objects';
import { uniq } from '@nlabs/utils/arrays';

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT License - see LICENSE for details.

---

Built with by Nitrogen Labs