Function compile_pch

ci/wasm_compile_pch.py:296–387

Compile the PCH file. Args: emcc: Compiler command (e.g., 'clang-tool-chain-emcc') flags: Compilation flags from TOML verbose: Enable verbose output Returns: Exit code (0 = success)

(
    emcc: str,
    flags: dict[str, list[str]],
    verbose: bool = False,
)

def compile_pch(
    emcc: str,
    flags: dict[str, list[str]],
    verbose: bool = False,
) -> int:
    """
    Compile the PCH file.

    Args:
        emcc: Compiler command (e.g., 'clang-tool-chain-emcc')
        flags: Compilation flags from TOML
        verbose: Enable verbose output

    Returns:
        Exit code (0 = success)
    """
    print(f"Compiling PCH: {PCH_HEADER.name} -> {PCH_OUTPUT.name}...")

    # Ensure build directory exists
    BUILD_DIR.mkdir(parents=True, exist_ok=True)

    # Build includes (must match regular compilation)
    includes = [
        f"-I{PROJECT_ROOT / 'src'}",
        f"-I{PROJECT_ROOT / 'src' / 'platforms' / 'wasm'}",
        f"-I{PROJECT_ROOT / 'src' / 'platforms' / 'wasm' / 'compiler'}",
    ]

    # PCH validation flags (catch invalidation/corruption issues)
    pch_validation_flags = [
        "-Werror=invalid-pch",  # Treat invalid PCH as hard error
        "-verify-pch",  # Load and verify PCH is not stale
        "-fpch-validate-input-files-content",  # Validate based on content, not mtime
        "-fpch-instantiate-templates",  # Instantiate templates during PCH build
    ]

    # Build command using compile_pch.py wrapper (fixes depfile)
    cmd = (
        [
            "uv",
            "run",
            "python",
            str(PROJECT_ROOT / "ci" / "compile_pch.py"),
            emcc,
            "-x",
            "c++-header",  # Treat input as C++ header
            str(PCH_HEADER),  # Input: wasm_pch.h
            "-o",
            str(PCH_OUTPUT),  # Output: wasm_pch.h.pch
            "-MD",
            "-MF",
            str(PCH_DEPFILE),  # Generate dependency file
        ]
        + includes
        + flags["defines"]
        + flags["compiler_flags"]
        + pch_validation_flags
    )