@macroforge/mcp-server 0.1.40 → 0.1.49

package/docs/sections.json

@@ -4,7 +4,7 @@
     "title": "Installation",
     "category": "getting-started",
     "category_title": "Getting Started",
-    "path": "getting-started/installation.md",
+    "path": "getting-started/getting-started.md",
     "use_cases": "setup, install, npm, getting started, quick start, init"
   },
   {
@@ -20,16 +20,39 @@
     "title": "How Macros Work",
     "category": "concepts",
     "category_title": "Core Concepts",
-    "path": "concepts/how-macros-work.md",
+    "path": "concepts/concepts.md",
     "use_cases": "architecture, overview, understanding, basics, fundamentals"
   },
+  {
+    "id": "derive-system/overview",
+    "title": "The Derive System: Overview",
+    "category": "concepts",
+    "category_title": "Core Concepts",
+    "path": "concepts/derive-system/overview.md",
+    "use_cases": "@derive, decorator, @derive",
+    "parent_id": "derive-system"
+  },
+  {
+    "id": "derive-system/built-in-vs-custom-macros",
+    "title": "The Derive System: Built-in vs Custom Macros",
+    "category": "concepts",
+    "category_title": "Core Concepts",
+    "path": "concepts/derive-system/built-in-vs-custom-macros.md",
+    "use_cases": "@derive, decorator, import macro",
+    "parent_id": "derive-system"
+  },
   {
     "id": "derive-system",
     "title": "The Derive System",
     "category": "concepts",
     "category_title": "Core Concepts",
     "path": "concepts/derive-system.md",
-    "use_cases": "@derive, decorator, annotation, derive macro"
+    "use_cases": "@derive, decorator, annotation, derive macro",
+    "is_chunked": true,
+    "chunk_ids": [
+      "derive-system/overview",
+      "derive-system/built-in-vs-custom-macros"
+    ]
   },
   {
     "id": "architecture",
@@ -39,13 +62,66 @@
     "path": "concepts/architecture.md",
     "use_cases": "internals, rust, swc, napi, how it works"
   },
+  {
+    "id": "macros-overview/overview",
+    "title": "Overview: Overview",
+    "category": "builtin-macros",
+    "category_title": "Built-in Macros",
+    "path": "builtin-macros/macros-overview/overview.md",
+    "use_cases": "all macros, list, debug, tostring(): string, clone, clone(): t",
+    "parent_id": "macros-overview"
+  },
+  {
+    "id": "macros-overview/interface-support",
+    "title": "Overview: Interface Support",
+    "category": "builtin-macros",
+    "category_title": "Built-in Macros",
+    "path": "builtin-macros/macros-overview/interface-support.md",
+    "use_cases": "all macros, list, self",
+    "parent_id": "macros-overview"
+  },
+  {
+    "id": "macros-overview/enum-support",
+    "title": "Overview: Enum Support",
+    "category": "builtin-macros",
+    "category_title": "Built-in Macros",
+    "path": "builtin-macros/macros-overview/enum-support.md",
+    "use_cases": "all macros, list",
+    "parent_id": "macros-overview"
+  },
+  {
+    "id": "macros-overview/type-alias-support",
+    "title": "Overview: Type Alias Support",
+    "category": "builtin-macros",
+    "category_title": "Built-in Macros",
+    "path": "builtin-macros/macros-overview/type-alias-support.md",
+    "use_cases": "all macros, list",
+    "parent_id": "macros-overview"
+  },
+  {
+    "id": "macros-overview/detailed-documentation",
+    "title": "Overview: Detailed Documentation",
+    "category": "builtin-macros",
+    "category_title": "Built-in Macros",
+    "path": "builtin-macros/macros-overview/detailed-documentation.md",
+    "use_cases": "all macros, list",
+    "parent_id": "macros-overview"
+  },
   {
     "id": "macros-overview",
     "title": "Overview",
     "category": "builtin-macros",
     "category_title": "Built-in Macros",
     "path": "builtin-macros/macros-overview.md",
-    "use_cases": "all macros, list, available macros, macro list"
+    "use_cases": "all macros, list, available macros, macro list",
+    "is_chunked": true,
+    "chunk_ids": [
+      "macros-overview/overview",
+      "macros-overview/interface-support",
+      "macros-overview/enum-support",
+      "macros-overview/type-alias-support",
+      "macros-overview/detailed-documentation"
+    ]
   },
   {
     "id": "debug",
@@ -103,46 +179,13 @@
     "path": "builtin-macros/partial-ord.md",
     "use_cases": "compareTo, partial ordering, sorting, nullable comparison"
   },
