@sxl-studio/bridge 1.2.0

package/dist/mcp-factory.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared MCP tool registration for SXL Studio Bridge.
+ * Used by stdio transport (Cursor spawn) and Streamable HTTP at /mcp (Cursor URL).
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CommandQueue } from "./command-queue.js";
+export declare function createBridgeMcpServer(commandQueue: CommandQueue): McpServer;

package/dist/mcp-factory.js

@@ -0,0 +1,30 @@
+/**
+ * Shared MCP tool registration for SXL Studio Bridge.
+ * Used by stdio transport (Cursor spawn) and Streamable HTTP at /mcp (Cursor URL).
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerCompositionTools } from "./tools/composition.js";
+import { registerDataTools } from "./tools/data.js";
+import { registerDiagnosticTools } from "./tools/diagnostics.js";
+import { registerFigmaNodeTools } from "./tools/figma-nodes.js";
+import { registerRcExtendedCanvasTools } from "./tools/figma-rc-extended.js";
+import { registerGitTools } from "./tools/git.js";
+import { registerTokenTools } from "./tools/tokens.js";
+import { SXL_BRIDGE_MCP_INSTRUCTIONS } from "./sxl-mcp-instructions.js";
+export function createBridgeMcpServer(commandQueue) {
+    const server = new McpServer({
+        name: "@sxl-studio/bridge",
+        version: "1.2.0",
+    }, {
+        instructions: SXL_BRIDGE_MCP_INSTRUCTIONS,
+    });
+    registerTokenTools(server, commandQueue);
+    registerCompositionTools(server, commandQueue);
+    registerDataTools(server, commandQueue);
+    registerDiagnosticTools(server, commandQueue);
+    registerFigmaNodeTools(server, commandQueue);
+    registerRcExtendedCanvasTools(server, commandQueue);
+    registerGitTools(server, commandQueue);
+    return server;
+}
+//# sourceMappingURL=mcp-factory.js.map

package/dist/mcp-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-factory.js","sourceRoot":"","sources":["../src/mcp-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE,MAAM,UAAU,qBAAqB,CAAC,YAA0B;IAC9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,2BAA2B;KAC1C,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,wBAAwB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/C,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,6BAA6B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpD,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Server for SXL Studio Bridge (stdio transport).
+ *
+ * Optional: Cursor can use HTTP MCP at http://127.0.0.1:{BRIDGE_PORT}/mcp instead
+ * (see http-api.ts) so the IDE does not need to spawn this process.
+ */
+import type { CommandQueue } from "./command-queue.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function startMcpServer(commandQueue: CommandQueue): Promise<McpServer>;

package/dist/mcp-server.js

@@ -0,0 +1,16 @@
+/**
+ * MCP Server for SXL Studio Bridge (stdio transport).
+ *
+ * Optional: Cursor can use HTTP MCP at http://127.0.0.1:{BRIDGE_PORT}/mcp instead
+ * (see http-api.ts) so the IDE does not need to spawn this process.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createBridgeMcpServer } from "./mcp-factory.js";
+export async function startMcpServer(commandQueue) {
+    const server = createBridgeMcpServer(commandQueue);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[MCP] SXL Studio Bridge MCP server started (stdio)");
+    return server;
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAA0B;IAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Session manager for Bridge server.
+ *
+ * Tracks plugin connection state and manages heartbeat timeouts.
+ */
+import type { SessionInfo } from "./types.js";
+export declare class SessionManager {
+    private _connected;
+    private _pluginName;
+    private _connectedAt;
+    private _lastHeartbeat;
+    private _heartbeatCheck;
+    private _onDisconnect;
+    get connected(): boolean;
+    get info(): SessionInfo;
+    onDisconnect(handler: () => void): void;
+    connect(pluginName?: string): void;
+    heartbeat(): void;
+    disconnect(): void;
+    private startHeartbeatMonitor;
+    private stopHeartbeatMonitor;
+}

package/dist/session.js

