itube-specs 0.0.1052 → 0.0.1053

package/SITE_UPDATES.md

@@ -11,6 +11,21 @@
 коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
 кому именно (всем / сайтам с N), что будет, если не сделать.
 
+## 0.0.1053 — 2026-10-26
+
+- **Всем — к сведению:** нативка в конце сеток листингов и похожих (`AdvNativeBottom` в `view/video`, `view/videos`,
+  `view/model-videos`, страницах категории, канала, поиска) больше не ленивая. Контейнер приезжает в серверной
+  разметке, и сеть заполняет его до гидрации, а ленивая гидрация пересобирала уже заполненный iframe — креатив
+  терялся, слот оставался пустым (найдено на hdsex-remaster). Делать ничего не надо.
+- **Сайтам со своими сортировками на страницах на page-composables:** у `useCategoryPage`, `useChannelPage`,
+  `useModelPage` новая опция `sortOptions` (по умолчанию `sortItemsDefault`) — по ней ключи меты и проверка `?sort`.
+  Без неё свои значения `?sort` такой страницы — 404. Образец — коммит hdsex-remaster с этим изменением.
+- **Сайтам с частотным капом преролла (hdsex-remaster):** в `usePlayerSiteHooks()` новый хук `onAdStart()` — старт
+  рекламы в плеере (например, поставить куку капа). Остальным — ничего.
+- **Сайтам с боковой колонкой моделей у плеера (hdsex-remaster):** `appConfig.videoPage.hideAsideModelChips: true` —
+  с 1024px не дублировать чипсой над плеером модель, у которой есть блок в колонке. По умолчанию `false`, ничего не
+  меняется.
+
 ## 0.0.1052 — 2026-10-22
 
 - **Всем — к сведению:** мусорные адреса листингов теперь 404. `?page` не натуральное число (`0`, `-1`, `abc`, `01`) —

package/app.config.ts