-  {
-    "id": "serialize/overview",
-    "title": "Serialize: Overview",
-    "category": "builtin-macros",
-    "category_title": "Built-in Macros",
-    "path": "builtin-macros/serialize/overview.md",
-    "use_cases": "toJSON, serialization, serialize, classnameserialize(value), enumnameserialize(value), enumnameserializewithcontext",
-    "parent_id": "serialize"
-  },
-  {
-    "id": "serialize/type-specific-serialization",
-    "title": "Serialize: Type-Specific Serialization",
-    "category": "builtin-macros",
-    "category_title": "Built-in Macros",
-    "path": "builtin-macros/serialize/type-specific-serialization.md",
-    "use_cases": "toJSON, serialization, date, toisostring(), serializewithcontext(ctx)",
-    "parent_id": "serialize"
-  },
-  {
-    "id": "serialize/example",
-    "title": "Serialize: Example",
-    "category": "builtin-macros",
-    "category_title": "Built-in Macros",
-    "path": "builtin-macros/serialize/example.md",
-    "use_cases": "toJSON, serialization",
-    "parent_id": "serialize"
-  },
   {
     "id": "serialize",
     "title": "Serialize",
     "category": "builtin-macros",
     "category_title": "Built-in Macros",
     "path": "builtin-macros/serialize.md",
-    "use_cases": "toJSON, serialization, json, api, data transfer",
-    "is_chunked": true,
-    "chunk_ids": [
-      "serialize/overview",
-      "serialize/type-specific-serialization",
-      "serialize/example"
-    ]
+    "use_cases": "toJSON, serialization, json, api, data transfer"
   },
   {
     "id": "deserialize/overview",
@@ -210,7 +253,7 @@
     "title": "Overview",
     "category": "custom-macros",
     "category_title": "Custom Macros",
-    "path": "custom-macros/custom-overview.md",
+    "path": "custom-macros/custom-macros.md",
     "use_cases": "custom, extending, creating macros, own macro"
   },
   {
@@ -221,13 +264,241 @@
     "path": "custom-macros/rust-setup.md",
     "use_cases": "rust, cargo, napi, compilation, building"
   },
