build: attempt to fix macOS build errors

Signed-off-by: Ronald Caesar <github43132@proton.me>

Author: GloriousTacoo

CMakeLists.txt

@@ -89,6 +89,59 @@ endforeach()
 
 message(STATUS "All submodules verified successfully")
 
+
+if(APPLE AND CMAKE_CXX_COMPILER_ID MATCHES "Clang")
+    # 1. Attempt to detect Homebrew prefix automatically
+    find_program(BREW_PROG brew)
+    if(BREW_PROG)
+        execute_process(
+            COMMAND ${BREW_PROG} --prefix
+            OUTPUT_VARIABLE BREW_PREFIX
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+        )
+    else()
+        # Fallback: Standard Architecture Paths
+        if(CMAKE_HOST_SYSTEM_PROCESSOR STREQUAL "arm64")
+            set(BREW_PREFIX "/opt/homebrew")
+        else()
+            set(BREW_PREFIX "/usr/local")
+        endif()
+    endif()
+
+    # 2. Define LLVM Path
+    set(LLVM_PATH "${BREW_PREFIX}/opt/llvm")
+
+    if(EXISTS "${LLVM_PATH}")
+        message(STATUS "Found Homebrew LLVM: ${LLVM_PATH}")
+        message(STATUS "Patching Linker Flags for libc++ compatibility")
+
+        # 3. Add Library Paths
+        # We use link_directories to ensure these are searched BEFORE system paths
+        link_directories("${LLVM_PATH}/lib")
+
+        # 4. Inject Linker Flags
+        # -L: Force linker to look in Homebrew LLVM lib first
+        # -Wl,-rpath: Bake the path into the binary so it runs without setting DYLD_LIBRARY_PATH
+        # -lunwind: Explicitly link unwinder (often required for C++ exceptions/RTTI in newer LLVM)
+        set(MACOS_LINKER_FLAGS "-L${LLVM_PATH}/lib -Wl,-rpath,${LLVM_PATH}/lib -stdlib=libc++")
+
+        set(CMAKE_EXE_LINKER_FLAGS    "${CMAKE_EXE_LINKER_FLAGS} ${MACOS_LINKER_FLAGS}")
+        set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} ${MACOS_LINKER_FLAGS}")
+        set(CMAKE_MODULE_LINKER_FLAGS "${CMAKE_MODULE_LINKER_FLAGS} ${MACOS_LINKER_FLAGS}")
+
+        # 5. Inject Compiler Flags
+        # Ensure headers match the library
+        include_directories(SYSTEM "${LLVM_PATH}/include")
+        add_compile_options(-stdlib=libc++)
+
+        # [Fix] Suppress C++20 char8_t warning in GTest/System headers if desired
+        add_compile_options(-Wno-character-conversion)
+
+    else()
+        message(WARNING "Homebrew LLVM not found at ${LLVM_PATH}. Build may fail with linker errors.")
+    endif()
+endif()
+
 #-----------------------------
 # ---- Target Definitions ----
 #-----------------------------