@appss/ui 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (284) hide show
  1. package/AGENTS.md +359 -0
  2. package/README.md +255 -2
  3. package/dist/appearances/profiles.d.ts +4 -0
  4. package/dist/appearances/profiles.d.ts.map +1 -0
  5. package/dist/appearances/profiles.js +5 -0
  6. package/dist/appearances/profiles.js.map +1 -0
  7. package/dist/appearances/reddit/profile.d.ts +187 -0
  8. package/dist/appearances/reddit/profile.d.ts.map +1 -0
  9. package/dist/appearances/reddit/profile.js +107 -0
  10. package/dist/appearances/reddit/profile.js.map +1 -0
  11. package/dist/appearances/reddit/reddit.module.css.js +240 -0
  12. package/dist/appearances/reddit/reddit.module.css.js.map +1 -0
  13. package/dist/appearances/telegram/profile.d.ts +197 -0
  14. package/dist/appearances/telegram/profile.d.ts.map +1 -0
  15. package/dist/appearances/telegram/profile.js +114 -0
  16. package/dist/appearances/telegram/profile.js.map +1 -0
  17. package/dist/appearances/telegram/telegram.module.css.js +270 -0
  18. package/dist/appearances/telegram/telegram.module.css.js.map +1 -0
  19. package/dist/components/Accordion/Accordion.d.ts +4 -0
  20. package/dist/components/Accordion/Accordion.d.ts.map +1 -0
  21. package/dist/components/Accordion/Accordion.js +91 -0
  22. package/dist/components/Accordion/Accordion.js.map +1 -0
  23. package/dist/components/Accordion/Accordion.module.css.js +30 -0
  24. package/dist/components/Accordion/Accordion.module.css.js.map +1 -0
  25. package/dist/components/Accordion/Accordion.types.d.ts +34 -0
  26. package/dist/components/Accordion/Accordion.types.d.ts.map +1 -0
  27. package/dist/components/Avatar/Avatar.d.ts +4 -0
  28. package/dist/components/Avatar/Avatar.d.ts.map +1 -0
  29. package/dist/components/Avatar/Avatar.js +50 -0
  30. package/dist/components/Avatar/Avatar.js.map +1 -0
  31. package/dist/components/Avatar/Avatar.module.css.js +18 -0
  32. package/dist/components/Avatar/Avatar.module.css.js.map +1 -0
  33. package/dist/components/Avatar/Avatar.types.d.ts +24 -0
  34. package/dist/components/Avatar/Avatar.types.d.ts.map +1 -0
  35. package/dist/components/Banner/Banner.d.ts +3 -0
  36. package/dist/components/Banner/Banner.d.ts.map +1 -0
  37. package/dist/components/Banner/Banner.js +39 -0
  38. package/dist/components/Banner/Banner.js.map +1 -0
  39. package/dist/components/Banner/Banner.module.css.js +24 -0
  40. package/dist/components/Banner/Banner.module.css.js.map +1 -0
  41. package/dist/components/Banner/Banner.types.d.ts +25 -0
  42. package/dist/components/Banner/Banner.types.d.ts.map +1 -0
  43. package/dist/components/BottomNav/BottomNav.d.ts +3 -0
  44. package/dist/components/BottomNav/BottomNav.d.ts.map +1 -0
  45. package/dist/components/BottomNav/BottomNav.js +68 -0
  46. package/dist/components/BottomNav/BottomNav.js.map +1 -0
  47. package/dist/components/BottomNav/BottomNav.module.css.js +24 -0
  48. package/dist/components/BottomNav/BottomNav.module.css.js.map +1 -0
  49. package/dist/components/BottomNav/BottomNav.types.d.ts +35 -0
  50. package/dist/components/BottomNav/BottomNav.types.d.ts.map +1 -0
  51. package/dist/components/Button/Button.d.ts +3 -0
  52. package/dist/components/Button/Button.d.ts.map +1 -0
  53. package/dist/components/Button/Button.js +52 -0
  54. package/dist/components/Button/Button.js.map +1 -0
  55. package/dist/components/Button/Button.module.css.js +24 -0
  56. package/dist/components/Button/Button.module.css.js.map +1 -0
  57. package/dist/components/Button/Button.types.d.ts +23 -0
  58. package/dist/components/Button/Button.types.d.ts.map +1 -0
  59. package/dist/components/Card/Card.d.ts +3 -0
  60. package/dist/components/Card/Card.d.ts.map +1 -0
  61. package/dist/components/Card/Card.js +50 -0
  62. package/dist/components/Card/Card.js.map +1 -0
  63. package/dist/components/Card/Card.module.css.js +21 -0
  64. package/dist/components/Card/Card.module.css.js.map +1 -0
  65. package/dist/components/Card/Card.types.d.ts +23 -0
  66. package/dist/components/Card/Card.types.d.ts.map +1 -0
  67. package/dist/components/ChatListItem/ChatListItem.d.ts +7 -0
  68. package/dist/components/ChatListItem/ChatListItem.d.ts.map +1 -0
  69. package/dist/components/ChatListItem/ChatListItem.js +75 -0
  70. package/dist/components/ChatListItem/ChatListItem.js.map +1 -0
  71. package/dist/components/ChatListItem/ChatListItem.module.css.js +51 -0
  72. package/dist/components/ChatListItem/ChatListItem.module.css.js.map +1 -0
  73. package/dist/components/ChatListItem/ChatListItem.types.d.ts +38 -0
  74. package/dist/components/ChatListItem/ChatListItem.types.d.ts.map +1 -0
  75. package/dist/components/ChatListItem/MessageStatusIcon.d.ts +7 -0
  76. package/dist/components/ChatListItem/MessageStatusIcon.d.ts.map +1 -0
  77. package/dist/components/ChatListItem/MessageStatusIcon.js +18 -0
  78. package/dist/components/ChatListItem/MessageStatusIcon.js.map +1 -0
  79. package/dist/components/Dialog/Dialog.d.ts +4 -0
  80. package/dist/components/Dialog/Dialog.d.ts.map +1 -0
  81. package/dist/components/Dialog/Dialog.js +63 -0
  82. package/dist/components/Dialog/Dialog.js.map +1 -0
  83. package/dist/components/Dialog/Dialog.module.css.js +21 -0
  84. package/dist/components/Dialog/Dialog.module.css.js.map +1 -0
  85. package/dist/components/Dialog/Dialog.types.d.ts +26 -0
  86. package/dist/components/Dialog/Dialog.types.d.ts.map +1 -0
  87. package/dist/components/Divider/Divider.d.ts +3 -0
  88. package/dist/components/Divider/Divider.d.ts.map +1 -0
  89. package/dist/components/Divider/Divider.js +27 -0
  90. package/dist/components/Divider/Divider.js.map +1 -0
  91. package/dist/components/Divider/Divider.module.css.js +9 -0
  92. package/dist/components/Divider/Divider.module.css.js.map +1 -0
  93. package/dist/components/Divider/Divider.types.d.ts +17 -0
  94. package/dist/components/Divider/Divider.types.d.ts.map +1 -0
  95. package/dist/components/IconButton/IconButton.d.ts +3 -0
  96. package/dist/components/IconButton/IconButton.d.ts.map +1 -0
  97. package/dist/components/IconButton/IconButton.js +49 -0
  98. package/dist/components/IconButton/IconButton.js.map +1 -0
  99. package/dist/components/IconButton/IconButton.module.css.js +15 -0
  100. package/dist/components/IconButton/IconButton.module.css.js.map +1 -0
  101. package/dist/components/IconButton/IconButton.types.d.ts +25 -0
  102. package/dist/components/IconButton/IconButton.types.d.ts.map +1 -0
  103. package/dist/components/Likes/Likes.d.ts +4 -0
  104. package/dist/components/Likes/Likes.d.ts.map +1 -0
  105. package/dist/components/Likes/Likes.js +85 -0
  106. package/dist/components/Likes/Likes.js.map +1 -0
  107. package/dist/components/Likes/Likes.module.css.js +18 -0
  108. package/dist/components/Likes/Likes.module.css.js.map +1 -0
  109. package/dist/components/Likes/Likes.types.d.ts +27 -0
  110. package/dist/components/Likes/Likes.types.d.ts.map +1 -0
  111. package/dist/components/Link/Link.d.ts +3 -0
  112. package/dist/components/Link/Link.d.ts.map +1 -0
  113. package/dist/components/Link/Link.js +47 -0
  114. package/dist/components/Link/Link.js.map +1 -0
  115. package/dist/components/Link/Link.module.css.js +15 -0
  116. package/dist/components/Link/Link.module.css.js.map +1 -0
  117. package/dist/components/Link/Link.types.d.ts +22 -0
  118. package/dist/components/Link/Link.types.d.ts.map +1 -0
  119. package/dist/components/Menu/Menu.d.ts +4 -0
  120. package/dist/components/Menu/Menu.d.ts.map +1 -0
  121. package/dist/components/Menu/Menu.js +134 -0
  122. package/dist/components/Menu/Menu.js.map +1 -0
  123. package/dist/components/Menu/Menu.module.css.js +27 -0
  124. package/dist/components/Menu/Menu.module.css.js.map +1 -0
  125. package/dist/components/Menu/Menu.types.d.ts +32 -0
  126. package/dist/components/Menu/Menu.types.d.ts.map +1 -0
  127. package/dist/components/MessageBubble/MessageBubble.d.ts +3 -0
  128. package/dist/components/MessageBubble/MessageBubble.d.ts.map +1 -0
  129. package/dist/components/MessageBubble/MessageBubble.js +85 -0
  130. package/dist/components/MessageBubble/MessageBubble.js.map +1 -0
  131. package/dist/components/MessageBubble/MessageBubble.module.css.js +54 -0
  132. package/dist/components/MessageBubble/MessageBubble.module.css.js.map +1 -0
  133. package/dist/components/MessageBubble/MessageBubble.types.d.ts +54 -0
  134. package/dist/components/MessageBubble/MessageBubble.types.d.ts.map +1 -0
  135. package/dist/components/MessageComposer/MessageComposer.d.ts +3 -0
  136. package/dist/components/MessageComposer/MessageComposer.d.ts.map +1 -0
  137. package/dist/components/MessageComposer/MessageComposer.js +55 -0
  138. package/dist/components/MessageComposer/MessageComposer.js.map +1 -0
  139. package/dist/components/MessageComposer/MessageComposer.module.css.js +24 -0
  140. package/dist/components/MessageComposer/MessageComposer.module.css.js.map +1 -0
  141. package/dist/components/MessageComposer/MessageComposer.types.d.ts +27 -0
  142. package/dist/components/MessageComposer/MessageComposer.types.d.ts.map +1 -0
  143. package/dist/components/MessageDivider/MessageDivider.d.ts +3 -0
  144. package/dist/components/MessageDivider/MessageDivider.d.ts.map +1 -0
  145. package/dist/components/MessageDivider/MessageDivider.js +28 -0
  146. package/dist/components/MessageDivider/MessageDivider.js.map +1 -0
  147. package/dist/components/MessageDivider/MessageDivider.module.css.js +12 -0
  148. package/dist/components/MessageDivider/MessageDivider.module.css.js.map +1 -0
  149. package/dist/components/MessageDivider/MessageDivider.types.d.ts +19 -0
  150. package/dist/components/MessageDivider/MessageDivider.types.d.ts.map +1 -0
  151. package/dist/components/NavBar/NavBar.d.ts +3 -0
  152. package/dist/components/NavBar/NavBar.d.ts.map +1 -0
  153. package/dist/components/NavBar/NavBar.js +42 -0
  154. package/dist/components/NavBar/NavBar.js.map +1 -0
  155. package/dist/components/NavBar/NavBar.module.css.js +24 -0
  156. package/dist/components/NavBar/NavBar.module.css.js.map +1 -0
  157. package/dist/components/NavBar/NavBar.types.d.ts +26 -0
  158. package/dist/components/NavBar/NavBar.types.d.ts.map +1 -0
  159. package/dist/components/NavList/NavList.d.ts +3 -0
  160. package/dist/components/NavList/NavList.d.ts.map +1 -0
  161. package/dist/components/NavList/NavList.js +53 -0
  162. package/dist/components/NavList/NavList.js.map +1 -0
  163. package/dist/components/NavList/NavList.module.css.js +24 -0
  164. package/dist/components/NavList/NavList.module.css.js.map +1 -0
  165. package/dist/components/NavList/NavList.types.d.ts +31 -0
  166. package/dist/components/NavList/NavList.types.d.ts.map +1 -0
  167. package/dist/components/SearchField/SearchField.d.ts +3 -0
  168. package/dist/components/SearchField/SearchField.d.ts.map +1 -0
  169. package/dist/components/SearchField/SearchField.js +38 -0
  170. package/dist/components/SearchField/SearchField.js.map +1 -0
  171. package/dist/components/SearchField/SearchField.module.css.js +18 -0
  172. package/dist/components/SearchField/SearchField.module.css.js.map +1 -0
  173. package/dist/components/SearchField/SearchField.types.d.ts +23 -0
  174. package/dist/components/SearchField/SearchField.types.d.ts.map +1 -0
  175. package/dist/components/Section/Section.d.ts +4 -0
  176. package/dist/components/Section/Section.d.ts.map +1 -0
  177. package/dist/components/Section/Section.js +101 -0
  178. package/dist/components/Section/Section.js.map +1 -0
  179. package/dist/components/Section/Section.module.css.js +36 -0
  180. package/dist/components/Section/Section.module.css.js.map +1 -0
  181. package/dist/components/Section/Section.types.d.ts +36 -0
  182. package/dist/components/Section/Section.types.d.ts.map +1 -0
  183. package/dist/components/Stat/Stat.d.ts +4 -0
  184. package/dist/components/Stat/Stat.d.ts.map +1 -0
  185. package/dist/components/Stat/Stat.js +31 -0
  186. package/dist/components/Stat/Stat.js.map +1 -0
  187. package/dist/components/Stat/Stat.module.css.js +15 -0
  188. package/dist/components/Stat/Stat.module.css.js.map +1 -0
  189. package/dist/components/Stat/Stat.types.d.ts +18 -0
  190. package/dist/components/Stat/Stat.types.d.ts.map +1 -0
  191. package/dist/components/Switch/Switch.d.ts +4 -0
  192. package/dist/components/Switch/Switch.d.ts.map +1 -0
  193. package/dist/components/Switch/Switch.js +45 -0
  194. package/dist/components/Switch/Switch.js.map +1 -0
  195. package/dist/components/Switch/Switch.module.css.js +21 -0
  196. package/dist/components/Switch/Switch.module.css.js.map +1 -0
  197. package/dist/components/Switch/Switch.types.d.ts +19 -0
  198. package/dist/components/Switch/Switch.types.d.ts.map +1 -0
  199. package/dist/components/Tabs/Tabs.d.ts +4 -0
  200. package/dist/components/Tabs/Tabs.d.ts.map +1 -0
  201. package/dist/components/Tabs/Tabs.js +92 -0
  202. package/dist/components/Tabs/Tabs.js.map +1 -0
  203. package/dist/components/Tabs/Tabs.module.css.js +24 -0
  204. package/dist/components/Tabs/Tabs.module.css.js.map +1 -0
  205. package/dist/components/Tabs/Tabs.types.d.ts +31 -0
  206. package/dist/components/Tabs/Tabs.types.d.ts.map +1 -0
  207. package/dist/components/Tag/Tag.d.ts +3 -0
  208. package/dist/components/Tag/Tag.d.ts.map +1 -0
  209. package/dist/components/Tag/Tag.js +33 -0
  210. package/dist/components/Tag/Tag.js.map +1 -0
  211. package/dist/components/Tag/Tag.module.css.js +12 -0
  212. package/dist/components/Tag/Tag.module.css.js.map +1 -0
  213. package/dist/components/Tag/Tag.types.d.ts +20 -0
  214. package/dist/components/Tag/Tag.types.d.ts.map +1 -0
  215. package/dist/components/Tooltip/Tooltip.d.ts +4 -0
  216. package/dist/components/Tooltip/Tooltip.d.ts.map +1 -0
  217. package/dist/components/Tooltip/Tooltip.js +63 -0
  218. package/dist/components/Tooltip/Tooltip.js.map +1 -0
  219. package/dist/components/Tooltip/Tooltip.module.css.js +12 -0
  220. package/dist/components/Tooltip/Tooltip.module.css.js.map +1 -0
  221. package/dist/components/Tooltip/Tooltip.types.d.ts +24 -0
  222. package/dist/components/Tooltip/Tooltip.types.d.ts.map +1 -0
  223. package/dist/core/AppssProvider.d.ts +21 -0
  224. package/dist/core/AppssProvider.d.ts.map +1 -0
  225. package/dist/core/AppssProvider.js +42 -0
  226. package/dist/core/AppssProvider.js.map +1 -0
  227. package/dist/core/appearance.d.ts +28 -0
  228. package/dist/core/appearance.d.ts.map +1 -0
  229. package/dist/core/appearance.js +40 -0
  230. package/dist/core/appearance.js.map +1 -0
  231. package/dist/core/host.d.ts +28 -0
  232. package/dist/core/host.d.ts.map +1 -0
  233. package/dist/core/host.js +42 -0
  234. package/dist/core/host.js.map +1 -0
  235. package/dist/hosts/adapters.d.ts +5 -0
  236. package/dist/hosts/adapters.d.ts.map +1 -0
  237. package/dist/hosts/adapters.js +21 -0
  238. package/dist/hosts/adapters.js.map +1 -0
  239. package/dist/icons/icons.d.ts +164 -0
  240. package/dist/icons/icons.d.ts.map +1 -0
  241. package/dist/icons/icons.js +220 -0
  242. package/dist/icons/icons.js.map +1 -0
  243. package/dist/icons/index.d.ts +2 -0
  244. package/dist/icons/index.d.ts.map +1 -0
  245. package/dist/icons/index.js +43 -0
  246. package/dist/icons/index.js.map +1 -0
  247. package/dist/index.d.ts +57 -0
  248. package/dist/index.d.ts.map +1 -0
  249. package/dist/index.js +61 -0
  250. package/dist/index.js.map +1 -0
  251. package/dist/integrations.d.ts +9 -0
  252. package/dist/integrations.d.ts.map +1 -0
  253. package/dist/integrations.js +27 -0
  254. package/dist/integrations.js.map +1 -0
  255. package/dist/modules/hideOnScroll.d.ts +7 -0
  256. package/dist/modules/hideOnScroll.d.ts.map +1 -0
  257. package/dist/modules/hideOnScroll.js +39 -0
  258. package/dist/modules/hideOnScroll.js.map +1 -0
  259. package/dist/modules/index.d.ts +2 -0
  260. package/dist/modules/index.d.ts.map +1 -0
  261. package/dist/modules/index.js +5 -0
  262. package/dist/modules/index.js.map +1 -0
  263. package/dist/recipes/buttons.d.ts +30 -0
  264. package/dist/recipes/buttons.d.ts.map +1 -0
  265. package/dist/recipes/buttons.js +28 -0
  266. package/dist/recipes/buttons.js.map +1 -0
  267. package/dist/recipes/index.d.ts +4 -0
  268. package/dist/recipes/index.d.ts.map +1 -0
  269. package/dist/recipes/index.js +23 -0
  270. package/dist/recipes/index.js.map +1 -0
  271. package/dist/recipes/navigation.d.ts +36 -0
  272. package/dist/recipes/navigation.d.ts.map +1 -0
  273. package/dist/recipes/navigation.js +28 -0
  274. package/dist/recipes/navigation.js.map +1 -0
  275. package/dist/recipes/recipes.module.css.js +27 -0
  276. package/dist/recipes/recipes.module.css.js.map +1 -0
  277. package/dist/recipes/whatsapp.d.ts +155 -0
  278. package/dist/recipes/whatsapp.d.ts.map +1 -0
  279. package/dist/recipes/whatsapp.js +155 -0
  280. package/dist/recipes/whatsapp.js.map +1 -0
  281. package/dist/recipes/whatsapp.module.css.js +135 -0
  282. package/dist/recipes/whatsapp.module.css.js.map +1 -0
  283. package/dist/styles.css +4089 -0
  284. package/package.json +78 -4