@@ -39,6 +39,8 @@ export default defineAppConfig({
     webcamsBlock: false,
     /** Сколько моделей из хвоста списка уходит во врезки похожих, когда блок Live Cams включён. */
     webcamInserts: 8,
+    /** С 1024px прятать чипсы моделей над плеером, у которых есть блок в боковой колонке (не дублировать ссылку). */
+    hideAsideModelChips: false,
     /** Мета ролика как на старых движках: description — до трёх фраз перехода (недостающие — из тегов), без них —
      *  категории, склейка ключами `meta.videos-slug.tags_and` / `tags_tail`; в title доступен `{thirdText}` — название
      *  в Title Case. Выключено — description из описания ролика. */

package/components/player/core.vue

@@ -14,6 +14,7 @@
     lazy
     load-on="placeholder"
     @ended="emit('end')"
+    @adstart="siteHooks.onAdStart?.()"
     @advancerequest="onAdvanceRequest"
     @sourcechange="onSourceChange"
     @menurequest="onMenuRequest"

package/components/view/model-videos.vue

@@ -38,10 +38,8 @@
       priority
     >
       <template #grid-end>
-        <LazyAdvNativeBottom
-          v-if="featureFlags.AdsNativeEnabled"
-          hydrate-on-visible
-        />
+        <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+        <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
       </template>
     </GridVideos>
     <div

package/components/view/video.vue

@@ -29,6 +29,7 @@
                 v-for="(model, index) in data.models"
                 :key="index"
                 :item="getModelChips(model)"
+                :class="{'view-video__model-chips': hasAsideBlock(model.title)}"
                 is-link
               />
             </template>
@@ -75,11 +76,10 @@
           />
         </template>
 
+        <!-- Без ленивой гидрации: контейнер приезжает в серверной разметке и сеть заполняет его до гидрации,
+        а ленивая гидрация пересобирала уже заполненный iframe — креатив терялся, слот оставался пустым. -->
         <template #grid-end>
-          <LazyAdvNativeBottom
-            v-if="featureFlags.AdsNativeEnabled"
-            hydrate-on-visible
-          />
+          <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
         </template>
       </LazyGridVideos>
     </section>
@@ -126,7 +126,7 @@
 
 <script setup lang="ts">
 import type { IChipsItem, IModelCard, IStripcashModel, IVideoCard, IVideoData, PaginatedResponse } from '../../types';
-import { convertModelToRoundCard } from '../../runtime';
+import { convertModelToRoundCard, convertString } from '../../runtime';
 import { VideosApiService } from '../../services/api/videos.service';
 import type { AsyncDataRequestStatus } from '#app';
 
@@ -232,6 +232,15 @@ const topChips = computed(() => {
 const topChipsStrings = computed(() => topChips.value?.map(item => item.value));
 
 /** Портрет в чипсе — квадратный кроп по лицу; своего у видео нет, его подмешивает BFF. */
+// `videoPage.hideAsideModelChips`: с 1024px чипса модели не нужна тем, у кого есть блок в боковой колонке плеера
+// (`useFetchAsideModels`). Снимок, а не реактивное чтение: список заполняется эффектом, и реактивный класс
+// пересчитывался бы во время гидрации — разметка расходилась бы с серверной.
+const asideModelSlugs = new Set(videoPage.hideAsideModelChips ? useAsideModelSlugs().value : []);
+
+function hasAsideBlock(title: string): boolean {
+  return asideModelSlugs.has(convertString().toSlug(title));
+}
+
 const placeholderOf = useModelPlaceholder();
 
 function getModelChips(model: IVideoData['models'][number]): IChipsItem {
@@ -283,6 +292,12 @@ function getModelChips(model: IVideoData['models'][number]): IChipsItem {
   margin-top: 32px;
 }
 
+.view-video__model-chips {
+  @include from-br(sd) {
+    display: none;
+  }
+}
+
 .view-video__popular-models {
   margin-top: 32px;
 }

package/components/view/videos.vue

@@ -36,10 +36,8 @@
       priority
     >
       <template #grid-end>
-        <LazyAdvNativeBottom
-          v-if="featureFlags.AdsNativeEnabled"
-          hydrate-on-visible
-        />
+        <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+        <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
       </template>
 
       <LazySectionSwiperCards

package/composables/page/use-category-page.ts

@@ -1,7 +1,7 @@
 import { CategoriesApiService } from '../../services/api/categories.service';
 import { VideosApiService } from '../../services/api/videos.service';
 import { sortItemsDefault } from '../../lib';
-import type { IBreadcrumbItem, ICardInfo, IChipsItem } from '../../types';
+import type { IBreadcrumbItem, ICardInfo, IChipsItem, INavLinkItem } from '../../types';
 
 /** Слаги категорий, у которых не показываем связанные поисковые фразы. */
 const DISALLOWED_SLUGS = ['18', '19'];
@@ -35,7 +35,11 @@ export async function useCategoryPageData() {
  */
 export function useCategoryPage(
   pageData: Awaited<ReturnType<typeof useCategoryPageData>>,
-  options: { metaKeys?: boolean } = {},
+  options: {
+    metaKeys?: boolean
+    /** Сортировки страницы (по умолчанию `sortItemsDefault`): по ним ключи меты и проверка `?sort` (чужой — 404). */
+    sortOptions?: INavLinkItem[]
+  } = {},
 ) {
   const { categoryInfo, data, status, relatedData } = pageData;
   const { t } = useI18n();
@@ -52,14 +56,16 @@ export function useCategoryPage(
   useStatsPage(() => ({ rotatorID: 'category', categories: slug.value ? [slug.value] : [] }));
 
   // с metaKeys `?sort` проверяет useMeta
-  if (!options.metaKeys) useSortGuard(sortItemsDefault);
+  const sortOptions = options.sortOptions || sortItemsDefault;
+
+  if (!options.metaKeys) useSortGuard(sortOptions);
 
   const keysMeta = options.metaKeys
     ? useMeta({
         t,
         pageKey: useGetPureRouteName(),
         brandName: useAppConfig().brandName,
-        sortOptions: sortItemsDefault,
+        sortOptions,
         text: title,
         nicheSafeText: title,
         seo: () => ({

package/composables/page/use-channel-page.ts

@@ -4,7 +4,7 @@ import type { Language } from '../../runtime';
 import { sortItemsDefault } from '../../lib';
 import { ChannelsApiService } from '../../services/api/channels.service';
 import { VideosApiService } from '../../services/api/videos.service';
-import type { IBreadcrumbItem, IChipsItem, IPopularTags } from '../../types';
+import type { IBreadcrumbItem, IChipsItem, IPopularTags, INavLinkItem } from '../../types';
 
 /**
  * Данные страницы канала: карточка канала, видео, популярные теги. Только запросы — их можно запускать в
@@ -37,7 +37,12 @@ export async function useChannelPageData() {
  */
 export function useChannelPage(
   pageData: Awaited<ReturnType<typeof useChannelPageData>>,
-  options: { metaSort?: MaybeRefOrGetter<string>, metaSecondText?: Ref<string> } = {},
+  options: {
+    metaSort?: MaybeRefOrGetter<string>
+    metaSecondText?: Ref<string>
+    /** Сортировки страницы (по умолчанию `sortItemsDefault`): по ним ключи меты и проверка `?sort` (чужой — 404). */
+    sortOptions?: INavLinkItem[]
+  } = {},
 ) {
   const { cardInfo, status, channelTagsData } = pageData;
   const route = useRoute();
@@ -50,7 +55,7 @@ export function useChannelPage(
     t,
     pageKey: useGetPureRouteName(),
     brandName: useAppConfig().brandName,
-    sortOptions: sortItemsDefault,
+    sortOptions: options.sortOptions || sortItemsDefault,
     sort: options.metaSort,
     text: metaTitle,
     secondText: options.metaSecondText,

package/composables/page/use-model-page.ts

@@ -4,7 +4,7 @@ import type { Language } from '../../runtime';
 import { sortItemsDefault } from '../../lib';
 import { ModelsApiService } from '../../services/api/models.service';
 import { VideosApiService } from '../../services/api/videos.service';
-import type { IBreadcrumbItem } from '../../types';
+import type { IBreadcrumbItem, INavLinkItem } from '../../types';
 
 /**
  * Данные страницы модели: видео и карточка модели. Только запросы — их можно запускать в `Promise.all` вместе
@@ -34,7 +34,12 @@ export async function useModelPageData() {
  */
 export function useModelPage(
   pageData: Awaited<ReturnType<typeof useModelPageData>>,
-  options: { metaSort?: MaybeRefOrGetter<string>, metaSecondText?: Ref<string> } = {},
+  options: {
+    metaSort?: MaybeRefOrGetter<string>
+    metaSecondText?: Ref<string>
+    /** Сортировки страницы (по умолчанию `sortItemsDefault`): по ним ключи меты и проверка `?sort` (чужой — 404). */
+    sortOptions?: INavLinkItem[]
+  } = {},
 ) {
   const { status, cardInfo } = pageData;
   const route = useRoute();
@@ -48,7 +53,7 @@ export function useModelPage(
     t,
     pageKey: useGetPureRouteName(),
     brandName: useAppConfig().brandName,
-    sortOptions: sortItemsDefault,
+    sortOptions: options.sortOptions || sortItemsDefault,
     sort: options.metaSort,
     text: metaTitle,
     secondText: options.metaSecondText,

package/package.json

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

package/pages/categories/[slug].vue

@@ -33,10 +33,8 @@
       :class="{'_loading': status === 'pending'}"
     >
       <template #grid-end>
-        <LazyAdvNativeBottom
-          v-if="featureFlags.AdsNativeEnabled"
-          hydrate-on-visible
-        />
+        <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+        <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
       </template>
       <template #default>
         <UiExpandRow

package/pages/channels/[channel].vue

@@ -41,10 +41,8 @@
       priority
     >
       <template #grid-end>
-        <LazyAdvNativeBottom
-          v-if="featureFlags.AdsNativeEnabled"
-          hydrate-on-visible
-        />
+        <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+        <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
       </template>
       <template #default>
         <LazySectionSwiperCards

package/pages/search/[slug]/index.vue

@@ -78,10 +78,8 @@
           priority
         >
           <template #grid-end>
-            <LazyAdvNativeBottom
-              v-if="featureFlags.AdsNativeEnabled"
-              hydrate-on-visible
-            />
+            <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+            <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
             <UiViewAll
               v-if="videosData.items.length > MAXIMUM_VIDEOS || videosData.total > MAXIMUM_VIDEOS"
               :to="`/search/${slug}/videos`"

package/types/player-site-hooks.d.ts

@@ -14,4 +14,6 @@ export interface IPlayerSiteHooks {
   }
   /** Плеер смонтирован (заглушка) и готов (ядро) — вызывается оба раза. */
   onReady?: () => void
+  /** Началась реклама (преролл): например, отметить частотный кап показа. */
+  onAdStart?: () => void
 }