@prosopo/locale 3.6.2 → 3.7.0

package/dist/locales/sr/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "Померајте део стрелицама, уз држање тастера Shift за ситније кораке. Притисните Enter да га пошаљете, Home да га вратите на почетак или Escape да откажете.",
 			"POSITION": "{{x}} посто с лева, {{y}} посто одозго",
 			"CHECKING": "Проверавамо ваш одговор",
-			"RETRY_ANNOUNCEMENT": "За длаку. Учитана је нова слагалица и део је поново на почетку."
+			"RETRY_ANNOUNCEMENT": "За длаку. Учитана је нова слагалица и део је поново на почетку.",
+			"REFRESH": "Друга слагалица"
 		}
 	},
 	"CONTRACT": {

package/dist/locales/sv/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "Flytta biten med piltangenterna, håll ned skift för mindre steg. Tryck på Retur för att skicka in den, Home för att lägga tillbaka den vid starten, eller Escape för att avbryta.",
 			"POSITION": "{{x}} procent från vänster, {{y}} procent uppifrån",
 			"CHECKING": "Kontrollerar ditt svar",
-			"RETRY_ANNOUNCEMENT": "Nästan. Ett nytt pussel har laddats och biten är tillbaka vid starten."
+			"RETRY_ANNOUNCEMENT": "Nästan. Ett nytt pussel har laddats och biten är tillbaka vid starten.",
+			"REFRESH": "Ett annat pussel"
 		}
 	},
 	"CONTRACT": {

package/dist/locales/th/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "ใช้ปุ่มลูกศรเพื่อเลื่อนชิ้นส่วน กดปุ่ม Shift ค้างไว้เพื่อเลื่อนทีละน้อย กด Enter เพื่อส่ง กด Home เพื่อกลับไปยังจุดเริ่มต้น หรือกด Escape เพื่อยกเลิก",
 			"POSITION": "{{x}} เปอร์เซ็นต์จากด้านซ้าย {{y}} เปอร์เซ็นต์จากด้านบน",
 			"CHECKING": "กำลังตรวจคำตอบของคุณ",
-			"RETRY_ANNOUNCEMENT": "เกือบแล้ว มีจิ๊กซอว์ชุดใหม่โหลดขึ้นมา และชิ้นส่วนกลับไปอยู่ที่จุดเริ่มต้น"
+			"RETRY_ANNOUNCEMENT": "เกือบแล้ว มีจิ๊กซอว์ชุดใหม่โหลดขึ้นมา และชิ้นส่วนกลับไปอยู่ที่จุดเริ่มต้น",
+			"REFRESH": "จิ๊กซอว์ชุดอื่น"
 		}
 	},
 	"CONTRACT": {

package/dist/locales/tr/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "Parçayı ok tuşlarıyla taşıyın, daha küçük adımlar için Shift tuşunu basılı tutun. Göndermek için Enter'a, başa döndürmek için Home'a, iptal etmek için Escape'e basın.",
 			"POSITION": "soldan yüzde {{x}}, yukarıdan yüzde {{y}}",
 			"CHECKING": "Cevabınız kontrol ediliyor",
-			"RETRY_ANNOUNCEMENT": "Az kaldı. Yeni bir yapboz yüklendi ve parça yeniden başlangıçta."
+			"RETRY_ANNOUNCEMENT": "Az kaldı. Yeni bir yapboz yüklendi ve parça yeniden başlangıçta.",
+			"REFRESH": "Başka bir yapboz"
 		}
 	},
 	"CONTRACT": {

package/dist/locales/uk/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "Переміщуйте фрагмент клавішами зі стрілками, утримуйте Shift для менших кроків. Натисніть Enter, щоб надіслати, Home, щоб повернути його на початок, або Escape, щоб скасувати.",
 			"POSITION": "{{x}} відсотків зліва, {{y}} відсотків згори",
 			"CHECKING": "Перевіряємо вашу відповідь",
-			"RETRY_ANNOUNCEMENT": "Майже. Завантажено новий пазл, і фрагмент знову на початку."
+			"RETRY_ANNOUNCEMENT": "Майже. Завантажено новий пазл, і фрагмент знову на початку.",
+			"REFRESH": "Інший пазл"
 		}
 	},
 	"CONTRACT": {

package/dist/locales/vi/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "Dùng các phím mũi tên để di chuyển mảnh ghép, giữ Shift để đi từng bước nhỏ hơn. Nhấn Enter để gửi, Home để đưa nó về vị trí ban đầu, hoặc Escape để hủy.",
 			"POSITION": "{{x}} phần trăm từ bên trái, {{y}} phần trăm từ trên xuống",
 			"CHECKING": "Đang kiểm tra câu trả lời của bạn",
-			"RETRY_ANNOUNCEMENT": "Suýt nữa. Một hình ghép mới đã được tải và mảnh ghép trở lại vị trí ban đầu."
+			"RETRY_ANNOUNCEMENT": "Suýt nữa. Một hình ghép mới đã được tải và mảnh ghép trở lại vị trí ban đầu.",
+			"REFRESH": "Hình ghép khác"
 		}
 	},
 	"CONTRACT": {

package/dist/locales/zh-CN/translation.json

@@ -398,7 +398,8 @@
 			"KEYBOARD_HINT": "用方向键移动拼块，按住 Shift 可以小步移动。按 Enter 提交，按 Home 让它回到起点，按 Escape 取消。",
 			"POSITION": "距左边 {{x}} %，距顶部 {{y}} %",
 			"CHECKING": "正在检查您的答案",
-			"RETRY_ANNOUNCEMENT": "差一点。已加载新的拼图，拼块回到了起点。"
+			"RETRY_ANNOUNCEMENT": "差一点。已加载新的拼图，拼块回到了起点。",
+			"REFRESH": "换一个拼图"
 		}
 	},
 	"CONTRACT": {

package/package.json

@@ -1,67 +1,66 @@
 {
-	"name": "@prosopo/locale",
-	"version": "3.6.2",
-	"description": "Prosopo locale library",
-	"type": "module",
-	"engines": {
-		"node": "^24",
-		"npm": "^11"
-	},
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js",
-			"require": "./dist/cjs/index.cjs"
-		},
-		"./locales/en/translation.json": {
-			"import": "./dist/locales/en/translation.json",
-			"require": "./dist/locales/en/translation.json"
-		}
-	},
-	"scripts": {
-		"clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
-		"build": "npm run build:cross-env -- --mode ${NODE_ENV:-development}",
-		"build:cross-env": "vite build --config vite.esm.config.ts",
-		"build:tsc": "tsc --build --verbose",
-		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
-		"typecheck": "tsc --project tsconfig.types.json",
-		"test": "NODE_ENV=${NODE_ENV:-test}; npx vitest run --config ./vite.test.config.ts"
-	},
-	"author": "Prosopo Limited",
-	"license": "Apache-2.0",
-	"dependencies": {
-		"@prosopo/util": "3.3.13",
-		"i18next": "26.4.2",
-		"i18next-fs-backend": "2.6.8",
-		"i18next-http-middleware": "3.9.9"
-	},
-	"devDependencies": {
-		"@prosopo/config": "3.4.2",
-		"@types/node": "22.10.2",
-		"@vitest/coverage-v8": "4.1.11",
-		"concurrently": "9.0.1",
-		"del-cli": "6.0.0",
-		"dotenv": "16.4.5",
-		"npm-run-all": "4.1.5",
-		"tslib": "2.7.0",
-		"tsx": "4.20.3",
-		"typescript": "5.6.2",
-		"vite": "8.1.5",
-		"vitest": "4.1.11"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/prosopo/captcha.git",
-		"directory": "packages/locale"
-	},
-	"bugs": {
-		"url": "https://github.com/prosopo/captcha/issues"
-	},
-	"homepage": "https://github.com/prosopo/captcha#readme",
-	"publishConfig": {
-		"registry": "https://registry.npmjs.org"
-	},
-	"sideEffects": false
-}
+  "name": "@prosopo/locale",
+  "version": "3.7.0",
+  "description": "Prosopo locale library",
+  "type": "module",
+  "engines": {
+    "node": "^24"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.cjs"
+    },
+    "./locales/en/translation.json": {
+      "import": "./dist/locales/en/translation.json",
+      "require": "./dist/locales/en/translation.json"
+    }
+  },
+  "author": "Prosopo Limited",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@prosopo/util": "3.3.14",
+    "i18next": "26.4.2",
+    "i18next-fs-backend": "2.6.8",
+    "i18next-http-middleware": "3.9.9"
+  },
+  "devDependencies": {
+    "@prosopo/config": "3.4.3",
+    "@types/node": "22.10.2",
+    "@vitest/coverage-v8": "4.1.11",
+    "concurrently": "9.0.1",
+    "del-cli": "6.0.0",
+    "dotenv": "16.4.5",
+    "npm-run-all": "4.1.5",
+    "tslib": "2.7.0",
+    "tsx": "4.20.3",
+    "typescript": "5.6.2",
+    "vite": "8.1.5",
+    "vitest": "4.1.11"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prosopo/captcha.git",
+    "directory": "packages/locale"
+  },
+  "bugs": {
+    "url": "https://github.com/prosopo/captcha/issues"
+  },
+  "homepage": "https://github.com/prosopo/captcha#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
+    "build": "pnpm run build:cross-env --mode ${NODE_ENV:-development}",
+    "build:cross-env": "vite build --config vite.esm.config.ts",
+    "build:tsc": "tsc --build --verbose",
+    "build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
+    "typecheck": "tsc --project tsconfig.types.json",
+    "test": "NODE_ENV=${NODE_ENV:-test}; pnpm exec vitest run --config ./vite.test.config.ts"
+  }
+}

