@biolab/talk-to-figma 0.4.0 → 0.5.0

package/README.md

@@ -145,10 +145,18 @@ https://cdn.jsdelivr.net/npm/@biolab/talk-to-figma@latest/figma-plugin/figma-plu
 bun install      # Install dependencies
 bun run build    # Build MCP server + relay (tsup → dist/)
 bun run dev      # Build in watch mode
-bun socket       # Start WebSocket relay (Bun-native, dev only)
 ```
 
-For local dev, point your MCP config to the built CLI:
+### Start the relay (pick one)
+
+```bash
+bun socket                # Bun-native relay (dev only, uses src/socket.ts)
+node dist/cli.js --relay  # Node-compatible relay (same as npm package)
+```
+
+Both run on port 3055 by default (`PORT` env to override).
+
+### Point MCP config to local build
 
 ```json
 {
@@ -161,12 +169,6 @@ For local dev, point your MCP config to the built CLI:
 }
 ```
 
-Start the relay locally:
-
-```bash
-node dist/cli.js --relay
-```
-
 ## Project Structure
 
 - `src/cli.ts` - CLI entry point (routes `--relay` flag)

package/dist/cli.cjs

@@ -1510,6 +1510,67 @@ ${failedResults.map(
         }
       }
     );
+    server.tool(
+      "create_component",
+      "Convert an existing node (typically a frame) into a reusable Figma Component. The node must not be nested inside another component, component set, or instance.",
+      {
+        nodeId: import_zod.z.string().describe("ID of the node to convert into a component")
+      },
+      async ({ nodeId }) => {
+        try {
+          const result = await sendCommandToFigma("create_component", { nodeId });
+          const typedResult = result;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Created component "${typedResult.name}" with ID: ${typedResult.id}, key: ${typedResult.key}`
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error creating component: ${error instanceof Error ? error.message : String(error)}`
+              }
+            ]
+          };
+        }
+      }
+    );
+    server.tool(
+      "create_component_set",
+      "Combine multiple Component nodes into a single ComponentSet (variant component). All provided nodes must already be Components (use create_component first). Components should use naming like 'property=value, property=value' for Figma to auto-detect variant properties.",
+      {
+        nodeIds: import_zod.z.array(import_zod.z.string()).min(1).describe("Array of Component node IDs to combine into a variant set"),
+        parentId: import_zod.z.string().optional().describe("Optional parent node ID. Defaults to the first component's parent.")
+      },
+      async ({ nodeIds, parentId }) => {
+        try {
+          const result = await sendCommandToFigma("create_component_set", { nodeIds, parentId });
+          const typedResult = result;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Created component set "${typedResult.name}" with ID: ${typedResult.id}, containing ${typedResult.childCount} variants`
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error creating component set: ${error instanceof Error ? error.message : String(error)}`
+              }
+            ]
+          };
+        }
+      }
+    );
     server.tool(
       "get_instance_overrides",
       "Get all override properties from a selected component instance. These overrides can be applied to other instances, which will swap them to match the source component.",