figma-console-mcp 1.45.0 → 1.46.0

package/dist/core/shader-tools.js

@@ -0,0 +1,238 @@
+/**
+ * Figma Shader tools (Plugin API, beta: Update 130+).
+ *
+ * Shaders are created in Figma (UI, or Figma's own MCP). The Plugin API can
+ * apply them by id and set their properties. Applied shaders carry
+ * `propertyMetadata` (author-defined names and types per property key), so
+ * these tools let callers set properties by name ("turbulence") instead of
+ * the opaque uniform keys ("3561834497:1861196824").
+ *
+ * Both tools build a Plugin API script and run it through executeCodeViaUI,
+ * so no Desktop Bridge plugin change (or re-import) is needed.
+ */
+import { z } from "zod";
+import { createChildLogger } from "./logger.js";
+const logger = createChildLogger({ component: "shader-tools" });
+const fileKeySchema = z
+    .string()
+    .optional()
+    .describe("Local Mode only. Run against this specific connected file instead of the active file. Get connected fileKeys from figma_list_open_files. Rejected in Cloud Mode, which pairs with a single plugin instance.");
+export const SHADER_TARGETS = ["fills", "strokes", "effects"];
+export const LIST_SHADERS_BODY = `
+const results = new Map();
+const limitUses = 20;
+const describe = (meta) => Object.entries(meta || {}).map(([key, d]) => ({ key, name: d.name, type: d.type, defaultValue: d.defaultValue, description: d.description }));
+const scan = (node, page) => {
+  for (const target of ['fills', 'strokes', 'effects']) {
+    const arr = node[target];
+    if (!Array.isArray(arr)) continue;
+    arr.forEach((p, index) => {
+      if (!p || p.type !== 'SHADER') return;
+      let entry = results.get(p.id);
+      if (!entry) {
+        entry = { id: p.id, kind: target === 'effects' ? 'effect' : 'fill', usageCount: 0, usedIn: [], properties: describe(p.propertyMetadata) };
+        results.set(p.id, entry);
+      }
+      entry.usageCount++;
+      if (entry.usedIn.length < limitUses) entry.usedIn.push({ nodeId: node.id, name: node.name, page: page.name, target, index });
+    });
+  }
+};
+let pages;
+if (P.nodeId) {
+  const root = await figma.getNodeByIdAsync(P.nodeId);
+  if (!root) throw new Error('Node not found: ' + P.nodeId);
+  let page = root; while (page && page.type !== 'PAGE') page = page.parent;
+  scan(root, page || figma.currentPage);
+  if ('findAll' in root) for (const n of root.findAll(() => true)) scan(n, page || figma.currentPage);
+} else {
+  pages = P.scope === 'file' ? figma.root.children : [figma.currentPage];
+  for (const page of pages) {
+    if (page !== figma.currentPage) await page.loadAsync();
+    for (const n of page.findAll(() => true)) scan(n, page);
+  }
+}
+let available = [];
+let availableNote;
+try {
+  const list = await Promise.race([figma.listAvailableShaders(), new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), 5000))]);
+  available = list.map(s => ({ id: s.id, name: s.name, kind: s.type, imported: s.imported, inFile: results.has(s.id), properties: describe(s.propertyDefinitions) }));
+} catch (e) {
+  availableNote = e && e.message === 'timeout'
+    ? "Figma didn't return the library shader list in time. This happens when the file's window isn't the focused one."
+    : 'Could not list library shaders: ' + (e && e.message ? e.message : e);
+}
+const out = { scope: P.nodeId ? 'node' : P.scope, inFile: Array.from(results.values()), available };
+if (availableNote) out.availableNote = availableNote;
+if (out.inFile.length > 0) out.note = 'Figma drops a shader from the file when nothing uses it and the file reloads. Keep at least one layer using each shader you want to reuse.';
+return out;
+`;
+export const APPLY_SHADER_BODY = `
+const node = await figma.getNodeByIdAsync(P.nodeId);
+if (!node) throw new Error('Node not found: ' + P.nodeId);
+const target = P.target;
+if (!(target in node) || !Array.isArray(node[target])) throw new Error(node.type + ' nodes have no ' + target);
+const original = node[target].map(p => JSON.parse(JSON.stringify(p)));
+const clone = (v) => JSON.parse(JSON.stringify(v));
+
+let index;
+let paint;
+if (P.index !== undefined) {
+  const existing = original[P.index];
+  if (!existing || existing.type !== 'SHADER') throw new Error(target + '[' + P.index + '] is not a shader. Omit index to add a new shader.');
+  index = P.index;
+  paint = clone(existing);
+  if (P.shaderId && P.shaderId !== existing.id) { paint = { type: 'SHADER', id: P.shaderId }; }
+} else {
+  if (!P.shaderId) throw new Error('Pass shaderId to add a shader, or index to change one already applied.');
+  paint = { type: 'SHADER', id: P.shaderId };
+  index = P.replace ? 0 : original.length;
+}
+if (target === 'effects') paint.visible = P.visible !== undefined ? P.visible : (paint.visible !== undefined ? paint.visible : true);
+else if (P.visible !== undefined) paint.visible = P.visible;
+if (target !== 'effects') {
+  if (P.opacity !== undefined) paint.opacity = P.opacity;
+  if (P.blendMode !== undefined) paint.blendMode = P.blendMode;
+}
+
+const strip = (p) => { const c = clone(p); delete c.propertyMetadata; return c; };
+const place = (p) => {
+  const next = P.replace && P.index === undefined ? [] : original.map(strip);
+  next[index] = strip(p);
+  return next;
+};
+const write = async (p) => {
+  try { node[target] = place(p); }
+  catch (e) {
+    const msg = e && e.message ? e.message : String(e);
+    if (/not imported/i.test(msg)) {
+      await figma.importShaderById(p.id);
+      node[target] = place(p);
+      return;
+    }
+    if (/Invalid shader id|Expected an id/i.test(msg)) {
+      throw new Error(msg + (target === 'effects'
+        ? ' Effect shaders and fill shaders are separate kinds: a fill shader goes on fills or strokes.'
+        : ' Use an id from figma_list_shaders. A shader nothing in the file uses is dropped when the file reloads.'));
+    }
+    throw e;
+  }
+};
+
+// Apply first (properties keep their current or default values) so Figma
+// returns propertyMetadata, then map names to keys and write the changes.
+await write(paint);
+const applied = node[target][index];
+const meta = applied.propertyMetadata || {};
+const props = clone(applied.properties || {});
+const byName = {};
+for (const [key, d] of Object.entries(meta)) byName[d.name] = key;
+const requested = P.properties || {};
+const unknown = [];
+for (const [name, raw] of Object.entries(requested)) {
+  const key = meta[name] ? name : byName[name];
+  if (!key) { unknown.push(name); continue; }
+  const type = meta[key].type;
+  let value = raw;
+  if (value && typeof value === 'object' && value.variableId) value = { type: 'VARIABLE_ALIAS', id: value.variableId };
+  else if (type === 'COLOR' && typeof value === 'string') value = figma.util.rgba(value);
+  else if (type === 'COLOR' && value && typeof value === 'object' && value.a === undefined && 'r' in value) value = { r: value.r, g: value.g, b: value.b, a: 1 };
+  props[key] = value;
+}
+if (unknown.length) {
+  node[target] = original.map(strip);
+  throw new Error('Unknown shader propert' + (unknown.length > 1 ? 'ies' : 'y') + ': ' + unknown.join(', ') + '. This shader has: ' + Object.values(meta).map(d => d.name + ' (' + d.type + ')').join(', ') + '. Nothing was changed.');
+}
+if (Object.keys(requested).length) {
+  try { await write(Object.assign(strip(applied), { properties: props })); }
+  catch (e) { node[target] = original.map(strip); throw new Error('Figma rejected the property values: ' + (e && e.message ? e.message : e) + ' Nothing was changed.'); }
+}
+const final = node[target][index];
+const named = {};
+for (const [key, v] of Object.entries(final.properties || {})) named[meta[key] ? meta[key].name : key] = v;
+return {
+  nodeId: node.id, name: node.name, target, index, shaderId: final.id,
+  properties: named,
+  definitions: Object.entries(meta).map(([key, d]) => ({ key, name: d.name, type: d.type, defaultValue: d.defaultValue })),
+};
+`;
+export function shaderScript(payload, body) {
+    return `const P = ${JSON.stringify(payload)};\n${body}`;
+}
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+function fail(tool, error) {
+    logger.error({ error }, `${tool} failed`);
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: error instanceof Error ? error.message : String(error) }) }],
+        isError: true,
+    };
+}
+async function run(getDesktopConnector, script, timeout, fileKey) {
+    const connector = await getDesktopConnector();
+    const result = await connector.executeCodeViaUI(script, timeout, fileKey);
+    if (!result?.success)
+        throw new Error(result?.error || "Shader script failed");
+    return result.result;
+}
+const colorObject = { r: z.number(), g: z.number(), b: z.number(), a: z.number().optional() };
+const shaderValueSchema = z.union([
+    z.number(),
+    z.boolean(),
+    z.string(),
+    z
+        .object({
+        variableId: z.string().optional().describe("Bind the property to a variable instead of a literal"),
+        x: z.number().optional(),
+        y: z.number().optional(),
+        x2: z.number().optional(),
+        y2: z.number().optional(),
+        radius: z.number().optional(),
+        angle: z.number().optional(),
+        r: z.number().optional(),
+        g: z.number().optional(),
+        b: z.number().optional(),
+        a: z.number().optional(),
+        color: z.object(colorObject).optional(),
+        stops: z.array(z.object({ position: z.number(), color: z.object(colorObject) })).optional(),
+    })
+        .describe("Points {x,y}, lines {x,y,x2,y2}, circles {x,y,radius,angle?}, colors {r,g,b,a} (0–1), color points {x,y,color}, gradients {stops}, or {variableId}"),
+]);
+export function registerShaderTools(server, getDesktopConnector) {
+    server.tool("figma_list_shaders", "List shaders: the ones applied in this file (fills, strokes and effects), with each property's name, type and default, and the layers using them; plus shaders from the user's libraries (figma.listAvailableShaders). Use the property names with figma_apply_shader. Shaders are created in Figma, not through the Plugin API. Requires Desktop Bridge.", {
+        scope: z.enum(["page", "file"]).optional().default("page").describe("Search the current page (default) or every page"),
+        nodeId: z.string().optional().describe("Only search this node and its descendants"),
+        fileKey: fileKeySchema,
+    }, async ({ scope, nodeId, fileKey }) => {
+        try {
+            return ok(await run(getDesktopConnector, shaderScript({ scope, nodeId }, LIST_SHADERS_BODY), scope === "file" && !nodeId ? 120000 : 30000, fileKey));
+        }
+        catch (error) {
+            return fail("figma_list_shaders", error);
+        }
+    });
+    server.tool("figma_apply_shader", "Apply a shader to a node's fills, strokes or effects, or change the properties of one already applied. Set properties by name (e.g. {turbulence: 40, cloudColor: '#E8F4FF'}); names, types and defaults come from figma_list_shaders. Colors take hex strings or {r,g,b,a}, and any property can bind a variable with {variableId}. Pass index to change a shader already in that list; without index the shader is added on top (or replaces the list with replace: true). Fill shaders go on fills or strokes; effect shaders go on effects. Unknown property names change nothing and list the valid ones. Requires Desktop Bridge.", {
+        nodeId: z.string(),
+        shaderId: z.string().optional().describe("Shader id from figma_list_shaders. Optional when index points at a shader already applied"),
+        target: z.enum(SHADER_TARGETS).optional().default("fills"),
+        index: z.number().int().min(0).optional().describe("Change the shader at this position in the target list instead of adding one"),
+        replace: z.boolean().optional().default(false).describe("Replace everything in the target list with this shader"),
+        properties: z.record(z.string(), shaderValueSchema).optional().describe("Property values by name (or key)"),
+        opacity: z.number().min(0).max(1).optional().describe("Fills and strokes only"),
+        blendMode: z
+            .enum(["NORMAL", "DARKEN", "MULTIPLY", "COLOR_BURN", "LIGHTEN", "SCREEN", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"])
+            .optional()
+            .describe("Fills and strokes only"),
+        visible: z.boolean().optional(),
+        fileKey: fileKeySchema,
+    }, async ({ fileKey, ...payload }) => {
+        try {
+            return ok(await run(getDesktopConnector, shaderScript(payload, APPLY_SHADER_BODY), 30000, fileKey));
+        }
+        catch (error) {
+            return fail("figma_apply_shader", error);
+        }
+    });
+}
+//# sourceMappingURL=shader-tools.js.map

package/dist/core/shader-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-tools.js","sourceRoot":"","sources":["../../src/core/shader-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhE,MAAM,aAAa,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACR,6MAA6M,CAC7M,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAEvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDhC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwFhC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,IAAY;IAC1D,OAAO,aAAa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,EAAE,CAAC,IAAa;IACxB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,KAAc;IACzC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,SAAS,CAAC,CAAC;IAC1C,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7H,OAAO,EAAE,IAAI;KACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,mBAAuC,EAAE,MAAc,EAAE,OAAe,EAAE,OAAgB;IAC5G,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,sBAAsB,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;AAE9F,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC;IACjC,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,MAAM,EAAE;IACV,CAAC;SACC,MAAM,CAAC;QACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QAClG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;QACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC3F,CAAC;SACD,QAAQ,CAAC,oJAAoJ,CAAC;CAChK,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,mBAAuC;IAC7F,MAAM,CAAC,IAAI,CACV,oBAAoB,EACpB,2VAA2V,EAC3V;QACC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QACtH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACnF,OAAO,EAAE,aAAa;KACtB,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACpC,IAAI,CAAC;YACJ,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,mBAAmB,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,CAAC,EAAE,KAAK,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACtJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC,CACD,CAAC;IAEF,MAAM,CAAC,IAAI,CACV,oBAAoB,EACpB,wmBAAwmB,EACxmB;QACC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2FAA2F,CAAC;QACrI,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;QACjI,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACjH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC3G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC/E,SAAS,EAAE,CAAC;aACV,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;aACtM,QAAQ,EAAE;aACV,QAAQ,CAAC,wBAAwB,CAAC;QACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,OAAO,EAAE,aAAa;KACtB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACJ,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,mBAAmB,EAAE,YAAY,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACrG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/core/tokens-tools.js

@@ -36,7 +36,7 @@ const logger = createChildLogger({ component: "tokens-tools" });
  * on every exported token document. Kept in sync with package.json by
  * scripts/release.sh — see step 3 of the release flow.
  */
-const MCP_VERSION = "1.45.0";
+const MCP_VERSION = "1.46.0";
 const EXPORT_TOOL_DESCRIPTION = `Export Figma variables to design token files in your codebase. Bidirectional with figma_import_tokens — together they replace Style Dictionary and Tokens Studio's export pipeline for the popular styling methods.
 
 FULLY-IMPLEMENTED OUTPUT FORMATS:

package/dist/core/write-tools.d.ts

@@ -1,13 +1,25 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare const MOTION_VALUE_DOC = "TIMING values are seconds (a number like 0.3, or '300ms' / '0.3s'). EASING values are 'cubic-bezier(x1, y1, x2, y2)', a Figma easing name (EASE_IN, EASE_OUT, EASE_IN_AND_OUT, LINEAR, EASE_IN_BACK, EASE_OUT_BACK, EASE_IN_AND_OUT_BACK, GENTLE, QUICK, BOUNCY, SLOW, HOLD) or 'spring(bounce)' with bounce 0\u20131.";
+/** A hex color the Desktop Bridge plugin's own fill/stroke handlers parse. */
+export declare const HEX_COLOR_RE: RegExp;
+export declare const CSS_COLOR_DOC = "Hex ('#FF0000', '#FF000080') or any CSS color: rgb(), hsl(), oklch(), oklab(), lab(), lch() or color(display-p3 \u2026). Fully opaque wide-gamut colors keep their source color space in Figma.";
+/**
+ * Plugin script for fills/strokes given as CSS colors. Hex-only calls keep
+ * going through the plugin's SET_NODE_FILLS / SET_NODE_STROKES handlers;
+ * anything else is parsed by figma.util.solidPaint, which keeps OKLCH / P3
+ * source colors. Variable bindings work the same way as the hex path.
+ */
+export declare const CSS_PAINT_BODY = "\nconst node = await figma.getNodeByIdAsync(P.nodeId);\nif (!node) throw new Error('Node not found: ' + P.nodeId);\nif (!(P.target in node)) throw new Error('Node type ' + node.type + ' does not support ' + P.target);\nconst paints = [];\nconst requested = [];\nfor (const item of P.paints) {\n  let paint;\n  try { paint = figma.util.solidPaint(item.color || '#000000'); requested.push(paint.color.sourceColor ? paint.color.sourceColor.space : 'SRGB'); }\n  catch (e) { throw new Error('Could not read color ' + JSON.stringify(item.color) + '. Use hex or a CSS color such as oklch(60% 0.2 250) or color(display-p3 1 0 0).'); }\n  if (paint.opacity === 1 && item.opacity !== undefined) paint = Object.assign({}, paint, { opacity: item.opacity });\n  if (item.variableId) {\n    const v = await figma.variables.getVariableByIdAsync(item.variableId);\n    if (!v) throw new Error('Variable not found: \"' + item.variableId + '\". Pass a local variable id from figma_get_variables (e.g. \"VariableID:1:23\"). Library variables must be imported first via figma_import_library_variable.');\n    paint = figma.variables.setBoundVariableForPaint(paint, 'color', v);\n  }\n  paints.push(paint);\n}\nnode[P.target] = paints;\nif (P.strokeWeight !== undefined) node.strokeWeight = P.strokeWeight;\nconst spaces = node[P.target].map(p => (p.color && p.color.sourceColor ? p.color.sourceColor.space : 'SRGB'));\nconst out = { node: { id: node.id, name: node.name }, colorSpaces: spaces };\nconst profile = figma.root.documentColorProfile;\nif (profile) out.documentColorProfile = profile;\nconst notes = [];\nconst dropped = requested.map((s, i) => (s !== 'SRGB' && spaces[i] === 'SRGB' && !P.paints[i].variableId ? i : -1)).filter(i => i >= 0);\nif (dropped.length) notes.push('Figma keeps an OKLCH or Display P3 source color only on fully opaque paints, so ' + P.target + ' ' + dropped.join(', ') + ' (below 100% opacity) ' + (dropped.length > 1 ? 'are' : 'is') + ' stored as sRGB.');\nif (profile === 'SRGB' && spaces.some(s => s !== 'SRGB')) notes.push('This file uses the sRGB color profile, so wide-gamut colors display clamped to sRGB. The source color is kept and shows in full in a Display P3 file.');\nif (notes.length) out.note = notes.join(' ');\nreturn out;\n";
+/**
+ * Plugin script for the text options that need the Plugin API directly:
+ * text wrap style and variable-font axes, plus font size/family/style when
+ * figma_set_text is called without new text.
+ */
+export declare const TEXT_STYLE_BODY = "\nconst node = await figma.getNodeByIdAsync(P.nodeId);\nif (!node) throw new Error('Node not found: ' + P.nodeId);\nif (node.type !== 'TEXT') throw new Error('Node ' + P.nodeId + ' is a ' + node.type + ', not a TEXT node');\nconst len = node.characters.length;\nfor (const f of (len ? node.getRangeAllFontNames(0, len) : [node.fontName])) { if (f !== figma.mixed) await figma.loadFontAsync(f); }\nconst current = node.fontName !== figma.mixed ? node.fontName : null;\nconst family = P.fontFamily || (current && current.family);\nconst style = P.fontStyle ? P.fontStyle.replace(/^(Semi|Extra|Ultra|Demi)(Bold|Light)$/i, '$1 $2') : undefined;\nif (P.fontVariations) {\n  if (!family) throw new Error('This text uses several fonts. Pass fontFamily to set font variations.');\n  const axes = figma.getFontFamilyVariationAxes(family);\n  if (!axes) throw new Error(family + ' is not a variable font, so it has no variation axes.');\n  const unknown = Object.keys(P.fontVariations).filter(a => !axes.includes(a));\n  if (unknown.length) throw new Error(family + ' has no ' + unknown.join(', ') + ' axis. Its axes are: ' + axes.join(', ') + '.');\n  const font = { family, variationSettings: P.fontVariations };\n  if (style) font.style = style;\n  await figma.loadFontAsync(font);\n  node.fontName = font;\n} else if (P.fontFamily || style) {\n  if (!family) throw new Error('This text uses several fonts. Pass fontFamily too.');\n  const font = { family, style: style || (current && current.family === family ? current.style : 'Regular') };\n  await figma.loadFontAsync(font);\n  node.fontName = font;\n}\nif (P.fontSize !== undefined) node.fontSize = P.fontSize;\nif (P.textWrapStyle !== undefined) node.textWrapStyle = P.textWrapStyle;\nconst fn = node.fontName !== figma.mixed ? node.fontName : 'mixed';\nreturn { node: { id: node.id, name: node.name }, fontName: fn, fontSize: node.fontSize !== figma.mixed ? node.fontSize : 'mixed', textWrapStyle: node.textWrapStyle };\n";
 /**
  * Plugin-side converter for motion variable values (see MOTION_VALUE_DOC).
  * Non-motion types pass through unchanged. Inlined into variable scripts.
  */
 export declare const MOTION_VALUE_JS = "\nfunction motionValue(type, value) {\n  if (type === 'TIMING') {\n    if (typeof value === 'number') return value;\n    const m = String(value).trim().match(/^(\\d*\\.?\\d+)\\s*(ms|s)?$/i);\n    if (!m) throw new Error('TIMING value ' + JSON.stringify(value) + ' is not a duration (use seconds, \"300ms\" or \"0.3s\")');\n    return m[2] && m[2].toLowerCase() === 'ms' ? Number(m[1]) / 1000 : Number(m[1]);\n  }\n  if (type === 'EASING') {\n    if (value && typeof value === 'object') return value;\n    const str = String(value).trim();\n    const bez = str.match(/^cubic-bezier\\(([^)]*)\\)$/i);\n    if (bez) {\n      const n = bez[1].split(',').map(Number);\n      if (n.length !== 4 || n.some(isNaN)) throw new Error('Invalid cubic-bezier: ' + str);\n      return { type: 'CUSTOM_CUBIC_BEZIER', easingFunctionCubicBezier: { x1: n[0], y1: n[1], x2: n[2], y2: n[3] } };\n    }\n    const spring = str.match(/^spring\\(\\s*(\\d*\\.?\\d+)\\s*\\)$/i);\n    if (spring) return { type: 'CUSTOM_SPRING', easingFunctionSpring: { bounce: Number(spring[1]) } };\n    const named = ['EASE_IN','EASE_OUT','EASE_IN_AND_OUT','LINEAR','EASE_IN_BACK','EASE_OUT_BACK','EASE_IN_AND_OUT_BACK','GENTLE','QUICK','BOUNCY','SLOW','HOLD'];\n    if (named.indexOf(str.toUpperCase()) !== -1) return { type: str.toUpperCase() };\n    throw new Error('EASING value ' + JSON.stringify(value) + ' is not cubic-bezier(...), spring(bounce) or a Figma easing name');\n  }\n  return value;\n}\n";
-/**
- * Register write/manipulation tools that require a Desktop Bridge connector.
- * Used by both local mode (src/local.ts) and cloud mode (src/index.ts).
- */
 export declare function registerWriteTools(server: McpServer, getDesktopConnector: () => Promise<any>): void;
 //# sourceMappingURL=write-tools.d.ts.map

package/dist/core/write-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../../src/core/write-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,eAAO,MAAM,gBAAgB,2TACuR,CAAC;AAErT;;;GAGG;AACH,eAAO,MAAM,eAAe,87CAyB3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,QA+mGvC"}
+{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../../src/core/write-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,eAAO,MAAM,gBAAgB,2TACuR,CAAC;AAErT,8EAA8E;AAC9E,eAAO,MAAM,YAAY,QAAiD,CAAC;AAE3E,eAAO,MAAM,aAAa,oMACmK,CAAC;AAE9L;;;;;GAKG;AACH,eAAO,MAAM,cAAc,ytEA8B1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,w7DA6B3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,87CAyB3B,CAAC;AAkBF,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,QA4oGvC"}

package/dist/core/write-tools.js

@@ -2,6 +2,81 @@ import { z } from "zod";
 import { createChildLogger } from "./logger.js";
 const logger = createChildLogger({ component: "write-tools" });
 export const MOTION_VALUE_DOC = "TIMING values are seconds (a number like 0.3, or '300ms' / '0.3s'). EASING values are 'cubic-bezier(x1, y1, x2, y2)', a Figma easing name (EASE_IN, EASE_OUT, EASE_IN_AND_OUT, LINEAR, EASE_IN_BACK, EASE_OUT_BACK, EASE_IN_AND_OUT_BACK, GENTLE, QUICK, BOUNCY, SLOW, HOLD) or 'spring(bounce)' with bounce 0–1.";
+/** A hex color the Desktop Bridge plugin's own fill/stroke handlers parse. */
+export const HEX_COLOR_RE = /^#?([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+export const CSS_COLOR_DOC = "Hex ('#FF0000', '#FF000080') or any CSS color: rgb(), hsl(), oklch(), oklab(), lab(), lch() or color(display-p3 …). Fully opaque wide-gamut colors keep their source color space in Figma.";
+/**
+ * Plugin script for fills/strokes given as CSS colors. Hex-only calls keep
+ * going through the plugin's SET_NODE_FILLS / SET_NODE_STROKES handlers;
+ * anything else is parsed by figma.util.solidPaint, which keeps OKLCH / P3
+ * source colors. Variable bindings work the same way as the hex path.
+ */
+export const CSS_PAINT_BODY = `
+const node = await figma.getNodeByIdAsync(P.nodeId);
+if (!node) throw new Error('Node not found: ' + P.nodeId);
+if (!(P.target in node)) throw new Error('Node type ' + node.type + ' does not support ' + P.target);
+const paints = [];
+const requested = [];
+for (const item of P.paints) {
+  let paint;
+  try { paint = figma.util.solidPaint(item.color || '#000000'); requested.push(paint.color.sourceColor ? paint.color.sourceColor.space : 'SRGB'); }
+  catch (e) { throw new Error('Could not read color ' + JSON.stringify(item.color) + '. Use hex or a CSS color such as oklch(60% 0.2 250) or color(display-p3 1 0 0).'); }
+  if (paint.opacity === 1 && item.opacity !== undefined) paint = Object.assign({}, paint, { opacity: item.opacity });
+  if (item.variableId) {
+    const v = await figma.variables.getVariableByIdAsync(item.variableId);
+    if (!v) throw new Error('Variable not found: "' + item.variableId + '". Pass a local variable id from figma_get_variables (e.g. "VariableID:1:23"). Library variables must be imported first via figma_import_library_variable.');
+    paint = figma.variables.setBoundVariableForPaint(paint, 'color', v);
+  }
+  paints.push(paint);
+}
+node[P.target] = paints;
+if (P.strokeWeight !== undefined) node.strokeWeight = P.strokeWeight;
+const spaces = node[P.target].map(p => (p.color && p.color.sourceColor ? p.color.sourceColor.space : 'SRGB'));
+const out = { node: { id: node.id, name: node.name }, colorSpaces: spaces };
+const profile = figma.root.documentColorProfile;
+if (profile) out.documentColorProfile = profile;
+const notes = [];
+const dropped = requested.map((s, i) => (s !== 'SRGB' && spaces[i] === 'SRGB' && !P.paints[i].variableId ? i : -1)).filter(i => i >= 0);
+if (dropped.length) notes.push('Figma keeps an OKLCH or Display P3 source color only on fully opaque paints, so ' + P.target + ' ' + dropped.join(', ') + ' (below 100% opacity) ' + (dropped.length > 1 ? 'are' : 'is') + ' stored as sRGB.');
+if (profile === 'SRGB' && spaces.some(s => s !== 'SRGB')) notes.push('This file uses the sRGB color profile, so wide-gamut colors display clamped to sRGB. The source color is kept and shows in full in a Display P3 file.');
+if (notes.length) out.note = notes.join(' ');
+return out;
+`;
+/**
+ * Plugin script for the text options that need the Plugin API directly:
+ * text wrap style and variable-font axes, plus font size/family/style when
+ * figma_set_text is called without new text.
+ */
+export const TEXT_STYLE_BODY = `
+const node = await figma.getNodeByIdAsync(P.nodeId);
+if (!node) throw new Error('Node not found: ' + P.nodeId);
+if (node.type !== 'TEXT') throw new Error('Node ' + P.nodeId + ' is a ' + node.type + ', not a TEXT node');
+const len = node.characters.length;
+for (const f of (len ? node.getRangeAllFontNames(0, len) : [node.fontName])) { if (f !== figma.mixed) await figma.loadFontAsync(f); }
+const current = node.fontName !== figma.mixed ? node.fontName : null;
+const family = P.fontFamily || (current && current.family);
+const style = P.fontStyle ? P.fontStyle.replace(/^(Semi|Extra|Ultra|Demi)(Bold|Light)$/i, '$1 $2') : undefined;
+if (P.fontVariations) {
+  if (!family) throw new Error('This text uses several fonts. Pass fontFamily to set font variations.');
+  const axes = figma.getFontFamilyVariationAxes(family);
+  if (!axes) throw new Error(family + ' is not a variable font, so it has no variation axes.');
+  const unknown = Object.keys(P.fontVariations).filter(a => !axes.includes(a));
+  if (unknown.length) throw new Error(family + ' has no ' + unknown.join(', ') + ' axis. Its axes are: ' + axes.join(', ') + '.');
+  const font = { family, variationSettings: P.fontVariations };
+  if (style) font.style = style;
+  await figma.loadFontAsync(font);
+  node.fontName = font;
+} else if (P.fontFamily || style) {
+  if (!family) throw new Error('This text uses several fonts. Pass fontFamily too.');
+  const font = { family, style: style || (current && current.family === family ? current.style : 'Regular') };
+  await figma.loadFontAsync(font);
+  node.fontName = font;
+}
+if (P.fontSize !== undefined) node.fontSize = P.fontSize;
+if (P.textWrapStyle !== undefined) node.textWrapStyle = P.textWrapStyle;
+const fn = node.fontName !== figma.mixed ? node.fontName : 'mixed';
+return { node: { id: node.id, name: node.name }, fontName: fn, fontSize: node.fontSize !== figma.mixed ? node.fontSize : 'mixed', textWrapStyle: node.textWrapStyle };
+`;
 /**
  * Plugin-side converter for motion variable values (see MOTION_VALUE_DOC).
  * Non-motion types pass through unchanged. Inlined into variable scripts.
@@ -36,6 +111,14 @@ function motionValue(type, value) {
  * Register write/manipulation tools that require a Desktop Bridge connector.
  * Used by both local mode (src/local.ts) and cloud mode (src/index.ts).
  */
+async function setCssPaints(connector, payload, message) {
+    const result = await connector.executeCodeViaUI(`const P = ${JSON.stringify(payload)};\n${CSS_PAINT_BODY}`, 15000);
+    if (!result?.success)
+        throw new Error(result?.error || `Failed to set ${payload.target}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify({ success: true, message, ...result.result }) }],
+    };
+}
 export function registerWriteTools(server, getDesktopConnector) {
     // ============================================================================
     // EXECUTION TOOL
@@ -1410,7 +1493,7 @@ After instantiating components, use figma_take_screenshot to verify the result l
         }
     });
     // Tool: Set Node Fills
