chuijs 4.0.0 → 4.0.2

package/CHANGELOG.md

@@ -0,0 +1,117 @@
+# Changelog
+
+Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
+версии — [Semantic Versioning](https://semver.org/lang/ru/).
+
+## [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
+
+### Добавлено
+
+- **`StickyBar`** — прилипающая полоса: компонент остаётся у верха области прокрутки, пока его
+  содержимое не кончилось. В покое не рисует фона и рамки, у закреплённой появляются материал,
+  волосяной край и тень; состояние отдаётся в `data-stuck` и `onChange(stuck)`.
+- Раздел `StickyBar` в витрине: карточка в каталоге группы «Компоновка и навигация» с показом
+  закрепления.
+- Страница **«История изменений»** на сайте документации: собирается из `CHANGELOG.md`, чтобы
+  журнал не расходился с копией в доке. Дорога к ней — из навигации и с бейджа версии на главной.
+- Тест `test/chui_app_paths.test.js`: белый список путей приложения не разойдётся с `App.*Path()`.
+
+### Изменено
+
+- **Рендер markdown переведён с `showdown` на `markdown-it`** (HTML), обратный разбор — на
+  `turndown`. `showdown` не обновлялся с 2022 года, исправленной версии у него нет, а аудит
+  показывал три неустранённые уязвимости (ReDoS и две XSS) именно в пути «markdown → innerHTML».
+  Новый разбор идёт с `html: false`: сырой HTML в `markdownText` теперь **показывается текстом,
+  а не исполняется** — это и закрывает XSS. Таблицы и `~~зачёркивание~~` работают как раньше,
+  авто-ссылок нет (адрес становится ссылкой только явным `[текст](адрес)`). Сайт документации
+  собирается тем же `markdown-it`; `npm audit` — 0 уязвимостей.
+- **`@electron/remote` убран полностью** — Electron не рекомендует отдавать странице модули
+  main-процесса. Кнопки окна ходят в main по каналам `WINDOW_ACTION` / `WINDOW_STATE` (обработчики
+  регистрируются и в обычном режиме, `enableServices`), а пути, диалоги и сессия доступны как
+  `Desktop.app.path()/info()`, `Desktop.dialog.*`, `Desktop.session.*` или свой канал из
+  `security.channels`; в безопасном окне то же отдаёт мост `window.chui`. `chooseFile` со страницы
+  идёт по IPC в своё окно, в main работает напрямую. **Ломающее:** `App.get()`, `App.getSession()`,
+  `App.getWebContents()` и `App.*Path()` теперь только для main-процесса — со страницы они бросают
+  ошибку с подсказкой. Убраны устаревшие `enableRemoteModule` из `webPreferences`.
+- **`Spinner`** переделан: вместо трёх вложенных колец — одно тонкое кольцо с приглушённой
+  дорожкой и гладкой дугой со скруглёнными концами. Цвет дуги задаётся `style.color`,
+  при `prefers-reduced-motion` вращение замедляется. Публичный API сохранён.
+- **Кнопки окна** (`AppLayout`): значки свернуть/развернуть/восстановить/закрыть нарисованы
+  линиями (SVG) вместо лигатур шрифта иконок — не зависят от Material Symbols.
+- **Шапка**: низ скруглён (логические радиусы), волосяная черта снизу сохранена.
+- **`UpdateNotification`**: под спиннером больше нет заливки плашки (`notification_icon_plain`) —
+  подложка читалась вторым фоном вокруг тонкого индикатора.
+- Витрина: липкая навигация по разделам переведена на `StickyBar`.
+- `DataGrid.exportToClipboard()`: резервный буфер обмена берётся через `Desktop`, а не напрямую
+  из `electron` — работает и в безопасном окне.
+- `chui_functions.setStyles()` кэширует прочитанные таблицы стилей: один файл отдаётся разным
+  `id` без повторного чтения с диска.
+- Документация: сайт пересобран, добавлены страницы `StickyBar` и «История изменений», в README —
+  раздел про разметку `markdownText`, её безопасный режим и группы моста `window.chui.desktop`.
+  Примеры в разделах о безопасности больше не упоминают `enableRemoteModule` — опции, которой в
+  `webPreferences` больше нет.
+
+### Пакет
+
+- Версия 4.0.1.
+- Удалена неиспользуемая зависимость `dataurl`: в коде не было ни одного `require`, ни реэкспорта.
+- Добавлены `repository`, `bugs`, `engines` и карта экспортов (`exports`) с сохранением глубоких
+  импортов вида `require('chuijs/framework/modules/chui_fonts')`.
+- Явно указан `"type": "commonjs"`.
+
+## [4.0.0]
+
+- Версия 4.0.0: реструктуризация модулей, локализация и RTL, десктоп-сервисы и безопасный режим
+  окон, статический сайт документации (`npm run docs:build`).

package/README.md

@@ -60,7 +60,7 @@ render(() => new App()).catch(err => Log.error(err))
 #### exampleApp / main.js
 ```javascript
 /** main.js */
-const { Main, MenuItem, path, App } = require('chuijs');
+const { Main, MenuItem, path, Desktop } = require('chuijs');
 const main = new Main({
     name: "exampleApp",
     // размеры окна задаются вложенным объектом sizes
@@ -73,9 +73,9 @@ const main = new Main({
     render: `${__dirname}/app/app.js`,
     devTools: false,
     resizable: true,
-    // папка загрузок (по умолчанию App.downloadsPath())
+    // папка загрузок: если не задана, путь выбирает Electron
     paths: {
-        downloadPath: path.join(App.userDataPath(), "downloads")
+        downloadPath: path.join(Desktop.app.path("userData"), "downloads")
     }
     /** icon: `${__dirname}/resources/icons/app/icon.png` */
 });
@@ -95,8 +95,9 @@ main.start({
 > поэтому окно доступно через `main.getWindow()` только после старта.
 #### Download Session в main.js
 ```javascript
-const { App } = require('chuijs');
-App.get().on('session-created', (session) => {
+const { Desktop } = require('chuijs');
+const app = Desktop.app.get();      // сырой `app` — только в main-процессе
+app.on('session-created', (session) => {
     session.on('will-download', (e, item, contents) => {
         // ...
     });
@@ -124,14 +125,14 @@ async function run() {
 Создаёт окно, трей и управляет жизненным циклом приложения.
 
 ```javascript
-const { Main, MenuItem, App } = require('chuijs');
+const { Main, MenuItem, Desktop } = require('chuijs');
 const main = new Main({
     name: 'exampleApp',
     sizes: { width: 1366, height: 768, minWidth: 960, minHeight: 540 },
     render: `${__dirname}/app/app.js`,
     devTools: false,
     resizable: true,
-    paths: { downloadPath: path.join(App.userDataPath(), 'downloads') }
+    paths: { downloadPath: path.join(Desktop.app.path('userData'), 'downloads') }
 });
 main.start({ hideOnClose: false, tray: [new MenuItem().quit('Выход')] });
 ```
@@ -178,29 +179,37 @@ main.getWindows();                                    // [{name, window}, …]
 `stop()` и `restart()` снимают свои обработчики: IPC (`show_system_notification`, `SEND_LOG_TEXT`,
 `updateInstallConfirm`), обработчики десктоп-сервисов вместе с глобальными клавишами,
 подписку апдейтера и глобальные обработчики ошибок процессов —
-повторный `start()` подпишет их заново по одному разу.
+повторный `start()` подпишет их заново по одному разу. Со страницы то же делают
+`Desktop.app.quit()` и `Desktop.app.restart()`: страница — код самого приложения, поэтому своей
+кнопке «Выход» не нужен отдельный канал в каждом проекте. Оба отвечают значением, а не промисом
+(синхронный канал, как у `Desktop.app.path`), поэтому `await` не обязателен.
 
-#### `App`
-Обёртка над `app` Electron.
+Пути приложения отдаёт `Desktop.app.path(name)` — и в main-процессе, и на странице, значением
+без промиса (на странице — синхронным каналом, в main — прямо у Electron):
 
 ```javascript
-const { App } = require('chuijs');
-App.get();             // app
-App.getSession();      // session
-App.getWebContents();  // webContents
+const { Desktop } = require('chuijs');
+Desktop.app.path('userData');     // .../AppData/<name>
+Desktop.app.path('downloads');
+Desktop.app.path('logs');
 ```
 
-#### `App.*Path()`
-Статические системные пути (все возвращают строку).
+Имена берутся из белого списка: `home`, `appData`, `userData`, `sessionData`, `temp`, `exe`,
+`module`, `desktop`, `documents`, `downloads`, `music`, `pictures`, `videos`, `logs`, `recent`,
+`crashDumps`; всё, что вне списка, отклоняется. Со страницы то же значение доступно как
+`window.chui.desktop.app.path('userData')`.
+
+Сырые объекты Electron (`app`, `session`, `webContents`) странице не отдают — Electron не
+рекомендует `remote`. В main-процессе их отдают `Desktop.app.get()`, `Desktop.app.getSession()`
+и `Desktop.app.getWebContents()`:
 
 ```javascript
-const { App } = require('chuijs');
-App.userDataPath();     // .../AppData/<name>
-App.downloadsPath();
-App.logsPath();
+const app = Desktop.app.get();                   // main.js
+app.on('session-created', (session) => { /* … */ });
 ```
 
-Полный список: `homePath()`, `appDataPath()`, `userDataPath()`, `sessionDataPath()`, `logsPath()`, `tempPath()`, `exePath()`, `modulePath()`, `desktopPath()`, `documentsPath()`, `downloadsPath()`, `musicPath()`, `picturesPath()`, `videosPath()`, `recentPath()`, `crashDumpsPath()`.
+Со страницы эти методы бросают ошибку с подсказкой: вместо них берут `Desktop.session.*`,
+`Desktop.dialog` или свой канал из `security.channels`.
 
 #### `Log`
 Пишет в `userData/logs/app_<date>.log`.
@@ -277,7 +286,8 @@ await bot.sendMessage({ chat_id: '123', text: 'привет' });
 доступны только там), а страница работает с ними через `Desktop`: он сам выбирает транспорт —
 канал `ipcRenderer.invoke` в обычном режиме или методы `window.chui.services` (preload +
 `contextBridge`) в безопасном. Имена каналов лежат в одном модуле `chui_services/chui_channels`,
-поэтому main и рендерер не расходятся.
+поэтому main и рендерер не расходятся. Пути приложения — единственное исключение: они идут
+синхронным каналом (`Desktop.app.path` отвечает значением, а не промисом, см. ниже).
 
 ```javascript
 const { Desktop } = require('chuijs');
@@ -299,6 +309,16 @@ offTheme();
 await Desktop.print.page();                  // системный диалог печати текущего окна
 await Desktop.print.html('<h1>Отчёт</h1>');  // печать HTML из скрытого окна
 await Desktop.print.pdf(html, {path: '/tmp/отчёт.pdf'});   // PDF без диалога (или с ним, без path)
+const userData = Desktop.app.path('userData');            // каталог настроек приложения, сразу
+await Desktop.app.info();                                 // {name, version, locale, isPackaged}
+const app = Desktop.app.get();                            // сырой `app` — только в main-процессе
+Desktop.app.quit();                                       // выход: тот же, что у пункта меню «Выход»
+Desktop.app.restart();                                    // перезапуск процесса (состояние не переносится)
+const {canceled, filePaths} = await Desktop.dialog.open({properties: ['openFile']});
+await Desktop.dialog.save({defaultPath: '/tmp/отчёт.pdf'});
+await Desktop.dialog.message({type: 'question', message: 'Продолжить?'});
+await Desktop.session.clearCache();                       // кеш своей сессии
+await Desktop.session.clearStorageData({storages: ['cookies']});
 ```
 
 Глобальная клавиша регистрируется в main один раз на комбинацию: сколько бы окон ни подписалось,
@@ -389,9 +409,9 @@ const preview = await main.createWindow({
 
 Что меняется в таком окне:
 
-- `nodeIntegration: false`, `contextIsolation: true`, `enableRemoteModule: false`,
-  `nodeIntegrationInSubFrames: false`, `webviewTag: false` — `require`, `process` и `module`
-  в странице недоступны, `@electron/remote` тоже;
+- `nodeIntegration: false`, `contextIsolation: true`, `nodeIntegrationInSubFrames: false`,
+  `webviewTag: false` — `require`, `process` и `module` в странице недоступны, модули
+  main-процесса (в том числе `@electron/remote`) тоже;
 - preload'ом становится мост фреймворка (`framework/modules/chui_bridge/preload.js`),
   а `render` — **скрипт документа**: мост подключает его как обычный `<script>` после
   `DOMContentLoaded`. Поэтому код вроде `require('chuijs')` в таком окне не работает —
@@ -409,6 +429,13 @@ window.chui.desktop.clipboard.readText();   // то же, что Desktop из re
 window.chui.desktop.recent.list();
 window.chui.desktop.progress.set(0.4);
 const off = window.chui.desktop.shortcuts.on('Mod+Shift+P', () => {});
+window.chui.desktop.app.path('userData');                  // путь приложения — сразу, без промиса
+await window.chui.desktop.app.info();                      // {name, version, locale, isPackaged}
+window.chui.desktop.app.quit();                            // закрыть всё приложение (окно — window.chui.window)
+window.chui.desktop.app.restart();                         // перезапустить приложение (тоже без промиса)
+const res = await window.chui.desktop.dialog.open({properties: ['openFile']});
+await window.chui.desktop.dialog.message({type: 'question', message: 'Продолжить?'});
+await window.chui.desktop.session.clearCache();
 window.chui.theme.get();                    // 'light' | 'dark'
 window.chui.theme.onChange((theme) => {});
 window.chui.window.minimize(); window.chui.window.toggleMaximize(); window.chui.window.close();
@@ -435,7 +462,9 @@ const { BrowserWindow, ipcMain, ipcRenderer, shell, path, fs, os, request,
         transliterate, systemPreferences, chooseFile, store, downloadSession } = require('chuijs');
 ```
 
-`chooseFile` — это `dialog` из `@electron/remote/main`, `store` — готовый экземпляр `new Store()`.
+`chooseFile` — диалоги `showOpenDialog` / `showSaveDialog` / `showMessageBox`: со страницы они идут
+по IPC в окно, которое их вызвало (`Desktop.dialog`), а в main — напрямую `dialog` Electron.
+`store` — готовый экземпляр `new Store()`.
 
 #### Автоматическое обновление приложения
 Только AppImage и NSIS.
@@ -604,6 +633,12 @@ Desktop.locale.onChange((locale) => I18n.setLocale(locale));
 DOM-элемент, поэтому внутри `Page.add(...)`, `Card.add(...)`, `ContentBlock.add(...)` передаётся
 сам объект, а в `Form.components` / `SlideShow.SLIDE` / `FieldSet.components` — тоже объекты.
 
+**Разметка `markdownText`.** Компоненты с этой опцией (`Label`, `Tooltip`, `Badge`, `Alert`,
+`Notification`, `ToastQueue`, `Chat`, `Tour`, `MarkdownEditor`) рендерят её `markdown-it` в безопасном
+режиме: сырой HTML из разметки не исполняется, а показывается текстом — так закрыт XSS через
+`markdownText`. Таблицы и `~~зачёркивание~~` поддерживаются, авто-ссылок нет: адрес становится
+ссылкой только явным `[текст](адрес)`. Обратный разбор (`htmlToMarkdown`) делает `turndown`.
+
 Описание каждого компонента — отдельная страница статического сайта документации в [`docs/`](docs/):
 [`docs/index.html`](docs/index.html) — полный индекс по группам и алфавиту, а у каждой страницы сверху
 ссылка на группу и общий список. Сайт собирается генератором `node docs/build.js`
@@ -621,7 +656,7 @@ DOM-элемент, поэтому внутри `Page.add(...)`, `Card.add(...)`
 [Константы и статические фабрики](docs/topics/constants.html), [Сценарии целиком](docs/topics/scenarios.html),
 [Витрина компонентов](docs/topics/showcase.html).
 
-Модули и десктоп-сервисы (`Main`, `App`, `I18n`, `Theme`, `Desktop`, `Log`) описаны выше, в разделе «Модули».
+Модули и десктоп-сервисы (`Main`, `I18n`, `Theme`, `Desktop`, `Log`) описаны выше, в разделе «Модули».
 
 ### В разработке
 

package/framework/appLayout/default/chui_app_layout.js

@@ -13,6 +13,7 @@ const {DownloadNotification} = require("../../components/chui_notification/notif
 const {Log} = require("../../../framework/modules/chui_logger/chui_logger");
 const {MenuKeyboard, makeKeyboardButton} = require('../../modules/chui_a11y/chui_a11y');
 const {LAYOUT_ROLE, LayoutRefs, registerLayout, requireLayoutNode} = require('../../modules/chui_layout/chui_layout');
+const {BRIDGE_CHANNELS} = require('../../modules/chui_services/chui_channels');
 const {OverlayScrollbars} = require('../../modules/chui_scrollbar/chui_scrollbar');
 const {MenuBar} = require('../../components/chui_menu_bar/menu_bar');
 const {Avatar} = require('../../components/chui_avatar/avatar');
@@ -88,19 +89,12 @@ class Route extends Events {
         //
         setPageName(page.getTitle());
         center.innerHTML = '';
-        const page_node = page.render();
-        // Заголовок страницы — в содержимом, первым блоком (вид — `page_title` в
-        // chui_page/styles.css). Текст идёт текстовым узлом, а не разметкой: имя
-        // страницы приходит от приложения и могло бы принести теги
-        const title = page.getTitle();
-        if (title !== undefined && title !== null && String(title) !== "") {
-            const block = document.createElement("page_title");
-            const icon = page.getIcon();
-            if (icon !== undefined && icon !== null) block.innerHTML = String(icon);
-            block.appendChild(document.createTextNode(String(title)));
-            page_node.prepend(block);
-        }
-        center.appendChild(page_node);
+        // Содержимое собирает сама страница (`Page#render`), оболочка в него не подмешивает
+        // ничего: узел `page_title` (был здесь) дублировал заголовок, который страница
+        // рисует сама, а `Page#render` отдаёт один и тот же узел — повторный переход на тот
+        // же экземпляр страницы (кнопка «Назад» из `Page#setBackButton`) добавлял второй
+        // заголовок. Место названия — шапка (`setPageName`).
+        center.appendChild(page.render());
         const _page = center.querySelector('page');
         new Animation(_page).fadeIn();
         // Стирания `center.removeAttribute("style")` здесь больше нет: инлайновых
@@ -157,6 +151,22 @@ function makeHeaderButtonBox(options = { title: undefined, icon: undefined, reve
     return button;
 }
 
+/**
+ * Значки кнопок окна нарисованы линиями, а не взяты из шрифта иконок: системные кнопки
+ * должны выглядеть одинаково, даже если Material Symbols недоступен (веб-сборка, безопасное
+ * окно, где шрифт фреймворка не подключён). «Свернуть»/«развернуть» — зеркальные шевроны,
+ * «восстановить» — контурный ромб, «закрыть» — крест. Все четыре значка вписаны в один
+ * квадрат 20×20 и центрированы геометрически (чернила симметричны относительно 10,10),
+ * поэтому в кнопке они стоят ровно и читаются одной тройкой. Толщина 1.3 и скругления
+ * подобраны под вид набора; цвет наследуется от кнопки через `currentColor`.
+ */
+const WINDOW_ICONS = {
+    minimize: '<svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><path d="M4.5 7.5 L10 12.5 L15.5 7.5" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/></svg>',
+    maximize: '<svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><path d="M4.5 12.5 L10 7.5 L15.5 12.5" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/></svg>',
+    restore: '<svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><path d="M10 5 L15 10 L10 15 L5 10 Z" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/></svg>',
+    close: '<svg viewBox="0 0 20 20" aria-hidden="true" focusable="false"><path d="M5 5 L15 15 M15 5 L5 15" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>',
+};
+
 class WindowControls {
     // Управление кнопками
     #box = document.createElement("wc_box")
@@ -166,70 +176,73 @@ class WindowControls {
     // Подписка на нересайзящееся окно: set() вызывается и из конструктора Header, и из
     // addWC(), поэтому в set() слушатель ipcRenderer накапливался.
     #resizable_false_event = () => this.#maximize.remove();
-    // Прокси окна берём один раз: getCurrentWindow() — синхронный IPC, а состояние
-    // нужно и на resize. null — окно недоступно (безопасные окна живут без @electron/remote).
-    #current_window = false;
+    // Номер запроса состояния гасит ответы, пришедшие не в том порядке
+    #sync_request = 0;
     constructor() {
         // Скрипт окна может быть preload'ом и выполняться до документа: здесь документ уже настоящий,
         // поэтому `dir`/`lang` (и зеркалирование логических свойств CSS) встают гарантированно
         I18n.apply();
-        this.#setButton(this.#close, I18n.t("appLayout.window.close"), Icons.NAVIGATION.CLOSE);
-        // Линию «свернуть» берём знак `horizontal_rule`, а не `minimize`: у того линия стоит
-        // у нижнего края глифа (замер: центр чернил на 5.25px ниже центра кнопки), и кнопка
-        // читалась смещённой; `horizontal_rule` — ровная линия по центру
-        this.#setButton(this.#minimize, I18n.t("appLayout.window.minimize"), Icons.EDITOR.HORIZONTAL_RULE);
-        // Глиф «развернуть» — квадрат (crop_square): в наборе есть и `maximize`, но там это
-        // линия у верхнего края — визуально она неотличима от второй кнопки «свернуть»
-        this.#setButton(this.#maximize, I18n.t("appLayout.window.maximize"), Icons.IMAGE.CROP_SQUARE);
-        this.#close.addEventListener("click", () => {
-            const window_ = this.#getWindow();
-            if (window_ !== undefined) window_.close();
-        })
-        this.#minimize.addEventListener("click", () => {
-            const window_ = this.#getWindow();
-            if (window_ !== undefined) window_.minimize();
-        })
-        this.#maximize.addEventListener("click", () => {
-            const window_ = this.#getWindow();
-            if (window_ === undefined) return;
-            window_.isMaximized() ? window_.unmaximize() : window_.maximize();
-        })
+        this.#setButton(this.#close, I18n.t("appLayout.window.close"), "close");
+        // «Свернуть» — шеврон вниз: плоская широкая галочка читается лучше горизонтальной
+        // черты и не сливается с рамкой кнопки
+        this.#setButton(this.#minimize, I18n.t("appLayout.window.minimize"), "minimize");
+        // «Развернуть» — шеврон вверх, зеркало «свернуть»: пара читается как одна ось
+        this.#setButton(this.#maximize, I18n.t("appLayout.window.maximize"), "maximize");
+        this.#close.addEventListener("click", () => this.#windowAction("close"))
+        this.#minimize.addEventListener("click", () => this.#windowAction("minimize"))
+        // Разворот и восстановление — одно действие: решение принимает окно, а не кнопка
+        this.#maximize.addEventListener("click", () => this.#windowAction("toggle-maximize"))
         // Разворот приходит не только от нашей кнопки (двойной клик по полосе, меню окна),
         // поэтому состояние читаем по факту изменения размера окна
         window.addEventListener("resize", this.#sync_maximized_event)
         this.#syncMaximized()
         ipcRenderer.on("chui_resizable_false", this.#resizable_false_event)
     }
-    /** Кнопка окна — иконка шапки с именем для скринридера, фокусом и активацией с клавиатуры.
-     *  Кегль глифа задаёт CSS (см. global_style.css): у кнопок окна он меньше, чем у соседних
-     *  иконок шапки, поэтому опция размера здесь не передаётся */
+    /** Кнопка окна — значок с именем для скринридера, фокусом и активацией с клавиатуры.
+     *  Значок рисуется линиями (`WINDOW_ICONS`), размер задаёт CSS (см. global_style.css) */
     #setButton(button, label, icon) {
-        button.innerHTML = new Icon(icon).getHTML();
+        button.innerHTML = WINDOW_ICONS[icon];
         button.setAttribute("title", label);
         button.setAttribute("aria-label", label);
         makeKeyboardButton(button);
     }
-    #getWindow() {
-        if (this.#current_window === false) {
-            try {
-                this.#current_window = require("@electron/remote").getCurrentWindow();
-            } catch (_error) {
-                this.#current_window = null;
-            }
+    /**
+     * Действия кнопок окна идут по IPC в main (`WINDOW_ACTION`/`WINDOW_STATE`). Прежде здесь
+     * стоял `@electron/remote`, но он устарел и тянул модули main-процесса прямо в страницу.
+     * Обработчики берут окно отправителя, поэтому канал не может задеть чужое окно; ошибка
+     * глушится — без `Main` (обработчики не зарегистрированы) нажатие не должно ломать страницу.
+     */
+    #windowAction(action = String()) {
+        try {
+            return Promise.resolve(ipcRenderer.invoke(BRIDGE_CHANNELS.WINDOW_ACTION, action)).catch(() => false);
+        } catch (_error) {
+            return Promise.resolve(false);
+        }
+    }
+
+    /** Состояние окна: `{isMaximized, isMinimized, …}`; без окна — пустой объект */
+    async #windowState() {
+        try {
+            return (await ipcRenderer.invoke(BRIDGE_CHANNELS.WINDOW_STATE)) ?? {};
+        } catch (_error) {
+            return {};
         }
-        return this.#current_window === null ? undefined : this.#current_window;
     }
-    // Развёрнутое окно — другой глиф и другая подпись: кнопка возвращает окно в оконный режим.
-    // Знак «восстановить» — те же два квадрата (`filter_none`); размер ему задаёт CSS
+    // Развёрнутое окно — другой значок и другая подпись: кнопка возвращает окно в оконный режим.
+    // «Восстановить» — контурный ромб; размер значкам задаёт CSS.
+    // Состояние приходит асинхронно, поэтому ответ устаревшего запроса отбрасывается по номеру:
+    // иначе быстрая пара «развернуть/восстановить» могла бы применить ответ в обратном порядке
     #syncMaximized() {
-        const window_ = this.#getWindow();
-        if (window_ === undefined) return;
-        const maximized = window_.isMaximized();
-        const label = maximized ? I18n.t("appLayout.window.restore") : I18n.t("appLayout.window.maximize");
-        this.#maximize.classList.toggle("wc_maximized", maximized);
-        this.#maximize.innerHTML = new Icon(maximized ? Icons.IMAGE.FILTER_NONE : Icons.IMAGE.CROP_SQUARE).getHTML();
-        this.#maximize.setAttribute("title", label);
-        this.#maximize.setAttribute("aria-label", label);
+        const request = ++this.#sync_request;
+        this.#windowState().then((state) => {
+            if (request !== this.#sync_request) return;
+            const maximized = state.isMaximized === true;
+            const label = maximized ? I18n.t("appLayout.window.restore") : I18n.t("appLayout.window.maximize");
+            this.#maximize.classList.toggle("wc_maximized", maximized);
+            this.#maximize.innerHTML = WINDOW_ICONS[maximized ? "restore" : "maximize"];
+            this.#maximize.setAttribute("title", label);
+            this.#maximize.setAttribute("aria-label", label);
+        });
     }
     #sync_maximized_event = () => this.#syncMaximized();
     set(pos_bool = Boolean()) {

package/framework/appLayout/default/global_style.css

@@ -454,15 +454,17 @@ header {
     display: flex;
     z-index: 999;
     flex-direction: column;
-    /* Шапка — плоская полоса во всю ширину с волосяной чертой снизу: содержимое уходит
-       под неё (материал полупрозрачный, с блюром). Углы прямые: скруглённые углы у полосы
-       во всю ширину окна не читались — вверху их срезал бы композитор, а внизу они
-       оставляли зазор. */
+    /* Шапка — плоская полоса во всю ширину: содержимое уходит под неё (материал
+       полупрозрачный, с блюром), низ скруглён и подчёркнут волосяной чертой. Радиус задан
+       логическими свойствами, поэтому в RTL скругление зеркалится; верхние углы прямые —
+       их срезал бы композитор. */
     align-items: start;
     background-color: var(--header_background);
     backdrop-filter: var(--global_blur);
     justify-content: space-between;
     border-bottom: 1px solid var(--border_color);
+    border-end-start-radius: var(--radius_md);
+    border-end-end-radius: var(--radius_md);
 }
 
 /* Прокрутка содержимого: материал плотнее и появляется тень — полоса читается
@@ -882,11 +884,14 @@ app_menu_empty {
    ниже содержимого, и длинное название выдавило бы кнопки за край окна. Полный текст
    лежит в подсказке (её ставит setPageName в chui_app_layout.js). */
 page_name {
-    /* Название переехало в содержимое страницы (`page_title` в chui_page/styles.css):
-       в шапке оно уезжало при прокрутке и делило полосу с кнопками. Узел оставлен
-       якорем — за ним разметка ставит полосу меню (`applyPageMenuBar`), а `setPageName`
-       продолжает держать текст для меню маршрутов и подсказки */
-    display: none;
+    /* Название показывает шапка, а не содержимое: оболочка в страницу его не подмешивает
+       (`Route#go`), поэтому приложение, рисующее свой заголовок, ничего не дублирует.
+       Узел — якорь полосы меню (`applyPageMenuBar` ставит её следом), и он же держит текст
+       для меню маршрутов и подсказки (`setPageName`).
+       У страницы с меню-баром название скрыто — место занимает полоса (правило
+       `.header_with_menu_bar page_name` ниже) */
+    display: flex;
+    align-items: center;
     outline: none;
     box-sizing: border-box;
     min-width: 0;
@@ -1253,25 +1258,21 @@ wc_close, wc_maximize, wc_minimize {
     transition: background-color var(--transition_time) ease, color var(--transition_time) ease;
 }
 
-/* Кегль глифов меньше соседних иконок шапки (--header_icon_size = 13pt): три системные
-   кнопки не должны перетягивать на себя внимание. Замер чернил при 14px: квадрат
-   9.6×9.6, линия 9.6×1.3, крест 7.9×7.9 — у креста знак мельче, так он нарисован
-   в наборе. chui_icon задаёт собственный color, поэтому цвет кнопки до глифа не доходит —
-   правила состояний ниже тоже про иконку. */
-wc_close chui_icon,
-wc_maximize chui_icon,
-wc_minimize chui_icon {
-    font-size: 14px;
+/* Значки кнопок окна нарисованы линиями (SVG), а не взяты из шрифта иконок: три системные
+   кнопки должны выглядеть одинаково и тогда, когда Material Symbols недоступен (веб-сборка,
+   безопасное окно без шрифта фреймворка). Все четыре значка вписаны в один квадрат 20×20 и
+   центрированы геометрически, поэтому при общем размере 16 пикселей стоят ровно и читаются
+   одной тройкой. Цвет приходит от кнопки через `currentColor`, поэтому состояния ниже красят
+   сам `svg`. */
+wc_close svg,
+wc_maximize svg,
+wc_minimize svg {
+    display: block;
+    width: 16px;
+    height: 16px;
     color: var(--text_color_disabled);
 }
 
-/* «Восстановить» — два квадрата вместо одного: знак плотнее и при общем кегле выходил
-   крупнее одиночного квадрата (чернила 15×15 против 11×11). Меньший кегль выравнивает
-   боксы: 9.5×9.5 у «восстановить» против 9.6×9.6 у «развернуть» */
-wc_maximize.wc_maximized chui_icon {
-    font-size: 10px;
-}
-
 wc_maximize:hover, wc_minimize:hover {
     background: var(--element_background_hover);
 }
@@ -1280,13 +1281,13 @@ wc_maximize:active, wc_minimize:active {
     background: var(--element_background_prime); color: var(--text_color_hover);
 }
 
-wc_maximize:hover chui_icon,
-wc_maximize:active chui_icon,
-wc_minimize:hover chui_icon,
-wc_minimize:active chui_icon,
-wc_close:focus-visible chui_icon,
-wc_maximize:focus-visible chui_icon,
-wc_minimize:focus-visible chui_icon {
+wc_maximize:hover svg,
+wc_maximize:active svg,
+wc_minimize:hover svg,
+wc_minimize:active svg,
+wc_close:focus-visible svg,
+wc_maximize:focus-visible svg,
+wc_minimize:focus-visible svg {
     color: var(--text_color);
 }
 
@@ -1297,8 +1298,8 @@ wc_close:active {
     background: var(--red_prime_background);
 }
 
-wc_close:hover chui_icon,
-wc_close:active chui_icon {
+wc_close:hover svg,
+wc_close:active svg {
     color: var(--text_color);
 }