+  {
+    "id": "ts-macro-derive/overview",
+    "title": "#[ts_macro_derive]: Overview",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/overview.md",
+    "use_cases": "attribute, proc macro, #[ts_macro_derive]",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/attribute-options",
+    "title": "#[ts_macro_derive]: Attribute Options",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/attribute-options.md",
+    "use_cases": "attribute, proc macro, @derive()",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/function-signature",
+    "title": "#[ts_macro_derive]: Function Signature",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/function-signature.md",
+    "use_cases": "attribute, proc macro",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/parsing-input",
+    "title": "#[ts_macro_derive]: Parsing Input",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/parsing-input.md",
+    "use_cases": "attribute, proc macro, parse_ts_macro_input!",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/deriveinput-structure",
+    "title": "#[ts_macro_derive]: DeriveInput Structure",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/deriveinput-structure.md",
+    "use_cases": "attribute, proc macro",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/accessing-field-data",
+    "title": "#[ts_macro_derive]: Accessing Field Data",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/accessing-field-data.md",
+    "use_cases": "attribute, proc macro",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/adding-imports",
+    "title": "#[ts_macro_derive]: Adding Imports",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/adding-imports.md",
+    "use_cases": "attribute, proc macro, add_import, tsstream",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/returning-errors",
+    "title": "#[ts_macro_derive]: Returning Errors",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/returning-errors.md",
+    "use_cases": "attribute, proc macro, macroforgeerror",
+    "parent_id": "ts-macro-derive"
+  },
+  {
+    "id": "ts-macro-derive/complete-example",
+    "title": "#[ts_macro_derive]: Complete Example",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-macro-derive/complete-example.md",
+    "use_cases": "attribute, proc macro",
+    "parent_id": "ts-macro-derive"
+  },
   {
     "id": "ts-macro-derive",
     "title": "#[ts_macro_derive]",
     "category": "custom-macros",
     "category_title": "Custom Macros",
     "path": "custom-macros/ts-macro-derive.md",
-    "use_cases": "attribute, proc macro, derive attribute, rust macro"
+    "use_cases": "attribute, proc macro, derive attribute, rust macro",
+    "is_chunked": true,
+    "chunk_ids": [
+      "ts-macro-derive/overview",
+      "ts-macro-derive/attribute-options",
+      "ts-macro-derive/function-signature",
+      "ts-macro-derive/parsing-input",
+      "ts-macro-derive/deriveinput-structure",
+      "ts-macro-derive/accessing-field-data",
+      "ts-macro-derive/adding-imports",
+      "ts-macro-derive/returning-errors",
+      "ts-macro-derive/complete-example"
+    ]
+  },
+  {
+    "id": "ts-quote/overview",
+    "title": "Template Syntax: Overview",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/overview.md",
+    "use_cases": "ts_quote, template, macroforge_ts_quote, ts_template!, body!",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/quick-reference",
+    "title": "Template Syntax: Quick Reference",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/quick-reference.md",
+    "use_cases": "ts_quote, template, @{expr}, {| content |}, {|get@{name}|}, getuser",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/identifier-concatenation-content",
+    "title": "Template Syntax: Identifier Concatenation: `{| content |}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/identifier-concatenation-content.md",
+    "use_cases": "ts_quote, template, {| content |}, getuser, setname, {| |}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/comments-and",
+    "title": "Template Syntax: Comments: `{> \"...\" <}` and `{>> \"...\" <<}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/comments-and.md",
+    "use_cases": "ts_quote, template, {> \"...\" <}, {>> \"...\" <<}, {> \"comment\" <}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/string-interpolation-textexpr",
+    "title": "Template Syntax: String Interpolation: `\"text @{expr}\"`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/string-interpolation-textexpr.md",
+    "use_cases": "ts_quote, template, \"text @{expr}\", format!()",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/backtick-template-literals",
+    "title": "Template Syntax: Backtick Template Literals: `\"'^...^'\"`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/backtick-template-literals.md",
+    "use_cases": "ts_quote, template, \"'^...^'\", '^...^', ${\"${}\"}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/conditionals-ifif",
+    "title": "Template Syntax: Conditionals: `{#if}...{/if}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/conditionals-ifif.md",
+    "use_cases": "ts_quote, template, {#if}...{/if}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/pattern-matching-iflet",
+    "title": "Template Syntax: Pattern Matching: `{#if let}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/pattern-matching-iflet.md",
+    "use_cases": "ts_quote, template, {#if let}, if let, option, result",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/match-expressions-match",
+    "title": "Template Syntax: Match Expressions: `{#match}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/match-expressions-match.md",
+    "use_cases": "ts_quote, template, {#match}, match, \npublic field: string;\n",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/iteration-for",
+    "title": "Template Syntax: Iteration: `{#for}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/iteration-for.md",
+    "use_cases": "ts_quote, template, {#for}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/while-loops-while",
+    "title": "Template Syntax: While Loops: `{#while}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/while-loops-while.md",
+    "use_cases": "ts_quote, template, {#while}, while",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/local-constants-let",
+    "title": "Template Syntax: Local Constants: `{$let}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/local-constants-let.md",
+    "use_cases": "ts_quote, template, {$let}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/side-effects-do",
+    "title": "Template Syntax: Side Effects: `{$do}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/side-effects-do.md",
+    "use_cases": "ts_quote, template, {$do}",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/tsstream-injection-typescript",
+    "title": "Template Syntax: TsStream Injection: `{$typescript}`",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/tsstream-injection-typescript.md",
+    "use_cases": "ts_quote, template, {$typescript}, add_import()",
+    "parent_id": "ts-quote"
+  },
+  {
+    "id": "ts-quote/complete-example-json-derive-macro",
+    "title": "Template Syntax: Complete Example: JSON Derive Macro",
+    "category": "custom-macros",
+    "category_title": "Custom Macros",
+    "path": "custom-macros/ts-quote/complete-example-json-derive-macro.md",
+    "use_cases": "ts_quote, template, ts_template!",
+    "parent_id": "ts-quote"
   },
   {
     "id": "ts-quote",
@@ -235,14 +506,32 @@
     "category": "custom-macros",
     "category_title": "Custom Macros",
     "path": "custom-macros/ts-quote.md",
-    "use_cases": "ts_quote, template, code generation, interpolation"
+    "use_cases": "ts_quote, template, code generation, interpolation",
+    "is_chunked": true,
+    "chunk_ids": [
+      "ts-quote/overview",
+      "ts-quote/quick-reference",
+      "ts-quote/identifier-concatenation-content",
+      "ts-quote/comments-and",
+      "ts-quote/string-interpolation-textexpr",
+      "ts-quote/backtick-template-literals",
+      "ts-quote/conditionals-ifif",
+      "ts-quote/pattern-matching-iflet",
+      "ts-quote/match-expressions-match",
+      "ts-quote/iteration-for",
+      "ts-quote/while-loops-while",
+      "ts-quote/local-constants-let",
+      "ts-quote/side-effects-do",
+      "ts-quote/tsstream-injection-typescript",
+      "ts-quote/complete-example-json-derive-macro"
+    ]
   },
   {
     "id": "integration-overview",
     "title": "Overview",
     "category": "integration",
     "category_title": "Integration",
-    "path": "integration/integration-overview.md",
+    "path": "integration/integration.md",
     "use_cases": "setup, integration, tools, ecosystem"
   },
   {
@@ -298,7 +587,7 @@
     "title": "Overview",
     "category": "language-servers",
     "category_title": "Language Servers",
-    "path": "language-servers/ls-overview.md",
+    "path": "language-servers/language-servers.md",
     "use_cases": "lsp, language server, editor support"
   },
   {
@@ -322,7 +611,7 @@
     "title": "Overview",
     "category": "api",
     "category_title": "API Reference",
-    "path": "api/api-overview.md",
+    "path": "api/api.md",
     "use_cases": "api, functions, exports, programmatic"
   },
   {

package/package.json

@@ -1,41 +1,15 @@
 {
-  "name": "@macroforge/mcp-server",
-  "version": "0.1.40",
-  "description": "MCP server for Macroforge documentation and code analysis",
-  "type": "module",
-  "main": "dist/index.js",
   "bin": {
     "macroforge-mcp": "./dist/index.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/rymskip/macroforge-ts.git",
-    "directory": "packages/mcp-server"
-  },
-  "scripts": {
-    "build": "tsc && chmod +x dist/index.js",
-    "build:docs": "node scripts/extract-docs.cjs",
-    "clean": "rm -rf dist",
-    "cleanbuild": "npm run clean && npm run build",
-    "dev": "npx @modelcontextprotocol/inspector dist/index.js",
-    "start": "node dist/index.js",
-    "test": "node --test tests/**/*.test.js"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.11.1"
   },
+  "description": "MCP server for Macroforge documentation and code analysis",
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0"
   },
-  "peerDependencies": {
-    "macroforge": "^0.1.40"
-  },
-  "peerDependenciesMeta": {
-    "macroforge": {
-      "optional": true
-    }
-  },
   "files": [
     "dist",
     "docs"
@@ -47,5 +21,30 @@
     "macros",
     "documentation"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "main": "dist/index.js",
+  "name": "@macroforge/mcp-server",
+  "peerDependencies": {
+    "macroforge": "^0.1.48"
+  },
+  "peerDependenciesMeta": {
+    "macroforge": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/macroforge-ts/mcp-server.git"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "build:docs": "rust-script scripts/extract-docs.rs",
+    "clean": "rm -rf dist",
+    "cleanbuild": "npm run clean && npm run build",
+    "dev": "npx @modelcontextprotocol/inspector dist/index.js",
+    "start": "node dist/index.js",
+    "test": "node --test tests/**/*.test.js"
+  },
+  "type": "module",
+  "version": "0.1.49"
 }