Релиз pnpm 12.19.0: команда fund, сборка в loaded node linker и изоляция peer-зависимостейСтатья · дайджест за 11 ноября
Модульная взрыв-схема пакетного менеджера pnpm 12.19 с изолированными зависимостями и общим кэшем пакетов.
Статья4 раздела≈ 6 мин

Релиз pnpm 12.19.0: команда fund, сборка в loaded node linker и изоляция peer-зависимостей

10 ноября 2026 года ведущий мейнтейнер Золтан Кочан опубликовал в официальном блоге релиз пакетного менеджера pnpm 12.19.0, развиваемого в открытом репозитории на GitHub. По номеру версии обновление легко принять за рядовой выпуск, но за ним стоят доработки, меняющие повседневную работу крупных проектов. Меня в этом списке изменений сразу зацепило то, как авторы разобрались со сборкой пакетов в общем хранилище и скрытыми связями внутри единого репозитория.

Когда в одном рабочем пространстве (pnpm workspace) живут несколько проектов — скажем, витрина @my-org/web и соседний серверный сервис, — между ними часто возникают трения. Как избавить такой монорепозиторий от повторной компиляции одних и тех же модулей и не допустить, чтобы отладочные инструменты одного пакета просочились в рабочую сборку соседнего? Версия 12.19.0 решает эти задачи через кэширование сборок в глобальном сторе, строгие границы для опциональных peer-зависимостей и новый формат файла блокировки.

Прозрачная поддержка авторов через команду pnpm fund

Начнем с пополнения в консольном интерфейсе, которого не хватало для паритета со стандартными инструментами экосистемы. Современный проект опирается на сотни открытых библиотек, и многие авторы указывают в манифестах ссылки для финансовой поддержки. Раньше, чтобы собрать их в проекте на pnpm, приходилось просматривать конфигурационные файлы вручную.

Теперь в менеджер встроена команда pnpm fund. Она обходит установленные зависимости и выводит в терминал дерево ссылок на страницы финансирования. Чтобы сразу открыть страницу пакета в браузере, достаточно передать его имя: pnpm fund <pkg>. Если у библиотеки указано несколько площадок для донатов, ключ --which позволяет выбрать нужную ссылку по номеру.

В монорепозитории выводить реквизиты всех сервисов разом неудобно, поэтому команда поддерживает флаги --recursive, --filter и формат --json. Например, вызов pnpm fund --filter @my-org/web --json соберет JSON-отчет только по зависимостям витрины @my-org/web. Такую выгрузку легко подключить к внутреннему дашборду компании для распределения спонсорского бюджета. А когда со списком пакетов всё ясно, возникает следующая задача — как быстро слинковать и собрать эти модули на диске.

Эволюция loaded node linker и кэширование сборок в sideEffectsCache

Обычный режим pnpm строит внутри node_modules лабиринт из символических и жестких ссылок на центральное хранилище. В 2026 году появился альтернативный режим nodeLinker.type: loaded (мы разбирали его устройство в материале о релизе pnpm 12.10.0). Если объяснять на пальцах, это переход от развешивания бумажных указателей по комнатам к единой картотеке: среда выполнения загружает код библиотек напрямую из глобального хранилища без тысяч симлинков.

До версии 12.19.0 у этого режима оставалось слабое место — пакеты со скриптами сборки (postinstall). Раньше их приходилось вручную вносить в исключения nodeLinker.excluded. В новом релизе это обязательное требование сняли, подружив режим loaded с кэшем побочных эффектов (sideEffectsCache).

Соотношение выгоды и цены при включенном чтении и записи sideEffectsCache выглядит так:

  • Выгода в скорости и экономии диска: когда пакету в @my-org/web нужна сборка, pnpm компилирует его один раз в приватной директории, сохраняет результат в sideEffectsCache и раздает напрямую из хранилища. Даже если скрипт не изменил ни одного файла, менеджер запоминает это и не запускает скрипт повторно в других проектах с тем же стором. Пакеты с промахом кэша, нативными аддонами .node и их зависимостями автоматически материализуются на диске.
  • Границы применимости и исключения: кэшировать всё подряд нельзя. Во-первых, пакеты, чей скрипт обязан отрабатывать в каждом проекте заново (например, установщики git-хуков), нужно явно указывать в sideEffectsCache.exclude. Во-вторых, pnpm сканирует исходники JavaScript на вызовы __dirname, import.meta и файловые импорты, материализуя такие пакеты на диске. Статический сканер видит прямые обращения, но не распознает динамически вычисляемые пути — библиотеки со склеенными на лету путями по-прежнему нужно вносить в nodeLinker.excluded.

