@emailmaker/extensions-sandbox 1.0.111-dev.6 → 1.0.111-dev.7

package/README.md

@@ -192,8 +192,8 @@ module.exports = {
 
 Нужна только для продвинутой интеграции или собственного бандлерного пайплайна. Основной сценарий для внешнего плагина — отдельный пакет с `PluginDev`.
 
-- `resolve.alias`: `react` → `@emailmaker/emailmaker/runtime/react` (и т.д.) для `esm` / dev; локальные shared internals идут через compat facades runtime
-- `externals`: `@emailmaker/emailmaker/runtime/core`, runtime npm-модули и `@emailmaker/ui-kit`
+- `resolve.alias`: `react` → `@emailmaker/emailmaker/runtime/react` (и т.д.) для `esm` / dev; локальные shared internals идут через compat facades runtime; UI-kit (`@emailmaker/ui-kit`) → **`@emailmaker/emailmaker/ui-kit`** (singleton bytes на main, не `runtime/@scope/ui-kit`)
+- `externals`: `@emailmaker/emailmaker/runtime/core`, runtime npm-модули; ui-kit external → **`@emailmaker/emailmaker/ui-kit`** (глобальный ключ `UiKit` в `runtimeExports`, см. манифест)
 - Список модулей: `@emailmaker/emailmaker/runtime/plugin-dev-manifest.json` → `runtimeModules`
 
 Если release bundle неожиданно стал толстым или target `встраиваемый bundle` не загружается, начните с раздела `Troubleshooting`.
@@ -504,6 +504,21 @@ panel.showSettingsPanel({
 });
 ```
 
+#### `instanceKey` (идентификатор экземпляра панели)
+
+По умолчанию **каждый** вызов `showSettingsPanel` получает новый `instanceKey`, и хост **перемонтирует** React-компонент панели. Это нужно при переключении между несколькими экземплярами одного блока в письме (две карточки товара с одним `ComponentId`).
+
+Передайте стабильный `instanceKey` только если нужно **обновлять props без remount** и сохранять внутреннее состояние панели (скролл, фокус, черновик формы):
+
+```ts
+panel.showSettingsPanel({
+  instanceKey: blockUuid,
+  content: { type: 'SettingsPanelId', props: { blockUuid, settings } },
+});
+```
+
+Не вызывайте `closeSettingsPanel` перед `showSettingsPanel` при переключении между экземплярами — достаточно одного `showSettingsPanel` с новыми `props`.
+
 Примерная последовательность процесса взаимодействия sandbox и app:
 1. Обработчик клика в sandbox
 2. Отправка события в app через MessageService
@@ -725,6 +740,10 @@ settingsPanel.showSettingsPanel({
 
 ## 🎨 UI Kit
 
+### ColorPicker — минимальный пример
+
+Растягивается на ширину родителя (Form.Item, колонку и т.д.) — дополнительный inline-style для ширины не нужен.
+
 ```tsx
 import { EmIcons, ColorPicker } from "@emailmaker/ui-kit";
 
@@ -734,6 +753,18 @@ import { EmIcons, ColorPicker } from "@emailmaker/ui-kit";
 />
 ```
 
+### FormColorField — рекомендуется для settings panel
+
+Микролейбл + `Form.Item` + color picker — тот же паттерн, что в панелях редактора. Используйте внутри `Form` с полем `name`.
+
+```tsx
+import { Form, FormColorField } from "@emailmaker/ui-kit";
+
+<Form layout="vertical">
+  <FormColorField name="bgColor" label="Цвет фона" />
+</Form>
+```
+
 
 ---
 

package/index.js

@@ -60,7 +60,7 @@ var t = e("SandboxApp"), n = e("IframePluginRegistry");
 			n.packages[e.id] = e, n.validateAll();
 		}, t.__compat.registerPackage({
 			id: "extensions-sandbox",
-			version: "1.0.111-dev.6",
+			version: "1.0.111-dev.7",
 			requires: { host: "^1.0.105" }
 		});
 	}
@@ -71,11 +71,9 @@ function r() {
 function i() {
 	let e = r();
 	if (!e) throw Error("Sandbox not initialized. Make sure sandbox bootstrap is loaded first.");
-	let i = e.getInstance(t);
-	if (!i) throw Error("App not registered in DI container.");
-	let o = e.getInstance(n);
-	if (!o) throw Error("PluginRegistry not registered in DI container.");
-	return a(i, o);
+	let n = e.getInstance(t);
+	if (!n) throw Error("App not registered in DI container.");
+	return a(n, l());
 }
 function a(e, t) {
 	return {
@@ -96,14 +94,20 @@ function a(e, t) {
 		}
 	};
 }
-var o = i();
+var o;
 function s() {
+	return o ||= i(), o;
+}
+var c = new Proxy({}, { get(e, t, n) {
+	let r = s(), i = Reflect.get(r, t, n);
+	return typeof i == "function" ? i.bind(r) : i;
+} });
+function l() {
 	let e = r();
 	if (!e) throw Error("Sandbox not initialized.");
 	let t = e.getInstance(n);
 	if (!t) throw Error("PluginRegistry not registered in DI container.");
 	return t;
 }
-var c = s();
 //#endregion
-export { t as APP_ID, o as App, n as IFRAME_PLUGIN_REGISTRY_ID, s as getPluginRegistry, c as pluginRegistry };
+export { t as APP_ID, c as App, n as IFRAME_PLUGIN_REGISTRY_ID, l as getPluginRegistry };

package/package.json

@@ -5,5 +5,5 @@
   "main": "index.js",
   "types": "types.d.ts",
   "name": "@emailmaker/extensions-sandbox",
-  "version": "1.0.111-dev.6"
+  "version": "1.0.111-dev.7"
 }