package/src/direction.ts

@@ -1,36 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-export type TextDirection = "ltr" | "rtl";
-
-// Scripts written right to left, by primary language subtag. Wider than the
-// shipped catalogues so a site asking for e.g. "he" still gets a mirrored
-// layout around whichever fallback text it is served.
-const RTL_LANGUAGES: ReadonlySet<string> = new Set([
-	"ar",
-	"ckb",
-	"dv",
-	"fa",
-	"he",
-	"ps",
-	"sd",
-	"ug",
-	"ur",
-	"yi",
-]);
-
-export const getLanguageDirection = (language: string): TextDirection => {
-	const primary = language.split(/[-_]/)[0]?.toLowerCase() ?? "";
-	return RTL_LANGUAGES.has(primary) ? "rtl" : "ltr";
-};

package/src/errorMessage.ts

@@ -1,37 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import { isTranslationKey } from "./translationKey.js";
-import type { Ti18n } from "./types.js";
-
-export interface KeyedErrorMessage {
-	message: string;
-	key?: string;
-}
-
-/**
- * The provider translates error messages into the request's Accept-Language,
- * which is the browser's language rather than the widget's. Re-translating the
- * error key on the client shows the error in the language the widget renders
- * in. Free text and keys the catalogue doesn't have keep the server's message.
- */
-export const localiseErrorMessage = (
-	i18n: Ti18n | undefined,
-	error: KeyedErrorMessage,
-): string => {
-	const { key, message } = error;
-	if (!key || !isTranslationKey(key) || !i18n?.isInitialized) {
-		return message;
-	}
-	return i18n.t(key, { defaultValue: message });
-};

