@macroforge/mcp-server 0.1.39 → 0.1.42

package/docs/getting-started/first-macro.md

@@ -1,137 +1,139 @@
 # Your First Macro
  *Let's create a class that uses Macroforge's derive macros to automatically generate useful methods.*
  ## Creating a Class with Derive Macros
- Start by creating a simple `User` class. We'll use the `@derive` decorator to automatically generate methods.
- **Before:**
+ Start by creating a simple <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">User</code> class. We'll use the <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@derive</code> decorator to automatically generate methods.
+ <div><div class="flex items-center justify-between gap-2 px-4 py-2 bg-muted rounded-t-lg border border-b-0 border-border"> 
+**Before:**
 ```
 /** @derive(Debug, Clone, PartialEq) */
-export class User {
+export class User &#123;
     name: string;
     age: number;
     email: string;
 
-    constructor(name: string, age: number, email: string) {
+    constructor(name: string, age: number, email: string) &#123;
         this.name = name;
         this.age = age;
         this.email = email;
-    }
-}
-```  
+    &#125;
+&#125;
+``` <div class="flex items-center justify-between gap-2 px-4 py-2 bg-muted rounded-t-lg border border-b-0 border-border"> 
 **After:**
 ```
-export class User {
+export class User &#123;
     name: string;
     age: number;
     email: string;
 
-    constructor(name: string, age: number, email: string) {
+    constructor(name: string, age: number, email: string) &#123;
         this.name = name;
         this.age = age;
         this.email = email;
-    }
+    &#125;
 
-    static toString(value: User): string {
+    static toString(value: User): string &#123;
         return userToString(value);
-    }
+    &#125;
 
-    static clone(value: User): User {
+    static clone(value: User): User &#123;
         return userClone(value);
-    }
+    &#125;
 
-    static equals(a: User, b: User): boolean {
+    static equals(a: User, b: User): boolean &#123;
         return userEquals(a, b);
-    }
-}
+    &#125;
+&#125;
 
-export function userToString(value: User): string {
+export function userToString(value: User): string &#123;
     const parts: string[] = [];
     parts.push('name: ' + value.name);
     parts.push('age: ' + value.age);
     parts.push('email: ' + value.email);
-    return 'User { ' + parts.join(', ') + ' }';
-}
+    return 'User &#123; ' + parts.join(', ') + ' &#125;';
+&#125;
 
-export function userClone(value: User): User {
+export function userClone(value: User): User &#123;
     const cloned = Object.create(Object.getPrototypeOf(value));
     cloned.name = value.name;
     cloned.age = value.age;
     cloned.email = value.email;
     return cloned;
-}
+&#125;
 
-export function userEquals(a: User, b: User): boolean {
+export function userEquals(a: User, b: User): boolean &#123;
     if (a === b) return true;
-    return a.name === b.name && a.age === b.age && a.email === b.email;
-}
+    return a.name === b.name &#x26;&#x26; a.age === b.age &#x26;&#x26; a.email === b.email;
+&#125;
 ``` ## Using the Generated Methods
  ```
-const user = new User("Alice", 30, "alice@example.com");
+const&nbsp;user&nbsp;=&nbsp;new&nbsp;User("Alice",&nbsp;30,&nbsp;"alice@example.com");
 
-// Debug: toString()
+//&nbsp;Debug:&nbsp;toString()
 console.log(user.toString());
-// Output: User &#123; name: Alice, age: 30, email: alice@example.com &#125;
+//&nbsp;Output:&nbsp;User&nbsp;&#123;&nbsp;name:&nbsp;Alice,&nbsp;age:&nbsp;30,&nbsp;email:&nbsp;alice@example.com&nbsp;&#125;
 
-// Clone: clone()
-const copy = user.clone();
-console.log(copy.name); // "Alice"
+//&nbsp;Clone:&nbsp;clone()
+const&nbsp;copy&nbsp;=&nbsp;user.clone();
+console.log(copy.name);&nbsp;//&nbsp;"Alice"
 
