figma-rust-mcp 5.0.2 → 5.1.0

package/README.md

@@ -487,3 +487,21 @@ node scripts/build-plugin.js
 ## 📄 License
 
 MIT © [BuiHung1612](https://github.com/BuiHung1612) — Free to use, modify, and distribute. See [LICENSE](LICENSE) for details.
+
+### Bounded design specs
+
+Use `figma_read` with `operation: "get_spec"` instead of loading a full frame into the model context:
+
+```json
+{"operation":"get_spec","nodeId":"1467:84778","mode":"overview","sessionId":"<tab-id>"}
+```
+
+- `overview` defaults to depth 2, returning section IDs for discovery. It does **not** claim deep text coverage.
+- Read each section with `mode: "spec"`; `mode: "detail"` reads one node at depth 0. `fields` can select geometry/layout or content/text independently.
+- `maxBytes` defaults to 24000 raw node bytes per page. Continue `nextCursor` with the same `sessionId`, mode and optional byte budget. No records are dropped. A single large node, response metadata and resolved component references can exceed this target.
+- Exact repeated style bundles use `_compression.styles`; repeated node properties use `templates`. Decode template references first, then style references. Identity, topology, copy, geometry, variants and mixed text remain reconstructable. This is property sharing, not heuristic merging of visually similar subtrees.
+- `coverage.subtreeComplete` distinguishes a complete deep read from exhausted pagination at a shallow depth. Counts describe the returned page, not unread descendants.
+- Pass `outputPath` on a fresh request to save **all pages of the requested scope** as raw JSON and return only coverage/path. A shallow overview export remains shallow. Raw data is also available through the existing session cache and node-ID reads.
+- Existing `read_nodes` remains raw by default; `detail: "compact"` enables lossless shared-style compression. It also accepts `maxBytes`.
+
+`figma_prepare_design` now follows expanded instance pagination for text and reports separate text/asset coverage. Default compact output omits the redundant `colorPalette`; use `detail: "full"` to retain it. Pass `outputPath` to save the grounding pack plus raw design records outside context. Asset export caps and failures are reported; exported icons do not imply all assets were inspected.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figma-rust-mcp",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "Claude Code to Figma — Bidirectional MCP bridge. AI draws UI on Figma canvas, reads designs back. Works with Claude, Cursor, VS Code, Windsurf, Antigravity. No API key needed.",
   "mcpName": "io.github.BuiHung1612/figma-rust-mcp",
   "type": "module",

package/scripts/test-plugin-tokens.mjs

@@ -812,3 +812,23 @@ test('creating a paint style invalidates the style names before the next design
   await r.handlers.createPaintStyle({ name: 'Brand/New', color: '#ff0000' });
   assert.equal((await r.getStyleNameMapAsync())['new-style'], 'Brand/New');
 });
+
+test('byte-bounded reads paginate without dropping unicode, oversized nodes or descendants', async () => {
+  const page = {id:'page',type:'PAGE'};
+  const frame = {id:'frame',name:'Frame',type:'FRAME',parent:page};
+  frame.children = Array.from({length:12},(_,i)=>({id:`text:${i}`,name:'Label',type:'TEXT',parent:frame,
+    characters:i === 4 ? '漢'.repeat(2000) : 'é'.repeat(100),visible:true}));
+  page.children = [frame];
+  const r = runtime({root:{id:"root"},currentPage:page,getNodeByIdAsync:async()=>frame});
+  let read = await r.handlers.read_nodes({id:'frame',expandInstances:true,maxBytes:1024,limit:500});
+  const all = [...read.nodes]; let oversized = false, pages = 1;
+  while(read.nextCursor) {
+    assert.ok(pages++ < 20);
+    read = await r.handlers.read_nodes({cursor:read.nextCursor,maxBytes:1024,limit:500});
+    oversized ||= read.oversizedNode; all.push(...read.nodes);
+  }
+  assert.equal(read.complete,true); assert.equal(oversized,true);
+  assert.deepEqual(plain(all.map(n=>n.id)),['frame',...frame.children.map(n=>n.id)]);
+  assert.equal(all[5].content,'漢'.repeat(2000));
+  await assert.rejects(r.handlers.read_nodes({id:'frame',maxBytes:0}),/maxBytes/);
+});