feat: add meaningful error when locale is not set

packages/core/src/i18n.test.ts

@@ -431,4 +431,17 @@ describe("I18n", () => {
     expect(i18n._("Software development")).toEqual("Software­entwicklung")
     expect(i18n._("Software development")).toEqual("Software­entwicklung")
   })
+
+  it("._ should throw a meaningful error when locale is not set", () => {
+    const i18n = setupI18n({})
+    expect(() =>
+      i18n._(
+        "Text {0, plural, offset:1 =0 {No books} =1 {1 book} other {# books}}"
+      )
+    ).toThrowErrorMatchingInlineSnapshot(`
+      "Lingui: Attempted to call a translation function without setting a locale.
+      Make sure to call \`i18n.activate(locale)\` before using Lingui functions.
+      This issue may also occur due to a race condition in your initialization logic."
+    `)
+  })
 })

packages/core/src/i18n.ts

@@ -240,6 +240,14 @@ export class I18n extends EventEmitter<Events> {
     values?: Values,
     options?: MessageOptions
   ): string {
+    if (!this.locale) {
+      throw new Error(
+        "Lingui: Attempted to call a translation function without setting a locale.\n" +
+          "Make sure to call `i18n.activate(locale)` before using Lingui functions.\n" +
+          "This issue may also occur due to a race condition in your initialization logic."
+      )
+    }
+
     let message = options?.message
 
     if (!id) {

packages/vite-plugin/test/macro-usage/entrypoint.js

@@ -1,5 +1,10 @@
 import { t } from "@lingui/core/macro"
+import { i18n } from "@lingui/core"
 
 export async function load() {
+  i18n.loadAndActivate({
+    locale: "en",
+    messages: {},
+  })
   return t`Ola`
 }