Brojevi u tekst

A lightweight, zero-dependency TypeScript library for converting numbers to Serbian words.

Handles Serbian grammatical cases, gender agreement, and plural forms correctly.

Installation

npm install brojevi-u-tekst

Usage

import brojeviUTekst from 'brojevi-u-tekst';

brojeviUTekst(12345);
// "dvanaest hiljada trista četrdeset pet"

brojeviUTekst(21000);
// "dvadeset jedna hiljada"

brojeviUTekst(-99);
// "minus devedeset devet"

Examples

Input	Output
0	nula
19	devetnaest
-42	minus četrdeset dva
100	sto
400	četiristo
1000	hiljadu
2000	dve hiljade
5000	pet hiljada
21000	dvadeset jedna hiljada
123456	sto dvadeset tri hiljade četiristo pedeset šest
1000000	jedan milion
2000000	dva miliona
11000000	jedanaest miliona
1000000000	jedna milijarda
2000000000	dve milijarde
1000000000000	jedan bilion
1234567890	jedna milijarda dvesta trideset četiri miliona petsto šezdeset sedam hiljada osamsto devedeset
Infinity	Neispravan unos
NaN	Neispravan unos
> MAX_SAFE	Broj je prevelik za preciznu konverziju.

API

brojeviUTekst(num: number): string

Converts a number to its Serbian word representation.

Parameters:

• num (number) - The number to convert. Supports positive and negative integers up to Number.MAX_SAFE_INTEGER (9,007,199,254,740,991). null and undefined are treated as 0.

Returns:

• (string) - The Serbian word representation
  • Returns "nula" for 0, null, or undefined
  • Returns "Neispravan unos" for non-finite numbers (Infinity, NaN) or invalid types
  • Returns "Broj je prevelik za preciznu konverziju." for numbers exceeding MAX_SAFE_INTEGER

Features

• ✅ Correct Serbian grammar for all denominations:
  • hiljadu/hiljade/hiljada (thousands)
  • milion/miliona (millions)
  • milijarda/milijarde/milijardi (billions)
  • bilion/biliona (trillions)
• ✅ Gender agreement for feminine nouns (jedan→jedna, dva→dve for thousands and billions)
• ✅ Support for numbers up to Number.MAX_SAFE_INTEGER (~9 quadrillion)
• ✅ Negative number support (prepends "minus")
• ✅ Proper handling of edge cases (zero chunks, teens, invalid inputs)
• ✅ Zero dependencies
• ✅ Fully typed (TypeScript)

License

MIT