//! Caller-supplied native function specifications.

//!

//! The compiler accepts a list of [`HostFnSpec`] entries (rpc/cli/tui all

//! provide their own) and treats them as first-class native callables: the

//! corresponding wasm imports get registered when CompileContext is built in

//! eval mode, and the native dispatcher emits a `(call $idx)` whenever a

//! nomiscript form references the spec's `nomi_name`. The matching host-side

//! linker registration is the consumer's responsibility — see

//! `rpc::natives::link` for the rpc layer's mirror.

use crate::ast::WasmType;

/// Description of a single host fn the caller wants nomiscript code to be

/// able to invoke.

///

/// `result: Option<WasmType>` is the single source of truth for the wasm

/// import signature. The compiler reads it via

/// `CompileContext::host_import_return_type` and declares the import

/// using the abstract heap type (`(ref null struct)` / `(ref null array)`)

/// that matches wasmtime's `Rooted<StructRef>` / `Rooted<ArrayRef>`

/// `WasmTy::valtype()`; a `ref.cast` after every call recovers the

/// concrete type. No per-shape flags, no synthesized guest-side wrap

/// helpers — host returns the GC ref directly.

#[derive(Debug, Clone)]

pub struct HostFnSpec {

    /// Symbol the lisp source uses, e.g. `rpc-protocol-version`. Stored

    /// uppercase to match the reader's symbol-normalisation behaviour.

    pub nomi_name: String,

    /// Wasm import module — typically `"nomi"` for the rpc-eval channel.

    pub import_module: String,

    /// Wasm import function name — typically the snake_case rpc fn name.

    pub import_name: String,

    /// Parameter wasm types (in declaration order).

    pub params: Vec<WasmType>,

    /// Return type, `None` for `() -> ()` host fns.

    pub result: Option<WasmType>,

}

impl HostFnSpec {

    #[must_use]

    #[must_use]

    #[must_use]

}

#[cfg(test)]

mod tests {

    use super::*;

    #[test]

    #[test]

}