chuijs 4.0.3 → 4.0.4

package/CHANGELOG.md

@@ -3,6 +3,542 @@
 Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
 версии — [Semantic Versioning](https://semver.org/lang/ru/).
 
+## [4.0.4] - 2026-10-01
+
+### Добавлено
+
+- **`ScreenSpinner` — экран занят.** Слой поверх всего окна с индикатором загрузки: пока он
+  открыт, до содержимого под ним не добраться — мышь и клавиатура приходятся на слой, фон
+  становится инертным, а фокус удерживается внутри. Слой встаёт в `body` (в карточке
+  с `backdrop-filter` Chromium собирает такой узел отдельной поверхностью и рисует её под
+  слоями из `body`), идёт выше модальных слоёв и объявляет себя `dialog` с именем загрузки,
+  внутри — `progressbar`. `delay` гасит мигание на коротких операциях, `hide()` до появления
+  слоя просто отменяет показ; на экране всегда один такой слой — новый убирает предыдущий.
+- **`CardScroll` — горизонтальная лента карточек.** Лента идёт вбок: вертикальное колесо
+  прокручивает её вдоль, карточка прилипает к началу (`snap: false` отключает), у краёв
+  появляются стрелки — только там, где за краем есть карточки. Клавиатура: стрелки влево-вправо
+  ведут по карточке с зазором, Home и End — к началу и концу; список объявлен
+  `role="list"` с подсчётом карточек, поэтому скринридер называет их число. Когда лента
+  упирается, колесо отдаётся странице — иначе список «съел» бы прокрутку.
+- **`Banner` — карточка-объявление.** Кромка со значком или фотографией, заголовок
+  с подзаголовком, действия и закрытие: размер `s` — строка, `m` — карточка с картинкой
+  во всю ширину, вид `tint` — значок в цветной плашке, `image` — фотография. Подпись не лежит
+  поверх снимка (она рядом), поэтому читается при любом кадре; закрытие идёт общим кадром ухода
+  с одноразовым слушателем и сроком из токена. `onClick` делает карточку кнопкой — роль, обход
+  клавиатурой и активация Enter/Space, а имя баннера даёт заголовок.
+- **`WriteBar` — панель ввода сообщения.** Слева вложения и эмодзи, по центру поле текста,
+  справа отправка: поле растёт под содержимое до `maxHeight`, дальше текст уходит в прокрутку
+  поля, и панель места не отнимает. Enter отправляет, Shift+Enter переносит строку (во время
+  набора иероглифов Enter не наш), `setEnterSends(false)` возвращает обычное поле. Кнопки панели
+  собираются фабрикой `WriteBar.Icon(...)` — со значком, подписью для скринридера и счётчиком;
+  отправка гаснет на пустом поле. Прилипание к низу окна панель не делает сама: для этого есть
+  `StickyBar`, а `shadow` поднимает её над содержимым тенью.
+- **`MessageBar` — лента сообщений в пару к панели ввода.** Группирует пузыри по автору и дню,
+  свои ставит справа акцентом, чужим даёт аватар и подпись автора, между днями рисует дату.
+  Лента следит за нижним краем: если человек читает историю выше, новое сообщение не сдёргивает
+  прокрутку, а над нижним краем появляется кнопка «Новые сообщения» со счётчиком; та же кнопка
+  зовёт вниз без новых сообщений. `linkWriteBar(bar)` связывает ленту с панелью одним вызовом —
+  отправленное из панели встаёт в ленту со состоянием `sending`, дальше приложение ставит
+  `sent`/`read` через `updateMessage()`, а правка состояния не трогает прокрутку.
+- **`UserBar` — полоса пользователя, шапка разговора.** Аватар, имя, состояние точкой и подписью,
+  кнопка возврата и действия со значками и счётчиком. Состояние показывается дважды — точкой
+  на аватаре и подписью («в сети», «отошёл», «занят», «не в сети»), причём своя подпись
+  (`setSubtitle('Иван печатает…')`) состояние не теряет, а `setSubtitle()` без аргумента
+  возвращает подпись состояния. С `onClick` полоса становится кнопкой (роль, обход клавиатурой,
+  Enter/Space, имя «открыть профиль: …»), но щелчок по кнопкам возврата и действий профиль
+  не открывает. Вместе с `MessageBar` и `WriteBar` собирает экран переписки.
+- **`UserListBar` — список разговоров, левая колонка мессенджера.** Строка показывает человека
+  с точкой состояния, последнюю строку разговора, время и число непрочитанных. Время принимает
+  и дату, и готовую строку: дата становится «14:20» за сегодня, «Вчера» — за вчера, короткой
+  датой — дальше. `updateItem()` правит строку на месте, не пересобирая список: последняя
+  строка в разговоре меняется постоянно, и пересборка сдвигала бы прокрутку. `search: true`
+  ставит поле поиска, которое фильтрует по имени и последней строке; пустой список говорит
+  об этом, а пустой от фильтра — «Ничего не найдено». Список — `role="listbox"` с одной
+  остановкой Tab: стрелки водят по строкам, Home/End — края, выбор по клику и Enter/Space.
+  Меню строки (`menu`) открывается правым щелчком, клавишей «Меню» и Shift+F10 и строится
+  по строке: функция `(item) => действия` даёт подписи и доступность по её состоянию,
+  а `onClick(action, item)` знает и действие, и строку; для строки без действий меню
+  не открывается вовсе.
+- **`ContextMenu`: `setItems()` и опасный пункт.** Пункты можно заменить (`setItems`) — так меню
+  строят по тому, на чём его открыли; у пункта появился `danger` — подпись и значок красного
+  цвета (цвет один на всю строку: прежде красная подпись шла с обычным значком), у слоя —
+  роль `menu`, у пунктов — `menuitem` и `aria-haspopup` у подменю: документация обещала это
+  раньше, чем код. Имя меню для скринридера даёт `setLabel(text)` — им пользуется список
+  разговоров: без имени меню читалось бы просто группой пунктов.
+- **`ActionsBar` — панель действий.** Подпись и ряд подписанных кнопок со значками: «Закрепить»,
+  «Без звука», «Найти в переписке», «Очистить историю». Переключатели (`toggle`) держат
+  состояние, объявляют его через `aria-pressed` и видны подложкой; щелчок и правка из кода
+  сообщают в `onChange` одинаково, а у обычного действия состояния нет вовсе — подсветка
+  без программного состояния читалась бы как выбранное действие. `danger` красит подпись
+  акцентом ошибки, `setBadge` показывает число на плашке и добавляет его в имя кнопки.
+  Внутри живёт `Toolbar`: стрелки ходят по действиям, Home/End — края, Tab проходит
+  по кнопкам, кнопки переносятся по строкам. Ориентация `VERTICAL` ставит действия столбцом,
+  как пункты меню, — в таком виде панель кладут в меню за кнопкой «⋯» полосы пользователя
+  (`UserBar({ menu: [...] })`), и отдельная полоса в шапке не нужна: переключатели в меню
+  остаются открытыми, а выбор обычного действия его закрывает.
+
+- **`Stepper`: состояния шагов и события.** Шаг может нести своё состояние (`status` у шага или
+  `setStatus(index, status)`): готово — зелёные подсветка и галочка, ошибка — красные подсветка
+  и крест, ожидание выполнения — спиннер в маркере. Состояние по месту (пройден, текущий,
+  предстоящий) остаётся `getStatus()`/`getStatuses()`; `undefined` возвращает шаг к нему.
+  Своё состояние сильнее состояния по месту — шаг с ошибкой не теряет её, когда человек ушёл
+  дальше. О смене состояния сообщают `addStatusListener()` и опция `onStatus`: сам `setStatus`
+  на шаг не переходит, а по событию приложение возвращает человека на шаг с ошибкой
+  (`steps.setActive(index)`). Слова состояний взяты из словарей (ru/en), а объявляет о перемене
+  скрытый `role="status"` словами имени маркера.
+- **Токены движения** — `--motion_fast` (0.15s), `--motion_base` (0.25s), `--motion_slow` (0.4s),
+  кривые `--motion_ease` и `--motion_spring` в `global_style.css`. Прежний `--transition_time`
+  остаётся псевдонимом `--motion_fast`, поэтому свои стили, написанные раньше, не ломаются:
+  один жест в разных местах теперь идёт одним временем и одной кривой.
+- **Виды движения в `Animation`** — `data-motion="enter" | "exit" | "pop"` в
+  `chui_animations/styles.css`. Имя кадра по-прежнему даёт JS, а длительность и кривую —
+  вид: вход базовый, выход короче (уход не задерживает следующий экран), отклик мелких
+  слоёв с лёгким перелётом.
+- **Сторожа системы движения** — `test/chui_motion.test.js`: компонент не задаёт время
+  перехода своим числом, у каждого вида есть правило, компонент, называющий кадр вручную,
+  называет и вид, инлайновый переход не возвращается.
+
+- **Появление и исчезновение у слоёв.** Добавлен общий кадр ухода `chui_leave_up`
+  (пара к `chui_appear_up`), а узел убирается по концу кадра — поэтому ничего не пропадает
+  рывком: закрываемое оповещение `Alert`, подсказка графиков, меню `SplitButton`,
+  выпадающие у `Time` и `Chips`, строка «печатает…» в `Chat`, закрываемая вкладка `Tabs`
+  и убираемая метка. Открытие за время ухода отменяет уборку. Раньше все они прятались
+  мгновенно (`display: none`, `hidden`, `remove()`).
+- **Построение диаграмм.** `BarGraph` — столбцы растут от оси, `PieGraph` — секторы
+  прочерчиваются по кругу (подписи встают, когда круг замкнулся), `LineGraph` и `AreaGraph` —
+  линия идёт слева направо, `ScatterGraph` — точки растут из нуля, `Gauge` — дуга идёт от
+  начала шкалы к значению. Прежде полотно появлялось готовым.
+- **Догоняющее значение `ProgressBar`.** Заливка догоняет число за время токена
+  `--motion_base`: ширину заливки у нативного `progress` задаёт браузер, переходом её
+  не задать, поэтому целевое значение догоняют кадры.
+- **Подложка выбора у `Tabs`** — как у `SegmentedControl`: одна деталь переезжает между
+  вкладками, а не вспыхивает на новой.
+- **Общий движок кадров** — `framework/modules/chui_animations/motion.js`: `animate(step)`
+  считает шаг 0…1 за время токена с торможением к покою и умеет останавливать предыдущее
+  движение; при уменьшенном движении шаг выполняется сразу.
+- **Смена темы идёт движением — кроссфейдом.** `crossFade(work, {waitFor})` в том же модуле
+  просит браузер снять страницу до и после работы и перевести один кадр в другой, а `Desktop.theme.set()`
+  и `toggle()` идут через него: прежде тема переключалась кадром — смена `prefers-color-scheme`
+  приходит от браузера, и CSS-переход на неё не запускается (проверено замером: пиксель подложки
+  менялся скачком, хотя класс с временем перехода на корне уже стоял). Время и кривую берут
+  токены движения (`::view-transition-*` в `global_style.css`), при уменьшенном движении
+  кроссфейд не запускается вовсе. Сторож — `test/chui_motion.test.js`: обработчик перехода
+  не ждёт кадров (на время перехода браузер останавливает отрисовку, и `requestAnimationFrame`
+  не приходит — переход зависал до таймаута) и обязательно дожидается смены схемы, иначе снимок
+  «после» берётся до перекраски, и кроссфейд идёт из старой схемы в старую.
+
+### Изменено
+
+- **Палитра пересобрана по эталонным таблицам цвета.** Основа — две таблицы, светлая и тёмная
+  колонки: акценты (синий `#007aff`/`#0a84ff`, красный `#ff3b30`/`#ff453a`, оранжевый
+  `#ff9500`/`#ff9f0a` и остальные десять) и серая шкала для фонов и нейтралей (деления 1…6).
+  Поверхности разложены по шкале: подложка — деление 6 (`#f2f2f7`/`#1c1c1e`), карточка в тёмной
+  схеме — деление 5 (`#2c2c2e`, ровно шаг шкалы), в светлой — белая (в шкале белого нет);
+  волосяная линия — деление 4 (в тёмной схеме это ровно то, что даёт эталонный разделитель),
+  под курсором — деление 2 в светлой и деление 3 в тёмной. Все двенадцать цветов таблицы
+  акцентов выставлены токенами (`--orange_prime_background` … `--gray_prime_background`), бейдж
+  предупреждения больше не коричневый и не жёлтый, а оранжевый акцент — как и положено
+  предупреждению. Сверка `npm run palette:check` читает значения прямо из файла темы, сравнивает
+  с эталоном, печатает, где занято каждое деление шкалы, и считает контраст по WCAG; список
+  решённого иначе (тёмная подложка не чёрная, волосяная линия тише эталонного разделителя, текст
+  ссылки — затемнённый акцентный синий) живёт там же с причиной у каждого пункта. Запасной цвет
+  графиков `#1676f3` заменён на акцентный синий.
+
+- **Уборка истории уведомлений — каскадом, а не одним щелчком.** Записи ящика уезжают
+  по очереди: номер в очереди задаёт переменную `--notification_clear_index`, а шаг считает CSS
+  долей токена `--motion_fast`, поэтому список читается как рассыпающийся. Подписи дней гаснут
+  вместе с записями, а подсказка «Уведомлений пока нет» приходит общим кадром появления
+  `chui_appear_up` — раньше записи исчезали мгновенно и рывком, а подсказка вспыхивала.
+  Срок каскада считается из тех же токенов движения, а не из своего числа (в коде жило
+  `setTimeout(…, 300)`, которое надо было держать в согласии со стилями): конец уборки
+  не зависит от того, проиграл ли браузер кадр, — у скрытой записи `animationend` не приходит
+  вовсе. Пока каскад идёт, кнопка «Очистить» недоступна; при уменьшенном движении история
+  очищается сразу.
+
+- **Запись встаёт в ящик кадром прихода, а не вспышкой на месте.** Тост, уезжая вправо,
+  возвращается в историю оттуда же — тем же кадром `slide-right-in`, каким он пришёл в панель.
+  Прежде карточка ставилась инлайновыми `opacity`/`transform` и ждала 500 мс, а вид `exit`
+  держит `transform` вне переходов: слайд не проигрывался вовсе, и запись просто появлялась.
+  Вид записи истории (`notification_in_box`) теперь сам показывает карточку — инлайновый
+  `display` из JS ушёл. Въезд стал одноразовым событием: раньше его обработчик ловил любой конец
+  кадра, в том числе кадр уборки, и переселял запись в начало списка, начиная её кадр заново.
+
+- **Сайт документации — в тех же цветах.** Палитра сайта (`docs/assets/style.css`) выровнена
+  по токенам фреймворка: подложка — деление 6 серой шкалы, карточки — белые в светлой схеме
+  и деление 5 в тёмной, волосяная линия — деление 4, ссылка — затемнённый акцентный синий
+  (осветлённый в тёмной схеме). Совпадение значений проверяет `npm run palette:check`:
+  раздел «сайт документации» сверяет токены `--p_*` с палитрой фреймворка.
+- **Подсветка примеров кода на сайте — тоже из палитры приложения.** Шесть токенов
+  подсветки (`--p_tok_*`) были цветами чужой таблицы редактора: синие ключевые слова,
+  кирпичные строки, зелёные числа. Теперь каждый — акцент палитры, подмешанный к чёрному
+  (светлая схема) или к белому (тёмная): ключевые слова — фиолетовый, строки — зелёный,
+  числа — оранжевый, вызовы — индиго, типы — бирюзовый, комментарии — серый. Доля
+  подмешивания выбрана под норму 4.5 (сам акцент на заливке кода даёт для текста от 1.3
+  до 3.6) — вышедший контраст печатает `npm run palette:check` вместе с таблицей долей.
+  Служебные цвета страницы тоже приведены к палитре: жёлтая отметка поиска — жёлтый акцент
+  (0.4 / 0.32), занавес открытого меню на узком экране — `modal_scrim`, а в печати, где
+  схема одна, стоят плоские значения светлой схемы. Сторож сверяет и это: цвета вне блока
+  токенов допускаются только из палитры (сейчас это четыре значения для печати), а мёртвые
+  `--p_warn` и `--p_ok` убраны.
+- **Из описаний убраны имена чужой таблицы.** Палитра и её сверка говорят о «таблицах
+  акцентов и серой шкалы» своими словами: значения не изменились, а имена, по которым они
+  раньше сверялись, ушли из комментариев, отчёта и документации.
+
+- **Открытие выпадающих панелей — движением, а не вспышкой.** Выпадающий список, меню и поповер
+  открываются общим кадром `chui_panel_in` (`global_style.css`) с видом `pop`: панель приходит
+  сверху вниз и чуть вырастает, кривая с лёгким перелётом. Прежде они брали `fade-in` — панель
+  не двигалась вовсе, и открытие читалось рывком. Кадр объявляет только начальное состояние,
+  поэтому после него на панели не остаётся вычисленного `transform`. На кадр перешли Select,
+  ComboBox, MultiComboBox, DateInput, палитра команд, выпадашка полосы меню, выпадашка редактора
+  кода, а панели, которые показывает класс или снятие `hidden` (Chips, Mention, TimeInput,
+  SplitButton, эквалайзер Audio), берут тот же кадр из стилей. Свой кадр `time_dropdown_in`
+  удалён как дубль. Панели без движения вовсе: Popover (был `display = "none"`/`flex` рывком —
+  теперь кадр при открытии и уход по концу кадра), меню SplitButton (кадр был только у ухода),
+  подменю контекстного меню и список подсказок Mention. У Popover и SplitButton уход тоже
+  ведёт кадр. У `Animation` появился метод `panelIn()`.
+- **SidebarNav: раскрытие пункта стало движением.** Панель переключается на месте, а не пересборкой
+  списка (новые узлы не помнят прошлого состояния — поэтому и содержимое, и стрелка появлялись
+  готовыми), высоту ведёт `max-height` переходом по токену движения, `hidden` возвращается по концу
+  перехода, при уменьшенном движении состояние применяется сразу. Новая метка Chips встаёт в строку
+  кадром появления, а не возникает рывком.
+
+- **Каждому контролу — своё движение, а не мгновенная смена состояния.** Ручка `Toggle` едет
+  пружиной; галка `CheckBox` прорастает из нуля; бегунки `Audio`/`Video` растут под курсором
+  плавно; у `SegmentedControl` выбранный вариант несёт подвижная подложка (её место и ширину
+  компонент считает по вёрстке и пересчитывает при изменении размера — растянутый контрол и
+  поворот окна её не сбивают); `DropZone` приподнимается при приёме файла; `Kanban` приподнимает
+  и наклоняет взятую карточку.
+- **Свой ритм у появления и ухода.** Кнопка `Backtop` поднимается и гаснет (появление —
+  `--motion_base`, уход — `--motion_fast`), а `hidden` включается по концу ухода: в закреплённом
+  положении он держит место в раскладке панели.
+- **Переходы `Stepper` идут движением, а не вспышкой.** Состояние применяется на месте,
+  без пересборки списка: узлы те же, поэтому смена цвета маркера и заливки линии читаются
+  переходом по токену движения, знак состояния приходит кадром, а фокус и прокрутка остаются
+  на месте (пересборка теряла то и другое и читалась вспышкой). Знак пересобирается только
+  тогда, когда он и впрямь сменился, — иначе кадр перезапускался бы сразу у всех маркеров.
+  Полулиния заполняется от маркера-предшественника и растёт по `scaleX` (в вертикальном
+  варианте — по `scaleY` сверху вниз), а заливка пройденного пути стала зелёной: за готовность
+  отвечает `--green_prime_background`, синий акцент остался за текущим шагом. Свой `icon` шага
+  показывается у текущего и предстоящего шага; у состояний знак свой — галочка, крест, спиннер.
+  Выключенный шаг помечен `aria-disabled="true"`.
+- **Ключи цвета собраны в одном месте — в теме.** Прежде цвет жил не только в палитре:
+  подсветка кода в модуле была набрана цветами одной тёмной колонки (в светлой схеме примеры
+  читались тускло), ручка плеера стояла значением в общих стилях, а тени контролов, край
+  закреплённой колонки, ореол ручки сравнения картинок и затемняющая накладка `Gantt` были
+  своими числами в компонентах. Теперь всё это — ключи палитры: `--box_shadow_control` (бегунок
+  и головка переключателя), `--box_shadow_edge`, `--box_shadow_halo`, `--overlay_dim`,
+  `--player_*` и восемь `--code_token_*` (акценты, приглушённые к заливке кода до нормы 4.5 —
+  доли и вышедший контраст печатает `npm run palette:check`). Светлые тени и ручка плеера
+  переехали из `global_style.css` в тему: цветовых значений вне `main_theme_style.css`
+  в дереве больше нет.
+
+- **Имена ключей приведены к правилам.** `--text_color_hover_disable` → `--text_color_hover_disabled`,
+  `--blue_prime_background_trans` → `--blue_prime_background_tint_strong` (имя говорило
+  «прозрачный» вместо «плотнее слабой тонировки»), восемь плашек бейджей `--badge_*_back` →
+  `--badge_*_background`, группа плеера `--ap_*` → `--player_*` (`--ap_slider_buf_background` →
+  `--player_slider_buffer_background`), мёртвый `--ap_main_background_2` убран. Цвет в JS тоже
+  собран в одно место: модуль `chui_palette` (`paletteColor`, `paletteScheme`, `paletteNames`) —
+  им теперь пользуются графики (оси, сетка, запасные цвета, пороги `Gauge`) и набор
+  `ColorPicker.PALETTE`; цвета графиков стали следовать схеме окна.
+
+- **Сторож ключей и найденные им поломки.** `test/chui_tokens.test.js` требует: цветовые
+  литералы — только в теме, схемы объявляют один набор ключей, имена по правилам, таблица
+  палитры для JS совпадает с темой, и каждая ссылка `var(--имя)` разрешается. Последняя
+  проверка сразу нашла пять битых ссылок: код в `Badge` и `MarkdownEditor` брал необъявленный
+  `--code_font` (моношрифт не применялся — теперь общий ключ `--font_mono`), лента `CardScroll`
+  — необъявленный `--box_shadow_sm` (тень карточки не рисовалась — теперь `--box_shadow_main`),
+  а ручка и кнопки сравнения картинок — необъявленный `--background_color` (подложки не было;
+  теперь `--element_background_2`).
+
+- **Имена всех переменных — по одним правилам, а не только цветовых.** Дефис внутри имени
+  убран: `--fx-before-width`, `--seek-before-width`, `--volume-before-width` →
+  `--fx_before_width`, `--seek_before_width`, `--volume_before_width` (дефис остаётся только
+  после `--`, как разделитель префикса). Сокращения заменены словами: `--tabs_x`/`--tabs_w` →
+  `--tabs_offset`/`--tabs_width`, `--segmented_x`/`--segmented_w` →
+  `--segmented_offset`/`--segmented_width`, а на сайте документации `--p_bg`, `--p_code_bg` и
+  шесть `--p_tok_*` → `--p_background`, `--p_code_background`, `--p_token_*`. Уточнены имена
+  без своего компонента: `--progress_height` → `--progress_bar_height`, `--sticky_offset` →
+  `--sticky_bar_offset`. Прежние публичные имена остались рабочими, но значение держит старый
+  ключ, а новый читает его: `--margin` → `--block_margin`, `--main_padding` → `--block_padding`,
+  `--main_padding_sm` → `--block_padding_sm`, `--border_radius` → `--radius_sm`,
+  `--test_padding` → `--control_padding`, `--transition_time` → `--motion_fast`,
+  `--ease_out` → `--motion_ease`. Правила теперь проверяются для каждого ключа дерева:
+  строчные буквы и подчёркивание, слово целиком вместо сокращения, никаких имён-заглушек,
+  и каждый объявленный ключ кем-то читается — акценты палитры читает код через `paletteColor`,
+  прежние имена перечислены исключениями с причиной. Витрина и сайт входят в ту же проверку:
+  ключ, который читает только их вёрстка, обязан быть объявленным.
+
+- **Имена в JS — `camelCase`, а `const` выбирается по факту.** `snake_case` остался только
+  у ключей CSS и у данных чужого API: переменные, параметры и функции приведены к `camelCase` —
+  226 имён в 271 месте. Из них не только camelCase, но и слово вместо сокращения и заглушки:
+  `main_test` → `sectionNode` (и `treeNode` в дереве), `checkbox_input` → `checkboxInput`,
+  `filter_test` → `preset`, `test_main`/`test_body`/`test_remove` →
+  `optionChip`/`optionChipBody`/`optionChipRemove`, `p_slider`/`p_val` →
+  `preampSlider`/`preampValue`, `ec_length` → `errorCorrectionLength`, `table_cols` →
+  `tableColumns`, `sum_slides` → `slideTotal`, `id_name` → `identifier`, `pos_bool` →
+  `isEnabled`, `stringz` → `styleGroups`, а `widow_size` → `windowSize` (опечатка),
+  `задержка_ms` → `delayMs`. Переименование сделано по смыслу, а не по тексту: имена классов
+  вида `checkbox_input` в строках разметки не тронуты — сверка литералов до и после правки
+  совпала. `let` остался только там, где значение переприсваивают, — 612 объявлений стали
+  `const`; `var` убран из `docs/assets/wiki.js` (91 объявление), где он остался от старого
+  стиля. Заодно `ActionSheet.show` собран без «пустого» `let sheet`: имя объявлено `const`
+  там, где слой создаётся (ответ зовут уже после сборки), а `image.js` — без `let imageSet`
+  под одну сборку. Публичное имя `chui_functions.style_parse` осталось ключом — его читает
+  `chui_fonts.js` и чужой код, — а сама функция называется `parseStyle`.
+- **Правила имён и объявлений стережёт линтер.** В `eslint.config.js` добавлены `camelcase`,
+  `prefer-const` и `no-var`: правило входит в `npm run lint`, то есть в `npm run check`
+  и в CI, поэтому прежние семьи имён больше не вернутся. «Стиль кода» в `CONTRIBUTING.md`
+  называет те же три правила и порядок для публичных имён.
+- **Приватные имена классов — тоже `camelCase`.** Поля и методы вида `#label_text` стали
+  `#labelText` — 4433 идентификатора в 118 файлах (551 имя). Правку делал разбор деревом
+  TypeScript, а не поиск по тексту: строки и комментарии не тронуты, сверка литералов до и после
+  совпала. Константы (`#DEFAULT_MAX`, `#MAX_COLUMNS`) оставлены как были — правило `camelCase`
+  их не касается. Восемь имён, рядом с которыми уже жило такое же имя в camelCase (поле-опция
+  и метод), названы развёрнуто: `#on_item_click` → `#onItemClickCallback`, `#value_text` →
+  `#valueLabel`, `#window_page` → `#windowPagePath`. Правило стережёт линтер: `camelcase`
+  приватные имена не смотрит (`properties: "never"`), поэтому в `eslint.config.js` добавлен
+  селектор `PrivateIdentifier[name=/_[a-z]/]`, а подчёркивание осталось только у констант.
+- **`Main` переехал из точки сборки в свой модуль.** Класс окна вынесен в
+  `framework/main_window.js`: `index.js` перестал быть самым большим файлом репозитория
+  (1606 → 400 строк), а публичный доступ не изменился — `require('chuijs').Main` тот же.
+  Страница `Styles` заодно перестала показывать методы окна: они попадали в её «Состав в коде»
+  только потому, что оба класса лежали в одном файле.
+- **Ссылки окно открывает в браузере, а не в себе.** `window.open`, `target="_blank"` (ссылки
+  `Link`) и переход на другой адрес уходят в системный браузер — наружу только `http(s)`.
+  Раньше `window.open` создавал новое окно Electron с собственными `webPreferences`, а переход
+  уносил окно без адресной строки на чужой сайт без пути назад.
+- **Проверки стали строже, а сторожа — точнее.** `npm run lint` идёт с `--max-warnings=0`,
+  добавлено правило `eqeqeq` (и два сравнения `!= null` исправлены), компонентам запрещён
+  `console`; у покрытия появился порог (`--check-coverage`), который не даст ему тихо просесть;
+  `actions/cache@v3` заменён на `@v4`. Тестов стало 329 (было 284): подсветка кода, DOM-часть
+  `chui_functions`, раскрывающиеся блоки (`Accordion`/`Details`/`FieldSet`) и ограничение
+  навигации окна.
+- **Скан «текст против кода» в доках перестал считать ложные упоминания.** Сверка методов
+  принимала за заявку упоминание в отрицании («`destroy()` не нужен») и имена платформы
+  (`String()`, `getBoundingClientRect()`): таких «упомянут, но не найден» было 110, стало 70.
+- **CSS подключается через `textContent`.** `setStyles` и `parseStyle` писали тело `<style>`
+  через `innerHTML` и `innerText`: первое разбирает CSS как разметку, второе в jsdom не работает
+  вовсе. Теперь в `<style>` кладётся текст — как и положено этому элементу.
+
+- **Документация — про имена целиком, а не только про цвета.** На странице «Темы» появился
+  раздел «Имена переменных — одни правила для всех ключей»: подчёркивание внутри имени, слово
+  целиком вместо сокращения, имена без заглушек, каждый объявленный ключ читается; там же —
+  таблица прежних публичных имён и объяснение, почему старый ключ держит значение, а новый его
+  читает. «Константы» уточняют шкалу плеера (глиф панели задаётся ключом самому значку, а не
+  наследует размер кнопки), перечисляют пары имён и называют убранные мёртвые ключи. «Плееры»
+  и «Дерево» описаны по коду: глиф берёт размер из `--player_icon_size`, а высота строки в
+  переменном режиме идёт одним ключом `--tree_view_row_height` и на распорки, и на вёрстку.
+  В «Планах» обновлены числа (284 теста) и список сторожей — сторожа ключей теперь называют
+  и правила имён.
+
+- **Строки списков встают на место.** Журнал `Console`, сообщения `Chat`, элементы
+  `ClipboardHistory` и события `Timeline` берут общий кадр `chui_appear_up` из
+  `global_style.css` — одно движение на все списки, которые наполняются по одной. Графики на
+  канвасе появляются тем же кадром: полотно встаёт на место, а не вспыхивает (рост столбцов и
+  прорисовку линии задаёт само рисование — это следующий шаг для графиков).
+- **Токен `--motion_none`** (`0s`) — переключатель без движения: им `visibility` возвращается
+  только по концу ухода, поэтому узел не мигает и не исчезает посреди анимации.
+- **Переходы компонентов переведены на токены.** Свои числа и `--transition_time` убраны из
+  `accordion`, `details`, `icons`, `inputs/file`, `inputs/slider`, `inputs/time`, `sidebar_nav`,
+  `tree_table`, `tree_view`, `media/audio`, `media/video`, `progress_ring`, `scrollbar`,
+  `slideshow`, `sticky_bar`, `tour`, `tooltip`. Кривая везде одна (`--motion_ease`), а время
+  выбрано по роли: состояния — `--motion_fast`, появление и перемещение — `--motion_base`,
+  крупные поверхности — `--motion_slow`. Круговые индикаторы (`spinner`, `skeleton`,
+  `progress_ring`) оставлены со своим временем: это фон ожидания, а не жест.
+- **Яркость в общем правиле.** `filter` добавлен в `* { transition }`: подсветка события в
+  `Gantt` и `Scheduler` (единственные места с `filter`) больше не переключается рывком.
+- **Крупные слои называют своё время сами.** Панель `Drawer` выезжает временем
+  `--motion_slow`, а уезжает `--motion_fast`; у `ActionSheet` и `ContextMenu` уход короткий.
+  Прежде у этих слоёв уход шёл временем появления, а у меню — ещё и кривой браузера.
+- **Ссылка в тексте** подчёркивается плавно: `text-decoration-color` вместо мгновенного
+  появления подчёркивания. Закреплённый `Affix` меняет радиус и тень одним переходом.
+- **Вычислено вместо инлайна.** У слоя движения переход на `transform` выключен правилом
+  `[data-motion] { transition-property: … }`, а не инлайновым `style.transition`.
+
+- **CI гоняет те же проверки, что и локально.** В матрице Node 18/20/22 проверки идут одним шагом
+  `npm run check:code` (линтер, форматирование, типы, сверка палитры и тесты) вместо перечисления
+  шагов в workflow — теперь новая проверка попадает в CI сама. Прежде `npm run palette:check`
+  в CI не запускался вовсе, а тесты в матрице не гонялись: их считала только задача покрытия.
+  `npm run check` — это `check:code` плюс `docs:check`.
+- Документация: в `CONTRIBUTING.md` добавлены команды `palette:check` и `check:code`; на странице
+  «Планы» обновлены цифры — 227 тестов и покрытие `framework/**` около 26% вместо прежних 6%,
+  и перечислены сторожа общих правил (движение, «тихие» отказы, модальный слой, карточки
+  уведомлений).
+
+### Исправлено
+
+- **Размытие подложки у слоёв с движением.** Кадр появления оставлял на слое вычисленный
+  `transform` — вид движения держит конечное состояние (`animation-fill-mode: both`). Элемент
+  с `transform` становится собственным «backdrop root», и размытие подложки перестаёт видеть
+  содержимое под слоем: контекстное меню, выпадающие списки, поповер, панель меню-бара и тосты
+  шли прозрачной подложкой без блюра (замер: у меню контекста картинка не менялась при
+  отключении `backdrop-filter`). Теперь драйвер снимает вид по концу кадра входа (`#entranceEnd`),
+  а имя кадра остаётся — по нему видно, что слой открыт. Контекстному меню этого мало: снятие
+  вида помогало лишь после кадра — и всё время открытия меню (0.25 с) шло без блюра, а размытие
+  появлялось рывком уже на открытом меню. Поэтому у меню пункты переехали в отдельный слой
+  (`context_menu_panel`, его отдаёт `getPanel()`), кадр с прозрачностью и усадкой играет он,
+  а поверхность с блюром стоит недвижимо и растворяется своим кадром по псевдоэлементу —
+  замер: на 30-й мс открытия и поверхность, и пункты на 0.53, `transform: none` у слоя,
+  `backdrop-filter: saturate(1.8) blur(20px)`. Уход играет та же пара кадров.
+
+- **Рамка меню на уходе становилась меньше пунктов.** Поверхность меню подрастала по `inset`
+  (8px → 0), и на уходе, пока пункты ещё не погасли, рамка с тенью сжималась внутрь — подпись
+  вылезала за кромку: замер на 60-й мс ухода — поверхность на 7px меньше пунктов при их
+  прозрачности 0.06. Теперь кадр поверхности идёт только по прозрачности и ничего не двигает:
+  рамка всё время охватывает пункты, а растворение поверхности и пунктов идёт одним временем
+  (на 25-й мс ухода оба на 0.47, меню убирается по концу кадра). Прозрачность на самой
+  поверхности блюру не мешает — проверено снимком при 0.55.
+
+- **Прилипающая полоса теряла фон.** Полоса отдавала контейнером прокрутки документ вместо своей
+  области прокрутки, если узел попадал в документ позже первого кадра (страница витрины собирает
+  навигацию после сборки содержимого): порог закрепления вставал на нуле, состояние `data-stuck`
+  оставалось `false`, и материал не рисовался — полоса шла прозрачной поверх содержимого. Теперь
+  подключение ждёт появления узла в документе (наблюдателем, а не опросом по кадрам), а не одного
+  кадра. Навигация по разделам в витрине получила зазор до шапки (`offset: 8`).
+
+- **Список `Select` мигал при открытии.** Поле открывают и `focus`, и `click` одного действия —
+  показ приходил в драйвер дважды, а `panelIn()` перед кадром снимает имя кадра, поэтому второй
+  вызов начинал кадр заново (панель успевала показаться и тут же прыгала к началу). Теперь
+  повторный показ уже открытой панели кадр не запускает, а после настоящего закрытия кадр
+  играет снова с нуля. Правило в драйвере, поэтому оно закрывает и остальные поля с тем же
+  действием (ComboBox, MultiComboBox, DateInput).
+
+- **Заголовок ящика и весь диалог пропадали.** Модальный слой при открытии не покидал карточку
+  приложения, а занавес и шапка окна живут в `body`. Chromium собирает слой с `backdrop-filter`
+  и `z-index` отдельной поверхностью и рисует её под слоями из `body`: у `Drawer` шапка срезала
+  верх панели вместе с заголовком и кнопкой закрытия, а `Dialog` целиком уходил под занавес и
+  читался одним размытым пятном. Теперь оба слоя при открытии встают в `body` — как уже делают
+  `ActionSheet`, `ContextMenu`, `MenuBar` и попапы, — а после ухода возвращаются туда, откуда
+  их открыли, и занавес диалога уходит из документа (`test/chui_overlay_host.test.js`).
+- **Инлайновый `transition: transform .0s` глушил у слоя все переходы** — он подменял список
+  свойств целиком, поэтому слой после первого показа терял плавность цвета, тени и прозрачности.
+- **У `ContextMenu` не было ни своего времени, ни кривой приложения**: меню шло временем общего
+  правила и кривой браузера (`ease`) — своим ритмом из общего ряда.
+- **Слои, называвшие кадр вручную** (`Drawer`, `ActionSheet`, `ContextMenu`, страховочные имена
+  у `Notification` и `ToastQueue`), берут время и кривую по виду движения, а не по общему правилу.
+
+- **Цвета в приложении на сеансе Wayland совпадают с токенами темы.** Причина найдена замером
+  пикселей на экране, а не чтением `getComputedStyle`: Chromium поднимал окно через протокол
+  цветоуправления Wayland (`wp_color_manager_v1`) и применял к тёмным тонам чужую кривую —
+  вместо `#1c1c1e` из `main_theme_style.css` на экране было `#222223` (сдвиг +6), тогда как
+  чёрный и белый оставались на месте. `Main` при старте отключает этот протокол в Chromium
+  (`WaylandWpColorManagerV1` добавляется в `--disable-features`), нативный Wayland при этом
+  сохраняется: сдвиг +6 → 0 на всех проверенных токенах, и теперь приложение показывает цвет
+  так же, как терминал. Значение флага, переданное клиентом, не затирается — своё дописывается
+  к нему. Рядом остаётся страховка `--force-color-profile=srgb` — но уже как отдельная мера: она
+  держит цвета темы в sRGB на широкоохватных экранах и сдвиг на Wayland не лечила (замер это
+  показал), так что причиной правки не является.
+  Про цветовое пространство и про то, почему пипетка по полупрозрачным материалам даёт смесь,
+  написано на странице «Themes».
+
+- **Меню `SplitButton` больше не залипает открытым.** Класс показа задан селектором с элементом
+  (`chui_split_menu.split_button_menu_open`), а класс ухода — коротким (`.split_button_menu_leaving`):
+  кадр ухода проигрывал по специфичности, `animationend` не приходил, класс показа оставался на узле,
+  и меню не закрывалось ни повторным нажатием каретки, ни кликом снаружи (состояние при этом уже
+  считалось закрытым). Правило ухода теперь называет оба класса, поэтому кадр играет и класс
+  снимается. Сторож — `test/chui_motion.test.js`: правило ухода не должно быть слабее по
+  специфичности правила показа того же узла, иначе узел остаётся открытым.
+
+- **Вложенный контейнер больше не сливается с карточкой.** Поверхностей в теме три: подложка,
+  карточка и нейтральная заливка. Контейнер носил карточную — и карточка тоже, поэтому внутри
+  карточки шаг светлоты был нулевым и блоки разделяла только граница: в витрине так выглядели
+  `SidebarNav`, `List`, `Toolbar`, `CodeEditor`, `TreeView`, `Gantt`, `Scheduler`, `Statistic`,
+  `Alert`, `DropZone`, `Splitter`, `ShortcutHelp`, `ClipboardHistory`, `JsonViewer`,
+  `StatusBar`, `Code` и разделы настроек. Теперь вложенный контейнер берёт нейтральную заливку
+  (правило в `global_style.css`), и шаг виден: замер пикселя даёт 8.3 в тёмной схеме и 5.5
+  в светлой — не меньше, чем между подложкой и карточкой (7.7 и 4.4). Своя заливка у контейнера
+  остаётся: на подложке он по-прежнему читается как карточка, опускает его только вложенность.
+  Числа печатает `npm run palette:check` новым разделом, он же проверяет, что список контейнеров
+  в правиле не разошёлся с компонентами.
+
+- **Обводка в тёмной схеме видна так же, как в светлой.** Волосяная линия была делением 4
+  (`#3a3a3c`): на подложке это давало шаг светлоты 14, а на карточке — всего 6.4 против 16
+  в светлой схеме, поэтому в тёмной теме рамки читались «не очень». А нужна рамка на карточке
+  чаще, чем на подложке: ею разделены блоки внутри карточки. Линия переехала на деление 3
+  (`#48484a`, шаг 12.6), под курсором — деление 2 (`#636366`), то же в палитре сайта документации.
+  Числа печатает `npm run palette:check`, он же следит, чтобы шаг не стал меньше 10.
+
+- **Hero — акцентная шапка страницы.** Подложка теперь несёт свечение акцентов по углам
+  и акцентную линию сверху, знак залит градиентом двух акцентов вместо плоского синего,
+  а плитки статистики берут акценты по кругу (синий, сиреневый, зелёный, оранжевый) —
+  `addStat()` ставит акцент сам. Цвет идёт заливкой, рамкой и полосой, а число и подпись
+  читаются цветом темы: акцентный текст на тинте дал бы контраст ниже 3.
+
+- **Появление Hero — по шагам, числа догоняют значения.** Движение шапки было одним кадром:
+  сейчас это хореография из одиночных кадров на токенах темы — линия сверху прочерчивается
+  слева направо, знак встаёт с перелётом и выпускает кольцо-отклик, заголовок → описание →
+  плитки приходят по очереди (у каждой плитки своя ступенька, и её полоса растёт сверху вниз),
+  а замыкает блик по подложке. Сами числа в плитках догоняют значения шагом общего движка
+  движения (`animate`), поэтому время — из темы, а при уменьшенном движении значение встаёт
+  сразу; значение, которое не разбирается как число, остаётся текстом. Непрерывных кадров нет:
+  шапка не индикатор ожидания — по кругу идут только индикаторы.
+
+- **Материалы стали прозрачнее: 0.6 при блюре `saturate(180%) blur(20px)`.** Шапка, панели,
+  меню, тосты и модалки брали заливку при прозрачности 0.72–0.9, теперь у всех 0.6
+  (`--header_background`, `--header_background_scrolled`, `--modal_background`); фильтр у них
+  и был тем же — `--global_blur` со значением `saturate(180%) blur(20px)`. Сквозь материал
+  видно содержимое: это и есть смысл материала, а не плоской заливки. У шапки при прокрутке
+  плотная ступень убрана — состояние показывает тень, а не заливка.
+
+- **Полосы оболочки носят цвет подложки.** У шапки, меню маршрутов и ящика уведомлений
+  (и у подписи дня в ящике) заливка была общей с меню и поповерами — `--header_background`,
+  то есть цвет карточки; в тёмной схеме полоса выходила светлее подложки и читалась отдельной
+  плашкой. Появился токен `--bar_background` — цвет подложки при прозрачности 0.6, и полосы
+  берут его: в тёмной схеме это `#1c1c1e`, в светлой — `#f2f2f7` (там же был и материал меню,
+  поэтому светлая схема визуально не изменилась). Всплывающие меню, попапы, дропдауны и тосты
+  остались на `--header_background`: над подложкой они должны читаться отдельной поверхностью.
+  Блюр у полос тот же — `--global_blur`.
+
+- **Подпись дня в ящике уведомлений стала полностью прозрачной и встала по центру.** «Сегодня»,
+  «Вчера» и дата раньше несли заливку полосы оболочки — на тёмной схеме читались тёмной полосой
+  поверх карточек. Теперь у подписи нет ни заливки, ни размытия: она только называет день,
+  а карточки при прокрутке проходят прямо под ней.
+
+- **Закреплённая полоса прилипания тоже носит цвет подложки.** `StickyBar` в состоянии
+  `data-stuck="true"` брал `--header_background` (цвет карточки) и выходил светлой плашкой
+  поверх подложки — теперь берёт `--bar_background`, как шапка, меню маршрутов и ящик
+  уведомлений: полоса читается продолжением страницы, а отделяют её волосяной край и тень.
+  Блюр остался общий — `--global_blur`.
+
+- **Состояния чипов в полосе прилипания — как у кнопок.** Чипы витрины остались своими узлами
+  (капсула и подпись 12px — как было), но наведение и нажатие взяты из правил `.chui_button`:
+  наведение — нейтральная ступень `--element_background_hover` и рамка `--border_color_hover`,
+  нажатие — акцентная заливка, акцентная рамка и лёгкая усадка `scale(0.97)`, как у кнопки
+  компонента. Прежде чип заливался акцентом уже на наведении и нажатие этим стирал.
+- **`MultiComboBox`: строка списка занимает всю ширину слоя.** Секция держит
+  `align-items: flex-start` (иначе подпись группы растягивалась и наследовала центрирование),
+  а от него строка сжималась до содержимого: подсветка под курсором и курсор клавиатуры шли
+  прямоугольником вокруг флажка вместо строки (замер: 53 px против 288 px у списка). Отмеченная
+  строка при этом по-прежнему ничего не подсвечивает — выбор видно чекбоксом; заголовки секций
+  не изменились.
+- **`WriteBar`: поле панели в одну линию ровно высотой с кнопки.** Поле было коробкой
+  с отступами по восьми пикселям от края, а кнопки — кругами контрольной высоты, и при
+  выравнивании по низу верх поля выходил выше кнопок: строка панели читалась кривой. Теперь
+  поле — такая же коробка, как у остальных полей фреймворка (заливка контрола, волосяная
+  линия, радиус), а отступы и строка подобраны под контрольную высоту, поэтому значок слева,
+  поле и отправка стоят в одну линию; поле по-прежнему растёт под текст до `maxHeight`.
+  Заодно у поля снято кольцо фокуса — в панели ввода каретка и так показывает, где набирают,
+  а контур вокруг строки рябил на каждом щелчке; активное поле выдаёт кромка акцентом.
+- **Мёртвые ключи убраны.** `--button_background_hover` был объявлен в обеих схемах и не
+  читался нигде: наведение кнопки красит общий `--element_background_hover`, а старый ключ
+  остался от прежней семьи `button_*`. `--player_row_height` был описан в документации, но к
+  нему нет разметки: списка дорожек в плеере нет вовсе. Оба ключа и строка документации
+  удалены.
+- **Глиф плеера берёт размер ключом.** Размер значка панели был вписан числом в код — `18px`
+  в пяти местах `audio.js` и `video.js`, — а документация обещала ключ `--player_icon_size`.
+  Теперь его читают стили плееров; общий ключ оказался нужен потому, что у значка есть своё
+  правило кегля (`chui_icon` носит размер шапки), и без своего правила глиф съезжал на 13pt:
+  замер на витрине — 17.33 px вместо 18 px, после правки снова 18 px.
+- **Высота строки дерева — одно число на вёрстку и на распорки.** Переменный режим писал
+  `--tree_view_row_height` из замера строки, но в стилях её никто не читал: `tree_view_button`
+  держала `min-height: 32px` своим числом, и замер влиял только на арифметику распорок.
+  Теперь строка читает ключ (`min-height: var(--tree_view_row_height, 32px)`), а 32 px остаются
+  значением до замера — вёрстка и окно переменного режима считают по одной высоте.
+
+### Пакет
+
+- Версия 4.0.4.
+
 ## [4.0.3] - 2026-09-30
 
 ### Добавлено