Изоляция воркспейсов с projectScopedOptionalPeers и защита от чужих пакетов

Когда сборка модулей отлажена, в монорепозитории всплывает еще более коварный класс ошибок — утечка опциональных peer-зависимостей между проектами. Представь общую кухню, где у каждого жильца своя полка, но кто-то случайно берет приправу с чужого стола.

Допустим, в проекте @my-org/web для локальной верстки в devDependencies установлен консольный инструмент сборщика. Рядом в том же монорепозитории лежит серверный сервис, использующий плагин, у которого этот инструмент объявлен как необязательная сопутствующая зависимость (optional peer dependency). Раньше резолвер видел, что инструмент уже есть в монорепозитории у соседа, и подключал его из чужих devDependencies прямо к рабочим (production) зависимостям серверного пакета. Локально тесты проходят, но при выкатке серверного сервиса в отдельный контейнер сборка меняет поведение или падает.

Чтобы закрыть эту лазейку, в версии 12.19.0 добавили настройку projectScopedOptionalPeers (в .npmrc она задается как project-scoped-optional-peers=true). При ее включении проект воркспейса получает необязательную peer-зависимость только тогда, когда она явно установлена в его собственных зависимостях. Чужие devDependencies больше не протекают через границы проектов, а dedupePeerDependents штатно дедуплицирует остальные пакеты. Даже при dedupePeerDependents: false отсутствующие опциональные peer-пакеты больше не берутся у соседей (разрешение из корня сохраняется только при resolvePeersFromWorkspaceRoot: true).

Заодно авторы исправили смежные углы разрешения графа, развивая аудит зависимостей из обзора релиза pnpm 12.17.0. Менеджер перестал подставлять опциональную peer-зависимость, если ее обязательные peer-пакеты конфликтуют с версиями проекта. А pnpm install --filter при частичном клонировании репозитория (sparse checkout) теперь учитывает зависимости пакетов воркспейса, отсутствующих на диске, сохраняя файл блокировки идентичным полной выгрузке.

Экспериментальный формат lockfile v13 и проверка окружения воркспейса

Даже при чистой изоляции пакетов командам мешают конфликты слияния в pnpm-lock.yaml. В прежней структуре метаданные версий лежали в секции packages, а связки разрешенных peer-зависимостей — отдельно в snapshots, поэтому обновление одного пакета меняло файл сразу в двух местах.

В релизе 12.19.0 появилась экспериментальная опция lockfile.format: v13. Она переводит pnpm-lock.yaml на JSON-подобный синтаксис YAML с отступами табуляцией и висячими запятыми. Вместо разделения на packages и snapshots каждой версии пакета отводится одна запись в packages, где версии peer-зависимостей записаны прямо как свойства. Обновление сопутствующего пакета меняет только строчки с его версией, сокращая конфликты в git. Сам pnpm читает оба формата при любых настройках, но статус v13 пока экспериментальный: сторонние CI-сканеры и боты, читающие pnpm-lock.yaml в обход CLI, могут не распознать новую разметку.

Помимо четырех главных новшеств, релиз принес улучшения безопасности и скорости. При ошибке оффлайн-установки отсутствующего архива из вывода убрали URL с токенами авторизации реестра, а нераскрытые шаблоны ${VAR} в адресах реестров внутри pnpm-workspace.yaml и .npmrc теперь вызывают ошибку. Команды установки и запуска (pnpm run -r, pnpm exec -r) проверяют поля engines (pnpm, node) и платформу (os, cpu, libc) по всем пакетам воркспейса, включая корень и devEngines.runtime. Распаковка крупных пакетов ускорилась на 30% (на примере архива TypeScript), холодная установка проекта из 1350 пакетов с клонированием на macOS при активном защитном ПО стала быстрее на 29%, pnpm store add рекурсивно добавляет папки с архивами, а список сборок пополнил бинарник для NetBSD 10 x64.

Чтобы обновление монорепозитория прошло без сюрпризов, сверься с памяткой из трех пунктов:

  • Добавь project-scoped-optional-peers=true в .npmrc, чтобы отсечь скрытый захват опциональных peer-пакетов из devDependencies соседних сервисов.
  • При включении nodeLinker.type: loaded с sideEffectsCache внеси установщики git-хуков в sideEffectsCache.exclude, а пакеты с вычисляемыми путями к файлам оставь в nodeLinker.excluded.
  • Перед переводом команды на lockfile.format: v13 проверь новый pnpm-lock.yaml на своих CI-сканерах безопасности и ботах автообновления.

Такая настройка позволяет сразу получить быструю сборку из общего кэша и честную изоляцию пакетов в воркспейсе, не ломая существующий конвейер доставки.

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