tallya

Turn raw counts into concise, UX‑friendly bucketed labels like 300+, 7K+ or 12M+.

Install

npm install tallya
# or
yarn add tallya

Quick Start

import { getLabel } from "tallya";

// default suffix '+'
getLabel(317); // → '300+'
getLabel(7321); // → '7K+'
getLabel(12_345_678); // → '12M+'
getLabel(0); // → '0+'

// custom suffix
getLabel(317, { suffix: " sold" }); // → '300 sold'
getLabel(0, { suffix: "" }); // → '0'

API

getLabel(count, options?) → string

| Argument | Type | Default | Description | | --------- | --------------------- | ------- | ------------------------------------------------------------- | | count | number | — | Any finite number you want to label (throws on NaN or ∞). | | options | { suffix?: string } | {} | Configuration object (only suffix is supported in v1.0). |

• Suffix: Text appended to every label. Defaults to +.

getLabel(100); // '100+'
getLabel(100, { suffix: "" }); // '100'

How It Works

1. Zero check: Throws if count is not finite.
2. Zero bucket: 0 → '0+' (or '0' with empty suffix).
3. Magnitude buckets: Groups by thousands: K, M, B, T.
4. Floor and suffix: Floors count to bucket value, then appends suffix.

Under the hood it uses Math.log10 and a tiny lookup array (['', 'K', 'M', 'B', 'T']) for an O(1) label computation.