@macroforge/mcp-server 0.1.17 → 0.1.21

package/docs/builtin-macros/default.md

@@ -4,40 +4,15 @@
 
 ## Basic Usage
 
-```typescript
-/** @derive(Default) */
-class Config {
-  host: string;
-  port: number;
-  enabled: boolean;
-
-  constructor(host: string, port: number, enabled: boolean) {
-    this.host = host;
-    this.port = port;
-    this.enabled = enabled;
-  }
-}
+<MacroExample before={data.examples.basic.before} after={data.examples.basic.after} />
 
+```typescript
 const config = Config.default();
 console.log(config.host);    // ""
 console.log(config.port);    // 0
 console.log(config.enabled); // false
 ```
 
-## Generated Code
-
-The Default macro generates a static factory method:
-
-```typescript
-static default(): Config {
-    const instance = new Config();
-    instance.host = "";
-    instance.port = 0;
-    instance.enabled = false;
-    return instance;
-}
-```
-
 ## Automatic Default Values
 
 The Default macro automatically determines default values based on field types:
@@ -64,29 +39,9 @@ The Default macro automatically determines default values based on field types:
 
 Use the `@defaultValue()` decorator to specify custom default values for fields:
 
-```typescript
-/** @derive(Default) */
-class ServerConfig {
-  /** @defaultValue("localhost") */
-  host: string;
-
-  /** @defaultValue(8080) */
-  port: number;
-
-  /** @defaultValue(true) */
-  enabled: boolean;
-
-  /** @defaultValue(["info", "error"]) */
-  logLevels: string[];
-
-  constructor(host: string, port: number, enabled: boolean, logLevels: string[]) {
-    this.host = host;
-    this.port = port;
-    this.enabled = enabled;
-    this.logLevels = logLevels;
-  }
-}
+<MacroExample before={data.examples.custom.before} after={data.examples.custom.after} />
 
+```typescript
 const config = ServerConfig.default();
 console.log(config.host);      // "localhost"
 console.log(config.port);      // 8080
@@ -98,23 +53,9 @@ console.log(config.logLevels); // ["info", "error"]
 
 Default also works with interfaces. For interfaces, a namespace is generated with a `default_()` function (note the underscore to avoid conflicts with the reserved word):
 
-```typescript
-/** @derive(Default) */
-interface Point {
-  x: number;
-  y: number;
-}
-
-// Generated:
-// export namespace Point {
-//   export function default_(): Point {
-//     return {
-//       x: 0,
-//       y: 0
-//     } as Point;
-//   }
-// }
+<MacroExample before={data.examples.interface.before} after={data.examples.interface.after} />
 
+```typescript
 const origin = Point.default_();
 console.log(origin); // { x: 0, y: 0 }
 ```
@@ -123,21 +64,9 @@ console.log(origin); // { x: 0, y: 0 }
 
 Default works with enums. For enums, it returns the first variant as the default value:
 
-```typescript
-/** @derive(Default) */
-enum Status {
-  Pending = "pending",
-  Active = "active",
-  Completed = "completed",
-}
-
-// Generated:
-// export namespace Status {
-//   export function default_(): Status {
-//     return Status.Pending;
-//   }
-// }
+<MacroExample before={data.examples.enum.before} after={data.examples.enum.after} />
 
+```typescript
 const defaultStatus = Status.default_();
 console.log(defaultStatus); // "pending"
 ```
@@ -146,31 +75,16 @@ console.log(defaultStatus); // "pending"
 
 Default works with type aliases. For object types, it creates an object with default field values:
 
-```typescript
-/** @derive(Default) */
-type Dimensions = {
-  width: number;
-  height: number;
-};
-
-// Generated:
-// export namespace Dimensions {
-//   export function default_(): Dimensions {
-//     return {
-//       width: 0,
-//       height: 0
-//     } as Dimensions;
-//   }
-// }
+<MacroExample before={data.examples.typeAlias.before} after={data.examples.typeAlias.after} />
 
+```typescript
 const dims = Dimensions.default_();
 console.log(dims); // { width: 0, height: 0 }
 ```
 
 ## Combining with Other Macros
 
-```typescript
-/** @derive(Default, Debug, Clone, PartialEq) */
+<InteractiveMacro code={`/** @derive(Default, Debug, Clone, PartialEq) */
 class User {
   /** @defaultValue("Anonymous") */
   name: string;
@@ -182,8 +96,9 @@ class User {
     this.name = name;
     this.age = age;
   }
-}
+}`} />
 
+```typescript
 const user1 = User.default();
 const user2 = user1.clone();