= { in: "id", iw: "he", ji: "yi", no: "nb", tl: "fil" };
+function canonical(locale: string): string[] {
try {
- return Intl.getCanonicalLocales(locale)[0];
+ const tag = Intl.getCanonicalLocales(locale.replaceAll("_", "-"))[0] ?? "";
+ const singleton = tag.search(/-[a-zA-Z0-9]-/);
+ return (singleton < 0 ? tag : tag.slice(0, singleton)).split("-");
} catch {
- return undefined;
+ return [];
}
}
-/** The closest shipped catalog for a BCP 47 tag, else the base locale. */
+/**
+ * The closest shipped catalog for a BCP 47 tag, else the base locale. Legacy codes map to their
+ * successors, Chinese infers its script from the region, and Portuguese outside Brazil reads pt-PT.
+ */
export function messages(locale?: string): Messages {
- let tag = locale ? canonical(locale) : undefined;
- while (tag) {
- if (tag in catalogs) return catalogs[tag as keyof typeof catalogs];
- tag = tag.includes("-") ? tag.slice(0, tag.lastIndexOf("-")) : undefined;
+ const [first, ...subtags] = locale ? canonical(locale) : [];
+ if (first) {
+ const language = aliases[first] ?? first;
+ const region = subtags.find((subtag) => /^([A-Z]{2}|[0-9]{3})$/.test(subtag));
+ const script =
+ subtags.find((subtag) => /^[A-Z][a-z]{3}$/.test(subtag)) ??
+ (language === "zh" ? (region && ["HK", "MO", "TW"].includes(region) ? "Hant" : "Hans") : undefined);
+ const candidates = [
+ [language, script, region],
+ [language, script],
+ [language, region],
+ [language],
+ [language, language === "pt" ? (region === undefined ? "BR" : "PT") : undefined],
+ ];
+ for (const parts of candidates) {
+ if (parts.includes(undefined)) continue;
+ const tag = parts.join("-");
+ if (tag in catalogs) return catalogs[tag as keyof typeof catalogs];
+ }
}
return catalogs["en"];
}
diff --git a/packages/react/src/widget/respondkit-widget.test.tsx b/packages/react/src/widget/respondkit-widget.test.tsx
index b9e4315..b0eef11 100644
--- a/packages/react/src/widget/respondkit-widget.test.tsx
+++ b/packages/react/src/widget/respondkit-widget.test.tsx
@@ -1,5 +1,8 @@
import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { act } from "react";
import { createPortal } from "react-dom";
+import { hydrateRoot } from "react-dom/client";
+import { renderToString } from "react-dom/server";
import userEvent from "@testing-library/user-event";
import { afterEach, describe, expect, it, vi } from "vite-plus/test";
@@ -395,6 +398,81 @@ describe("RespondKitWidget", () => {
expect(screen.queryByLabelText("Loading messages")).not.toBeInTheDocument();
});
+ it.each([
+ [
+ "ja-JP",
+ "何でもお気軽にどうぞ",
+ "どのようなご用件ですか?",
+ "メッセージを送信して、このページを開いたままお待ちください。すぐにお返事します。",
+ "ファイルを添付",
+ ],
+ [
+ "zh-Hans-CN",
+ "有问题尽管问",
+ "有什么可以帮您?",
+ "发送消息后请保持此页面打开,以便及时收到回复。",
+ "添加附件",
+ ],
+ ])("renders the %s empty state, subtitle and attach control", async (locale, ...expected) => {
+ const [subtitle, help, intro, attach] = expected;
+ const { apiFetch, resolveTranscript } = createDelayedEmptyTranscriptApiFetch();
+ vi.stubGlobal("fetch", apiFetch);
+ render(
+ ,
+ );
+ resolveTranscript();
+ expect(await screen.findByText(help!)).toBeVisible();
+ expect(screen.getByText(subtitle!)).toBeVisible();
+ expect(screen.getByText(intro!)).toBeVisible();
+ expect(screen.getByRole("button", { name: attach })).toBeInTheDocument();
+ });
+
+ it("falls back to the browser language when the host sends no locale", async () => {
+ const language = vi.spyOn(navigator, "language", "get").mockReturnValue("ja");
+ const { apiFetch, resolveTranscript } = createDelayedEmptyTranscriptApiFetch();
+ vi.stubGlobal("fetch", apiFetch);
+ render(
+ ,
+ );
+ resolveTranscript();
+ expect(await screen.findByText("どのようなご用件ですか?")).toBeVisible();
+ expect(screen.getByText("何でもお気軽にどうぞ")).toBeVisible();
+ language.mockRestore();
+ });
+
+ it("hydrates server markup without a locale before switching to the browser language", async () => {
+ const { apiFetch, resolveTranscript } = createDelayedEmptyTranscriptApiFetch();
+ vi.stubGlobal("fetch", apiFetch);
+ const widget = (
+
+ );
+ const container = document.createElement("div");
+ container.innerHTML = renderToString(widget);
+ document.body.append(container);
+ expect(container.textContent).toContain("Ask us anything");
+ const language = vi.spyOn(navigator, "language", "get").mockReturnValue("ja");
+ const onRecoverableError = vi.fn();
+ const root = await act(async () => hydrateRoot(container, widget, { onRecoverableError }));
+ resolveTranscript();
+ await waitFor(() => expect(container.textContent).toContain("何でもお気軽にどうぞ"));
+ expect(onRecoverableError).not.toHaveBeenCalled();
+ act(() => root.unmount());
+ container.remove();
+ language.mockRestore();
+ });
+
it.each(["interval", "reopen", "visibility"])(
"keeps an empty transcript visible during a pending %s refresh",
async (trigger) => {
diff --git a/packages/react/src/widget/respondkit-widget.tsx b/packages/react/src/widget/respondkit-widget.tsx
index 8f49696..e793cc8 100644
--- a/packages/react/src/widget/respondkit-widget.tsx
+++ b/packages/react/src/widget/respondkit-widget.tsx
@@ -4,6 +4,7 @@ import {
useId,
useRef,
useState,
+ useSyncExternalStore,
type ComponentPropsWithRef,
type ReactNode,
type CSSProperties,
@@ -47,6 +48,11 @@ export interface RespondKitWidgetProps {
readonly accentColor?: RespondKitAccentColor | undefined;
}
+function subscribeToLanguage(onChange: () => void) {
+ window.addEventListener("languagechange", onChange);
+ return () => window.removeEventListener("languagechange", onChange);
+}
+
export function RespondKitWidget({
apiBaseUrl,
context,
@@ -112,6 +118,12 @@ export function RespondKitWidget({
setOpen(true);
}
+ const browserLocale = useSyncExternalStore(
+ subscribeToLanguage,
+ () => navigator.language,
+ () => undefined,
+ );
+ const locale = context.locale ?? browserLocale;
const hasUnreadReplies = unreadThreadIds.size > 0;
const buttonProps: ComponentPropsWithRef<"button"> = {
ref: launcherRef,
@@ -154,7 +166,7 @@ export function RespondKitWidget({
{title}
- {catalog(context.locale).respondkit_ask_anything()}
+ {catalog(locale).respondkit_ask_anything()}
@@ -224,7 +236,7 @@ export function RespondKitWidget({
) : null}
) : null}