skate-3-rust-engine/scripts/Build.ps1

param(
    [switch]$StageOnly,
    [switch]$WithRelay,
    [switch]$Dev,
    [string]$TargetDirectory = (Join-Path (Split-Path $PSScriptRoot -Parent) 'target')
)
# Fast local iteration: Bevy dynamic_linking (default features) + stable target/.
# Do NOT pass --no-default-features here — that static-links Bevy and takes many minutes.
$ProjectRoot = Split-Path $PSScriptRoot -Parent
$ErrorActionPreference = 'Stop'
. (Join-Path $PSScriptRoot 'Ensure-CMake.ps1')
$sw = [Diagnostics.Stopwatch]::StartNew()
Push-Location $ProjectRoot
try {
    if (-not $StageOnly) {
        $packages = @('-p', 'skate-game')
        if ($WithRelay) { $packages += @('-p', 'skate-steam-relay') }
        $buildArgs = @('build') + $packages + @('--bin', 'skate3rust', '--target-dir', $TargetDirectory)
        if (-not $Dev) { $buildArgs += '--release' }
        & cargo @buildArgs
        if ($LASTEXITCODE -ne 0) { throw 'Build failed; see the compiler output above.' }
        # Native RefPack for asset setup from this checkout (fast_refpack.py loads
        # target/native/refpack.dll; releases bundle the same DLL). Without it
        # setup decodes RefPack in pure Python, ~10x slower. Same flags as releases.
        $refpackSource = Join-Path $ProjectRoot 'tools/asset_pipeline/refpack_native.rs'
        $refpack = Join-Path $ProjectRoot 'target/native/refpack.dll'
        if (-not (Test-Path -LiteralPath $refpack) -or (Get-Item -LiteralPath $refpackSource).LastWriteTime -gt (Get-Item -LiteralPath $refpack).LastWriteTime) {
            New-Item -ItemType Directory -Path (Split-Path $refpack) -Force | Out-Null
            & rustc --edition 2024 --crate-type cdylib -C opt-level=3 -C panic=abort -C target-feature=+crt-static $refpackSource -o $refpack
            if ($LASTEXITCODE -ne 0) { throw 'Native RefPack compilation failed' }
        }
    }
    $profile = if ($Dev) { 'debug' } else { 'release' }
    $debugDirectory = Join-Path $TargetDirectory $profile
    $executable = Join-Path $debugDirectory 'skate3rust.exe'
    if (-not (Test-Path -LiteralPath $executable)) { throw "Missing executable: $executable" }
    $readobj = Join-Path $env:ProgramFiles 'LLVM/bin/llvm-readobj.exe'
    if (-not (Test-Path -LiteralPath $readobj)) { throw 'LLVM llvm-readobj is required to stage exact runtime DLL dependencies.' }
    $rustLibraries = (& rustc --print target-libdir).Trim()
    if ($LASTEXITCODE -ne 0) { throw 'Could not locate Rust runtime libraries.' }
    $binDirectory = Join-Path $ProjectRoot 'bin'
    New-Item -ItemType Directory -Path $binDirectory -Force | Out-Null
    # Get-FileHash is missing from the PowerShell BUILD.bat launches, which used
    # to abort staging before manifest.json was written.
    function Get-StagedHash([string]$Path) {
        $sha = [System.Security.Cryptography.SHA256]::Create()
        try {
            $stream = [System.IO.File]::OpenRead($Path)
            try { ($sha.ComputeHash($stream) | ForEach-Object { $_.ToString('X2') }) -join '' }
            finally { $stream.Dispose() }
        } finally { $sha.Dispose() }
    }
    $queue = [System.Collections.Generic.Queue[string]]::new()
    $queue.Enqueue($executable)
    $seen = @{}
    $staged = @()
    while ($queue.Count -gt 0) {
        $source = $queue.Dequeue()
        $name = Split-Path -Leaf $source
        if ($seen.ContainsKey($name)) { continue }
        $seen[$name] = $true
        $destination = Join-Path $binDirectory $name
        Copy-Item -LiteralPath $source -Destination $destination -Force
        $staged += @{name = $name; sha256 = (Get-StagedHash $destination)}
        # Keep development backtraces useful after staging the EXE and Bevy DLLs.
        $pdb = [IO.Path]::ChangeExtension($source, '.pdb')
        if (Test-Path -LiteralPath $pdb) {
            $symbolDestination = Join-Path $binDirectory (Split-Path -Leaf $pdb)
            Copy-Item -LiteralPath $pdb -Destination $symbolDestination -Force
            $staged += @{name = (Split-Path -Leaf $pdb); sha256 = (Get-StagedHash $symbolDestination)}
        }
        $imports = & $readobj --coff-imports $source
        if ($LASTEXITCODE -ne 0) { throw "Could not inspect DLL imports: $source" }
        foreach ($line in $imports) {
            if ($line -match '^\s+Name: (.+\.dll)$') {
                $dependency = $Matches[1]
                $found = $false
                foreach ($directory in @($debugDirectory, (Join-Path $debugDirectory 'deps'), $rustLibraries)) {
                    $candidate = Join-Path $directory $dependency
                    if (Test-Path -LiteralPath $candidate) {
                        $queue.Enqueue($candidate)
                        $found = $true
                        break
                    }
                }
                if (-not $found -and $dependency -notmatch '^(api-ms-|ext-ms-)' -and
                    -not (Test-Path -LiteralPath (Join-Path $env:WINDIR "System32/$dependency"))) {
                    throw "Runtime dependency not found: $dependency"
                }
            }
        }
    }
    if ($WithRelay -or (Test-Path -LiteralPath (Join-Path $binDirectory 'steam-relay/skate-steam-relay.exe'))) {
        if ($WithRelay) {
            & (Join-Path $PSScriptRoot 'Stage-SteamRelay.ps1') -TargetDirectory $TargetDirectory -BinDirectory $binDirectory
        }
        foreach ($name in @('steam-relay/skate-steam-relay.exe', 'steam-relay/steam_api64.dll')) {
            $path = Join-Path $binDirectory $name
            if (Test-Path -LiteralPath $path) {
                $staged += @{name = $name; sha256 = (Get-StagedHash $path)}
            }
        }
    }
    $staged | ConvertTo-Json | Set-Content -LiteralPath (Join-Path $binDirectory 'manifest.json') -Encoding UTF8
    $label = if ($Dev) { 'debug (fast rebuild; use BUILD_DEV.bat)' } else { 'release' }
    Write-Host ("Ready: {0}/skate3rust.exe [{1}] ({2:n1}s)" -f $binDirectory, $label, $sw.Elapsed.TotalSeconds)
} finally { Pop-Location }