@vnejs/docs 0.2.21 → 0.2.22

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-Краткая история изменений плагинов и внешнего API. Версии — релизы пакета `@vnejs/docs`.
+Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
+
+## 0.2.22
+
+- `scenario/fastforward` — цикл автоклика в модуле `fastforward.emit`; провал `CHECK` эмитит `STOP`. `isFastforwardOn` сбрасывается через `setValue(false)` в `init`, не на `SYSTEM.STARTED`. Визиты в `shared.fastforwardStorage`; диск в `fastforward.storage`. API: `shared.fastforwardStorage`, `EVENTS.FASTFORWARD.VISIT_ADD`, модули `fastforward.emit`, `fastforward.scenario`, `fastforward.storage`.
+- `core/vendors` — события `UID`, `HASH`, `DATE`, `DEBOUNCE` сняты; остались `CLONE`, `SCREEN`. Вместо них: `crypto.randomUUID()`, `hashSha256`, `formatTimestamp`, `debounce`.
+- `helpers/hash-sha256` — SHA-256 объекта: `hashSha256(value, maxLength?)`; ключи канонизируются. `maxLength` пока не передают.
+- `helpers/format-timestamp` — `formatTimestamp({ ts, format })`; токены `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss`.
+- `helpers/debounce` — `debounce({ fn, wait, maxWait, leading, trailing })`.
+- `core/logs`, `text/text`, `canvas/bg`, `canvas/video`, `views.screens/history` — uid через `crypto.randomUUID()`, не `VENDORS.UID`.
+- `core/scenario`, `core/state`, `scenario/fastforward` — хеш строки / visits через `hashSha256`, не `VENDORS.HASH`.
+- `views.screens/save` — дата и время слота через `formatTimestamp`, не `VENDORS.DATE`.
+- `platform/electron` — сохранение state через `debounce`, не `VENDORS.DEBOUNCE`.
 
 ## 0.2.21
 

package/README.md

@@ -28,7 +28,7 @@ npm i @vnejs/docs
 - [Сценарий — guide](./scenario.guide/README.md) — синтаксис `.vne` и тематические гайды
 - [Сценарий — catalog](./scenario.catalog/README.md) — каталог `$` / `%` команд
 - [Архитектура](./architecture.md) — каталоги монорепы и их связи, mermaid-диаграммы
-- [Changelog](./CHANGELOG.md) — изменения плагинов и API по версиям `@vnejs/docs`
+- [Changelog](./CHANGELOG.md) — изменения движка и API по версиям `@vnejs/docs`
 
 ## Быстрый ориентир по монорепе
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/docs",
-  "version": "0.2.21",
+  "version": "0.2.22",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/core/storage.md

@@ -10,7 +10,7 @@
 
 - Если `group` не передан — подставляется `_` (default group).
 - `key` может содержать `:` (например settings `vne:volume:common`).
-- `module` может содержать `.` (например `vars.global`, `fastforward.visits`).
+- `module` может содержать `.` (например `vars.global`, `fastforward.storage`).
 
 Примеры:
 
@@ -18,7 +18,7 @@
 |-------|-----------------|
 | `{ module: "settings", key: "vne:volume:common" }` | `settings/_/vne:volume:common` |
 | `{ module: "save", group: "0", key: "3" }` | `save/0/3` |
-| `{ module: "fastforward.visits", group: "intro", key: "hash" }` | `fastforward.visits/intro/hash` |
+| `{ module: "fastforward.storage", group: "intro", key: "hash" }` | `fastforward.storage/intro/hash` |
 
 ## Диск (desktop / Steam)
 
@@ -27,7 +27,7 @@
 | `_` или не задан | `{module}.json` |
 | любая другая | `{module}/{group}.json` |
 
-Примеры: `settings.json`, `save/0.json`, `save/autosave.json`, `fastforward.visits/intro.json`.
+Примеры: `settings.json`, `save/0.json`, `save/autosave.json`, `fastforward.storage/intro.json`.
 
 ## События
 

package/plugins/core/vendors.md

@@ -2,18 +2,14 @@
 
 Пакет: `@vnejs/plugins.core.vendors` · namespace: `VENDORS`
 
-Обёртки над сторонними утилитами: clone, hash, uuid, debounce, дата, скриншот.
+Обёртки над сторонними утилитами: clone, скриншот.
 
 ## События
 
 | Ключ | Строка | Смысл |
 |------|--------|-------|
