From 794c932ca93aa23d7ad92b84ec6b6db722903288 Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sat, 1 Aug 2026 22:46:02 +0100
Subject: [PATCH 1/8] Add support for LLVM-based MSVC builds

---
 toolchain/msvc-toolchain.xml | 42 ++++++++++++++++++++++++++++++++----
 1 file changed, 38 insertions(+), 4 deletions(-)

diff --git a/toolchain/msvc-toolchain.xml b/toolchain/msvc-toolchain.xml
index fc2383848..d07e64a32 100644
--- a/toolchain/msvc-toolchain.xml
+++ b/toolchain/msvc-toolchain.xml
@@ -3,7 +3,27 @@
 
 <!-- WINDOWS TOOLS -->
 
+<set name="TOOLS_EXE_SUFFIX" value=".exe" />
 
+<section if="HXCPP_MSVC_LLVM" >
+
+  <set name="CL_EXE" value="clang-cl${TOOLS_EXE_SUFFIX}" />
+  <set name="LINK_EXE" value="lld-link${TOOLS_EXE_SUFFIX}" />
+  <set name="LIB_EXE" value="llvm-lib${TOOLS_EXE_SUFFIX}" />
+  <set name="RC_EXE" value="llvm-rc${TOOLS_EXE_SUFFIX}" />
+  <set name="MT_EXE" value="llvm-mt${TOOLS_EXE_SUFFIX}" />
+
+</section>
+
+<section unless="HXCPP_MSVC_LLVM">
+
+  <set name="CL_EXE" value="cl${TOOLS_EXE_SUFFIX}" />
+  <set name="LINK_EXE" value="link${TOOLS_EXE_SUFFIX}" />
+  <set name="LIB_EXE" value="lib${TOOLS_EXE_SUFFIX}" />
+  <set name="RC_EXE" value="rc${TOOLS_EXE_SUFFIX}" />
+  <set name="MT_EXE" value="mt${TOOLS_EXE_SUFFIX}" />
+
+</section>
 
 <set name="USE_PRECOMPILED_HEADERS" value="msvc" unless="NO_PRECOMPILED_HEADERS" />
 
@@ -52,8 +72,10 @@
 <unset name="HXCPP_FAST_LINK" if="HXCPP_FAST_LINK" unless="MSVC19"/>
 
 <compiler id="MSVC" exe="cl.exe" if="windows">
+  <exe name="${CL_EXE}" />
   <flag value="-nologo"/>
 
+  <pchflag value="/TP" />
 
   <!-- Newer options -->
   <!-- <flag value = "/analyze-" if="MSVC17+" /> -->
@@ -107,18 +129,26 @@
   <flag value="-wd4996"/>
   <outflag value="-Fo"/>
   <ext value=".obj"/>
-  <asmExe value="ml64.exe" if="HXCPP_M64" />
-  <asmExe value="ml.exe" unless="HXCPP_M64" />
+
+  <section if="HXCPP_MSVC_LLVM">
+    <asmExe value="llvm-ml${TOOLS_EXE_SUFFIX}" />
+  </section>
+  <section unless="HXCPP_MSVC_LLVM">
+    <asmExe value="ml64.exe" if="HXCPP_M64" />
+    <asmExe value="ml.exe" unless="HXCPP_M64" />
+  </section>
+
   <objdir value="${MSVC_OBJ_DIR}" />
 
-  <rcexe name="rc.exe" />
+  <rcexe name="${RC_EXE}" />
   <rcext value=".res" />
   <rcflag value="-nologo" />
 
-  <getversion value="cl.exe"/>
+  <getversion value="${CL_EXE}" unless="HXCPP_MSVC_LLVM"/>
 </compiler>
 
 <linker id="dll" exe="link.exe" if="windows">
+  <exe name="${LINK_EXE}" />
   <flag value="-nologo"/>
   <flag value="-machine:${MACHINE}"/>
   <flag value="-dll"/>
