@volue/wave-mcp 0.1.0-next.3 → 0.1.0-next.5

package/README.md

@@ -4,20 +4,24 @@
 
 ## Available Tools
 
-- `init` - Initialize the Wave Design System in your project
-- `list_components` - List all available components grouped by category
-- `get_component` - Get comprehensive documentation for a specific component
-- `list_patterns` - List all UX patterns grouped by category
-- `get_pattern` - Retrieve detailed guidance for a specific pattern
-- `get_color_usage` - Get color token usage and guidelines
-- `list_icons` - List all available icons in the Wave icon library
-- `get_icon` - Get SVG code and usage information for a specific icon
+| Tool Name         | Description                                              |
+| ----------------- | -------------------------------------------------------- |
+| `init`            | Initialize the Wave Design System in your project        |
+| `list_components` | List all available components grouped by category        |
+| `get_component`   | Get comprehensive documentation for a specific component |
+| `list_patterns`   | List all UX patterns grouped by category                 |
+| `get_pattern`     | Retrieve detailed guidance for a specific pattern        |
+| `get_color_usage` | Get color token usage and guidelines                     |
+| `list_icons`      | List all available icons in the Wave icon library        |
+| `get_icon`        | Get SVG code and usage information for a specific icon   |
 
 ## Setup
 
+Add configuration code that tells your MCP-compatible client how to connect to the Wave MCP server.
+
 ### VS Code
 