-// Eq: equals()
-console.log(user.equals(copy)); // true
+//&nbsp;Eq:&nbsp;equals()
+console.log(user.equals(copy));&nbsp;//&nbsp;true
 
-const different = new User("Bob", 25, "bob@example.com");
-console.log(user.equals(different)); // false
+const&nbsp;different&nbsp;=&nbsp;new&nbsp;User("Bob",&nbsp;25,&nbsp;"bob@example.com");
+console.log(user.equals(different));&nbsp;//&nbsp;false
 ``` ## Customizing Behavior
  You can customize how macros work using field-level decorators. For example, with the Debug macro:
- **Before:**
+ <div><div class="flex items-center justify-between gap-2 px-4 py-2 bg-muted rounded-t-lg border border-b-0 border-border"> 
+**Before:**
 ```
 /** @derive(Debug) */
-export class User {
-    /** @debug({ rename: "userId" }) */
+export class User &#123;
+    /** @debug(&#123; rename: "userId" &#125;) */
     id: number;
 
     name: string;
 
-    /** @debug({ skip: true }) */
+    /** @debug(&#123; skip: true &#125;) */
     password: string;
 
-    constructor(id: number, name: string, password: string) {
+    constructor(id: number, name: string, password: string) &#123;
         this.id = id;
         this.name = name;
         this.password = password;
-    }
-}
-```  
+    &#125;
+&#125;
+``` <div class="flex items-center justify-between gap-2 px-4 py-2 bg-muted rounded-t-lg border border-b-0 border-border"> 
 **After:**
 ```
-export class User {
+export class User &#123;
     id: number;
 
     name: string;
 
     password: string;
 
-    constructor(id: number, name: string, password: string) {
+    constructor(id: number, name: string, password: string) &#123;
         this.id = id;
         this.name = name;
         this.password = password;
-    }
+    &#125;
 
-    static toString(value: User): string {
+    static toString(value: User): string &#123;
         return userToString(value);
-    }
-}
+    &#125;
+&#125;
 
-export function userToString(value: User): string {
+export function userToString(value: User): string &#123;
     const parts: string[] = [];
     parts.push('userId: ' + value.id);
     parts.push('name: ' + value.name);
-    return 'User { ' + parts.join(', ') + ' }';
-}
+    return 'User &#123; ' + parts.join(', ') + ' &#125;';
+&#125;
 ``` ```
-const user = new User(42, "Alice", "secret123");
+const&nbsp;user&nbsp;=&nbsp;new&nbsp;User(42,&nbsp;"Alice",&nbsp;"secret123");
 console.log(user.toString());
-// Output: User &#123; userId: 42, name: Alice &#125;
-// Note: 'id' is renamed to 'userId', 'password' is skipped
+//&nbsp;Output:&nbsp;User&nbsp;&#123;&nbsp;userId:&nbsp;42,&nbsp;name:&nbsp;Alice&nbsp;&#125;
+//&nbsp;Note:&nbsp;'id'&nbsp;is&nbsp;renamed&nbsp;to&nbsp;'userId',&nbsp;'password'&nbsp;is&nbsp;skipped
 ```  **Field-level decorators Field-level decorators let you control exactly how each field is handled by the macro. ## Next Steps
  - [Learn how macros work under the hood](../../docs/concepts)
  - [Explore all Debug options](../../docs/builtin-macros/debug)

package/docs/getting-started/installation.md

@@ -6,40 +6,40 @@
  ## Install the Package
  Install Macroforge using your preferred package manager:
  ```
-npm install macroforge
+npm install macroforge
 ``` ```
-bun add macroforge
+bun add macroforge
 ``` ```
-pnpm add macroforge
+pnpm add macroforge
 ```  **Info Macroforge includes pre-built native binaries for macOS (x64, arm64), Linux (x64, arm64), and Windows (x64, arm64). ## Basic Usage
