🧰 CLI

@emailmaker/cli — публичный генератор проектов: внешние плагины и демо-стенды. Работает в интерактивном режиме и с полным набором аргументов командной строки.

Флаги командной строки

Ниже перечислены основные опции, которые доступны пользователю через --help.

--dev / --dev-packages

Самый частый флаг для разработки: в сгенерированном проекте пакеты экосистемы получают dist-tag dev вместо latest. Используйте, когда нужны свежие предрелизные сборки.

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. | | --output-dir | Каталог, куда положить сгенерированный проект. | | --output-base | Базовый каталог: внутри него будет создана папка проекта. | | --force | Разрешить запись в уже существующую директорию. |

Полный список и актуальные значения перечислены в выводе:

npx @emailmaker/cli --help

Что умеет CLI

• интерактивный wizard и неинтерактивный запуск;
• генерация проекта плагина и демо-стендов;
• шаблоны под vite и webpack;
• выбор способа поставки плагина: npm-модуль, браузерный бандл, режим advanced.

Основные режимы

plugin

Внешний плагин: app-часть, sandbox, локальный debug host, базовые скрипты сборки.

demo-stand

Отдельный стенд для интеграции: варианты с OAuth, закрытым контуром, react-adapter и advanced-профилями.

Preset-ы для plugin

• minimal — каркас без React-примера.
• advanced — React UI, ComponentRegistry, примеры панелей и API.

Примеры

С dev-пакетами:

npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --dev --output-dir ./my-plugin

Без dev (стабильные версии из реестра):

npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --output-dir ./my-plugin

После глобальной установки команда может называться emailmaker-cli.

Когда использовать CLI

• быстро создать новый внешний плагин;
• не собирать вручную конфиг vite / webpack;
• получить согласованную структуру app, sandbox и локальной отладки.