@vnejs/docs 0.2.65 → 0.2.66

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 (261) hide show
  1. package/README.md +35 -35
  2. package/architecture/backends.md +18 -0
  3. package/architecture/build.md +37 -0
  4. package/architecture/bundles.md +20 -0
  5. package/architecture/cli.md +25 -0
  6. package/architecture/compatibility.md +22 -0
  7. package/architecture/configs.md +19 -0
  8. package/architecture/contracts.md +30 -0
  9. package/architecture/dependencies.md +55 -0
  10. package/architecture/editor.md +7 -0
  11. package/architecture/games.md +38 -0
  12. package/architecture/helpers.md +14 -0
  13. package/architecture/model.md +43 -0
  14. package/architecture/modules.md +87 -0
  15. package/architecture/packages.md +43 -0
  16. package/architecture/plugins.md +36 -0
  17. package/architecture/uis.md +23 -0
  18. package/changelog/0.2.18.md +7 -0
  19. package/changelog/0.2.19.md +14 -0
  20. package/changelog/0.2.20.md +10 -0
  21. package/changelog/0.2.21.md +5 -0
  22. package/changelog/0.2.22.md +11 -0
  23. package/changelog/0.2.23.md +4 -0
  24. package/changelog/0.2.25.md +6 -0
  25. package/changelog/0.2.26.md +12 -0
  26. package/changelog/0.2.29.md +10 -0
  27. package/changelog/0.2.31.md +5 -0
  28. package/changelog/0.2.32.md +3 -0
  29. package/changelog/0.2.33.md +5 -0
  30. package/changelog/0.2.34.md +8 -0
  31. package/changelog/0.2.35.md +33 -0
  32. package/changelog/0.2.36.md +10 -0
  33. package/changelog/0.2.38.md +19 -0
  34. package/changelog/0.2.39.md +16 -0
  35. package/changelog/0.2.40.md +9 -0
  36. package/changelog/0.2.42.md +3 -0
  37. package/changelog/0.2.43.md +10 -0
  38. package/changelog/0.2.46.md +3 -0
  39. package/changelog/0.2.47.md +25 -0
  40. package/changelog/0.2.49.md +3 -0
  41. package/changelog/0.2.50.md +6 -0
  42. package/changelog/0.2.51.md +6 -0
  43. package/changelog/0.2.52.md +5 -0
  44. package/changelog/0.2.53.md +12 -0
  45. package/changelog/0.2.55.md +19 -0
  46. package/changelog/0.2.56.md +11 -0
  47. package/changelog/0.2.57.md +7 -0
  48. package/changelog/0.2.58.md +8 -0
  49. package/changelog/0.2.59.md +6 -0
  50. package/changelog/0.2.60.md +5 -0
  51. package/changelog/0.2.61.md +11 -0
  52. package/changelog/0.2.62.md +8 -0
  53. package/changelog/0.2.63.md +4 -0
  54. package/changelog/0.2.64.md +4 -0
  55. package/changelog/0.2.65.md +3 -0
  56. package/changelog/0.2.66.md +5 -0
  57. package/changelog/README.md +43 -0
  58. package/manifest.json +66 -5
  59. package/package.json +6 -4
  60. package/plugins/ai/ai.md +29 -29
  61. package/plugins/ai/checkers.md +26 -26
  62. package/plugins/audio/ambient.md +20 -20
  63. package/plugins/audio/audio.md +40 -40
  64. package/plugins/audio/music.md +20 -20
  65. package/plugins/audio/sound.md +20 -20
  66. package/plugins/audio/voice.md +23 -23
  67. package/plugins/canvas/bg.md +44 -44
  68. package/plugins/canvas/bg.speak.md +34 -34
  69. package/plugins/canvas/fill.md +33 -33
  70. package/plugins/canvas/layer.md +35 -35
  71. package/plugins/canvas/sprite.md +46 -46
  72. package/plugins/canvas/sprite.speak.md +33 -33
  73. package/plugins/canvas/text.md +37 -37
  74. package/plugins/canvas/video.md +37 -37
  75. package/plugins/canvas.layers/bl.md +33 -33
  76. package/plugins/canvas.layers/fl.md +33 -33
  77. package/plugins/canvas.layers/ml.md +33 -33
  78. package/plugins/canvas.layers/ul.md +32 -32
  79. package/plugins/canvas.props/animation.md +25 -25
  80. package/plugins/canvas.props/clip.md +22 -22
  81. package/plugins/canvas.props/filters.md +20 -20
  82. package/plugins/canvas.props/mask.md +23 -23
  83. package/plugins/canvas.props/scale.md +20 -20
  84. package/plugins/common/grid.md +23 -23
  85. package/plugins/common/turn.md +18 -18
  86. package/plugins/controls/controls.md +31 -31
  87. package/plugins/controls/cursor.md +54 -54
  88. package/plugins/controls/gamepad.md +56 -56
  89. package/plugins/controls/keyboard.md +17 -17
  90. package/plugins/core/components.md +28 -28
  91. package/plugins/core/interact.md +26 -26
  92. package/plugins/core/logs.md +28 -28
  93. package/plugins/core/media.md +38 -38
  94. package/plugins/core/memory.md +28 -28
  95. package/plugins/core/platforms.md +19 -19
  96. package/plugins/core/scenario.md +48 -48
  97. package/plugins/core/settings.md +24 -24
  98. package/plugins/core/stack.md +39 -39
  99. package/plugins/core/state.md +30 -30
  100. package/plugins/core/storage.md +56 -56
  101. package/plugins/core/system.md +37 -37
  102. package/plugins/core/vendors.md +19 -19
  103. package/plugins/entities/entities.md +16 -16
  104. package/plugins/entities/wallet.md +27 -27
  105. package/plugins/font/montserrat.md +16 -16
  106. package/plugins/game/checkers.md +38 -38
  107. package/plugins/platform/android.md +17 -17
  108. package/plugins/platform/electron.md +21 -21
  109. package/plugins/platform/metric.md +23 -23
  110. package/plugins/rpg/damage.md +22 -22
  111. package/plugins/rpg/hit.md +24 -24
  112. package/plugins/rpg/skills.md +26 -26
  113. package/plugins/save/auto.md +26 -26
  114. package/plugins/save/continue.md +23 -23
  115. package/plugins/save/quick.md +24 -24
  116. package/plugins/save/save.md +37 -37
  117. package/plugins/scales/health.md +17 -17
  118. package/plugins/scales/mana.md +17 -17
  119. package/plugins/scales/scales.md +31 -31
  120. package/plugins/scenario/autoread.md +36 -36
  121. package/plugins/scenario/choose.md +74 -65
  122. package/plugins/scenario/fastforward.md +46 -46
  123. package/plugins/scenario/history.md +41 -41
  124. package/plugins/scenario/pause.md +27 -27
  125. package/plugins/scenario/point_and_click.md +51 -51
  126. package/plugins/scenario/qte.md +54 -54
  127. package/plugins/scenario/random.md +17 -17
  128. package/plugins/settings/filter.md +19 -19
  129. package/plugins/settings/potato.md +22 -22
  130. package/plugins/settings/ratio.md +19 -19
  131. package/plugins/settings/textsize.md +19 -19
  132. package/plugins/settings/volume.md +21 -21
  133. package/plugins/text/inject.md +22 -22
  134. package/plugins/text/locs.md +36 -36
  135. package/plugins/text/meet.md +19 -19
  136. package/plugins/text/smooth.md +33 -33
  137. package/plugins/text/text.md +76 -69
  138. package/plugins/text/wall.md +20 -20
  139. package/plugins/time/date.md +22 -22
  140. package/plugins/time/time.md +23 -23
  141. package/plugins/vars/counters.md +28 -28
  142. package/plugins/vars/flags.md +24 -24
  143. package/plugins/vars/vars.md +29 -29
  144. package/plugins/views/achievement.md +44 -44
  145. package/plugins/views/comment.md +31 -31
  146. package/plugins/views/controls.hints.md +34 -34
  147. package/plugins/views/cursor.md +19 -19
  148. package/plugins/views/fps.md +33 -33
  149. package/plugins/views/gamepad.debug.md +32 -32
  150. package/plugins/views/settings.md +39 -39
  151. package/plugins/views/video.md +37 -37
  152. package/plugins/views.scenario/choose.md +41 -41
  153. package/plugins/views.scenario/interface.controls.md +31 -31
  154. package/plugins/views.scenario/interface.fastforward.md +29 -29
  155. package/plugins/views.scenario/interface.md +74 -74
  156. package/plugins/views.scenario/point_and_click.md +39 -39
  157. package/plugins/views.scenario/qte.md +51 -51
  158. package/plugins/views.screens/checkers.md +35 -35
  159. package/plugins/views.screens/confirm.md +35 -35
  160. package/plugins/views.screens/credits.md +31 -31
  161. package/plugins/views.screens/disclaimer.md +42 -42
  162. package/plugins/views.screens/eula.md +37 -37
  163. package/plugins/views.screens/gallery.full.md +41 -41
  164. package/plugins/views.screens/gallery.md +75 -75
  165. package/plugins/views.screens/gamemenu.md +41 -41
  166. package/plugins/views.screens/history.md +39 -39
  167. package/plugins/views.screens/intro.md +32 -32
  168. package/plugins/views.screens/loading.md +30 -30
  169. package/plugins/views.screens/mainmenu.md +49 -49
  170. package/plugins/views.screens/mainmenu.socials.md +25 -25
  171. package/plugins/views.screens/save.md +66 -66
  172. package/plugins/views.screens/settings.defaults.md +37 -37
  173. package/plugins/views.screens/settings.md +40 -40
  174. package/scenario.catalog/README.md +13 -13
  175. package/scenario.catalog/index.md +35 -35
  176. package/scenario.catalog/stubs/achievement.md +4 -4
  177. package/scenario.catalog/stubs/audio.ambient.md +4 -4
  178. package/scenario.catalog/stubs/audio.music.md +4 -4
  179. package/scenario.catalog/stubs/audio.sound.md +4 -4
  180. package/scenario.catalog/stubs/audio.voice.md +4 -4
  181. package/scenario.catalog/stubs/bl.animation.md +5 -5
  182. package/scenario.catalog/stubs/bl.bg.md +5 -5
  183. package/scenario.catalog/stubs/bl.clip.md +5 -5
  184. package/scenario.catalog/stubs/bl.fill.md +5 -5
  185. package/scenario.catalog/stubs/bl.filter.md +5 -5
  186. package/scenario.catalog/stubs/bl.mask.md +5 -5
  187. package/scenario.catalog/stubs/bl.scale.md +5 -5
  188. package/scenario.catalog/stubs/bl.sprite.md +5 -5
  189. package/scenario.catalog/stubs/bl.text.md +5 -5
  190. package/scenario.catalog/stubs/bl.video.md +5 -5
  191. package/scenario.catalog/stubs/choose.block.md +7 -7
  192. package/scenario.catalog/stubs/choose.md +4 -4
  193. package/scenario.catalog/stubs/choose.option.md +7 -7
  194. package/scenario.catalog/stubs/comment.md +5 -5
  195. package/scenario.catalog/stubs/counter.md +5 -5
  196. package/scenario.catalog/stubs/credits.md +4 -4
  197. package/scenario.catalog/stubs/date.md +4 -4
  198. package/scenario.catalog/stubs/disclaimer.md +5 -5
  199. package/scenario.catalog/stubs/fl.animation.md +5 -5
  200. package/scenario.catalog/stubs/fl.bg.md +5 -5
  201. package/scenario.catalog/stubs/fl.clip.md +5 -5
  202. package/scenario.catalog/stubs/fl.fill.md +5 -5
  203. package/scenario.catalog/stubs/fl.filter.md +5 -5
  204. package/scenario.catalog/stubs/fl.mask.md +5 -5
  205. package/scenario.catalog/stubs/fl.scale.md +5 -5
  206. package/scenario.catalog/stubs/fl.sprite.md +5 -5
  207. package/scenario.catalog/stubs/fl.text.md +5 -5
  208. package/scenario.catalog/stubs/fl.video.md +5 -5
  209. package/scenario.catalog/stubs/flag.md +13 -13
  210. package/scenario.catalog/stubs/interface.md +4 -4
  211. package/scenario.catalog/stubs/intro.md +4 -4
  212. package/scenario.catalog/stubs/mainmenu.md +4 -4
  213. package/scenario.catalog/stubs/ml.animation.md +5 -5
  214. package/scenario.catalog/stubs/ml.bg.md +5 -5
  215. package/scenario.catalog/stubs/ml.clip.md +5 -5
  216. package/scenario.catalog/stubs/ml.fill.md +5 -5
  217. package/scenario.catalog/stubs/ml.filter.md +5 -5
  218. package/scenario.catalog/stubs/ml.mask.md +5 -5
  219. package/scenario.catalog/stubs/ml.scale.md +5 -5
  220. package/scenario.catalog/stubs/ml.sprite.md +5 -5
  221. package/scenario.catalog/stubs/ml.text.md +5 -5
  222. package/scenario.catalog/stubs/ml.video.md +5 -5
  223. package/scenario.catalog/stubs/other.md +6 -6
  224. package/scenario.catalog/stubs/pause.md +5 -5
  225. package/scenario.catalog/stubs/point-and-click.block.md +4 -4
  226. package/scenario.catalog/stubs/point-and-click.md +4 -4
  227. package/scenario.catalog/stubs/point-and-click.option.md +4 -4
  228. package/scenario.catalog/stubs/qte.md +4 -4
  229. package/scenario.catalog/stubs/random.md +4 -4
  230. package/scenario.catalog/stubs/random.option.md +4 -4
  231. package/scenario.catalog/stubs/save.auto.md +4 -4
  232. package/scenario.catalog/stubs/save.md +5 -5
  233. package/scenario.catalog/stubs/scenario.md +4 -4
  234. package/scenario.catalog/stubs/settings.defaults.md +4 -4
  235. package/scenario.catalog/stubs/stack.md +4 -4
  236. package/scenario.catalog/stubs/text.meet.md +4 -4
  237. package/scenario.catalog/stubs/text.wall.md +4 -4
  238. package/scenario.catalog/stubs/time.md +4 -4
  239. package/scenario.catalog/stubs/ul.animation.md +5 -5
  240. package/scenario.catalog/stubs/ul.bg.md +5 -5
  241. package/scenario.catalog/stubs/ul.clip.md +5 -5
  242. package/scenario.catalog/stubs/ul.fill.md +5 -5
  243. package/scenario.catalog/stubs/ul.filter.md +5 -5
  244. package/scenario.catalog/stubs/ul.mask.md +5 -5
  245. package/scenario.catalog/stubs/ul.scale.md +5 -5
  246. package/scenario.catalog/stubs/ul.sprite.md +5 -5
  247. package/scenario.catalog/stubs/ul.text.md +5 -5
  248. package/scenario.catalog/stubs/video.md +4 -4
  249. package/scenario.catalog/stubs/wallet.md +4 -4
  250. package/scenario.guide/README.md +38 -38
  251. package/scenario.guide/audio.md +11 -11
  252. package/scenario.guide/canvas.md +23 -23
  253. package/scenario.guide/choose.md +28 -28
  254. package/scenario.guide/dialogue.md +23 -23
  255. package/scenario.guide/flow.md +21 -21
  256. package/scenario.guide/point-and-click.md +12 -12
  257. package/scenario.guide/qte-random.md +20 -20
  258. package/scenario.guide/vars.md +19 -19
  259. package/scenario.guide/views.md +20 -20
  260. package/CHANGELOG.md +0 -387
  261. package/architecture.md +0 -566
