@prosopo/locale 3.4.2 → 3.5.0

package/src/locales/hu/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Túl sok beküldés erről az e-mail címről",
 		"VPN_BLOCKED": "VPN-kapcsolatokról érkező kérések nem engedélyezettek ezen az oldalon",
 		"PROXY_BLOCKED": "Proxy szerverekről érkező kérések nem engedélyezettek ezen az oldalon",
+		"TOO_MANY_LOCALHOST": "Túl sok CAPTCHA-kérés a localhostról ehhez a webhelykulcshoz",
 		"TOR_BLOCKED": "Tor kilépési csomópontokról érkező kérések nem engedélyezettek ezen az oldalon",
 		"ABUSER_BLOCKED": "Visszaélésért megjelölt hálózatokról érkező kérések nem engedélyezettek ezen az oldalon",
 		"DATACENTER_BLOCKED": "Adatközponti IP-címekről érkező kérések nem engedélyezettek ezen az oldalon",

package/src/locales/id/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Terlalu banyak pengiriman dari alamat email ini",
 		"VPN_BLOCKED": "Permintaan dari koneksi VPN tidak diizinkan untuk situs ini",
 		"PROXY_BLOCKED": "Permintaan dari server proxy tidak diizinkan untuk situs ini",
+		"TOO_MANY_LOCALHOST": "Terlalu banyak permintaan CAPTCHA dari localhost untuk kunci situs ini",
 		"TOR_BLOCKED": "Permintaan dari node keluar Tor tidak diizinkan untuk situs ini",
 		"ABUSER_BLOCKED": "Permintaan dari jaringan yang ditandai karena penyalahgunaan tidak diizinkan untuk situs ini",
 		"DATACENTER_BLOCKED": "Permintaan dari alamat IP pusat data tidak diizinkan untuk situs ini",

package/src/locales/it/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Troppi invii da questo indirizzo email",
 		"VPN_BLOCKED": "Le richieste da connessioni VPN non sono consentite per questo sito",
 		"PROXY_BLOCKED": "Le richieste da server proxy non sono consentite per questo sito",
+		"TOO_MANY_LOCALHOST": "Troppe richieste CAPTCHA da localhost per questa chiave del sito",
 		"TOR_BLOCKED": "Le richieste da nodi di uscita Tor non sono consentite per questo sito",
 		"ABUSER_BLOCKED": "Le richieste da reti segnalate per abuso non sono consentite per questo sito",
 		"DATACENTER_BLOCKED": "Le richieste da indirizzi IP di data center non sono consentite per questo sito",

package/src/locales/ja/translation.json

@@ -346,6 +346,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "このメールアドレスからの送信が多すぎます",
 		"VPN_BLOCKED": "このサイトではVPN接続からのリクエストは許可されていません",
 		"PROXY_BLOCKED": "このサイトではプロキシサーバーからのリクエストは許可されていません",
+		"TOO_MANY_LOCALHOST": "このサイトキーに対する localhost からの CAPTCHA リクエストが多すぎます",
 		"TOR_BLOCKED": "このサイトではTor出口ノードからのリクエストは許可されていません",
 		"ABUSER_BLOCKED": "このサイトでは不正行為としてフラグが付けられたネットワークからのリクエストは許可されていません",
 		"DATACENTER_BLOCKED": "このサイトではデータセンターのIPアドレスからのリクエストは許可されていません",

package/src/locales/jv/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Kakehen kiriman saka alamat email iki",
 		"VPN_BLOCKED": "Panjaluk saka sambungan VPN ora diidini kanggo situs iki",
 		"PROXY_BLOCKED": "Panjaluk saka server proxy ora diidini kanggo situs iki",
+		"TOO_MANY_LOCALHOST": "Kakehan panjaluk CAPTCHA saka localhost kanggo kunci situs iki",
 		"TOR_BLOCKED": "Panjaluk saka simpul metu Tor ora diidini kanggo situs iki",
 		"ABUSER_BLOCKED": "Panjaluk saka jaringan sing ditandhani amarga penyalahgunaan ora diidini kanggo situs iki",
 		"DATACENTER_BLOCKED": "Panjaluk saka alamat IP pusat data ora diidini kanggo situs iki",

package/src/locales/ko/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "이 이메일 주소에서 너무 많은 제출이 있었습니다",
 		"VPN_BLOCKED": "이 사이트에서는 VPN 연결의 요청이 허용되지 않습니다",
 		"PROXY_BLOCKED": "이 사이트에서는 프록시 서버의 요청이 허용되지 않습니다",
