Phase 5 tranche 2: luminal-vgd-ffi C ABI staticlib

Cargo.toml

@@ -1,6 +1,6 @@
 [workspace]
 resolver = "2"
-members = ["crates/luminal-driver-proto", "crates/luminal-vgd-core", "crates/luminal-vgd-host", "crates/luminal-vgd-driver", "crates/vgd-probe"]
+members = ["crates/luminal-driver-proto", "crates/luminal-vgd-core", "crates/luminal-vgd-host", "crates/luminal-vgd-driver", "crates/vgd-probe", "crates/luminal-vgd-ffi"]
 
 [workspace.package]
 edition = "2021"

crates/luminal-vgd-ffi/Cargo.toml

@@ -0,0 +1,18 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+[package]
+name = "luminal-vgd-ffi"
+version = "0.1.0"
+description = "C ABI over luminal-vgd-host for the LuminalShine (C++) integration: control-device ops and ring consumption. Built as a staticlib for the MSYS2 UCRT64 toolchain (target x86_64-pc-windows-gnullvm)."
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+
+[lib]
+crate-type = ["staticlib", "lib"]
+
+[dependencies]
+luminal-driver-proto = { path = "../luminal-driver-proto" }
+luminal-vgd-host = { path = "../luminal-vgd-host" }
+
+[build-dependencies]
+cbindgen = { version = "0.29", default-features = false }

crates/luminal-vgd-ffi/build.rs

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+//! Generates include/luminal_vgd.h from the FFI surface. The header is
+//! committed (LuminalShine's CMake includes it without running cargo);
+//! this regenerates it on every build so drift is impossible to miss in
+//! review.
+
+fn main() {
+    let crate_dir = std::env::var("CARGO_MANIFEST_DIR").unwrap();
+    let config = cbindgen::Config {
+        language: cbindgen::Language::C,
+        include_guard: Some("LUMINAL_VGD_H".into()),
+        header: Some(
+            "/* SPDX-License-Identifier: AGPL-3.0-only\n * Generated by luminal-vgd-ffi's build.rs (cbindgen) — do not edit.\n *\n * Link (MSYS2 UCRT64):\n *   cargo build -p luminal-vgd-ffi --release --target x86_64-pc-windows-gnullvm\n *   ... -lluminal_vgd_ffi -lcfgmgr32 -lws2_32 -luserenv -lntdll -lbcrypt\n */"
+                .into(),
+        ),
+        cpp_compat: true,
+        ..Default::default()
+    };
+    match cbindgen::Builder::new()
+        .with_crate(&crate_dir)
+        .with_config(config)
+        .generate()
+    {
+        Ok(bindings) => {
+            bindings.write_to_file(format!("{crate_dir}/include/luminal_vgd.h"));
+        }
+        // Never fail the build over header generation (e.g. during a
+        // syntax-error iteration); the committed header stays.
+        Err(e) => println!("cargo:warning=cbindgen skipped: {e}"),
+    }
+    println!("cargo:rerun-if-changed=src/lib.rs");
+}