itube-specs 0.0.794 → 0.0.796

package/README.md

@@ -21,39 +21,32 @@ runtime-хелперы, типы и lib-данные. Приложения ра
 
 ## Как работать со слоем
 
-Слой публикуется в npm, приложения используют **опубликованную** копию (`node_modules/itube-specs`).
-**Локальные правки не видны приложению, пока не опубликована новая версия.**
+Слой публикуется в npm, прод/CI собираются с **опубликованной** копии (`node_modules/itube-specs`).
+Локально приложение подсасывает слой напрямую через симлинк — правки видны сразу, без публикации.
 
-1. Коммитим правки в слое.
-2. `npm run patch` — патчим версию → пуш → мерж.
-3. В проекте: `npm run spec` (`npm install itube-specs@latest`), при необходимости `npx nuxi prepare`
-   (если не подхватились автоимпорты composables/компонентов).
-4. При runtime-проблемах — `npm run dev` в слое перегенерит `tsconfig` и `eslint.config.mjs`.
+### Локальная разработка (авто-линк из приложения)
 
-> **npm install и другие команды, меняющие зависимости, в этом репозитории не запускаем** — зависимости
-> и публикацию ведёт мейнтейнер вручную. Править `package.json` можно, ставить пакеты — нет.
+В приложении `npm run dev` перед стартом (хук `predev`) вешает симлинк
+`node_modules/itube-specs` → `LAYER_PATH` (путь берётся из `.env` приложения). Дальше:
 
-### Отладка из приложения
+1. Правим слой прямо здесь (по `LAYER_PATH`) — изменения видны на локалке приложения сразу (HMR),
+   cmd+click по сущностям слоя ведёт в эти исходники.
+2. Правки готовы: коммит в слое → `npm run patch` → пуш → мерж → публикация.
+3. В приложении: `npm run spec` (`npm install itube-specs@latest`) тянет опубликованную версию
+   (симлинк заменяется реальным пакетом), коммит, пуш на прод.
 
-Правим слой прямо здесь (по `LAYER_PATH`), затем `npm run patch` + `npm run spec` в приложении.
+`npm run dev:published` в приложении — дев против опубликованной версии, минуя авто-линк.
 
-Приоритет авто-импорта в приложении: `*-debug` > проектные `components/`/`composables/` > слой.
+> **npm install и другие команды, меняющие зависимости, в этом репозитории не запускаем** — зависимости
+> и публикацию ведёт мейнтейнер вручную. Править `package.json` можно, ставить пакеты — нет.
 
-**Постоянная кастомизация:** приложение может завести файл с **тем же именем**, что сущность слоя
-(напр. `<UiBtn>`), в своих `components/`/`composables/` — победит проектный (он выше слоя). Так форк
-меняет вёрстку/логику под себя **без переименования**. Осмысленно: если разницу решает пропс — делать
-пропсом, а не форкать весь компонент.
+### Проектные оверрайды
 
-**Отладка слоя:** копируем сущность слоя в `components-debug/` / `composables-debug/` приложения
-(без сегмента `components/`/`composables/` слоевого пути), `npx nuxi prepare` — копия перекрывает слой
-(отдельные авто-корни, наивысший приоритет). При необходимости оверрайд можно закоммитить и выкатить
-в бой для отладки (папки не в git-ignore). Правим, переносим в слой (или скилл `debug-clean`),
-`npm run patch` + `npm run spec`, копию удаляем. Импорты в копии — пакетные
-(`itube-specs/runtime|types|lib|services|utils`). **Дисциплина: держать пусто, когда нет активной задачи** —
-копия перекрывает слой только для одного проекта, правки должны уходить в слой и расходиться на все форки.
+Приоритет авто-импорта в приложении: проектные `components/`/`composables/` > слой.
 
-Для мелких утилит/runtime можно и грубее — временный disk-импорт с диска
-(`import { test } from '../../../../specs/runtime/utils'`), только для локальной отладки, в коммит не идёт.
+Приложение может завести файл с **тем же именем**, что сущность слоя (напр. `<UiBtn>`), в своих
+`components/`/`composables/` — победит проектный (он выше слоя). Так форк меняет вёрстку/логику под себя
+**без переименования**. Осмысленно: если разницу решает пропс — делать пропсом, а не форкать весь компонент.
 
 ---
 

package/composables/fetch/use-fetch-categories-by-letter.ts

