@macroforge/mcp-server 0.1.33 → 0.1.35

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

@@ -1,47 +1,23 @@
 # Language Servers
-
-*Macroforge provides language server integrations for enhanced IDE support beyond the TypeScript plugin.*
-
-<Alert type="warning" title="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.
-</Alert>
-
-## Overview
-
-While the [TypeScript Plugin]({base}/docs/integration/typescript-plugin) provides macro support in any TypeScript-aware editor, dedicated language servers offer deeper integration for specific frameworks and editors.
-
-| [Svelte Language Server]({base}/docs/language-servers/svelte) 
-| Full Svelte support with macroforge 
-| Working (dev install) 
-
-| [Zed Extensions]({base}/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]({base}/docs/language-servers/svelte) - Full Svelte IDE support
-
-- [Zed Extensions]({base}/docs/language-servers/zed) - VTSLS and Svelte for Zed
+ *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
+**

package/docs/language-servers/svelte.md

@@ -1,80 +1,41 @@
 # Svelte Language Server
-
-*`@macroforge/svelte-language-server` provides full Svelte IDE support with macroforge integration.*
-
-<Alert type="warning" title="Developer Installation Required">
-This package is not yet published as an official extension. You'll need to build and install it manually.
-</Alert>
-
-## 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
+ *`@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
+ ```
 git clone https://github.com/rymskip/macroforge-ts.git
 cd macroforge-ts
-```
-
-### 2. Build the Language Server
-
-```bash
+``` ### 2. Build the Language Server
+ ```
 # 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
+``` ### 3. Configure Your Editor
+ The language server exposes a `svelteserver` binary that implements the Language Server Protocol (LSP). Configure your editor to use it:
+ ```
 # 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 `.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]({base}/docs/language-servers/zed) page for the dedicated `svelte-macroforge` 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,84 +1,46 @@
 # Zed Extensions
-
-*Macroforge provides two extensions for the [Zed editor](https://zed.dev): one for TypeScript via VTSLS, and one for Svelte.*
-
-<Alert type="warning" title="Developer Installation Required">
-These extensions are not yet in the Zed extension registry. You'll need to install them as developer extensions.
-</Alert>
-
-## Available Extensions
-
-| `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
+ *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:
-
-```bash
+``` ### 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:
-
-```bash
+``` ### 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
+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.
+``` ## 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,131 +1,55 @@
 # 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.
-
-| 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.
-
-| 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.
-
-| 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.
-
-| 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.
-
-| 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.
-
-| 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
+ *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