-    server.tool("figma_set_fills", "Set the fill colors on a node. Accepts hex color strings (e.g., '#FF0000'). To bind a fill to a design token / color variable, pass that fill's variableId — the variable drives the color and this works on any Figma plan via the bridge (no raw figma_execute needed).", {
+    server.tool("figma_set_fills", "Set the fill colors on a node. Accepts hex or CSS colors, including oklch() and color(display-p3 …). To bind a fill to a design token / color variable, pass that fill's variableId — the variable drives the color and this works on any Figma plan via the bridge (no raw figma_execute needed).", {
         nodeId: z.string().describe("The node ID to modify"),
         fills: z
             .array(z.object({
@@ -1420,7 +1503,7 @@ After instantiating components, use figma_take_screenshot to verify the result l
             color: z
                 .string()
                 .optional()
-                .describe("Hex color string (e.g., '#FF0000', '#FF000080' for transparency). Optional when variableId is provided."),
+                .describe(`${CSS_COLOR_DOC} Optional when variableId is provided.`),
             opacity: z
                 .number()
                 .optional()
@@ -1434,6 +1517,9 @@ After instantiating components, use figma_take_screenshot to verify the result l
     }, async ({ nodeId, fills }) => {
         try {
             const connector = await getDesktopConnector();
+            if (fills.some((f) => f.color !== undefined && !HEX_COLOR_RE.test(f.color.trim()))) {
+                return await setCssPaints(connector, { nodeId, target: "fills", paints: fills }, "Fills updated");
+            }
             const result = await connector.setNodeFills(nodeId, fills);
             if (!result.success) {
                 throw new Error(result.error || "Failed to set fills");
@@ -1510,7 +1596,7 @@ After instantiating components, use figma_take_screenshot to verify the result l
         }
     });
     // Tool: Set Node Strokes
-    server.tool("figma_set_strokes", "Set the stroke (border) on a node. Accepts hex color strings and optional stroke weight. To bind a stroke to a design token / color variable, pass that stroke's variableId — works on any Figma plan via the bridge.", {
+    server.tool("figma_set_strokes", "Set the stroke (border) on a node. Accepts hex or CSS colors (including oklch() and color(display-p3 …)) and an optional stroke weight. To bind a stroke to a design token / color variable, pass that stroke's variableId — works on any Figma plan via the bridge.", {
         nodeId: z.string().describe("The node ID to modify"),
         strokes: z
             .array(z.object({
@@ -1518,7 +1604,7 @@ After instantiating components, use figma_take_screenshot to verify the result l
             color: z
                 .string()
                 .optional()
-                .describe("Hex color string. Optional when variableId is provided."),
+                .describe(`${CSS_COLOR_DOC} Optional when variableId is provided.`),
             opacity: z.number().optional().describe("Opacity 0-1"),
             variableId: z
                 .string()
@@ -1533,6 +1619,9 @@ After instantiating components, use figma_take_screenshot to verify the result l
     }, async ({ nodeId, strokes, strokeWeight }) => {
         try {
             const connector = await getDesktopConnector();
+            if (strokes.some((f) => f.color !== undefined && !HEX_COLOR_RE.test(f.color.trim()))) {
+                return await setCssPaints(connector, { nodeId, target: "strokes", paints: strokes, strokeWeight }, "Strokes updated");
+            }
             const result = await connector.setNodeStrokes(nodeId, strokes, strokeWeight);
             if (!result.success) {
                 throw new Error(result.error || "Failed to set strokes");
@@ -1681,9 +1770,9 @@ After instantiating components, use figma_take_screenshot to verify the result l
         }
     });
     // Tool: Set Text Content
-    server.tool("figma_set_text", "Set the text content of a text node. Optionally adjust font size and the font family/style. Font style names are space-sensitive ('Semi Bold', not 'SemiBold'), but this tool auto-corrects common no-space variants and falls back gracefully — so you don't need raw figma_execute to change typography.", {
+    server.tool("figma_set_text", "Set the text content of a text node. Optionally adjust font size and the font family/style, the text wrap style (BALANCE or PRETTY, like CSS text-wrap), and variable-font axes (fontVariations, e.g. {wght: 550}). Font style names are space-sensitive ('Semi Bold', not 'SemiBold'), but this tool auto-corrects common no-space variants and falls back gracefully — so you don't need raw figma_execute to change typography. text can be left out to change only the styling.", {
         nodeId: z.string().describe("The text node ID"),
-        text: z.string().describe("The new text content"),
+        text: z.string().optional().describe("The new text content. Leave out to change only the styling"),
         fontSize: z.number().optional().describe("Optional font size to set"),
         fontFamily: z
             .string()
@@ -1693,14 +1782,44 @@ After instantiating components, use figma_take_screenshot to verify the result l
             .string()
             .optional()
             .describe("Optional font style/weight to apply (e.g., 'Bold', 'Semi Bold'). No-space variants like 'SemiBold' are auto-corrected."),
-    }, async ({ nodeId, text, fontSize, fontFamily, fontStyle }) => {
+        textWrapStyle: z
+            .enum(["AUTO", "BALANCE", "PRETTY"])
+            .optional()
+            .describe("How lines break: AUTO (default), BALANCE (even line lengths, for headings) or PRETTY (avoids a lone last word)"),
+        fontVariations: z
+            .record(z.string(), z.number())
+            .optional()
+            .describe("Variable-font axis values by OpenType tag, e.g. {wght: 550, slnt: -5}. Axes you leave out keep the named style's values"),
+    }, async ({ nodeId, text, fontSize, fontFamily, fontStyle, textWrapStyle, fontVariations }) => {
         try {
             const connector = await getDesktopConnector();
-            const result = await connector.setTextContent(nodeId, text, fontSize || fontFamily || fontStyle
-                ? { fontSize, fontFamily, fontStyle }
-                : undefined);
-            if (!result.success) {
-                throw new Error(result.error || "Failed to set text");
+            const styleOnly = text === undefined;
+            if (styleOnly && fontSize === undefined && !fontFamily && !fontStyle && !textWrapStyle && !fontVariations) {
+                throw new Error("Nothing to change: pass text, or a font or wrap option");
+            }
+            let node;
+            if (!styleOnly) {
+                // Variable-font axes are set by the follow-up script, so the
+                // family and style go there too when fontVariations is given.
+                const fontOpts = fontVariations
+                    ? fontSize !== undefined ? { fontSize } : undefined
+                    : fontSize || fontFamily || fontStyle ? { fontSize, fontFamily, fontStyle } : undefined;
+                const result = await connector.setTextContent(nodeId, text, fontOpts);
+                if (!result.success) {
+                    throw new Error(result.error || "Failed to set text");
+                }
+                node = result.node;
+            }
+            let styling;
+            if (styleOnly || textWrapStyle || fontVariations) {
+                const payload = styleOnly
+                    ? { nodeId, fontSize, fontFamily, fontStyle, textWrapStyle, fontVariations }
+                    : { nodeId, textWrapStyle, fontVariations, ...(fontVariations ? { fontFamily, fontStyle } : {}) };
+                const res = await connector.executeCodeViaUI(`const P = ${JSON.stringify(payload)};\n${TEXT_STYLE_BODY}`, 15000);
+                if (!res?.success)
+                    throw new Error(res?.error || "Failed to set text styling");
+                styling = res.result;
+                node = node ?? res.result.node;
             }
             return {
                 content: [
@@ -1708,8 +1827,9 @@ After instantiating components, use figma_take_screenshot to verify the result l
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            message: "Text content updated",
-                            node: result.node,
+                            message: styleOnly ? "Text styling updated" : "Text content updated",
+                            node,
+                            ...(styling ? { fontName: styling.fontName, fontSize: styling.fontSize, textWrapStyle: styling.textWrapStyle } : {}),
                         }),
                     },
                 ],