✨ Improve FoMaC and embedded QDMI integration

[burgholzer]

🤖 AI text below 🤖

Summary

• add exact-byte FoMaC submission and retrieval for binary QDMI programs
• expose the complete standard QDMI program-format enum in Python and enforce text/binary representation contracts
• let embedded consumers independently select the QIR runner and DDSIM QIR support while reusing existing LLVM/MLIR and spdlog targets
• advertise the binary FoMaC API and DDSIM QIR capability through exported target properties
• exercise source-tree embedding, textual QASM, and real QIR bitcode paths

Context

This is an independent prerequisite for the QDMI integration in NVIDIA/cuda-quantum#4882. It does not depend on #1912 and can merge separately. Stable-ID device registration and selective provider composition remain part of #1912.

Validation

• full release build with LLVM/MLIR 22.1.3
• 170/170 native FoMaC tests
• 47/47 DDSIM QDMI device tests
• 7/7 nested CMake consumer tests across source and imported-package dependency modes
• 9/9 focused Python FoMaC tests, including real QIR bitcode execution
• stub generation
• full repository lint

[codecov]

Codecov Report

❌ Patch coverage is 94.73684% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/fomac/FoMaC.cpp	93.5%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!