Function compile_wasm

ci/wasm_compile_native.py:227–385

Compile a FastLED sketch to WebAssembly using incremental compilation. Build phases: 1. Ensure PCH is up-to-date (via wasm_build_library.py dependency) 2. Ensure library is up-to-date (calls wasm_build_library.py) 3. Compile sketch wrapper to object file (always rebuild)

(
    source_file: Path,
    output_file: Path,
    build_mode: str = "quick",
    verbose: bool = False,
    force: bool = False,
    unity_chunks: int = 0,
)

def compile_wasm(
    source_file: Path,
    output_file: Path,
    build_mode: str = "quick",
    verbose: bool = False,
    force: bool = False,
    unity_chunks: int = 0,
) -> int:
    """
    Compile a FastLED sketch to WebAssembly using incremental compilation.

    Build phases:
      1. Ensure PCH is up-to-date (via wasm_build_library.py dependency)
      2. Ensure library is up-to-date (calls wasm_build_library.py)
      3. Compile sketch wrapper to object file (always rebuild)
      4. Compile entry_point.cpp to object file (always rebuild)
      5. Link sketch.o + entry_point.o + libfastled.a -> wasm

    Args:
        source_file: Path to wrapper .cpp file or example name
        output_file: Output .js file path
        build_mode: Build mode (debug, fast_debug, quick, release)
        verbose: Enable verbose output
        force: Force rebuild of all components
        unity_chunks: Number of unity build chunks (0 = disabled)

    Returns:
        Exit code (0 = success)
    """
    try:
        start_time = time.time()
        print(f"Building FastLED sketch to WASM (mode: {build_mode})...")

        # Get tool command
        emcc = get_emcc()
        if verbose:
            print(f"Using emscripten: {emcc}")

        # Create build directories
        BUILD_DIR.mkdir(parents=True, exist_ok=True)
        LTO_CACHE_DIR.mkdir(parents=True, exist_ok=True)

        # Phase 1 & 2: Ensure library is up-to-date (also ensures PCH is up-to-date)
        phase2_start = time.time()
        if not ensure_library_built(build_mode, verbose, force, unity_chunks):
            print("✗ Library build failed")
            return 1
        phase2_time = time.time() - phase2_start
        if verbose:
            print(f"Library build phase: {phase2_time:.2f}s")

        # Load build flags for sketch compilation
        flags = get_sketch_compile_flags_dict(build_mode)
        if verbose:
            print(
                f"Loaded {len(flags['defines'])} defines, {len(flags['compiler_flags'])} compiler flags, {len(flags['link_flags'])} link flags"
            )