@dannote/figma-use 0.5.5 → 0.5.7

package/CHANGELOG.md

@@ -7,14 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.5.5] - 2026-01-18
+## [0.5.7] - 2026-01-18
+
+### Fixed
+
+- Font family and style now shown in `node tree` output
+
+## [0.5.6] - 2026-01-18
 
 ### Added
 
 - `comment list|add|delete` — manage file comments
-- `version list` — view file version history
+- `version list` — view file version history  
 - `file info` — get file key and name
 - `me` — get current user info
+- `font list` — list available fonts with optional family filter
+- `plugin list` — list installed development plugins
+- `plugin` is now a subcommand group: `plugin install|uninstall|list|path`
 
 ## [0.5.4] - 2026-01-18
 

package/README.md

@@ -49,7 +49,7 @@ The `render` command takes this JSX and creates real Figma nodes — frames, tex
 ```bash
 bun install -g @dannote/figma-use
 
-figma-use plugin     # Install Figma plugin (quit Figma first)
+figma-use plugin install  # Install plugin (quit Figma first)
 figma-use proxy      # Start proxy server
 ```
 
@@ -260,6 +260,13 @@ figma-use style list
 figma-use style create-paint "Brand/Primary" --color "#E11D48"
 ```
 
+### Fonts
+
+```bash
+figma-use font list                  # All available fonts
+figma-use font list --family Roboto  # Filter by family name
+```
+
 ### Comments & History
 
 ```bash

package/SKILL.md

@@ -29,7 +29,7 @@ figma --remote-debugging-port=9222
 If plugin not installed:
 ```bash
 # Quit Figma first, then:
-figma-use plugin
+figma-use plugin install
 ```
 
 ---