package/AGENTS.md ADDED
@@ -0,0 +1,359 @@
1
+ # Appss UI — руководство для ИИ-агента
2
+
3
+ Этот файл — инструкция для агента, который собирает приложения на `@appss/ui`. В нём описаны все компоненты, их пропсы и размеры, все рецепты с описанием стиля, платформенные киты и правила сборки экранов. Пиши код только из того, что описано здесь: если нужного компонента нет, собери его из существующих или из обычного HTML, а не придумывай несуществующие пропсы.
4
+
5
+ Размеры даны в CSS-пикселях. «База» — оформление Web без рецепта; «Telegram», «Reddit» — что получает компонент внутри этих платформ; рецепт указывается отдельно.
6
+
7
+ ---
8
+
9
+ ## 1. Быстрый старт
10
+
11
+ ```tsx
12
+ import "@appss/ui/styles.css"; // один раз, в корне приложения
13
+ import { AppssProvider, Button, NavBar } from "@appss/ui";
14
+ import { integrations, webIntegration } from "@appss/ui/integrations";
15
+
16
+ export function App() {
17
+ return (
18
+ <AppssProvider integrations={integrations} fallback={webIntegration}>
19
+ <NavBar title="Главная" />
20
+ <Button onClick={save}>Сохранить</Button>
21
+ </AppssProvider>
22
+ );
23
+ }
24
+ ```
25
+
26
+ Точки входа пакета:
27
+
28
+ | Импорт | Что внутри |
29
+ | ------------------------ | ---------------------------------------------------------------------------- |
30
+ | `@appss/ui` | `AppssProvider`, `useHost`, все компоненты и их типы |
31
+ | `@appss/ui/integrations` | `integrations`, `webIntegration`, `telegramIntegration`, `redditIntegration` |
32
+ | `@appss/ui/recipes` | все рецепты (раздел 5) |
33
+ | `@appss/ui/icons` | 39 иконок (раздел 6) |
34
+ | `@appss/ui/modules` | `hideOnScroll` для BottomNav |
35
+ | `@appss/ui/styles.css` | все стили; без него компоненты не оформлены |
36
+
37
+ Пакет — только ESM, `react` и `react-dom` ^19 — peer dependencies. Импортируй именованно (`import { Button } from "@appss/ui"`): бандлер оставит только использованные компоненты, иконки и рецепты. `import *` и реэкспорт всего пакета этому мешают.
38
+
39
+ ---
40
+
41
+ ## 2. Как устроено оформление
42
+
43
+ Каждый компонент получает оформление по слоям, от слабого к сильному:
44
+
45
+ 1. **База** — нейтральный вид Web (фиолетовый акцент `#6554D9`, радиусы 10–16 px).
46
+ 2. **Рецепт** (`recipe={...}`) — готовый стиль компонента: форма, отступы, цвета.
47
+ 3. **Платформа** — кит Telegram или Reddit, включается автоматически внутри этих платформ.
48
+ 4. **`appearance`** — точечные правки экземпляра: `{ classNames: { слот: "класс" }, styles: { слот: { CSS } } }`.
49
+ 5. **`className` / `style`** — на корневой элемент.
50
+
51
+ Важные следствия:
52
+
53
+ - В Telegram и Reddit кит платформы **перекрывает рецепт**. Рецепты видны в Web. Чтобы рецепт действовал везде, передай `adaptation="fixed"` — тогда платформа к этому компоненту не применяется.
54
+ - Состояния (`disabled`, выбранный пункт, `checked`) задаются пропсами, а не через `appearance`.
55
+ - Слоты (`root`, `label`, …) у каждого компонента фиксированы и перечислены ниже. Неизвестный слот — ошибка TypeScript.
56
+
57
+ ### Платформы
58
+
59
+ `AppssProvider` сам определяет, где запущено приложение:
60
+
61
+ | Платформа | Как определяется | Подключить явно |
62
+ | ----------------- | ------------------------------------------------------------------------------------------- | ----------------- |
63
+ | Web | по умолчанию | `host="web"` |
64
+ | Telegram Mini App | `tgWebAppData` и `tgWebAppPlatform` в hash запуска или `window.__APPSS_HOST__ = "telegram"` | `host="telegram"` |
65
+ | Reddit (Devvit) | только `window.__APPSS_HOST__ = "reddit"` | `host="reddit"` |
66
+
67
+ Для Telegram подключи в приложении `telegram-web-app.js`: он выставляет переменные `--tg-theme-*`, по ним кит берёт цвета темы пользователя (светлая, тёмная, кастомная).
68
+
69
+ Тёмная тема: Telegram — автоматически из темы клиента; Reddit и запасные цвета Telegram — по `prefers-color-scheme` или атрибуту `data-appss-theme="light" | "dark"` на любом предке. Рецепты WhatsApp — только светлые.
70
+
71
+ ---
72
+
73
+ ## 3. Стиль платформ
74
+
75
+ | Платформа | Характер | Ключевые черты |
76
+ | ---------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
77
+ | **Web (база)** | нейтральный, современный, спокойный | фиолетовый акцент, мягкие радиусы 10–16 px, шрифт наследуется от страницы |
78
+ | **Telegram** | лёгкий, системный, «iOS 26» | цвета из темы Telegram (`#007AFF` по умолчанию), стеклянные кнопки и капсулы, сгруппированные списки с радиусом 12, системный шрифт |
79
+ | **Reddit** | энергичный, сообщественный, плотный | оранжевые действия `#D93A00`, синие ссылки `#0045AC`, всё в форме «пилюли», высоты 32/40/48, шрифт 14/20 semibold |
80
+ | **WhatsApp (рецепты)** | дружелюбный, бытовой, спокойный | зелёный `#1DAA61`, белые круглые кнопки с тенью, группы с радиусом 26, крупный текст 17 px, iOS-переключатель |
81
+
82
+ Выбор для нового приложения: Mini App в Telegram — ничего не указывай, кит включится сам. Мессенджер или «домашний» сервис в Web — рецепты WhatsApp. Лента, сообщество, голосования — кит Reddit. Остальное — база с рецептами Button и BottomNav.
83
+
84
+ ---
85
+
86
+ ## 4. Компоненты
87
+
88
+ Общие пропсы у всех компонентов: `appearance`, `recipe`, `adaptation` (`"host"` по умолчанию | `"fixed"`), `className`, `style` и нативные атрибуты корневого элемента.
89
+
90
+ ### Button
91
+
92
+ Кнопка действия. Слоты: `root`, `label`, `leading`, `trailing`, `spinner`.
93
+
94
+ - `variant`: `solid` (основное действие), `soft` (вторичное, тонированное), `outline` (с рамкой), `plain` (текстовое).
95
+ - `tone`: `accent` (по умолчанию), `neutral` (тёмная или серая), `brand` (цвет бренда платформы), `destructive` (удаление).
96
+ - `size`: `sm` | `md` | `lg`; `loading` (спиннер и `aria-busy`), `leading`/`trailing` — иконки.
97
+ - Размеры (высота): база 36/44/52, радиус 10; Telegram 36/42/50, радиус 20 у `sm` и 12 у остальных; Reddit 32/40/48, «пилюля».
98
+ - На одном экране — одна `solid` кнопка; остальные `soft`, `outline` или `plain`.
99
+
100
+ Рецепты:
101
+
102
+ | Рецепт | Стиль | Размеры и форма |
103
+ | ----------------- | --------------------------------- | --------------------------------------------------------------- |
104
+ | `essentialButton` | нейтральный, деловой, сдержанный | как база: 36/44/52, радиус 10 |
105
+ | `pillButton` | дружелюбный, мягкий, современный | высоты базы, полное скругление, горизонтальный отступ 25 |
106
+ | `softButton` | игривый, тактильный, «нажимаемый» | высоты базы, радиус 16, нижняя тень 5 px, будто кнопка выпуклая |
107
+
108
+ ### IconButton
109
+
110
+ Кнопка только с иконкой. Слоты: `root`, `icon`, `badge`. **`label` обязателен** — это доступное имя.
111
+
112
+ - `icon`, `variant`: `plain` (без подложки) | `soft` | `outline` | `solid`; `size`: `sm` 32 | `md` 40 | `lg` 48, круг.
113
+ - `badge`: число (счётчик в углу, 99+) или `true` (точка); `pressed` — переключатель (`aria-pressed`).
114
+ - Telegram: `soft` — стеклянный круг; в шапке NavBar кнопки сами становятся стеклянными. Reddit: круг 40, `solid` оранжевый, счётчик оранжево-красный.
115
+
116
+ | Рецепт | Стиль | Размеры и форма |
117
+ | -------------------- | ---------------------- | --------------------------------------------------------------------------------- |
118
+ | `whatsappIconButton` | дружелюбный, воздушный | круг 48; `soft` — белый с мягкой тенью, `solid` — зелёный, `plain` — без подложки |
119
+
120
+ ### Link
121
+
122
+ Текстовая ссылка `<a>`. Слоты: `root`, `leading`, `trailing`. `href` обязателен; `variant`: `accent` | `subtle`; `external` открывает в новой вкладке с безопасным `rel`. Telegram — цвет ссылок темы без подчёркивания; Reddit — синий `#0045AC`, подчёркивание при наведении. Рецептов нет.
123
+
124
+ ### Tabs
125
+
126
+ ARIA-вкладки (стрелки, Home, End). Слоты: `root`, `list`, `tab`, `label`, `badge`, `panel`.
127
+
128
+ - `items: { id, label, badge?, disabled?, content? }[]`, `value`, `onValueChange`, **`label` обязателен** (имя группы).
129
+ - `variant`: `underline` (полоска под активной), `pill` (активная залита), `segmented` (сегментированный переключатель); `stretch` — вкладки на всю ширину.
130
+ - Без `content` у пунктов работает как фильтр, без панели.
131
+ - Высота вкладки: база 40 (segmented 34); Telegram 44, полоска 3 px; Reddit 40, «пилюли», полоска 2 px тёмная.
132
+ - Рецептов нет.
133
+
134
+ ### Menu
135
+
136
+ Выпадающее меню (кнопка + список). Слоты: `root`, `trigger`, `popover`, `item`, `icon`, `label`, `separator`.
137
+
138
+ - `trigger` (содержимое кнопки), `triggerLabel` (обязателен, если в кнопке только иконка), `items: { id, label, icon?, tone?: "default" | "destructive", disabled?, separatorBefore? }[]`, `onSelect`, `align`: `start` | `end`.
139
+ - Строки: база 40, ширина от 200; Telegram 44, радиус 13, стеклянный фон; Reddit 48, радиус 8, тень.
140
+ - Рецептов нет.
141
+
142
+ ### NavBar
143
+
144
+ Шапка экрана. Слоты: `root`, `leading`, `center`, `title`, `subtitle`, `trailing`.
145
+
146
+ - `title`, `subtitle`, `leading` (назад, логотип), `trailing` (действия), `children` — в центр вместо заголовка (например, SearchField).
147
+ - `align`: `start` | `center`; `titleSize`: `regular` | `large` (крупный заголовок второй строкой, как «Чаты» в iOS); `titleAs`: `h1` (по умолчанию) | `h2` | `div`.
148
+ - Высота: база 56, заголовок 17/700, крупный — 32; Telegram 64, прозрачный фон, кнопки внутри — стеклянные, заголовок с подзаголовком — в стеклянной капсуле, всегда по центру; Reddit 56, белый с нижней линией.
149
+
150
+ | Рецепт | Стиль | Размеры и форма |
151
+ | ---------------- | ---------------------- | ----------------------------------------------------------------------------------------------- |
152
+ | `whatsappHeader` | дружелюбный, спокойный | высота 64, полупрозрачный фон с размытием; с `titleSize="large"` — прозрачный, заголовок 34/800 |
153
+
154
+ ### BottomNav
155
+
156
+ Нижняя навигация по ссылкам. Слоты: `root`, `list`, `item`, `icon`, `label`, `badge`.
157
+
158
+ - `items: { id, label, href, icon?, badge?, disabled? }[]`, `activeId`, `onNavigate(id, event)` (вызови `event.preventDefault()` для SPA), `modules` — `[hideOnScroll({ target })]`.
159
+ - Размещение (фиксация внизу, отступы от краёв) — задача приложения; компонент учитывает `safe-area-inset-bottom`.
160
+ - Telegram и Reddit: плавающая стеклянная капсула, пункт 54, активный — «пилюля». В Telegram капсула по ширине содержимого, по центру, счётчики красные.
161
+
162
+ | Рецепт | Стиль | Размеры и форма |
163
+ | ---------------- | ----------------------------------------- | ---------------------------------------------------------------------- |
164
+ | `dockNav` | спокойный, аккуратный | плавающая белая карточка, радиус 22, лёгкая тень, высота 72 |
165
+ | `lineNav` | строгий, утилитарный, классический | на всю ширину, без скругления, линия сверху, активный пункт подчёркнут |
166
+ | `glassNav` | современный, лёгкий, премиальный (iOS 26) | стеклянная капсула с размытием, пункты 54, активный — «пилюля» |
167
+ | `whatsappTabBar` | дружелюбный, бытовой | стеклянная капсула, пункты 56, подпись 10 px, зелёные счётчики |
168
+
169
+ ### NavList
170
+
171
+ Навигация списком ссылок: боковое меню или меню в шапке сайта. Слоты: `root`, `list`, `item`, `icon`, `label`, `badge`.
172
+
173
+ - `items: { id, label, href, icon?, badge?, disabled? }[]`, `activeId` (можно не задавать), `onNavigate`, `orientation`: `vertical` | `horizontal`.
174
+ - Пункт: база 40, радиус 10; горизонтальный — без подложки, активный подчёркнут. Telegram 44; Reddit 40, радиус 8.
175
+ - Рецептов нет.
176
+
177
+ ### Section и Cell
178
+
179
+ Сгруппированный список, например настройки. Section — слоты `root`, `header`, `body`, `footer`; пропсы `header`, `footer`, `children` (ячейки). Cell — слоты `root`, `before`, `content`, `title`, `subtitle`, `after`; пропсы `title`, `subtitle`, `before` (иконка, аватар), `after` (значение, шеврон, Switch), `href` (ссылка) или `onClick` (кнопка), `disabled`.
180
+
181
+ - Строка: база 52, группа радиус 16 с рамкой; Telegram 44, радиус 12, текст 17, разделитель с отступом; Reddit 48, радиус 16.
182
+
183
+ | Рецепт | Стиль | Размеры и форма |
184
+ | ----------------- | ------------------------ | ---------------------------------------------------------------------- |
185
+ | `whatsappSection` | спокойный, упорядоченный | белые группы с радиусом 26 на сером фоне, подписи 13 px серым |
186
+ | `whatsappCell` | спокойный, крупный | строка 52, текст 17, иконка 24 слева, разделитель начинается от текста |
187
+
188
+ ### Switch
189
+
190
+ Переключатель (`input type="checkbox" role="switch"`). Слоты: `root`, `input`, `track`, `thumb`, `label`. Пропсы: `checked` / `defaultChecked`, `onCheckedChange(checked)`, `children` — подпись (без неё обязателен `aria-label`). Размеры: база 44×26; Telegram 51×31 (iOS); Reddit 48×32, включённый — оранжевый.
191
+
192
+ | Рецепт | Стиль | Размеры и форма |
193
+ | ---------------- | ---------------------------- | ---------------------------------------------------------------------- |
194
+ | `whatsappSwitch` | современный, мягкий (iOS 26) | дорожка 64×28, вытянутый бегунок 38×24, включённый — зелёный `#34C759` |
195
+
196
+ ### Avatar
197
+
198
+ Аватар. Слоты: `root`, `image`, `fallback`, `status`. **`name` обязателен** (доступное имя и инициалы); `src`, `fallback` (вместо инициалов, например `<PersonIcon />`), `size`: `xs` 20 | `sm` 24 | `md` 32 | `lg` 40 | `xl` 64 | `2xl` 112; `shape`: `circle` | `rounded`; `status`: `online` | `offline`. Если картинка не загрузилась — показываются инициалы.
199
+
200
+ | Рецепт | Стиль | Размеры и форма |
201
+ | ---------------- | ------------------- | -------------------------------------------------------------------- |
202
+ | `whatsappAvatar` | мягкий, нейтральный | пастельная лавандовая заглушка; цвет фона можно задать через `style` |
203
+
204
+ ### Tag
205
+
206
+ Неинтерактивная метка: флейр, «Spoiler», NSFW, папка чата. Слоты: `root`, `icon`, `label`. `tone`: `neutral` | `accent` | `brand` | `success` | `warning` | `danger`; `variant`: `soft` | `solid` | `outline` | `plain`; `icon`. Высота 22 (Reddit 20), шрифт 12. В Telegram — капслоком на тонированной плашке с радиусом 4, как метки папок. Рецептов нет.
207
+
208
+ ### Divider
209
+
210
+ Разделитель 1 px. Слот `root`. `orientation`: `horizontal` | `vertical`. Рецептов нет.
211
+
212
+ ### Stat
213
+
214
+ Число с подписью («12K участников»). Слоты: `root`, `value`, `label`. Пропсы `value`, `label`. Значение 18/700 (Reddit 16), подпись 13. Рецептов нет.
215
+
216
+ ### SearchField
217
+
218
+ Поле поиска с `role="search"`. Слоты: `root`, `leading`, `input`, `trailing`. **`label` обязателен** (placeholder не заменяет имя); `leading` (по умолчанию лупа), `trailing` (действие справа), `variant`: `filled` | `outline`, плюс атрибуты `input`.
219
+
220
+ - Высота: база 40, «пилюля»; Telegram 44, серая капсула, иконка и подсказка по центру, пока поле пустое и без фокуса; Reddit 40, `outline` — оранжево-жёлтая градиентная рамка.
221
+ - Рецептов нет.
222
+
223
+ ### Accordion
224
+
225
+ Раскрывающиеся блоки. Слоты: `root`, `item`, `header`, `trigger`, `leading`, `title`, `chevron`, `panel`.
226
+
227
+ - `items: { id, title, leading?, content, disabled? }[]`, `value` / `defaultValue` (массив открытых id), `onValueChange`, `multiple` (по умолчанию `true`), `headingLevel` 2 | 3 | 4.
228
+ - `variant`: `list` (строки, например правила сообщества с номерами) | `section` (группы бокового меню с заголовками капслоком).
229
+ - Строка: база 48 (`section` 40); Telegram 44; Reddit 40.
230
+ - Рецептов нет.
231
+
232
+ ### Card
233
+
234
+ Поверхность для блока. Слоты: `root`, `header`, `title`, `action`, `body`. Пропсы: `title`, `titleAs`, `titleStyle`: `caption` (капслоком мелко) | `heading`, `action` (кнопка или ссылка в шапке), `variant`: `filled` | `outlined` | `elevated`. Отступ 16, радиус 16 (Telegram 12). Рецептов нет.
235
+
236
+ ### Tooltip
237
+
238
+ Подсказка при наведении и фокусе с клавиатуры, закрывается по Escape. Слоты: `root`, `tooltip`. `content` (строка), `children` — один фокусируемый элемент, `placement`: `top` | `bottom` | `start` | `end`, `delay` (300 мс). Подсказка не заменяет доступное имя кнопки. Рецептов нет.
239
+
240
+ ### Likes
241
+
242
+ Оценка «нравится / не нравится» со счётом. Слоты: `root`, `up`, `down`, `score`. Пропсы: `score` (без голоса пользователя), `vote`: `"up" | "down" | null`, `onVoteChange`, `upLabel`, `downLabel`, `label`, `formatScore`, `size`: `sm` 32 | `md` 36 (Reddit `md` 40). Reddit: «за» — оранжевая заливка, «против» — сине-фиолетовая. Рецептов нет.
243
+
244
+ ### Banner
245
+
246
+ Выделенный блок-ссылка с цветным фоном: анонс, новая функция, призыв к действию. Слоты: `root`, `media`, `content`, `title`, `subtitle`, `caption`. Пропсы: `href`, `title`, `subtitle`, `caption`, `icon`, `color` (фон; текст белый, поэтому фон должен быть тёмным). Отступ 12×16, радиус 16. По умолчанию — цвет платформы. Рецептов нет.
247
+
248
+ ### Dialog
249
+
250
+ Модальное окно на нативном `<dialog>`: браузер сам удерживает фокус и возвращает его после закрытия. Слоты: `root`, `panel`, `title`, `body`, `actions`. Пропсы: `open`, `onClose`, `title`, `children` (текст), `actions` (кнопки), `placement`: `center` (окно 480) | `bottom` (нижняя панель, например согласие на cookies), `dismissible` (Escape и клик по фону). Рецептов нет.
251
+
252
+ ### ChatListItem
253
+
254
+ Строка списка чатов. Слоты: `root`, `avatar`, `content`, `header`, `name`, `muted`, `timeStatus`, `time`, `body`, `status`, `sender`, `preview`, `badge`, `pin`, `tags`.
255
+
256
+ - `name`, `avatar`, `sender` (автор последнего сообщения в группе), `preview`, `time`, `unreadCount`, `status`: `sending` | `sent` | `delivered` | `read`, `muted`, `pinned`, `tags` (Tag), `previewLines` 1 | 2, `href` или `onClick`.
257
+ - База: отступ 8×16, имя 16, превью 14 в две строки. Telegram: аватар 54, имя 17, галочка у времени, серый счётчик у чатов без звука, линия под текстом. Reddit: компактно, 14 px.
258
+
259
+ | Рецепт | Стиль | Размеры и форма |
260
+ | ---------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------- |
261
+ | `whatsappChatListItem` | дружелюбный, бытовой | аватар 52, имя 17/600, превью 15 серым, зелёные время и счётчик у непрочитанных, голубые галочки прочтения |
262
+
263
+ ### MessageBubble
264
+
265
+ Сообщение в чате. Слоты: `root`, `avatar`, `bubble`, `author`, `authorName`, `authorBadge`, `reply`, `replyAuthor`, `replyText`, `title`, `content`, `reactions`, `meta`, `time`, `status`, `actions`, `action`.
266
+
267
+ - `direction`: `in` | `out`, `time`, `status` (у исходящих), `author` и `authorColor` (в группах), `authorBadge` (роль), `reply: { author, text, color? }` (цитата), `title`, `reactions`, `actions: { id, label, icon? }[]` и `onAction` (кнопки быстрого ответа), `avatar` и `avatarSpace` (колонка аватаров в группе), `tail`.
268
+ - Хвостик: в Telegram — на последнем сообщении группы, в WhatsApp — на первом.
269
+ - Время стоит в правом нижнем углу и занимает конец последней строки, если там есть место.
270
+ - База: радиус 16, текст 15, ширина до 80% (максимум 520). Telegram: радиус 18, текст 17, исходящие голубоватые, хвостик снизу.
271
+
272
+ | Рецепт | Стиль | Размеры и форма |
273
+ | ----------------------- | ------------------- | ------------------------------------------------------------------------------- |
274
+ | `whatsappMessageBubble` | дружелюбный, тёплый | радиус 18, текст 17, входящие белые, исходящие `#D9FDD3`, зелёные кнопки ответа |
275
+
276
+ ### MessageDivider
277
+
278
+ Разделитель в ленте сообщений. Слоты: `root`, `label`. `label` (строка), `variant`: `date` (ярлык даты) | `unread` (полоса «N непрочитанных»). Ярлык 13 px, «пилюля»; в Telegram — тёмный полупрозрачный с белым текстом.
279
+
280
+ | Рецепт | Стиль | Размеры и форма |
281
+ | ------------------------ | --------- | ------------------------------------------------------------------------------ |
282
+ | `whatsappMessageDivider` | спокойный | белый ярлык 14/600 с лёгкой тенью; полоса непрочитанных — полупрозрачная белая |
283
+
284
+ ### MessageComposer
285
+
286
+ Панель ввода сообщения. Слоты: `root`, `leading`, `field`, `input`, `fieldAction`, `trailing`. **`label` обязателен**; `leading` (вложение), `fieldAction` (внутри поля, например стикеры), `trailing` (камера, микрофон или отправка), `onSend` (по Enter), `value` / `onChange` контролирует приложение. Поле 40, «пилюля»; Telegram — без фона, стеклянное поле 44, кнопки — IconButton `variant="soft"` (стеклянные круги).
287
+
288
+ | Рецепт | Стиль | Размеры и форма |
289
+ | ------------------ | ------------------ | -------------------------------------------------------------- |
290
+ | `whatsappComposer` | бытовой, спокойный | бежевая панель, белое поле-капсула 40 с серой рамкой, текст 17 |
291
+
292
+ ---
293
+
294
+ ## 5. Все рецепты
295
+
296
+ Импорт: `import { pillButton, whatsappTabBar } from "@appss/ui/recipes"`. Рецепт работает только со своим компонентом — TypeScript не даст передать рецепт кнопки в BottomNav.
297
+
298
+ | Рецепт | Компонент | Стиль |
299
+ | ------------------------ | --------------- | ------------------------ |
300
+ | `essentialButton` | Button | нейтральный, деловой |
301
+ | `pillButton` | Button | дружелюбный, мягкий |
302
+ | `softButton` | Button | игривый, тактильный |
303
+ | `dockNav` | BottomNav | спокойный, аккуратный |
304
+ | `lineNav` | BottomNav | строгий, утилитарный |
305
+ | `glassNav` | BottomNav | современный, премиальный |
306
+ | `whatsappTabBar` | BottomNav | дружелюбный, бытовой |
307
+ | `whatsappIconButton` | IconButton | дружелюбный, воздушный |
308
+ | `whatsappHeader` | NavBar | дружелюбный, спокойный |
309
+ | `whatsappSection` | Section | спокойный, упорядоченный |
310
+ | `whatsappCell` | Cell | спокойный, крупный |
311
+ | `whatsappSwitch` | Switch | современный, мягкий |
312
+ | `whatsappAvatar` | Avatar | мягкий, нейтральный |
313
+ | `whatsappChatListItem` | ChatListItem | дружелюбный, бытовой |
314
+ | `whatsappMessageBubble` | MessageBubble | дружелюбный, тёплый |
315
+ | `whatsappMessageDivider` | MessageDivider | спокойный |
316
+ | `whatsappComposer` | MessageComposer | бытовой, спокойный |
317
+
318
+ Подбор по настроению: «серьёзный, деловой» — `essentialButton` и `lineNav`; «дружелюбный» — `pillButton` и рецепты WhatsApp; «игривый» — `softButton` и `dockNav`; «современный, премиальный» — `glassNav` и `pillButton`. Не смешивай на одном экране рецепты разного характера.
319
+
320
+ ---
321
+
322
+ ## 6. Иконки
323
+
324
+ `import { ChatsIcon } from "@appss/ui/icons"` — оригинальный набор на сетке 24, контурные, `stroke="currentColor"` (цвет берётся из текста). Пропсы: `size` (24), `strokeWidth` (1.75), `title` — доступное имя; без `title` иконка декоративная и скрыта от скринридеров. Внутри IconButton и Button `title` не нужен: имя даёт кнопка.
325
+
326
+ | Группа | Иконки |
327
+ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
328
+ | Навигация | `BackIcon`, `ChevronRightIcon`, `CloseIcon`, `MoreIcon`, `PlusIcon`, `SearchIcon`, `EditIcon`, `QrCodeIcon` |
329
+ | Вкладки | `ChatsIcon`, `ChatsFilledIcon` (залитая, для активной вкладки), `ChatIcon`, `PhoneIcon`, `StatusIcon`, `CommunitiesIcon`, `PersonIcon` |
330
+ | Сообщения | `CheckIcon`, `DoubleCheckIcon`, `ReplyIcon`, `MicIcon`, `StickerIcon`, `AttachIcon`, `CameraIcon`, `VideoIcon`, `CallOutgoingIcon`, `NewMessageIcon`, `AddStoryIcon`, `PinIcon`, `MutedIcon`, `VerifiedIcon` |
331
+ | Настройки | `ContactListIcon`, `StarIcon`, `BroadcastIcon`, `LaptopIcon`, `KeyIcon`, `LockIcon`, `NotificationIcon`, `TransferIcon`, `ShieldIcon`, `HelpIcon` |
332
+
333
+ Логотипов и фирменных иконок Telegram, Reddit, WhatsApp, Apple в наборе нет и добавлять их нельзя.
334
+
335
+ ---
336
+
337
+ ## 7. Шаблоны экранов
338
+
339
+ **Список чатов:** `NavBar` (`titleSize="large"` или по центру) → `SearchField` → `Tabs variant="pill"` (папки) → `ChatListItem` × N → `BottomNav` поверх контента, закреплённый внизу.
340
+
341
+ **Чат:** `NavBar` (`leading` — IconButton «Назад», `title` — имя, `subtitle` — статус, `trailing` — Avatar) → лента: `MessageDivider` + `MessageBubble`, у входящих в группах `avatar` на последнем сообщении и `avatarSpace` на остальных → `MessageComposer` внизу.
342
+
343
+ **Настройки:** `NavBar` → `Avatar size="2xl"` и имя → несколько `Section` с `Cell` (`before` — иконка, `after` — `ChevronRightIcon` или `Switch`), пояснения — в `footer`.
344
+
345
+ **Лента:** `NavBar` с `SearchField` в центре → `Tabs` (сортировка) → карточки из `Card`, `Avatar`, `Tag`, `Likes` и Button `variant="soft" size="sm"` → `Banner` для анонсов.
346
+
347
+ **Сайт или десктоп:** `NavBar` + `NavList orientation="horizontal"`; сбоку `NavList` и `Accordion variant="section"`; справа `Card`; подтверждения — `Dialog`.
348
+
349
+ ---
350
+
351
+ ## 8. Правила
352
+
353
+ - Доступность обязательна: `label` у IconButton, Tabs, SearchField, MessageComposer; `name` у Avatar; `triggerLabel` у Menu с иконкой; подпись или `aria-label` у Switch.
354
+ - Не выдумывай пропсы и варианты: используй только перечисленные. Тонкая настройка — через `appearance` по слотам.
355
+ - Не задавай цвета платформы вручную: в Telegram цвета приходят из темы пользователя.
356
+ - Рецепт выбирай по настроению приложения (раздел 5) и держи один характер на экран.
357
+ - Не используй логотипы, маскоты и фирменные иконки платформ, реальные имена людей, телефоны, коды и переписки в примерах и демо-данных.
358
+ - Одна основная (`solid`) кнопка на экран. Деструктивные действия — `tone="destructive"`.
359
+ - Для навигации в SPA вызывай `event.preventDefault()` в `onNavigate` и меняй `activeId` сам: компоненты контролируемые.