@emailmaker/emailmaker 1.1.85-dev.6 → 1.1.85-dev.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/README.md +14 -4
  2. package/{emailmaker-core.fd7c3ffe.js → emailmaker-core.8402bf20.js} +31 -31
  3. package/emailmaker-esm.js +10 -10
  4. package/{emailmaker-po.fd7c3ffe.js → emailmaker-po.8402bf20.js} +1 -1
  5. package/emailmaker.d.ts +26 -6
  6. package/emailmaker.js +11 -11
  7. package/iframe/.vite/manifest.json +4 -4
  8. package/iframe/js/{discussHandlers.Clc2uPQ5.js → discussHandlers.DO8E9IM3.js} +2 -2
  9. package/iframe/js/iframe-eblock.body.js +1 -1
  10. package/iframe/js/iframe-eblock.js +1 -1
  11. package/iframe/js/iframe.body.js +2 -2
  12. package/iframe/js/iframe.js +1 -1
  13. package/node_modules/@emailmaker/ui-kit/package.json +1 -1
  14. package/package.json +2 -2
  15. package/runtime/react/index.js +1 -1
  16. package/static/core/{af5819b6.js → 147d6029.js} +1 -1
  17. package/static/core/{ad7afbf4.js → 48cd36c4.js} +2 -2
  18. package/static/core/{d240cf62.js → 6996109c.js} +3 -3
  19. package/static/core/{7010b77d.js → 7916de44.js} +1 -1
  20. package/static/core/{48270509.js → 99c5ef1b.js} +2 -2
  21. package/static/umd-runtime/runtime.js +1 -1
  22. /package/iframe/{iframe-eblock.fd7c3ffe.html → iframe-eblock.8402bf20.html} +0 -0
  23. /package/iframe/{iframe.fd7c3ffe.html → iframe.8402bf20.html} +0 -0
package/README.md CHANGED
@@ -214,10 +214,13 @@ const editor = emailmaker.create({
214
214
  await editor.ready;
215
215
  ```
216
216
 
217
- Ручку можно сразу положить в своё хранилище, подписаться на события или вызвать `destroy()`. До
218
- `ready` она ведёт себя так:
217
+ Ручку можно сразу положить в своё хранилище, подписаться на события или вызвать `destroy()`.
219
218
 
220
- | что | до готовности |
219
+ Ручка привязывается к редактору, как только он собран, — ещё до показа письма из `content`: так
220
+ вызовы из обработчиков (как `compileEmail()` выше) доходят до редактора. После привязки все вызовы
221
+ идут прямо в редактор. До привязки ручка ведёт себя так:
222
+
223
+ | что | до привязки |
221
224
  | --- | --- |
222
225
  | подписки `handle*` | запоминаются и цепляются до первого события — ничего не теряется |
223
226
  | асинхронные методы (`show`, `compileEmail`, `getEmailSnapshot`, …) | ждут готовности и выполняются |
@@ -231,6 +234,13 @@ await editor.ready;
231
234
  редактора. Если узел уже переиспользовал другой владелец, `destroy()` прежнего редактор не трогает —
232
235
  забирает только свои подписки.
233
236
 
237
+ Между привязкой и `ready` письмо может быть ещё не показано. Если нужен именно показанный документ —
238
+ например, снимок `getEmailSnapshot()`, — дождитесь `ready`.
239
+
240
+ Второй `create()` или `init()` в тот же узел, пока первый ещё стартует, дожидается первого и
241
+ переиспользует его редактор со своими опциями: оба вызова завершаются успешно, редактор принадлежит
242
+ последнему.
243
+
234
244
  Ошибка инициализации приходит отказом `ready`. Если ручку создали, а `ready` не ждут, такая ошибка
235
245
  всплывёт в консоли как необработанная — это намеренно: иначе о том, что редактор не поднялся, не
236
246
  узнать. Исключение — `destroy()` до готовности: этот отказ ожидаемый и не шумит.
@@ -620,7 +630,7 @@ emailmaker.init({
620
630
  | handleSaveButtonClick | Клик по основной кнопке (например «Сохранить»). |
621
631
  | handleNextButtonClick | Клик по «Далее». |
622
632
  | handlePreviousButtonClick | Клик «Назад» в шапке. |
623
- | handleEmailInit | Инициализирован контур письма. |
633
+ | handleEmailInit | Письмо показано на холсте. Приходит на каждое наполнение холста новым содержимым — при старте и при каждом `show()` с другим письмом; повтор того же показа и перезаливка холста события не дают. Однократные действия («сохранить при первом открытии») на нём не стройте. |
624
634
  | handleEmailChanged | Изменился параметр письма. |
625
635
  | handleHtmlChanged | Изменился HTML-код. |
626
636
  | handleSubjectChanged | Изменилась тема (особая подпись — см. типы). |