- The simplest way to use Macroforge is with the built-in derive macros. Add a `@derive` comment decorator to your class:
+ The simplest way to use Macroforge is with the built-in derive macros. Add a **<code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@derive</code> comment decorator to your class:
  ```
-/** @derive(Debug, Clone, PartialEq) */
-class User &#123;
-  name: string;
-  age: number;
+/**&nbsp;@derive(Debug,&nbsp;Clone,&nbsp;PartialEq)&nbsp;*/
+class&nbsp;User&nbsp;&#123;
+&nbsp;&nbsp;name:&nbsp;string;
+&nbsp;&nbsp;age:&nbsp;number;
 
-  constructor(name: string, age: number) &#123;
-    this.name = name;
-    this.age = age;
-  &#125;
+&nbsp;&nbsp;constructor(name:&nbsp;string,&nbsp;age:&nbsp;number)&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;this.name&nbsp;=&nbsp;name;
+&nbsp;&nbsp;&nbsp;&nbsp;this.age&nbsp;=&nbsp;age;
+&nbsp;&nbsp;&#125;
 &#125;
 
-// After macro expansion, User has:
-// - toString(): string              (from Debug)
-// - clone(): User                   (from Clone)
-// - equals(other: unknown): boolean (from PartialEq)
+//&nbsp;After&nbsp;macro&nbsp;expansion,&nbsp;User&nbsp;has:
+//&nbsp;-&nbsp;toString():&nbsp;string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(from&nbsp;Debug)
+//&nbsp;-&nbsp;clone():&nbsp;User&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(from&nbsp;Clone)
+//&nbsp;-&nbsp;equals(other:&nbsp;unknown):&nbsp;boolean&nbsp;(from&nbsp;PartialEq)
 ``` ## IDE Integration
- For the best development experience, add the TypeScript plugin to your `tsconfig.json`:
+ For the best development experience, add the TypeScript plugin to your <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">tsconfig.json</code>:
  ```
 &#123;
-  "compilerOptions": &#123;
-    "plugins": [
-      &#123;
-        "name": "@macroforge/typescript-plugin"
-      &#125;
-    ]
-  &#125;
+&nbsp;&nbsp;"compilerOptions":&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;"plugins":&nbsp;[
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name":&nbsp;"@macroforge/typescript-plugin"
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#125;
+&nbsp;&nbsp;&nbsp;&nbsp;]
+&nbsp;&nbsp;&#125;
 &#125;
 ``` This enables features like:
  - Accurate error positions in your source code
@@ -48,20 +48,19 @@ class User &#123;
  ## Build Integration (Vite)
  If you're using Vite, add the plugin to your config for automatic macro expansion during build:
  ```
-import macroforge from "@macroforge/vite-plugin";
-import &#123; defineConfig &#125; from "vite";
+import&nbsp;macroforge&nbsp;from&nbsp;"@macroforge/vite-plugin";
+import&nbsp;&#123;&nbsp;defineConfig&nbsp;&#125;&nbsp;from&nbsp;"vite";
 
-export default defineConfig(&#123;
-  plugins: [
-    macroforge(&#123;
-      generateTypes: true,
-      typesOutputDir: ".macroforge/types"
-    &#125;)
-  ]
+export&nbsp;default&nbsp;defineConfig(&#123;
+&nbsp;&nbsp;plugins:&nbsp;[
+&nbsp;&nbsp;&nbsp;&nbsp;macroforge(&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;generateTypes:&nbsp;true,
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;typesOutputDir:&nbsp;".macroforge/types"
+&nbsp;&nbsp;&nbsp;&nbsp;&#125;)
+&nbsp;&nbsp;]
 &#125;);
 ``` ## Next Steps
  Now that you have Macroforge installed, learn how to use it:
  - [Create your first macro](../docs/getting-started/first-macro)
  - [Understand how macros work](../docs/concepts)
- - [Explore built-in macros](../docs/builtin-macros)
-**
+ - [Explore built-in macros](../docs/builtin-macros)

package/docs/integration/cli.md

