itube-specs 0.0.720 → 0.0.721

package/package.json

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

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/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,