@emailmaker/extensions-sandbox 1.1.85-dev.1 → 1.1.85-dev.11

package/README.md

@@ -340,6 +340,18 @@ import { ComponentRegistry } from '@emailmaker/extensions-react';
 Лечится добавлением `PluginDev` в конфигурацию сборки плагина (`externals: 'esm'`) либо сборкой
 плагина на глобалах.
 
+## Ваши настройки резолва редактора не касаются
+
+Внутри пакета React адресуется **путём** к копии, которая лежит в нём же, а не именем `react`.
+Следствий два, и оба в вашу пользу:
+
+- `resolve.dedupe`, `resolve.alias`, `resolve.modules` и Module Federation `shared` работают у вас
+  так, как вы их написали. Мы не занимаем имя `react` и ничего у вас не перехватываем.
+- Редактор не зависит от того, что вы с этим именем делаете: своя копия достаётся ему при любой
+  конфигурации сборки, в том числе если наш плагин у вас не подключён.
+
+Одно исключение — `sharedReact` ниже: им вы просите обратного.
+
 ## Общий React (необязательно)
 
 Плагин хоста умеет обратное: отдать редактору **ваш** React вместо вендоренного —
@@ -866,6 +878,22 @@ App.registerPlugin('MyPluginSandbox', MyPluginSandbox);
 
 > ⚠️ Sandbox работает в изолированном iframe. React-компоненты здесь недоступны — только нативный DOM.
 
+### Скрипт живёт одно письмо
+
+Документ холста пересоздаётся на каждое письмо: скрипт песочницы выполняется заново, и ничего из
+прошлого письма в нём не остаётся. `handle.ready` — обещание, оно разрешается один раз, для первого
+холста. Чтобы узнавать о готовности каждый раз, подпишитесь на `onReady`:
+
+```ts
+const script = sandboxApi.registerSandboxScript(url);
+script.onReady(() => {
+  messageService.send('my-plugin:settings', mySettings);
+});
+```
+
+Последнее, что вы отправили скрипту после его готовности, редактор повторяет в новый холст сам —
+по каждому ключу сообщения. `onReady` нужен для состояния, которое вы считаете заново.
+
 
 ### MessageService (внутри sandbox)
 
@@ -978,6 +1006,20 @@ import { Form, FormColorField } from "@emailmaker/ui-kit";
 </Form>
 ```
 
+### Значки
+
+Значки ui-kit берите по одному из подпути `icons` — в сборку плагина попадут только те, что вы
+используете. В release-сборке этот путь уходит на `@emailmaker/emailmaker/ui-kit/icons` хоста.
+
+```tsx
+import { AIRequests, Sun } from "@emailmaker/ui-kit/icons";
+
+<AIRequests />
+```
+
+`<EmIcons icon="Sun" />` тоже работает, но подтягивает весь каталог значков и пишет в консоль
+предупреждение.
+
 
 ---
 

package/package.json

@@ -5,5 +5,5 @@
   "main": "index.js",
   "types": "types.d.ts",
   "name": "@emailmaker/extensions-sandbox",
-  "version": "1.1.85-dev.1"
+  "version": "1.1.85-dev.11"
 }