@emailmaker/cli

中文文档
1.3.14发布于 2026/11/16CommonJS近 30 天下载 2233

CLI generator for external editor plugins

原始使用文档
文档目录10 节
  1. Флаги командной строки
  2. --dev / --dev-packages
  3. Остальные опции
  4. Что умеет CLI
  5. Основные режимы
  6. plugin
  7. demo-stand
  8. Preset-ы для plugin
  9. Примеры
  10. Когда использовать CLI

🧰 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.
--bundlervite или 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 и локальной отладки.

版本与发布记录

@emailmaker/cli 共发布 69 个版本,首次发布于 2026/03/19;过去 12 个月发布了 69 个版本。

版本发布日期距今
1.3.14latest2026/11/16今天
1.3.11-dev.3dev2026/11/124 天前
1.3.11-dev.22026/11/115 天前
1.3.11-dev.12026/11/106 天前
1.3.102026/11/097 天前
1.3.82026/11/097 天前

其他发布通道:next → 1.1.45-alpha.1,dev → 1.3.11-dev.3。

关于 @emailmaker/cli 的常见问题

@emailmaker/cli 是什么?

CLI generator for external editor plugins

如何安装 @emailmaker/cli?

在项目目录运行 npm install @emailmaker/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 emailmaker-cli,可以用 npx emailmaker-cli 直接运行。

@emailmaker/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/emailmaker__cli 是否存在。

@emailmaker/cli 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@emailmaker/cli 可以商用吗?

@emailmaker/cli 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@emailmaker/cli 的下载量有多少?

根据 npm 官方下载统计,@emailmaker/cli 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,233 次,日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@emailmaker/cli 还在维护吗?

最新版本 1.3.14 发布于 2026/11/16(今天);至今共发布 69 个版本,其中过去 12 个月发布了 69 个;首次发布于 2026/03/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。