@emailmaker/extensions-react 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/index.js

@@ -42,7 +42,7 @@ var l = class e extends a {
 	_injectCallbacks = [];
 	_injections = Object.create(null);
 	_runCallbacks(e) {
-		this._injectCallbacks.forEach((t) => t(e));
+		[...this._injectCallbacks].forEach((t) => t(e));
 	}
 	constructor(e = null) {
 		super(), this._parent = e, e && this.addDisposable(e.onInject((e) => this._runCallbacks(e)));
@@ -63,7 +63,7 @@ var l = class e extends a {
 	}
 	_onInject(e, t, n = new a()) {
 		return n.addDisposable(this.onInject((r) => {
-			e === r && (n.dispose(), t(this.getInstance(r)));
+			e === r && !n.isDisposed() && (n.dispose(), t(this.getInstance(r)));
 		})), this._parent && n.addDisposable(this._parent._onInject(e, t, n)), this.addDisposable(n), n;
 	}
 	getInstance(e, t = !0) {
@@ -386,19 +386,30 @@ var T = new Proxy({}, { get(e, t, n) {
 	forContext() {
 		return this.target().forContext();
 	}
-}, O = v("ComponentRegistry"), k;
-function A(e) {
-	k = e;
+}, O = v("ComponentRegistry"), k = v("ComponentRegistryGate");
+function A() {
+	return T.getOrCreateInstance(k, () => ({ pending: [] }));
 }
-function j(e, t = O) {
+function j(e) {
+	let t = A();
+	t.factory = e;
+	let n = t.pending.splice(0, t.pending.length);
+	for (let e of n) try {
+		e();
+	} catch (e) {
+		console.error("[extensions] deferred UI call failed once the component registry arrived:", e);
+	}
+}
+function M(e, t = O) {
 	let n = T.getInstance(t);
 	if (n) return n;
-	if (!k) throw Error("[extensions] component registry is not loaded yet — UI work starts at init()");
-	return T.getOrCreateInstance(t, k);
+	let r = A().factory;
+	if (!r) throw Error("[extensions] component registry is not loaded yet — UI work starts at init()");
+	return T.getOrCreateInstance(t, r);
 }
 //#endregion
 //#region packages/extensions-core/components/DomComponentRegistry.ts
-var M = class {
+var N = class {
 	_factories = /* @__PURE__ */ new Map();
 	add(e, t) {
 		let n = e;
@@ -409,28 +420,28 @@ var M = class {
 	get(e) {
 		return this._factories.get(e);
 	}
-}, N = v("DomComponentRegistry");
-function P(e, t = N) {
-	return T.getOrCreateInstance(t, () => new M());
+}, P = v("DomComponentRegistry");
+function F(e, t = P) {
+	return T.getOrCreateInstance(t, () => new N());
 }
 //#endregion
 //#region packages/extensions-core/components/ComponentRegistry.ts
-function F(e) {
-	return typeof e == "function";
-}
 function I(e) {
-	return i(e);
+	return typeof e == "function";
 }
 function L(e) {
-	return typeof e == "function" || I(e);
+	return i(e);
 }
 function R(e) {
-	return typeof e == "object" && !!e && "type" in e && "props" in e && !I(e);
+	return typeof e == "function" || L(e);
 }
-function z(e, t) {
+function z(e) {
+	return typeof e == "object" && !!e && "type" in e && "props" in e && !L(e);
+}
+function B(e, t) {
 	return n(e, t);
 }
-function B(t) {
+function V(t) {
 	return class extends e {
 		_ref = r();
 		_instance;
@@ -448,7 +459,7 @@ function B(t) {
 		}
 	};
 }
-var V = class {
+var H = class {
 	_domComponentRegistry;
 	_components = /* @__PURE__ */ new Map();
 	_domAdapters = /* @__PURE__ */ new Map();
@@ -482,26 +493,26 @@ var V = class {
 		t.component = t.replacers.reduce((e, { replacer: t }) => t(e), void 0);
 	}
 	get(e) {
-		if (L(e)) return e;
+		if (R(e)) return e;
 		let t = e, n = this._components.get(t);
 		if (n?.component) return n.component;
 		let r = this._domComponentRegistry.get(e);
 		if (r) {
 			let e = this._domAdapters.get(t);
-			return e || (e = B(r), this._domAdapters.set(t, e)), e;
+			return e || (e = V(r), this._domAdapters.set(t, e)), e;
 		}
 	}
 	_resolveComponentInput(e) {
 		if (e == null) return null;
-		if (typeof e == "number" || typeof e == "boolean" || I(e)) return e;
+		if (typeof e == "number" || typeof e == "boolean" || L(e)) return e;
 		if (typeof e == "string") {
 			let t = this.get(e);
-			return I(t) ? t : t ? z(t) : e;
+			return L(t) ? t : t ? B(t) : e;
 		}
-		if (F(e)) return z(e);
-		if (R(e)) {
+		if (I(e)) return B(e);
+		if (z(e)) {
 			let t = this.get(e.type);
-			return I(t) ? t : t ? z(t, e.props) : null;
+			return L(t) ? t : t ? B(t, e.props) : null;
 		}
 		return null;
 	}
@@ -510,36 +521,36 @@ var V = class {
 	}
 	getReactElement(e) {
 		let r = this._resolveComponentInput(e);
-		return I(r) ? r : typeof r == "string" || r == null || typeof r == "boolean" || typeof r == "number" ? n(t, null, r) : n(t, null);
+		return L(r) ? r : typeof r == "string" || r == null || typeof r == "boolean" || typeof r == "number" ? n(t, null, r) : n(t, null);
 	}
-};
-A(() => new V(P(T, N)));
+}, U = () => new H(F(T, P));
+j(U), T.getOrCreateInstance(O, U);
 //#endregion
 //#region src/plugin/registryId.ts
-var H = "PluginRegistry";
+var W = "PluginRegistry";
 //#endregion
 //#region src/plugin/pluginRegistry.ts
-function U(e = h()) {
-	return e.getOrCreateInstance(H, () => new E());
+function G(e = h()) {
+	return e.getOrCreateInstance(W, () => new E());
 }
-new D(() => U()), v("ELEMENT_INSERT_HTML_PIPELINE"), v("BLOCK_INSERT_HTML_PIPELINE");
+new D(() => G()), v("ELEMENT_INSERT_HTML_PIPELINE"), v("BLOCK_INSERT_HTML_PIPELINE");
 //#endregion
 //#region packages/extensions-core/identifiers/index.ts
-function W(e) {
+function K(e) {
 	return v(e);
 }
-v("extensions.atomsHandlers"), W("HANDLE_ATOM_INSERT"), v("extensions.sandboxExtensions"), v("MESSAGE_SERVICE"), W("SETTINGS_PANEL_EVENT"), W("MODAL_SHOW_EVENT"), W("MODAL_CLOSE_EVENT"), W("MODAL_UPDATE_EVENT");
+v("extensions.atomsHandlers"), K("HANDLE_ATOM_INSERT"), v("HeadlessMode"), v("extensions.sandboxExtensions"), v("MESSAGE_SERVICE"), K("SETTINGS_PANEL_EVENT"), K("MODAL_SHOW_EVENT"), K("MODAL_CLOSE_EVENT"), K("MODAL_UPDATE_EVENT");
 //#endregion
 //#region src/extensions/api/src/index.ts
-function G() {
+function q() {
 	return typeof globalThis.crypto?.randomUUID == "function" ? globalThis.crypto.randomUUID() : `component-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
-function K(e = G()) {
+function J(e = q()) {
 	return e;
 }
-P(T);
+F(T);
 //#endregion
 //#region src/extensions/react/src/index.ts
-var q = j(T);
+var Y = M(T);
 //#endregion
-export { q as ComponentRegistry, K as createComponentIdentifier };
+export { Y as ComponentRegistry, J as createComponentIdentifier };

package/package.json

@@ -5,14 +5,14 @@
   "main": "index.js",
   "types": "types.d.ts",
   "dependencies": {
-    "antd": "^6.3.5",
+    "antd": "^6.4.3",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@emailmaker/emailmaker": "1.1.85-dev.1",
-    "@emailmaker/extensions-app": "1.1.85-dev.1"
+    "@emailmaker/emailmaker": "1.1.85-dev.11",
+    "@emailmaker/extensions-app": "1.1.85-dev.11"
   },
   "name": "@emailmaker/extensions-react",
-  "version": "1.1.85-dev.1"
+  "version": "1.1.85-dev.11"
 }

package/types.d.ts

@@ -322,6 +322,15 @@ interface ISandboxScriptHandle extends IDisposable {
    * lifecycle initialization (`afterInit`).
    */
   readonly ready: Promise<void>;
+  /**
+   * Fires every time the script becomes ready, including the first time.
+   *
+   * The canvas document is recreated for every email, so the script is evaluated again and becomes
+   * ready again — `ready` is a promise and settles only once, for the first canvas. A host that keeps
+   * state in the script subscribes here and sends it again; the editor also replays, on its own, the
+   * last message the host sent to the script after `ready`.
+   */
+  onReady(listener: () => void): IDisposable;
 }
 interface ISandboxScriptApi {
   /**