Lazy loading

Every namespace loads through generated namespaceLoaders under codegenPath/namespace-loaders.generated.ts. There is no eager loadOnInit / canonical bundle — call load({ namespaces, locale }) for what the page needs.

{
  "projectName": "MyProject",
  "delivery": "split-by-locale",
  "namespaces": {
    "default": "translations/default.json",
    "billing": "translations/billing.yaml"
  },
  "codegenPath": "generated"
}

import { createI18n } from "./i18n";

const { t } = await createI18n().load({
  namespaces: ["default", "billing"],
  locale: "en",
});
t("billing", "invoice_summary", { count: 12 });

With delivery: "custom", loaders take a delivery area (mapped from locale via generated LOCALE_DELIVERY_AREA):

const { t } = await createI18n().load({
  namespaces: ["billing"],
  locale: "it",
});

loaderStrategy: "fetch" resolves JSON through an injectable fetchImpl({ locale, namespace, area? }) so delivery JSON can change without rebuilding TypeScript (pair with regenerateNamespaces). URL / storage mapping is app-owned:

const i18n = createI18n({ fetchImpl: myFetchArtifact });
const hydrated = createI18n({ fetchImpl: myFetchArtifact, state });

In React, pass the same fetchImpl to generated I18nRoot. See Delivery, React, and External validation.