@macroforge/mcp-server 0.1.40 → 0.1.49

package/docs/api/position-mapper.md

@@ -1,54 +1,110 @@
 # PositionMapper
-  *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
- ```
-import { NativePlugin, PositionMapper } from "macroforge";
 
-const plugin = new NativePlugin();
-const result = plugin.processFile("user.ts", code, { version: "1" });
-
-// Get the mapper for this file
-const mapper = plugin.getMapper("user.ts");
-if (mapper) {
-  // Use the mapper...
-}
-``` ## Methods
- ### isEmpty()
- Check if the mapper has any mappings:
- ```
-isEmpty(): boolean
-``` ### originalToExpanded()
- Map a position from original to expanded code:
- ```
-originalToExpanded(pos: number): number
-``` ### expandedToOriginal()
- Map a position from expanded to original code:
- ```
-expandedToOriginal(pos: number): number | null
-``` Returns `null` if the position is in generated code.
- ### isInGenerated()
- Check if a position is in macro-generated code:
- ```
-isInGenerated(pos: number): boolean
-``` ### generatedBy()
- Get the name of the macro that generated code at a position:
- ```
-generatedBy(pos: number): string | null
-``` ### mapSpanToOriginal()
- Map a span (range) from expanded to original code:
- ```
-mapSpanToOriginal(start: number, length: number): SpanResult | null
-
-interface SpanResult {
-  start: number;
-  length: number;
-}
-``` ### mapSpanToExpanded()
- Map a span from original to expanded code:
- ```
-mapSpanToExpanded(start: number, length: number): SpanResult
-``` ## Example: Error Position Mapping
- ```
+macroforge v0.1.43
+
+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
+
+TypeScript
+
+```
+import { NativePlugin, PositionMapper } from "macroforge";
+
+const plugin = new NativePlugin();
+const result = plugin.processFile("user.ts", code, { version: "1" });
+
+// Get the mapper for this file
+const mapper = plugin.getMapper("user.ts");
+if (mapper) {
+  // Use the mapper...
+}
+```
+
+## Methods
+
+### isEmpty()
+
+Check if the mapper has any mappings:
+
+TypeScript
+
+```
+isEmpty(): boolean
+```
+
+### originalToExpanded()
+
+Map a position from original to expanded code:
+
+TypeScript
+
+```
+originalToExpanded(pos: number): number
+```
+
+### expandedToOriginal()
+
+Map a position from expanded to original code:
+
+TypeScript
+
+```
+expandedToOriginal(pos: number): number | null
+```
+
+Returns `null` if the position is in generated code.
+
+### isInGenerated()
+
+Check if a position is in macro-generated code:
+
+TypeScript
+
+```
+isInGenerated(pos: number): boolean
+```
+
+### generatedBy()
+
+Get the name of the macro that generated code at a position:
+
+TypeScript
+
+```
+generatedBy(pos: number): string | null
+```
+
+### mapSpanToOriginal()
+
+Map a span (range) from expanded to original code:
+
+TypeScript
+
+```
+mapSpanToOriginal(start: number, length: number): SpanResult | null
+
+interface SpanResult {
+  start: number;
+  length: number;
+}
+```
+
+### mapSpanToExpanded()
+
+Map a span from original to expanded code:
+
+TypeScript
+
+```
+mapSpanToExpanded(start: number, length: number): SpanResult
+```
+
+## Example: Error Position Mapping
+
+TypeScript
+
+```
 import { NativePlugin } from "macroforge";
 
 const plugin = new NativePlugin();
@@ -78,8 +134,12 @@ function mapError(filepath: string, expandedPos: number, message: string) {
 
   return null;
 }
-``` ## Performance
- Position mapping uses binary search with O(log n) complexity:
- - Fast lookups even for large files
- - Minimal memory overhead
- - Thread-safe access
+```
+
+## Performance
+
+Position mapping uses binary search with O(log n) complexity:
+
+*   Fast lookups even for large files
+*   Minimal memory overhead
+*   Thread-safe access

package/docs/api/transform-sync.md

@@ -1,66 +1,92 @@
 # transformSync()
-  *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
- ```
-function transformSync(
-  code: string,
-  filepath: string
-): TransformResult
-``` ## Parameters
- | Parameter | Type | Description |
-| --- | --- | --- |
-| `code` | `string` | TypeScript source code to transform |
+
+macroforge v0.1.43
+
+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
+
+TypeScript
+
+```
+function transformSync(
+  code: string,
+  filepath: string
+): TransformResult
+```
+
+## Parameters
+
+| Parameter  | Type     | Description                          |
+| ---------- | -------- | ------------------------------------ |
+| `code`     | `string` | TypeScript source code to transform  |
 | `filepath` | `string` | File path (used for error reporting) |
