build.rs api rework

Author: milyin

prebindgen-ext/src/core/inline_fn.rs

@@ -1,33 +1,16 @@
 //! Core: language-agnostic primitives for the Registry-based pipeline.
 //!
-//! Pipeline shape:
-//!   1. [`registry::Registry::from_source`] — scan a `prebindgen::Source`
-//!      into a flat type table.
-//!   2. [`resolve::resolve`] — fixed-point loop driving the configured
-//!      [`prebindgen_ext::PrebindgenExt`] across all rank phases and both
-//!      directions.
-//!   3. [`write::write_rust`] — emit the resolved bindings file.
-//!   4. (Destination-language Kotlin emission lives in `crate::kotlin`.)
-//!
-//! `inline_fn`, `name_mangler`, `type_binding`, `type_registry` are kept
-//! transitionally; they're only referenced by the unmigrated
-//! [`crate::kotlin::KotlinInterfaceGenerator`] which still consumes the
-//! old `TypeRegistry` shape. They will be removed once that generator
-//! lands on the new `Registry`.
+//! Public entry point: [`registry::Registry::from_source`] scans a
+//! `prebindgen::Source` into a flat type table; [`registry::Registry::write_rust`]
+//! resolves every required type using the configured
+//! [`prebindgen_ext::PrebindgenExt`] and emits the bindings file. Kotlin
+//! emission for the JNI back-end lives in `crate::jni::JniExt::write_kotlin`.
 
-pub mod inline_fn;
-pub mod name_mangler;
 pub mod niches;
 pub mod prebindgen_ext;
 pub mod registry;
-pub mod resolve;
-pub mod type_binding;
-pub mod type_registry;
-pub mod write;
+pub(crate) mod resolve;
+pub(crate) mod write;
 
 pub use niches::{NicheSlot, Niches};
-
-pub use type_registry::{
-    input_option, input_result, nullable_to_option, option_to_nullable, option_wire_type,
-    output_option, output_result, primitive_builtins, result_wire_type, TypeRegistry,
-};
+pub use registry::Registry;

prebindgen-ext/src/core/mod.rs

@@ -202,6 +202,36 @@ impl fmt::Display for ScanError {
 
 impl std::error::Error for ScanError {}
 
+/// Combined error surfaced by [`Registry::write_rust`].
+#[derive(Debug)]
+pub enum WriteRustError {
+    Resolve(crate::core::resolve::ResolveError),
+    Write(crate::core::write::WriteError),
+}
+
+impl fmt::Display for WriteRustError {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        match self {
+            WriteRustError::Resolve(e) => write!(f, "{}", e),
+            WriteRustError::Write(e) => write!(f, "{}", e),
+        }
+    }
+}
+
+impl std::error::Error for WriteRustError {}
+
+impl From<crate::core::resolve::ResolveError> for WriteRustError {
+    fn from(e: crate::core::resolve::ResolveError) -> Self {
+        WriteRustError::Resolve(e)
+    }
+}
+
+impl From<crate::core::write::WriteError> for WriteRustError {
+    fn from(e: crate::core::write::WriteError) -> Self {
+        WriteRustError::Write(e)
+    }
+}
+
 impl Registry {
     /// Construct a `Registry` by scanning a `prebindgen::Source`.
     pub fn from_source(source: &Source) -> Result<Self, ScanError> {
@@ -467,6 +497,19 @@ impl Registry {
         }
         self.type_locations.entry(key).or_insert_with(|| loc.clone());
     }
+
+    /// One-shot: resolve every required type using `ext`, then write the
+    /// generated Rust bindings file. The single public entry point for
+    /// language-specific binding generation — language-agnostic because
+    /// `ext` is any [`crate::core::prebindgen_ext::PrebindgenExt`] impl.
+    pub fn write_rust<E: crate::core::prebindgen_ext::PrebindgenExt>(
+        &mut self,
+        ext: &E,
+        out_path: impl AsRef<std::path::Path>,
+    ) -> Result<std::path::PathBuf, WriteRustError> {
+        crate::core::resolve::resolve(self, ext)?;
+        Ok(crate::core::write::write_rust(self, ext, out_path)?)
+    }
 }
 
 // ──────────────────────────────────────────────────────────────────────