itube-specs 0.0.1044 → 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/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/package.json

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