-[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Wave_MCP-0098FF?style=plastic&logo=visualstudiocode&logoColor=ffffff)](https://insiders.vscode.dev/redirect/mcp/install?name=Wave%20Design%20System&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40volue%2Fwave-mcp%40latest%22%5D%7D)
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Wave_MCP-0098FF?style=plastic)](https://insiders.vscode.dev/redirect/mcp/install?name=Wave%20Design%20System&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40volue%2Fwave-mcp%40latest%22%5D%7D)
 
 Use the button above or manually add to your `.vscode/mcp.json`:
 
@@ -36,7 +40,17 @@ Use the button above or manually add to your `.vscode/mcp.json`:
 
 ### Claude Code
 
-Add to your Claude Code MCP servers configuration:
+Use the CLI:
+
+```bash
+# 1. Navigate to your project
+cd your-awesome-project
+
+# 2. Add Wave MCP server
+claude mcp add wave -- npx -y @volue/wave-mcp@latest
+```
+
+Or manually add to your Claude Code MCP servers configuration:
 
 ```json
 {
@@ -51,7 +65,9 @@ Add to your Claude Code MCP servers configuration:
 
 ### Cursor
 
-Add to your Cursor MCP configuration:
+[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Wave_MCP-000000?style=plastic)](https://cursor.com/en/install-mcp?name=wave&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB2b2x1ZS93YXZlLW1jcEBsYXRlc3QiXX0=)
+
+Use the button above or manually add to your Cursor MCP configuration:
 
 ```json
 {

package/dist/index-Bz3fxPpO.js

@@ -0,0 +1,71 @@
+var N=Object.defineProperty;var r=(e,t)=>N(e,"name",{value:t,configurable:!0});import{a as u,f as p,u as f,g as m}from"./server-DrYJkNtU.js";import{createRequire as W}from"node:module";import I from"remark-parse";import A from"unified";import{z as g}from"zod";const j=A().use(I),$={Components:"component","UX patterns":"pattern"};function F(e,t){const o=j.parse(e);let n=null;return o.children.reduce((a,i)=>{if(u(i,"heading")&&i.depth===2)return n=B(i),a;if(!n||!u(i,"list"))return a;const s=n,c=i.children.map(l=>P(l,s,t)).filter(l=>l!==null);return a.concat(c)},[])}r(F,"parseLlmsIndex");function B(e){const[t]=e.children;if(!t||!u(t,"text"))return null;const o=t.value.trim();if(!(o in $))return null;const n=$[o];return{title:o,type:n}}r(B,"extractSectionContext");function P(e,t,o){const[n]=e.children;if(!n||!u(n,"paragraph")||n.children.length!==2)return null;const[a,i]=n.children;if(!u(a,"link")||!u(i,"text")||a.children.length!==1)return null;const s=a.children[0];if(!u(s,"text"))return null;const c=s.value.trim(),l=a.url.replace(/^\//,""),L=new URL(l,`${o}/`).toString(),D=O(l),U=M(t.title,l,t.type),k=z(i.value);return{name:c,slug:D,category:U,section:t.title,type:t.type,url:L,description:k??void 0}}r(P,"listItemToResource");function O(e){return e.replace(/\.md$/,"").split("/").pop()??""}r(O,"deriveSlug");function M(e,t,o){const n=t.replace(/\.md$/,"").split("/");if(o==="component"||o==="pattern"){const a=n.length>=3?n[n.length-2]:null;return a?`${e} / ${V(a)}`:e}return e}r(M,"deriveCategory");function V(e){return e.split("-").filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}r(V,"formatSegment");function z(e){if(!e)return null;const t=e.replace(/^\s*:\s*/,"").trim();return t.toLowerCase()==="no description available"?null:t}r(z,"normalizeDescription");const E=W(import.meta.url),H=E("@volue/design-colors/generic"),X=E("@volue/design-icons"),h=process.env.USE_STABLE_DOCS==="true"||process.env.USE_STABLE_DOCS==="1"?"https://wave.volue.com":"https://wave-design-system.vercel.app",G=`${h}/llms.txt`,q=1e3*60*15,J=process.env.WAVE_RESOURCES_CACHE_TIME?Number.parseInt(process.env.WAVE_RESOURCES_CACHE_TIME,10):q;function y(e){const t=new URL(e,h);return t.pathname.endsWith(".md")||(t.pathname+=".md"),t.toString()}r(y,"createUrl");let v=null,C=0;async function Y(){if(v!==null&&Date.now()<C)return v;const e=await K();return v=e,C=Date.now()+J,e}r(Y,"listCachedResources");let d=null;async function K(){return d||(d=Q().finally(()=>{d=null})),d}r(K,"idempotentLoadResourcesFromLlms");async function Q(){const e=await p(G,void 0,"fetch llms.txt");return F(e,h)}r(Q,"loadResourcesFromLlms");async function Z(e){return p(e.url,void 0,`fetch ${e.name} documentation`)}r(Z,"fetchComponent");function ee(e){return p(e.url,void 0,`fetch ${e.name} pattern`)}r(ee,"fetchPattern");async function te(){return p(y("get-started/developing"),void 0,"fetch developing guide")}r(te,"fetchDevelopingGuide");async function ne(){return p(y("tokens/colors"),void 0,"fetch color usage guidelines")}r(ne,"fetchColorUsageGuidelines");function x(){return Object.entries(X).map(([e,t])=>({name:e,svg:t}))}r(x,"listIcons");function oe(){const e=x();return f(e.map(t=>t.name))}r(oe,"getIconNames");function re(e,t){const o=t.trim().toLowerCase();return e.find(n=>n.name.toLowerCase()===o)}r(re,"findIconByName");async function T(e){return(await Y()).filter(o=>o.type===e)}r(T,"listResourcesByType");function b(e,t){const o=t.trim().toLowerCase();return e.find(n=>n.name.toLowerCase()===o)}r(b,"findResourceByName");function w(){return T("component")}r(w,"listComponents");async function ae(){const e=await w();return f(e.map(t=>t.name))}r(ae,"getComponentNames");function S(){return T("pattern")}r(S,"listPatterns");async function ie(){const e=await S();return f(e.map(t=>t.name))}r(ie,"getPatternNames");function _(e){return e.reduce((t,o)=>(t[o.category]||(t[o.category]=[]),t[o.category].push(o),t),{})}r(_,"groupResourcesByCategory");const se={name:"get_color_usage",description:"Retrieve the Wave Design System color tokens and guidelines for applying color in user interfaces.",exec(e,{name:t,description:o}){e.tool(t,o,async()=>{try{const n=await ne();return{content:[{type:"text",text:JSON.stringify(H)},{type:"text",text:`Here are the Wave Design System color usage guidelines:
+
+${n}
+
+---
+Source: ${y("tokens/colors")}`}]}}catch(n){return{isError:!0,content:[{type:"text",text:`Failed to retrieve color usage guidelines: ${m(n)}`}]}}})}},ce={name:"get_component",description:"Retrieve comprehensive documentation for a specific Wave Design System component by name. This tool retrieves the import instructions, basic usage and advanced configuration examples, code snippets for common scenarios, available props/properties table and some general guidelines for a given Wave Design System component.",async ctx(){try{return{componentNames:await ae()}}catch(e){throw new Error(`Failed to initialize component tool: ${m(e)}`)}},exec(e,{ctx:t,name:o,description:n}){e.tool(o,n,{name:g.enum(t.componentNames).describe("The name of the component to retrieve documentation for. This can be derived from calling the `get_components` tool.")},async({name:a})=>{try{const i=await w(),s=b(i,a);if(!s)throw new Error("Component not found");const c=await Z(s);return c?{content:[{type:"text",text:`Here is the documentation for the \`${s.name}\` component from the Wave Design System:
+
+${c}
+
+---
+Source: ${s.url}`}]}:{content:[{type:"text",text:`No documentation content found for the \`${s.name}\` component.`}]}}catch(i){return{isError:!0,content:[{type:"text",text:`Failed to retrieve documentation for \`${a}\`: ${m(i)}`}]}}})}},le={name:"get_icon",description:"Retrieve a specific icon information by name from Wave Design System.",exec(e,{name:t,description:o}){e.tool(t,o,{name:g.enum(oe()).describe("The icon name to retrieve. This can be derived from calling the `list_icon` tool.")},async({name:n})=>{try{const a=x(),i=re(a,n);if(!i)throw new Error("Icon not found.");const s=`<SvgIcon iconName="${i.name}" />`,c=`<div class="svgIcon svgIcon--stroked">
+  <svg focusable="false" aria-hidden="true">
+    <use xlink:href="#svg--${i.name}"></use>
+  </svg>
+</div>`;return{content:[{type:"text",text:`# ${i.name} icon
+
+## React component:
+
+\`\`\`tsx
+${s}
+\`\`\`
+
+## HTML markup:
+
+\`\`\`html
+${c}
+\`\`\`
+
+## Raw SVG code:
+
+\`\`\`svg
+${i.svg}
+\`\`\``}]}}catch(a){return{isError:!0,content:[{type:"text",text:`Failed to retrieve icon \`${n}\`: ${m(a)}`}]}}})}},me={name:"get_pattern",description:"Retrieve documentation for a specific Wave Design System UX pattern by name. This tool provides guidance, examples and components that implement the selected pattern.",async ctx(){try{return{patternNames:await ie()}}catch(e){throw new Error(`Failed to initialize pattern tool: ${m(e)}`)}},exec(e,{ctx:t,name:o,description:n}){e.tool(o,n,{name:g.enum(t.patternNames).describe("The name of the UX pattern to retrieve documentation for. This can be derived from calling the `list_patterns` tool.")},async({name:a})=>{try{const i=await S(),s=b(i,a);if(!s)throw new Error("Pattern not found");const c=await ee(s);return{content:[{type:"text",text:`Here are the guidelines for the \`${s.name}\` UX pattern from the Wave Design System:
+
+${c}
+
+---
+Source: ${s.url}`}]}}catch(i){return{isError:!0,content:[{type:"text",text:`Failed to retrieve documentation for \`${a}\`: ${m(i)}`}]}}})}},ue={name:"init",description:"Get guide on how to setup or create a project that includes Wave Design System.",exec(e,{name:t,description:o}){e.tool(t,o,async()=>{try{return{content:[{type:"text",text:`The getting started documentation for developing with Wave Design System is included below.
+
+It's **important** that if the project is using a tool like Vite or Next.js, one of the pre-configured starter templates should be used instead of manual configuration:
+
+- https://github.com/Volue/wave-vite-example (Vite template)
+- https://github.com/Volue/wave-nextjs-app-router-example (Next.js App Router template)
+
+---
+
+${await te()}
+`}]}}catch(n){return{isError:!0,content:[{type:"text",text:`Failed to retrieve getting started documentation: ${m(n)}`}]}}})}},pe={name:"list_components",description:"List all components available from the Wave Design System. This tool retrieves the names of all available Wave Design System components grouped by category.",exec(e,{name:t,description:o}){e.tool(t,o,async()=>{try{const n=await w(),a=_(n);return{content:[{type:"text",text:`The following components are available in the Wave Design System:
+
+${Object.entries(a).map(([s,c])=>`## ${s}
+${c.map(l=>`- ${l.name}`).join(`
+`)}`).join(`
+
+`)}
+
+Use the \`get_component\` tool to get more information about a specific component.
+
+Use these components from the @volue/wave-react package.`}]}}catch(n){return{isError:!0,content:[{type:"text",text:`Failed to retrieve the component index: ${m(n)}`}]}}})}},de={name:"list_icons",description:"List all icons available from the Wave Design System. Icons are sourced directly from the `@volue/design-icons` package.",exec(e,{name:t,description:o}){e.tool(t,o,async()=>{try{return{content:[{type:"text",text:`The following icons are available in the Wave Design System:
+
+${x().map(i=>`- ${i.name}`).join(`
+`)}
+
+Use the \`get_icon\` tool to retrieve the SVG markup and usage guidelines for a specific icon.`}]}}catch(n){return{isError:!0,content:[{type:"text",text:`Failed to retrieve the icon data: ${m(n)}`}]}}})}},fe={name:"list_patterns",description:"List all UX patterns available from the Wave Design System. This tool retrieves the names of all available Wave Design System patterns grouped by category.",exec(e,{name:t,description:o}){e.tool(t,o,async()=>{try{const n=await S(),a=_(n);return{content:[{type:"text",text:`The following UX patterns are available in the Wave Design System:
+
+${Object.entries(a).map(([s,c])=>`## ${s}
+${c.map(l=>`- ${l.name}`).join(`
+`)}`).join(`
+
+`)}
+
+Use the \`get_pattern\` tool to access detailed guidance for a specific pattern.`}]}}catch(n){return{isError:!0,content:[{type:"text",text:`Failed to retrieve the pattern index: ${m(n)}`}]}}})}},ge=[ue,pe,ce,fe,me,se,de,le],R=new Set;async function he(e){await Promise.all(ge.map(async t=>{if(R.has(t.name))return;const o=await t.ctx?.();R.add(t.name),t.exec(e,{name:t.name,description:t.description,ctx:o})}))}r(he,"initializeTools");export{he as i};

