motionwind-mcp 2.1.0

package/README.md

@@ -0,0 +1,27 @@
+# motionwind-mcp v2
+
+MCP tools generated from Motionwind's shared syntax registry.
+
+```json
+{
+  "mcpServers": {
+    "motionwind": {
+      "command": "npx",
+      "args": ["-y", "motionwind-mcp@2"]
+    }
+  }
+}
+```
+
+Tools:
+
+- `validate_motionwind` returns unknown tokens, duplicates, diagnostics, and
+  parsed output.
+- `explain_motionwind` explains each token.
+- `optimize_motionwind` sorts classes and reports problems.
+- `generate_motionwind` produces React, Vue, JavaScript, or React Native code.
+
+The `motionwind://syntax` resource exposes the machine-readable definition
+registry used by the parser and developer tools.
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import * as motionwind_core from 'motionwind-core';
+
+declare function validateClasses(className: string): {
+    valid: boolean;
+    unknown: string[];
+    duplicates: motionwind_core.DuplicateProp[];
+    diagnostics: motionwind_core.MotionwindDiagnostic[];
+    parsed: motionwind_core.ParsedResult;
+};
+declare function explainClasses(className: string): {
+    token: string;
+    recognized: boolean;
+    motion: motionwind_core.ParsedResult | undefined;
+    passthrough: string | undefined;
+}[];
+declare function optimizeClasses(className: string): {
+    className: string;
+    duplicates: motionwind_core.DuplicateProp[];
+    unknown: string[];
+};
+declare function generateExample(input: {
+    className: string;
+    tag?: string;
+    text?: string;
+    target?: "react" | "vue" | "javascript" | "react-native";
+}): string;
+declare function syntaxManifest(): readonly motionwind_core.SyntaxDefinition[];
+
+export { explainClasses, generateExample, optimizeClasses, syntaxManifest, validateClasses };

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import {
+  McpServer,
+  ResourceTemplate
+} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/tools.ts
+import {
+  MOTIONWIND_SYNTAX_REGISTRY,
+  analyzeClassName,
+  parseMotionClasses,
+  sortMotionClasses
+} from "motionwind-core";
+import { generateMotionCode } from "motionwind-react/tooling";
+function validateClasses(className) {
+  const parsed = parseMotionClasses(className);
+  const analysis = analyzeClassName(className);
+  return {
+    valid: analysis.unknown.length === 0,
+    unknown: analysis.unknown,
+    duplicates: analysis.duplicates,
+    diagnostics: parsed.diagnostics,
+    parsed
+  };
+}
+function explainClasses(className) {
+  const tokens = className.split(/\s+/).filter(Boolean);
+  return tokens.map((token) => {
+    const parsed = parseMotionClasses(token);
+    return {
+      token,
+      recognized: parsed.hasMotion || !token.startsWith("animate-"),
+      motion: parsed.hasMotion ? parsed : void 0,
+      passthrough: parsed.tailwindClasses || void 0
+    };
+  });
+}
+function optimizeClasses(className) {
+  const analysis = analyzeClassName(className);
+  return {
+    className: sortMotionClasses(className),
+    duplicates: analysis.duplicates,
+    unknown: analysis.unknown
+  };
+}
+function generateExample(input) {
+  return generateMotionCode(input.tag ?? "div", input.className, {
+    text: input.text,
+    target: input.target
+  });
+}
+function syntaxManifest() {
+  return MOTIONWIND_SYNTAX_REGISTRY;
+}
+
+// src/index.ts
+var server = new McpServer({ name: "motionwind", version: "2.0.0" });
+var text = (value) => ({
+  content: [{ type: "text", text: JSON.stringify(value, null, 2) }]
+});
+server.tool(
+  "validate_motionwind",
+  "Validate Motionwind classes and return diagnostics and parsed Motion output.",
+  { className: z.string() },
+  async ({ className }) => text(validateClasses(className))
+);
+server.tool(
+  "explain_motionwind",
+  "Explain each Motionwind token without changing source code.",
+  { className: z.string() },
+  async ({ className }) => text(explainClasses(className))
+);
+server.tool(
+  "optimize_motionwind",
+  "Canonically sort Motionwind classes and report duplicates or unknown tokens.",
+  { className: z.string() },
+  async ({ className }) => text(optimizeClasses(className))
+);
+server.tool(
+  "generate_motionwind",
+  "Generate framework code from Motionwind classes.",
+  {
+    className: z.string(),
+    tag: z.string().optional(),
+    text: z.string().optional(),
+    target: z.enum(["react", "vue", "javascript", "react-native"]).optional()
+  },
+  async (input) => text({ code: generateExample(input) })
+);
+server.resource(
+  "motionwind-syntax",
+  new ResourceTemplate("motionwind://syntax", { list: void 0 }),
+  async (uri) => ({
+    contents: [
+      {
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(syntaxManifest())
+      }
+    ]
+  })
+);
+var transport = new StdioServerTransport();
+await server.connect(transport);
+export {
+  explainClasses,
+  generateExample,
+  optimizeClasses,
+  syntaxManifest,
+  validateClasses
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/tools.ts"],"sourcesContent":["import {\n  McpServer,\n  ResourceTemplate,\n} from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport {\n  explainClasses,\n  generateExample,\n  optimizeClasses,\n  syntaxManifest,\n  validateClasses,\n} from \"./tools.js\";\n\nexport {\n  explainClasses,\n  generateExample,\n  optimizeClasses,\n  syntaxManifest,\n  validateClasses,\n} from \"./tools.js\";\n\nconst server = new McpServer({ name: \"motionwind\", version: \"2.0.0\" });\nconst text = (value: unknown) => ({\n  content: [{ type: \"text\" as const, text: JSON.stringify(value, null, 2) }],\n});\n\nserver.tool(\n  \"validate_motionwind\",\n  \"Validate Motionwind classes and return diagnostics and parsed Motion output.\",\n  { className: z.string() },\n  async ({ className }) => text(validateClasses(className)),\n);\n\nserver.tool(\n  \"explain_motionwind\",\n  \"Explain each Motionwind token without changing source code.\",\n  { className: z.string() },\n  async ({ className }) => text(explainClasses(className)),\n);\n\nserver.tool(\n  \"optimize_motionwind\",\n  \"Canonically sort Motionwind classes and report duplicates or unknown tokens.\",\n  { className: z.string() },\n  async ({ className }) => text(optimizeClasses(className)),\n);\n\nserver.tool(\n  \"generate_motionwind\",\n  \"Generate framework code from Motionwind classes.\",\n  {\n    className: z.string(),\n    tag: z.string().optional(),\n    text: z.string().optional(),\n    target: z.enum([\"react\", \"vue\", \"javascript\", \"react-native\"]).optional(),\n  },\n  async (input) => text({ code: generateExample(input) }),\n);\n\nserver.resource(\n  \"motionwind-syntax\",\n  new ResourceTemplate(\"motionwind://syntax\", { list: undefined }),\n  async (uri) => ({\n    contents: [\n      {\n        uri: uri.href,\n        mimeType: \"application/json\",\n        text: JSON.stringify(syntaxManifest()),\n      },\n    ],\n  }),\n);\n\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n","import {\n  MOTIONWIND_SYNTAX_REGISTRY,\n  analyzeClassName,\n  parseMotionClasses,\n  sortMotionClasses,\n} from \"motionwind-core\";\nimport { generateMotionCode } from \"motionwind-react/tooling\";\n\nexport function validateClasses(className: string) {\n  const parsed = parseMotionClasses(className);\n  const analysis = analyzeClassName(className);\n  return {\n    valid: analysis.unknown.length === 0,\n    unknown: analysis.unknown,\n    duplicates: analysis.duplicates,\n    diagnostics: parsed.diagnostics,\n    parsed,\n  };\n}\n\nexport function explainClasses(className: string) {\n  const tokens = className.split(/\\s+/).filter(Boolean);\n  return tokens.map((token) => {\n    const parsed = parseMotionClasses(token);\n    return {\n      token,\n      recognized: parsed.hasMotion || !token.startsWith(\"animate-\"),\n      motion: parsed.hasMotion ? parsed : undefined,\n      passthrough: parsed.tailwindClasses || undefined,\n    };\n  });\n}\n\nexport function optimizeClasses(className: string) {\n  const analysis = analyzeClassName(className);\n  return {\n    className: sortMotionClasses(className),\n    duplicates: analysis.duplicates,\n    unknown: analysis.unknown,\n  };\n}\n\nexport function generateExample(input: {\n  className: string;\n  tag?: string;\n  text?: string;\n  target?: \"react\" | \"vue\" | \"javascript\" | \"react-native\";\n}) {\n  return generateMotionCode(input.tag ?? \"div\", input.className, {\n    text: input.text,\n    target: input.target,\n  });\n}\n\nexport function syntaxManifest() {\n  return MOTIONWIND_SYNTAX_REGISTRY;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "motionwind-mcp",
+  "version": "2.1.0",
+  "type": "module",
+  "description": "MCP tools for generating, validating, explaining, and optimizing Motionwind classes.",
+  "license": "MIT",
+  "bin": {
+    "motionwind-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "lint": "eslint --max-warnings 0",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "motionwind-core": "^2.1.0",
+    "motionwind-react": "^2.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "*",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.39.1",
+    "tsup": "^8.5.0",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}