diff --git a/CHANGELOG.md b/CHANGELOG.md index 89d107a..ea5ba1b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,11 +1,11 @@ # Изменения -## 1.36.1 / 1.21.0 (только Electron-версия: 1.21.0) — отмена отражения, C# без изменений +## 1.36.1 / 1.21.0 (только Electron-версия: 1.21.0) - отмена отражения, C# без изменений По отчёту: «нажал отразить, Ctrl+Z - на холсте ничего не поменялось, а ластик стирает противоположную сторону». Поменялась только Electron-версия, теперь 1.21.0. C#-версия без изменений: номер 1.36.1 у неё только потому, что выпуски на GitHub идут по номеру -C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# — 1144, как было. +C#, а 1.36.0 уже выпущен. Проверок: Electron - 474 (+5), C# - 1144, как было. ### Портит работу @@ -16,9 +16,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# рисовали с противоположной стороны. В C#-версии каждое преобразование рисует новым холстом, который сразу выбрасывается, - там этого не было. -## 1.36.0 (только C#-версия) — ровные галочки +## 1.36.0 (только C#-версия) - ровные галочки -По замечанию «исправь галочки». Проверок: C# — 1144 (+3), Electron без изменений. +По замечанию «исправь галочки». Проверок: C# - 1144 (+3), Electron без изменений. ### Мешало обычной работе @@ -27,9 +27,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# ниже середины квадрата. Теперь квадрат одного размера в обоих состояниях, галочка посередине. В Electron-версии флажок родной, Chromium, - там этого не было. -## 1.35.0 (только C#-версия) — печать листа +## 1.35.0 (только C#-версия) - печать листа -По просьбе сделать печать листа и в C#-версии. Проверок: C# — 1141 (+18), Electron без +По просьбе сделать печать листа и в C#-версии. Проверок: C# - 1141 (+18), Electron без изменений. ### Мешало обычной работе @@ -40,9 +40,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# своём размере, большая уменьшается до страницы. Ориентация страницы подсказывается по форме картинки: холст по умолчанию лежачий, а в окне печати её легко не заметить. -## 1.34.0 / 1.20.0 — быстрые мазки не подвисают, печать только листа +## 1.34.0 / 1.20.0 - быстрые мазки не подвисают, печать только листа -Разбор по двум замечаниям. Проверок: C# — 1123 (+22), Electron — 469 (+10) плюс 17 по +Разбор по двум замечаниям. Проверок: C# - 1123 (+22), Electron - 469 (+10) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -59,9 +59,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# печатается один лист: картинка как на экране, со слоями и с объектом, который ещё в руках; документ при этом не меняется. Появился пункт «Файл → Печать…». -## 1.33.0 / 1.19.0 — кисть с ворсинками, кружок не отстаёт, объект тащится хоть за окно +## 1.33.0 / 1.19.0 - кисть с ворсинками, кружок не отстаёт, объект тащится хоть за окно -Разбор по трём замечаниям к обеим версиям. Проверок: C# — 1101 (+84), Electron — 459 (+36) +Разбор по трём замечаниям к обеим версиям. Проверок: C# - 1101 (+84), Electron - 459 (+36) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -89,11 +89,11 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# Electron зерно записано в мазок, и пересборка ленты рисует тот же пучок; старые мазки кисти, записанные до 1.19.0, пересобираются сплошной линией, как и были нарисованы. -## 1.32.0 / 1.18.0 — кружок размера не врёт, размер - это толщина у всех инструментов +## 1.32.0 / 1.18.0 - кружок размера не врёт, размер - это толщина у всех инструментов Разбор по замечанию к обеим версиям: кружок размера кисти показывает не тот размер, а у -ластика и карандаша одни и те же «300 px» дают разные полосы. Проверок: C# — 1017 (+57), -Electron — 423 (+33) плюс 17 по настоящему приложению. +ластика и карандаша одни и те же «300 px» дают разные полосы. Проверок: C# - 1017 (+57), +Electron - 423 (+33) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -110,9 +110,9 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **У двух старых выпусков на GitHub (1.28.0 и 1.15.0) не было описания** - дописаны. -## 1.31.0 / 1.17.0 — размер кисти меняется посреди штриха, кисть до 300 px +## 1.31.0 / 1.17.0 - размер кисти меняется посреди штриха, кисть до 300 px -Разбор по двум замечаниям к обеим версиям. Проверок: C# — 960 (+17), Electron — 390 (+14) +Разбор по двум замечаниям к обеим версиям. Проверок: C# - 960 (+17), Electron - 390 (+14) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -133,10 +133,10 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **У выпуска на GitHub появилось описание.** Раньше там была одна ссылка «Full Changelog». Короткое описание лежит в `docs/release-notes/<тег>.md`; описания 1.28.1-1.30.0 дописаны. -## 1.30.0 (только C#-версия) — холст размером с окно: фотографии втрое быстрее и до 800% +## 1.30.0 (только C#-версия) - холст размером с окно: фотографии втрое быстрее и до 800% Холст переделан под большие фотографии, как в Electron-версии: рисуется только то, что -видно в окне. Проверок: C# — 943 (+103), Electron без изменений. +видно в окне. Проверок: C# - 943 (+103), Electron без изменений. ### Мешало обычной работе @@ -167,10 +167,10 @@ Electron — 423 (+33) плюс 17 по настоящему приложени превью штриха и объект в руках рисуются теперь без копии, пиксели те же. Так же без копии снимается «до» у каждого штриха для отмены. -## 1.29.0 (только C#-версия) — рисование в пять раз быстрее, холст посередине +## 1.29.0 (только C#-версия) - рисование в пять раз быстрее, холст посередине Разбор по двум замечаниям к C#-версии: она заметно медленнее, чем Electron, а уменьшенный -холст уезжает в левый верхний угол. Проверок: C# — 840 (+132), Electron без изменений. +холст уезжает в левый верхний угол. Проверок: C# - 840 (+132), Electron без изменений. ### Мешало обычной работе @@ -203,12 +203,12 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **C#: тени у меню, подсказок, выпадающих списков и диалогов** тоже в кэше - по тому же правилу. Проверка читает разметку всех файлов и не пропустит новую тень без кэша. -## 1.28.1 / 1.16.1 — Electron 44, сборщик без уязвимостей, C# без изменений +## 1.28.1 / 1.16.1 - Electron 44, сборщик без уязвимостей, C# без изменений Выпуск ради безопасности Electron-версии. После включения оповещений Dependabot GitHub показал 64 уязвимости в зависимостях `paint-pro-electron`; `npm audit` - 21, одну -критическую. Теперь 0. Проверок столько же, все прошли на новом Electron: Electron — 376 -плюс 17 по настоящему приложению, C# — 708. +критическую. Теперь 0. Проверок столько же, все прошли на новом Electron: Electron - 376 +плюс 17 по настоящему приложению, C# - 708. ### Скрытое @@ -222,11 +222,11 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **C#-версия не менялась**: номер 1.28.1 поднят, потому что выпуск на GitHub называется по номеру C#-версии. -## 1.28.0 / 1.16.0 — две версии один в один, панели тянутся, окно помнит место +## 1.28.0 / 1.16.0 - две версии один в один, панели тянутся, окно помнит место Разбор по замечаниям к виду обеих версий: всё, что было только в одной из них, перенесено -в другую, раскладка одна и та же, а визуальные недочёты исправлены. Проверок: C# — 708 -(+85), Electron — 376 (+41) плюс 17 по настоящему приложению (+3). +в другую, раскладка одна и та же, а визуальные недочёты исправлены. Проверок: C# - 708 +(+85), Electron - 376 (+41) плюс 17 по настоящему приложению (+3). ### Портит работу @@ -245,15 +245,15 @@ Electron — 423 (+33) плюс 17 по настоящему приложени возвращает как было, ширина запоминается. Инструменты встают в один, два или три столбца, палитра ужимается, и ничего не налезает: это проверяется на самом маленьком окне с настоящей полосой прокрутки. На узком окне панели уступают место холсту. -- **Окно открывается там и такого размера, где его закрыли** — в обеих версиях. Монитор - отключили — окно встаёт на основной; заголовок всегда остаётся на экране. -- **Выбор цвета.** В C#-версии — своё окно: квадрат оттенков, полоса тона, HEX, образец +- **Окно открывается там и такого размера, где его закрыли** - в обеих версиях. Монитор + отключили - окно встаёт на основной; заголовок всегда остаётся на экране. +- **Выбор цвета.** В C#-версии - своё окно: квадрат оттенков, полоса тона, HEX, образец «было / стало»; раньше было окно «Введите цвет в HEX». В Electron-версии окно выбора - открывалось только щелчком по левой части образца — теперь по всему. + открывалось только щелчком по левой части образца - теперь по всему. - **«Последние» цвета в обеих версиях:** до восьми, свежий первым, без повторов. Пока цвет подбирают в окне, промежуточные оттенки туда не сыплются. - **Одна палитра:** сорок цветов по восемь в ряд, по центру, одни и те же в обеих версиях. -- **Сообщения и вопросы — в цветах темы**, а не белыми системными окнами. +- **Сообщения и вопросы - в цветах темы**, а не белыми системными окнами. - **C#: свой заголовок окна** с меню, названием и значком, скругление углов; кнопки с рамками, ровные ползунки и флажки; окно текста со шрифтом, размером, жирным, курсивом и подчёркнутым, как в Electron-версии. @@ -264,13 +264,13 @@ Electron — 423 (+33) плюс 17 по настоящему приложени ### Новое в одной из версий, теперь в обеих -- Поворот на 90° против часовой (Electron) — в меню и в быстрых действиях. +- Поворот на 90° против часовой (Electron) - в меню и в быстрых действиях. - Порядок слоёв ▲▼, «Очистить холст», размер выделения в строке состояния, имена слоёв «Бумага» и «Слой N» (C#). - Размер холста полями прямо в правой панели (C#), «Правка → Удалить» (Electron), клавиши L, R, O, C для линии, прямоугольника, эллипса и обрезки (Electron). -## 1.27.0 (только C#-версия) — иконки видны в светлой теме, полосы прокрутки под тему +## 1.27.0 (только C#-версия) - иконки видны в светлой теме, полосы прокрутки под тему Разбор после кадров для README: их теперь собирает программа (`tools/PaintPro.Screenshots`), рисуя настоящими инструментами и снимая окно в трёх @@ -292,24 +292,24 @@ Electron — 423 (+33) плюс 17 по настоящему приложени инструментов, у правой панели и под холстом. Теперь это узкая дорожка с ползунком из цветов текущей темы. -## 1.26.0 / 1.15.0 — ресайз идёт за мышью, прямоугольный треугольник в фигурах +## 1.26.0 / 1.15.0 - ресайз идёт за мышью, прямоугольный треугольник в фигурах -Обе версии, оба изменения. Проверок: C# — 623 (+11), Electron — 335 (+19) плюс 14 по +Обе версии, оба изменения. Проверок: C# - 623 (+11), Electron - 335 (+19) плюс 14 по настоящему приложению. ### Портит работу - **Ресайз выделения срывался, стоило отклониться от линии на пару пикселей.** Вести мышь - приходилось идеально по траектории: чуть в сторону — и рамка застывала, хотя кнопка + приходилось идеально по траектории: чуть в сторону - и рамка застывала, хотя кнопка оставалась зажатой. Теперь ресайз идёт просто за направлением мыши, откуда бы её ни вело. Причина оказалась не в счёте координат, а в том, чем приложение считало конец жеста. Рамка выделения и её восемь ручек лежат ПОВЕРХ холста отдельными элементами, а не - внутри него. Пока тянешь ручку, курсор то и дело оказывается над ней или над соседней — + внутри него. Пока тянешь ручку, курсор то и дело оказывается над ней или над соседней - и для холста это ровно то же событие «курсор ушёл», что и уход за край. На этом событии висело завершение жеста. Отсюда и требование вести пиксель в пиксель: если идти строго - по траектории, ручка едет ровно под курсором и он с неё не сходит. Стоит промахнуться — + по траектории, ручка едет ровно под курсором и он с неё не сходит. Стоит промахнуться - курсор соскакивает на холст и обратно, и ресайз считался законченным. Тем же событием обрывалось и перетаскивание объекта, если путь проходил над его @@ -318,38 +318,38 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **Мазок обрывался на краю холста и не продолжался при возврате.** Тот же виновник: кнопка всё это время оставалась зажатой, а штрих уже был записан в ленту. Вернувшись на холст, пользователь вёл мышь впустую и получал вместо одной линии два обрубка. - В WPF-версии мышь на время жеста захватывается и ничего подобного не происходило — + В WPF-версии мышь на время жеста захватывается и ничего подобного не происходило - версии разошлись молча. Теперь в обеих жест кончается ОТПУСКАНИЕМ кнопки. ### Новое - **Прямоугольный треугольник в фигурах**, рядом с обычным. Прямой угол ставится по направлению жеста: катеты выходят из точки старта, гипотенуза ложится ровно на линию, - которую ведёт рука. Поэтому один и тот же прямоугольник даёт четыре разных треугольника - — по одному на каждое направление, — и не нужно ни отдельной кнопки на каждый поворот, + которую ведёт рука. Поэтому один и тот же прямоугольник даёт четыре разных треугольника - + по одному на каждое направление, - и не нужно ни отдельной кнопки на каждый поворот, ни попыток угадать, какой из четырёх имелся в виду. У остальных фигур габарит жеста нормализуется и направление теряется; здесь оно и есть весь смысл. ### Скрытое - **Жест, отпускания которого никто не видел, больше не виснет.** Кнопку можно отпустить - за краем окна или под чужим окном, вышедшим вперёд, — `mouseup` тогда не приходит + за краем окна или под чужим окном, вышедшим вперёд, - `mouseup` тогда не приходит совсем. Раньше такой жест частично подбирал уход курсора с холста; теперь, когда уход не завершает ничего, подбор сделан явно: первое же движение с уже отпущенной кнопкой и потеря фокуса окном закрывают жест. В WPF-версии этот случай с 1.21.0 ловит - `Skia.LostMouseCapture` — теперь оба поведения проверены с обеих сторон. + `Skia.LostMouseCapture` - теперь оба поведения проверены с обеих сторон. - **Список фигур перестал жить в двух местах.** Память размера кисти держала свой собственный перечень инструментов, набранный руками; новая фигура попала бы в панель, а - в этот перечень — нет, и размер при переключении на неё «залипал» бы от ластика. Теперь + в этот перечень - нет, и размер при переключении на неё «залипал» бы от ластика. Теперь перечень один. - **Проверка читаемости тем перестала врать на загруженной машине.** Она ждала конца перехода фиксированные 250 мс, а когда четыре проверки идут параллельно, кадры - приходят реже — и цвет читался ПОСРЕДИ перехода, которого пользователь не увидит. + приходят реже - и цвет читался ПОСРЕДИ перехода, которого пользователь не увидит. Ждём теперь не время, а факт: два одинаковых замера подряд. -## 1.25.0 / 1.14.0 — колесо меняет размер кисти, холст тянется за все восемь ручек +## 1.25.0 / 1.14.0 - колесо меняет размер кисти, холст тянется за все восемь ручек -Обе версии, оба изменения. Проверок: C# — 612 (+33), Electron — 316 (+24) плюс 14 по +Обе версии, оба изменения. Проверок: C# - 612 (+33), Electron - 316 (+24) плюс 14 по настоящему приложению. ### Новое @@ -393,22 +393,22 @@ Electron — 423 (+33) плюс 17 по настоящему приложени пиксели рисунка и глотала бы клики, адресованные инструменту. Места хватает: вокруг поверхности лежит поле в 40 пикселей, на котором и так лежала тень. -## 1.24.0 / 1.13.0 — пять тем оформления в обеих версиях и один файл для браузера +## 1.24.0 / 1.13.0 - пять тем оформления в обеих версиях и один файл для браузера Первый выпуск, который меняет обе версии сразу и одинаково. Тем пять, названия и порядок -совпадают. Проверок: C# — 579 (+14), Electron — 292 (+16) плюс 14 по настоящему приложению. +совпадают. Проверок: C# - 579 (+14), Electron - 292 (+16) плюс 14 по настоящему приложению. ### Новое -- **Пять тем оформления, «Вид → Тема».** «Стеклянная» — как было; «Строгая» — ровный тёмный - фон без цветных пятен и приглушённый синий; «Светлая» — тёмный текст на светлом; «Ночная» - — почти чёрный фон для тёмной комнаты; «Тёплая» — охра и кофе вместо синевы. Выбор +- **Пять тем оформления, «Вид → Тема».** «Стеклянная» - как было; «Строгая» - ровный тёмный + фон без цветных пятен и приглушённый синий; «Светлая» - тёмный текст на светлом; «Ночная» - + почти чёрный фон для тёмной комнаты; «Тёплая» - охра и кофе вместо синевы. Выбор переживает перезапуск, неизвестное имя откатывается к исходной теме: файл настроек могли - поправить руками, а приложение без оформления — не приложение. + поправить руками, а приложение без оформления - не приложение. - Тема — это НАБОР ТЕХ ЖЕ КЛЮЧЕЙ, а не отдельное оформление: всё уже ходило через токены, + Тема - это НАБОР ТЕХ ЖЕ КЛЮЧЕЙ, а не отдельное оформление: всё уже ходило через токены, поэтому смена сводится к подмене одного словаря (C#) или атрибута на корне (Electron). - Холст в тему не входит — бумага белая всегда. + Холст в тему не входит - бумага белая всегда. - **Отдельный файл для работы в браузере**: `npm run build:web` кладёт в `dist/` `paint-pro-<версия>-web.html`. Один файл, ничего больше не нужно: переслать, положить на @@ -416,21 +416,21 @@ Electron — 423 (+33) плюс 17 по настоящему приложени ### Портит работу -Все три находки — из запуска приложения и взгляда на экран. +Все три находки - из запуска приложения и взгляда на экран. - **Строка меню была зашита белым цветом.** «Файл», «Правка», «Вид» и «Справка» брали не токен, а `rgba(255,255,255,0.92)`: в светлой теме они становились невидимы. Там же - оказались заголовок программы и часы. Выпадающий список тоже всплывает над холстом — + оказались заголовок программы и часы. Выпадающий список тоже всплывает над холстом - переведён на ту же подложку, что подсказки. - **У пункта меню три роли, а шаблона было два.** Пункт со СВОИМ вложенным списком - («Вид → Тема») — это третья роль, `SubmenuHeader`, и её всплывающее окно рисовала + («Вид → Тема») - это третья роль, `SubmenuHeader`, и её всплывающее окно рисовала система: подменю тем открывалось пустой светлой панелью, ровно как выпадающие меню до 1.23.0. Пока вложенных подменю в программе не было ни одного, дыра не показывалась. - **Два установщика ставили одно поверх другого.** Обе версии назывались «Paint Pro» и шли в одну папку `%LOCALAPPDATA%\Programs\Paint Pro`: кто установлен вторым, тот и затирал первого, а в списке программ оставалась запись про стёртого. Electron-версия теперь ставится как «Paint Pro Electron» в собственную папку, со своим `appId` и своим - ярлыком. Папка настроек НЕ переехала — она берётся из `name` в `package.json`, а не из + ярлыком. Папка настроек НЕ переехала - она берётся из `name` в `package.json`, а не из `productName`, так что выбранная тема пережила переименование. - **Открытие файла не работало в браузере вовсе.** `Ctrl+O` и пункт «Открыть…» лежали внутри блока «только для Electron»: без моста они молча не делали ничего. Вынесены @@ -438,61 +438,61 @@ Electron — 423 (+33) плюс 17 по настоящему приложени ### Скрытое -- **`DynamicResource` вместо `StaticResource` во всей разметке C#** — 161 место. Иначе +- **`DynamicResource` вместо `StaticResource` во всей разметке C#** - 161 место. Иначе смена темы не видна: `StaticResource` разрешается один раз при загрузке. Исключение ровно - одно и оно жёсткое: `Converter` у привязки — не свойство зависимости, и `DynamicResource` + одно и оно жёсткое: `Converter` у привязки - не свойство зависимости, и `DynamicResource` там валит приложение прямо при запуске. Найдено ровно так: тесты проходили, а окно не открывалось. Обе стороны правила теперь под проверкой. - **Проверки тем проверяют не «красиво ли», а три правила**: у всех тем один и тот же набор - ключей (разойдись он на один — на смене кисть окажется пустой, и падать будет в отрисовке, + ключей (разойдись он на один - на смене кисть окажется пустой, и падать будет в отрисовке, где причину уже не увидеть); текст виден на фоне своей темы; подложка над холстом остаётся тёмной в любой теме. Последнее уже стоило одной находки в 1.12.2. - **Проверки браузерного файла гоняются по СОБРАННОМУ файлу**, а не по исходнику: - пересылают именно его. Среди прочего — что он не тянет ничего из сети, иначе «перекинул + пересылают именно его. Среди прочего - что он не тянет ничего из сети, иначе «перекинул на другое устройство» работало бы только с интернетом. -## 1.12.2 — память измерена, main-процесс проверен, две находки глазами +## 1.12.2 - память измерена, main-процесс проверен, две находки глазами Три слепые зоны, названные после прошлого прохода, закрыты: расход памяти, main-процесс и внешний вид. Семь находок. Проверок: 262 быстрых плюс 14 по настоящему приложению. ### Портит работу -**Память.** Померить аллокатор здесь нечем — холсты слоёв лежат вне кучи JavaScript, и +**Память.** Померить аллокатор здесь нечем - холсты слоёв лежат вне кучи JavaScript, и `performance.memory` на них показывает почти ноль, та же ловушка, что была в C# с `PrivateMemorySize64`. Поэтому считается не то, что выдал аллокатор, а то, что попросили мы сами: создание холста, `getImageData`, `toDataURL`. Единица та же, что в C#: «эта операция просит x2.25 от холста». - **Заливка просила заплатку размером с весь документ.** Заплатка нужна (класть надо только - закрашенное, иначе стопка расплющится), но заводить её во весь холст — нет: заливка внутри + закрашенное, иначе стопка расплющится), но заводить её во весь холст - нет: заливка внутри рамки трогает малую часть картинки. Теперь по габариту закрашенного: **x2.04 → x1.11**. -- **Заливка держала две байтовые карты вместо одной.** «Смотрели» и «закрасили» — два бита, +- **Заливка держала две байтовые карты вместо одной.** «Смотрели» и «закрасили» - два бита, а не два массива по байту на пиксель. Ещё четверть холста. - **Подъём выделения снимал ВЕСЬ слой ради возможности отменить.** Меняется только область выделения, её и достаточно: **x3.22 → x0.27** на небольшом выделении. - **Под признак «рамка готова к перемещению» копировался целый `ImageData`.** Поле когда-то - везло пиксели, потом читать его перестали — а снимать не перестали: «Выделить всё» + везло пиксели, потом читать его перестали - а снимать не перестали: «Выделить всё» копировало весь холст ради одного `true`. Это тот же шаблон «правило доведено до половины», только в редкой форме, и чтением кода он не виден: строка выглядит осмысленно. - **Отмена пересоздавала всю стопку слоёв.** По холсту на каждый слой, и на время подмены в - памяти жили обе стопки сразу — двойной пик на каждом Ctrl+Z. Холсты переиспользуются: + памяти жили обе стопки сразу - двойной пик на каждом Ctrl+Z. Холсты переиспользуются: **x5.00 → x0.00** при пяти слоях, пересборка ленты **x11.09 → x1.09**. -**Внешний вид.** Обе находки — из запуска приложения руками. +**Внешний вид.** Обе находки - из запуска приложения руками. - **Каждый штрих утаскивал боковую панель вниз.** Лента прокручивается к текущей записи, и `scrollIntoView` тащил за собой все прокручиваемые родители: панель слоёв уезжала из виду прямо во время рисования. Теперь прокручивается только сам список. - **Подсказка, панель обрезки и кнопки масштаба были нечитаемы над холстом.** Стеклянные - подложки приложения — это БЕЛЫЙ с прозрачностью 0.08–0.14, и рассчитаны они на тёмный фон - окна. Над белым холстом подложка становится белой, а текст на ней светлый — и пропадает + подложки приложения - это БЕЛЫЙ с прозрачностью 0.08-0.14, и рассчитаны они на тёмный фон + окна. Над белым холстом подложка становится белой, а текст на ней светлый - и пропадает начисто. Ровно то же было с выпадающим меню в C#-версии. У подсказки для размеров и панели текста подложка была тёмной с самого начала: правило снова оказалось доведено до половины. ### Скрытое -- **`tests-app/` — проверки настоящего приложения, а не страницы в браузере.** Playwright +- **`tests-app/` - проверки настоящего приложения, а не страницы в браузере.** Playwright умеет запускать Electron и выполнять код В MAIN-ПРОЦЕССЕ: нативный диалог подменяется, не показываясь, и видно, что приложение сделало дальше. Четырнадцать проверок: запись в .jpg даёт настоящий JPEG, ошибка записи доезжает до пользователя, отказ от диалога не считается @@ -508,7 +508,7 @@ Electron — 423 (+33) плюс 17 по настоящему приложени в папке пользовательских данных, и без своей папки на запуск второй экземпляр молча выходил; обработчик диалога падал, если диалог успели снять. -## 1.12.1 — сплошной проход по новой площади: семь находок +## 1.12.1 - сплошной проход по новой площади: семь находок Слои и командная лента - это две новые подсистемы, то есть свежая площадь, по которой ещё никто не ходил. Пять партий проб, пять инвариантов фаззера и два разовых тяжёлых прогона. @@ -559,36 +559,36 @@ Electron — 423 (+33) плюс 17 по настоящему приложени поднятый объект вместе, а не по отдельности. Находки в этом проекте раз за разом приходят из стыков: правило записано у одного участника и не записано у соседнего. -## 1.12.0 — Electron: слои и выключатель правки. Обе версии сравнялись +## 1.12.0 - Electron: слои и выключатель правки. Обе версии сравнялись -Полный перенос. Две подсистемы, которых в Electron-версии не было вовсе, — стопка слоёв и -командная лента — построены с нуля, и вместе с ними доехали все правки C#-выпусков -1.12.0—1.23.0, которые до сих пор были неприменимы. Проверок: 193 (+58). +Полный перенос. Две подсистемы, которых в Electron-версии не было вовсе, - стопка слоёв и +командная лента - построены с нуля, и вместе с ними доехали все правки C#-выпусков +1.12.0 - 1.23.0, которые до сих пор были неприменимы. Проверок: 193 (+58). ### Новое -- **Слои.** Слой — отдельный холст того же размера, что документ; видимый холст стал - производным, его пересобирает сборка. Слой номер ноль — БУМАГА документа: на ней ластик +- **Слои.** Слой - отдельный холст того же размера, что документ; видимый холст стал + производным, его пересобирает сборка. Слой номер ноль - БУМАГА документа: на ней ластик красит белым, а на слоях выше вычитает; ей достаётся фон при смене размера; удалить её нельзя. На этом держится с полдюжины правил, как и в C#-версии. Панель: список сверху вниз, как стопка лежит на холсте. Активный слой обведён, скрытый зачёркнут и с пустым глазом, у бумаги обе стрелки погашены. Щелчок по глазу не меняет - активный слой — это два разных намерения. Ползунок непрозрачности показывает АКТИВНЫЙ + активный слой - это два разных намерения. Ползунок непрозрачности показывает АКТИВНЫЙ слой, а не последний тронутый. Потолок стопки считается по ПЛОЩАДИ (192 млн пикселей, не больше ста слоёв): на - маленьком документе сто слоёв безобидны, на большом смертельны — каждый слой это целый + маленьком документе сто слоёв безобидны, на большом смертельны - каждый слой это целый холст, и на снимке 4000×3000 «Добавить слой» съедает по 48 МБ за нажатие. - **У правки в ленте появился выключатель.** Щелчок по строке приводит документ к этой - позиции, то есть отменяет всё, что после неё. Галочка — другое: снял, и правка перестаёт + позиции, то есть отменяет всё, что после неё. Галочка - другое: снял, и правка перестаёт применяться, а идущие после неё остаются на месте. Выключенная строка показана зачёркнутой. Выключатель есть не у всех, и деление проходит не по «нарисованное против холста», а по тому, КАК правка ложится на картинку. Штрих, фигура, надпись, заливка и стирание - СКЛАДЫВАЮТСЯ с тем, что на слое, — пропустить любую из них при пересборке можно, и + СКЛАДЫВАЮТСЯ с тем, что на слое, - пропустить любую из них при пересборке можно, и получится ровно «как если бы этой правки не делали». Прижатие поднятого, вставка, поворот, отражение, кадрирование, смена размера, открытие файла, очистка и действия со слоями кладут ГОТОВЫЙ снимок: при пересборке они положат его поверх вместе с тем, что @@ -597,15 +597,15 @@ Electron — 423 (+33) плюс 17 по настоящему приложени отказать. Где галочки нет, строка объясняет почему. Признак несохранённой работы считает набор выключенных наравне с позицией курсора: - выключить правку — значит изменить картинку, включить обратно — вернуться ровно к + выключить правку - значит изменить картинку, включить обратно - вернуться ровно к сохранённому. ### Портит работу -Найдено при переносе, всё — правила, давно записанные в C#-версии: +Найдено при переносе, всё - правила, давно записанные в C#-версии: -- **Жест не помнил, на каком слое начался.** Слой меняют посреди штриха — панель под рукой - всё время, а у окна ввода текста между кликом и ответом проходит сколько угодно, — и +- **Жест не помнил, на каком слое начался.** Слой меняют посреди штриха - панель под рукой + всё время, а у окна ввода текста между кликом и ответом проходит сколько угодно, - и краска уходила не туда, где её начали класть. - **Превью мазка лежало поверх всей стопки.** Штрих по нижнему слою во время протяжки был виден над верхними, а на отпускании нырял под них: картинка прыгала в момент, когда @@ -614,21 +614,21 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **Спрятанный и полностью прозрачный слой молча съедали краску**: на экране не появлялось ничего, а запись в ленте появлялась и документ считался изменённым. Это касалось кисти, фигур, заливки, текста, вставки, вырезания и Delete. -- **«Создать» оставлял прежнюю стопку** — со всеми именами, спрятанностью и прозрачностью +- **«Создать» оставлял прежнюю стопку** - со всеми именами, спрятанностью и прозрачностью прошлой работы. - **Отмена удаления слоя уводила кисть на другой слой.** ### Скрытое - **Два смысла у `ctx` разделены.** Он и рисовал, и читал: инструменты клали в него краску, - пипетка и лента читали из него картинку. Со слоями это разные объекты — рисуют в холст + пипетка и лента читали из него картинку. Со слоями это разные объекты - рисуют в холст активного слоя, читают из видимого. Без этого разделения каждая правка угадывала бы, куда попала. -- **Кадр ленты хранит стопку целиком** — имена, видимость, прозрачность и пиксели каждого +- **Кадр ленты хранит стопку целиком** - имена, видимость, прозрачность и пиксели каждого слоя, плюс отпечаток свойств: скрытый слой картинку не меняет, а документ меняет. - **Складывающаяся правка записывается ПОВТОРИМОЙ**, а не только отменяемой: точки штриха, углы фигуры, строка и шрифт надписи, точка и цвет заливки. Пересборка не накладывает - сохранённые пиксели, а ПОВТОРЯЕТ правку заново — иначе заливка после выключенного штриха + сохранённые пиксели, а ПОВТОРЯЕТ правку заново - иначе заливка после выключенного штриха соврала бы: подложка стала другой, и растечься она обязана по-новому. - **Повтор обязан совпадать ДО ПИКСЕЛЯ, и «почти» тут не годится.** Три расхождения нашлись и закрыты: штрих рисовался одним сплошным путём вместо отрезка за отрезком (18 пикселей @@ -636,40 +636,40 @@ Electron — 423 (+33) плюс 17 по настоящему приложени `drawShape` берёт цвет и толщину из состояния, а не из контекста, и фигура повторялась сегодняшними настройками вместо записанных. - **Фаззер ленты.** Случайные последовательности правок и пять инвариантов: один и тот же - набор выключенных даёт один и тот же документ; включить всё обратно — то же, что не + набор выключенных даёт один и тот же документ; включить всё обратно - то же, что не выключать вовсе; выключение одной записи не трогает остальные; снимок ниже отнимает галочку у всего, что выше; прогулка по ленте с выключенными записями приводит к тому же. - Именно он поймал ошибку с `drawShape` — сценарной проверкой она не воспроизводилась. + Именно он поймал ошибку с `drawShape` - сценарной проверкой она не воспроизводилась. Разовый тяжёлый прогон: 25 seed'ов по 7 шагов со всеми видами правок, случайными - прозрачностями, режимами заливки и размерами шрифта — отказов нет. + прозрачностями, режимами заливки и размерами шрифта - отказов нет. - **Номер слоя переживает восстановление кадра.** Описание правки ссылается на слой по номеру, а восстановление создавало слои заново: повтор не находил, куда рисовать, и пересборка теряла всё, что было после базового кадра. -## 1.11.5 — вставка идёт двумя путями, а поправлен был один +## 1.11.5 - вставка идёт двумя путями, а поправлен был один -Разбор после запуска приложения живьём. Само наблюдение оказалось неубедительным — -нажатия до окна не дошли, — но поиск причины привёл к настоящей находке в коде. +Разбор после запуска приложения живьём. Само наблюдение оказалось неубедительным - +нажатия до окна не дошли, - но поиск причины привёл к настоящей находке в коде. ### Портит работу - **Картинка из системного буфера по-прежнему уезжала за край маленького холста.** Путей - вставки два: свой буфер (`pasteFromClipboard`) и системный — тот приходит событием + вставки два: свой буфер (`pasteFromClipboard`) и системный - тот приходит событием `paste` и идёт через `createFloatingFromImage`. Отступ в двадцать пикселей был зашит числом в обоих, а поправлен в 1.11.4 только в первом. Теперь отступ считает одна общая функция, и оба пути берут её. ### Скрытое -- **Проверка звала функцию вместо пути пользователя — и потому прошла мимо.** «Вставка по +- **Проверка звала функцию вместо пути пользователя - и потому прошла мимо.** «Вставка по пустому буферу объясняется» вызывала `pasteFromClipboard()` напрямую, а Ctrl+V приходит событием `paste`, и до этой функции доходит только когда в системном буфере нет картинки. Проверка переписана на событие; вторая проверяет отступ на системном пути. Проверок: 135. -## 1.11.4 — Electron: пять расхождений с C#-версией закрыто, остальное совпало само +## 1.11.4 - Electron: пять расхождений с C#-версией закрыто, остальное совпало само -Все 111 правок C#-выпусков 1.12.0—1.23.0 выписаны в список и прогнаны по Electron-версии -пробами на оснастке. Из них 23 требуют слоёв, которых здесь нет вовсе, и одна — командной +Все 111 правок C#-выпусков 1.12.0 - 1.23.0 выписаны в список и прогнаны по Electron-версии +пробами на оснастке. Из них 23 требуют слоёв, которых здесь нет вовсе, и одна - командной ленты вместо PNG-кадров; эти отложены. Из остальных проверено сорок с лишним, и совпало подавляющее большинство: часть этих правил в C#-версию попала как раз отсюда. Пять расхождений закрыто. Проверок: 123 (+29). @@ -678,22 +678,22 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **Ctrl+C и Ctrl+X без выделения не делали ничего и молчали.** В C#-версии Ctrl+C в этом положении копирует ВЕСЬ холст, а Ctrl+X объясняет, почему так не может: после этого не - осталось бы документа. Здесь обе клавиши были закрыты условием «есть выделение» — и в + осталось бы документа. Здесь обе клавиши были закрыты условием «есть выделение» - и в обработчике клавиш, и в пунктах меню «Правка». Теперь как в C#-версии. - **Штрих, фигура и текст прозрачными чернилами молчали.** Заливка про пустые чернила - говорит с 1.11.3, остальные рисующие — нет. Формулировка на все четыре теперь одна: + говорит с 1.11.3, остальные рисующие - нет. Формулировка на все четыре теперь одна: разные слова для одной и той же причины читались бы как разные причины. - **Вставка на маленький холст ложилась целиком за его краем.** Картинка кладётся с - отступом в двадцать пикселей от угла — так видно, что она лежит поверх, а не приклеена. + отступом в двадцать пикселей от угла - так видно, что она лежит поверх, а не приклеена. На холсте меньше самого отступа (такой остаётся после обрезки до мелочи) он уносил её с холста совсем: Ctrl+V выглядел ничего не сделавшим, а отмена при этом была нужна. Отступ теперь не больше четверти стороны. - **«Создать» наследовал размер холста прежней работы.** Открыл фотографию 4000×3000, - нажал «Создать» — и получил такой же огромный чистый лист; после обрезки до марки, - наоборот, лоскут в полсотни пикселей. Новый документ — это чистый лист, а не старый, + нажал «Создать» - и получил такой же огромный чистый лист; после обрезки до марки, + наоборот, лоскут в полсотни пикселей. Новый документ - это чистый лист, а не старый, залитый белым. - **Цвет пикселя в статусбаре не гас, когда курсор уходил с холста.** Координаты гаснут - прочерком с самого начала, HEX оставался и читался как цвет под курсором — которого на + прочерком с самого начала, HEX оставался и читался как цвет под курсором - которого на холсте уже нет. ### Новое @@ -711,54 +711,54 @@ Electron — 423 (+33) плюс 17 по настоящему приложени округляет угол поворота до 15°; полигон не хватается за угол описанного прямоугольника; подъём выделения у самого края холста не роняет; смена инструмента посреди протяжки не оставляет жест включённым; отмена удаления полигона возвращает холст до пикселя. Все они - теперь стоят проверками в `parity.spec.js` — каждая названа выпуском C#-версии, в котором + теперь стоят проверками в `parity.spec.js` - каждая названа выпуском C#-версии, в котором правило там появилось. - **Две «находки» оказались моими ошибками в пробах, а не дефектами.** Размер текста здесь слушается своего поля, а не общего ползунка толщины (в C#-версии отдельного поля нет, и - правка 1.18.0 была про это). Попадание по повёрнутому объекту считается правильно — + правка 1.18.0 была про это). Попадание по повёрнутому объекту считается правильно - `hitFloating` возвращает имя зоны, а не «да/нет», и проба сравнивала строку с `true`. ### Чего в Electron-версии не будет без переписывания -- **Слои.** Слова «layer» в файле нет ни разу. 23 правки C#-выпусков — про них. -- **Выключатель правки в ленте (C# 1.23.0).** Лента здесь — массив целых PNG-кадров, а не +- **Слои.** Слова «layer» в файле нет ни разу. 23 правки C#-выпусков - про них. +- **Выключатель правки в ленте (C# 1.23.0).** Лента здесь - массив целых PNG-кадров, а не команды с диффами; снимок нельзя «пропустить» при пересборке. -## 1.11.3 — Electron перестал отказывать молча +## 1.11.3 - Electron перестал отказывать молча Первый шаг синхронизации с C#-версией, и взят он не наугад: проверки из 1.11.2 прогнали по -Electron-версии правила, добытые в C#-выпусках 1.12.0—1.23.0. Из шестнадцати применимых -одиннадцать уже соблюдались, а пять провалившихся оказались одной семьёй — «отказ без слов». +Electron-версии правила, добытые в C#-выпусках 1.12.0 - 1.23.0. Из шестнадцати применимых +одиннадцать уже соблюдались, а пять провалившихся оказались одной семьёй - «отказ без слов». Проверок: 94 (+15). ### Портит работу -- **Одиннадцать действий не делали ничего и не говорили почему.** Нажал — не произошло +- **Одиннадцать действий не делали ничего и не говорили почему.** Нажал - не произошло ничего; отличить «не сработало» от «так и задумано» было нельзя. Теперь каждое такое место объясняется: - - Ctrl+C без выделения и Ctrl+X без выделения — разными словами: сказать «копировать + - Ctrl+C без выделения и Ctrl+X без выделения - разными словами: сказать «копировать нечего» на попытку вырезать было бы не про то. - Ctrl+V по пустому буферу. - Delete без выделения. - Заливка с прозрачностью в нуле. Заодно она больше не пишет в ленту. - Увеличение и уменьшение, упёршиеся в предел масштаба: кнопка нажимается, ничего не - меняется — это выглядело поломкой, хотя это потолок. + меняется - это выглядело поломкой, хотя это потолок. - Рамка выделения, обрезки и полигона меньше допустимой. Нижняя граница у рамки разумна, но пока рамка пропадала молча, выделение выглядело сломанным. - Поворот хоткеями «[» и «]» без поднятого объекта. Про эти хоткеи и так знают немногие. - В C#-версии тот же разбор шёл в 1.19.0—1.21.0. + В C#-версии тот же разбор шёл в 1.19.0 - 1.21.0. ### Новое - **Подсказка про отказ.** Строка над статусбаром, гаснет сама через три секунды. Не - модальное окно: «в буфере пусто» не заслуживает того, чтобы его закрывали руками — по той + модальное окно: «в буфере пусто» не заслуживает того, чтобы его закрывали руками - по той же причине WPF-версия показывает подсказку, а не диалог. ### Скрытое -- **Пятнадцать проверок, и половина из них — на обратное.** Мало проверить, что отказ +- **Пятнадцать проверок, и половина из них - на обратное.** Мало проверить, что отказ объяснился; надо проверить и что удавшееся действие молчит. Иначе подсказка начнёт выскакивать на каждое нормальное копирование, и её перестанут читать. - **Что из C#-правил уже соблюдалось.** Текст с переносами строки; текст из одних пробелов @@ -767,28 +767,28 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ним; кадрирование и поворот холста не теряют поднятое; второй подъём не затирает первый; полупрозрачная заливка подмешивается к подложке; Shift держит пропорции. -## 1.11.2 — у Electron-версии появились проверки, и первая же нашла три ошибки +## 1.11.2 - у Electron-версии появились проверки, и первая же нашла три ошибки До сих пор Electron-версию не проверял никто и ничто: четыре с лишним тысячи строк в одном файле, всё состояние в одном объекте, ни одного теста. Синхронизировать её с C#-версией в -таком виде значило переносить правки вслепую — ровно тот способ добавить кучу новых ошибок, +таком виде значило переносить правки вслепую - ровно тот способ добавить кучу новых ошибок, которого просили избежать. Поэтому сначала оснастка. Проверок: 79. ### Портит работу - **Только что запущенная программа считала пустой белый холст изменённым.** Закрыть окно, - ничего не нарисовав, было нельзя без вопроса «сохранить изменения?» — и так с самого + ничего не нарисовав, было нельзя без вопроса «сохранить изменения?» - и так с самого появления этого вопроса. Причина поучительная: в 1.10.0 появилась страховка «если метка «сохранено» осталась в отрезаемом хвосте повтора, сбросить её», с условием - `savedHistoryIndex > historyIndex`. У состояния на старте эти числа — 0 и −1, первый же + `savedHistoryIndex > historyIndex`. У состояния на старте эти числа - 0 и −1, первый же вызов на запуске принимает их за свой случай и уводит метку в −1. Правило верное, применялось на один вызов раньше, чем задумано. - **Правка, не изменившая ни одного пикселя, попадала в ленту.** Прозрачный мазок, фигура - нулевого размера от щелчка без протяжки, заливка тем цветом, что уже под курсором — всё + нулевого размера от щелчка без протяжки, заливка тем цветом, что уже под курсором - всё это давало запись, отмена которой ничего не отменяла. В C#-версии это чинилось в 1.20.0 покомандно: у каждой команды свой `ChangedAnything`, и штрих ради ответа заново сравнивает пиксели. Здесь архитектура сыграла за нас: лента хранит целые PNG-кадры, и «изменилось ли - что-нибудь» — это сравнение строки, которая всё равно уже посчитана для записи. + что-нибудь» - это сравнение строки, которая всё равно уже посчитана для записи. Тонкость в порядке: проверка стоит ДО обрезки хвоста повтора. Иначе пустой жест после отмены отнимал бы возможность повтора, не добавляя ничего взамен. @@ -797,7 +797,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Оснастка: `tests/` на Playwright.** Страница открывается в Chromium по файловому адресу, мышь водит по холсту по-настоящему, проверки читают пиксели через `getImageData` - и сравнивают целые кадры через `toDataURL`. Настоящий Electron для этого не нужен — + и сравнивают целые кадры через `toDataURL`. Настоящий Electron для этого не нужен - подменяется только мост в него. Запуск: `npm test`, весь набор проходит за 45 секунд. - **79 проверок пятью темами**: лента отмен (что в неё попадает, ходьба, потолки, метка сохранения), инструменты (фигуры, заливка, ластик, маркер, текст, хоткеи), холст (размер, @@ -805,14 +805,14 @@ Electron-версии правила, добытые в C#-выпусках 1.12 объектом, сеанс (сохранение и закрытие). - **Метод тот же, что в C#-версии: пробные проверки.** Пять партий гипотез, около семидесяти штук; подтвердившиеся стали постоянными проверками, остальные удалены. Первая партия дала - три находки, партии со второй по пятую — ни одной. Половина «падений» оказалась ошибками + три находки, партии со второй по пятую - ни одной. Половина «падений» оказалась ошибками в самих гипотезах, а не в приложении: щелчок карандашом законно ставит точку, `clearCanvas` - спрашивает подтверждение, `setCanvasSize` — служебная функция мимо ленты. + спрашивает подтверждение, `setCanvasSize` - служебная функция мимо ленты. - **Одно ограничение оснастки записано прямо в ней**: ровно по границе холста мышь Playwright - в него не попадает — попадание считается по контейнеру. Сам холст такое событие принимает, + в него не попадает - попадание считается по контейнеру. Сам холст такое событие принимает, это проверено отправкой `mousedown` в тот же угол напрямую. Проверки края берут отступ. -## 1.11.1 — фон без пузырей (только Electron-версия) +## 1.11.1 - фон без пузырей (только Electron-версия) Косметика по просьбе: правки касаются ТОЛЬКО Electron-версии, C#-версия остаётся на 1.23.0. Номер патчевый и на своей линии - набор возможностей не менялся ни на одну. @@ -833,33 +833,33 @@ Electron-версии правила, добытые в C#-выпусках 1.12 paint-pro-electron/tools/sync-changelog.js: он собирает из этого файла CHANGELOG.md для публикуемой Electron-версии. --> -## 1.23.0 — правка, которую можно выключить, меню без текста и пятый инвариант ленты +## 1.23.0 - правка, которую можно выключить, меню без текста и пятый инвариант ленты -Разбор после двадцатого прохода, и он не такой, как прежние: главное здесь — не находка, а +Разбор после двадцатого прохода, и он не такой, как прежние: главное здесь - не находка, а новая возможность, которую попросили. Плюс один дефект, найденный тем единственным -способом, каким его вообще можно было найти, — запуском приложения и взглядом на экран. +способом, каким его вообще можно было найти, - запуском приложения и взглядом на экран. Тесты: 565 (+32). ### Новое - **У правки в ленте появился выключатель.** Щелчок по строке истории и раньше приводил документ к этой позиции, то есть отменял всё, что сделано после неё. Теперь у части строк - есть галочка: снял — правка перестаёт применяться, а идущие после неё остаются на месте; - поставил обратно — вернулась. Выключенная строка показана зачёркнутой. + есть галочка: снял - правка перестаёт применяться, а идущие после неё остаются на месте; + поставил обратно - вернулась. Выключенная строка показана зачёркнутой. Выключатель есть не у всех, и деление проходит не по «нарисованное против холста», а по тому, как правка ложится на картинку. Штрих, фигура, надпись, заливка и стирание - СКЛАДЫВАЮТСЯ с тем, что на слое, — пропустить любого из них при пересборке можно, и + СКЛАДЫВАЮТСЯ с тем, что на слое, - пропустить любого из них при пересборке можно, и получится ровно «как если бы этой правки не делали». А прижатие поднятого объекта, вставка, поворот, отражение, кадрирование, смена размера, открытие файла, очистка и действия со слоями кладут ГОТОВЫЙ снимок: при пересборке они положат его поверх вместе с тем, что пользователь выключил, и выключатель начал бы врать. Поэтому галочка есть у складывающейся правки и только пока ниже неё нет ни одной пишущей снимок. Прижатие - объекта в этом списке наравне с поворотом — это строже, чем кажется, и намеренно: + объекта в этом списке наравне с поворотом - это строже, чем кажется, и намеренно: соврать хуже, чем отказать. Где галочки нет, строка при наведении объясняет почему. Признак несохранённой работы считает набор выключенных наравне с позицией курсора: - выключить правку — значит изменить картинку, а включить обратно — вернуться ровно к + выключить правку - значит изменить картинку, а включить обратно - вернуться ровно к сохранённому, и вопроса при закрытии тогда быть не должно. ### Портит работу @@ -867,22 +867,22 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Все выпадающие меню были нечитаемы.** «Файл», «Правка», «Вид», «Изображение» открывались пустой светлой панелью: пункты на месте, нажимаются, но текста не видно. Заголовки в строке меню стоят на нашем тёмном фоне и раскрашены светлым, а выпадающий - список система рисует СВОИМ светлым фоном — и тот же светлый текст пропадал на нём + список система рисует СВОИМ светлым фоном - и тот же светлый текст пропадал на нём начисто. - Первая попытка — покрасить пункты списка в тёмный по их роли — не помогла, и это + Первая попытка - покрасить пункты списка в тёмный по их роли - не помогла, и это оказалось поучительно: сквозной стиль `TextBlock` задаёт цвет НАСТАВЛЕНИЕМ, а оно сильнее наследования, и до подписи внутри пункта наш цвет не доходил вовсе. Видно это было только по дереву настоящего окна: у самой строки меню цвет уже тёмный, а у `TextBlock` внутри - неё — по-прежнему светлый. Поэтому отрисовка меню забрана целиком: свой тёмный фон, свои + неё - по-прежнему светлый. Поэтому отрисовка меню забрана целиком: свой тёмный фон, свои подписи, свои подсказки хоткеев справа, свой разделитель. Заодно меню перестало выпадать из общего вида программы. - **Всплывающие подсказки были нечитаемы по той же причине.** «Карандаш (P)», «Видимость», - объяснение у строки истории — все выходили пустой белой полосой, и так было с самого + объяснение у строки истории - все выходили пустой белой полосой, и так было с самого начала. Лечится тем же: подсказка рисуется своим тёмным фоном и переносит длинные строки по словам. - Ни то ни другое не ловится ни одним тестом. Нашлось это только запуском приложения — и + Ни то ни другое не ловится ни одним тестом. Нашлось это только запуском приложения - и только после того, как выяснилось, что снимок экрана через средства управления компьютером ЗАМАЗЫВАЕТ всплывающие окна: и меню, и подсказка приходили пустыми и в здоровом виде тоже. Настоящую картинку дал обычный снимок экрана средствами системы. @@ -892,42 +892,42 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **У записи ленты появились два новых вопроса к себе: «пишу ли я готовый снимок» и «забудь снимок до».** Первый по умолчанию отвечает «да»: команда, о которой никто не подумал, автоматически оказывается невыключаемой. Ошибка в эту сторону стоит отказа, в - обратную — совравшей ленты. Второй нужен после переключения: снимок «до», снятый при + обратную - совравшей ленты. Второй нужен после переключения: снимок «до», снятый при первой записи, помнит слой вместе с выключенной правкой, и первый же Ctrl+Z вернул бы пиксели по устаревшему. - **Пятый инвариант фаззера ленты.** К четырём прежним добавилось «выключить запись и включить обратно возвращает документ до пикселя», а само переключение вошло в набор случайных правок двадцать шестым видом. Тяжёлый разовый прогон: 27 000 правок, 10 800 - прыжков по ленте и 8 789 переключений — отказов нет. Отдельный прогон только по + прыжков по ленте и 8 789 переключений - отказов нет. Отдельный прогон только по складывающимся правкам проверял, что один и тот же набор выключенных всегда даёт один и тот же документ, а включение всего обратно совпадает с лентой, где ничего не выключали. -- **Спецификация возможности записана до кода** — `docs/superpowers/specs/`. Там же +- **Спецификация возможности записана до кода** - `docs/superpowers/specs/`. Там же разобрано, почему прижатие объекта попало в стоп-список вместе с поворотом. -## 1.22.0 — заливка вдвое легче, подъём впятеро и слои, которые перестали множиться +## 1.22.0 - заливка вдвое легче, подъём впятеро и слои, которые перестали множиться Разбор после девятнадцатого прохода. Правки только в C#-версии; Electron-версия остаётся на 1.11.0. Тема выбрана та, на которую указала находка прошлого релиза: потолок стоит на том, что хранится, и не стоит на том, что из этого разворачивается по ходу работы. На этот -раз мерили, а не считали по коду — поточный счётчик выделений точен и повторяем, и он сразу +раз мерили, а не считали по коду - поточный счётчик выделений точен и повторяем, и он сразу показал две операции, просящие сверх документа кратно больше остальных. Три правки. Тесты: 533 (+11). ### Портит работу -- **Число слоёв не ограничивал никто, а каждый слой — это целый холст.** Потолок у +- **Число слоёв не ограничивал никто, а каждый слой - это целый холст.** Потолок у документа был только на площадь одного холста: сторона до 20000 пикселей и до 120 млн пикселей всего. На снимке 4000×3000 каждое нажатие «Добавить слой» отъедало 48 МБ, и удерживать кнопку можно было до тех пор, пока приложение не умрёт. Теперь стопка слоёв - ограничена той же величиной, что и лента истории, — 768 МБ, — и предел считается от + ограничена той же величиной, что и лента истории, - 768 МБ, - и предел считается от размера холста: на обычном документе это сотня слоёв (больше никто и не заводит), на - фотографии — полтора десятка, на самом большом разрешённом холсте — один. Упёршись в + фотографии - полтора десятка, на самом большом разрешённом холсте - один. Упёршись в предел, кнопка объясняет отказ, а не молчит. ### Мешало обычной работе - **Заливка просила вдвое больше холста, чем ей нужно.** Кроме рабочего буфера она держала - копию ВСЕГО слоя — снятую заранее, на случай, если понадобится вырезать из неё снимок для + копию ВСЕГО слоя - снятую заранее, на случай, если понадобится вырезать из неё снимок для отмены. Не понадобилась: заливка идёт в отдельном буфере, и слой всё это время держит прежние пиксели сам, так что снимок берётся прямо с него, когда область уже известна. На холсте в 120 млн пикселей это 480 сэкономленных мегабайт на каждый щелчок. Измерено: @@ -936,28 +936,28 @@ Electron-версии правила, добытые в C#-выпусках 1.12 обходит всю площадь, и пиксель помечался пройденным при извлечении из стека, а не при помещении в него: один и тот же индекс попадал туда по числу своих соседей, и стек разрастался до нескольких размеров самой картинки. Обход от поправки не изменился ни на - пиксель — каждый индекс и раньше обрабатывался ровно один раз, — зато стек больше не может + пиксель - каждый индекс и раньше обрабатывался ровно один раз, - зато стек больше не может стать длиннее, чем есть пикселей. Измерено: было ×5.45, стало ×1.56. ### Скрытое -- **Карта «этот пиксель уже смотрели» — битами, а не байтами.** Она нужна и выкусыванию +- **Карта «этот пиксель уже смотрели» - битами, а не байтами.** Она нужна и выкусыванию фона, и заливке, и обеим размером с картинку: на холсте в 120 млн пикселей это разница между 120 и 15 мегабайтами. - **Расход памяти проверяется тестом, а не на глаз.** Каждая операция меряется в долях холста, и у каждой записан свой потолок. Счётчик обязан быть ПОТОЧНЫМ: xunit гоняет - классы тестов параллельно, и общий по процессу считал бы заодно всё, что выделяют соседи - — проверка проходила в одиночку и падала в общем прогоне. + классы тестов параллельно, и общий по процессу считал бы заодно всё, что выделяют соседи - + проверка проходила в одиночку и падала в общем прогоне. - **Нативную память Skia померить отсюда нечем.** Счётчики процесса на таких объёмах шумят сильнее самой разницы: поворот трёх слоёв по 34 МБ показывал прирост «0 МБ». Поэтому под - тестом только операции с управляемыми буферами, а всё остальное ограничивается счётом — + тестом только операции с управляемыми буферами, а всё остальное ограничивается счётом - как предел на число слоёв и как потолок масштаба из 1.21.0. -## 1.21.0 — три гигабайта на масштаб, накладка под тестами и разметка, которую читают +## 1.21.0 - три гигабайта на масштаб, накладка под тестами и разметка, которую читают Разбор после восемнадцатого прохода. Правки только в C#-версии; Electron-версия остаётся на 1.11.0. Проход этот другой: искали не в модели и командах, куда тесты доставали и -раньше, а в слое представления — тысяча триста строк code-behind и разметки, в которых до +раньше, а в слое представления - тысяча триста строк code-behind и разметки, в которых до сих пор не было ни одного теста, при том что именно они решают, куда попадёт клик. Оттуда и вывод: находка одна, зато такая, что роняла приложение целиком, а главным итогом стало то, что этот слой вообще стало можно проверять. Тесты: 522 (+58). @@ -965,23 +965,23 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ### Портит работу - **Четыре нажатия Ctrl+= на фотографии убивали приложение нехваткой памяти.** Экранная - поверхность холста — это документ, умноженный на масштаб, и растрируется она целиком: + поверхность холста - это документ, умноженный на масштаб, и растрируется она целиком: под неё заводится один битмап на всю площадь, по четыре байта на пиксель, без всякой - виртуализации по видимой области. Потолок стоял только у самого документа — сторона до - 20000 пикселей и до 120 млн пикселей всего, — а произведение «документ × масштаб» не + виртуализации по видимой области. Потолок стоял только у самого документа - сторона до + 20000 пикселей и до 120 млн пикселей всего, - а произведение «документ × масштаб» не проверял никто. Обычный снимок 4000×3000 на восьмикратном увеличении просил 2930 МБ, - самый большой разрешённый холст — 29 ГБ. Падало это прямо в отрисовке, мимо всех + самый большой разрешённый холст - 29 ГБ. Падало это прямо в отрисовке, мимо всех `catch`'ей, вместе с несохранённым рисунком. Ровно та же дыра, что закрывалась в 1.19.0 у «Открыть»: потолок проверяет одно место и не проверяет соседнее. Теперь масштаб ограничен размером холста так, чтобы поверхность не превышала 64 млн пикселей (256 МБ); - холсту по умолчанию это оставляет весь восьмикратный зум, обычному снимку экрана — тоже. + холсту по умолчанию это оставляет весь восьмикратный зум, обычному снимку экрана - тоже. - **Кнопка «1:1» на большом документе роняла его так же.** Сброс масштаба ставил единицу не спрашивая, а стосорокамегапиксельный холст один к одному показать нельзя. Теперь она - ставит единицу или потолок — что меньше. + ставит единицу или потолок - что меньше. ### Мешало обычной работе -- **Увеличение, упёршееся в потолок, молчало.** Кнопка нажимается, ничего не происходит — +- **Увеличение, упёршееся в потолок, молчало.** Кнопка нажимается, ничего не происходит - неотличимо от сломанной. Теперь она говорит, что дальше нельзя и почему. То же правило, по которому объясняют себя остальные отказы с 1.19.0. @@ -990,7 +990,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Арифметика окна просмотра вынесена из code-behind.** Размер поверхности под масштаб, перевод экранных координат в документ, прокрутка при зуме и панорамировании, положение ручек и строки статусбара жили среди обработчиков мыши, и проверить их было нельзя - ничем. Теперь это `ViewGeometry` — чистый счёт без единого обращения к WPF, и на него + ничем. Теперь это `ViewGeometry` - чистый счёт без единого обращения к WPF, и на него двадцать проверок. Тем же приёмом из вьюмодели в своё время вынесены `TryParseCanvasSize` и `PasteOrigin`. - **Настоящие элементы WPF поднимаются в тестах.** Казалось, что без запущенного @@ -1001,12 +1001,12 @@ Electron-версии правила, добытые в C#-выпусках 1.12 размеры, а также жесты: чужая кнопка мыши, потеря захвата посреди штриха и смена инструмента на полпути. - **Привязки и хоткеи проверяются чтением самой разметки.** Прежняя проверка была списком - путей, выписанным руками, а такой список отстаёт от разметки — это тот же шаблон + путей, выписанным руками, а такой список отстаёт от разметки - это тот же шаблон «правило доведено до половины», от которого находки шли весь прошлый проход. Теперь `MainWindow.xaml` читается целиком: каждый путь привязки обязан существовать хоть на - одном из типов, которые бывают его контекстом, каждая команда — на вьюмодели, каждый - хоткей инструмента — называть настоящий инструмент, и каждая буква, обещанная в - подсказке кнопки, — быть на самом деле назначенной. + одном из типов, которые бывают его контекстом, каждая команда - на вьюмодели, каждый + хоткей инструмента - называть настоящий инструмент, и каждая буква, обещанная в + подсказке кнопки, - быть на самом деле назначенной. - **Один тест выброшен как ненадёжный.** Проверка «колесо без Ctrl не меняет масштаб» читает НАСТОЯЩЕЕ состояние клавиатуры машины и потому падала примерно раз на пятнадцать прогонов. Тест, который врёт раз в пятнадцать раз, хуже отсутствующего. @@ -1017,39 +1017,39 @@ Electron-версии правила, добытые в C#-выпусках 1.12 объектом, границах холста под курсором, строках статусбара, закрытии жеста при потерянном захвате и в самой разметке. Туда больше не смотреть. -## 1.20.0 — правка без следа, слой без цвета и отказы без слов +## 1.20.0 - правка без следа, слой без цвета и отказы без слов Разбор после семнадцатого прохода. Правки только в C#-версии; Electron-версия остаётся на 1.11.0. Проверок в этот раз было около ста семидесяти, разложенных на десять пачек -гипотез; четыре пачки не дали ни одной находки — вырожденные размеры холста, сборка -картинки со слоями и превью, связки «вставка — прижатие — отмена — повтор» и правила, +гипотез; четыре пачки не дали ни одной находки - вырожденные размеры холста, сборка +картинки со слоями и превью, связки «вставка - прижатие - отмена - повтор» и правила, доведённые до половины в геометрии, оказались чисты. Оставшиеся находки собрались вокруг трёх вещей. Первая, и она же самая крупная: правило «жест, от которого на холсте ничего -не изменилось, не попадает в ленту истории» знали заливка и стирание — и не знали штрих, -фигура, надпись и все операции над документом целиком. Вторая — прозрачность слоя, +не изменилось, не попадает в ленту истории» знали заливка и стирание - и не знали штрих, +фигура, надпись и все операции над документом целиком. Вторая - прозрачность слоя, выкрученная в ноль: она подкрашивала картинку и прятала то, что пользователь держит в -руках, при том что для спрятанного слоя правило записано обратное. Третья — снова отказы, +руках, при том что для спрятанного слоя правило записано обратное. Третья - снова отказы, которые молчат. Тринадцать правок. Тесты: 464 (+55). ### Портит работу -- **Слой, выкрученный в полную прозрачность, подкрашивал картинку — и на экране, и в +- **Слой, выкрученный в полную прозрачность, подкрашивал картинку - и на экране, и в файле.** Ползунок прозрачности доходит до нуля, и такой слой не должен быть виден вовсе. Skia на краске с нулевой альфой всё равно подмешивает битмап примерно на один уровень из 255: белая бумага под погашенным зелёным слоем выходила #FEFEFE вместо - #FFFFFF — и в сохранённом PNG тоже. Пипетка при этом отвечала честным #FFFFFF, потому + #FFFFFF - и в сохранённом PNG тоже. Пипетка при этом отвечала честным #FFFFFF, потому что такие слои она пропускает, и два места, которые обязаны отвечать одинаково, - расходились на ровном месте. Теперь слой без прозрачности не рисуется совсем — как + расходились на ровном месте. Теперь слой без прозрачности не рисуется совсем - как спрятанный. - **Поднятая картинка пропадала с экрана, если прозрачность её слоя увели в ноль.** Правило «спрятать то, что пользователь сейчас тащит, хуже любой нестыковки» записано для видимости слоя: объект в руках виден и на спрятанном слое. Про прозрачность про - него забыли, и объект пропадал целиком — рамка и ручки на месте, внутри пусто, и + него забыли, и объект пропадал целиком - рамка и ручки на месте, внутри пусто, и понять, куда делась картинка, было нельзя. Теперь оба случая это одно и то же «слоя сейчас не видно», и объект показывается полностью в обоих. Пипетка отвечает тем же. - **Щелчок по ТЕКУЩЕЙ строке ленты оставлял поднятое в руках.** Строка панели истории обязана означать одно и то же состояние документа, каким бы путём на неё ни пришли. - Прогулка по ленте снимает с рук то, чего она вернуть не сможет, — но щелчок по строке, + Прогулка по ленте снимает с рук то, чего она вернуть не сможет, - но щелчок по строке, на которой курсор уже стоит, возвращался из неё сразу и до этого места не доходил. На одной и той же позиции получалось то с картинкой в руках, то без: смотря щёлкнули по ней самой или пришли на неё с соседней. Это тот же инвариант, что проверяет фаззер @@ -1059,7 +1059,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ### Мешало обычной работе - **Ластик по нетронутой бумаге объявлял документ изменённым.** Провёл ластиком по - чистому месту — ни один пиксель не поменялся, а в ленте появилась строка «Штрих», и при + чистому месту - ни один пиксель не поменялся, а в ленте появилась строка «Штрих», и при закрытии окно спрашивало про сохранение работы, которой не было. Пустым штрих выходит чаще, чем кажется: белая кисть по белому, ластик по пустому месту верхнего слоя, надпись белым по белому, фигура белым по белому, любой жест мимо холста. Правило @@ -1067,22 +1067,22 @@ Electron-версии правила, добытые в C#-выпусках 1.12 выделения; каждый раз, когда оно всплывало, его чинили у очередной команды по отдельности. Теперь вопрос задаёт сама лента, один и тот же ко всем. - **Кадрирование по всему холсту записывалось как правка.** Рамка обведена по краям - холста (или шире), кнопка отпущена — холст прежний до пикселя, а в ленте «Кадрирование» + холста (или шире), кнопка отпущена - холст прежний до пикселя, а в ленте «Кадрирование» и документ изменён. То же и с отражением симметричной картинки, и с поворотом квадратного чистого листа, и с открытием файла, который на холсте и так лежит. Все они идут одной командой, и теперь она сама говорит про себя, изменила ли она хоть что-то. Свойства слоёв при этом считаются наравне с пикселями: открытие файла в документ со - спрятанной бумагой пикселей не меняет, а видимость — меняет, и такую запись пропускать + спрятанной бумагой пикселей не меняет, а видимость - меняет, и такую запись пропускать нельзя. - **Заливка прозрачными чернилами молчала.** Ползунок прозрачности начинается с нуля, - дотянуть до него — одно движение. Кисть, фигура и текст про пустые чернила говорят с + дотянуть до него - одно движение. Кисть, фигура и текст про пустые чернила говорят с 1.19.0; заливка оставалась единственной рисующей, кто молча ничего не делал. - **Ctrl+X без выделения не делал ничего и молчал.** Ctrl+C в том же положении копирует весь холст: одна и та же пара клавиш на одном и том же документе отвечала по-разному, и - понять, почему, было нельзя. Вырезать холст целиком нельзя — после этого не осталось бы - документа, — значит надо сказать словами. + понять, почему, было нельзя. Вырезать холст целиком нельзя - после этого не осталось бы + документа, - значит надо сказать словами. - **Нажатие «×» у единственного слоя молчало.** Бумагу документа удалить нельзя, и об - этом есть объяснение — но проверка «слой в стопке один» стояла перед ним и молча + этом есть объяснение - но проверка «слой в стопке один» стояла перед ним и молча съедала единственный случай, когда она вообще срабатывает: в новом документе слой ровно один, он же бумага. Порядок теперь обратный. - **Хоткеи поворота «[» и «]» без выделения молчали.** Про них и так знают немногие, а @@ -1095,8 +1095,8 @@ Electron-версии правила, добытые в C#-выпусках 1.12 означает, что снимок «до», который эта команда держала для отмены, больше никому не нужен: у штриха размером с холст это несколько мегабайт нативной памяти мимо сборщика мусора за жест. -- **Фаззер признака несохранённой работы стал односторонним — и от этого честным.** - Инвариант «картинка отличается от сохранённой ⇒ документ изменён» — закон: обратное +- **Фаззер признака несохранённой работы стал односторонним - и от этого честным.** + Инвариант «картинка отличается от сохранённой ⇒ документ изменён» - закон: обратное означало бы молча потерянную работу при закрытии окна. А обратное направление законом не является, и требовать его нельзя: добавленный слой сборку не меняет (файл-то плоский), но терять стопку слоёв пользователь не соглашался, а два отражения подряд @@ -1107,37 +1107,37 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ленте на каждом.** Отказов нет. Проверялись оба инварианта сразу: «позиция курсора однозначно задаёт документ» и «отмена всего даёт чистый лист того же размера». -## 1.19.0 — ручки не по размеру, вставка мимо холста и отказы без слов +## 1.19.0 - ручки не по размеру, вставка мимо холста и отказы без слов Разбор после шестнадцатого прохода. Правки только в C#-версии; Electron-версия остаётся -на 1.11.0. Находки снова собрались вокруг трёх вещей. Первая — правило, доведённое до +на 1.11.0. Находки снова собрались вокруг трёх вещей. Первая - правило, доведённое до половины: зона хвата ужимается под размер фигуры у углов маски, но не у восьми ручек масштабирования; потолок размера холста проверяет диалог «Изменить размер», но не «Открыть»; правку, не изменившую ни пикселя, отсеивают штрих, фигура, текст, заливка и -прижатие — и не отсеивало стирание. Вторая — жесты, которые отказывают молча: рамка +прижатие - и не отсеивало стирание. Вторая - жесты, которые отказывают молча: рамка меньше четырёх пикселей, кадрирование по такой же рамке, Ctrl+V по буферу без картинки. -Третья — интерфейс, отставший от модели: строка панели слоёв после «Создать» и строка +Третья - интерфейс, отставший от модели: строка панели слоёв после «Создать» и строка «Исходное состояние» после переполнения ленты. Десять правок. Тесты: 409 (+35). ### Портит работу - **Открытие большой картинки уносило приложение вместе с несохранённым рисунком.** Диалог «Изменить размер холста» держит потолок: сторона не больше 20000 пикселей и не - больше 120 млн пикселей всего. «Открыть» не проверяло ничего. Снимок 25000×25000 — это + больше 120 млн пикселей всего. «Открыть» не проверяло ничего. Снимок 25000×25000 - это два с половиной гигабайта на слой, и раскодирование падало нехваткой памяти мимо всех `catch`'ей: окно закрывалось, вопроса про сохранение не было, работа пропадала. Габарит теперь читается из ЗАГОЛОВКА файла, до раскодирования, и отказ приходит раньше, чем под картинку выделят хоть байт. Тем же путём идёт и перетаскивание файла в окно. -- **Ручки маленького объекта накрывали его целиком — тело было не ухватить.** Восемь +- **Ручки маленького объекта накрывали его целиком - тело было не ухватить.** Восемь ручек по двенадцать экранных пикселей стоят по углам и серединам сторон; у объекта меньше двух таких размеров верхняя и нижняя смыкаются посередине. Клик в любую точку - попадал в ручку, и вместо перетаскивания начиналось масштабирование — увезти объект + попадал в ручку, и вместо перетаскивания начиналось масштабирование - увезти объект было нельзя вовсе. Начиналось это на 24 экранных пикселях: при масштабе 1:1 это - выделение с ноготь, а на картинке в четверть натуральной величины — почти сто пикселей + выделение с ноготь, а на картинке в четверть натуральной величины - почти сто пикселей документа. Ровно то же и по той же причине было у зоны хвата углов маски и починено в 1.18.0; ручки остались в стороне. Теперь ручка не может быть больше половины меньшей - стороны объекта — на крупных объектах не меняется ничего. + стороны объекта - на крупных объектах не меняется ничего. - **«Создать» оставляло в панели слоёв прежние флажок и ползунок.** Новый документ возвращает бумагу к видимой и непрозрачной, но строки панели держат свои копии этих значений и пересобираются, когда меняется сама стопка слоёв. У документа с ОДНИМ слоем @@ -1148,28 +1148,28 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ### Мешало обычной работе - **Вставка на маленький холст ложилась целиком за его краем.** Картинка кладётся с - отступом в двадцать пикселей от угла — так видно, что она лежит поверх, а не приклеена. + отступом в двадцать пикселей от угла - так видно, что она лежит поверх, а не приклеена. На холсте меньше двадцати пикселей (а такой остаётся после кадрирования до мелочи или смены размера) этот отступ уносил её с холста совсем: Ctrl+V не показывал ничего, в - ленте появлялась строка «Вставка», и первое же прижатие вычёркивало её обратно — + ленте появлялась строка «Вставка», и первое же прижатие вычёркивало её обратно - прижимать было некуда. Со стороны это выглядело как «вставка не работает». Отступ теперь не может увести картинку с холста. - **Delete по области, где стирать нечего, объявлял документ изменённым.** Рамка по - нетронутой бумаге или по пустому месту верхнего слоя, Delete — и ни один пиксель не + нетронутой бумаге или по пустому месту верхнего слоя, Delete - и ни один пиксель не менялся, зато в ленте появлялась запись «Удаление выделения», а при закрытии окно спрашивало про сохранение работы, которой не было. Правило «действие, не изменившее ни пикселя, в историю не пишется» знали штрих, фигура, текст, заливка и прижатие; стирание его не знало. - **Рамка меньше четырёх пикселей пропадала молча.** Нижняя граница у выделения есть, и она не случайна: у фигуры меньше двух диаметров зоны хвата четыре угловых зоны - смыкаются и накрывают её целиком. Но пользователю об этом не говорилось ни слова — он + смыкаются и накрывают её целиком. Но пользователю об этом не говорилось ни слова - он тянул мышью, отпускал, и на холсте не оставалось ничего, неотличимо от промаха. Теперь - об этом говорит строка в статусбаре — как про скрытый слой и про нулевую прозрачность. + об этом говорит строка в статусбаре - как про скрытый слой и про нулевую прозрачность. Чистый клик по-прежнему молчит: им как раз снимают выделение. - **Кадрирование по такой же рамке молча не срабатывало.** То же самое и с той же границей: рамка обведена, кнопка отпущена, холст прежний, объяснений нет. Заодно объясняется и рамка, целиком уехавшая за край холста. -- **Ctrl+V по буферу без картинки молчал.** Занятый буфер объяснялся с 1.16.0, пустой — +- **Ctrl+V по буферу без картинки молчал.** Занятый буфер объяснялся с 1.16.0, пустой - нет. В буфере обычно оказывается текст или файл, вставлять нечего, но отличить это от сломанной вставки было нельзя, и оставалось жать ещё и ещё. @@ -1177,10 +1177,10 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Запись прижатия описывала слой на момент подъёма, а не на момент прижатия.** «До» для дифа бралось из снимка, снятого при подъёме выделения. Пока между подъёмом и прижатием - со слоем ничего не происходит, ответ тот же самый до пикселя — а вот если происходит, + со слоем ничего не происходит, ответ тот же самый до пикселя - а вот если происходит, первый же Ctrl+Z стирал сделанное заодно с прижатием. Сегодня из интерфейса до этого не дотянуться: все пути к рисующей правке прижимают поднятое заранее. Но правило это жило - в вызывающих, а не в самой записи, и достаточно было бы одного нового пути — ровно так + в вызывающих, а не в самой записи, и достаточно было бы одного нового пути - ровно так в 1.18.0 пропадал второй плавающий объект. Теперь «до» собирается из ЖИВОГО слоя, в котором восстановлена одна только исходная область, а снимок пересматривается прямо перед тем, как эту область выкусить. @@ -1190,46 +1190,46 @@ Electron-версии правила, добытые в C#-выпусках 1.12 обещала вернуть документ к началу работы, а возвращала к середине. Теперь она честно называется «Дальше отмена не идёт», пока из ленты что-то выброшено. - **У фаззера ленты стало двадцать пять видов правок вместо девятнадцати.** Добавились - «Создать», отказ от поднятого (Escape) и выбрасывание поднятого (Delete) — две - противоположные развязки одного жеста, — стирание многоугольником, у которого + «Создать», отказ от поднятого (Escape) и выбрасывание поднятого (Delete) - две + противоположные развязки одного жеста, - стирание многоугольником, у которого сглаженный контур задевает пиксели за габаритом, и два вида, которых не было совсем: полный жест самих инструментов выделения, от рамки до прижатия, а не вызовы `PickupOps` напрямую. Тяжёлый прогон на 250 seed'ах по 30 шагов в восьми сочетаниях наборов правок отказов не дал. Отдельно прогнан фаззер признака несохранённой работы: 300 seed'ов проверяли, что «изменено» означает «файл вышел бы другим», и обратно; молча потерянной - работы не нашлось ни одной, а ложные тревоги свелись к пустому стиранию — оно в этом + работы не нашлось ни одной, а ложные тревоги свелись к пустому стиранию - оно в этом списке выше. -## 1.18.0 — форма выделения, две руки на один объект и лента, которая помнит не то +## 1.18.0 - форма выделения, две руки на один объект и лента, которая помнит не то Разбор после пятнадцатого прохода. Правки только в C#-версии; Electron-версия остаётся -на 1.11.0. Находки собрались вокруг трёх вещей. Первая — инвариант, записанный в +на 1.11.0. Находки собрались вокруг трёх вещей. Первая - инвариант, записанный в вызывающих, а не в том, кто его держит: «новый плавающий объект прижимает прежний» знали -все четыре места, откуда объект берётся, и ни одно из них не отвечало за это правило — +все четыре места, откуда объект берётся, и ни одно из них не отвечало за это правило - достаточно было пятого пути, чтобы поднятое пропадало без следа вместе с записью о себе. -Вторая — правило, доведённое до половины: рамка-многоугольник задаёт форму, и поднятый +Вторая - правило, доведённое до половины: рамка-многоугольник задаёт форму, и поднятый объект её уважает, а копирование той же рамки брало описанный вокруг прямоугольник. -Третья — «новый документ» и «размер холста»: чистый лист сбрасывал стопку слоёв, имя +Третья - «новый документ» и «размер холста»: чистый лист сбрасывал стопку слоёв, имя бумаги, её видимость и прозрачность, а габарит прежней работы наследовал. Десять правок. Тесты: 374 (+41). ### Портит работу -- **Второй плавающий объект затирал первый — вместе с пикселями и записью о нём.** +- **Второй плавающий объект затирал первый - вместе с пикселями и записью о нём.** Присваивание в `Document.FloatingPickup` просто меняло ссылку. Пиксели первого объекта не ложились ни на один слой и пропадали совсем; его битмапы не освобождались вовсе, то есть нативная память утекала мимо сборщика мусора; а если это была вставка, её запись оставалась в ленте применённой при том, что картинки на холсте уже нет. Дальше позиция курсора переставала однозначно задавать документ: пройдя ленту снизу, на той же строке - получали картинку в руках, пройдя сверху — пустоту. Правило то же, что у рамки выделения - поверх объекта («сначала прижать прежнее»), и живёт оно теперь там же — в самом + получали картинку в руках, пройдя сверху - пустоту. Правило то же, что у рамки выделения + поверх объекта («сначала прижать прежнее»), и живёт оно теперь там же - в самом документе, а не в каждом вызывающем по отдельности. - **Копия многоугольного выделения тащила чужие пиксели.** Углы описанного вокруг прямоугольника лежат ВНЕ выделенного. Пока копирование шло по нему, Ctrl+C по треугольнику клал в буфер прямоугольную заплатку с фоном по углам, и вставка возвращала на холст не фигуру, а кусок фона с фигурой внутри. Delete по тому же выделению при этом - стирал именно многоугольник — копия и вырезание описывали разные области. Поднятый - многоугольник маску уважал с самого начала, рамка — нет. + стирал именно многоугольник - копия и вырезание описывали разные области. Поднятый + многоугольник маску уважал с самого начала, рамка - нет. - **Клик по строке «Вставка» в панели истории убирал картинку из рук.** Прогулка по ленте снимала плавающий объект без разбора. Поднятое пользователем выделение снимать надо: оно держит снимок слоя на момент подъёма, а после шага по ленте этот снимок описывает @@ -1238,14 +1238,14 @@ Electron-версии правила, добытые в C#-выпусках 1.12 картинка исчезала, и вернуть её было нечем: курсор уже стоял там, куда его просили поставить. Тем же порядком её убирал обычный Ctrl+Y. - **Прижатая вставка оставляла в ленте две записи вместо одной.** «Вставка» кладёт - картинку в руки, диф прижатия описывает всё, что она означает для холста, — и подпись + картинку в руки, диф прижатия описывает всё, что она означает для холста, - и подпись «Вставка» несёт он же. Пока обе записи оставались, позиция курсора снова переставала задавать документ: на курсоре, куда пришли отменой прижатия, на холсте не было ничего, а - на том же курсоре, куда пришли кликом по строке ленты, картинка появлялась в руках — и + на том же курсоре, куда пришли кликом по строке ленты, картинка появлялась в руках - и не там, куда её перетащили, а в точке вставки. Первый Ctrl+Z убирал картинку с холста, второй не менял ничего, а возвращал её только двойной Ctrl+Y. - **Прижатие, не изменившее ни пикселя, всё равно оставляло запись.** Пустой габарит - отсеивался с 1.17.0, а пустая правка в непустом габарите — нет. Картинку вставляли на + отсеивался с 1.17.0, а пустая правка в непустом габарите - нет. Картинку вставляли на холст и уносили за его край: рисовать нечего, но габарит правки накрывал место, где она лежала вначале, и в ленту уходил диф, у которого «до» и «после» побайтно одинаковы. В панели появлялась вторая строка «Вставка», не делающая ровно ничего. @@ -1258,24 +1258,24 @@ Electron-версии правила, добытые в C#-выпусках 1.12 так, чтобы значение по умолчанию давало прежние 24 пикселя. - **Текст ложился в слой, спрятанный после клика.** Проверка на клике от этого не спасает: между ней и ответом в окне ввода проходит сколько угодно времени, а панель слоёв всё это - время под рукой. Текст уходил в битмап невидимого слоя — на экране не появлялось ничего, + время под рукой. Текст уходил в битмап невидимого слоя - на экране не появлялось ничего, зато в ленте появлялась запись, документ считался изменённым, а надпись всплывала, стоило слой включить. Ровно та же история была со штрихами до 1.15.0, и решается она тем - же — отказом и строкой в статусбаре. + же - отказом и строкой в статусбаре. - **«Создать» наследовал размер холста прежней работы.** Открыл фотографию 4000×3000, - нажал Ctrl+N — и получил чистый лист 4000×3000, вернуть который к обычному можно было + нажал Ctrl+N - и получил чистый лист 4000×3000, вернуть который к обычному можно было только через диалог смены размера; кадрирование до марки оставляло, наоборот, лоскут в - полсотни пикселей. Новый документ — это чистый лист, а не старый со стёртым рисунком; + полсотни пикселей. Новый документ - это чистый лист, а не старый со стёртым рисунком; ровно поэтому же «Создать» сбрасывает стопку слоёв, имя бумаги, её видимость и прозрачность. Отмена возвращает и работу, и её размер. - **Отмена удаления слоя уводила кисть на другой слой.** Активным становился восстановленный: пользователь удалил верхний слой, вернул его отменой и продолжал - рисовать — но уже не там, где рисовал минуту назад. Номер активного слоя удаление + рисовать - но уже не там, где рисовал минуту назад. Номер активного слоя удаление записывало, а отмена его не читала вовсе. - **Заливка спотыкалась о разницу в один уровень яркости.** Совпадение цвета требовалось точное, и по фотографии заливался ровно один пиксель: небо на снимке состоит из почти одинаковых, но не равных цветов, и клик по нему не делал ничего заметного. Допуск теперь - тот же, что в Electron-версии, — два уровня на канал. Вместе с ним появилась карта + тот же, что в Electron-версии, - два уровня на канал. Вместе с ним появилась карта пройденных пикселей: без неё залитый пиксель может остаться в пределах допуска от исходного, соседи кладут его в стек снова и снова, и программа зависает. В Electron-версии эта карта стоит ровно по той же причине. @@ -1283,62 +1283,62 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ### Скрытое - **У фаззинга ленты появился четвёртый инвариант, и самый сильный: позиция курсора - однозначно задаёт документ.** Каким бы путём до строки ленты ни дошли — сверху отменами, - снизу повторами, — на ней обязан быть один и тот же документ, вплоть до того, держит ли + однозначно задаёт документ.** Каким бы путём до строки ленты ни дошли - сверху отменами, + снизу повторами, - на ней обязан быть один и тот же документ, вплоть до того, держит ли пользователь что-то в руках. Именно он нашёл затирание одного плавающего объекта другим: ни сценарным тестом, ни тремя прежними инвариантами это не ловилось, потому что холст в - обоих случаях выходил одинаковый. Видов правок в фаззере стало девятнадцать — + обоих случаях выходил одинаковый. Видов правок в фаззере стало девятнадцать - добавились ластик, текст, перетаскивание угла маски у поднятого объекта и вставка, от которой отказались. - **Тяжёлый прогон перед релизом: 1200 сценариев по 40 шагов с двумя десятками случайных прыжков по ленте в каждом.** До правок он давал расхождения на каждом сотом сценарии, - после — ни одного. -- **`PixelLayer.Reset`** — новый битмап заданного размера вместо прежнего, с сохранением + после - ни одного. +- **`PixelLayer.Reset`** - новый битмап заданного размера вместо прежнего, с сохранением самого объекта слоя. Заменять слой целиком в «Создать» нельзя: тот, кто взял слой в руки до операции, получил бы освобождённую нативную память и падение процесса на первом же обращении. -## 1.17.0 — маска на повороте, удалённый слой под руками и вставка за краем +## 1.17.0 - маска на повороте, удалённый слой под руками и вставка за краем Разбор после четырнадцатого прохода. Правки только в C#-версии; Electron-версия остаётся -на 1.11.0. Находки собрались вокруг трёх вещей. Первая — две системы координат, которые +на 1.11.0. Находки собрались вокруг трёх вещей. Первая - две системы координат, которые выглядят одинаково: маска поднятого многоугольника хранится неповёрнутой, а сравнивается с величиной, взятой уже с поворотом; пока объект не повёрнут, ошибка равна нулю и живёт -годами. Вторая — запасной вариант, подставленный не туда: когда слой-источник удалён, +годами. Вторая - запасной вариант, подставленный не туда: когда слой-источник удалён, рисовать в активный можно, а вот снимок ПРЕЖНЕГО состояния к нему не относится ничем. -Третья — у слоя, кроме пикселей, есть имя, видимость и прозрачность, и «Создать» с +Третья - у слоя, кроме пикселей, есть имя, видимость и прозрачность, и «Создать» с «Открыть» стирали только пиксели. Одиннадцать правок. Тесты: 333 (+58). ### Портит работу - **Маска повёрнутого многоугольника съезжала с пикселей на первом же движении ручки.** - Углы маски и габарит объекта хранятся неповёрнутыми — поворот накладывает уже рисование: + Углы маски и габарит объекта хранятся неповёрнутыми - поворот накладывает уже рисование: канва крутится, и только потом режется по маске. Значит какие пиксели останутся под маской, решает её положение ОТНОСИТЕЛЬНО габарита, и пересчёт при масштабировании обязан сохранять именно доли. Пересчёт же шёл вокруг мирового, то есть уже повёрнутого, положения противоположной ручки: две системы координат смешивались, и стоило потянуть - любую ручку у повёрнутого объекта, как маска уезжала с того, что вырезала, — из-под неё + любую ручку у повёрнутого объекта, как маска уезжала с того, что вырезала, - из-под неё выползал кусок соседнего рисунка. Без поворота ошибка обнулялась целиком, поэтому ловилась она только на повёрнутом объекте и только глазами. - **Удаление слоя, с которого подняли пиксели, портило соседний слой.** Пикап помнит слой по идентификатору и держит снимок этого слоя на момент подъёма. Когда слой удаляют, пока объект в руках, поиск по идентификатору возвращает пустоту, и вместо него подставлялся - активный слой — всюду, включая места, где речь идёт о ПРЕЖНЕМ состоянии. Escape стирал + активный слой - всюду, включая места, где речь идёт о ПРЕЖНЕМ состоянии. Escape стирал по чужому слою рисунок целиком и клал на его место содержимое того, чего в документе уже нет; Delete записывал в историю дыру не там, где надо; первый же Ctrl+Z после прижатия делал то же самое; а первое перемещение вырезало в чужом слое дыру по координатам, к нему не относящимся. Разделены теперь две вещи: куда рисовать (запасной вариант нужен, - иначе теряются сами пиксели) и чей снимок описывает «до» — только слой-источник. + иначе теряются сами пиксели) и чей снимок описывает «до» - только слой-источник. - **Вставка, унесённая за край холста, оставляла в ленте запись без картинки.** Прижимать за холстом нечего: ни один пиксель не меняется, и записи о прижатии не - появляется. Запись «Вставка» при этом оставалась в ленте применённой — и получалось + появляется. Запись «Вставка» при этом оставалась в ленте применённой - и получалось ровно то, от чего написано правило 1.14.0: на холсте картинки нет, а история утверждает, что вставка сделана. Клик по строке ленты создавал картинку заново, из - ниоткуда, — документ после прогулки по истории отличался от того, из которого вышли. + ниоткуда, - документ после прогулки по истории отличался от того, из которого вышли. Вставка не трогает ни одного пикселя, поэтому пустое прижатие вычёркивает её из ленты - целиком — тем же способом, каким от неё отказываются Escape и Delete. + целиком - тем же способом, каким от неё отказываются Escape и Delete. - **Отмена «Создать» после вставки не возвращала картинку.** Поворот, отражение, - кадрирование и смена размера прижимают поднятый объект ДО себя — «Создать» этого не + кадрирование и смена размера прижимают поднятый объект ДО себя - «Создать» этого не делало, а сама команда объект только снимает. Вставленная картинка, которую пользователь ещё держал в руках, исчезала бесследно: отмена возвращала слои, но не её, а запись «Вставка» оставалась в ленте применённой. Теперь «Создать» прижимает объект первым делом, @@ -1346,23 +1346,23 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Открытый файл мог оказаться невидимым.** Открытие заменяет содержимое всех слоёв, но свойства слоёв переживали его нетронутыми. «Открыть» в документ, где нижний слой спрятан или выкручен в прозрачность, давало пустой белый холст: картинка легла в слой, которого - не видно, — и в файл при следующем Ctrl+S уходил тот же белый лист. Свойства слоёв + не видно, - и в файл при следующем Ctrl+S уходил тот же белый лист. Свойства слоёв выправляются теперь вместе с пикселями, а отмена возвращает и то и другое. Поворота и отражения это не касается: они про пиксели. - **Ctrl+C по объекту за краем холста молча затирал буфер обмена.** Копировать в этом - случае нечего, но копирование отдавало прозрачный пиксель 1×1 — он честно уходил в буфер + случае нечего, но копирование отдавало прозрачный пиксель 1×1 - он честно уходил в буфер вместо того, что там лежало, и Ctrl+C заканчивался «успешно» и без единого слова. Ctrl+X по этому «успеху» ещё и выбрасывал сам объект: вырезание идёт вслед за удавшимся - копированием. Теперь оба отвечают отказом и говорят почему — «занят» и «копировать + копированием. Теперь оба отвечают отказом и говорят почему - «занят» и «копировать нечего» стали разными ответами. ### Мешало обычной работе - **«Создать» не сбрасывало имя, видимость и прозрачность бумаги.** От стопки остаётся - один слой — это правило с 1.16.0, — но чистились у него только пиксели. Новый документ + один слой - это правило с 1.16.0, - но чистились у него только пиксели. Новый документ приезжал с настройками прошлой работы: бумага звалась как раньше, а то и была спрятана или выкручена в прозрачность. Пользователь рисовал по чистому листу и не видел ни - штриха, а в файл уходил белый прямоугольник. Отмена возвращает всё это назад — слои она + штриха, а в файл уходил белый прямоугольник. Отмена возвращает всё это назад - слои она собирает из снимка целиком. - **Масштабированный объект прижимался лесенкой.** Растянутый или повёрнутый объект пересэмплируется, и делать это надо с фильтрацией. Без неё Skia берёт ближайший пиксель: @@ -1371,16 +1371,16 @@ Electron-версии правила, добытые в C#-выпусках 1.12 же самое уходило и в файл. При размере один к одному и без поворота фильтрации по-прежнему нет и быть не должно: пиксельный рисунок обязан переезжать без размытия. - **Слой с прозрачностью в ноль молча съедал штрихи.** Это тот же скрытый слой, только - другой дорогой: ползунок в панели слоёв начинается с нуля, довести его туда — одно + другой дорогой: ползунок в панели слоёв начинается с нуля, довести его туда - одно движение. Дальше повторялась ровно та история, которую закрыли для скрытого слоя в - 1.15.0: на экране не появлялось ничего, в файл — тоже (сборка умножает на прозрачность), + 1.15.0: на экране не появлялось ничего, в файл - тоже (сборка умножает на прозрачность), а запись в истории появлялась, и приложение начинало спрашивать про сохранение после ничего. Теперь отвечает статусбар, той же строкой и по тому же правилу. - **Штрих, фигура и текст ложились на слой, активный на отпускании.** Жест начинается на одном слое, а исполняется командой на отпускании, и команда спрашивала «какой слой активен сейчас». Между этими двумя мгновениями слой успевает смениться: у окна ввода текста между кликом и OK проходит сколько угодно времени. Ластику это стоило не только - слоя, но и режима — на нижнем слое он красит белым, на верхних вычитает пиксели, — и + слоя, но и режима - на нижнем слое он красит белым, на верхних вычитает пиксели, - и превью всю дорогу показывало дыру, а на слой ложилась белая полоса. Инструменты снимают слой на нажатии и передают его записи. - **Статусбар держал последний цвет, когда курсор ушёл с холста.** Координаты гасли @@ -1393,60 +1393,60 @@ Electron-версии правила, добытые в C#-выпусках 1.12 удаление области, свойства слоя и масштабирование поднятого объекта ручкой. Инвариантов стало три: к «отмена всего даёт чистый лист» и «прогулка в начало и обратно приводит документ туда же» добавилось «свойства слоёв возвращаются так же точно, как пиксели». - Осиротевшую запись вставки нашёл именно он — сценарным тестом она не сочинялась: нужен + Осиротевшую запись вставки нашёл именно он - сценарным тестом она не сочинялась: нужен паст, который после кадрирования оказался за пределами нового холста. -- **`MainViewModel.ResetDocument`** — «Создать» без вопроса про несохранённую работу. +- **`MainViewModel.ResetDocument`** - «Создать» без вопроса про несохранённую работу. Вынесен из-под модального окна, чтобы весь путь «вставка → создать → отмена» проверялся тестом целиком, а не по кускам. Тем же приёмом раньше вынесен разбор размера холста. -## 1.16.0 — полоска без площади, запись без картинки и бумага под ногами +## 1.16.0 - полоска без площади, запись без картинки и бумага под ногами Разбор после тринадцатого прохода. Правки только в C#-версии; Electron-версия остаётся -на 1.11.0. Находки собрались вокруг трёх вещей. Первая — чужой тип отвечает не на тот +на 1.11.0. Находки собрались вокруг трёх вещей. Первая - чужой тип отвечает не на тот вопрос, который ему задают: `SKRectI.IsEmpty` говорит «пустой» только про прямоугольник из четырёх нулей, а полоска нулевой ширины для него вполне себе непустая, и на ней -приложение падало. Вторая — запись в истории описывает пиксели, но не описывает +приложение падало. Вторая - запись в истории описывает пиксели, но не описывает состояние: прижатие рисовало картинку и забывало убрать объект, который её держал. -Третья — правило, записанное в десятке мест сразу («нижний слой — это бумага»), можно +Третья - правило, записанное в десятке мест сразу («нижний слой - это бумага»), можно нарушить одной кнопкой. Десять правок. Тесты: 275 (+54). ### Портит работу - **Подъём выделения, приткнутого к самому краю холста, роняло приложение.** - `SKRectI.IsEmpty` в SkiaSharp отвечает true только на прямоугольник из четырёх нулей — + `SKRectI.IsEmpty` в SkiaSharp отвечает true только на прямоугольник из четырёх нулей - полоска (10, 5, 10, 25), у которой ширина ноль, для него непустая. А получаются такие полоски на каждом пересечении с холстом, когда фигура стоит вплотную к его краю: рамка, растянутая от верхней строки вверх, даёт на холсте полосу нулевой высоты. Дальше из неё строился `SKBitmap` нулевого размера, `SKImage.FromBitmap` возвращал на нём null, и - пользователь получал окно «Что-то пошло не так» — вместо выделения. Проверок на эту + пользователь получал окно «Что-то пошло не так» - вместо выделения. Проверок на эту самую пустоту в коде было двенадцать, и все двенадцать пропускали такую полоску: теперь все они спрашивают про площадь (`GeometryMath.HasArea`), а не про четыре нуля. - **Escape по вставке, между которой и отказом успела лечь другая правка, оставлял запись без картинки.** Снять пикап вставки вправе только сама запись «Вставка» (правило с 1.14.0), а отменить её можно, только пока она последняя. Между вставкой и - отказом от неё легко ложится что-то ещё — тот же ползунок прозрачности слоя, — и + отказом от неё легко ложится что-то ещё - тот же ползунок прозрачности слоя, - и прежняя версия в этом случае просто отступалась: пикап снимался напрямую. Дальше выходило ровно то, от чего это правило и написано: картинки на холсте нет, запись «Вставка» стоит применённой, документ считается изменённым, а Ctrl+Y картинку не - возвращает — курсору некуда двигаться. Вставка не трогает ни одного пикселя, поэтому + возвращает - курсору некуда двигаться. Вставка не трогает ни одного пикселя, поэтому теперь такая запись вычёркивается из ленты целиком (`HistoryManager.Forget`): записям после неё её исчезновение ничем не грозит. То же самое для Delete и Ctrl+X. - **Клик по строке в панели истории оставлял поверх прижатой картинки её же копию.** - Повтор ленты — это не только Ctrl+Y: любой прыжок по истории проигрывает записи - заново. Вставка при своём повторе кладёт картинку в руки, а следующая запись — прижатие - этой же картинки — только рисовала пиксели и объект из рук не забирала. На экране всё + Повтор ленты - это не только Ctrl+Y: любой прыжок по истории проигрывает записи + заново. Вставка при своём повторе кладёт картинку в руки, а следующая запись - прижатие + этой же картинки - только рисовала пиксели и объект из рук не забирала. На экране всё выглядело правильно, потому что объект стоит ровно поверх своих же пикселей; расходились - они, стоило его потянуть — из-под него выезжала вторая, уже прижатая. Запись прижатия - снимает объект теперь сама, вместе с пикселями: состояние документа — это не только + они, стоило его потянуть - из-под него выезжала вторая, уже прижатая. Запись прижатия + снимает объект теперь сама, вместе с пикселями: состояние документа - это не только холст. Заодно прижатие вообще перестало трогать пиксели во время прогулки по ленте: запись истории в этот момент не принимается (`IsApplying`), и нарисованное осталось бы на холсте вовсе без записи о себе. -- **Удаление нижнего слоя ломало ластик и смену размера холста.** Бумага документа — это +- **Удаление нижнего слоя ломало ластик и смену размера холста.** Бумага документа - это слой номер ноль, и на этом держится с полдюжины правил: ластик красит по нему белым, а не вычитает пиксели; подъём прямоугольного выделения выкусывает из него фон; смена размера холста заливает белым новую площадь; «Очистить» возвращает его к белому, а слои над ним к прозрачному. Пока бумагу можно было удалить крестиком в панели, бумагой молча - становился следующий слой — со всеми этими правилами разом. Прозрачный слой с рисунком + становился следующий слой - со всеми этими правилами разом. Прозрачный слой с рисунком после первой же смены размера холста оказывался залит белым по всей площади, а ластик переставал стирать и начинал красить. Пользователь при этом ничего такого не заказывал: он удалил слой, который ему не нужен. Бумага теперь не удаляется, и об этом говорит @@ -1455,8 +1455,8 @@ Electron-версии правила, добытые в C#-выпусках 1.12 через общую сборку документа, обрезанную по его габариту: объект, уведённый на цветное место, попадал в буфер обмена вместе с этим цветом прямоугольной заплаткой, и вставка возвращала на холст не фигуру, а плитку фона с фигурой внутри. Габарит при этом ещё и - шире самого объекта — у повёрнутого сильно, — так что фона в копии было больше, чем - содержимого. Объект копируется теперь сам, на прозрачном; выделение — по-прежнему + шире самого объекта - у повёрнутого сильно, - так что фона в копии было больше, чем + содержимого. Объект копируется теперь сам, на прозрачном; выделение - по-прежнему сборкой всех слоёв, там копируется как раз то, что видно. В Electron-версии Ctrl+C по floating рисует в чистый холст один только объект. @@ -1467,46 +1467,46 @@ Electron-версии правила, добытые в C#-выпусках 1.12 стороны независимо всегда. Вернуть картинке исходное соотношение после такого можно было только отменой. Shift у угловой ручки держит теперь пропорции; боковые ручки меняют одну сторону по определению, их это не касается. -- **Поворот ручкой не вставал на ровный угол.** Shift при повороте округляет угол до 15° — +- **Поворот ручкой не вставал на ровный угол.** Shift при повороте округляет угол до 15° - опять же как в Electron-версии. Без него попасть ручкой ровно на 90° или 45° можно было только случайно: хоткеи «[» и «]» дают ровный шаг, но они крутят от текущего положения, а не приводят к нему, так что после любого поворота мышью ровного угла уже не получить. -- **«Создать» оставляло старую стопку слоёв.** Очищались все слои — это правило с 1.6.0, — +- **«Создать» оставляло старую стопку слоёв.** Очищались все слои - это правило с 1.6.0, - но сами слои оставались: панель после «Создать» показывала прежние «Layer 1», «Layer 2» и прочее, чего в новом документе взяться неоткуда, а следующий «Добавить слой» получал - имя «Layer 3». Новый документ — это чистый лист, а не старый со стёртым рисунком: от + имя «Layer 3». Новый документ - это чистый лист, а не старый со стёртым рисунком: от стопки остаётся теперь бумага. Отмена возвращает стопку целиком, с прежними идентификаторами слоёв: по ним находят свою цель записи, сделанные до очистки. - **Добавление и удаление слоя стояли в панели истории по-английски.** Перевода для них - там просто не было, а запасной вариант отдаёт имя команды как есть — «Add layer» среди + там просто не было, а запасной вариант отдаёт имя команды как есть - «Add layer» среди «Штрих», «Заливка» и «Перемещение». - **Нулевая прозрачность молчала.** Штрих, фигура и текст с прозрачностью в ноль не - меняют ни одного пикселя и в историю не идут — это правило с 1.15.0, — но пользователю + меняют ни одного пикселя и в историю не идут - это правило с 1.15.0, - но пользователю об этом не говорилось ни слова: он водил мышью по холсту, на холсте не появлялось ничего, и отличить это от сломанной программы было нельзя. Ровно та же беда была со - скрытым слоем, и решается она тем же — строкой в статусбаре. Ластика это не касается: + скрытым слоем, и решается она тем же - строкой в статусбаре. Ластика это не касается: он прозрачность не учитывает вовсе, как и в Electron-версии. ### Скрытое -- **Тесты на случайных последовательностях правок.** Две находки из десяти — фантомная - копия после клика по строке истории и падение на габарите без площади — руками +- **Тесты на случайных последовательностях правок.** Две находки из десяти - фантомная + копия после клика по строке истории и падение на габарите без площади - руками написанным сценарием не воспроизводились: обе требуют определённого порядка нескольких операций. `TimelineFuzzTests` проигрывает по seed'у десяток случайных правок (штрих, заливка, подъём прямоугольника и многоугольника, вставка, добавление и удаление слоя, фигура, отражение) и проверяет три инварианта: отмена всего возвращает документ к чистому листу, прогулка «в начало и обратно» приводит его туда же, куда привели сами - правки, и отмена с последующим повтором — тоже. Смысл не в конкретной + правки, и отмена с последующим повтором - тоже. Смысл не в конкретной последовательности, а в том, что порядок выбран не автором теста. -## 1.15.0 — размер фигуры, две руки для одного объекта и правки, которых не было +## 1.15.0 - размер фигуры, две руки для одного объекта и правки, которых не было Разбор после двенадцатого прохода. Правки только в C#-версии; Electron-версия остаётся -на 1.11.0. Находки собрались вокруг трёх вещей. Первая — величина, заданная в одних +на 1.11.0. Находки собрались вокруг трёх вещей. Первая - величина, заданная в одних единицах, применяется к фигуре, о размере которой ничего не знает: зона хвата угла в десять экранных пикселей на выделении в двадцать пикселей документа съедает его целиком. -Вторая — поднятый объект принадлежит документу, а не тому инструменту, которым его сейчас -двигают. Третья — правка, не изменившая ни одного пикселя, не должна попадать в историю: +Вторая - поднятый объект принадлежит документу, а не тому инструменту, которым его сейчас +двигают. Третья - правка, не изменившая ни одного пикселя, не должна попадать в историю: заливка это правило знает с 1.7.0, а штрих, фигура и текст не знали. Десять правок. Тесты: 221 (+29). @@ -1517,8 +1517,8 @@ Electron-версии правила, добытые в C#-выпусках 1.12 знала. У квадрата со стороной меньше 20 пикселей документа четыре круга радиусом 10 смыкаются в середине и накрывают его целиком: проверка углов идёт первой, и клик в самый центр выделения читался как хват угла. Поднять такое выделение было нельзя вовсе, - а уже поднятое не двигалось — вместо объекта уезжал ближайший угол, искажая маску. - Нижняя граница у выделения — 4 пикселя, то есть непригодным было всё от 4 до 20. + а уже поднятое не двигалось - вместо объекта уезжал ближайший угол, искажая маску. + Нижняя граница у выделения - 4 пикселя, то есть непригодным было всё от 4 до 20. Хват теперь не больше половины меньшей стороны габарита: на такой зоне углы забирают не больше половины каждой своей стороны, а середина фигуры остаётся телу. На крупных фигурах не меняется ничего. @@ -1527,14 +1527,14 @@ Electron-версии правила, добытые в C#-выпусках 1.12 меняют. Между тем это две руки для одного и того же объекта: «Выделение» его двигает и масштабирует, «Четырёхугольник» вдобавок тянет углы маски. Нажатие Q по перетащенному выделению прибивало его к холсту раньше, чем пользователь успевал взяться за угол, и - путь «выдели прямоугольником — искриви углы» был закрыт целиком. Решает это теперь + путь «выдели прямоугольником - искриви углы» был закрыт целиком. Решает это теперь вьюмодель, которой известны обе стороны замены; в Electron-версии то же исключение записано прямо в обработчике кнопок инструментов. - **Отмена стирания многоугольника оставляла кайму по краю.** Снимок для отмены брался ровно по габариту, округлённому к ближайшему целому, а контур многоугольника идёт по дробным координатам и сглаживается: сглаживание задевает пиксели за этой границей. Delete по многоугольнику, нарисованному в стороне от целых координат, оставлял после - Ctrl+Z бледную кайму — пиксели, которые стёрли, но не записали. Снимок теперь шире на + Ctrl+Z бледную кайму - пиксели, которые стёрли, но не записали. Снимок теперь шире на пиксель со всех сторон; ту же поправку на сглаживание делает для области подъёма сам документ (`Document.SourceRect`). - **Текст с переносами строки ложился одной строкой.** `DrawText` рисует ОДИН ряд глифов @@ -1551,10 +1551,10 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ### Мешало обычной работе - **«Снять выделение» по поднятому объекту не делало ничего.** Подъём забирает выделение - себе — это инвариант документа, — и проверка на одну только рамку отправляла Ctrl+D в + себе - это инвариант документа, - и проверка на одну только рамку отправляла Ctrl+D в никуда. Пользователь просил закончить с выделенным, а объект оставался висеть над холстом с рамкой и ручками, и убрать его можно было только другим действием. Теперь - объект ложится на холст: именно прижать, а не отменить — Escape уже есть и возвращает + объект ложится на холст: именно прижать, а не отменить - Escape уже есть и возвращает пиксели на место, а «снять выделение» это «я закончил», как и клик мимо рамки. - **Штрих и фигура с нулевой прозрачностью писались в историю.** Ползунок прозрачности начинается с нуля, так что дотянуть до этого можно одним движением. Source-over с @@ -1563,18 +1563,18 @@ Electron-версии правила, добытые в C#-выпусках 1.12 на холсте не осталось ничего. Заливка это правило знает с 1.7.0 (`FillCommand.ChangedAnything`), теперь его знают и штрих с фигурой. - **Текст из одних пробелов писался в историю.** То же самое и по той же причине: пустая - строка отсеивалась, строка из пробелов — нет, а чернил из неё не выходит. + строка отсеивалась, строка из пробелов - нет, а чернил из неё не выходит. - **Смена размера холста на тот же самый считалась правкой.** Диалог открывается с текущим - размером в поле, и нажать OK, ничего не поменяв, — самый обычный способ передумать. + размером в поле, и нажать OK, ничего не поменяв, - самый обычный способ передумать. Команда при этом пересобирала все слои, писала в историю «Изменение размера», объявляла документ изменённым и заодно снимала выделение и поднятый объект (1.13.0). Тот же самый размер теперь не правка. - **Русская «х» в размере холста молча ничего не делала.** Подсказка в диалоге написана по-русски, и раскладка у пользователя в этот момент тоже русская: «1200х800», набранное не переключаясь, разбиралось на одну часть, диалог закрывался, и холст оставался - прежним — без единого слова о том, что не так. Русская «х» принимается теперь наравне с + прежним - без единого слова о том, что не так. Русская «х» принимается теперь наравне с латинской «x», заодно «×» и «*»; а любая опечатка перестала быть неотличимой от - «Отмена» — про непонятый размер приложение говорит. + «Отмена» - про непонятый размер приложение говорит. - **Имя нового слоя повторялось.** Номер брался из числа слоёв, а оно уменьшается при удалении: «добавили два, удалили первый, добавили ещё» давало второй «Layer 2». В панели две одинаковые строки, отличить их можно только положением, и выключить видимость @@ -1585,42 +1585,42 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Координата пикселя округлялась в сторону нуля.** Приведение `float` к `int` отбрасывает дробную часть в сторону нуля, и всё от −0.99 до 0 схлопывалось в ноль: точка чуть левее или выше холста становилась его левым верхним пикселем, и заливка с пипеткой считали - клик мимо кликом по углу. Через мышь в это сейчас не попасть — события приходят только - внутри холста, — но правило неверное, и обе теперь округляют вниз. Заодно: подписки + клик мимо кликом по углу. Через мышь в это сейчас не попасть - события приходят только + внутри холста, - но правило неверное, и обе теперь округляют вниз. Заодно: подписки главного окна ставятся один раз (`Loaded` приходит при каждом возвращении окна в дерево - визуалов, и второй подписчик на запрос текста — это два окна ввода подряд на один клик). + визуалов, и второй подписчик на запрос текста - это два окна ввода подряд на один клик). -## 1.14.0 — поднятое выделение: чем тащат, откуда подняли и куда кладут +## 1.14.0 - поднятое выделение: чем тащат, откуда подняли и куда кладут Разбор после одиннадцатого прохода. Правки только в C#-версии; Electron-версия остаётся -на 1.11.0. Всё найденное — про поднятое выделение, и каждая находка проверяет его со +на 1.11.0. Всё найденное - про поднятое выделение, и каждая находка проверяет его со своей стороны: каким инструментом его тащат, с какого слоя его подняли и на какой слой -оно ляжет. Общее у них одно — правило записано в одном месте, а работает не везде. Четыре +оно ляжет. Общее у них одно - правило записано в одном месте, а работает не везде. Четыре правки. Тесты: 192 (+6). ### Портит работу - **Многоугольник, поднятый под «Выделением», срезался собственной маской на ходу.** Перетаскивание было написано дважды: «Четырёхугольник» двигал габарит вместе с - quad-маской, «Выделение» — один габарит. Разными инструментами один и тот же объект + quad-маской, «Выделение» - один габарит. Разными инструментами один и тот же объект таскать можно: хоткей поворота («[» и «]») поднимает многоугольник, не трогая активный инструмент, и объект оказывается в руках у «Выделения». Маска при этом оставалась на прежнем месте, а рисуется объект только внутри неё: он таял по мере движения и исчезал - совсем, стоило отвести его на свою ширину. Сдвиг теперь один на оба инструмента — + совсем, стоило отвести его на свою ширину. Сдвиг теперь один на оба инструмента - `PickupOps.Translate`, там же, где живут подъём, ленивое стирание и попадание мыши. - **Подъём многоугольника выкусывал бумагу изнутри выделенного.** Белый фон вокруг - рисунка выкусывается заливкой от рамки габарита внутрь (1.5.0) — но у многоугольника + рисунка выкусывается заливкой от рамки габарита внутрь (1.5.0) - но у многоугольника углы габарита лежат ВНЕ его самого, и белое снаружи фигуры соединено с белым внутри неё. Заливка проходила насквозь: пользователь двигал кусок бумаги с рисунком, а получал - рисунок на прозрачном — сквозь него просвечивало то, что лежит ниже, при том что на + рисунок на прозрачном - сквозь него просвечивало то, что лежит ниже, при том что на прежнем месте оставалась ровно та же белая бумага. Форму многоугольнику задаёт он сам, - маской, и кеинг ему не нужен вовсе — так это и сделано в Electron-версии + маской, и кеинг ему не нужен вовсе - так это и сделано в Electron-версии (`eraseBbox === false`). - **Подъём с верхнего слоя терял белые пиксели.** Там же и по той же причине: на верхнем - слое фона нет, там пусто, а белое — нарисовано. Выкусывался целый слой сразу, если до + слое фона нет, там пусто, а белое - нарисовано. Выкусывался целый слой сразу, если до края выделения доходило белое: небо на вставленной фотографии, залитая белым фигура. - Стирание при этом знало правило и раньше — `PickupOps.EraseColor` возвращает бумагу - белой только для нижнего слоя, — а подъём его не знал. Теперь кеинг идёт там же, где и + Стирание при этом знало правило и раньше - `PickupOps.EraseColor` возвращает бумагу + белой только для нижнего слоя, - а подъём его не знал. Теперь кеинг идёт там же, где и бумага: у нижнего слоя и только у прямоугольного выделения. ### Мешало обычной работе @@ -1628,18 +1628,18 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Вставка на скрытый слой была видна ровно до прижатия.** Проверка на видимость стоит у кистей, фигур, заливки, текста (1.10.0), подъёма выделения (1.11.0) и стирания (1.12.0), а у вставки не стояла. Плавающий объект рисуется поверх документа независимо от - видимости своего слоя — иначе спряталось бы то, что пользователь держит в руках, — и + видимости своего слоя - иначе спряталось бы то, что пользователь держит в руках, - и вставленная картинка была на экране, пока её двигали. Прижатие уводило её в битмап скрытого слоя: с экрана она пропадала, в истории оставалась запись, документ считался изменённым. Вставка идёт теперь через тот же `ToolContext.DrawTarget()`, и причину отказа объясняет статусбар. -## 1.13.0 — одна сборка на всех и экранные пиксели против холстовых +## 1.13.0 - одна сборка на всех и экранные пиксели против холстовых Разбор после десятого прохода. Правки только в C#-версии; Electron-версия остаётся на -1.11.0. Найденное собралось вокруг двух вещей. Первая — та же, что и в 1.12.0: сборка +1.11.0. Найденное собралось вокруг двух вещей. Первая - та же, что и в 1.12.0: сборка документа обязана быть одна. В 1.12.0 к ней свели экран и файл, но мимо остались выборка -цвета точки и превью ластика, и каждая показывала своё. Вторая — единицы измерения: часть +цвета точки и превью ластика, и каждая показывала своё. Вторая - единицы измерения: часть интерфейса нарисована в экранных пикселях, а меряется в пикселях холста, и совпадает это только при масштабе 1:1. Пять правок. Тесты: 186 (+15). @@ -1647,36 +1647,36 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Пипетка и статусбар отвечали цветом того, что лежит ПОД поднятым объектом.** Выборка цвета точки складывала слои сама и плавающий объект в счёт не брала: на экране синяя - вставленная картинка, в подсказке под курсором — белый холст под ней, и по клику + вставленная картинка, в подсказке под курсором - белый холст под ней, и по клику пипеткой в палитру уходил тот же белый. Теперь объект входит в выборку наравне со - слоями и на своём месте в стопке — том же, куда его кладёт отрисовка, — с учётом + слоями и на своём месте в стопке - том же, куда его кладёт отрисовка, - с учётом поворота, quad-маски, растяжения и прозрачности слоя. В Electron-версии пипетка сэмплит композит вместе с floating с самого начала. - **Кадрирование теряло поднятый объект молча.** Поворот, отражение и смена размера - прижимают его перед собой, а кадрирование — нет: команда заменяет содержимое всех + прижимают его перед собой, а кадрирование - нет: команда заменяет содержимое всех слоёв разом, и объект, который пользователь держал в руках, просто исчезал, не оставив - записи в истории. Теперь кадрирование прижимает его, как и его соседи, до операции — + записи в истории. Теперь кадрирование прижимает его, как и его соседи, до операции - пока холст ещё прежний. - **Поднятый объект переживал замену всех слоёв.** Рамку выделения при повороте, - кадрировании и смене размера снимали (1.4.0), а объект — нет. Он оставался висеть над + кадрировании и смене размера снимали (1.4.0), а объект - нет. Он оставался висеть над холстом, которого уже нет: ссылка на слой-источник указывала на выброшенный битмап, а - координаты — на прежний размер. Снимается теперь там же и по той же причине, что и - рамка, — то есть и при откате по истории. + координаты - на прежний размер. Снимается теперь там же и по той же причине, что и + рамка, - то есть и при откате по истории. ### Мешало обычной работе - **Ластик на верхнем слое вёл белую полосу, а оставлял дыру.** Превью рисовалось поверх слоя обычным source-over, а на слой ластик ложится вычитанием: во время штриха пользователь видел белую краску, а на отпускании она превращалась в прозрачность с - нижним слоем внутри — картинка менялась в момент, когда рука уже отведена. Тот же + нижним слоем внутри - картинка менялась в момент, когда рука уже отведена. Тот же разрыв между превью и результатом, что чинили в 1.12.0 для порядка слоёв. Теперь инструмент отдаёт вместе с превью и режим, которым оно ляжет, а отрисовка замыкает - вычитание на своём слое через отдельный слой Skia — иначе ластик на верхнем слое + вычитание на своём слое через отдельный слой Skia - иначе ластик на верхнем слое пробивал бы дыру до самой бумаги. - **Зона хвата и ручка поворота ехали вместе с масштабом.** Угловая точка четырёхугольника рисуется девятью экранными пикселями, а хват искался в десяти пикселях холста: на уменьшенной картинке (масштаб 0.25) в него нельзя было попасть - вовсе — два экранных пикселя, — а на увеличенной (масштаб 4 и больше) он накрывал + вовсе - два экранных пикселя, - а на увеличенной (масштаб 4 и больше) он накрывал сорок экранных и перехватывал перетаскивание самого объекта. Ручка поворота стояла на отступе, заданном так же: на восьмикратном увеличении улетала на четверть экрана вверх, на уменьшении ложилась на объект. И то и другое считается теперь в экранных @@ -1686,22 +1686,22 @@ Electron-версии правила, добытые в C#-выпусках 1.12 смена размера: слой мог оказаться меньше остальных, и рисовать по нему за его краем было нельзя. Строится теперь под текущий холст. -## 1.12.0 — поворот, слои и то, что считается правкой +## 1.12.0 - поворот, слои и то, что считается правкой Разбор после девятого прохода. Правки только в C#-версии; Electron-версия остаётся на 1.11.0. Половина найденного собралась вокруг поворота плавающего объекта: его учитывала одна отрисовка, а весь ввод сравнивал мышь с фигурой, которой на экране нет. Вторая -половина — про то, где что лежит и что попадает в историю. Десять правок. Тесты: 171. +половина - про то, где что лежит и что попадает в историю. Десять правок. Тесты: 171. ### Портит работу - **Delete, Ctrl+X и Escape по только что вставленной картинке оставляли запись - «Вставка».** Пикап вставки создаёт команда, которая уже лежит в истории, — в 1.11.0 + «Вставка».** Пикап вставки создаёт команда, которая уже лежит в истории, - в 1.11.0 это учли для первого Ctrl+Z, но не для трёх остальных способов снять пикап. Картинка с холста пропадала, а запись оставалась текущей: история утверждала, что вставка - применена, документ считался изменённым, а Ctrl+Y картинку не возвращал — курсору + применена, документ считался изменённым, а Ctrl+Y картинку не возвращал - курсору некуда двигаться. Теперь такой пикап во всех четырёх случаях снимает отмена самой - команды. Признак принадлежности — ссылка на запись (`FloatingPickup.Owner`), а не + команды. Признак принадлежности - ссылка на запись (`FloatingPickup.Owner`), а не флажок: между вставкой и удалением успевает лечь другая правка, и отменять «текущую» вместо вставки нельзя. - **Delete и Ctrl+X по скрытому слою стирали невидимое.** Проверка на видимость стоит у @@ -1714,7 +1714,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 стало ясно, что стирать есть где. - **Заливка с прозрачностью выбрасывала подложку вместо того, чтобы подмешать себя к ней.** Пиксель просто переписывался полупрозрачным цветом: красная область, залитая - чёрным на 50%, выходила серой вместо тёмно-красной, а на нижнем слое — с дырой в самой + чёрным на 50%, выходила серой вместо тёмно-красной, а на нижнем слое - с дырой в самой бумаге, потому что заливка оставляла после себя неполную непрозрачность. Теперь идёт обычный source-over, ровно как у полупрозрачного мазка кисти. В Electron-версии смешивание в `floodFill` было с самого начала. Заливка непрозрачным цветом не @@ -1728,8 +1728,8 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Повёрнутый объект нельзя было взять там, где он нарисован.** Попадание мыши проверялось по неповёрнутому габариту: у прямоугольника, повёрнутого на 45°, углы вылезают за габарит, а сам габарит по углам пуст. Клик по видимому краю объекта - прижимал его к холсту и начинал новое выделение — то есть попытка подвинуть картинку - её роняла, — зато клик по пустому месту рядом её таскал. Теперь мышь приводится к + прижимал его к холсту и начинал новое выделение - то есть попытка подвинуть картинку + её роняла, - зато клик по пустому месту рядом её таскал. Теперь мышь приводится к системе координат пикапа, как в `hitFloating` Electron-версии. - **Многоугольник тянулся за описанный вокруг прямоугольник.** Форма проверялась только у выделения; поднятый quad хватался за габарит, включая углы, где ничего не @@ -1737,7 +1737,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 пикап (`GeometryMath.PointInPolygon`). - **Углы повёрнутого quad'а стояли не там, где сама фигура.** Точки углов рисовались по неповёрнутым координатам, и хват искал их там же: у повёрнутой фигуры точки висели в - стороне от её углов, а перетаскивание писало в угол мировую координату — фигура + стороне от её углов, а перетаскивание писало в угол мировую координату - фигура прыгала в сторону на весь угол поворота. - **Смена инструмента посреди выделения прятала ручки насовсем.** Инструмент меняют и горячей клавишей, в том числе с нажатой кнопкой мыши: `SelectTool` и `QuadTool` @@ -1753,12 +1753,12 @@ Electron-версии правила, добытые в C#-выпусках 1.12 нижнему слою во время перетаскивания лежал над верхними, а на отпускании нырял под них: картинка прыгала в момент, когда пользователь уже отвёл руку. То же с поднятым выделением. Сборка документа теперь одна на экран и на файл (`Document.Render`), и - превью с пикапом ложатся на свой слой и с его прозрачностью — туда же, где окажутся + превью с пикапом ложатся на свой слой и с его прозрачностью - туда же, где окажутся после фиксации. -## 1.11.0 — поднятое выделение: что вырезается, что стирается, что пишется в историю +## 1.11.0 - поднятое выделение: что вырезается, что стирается, что пишется в историю -Разбор после восьмого прохода. Почти всё найденное собралось вокруг одного места — +Разбор после восьмого прохода. Почти всё найденное собралось вокруг одного места - плавающего объекта: подъём холста не трогает, стирание идёт лениво, и код в пяти местах решал по разным признакам, случилось ли что-нибудь. Плюс два дефекта, которые в Electron-версии закрыты давно, а сюда не доехали. Девять правок. @@ -1767,32 +1767,32 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ### Портит работу - **Delete и Ctrl+X по только что поднятому выделению ничего не вырезали.** Клик - внутрь рамки поднимает пиксели, но исходную область не стирает — стирание идёт при + внутрь рамки поднимает пиксели, но исходную область не стирает - стирание идёт при первом перемещении. `DiscardFloating` про это не знал: он выкидывал пикап и, раз «стирать нечего», оставлял слой нетронутым. Пиксели возвращались на место, и - пользователь получал «вырезал, а ничего не вырезалось» — а Ctrl+X при этом уже + пользователь получал «вырезал, а ничего не вырезалось» - а Ctrl+X при этом уже положил копию в буфер обмена. Теперь `DiscardFloating` и `CommitFloating` сами доводят ленивое стирание до конца. - **Перетаскивание угла quad'а вырезало из слоя не ту форму.** Стираемая форма снималась при первом перемещении (`EnsureLazyErase`), а угол можно увести раньше: - из слоя выкусывалась новая форма — то есть область, которую пользователь не - выделял, — а часть выделенной оставалась лежать на месте. Теперь форма запоминается + из слоя выкусывалась новая форма - то есть область, которую пользователь не + выделял, - а часть выделенной оставалась лежать на месте. Теперь форма запоминается при подъёме (`PickupOps.Promote`), и маска пикапа на неё больше не влияет. - **Изменённый углами quad при фиксации оставлял оригинал на холсте.** Если тело пикапа не двигали, стирание не проходило вовсе: прижатый пикап ложился поверх - собственного исходника, лишние пиксели оставались, и в историю не попадало ничего — + собственного исходника, лишние пиксели оставались, и в историю не попадало ничего - отменить это было нечем. В Electron-версии ровно за этим следит `ensureOriginalQuadErased`. - **Нажатие на ручку без перетаскивания меняло документ.** Стирание исходной области - шло по нажатию, а не по первому движению: щёлкнули по ручке, отпустили — и документ + шло по нажатию, а не по первому движению: щёлкнули по ручке, отпустили - и документ считается изменённым, а фиксация пишет пустую запись «Перемещение». Признак «что-то делали» вообще заменён сравнением геометрии с той, что была при подъёме - (`FloatingPickup.HasMoved`), — так же, как `floatingMoved` в Electron-версии. - Флаг забыть легко, а забытый флаг — это молча потерянная запись в истории. + (`FloatingPickup.HasMoved`), - так же, как `floatingMoved` в Electron-версии. + Флаг забыть легко, а забытый флаг - это молча потерянная запись в истории. - **Ctrl+Z после вставки убирал картинку, но не запись о ней.** Пикап вставки создаёт команда, которая уже лежит в истории, а первый Ctrl+Z по правилу «сначала снимаем подъём» снимал его отдельно, не двигая курсор. История говорила, что вставка - применена, холст был пуст, а Ctrl+Y картинку не возвращал — курсору некуда было + применена, холст был пуст, а Ctrl+Y картинку не возвращал - курсору некуда было двигаться. Такой пикап теперь помечен (`OwnedByCommand`), и снимает его отмена самой команды. @@ -1805,7 +1805,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 идёт через тот же `ToolContext.DrawTarget()`, и причина отказа видна в статусбаре. - **Перемещение выделения пробивало дыры в самой картинке.** Белый фон вокруг рисунка делается прозрачным, чтобы выделение не таскало за собой белый - прямоугольник, — но проход шёл по всем белым пикселям подряд. Блик на фотографии, + прямоугольник, - но проход шёл по всем белым пикселям подряд. Блик на фотографии, белая заливка фигуры, глаз на рисунке становились прозрачными вместе с фоном, и сквозь них было видно то, что лежит ниже. Теперь прозрачность заливается от краёв пикапа внутрь и останавливается на первом непохожем пикселе. В Electron-версии @@ -1823,13 +1823,13 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Ctrl+C мог упасть на пустом результате кодировщика.** `SKImage.Encode` возвращает null, а не бросает исключение, и следующая строка читала этот null. Падение уходило - в глобальный обработчик и пугало окном «Что-то пошло не так» — при том, что + в глобальный обработчик и пугало окном «Что-то пошло не так» - при том, что копирование просто не удалось. - **Комментарий в Electron-версии обещал недоехавшую правку**, которая доехала в 1.10.0: строка про метку сохранения в срезаемом хвосте стояла прямо над кодом, который её и делает. -## 1.10.0 — склейка правок, буфер обмена и скрытый слой +## 1.10.0 - склейка правок, буфер обмена и скрытый слой Разбор после седьмого прохода. Две правки того же класса, что чинили в 1.9.0: изменение, которое доходит до файла, но не доходит до вопроса при закрытии. Плюс @@ -1899,7 +1899,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 на чистом документе кнопка и хоткей были выключены, и отказаться от подъёма можно было только через Escape. -## 1.9.0 — метка сохранения, открытие файла и свойства слоя +## 1.9.0 - метка сохранения, открытие файла и свойства слоя Разбор того, что пережило шесть предыдущих проходов: позиция в истории как признак сохранённого, замена документа при открытии файла и состояние, которое живёт мимо @@ -1980,7 +1980,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 на большом холсте, выглядел сломанным, и окно закрывалось вместе с работой. Теперь renderer первым делом отвечает `close-ack`, и страховка снимается сразу. -## 1.8.0 — метка сохранения, открытие файла и захват мыши +## 1.8.0 - метка сохранения, открытие файла и захват мыши Проход по тому, что предыдущие шесть релизов не трогали: переполнение истории, подмена документа при открытии файла, перетаскивание ручек и обработка ошибок в @@ -1992,11 +1992,11 @@ main-процессе Electron. Шесть правок и три мелочи. работу.** `HistoryManager.Drop` выбрасывает старые записи и сдвигает курсор вниз вместе с ними, а метка «здесь сохранено» жила отдельным полем во вьюмодели и оставалась на прежнем числе. Как только упирались в `MaxDepth` (1000 штрихов) или - в `MaxBytes` (768 МБ — это два-три поворота большой картинки), курсор при каждом + в `MaxBytes` (768 МБ - это два-три поворота большой картинки), курсор при каждом новом `Push` возвращался к тому же значению, `IsDirty` навсегда становился false, и окно закрывалось без вопроса, унося всё нарисованное после переполнения. Метка переехала внутрь `HistoryManager` (`MarkSaved` / `IsDirtySinceSave`) и - теперь сдвигается в том же `Drop`, что и курсор — забыть её больше негде. + теперь сдвигается в том же `Drop`, что и курсор - забыть её больше негде. В Electron это было починено ещё в 1.5.0 (`state.savedHistoryIndex--` внутри цикла вытеснения), сюда правка не доехала. - **WPF: «Открыть» оставлял старый рисунок с верхних слоёв поверх открытой @@ -2004,7 +2004,7 @@ main-процессе Electron. Шесть правок и три мелочи. активный слой», но `ResizeCanvasCommand` переносит содержимое ВСЕХ слоёв. На документе с двумя слоями поверх открытой фотографии продолжали лежать прежние штрихи, и следующий Ctrl+S записывал её вместе с ними: `Flatten` складывает все - слои. Появился `DocumentTransform.OpenImage` — одна `ReplaceAllLayersCommand`, + слои. Появился `DocumentTransform.OpenImage` - одна `ReplaceAllLayersCommand`, которая ставит картинку на нижний слой, очищает верхние и меняет размер холста за один шаг истории. @@ -2015,12 +2015,12 @@ main-процессе Electron. Шесть правок и три мелочи. элемента, убранного из дерева. Ручка, за которую тянули, исчезала на первом же кадре. У угловых ручек новая вставала ровно под курсором и жест продолжался по случайности; у боковых (E, W, N, S) ручка едет только по одной оси, и движение - поперёк на 6 пикселей выводило курсор за неё — дальше события шли на холст и + поперёк на 6 пикселей выводило курсор за неё - дальше события шли на холст и доставались активному инструменту. Захват теперь берёт сам `Overlay`: он на месте всегда, чистятся только его дети. - **Electron: пустая заливка писала запись в историю.** Ровно то, что чинилось в WPF в 1.7.0. `floodFill` выходит сразу, если под курсором уже этот цвет, а - `onDown` звал `saveHistory` безусловно. Мусор в панели истории — полбеды; + `onDown` звал `saveHistory` безусловно. Мусор в панели истории - полбеды; `isDirty()` считается по позиции в ней, и приложение спрашивало про сохранение после действия, ничего не сделавшего. Теперь `floodFill` возвращает, изменился ли хоть один пиксель, и заодно отказывается от клика за краем холста: `Math.floor` @@ -2028,7 +2028,7 @@ main-процессе Electron. Шесть правок и три мелочи. - **Electron: «Открыть…» на нечитаемом файле не делало вообще ничего.** Обработчик `open-file-dialog` читал файл без `try/catch`, `invoke` отклонялся, а оба вызывающих места ждали результат без `catch`. Файл удалили после показа диалога, - нет прав, отвалился сетевой диск — окно закрывалось, и на этом всё. Ошибка + нет прав, отвалился сетевой диск - окно закрывалось, и на этом всё. Ошибка возвращается полем `error`, как это давно делает соседний `read-dropped-file`, и показывается пользователем. Заодно `lastSavedPath` теперь ставится только после удачного чтения: иначе Ctrl+S целился в файл, который так и не открылся. @@ -2036,7 +2036,7 @@ main-процессе Electron. Шесть правок и три мелочи. - **WPF: вставка при активном «Четырёхугольнике» прижималась к холсту сразу.** `Paste` выполнял команду, а потом переключал инструмент на «Выделение». Смена инструмента зовёт `OnDeactivate` у прежнего, а `QuadTool` делает там - `CommitFloating` — только что вставленная картинка укладывалась в точке (20, 20) + `CommitFloating` - только что вставленная картинка укладывалась в точке (20, 20) раньше, чем её успевали увидеть. Инструмент переключается до вставки. ### Мелочи @@ -2053,7 +2053,7 @@ main-процессе Electron. Шесть правок и три мелочи. - **Шаги зума разошлись между версиями.** В Electron не хватало 0.67, и одна и та же кнопка «уменьшить» с 75% уводила в разных версиях в разные места. -## 1.7.0 — сплошной проход по обеим версиям +## 1.7.0 - сплошной проход по обеим версиям Прочитано всё, что раньше не читалось: команды и разметка WPF, HTML и CSS Electron-страницы, скрипт установщика. Три правки. Тесты: 89. @@ -2061,7 +2061,7 @@ Electron-страницы, скрипт установщика. Три прав ### Портит файлы - **Electron: размер холста без верхней границы уничтожал рисунок молча.** Лишний - ноль в поле ширины — и `setCanvasSize(99999, 99999)`. Буфер такого размера + ноль в поле ширины - и `setCanvasSize(99999, 99999)`. Буфер такого размера браузер не выделяет, но и не сообщает об этом: `canvas.width` честно возвращает 99999, а любой пиксель читается как прозрачный. Рисунок пропадает, отменить нечего, следующее сохранение пишет пустоту. Единственная проверка была @@ -2074,7 +2074,7 @@ Electron-страницы, скрипт установщика. Три прав - **WPF: пустая заливка писала запись в историю.** Клик по области, уже залитой этим цветом, и клик мимо холста не меняют ни пикселя, но `FillTool` звал - `ExecuteAndPush` безусловно. Мусор в списке истории — полбеды; `IsDirty` + `ExecuteAndPush` безусловно. Мусор в списке истории - полбеды; `IsDirty` считается по позиции курсора, и приложение спрашивало про сохранение после действия, ничего не сделавшего. Ровно то же самое чинилось в Electron в 1.6.0 для подъёма выделения. Теперь `FillCommand.ChangedAnything` говорит, изменились @@ -2083,13 +2083,13 @@ Electron-страницы, скрипт установщика. Три прав ### Мелочи - **Версия в интерфейсе отстала на шесть релизов в четырёх местах.** «Paint Pro - 1.0» было вписано строкой в статусбар и в «О программе» — и в WPF, и в + 1.0» было вписано строкой в статусбар и в «О программе» - и в WPF, и в Electron. В WPF версия теперь читается из атрибутов сборки, то есть из `` в csproj; в Electron приходит из `package.json` через `app.getVersion()`. Источник в каждой версии остался ровно один, и отстать больше нечему. Есть тест, сравнивающий подпись с версией сборки. -## 1.6.0 — слои, выделение и отмена подъёма +## 1.6.0 - слои, выделение и отмена подъёма Второй проход подряд, по тем местам, куда 1.5.0 не заглянула: команды документа в WPF и оверлеи поверх холста в Electron. Шесть правок. Тесты: 83. @@ -2100,7 +2100,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав резолвил слой через `LayerTarget`, то есть брал активный, а остальные не трогал. На документе с двумя слоями «чистый» холст показывал старый рисунок с верхнего слоя, и следующий Ctrl+S записывал его в файл: `FileService.Flatten` складывает - все слои. Теперь чистятся все — нижний в цвет фона, верхние в прозрачность, по + все слои. Теперь чистятся все - нижний в цвет фона, верхние в прозрачность, по тому же правилу, что у `ResizeCanvasCommand`. Снимок для отмены тоже стал послойным. @@ -2110,7 +2110,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав месте.** Рамка «муравьёв» висела там, где холста уже нет, а клик внутрь поднимал не те пиксели: `PromoteRect` берёт то, что лежит по этим координатам сейчас. В Electron-версии это чинилось в 1.4.0. Выделение снимается внутри самих команд - (`ResizeCanvasCommand`, `ReplaceAllLayersCommand`), а не в вызывающем коде — + (`ResizeCanvasCommand`, `ReplaceAllLayersCommand`), а не в вызывающем коде - тогда это работает и при откате по истории, а не только при прямом действии. - **Electron: Escape применял плавающий объект вместо отмены.** Способа отказаться от подъёма не было вовсе, хотя `cancelFloating` ровно для этого и написан, а @@ -2118,26 +2118,26 @@ WPF и оверлеи поверх холста в Electron. Шесть прав пиксели на место (инвариант 11 в README). - **Electron: клик в выделение без сдвига считался изменением.** Подъём стирает bbox сразу, поэтому `commitFloating` всегда писал в историю запись - «Перемещение» — даже когда пользователь просто кликнул внутрь рамки и тут же + «Перемещение» - даже когда пользователь просто кликнул внутрь рамки и тут же мимо. С появившимся в 1.5.0 вопросом при закрытии это стало заметно: приложение спрашивало про сохранение после действия, ничего не изменившего. Теперь `commitFloating` сравнивает геометрию пикапа с той, что была при подъёме, и если - ничего не двигали — возвращает `preCanvas`, то есть холст остаётся прежним до + ничего не двигали - возвращает `preCanvas`, то есть холст остаётся прежним до пикселя. Сравнение геометрии, а не флаг в пяти обработчиках drag'а: забытый флаг означал бы молча потерянную запись в истории. - **Electron: кнопки обрезки не ехали за выделением.** Позиция считалась один раз, при показе, и при первом же зуме или панораме «Применить / Отмена» отрывались от рамки. Обработчик `resize` окна заодно не знал про редактор текста. Список - оверлеев был скопирован в четыре места и в двух отставал — сведён в + оверлеев был скопирован в четыре места и в двух отставал - сведён в `updateOverlays()`. - **Electron: пустой редактор текста считался несохранённой работой.** Клик инструментом «Текст» открывает рамку, и сам по себе он ничего не меняет. `isDirty` смотрит на набранный текст, а не на видимость рамки. -## 1.5.0 — прозрачность, сохранение и закрытие +## 1.5.0 - прозрачность, сохранение и закрытие Проход после того, как 1.4.0 сводила версии. Девять правок, две из них про потерю -работы пользователя. Главная — прозрачность, которая протекала из инструмента в +работы пользователя. Главная - прозрачность, которая протекала из инструмента в контекст холста и портила всё, что рисовалось после. Тесты: 76. ### Портит файлы @@ -2145,7 +2145,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав - **Electron: Ctrl+S сразу после «Открыть» писал белый лист поверх фотографии.** Открытая картинка приходит плавающим объектом, то есть живёт на `previewCanvas` над холстом; `canvas.toDataURL()` её не видит. `saveCanvas` оказалась - единственной функцией в файле, которая про floating забыла — остальные восемь + единственной функцией в файле, которая про floating забыла - остальные восемь мест его фиксируют. А `pick-save-path` без `saveAs` возвращает путь открытого файла не спрашивая, так что запись уходила прямо в оригинал. То же самое было со вставкой из буфера и с открытым текстовым редактором. Теперь `saveCanvas` @@ -2155,7 +2155,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав - **Electron: закрытие окна молча теряло несохранённый рисунок.** В WPF вопрос появился ещё в 1.2.0, сюда правка не доехала. Признак изменений может знать только renderer, поэтому main по `close` не отпускает окно, а спрашивает его; - дальше диалог на три кнопки — «Сохранить», «Не сохранять», «Отмена», — и окно + дальше диалог на три кнопки - «Сохранить», «Не сохранять», «Отмена», - и окно закрывается лишь по `confirm-close`. Отмена сохранения тоже оставляет окно открытым. На случай, если renderer не ответит вовсе, стоит пятисекундная страховка, иначе приложение стало бы невыключаемым. @@ -2164,19 +2164,19 @@ WPF и оверлеи поверх холста в Electron. Шесть прав - **Electron: прозрачность оставалась на контексте и портила всё после себя.** `applyBrushStyle` писал `state.opacity` прямо в `ctx.globalAlpha` и не возвращал - обратно, а `globalAlpha` — состояние контекста, а не операции. Значение висело + обратно, а `globalAlpha` - состояние контекста, а не операции. Значение висело дальше, и в него попадали все прямые записи на холст: `restoreHistory`, `fillWhite`, поворот, отражение, обе смены размера, открытие файла. Один Ctrl+Z после мазка с прозрачностью 40% делал весь лист прозрачным на 60%, а «Очистить - холст» давал серый вместо белого — и четыре нажатия подряд белого не давали. + холст» давал серый вместо белого - и четыре нажатия подряд белого не давали. Починено не сбросом на каждом вызывающем месте, а так же, как это устроено в WPF: инструмент рисует непрозрачно в буфер, альфа накладывается один раз при переносе буфера на холст (`beginPreviewStroke` / `mergePreviewStroke`). Карандаш, кисть и фигуры переведены на ту же схему, по которой маркер работал и раньше. Инвариант теперь простой: `ctx.globalAlpha` всегда 1 вне пар `save`/`restore`. - Побочная выгода — мазок при прозрачности меньше 100% перестал темнеть в стыках - сегментов, а фигура в режиме «контур + заливка» — на границе. + Побочная выгода - мазок при прозрачности меньше 100% перестал темнеть в стыках + сегментов, а фигура в режиме «контур + заливка» - на границе. - **WPF: масштаб повёрнутого полигона уводил маску с пикселей.** `FloatingPickup.ApplyResize` масштабировал углы quad вокруг **неповёрнутой** точки якоря и по осям мира, тогда как сама рамка считается вокруг мировой @@ -2186,14 +2186,14 @@ WPF и оверлеи поверх холста в Electron. Шесть прав Добавлен `RotatedQuadResizeTests`: на старом коде девять его проверок из десяти падают, проходит только случай без поворота. - **Electron: текстовый редактор не масштабировался вместе с холстом.** Позицию - рамки умножали на зум, а размер шрифта — нет: на масштабе 200% буквы в рамке + рамки умножали на зум, а размер шрифта - нет: на масштабе 200% буквы в рамке были вдвое мельче тех, что лягут на холст. Смена зума при открытом редакторе вообще оставляла рамку на старом месте. Теперь элемент масштабируется целиком одним `transform: scale`, поэтому и `padding`, по которому `commitText` считает смещение текста, остаётся в координатах холста. - **Electron: дробное выделение мылило картинку, а протяжка за край уезжала за холст.** Подъём во floating округлял размер снимка, а укладка обратно рисовала - его в дробный прямоугольник — картинка пересэмплировалась дважды за одно + его в дробный прямоугольник - картинка пересэмплировалась дважды за одно перетаскивание. Координаты в `mousemove` при этом ничем не ограничивались, и протяжка мимо холста давала выделение с отрицательным `x`. Добавлена `normalizeSelection()`: на отпускании мыши рамка приводится к целым пикселям и @@ -2211,16 +2211,16 @@ WPF и оверлеи поверх холста в Electron. Шесть прав ### Внутреннее - **У истории в Electron появился потолок по памяти.** Одной глубины мало: снимок - холста 4000×3000 — это единицы мегабайт в base64, и полтораста таких кадров + холста 4000×3000 - это единицы мегабайт в base64, и полтораста таких кадров кладут вкладку задолго до того, как счётчик дойдёт до `MAX_HISTORY`. Добавлен `MAX_HISTORY_BYTES` (512 МБ), самый свежий кадр не выбрасывается никогда. В WPF такой потолок был с самого начала (`HistoryManager.MaxBytes`). - При вытеснении старых записей метка последнего сохранения едет вместе с индексами, иначе после переполнения истории сохранённый файл считался бы изменённым. -- Список фигур был скопирован инлайном в трёх ветках — сведён в `SHAPE_TOOLS`. +- Список фигур был скопирован инлайном в трёх ветках - сведён в `SHAPE_TOOLS`. -## 1.4.0 — проход по обеим версиям +## 1.4.0 - проход по обеим версиям Ищем то, что переехало между версиями лишь наполовину: три из девяти правок ниже уже делались в одной версии и не были перенесены во вторую. Тесты: 66. @@ -2228,13 +2228,13 @@ WPF и оверлеи поверх холста в Electron. Шесть прав ### Портит файлы - **WPF: «Файл → Создать» не отвязывал документ от файла.** Открываешь `photo.jpg`, - делаешь новый холст, жмёшь Ctrl+S — и `photo.jpg` становится белым листом без + делаешь новый холст, жмёшь Ctrl+S - и `photo.jpg` становится белым листом без единого вопроса: `SaveOrSaveAs` берёт `LastSavedPath ?? LastOpenedPath` и пишет туда молча. Добавлен `FileService.Detach()`, `NewDocument` его зовёт. В Electron-версии это чинилось в 1.3.0 (IPC `clear-save-path`), сюда правка не доехала. - **WPF: открытие файла не меняло цель Ctrl+S.** Сохранил в `a.png`, открыл - `b.png`, нажал Ctrl+S — записалось в `a.png`, потому что `LastSavedPath` + `b.png`, нажал Ctrl+S - записалось в `a.png`, потому что `LastSavedPath` оставался прежним и шёл первым в цепочке. Теперь удачное открытие сбрасывает `LastSavedPath`, и целью становится открытый файл. - **Electron: открытие картинки шире холста стирало рисунок без возможности @@ -2257,7 +2257,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав `CancelFloating`, который вернул бы пиксели на место. - **WPF: Ctrl+C по перетащенному объекту клал в буфер весь холст.** Тот же обнулённый `Selection`, только в `ClipboardService`: без выделения он копировал - холст целиком. Копируется габарит самого объекта — с учётом поворота (углы + холст целиком. Копируется габарит самого объекта - с учётом поворота (углы вылезают за bbox) и quad-клипа (он, наоборот, уже). Для этого добавлен `Document.PickupBounds`. - **Electron: поворот, отражение и смена размера холста оставляли выделение на @@ -2265,7 +2265,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав `selectionData` указывал на пиксели, которых там уже нет: клик внутрь поднимал во floating мусор. Все четыре операции теперь снимают выделение. - **Electron: горячие клавиши срабатывали при фокусе в списке шрифтов.** Проверка - была только на `INPUT`, а список шрифтов — `SELECT`: нажатие «e» для выбора + была только на `INPUT`, а список шрифтов - `SELECT`: нажатие «e» для выбора шрифта на эту букву переключало инструмент на ластик. Исключены `SELECT`, `TEXTAREA` и любой contenteditable. @@ -2274,7 +2274,7 @@ WPF и оверлеи поверх холста в Electron. Шесть прав - **WPF: в палитре бирюзовый вместо серого.** Запись `"#2EFFFFFF".Substring(0,7)` давала `#2EFFFF` при комментарии «mid-grey-ish». Заменено на `#6E7080`. -## 1.3.0 — проход по Electron-версии +## 1.3.0 - проход по Electron-версии Ревизия `paint-pro.html` после того, как 1.2.0 занималась только WPF. Двенадцать проверок сценариев прогнаны на живой странице. @@ -2289,9 +2289,9 @@ WPF и оверлеи поверх холста в Electron. Шесть прав его растянутым в старую рамку. Все шесть мест сведены в `setCanvasSize()`, который меняет буфер обоих канвасов и сам применяет зум. - **Ctrl+X и Delete по перемещённому выделению ничего не удаляли.** Обе ветки - звали `cancelFloating()`, а он восстанавливает `preCanvas` — то есть + звали `cancelFloating()`, а он восстанавливает `preCanvas` - то есть откатывает подъём пикселей. Объект прыгал на место, вырезания не происходило, - запись в историю не писалась. Добавлен `deleteFloating()` — противоположность + запись в историю не писалась. Добавлен `deleteFloating()` - противоположность `cancelFloating`: снимает объект, оставляя стёртое стёртым, и сообщает, изменился ли холст (у только что вставленной картинки под ней ничего не стиралось, и писать в историю нечего). @@ -2300,18 +2300,18 @@ WPF и оверлеи поверх холста в Electron. Шесть прав перезаписывал ранее открытый файл: `pick-save-path` без `saveAs` возвращает `global.lastSavedPath` не спрашивая. Добавлен IPC `clear-save-path`. - **Курсор-кружок врал про толщину у карандаша и маркера.** Курсор рисовался - диаметром `state.size`, а перо — `size * 0.5` у карандаша и `size * 1.5` у + диаметром `state.size`, а перо - `size * 0.5` у карандаша и `size * 1.5` у маркера. Толщина считается одной функцией `strokeWidthFor()`, общей для пера и курсора. - **Перемещение выделения пробивало дыры в фотографиях.** Прозрачным делался весь белый подряд, включая блик на фото и белую заливку внутри фигуры. Теперь заливка идёт от краёв пикапа внутрь и останавливается на первом - небелом пикселе, так что фон вокруг рисунка снимается, а белое внутри — нет. + небелом пикселе, так что фон вокруг рисунка снимается, а белое внутри - нет. - **Ctrl+C по повёрнутому объекту клал в буфер неповёрнутый прямоугольник.** Копирование рисовало голым `drawImage` мимо поворота и quad-клипа. Копия берётся общим рендером и по фактическому габариту (`floatingBounds`), иначе у повёрнутого прямоугольника срезались углы, вылезающие за bbox. -- **Пипетка брала цвет из неповёрнутого объекта** — тот же пропущенный поворот +- **Пипетка брала цвет из неповёрнутого объекта** - тот же пропущенный поворот в композите. - **Обрезка на дробном выделении теряла пиксельный столбец.** `getImageData` дробные аргументы округляет, а `canvas.width` их отбрасывает: на ширине 100.7 @@ -2329,17 +2329,17 @@ WPF и оверлеи поверх холста в Electron. Шесть прав в `drawFloatingOnto()`. Именно дублирование и было причиной того, что про поворот забывали то в пипетке, то в копировании. - «Выделить всё» было трижды скопировано (пункт меню, Ctrl+A, действие из - main-процесса) — теперь одна функция `selectAll()`. + main-процесса) - теперь одна функция `selectAll()`. - Удалена мёртвая ветка `movingSelection`: флаг нигде не выставлялся в `true`, а сопутствующий `originalBeforeMove` на каждый Ctrl+A зря копировал полный `ImageData` холста. - Стек заливки и кеинга белого стал плоским (`x, y, x, y, ...`) вместо массива - пар: на заливке во весь экран пар набегают миллионы, и каждая — отдельный + пар: на заливке во весь экран пар набегают миллионы, и каждая - отдельный объект для сборщика мусора. WPF-версия в этом проходе не менялась и остаётся на 1.2.0. -## 1.2.0 — второй проход +## 1.2.0 - второй проход Ревизия после 1.1.0, включая одну регрессию от неё самой. Тесты: 62. @@ -2351,9 +2351,9 @@ WPF-версия в этом проходе не менялась и остаё - **Заливка подвешивала интерфейс.** `SKBitmap.GetPixel`/`SetPixel` ходят через managed/native границу на каждый пиксель. Замер на холсте 900×600: 700 мс только на первом проходе, плюс второй проход на восстановление снимка. Переписано на - scanline-обход сырого BGRA-буфера: 900×600 — 25 мс, 4000×3000 — 172 мс. + scanline-обход сырого BGRA-буфера: 900×600 - 25 мс, 4000×3000 - 172 мс. - **Ластик на верхних слоях красил белым**, пробивая непрозрачную дыру сквозь всё - под ним. Теперь на нижнем слое по-прежнему белый (он и есть бумага), выше — + под ним. Теперь на нижнем слое по-прежнему белый (он и есть бумага), выше - стирание в прозрачность через `DstOut` при слиянии. - **Ctrl+C и Ctrl+X брали только активный слой.** Копируется то, что видно. - **Пипетка и цвет в статусбаре читали активный слой** и возвращали пустоту там, @@ -2382,7 +2382,7 @@ WPF-версия в этом проходе не менялась и остаё Electron-версия в этом проходе не менялась и остаётся на 1.1.0. -## 1.1.0 — багфикс-проход +## 1.1.0 - багфикс-проход Ревизия обеих версий по всему коду. Тесты: 51 (было 44). @@ -2423,14 +2423,14 @@ Electron-версия в этом проходе не менялась и ост - **Маркер темнел на перекрытиях.** Штрих рисуется непрозрачным в свой буфер, прозрачность применяется один раз при слиянии. То же для карандаша, кисти, фигур и текста. Превью на канвасе рисуется с той же альфой. -- **Инструмент Quad не поднимал пиксели** — четырёхугольник можно было нарисовать, +- **Инструмент Quad не поднимал пиксели** - четырёхугольник можно было нарисовать, но не переместить, а перетаскивание углов не было подключено вовсе. Добавлены подъём в пикап, перетаскивание углов и точки-маркеры на углах в оверлее. -- **Undo заливки на прозрачном слое не срабатывал** — снимок рисовался поверх без +- **Undo заливки на прозрачном слое не срабатывал** - снимок рисовался поверх без очистки. Заодно устранена утечка снимка при повторе заливки. - **Режим `Cropping` затирался** сразу после установки: `RecomputeMode` перебивал его на `SelectionRect`. Теперь режимы, которые задаёт инструмент, не трогаются. -- **Размер холста не был ограничен** — `100000x100000` уводил в OutOfMemory. +- **Размер холста не был ограничен** - `100000x100000` уводил в OutOfMemory. Лимит: 20000 по стороне и 120 млн пикселей всего, с понятным сообщением. - **Заливка фигур была недоступна** из интерфейса. Добавлен флажок в правой панели. - Ленивое стирание было продублировано в трёх местах, сведено в `PickupOps`. diff --git a/REWRITE_PROMPT_CSHARP.md b/REWRITE_PROMPT_CSHARP.md index 815ff04..e22a8de 100644 --- a/REWRITE_PROMPT_CSHARP.md +++ b/REWRITE_PROMPT_CSHARP.md @@ -1,9 +1,9 @@ # Задача -Напиши Windows-приложение «Paint Pro» — растровый графический редактор с GUI в +Напиши Windows-приложение «Paint Pro» - растровый графический редактор с GUI в стиле Apple Liquid Glass (iOS 26 / macOS Tahoe 26) на **C# 12 + WPF (.NET 8) + SkiaSharp**. Это перенос существующего Electron-приложения (HTML/JS, ~3500 строк в одном файле) -на нативный стек, с архитектурной переработкой — слои, MVVM, Command Pattern для +на нативный стек, с архитектурной переработкой - слои, MVVM, Command Pattern для undo, чистая state-machine. Цель: меньший размер (~15-30 МБ вместо 71 МБ), нативная производительность, @@ -13,19 +13,19 @@ undo, чистая state-machine. # Почему C# + WPF + SkiaSharp -- **SkiaSharp** — тот же graphics engine что в Chrome (Skia). API очень похож +- **SkiaSharp** - тот же graphics engine что в Chrome (Skia). API очень похож на HTML5 Canvas (MoveTo/LineTo/Stroke/Fill/clip/setTransform), миграция алгоритмов прямая. -- **WPF** — мощный native UI, поддержка blur/acrylic, hardware-accelerated. -- **C#** — strong typing помогает избежать ошибок типа «забыл сбросить state-флаг». -- **MVVM** — обязательная архитектура для WPF, разделение View/Logic. +- **WPF** - мощный native UI, поддержка blur/acrylic, hardware-accelerated. +- **C#** - strong typing помогает избежать ошибок типа «забыл сбросить state-флаг». +- **MVVM** - обязательная архитектура для WPF, разделение View/Logic. - **Self-contained publish** дает single .exe ~15-30 МБ против 71 МБ Electron. NuGet packages (минимум): -- `SkiaSharp` + `SkiaSharp.Views.WPF` — рендеринг через `SKElement` или `SKCanvasView`. -- `Wpf.Ui` — для AcrylicBrush, glass-эффектов. -- `CommunityToolkit.Mvvm` — `ObservableObject`, `[ObservableProperty]`, `[RelayCommand]` - атрибуты — драматически сокращают MVVM boilerplate. +- `SkiaSharp` + `SkiaSharp.Views.WPF` - рендеринг через `SKElement` или `SKCanvasView`. +- `Wpf.Ui` - для AcrylicBrush, glass-эффектов. +- `CommunityToolkit.Mvvm` - `ObservableObject`, `[ObservableProperty]`, `[RelayCommand]` + атрибуты - драматически сокращают MVVM boilerplate. --- @@ -37,41 +37,41 @@ PaintPro.Wpf/ ├── MainWindow.xaml + MainWindow.xaml.cs │ ├── Models/ -│ ├── Document.cs — document = stack of layers + selection + history -│ ├── Layer.cs — abstract layer; PixelLayer : Layer (raster pixels) -│ ├── Selection.cs — rectangle | polygon | none -│ ├── FloatingPickup.cs — temporary "pickup" layer (rotated, scaled, warped) -│ └── HistoryEntry.cs — command-based undo entry +│ ├── Document.cs - document = stack of layers + selection + history +│ ├── Layer.cs - abstract layer; PixelLayer : Layer (raster pixels) +│ ├── Selection.cs - rectangle | polygon | none +│ ├── FloatingPickup.cs - temporary "pickup" layer (rotated, scaled, warped) +│ └── HistoryEntry.cs - command-based undo entry │ ├── ViewModels/ -│ ├── MainViewModel.cs — root, owns Document, ActiveTool, etc. -│ ├── LayerListViewModel.cs — справа: список слоёв с visibility/opacity -│ ├── ColorPickerViewModel.cs — палитра + recent colors + custom color -│ └── ToolPanelViewModel.cs — левая панель: список инструментов +│ ├── MainViewModel.cs - root, owns Document, ActiveTool, etc. +│ ├── LayerListViewModel.cs - справа: список слоёв с visibility/opacity +│ ├── ColorPickerViewModel.cs - палитра + recent colors + custom color +│ └── ToolPanelViewModel.cs - левая панель: список инструментов │ ├── Views/ -│ ├── CanvasView.xaml — SKElement + overlay для selection-frame -│ ├── ToolPanel.xaml — левая стеклянная панель -│ ├── LayerPanel.xaml — правая стеклянная панель +│ ├── CanvasView.xaml - SKElement + overlay для selection-frame +│ ├── ToolPanel.xaml - левая стеклянная панель +│ ├── LayerPanel.xaml - правая стеклянная панель │ ├── ColorPalette.xaml │ └── StatusBar.xaml │ ├── Tools/ -│ ├── ITool.cs — OnPointerDown/Move/Up, OnActivate/Deactivate +│ ├── ITool.cs - OnPointerDown/Move/Up, OnActivate/Deactivate │ ├── PencilTool.cs │ ├── BrushTool.cs │ ├── MarkerTool.cs │ ├── EraserTool.cs -│ ├── FillTool.cs — flood fill -│ ├── PickerTool.cs — eyedropper +│ ├── FillTool.cs - flood fill +│ ├── PickerTool.cs - eyedropper │ ├── TextTool.cs -│ ├── ShapeTool.cs — общая база для Line/Rect/Ellipse/Triangle/... -│ ├── SelectTool.cs — rectangle selection -│ ├── QuadTool.cs — 4-point polygon selection +│ ├── ShapeTool.cs - общая база для Line/Rect/Ellipse/Triangle/... +│ ├── SelectTool.cs - rectangle selection +│ ├── QuadTool.cs - 4-point polygon selection │ └── CropTool.cs │ -├── Commands/ — Command Pattern для undo/redo -│ ├── ICommand.cs — { Execute(); Undo(); } +├── Commands/ - Command Pattern для undo/redo +│ ├── ICommand.cs - { Execute(); Undo(); } │ ├── DrawStrokeCommand.cs │ ├── FillCommand.cs │ ├── PasteCommand.cs @@ -81,24 +81,24 @@ PaintPro.Wpf/ │ └── ResizeCanvasCommand.cs │ ├── Services/ -│ ├── HistoryManager.cs — Undo()/Redo()/Push() стек -│ ├── ClipboardService.cs — read/write image clipboard -│ ├── FileService.cs — open/save PNG/JPEG/BMP/WEBP -│ └── GeometryMath.cs — anchor-based resize math, rotation, polygon clip +│ ├── HistoryManager.cs - Undo()/Redo()/Push() стек +│ ├── ClipboardService.cs - read/write image clipboard +│ ├── FileService.cs - open/save PNG/JPEG/BMP/WEBP +│ └── GeometryMath.cs - anchor-based resize math, rotation, polygon clip │ -├── Converters/ — XAML value converters +├── Converters/ - XAML value converters │ ├── Resources/ -│ ├── Themes.xaml — цветовые токены -│ ├── GlassStyles.xaml — .panel, .btn, .tool кнопки -│ └── Icons/ — SVG → XAML path data для инструментов +│ ├── Themes.xaml - цветовые токены +│ ├── GlassStyles.xaml - .panel, .btn, .tool кнопки +│ └── Icons/ - SVG → XAML path data для инструментов │ └── Tests/ └── PaintPro.Tests/ - ├── GeometryMathTests.cs — rotated resize math, anchor calculations - ├── HistoryManagerTests.cs — undo/redo invariants + ├── GeometryMathTests.cs - rotated resize math, anchor calculations + ├── HistoryManagerTests.cs - undo/redo invariants ├── FloodFillTests.cs - └── ClearCanvasTests.cs — все state-слои сбрасываются + └── ClearCanvasTests.cs - все state-слои сбрасываются ``` --- @@ -124,7 +124,7 @@ public partial class MainViewModel : ObservableObject } ``` -## 2. Document — это stack of layers +## 2. Document - это stack of layers Не один canvas + ad-hoc flags «floating», «selection». Document содержит: @@ -140,13 +140,13 @@ public class Document } ``` -`FloatingPickup` — это **отдельный лёгкий слой** который рендерится поверх Document +`FloatingPickup` - это **отдельный лёгкий слой** который рендерится поверх Document во время трансформации (move/scale/rotate). При commit его pixels сливаются в active layer. ## 3. Command Pattern для undo -НЕ snapshot всего canvas в PNG (как в Electron). Каждое действие — это команда: +НЕ snapshot всего canvas в PNG (как в Electron). Каждое действие - это команда: ```csharp public interface IDocumentCommand @@ -181,13 +181,13 @@ public interface ITool void OnPointerMove(SKPoint pos, ToolContext ctx); void OnPointerUp(SKPoint pos, ToolContext ctx); void OnActivate(ToolContext ctx); - void OnDeactivate(ToolContext ctx); // при смене tool — может закоммитить floating и т.п. + void OnDeactivate(ToolContext ctx); // при смене tool - может закоммитить floating и т.п. SKBitmap? PreviewBitmap { get; } // что показывать поверх canvas во время drag Cursor? GetCursor(SKPoint pos); } ``` -`ToolContext` — это «view» в Document/state, безопасный для инструмента. +`ToolContext` - это «view» в Document/state, безопасный для инструмента. Никаких global mutable variables. ## 5. State-машина для selection / floating @@ -206,7 +206,7 @@ public enum DocumentMode } ``` -Каждый переход — явный метод (`EnterFloating()`, `ExitFloating()`). +Каждый переход - явный метод (`EnterFloating()`, `ExitFloating()`). Никаких `state.draggingFloating + state.resizingFloating + state.warpingQuad`. --- @@ -236,44 +236,44 @@ public enum DocumentMode # Функциональные требования (всё что есть в текущем Paint Pro Electron) ## Инструменты рисования -- **Pencil** — тонкая линия, `lineWidth = size * 0.5`, `lineCap = round`. -- **Brush** — толстая мягкая линия, `lineWidth = size`, round caps/joins. -- **Marker** — полупрозрачный (`alpha = 0.4`), рисуется на отдельный bitmap при +- **Pencil** - тонкая линия, `lineWidth = size * 0.5`, `lineCap = round`. +- **Brush** - толстая мягкая линия, `lineWidth = size`, round caps/joins. +- **Marker** - полупрозрачный (`alpha = 0.4`), рисуется на отдельный bitmap при `alpha=1` (чтобы overlapping не накапливался), потом merge'ится через `SaveLayerAlpha`. -- **Eraser** — рисует белым (в Paint классически, не透ность). -- **Fill** — flood fill, классический BFS/scanline algorithm. -- **Picker** — eyedropper, читает `SKBitmap.GetPixel()`. -- **Text** — отдельный editable text box overlay (XAML TextBox), при commit +- **Eraser** - рисует белым (в Paint классически, не透ность). +- **Fill** - flood fill, классический BFS/scanline algorithm. +- **Picker** - eyedropper, читает `SKBitmap.GetPixel()`. +- **Text** - отдельный editable text box overlay (XAML TextBox), при commit растрируется на bitmap через `SKCanvas.DrawText`. ## Фигуры (все рисуются drag) -- **Line** — прямая -- **Rect** — прямоугольник (outline и/или fill) -- **Ellipse** — эллипс -- **Triangle** — треугольник -- **Star** — 5-конечная звезда -- **Arrow** — стрелка -- **Heart** — сердце +- **Line** - прямая +- **Rect** - прямоугольник (outline и/или fill) +- **Ellipse** - эллипс +- **Triangle** - треугольник +- **Star** - 5-конечная звезда +- **Arrow** - стрелка +- **Heart** - сердце ## Выделение -### Select (S) — прямоугольное -- Drag → bbox с **2px dashed border** (anti-marching-ants для стабильности — +### Select (S) - прямоугольное +- Drag → bbox с **2px dashed border** (anti-marching-ants для стабильности - не делай background-image-keyframe animation). - Внутри drag → move pixels (через `SKBitmap.Extract` + `Canvas.DrawBitmap`). - 8 resize-handles по углам/сторонам + 1 rotate-handle сверху. **СКРЫВАЙ handles во время drawing/move** (т.е. пока зажата кнопка мыши и - выделение растёт) — иначе при tiny drag mouse попадает на handle, события + выделение растёт) - иначе при tiny drag mouse попадает на handle, события не доходят до canvas. Через `IsHitTestVisible = false` или CSS-эквивалент. - Сlick на handle → promote во floating с anchor-based resize math. -### Quad (Q) — полигон 4 точками +### Quad (Q) - полигон 4 точками - Drag → bbox (как у Select), потом 4 угла превращаются в drag-targets. - Каждый угол можно тащить независимо → меняется ФОРМА clip-маски (НЕ warp/scale). - 4 угла = 4 крупные круглые точки (18×18). - Плюс 8 bbox-handles по периметру → uniform scale всего полигона. - Плюс 1 rotate-handle. -- Содержимое НЕ деформируется — pickup рисуется в исходных координатах, +- Содержимое НЕ деформируется - pickup рисуется в исходных координатах, quad работает как `SKCanvas.ClipPath`. ### Photoshop-like polygon-selection @@ -312,12 +312,12 @@ public enum DocumentMode - Кнопки `+`/`-`, `1:1`. `Ctrl+wheel` = zoom. - Сохраняй центр под курсором при zoom (не упрощённое scale-from-origin). - Discrete steps: [0.1, 0.25, 0.5, 0.67, 0.75, 1.0, 1.25, 1.5, 2.0, 3.0, 4.0, 6.0, 8.0]. -- Hand tool (`H`) — pan через drag. +- Hand tool (`H`) - pan через drag. ## Холст (canvas) - Default 900×600. -- Resize: edge-handles справа/снизу/угол. При drag — preview-rect с tooltip - `WxH`. На mouseup — реальный resize с белой заливкой пустых областей. +- Resize: edge-handles справа/снизу/угол. При drag - preview-rect с tooltip + `WxH`. На mouseup - реальный resize с белой заливкой пустых областей. - Sidebar: ширина/высота как input fields + Apply button. ## Быстрые действия (sidebar) @@ -326,16 +326,16 @@ public enum DocumentMode - Отразить вертикально ## File I/O -- Open: `OpenFileDialog` PNG/JPG/BMP/GIF/WEBP. Если изображение больше canvas - — спросить «расширить?» или «вписать?». Если меньше — paste в (0,0). -- Save: `SaveFileDialog`. Если был открыт файл — `Ctrl+S` пишет в него. +- Open: `OpenFileDialog` PNG/JPG/BMP/GIF/WEBP. Если изображение больше canvas - + спросить «расширить?» или «вписать?». Если меньше - paste в (0,0). +- Save: `SaveFileDialog`. Если был открыт файл - `Ctrl+S` пишет в него. - File associations (через app.manifest): `.png`, `.jpg`, `.jpeg`, `.bmp`, `.gif`, `.webp`. -- Drag-and-drop файлов на окно — открывает. +- Drag-and-drop файлов на окно - открывает. ## Clipboard -- `Ctrl+C` — копирует selection (или весь canvas если нет selection). -- `Ctrl+X` — вырезает. -- `Ctrl+V` — вставляет как FloatingPickup в (20, 20). +- `Ctrl+C` - копирует selection (или весь canvas если нет selection). +- `Ctrl+X` - вырезает. +- `Ctrl+V` - вставляет как FloatingPickup в (20, 20). ## Меню (Menu Bar) - Файл: Создать / Открыть / Сохранить / Сохранить как / Экспорт / Выход @@ -344,18 +344,18 @@ public enum DocumentMode - Изображение: Resize canvas / Rotate / Flip / Crop to selection - Справка: О программе -## Хоткеи (КРИТИЧНО — все должны работать СТАБИЛЬНО) -- `S` — select, `Q` — quad, `H` — hand, `P` — pencil, `B` — brush, `M` — marker, - `E` — eraser, `G` — fill, `I` — picker, `T` — text -- `Ctrl+Z` — undo, `Ctrl+Y` / `Ctrl+Shift+Z` — redo -- `Ctrl+S` — save, `Ctrl+O` — open -- `Ctrl+C/X/V` — clipboard -- `Ctrl+A` — select all -- `Delete` — clear selection contents / cancel floating -- `Escape` — commit / cancel -- `Enter` — commit floating -- `[` / `]` — rotate ±90° (Shift = ±15°) -- `Ctrl+=` / `Ctrl+-` / `Ctrl+0` — zoom in/out/reset +## Хоткеи (КРИТИЧНО - все должны работать СТАБИЛЬНО) +- `S` - select, `Q` - quad, `H` - hand, `P` - pencil, `B` - brush, `M` - marker, + `E` - eraser, `G` - fill, `I` - picker, `T` - text +- `Ctrl+Z` - undo, `Ctrl+Y` / `Ctrl+Shift+Z` - redo +- `Ctrl+S` - save, `Ctrl+O` - open +- `Ctrl+C/X/V` - clipboard +- `Ctrl+A` - select all +- `Delete` - clear selection contents / cancel floating +- `Escape` - commit / cancel +- `Enter` - commit floating +- `[` / `]` - rotate ±90° (Shift = ±15°) +- `Ctrl+=` / `Ctrl+-` / `Ctrl+0` - zoom in/out/reset - В WPF используй `InputBindings` на Window-уровне + `Focusable=false` на кнопках, чтобы хоткеи не перехватывались focus-ом кнопок. @@ -369,7 +369,7 @@ public enum DocumentMode --- -# Визуальный язык — Apple Liquid Glass (iOS 26 / macOS Tahoe 26) +# Визуальный язык - Apple Liquid Glass (iOS 26 / macOS Tahoe 26) ## Цветовые токены (как XAML resources) @@ -390,7 +390,7 @@ public enum DocumentMode ## Window background (обязательно цветной) Используй `` накладкой 4-5 цветных пятен поверх базового -LinearGradient `#0E0C1A → #1A1330 → #0C1024` (135°). Если просто чёрный фон — +LinearGradient `#0E0C1A → #1A1330 → #0C1024` (135°). Если просто чёрный фон - acrylic blur будет визуально серым. Пятна (примерно): @@ -420,7 +420,7 @@ multi-stop multiple radial gradients как CSS. ``` -Если используешь `Wpf.Ui` — пакет имеет `AcrylicBrush` который даёт настоящий +Если используешь `Wpf.Ui` - пакет имеет `AcrylicBrush` который даёт настоящий blur+saturate. Иначе fallback на полупрозрачный + `BlurEffect` на снапшоте фона (медленнее). @@ -433,12 +433,12 @@ blur+saturate. Иначе fallback на полупрозрачный + `BlurEffe - `EasingFunction`: `SineEase` или `QuadraticEase` - `RepeatBehavior=Forever` -Не делай через `DispatcherTimer` и manual Update — это лагает и съедает CPU. +Не делай через `DispatcherTimer` и manual Update - это лагает и съедает CPU. WPF Storyboard работает на compositor thread, идеально 60 fps. ## Анимация ripple на клике -При MouseDown на любой `.btn`/`.tool` — `` за курсором, scale 0 → 2.6, +При MouseDown на любой `.btn`/`.tool` - `` за курсором, scale 0 → 2.6, opacity 0.9 → 0. Через `Storyboard` 650ms. Управляй через behavior или attached property. @@ -446,7 +446,7 @@ attached property. # КРИТИЧНЫЕ АНТИПАТТЕРНЫ из Electron-версии (НЕ ПОВТОРЯТЬ) -Эти баги мы прошли в HTML-версии после ~30 итераций фиксов. **Каждый из них — +Эти баги мы прошли в HTML-версии после ~30 итераций фиксов. **Каждый из них - прямой указатель на архитектурное решение в C#**. ## 1. Сlear на одном слое visible state НЕ сбрасывает все state-слои @@ -454,7 +454,7 @@ attached property. В Electron `clearCanvas()` заливал основной `` белым, но игнорировал `previewCanvas` (для floating pickup), `state.selectionData` (ImageData), `state.originalBeforeMove` (backup). Визуально пользователь видел «ничего -не очистилось» — старый floating оставался поверх. +не очистилось» - старый floating оставался поверх. **В C# фикс**: `ClearCanvasCommand.Execute(doc)` должен: ```csharp @@ -464,7 +464,7 @@ doc.Selection = null; doc.ActiveLayer.Clear(SKColors.White); doc.Mode = DocumentMode.Idle; ``` -И **unit-test**: «после Clear с активным floating, нажми Pencil + рисуй — +И **unit-test**: «после Clear с активным floating, нажми Pencil + рисуй - floating не появляется поверх, рисую на чистом холсте». ## 2. Handles внутри overlay перехватывают mousemove во время drag @@ -486,7 +486,7 @@ drawing (привязано к флагу `IsDrawing` через PropertyChanged ``` -ИЛИ используй `CaptureMouse()` на canvas в `PointerDown` — это берёт capture, +ИЛИ используй `CaptureMouse()` на canvas в `PointerDown` - это берёт capture, все events идут только на canvas пока pointer не released. **Правильный WPF-way**. @@ -540,8 +540,8 @@ public FloatingPickup? FloatingPickup ## 5. PNG-snapshot для undo -В Electron `state.history` = `[canvas.toDataURL(), ...]` — каждый snapshot -~3 МБ. Через 30 операций — 90 МБ памяти и медленный restore. +В Electron `state.history` = `[canvas.toDataURL(), ...]` - каждый snapshot +~3 МБ. Через 30 операций - 90 МБ памяти и медленный restore. **В C# фикс**: Command Pattern. Каждая команда хранит только diff (bitmap размером со stroke, не размером с canvas): @@ -565,7 +565,7 @@ public sealed class DrawStrokeCommand : IDocumentCommand ## 6. Pickup для polygon-selection стирает bbox вместо polygon -В Electron при создании quad-selection я сразу стирал весь bbox — поэтому +В Electron при создании quad-selection я сразу стирал весь bbox - поэтому если ты делал треугольник corner-drag'ом, вокруг треугольника был белый прямоугольник на canvas. @@ -574,7 +574,7 @@ public sealed class DrawStrokeCommand : IDocumentCommand `OriginalQuadErased` и метод `EnsureOriginalQuadErased()`. См. полный код в существующем `paint-pro.html` (функция с тем же именем). -## 7. State.drawing + state.draggingFloating + state.movingSelection — 6 разных bool флагов +## 7. State.drawing + state.draggingFloating + state.movingSelection - 6 разных bool флагов Это race conditions в чистом виде. Один сбросил, другой нет. @@ -608,7 +608,7 @@ public void Clear_resets_all_layers_including_floating() public void Rotated_resize_anchor_math_preserves_opposite_corner() { // floating 100x100 в (50,50), rotation = 30° - // тащим SE handle на (200,200) — newCorner = (200,200) + // тащим SE handle на (200,200) - newCorner = (200,200) // ожидаем что NW corner (anchor) остался в world coords (50,50) после resize var floating = new FloatingPickup { X=50, Y=50, W=100, H=100, Rotation=Math.PI/6 }; var math = new ResizeMath(floating, "se"); @@ -625,7 +625,7 @@ public void Quad_corner_drag_does_NOT_erase_canvas() new PromoteQuadCommand().Execute(doc); // создаёт floating с quad var canvasBefore = doc.ActiveLayer.Snapshot(); - // Тащим один corner — НЕ должно менять active layer canvas + // Тащим один corner - НЕ должно менять active layer canvas doc.FloatingPickup!.Quad[0] = new SKPoint(20, 20); var canvasAfter = doc.ActiveLayer.Snapshot(); Assert.True(canvasBefore.Equals(canvasAfter)); @@ -655,7 +655,7 @@ public void Hotkey_works_even_after_clicking_button() // Симулируем клик на кнопке Brush window.BrushToolButton.RaiseEvent(new RoutedEventArgs(Button.ClickEvent)); Assert.Equal(ToolKind.Brush, vm.ActiveTool); - // Теперь нажимаем "S" — должен переключиться на Select + // Теперь нажимаем "S" - должен переключиться на Select window.RaiseEvent(new KeyEventArgs(... Key.S ...)); Assert.Equal(ToolKind.Select, vm.ActiveTool); // фокус не блокирует } @@ -700,14 +700,14 @@ public void Selection_and_floating_are_mutually_exclusive() # Reference материалы -Если есть доступ к существующему `paint-pro-electron/paint-pro.html` — +Если есть доступ к существующему `paint-pro-electron/paint-pro.html` - там ~3500 строк HTML/CSS/JS со всей логикой. Это твой "spec". НЕ переноси -дословно — это монолит. Переноси **поведение и hot-key set**, но архитектуру +дословно - это монолит. Переноси **поведение и hot-key set**, но архитектуру строй с нуля по принципам выше. Особенно полезные файлы для reference: -- `DEV_CONTEXT.md` — описание визуального языка, токенов, антипаттернов. -- `paint-pro.html` — функция `resizeFloating()` (anchor-based math), +- `DEV_CONTEXT.md` - описание визуального языка, токенов, антипаттернов. +- `paint-pro.html` - функция `resizeFloating()` (anchor-based math), `drawClippedQuad()` (polygon clip), `ensureOriginalQuadErased()` (lazy erase для polygon). @@ -715,16 +715,16 @@ public void Selection_and_floating_are_mutually_exclusive() 1. Solution skeleton с пустыми классами (Document, Layer, ITool, IDocumentCommand) и unit-тестами на математику (GeometryMath). -2. CanvasView с SkiaSharp — нарисовать тестовый rect, проверить что рендеринг +2. CanvasView с SkiaSharp - нарисовать тестовый rect, проверить что рендеринг работает. -3. PencilTool как самый простой — реализовать полный цикл PointerDown/Move/Up +3. PencilTool как самый простой - реализовать полный цикл PointerDown/Move/Up с DrawStrokeCommand → HistoryManager.Push. 4. Undo/Redo на тестах. 5. Selection tool с rect + handles + lazy promote во FloatingPickup. 6. Quad tool с polygon clip. 7. Все остальные tools. -8. Стилизация Liquid Glass — в самом конце, когда логика отлажена. +8. Стилизация Liquid Glass - в самом конце, когда логика отлажена. **Не пытайся всё сделать в один файл MainWindow.xaml.cs. Не используй только -code-behind. Цель — код который через 6 месяцев легко расширить новым tool -(нарисовал ITool, добавил кнопку — работает) без рефакторинга всего проекта.** +code-behind. Цель - код который через 6 месяцев легко расширить новым tool +(нарисовал ITool, добавил кнопку - работает) без рефакторинга всего проекта.** diff --git a/docs/superpowers/specs/2026-08-28-history-entry-toggle-design.md b/docs/superpowers/specs/2026-08-28-history-entry-toggle-design.md index 2c02b6c..20d86c1 100644 --- a/docs/superpowers/specs/2026-08-28-history-entry-toggle-design.md +++ b/docs/superpowers/specs/2026-08-28-history-entry-toggle-design.md @@ -5,10 +5,10 @@ ## Задача Сейчас панель истории умеет одно: щелчок по строке приводит документ к этой позиции, -то есть отменяет всё, что сделано после неё. Нужна вторая возможность — **выключить одну +то есть отменяет всё, что сделано после неё. Нужна вторая возможность - **выключить одну правку из середины ленты, не трогая те, что идут после неё**. -Мысленная модель — выключатель, а не вычёркивание: галочка снимается и ставится обратно +Мысленная модель - выключатель, а не вычёркивание: галочка снимается и ставится обратно сколько угодно раз, документ каждый раз пересобирается. ## Какие правки выключаются @@ -18,17 +18,17 @@ | Запись | Что делает с пикселями | Выключается | |---|---|---| -| `DrawStrokeCommand` — штрих, фигура, текст | подмешивает свой битмап поверх | да | -| `FillCommand` — заливка | пересчитывается от текущего состояния слоя | да | -| `EraseRegionCommand` — стирание выделения | закрашивает свою форму | да | -| `RegionDiffCommand` — прижатие объекта, вставка | кладёт готовый снимок области | нет | -| `ReplaceAllLayersCommand` — поворот, отражение, кадрирование, открытие | кладёт снимок всех слоёв | нет | +| `DrawStrokeCommand` - штрих, фигура, текст | подмешивает свой битмап поверх | да | +| `FillCommand` - заливка | пересчитывается от текущего состояния слоя | да | +| `EraseRegionCommand` - стирание выделения | закрашивает свою форму | да | +| `RegionDiffCommand` - прижатие объекта, вставка | кладёт готовый снимок области | нет | +| `ReplaceAllLayersCommand` - поворот, отражение, кадрирование, открытие | кладёт снимок всех слоёв | нет | | `ResizeCanvasCommand`, `ClearCanvasCommand`, `LayerStackCommand` | пересобирают стопку слоёв | нет | | `PasteCommand` | кладёт картинку в руки, пикселей не трогает | нет | Первые три **складываются** с тем, что уже на слое: пропустить одну из них при проигрывании можно, и результат будет ровно «как если бы её не делали». Остальные пишут абсолютный -снимок: при пересборке они положат его поверх — вместе с тем, что пользователь выключил, — +снимок: при пересборке они положат его поверх - вместе с тем, что пользователь выключил, - и выключатель начал бы врать. Отсюда правило: @@ -46,7 +46,7 @@ ### Лента -`HistoryManager` держит набор выключенных записей — по ссылке на команду, а не по номеру: +`HistoryManager` держит набор выключенных записей - по ссылке на команду, а не по номеру: номера едут при обрезке переполнения (`Trim`) и при вычёркивании вставки (`Forget`). Проигрывание ленты (`Undo`, `Redo`, `JumpTo`) пропускает выключенные записи: курсор через @@ -57,23 +57,23 @@ `SetEnabled(command, enabled, doc)` идёт одним путём: 1. запомнить позицию курсора; -2. `JumpTo(0)` — откат обычным способом, по действующим снимкам «до»; они ещё верны; +2. `JumpTo(0)` - откат обычным способом, по действующим снимкам «до»; они ещё верны; 3. поменять пометку; 4. велеть всем записям от переключённой и ниже забыть снимок «до»; -5. `JumpTo(запомненную позицию)` — проигрывание вперёд с пропуском выключенных. +5. `JumpTo(запомненную позицию)` - проигрывание вперёд с пропуском выключенных. Шаг 4 обязателен: снимок «до», снятый при первой записи, описывает слой вместе с той правкой, которую только что выключили. Без пересъёмки первый же Ctrl+Z после переключения вернул бы пиксели по устаревшему снимку. Пересъёмку умеют делать `DrawStrokeCommand` и `EraseRegionCommand` (`ForgetBefore`); `FillCommand` пересчитывает себя сам и так. -Записи, которые пишут абсолютный снимок, после пропуска не проигрываются никогда — правило -выше это гарантирует, — поэтому пересъёмка им не нужна. +Записи, которые пишут абсолютный снимок, после пропуска не проигрываются никогда - правило +выше это гарантирует, - поэтому пересъёмка им не нужна. ### Признак несохранённой работы Метка сохранения запоминает не только позицию курсора, но и набор выключенных записей. -Выключить и включить обратно — значит вернуться к сохранённому состоянию, и вопроса про +Выключить и включить обратно - значит вернуться к сохранённому состоянию, и вопроса про сохранение быть не должно. ### Панель @@ -88,15 +88,15 @@ > **Позиция курсора вместе с набором выключенных однозначно задаёт документ.** -Фаззер получает новый вид шага — «переключить случайную выключаемую запись». +Фаззер получает новый вид шага - «переключить случайную выключаемую запись». Точечные проверки сверх фаззера: -- выключить и включить обратно — документ прежний до пикселя; +- выключить и включить обратно - документ прежний до пикселя; - выключение последней записи в ленте равно обычной отмене; - у записи, ниже которой есть прижатие объекта или правка холста, галочки нет; - у записи, пишущей снимок, галочки нет никогда; -- переключение делает документ изменённым, обратное переключение — снова сохранённым. +- переключение делает документ изменённым, обратное переключение - снова сохранённым. ## Чего не делаем diff --git a/paint-pro-electron/CHANGELOG.md b/paint-pro-electron/CHANGELOG.md index 12d4d16..3520b76 100644 --- a/paint-pro-electron/CHANGELOG.md +++ b/paint-pro-electron/CHANGELOG.md @@ -1,18 +1,18 @@ # Изменения > История обеих реализаций Paint Pro ведётся одним файлом, поэтому выпуски, менявшие -> обе сразу, записаны как «C# / Electron»: **1.26.0 / 1.15.0** — это C#-версия 1.26.0 и +> обе сразу, записаны как «C# / Electron»: **1.26.0 / 1.15.0** - это C#-версия 1.26.0 и > Electron-версия 1.15.0. Здесь опубликована Electron-версия, и её история начинается -> с 1.11.1 — с того выпуска, когда у неё появилась собственная линия номеров. +> с 1.11.1 - с того выпуска, когда у неё появилась собственная линия номеров. > > Файл собирается из общего скриптом `tools/sync-changelog.js`, руками не правится. -## 1.36.1 / 1.21.0 (только Electron-версия: 1.21.0) — отмена отражения, C# без изменений +## 1.36.1 / 1.21.0 (только Electron-версия: 1.21.0) - отмена отражения, C# без изменений По отчёту: «нажал отразить, Ctrl+Z - на холсте ничего не поменялось, а ластик стирает противоположную сторону». Поменялась только Electron-версия, теперь 1.21.0. C#-версия без изменений: номер 1.36.1 у неё только потому, что выпуски на GitHub идут по номеру -C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# — 1144, как было. +C#, а 1.36.0 уже выпущен. Проверок: Electron - 474 (+5), C# - 1144, как было. ### Портит работу @@ -23,9 +23,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# рисовали с противоположной стороны. В C#-версии каждое преобразование рисует новым холстом, который сразу выбрасывается, - там этого не было. -## 1.36.0 (только C#-версия) — ровные галочки +## 1.36.0 (только C#-версия) - ровные галочки -По замечанию «исправь галочки». Проверок: C# — 1144 (+3), Electron без изменений. +По замечанию «исправь галочки». Проверок: C# - 1144 (+3), Electron без изменений. ### Мешало обычной работе @@ -34,9 +34,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# ниже середины квадрата. Теперь квадрат одного размера в обоих состояниях, галочка посередине. В Electron-версии флажок родной, Chromium, - там этого не было. -## 1.35.0 (только C#-версия) — печать листа +## 1.35.0 (только C#-версия) - печать листа -По просьбе сделать печать листа и в C#-версии. Проверок: C# — 1141 (+18), Electron без +По просьбе сделать печать листа и в C#-версии. Проверок: C# - 1141 (+18), Electron без изменений. ### Мешало обычной работе @@ -47,9 +47,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# своём размере, большая уменьшается до страницы. Ориентация страницы подсказывается по форме картинки: холст по умолчанию лежачий, а в окне печати её легко не заметить. -## 1.34.0 / 1.20.0 — быстрые мазки не подвисают, печать только листа +## 1.34.0 / 1.20.0 - быстрые мазки не подвисают, печать только листа -Разбор по двум замечаниям. Проверок: C# — 1123 (+22), Electron — 469 (+10) плюс 17 по +Разбор по двум замечаниям. Проверок: C# - 1123 (+22), Electron - 469 (+10) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -66,9 +66,9 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# печатается один лист: картинка как на экране, со слоями и с объектом, который ещё в руках; документ при этом не меняется. Появился пункт «Файл → Печать…». -## 1.33.0 / 1.19.0 — кисть с ворсинками, кружок не отстаёт, объект тащится хоть за окно +## 1.33.0 / 1.19.0 - кисть с ворсинками, кружок не отстаёт, объект тащится хоть за окно -Разбор по трём замечаниям к обеим версиям. Проверок: C# — 1101 (+84), Electron — 459 (+36) +Разбор по трём замечаниям к обеим версиям. Проверок: C# - 1101 (+84), Electron - 459 (+36) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -96,11 +96,11 @@ C#, а 1.36.0 уже выпущен. Проверок: Electron — 474 (+5), C# Electron зерно записано в мазок, и пересборка ленты рисует тот же пучок; старые мазки кисти, записанные до 1.19.0, пересобираются сплошной линией, как и были нарисованы. -## 1.32.0 / 1.18.0 — кружок размера не врёт, размер - это толщина у всех инструментов +## 1.32.0 / 1.18.0 - кружок размера не врёт, размер - это толщина у всех инструментов Разбор по замечанию к обеим версиям: кружок размера кисти показывает не тот размер, а у -ластика и карандаша одни и те же «300 px» дают разные полосы. Проверок: C# — 1017 (+57), -Electron — 423 (+33) плюс 17 по настоящему приложению. +ластика и карандаша одни и те же «300 px» дают разные полосы. Проверок: C# - 1017 (+57), +Electron - 423 (+33) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -117,9 +117,9 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **У двух старых выпусков на GitHub (1.28.0 и 1.15.0) не было описания** - дописаны. -## 1.31.0 / 1.17.0 — размер кисти меняется посреди штриха, кисть до 300 px +## 1.31.0 / 1.17.0 - размер кисти меняется посреди штриха, кисть до 300 px -Разбор по двум замечаниям к обеим версиям. Проверок: C# — 960 (+17), Electron — 390 (+14) +Разбор по двум замечаниям к обеим версиям. Проверок: C# - 960 (+17), Electron - 390 (+14) плюс 17 по настоящему приложению. ### Мешало обычной работе @@ -140,10 +140,10 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **У выпуска на GitHub появилось описание.** Раньше там была одна ссылка «Full Changelog». Короткое описание лежит в `docs/release-notes/<тег>.md`; описания 1.28.1-1.30.0 дописаны. -## 1.30.0 (только C#-версия) — холст размером с окно: фотографии втрое быстрее и до 800% +## 1.30.0 (только C#-версия) - холст размером с окно: фотографии втрое быстрее и до 800% Холст переделан под большие фотографии, как в Electron-версии: рисуется только то, что -видно в окне. Проверок: C# — 943 (+103), Electron без изменений. +видно в окне. Проверок: C# - 943 (+103), Electron без изменений. ### Мешало обычной работе @@ -174,10 +174,10 @@ Electron — 423 (+33) плюс 17 по настоящему приложени превью штриха и объект в руках рисуются теперь без копии, пиксели те же. Так же без копии снимается «до» у каждого штриха для отмены. -## 1.29.0 (только C#-версия) — рисование в пять раз быстрее, холст посередине +## 1.29.0 (только C#-версия) - рисование в пять раз быстрее, холст посередине Разбор по двум замечаниям к C#-версии: она заметно медленнее, чем Electron, а уменьшенный -холст уезжает в левый верхний угол. Проверок: C# — 840 (+132), Electron без изменений. +холст уезжает в левый верхний угол. Проверок: C# - 840 (+132), Electron без изменений. ### Мешало обычной работе @@ -210,12 +210,12 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **C#: тени у меню, подсказок, выпадающих списков и диалогов** тоже в кэше - по тому же правилу. Проверка читает разметку всех файлов и не пропустит новую тень без кэша. -## 1.28.1 / 1.16.1 — Electron 44, сборщик без уязвимостей, C# без изменений +## 1.28.1 / 1.16.1 - Electron 44, сборщик без уязвимостей, C# без изменений Выпуск ради безопасности Electron-версии. После включения оповещений Dependabot GitHub показал 64 уязвимости в зависимостях `paint-pro-electron`; `npm audit` - 21, одну -критическую. Теперь 0. Проверок столько же, все прошли на новом Electron: Electron — 376 -плюс 17 по настоящему приложению, C# — 708. +критическую. Теперь 0. Проверок столько же, все прошли на новом Electron: Electron - 376 +плюс 17 по настоящему приложению, C# - 708. ### Скрытое @@ -229,11 +229,11 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **C#-версия не менялась**: номер 1.28.1 поднят, потому что выпуск на GitHub называется по номеру C#-версии. -## 1.28.0 / 1.16.0 — две версии один в один, панели тянутся, окно помнит место +## 1.28.0 / 1.16.0 - две версии один в один, панели тянутся, окно помнит место Разбор по замечаниям к виду обеих версий: всё, что было только в одной из них, перенесено -в другую, раскладка одна и та же, а визуальные недочёты исправлены. Проверок: C# — 708 -(+85), Electron — 376 (+41) плюс 17 по настоящему приложению (+3). +в другую, раскладка одна и та же, а визуальные недочёты исправлены. Проверок: C# - 708 +(+85), Electron - 376 (+41) плюс 17 по настоящему приложению (+3). ### Портит работу @@ -252,15 +252,15 @@ Electron — 423 (+33) плюс 17 по настоящему приложени возвращает как было, ширина запоминается. Инструменты встают в один, два или три столбца, палитра ужимается, и ничего не налезает: это проверяется на самом маленьком окне с настоящей полосой прокрутки. На узком окне панели уступают место холсту. -- **Окно открывается там и такого размера, где его закрыли** — в обеих версиях. Монитор - отключили — окно встаёт на основной; заголовок всегда остаётся на экране. -- **Выбор цвета.** В C#-версии — своё окно: квадрат оттенков, полоса тона, HEX, образец +- **Окно открывается там и такого размера, где его закрыли** - в обеих версиях. Монитор + отключили - окно встаёт на основной; заголовок всегда остаётся на экране. +- **Выбор цвета.** В C#-версии - своё окно: квадрат оттенков, полоса тона, HEX, образец «было / стало»; раньше было окно «Введите цвет в HEX». В Electron-версии окно выбора - открывалось только щелчком по левой части образца — теперь по всему. + открывалось только щелчком по левой части образца - теперь по всему. - **«Последние» цвета в обеих версиях:** до восьми, свежий первым, без повторов. Пока цвет подбирают в окне, промежуточные оттенки туда не сыплются. - **Одна палитра:** сорок цветов по восемь в ряд, по центру, одни и те же в обеих версиях. -- **Сообщения и вопросы — в цветах темы**, а не белыми системными окнами. +- **Сообщения и вопросы - в цветах темы**, а не белыми системными окнами. - **C#: свой заголовок окна** с меню, названием и значком, скругление углов; кнопки с рамками, ровные ползунки и флажки; окно текста со шрифтом, размером, жирным, курсивом и подчёркнутым, как в Electron-версии. @@ -271,13 +271,13 @@ Electron — 423 (+33) плюс 17 по настоящему приложени ### Новое в одной из версий, теперь в обеих -- Поворот на 90° против часовой (Electron) — в меню и в быстрых действиях. +- Поворот на 90° против часовой (Electron) - в меню и в быстрых действиях. - Порядок слоёв ▲▼, «Очистить холст», размер выделения в строке состояния, имена слоёв «Бумага» и «Слой N» (C#). - Размер холста полями прямо в правой панели (C#), «Правка → Удалить» (Electron), клавиши L, R, O, C для линии, прямоугольника, эллипса и обрезки (Electron). -## 1.27.0 (только C#-версия) — иконки видны в светлой теме, полосы прокрутки под тему +## 1.27.0 (только C#-версия) - иконки видны в светлой теме, полосы прокрутки под тему Разбор после кадров для README: их теперь собирает программа (`tools/PaintPro.Screenshots`), рисуя настоящими инструментами и снимая окно в трёх @@ -299,24 +299,24 @@ Electron — 423 (+33) плюс 17 по настоящему приложени инструментов, у правой панели и под холстом. Теперь это узкая дорожка с ползунком из цветов текущей темы. -## 1.26.0 / 1.15.0 — ресайз идёт за мышью, прямоугольный треугольник в фигурах +## 1.26.0 / 1.15.0 - ресайз идёт за мышью, прямоугольный треугольник в фигурах -Обе версии, оба изменения. Проверок: C# — 623 (+11), Electron — 335 (+19) плюс 14 по +Обе версии, оба изменения. Проверок: C# - 623 (+11), Electron - 335 (+19) плюс 14 по настоящему приложению. ### Портит работу - **Ресайз выделения срывался, стоило отклониться от линии на пару пикселей.** Вести мышь - приходилось идеально по траектории: чуть в сторону — и рамка застывала, хотя кнопка + приходилось идеально по траектории: чуть в сторону - и рамка застывала, хотя кнопка оставалась зажатой. Теперь ресайз идёт просто за направлением мыши, откуда бы её ни вело. Причина оказалась не в счёте координат, а в том, чем приложение считало конец жеста. Рамка выделения и её восемь ручек лежат ПОВЕРХ холста отдельными элементами, а не - внутри него. Пока тянешь ручку, курсор то и дело оказывается над ней или над соседней — + внутри него. Пока тянешь ручку, курсор то и дело оказывается над ней или над соседней - и для холста это ровно то же событие «курсор ушёл», что и уход за край. На этом событии висело завершение жеста. Отсюда и требование вести пиксель в пиксель: если идти строго - по траектории, ручка едет ровно под курсором и он с неё не сходит. Стоит промахнуться — + по траектории, ручка едет ровно под курсором и он с неё не сходит. Стоит промахнуться - курсор соскакивает на холст и обратно, и ресайз считался законченным. Тем же событием обрывалось и перетаскивание объекта, если путь проходил над его @@ -325,38 +325,38 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **Мазок обрывался на краю холста и не продолжался при возврате.** Тот же виновник: кнопка всё это время оставалась зажатой, а штрих уже был записан в ленту. Вернувшись на холст, пользователь вёл мышь впустую и получал вместо одной линии два обрубка. - В WPF-версии мышь на время жеста захватывается и ничего подобного не происходило — + В WPF-версии мышь на время жеста захватывается и ничего подобного не происходило - версии разошлись молча. Теперь в обеих жест кончается ОТПУСКАНИЕМ кнопки. ### Новое - **Прямоугольный треугольник в фигурах**, рядом с обычным. Прямой угол ставится по направлению жеста: катеты выходят из точки старта, гипотенуза ложится ровно на линию, - которую ведёт рука. Поэтому один и тот же прямоугольник даёт четыре разных треугольника - — по одному на каждое направление, — и не нужно ни отдельной кнопки на каждый поворот, + которую ведёт рука. Поэтому один и тот же прямоугольник даёт четыре разных треугольника - + по одному на каждое направление, - и не нужно ни отдельной кнопки на каждый поворот, ни попыток угадать, какой из четырёх имелся в виду. У остальных фигур габарит жеста нормализуется и направление теряется; здесь оно и есть весь смысл. ### Скрытое - **Жест, отпускания которого никто не видел, больше не виснет.** Кнопку можно отпустить - за краем окна или под чужим окном, вышедшим вперёд, — `mouseup` тогда не приходит + за краем окна или под чужим окном, вышедшим вперёд, - `mouseup` тогда не приходит совсем. Раньше такой жест частично подбирал уход курсора с холста; теперь, когда уход не завершает ничего, подбор сделан явно: первое же движение с уже отпущенной кнопкой и потеря фокуса окном закрывают жест. В WPF-версии этот случай с 1.21.0 ловит - `Skia.LostMouseCapture` — теперь оба поведения проверены с обеих сторон. + `Skia.LostMouseCapture` - теперь оба поведения проверены с обеих сторон. - **Список фигур перестал жить в двух местах.** Память размера кисти держала свой собственный перечень инструментов, набранный руками; новая фигура попала бы в панель, а - в этот перечень — нет, и размер при переключении на неё «залипал» бы от ластика. Теперь + в этот перечень - нет, и размер при переключении на неё «залипал» бы от ластика. Теперь перечень один. - **Проверка читаемости тем перестала врать на загруженной машине.** Она ждала конца перехода фиксированные 250 мс, а когда четыре проверки идут параллельно, кадры - приходят реже — и цвет читался ПОСРЕДИ перехода, которого пользователь не увидит. + приходят реже - и цвет читался ПОСРЕДИ перехода, которого пользователь не увидит. Ждём теперь не время, а факт: два одинаковых замера подряд. -## 1.25.0 / 1.14.0 — колесо меняет размер кисти, холст тянется за все восемь ручек +## 1.25.0 / 1.14.0 - колесо меняет размер кисти, холст тянется за все восемь ручек -Обе версии, оба изменения. Проверок: C# — 612 (+33), Electron — 316 (+24) плюс 14 по +Обе версии, оба изменения. Проверок: C# - 612 (+33), Electron - 316 (+24) плюс 14 по настоящему приложению. ### Новое @@ -400,22 +400,22 @@ Electron — 423 (+33) плюс 17 по настоящему приложени пиксели рисунка и глотала бы клики, адресованные инструменту. Места хватает: вокруг поверхности лежит поле в 40 пикселей, на котором и так лежала тень. -## 1.24.0 / 1.13.0 — пять тем оформления в обеих версиях и один файл для браузера +## 1.24.0 / 1.13.0 - пять тем оформления в обеих версиях и один файл для браузера Первый выпуск, который меняет обе версии сразу и одинаково. Тем пять, названия и порядок -совпадают. Проверок: C# — 579 (+14), Electron — 292 (+16) плюс 14 по настоящему приложению. +совпадают. Проверок: C# - 579 (+14), Electron - 292 (+16) плюс 14 по настоящему приложению. ### Новое -- **Пять тем оформления, «Вид → Тема».** «Стеклянная» — как было; «Строгая» — ровный тёмный - фон без цветных пятен и приглушённый синий; «Светлая» — тёмный текст на светлом; «Ночная» - — почти чёрный фон для тёмной комнаты; «Тёплая» — охра и кофе вместо синевы. Выбор +- **Пять тем оформления, «Вид → Тема».** «Стеклянная» - как было; «Строгая» - ровный тёмный + фон без цветных пятен и приглушённый синий; «Светлая» - тёмный текст на светлом; «Ночная» - + почти чёрный фон для тёмной комнаты; «Тёплая» - охра и кофе вместо синевы. Выбор переживает перезапуск, неизвестное имя откатывается к исходной теме: файл настроек могли - поправить руками, а приложение без оформления — не приложение. + поправить руками, а приложение без оформления - не приложение. - Тема — это НАБОР ТЕХ ЖЕ КЛЮЧЕЙ, а не отдельное оформление: всё уже ходило через токены, + Тема - это НАБОР ТЕХ ЖЕ КЛЮЧЕЙ, а не отдельное оформление: всё уже ходило через токены, поэтому смена сводится к подмене одного словаря (C#) или атрибута на корне (Electron). - Холст в тему не входит — бумага белая всегда. + Холст в тему не входит - бумага белая всегда. - **Отдельный файл для работы в браузере**: `npm run build:web` кладёт в `dist/` `paint-pro-<версия>-web.html`. Один файл, ничего больше не нужно: переслать, положить на @@ -423,21 +423,21 @@ Electron — 423 (+33) плюс 17 по настоящему приложени ### Портит работу -Все три находки — из запуска приложения и взгляда на экран. +Все три находки - из запуска приложения и взгляда на экран. - **Строка меню была зашита белым цветом.** «Файл», «Правка», «Вид» и «Справка» брали не токен, а `rgba(255,255,255,0.92)`: в светлой теме они становились невидимы. Там же - оказались заголовок программы и часы. Выпадающий список тоже всплывает над холстом — + оказались заголовок программы и часы. Выпадающий список тоже всплывает над холстом - переведён на ту же подложку, что подсказки. - **У пункта меню три роли, а шаблона было два.** Пункт со СВОИМ вложенным списком - («Вид → Тема») — это третья роль, `SubmenuHeader`, и её всплывающее окно рисовала + («Вид → Тема») - это третья роль, `SubmenuHeader`, и её всплывающее окно рисовала система: подменю тем открывалось пустой светлой панелью, ровно как выпадающие меню до 1.23.0. Пока вложенных подменю в программе не было ни одного, дыра не показывалась. - **Два установщика ставили одно поверх другого.** Обе версии назывались «Paint Pro» и шли в одну папку `%LOCALAPPDATA%\Programs\Paint Pro`: кто установлен вторым, тот и затирал первого, а в списке программ оставалась запись про стёртого. Electron-версия теперь ставится как «Paint Pro Electron» в собственную папку, со своим `appId` и своим - ярлыком. Папка настроек НЕ переехала — она берётся из `name` в `package.json`, а не из + ярлыком. Папка настроек НЕ переехала - она берётся из `name` в `package.json`, а не из `productName`, так что выбранная тема пережила переименование. - **Открытие файла не работало в браузере вовсе.** `Ctrl+O` и пункт «Открыть…» лежали внутри блока «только для Electron»: без моста они молча не делали ничего. Вынесены @@ -445,61 +445,61 @@ Electron — 423 (+33) плюс 17 по настоящему приложени ### Скрытое -- **`DynamicResource` вместо `StaticResource` во всей разметке C#** — 161 место. Иначе +- **`DynamicResource` вместо `StaticResource` во всей разметке C#** - 161 место. Иначе смена темы не видна: `StaticResource` разрешается один раз при загрузке. Исключение ровно - одно и оно жёсткое: `Converter` у привязки — не свойство зависимости, и `DynamicResource` + одно и оно жёсткое: `Converter` у привязки - не свойство зависимости, и `DynamicResource` там валит приложение прямо при запуске. Найдено ровно так: тесты проходили, а окно не открывалось. Обе стороны правила теперь под проверкой. - **Проверки тем проверяют не «красиво ли», а три правила**: у всех тем один и тот же набор - ключей (разойдись он на один — на смене кисть окажется пустой, и падать будет в отрисовке, + ключей (разойдись он на один - на смене кисть окажется пустой, и падать будет в отрисовке, где причину уже не увидеть); текст виден на фоне своей темы; подложка над холстом остаётся тёмной в любой теме. Последнее уже стоило одной находки в 1.12.2. - **Проверки браузерного файла гоняются по СОБРАННОМУ файлу**, а не по исходнику: - пересылают именно его. Среди прочего — что он не тянет ничего из сети, иначе «перекинул + пересылают именно его. Среди прочего - что он не тянет ничего из сети, иначе «перекинул на другое устройство» работало бы только с интернетом. -## 1.12.2 — память измерена, main-процесс проверен, две находки глазами +## 1.12.2 - память измерена, main-процесс проверен, две находки глазами Три слепые зоны, названные после прошлого прохода, закрыты: расход памяти, main-процесс и внешний вид. Семь находок. Проверок: 262 быстрых плюс 14 по настоящему приложению. ### Портит работу -**Память.** Померить аллокатор здесь нечем — холсты слоёв лежат вне кучи JavaScript, и +**Память.** Померить аллокатор здесь нечем - холсты слоёв лежат вне кучи JavaScript, и `performance.memory` на них показывает почти ноль, та же ловушка, что была в C# с `PrivateMemorySize64`. Поэтому считается не то, что выдал аллокатор, а то, что попросили мы сами: создание холста, `getImageData`, `toDataURL`. Единица та же, что в C#: «эта операция просит x2.25 от холста». - **Заливка просила заплатку размером с весь документ.** Заплатка нужна (класть надо только - закрашенное, иначе стопка расплющится), но заводить её во весь холст — нет: заливка внутри + закрашенное, иначе стопка расплющится), но заводить её во весь холст - нет: заливка внутри рамки трогает малую часть картинки. Теперь по габариту закрашенного: **x2.04 → x1.11**. -- **Заливка держала две байтовые карты вместо одной.** «Смотрели» и «закрасили» — два бита, +- **Заливка держала две байтовые карты вместо одной.** «Смотрели» и «закрасили» - два бита, а не два массива по байту на пиксель. Ещё четверть холста. - **Подъём выделения снимал ВЕСЬ слой ради возможности отменить.** Меняется только область выделения, её и достаточно: **x3.22 → x0.27** на небольшом выделении. - **Под признак «рамка готова к перемещению» копировался целый `ImageData`.** Поле когда-то - везло пиксели, потом читать его перестали — а снимать не перестали: «Выделить всё» + везло пиксели, потом читать его перестали - а снимать не перестали: «Выделить всё» копировало весь холст ради одного `true`. Это тот же шаблон «правило доведено до половины», только в редкой форме, и чтением кода он не виден: строка выглядит осмысленно. - **Отмена пересоздавала всю стопку слоёв.** По холсту на каждый слой, и на время подмены в - памяти жили обе стопки сразу — двойной пик на каждом Ctrl+Z. Холсты переиспользуются: + памяти жили обе стопки сразу - двойной пик на каждом Ctrl+Z. Холсты переиспользуются: **x5.00 → x0.00** при пяти слоях, пересборка ленты **x11.09 → x1.09**. -**Внешний вид.** Обе находки — из запуска приложения руками. +**Внешний вид.** Обе находки - из запуска приложения руками. - **Каждый штрих утаскивал боковую панель вниз.** Лента прокручивается к текущей записи, и `scrollIntoView` тащил за собой все прокручиваемые родители: панель слоёв уезжала из виду прямо во время рисования. Теперь прокручивается только сам список. - **Подсказка, панель обрезки и кнопки масштаба были нечитаемы над холстом.** Стеклянные - подложки приложения — это БЕЛЫЙ с прозрачностью 0.08–0.14, и рассчитаны они на тёмный фон - окна. Над белым холстом подложка становится белой, а текст на ней светлый — и пропадает + подложки приложения - это БЕЛЫЙ с прозрачностью 0.08-0.14, и рассчитаны они на тёмный фон + окна. Над белым холстом подложка становится белой, а текст на ней светлый - и пропадает начисто. Ровно то же было с выпадающим меню в C#-версии. У подсказки для размеров и панели текста подложка была тёмной с самого начала: правило снова оказалось доведено до половины. ### Скрытое -- **`tests-app/` — проверки настоящего приложения, а не страницы в браузере.** Playwright +- **`tests-app/` - проверки настоящего приложения, а не страницы в браузере.** Playwright умеет запускать Electron и выполнять код В MAIN-ПРОЦЕССЕ: нативный диалог подменяется, не показываясь, и видно, что приложение сделало дальше. Четырнадцать проверок: запись в .jpg даёт настоящий JPEG, ошибка записи доезжает до пользователя, отказ от диалога не считается @@ -515,7 +515,7 @@ Electron — 423 (+33) плюс 17 по настоящему приложени в папке пользовательских данных, и без своей папки на запуск второй экземпляр молча выходил; обработчик диалога падал, если диалог успели снять. -## 1.12.1 — сплошной проход по новой площади: семь находок +## 1.12.1 - сплошной проход по новой площади: семь находок Слои и командная лента - это две новые подсистемы, то есть свежая площадь, по которой ещё никто не ходил. Пять партий проб, пять инвариантов фаззера и два разовых тяжёлых прогона. @@ -566,36 +566,36 @@ Electron — 423 (+33) плюс 17 по настоящему приложени поднятый объект вместе, а не по отдельности. Находки в этом проекте раз за разом приходят из стыков: правило записано у одного участника и не записано у соседнего. -## 1.12.0 — Electron: слои и выключатель правки. Обе версии сравнялись +## 1.12.0 - Electron: слои и выключатель правки. Обе версии сравнялись -Полный перенос. Две подсистемы, которых в Electron-версии не было вовсе, — стопка слоёв и -командная лента — построены с нуля, и вместе с ними доехали все правки C#-выпусков -1.12.0—1.23.0, которые до сих пор были неприменимы. Проверок: 193 (+58). +Полный перенос. Две подсистемы, которых в Electron-версии не было вовсе, - стопка слоёв и +командная лента - построены с нуля, и вместе с ними доехали все правки C#-выпусков +1.12.0 - 1.23.0, которые до сих пор были неприменимы. Проверок: 193 (+58). ### Новое -- **Слои.** Слой — отдельный холст того же размера, что документ; видимый холст стал - производным, его пересобирает сборка. Слой номер ноль — БУМАГА документа: на ней ластик +- **Слои.** Слой - отдельный холст того же размера, что документ; видимый холст стал + производным, его пересобирает сборка. Слой номер ноль - БУМАГА документа: на ней ластик красит белым, а на слоях выше вычитает; ей достаётся фон при смене размера; удалить её нельзя. На этом держится с полдюжины правил, как и в C#-версии. Панель: список сверху вниз, как стопка лежит на холсте. Активный слой обведён, скрытый зачёркнут и с пустым глазом, у бумаги обе стрелки погашены. Щелчок по глазу не меняет - активный слой — это два разных намерения. Ползунок непрозрачности показывает АКТИВНЫЙ + активный слой - это два разных намерения. Ползунок непрозрачности показывает АКТИВНЫЙ слой, а не последний тронутый. Потолок стопки считается по ПЛОЩАДИ (192 млн пикселей, не больше ста слоёв): на - маленьком документе сто слоёв безобидны, на большом смертельны — каждый слой это целый + маленьком документе сто слоёв безобидны, на большом смертельны - каждый слой это целый холст, и на снимке 4000×3000 «Добавить слой» съедает по 48 МБ за нажатие. - **У правки в ленте появился выключатель.** Щелчок по строке приводит документ к этой - позиции, то есть отменяет всё, что после неё. Галочка — другое: снял, и правка перестаёт + позиции, то есть отменяет всё, что после неё. Галочка - другое: снял, и правка перестаёт применяться, а идущие после неё остаются на месте. Выключенная строка показана зачёркнутой. Выключатель есть не у всех, и деление проходит не по «нарисованное против холста», а по тому, КАК правка ложится на картинку. Штрих, фигура, надпись, заливка и стирание - СКЛАДЫВАЮТСЯ с тем, что на слое, — пропустить любую из них при пересборке можно, и + СКЛАДЫВАЮТСЯ с тем, что на слое, - пропустить любую из них при пересборке можно, и получится ровно «как если бы этой правки не делали». Прижатие поднятого, вставка, поворот, отражение, кадрирование, смена размера, открытие файла, очистка и действия со слоями кладут ГОТОВЫЙ снимок: при пересборке они положат его поверх вместе с тем, что @@ -604,15 +604,15 @@ Electron — 423 (+33) плюс 17 по настоящему приложени отказать. Где галочки нет, строка объясняет почему. Признак несохранённой работы считает набор выключенных наравне с позицией курсора: - выключить правку — значит изменить картинку, включить обратно — вернуться ровно к + выключить правку - значит изменить картинку, включить обратно - вернуться ровно к сохранённому. ### Портит работу -Найдено при переносе, всё — правила, давно записанные в C#-версии: +Найдено при переносе, всё - правила, давно записанные в C#-версии: -- **Жест не помнил, на каком слое начался.** Слой меняют посреди штриха — панель под рукой - всё время, а у окна ввода текста между кликом и ответом проходит сколько угодно, — и +- **Жест не помнил, на каком слое начался.** Слой меняют посреди штриха - панель под рукой + всё время, а у окна ввода текста между кликом и ответом проходит сколько угодно, - и краска уходила не туда, где её начали класть. - **Превью мазка лежало поверх всей стопки.** Штрих по нижнему слою во время протяжки был виден над верхними, а на отпускании нырял под них: картинка прыгала в момент, когда @@ -621,21 +621,21 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **Спрятанный и полностью прозрачный слой молча съедали краску**: на экране не появлялось ничего, а запись в ленте появлялась и документ считался изменённым. Это касалось кисти, фигур, заливки, текста, вставки, вырезания и Delete. -- **«Создать» оставлял прежнюю стопку** — со всеми именами, спрятанностью и прозрачностью +- **«Создать» оставлял прежнюю стопку** - со всеми именами, спрятанностью и прозрачностью прошлой работы. - **Отмена удаления слоя уводила кисть на другой слой.** ### Скрытое - **Два смысла у `ctx` разделены.** Он и рисовал, и читал: инструменты клали в него краску, - пипетка и лента читали из него картинку. Со слоями это разные объекты — рисуют в холст + пипетка и лента читали из него картинку. Со слоями это разные объекты - рисуют в холст активного слоя, читают из видимого. Без этого разделения каждая правка угадывала бы, куда попала. -- **Кадр ленты хранит стопку целиком** — имена, видимость, прозрачность и пиксели каждого +- **Кадр ленты хранит стопку целиком** - имена, видимость, прозрачность и пиксели каждого слоя, плюс отпечаток свойств: скрытый слой картинку не меняет, а документ меняет. - **Складывающаяся правка записывается ПОВТОРИМОЙ**, а не только отменяемой: точки штриха, углы фигуры, строка и шрифт надписи, точка и цвет заливки. Пересборка не накладывает - сохранённые пиксели, а ПОВТОРЯЕТ правку заново — иначе заливка после выключенного штриха + сохранённые пиксели, а ПОВТОРЯЕТ правку заново - иначе заливка после выключенного штриха соврала бы: подложка стала другой, и растечься она обязана по-новому. - **Повтор обязан совпадать ДО ПИКСЕЛЯ, и «почти» тут не годится.** Три расхождения нашлись и закрыты: штрих рисовался одним сплошным путём вместо отрезка за отрезком (18 пикселей @@ -643,40 +643,40 @@ Electron — 423 (+33) плюс 17 по настоящему приложени `drawShape` берёт цвет и толщину из состояния, а не из контекста, и фигура повторялась сегодняшними настройками вместо записанных. - **Фаззер ленты.** Случайные последовательности правок и пять инвариантов: один и тот же - набор выключенных даёт один и тот же документ; включить всё обратно — то же, что не + набор выключенных даёт один и тот же документ; включить всё обратно - то же, что не выключать вовсе; выключение одной записи не трогает остальные; снимок ниже отнимает галочку у всего, что выше; прогулка по ленте с выключенными записями приводит к тому же. - Именно он поймал ошибку с `drawShape` — сценарной проверкой она не воспроизводилась. + Именно он поймал ошибку с `drawShape` - сценарной проверкой она не воспроизводилась. Разовый тяжёлый прогон: 25 seed'ов по 7 шагов со всеми видами правок, случайными - прозрачностями, режимами заливки и размерами шрифта — отказов нет. + прозрачностями, режимами заливки и размерами шрифта - отказов нет. - **Номер слоя переживает восстановление кадра.** Описание правки ссылается на слой по номеру, а восстановление создавало слои заново: повтор не находил, куда рисовать, и пересборка теряла всё, что было после базового кадра. -## 1.11.5 — вставка идёт двумя путями, а поправлен был один +## 1.11.5 - вставка идёт двумя путями, а поправлен был один -Разбор после запуска приложения живьём. Само наблюдение оказалось неубедительным — -нажатия до окна не дошли, — но поиск причины привёл к настоящей находке в коде. +Разбор после запуска приложения живьём. Само наблюдение оказалось неубедительным - +нажатия до окна не дошли, - но поиск причины привёл к настоящей находке в коде. ### Портит работу - **Картинка из системного буфера по-прежнему уезжала за край маленького холста.** Путей - вставки два: свой буфер (`pasteFromClipboard`) и системный — тот приходит событием + вставки два: свой буфер (`pasteFromClipboard`) и системный - тот приходит событием `paste` и идёт через `createFloatingFromImage`. Отступ в двадцать пикселей был зашит числом в обоих, а поправлен в 1.11.4 только в первом. Теперь отступ считает одна общая функция, и оба пути берут её. ### Скрытое -- **Проверка звала функцию вместо пути пользователя — и потому прошла мимо.** «Вставка по +- **Проверка звала функцию вместо пути пользователя - и потому прошла мимо.** «Вставка по пустому буферу объясняется» вызывала `pasteFromClipboard()` напрямую, а Ctrl+V приходит событием `paste`, и до этой функции доходит только когда в системном буфере нет картинки. Проверка переписана на событие; вторая проверяет отступ на системном пути. Проверок: 135. -## 1.11.4 — Electron: пять расхождений с C#-версией закрыто, остальное совпало само +## 1.11.4 - Electron: пять расхождений с C#-версией закрыто, остальное совпало само -Все 111 правок C#-выпусков 1.12.0—1.23.0 выписаны в список и прогнаны по Electron-версии -пробами на оснастке. Из них 23 требуют слоёв, которых здесь нет вовсе, и одна — командной +Все 111 правок C#-выпусков 1.12.0 - 1.23.0 выписаны в список и прогнаны по Electron-версии +пробами на оснастке. Из них 23 требуют слоёв, которых здесь нет вовсе, и одна - командной ленты вместо PNG-кадров; эти отложены. Из остальных проверено сорок с лишним, и совпало подавляющее большинство: часть этих правил в C#-версию попала как раз отсюда. Пять расхождений закрыто. Проверок: 123 (+29). @@ -685,22 +685,22 @@ Electron — 423 (+33) плюс 17 по настоящему приложени - **Ctrl+C и Ctrl+X без выделения не делали ничего и молчали.** В C#-версии Ctrl+C в этом положении копирует ВЕСЬ холст, а Ctrl+X объясняет, почему так не может: после этого не - осталось бы документа. Здесь обе клавиши были закрыты условием «есть выделение» — и в + осталось бы документа. Здесь обе клавиши были закрыты условием «есть выделение» - и в обработчике клавиш, и в пунктах меню «Правка». Теперь как в C#-версии. - **Штрих, фигура и текст прозрачными чернилами молчали.** Заливка про пустые чернила - говорит с 1.11.3, остальные рисующие — нет. Формулировка на все четыре теперь одна: + говорит с 1.11.3, остальные рисующие - нет. Формулировка на все четыре теперь одна: разные слова для одной и той же причины читались бы как разные причины. - **Вставка на маленький холст ложилась целиком за его краем.** Картинка кладётся с - отступом в двадцать пикселей от угла — так видно, что она лежит поверх, а не приклеена. + отступом в двадцать пикселей от угла - так видно, что она лежит поверх, а не приклеена. На холсте меньше самого отступа (такой остаётся после обрезки до мелочи) он уносил её с холста совсем: Ctrl+V выглядел ничего не сделавшим, а отмена при этом была нужна. Отступ теперь не больше четверти стороны. - **«Создать» наследовал размер холста прежней работы.** Открыл фотографию 4000×3000, - нажал «Создать» — и получил такой же огромный чистый лист; после обрезки до марки, - наоборот, лоскут в полсотни пикселей. Новый документ — это чистый лист, а не старый, + нажал «Создать» - и получил такой же огромный чистый лист; после обрезки до марки, + наоборот, лоскут в полсотни пикселей. Новый документ - это чистый лист, а не старый, залитый белым. - **Цвет пикселя в статусбаре не гас, когда курсор уходил с холста.** Координаты гаснут - прочерком с самого начала, HEX оставался и читался как цвет под курсором — которого на + прочерком с самого начала, HEX оставался и читался как цвет под курсором - которого на холсте уже нет. ### Новое @@ -718,54 +718,54 @@ Electron — 423 (+33) плюс 17 по настоящему приложени округляет угол поворота до 15°; полигон не хватается за угол описанного прямоугольника; подъём выделения у самого края холста не роняет; смена инструмента посреди протяжки не оставляет жест включённым; отмена удаления полигона возвращает холст до пикселя. Все они - теперь стоят проверками в `parity.spec.js` — каждая названа выпуском C#-версии, в котором + теперь стоят проверками в `parity.spec.js` - каждая названа выпуском C#-версии, в котором правило там появилось. - **Две «находки» оказались моими ошибками в пробах, а не дефектами.** Размер текста здесь слушается своего поля, а не общего ползунка толщины (в C#-версии отдельного поля нет, и - правка 1.18.0 была про это). Попадание по повёрнутому объекту считается правильно — + правка 1.18.0 была про это). Попадание по повёрнутому объекту считается правильно - `hitFloating` возвращает имя зоны, а не «да/нет», и проба сравнивала строку с `true`. ### Чего в Electron-версии не будет без переписывания -- **Слои.** Слова «layer» в файле нет ни разу. 23 правки C#-выпусков — про них. -- **Выключатель правки в ленте (C# 1.23.0).** Лента здесь — массив целых PNG-кадров, а не +- **Слои.** Слова «layer» в файле нет ни разу. 23 правки C#-выпусков - про них. +- **Выключатель правки в ленте (C# 1.23.0).** Лента здесь - массив целых PNG-кадров, а не команды с диффами; снимок нельзя «пропустить» при пересборке. -## 1.11.3 — Electron перестал отказывать молча +## 1.11.3 - Electron перестал отказывать молча Первый шаг синхронизации с C#-версией, и взят он не наугад: проверки из 1.11.2 прогнали по -Electron-версии правила, добытые в C#-выпусках 1.12.0—1.23.0. Из шестнадцати применимых -одиннадцать уже соблюдались, а пять провалившихся оказались одной семьёй — «отказ без слов». +Electron-версии правила, добытые в C#-выпусках 1.12.0 - 1.23.0. Из шестнадцати применимых +одиннадцать уже соблюдались, а пять провалившихся оказались одной семьёй - «отказ без слов». Проверок: 94 (+15). ### Портит работу -- **Одиннадцать действий не делали ничего и не говорили почему.** Нажал — не произошло +- **Одиннадцать действий не делали ничего и не говорили почему.** Нажал - не произошло ничего; отличить «не сработало» от «так и задумано» было нельзя. Теперь каждое такое место объясняется: - - Ctrl+C без выделения и Ctrl+X без выделения — разными словами: сказать «копировать + - Ctrl+C без выделения и Ctrl+X без выделения - разными словами: сказать «копировать нечего» на попытку вырезать было бы не про то. - Ctrl+V по пустому буферу. - Delete без выделения. - Заливка с прозрачностью в нуле. Заодно она больше не пишет в ленту. - Увеличение и уменьшение, упёршиеся в предел масштаба: кнопка нажимается, ничего не - меняется — это выглядело поломкой, хотя это потолок. + меняется - это выглядело поломкой, хотя это потолок. - Рамка выделения, обрезки и полигона меньше допустимой. Нижняя граница у рамки разумна, но пока рамка пропадала молча, выделение выглядело сломанным. - Поворот хоткеями «[» и «]» без поднятого объекта. Про эти хоткеи и так знают немногие. - В C#-версии тот же разбор шёл в 1.19.0—1.21.0. + В C#-версии тот же разбор шёл в 1.19.0 - 1.21.0. ### Новое - **Подсказка про отказ.** Строка над статусбаром, гаснет сама через три секунды. Не - модальное окно: «в буфере пусто» не заслуживает того, чтобы его закрывали руками — по той + модальное окно: «в буфере пусто» не заслуживает того, чтобы его закрывали руками - по той же причине WPF-версия показывает подсказку, а не диалог. ### Скрытое -- **Пятнадцать проверок, и половина из них — на обратное.** Мало проверить, что отказ +- **Пятнадцать проверок, и половина из них - на обратное.** Мало проверить, что отказ объяснился; надо проверить и что удавшееся действие молчит. Иначе подсказка начнёт выскакивать на каждое нормальное копирование, и её перестанут читать. - **Что из C#-правил уже соблюдалось.** Текст с переносами строки; текст из одних пробелов @@ -774,28 +774,28 @@ Electron-версии правила, добытые в C#-выпусках 1.12 ним; кадрирование и поворот холста не теряют поднятое; второй подъём не затирает первый; полупрозрачная заливка подмешивается к подложке; Shift держит пропорции. -## 1.11.2 — у Electron-версии появились проверки, и первая же нашла три ошибки +## 1.11.2 - у Electron-версии появились проверки, и первая же нашла три ошибки До сих пор Electron-версию не проверял никто и ничто: четыре с лишним тысячи строк в одном файле, всё состояние в одном объекте, ни одного теста. Синхронизировать её с C#-версией в -таком виде значило переносить правки вслепую — ровно тот способ добавить кучу новых ошибок, +таком виде значило переносить правки вслепую - ровно тот способ добавить кучу новых ошибок, которого просили избежать. Поэтому сначала оснастка. Проверок: 79. ### Портит работу - **Только что запущенная программа считала пустой белый холст изменённым.** Закрыть окно, - ничего не нарисовав, было нельзя без вопроса «сохранить изменения?» — и так с самого + ничего не нарисовав, было нельзя без вопроса «сохранить изменения?» - и так с самого появления этого вопроса. Причина поучительная: в 1.10.0 появилась страховка «если метка «сохранено» осталась в отрезаемом хвосте повтора, сбросить её», с условием - `savedHistoryIndex > historyIndex`. У состояния на старте эти числа — 0 и −1, первый же + `savedHistoryIndex > historyIndex`. У состояния на старте эти числа - 0 и −1, первый же вызов на запуске принимает их за свой случай и уводит метку в −1. Правило верное, применялось на один вызов раньше, чем задумано. - **Правка, не изменившая ни одного пикселя, попадала в ленту.** Прозрачный мазок, фигура - нулевого размера от щелчка без протяжки, заливка тем цветом, что уже под курсором — всё + нулевого размера от щелчка без протяжки, заливка тем цветом, что уже под курсором - всё это давало запись, отмена которой ничего не отменяла. В C#-версии это чинилось в 1.20.0 покомандно: у каждой команды свой `ChangedAnything`, и штрих ради ответа заново сравнивает пиксели. Здесь архитектура сыграла за нас: лента хранит целые PNG-кадры, и «изменилось ли - что-нибудь» — это сравнение строки, которая всё равно уже посчитана для записи. + что-нибудь» - это сравнение строки, которая всё равно уже посчитана для записи. Тонкость в порядке: проверка стоит ДО обрезки хвоста повтора. Иначе пустой жест после отмены отнимал бы возможность повтора, не добавляя ничего взамен. @@ -804,7 +804,7 @@ Electron-версии правила, добытые в C#-выпусках 1.12 - **Оснастка: `tests/` на Playwright.** Страница открывается в Chromium по файловому адресу, мышь водит по холсту по-настоящему, проверки читают пиксели через `getImageData` - и сравнивают целые кадры через `toDataURL`. Настоящий Electron для этого не нужен — + и сравнивают целые кадры через `toDataURL`. Настоящий Electron для этого не нужен - подменяется только мост в него. Запуск: `npm test`, весь набор проходит за 45 секунд. - **79 проверок пятью темами**: лента отмен (что в неё попадает, ходьба, потолки, метка сохранения), инструменты (фигуры, заливка, ластик, маркер, текст, хоткеи), холст (размер, @@ -812,14 +812,14 @@ Electron-версии правила, добытые в C#-выпусках 1.12 объектом, сеанс (сохранение и закрытие). - **Метод тот же, что в C#-версии: пробные проверки.** Пять партий гипотез, около семидесяти штук; подтвердившиеся стали постоянными проверками, остальные удалены. Первая партия дала - три находки, партии со второй по пятую — ни одной. Половина «падений» оказалась ошибками + три находки, партии со второй по пятую - ни одной. Половина «падений» оказалась ошибками в самих гипотезах, а не в приложении: щелчок карандашом законно ставит точку, `clearCanvas` - спрашивает подтверждение, `setCanvasSize` — служебная функция мимо ленты. + спрашивает подтверждение, `setCanvasSize` - служебная функция мимо ленты. - **Одно ограничение оснастки записано прямо в ней**: ровно по границе холста мышь Playwright - в него не попадает — попадание считается по контейнеру. Сам холст такое событие принимает, + в него не попадает - попадание считается по контейнеру. Сам холст такое событие принимает, это проверено отправкой `mousedown` в тот же угол напрямую. Проверки края берут отступ. -## 1.11.1 — фон без пузырей (только Electron-версия) +## 1.11.1 - фон без пузырей (только Electron-версия) Косметика по просьбе: правки касаются ТОЛЬКО Electron-версии, C#-версия остаётся на 1.23.0. Номер патчевый и на своей линии - набор возможностей не менялся ни на одну. diff --git a/paint-pro-electron/docs/ARCHITECTURE.md b/paint-pro-electron/docs/ARCHITECTURE.md index 889f672..ccd457a 100644 --- a/paint-pro-electron/docs/ARCHITECTURE.md +++ b/paint-pro-electron/docs/ARCHITECTURE.md @@ -58,46 +58,46 @@ npm run build-all ``` После `npm run build` в папке `dist/` появится файл: -**`PaintPro-<версия>-portable.exe`** — один самодостаточный файл, ничего не надо +**`PaintPro-<версия>-portable.exe`** - один самодостаточный файл, ничего не надо устанавливать. Версию в имени подставляет `artifactName` из `package.json`, так -что менять её достаточно в одном месте — в поле `version`. +что менять её достаточно в одном месте - в поле `version`. ## Проверки -`tests/` — 335 проверок на Playwright. Страница открывается в Chromium по файловому +`tests/` - 335 проверок на Playwright. Страница открывается в Chromium по файловому адресу, мышь водит по холсту по-настоящему, утверждения читают пиксели через `getImageData` и сравнивают целые кадры через `toDataURL`. Настоящий Electron для этого не нужен: подменяется только мост в него (`tests/harness.js`), всё остальное - то же приложение, что видит пользователь. -- `basics.spec.js` — рисование, отмена, признак несохранённой работы -- `history.spec.js` — лента: что в неё попадает, ходьба по ней, потолки, метка сохранения -- `tools.spec.js` — инструменты, фигуры, заливка, текст, горячие клавиши -- `canvas.spec.js` — размер, повороты, обрезка, открытие файла, масштаб и панорама -- `selection.spec.js` — выделение, буфер, плавающий объект, сохранение и закрытие -- `hints.spec.js` — все места, где действие законно не делает ничего и обязано сказать +- `basics.spec.js` - рисование, отмена, признак несохранённой работы +- `history.spec.js` - лента: что в неё попадает, ходьба по ней, потолки, метка сохранения +- `tools.spec.js` - инструменты, фигуры, заливка, текст, горячие клавиши +- `canvas.spec.js` - размер, повороты, обрезка, открытие файла, масштаб и панорама +- `selection.spec.js` - выделение, буфер, плавающий объект, сохранение и закрытие +- `hints.spec.js` - все места, где действие законно не делает ничего и обязано сказать об этом; и обратная сторона: удавшееся действие молчит -- `parity.spec.js` — правила, добытые в C#-версии: каждая проверка названа выпуском, +- `parity.spec.js` - правила, добытые в C#-версии: каждая проверка названа выпуском, в котором правило появилось там -- `layers.spec.js` — стопка слоёв: устройство, видимость и прозрачность, рисование по +- `layers.spec.js` - стопка слоёв: устройство, видимость и прозрачность, рисование по слоям, порядок, потолок, панель -- `toggle.spec.js` — выключатель правки в ленте: что выключаемо, что делает выключение, +- `toggle.spec.js` - выключатель правки в ленте: что выключаемо, что делает выключение, как это видно в панели -- `fuzz.spec.js` — случайные последовательности правок и инварианты поверх них, включая +- `fuzz.spec.js` - случайные последовательности правок и инварианты поверх них, включая сильнейший: позиция курсора однозначно задаёт документ -- `integration.spec.js` — стыки: слои, лента, буфер, файл и поднятый объект вместе -- `memory.spec.js` — сколько каждая операция просит себе, в долях холста, с потолками -- `appearance.spec.js` — внешний вид: прокрутка панели и читаемость того, что всплывает +- `integration.spec.js` - стыки: слои, лента, буфер, файл и поднятый объект вместе +- `memory.spec.js` - сколько каждая операция просит себе, в долях холста, с потолками +- `appearance.spec.js` - внешний вид: прокрутка панели и читаемость того, что всплывает над холстом -- `theme.spec.js` — пять тем: набор ключей, читаемость в каждой, память выбора -- `wheel.spec.js` — колесо над холстом: размер инструмента, Ctrl под масштаб, прокрутка -- `canvas-handles.spec.js` — восемь ручек холста: смещение рисунка, пределы, отмена -- `web.spec.js` — собранный файл для браузера: работает сам по себе и ничего не тянет из сети -- `gesture.spec.js` — чем жест мышью продолжается и чем кончается: ресайз за направлением +- `theme.spec.js` - пять тем: набор ключей, читаемость в каждой, память выбора +- `wheel.spec.js` - колесо над холстом: размер инструмента, Ctrl под масштаб, прокрутка +- `canvas-handles.spec.js` - восемь ручек холста: смещение рисунка, пределы, отмена +- `web.spec.js` - собранный файл для браузера: работает сам по себе и ничего не тянет из сети +- `gesture.spec.js` - чем жест мышью продолжается и чем кончается: ресайз за направлением мыши, мазок через край холста, подбор жеста, отпускания которого никто не видел -- `right-triangle.spec.js` — прямоугольный треугольник: прямой угол по направлению жеста +- `right-triangle.spec.js` - прямоугольный треугольник: прямой угол по направлению жеста -Отдельно `tests-app/` — проверки НАСТОЯЩЕГО приложения (`npm run test:app`): Playwright +Отдельно `tests-app/` - проверки НАСТОЯЩЕГО приложения (`npm run test:app`): Playwright запускает Electron и выполняет код в main-процессе, подменяя нативные диалоги. Там проверяются запись файлов, вопрос при закрытии, открытие через диалог и клавиатура в той оболочке, где она живёт. Медленные, поэтому отдельной командой. @@ -109,10 +109,10 @@ npm run build-all `npm run build:web` кладёт в `dist/` файл `paint-pro-<версия>-web.html`. Это всё приложение целиком: стили и код внутри, снаружи не подгружается ничего. Его можно переслать, положить на флешку или открыть двойным щелчком на любом устройстве с -браузером — ни установки, ни интернета не нужно. +браузером - ни установки, ни интернета не нужно. Чего в браузере нет по сравнению с установленной версией: нативных диалогов. Открытие -идёт через обычное поле выбора файла, сохранение — скачиванием в папку загрузок, а вопрос +идёт через обычное поле выбора файла, сохранение - скачиванием в папку загрузок, а вопрос про несохранённую работу задаёт сам браузер своими словами. ## Структура проекта @@ -142,7 +142,7 @@ paint-pro-electron/ ## Сохранение: два шага IPC -`saveCanvas()` не может закодировать картинку до того, как узнает расширение — +`saveCanvas()` не может закодировать картинку до того, как узнает расширение - иначе «Сохранить как JPEG» пишет PNG-байты в файл с именем `.jpg`. Поэтому путь и запись разведены: @@ -163,26 +163,26 @@ paint-pro-electron/ ## Прозрачность: одно наложение на мазок -`ctx.globalAlpha` — состояние контекста, а не операции: присвоил и забыл, а оно +`ctx.globalAlpha` - состояние контекста, а не операции: присвоил и забыл, а оно осталось. Инструмент, который писал туда `state.opacity` и не возвращал обратно, -портил всё, что дальше пишется на холст напрямую — отмену, «Очистить холст», +портил всё, что дальше пишется на холст напрямую - отмену, «Очистить холст», поворот, отражение, смену размера, открытие файла. Один Ctrl+Z после мазка с прозрачностью 40% делал весь лист прозрачным на 60%. Поэтому альфы в процессе рисования нет вовсе: -1. `beginPreviewStroke(tool)` — чистит `previewCanvas` и вешает на него CSS +1. `beginPreviewStroke(tool)` - чистит `previewCanvas` и вешает на него CSS `opacity`. Это то, что пользователь видит, пока тянет мышь. 2. Инструмент рисует в `previewCtx` **непрозрачно** (`applyStrokeStyle`, `drawShape`). -3. `mergePreviewStroke(tool)` — переносит буфер на холст одним `drawImage` с +3. `mergePreviewStroke(tool)` - переносит буфер на холст одним `drawImage` с нужной альфой и возвращает `ctx.globalAlpha` обратно в 1. Так работают карандаш, кисть, маркер и все фигуры. Ластик рисует прямо на холсте, но он всегда непрозрачный. Инвариант, который стоит проверять при любой правке: **`ctx.globalAlpha` равен 1 вне пар `save`/`restore`**. -Вторая выгода — та, ради которой через буфер изначально пустили маркер: перекрытия +Вторая выгода - та, ради которой через буфер изначально пустили маркер: перекрытия `round`-cap в стыках сегментов не складываются, и мазок при прозрачности меньше 100% не превращается в цепочку тёмных пятен. У фигуры в режиме «контур + заливка» по той же причине перестала темнеть граница. @@ -206,7 +206,7 @@ paint-pro-electron/ ## Сохранение фиксирует всё незакоммиченное -Плавающий объект живёт на `previewCanvas` **над** холстом, текст — в +Плавающий объект живёт на `previewCanvas` **над** холстом, текст - в `contenteditable` над обоими. `canvas.toDataURL()` не видит ни того, ни другого. Поэтому `saveCanvas` начинается с `commitText()` и `commitFloating()`. @@ -216,21 +216,21 @@ paint-pro-electron/ ## Закрытие окна: кто кого спрашивает -Признак несохранённой работы (`isDirty()`) знает только renderer — это позиция в +Признак несохранённой работы (`isDirty()`) знает только renderer - это позиция в истории против той, что была на момент последнего сохранения, плюс **сдвинутый** floating или открытый редактор текста с набранным текстом. Диалог при этом умеет показывать только main. Отсюда порядок: 1. main по `close` делает `preventDefault()` и шлёт renderer `request-close`. 2. renderer, если сохранять нечего, сразу зовёт `confirmClose()`. -3. Иначе просит `askUnsaved()` — main показывает диалог на три кнопки и - возвращает индекс нажатой. «Отмена» и «не сохранять» — разные ответы, поэтому +3. Иначе просит `askUnsaved()` - main показывает диалог на три кнопки и + возвращает индекс нажатой. «Отмена» и «не сохранять» - разные ответы, поэтому не `confirm()`. 4. По «Сохранить» renderer зовёт `saveCanvas(false)` и отпускает окно, только если та вернула `true`. Отменённый диалог сохранения оставляет окно открытым. На случай, если renderer не ответит вообще (ошибка в скрипте), в main стоит -пятисекундная страховка — иначе приложение стало бы невыключаемым. Снимает её +пятисекундная страховка - иначе приложение стало бы невыключаемым. Снимает её первый же ответ, и первый ответ - это `close-ack` в начале `handleCloseRequest`: renderer, задумавшийся дольше пяти секунд на большом холсте, иначе выглядел бы сломанным, и окно закрывалось бы вместе с работой. @@ -239,13 +239,13 @@ renderer, задумавшийся дольше пяти секунд на бо `ipcRenderer.invoke` отклоняется, если обработчик в main бросил исключение. В renderer результат почти везде ждут без `catch`, поэтому такое отклонение выглядит -как «нажал Открыть, выбрал файл, ничего не произошло» — ни картинки, ни сообщения, +как «нажал Открыть, выбрал файл, ничего не произошло» - ни картинки, ни сообщения, только запись в консоли, которую никто не смотрит. Поэтому обработчики, трогающие файловую систему, ловят ошибку сами и возвращают `{ error }`: так делают `open-file-dialog`, `read-dropped-file` и `write-image`. Вызывающая сторона проверяет поле и показывает `alert`. `lastSavedPath` при этом -ставится только после удачного чтения — иначе Ctrl+S нацелился бы на файл, который +ставится только после удачного чтения - иначе Ctrl+S нацелился бы на файл, который так и не открылся. ## Копия уходит в оба буфера @@ -258,7 +258,7 @@ renderer результат почти везде ждут без `catch`, по ## Действие, не изменившее ни пикселя, не пишется в историю -Запись в истории — не просто строка в списке: `isDirty()` считается по позиции в +Запись в истории - не просто строка в списке: `isDirty()` считается по позиции в ней, и лишняя запись заставляет приложение спрашивать про сохранение после того, что ничего не сделало. Поэтому признак берётся из результата операции, а не из факта вызова обработчика: @@ -275,10 +275,10 @@ renderer результат почти везде ждут без `catch`, по ## История: потолок и по глубине, и по памяти -`MAX_HISTORY` — 150 шагов, но одной глубины мало. Снимки хранятся как PNG в +`MAX_HISTORY` - 150 шагов, но одной глубины мало. Снимки хранятся как PNG в base64, и для холста 4000×3000 это единицы мегабайт на кадр: полтораста таких кладут вкладку задолго до счётчика шагов. Поэтому есть и `MAX_HISTORY_BYTES` -(512 МБ). Самый свежий кадр не выбрасывается никогда — потерять отмену только +(512 МБ). Самый свежий кадр не выбрасывается никогда - потерять отмену только что сделанной правки хуже, чем занять память. При вытеснении старых записей вместе с индексами едет `state.savedHistoryIndex`, @@ -297,7 +297,7 @@ Ctrl+Z и появлением картинки на холсте лежит с Поэтому восстановление запирает холст: `state.restoring` не даёт `onDown` начать жест (штрих всё равно затёрло бы приходящим кадром), а `saveCanvas` ждёт -`restorePending` — без этого Ctrl+S сразу после Ctrl+Z записал бы в файл отменённое. +`restorePending` - без этого Ctrl+S сразу после Ctrl+Z записал бы в файл отменённое. Флаг снимает только самый свежий запрос: несколько быстрых Ctrl+Z дают несколько загрузок, и обогнанный кадр не должен открывать холст посреди следующего. `img.onerror` разбирает флаг так же, как `onload`: повиснуть на битом кадре значило @@ -310,7 +310,7 @@ Ctrl+Z и появлением картинки на холсте лежит с и каждый пиксель прочитается как прозрачный. Рисунок при этом уже потерян, а следующее сохранение запишет пустоту. -Поэтому размер проверяется до присваивания — `canvasSizeAllowed(w, h)`, +Поэтому размер проверяется до присваивания - `canvasSizeAllowed(w, h)`, `MAX_CANVAS_SIDE` = 20000, `MAX_CANVAS_PIXELS` = 120 млн, те же значения, что в WPF-версии. Поле «Размер холста» отказывает с объяснением и возвращает в поля реальный размер. Нижняя граница (`MIN_CANVAS_SIDE` = 10) отказывает так же: раньше @@ -323,24 +323,24 @@ WPF-версии. Поле «Размер холста» отказывает с Рамка выделения, рамка плавающего объекта, кнопки обрезки и редактор текста с тулбаром живут в экранных пикселях, а привязаны к координатам холста. Пересчёт у -всех одинаковый — от `canvas.getBoundingClientRect()`, — и звать их надо одним +всех одинаковый - от `canvas.getBoundingClientRect()`, - и звать их надо одним вызовом `updateOverlays()` из каждого места, где меняется зум, панорама, прокрутка или размер окна. Пока список был скопирован по вызывающим местам, два из них отставали: обработчик -`resize` окна не двигал редактор текста, а про кнопки обрезки не знал никто — их +`resize` окна не двигал редактор текста, а про кнопки обрезки не знал никто - их позиция считалась один раз, при показе, и при первом зуме «Применить / Отмена» уезжали от рамки. ## Размер холста: только через setCanvasSize() -У `` два независимых размера — буферный (`canvas.width`, пиксели +У `` два независимых размера - буферный (`canvas.width`, пиксели картинки) и экранный (`canvas.style.width`). Присвоение `width` сбрасывает буфер, но CSS-размер остаётся прежним, и картинка оказывается растянутой в старую рамку. Зум здесь же: `applyZoom()` выставляет CSS-размер как `canvas.width * state.zoom`. -Поэтому буферный размер меняется ровно в одном месте — `setCanvasSize(w, h)`. +Поэтому буферный размер меняется ровно в одном месте - `setCanvasSize(w, h)`. Она трогает оба канваса (основной и `previewCanvas`, они обязаны совпадать) и сама зовёт `applyZoom()`. Прямых присваиваний `canvas.width` в коде быть не должно: именно из-за них обрезка, поворот, смена размера и открытие файла @@ -350,17 +350,17 @@ WPF-версии. Поле «Размер холста» отказывает с Три способа убрать `state.floating`, и путать их нельзя: -- `commitFloating()` — впечатать в холст. Пишет историю. -- `cancelFloating()` — откатить подъём: возвращает `preCanvas`, то есть холст +- `commitFloating()` - впечатать в холст. Пишет историю. +- `cancelFloating()` - откатить подъём: возвращает `preCanvas`, то есть холст до того, как из-под объекта вырезали пиксели. -- `deleteFloating()` — снять объект, оставив стёртое стёртым. Возвращает +- `deleteFloating()` - снять объект, оставив стёртое стёртым. Возвращает `true`, если холст изменился и нужна запись в историю (у только что вставленной картинки `preCanvas` нет, стирать было нечего). Ctrl+X, Delete и очистка холста хотят именно `deleteFloating`. Пока там стоял `cancelFloating`, вырезание возвращало объект на место вместо удаления. -С клавиатуры: **Enter применяет, Escape отменяет** — как в WPF-версии. Раньше +С клавиатуры: **Enter применяет, Escape отменяет** - как в WPF-версии. Раньше Escape тоже применял, и отказаться от подъёма было нечем, хотя `cancelFloating` ровно для этого и написан. @@ -368,20 +368,20 @@ Escape тоже применял, и отказаться от подъёма б что «клик внутрь выделения, клик мимо» проходил через полный цикл стирания и обратной отрисовки и писал в историю запись «Перемещение», ничего не изменив. Теперь `floatingMoved()` сравнивает геометрию пикапа с той, что запомнил -`rememberFloatingOrigin()` при подъёме, и если ничего не двигали — commit +`rememberFloatingOrigin()` при подъёме, и если ничего не двигали - commit сводится к `cancelFloating()`, то есть холст возвращается прежним до пикселя. Сравнение геометрии, а не флаг «пользователь потащил» в пяти обработчиках drag'а: забытый флаг означает молча потерянную запись в истории. -Рисуется floating всегда через `drawFloatingOnto(ctx)` — он один знает про +Рисуется floating всегда через `drawFloatingOnto(ctx)` - он один знает про поворот и quad-клип. Пока эти ветки были скопированы по коду, о повороте забывали то в пипетке, то в копировании. -## Версия — одна, из package.json +## Версия - одна, из package.json Renderer не может прочитать `package.json` сам: `contextIsolation` на месте, Node в странице нет. Поэтому `app.getVersion()` отдаётся через IPC `app-version`, и подпись -в статусбаре с «О программе» берутся оттуда. В обычном браузере версии просто нет — +в статусбаре с «О программе» берутся оттуда. В обычном браузере версии просто нет - страница показывает «Paint Pro» без номера. Так сделано после того, как «Paint Pro v1.0», вписанное руками в двух местах, diff --git a/paint-pro-electron/docs/DEV_CONTEXT.md b/paint-pro-electron/docs/DEV_CONTEXT.md index 1093077..bba354f 100644 --- a/paint-pro-electron/docs/DEV_CONTEXT.md +++ b/paint-pro-electron/docs/DEV_CONTEXT.md @@ -1,4 +1,4 @@ -# Paint Pro — Dev Context (для переноса стиля и подходов в другие проекты, например калькулятор) +# Paint Pro - Dev Context (для переноса стиля и подходов в другие проекты, например калькулятор) > Цель документа: дать модели в новой сессии всё необходимое, чтобы воссоздать визуальный язык, стек, паттерны UI/UX и архитектуру Paint Pro в другом приложении (например, калькулятор) без переоткрытия дискуссий. @@ -8,14 +8,14 @@ - **Платформа:** Electron 44.4.5 + Node 24.14 / npm 11.9 (до 1.16.1 был Electron 33.4.11: 32 известные уязвимости движка, см. CHANGELOG 1.28.1 / 1.16.1). -- **electron-builder 26.15.3** — Windows portable + NSIS installer (до 1.16.1 - 25.1.8). -- **Один HTML-файл (`paint-pro.html` ≈ 3000+ строк)** содержит CSS + HTML + ванильный JS. Никаких бандлеров, фреймворков, transpile-шага. Это намеренно — приложение «open-and-edit». -- **`main.js`** — создаёт `BrowserWindow`, отключает нативное меню (`Menu.setApplicationMenu(null)` + `setMenuBarVisibility(false)`), обрабатывает `ipcMain.handle('pick-save-path' | 'write-image' | 'clear-save-path' | 'open-file-dialog' | 'read-dropped-file')` и single-instance lock + ассоциации файлов. Сохранение разведено на два вызова специально: renderer должен знать расширение до `toDataURL`, иначе JPEG уезжает в файл PNG-байтами. `clear-save-path` обнуляет `global.lastSavedPath`: без него «Файл → Новый» оставлял документ привязанным к прежней картинке, и Ctrl+S перезаписывал её чистым холстом. -- **`preload.js`** — `contextBridge.exposeInMainWorld('electronAPI', { pickSavePath, writeImage, clearSavePath, openFileDialog, getFilePath, readDroppedFile, onMenuAction, onOpenFile })`. `contextIsolation:true`, `nodeIntegration:false`. -- **`package.json` build-конфиг:** `target: ['portable', 'nsis']`, иконки в `build/icon.ico` + `build/icon.png`. NSIS — `oneClick:false, perMachine:false, allowToChangeInstallationDirectory:true`. +- **electron-builder 26.15.3** - Windows portable + NSIS installer (до 1.16.1 - 25.1.8). +- **Один HTML-файл (`paint-pro.html` ≈ 3000+ строк)** содержит CSS + HTML + ванильный JS. Никаких бандлеров, фреймворков, transpile-шага. Это намеренно - приложение «open-and-edit». +- **`main.js`** - создаёт `BrowserWindow`, отключает нативное меню (`Menu.setApplicationMenu(null)` + `setMenuBarVisibility(false)`), обрабатывает `ipcMain.handle('pick-save-path' | 'write-image' | 'clear-save-path' | 'open-file-dialog' | 'read-dropped-file')` и single-instance lock + ассоциации файлов. Сохранение разведено на два вызова специально: renderer должен знать расширение до `toDataURL`, иначе JPEG уезжает в файл PNG-байтами. `clear-save-path` обнуляет `global.lastSavedPath`: без него «Файл → Новый» оставлял документ привязанным к прежней картинке, и Ctrl+S перезаписывал её чистым холстом. +- **`preload.js`** - `contextBridge.exposeInMainWorld('electronAPI', { pickSavePath, writeImage, clearSavePath, openFileDialog, getFilePath, readDroppedFile, onMenuAction, onOpenFile })`. `contextIsolation:true`, `nodeIntegration:false`. +- **`package.json` build-конфиг:** `target: ['portable', 'nsis']`, иконки в `build/icon.ico` + `build/icon.png`. NSIS - `oneClick:false, perMachine:false, allowToChangeInstallationDirectory:true`. `productName: 'Paint Pro Electron'` и `appId: 'com.paintpro.electron'` отличаются от C#-версии НАМЕРЕННО: пока оба назывались «Paint Pro», установщики шли в одну папку и - затирали друг друга. Трогать `name` в package.json при этом нельзя — из него Electron + затирали друг друга. Трогать `name` в package.json при этом нельзя - из него Electron берёт `%APPDATA%\paint-pro`, где лежит localStorage с выбранной темой. Команды: @@ -26,7 +26,7 @@ npm run build-installer # Paint Pro Electron Setup <версия>.exe --- -## 2. Визуальный язык — Apple Liquid Glass (iOS 26 / macOS Tahoe 26) +## 2. Визуальный язык - Apple Liquid Glass (iOS 26 / macOS Tahoe 26) Главная идея: **полупрозрачные стеклянные панели поверх насыщенного цветного фона, с плавающими «пузырями» и тонкими бликами**. Цвета подсасываются `backdrop-filter: blur(...) saturate(...)` через стекло. @@ -56,7 +56,7 @@ npm run build-installer # Paint Pro Electron Setup <версия>.exe } ``` -### 2.2 Фон-«обои» на body — обязательно цветной +### 2.2 Фон-«обои» на body - обязательно цветной ```css body { @@ -83,7 +83,7 @@ body { border-radius: 18-22px; /* большие радиусы */ box-shadow: var(--glass-shadow), var(--glass-inset); position: relative; - /* overflow:visible — НЕ ставить overflow:hidden, сломает тултипы и выпадайки */ + /* overflow:visible - НЕ ставить overflow:hidden, сломает тултипы и выпадайки */ } ``` @@ -99,7 +99,7 @@ body { .panel > * { position: relative; z-index: 1; } /* контент поверх блика */ ``` -### 2.5 Бегущий блик (shimmer) — только на крупных стационарных панелях +### 2.5 Бегущий блик (shimmer) - только на крупных стационарных панелях ```css .panel-with-shimmer::after { @@ -127,7 +127,7 @@ HTML: ``` @@ -229,7 +229,7 @@ function spawnRipple(target, clientX, clientY) { if (getComputedStyle(target).position === 'static') target.style.position = 'relative'; target.appendChild(r); setTimeout(() => r.remove(), 700); - // ⚠️ НЕ ставим overflow:hidden на target — обрезает тултипы. + // ⚠️ НЕ ставим overflow:hidden на target - обрезает тултипы. // Мягкий radial-fade ripple допустимо чуть выходит за края (выглядит как glow). } document.addEventListener('mousedown', (e) => { @@ -318,7 +318,7 @@ body (flex column, 100vh) └── .statusbar (опционально) ``` -Каждая панель — `margin: 6px-10px`, `border-radius: 18-22px`. Между панелями — узкие зазоры (10px), сквозь которые видны пузыри. +Каждая панель - `margin: 6px-10px`, `border-radius: 18-22px`. Между панелями - узкие зазоры (10px), сквозь которые видны пузыри. ### 3.2 Состояние @@ -330,7 +330,7 @@ let state = { }; ``` -Все мутации — прямой `state.x = y`. UI обновляется явными вызовами `update*()`. +Все мутации - прямой `state.x = y`. UI обновляется явными вызовами `update*()`. ### 3.3 Хоткеи @@ -347,7 +347,7 @@ document.addEventListener('keydown', (e) => { }); ``` -### 3.4 История (undo/redo) — паттерн из Paint Pro +### 3.4 История (undo/redo) - паттерн из Paint Pro ```js state.history = []; @@ -364,14 +364,14 @@ function redo() { if (state.historyIndex < state.history.length-1) { state.histo Если у истории есть потолок и она вытесняет старые записи, то всё, что ссылается на позицию в ней (метка «здесь сохранено», закладки, «вернуться сюда»), обязано жить рядом с самим списком и сдвигаться в той же функции. Копия индекса, лежащая -в другом объекте, после первого же вытеснения начинает указывать не туда — и не +в другом объекте, после первого же вытеснения начинает указывать не туда - и не падает, а тихо врёт. См. антипаттерн 26. Для калькулятора: `serializeState` = `{display, expression, memory}` JSON; `restoreHistory` присваивает обратно и обновляет UI. --- -## 4. Калькулятор в стиле Paint Pro — конкретный план +## 4. Калькулятор в стиле Paint Pro - конкретный план ### 4.1 Структура @@ -381,8 +381,8 @@ body ├── .calc-shell .panel (стеклянная панель ~ 380×600 в центре) │ ├── .calc-header (заголовок + переключатель режимов: Standard / Scientific / Programmer) │ ├── .calc-display .panel (вложенная панель: история сверху мелко, основной результат снизу крупно) -│ ├── .calc-mem-row (M+, M-, MR, MC — узкая строка small glass pills) -│ └── .calc-keys (grid 4–5 колонок) +│ ├── .calc-mem-row (M+, M-, MR, MC - узкая строка small glass pills) +│ └── .calc-keys (grid 4-5 колонок) │ ├── digit btn │ ├── op btn (более яркий, primary градиент на = ) │ └── func btn (sin, cos, log, %) @@ -417,7 +417,7 @@ let state = { }; ``` -Парсинг: **ТОЛЬКО собственный recursive-descent парсер, никогда `eval()`** — eval откроет XSS если поделиться скрином/ссылкой. +Парсинг: **ТОЛЬКО собственный recursive-descent парсер, никогда `eval()`** - eval откроет XSS если поделиться скрином/ссылкой. ```js // Pratt parser или simple shunting-yard. @@ -430,7 +430,7 @@ function evaluate(expr) { } ``` -Округление: `Number(value.toPrecision(12))` — убирает мусор `0.1+0.2=0.30000…04`. +Округление: `Number(value.toPrecision(12))` - убирает мусор `0.1+0.2=0.30000…04`. ### 4.4 Хоткеи для калькулятора @@ -464,14 +464,14 @@ document.addEventListener('keydown', e => { | Из Paint Pro | В калькулятор | |---|---| | Custom menubar (Файл/Правка/Вид) | Меню: View → mode (Standard/Scientific), Edit → Copy result / Paste, History panel toggle | -| Sidebar с настройками | Sidebar с историей вычислений (список последних 50, click — вставить в выражение) | +| Sidebar с настройками | Sidebar с историей вычислений (список последних 50, click - вставить в выражение) | | Тултипы на тулзах | Тултипы на функциональных кнопках (sin → «sin(x), Rad/Deg в зависимости от режима») | -| Хоткеи V/P/B/M/E/G/I/T | Хоткеи Ctrl+H — toggle history, Ctrl+M — memory store/recall и т.д. | -| Размер кисти / ластика раздельно (через slider) | — (н/а) | +| Хоткеи V/P/B/M/E/G/I/T | Хоткеи Ctrl+H - toggle history, Ctrl+M - memory store/recall и т.д. | +| Размер кисти / ластика раздельно (через slider) | - (н/а) | | Undo/Redo (Ctrl+Z/Y) | Undo/Redo для последовательности нажатий: «удалил → undo → вернулась цифра» | | Сохранение PNG | Export history → .txt / .csv | | Электрон-IPC + drag&drop | DnD числа / выражения из буфера, paste из буфера обмена с очисткой нечисловых символов | -| Окно без нативного меню (`Menu.setApplicationMenu(null)`) | Идентично — у нас своё меню в renderer | +| Окно без нативного меню (`Menu.setApplicationMenu(null)`) | Идентично - у нас своё меню в renderer | ### 4.7 Файлы для калькулятора @@ -497,35 +497,35 @@ calc-pro-electron/ 3. **Курсор-пузырь, следующий за мышкой** → выглядит как баг отрисовки, отвлекает. Решение: только ripple на клике, без постоянной линзы. -4. **Inline `style="background:var(--bg-3)"` на кнопках** при смене темы — нужно либо удалять inline, либо перебивать через `.parent button { ... !important }`. Я выбрал второе для быстрого фикса; в новых проектах — не использовать inline-стили вообще. +4. **Inline `style="background:var(--bg-3)"` на кнопках** при смене темы - нужно либо удалять inline, либо перебивать через `.parent button { ... !important }`. Я выбрал второе для быстрого фикса; в новых проектах - не использовать inline-стили вообще. -5. **`buildMenu()` оставлен мёртвым после переключения на custom menu в renderer** — захламляет main.js. +5. **`buildMenu()` оставлен мёртвым после переключения на custom menu в renderer** - захламляет main.js. Решение: удалять сразу. -6. **Присваивать `canvas.width` где попало.** У `` буферный размер (`width`/`height`) и экранный (`style.width`) независимы: присвоение `width` сбрасывает буфер, а CSS-размер остаётся от прошлого состояния, и картинка растягивается в старую рамку. Я сначала залатал это в одном `restoreHistory`, а потом нашёл ещё пять мест с тем же багом (обрезка, поворот, смена размера, два открытия файла). Правильно — одна функция `setCanvasSize(w, h)`, которая меняет буфер и сама зовёт `applyZoom()`, и ни одного прямого присваивания в коде. Общее правило для калькулятора: если у состояния есть «внутреннее» и «показанное» представление, синхронизировать их должна одна функция, а не дисциплина на каждом вызывающем месте. +6. **Присваивать `canvas.width` где попало.** У `` буферный размер (`width`/`height`) и экранный (`style.width`) независимы: присвоение `width` сбрасывает буфер, а CSS-размер остаётся от прошлого состояния, и картинка растягивается в старую рамку. Я сначала залатал это в одном `restoreHistory`, а потом нашёл ещё пять мест с тем же багом (обрезка, поворот, смена размера, два открытия файла). Правильно - одна функция `setCanvasSize(w, h)`, которая меняет буфер и сама зовёт `applyZoom()`, и ни одного прямого присваивания в коде. Общее правило для калькулятора: если у состояния есть «внутреннее» и «показанное» представление, синхронизировать их должна одна функция, а не дисциплина на каждом вызывающем месте. -7. **`eval()` для парсинга выражения** — НИКОГДА. Свой парсер. +7. **`eval()` для парсинга выражения** - НИКОГДА. Свой парсер. -8. **`text-size` input без clamp** — `min`/`max` HTML работают только для стрелок; вводимое руками значение не зажимается. Делать `Math.min(max, Math.max(min, parseInt(v)))` в input listener. +8. **`text-size` input без clamp** - `min`/`max` HTML работают только для стрелок; вводимое руками значение не зажимается. Делать `Math.min(max, Math.max(min, parseInt(v)))` в input listener. -9. **Flood fill без множества посещённых пикселей** — ранний выход `if (target === fill) return` спасает только при непрозрачности 100%. При alpha < 1 и цвете заливки, близком к исходному, смешанный результат остаётся в пределах допуска `colorsMatch`, пиксель снова совпадает с target, соседи кладут его в стек заново — стек растёт бесконечно и приложение зависает. Всегда держать `Uint8Array(w*h)` посещённых. +9. **Flood fill без множества посещённых пикселей** - ранний выход `if (target === fill) return` спасает только при непрозрачности 100%. При alpha < 1 и цвете заливки, близком к исходному, смешанный результат остаётся в пределах допуска `colorsMatch`, пиксель снова совпадает с target, соседи кладут его в стек заново - стек растёт бесконечно и приложение зависает. Всегда держать `Uint8Array(w*h)` посещённых. -10. **`restoreHistory` через `img.onload` без счётчика поколений** — несколько быстрых Ctrl+Z завершаются не в том порядке, на холсте оседает не тот кадр. Инкрементировать `restoreGeneration` на входе и проверять его в `onload`. +10. **`restoreHistory` через `img.onload` без счётчика поколений** - несколько быстрых Ctrl+Z завершаются не в том порядке, на холсте оседает не тот кадр. Инкрементировать `restoreGeneration` на входе и проверять его в `onload`. -11. **`canvas.toDataURL('image/png')` до того, как известно расширение** — «Сохранить как JPEG» пишет PNG-байты под именем `.jpg`. Сначала путь, потом кодирование под его расширение. +11. **`canvas.toDataURL('image/png')` до того, как известно расширение** - «Сохранить как JPEG» пишет PNG-байты под именем `.jpg`. Сначала путь, потом кодирование под его расширение. -12. **Две операции с противоположным смыслом под одним именем.** «Отменить подъём выделения» (вернуть пиксели на место) и «удалить выделение» (оставить дыру) — разные вещи, но обе выглядят как «убрать плавающий объект». Ctrl+X и Delete звали `cancelFloating`, и вырезание возвращало объект обратно вместо удаления. Заводить отдельные функции с говорящими именами (`cancelFloating` / `deleteFloating`), даже если тела почти совпадают. +12. **Две операции с противоположным смыслом под одним именем.** «Отменить подъём выделения» (вернуть пиксели на место) и «удалить выделение» (оставить дыру) - разные вещи, но обе выглядят как «убрать плавающий объект». Ctrl+X и Delete звали `cancelFloating`, и вырезание возвращало объект обратно вместо удаления. Заводить отдельные функции с говорящими именами (`cancelFloating` / `deleteFloating`), даже если тела почти совпадают. -13. **Копипаста ветвления по состоянию объекта.** Блок «нарисуй с поворотом, или с клипом, или просто» был скопирован в трёх местах. Стоило добавить поворот — и про него забыли в пипетке и в копировании: они рисовали неповёрнутый прямоугольник. Один рендер (`drawFloatingOnto`) на все места, где объект попадает на пиксели. То же для «выделить всё», скопированного в пункт меню, хоткей и обработчик IPC. +13. **Копипаста ветвления по состоянию объекта.** Блок «нарисуй с поворотом, или с клипом, или просто» был скопирован в трёх местах. Стоило добавить поворот - и про него забыли в пипетке и в копировании: они рисовали неповёрнутый прямоугольник. Один рендер (`drawFloatingOnto`) на все места, где объект попадает на пиксели. То же для «выделить всё», скопированного в пункт меню, хоткей и обработчик IPC. 14. **Жёсткая подпись по индексу в списке с вытеснением.** Нулевая строка истории подписывалась «Исходное состояние» по `i === 0`, но при переполнении лимита нулевую запись вытесняет обычная правка, и подпись начинает врать. Подпись хранить в самой записи. -15. **Стек обхода из массивов пар (`[[x, y]]`)** в заливке и подобных обходах — на заливке во весь экран это миллионы короткоживущих объектов для сборщика мусора. Плоский массив `[x, y, x, y, ...]` с двумя `pop()` подряд. +15. **Стек обхода из массивов пар (`[[x, y]]`)** в заливке и подобных обходах - на заливке во весь экран это миллионы короткоживущих объектов для сборщика мусора. Плоский массив `[x, y, x, y, ...]` с двумя `pop()` подряд. 16. **Оставлять настройку в разделяемом объекте состояния.** `ctx.globalAlpha` у - `` — состояние контекста, а не операции: инструмент присвоил + `` - состояние контекста, а не операции: инструмент присвоил `state.opacity` и ушёл, а значение осталось висеть. В него потом попадали все - прямые записи на холст — отмена, очистка, поворот, отражение, открытие файла. + прямые записи на холст - отмена, очистка, поворот, отражение, открытие файла. Один Ctrl+Z после мазка с прозрачностью 40% делал весь лист прозрачным на 60%, а «Очистить холст» давал серый вместо белого. Это тот же урок, что и пункт 6 про `canvas.width`, только злее: там разъезжались два представления одного @@ -542,9 +542,9 @@ calc-pro-electron/ сочетание где-то обещано пользователю, оно должно быть заведено. 18. **Экранный редактор поверх масштабируемого холста.** Позиция рамки умножалась - на зум, а размер шрифта — нет, и на 200% буквы в рамке были вдвое мельче тех, + на зум, а размер шрифта - нет, и на 200% буквы в рамке были вдвое мельче тех, что лягут на холст. Масштабировать элемент целиком одним - `transform: scale(zoom)` с `transform-origin: 0 0` — тогда и `padding` + `transform: scale(zoom)` с `transform-origin: 0 0` - тогда и `padding` остаётся в координатах холста, и смещение при печати не надо пересчитывать. 19. **Дробные границы выделения.** Подъём округлял размер снимка, а укладка @@ -557,7 +557,7 @@ calc-pro-electron/ ставились под рамкой выделения в момент появления и больше не пересчитывались: первый же зум или панорама отрывали их от рамки. Всё, что привязано к координатам документа, но живёт в экранных пикселях, пересчитывается по одному - и тому же событию — сводить в одну функцию (`updateOverlays`) и звать её + и тому же событию - сводить в одну функцию (`updateOverlays`) и звать её целиком, а не перечислять оверлеи в каждом обработчике. Список, скопированный в четыре места, отставал в двух. @@ -567,16 +567,16 @@ calc-pro-electron/ запись о перемещении, не изменив ни пикселя. Само по себе это лишь мусор в списке, но как только появился вопрос «сохранить перед выходом?», приложение начало спрашивать на ровном месте. Сравнивать состояние до и после, а не - считать, что раз обработчик вызвался — что-то поменялось. Флаг «пользователь + считать, что раз обработчик вызвался - что-то поменялось. Флаг «пользователь потащил», расставленный по обработчикам drag'а, решает ту же задачу хуже: - забыть его в одном месте — значит молча потерять запись в истории. + забыть его в одном месте - значит молча потерять запись в истории. Второй случай того же нашёлся позже в заливке: `floodFill` выходила сразу, если под курсором уже нужный цвет, а вызывающий код всё равно писал запись. Правило работает только если операция сама возвращает «изменил / не изменил»; пока это решает вызывающая сторона, у каждой операции свой шанс забыть. 22. **Числовое поле без верхней границы.** У поля размера холста стояла только - нижняя проверка (`w < 10`). Лишний ноль при вводе — и `canvas.width = 99999`: + нижняя проверка (`w < 10`). Лишний ноль при вводе - и `canvas.width = 99999`: буфер такого размера браузер не выделяет, но и не сообщает об этом, свойство честно возвращает записанное, а пиксели читаются как прозрачные. Рисунок потерян молча и безвозвратно. Проверять обе границы, и не только на сторону, но @@ -585,13 +585,13 @@ calc-pro-electron/ отказывать, а зажимать: диалог посреди drag'а показывать некуда. 23. **Версия приложения, вписанная в интерфейс строкой.** «Paint Pro v1.0» стояло в - статусбаре и в «О программе» и доехало неизменным до релиза 1.6.0 — при том, что + статусбаре и в «О программе» и доехало неизменным до релиза 1.6.0 - при том, что в `package.json` версия обновлялась каждый раз. Тянуть из единственного источника: в Electron `app.getVersion()` через IPC, в .NET атрибуты сборки. Правило шире номера версии: если значение уже где-то есть, второй его копии в интерфейсе быть не должно. -24. **Убирать «весь белый» вместо «белого фона».** Кеинг прозрачности проходом по всем пикселям пробивает дыры внутри картинки — блик на фото, белую заливку фигуры, — и сквозь них видно нижний слой. Заливка от краёв области внутрь снимает фон вокруг рисунка и не трогает белое внутри. +24. **Убирать «весь белый» вместо «белого фона».** Кеинг прозрачности проходом по всем пикселям пробивает дыры внутри картинки - блик на фото, белую заливку фигуры, - и сквозь них видно нижний слой. Заливка от краёв области внутрь снимает фон вокруг рисунка и не трогает белое внутри. 25. **`dragleave` как сигнал «курсор покинул окно».** Событие стреляет и при переходе между дочерними элементами, поэтому подсветка зоны drop гаснет и залипает как попало. Считать глубину: `dragenter` увеличивает счётчик, `dragleave` уменьшает, гасить на нуле. @@ -599,8 +599,8 @@ calc-pro-electron/ У истории есть потолок по глубине и по памяти, и при переполнении она выбрасывает старые записи, сдвигая курсор вниз. Метка «на этой позиции файл был сохранён» лежала отдельным полем в другом объекте и не сдвигалась. Пока - история короткая, всё сходится; после переполнения курсор перестаёт расти — - каждая новая правка вытесняет одну старую и возвращает его на тот же потолок, — + история короткая, всё сходится; после переполнения курсор перестаёт расти - + каждая новая правка вытесняет одну старую и возвращает его на тот же потолок, - и сравнение «курсор ≠ метка» навсегда даёт «сохранено». Приложение закрывалось без вопроса и уносило всё нарисованное после переполнения. Ошибка тихая вдвойне: она не проявляется ни на одном коротком сценарии и включается ровно тогда, когда @@ -727,14 +727,14 @@ calc-pro-electron/ ## 6. Чеклист «оно ощущается как Apple liquid glass» - [ ] Цветной радиальный фон body (не однотонный). -- [ ] 8–12 фоновых пузырей с `bubbleRise` анимацией. +- [ ] 8-12 фоновых пузырей с `bubbleRise` анимацией. - [ ] Все основные панели: `backdrop-filter: blur(28px) saturate(190%)`. - [ ] Панели имеют `::before` блик сверху и `box-shadow` outer + inner. -- [ ] `border-radius` 14–22px на всём — никаких острых углов. +- [ ] `border-radius` 14-22px на всём - никаких острых углов. - [ ] `.btn:hover` приподнимает на 1px. -- [ ] Активные/primary кнопки — accent-grad + accent-glow. +- [ ] Активные/primary кнопки - accent-grad + accent-glow. - [ ] Ripple на клике. -- [ ] Тултипы — стеклянные тёмные с blur(20px). +- [ ] Тултипы - стеклянные тёмные с blur(20px). - [ ] Стеклянный scrollbar. - [ ] Шрифт SF Pro / -apple-system, цифры с tabular-nums. - [ ] z-index гигиена: пузыри 0, контент 2, dropdowns/tooltips 100. @@ -772,13 +772,13 @@ calc-pro-electron/ } ``` -`main.js` — копия из Paint Pro с заменой имени файла на `calc-pro.html` и упрощением IPC (только save-file для экспорта истории). +`main.js` - копия из Paint Pro с заменой имени файла на `calc-pro.html` и упрощением IPC (только save-file для экспорта истории). --- ## 8. Ссылки на источники -- Apple WWDC 2025 — Liquid Glass design language (iOS 26 / macOS Tahoe 26). -- CSS-tricks: «Getting Clarity on Apple's Liquid Glass» — https://css-tricks.com/getting-clarity-on-apples-liquid-glass/ -- DEV.to: «Recreating Apple's Liquid Glass Effect with Pure CSS» — https://dev.to/kevinbism/recreating-apples-liquid-glass-effect-with-pure-css-3gpl -- Browser support: `backdrop-filter` отлично работает в Electron 44 (так же было и в Electron 33). На Windows hardware acceleration включён по умолчанию — производительность нормальная даже с 12 анимированными пузырями + 4 стеклянными панелями. +- Apple WWDC 2025 - Liquid Glass design language (iOS 26 / macOS Tahoe 26). +- CSS-tricks: «Getting Clarity on Apple's Liquid Glass» - https://css-tricks.com/getting-clarity-on-apples-liquid-glass/ +- DEV.to: «Recreating Apple's Liquid Glass Effect with Pure CSS» - https://dev.to/kevinbism/recreating-apples-liquid-glass-effect-with-pure-css-3gpl +- Browser support: `backdrop-filter` отлично работает в Electron 44 (так же было и в Electron 33). На Windows hardware acceleration включён по умолчанию - производительность нормальная даже с 12 анимированными пузырями + 4 стеклянными панелями.