itube-specs 0.0.720 → 0.0.722

package/composables/use-antiadblock-domains.ts

@@ -1,3 +1,4 @@
+/** Управляет состоянием антиадблок-доменов; предоставляет метод update для обновления данных через BFF. */
 export const useAntiadBlockDomains = () => {
   const state = useState('antiadblock-domains', () => ({
     data: null,

package/composables/use-api-action.ts

@@ -1,3 +1,8 @@
+/**
+ * Оборачивает API-метод в реактивные состояния loading, error, data.
+ * @param apiMethod - асинхронная функция API
+ * @param isGet - если true, результат сохраняется в data и опционально в useState по ключу key
+ */
 export function useApiAction<T extends any[], R>(
   apiMethod: (...args: T) => Promise<R>,
   isGet = false,

package/composables/use-api-fetcher-no-cache.ts

@@ -1,3 +1,10 @@
+/**
+ * Возвращает функцию fetchData, вызывающую apiMethod и сохраняющую результат в useState по ключу key.
+ * В отличие от useApiFetcher, не кеширует данные — подходит для запросов, требующих свежего состояния.
+ * @param key - ключ для useState (null — не сохранять)
+ * @param apiMethod - асинхронная функция API
+ * @param apiArgs - аргументы для apiMethod
+ */
 export function useApiFetcherNoCache<T>(
     key: string | null,
     apiMethod: (...args: any[]) => Promise<T>,

package/composables/use-api-fetcher.ts

@@ -1,3 +1,9 @@
+/**
+ * Возвращает функцию fetchData, вызывающую apiMethod с переданными аргументами и оборачивающую ошибки в createError.
+ * @param key - ключ для идентификации запроса в сообщении об ошибке
+ * @param apiMethod - асинхронная функция API
+ * @param apiArgs - аргументы для apiMethod
+ */
 export function useApiFetcher<T>(
     key: string | null,
     apiMethod: (...args: any[]) => Promise<T>,

package/composables/use-auth-popup.ts

@@ -1,5 +1,6 @@
 import { EAuthSteps } from '../runtime';
 
+/** Управляет состоянием попапа авторизации: открытие на нужном шаге EAuthSteps, закрытие, дополнительный текст. */
 export const useAuthPopup = () => {
   const isAuthPopupOpen = useState('auth-popup-open', () => false);
   const currentStep = useState<EAuthSteps>('auth-popup-step', () => EAuthSteps.Registration);

package/composables/use-favorites.ts

@@ -1,5 +1,6 @@
 export const FAVORITES_KEY = 'favorites';
 
+/** Управляет состоянием плейлиста избранного: id, первое видео и вычисляемая ссылка на плейлист. */
 export const useFavorites = () => {
   const favoritesId = useState<string | null>('favorites-playlist-id', () => null);
   const favoritesFirstVideoId = useState<string | null>('favorites-first-video-id', () => null);

package/composables/use-filter-scheme.ts

@@ -1,6 +1,11 @@
 import type { IFilterScheme, IGroupCategories } from '../types';
 import { convertString } from '../runtime';
 
+/**
+ * Строит вычисляемую схему фильтров из группированных категорий.
+ * @param t - функция перевода (i18n)
+ * @param groupsCategories - массив групп категорий
+ */
 export const useFilterScheme = (t, groupsCategories: IGroupCategories[] | null) => {
   const getFilterSchemeCategories = (): IFilterScheme[] => {
     return groupsCategories?.map((item) => ({

package/composables/use-format-time-ago.ts

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

package/composables/use-generate-link.ts

@@ -1,5 +1,6 @@
 import type { ELanguage, ENiche } from '~/runtime';
 
+/** Возвращает generateLink — генерирует путь с учётом текущей ниши и локали. */
 export const useGenerateLink = () => {
   const niche = useState<string>('niche');
   const localePath = useLocalePath();

package/composables/use-get-pure-route-name.ts

@@ -1,5 +1,6 @@
 import { useRoute } from 'vue-router';
 
+/** Возвращает имя текущего маршрута без суффикса локали (___en, ___ru и т.д.). */
 export function useGetPureRouteName() {
   return String(useRoute()?.name)?.replace(/___[a-zA-Z-]+$/, '') || '';
 }

package/composables/use-get-videos-filter-request.ts

@@ -2,6 +2,12 @@ import { getMultipleQuery } from '../runtime';
 import type { ISelectItem } from '../types';
 import type { RouteLocationNormalized, RouteLocationNormalizedLoaded } from 'vue-router';
 
+/**
+ * Формирует объект параметров запроса фильтра видео из query текущего маршрута.
+ * @param route - текущий маршрут
+ * @param selectDurationItems - элементы выбора длительности
+ * @param selectAddedItems - элементы выбора даты добавления
+ */
 export function useGetVideosFilterRequest(route: RouteLocationNormalized | RouteLocationNormalizedLoaded, selectDurationItems: ISelectItem[], selectAddedItems: ISelectItem[]) {
     // Распарсим categories из query, если есть
     const rawCategories = route.query.categories

package/composables/use-global-scroll-lock.ts

@@ -16,6 +16,7 @@ function preventTouchScroll(e: TouchEvent) {
   }
 }
 
+/** Управляет глобальной блокировкой прокрутки с счётчиком вложенности; корректно блокирует тач-скролл на мобильных. */
 export function useGlobalScrollLock() {
   const lockCount = useState('global-scroll-lock-count', () => 0);
 

package/composables/use-lang.ts

@@ -1,3 +1,4 @@
+/** Возвращает код текущей локали с учётом алиасов (zh → ch). */
 export const useLang = () => {
     const lang = useI18n().locale.value;
     const anotherCode: Record<string, string> = {

package/composables/use-meta.ts

@@ -3,6 +3,17 @@ import type { Ref } from 'vue';
 import { useRoute } from 'vue-router';
 import type { IChipsItem } from '../types';
 
+/**
+ * Генерирует реактивные meta (title, description) и h1 с учётом сортировки, страницы и i18n-ключей.
+ * @param t - функция перевода (i18n)
+ * @param page - ключ страницы для i18n (например 'videos', 'models')
+ * @param brandName - название бренда для подстановки в мета
+ * @param sortOptions - опции сортировки (если есть)
+ * @param text - основной текст (slug, имя и т.д.)
+ * @param secondText - второй подставляемый текст
+ * @param thirdText - третий подставляемый текст
+ * @param fourthText - четвёртый подставляемый текст
+ */
 export function useMeta(t, page: string, brandName: string, sortOptions?: IChipsItem[], text?: Ref<string>, secondText?: Ref<string>, thirdText?: Ref<string>, fourthText?: Ref<string>) {
     const route = useRoute();
 

package/composables/use-model-filter-chips.ts

@@ -3,6 +3,12 @@ import type { LocationQuery } from '#vue-router'
 import { getMonth } from '../runtime'
 import type { Ref } from 'vue';
 
+/**
+ * Формирует вычисляемый список чипсов из активных filter_* параметров в query маршрута.
+ * @param filters - список схем фильтров модели
+ * @param route - текущий маршрут с query
+ * @param t - функция перевода (i18n)
+ */
 export function useFilterChipsItems(
   filters: Ref<IModelFilter[]>,
   route: { query: LocationQuery },

package/composables/use-playlist-add.ts

@@ -2,6 +2,7 @@ import type { Ref } from 'vue';
 import type { IVideoData, IVideoCard } from '../types';
 import { EAuthSteps } from '../runtime';
 
+/** Управляет состоянием попапа добавления видео в плейлист; при неавторизованном пользователе открывает попап авторизации. */
 export const usePlaylistAdd = () => {
   const videoCard = useState<IVideoCard | IVideoData | null>('playlist-add-card', () => null);
   const isPlaylistAdd = useState('playlist-add-open', () => false);

package/composables/use-playlist-edit.ts

@@ -1,6 +1,7 @@
 import { EPlaylistStep } from '../runtime';
 import type { IVideoCard, IPlaylistCard } from '../types';
 
+/** Управляет состоянием попапа редактирования плейлиста: шаги EPlaylistStep, выбранный плейлист, возврат назад. */
 export const usePlaylistEdit = () => {
   const deletedVideo = useState<IVideoCard | null | undefined>('playlist-edit-deleted-video', () => null);
   const selectedPlaylist = useState<IPlaylistCard | undefined>('playlist-edit-selected', () => undefined);

package/composables/use-recaptcha.ts

@@ -2,6 +2,7 @@
 
 import { useRuntimeConfig } from '#imports';
 
+/** Управляет загрузкой reCAPTCHA v3 и получением токенов; загружает скрипт лениво при первом вызове initRecaptcha. */
 export function useRecaptcha() {
   let recaptchaLoaded = false;
   let siteKey: string | null = null;

package/composables/use-report-popup.ts

@@ -1,5 +1,6 @@
 import type { IVideoCard } from '../types';
 
+/** Управляет состоянием попапа жалобы на видео. */
 export const useReportPopup = () => {
     const isReportPopupOpen = useState('report-popup-open', () => false);
     const reportedVideoCard = useState<IVideoCard>('report-popup-card', () => ({} as IVideoCard));

package/composables/use-seo-links.ts

@@ -5,6 +5,13 @@ type I18nMock = {
 
 type LocalePathMock = (path: string, localeCode: string) => string;
 
+/**
+ * Генерирует canonical URL и hreflang alternate-ссылки для всех локалей с сохранением допустимых query-параметров.
+ * @param baseDomain - базовый домен (например 'https://example.com')
+ * @param alonePage - если true, параметр sort исключается из URL
+ * @param i18n - объект i18n с locale и locales
+ * @param localePath - функция для генерации пути с локалью
+ */
 export const useSeoLinks = (baseDomain: string, alonePage: boolean = false, i18n: I18nMock, localePath: LocalePathMock) => {
     const route = useRoute();
 

package/composables/use-slug.ts

@@ -1,6 +1,10 @@
 import { useRoute } from 'vue-router';
 import { convertString } from '../runtime';
 
+/**
+ * Возвращает вычисляемый slug из параметров маршрута, декодированный через fromSlug.
+ * @param value - имя параметра маршрута (по умолчанию 'slug')
+ */
 export function useSlug(value = 'slug') {
   const route = useRoute();
 

package/composables/use-snackbar.ts

@@ -5,6 +5,7 @@ const ERROR_TIME = 4000;
 
 let _timeoutClosure: null | ReturnType<typeof setTimeout> = null;
 
+/** Управляет состоянием snackbar-уведомления: показ ошибки, сброс, тема, иконка и таймер. */
 export const useSnackbar = () => {
   const snackbarIcon = useState('snackbar-icon', () => 'check');
   const snackbarText = useState('snackbar-text', () => '');

package/composables/use-units.ts

@@ -1,5 +1,6 @@
 const imperialCountries = new Set(['us', 'lr', 'mm']);
 
+/** Возвращает текущую систему мер (metric/imperial) и список скрытых параметров; сохраняет выбор в localStorage. */
 export function useUnits() {
   const clientCountryCode = useState<string>('clientCountryCode', () => '');
   const savedUnits = import.meta.client ? localStorage.getItem('units') : null;

package/composables/use-user.ts

@@ -18,6 +18,10 @@ function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K
   return result;
 }
 
+/**
+ * Управляет авторизацией и профилем пользователя: регистрация, вход, выход, смена пароля/email, обновление профиля.
+ * @param apiService - сервис для API-запросов
+ */
 export const useUser = (apiService) => {
   const { snackbarText, snackbarTheme, showErrorSnack } = useSnackbar();
   const register = async (form: IRegistrateForm) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.720",
+  "version": "0.0.722",
   "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,