@macroforge/mcp-server 0.1.42 → 0.1.49

package/docs/custom-macros/ts-macro-derive/deriveinput-structure.md

@@ -1,61 +1,63 @@
 ## DeriveInput Structure
 
-```rust
-struct DeriveInput {
-    pub ident: Ident,           // The type name
-    pub span: SpanIR,           // Span of the type definition
-    pub attrs: Vec<Attribute>,  // Decorators (excluding @derive)
-    pub data: Data,             // The parsed type data
-    pub context: MacroContextIR, // Macro context with spans
-
-    // Helper methods
-    fn name(&self) -> &str;              // Get the type name
-    fn decorator_span(&self) -> SpanIR;  // Span of @derive decorator
-    fn as_class(&self) -> Option<&DataClass>;
-    fn as_interface(&self) -> Option<&DataInterface>;
-    fn as_enum(&self) -> Option<&DataEnum>;
+Rust
+
+```
+struct DeriveInput {
+    pub ident: Ident,           // The type name
+    pub span: SpanIR,           // Span of the type definition
+    pub attrs: Vec<Attribute>,  // Decorators (excluding @derive)
+    pub data: Data,             // The parsed type data
+    pub context: MacroContextIR, // Macro context with spans
+
+    // Helper methods
+    fn name(&self) -> &str;              // Get the type name
+    fn decorator_span(&self) -> SpanIR;  // Span of @derive decorator
+    fn as_class(&self) -> Option<&DataClass>;
+    fn as_interface(&self) -> Option<&DataInterface>;
+    fn as_enum(&self) -> Option<&DataEnum>;
 }
 