@@ -0,0 +1,64 @@
+/**
+ * Session manager for Bridge server.
+ *
+ * Tracks plugin connection state and manages heartbeat timeouts.
+ */
+const HEARTBEAT_TIMEOUT_MS = 30_000;
+export class SessionManager {
+    _connected = false;
+    _pluginName = null;
+    _connectedAt = null;
+    _lastHeartbeat = null;
+    _heartbeatCheck = null;
+    _onDisconnect = null;
+    get connected() {
+        return this._connected;
+    }
+    get info() {
+        return {
+            connected: this._connected,
+            pluginName: this._pluginName,
+            connectedAt: this._connectedAt,
+            lastHeartbeat: this._lastHeartbeat,
+        };
+    }
+    onDisconnect(handler) {
+        this._onDisconnect = handler;
+    }
+    connect(pluginName) {
+        this._connected = true;
+        this._pluginName = pluginName ?? "SXL Studio";
+        this._connectedAt = Date.now();
+        this._lastHeartbeat = Date.now();
+        this.startHeartbeatMonitor();
+        console.error(`[Session] Plugin connected: ${this._pluginName}`);
+    }
+    heartbeat() {
+        this._lastHeartbeat = Date.now();
+    }
+    disconnect() {
+        this.stopHeartbeatMonitor();
+        this._connected = false;
+        this._pluginName = null;
+        this._connectedAt = null;
+        this._lastHeartbeat = null;
+        console.error("[Session] Plugin disconnected");
+    }
+    startHeartbeatMonitor() {
+        this.stopHeartbeatMonitor();
+        this._heartbeatCheck = setInterval(() => {
+            if (this._lastHeartbeat && Date.now() - this._lastHeartbeat > HEARTBEAT_TIMEOUT_MS) {
+                console.warn("[Session] Heartbeat timeout — plugin may be unresponsive");
+                this.disconnect();
+                this._onDisconnect?.();
+            }
+        }, HEARTBEAT_TIMEOUT_MS / 2);
+    }
+    stopHeartbeatMonitor() {
+        if (this._heartbeatCheck) {
+            clearInterval(this._heartbeatCheck);
+            this._heartbeatCheck = null;
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC,MAAM,OAAO,cAAc;IACjB,UAAU,GAAG,KAAK,CAAC;IACnB,WAAW,GAAkB,IAAI,CAAC;IAClC,YAAY,GAAkB,IAAI,CAAC;IACnC,cAAc,GAAkB,IAAI,CAAC;IACrC,eAAe,GAA0C,IAAI,CAAC;IAC9D,aAAa,GAAwB,IAAI,CAAC;IAElD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,IAAI;QACN,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,aAAa,EAAE,IAAI,CAAC,cAAc;SACnC,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,OAAmB;QAC9B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,UAAmB;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,UAAU,IAAI,YAAY,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEjC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,OAAO,CAAC,KAAK,CAAC,+BAA+B,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,SAAS;QACP,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAE3B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACjD,CAAC;IAEO,qBAAqB;QAC3B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,GAAG,oBAAoB,EAAE,CAAC;gBACnF,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;gBACzE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,EAAE,oBAAoB,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IAEO,oBAAoB;QAC1B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;CACF"}

package/dist/sxl-mcp-instructions.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MCP server instructions for Cursor / other agents using SXL Studio Bridge.
+ * Keep in sync with Plugin/docs/ru/60-remote-connect.md (agent workflows).
+ */
+export declare const SXL_BRIDGE_MCP_INSTRUCTIONS: string;

package/dist/sxl-mcp-instructions.js

@@ -0,0 +1,36 @@
+/**
+ * MCP server instructions for Cursor / other agents using SXL Studio Bridge.
+ * Keep in sync with Plugin/docs/ru/60-remote-connect.md (agent workflows).
+ */
+export const SXL_BRIDGE_MCP_INSTRUCTIONS = `
+You are assisting with Figma via the SXL Studio plugin and this Bridge.
+
+## Two MCP servers (recommended)
+- **Official Figma MCP** (often remote): design context from links, selection, native file ops (e.g. use_figma). Parse node-id from figma.com URLs (replace "-" with ":" in node-id).
+- **SXL Studio Bridge (this server)**: plugin-only commands — compositions, token files, Git in the plugin, and whitelisted canvas helpers.
+
+## Prerequisites
+1. Bridge running (HTTP/WebSocket on BRIDGE_PORT).
+2. Figma: SXL Studio plugin open, **Remote Connect** session active.
+
+## Workflow: component from layout + composition JSON + generate in Figma
+1. Use **Figma MCP** (or user selection) to identify the **nodeId** of the frame/component the user wants as the composition source.
+2. Call **export_composition_json** with \`payload.nodeId\` (or select the node in Figma first). You receive \`compositionJson\`.
+3. In the IDE, **write** a new \`.json\` composition file in the user repo (path they expect under tokens/compositions).
+4. Call **save_token_file** if the file is managed by the plugin, or ensure the plugin sees the file via normal sync.
+5. Call **generate_composition** or **apply_composition** with \`fileId\` / \`compositionName\` as required by the project.
+
+## Workflow: documentation in Figma
+**Template in Figma:** duplicate a template subtree under the doc page, then place an instance of the new component.
+- **duplicate_subtree**: \`sourceNodeId\` (template root), \`targetParentId\` (e.g. doc section), optional \`offsetX\` / \`offsetY\`.
+- **create_component_instance**: \`mainComponentId\` (local COMPONENT) or \`componentKey\` (published library), optional \`parentId\`, \`x\`, \`y\`.
+
+**Template from repo:** build section text in the IDE, then **apply_documentation_payload** with \`targetRootId\` and \`entries: [{ layerName, text }]\` matching text layer names under the duplicated template.
+
+## Canvas tools
+Atomic node tools (create_frame, create_text, set_node_fill, etc.) execute in the plugin sandbox. They must stay on the whitelist — do not assume a tool exists until documented in Bridge release notes.
+
+## Stability
+If a command fails, check: Remote Connect connected, Bridge port matches, plugin version supports the commandType, and composition tier for composition commands.
+`.trim();
+//# sourceMappingURL=sxl-mcp-instructions.js.map

package/dist/sxl-mcp-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sxl-mcp-instructions.js","sourceRoot":"","sources":["../src/sxl-mcp-instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B1C,CAAC,IAAI,EAAE,CAAC"}

package/dist/tools/composition.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Composition operations.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CommandQueue } from "../command-queue.js";
+export declare function registerCompositionTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/composition.js

@@ -0,0 +1,47 @@
+/**
+ * MCP tools for Composition operations.
+ */
+import { z } from "zod";
+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. 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) }] };
+    });
+    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) }] };
+    });
+    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) }] };
+    });
+    server.tool("export_composition_json", "Export the selected node (or a node by ID) as composition JSON string, same format as Dev Tool codegen. Requires design mode with a selection unless nodeId is set.", {
+        nodeId: z
+            .string()
+            .optional()
+            .describe("Figma node id. Omit to use current selection (first selected node)."),
+    }, async ({ nodeId }) => {
+        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) }] };
+    });
+}
+//# sourceMappingURL=composition.js.map

