@emailmaker/emailmaker 1.3.4 → 1.3.8

package/CHANGELOG.md

@@ -6,6 +6,64 @@
 
 ---
 
+## [Не выпущено]
+
+### Добавлено
+
+- Кнопка «Начать с пустого письма» на холсте: появляется, когда в письме нечего показать, и возвращает каркас,
+  в который снова можно вставлять блоки
+
+### Изменено
+
+- Письмо со стёртым кодом сохраняется пустым, как любая другая правка: `save()` больше не отказывает с причиной
+  `empty-content`, событие `EMAIL_EMPTY_SAVE_BLOCKED` не приходит, а пустой снимок уходит в автосохранение
+- Новое письмо плагина: `show()` без `code` открывает обновлённый код заготовки, а пустая `subject` заменяется темой
+  «Новое письмо» на языке интерфейса. Эта тема попадает в `<title>` и в `getEmail()`
+- Карточка «Пустой шаблон» создаёт письмо без запроса к серверу и без родительских блоков
+
+## [1.3.5] - 2026-11-03
+
+### Добавлено
+
+- Платформа плагинов, первый этап: `defineCommand`, `defineView`, `domView`, `createSource`, `ok`, `err`
+  и `Arg` в `extensions-api`, службы `Commands` и `Ui`. Плагин добавляет свои команды, пункты и панели на
+  места `toolbar`, `sidebar`, `dialog`, `documentSettings`, `menu:document`, `menu:export`, `menu:view`,
+  `menu:save`, `statusBar` и `notices`
+- Команды редактора для плагинов: `ui.openView`, `ui.closeView`, `document.getSnapshot`, `document.save`
+  (сохраняет так же, как кнопка «Сохранить»); хуки `useCommand`, `useSource`, `useEditor` в
+  `extensions-react`; тестовый набор `extensions-api/testing`
+- Корзина блоков: кнопка «Очистить корзину» для владельца и администратора
+
+### Исправлено
+
+- Копия глобального блока — обычный блок: `handleCloneBlock` получает `code` без `em-block-id` и
+  `em-block-version`, а вставка копии больше не считается вставкой оригинала и не переписывает его.
+  «Создать новый блок» из копии тоже не уносит метку прежнего блока
+- Версия глобального блока: переименование и теги её не сдвигают, поэтому письмо не видит свежий блок
+  устаревшим; `saveBlock()` ставит новую версию
+- «Обновить текущий блок»: блок не из прочитанного списка редактор ищет через `handleReadBlock`, затем в
+  `handleReadBlocks`; не нашёл — отказ `BLOCK_EDITING_ERROR`, и `handleSaveBlock` не получает неполный блок.
+  Если `handleReadBlock` ответил, что блока нет, глобальный блок заводится заново
+- Окно обновления глобальных блоков появляется и при входе через скрытый редактор, а в «Обновлено»
+  считает только реально заменённые вставки; остальное показывает предупреждением
+- Значок глобального блока на холсте выглядит как значки устройств и не ломает надпись «Вставить сюда»
+- Новое письмо без правок снова создаётся через 10 секунд, а не через интервал `autosaveTimeout`
+- ESM-пакет: webpack больше не пишет «Critical dependency» и его dev-сервер не закрывает страницу окном
+  предупреждений
+- Скрипт интегратора в песочнице: `App` из `extensions-sandbox` не падает с ошибкой «App not registered
+  in DI container»
+- `ModalApi`: `update()` меняет открытое окно (раньше вызов не действовал), а то, что не передали, остаётся
+  прежним; `onClose` срабатывает и при закрытии крестиком, и через `close(id)`
+- Шаблоны плагина в CLI: стенд разработки и шаблон `minimal` не тянут React, проект проходит `tsc`,
+  демо-письмо стенда не вызывает запросы истории с ответом 404
+
+### Изменено
+
+- Создание письма автосохранением приходит в `source` как `AUTOSAVE`. Раньше `source` был пустым: если вы
+  узнавали такое создание по пустому значению, обновите проверку
+
+---
+
 ## [1.2.5] - 2026-10-28
 
 ### Добавлено

package/README.md

@@ -111,6 +111,25 @@ export default defineConfig({
 
 Имя класса Webpack-плагина строится из имени приложения в `package.json` (для **`@emailmaker/emailmaker`** это **`EmailmakerWebpackPlugin`**).
 
+## Кеширование после обновления пакета
+
+Плагин сборки копирует статику пакета в вашу сборку, и раздаёт её ваш сервер. Чтобы после обновления
+пакета пользователи сразу получали новую версию, без сброса кеша браузера, разделите файлы на два вида.
+
+| Файлы | `Cache-Control` | Почему |
+| --- | --- | --- |
+| С хешем в имени: **`emailmaker-core.<hash>.js`**, **`emailmaker-po.<hash>.js`**, **`static/**/<hash>.js`**, **`iframe/iframe.<hash>.html`**, **`iframe/js/*.<hash>.js`**, **`static/media/*.<hash>.*`** | `public, max-age=31536000, immutable` | Новое содержимое приходит под новым именем, старое можно держать сколько угодно. |
+| Без хеша: **`emailmaker.js`**, **`emailmaker-esm.js`**, **`compat-globals.js`**, **`iframe/js/boot-guard.js`**, **`iframe/css/*.css`** и остальные | `no-cache` | Имя одно на все версии. Браузер хранит файл, но перед использованием сверяет его с сервером: если он не менялся, ответ — короткий `304`. |
+| Ваши HTML-страницы с редактором | `no-cache` | Страница должна подхватывать новый вход редактора. |
+
+Хеш — это 8 шестнадцатеричных символов (`.f9289386.`, 20 — у картинок и шрифтов) или 8 символов base64
+в каталогах **`static/*`** и **`iframe/js`** (`DS2seoW7.js`). Другие восьмибуквенные имена (`Checkbox.js`) — не хеш.
+
+Не ставьте долгий `max-age` или `expires` на файлы без хеша. Закешированный **`emailmaker.js`** ссылается
+на ядро и чанки своей версии: после обновления браузер будет запускать старый редактор, а если старые
+файлы удалены — получит ошибки загрузки. Если вход **`emailmaker-esm.js`** собирает ваш сборщик,
+имя ему даёт он — тогда правило касается только скопированной статики.
+
 # Инициализация
 
 Импортируйте плагин в коде приложения:
@@ -593,6 +612,7 @@ HTML-разметка письма.
 | blocksEmptyEnabled                     | Показ пустых блоков.                                                        | true                  |
 | blocksSavedEnabled                     | Показ сохранённых блоков.                                                   | true                  |
 | blocksCommonEnabled                    | Показ общих блоков.                                                         | true                  |
+| blocksCommonSource                     | Откуда брать общие блоки при хранении блоков на Go, если `handleReadCommonBlocks` ничего не вернул: `gallery` — галерея продукта, `project` — блоки проекта, к которому привязан ключ плагина (только вставка). | gallery               |
 | blocksTemplateEnabled                  | Показ блоков шаблона.                                                       | true                  |
 | blocksSearchEnabled                    | Показ поиска по блокам.                                                     | true                  |
 | blocksAddPanelEnabled                  | Показ панели добавления блока в визуальном редакторе.                       | true                  |