itube-specs 0.0.940 → 0.0.941

package/README.md

@@ -183,9 +183,11 @@ ad-конфиг), теперь читается из `runtimeConfig.public` (з
 
 - **Слой:** компоненты, composables, API-сервисы, доменные утилиты, runtime-константы/хелперы, типы,
   `lib/` (продуктовые данные), `config/` (темы, брейкпоинты), middleware (`auth`/`normalize`/`age`), SSR-плагины
-  (`country`/`mobile`/`services`/`sentry`/`adv`), BFF-хендлеры `server/api/**` — всё site-agnostic.
+  (`country`/`mobile`/`services`/`sentry`/`adv`), BFF-хендлеры `server/api/**`, общие i18n-ключи
+  (`i18n/locales/` — навигация, сортировки, UI-обвязка) — всё site-agnostic.
 - **Приложение:** только per-site — **значения** config (флаги/реклама/локали) через `runtimeConfig.public`
-  (слой держит пустые контейнеры-заглушки), i18n-локали, `public/` и **выбор темы** (`theme:` в
+  (слой держит пустые контейнеры-заглушки), свои i18n-ключи (SEO/ниша) и оверрайды общих,
+  `public/` и **выбор темы** (`theme:` в
   `config/site.config.ts`). Своего SCSS у приложения нет: `assets/scss/` — пустой слот-оверрайд.
   `server/` целиком в слое, включая locale-кластер.
 

package/components/ui/pagination.vue

@@ -1,3 +1,12 @@
+<!-- Пагинация: номера страниц, «Предыдущая»/«Следующая» и путь с текущим query.
+
+Через `Lazy…` подключать МОЖНО, но только с `hydrate-on-idle`, не с
+`hydrate-on-visible`. Пагинация стоит внизу страницы, а фильтры и сортировка
+меняют query из первого экрана: пока компонент не гидрирован, в DOM висит
+разметка от серверного рендера, и гидрация её атрибуты не переписывает. Клик
+мышью после этого работает (навигация идёт по объекту `to`), а «открыть в новой
+вкладке» уходило по устаревшему `href` — без выбранных фильтров и сортировки.
+Ключ `:key` от числа страниц спасал только когда их количество менялось. -->
 <template>
   <nav
     v-if="length > 1"

package/components/view/model-videos.vue

@@ -58,7 +58,7 @@
       :key="`pagination-${data.allPages}`"
       :total="data.allPages"
       class="view-model-videos__pagination _pagination"
-      hydrate-on-visible
+      hydrate-on-idle
     />
 
     <div

package/components/view/models.vue

@@ -108,7 +108,7 @@
       :key="`pagination-${data.allPages}`"
       :total="data.allPages"
       class="view-models__pagination _pagination"
-      hydrate-on-visible
+      hydrate-on-idle
     />
   </div>
 </template>

package/components/view/video.vue

@@ -83,7 +83,7 @@
       :total="total"
       :limit="10"
       class="view-video__pagination _pagination"
-      hydrate-on-visible
+      hydrate-on-idle
     />
 
     <LazySectionSwiperCards

package/components/view/videos.vue

@@ -66,7 +66,7 @@
       :key="`pagination-${data.allPages}`"
       :total="data.allPages"
       class="view-videos__pagination _pagination"
-      hydrate-on-visible
+      hydrate-on-idle
     />
 
     <SectionCategoriesIsland

package/components/view/webcams.vue

@@ -108,7 +108,7 @@ query-параметрах `filter_*`. Формат провайдера при
       :total="allPages"
       arrow-icon
       class="_pagination"
-      hydrate-on-visible
+      hydrate-on-idle
     />
   </div>
 </template>

package/i18n/locales/de-DE.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "Hauptmenü",
+    "videos": "Videos",
+    "categories": "Kategorien",
+    "top_categories": "Top-Kategorien",
+    "channels": "Kanäle",
+    "live_sex": "Live-Sex",
+    "history": "Verlauf",
+    "models": "Models",
+    "moments": "Momente",
+    "playlists": "Playlists",
+    "network": "Netzwerk",
+    "profile": "Profil",
+    "settings": "Einstellungen",
+    "my_playlists": "Meine Playlists",
+    "back_to_main_page": "Zur Hauptseite zurück",
+    "watch_later": "Später ansehen"
+  },
+  "sort": {
+    "network": "Netzwerk",
+    "popular": "Beliebt",
+    "trending": "Angesagt",
+    "new_videos": "Neue Videos",
+    "new": "Neu",
+    "new_short": "Neu",
+    "recommended": "Empfohlen",
+    "az": "A-Z",
+    "most_videos": "Meiste Videos",
+    "last_updated": "Zuletzt aktualisiert",
+    "longest": "Längste",
+    "longest_short": "Längste"
+  }
+}

