Ultra-lightweight chunker for everything — arrays, strings, sets, maps, async iterables and more.

📦 Installation

1npm install chonkify

✨ Features

• Works with everything: Array, String, Buffer, Set, Map, Array-like, TypedArray
• Supports AsyncIterable (for await)
• UTF-16 code points and Unicode graphemes support 👨‍👩‍👧‍👦🏳️‍🌈
• Minimal size: core just 1103 bytes, entire package ~7 kB
• Zero dependencies
• ESM-first, TypeScript-ready

🧪 Usage

1import { chonk, chonkAsync, chonkGraphemes } from 'chonkify';
2
3// Basic examples
4chonk([1, 2, 3, 4], 2); // [[1, 2], [3, 4]]
5chonk('abcdef', 2);     // ['ab', 'cd', 'ef']
6
7// Standard chonk uses UTF-16 code points (like standard JS)
8chonk('👍👌✌️😀', 2);  // May split emojis incorrectly
9
10// Use chonkGraphemes for proper emoji support
11chonkGraphemes('👍👌✌️😀', 2);  // ['👍👌', '✌️😀']
12chonkGraphemes('👨‍👩‍👧‍👦🏳️‍🌈', 1); // ['👨‍👩‍👧‍👦', '🏳️‍🌈']
13
14// Async usage:
15for await (const group of chonkAsync(fetchLines(), 100)) {
16  console.log(group);
17}

🔍 API

chonk(iterable, size)

Splits an iterable into groups of the specified size. For strings, splits by UTF-16 code points (standard JavaScript behavior).

1chonk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]

chonkGraphemes(iterable, size)

Same as chonk() but for strings, splits by Unicode grapheme clusters instead of code points. This correctly handles emoji and complex symbols like family emojis and flags.

1// Standard chonk may split complex emojis incorrectly
2chonk('👨‍👩‍👧‍👦', 1); // May return multiple chunks
3
4// chonkGraphemes correctly handles complex emoji
5chonkGraphemes('👨‍👩‍👧‍👦', 1); // ['👨‍👩‍👧‍👦']

chonkAsync(asyncIterable, size)

Asynchronously splits an iterable into groups of the specified size.

1// Process large datasets in batches
2for await (const batch of chonkAsync(dataStream, 100)) {
3  await processBatch(batch);
4}

🤔 FAQ

Can I use chonkify with Node.js?

Yes, chonkify works both in browsers and Node.js environments.

Does it support nested data structures?

Yes, chonkify can handle nested data structures as it groups elements without transforming them.

📄 License

MIT