🌐 Add Spanish translations to i18n implementation

AndreMiras · AndreMiras · commit 671bc9f035b1 · 2025-10-18T00:21:07.000Z
Add Spanish (es) as a third supported language alongside English and French.
This completes the internationalization support with a scalable dropdown
language switcher.

Changes:
- Create 9 Spanish translation JSON files in public/locales/es/
- Update i18n.ts to import and register Spanish resources
- Update next-i18next.config.js to include 'es' in locales array
- Update LanguageSwitcher to include Spanish in dropdown
- Update LanguageInitializer to validate Spanish locale
- Add Spanish language entry to English and French header translations

All translations maintain technical accuracy while providing natural Spanish
equivalents. Variable interpolation ({{mac}}) and Unicode escape sequences
(Copyleft symbol) are preserved.
diff --git a/next-i18next.config.js b/next-i18next.config.js
@@ -1,7 +1,7 @@
 module.exports = {
   i18n: {
     defaultLocale: 'en',
-    locales: ['en', 'fr'],
+    locales: ['en', 'fr', 'es'],
   },
   localePath: typeof window === 'undefined' ? require('path').resolve('./public/locales') : '/locales',
   reloadOnPrerender: process.env.NODE_ENV === 'development',
diff --git a/public/locales/en/header.json b/public/locales/en/header.json
@@ -3,7 +3,8 @@
   "languageSwitcher": {
     "languages": {
       "en": "English",
-      "fr": "Français"
+      "fr": "Français",
+      "es": "Español"
     }
   }
 }
diff --git a/public/locales/es/common.json b/public/locales/es/common.json
@@ -0,0 +1,3 @@
+{
+  "appTitle": "Open Edilkamin"
+}
diff --git a/public/locales/es/error.json b/public/locales/es/error.json
@@ -0,0 +1,3 @@
+{
+  "defaultTitle": "Error"
+}
diff --git a/public/locales/es/fireplace.json b/public/locales/es/fireplace.json
@@ -0,0 +1,14 @@
+{
+  "title": "Chimenea: {{mac}}",
+  "advanced": "Avanzado",
+  "debug": "Depuración",
+  "errors": {
+    "deviceNotFound": "Dispositivo no encontrado",
+    "deviceNotFoundBody": "La dirección proporcionada (\"{{mac}}\") no es válida o el dispositivo no está registrado.",
+    "couldntFetchInfo": "No se pudo obtener la información del dispositivo.",
+    "powerUpdateFailed": "Error al actualizar el estado de encendido",
+    "powerUpdateBody": "No se pudo cambiar el estado de encendido. Por favor, inténtelo de nuevo.",
+    "temperatureUpdateFailed": "Error al actualizar la temperatura",
+    "temperatureUpdateBody": "No se pudo actualizar la temperatura. Por favor, inténtelo de nuevo."
+  }
+}
diff --git a/public/locales/es/footer.json b/public/locales/es/footer.json
@@ -0,0 +1,3 @@
+{
+  "text": "Copyleft \uD83C\uDD2F Andre Miras 2022 - Open Edilkamin v"
+}
diff --git a/public/locales/es/header.json b/public/locales/es/header.json
@@ -0,0 +1,10 @@
+{
+  "about": "Acerca de",
+  "languageSwitcher": {
+    "languages": {
+      "en": "English",
+      "fr": "Français",
+      "es": "Español"
+    }
+  }
+}
diff --git a/public/locales/es/home.json b/public/locales/es/home.json
@@ -0,0 +1,9 @@
+{
+  "title": "Chimeneas",
+  "emptyState": "No hay chimeneas registradas, agregue una a continuación",
+  "macPlaceholder": "aabbccddeeff",
+  "validation": {
+    "invalidMac": "Dirección MAC no válida.",
+    "alreadyAdded": "Dispositivo ya agregado."
+  }
+}
diff --git a/public/locales/es/login.json b/public/locales/es/login.json
@@ -0,0 +1,11 @@
+{
+  "usernamePlaceholder": "Nombre de usuario",
+  "emailAriaLabel": "Correo electrónico",
+  "passwordPlaceholder": "Contraseña",
+  "passwordAriaLabel": "Contraseña",
+  "button": "Iniciar sesión",
+  "errors": {
+    "couldntLogin": "No se pudo iniciar sesión",
+    "unknownError": "Error de inicio de sesión desconocido"
+  }
+}
diff --git a/public/locales/es/logout.json b/public/locales/es/logout.json
@@ -0,0 +1,3 @@
+{
+  "button": "Cerrar sesión"
+}
diff --git a/public/locales/es/power.json b/public/locales/es/power.json
@@ -0,0 +1,4 @@
+{
+  "on": "Encendido",
+  "off": "Apagado"
+}
diff --git a/public/locales/fr/header.json b/public/locales/fr/header.json
@@ -3,7 +3,8 @@
   "languageSwitcher": {
     "languages": {
       "en": "English",
-      "fr": "Français"
+      "fr": "Français",
+      "es": "Español"
     }
   }
 }