package/i18n/locales/en-US.json

@@ -0,0 +1,38 @@
+{
+  "navigation": {
+    "main": "Main",
+    "videos": "Videos",
+    "categories": "Categories",
+    "top_categories": "Top categories",
+    "channels": "Channels",
+    "live_sex": "Live Sex",
+    "webcams": "Webcams",
+    "history": "History",
+    "models": "Models",
+    "moments": "Moments",
+    "playlists": "Playlists",
+    "network": "Network",
+    "profile": "Profile",
+    "settings": "Settings",
+    "my_playlists": "My playlists",
+    "library": "Library",
+    "back_to_main_page": "Back to Main page",
+    "watch_later": "Watch Later"
+  },
+  "sort": {
+    "recent": "Recent",
+    "relevant": "Relevant",
+    "network": "Network",
+    "popular": "Popular",
+    "trending": "Trending",
+    "new_videos": "New videos",
+    "new": "New",
+    "new_short": "New",
+    "recommended": "Recommended",
+    "az": "A-Z",
+    "most_videos": "Most videos",
+    "last_updated": "Last updated",
+    "longest": "Longest",
+    "longest_short": "Longest"
+  }
+}

package/i18n/locales/es-ES.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "Principal",
+    "videos": "Vídeos",
+    "categories": "Categorías",
+    "top_categories": "Categorías principales",
+    "channels": "Canales",
+    "models": "Modelos",
+    "moments": "Momentos",
+    "playlists": "Listas de reproducción",
+    "network": "Red",
+    "profile": "Perfil",
+    "settings": "Configuraciones",
+    "my_playlists": "Mis listas de reproducción",
+    "back_to_main_page": "Volver a la página principal",
+    "history": "Historial",
+    "live_sex": "Sexo en vivo",
+    "watch_later": "Ver después"
+  },
+  "sort": {
+    "network": "Red",
+    "popular": "Popular",
+    "trending": "Tendencia",
+    "new_videos": "Vídeos nuevos",
+    "new": "Nuevo",
+    "new_short": "Nuevo",
+    "recommended": "Recomendado",
+    "az": "A-Z",
+    "most_videos": "Más videos",
+    "last_updated": "Última actualización",
+    "longest": "Más largo",
+    "longest_short": "Largos"
+  }
+}

package/i18n/locales/fr-FR.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "Principal",
+    "videos": "Vidéos",
+    "categories": "Catégories",
+    "top_categories": "Catégories principales",
+    "channels": "Chaînes",
+    "models": "Modèles",
+    "moments": "Moments",
+    "playlists": "Listes de lecture",
+    "network": "Réseau",
+    "profile": "Profil",
+    "settings": "Paramètres",
+    "my_playlists": "Mes listes de lecture",
+    "back_to_main_page": "Retour à la page principale",
+    "history": "Historique",
+    "live_sex": "Sexe en direct",
+    "watch_later": "Regarder plus tard"
+  },
+  "sort": {
+    "network": "Réseau",
+    "popular": "Populaire",
+    "trending": "Tendance",
+    "new_videos": "Nouvelles vidéos",
+    "new": "Nouveau",
+    "new_short": "Nouveau",
+    "recommended": "Recommandé",
+    "az": "A-Z",
+    "most_videos": "Plus de vidéos",
+    "last_updated": "Dernière mise à jour",
+    "longest": "Les plus longues",
+    "longest_short": "Longues"
+  }
+}

package/i18n/locales/it-IT.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "Principale",
+    "videos": "Video",
+    "categories": "Categorie",
+    "top_categories": "Categorie principali",
+    "channels": "Canali",
+    "models": "Modelli",
+    "moments": "Momenti",
+    "playlists": "Playlist",
+    "network": "Rete",
+    "profile": "Profilo",
+    "settings": "Impostazioni",
+    "my_playlists": "Le mie playlist",
+    "back_to_main_page": "Torna alla pagina principale",
+    "history": "Cronologia",
+    "live_sex": "Sesso dal vivo",
+    "watch_later": "Guarda dopo"
+  },
+  "sort": {
+    "network": "Rete",
+    "popular": "Popolare",
+    "trending": "Tendenza",
+    "new_videos": "Nuovi video",
+    "new": "Nuovo",
+    "new_short": "Nuovo",
+    "recommended": "Raccomandato",
+    "az": "A-Z",
+    "most_videos": "Più video",
+    "last_updated": "Ultimo aggiornamento",
+    "longest": "Più lungo",
+    "longest_short": "Lunghi"
+  }
+}

