itube-specs 0.0.1043 → 0.0.1045

package/SITE_UPDATES.md

@@ -11,6 +11,23 @@
 коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
 кому именно (всем / сайтам с N), что будет, если не сделать.
 
+## 0.0.1045 — 2026-10-20
+
+- **Сайтам, у которых бэк включает хинди (`/v1/site/languages` отдаёт `name: "in"`, `iso: "hi"` — сейчас
+  videosection, hdsex):** слой хинди уже знает — `X-Language: in` для бэка (с `hi` бэк отдаёт английский контент),
+  общие переводы `i18n/locales/hi-IN.json` (пока пустые, заполняются через CSV слоя), `lib/countries/hi.json`
+  для `{secondText}` главной. Чтобы включить хинди на сайте: в `config/locales.config.ts` добавить
+  `{ code: 'hi', sub: 'in', file: 'hi-IN.json', language: 'hi-IN', iso: 'hi-IN', name: 'हिन्दी', value: 'hi' }`,
+  свой `i18n/locales/hi-IN.json` (мету старого сайта переносят `import-old-meta.mjs` / `import-old-h1.mjs` —
+  образец коммит videosection-redesign с хинди), `hi` в `nicheAdjectives` (если есть `%niche%`). В шаблоне
+  `meta.index.trending.h1` у хинди `{secondText}` уже несёт послелог (`भारत में`) — «में» не дописывать.
+  Не сделать — хинди на сайте нет, хотя бэк его включает.
+- **Всем — ничего делать не надо, к сведению:** переключатель языков и hreflang (`useEnabledLocales`,
+  `useSeoLinks`) показывают только локали, объявленные сайтом в `runtimeConfig.public.locales.codes`, и
+  включённые бэком. Раньше при пустом ответе бэка показывались все локали i18n — включая приехавшие файлом из
+  слоя, без домена у сайта, а у сайта с меньшим набором, чем файлов в слое, лишние локали от бэка проходили и
+  при нормальном ответе.
+
 ## 0.0.1041 — 2026-10-19
 
 - **Сайтам со своим `composables/use-meta.ts` или форком `pages/videos/[slug].vue` ради меты (videosection-redesign):**

package/components/player/interface.vue