@@ -3,71 +3,71 @@
  ## Installation
  The CLI is a Rust binary. You can install it using Cargo:
  ```
-cargo install macroforge_ts
+cargo install macroforge_ts
 ``` Or build from source:
  ```
-git clone https://github.com/rymskip/macroforge-ts.git
-cd macroforge-ts/crates
-cargo build --release --bin macroforge
+git clone https://github.com/rymskip/macroforge-ts.git
+cd macroforge-ts/crates
+cargo build --release --bin macroforge
 
-# The binary is at target/release/macroforge
+# The binary is at target/release/macroforge
 ``` ## Commands
  ### macroforge expand
  Expands macros in a TypeScript file and outputs the transformed code.
  ```
-macroforge expand <input> [options]
+macroforge expand <input> [options]
 ``` #### Arguments
  | Argument | Description |
 | --- | --- |
-| `<input>` | Path to the TypeScript or TSX file to expand |
+| <input> | Path to the TypeScript or TSX file to expand |
  #### Options
  | Option | Description |
 | --- | --- |
-| `--out <path>` | Write the expanded JavaScript/TypeScript to a file |
-| `--types-out <path>` | Write the generated `.d.ts` declarations to a file |
-| `--print` | Print output to stdout even when `--out` is specified |
-| `--builtin-only` | Use only built-in Rust macros (faster, but no external macro support) |
+| --out <path> | Write the expanded JavaScript/TypeScript to a file |
+| --types-out <path> | Write the generated .d.ts declarations to a file |
+| --print | Print output to stdout even when --out is specified |
+| --builtin-only | Use only built-in Rust macros (faster, but no external macro support) |
  #### Examples
  Expand a file and print to stdout:
  ```
-macroforge expand src/user.ts
+macroforge&nbsp;expand&nbsp;src/user.ts
 ``` Expand and write to a file:
  ```
-macroforge expand src/user.ts --out dist/user.js
+macroforge&nbsp;expand&nbsp;src/user.ts&nbsp;--out&nbsp;dist/user.js
 ``` Expand with both runtime output and type declarations:
  ```
-macroforge expand src/user.ts --out dist/user.js --types-out dist/user.d.ts
+macroforge&nbsp;expand&nbsp;src/user.ts&nbsp;--out&nbsp;dist/user.js&nbsp;--types-out&nbsp;dist/user.d.ts
 ``` Use fast built-in macros only (no external macro support):
  ```
-macroforge expand src/user.ts --builtin-only
+macroforge&nbsp;expand&nbsp;src/user.ts&nbsp;--builtin-only
 ``` > **Note:** By default, the CLI uses Node.js for full macro support (including external macros). It must be run from your project's root directory where macroforge and any external macro packages are installed in node_modules. ### macroforge tsc
- Runs TypeScript type checking with macro expansion. This wraps `tsc --noEmit` and expands macros before type checking, so your generated methods are properly type-checked.
+ Runs TypeScript type checking with macro expansion. This wraps <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">tsc <span style="--shiki-dark:#F97583;--shiki-light:#D73A49">--<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">noEmit</code> and expands macros before type checking, so your generated methods are properly type-checked.
  ```
-macroforge tsc [options]
+macroforge&nbsp;tsc&nbsp;[options]
 ``` #### Options
  | Option | Description |
 | --- | --- |
