Changelog

Copy Markdown View Source

[0.2.0] - 2026-08-11

The domain, not the locale, is the unit of loading. Measured in a client app: 573 of 849 msgids were admin-panel copy, and every public English page downloaded all of them — 30 kB gzipped of a catalog no visitor can reach.

Breaking:

  • Codegen emits catalog/<locale>/<domain>.ts, not catalog/<locale>.ts. Static importers must name the domain.
  • loadCatalog(locale, only?) takes the domains to load; omitting them loads the locale whole, as before.
  • LocaleCatalog and Overrides are Partial<Record<Domain, DomainCatalog>> and createT/useT take a Domain, not a string. A domain typo is now a type error; a domain the route tree did not load is not.
  • The source locale gets no catalog files. Identity is what msgid passthrough already gives, so writing it out only made the source language download its own copy. A source locale with real PO files on disk is emitted as before.
  • Stale files under catalog/ are deleted, and reported by --check.

Added:

  • I18nProvider takes a domains prop — the chunks that subtree needs. Nest a second provider around an admin area to load its domain lazily.
  • The extractor understands the domain in the BINDING: every const t = useT("admin") in a file attributes that file's t("…") calls to admin. Without it, moving a subtree to its own domain kept extracting into the default one, and the drift showed up only as untranslated copy at runtime. Hook name configurable as :domain_hook (default "useT").

[0.1.1] - 2026-08-11

  • I18nProvider takes an optional initialCatalog, used as the provider's initial state. A per-locale server-rendered route tree can now import its catalog statically and be translated in the first HTML, instead of shipping source language and swapping after hydration. The lazy load is unchanged.

[0.1.0] - 2026-08-11

Initial extraction from the Vulcora apps (mosis's PO→TypeScript pipeline), with the production-known defects fixed: nested locale→domain→msgid catalogs (cross-domain msgid collisions), per-locale output files with lazy loading (previously one all-locales bundle), a single %{var} interpolation dialect, configurable frontend scanning, and first-class runtime overrides on both sides (backend override MFA in the t macro, overrides prop in the React provider).