@mp3wizard/figma-console-mcp 1.23.1 → 1.25.1

package/figma-desktop-bridge/code.js

@@ -6,7 +6,7 @@
 
 // Plugin version — sent in FILE_INFO for server-side version compatibility checks.
 // The server compares this against its own version to detect stale cached plugins.
-var PLUGIN_VERSION = '1.23.0'; // Kept in sync with package.json by scripts/release.sh — see issue #62.
+var PLUGIN_VERSION = '1.25.0'; // Kept in sync with package.json by scripts/release.sh — see issue #62.
 
 console.log('🌉 [Desktop Bridge] Plugin loaded (v' + PLUGIN_VERSION + ')');
 
@@ -6299,6 +6299,12 @@ figma.loadAllPagesAsync().then(function() {
     var hasNodeChanges = false;
     var changedNodeIds = [];
 
+    // v1.25.0: also collect metadata-only changes (descriptions, annotations).
+    // These are properties that the REST API DOESN'T expose in version snapshots,
+    // so figma_diff_versions can't see them through REST alone. Forwarding them
+    // via the Plugin API + WebSocket is the only way to make them diff-visible.
+    var metadataChanges = [];
+
     for (var i = 0; i < event.documentChanges.length; i++) {
       var change = event.documentChanges[i];
       if (change.type === 'STYLE_CREATE' || change.type === 'STYLE_DELETE' || change.type === 'STYLE_PROPERTY_CHANGE') {
@@ -6309,6 +6315,48 @@ figma.loadAllPagesAsync().then(function() {
           changedNodeIds.push(change.id);
         }
       }
+
+      // Metadata change detection. PROPERTY_CHANGE includes a `properties` array
+      // listing which fields changed; we only snapshot the new value for the
+      // two fields Figma's REST never returns: `description` and `annotations`.
+      if (change.type === 'PROPERTY_CHANGE' && change.node && Array.isArray(change.properties)) {
+        for (var p = 0; p < change.properties.length; p++) {
+          var prop = change.properties[p];
+          if (prop === 'description' || prop === 'descriptionMarkdown' || prop === 'annotations') {
+            try {
+              var newValue = change.node[prop];
+              // Serialize annotations to plain JSON-safe form
+              if (prop === 'annotations' && Array.isArray(newValue)) {
+                newValue = newValue.map(function(a) {
+                  return {
+                    label: a.label || null,
+                    labelMarkdown: a.labelMarkdown || null,
+                    categoryId: a.categoryId || null,
+                    properties: a.properties || []
+                  };
+                });
+              }
+              metadataChanges.push({
+                node_id: change.node.id,
+                node_name: change.node.name || null,
+                node_type: change.node.type || null,
+                field: prop === 'descriptionMarkdown' ? 'description' : prop,
+                new_value: newValue,
+                timestamp: Date.now()
+              });
+            } catch (e) {
+              // Some property reads can throw on detached / deleted nodes
+            }
+          }
+        }
+      }
+    }
+
+    if (metadataChanges.length > 0) {
+      figma.ui.postMessage({
+        type: 'METADATA_CHANGE',
+        data: { changes: metadataChanges }
+      });
     }
 
     if (hasStyleChanges || hasNodeChanges) {

package/figma-desktop-bridge/ui.html

@@ -1043,6 +1043,14 @@
         }
       };
 
+      // v1.25.0: forward METADATA_CHANGE events (description/annotation edits)
+      // so figma_diff_versions can surface them despite Figma REST not exposing them.
+      window.__wsForwardMetadataChange = function(data) {
+        if (wsConnected) {
+          broadcastToAll({ type: 'METADATA_CHANGE', data: data });
+        }
+      };
+
       // Forward CONSOLE_CAPTURE events to all servers for console monitoring
       window.__wsForwardConsoleCapture = function(data) {
         if (wsConnected) {
@@ -1472,6 +1480,11 @@
           if (window.__wsForwardDocumentChange) window.__wsForwardDocumentChange(msg.data);
           break;
 
+        // v1.25.0: metadata change events (description/annotation edits via Plugin API)
+        case 'METADATA_CHANGE':
+          if (window.__wsForwardMetadataChange) window.__wsForwardMetadataChange(msg.data);
+          break;
+
         // Console capture events (for console monitoring via WebSocket)
         case 'CONSOLE_CAPTURE':
           if (window.__wsForwardConsoleCapture) window.__wsForwardConsoleCapture(msg);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mp3wizard/figma-console-mcp",
-	"version": "1.23.1",
+	"version": "1.25.1",
 	"description": "MCP server for accessing Figma plugin console logs and screenshots via Cloudflare Workers or local mode",
 	"type": "module",
 	"main": "dist/local.js",
@@ -65,7 +65,7 @@
 		"pino": "^9.5.0",
 		"pino-pretty": "^13.0.0",
 		"puppeteer-core": "^23.11.1",
-		"uuid": ">=11.1.1",
+		"uuid": "^11.0.3",
 		"ws": "^8.19.0",
 		"zod": "^3.25.76"
 	},
@@ -81,28 +81,9 @@
 		"ts-jest": "^29.2.5",
 		"tsx": "^4.19.2",
 		"typescript": "5.9.3",
-		"vite": ">=6.4.2",
+		"vite": "^6.0.0",
 		"vite-plugin-singlefile": "^2.0.0",
 		"wrangler": "^4.42.0",
 		"zod-to-json-schema": "^3.25.1"
-	},
-	"overrides": {
-		"path-to-regexp": ">=8.4.1",
-		"miniflare": {
-			"undici": ">=7.24.0"
-		},
-		"handlebars": ">=4.7.9",
-		"brace-expansion": ">=1.1.13",
-		"lodash": ">=4.18.0",
-		"picomatch": ">=4.0.4",
-		"hono": ">=4.12.18",
-		"@hono/node-server": ">=1.19.13",
-		"basic-ftp": ">=5.3.0",
-		"postcss": ">=8.5.10",
-		"fast-uri": ">=3.1.2",
-		"ip-address": ">=10.1.1",
-		"vite": {
-			"picomatch": ">=4.0.4"
-		}
 	}
 }