@gusnips/react 0.4.4 → 0.4.5

package/dist/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACT,EAAE,eAAe;;;;;;;;;;;;;;;;EAqBjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAmB/E"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACT,EAAE,eAAe;;;;;;;;;;;;;;;;EAuBjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAmB/E"}

package/dist/i18n.js

@@ -26,11 +26,13 @@ export function i18nInitOptions({ fallbackLng, supportedLngs, storageKey, queryK
             lookupLocalStorage: storageKey,
         },
         react: { useSuspense: false },
-        // `nonExplicitSupportedLngs` is omitted deliberately, and both donors say so in the same
-        // words. Enabling it validates the BASE subtag against `supportedLngs`, which rejects a
-        // region-coded "pt-BR" (its base "pt" is not in the list) and silently falls the whole app
-        // back to English. Detected sub-locales like "en-US" already resolve to their base through
-        // i18next's ordinary fallback hierarchy, so the flag buys nothing and breaks pt-BR.
+        // `nonExplicitSupportedLngs` is omitted deliberately. It breaks both shapes a catalog comes in.
+        // Region-coded: it validates the BASE subtag against `supportedLngs`, "pt" is not in a list
+        // that says "pt-BR", and the whole app silently renders English — both donors say so in the
+        // same words. Base codes: an "en-US" browser keeps "en-US" as `i18n.language`. Beside
+        // `currentOnly` no catalog matches it, so the reader gets the fallback language; beside
+        // `languageOnly` the copy is right and every map an app keys by the tag misses — the third
+        // migration shipped English copy as `lang="pt-BR"`. Without the flag "en-US" settles on "en".
     };
 }
 /**

package/dist/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4BH,MAAM,UAAU,eAAe,CAAC,EAC9B,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACQ;IAChB,OAAO;QACL,WAAW;QACX,aAAa,EAAE,CAAC,GAAG,aAAa,CAAC;QACjC,IAAI,EAAE,aAAsB;QAC5B,aAAa,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,yBAAyB;QAChE,SAAS,EAAE;YACT,KAAK,EAAE,QAAQ;gBACb,CAAC,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,CAAC;gBAC9C,CAAC,CAAC,CAAC,cAAc,EAAE,WAAW,CAAC;YACjC,MAAM,EAAE,CAAC,cAAc,CAAC;YACxB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,kBAAkB,EAAE,UAAU;SAC/B;QACD,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;QAC7B,yFAAyF;QACzF,wFAAwF;QACxF,2FAA2F;QAC3F,2FAA2F;QAC3F,oFAAoF;KACrF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAI,SAAY,EAAE,IAA4B;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,UAAU,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EACvF,GAAG,CACJ,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9F,MAAM,IAAI,GAAG,CAAC,KAAc,EAAW,EAAE;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YACpC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAM,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4BH,MAAM,UAAU,eAAe,CAAC,EAC9B,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACQ;IAChB,OAAO;QACL,WAAW;QACX,aAAa,EAAE,CAAC,GAAG,aAAa,CAAC;QACjC,IAAI,EAAE,aAAsB;QAC5B,aAAa,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,yBAAyB;QAChE,SAAS,EAAE;YACT,KAAK,EAAE,QAAQ;gBACb,CAAC,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,CAAC;gBAC9C,CAAC,CAAC,CAAC,cAAc,EAAE,WAAW,CAAC;YACjC,MAAM,EAAE,CAAC,cAAc,CAAC;YACxB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,kBAAkB,EAAE,UAAU;SAC/B;QACD,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;QAC7B,gGAAgG;QAChG,4FAA4F;QAC5F,4FAA4F;QAC5F,sFAAsF;QACtF,wFAAwF;QACxF,2FAA2F;QAC3F,8FAA8F;KAC/F,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAI,SAAY,EAAE,IAA4B;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,UAAU,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EACvF,GAAG,CACJ,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9F,MAAM,IAAI,GAAG,CAAC,KAAc,EAAW,EAAE;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YACpC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAM,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusnips/react",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "The headless runtime under a Vite + React SPA: typed fetch client with single-flight refresh, auth store, query defaults, route guards, error boundary, chunk-reload recovery, i18n bootstrap.",
   "type": "module",
   "license": "MIT",

package/src/i18n.test.ts

@@ -1,5 +1,6 @@
+import { createInstance } from "i18next";
 import { describe, expect, it } from "vitest";
-import { applyBrandVars, i18nInitOptions } from "./i18n.ts";
+import { applyBrandVars, i18nInitOptions, type I18nInitOptions } from "./i18n.ts";
 
 describe("applyBrandVars", () => {
   it("fills placeholders anywhere in the tree and leaves the input alone", () => {
@@ -27,17 +28,34 @@ describe("applyBrandVars", () => {
   });
 });
 
+/** For a browser saying `lng`: the app's `i18n.language`, and the catalog that answers. */
+async function settle(
+  options: Omit<I18nInitOptions, "storageKey">,
+  lng: string,
+): Promise<[language: string, catalog: string]> {
+  const i18n = createInstance();
+  const resources = Object.fromEntries(
+    options.supportedLngs.map((tag) => [tag, { translation: { tag } }]),
+  );
+  await i18n.init({ ...i18nInitOptions({ ...options, storageKey: "app.locale" }), resources, lng });
+  return [i18n.language, i18n.t("tag")];
+}
+
 describe("i18nInitOptions", () => {
-  // The comment in both donors names the bug: `nonExplicitSupportedLngs` validates the BASE
-  // subtag, which rejects "pt-BR" (its base "pt" is not listed) and silently falls the whole
-  // app back to English. Its absence is load-bearing.
-  it("does not set nonExplicitSupportedLngs", () => {
-    const options = i18nInitOptions({
-      fallbackLng: "en",
-      supportedLngs: ["en", "pt-BR"],
-      storageKey: "app.locale",
-    });
-    expect(options).not.toHaveProperty("nonExplicitSupportedLngs");
+  // `nonExplicitSupportedLngs` breaks both catalog shapes, and this pins both. Region-coded, the
+  // app renders English for a pt-BR reader — the bug both donors' comments name. Base codes, an
+  // "en-US" browser keeps "en-US" as `i18n.language`, which is what an app keys `<html lang>` and
+  // `og:locale` by: the third migration's site missed its lookup and shipped English copy as
+  // `lang="pt-BR"`.
+  it("settles a browser's regional tag on a language the catalogs have", async () => {
+    const baseCodes = { fallbackLng: "pt", supportedLngs: ["pt", "es", "en"] };
+    expect(await settle(baseCodes, "en-US")).toEqual(["en", "en"]);
+    expect(await settle(baseCodes, "es-419")).toEqual(["es", "es"]);
+    expect(await settle(baseCodes, "fr-FR")).toEqual(["pt", "pt"]);
+
+    const regionCoded = { fallbackLng: "en", supportedLngs: ["en", "pt-BR"] };
+    expect(await settle(regionCoded, "pt-BR")).toEqual(["pt-BR", "pt-BR"]);
+    expect(await settle(regionCoded, "en-GB")).toEqual(["en", "en"]);
   });
 
   // Only one donor had the query parameter, and it is the only detection source somebody chose

package/src/i18n.ts

@@ -58,11 +58,13 @@ export function i18nInitOptions({
       lookupLocalStorage: storageKey,
     },
     react: { useSuspense: false },
-    // `nonExplicitSupportedLngs` is omitted deliberately, and both donors say so in the same
-    // words. Enabling it validates the BASE subtag against `supportedLngs`, which rejects a
-    // region-coded "pt-BR" (its base "pt" is not in the list) and silently falls the whole app
-    // back to English. Detected sub-locales like "en-US" already resolve to their base through
-    // i18next's ordinary fallback hierarchy, so the flag buys nothing and breaks pt-BR.
+    // `nonExplicitSupportedLngs` is omitted deliberately. It breaks both shapes a catalog comes in.
+    // Region-coded: it validates the BASE subtag against `supportedLngs`, "pt" is not in a list
+    // that says "pt-BR", and the whole app silently renders English — both donors say so in the
+    // same words. Base codes: an "en-US" browser keeps "en-US" as `i18n.language`. Beside
+    // `currentOnly` no catalog matches it, so the reader gets the fallback language; beside
+    // `languageOnly` the copy is right and every map an app keys by the tag misses — the third
+    // migration shipped English copy as `lang="pt-BR"`. Without the flag "en-US" settles on "en".
   };
 }