Merge remote-tracking branch 'origin/main' into german/hal-638-fr

# Conflicts:
#	docs/CURRENT-STATE.md
#	docs/TRANSLATORS.md
#	scripts/package-boundaries.json
#	src/i18n/i18n.test.mjs
#	src/i18n/index.js
#	src/i18n/locale.js
#	src/i18n/same-as-english.json
#	src/scenes/recipes.js
#	src/ui/localePicker.test.mjs
#	src/ui/templates/context.html

src/i18n/i18n.test.mjs

@@ -33,11 +33,17 @@ function memoryStorage(initial = {}) {
 test('normalizeLocale folds regional variants and rejects unshipped tags', () => {
   assert.equal(normalizeLocale('ru-RU'), 'ru');
   assert.equal(normalizeLocale(' RU '), 'ru');
+  assert.equal(normalizeLocale('uk'), 'uk');
+  assert.equal(normalizeLocale('uk-UA'), 'uk');
   assert.equal(normalizeLocale('en_GB'), 'en');
   assert.equal(normalizeLocale('fr'), 'fr');
   assert.equal(normalizeLocale('fr-CA'), 'fr');
   assert.equal(normalizeLocale('FR_be'), 'fr');
+  assert.equal(normalizeLocale('pt-BR'), 'pt');
+  assert.equal(normalizeLocale('pt_PT'), 'pt');
   assert.equal(normalizeLocale('xx'), null);
+  assert.equal(normalizeLocale('it-IT'), 'it');
+  assert.equal(normalizeLocale('it_CH'), 'it');
   // Explicit script tags take precedence over regional defaults.
   assert.equal(normalizeLocale('zh'), 'zh-CN');
   assert.equal(normalizeLocale('zh-CN'), 'zh-CN');
@@ -145,6 +151,36 @@ test('tn() picks English and Russian plural forms', () => {
   assert.match(label(21), / 21 КЛЮЧ(?![А-ЯЁ])/);
 });
 
+test('tn() picks the Portuguese one, many and other forms', () => {
+  const label = (count) =>
+    tn(
+      count,
+      'POWER UP · {count} KEY WAITING',
+      'POWER UP · {count} KEYS WAITING',
+    );
+  setLocale('pt');
+  assert.equal(label(0), 'ATIVAR · 0 CHAVE PENDENTE');
+  assert.equal(label(1), 'ATIVAR · 1 CHAVE PENDENTE');
+  assert.equal(label(3), 'ATIVAR · 3 CHAVES PENDENTES');
+  assert.equal(label(1_000_000), 'ATIVAR · 1000000 DE CHAVES PENDENTES');
+});
+
+test('tn() picks the four Ukrainian plural forms', () => {
+  const label = (count) =>
+    tn(
+      count,
+      'POWER UP · {count} KEY WAITING',
+      'POWER UP · {count} KEYS WAITING',
+    );
+  setLocale('uk');
+  assert.match(label(1), / 1 КЛЮЧ(?![А-ЯҐЄІЇ])/);
+  assert.match(label(3), / 3 КЛЮЧІ(?![А-ЯҐЄІЇ])/);
+  assert.match(label(5), / 5 КЛЮЧІВ(?![А-ЯҐЄІЇ])/);
+  assert.match(label(11), / 11 КЛЮЧІВ(?![А-ЯҐЄІЇ])/);
+  assert.match(label(21), / 21 КЛЮЧ(?![А-ЯҐЄІЇ])/);
+  assert.match(label(1.5), / 1\.5 КЛЮЧА(?![А-ЯҐЄІЇ])/);
+});
+
 test('t() context separates identical English with different meanings', () => {
   assert.equal(t('CLEAR', { context: 'action' }), 'CLEAR');
   setLocale('ru');
@@ -203,6 +239,21 @@ test('applyDocumentTranslations translates opted-in text and attributes in place
   assert.equal(unknown.textContent, 'No such message');
 });
 
+test('applyDocumentTranslations reads data-i18n-context for element text', () => {
+  const option = fakeElement({
+    text: 'All',
+    attributes: { 'data-i18n-context': 'radio tag' },
+  });
+  const doc = {
+    querySelectorAll: (selector) =>
+      selector === '[data-i18n]' ? [option] : [],
+  };
+  setLocale('pt');
+  applyDocumentTranslations(doc);
+  assert.equal(option.textContent, t('All', { context: 'radio tag' }));
+  assert.notEqual(option.textContent, t('All'));
+});
+
 test('persistLocaleAndReload keeps the choice in ?lang when storage is blocked', () => {
   const calls = [];
   const location = {

src/i18n/index.js

@@ -18,14 +18,20 @@ import {
 } from './locale.js';
 import es from './locales/es.json' with { type: 'json' };
 import fr from './locales/fr.json' with { type: 'json' };
+import it from './locales/it.json' with { type: 'json' };
+import pt from './locales/pt.json' with { type: 'json' };
 import ru from './locales/ru.json' with { type: 'json' };
+import uk from './locales/uk.json' with { type: 'json' };
 import zhCN from './locales/zh-CN.json' with { type: 'json' };
 import zhHant from './locales/zh-Hant.json' with { type: 'json' };
 
 const CATALOGS = Object.freeze({
   es,
   fr,
+  it,
+  pt,
   ru,
+  uk,
   'zh-CN': zhCN,
   'zh-Hant': zhHant,
 });
@@ -228,7 +234,9 @@ function normalizeMarkupText(text) {
  * Markup opt-in: the element's own English text or attribute is the source.
  *   <span data-i18n>Normal</span>
  *   <button title="Pin" data-i18n-title>…</button>
- * Also data-i18n-aria-label and data-i18n-placeholder.
+ * Also data-i18n-aria-label and data-i18n-placeholder. data-i18n-context
+ * gives the element's text a context, as t(text, { context }) does:
+ *   <option data-i18n data-i18n-context="radio tag">All</option>
  */
 const DOCUMENT_TRANSLATION_TARGETS = Object.freeze([
   ['data-i18n', null],
@@ -253,7 +261,10 @@ export function applyDocumentTranslations(doc) {
         ? element.getAttribute(attribute)
         : normalizeMarkupText(element.textContent);
       if (!source) continue;
-      const text = t(source);
+      const context = attribute
+        ? null
+        : element.getAttribute?.('data-i18n-context');
+      const text = context ? t(source, { context }) : t(source);
       if (text === source) continue;
       if (attribute) element.setAttribute(attribute, text);
       else element.textContent = text;

src/i18n/locale.js

@@ -12,7 +12,10 @@ export const LOCALES = Object.freeze([
   'en',
   'es',
   'fr',
+  'it',
+  'pt',
   'ru',
+  'uk',
   'zh-CN',
   'zh-Hant',
 ]);
@@ -22,7 +25,10 @@ export const LOCALE_NAMES = Object.freeze({
   en: 'English',
   es: 'Español',
   fr: 'Français',
+  it: 'Italiano',
+  pt: 'Português (Brasil)',
   ru: 'Русский',
+  uk: 'Українська',
   'zh-CN': '中文（简体）',
   'zh-Hant': '中文（繁體）',
 });
@@ -32,6 +38,7 @@ const RTL_LOCALES = Object.freeze([]);
 
 /**
  * Map any language tag to a shipped locale: 'ru-RU' and 'RU' → 'ru',
+ * 'pt-BR' and 'pt-PT' → 'pt' (Brazilian Portuguese),
  * 'zh', 'zh-CN' and 'zh-Hans-SG' → 'zh-CN';
  * 'zh-Hant', 'zh-TW', 'zh-HK' and 'zh-MO' → 'zh-Hant'.
  * @returns {string|null}

src/i18n/locales/es.json

@@ -2227,6 +2227,8 @@
   "GOOGLE_MAPS_API_KEY is not set": "GOOGLE_MAPS_API_KEY no está configurada",
   "The Google Maps JavaScript API could not load": "No se pudo cargar la API de Maps JavaScript de Google",
   "Weather request timed out": "La petición del clima agotó el tiempo de espera",
+  "Cyclone request timed out": "La petición de ciclones agotó el tiempo de espera",
+  "Malformed cyclone snapshot": "Instantánea de ciclones mal formada",
   "Malformed weather manifest": "Manifiesto del clima mal formado",
   "Weather HTTP {status}": "Clima: HTTP {status}",
   "Weather image HTTP {status}": "Imagen del clima: HTTP {status}",

src/i18n/locales/ru.json

@@ -2263,6 +2263,8 @@
   "GOOGLE_MAPS_API_KEY is not set": "GOOGLE_MAPS_API_KEY не задан",
   "The Google Maps JavaScript API could not load": "Не удалось загрузить Google Maps JavaScript API",
   "Weather request timed out": "Истекло время ожидания запроса погоды",
+  "Cyclone request timed out": "Истекло время ожидания запроса циклонов",
+  "Malformed cyclone snapshot": "Некорректный снимок циклонов",
   "Malformed weather manifest": "Некорректный манифест погоды",
   "Weather HTTP {status}": "Погода: HTTP {status}",
   "Weather image HTTP {status}": "Снимок погоды: HTTP {status}",

src/i18n/locales/zh-CN.json

@@ -1203,6 +1203,8 @@
   "Some weather tiles unavailable": "部分天气瓦片不可用",
   "Malformed weather manifest": "天气清单格式错误",
   "Weather request timed out": "天气请求超时",
+  "Cyclone request timed out": "气旋请求超时",
+  "Malformed cyclone snapshot": "气旋快照格式错误",
   "Temperature field unavailable": "温度场不可用",
   "Mean sea level pressure field unavailable": "平均海平面气压场不可用",
   "Wind upstream unavailable": "风场上游数据源不可用",

src/i18n/locales/zh-Hant.json

@@ -1198,6 +1198,8 @@
   "Some weather tiles unavailable": "部分天氣瓦片不可用",
   "Malformed weather manifest": "天氣清單格式錯誤",
   "Weather request timed out": "天氣請求超時",
+  "Cyclone request timed out": "氣旋請求超時",
+  "Malformed cyclone snapshot": "氣旋快照格式錯誤",
   "Temperature field unavailable": "溫度場不可用",
   "Mean sea level pressure field unavailable": "平均海平面氣壓場不可用",
   "Wind upstream unavailable": "風場上游數據源不可用",

src/i18n/same-as-english.json

@@ -303,6 +303,303 @@
     "Ⅱ PAUSE",
     "▲ {frp} MW"
   ],
+  "it": [
+    "1090 MHz",
+    "978 MHz UAT",
+    "AFRICA",
+    "AIS: --",
+    "AIS: {name}",
+    "ALT {altitude} FT · GS {speed} KT · TRK {track}",
+    "ANIME",
+    "ASIA",
+    "AUTO",
+    "AUTO HOP OFF",
+    "AUTO HOP ON",
+    "Alternative",
+    "Ambient",
+    "Anime",
+    "Area",
+    "Austin",
+    "BRG {value}°",
+    "BRG —",
+    "Bloom",
+    "Blues",
+    "Business jet",
+    "CAL {value}",
+    "CAL · {badge}",
+    "CARGO",
+    "CCTV",
+    "CCTV OFF",
+    "CCTV ON",
+    "CH {index} / {total}",
+    "COCKPIT",
+    "CRS {value}°",
+    "CRT",
+    "Country",
+    "Cyber",
+    "DEST ---°",
+    "DEST {bearing}",
+    "DISPLAY",
+    "Dance",
+    "Drone",
+    "Dubai",
+    "ENE",
+    "ESE",
+    "FLIR",
+    "FM MHZ",
+    "FOCUS",
+    "FOV",
+    "FOV {value}°",
+    "FT",
+    "Folk",
+    "Funk",
+    "GEO",
+    "GOOGLE STREET VIEW",
+    "Google Street View",
+    "HDG",
+    "HDG {value}°",
+    "Hip-Hop",
+    "House",
+    "Indie",
+    "Ironbow",
+    "Jazz",
+    "KTS",
+    "LIVE",
+    "Landsat 8/9",
+    "Layout",
+    "Los Angeles",
+    "MIC",
+    "MIL",
+    "MINI",
+    "MM",
+    "MONITOR",
+    "MSG/S",
+    "Metal",
+    "NASA FIRMS · LIVE",
+    "NAV",
+    "NE",
+    "NNE",
+    "NOIR",
+    "NVG",
+    "New York",
+    "Noir",
+    "OCEANIA",
+    "OFF",
+    "OK",
+    "ON",
+    "ON/OFF",
+    "Oldies",
+    "PAYLOAD",
+    "PLAY",
+    "POS: LIVE",
+    "POS: {time}Z",
+    "PRECIP",
+    "Pop",
+    "Punk",
+    "RADIO",
+    "REC",
+    "RESET",
+    "RESET CAL",
+    "Radio",
+    "Reggae",
+    "Rock",
+    "S2 GhostMaps",
+    "SAR",
+    "SE",
+    "SIG",
+    "SNAPSHOT",
+    "SQUAWK {code} · {status}",
+    "SSE",
+    "STANDARD",
+    "STD",
+    "STOP",
+    "SYNC",
+    "San Francisco",
+    "Scope",
+    "Sentinel-2",
+    "Sonar",
+    "Soul",
+    "TEMP",
+    "TIMEOUT",
+    "Talk",
+    "Tallinn",
+    "Techno",
+    "Tokyo",
+    "Tram",
+    "Trance",
+    "UPSTREAM",
+    "USB {rate} msg/s",
+    "Upstream HTTP {status}",
+    "V/S {rate} FPM",
+    "VIEWSHED",
+    "VIEWSHED ON",
+    "VOLUME",
+    "VS",
+    "WHOT/BHOT",
+    "Washington DC",
+    "World",
+    "audio {state}",
+    "dB",
+    "feed status|live",
+    "ft",
+    "hPa",
+    "installation class|BASE",
+    "km",
+    "km/h",
+    "max {value} MW",
+    "min",
+    "mini",
+    "mph",
+    "radio|TALK",
+    "satellite",
+    "standard",
+    "view band|METRO",
+    "voice|OFF",
+    "{count} MSGS",
+    "{count} feeds live",
+    "{count} scenes",
+    "{rate} msg/s",
+    "{scene} / {pack}: {status}. File: {path}. {attribution} · {license}",
+    "{source} HTTP {status}",
+    "{speed} kn",
+    "{speed}KT",
+    "{value} KM",
+    "{value} KM DOWNRANGE",
+    "{value} KM/H",
+    "{value} KM/S",
+    "{value} conf",
+    "ΔE",
+    "ΔN",
+    "▲ {frp} MW"
+  ],
+  "pt": [
+    "1090 MHz",
+    "978 MHz UAT",
+    "AIS: --",
+    "AIS: {name}",
+    "ALT {altitude} FT · GS {speed} KT · TRK {track}",
+    "ALTITUDE",
+    "ALTITUDE · FT",
+    "ANIME",
+    "AUTO",
+    "Altitude {altitude}",
+    "Anime",
+    "Austin",
+    "BIKE",
+    "BRG {value}°",
+    "BRG —",
+    "Bloom",
+    "Blues",
+    "CAL {value}",
+    "CAL · {badge}",
+    "CCTV",
+    "CRS {value}°",
+    "CRT",
+    "Country",
+    "DEST ---°",
+    "DEST {bearing}",
+    "Dance",
+    "Drone",
+    "Dubai",
+    "ENE",
+    "ESE",
+    "FLIR",
+    "FLT",
+    "FM MHZ",
+    "FOV",
+    "FOV {value}°",
+    "FT",
+    "Folk",
+    "Funk",
+    "GEO",
+    "GOOGLE STREET VIEW",
+    "Global",
+    "Global · 60°S–60°N",
+    "Google Street View",
+    "HDG",
+    "HDG {value}°",
+    "Hip-Hop",
+    "House",
+    "Indie",
+    "Ironbow",
+    "Jazz",
+    "LOCAL",
+    "Landsat 8/9",
+    "Landsat 8/9 via HLS",
+    "Layout",
+    "Los Angeles",
+    "MIC",
+    "MIL",
+    "MINI",
+    "MM",
+    "MONITOR",
+    "MSG/S",
+    "Metal",
+    "NAV",
+    "NE",
+    "NNE",
+    "NOIR",
+    "NORMAL",
+    "NVG",
+    "Noir",
+    "Normal",
+    "OCEANIA",
+    "OK",
+    "POS: {time}Z",
+    "PRECIP",
+    "Paris",
+    "Pop",
+    "Punk",
+    "RANGE",
+    "REC",
+    "Reggae",
+    "Rock",
+    "S2 GhostMaps",
+    "SAR",
+    "SE",
+    "SIG",
+    "SNAPSHOT",
+    "SQUAWK {code} · {status}",
+    "SSE",
+    "STATUS",
+    "STATUS · ",
+    "Sentinel-2",
+    "Sentinel-2 via HLS",
+    "Sonar",
+    "Soul",
+    "TAGS · {tags}",
+    "TEMP",
+    "Tallinn",
+    "Techno",
+    "Trance",
+    "USB {rate} msg/s",
+    "V/S {rate}",
+    "VISUAL",
+    "VOLUME",
+    "VS",
+    "WHOT/BHOT",
+    "WX",
+    "dB",
+    "fire confidence|nominal",
+    "ft",
+    "hPa",
+    "installation class|BASE",
+    "km",
+    "km/h",
+    "kt",
+    "min",
+    "mini",
+    "mph",
+    "nominal",
+    "view band|GLOBAL",
+    "{rate} msg/s",
+    "{type}  SPD: {speed}  HDG: {heading}",
+    "{value} KM",
+    "{value} KM/H",
+    "{value} KM/S",
+    "ΔN",
+    "▲ {frp} MW"
+  ],
   "ru": [
     "AIS: --",
     "AIS: {name}",
@@ -321,6 +618,19 @@
     "VS",
     "WHOT/BHOT"
   ],
+  "uk": [
+    "AIS: --",
+    "AIS: {name}",
+    "CCTV",
+    "CRT",
+    "FLIR",
+    "Ironbow",
+    "Landsat 8/9",
+    "NVG",
+    "REC",
+    "S2 GhostMaps",
+    "WHOT/BHOT"
+  ],
   "zh-CN": [
     "1090 MHz",
     "978 MHz UAT",