nextjs v16.3.0-canary.64
Resumo
O Next.js v16.3.0-canary.64 consolida uma sequência de canaries com mudanças em Turbopack, Cached Navigations, Cache Components, App Router, overlay de desenvolvimento, documentação e pipeline de release. O pacote também traz ajustes de instrumentação, metadata routes, React, SWC, typegen e testes, então a adoção deve ser limitada a ambientes que já aceitam comportamento canary.
Novidades
- nextjs v16.3.0-canary.64 — Chunks de entrada única: o Turbopack passa a aceitar chunks com uma única entrada. Essa mudança amplia o controle do empacotador sobre a forma como módulos são agrupados.
- nextjs v16.3.0-canary.64 — Debug de CSS no Turbopack: a variável
TURBOPACK_DEBUG_CSS_CHUNKINGfoi adicionada para inspecionar divisão de CSS. Esse apoio é útil quando a investigação depende de entender por que um chunk de estilo foi separado ou mesclado. - nextjs v16.3.0-canary.63 — Fallback de ISR em prefetch: respostas de prefetch passam a servir shells de fallback de ISR. Esse comportamento afeta rotas que dependem de geração incremental e pré-carregamento de navegação.
- nextjs v16.3.0-canary.61 — Runtime stage para Cached Navigations: a versão adiciona opção global para colocar Cached Navigations no estágio de runtime. Também há opt-in de Partial Prefetching routes para esse estágio em releases próximos da mesma sequência.
- nextjs v16.3.0-canary.62 — Guia de Interactive Apps: a documentação ganha um guia dedicado a Interactive Apps. O conteúdo amplia a cobertura oficial para aplicações interativas dentro do ecossistema do framework.
Melhorias
- nextjs v16.3.0-canary.64 — Mesclagem de chunks: o empacotamento passa a considerar fusão quando
overlap == 1. A mudança reduz fragmentação desnecessária em casos nos quais a sobreposição de módulos justifica agrupamento. - nextjs v16.3.0-canary.63 — Navigation inspector: a interface do inspetor de navegação recebeu ajustes visuais e funcionais. A inspeção de navegação fica mais alinhada ao comportamento atual de Cached Navigations e Instant Navs.
- nextjs v16.3.0-canary.63 — Parâmetros de fallback em dev: os parâmetros de fallback no desenvolvimento passam a ser computados a partir da rota pré-renderizada mais específica. Esse ajuste melhora a correspondência entre rota, pre-render e fallback em cenários de desenvolvimento.
- nextjs v16.3.0-canary.61 — Metadata routes: rotas de imagem de metadata passam a ser pré-renderizadas estaticamente sob Cache Components. A versão também reforça configurações de segmento de rota para metadata routes nesse modo.
- nextjs v16.3.0-canary.61 — Atualização do React: a sequência atualiza o React do build
b1786c31-20260618para247fbb45-20260622. Quem usa canary deve validar hidratação, actions, handlers e rotas App Router depois da troca. - nextjs v16.3.0-canary.59 — Atualização do SWC: a base passa para SWC 70. Essa mudança pede validação de build, transformação e comportamento de código em projetos que usam recursos recentes do compilador.
- nextjs v16.3.0-canary.59 — Instrumentação do router: a instrumentação do router ganha refatoração no dispatch do hook cliente e início de transição. Esse trabalho prepara leitura mais detalhada do ciclo de navegação.
- nextjs v16.3.0-canary.59 — OTEL no App Router: spans mais verbosos de OTEL entram no modo verbose para o App Router. A observabilidade fica mais detalhada quando o projeto ativa esse nível de instrumentação.
- nextjs v16.3.0-canary.58 — Carregamento de chunks: o Turbopack passa a tentar novamente o carregamento de chunks quando ocorre falha. Essa melhoria reduz falhas intermitentes de carregamento em desenvolvimento ou ambientes instáveis.
- nextjs v16.3.0-canary.56 — Descrições de PR por LLMs: a orientação interna passa a gerar descrições de Pull Request menos ruidosas e mais focadas. A mudança é de manutenção do repositório, mas indica cuidado com revisão assistida por IA.
Correções
- nextjs v16.3.0-canary.63 — Instant Navs: o lock de Instant Navs passa a ser liberado sem limpar todo o cookie jar. A correção evita efeitos colaterais amplos durante navegação instantânea.
- nextjs v16.3.0-canary.62 — Cache Components: a detecção de
export const dynamicdeixa de gerar falso positivo nesse modo. A correção ajuda a evitar diagnóstico incorreto em rotas que usam Cache Components. - nextjs v16.3.0-canary.61 — Atributos de erro OTEL: App API routes passam a registrar corretamente atributos de código de erro. A telemetria fica mais fiel quando handlers ou actions falham.
- nextjs v16.3.0-canary.59 — Callback
after: a versão corrige chamada deafter(callback)depois do fim da resposta. Também corrige APIs de request dentro de promises passadas paraafterem actions e handlers. - nextjs v16.3.0-canary.58 — Overlay de desenvolvimento: a ordenação de erros de hidratação no dev overlay foi corrigida. O caminho de abrir arquivo no editor também foi ajustado quando o projeto usa diretório
src. - nextjs v16.3.0-canary.58 — Raiz de repositório em adapters: a detecção de
repoRootfoi corrigida para adapters. Esse ajuste evita referência errada à raiz em integrações que dependem dessa informação. - nextjs v16.3.0-canary.56 — Erros originados no servidor: erros encaminhados do navegador deixam de ser logados novamente quando já vieram do servidor. A mudança reduz ruído duplicado durante investigação.
- nextjs v16.3.0-canary.55 — Esteira de release: o release train continua mesmo quando a publicação de
@next/swc-wasm-*falha. A alteração melhora a continuidade da publicação canary sem mascarar o ponto específico que falhou.
Breaking changes
Não foi identificada quebra de compatibilidade explícita no changelog desta sequência canary. Mesmo assim, mudanças em Cache Components, Cached Navigations, Turbopack, React e SWC podem alterar comportamento em projetos que dependem dessas áreas experimentais.
Ponto de Atenção
- nextjs v16.3.0-canary.64 — Cache Components e navegação: a sequência mexe em Cache Components, Cached Navigations, Partial Prefetching, ISR fallback e metadata routes. Teste sugerido: em uma aplicação App Router com rotas pré-renderizadas, executar navegação com prefetch, validar metadata images, confirmar que
generateStaticParamscontinua coerente e observar se o dev overlay mostra erros de hidratação na ordem esperada. - nextjs v16.3.0-canary.64 — Turbopack e compilação: a versão altera chunking, ordenação de módulos, runtime de edge renomeado e atualização do SWC. Teste sugerido: rodar build com Turbopack, habilitar
TURBOPACK_DEBUG_CSS_CHUNKINGem uma rota com CSS dividido, verificar carregamento de chunks e comparar saída de typegen em projeto que usa App Router. - nextjs v16.3.0-canary.64 — React e callbacks: a atualização do React e as correções em
after(callback)pedem validação de actions, handlers e APIs de request. Teste sugerido: executar uma action que agendaafter, confirmar que a resposta finaliza sem chamada tardia indevida e revisar spans OTEL quando o handler retorna erro.
Notas da versão
As versões v16.3.0-canary.55 a v16.3.0-canary.64 foram agrupadas no release v16.3.0-canary.64. Os termos Turbopack, Cache Components, Cached Navigations, Partial Prefetching, Instant Navs, App Router, OTEL, SWC, after(callback), generateStaticParams, TURBOPACK_DEBUG_CSS_CHUNKING e @next/swc-wasm-* foram preservados por identificarem recursos e APIs oficiais.