@gtcx/i18n

Multi-language support system for GTCX Protocol — country-agnostic internationalization with cultural adaptation.

Features

• 50+ Languages — Primary and local dialect support
• Cultural Context — Language that feels native, not translated
• Offline-First — Full i18n capabilities without connectivity
• AI-Native — Agents auto-detect and adapt to user language
• RTL Support — Right-to-left language handling

Installation

pnpm add @gtcx/i18n

Usage

import { I18nService, CulturalContext } from '@gtcx/i18n';

// Initialize with country context
const i18n = new I18nService({
  country: 'ghana',
  primaryLanguage: 'en',
  localLanguages: ['tw', 'gaa', 'ee'], // Twi, Ga, Ewe
  fallbackLanguage: 'en',
});

// Translate with cultural context
const message = i18n.t('compliance.violation_warning', {
  context: 'formal', // Adapts tone for authority figures
  dialect: 'tw', // Twi dialect
});

// AI agent language detection
const detectedLang = await i18n.detectLanguage(userInput);
const response = i18n.t('welcome', { lang: detectedLang });

Cultural Adaptation

The i18n system goes beyond translation:

// Cultural context affects more than words
const culturalContext = i18n.getCulturalContext('ghana');

culturalContext.communicationStyle; // 'formal', 'community-oriented'
culturalContext.decisionMaking; // 'consensus', 'elder-consultation'
culturalContext.honorifics; // true (use respectful titles)
culturalContext.traditionalKnowledge; // Integration points

Supported Languages by Region

West Africa

• English, Twi, Ga, Ewe, Dagbani (Ghana)
• English, Yoruba, Igbo, Hausa (Nigeria)
• French, Wolof (Senegal)

East Africa

• Swahili, English, Kikuyu, Luo (Kenya)
• Swahili, English, Sukuma (Tanzania)

Latin America

• Spanish, Quechua, Aymara (Peru)
• Spanish, Wayuu, Emberá (Colombia)

Global

• English, French, Spanish, Portuguese, Arabic, Chinese, Hindi

Architecture

packages/i18n/
├── src/
│   ├── index.ts           # Main exports
│   ├── service.ts         # I18nService class
│   ├── cultural-context.ts # Cultural adaptation logic
│   ├── language-detector.ts # AI language detection
│   ├── offline-store.ts   # Offline translation cache
│   └── types.ts           # TypeScript definitions
├── locales/               # Translation files
│   ├── en/
│   ├── sw/                # Swahili
│   ├── es/                # Spanish
│   └── ...
└── cultural/              # Cultural context configs
    ├── ghana.yaml
    ├── kenya.yaml
    └── ...

Related Packages

• @gtcx/accessibility — Tech literacy and WCAG compliance
• @gtcx/offline-sync — Offline-first data synchronization