Валидатор конфигурации Rollup

Rollup — современный высокопроизводительный сборщик модулей JavaScript, который ценят авторы библиотек и разработчики фреймворков за компиляцию кода в чистые, готовые к распространению форматы. В отличие от более крупных сборщиков приложений, Rollup ориентирован на спецификацию ES-модулей (ESM) и предлагает продвинутый tree-shaking, удаляющий неиспользуемый код (dead code elimination) для минимального размера бандла.

Поскольку Rollup очень гибок, его файлы конфигурации (обычно rollup.config.js или rollup.config.mjs) часто становятся сложными. Они координируют несколько точек входа, объявляют разные форматы вывода (ESM, CommonJS, UMD, IIFE), задают внешние зависимости и настраивают цепочки плагинов (Babel, TypeScript, минификаторы).

Опечатки в ключах опций, несогласованные объявления формата или конфликтующие директивы вывода ломают конвейер сборки, приводя к ошибкам CI/CD или сломанным релизам. Наш бесплатный валидатор даёт быструю и безопасную площадку в браузере для проверки схемы перед сборкой.

Наш валидатор сверяет ваши настройки Rollup с официальной спецификацией конфигурации и проверяет следующие параметры:

• Определение входных данных (input): Rollup должен видеть входные файлы. Директива input должна быть строкой пути (например, "src/index.js"), массивом путей или объектом, сопоставляющим имена с путями для сборок с несколькими точками входа.
• Блоки вывода (output): параметры вывода определяют, как выдаются бандлы. Валидатор проверяет ключевые свойства объекта output, в том числе что file и dir не заданы одновременно (file — для одного бандла, dir — для разбитых или множественных сборок).
• Значение format является допустимым: amd, cjs, es, iife, system или umd.
• Скалярные свойства вроде sourcemap используют корректные типы (булевы значения или строки "inline" / "hidden").

Главная сложность онлайн-валидаторов в том, что реальные конфигурации Rollup — это файлы JavaScript, а не статический JSON. В них есть import-выражения ES (import resolve from ...), экспорты ES-модулей (export default { ... }) и вызовы плагинов во время выполнения (resolve(), commonjs()).

Наш клиентский валидатор использует специализированный нормализатор JavaScript-объектов. Он распознаёт стандартные конструкции JavaScript, безопасно удаляет комментарии, заменяет вызовы функций (плагины и вложенные создания объектов) статическими заполнителями и берёт в кавычки переменные без них.

Поэтому можно вставить «сырой» rollup.config.js прямо в валидатор. Парсер извлекает основную структуру конфигурации и проверяет её параметры схемы **без выполнения произвольного JavaScript-кода**, обеспечивая максимальную производительность и полную безопасность.

Изучите следующую стандартную конфигурацию, чтобы понять, какие структуры опций проверяет валидатор:

Наш валидатор разбирает эту структуру файла, заменяет вызовы плагинов вроде resolve() заполнителями, проверяет массив output, убеждается, что значения format (cjs и es) соответствуют стандартным целям, проверяет ключи treeshake и сообщает об успешной проверке.

Конфигурации сборки содержат закрытую информацию: раскрывают структуру каталогов, точки входа сборки, внешние зависимости и внутренние имена пакетов. Отправка таких конфигураций на удалённые серверы — риск для безопасности.

Наш валидатор конфигурации Rollup работает на 100 % локально в вашем браузере. Весь разбор и проверка выполняются клиентским JavaScript. Ни файлы, ни текстовое содержимое никогда не загружаются, не хранятся и не передаются по сети. Можно проверять конфигурации полностью офлайн или за корпоративным файрволом, соблюдая политики безопасности и приватности.