refactor: Modularize CMake build system into 10 specialized modules

Refactor monolithic 866-line CMakeLists.txt into 54-line orchestrator + 10 modules:
- DemoOptions.cmake - Build option declarations
- DemoConfig.cmake - Option implications and platform detection
- DemoCommon.cmake - Shared macros (conditional sources, size opts, linking)
- DemoDependencies.cmake - External library discovery (WGPU, GLFW)
- DemoSourceLists.cmake - Conditional source file lists
- DemoLibraries.cmake - Subsystem library targets
- DemoTools.cmake - Build tools (asset_packer, compilers)
- DemoCodegen.cmake - Code generation (assets, timeline, music)
- DemoExecutables.cmake - Main binaries (demo64k, test_demo)
- DemoTests.cmake - Test infrastructure (36 tests)
- Validation.cmake - Uniform buffer validation

Benefits:
- 94% reduction in main file size (866 → 54 lines)
- Conditional module inclusion (tests only parsed if DEMO_BUILD_TESTS=ON)
- Shared macros eliminate 200+ lines of repetition
- Clear separation of concerns

All 36 tests passing. All build modes verified.

Documentation: Created doc/CMAKE_MODULES.md with module architecture.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

1 files changed, 24 insertions, 835 deletions

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 6536c9a..c32692c 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -4,66 +4,13 @@ project(demo64k LANGUAGES C CXX)
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
-#-- - Configuration Options -- -
-option(DEMO_SIZE_OPT "Enable size optimization flags" OFF)
-option(DEMO_STRIP_ALL "Strip all unnecessary code for final build" OFF)
-option(DEMO_FINAL_STRIP "Strip ALL error checking for final-final build" OFF)
-option(DEMO_STRIP_EXTERNAL_LIBS "Stub external libs for size measurement (binary won't run)" OFF)
-option(DEMO_BUILD_TESTS "Build tests" OFF)
-option(DEMO_BUILD_TOOLS "Build tools" OFF)
-option(DEMO_ENABLE_COVERAGE "Enable code coverage generation (macOS only)" OFF)
-option(DEMO_ENABLE_DEBUG_LOGS "Enable all debug logging (for pre-commit checks)" OFF)
-option(DEMO_HEADLESS "Build headless mode (functional stubs for testing)" OFF)
-option(DEMO_ALL_OPTIONS "Activate all options at once" OFF)
-set(DEMO_WORKSPACE "main" CACHE STRING "Active workspace (main, test, etc.)")
+# Configuration Options
+include(cmake/DemoOptions.cmake)
 
-if (DEMO_ALL_OPTIONS)
-    set(DEMO_SIZE_OPT ON)
-    set(DEMO_STRIP_ALL ON)
-    set(DEMO_BUILD_TESTS ON)
-    set(DEMO_BUILD_TOOLS ON)
-    # NOTE: DEMO_FINAL_STRIP is NOT included here (too dangerous for testing)
-endif()
-
-# FINAL_STRIP: Most aggressive stripping (removes ALL error checking)
-# Implies STRIP_ALL (stricter superset)
-if (DEMO_FINAL_STRIP)
-    add_definitions(-DFINAL_STRIP)
-    set(DEMO_STRIP_ALL ON)
-    message(STATUS "FINAL_STRIP enabled - all error checking will be removed")
-endif()
-
-if (DEMO_STRIP_ALL)
-    add_definitions(-DSTRIP_ALL)
-    set(DEMO_SIZE_OPT ON)
-endif()
-
-if (DEMO_STRIP_EXTERNAL_LIBS)
-    add_definitions(-DSTRIP_EXTERNAL_LIBS)
-    # Audio: Use miniaudio null backend
-    add_definitions(-DMA_ENABLE_ONLY_SPECIFIC_BACKENDS -DMA_ENABLE_NULL)
-    message(STATUS "STRIP_EXTERNAL_LIBS enabled - binary will compile but NOT run (size measurement only)")
-endif()
+# Option implications and platform detection
+include(cmake/DemoConfig.cmake)
 
-if (DEMO_ENABLE_COVERAGE AND APPLE)
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} --coverage")
-    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} --coverage")
-    set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} --coverage")
-    # Coverage requires debug info
-    set(CMAKE_BUILD_TYPE Debug)
-endif()
-
-if (DEMO_ENABLE_DEBUG_LOGS)
-    add_definitions(-DDEBUG_LOG_ALL)
-endif()
-
-if (DEMO_HEADLESS)
-    add_definitions(-DDEMO_HEADLESS)
-    add_definitions(-DMA_ENABLE_ONLY_SPECIFIC_BACKENDS -DMA_ENABLE_NULL)
-    message(STATUS "DEMO_HEADLESS enabled - functional stubs (audio works, no GPU)")
-endif()
-
-#-- - Workspace Configuration -- -
+# Workspace selection
 include(cmake/ParseWorkspace.cmake)
 set(WORKSPACE_DIR "${CMAKE_SOURCE_DIR}/workspaces/${DEMO_WORKSPACE}")
 if(NOT EXISTS "${WORKSPACE_DIR}/workspace.cfg")
@@ -72,794 +19,36 @@ endif()
 parse_workspace_config("${WORKSPACE_DIR}")
 message(STATUS "Using workspace: ${DEMO_WORKSPACE}")
 
