This is a fork of the original pluralize project, providing full TypeScript support and Deno compatibility.

This module employs a pre-defined list of rules, applied in order, to singularize or pluralize given words. It's particularly useful for:

• Automating processes based on user input
• Handling dynamic content where word forms may vary

For applications where words are known ahead of time, a simple ternary operation or custom function would be a lighter alternative.

Pluralize is available on jsr. You can install it using the following command:

deno add jsr:@wei/pluralize
npx jsr add @wei/pluralize

import pluralize from "pluralize";

Convert a word to its plural form:

console.log(pluralize("test")); //=> "tests"

Specify a count to get the correct form:

console.log(pluralize("test", 0)); //=> "tests"
console.log(pluralize("test", 1)); //=> "test"
console.log(pluralize("test", 5)); //=> "tests"

Include the count in the output:

console.log(pluralize("test", 1, true)); //=> "1 test"
console.log(pluralize("test", 5, true)); //=> "5 tests"

The module also supports non-English words:

console.log(pluralize("蘋果", 2, true)); //=> "2 蘋果"

pluralize.addPluralRule(/gex$/i, "gexii");
console.log(pluralize.plural("regex")); //=> "regexii"

pluralize.addSingularRule(/singles$/i, "singular");
console.log(pluralize.singular("singles")); //=> "singular"

Define irregular pluralization rules:

pluralize.addIrregularRule("irregular", "regular");
console.log(pluralize.plural("irregular")); //=> "regular"

Specify words that do not have a plural form:

pluralize.addUncountableRule("paper");
console.log(pluralize.plural("paper")); //=> "paper"

Determine if a word is singular or plural:

console.log(pluralize.isPlural("test")); //=> false
console.log(pluralize.isSingular("test")); //=> true

The pluralize module provides the following functions:

• Converts a word to its plural form based on the count.
• If inclusive is true, it includes the count in the output.

• Adds a custom pluralization rule.

• Adds a custom singularization rule.

• Defines an irregular pluralization rule.

• Specifies a word that does not have a plural form.

• Checks if the given word is plural.

• Checks if the given word is singular.

MIT