-| `-p, --project <path>` | Path to `tsconfig.json` (defaults to `tsconfig.json` in current directory) |
+| -p, --project <path> | Path to tsconfig.json (defaults to tsconfig.json in current directory) |
  #### Examples
  Type check with default tsconfig.json:
  ```
-macroforge tsc
+macroforge&nbsp;tsc
 ``` Type check with a specific config:
  ```
-macroforge tsc -p tsconfig.build.json
+macroforge&nbsp;tsc&nbsp;-p&nbsp;tsconfig.build.json
 ``` ## Output Format
  ### Expanded Code
  When expanding a file like this:
  ```
-/** @derive(Debug) */
-class User &#123;
-  name: string;
-  age: number;
+/**&nbsp;@derive(Debug)&nbsp;*/
+class&nbsp;User&nbsp;&#123;
+&nbsp;&nbsp;name:&nbsp;string;
+&nbsp;&nbsp;age:&nbsp;number;
 
-  constructor(name: string, age: number) &#123;
-    this.name = name;
-    this.age = age;
-  &#125;
+&nbsp;&nbsp;constructor(name:&nbsp;string,&nbsp;age:&nbsp;number)&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;this.name&nbsp;=&nbsp;name;
+&nbsp;&nbsp;&nbsp;&nbsp;this.age&nbsp;=&nbsp;age;
+&nbsp;&nbsp;&#125;
 &#125;
 ``` The CLI outputs the expanded code with the generated methods:
  ```
@@ -87,35 +87,35 @@ class User {
 ``` ### Diagnostics
  Errors and warnings are printed to stderr in a readable format:
  ```
-[macroforge] error at src/user.ts:5:1: Unknown derive macro: InvalidMacro
-[macroforge] warning at src/user.ts:10:3: Field 'unused' is never used
+[macroforge]&nbsp;error&nbsp;at&nbsp;src/user.ts:5:1:&nbsp;Unknown&nbsp;derive&nbsp;macro:&nbsp;InvalidMacro
+[macroforge]&nbsp;warning&nbsp;at&nbsp;src/user.ts:10:3:&nbsp;Field&nbsp;'unused'&nbsp;is&nbsp;never&nbsp;used
 ``` ## Use Cases
  ### CI/CD Type Checking
- Use `macroforge tsc` in your CI pipeline to type-check with macro expansion:
+ Use <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#B392F0;--shiki-light:#6F42C1">macroforge<span style="--shiki-dark:#9ECBFF;--shiki-light:#032F62"> tsc</code> in your CI pipeline to type-check with macro expansion:
  ```
-# package.json
+#&nbsp;package.json
 &#123;
-  "scripts": &#123;
-    "typecheck": "macroforge tsc"
-  &#125;
+&nbsp;&nbsp;"scripts":&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;"typecheck":&nbsp;"macroforge&nbsp;tsc"
+&nbsp;&nbsp;&#125;
 &#125;
 ``` ### Debugging Macro Output
- Use `macroforge expand` to inspect what code your macros generate:
+ Use <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#B392F0;--shiki-light:#6F42C1">macroforge<span style="--shiki-dark:#9ECBFF;--shiki-light:#032F62"> expand</code> to inspect what code your macros generate:
  ```
-macroforge expand src/models/user.ts | less
+macroforge&nbsp;expand&nbsp;src/models/user.ts&nbsp;|&nbsp;less
 ``` ### Build Pipeline
  Generate expanded files as part of a custom build:
  ```
 #!/bin/bash
-for file in src/**/*.ts; do
-  outfile="dist/$(basename "$file" .ts).js"
-  macroforge expand "$file" --out "$outfile"
+for&nbsp;file&nbsp;in&nbsp;src/**/*.ts;&nbsp;do
+&nbsp;&nbsp;outfile="dist/$(basename&nbsp;"$file"&nbsp;.ts).js"
+&nbsp;&nbsp;macroforge&nbsp;expand&nbsp;"$file"&nbsp;--out&nbsp;"$outfile"
 done
 ``` ## Built-in vs Full Mode
- By default, the CLI uses Node.js for full macro support including external macros. Use `--builtin-only` for faster expansion when you only need built-in macros:
- | Feature | Default (Node.js) | `--builtin-only` (Rust) |
+ By default, the CLI uses Node.js for full macro support including external macros. Use <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#F97583;--shiki-light:#D73A49">--<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">builtin<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">only</code> for faster expansion when you only need built-in macros:
+ | Feature | Default (Node.js) | --builtin-only (Rust) |
 | --- | --- | --- |
 | Built-in macros | Yes | Yes |
 | External macros | Yes | No |
 | Performance | Standard | Faster |
