@flyingrobots/bijou-i18n

The in-memory localization runtime for Bijou.

@flyingrobots/bijou-i18n provides:

• namespaced catalogs
• locale and direction
• message lookup
• generic resource lookup
• runtime-safe references
• locale-aware formatting seams
• async locale loader support for runtime-integrated catalog activation

This package is intentionally runtime-only. Spreadsheet workflows, stale detection, pseudo-localization, and catalog compilation belong in @flyingrobots/bijou-i18n-tools.

Loader Seam

Use createI18nRuntime() for fully preloaded catalogs, or createI18nRuntimeAsync() when catalogs need to be loaded lazily:

import { createI18nRuntimeAsync, type I18nCatalogLoader } from '@flyingrobots/bijou-i18n';

const loader: I18nCatalogLoader = async (locale) => {
  const module = await import(`./catalogs/${locale}.js`);
  return module.catalogs;
};

const runtime = await createI18nRuntimeAsync({
  locale: 'fr',
  direction: 'ltr',
  loader,
});

The same loader seam also supports file-backed locale bundles through @flyingrobots/bijou-i18n-tools-node:

import { createI18nRuntimeAsync } from '@flyingrobots/bijou-i18n';
import { createCatalogBundleFileLoader } from '@flyingrobots/bijou-i18n-tools-node';

const runtime = await createI18nRuntimeAsync({
  locale: 'fr',
  direction: 'ltr',
  loader: createCatalogBundleFileLoader({
    resolvePath: (locale) => `./i18n/${locale}.json`,
  }),
});

Once created, the runtime can preload and activate locales explicitly:

await runtime.preloadLocale('de');
await runtime.setLocale('de');

Documentation

See the Bijou repo for the full documentation map, architecture guide, and design system.