itube-specs 0.0.1001 → 0.0.1004

package/SITE_UPDATES.md

@@ -0,0 +1,32 @@
+# Что сделать в сайтах после обновления слоя
+
+Только то, что каждый сайт должен сделать у себя после `npm run spec`: объявить новую сущность, поправить
+свою логику, удалить файлы, переехавшие в слой. Описание изменений слоя — в истории git, не здесь.
+
+Сайт после `npm run spec` видит записи между своей прошлой и новой версией:
+`node node_modules/itube-specs/scripts/site-updates.mjs`.
+
+Пишет тот, кто меняет слой, в том же коммите. Новые записи — сверху, в секцию `## Unreleased` (одна на все
+коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
+кому именно (всем / сайтам с N), что будет, если не сделать.
+
+## 0.0.1001 — 2026-10-06
+
+- **Всем:** удалить свои `public/img/model-placeholder-{portrait,square}.{webp,avif}` и
+  `model-placeholder-female-*`, если есть. Заглушки моделей теперь в слое
+  (`public/img/model-placeholder/<niche>-<theme>-<shape>`), старые пути слой больше не запрашивает.
+  Свой вариант картинки — файлом с тем же новым путём в `public/` сайта.
+
+## 0.0.1000 — 2026-10-06
+
+- **Сайтам с несколькими нишами, у которых ниша в URL не равна её коду** (`/gays` вместо `/gay`): одна
+  константа слагов → `nicheSlugs` в `app.config.ts` и `slugs` в `addNicheAliases` (`NEW_SITE_CHECKLIST.md` §3a).
+  Остальным — ничего.
+
+## 0.0.999 — 2026-10-06
+
+- **Всем:** флага нет в `config/feature-flags.config.ts` — фича выключена, дефолтов у слоя нет. Перечислить
+  все флаги явно по карте в `NEW_SITE_CHECKLIST.md` §4. Заглушки без бекенда (`FeatureFollowEnabled`,
+  `FeatureHistoryEnabled`, `FeatureFavoritesEnabled`, `FeatureWatchLaterEnabled`, `FeatureLiveEnabled`) — на
+  боевом сайте включать только осознанно; при выключенном флаге их страницы отдают 404.
+- **Всем:** `FeatureMomentsEnabled` и `SponsoredEnabled` слой не читает — можно убрать.

package/composables/use-generate-link.ts

@@ -1,5 +1,5 @@
 import type { Language, Niche } from '../runtime';
-import { nicheSlug, type NicheSlugs } from '../config/niches';
+import { nicheSlug, withNichePrefix, type NicheSlugs } from '../config/niches';
 import { NicheHelper } from '../utils/niche-helper';
 
 /** Возвращает generateLink — генерирует путь с учётом текущей ниши и локали. */
@@ -26,13 +26,12 @@ export const useGenerateLink = () => {
     const nicheFreeRoots = (appConfig.nicheFreeRoots as string[] | undefined) || [];
     const isNicheFree = nicheFreeRoots.some(root => cleanPath === root || cleanPath.startsWith(`${root}/`));
 
-    const withNiche =
-      !niche.value || niche.value === defaultNiche || isOneNiche || isNicheFree
-        ? cleanPath
-        : `/${nicheSlug(niche.value, appConfig.nicheSlugs as NicheSlugs | undefined)}${cleanPath}`;
-
     const locale = localeArg || undefined;
-    return localePath(withNiche, locale);
+    const localized = localePath(cleanPath, locale);
+
+    if (!niche.value || niche.value === defaultNiche || isOneNiche || isNicheFree) return localized;
+
+    return withNichePrefix(localized, `/${nicheSlug(niche.value, appConfig.nicheSlugs as NicheSlugs | undefined)}`, localePath('/', locale));
   };
 
   return { generateLink };

package/composables/use-niches.ts

@@ -1,4 +1,5 @@
 import type { Niche } from '../runtime';
+import { withNichePrefix } from '../config/niches';
 import { NicheHelper } from '../utils/niche-helper';
 
 /** Иконка из assets/icons/common под каждую нишу. */
@@ -40,7 +41,8 @@ export const useNiches = () => {
   function changeNiche(name: Niche) {
     if (name === current.value) return;
     current.value = name;
-    window.location.href = localePath(NicheHelper.getNichePath(name) || '/');
+    const root = localePath('/');
+    window.location.href = withNichePrefix(root, NicheHelper.getNichePath(name), root);
   }
 
   return { niches, currentNiche, changeNiche };

package/config/__tests__/niches.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { addNicheAliases, nicheFromPath, nicheFromSlug, nicheRoutePrefix, nicheSlug } from '../niches';
+import { addNicheAliases, nicheFromPath, nicheFromSlug, nicheRoutePrefix, nicheSlug, nichePath, withNichePrefix } from '../niches';
 
 const CONFIG = { niches: ['straight', 'gay', 'shemale'], defaultNiche: 'straight', contentRoots: ['/', '/videos', '/models'] };
 
@@ -19,9 +19,9 @@ describe('niches', () => {
     ];
     addNicheAliases(pages, CONFIG);
 
-    expect(pages[0]?.alias).toEqual(['/:niche(gay|shemale)']);
-    expect(pages[1]?.alias).toEqual(['/v/:slug', '/:niche(gay|shemale)/videos/:slug']);
-    expect(pages[2]?.alias).toEqual(['/:niche(gay|shemale)/models']);
+    expect(pages[0]?.alias).toEqual(['/gay', '/shemale']);
+    expect(pages[1]?.alias).toEqual(['/v/:slug', '/gay/videos/:slug', '/shemale/videos/:slug']);
+    expect(pages[2]?.alias).toEqual(['/gay/models', '/shemale/models']);
     expect(pages[3]?.alias).toBeUndefined();
     expect(pages[4]?.alias).toBeUndefined();
   });
@@ -32,7 +32,29 @@ describe('niches', () => {
 
     const pages = [{ path: '/videos/:slug' }];
     addNicheAliases(pages, { ...CONFIG, slugs });
-    expect(pages[0]?.alias).toEqual(['/:niche(gays|shemale)/videos/:slug']);
+    expect(pages[0]?.alias).toEqual(['/gays/videos/:slug', '/shemale/videos/:slug']);
+  });
+
+  it('префикс пути ниши: слаг, у дефолтной и одной ниши пусто', () => {
+    const slugs = { gay: 'gays' };
+    expect(nichePath('gay', { ...CONFIG, slugs })).toBe('/gays');
+    expect(nichePath('shemale', { ...CONFIG, slugs })).toBe('/shemale');
+    expect(nichePath('straight', CONFIG)).toBe('');
+    expect(nichePath(undefined, CONFIG)).toBe('');
+    expect(nichePath('gay', { niches: ['gay'], defaultNiche: 'straight' })).toBe('');
+  });
+
+  it('префикс ниши в локализованном пути — после языка', () => {
+    expect(withNichePrefix('/models', '/gays')).toBe('/gays/models');
+    expect(withNichePrefix('/', '/gays')).toBe('/gays');
+    expect(withNichePrefix('/?page=2', '/gays')).toBe('/gays?page=2');
+    expect(withNichePrefix('/ru/models', '/gays', '/ru')).toBe('/ru/gays/models');
+    expect(withNichePrefix('/ru', '/gays', '/ru')).toBe('/ru/gays');
+    expect(withNichePrefix('/ru?page=2', '/gays', '/ru')).toBe('/ru/gays?page=2');
+    expect(withNichePrefix('/rubber', '/gays', '/ru')).toBe('/gays/rubber');
+    expect(withNichePrefix('/models', '')).toBe('/models');
+    expect(withNichePrefix('https://ru.example.com/models', '/gays')).toBe('https://ru.example.com/gays/models');
+    expect(withNichePrefix('https://ru.example.com', '/gays')).toBe('https://ru.example.com/gays');
   });
 
   it('слаг ↔ ниша', () => {

package/config/niches.ts

@@ -79,19 +79,50 @@ function isUnderRoot(path: string, roots: readonly string[]): boolean {
 
 /**
  * Клонирует контентные разделы под нишевые префиксы — алиасом той же записи роута:
- * `/videos/:slug` начинает отвечать и на `/gay/videos/:slug`. Сайту с одной нишей ничего не
- * добавляет. Мутирует переданный список — так устроен хук `pages:extend`.
+ * `/videos/:slug` начинает отвечать и на `/gay/videos/:slug`. Алиасы статичные, по одному на нишу:
+ * у алиаса vue-router требует те же параметры, что у оригинала, поэтому параметр `:niche` сюда нельзя.
+ * Сайту с одной нишей ничего не добавляет. Мутирует переданный список — так устроен хук `pages:extend`.
  */
 export function addNicheAliases(pages: INicheAliasablePage[], config: INicheRouting): void {
-  const prefix = nicheRoutePrefix(config);
-  if (!prefix) return;
+  const prefixes = prefixedNiches(config).map(niche => `/${nicheSlug(niche, config.slugs)}`);
+  if (!prefixes.length) return;
 
   for (const page of pages) {
     if (!page.path || !isUnderRoot(page.path, config.contentRoots)) continue;
 
-    const alias = page.path === '/' ? prefix : `${prefix}${page.path}`;
+    const aliases = prefixes.map(prefix => (page.path === '/' ? prefix : `${prefix}${page.path}`));
     const current = Array.isArray(page.alias) ? page.alias : page.alias ? [page.alias] : [];
 
-    page.alias = [...current, alias];
+    page.alias = [...current, ...aliases];
   }
 }
+
+/** Префикс пути ниши (`/gays`). У дефолтной ниши и у сайта с одной нишей — пусто. */
+export function nichePath(niche: string | undefined, { niches, defaultNiche, slugs }: Pick<INicheRouting, 'niches' | 'defaultNiche' | 'slugs'>): string {
+  if (!niche || niches.length <= 1 || niche === defaultNiche) return '';
+
+  return `/${nicheSlug(niche, slugs)}`;
+}
+
+const ORIGIN_RE = /^https?:\/\/[^/?#]+/;
+
+/**
+ * Вставляет префикс ниши в уже локализованный путь — после языкового префикса: `/ru/models` → `/ru/gays/models`.
+ * Префикс ниши добавляется после `localePath`, а не до: на нишевом пути i18n находит роут по алиасу и
+ * пересобирает путь по имени роута — то есть без ниши (так же `switchLocalePath`). `localeRoot` —
+ * `localePath('/')` той же локали. Абсолютный URL (локали на поддоменах) — префикс в его путь.
+ */
+export function withNichePrefix(localizedPath: string, nichePath: string, localeRoot = '/'): string {
+  if (!nichePath) return localizedPath;
+
+  const origin = localizedPath.match(ORIGIN_RE)?.[0] || '';
+  if (origin) return `${origin}${withNichePrefix(localizedPath.slice(origin.length) || '/', nichePath, localeRoot)}`;
+
+  const localeRootPath = localeRoot.replace(ORIGIN_RE, '').replace(/\/$/, '');
+  const afterRoot = localizedPath.slice(localeRootPath.length);
+  const root = localeRootPath && localizedPath.startsWith(localeRootPath) && (!afterRoot || /^[/?#]/.test(afterRoot)) ? localeRootPath : '';
+  const rest = localizedPath.slice(root.length);
+  const tail = rest === '/' ? '' : rest.startsWith('/?') || rest.startsWith('/#') ? rest.slice(1) : rest;
+
+  return `${root}${nichePath}${tail}`;
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.1001",
+  "version": "0.0.1004",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {
     "prepublishOnly": "npm install && npx nuxi prepare",
     "patch": "npm version patch",
+    "version": "node scripts/site-updates-release.mjs && git add SITE_UPDATES.md",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
     "lint:css": "stylelint \"**/*.{scss,vue}\" --max-warnings=0 --allow-empty-input",
@@ -80,6 +81,8 @@
     "i18n/locales/",
     "scripts/i18n-check.mjs",
     "scripts/i18n-sheet.mjs",
+    "scripts/site-updates.mjs",
+    "SITE_UPDATES.md",
     "nuxt.config.ts",
     "DOCS/"
   ],

package/scripts/site-updates.mjs

@@ -0,0 +1,46 @@
+// Для сайта, после `npm run spec`: печатает записи SITE_UPDATES.md слоя, вышедшие после версии,
+// которая стояла в закоммиченном package.json сайта. Запуск из корня сайта.
+// Явно: `node node_modules/itube-specs/scripts/site-updates.mjs <старая-версия>`.
+
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+
+const FILE = 'node_modules/itube-specs/SITE_UPDATES.md';
+
+const toParts = version => version.replace(/^[^\d]*/, '').split('.').map(Number);
+const isNewer = (a, b) => {
+  const [x, y] = [toParts(a), toParts(b)];
+  for (let i = 0; i < 3; i++) if ((x[i] || 0) !== (y[i] || 0)) return (x[i] || 0) > (y[i] || 0);
+  return false;
+};
+
+function previousVersion() {
+  if (process.argv[2]) return process.argv[2];
+  try {
+    const pkg = JSON.parse(execSync('git show HEAD:package.json', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
+    return pkg.dependencies?.['itube-specs'] || pkg.devDependencies?.['itube-specs'] || '';
+  }
+  catch {
+    return '';
+  }
+}
+
+if (!existsSync(FILE)) process.exit(0);
+
+const from = previousVersion();
+const installed = JSON.parse(readFileSync('node_modules/itube-specs/package.json', 'utf8')).version;
+
+const sections = readFileSync(FILE, 'utf8').split(/^(?=## )/m).filter(part => part.startsWith('## '));
+const pending = sections.filter((section) => {
+  const version = section.match(/^## (\d+\.\d+\.\d+)/)?.[1];
+  return version && (!from || isNewer(version, from)) && !isNewer(version, installed);
+});
+
+if (!pending.length) {
+  console.log(`site-updates: ${from || '?'} → ${installed}, действий для сайта нет.`);
+  process.exit(0);
+}
+
+console.log(`\nsite-updates: ${from || '?'} → ${installed}. Что сделать в этом сайте (от старых к новым):\n`);
+console.log(pending.reverse().map(section => section.trim()).join('\n\n'));
+console.log('');

package/utils/niche-helper.ts

@@ -1,5 +1,5 @@
 import type { Niche } from '../runtime';
-import { nicheSlug, type NicheSlugs } from '../config/niches';
+import { nichePath, type NicheSlugs } from '../config/niches';
 
 /** Хелпер для работы с нишами */
 export class NicheHelper {
@@ -21,10 +21,17 @@ export class NicheHelper {
    * сайта с одной нишей — пусто.
    */
   public static getNichePath(niche: Niche = NicheHelper.getCurrentNiche()): string {
+    return nichePath(niche, NicheHelper.getNicheRouting());
+  }
+
+  /** Ниши сайта, дефолтная и слаги — то, что нужно `nichePath` и прочим хелперам `itube-specs/config`. */
+  public static getNicheRouting(): { niches: Niche[], defaultNiche: Niche, slugs?: NicheSlugs } {
     const appConfig = useAppConfig();
-    const isOneNiche = ((appConfig.niches as Niche[] | undefined) || []).length <= 1;
-    if (!niche || isOneNiche || niche === NicheHelper.getSiteDefaultNiche()) return '';
 
-    return `/${nicheSlug(niche, appConfig.nicheSlugs as NicheSlugs | undefined)}`;
+    return {
+      niches: (appConfig.niches as Niche[] | undefined) || [],
+      defaultNiche: NicheHelper.getSiteDefaultNiche(),
+      slugs: appConfig.nicheSlugs as NicheSlugs | undefined,
+    };
   }
 }