itube-specs 0.0.721 → 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.721",
+  "version": "0.0.722",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {