@bitrix/chef
CLI генераторыRUИнструмент разработчика JS-расширений для Bitrix: собирает расширение под платформенную раскладку, гоняет его тесты в настоящем браузере и показывает, из чего вырос бандл. Пришёл на смену устаревшему @bitrix/cli — тот помечен в npm как deprecated, а его репозиторий архивирован.
bitrix-tools
автор
TypeScript
язык
MIT
лицензия
★ 16
GitHub звёзд
Установка
Глобальная установка — единственный способ из документации, запуск через npx там не показан. Требование Node.js 22 жёсткое и записано в самом пакете; у прежнего @bitrix/cli планка была 14.16, поэтому переход с него на рабочей машине часто и упирается в версию Node.
Что он делает
Сборка — это Rollup с Babel и PostCSS: TypeScript из коробки, отбрасывание неиспользуемого кода, минификация, карты кода и генерация файлов типов.
Тесты запускаются не в эмуляции, а в реальном браузере через Playwright, на связке Mocha и Chai; есть режим слежения за файлами, запуск с открытым окном, отбор по имени и отладка. Отдельной командой поднимаются сквозные тесты.
Диагностика показывает дерево зависимостей, размеры бандлов, циклические зависимости и расширения, которые никто не использует. Отдельной командой переводится код с Flow.js на TypeScript — для старых проектов это основная причина вообще ставить инструмент.
Правила на весь проект
У каждого расширения свой файл сборки, а рядом лежит проектный конфиг, где можно запретить командам отдельные опции, задать значения по умолчанию и сделать часть настроек обязательными. Практический смысл: архитектор фиксирует правила один раз, и команда физически не может собрать расширение мимо них.
После настройки расширения импортируются по имени, а не по пути — раскладку путей генерирует сама команда подготовки проекта.
Насколько он живой
Развивается быстро: 55 версий с февраля 2026 года, последняя — 1.21.0 от 10 июля 2026. Репозиторий не архивирован, открытые задачи есть.
Две оговорки. Со дня последнего выпуска прошло около семи недель без новых правок. И аудитория ещё не перешла: за месяц у chef около 622 загрузок против 1057 у устаревшего @bitrix/cli — то есть большинство проектов пока собирается прежним инструментом.
Частые вопросы
Чем @bitrix/chef отличается от @bitrix/cli и надо ли переходить?
@bitrix/cli объявлен устаревшим: его страница в npm несёт пометку deprecated со ссылкой на chef, а репозиторий архивирован. Chef — замена: нативный TypeScript, тесты в реальном браузере через Playwright, диагностика бандлов и перевод кода с Flow.js.
Какая версия Node.js нужна?
Node.js 22 и выше — требование записано в самом пакете и в разделе требований документации, на более старых версиях установка не пройдёт. У прежнего @bitrix/cli планка была 14.16, поэтому переход чаще всего спотыкается именно об это.
Как подключить его к уже существующему проекту?
Поставить глобально и выполнить в корне проекта команду подготовки сборки: она просканирует расширения и сгенерирует раскладку путей и конфиги TypeScript и браузерных целей. После этого расширения импортируются по имени.
Можно ли гонять тесты расширений в настоящем браузере?
Да, это основной режим. Команда подготовки тестов создаёт конфиг Playwright и файл окружения с данными вашей локальной установки Bitrix. Важно: этот файл нельзя коммитить — в нём логин и пароль.