-#-- - Configuration Summary -- -
-message(STATUS "")
-message(STATUS "Build Configuration:")
-message(STATUS "  DEMO_SIZE_OPT:           ${DEMO_SIZE_OPT}")
-message(STATUS "  DEMO_STRIP_ALL:          ${DEMO_STRIP_ALL}")
-message(STATUS "  DEMO_FINAL_STRIP:        ${DEMO_FINAL_STRIP}")
-message(STATUS "  DEMO_STRIP_EXTERNAL_LIBS: ${DEMO_STRIP_EXTERNAL_LIBS}")
-message(STATUS "  DEMO_BUILD_TESTS:        ${DEMO_BUILD_TESTS}")
-message(STATUS "  DEMO_BUILD_TOOLS:        ${DEMO_BUILD_TOOLS}")
-message(STATUS "  DEMO_ENABLE_COVERAGE:    ${DEMO_ENABLE_COVERAGE}")
-message(STATUS "  DEMO_ENABLE_DEBUG_LOGS:  ${DEMO_ENABLE_DEBUG_LOGS}")
-message(STATUS "  DEMO_HEADLESS:           ${DEMO_HEADLESS}")
-message(STATUS "  DEMO_WORKSPACE:          ${DEMO_WORKSPACE}")
-message(STATUS "")
-
-#-- - Platform Detection and Core Setup -- - 
-if(APPLE)
-    add_definitions(-DGLFW_EXPOSE_NATIVE_COCOA)
-elseif(WIN32)
-    add_definitions(-DGLFW_EXPOSE_NATIVE_WIN32)
-elseif(UNIX)
-    if(DEFINED CMAKE_USE_WAYLAND)
-        add_definitions(-DGLFW_EXPOSE_NATIVE_WAYLAND)
-    else()
-        add_definitions(-DGLFW_EXPOSE_NATIVE_X11)
-    endif()
-endif()
-
-#-- - Dependencies & Includes -- - 
-set(CORE_INCLUDES src third_party)
-
-if (DEMO_CROSS_COMPILE_WIN32)
-    add_definitions(-DDEMO_CROSS_COMPILE_WIN32)
-    set(WINDOWS_DEPS_DIR "${CMAKE_CURRENT_SOURCE_DIR}/third_party/windows")
-    set(WGPU_INCLUDE_DIR "${WINDOWS_DEPS_DIR}/include")
-    set(WGPU_LIBRARY "${WINDOWS_DEPS_DIR}/lib/libwgpu_native.dll.a")
-    set(GLFW3_INCLUDE_DIR "${WINDOWS_DEPS_DIR}/include")
-    set(GLFW3_LIBRARY "${WINDOWS_DEPS_DIR}/lib/libglfw3.a")
-    
-    list(APPEND CORE_INCLUDES ${WGPU_INCLUDE_DIR} ${WGPU_INCLUDE_DIR}/webgpu ${GLFW3_INCLUDE_DIR})
-    set(DEMO_LIBS ${GLFW3_LIBRARY} ${WGPU_LIBRARY} -lgdi32 -lws2_32 -luser32 -lkernel32 -lshell32 -ladvapi32 -ldwmapi)
-    set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static-libgcc -static-libstdc++")
-else()
-    find_library(WGPU_LIBRARY NAMES wgpu_native libwgpu_native REQUIRED)
-    find_path(WGPU_ROOT_INCLUDE_DIR NAMES wgpu.h REQUIRED)
-    list(APPEND CORE_INCLUDES ${WGPU_ROOT_INCLUDE_DIR} ${WGPU_ROOT_INCLUDE_DIR}/webgpu-headers)
-    find_package(glfw3 REQUIRED)
-    set(DEMO_LIBS glfw ${WGPU_LIBRARY})
-endif()
-
-list(APPEND CORE_INCLUDES third_party/glfw3webgpu)
-include_directories(${CORE_INCLUDES})
-
-if (APPLE)
-    set_source_files_properties(src/platform.cc third_party/glfw3webgpu/glfw3webgpu.c PROPERTIES COMPILE_FLAGS "-x objective-c++")
-    list(APPEND DEMO_LIBS "-framework Metal" "-framework Foundation" "-framework Cocoa" "-framework QuartzCore")
-elseif (NOT DEMO_CROSS_COMPILE_WIN32)
-    list(APPEND DEMO_LIBS pthread m dl)
-endif()
-
-#-- - Source Groups -- -
-set(AUDIO_SOURCES src/audio/audio.cc src/audio/ring_buffer.cc src/audio/backend/miniaudio_backend.cc src/audio/backend/wav_dump_backend.cc src/audio/backend/silent_backend.cc src/audio/gen.cc src/audio/fdct.cc src/audio/idct.cc src/audio/fft.cc src/audio/window.cc src/audio/synth.cc src/audio/tracker.cc src/audio/spectrogram_resource_manager.cc src/audio/audio_engine.cc src/audio/spectral_brush.cc)
-set(PROCEDURAL_SOURCES src/procedural/generator.cc)
-if (DEMO_HEADLESS)
-    # Headless mode: Functional stubs (timeline/audio work)
-    # Include all effect classes to satisfy timeline loading
-    set(GPU_SOURCES
-        src/gpu/headless_gpu.cc
-        src/gpu/demo_effects.cc
-        src/gpu/effect.cc
-        src/gpu/effects/heptagon_effect.cc
-        src/gpu/effects/particles_effect.cc
-        src/gpu/effects/passthrough_effect.cc
-        src/gpu/effects/moving_ellipse_effect.cc
-        src/gpu/effects/particle_spray_effect.cc
-        src/gpu/effects/gaussian_blur_effect.cc
-        src/gpu/effects/solarize_effect.cc
-# Disabled: src/gpu/effects/cube_sphere_effect.cc (incomplete conversion)
-        src/gpu/effects/scene1_effect.cc
-        src/gpu/effects/chroma_aberration_effect.cc
-        src/gpu/effects/vignette_effect.cc
-        src/gpu/effects/cnn_effect.cc
-        src/gpu/effects/post_process_helper.cc
-        src/gpu/effects/shaders.cc
-        src/gpu/effects/hybrid_3d_effect.cc
-        src/gpu/effects/flash_cube_effect.cc
-        src/gpu/effects/theme_modulation_effect.cc
-        src/gpu/effects/fade_effect.cc
-        src/gpu/effects/flash_effect.cc
-        src/gpu/effects/shader_composer.cc
-        src/gpu/effects/circle_mask_effect.cc
-        src/gpu/effects/rotating_cube_effect.cc
-        src/gpu/texture_manager.cc
-        src/gpu/texture_readback.cc
-    )
-elseif (DEMO_STRIP_EXTERNAL_LIBS)
-    # Size measurement mode: Minimal GPU stubs only
-    set(GPU_SOURCES src/gpu/stub_gpu.cc)
-else()
-    # Normal mode: Full GPU implementation
-    set(GPU_SOURCES
-        src/gpu/gpu.cc
-        src/gpu/effect.cc
-        src/gpu/effects/heptagon_effect.cc
-        src/gpu/effects/particles_effect.cc
-        src/gpu/effects/passthrough_effect.cc
-        src/gpu/effects/moving_ellipse_effect.cc
-        src/gpu/effects/particle_spray_effect.cc
-        src/gpu/effects/gaussian_blur_effect.cc
-        src/gpu/effects/solarize_effect.cc
-# Disabled: src/gpu/effects/cube_sphere_effect.cc (incomplete conversion)
-        src/gpu/effects/scene1_effect.cc
-        src/gpu/effects/chroma_aberration_effect.cc
-        src/gpu/effects/vignette_effect.cc
-        src/gpu/effects/cnn_effect.cc
-        src/gpu/effects/post_process_helper.cc
-        src/gpu/effects/shaders.cc
-        src/gpu/effects/hybrid_3d_effect.cc
-        src/gpu/effects/flash_cube_effect.cc
-        src/gpu/effects/theme_modulation_effect.cc
-        src/gpu/effects/fade_effect.cc
-        src/gpu/effects/flash_effect.cc
-        src/gpu/effects/shader_composer.cc
-        src/gpu/effects/circle_mask_effect.cc
-        src/gpu/effects/rotating_cube_effect.cc
-        src/gpu/texture_manager.cc
-        src/gpu/texture_readback.cc
-    )
-endif()
-if (DEMO_HEADLESS)
-    # Headless mode: Full 3D (needed for Hybrid3DEffect)
-    set(3D_SOURCES
-        src/3d/renderer.cc
-        src/3d/renderer_draw.cc
-        src/3d/renderer_pipelines.cc
-        src/3d/renderer_resources.cc
-        src/3d/visual_debug.cc
-        src/3d/bvh.cc
-        src/3d/physics.cc
-        src/3d/scene_loader.cc
-    )
-elseif (DEMO_STRIP_EXTERNAL_LIBS)
-    # Size measurement mode: Stub 3D (depends on WebGPU)
-    set(3D_SOURCES src/3d/bvh.cc src/3d/physics.cc src/3d/scene_loader.cc)
-else()
-    # Normal mode: Full 3D implementation
-    set(3D_SOURCES
-        src/3d/renderer.cc
-        src/3d/renderer_draw.cc
-        src/3d/renderer_pipelines.cc
-        src/3d/renderer_resources.cc
-        src/3d/visual_debug.cc
-        src/3d/bvh.cc
-        src/3d/physics.cc
-        src/3d/scene_loader.cc
-    )
-endif()
-if (DEMO_HEADLESS)
-    set(PLATFORM_SOURCES src/platform/headless_platform.cc)
-elseif (DEMO_STRIP_EXTERNAL_LIBS)
-    set(PLATFORM_SOURCES src/platform/stub_platform.cc)
-else()
-    set(PLATFORM_SOURCES src/platform/platform.cc third_party/glfw3webgpu/glfw3webgpu.c)
-endif()
-set(UTIL_SOURCES src/util/asset_manager.cc src/util/file_watcher.cc)
-
-#-- - Subsystem Libraries -- -
-add_library(util STATIC ${UTIL_SOURCES})
-add_dependencies(util generate_demo_assets generate_test_assets)
-add_library(procedural STATIC ${PROCEDURAL_SOURCES})
-add_library(audio STATIC ${AUDIO_SOURCES})
-add_library(3d STATIC ${3D_SOURCES})
-add_library(gpu STATIC ${GPU_SOURCES})
-
-# Libraries must wait for asset generation (they include generated/assets.h)
-add_dependencies(audio generate_demo_assets)
-add_dependencies(3d generate_demo_assets)
-add_dependencies(gpu generate_demo_assets)
-
-target_include_directories(util PUBLIC ${CORE_INCLUDES})
-target_include_directories(procedural PUBLIC ${CORE_INCLUDES})
-target_include_directories(audio PUBLIC ${CORE_INCLUDES})
-target_include_directories(3d PUBLIC ${CORE_INCLUDES})
-target_include_directories(gpu PUBLIC ${CORE_INCLUDES})
-
-# Note: Static libraries do not strictly need to link dependencies, 
-# but if they did, PRIVATE would propagate to the executable.
-# We will link them in the executable to be explicit and avoid order issues.
-
-#-- - Tools Setup -- - 
-if (DEFINED ASSET_PACKER_PATH)
-    set(ASSET_PACKER_CMD ${ASSET_PACKER_PATH})
-    set(ASSET_PACKER_DEPENDS ${ASSET_PACKER_PATH})
-else()
-    add_executable(asset_packer tools/asset_packer.cc)
-    target_link_libraries(asset_packer PRIVATE procedural)
-    target_include_directories(asset_packer PRIVATE third_party)
-    set(ASSET_PACKER_CMD $<TARGET_FILE:asset_packer>)
-    set(ASSET_PACKER_DEPENDS asset_packer)
-endif()
-
-if (DEFINED SEQ_COMPILER_PATH)
-    set(SEQ_COMPILER_CMD ${SEQ_COMPILER_PATH})
-    set(SEQ_COMPILER_DEPENDS ${SEQ_COMPILER_PATH})
-else()
-    add_executable(seq_compiler tools/seq_compiler.cc)
-    set(SEQ_COMPILER_CMD $<TARGET_FILE:seq_compiler>)
-    set(SEQ_COMPILER_DEPENDS seq_compiler)
-endif()
-
-if (DEFINED TRACKER_COMPILER_PATH)
-    set(TRACKER_COMPILER_CMD ${TRACKER_COMPILER_PATH})
-    set(TRACKER_COMPILER_DEPENDS ${TRACKER_COMPILER_PATH})
-else()
-    add_executable(tracker_compiler tools/tracker_compiler.cc)
-    set(TRACKER_COMPILER_CMD $<TARGET_FILE:tracker_compiler>)
-    set(TRACKER_COMPILER_DEPENDS tracker_compiler)
-endif()
-
-# Always build a host-native tracker_compiler for code generation purposes
-add_executable(tracker_compiler_host tools/tracker_compiler.cc)
-set_target_properties(tracker_compiler_host PROPERTIES 
-    RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/tools_host")
-
-# Determine which tracker compiler to use for code generation
-if (DEMO_CROSS_COMPILE_WIN32)
-    set(TRACKER_COMPILER_FINAL_CMD "${CMAKE_SOURCE_DIR}/build_native/tools_host/tracker_compiler_host")
-    set(TRACKER_COMPILER_FINAL_DEPENDS tracker_compiler_host)
-else()
-    set(TRACKER_COMPILER_FINAL_CMD ${TRACKER_COMPILER_CMD})
-    set(TRACKER_COMPILER_FINAL_DEPENDS ${TRACKER_COMPILER_DEPENDS})
-endif()
-
-#-- - Code Generation Helpers -- -
-# Helper to parse demo_assets.txt and extract individual file paths
-function(parse_asset_list INPUT_TXT OUT_FILE_LIST)
-    set(ASSET_FILES "")
-    if(EXISTS ${INPUT_TXT})
-        # Get directory of INPUT_TXT for relative path resolution
-        get_filename_component(INPUT_DIR ${INPUT_TXT} DIRECTORY)
-
-        file(STRINGS ${INPUT_TXT} LINES)
-        foreach(LINE ${LINES})
-            # Skip comments and empty lines
-            string(STRIP "${LINE}" LINE)
-            if(NOT LINE MATCHES "^#" AND NOT LINE STREQUAL "")
-                # Extract filename (third field: ASSET_NAME, COMPRESSION, FILENAME, DESC)
-                string(REGEX REPLACE "^[^,]+,[^,]+,[ ]*([^,]+).*" "\\1" FILENAME "${LINE}")
-                string(STRIP "${FILENAME}" FILENAME)
-
-                # Try workspace-relative path first
-                set(FULL_PATH "${INPUT_DIR}/${FILENAME}")
-                if(NOT EXISTS ${FULL_PATH})
-                    # Fall back to legacy path for compatibility
-                    set(FULL_PATH "${CMAKE_CURRENT_SOURCE_DIR}/assets/final/${FILENAME}")
-                endif()
-
-                if(EXISTS ${FULL_PATH})
-                    list(APPEND ASSET_FILES ${FULL_PATH})
-                endif()
-            endif()
-        endforeach()
-    endif()
-    set(${OUT_FILE_LIST} ${ASSET_FILES} PARENT_SCOPE)
-endfunction()
-
-function(pack_assets NAME INPUT_TXT HEADER_VAR DATA_CC_VAR TARGET_NAME)
-    set(OUT_H ${CMAKE_CURRENT_SOURCE_DIR}/src/generated/${NAME}.h)
-    set(OUT_CC ${CMAKE_CURRENT_SOURCE_DIR}/src/generated/${NAME}_data.cc)
-
-    # Parse asset list to get individual file dependencies
-    parse_asset_list(${INPUT_TXT} ASSET_FILE_DEPS)
-
-    add_custom_command(
-        OUTPUT ${OUT_H} ${OUT_CC}
-        COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_SOURCE_DIR}/src/generated
-        COMMAND ${ASSET_PACKER_CMD} ${INPUT_TXT} ${OUT_H} ${OUT_CC}
-        DEPENDS ${ASSET_PACKER_DEPENDS} ${INPUT_TXT} ${ASSET_FILE_DEPS}
-        COMMENT "Generating assets for ${NAME}..."
-    )
-    set(${HEADER_VAR} ${OUT_H} PARENT_SCOPE)
-    set(${DATA_CC_VAR} ${OUT_CC} PARENT_SCOPE)
-    add_custom_target(${TARGET_NAME} DEPENDS ${OUT_H} ${OUT_CC})
-endfunction()
+# Common macros and utilities
+include(cmake/DemoCommon.cmake)
 
