@macroforge/typescript-plugin 0.1.64 → 0.1.67

package/README.md

@@ -1,6 +1,7 @@
 # @macroforge/typescript-plugin
 
-TypeScript language service plugin that augments classes decorated with @derive to include macro-generated methods.
+TypeScript language service plugin that augments classes decorated with @derive to include
+macro-generated methods.
 
 [![npm version](https://badge.fury.io/js/%40macroforge%2Ftypescript-plugin.svg)](https://www.npmjs.com/package/@macroforge/typescript-plugin)
 
@@ -8,23 +9,23 @@ TypeScript language service plugin that augments classes decorated with @derive
 
 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.
+This plugin integrates Macroforge's compile-time macro expansion with TypeScript's Language Service
+to provide seamless IDE support for macro-decorated classes.
 
 ## Architecture Overview
 
-The plugin operates by intercepting TypeScript's Language Service methods and
-transforming source code on-the-fly:
+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.
+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.
+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.
+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.
 
 ## Supported File Types
 
@@ -41,6 +42,7 @@ The plugin hooks into three categories of Language Service methods:
 - **Navigation hooks**: Handle go-to-definition, references, completions, etc.
 
 @example
+
 ```typescript
 {
 "compilerOptions": {
@@ -59,15 +61,19 @@ npm install @macroforge/typescript-plugin
 
 ### Functions
 
-- **`parseMacroImportComments`** - Parses macro import comments to extract macro name to module path mappings.
+- **`parseMacroImportComments`** - Parses macro import comments to extract macro name to module path
+  mappings.
 - **`getExternalManifest`** - Attempts to load the manifest from an external macro package.
 - **`getExternalMacroInfo`** - Looks up macro info from an external package manifest.
 - **`getExternalDecoratorInfo`** - Looks up decorator info from an external package manifest.
-- **`findDeriveAtPosition`** - Finds a macro name within `@derive(...)` decorators at a given cursor position.
+- **`findDeriveAtPosition`** - Finds a macro name within `@derive(...)` decorators at a given cursor
+  position.
 - **`findDeriveKeywordAtPosition`** - Finds the `@derive` keyword at a given cursor position.
-- **`findDecoratorAtPosition`** - Finds a field decorator (like `@serde` or `@debug`) at a given cursor position.
+- **`findDecoratorAtPosition`** - Finds a field decorator (like `@serde` or `@debug`) at a given
+  cursor position.
 - **`findEnclosingDeriveContext`** - const lastCommentEnd = beforeMatch.lastIndexOf("*/
-- **`getMacroHoverInfo`** - Generates hover information (QuickInfo) for macros and decorators at a cursor position.
+- **`getMacroHoverInfo`** - Generates hover information (QuickInfo) for macros and decorators at a
+  cursor position.
 - **`shouldProcess`** - Determines whether a file should be processed for macro expansion.
 - ... and 7 more
 
@@ -87,7 +93,8 @@ npm install @macroforge/typescript-plugin
 
 ## Documentation
 
-See the [full documentation](https://macroforge.dev/docs/api/reference/typescript/typescript-plugin) on the Macroforge website.
+See the [full documentation](https://macroforge.dev/docs/api/reference/typescript/typescript-plugin)
+on the Macroforge website.
 
 ## License
 

package/dist/index.d.ts

@@ -13,7 +13,7 @@
  *    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
+ *    the plugin maintains a 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
@@ -44,10 +44,10 @@
  * ```
  *
  * @see {@link init} - The main plugin factory function
- * @see {@link PositionMapper} - Position mapping between original and expanded code
+ * @see PositionMapper from macroforge - Position mapping between original and expanded code
  * @module @macroforge/typescript-plugin
  */
-import type ts from "typescript/lib/tsserverlibrary";
+import type ts from 'typescript/lib/tsserverlibrary';
 /**
  * Main plugin factory function conforming to the TypeScript Language Service Plugin API.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAqqBrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,iBAAS,IAAI,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,OAAO,EAAE,CAAA;CAAE;mBAcxB,EAAE,CAAC,MAAM,CAAC,gBAAgB;EAm/DjD;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,MAAM,gCAAgC,CAAC;AA0qBrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,iBAAS,IAAI,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,OAAO,EAAE,CAAA;CAAE;mBActB,EAAE,CAAC,MAAM,CAAC,gBAAgB;EAyhEnD;AAED,eAAe,IAAI,CAAC"}