+		"TOO_MANY_LOCALHOST": "이 사이트 키에 대한 localhost의 CAPTCHA 요청이 너무 많습니다",
 		"TOR_BLOCKED": "이 사이트에서는 Tor 출구 노드의 요청이 허용되지 않습니다",
 		"ABUSER_BLOCKED": "악용으로 표시된 네트워크의 요청은 이 사이트에서 허용되지 않습니다",
 		"DATACENTER_BLOCKED": "이 사이트에서는 데이터센터 IP 주소의 요청이 허용되지 않습니다",

package/src/locales/ml/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "ഈ ഇമെയിൽ വിലാസത്തിൽ നിന്ന് വളരെയധികം സമർപ്പണങ്ങൾ",
 		"VPN_BLOCKED": "ഈ സൈറ്റിന് VPN കണക്ഷനുകളിൽ നിന്നുള്ള അഭ്യർത്ഥനകൾ അനുവദനീയമല്ല",
 		"PROXY_BLOCKED": "ഈ സൈറ്റിന് പ്രോക്സി സെർവറുകളിൽ നിന്നുള്ള അഭ്യർത്ഥനകൾ അനുവദനീയമല്ല",
+		"TOO_MANY_LOCALHOST": "ഈ സൈറ്റ് കീയ്ക്കായി localhost-ൽ നിന്ന് വളരെയധികം CAPTCHA അഭ്യർത്ഥനകൾ",
 		"TOR_BLOCKED": "ഈ സൈറ്റിന് Tor എക്സിറ്റ് നോഡുകളിൽ നിന്നുള്ള അഭ്യർത്ഥനകൾ അനുവദനീയമല്ല",
 		"ABUSER_BLOCKED": "ദുരുപയോഗത്തിന് ഫ്ലാഗ് ചെയ്ത നെറ്റ്വർക്കുകളിൽ നിന്നുള്ള അഭ്യർത്ഥനകൾ ഈ സൈറ്റിന് അനുവദനീയമല്ല",
 		"DATACENTER_BLOCKED": "ഈ സൈറ്റിന് ഡാറ്റാസെന്റർ IP വിലാസങ്ങളിൽ നിന്നുള്ള അഭ്യർത്ഥനകൾ അനുവദനീയമല്ല",

package/src/locales/ms/translation.json

@@ -346,6 +346,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Terlalu banyak penghantaran dari alamat e-mel ini",
 		"VPN_BLOCKED": "Permintaan daripada sambungan VPN tidak dibenarkan untuk laman ini",
 		"PROXY_BLOCKED": "Permintaan daripada pelayan proksi tidak dibenarkan untuk laman ini",
+		"TOO_MANY_LOCALHOST": "Terlalu banyak permintaan CAPTCHA dari localhost untuk kunci tapak ini",
 		"TOR_BLOCKED": "Permintaan daripada nod keluar Tor tidak dibenarkan untuk laman ini",
 		"ABUSER_BLOCKED": "Permintaan daripada rangkaian yang ditandakan kerana penyalahgunaan tidak dibenarkan untuk laman ini",
 		"DATACENTER_BLOCKED": "Permintaan daripada alamat IP pusat data tidak dibenarkan untuk laman ini",

package/src/locales/nl/translation.json

@@ -346,6 +346,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Te veel inzendingen vanaf dit e-mailadres",
 		"VPN_BLOCKED": "Verzoeken via VPN-verbindingen zijn niet toegestaan voor deze site",
 		"PROXY_BLOCKED": "Verzoeken via proxyservers zijn niet toegestaan voor deze site",
+		"TOO_MANY_LOCALHOST": "Te veel CAPTCHA-verzoeken vanaf localhost voor deze sitesleutel",
 		"TOR_BLOCKED": "Verzoeken via Tor-exitnodes zijn niet toegestaan voor deze site",
 		"ABUSER_BLOCKED": "Verzoeken van netwerken die zijn gemarkeerd voor misbruik zijn niet toegestaan voor deze site",
 		"DATACENTER_BLOCKED": "Verzoeken van datacenter-IP-adressen zijn niet toegestaan voor deze site",