-| `UID` | `vne:vendors:uid` | Сгенерировать уникальный идентификатор uuid4. |
-| `HASH` | `vne:vendors:hash` | MD5-хеш объекта (идентификация строки сценария, проверка сохранений). |
-| `DATE` | `vne:vendors:date` | Форматирование timestamp через dayjs. Payload: `{ ts?, format? }`. |
 | `CLONE` | `vne:vendors:clone` | Deep clone через lodash (state, stack, args). |
 | `SCREEN` | `vne:vendors:screen` | Скриншот DOM через html2canvas → webp data URL. Payload: `{ width?, height?, quality?, id? }`. |
-| `DEBOUNCE` | `vne:vendors:debounce` | Вернуть lodash-debounced функцию. Payload: `{ func?, wait?, options? }`. |
 
 ## Константы
 
@@ -31,7 +27,7 @@
 
 | Модуль | Зона ответственности |
 |--------|----------------------|
-| `vendors` | uid, hash, clone, debounce, date. |
+| `vendors` | clone. |
 | `vendors.screen` | html2canvas screenshot; на init помечает media-элементы ignore. |
 
 ## Близкие плагины

package/plugins/scenario/fastforward.md

@@ -15,11 +15,14 @@
 | `EMIT_CHECK` | `vne:fastforward:emit_check` | Инициировать действие или цикл. |
 | `CHECK` | `vne:fastforward:check` | Проверить состояние или наличие ресурса. |
 | `CHANGED` | `vne:fastforward:changed` | Зафиксировать изменение состояния. |
+| `VISIT_ADD` | `vne:fastforward:visit_add` | Записать визит: `shared.fastforwardStorage` + стейт и `STORAGE.SET`. Payload: `key`, `group`, поля `SCENARIO.EXEC`. |
 | `CLEAR` | `vne:fastforward:clear` | Очистить накопленное состояние. |
 
 ## Константы
 
-Нет.
+| Ключ | Смысл |
+|------|--------|
+| `SOURCE` | `"fastforward"` — ключ в SourcesSet соседних плагинов. |
 
 ## Параметры
 
@@ -37,12 +40,22 @@
 | `DELAY` (`vne:fastforward:delay`) | `number` | Настройка `vne:fastforward:delay` в `shared.settings`. |
 | `ENABLED` (`vne:fastforward:enabled`) | `boolean` | Включить или выключить функцию. |
 
+## Shared
+
+| Поле | Тип | Смысл |
+|------|-----|--------|
+| `isFastforwardOn` | `boolean` | Режим прокрутки включён. В `init` модуля `fastforward` сбрасывается через `setValue(false)`; дальше — `START` / `STOP` / `TOGGLE`. |
+| `fastforwardStorage` | `Set<string>` | Хеши уже просмотренных строк; наполняется из `STORAGE` в `init` модуля `fastforward.storage`. |
+
 ## Модули
 
 | Модуль | Зона ответственности |
 |--------|----------------------|
-| `fastforward` | Обрабатывает STOP, START, CHECK, TOGGLE, …. |
-| `fastforward.visits` | Визиты в `STORAGE`: `group` = label, `key` = hash; `GET_ALL` по module без group возвращает `label/hash`, при init hash берётся из хвоста ключа. На диске: `fastforward.visits/{label}.json`. |
+| `fastforward` | `STOP`, `START`, `CHECK`, `TOGGLE`; в `init` — `setValue(false)`. |
+| `fastforward.emit` | Цикл `EMIT` / `EMIT_CHECK`: `CHECK` → `INTERACT.EMIT`; провал `CHECK` → `STOP`. |
+| `fastforward.scenario` | `SCENARIO.EXEC` → hash стейта `fastforward.visits` и `VISIT_ADD`. |
+| `fastforward.visits` | `VISIT_ADD` пишет в `shared.fastforwardStorage` и снимок стейта. `CHECK` читает Set. |
+| `fastforward.storage` | `VISIT_ADD` → `STORAGE.SET` с `module` = `this.name`. `GET_ALL` / `RM_ALL` / `CLEAR`. `group` = label, `key` = hash; при init hash берётся из хвоста ключа. На диске: `fastforward.storage/{label}.json`. |
 
 ## Близкие плагины
 
@@ -53,8 +66,6 @@
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.INIT
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
 - [storage.md](../core/storage.md) — `STORAGE`: EVENTS.GET_ALL, EVENTS.SET, EVENTS.RM_ALL
-- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
-- [vendors.md](../core/vendors.md) — `VENDORS`: EVENTS.HASH
 
 ### Остальные