@macroforge/mcp-server 0.1.65 → 0.1.72

package/docs/BOOK.md

@@ -1,21 +1,24 @@
 # Macroforge Documentation
 
-*TypeScript Macros - Rust-Powered Code Generation*
+_TypeScript Macros - Rust-Powered Code Generation_
 
 ---
 
 ## Table of Contents
 
 ### Getting Started
+
 - [Installation](#installation)
 - [First Macro](#first-macro)
 
 ### Core Concepts
+
 - [How Macros Work](#how-macros-work)
 - [The Derive System](#the-derive-system)
 - [Architecture](#architecture)
 
 ### Built-in Macros
+
 - [Overview](#overview)
 - [Debug](#debug)
 - [Clone](#clone)
@@ -28,12 +31,14 @@
 - [Deserialize](#deserialize)
 
 ### Custom Macros
+
 - [Overview](#overview)
 - [Rust Setup](#rust-setup)
 - [ts_macro_derive](#ts-macro-derive)
 - [Template Syntax](#template-syntax)
 
 ### Integration
+
 - [Overview](#overview)
 - [CLI](#cli)
 - [TypeScript Plugin](#typescript-plugin)
@@ -41,11 +46,13 @@
 - [Configuration](#configuration)
 
 ### Language Servers
+
 - [Overview](#overview)
 - [Svelte](#svelte)
 - [Zed Extensions](#zed-extensions)
 
 ### API Reference
+
 - [Overview](#overview)
 - [expandSync()](#expandsync)
 - [transformSync()](#transformsync)
@@ -56,110 +63,78 @@
 
 # Getting Started
 
-
 ---
 
-
 ---
 
 # Core Concepts
 
-
 ---
 
-
 ---
 
-
 ---
 
 # Built-in Macros
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
 # Custom Macros
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
 # Integration
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
 # Language Servers
 
-
 ---
 
-
 ---
 
-
 ---
 
 # API Reference
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---
 
-
 ---

package/docs/api/api-overview.md

@@ -66,7 +66,7 @@ if (result.diagnostics.length > 0) {
 
 ## Detailed Reference
 
-*   [`expandSync()`](../docs/api/expand-sync) - Full options and return types
-*   [`transformSync()`](../docs/api/transform-sync) - Transform with source maps
-*   [`NativePlugin`](../docs/api/native-plugin) - Caching for language servers
-*   [`PositionMapper`](../docs/api/position-mapper) - Position mapping utilities
+- [`expandSync()`](../docs/api/expand-sync) - Full options and return types
+- [`transformSync()`](../docs/api/transform-sync) - Transform with source maps
+- [`NativePlugin`](../docs/api/native-plugin) - Caching for language servers
+- [`PositionMapper`](../docs/api/position-mapper) - Position mapping utilities

package/docs/api/expand-sync.md

@@ -2,7 +2,8 @@
 
 macroforge v0.1.48
 
-Synchronously expands macros in TypeScript code. This is the standalone macro expansion function that doesn't use caching. For cached expansion, use \[\`NativePlugin::process\_file\`\] instead.
+Synchronously expands macros in TypeScript code. This is the standalone macro expansion function
+that doesn't use caching. For cached expansion, use \[\`NativePlugin::process\_file\`\] instead.
 
 ## Signature
 
@@ -124,4 +125,4 @@ for (const diag of result.diagnostics) {
     console.error(`Error at ${diag.span.start}: ${diag.message}`);
   }
 }
-```
+```

package/docs/api/native-plugin.md

@@ -2,7 +2,9 @@
 
 macroforge v0.1.48
 
-The main plugin class for macro expansion with caching support. \`NativePlugin\` is designed to be instantiated once and reused across multiple file processing operations. It maintains a cache of expansion results keyed by filepath and version, enabling efficient incremental processing.
+The main plugin class for macro expansion with caching support. \`NativePlugin\` is designed to be
+instantiated once and reused across multiple file processing operations. It maintains a cache of
+expansion results keyed by filepath and version, enabling efficient incremental processing.
 
 ## Constructor
 
@@ -121,4 +123,5 @@ class MacroforgeLanguageService {
 
 ## Thread Safety
 
-The `NativePlugin` class is thread-safe and can be used from multiple async contexts. Each file is processed in an isolated thread with its own stack space.
+The `NativePlugin` class is thread-safe and can be used from multiple async contexts. Each file is
+processed in an isolated thread with its own stack space.

package/docs/api/position-mapper.md

@@ -2,7 +2,10 @@
 
 macroforge v0.1.48
 
-Bidirectional position mapper for translating between original and expanded source positions. This mapper enables IDE features like error reporting, go-to-definition, and hover to work correctly with macro-expanded code by translating positions between the original source (what the user wrote) and the expanded source (what the compiler sees).
+Bidirectional position mapper for translating between original and expanded source positions. This
+mapper enables IDE features like error reporting, go-to-definition, and hover to work correctly with
+macro-expanded code by translating positions between the original source (what the user wrote) and
+the expanded source (what the compiler sees).
 
 ## Getting a Mapper
 
@@ -140,6 +143,6 @@ function mapError(filepath: string, expandedPos: number, message: string) {
 
 Position mapping uses binary search with O(log n) complexity:
 
-*   Fast lookups even for large files
-*   Minimal memory overhead
-*   Thread-safe access
+- Fast lookups even for large files
+- Minimal memory overhead
+- Thread-safe access

package/docs/api/transform-sync.md

@@ -2,7 +2,9 @@
 
 macroforge v0.1.48
 
-Synchronously transforms TypeScript code through the macro expansion system. This is similar to \[\`expand\_sync\`\] but returns a \[\`TransformResult\`\] which includes source map information (when available).
+Synchronously transforms TypeScript code through the macro expansion system. This is similar to
+\[\`expand\_sync\`\] but returns a \[\`TransformResult\`\] which includes source map information
+(when available).
 
 ## Signature
 
@@ -85,8 +87,8 @@ if (result.metadata) {
 
 Use `transformSync` when:
 
-*   Building custom integrations
-*   You need raw output without diagnostics
-*   You're implementing a build tool plugin
+- Building custom integrations
+- You need raw output without diagnostics
+- You're implementing a build tool plugin
 
-Use `expandSync` for most other use cases, as it provides better error handling.
+Use `expandSync` for most other use cases, as it provides better error handling.

package/docs/builtin-macros/deserialize/all-options.md

@@ -2,32 +2,18 @@
 
 ### Container Options (on class/interface)
 
-| `rename_all` 
-| `string` 
-| Apply naming convention to all fields 
+| `rename_all` | `string` | Apply naming convention to all fields
 
-| `deny_unknown_fields` 
-| `boolean` 
-| Throw error if JSON has unknown keys
+| `deny_unknown_fields` | `boolean` | Throw error if JSON has unknown keys
 
 ### Field Options (on properties)
 
-| `rename` 
-| `string` 
-| Use a different JSON key 
+| `rename` | `string` | Use a different JSON key
 
-| `skip` 
-| `boolean` 
-| Exclude from serialization and deserialization 
+| `skip` | `boolean` | Exclude from serialization and deserialization
 
-| `skip_deserializing` 
-| `boolean` 
-| Exclude from deserialization only 
+| `skip_deserializing` | `boolean` | Exclude from deserialization only
 
-| `default` 
-| `boolean | string` 
-| Use TypeScript default or custom expression if missing 
+| `default` | `boolean | string` | Use TypeScript default or custom expression if missing
 
-| `flatten` 
-| `boolean` 
-| Merge nested object fields from parent
+| `flatten` | `boolean` | Merge nested object fields from parent

package/docs/builtin-macros/deserialize/combining-with-serialize.md

@@ -2,18 +2,20 @@
 
 Use both Serialize and Deserialize for complete JSON round-trip support:
 
-<InteractiveMacro code={`/** @derive(Serialize, Deserialize) */
+<InteractiveMacro
+code={`/** @derive(Serialize, Deserialize) */
 /** @serde({ rename_all: "camelCase" }) */
 class UserProfile {
   user_name: string;
   created_at: Date;
   is_active: boolean;
-}`} />
+}`}
+/>
 
 ```typescript
 // Create and serialize
 const profile = new UserProfile();
-profile.user_name = "Alice";
+profile.user_name = 'Alice';
 profile.created_at = new Date();
 profile.is_active = true;
 
@@ -22,6 +24,6 @@ const json = JSON.stringify(profile);
 
 // Deserialize back
 const restored = UserProfile.fromJSON(JSON.parse(json));
-console.log(restored.user_name);              // "Alice"
+console.log(restored.user_name); // "Alice"
 console.log(restored.created_at instanceof Date); // true
-```
+```

package/docs/builtin-macros/deserialize/enum-support.md

@@ -1,24 +1,26 @@
 ## Enum Support
 
-Deserialize also works with enums. The `fromJSON` function validates that the input matches one of the enum values:
+Deserialize also works with enums. The `fromJSON` function validates that the input matches one of
+the enum values:
 
 <MacroExample before={data.examples.enum.before} after={data.examples.enum.after} />
 
 ```typescript
-const status = Status.fromJSON("active");
+const status = Status.fromJSON('active');
 console.log(status); // Status.Active
 
 // Invalid values throw an error
 try {
-  Status.fromJSON("invalid");
+    Status.fromJSON('invalid');
 } catch (e) {
-  console.log(e.message); // "Invalid Status value: invalid"
+    console.log(e.message); // "Invalid Status value: invalid"
 }
 ```
 
 Works with numeric enums too:
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
+<InteractiveMacro
+code={`/** @derive(Deserialize) */
 enum Priority {
   Low = 1,
   Medium = 2,
@@ -28,4 +30,4 @@ enum Priority {
 ```typescript
 const priority = Priority.fromJSON(3);
 console.log(priority); // Priority.High
-```
+```

package/docs/builtin-macros/deserialize/error-handling.md

@@ -2,7 +2,8 @@
 
 Handle deserialization errors gracefully:
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
+<InteractiveMacro
+code={`/** @derive(Deserialize) */
 class User {
   name: string;
   email: string;
@@ -10,15 +11,15 @@ class User {
 
 ```typescript
 function parseUser(json: unknown): User | null {
-  try {
-    return User.fromJSON(json);
-  } catch (error) {
-    console.error("Failed to parse user:", error.message);
-    return null;
-  }
+    try {
+        return User.fromJSON(json);
+    } catch (error) {
+        console.error('Failed to parse user:', error.message);
+        return null;
+    }
 }
 
-const user = parseUser({ name: "Alice" });
+const user = parseUser({ name: 'Alice' });
 // Logs: Failed to parse user: User.fromJSON: missing required field "email"
 // Returns: null
-```
+```

package/docs/builtin-macros/deserialize/interface-support.md

@@ -1,18 +1,23 @@
 ## Interface Support
 
-Deserialize also works with interfaces. For interfaces, a namespace is generated with `is` (type guard) and `fromJSON` functions:
+Deserialize also works with interfaces. For interfaces, a namespace is generated with `is` (type
+guard) and `fromJSON` functions:
 
 <MacroExample before={data.examples.interface.before} after={data.examples.interface.after} />
 
 ```typescript
-const json = { status: 200, message: "OK", timestamp: "2024-01-15T10:30:00.000Z" };
+const json = {
+    status: 200,
+    message: 'OK',
+    timestamp: '2024-01-15T10:30:00.000Z'
+};
 
 // Type guard
 if (ApiResponse.is(json)) {
-  console.log(json.status); // TypeScript knows this is ApiResponse
+    console.log(json.status); // TypeScript knows this is ApiResponse
 }
 
 // Deserialize with validation
 const response = ApiResponse.fromJSON(json);
 console.log(response.timestamp instanceof Date); // true
-```
+```

package/docs/builtin-macros/deserialize/runtime-validation.md

@@ -2,7 +2,8 @@
 
 Deserialize validates the input data and throws descriptive errors:
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
+<InteractiveMacro
+code={`/** @derive(Deserialize) */
 class User {
   name: string;
   email: string;
@@ -10,11 +11,11 @@ class User {
 
 ```typescript
 // Missing required field
-User.fromJSON({ name: "Alice" });
+User.fromJSON({ name: 'Alice' });
 // Error: User.fromJSON: missing required field "email"
 
 // Wrong type
-User.fromJSON("not an object");
+User.fromJSON('not an object');
 // Error: User.fromJSON: expected an object, got string
 
 // Array instead of object
@@ -26,26 +27,14 @@ User.fromJSON([1, 2, 3]);
 
 Deserialize automatically converts JSON types to their TypeScript equivalents:
 
-| string/number/boolean 
-| `string`/`number`/`boolean` 
-| Direct assignment 
+| string/number/boolean | `string`/`number`/`boolean` | Direct assignment
 
-| ISO string 
-| `Date` 
-| `new Date(string)` 
+| ISO string | `Date` | `new Date(string)`
 
-| array 
-| `T[]` 
-| Maps items with auto-detection 
+| array | `T[]` | Maps items with auto-detection
 
-| object 
-| `Map<K, V>` 
-| `new Map(Object.entries())` 
+| object | `Map<K, V>` | `new Map(Object.entries())`
 
-| array 
-| `Set<T>` 
-| `new Set(array)` 
+| array | `Set<T>` | `new Set(array)`
 
-| object 
-| Nested class 
-| Calls `fromJSON()` if available
+| object | Nested class | Calls `fromJSON()` if available

package/docs/builtin-macros/deserialize/serde-options.md

@@ -7,8 +7,8 @@ Use the `@serde` decorator to customize deserialization:
 <MacroExample before={data.examples.rename.before} after={data.examples.rename.after} />
 
 ```typescript
-const user = User.fromJSON({ user_id: "123", full_name: "Alice" });
-console.log(user.id);   // "123"
+const user = User.fromJSON({ user_id: '123', full_name: 'Alice' });
+console.log(user.id); // "123"
 console.log(user.name); // "Alice"
 ```
 
@@ -17,24 +17,18 @@ console.log(user.name); // "Alice"
 <MacroExample before={data.examples.default.before} after={data.examples.default.after} />
 
 ```typescript
-const config = Config.fromJSON({ host: "localhost" });
-console.log(config.port);  // "3000"
+const config = Config.fromJSON({ host: 'localhost' });
+console.log(config.port); // "3000"
 console.log(config.debug); // false
 ```
 
 ### Skipping Fields
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
-class User {
-  name: string;
-  email: string;
+<InteractiveMacro code={`/** @derive(Deserialize) */ class User { name: string; email: string;
 
-  /** @serde({ skip: true }) */
-  cachedData: unknown;
+/** @serde({ skip: true }) */ cachedData: unknown;
 
-  /** @serde({ skip_deserializing: true }) */
-  computedField: string;
-}`} />
+/** @serde({ skip_deserializing: true }) */ computedField: string; }`} />
 
 <Alert type="tip" title="skip vs skip_deserializing">
 Use `skip: true` to exclude from both serialization and deserialization.
@@ -43,41 +37,35 @@ Use `skip_deserializing: true` to only skip during deserialization.
 
 ### Deny Unknown Fields
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
+<InteractiveMacro
+code={`/** @derive(Deserialize) */
 /** @serde({ deny_unknown_fields: true }) */
 class StrictUser {
   name: string;
   email: string;
-}`} />
+}`}
+/>
 
 ```typescript
 // This will throw an error
-StrictUser.fromJSON({ name: "Alice", email: "a@b.com", extra: "field" });
+StrictUser.fromJSON({ name: 'Alice', email: 'a@b.com', extra: 'field' });
 // Error: StrictUser.fromJSON: unknown field "extra"
 ```
 
 ### Flatten Nested Objects
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
-class Address {
-  city: string;
-  zip: string;
-}
+<InteractiveMacro code={`/** @derive(Deserialize) */ class Address { city: string; zip: string; }
 
-/** @derive(Deserialize) */
-class User {
-  name: string;
+/** @derive(Deserialize) */ class User { name: string;
 
-  /** @serde({ flatten: true }) */
-  address: Address;
-}`} />
+/** @serde({ flatten: true }) */ address: Address; }`} />
 
 ```typescript
 // Flat JSON structure
 const user = User.fromJSON({
-  name: "Alice",
-  city: "NYC",
-  zip: "10001"
+    name: 'Alice',
+    city: 'NYC',
+    zip: '10001'
 });
 console.log(user.address.city); // "NYC"
-```
+```

package/docs/builtin-macros/deserialize/type-alias-support.md

@@ -6,9 +6,9 @@ Deserialize works with type aliases. For object types, validation and type conve
 
 ```typescript
 const json = {
-  id: "123",
-  name: "Alice",
-  createdAt: "2024-01-15T00:00:00.000Z"
+    id: '123',
+    name: 'Alice',
+    createdAt: '2024-01-15T00:00:00.000Z'
 };
 
 const profile = UserProfile.fromJSON(json);
@@ -17,10 +17,11 @@ console.log(profile.createdAt instanceof Date); // true
 
 For union types, basic validation is applied:
 
-<InteractiveMacro code={`/** @derive(Deserialize) */
+<InteractiveMacro
+code={`/** @derive(Deserialize) */
 type ApiStatus = "loading" | "success" | "error";`} />
 
 ```typescript
-const status = ApiStatus.fromJSON("success");
+const status = ApiStatus.fromJSON('success');
 console.log(status); // "success"
-```
+```

package/docs/builtin-macros/macros-overview/detailed-documentation.md

@@ -2,12 +2,12 @@
 
 Each macro has its own options and behaviors:
 
-*   [**Debug**](../docs/builtin-macros/debug) - Customizable field renaming and skipping
-*   [**Clone**](../docs/builtin-macros/clone) - Deep copying for all field types
-*   [**Default**](../docs/builtin-macros/default) - Default value generation with field attributes
-*   [**Hash**](../docs/builtin-macros/hash) - Hash code generation for use in maps and sets
-*   [**PartialEq**](../docs/builtin-macros/partial-eq) - Value-based equality comparison
-*   [**Ord**](../docs/builtin-macros/ord) - Total ordering for sorting
-*   [**PartialOrd**](../docs/builtin-macros/partial-ord) - Partial ordering comparison
-*   [**Serialize**](../docs/builtin-macros/serialize) - JSON serialization with serde-style options
-*   [**Deserialize**](../docs/builtin-macros/deserialize) - JSON deserialization with validation
+- [**Debug**](../docs/builtin-macros/debug) - Customizable field renaming and skipping
+- [**Clone**](../docs/builtin-macros/clone) - Deep copying for all field types
+- [**Default**](../docs/builtin-macros/default) - Default value generation with field attributes
+- [**Hash**](../docs/builtin-macros/hash) - Hash code generation for use in maps and sets
+- [**PartialEq**](../docs/builtin-macros/partial-eq) - Value-based equality comparison
+- [**Ord**](../docs/builtin-macros/ord) - Total ordering for sorting
+- [**PartialOrd**](../docs/builtin-macros/partial-ord) - Partial ordering comparison
+- [**Serialize**](../docs/builtin-macros/serialize) - JSON serialization with serde-style options
+- [**Deserialize**](../docs/builtin-macros/deserialize) - JSON deserialization with validation

package/docs/builtin-macros/macros-overview/enum-support.md

@@ -1,6 +1,7 @@
 ## Enum Support
 
-All built-in macros work with enums. For enums, methods are generated as functions in a namespace with the same name:
+All built-in macros work with enums. For enums, methods are generated as functions in a namespace
+with the same name:
 
 TypeScript
 
@@ -27,4 +28,4 @@ console.log(Status.toString(Status.Active));     // "Status.Active"
 console.log(Status.equals(Status.Active, Status.Active)); // true
 const json = Status.toJSON(Status.Pending);      // "pending"
 const parsed = Status.fromJSON("active");        // Status.Active
-```
+```

package/docs/builtin-macros/macros-overview/interface-support.md

@@ -1,6 +1,7 @@
 ## Interface Support
 
-All built-in macros work with interfaces. For interfaces, methods are generated as functions in a namespace with the same name, using `self` as the first parameter:
+All built-in macros work with interfaces. For interfaces, methods are generated as functions in a
+namespace with the same name, using `self` as the first parameter:
 
 TypeScript
 
@@ -25,4 +26,4 @@ const point: Point = { x: 10, y: 20 };
 console.log(Point.toString(point));     // "Point { x: 10, y: 20 }"
 const copy = Point.clone(point);        // { x: 10, y: 20 }
 console.log(Point.equals(point, copy)); // true
-```
+```