Changesets v3: Nova versão traz instalação 88% menor e muda gerenciamento de dependências
Changesets, a ferramenta baseada em arquivos para versionamento e changelog em monorepos JavaScript, lançou a v3.0, seu primeiro lançamento maior em sete anos desde a v2. A versão chega com instalações mais enxutas, uma CLI reconstruída e uma mudança tão esperada na forma como as dependências peer são atualizadas.
O lançamento aconteceu em 11 de agosto de 2026, liderado por um time de mantenedores renovado: Mateusz Burzyński, Bjorn Lu e Adam Haglund, que seguiram um plano público de lançamento v3. A versão vem com um novo site de documentação, uma correspondente changesets/action v2 e mais de 3 milhões de downloads semanais.
Pacotes ESM apenas e requisitos mais altos
Todos os pacotes agora são apenas ESM (ES Modules) e exigem Node.js 22.11 ou mais recente, além de pnpm 10, npm 10.9 ou Yarn 4.5.2 como mínimo, com o Yarn Classic descontinuado. A limpeza reduziu o tamanho da instalação de 16,1MB para 2,1MB e as dependências de 95 para 39. Internamente, o projeto migrou para tsdown, rolldown, vitest e oxfmt. A formatação de changelog não puxa mais sua própria cópia do Prettier, em vez disso usa @changesets/format para detectar prettier, oxfmt, deno ou dprint no projeto.
Mudança no comportamento de dependências peer
A principal mudança de comportamento é que uma atualização de dependência peer agora dá aos dependentes um bump de patch em vez de um major. O comportamento antigo gerou anos de reclamações, incluindo a issue 1011, onde um time mantendo um monorepo de design system escreveu que atualizar para uma versão major "parece estar mandando a mensagem errada e não honrando semver".
Autores que enviam uma quebra genuína ainda podem adicionar um changeset major explícito para o dependente.
Os mantenedores do Bumpy, um competidor lançado recentemente, observam que a v3 "codifica o extremo oposto", já que toda mudança peer agora é assumida como não-quebra, e que nenhuma versão deixa você configurar a propagação. A comparação ainda credita a v3 por corrigir muitas reclamações antigas, enquanto lista lacunas como suporte a catálogo pnpm e um design de prerelease inalterado.
CLI reconstruída com novos comandos
A CLI foi reconstruída com cac para análise de argumentos e clack prompts para interação, o que também corrige prompts cancelados travando o processo. Novos comandos pack e publish-plan suportam a sequência de build, pack e publish recomendada pela comunidade e18e. A action v2 expõe sub-actions para que times usando npm trusted publishing possam restringir permissões de publicação.
Processo de atualização
Atualizar é principalmente um trabalho de configuração, documentado no guia de migração. Além dos requisitos de instalação, comandos e flags foram renomeados:
changeset→