-| Dependencies | Requires `macroforge` in node_modules | None |
+| Dependencies | Requires macroforge in node_modules | None |

package/docs/integration/configuration.md

@@ -1,73 +1,73 @@
 # Configuration
- *Macroforge can be configured with a `macroforge.json` file in your project root.*
+ *Macroforge can be configured with a <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">macroforge.json</code> file in your project root.*
  ## Configuration File
- Create a `macroforge.json` file:
+ Create a <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">macroforge.json</code> file:
  ```
 &#123;
-  "allowNativeMacros": true,
-  "macroPackages": [],
-  "keepDecorators": false,
-  "limits": &#123;
-    "maxExecutionTimeMs": 5000,
-    "maxMemoryBytes": 104857600,
-    "maxOutputSize": 10485760,
-    "maxDiagnostics": 100
-  &#125;
+&nbsp;&nbsp;"allowNativeMacros":&nbsp;true,
+&nbsp;&nbsp;"macroPackages":&nbsp;[],
+&nbsp;&nbsp;"keepDecorators":&nbsp;false,
+&nbsp;&nbsp;"limits":&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;"maxExecutionTimeMs":&nbsp;5000,
+&nbsp;&nbsp;&nbsp;&nbsp;"maxMemoryBytes":&nbsp;104857600,
+&nbsp;&nbsp;&nbsp;&nbsp;"maxOutputSize":&nbsp;10485760,
+&nbsp;&nbsp;&nbsp;&nbsp;"maxDiagnostics":&nbsp;100
+&nbsp;&nbsp;&#125;
 &#125;
 ``` ## Options Reference
  ### allowNativeMacros
- | Type | `boolean` |
-| Default | `true` |
- Enable or disable native (Rust) macro packages. Set to `false` to only allow built-in macros.
+ | Type | boolean |
+| Default | true |
+ Enable or disable native (Rust) macro packages. Set to <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#79B8FF;--shiki-light:#005CC5">false</code> to only allow built-in macros.
  ### macroPackages
- | Type | `string[]` |
-| Default | `[]` |
+ | Type | string[] |
+| Default | [] |
  List of npm packages that provide macros. Macroforge will look for macros in these packages.
  ```
 &#123;
-  "macroPackages": [
-    "@my-org/custom-macros",
-    "community-macros"
-  ]
+&nbsp;&nbsp;"macroPackages":&nbsp;[
+&nbsp;&nbsp;&nbsp;&nbsp;"@my-org/custom-macros",
+&nbsp;&nbsp;&nbsp;&nbsp;"community-macros"
+&nbsp;&nbsp;]
 &#125;
 ``` ### keepDecorators