package/src/locales/no/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "For mange innsendinger fra denne e-postadressen",
 		"VPN_BLOCKED": "Forespørsler fra VPN-tilkoblinger er ikke tillatt for dette nettstedet",
 		"PROXY_BLOCKED": "Forespørsler fra proxyservere er ikke tillatt for dette nettstedet",
+		"TOO_MANY_LOCALHOST": "For mange CAPTCHA-førespurnader frå localhost for denne nettstadsnøkkelen",
 		"TOR_BLOCKED": "Forespørsler fra Tor-utgangsnoder er ikke tillatt for dette nettstedet",
 		"ABUSER_BLOCKED": "Forespørsler fra nettverk flagget for misbruk er ikke tillatt for dette nettstedet",
 		"DATACENTER_BLOCKED": "Forespørsler fra datasenter-IP-adresser er ikke tillatt for dette nettstedet",

package/src/locales/pl/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Zbyt wiele zgłoszeń z tego adresu e-mail",
 		"VPN_BLOCKED": "Żądania z połączeń VPN nie są dozwolone dla tej strony",
 		"PROXY_BLOCKED": "Żądania z serwerów proxy nie są dozwolone dla tej strony",
+		"TOO_MANY_LOCALHOST": "Zbyt wiele żądań CAPTCHA z localhost dla tego klucza witryny",
 		"TOR_BLOCKED": "Żądania z węzłów wyjściowych Tor nie są dozwolone dla tej strony",
 		"ABUSER_BLOCKED": "Żądania z sieci oznaczonych za nadużycia nie są dozwolone dla tej strony",
 		"DATACENTER_BLOCKED": "Żądania z adresów IP centrów danych nie są dozwolone dla tej strony",

package/src/locales/pt/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Demasiados envios deste endereço de e-mail",
 		"VPN_BLOCKED": "Pedidos a partir de ligações VPN não são permitidos para este site",
 		"PROXY_BLOCKED": "Pedidos a partir de servidores proxy não são permitidos para este site",
+		"TOO_MANY_LOCALHOST": "Demasiados pedidos de CAPTCHA a partir de localhost para esta chave de site",
 		"TOR_BLOCKED": "Pedidos a partir de nós de saída Tor não são permitidos para este site",
 		"ABUSER_BLOCKED": "Pedidos de redes sinalizadas por abuso não são permitidos para este site",
 		"DATACENTER_BLOCKED": "Pedidos de endereços IP de centros de dados não são permitidos para este site",

package/src/locales/pt-BR/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Muitos envios deste endereço de e-mail",
 		"VPN_BLOCKED": "Solicitações de conexões VPN não são permitidas para este site",
 		"PROXY_BLOCKED": "Solicitações de servidores proxy não são permitidas para este site",
+		"TOO_MANY_LOCALHOST": "Muitas solicitações de CAPTCHA do localhost para esta chave de site",
 		"TOR_BLOCKED": "Solicitações de nós de saída Tor não são permitidas para este site",
 		"ABUSER_BLOCKED": "Solicitações de redes sinalizadas por abuso não são permitidas para este site",
 		"DATACENTER_BLOCKED": "Solicitações de endereços IP de datacenters não são permitidas para este site",

package/src/locales/ro/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Prea multe trimiteri de la această adresă de e-mail",
 		"VPN_BLOCKED": "Solicitările de la conexiuni VPN nu sunt permise pentru acest site",
 		"PROXY_BLOCKED": "Solicitările de la servere proxy nu sunt permise pentru acest site",
+		"TOO_MANY_LOCALHOST": "Prea multe solicitări CAPTCHA de la localhost pentru această cheie de site",
 		"TOR_BLOCKED": "Solicitările de la noduri de ieșire Tor nu sunt permise pentru acest site",
 		"ABUSER_BLOCKED": "Solicitările de la rețele semnalate pentru abuz nu sunt permise pentru acest site",
 		"DATACENTER_BLOCKED": "Solicitările de la adrese IP de centre de date nu sunt permise pentru acest site",

package/src/locales/ru/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Слишком много отправок с этого адреса электронной почты",
 		"VPN_BLOCKED": "Запросы через VPN-подключения не разрешены для этого сайта",
 		"PROXY_BLOCKED": "Запросы через прокси-серверы не разрешены для этого сайта",
