cmake_minimum_required(VERSION 3.22)
project(starfox_3ds_frontend LANGUAGES CXX)
option(STARFOX_3DS_BUILD_NATIVE "Build the asset-free libctru diagnostic (not the game)" OFF)
option(STARFOX_3DS_BUILD_GPU_CHECK "Include the native Citro3D diagnostic (not the game)" ON)
option(STARFOX_3DS_BUILD_HOST_TESTS "Build platform-independent projection/LCD tests" ON)
option(STARFOX_3DS_BUILD_GAME_CORE "Link the actual cartridge VM/SPC/game session bring-up target" ${STARFOX_3DS_BUILD_NATIVE})
option(STARFOX_3DS_BUILD_TEST_PLAYER "Build an experimental full-menu player for the New Nintendo 3DS family" OFF)
option(STARFOX_3DS_PROFILE_FRAMES "Write bounded native phase timings to a separate diagnostic CSV" OFF)
option(STARFOX_3DS_ENABLE_IPO "Optimize the real native/core graph across translation units" OFF)
if(STARFOX_3DS_ENABLE_IPO)
    # Test the caller's actual compiler/target flags, including the native ABI.
    # An explicitly requested optimization must not silently become a baseline.
    if(POLICY CMP0138)
        cmake_policy(SET CMP0138 NEW)
    endif()
    include(CheckIPOSupported)
    check_ipo_supported(RESULT starfox_3ds_ipo_supported
        OUTPUT starfox_3ds_ipo_error LANGUAGES CXX)
    if(NOT starfox_3ds_ipo_supported)
        message(FATAL_ERROR "Requested 3DS IPO is unsupported: ${starfox_3ds_ipo_error}")
    endif()
endif()
if(STARFOX_3DS_PROFILE_FRAMES AND NOT STARFOX_3DS_BUILD_GAME_CORE)
    message(FATAL_ERROR "Native frame profiling requires the actual cartridge core.")
endif()

if(STARFOX_3DS_BUILD_TEST_PLAYER AND (NOT STARFOX_3DS_BUILD_NATIVE OR NOT STARFOX_3DS_BUILD_GAME_CORE OR NOT STARFOX_3DS_BUILD_GPU_CHECK))
    message(FATAL_ERROR "The 3DS test player requires the native SDK, cartridge core and PICA renderer; no desktop/mono substitute.")
endif()
add_library(starfox_3ds_frontend STATIC frontend.cpp cockpit_layout.cpp game_hud_editor.cpp game_remap.cpp game_quick_menu.cpp)
target_include_directories(starfox_3ds_frontend PUBLIC ../../include)
target_compile_features(starfox_3ds_frontend PUBLIC cxx_std_20)
add_library(starfox_3ds_source_geometry STATIC pica_shapes.cpp pica_source_spans.cpp
    ../../src/render/software_renderer.cpp ../../src/render/face_material.cpp
    ../../src/simulation/math.cpp ../../src/assets/rom.cpp)
target_include_directories(starfox_3ds_source_geometry PUBLIC ../../include)
target_compile_features(starfox_3ds_source_geometry PUBLIC cxx_std_20)
add_library(starfox_3ds_raster STATIC pica_raster.cpp bg2_tile_plan.cpp bg2_rolled_tile_plan.cpp pica_bg2_tiles.cpp
    ../../src/render/background_renderer.cpp ../../src/render/sprite_renderer.cpp)
target_include_directories(starfox_3ds_raster PUBLIC ../../include)
target_compile_features(starfox_3ds_raster PUBLIC cxx_std_20)
# Host raster/effect contracts consume the same cartridge scene snapshots as
# the console. They must not acquire desktop OpenXR helpers through that ABI.
target_compile_definitions(starfox_3ds_raster PUBLIC STARFOX_SCENE_SOURCE_ONLY=1)
if(STARFOX_3DS_BUILD_GAME_CORE)
    include(cartridge_core.cmake)
    if(STARFOX_3DS_PROFILE_FRAMES)
        target_compile_definitions(starfox_3ds_cartridge_core PUBLIC STARFOX_3DS_PROFILE_FRAMES=1)
        target_compile_definitions(starfox_3ds_raster PRIVATE STARFOX_3DS_PROFILE_FRAMES=1)
    endif()
