refactor(i18n): key messages by English text; add Russian

Replace the semantic keys with the English source text, so code reads as the
UI does and English needs no catalog: t('Save keys'), tn(count, one, other)
for plurals, msg() for text stored in data, and bare data-i18n* markup that
translates the element's own English. Other languages are one flat JSON each.

- Simplify src/i18n: drop namespaces, the configurable locale pair
  (GEV_DEFAULT_LOCALE / GEV_SECONDARY_LOCALE) and its build defines. Locale
  comes from ?lang=, the stored choice, then browser languages.
- Add scripts/i18n.mjs (npm run i18n): extracts every message from t/tn/msg
  and markup, and fails on missing, unused, placeholder-mismatched or
  wrongly-shaped plural entries. npm test runs it via catalog.test.mjs.
- Add Russian (src/i18n/locales/ru.json, 833 messages), started from the
  community catalog in #312 and reviewed against the current English.
- Fix data-i18n placed on parents that would wipe their children (cockpit
  LEVEL and local weather cells, first-run EXPLORE MANUALLY tile), and a
  doubled degree sign in the TRACK ACQUIRED signal.
- Rewrite docs/TRANSLATORS.md for the new workflow; drop sections the earlier
  merge resurrected in docs/CURRENT-STATE.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

src/layers/vessels/cards.js

