@wot-ui/cli 0.0.1-beta.2

package/dist/server-HjZltXBO.mjs

@@ -0,0 +1,248 @@
+import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent } from "./scanner-BFHnD5iE.mjs";
+import process from "node:process";
+import { McpServer, StdioServerTransport } from "@modelcontextprotocol/server";
+import * as z from "zod/v4";
+
+//#region src/mcp/prompts.ts
+const WOT_EXPERT_PROMPT = [
+	"You are a wot-ui expert assistant.",
+	"Always query component metadata before generating code.",
+	"Prefer using wot_list, wot_info, wot_doc, and wot_token before writing UI code.",
+	"Assume only wot-ui v2 is supported by this server."
+].join(" ");
+const WOT_PAGE_GENERATOR_PROMPT = [
+	"Generate wot-ui pages by first collecting every relevant component API and CSS variable.",
+	"Prefer existing wd-* components and documented props over ad-hoc custom markup.",
+	"When theme customization is involved, inspect CSS variables with wot_token first."
+].join(" ");
+
+//#endregion
+//#region src/mcp/tools.ts
+function jsonText(value) {
+	return JSON.stringify(value, null, 2);
+}
+function registerMcpTools(server) {
+	server.registerTool("wot_list", {
+		description: "List available wot-ui components.",
+		inputSchema: z.object({ version: z.string().optional() }),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async ({ version }) => {
+		return { content: [{
+			type: "text",
+			text: jsonText({ components: listComponents(version) })
+		}] };
+	});
+	server.registerTool("wot_info", {
+		description: "Get props, events, slots, and CSS variables for a component.",
+		inputSchema: z.object({
+			component: z.string(),
+			version: z.string().optional()
+		}),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async ({ component, version }) => {
+		const result = findComponent(component, version);
+		if (!result) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Component not found: ${component}`
+			}]
+		};
+		return { content: [{
+			type: "text",
+			text: jsonText(result)
+		}] };
+	});
+	server.registerTool("wot_doc", {
+		description: "Get component markdown documentation.",
+		inputSchema: z.object({
+			component: z.string(),
+			version: z.string().optional()
+		}),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async ({ component, version }) => {
+		const result = findComponent(component, version);
+		if (!result?.doc) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Documentation not found: ${component}`
+			}]
+		};
+		return { content: [{
+			type: "text",
+			text: result.doc
+		}] };
+	});
+	server.registerTool("wot_demo", {
+		description: "Get component demo code or list demos.",
+		inputSchema: z.object({
+			component: z.string(),
+			demo: z.string().optional(),
+			version: z.string().optional()
+		}),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async ({ component, demo, version }) => {
+		const result = findComponent(component, version);
+		if (!result) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Component not found: ${component}`
+			}]
+		};
+		if (!demo) return { content: [{
+			type: "text",
+			text: jsonText({ demos: result.demos ?? [] })
+		}] };
+		const matched = result.demos?.find((item) => item.name.toLowerCase() === demo.toLowerCase());
+		if (!matched) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Demo not found: ${demo}`
+			}]
+		};
+		return { content: [{
+			type: "text",
+			text: jsonText(matched)
+		}] };
+	});
+	server.registerTool("wot_token", {
+		description: "Get component CSS variables.",
+		inputSchema: z.object({
+			component: z.string().optional(),
+			version: z.string().optional()
+		}),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async ({ component, version }) => {
+		if (!component) return { content: [{
+			type: "text",
+			text: jsonText({ components: listComponents(version).map((item) => ({
+				name: item.name,
+				cssVars: item.cssVars
+			})) })
+		}] };
+		const result = findComponent(component, version);
+		if (!result) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Component not found: ${component}`
+			}]
+		};
+		return { content: [{
+			type: "text",
+			text: jsonText({
+				name: result.name,
+				cssVars: result.cssVars
+			})
+		}] };
+	});
+	server.registerTool("wot_changelog", {
+		description: "Get changelog entries for the supported v2 dataset.",
+		inputSchema: z.object({
+			version: z.string().optional(),
+			component: z.string().optional()
+		}),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async ({ version, component }) => {
+		return { content: [{
+			type: "text",
+			text: jsonText({ entries: (loadMetadataFile(resolveVersion(version)).changelog ?? []).filter((entry) => {
+				const versionMatches = version ? entry.version === version || `v${entry.version}` === version : true;
+				const componentMatches = component ? (entry.components ?? []).some((item) => item.toLowerCase() === component.toLowerCase()) : true;
+				return versionMatches && componentMatches;
+			}) })
+		}] };
+	});
+	server.registerTool("wot_lint", {
+		description: "Lint a local project for wot-ui related issues.",
+		inputSchema: z.object({
+			dir: z.string().optional(),
+			version: z.string().optional()
+		}),
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: true
+		}
+	}, async ({ dir, version }) => {
+		return { content: [{
+			type: "text",
+			text: jsonText(lintProject(dir ?? process.cwd(), version))
+		}] };
+	});
+}
+
+//#endregion
+//#region src/mcp/server.ts
+async function startMcpServer() {
+	const server = new McpServer({
+		name: "wot-ui",
+		version: "0.0.0"
+	}, {
+		instructions: "Use wot-ui component tools before generating UI code. Only wot-ui v2 metadata is available in this server.",
+		capabilities: { logging: {} }
+	});
+	registerMcpTools(server);
+	server.registerPrompt("wot-expert", { description: "General wot-ui expert workflow." }, async () => ({ messages: [{
+		role: "assistant",
+		content: {
+			type: "text",
+			text: WOT_EXPERT_PROMPT
+		}
+	}] }));
+	server.registerPrompt("wot-page-generator", {
+		description: "Workflow for generating a wot-ui page.",
+		argsSchema: z.object({ goal: z.string().optional() })
+	}, async ({ goal }) => ({ messages: [{
+		role: "assistant",
+		content: {
+			type: "text",
+			text: goal ? `${WOT_PAGE_GENERATOR_PROMPT} Goal: ${goal}` : WOT_PAGE_GENERATOR_PROMPT
+		}
+	}] }));
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	const shutdown = async () => {
+		await server.close();
+		process.exit(0);
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+}
+
+//#endregion
+export { startMcpServer };

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@wot-ui/cli",
+  "type": "module",
+  "version": "0.0.1-beta.2",
+  "description": "CLI, MCP and skills toolkit for wot-ui",
+  "license": "MIT",
+  "homepage": "https://github.com/wot-ui/open-wot#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wot-ui/open-wot.git"
+  },
+  "bugs": "https://github.com/wot-ui/open-wot/issues",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "wot": "dist/index.mjs"
+  },
+  "files": [
+    "data",
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "extract": "tsx scripts/extract.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@cfworker/json-schema": "catalog:cli",
+    "@modelcontextprotocol/server": "catalog:cli",
+    "@vue/compiler-sfc": "catalog:cli",
+    "commander": "catalog:cli",
+    "zod": "catalog:cli"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:types",
+    "tsdown": "catalog:cli",
+    "tsx": "catalog:cli",
+    "typescript": "catalog:cli",
+    "vitest": "catalog:testing"
+  }
+}

package/skills/wot-ui/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: wot-ui
+description: Query wot-ui component knowledge before generating or refactoring UI code.
+summary: Query wot-ui component knowledge before generating code.
+---
+
+Use the local `wot` CLI before generating or refactoring wot-ui based code.
+
+Recommended workflow:
+1. Run `wot list` to find the target component.
+2. Run `wot info <Component>` to inspect props, events, slots, and CSS variables.
+3. Run `wot doc <Component>` when you need the markdown documentation.
+4. Run `wot token <Component>` when theme customization is involved.
+
+Current limitations:
+- Only wot-ui v2 is supported.
+- Bundled data is still a seed dataset until `pnpm extract` is run against the full wot-ui source repository.
+- `usage` and `lint` currently focus on `.vue` files.