@bnidev/js-utils

A collection of modern, typed JavaScript utility functions for working with arrays, DOM elements, objects, and timing.

✨ Features

• ✅ Fully typed with TypeScript
• 📦 Tree-shakable (ESM support)
• 🧩 Modular structure (array, DOM, object, validation, etc.)
• 📚 Auto-generated documentation via TypeDoc
• 🧪 Tested with Vitest

📦 Installation

npm

npm install @bnidev/js-utils
Copy

pnpm

pnpm add @bnidev/js-utils
Copy

yarn

yarn add @bnidev/js-utils
Copy

🛠 Usage

import { debounceFn, flattenArray, deepClone } from "@bnidev/js-utils";

// Debounce any function
const log = (val: string) => console.log(val);
const debouncedLog = debounceFn(log, 300);

// Flatten nested arrays
flattenArray([1, [2, 3], [[4]], 5]); // → [1, 2, 3, 4, 5]

// Deep clone objects
const copy = deepClone({ a: { b: 1 } });
Copy

📚 Documentation

You can find the full documentation for all utility functions, including parameters and return types here:
👉 View full documentation

Generated automatically using TypeDoc.

🧪 Development & Testing

Run lint and formatting checks:

pnpm run check
Copy

Run lint and formatting checks & autofix if possible:

pnpm run check:fix
Copy

Run tests with coverage report:

pnpm run test:coverage
Copy

Build the package:

pnpm run build
Copy

Generate docs:

pnpm run docs:build
Copy