package/i18n/locales/ja-JP.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "メイン",
+    "videos": "ビデオ",
+    "top_categories": "トップカテゴリ",
+    "categories": "カテゴリ",
+    "channels": "チャンネル",
+    "models": "モデル",
+    "moments": "瞬間",
+    "playlists": "プレイリスト",
+    "network": "ネットワーク",
+    "profile": "プロフィール",
+    "settings": "設定",
+    "my_playlists": "マイプレイリスト",
+    "back_to_main_page": "メインページに戻る",
+    "history": "履歴",
+    "live_sex": "ライブ",
+    "watch_later": "後で見る"
+  },
+  "sort": {
+    "network": "ネットワーク",
+    "popular": "人気",
+    "trending": "トレンド",
+    "new_videos": "新着ビデオ",
+    "new": "新しい",
+    "new_short": "新しい",
+    "recommended": "おすすめ",
+    "az": "A-Z",
+    "most_videos": "ビデオ数最多",
+    "last_updated": "最終更新",
+    "longest": "最長",
+    "longest_short": "最長"
+  }
+}

package/i18n/locales/ko-KR.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "메인",
+    "videos": "비디오",
+    "categories": "카테고리",
+    "top_categories": "상위 카테고리",
+    "channels": "채널",
+    "models": "모델",
+    "moments": "순간",
+    "playlists": "재생목록",
+    "network": "네트워크",
+    "profile": "프로필",
+    "settings": "설정",
+    "my_playlists": "내 재생목록",
+    "back_to_main_page": "메인 페이지로 돌아가기",
+    "history": "기록",
+    "live_sex": "라이브",
+    "watch_later": "나중에 보기"
+  },
+  "sort": {
+    "network": "네트워크",
+    "popular": "인기",
+    "trending": "트렌드",
+    "new_videos": "신규 비디오",
+    "new": "새로운",
+    "new_short": "새로운",
+    "recommended": "추천",
+    "az": "A-Z",
+    "most_videos": "동영상 수 최다",
+    "last_updated": "마지막 업데이트",
+    "longest": "가장 긴",
+    "longest_short": "가장 긴"
+  }
+}

package/i18n/locales/ru-RU.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "Главная",
+    "videos": "Видео",
+    "categories": "Категории",
+    "top_categories": "Топ категории",
+    "channels": "Каналы",
+    "live_sex": "Прямой эфир",
+    "history": "История",
+    "models": "Модели",
+    "moments": "Моменты",
+    "playlists": "Плейлисты",
+    "network": "Сеть",
+    "profile": "Профиль",
+    "settings": "Настройки",
+    "my_playlists": "Мои плейлисты",
+    "back_to_main_page": "Вернуться на главную",
+    "watch_later": "Смотреть позже"
+  },
+  "sort": {
+    "network": "Сеть",
+    "popular": "Популярное",
+    "trending": "В тренде",
+    "new_videos": "Новые видео",
+    "new": "Новое",
+    "new_short": "Новые",
+    "recommended": "Рекомендуемые",
+    "az": "A-Z",
+    "most_videos": "Больше видео",
+    "last_updated": "Последние",
+    "longest": "Самые длинные",
+    "longest_short": "Длинные"
+  }
+}

package/i18n/locales/zh-CN.json

@@ -0,0 +1,34 @@
+{
+  "navigation": {
+    "main": "主页",
+    "videos": "视频",
+    "categories": "类别",
+    "top_categories": "热门分类",
+    "channels": "频道",
+    "models": "模特",
+    "moments": "时刻",
+    "playlists": "播放列表",
+    "network": "网络",
+    "profile": "个人资料",
+    "settings": "设置",
+    "my_playlists": "我的播放列表",
+    "back_to_main_page": "返回主页",
+    "history": "历史记录",
+    "live_sex": "直播",
+    "watch_later": "稍后观看"
+  },
+  "sort": {
+    "network": "网络",
+    "popular": "热门",
+    "trending": "趋势",
+    "new_videos": "新视频",
+    "new": "新",
+    "new_short": "新",
+    "recommended": "推荐",
+    "az": "A-Z",
+    "most_videos": "最多视频",
+    "last_updated": "最后更新",
+    "longest": "最长",
+    "longest_short": "最长"
+  }
+}

package/nuxt.config.ts