@@ -142,6 +172,7 @@
 </linker>
 
 <linker id="exe" exe="link.exe" unless="winrt">
+  <exe name="${LINK_EXE}" />
   <fromfile value="@"/>
   <flag value="-nologo"/>
   <flag value="-machine:${MACHINE}"/>
@@ -166,6 +197,7 @@
 
 
 <manifest exe="mt.exe" >
+  <exe name="${MT_EXE}" />
   <flag value="-nologo"/>
   <flag value="-manifest"/>
   <outPre value="-outputresource:" />
@@ -175,6 +207,7 @@
 
 
 <linker id="exe" exe="link.exe" if="winrt">
+  <exe name="${LINK_EXE}" />
   <fromfile value="@"/>
   <flag value="-nologo"/>
   <flag value="-machine:${MACHINE}"/>
@@ -197,6 +230,7 @@
 </linker>
 
 <linker id="static_link" exe="lib.exe" if="windows">
+  <exe name="${LIB_EXE}" />
   <flag value="-LTCG" if="HXCPP_OPTIMIZE_LINK" unless="debug || HXCPP_LTCG_INCREMENTAL"/>
   <flag value="-LTCG:INCREMENTAL" if="HXCPP_LTCG_INCREMENTAL" unless="debug"/>
   <fromfile value="@"/>

From 32848deeaa251503d3e30d267d688a058093840d Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sat, 1 Aug 2026 22:46:43 +0100
Subject: [PATCH 2/8] Fix msvc builds without MSVC_VER set

For the clang-based MSVC toolchain, MSVC_VER doesn't get set, only
isMsvc.
---
 project/thirdparty/mbedtls-files.xml | 2 +-
 src/hx/libs/regexp/pcre2_sources.xml | 4 ++--
 toolchain/finish-setup.xml           | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/project/thirdparty/mbedtls-files.xml b/project/thirdparty/mbedtls-files.xml
index 92dc763c7..2534f9185 100644
--- a/project/thirdparty/mbedtls-files.xml
+++ b/project/thirdparty/mbedtls-files.xml
@@ -8,7 +8,7 @@
 
 	<include name="${this_dir}/mbedtls-flags.xml" />
 
-	<compilerflag value="-std=c99" unless="MSVC_VER" />
+	<compilerflag value="-std=c99" unless="isMsvc" />
 
 	<file name="${MBEDTLS_DIR}/library/aes.c" />
 	<file name="${MBEDTLS_DIR}/library/aesni.c" />
diff --git a/src/hx/libs/regexp/pcre2_sources.xml b/src/hx/libs/regexp/pcre2_sources.xml
index a70d8fa0e..e91bb83c8 100644
--- a/src/hx/libs/regexp/pcre2_sources.xml
+++ b/src/hx/libs/regexp/pcre2_sources.xml
@@ -3,7 +3,7 @@
   <compilerflag value="-DPCRE2_STATIC" />
   <compilerflag value="-DSUPPORT_UNICODE" />
   <compilerflag value="-I${PCRE_DIR}" />
-  <compilerflag value="-std=c99" unless="MSVC_VER" />
+  <compilerflag value="-std=c99" unless="isMsvc" />
 
   <file name="${PCRE_DIR}/pcre2_auto_possess.c" />
   <file name="${PCRE_DIR}/pcre2_chartables.c" />
@@ -32,4 +32,4 @@
   <file name="${PCRE_DIR}/pcre2_ucd.c" />
   <file name="${PCRE_DIR}/pcre2_valid_utf.c" />
   <file name="${PCRE_DIR}/pcre2_xclass.c" />
-</xml>
\ No newline at end of file
+</xml>
diff --git a/toolchain/finish-setup.xml b/toolchain/finish-setup.xml
index 1e814ade3..468f2ed1c 100644
--- a/toolchain/finish-setup.xml
+++ b/toolchain/finish-setup.xml
@@ -95,7 +95,7 @@
    <setup name="msvc"/>
 
    <section if="static_link" >
