itube-specs 0.0.861 → 0.0.863

package/README.md

@@ -61,11 +61,15 @@ npm run lint         # ESLint (гейтит на ноль варнингов)
 npm run lint:fix     # ESLint --fix
 npm run lint:css     # Stylelint по **/*.{scss,vue}
 npm run lint:css:fix # Stylelint --fix
+npm run check:themes # сверяет наборы имён токенов во всех темах
+npm run check:styles # компилирует стили каждого SFC каждой темой (~1.5s)
 npm run test         # vitest однократно
 npm run patch        # npm version patch — бамп версии перед публикацией
 ```
 
 Pre-commit (husky + lint-staged): на закоммиченных файлах прогоняются `eslint --fix` и `stylelint --fix`.
+Если в коммите есть `assets/scss/themes/**`, гоняется `check:themes`; если любой `.vue` или `assets/scss/**` —
+`check:styles`. Оба есть и в CI, в шаге Lint.
 ⚠️ **Шаблоны `.vue` не типизируются вообще.** Обычный `tsc` их не читает, а `vue-tsc` не подключён (накопился
 бэклог ошибок в шаблонах, подключение — отдельная задача). Значит чистый `tsc` ничего не говорит про выражения
 в шаблоне: арифметика над строковым union, неверный тип пропа, переименованное поле пройдут молча.
@@ -126,8 +130,15 @@ assets/scss/themes/dark/_theme.scss
 `loadPaths`). Это точка пер-сайтовой темизации.
 
 **Все токены обязаны быть во всех темах.** Отсутствующий токен — жёсткая ошибка Sass в момент, когда
-тема выбрана, то есть падает вся сборка сайта, а не «поехал цвет». Сверять набор имён после любой
-правки темы.
+тема выбрана, то есть падает вся сборка сайта, а не «поехал цвет». Это гейтит `npm run check:themes`
+(pre-commit при правке тем + CI). Сверяются только верхнеуровневые `$name:`, поэтому начинка
+`$surfaces` / `$button-variant-overrides` игнорируется — она по замыслу разная.
+
+Паритет доказывает лишь то, что темы согласованы **между собой**. Токен, использованный в компоненте, но не
+заведённый **ни в одной** теме, эту проверку пройдёт и всё равно уронит сборку — для этого есть
+`npm run check:styles`: он достаёт каждый `<style lang="scss">`, приписывает тот же `@use`-префикс, что
+подставляет приложение, и компилирует по разу на тему. То же, что делает Vite, — значит ловит и неизвестные
+миксины, и неверные аргументы `@include`, и показывает, в какой теме падает.
 
 Контекстные различия (контрол внутри попапа, вариант кнопки, зависящий от темы) решают миксины
 `surface()` и `button-variant()` из `mixins/`: место объявляет себя, а значения даёт тема через карты
@@ -178,9 +189,9 @@ ad-конфиг), теперь читается из `runtimeConfig.public` (з
 - **Компоненты** — `pathPrefix: true`: имя = папка + файл (`ui/icon.vue` → `<UiIcon>`), BEM-класс = kebab
   тега. Корень папки — `index.vue` (или `main.vue`, если иначе имя было бы односложным).
 - **`as const`** вместо `enum` — доменные наборы в `runtime/constants/`, тип через
-  `typeof X[keyof typeof X]`. В enum не положить строку из API, он остаётся в бандле, и в
-  опубликованном пакете `import type` на нём ломается в рантайме. Фреймворковые union'ы не
-  оборачивать. Подробнее — в [CLAUDE.md](./CLAUDE.md).
+  `typeof X[keyof typeof X]`, значения строковые. Enum остаётся в бандле, в опубликованном пакете
+  `import type` на нём ломается в рантайме, а там, где значение приходит из API/URL/куки, сырую строку
+  в него не положить. Фреймворковые union'ы не оборачивать. Подробнее — в [CLAUDE.md](./CLAUDE.md).
 - **Стили** — co-location в `<style lang="scss">` без `scoped`, flat-BEM, только дизайн-токены.
   `vars` и `mixins` **авто-инжектятся** через `additionalData` приложения, поэтому в блоке компонента
   `@use` писать не надо. Сам `sass` в слое не установлен — SCSS компилируется внутри приложения, но

package/assets/scss/mixins/_surface.scss

@@ -64,16 +64,18 @@ $surface-roles: (
 
   $overrides: map.get($surfaces, $name);
 
-  @each $role, $value in if($overrides, $overrides, ()) {
-    $props: map.get($surface-roles, $role);
+  @if $overrides {
+    @each $role, $value in $overrides {
+      $props: map.get($surface-roles, $role);
 
-    @if not $props {
-      @error 'surface(#{$name}): неизвестная роль `#{$role}`. Допустимые: #{map.keys($surface-roles)}';
-    }
+      @if not $props {
+        @error 'surface(#{$name}): неизвестная роль `#{$role}`. Допустимые: #{map.keys($surface-roles)}';
+      }
 
-    @if $value {
-      @each $prop in $props {
-        #{$prop}: #{$value};
+      @if $value {
+        @each $prop in $props {
+          #{$prop}: #{$value};
+        }
       }
     }
   }

package/components/player/playlist.vue

@@ -142,8 +142,7 @@
 
 <script setup lang="ts">
 import type { IVideoCard, IPlaylistCard, IProfileData } from '../../types';
-import type { PlaylistType } from '../../runtime';
-import { AuthSteps, PlaylistStep } from '../../runtime';
+import { AuthSteps, PlaylistStep, PlaylistType } from '../../runtime';
 import { AuthorizationApiService } from '../../services/api/authorization.service';
 
 const props = defineProps<{
@@ -167,7 +166,7 @@ const sharePlaylistCard = computed<IPlaylistCard>(() => ({
   videosCount: props.items.length,
   thumbUrls: props.items.slice(0, 4).map(item => item.thumbUrls || { webp: {} }),
   created: 0,
-  playlistType: 'public' as unknown as PlaylistType,
+  playlistType: PlaylistType.Public,
 }));
 
 const { isAuthorized } = useUser(AuthorizationApiService);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.861",
+  "version": "0.0.863",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {
@@ -11,6 +11,8 @@
     "lint:fix": "eslint . --fix",
     "lint:css": "stylelint \"**/*.{scss,vue}\" --max-warnings=0 --allow-empty-input",
     "lint:css:fix": "stylelint \"**/*.{scss,vue}\" --fix --allow-empty-input",
