@emailmaker/emailmaker 1.3.5 → 1.3.8

package/CHANGELOG.md

@@ -6,6 +6,21 @@
 
 ---
 
+## [Не выпущено]
+
+### Добавлено
+
+- Кнопка «Начать с пустого письма» на холсте: появляется, когда в письме нечего показать, и возвращает каркас,
+  в который снова можно вставлять блоки
+
+### Изменено
+
+- Письмо со стёртым кодом сохраняется пустым, как любая другая правка: `save()` больше не отказывает с причиной
+  `empty-content`, событие `EMAIL_EMPTY_SAVE_BLOCKED` не приходит, а пустой снимок уходит в автосохранение
+- Новое письмо плагина: `show()` без `code` открывает обновлённый код заготовки, а пустая `subject` заменяется темой
+  «Новое письмо» на языке интерфейса. Эта тема попадает в `<title>` и в `getEmail()`
+- Карточка «Пустой шаблон» создаёт письмо без запроса к серверу и без родительских блоков
+
 ## [1.3.5] - 2026-11-03
 
 ### Добавлено

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                  |