Arabic Count Formatter

A minimal, zero-dependency utility for pluralizing Arabic nouns across singular, dual, and plural forms, including 0 and 11+ counts.

Features

• Provides the correct Arabic noun forms for any numeric count.
• Supports singular, dual, plural, and specific rules for counts of 0, 2, and 11 or more.
• Handles Arabic number formatting and locale settings (ar-SA, en-US).
• Optionally displays the number for counts of 1 and 2.
• Lightweight and requires no dependencies.

Installation

npm i arabic-count-format
# or
yarn add arabic-count-format
# or
pnpm add arabic-count-format
# or
bun add arabic-count-format

Usage

import { formatArabicCount, type ArabicNounForms } from "arabic-count-format";

const carForms: ArabicNounForms = {
  singular: "سيارة",
  dual: "سيارتان",
  plural: "سيارات",
};

formatArabicCount({ count: 0, nounForms: carForms }); // "لا سيارة"
formatArabicCount({ count: 1, nounForms: carForms }); // "سيارة"
formatArabicCount({ count: 2, nounForms: carForms }); // "سيارتان"
formatArabicCount({ count: 7, nounForms: carForms }); // "٧ سيارات"
formatArabicCount({ count: 15, nounForms: carForms }); // "١٥ سيارة"

// With options
formatArabicCount({
  count: 1,
  nounForms: carForms,
  alwaysShowNumber: true,
  locale: "ar-SA",
}); // => "١ سيارة"

API

formatArabicCount(options)

Returns the grammatically correct Arabic phrase for a given count and noun.

Options

Parameter	Type	Description	Default
count	number	The numeric count of items	(required)
nounForms	ArabicNounForms	The various forms of the Arabic noun	(required)
locale	string	Locale for number formatting	"ar-SA"
alwaysShowNumber	boolean	Whether to include the number for counts 1 and 2	false

ArabicNounForms

Property	Type	Description
singular	string	Singular form of the noun (e.g., "سيارة")
dual	string	Dual form of the noun (e.g., "سيارتان")
plural	string	Plural form of the noun for 3-10 (e.g., "سيارات")

Contributing

If you encounter any issues or have suggestions, please submit them via issues or PR.

License

This project is licensed under the MIT License. See the LICENSE file for details.