i18n

@motioneffector/i18n

A lightweight, type-safe internationalization library with zero dependencies for modern web applications.

Features

Simple Translation API - Clean t() function with dot notation
Pluralization Support - Intl-based plural rules for all languages
Nested Namespaces - Organize translations hierarchically with dot notation
Dynamic Loading - Lazy-load translations on demand with async support
Interpolation - Template placeholders for dynamic values
Fallback Handling - Graceful fallback to default locale when missing
Format Utilities - Built-in number, date, and relative time formatting
Change Callbacks - React to locale changes and missing translations

Quick Start

import { createI18n } from '@motioneffector/i18n'

// Create i18n instance with translations
const i18n = createI18n({
  defaultLocale: 'en',
  translations: {
    en: {
      greeting: 'Hello, !',
      items: {
        one: '8 item',
        other: '8 items'
      }
    }
  }
})

// Interpolation
i18n.t('greeting', { name: 'World' })  // "Hello, World!"

// Pluralization
i18n.t('items', { count: 1 })  // "1 item"
i18n.t('items', { count: 5 })  // "5 items"

Testing & Validation

Comprehensive test suite - 200 unit tests covering core functionality
Fuzz tested - Randomized input testing to catch edge cases
Strict TypeScript - Full type coverage with no any types
Zero dependencies - No supply chain risk

License

This site is open source. Improve this page.