@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/tools/composition.js

@@ -2,35 +2,25 @@
  * MCP tools for Composition operations.
  */
 import { z } from "zod";
+import { callPluginCommand, callPluginWriteCommand } from "./shared.js";
 export function registerCompositionTools(server, queue) {
     server.tool("generate_composition", "Generate a Figma component (or ComponentSet) from a composition JSON file. Creates the component structure, applies styles, binds variables. When the JSON has \"component\": false, creates plain nodes (Frame/Instance) instead of a Component. The fileId can be an internal file ID or a file path like 'compositions/MyButton/MyButton.json'.", {
         fileId: z.string().describe("File path (e.g. 'compositions/MyButton/MyButton.json') or internal file ID"),
         compositionName: z.string().optional().describe("Component name from JSON (e.g. 'MyButton') — used as fallback if fileId doesn't resolve"),
-    }, async ({ fileId, compositionName }) => {
-        const result = await queue.execute("generate_composition", { fileId, compositionName });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
+    }, async ({ fileId, compositionName }) => callPluginWriteCommand(queue, "generate_composition", { fileId, compositionName }, {
+        okFalseErrorCode: "SXL_COMPOSITION_WRITE_FAILED",
+    }));
     server.tool("apply_composition", "Apply a composition JSON to an existing Figma component. Updates structure, styles, and bindings without re-creating. The fileId can be an internal file ID or a file path.", {
         fileId: z.string().describe("File path (e.g. 'compositions/MyButton/MyButton.json') or internal file ID"),
         compositionName: z.string().optional().describe("Component name from JSON — used as fallback"),
-    }, async ({ fileId, compositionName }) => {
-        const result = await queue.execute("apply_composition", { fileId, compositionName });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
+    }, async ({ fileId, compositionName }) => callPluginWriteCommand(queue, "apply_composition", { fileId, compositionName }, {
+        okFalseErrorCode: "SXL_COMPOSITION_WRITE_FAILED",
+    }));
     server.tool("preview_composition", "Preview a composition JSON without applying it. Returns parsed structure and any validation errors. The fileId can be an internal file ID or a file path.", {
         fileId: z.string().describe("File path (e.g. 'compositions/MyButton/MyButton.json') or internal file ID"),
-    }, async ({ fileId }) => {
-        const result = await queue.execute("preview_composition", { fileId });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("check_composition_linked", "Check if a composition is linked to an existing component in the Figma file.", { compositionName: z.string().describe("Name of the composition to check") }, async ({ compositionName }) => {
-        const result = await queue.execute("check_composition_linked", { compositionName });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("inspect_selection", "Inspect the currently selected nodes in Figma. Returns token bindings, composition status, drift status, and node hierarchy.", {}, async () => {
-        const result = await queue.execute("inspect_selection");
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
+    }, async ({ fileId }) => callPluginCommand(queue, "preview_composition", { fileId }));
+    server.tool("check_composition_linked", "Check if a composition is linked to an existing component in the Figma file.", { compositionName: z.string().describe("Name of the composition to check") }, async ({ compositionName }) => callPluginCommand(queue, "check_composition_linked", { compositionName }));
+    server.tool("inspect_selection", "Inspect the currently selected nodes in Figma. Returns token bindings, composition status, drift status, and node hierarchy.", {}, async () => callPluginCommand(queue, "inspect_selection"));
     server.tool("export_composition_json", "Export the selected node (or a node by ID) as composition JSON string — the SINGLE SOURCE OF TRUTH for composition JSON. Produces the exact same output as Dev Mode → Get Code → Designer JSON tab. For non-component nodes (Frame, Group, etc.) the output includes \"component\": false so the JSON can be used to regenerate plain nodes. NEVER hand-craft this JSON from get_node_tree / get_selection — always use this tool.", {
         nodeId: z
             .string()
@@ -40,16 +30,15 @@ export function registerCompositionTools(server, queue) {
         const payload = {};
         if (nodeId)
             payload.nodeId = nodeId;
-        const result = await queue.execute("export_composition_json", payload);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return callPluginCommand(queue, "export_composition_json", payload);
     });
-    server.tool("get_codegen", "Run Figma Dev Mode codegen for the selected node (or by nodeId) and return all generated tabs. This exposes the exact same output the user sees in Dev Mode → Inspect → Code panel, for any language: designer-json (default, includes Props/Structure/Styles/Variables/Transitions/Theme/Code Connect tabs), vue3 (SFC + CSS vars + Code Connect), swiftui (Swift file + Variables), kotlin (Compose file + Variables). Use viewMode to switch between 'styled' (default, tokens preserved), 'decomposed' (composite styles expanded) or 'raw' (all literals).", {
+    server.tool("get_codegen", "Run Figma Dev Mode codegen for the selected node (or by nodeId) and return all generated tabs. This exposes the exact same output the user sees in Dev Mode → Inspect → Code panel, for any language: designer-json (default, includes Props/Structure/Styles/Variables/Transitions/Theme/Code Connect tabs), vue3 (SFC + CSS vars + Code Connect), swiftui (Swift file + Variables), kotlin (Compose file + Variables), divkit (DivKit JSON card). Use viewMode to switch between 'styled' (default, tokens preserved), 'decomposed' (composite styles expanded) or 'raw' (all literals).", {
         nodeId: z
             .string()
             .optional()
             .describe("Figma node id. Omit to use current selection (first selected node)."),
         language: z
-            .enum(["designer-json", "vue3", "swiftui", "kotlin"])
+            .enum(["designer-json", "vue3", "swiftui", "kotlin", "divkit"])
             .optional()
             .describe("Target language for codegen. Defaults to 'designer-json'."),
         viewMode: z
@@ -64,12 +53,8 @@ export function registerCompositionTools(server, queue) {
             payload.language = language;
         if (viewMode)
             payload.viewMode = viewMode;
-        const result = await queue.execute("get_codegen", payload);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("list_compositions", "List every composition JSON file in the plugin workspace (entries with $type:composition). Returns fileId, fileName, folder, gitPath, compositionName, and whether it represents a Component (component:true) or plain Frames (component:false). Use this to discover targets for generate_composition / apply_composition.", {}, async () => {
-        const result = await queue.execute("list_compositions", {});
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return callPluginCommand(queue, "get_codegen", payload);
     });
+    server.tool("list_compositions", "List every composition JSON file in the plugin workspace (entries with $type:composition). Returns fileId, fileName, folder, gitPath, compositionName, and whether it represents a Component (component:true) or plain Frames (component:false). Use this to discover targets for generate_composition / apply_composition.", {}, async () => callPluginCommand(queue, "list_compositions", {}));
 }
 //# sourceMappingURL=composition.js.map

package/dist/tools/composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../src/tools/composition.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,KAAmB;IAC7E,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,oVAAoV,EACpV;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;QACzG,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;KAC3I,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QACxF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,6KAA6K,EAC7K;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;QACzG,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KAC/F,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QACrF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,2JAA2J,EAC3J;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;KAC1G,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,8EAA8E,EAC9E,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC,EAAE,EAC5E,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;QACpF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,8HAA8H,EAC9H,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,oaAAoa,EACpa;QACE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;KACnF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,iiBAAiiB,EACjiB;QACE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;aACpD,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;QACxE,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;aACrC,QAAQ,EAAE;aACV,QAAQ,CAAC,2IAA2I,CAAC;KACzJ,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QACvC,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QACpC,IAAI,QAAQ;YAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1C,IAAI,QAAQ;YAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,6TAA6T,EAC7T,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../src/tools/composition.ts"],"names":[],"mappings":"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"}

package/dist/tools/compositions-orchestration.d.ts

@@ -36,37 +36,37 @@ export declare const compositionsOrchestrationSchemas: {
         anchorNodeId: z.ZodOptional<z.ZodString>;
         dryRun: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        dryRun?: boolean | undefined;
+        operation?: "auto" | "apply" | "generate" | undefined;
+        prefix?: string | undefined;
         fileIds?: string[] | undefined;
         names?: string[] | undefined;
-        prefix?: string | undefined;
-        operation?: "auto" | "generate" | "apply" | undefined;
         continueOnError?: boolean | undefined;
         anchorNodeId?: string | undefined;
-        dryRun?: boolean | undefined;
     }, {
+        dryRun?: boolean | undefined;
+        operation?: "auto" | "apply" | "generate" | undefined;
+        prefix?: string | undefined;
         fileIds?: string[] | undefined;
         names?: string[] | undefined;
-        prefix?: string | undefined;
-        operation?: "auto" | "generate" | "apply" | undefined;
         continueOnError?: boolean | undefined;
         anchorNodeId?: string | undefined;
-        dryRun?: boolean | undefined;
     }>, {
+        dryRun?: boolean | undefined;
+        operation?: "auto" | "apply" | "generate" | undefined;
+        prefix?: string | undefined;
         fileIds?: string[] | undefined;
         names?: string[] | undefined;
-        prefix?: string | undefined;
-        operation?: "auto" | "generate" | "apply" | undefined;
         continueOnError?: boolean | undefined;
         anchorNodeId?: string | undefined;
-        dryRun?: boolean | undefined;
     }, {
+        dryRun?: boolean | undefined;
+        operation?: "auto" | "apply" | "generate" | undefined;
+        prefix?: string | undefined;
         fileIds?: string[] | undefined;
         names?: string[] | undefined;
-        prefix?: string | undefined;
-        operation?: "auto" | "generate" | "apply" | undefined;
         continueOnError?: boolean | undefined;
         anchorNodeId?: string | undefined;
-        dryRun?: boolean | undefined;
     }>;
     auditDriftRequestZod: z.ZodObject<{
         fileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -75,15 +75,15 @@ export declare const compositionsOrchestrationSchemas: {
         includeUnlinked: z.ZodOptional<z.ZodBoolean>;
         includeLinked: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        prefix?: string | undefined;
         fileIds?: string[] | undefined;
         names?: string[] | undefined;
-        prefix?: string | undefined;
         includeUnlinked?: boolean | undefined;
         includeLinked?: boolean | undefined;
     }, {
+        prefix?: string | undefined;
         fileIds?: string[] | undefined;
         names?: string[] | undefined;
-        prefix?: string | undefined;
         includeUnlinked?: boolean | undefined;
         includeLinked?: boolean | undefined;
     }>;

package/dist/tools/compositions-orchestration.js

@@ -24,7 +24,7 @@
  *     for design systems with hundreds of components.
  */
 import { z } from "zod";
-import { callPluginCommand } from "./shared.js";
+import { callPluginCommand, callPluginWriteCommand } from "./shared.js";
 // ─── Shared building blocks ───────────────────────────────────────────────────
 const stringArrayZod = z
     .array(z.string().min(1))
@@ -92,7 +92,7 @@ export function registerCompositionsOrchestrationTools(server, queue) {
     // — bulk_generate_compositions ---------------------------------------------
     server.tool("bulk_generate_compositions", "Bulk generate / apply MANY composition files in a single MCP call. Discovers every composition in the plugin workspace (same source as `list_compositions`), filters by `fileIds | names | prefix`, then runs the per-file generate/apply pipeline. Per-item errors are isolated — one bad composition does NOT abort the run (set `continueOnError: false` to opt out). `operation` controls the effective branch: `auto` (default) keeps the manual UX (apply when tracking exists, otherwise generate), `generate` forces a fresh ComponentSet rebuild, `apply` forces apply onto the existing component. `dryRun: true` returns the resolved plan WITHOUT touching the canvas — Dev Mode safe. Use it after `audit_composition_drift` to selectively re-generate only drifted components. CANVAS WRITE in apply / generate mode (Dev Mode blocks unless `dryRun: true`). Recipe: `sxl://agent/recipes/bulk-compositions`.", {
         request: bulkGenerateRequestZod.describe("Filter set + operation + execution mode. All filters are AND-ed (a composition must satisfy every provided filter). Omit all three filters to operate on every composition in the workspace."),
-    }, async ({ request }) => callPluginCommand(queue, "bulk_generate_compositions", request));
+    }, async ({ request }) => callPluginWriteCommand(queue, "bulk_generate_compositions", request, { okFalseErrorCode: "SXL_COMPOSITION_WRITE_FAILED" }));
     // — audit_composition_drift -------------------------------------------------
     server.tool("audit_composition_drift", "READ-ONLY drift detector between workspace composition files and the Figma components they tracked in `diff-id.compositions`. Reports per-composition status: `linked` (tracking valid + Figma node matches), `unlinked` (composition was never generated — no tracking entry), `drift` (Figma node renamed or variant count mismatch vs the JSON), `missing` (tracking points to a deleted node). Returns `findings[]` with human-readable `reason`. Fully Dev-Mode-compatible — never touches the canvas. Pair with `bulk_generate_compositions { fileIds: drifted }` to fix drift in one round-trip. Recipe: `sxl://agent/recipes/composition-drift`.", {
         request: auditDriftRequestZod.describe("Filter set + report flags. Default returns every composition + every status."),

package/dist/tools/compositions-orchestration.js.map

@@ -1 +1 @@
-{"version":3,"file":"compositions-orchestration.js","sourceRoot":"","sources":["../../src/tools/compositions-orchestration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compositions-orchestration.js","sourceRoot":"","sources":["../../src/tools/compositions-orchestration.ts"],"names":[],"mappings":"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"}