@macroforge/mcp-server 0.1.42 → 0.1.50

package/docs/integration/vite-plugin.md

@@ -1,77 +1,117 @@
 # Vite Plugin
- *The Vite plugin provides build-time macro expansion, transforming your code during development and production builds.*
- ## Installation
- ```
-npm install -D @macroforge/vite-plugin
-``` ## Configuration
- Add the plugin to your <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">vite.config.ts</code>:
- ```
-import&nbsp;macroforge&nbsp;from&nbsp;"@macroforge/vite-plugin";
-import&nbsp;&#123;&nbsp;defineConfig&nbsp;&#125;&nbsp;from&nbsp;"vite";
-
-export&nbsp;default&nbsp;defineConfig(&#123;
-&nbsp;&nbsp;plugins:&nbsp;[
-&nbsp;&nbsp;&nbsp;&nbsp;macroforge()
-&nbsp;&nbsp;]
-&#125;);
-``` ## Options
- ```
-macroforge(&#123;
-&nbsp;&nbsp;//&nbsp;Generate&nbsp;.d.ts&nbsp;files&nbsp;for&nbsp;expanded&nbsp;code
-&nbsp;&nbsp;generateTypes:&nbsp;true,
-
-&nbsp;&nbsp;//&nbsp;Output&nbsp;directory&nbsp;for&nbsp;generated&nbsp;types
-&nbsp;&nbsp;typesOutputDir:&nbsp;".macroforge/types",
-
-&nbsp;&nbsp;//&nbsp;Emit&nbsp;metadata&nbsp;files&nbsp;for&nbsp;debugging
-&nbsp;&nbsp;emitMetadata:&nbsp;false,
-
-&nbsp;&nbsp;//&nbsp;Keep&nbsp;@derive&nbsp;decorators&nbsp;in&nbsp;output&nbsp;(for&nbsp;debugging)
-&nbsp;&nbsp;keepDecorators:&nbsp;false,
-
-&nbsp;&nbsp;//&nbsp;File&nbsp;patterns&nbsp;to&nbsp;process
-&nbsp;&nbsp;include:&nbsp;["**/*.ts",&nbsp;"**/*.tsx"],
-&nbsp;&nbsp;exclude:&nbsp;["node_modules/**"]
-&#125;)
-``` ### Option Reference
- | Option | Type | Default | Description |
-| --- | --- | --- | --- |
-| generateTypes | boolean | true | Generate .d.ts files |
-| typesOutputDir | string | .macroforge/types | Where to write type files |
-| emitMetadata | boolean | false | Emit macro metadata files |
-| keepDecorators | boolean | false | Keep decorators in output |
- ## Framework Integration
- ### React (Vite)
- ```
-import&nbsp;macroforge&nbsp;from&nbsp;"@macroforge/vite-plugin";
-import&nbsp;react&nbsp;from&nbsp;"@vitejs/plugin-react";
-import&nbsp;&#123;&nbsp;defineConfig&nbsp;&#125;&nbsp;from&nbsp;"vite";
-
-export&nbsp;default&nbsp;defineConfig(&#123;
-&nbsp;&nbsp;plugins:&nbsp;[
-&nbsp;&nbsp;&nbsp;&nbsp;macroforge(),&nbsp;&nbsp;//&nbsp;Before&nbsp;React&nbsp;plugin
-&nbsp;&nbsp;&nbsp;&nbsp;react()
-&nbsp;&nbsp;]
-&#125;);
-``` ### SvelteKit
- ```
-import&nbsp;macroforge&nbsp;from&nbsp;"@macroforge/vite-plugin";
-import&nbsp;&#123;&nbsp;sveltekit&nbsp;&#125;&nbsp;from&nbsp;"@sveltejs/kit/vite";
-import&nbsp;&#123;&nbsp;defineConfig&nbsp;&#125;&nbsp;from&nbsp;"vite";
-
-export&nbsp;default&nbsp;defineConfig(&#123;
-&nbsp;&nbsp;plugins:&nbsp;[
-&nbsp;&nbsp;&nbsp;&nbsp;macroforge(),&nbsp;&nbsp;//&nbsp;Before&nbsp;SvelteKit
-&nbsp;&nbsp;&nbsp;&nbsp;sveltekit()
-&nbsp;&nbsp;]
-&#125;);
-``` > **Note:** Always place the Macroforge plugin before other framework plugins to ensure macros are expanded first. ## Development Server
- During development, the plugin:
- - Watches for file changes
- - Expands macros on save
- - Provides HMR support for expanded code
- ## Production Build
- During production builds, the plugin:
- - Expands all macros in the source files
- - Generates type declaration files
- - Strips <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@derive</code> decorators from output
+
+The Vite plugin provides build-time macro expansion, transforming your code during development and production builds.
+
+## Installation
+
+Bash
+
+```
+npm install -D @macroforge/vite-plugin
+```
+
+## Configuration
+
+Add the plugin to your `vite.config.ts`:
+
+vite.config.ts 
+
+```
+import macroforge from "@macroforge/vite-plugin";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [
+    macroforge()
+  ]
+});
+```
+
+## Options
+
+TypeScript
+
+```
+macroforge({
+  // Generate .d.ts files for expanded code
+  generateTypes: true,
+
+  // Output directory for generated types
+  typesOutputDir: ".macroforge/types",
+
+  // Emit metadata files for debugging
+  emitMetadata: false,
+
+  // Keep @derive decorators in output (for debugging)
+  keepDecorators: false,
+
+  // File patterns to process
+  include: ["**/*.ts", "**/*.tsx"],
+  exclude: ["node_modules/**"]
+})
+```
+
+### Option Reference
+
+| Option           | Type      | Default             | Description               |
+| ---------------- | --------- | ------------------- | ------------------------- |
+| `generateTypes`  | `boolean` | `true`              | Generate .d.ts files      |
+| `typesOutputDir` | `string`  | `.macroforge/types` | Where to write type files |
+| `emitMetadata`   | `boolean` | `false`             | Emit macro metadata files |
+| `keepDecorators` | `boolean` | `false`             | Keep decorators in output |
+
+## Framework Integration
+
+### React (Vite)
+
+vite.config.ts 
+
+```
+import macroforge from "@macroforge/vite-plugin";
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [
+    macroforge(),  // Before React plugin
+    react()
+  ]
+});
+```
+
+### SvelteKit
+
+vite.config.ts 
+
+```
+import macroforge from "@macroforge/vite-plugin";
+import { sveltekit } from "@sveltejs/kit/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [
+    macroforge(),  // Before SvelteKit
+    sveltekit()
+  ]
+});
+```
+
+Note
+
+Always place the Macroforge plugin before other framework plugins to ensure macros are expanded first.
+
+## Development Server
+
+During development, the plugin:
+
+*   Watches for file changes
+*   Expands macros on save
+*   Provides HMR support for expanded code
+
+## Production Build
+
+During production builds, the plugin:
+
+*   Expands all macros in the source files
+*   Generates type declaration files
+*   Strips `@derive` decorators from output