-      <set name="MSVC_LIB_VERSION" value="-${MSVC_VER}" />
+      <set name="MSVC_LIB_VERSION" value="-${MSVC_VER}" if="MSVC_VER" />
    </section>
 
    <set name="LIBEXTRA" value="-19" if="MSVC19" />

From cdf953622881f72d7b9b5f8d395daf77c9a8c8e8 Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sat, 1 Aug 2026 22:48:08 +0100
Subject: [PATCH 3/8] Keep msvc style pch for msvc llvm

---
 tools/hxcpp/Compiler.hx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/hxcpp/Compiler.hx b/tools/hxcpp/Compiler.hx
index 8afdc4bbe..8b05c3d13 100644
--- a/tools/hxcpp/Compiler.hx
+++ b/tools/hxcpp/Compiler.hx
@@ -694,7 +694,7 @@ class Compiler
    {
       mPCH = inPCH;
       createCompilerVersion();
-		if (inPCH != null && ~/clang/i.match(mCompilerVersionString)) {
+      if (inPCH != null && ~/clang/i.match(mCompilerVersionString) && !BuildTool.isMsvcLlvm()) {
          mPCH = "clang";
       }
       switch (mPCH) {

From 3e29ab6a3daac2dca02afec1212429c286aeeb6c Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sun, 2 Aug 2026 01:01:29 +0100
Subject: [PATCH 4/8] Avoid -Yl use for msvc llvm pch

clang-cl does not handle pchs in the same way, and it gives a warning
when this flag is included.
---
 tools/hxcpp/BuildTool.hx | 5 +++++
 tools/hxcpp/Compiler.hx  | 6 ++++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/tools/hxcpp/BuildTool.hx b/tools/hxcpp/BuildTool.hx
index cd5a48f5b..a73f60cda 100644
--- a/tools/hxcpp/BuildTool.hx
+++ b/tools/hxcpp/BuildTool.hx
@@ -1535,6 +1535,11 @@ class BuildTool
       return instance.mDefines.get("toolchain")=="msvc";
    }
 
+   public static function isMsvcLlvm()
+   {
+		return isMsvc() && instance.mDefines.exists("HXCPP_MSVC_LLVM");
+   }
+
    public static function isMingw()
    {
       return instance.mDefines.get("toolchain")=="mingw";
diff --git a/tools/hxcpp/Compiler.hx b/tools/hxcpp/Compiler.hx
index 8b05c3d13..4700c6ca5 100644
--- a/tools/hxcpp/Compiler.hx
+++ b/tools/hxcpp/Compiler.hx
@@ -640,8 +640,10 @@ class Compiler
       if (mPCH == "msvc")
       {
          args.push( mPCHCreate + header + ".h" );
-         var symbol = "link" + Md5.encode( PathManager.combine(dir, file + mExt) );
-         args.push( "-Yl" + symbol  );
+         if (!BuildTool.isMsvcLlvm()) {
+            var symbol = "link" + Md5.encode( PathManager.combine(dir, file + mExt) );
+            args.push( "-Yl" + symbol  );
+         }
 
          // Create a temp file for including ...
          var tmp_cpp = dir + "/" + file + ".cpp";

From cb39e74543bfdde3a3efac70804fc7345ff47a97 Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sat, 1 Aug 2026 23:45:41 +0100
Subject: [PATCH 5/8] Skip cl version check for msvc llvm

---
 tools/hxcpp/Setup.hx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tools/hxcpp/Setup.hx b/tools/hxcpp/Setup.hx
index 9b16ff801..49f576afe 100644
--- a/tools/hxcpp/Setup.hx
+++ b/tools/hxcpp/Setup.hx
@@ -901,6 +901,8 @@ class Setup
          }
       }
 
+      if (ioDefines.exists("HXCPP_MSVC_LLVM")) return;
+
       try
       {
          var proc = new Process("cl.exe",[]);

From 62da55930478aeae099d1f5577458d42e1e71243 Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sat, 1 Aug 2026 22:48:40 +0100
Subject: [PATCH 6/8] Support llvm msvc build from linux host

---
 toolchain/msvc-toolchain.xml | 12 +++++++++++-
 tools/hxcpp/BuildTool.hx     | 11 ++++++++---
 tools/hxcpp/Setup.hx         |  3 ++-
 3 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/toolchain/msvc-toolchain.xml b/toolchain/msvc-toolchain.xml
index d07e64a32..efc8ca49e 100644
--- a/toolchain/msvc-toolchain.xml
+++ b/toolchain/msvc-toolchain.xml
@@ -3,7 +3,7 @@
 
 <!-- WINDOWS TOOLS -->
 
-<set name="TOOLS_EXE_SUFFIX" value=".exe" />
+<set name="TOOLS_EXE_SUFFIX" value=".exe" unless="linux_host" />
 
 <section if="HXCPP_MSVC_LLVM" >
 
@@ -75,6 +75,11 @@
   <exe name="${CL_EXE}" />
   <flag value="-nologo"/>
 
+  <section if="HXCPP_MSVC_LLVM HXCPP_MSVC_ROOT">
+    <flag value="-winsysroot" />
+    <flag value="${HXCPP_MSVC_ROOT}" />
+  </section>
+
   <pchflag value="/TP" />
 
   <!-- Newer options -->
@@ -150,6 +155,7 @@
 <linker id="dll" exe="link.exe" if="windows">
   <exe name="${LINK_EXE}" />
   <flag value="-nologo"/>
+  <flag value="-winsysroot:${HXCPP_MSVC_ROOT}" if="HXCPP_MSVC_LLVM HXCPP_MSVC_ROOT" />
   <flag value="-machine:${MACHINE}"/>
   <flag value="-dll"/>
   <flag value="-debug:full" if="HXCPP_DEBUG_LINK" unless="HXCPP_FAST_LINK"/>
@@ -175,6 +181,7 @@
   <exe name="${LINK_EXE}" />
   <fromfile value="@"/>
   <flag value="-nologo"/>
+  <flag value="-winsysroot:${HXCPP_MSVC_ROOT}" if="HXCPP_MSVC_LLVM HXCPP_MSVC_ROOT" />
   <flag value="-machine:${MACHINE}"/>
   <flag value="-debug" if="HXCPP_DEBUG_LINK||HXCPP_PDB_FILE" unless="HXCPP_FAST_LINK"/>
   <flag value="-debug:fastlink" if="HXCPP_FAST_LINK HXCPP_DEBUG_LINK"/>
@@ -199,6 +206,7 @@
 <manifest exe="mt.exe" >
   <exe name="${MT_EXE}" />
   <flag value="-nologo"/>
+  <flag value="-winsysroot:${HXCPP_MSVC_ROOT}" if="HXCPP_MSVC_LLVM HXCPP_MSVC_ROOT" />
   <flag value="-manifest"/>
   <outPre value="-outputresource:" />
   <outPost value=";1" />
@@ -210,6 +218,7 @@
   <exe name="${LINK_EXE}" />
   <fromfile value="@"/>
   <flag value="-nologo"/>
+  <flag value="-winsysroot:${HXCPP_MSVC_ROOT}" if="HXCPP_MSVC_LLVM HXCPP_MSVC_ROOT" />
   <flag value="-machine:${MACHINE}"/>
   <flag value="-debug" if="HXCPP_DEBUG_LINK" unless="HXCPP_FAST_LINK"/>
   <flag value="-debug:fastlink" if="HXCPP_FAST_LINK HXCPP_DEBUG_LINK"/>
@@ -235,6 +244,7 @@
   <flag value="-LTCG:INCREMENTAL" if="HXCPP_LTCG_INCREMENTAL" unless="debug"/>
   <fromfile value="@"/>
   <flag value="-nologo"/>
+  <flag value="-winsysroot:${HXCPP_MSVC_ROOT}" if="HXCPP_MSVC_LLVM HXCPP_MSVC_ROOT" />
   <flag value="-IGNORE:4264" if="winrt" />
   <ext value="${LIBEXT}"/>
   <outflag value="-out:"/>
diff --git a/tools/hxcpp/BuildTool.hx b/tools/hxcpp/BuildTool.hx
index a73f60cda..80132cf6e 100644
--- a/tools/hxcpp/BuildTool.hx
+++ b/tools/hxcpp/BuildTool.hx
@@ -2144,9 +2144,14 @@ class BuildTool
          // Cross-compile?
          if(defines.exists("windows"))
          {
-            defines.set("toolchain","mingw");
-            defines.set("mingw", "mingw");
-            defines.set("xcompile","1");
+            if (defines.exists("HXCPP_MSVC_LLVM"))
+               defines.set("toolchain", "msvc");
+            else
+            {
+               defines.set("toolchain","mingw");
+               defines.set("mingw", "mingw");
+            }
+            defines.set("xcompile", "1");
             defines.set("BINDIR", arm64 ? "WindowsArm64" : m64 ? "Windows64":"Windows");
          }
          else
diff --git a/tools/hxcpp/Setup.hx b/tools/hxcpp/Setup.hx
index 49f576afe..ed68ae456 100644
--- a/tools/hxcpp/Setup.hx
+++ b/tools/hxcpp/Setup.hx
@@ -781,7 +781,8 @@ class Setup
    public static function setupMSVC(ioDefines:Hash<String>, in64:Bool, inArm64, isWinRT:Bool)
    {
       var detectMsvc = !ioDefines.exists("NO_AUTO_MSVC") &&
-                       !ioDefines.exists("HXCPP_MSVC_CUSTOM");
+                       !ioDefines.exists("HXCPP_MSVC_CUSTOM") &&
+                       !ioDefines.exists("HXCPP_MSVC_ROOT");
 
       if (ioDefines.exists("HXCPP_MSVC_VER"))
       {

From 5cf8a2926992108f8bd876e0b0933cd184b0dbc5 Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Sun, 2 Aug 2026 00:15:23 +0100
Subject: [PATCH 7/8] docs: Add HXCPP_MSVC_LLVM and HXCPP_MSVC_ROOT

---
 docs/build_xml/Defines.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/build_xml/Defines.md b/docs/build_xml/Defines.md
index 319c47cca..6d89b214a 100755
--- a/docs/build_xml/Defines.md
+++ b/docs/build_xml/Defines.md
@@ -91,3 +91,5 @@ Defines affecting target architecture.
 | *HXCPP_MINGW*           | Compile for windows using mingw |
 | *NO_AUTO_MSVC*          | Do not detect msvc location, use the one already in the executable path |
 | *HXCPP_WINXP_COMPAT*    | Remain compatible with Windows XP. Disables condition variables. No effect on ARM. |
+| *HXCPP_MSVC_LLVM*       | Compile for windows using the LLVM-based MSVC toolchain |
+| *HXCPP_MSVC_ROOT*       | Set the root for MSVC libraries and headers |

From f7826e27964fbd12d5ea579db584377f5ea7ab55 Mon Sep 17 00:00:00 2001
From: Tobiasz Laskowski <tobil4sk@outlook.com>
Date: Fri, 21 Aug 2026 21:44:04 +0100
Subject: [PATCH 8/8] Support arm64 build with MSVC LLVM

---
 toolchain/msvc-toolchain.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/toolchain/msvc-toolchain.xml b/toolchain/msvc-toolchain.xml
index efc8ca49e..0040296ab 100644
--- a/toolchain/msvc-toolchain.xml
+++ b/toolchain/msvc-toolchain.xml
@@ -80,6 +80,11 @@
     <flag value="${HXCPP_MSVC_ROOT}" />
   </section>
 
+  <section if="HXCPP_MSVC_LLVM HXCPP_ARM64">
+    <flag value="-target" />
+    <flag value="aarch64-pc-windows-msvc" />
+  </section>
+
   <pchflag value="/TP" />
 
   <!-- Newer options -->