package/dist/index.js

@@ -1,32 +1,2 @@
 #!/usr/bin/env node
-import { i as isEntryFile } from './server-DtR5gJns.js';
-export { s as server } from './server-DtR5gJns.js';
-import 'node:fs';
-import 'node:url';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-
-if (isEntryFile(import.meta.url)) {
-  const args = process.argv.slice(2);
-  const transport = args[0] || "stdio";
-  async function run() {
-    try {
-      switch (transport) {
-        case "stdio":
-          await import('./transports/stdio.js');
-          break;
-        case "http":
-          process.argv.push("--auto-run");
-          await import('./transports/http.js');
-          break;
-        default:
-          console.error(`Unknown transport: ${transport}`);
-          console.error("Available transports: stdio, http");
-          process.exit(1);
-      }
-    } catch (error) {
-      console.error("Error running transport:", error);
-      process.exit(1);
-    }
-  }
-  run();
-}
+var e=Object.defineProperty;var t=(o,r)=>e(o,"name",{value:r,configurable:!0});import{i}from"./server-DrYJkNtU.js";import{s as g}from"./server-DrYJkNtU.js";import"node:fs";import"node:url";import"@modelcontextprotocol/sdk/server/mcp.js";if(i(import.meta.url)){const r=process.argv.slice(2)[0]||"stdio";async function s(){try{switch(r){case"stdio":await import("./transports/stdio.js");break;case"http":process.argv.push("--auto-run"),await import("./transports/http.js");break;default:console.error(`Unknown transport: ${r}`),console.error("Available transports: stdio, http"),process.exit(1)}}catch(a){console.error("Error running transport:",a),process.exit(1)}}t(s,"run"),s()}export{g as server};

package/dist/server-DrYJkNtU.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var t=(e,r)=>i(e,"name",{value:r,configurable:!0});import{realpathSync as c}from"node:fs";import{pathToFileURL as f}from"node:url";import{McpServer as p}from"@modelcontextprotocol/sdk/server/mcp.js";async function u(e,r,n){const s=await fetch(e,r);if(!s.ok){const a=n??`fetch ${e}`;throw new Error(`Failed to ${a}: ${s.status} ${s.statusText}`)}return s.text()}t(u,"fetchMarkdown");function m(e,r){return e.type===r}t(m,"isNodeType");function v(e){return Array.from(new Set(e))}t(v,"uniq");function h(e){return e instanceof Error?e.message:"Unknown error"}t(h,"getErrorMessage");function g(e){if(!process.argv[1])return!1;const r=c(process.argv[1]),n=f(r);return e===n.href}t(g,"isEntryFile");var l="0.1.0-next.5",o={version:l};const w=new p({name:"Wave Design System",version:o.version,capabilities:{prompts:{},resources:{},tools:{}}});export{m as a,u as f,h as g,g as i,o as p,w as s,v as u};

package/dist/transports/http.js

@@ -1,110 +1,2 @@
 #!/usr/bin/env node