@@ -3,22 +3,22 @@ import { AsyncData } from '../../runtime';
 import type { ICategoryCard } from '../../types';
 
 export const useFetchCategoriesByLetter = async (
-    apiMethod: (...args: any[]) => Promise<Array<ICategoryCard>>
+  apiMethod: (...args: any[]) => Promise<Array<ICategoryCard>>
 ) => {
-    const key = AsyncData.CategoriesByLetter;
-    const lang = useLang() as Language;
-    const slug = useSlug();
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const key = AsyncData.CategoriesByLetter;
+  const lang = useLang() as Language;
+  const slug = useSlug();
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<Array<ICategoryCard>>(
-        stateKey.value,
-        () => useApiFetcher<Array<ICategoryCard>>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            slug.value,
-        )()
-    );
+  const { data, status, error } = await useAsyncData<Array<ICategoryCard>>(
+    stateKey.value,
+    () => useApiFetcher<Array<ICategoryCard>>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      slug.value,
+    )()
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-categories-by-phrase.ts

@@ -3,25 +3,25 @@ import { AsyncData } from '../../runtime';
 import type { IChipsItem } from '../../types';
 
 export const useFetchCategoriesByPhrase = async (
-    apiMethod: (...args: any[]) => Promise<Array<IChipsItem>>
+  apiMethod: (...args: any[]) => Promise<Array<IChipsItem>>
 ) => {
-    const key = AsyncData.CategoriesByPhrase;
-    const lang = useLang() as Language;
-    const slug = useSlug();
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const key = AsyncData.CategoriesByPhrase;
+  const lang = useLang() as Language;
+  const slug = useSlug();
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<Array<IChipsItem>>(
-        stateKey.value,
-        () => useApiFetcher<Array<IChipsItem>>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            slug.value,
-            1,
-            1,
-            100
-        )()
-    );
+  const { data, status, error } = await useAsyncData<Array<IChipsItem>>(
+    stateKey.value,
+    () => useApiFetcher<Array<IChipsItem>>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      slug.value,
+      1,
+      1,
+      100
+    )()
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-categories-group-by-letter.ts

@@ -2,20 +2,20 @@ import type { AsyncData, Language } from '../../runtime';
 import type { ICategoryCard, IChipsItem } from '../../types';
 
 export const useFetchCategoriesGroupByLetter = async (
-    key: AsyncData,
-    apiMethod: (...args: any[]) => Promise<Record<string, Array<ICategoryCard>>> | Promise<IChipsItem[]>
+  key: AsyncData,
+  apiMethod: (...args: any[]) => Promise<Record<string, Array<ICategoryCard>>> | Promise<IChipsItem[]>
 ) => {
-    const lang = useLang() as Language;
-    const stateKey = computed(() => `data-${key}-${lang}`);
+  const lang = useLang() as Language;
+  const stateKey = computed(() => `data-${key}-${lang}`);
 
-    const { data, error, refresh, status } = await useAsyncData<Record<string, Array<ICategoryCard>> | IChipsItem[]>(
-        key,
-        () => useApiFetcher<Record<string, Array<ICategoryCard>> | IChipsItem[]>(
-            stateKey.value,
-            apiMethod,
-            lang,
-        )(),
-    );
+  const { data, error, refresh, status } = await useAsyncData<Record<string, Array<ICategoryCard>> | IChipsItem[]>(
+    key,
+    () => useApiFetcher<Record<string, Array<ICategoryCard>> | IChipsItem[]>(
+      stateKey.value,
+      apiMethod,
+      lang,
+    )(),
+  );
 
-    return { data, error, refresh, status };
+  return { data, error, refresh, status };
 };

package/composables/fetch/use-fetch-channels-by-model.ts

@@ -3,25 +3,25 @@ import { AsyncData } from '../../runtime';
 import type { IChannelCard, PaginatedResponse } from '../../types';
 
 export const useFetchChannelsByModel = async (
-    apiMethod: (...args: any[]) => Promise<PaginatedResponse<IChannelCard>>
+  apiMethod: (...args: any[]) => Promise<PaginatedResponse<IChannelCard>>
 ) => {
-    const lang = useLang() as Language;
-    const slug = useSlug();
-    const key = AsyncData.ChannelsByModel;
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const lang = useLang() as Language;
+  const slug = useSlug();
+  const key = AsyncData.ChannelsByModel;
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<PaginatedResponse<IChannelCard>>(
-        stateKey.value,
-        () => useApiFetcher<PaginatedResponse<IChannelCard>>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            {
-                page: 1,
-            },
-            slug.value,
-        )(),
-    );
+  const { data, status, error } = await useAsyncData<PaginatedResponse<IChannelCard>>(
+    stateKey.value,
+    () => useApiFetcher<PaginatedResponse<IChannelCard>>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      {
+        page: 1,
+      },
+      slug.value,
+    )(),
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-channels-by-name.ts