endif()
if(STARFOX_3DS_BUILD_NATIVE)
    if(NOT CMAKE_CROSSCOMPILING OR NOT CMAKE_SYSTEM_NAME STREQUAL "Nintendo3DS")
        message(FATAL_ERROR "Use devkitPro's 3DS.cmake toolchain; a desktop compiler cannot build a 3DS app.")
    endif()
    find_path(STARFOX_CTRU_INCLUDE 3ds.h HINTS "${DEVKITPRO}/libctru/include" "$ENV{DEVKITPRO}/libctru/include" REQUIRED)
    find_library(STARFOX_CTRU_LIBRARY ctru HINTS "${DEVKITPRO}/libctru/lib" "$ENV{DEVKITPRO}/libctru/lib" REQUIRED)
    # The lean-core target compiles/links these actual sources. Retain the
    # limited ABI-only check when explicitly building without the VM/SPC core.
    if(NOT STARFOX_3DS_BUILD_GAME_CORE)
        add_library(starfox_3ds_game_models_arm_syntax OBJECT game_models.cpp
            ../../src/vr/source_pose_interpolation.cpp)
        target_include_directories(starfox_3ds_game_models_arm_syntax PRIVATE ../../include)
        target_compile_features(starfox_3ds_game_models_arm_syntax PRIVATE cxx_std_20)
    endif()
    add_library(starfox_3ds_native_audio STATIC native_audio.cpp native_csnd_check.cpp native_stem_executor.cpp)
    target_link_libraries(starfox_3ds_native_audio PUBLIC starfox_3ds_frontend PRIVATE "${STARFOX_CTRU_LIBRARY}")
    target_include_directories(starfox_3ds_native_audio SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
    if(STARFOX_3DS_PROFILE_FRAMES)
        target_compile_definitions(starfox_3ds_native_audio PRIVATE STARFOX_3DS_PROFILE_FRAMES=1)
    endif()
    add_executable(starfox_3ds_frontend_check frontend_probe.cpp native_display.cpp)
    target_include_directories(starfox_3ds_frontend_check SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
    target_link_libraries(starfox_3ds_frontend_check PRIVATE starfox_3ds_frontend starfox_3ds_native_audio "${STARFOX_CTRU_LIBRARY}" m)
    set_target_properties(starfox_3ds_frontend_check PROPERTIES SUFFIX ".elf")
    if(NOT COMMAND ctr_create_3dsx)
        message(FATAL_ERROR "The current devkitPro 3DS CMake helpers are required (3ds-cmake).")
    endif()
    ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/frontend-check.smdh"
        NAME "Star Fox Enhanced - frontend check"
        DESCRIPTION "Asset-free LCD, input and stereo diagnostic - not the game"
        AUTHOR "kandowontu")
    ctr_create_3dsx(starfox_3ds_frontend_check SMDH "${CMAKE_CURRENT_BINARY_DIR}/frontend-check.smdh")
    add_executable(starfox_3ds_spc_saturation_check spc_saturation_probe.cpp native_display.cpp)
    target_include_directories(starfox_3ds_spc_saturation_check SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
    target_link_libraries(starfox_3ds_spc_saturation_check PRIVATE starfox_3ds_frontend "${STARFOX_CTRU_LIBRARY}" m)
    set_target_properties(starfox_3ds_spc_saturation_check PROPERTIES SUFFIX ".elf")
    ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/spc-saturation-check.smdh"
        NAME "Star Fox Enhanced - SPC integer check"
        DESCRIPTION "Asset-free native signed-saturation arithmetic check - not the game"
        AUTHOR "kandowontu")
    ctr_create_3dsx(starfox_3ds_spc_saturation_check SMDH "${CMAKE_CURRENT_BINARY_DIR}/spc-saturation-check.smdh")
    add_executable(starfox_3ds_spc_counters_check spc_saturation_probe.cpp native_display.cpp)
    target_compile_definitions(starfox_3ds_spc_counters_check PRIVATE STARFOX_3DS_COUNTER_CHECK=1)
    target_include_directories(starfox_3ds_spc_counters_check SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
    target_link_libraries(starfox_3ds_spc_counters_check PRIVATE starfox_3ds_frontend "${STARFOX_CTRU_LIBRARY}" m)
    set_target_properties(starfox_3ds_spc_counters_check PROPERTIES SUFFIX ".elf")
    ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/spc-counters-check.smdh"
        NAME "Star Fox Enhanced - DSP counter check"
        DESCRIPTION "Asset-free exact DSP integer remainder check"
        AUTHOR "Star Fox Enhanced contributors")
    ctr_create_3dsx(starfox_3ds_spc_counters_check SMDH "${CMAKE_CURRENT_BINARY_DIR}/spc-counters-check.smdh")
    add_executable(starfox_3ds_spc_output_check spc_saturation_probe.cpp native_display.cpp)
    target_compile_definitions(starfox_3ds_spc_output_check PRIVATE STARFOX_3DS_OUTPUT_CHECK=1)
    target_include_directories(starfox_3ds_spc_output_check SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
    target_link_libraries(starfox_3ds_spc_output_check PRIVATE starfox_3ds_frontend "${STARFOX_CTRU_LIBRARY}" m)
    set_target_properties(starfox_3ds_spc_output_check PROPERTIES SUFFIX ".elf")
    ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/spc-output-check.smdh"
        NAME "Star Fox Enhanced - voice math check"
        DESCRIPTION "Asset-free exact voice output selection check"
        AUTHOR "Star Fox Enhanced contributors")
    ctr_create_3dsx(starfox_3ds_spc_output_check SMDH "${CMAKE_CURRENT_BINARY_DIR}/spc-output-check.smdh")
    if(STARFOX_3DS_BUILD_GAME_CORE)
        include(companion_manifest.cmake)
        add_executable(starfox_3ds_game_core_check game_core_probe.cpp native_display.cpp "${companion_header}")
        target_include_directories(starfox_3ds_game_core_check PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/generated")
        target_include_directories(starfox_3ds_game_core_check SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
        target_link_libraries(starfox_3ds_game_core_check PRIVATE starfox_3ds_cartridge_core
            starfox_3ds_native_audio "${STARFOX_CTRU_LIBRARY}" m)
        set_target_properties(starfox_3ds_game_core_check PROPERTIES SUFFIX ".elf")
        ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/game-core-check.smdh"
            NAME "Star Fox Enhanced - source core"
            DESCRIPTION "Actual cartridge VM / SPC / HUD bring-up - incomplete renderer"
            AUTHOR "kandowontu")
        ctr_create_3dsx(starfox_3ds_game_core_check SMDH "${CMAKE_CURRENT_BINARY_DIR}/game-core-check.smdh")
        if(STARFOX_3DS_BUILD_TEST_PLAYER)
            # Same real source owner as bring-up, without its diagnostic strip
            # covering gameplay. A distinct opt-in target keeps incomplete
            # hardware acceptance explicit rather than relabeling old binaries.
            add_executable(starfox_3ds_test_player game_core_probe.cpp native_display.cpp "${companion_header}")
            target_include_directories(starfox_3ds_test_player PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/generated")
            target_include_directories(starfox_3ds_test_player SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
            target_link_libraries(starfox_3ds_test_player PRIVATE starfox_3ds_cartridge_core
                starfox_3ds_native_audio "${STARFOX_CTRU_LIBRARY}" m)
            target_compile_definitions(starfox_3ds_test_player PRIVATE STARFOX_3DS_TEST_PLAYER=1)
            set_target_properties(starfox_3ds_test_player PROPERTIES SUFFIX ".elf")
            ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/test-player.smdh"
                NAME "Star Fox Enhanced - TEST"
                DESCRIPTION "Experimental New 3DS/XL stereo / New 2DS XL mono - testing required"
                AUTHOR "kandowontu")
            ctr_create_3dsx(starfox_3ds_test_player SMDH "${CMAKE_CURRENT_BINARY_DIR}/test-player.smdh")
        endif()
    endif()
    if(STARFOX_3DS_BUILD_GPU_CHECK)
        find_path(STARFOX_CITRO3D_INCLUDE citro3d.h HINTS "${DEVKITPRO}/libctru/include" "$ENV{DEVKITPRO}/libctru/include" REQUIRED)
        find_library(STARFOX_CITRO3D_LIBRARY citro3d HINTS "${DEVKITPRO}/libctru/lib" "$ENV{DEVKITPRO}/libctru/lib" REQUIRED)
        if(NOT COMMAND ctr_add_shader_library)
            message(FATAL_ERROR "The devkitPro Picasso/CMake shader helpers are required")
        endif()
        set(pica_shader "${CMAKE_CURRENT_BINARY_DIR}/pica_scene.shbin")
        ctr_add_shader_library(starfox_3ds_pica_shader OUTPUT "${pica_shader}" pica_scene.v.pica)
        find_package(Python3 COMPONENTS Interpreter REQUIRED)
        set(pica_shader_check "${CMAKE_CURRENT_SOURCE_DIR}/../../tools/check_3ds_shader.py")
        set(pica_header "${CMAKE_CURRENT_BINARY_DIR}/generated/pica_scene_shader.hpp")
        add_custom_command(OUTPUT "${pica_header}"
            COMMAND "${Python3_EXECUTABLE}" "${pica_shader_check}" "${pica_shader}"
            COMMAND "${CMAKE_COMMAND}" "-DINPUT=${pica_shader}" "-DOUTPUT=${pica_header}"
                -P "${CMAKE_CURRENT_SOURCE_DIR}/embed_shader.cmake"
            DEPENDS starfox_3ds_pica_shader "${pica_shader}" "${pica_shader_check}" "${CMAKE_CURRENT_SOURCE_DIR}/embed_shader.cmake"
            VERBATIM)
        add_library(starfox_3ds_native_gpu STATIC native_gpu.cpp)
        target_link_libraries(starfox_3ds_native_gpu PUBLIC starfox_3ds_frontend
            PRIVATE "${STARFOX_CITRO3D_LIBRARY}" "${STARFOX_CTRU_LIBRARY}")
        target_include_directories(starfox_3ds_native_gpu SYSTEM PRIVATE
            "${STARFOX_CTRU_INCLUDE}" "${STARFOX_CITRO3D_INCLUDE}")
        if(STARFOX_3DS_PROFILE_FRAMES)
            target_compile_definitions(starfox_3ds_native_gpu PRIVATE STARFOX_3DS_PROFILE_FRAMES=1)
        endif()
        if(STARFOX_3DS_BUILD_GAME_CORE)
            target_sources(starfox_3ds_game_core_check PRIVATE "${pica_header}")
            target_link_libraries(starfox_3ds_game_core_check PRIVATE starfox_3ds_native_gpu)
            target_compile_definitions(starfox_3ds_game_core_check PRIVATE STARFOX_3DS_CORE_PICA=1)
            if(STARFOX_3DS_BUILD_TEST_PLAYER)
                target_sources(starfox_3ds_test_player PRIVATE "${pica_header}")
                target_link_libraries(starfox_3ds_test_player PRIVATE starfox_3ds_native_gpu)
                target_compile_definitions(starfox_3ds_test_player PRIVATE STARFOX_3DS_CORE_PICA=1)
            endif()
        endif()
        add_executable(starfox_3ds_gpu_check gpu_probe.cpp native_display.cpp "${pica_header}")
        target_include_directories(starfox_3ds_gpu_check PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/generated")
        target_include_directories(starfox_3ds_gpu_check SYSTEM PRIVATE "${STARFOX_CTRU_INCLUDE}")
        target_link_libraries(starfox_3ds_gpu_check PRIVATE starfox_3ds_native_gpu
            starfox_3ds_source_geometry starfox_3ds_raster "${STARFOX_CTRU_LIBRARY}" m)
        set_target_properties(starfox_3ds_gpu_check PROPERTIES SUFFIX ".elf")
        ctr_generate_smdh(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/gpu-check.smdh"
            NAME "Star Fox Enhanced - GPU check"
            DESCRIPTION "Asset-free PICA textures, depth and stereo check - not the game"
            AUTHOR "kandowontu")
        ctr_create_3dsx(starfox_3ds_gpu_check SMDH "${CMAKE_CURRENT_BINARY_DIR}/gpu-check.smdh")
    endif()
    # Keep compiler frame evidence alongside the real ARM binaries. The package
    # gate checks the linked libctru stack reservation, not just host builds.
    foreach(target starfox_3ds_frontend starfox_3ds_source_geometry starfox_3ds_raster
            starfox_3ds_native_audio starfox_3ds_frontend_check starfox_3ds_spc_saturation_check starfox_3ds_spc_counters_check
            starfox_3ds_spc_output_check
            starfox_3ds_cartridge_core starfox_3ds_spc starfox_3ds_cpu
            starfox_3ds_native_gpu starfox_3ds_gpu_check
            starfox_3ds_game_core_check starfox_3ds_test_player)
        if(TARGET ${target})
            target_compile_options(${target} PRIVATE -fstack-usage)
            # The native toolchain defaults Release to O2. Keep its ARM ABI,
            # floating-point semantics and diagnostic stack reports, while
            # optimizing the complete actual native source graph at O3.
            # This is not Ofast/fast-math, and does not enable IPO implicitly.
            if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
                target_compile_options(${target} PRIVATE $<$<CONFIG:Release>:-O3>)
            endif()
            if(STARFOX_3DS_ENABLE_IPO AND CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
                get_target_property(target_type ${target} TYPE)
                if(target_type STREQUAL "EXECUTABLE")
                    # LTO emits machine-code frames at link time, not when
                    # compiling GIMPLE objects. Retain those actual reports
                    # beside the ELF so the unchanged stack gate can read them.
                    target_link_options(${target} PRIVATE -fstack-usage)
                endif()
            endif()
        endif()
    endforeach()
elseif(STARFOX_3DS_BUILD_HOST_TESTS)
    enable_testing()
    # Compile the diagnostic owner without linking it to a fake display. This
    # catches ordinary C++/frontend API regressions when the native SDK is not
    # installed; it does not validate libctru or produce a desktop game.
    add_library(starfox_3ds_probe_syntax OBJECT frontend_probe.cpp)
    target_link_libraries(starfox_3ds_probe_syntax PRIVATE starfox_3ds_frontend)
    add_executable(starfox_3ds_frontend_tests ../../tests/nintendo_3ds_frontend_tests.cpp)
    target_link_libraries(starfox_3ds_frontend_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_frontend_tests COMMAND starfox_3ds_frontend_tests)
    add_executable(starfox_3ds_display_tests ../../tests/nintendo_3ds_display_tests.cpp native_display.cpp)
    target_include_directories(starfox_3ds_display_tests PRIVATE ../../tests/3ds_display_stubs .)
    target_link_libraries(starfox_3ds_display_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_display_tests COMMAND starfox_3ds_display_tests)
    add_executable(starfox_3ds_game_remap_tests ../../tests/nintendo_3ds_game_remap_tests.cpp)
    target_link_libraries(starfox_3ds_game_remap_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_game_remap_tests COMMAND starfox_3ds_game_remap_tests)
    add_executable(starfox_3ds_game_hud_editor_tests ../../tests/nintendo_3ds_game_hud_editor_tests.cpp)
    target_link_libraries(starfox_3ds_game_hud_editor_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_game_hud_editor_tests COMMAND starfox_3ds_game_hud_editor_tests)
    add_executable(starfox_3ds_game_quick_menu_tests ../../tests/nintendo_3ds_game_quick_menu_tests.cpp)
    target_link_libraries(starfox_3ds_game_quick_menu_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_game_quick_menu_tests COMMAND starfox_3ds_game_quick_menu_tests)
    add_executable(starfox_3ds_audio_tests ../../tests/nintendo_3ds_audio_tests.cpp)
    target_link_libraries(starfox_3ds_audio_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_audio_tests COMMAND starfox_3ds_audio_tests)
    add_executable(starfox_3ds_native_audio_tests ../../tests/nintendo_3ds_native_audio_tests.cpp native_audio.cpp)
    target_include_directories(starfox_3ds_native_audio_tests PRIVATE ../../tests/3ds_audio_stubs ../../include)
    target_compile_features(starfox_3ds_native_audio_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_3ds_native_audio_tests COMMAND starfox_3ds_native_audio_tests)
    find_package(Threads REQUIRED)
    add_executable(starfox_3ds_native_stem_executor_tests
        ../../tests/nintendo_3ds_native_stem_executor_tests.cpp native_stem_executor.cpp)
    target_include_directories(starfox_3ds_native_stem_executor_tests PRIVATE
        ../../tests/3ds_stem_stubs ../../include .)
    target_compile_features(starfox_3ds_native_stem_executor_tests PRIVATE cxx_std_20)
    target_link_libraries(starfox_3ds_native_stem_executor_tests PRIVATE Threads::Threads)
    add_test(NAME starfox_3ds_native_stem_executor_tests COMMAND starfox_3ds_native_stem_executor_tests)
    # Reuse only the explicit host libctru doubles from the adapter fixture.
    # Its main is renamed per target, never in the real native SDK build.
    add_library(starfox_3ds_stem_test_runtime STATIC
        ../../tests/nintendo_3ds_native_stem_executor_tests.cpp native_stem_executor.cpp)
    target_include_directories(starfox_3ds_stem_test_runtime PRIVATE
        ../../tests/3ds_stem_stubs ../../include .)
    target_compile_features(starfox_3ds_stem_test_runtime PRIVATE cxx_std_20)
    target_compile_definitions(starfox_3ds_stem_test_runtime PRIVATE
        main=worker_api_fixture_main STARFOX_STEM_TEST_NEW_MODEL=1)
    target_link_libraries(starfox_3ds_stem_test_runtime PRIVATE Threads::Threads)
    add_executable(starfox_3ds_csnd_check_tests ../../tests/nintendo_3ds_csnd_check_tests.cpp native_csnd_check.cpp)
    target_include_directories(starfox_3ds_csnd_check_tests PRIVATE ../../tests/3ds_audio_stubs ../../include)
    target_compile_features(starfox_3ds_csnd_check_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_3ds_csnd_check_tests COMMAND starfox_3ds_csnd_check_tests)
    add_executable(starfox_3ds_pica_tests ../../tests/nintendo_3ds_pica_tests.cpp)
    target_link_libraries(starfox_3ds_pica_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_pica_tests COMMAND starfox_3ds_pica_tests)
    add_executable(starfox_3ds_draw_transform_tests ../../tests/nintendo_3ds_draw_transform_tests.cpp)
    target_link_libraries(starfox_3ds_draw_transform_tests PRIVATE starfox_3ds_frontend)
    add_test(NAME starfox_3ds_draw_transform_tests COMMAND starfox_3ds_draw_transform_tests)
    add_executable(starfox_3ds_source_geometry_tests ../../tests/nintendo_3ds_source_geometry_tests.cpp)
    target_link_libraries(starfox_3ds_source_geometry_tests PRIVATE starfox_3ds_source_geometry)
    add_test(NAME starfox_3ds_source_geometry_tests COMMAND starfox_3ds_source_geometry_tests)
    add_executable(starfox_3ds_source_spans_tests ../../tests/nintendo_3ds_source_spans_tests.cpp)
    target_link_libraries(starfox_3ds_source_spans_tests PRIVATE starfox_3ds_source_geometry)
    add_test(NAME starfox_3ds_source_spans_tests COMMAND starfox_3ds_source_spans_tests)
    add_executable(starfox_source_polygon_spans_tests ../../tests/source_polygon_spans_tests.cpp)
    target_link_libraries(starfox_source_polygon_spans_tests PRIVATE starfox_3ds_source_geometry)
    add_test(NAME starfox_source_polygon_spans_tests COMMAND starfox_source_polygon_spans_tests)
    add_executable(starfox_3ds_source_models_check ../../tools/check_3ds_source_models.cpp
        ../../src/assets/shape_decoder.cpp)
    target_link_libraries(starfox_3ds_source_models_check PRIVATE starfox_3ds_source_geometry)
    add_executable(starfox_3ds_hud_routing_tests ../../tests/nintendo_3ds_hud_routing_tests.cpp
        ../../src/render/sprite_renderer.cpp)
    target_include_directories(starfox_3ds_hud_routing_tests PRIVATE ../../include)
    target_compile_features(starfox_3ds_hud_routing_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_3ds_hud_routing_tests COMMAND starfox_3ds_hud_routing_tests)
    add_executable(starfox_3ds_raster_tests ../../tests/nintendo_3ds_raster_tests.cpp)
    target_link_libraries(starfox_3ds_raster_tests PRIVATE starfox_3ds_raster)
    add_test(NAME starfox_3ds_raster_tests COMMAND starfox_3ds_raster_tests)
    add_executable(starfox_3ds_raster_colour_tests ../../tests/nintendo_3ds_raster_colour_tests.cpp)
    target_link_libraries(starfox_3ds_raster_colour_tests PRIVATE starfox_3ds_raster)
    add_test(NAME starfox_3ds_raster_colour_tests COMMAND starfox_3ds_raster_colour_tests)
    add_executable(starfox_tilemap_coordinates_tests ../../tests/tilemap_coordinates_tests.cpp)
    target_compile_features(starfox_tilemap_coordinates_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_tilemap_coordinates_tests COMMAND starfox_tilemap_coordinates_tests)
    add_executable(starfox_background_scanline_tests ../../tests/background_scanline_tests.cpp)
    target_link_libraries(starfox_background_scanline_tests PRIVATE starfox_3ds_raster)
    add_test(NAME starfox_background_scanline_tests COMMAND starfox_background_scanline_tests)
    add_executable(starfox_tunnel_scanline_tests ../../tests/tunnel_scanline_tests.cpp)
    target_link_libraries(starfox_tunnel_scanline_tests PRIVATE starfox_3ds_raster)
    add_test(NAME starfox_tunnel_scanline_tests COMMAND starfox_tunnel_scanline_tests)
    add_executable(starfox_framebuffer_extents_tests ../../tests/framebuffer_extents_tests.cpp)
    target_include_directories(starfox_framebuffer_extents_tests PRIVATE ../../include)
    target_compile_features(starfox_framebuffer_extents_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_framebuffer_extents_tests COMMAND starfox_framebuffer_extents_tests)
    add_executable(starfox_3ds_frame_profile_tests ../../tests/nintendo_3ds_frame_profile_tests.cpp)
    target_include_directories(starfox_3ds_frame_profile_tests PRIVATE ../../include)
    target_compile_features(starfox_3ds_frame_profile_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_3ds_frame_profile_tests COMMAND starfox_3ds_frame_profile_tests)
    add_executable(starfox_3ds_program_binding_tests ../../tests/nintendo_3ds_program_binding_tests.cpp)
    target_include_directories(starfox_3ds_program_binding_tests PRIVATE ../../include)
    target_compile_features(starfox_3ds_program_binding_tests PRIVATE cxx_std_20)
    add_test(NAME starfox_3ds_program_binding_tests COMMAND starfox_3ds_program_binding_tests)
    foreach(trace_variant IN ITEMS disabled enabled)
        add_executable(starfox_3ds_startup_trace_${trace_variant}_tests ../../tests/nintendo_3ds_startup_trace_tests.cpp)
        target_include_directories(starfox_3ds_startup_trace_${trace_variant}_tests PRIVATE ../../include)
        target_compile_features(starfox_3ds_startup_trace_${trace_variant}_tests PRIVATE cxx_std_20)
        if(trace_variant STREQUAL "enabled")
            target_compile_definitions(starfox_3ds_startup_trace_${trace_variant}_tests PRIVATE STARFOX_3DS_PROFILE_FRAMES=1)
        endif()
        add_test(NAME starfox_3ds_startup_trace_${trace_variant}_tests COMMAND starfox_3ds_startup_trace_${trace_variant}_tests)
    endforeach()
    if(STARFOX_3DS_BUILD_GAME_CORE)
        include(companion_manifest.cmake)
        add_executable(starfox_owned_65816_step_tests ../../tests/owned_65816_step_tests.cpp)
        target_link_libraries(starfox_owned_65816_step_tests PRIVATE starfox_3ds_cpu)
        target_compile_features(starfox_owned_65816_step_tests PRIVATE cxx_std_20)
        add_test(NAME starfox_owned_65816_step_tests COMMAND starfox_owned_65816_step_tests)
        add_test(NAME starfox_owned_65816_memory_tests
            COMMAND starfox_owned_65816_step_tests --cpu-workload-benchmark)
        add_executable(starfox_object_record_tests ../../tests/object_record_tests.cpp)
        target_link_libraries(starfox_object_record_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_object_record_tests COMMAND starfox_object_record_tests)
        add_executable(starfox_bus_transfer_tests ../../tests/bus_transfer_tests.cpp)
        target_link_libraries(starfox_bus_transfer_tests PRIVATE starfox_3ds_cartridge_core starfox_3ds_cpu)
        add_test(NAME starfox_bus_transfer_tests COMMAND starfox_bus_transfer_tests)
        add_test(NAME starfox_3ds_test_package_contract
            COMMAND "${Python3_EXECUTABLE}" "${CMAKE_CURRENT_SOURCE_DIR}/../../tests/test_3ds_package.py")
        add_test(NAME starfox_3ds_shader_output_contract
            COMMAND "${Python3_EXECUTABLE}" "${CMAKE_CURRENT_SOURCE_DIR}/../../tests/test_3ds_shader.py")
        add_executable(starfox_3ds_game_assets_tests ../../tests/nintendo_3ds_game_assets_tests.cpp "${companion_header}")
        target_include_directories(starfox_3ds_game_assets_tests PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/generated")
        target_link_libraries(starfox_3ds_game_assets_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_assets_tests COMMAND starfox_3ds_game_assets_tests "${CMAKE_CURRENT_SOURCE_DIR}/../..")
        add_executable(starfox_3ds_game_layers_tests ../../tests/nintendo_3ds_game_layers_tests.cpp)
        target_link_libraries(starfox_3ds_game_layers_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_layers_tests COMMAND starfox_3ds_game_layers_tests)
        add_executable(starfox_3ds_bg2_tile_tests ../../tests/nintendo_3ds_bg2_tile_tests.cpp)
        target_link_libraries(starfox_3ds_bg2_tile_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_bg2_tile_tests COMMAND starfox_3ds_bg2_tile_tests)
        add_executable(starfox_3ds_game_dots_tests ../../tests/nintendo_3ds_game_dots_tests.cpp)
        target_link_libraries(starfox_3ds_game_dots_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_dots_tests COMMAND starfox_3ds_game_dots_tests)
        add_executable(starfox_3ds_game_session_check ../../tools/check_3ds_game_session.cpp)
        target_link_libraries(starfox_3ds_game_session_check PRIVATE starfox_3ds_cartridge_core)
        add_executable(starfox_3ds_parallel_game_session_check ../../tools/check_3ds_game_session.cpp)
        target_compile_definitions(starfox_3ds_parallel_game_session_check PRIVATE STARFOX_3DS_CHECK_PARALLEL_AUDIO=1)
        target_include_directories(starfox_3ds_parallel_game_session_check PRIVATE .)
        target_link_libraries(starfox_3ds_parallel_game_session_check PRIVATE
            starfox_3ds_cartridge_core starfox_3ds_stem_test_runtime Threads::Threads)
        add_executable(starfox_3ds_cpu_timing_check ../../tools/check_3ds_cpu_timing.cpp)
        target_link_libraries(starfox_3ds_cpu_timing_check PRIVATE starfox_3ds_cartridge_core)
        add_executable(starfox_3ds_game_hud_check ../../tools/check_3ds_game_hud.cpp)
        target_link_libraries(starfox_3ds_game_hud_check PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_hud_status COMMAND starfox_3ds_game_hud_check)
        add_executable(starfox_3ds_direct_audio_check ../../tests/direct_audio_tests.cpp)
        target_link_libraries(starfox_3ds_direct_audio_check PRIVATE starfox_3ds_cartridge_core)
        add_executable(starfox_spc_stems_tests ../../tests/spc_stems_tests.cpp)
        target_link_libraries(starfox_spc_stems_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_spc_stems_tests COMMAND starfox_spc_stems_tests)
        add_executable(starfox_spc_parallel_stems_tests ../../tests/spc_stems_tests.cpp)
        target_compile_definitions(starfox_spc_parallel_stems_tests PRIVATE STARFOX_SPC_PARALLEL_ORACLE=1)
        target_include_directories(starfox_spc_parallel_stems_tests PRIVATE .)
        target_link_libraries(starfox_spc_parallel_stems_tests PRIVATE
            starfox_3ds_cartridge_core starfox_3ds_stem_test_runtime Threads::Threads)
        add_test(NAME starfox_spc_parallel_stems_tests COMMAND starfox_spc_parallel_stems_tests)
        add_executable(starfox_3ds_spc_timers_tests ../../tests/nintendo_3ds_spc_timers_tests.cpp)
        target_link_libraries(starfox_3ds_spc_timers_tests PRIVATE starfox_3ds_frontend)
        add_test(NAME starfox_3ds_spc_timers_tests COMMAND starfox_3ds_spc_timers_tests)
        add_executable(starfox_3ds_spc_saturation_tests ../../tests/nintendo_3ds_spc_saturation_tests.cpp)
        target_link_libraries(starfox_3ds_spc_saturation_tests PRIVATE starfox_3ds_frontend)
        add_test(NAME starfox_3ds_spc_saturation_tests COMMAND starfox_3ds_spc_saturation_tests)
        add_executable(starfox_3ds_spc_counters_tests ../../tests/nintendo_3ds_spc_counters_tests.cpp)
        target_link_libraries(starfox_3ds_spc_counters_tests PRIVATE starfox_3ds_frontend)
        add_test(NAME starfox_3ds_spc_counters_tests COMMAND starfox_3ds_spc_counters_tests)
        add_executable(starfox_3ds_spc_ram_tests ../../tests/nintendo_3ds_spc_ram_tests.cpp)
        target_link_libraries(starfox_3ds_spc_ram_tests PRIVATE starfox_3ds_frontend)
        add_test(NAME starfox_3ds_spc_ram_tests COMMAND starfox_3ds_spc_ram_tests)
        add_executable(starfox_3ds_spc_output_tests ../../tests/nintendo_3ds_spc_output_tests.cpp)
        target_link_libraries(starfox_3ds_spc_output_tests PRIVATE starfox_3ds_frontend)
        add_test(NAME starfox_3ds_spc_output_tests COMMAND starfox_3ds_spc_output_tests)
        add_executable(starfox_3ds_game_menu_tests ../../tests/nintendo_3ds_game_menu_tests.cpp)
        target_link_libraries(starfox_3ds_game_menu_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_menu_tests COMMAND starfox_3ds_game_menu_tests)
        add_executable(starfox_3ds_game_storage_tests ../../tests/nintendo_3ds_game_storage_tests.cpp)
        target_link_libraries(starfox_3ds_game_storage_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_storage_tests COMMAND starfox_3ds_game_storage_tests)
        add_executable(starfox_3ds_game_state_tests ../../tests/nintendo_3ds_game_state_tests.cpp)
        target_link_libraries(starfox_3ds_game_state_tests PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_state_tests COMMAND starfox_3ds_game_state_tests)
        add_executable(starfox_3ds_game_models_check ../../tools/check_3ds_game_models.cpp "${companion_header}")
        target_include_directories(starfox_3ds_game_models_check PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/generated")
        target_link_libraries(starfox_3ds_game_models_check PRIVATE starfox_3ds_cartridge_core)
        add_executable(starfox_3ds_native_model_check ../../tools/check_3ds_native_model.cpp)
        target_link_libraries(starfox_3ds_native_model_check PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_game_models_cli
            COMMAND "${CMAKE_COMMAND}" "-DCHECKER=$<TARGET_FILE:starfox_3ds_game_models_check>"
                -P "${CMAKE_CURRENT_SOURCE_DIR}/../../tests/nintendo_3ds_game_models_cli.cmake")
        add_executable(starfox_3ds_fortuna_inputs_check ../../tools/check_3ds_fortuna_inputs.cpp "${companion_header}")
        target_include_directories(starfox_3ds_fortuna_inputs_check PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/generated")
        target_link_libraries(starfox_3ds_fortuna_inputs_check PRIVATE starfox_3ds_cartridge_core)
        add_test(NAME starfox_3ds_fortuna_inputs_cli
            COMMAND "${CMAKE_COMMAND}" "-DCHECKER=$<TARGET_FILE:starfox_3ds_fortuna_inputs_check>"
                -P "${CMAKE_CURRENT_SOURCE_DIR}/../../tests/nintendo_3ds_fortuna_inputs_cli.cmake")
        include("${CMAKE_CURRENT_SOURCE_DIR}/../../tests/nintendo_3ds_cartridge_tests.cmake")
    endif()
endif()

if(STARFOX_3DS_ENABLE_IPO)
    # Include SPC, CPU, shared PPU and the actual scene owner, not just a small
    # diagnostic executable. External SDK libraries keep their original ABI.
    get_property(starfox_3ds_build_targets DIRECTORY PROPERTY BUILDSYSTEM_TARGETS)
    foreach(target IN LISTS starfox_3ds_build_targets)
        get_target_property(target_type ${target} TYPE)
        if(target_type MATCHES "^(STATIC_LIBRARY|OBJECT_LIBRARY|EXECUTABLE)$")
            set_property(TARGET ${target} PROPERTY INTERPROCEDURAL_OPTIMIZATION TRUE)
            message(STATUS "3DS IPO enabled: ${target}")
        endif()
    endforeach()
endif()