-# A separate function for test assets to avoid polluting the source tree
-function(pack_test_assets NAME INPUT_TXT HEADER_VAR DATA_CC_VAR TARGET_NAME)
-    set(OUT_H ${CMAKE_CURRENT_BINARY_DIR}/src/generated_test/${NAME}.h)
-    set(OUT_CC ${CMAKE_CURRENT_BINARY_DIR}/src/generated_test/${NAME}_data.cc)
+# External dependencies (WGPU, GLFW, platform libs)
+include(cmake/DemoDependencies.cmake)
 
-    # Parse asset list to get individual file dependencies
-    parse_asset_list(${INPUT_TXT} ASSET_FILE_DEPS)
+# Conditional source file lists
+include(cmake/DemoSourceLists.cmake)
 
-    add_custom_command(
-        OUTPUT ${OUT_H} ${OUT_CC}
-        COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_BINARY_DIR}/src/generated_test
-        COMMAND ${ASSET_PACKER_CMD} ${INPUT_TXT} ${OUT_H} ${OUT_CC}
-        DEPENDS ${ASSET_PACKER_DEPENDS} ${INPUT_TXT} ${ASSET_FILE_DEPS}
-        COMMENT "Generating assets for test ${NAME}..."
-    )
-    set(${HEADER_VAR} ${OUT_H} PARENT_SCOPE)
-    set(${DATA_CC_VAR} ${OUT_CC} PARENT_SCOPE)
-    add_custom_target(${TARGET_NAME} DEPENDS ${OUT_H} ${OUT_CC})
-endfunction()
+# Subsystem library targets
+include(cmake/DemoLibraries.cmake)
 
