@biolab/talk-to-figma 0.5.0 → 0.7.0

package/README.md

@@ -55,128 +55,3 @@ https://cdn.jsdelivr.net/npm/@biolab/talk-to-figma@latest/figma-plugin/figma-plu
 1. Open the plugin in Figma and join a channel
 2. In your AI agent, call `join_channel` with the same channel name
 3. Start using the MCP tools
-
-## MCP Tools
-
-### Document & Selection
-
-- `get_document_info` - Get document info
-- `get_selection` - Get current selection
-- `read_my_design` - Get detailed selection info with all node details
-- `get_node_info` - Get info about a specific node
-- `get_nodes_info` - Get info about multiple nodes
-- `set_focus` - Focus and scroll to a node
-- `set_selections` - Select multiple nodes
-
-### Creating Elements
-
-- `create_rectangle` - Create a rectangle
-- `create_frame` - Create a frame with auto-layout support
-- `create_text` - Create a text node
-
-### Modifying Elements
-
-- `set_fill_color` - Set fill color (RGBA 0-1)
-- `set_stroke_color` - Set stroke color and weight
-- `set_corner_radius` - Set corner radius (per-corner support)
-- `set_text_content` - Set text content
-- `set_multiple_text_contents` - Batch update text nodes
-- `move_node` - Move a node
-- `resize_node` - Resize a node
-- `clone_node` - Clone a node
-- `delete_node` / `delete_multiple_nodes` - Delete nodes
-
-### Auto Layout
-
-- `set_layout_mode` - Set layout mode (NONE, HORIZONTAL, VERTICAL)
-- `set_padding` - Set frame padding
-- `set_axis_align` - Set axis alignment
-- `set_layout_sizing` - Set sizing mode (FIXED, HUG, FILL)
-- `set_item_spacing` - Set spacing between children
-
-### Variables
-
-- `get_local_variables` - Get all local variables with values per mode
-- `get_local_variable_collections` - Get variable collections with modes
-- `get_variable_by_id` - Get a specific variable
-- `create_variable_collection` - Create a variable collection
-- `create_variable` - Create a variable
-- `set_variable_value` - Set variable value for a mode
-- `set_variable_mode_name` - Rename a mode
-- `set_variable_binding` - Bind a variable to a node property
-
-### Components & Styles
-
-- `get_styles` - Get local styles
-- `get_local_components` - Get local components
-- `create_component_instance` - Instantiate a component
-- `get_instance_overrides` / `set_instance_overrides` - Copy/apply instance overrides
-- `get_team_library_components` - Get team library components
-- `get_team_library_variables` - Get team library variables
-- `import_variable_by_key` - Import a variable from team library
-
-### Scanning
-
-- `scan_text_nodes` - Scan text nodes (chunked for large designs)
-- `scan_nodes_by_types` - Scan nodes by type
-
-### Annotations
-
-- `get_annotations` - Get annotations
-- `set_annotation` / `set_multiple_annotations` - Create/update annotations
-
-### Prototyping & Connections
-
-- `get_reactions` - Get prototype reactions
-- `set_default_connector` - Set default connector style
-- `create_connections` - Create connector lines between nodes
-
-### Export
-
-- `export_node_as_image` - Export as PNG, JPG, SVG, or PDF
-
-### Connection
-
-- `join_channel` - Join a channel to communicate with Figma
-
-## Local Development
-
-```bash
-bun install      # Install dependencies
-bun run build    # Build MCP server + relay (tsup → dist/)
-bun run dev      # Build in watch mode
-```
-
-### 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
-{
-  "mcpServers": {
-    "TalkToFigma": {
-      "command": "node",
-      "args": ["/path-to-repo/dist/cli.js"]
-    }
-  }
-}
-```
-
-## Project Structure
-
-- `src/cli.ts` - CLI entry point (routes `--relay` flag)
-- `src/talk_to_figma_mcp/server.ts` - MCP server
-- `src/relay.ts` - WebSocket relay (Node-compatible, bundled in npm package)
-- `src/socket.ts` - WebSocket relay (Bun-native, local dev only)
-- `src/cursor_mcp_plugin/` - Figma plugin (`code.js`, `ui.html`, `manifest.json`)
-
-## License
-
-MIT

package/dist/cli.cjs

@@ -1058,6 +1058,110 @@ var init_server = __esm({
         }
       }
     );
+    server.tool(
+      "set_font_family",
+      "Set the font family of an existing text node in Figma",
+      {
+        nodeId: import_zod.z.string().describe("The ID of the text node to modify"),
+        fontFamily: import_zod.z.string().describe("Font family name (e.g. 'Inter', 'Roboto', 'Arial')"),
+        fontStyle: import_zod.z.string().optional().describe("Font style (e.g. 'Regular', 'Bold', 'Italic'). Defaults to 'Regular'")
+      },
+      async ({ nodeId, fontFamily, fontStyle }) => {
+        try {
+          const result = await sendCommandToFigma("set_font_family", {
+            nodeId,
+            fontFamily,
+            fontStyle: fontStyle || "Regular"
+          });
+          const typedResult = result;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Updated font family of node "${typedResult.name}" to "${typedResult.fontName.family} ${typedResult.fontName.style}"`
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error setting font family: ${error instanceof Error ? error.message : String(error)}`
+              }
+            ]
+          };
+        }
+      }
+    );
+    server.tool(
+      "set_font_size",
+      "Set the font size of an existing text node in Figma",
+      {
+        nodeId: import_zod.z.string().describe("The ID of the text node to modify"),
+        fontSize: import_zod.z.number().min(1).describe("Font size in pixels")
+      },
+      async ({ nodeId, fontSize }) => {
+        try {
+          const result = await sendCommandToFigma("set_font_size", {
+            nodeId,
+            fontSize
+          });
+          const typedResult = result;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Updated font size of node "${typedResult.name}" to ${typedResult.fontSize}px`
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error setting font size: ${error instanceof Error ? error.message : String(error)}`
+              }
+            ]
+          };
+        }
+      }
+    );
+    server.tool(
+      "set_font_weight",
+      "Set the font weight of an existing text node in Figma. Maps numeric weight to font style (100=Thin, 300=Light, 400=Regular, 500=Medium, 600=Semi Bold, 700=Bold, 800=Extra Bold, 900=Black)",
+      {
+        nodeId: import_zod.z.string().describe("The ID of the text node to modify"),
+        fontWeight: import_zod.z.number().min(100).max(900).describe("Font weight (100-900)")
+      },
+      async ({ nodeId, fontWeight }) => {
+        try {
+          const result = await sendCommandToFigma("set_font_weight", {
+            nodeId,
+            fontWeight
+          });
+          const typedResult = result;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Updated font weight of node "${typedResult.name}" to ${fontWeight} (${typedResult.fontName.style})`
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error setting font weight: ${error instanceof Error ? error.message : String(error)}`
+              }
+            ]
+          };
+        }
+      }
+    );
     server.tool(
       "get_styles",
       "Get all styles from the current Figma document",