package/docs/language-servers/ls-overview.md

@@ -1,23 +1,39 @@
 # Language Servers
- *Macroforge provides language server integrations for enhanced IDE support beyond the TypeScript plugin.*
-  **Work in Progress Language server integrations are currently experimental. They work in the repository but are not yet published as official extensions. You'll need to fork the repo and install them as developer extensions. ## Overview
- While the [TypeScript Plugin](../docs/integration/typescript-plugin) provides macro support in any TypeScript-aware editor, dedicated language servers offer deeper integration for specific frameworks and editors.
- | Integration | Purpose | Status |
-| --- | --- | --- |
+
+Macroforge provides language server integrations for enhanced IDE support beyond the TypeScript plugin.
+
+Work in Progress
+
+Language server integrations are currently experimental. They work in the repository but are not yet published as official extensions. You'll need to fork the repo and install them as developer extensions.
+
+## Overview
+
+While the [TypeScript Plugin](../docs/integration/typescript-plugin) provides macro support in any TypeScript-aware editor, dedicated language servers offer deeper integration for specific frameworks and editors.
+
+| Integration                                               | Purpose                             | Status                |
+| --------------------------------------------------------- | ----------------------------------- | --------------------- |
 | [Svelte Language Server](../docs/language-servers/svelte) | Full Svelte support with macroforge | Working (dev install) |