@@ -1,58 +1,58 @@
1
1
  # plugins/core/system/
2
2
 
3
- Пакет: `@vnejs/plugins.core.system` · namespace: `SYSTEM`
3
+ Package: `@vnejs/plugins.core.system` · namespace: `SYSTEM`
4
4
 
5
- Жизненный цикл приложения, DOM-якоря, файлы, resize, версия движка.
5
+ Application lifecycle, DOM anchors, files, resize, engine version.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.system`.
9
+ Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.system`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------------- | ------------------------- | ----------------------------------------------------------- |
13
- | `RESIZE` | `vne:system:resize` | Изменились размеры окна приложения. |
14
- | `RELOAD` | `vne:system:reload` | Перезагрузка страницы после фазы `CLOSE_BEFORE`. |
15
- | `FULLSCREEN` | `vne:system:fullscreen` | Переключение полноэкранного режима документа. |
16
- | `CLOSE` | `vne:system:close` | Закрытие окна приложения после фазы `CLOSE_BEFORE`. |
17
- | `CLOSE_BEFORE` | `vne:system:close_before` | Фаза подготовки перед закрытием или перезагрузкой страницы. |
18
- | `FILE_LOAD` | `vne:file:load` | Скачать объект как JSON-файл. Payload: `{ obj?, name? }`. |
19
- | `FILE_READ` | `vne:file:read` | File picker → parse JSON → вернуть содержимое. |
11
+ | Key | String | Meaning |
12
+ | -------------- | ------------------------- | -------------------------------------------------------------- |
13
+ | `RESIZE` | `vne:system:resize` | Application window size changed. |
14
+ | `RELOAD` | `vne:system:reload` | Reload the page after the `CLOSE_BEFORE` phase. |
15
+ | `FULLSCREEN` | `vne:system:fullscreen` | Toggle document fullscreen. |
16
+ | `CLOSE` | `vne:system:close` | Close the application window after the `CLOSE_BEFORE` phase. |
17
+ | `CLOSE_BEFORE` | `vne:system:close_before` | Prep phase before page close or reload. |
18
+ | `FILE_LOAD` | `vne:file:load` | Download an object as a JSON file. Payload: `{ obj?, name? }`. |
19
+ | `FILE_READ` | `vne:file:read` | File picker → parse JSON → return contents. |
20
20
 