package/src/i18SharedOptions.ts

@@ -1,29 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import { getProcess } from "./process.js";
-import { LanguageCodes, Languages } from "./translations.js";
-
-// Read through getProcess() so the module stays loadable in a plain browser
-// runtime where `process` is undefined. Without that guard, any side-effectful
-// runtime import of `@prosopo/types` (which transitively reaches here via
-// `LanguageSchema`) crashes the page in Vite's dev/preview mode.
-const logLevel = getProcess()?.env?.PROSOPO_LOG_LEVEL;
-
-export const i18nSharedOptions = {
-	debug: logLevel === "debug",
-	fallbackLng: Languages.english,
-	namespace: "translation",
-	supportedLngs: LanguageCodes,
-	nonExplicitSupportedLngs: false,
-};

package/src/i18nBackend.ts

@@ -1,69 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import path from "node:path";
-import i18n from "i18next";
-import FSBackend from "i18next-fs-backend/cjs"; // https://github.com/i18next/i18next-fs-backend/issues/57
-import { LanguageDetector as MiddlewareLanguageDetector } from "i18next-http-middleware";
-import { i18nSharedOptions } from "./i18SharedOptions.js";
-import { isServerSide } from "./util.js";
-
-const loadPath =
-	`${path.dirname(import.meta.url)}/locales/{{lng}}/{{ns}}.json`.replace(
-		"file://",
-		"",
-	);
-
-export function initializeI18n(
-	i18nLoadedCallback?: (value: typeof i18n) => void,
-) {
-	if (!i18n.isInitialized && isServerSide()) {
-		const lngDetector = new MiddlewareLanguageDetector(null, {
-			order: ["header", "query", "cookie"],
-		});
-		i18n
-			// @ts-ignore https://github.com/i18next/i18next-fs-backend/issues/57
-			.use(FSBackend)
-			.use(lngDetector) // this line should switch the language to the one the user reports in the Accept-Language header
-			.init({
-				...i18nSharedOptions,
-				ns: ["translation"],
-				backend: {
-					loadPath,
-				},
-			});
-		// "loaded" fires once per namespace, and again after changeLanguage(),
-		// so the raw event is not the one-shot signal the callback expects.
-		// Latch it here as well as in loadI18next: this callback is public and
-		// a caller could reasonably use it to run a side effect.
-		let notified = false;
-		i18n.on("loaded", () => {
-			if (notified) {
-				return;
-			}
-			notified = true;
-			i18nLoadedCallback?.(i18n);
-		});
-	} else {
-		// Nothing to initialise — either i18next is already up (a frontend
-		// consumer got there first) or we are not on the server. The `loaded`
-		// handler above is only registered inside the init branch, so without
-		// this the callback would never fire and loadI18next() would stay
-		// pending forever instead of handing back the instance we already have.
-		i18nLoadedCallback?.(i18n);
-	}
-	return i18n;
-}
-
-export default initializeI18n;

