kuito.
Get started

localization

namespace

Use localization for the user’s language order, calendars and clock preferences. Use message catalogs for UI strings and Intl for numbers and dates.

Read language and calendar preferences

tsx
import { watch, localization } from 'kuito';

const [locale] = localization.locales.value;
locale.languageTag; // 'pt-PT'
locale.currencyCode; // 'EUR'

const [calendar] = localization.calendars.value;
calendar.timeZone; // 'Europe/Lisbon'
calendar.uses24hourClock; // true

watch(localization.locales, ([preferred]) => console.log(preferred.languageTag)); // in a component

Translate a count with ICU messages

tsx
import { Text, localization } from 'kuito';

const t = localization.messages({
  en: {
    greeting: 'Hello, {name}!',
    inbox: '{count, plural, =0 {No messages} one {# message} other {# messages}}',
  },
  pt: {
    greeting: 'Olá, {name}!',
    inbox: '{count, plural, =0 {Sem mensagens} one {# mensagem} other {# mensagens}}',
  },
  'pt-PT': { greeting: 'Olá, {name}.' },
});

<Text>{t('inbox', { count: 3 })}</Text>; // '3 messages', or '3 mensagens' in Portuguese

Behavior and limits

locales and calendars are signals; reactive reads follow setting changes. messages(catalogs) chooses the best matching language and uses the first catalog as fallback for missing keys. Keep placeholders named and pass values separately. Layout direction follows the user language; use logical padding and margins so screens mirror correctly.

Continue

Read Localization rtl for the related workflow. The API reference lists every method, option, event and return type.

Reference

Exports 7

Methods, constants and types exposed by this native namespace.

functionmessagesMessages in ICU MessageFormat, by key, in catalogs by language tag: the returned function formats a key in the catalog of the user's best language, which it reads at each call, so typeMessageCatalogsMessages by key, in catalogs by BCP 47 tag; the first catalog is the fallback.typeMessageValuesThe values a message's arguments take, by name.typeLocaleOne of the user's preferred languages, most preferred first.typeCalendarOne of the user's calendar settings, for showing dates, times and weeks the way the user reads them.valuelocalesThe user's languages, most preferred first; follows the system's settings while watched.valuecalendarsThe user's calendars, time zone and clock; follows the system's settings while watched.
Generated from the public TypeScript declarations: signatures, props and defaults come from the checked source, descriptions from its JSDoc. No defaults are invented.