@@ -3,22 +3,22 @@ import { AsyncData } from '../../runtime';
 import type { ICardInfo } from '../../types';
 
 export const useFetchChannelsByName = async (
-    apiMethod: (...args: any[]) => Promise<ICardInfo>
+  apiMethod: (...args: any[]) => Promise<ICardInfo>
 ) => {
-    const lang = useLang() as Language;
-    const slug = useSlug('channel');
-    const key = AsyncData.ChannelByName;
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const lang = useLang() as Language;
+  const slug = useSlug('channel');
+  const key = AsyncData.ChannelByName;
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<ICardInfo>(
-        stateKey.value,
-        () => useApiFetcher<ICardInfo>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            slug.value,
-        )()
-    );
+  const { data, status, error } = await useAsyncData<ICardInfo>(
+    stateKey.value,
+    () => useApiFetcher<ICardInfo>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      slug.value,
+    )()
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-channels-by-network-name.ts

@@ -4,37 +4,37 @@ import { AsyncData } from '../../runtime';
 import type { IChannelCard, PaginatedResponse } from '../../types';
 
 export const useFetchChannelsByNetworkName = async (
-    apiMethod: (...args: any[]) => Promise<PaginatedResponse<IChannelCard>>
+  apiMethod: (...args: any[]) => Promise<PaginatedResponse<IChannelCard>>
 ) => {
-    const lang = useLang() as Language;
-    const route = useRoute();
-    const mobile = !!useState<boolean>('isMobile').value;
-    const perPage = mobile ? 12 : 48;
-    const slug = useSlug('channel');
-    const key = AsyncData.ChannelsByNetworkName;
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const lang = useLang() as Language;
+  const route = useRoute();
+  const mobile = !!useState<boolean>('isMobile').value;
+  const perPage = mobile ? 12 : 48;
+  const slug = useSlug('channel');
+  const key = AsyncData.ChannelsByNetworkName;
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<PaginatedResponse<IChannelCard>>(
-        stateKey.value,
-        () => useApiFetcher<PaginatedResponse<IChannelCard>>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            {
-                page: Number(route.query['page']) || 1,
-                'per-page': perPage,
-            },
-            slug.value,
-        )(),
-        {
-            watch: [
-                () => {
-                    const currentQuery = route.query;
-                    return JSON.stringify(currentQuery);
-                },
-            ],
-        }
-    );
+  const { data, status, error } = await useAsyncData<PaginatedResponse<IChannelCard>>(
+    stateKey.value,
+    () => useApiFetcher<PaginatedResponse<IChannelCard>>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      {
+        page: Number(route.query['page']) || 1,
+        'per-page': perPage,
+      },
+      slug.value,
+    )(),
+    {
+      watch: [
+        () => {
+          const currentQuery = route.query;
+          return JSON.stringify(currentQuery);
+        },
+      ],
+    }
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-channels.ts

