mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
Add complete i18n infrastructure with 21 supported languages: English, Simplified Chinese, Traditional Chinese, Japanese, Korean, Spanish, French, Italian, Brazilian Portuguese, German, Dutch, Swedish, Russian, Polish, Ukrainian, Arabic (RTL), Turkish, Hindi, Vietnamese, Indonesian, and Thai. - I18nProvider context with three-tier locale detection (user preference > navigator.languages > instance default > English) - ~1500 translation keys per locale with TypeScript-enforced completeness - Dynamic code-splitting: only the active locale is loaded at runtime - Language selectors in footer, login page, settings, and mobile sidebar - Arabic RTL support with CSS logical properties across all components - Tool names, descriptions, and categories translated via i18n helpers - Public API endpoint GET /api/v1/config/locale for instance default - Multi-script font stack (CJK, Arabic, Devanagari, Thai, Cyrillic) - format() and plural() helpers for interpolation and pluralization - API error translation mapping (translateApiError) - 36 Playwright e2e tests verifying all 21 locales load correctly - 25 unit tests for format, plural, locale detection, and completeness - Updated translations.md docs and CLAUDE.md conventions
214 lines
8.0 KiB
TypeScript
214 lines
8.0 KiB
TypeScript
import { expect, test } from "@playwright/test";
|
|
|
|
const API = process.env.API_URL || "http://localhost:13490";
|
|
|
|
const LOCALES = [
|
|
{ code: "en", native: "English", dir: "ltr", sample: "Upload from computer" },
|
|
{ code: "de", native: "Deutsch", dir: "ltr", sample: "Vom Computer hochladen" },
|
|
{ code: "fr", native: "Français", dir: "ltr", sample: "Importer depuis" },
|
|
{ code: "es", native: "Español", dir: "ltr", sample: "Subir desde" },
|
|
{ code: "ja", native: "日本語", dir: "ltr", sample: "アップロード" },
|
|
{ code: "ko", native: "한국어", dir: "ltr", sample: "업로드" },
|
|
{ code: "zh-CN", native: "简体中文", dir: "ltr", sample: "上传" },
|
|
{ code: "zh-TW", native: "繁體中文", dir: "ltr", sample: "上傳" },
|
|
{ code: "ru", native: "Русский", dir: "ltr", sample: "Загрузить" },
|
|
{ code: "ar", native: "العربية", dir: "rtl", sample: "رفع" },
|
|
{ code: "pt-BR", native: "Português (Brasil)", dir: "ltr", sample: "Enviar do computador" },
|
|
{ code: "it", native: "Italiano", dir: "ltr", sample: "Carica dal computer" },
|
|
{ code: "nl", native: "Nederlands", dir: "ltr", sample: "Upload van computer" },
|
|
{ code: "sv", native: "Svenska", dir: "ltr", sample: "Ladda upp" },
|
|
{ code: "pl", native: "Polski", dir: "ltr", sample: "Prześlij" },
|
|
{ code: "uk", native: "Українська", dir: "ltr", sample: "Завантажити" },
|
|
{ code: "tr", native: "Türkçe", dir: "ltr", sample: "Bilgisayardan" },
|
|
{ code: "hi", native: "हिन्दी", dir: "ltr", sample: "अपलोड" },
|
|
{ code: "vi", native: "Tiếng Việt", dir: "ltr", sample: "Tải lên" },
|
|
{ code: "id", native: "Bahasa Indonesia", dir: "ltr", sample: "Unggah" },
|
|
{ code: "th", native: "ไทย", dir: "ltr", sample: "อัปโหลด" },
|
|
];
|
|
|
|
test.describe("i18n - API", () => {
|
|
test("GET /api/v1/config/locale returns default locale without auth", async ({ request }) => {
|
|
const res = await request.get(`${API}/api/v1/config/locale`);
|
|
expect(res.ok()).toBe(true);
|
|
const data = await res.json();
|
|
expect(data.defaultLocale).toBe("en");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - locale detection", () => {
|
|
test("defaults to English when no preference is set", async ({ page }) => {
|
|
await page.goto("/");
|
|
const lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe("en");
|
|
});
|
|
|
|
test("document.dir is set to ltr after mount", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.waitForTimeout(500);
|
|
const dir = await page.getAttribute("html", "dir");
|
|
expect(dir).toBe("ltr");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - footer language selector", () => {
|
|
test("footer shows Globe button with current language name", async ({ page }) => {
|
|
await page.goto("/");
|
|
const footer = page.locator("text=English").last();
|
|
await expect(footer).toBeVisible();
|
|
});
|
|
|
|
test("clicking Globe opens language dropdown with all 21 languages", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.locator("button", { hasText: "English" }).last().click();
|
|
await page.waitForTimeout(300);
|
|
|
|
const dropdown = page.locator("[class*='overflow-y-auto']").last();
|
|
await expect(dropdown).toBeVisible();
|
|
|
|
for (const locale of LOCALES) {
|
|
const option = dropdown.locator("button", { hasText: locale.native });
|
|
await expect(option).toBeVisible();
|
|
}
|
|
});
|
|
|
|
test("selecting a language updates the UI", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.locator("button", { hasText: "English" }).last().click();
|
|
await page.waitForTimeout(300);
|
|
await page.locator("button", { hasText: "Deutsch" }).click();
|
|
await page.waitForTimeout(500);
|
|
|
|
const lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe("de");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - locale persistence", () => {
|
|
test("selected locale persists in localStorage", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.locator("button", { hasText: "English" }).last().click();
|
|
await page.waitForTimeout(300);
|
|
await page.locator("button", { hasText: "Français" }).click();
|
|
await page.waitForTimeout(500);
|
|
|
|
const stored = await page.evaluate(() => localStorage.getItem("snapotter-locale"));
|
|
expect(stored).toBe("fr");
|
|
});
|
|
|
|
test("locale persists across page refresh", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.locator("button", { hasText: "English" }).last().click();
|
|
await page.waitForTimeout(300);
|
|
await page.locator("button", { hasText: "Español" }).click();
|
|
await page.waitForTimeout(500);
|
|
|
|
await page.reload();
|
|
await page.waitForTimeout(1000);
|
|
|
|
const lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe("es");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - Arabic RTL", () => {
|
|
test("switching to Arabic sets dir=rtl", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.locator("button", { hasText: "English" }).last().click();
|
|
await page.waitForTimeout(300);
|
|
await page.locator("button", { hasText: "العربية" }).click();
|
|
await page.waitForTimeout(500);
|
|
|
|
const dir = await page.getAttribute("html", "dir");
|
|
expect(dir).toBe("rtl");
|
|
|
|
const lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe("ar");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - login page", () => {
|
|
test("login page has language selector", async ({ page }) => {
|
|
await page.goto("/login");
|
|
const langSelector = page.locator("button", { hasText: "English" }).first();
|
|
await expect(langSelector).toBeVisible();
|
|
});
|
|
|
|
test("switching language on login page translates form labels", async ({ page }) => {
|
|
await page.goto("/login");
|
|
await page.locator("button", { hasText: "English" }).first().click();
|
|
await page.waitForTimeout(300);
|
|
await page.locator("button", { hasText: "Deutsch" }).click();
|
|
await page.waitForTimeout(500);
|
|
|
|
const loginHeading = page.locator("h2").first();
|
|
await expect(loginHeading).toContainText("Anmelden");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - all locales load", () => {
|
|
for (const locale of LOCALES) {
|
|
test(`${locale.code} (${locale.native}) loads and shows translated content`, async ({
|
|
page,
|
|
}) => {
|
|
await page.goto("/");
|
|
await page.evaluate((code) => localStorage.setItem("snapotter-locale", code), locale.code);
|
|
await page.reload();
|
|
await page.waitForTimeout(1000);
|
|
|
|
const lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe(locale.code);
|
|
|
|
const dir = await page.getAttribute("html", "dir");
|
|
expect(dir).toBe(locale.dir);
|
|
|
|
const body = await page.textContent("body");
|
|
expect(body).toContain(locale.sample);
|
|
});
|
|
}
|
|
});
|
|
|
|
test.describe("i18n - tool names translate", () => {
|
|
test("tool names and categories show in selected language", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.evaluate(() => localStorage.setItem("snapotter-locale", "de"));
|
|
await page.reload();
|
|
await page.waitForTimeout(1500);
|
|
|
|
const body = await page.textContent("body");
|
|
expect(body).toContain("Grundlagen");
|
|
expect(body).toContain("Komprimieren");
|
|
});
|
|
|
|
test("tool names show in Japanese", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.evaluate(() => localStorage.setItem("snapotter-locale", "ja"));
|
|
await page.reload();
|
|
await page.waitForTimeout(1500);
|
|
|
|
const body = await page.textContent("body");
|
|
expect(body).toContain("リサイズ");
|
|
});
|
|
});
|
|
|
|
test.describe("i18n - switching back to English", () => {
|
|
test("can switch back to English after using another language", async ({ page }) => {
|
|
await page.goto("/");
|
|
await page.evaluate(() => localStorage.setItem("snapotter-locale", "de"));
|
|
await page.reload();
|
|
await page.waitForTimeout(1000);
|
|
|
|
let lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe("de");
|
|
|
|
await page.evaluate(() => localStorage.setItem("snapotter-locale", "en"));
|
|
await page.reload();
|
|
await page.waitForTimeout(1000);
|
|
|
|
lang = await page.getAttribute("html", "lang");
|
|
expect(lang).toBe("en");
|
|
|
|
const body = await page.textContent("body");
|
|
expect(body).toContain("Upload from computer");
|
|
});
|
|
});
|