itube-specs 0.0.719 → 0.0.721

package/package.json

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

package/runtime/utils/check-device-width.ts

@@ -13,6 +13,10 @@ function breakpoints(breakpoints: Record<CssBreakpoints, number>) {
     )
 }
 
+/**
+ * Возвращает реактивные флаги isMobile и isTablet на основе переданных breakpoints.
+ * @param projectBreakpoints - набор брейкпоинтов проекта (xs, sm, md, lg, xl) в пикселях
+ */
 export const checkDeviceWidth = (projectBreakpoints: Record<CssBreakpoints, number>) => {
     const isMobile = breakpoints(projectBreakpoints).smaller('sm');
     const isTablet = breakpoints(projectBreakpoints).smaller('md');

package/runtime/utils/cleaners/clean-category-card.ts

@@ -1,6 +1,7 @@
 import type { IRawCategoryCard, ICategoryCard } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырую карточку категории к типу ICategoryCard. */
 export const cleanCategoryCard = (card: IRawCategoryCard): ICategoryCard => ({
   name: card.name || '',
   title: card.title || '',

package/runtime/utils/cleaners/clean-category-info.ts

@@ -2,6 +2,7 @@ import type { IRawCategoryInfo, ICardInfo } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 import { convertCategoriesToChips } from '../converters/convert-categories-to-chips';
 
+/** Нормализует сырые данные страницы категории к типу ICardInfo. */
 export const cleanCategoryInfo = (card: IRawCategoryInfo): ICardInfo => ({
   guid: card.guid || '',
   title: card.title || '',

package/runtime/utils/cleaners/clean-channel-card.ts

@@ -1,6 +1,7 @@
 import type { IChannelCard, IRawChannelCard } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырую карточку канала к типу IChannelCard. */
 export const cleanChannelCard = (card: IRawChannelCard): IChannelCard => ({
   guid: card.guid || '',
   name: card.name || '',

package/runtime/utils/cleaners/clean-channel-info.ts

@@ -1,6 +1,7 @@
 import type { IRawChannelInfo, ICardInfo } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырые данные страницы канала к типу ICardInfo. */
 export const cleanChannelInfo = (card: IRawChannelInfo): ICardInfo => ({
   guid: card.guid || '',
   title: card.name || '',

package/runtime/utils/cleaners/clean-mini-category-card.ts

@@ -1,5 +1,6 @@
 import type { IRawCategoryCard, IMiniCategoryCard } from '../../../types';
 
+/** Нормализует сырую карточку категории к компактному типу IMiniCategoryCard. */
 export const cleanMiniCategoryCard = (card: IRawCategoryCard): IMiniCategoryCard => ({
     name: card.name || '',
     title: card.title || '',

package/runtime/utils/cleaners/clean-model-card.ts

@@ -4,6 +4,7 @@ import { ThumbSize } from '../../enums/thumb-size';
 const parameterNames = ['height_cm', 'weight_kg'];
 const age = (card: IRawModelCard) => card.parameters.find(item => item.name === 'age')?.values[0].title;
 
+/** Нормализует сырую карточку модели к типу IModelCard, включая параметры (возраст, рост, вес) и страну. */
 export const cleanModelCard = (card: IRawModelCard): IModelCard => ({
     title: card.title || '',
     videosCount: card.videos_count || 0,

package/runtime/utils/cleaners/clean-model-info.ts

@@ -1,6 +1,7 @@
 import type { IRawModelInfo, ICardInfo } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырые данные страницы модели к типу ICardInfo. */
 export const cleanModelInfo = (card: IRawModelInfo): ICardInfo => ({
   title: card.title || '',
   description: card.description || '',

package/runtime/utils/cleaners/clean-playlist-card.ts

@@ -1,6 +1,7 @@
 import type { IRawPlaylistCard, IPlaylistCard } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырую карточку плейлиста к типу IPlaylistCard. */
 export const cleanPlaylistCard = (card: IRawPlaylistCard): IPlaylistCard => ({
   created: card.created || 0,
   id: card.id || '',

package/runtime/utils/cleaners/clean-playlist-data.ts

@@ -1,5 +1,6 @@
 import type { IRawPlaylistData, IPlaylistData } from '../../../types';
 
+/** Нормализует сырые данные плейлиста к типу IPlaylistData. */
 export const cleanPlaylistData = (card: IRawPlaylistData): IPlaylistData => ({
   updated: card.updated || 0,
   id: card.id || '',

package/runtime/utils/cleaners/clean-playlist-video.ts

@@ -1,6 +1,7 @@
 import type { IRawPlaylistVideo, IVideoCard } from '../../../types';
 import { ThumbSize } from '../../../runtime';
 
+/** Нормализует сырое видео из плейлиста к типу IVideoCard. */
 export const cleanPlaylistVideo = (card: IRawPlaylistVideo): IVideoCard => ({
   guid: card.guid || '',
   duration: card.duration || 0,

package/runtime/utils/cleaners/clean-profile-data.ts

@@ -1,5 +1,6 @@
 import type { IRawProfileData, IProfileData } from '../../../types';
 
+/** Нормализует сырые данные профиля пользователя к типу IProfileData. */
 export const cleanProfileData = (data: IRawProfileData): IProfileData => ({
   username: data.username || '',
   email: data.email || '',

package/runtime/utils/cleaners/clean-user-playlists-card.ts

@@ -1,6 +1,7 @@
 import type { IRawPlaylistsUser, IPlaylistCard } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырую карточку плейлиста пользователя к типу IPlaylistCard. */
 export const cleanUserPlaylistCard = (card: IRawPlaylistsUser): IPlaylistCard => ({
   created: card.created || 0,
   id: card.id || '',

package/runtime/utils/cleaners/clean-video-card.ts

@@ -1,6 +1,7 @@
 import type { IRawVideoCard, IVideoCard } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
+/** Нормализует сырую карточку видео к типу IVideoCard. */
 export const cleanVideoCard = (card: IRawVideoCard): IVideoCard => ({
   guid: card.guid || '',
   quality: card.quality || '',

package/runtime/utils/cleaners/clean-video-data.ts

@@ -1,5 +1,6 @@
 import type { IRawVideoData, IVideoData } from '../../../types';
 
+/** Нормализует сырые данные видео к типу IVideoData. */
 export const cleanVideoData = (data: IRawVideoData): IVideoData => ({
     guid: data.guid || '',
     md5: data.md5 || '',

package/runtime/utils/compress-image.ts

@@ -1,3 +1,9 @@
+/**
+ * Сжимает изображение до maxSize px по наибольшей стороне и возвращает Blob в формате JPEG.
+ * @param blob - исходное изображение
+ * @param maxSize - максимальный размер стороны в px (по умолчанию 512)
+ * @param quality - качество JPEG от 0 до 1 (по умолчанию 0.8)
+ */
 export const compressImage = (blob: Blob, maxSize = 512, quality = 0.8): Promise<Blob> => {
   return new Promise((resolve, reject) => {
     const img = new Image();

package/runtime/utils/converters/convert-categories-to-chips.ts

@@ -1,6 +1,6 @@
 import type { IRawCategoryCard, IChipsItem } from '../../../types';
 
-/** Конвертирует обьекты категорий в чипсы */
+/** Конвертирует массив категорий в чипсы IChipsItem для фильтров. */
 export function convertCategoriesToChips(
   items: Array<IRawCategoryCard>,
   prefix: string

package/runtime/utils/converters/convert-categories-to-footer.ts

@@ -1,6 +1,6 @@
 import type { IRawCategoryCard, ILinkItem } from '../../../types';
 
-/** Конвертирует обьекты категорий в футер категории */
+/** Конвертирует массив категорий в ссылки ILinkItem для футера. */
 export function convertCategoriesToFooter(
   items: Array<IRawCategoryCard>,
 ): Array<ILinkItem> {

package/runtime/utils/converters/convert-channel-to-round-card.ts

@@ -1,6 +1,7 @@
 import type { IChannelCard, IRoundCard } from '../../../types';
 import { convertString } from './convert-string';
 
+/** Конвертирует карточку канала к формату IRoundCard для отображения в круглой карточке. */
 export function convertChannelToRoundCard(channel: IChannelCard): IRoundCard {
   return {
     title: channel.name,

package/runtime/utils/converters/convert-date-to-timestamp.ts

@@ -1,6 +1,4 @@
-    /**
-     * Преобразует строку вида "дд.мм.гггг" в Unix timestamp (в секундах)
-     */
+/** Возвращает функции для конвертации дат: toUnix ("yyyy-MM-dd" → timestamp) и fromUnix (timestamp → "yyyy-MM-dd"). */
 export const convertDateToTimestamp = () => {
     const toUnix = (dateStr: string): number | null => {
         const [year, month, day] = dateStr.split('-').map(Number);
@@ -16,10 +14,6 @@ export const convertDateToTimestamp = () => {
         return Math.floor(date.getTime() / 1000);
     };
 
-    /**
-     * Преобразует Unix timestamp в строку "yyyy-MM-dd"
-     * (то, что понимает input[type="date"])
-     */
     const fromUnix = (timestamp: number): string => {
         const date = new Date(timestamp * 1000);
 

package/runtime/utils/converters/convert-model-card-to-chips.ts

@@ -1,7 +1,7 @@
 import type { IRawModelCard, IChipsItem } from '../../../types';
 import { ThumbSize } from '../../enums/thumb-size';
 
-/** Конвертация карточки модели в chips */
+/** Конвертирует массив карточек моделей в чипсы IChipsItem с иконкой превью. */
 export function convertModelCardToChips(
   items: Array<IRawModelCard>,
 ): Array<IChipsItem> {

package/runtime/utils/converters/convert-model-to-round-card.ts

@@ -1,6 +1,7 @@
 import type { IModelCard, IRoundCard } from '../../../types';
 import { convertString } from './convert-string';
 
+/** Конвертирует карточку модели к формату IRoundCard для отображения в круглой карточке. */
 export function convertModelToRoundCard(model: IModelCard): IRoundCard {
   return {
     title: model.title,

package/runtime/utils/converters/convert-query-categories.ts

@@ -1,7 +1,5 @@
 import type { RouteLocationNormalizedLoaded } from 'vue-router';
-/**
-   * конвертирует список категорий из фильтра страниц с видео роликами из query в одну строку, все слова с заглавной буквы
- */
+/** Конвертирует категории из query-параметра в читаемую строку с заглавными буквами (до 3 категорий). */
 export function convertQueryCategories(route: RouteLocationNormalizedLoaded)  {
     const MAX_CATEGORIES = 3;
     return String(route.query[ 'categories' ])?.split(',').map(item => item.split('_')[ 1 ]).map(item => item?.charAt(0).toUpperCase() + item?.slice(1)).slice(0, MAX_CATEGORIES).join(', ');

package/runtime/utils/converters/convert-snake-keys-to-camel.ts

@@ -2,6 +2,7 @@ function snakeToCamel(str: string): string {
   return str.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
 }
 
+/** Рекурсивно преобразует все ключи объекта из snake_case в camelCase. */
 export function convertSnakeKeysToCamel<T = any>(input: any): T {
   if (Array.isArray(input)) {
     return input.map(item => convertSnakeKeysToCamel(item)) as T;

package/runtime/utils/converters/convert-string-array-to-chips.ts

@@ -1,5 +1,6 @@
 import type { IChipsItem } from '../../../types';
 
+/** Конвертирует массив строк в чипсы IChipsItem; строку '#' заменяет на 'post'. */
 export function convertStringArrayToChips(array: string[], prefix: string, resetPath: string): IChipsItem[] {
     return array.map((item) => ({
         title: item.toLowerCase() === '#' ? 'post' : item,

package/runtime/utils/converters/convert-string.ts

@@ -1,6 +1,8 @@
 import type { IChipsItem } from '../../../types';
 
+/** Утилиты для преобразования строк: slug, snake_case, kebab-case, chips, capitalize. */
 export const convertString = () => {
+    /** Преобразует строку в URL-slug: пробелы → дефисы, _ → ~, исходные дефисы сохраняются. */
     const toSlug = (input: string): string => {
         return input
             .toLowerCase()
@@ -10,6 +12,7 @@ export const convertString = () => {
             .replace(/\u0000/g, '_');
     };
 
+    /** Восстанавливает исходную строку из slug. */
     const fromSlug = (slug: string): string => {
         return slug
             .replace(/_/g, '\u0000')  // временно убираем "_" (разделители)
@@ -18,6 +21,7 @@ export const convertString = () => {
             .replace(/~/g, '_');      // в конце восстанавливаем "_"
     };
 
+    /** Преобразует строку в snake_case. */
     const toSnakeCase = (slug: string): string => {
         return slug
             .replace(/([a-z])([A-Z])/g, '$1_$2')
@@ -26,6 +30,7 @@ export const convertString = () => {
             .toLowerCase();
     };
 
+    /** Преобразует строку в kebab-case. */
     const toKebabCase = (str: string): string => {
         return str
             .replace(/([a-z])([A-Z])/g, '$1-$2')
@@ -35,6 +40,7 @@ export const convertString = () => {
             .toLowerCase();
     };
 
+    /** Создаёт объект IChipsItem из строки и префикса. */
     const toChips = (string: string, prefix: string): IChipsItem => {
         return {
             title: string,
@@ -43,6 +49,7 @@ export const convertString = () => {
         }
     }
 
+    /** Делает первую букву каждого слова заглавной. */
     const toCapitalize = (string: string): string => {
         return string.split(' ').map(i => i.charAt(0).toUpperCase() + i.slice(1)).join(' ');
     }

package/runtime/utils/converters/group-categories-by-first-letter.ts

@@ -1,6 +1,12 @@
 import type { IRawCategoryCard, ICategoryCard } from '../../../types';
 
-/** Метод для группировки мини категорий по первой букве свойства */
+/**
+ * Группирует категории по первой букве указанного свойства, сортируя по локали; нелитерные значения — под ключом nonLetterKey.
+ * @param items - массив категорий
+ * @param prop - свойство для группировки (например 'title')
+ * @param locale - локаль для сортировки
+ * @param nonLetterKey - ключ для нелитерных значений (по умолчанию 'POST')
+ */
 export function groupCategoriesByFirstLetter(
   items: Array<IRawCategoryCard>,
   prop: string,

package/runtime/utils/converters/group-objects-by-first-letter.ts

@@ -1,4 +1,9 @@
-/** Метод для группировки категорий по первой букве свойства */
+/**
+ * Группирует объекты по первой букве указанного свойства; нелитерные значения — под ключом nonLetterKey.
+ * @param items - массив объектов
+ * @param prop - свойство для группировки
+ * @param nonLetterKey - ключ для нелитерных значений (по умолчанию 'POST')
+ */
 export function groupObjectsByFirstLetter<T>(
   items: Array<T>,
   prop: string,

package/runtime/utils/format-date.ts

@@ -1,3 +1,4 @@
+/** Форматирует Unix timestamp (в секундах) в строку вида ДД.ММ.ГГГГ. */
 export function formatDate(seconds: number): string {
   const date = new Date(1000 * seconds);
 

package/runtime/utils/format-number.ts

@@ -1,6 +1,6 @@
 /**
- * Форматирует число в короткий формат 10400 => 10.4K
- * @param {number} number - число
+ * Форматирует число в короткий формат: 10400 → 10.4K.
+ * @param number - исходное число
  */
 
 export function formatNumber (number: number) {

package/runtime/utils/format-time-ago.ts

@@ -1,3 +1,8 @@
+/**
+ * Форматирует Unix timestamp (в секундах) в относительную строку: «сегодня», «вчера», «3 дня назад» и т.д.
+ * @param date - Unix timestamp в секундах
+ * @param t - функция перевода (i18n)
+ */
 export function formatTimeAgo(date: number, t) {
   const pastDate = new Date(date * 1000);
   const now = new Date();

package/runtime/utils/format-time.ts

@@ -1,3 +1,4 @@
+/** Форматирует секунды в строку мм:сс, или чч:мм:сс если есть часы. */
 export function formatTime(seconds: number): string {
     const h = Math.floor(seconds / 3600);
     const m = Math.floor((seconds % 3600) / 60);

package/runtime/utils/get-duration.ts

@@ -1,6 +1,6 @@
 /**
- * Возвращает продолжительность по переданным секундам в формате hh:mm:ss
- * @param {seconds} number - число секунды
+ * Возвращает продолжительность по переданным секундам в формате [чч:]мм:сс.
+ * @param seconds - количество секунд
  */
 export function getDuration (seconds: number) {
   const date = new Date(0);

package/runtime/utils/get-month.ts

@@ -1,6 +1,8 @@
 /**
- * возвращает название месяца по цифре
-  */
+ * Возвращает локализованное название месяца по его номеру (0-based).
+ * @param t - функция перевода (i18n)
+ * @param number - номер месяца от 0 (январь) до 11 (декабрь)
+ */
 export function getMonth(t: (key: string) => string, number?: number) {
   const months = [
     'january',

package/runtime/utils/get-multiple-query.ts

@@ -2,6 +2,13 @@ import type { RouteLocationNormalizedLoaded } from 'vue-router';
 import type { IChipsItem, ISelectItem } from '../../types';
 import { getSelectedQuery } from '../utils/get-selected-query';
 
+/**
+ * Возвращает query-объект для диапазонного фильтра (min/max) на основе текущего маршрута.
+ * @param route - текущий маршрут Vue Router
+ * @param items - список элементов фильтра
+ * @param minKey - ключ минимального значения в query
+ * @param maxKey - ключ максимального значения в query
+ */
 export function getMultipleQuery (
   route: RouteLocationNormalizedLoaded,
   items: ISelectItem[] | IChipsItem[],

package/runtime/utils/get-selected-query.ts

@@ -1,6 +1,7 @@
 import type { RouteLocation } from 'vue-router';
 import type { IChipsItem, ISelectItem } from '../../types';
 
+/** Возвращает значение query выбранного элемента из items, совпадающего с текущим маршрутом. */
 export function getSelectedQuery(route: RouteLocation, items: IChipsItem[] | ISelectItem[]) {
   return items.find(item => item.value === route.query[item.key || ''])?.query;
 }

package/runtime/utils/is-mobile-device.ts

@@ -1,3 +1,4 @@
+/** Возвращает true если userAgent соответствует мобильному устройству. */
 export const isMobileDevice = (userAgent: string) => {
   return /Android|webOS|iPhone|iPad|iPod|BlackBerry|Windows Phone/i.test(userAgent)
 }

package/runtime/utils/normalize-url.ts

@@ -1,3 +1,4 @@
+/** Нормализует URL: убирает page=1, sort=trending, пустые query, приводит к нижнему регистру, заменяет пробелы на дефисы. */
 export function normalizeUrl(to: { path: string; query: Record<string, any> }) {
   let path = to.path
   let query = { ...to.query }

package/runtime/utils/on-backdrop-click.ts

@@ -1,3 +1,4 @@
+/** Вызывает callback если клик пришёл непосредственно по элементу <dialog> (backdrop), а не по его содержимому. */
 export function onBackdropClick(target: HTMLDialogElement, callback: () => void) {
   if (target?.nodeName === 'DIALOG') {
     callback();

package/runtime/utils/scroll-lock.ts

@@ -1,3 +1,4 @@
+/** Возвращает функции lockScroll/unlockScroll для блокировки прокрутки страницы через overflow: hidden. */
 const lockScroll = () => {
   document.body.style.overflow = 'hidden';
 };

package/runtime/utils/validate-email.ts

@@ -1,3 +1,4 @@
+/** Возвращает true если строка является валидным email-адресом. */
 export function validateEmail(value: string) {
     const re = /^[\w&*+-]+(?:\.[\w&*+-]+)*@(?:[\da-z-]+\.)+[a-z]{2,}$/gi;
     return value?.length !== 0 && re.test(String(value).toLowerCase());

package/runtime/utils/validate-password.ts

@@ -1,3 +1,4 @@
+/** Возвращает true если пароль длиннее 4 символов. */
 export function validatePassword(value: string) {
   return value.length > 4;
 };

package/runtime/utils/validate-phone.ts

@@ -1,3 +1,4 @@
+/** Возвращает true если строка является валидным номером телефона (7–20 цифр, опциональные +, пробелы, скобки и дефисы). */
 export function validatePhone (value: string) {
   const re = /^\+?[0-9\s\-().]{7,20}$/;
   return value?.length !== 0 && re.test(String(value).trim());

package/runtime/utils/validate-username.ts

@@ -1,3 +1,4 @@
+/** Возвращает true если имя пользователя состоит из 2–20 символов (латиница, цифры, _ и -). */
 export function validateUsername (value: string) {
   const re = /^[a-zA-Z0-9_-]{2,20}$/;
   return value.length !== 0 && re.test(String(value).toLowerCase());

package/runtime/utils/video-data-add-model-icon.ts

@@ -1,5 +1,10 @@
 import type { IRawModelCard, IRawVideoData } from '../../types';
 
+/**
+ * Добавляет поле icon из modelsData в каждую модель videoData.models по совпадению guid.
+ * @param videoData - сырые данные видео
+ * @param modelsData - массив карточек моделей с primary_image_url
+ */
 export function videoDataAddModelIcon(videoData: IRawVideoData, modelsData: Array<IRawModelCard>): IRawVideoData {
   const transformedData = { ...videoData };
 

package/runtime/utils/vtt-helper.ts

@@ -4,6 +4,7 @@ export interface IVttItem {
     coords: { x: number; y: number; w: number; h: number };
 }
 
+/** Загружает и парсит VTT-файл с тайм-кодами и координатами спрайтов превью видео. */
 export class VttHelper {
   private readonly vttUrl: string;
   public hasInited: boolean;
@@ -15,6 +16,7 @@ export class VttHelper {
     this.vttData = null;
   }
 
+  /** Загружает и парсит VTT-файл по url из конструктора. Устанавливает hasInited = true после успешной загрузки. */
   async init(): Promise<void> {
     const vttContent: Response = await fetch(this.vttUrl);
 
@@ -71,6 +73,11 @@ export class VttHelper {
     return hh * 3600 + mm * 60 + ss;
   }
 
+  /**
+   * Возвращает координаты спрайта превью для указанного времени воспроизведения.
+   * @param time - время в секундах
+   * @param vttData - данные VTT (по умолчанию загруженные через init)
+   */
   getCoordsByTime(time: number, vttData: Array<IVttItem> | null = this.vttData):
       { x: number; y: number; w: number; h: number } | string {
     if (!this.hasInited || !vttData) {