-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
-import cors from 'cors';
-import express from 'express';
-import { randomUUID } from 'node:crypto';
-import { s as server, p as packageJson, i as isEntryFile } from '../server-DtR5gJns.js';
-import { i as initializeTools } from '../index-EJr2aPNi.js';
-import 'node:fs';
-import 'node:url';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import 'node:module';
-import 'remark-parse';
-import 'unified';
-import 'zod';
-
-const app = express();
-const corsOrigin = process.env.CORS_ORIGIN?.split(",") ?? "*";
-app.use(
-  cors({
-    origin: corsOrigin,
-    exposedHeaders: ["Mcp-Session-Id"],
-    allowedHeaders: ["Content-Type", "mcp-session-id"]
-  })
-);
-app.use(express.json());
-const transports = /* @__PURE__ */ new Map();
-app.post("/mcp", async (req, res) => {
-  const sessionId = req.headers["mcp-session-id"];
-  let transport;
-  if (sessionId && transports.has(sessionId)) {
-    transport = transports.get(sessionId);
-  } else if (!sessionId && isInitializeRequest(req.body)) {
-    transport = new StreamableHTTPServerTransport({
-      sessionIdGenerator: () => randomUUID(),
-      onsessioninitialized: (sessionId2) => {
-        transports.set(sessionId2, transport);
-      }
-    });
-    transport.onclose = () => {
-      if (transport.sessionId && transports.has(transport.sessionId)) {
-        transports.delete(transport.sessionId);
-      }
-    };
-    await initializeTools(server);
-    await server.connect(transport);
-  } else {
-    return res.status(400).json({
-      error: { message: "Bad Request: No valid session ID provided" }
-    });
-  }
-  await transport.handleRequest(req, res, req.body);
-});
-const handleSessionRequest = async (req, res) => {
-  const sessionId = req.headers["mcp-session-id"];
-  if (!sessionId || !transports.has(sessionId)) {
-    return res.status(404).send("Invalid or missing session ID");
-  }
-  const transport = transports.get(sessionId);
-  await transport.handleRequest(req, res);
-};
-app.get("/mcp", handleSessionRequest);
-app.delete("/mcp", handleSessionRequest);
-app.get("/", (_req, res) => {
-  res.json({
-    name: "Wave MCPc Server",
-    version: packageJson.version,
-    description: "MCP server for Wave Design System",
-    endpoints: {
-      "/": "Server information (this response)",
-      "/mcp": "Streamable HTTP endpoint for MCP connection",
-      "/health": "Health check endpoint"
-    }
-  });
-});
-app.get("/health", (_req, res) => {
-  res.json({
-    status: "healthy",
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    uptime: process.uptime()
-  });
-});
-const host = process.env.HOST ?? "localhost";
-const port = process.env.PORT ? Number(process.env.PORT) : 3e3;
-let runningServer = null;
-if (process.argv.includes("--auto-run") || isEntryFile(import.meta.url)) {
-  runningServer = app.listen(port, host, (error) => {
-    if (error) {
-      console.error("\u274C Failed to start server:", error);
-      process.exit(1);
-    }
-    console.log(`\u{1F680} Wave MCP Server running on http://${host}:${port}`);
-    console.log(`\u{1F517} Connect via http://${host}:${port}/mcp`);
-  });
-}
-const cleanup = async () => {
-  const closeTasks = Array.from(transports.values()).map((t) => t.close());
-  if (runningServer) {
-    closeTasks.push(
-      new Promise((resolve) => runningServer.close(() => resolve()))
-    );
-  }
-  await Promise.allSettled(closeTasks);
-  console.log("\u{1F44B} Server shut down gracefully");
-  process.exit(0);
-};
-process.on("SIGTERM", cleanup);
-process.on("SIGINT", cleanup);
-
-export { app as default };
+var h=Object.defineProperty;var i=(e,s)=>h(e,"name",{value:s,configurable:!0});import{StreamableHTTPServerTransport as f}from"@modelcontextprotocol/sdk/server/streamableHttp.js";import{isInitializeRequest as g}from"@modelcontextprotocol/sdk/types.js";import I from"cors";import l from"express";import{randomUUID as S}from"node:crypto";import{s as m,p as T,i as w}from"../server-DrYJkNtU.js";import{i as y}from"../index-Bz3fxPpO.js";import"node:fs";import"node:url";import"@modelcontextprotocol/sdk/server/mcp.js";import"node:module";import"remark-parse";import"unified";import"zod";const t=l(),P=process.env.CORS_ORIGIN?.split(",")??"*";t.use(I({origin:P,exposedHeaders:["Mcp-Session-Id"],allowedHeaders:["Content-Type","mcp-session-id"]})),t.use(l.json());const r=new Map;t.post("/mcp",async(e,s)=>{const n=e.headers["mcp-session-id"];let o;if(n&&r.has(n))o=r.get(n);else if(!n&&g(e.body))o=new f({sessionIdGenerator:i(()=>S(),"sessionIdGenerator"),onsessioninitialized:i(v=>{r.set(v,o)},"onsessioninitialized")}),o.onclose=()=>{o.sessionId&&r.has(o.sessionId)&&r.delete(o.sessionId)},await y(m),await m.connect(o);else return s.status(400).json({error:{message:"Bad Request: No valid session ID provided"}});await o.handleRequest(e,s,e.body)});const d=i(async(e,s)=>{const n=e.headers["mcp-session-id"];if(!n||!r.has(n))return s.status(404).send("Invalid or missing session ID");await r.get(n).handleRequest(e,s)},"handleSessionRequest");t.get("/mcp",d),t.delete("/mcp",d),t.get("/",(e,s)=>{s.json({name:"Wave MCPc Server",version:T.version,description:"MCP server for Wave Design System",endpoints:{"/":"Server information (this response)","/mcp":"Streamable HTTP endpoint for MCP connection","/health":"Health check endpoint"}})}),t.get("/health",(e,s)=>{s.json({status:"healthy",timestamp:new Date().toISOString(),uptime:process.uptime()})});const a=process.env.HOST??"localhost",p=process.env.PORT?Number(process.env.PORT):3e3;let c=null;(process.argv.includes("--auto-run")||w(import.meta.url))&&(c=t.listen(p,a,e=>{e&&(console.error("\u274C Failed to start server:",e),process.exit(1)),console.log(`\u{1F680} Wave MCP Server running on http://${a}:${p}`),console.log(`\u{1F517} Connect via http://${a}:${p}/mcp`)}));const u=i(async()=>{const e=Array.from(r.values()).map(s=>s.close());c&&e.push(new Promise(s=>c.close(()=>s()))),await Promise.allSettled(e),console.log("\u{1F44B} Server shut down gracefully"),process.exit(0)},"cleanup");process.on("SIGTERM",u),process.on("SIGINT",u);export{t as default};