package/dist/tools/composition.js.map

@@ -0,0 +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,+OAA+O,EAC/O;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,qKAAqK,EACrK;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;AACJ,CAAC"}

package/dist/tools/data.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Data / Mapping operations.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CommandQueue } from "../command-queue.js";
+export declare function registerDataTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/data.js

@@ -0,0 +1,56 @@
+/**
+ * MCP tools for Data / Mapping operations.
+ */
+import { z } from "zod";
+export function registerDataTools(server, queue) {
+    server.tool("apply_mapping", "Apply a data mapping to target nodes in Figma. Maps dataset fields to Figma layers.", {
+        mappingId: z.string().describe("ID of the mapping to apply"),
+        targetNodes: z.array(z.unknown()).optional().describe("Optional target nodes array"),
+    }, async ({ mappingId, targetNodes }) => {
+        const result = await queue.execute("apply_mapping", { mappingId, targetNodes: targetNodes ?? [] });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("apply_all_mappings", "Apply all mappings within a scope (selection, page, or document).", { scope: z.string().optional().describe("Scope: selection, page, or document") }, async ({ scope }) => {
+        const result = await queue.execute("apply_all_mappings", scope ? { scope } : {});
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("count_apply_targets", "Count how many nodes match a mapping scope.", { scope: z.string().describe("Scope: selection, page, or document") }, async ({ scope }) => {
+        const result = await queue.execute("count_apply_targets", { scope });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("generate_instances", "Generate component instances from mapping data.", {
+        mappingId: z.string().describe("Mapping ID to generate from"),
+        rowCount: z.number().nullable().optional().describe("Number of rows to generate (null for all)"),
+    }, async ({ mappingId, rowCount }) => {
+        const result = await queue.execute("generate_instances", {
+            mappingId,
+            rowCount: rowCount ?? null,
+            scope: "selection",
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("apply_image", "Apply an image from URL to the current selection.", {
+        url: z.string().describe("Image URL"),
+        name: z.string().describe("Image name"),
+    }, async ({ url, name }) => {
+        const result = await queue.execute("apply_image", { url, name });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("set_node_text", "Set text content on a text layer in the currently selected nodes (or a specific node by ID). If layerName is provided, finds text nodes with that name inside the selection. Otherwise sets text on all text nodes in selection.", {
+        text: z.string().describe("Text content to set"),
+        layerName: z.string().optional().describe("Name of the text layer to target (e.g. 'label', 'title'). Omit to set all text nodes."),
+        nodeId: z.string().optional().describe("Specific Figma node ID. Omit to use current selection."),
+    }, async ({ text, layerName, nodeId }) => {
+        const result = await queue.execute("set_node_text", { text, layerName, nodeId });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("set_node_property", "Set a component property on a selected instance or component. For instances, sets instance property. For components, sets default value.", {
+        propertyName: z.string().describe("Property name (e.g. 'label', 'isIcon', 'size')"),
+        propertyValue: z.union([z.string(), z.boolean(), z.number()]).describe("Property value"),
+        nodeId: z.string().optional().describe("Specific Figma node ID. Omit to use current selection."),
+    }, async ({ propertyName, propertyValue, nodeId }) => {
+        const result = await queue.execute("set_node_property", { propertyName, propertyValue, nodeId });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=data.js.map

package/dist/tools/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/tools/data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,KAAmB;IACtE,MAAM,CAAC,IAAI,CACT,eAAe,EACf,qFAAqF,EACrF;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC5D,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KACrF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;QACnG,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,oBAAoB,EACpB,mEAAmE,EACnE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EAChF,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjF,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,6CAA6C,EAC7C,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EACrE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,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,oBAAoB,EACpB,iDAAiD,EACjD;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE;YACvD,SAAS;YACT,QAAQ,EAAE,QAAQ,IAAI,IAAI;YAC1B,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;QACH,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,mDAAmD,EACnD;QACE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;KACxC,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,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,eAAe,EACf,kOAAkO,EAClO;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;QAClI,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,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,0IAA0I,EAC1I;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QACnF,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACxF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;QACjG,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"}

package/dist/tools/diagnostics.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Diagnostics, Recovery, and Code Connect operations.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CommandQueue } from "../command-queue.js";
+export declare function registerDiagnosticTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/diagnostics.js

@@ -0,0 +1,70 @@
+/**
+ * MCP tools for Diagnostics, Recovery, and Code Connect operations.
+ */
+import { z } from "zod";
+export function registerDiagnosticTools(server, queue) {
+    // ─── Diagnostics ───
+    server.tool("get_plugin_status", "Get current plugin status: editor type, current page, selection, session state.", {}, async () => {
+        const result = await queue.execute("get_plugin_status");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_selection_summary", "Get detailed information about currently selected nodes in Figma: types, names, bound compositions/templates.", {}, async () => {
+        const result = await queue.execute("get_selection_summary");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_drift_status", "Get drift status for selected nodes — shows which compositions have diverged from their JSON source.", {}, async () => {
+        const result = await queue.execute("get_drift_status");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_export_report", "Get information about the last export operation results.", {}, async () => {
+        const result = await queue.execute("get_export_report");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("list_token_files", "List all token/composition files loaded in the plugin. Returns file IDs, names, and folder paths. Use this to discover correct file IDs before generating compositions.", {}, async () => {
+        const result = await queue.execute("list_token_files");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    // ─── Recovery ───
+    server.tool("rebind_instance", "Rebind one or more instances to a different component.", {
+        instanceNodeIds: z.array(z.string()).describe("Node IDs of instances to rebind"),
+        componentId: z.string().describe("Target component ID"),
+        isKey: z.boolean().optional().describe("Whether componentId is a component key"),
+    }, async ({ instanceNodeIds, componentId, isKey }) => {
+        const result = await queue.execute("rebind_instance", { instanceNodeIds, componentId, isKey });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("remap_composition_id", "Remap the composition tracking ID on a node to point to a different composition.", {
+        nodeId: z.string().describe("Node ID to remap"),
+        compositionName: z.string().describe("New composition name"),
+    }, async ({ nodeId, compositionName }) => {
+        const result = await queue.execute("remap_composition_id", { nodeId, compositionName });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("reapply_compositions", "Re-apply all drifted compositions to restore them to their JSON-defined state.", {}, async () => {
+        const result = await queue.execute("reapply_compositions");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    // ─── Code Connect ───
+    server.tool("codeconnect_get_binding", "Get the Code Connect binding for a specific node — the GitLab link and metadata.", { nodeId: z.string().describe("Node ID to get binding for") }, async ({ nodeId }) => {
+        const result = await queue.execute("codeconnect_get_binding", { nodeId });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("codeconnect_save_binding", "Save a Code Connect binding on a node — links a Figma component to a GitLab resource.", {
+        nodeId: z.string().describe("Node ID to bind"),
+        binding: z.object({
+            gitlabUrl: z.string().describe("GitLab URL"),
+            displayName: z.string().describe("Display name"),
+            resourceType: z.enum(["source", "docs", "story", "package"]).describe("Resource type"),
+            importPath: z.string().optional().describe("Import path"),
+            snippetTemplate: z.string().optional().describe("Code snippet template"),
+        }).describe("Code Connect binding data"),
+    }, async ({ nodeId, binding }) => {
+        const result = await queue.execute("codeconnect_save_binding", { nodeId, binding });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("codeconnect_get_selection_status", "Get Code Connect binding status for all selected nodes.", {}, async () => {
+        const result = await queue.execute("codeconnect_get_selection_status");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/tools/diagnostics.js.map

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

package/dist/tools/figma-nodes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP tools for direct Figma node manipulation.
+ *
+ * These tools give the agent full control over the Figma file:
+ * reading nodes, modifying properties, navigation, creation, deletion.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CommandQueue } from "../command-queue.js";
+export declare function registerFigmaNodeTools(server: McpServer, queue: CommandQueue): void;