@@ -137,7 +137,7 @@ onBeforeUnmount(() => {
 
 const videoCard = computed(() => ({
   guid: props.data.guid,
-  title: props.data.header,
+  title: props.data.header || props.data.title,
   duration: props.data.duration,
   thumbUrls: props.data.thumbUrls,
   md5: props.data.md5,

package/components/playlist/add.vue

@@ -396,6 +396,7 @@ async function onSaveClick() {
 
   color: $playlist-add-item-icon;
   display: flex;
+  flex-shrink: 0;
   align-items: center;
   column-gap: 4px;
 }

package/components/playlist/main.vue

@@ -72,7 +72,7 @@ const { execute: executeRefresh, loading: loadingRefresh } = useApiAction(Playli
 
 /** Плейлисты с ещё не отправленным удалением в попапе добавления не показываем. */
 const userPlaylists = computed<PaginatedResponse<IPlaylistCard> | null>(() => data.value
-  ? { ...data.value, items: data.value.items.filter(item => !isPendingDelete(item.id)) }
+  ? { ...data.value, items: (data.value.items ?? []).filter(item => !isPendingDelete(item.id)) }
   : null);
 
 async function getUserPlaylists() {

package/composables/__tests__/use-seo-links.test.ts

@@ -97,6 +97,36 @@ describe('useSeoLinks', () => {
     expect(hreflangs).not.toContain('zh-CN');
   });
 
+  it('alternate links только для объявленных сайтом локалей, даже без ответа бэка', () => {
+    const locales = useRuntimeConfig().public.locales;
+    locales.codes = ['en', 'fr', 'ja'];
+    try {
+      const { alternateLinks } = useSeoLinks('https://example.com', mockI18n, mockLocalePath);
+      const hreflangs = alternateLinks.value.map(l => l.hreflang);
+      expect(hreflangs).toContain('fr');
+      expect(hreflangs).toContain('ja-JP');
+      expect(hreflangs).not.toContain('de');
+      expect(hreflangs).not.toContain('zh-CN');
+    } finally {
+      locales.codes = [];
+    }
+  });
+
+  it('локаль нужна и сайту, и бэку', () => {
+    const locales = useRuntimeConfig().public.locales;
+    locales.codes = ['en', 'fr', 'ja'];
+    useEnabledLanguageCodes().value = ['en', 'fr', 'de'];
+    try {
+      const { alternateLinks } = useSeoLinks('https://example.com', mockI18n, mockLocalePath);
+      const hreflangs = alternateLinks.value.map(l => l.hreflang);
+      expect(hreflangs).toContain('fr');
+      expect(hreflangs).not.toContain('de');
+      expect(hreflangs).not.toContain('ja-JP');
+    } finally {
+      locales.codes = [];
+    }
+  });
+
   it('текущая локаль остаётся в alternate, даже если её нет в списке включённых', () => {
     mockRoute = { path: '/ja/videos', query: {} };
     mockI18n.locale.value = 'ja';

package/composables/use-enabled-locales.ts

@@ -4,14 +4,25 @@
  */
 export const useEnabledLanguageCodes = () => useState<string[]>('enabledLanguageCodes', () => []);
 
+/**
+ * Предикат «локаль показывается на сайте»: она объявлена сайтом (`runtimeConfig.public.locales.codes`)
+ * и включена бэком. Локаль, приехавшая только файлом из слоя, не проходит даже при пустом ответе бэка.
+ * Пустой список кодов сайта (слой без приложения) или бэка — это измерение не ограничивает.
+ */
+export const useIsLocaleShown = () => {
+    const enabledCodes = useEnabledLanguageCodes();
+    const siteCodes: string[] = useRuntimeConfig().public.locales?.codes || [];
+
+    return (code: string) => (!siteCodes.length || siteCodes.includes(code))
+        && (!enabledCodes.value.length || enabledCodes.value.includes(code));
+};
+
 /**
  * Локали i18n, отфильтрованные по включённым на сайте — для переключателей языка и hreflang.
  */
 export const useEnabledLocales = () => {
     const { locales } = useI18n();
-    const codes = useEnabledLanguageCodes();
+    const isShown = useIsLocaleShown();
 
-    return computed(() => codes.value.length
-        ? locales.value.filter(item => codes.value.includes(item.code))
-        : locales.value);
+    return computed(() => locales.value.filter(item => isShown(item.code)));
 };

package/composables/use-seo-links.ts

@@ -24,7 +24,7 @@ type LocalePathMock = (path: string, localeCode: string) => string;
 export const useSeoLinks = (baseDomain: string, i18n: I18nMock, localePath: LocalePathMock) => {
     const route = useRoute();
     const overrides = useSeoOverrides();
-    const enabledCodes = useEnabledLanguageCodes();
+    const isShown = useIsLocaleShown();
 
     const { locales, seo } = useRuntimeConfig().public;
     const defaultCode: string = locales.default;
@@ -116,14 +116,13 @@ export const useSeoLinks = (baseDomain: string, i18n: I18nMock, localePath: Loca
             });
         }
 
-        // локаль, выключенная на сайте, отдаёт 404 (server/middleware/locale-guard.ts) —
-        // такие hreflang вели бы на несуществующие страницы
-        const isEnabled = (code: string) => !enabledCodes.value.length || enabledCodes.value.includes(code);
+        // локаль, выключенная на сайте, отдаёт 404 (server/middleware/locale-guard.ts), а не объявленная
+        // сайтом не имеет домена — такие hreflang вели бы на несуществующие страницы
 
         const otherLocales = i18n.locales.value.filter(
             (locale) => {
                 const localeCode = typeof locale === 'string' ? locale : locale.code;
-                return localeCode !== currentLocaleCode && localeCode !== defaultCode && isEnabled(localeCode);
+                return localeCode !== currentLocaleCode && localeCode !== defaultCode && isShown(localeCode);
             }
         );
 

package/i18n/locales/hi-IN.json

@@ -0,0 +1 @@
+{}

package/lib/countries/__tests__/countries.test.ts

@@ -14,6 +14,7 @@ describe('getCountryPlace', () => {
     expect(await getCountryPlace('ph', 'de')).toBe('auf den Philippinen');
     expect(await getCountryPlace('us', 'it')).toBe('negli Stati Uniti');
     expect(await getCountryPlace('us', 'fr')).toBe('aux États-Unis');
+    expect(await getCountryPlace('ph', 'hi')).toBe('फ़िलिपींस में');
   });
 
   it('для локалей без предлога отдаёт именительный падеж — частица живёт в шаблоне', async () => {
@@ -41,7 +42,7 @@ describe('getCountryPlace', () => {
   it('словари покрывают все локали одним набором кодов', async () => {
     const codes = Object.keys(en).sort();
 
-    for (const locale of ['de', 'es', 'fr', 'it', 'ja', 'ko', 'ru', 'zh']) {
+    for (const locale of ['de', 'es', 'fr', 'hi', 'it', 'ja', 'ko', 'ru', 'zh']) {
       const { default: places } = await import(`../${locale}.json`);
 
       expect(Object.keys(places).sort(), locale).toEqual(codes);
@@ -49,7 +50,7 @@ describe('getCountryPlace', () => {
   });
 
   it('именительного падежа не держит — его отдаёт ICU один в один', async () => {
-    for (const locale of ['de', 'en', 'es', 'fr', 'it', 'ja', 'ko', 'ru', 'zh']) {
+    for (const locale of ['de', 'en', 'es', 'fr', 'hi', 'it', 'ja', 'ko', 'ru', 'zh']) {
       const { default: places } = await import(`../${locale}.json`);
       const displayNames = new Intl.DisplayNames([locale], { type: 'region' });
       const missing = Object.keys(places).filter(code => !displayNames.of(code.toUpperCase()));

package/lib/countries/hi.json

@@ -0,0 +1,251 @@
+{
+  "ad": "एंडोरा में",
+  "ae": "संयुक्त अरब अमीरात में",
+  "af": "अफ़गानिस्तान में",
+  "ag": "एंटिगुआ और बरबुडा में",
+  "ai": "एंग्विला में",
+  "al": "अल्बानिया में",
+  "am": "आर्मेनिया में",
+  "ao": "अंगोला में",
+  "aq": "अंटार्कटिका में",
+  "ar": "अर्जेंटीना में",
+  "as": "अमेरिकी समोआ में",
+  "at": "ऑस्ट्रिया में",
+  "au": "ऑस्ट्रेलिया में",
+  "aw": "अरूबा में",
+  "ax": "एलैंड द्वीपसमूह में",
+  "az": "अज़रबैजान में",
+  "ba": "बोस्निया और हर्ज़ेगोविना में",
+  "bb": "बारबाडोस में",
+  "bd": "बांग्लादेश में",
+  "be": "बेल्जियम में",
+  "bf": "बुर्किना फ़ासो में",
+  "bg": "बुल्गारिया में",
+  "bh": "बहरीन में",
+  "bi": "बुरुंडी में",
+  "bj": "बेनिन में",
+  "bl": "सेंट बार्थेलेमी में",
+  "bm": "बरमूडा में",
+  "bn": "ब्रूनेई में",
+  "bo": "बोलीविया में",
+  "bq": "कैरिबियन नीदरलैंड में",
+  "br": "ब्राज़ील में",
+  "bs": "बहामास में",
+  "bt": "भूटान में",
+  "bv": "बोवेत द्वीप में",
+  "bw": "बोत्स्वाना में",
+  "by": "बेलारूस में",
+  "bz": "बेलीज़ में",
+  "ca": "कनाडा में",
+  "cc": "कोकोस (कीलिंग) द्वीपसमूह में",
+  "cd": "कांगो - किंशासा में",
+  "cf": "मध्य अफ़्रीकी गणराज्य में",
+  "cg": "कांगो – ब्राज़ाविल में",
+  "ch": "स्विट्ज़रलैंड में",
+  "ci": "कोत दिवुआर में",
+  "ck": "कुक द्वीपसमूह में",
+  "cl": "चिली में",
+  "cm": "कैमरून में",
+  "cn": "चीन में",
+  "co": "कोलंबिया में",
+  "cr": "कोस्टारिका में",
+  "cu": "क्यूबा में",
+  "cv": "केप वर्ड में",
+  "cw": "कुरासाओ में",
+  "cx": "क्रिसमस द्वीप में",
+  "cy": "साइप्रस में",
+  "cz": "चेकिया में",
+  "de": "जर्मनी में",
+  "dj": "जिबूती में",
+  "dk": "डेनमार्क में",
+  "dm": "डोमिनिका में",
+  "do": "डोमिनिकन गणराज्य में",
+  "dz": "अल्जीरिया में",
+  "ec": "इक्वाडोर में",
+  "ee": "एस्टोनिया में",
+  "eg": "मिस्र में",
+  "eh": "पश्चिमी सहारा में",
+  "er": "इरिट्रिया में",
+  "es": "स्पेन में",
+  "et": "इथियोपिया में",
+  "fi": "फ़िनलैंड में",
+  "fj": "फ़िजी में",
+  "fk": "फ़ॉकलैंड द्वीपसमूह में",
+  "fm": "माइक्रोनेशिया में",
+  "fo": "फ़ेरो द्वीपसमूह में",
+  "fr": "फ़्रांस में",
+  "ga": "गैबॉन में",
+  "gb": "यूनाइटेड किंगडम में",
+  "gd": "ग्रेनाडा में",
+  "ge": "जॉर्जिया में",
+  "gf": "फ़्रेंच गुयाना में",
+  "gg": "गर्नसी में",
+  "gh": "घाना में",
+  "gi": "जिब्राल्टर में",
+  "gl": "ग्रीनलैंड में",
+  "gm": "गाम्बिया में",
+  "gn": "गिनी में",
+  "gp": "ग्वाडेलूप में",
+  "gq": "इक्वेटोरियल गिनी में",
+  "gr": "यूनान में",
+  "gs": "दक्षिण जॉर्जिया और दक्षिण सैंडविच द्वीपसमूह में",
+  "gt": "ग्वाटेमाला में",
+  "gu": "गुआम में",
+  "gw": "गिनी-बिसाउ में",
+  "gy": "गुयाना में",
+  "hk": "हाँग काँग (चीन विशेष प्रशासनिक क्षेत्र) में",
+  "hm": "हर्ड द्वीप और मैकडोनॉल्ड द्वीपसमूह में",
+  "hn": "होंडूरास में",
+  "hr": "क्रोएशिया में",
+  "ht": "हैती में",
+  "hu": "हंगरी में",
+  "id": "इंडोनेशिया में",
+  "ie": "आयरलैंड में",
+  "il": "इज़राइल में",
+  "im": "आइल ऑफ़ मैन में",
+  "in": "भारत में",
+  "io": "ब्रिटिश हिंद महासागरीय क्षेत्र में",
+  "iq": "इराक में",
+  "ir": "ईरान में",
+  "is": "आइसलैंड में",
+  "it": "इटली में",
+  "je": "जर्सी में",
+  "jm": "जमैका में",
+  "jo": "जॉर्डन में",
+  "jp": "जापान में",
+  "ke": "केन्या में",
+  "kg": "किर्गिज़स्तान में",
+  "kh": "कंबोडिया में",
+  "ki": "किरिबाती में",
+  "km": "कोमोरोस में",
+  "kn": "सेंट किट्स और नेविस में",
+  "kp": "उत्तर कोरिया में",
+  "kr": "दक्षिण कोरिया में",
+  "kw": "कुवैत में",
+  "ky": "कैमेन द्वीपसमूह में",
+  "kz": "कज़ाखस्तान में",
+  "la": "लाओस में",
+  "lb": "लेबनान में",
+  "lc": "सेंट लूसिया में",
+  "li": "लिचेंस्टीन में",
+  "lk": "श्रीलंका में",
+  "lr": "लाइबेरिया में",
+  "ls": "लेसोथो में",
+  "lt": "लिथुआनिया में",
+  "lu": "लग्ज़मबर्ग में",
+  "lv": "लातविया में",
+  "ly": "लीबिया में",
+  "ma": "मोरक्को में",
+  "mc": "मोनाको में",
+  "md": "मॉल्डोवा में",
+  "me": "मोंटेनेग्रो में",
+  "mf": "सेंट मार्टिन में",
+  "mg": "मेडागास्कर में",
+  "mh": "मार्शल द्वीपसमूह में",
+  "mk": "उत्तरी मकदूनिया में",
+  "ml": "माली में",
+  "mm": "म्यांमार (बर्मा) में",
+  "mn": "मंगोलिया में",
+  "mo": "मकाऊ (विशेष प्रशासनिक क्षेत्र चीन) में",
+  "mp": "उत्तरी मारियाना द्वीपसमूह में",
+  "mq": "मार्टीनिक में",
+  "mr": "मॉरिटानिया में",
+  "ms": "मोंटसेरात में",
+  "mt": "माल्टा में",
+  "mu": "मॉरीशस में",
+  "mv": "मालदीव में",
+  "mw": "मलावी में",
+  "mx": "मैक्सिको में",
+  "my": "मलेशिया में",
+  "mz": "मोज़ांबिक में",
+  "na": "नामीबिया में",
+  "nc": "न्यू कैलेडोनिया में",
+  "ne": "नाइजर में",
+  "nf": "नॉरफ़ॉक द्वीप में",
+  "ng": "नाइजीरिया में",
+  "ni": "निकारागुआ में",
+  "nl": "नीदरलैंड में",
+  "no": "नॉर्वे में",
+  "np": "नेपाल में",
+  "nr": "नाउरु में",
+  "nu": "नीयू में",
+  "nz": "न्यूज़ीलैंड में",
+  "om": "ओमान में",
+  "pa": "पनामा में",
+  "pe": "पेरू में",
+  "pf": "फ़्रेंच पोलिनेशिया में",
+  "pg": "पापुआ न्यू गिनी में",
+  "ph": "फ़िलिपींस में",
+  "pk": "पाकिस्तान में",
+  "pl": "पोलैंड में",
+  "pm": "सेंट पिएरे और मिक्वेलान में",
+  "pn": "पिटकैर्न द्वीपसमूह में",
+  "pr": "पोर्टो रिको में",
+  "ps": "फ़िलिस्तीनी क्षेत्र में",
+  "pt": "पुर्तगाल में",
+  "pw": "पलाऊ में",
+  "py": "पराग्वे में",
+  "qa": "क़तर में",
+  "re": "रियूनियन में",
+  "ro": "रोमानिया में",
+  "rs": "सर्बिया में",
+  "ru": "रूस में",
+  "rw": "रवांडा में",
+  "sa": "सऊदी अरब में",
+  "sb": "सोलोमन द्वीपसमूह में",
+  "sc": "सेशेल्स में",
+  "sd": "सूडान में",
+  "se": "स्वीडन में",
+  "sg": "सिंगापुर में",
+  "sh": "सेंट हेलेना में",
+  "si": "स्लोवेनिया में",
+  "sj": "स्वालबार्ड और जान मायेन में",
+  "sk": "स्लोवाकिया में",
+  "sl": "सिएरा लियोन में",
+  "sm": "सैन मेरीनो में",
+  "sn": "सेनेगल में",
+  "so": "सोमालिया में",
+  "sr": "सूरीनाम में",
+  "ss": "दक्षिण सूडान में",
+  "st": "साओ टोम और प्रिंसिपे में",
+  "sv": "अल सल्वाडोर में",
+  "sx": "सिंट मार्टिन में",
+  "sy": "सीरिया में",
+  "sz": "एस्वाटिनी में",
+  "tc": "तुर्क और कैकोज़ द्वीपसमूह में",
+  "td": "चाड में",
+  "tf": "फ़्रांसीसी दक्षिणी क्षेत्र में",
+  "tg": "टोगो में",
+  "th": "थाईलैंड में",
+  "tj": "ताजिकिस्तान में",
+  "tk": "तोकेलाउ में",
+  "tl": "तिमोर-लेस्त में",
+  "tm": "तुर्कमेनिस्तान में",
+  "tn": "ट्यूनीशिया में",
+  "to": "टोंगा में",
+  "tr": "तुर्किये में",
+  "tt": "त्रिनिदाद और टोबैगो में",
+  "tv": "तुवालू में",
+  "tw": "ताइवान में",
+  "tz": "तंज़ानिया में",
+  "ua": "यूक्रेन में",
+  "ug": "युगांडा में",
+  "um": "यू॰एस॰ आउटलाइंग द्वीपसमूह में",
+  "us": "संयुक्त राज्य में",
+  "uy": "उरूग्वे में",
+  "uz": "उज़्बेकिस्तान में",
+  "va": "वेटिकन सिटी में",
+  "vc": "सेंट विंसेंट और ग्रेनाडाइंस में",
+  "ve": "वेनेज़ुएला में",
+  "vg": "ब्रिटिश वर्जिन द्वीपसमूह में",
+  "vi": "यू॰एस॰ वर्जिन द्वीपसमूह में",
+  "vn": "वियतनाम में",
+  "vu": "वनुआतू में",
+  "wf": "वालिस और फ़्यूचूना में",
+  "ws": "समोआ में",
+  "ye": "यमन में",
+  "yt": "मायोते में",
+  "za": "दक्षिण अफ़्रीका में",
+  "zm": "ज़ाम्बिया में",
+  "zw": "ज़िम्बाब्वे में"
+}

package/lib/countries/index.ts

@@ -3,13 +3,14 @@
  * `in the Philippines`, `auf den Philippinen`, `negli Stati Uniti`, `aux États-Unis`. Предлог,
  * артикль и падеж лежат в значении — шаблон локали держит только `{secondText}` и ничего не
  * склеивает. У ja/ko/zh предлога нет, значение — именительный падеж, частица остаётся в шаблоне.
+ * У hi послелог `में` стоит в значении после имени (`फ़िलिपींस में`), шаблон его не дописывает.
  *
  * Именительного падежа здесь НЕТ намеренно: его один в один отдаёт `Intl.DisplayNames`
  * (сверено на всех 249 странах × 9 локалях) — см. utils/iso-code-to-country-name.ts. Косвенных
  * падежей и артиклей в ECMA-402 нет ни в каком виде, поэтому эта таблица и существует.
  *
  * Читается ТОЛЬКО на сервере (см. plugins/countries.server.ts): в payload уходит одна готовая
- * строка, таблица (249 стран × 9 локалей) в клиентский бандл не попадает. Не реэкспортируется
+ * строка, таблица (249 стран × 10 локалей) в клиентский бандл не попадает. Не реэкспортируется
  * из lib/index.ts по той же причине.
  */
 const LOADERS: Record<string, () => Promise<{ default: Record<string, string> }>> = {
@@ -17,6 +18,7 @@ const LOADERS: Record<string, () => Promise<{ default: Record<string, string> }>
   en: () => import('./en.json'),
   es: () => import('./es.json'),
   fr: () => import('./fr.json'),
+  hi: () => import('./hi.json'),
   it: () => import('./it.json'),
   ja: () => import('./ja.json'),
   ko: () => import('./ko.json'),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.1043",
+  "version": "0.0.1045",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {

package/runtime/constants/__tests__/languages.test.ts

@@ -0,0 +1,15 @@
+import { describe, it, expect } from 'vitest';
+import { Language, toHeaderLanguage } from '../languages';
+
+describe('toHeaderLanguage', () => {
+  it('maps locales whose backend code differs from ISO', () => {
+    expect(toHeaderLanguage(Language.Japanese)).toBe('jp');
+    expect(toHeaderLanguage(Language.Chinese)).toBe('ch');
+    expect(toHeaderLanguage(Language.Hindi)).toBe('in');
+  });
+
+  it('passes other locales through as is', () => {
+    expect(toHeaderLanguage(Language.English)).toBe('en');
+    expect(toHeaderLanguage(Language.Russian)).toBe('ru');
+  });
+});

package/runtime/constants/languages.ts

@@ -8,6 +8,7 @@ export const Language = {
   French: 'fr',
   Russian: 'ru',
   Chinese: 'zh',
+  Hindi: 'hi',
 } as const;
 
 export type Language = typeof Language[keyof typeof Language];
@@ -15,6 +16,7 @@ export type Language = typeof Language[keyof typeof Language];
 const languageHeaderMap: Partial<Record<Language, string>> = {
   [Language.Japanese]: 'jp',
   [Language.Chinese]: 'ch',
+  [Language.Hindi]: 'in',
 };
 
 export function toHeaderLanguage(lang: Language): string {