Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

refactor(docs-ui): drop DocsI18n.tsx, unify locale handling via next-intl

diegosouzapw7b97b01fe63f
diff --git a/src/app/docs/components/DocsI18n.tsx b/src/app/docs/components/DocsI18n.tsx
deleted file mode 100644
index 49a76a01f7..0000000000
--- a/src/app/docs/components/DocsI18n.tsx
+++ /dev/null
@@ -1,200 +0,0 @@
-"use client";
-
-import { useMemo, useState } from "react";
-import { useSearchParams, useRouter, usePathname } from "next/navigation";
-
-type Locale = "en" | "pt-BR" | "es" | "fr" | "de" | "ja" | "zh-CN" | "ko" | "ru" | "ar";
-
-const SECTION_LABELS: Record<Locale, Record<string, string>> = {
- en: {
- "Getting Started": "Getting Started",
- Features: "Features",
- "API & Protocols": "API & Protocols",
- Deployment: "Deployment",
- Operations: "Operations",
- Development: "Development",
- },
- "pt-BR": {
- "Getting Started": "Primeiros Passos",
- Features: "Recursos",
- "API & Protocols": "API & Protocolos",
- Deployment: "Implantação",
- Operations: "Operações",
- Development: "Desenvolvimento",
- },
- es: {
- "Getting Started": "Primeros Pasos",
- Features: "Características",
- "API & Protocols": "API y Protocolos",
- Deployment: "Despliegue",
- Operations: "Operaciones",
- Development: "Desarrollo",
- },
- fr: {
- "Getting Started": "Démarrage",
- Features: "Fonctionnalités",
- "API & Protocols": "API et Protocoles",
- Deployment: "Déploiement",
- Operations: "Opérations",
- Development: "Développement",
- },
- de: {
- "Getting Started": "Erste Schritte",
- Features: "Funktionen",
- "API & Protocols": "API & Protokolle",
- Deployment: "Bereitstellung",
- Operations: "Betrieb",
- Development: "Entwicklung",
- },
- ja: {
- "Getting Started": "はじめに",
- Features: "機能",
- "API & Protocols": "APIとプロトコル",
- Deployment: "デプロイ",
- Operations: "運用",
- Development: "開発",
- },
- "zh-CN": {
- "Getting Started": "快速开始",
- Features: "功能",
- "API & Protocols": "API与协议",
- Deployment: "部署",
- Operations: "运维",
- Development: "开发",
- },
- ko: {
- "Getting Started": "시작하기",
- Features: "기능",
- "API & Protocols": "API 및 프로토콜",
- Deployment: "배포",
- Operations: "운영",
- Development: "개발",
- },
- ru: {
- "Getting Started": "Начало работы",
- Features: "Возможности",
- "API & Protocols": "API и Протоколы",
- Deployment: "Развертывание",
- Operations: "Эксплуатация",
- Development: "Разработка",
- },
- ar: {
- "Getting Started": "البدء",
- Features: "الميزات",
- "API & Protocols": "API والبروتوكولات",
- Deployment: "النشر",
- Operations: "العمليات",
- Development: "التطوير",
- },
-};
-
-function detectLocale(): Locale {
- if (typeof navigator === "undefined") return "en";
- const lang = navigator.language;
- if (lang.startsWith("pt-BR")) return "pt-BR";
- if (lang.startsWith("es")) return "es";
- if (lang.startsWith("fr")) return "fr";
- if (lang.startsWith("de")) return "de";
- if (lang.startsWith("ja")) return "ja";
- if (lang.startsWith("zh")) return "zh-CN";
- if (lang.startsWith("ko")) return "ko";
- if (lang.startsWith("ru")) return "ru";
- if (lang.startsWith("ar")) return "ar";
- return "en";
-}
-
-export function useDocsLocale() {
- const searchParams = useSearchParams();
- return useMemo<Locale>(() => {
- const langParam = searchParams.get("lang");
- if (langParam && langParam in SECTION_LABELS) return langParam as Locale;
- return detectLocale();
- }, [searchParams]);
-}
-
-export function useLocalizedSectionTitle(englishTitle: string): string {
- const locale = useDocsLocale();
- return SECTION_LABELS[locale]?.[englishTitle] ?? englishTitle;
-}
-
-export function getAvailableLocales(): Locale[] {
- return Object.keys(SECTION_LABELS) as Locale[];
-}
-
-export const LOCALE_NAMES: Record<Locale, string> = {
- en: "English",
- "pt-BR": "Português (Brasil)",
- es: "Español",
- fr: "Français",
- de: "Deutsch",
- ja: "日本語",
- "zh-CN": "简体中文",
- ko: "한국어",
- ru: "Русский",
- ar: "العربية",
-};
-
-const COMMON_LOCALES: Locale[] = ["en", "pt-BR", "es", "fr", "de", "ja", "zh-CN", "ko", "ru", "ar"];
-
-export function DocsLocaleSwitcher() {
- const searchParams = useSearchParams();
- const router = useRouter();
- const pathname = usePathname();
- const [isOpen, setIsOpen] = useState(false);
- const currentLocale = useMemo<Locale>(() => {
- const langParam = searchParams.get("lang");
- if (langParam && langParam in SECTION_LABELS) return langParam as Locale;
- if (typeof navigator !== "undefined") {
- const navLocale = detectLocale();
- if (navLocale in SECTION_LABELS) return navLocale;
- }
- return "en";
- }, [searchParams]);
-
- const handleLocaleChange = (locale: Locale) => {
- setIsOpen(false);
- const params = new URLSearchParams(searchParams.toString());
- if (locale === "en") {
- params.delete("lang");
- } else {
- params.set("lang", locale);
- }
- const queryString = params.toString();
- router.push(`${pathname}${queryString ? `?${queryString}` : ""}`);
- };
-
- return (
- <div className="relative">
- <button
- onClick={() => setIsOpen(!isOpen)}
- className="flex items-center gap-1 px-2 py-1 text-xs border border-border rounded hover:border-primary/50 transition-colors text-text-muted hover:text-text-main"
- aria-label="Change documentation language"
- aria-expanded={isOpen}
- aria-haspopup="listbox"
- >
- <span className="material-symbols-outlined text-sm">language</span>
- {LOCALE_NAMES[currentLocale]}
- </button>
- {isOpen && (
- <div
- className="absolute right-0 top-full mt-1 bg-bg border border-border rounded-lg shadow-lg z-50 py-1 min-w-[160px]"
- role="listbox"
- >
- {COMMON_LOCALES.map((locale) => (
- <button
- key={locale}
- onClick={() => handleLocaleChange(locale)}
- className={`w-full text-left px-3 py-1.5 text-sm hover:bg-primary/5 transition-colors ${
- locale === currentLocale ? "text-primary font-semibold" : "text-text-muted"
- }`}
- role="option"
- aria-selected={locale === currentLocale}
- >
- {LOCALE_NAMES[locale]}
- </button>
- ))}
- </div>
- )}
- </div>
- );
-}
diff --git a/src/app/docs/layout.tsx b/src/app/docs/layout.tsx
index 4890d479c4..fbab0e946a 100644
--- a/src/app/docs/layout.tsx
+++ b/src/app/docs/layout.tsx
@@ -1,7 +1,7 @@
import Link from "next/link";
import { ReactNode, Suspense } from "react";
import { DocsSidebarClient } from "./components/DocsSidebarClient";
-import { DocsLocaleSwitcher } from "./components/DocsI18n";
+import LanguageSelector from "@/shared/components/LanguageSelector";
export const metadata = {
title: {
@@ -56,7 +56,7 @@ export default function DocsLayout({ children }: { children: ReactNode }) {
</Link>
</div>
<Suspense fallback={<div className="w-24 h-8" />}>
- <DocsLocaleSwitcher />
+ <LanguageSelector />
</Suspense>
</nav>
diff --git a/tests/unit/docs-site-overhaul.test.ts b/tests/unit/docs-site-overhaul.test.ts
index e2f25d3e20..584c828268 100644
--- a/tests/unit/docs-site-overhaul.test.ts
+++ b/tests/unit/docs-site-overhaul.test.ts
@@ -314,23 +314,31 @@ test("WhatsNewSection is importable", async () => {
});
// ──────────────────────────────────────────────
-// i18n locale system
+// i18n locale system (next-intl + config/i18n.json)
// ──────────────────────────────────────────────
-test("DocsI18n is importable", async () => {
- const mod = await import("../../src/app/docs/components/DocsI18n");
- assert.ok(mod.useLocalizedSectionTitle, "useLocalizedSectionTitle should be exported");
- assert.ok(mod.getAvailableLocales, "getAvailableLocales should be exported");
- assert.ok(mod.LOCALE_NAMES, "LOCALE_NAMES should be exported");
- assert.equal(mod.LOCALE_NAMES.en, "English");
- assert.equal(mod.LOCALE_NAMES["zh-CN"], "简体中文");
-});
-
-test("getAvailableLocales returns 10 locales", async () => {
- const { getAvailableLocales } = await import("../../src/app/docs/components/DocsI18n");
- const locales = getAvailableLocales();
- assert.equal(locales.length, 10);
- assert.ok(locales.includes("en"));
- assert.ok(locales.includes("pt-BR"));
- assert.ok(locales.includes("zh-CN"));
+test("docs locale handling uses the shared next-intl config", async () => {
+ const cfg = await import("../../src/i18n/config");
+ assert.ok(Array.isArray(cfg.LANGUAGES), "LANGUAGES should be exported");
+ assert.ok(cfg.LANGUAGES.length >= 10, "LANGUAGES should cover all configured locales");
+ const codes = cfg.LANGUAGES.map((l) => l.code);
+ assert.ok(codes.includes("en"));
+ assert.ok(codes.includes("pt-BR"));
+ assert.ok(codes.includes("zh-CN"));
+ const en = cfg.LANGUAGES.find((l) => l.code === "en");
+ const zh = cfg.LANGUAGES.find((l) => l.code === "zh-CN");
+ assert.equal(en?.english, "English");
+ assert.equal(zh?.native, "中文 (简体)");
+});
+
+test("docs language selector reuses the global LanguageSelector component", async () => {
+ const selector = await import("../../src/shared/components/LanguageSelector");
+ assert.ok(selector.default, "LanguageSelector default export should exist");
+});
+
+test("DocsI18n shim is no longer present (replaced by next-intl)", async () => {
+ await assert.rejects(
+ async () => import("../../src/app/docs/components/DocsI18n"),
+ "DocsI18n.tsx should be removed; docs UI uses next-intl directly"
+ );
});