- ## TransformResult
- ```
-interface TransformResult {
-  // Transformed TypeScript code
-  code: string;
-
-  // Source map (JSON string, not yet implemented)
-  map?: string;
-
-  // Generated type declarations
-  types?: string;
-
-  // Macro expansion metadata
-  metadata?: string;
-}
-``` ## Comparison with expandSync()
- | Feature | `expandSync` | `transformSync` |
-| --- | --- | --- |
-| Options | Yes | No |
-| Diagnostics | Yes | No |
-| Source Mapping | Yes | Limited |
-| Use Case | General purpose | Build tools |
- ## Example
- ```
-import { transformSync } from "macroforge";
-
-const sourceCode = \`
-/** @derive(Debug) */
-class User {
-  name: string;
-}
+
+## TransformResult
+
+TypeScript
+
+```
+interface TransformResult {
+  // Transformed TypeScript code
+  code: string;
+
+  // Source map (JSON string, not yet implemented)
+  map?: string;
+
+  // Generated type declarations
+  types?: string;
+
+  // Macro expansion metadata
+  metadata?: string;
+}
+```
+
+## Comparison with expandSync()
+
+| Feature        | `expandSync`    | `transformSync` |
+| -------------- | --------------- | --------------- |
+| Options        | Yes             | No              |
+| Diagnostics    | Yes             | No              |
+| Source Mapping | Yes             | Limited         |
+| Use Case       | General purpose | Build tools     |
+
+## Example
+
+TypeScript
+
+```
+import { transformSync } from "macroforge";
+
+const sourceCode = \`
+/** @derive(Debug) */
+class User {
+  name: string;
+}
 \`;
 
-const result = transformSync(sourceCode, "user.ts");
+const result = transformSync(sourceCode, "user.ts");
 
 console.log(result.code);
 
-if (result.types) {
-  // Write to .d.ts file
-  fs.writeFileSync("user.d.ts", result.types);
-}
-
-if (result.metadata) {
-  // Parse and use metadata
-  const meta = JSON.parse(result.metadata);
-  console.log("Macros expanded:", meta);
-}
-``` ## When to Use
- Use `transformSync` when:
- - 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.
+if (result.types) {
+  // Write to .d.ts file
+  fs.writeFileSync("user.d.ts", result.types);
+}
+
+if (result.metadata) {
+  // Parse and use metadata
+  const meta = JSON.parse(result.metadata);
+  console.log("Macros expanded:", meta);
+}
+```
+
+## When to Use
+
+Use `transformSync` when:
+
+*   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.

package/docs/builtin-macros/clone.md

@@ -53,26 +53,6 @@ export function pointClone(value: Point): Point {
 }
 ```
 
-Generated output:
-
-```typescript
-class Point {
-    x: number;
-    y: number;
-
-    static clone(value: Point): Point {
-        return pointClone(value);
-    }
-}
-
-export function pointClone(value: Point): Point {
-    const cloned = Object.create(Object.getPrototypeOf(value));
-    cloned.x = value.x;
-    cloned.y = value.y;
-    return cloned;
-}
-```
-
 ## Implementation Notes
 
 - **Classes**: Uses `Object.create(Object.getPrototypeOf(value))` to preserve

package/docs/builtin-macros/debug.md

@@ -59,26 +59,3 @@ export function userToString(value: User): string {
     return 'User { ' + parts.join(', ') + ' }';
 }
 ```
-
-Generated output:
-
-```typescript
-class User {
-    userId: number;
-
-    password: string;
-
-    email: string;
-
-    static toString(value: User): string {
-        return userToString(value);
-    }
-}
-
-export function userToString(value: User): string {
-    const parts: string[] = [];
-    parts.push('id: ' + value.userId);
-    parts.push('email: ' + value.email);
-    return 'User { ' + parts.join(', ') + ' }';
-}
-```

package/docs/builtin-macros/default.md

@@ -52,7 +52,7 @@ class UserSettings {
     /** @default(10) */
     pageSize: number;
 
-    notifications: boolean; // Uses type default: false
+    notifications: boolean;  // Uses type default: false
 }
 ```
 
@@ -74,26 +74,6 @@ class UserSettings {
 }
 ```
 
-Generated output:
-
-```typescript
-class UserSettings {
-    theme: string;
-
-    pageSize: number;
-
-    notifications: boolean; // Uses type default: false
-
-    static defaultValue(): UserSettings {
-        const instance = new UserSettings();
-        instance.theme = 'light';
-        instance.pageSize = 10;
-        instance.notifications = false;
-        return instance;
-    }
-}
-```
-
 ## Enum Defaults
 
 For enums, mark one variant with `@default`:
@@ -125,25 +105,6 @@ namespace Status {
 }
 ```
 
-Generated output:
-
-```typescript
-enum Status {
-    /** @default */
-    Pending,
-    Active,
-    Completed
-}
-
-export function statusDefaultValue(): Status {
-    return Status.Pending;
-}
-
-namespace Status {
-    export const defaultValue = statusDefaultValue;
-}
-```
-
 ## Error Handling
 
 The macro will return an error if: