Template part não aparece: parts/header.html e o theme.json do tema de blocos

O arquivo parts/header.html está lá no tema de blocos, mas o Editor de Site não lista a parte em Cabeçalhos — ou o modelo abre com o topo vazio. O WordPress 6.9 acha o arquivo sozinho; sem declaração, porém, ele entra na área uncategorized e fica fora de qualquer agrupamento de cabeçalho.

Declare a parte no theme.json

O array templateParts fica na raiz do arquivo, no mesmo nível de settings e styles. O name é o nome do arquivo sem a extensão:

{
  "$schema": "https://schemas.wp.org/trunk/theme.json",
  "version": 3,
  "templateParts": [
    { "name": "header", "title": "Cabeçalho", "area": "header" },
    { "name": "footer", "title": "Rodapé",   "area": "footer" }
  ]
}

As áreas registradas por padrão são header, footer e uncategorized; qualquer outra é ignorada em silêncio, a não ser que você acrescente a sua pelo filtro default_wp_template_part_areas. E o tema só conta como tema de blocos se existir templates/index.html. Dentro desse modelo a parte entra como um bloco wp:template-part com {"slug":"header","tagName":"header"} — o editor escreve isso sozinho quando você insere o bloco Parte do modelo.

A armadilha: o banco ganha do arquivo

Se alguém já editou o cabeçalho pelo Editor de Site, o WordPress gravou um post do tipo wp_template_part e passa a servir essa cópia. Mexer no HTML do tema não muda nada até você remover a personalização:

sudo -u www-data wp post list --post_type=wp_template_part 
  --fields=ID,post_name,post_status

# confira o ID na listagem: o --force pula a lixeira e não tem volta
sudo -u www-data wp post delete 1234 --force
sudo -u www-data wp cache flush

Pelo painel dá no mesmo, e sem risco de apagar o post errado: abra a parte no Editor de Site e use Limpar personalizações. Depois disso o arquivo volta a mandar, e aí sim vale versionar parts/ no Git sem alguém sobrescrever pelo admin.