itube-specs 0.0.782 → 0.0.784

package/README.md

@@ -37,11 +37,20 @@ runtime-хелперы, типы и lib-данные. Приложения ра
 
 Правим слой прямо здесь (по `LAYER_PATH`), затем `npm run patch` + `npm run spec` в приложении.
 
-Чтобы видеть изменения без публикации — **локальный оверрайд** в приложении: копируем компонент/composable
-в проект по **тому же относительному пути** (`components/<...>.vue` / `composables/<...>.ts`), `npx nuxi prepare`
-— копия перекрывает слой на рантайме (приложение выше слоя по приоритету; при `pathPrefix` имя совпадает
-со слоевым). Правим копию, после — переносим в слой, `npm run patch` + `npm run spec`, копию удаляем.
-Импорты в копии чиним на пакетные (`itube-specs/runtime|types|lib|services|utils`).
+Приоритет авто-импорта в приложении: `*-debug` > проектные `components/`/`composables/` > слой.
+
+**Постоянная кастомизация:** приложение может завести файл с **тем же именем**, что сущность слоя
+(напр. `<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`). **Дисциплина: держать пусто, когда нет активной задачи** —
+копия перекрывает слой только для одного проекта, правки должны уходить в слой и расходиться на все форки.
 
 Для мелких утилит/runtime можно и грубее — временный disk-импорт с диска
 (`import { test } from '../../../../specs/runtime/utils'`), только для локальной отладки, в коммит не идёт.

package/components/player/core.vue

@@ -59,19 +59,21 @@ let advancing = false;
 
 function onAdvanceRequest(payload: AdvanceRequest): void {
   if (payload.direction === 'previous') return;
-  // Автопереход по окончании — только при включённом тумблере Autoplay.
-  if (payload.direction === 'ended' && playerRef.value?.player && !playerRef.value.player.autoAdvance) return;
-
+  // Переключаемся всегда (грузим следующий ролик); автоплей решаем в onSourceChange.
   advancing = true;
   emit('advance', payload);
 }
 
-// player.load() сам не стартует воспроизведение. Доигрываем play() по sourcechange, но
-// только если свап — следствие нашего перехода (иначе левый автоплей при смене превью).
+// player.load() сам не стартует воспроизведение. По sourcechange после нашего перехода
+// доигрываем play() — но только при включённом тумблере Autoplay. Выключен → следующий
+// ролик (и по next, и по окончании) только загружается и ждёт play от пользователя.
 function onSourceChange(): void {
   if (!advancing) return;
   advancing = false;
-  playerRef.value?.player?.play();
+
+  if (playerRef.value?.player?.autoAdvance) {
+    playerRef.value.player.play();
+  }
 }
 
 // Наша иконка play (public/img/play.svg) — для опции icons плеер ждёт сырой <svg>.

package/composables/use-lang.ts

@@ -1,6 +1,9 @@
-/** Возвращает код текущей локали с учётом алиасов (zh → ch). */
+/** Возвращает код текущей локали с учётом алиасов (zh → ch).
+ * Локаль берётся из глобального инстанса i18n (`useNuxtApp().$i18n`), а не из `useI18n()`,
+ * чтобы функцию можно было безопасно вызывать вне setup-контекста (watch/async-колбэки):
+ * `useI18n()` вне setup кидает MUST_BE_CALL_SETUP_TOP. */
 export const useLang = () => {
-    const lang = useI18n().locale.value;
+    const lang = useNuxtApp().$i18n.locale.value;
     const anotherCode: Record<string, string> = {
         zh: 'ch',
     };

package/package.json

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