21
- ## Константы
21
+ ## Constants
22
22
 
23
- | Ключ | Смысл |
24
- | -------------------- | --------------------------------------------- |
25
- | `HOST` | Origin или `http://localhost:{port}` из query |
26
- | `VERSION_MAJOR` | Major-версия формата state (число) |
27
- | `VERSION_MINOR` | Minor-версия (число) |
28
- | `DOM_IDS.APP` | `"app"` — корневой контейнер |
29
- | `DOM_IDS.MEDIA` | `"media"` — скрытый контейнер медиа |
30
- | `DOM_IDS.COMPONENTS` | `"components"` — контейнер UI |
31
- | `LOGS_ACTIONS.RESIZE` | `"resize"` — метка лога при `RESIZE` |
23
+ | Key | Meaning |
24
+ | --------------------- | ---------------------------------------------- |
25
+ | `HOST` | Origin or `http://localhost:{port}` from query |
26
+ | `VERSION_MAJOR` | Major version of the state format (number) |
27
+ | `VERSION_MINOR` | Minor version (number) |
28
+ | `DOM_IDS.APP` | `"app"` — root container |
29
+ | `DOM_IDS.MEDIA` | `"media"` — hidden media container |
30
+ | `DOM_IDS.COMPONENTS` | `"components"` — UI container |
31
+ | `LOGS_ACTIONS.RESIZE` | `"resize"` — log label on `RESIZE` |
32
32
 
