@vizejs/musea-mcp-server 0.11.0 → 0.12.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { startServer } from "./src-ZT3oDiIm.js";
+import { startServer } from "./src-DNZL-15O.js";
 
 //#region src/cli.ts
 let projectRoot = process.env.MUSEA_PROJECT_ROOT || process.cwd();

package/dist/index.js

@@ -1,3 +1,3 @@
-import { createMuseaServer, src_default, startServer } from "./src-ZT3oDiIm.js";
+import { createMuseaServer, src_default, startServer } from "./src-DNZL-15O.js";
 
 export { createMuseaServer, src_default as default, startServer };

package/dist/{src-ZT3oDiIm.js → src-DNZL-15O.js}

@@ -51,98 +51,14 @@ function matchGlob(filepath, pattern) {
 }
 
 //#endregion
-//#region src/tokens.ts
-async function parseTokensFromPath(tokensPath) {
-	const stat = await fs.promises.stat(tokensPath);
-	if (stat.isDirectory()) {
-		const entries = await fs.promises.readdir(tokensPath, { withFileTypes: true });
-		const categories = [];
-		for (const entry of entries) if (entry.isFile() && (entry.name.endsWith(".json") || entry.name.endsWith(".tokens.json"))) {
-			const filePath = path.join(tokensPath, entry.name);
-			const content$1 = await fs.promises.readFile(filePath, "utf-8");
-			const tokens$1 = JSON.parse(content$1);
-			const categoryName = path.basename(entry.name, path.extname(entry.name)).replace(".tokens", "");
-			categories.push({
-				name: formatCategoryName(categoryName),
-				tokens: extractTokenValues(tokens$1),
-				subcategories: extractSubcats(tokens$1)
-			});
-		}
-		return categories;
-	}
-	const content = await fs.promises.readFile(tokensPath, "utf-8");
-	const tokens = JSON.parse(content);
-	return flattenTokenStructure(tokens);
-}
-function generateTokensMarkdown(categories) {
-	const renderCategory = (category, level = 2) => {
-		const heading = "#".repeat(level);
-		let md = `\n${heading} ${category.name}\n\n`;
-		if (Object.keys(category.tokens).length > 0) {
-			md += "| Token | Value | Description |\n";
-			md += "|-------|-------|-------------|\n";
-			for (const [name, token] of Object.entries(category.tokens)) md += `| \`${name}\` | \`${token.value}\` | ${token.description || "-"} |\n`;
-			md += "\n";
-		}
-		if (category.subcategories) for (const sub of category.subcategories) md += renderCategory(sub, level + 1);
-		return md;
-	};
-	let markdown = "# Design Tokens\n";
-	for (const category of categories) markdown += renderCategory(category);
-	return markdown;
-}
-function isTokenLeaf(value) {
-	if (typeof value !== "object" || value === null) return false;
-	const obj = value;
-	return "value" in obj && (typeof obj.value === "string" || typeof obj.value === "number");
-}
-function extractTokenValues(obj) {
-	const tokens = {};
-	for (const [key, value] of Object.entries(obj)) if (isTokenLeaf(value)) {
-		const raw = value;
-		tokens[key] = {
-			value: raw.value,
-			type: raw.type,
-			description: raw.description
-		};
-	}
-	return tokens;
-}
-function extractSubcats(obj) {
-	const subcategories = [];
-	for (const [key, value] of Object.entries(obj)) if (!isTokenLeaf(value) && typeof value === "object" && value !== null) {
-		const tokens = extractTokenValues(value);
-		const nested = extractSubcats(value);
-		if (Object.keys(tokens).length > 0 || nested && nested.length > 0) subcategories.push({
-			name: formatCategoryName(key),
-			tokens,
-			subcategories: nested
-		});
-	}
-	return subcategories.length > 0 ? subcategories : void 0;
-}
-function flattenTokenStructure(tokens) {
-	const categories = [];
-	for (const [key, value] of Object.entries(tokens)) {
-		if (isTokenLeaf(value)) continue;
-		if (typeof value === "object" && value !== null) {
-			const categoryTokens = extractTokenValues(value);
-			const subcategories = flattenTokenStructure(value);
-			if (Object.keys(categoryTokens).length > 0 || subcategories.length > 0) categories.push({
-				name: formatCategoryName(key),
-				tokens: categoryTokens,
-				subcategories: subcategories.length > 0 ? subcategories : void 0
-			});
-		}
-	}
-	return categories;
-}
-function formatCategoryName(name) {
-	return name.replace(/[-_]/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
-}
-
-//#endregion
-//#region src/tools.ts
+//#region src/tools/definitions.ts
+/**
+* MCP tool definitions for Musea.
+*
+* Declares the schema (name, description, input parameters) for each tool
+* exposed by the MCP server: component analysis, registry, code generation,
+* documentation, and design tokens.
+*/
 const toolDefinitions = [
 	{
 		name: "analyze_component",
@@ -327,6 +243,100 @@ const toolDefinitions = [
 		}
 	}
 ];
+
+//#endregion
+//#region src/tokens.ts
+async function parseTokensFromPath(tokensPath) {
+	const stat = await fs.promises.stat(tokensPath);
+	if (stat.isDirectory()) {
+		const entries = await fs.promises.readdir(tokensPath, { withFileTypes: true });
+		const categories = [];
+		for (const entry of entries) if (entry.isFile() && (entry.name.endsWith(".json") || entry.name.endsWith(".tokens.json"))) {
+			const filePath = path.join(tokensPath, entry.name);
+			const content$1 = await fs.promises.readFile(filePath, "utf-8");
+			const tokens$1 = JSON.parse(content$1);
+			const categoryName = path.basename(entry.name, path.extname(entry.name)).replace(".tokens", "");
+			categories.push({
+				name: formatCategoryName(categoryName),
+				tokens: extractTokenValues(tokens$1),
+				subcategories: extractSubcats(tokens$1)
+			});
+		}
+		return categories;
+	}
+	const content = await fs.promises.readFile(tokensPath, "utf-8");
+	const tokens = JSON.parse(content);
+	return flattenTokenStructure(tokens);
+}
+function generateTokensMarkdown(categories) {
+	const renderCategory = (category, level = 2) => {
+		const heading = "#".repeat(level);
+		let md = `\n${heading} ${category.name}\n\n`;
+		if (Object.keys(category.tokens).length > 0) {
+			md += "| Token | Value | Description |\n";
+			md += "|-------|-------|-------------|\n";
+			for (const [name, token] of Object.entries(category.tokens)) md += `| \`${name}\` | \`${token.value}\` | ${token.description || "-"} |\n`;
+			md += "\n";
+		}
+		if (category.subcategories) for (const sub of category.subcategories) md += renderCategory(sub, level + 1);
+		return md;
+	};
+	let markdown = "# Design Tokens\n";
+	for (const category of categories) markdown += renderCategory(category);
+	return markdown;
+}
+function isTokenLeaf(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const obj = value;
+	return "value" in obj && (typeof obj.value === "string" || typeof obj.value === "number");
+}
+function extractTokenValues(obj) {
+	const tokens = {};
+	for (const [key, value] of Object.entries(obj)) if (isTokenLeaf(value)) {
+		const raw = value;
+		tokens[key] = {
+			value: raw.value,
+			type: raw.type,
+			description: raw.description
+		};
+	}
+	return tokens;
+}
+function extractSubcats(obj) {
+	const subcategories = [];
+	for (const [key, value] of Object.entries(obj)) if (!isTokenLeaf(value) && typeof value === "object" && value !== null) {
+		const tokens = extractTokenValues(value);
+		const nested = extractSubcats(value);
+		if (Object.keys(tokens).length > 0 || nested && nested.length > 0) subcategories.push({
+			name: formatCategoryName(key),
+			tokens,
+			subcategories: nested
+		});
+	}
+	return subcategories.length > 0 ? subcategories : void 0;
+}
+function flattenTokenStructure(tokens) {
+	const categories = [];
+	for (const [key, value] of Object.entries(tokens)) {
+		if (isTokenLeaf(value)) continue;
+		if (typeof value === "object" && value !== null) {
+			const categoryTokens = extractTokenValues(value);
+			const subcategories = flattenTokenStructure(value);
+			if (Object.keys(categoryTokens).length > 0 || subcategories.length > 0) categories.push({
+				name: formatCategoryName(key),
+				tokens: categoryTokens,
+				subcategories: subcategories.length > 0 ? subcategories : void 0
+			});
+		}
+	}
+	return categories;
+}
+function formatCategoryName(name) {
+	return name.replace(/[-_]/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
+
+//#endregion
+//#region src/tools/handler.ts
 async function handleToolCall(ctx, name, args) {
 	const binding = ctx.loadNative();
 	switch (name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/musea-mcp-server",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "MCP server for building Vue.js design systems - component analysis, documentation, variant generation, and design tokens",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.5.0",
-    "@vizejs/native": "0.11.0"
+    "@vizejs/native": "0.12.0"
   },
   "devDependencies": {
     "@types/node": "^22.14.0",