+		"TOO_MANY_LOCALHOST": "Слишком много запросов CAPTCHA с localhost для этого ключа сайта",
 		"TOR_BLOCKED": "Запросы через выходные узлы Tor не разрешены для этого сайта",
 		"ABUSER_BLOCKED": "Запросы из сетей, отмеченных за злоупотребления, не разрешены для этого сайта",
 		"DATACENTER_BLOCKED": "Запросы с IP-адресов центров обработки данных не разрешены для этого сайта",

package/src/locales/sr/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Превише слања са ове адресе е-поште",
 		"VPN_BLOCKED": "Захтеви са VPN конекција нису дозвољени за овај сајт",
 		"PROXY_BLOCKED": "З��хтеви са прокси сервера нису дозвољени за овај сајт",
+		"TOO_MANY_LOCALHOST": "Превише CAPTCHA захтева са localhost-а за овај кључ сајта",
 		"TOR_BLOCKED": "Захтеви са Tor излазних чворова нису дозвољени за овај сајт",
 		"ABUSER_BLOCKED": "Захтеви са мрежа означених за злоупотребу нису дозвољени за овај сајт",
 		"DATACENTER_BLOCKED": "Захтеви са IP адреса центара података нису дозвољени за овај сајт",

package/src/locales/sv/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "För många inskickningar från denna e-postadress",
 		"VPN_BLOCKED": "Förfrågningar från VPN-anslutningar är inte tillåtna för denna webbplats",
 		"PROXY_BLOCKED": "Förfrågningar från proxyservrar är inte tillåtna för denna webbplats",
+		"TOO_MANY_LOCALHOST": "För många CAPTCHA-förfrågningar från localhost för denna webbplatsnyckel",
 		"TOR_BLOCKED": "Förfrågningar från Tor-utgångsnoder är inte tillåtna för denna webbplats",
 		"ABUSER_BLOCKED": "Förfrågningar från nätverk markerade för missbruk är inte tillåtna för denna webbplats",
 		"DATACENTER_BLOCKED": "Förfrågningar från datacenter-IP-adresser är inte tillåtna för denna webbplats",

package/src/locales/th/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "มีการส่งจากที่อยู่อีเมลนี้มากเกินไป",
 		"VPN_BLOCKED": "คำขอจากการเชื่อมต่อ VPN ไม่ได้รับอนุญาตสำหรับเว็บไซต์นี้",
 		"PROXY_BLOCKED": "คำขอจากเซิร์ฟเวอร์พร็อกซีไม่ได้รับอนุญาตสำหรับเว็บไซต์นี้",
+		"TOO_MANY_LOCALHOST": "มีคำขอ CAPTCHA จาก localhost มากเกินไปสำหรับคีย์ไซต์นี้",
 		"TOR_BLOCKED": "คำขอจากโหนดทางออก Tor ไม่ได้รับอนุญาตสำหรับเว็บไซต์นี้",
 		"ABUSER_BLOCKED": "คำขอจากเครือข่ายที่ถูกระบุว่ามีการใช้งานในทางที่ผิดไม่ได้รับอนุญาตสำหรับเว็บไซต์นี้",
 		"DATACENTER_BLOCKED": "คำขอจากที่อยู่ IP ของศูนย์ข้อมูลไม่ได้รับอนุญาตสำหรับเว็บไซต์นี้",

package/src/locales/tr/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Bu e-posta adresinden çok fazla gönderi",
 		"VPN_BLOCKED": "Bu site için VPN bağlantılarından gelen isteklere izin verilmiyor",
 		"PROXY_BLOCKED": "Bu site için proxy sunucularından gelen isteklere izin verilmiyor",
+		"TOO_MANY_LOCALHOST": "Bu site anahtarı için localhost'tan çok fazla CAPTCHA isteği",
 		"TOR_BLOCKED": "Bu site için Tor çıkış düğümlerinden gelen isteklere izin verilmiyor",
 		"ABUSER_BLOCKED": "Bu site için kötüye kullanım olarak işaretlenen ağlardan gelen isteklere izin verilmiyor",
 		"DATACENTER_BLOCKED": "Bu site için veri merkezi IP adreslerinden gelen isteklere izin verilmiyor",

package/src/locales/uk/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Забагато надсилань з цієї адреси електронної пошти",
 		"VPN_BLOCKED": "Запити з VPN-з'єднань не дозволені для цього сайту",
 		"PROXY_BLOCKED": "Запити з проксі-серверів не дозволені для цього сайту",
