@wot-ui/cli 0.0.1-beta.10

package/dist/server-BLoIUV7u.mjs

@@ -0,0 +1,248 @@
+import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent, s as version } from "./scanner-_isnOGJK.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: version$1 }) => {
+		return { content: [{
+			type: "text",
+			text: jsonText({ components: listComponents(version$1) })
+		}] };
+	});
+	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: version$1 }) => {
+		const result = findComponent(component, version$1);
+		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: version$1 }) => {
+		const result = findComponent(component, version$1);
+		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: version$1 }) => {
+		const result = findComponent(component, version$1);
+		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: version$1 }) => {
+		if (!component) return { content: [{
+			type: "text",
+			text: jsonText({ components: listComponents(version$1).map((item) => ({
+				name: item.name,
+				cssVars: item.cssVars
+			})) })
+		}] };
+		const result = findComponent(component, version$1);
+		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: version$1, component }) => {
+		return { content: [{
+			type: "text",
+			text: jsonText({ entries: (loadMetadataFile(resolveVersion(version$1)).changelog ?? []).filter((entry) => {
+				const versionMatches = version$1 ? entry.version === version$1 || `v${entry.version}` === version$1 : 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: version$1 }) => {
+		return { content: [{
+			type: "text",
+			text: jsonText(lintProject(dir ?? process.cwd(), version$1))
+		}] };
+	});
+}
+
+//#endregion
+//#region src/mcp/server.ts
+async function startMcpServer() {
+	const server = new McpServer({
+		name: "wot-ui",
+		version
+	}, {
+		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,82 @@
+{
+  "name": "@wot-ui/cli",
+  "type": "module",
+  "version": "0.0.1-beta.10",
+  "description": "面向 wot-ui 的 CLI、MCP 与数据提取工具集",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/antfu",
+  "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",
+  "keywords": [],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "wot": "dist/index.mjs"
+  },
+  "files": [
+    "data",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
+    "@modelcontextprotocol/server": "^2.0.0-alpha.2",
+    "@vue/compiler-sfc": "^3.5.13",
+    "commander": "^14.0.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.6.1",
+    "@antfu/ni": "^28.0.0",
+    "@antfu/utils": "^9.3.0",
+    "@types/node": "^25.0.1",
+    "@vitest/coverage-v8": "4.0.15",
+    "baseline-browser-mapping": "^2.10.18",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.2",
+    "lint-staged": "^16.2.7",
+    "publint": "^0.3.16",
+    "simple-git-hooks": "^2.13.1",
+    "tinyexec": "^1.0.2",
+    "tsdown": "^0.17.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15",
+    "vitest-package-exports": "^0.1.1",
+    "yaml": "^2.8.2"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix --no-warn-ignored"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "extract": "tsx scripts/extract.ts",
+    "extract:cli": "pnpm extract",
+    "extract:clone": "rm -rf /tmp/open-wot-wot-ui && git clone --depth 1 https://github.com/wot-ui/wot-ui.git /tmp/open-wot-wot-ui && pnpm extract --wot-dir /tmp/open-wot-wot-ui --output data/v2.json",
+    "lint": "eslint",
+    "release": "bumpp",
+    "start": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage --coverage.reporter=lcov --coverage.reporter=text",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "typecheck:all": "pnpm typecheck",
+    "typecheck:cli": "pnpm typecheck"
+  }
+}