@macroforge/mcp-server 0.1.49 → 0.1.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  # API Reference
2
2
 
3
- macroforge v0.1.43 33 exported items
3
+ macroforge v0.1.48 33 exported items
4
4
 
5
5
  Macroforge provides a programmatic API for expanding macros in TypeScript code.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # expandSync()
2
2
 
3
- macroforge v0.1.43
3
+ macroforge v0.1.48
4
4
 
5
5
  Synchronously expands macros in TypeScript code. This is the standalone macro expansion function that doesn't use caching. For cached expansion, use \[\`NativePlugin::process\_file\`\] instead.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # NativePlugin
2
2
 
3
- macroforge v0.1.43
3
+ macroforge v0.1.48
4
4
 
5
5
  The main plugin class for macro expansion with caching support. \`NativePlugin\` is designed to be instantiated once and reused across multiple file processing operations. It maintains a cache of expansion results keyed by filepath and version, enabling efficient incremental processing.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # PositionMapper
2
2
 
3
- macroforge v0.1.43
3
+ macroforge v0.1.48
4
4
 
5
5
  Bidirectional position mapper for translating between original and expanded source positions. This mapper enables IDE features like error reporting, go-to-definition, and hover to work correctly with macro-expanded code by translating positions between the original source (what the user wrote) and the expanded source (what the compiler sees).
6
6
 
@@ -1,6 +1,6 @@
1
1
  # transformSync()
2
2
 
3
- macroforge v0.1.43
3
+ macroforge v0.1.48
4
4
 
5
5
  Synchronously transforms TypeScript code through the macro expansion system. This is similar to \[\`expand\_sync\`\] but returns a \[\`TransformResult\`\] which includes source map information (when available).
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Command Line Interface
2
2
 
3
- macroforge v0.1.43
3
+ macroforge v0.1.48
4
4
 
5
5
  This binary provides command-line utilities for working with Macroforge TypeScript macros. It is designed for development workflows, enabling macro expansion and type checking without requiring Node.js integration.
6
6
 
@@ -1,128 +1,4 @@
1
1
  [
2
- {
3
- "id": "installation",
4
- "title": "Installation",
5
- "category": "getting-started",
6
- "category_title": "Getting Started",
7
- "path": "getting-started/getting-started.md",
8
- "use_cases": "setup, install, npm, getting started, quick start, init"
9
- },
10
- {
11
- "id": "first-macro",
12
- "title": "First Macro",
13
- "category": "getting-started",
14
- "category_title": "Getting Started",
15
- "path": "getting-started/first-macro.md",
16
- "use_cases": "tutorial, example, hello world, beginner, learn"
17
- },
18
- {
19
- "id": "how-macros-work",
20
- "title": "How Macros Work",
21
- "category": "concepts",
22
- "category_title": "Core Concepts",
23
- "path": "concepts/concepts.md",
24
- "use_cases": "architecture, overview, understanding, basics, fundamentals"
25
- },
26
- {
27
- "id": "derive-system/overview",
28
- "title": "The Derive System: Overview",
29
- "category": "concepts",
30
- "category_title": "Core Concepts",
31
- "path": "concepts/derive-system/overview.md",
32
- "use_cases": "@derive, decorator, @derive",
33
- "parent_id": "derive-system"
34
- },
35
- {
36
- "id": "derive-system/built-in-vs-custom-macros",
37
- "title": "The Derive System: Built-in vs Custom Macros",
38
- "category": "concepts",
39
- "category_title": "Core Concepts",
40
- "path": "concepts/derive-system/built-in-vs-custom-macros.md",
41
- "use_cases": "@derive, decorator, import macro",
42
- "parent_id": "derive-system"
43
- },
44
- {
45
- "id": "derive-system",
46
- "title": "The Derive System",
47
- "category": "concepts",
48
- "category_title": "Core Concepts",
49
- "path": "concepts/derive-system.md",
50
- "use_cases": "@derive, decorator, annotation, derive macro",
51
- "is_chunked": true,
52
- "chunk_ids": [
53
- "derive-system/overview",
54
- "derive-system/built-in-vs-custom-macros"
55
- ]
56
- },
57
- {
58
- "id": "architecture",
59
- "title": "Architecture",
60
- "category": "concepts",
61
- "category_title": "Core Concepts",
62
- "path": "concepts/architecture.md",
63
- "use_cases": "internals, rust, swc, napi, how it works"
64
- },
65
- {
66
- "id": "macros-overview/overview",
67
- "title": "Overview: Overview",
68
- "category": "builtin-macros",
69
- "category_title": "Built-in Macros",
70
- "path": "builtin-macros/macros-overview/overview.md",
71
- "use_cases": "all macros, list, debug, tostring(): string, clone, clone(): t",
72
- "parent_id": "macros-overview"
73
- },
74
- {
75
- "id": "macros-overview/interface-support",
76
- "title": "Overview: Interface Support",
77
- "category": "builtin-macros",
78
- "category_title": "Built-in Macros",
79
- "path": "builtin-macros/macros-overview/interface-support.md",
80
- "use_cases": "all macros, list, self",
81
- "parent_id": "macros-overview"
82
- },
83
- {
84
- "id": "macros-overview/enum-support",
85
- "title": "Overview: Enum Support",
86
- "category": "builtin-macros",
87
- "category_title": "Built-in Macros",
88
- "path": "builtin-macros/macros-overview/enum-support.md",
89
- "use_cases": "all macros, list",
90
- "parent_id": "macros-overview"
91
- },
92
- {
93
- "id": "macros-overview/type-alias-support",
94
- "title": "Overview: Type Alias Support",
95
- "category": "builtin-macros",
96
- "category_title": "Built-in Macros",
97
- "path": "builtin-macros/macros-overview/type-alias-support.md",
98
- "use_cases": "all macros, list",
99
- "parent_id": "macros-overview"
100
- },
101
- {
102
- "id": "macros-overview/detailed-documentation",
103
- "title": "Overview: Detailed Documentation",
104
- "category": "builtin-macros",
105
- "category_title": "Built-in Macros",
106
- "path": "builtin-macros/macros-overview/detailed-documentation.md",
107
- "use_cases": "all macros, list",
108
- "parent_id": "macros-overview"
109
- },
110
- {
111
- "id": "macros-overview",
112
- "title": "Overview",
113
- "category": "builtin-macros",
114
- "category_title": "Built-in Macros",
115
- "path": "builtin-macros/macros-overview.md",
116
- "use_cases": "all macros, list, available macros, macro list",
117
- "is_chunked": true,
118
- "chunk_ids": [
119
- "macros-overview/overview",
120
- "macros-overview/interface-support",
121
- "macros-overview/enum-support",
122
- "macros-overview/type-alias-support",
123
- "macros-overview/detailed-documentation"
124
- ]
125
- },
126
2
  {
127
3
  "id": "debug",
128
4
  "title": "Debug",
@@ -247,411 +123,5 @@
247
123
  "deserialize/union-type-deserialization",
248
124
  "deserialize/example"
249
125
  ]
250
- },
251
- {
252
- "id": "custom-overview",
253
- "title": "Overview",
254
- "category": "custom-macros",
255
- "category_title": "Custom Macros",
256
- "path": "custom-macros/custom-macros.md",
257
- "use_cases": "custom, extending, creating macros, own macro"
258
- },
259
- {
260
- "id": "rust-setup",
261
- "title": "Rust Setup",
262
- "category": "custom-macros",
263
- "category_title": "Custom Macros",
264
- "path": "custom-macros/rust-setup.md",
265
- "use_cases": "rust, cargo, napi, compilation, building"
266
- },
267
- {
268
- "id": "ts-macro-derive/overview",
269
- "title": "#[ts_macro_derive]: Overview",
270
- "category": "custom-macros",
271
- "category_title": "Custom Macros",
272
- "path": "custom-macros/ts-macro-derive/overview.md",
273
- "use_cases": "attribute, proc macro, #[ts_macro_derive]",
274
- "parent_id": "ts-macro-derive"
275
- },
276
- {
277
- "id": "ts-macro-derive/attribute-options",
278
- "title": "#[ts_macro_derive]: Attribute Options",
279
- "category": "custom-macros",
280
- "category_title": "Custom Macros",
281
- "path": "custom-macros/ts-macro-derive/attribute-options.md",
282
- "use_cases": "attribute, proc macro, @derive()",
283
- "parent_id": "ts-macro-derive"
284
- },
285
- {
286
- "id": "ts-macro-derive/function-signature",
287
- "title": "#[ts_macro_derive]: Function Signature",
288
- "category": "custom-macros",
289
- "category_title": "Custom Macros",
290
- "path": "custom-macros/ts-macro-derive/function-signature.md",
291
- "use_cases": "attribute, proc macro",
292
- "parent_id": "ts-macro-derive"
293
- },
294
- {
295
- "id": "ts-macro-derive/parsing-input",
296
- "title": "#[ts_macro_derive]: Parsing Input",
297
- "category": "custom-macros",
298
- "category_title": "Custom Macros",
299
- "path": "custom-macros/ts-macro-derive/parsing-input.md",
300
- "use_cases": "attribute, proc macro, parse_ts_macro_input!",
301
- "parent_id": "ts-macro-derive"
302
- },
303
- {
304
- "id": "ts-macro-derive/deriveinput-structure",
305
- "title": "#[ts_macro_derive]: DeriveInput Structure",
306
- "category": "custom-macros",
307
- "category_title": "Custom Macros",
308
- "path": "custom-macros/ts-macro-derive/deriveinput-structure.md",
309
- "use_cases": "attribute, proc macro",
310
- "parent_id": "ts-macro-derive"
311
- },
312
- {
313
- "id": "ts-macro-derive/accessing-field-data",
314
- "title": "#[ts_macro_derive]: Accessing Field Data",
315
- "category": "custom-macros",
316
- "category_title": "Custom Macros",
317
- "path": "custom-macros/ts-macro-derive/accessing-field-data.md",
318
- "use_cases": "attribute, proc macro",
319
- "parent_id": "ts-macro-derive"
320
- },
321
- {
322
- "id": "ts-macro-derive/adding-imports",
323
- "title": "#[ts_macro_derive]: Adding Imports",
324
- "category": "custom-macros",
325
- "category_title": "Custom Macros",
326
- "path": "custom-macros/ts-macro-derive/adding-imports.md",
327
- "use_cases": "attribute, proc macro, add_import, tsstream",
328
- "parent_id": "ts-macro-derive"
329
- },
330
- {
331
- "id": "ts-macro-derive/returning-errors",
332
- "title": "#[ts_macro_derive]: Returning Errors",
333
- "category": "custom-macros",
334
- "category_title": "Custom Macros",
335
- "path": "custom-macros/ts-macro-derive/returning-errors.md",
336
- "use_cases": "attribute, proc macro, macroforgeerror",
337
- "parent_id": "ts-macro-derive"
338
- },
339
- {
340
- "id": "ts-macro-derive/complete-example",
341
- "title": "#[ts_macro_derive]: Complete Example",
342
- "category": "custom-macros",
343
- "category_title": "Custom Macros",
344
- "path": "custom-macros/ts-macro-derive/complete-example.md",
345
- "use_cases": "attribute, proc macro",
346
- "parent_id": "ts-macro-derive"
347
- },
348
- {
349
- "id": "ts-macro-derive",
350
- "title": "#[ts_macro_derive]",
351
- "category": "custom-macros",
352
- "category_title": "Custom Macros",
353
- "path": "custom-macros/ts-macro-derive.md",
354
- "use_cases": "attribute, proc macro, derive attribute, rust macro",
355
- "is_chunked": true,
356
- "chunk_ids": [
357
- "ts-macro-derive/overview",
358
- "ts-macro-derive/attribute-options",
359
- "ts-macro-derive/function-signature",
360
- "ts-macro-derive/parsing-input",
361
- "ts-macro-derive/deriveinput-structure",
362
- "ts-macro-derive/accessing-field-data",
363
- "ts-macro-derive/adding-imports",
364
- "ts-macro-derive/returning-errors",
365
- "ts-macro-derive/complete-example"
366
- ]
367
- },
368
- {
369
- "id": "ts-quote/overview",
370
- "title": "Template Syntax: Overview",
371
- "category": "custom-macros",
372
- "category_title": "Custom Macros",
373
- "path": "custom-macros/ts-quote/overview.md",
374
- "use_cases": "ts_quote, template, macroforge_ts_quote, ts_template!, body!",
375
- "parent_id": "ts-quote"
376
- },
377
- {
378
- "id": "ts-quote/quick-reference",
379
- "title": "Template Syntax: Quick Reference",
380
- "category": "custom-macros",
381
- "category_title": "Custom Macros",
382
- "path": "custom-macros/ts-quote/quick-reference.md",
383
- "use_cases": "ts_quote, template, @{expr}, {| content |}, {|get@{name}|}, getuser",
384
- "parent_id": "ts-quote"
385
- },
386
- {
387
- "id": "ts-quote/identifier-concatenation-content",
388
- "title": "Template Syntax: Identifier Concatenation: `{| content |}`",
389
- "category": "custom-macros",
390
- "category_title": "Custom Macros",
391
- "path": "custom-macros/ts-quote/identifier-concatenation-content.md",
392
- "use_cases": "ts_quote, template, {| content |}, getuser, setname, {| |}",
393
- "parent_id": "ts-quote"
394
- },
395
- {
396
- "id": "ts-quote/comments-and",
397
- "title": "Template Syntax: Comments: `{> \"...\" <}` and `{>> \"...\" <<}`",
398
- "category": "custom-macros",
399
- "category_title": "Custom Macros",
400
- "path": "custom-macros/ts-quote/comments-and.md",
401
- "use_cases": "ts_quote, template, {> \"...\" <}, {>> \"...\" <<}, {> \"comment\" <}",
402
- "parent_id": "ts-quote"
403
- },
404
- {
405
- "id": "ts-quote/string-interpolation-textexpr",
406
- "title": "Template Syntax: String Interpolation: `\"text @{expr}\"`",
407
- "category": "custom-macros",
408
- "category_title": "Custom Macros",
409
- "path": "custom-macros/ts-quote/string-interpolation-textexpr.md",
410
- "use_cases": "ts_quote, template, \"text @{expr}\", format!()",
411
- "parent_id": "ts-quote"
412
- },
413
- {
414
- "id": "ts-quote/backtick-template-literals",
415
- "title": "Template Syntax: Backtick Template Literals: `\"'^...^'\"`",
416
- "category": "custom-macros",
417
- "category_title": "Custom Macros",
418
- "path": "custom-macros/ts-quote/backtick-template-literals.md",
419
- "use_cases": "ts_quote, template, \"'^...^'\", '^...^', ${\"${}\"}",
420
- "parent_id": "ts-quote"
421
- },
422
- {
423
- "id": "ts-quote/conditionals-ifif",
424
- "title": "Template Syntax: Conditionals: `{#if}...{/if}`",
425
- "category": "custom-macros",
426
- "category_title": "Custom Macros",
427
- "path": "custom-macros/ts-quote/conditionals-ifif.md",
428
- "use_cases": "ts_quote, template, {#if}...{/if}",
429
- "parent_id": "ts-quote"
430
- },
431
- {
432
- "id": "ts-quote/pattern-matching-iflet",
433
- "title": "Template Syntax: Pattern Matching: `{#if let}`",
434
- "category": "custom-macros",
435
- "category_title": "Custom Macros",
436
- "path": "custom-macros/ts-quote/pattern-matching-iflet.md",
437
- "use_cases": "ts_quote, template, {#if let}, if let, option, result",
438
- "parent_id": "ts-quote"
439
- },
440
- {
441
- "id": "ts-quote/match-expressions-match",
442
- "title": "Template Syntax: Match Expressions: `{#match}`",
443
- "category": "custom-macros",
444
- "category_title": "Custom Macros",
445
- "path": "custom-macros/ts-quote/match-expressions-match.md",
446
- "use_cases": "ts_quote, template, {#match}, match, \npublic field: string;\n",
447
- "parent_id": "ts-quote"
448
- },
449
- {
450
- "id": "ts-quote/iteration-for",
451
- "title": "Template Syntax: Iteration: `{#for}`",
452
- "category": "custom-macros",
453
- "category_title": "Custom Macros",
454
- "path": "custom-macros/ts-quote/iteration-for.md",
455
- "use_cases": "ts_quote, template, {#for}",
456
- "parent_id": "ts-quote"
457
- },
458
- {
459
- "id": "ts-quote/while-loops-while",
460
- "title": "Template Syntax: While Loops: `{#while}`",
461
- "category": "custom-macros",
462
- "category_title": "Custom Macros",
463
- "path": "custom-macros/ts-quote/while-loops-while.md",
464
- "use_cases": "ts_quote, template, {#while}, while",
465
- "parent_id": "ts-quote"
466
- },
467
- {
468
- "id": "ts-quote/local-constants-let",
469
- "title": "Template Syntax: Local Constants: `{$let}`",
470
- "category": "custom-macros",
471
- "category_title": "Custom Macros",
472
- "path": "custom-macros/ts-quote/local-constants-let.md",
473
- "use_cases": "ts_quote, template, {$let}",
474
- "parent_id": "ts-quote"
475
- },
476
- {
477
- "id": "ts-quote/side-effects-do",
478
- "title": "Template Syntax: Side Effects: `{$do}`",
479
- "category": "custom-macros",
480
- "category_title": "Custom Macros",
481
- "path": "custom-macros/ts-quote/side-effects-do.md",
482
- "use_cases": "ts_quote, template, {$do}",
483
- "parent_id": "ts-quote"
484
- },
485
- {
486
- "id": "ts-quote/tsstream-injection-typescript",
487
- "title": "Template Syntax: TsStream Injection: `{$typescript}`",
488
- "category": "custom-macros",
489
- "category_title": "Custom Macros",
490
- "path": "custom-macros/ts-quote/tsstream-injection-typescript.md",
491
- "use_cases": "ts_quote, template, {$typescript}, add_import()",
492
- "parent_id": "ts-quote"
493
- },
494
- {
495
- "id": "ts-quote/complete-example-json-derive-macro",
496
- "title": "Template Syntax: Complete Example: JSON Derive Macro",
497
- "category": "custom-macros",
498
- "category_title": "Custom Macros",
499
- "path": "custom-macros/ts-quote/complete-example-json-derive-macro.md",
500
- "use_cases": "ts_quote, template, ts_template!",
501
- "parent_id": "ts-quote"
502
- },
503
- {
504
- "id": "ts-quote",
505
- "title": "Template Syntax",
506
- "category": "custom-macros",
507
- "category_title": "Custom Macros",
508
- "path": "custom-macros/ts-quote.md",
509
- "use_cases": "ts_quote, template, code generation, interpolation",
510
- "is_chunked": true,
511
- "chunk_ids": [
512
- "ts-quote/overview",
513
- "ts-quote/quick-reference",
514
- "ts-quote/identifier-concatenation-content",
515
- "ts-quote/comments-and",
516
- "ts-quote/string-interpolation-textexpr",
517
- "ts-quote/backtick-template-literals",
518
- "ts-quote/conditionals-ifif",
519
- "ts-quote/pattern-matching-iflet",
520
- "ts-quote/match-expressions-match",
521
- "ts-quote/iteration-for",
522
- "ts-quote/while-loops-while",
523
- "ts-quote/local-constants-let",
524
- "ts-quote/side-effects-do",
525
- "ts-quote/tsstream-injection-typescript",
526
- "ts-quote/complete-example-json-derive-macro"
527
- ]
528
- },
529
- {
530
- "id": "integration-overview",
531
- "title": "Overview",
532
- "category": "integration",
533
- "category_title": "Integration",
534
- "path": "integration/integration.md",
535
- "use_cases": "setup, integration, tools, ecosystem"
536
- },
537
- {
538
- "id": "cli",
539
- "title": "CLI",
540
- "category": "integration",
541
- "category_title": "Integration",
542
- "path": "integration/cli.md",
543
- "use_cases": "command line, macroforge command, expand, terminal"
544
- },
545
- {
546
- "id": "typescript-plugin",
547
- "title": "TypeScript Plugin",
548
- "category": "integration",
549
- "category_title": "Integration",
550
- "path": "integration/typescript-plugin.md",
551
- "use_cases": "vscode, ide, language server, intellisense, autocomplete"
552
- },
553
- {
554
- "id": "vite-plugin",
555
- "title": "Vite Plugin",
556
- "category": "integration",
557
- "category_title": "Integration",
558
- "path": "integration/vite-plugin.md",
559
- "use_cases": "vite, build, bundler, react, svelte, sveltekit"
560
- },
561
- {
562
- "id": "svelte-preprocessor",
563
- "title": "Svelte Preprocessor",
564
- "category": "integration",
565
- "category_title": "Integration",
566
- "path": "integration/svelte-preprocessor.md",
567
- "use_cases": "svelte, preprocessor, svelte components, .svelte files, sveltekit"
568
- },
569
- {
570
- "id": "mcp-server",
571
- "title": "MCP Server",
572
- "category": "integration",
573
- "category_title": "Integration",
574
- "path": "integration/mcp-server.md",
575
- "use_cases": "mcp, ai, claude, llm, model context protocol, assistant"
576
- },
577
- {
578
- "id": "configuration",
579
- "title": "Configuration",
580
- "category": "integration",
581
- "category_title": "Integration",
582
- "path": "integration/configuration.md",
583
- "use_cases": "macroforge.json, config, settings, options"
584
- },
585
- {
586
- "id": "ls-overview",
587
- "title": "Overview",
588
- "category": "language-servers",
589
- "category_title": "Language Servers",
590
- "path": "language-servers/language-servers.md",
591
- "use_cases": "lsp, language server, editor support"
592
- },
593
- {
594
- "id": "svelte",
595
- "title": "Svelte",
596
- "category": "language-servers",
597
- "category_title": "Language Servers",
598
- "path": "language-servers/svelte.md",
599
- "use_cases": "svelte, svelte language server, .svelte files"
600
- },
601
- {
602
- "id": "zed",
603
- "title": "Zed Extensions",
604
- "category": "language-servers",
605
- "category_title": "Language Servers",
606
- "path": "language-servers/zed.md",
607
- "use_cases": "zed, zed editor, extension"
608
- },
609
- {
610
- "id": "api-overview",
611
- "title": "Overview",
612
- "category": "api",
613
- "category_title": "API Reference",
614
- "path": "api/api.md",
615
- "use_cases": "api, functions, exports, programmatic"
616
- },
617
- {
618
- "id": "expand-sync",
619
- "title": "expandSync()",
620
- "category": "api",
621
- "category_title": "API Reference",
622
- "path": "api/expand-sync.md",
623
- "use_cases": "expandSync, expand, transform, macro expansion"
624
- },
625
- {
626
- "id": "transform-sync",
627
- "title": "transformSync()",
628
- "category": "api",
629
- "category_title": "API Reference",
630
- "path": "api/transform-sync.md",
631
- "use_cases": "transformSync, transform, metadata, low-level"
632
- },
633
- {
634
- "id": "native-plugin",
635
- "title": "NativePlugin",
636
- "category": "api",
637
- "category_title": "API Reference",
638
- "path": "api/native-plugin.md",
639
- "use_cases": "NativePlugin, caching, language server, stateful"
640
- },
641
- {
642
- "id": "position-mapper",
643
- "title": "PositionMapper",
644
- "category": "api",
645
- "category_title": "API Reference",
646
- "path": "api/position-mapper.md",
647
- "use_cases": "PositionMapper, source map, diagnostics, position"
648
- },
649
- {
650
- "id": "roadmap",
651
- "title": "Roadmap",
652
- "category": "roadmap",
653
- "category_title": "Roadmap",
654
- "path": "roadmap/roadmap.md",
655
- "use_cases": "roadmap, future, planned features, upcoming"
656
126
  }
657
127
  ]
package/package.json CHANGED
@@ -25,7 +25,7 @@
25
25
  "main": "dist/index.js",
26
26
  "name": "@macroforge/mcp-server",
27
27
  "peerDependencies": {
28
- "macroforge": "^0.1.48"
28
+ "macroforge": "^0.1.53"
29
29
  },
30
30
  "peerDependenciesMeta": {
31
31
  "macroforge": {
@@ -46,5 +46,5 @@
46
46
  "test": "node --test tests/**/*.test.js"
47
47
  },
48
48
  "type": "module",
49
- "version": "0.1.49"
49
+ "version": "0.1.53"
50
50
  }