Next.js v16.3.0-canary.61
Resumo
O Next.js v16.3.0-canary.61 consolida canaries de v16.3.0-canary.53 a v16.3.0-canary.61, com mudanças relevantes em Cache Components, Turbopack, App Router, OTEL, documentação e pipeline de publicação. O release é extenso para uma linha canary e exige leitura cuidadosa em projetos que testam recursos experimentais, principalmente quando há metadata routes, adapters, navegação cacheada, dev overlay ou instrumentação de rotas.
Novidades
- Next.js v16.3.0-canary.61 — Cached Navigations: a versão adiciona uma opção global para entrar no estágio de runtime de Cached Navigations, o que antecipa validação para aplicações que já acompanham a evolução de navegação instantânea.
- Next.js v16.3.0-canary.61 — Metadata image routes: as rotas de imagem de metadata passam a ser pre-renderizadas estaticamente sob Cache Components, reduzindo ambiguidade entre metadata dinâmica e cache durante builds experimentais.
- Next.js v16.3.0-canary.61 — Cache Components: o codemod
cache-components-instant-falsee a skill de adoção de Cache Components foram adicionados, enquanto a documentação passou a mencionar a exigência de App Router e runtime Node.js para esse caminho. - Next.js v16.3.0-canary.53 — React experimental: a opção
experimental.useExperimentalReactpermite testar o canal experimental do React de forma explícita, sem misturar essa escolha com a configuração principal da aplicação.
Melhorias
- Next.js v16.3.0-canary.61 — Turbopack runtime: o edge runtime foi renomeado para self-contained runtime, deixando a nomenclatura mais alinhada ao isolamento real do pacote gerado.
- Next.js v16.3.0-canary.61 — Ordenação de módulos: o Turbopack passa a ordenar módulos por caminho em arquivos, e a linha
v16.3.0-canary.59também ordena módulos em chunks para reduzir duplicações. - Next.js v16.3.0-canary.61 — React atualizado: o React foi atualizado de
b1786c31-20260618para247fbb45-20260622, mantendo a linha canary próxima das mudanças recentes do canal experimental. - Next.js v16.3.0-canary.59 — App Router e OTEL: a instrumentação do roteador recebeu spans OTEL mais verbosos e começou uma refatoração do dispatch de hooks do cliente, incluindo o início de transição como parte do rastro observado.
- Next.js v16.3.0-canary.59 — Typegen: a geração de tipos passa a assumir Turbopack por padrão, o que aproxima o caminho de desenvolvimento da direção atual do bundler.
- Next.js v16.3.0-canary.58 — Publicação npm: o pipeline de publicação reduz o tamanho dos metadados enviados ao npm, diminuindo ruído no pacote distribuído.
- Next.js v16.3.0-canary.57 — Instant Navs DevTools: a captura de bugs no DevTools de Instant Navs foi corrigida e a suíte de testes voltou a rodar, reforçando a cobertura de navegação em desenvolvimento.
- Next.js v16.3.0-canary.53 — Turbopack internals: o algoritmo de chunking recebeu ajuste algébrico, a alocação de
Effects foi movida para arena e estruturas internas comoRawVceCellIdficaram menores. - Next.js v16.3.0-canary.53 — Cache em desenvolvimento:
cacheMaxMemorySize: 0e cache handlers customizados ficaram mais rápidos em desenvolvimento, o que ajuda projetos que validam comportamento de cache com configuração não padrão.
Correções
- Next.js v16.3.0-canary.61 — OTEL em App API routes: os atributos de código de erro passam a ser definidos corretamente em App API routes, melhorando a leitura de falhas em telemetria.
- Next.js v16.3.0-canary.61 — Configuração de metadata routes: as configurações de segmento de rota agora são aplicadas em metadata routes sob Cache Components, reduzindo divergência entre rota comum e rota de metadata.
- Next.js v16.3.0-canary.59 —
after()em responses: a chamada deafter(callback)depois do fim da resposta foi corrigida, evitando execução tardia fora do ciclo esperado. - Next.js v16.3.0-canary.59 — APIs em promises: as request APIs em promises passadas para
after()em actions e handlers foram corrigidas, evitando comportamento inconsistente em callbacks posteriores à resposta. - Next.js v16.3.0-canary.58 — Dev overlay: a ordenação de erros de hidratação no dev overlay foi ajustada, e o caminho de
open-in-editorfoi corrigido quando o projeto usa diretóriosrc. - Next.js v16.3.0-canary.58 — Chunk loading: o Turbopack passa a tentar carregar chunks novamente depois de uma falha, o que reduz quebra temporária em desenvolvimento quando um chunk não chega na primeira tentativa.
- Next.js v16.3.0-canary.57 — Repo root em adapters: a detecção de
repoRootfoi corrigida para adapters, evitando leitura incorreta da raiz do repositório em empacotamentos adaptados. - Next.js v16.3.0-canary.56 — Erros do servidor: erros originados no servidor e encaminhados pelo navegador deixam de ser registrados novamente, reduzindo duplicidade nos logs de desenvolvimento.
- Next.js v16.3.0-canary.53 — OTEL em adapters: atributos OTEL baseados em resposta foram definidos corretamente com adapters, e outros pontos remanescentes de OTEL nessa superfície também receberam correção.
- Next.js v16.3.0-canary.53 — Cache Components: a lógica de flush do accumulator em Cache Components foi corrigida, evitando retenção indevida de estado durante a composição de cache.
Breaking changes
- Next.js v16.3.0-canary.61 — PPR legado: caminhos legados de Partial Prerendering foram removidos, o que pode afetar aplicações que ainda dependem de comportamento antigo em experimentos de prerenderização.
- Next.js v16.3.0-canary.61 — Runtime do Turbopack: a renomeação do edge runtime para self-contained runtime pode exigir ajuste em documentação interna, testes ou integrações que conferem nomes de runtime.
- Next.js v16.3.0-canary.60 — Marketplace de plugin: o marketplace embutido de plugins do Claude Code foi removido, então fluxos internos que dependiam dessa integração precisam ser revisados antes de atualizar.
Ponto de Atenção
- Next.js v16.3.0-canary.61 — Cache Components: projetos que usam metadata routes, Cache Components e App Router devem testar build, navegação e pre-renderização de imagens de metadata no mesmo ambiente, porque várias mudanças convergem nessa superfície.
- Next.js v16.3.0-canary.61 — Teste sugerido: execute uma rota App Router com metadata image route,
after()em action ou handler e telemetria OTEL ligada, conferindo se a resposta termina corretamente, se os spans aparecem e se o dev overlay abre o arquivo certo em projetos comsrc. - Next.js v16.3.0-canary.61 — Turbopack: valide chunks em desenvolvimento depois de atualização, principalmente se a aplicação usa adapter, cache handler customizado ou runtime experimental.
- Next.js v16.3.0-canary.61 — Linha canary: a sequência inclui remoção de caminho legado de PPR e mudanças em recursos experimentais, então ela não deve ser promovida para ambiente sensível sem uma bateria mínima de build, navegação, metadata, telemetria e logs.
Notas da versão
O release mescla as versões v16.3.0-canary.53 a v16.3.0-canary.61. A versão v16.3.0-canary.54 apareceu sem corpo técnico além do identificador e, por isso, não foi usada como base de mudança publicável.