- | Type | `boolean` |
-| Default | `false` |
- Keep `@derive` decorators in the output. Useful for debugging.
+ | Type | boolean |
+| Default | false |
+ Keep <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@derive</code> decorators in the output. Useful for debugging.
  ### limits
  Configure resource limits for macro expansion:
  ```
 &#123;
-  "limits": &#123;
-    // Maximum time for a single macro expansion (ms)
-    "maxExecutionTimeMs": 5000,
+&nbsp;&nbsp;"limits":&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Maximum&nbsp;time&nbsp;for&nbsp;a&nbsp;single&nbsp;macro&nbsp;expansion&nbsp;(ms)
+&nbsp;&nbsp;&nbsp;&nbsp;"maxExecutionTimeMs":&nbsp;5000,
 
-    // Maximum memory usage (bytes)
-    "maxMemoryBytes": 104857600,  // 100MB
+&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Maximum&nbsp;memory&nbsp;usage&nbsp;(bytes)
+&nbsp;&nbsp;&nbsp;&nbsp;"maxMemoryBytes":&nbsp;104857600,&nbsp;&nbsp;//&nbsp;100MB
 
-    // Maximum size of generated code (bytes)
-    "maxOutputSize": 10485760,    // 10MB
+&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Maximum&nbsp;size&nbsp;of&nbsp;generated&nbsp;code&nbsp;(bytes)
+&nbsp;&nbsp;&nbsp;&nbsp;"maxOutputSize":&nbsp;10485760,&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;10MB
 
-    // Maximum number of diagnostics per file
-    "maxDiagnostics": 100
-  &#125;
+&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;diagnostics&nbsp;per&nbsp;file
+&nbsp;&nbsp;&nbsp;&nbsp;"maxDiagnostics":&nbsp;100
+&nbsp;&nbsp;&#125;
 &#125;
 ``` ## Macro Runtime Overrides
  Override settings for specific macros:
  ```
 &#123;
-  "macroRuntimeOverrides": &#123;
-    "@my-org/macros": &#123;
-      "maxExecutionTimeMs": 10000
-    &#125;
-  &#125;
+&nbsp;&nbsp;"macroRuntimeOverrides":&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;"@my-org/macros":&nbsp;&#123;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"maxExecutionTimeMs":&nbsp;10000
+&nbsp;&nbsp;&nbsp;&nbsp;&#125;
+&nbsp;&nbsp;&#125;
 &#125;
 ```  **Warning Be careful when increasing limits, as this could allow malicious macros to consume excessive resources. ## Environment Variables
  Some settings can be overridden with environment variables:
  | Variable | Description |
 | --- | --- |
-| `MACROFORGE_DEBUG` | Enable debug logging |
-| `MACROFORGE_LOG_FILE` | Write logs to a file |
+| MACROFORGE_DEBUG | Enable debug logging |
+| MACROFORGE_LOG_FILE | Write logs to a file |
  ```
-MACROFORGE_DEBUG=1 npm run dev
+MACROFORGE_DEBUG=1&nbsp;npm&nbsp;run&nbsp;dev
 ```**

package/docs/integration/integration-overview.md

@@ -3,15 +3,15 @@
  ## Overview
  | Integration | Purpose | Package |
 | --- | --- | --- |
-| TypeScript Plugin | IDE support (errors, completions) | `@macroforge/typescript-plugin` |
-| Vite Plugin | Build-time macro expansion | `@macroforge/vite-plugin` |
+| TypeScript Plugin | IDE support (errors, completions) | @macroforge/typescript-plugin |
+| Vite Plugin | Build-time macro expansion | @macroforge/vite-plugin |
  ## Recommended Setup
  For the best development experience, use both integrations:
  1. **TypeScript Plugin**: Provides real-time feedback in your IDE
  2. **Vite Plugin**: Expands macros during development and production builds
  ```
-# Install both plugins
-npm install -D @macroforge/typescript-plugin @macroforge/vite-plugin
+# Install both plugins
+npm install -D @macroforge/typescript-plugin @macroforge/vite-plugin
 ``` ## How They Work Together
  <div class="flex justify-center"><div class="border-2 border-primary bg-primary/10 rounded-lg px-6 py-3 text-center"><div class="font-semibold text-primary">Your Code TypeScript with @derive decorators  <div class="absolute top-0 h-px bg-border" style="width: 50%; left: 25%;"> <div class="flex flex-col items-center">  <div class="border border-border bg-card rounded-lg px-4 py-3 text-center w-full mt-1"><div class="font-medium text-foreground">TypeScript Plugin Language service integration   <div class="border border-success/30 bg-success/10 rounded-md px-3 py-2 text-center"><div class="text-sm font-medium text-success-foreground">IDE Feedback Errors & completions  <div class="border border-border bg-card rounded-lg px-4 py-3 text-center w-full mt-1"><div class="font-medium text-foreground">Vite Plugin Build-time transformation   <div class="border border-success/30 bg-success/10 rounded-md px-3 py-2 text-center"><div class="text-sm font-medium text-success-foreground">Dev Server Hot reload<div class="text-sm font-medium text-success-foreground">Production Build Optimized output ## Detailed Guides
  - [TypeScript Plugin setup](../docs/integration/typescript-plugin)