@@ -5,38 +5,38 @@ import { sortChannels } from '../../lib';
 import type { IChannelCard, PaginatedResponse } from '../../types';
 
 export const useFetchChannels = async (
-    apiMethod: (...args: any[]) => Promise<PaginatedResponse<IChannelCard>>
+  apiMethod: (...args: any[]) => Promise<PaginatedResponse<IChannelCard>>
 ) => {
-    const route = useRoute();
-    const mobile = !!useState<boolean>('isMobile').value;
-    const perPage = mobile ? 12 : 48;
-    const lang = useLang() as Language;
-    const key = AsyncData.Channels;
-    const stateKey = computed(() => `data-${key}-${JSON.stringify(route.query)}-${lang}`);
+  const route = useRoute();
+  const mobile = !!useState<boolean>('isMobile').value;
+  const perPage = mobile ? 12 : 48;
+  const lang = useLang() as Language;
+  const key = AsyncData.Channels;
+  const stateKey = computed(() => `data-${key}-${JSON.stringify(route.query)}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<PaginatedResponse<IChannelCard>>(
-        key,
-        () => useApiFetcher<PaginatedResponse<IChannelCard>>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            {
-                page: Number(route.query['page']) || 1,
-                'per-page': perPage,
-            },
-            getSelectedQuery(route, sortChannels) || '-popularity',
-        )(),
-        {
-            watch: [
-                () => {
-                    if (route.query) {
-                        const currentQuery = route.query;
-                        return JSON.stringify(currentQuery);
-                    }
-                },
-            ],
-        }
-    );
+  const { data, status, error } = await useAsyncData<PaginatedResponse<IChannelCard>>(
+    key,
+    () => useApiFetcher<PaginatedResponse<IChannelCard>>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      {
+        page: Number(route.query['page']) || 1,
+        'per-page': perPage,
+      },
+      getSelectedQuery(route, sortChannels) || '-popularity',
+    )(),
+    {
+      watch: [
+        () => {
+          if (route.query) {
+            const currentQuery = route.query;
+            return JSON.stringify(currentQuery);
+          }
+        },
+      ],
+    }
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-dictionaries-countries.ts

@@ -3,20 +3,20 @@ import type { Language } from '../../runtime';
 import { AsyncData } from '../../runtime';
 
 export const useFetchDictionariesCountries = async (
-    apiMethod: (...args: any[]) => Promise<ICountries>
+  apiMethod: (...args: any[]) => Promise<ICountries>
 ) => {
-    const lang = useLang() as Language;
-    const key = AsyncData.Countries;
-    const stateKey = computed(() => `data-${key}-${lang}`);
+  const lang = useLang() as Language;
+  const key = AsyncData.Countries;
+  const stateKey = computed(() => `data-${key}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<ICountries>(
-        key,
-        () => useApiFetcher<ICountries>(
-            stateKey.value,
-            apiMethod,
-            lang,
-        )(),
-    );
+  const { data, status, error } = await useAsyncData<ICountries>(
+    key,
+    () => useApiFetcher<ICountries>(
+      stateKey.value,
+      apiMethod,
+      lang,
+    )(),
+  );
 
-    return { countriesData: data, status, error };
+  return { countriesData: data, status, error };
 };

package/composables/fetch/use-fetch-dictionaries-genders.ts

@@ -3,20 +3,20 @@ import type { Language } from '../../runtime';
 import { AsyncData } from '../../runtime';
 
 export const useFetchDictionariesGenders = async (
-    apiMethod: (...args: any[]) => Promise<IGenders>
+  apiMethod: (...args: any[]) => Promise<IGenders>
 ) => {
-    const lang = useLang() as Language;
-    const key = AsyncData.Genders;
-    const stateKey = computed(() => `data-${key}-${lang}`);
+  const lang = useLang() as Language;
+  const key = AsyncData.Genders;
+  const stateKey = computed(() => `data-${key}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<IGenders>(
-        key,
-        () => useApiFetcher<IGenders>(
-            stateKey.value,
-            apiMethod,
-            lang,
-        )(),
-    );
+  const { data, status, error } = await useAsyncData<IGenders>(
+    key,
+    () => useApiFetcher<IGenders>(
+      stateKey.value,
+      apiMethod,
+      lang,
+    )(),
+  );
 
-    return { gendersData: data, status, error };
+  return { gendersData: data, status, error };
 };

package/composables/fetch/use-fetch-groups-categories-lazy.ts

@@ -2,23 +2,23 @@ import type { Language } from '../../runtime';
 import type { IGroupCategories } from '../../types';
 
 export const useFetchGroupsCategoriesLazy = (
-    apiMethod: (...args: any[]) => Promise<IGroupCategories[]>
+  apiMethod: (...args: any[]) => Promise<IGroupCategories[]>
 ) => {
-    const data = useState<IGroupCategories[] | null>('lazy-groups-categories', () => null);
-    const isLoading = useState<boolean>('lazy-groups-categories-loading', () => false);
-    const lang = useLang() as Language;
+  const data = useState<IGroupCategories[] | null>('lazy-groups-categories', () => null);
+  const isLoading = useState<boolean>('lazy-groups-categories-loading', () => false);
+  const lang = useLang() as Language;
 
-    async function load() {
-        if (data.value?.length || isLoading.value) return;
-        isLoading.value = true;
-        try {
-            data.value = await apiMethod(lang);
-        } catch (err) {
-            console.error('Failed to load groups categories:', err);
-        } finally {
-            isLoading.value = false;
-        }
+  async function load() {
+    if (data.value?.length || isLoading.value) return;
+    isLoading.value = true;
+    try {
+      data.value = await apiMethod(lang);
+    } catch (err) {
+      console.error('Failed to load groups categories:', err);
+    } finally {
+      isLoading.value = false;
     }
+  }
 
-    return { data, isLoading, load };
+  return { data, isLoading, load };
 };

package/composables/fetch/use-fetch-groups-categories.ts

@@ -3,20 +3,20 @@ import { AsyncData } from '../../runtime';
 import type { IGroupCategories } from '../../types';
 
 export const useFetchGroupsCategories = async (
-    apiMethod: (...args: any[]) => Promise<IGroupCategories[]>
+  apiMethod: (...args: any[]) => Promise<IGroupCategories[]>
 ) => {
-    const lang = useLang() as Language;
-    const key = AsyncData.GroupsCategoriesFilter;
-    const stateKey = computed(() => `data-${key}-${lang}`);
+  const lang = useLang() as Language;
+  const key = AsyncData.GroupsCategoriesFilter;
+  const stateKey = computed(() => `data-${key}-${lang}`);
 
-    const { data, pending: status, error } = await useAsyncData<IGroupCategories[]>(
-        key,
-        () => useApiFetcher<IGroupCategories[]>(
-            stateKey.value,
-            apiMethod,
-            lang,
-        )(),
-    );
+  const { data, pending: status, error } = await useAsyncData<IGroupCategories[]>(
+    key,
+    () => useApiFetcher<IGroupCategories[]>(
+      stateKey.value,
+      apiMethod,
+      lang,
+    )(),
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-model-by-name.ts

@@ -3,22 +3,22 @@ import { AsyncData } from '../../runtime';
 import type { ICardInfo } from '../../types';
 
 export const useFetchModelByName = async (
-    apiMethod: (...args: any[]) => Promise<ICardInfo>
+  apiMethod: (...args: any[]) => Promise<ICardInfo>
 ) => {
-    const lang = useLang() as Language;
-    const slug = useSlug();
-    const key = AsyncData.ModelsByName;
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const lang = useLang() as Language;
+  const slug = useSlug();
+  const key = AsyncData.ModelsByName;
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status, error } = await useAsyncData<ICardInfo>(
-        stateKey.value,
-        () => useApiFetcher<ICardInfo>(
-            stateKey.value,
-            apiMethod,
-            lang,
-            slug.value,
-        )()
-    );
+  const { data, status, error } = await useAsyncData<ICardInfo>(
+    stateKey.value,
+    () => useApiFetcher<ICardInfo>(
+      stateKey.value,
+      apiMethod,
+      lang,
+      slug.value,
+    )()
+  );
 
-    return { data, status, error };
+  return { data, status, error };
 };

package/composables/fetch/use-fetch-models-by-category.ts

@@ -3,24 +3,24 @@ import { AsyncData } from '../../runtime';
 import type { IModelCard, PaginatedResponse } from '../../types';
 
 export const useFetchModelsByCategory = async (
-    apiMethod: (...args: any[]) => Promise<PaginatedResponse<IModelCard>>,
-    limit: number,
+  apiMethod: (...args: any[]) => Promise<PaginatedResponse<IModelCard>>,
+  limit: number,
 ) => {
-    const lang = useLang() as Language;
-    const slug = useSlug();
-    const key = AsyncData.ModelsByCategory;
-    const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
+  const lang = useLang() as Language;
+  const slug = useSlug();
+  const key = AsyncData.ModelsByCategory;
+  const stateKey = computed(() => `data-${key}-${slug.value}-${lang}`);
 
-    const { data, status } = await useAsyncData<PaginatedResponse<IModelCard>>(
-        stateKey.value,
-        () => useApiFetcher<PaginatedResponse<IModelCard>>(
-            stateKey.value,
-            apiMethod,
-            slug.value,
-            limit,
-            lang,
-        )(),
-    );
+  const { data, status } = await useAsyncData<PaginatedResponse<IModelCard>>(
+    stateKey.value,
+    () => useApiFetcher<PaginatedResponse<IModelCard>>(
+      stateKey.value,
+      apiMethod,
+      slug.value,
+      limit,
+      lang,
+    )(),
+  );
 
-    return { data, status };
+  return { data, status };
 };