33
- ## Параметры
33
+ ## Parameters
34
34
 
35
- Нет.
35
+ None.
36
36
 
37
- ## Настройки
37
+ ## Settings
38
38
 
39
- Нет.
39
+ None.
40
40
 
41
- ## Модули
41
+ ## Modules
42
42
 
43
- | Модуль | Зона ответственности |
44
- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
45
- | `system` | Reload, close, fullscreen, `CLOSE_BEFORE`. |
46
- | `system.resize` | Реагирует на изменение размеров окна; инициирует `RESIZE`. |
47
- | `system.file` | `FILE_LOAD` / `FILE_READ`. |
48
- | `system.version` | Default state `{ major, minor }` для миграции сохранений; slice в `ModuleGlobalState["system.version"]` (`ModuleGlobalStateSystemVersion`). |
43
+ | Module | Role |
44
+ | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
45
+ | `system` | Reload, close, fullscreen, `CLOSE_BEFORE`. |
46
+ | `system.resize` | Reacts to window resize; emits `RESIZE`. |
47
+ | `system.file` | `FILE_LOAD` / `FILE_READ`. |
48
+ | `system.version` | Default state `{ major, minor }` for save migration; slice in `ModuleGlobalState["system.version"]` (`ModuleGlobalStateSystemVersion`). |
49
49
 
50
- ## Близкие плагины
50
+ ## Related plugins
51
51
 
52
52
  ### plugins/core/
53
53
 
54
54
  - [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …) (resize)
55
55
 
56
- ### Остальные
56
+ ### Other
57
57
 
58
- — нет
58
+ — None
@@ -1,41 +1,41 @@
1
1
  # plugins/core/vendors/
2
2
 
3
- Пакет: `@vnejs/plugins.core.vendors` · namespace: `VENDORS`
3
+ Package: `@vnejs/plugins.core.vendors` · namespace: `VENDORS`
4
4
 
5
- Обёртки над сторонними утилитами: скриншот.
5
+ Wrappers over third-party utilities: screenshot.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.vendors`.
9
+ Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.vendors`.
10
10
 
11
- | Ключ | Строка | Смысл |
11
+ | Key | String | Meaning |
12
12
  | -------- | -------------------- | ---------------------------------------------------------------------------------------------- |
