@emailmaker/emailmaker 1.2.0 → 1.2.5

package/CHANGELOG.md

@@ -6,6 +6,87 @@
 
 ---
 
+## [1.2.5] - 2026-10-28
+
+### Добавлено
+
+- Редактор блока в плагине: `show({ block })` и `showBlock(block, options)` показывают блок,
+  `openBlock(id | блок)` открывает его поверх письма, а `closeBlock()` возвращает к письму — без потери
+  несохранённого и истории отмены. `saveBlock()` сохраняет блок, `getBlockSnapshot()` отдаёт его
+  текущий код без сохранения, `show({ block, reload: true })` перечитывает блок
+- События блока: `handleReadBlock`, `handleOpenBlock`, `handleCloseBlock`, `handleCloneBlock`,
+  `handleBlockInit`, `handleBlockChanged`, `handleSaveBlockButtonClick` (ответ `false` отменяет
+  сохранение), автосохранения и ревизии блока — `handleBlockAutosave`, `handleRemoveBlockAutoSave`,
+  `handleReadBlockRevisions`, `handleReadBlockAutosave`; признак `isNew` у письма и блока
+- Признак `openBlockFromEmailEnabled` (по умолчанию `false`): пункт «Edit block» в библиотеке блоков
+  открывает редактор блока поверх письма
+- Колбэк `handleAnalyticsEvent` — действия пользователя в редакторе для вашей аналитики: сохранение,
+  импорт и экспорт, проверки, предпросмотр, конвертация вёрстки, ИИ. Идентификаторов, имён и текста
+  письма в событиях нет
+- Событие `handleImportValidate` — ошибки разметки импортируемого файла до того, как браузер их
+  молча «починит»; импорт его не ждёт
+- Флаг `saveHotkeyEnabled` (по умолчанию `true`): при `false` Ctrl+S / Cmd+S не сохраняет ни письмо, ни
+  блок
+- Флаг `formButtonFieldInsertImageEnabled` снова показывает «Добавить картинку» в настройках кнопки. В
+  Outlook картинка в кнопке не видна
+- File Manager: флаг `trashSupportsFolders` — если корзина хранилища не умеет папки, удалённая папка
+  попадает в корзину своими файлами плоским списком. «Очистить корзину» работает и у провайдера без
+  `cleanTrash`
+
+### Исправлено
+
+- Набор текста на холсте: быстрая печать вперемешку с Ctrl+Z / Ctrl+Y не теряет буквы; курсор после
+  Enter, отмены, повтора и вставки остаётся на месте правки; ввод поверх выделения и удаление слова не
+  дробят текст и не снимают форматирование; Ctrl+Backspace и Delete удаляют переменную целиком
+- Удаление на холсте: Delete на элементе колонки не стирает соседние, удаление выделенного пункта
+  списка не стирает весь текстовый блок, картинки и кнопки рядом не пропадают; Ctrl+X и «Удалить» из
+  меню браузера убирают текст из письма
+- Вставка из буфера: простой текст сохраняет переводы строк и не выполняет скрипты, повторный Ctrl+V
+  не множит вставку, вставка у края ссылки или переменной ложится снаружи
+- Ссылка на выделении, которое выходит за пределы оформленного куска текста, получает адрес и
+  настройки
+- Отмена и повтор: Ctrl+Y на холсте и в редакторе кода — повтор, как Ctrl+Shift+Z; отмена и повтор из
+  меню браузера идут через историю редактора; после отмены выделение возвращается туда, где было
+- Набранное на холсте не теряется при медленном ответе редактора, сохранение дожидается всех правок
+- Скрипты письма не выполняются повторно при перестройке списков и таблиц и не удаляются фильтром
+- Наведение мыши не сбивает курсор и набор в блоке, где печатают
+- Разбор кода письма: кривые закрывающие теги, одинокий `<`, конструкции `<?…>` и атрибуты таблиц
+  разбираются как в браузере — строки таблиц не выпадают, перевод строки после `<style>` не съедается
+- Изменённые стили попадают в письмо цветами в hex, а не `rgb()`
+- Показ письма в плагине: тема и прехедер из `show()` не перебиваются вёрсткой; повторный `show()` или
+  `reset()` того же письма и показ сохранённого кода не затирают несохранённую правку; `setConfig()`
+  без режима не сбрасывает выбор переключателя
+- Смена письма: история версий, обсуждения, беседа и ответы ИИ прежнего письма не попадают в новое
+- «Сохранить» не выключается на время автосохранения, первое сохранение нового письма не очищает
+  историю отмены; на бесплатном тарифе автосохранение работает и после перехода на другое письмо
+- Генерация письма и картинки ИИ в плагине не крутится бесконечно; тема и прехедер от ИИ попадают в
+  поля шапки
+- Типограф не ломает разметку письма: результат проверяется перед применением, числа и валюта
+  правятся только в тексте
+- Сжатие картинок при загрузке: фото сжимается качеством, а не разрешением; картинка, которая уже
+  укладывается в лимиты, не пережимается
+- Файл картинки, брошенный на картинку, снова её заменяет; «Редактировать» на заглушке картинки
+  открывает загрузку файла
+- Холст переключается вместе с темой интерфейса, «системная» тема следует за ОС и после перезагрузки
+- Импорт письма без `<body>` не роняет холст, теги Word (`<o:p>`) срезаются из темы письма
+- Экспорт для Outlook берёт тему письма в Subject
+- Пустой `<title>` больше не считается ошибкой проверки кода
+- Тексты ошибок сервера приходят на языке интерфейса, а не браузера
+- В Safari часть страницы, которая не загрузилась, загружается повторно без перезагрузки страницы
+- Редактор блоков: настройки кнопки, ссылки и ячейки снова применяются, клик по промежутку колонок не
+  роняет холст, «Объединить блоки» работает, шрифты проекта и AMP сохраняются вместе с блоком
+- File Manager: имя файла в табличном виде не сжимается в столбик на узком экране, неполная очистка
+  корзины не выдаётся за успех
+- Переводы: длительность таймера и повтор «Custom fonts» в русском интерфейсе
+
+### Изменено
+
+- `lockEditor: true` закрывает не только холст и код: неактивны импорт, отмена и повтор, история
+  версий, поля темы и прехедера, ИИ-чат, конвертер вёрстки, аннотации Gmail и переключатель «Шаблон».
+  Кнопки остаются на месте с подсказкой «Только для чтения», методы API работают как раньше
+
+---
+
 ## [1.1.104] - 2026-10-13
 
 ### Добавлено

