Nudeps от Лии Веру: как подключать npm-пакеты в браузере без сборщика и лишней настройкиСтатья · дайджест за 19 ноября
Nudeps от Лии Веру: как подключать npm-пакеты в браузере без сборщика и лишней настройки
Статья5 разделов≈ 7 мин

Nudeps от Лии Веру: как подключать npm-пакеты в браузере без сборщика и лишней настройки

Знакомая развилка. Делаешь небольшой сайт или демку на чистом HTML и JS, и тут хочется подключить Vue, D3 или библиотеку подсказок. Дальше обычно два пути — и оба бесят. Либо качать файлы руками, цеплять внешние CDN и забыть про npm install, либо ставить сборщик вроде Vite или Webpack. Просто ради одной строки import { createApp } from "vue".

Браузер сам по себе такое не поймёт. Запись "vue" без адреса или пути называют bare specifier — импортом по короткому имени. Браузеру нужен реальный URL, а node_modules/ никто не проектировал для выгрузки на сервер. Вот и приходится тянуть сборщик даже в простейший проект. Вместе с ним приезжают конфиги, фоновые процессы и лишние слои, из-за которых рабочий браузерный код ломается на сборке. В опросе State of JS 2025 управление зависимостями заняло 3-е место среди главных болей JS-разработчиков, а инструменты сборки — 6-е.

18 ноября 2026 года Лия Веру в своём блоге выпустила Nudeps — лёгкий инструмент под лицензией MIT (v0.4.4, 133,8 КБ). Первый прототип она собрала в феврале со своим учеником Дмитрием Шарабиным, а потом обкатывала его с бета-тестерами и советовалась с Джорданом Харбандом. В названии игра слов: nude deps («голые зависимости» без обёртки сборщика) и созвучие с new deps.

Идея тут простая: не отменять сборщики совсем, а сделать «лёгкую сборку» (light-build). Бандлеры нужны для сложной компиляции и тяжёлой оптимизации, а Nudeps закрывает простые задачи — и вообще не трогает твой собственный код.

Две команды вместо конфигов: как всё работает без фонового процесса

После установки о Nudeps можно забыть. Он не висит в фоне, не следит за правками файлов и не переписывает твой JS. В папке с package.json хватает одной команды:

# Ставит nudeps, прописывает хуки и сразу собирает карту импортов
npx nudeps install

Она добавляет nudeps в devDependencies, делает первый прогон и прописывает в package.json два скрипта. Весь фокус держится на встроенном хуке dependencies в npm, про который многие даже не знают: он запускается сам после каждого npm install и npm uninstall. А prepare подхватывает проект после свежего git clone.

{
  "scripts": {
    "dependencies": "npx nudeps",
    "prepare": "npx nudeps"
  },
  "devDependencies": {
    "nudeps": "^0.4.4"
  },
  "dependencies": {
    "jquery": "^4.0.0",
    "jquery1": "npm:jquery@^1.12.4"
  }
}

Это реальный package.json из демо с jQuery, где рядом живут сразу две версии библиотеки через алиас npm. Никакого watcher в терминале держать не надо. Люди настолько привыкли к долгой настройке, что первые тестеры пугались тишины. Сэм Литтлфэр рассказал: запустил npx, добавил карту импортов и ждал ещё кучу возни — а потом с удивлением понял, что уже всё готово.

