@vnejs/docs 0.2.20 → 0.2.22

package/CHANGELOG.md

@@ -1,6 +1,24 @@
 # 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
+
+- `core/media` — ошибка/timeout fetch не занимает слот semaphore и не кладёт битый blob в память; `GET` не ждёт вечно и возвращает `null` для отсутствующего или битого asset.
+- `core/scenario` — `LABEL_GET` / `LINE_GET` завершаются, если предзагрузка одной строки упала.
+- `cli/desktop` — закрытие последнего окна завершает Electron и на macOS (Steam не держит игру запущенной); Fastify закрывается на quit, если процесс не выходит — `app.exit(0)`. API: `runServer` возвращает `{ port, close }`, `runElectron` принимает `onBeforeQuit`.
 
 ## 0.2.20
 

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.20",
+  "version": "0.2.22",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/core/media.md

@@ -8,14 +8,14 @@
 
 | Ключ | Строка | Смысл |
 |------|--------|-------|
-| `GET` | `vne:media:get` | Получить готовый медиа-элемент: из кэша или через цепочку load. |
+| `GET` | `vne:media:get` | Получить готовый медиа-элемент: из кэша или через цепочку load. Битый или отсутствующий asset → `null`, без вечного wait. |
 | `SET` | `vne:media:set` | Положить готовый DOM-элемент в memory-подсистему media. |
-| `LOAD` | `vne:media:load` | Запуск загрузки по id/type/name с учётом semaphore и dedup через `LOAD_CHECK`. |
+| `LOAD` | `vne:media:load` | Запуск загрузки по id/type/name с учётом semaphore и dedup через `LOAD_CHECK`. Слот очереди освобождается и при ошибке. |
 | `LOAD_CHECK` | `vne:media:load_check` | Проверить: уже в памяти, в процессе process или load. |
 | `LOAD_START` | `vne:media:load_start` | Начало загрузки asset (маркер lifecycle). |
 | `LOAD_END` | `vne:media:load_end` | Окончание загрузки asset (маркер lifecycle). |
 | `ERROR_NO_SRC` | `vne:media:error_no_src` | В манифесте нет src для запрошенного asset. |
-| `ERROR_FETCH` | `vne:media:error_fetch` | Ошибка fetch при загрузке blob. |
+| `ERROR_FETCH` | `vne:media:error_fetch` | Ошибка fetch: сеть, HTTP не-ok, timeout. Битый blob в память не кладётся. |
 | `PROCESS` | `vne:media:process` | Скачать blob, создать `<img>` / `<audio>` / `<video>`, вызвать `SET`. |
 | `PROCESS_CHECK` | `vne:media:process_check` | Есть ли уже promise/результат process для `mediaId`. |
 | `MEMORY_GET` | `vne:media:memory_get` | Прокси к `MEMORY.GET` для namespace media. |
@@ -39,10 +39,10 @@
 
 | Модуль | Зона ответственности |
 |--------|----------------------|
-| `media.load` | Semaphore-gated load, dedup, делегирование в process/memory. |
-| `media.process` | Fetch blob и создание DOM-медиа. |
+| `media.load` | Semaphore-gated load, dedup, делегирование в process/memory. Слот всегда освобождается (`finally`), даже если process reject. |
+| `media.process` | Fetch blob и создание DOM-медиа. HTTP не-ok и timeout fetch → `ERROR_FETCH`, без `SET`. |
 | `media.memory` | REG в memory, монтирование элементов в скрытый `#media`. |
-| `media` | Высокоуровневый get/set. |
+| `media` | Высокоуровневый get/set. `GET` возвращает `null`, если asset нет или не готов (битая картинка, error). |
 | `media.logs` | Логирование lifecycle media. |
 
 ## Близкие плагины

package/plugins/core/scenario.md

@@ -11,9 +11,9 @@
 | `EXEC` | `vne:scenario:exec` | Выполнить строку сценария: dispatch по module/block с line, args и keywords. |
 | `EXEC_DELAY` | `vne:scenario:exec_delay` | Отложить promise до завершения текущего exec (async-строки). |
 | `NEXT` | `vne:scenario:next` | Шаг вперёд по сценарию: выполнить текущую строку или завершить текущую метку. |
-| `LABEL_GET` | `vne:scenario:label_get` | Предзагрузка строк метки на глубину `deep` с приоритетом. |
+| `LABEL_GET` | `vne:scenario:label_get` | Предзагрузка строк метки на глубину `deep` с приоритетом. Упавшая строка не блокирует метку. |
 | `LINE_LOAD` | `vne:scenario:line_load` | Условная предзагрузка одной строки (с учётом depth в memory). |
-| `LINE_GET` | `vne:scenario:line_get` | Получить и подготовить одну строку сценария по label и index. |
+| `LINE_GET` | `vne:scenario:line_get` | Получить и подготовить одну строку сценария по label и index. Ошибка предзагрузки не оставляет промис висящим. |
 | `LINE_LOAD_REG` | `vne:scenario:line_load_reg` | Зарегистрировать обработчик предзагрузки строк для module/block. |
 | `LINE_EXEC_REG` | `vne:scenario:line_exec_reg` | Зарегистрировать обработчик выполнения строк для module/block. |
 | `LINES_GET` | `vne:scenario:lines_get` | Получить массив строк метки (JSON с хоста, кэш в memory). |
@@ -48,8 +48,8 @@
 | `scenario` | Главный цикл `NEXT`, exec строк, sync state. |
 | `scenario.autostart` | Дефолт `shared.shouldAutostartScenario`; на `SYSTEM.STARTED` — init label + `emitNext` при включённом флаге. |
 | `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
-| `scenario.label` | `LABEL_GET`, preload меток; init label на `STATE.CLEAR`. |
-| `scenario.line` | `LINE_LOAD` / `LINE_GET`, registry preload handlers. |
+| `scenario.label` | `LABEL_GET`, preload меток; init label на `STATE.CLEAR`. Одна упавшая строка не валит всю метку. |
+| `scenario.line` | `LINE_LOAD` / `LINE_GET`, registry preload handlers. Executor `LINE_GET` всегда resolve. |
 | `scenario.lines` | Fetch `label/<path>.json` с `HOST` (например `label/prologue/1.json`). |
 
 ## Близкие плагины

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
 
 ### Остальные