package/README.md

@@ -558,6 +558,8 @@ HTML-разметка письма.
 | saveHotkeyEnabled                      | Сохранение по Ctrl+S / Cmd+S. `false` отключает его; диалог браузера «Сохранить страницу» всё равно не открывается. | true |
 | commandButtonsEnabled                  | Показ основной и второстепенной кнопки.                                     | true                  |
 |                                        |                                                                             |                       |
+| lockEditor                             | Режим только для чтения: письмо нельзя изменить. Закрывает холст, редактор кода, поля темы и прехедера, импорт, отмену и повтор (кнопки и клавиши), историю версий, настройки письма и UTM-метки, ИИ-чат, конвертер раскладки и аннотации Gmail. Кнопки остаются на месте, но неактивны; иконка ИИ у темы и прехедера скрывается. Методы API (`show`, `setEmail`, отмена через API) не закрываются. Переключается через `setConfig`. | false |
+|                                        |                                                                             |                       |
 | sidePanelFloating                      | Плавающая боковая панель.                                                   | true                  |
 | desktopMobileSwitchRule                | Полоса переключения режимов.                                                | true                  |
 | desktopMobileSwitchPanel               | Панель переключения режимов.                                                | false                 |
@@ -952,6 +954,7 @@ emailmaker.init({
 | `trashPath`                 | `string`  | Путь к корзине/папке для удаленных файлов                   | -            |
 | `tempPath`                  | `string`  | Путь к временной папке для загрузок                         | -            |
 | `useSoftDelete`             | `boolean` | Включить программное мягкое удаление                        | `false`      |
+| `trashSupportsFolders`      | `boolean` | Корзина принимает папки (при `useSoftDelete`)               | `true`       |
 | `ensureFolderTrailingSlash` | `boolean` | Добавлять к путям папок завершающий слэш                    | `true`       |
 | `validateDuplicates`        | `boolean` | Проверка на существование при операциях с файлами и папками | -            |
 
@@ -991,6 +994,7 @@ emailmaker.init({
 ##### Важные примечания
 
 - **Мягкое удаление**: Когда `useSoftDelete=true`, операции удаления перемещают элементы в `trashPath`
+- **Корзина без папок**: Если бэкенд не принимает папки в корзине, задайте `trashSupportsFolders=false`: при удалении папки файлы всего её поддерева переносятся в корзину плоским списком (совпавшее имя получает номер, `photo (1).png`, если реализован `renameItem`), а опустевшие папки удаляются навсегда. Если хоть один файл не перенёсся, папка не удаляется
 - **Корневая папка**: Используйте `rootId` или пустую строку для операций с корневой папкой
 - **Разрешение путей**: `trashPath` и `tempPath` преобразуются в реальные идентификаторы папок
 - **Загрузка по URL**: Должна проверять, существует ли файл уже на текущем сервере