+    "check:themes": "node scripts/check-themes.mjs",
+    "check:styles": "node scripts/check-styles.mjs",
     "test": "NODE_OPTIONS='--no-warnings' vitest",
     "prepare": "husky"
   },
@@ -69,26 +71,27 @@
   ],
   "devDependencies": {
     "@intlify/eslint-plugin-vue-i18n": "^4.5.1",
-    "@nuxt/eslint": "latest",
+    "@nuxt/eslint": "^1.16.0",
     "@nuxt/icon": "1.15.0",
     "@nuxt/test-utils": "^3.23.0",
     "@nuxtjs/i18n": "9.5.6",
     "@types/node": "^20.19.19",
-    "@vue/test-utils": "^2.4.6",
-    "eslint": "^9.37.0",
+    "@vue/test-utils": "^2.4.11",
+    "eslint": "^9.39.5",
     "happy-dom": "^18.0.1",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.7",
     "nuxt": "^3.21.8",
     "postcss-html": "^1.8.1",
+    "sass": "^1.102.0",
     "stylelint": "^17.13.0",
     "stylelint-config-standard-scss": "^17.0.0",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4",
+    "vitest": "^3.2.7",
     "vue": "3.5.17"
   },
   "dependencies": {
-    "@sentry/nuxt": "^10.53.1",
+    "@sentry/nuxt": "^10.69.0",
     "@vueform/slider": "2.1.10",
     "@vueuse/core": "12.8.2"
   }

package/runtime/utils/server/server-api-helper.ts

@@ -17,7 +17,7 @@ export class ServerApiHelper {
       });
       return response.data;
     } catch (error: any) {
-      throw new Error(`Cannot fetch ${url}: ${error?.data ?? error?.message ?? error}`);
+      throw new Error(`Cannot fetch ${url}: ${error?.data ?? error?.message ?? error}`, { cause: error });
     }
   }
 }