@csszyx/mcp-server 0.11.4 → 0.11.6

package/dist/index.d.mts

@@ -1 +1,204 @@
 
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
+/**
+ * @csszyx/mcp-server — Model Context Protocol server for csszyx.
+ *
+ * Enables AI agents (Cursor, Windsurf, Claude Desktop, Cline) to natively
+ * understand and generate csszyx sz props.
+ *
+ * Architecture follows Tier-1 Proxy patterns:
+ * - 7 Stateless Sandbox tools (no destructive edits)
+ * - 3 Reference Data Endpoints
+ * - Unified Single Source of Truth via @csszyx/compiler and @csszyx/unplugin
+ *
+ * @module
+ */
+
+declare const server: Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+declare const TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sz: {
+                type: "object";
+                description: string;
+            };
+            classes?: undefined;
+            query?: undefined;
+            code?: undefined;
+            customMap?: undefined;
+            injectTodos?: undefined;
+            items?: undefined;
+            css?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            classes: {
+                type: "string";
+                description: string;
+            };
+            sz?: undefined;
+            query?: undefined;
+            code?: undefined;
+            customMap?: undefined;
+            injectTodos?: undefined;
+            items?: undefined;
+            css?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: "string";
+                description: string;
+            };
+            sz?: undefined;
+            classes?: undefined;
+            code?: undefined;
+            customMap?: undefined;
+            injectTodos?: undefined;
+            items?: undefined;
+            css?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            code: {
+                type: "string";
+                description: string;
+            };
+            customMap: {
+                type: "object";
+                description: string;
+            };
+            injectTodos: {
+                type: "boolean";
+                description: string;
+            };
+            sz?: undefined;
+            classes?: undefined;
+            query?: undefined;
+            items?: undefined;
+            css?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            items: {
+                type: "array";
+                items: {
+                    type: "object";
+                };
+                description: string;
+            };
+            sz?: undefined;
+            classes?: undefined;
+            query?: undefined;
+            code?: undefined;
+            customMap?: undefined;
+            injectTodos?: undefined;
+            css?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            css: {
+                type: "string";
+                description: string;
+            };
+            sz?: undefined;
+            classes?: undefined;
+            query?: undefined;
+            code?: undefined;
+            customMap?: undefined;
+            injectTodos?: undefined;
+            items?: undefined;
+        };
+        required: string[];
+    };
+})[];
+/**
+ *
+ */
+/**
+ * Handle conventional `--version` / `--help` flags by printing diagnostics to
+ * stdout and exiting, WITHOUT starting the stdio server. Lets a host or a human
+ * separate a server/package failure from an MCP attachment failure without having
+ * to speak JSON-RPC. Returns true when a flag was handled (caller should not start
+ * the server).
+ *
+ * @param argv - process arguments (`process.argv.slice(2)`).
+ * @returns whether a flag was handled.
+ */
+declare function handleCliFlags(argv: string[]): boolean;
+/**
+ * Only start the stdio server when this module is the process entry point, not
+ * when a test imports it to exercise the handlers in-process. realpath so the
+ * bin symlink (node_modules/.bin/csszyx-mcp) still resolves to this module.
+ * @returns Whether this module was run directly.
+ */
+declare function isEntrypoint(): boolean;
+
+export { TOOLS, handleCliFlags, isEntrypoint, server };

package/dist/index.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
+import fs, { realpathSync } from 'node:fs';
 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 { sortStrings, SPECIAL_VARIANTS, KNOWN_VARIANTS, PROPERTY_MAP, transform, SUGGESTION_MAP, BOOLEAN_SHORTHANDS, REMOVED_BOOLEAN_SUGAR } from '@csszyx/compiler';
 import { z } from 'zod';
 import { migrateSource, classNameToSzObject } from '@csszyx/cli';
@@ -306,8 +306,7 @@ function handleBatch(input) {
       const result = transform(sz);
       return {
         index,
-        className: result.className,
-        attributes: Object.keys(result.attributes).length > 0 ? result.attributes : void 0
+        className: result.className
       };
     } catch (err) {
       return {
@@ -348,7 +347,6 @@ function handleExpand(input) {
         text: JSON.stringify(
           {
             className: result.className,
-            attributes: result.attributes,
             classCount: result.className.split(/\s+/).filter(Boolean).length
           },
           null,
@@ -613,10 +611,18 @@ function handleValidate(input) {
   }
   let transformResult = null;
   let transformError = null;
+  const originalWarn = console.warn;
+  console.warn = (...args) => {
+    warnings.push(
+      args.map((arg) => typeof arg === "string" ? arg : JSON.stringify(arg)).join(" ")
+    );
+  };
   try {
     transformResult = transform(input.sz);
   } catch (err) {
     transformError = err instanceof Error ? err.message : String(err);
+  } finally {
+    console.warn = originalWarn;
   }
   return {
     content: [
@@ -861,7 +867,20 @@ async function main() {
     `  Tools: ${TOOLS.length} | Resources: ${listResources().length} | Prompts: ${listPrompts().length}`
   );
 }
-main().catch((error) => {
-  console.error("Server error:", error);
-  process.exit(1);
-});
+function isEntrypoint() {
+  const invoked = process.argv[1];
+  if (!invoked) return false;
+  try {
+    return realpathSync(invoked) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+if (isEntrypoint()) {
+  main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+  });
+}
+
+export { TOOLS, handleCliFlags, isEntrypoint, server };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/mcp-server",
-  "version": "0.11.4",
+  "version": "0.11.6",
   "description": "Model Context Protocol (MCP) server for csszyx — enables AI agents to understand and generate sz props",
   "license": "MIT",
   "type": "module",
@@ -30,9 +30,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.23.8",
-    "@csszyx/compiler": "0.11.4",
-    "@csszyx/cli": "0.11.4",
-    "@csszyx/unplugin": "0.11.4"
+    "@csszyx/compiler": "0.11.6",
+    "@csszyx/cli": "0.11.6",
+    "@csszyx/unplugin": "0.11.6"
   },
   "devDependencies": {
     "typescript": "^6.0.3",