Astro 7.4.2

Resumo

O Astro 7.4.2 eleva o Node.js mínimo para 22.23.4, versão que traz as correções de segurança do Node.js de outubro de 2026. A versão reduz o tempo de sincronização de content collections com armazenamento fatiado e corrige falhas do servidor de desenvolvimento com o adapter Cloudflare, ilhas server:defer e variáveis de ambiente com $.

Novidades

Esta versão não traz recurso novo, porque a mudança de maior alcance eleva a versão mínima do Node.js.

Melhorias

• Astro 7.4.2 — Content collections: com experimental.collectionStorage: "chunked", a sincronização calcula a largura UTF-8 de cada caractere pelo código do caractere, sem passar cada um pelo TextEncoder. Num armazenamento com cerca de 44 mil entradas, a etapa de fatiamento cai de aproximadamente 60 segundos para menos de um segundo, com saída idêntica.

Correções

• Astro 7.4.2 — Cloudflare em desenvolvimento: astro dev com @astrojs/cloudflare deixa de falhar com Calling `require` for "node-fetch" quando uma dependência de servidor, como o cross-fetch, exige o node-fetch.
• Astro 7.4.2 — Arquivo de trava: um arquivo de trava antigo com o ID de uma thread do Linux não indica mais um servidor Astro em execução. Com isso, astro dev stop e astro dev --force não encerram o processo alheio dono daquela thread.
• Astro 7.4.2 — Dependências otimizadas: astro sync, astro check e astro build deixam de substituir as dependências otimizadas de um servidor de desenvolvimento aberto no mesmo projeto. A substituição quebrava as ilhas de framework até um reinício com --force.
• Astro 7.4.2 — Variáveis de ambiente: o módulo virtual astro:env/server é gerado com JavaScript válido mesmo quando uma variável contém padrões de substituição como $& ou $1. O caso aparecia com a variável KITTY_PUBLIC_KEY, que o terminal Kitty define por padrão. O servidor quebrava com Failed to parse source for import analysis.
• Astro 7.4.2 — Estilos e ilhas: os estilos inline em desenvolvimento usam o CSS transformado pelo framework, como estilos com escopo e v-bind() em componentes Vue. Uma ilha server:defer que importa astro:actions ou astro:config/server deixa de gerar o erro Could not find server component name.
• Astro 7.4.2 — Tipos de i18n: os tipos de defineConfig() para i18n.defaultLocale, i18n.fallback e i18n.domains aceitam o path de um idioma personalizado, como o Astro já validava.

Breaking changes

• Astro 7.4.2 — Node.js: o Astro exige o Node.js 22.23.4 ou superior. A mudança saiu numa versão de correção porque a política de suporte do Astro permite elevar o mínimo quando uma falha de segurança do Node.js afeta o framework. Ambientes com Node.js 22.22.x precisam ser atualizados.

Ponto de Atenção

Imagens Docker, pipelines de CI e servidores presos a uma versão anterior do Node.js 22 deixam de atender ao requisito do Astro. Teste sugerido: rode node --version em cada ambiente de build e de execução e confirme a versão 22.23.4 ou superior antes de atualizar o Astro.

Notas da versão

As mudanças estão nas notas oficiais do Astro 7.4.2, publicadas em 21/10/2026. O motivo da nova versão mínima está nas correções de segurança do Node.js de outubro de 2026. A versão atualiza @astrojs/telemetry para 3.4.1 e @astrojs/markdown-satteri para 0.4.5.