Add DSMIL toolchain preset and document wrappers

Author: Your Name

dsmil/CMakeLists.txt

@@ -32,3 +32,8 @@ install(
   PROGRAMS ${DSMIL_WRAPPER_OUTPUTS}
   DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+install(
+  FILES cmake/dsmil-toolchain.cmake
+  DESTINATION ${CMAKE_INSTALL_DATADIR}/dsmil
+)

dsmil/README.md

@@ -126,6 +126,22 @@ ninja -C build
 ninja -C build install
 ```
 
+### Using DSMIL wrappers and toolchain
+
+- Wrappers: `dsmil-clang`, `dsmil-clang++`, and `dsmil-opt` are installed alongside the toolchain. They automatically load the DSMIL pass plugin, add DSMIL headers, and link the DSMIL runtime (`libdsmilrt.a`).
+- Toolchain file: A CMake preset is installed at `/usr/local/share/dsmil/dsmil-toolchain.cmake` (or `${CMAKE_INSTALL_PREFIX}/share/dsmil/` if you used a custom prefix). Use it so CMake picks up DSMIL by default:
+
+```bash
+cmake -G Ninja -S <src> -B <build> \
+  -DCMAKE_TOOLCHAIN_FILE=/usr/local/share/dsmil/dsmil-toolchain.cmake
+```
+
+Set a custom prefix if you installed elsewhere:
+
+```bash
+cmake ... -DDSMIL_PREFIX=/opt/dsllvm ...
+```
+
 ### Using DSLLVM
 
 ```bash

dsmil/cmake/dsmil-toolchain.cmake

@@ -0,0 +1,30 @@
+# DSMIL toolchain preset for consumers of an installed DSLLVM.
+#
+# Usage:
+#   cmake -G Ninja -S <src> -B <build> \
+#     -DCMAKE_TOOLCHAIN_FILE=/usr/local/share/dsmil/dsmil-toolchain.cmake
+#
+# Customize the install prefix if DSLLVM was installed somewhere else:
+#   cmake ... -DDSMIL_PREFIX=/opt/dsllvm ...
+
+set(DSMIL_PREFIX "/usr/local" CACHE PATH "Install prefix of DSLLVM/DSMIL toolchain")
+
+set(_DSMIL_BIN "${DSMIL_PREFIX}/bin")
+set(_DSMIL_LIB "${DSMIL_PREFIX}/lib")
+set(_DSMIL_INC "${DSMIL_PREFIX}/include/dsmil")
+
+set(CMAKE_C_COMPILER "${_DSMIL_BIN}/dsmil-clang" CACHE FILEPATH "DSMIL C compiler" FORCE)
+set(CMAKE_CXX_COMPILER "${_DSMIL_BIN}/dsmil-clang++" CACHE FILEPATH "DSMIL C++ compiler" FORCE)
+
+set(CMAKE_PREFIX_PATH "${DSMIL_PREFIX}" CACHE PATH "Search prefix for DSMIL libraries" FORCE)
+
+# Ensure CMake can find the runtime and plugin from the install.
+set(CMAKE_LIBRARY_PATH "${_DSMIL_LIB}" CACHE PATH "DSMIL library path" FORCE)
+set(CMAKE_INCLUDE_PATH "${_DSMIL_INC}" CACHE PATH "DSMIL include path" FORCE)
+
+if(NOT EXISTS "${CMAKE_C_COMPILER}")
+  message(FATAL_ERROR "dsmil-clang not found at ${CMAKE_C_COMPILER}. Set DSMIL_PREFIX to your install.")
+endif()
+if(NOT EXISTS "${CMAKE_CXX_COMPILER}")
+  message(FATAL_ERROR "dsmil-clang++ not found at ${CMAKE_CXX_COMPILER}. Set DSMIL_PREFIX to your install.")
+endif()