@emailmaker/extensions-sandbox 0.9.0-dev.3 → 0.9.0-dev.5

package/README.md

@@ -901,71 +901,89 @@ settingsPanel.showSettingsPanel({
 
 # 🧰 CLI
 
-`@emailmaker/cli` — публичный генератор проектов для внешних плагинов и demo-стендов.
+`@emailmaker/cli` — публичный генератор проектов: внешние плагины и демо-стенды. Работает в интерактивном режиме и с полным набором аргументов командной строки.
 
-## Что умеет CLI
+## Флаги командной строки
 
-- интерактивный wizard
-- неинтерактивный запуск через аргументы командной строки
-- генерация plugin-проекта
-- генерация stand / stand-closed сценариев
-- шаблоны под `vite` и `webpack`
-- выбор target-а для внешнего плагина: `npm-пакет`, `встраиваемый bundle`, `advanced`
+Ниже — опции, которые отражены в справке CLI (`--help`). Скрытые или служебные поля (монорепозиторий, отладка шаблонов) здесь не перечисляются.
 
-## Основные режимы
+### `--dev` / `--dev-packages`
 
-### `plugin`
+**Самый частый флаг для разработки:** подставляет **dev**-версии внутренних npm-пакетов (`@emailmaker/*`), которые в шаблонах задаются с dist-tag `dev` вместо `latest`. Используйте, когда нужны свежие предрелизные сборки экосистемы.
+
+```bash
+npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --dev --output-dir ./my-plugin
+```
+
+Короткая форма: `--dev` (эквивалент `--dev-packages`).
+
+### Остальные опции
+
+| Флаг | Назначение |
+|------|------------|
+| `--interactive` | Запустить интерактивный мастер (шаги вместо обязательных аргументов). |
+| `--package-name` | Явное имя npm-пакета для генерируемого плагина. |
+| `--kind` | Режим: `plugin` или `demo-stand`. |
+| `--stand-mode` | Сценарий стенда: `oauth`, `closed-loop`, `react-adapter`, `advanced` (и связанные варианты). |
+| `--advanced-profile` | Для `--stand-mode advanced`: `subpath`, `shadow-dom`, `umd`. |
+| `--preset` | Шаблон плагина: `minimal` или `advanced`. |
+| `--bundler` | `vite` или `webpack` — сборщик в шаблоне. |
+| `--target` | Поставка плагина: `npm-package`, `browser`, `advanced`. |
+| `--advanced-target` | Доп. цель для режима `advanced` (только webpack), см. справку CLI. |
+| `--app` | Идентификатор приложения (`REACT_APP_NAME`), как в монорепозитории; в опубликованном CLI может быть скрыт. |
+| `--output-dir` | Каталог, куда положить сгенерированный проект. |
+| `--output-base` | Базовый каталог: внутри него будет создана папка проекта. |
+| `--force` | Разрешить запись в уже существующую директорию. |
 
-Генерирует внешний плагин с:
+Полный список и актуальные значения перечислены в выводе:
 
-- app-частью
-- sandbox-частью
-- local debug host
-- базовой сборкой и scripts
+```bash
+npx @emailmaker/cli --help
+```
 
-### `stand`
+## Что умеет CLI
 
-Генерирует тестовый стенд с API и OAuth.
+- интерактивный wizard и неинтерактивный запуск;
+- генерация проекта плагина и демо-стендов;
+- шаблоны под **vite** и **webpack**;
+- выбор способа поставки плагина: npm-модуль, браузерный бандл, режим **advanced**.
 
-### `stand-closed`
+## Основные режимы
 
-Генерирует стенд для замкнутого контура (`standaloneKey`).
+### `plugin`
 
-## Preset-ы для plugin
+Внешний плагин: app-часть, sandbox, локальный debug host, базовые скрипты сборки.
 
-### `minimal`
+### `demo-stand` (в т.ч. `stand`, `stand-closed` в документации)
 
-Минимальный каркас:
+Отдельный стенд для интеграции: варианты с OAuth, закрытым контуром, react-adapter, advanced-профили.
 
-- `pluginRegistry`
-- базовая app/sandbox связка
-- без React UI примера
+## Preset-ы для `plugin`
 
-### `advanced`
+- **`minimal`** — каркас без React-примера.
+- **`advanced`** — React UI, `ComponentRegistry`, примеры панелей и API.
 
-Расширенный пример:
+## Примеры
 
-- React UI
-- `ComponentRegistry` из `@emailmaker/extensions-react`
-- пример регистрации panel/icon
-- пример `SettingsPanelApi` и `MessageService`
+С **dev**-пакетами:
 
-## Пример запуска
+```bash
+npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --dev --output-dir ./my-plugin
+```
+
+Без dev (стабильные версии из реестра):
 
 ```bash
-npx @emailmaker/cli my-plugin --preset advanced --bundler vite --target npm-package --output-dir ./my-plugin
+npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --output-dir ./my-plugin
 ```
 
-После глобальной установки команда будет называться `emailmaker-cli`.
+После глобальной установки команда может называться `emailmaker-cli`.
 
 ## Когда использовать CLI
 
-CLI нужен, если вы хотите:
-
-- быстро стартовать новый внешний плагин
-- не собирать вручную `vite`/`webpack` конфиг
-- сразу получить готовую структуру проекта
-- получить рабочий пример app, sandbox и локальной отладки
+- быстро создать новый внешний плагин;
+- не собирать вручную конфиг **vite** / **webpack**;
+- получить согласованную структуру app, sandbox и локальной отладки.
 
 
 ---

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: "0.9.0-dev.3",
+			version: "0.9.0-dev.5",
 			requires: { host: "^1.0.105" }
 		});
 	}

package/package.json

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