+		"TOO_MANY_LOCALHOST": "Забагато запитів CAPTCHA з localhost для цього ключа сайту",
 		"TOR_BLOCKED": "Запити з вихідних вузлів Tor не дозволені для цього сайту",
 		"ABUSER_BLOCKED": "Запити з мереж, позначених за зловживання, не дозволені для цього сайту",
 		"DATACENTER_BLOCKED": "Запити з IP-адрес дата-центрів не дозволені для цього сайту",

package/src/locales/vi/translation.json

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "Quá nhiều lượt gửi từ địa chỉ email này",
 		"VPN_BLOCKED": "Các yêu cầu từ kết nối VPN không được phép cho trang web này",
 		"PROXY_BLOCKED": "Các yêu cầu từ máy chủ proxy không được phép cho trang web này",
+		"TOO_MANY_LOCALHOST": "Quá nhiều yêu cầu CAPTCHA từ localhost cho khóa trang web này",
 		"TOR_BLOCKED": "Các yêu cầu từ nút thoát Tor không được phép cho trang web này",
 		"ABUSER_BLOCKED": "Các yêu cầu từ mạng bị gắn cờ lạm dụng không được phép cho trang web này",
 		"DATACENTER_BLOCKED": "Các yêu cầu từ địa chỉ IP trung tâm dữ liệu không được phép cho trang web này",

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

@@ -47,6 +47,7 @@
 		"SPAM_EMAIL_COUNT_EXCEEDED": "该电子邮件地址提交次数过多",
 		"VPN_BLOCKED": "此网站不允许来自VPN连接的请求",
 		"PROXY_BLOCKED": "此网站不允许来自代理服务器的请求",
+		"TOO_MANY_LOCALHOST": "此站点密钥来自 localhost 的 CAPTCHA 请求过多",
 		"TOR_BLOCKED": "此网站不允许来自Tor出口节点的请求",
 		"ABUSER_BLOCKED": "此网站不允许来自被标记为滥用的网络的请求",
 		"DATACENTER_BLOCKED": "此网站不允许来自数据中心IP地址的请求",

package/src/tests/i18nFrontend.unit.test.ts

@@ -96,7 +96,6 @@ const load = async (
 			return "InMemoryBackend";
 		},
 	}));
-	vi.doMock("react-i18next", () => ({ initReactI18next: "initReactI18next" }));
 
 	const imported = await import("../i18nFrontend.js");
 	return { initializeI18n: imported.default, harness };
@@ -118,7 +117,6 @@ afterEach(() => {
 		"i18next-http-backend",
 		"i18next-browser-languagedetector",
 		"i18next-resources-to-backend",
-		"react-i18next",
 	]) {
 		vi.doUnmock(module);
 	}
@@ -131,12 +129,11 @@ describe("i18nFrontend, first initialisation", () => {
 		expect(harness.initOptions).toHaveLength(1);
 	});
 