package/dist/transports/stdio.js

@@ -1,27 +1,2 @@
 #!/usr/bin/env node
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { s as server } from '../server-DtR5gJns.js';
-import { i as initializeTools } from '../index-EJr2aPNi.js';
-import 'node:fs';
-import 'node:url';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import 'node:module';
-import 'remark-parse';
-import 'unified';
-import 'zod';
-
-async function main() {
-  await initializeTools(server);
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  const cleanup = async () => {
-    await transport.close();
-    process.exit(0);
-  };
-  process.on("SIGTERM", cleanup);
-  process.on("SIGINT", cleanup);
-}
-main().catch((error) => {
-  console.error("\u274C Failed to start server:", error);
-  process.exit(1);
-});
+var s=Object.defineProperty;var t=(o,r)=>s(o,"name",{value:r,configurable:!0});import{StdioServerTransport as e}from"@modelcontextprotocol/sdk/server/stdio.js";import{s as i}from"../server-DrYJkNtU.js";import{i as a}from"../index-Bz3fxPpO.js";import"node:fs";import"node:url";import"@modelcontextprotocol/sdk/server/mcp.js";import"node:module";import"remark-parse";import"unified";import"zod";async function n(){await a(i);const o=new e;await i.connect(o);const r=t(async()=>{await o.close(),process.exit(0)},"cleanup");process.on("SIGTERM",r),process.on("SIGINT",r)}t(n,"main"),n().catch(o=>{console.error("\u274C Failed to start server:",o),process.exit(1)});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volue/wave-mcp",
-  "version": "0.1.0-next.3",
+  "version": "0.1.0-next.5",
   "description": "An MCP server that connects AI tools to the Wave Design System",
   "license": "UNLICENSED",
   "repository": {
@@ -43,7 +43,7 @@
     "format": "yarn run _prettier --write",
     "test": "run-p lint:types lint \"_prettier --check\"",
     "clean": "premove dist",
-    "build": "yarn run clean && pkgroll",
+    "build": "yarn run clean && pkgroll --minify",
     "start": "yarn run build && node dist/transports/http.js",
     "dev": "tsx watch --clear-screen=false src/transports/http.ts",
     "prepack": "yarn run build",
@@ -51,12 +51,12 @@
     "inspect:http": "yarn dlx -q @modelcontextprotocol/inspector --transport http --server-url http://localhost:3000/mcp"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.17.5",
+    "@modelcontextprotocol/sdk": "1.19.1",
     "@types/cors": "2.8.19",
     "@types/express": "5.0.3",
     "@types/express-serve-static-core": "5.0.7",
-    "@volue/design-colors": "^3.0.10-next.2",
-    "@volue/design-icons": "^1.9.4-next.2",
+    "@volue/design-colors": "^3.0.10-next.3",
+    "@volue/design-icons": "^1.9.4-next.3",
     "cors": "2.8.5",
     "express": "5.1.0",
     "remark-parse": "8.0.3",
@@ -65,15 +65,15 @@
     "zod": "3.25.76"
   },
   "devDependencies": {
-    "@types/mdast": "3.0.3",
-    "@types/node": "22.18.1",
+    "@types/mdast": "3.0.15",
+    "@types/node": "22.18.8",
     "@volue/eslint-config": "1.3.11",
-    "eslint": "9.32.0",
+    "eslint": "9.36.0",
     "npm-run-all2": "8.0.4",
-    "pkgroll": "2.15.3",
+    "pkgroll": "2.17.0",
     "premove": "4.0.0",
     "prettier": "3.6.2",
-    "tsx": "4.20.5",
-    "typescript": "5.9.2"
+    "tsx": "4.20.6",
+    "typescript": "5.9.3"
   }
 }

package/dist/index-EJr2aPNi.js