@@ -175,6 +175,13 @@ figma-use style list
 figma-use style create-paint "Brand/Primary" --color "#E11D48"
 ```
 
+### Fonts
+
+```bash
+figma-use font list                  # All available fonts
+figma-use font list --family Roboto  # Filter by family name
+```
+
 ### Comments & History
 
 Requires Figma running with `--remote-debugging-port=9222`:

package/dist/cli/index.js

@@ -977,8 +977,9 @@ function formatNode(node, indent = "") {
     details.push(`radius: ${node.cornerRadius}px`);
   }
   if (node.fontSize) {
-    const weight = node.fontWeight || "";
-    details.push(`font: ${node.fontSize}px ${weight}`.trim());
+    const family = node.fontFamily || "";
+    const style = node.fontStyle || "";
+    details.push(`font: ${node.fontSize}px ${family} ${style}`.trim());
   }
   if (node.characters && !name) {
     details.push(`text: "${node.characters}"`);
@@ -22791,6 +22792,7 @@ __export(exports_commands, {
   import: () => import_default,
   group: () => group_default,
   get: () => get_default2,
+  font: () => font_default2,
   find: () => find_default,
   file: () => file_default,
   export: () => export_default,
@@ -22923,10 +22925,9 @@ var proxy_default = defineCommand({
     child.on("exit", (code) => process.exit(code || 0));
   }
 });
-// packages/cli/src/commands/plugin.ts
-import { resolve as resolve2, dirname as dirname2, join } from "path";
+// packages/cli/src/commands/plugin/install.ts
+import { resolve as resolve2, dirname as dirname2, join as join2 } from "path";
 import { readFileSync, writeFileSync, existsSync } from "fs";
-import { execSync } from "child_process";
 
 // packages/cli/node_modules/consola/dist/core.mjs
 var LogLevels2 = {
@@ -23901,21 +23902,9 @@ function _getDefaultLogLevel2() {
 }
 var consola2 = createConsola4();
 
-// packages/cli/src/commands/plugin.ts
-function getPackageRoot2() {
-  const currentFile = import.meta.path || import.meta.url.replace("file://", "");
-  let dir = dirname2(currentFile);
-  for (let i3 = 0;i3 < 10; i3++) {
-    try {
-      const pkg = __require(resolve2(dir, "package.json"));
-      if (pkg.name === "@dannote/figma-use") {
-        return dir;
-      }
-    } catch {}
-    dir = dirname2(dir);
-  }
-  return dirname2(dirname2(dirname2(currentFile)));
-}
+// packages/cli/src/commands/plugin/utils.ts
+import { join } from "path";
+import { execSync } from "child_process";
 function getFigmaSettingsPath() {
   const home = process.env.HOME || process.env.USERPROFILE || "";
   if (process.platform === "darwin") {
@@ -23943,12 +23932,28 @@ function isFigmaRunning() {
     return false;
   }
 }
+
+// packages/cli/src/commands/plugin/install.ts
+function getPackageRoot2() {
+  const currentFile = import.meta.path || import.meta.url.replace("file://", "");
+  let dir = dirname2(currentFile);
+  for (let i3 = 0;i3 < 10; i3++) {
+    try {
+      const pkg = __require(resolve2(dir, "package.json"));
+      if (pkg.name === "@dannote/figma-use") {
+        return dir;
+      }
+    } catch {}
+    dir = dirname2(dir);
+  }
+  return dirname2(dirname2(dirname2(currentFile)));
+}
 function getNextId(extensions) {
   if (!extensions || extensions.length === 0)
     return 1;
   return Math.max(...extensions.map((e3) => e3.id)) + 1;
 }
-function installPlugin(manifestPath) {
+function installPlugin(manifestPath, force = false) {
   const settingsPath = getFigmaSettingsPath();
   if (!settingsPath || !existsSync(settingsPath)) {
     return {
@@ -23956,10 +23961,10 @@ function installPlugin(manifestPath) {
       message: "Figma settings not found. Please install Figma Desktop first."
     };
   }
-  if (isFigmaRunning()) {
+  if (!force && isFigmaRunning()) {
     return {
       success: false,
-      message: "Figma is running. Please quit Figma first, then run this command again."
+      message: "Figma is running. Quit Figma first or use --force"
     };
   }
   try {
@@ -23975,9 +23980,9 @@ function installPlugin(manifestPath) {
         for (const ext of extensions) {
           if (ext.fileMetadata?.manifestFileId === existing.id) {
             if (ext.fileMetadata.type === "code") {
-              ext.manifestPath = join(pluginDir2, manifest.main || "main.js");
+              ext.manifestPath = join2(pluginDir2, manifest.main || "main.js");
             } else if (ext.fileMetadata.type === "ui") {
-              ext.manifestPath = join(pluginDir2, manifest.ui || "ui.html");
+              ext.manifestPath = join2(pluginDir2, manifest.ui || "ui.html");
             }
           }
         }
@@ -24005,7 +24010,7 @@ function installPlugin(manifestPath) {
     });
     extensions.push({
       id: codeId,
-      manifestPath: join(pluginDir, manifest.main || "main.js"),
+      manifestPath: join2(pluginDir, manifest.main || "main.js"),
       fileMetadata: {
         type: "code",
         manifestFileId: manifestId
@@ -24013,7 +24018,7 @@ function installPlugin(manifestPath) {
     });
     extensions.push({
       id: uiId,
-      manifestPath: join(pluginDir, manifest.ui || "ui.html"),
+      manifestPath: join2(pluginDir, manifest.ui || "ui.html"),
       fileMetadata: {
         type: "ui",
         manifestFileId: manifestId
@@ -24029,15 +24034,15 @@ function installPlugin(manifestPath) {
     };
   }
 }
-function uninstallPlugin(manifestPath) {
+function uninstallPlugin(manifestPath, force = false) {
   const settingsPath = getFigmaSettingsPath();
   if (!settingsPath || !existsSync(settingsPath)) {
     return { success: false, message: "Figma settings not found" };
   }
-  if (isFigmaRunning()) {
+  if (!force && isFigmaRunning()) {
     return {
       success: false,
-      message: "Figma is running. Please quit Figma first."
+      message: "Figma is running. Quit Figma first or use --force"
     };
   }
   try {
@@ -24060,7 +24065,7 @@ function uninstallPlugin(manifestPath) {
     };
   }
 }
-var plugin_default = defineCommand({
+var install_default = defineCommand({
   meta: { description: "Install/uninstall Figma plugin" },
   args: {
     uninstall: { type: "boolean", description: "Uninstall the plugin" },
@@ -24075,7 +24080,7 @@ var plugin_default = defineCommand({
       return;
     }
     if (args.uninstall) {
-      const result2 = uninstallPlugin(pluginPath);
+      const result2 = uninstallPlugin(pluginPath, args.force);
       if (result2.success) {
         consola2.success(result2.message);
       } else {
@@ -24083,13 +24088,7 @@ var plugin_default = defineCommand({
       }
       return;
     }
-    if (!args.force && isFigmaRunning()) {
-      consola2.error("Figma is running");
-      consola2.info("Please quit Figma, then run: figma-use plugin");
-      consola2.info("Or use --force to install anyway (changes will apply on restart)");
-      return;
-    }
-    const result = installPlugin(pluginPath);
+    const result = installPlugin(pluginPath, args.force);
     if (result.success) {
       consola2.success(result.message);
       if (result.message !== "Plugin already installed") {
@@ -24111,6 +24110,72 @@ var plugin_default = defineCommand({
     }
   }
 });
+
+// packages/cli/src/commands/plugin/list.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+init_format();
+var list_default = defineCommand({
+  meta: { description: "List installed development plugins" },
+  args: {
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const settingsPath = getFigmaSettingsPath();
+      if (!settingsPath || !existsSync2(settingsPath)) {
+        console.log("No Figma settings found");
+        return;
+      }
+      const settings = JSON.parse(readFileSync2(settingsPath, "utf-8"));
+      const extensions = settings.localFileExtensions || [];
+      const plugins = extensions.filter((e3) => e3.fileMetadata?.type === "manifest").map((e3) => ({
+        id: e3.lastKnownPluginId || "unknown",
+        name: e3.lastKnownName || "Unnamed",
+        path: e3.manifestPath
+      }));
+      if (args.json) {
+        console.log(JSON.stringify(plugins, null, 2));
+        return;
+      }
+      if (plugins.length === 0) {
+        console.log("No development plugins installed");
+        return;
+      }
+      for (const p of plugins) {
+        console.log(`${accent(p.name)} ${dim(`(${p.id})`)}`);
+        console.log(`  ${dim(p.path)}`);
+      }
+      console.log(`
+${plugins.length} plugin${plugins.length === 1 ? "" : "s"}`);
+    } catch (e3) {
+      handleError(e3);
+    }
+  }
+});
+
+// packages/cli/src/commands/plugin/index.ts
+var plugin_default = defineCommand({
+  meta: { description: "Manage Figma plugins" },
+  subCommands: {
+    install: install_default,
+    list: list_default,
+    uninstall: defineCommand({
+      meta: { description: "Uninstall the Figma Use plugin" },
+      args: {
+        force: { type: "boolean", description: "Force uninstall even if Figma is running" }
+      },
+      async run({ args }) {
+        await install_default.run?.({ args: { uninstall: true, path: false, force: args.force } });
+      }
+    }),
+    path: defineCommand({
+      meta: { description: "Show plugin manifest path" },
+      async run() {
+        await install_default.run?.({ args: { path: true, uninstall: false, force: false } });
+      }
+    })
+  }
+});
 // packages/cli/src/commands/profile.ts
 init_format();
 import { spawn as spawn2 } from "child_process";
@@ -24256,9 +24321,9 @@ var profile_default = defineCommand({
 init_format();
 var React3 = __toESM(require_react(), 1);
 import { resolve as resolve3 } from "path";
-import { existsSync as existsSync2, writeFileSync as writeFileSync2, unlinkSync } from "fs";
+import { existsSync as existsSync3, writeFileSync as writeFileSync2, unlinkSync } from "fs";
 import { tmpdir } from "os";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 
 // packages/cli/src/render/reconciler.ts
 var import_react_reconciler = __toESM(require_react_reconciler(), 1);
@@ -28345,7 +28410,7 @@ async function readStdin() {
 function findNodeModulesDir() {
   let dir = import.meta.dir;
   for (let i3 = 0;i3 < 10; i3++) {
-    if (existsSync2(join2(dir, "node_modules", "react"))) {
+    if (existsSync3(join3(dir, "node_modules", "react"))) {
       return dir;
     }
     const parent = resolve3(dir, "..");
@@ -28468,12 +28533,12 @@ var render_default = defineCommand({
       }
       code = transformJsxSnippet(code);
       const baseDir = findNodeModulesDir() || tmpdir();
-      tempFile = join2(baseDir, `.figma-render-${Date.now()}.js`);
+      tempFile = join3(baseDir, `.figma-render-${Date.now()}.js`);
       writeFileSync2(tempFile, code);
       filePath = tempFile;
     } else if (args.file) {
       filePath = resolve3(args.file);
-      if (!existsSync2(filePath)) {
+      if (!existsSync3(filePath)) {
         console.error(fail(`File not found: ${filePath}`));
         process.exit(1);
       }
@@ -28556,7 +28621,7 @@ var render_default = defineCommand({
     } catch (e6) {
       handleError(e6);
     } finally {
-      if (tempFile && existsSync2(tempFile)) {
+      if (tempFile && existsSync3(tempFile)) {
         unlinkSync(tempFile);
       }
     }
@@ -29956,7 +30021,7 @@ var blend_default = defineCommand({
 });
 
 // packages/cli/src/commands/set/image.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 var image_default = defineCommand({
   meta: { description: "Set image fill from file" },
   args: {
@@ -29967,7 +30032,7 @@ var image_default = defineCommand({
   },
   async run({ args }) {
     try {
-      const buffer = readFileSync2(args.file);
+      const buffer = readFileSync3(args.file);
       const base64 = buffer.toString("base64");
       const result = await sendCommand("set-image-fill", {
         id: args.id,
@@ -30354,7 +30419,7 @@ var export_default = defineCommand({
   }
 });
 // packages/cli/src/commands/page/list.ts
-var list_default = defineCommand({
+var list_default2 = defineCommand({
   meta: { description: "List all pages" },
   args: {
     json: { type: "boolean", description: "Output as JSON" }
@@ -30390,7 +30455,7 @@ var set_default3 = defineCommand({
 var page_default2 = defineCommand({
   meta: { description: "Page operations" },
   subCommands: {
-    list: list_default,
+    list: list_default2,
     set: set_default3
   }
 });
@@ -30461,7 +30526,7 @@ var viewport_default = defineCommand({
   }
 });
 // packages/cli/src/commands/variable/list.ts
-var list_default2 = defineCommand({
+var list_default3 = defineCommand({
   meta: { description: "List all variables" },
   args: {
     type: { type: "string", description: "Filter by type: COLOR, FLOAT, STRING, BOOLEAN" },
@@ -30586,7 +30651,7 @@ var bind_default = defineCommand({
 var variable_default = defineCommand({
   meta: { description: "Variable operations" },
   subCommands: {
-    list: list_default2,
+    list: list_default3,
     get: get_default5,
     create: create_default2,
     set: set_default5,
@@ -30595,7 +30660,7 @@ var variable_default = defineCommand({
   }
 });
 // packages/cli/src/commands/collection/list.ts
-var list_default3 = defineCommand({
+var list_default4 = defineCommand({
   meta: { description: "List variable collections" },
   args: {
     json: { type: "boolean", description: "Output as JSON" }
@@ -30665,14 +30730,14 @@ var delete_default3 = defineCommand({
 var collection_default = defineCommand({
   meta: { description: "Variable collection operations" },
   subCommands: {
-    list: list_default3,
+    list: list_default4,
     get: get_default6,
     create: create_default3,
     delete: delete_default3
   }
 });
 // packages/cli/src/commands/style/list.ts
-var list_default4 = defineCommand({
+var list_default5 = defineCommand({
   meta: { description: "List local styles" },
   args: {
     json: { type: "boolean", description: "Output as JSON" }
@@ -30763,7 +30828,7 @@ var create_effect_default = defineCommand({
 var style_default = defineCommand({
   meta: { description: "Style operations" },
   subCommands: {
-    list: list_default4,
+    list: list_default5,
     "create-paint": create_paint_default,
     "create-text": create_text_default,
     "create-effect": create_effect_default
@@ -31008,7 +31073,7 @@ function formatComment(c7) {
   ${c7.message}
   ${dim(`id: ${c7.id}`)}`;
 }