-	test("registers the chained backend, the detector and the react binding", async () => {
+	test("registers the chained backend and the language detector", async () => {
 		const { initializeI18n, harness } = await load();
 		initializeI18n();
-		expect(harness.plugins).toHaveLength(3);
+		expect(harness.plugins).toHaveLength(2);
 		expect(harness.plugins[0]).toBe("ChainedBackend");
-		expect(harness.plugins[2]).toBe("initReactI18next");
 	});
 
 	test("carries the shared options through to init", async () => {

package/src/tests/locale.test-d.ts

@@ -23,10 +23,10 @@ import {
 	type Ti18n,
 	type TranslationKey,
 	TranslationKeysSchema,
+	createTranslator,
 	i18nMiddleware,
 	isClientSide,
 	loadI18next,
-	useTranslation,
 } from "../index.js";
 
 describe("Languages", () => {
@@ -140,17 +140,20 @@ describe("i18nMiddleware", () => {
 	});
 });
 
-describe("useTranslation", () => {
-	it("is callable with no options", () => {
-		expectTypeOf(useTranslation).toBeCallableWith();
+describe("createTranslator", () => {
+	it("is callable with no instance, so a standalone widget can boot one", () => {
+		expectTypeOf(createTranslator).toBeCallableWith();
 	});
 
-	it("returns a t function", () => {
-		expectTypeOf(useTranslation).returns.toHaveProperty("t");
+	it("returns the translator surface the widgets render against", () => {
+		expectTypeOf(createTranslator).returns.toHaveProperty("t");
+		expectTypeOf(createTranslator).returns.toHaveProperty("isReady");
+		expectTypeOf(createTranslator).returns.toHaveProperty("subscribe");
+		expectTypeOf(createTranslator).returns.toHaveProperty("i18n");
 	});
 
-	it("rejects an unknown option", () => {
-		// @ts-expect-error notAnOption is not a UseTranslationOptions field
-		useTranslation({ notAnOption: 1 });
+	it("rejects anything that is not an i18next instance", () => {
+		// @ts-expect-error the only parameter is an existing i18next instance
+		createTranslator({ notAnInstance: 1 });
 	});
 });

package/src/tests/translator.unit.test.ts

@@ -0,0 +1,213 @@
+// 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 type { i18n } from "i18next";
+import { afterEach, describe, expect, test, vi } from "vitest";
+import type { Translator } from "../translator.js";
+
+// The translator is a thin wrapper: it forces the package's own i18next
+// instance in rather than letting a host app's provider decide, and exposes the
+// three events that used to drive a React re-render. i18next itself is mocked
+// so the tests observe the wiring rather than i18next's own behaviour.
+
+interface FakeI18n {
+	readonly instance: i18n;
+	readonly handlers: Map<string, Set<() => void>>;
+	isInitialized: boolean;
+	loadedNamespaces: string[];
+	translations: Record<string, string>;
+}
+
+const fakeI18n = (): FakeI18n => {
+	const handlers = new Map<string, Set<() => void>>();
+	const fake: FakeI18n = {
+		handlers,
+		isInitialized: true,
+		loadedNamespaces: ["translation"],
+		translations: {},
+		instance: {
+			t: (key: string): string => fake.translations[key] ?? key,
+			get isInitialized(): boolean {
+				return fake.isInitialized;
+			},
+			hasLoadedNamespace: (namespace: string): boolean =>
+				fake.loadedNamespaces.includes(namespace),
+			on: (event: string, listener: () => void): void => {
+				const existing = handlers.get(event) ?? new Set<() => void>();
+				existing.add(listener);
+				handlers.set(event, existing);
+			},
+			off: (event: string, listener: () => void): void => {
+				handlers.get(event)?.delete(listener);
+			},
+		} as unknown as i18n,
+	};
+	return fake;
+};
+
+const emit = (fake: FakeI18n, event: string): void => {
+	for (const listener of fake.handlers.get(event) ?? []) {
+		listener();
+	}
+};
+
+const load = async (): Promise<{
+	createTranslator: (existing?: i18n) => Translator;
+	packageInstance: i18n;
+	initCount: () => number;
+}> => {
+	vi.resetModules();
+
+	const packageInstance = fakeI18n().instance;
+	let initCalls = 0;
+
+	vi.doMock("../i18nFrontend.js", () => ({
+		default: (): i18n => {
+			initCalls += 1;
+			return packageInstance;
+		},
+	}));
+
+	const imported = await import("../translator.js");
+	return {
+		createTranslator: imported.createTranslator,
+		packageInstance,
+		initCount: (): number => initCalls,
+	};
+};
+
+afterEach(() => {
+	vi.resetModules();
+	vi.doUnmock("../i18nFrontend.js");
+});
+
+describe("which i18next instance the translator talks to", () => {
+	test("initialises the package's own instance when given none", async () => {
+		// Without this, a host application running its own i18next would capture
+		// the widget's translations and render its keys instead.
+		const { createTranslator, packageInstance, initCount } = await load();
+
+		const translator = createTranslator();
+
+		expect(translator.i18n).toBe(packageInstance);
+		expect(initCount()).toBe(1);
+	});
+
+	test("adopts an instance the caller already has", async () => {
+		// The bundle loads i18next once and hands the same instance to every
+		// widget on the page, so a second init would be wasted work.
+		const { createTranslator, initCount } = await load();
+		const existing = fakeI18n().instance;
+
+		const translator = createTranslator(existing);
+
+		expect(translator.i18n).toBe(existing);
+		expect(initCount()).toBe(0);
+	});
+});
+
+describe("translating", () => {
+	test("delegates to the instance", async () => {
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+		fake.translations = { "WIDGET.SUBMIT": "Submit" };
+
+		expect(createTranslator(fake.instance).t("WIDGET.SUBMIT")).toBe("Submit");
+	});
+
+	test("reads the instance at call time, not at creation time", async () => {
+		// A language switch mutates the instance in place; a translator that
+		// cached `t` would keep serving the previous language.
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+		const translator = createTranslator(fake.instance);
+
+		fake.translations = { "WIDGET.SUBMIT": "Envoyer" };
+
+		expect(translator.t("WIDGET.SUBMIT")).toBe("Envoyer");
+	});
+});
+
+describe("readiness", () => {
+	test("is ready once the instance has loaded the translation namespace", async () => {
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+
+		expect(createTranslator(fake.instance).isReady()).toBe(true);
+	});
+
+	test("is not ready before initialisation", async () => {
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+		fake.isInitialized = false;
+
+		expect(createTranslator(fake.instance).isReady()).toBe(false);
+	});
+
+	test("is not ready while the namespace is still loading", async () => {
+		// Widgets render an empty label until this flips, rather than flashing a
+		// raw translation key at the user.
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+		fake.loadedNamespaces = [];
+
+		expect(createTranslator(fake.instance).isReady()).toBe(false);
+	});
+});
+
+describe("subscribing", () => {
+	test.each(["initialized", "loaded", "languageChanged"])(
+		"notifies the listener on %s",
+		async (event: string) => {
+			const { createTranslator } = await load();
+			const fake = fakeI18n();
+			const listener = vi.fn<() => void>();
+
+			createTranslator(fake.instance).subscribe(listener);
+			emit(fake, event);
+
+			expect(listener).toHaveBeenCalledTimes(1);
+		},
+	);
+
+	test("stops notifying once unsubscribed", async () => {
+		// Widgets unsubscribe on destroy; a leaked listener would keep a torn-down
+		// widget alive for the lifetime of the page.
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+		const listener = vi.fn<() => void>();
+
+		const unsubscribe = createTranslator(fake.instance).subscribe(listener);
+		unsubscribe();
+		emit(fake, "languageChanged");
+
+		expect(listener).not.toHaveBeenCalled();
+	});
+
+	test("keeps independent subscriptions apart", async () => {
+		const { createTranslator } = await load();
+		const fake = fakeI18n();
+		const first = vi.fn<() => void>();
+		const second = vi.fn<() => void>();
+		const translator = createTranslator(fake.instance);
+
+		const unsubscribeFirst = translator.subscribe(first);
+		translator.subscribe(second);
+		unsubscribeFirst();
+		emit(fake, "loaded");
+
+		expect(first).not.toHaveBeenCalled();
+		expect(second).toHaveBeenCalledTimes(1);
+	});
+});

package/src/translator.ts

@@ -0,0 +1,69 @@
+// 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 type { TOptions } from "i18next";
+import initializeI18n from "./i18nFrontend.js";
+import type { Ti18n } from "./loadI18next.js";
+
+const NAMESPACE = "translation";
+
+export interface Translator {
+	/**
+	 * Translate a key against the current language. `options` carries
+	 * interpolation values and the `defaultValue` a widget falls back to when
+	 * its key has not been added to the bundled catalogues yet.
+	 */
+	t(key: string, options?: TOptions): string;
+	/**
+	 * Whether the namespace for the active language has finished loading.
+	 * Mirrors `ready` from the old react-i18next hook: widgets render an empty
+	 * label until it flips, rather than flashing a raw translation key.
+	 */
+	isReady(): boolean;
+	/**
+	 * Notified when the translation output could have changed — initialisation,
+	 * a namespace load, or a language switch. Returns an unsubscribe function.
+	 */
+	subscribe(listener: () => void): () => void;
+	readonly i18n: Ti18n;
+}
+
+/**
+ * Vanilla replacement for the `useTranslation` hook. i18next is already
+ * framework-agnostic and event-driven; this just exposes its `t` plus the three
+ * events that used to trigger a React re-render.
+ */
+export const createTranslator = (existing?: Ti18n): Translator => {
+	const i18n: Ti18n = existing ?? initializeI18n();
+
+	const isReady = (): boolean =>
+		i18n.isInitialized && i18n.hasLoadedNamespace(NAMESPACE);
+
+	return {
+		t: (key: string, options?: TOptions): string => i18n.t(key, options),
+		isReady,
+		i18n,
+		subscribe: (listener: () => void): (() => void) => {
+			const events = ["initialized", "loaded", "languageChanged"] as const;
+			for (const event of events) {
+				i18n.on(event, listener);
+			}
+			return () => {
+				for (const event of events) {
+					i18n.off(event, listener);
+				}
+			};
+		},
+	};
+};