macroforge_ts 0.1.80

TypeScript macro expansion engine - write compile-time macros in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

use super::descriptors::DerivedMacroRegistration;
use super::registry::decorator_metadata;
use serde::{Deserialize, Serialize};

#[cfg(feature = "node")]
use napi_derive::napi;

/// Manifest entry describing a single macro.
#[cfg_attr(feature = "node", napi(object))]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct MacroManifestEntry {
    /// The macro name (e.g., "Debug", "Clone").
    pub name: String,
    /// The macro kind (derive, attribute, function).
    pub kind: String,
    /// Human-readable description.
    pub description: String,
    /// The package providing this macro.
    pub package: String,
}

/// Entry for a registered decorator in the manifest.
#[cfg_attr(feature = "node", napi(object))]
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DecoratorManifestEntry {
    /// The module this decorator belongs to (e.g., "serde").
    pub module: String,
    /// The exported name of the decorator (e.g., "skip", "rename").
    pub export: String,
    /// The decorator kind: "class", "property", "method", "accessor", "parameter".
    pub kind: String,
    /// Documentation string for the decorator.
    pub docs: String,
}

/// Complete manifest of all available macros and decorators.
#[cfg_attr(feature = "node", napi(object))]
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
#[serde(rename_all = "camelCase")]
pub struct MacroManifest {
    /// Manifest format version (currently always 1).
    pub version: u32,
    /// All registered macros.
    pub macros: Vec<MacroManifestEntry>,
    /// All registered decorators.
    pub decorators: Vec<DecoratorManifestEntry>,
}

/// Returns the complete manifest of all registered macros and decorators.
pub fn get_manifest() -> MacroManifest {
    let macros: Vec<MacroManifestEntry> = inventory::iter::<DerivedMacroRegistration>
        .into_iter()
        .map(|entry| {
            let name = if entry.descriptor.kind == crate::ts_syn::abi::MacroKind::Call {
                format!("${}", entry.descriptor.name)
            } else {
                entry.descriptor.name.to_string()
            };
            MacroManifestEntry {
                name,
                kind: format!("{:?}", entry.descriptor.kind).to_lowercase(),
                description: entry.descriptor.description.to_string(),
                package: entry.descriptor.package.to_string(),
            }
        })
        .collect();

    let decorators: Vec<DecoratorManifestEntry> = decorator_metadata()
        .into_iter()
        .map(|d| DecoratorManifestEntry {
            module: d.module.to_string(),
            export: d.export.to_string(),
            kind: format!("{:?}", d.kind).to_lowercase(),
            docs: d.docs.to_string(),
        })
        .collect();

    MacroManifest {
        version: 1,
        macros,
        decorators,
    }
}