# Versão instalada
zig version

# Versão usada no projeto (se documentada)
cat .zig-version 2>/dev/null

# Criar branch para a atualização
git checkout -b atualizar-zig-0.14

# Instalar nova versão
# macOS
brew upgrade zig

# Linux — baixar nova versão
wget https://ziglang.org/download/0.14.0/zig-linux-x86_64-0.14.0.tar.xz
tar xf zig-linux-x86_64-0.14.0.tar.xz

# Windows
scoop update zig

# Primeiro, tentar compilar
zig build 2>&1

# O compilador indicará o que precisa mudar
# Corrigir cada erro um por um

# Rodar todos os testes
zig build test

# Testar em todos os targets usados
zig build -Dtarget=x86_64-linux-gnu
zig build -Dtarget=x86_64-windows

// ANTIGO (versões anteriores):
// exe.addPackagePath("mod", "src/mod.zig");

// NOVO:
exe.root_module.addImport("mod", b.addModule(.{
    .name = "mod",
    .root_source_file = b.path("src/mod.zig"),
}));

// ANTIGO:
// .root_source_file = .{ .path = "src/main.zig" },

// NOVO:
.root_source_file = b.path("src/main.zig"),

// Mudanças em builtins (exemplos genéricos)
// Builtins podem ser renomeados ou ter assinatura alterada

// Sempre consulte a documentação da nova versão:
// https://ziglang.org/documentation/master/

// Funções podem ser movidas, renomeadas ou removidas
// Exemplo genérico:
// ANTIGO: std.mem.toSlice(u8, ptr)
// NOVO: std.mem.span(ptr)

// ANTIGO: std.fmt.bufPrint(...)
// NOVO: std.fmt.bufPrint(...) // mesma função, parâmetros podem mudar

# Verificar se dependências suportam a nova versão do Zig
# Consultar o repositório de cada dependência

# Atualizar hash se a dependência tem versão nova
zig fetch --save https://github.com/user/lib/archive/v2.0.tar.gz

# Se a dependência não suporta a nova versão:
# 1. Abrir issue no repositório da dependência
# 2. Usar versão de desenvolvimento (branch main)
# 3. Fazer fork e corrigir

# macOS
brew upgrade zls

# Ou baixar do GitHub
# https://github.com/zigtools/zls/releases

# Verificar compatibilidade
zig version
zls --version
# Devem ser versões compatíveis

# .github/workflows/ci.yml
# Atualizar a versão no CI
- uses: goto-bus-stop/setup-zig@v2
  with:
    version: 0.14.0  # Nova versão

const builtin = @import("builtin");

// Código compatível com múltiplas versões (quando necessário)
const zig_version = builtin.zig_version;

# Corrigir um erro de cada vez
zig build 2>&1 | head -5
# Corrigir o primeiro erro
# Repetir até compilar limpo

# O compilador frequentemente sugere a correção
zig build 2>&1
# Muitas mensagens de erro incluem "note: " com a sugestão

# Usar zig fmt para corrigir mudanças de formatação
zig fmt src/

# Se a atualização causa muitos problemas:
git checkout main  # Voltar para branch estável

# Reinstalar versão anterior
# Manter múltiplas versões do Zig disponíveis
# Criar aliases: zig-0.13, zig-0.14, etc.

# Criar arquivo .zig-version no projeto
echo "0.14.0" > .zig-version

# Documentar no README
# ## Requisitos
# - Zig >= 0.14.0

// No build.zig.zon — minimum_zig_version
.{
    .name = "meu-projeto",
    .version = "1.0.0",
    .minimum_zig_version = "0.14.0",
    .paths = .{"."},
}