13
- | `SCREEN` | `vne:vendors:screen` | Скриншот DOM через html2canvas → webp data URL. Payload: `{ width?, height?, quality?, id? }`. |
13
+ | `SCREEN` | `vne:vendors:screen` | DOM screenshot via html2canvas → webp data URL. Payload: `{ width?, height?, quality?, id? }`. |
14
14
 
15
- ## Константы
15
+ ## Constants
16
16
 
17
- Нет.
17
+ None.
18
18
 
19
- ## Параметры
19
+ ## Parameters
20
20
 
21
- Нет.
21
+ None.
22
22
 
23
- ## Настройки
23
+ ## Settings
24
24
 
25
- Нет.
25
+ None.
26
26
 
27
- ## Модули
27
+ ## Modules
28
28
 
29
- | Модуль | Зона ответственности |
30
- | ---------------- | --------------------------------------------------------------- |
31
- | `vendors.screen` | html2canvas screenshot; на init помечает media-элементы ignore. |
29
+ | Module | Role |
30
+ | ---------------- | ------------------------------------------------------------ |
31
+ | `vendors.screen` | html2canvas screenshot; on init marks media elements ignore. |
32
32
 
33
- ## Близкие плагины
33
+ ## Related plugins
34
34
 
35
35
  ### plugins/core/
36
36
 
37
37
  - [system.md](./system.md) — `SYSTEM`: `STARTED`; `CONST.SYSTEM.DOM_IDS.MEDIA` (html2canvas ignore)
38
38
 
39
- ### Остальные
39
+ ### Other
40
40
 
41
- — нет
41
+ — None
@@ -1,35 +1,35 @@
1
1
  # plugins/entities/entities/
2
2
 
3
- Пакет: `@vnejs/plugins.entities.entities` · namespace: `ENTITIES`
3
+ Package: `@vnejs/plugins.entities.entities` · namespace: `ENTITIES`
4
4
 
5
- Регистрирует базовый контракт системы сущностей.
5
+ Registers the base entity-system contract.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Нет.
9
+ None.
10
10
 
11
- ## Константы
11
+ ## Constants
12
12
 
13
- Нет.
13
+ None.
14
14
 
15
- ## Параметры
15
+ ## Parameters
16
16
 
17
- Нет.
17
+ None.
18
18
 
19
- ## Настройки
19
+ ## Settings
20
20
 
21
- Нет.
21
+ None.
22
22
 
23
- ## Модули
23
+ ## Modules
24
24
 
25
- Нет.
25
+ None.
26
26
 
27
- ## Близкие плагины
27
+ ## Related plugins
28
28
 
29
29
  ### plugins/core/
30
30
 
31
- — нет
31
+ — None
32
32
 
33
- ### Остальные
33
+ ### Other
34
34
 
35
- — нет
35
+ — None
@@ -1,49 +1,49 @@
1
1
  # plugins/entities/wallet/
2
2
 
3
- Пакет: `@vnejs/plugins.entities.wallet` · namespace: `WALLET`
3
+ Package: `@vnejs/plugins.entities.wallet` · namespace: `WALLET`
4
4
 
5
- Управляет кошельками и валютами: add, set и reset из сценария и событий.
5
+ Manages wallets and currencies: add, set, and reset from scenario and events.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.entities.wallet`.
9
+ Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.entities.wallet`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | --------- | -------------------- | ---------------------------------- |
13
- | `ADD` | `vne:wallet:add` | Событие `ADD` namespace плагина. |
14
- | `SET` | `vne:wallet:set` | Записать или обновить значение. |
15
- | `REG` | `vne:wallet:reg` | Зарегистрировать обработчик. |
16
- | `RESET` | `vne:wallet:reset` | Событие `RESET` namespace плагина. |
17
- | `CHANGED` | `vne:wallet:changed` | Зафиксировать изменение состояния. |
11
+ | Key | String | Meaning |
12
+ | --------- | -------------------- | ------------------------------- |
13
+ | `ADD` | `vne:wallet:add` | Plugin namespace event `ADD`. |
14
+ | `SET` | `vne:wallet:set` | Write or update a value. |
15
+ | `REG` | `vne:wallet:reg` | Register a handler. |
16
+ | `RESET` | `vne:wallet:reset` | Plugin namespace event `RESET`. |
17
+ | `CHANGED` | `vne:wallet:changed` | Record a state change. |
18
18
 
19
- ## Константы
19
+ ## Constants
20
20
 
21
- Нет.
21
+ None.
22
22
 
23
- ## Параметры
23
+ ## Parameters
24
24
 
25
- | Ключ | Тип | Смысл |
26
- | ------------ | -------- | ------------------------------------ |
27
- | `CURRENCIES` | `string` | Значение по умолчанию: "CURRENCIES". |
28
- | `ITEMS` | `object` | Параметр `ITEMS`. |
25
+ | Key | Type | Meaning |
26
+ | ------------ | -------- | ------------------------ |
27
+ | `CURRENCIES` | `string` | Default: `"CURRENCIES"`. |
28
+ | `ITEMS` | `object` | Parameter `ITEMS`. |
29
29
 
30
- ## Настройки
30
+ ## Settings
31
31
 
32
- Нет.
32
+ None.
33
33
 
34
- ## Модули
34
+ ## Modules
35
35
 
36
- | Модуль | Зона ответственности |
37
- | -------- | ------------------------ |
38
- | `wallet` | Реестр обработчиков REG. |
36
+ | Module | Role |
37
+ | -------- | ----------------------- |
38
+ | `wallet` | Handler registry (REG). |
39
39
 
40
- ## Близкие плагины
40
+ ## Related plugins
41
41
 