@@ -1,619 +0,0 @@
-import { a as isNodeType, f as fetchMarkdown, u as uniq, g as getErrorMessage } from './server-DtR5gJns.js';
-import { createRequire } from 'node:module';
-import remarkParse from 'remark-parse';
-import unified from 'unified';
-import { z } from 'zod';
-
-const markdownParser = unified().use(remarkParse);
-const SECTION_TYPE_MAP = {
-  Components: "component",
-  "UX patterns": "pattern"
-};
-function parseLlmsIndex(indexContent, baseUrl) {
-  const ast = markdownParser.parse(indexContent);
-  let currentSection = null;
-  return ast.children.reduce((resources, node) => {
-    if (isNodeType(node, "heading") && node.depth === 2) {
-      currentSection = extractSectionContext(node);
-      return resources;
-    }
-    if (!currentSection || !isNodeType(node, "list")) {
-      return resources;
-    }
-    const section = currentSection;
-    const sectionResources = node.children.map((item) => listItemToResource(item, section, baseUrl)).filter((resource) => resource !== null);
-    return resources.concat(sectionResources);
-  }, []);
-}
-function extractSectionContext(node) {
-  const [headingChild] = node.children;
-  if (!headingChild || !isNodeType(headingChild, "text")) {
-    return null;
-  }
-  const title = headingChild.value.trim();
-  if (!(title in SECTION_TYPE_MAP)) {
-    return null;
-  }
-  const type = SECTION_TYPE_MAP[title];
-  return {
-    title,
-    type
-  };
-}
-function listItemToResource(item, section, baseUrl) {
-  const [paragraph] = item.children;
-  if (!paragraph || !isNodeType(paragraph, "paragraph") || paragraph.children.length !== 2) {
-    return null;
-  }
-  const [linkNode, textNode] = paragraph.children;
-  if (!isNodeType(linkNode, "link") || !isNodeType(textNode, "text") || linkNode.children.length !== 1) {
-    return null;
-  }
-  const linkChild = linkNode.children[0];
-  if (!isNodeType(linkChild, "text")) {
-    return null;
-  }
-  const name = linkChild.value.trim();
-  const normalizedPath = linkNode.url.replace(/^\//, "");
-  const url = new URL(normalizedPath, `${baseUrl}/`).toString();
-  const slug = deriveSlug(normalizedPath);
-  const category = deriveCategory(section.title, normalizedPath, section.type);
-  const description = normalizeDescription(textNode.value);
-  return {
-    name,
-    slug,
-    category,
-    section: section.title,
-    type: section.type,
-    url,
-    description: description ?? void 0
-  };
-}
-function deriveSlug(path) {
-  return path.replace(/\.md$/, "").split("/").pop() ?? "";
-}
-function deriveCategory(sectionTitle, path, type) {
-  const segments = path.replace(/\.md$/, "").split("/");
-  if (type === "component" || type === "pattern") {
-    const subcategory = segments.length >= 3 ? segments[segments.length - 2] : null;
-    return subcategory ? `${sectionTitle} / ${formatSegment(subcategory)}` : sectionTitle;
-  }
-  return sectionTitle;
-}
-function formatSegment(segment) {
-  return segment.split("-").filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
-function normalizeDescription(rawDescription) {
-  if (!rawDescription) {
-    return null;
-  }
-  const withoutLeadingColon = rawDescription.replace(/^\s*:\s*/, "").trim();
-  if (withoutLeadingColon.toLowerCase() === "no description available") {
-    return null;
-  }
-  return withoutLeadingColon;
-}
-
-const require = createRequire(import.meta.url);
-const colorTokensData = require("@volue/design-colors/generic");
-const iconTokensData = require("@volue/design-icons");
-const WAVE_BASE_URL = "https://wave-design-system.vercel.app";
-const LLMS_INDEX_URL = `${WAVE_BASE_URL}/llms.txt`;
-const DEFAULT_RESOURCES_CACHE_TIME = 1e3 * 60 * 15;
-const RESOURCES_CACHE_TIME = process.env.WAVE_RESOURCES_CACHE_TIME ? Number.parseInt(process.env.WAVE_RESOURCES_CACHE_TIME, 10) : DEFAULT_RESOURCES_CACHE_TIME;
-function createUrl(path) {
-  const withSlash = path.startsWith("/") ? path : `/${path}`;
-  return `${WAVE_BASE_URL}${withSlash}.md`;
-}
-let cachedResources = null;
-let cacheExpiresAt = 0;
-async function listCachedResources() {
-  if (cachedResources !== null && Date.now() < cacheExpiresAt) {
-    return cachedResources;
-  }
-  const resources = await idempotentLoadResourcesFromLlms();
-  cachedResources = resources;
-  cacheExpiresAt = Date.now() + RESOURCES_CACHE_TIME;
-  return resources;
-}
-let inflightResources = null;
-async function idempotentLoadResourcesFromLlms() {
-  if (!inflightResources) {
-    inflightResources = loadResourcesFromLlms().finally(() => {
-      inflightResources = null;
-    });
-  }
-  return inflightResources;
-}
-async function loadResourcesFromLlms() {
-  const body = await fetchMarkdown(LLMS_INDEX_URL, void 0, "fetch llms.txt");
-  const parsedBody = parseLlmsIndex(body, WAVE_BASE_URL);
-  return parsedBody;
-}
-async function fetchComponent(component) {
-  return fetchMarkdown(
-    component.url,
-    void 0,
-    `fetch ${component.name} documentation`
-  );
-}
-function fetchPattern(pattern) {
-  return fetchMarkdown(pattern.url, void 0, `fetch ${pattern.name} pattern`);
-}
-async function fetchDevelopingGuide() {
-  return fetchMarkdown(
-    createUrl("get-started/developing"),
-    void 0,
-    "fetch developing guide"
-  );
-}
-async function fetchColorUsageGuidelines() {
-  return fetchMarkdown(
-    createUrl("tokens/colors"),
-    void 0,
-    "fetch color usage guidelines"
-  );
-}
-function listIcons() {
-  return Object.entries(iconTokensData).map(([name, svg]) => ({ name, svg }));
-}
-function getIconNames() {
-  const icons = listIcons();
-  return uniq(icons.map((icon) => icon.name));
-}
-function findIconByName(icons, name) {
-  const normalized = name.trim().toLowerCase();
-  return icons.find((icon) => icon.name.toLowerCase() === normalized);
-}
-async function listResourcesByType(type) {
-  const resources = await listCachedResources();
-  return resources.filter(
-    (resource) => resource.type === type
-  );
-}
-function findResourceByName(resources, name) {
-  const normalized = name.trim().toLowerCase();
-  return resources.find((resource) => resource.name.toLowerCase() === normalized);
-}
-function listComponents() {
-  return listResourcesByType("component");
-}
-async function getComponentNames() {
-  const components = await listComponents();
-  return uniq(components.map((component) => component.name));
-}
-function listPatterns() {
-  return listResourcesByType("pattern");
-}
-async function getPatternNames() {
-  const patterns = await listPatterns();
-  return uniq(patterns.map((pattern) => pattern.name));
-}
-function groupResourcesByCategory(resources) {
-  return resources.reduce((acc, resource) => {
-    if (!acc[resource.category]) {
-      acc[resource.category] = [];
-    }
-    acc[resource.category].push(resource);
-    return acc;
-  }, {});
-}
-
-const getColorUsageTool = {
-  name: "get_color_usage",
-  description: "Retrieve the Wave Design System color tokens and guidelines for applying color in user interfaces.",
-  exec(server, { name, description }) {
-    server.tool(name, description, async () => {
-      try {
-        const markdown = await fetchColorUsageGuidelines();
-        return {
-          content: [
-            {
-              type: "text",
-              text: JSON.stringify(colorTokensData)
-            },
-            {
-              type: "text",
-              text: `Here are the Wave Design System color usage guidelines:
-
-${markdown}
-
----
-Source: ${createUrl("tokens/colors")}`
-            }
-          ]
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [
-            {
-              type: "text",
-              text: `Failed to retrieve color usage guidelines: ${getErrorMessage(error)}`
-            }
-          ]
-        };
-      }
-    });
-  }
-};
-
-const getComponentTool = {
-  name: "get_component",
-  description: "Retrieve comprehensive documentation for a specific Wave Design System component by name. This tool retrieves the import instructions, basic usage and advanced configuration examples, code snippets for common scenarios, available props/properties table and some general guidelines for a given Wave Design System component.",
-  async ctx() {
-    try {
-      const componentNames = await getComponentNames();
-      return { componentNames };
-    } catch (error) {
-      throw new Error(
-        `Failed to initialize component tool: ${getErrorMessage(error)}`
-      );
-    }
-  },
-  exec(server, { ctx, name, description }) {
-    server.tool(
-      name,
-      description,
-      {
-        name: z.enum(ctx.componentNames).describe(
-          "The name of the component to retrieve documentation for. This can be derived from calling the `get_components` tool."
-        )
-      },
-      async ({ name: name2 }) => {
-        try {
-          const components = await listComponents();
-          const component = findResourceByName(components, name2);
-          if (!component) {
-            throw new Error(`Component not found`);
-          }
-          const markdown = await fetchComponent(component);
-          if (!markdown) {
-            return {
-              content: [
-                {
-                  type: "text",
-                  text: `No documentation content found for the \`${component.name}\` component.`
-                }
-              ]
-            };
-          }
-          return {
-            content: [
-              {
-                type: "text",
-                text: `Here is the documentation for the \`${component.name}\` component from the Wave Design System:
-
-${markdown}
-
----
-Source: ${component.url}`
-              }
-            ]
-          };
-        } catch (error) {
-          return {
-            isError: true,
-            content: [
-              {
-                type: "text",
-                text: `Failed to retrieve documentation for \`${name2}\`: ${getErrorMessage(error)}`
-              }
-            ]
-          };
-        }
-      }
-    );
-  }
-};
-
-const getIconTool = {
-  name: "get_icon",
-  description: "Retrieve a specific icon information by name from Wave Design System.",
-  exec(server, { name, description }) {
-    server.tool(
-      name,
-      description,
-      {
-        name: z.enum(getIconNames()).describe(
-          "The icon name to retrieve. This can be derived from calling the `list_icon` tool."
-        )
-      },
-      async ({ name: name2 }) => {
-        try {
-          const icons = listIcons();
-          const icon = findIconByName(icons, name2);
-          if (!icon) {
-            throw new Error("Icon not found.");
-          }
-          const reactComponentSnippet = `<SvgIcon iconName="${icon.name}" />`;
-          const htmlMarkup = `<div class="svgIcon svgIcon--stroked">
-  <svg focusable="false" aria-hidden="true">
-    <use xlink:href="#svg--${icon.name}"></use>
-  </svg>
-</div>`;
-          return {
-            content: [
-              {
-                type: "text",
-                text: `# ${icon.name} icon
-
-## React component:
-
-\`\`\`tsx
-${reactComponentSnippet}
-\`\`\`
-
-## HTML markup:
-
-\`\`\`html
-${htmlMarkup}
-\`\`\`
-
-## Raw SVG code:
-
-\`\`\`svg
-${icon.svg}
-\`\`\``
-              }
-            ]
-          };
-        } catch (error) {
-          return {
-            isError: true,
-            content: [
-              {
-                type: "text",
-                text: `Failed to retrieve icon \`${name2}\`: ${getErrorMessage(error)}`
-              }
-            ]
-          };
-        }
-      }
-    );
-  }
-};
-
-const getPatternTool = {
-  name: "get_pattern",
-  description: "Retrieve documentation for a specific Wave Design System UX pattern by name. This tool provides guidance, examples and components that implement the selected pattern.",
-  async ctx() {
-    try {
-      const patternNames = await getPatternNames();
-      return { patternNames };
-    } catch (error) {
-      throw new Error(
-        `Failed to initialize pattern tool: ${getErrorMessage(error)}`
-      );
-    }
-  },
-  exec(server, { ctx, name, description }) {
-    server.tool(
-      name,
-      description,
-      {
-        name: z.enum(ctx.patternNames).describe(
-          "The name of the UX pattern to retrieve documentation for. This can be derived from calling the `list_patterns` tool."
-        )
-      },
-      async ({ name: name2 }) => {
-        try {
-          const patterns = await listPatterns();
-          const pattern = findResourceByName(patterns, name2);
-          if (!pattern) {
-            throw new Error("Pattern not found");
-          }
-          const markdown = await fetchPattern(pattern);
-          return {
-            content: [
-              {
-                type: "text",
-                text: `Here are the guidelines for the \`${pattern.name}\` UX pattern from the Wave Design System:
-
-${markdown}
-
----
-Source: ${pattern.url}`
-              }
-            ]
-          };
-        } catch (error) {
-          return {
-            isError: true,
-            content: [
-              {
-                type: "text",
-                text: `Failed to retrieve documentation for \`${name2}\`: ${getErrorMessage(error)}`
-              }
-            ]
-          };
-        }
-      }
-    );
-  }
-};
-
-const initTool = {
-  name: "init",
-  description: "Get guide on how to setup or create a project that includes Wave Design System.",
-  exec(server, { name, description }) {
-    server.tool(name, description, async () => {
-      try {
-        const markdown = await fetchDevelopingGuide();
-        return {
-          content: [
-            {
-              type: "text",
-              text: `The getting started documentation for developing with Wave Design System is included below.
-
-It's **important** that if the project is using a tool like Vite or Next.js, one of the pre-configured starter templates should be used instead of manual configuration:
-
-- https://github.com/Volue/wave-vite-example (Vite template)
-- https://github.com/Volue/wave-nextjs-app-router-example (Next.js App Router template)
-
----
-
-${markdown}
-`
-            }
-          ]
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [
-            {
-              type: "text",
-              text: `Failed to retrieve getting started documentation: ${getErrorMessage(error)}`
-            }
-          ]
-        };
-      }
-    });
-  }
-};
-
-const listComponentsTool = {
-  name: "list_components",
-  description: "List all components available from the Wave Design System. This tool retrieves the names of all available Wave Design System components grouped by category.",
-  exec(server, { name, description }) {
-    server.tool(name, description, async () => {
-      try {
-        const components = await listComponents();
-        const componentsByCategory = groupResourcesByCategory(components);
-        const formattedList = Object.entries(componentsByCategory).map(
-          ([category, items]) => `## ${category}
-${items.map((item) => `- ${item.name}`).join("\n")}`
-        ).join("\n\n");
-        return {
-          content: [
-            {
-              type: "text",
-              text: `The following components are available in the Wave Design System:
-
-${formattedList}
-
-Use the \`get_component\` tool to get more information about a specific component.
-
-Use these components from the @volue/wave-react package.`
-            }
-          ]
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [
-            {
-              type: "text",
-              text: `Failed to retrieve the component index: ${getErrorMessage(error)}`
-            }
-          ]
-        };
-      }
-    });
-  }
-};
-
-const listIconsTool = {
-  name: "list_icons",
-  description: "List all icons available from the Wave Design System. Icons are sourced directly from the `@volue/design-icons` package.",
-  exec(server, { name, description }) {
-    server.tool(name, description, async () => {
-      try {
-        const icons = listIcons();
-        const formattedList = icons.map((icon) => `- ${icon.name}`).join("\n");
-        return {
-          content: [
-            {
-              type: "text",
-              text: `The following icons are available in the Wave Design System:
-
-${formattedList}
-
-Use the \`get_icon\` tool to retrieve the SVG markup and usage guidelines for a specific icon.`
-            }
-          ]
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [
-            {
-              type: "text",
-              text: `Failed to retrieve the icon data: ${getErrorMessage(error)}`
-            }
-          ]
-        };
-      }
-    });
-  }
-};
-
-const listPatternsTool = {
-  name: "list_patterns",
-  description: "List all UX patterns available from the Wave Design System. This tool retrieves the names of all available Wave Design System patterns grouped by category.",
-  exec(server, { name, description }) {
-    server.tool(name, description, async () => {
-      try {
-        const patterns = await listPatterns();
-        const patternsByCategory = groupResourcesByCategory(patterns);
-        const formattedList = Object.entries(patternsByCategory).map(
-          ([category, items]) => `## ${category}
-${items.map((item) => `- ${item.name}`).join("\n")}`
-        ).join("\n\n");
-        return {
-          content: [
-            {
-              type: "text",
-              text: `The following UX patterns are available in the Wave Design System:
-
-${formattedList}
-
-Use the \`get_pattern\` tool to access detailed guidance for a specific pattern.`
-            }
-          ]
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [
-            {
-              type: "text",
-              text: `Failed to retrieve the pattern index: ${getErrorMessage(error)}`
-            }
-          ]
-        };
-      }
-    });
-  }
-};
-
-const tools = [
-  initTool,
-  listComponentsTool,
-  getComponentTool,
-  listPatternsTool,
-  getPatternTool,
-  getColorUsageTool,
-  listIconsTool,
-  getIconTool
-];
-const registeredToolNames = /* @__PURE__ */ new Set();
-async function initializeTools(server) {
-  await Promise.all(
-    tools.map(async (tool) => {
-      if (registeredToolNames.has(tool.name)) {
-        return;
-      }
-      const toolCtx = await tool.ctx?.();
-      registeredToolNames.add(tool.name);
-      tool.exec(server, {
-        name: tool.name,
-        description: tool.description,
-        ctx: toolCtx
-      });
-    })
-  );
-}
-
-export { initializeTools as i };

package/dist/server-DtR5gJns.js

@@ -1,45 +0,0 @@
-import { realpathSync } from 'node:fs';
-import { pathToFileURL } from 'node:url';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-
-async function fetchMarkdown(url, options, errorContext) {
-  const response = await fetch(url, options);
-  if (!response.ok) {
-    const context = errorContext ?? `fetch ${url}`;
-    throw new Error(
-      `Failed to ${context}: ${response.status} ${response.statusText}`
-    );
-  }
-  return response.text();
-}
-function isNodeType(node, type) {
-  return node.type === type;
-}
-function uniq(array) {
-  return Array.from(new Set(array));
-}
-function getErrorMessage(error) {
-  return error instanceof Error ? error.message : "Unknown error";
-}
-function isEntryFile(url) {
-  if (!process.argv[1]) return false;
-  const realPath = realpathSync(process.argv[1]);
-  const realPathURL = pathToFileURL(realPath);
-  return url === realPathURL.href;
-}
-
-var version = "0.1.0-next.3";
-var packageJson = {
-	version: version};
-
-const server = new McpServer({
-  name: "Wave Design System",
-  version: packageJson.version,
-  capabilities: {
-    prompts: {},
-    resources: {},
-    tools: {}
-  }
-});
-
-export { isNodeType as a, fetchMarkdown as f, getErrorMessage as g, isEntryFile as i, packageJson as p, server as s, uniq as u };