-#-- - Build Macros -- - 
-macro(add_demo_executable NAME)
-    add_executable(${NAME} ${ARGN})
-    # target_link_libraries must be called manually to ensure correct order
-endmacro()
-
-macro(add_demo_test NAME TEST_NAME LABEL)
-    add_executable(${NAME} ${ARGN})
-    add_test(NAME ${TEST_NAME} COMMAND ${NAME})
-    set_tests_properties(${TEST_NAME} PROPERTIES LABELS "${LABEL}")
-endmacro()
-
-#-- - Generation Targets -- -
-# Use workspace-configured paths
-set(DEMO_SEQ_PATH ${WORKSPACE_TIMELINE})
-set(GENERATED_TIMELINE_CC ${CMAKE_CURRENT_SOURCE_DIR}/src/generated/timeline.cc)
-add_custom_command(
-    OUTPUT ${GENERATED_TIMELINE_CC}
-    COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_SOURCE_DIR}/src/generated
-    COMMAND ${SEQ_COMPILER_CMD} ${DEMO_SEQ_PATH} ${GENERATED_TIMELINE_CC}
-    DEPENDS ${SEQ_COMPILER_DEPENDS} ${DEMO_SEQ_PATH}
-            src/gpu/demo_effects.h
-    COMMENT "Compiling demo sequence from workspace ${DEMO_WORKSPACE}..."
-)
-add_custom_target(generate_timeline ALL DEPENDS ${GENERATED_TIMELINE_CC})
-
-set(TRACKER_MUSIC_PATH ${WORKSPACE_MUSIC})
-set(GENERATED_MUSIC_DATA_CC ${CMAKE_CURRENT_SOURCE_DIR}/src/generated/music_data.cc)
-add_custom_command(
-    OUTPUT ${GENERATED_MUSIC_DATA_CC}
-    COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_SOURCE_DIR}/src/generated
-    COMMAND ${TRACKER_COMPILER_FINAL_CMD} ${TRACKER_MUSIC_PATH} ${GENERATED_MUSIC_DATA_CC}
-    DEPENDS ${TRACKER_COMPILER_FINAL_DEPENDS} ${TRACKER_MUSIC_PATH} tracker_compiler_host
-    COMMENT "Compiling tracker music from workspace ${DEMO_WORKSPACE}..."
-)
-add_custom_target(generate_tracker_music ALL DEPENDS ${GENERATED_MUSIC_DATA_CC})
-
-pack_assets(assets ${WORKSPACE_ASSETS} GEN_DEMO_H GEN_DEMO_CC generate_demo_assets)
-pack_test_assets(test_assets ${CMAKE_CURRENT_SOURCE_DIR}/assets/final/test_assets_list.txt GEN_TEST_H GEN_TEST_CC generate_test_assets)
-
-# Mark generated files so CMake always checks if they need rebuilding
-set_source_files_properties(${GEN_DEMO_H} ${GEN_DEMO_CC} PROPERTIES GENERATED TRUE)
-set_source_files_properties(${GEN_TEST_H} ${GEN_TEST_CC} PROPERTIES GENERATED TRUE)
-set_source_files_properties(${GENERATED_TIMELINE_CC} PROPERTIES GENERATED TRUE)
-set_source_files_properties(${GENERATED_MUSIC_DATA_CC} PROPERTIES GENERATED TRUE)
-
-#-- - Main Demo -- -
-if (DEMO_STRIP_EXTERNAL_LIBS)
-    # Size measurement mode: Stub main, no timeline/music
-    add_demo_executable(demo64k src/stub_main.cc ${PLATFORM_SOURCES} ${GEN_DEMO_CC})
-    add_dependencies(demo64k generate_demo_assets)
-else()
-    # Normal mode: Full main with timeline and music
-    add_demo_executable(demo64k src/main.cc ${PLATFORM_SOURCES} ${GEN_DEMO_CC} ${GENERATED_TIMELINE_CC} ${GENERATED_MUSIC_DATA_CC})
-    add_dependencies(demo64k generate_demo_assets generate_timeline generate_tracker_music)
-endif()# Link order: Internal libs first, then external libs (DEMO_LIBS).
-# gpu and 3d depend on WGPU (in DEMO_LIBS).
-if (DEMO_STRIP_EXTERNAL_LIBS)
-    # Size measurement mode: No external libraries (only math/pthread)
-    if (APPLE)
-        target_link_libraries(demo64k PRIVATE 3d gpu audio procedural util)
-    else()
-        target_link_libraries(demo64k PRIVATE -Wl,--start-group 3d gpu audio procedural util -Wl,--end-group pthread m)
-    endif()
-else()
-    # Normal mode: Link external libraries
-    if (APPLE)
-        target_link_libraries(demo64k PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    else()
-        target_link_libraries(demo64k PRIVATE -Wl,--start-group 3d gpu audio procedural util -Wl,--end-group ${DEMO_LIBS})
-    endif()
-endif()
-
-#Size optimizations
-if (DEMO_SIZE_OPT)
-    if (MSVC)
-        target_compile_options(demo64k PRIVATE /Os /GS-)
-        target_link_options(demo64k PRIVATE /OPT:REF /OPT:ICF /INCREMENTAL:NO)
-    elseif (APPLE)
-        target_compile_options(demo64k PRIVATE -Os)
-        target_link_options(demo64k PRIVATE -Wl,-dead_strip)
-    else ()
-        target_compile_options(demo64k PRIVATE -Os -ffunction-sections -fdata-sections)
-        target_link_options(demo64k PRIVATE -Wl,--gc-sections -s)
-    endif()
+# Build tools (conditional: only if needed)
+if(DEMO_BUILD_TOOLS OR DEMO_BUILD_TESTS OR NOT DEMO_STRIP_EXTERNAL_LIBS)
+    include(cmake/DemoTools.cmake)
 endif()
 
-# ==============================================================================
-# Final Build Target (make final)
-# ==============================================================================
-# Convenience target for final production build with all stripping enabled
-# Usage: make final
-# This reconfigures CMake with FINAL_STRIP and rebuilds demo64k
-# Note: Only create this target if we're NOT already in FINAL_STRIP mode
-
-if (NOT DEMO_FINAL_STRIP)
-    add_custom_target(final
-        COMMAND ${CMAKE_COMMAND} -E echo "Building FINAL production binary..."
-        COMMAND ${CMAKE_COMMAND} ${CMAKE_SOURCE_DIR} -DDEMO_FINAL_STRIP=ON -DDEMO_SIZE_OPT=ON
-        COMMAND ${CMAKE_COMMAND} --build ${CMAKE_BINARY_DIR} --target demo64k -j8
-        COMMAND ${CMAKE_COMMAND} -E echo ""
-        COMMAND ${CMAKE_COMMAND} -E echo "Final build complete!"
-        COMMAND ${CMAKE_COMMAND} -E echo "Binary: ${CMAKE_BINARY_DIR}/demo64k"
-        COMMAND ls -lh ${CMAKE_BINARY_DIR}/demo64k
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Building final production binary with FINAL_STRIP"
-    )
-endif()
-
-# ==============================================================================
-# Test Demo (Audio/Visual Sync Tool)
-# ==============================================================================
-
-# Timeline generation
-set(TEST_DEMO_SEQ_PATH ${CMAKE_CURRENT_SOURCE_DIR}/assets/test_demo.seq)
-set(GENERATED_TEST_DEMO_TIMELINE_CC ${CMAKE_CURRENT_SOURCE_DIR}/src/generated/test_demo_timeline.cc)
-add_custom_command(
-    OUTPUT ${GENERATED_TEST_DEMO_TIMELINE_CC}
-    COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_SOURCE_DIR}/src/generated
-    COMMAND ${SEQ_COMPILER_CMD} ${TEST_DEMO_SEQ_PATH} ${GENERATED_TEST_DEMO_TIMELINE_CC}
-    DEPENDS ${SEQ_COMPILER_DEPENDS} ${TEST_DEMO_SEQ_PATH} src/gpu/demo_effects.h
-    COMMENT "Compiling test_demo sequence..."
-)
-add_custom_target(generate_test_demo_timeline ALL DEPENDS ${GENERATED_TEST_DEMO_TIMELINE_CC})
-
-# Music generation
-set(TEST_DEMO_TRACK_PATH ${CMAKE_CURRENT_SOURCE_DIR}/assets/test_demo.track)
-set(GENERATED_TEST_DEMO_MUSIC_CC ${CMAKE_CURRENT_SOURCE_DIR}/src/generated/test_demo_music.cc)
-add_custom_command(
-    OUTPUT ${GENERATED_TEST_DEMO_MUSIC_CC}
-    COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_SOURCE_DIR}/src/generated
-    COMMAND ${TRACKER_COMPILER_FINAL_CMD} ${TEST_DEMO_TRACK_PATH} ${GENERATED_TEST_DEMO_MUSIC_CC}
-    DEPENDS ${TRACKER_COMPILER_FINAL_DEPENDS} ${TEST_DEMO_TRACK_PATH} tracker_compiler_host
-    COMMENT "Compiling test_demo music..."
-)
-add_custom_target(generate_test_demo_music ALL DEPENDS ${GENERATED_TEST_DEMO_MUSIC_CC})
-
-# Mark test_demo generated files as GENERATED
-set_source_files_properties(${GENERATED_TEST_DEMO_TIMELINE_CC} PROPERTIES GENERATED TRUE)
-set_source_files_properties(${GENERATED_TEST_DEMO_MUSIC_CC} PROPERTIES GENERATED TRUE)
-
-# Build executable (uses main demo assets)
-if (NOT DEMO_STRIP_EXTERNAL_LIBS)
-    add_demo_executable(
-        test_demo
-        src/test_demo.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC}
-        ${GENERATED_TEST_DEMO_TIMELINE_CC}
-        ${GENERATED_TEST_DEMO_MUSIC_CC}
-    )
+# Code generation (assets, timeline, music)
+include(cmake/DemoCodegen.cmake)
 