42
42
  ### plugins/core/
43
43
 
44
44
  - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
45
45
  - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
46
46
 
47
- ### Остальные
47
+ ### Other
48
48
 
49
- - [entities.md](./entities.md) — базовый namespace `ENTITIES` (родительский пакет)
49
+ - [entities.md](./entities.md) — base namespace `ENTITIES` (parent package)
@@ -1,35 +1,35 @@
1
1
  # plugins/font/montserrat/
2
2
 
3
- Пакет: `@vnejs/plugins.font.montserrat` · namespace: `UNKNOWN`
3
+ Package: `@vnejs/plugins.font.montserrat` · namespace: `UNKNOWN`
4
4
 
5
- Подключает шрифт Montserrat через CSS @font-face.
5
+ Loads the Montserrat font via CSS @font-face.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Нет.
9
+ None.
10
10
 
11
- ## Константы
11
+ ## Constants
12
12
 
13
- Нет.
13
+ None.
14
14
 
15
- ## Параметры
15
+ ## Parameters
16
16
 
17
- Нет.
17
+ None.
18
18
 
19
- ## Настройки
19
+ ## Settings
20
20
 
21
- Нет.
21
+ None.
22
22
 
23
- ## Модули
23
+ ## Modules
24
24
 
25
- Нет.
25
+ None.
26
26
 
27
- ## Близкие плагины
27
+ ## Related plugins
28
28
 
29
29
  ### plugins/core/
30
30
 
31
- — нет
31
+ — None
32
32
 
33
- ### Остальные
33
+ ### Other
34
34
 
35
- — нет
35
+ — None
@@ -1,51 +1,51 @@
1
1
  # plugins/game/checkers/
2
2
 
3
- Пакет: `@vnejs/plugins.game.checkers` · namespace: `CHECKERS`
3
+ Package: `@vnejs/plugins.game.checkers` · namespace: `CHECKERS`
4
4
 
5
- Правила русских шашек и сценарные команды `$ checkers`. AI-оркестрация — в [`ai/checkers`](../ai/checkers.md) (`CHECKERS_AI`). UI — в [`views.screens/checkers`](../views.screens/checkers.md) (`CHECKERS_VIEW`). Доска — в [`common/grid`](../common/grid.md) (`GRID`). Ход стороны — в [`common/turn`](../common/turn.md) (`TURNS`).
5
+ Russian checkers rules and scenario commands `$ checkers`. AI orchestration — in [`ai/checkers`](../ai/checkers.md) (`CHECKERS_AI`). UI — in [`views.screens/checkers`](../views.screens/checkers.md) (`CHECKERS_VIEW`). Board — in [`common/grid`](../common/grid.md) (`GRID`). Side to move — in [`common/turn`](../common/turn.md) (`TURNS`).
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.game.checkers`.
9
+ Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.game.checkers`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
13
- | `SHOW` | `vne:checkers:show` | Старт: `SET` (`cells` + `owner`) → `START`. Payload: `{ initialOwner?, initialPreset? }`. |
14
- | `HIDE` | `vne:checkers:hide` | `UNSET` + сброс busy sources. |
15
- | `START` | `vne:checkers:start` | Партия готова (слушает `CHECKERS_AI` → `INTERACT`). |
16
- | `SET` | `vne:checkers:set` | `{ cells, owner }` → `GRID.SET` + `TURNS.SET` (id / rows / columns из констант). |
17
- | `UNSET` | `vne:checkers:unset` | `GRID.UNSET` + `TURNS.UNSET` по `GRID_ID` / `TURN_ID`. |
18
- | `STATE_UPDATE` | `vne:checkers:state_update` | Патч game-стейта (без board). |
19
- | `FINISH` | `vne:checkers:finish` | Конец партии: `{ winner }` → delay → `sources.clear()` + `emit SCENARIO.NEXT`. |
20
- | `MOVES_GET` | `vne:checkers:moves_get` | `emitOne`: `{ board, turn }` → `{ moves, hanging, safe }`. |
21
- | `MOVE_PLAY` | `vne:checkers:move_play` | `emitOne`: `{ move, controllerType? }` → `boolean`; успех → `MOVE_PLAYED` или при победе `FINISH`. |
22
- | `MOVE_PLAYED` | `vne:checkers:move_played` | После хода (из `MOVE_PLAY`); цикл AI — в `CHECKERS_AI`. |
11
+ | Key | String | Meaning |
12
+ | -------------- | --------------------------- | ----------------------------------------------------------------------------------------------- |
13
+ | `SHOW` | `vne:checkers:show` | Start: `SET` (`cells` + `owner`) → `START`. Payload: `{ initialOwner?, initialPreset? }`. |
14
+ | `HIDE` | `vne:checkers:hide` | `UNSET` + reset busy sources. |
15
+ | `START` | `vne:checkers:start` | Game ready (listens `CHECKERS_AI` → `INTERACT`). |
16
+ | `SET` | `vne:checkers:set` | `{ cells, owner }` → `GRID.SET` + `TURNS.SET` (id / rows / columns from constants). |
17
+ | `UNSET` | `vne:checkers:unset` | `GRID.UNSET` + `TURNS.UNSET` by `GRID_ID` / `TURN_ID`. |
18
+ | `STATE_UPDATE` | `vne:checkers:state_update` | Patch game state (no board). |
19
+ | `FINISH` | `vne:checkers:finish` | End game: `{ winner }` → delay → `sources.clear()` + `emit SCENARIO.NEXT`. |
20
+ | `MOVES_GET` | `vne:checkers:moves_get` | `emitOne`: `{ board, turn }` → `{ moves, hanging, safe }`. |
21
+ | `MOVE_PLAY` | `vne:checkers:move_play` | `emitOne`: `{ move, controllerType? }` → `boolean`; success → `MOVE_PLAYED` or on win `FINISH`. |
22
+ | `MOVE_PLAYED` | `vne:checkers:move_played` | After a move (from `MOVE_PLAY`); AI loop — in `CHECKERS_AI`. |
23
23
 
