Skip to main content

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 array;
8mod extern_value;
9mod record;
10mod utils;
11
12#[proc_macro_derive(MiraRecord, attributes(mira))]
13/// Derive a read-only MiraScript record view for a named-field struct.
14///
15/// Fields may use `#[mira(rename = "name")]` or `#[mira(skip)]`. Generic field
16/// types receive the conversion bounds required by the generated implementation.
17pub fn derive_record(input: TokenStream) -> TokenStream {
18    record::expand(syn::parse_macro_input!(input as syn::DeriveInput))
19        .unwrap_or_else(syn::Error::into_compile_error)
20        .into()
21}
22
23#[proc_macro_derive(MiraArray, attributes(mira))]
24/// Derive a read-only MiraScript array view for a tuple struct.
25///
26/// Tuple fields may use `#[mira(skip)]` and retain their relative order.
27pub fn derive_array(input: TokenStream) -> TokenStream {
28    array::expand(syn::parse_macro_input!(input as syn::DeriveInput))
29        .unwrap_or_else(syn::Error::into_compile_error)
30        .into()
31}
32
33#[proc_macro_derive(MiraExtern, attributes(mira))]
34/// Derive a mutable MiraScript extern view for a named-field struct.
35///
36/// Use `#[mira(tag = "Name")]` to override the runtime tag. Fields support
37/// `rename`, `skip`, and `readonly`; fields are writable by default.
38pub fn derive_extern(input: TokenStream) -> TokenStream {
39    extern_value::expand(syn::parse_macro_input!(input as syn::DeriveInput))
40        .unwrap_or_else(syn::Error::into_compile_error)
41        .into()
42}