@@ -1,6 +1,18 @@
+import { readdirSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { defineNuxtConfig } from 'nuxt/config';
 
+// Общие для всех сайтов переводы (навигация, сортировки, UI-действия). `@nuxtjs/i18n`
+// мержит локали слоёв: файл слоя встаёт в `files` ПЕРЕД проектным, поэтому проект
+// перекрывает любой ключ, а `deepCopy` мержит вложенные группы, не заменяя их целиком.
+// Список кодов выводится из самих файлов, поэтому набор здесь — канонический:
+// код, которого нет в locales приложения, добавит приложению лишнюю локаль.
+const sharedLocalesDir = fileURLToPath(new URL('./i18n/locales', import.meta.url));
+const sharedLocales = readdirSync(sharedLocalesDir)
+  .filter(file => file.endsWith('.json'))
+  .sort()
+  .map(file => ({ code: file.split('-')[0], file }));
+
 export default defineNuxtConfig({
   modules: ['@nuxt/eslint', '@nuxt/icon', '@nuxtjs/i18n'],
   imports: {
@@ -20,6 +32,11 @@ export default defineNuxtConfig({
       }
     ]
   },
+  i18n: {
+    // Строго относительный путь: абсолютный не работает в проде (модуль об этом warn'ит).
+    langDir: 'locales/',
+    locales: sharedLocales,
+  },
   icon: {
     customCollections: [
       {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.940",
+  "version": "0.0.941",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {
@@ -14,6 +14,9 @@
     "check:themes": "node scripts/check-themes.mjs",
     "check:styles": "node scripts/check-styles.mjs",
     "check:breakpoints": "node scripts/check-breakpoints.mjs",
+    "i18n:check": "node scripts/i18n-check.mjs",
+    "i18n:sheet:export": "node scripts/i18n-sheet.mjs export",
+    "i18n:sheet:import": "node scripts/i18n-sheet.mjs import",
     "test": "NODE_OPTIONS='--no-warnings' vitest",
     "prepare": "husky"
   },
@@ -74,6 +77,9 @@
     "assets/scss/base/",
     "assets/scss/layout/",
     "assets/scss/main.scss",
+    "i18n/locales/",
+    "scripts/i18n-check.mjs",
+    "scripts/i18n-sheet.mjs",
     "nuxt.config.ts",
     "DOCS/"
   ],

package/pages/channels/[channel].vue

@@ -69,7 +69,7 @@
       :key="`pagination-${videosData.allPages}`"
       :total="videosData.allPages"
       class="channel__pagination _pagination"
-      hydrate-on-visible
+      hydrate-on-idle
     />
   </div>
 </template>

package/scripts/i18n-check.mjs

@@ -0,0 +1,197 @@
+// Отчёт о полноте переводов: сравнивает каждую локаль с эталоном en-US.
+// Вне общего lint-флоу — гоняется вручную. Exit 1, если есть рассинхрон (для удобства проверки).
+//
+//   в слое:     npm run i18n:check
+//   в проекте:  node node_modules/itube-specs/scripts/i18n-check.mjs
+//
+// Пути берутся от cwd, поэтому один и тот же скрипт обслуживает и слой (общие ключи),
+// и приложение (свои ключи). В приложении общие локали слоя подмешиваются как
+// «унаследованные»: ключ, который есть в слое, не считается отсутствующим, а ключ,
+// продублированный в проекте с тем же значением, репортится как мёртвый оверрайд.
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+const LOCALES_DIR = path.resolve(process.cwd(), 'i18n', 'locales');
+const BASE = 'en-US';
+
+if (!fs.existsSync(LOCALES_DIR)) {
+  console.error(`✗ Нет каталога ${path.relative(process.cwd(), LOCALES_DIR)} — запускать из корня слоя или приложения.`);
+  process.exit(1);
+}
+
+// Локали слоя видны приложению через node_modules; при локальной разработке это симлинк
+// на сам слой, поэтому сверяем realpath — иначе слой подмешал бы себе свои же ключи.
+function resolveSharedDir() {
+  const dir = path.resolve(process.cwd(), 'node_modules', 'itube-specs', 'i18n', 'locales');
+  if (!fs.existsSync(dir)) return null;
+  if (fs.realpathSync(dir) === fs.realpathSync(LOCALES_DIR)) return null;
+  return dir;
+}
+
+const SHARED_DIR = resolveSharedDir();
+
+function flatten(obj, prefix = '', acc = {}) {
+  for (const key in obj) {
+    const full = prefix ? `${prefix}.${key}` : key;
+    const value = obj[key];
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+      flatten(value, full, acc);
+    } else {
+      acc[full] = value;
+    }
+  }
+  return acc;
+}
+
+function readFlat(dir, file) {
+  const full = path.join(dir, file);
+  if (!fs.existsSync(full)) return {};
+  return flatten(JSON.parse(fs.readFileSync(full, 'utf8')));
+}
+
+const readKeys = (dir, file) => Object.keys(readFlat(dir, file));
+
+const ownBaseKeys = readKeys(LOCALES_DIR, `${BASE}.json`);
+const sharedBaseKeys = SHARED_DIR ? readKeys(SHARED_DIR, `${BASE}.json`) : [];
+const baseKeys = [...new Set([...sharedBaseKeys, ...ownBaseKeys])];
+const baseSet = new Set(baseKeys);
+
+const locales = fs.readdirSync(LOCALES_DIR)
+  .filter(f => f.endsWith('.json') && f !== `${BASE}.json`)
+  .sort();
+
+const sharedNote = SHARED_DIR ? ` (своих ${ownBaseKeys.length} + общих из слоя ${sharedBaseKeys.length})` : '';
+console.log(`Эталон ${BASE}: ${baseKeys.length} ключей${sharedNote}\n`);
+
+let hasGap = false;
+// По умолчанию печатаем все ключи; ограничить можно флагом `--limit=N`.
+const limitArg = process.argv.find(a => a.startsWith('--limit='));
+const SHOW = limitArg ? Number(limitArg.split('=')[1]) : Infinity;
+
+// `*_footer_links.*` — это карты «подпись→URL», где сам ключ локализован
+// (en: twinks, ru: твинки, zh: 伪娘). Разные ключи по локалям тут by design,
+// сравнивать их с эталоном бессмысленно — исключаем (с пометкой сколько пропущено).
+const IGNORE = /footer_links\./;
+
+const deadOverrides = [];
+
+for (const file of locales) {
+  const locale = file.replace('.json', '');
+  const own = readFlat(LOCALES_DIR, file);
+  const shared = SHARED_DIR ? readFlat(SHARED_DIR, file) : {};
+  const set = new Set([...Object.keys(shared), ...Object.keys(own)]);
+
+  const dead = Object.keys(own).filter(k => k in shared && own[k] === shared[k]);
+  if (dead.length) deadOverrides.push([locale, dead]);
+
+  const allMissing = baseKeys.filter(k => !set.has(k));
+  const allExtra = [...set].filter(k => !baseSet.has(k));
+  const missing = allMissing.filter(k => !IGNORE.test(k));
+  const extra = allExtra.filter(k => !IGNORE.test(k));
+  const skipped = (allMissing.length - missing.length) + (allExtra.length - extra.length);
+  const inherited = Object.keys(shared).filter(k => !(k in own)).length;
+
+  const notes = [
+    skipped ? `пропущено ${skipped} ключей-подписей footer_links` : null,
+    inherited ? `наследует ${inherited} из слоя` : null,
+  ].filter(Boolean);
+
+  if (!missing.length && !extra.length) {
+    console.log(`✓ ${locale} — полная${notes.length ? ` (${notes.join(', ')})` : ''}`);
+    continue;
+  }
+
+  hasGap = true;
+  console.log(`✗ ${locale} — отсутствует: ${missing.length}, лишних: ${extra.length}${notes.length ? `, ${notes.join(', ')}` : ''}`);
+  if (missing.length) {
+    console.log(`    отсутствуют (есть в ${BASE}):`);
+    missing.slice(0, SHOW).forEach(k => console.log(`      - ${k}`));
+    if (missing.length > SHOW) console.log(`      … ещё ${missing.length - SHOW}`);
+  }
+  if (extra.length) {
+    console.log(`    лишние (нет в ${BASE}):`);
+    extra.slice(0, SHOW).forEach(k => console.log(`      + ${k}`));
+    if (extra.length > SHOW) console.log(`      … ещё ${extra.length - SHOW}`);
+  }
+  console.log('');
+}
+
+// --- мёртвые оверрайды: значение в проекте совпадает со слоем, ключ можно удалить.
+// Направление мержа одно (проект сильнее слоя), поэтому такой дубль ничего не меняет,
+// но замораживает перевод: правка в слое до этой локали уже не доедет.
+if (SHARED_DIR) {
+  console.log('\n— Оверрайды общих ключей —\n');
+  const baseDead = (() => {
+    const own = readFlat(LOCALES_DIR, `${BASE}.json`);
+    const shared = readFlat(SHARED_DIR, `${BASE}.json`);
+    return Object.keys(own).filter(k => k in shared && own[k] === shared[k]);
+  })();
+  if (baseDead.length) deadOverrides.unshift([BASE, baseDead]);
+
+  if (!deadOverrides.length) {
+    console.log('✓ мёртвых оверрайдов нет');
+  } else {
+    for (const [locale, keys] of deadOverrides) {
+      console.log(`✗ ${locale} — дублирует слой без изменений: ${keys.length}`);
+      keys.slice(0, SHOW).forEach(k => console.log(`      = ${k}`));
+      if (keys.length > SHOW) console.log(`      … ещё ${keys.length - SHOW}`);
+    }
+  }
+}
+
+// --- SEO keyword-links: каждый keyword из `*_footer_links` должен встречаться
+// в парном `*_text` (иначе ссылка не отрендерится). Совпадение — регистро-
+// независимая подстрока, как в splitTextByKeywordLinks. Пара: хвост
+// `footer_links` → `footer_text` (footer_links↔footer_text, models_footer_links↔models_footer_text).
+console.log('\n— SEO keyword-links (keyword ⊂ парный текст) —\n');
+
+function readRaw(file) {
+  return JSON.parse(fs.readFileSync(path.join(LOCALES_DIR, file), 'utf8'));
+}
+
+let hasDeadLinks = false;
+let checkedLinks = 0;
+for (const file of [`${BASE}.json`, ...locales]) {
+  const locale = file.replace('.json', '');
+  const json = readRaw(file);
+  const linkKeys = Object.keys(json).filter(
+    k => /footer_links$/.test(k) && json[k] && typeof json[k] === 'object' && !Array.isArray(json[k]),
+  );
+  if (!linkKeys.length) continue;
+  checkedLinks++;
+
+  const problems = [];
+  for (const lk of linkKeys) {
+    const textKey = lk.replace(/footer_links$/, 'footer_text');
+    const text = json[textKey];
+    if (typeof text !== 'string') {
+      problems.push(`${lk}: нет парного текста "${textKey}"`);
+      continue;
+    }
+    const haystack = text.toLowerCase();
+    const dead = Object.keys(json[lk]).filter(kw => !haystack.includes(kw.toLowerCase()));
+    if (dead.length) problems.push(`${lk} (текст "${textKey}"): нет в тексте — ${dead.map(k => `"${k}"`).join(', ')}`);
+  }
+
+  if (!problems.length) {
+    console.log(`✓ ${locale}`);
+    continue;
+  }
+  hasDeadLinks = true;
+  console.log(`✗ ${locale}`);
+  problems.forEach(p => console.log(`    ${p}`));
+}
+if (!checkedLinks) console.log('— нет ключей *_footer_links (SEO-карты живут в приложении)');
+
+const hasDeadOverrides = deadOverrides.length > 0;
+if (hasGap || hasDeadLinks || hasDeadOverrides) {
+  const parts = [
+    hasGap && 'рассинхрон ключей с эталоном',
+    hasDeadOverrides && 'мёртвые оверрайды общих ключей',
+    hasDeadLinks && 'мёртвые keyword-ссылки',
+  ].filter(Boolean);
+  console.log(`\nЕсть проблемы: ${parts.join('; ')}. Это отчёт, не гейт — он не блокирует коммиты и CI.`);
+  process.exit(1);
+}
+console.log('\nВсе локали совпадают с эталоном, keyword-ссылки целы.');

package/scripts/i18n-sheet.mjs

@@ -0,0 +1,258 @@
+// Мост «переводы ↔ CSV» для работы через переводчика.
+//
+//   в слое:     npm run i18n:sheet:export / npm run i18n:sheet:import
+//   в проекте:  node node_modules/itube-specs/scripts/i18n-sheet.mjs export|import
+//
+// Пути берутся от cwd, поэтому один и тот же скрипт обслуживает два набора:
+// общие ключи слоя (навигация, сортировки, UI-действия) и ключи приложения
+// (SEO-тексты, нишевая лексика). Каждый набор — свой i18n/i18n.csv, эталон свой.
+//
+// Двусторонний флоу:
+//   1. Разработчик добавляет новый ключ в en-US.json (эталон) нужного набора.
+//   2. export → в CSV появляется строка ключа с заполненным en и пустыми
+//      клетками остальных локалей (переводчику видно «новое, надо перевести»).
+//   3. Переводчик правит CSV (обычный файл: Excel / Numbers / Google Sheets → «скачать CSV»).
+//   4. import → значения из CSV попадают в *.json.
+//
+// Эталон структуры и порядка ключей — en-US.json. При импорте каждая локаль
+// пересобирается по порядку ключей эталона (files остаются консистентными,
+// «новые ключи сверху» из en-US подхватываются автоматически).
+//
+// В CSV строки сортируются «непереведённое сверху»: сначала ключи, пустые в
+// наибольшем числе локалей, дальше полностью заполненные — переводчику не надо
+// искать TODO по всему файлу. На импорт порядок строк не влияет.
+//
+// `*_footer_links.*` — карты «подпись→URL», где сам ключ локализован по-разному
+// в каждой локали (by design, см. scripts/i18n-check.mjs). В CSV не выгружаются
+// и при импорте берутся как есть из текущего файла локали.
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+const ROOT = process.cwd();
+const LOCALES_DIR = path.join(ROOT, 'i18n', 'locales');
+const CSV_PATH = path.join(ROOT, 'i18n', 'i18n.csv');
+const BASE = 'en-US';
+const IGNORE = /footer_links\./;
+
+if (!fs.existsSync(LOCALES_DIR)) {
+  console.error(`✗ Нет каталога ${path.relative(ROOT, LOCALES_DIR)} — запускать из корня слоя или приложения.`);
+  process.exit(1);
+}
+
+// --- файлы локалей: эталон первым, дальше по алфавиту (как в i18n-check) ---
+
+function localeFiles() {
+  const all = fs.readdirSync(LOCALES_DIR).filter(f => f.endsWith('.json')).sort();
+  const rest = all.filter(f => f !== `${BASE}.json`);
+  return [`${BASE}.json`, ...rest];
+}
+
+const localeCode = file => file.replace('.json', '');
+
+function readJson(file) {
+  return JSON.parse(fs.readFileSync(path.join(LOCALES_DIR, file), 'utf8'));
+}
+
+// --- плоские ключи через точку (только строковые листья, без footer_links) ---
+
+function flatten(obj, prefix = '', acc = {}) {
+  for (const key in obj) {
+    const full = prefix ? `${prefix}.${key}` : key;
+    const value = obj[key];
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+      flatten(value, full, acc);
+    } else if (typeof value === 'string' && !IGNORE.test(full)) {
+      acc[full] = value;
+    }
+  }
+  return acc;
+}
+
+function setDeep(obj, dottedKey, value) {
+  const parts = dottedKey.split('.');
+  let node = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    const p = parts[i];
+    if (typeof node[p] !== 'object' || node[p] === null || Array.isArray(node[p])) node[p] = {};
+    node = node[p];
+  }
+  node[parts[parts.length - 1]] = value;
+}
+
+// --- CSV (RFC 4180): кавычим поля с , " \n ; экранируем внутренние " как "" ---
+
+function csvCell(s) {
+  return /[",\n\r]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+}
+
+function toCsv(rows) {
+  return '' + rows.map(r => r.map(csvCell).join(',')).join('\r\n') + '\r\n';
+}
+
+// Разделитель зависит от локали редактора (Numbers/Excel пишут `;` или таб) —
+// нюхаем по первой строке, считая только вне кавычек.
+function sniffDelimiter(text) {
+  const nl = text.search(/\r|\n/);
+  const first = nl === -1 ? text : text.slice(0, nl);
+  const counts = { ',': 0, ';': 0, '\t': 0 };
+  let q = false;
+  for (const ch of first) {
+    if (ch === '"') q = !q;
+    else if (!q && ch in counts) counts[ch]++;
+  }
+  return [',', ';', '\t'].reduce((best, d) => (counts[d] > counts[best] ? d : best), ',');
+}
+
+function parseCsv(text) {
+  if (text.charCodeAt(0) === 0xfeff) text = text.slice(1);
+  const delim = sniffDelimiter(text);
+  const rows = [];
+  let row = [], field = '', inQuotes = false, i = 0;
+  const pushField = () => { row.push(field); field = ''; };
+  const pushRow = () => { pushField(); rows.push(row); row = []; };
+  while (i < text.length) {
+    const c = text[i];
+    if (inQuotes) {
+      if (c === '"') {
+        if (text[i + 1] === '"') { field += '"'; i += 2; continue; }
+        inQuotes = false; i++; continue;
+      }
+      field += c; i++; continue;
+    }
+    if (c === '"') { inQuotes = true; i++; continue; }
+    if (c === delim) { pushField(); i++; continue; }
+    if (c === '\r') { if (text[i + 1] === '\n') i++; pushRow(); i++; continue; }
+    if (c === '\n') { pushRow(); i++; continue; }
+    field += c; i++;
+  }
+  // хвост без завершающего перевода строки
+  if (field !== '' || row.length) pushRow();
+  return rows.filter(r => r.length > 1 || (r.length === 1 && r[0] !== ''));
+}
+
+// --- export ---
+
+function exportCsv() {
+  const files = localeFiles();
+  const codes = files.map(localeCode);
+  const flat = files.map(f => flatten(readJson(f)));
+
+  // ключи и их порядок берём из эталона
+  const baseKeys = Object.keys(flat[0]);
+
+  // Непереведённое — наверх: сначала ключи с наибольшим числом пустых локалей,
+  // внутри группы порядок эталона сохраняется. Порядок строк на импорт не влияет
+  // (там значения берутся по ключу, файл пересобирается в своём порядке).
+  const emptyCount = new Map(baseKeys.map(k => [k, flat.slice(1).filter(fl => !fl[k]).length]));
+  const sortedKeys = baseKeys
+    .map((k, idx) => ({ k, idx }))
+    .sort((a, b) => emptyCount.get(b.k) - emptyCount.get(a.k) || a.idx - b.idx)
+    .map(e => e.k);
+
+  const header = ['key', ...codes];
+  const rows = [header];
+  for (const k of sortedKeys) {
+    rows.push([k, ...flat.map(fl => fl[k] ?? '')]);
+  }
+
+  fs.writeFileSync(CSV_PATH, toCsv(rows), 'utf8');
+
+  const missing = codes.slice(1).map((code, idx) => {
+    const fl = flat[idx + 1];
+    const empty = baseKeys.filter(k => !fl[k]).length;
+    return empty ? `${code}: ${empty}` : null;
+  }).filter(Boolean);
+
+  const todoRows = sortedKeys.filter(k => emptyCount.get(k) > 0).length;
+
+  console.log(`✓ Выгружено ${baseKeys.length} ключей × ${codes.length} локалей → ${path.relative(ROOT, CSV_PATH)}`);
+  if (todoRows) console.log(`  Сверху ${todoRows} строк с непереведёнными ключами.`);
+  if (missing.length) console.log(`  Пустых (нужен перевод): ${missing.join(', ')}`);
+  else console.log('  Все локали заполнены.');
+}
+
+// --- import ---
+
+function importCsv() {
+  if (!fs.existsSync(CSV_PATH)) {
+    console.error(`✗ Нет файла ${path.relative(ROOT, CSV_PATH)} — сначала i18n:sheet:export`);
+    process.exit(1);
+  }
+  const rows = parseCsv(fs.readFileSync(CSV_PATH, 'utf8'));
+  const [header, ...body] = rows;
+  if (!header || header[0] !== 'key') {
+    console.error('✗ Первый столбец CSV должен называться "key".');
+    process.exit(1);
+  }
+  const codes = header.slice(1);
+
+  // ключи-строки эталона задают структуру и порядок
+  const baseFlat = flatten(readJson(`${BASE}.json`));
+  const orderedKeys = Object.keys(baseFlat);
+
+  // значения из CSV: { code: { dottedKey: value } }
+  const byCode = Object.fromEntries(codes.map(c => [c, {}]));
+  for (const r of body) {
+    const key = r[0];
+    if (!key || IGNORE.test(key)) continue;
+    codes.forEach((c, idx) => {
+      const v = r[idx + 1] ?? '';
+      if (v !== '') byCode[c][key] = v;
+    });
+  }
+
+  const baseSet = new Set(orderedKeys);
+
+  // Пересобираем файл локали в его СОБСТВЕННОМ порядке ключей (минимальный diff):
+  //  - строковый лист есть в эталоне → значение из CSV, иначе текущее;
+  //  - footer_links → как есть;
+  //  - лист, которого больше нет в эталоне → выкидываем (удаление ключей едет из en);
+  //  - структура/порядок вложенности сохраняются 1:1.
+  function rebuild(cur, csvVals, prefix = '') {
+    const out = {};
+    for (const k in cur) {
+      const full = prefix ? `${prefix}.${k}` : k;
+      const v = cur[k];
+      if (v && typeof v === 'object' && !Array.isArray(v)) {
+        const child = rebuild(v, csvVals, full);
+        if (Object.keys(child).length) out[k] = child;
+      } else if (typeof v === 'string') {
+        if (IGNORE.test(full)) out[k] = v;
+        else if (baseSet.has(full)) out[k] = csvVals[full] ?? v;
+      } else {
+        out[k] = v;
+      }
+    }
+    return out;
+  }
+
+  let changed = 0;
+  for (const file of localeFiles()) {
+    const code = localeCode(file);
+    if (!(code in byCode)) continue;
+    const current = readJson(file);
+    const csvVals = byCode[code];
+
+    const next = rebuild(current, csvVals);
+    // новые ключи эталона, которых ещё нет в локали, — дописываем в конец объекта
+    const nextFlat = flatten(next);
+    for (const k of orderedKeys) {
+      if (!(k in nextFlat) && csvVals[k] !== undefined) setDeep(next, k, csvVals[k]);
+    }
+
+    const out = JSON.stringify(next, null, 2) + '\n';
+    const prev = fs.readFileSync(path.join(LOCALES_DIR, file), 'utf8');
+    if (out !== prev) { fs.writeFileSync(path.join(LOCALES_DIR, file), out, 'utf8'); changed++; console.log(`  ~ ${file}`); }
+  }
+
+  console.log(changed ? `✓ Обновлено файлов: ${changed}. Прогони i18n:check.` : '✓ Изменений нет.');
+}
+
+const mode = process.argv[2];
+if (mode === 'export') exportCsv();
+else if (mode === 'import') importCsv();
+else {
+  console.error('Использование: node scripts/i18n-sheet.mjs export|import');
+  process.exit(1);
+}