24
- `MOVE_PLAY` читает доску через `GRID.GET` и сторону через `TURNS.GET`; после хода пишет `CHECKERS.SET`. Победа — только через `FINISH` (`CheckersFinishPayload`).
24
+ `MOVE_PLAY` reads the board via `GRID.GET` and side via `TURNS.GET`; after the move writes `CHECKERS.SET`. Win — only via `FINISH` (`CheckersFinishPayload`).
25
25
 
26
- ## Константы / Shared / Params
26
+ ## Constants / Shared / Params
27
27
 
28
- | Ключ | Смысл |
29
- | ------------------------------------------ | -------------------------------------------------------------------------- |
30
- | `EXEC_ACTIONS` / `COLORS` / `COLOR_VALUES` | show/hide; white/black |
31
- | `CONST.CHECKERS.TURN_ID` | `"checkers"` — id в `TURNS` |
32
- | `CONST.CHECKERS.GRID_ID` | `"checkers"` — id в `GRID` |
33
- | `shared.checkersInteractDisableSources` | `SourcesSet` — блок интерактива на ход AI |
34
- | `PARAMS.CHECKERS.FINISH_DELAY` | пауза перед `emit SCENARIO.NEXT` на `FINISH` (мс, `300`) |
35
- | `PARAMS.CHECKERS.ROWS` / `COLUMNS` | `8` — размер для `GRID.SET` (внутри `SET`) |
36
- | `PARAMS.CHECKERS.PRESETS` | пресеты доски: `COMMON`, `FLIPPED`, `RANDOM` (RANDOM каждый `SHOW` заново) |
28
+ | Key | Meaning |
29
+ | ------------------------------------------ | --------------------------------------------------------------------------- |
30
+ | `EXEC_ACTIONS` / `COLORS` / `COLOR_VALUES` | show/hide; white/black |
31
+ | `CONST.CHECKERS.TURN_ID` | `"checkers"` — id in `TURNS` |
32
+ | `CONST.CHECKERS.GRID_ID` | `"checkers"` — id in `GRID` |
33
+ | `shared.checkersInteractDisableSources` | `SourcesSet` — block interact during AI move |
34
+ | `PARAMS.CHECKERS.FINISH_DELAY` | pause before `emit SCENARIO.NEXT` on `FINISH` (ms, `300`) |
35
+ | `PARAMS.CHECKERS.ROWS` / `COLUMNS` | `8` — size for `GRID.SET` (inside `SET`) |
36
+ | `PARAMS.CHECKERS.PRESETS` | board presets: `COMMON`, `FLIPPED`, `RANDOM` (`RANDOM` anew on each `SHOW`) |
37
37
 
38
- ## Модули
38
+ ## Modules
39
39
 
40
- | Модуль | Зона |
40
+ | Module | Role |
41
41
  | --------------------------------------- | ------------------------------------------------------ |
42
42
  | `checkers` | `$ checkers show/hide` |
43
43
  | `checkers.show` | SHOW → `SET` + START; HIDE → `UNSET` |
44
44
  | `checkers.set` | `SET` → `GRID`/`TURNS`; `UNSET` → `GRID`/`TURNS` UNSET |
45
- | `checkers.moves` / `checkers.move.play` | ходы; `move.play` → `SET` / `FINISH` |
46
- | `checkers.finish` | FINISH → delay + `emit SCENARIO.NEXT` |
45
+ | `checkers.moves` / `checkers.move.play` | moves; `move.play` → `SET` / `FINISH` |
46
+ | `checkers.finish` | FINISH → delay + `emit SCENARIO.NEXT` |
47
47
 
48
- ## Сценарий
48
+ ## Scenario
49
49
 
50
50
  ```vne
51
51
  $ checkers show
@@ -55,18 +55,18 @@ $ checkers show
55
55
  $ checkers hide
56
56
  ```
57
57
 
58
- Args под `show`: `initialOwner` (`white` / `black`, иначе белые); `initialPreset` (ключ из `PARAMS.CHECKERS.PRESETS`, дефолт `COMMON`).
58
+ Args under `show`: `initialOwner` (`white` / `black`, else white); `initialPreset` (key from `PARAMS.CHECKERS.PRESETS`, default `COMMON`).
59
59
 
60
- `$ checkers.ai` — см. [`ai/checkers`](../ai/checkers.md).
60
+ `$ checkers.ai` — see [`ai/checkers`](../ai/checkers.md).
61
61
 
62
- ## Бандл
62
+ ## Bundle
63
63
 
64
64
  `@vnejs/bundles.checkers` — `plugins.common.grid` + `plugins.common.turn` + `plugins.game.checkers` + `plugins.ai.checkers` + `plugins.views.screens.checkers` + `plugins.ai`.
65
65
 
66
- ## Близкие плагины
66
+ ## Related plugins
67
67
 
68
- - [common/grid.md](../common/grid.md) — `GRID` (доска)
68
+ - [common/grid.md](../common/grid.md) — `GRID` (board)
69
69
  - [common/turn.md](../common/turn.md) — `TURNS` (`id` / `owner`)
