Add Windows build support with MSVC/clang-cl and vcpkg

.gitattributes

@@ -0,0 +1,2 @@
+# Normalize all text files to LF in the repo and working copy.
+* text=auto eol=lf

.github/scripts/check_license_headers.py

@@ -16,6 +16,10 @@
 from pathlib import Path
 from typing import List, Optional, Tuple
 
+# Ensure emoji and other Unicode characters can be printed on Windows (cp1252)
+if hasattr(sys.stdout, "reconfigure"):
+    sys.stdout.reconfigure(encoding="utf-8")
+
 # Expected license headers for different file types
 CPP_LICENSE_PATTERNS = [
     # Full MIT license header - standard C-style comment with line breaks

.github/workflows/build-and-test.yaml

@@ -62,29 +62,29 @@ jobs:
       matrix:
         include:
         - os-name: Linux
-          runner: [self-hosted, 1ES.Pool=1es-gh-hb120-pool-wus3, 1ES.ImageOverride=Ubuntu24.04Nightly, 'JobId=qdk_chemistry-linux-py3.10-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}']
-          build-parallel: 120
+          runner: [self-hosted, 1ES.Pool=1es-gh-Dads_v5-pool-wus2, 1ES.ImageOverride=Ubuntu24.04Nightly, 'JobId=qdk_chemistry-linux-py3.10-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}']
+          build-parallel: 32
           uarch: x86-64-v3
           python-version: '3.10'
           cpp-test-threads: 2
           python-test-threads: 2
         - os-name: Linux
-          runner: [self-hosted, 1ES.Pool=1es-gh-hb120-pool-wus3, 1ES.ImageOverride=Ubuntu24.04Nightly, 'JobId=qdk_chemistry-linux-py3.13-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}']
-          build-parallel: 120
+          runner: [self-hosted, 1ES.Pool=1es-gh-Dads_v5-pool-wus2, 1ES.ImageOverride=Ubuntu24.04Nightly, 'JobId=qdk_chemistry-linux-py3.13-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}']
+          build-parallel: 32
           uarch: x86-64-v3
           python-version: '3.13'
           cpp-test-threads: 2
           python-test-threads: 2
         - os-name: Linux
-          runner: [self-hosted, 1ES.Pool=1es-gh-hb120-pool-wus3, 1ES.ImageOverride=Ubuntu24.04Nightly, 'JobId=qdk_chemistry-linux-py3.14-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}']
-          build-parallel: 120
+          runner: [self-hosted, 1ES.Pool=1es-gh-Dads_v5-pool-wus2, 1ES.ImageOverride=Ubuntu24.04Nightly, 'JobId=qdk_chemistry-linux-py3.14-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}']
+          build-parallel: 32
           uarch: x86-64-v3
           python-version: '3.14'
           cpp-test-threads: 2
           python-test-threads: 2
         - os-name: macOS
           runner: macos-26-xlarge
-          build-parallel: 3
+          build-parallel: 5
           uarch: native
           python-version: '3.13'
           cpp-test-threads: 16
@@ -251,13 +251,21 @@ jobs:
 
     - name: Configure C++ RelWithDebInfo/Coverage build
       run: |
+        if [ "${{ matrix.os-name }}" == "macOS" ]; then
+          TOOLCHAIN_FILE="${{ github.workspace }}/.pipelines/toolchains/macos.cmake"
+        else
+          TOOLCHAIN_FILE="${{ github.workspace }}/.pipelines/toolchains/linux.cmake"
+        fi
         cmake -S cpp -B "$BUILD_DIR" \
           -GNinja \
+          -DCMAKE_TOOLCHAIN_FILE="$TOOLCHAIN_FILE" \
           -DCMAKE_BUILD_TYPE=RelWithDebInfo \
           -DCMAKE_INSTALL_PREFIX="$CMAKE_INSTALL_PREFIX" \
           -DQDK_UARCH="$QDK_UARCH" \
+          -DQDK_ENABLE_OPENMP=ON \
           -DQDK_CHEMISTRY_ENABLE_COVERAGE=ON \
-          -DBUILD_TESTING=ON
+          -DBUILD_TESTING=ON \
+          -DMACIS_ENABLE_TESTS=ON
 
     - name: Build C++ RelWithDebInfo/Coverage library
       run: cmake --build "$BUILD_DIR"

.gitignore

@@ -12,16 +12,20 @@ docs/*.txt
 # Distribution / packaging
 .Python
 build/
+build-*/
 develop-eggs/
 dist/
 downloads/
 eggs/
 .eggs/
+install/
+install-*/
 lib/
 lib64/
 parts/
 sdist/
 var/
+vcpkg_installed/
 wheels/
 share/python-wheels/
 *.egg-info/

.pipelines/toolchains/linux.cmake

@@ -0,0 +1,10 @@
+# Example toolchain: GCC/Clang flag setup for QDK/Chemistry on Linux.
+#
+# Usage:
+#   cmake -S cpp -B build -DCMAKE_TOOLCHAIN_FILE=<repo>/.pipelines/toolchains/linux.cmake
+
+foreach(_lang C CXX)
+  set(CMAKE_${_lang}_FLAGS_DEBUG          "-g -O0 -Wall -Wextra" CACHE STRING "" FORCE)
+  set(CMAKE_${_lang}_FLAGS_RELWITHDEBINFO "-g -O3 -DNDEBUG"      CACHE STRING "" FORCE)
+  set(CMAKE_${_lang}_FLAGS_RELEASE        "-O3 -DNDEBUG"         CACHE STRING "" FORCE)
+endforeach()

.pipelines/toolchains/macos.cmake

@@ -0,0 +1,8 @@
+# Example toolchain: AppleClang flag setup for QDK/Chemistry on macOS.
+#
+# Usage:
+#   cmake -S cpp -B build -DCMAKE_TOOLCHAIN_FILE=<repo>/.pipelines/toolchains/macos.cmake
+#
+# AppleClang uses the same GCC/Clang-style flags as the Linux toolchain.
+
+include("${CMAKE_CURRENT_LIST_DIR}/linux.cmake")

.pipelines/toolchains/windows.cmake

@@ -0,0 +1,14 @@
+# Example toolchain: Windows (cl.exe and clang-cl) flag setup for QDK/Chemistry.
+#
+# clang-cl targets the MSVC ABI and accepts MSVC-style flags, so both native
+# cl.exe and clang-cl use the same per-config flag setup.
+#
+# Chainload after the vcpkg toolchain via VCPKG_CHAINLOAD_TOOLCHAIN_FILE:
+#   -DCMAKE_TOOLCHAIN_FILE=<vcpkg>/scripts/buildsystems/vcpkg.cmake
+#   -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE=<repo>/.pipelines/toolchains/windows.cmake
+
+foreach(_lang C CXX)
+  set(CMAKE_${_lang}_FLAGS_DEBUG          "/Zi /Od /RTC1"    CACHE STRING "" FORCE)
+  set(CMAKE_${_lang}_FLAGS_RELWITHDEBINFO "/Zi /O2 /DNDEBUG" CACHE STRING "" FORCE)
+  set(CMAKE_${_lang}_FLAGS_RELEASE        "/O2 /DNDEBUG"     CACHE STRING "" FORCE)
+endforeach()