Локальный HTTP-сервер для ES-модулей всё равно нужен (по file:// браузер их не пустит). Но, как шутит Лия, локальный сервер ничего не стоит: его поднимет редактор или агент, а у неё один сервер вообще крутится в корне папки со всеми репозиториями.

Что под капотом: client_modules, JSPM и умный importmap.js

Внутри Nudeps склеил готовые механизмы. Первый — Import Maps (карты импортов), встроенный словарь браузера <script type="importmap">, который переводит "vue" в реальный путь к файлу. Стандарт уже Baseline Widely Available, то есть стабильно работает во всех основных современных браузерах.

Второй — движок JSPM (@jspm/generator и @jspm/overrides), который обычно используют с CDN, но здесь он работает локально. При каждом npm install Nudeps копирует нужные файлы из node_modules/ в плоскую папку client_modules/ с версией в имени — вроде client_modules/vue@3.5.45/. Дубликаты исчезают, а кэш браузера сбрасывается точечно: обновил один пакет — остальные не перезагружаются. Внутрь client_modules/ и .nudeps/ кладётся свой .gitignore, так что в Git они не попадут, зато client_modules/ уезжает в деплой.

Браузеры пока требуют вставлять <script type="importmap"> прямо в HTML каждой страницы. Nudeps обходит это скриптом /importmap.js, который сам добавляет тег на лету:

<!-- Обычный скрипт без type="module", строго до модулей -->
<script src="/importmap.js"></script>
<script type="module">
  // Короткое имя работает прямо в браузере
  import { createApp } from "vue";
</script>

В реальном importmap.js из демо Vue видна приятная аккуратность. Скрипт через new URL(m[k], document.currentScript.src).href пересчитывает относительные пути от своего адреса, поэтому один файл работает на страницах любой вложенности. Заодно он бросает ошибку при лишнем type="module" и предупреждает в консоль, если его поставили после модульного скрипта. А перед продом опция prune вырезает неиспользуемые импорты: в разработке карта держит все точки входа, чтобы не пересобираться от каждого нового import в твоём коде.

Что уже работает: от Vue и двух jQuery до CSS и lodash

Сам сайт nudeps.dev уже работает на nudeps@0.4.4. В живых примерах без сборщика заводятся Vue (любимый вариант Лии), Lit, D3, gsap, Three.js, Floating UI, interact.js и Underscore — и даже React, хотя без JSX писать на нём неудобно. Работают динамический import(), import.meta.resolve(), локальные пакеты (npm i ../foo), git-зависимости, алиасы и экспериментальные workspaces.

С форматами модулей расклад такой. Современные ESM-пакеты (import/export) браузер понимает напрямую, и с ними всё гладко. Старые CommonJS-библиотеки вроде lodash написаны под require() в Node.js — в Nudeps для них есть экспериментальная прослойка cjs-browser-shim, где пакет подключают через import { require } from "cjs-browser-shim" и вызов require("lodash").

С CSS-библиотеками и иконками вроде Open Props и Bootstrap Icons иначе: браузеры пока не умеют импортировать стили по короткому имени, нужен URL. Чтобы не править ссылки после каждого обновления пакета, Nudeps делает в client_modules/ симлинки (ярлыки без версии, или редиректы там, где хостинг их не поддерживает):

<!-- Путь через симлинк не ломается при обновлении пакета -->
<link
  rel="stylesheet"
  href="client_modules/open-props/open-props.min.css"
/>

Так стили подключены в демо Open Props. Ограничение одно: внешние CSS-зависимости такой пакет сам подтянуть не сможет, если они не вшиты внутрь — но почти все библиотеки стилей и иконок самодостаточны.

Как Nudeps поссорил Claude с npm — и чем помог SKILL.md

Смешная история вышла с ИИ-агентами. С февральских тестов Claude в целом справлялся с Nudeps, но по привычке делал лишние движения: дописывал client_modules/ в .gitignore, хотя папка сама себя игнорирует, добавлял npm run build и гонял npx nudeps вручную. А ещё запускал npm run dependencies руками, решив, что это самодельный скрипт.

Главный курьёз: Claude вообще не знал про встроенный хук dependencies в npm и, по словам Лии, уверенно спорил, что его не существует. Всё вылечил файл SKILL.md в репозитории Nudeps с таблицей типовых промахов агентов (не трогать client_modules/, не ставить type="module" на importmap.js, не запускать npx nudeps вручную). Он ставится в Claude Code, Cursor и Copilot командой npx skills add nudeps/nudeps, и лишние правки исчезают.

Где Nudeps не вытянет и лучше оставить сборщик

Nudeps честно держится в своих границах. Он вообще не компилирует твой код: для TypeScript, JSX, Svelte и однофайловых компонентов Vue (.vue) всё равно нужен отдельный компилятор (хотя Nudeps легко уживается с генераторами статики или компилятором TS). Пока поддерживается только npm — pnpm и yarn стоят первыми в планах, но в 0.4.4 их нет.

Есть и потолок самой платформы. Карты импортов до сих пор не работают в Web Workers — задача whatwg/html#8173, открытая Гаем Бедфордом в августе 2022 года, всё ещё открыта. А часть пакетов ждёт API Node.js вроде process.env: мелочи прикрывают заглушкой, но для тяжёлых случаев проще подсунуть браузерный бандл пакета через переопределения в конфиге nudeps.js.

Наконец, скорость первой загрузки. Без склейки пакет из десятков мелких ESM-файлов устроит браузеру цепочку запросов. Замеров против Vite, esbuild или Webpack пока нет, и Лия честно предупреждает: в зависимости от структуры пакетов сборщик может быть заметно быстрее — а иногда чуть медленнее.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 9