Next.js v16.3.0-preview.4: changelog

Next.js v16.3.0-preview.4

Resumo

O Next.js v16.3.0-preview.4 consolida a versão preview e uma sequência de canaries da linha 16.3.0, com mudanças em Cache Components, Partial Prefetching, Navigation Inspector, Turbopack, metadata routes, instrumentação do App Router e publicação de pacotes. A versão também reorganiza parte da documentação e do fluxo de adoção para recursos experimentais.

Novidades

Next.js v16.3.0-preview.4 — Native binding opcional: a instalação automática de native bindings passa a ser opt-in, reduzindo interferência em ambientes que precisam controlar dependências nativas.
Next.js v16.3.0-canary.64 — Chunks de entrada única: o Turbopack adiciona suporte a chunks com entrada única, o que altera a forma como determinados módulos podem ser agrupados.
Next.js v16.3.0-canary.64 — Debug de CSS chunking: a variável TURBOPACK_DEBUG_CSS_CHUNKING foi adicionada para apoiar investigação de divisão de CSS no Turbopack.
Next.js v16.3.0-canary.63 — ISR em prefetch: respostas de prefetch agora podem receber shells de fallback ISR, aproximando a navegação antecipada do comportamento esperado em páginas com fallback.
Next.js v16.3.0-canary.61 — Runtime stage de Cached Navigations: foi incluído um opt-in global para a etapa de runtime em Cached Navigations.
Next.js v16.3.0-canary.59 — Typegen com Turbopack: o typegen passa a usar Turbopack como padrão.

Melhorias

Next.js v16.3.0-canary.67 — Fontes locais em metadata: fontes locais foram corrigidas em rotas de metadata ImageResponse pré-renderizadas estaticamente.
Next.js v16.3.0-canary.67 — Navigation Inspector: rotas bloqueantes agora exibem erro no Navigation Inspector, tornando a falha mais visível durante depuração.
Next.js v16.3.0-canary.67 — Aviso de prefetch: o aviso de prefetch={true} é suprimido quando a rota opta por sair do recurso com instant = false.
Next.js v16.3.0-canary.66 — Partial Prefetching no overlay: o dev-overlay conecta o aviso de Partial Prefetching para Link prefetch={true} ao painel de Insights.
Next.js v16.3.0-canary.66 — Publicação preview: os tarballs de preview ficam disponíveis enquanto novos canaries são publicados, e o corte de preview pode ser feito a partir de canary.
Next.js v16.3.0-canary.65 — Cache em desenvolvimento: caches com cacheMaxMemorySize: 0 preservam a vida útil resolvida em ambiente de desenvolvimento.
Next.js v16.3.0-canary.65 — Headers internos: a remoção de headers internos passa a evitar mutação direta de req.headers.
Next.js v16.3.0-canary.64 — Mesclagem de chunks: chunks podem ser mesclados quando overlap == 1, reduzindo duplicações em cenários específicos.
Next.js v16.3.0-canary.63 — Navigation Inspector UI: a interface do Navigation Inspector recebeu ajustes visuais e comportamentais.
Next.js v16.3.0-canary.63 — Cached Navs: rotas com Partial Prefetching passam a optar pela etapa de runtime em Cached Navs.
Next.js v16.3.0-canary.63 — Fallback params: os parâmetros de fallback em desenvolvimento agora são calculados a partir da rota pré-renderizada mais específica.
Next.js v16.3.0-canary.61 — Metadata image routes: rotas de imagem de metadata podem ser pré-renderizadas estaticamente sob Cache Components.
Next.js v16.3.0-canary.59 — SWC: a base foi atualizada para swc 70.
Next.js v16.3.0-canary.59 — Instrumentação do App Router: foram adicionados spans OTEL mais detalhados em modo verboso e o início de transição passou a ter rastreio próprio.
Next.js v16.3.0-canary.59 — Ordenação no Turbopack: módulos em chunks e arquivos passam a ser ordenados por path, reduzindo duplicações e tornando a saída mais determinística.

Correções

Next.js v16.3.0-canary.66 — Navigation Inspector em modo escuro: os estilos do Navigation Inspector foram corrigidos para dark mode.
Next.js v16.3.0-canary.63 — Erros irrelevantes em Insights: cards sem relação com erros de navegação instantânea foram removidos da visualização de Insights.
Next.js v16.3.0-canary.63 — Lock de navegação instantânea: o lock de instant navs passa a ser liberado sem limpar o cookie jar inteiro.
Next.js v16.3.0-canary.62 — Cache Components: um falso positivo em export const dynamic na detecção de Cache Components foi corrigido.
Next.js v16.3.0-canary.61 — App API routes: atributos de código de erro OTEL foram ajustados para rotas App API.
Next.js v16.3.0-canary.59 — after(callback): callbacks registrados com after não são mais chamados depois do fim da resposta.
Next.js v16.3.0-canary.59 — Promises em after(): chamadas de request passadas para after() em actions e handlers foram corrigidas.

Breaking changes

Não há breaking change declarado como tal na origem. Mesmo assim, mudanças em Cache Components, Cached Navigations, Partial Prefetching, typegen com Turbopack e remoção ou retorno de caminhos legados de PPR exigem validação em aplicações que dependem desses recursos experimentais.

Ponto de Atenção

Next.js v16.3.0-preview.4 — Cache Components: revise aplicações que usam generateStaticParams, runtime Node.js, instant=false, metadata routes ou cacheMaxMemorySize: 0, porque várias mudanças desta sequência incidem sobre esses pontos.
Next.js v16.3.0-preview.4 — Turbopack: valide builds com CSS chunking, ordenação de módulos, chunks de entrada única e typegen, especialmente quando a aplicação depende de saída determinística.
Next.js v16.3.0-preview.4 — Navegação e prefetch: teste rotas com Link prefetch={true}, Partial Prefetching, Navigation Inspector, fallback ISR e Cached Navigations antes de atualizar ambiente de desenvolvimento compartilhado.
Next.js v16.3.0-preview.4 — Teste sugerido: rode build, navegação local e fluxo de metadata image route em uma aplicação que use App Router, Cache Components e Turbopack, conferindo logs OTEL, avisos do overlay e comportamento de prefetch.

Notas da versão

Além das mudanças de runtime, o release atualiza documentação de Cache Components, Partial Prefetching, autenticação, Interactive Apps e guias internos de adoção. A origem também registra reversões pontuais em PPR e em um switch case, que foram preservadas aqui como sinal de estabilização da sequência preview.