package/src/i18nFrontend.ts

@@ -1,267 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { flatten } from "@prosopo/util";
-import { i18nSharedOptions } from "./i18SharedOptions.js";
-import type { I18nEvent, Ti18n, TranslateOptions } from "./types.js";
-
-const NAMESPACE = "translation";
-const FALLBACK_LANGUAGE = i18nSharedOptions.fallbackLng;
-const STORAGE_KEY = "i18nextLng";
-const COOKIE_KEY = "i18next";
-const COOKIE_MAX_AGE_SECONDS = 7 * 24 * 60 * 60;
-
-/**
- * How long to wait for a catalogue before rendering untranslated.
- *
- * A widget with no text is worse than a widget in English: every caller
- * supplies a `defaultValue`, and `t()` falls back to the key otherwise, so a
- * catalogue that never arrives degrades rather than blocks.
- */
-const CATALOGUE_FETCH_TIMEOUT_MS = 10_000;
-
-type Catalogue = Record<string, string>;
-
-const SUPPORTED_LANGUAGES: readonly string[] = i18nSharedOptions.supportedLngs;
-
-/**
- * Locale JSON sits next to the bundle that asked for it. The widget is embedded
- * by third parties and cannot know a base URL, but it does know where its own
- * module was served from.
- */
-const catalogueUrl = (language: string): string => {
-	const moduleUrl = import.meta.url;
-	const directory = moduleUrl.slice(0, moduleUrl.lastIndexOf("/"));
-	return `${directory}/locales/${language}/${NAMESPACE}.json`;
-};
-
-/**
- * `en-GB` is not in the catalogue list but `en` is, so a regional tag resolves
- * to its base language rather than falling all the way back to English.
- */
-const resolveLanguage = (candidate: string | undefined): string | undefined => {
-	if (!candidate) {
-		return undefined;
-	}
-	if (SUPPORTED_LANGUAGES.includes(candidate)) {
-		return candidate;
-	}
-	const base = candidate.split("-")[0];
-	return base && SUPPORTED_LANGUAGES.includes(base) ? base : undefined;
-};
-
-const readCookie = (): string | undefined => {
-	try {
-		const match = document.cookie.match(
-			new RegExp(`(?:^|; )${COOKIE_KEY}=([^;]*)`),
-		);
-		return match?.[1] ? decodeURIComponent(match[1]) : undefined;
-	} catch {
-		return undefined;
-	}
-};
-
-const readStorage = (): string | undefined => {
-	try {
-		return localStorage.getItem(STORAGE_KEY) ?? undefined;
-	} catch {
-		return undefined;
-	}
-};
-
-const navigatorLanguages = (): readonly string[] => {
-	try {
-		return navigator.languages?.length
-			? navigator.languages
-			: [navigator.language];
-	} catch {
-		return [];
-	}
-};
-
-/**
- * Cookie and localStorage are both written, matching what the widget did when
- * i18next-browser-languagedetector handled this, so a visitor's choice survives
- * across pages that embed the widget. Either store can throw in a sandboxed
- * iframe or with third-party storage blocked; neither is load-bearing.
- */
-const cacheLanguage = (language: string): void => {
-	try {
-		localStorage.setItem(STORAGE_KEY, language);
-	} catch {
-		// storage unavailable — the language is still active for this page
-	}
-	try {
-		document.cookie = `${COOKIE_KEY}=${encodeURIComponent(language)};max-age=${COOKIE_MAX_AGE_SECONDS};path=/`;
-	} catch {
-		// cookies unavailable — as above
-	}
-};
-
-const detectLanguage = (): string => {
-	const candidates = [readCookie(), readStorage(), ...navigatorLanguages()];
-	for (const candidate of candidates) {
-		const resolved = resolveLanguage(candidate);
-		if (resolved) {
-			return resolved;
-		}
-	}
-	return FALLBACK_LANGUAGE;
-};
-
-const fetchCatalogue = async (language: string): Promise<Catalogue> => {
-	const controller = new AbortController();
-	const timer = setTimeout(
-		() => controller.abort(),
-		CATALOGUE_FETCH_TIMEOUT_MS,
-	);
-	try {
-		const response = await fetch(catalogueUrl(language), {
-			signal: controller.signal,
-		});
-		if (!response.ok) {
-			return {};
-		}
-		const body: unknown = await response.json();
-		return typeof body === "object" && body !== null ? flatten(body) : {};
-	} catch {
-		return {};
-	} finally {
-		clearTimeout(timer);
-	}
-};
-
-const interpolate = (template: string, options?: TranslateOptions): string =>
-	options
-		? template.replace(/\{\{(\w+)\}\}/g, (placeholder, name: string) =>
-				name in options ? String(options[name]) : placeholder,
-			)
-		: template;
-
-interface BrowserI18n extends Ti18n {
-	/** Resolves once the active language's catalogue has been fetched. */
-	ready(): Promise<BrowserI18n>;
-}
-
-const createBrowserI18n = (requested?: string): BrowserI18n => {
-	const catalogues = new Map<string, Catalogue>();
-	const listeners = new Map<I18nEvent, Set<() => void>>();
-	let language = resolveLanguage(requested) ?? detectLanguage();
-	let initialised = false;
-
-	const emit = (event: I18nEvent): void => {
-		for (const listener of listeners.get(event) ?? []) {
-			listener();
-		}
-	};
-
-	/**
-	 * The fallback catalogue is fetched alongside the active one so a key
-	 * missing from a translation still renders English rather than its key —
-	 * the same key-level fallback i18next gave us via `fallbackLng`.
-	 */
-	const loadCatalogues = async (target: string): Promise<void> => {
-		const wanted = [...new Set([target, FALLBACK_LANGUAGE])].filter(
-			(candidate) => !catalogues.has(candidate),
-		);
-		await Promise.all(
-			wanted.map(async (candidate) => {
-				catalogues.set(candidate, await fetchCatalogue(candidate));
-			}),
-		);
-	};
-
-	const lookup = (candidate: string, key: string): string | undefined =>
-		catalogues.get(candidate)?.[key];
-
-	cacheLanguage(language);
-	const loading = loadCatalogues(language).then(() => {
-		initialised = true;
-		emit("initialized");
-		emit("loaded");
-	});
-
-	const instance: BrowserI18n = {
-		get language(): string {
-			return language;
-		},
-		get isInitialized(): boolean {
-			return initialised;
-		},
-		t: (key: string, options?: TranslateOptions): string =>
-			interpolate(
-				lookup(language, key) ??
-					lookup(FALLBACK_LANGUAGE, key) ??
-					options?.defaultValue ??
-					key,
-				options,
-			),
-		hasLoadedNamespace: (namespace: string): boolean =>
-			namespace === NAMESPACE && catalogues.has(language),
-		changeLanguage: async (next: string): Promise<BrowserI18n> => {
-			const resolved = resolveLanguage(next) ?? FALLBACK_LANGUAGE;
-			if (resolved !== language) {
-				language = resolved;
-				cacheLanguage(resolved);
-				await loadCatalogues(resolved);
-				emit("loaded");
-				emit("languageChanged");
-			}
-			return instance;
-		},
-		on: (event: I18nEvent, listener: () => void): void => {
-			const existing = listeners.get(event) ?? new Set<() => void>();
-			existing.add(listener);
-			listeners.set(event, existing);
-		},
-		off: (event: I18nEvent, listener: () => void): void => {
-			listeners.get(event)?.delete(listener);
-		},
-		ready: async (): Promise<BrowserI18n> => {
-			await loading;
-			return instance;
-		},
-	};
-
-	return instance;
-};
-
-/**
- * The widget owns this instance. A host page running its own i18n must not be
- * able to capture the widget's translations, and every widget on the page
- * shares one catalogue fetch.
- */
-let instance: BrowserI18n | undefined;
-
-export function initializeI18n(
-	i18nLoadedCallback?: (value: Ti18n) => void,
-	lng?: string,
-): Ti18n {
-	if (!instance) {
-		// Passing `lng` here rather than calling changeLanguage() afterwards is
-		// what stops the widget rendering a flash of the browser's language
-		// before the site owner's choice is applied.
-		const created = createBrowserI18n(lng);
-		instance = created;
-		void created.ready().then(() => i18nLoadedCallback?.(created));
-	} else {
-		// Already built (a second widget on the page, or createTranslator() got
-		// here first). The callback is only armed in the branch above, so it has
-		// to fire here or loadI18next() never settles.
-		i18nLoadedCallback?.(instance);
-	}
-	return instance;
-}
-
-export default initializeI18n;