-enum Data {
-    Class(DataClass),
-    Interface(DataInterface),
-    Enum(DataEnum),
-    TypeAlias(DataTypeAlias),
+enum Data {
+    Class(DataClass),
+    Interface(DataInterface),
+    Enum(DataEnum),
+    TypeAlias(DataTypeAlias),
 }
 
-impl DataClass {
-    fn fields(&self) -> &[FieldIR];
-    fn methods(&self) -> &[MethodSigIR];
-    fn field_names(&self) -> impl Iterator<Item = &str>;
-    fn field(&self, name: &str) -> Option<&FieldIR>;
-    fn body_span(&self) -> SpanIR;      // For inserting code into class body
-    fn type_params(&self) -> &[String]; // Generic type parameters
-    fn heritage(&self) -> &[String];    // extends/implements clauses
-    fn is_abstract(&self) -> bool;
+impl DataClass {
+    fn fields(&self) -> &[FieldIR];
+    fn methods(&self) -> &[MethodSigIR];
+    fn field_names(&self) -> impl Iterator<Item = &str>;
+    fn field(&self, name: &str) -> Option<&FieldIR>;
+    fn body_span(&self) -> SpanIR;      // For inserting code into class body
+    fn type_params(&self) -> &[String]; // Generic type parameters
+    fn heritage(&self) -> &[String];    // extends/implements clauses
+    fn is_abstract(&self) -> bool;
 }
 
-impl DataInterface {
-    fn fields(&self) -> &[InterfaceFieldIR];
-    fn methods(&self) -> &[InterfaceMethodIR];
-    fn field_names(&self) -> impl Iterator<Item = &str>;
-    fn field(&self, name: &str) -> Option<&InterfaceFieldIR>;
-    fn body_span(&self) -> SpanIR;
-    fn type_params(&self) -> &[String];
-    fn heritage(&self) -> &[String];    // extends clauses
+impl DataInterface {
+    fn fields(&self) -> &[InterfaceFieldIR];
+    fn methods(&self) -> &[InterfaceMethodIR];
+    fn field_names(&self) -> impl Iterator<Item = &str>;
+    fn field(&self, name: &str) -> Option<&InterfaceFieldIR>;
+    fn body_span(&self) -> SpanIR;
+    fn type_params(&self) -> &[String];
+    fn heritage(&self) -> &[String];    // extends clauses
 }
 
-impl DataEnum {
-    fn variants(&self) -> &[EnumVariantIR];
-    fn variant_names(&self) -> impl Iterator<Item = &str>;
-    fn variant(&self, name: &str) -> Option<&EnumVariantIR>;
+impl DataEnum {
+    fn variants(&self) -> &[EnumVariantIR];
+    fn variant_names(&self) -> impl Iterator<Item = &str>;
+    fn variant(&self, name: &str) -> Option<&EnumVariantIR>;
 }
 
-impl DataTypeAlias {
-    fn body(&self) -> &TypeBody;
-    fn type_params(&self) -> &[String];
-    fn is_union(&self) -> bool;
-    fn is_object(&self) -> bool;
-    fn as_union(&self) -> Option<&[TypeMember]>;
-    fn as_object(&self) -> Option<&[InterfaceFieldIR]>;
+impl DataTypeAlias {
+    fn body(&self) -> &TypeBody;
+    fn type_params(&self) -> &[String];
+    fn is_union(&self) -> bool;
+    fn is_object(&self) -> bool;
+    fn as_union(&self) -> Option<&[TypeMember]>;
+    fn as_object(&self) -> Option<&[InterfaceFieldIR]>;
 }
 ```

package/docs/custom-macros/ts-macro-derive/function-signature.md

@@ -0,0 +1,12 @@
+## Function Signature
+
+Rust
+
+```
+pub fn my_macro(mut input: TsStream) -> Result<TsStream, MacroforgeError>
+```
+
+| Parameter                           | Description                                             |
+| ----------------------------------- | ------------------------------------------------------- |
+| `input: TsStream`                   | Token stream containing the class/interface AST         |
+| `Result<TsStream, MacroforgeError>` | Returns generated code or an error with source location |

package/docs/custom-macros/ts-macro-derive/overview.md

@@ -1,15 +1,17 @@
-# ts_macro_derive
+# ts\_macro\_derive
 
-*The `#[ts_macro_derive]` attribute is a Rust procedural macro that registers your function as a Macroforge derive macro.*
+The `#[ts_macro_derive]` attribute is a Rust procedural macro that registers your function as a Macroforge derive macro.
 
 ## Basic Syntax
 
-```rust
-use macroforge_ts::macros::ts_macro_derive;
-use macroforge_ts::ts_syn::{TsStream, MacroforgeError};
+Rust
+
+```
+use macroforge_ts::macros::ts_macro_derive;
+use macroforge_ts::ts_syn::{TsStream, MacroforgeError};
 
 #[ts_macro_derive(MacroName)]
-pub fn my_macro(mut input: TsStream) -> Result<TsStream, MacroforgeError> {
-    // Macro implementation
+pub fn my_macro(mut input: TsStream) -> Result<TsStream, MacroforgeError> {
+    // Macro implementation
 }
 ```

package/docs/custom-macros/ts-macro-derive/parsing-input.md

@@ -2,26 +2,28 @@
 
 Use `parse_ts_macro_input!` to convert the token stream:
 
-```rust
-use macroforge_ts::ts_syn::{Data, DeriveInput, parse_ts_macro_input};
+Rust
+
+```
+use macroforge_ts::ts_syn::{Data, DeriveInput, parse_ts_macro_input};
 
 #[ts_macro_derive(MyMacro)]
-pub fn my_macro(mut input: TsStream) -> Result<TsStream, MacroforgeError> {
-    let input = parse_ts_macro_input!(input as DeriveInput);
+pub fn my_macro(mut input: TsStream) -> Result<TsStream, MacroforgeError> {
+    let input = parse_ts_macro_input!(input as DeriveInput);
 
-    // Access class data
-    match &input.data {
-        Data::Class(class) => {
-            let class_name = input.name();
-            let fields = class.fields();
-            // ...
-        }
-        Data::Interface(interface) => {
-            // Handle interfaces
-        }
-        Data::Enum(_) => {
-            // Handle enums (if supported)
-        }
-    }
+    // Access class data
+    match &input.data {
+        Data::Class(class) => {
+            let class_name = input.name();
+            let fields = class.fields();
+            // ...
+        }
+        Data::Interface(interface) => {
+            // Handle interfaces
+        }
+        Data::Enum(_) => {
+            // Handle enums (if supported)
+        }
+    }
 }
 ```

package/docs/custom-macros/ts-macro-derive/returning-errors.md

@@ -2,20 +2,22 @@
 
 Use `MacroforgeError` to report errors with source locations:
 
-```rust
+Rust
+
+```
 #[ts_macro_derive(ClassOnly)]
-pub fn class_only(mut input: TsStream) -> Result<TsStream, MacroforgeError> {
-    let input = parse_ts_macro_input!(input as DeriveInput);
+pub fn class_only(mut input: TsStream) -> Result<TsStream, MacroforgeError> {
+    let input = parse_ts_macro_input!(input as DeriveInput);
 
-    match &input.data {
-        Data::Class(_) => {
-            // Generate code...
-            Ok(body! { /* ... */ })
-        }
-        _ => Err(MacroforgeError::new(
-            input.decorator_span(),
-            "@derive(ClassOnly) can only be used on classes",
-        )),
-    }
+    match &input.data {
+        Data::Class(_) => {
+            // Generate code...
+            Ok(body! { /* ... */ })
+        }
+        _ => Err(MacroforgeError::new(
+            input.decorator_span(),
+            "@derive(ClassOnly) can only be used on classes",
+        )),
+    }
 }
 ```