mirascript_vm_derive/lib.rs
1//! Derive macros for exposing live Rust values to `mirascript-vm`.
2
3#![warn(missing_docs)]
4
5use proc_macro::TokenStream;
6
7mod derive;
8mod mira;
9mod utils;
10
11#[proc_macro_attribute]
12/// Expose a Rust function or inline module as a MiraScript value.
13///
14/// The generated companion constant defaults to the upper-case Rust item name.
15/// Use `const = NAME` to override the Rust constant, `rename = "mira.name"`
16/// to override the diagnostic name, and `use = "export"` to override a direct
17/// parent module's export key.
18pub fn mira(attr: TokenStream, input: TokenStream) -> TokenStream {
19 mira::expand(attr.into(), input.into())
20 .unwrap_or_else(syn::Error::into_compile_error)
21 .into()
22}
23
24#[proc_macro_derive(MiraRecord, attributes(mira))]
25/// Derive a read-only MiraScript record view for a named-field struct.
26///
27/// Fields may use `#[mira(rename = "name")]` or `#[mira(skip)]`. Generic field
28/// types receive the conversion bounds required by the generated implementation.
29pub fn derive_record(input: TokenStream) -> TokenStream {
30 derive::record::expand(syn::parse_macro_input!(input as syn::DeriveInput))
31 .unwrap_or_else(syn::Error::into_compile_error)
32 .into()
33}
34
35#[proc_macro_derive(MiraArray, attributes(mira))]
36/// Derive a read-only MiraScript array view for a tuple struct.
37///
38/// Tuple fields may use `#[mira(skip)]` and retain their relative order.
39pub fn derive_array(input: TokenStream) -> TokenStream {
40 derive::array::expand(syn::parse_macro_input!(input as syn::DeriveInput))
41 .unwrap_or_else(syn::Error::into_compile_error)
42 .into()
43}