@comity/i18n
v0.9.0
Published
Internationalization module providing localization and translation services for Comity
Readme
@comity/i18n
Internationalization module for Comity.
Purpose
Defines locale, translation, and loader contracts for Comity-based applications. Exposes a facade for consuming translations and includes setup types for module wiring.
Scope
This package:
- ✅ defines locale and translator contracts
- ✅ provides an I18n facade for application consumption
- ✅ exposes the
errorandsetupsubpaths - ✅ offers module-level hooks for configuring translations
This package does NOT:
- ❌ implement translation data storage
- ❌ provide typed translation bridges
- ❌ own application-specific localization policy
Public API
I18nFacade— public facade for translation consumptionI18nLoader,Translator— translation loading and translation contractsI18nLocaleResolver,I18nResolveContext— locale resolution contractsI18N_TOKEN— DI token for the i18n service- Error types (
@comity/i18n/errors) - Setup — module wiring tokens (
@comity/i18n/setup)
No exhaustive reference; see docs for constraints.
Documentation
- docs/overview.md
- docs/conventions.md
- docs/architecture.md
Related Packages
- @comity/i18n-typesafe — typed setup helper for i18n
- @comity/kernel — module lifecycle runtime
Status
Stable
Review Completed: 2026-07-25 Reviewer: Hobiri MAGI (DeepSeek v4 Pro) Compliance Score: 99.5% (Green)