-| [Zed Extensions](../docs/language-servers/zed) | VTSLS and Svelte for Zed editor | Working (dev install) |
- ## Current Status
- The language servers are functional and used during development of macroforge itself. However, they require manual installation:
- 1. Fork or clone the [macroforge-ts repository](https://github.com/rymskip/macroforge-ts)
- 2. Build the extension you need
- 3. Install it as a developer extension in your editor
- See the individual pages for detailed installation instructions.
- ## Roadmap
- We're working on official extension releases for:
- - VS Code (via VTSLS)
- - Zed (native extensions)
- - Other editors with LSP support
- ## Detailed Guides
- - [Svelte Language Server](../docs/language-servers/svelte) - Full Svelte IDE support
- - [Zed Extensions](../docs/language-servers/zed) - VTSLS and Svelte for Zed
-**
+| [Zed Extensions](../docs/language-servers/zed)            | VTSLS and Svelte for Zed editor     | Working (dev install) |
+
+## Current Status
+
+The language servers are functional and used during development of macroforge itself. However, they require manual installation:
+
+1.  Fork or clone the [macroforge-ts repository](https://github.com/rymskip/macroforge-ts)
+2.  Build the extension you need
+3.  Install it as a developer extension in your editor
+
+See the individual pages for detailed installation instructions.
+
+## Roadmap
+
+We're working on official extension releases for:
+
+*   VS Code (via VTSLS)
+*   Zed (native extensions)
+*   Other editors with LSP support
+
+## Detailed Guides
+
+*   [Svelte Language Server](../docs/language-servers/svelte) - Full Svelte IDE support
+*   [Zed Extensions](../docs/language-servers/zed) - VTSLS and Svelte for Zed

package/docs/language-servers/svelte.md

@@ -1,40 +1,71 @@
 # Svelte Language Server
- *<code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@macroforge<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">/<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">svelte<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">language<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">server</code> provides full Svelte IDE support with macroforge integration.*
-  **Developer Installation Required This package is not yet published as an official extension. You'll need to build and install it manually. ## Features
- - **Svelte syntax diagnostics** - Errors and warnings in .svelte files
- - **HTML support** - Hover info, autocompletions, Emmet, outline symbols
- - **CSS/SCSS/LESS** - Diagnostics, hover, completions, formatting, Emmet, color picking
- - **TypeScript/JavaScript** - Full language features with macroforge macro expansion
- - **Go-to-definition** - Navigate to macro-generated code
- - **Code actions** - Quick fixes and refactorings
- ## Installation
- ### 1. Clone the Repository
- ```
-git&nbsp;clone&nbsp;https://github.com/rymskip/macroforge-ts.git
-cd&nbsp;macroforge-ts
-``` ### 2. Build the Language Server
- ```
-#&nbsp;Install&nbsp;dependencies
-npm&nbsp;install
-
-#&nbsp;Build&nbsp;the&nbsp;Svelte&nbsp;language&nbsp;server
-cd&nbsp;packages/svelte-language-server
-npm&nbsp;run&nbsp;build
-``` ### 3. Configure Your Editor
- The language server exposes a **<code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">svelteserver</code> binary that implements the Language Server Protocol (LSP). Configure your editor to use it:
- ```
-#&nbsp;The&nbsp;binary&nbsp;is&nbsp;located&nbsp;at:
+
+`@macroforge/svelte-language-server` provides full Svelte IDE support with macroforge integration.
+
+Developer Installation Required
+
+This package is not yet published as an official extension. You'll need to build and install it manually.
+
+## Features
+
+*   **Svelte syntax diagnostics** - Errors and warnings in .svelte files
+*   **HTML support** - Hover info, autocompletions, Emmet, outline symbols
+*   **CSS/SCSS/LESS** - Diagnostics, hover, completions, formatting, Emmet, color picking
+*   **TypeScript/JavaScript** - Full language features with macroforge macro expansion
+*   **Go-to-definition** - Navigate to macro-generated code
+*   **Code actions** - Quick fixes and refactorings
+
+## Installation
+
+### 1\. Clone the Repository
+
+Bash
+
+```
+git clone https://github.com/rymskip/macroforge-ts.git
+cd macroforge-ts
+```
+
+### 2\. Build the Language Server
+
+Bash
+
+```
+# Install dependencies
+npm install
+
+# Build the Svelte language server
+cd packages/svelte-language-server
+npm run build
+```
+
+### 3\. Configure Your Editor
+
+The language server exposes a `svelteserver` binary that implements the Language Server Protocol (LSP). Configure your editor to use it:
+
+Bash
+
+```
+# The binary is located at:
 ./packages/svelte-language-server/bin/server.js
-``` ## Package Info
- | Package | @macroforge/svelte-language-server |
-| Version | 0.1.7 |
-| CLI Command | svelteserver |
-| Node Version | >= 18.0.0 |
- ## How It Works
- The Svelte language server extends the standard Svelte language tooling with macroforge integration:
- 1. Parses <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">.svelte</code> files and extracts TypeScript/JavaScript blocks
- 2. Expands macros using the <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@macroforge<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">/<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">typescript<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">plugin</code>
- 3. Maps diagnostics back to original source positions
- 4. Provides completions for macro-generated methods
- ## Using with Zed
- For Zed editor, see the [Zed Extensions](../../docs/language-servers/zed) page for the dedicated <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">svelte<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">macroforge</code> extension.
+```
+
+## Package Info
+
+| Package      | `@macroforge/svelte-language-server` |
+| Version      | 0.1.7                                |
+| CLI Command  | `svelteserver`                       |
+| Node Version | \>= 18.0.0                           |
+
+## How It Works
+
+The Svelte language server extends the standard Svelte language tooling with macroforge integration:
+
+1.  Parses `.svelte` files and extracts TypeScript/JavaScript blocks
+2.  Expands macros using the `@macroforge/typescript-plugin`
+3.  Maps diagnostics back to original source positions
+4.  Provides completions for macro-generated methods
+
+## Using with Zed
+
+For Zed editor, see the [Zed Extensions](../../docs/language-servers/zed) page for the dedicated `svelte-macroforge` extension.

package/docs/language-servers/zed.md

@@ -1,45 +1,82 @@
 # Zed Extensions
- *Macroforge provides two extensions for the [Zed editor](https://zed.dev): one for TypeScript via VTSLS, and one for Svelte.*
-  **Developer Installation Required These extensions are not yet in the Zed extension registry. You'll need to install them as developer extensions. ## Available Extensions
- | Extension | Description | Location |
-| --- | --- | --- |
-| vtsls-macroforge | VTSLS with macroforge support for TypeScript | crates/extensions/vtsls-macroforge |
-| svelte-macroforge | Svelte language support with macroforge | crates/extensions/svelte-macroforge |
- ## Installation
- ### 1. Clone the Repository
- ```
-git clone https://github.com/rymskip/macroforge-ts.git
-cd macroforge-ts
-``` ### 2. Build the Extension
- Build the extension you want to use:
- ```
-# For VTSLS (TypeScript)
-cd crates/extensions/vtsls-macroforge
-
-# Or for Svelte
-cd crates/extensions/svelte-macroforge
-``` ### 3. Install as Dev Extension in Zed
- In Zed, open the command palette and run **zed: install dev extension**, then select the extension directory.
- Alternatively, symlink the extension to your Zed extensions directory:
- ```
-# macOS
-ln -s /path/to/macroforge-ts/crates/extensions/vtsls-macroforge ~/Library/Application\\ Support/Zed/extensions/installed/vtsls-macroforge
-
-# Linux
-ln -s /path/to/macroforge-ts/crates/extensions/vtsls-macroforge ~/.config/zed/extensions/installed/vtsls-macroforge
-``` ## vtsls-macroforge
- This extension wraps [VTSLS](https://github.com/yioneko/vtsls) (a TypeScript language server) with macroforge integration. It provides:
- - Full TypeScript language features
- - Macro expansion at edit time
- - Accurate error positions in original source
- - Completions for macro-generated methods
- ## svelte-macroforge
- This extension provides Svelte support using the **<code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">@macroforge<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">/<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">svelte<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">language<span style="--shiki-dark:#F97583;--shiki-light:#D73A49">-<span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">server</code>. It includes:
- - Svelte component syntax support
- - HTML, CSS, and TypeScript features
- - Macroforge integration in script blocks
- ## Troubleshooting
- ### Extension not loading
- Make sure you've restarted Zed after installing the extension. Check the Zed logs for any error messages.
- ### Macros not expanding
- Ensure your project has the <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">macroforge</code> package installed and a valid <code class="shiki-inline"><span class="line"><span style="--shiki-dark:#E1E4E8;--shiki-light:#24292E">tsconfig.json</code> with the TypeScript plugin configured.
+
+Macroforge provides two extensions for the [Zed editor](https://zed.dev): one for TypeScript via VTSLS, and one for Svelte.
+
+Developer Installation Required
+
+These extensions are not yet in the Zed extension registry. You'll need to install them as developer extensions.
+
+## Available Extensions
+
+| Extension           | Description                                  | Location                              |
+| ------------------- | -------------------------------------------- | ------------------------------------- |
+| `vtsls-macroforge`  | VTSLS with macroforge support for TypeScript | `crates/extensions/vtsls-macroforge`  |
+| `svelte-macroforge` | Svelte language support with macroforge      | `crates/extensions/svelte-macroforge` |
+
+## Installation
+
+### 1\. Clone the Repository
+
+Bash
+
+```
+git clone https://github.com/rymskip/macroforge-ts.git
+cd macroforge-ts
+```
+
+### 2\. Build the Extension
+
+Build the extension you want to use:
+
+Bash
+
+```
+# For VTSLS (TypeScript)
+cd crates/extensions/vtsls-macroforge
+
+# Or for Svelte
+cd crates/extensions/svelte-macroforge
+```
+
+### 3\. Install as Dev Extension in Zed
+
+In Zed, open the command palette and run **zed: install dev extension**, then select the extension directory.
+
+Alternatively, symlink the extension to your Zed extensions directory:
+
+Bash
+
+```
+# macOS
+ln -s /path/to/macroforge-ts/crates/extensions/vtsls-macroforge ~/Library/Application\\ Support/Zed/extensions/installed/vtsls-macroforge
+
+# Linux
+ln -s /path/to/macroforge-ts/crates/extensions/vtsls-macroforge ~/.config/zed/extensions/installed/vtsls-macroforge
+```
+
+## vtsls-macroforge
+
+This extension wraps [VTSLS](https://github.com/yioneko/vtsls) (a TypeScript language server) with macroforge integration. It provides:
+
+*   Full TypeScript language features
+*   Macro expansion at edit time
+*   Accurate error positions in original source
+*   Completions for macro-generated methods
+
+## svelte-macroforge
+
+This extension provides Svelte support using the `@macroforge/svelte-language-server`. It includes:
+
+*   Svelte component syntax support
+*   HTML, CSS, and TypeScript features
+*   Macroforge integration in script blocks
+
+## Troubleshooting
+
+### Extension not loading
+
+Make sure you've restarted Zed after installing the extension. Check the Zed logs for any error messages.
+
+### Macros not expanding
+
+Ensure your project has the `macroforge` package installed and a valid `tsconfig.json` with the TypeScript plugin configured.

package/docs/roadmap/roadmap.md

@@ -1,55 +1,77 @@
 # Roadmap
- *Planned features and improvements for Macroforge. This roadmap reflects our current priorities but may change based on community feedback.*
- ## IDE Extensions
- Bring Macroforge support directly into your favorite editors with native extensions.
- | Extension | Status | Description |
-| --- | --- | --- |
-| VS Code / Cursor | Planned | Native extension with macro expansion preview, error highlighting, and completions |
-| Zed | Available | Full support via vtsls-macroforge and svelte-macroforge extensions |
-| Neovim | Considering | LSP integration for Neovim users |
-| JetBrains (WebStorm) | Considering | Plugin for WebStorm and other JetBrains IDEs |
- ## Framework Support
- Expanding Macroforge to work seamlessly with popular frontend frameworks.
- | Framework | Status | Description |
-| --- | --- | --- |
-| Svelte / SvelteKit | Available | Full support via svelte-language-server and Vite plugin |
-| React | Planned | React-specific macros and integration with React tooling |
-| Vue | Planned | Vue SFC support and Vue-specific derive macros |
-| Angular | Planned | Angular decorator integration and CLI support |
-| Solid | Planned | SolidJS integration |
- ## Pure TypeScript Macro Creation
- While Rust provides the best performance and type safety, we recognize that not everyone wants to write Rust. We're exploring options for writing macros in pure TypeScript.
- | Feature | Status | Description |
-| --- | --- | --- |
+
+Planned features and improvements for Macroforge. This roadmap reflects our current priorities but may change based on community feedback.
+
+## IDE Extensions
+
+Bring Macroforge support directly into your favorite editors with native extensions.
+
+| Extension            | Status      | Description                                                                        |
+| -------------------- | ----------- | ---------------------------------------------------------------------------------- |
+| VS Code / Cursor     | Planned     | Native extension with macro expansion preview, error highlighting, and completions |
+| Zed                  | Available   | Full support via vtsls-macroforge and svelte-macroforge extensions                 |
+| Neovim               | Considering | LSP integration for Neovim users                                                   |
+| JetBrains (WebStorm) | Considering | Plugin for WebStorm and other JetBrains IDEs                                       |
+
+## Framework Support
+
+Expanding Macroforge to work seamlessly with popular frontend frameworks.
+
+| Framework          | Status    | Description                                              |
+| ------------------ | --------- | -------------------------------------------------------- |
+| Svelte / SvelteKit | Available | Full support via svelte-language-server and Vite plugin  |
+| React              | Planned   | React-specific macros and integration with React tooling |
+| Vue                | Planned   | Vue SFC support and Vue-specific derive macros           |
+| Angular            | Planned   | Angular decorator integration and CLI support            |
+| Solid              | Planned   | SolidJS integration                                      |
+
+## Pure TypeScript Macro Creation
+
+While Rust provides the best performance and type safety, we recognize that not everyone wants to write Rust. We're exploring options for writing macros in pure TypeScript.
+
+| Feature              | Status  | Description                                      |
+| -------------------- | ------- | ------------------------------------------------ |
 | TypeScript Macro API | Planned | Define macros using TypeScript with a simple API |
-| Template Strings | Planned | Generate code using tagged template literals |
-| AST Helpers | Planned | TypeScript utilities for working with the AST |
- ## Built-in Macros
- Expanding the library of built-in derive macros.
- | Macro | Status | Description |
-| --- | --- | --- |
-| Debug, Clone, PartialEq, Ord, Hash | Available | Core derive macros |
-| Serialize, Deserialize | Available | JSON serialization with validation |
-| Builder | Planned | Generate builder pattern for classes |
-| Immutable | Considering | Generate immutable update methods (with, set) |
- ## Distribution & Packaging
- Making it easier to publish and share custom macros.
- | Feature | Status | Description |
-| --- | --- | --- |
-| Native Node Binaries | Available | Platform-specific binaries for maximum performance |
-| WASM Binary Generation | Planned | Cross-platform WebAssembly binaries for easier macro distribution |
-| Macro Registry | Considering | Central registry for discovering and sharing community macros |
- ## Tooling & DX
- Improvements to the developer experience.
- | Feature | Status | Description |
-| --- | --- | --- |
-| CLI Expansion | Available | Expand macros from the command line |
-| Macro Playground | Planned | Web-based playground to test macros |
-| create-macroforge | Planned | Scaffolding tool for new macro projects |
-| Macro Debugging | Considering | Step-through debugging for macro expansion |
- ## Contributing
- Interested in helping? We welcome contributions of all kinds:
- - Feature requests and feedback on [GitHub Issues](https://github.com/rymskip/macroforge-ts/issues)
- - Pull requests for new macros or improvements
- - Documentation improvements
- - Framework integrations
+| Template Strings     | Planned | Generate code using tagged template literals     |
+| AST Helpers          | Planned | TypeScript utilities for working with the AST    |
+
+## Built-in Macros
+
+Expanding the library of built-in derive macros.
+
+| Macro                              | Status      | Description                                   |
+| ---------------------------------- | ----------- | --------------------------------------------- |
+| Debug, Clone, PartialEq, Ord, Hash | Available   | Core derive macros                            |
+| Serialize, Deserialize             | Available   | JSON serialization with validation            |
+| Builder                            | Planned     | Generate builder pattern for classes          |
+| Immutable                          | Considering | Generate immutable update methods (with, set) |
+
+## Distribution & Packaging
+
+Making it easier to publish and share custom macros.
+
+| Feature                | Status      | Description                                                       |
+| ---------------------- | ----------- | ----------------------------------------------------------------- |
+| Native Node Binaries   | Available   | Platform-specific binaries for maximum performance                |
+| WASM Binary Generation | Planned     | Cross-platform WebAssembly binaries for easier macro distribution |
+| Macro Registry         | Considering | Central registry for discovering and sharing community macros     |
+
+## Tooling & DX
+
+Improvements to the developer experience.
+
+| Feature           | Status      | Description                                |
+| ----------------- | ----------- | ------------------------------------------ |
+| CLI Expansion     | Available   | Expand macros from the command line        |
+| Macro Playground  | Planned     | Web-based playground to test macros        |
+| create-macroforge | Planned     | Scaffolding tool for new macro projects    |
+| Macro Debugging   | Considering | Step-through debugging for macro expansion |
+
+## Contributing
+
+Interested in helping? We welcome contributions of all kinds:
+
+*   Feature requests and feedback on [GitHub Issues](https://github.com/rymskip/macroforge-ts/issues)
+*   Pull requests for new macros or improvements
+*   Documentation improvements
+*   Framework integrations