diff --git a/src/components/LanguageInitializer.tsx b/src/components/LanguageInitializer.tsx
@@ -8,7 +8,8 @@ const LanguageInitializer = () => {
 
   useEffect(() => {
     const savedLocale = localStorage.getItem(LOCALE_STORAGE_KEY);
-    if (savedLocale && (savedLocale === "en" || savedLocale === "fr")) {
+    const validLocales = ["en", "fr", "es"];
+    if (savedLocale && validLocales.includes(savedLocale)) {
       i18n.changeLanguage(savedLocale);
     }
   }, [i18n]);
diff --git a/src/components/LanguageSwitcher.tsx b/src/components/LanguageSwitcher.tsx
@@ -6,7 +6,7 @@ const LOCALE_STORAGE_KEY = "edilkamin-locale";
 const LanguageSwitcher = () => {
   const { t, i18n } = useTranslation("header");
 
-  const languages = ["en", "fr"];
+  const languages = ["en", "fr", "es"];
 
   const switchLanguage = (locale: string) => {
     i18n.changeLanguage(locale);
diff --git a/src/i18n.ts b/src/i18n.ts
@@ -10,6 +10,15 @@ import homeEn from "../public/locales/en/home.json";
 import loginEn from "../public/locales/en/login.json";
 import logoutEn from "../public/locales/en/logout.json";
 import powerEn from "../public/locales/en/power.json";
+import commonEs from "../public/locales/es/common.json";
+import errorEs from "../public/locales/es/error.json";
+import fireplaceEs from "../public/locales/es/fireplace.json";
+import footerEs from "../public/locales/es/footer.json";
+import headerEs from "../public/locales/es/header.json";
+import homeEs from "../public/locales/es/home.json";
+import loginEs from "../public/locales/es/login.json";
+import logoutEs from "../public/locales/es/logout.json";
+import powerEs from "../public/locales/es/power.json";
 import commonFr from "../public/locales/fr/common.json";
 import errorFr from "../public/locales/fr/error.json";
 import fireplaceFr from "../public/locales/fr/fireplace.json";
@@ -43,6 +52,17 @@ const resources = {
     logout: logoutFr,
     power: powerFr,
   },
+  es: {
+    common: commonEs,
+    error: errorEs,
+    fireplace: fireplaceEs,
+    footer: footerEs,
+    header: headerEs,
+    home: homeEs,
+    login: loginEs,
+    logout: logoutEs,
+    power: powerEs,
+  },
 };
 
 i18n.use(initReactI18next).init({

Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,8 @@`
`3`	`3`	`"languageSwitcher": {`
`4`	`4`	`"languages": {`
`5`	`5`	`"en": "English",`
`6`		`- "fr": "Français"`
	`6`	`+ "fr": "Français",`
	`7`	`+ "es": "Español"`
`7`	`8`	`}`
`8`	`9`	`}`
`9`	`10`	`}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{`
	`2`	`+ "appTitle": "Open Edilkamin"`
	`3`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{`
	`2`	`+ "defaultTitle": "Error"`
	`3`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{`
	`2`	`+ "text": "Copyleft \uD83C\uDD2F Andre Miras 2022 - Open Edilkamin v"`
	`3`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{`
	`2`	`+ "button": "Cerrar sesión"`
	`3`	`+}`