@dannote/figma-use 0.5.8 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-01-18
+
+### Added
+
+- **`node bounds`** — get node position, size, center point, edges
+- **`path` commands** — vector path manipulation:
+  - `path get <id>` — read SVG path data
+  - `path set <id> "M..."` — replace path data
+  - `path move <id> --dx --dy` — translate all points
+  - `path scale <id> --factor` — scale from center
+  - `path flip <id> --axis x|y` — mirror horizontally/vertically
+- Uses [svgpath](https://github.com/fontello/svgpath) library for path transformations
+- Path command tests
+
+## [0.5.9] - 2026-01-18
+
+### Changed
+
+- Version now read from package.json instead of hardcoded
+
 ## [0.5.8] - 2026-01-18
 
 ### Added

package/README.md

@@ -230,11 +230,23 @@ figma-use set effect <id> --type DROP_SHADOW --radius 10 --color "#00000040"
 figma-use node get <id>              # Get node properties
 figma-use node tree                  # Page structure as readable tree
 figma-use node children <id>         # List children
+figma-use node bounds <id>           # Position, size, center point
 figma-use find --name "Button"       # Find by name
 figma-use find --type FRAME          # Find by type
 figma-use selection get              # Current selection
 ```
 
+### Vector Paths
+
+```bash
+figma-use create vector --x 0 --y 0 --path "M 0 0 L 100 50 L 0 100 Z" --fill "#F00"
+figma-use path get <id>              # Read path data
+figma-use path set <id> "M 0 0 ..."  # Replace path
+figma-use path move <id> --dx 10 --dy -5   # Translate points
+figma-use path scale <id> --factor 1.5     # Scale from center
+figma-use path flip <id> --axis x          # Mirror horizontally
+```
+
 ### Export
 
 ```bash

package/SKILL.md

@@ -315,3 +315,76 @@ figma-use set text "I123:456;789:10" "New text"  # Modify text inside instance
 figma-use find --type FRAME 2>&1 | grep "stroke: #EF4444"  # Red border
 figma-use find --type TEXT 2>&1 | grep "Bold"              # Bold text
 ```
+
+---
+
+## Vector Drawing
+
+Work iteratively: bounds → draw → screenshot → adjust → repeat.
+
+### Path Commands
+
+```bash
+figma-use node bounds <id>                    # Position, size, center
+figma-use create vector --path "M 0 0 L 100 50 Z" --fill "#F00"
+figma-use path get <id>                       # Read path data
+figma-use path set <id> "M 0 0 L 100 100 Z"   # Replace path
+figma-use path move <id> --dx 10 --dy -5      # Translate points
+figma-use path scale <id> --factor 1.5        # Scale from center
+figma-use path flip <id> --axis x             # Mirror horizontally
+figma-use path flip <id> --axis y             # Mirror vertically
+```
+
+### SVG Path Syntax
+
+```
+M x y       Move to          L x y       Line to
+H x         Horizontal to    V y         Vertical to
+C x1 y1 x2 y2 x y   Cubic Bezier    Q x1 y1 x y   Quadratic Bezier
+Z           Close path
+```
+
+### Iterative Workflow
+
+```bash
+# 1. Create canvas, get bounds
+figma-use create frame --width 300 --height 300 --fill "#F0F4FF" --name "Drawing"
+figma-use node bounds 123:456
+
+# 2. Draw shape with Bezier curves
+figma-use create vector --path "M 80 180 C 50 180 50 140 80 140 C 180 130 200 150 180 195 Z" --fill "#FFD700" --parent 123:456
+
+# 3. Screenshot to verify
+figma-use export node 123:456 --output /tmp/check.png
+
+# 4. Adjust if needed
+figma-use path scale 123:457 --factor 0.9
+figma-use path move 123:457 --dx 20 --dy 0
+
+# 5. Get bounds of first shape, position next relative to it
+figma-use node bounds 123:457
+```
+
+### Common Shapes
+
+```bash
+# Triangle
+figma-use create vector --path "M 50 0 L 100 100 L 0 100 Z" --fill "#F00"
+
+# Star
+figma-use create vector --path "M 50 0 L 61 35 L 98 35 L 68 57 L 79 91 L 50 70 L 21 91 L 32 57 L 2 35 L 39 35 Z" --fill "#FFD700"
+
+# Heart
+figma-use create vector --path "M 50 90 C 20 60 0 30 25 10 C 40 0 50 10 50 25 C 50 10 60 0 75 10 C 100 30 80 60 50 90 Z" --fill "#E11D48"
+
+# Arrow right
+figma-use create vector --path "M 0 20 L 60 20 L 60 10 L 80 25 L 60 40 L 60 30 L 0 30 Z" --fill "#000"
+```
+
+### Complex Illustrations
+
+For intricate artwork, import SVG instead:
+
+```bash
+figma-use import --svg "$(cat icon.svg)"
+```

package/dist/cli/index.js

@@ -1106,6 +1106,15 @@ function formatResult(result, context) {
     if ("deleted" in obj && obj.deleted !== undefined) {
       return formatDeleted({ deleted: Boolean(obj.deleted) });
     }
+    if (context === "path" && "paths" in obj) {
+      const paths = obj.paths;
+      return ok("Path updated") + `
+` + paths.map((p) => dim(p.data)).join(`
+`);
+    }
+    if ("updated" in obj && obj.updated === true) {
+      return ok("Updated");
+    }
     if (context === "export" || "data" in obj) {
       return formatExport({ data: String(obj.data ?? ""), filename: obj.filename });
     }
@@ -22779,19 +22788,20 @@ __export(exports_commands, {
   variable: () => variable_default,
   style: () => style_default,
   status: () => status_default,
-  set: () => set_default,
+  set: () => set_default2,
   selection: () => selection_default,
   render: () => render_default,
   proxy: () => proxy_default,
   profile: () => profile_default,
   plugin: () => plugin_default,
+  path: () => path_default,
   page: () => page_default2,
   node: () => node_default,
   me: () => me_default,
   mcp: () => mcp_default,
   import: () => import_default,
   group: () => group_default,
-  get: () => get_default2,
+  get: () => get_default3,
   font: () => font_default2,
   find: () => find_default,
   file: () => file_default,
@@ -29200,6 +29210,31 @@ var to_component_default = defineCommand({
   }
 });
 
+// packages/cli/src/commands/node/bounds.ts
+var bounds_default = defineCommand({
+  meta: { description: "Get node bounding box" },
+  args: {
+    id: { type: "positional", description: "Node ID", required: true },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const result = await sendCommand("node-bounds", { id: args.id });
+      if (args.json) {
+        printResult(result, true);
+      } else {
+        const b3 = result;
+        console.log(`x: ${b3.x}, y: ${b3.y}`);
+        console.log(`width: ${b3.width}, height: ${b3.height}`);
+        console.log(`center: (${b3.centerX}, ${b3.centerY})`);
+        console.log(`right: ${b3.right}, bottom: ${b3.bottom}`);
+      }
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
 // packages/cli/src/commands/node/index.ts
 var node_default = defineCommand({
   meta: { description: "Node operations" },
@@ -29213,7 +29248,138 @@ var node_default = defineCommand({
     move: move_default,
     resize: resize_default,
     "set-parent": set_parent_default,
-    "to-component": to_component_default
+    "to-component": to_component_default,
+    bounds: bounds_default
+  }
+});
+// packages/cli/src/commands/path/get.ts
+var get_default2 = defineCommand({
+  meta: { description: "Get vector path data" },
+  args: {
+    id: { type: "positional", description: "Vector node ID", required: true },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const result = await sendCommand("path-get", { id: args.id });
+      if (args.json) {
+        printResult(result, true);
+      } else {
+        for (const p4 of result.paths) {
+          console.log(p4.data);
+        }
+      }
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
+// packages/cli/src/commands/path/set.ts
+init_output();
+var set_default = defineCommand({
+  meta: { description: "Set vector path data" },
+  args: {
+    id: { type: "positional", description: "Vector node ID", required: true },
+    path: { type: "positional", description: "SVG path data", required: true },
+    windingRule: { type: "string", description: "Winding rule (NONZERO or EVENODD)", default: "NONZERO" },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const result = await sendCommand("path-set", {
+        id: args.id,
+        path: args.path,
+        windingRule: args.windingRule
+      });
+      printResult(result, args.json, "update");
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
+// packages/cli/src/commands/path/move.ts
+init_output();
+var move_default2 = defineCommand({
+  meta: { description: "Move all path points by offset" },
+  args: {
+    id: { type: "positional", description: "Vector node ID", required: true },
+    dx: { type: "string", description: "X offset", default: "0" },
+    dy: { type: "string", description: "Y offset", default: "0" },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const result = await sendCommand("path-move", {
+        id: args.id,
+        dx: Number(args.dx),
+        dy: Number(args.dy)
+      });
+      printResult(result, args.json, "path");
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
+// packages/cli/src/commands/path/scale.ts
+init_output();
+var scale_default = defineCommand({
+  meta: { description: "Scale path from center" },
+  args: {
+    id: { type: "positional", description: "Vector node ID", required: true },
+    factor: { type: "string", description: "Scale factor (e.g., 1.5 for 150%)", required: true },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const result = await sendCommand("path-scale", {
+        id: args.id,
+        factor: Number(args.factor)
+      });
+      printResult(result, args.json, "path");
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
+// packages/cli/src/commands/path/flip.ts
+init_output();
+var flip_default = defineCommand({
+  meta: { description: "Flip path horizontally or vertically" },
+  args: {
+    id: { type: "positional", description: "Vector node ID", required: true },
+    axis: { type: "string", description: "Axis to flip (x or y)", required: true },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      if (args.axis !== "x" && args.axis !== "y") {
+        console.error('Axis must be "x" or "y"');
+        process.exit(1);
+      }
+      const result = await sendCommand("path-flip", {
+        id: args.id,
+        axis: args.axis
+      });
+      printResult(result, args.json, "path");
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
+// packages/cli/src/commands/path/index.ts
+var path_default = defineCommand({
+  meta: { description: "Vector path operations" },
+  subCommands: {
+    get: get_default2,
+    set: set_default,
+    move: move_default2,
+    scale: scale_default,
+    flip: flip_default
   }
 });
 // packages/cli/src/commands/create/rect.ts
@@ -30115,7 +30281,7 @@ var minmax_default = defineCommand({
 });
 
 // packages/cli/src/commands/set/index.ts
-var set_default = defineCommand({
+var set_default2 = defineCommand({
   meta: { description: "Set node properties" },
   subCommands: {
     fill: fill_default,
@@ -30194,7 +30360,7 @@ var styles_default = defineCommand({
 });
 
 // packages/cli/src/commands/get/index.ts
-var get_default2 = defineCommand({
+var get_default3 = defineCommand({
   meta: { description: "Get document info" },
   subCommands: {
     pages: pages_default,
@@ -30203,7 +30369,7 @@ var get_default2 = defineCommand({
   }
 });
 // packages/cli/src/commands/selection/get.ts
-var get_default3 = defineCommand({
+var get_default4 = defineCommand({
   meta: { description: "Get selected nodes" },
   args: {
     json: { type: "boolean", description: "Output as JSON" }
@@ -30219,7 +30385,7 @@ var get_default3 = defineCommand({
 });
 
 // packages/cli/src/commands/selection/set.ts
-var set_default2 = defineCommand({
+var set_default3 = defineCommand({
   meta: { description: "Set selection" },
   args: {
     ids: { type: "positional", description: "Node IDs (space separated)", required: true },
@@ -30240,8 +30406,8 @@ var set_default2 = defineCommand({
 var selection_default = defineCommand({
   meta: { description: "Selection operations" },
   subCommands: {
-    get: get_default3,
-    set: set_default2
+    get: get_default4,
+    set: set_default3
   }
 });
 // packages/cli/src/export-guard.ts
@@ -30439,7 +30605,7 @@ var list_default2 = defineCommand({
 });
 
 // packages/cli/src/commands/page/set.ts
-var set_default3 = defineCommand({
+var set_default4 = defineCommand({
   meta: { description: "Switch to page by ID or name" },
   args: {
     page: { type: "positional", description: "Page ID or name", required: true },
@@ -30460,11 +30626,11 @@ var page_default2 = defineCommand({
   meta: { description: "Page operations" },
   subCommands: {
     list: list_default2,
-    set: set_default3
+    set: set_default4
   }
 });
 // packages/cli/src/commands/viewport/get.ts
-var get_default4 = defineCommand({
+var get_default5 = defineCommand({
   meta: { description: "Get viewport position and zoom" },
   args: {
     json: { type: "boolean", description: "Output as JSON" }
@@ -30480,7 +30646,7 @@ var get_default4 = defineCommand({
 });
 
 // packages/cli/src/commands/viewport/set.ts
-var set_default4 = defineCommand({
+var set_default5 = defineCommand({
   meta: { description: "Set viewport position and zoom" },
   args: {
     x: { type: "string", description: "X position" },
@@ -30524,8 +30690,8 @@ var zoom_to_fit_default = defineCommand({
 var viewport_default = defineCommand({
   meta: { description: "Viewport operations" },
   subCommands: {
-    get: get_default4,
-    set: set_default4,
+    get: get_default5,
+    set: set_default5,
     "zoom-to-fit": zoom_to_fit_default
   }
 });
@@ -30547,7 +30713,7 @@ var list_default3 = defineCommand({
 });
 
 // packages/cli/src/commands/variable/get.ts
-var get_default5 = defineCommand({
+var get_default6 = defineCommand({
   meta: { description: "Get variable by ID" },
   args: {
     id: { type: "positional", description: "Variable ID", required: true },
@@ -30589,7 +30755,7 @@ var create_default2 = defineCommand({
 });
 
 // packages/cli/src/commands/variable/set.ts
-var set_default5 = defineCommand({
+var set_default6 = defineCommand({
   meta: { description: "Set variable value for mode" },
   args: {
     id: { type: "positional", description: "Variable ID", required: true },
@@ -30656,9 +30822,9 @@ var variable_default = defineCommand({
   meta: { description: "Variable operations" },
   subCommands: {
     list: list_default3,
-    get: get_default5,
+    get: get_default6,
     create: create_default2,
-    set: set_default5,
+    set: set_default6,
     delete: delete_default2,
     bind: bind_default
   }
@@ -30680,7 +30846,7 @@ var list_default4 = defineCommand({
 });
 
 // packages/cli/src/commands/collection/get.ts
-var get_default6 = defineCommand({
+var get_default7 = defineCommand({
   meta: { description: "Get variable collection by ID" },
   args: {
     id: { type: "positional", description: "Collection ID", required: true },
@@ -30735,7 +30901,7 @@ var collection_default = defineCommand({
   meta: { description: "Variable collection operations" },
   subCommands: {
     list: list_default4,
-    get: get_default6,
+    get: get_default7,
     create: create_default3,
     delete: delete_default3
   }
@@ -31282,12 +31448,15 @@ var font_default2 = defineCommand({
     list: list_default8
   }
 });
+// package.json
+var version = "0.6.0";
+
 // packages/cli/src/index.ts
 var main = defineCommand({
   meta: {
     name: "figma-use",
     description: "Control Figma from the command line. Supports JSX rendering with components and variants \u2014 see `figma-use render --examples`",
-    version: "0.5.0"
+    version
   },
   subCommands: exports_commands
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dannote/figma-use",
-  "version": "0.5.8",
+  "version": "0.6.0",
   "description": "Control Figma from the command line. Full read/write access for AI agents.",
   "type": "module",
   "bin": {