@csszyx/mcp-server 0.9.9

package/dist/index.mjs

@@ -0,0 +1,785 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import fs from 'node:fs';
+import { SPECIAL_VARIANTS, KNOWN_VARIANTS, PROPERTY_MAP, transform, SUGGESTION_MAP, BOOLEAN_SHORTHANDS } from '@csszyx/compiler';
+import { z } from 'zod';
+import { migrateSource, classNameToSzObject } from '@csszyx/cli';
+import { parseThemeBlocks, hasTokens } from '@csszyx/unplugin';
+
+function listPrompts() {
+  return [
+    {
+      name: "migrate_component",
+      description: "Migrate a Tailwind CSS component to use csszyx sz props. Paste your component code and get a transformed version with sz syntax.",
+      arguments: [
+        {
+          name: "code",
+          description: "The JSX/TSX component code to migrate from className to sz props",
+          required: true
+        }
+      ]
+    },
+    {
+      name: "create_component",
+      description: "Create a UI component using csszyx sz props. Describe the component you want and get production-ready code with proper sz syntax.",
+      arguments: [
+        {
+          name: "description",
+          description: 'Description of the component to create (e.g., "a responsive card with hover effects")',
+          required: true
+        }
+      ]
+    }
+  ];
+}
+function getPrompt(name, args) {
+  switch (name) {
+    case "migrate_component":
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `I want to migrate this Tailwind CSS component to use csszyx sz props.
+
+Here is the component code:
+
+\`\`\`tsx
+${args.code ?? "// paste your component here"}
+\`\`\`
+
+Please:
+1. Use the csszyx_migrate tool to transform the className attributes to sz props
+2. Review the result for any unrecognized classes
+3. Explain any changes and suggest improvements
+4. If there are dynamic className patterns (clsx, ternary, template literals), explain how sz handles them
+
+Key csszyx rules:
+- Numbers are bare: { p: 4 } \u2192 p-4
+- Colors are strings: { bg: 'blue-500' } \u2192 bg-blue-500
+- Color + opacity is an object: { bg: { color: 'blue-500', op: 50 } } \u2192 bg-blue-500/50
+- Variants nest: { hover: { bg: 'blue-700' } } \u2192 hover:bg-blue-700
+- Boolean sugar: { flex: true } \u2192 flex
+- Fractions stay native: { w: '1/2' } \u2192 w-1/2
+- Arbitrary values: { p: '5px' } \u2192 p-[5px]
+- CSS variables: { p: '--my-var' } \u2192 p-(--my-var)
+- Scope variants: { group: { hover: { bg: 'blue-700' } } } \u2192 group-hover:bg-blue-700 (also peer)
+- Conditional/feature variants: { has: { checked: { ... } } } \u2192 has-[:checked]:\u2026, { supports: { 'display:grid': { ... } } } \u2192 supports-[display:grid]:\u2026 (also not/data/aria)`
+            }
+          }
+        ]
+      };
+    case "create_component":
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `I want to create a React component using csszyx sz props.
+
+Component description: ${args.description ?? "a responsive card component"}
+
+Please:
+1. Generate a complete React component using sz props (NOT className/Tailwind)
+2. Use the csszyx_lookup tool to verify prop names for any CSS properties
+3. Include responsive breakpoints using nested variants: { md: { ... } }
+4. Include hover/focus states using nested variants: { hover: { ... } }
+5. Include dark mode support: { dark: { ... } }
+6. Use the csszyx_expand tool to verify the generated sz objects
+
+Key csszyx syntax:
+- <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
+- <div sz={{ flex: true, items: 'center', gap: 4 }} />
+- <div sz={{ md: { gridCols: 3 }, gridCols: 1, gap: 6 }} />
+- <div sz={{ dark: { bg: 'gray-900', color: 'white' } }} />
+- <div sz={{ bg: { color: 'blue-500', op: 50 }, w: '1/2' }} />  (color opacity + fraction)
+- <div sz={{ group: { hover: { bg: 'blue-700' } } }} />  (group/peer scope variants)`
+            }
+          }
+        ]
+      };
+    default:
+      throw new Error(`Unknown prompt: ${name}`);
+  }
+}
+
+const packageRoot = path.resolve(fileURLToPath(import.meta.url), "../../..");
+const LLMS_FULL_PATH = path.join(packageRoot, "llms-full.txt");
+const SETUP_GUIDE = `# csszyx setup
+
+Fastest path: run \`csszyx init\` (it does everything below). Manual steps:
+
+## 1. Install
+\`\`\`bash
+pnpm add csszyx @csszyx/runtime
+pnpm add -D @csszyx/types @csszyx/cli tailwindcss
+\`\`\`
+\`@csszyx/runtime\` and \`@csszyx/types\` MUST be DIRECT dependencies: the
+transform injects a bare \`import { _szMerge } from '@csszyx/runtime'\`, and
+\`@csszyx/types\` provides the \`sz\` JSX types. Strict package managers (pnpm) do
+not resolve them transitively.
+
+## 2. Bundler config
+### Vite
+\`\`\`ts
+import csszyx from 'csszyx/vite';
+import tailwindcss from '@tailwindcss/vite';
+export default defineConfig({ plugins: [...csszyx(), tailwindcss(), react()] });
+// Order matters: csszyx BEFORE tailwindcss BEFORE react.
+\`\`\`
+### Next.js \u2014 webpack (full parity, recommended)
+\`\`\`ts
+// next.config.ts
+export default {
+  webpack: (config) => {
+    config.plugins.push(require('@csszyx/unplugin/webpack').default());
+    return config;
+  },
+};
+// Run: next dev --webpack / next build --webpack
+\`\`\`
+### Next.js \u2014 Turbopack (experimental; no production class/CSS-var mangling)
+\`\`\`js
+// next.config.mjs
+import { csszyxTurbopack } from '@csszyx/unplugin/next';
+export default {
+  turbopack: csszyxTurbopack({}, { safelistOutputFile: '.csszyx/next-loader-classes.html' }),
+};
+\`\`\`
+- Do NOT set an \`as\` field on the loader rule \u2014 the helper omits it; an \`as\`
+  makes the loader output self-match into \`./X.tsx.tsx\` (Module not found).
+- Keep the safelist fresh: \`csszyx next watch\` (dev) and \`csszyx next prebuild\`
+  before \`next build --turbopack\`. Point Tailwind \`@source\` at the safelist file.
+
+## 3. Tailwind v4 entry
+\`\`\`css
+/* src/index.css */
+@import "tailwindcss";
+\`\`\`
+Import it from your app entry.
+
+## 4. TypeScript \u2014 enable the \`sz\` prop types
+Create \`csszyx-env.d.ts\` at the project root (kept in tsconfig \`include\`):
+\`\`\`ts
+/// <reference types="@csszyx/types/jsx" />
+\`\`\`
+Without it: \`Property 'sz' does not exist on type 'DetailedHTMLProps<...>'\`.
+
+## Usage
+\`\`\`tsx
+<div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
+\`\`\`
+`;
+function listResources() {
+  return [
+    {
+      uri: "csszyx://reference",
+      name: "CSSzyx Full Reference",
+      description: "Complete sz prop API reference \u2014 all property mappings, variant syntax, and examples",
+      mimeType: "text/plain"
+    },
+    {
+      uri: "csszyx://property-map",
+      name: "CSSzyx Property Map",
+      description: "JSON mapping of sz keys to Tailwind CSS utility prefixes (PROPERTY_MAP)",
+      mimeType: "application/json"
+    },
+    {
+      uri: "csszyx://variants",
+      name: "CSSzyx Variant List",
+      description: "JSON with `standard` variants (hover, focus, dark, sm, md, \u2026) and `parametric` scope variants (group, peer, has, not, data, aria, supports) that take a nested target",
+      mimeType: "application/json"
+    },
+    {
+      uri: "csszyx://setup",
+      name: "CSSzyx Setup Guide",
+      description: "How to install and wire csszyx into a project (Vite / Next.js webpack / Next.js Turbopack) \u2014 direct @csszyx/runtime + @csszyx/types deps, the sz JSX types (csszyx-env.d.ts), and the Turbopack no-`as` rule",
+      mimeType: "text/markdown"
+    }
+  ];
+}
+function readResource(uri) {
+  switch (uri) {
+    case "csszyx://reference": {
+      let content = "CSSzyx Full Reference \u2014 llms-full.txt not found. Use csszyx_lookup tool instead.";
+      try {
+        content = fs.readFileSync(LLMS_FULL_PATH, "utf-8");
+      } catch {
+      }
+      return {
+        contents: [{ uri, mimeType: "text/plain", text: content }]
+      };
+    }
+    case "csszyx://property-map":
+      return {
+        contents: [
+          {
+            uri,
+            mimeType: "application/json",
+            text: JSON.stringify(PROPERTY_MAP, null, 2)
+          }
+        ]
+      };
+    case "csszyx://variants":
+      return {
+        contents: [
+          {
+            uri,
+            mimeType: "application/json",
+            text: JSON.stringify(
+              {
+                standard: [...KNOWN_VARIANTS].sort(),
+                parametric: [...SPECIAL_VARIANTS].sort()
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    case "csszyx://setup":
+      return {
+        contents: [{ uri, mimeType: "text/markdown", text: SETUP_GUIDE }]
+      };
+    default:
+      throw new Error(`Unknown resource URI: ${uri}`);
+  }
+}
+
+const batchSchema = z.object({
+  items: z.array(z.record(z.any())).describe(
+    "Array of sz prop objects to expand. Example: [{ p: 4 }, { m: 2, bg: 'red-500' }]"
+  )
+});
+function handleBatch(input) {
+  const results = input.items.map((sz, index) => {
+    try {
+      const result = transform(sz);
+      return {
+        index,
+        className: result.className,
+        attributes: Object.keys(result.attributes).length > 0 ? result.attributes : void 0
+      };
+    } catch (err) {
+      return {
+        index,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  });
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            results,
+            totalItems: input.items.length,
+            successful: results.filter((r) => !("error" in r)).length
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const expandSchema = z.object({
+  sz: z.record(z.any()).describe(
+    "The sz prop object to expand. Example: { p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }"
+  )
+});
+function handleExpand(input) {
+  const result = transform(input.sz);
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            className: result.className,
+            attributes: result.attributes,
+            classCount: result.className.split(/\s+/).filter(Boolean).length
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const SEARCH_INDEX = /* @__PURE__ */ new Map();
+function addSearch(term, szKey) {
+  const lower = term.toLowerCase();
+  const existing = SEARCH_INDEX.get(lower) ?? [];
+  if (!existing.includes(szKey)) {
+    existing.push(szKey);
+    SEARCH_INDEX.set(lower, existing);
+  }
+}
+function toKebab(camel) {
+  return camel.replace(/([A-Z])/g, "-$1").toLowerCase();
+}
+for (const szKey of Object.keys(PROPERTY_MAP)) {
+  addSearch(szKey, szKey);
+  addSearch(toKebab(szKey), szKey);
+}
+for (const [cssAlias, szTarget] of Object.entries(SUGGESTION_MAP)) {
+  const primaryKey = szTarget.split(/[\s/(]/)[0];
+  if (primaryKey && (PROPERTY_MAP[primaryKey] !== void 0 || BOOLEAN_SHORTHANDS.has(primaryKey))) {
+    addSearch(cssAlias, primaryKey);
+    addSearch(toKebab(cssAlias), primaryKey);
+  }
+}
+for (const key of BOOLEAN_SHORTHANDS) {
+  addSearch(key, key);
+  addSearch(toKebab(key), key);
+}
+const EXAMPLES = {
+  bg: ["{ bg: 'blue-500' }", "{ bg: { color: 'blue-500', op: 50 } }"],
+  p: ["{ p: 4 }", "{ p: '5px' }"],
+  m: ["{ m: 4 }", "{ m: 'auto' }"],
+  px: ["{ px: 4 }"],
+  py: ["{ py: 2 }"],
+  mx: ["{ mx: 'auto' }"],
+  my: ["{ my: 4 }"],
+  w: ["{ w: 64 }", "{ w: 'full' }"],
+  h: ["{ h: 16 }", "{ h: 'screen' }"],
+  text: ["{ text: 'lg' }", "{ text: '2xl' }"],
+  color: ["{ color: 'white' }", "{ color: 'slate-500' }"],
+  fontWeight: ["{ fontWeight: 'bold' }", "{ fontWeight: 700 }"],
+  fontFamily: ["{ fontFamily: 'sans' }", "{ fontFamily: 'mono' }"],
+  flex: ["{ flex: true }", "{ flex: 'auto' }", "{ flex: 1 }"],
+  flexDir: ["{ flexDir: 'col' }", "{ flexDir: 'row' }"],
+  grid: ["{ grid: true }"],
+  gridCols: ["{ gridCols: 3 }", "{ gridCols: 'none' }"],
+  gap: ["{ gap: 4 }"],
+  items: ["{ items: 'center' }", "{ items: 'start' }"],
+  justify: ["{ justify: 'center' }", "{ justify: 'between' }"],
+  rounded: ["{ rounded: 'md' }", "{ rounded: 'full' }"],
+  shadow: ["{ shadow: 'md' }"],
+  border: ["{ border: true }", "{ border: 2 }"],
+  opacity: ["{ opacity: 50 }"],
+  z: ["{ z: 10 }", "{ z: 'auto' }"],
+  overflow: ["{ overflow: 'hidden' }"],
+  cursor: ["{ cursor: 'pointer' }"],
+  transition: ["{ transition: 'all' }", "{ transition: 'colors' }"],
+  duration: ["{ duration: 300 }"],
+  scale: ["{ scale: 150 }", "{ scale: 75 }"],
+  rotate: ["{ rotate: 45 }"],
+  leading: ["{ leading: 'tight' }", "{ leading: 7 }"],
+  tracking: ["{ tracking: 'wide' }"],
+  textAlign: ["{ textAlign: 'center' }"],
+  aspect: ["{ aspect: 'video' }", "{ aspect: 'square' }"],
+  blur: ["{ blur: true }", "{ blur: 'sm' }"],
+  grow: ["{ grow: true }"],
+  shrink: ["{ shrink: true }"]
+};
+const lookupSchema = z.object({
+  query: z.string().describe(
+    'CSS property name, sz key, or search term. Examples: "background-color", "bg", "padding", "flex-direction"'
+  )
+});
+function handleLookup(input) {
+  const query = input.query.trim().toLowerCase();
+  const seen = /* @__PURE__ */ new Set();
+  const results = [];
+  function pushResult(szKey) {
+    if (seen.has(szKey)) {
+      return;
+    }
+    seen.add(szKey);
+    results.push({
+      szKey,
+      tailwindPrefix: PROPERTY_MAP[szKey] ?? szKey,
+      examples: (EXAMPLES[szKey] ?? []).slice(0, 2)
+    });
+  }
+  const exact = SEARCH_INDEX.get(query);
+  if (exact) {
+    exact.forEach(pushResult);
+  }
+  if (results.length === 0) {
+    for (const [term, szKeys] of SEARCH_INDEX.entries()) {
+      if (results.length >= 5) {
+        break;
+      }
+      if (term.includes(query)) {
+        szKeys.forEach(pushResult);
+      }
+    }
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: results.length > 0 ? JSON.stringify(
+          { query: input.query, results: results.slice(0, 8) },
+          null,
+          2
+        ) : JSON.stringify(
+          {
+            query: input.query,
+            results: [],
+            message: `No mapping found for "${input.query}". Try a CSS property name (e.g. "padding") or sz key (e.g. "p").`
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const migrateSchema = z.object({
+  code: z.string().describe(
+    `JSX/TSX code snippet containing className attributes to transform. Example: '<div className="p-4 bg-blue-500" />'`
+  ),
+  customMap: z.record(z.unknown()).optional().describe(
+    'Parsed .csszyx-todo.json map. Values: sz object, Tailwind string, "sz:keep", "sz:remove", "sz:todo", null, or false.'
+  ),
+  injectTodos: z.boolean().optional().describe(
+    "If true, inserts {/* @sz-todo: ... */} comments above elements with unrecognized classes."
+  )
+});
+function handleMigrate(input) {
+  const result = migrateSource(input.code, "snippet.tsx", {
+    injectTodos: input.injectTodos,
+    customMap: input.customMap
+  });
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            code: result.code,
+            changed: result.changed,
+            stats: {
+              classNamesTransformed: result.stats.classNamesTransformed,
+              classNamesSkipped: result.stats.classNamesSkipped,
+              unrecognized: result.stats.classesUnrecognized.length > 0 ? result.stats.classesUnrecognized : void 0
+            },
+            warnings: result.warnings.length > 0 ? result.warnings : void 0,
+            potentiallyUnusedImports: result.potentiallyUnusedImports.length > 0 ? result.potentiallyUnusedImports : void 0
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const reverseSchema = z.object({
+  classes: z.string().describe(
+    'Tailwind CSS class string to convert. Example: "p-4 bg-blue-500 hover:text-white"'
+  )
+});
+function handleReverse(input) {
+  const { szObject, unrecognized } = classNameToSzObject(input.classes.trim());
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            szObject,
+            unrecognized: unrecognized.length > 0 ? unrecognized : void 0,
+            totalRecognized: Object.keys(szObject).length,
+            totalUnrecognized: unrecognized.length
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const themeSchema = z.object({
+  css: z.string().describe(
+    'CSS file content containing @theme blocks. Example: "@theme { --color-brand: #ff6b35; --font-display: \\"Cal Sans\\"; }"'
+  )
+});
+function handleTheme(input) {
+  const theme = parseThemeBlocks(input.css);
+  const totalVars = theme.colors.length + theme.spacings.length + theme.fonts.length + theme.radii.length + theme.shadows.length;
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            theme,
+            totalVariables: totalVars,
+            usage: hasTokens(theme) ? "Use these custom values in sz props. Example: { bg: 'brand' } for --color-brand-500" : "No @theme block found in the CSS content. Make sure your CSS contains @theme { --color-*: ...; }"
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const validateSchema = z.object({
+  sz: z.record(z.any()).describe('The sz prop object to validate. Example: { padding: 4, bg: "blue-500" }')
+});
+function handleValidate(input) {
+  const errors = [];
+  const warnings = [];
+  for (const key of Object.keys(input.sz)) {
+    if (SUGGESTION_MAP[key]) {
+      errors.push({
+        key,
+        message: `Unknown prop '${key}'. This is a CSS property name, not an sz key.`,
+        suggestion: `Use '${SUGGESTION_MAP[key]}' instead. Example: { ${SUGGESTION_MAP[key].split(/[\s/(]/)[0]}: ${JSON.stringify(input.sz[key])} }`
+      });
+      continue;
+    }
+    const isProperty = key in PROPERTY_MAP;
+    const isBoolean = BOOLEAN_SHORTHANDS.has(key);
+    const isVariant = KNOWN_VARIANTS.has(key);
+    const isSpecial = ["css", "@container", "*"].includes(key) || key.startsWith("@") || key.startsWith("[");
+    if (!isProperty && !isBoolean && !isVariant && !isSpecial) {
+      errors.push({
+        key,
+        message: `Unknown prop '${key}'. Not a valid sz key, variant, or special prop.`
+      });
+    }
+  }
+  let transformResult = null;
+  let transformError = null;
+  try {
+    transformResult = transform(input.sz);
+  } catch (err) {
+    transformError = err instanceof Error ? err.message : String(err);
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            valid: errors.length === 0 && !transformError,
+            errors: errors.length > 0 ? errors : void 0,
+            warnings: warnings.length > 0 ? warnings : void 0,
+            transformResult: transformResult ? {
+              className: transformResult.className,
+              classCount: transformResult.className.split(/\s+/).filter(Boolean).length
+            } : void 0,
+            transformError: transformError ?? void 0
+          },
+          null,
+          2
+        )
+      }
+    ]
+  };
+}
+
+const _require = createRequire(import.meta.url);
+const packageJson = _require(
+  path.resolve(fileURLToPath(import.meta.url), "../../package.json")
+);
+const VERSION = packageJson.version;
+const server = new Server(
+  {
+    name: "csszyx-mcp-server",
+    version: VERSION
+  },
+  {
+    capabilities: {
+      tools: {},
+      resources: {},
+      prompts: {}
+    }
+  }
+);
+const TOOLS = [
+  {
+    name: "csszyx_expand",
+    description: "Expand ONE csszyx sz object into a Tailwind CSS className string. Use this for a single component or quick lookup. For multiple objects at once, use csszyx_batch instead.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sz: {
+          type: "object",
+          description: "The sz prop object. Example: { p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }"
+        }
+      },
+      required: ["sz"]
+    }
+  },
+  {
+    name: "csszyx_reverse",
+    description: "Convert a Tailwind CSS class string into a csszyx sz object. Input: class string. Output: structured sz object + unrecognized classes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        classes: {
+          type: "string",
+          description: 'Tailwind CSS class string. Example: "p-4 bg-blue-500 hover:text-white"'
+        }
+      },
+      required: ["classes"]
+    }
+  },
+  {
+    name: "csszyx_validate",
+    description: "Validate a csszyx sz object for correctness. Detects unknown props, wrong types, deprecated CSS property names, and suggests fixes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sz: {
+          type: "object",
+          description: 'The sz prop object to validate. Example: { padding: 4, bg: "blue-500" }'
+        }
+      },
+      required: ["sz"]
+    }
+  },
+  {
+    name: "csszyx_lookup",
+    description: "Look up how a CSS property maps to csszyx sz syntax. Search by CSS property name, sz key, or keyword. Returns sz key, Tailwind prefix, and usage examples.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: 'CSS property name, sz key, or search term. Examples: "background-color", "bg", "padding", "flex-direction"'
+        }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "csszyx_migrate",
+    description: "Transform JSX/TSX code from Tailwind className attributes to csszyx sz props. Handles static strings, clsx/cn calls, ternary expressions, and template literals. Optionally pass a customMap (parsed .csszyx-todo.json) to resolve custom class names, and injectTodos to annotate unrecognized classes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        code: {
+          type: "string",
+          description: `JSX/TSX code snippet. Example: '<div className="p-4 bg-blue-500" />'`
+        },
+        customMap: {
+          type: "object",
+          description: 'Parsed .csszyx-todo.json map. Values per entry: sz object | Tailwind string | "sz:keep" | "sz:remove" | "sz:todo" | null | false.'
+        },
+        injectTodos: {
+          type: "boolean",
+          description: "If true, inserts {/* @sz-todo: ... */} comments above elements with unrecognized classes."
+        }
+      },
+      required: ["code"]
+    }
+  },
+  {
+    name: "csszyx_batch",
+    description: "Expand MULTIPLE sz objects into Tailwind class strings in one call. Use when you need to process an array of components. For a single object, use csszyx_expand instead.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        items: {
+          type: "array",
+          items: { type: "object" },
+          description: "Array of sz objects. Example: [{ p: 4 }, { m: 2, bg: 'red-500' }]"
+        }
+      },
+      required: ["items"]
+    }
+  },
+  {
+    name: "csszyx_theme",
+    description: "Extract @theme CSS custom properties from Tailwind CSS file content. Categorizes variables by type: colors, fonts, spacing, breakpoints.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        css: {
+          type: "string",
+          description: "CSS file content containing @theme blocks"
+        }
+      },
+      required: ["css"]
+    }
+  }
+];
+const TOOL_HANDLERS = {
+  csszyx_expand: { schema: expandSchema, handler: handleExpand },
+  csszyx_reverse: { schema: reverseSchema, handler: handleReverse },
+  csszyx_validate: { schema: validateSchema, handler: handleValidate },
+  csszyx_lookup: { schema: lookupSchema, handler: handleLookup },
+  csszyx_migrate: { schema: migrateSchema, handler: handleMigrate },
+  csszyx_batch: { schema: batchSchema, handler: handleBatch },
+  csszyx_theme: { schema: themeSchema, handler: handleTheme }
+};
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return { tools: TOOLS };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const entry = TOOL_HANDLERS[name];
+  if (!entry) {
+    throw new Error(
+      `Unknown tool: ${name}. Available: ${Object.keys(TOOL_HANDLERS).join(", ")}`
+    );
+  }
+  try {
+    const validated = entry.schema.parse(args);
+    return entry.handler(validated);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [{ type: "text", text: `Error in ${name}: ${message}` }],
+      isError: true
+    };
+  }
+});
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  return { resources: listResources() };
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  try {
+    return readResource(request.params.uri);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Resource error: ${message}`);
+  }
+});
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+  return { prompts: listPrompts() };
+});
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+  try {
+    return getPrompt(
+      request.params.name,
+      request.params.arguments ?? {}
+    );
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Prompt error: ${message}`);
+  }
+});
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`csszyx MCP Server v${VERSION} running on stdio`);
+  console.error(
+    `  Tools: ${TOOLS.length} | Resources: ${listResources().length} | Prompts: ${listPrompts().length}`
+  );
+}
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});