chuijs 4.0.1 → 4.0.3

package/CHANGELOG.md

@@ -3,6 +3,119 @@
 Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
 версии — [Semantic Versioning](https://semver.org/lang/ru/).
 
+## [4.0.3] - 2026-09-30
+
+### Добавлено
+
+- **CI для GitVerse** — `.gitverse/workflows/ci.yaml`. На Node 18, 20 и 22 гоняются линтер,
+  проверка форматирования, проверка типов и тесты; отдельными задачами — покрытие (`c8`,
+  отчёт уходит артефактом) и сверка того, что сайт документации и `index.d.ts` пересобраны.
+  Установка идёт через `npm install`: lock-файл в репозиторий не коммитится.
+- **Типы публичного API** — `index.d.ts` (подключён через `types` в `package.json`).
+  Опции конструкторов собираются из заготовок в самих компонентах
+  (`constructor(options = { width: String() })` → `width?: string`), имена и порядок экспортов —
+  из `index.js`. Файл генерируется: `npm run types:build`, проверяется `npm run types:check`
+  (компилятор TypeScript) и стендом `test/types.smoke.ts`.
+- **Проверки и скрипты:** `npm run check` (линт + формат + типы + тесты + доки),
+  `npm run test:coverage` (покрытие через `c8`), `npm run docs:check`
+  (`scripts/check-docs.js`: сборка документации не должна менять рабочее дерево),
+  `npm run types:build` / `types:check`.
+- **Тесты компонентов** — `test/chui_component_dom.test.js` на `jsdom`: поведение `Badge`,
+  `Label`, `Divider` и `Kbd` (текст, подпись, ориентация, клавиши, доступное имя) и проверка
+  того, что каждый подключённый через `setStyles()` css-файл существует.
+- **Тест публичного API** — `test/chui_exports.test.js`: имена экспортов не повторяются,
+  каждый ссылается на объявленное имя, каждый относительный `require` ведёт в существующий файл.
+- `CONTRIBUTING.md` — окружение, команды, структура, порядок добавления компонента.
+- `.editorconfig` — те же отступы, что у Prettier, чтобы редакторы не расходились со стилем.
+
+### Изменено
+
+- **README — только для пользователя пакета (103 → 71 строка).** Из него убрано всё
+  разработческое: команды проверок, `types:build`/`docs:build`, сборка сайта и детали устройства
+  репозитория — это переехало в `CONTRIBUTING.md`. В README остались описание фреймворка,
+  установка, быстрый старт, ссылки на справочник и лицензия.
+- **README сокращён с 727 до 103 строк: его разделы переехали в `docs/content/`** — `start.md`
+  («Начало работы»), `i18n.md` (локализация и RTL), `roadmap.md` («В разработке»), `modules.md`
+  и страница на каждый модуль (`main.md`, `desktop.md`, `security.md` и другие). Текст перенесён
+  дословно: собранный сайт отличается только пометкой «Тексты этого раздела — из `docs/content/`».
+  `docs/build.js` разбор README больше не делает, поэтому у документации один источник правды —
+  `docs/content/*.md`, а README снова читается как обычная страница репозитория.
+- **Prettier применяется ко всему поддерживаемому коду.** Из проверки исключены только
+  сгенерированный сайт (`docs/*.html`, `docs/components/` и другие страницы) и тексты страниц
+  `docs/content/*.md` — их переформатирование ломало бы разметку. `npm run format:check`
+  проходит, поэтому проверка добавлена в CI. Для YAML задан отступ 2 пробела.
+- **`npm run test:coverage` считает весь `framework/**`**, а не только файлы, загруженные тестами.
+  Без `--all` c8 показывал 95% (в отчёт попадали лишь импортированные модули), с ним картина
+  честная — пока около 6%. Из подсчёта исключены `chui_fonts.js` (данные шрифтов) и
+  `preload.js` (загружает Electron, а не `require`).
+- Тесты, читающие исходники регулярками (`chui_services_sync.test.js`), больше не зависят от
+  переносов строк и отступов: текст сравнивается с нормализованным пробелам.
+- `main.js`: вместо `console.log` — `Log`; убран закомментированный код отладки.
+
+### Исправлено
+
+- **Главная страница документации приведена в соответствие с кодом**: числа компонентов по
+  группам (13 / 29 / 73 / 21 вместо 12 / 29 / 77 / 21), ссылка на раздел «Модули и сервисы»
+  вместо утверждения «остались в README», убран раздел о публикации в GitHub Wiki — каталога
+  `wiki/` в репозитории давно нет.
+- `.gitignore` и ESLint игнорируют каталог отчёта покрытия `coverage/`.
+
+### Пакет
+
+- Версия 4.0.3.
+
+## [4.0.2] - 2026-09-29
+
+### Исправлено
+
+- **Заголовок страницы вернулся в шапку.** `Route#go()` больше не подмешивает название в
+  содержимое: узел `page_title` (появился в 4.0.1) и его стили удалены. Он дублировал заголовок,
+  который страница рисует сама, а `Page#render()` отдаёт один и тот же узел — повторный переход
+  на ту же страницу (кнопка «Назад» из `Page#setBackButton()`) добавлял второй заголовок.
+  Название показывает узел `page_name` в шапке, у страницы с меню-баром он по-прежнему скрыт —
+  место занимает полоса меню.
+
+### Изменено
+
+- **`Desktop.app.path()` отвечает значением, а не промисом.** Из путей страница собирает свои
+  (файлы, логи, кеш) на старте, где `await` пришлось бы протаскивать через весь код инициализации.
+  Путь приходит по синхронному каналу (`SERVICES_SYNC_CALLS`: `ipcRenderer.sendSync` в странице,
+  `ipcMain.on` + `event.returnValue` в main) и кешируется — за одним именем в main ходят один раз.
+  Ответ идёт конвертом `{value}`/`{error}`: у `sendSync` нет канала для исключения, поэтому отказ
+  (имя вне белого списка) приходит странице обычной ошибкой с текстом main. Прежний
+  `await Desktop.app.path(...)` продолжает работать — `await` на строке возвращает ту же строку.
+  Асинхронный канал `APP_PATH` оставлен: его ключ есть в карте `window.chui.services`.
+
+### Добавлено
+
+- **`Desktop.app.quit()` и `Desktop.app.restart()`** — закрытие и перезапуск приложения со страницы,
+  в том числе из безопасного окна (`window.chui.desktop.app.quit()`). Идут через `Main.stop()`/
+  `Main.restart()`, то есть теми же шагами, что пункт меню «Выход»: снимаются обработчики сервисов,
+  глобальные клавиши и подписки, а не просто закрывается окно. Отвечают значением, а не промисом
+  (синхронные каналы `appQuitSync`/`appRestartSync`), поэтому `await` не обязателен; выход
+  откладывается `setImmediate`, чтобы ответ успел уйти странице. Асинхронные каналы
+  `APP_QUIT`/`APP_RESTART` оставлены: их ключи есть в карте `window.chui.services`.
+- Тесты `test/chui_services_sync.test.js` и `test/chui_app_lifecycle.test.js`: сверяют синхронные
+  каналы (main ↔ мост preload ↔ страница) и то, что закрытие с перезапуском идут именно через
+  `Main.stop()`/`Main.restart()`.
+
+### Удалено
+
+- **Класс `App` и вспомогательный `Application` удалены.** `App.get()`, `App.getSession()`,
+  `App.getWebContents()` и все `App.*Path()` больше не экспортируются. Пути теперь отдаёт
+  `Desktop.app.path(name)` — и на странице, и в main-процессе: там канала нет, поэтому путь
+  берётся у Electron напрямую с той же проверкой белого списка `APP_PATH_NAMES`. Сырые объекты
+  Electron в main отдают `Desktop.app.get()`, `Desktop.app.getSession()` и
+  `Desktop.app.getWebContents()`; со страницы они бросают ошибку с подсказкой (`Desktop.session.*`,
+  `Desktop.dialog` или свой канал из `security.channels`).
+  **Ломающее:** `const { App } = require('chuijs')` перестаёт работать.
+- Тест `test/chui_app_paths.test.js` переписан: сверяет белый список с ожидаемым набором имён
+  путей и проверяет оба валидатора — `appPathByName` (`index.js`) и `#appPathInMain` (`desktop.js`).
+
+### Пакет
+
+- Версия 4.0.2.
+
 ## [4.0.1] - 2026-09-28
 
 ### Добавлено