TypeScript language service plugin that augments classes decorated with @derive to include macro-generated methods.
npm install @macroforge/typescript-pluginTypeScript language service plugin that augments classes decorated with @derive to include
macro-generated methods.
TypeScript Language Service Plugin for Macroforge
This plugin integrates Macroforge's compile-time macro expansion with TypeScript's Language Service
to provide seamless IDE support for macro-decorated classes.
The plugin operates by intercepting TypeScript's Language Service methods and transforming source
code on-the-fly:
1. Macro Expansion: When TypeScript requests a file's content via getScriptSnapshot, this
plugin intercepts the call and returns the macro-expanded version instead.
2. Position Mapping: Since expanded code has different positions than the original, the plugin
maintains a {@link PositionMapper} for each file to translate positions between original and
expanded coordinates.
3. Virtual .d.ts Files: For each macro-containing file, the plugin generates a companion
.macroforge.d.ts file containing type declarations for generated methods.
- .ts - TypeScript files
- .tsx - TypeScript JSX files
- .svelte - Svelte components (with