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