itube-specs 0.0.939 → 0.0.941

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.939",
+  "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);
+}

package/types/filter-chip-item.d.ts

@@ -9,4 +9,8 @@ export interface IFilterChipItem {
   value?: string | string[] | number
   /** Тип фильтра, к которому относится чипса. */
   key?: string
+  /** Код страны для флага (`/icons/flags/<код>.svg`) — у языковой чипсы вебкамов.
+   *  У такой чипсы подпись собрана переводом («Russian speaking»), поэтому
+   *  капитализация слов к ней не применяется. */
+  flag?: string
 }

package/utils/ui-pagination/__tests__/get-pagination-link.test.ts

@@ -7,9 +7,14 @@ describe('getPaginationLink', () => {
     expect(result).toEqual({ path: '/videos', query: { sort: 'new' } });
   });
 
-  it('для прочих страниц сохраняет query и проставляет номер (без path)', () => {
+  it('для прочих страниц сохраняет query и проставляет номер', () => {
     const result = getPaginationLink(5, 'page', '/videos', { sort: 'new' });
-    expect(result).toEqual({ query: { sort: 'new', page: 5 } });
+    expect(result).toEqual({ path: '/videos', query: { sort: 'new', page: 5 } });
+  });
+
+  it('путь есть у любой страницы: относительную локацию роутер разрешал бы сам', () => {
+    const result = getPaginationLink(3, 'page', '/gay/webcams', { filter_language: 'ru' });
+    expect(result).toEqual({ path: '/gay/webcams', query: { filter_language: 'ru', page: 3 } });
   });
 
   it('зажимает значение < 1 к первой странице', () => {
@@ -19,6 +24,6 @@ describe('getPaginationLink', () => {
 
   it('перезаписывает существующий префикс', () => {
     const result = getPaginationLink(7, 'page', '/videos', { page: '2', q: 'x' });
-    expect(result).toEqual({ query: { page: 7, q: 'x' } });
+    expect(result).toEqual({ path: '/videos', query: { page: 7, q: 'x' } });
   });
 });

package/utils/ui-pagination/get-pagination-link.ts

@@ -3,10 +3,17 @@ type QueryRecord = Record<string, QueryParam>;
 
 /**
  * Строит объект ссылки для страницы пагинации: для первой страницы убирает параметр `prefix`
- * из query (и отдаёт path), для остальных — проставляет номер. Значение < 1 зажимается к 1.
+ * из query, для остальных — проставляет номер. Значение < 1 зажимается к 1.
+ *
+ * Путь проставляем ВСЕГДА, даже когда он равен текущему. Локация без `path` — относительная,
+ * и её разрешает роутер: у нишевых разделов (они живут на алиасах записей) так пропадал
+ * префикс ниши, а `href` у ссылки вообще собирается из результата `resolve` — то есть любой
+ * промах разрешения уезжает в разметку. Клик мышью при этом работает (навигация идёт по
+ * объекту), а «открыть в новой вкладке» — уже по `href`, и открывалось не то.
+ *
  * @param value - номер страницы
  * @param prefix - имя query-параметра страницы (напр. `page`)
- * @param path - текущий путь (используется только для первой страницы)
+ * @param path - текущий путь
  * @param query - текущий query
  */
 export function getPaginationLink(
@@ -14,7 +21,7 @@ export function getPaginationLink(
   prefix: string,
   path: string,
   query: QueryRecord,
-): { path?: string; query: QueryRecord } {
+): { path: string; query: QueryRecord } {
   const safeValue = Math.max(1, Number(value));
 
   if (safeValue === 1) {
@@ -26,6 +33,7 @@ export function getPaginationLink(
   }
 
   return {
+    path,
     query: {
       ...query,
       [prefix]: safeValue,