figma-relai 0.2.0 → 0.2.1

package/dist/{chunk-5YB7XMT6.js → chunk-EBP7POOP.js}

@@ -9,7 +9,7 @@ function createServer() {
   return new McpServer(
     {
       name: "Relai",
-      version: "0.2.0"
+      version: "0.2.1"
     },
     {
       instructions: `
@@ -116,6 +116,7 @@ var FIGMA_COMMANDS = [
   "get_relaunch_data",
   // Styling
   "set_fill_color",
+  "set_fills",
   "set_stroke_color",
   "set_corner_radius",
   "set_blend_mode",
@@ -154,6 +155,9 @@ var FIGMA_COMMANDS = [
   "get_component_properties",
   "set_component_properties",
   "detach_instance",
+  "reset_instance",
+  "audit_colors",
+  "find_orphan_instances",
   // Variables
   "get_variable_collections",
   "get_variables",
@@ -705,6 +709,8 @@ var propertiesSchema = z3.object({
   blendMode: blendModeSchema.optional(),
   // Paint
   fillColor: colorSchema.optional(),
+  fills: z3.array(z3.record(z3.unknown())).optional().describe("Raw Paint[] \u2014 replaces the whole fill list; [] clears all fills"),
+  strokes: z3.array(z3.record(z3.unknown())).optional().describe("Raw Paint[] \u2014 replaces the whole stroke list; [] clears all strokes"),
   strokeColor: colorSchema.optional(),
   strokeWeight: z3.number().min(0).optional(),
   cornerRadius: z3.number().min(0).optional(),
@@ -780,6 +786,11 @@ function mapPropertiesToCommands(nodeId, p) {
       layoutSizingHorizontal: p.layoutSizingHorizontal,
       layoutSizingVertical: p.layoutSizingVertical
     });
+  if (p.fills !== void 0 || p.strokes !== void 0)
+    add("set_fills", {
+      ...p.fills !== void 0 ? { fills: p.fills } : {},
+      ...p.strokes !== void 0 ? { strokes: p.strokes } : {}
+    });
   if (p.fillColor !== void 0) add("set_fill_color", { color: p.fillColor });
   if (p.strokeColor !== void 0 || p.strokeWeight !== void 0)
     add("set_stroke_color", {
@@ -1016,7 +1027,7 @@ import { z as z6 } from "zod";
 function register5(server, sendCommand) {
   server.tool(
     "manage_components",
-    "Component workflow: list local components, create a component from a node, create_set (combine components as variants), instantiate (place an instance by componentKey \u2014 imports from the team library if needed), get_props / set_props (component properties on an instance), get_overrides / set_overrides (copy overrides from a source instance to targets), detach.",
+    "Component workflow: list local components, create a component from a node, create_set (combine components as variants), instantiate (place an instance by componentKey \u2014 imports from the team library if needed), get_props / set_props (component properties on an instance), get_overrides / set_overrides (copy overrides from a source instance to targets), reset_instance (clear ALL overrides so the instance re-inherits its main component \u2014 returns property snapshots before/after so you can re-apply what mattered), detach.",
     {
       action: z6.enum([
         "list",
@@ -1027,9 +1038,10 @@ function register5(server, sendCommand) {
         "set_props",
         "get_overrides",
         "set_overrides",
+        "reset_instance",
         "detach"
       ]),
-      nodeId: z6.string().optional().describe("Target node (create/get_props/set_props/detach)"),
+      nodeId: z6.string().optional().describe("Target node (create/get_props/set_props/reset_instance/detach)"),
       componentIds: z6.array(z6.string()).optional().describe("create_set: components to combine"),
       componentKey: z6.string().optional().describe("instantiate: component key (or node id)"),
       x: z6.number().optional().describe("instantiate: position"),
@@ -1079,6 +1091,9 @@ function register5(server, sendCommand) {
               targetNodeIds: args.targetNodeIds
             });
             break;
+          case "reset_instance":
+            result = await sendCommand("reset_instance", { nodeId: args.nodeId });
+            break;
           case "detach":
             result = await sendCommand("detach_instance", { nodeId: args.nodeId });
             break;
@@ -1842,7 +1857,8 @@ function register17(server, sendCommand) {
 // src/tools/v2/context.ts
 var context_exports = {};
 __export(context_exports, {
-  register: () => register18
+  register: () => register18,
+  styleCountsFrom: () => styleCountsFrom
 });
 import { z as z19 } from "zod";
 
@@ -2020,6 +2036,22 @@ function hasBinding(boundVars, prefix) {
 }
 
 // src/tools/v2/context.ts
+function styleCountsFrom(styles) {
+  const counts = { paint: 0, text: 0, effect: 0, grid: 0 };
+  if (Array.isArray(styles)) {
+    for (const s of styles) {
+      const t = (s.type || "").toLowerCase();
+      if (t in counts) counts[t]++;
+    }
+  } else if (styles && typeof styles === "object") {
+    const o = styles;
+    counts.paint = Array.isArray(o.paintStyles) ? o.paintStyles.length : 0;
+    counts.text = Array.isArray(o.textStyles) ? o.textStyles.length : 0;
+    counts.effect = Array.isArray(o.effectStyles) ? o.effectStyles.length : 0;
+    counts.grid = Array.isArray(o.gridStyles) ? o.gridStyles.length : 0;
+  }
+  return { ...counts, total: counts.paint + counts.text + counts.effect + counts.grid };
+}
 function register18(server, sendCommand) {
   server.tool(
     "get_document_overview",
@@ -2035,30 +2067,21 @@ function register18(server, sendCommand) {
           // Older plugin builds don't have the handler — degrade quietly
           sendCommand("get_conventions", {}).catch(() => null)
         ]);
-        const componentCount = docInfo.componentCount ?? 0;
-        const stylesByType = { paint: 0, text: 0, effect: 0, grid: 0 };
-        if (Array.isArray(styles)) {
-          for (const s of styles) {
-            const t = (s.type || "").toLowerCase();
-            if (t === "paint") stylesByType.paint++;
-            else if (t === "text") stylesByType.text++;
-            else if (t === "effect") stylesByType.effect++;
-            else if (t === "grid") stylesByType.grid++;
-          }
-        }
+        const componentCount = docInfo.componentCount ?? null;
+        const stylesByType = styleCountsFrom(styles);
         const data = {
           name: docInfo.name,
           currentPage: docInfo.currentPage,
           pages: docInfo.pages || [],
           counts: {
             components: componentCount,
-            styles: Array.isArray(styles) ? styles.length : 0,
+            styles: stylesByType.total,
             variableCollections: Array.isArray(collections) ? collections.length : 0
           }
         };
         const conventionsText = conventions?.content ?? null;
         return standardResult({
-          summary: `"${data.name}" \u2014 ${data.pages.length} pages, ${data.counts.components} components, ${data.counts.styles} styles, ${data.counts.variableCollections} variable collections` + (conventionsText ? ". This file has conventions \u2014 follow them (see data.conventions)." : ""),
+          summary: `"${data.name}" \u2014 ${data.pages.length} pages, ` + (data.counts.components != null ? `${data.counts.components} components, ` : "") + `${data.counts.styles} styles, ${data.counts.variableCollections} variable collections` + (data.counts.components == null ? " (component inventory via get_design_system)" : "") + (conventionsText ? ". This file has conventions \u2014 follow them (see data.conventions)." : ""),
           data: { ...data, ...conventionsText ? { conventions: conventionsText } : {} },
           recommended_next: [
             { tool: "get_selection_context", reason: "Inspect currently selected nodes" },
@@ -2256,13 +2279,7 @@ function register18(server, sendCommand) {
           modes: Array.isArray(c.modes) ? c.modes : [],
           variableCount: Array.isArray(c.variableIds) ? c.variableIds.length : 0
         }));
-        const stylesByType = { paint: 0, text: 0, effect: 0, grid: 0 };
-        if (Array.isArray(styles)) {
-          for (const s of styles) {
-            const t = (s.type || "").toLowerCase();
-            if (t in stylesByType) stylesByType[t]++;
-          }
-        }
+        const { total: _ignored, ...stylesByType } = styleCountsFrom(styles);
         const totalVars = collectionSummaries.reduce((sum, c) => sum + c.variableCount, 0);
         const data = {
           collections: collectionSummaries,
@@ -2535,7 +2552,25 @@ function registerAnalysisTools(server, sendCommand) {
         }
         const unboundColors = [];
         const counters = { totalProps: 0, boundCount: 0 };
+        let hiddenCount = 0;
+        let scanned = 0;
+        let capped = false;
         for (const id of targetIds) {
+          let audit = null;
+          try {
+            audit = await sendCommand("audit_colors", { nodeId: id }, 6e4);
+          } catch {
+            audit = null;
+          }
+          if (audit && typeof audit.totalProperties === "number") {
+            counters.totalProps += audit.totalProperties;
+            counters.boundCount += audit.boundCount ?? 0;
+            hiddenCount += audit.hiddenCount ?? 0;
+            scanned += audit.scanned ?? 0;
+            capped = capped || !!audit.capped;
+            for (const issue of audit.issues ?? []) unboundColors.push(issue);
+            continue;
+          }
           const [nodeInfo, boundVars] = await Promise.all([
             sendCommand("get_node_info", { nodeId: id, depth: 2, maxNodes: 200 }),
             sendCommand("get_bound_variables", { nodeId: id }).catch(() => null)
@@ -2557,11 +2592,15 @@ function registerAnalysisTools(server, sendCommand) {
           boundCount: counters.boundCount,
           unboundCount: unboundColors.length,
           tokenCoverage,
-          unboundColors
+          unboundColors,
+          ...hiddenCount ? { hiddenCount } : {},
+          ...scanned ? { scanned } : {},
+          ...capped ? { capped } : {}
         };
-        const warnings = unboundColors.length > 0 ? [{ category: "tokens", message: `${unboundColors.length} color(s) not bound to design tokens` }] : [];
+        const visibleIssues = unboundColors.length - hiddenCount;
+        const warnings = unboundColors.length > 0 ? [{ category: "tokens", message: `${unboundColors.length} color(s) not bound to design tokens${hiddenCount ? ` (${hiddenCount} on hidden paints)` : ""}` }] : [];
         return standardResult({
-          summary: `Color audit: ${unboundColors.length} unbound color(s) found. Token coverage: ${Math.round(data.tokenCoverage * 100)}%`,
+          summary: `Color audit: ${visibleIssues} unbound color(s)` + (hiddenCount ? ` + ${hiddenCount} on hidden paints` : "") + `. Token coverage: ${Math.round(data.tokenCoverage * 100)}%` + (capped ? " (scan capped \u2014 large subtree)" : ""),
           data,
           warnings,
           recommended_next: unboundColors.length > 0 ? [
@@ -3159,6 +3198,21 @@ function register20(server, sendCommand) {
             fix: !adequate ? { tool: "update_node", reason: "Increase size to meet touch target minimum", args: { nodeId: targetId } } : void 0
           });
         }
+        try {
+          const orph = await sendCommand("find_orphan_instances", { nodeId: targetId }, 6e4);
+          if (orph && typeof orph.scanned === "number") {
+            const found = orph.orphans ?? [];
+            results.push({
+              rule: "orphaned_instances",
+              passed: found.length === 0,
+              severity: "warning",
+              message: found.length ? `${found.length} instance(s) reference deleted components (of ${orph.scanned} scanned): ${found.slice(0, 3).map((o) => o.name).join(", ")}${found.length > 3 ? "\u2026" : ""}` : `No orphaned instances (${orph.scanned} scanned)`,
+              nodeId: targetId,
+              fix: found.length ? { tool: "manage_components", reason: "Re-instantiate from a living component, or detach deliberately", args: { action: "list" } } : void 0
+            });
+          }
+        } catch {
+        }
         const passed = results.filter((r) => r.passed).length;
         const failed = results.filter((r) => !r.passed).length;
         const data = {
@@ -3459,4 +3513,4 @@ export {
   listToolCatalog,
   registerPrompts
 };
-//# sourceMappingURL=chunk-5YB7XMT6.js.map
+//# sourceMappingURL=chunk-EBP7POOP.js.map