Formatting

import { humanize, titleCase, slugify, ordinalize, pluralize } from '@ppabari/strio/str';

🌐

English-locale: titleCase, pluralize, and ordinalize implement English rules only.

humanize

humanize(str: string): string

Convert a machine identifier into a readable sentence.

humanize('first_name'); // → 'First name'
humanize('userID');     // → 'User id'
humanize('created-at'); // → 'Created at'

titleCase

titleCase(str: string): string

Title Case with English conventions — minor words (articles, short prepositions, conjunctions) stay lowercase unless first or last.

titleCase('the lord of the rings'); // → 'The Lord of the Rings'
titleCase('a tale of two cities');  // → 'A Tale of Two Cities'

slugify

slugify(str: string, separator?: string): string

Produce a URL-friendly slug: transliterated to ASCII, lowercased, with runs of non-alphanumerics collapsed to separator (default '-').

slugify('Héllo, World!');  // → 'hello-world'
slugify('Foo   Bar', '_'); // → 'foo_bar'

ordinalize

ordinalize(n: number | string): string

Return the ordinal form of a number.

ordinalize(1);   // → '1st'
ordinalize(2);   // → '2nd'
ordinalize(11);  // → '11th'
ordinalize(103); // → '103rd'

pluralize

pluralize(word: string, count?: number): string

Pluralize an English word. When count is provided, the word is only pluralized if count !== 1. First-letter case is preserved; handles irregulars and uncountables.

pluralize('cat');    // → 'cats'
pluralize('bus');    // → 'buses'
pluralize('city');   // → 'cities'
pluralize('child');  // → 'children'
pluralize('sheep');  // → 'sheep'
pluralize('cat', 1); // → 'cat'
pluralize('cat', 3); // → 'cats'