@mobilon-dev/chotto 0.3.108 → 0.3.110

package/README.md

@@ -46,7 +46,7 @@
 ### 🎯 **Продвинутые функции**
 - 🔍 **Поиск по сообщениям** с подсветкой результатов
 - 📱 **Адаптивные макеты** для всех устройств
-- 🎨 **3 готовые темы**: светлая, темная, зеленая
+- 🎨 **5 готовых тем**: светлая, темная, glass, зеленая, Mobilon1
 - 🌍 **Многоязычность**: русский и английский
 - 🔔 **Система уведомлений** в реальном времени
 - 📊 **Просмотры сообщений** с счетчиками
@@ -128,6 +128,7 @@ import '@mobilon-dev/chotto/style.css'
 // Если нужна конкретная тема, можно импортировать отдельно:
 import '@mobilon-dev/chotto/themes/default.css'
 import '@mobilon-dev/chotto/themes/dark.css'
+import '@mobilon-dev/chotto/themes/glass.css'
 import '@mobilon-dev/chotto/themes/green.css'
 import '@mobilon-dev/chotto/themes/mobilon1.css'
 
@@ -167,6 +168,18 @@ npm run lint
 npm run lint-fix
 ```
 
+### Автотесты
+```bash
+npm test              # unit / component (Vitest)
+npm run test:watch    # watch-режим
+npm run test:coverage # coverage для functions / validators / uploadFile
+npm run test:e2e      # E2E Playwright (сам поднимает vite dev на :5173)
+npm run test:e2e:ui   # Playwright UI mode
+npm run validate-themes
+```
+
+Тесты лежат в `__tests__` рядом с модулями (например `src/functions/__tests__/`). E2E — в `e2e/`, против демо `MobilonExtendedChatApp` (`/?e2e=1` отключает фейковые server-push). Демо-apps (`src/apps`) и Storybook stories в unit-прогон не входят.
+
 ## 🏗️ Архитектура
 
 ```
@@ -195,7 +208,7 @@ src/
 │   └── validators/             # Валидаторы
 ├── functions/                  # Утилитарные функции
 ├── types/                      # TypeScript типы и интерфейсы
-├── themes/                     # Система тем (default, dark, green, mobilon1)
+├── themes/                     # Система тем (default, dark, glass, green, mobilon1)
 ├── locale/                     # Локализация (EN, RU)
 └── utils/                      # Вспомогательные утилиты
 ```
@@ -204,7 +217,8 @@ src/
 
 ```
 .storybook/           # Storybook конфигурация (если используется)
-docs/                 # Документация (ARCHITECTURE.md, ARCHITECTURE_ANALYSIS.md, etc.)
+docs/                 # Markdown-документация (ARCHITECTURE.md и др.)
+storybook-static/     # Сборка Storybook (`npm run build-storybook`)
 scripts/              # Скрипты валидации тем и утилиты
 dist/                 # Собранная библиотека (результат сборки)
 ```
@@ -213,7 +227,8 @@ dist/                 # Собранная библиотека (результ
 
 ### Доступные темы
 - **Default** - светлая тема
-- **Dark** - темная тема  
+- **Dark** - темная тема
+- **Glass** - полупрозрачная glass-тема
 - **Green** - зеленая тема
 - **Mobilon1** - брендовая тема Mobilon
 
@@ -225,6 +240,7 @@ dist/                 # Собранная библиотека (результ
 // Импорт конкретной темы
 import '@mobilon-dev/chotto/themes/default.css'
 import '@mobilon-dev/chotto/themes/dark.css'
+import '@mobilon-dev/chotto/themes/glass.css'
 import '@mobilon-dev/chotto/themes/green.css'
 import '@mobilon-dev/chotto/themes/mobilon1.css'
 ```
@@ -283,7 +299,7 @@ import '@mobilon-dev/chotto/themes/mobilon1.css'
 - ✅ Можно использовать глобальные переменные темы: `var(--chotto-theme-primary-color)`
 - ✅ Полная типизация через TypeScript интерфейсы
 
-**Доступные значения `data-theme`:** `"default"`, `"dark"`, `"green"`, `"mobilon1"`
+**Доступные значения `data-theme`:** `"default"`, `"dark"`, `"glass"`, `"green"`, `"mobilon1"`
 
 Полный список глобальных переменных доступен в типе `ChottoThemeVariables` из `@mobilon-dev/chotto`. Переменные компонентов типизированы в интерфейсах вида `ComponentNameThemeCSSVariables` в соответствующих компонентах.
 
@@ -332,6 +348,41 @@ console.log(t('component.ChatInput.InputPlaceholder'))
 }
 ```
 
+## 📎 Загрузка файлов
+
+Рекомендуемый путь — injectable `uploader` (prop или `provide(chottoUploadFileKey)`).
+
+`filebump-url` / default adapter `POST {filebumpUrl}/upload` — **deprecated**, сохранён для совместимости до следующего major.
+
+Приоритет: prop `uploader` → `inject(chottoUploadFileKey)` → legacy `filebump-url`.
+
+```vue
+<script setup>
+import { FileUploader, type ChottoUploadFileFn } from '@mobilon-dev/chotto'
+
+const uploadFile: ChottoUploadFileFn = async (file, meta) => {
+  // meta.kind: 'file' | 'audio' | 'video'
+  return hostUpload(file, meta) // { url, filename }
+}
+</script>
+
+<template>
+  <FileUploader :uploader="uploadFile" />
+  <!-- filebump-url не нужен, если передан uploader -->
+</template>
+```
+
+Чтобы recorder’ы в слотах `ChatInput` использовали тот же adapter:
+
+```ts
+import { provide } from 'vue'
+import { chottoUploadFileKey } from '@mobilon-dev/chotto'
+
+provide(chottoUploadFileKey, uploadFile)
+```
+
+Без `uploader` и без `filebump-url` загрузка не выполняется (ошибка в консоли, сообщение не отправляется). Prop `filebump-url` deprecated: для новых интеграций используйте `uploader` / `provide`.
+
 ## 🔌 Интеграция с бэкендом
 
 ### Data Provider