70
70
  - [ai/checkers.md](../ai/checkers.md) — `CHECKERS_AI`
71
71
  - [views.screens/checkers.md](../views.screens/checkers.md) — `CHECKERS_VIEW`
72
- - [ai/ai.md](../ai/ai.md) — диспетчер `AI.EMIT`
72
+ - [ai/ai.md](../ai/ai.md) — `AI.EMIT` dispatcher
@@ -1,38 +1,38 @@
1
1
  # plugins/platform/android/
2
2
 
3
- Пакет: `@vnejs/plugins.platform.android` · namespace: `ANDROID`
3
+ Package: `@vnejs/plugins.platform.android` · namespace: `ANDROID`
4
4
 
5
- На Android скрывает splash screen при старте и закрывает приложение.
5
+ On Android hides the splash screen on start and closes the app.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Нет.
9
+ None.
10
10
 
11
- ## Константы
11
+ ## Constants
12
12
 
13
- Нет.
13
+ None.
14
14
 
15
- ## Параметры
15
+ ## Parameters
16
16
 
17
- Нет.
17
+ None.
18
18
 
19
- ## Настройки
19
+ ## Settings
20
20
 
21
- Нет.
21
+ None.
22
22
 
23
- ## Модули
23
+ ## Modules
24
24
 
25
- | Модуль | Зона ответственности |
26
- | --------- | ---------------------------- |
27
- | `android` | Обрабатывает STARTED, CLOSE. |
25
+ | Module | Role |
26
+ | --------- | ----------------------- |
27
+ | `android` | Handles STARTED, CLOSE. |
28
28
 
29
- ## Близкие плагины
29
+ ## Related plugins
30
30
 
31
31
  ### plugins/core/
32
32
 
33
33
  - [platforms.md](../core/platforms.md) — `PLATFORMS`: CONST.MOBILE, PARAMS.CURRENT_PLATFORM
34
34
  - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED, EVENTS.CLOSE
35
35
 
36
- ### Остальные
36
+ ### Other
37
37
 
38
- — нет
38
+ — None
@@ -1,45 +1,45 @@
1
1
  # plugins/platform/electron/
2
2
 
3
- Пакет: `@vnejs/plugins.platform.electron` · namespace: `ELECTRON`
3
+ Package: `@vnejs/plugins.platform.electron` · namespace: `ELECTRON`
4
4
 
5
- Синхронизирует storage с хостом Electron и перезагружает игру при изменении состояния. Хост раскладывает state: `{module}.json` при group `_`, иначе `{module}/{group}.json`.
5
+ Syncs storage with the Electron host and reloads the game when state changes. The host lays out state: `{module}.json` when group is `_`, else `{module}/{group}.json`.
6
6
 
7
- ## События
7
+ ## Events
8
8
 
9
- Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.platform.electron`.
9
+ Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.platform.electron`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------- | --------------------- | ------------------------------------------ |
13
- | `CONFIG` | `vne:electron:config` | Конфиг хоста Electron (например language). |
11
+ | Key | String | Meaning |
12
+ | -------- | --------------------- | -------------------------------------------- |
13
+ | `CONFIG` | `vne:electron:config` | Electron host config (for example language). |
14
14
 
15
- ## Константы
15
+ ## Constants
16
16
 
17
- Нет.
17
+ None.
18
18
 
19
- ## Параметры
19
+ ## Parameters
20
20
 
21
- Нет.
21
+ None.
22
22
 
23
- ## Настройки
23
+ ## Settings
24
24
 
25
- Нет.
25
+ None.
26
26
 
27
- ## Модули
27
+ ## Modules
28
28
 
29
- | Модуль | Зона ответственности |
30
- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
31
- | `electron` | Синхронизирует remote storage; при изменении и cooldown ≥ 10 с (метка в `sessionStorage`) ставит `shouldReload` + `shared.shouldAutostartScenario = false`; на `STARTED` эмитит `RELOAD`; обрабатывает CHANGED / CLOSE_BEFORE. |
29
+ | Module | Role |
30
+ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
31
+ | `electron` | Syncs remote storage; on change and cooldown ≥ 10 s (mark in `sessionStorage`) sets `shouldReload` + `shared.shouldAutostartScenario = false`; on `STARTED` emits `RELOAD`; handles CHANGED / CLOSE_BEFORE. |
32
32
 
33
- ## Близкие плагины
33
+ ## Related plugins
34
34
 
35
35
  ### plugins/core/
36
36
 
37
37
  - [platforms.md](../core/platforms.md) — `PLATFORMS`: CONST.ELECTRON, PARAMS.CURRENT_PLATFORM
38
- - [scenario.md](../core/scenario.md) — `SCENARIO`: `shared.shouldAutostartScenario` (отключает автостарт перед reload)
38
+ - [scenario.md](../core/scenario.md) — `SCENARIO`: `shared.shouldAutostartScenario` (disables autostart before reload)
39
39
  - [storage.md](../core/storage.md) — `STORAGE`: EVENTS.CHANGED, EVENTS.SET_ALL, EVENTS.GET_ALL
40
40
  - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED, EVENTS.CLOSE_BEFORE, EVENTS.RELOAD, CONST.HOST
41
41
  - [vendors.md](../core/vendors.md) — `VENDORS`: EVENTS.DEBOUNCE
42
42
 
43
- ### Остальные
43
+ ### Other
44
44
 
45
- — нет
45
+ — None