API Stability Notice

Macroforge is under active development. The API is not yet stable and may change between versions. Some documentation sections may be outdated.

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.

ExtensionStatusDescription
VS Code / CursorPlannedNative extension with macro expansion preview, error highlighting, and completions
ZedAvailableFull support via vtsls-macroforge and svelte-macroforge extensions
NeovimConsideringLSP integration for Neovim users
JetBrains (WebStorm)ConsideringPlugin for WebStorm and other JetBrains IDEs

Framework Support

Expanding Macroforge to work seamlessly with popular frontend frameworks.

FrameworkStatusDescription
Svelte / SvelteKitAvailableFull support via svelte-language-server and Vite plugin
ReactPlannedReact-specific macros and integration with React tooling
VuePlannedVue SFC support and Vue-specific derive macros
AngularPlannedAngular decorator integration and CLI support
SolidPlannedSolidJS 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.

FeatureStatusDescription
TypeScript Macro APIPlannedDefine macros using TypeScript with a simple API
Template StringsPlannedGenerate code using tagged template literals
AST HelpersPlannedTypeScript utilities for working with the AST

Built-in Macros

Expanding the library of built-in derive macros.

MacroStatusDescription
Debug, Clone, PartialEq, Ord, HashAvailableCore derive macros
Serialize, DeserializeAvailableJSON serialization with validation
BuilderPlannedGenerate builder pattern for classes
ImmutableConsideringGenerate immutable update methods (with, set)

Distribution & Packaging

Making it easier to publish and share custom macros.

FeatureStatusDescription
Native Node BinariesAvailablePlatform-specific binaries for maximum performance
WASM Binary GenerationPlannedCross-platform WebAssembly binaries for easier macro distribution
Macro RegistryConsideringCentral registry for discovering and sharing community macros

Tooling & DX

Improvements to the developer experience.

FeatureStatusDescription
CLI ExpansionAvailableExpand macros from the command line
Macro PlaygroundPlannedWeb-based playground to test macros
create-macroforgePlannedScaffolding tool for new macro projects
Macro DebuggingConsideringStep-through debugging for macro expansion

Contributing

Interested in helping? We welcome contributions of all kinds:

  • Feature requests and feedback on GitHub Issues
  • Pull requests for new macros or improvements
  • Documentation improvements
  • Framework integrations