-    add_dependencies(test_demo generate_demo_assets generate_test_demo_timeline generate_test_demo_music)
+# Main executables (demo64k, test_demo)
+include(cmake/DemoExecutables.cmake)
 
-    if (APPLE)
-        target_link_libraries(test_demo PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    else()
-        target_link_libraries(test_demo PRIVATE -Wl,--start-group 3d gpu audio procedural util -Wl,--end-group ${DEMO_LIBS})
-    endif()
-
-    # Size optimizations
-    if (DEMO_SIZE_OPT)
-        if (MSVC)
-            target_compile_options(test_demo PRIVATE /Os /GS-)
-            target_link_options(test_demo PRIVATE /OPT:REF /OPT:ICF /INCREMENTAL:NO)
-        elseif (APPLE)
-            target_compile_options(test_demo PRIVATE -Os)
-            target_link_options(test_demo PRIVATE -Wl,-dead_strip)
-        else ()
-            target_compile_options(test_demo PRIVATE -Os -ffunction-sections -fdata-sections)
-            target_link_options(test_demo PRIVATE -Wl,--gc-sections -s)
-        endif()
-    endif()
-endif()
-
-#-- - Tests -- - 
+# Tests (conditional: only if DEMO_BUILD_TESTS)
 enable_testing()
 if(DEMO_BUILD_TESTS)
-    add_demo_test(test_window HammingWindowTest audio src/tests/audio/test_window.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_window PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_window generate_demo_assets)
-
-    add_demo_test(test_maths MathUtilsTest util src/tests/util/test_maths.cc)
-
-    add_demo_test(test_file_watcher FileWatcherTest util src/tests/util/test_file_watcher.cc)
-    target_link_libraries(test_file_watcher PRIVATE util ${DEMO_LIBS})
-
-    add_demo_test(test_synth SynthEngineTest audio src/tests/audio/test_synth.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_synth PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_synth generate_demo_assets)
-
-    add_demo_test(test_dct DctTest audio src/tests/audio/test_dct.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_dct PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_dct generate_demo_assets)
-
-    add_demo_test(test_fft FftTest audio src/tests/audio/test_fft.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_fft PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_fft generate_demo_assets)
-
-    add_demo_test(test_spectral_brush SpectralBrushTest audio src/tests/audio/test_spectral_brush.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_spectral_brush PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_spectral_brush generate_demo_assets)
-
-    add_demo_test(test_audio_gen AudioGenTest audio src/tests/audio/test_audio_gen.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_audio_gen PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_audio_gen generate_demo_assets)
-
-    add_demo_test(test_audio_backend AudioBackendTest audio src/tests/audio/test_audio_backend.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_audio_backend PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_audio_backend generate_demo_assets)
-
-    add_demo_test(test_silent_backend SilentBackendTest audio src/tests/audio/test_silent_backend.cc ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_silent_backend PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_silent_backend generate_demo_assets generate_tracker_music)
-
-    add_demo_test(test_mock_backend MockAudioBackendTest audio src/tests/audio/test_mock_backend.cc src/audio/backend/mock_audio_backend.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_mock_backend PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_mock_backend generate_demo_assets)
-
-    add_demo_test(test_wav_dump WavDumpBackendTest audio src/tests/audio/test_wav_dump.cc src/audio/backend/wav_dump_backend.cc ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_wav_dump PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_wav_dump generate_demo_assets generate_tracker_music)
-
-    add_demo_test(test_jittered_audio JitteredAudioBackendTest audio src/tests/audio/test_jittered_audio.cc src/audio/backend/jittered_audio_backend.cc ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_jittered_audio PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_jittered_audio generate_demo_assets generate_tracker_music)
-
-    add_demo_test(test_tracker_timing TrackerTimingTest audio src/tests/audio/test_tracker_timing.cc src/audio/backend/mock_audio_backend.cc ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_tracker_timing PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_tracker_timing generate_demo_assets generate_tracker_music)
-
-    add_demo_test(test_variable_tempo VariableTempoTest audio src/tests/audio/test_variable_tempo.cc src/audio/backend/mock_audio_backend.cc ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_variable_tempo PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_variable_tempo generate_demo_assets generate_tracker_music)
-
-    add_demo_test(test_tracker TrackerSystemTest audio src/tests/audio/test_tracker.cc ${GEN_DEMO_CC} ${GENERATED_TEST_DEMO_MUSIC_CC})
-    target_link_libraries(test_tracker PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_tracker generate_demo_assets generate_test_demo_music)
-
-    add_demo_test(test_audio_engine AudioEngineTest audio src/tests/audio/test_audio_engine.cc ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_audio_engine PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_audio_engine generate_demo_assets generate_tracker_music)
-
-    add_demo_test(test_shader_assets ShaderAssetValidation gpu src/tests/gpu/test_shader_assets.cc ${GEN_DEMO_CC})
-    target_link_libraries(test_shader_assets PRIVATE util procedural ${DEMO_LIBS})
-    add_dependencies(test_shader_assets generate_demo_assets)
-
-    add_demo_test(test_shader_compilation ShaderCompilationTest gpu src/tests/gpu/test_shader_compilation.cc ${PLATFORM_SOURCES} ${GEN_DEMO_CC})
-    target_link_libraries(test_shader_compilation PRIVATE gpu util procedural ${DEMO_LIBS})
-    add_dependencies(test_shader_compilation generate_demo_assets)
-
-    add_demo_test(test_noise_functions NoiseFunctionsTest gpu src/tests/gpu/test_noise_functions.cc ${PLATFORM_SOURCES} ${GEN_DEMO_CC})
-    target_link_libraries(test_noise_functions PRIVATE gpu util procedural ${DEMO_LIBS})
-    add_dependencies(test_noise_functions generate_demo_assets)
-
-    add_demo_test(test_uniform_helper UniformHelperTest gpu src/tests/gpu/test_uniform_helper.cc)
-    target_link_libraries(test_uniform_helper PRIVATE gpu util ${DEMO_LIBS})
-
-    add_demo_executable(test_spectool src/tests/gpu/test_spectool.cc ${PLATFORM_SOURCES} ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_compile_definitions(test_spectool PRIVATE DEMO_BUILD_TOOLS)
-    target_link_libraries(test_spectool PRIVATE audio util procedural ${DEMO_LIBS})
-    add_dependencies(test_spectool generate_tracker_music generate_demo_assets)
-
-    add_demo_test(test_assets AssetManagerTest assets src/tests/assets/test_assets.cc ${GEN_TEST_CC})
-    target_include_directories(test_assets PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/src/generated_test)
-    target_compile_definitions(test_assets PRIVATE USE_TEST_ASSETS)
-    target_link_libraries(test_assets PRIVATE util procedural ${DEMO_LIBS})
-    add_dependencies(test_assets generate_test_assets)
-    set_source_files_properties(src/tests/assets/test_assets.cc PROPERTIES COMPILE_DEFINITIONS "USE_TEST_ASSETS")
-
-    add_demo_test(test_sequence SequenceSystemTest assets src/tests/assets/test_sequence.cc ${GEN_DEMO_CC} ${GENERATED_TIMELINE_CC} ${PLATFORM_SOURCES})
-    target_link_libraries(test_sequence PRIVATE 3d gpu util procedural ${DEMO_LIBS})
-    add_dependencies(test_sequence generate_timeline generate_demo_assets)
-
-    add_demo_test(test_procedural ProceduralGenTest util src/tests/util/test_procedural.cc)
-    target_link_libraries(test_procedural PRIVATE procedural ${DEMO_LIBS})
-
-    add_demo_test(test_physics PhysicsTest 3d src/tests/3d/test_physics.cc)
-    target_link_libraries(test_physics PRIVATE 3d util procedural ${DEMO_LIBS})
-
-    add_demo_test(test_3d ThreeDSystemTest 3d src/tests/3d/test_3d.cc)
-
-    add_demo_test(test_shader_composer ShaderComposerTest gpu src/tests/gpu/test_shader_composer.cc ${GEN_TEST_CC})
-    target_compile_definitions(test_shader_composer PRIVATE USE_TEST_ASSETS)
-    target_include_directories(test_shader_composer PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/src/generated_test ${CORE_INCLUDES})
-    target_link_libraries(test_shader_composer PRIVATE gpu util procedural ${DEMO_LIBS})
-    add_dependencies(test_shader_composer generate_test_assets)
-
-
-    add_demo_executable(test_3d_render src/tests/3d/test_3d_render.cc ${PLATFORM_SOURCES} ${GENERATED_TIMELINE_CC} ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_3d_render PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_3d_render generate_timeline generate_demo_assets generate_tracker_music)
-
-    add_demo_executable(test_3d_physics src/tests/3d/test_3d_physics.cc ${PLATFORM_SOURCES} ${GENERATED_TIMELINE_CC} ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_3d_physics PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_3d_physics generate_timeline generate_demo_assets generate_tracker_music)
-
-    add_demo_executable(test_mesh src/tests/3d/test_mesh.cc ${PLATFORM_SOURCES} ${GENERATED_TIMELINE_CC} ${GEN_DEMO_CC} ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_mesh PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_mesh generate_timeline generate_demo_assets generate_tracker_music)
-
-    add_demo_executable(test_platform src/tests/test_platform.cc ${PLATFORM_SOURCES})
-    target_link_libraries(test_platform PRIVATE util ${DEMO_LIBS})
-
-    add_demo_executable(test_scene_loader src/tests/3d/test_scene_loader.cc ${PLATFORM_SOURCES} ${GEN_DEMO_CC})
-    target_link_libraries(test_scene_loader PRIVATE 3d util procedural ${DEMO_LIBS})
-    add_dependencies(test_scene_loader generate_demo_assets)
-    add_test(NAME SceneLoaderTest COMMAND test_scene_loader)
-    set_tests_properties(SceneLoaderTest PROPERTIES LABELS "3d")
-
-    # GPU Effects Test Infrastructure (Phase 1: Foundation)
-    add_demo_test(test_effect_base EffectBaseTest gpu
-        src/tests/gpu/test_effect_base.cc
-        src/tests/common/webgpu_test_fixture.cc
-        src/tests/common/offscreen_render_target.cc
-        src/tests/common/effect_test_helpers.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC}
-        ${GENERATED_TIMELINE_CC}
-        ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_effect_base PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_effect_base generate_timeline generate_demo_assets generate_tracker_music)
-
-    # GPU Effects Test Infrastructure (Phase 2.1: Effect Classes)
-    add_demo_test(test_demo_effects DemoEffectsTest gpu
-        src/tests/gpu/test_demo_effects.cc
-        src/tests/common/webgpu_test_fixture.cc
-        src/tests/common/offscreen_render_target.cc
-        src/tests/common/effect_test_helpers.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC}
-        ${GENERATED_TIMELINE_CC}
-        ${GENERATED_MUSIC_DATA_CC})
-    target_link_libraries(test_demo_effects PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_demo_effects generate_timeline generate_demo_assets generate_tracker_music)
-
-    # GPU Effects Test Infrastructure (Phase 2.2: Post-Process Utilities)
-    add_demo_test(test_post_process_helper PostProcessHelperTest gpu
-        src/tests/gpu/test_post_process_helper.cc
-        src/tests/common/webgpu_test_fixture.cc
-        src/tests/common/offscreen_render_target.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC})
-    target_link_libraries(test_post_process_helper PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_post_process_helper generate_demo_assets)
-
-    # TextureManager tests
-    add_demo_test(test_texture_manager TextureManagerTest gpu
-        src/tests/gpu/test_texture_manager.cc
-        src/tests/common/webgpu_test_fixture.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC})
-    target_link_libraries(test_texture_manager PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_texture_manager generate_demo_assets)
-
-    # GPU Procedural Texture Test
-    add_demo_test(test_gpu_procedural GpuProceduralTest gpu
-        src/tests/gpu/test_gpu_procedural.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC})
-    target_link_libraries(test_gpu_procedural PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_gpu_procedural generate_demo_assets)
-
-    # CNN shader testing tool
-    add_executable(cnn_test
-        tools/cnn_test.cc
-        src/tests/common/webgpu_test_fixture.cc
-        src/tests/common/offscreen_render_target.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC})
-
-    target_include_directories(cnn_test PRIVATE
-        ${CMAKE_CURRENT_SOURCE_DIR}/src
-        ${CMAKE_CURRENT_SOURCE_DIR}/third_party
-        ${CMAKE_CURRENT_BINARY_DIR}/src/generated
-        ${CORE_INCLUDES})
-
-    target_link_libraries(cnn_test PRIVATE
-        gpu util procedural ${DEMO_LIBS})
-
-    add_dependencies(cnn_test generate_demo_assets)
-
-    # Define STB_IMAGE macros
-    target_compile_definitions(cnn_test PRIVATE
-        STB_IMAGE_IMPLEMENTATION
-        STB_IMAGE_WRITE_IMPLEMENTATION)
-
-    # GPU Composite Texture Test (Phase 4)
-    add_demo_test(test_gpu_composite GpuCompositeTest gpu
-        src/tests/gpu/test_gpu_composite.cc
-        ${PLATFORM_SOURCES}
-        ${GEN_DEMO_CC})
-    target_link_libraries(test_gpu_composite PRIVATE 3d gpu audio procedural util ${DEMO_LIBS})
-    add_dependencies(test_gpu_composite generate_demo_assets)
-
-    # Gantt chart output test (bash script)
-    add_test(
-        NAME GanttOutputTest
-        COMMAND ${CMAKE_CURRENT_SOURCE_DIR}/scripts/test_gantt_output.sh
-                $<TARGET_FILE:seq_compiler>
-                ${CMAKE_CURRENT_SOURCE_DIR}/assets/test_gantt.seq
-                ${CMAKE_CURRENT_BINARY_DIR}/test_gantt_output.txt
-    )
-    set_tests_properties(GanttOutputTest PROPERTIES LABELS "scripts")
-
-    # HTML Gantt chart output test
-    add_test(
-        NAME GanttHtmlOutputTest
-        COMMAND ${CMAKE_CURRENT_SOURCE_DIR}/scripts/test_gantt_html.sh
-                $<TARGET_FILE:seq_compiler>
-                ${CMAKE_CURRENT_SOURCE_DIR}/assets/test_gantt.seq
-                ${CMAKE_CURRENT_BINARY_DIR}/test_gantt_output.html
-    )
-    set_tests_properties(GanttHtmlOutputTest PROPERTIES LABELS "scripts")
-
-    # Subsystem test targets
-    add_custom_target(run_audio_tests
-        COMMAND ${CMAKE_CTEST_COMMAND} -L audio --output-on-failure
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Running audio subsystem tests...")
-
-    add_custom_target(run_gpu_tests
-        COMMAND ${CMAKE_CTEST_COMMAND} -L gpu --output-on-failure
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Running GPU subsystem tests...")
-
-    add_custom_target(run_3d_tests
-        COMMAND ${CMAKE_CTEST_COMMAND} -L 3d --output-on-failure
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Running 3D subsystem tests...")
-
-    add_custom_target(run_assets_tests
-        COMMAND ${CMAKE_CTEST_COMMAND} -L assets --output-on-failure
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Running asset system tests...")
-
-    add_custom_target(run_util_tests
-        COMMAND ${CMAKE_CTEST_COMMAND} -L util --output-on-failure
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Running utility tests...")
-
-    add_custom_target(run_all_tests
-        COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-        COMMENT "Running all tests...")
+    include(cmake/DemoTests.cmake)
 endif()
 
-# Sub-task 7: Integrate validation tool into CI/build system
-
-# Ensure the Python validation script is available
-add_custom_target(validate_uniforms_script ALL DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/tools/validate_uniforms.py)
-
-# Find all WGSL files recursively in src/gpu
-file(GLOB WGSL_FILES RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/*.wgsl ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/**/*.wgsl)
-
-# List of C++ files containing uniform struct definitions and shader code
-# Add more C++ files here if new effects with structs are added.
-set(VALIDATION_CPP_FILES
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/heptagon_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/post_process_helper.h
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/fade_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/theme_modulation_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/chroma_aberration_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/vignette_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/gaussian_blur_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/distort_effect.cc
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/demo_effects.h
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/gpu/effects/circle_mask_effect.h
-)
-
-# Add custom command to run the validator
-# It depends on the script itself, WGSL files, and the C++ files being validated.
-# Outputting a flag file to signal completion.
-set(VALIDATION_FLAG ${CMAKE_CURRENT_BINARY_DIR}/uniform_validation_complete.flag)
-add_custom_command(
-    OUTPUT ${VALIDATION_FLAG}
-    COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/tools/validate_uniforms.py ${VALIDATION_FLAG}
-    COMMAND python3 ${CMAKE_CURRENT_SOURCE_DIR}/tools/validate_uniforms.py ${CMAKE_CURRENT_SOURCE_DIR}/assets/final/shaders ${VALIDATION_CPP_FILES}
-    DEPENDS validate_uniforms_script ${WGSL_FILES} ${VALIDATION_CPP_FILES}
-    COMMENT "Validating uniform buffer sizes and alignments..."
-)
-
-# Add custom target that depends on the validation output flag
-add_custom_target(validate_uniforms ALL DEPENDS ${VALIDATION_FLAG})
+# Uniform buffer validation
+include(cmake/Validation.cmake)