i18n
Feature-scoped translations — ‘Hallo’ and ‘Hello’ in the same app.
What it shows
Section titled “What it shows”r.translations()for multi-language feature keys- Plurals
requiredLocales: boot fails when a key misses one of the app’s languages
Plurals
Section titled “Plurals”A translation value can be a CLDR plural-forms object instead of a plain
string. other is required; the rest (zero/one/two/few/many) only
exist where the locale’s grammar needs them:
"greeting.unread_count": { de: { one: "{count} ungelesene Nachricht", other: "{count} ungelesene Nachrichten" }, en: { one: "{count} unread message", other: "{count} unread messages" },},t(key, locale, { count }) picks the CLDR category for count via
Intl.PluralRules(locale), then interpolates {count} (and any other
{name} placeholder) into the chosen form.
Required locales
Section titled “Required locales”Without further options boot only checks that each feature is consistent with
itself. An app that ships fixed languages lists them, and boot then fails on any
key that misses one of them, including framework keys. Locale packages such as
locale-de count:
runProdApp({ ...options, validateBootOptions: { requiredLocales: ["de", "en"] } });Define the options once and re-export them as VALIDATE_BOOT_OPTIONS from
kumiko/schema.ts, so kumiko-schema validate checks the same list in CI.
Source
Section titled “Source”Feature entry point: src/feature.ts.
cd samples/recipes/i18nbun testSource code
Section titled “Source code”The feature entry point — embedded straight from the source file, so the code here is exactly what runs. Multi-file samples keep their remaining files next to it on GitHub (link below):
// i18n Sample// Shows: r.translations() for multi-language feature keys, and plural forms// (CLDR categories) for a count-dependent key
import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
export const greetingFeature = defineFeature("greeting", (r) => { r.translations({ keys: { "greeting.welcome": { de: "Willkommen", en: "Welcome", fr: "Bienvenue", pl: "Witamy", }, "greeting.goodbye": { de: "Auf Wiedersehen", en: "Goodbye", fr: "Au revoir", pl: "Do widzenia", }, "greeting.hello_name": { de: "Hallo, {name}!", en: "Hello, {name}!", fr: "Bonjour, {name}!", pl: "Cześć, {name}!", }, "greeting.unread_count": { de: { one: "{count} ungelesene Nachricht", other: "{count} ungelesene Nachrichten" }, en: { one: "{count} unread message", other: "{count} unread messages" }, fr: { one: "{count} message non lu", other: "{count} messages non lus" }, pl: { one: "{count} nieprzeczytana wiadomość", few: "{count} nieprzeczytane wiadomości", many: "{count} nieprzeczytanych wiadomości", other: "{count} nieprzeczytanej wiadomości", }, }, }, });});
export const errorFeature = defineFeature("errors", (r) => { r.translations({ keys: { "errors.not_found": { de: "Nicht gefunden", en: "Not found", }, "errors.access_denied": { de: "Zugriff verweigert", en: "Access denied", }, }, });});📄 On GitHub: samples/recipes/i18n/src/feature.ts