@@ -21,13 +21,13 @@ export function createCards({
     const stale = (record.missedRefreshes || 0) > 0;
     el.classList.add('active');
     el.textContent = [
-      t('layers.vessel.hudName', { name: trimHudValue(record.name, 32) }),
-      t('layers.vessel.hudTypeLine', {
-        type: trimHudValue(record.type || t('layers.vessel.fallback'), 24),
+      t('AIS: {name}', { name: trimHudValue(record.name, 32) }),
+      t('{type}  SPD: {speed}  HDG: {heading}', {
+        type: trimHudValue(record.type || t('VESSEL'), 24),
         speed: formatSpeed(record.speed),
         heading: formatHeading(record.heading ?? record.course),
       }),
-      `MMSI: ${record.mmsi || '--'}  ${formatPositionTime(record)}${stale ? `  · ${t('layers.status.stale')}` : ''}`,
+      `MMSI: ${record.mmsi || '--'}  ${formatPositionTime(record)}${stale ? `  · ${t('STALE')}` : ''}`,
     ].join('\n');
   }
 
@@ -35,7 +35,7 @@ export function createCards({
     const el = document.getElementById('hud-ais-vessel');
     if (!el) return;
     el.classList.remove('active');
-    el.textContent = t('layers.vessel.hudIdle');
+    el.textContent = t('AIS: --');
   }
 
   function trimHudValue(value, maxLength) {
@@ -90,7 +90,7 @@ export function createCards({
     const direction = record.heading ?? record.course;
     const details = [
       [
-        vesselTypeShort(record) || t('layers.vessel.fallback'),
+        vesselTypeShort(record) || t('VESSEL'),
         formatSpeed(record.speed),
         Number.isFinite(direction) ? `${Math.round(direction)}°` : '--°',
       ].join(' · '),
@@ -99,7 +99,7 @@ export function createCards({
     if (destination) details.push(`→ ${trimHudValue(destination, 24)}`);
     const stale = (record.missedRefreshes || 0) > 0;
     details.push(
-      `MMSI ${record.mmsi || '--'} · ${formatPositionTime(record)}${stale ? ` · ${t('layers.status.stale')}` : ''}`,
+      `MMSI ${record.mmsi || '--'} · ${formatPositionTime(record)}${stale ? ` · ${t('STALE')}` : ''}`,
     );
     return {
       id: vesselOverlayEntryId(record),
@@ -156,7 +156,7 @@ export function createCards({
   function displayVesselName(record) {
     const name = String(record.name || '').trim();
     if (name && name !== 'VESSEL' && name !== record.mmsi) return name;
-    return record.mmsi ? `MMSI ${record.mmsi}` : t('layers.vessel.fallback');
+    return record.mmsi ? `MMSI ${record.mmsi}` : t('VESSEL');
   }
 
   function formatSpeed(speed) {
@@ -168,10 +168,10 @@ export function createCards({
   }
 
   function formatPositionTime(record) {
-    if (!record.lastPositionUtc) return t('layers.vessel.posLive');
+    if (!record.lastPositionUtc) return t('POS: LIVE');
     const date = new Date(record.lastPositionUtc);
-    if (Number.isNaN(date.getTime())) return t('layers.vessel.posLive');
-    return t('layers.vessel.posAt', { time: date.toISOString().slice(11, 19) });
+    if (Number.isNaN(date.getTime())) return t('POS: LIVE');
+    return t('POS: {time}Z', { time: date.toISOString().slice(11, 19) });
   }
   return {
     updateSelectedVesselHud,

src/layers/vessels/lifecycle.js

@@ -38,7 +38,7 @@ export function createLifecycle({
     state.feed.firstConnectStartedAt = startedAt;
     state.feed.firstConnectDeadline = startedAt + AIS_FIRST_CONNECT_GRACE_MS;
     state.feed.error = null;
-    state.feed.loadingLabel = t('layers.vessel.awaitingFirstPosition');
+    state.feed.loadingLabel = t('awaiting first AIS position…');
     scheduleFirstConnectExpiry(sessionId, AIS_FIRST_CONNECT_GRACE_MS);
   }
 
@@ -60,8 +60,8 @@ export function createLifecycle({
       state.feed.firstConnectPhase = 'unavailable';
       state.feed.loadingLabel = '';
       state.feed.error = state.feed.lastMessageAt
-        ? t('layers.vessel.awaitingPositions')
-        : t('layers.vessel.awaitingFirstMessage');
+        ? t('awaiting usable AIS positions…')
+        : t('awaiting first AIS message…');
       state.feed.stale = state.feed.count > 0;
     }, delayMs);
   }

src/layers/vessels/queries.js

@@ -1,14 +1,14 @@
 import * as Cesium from 'cesium';
-import { t } from '../../i18n/index.js';
+import { t, msg } from '../../i18n/index.js';
 
 // The vessels ingestion owner is a portable module graph (it also runs in the
 // server-side source builds), so it writes stable English feed labels into
 // state. Localize those known labels here, at the presentation read; anything
 // else (a bespoke manager label) passes through verbatim.
 const FEED_STATE_LABEL_KEYS = Object.freeze({
-  'refreshing...': 'layers.meta.refreshing',
-  'loading...': 'layers.meta.loading',
-  'awaiting first AIS position…': 'layers.vessel.awaitingFirstPosition',
+  'refreshing...': msg('refreshing...'),
+  'loading...': msg('loading...'),
+  'awaiting first AIS position…': msg('awaiting first AIS position…'),
 });
 
 function localizeFeedLabel(raw) {
@@ -98,8 +98,8 @@ export function createQueries({
     if (acceptedRowCount > 0) return null; // accepted rows may be stale while reconnecting, but remain usable
     if (AIS_HEALTHY_STATUSES.has(status)) {
       return payload?.lastMessageAt
-        ? t('layers.vessel.awaitingPositions')
-        : t('layers.vessel.awaitingFirstMessage');
+        ? t('awaiting usable AIS positions…')
+        : t('awaiting first AIS message…');
     }
     if (!status) return null;
     const detail =
@@ -158,9 +158,7 @@ export function createQueries({
       error: emptyCoverage
         ? null
         : deriveAisFeedError(payload, acceptedRowCount) ||
-          (acceptedRowCount === 0
-            ? t('layers.vessel.awaitingPositions')
-            : null),
+          (acceptedRowCount === 0 ? t('awaiting usable AIS positions…') : null),
     };
   }
 
@@ -532,7 +530,7 @@ export function createQueries({
         lastUpdate: state.feed.lastUpdate,
         loading: state.feed.loading || waitingForFirstPosition,
         loadingLabel: waitingForFirstPosition
-          ? t('layers.vessel.awaitingFirstPosition')
+          ? t('awaiting first AIS position…')
           : localizeFeedLabel(state.feed.loadingLabel),
         error: state.feed.error,
         stale: state.feed.stale,