-var list_default5 = defineCommand({
+var list_default6 = defineCommand({
   meta: { description: "List comments on the current file" },
   args: {
     file: { type: "string", description: "File key (default: current file)" },
@@ -31091,16 +31156,16 @@ var delete_default4 = defineCommand({
 
 // packages/cli/src/commands/comment/index.ts
 var comment_default = defineCommand({
-  meta: { description: "Manage file comments (REST API)" },
+  meta: { description: "Manage file comments " },
   subCommands: {
-    list: list_default5,
+    list: list_default6,
     add: add_default,
     delete: delete_default4
   }
 });
 // packages/cli/src/commands/version/list.ts
 init_format();
-var list_default6 = defineCommand({
+var list_default7 = defineCommand({
   meta: { description: "List file version history" },
   args: {
     file: { type: "string", description: "File key (default: current file)" },
@@ -31135,9 +31200,9 @@ var list_default6 = defineCommand({
 
 // packages/cli/src/commands/version/index.ts
 var version_default = defineCommand({
-  meta: { description: "View file version history (REST API)" },
+  meta: { description: "View file version history" },
   subCommands: {
-    list: list_default6
+    list: list_default7
   }
 });
 // packages/cli/src/commands/file/info.ts
@@ -31164,11 +31229,55 @@ var info_default = defineCommand({
 
 // packages/cli/src/commands/file/index.ts
 var file_default = defineCommand({
-  meta: { description: "File operations (REST API)" },
+  meta: { description: "File operations " },
   subCommands: {
     info: info_default
   }
 });
+// packages/cli/src/commands/font/list.ts
+init_format();
+var list_default8 = defineCommand({
+  meta: { description: "List available fonts" },
+  args: {
+    family: { type: "string", description: "Filter by family name" },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    try {
+      const fonts = await sendCommand("list-fonts");
+      let filtered = fonts;
+      if (args.family) {
+        const search = args.family.toLowerCase();
+        filtered = fonts.filter((f7) => f7.family.toLowerCase().includes(search));
+      }
+      if (args.json) {
+        console.log(JSON.stringify(filtered, null, 2));
+        return;
+      }
+      const families = new Map;
+      for (const font of filtered) {
+        const styles = families.get(font.family) || [];
+        styles.push(font.style);
+        families.set(font.family, styles);
+      }
+      for (const [family, styles] of families) {
+        console.log(`${family} ${dim(`(${styles.join(", ")})`)}`);
+      }
+      console.log(`
+${families.size} families, ${filtered.length} fonts`);
+    } catch (e6) {
+      handleError(e6);
+    }
+  }
+});
+
+// packages/cli/src/commands/font/index.ts
+var font_default2 = defineCommand({
+  meta: { description: "Font operations" },
+  subCommands: {
+    list: list_default8
+  }
+});
 // packages/cli/src/index.ts
 var main = defineCommand({
   meta: {

package/package.json

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

package/packages/plugin/dist/main.js

@@ -272,6 +272,10 @@
         }
         case "get-current-page":
           return { id: figma.currentPage.id, name: figma.currentPage.name };
+        case "list-fonts": {
+          const fonts = yield figma.listAvailableFontsAsync();
+          return fonts.map((f) => ({ family: f.fontName.family, style: f.fontName.style }));
+        }
         case "get-node-tree": {
           const { id } = args;
           const node = yield figma.getNodeByIdAsync(id);
@@ -1434,6 +1438,10 @@
       const textNode = node;
       base.characters = textNode.characters;
       if (typeof textNode.fontSize === "number") base.fontSize = textNode.fontSize;
+      if (typeof textNode.fontName === "object") {
+        base.fontFamily = textNode.fontName.family;
+        base.fontStyle = textNode.fontName.style;
+      }
     }
     if ("children" in node) {
       base.childCount = node.children.length;