@sxl-studio/bridge 1.2.0 → 1.3.1

package/dist/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,UAAU,EAAE,CAAC,OAAgB;IACjC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,OAAiC;IACpE,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,OAAO,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc;QAC9E,OAAO;QACP,SAAS,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK;QAC1C,OAAO,EAAE,OAAO,IAAI,IAAI;KACzB,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5E,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAmB,EACnB,WAAmB,EACnB,UAAmC,EAAE;IAErC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,gDAAgD;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CACR,MAAM,CAAC,KAAK,IAAI,YAAY,WAAW,aAAa,MAAM,CAAC,MAAM,GAAG,EACpE;QACE,IAAI,EACF,MAAM,CAAC,MAAM,KAAK,SAAS;YACzB,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW;gBAC7B,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,cAAc;QACtB,SAAS,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;KACxE,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/styles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP tools for Figma local Styles CRUD + assignment.
+ *
+ * All commands here mutate the Figma document and require Design mode.
+ */
+import type { McpServer } from "../../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
+import type { CommandQueue } from "../command-queue.js";
+export declare function registerStyleTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/styles.js

@@ -0,0 +1,55 @@
+/**
+ * MCP tools for Figma local Styles CRUD + assignment.
+ *
+ * All commands here mutate the Figma document and require Design mode.
+ */
+import { z } from "zod";
+import { callPluginCommand } from "./shared.js";
+export function registerStyleTools(server, queue) {
+    server.tool("create_paint_style", "Create a local PaintStyle with the given name and paints. Solid paints accept either { type: 'SOLID', color: '#rrggbb', opacity? } or raw Figma Paint objects.", {
+        name: z.string().describe("Style name"),
+        paints: z.array(z.record(z.unknown())).optional().describe("Array of Paint objects (see Figma Plugin API). Defaults to a black solid paint."),
+        description: z.string().optional().describe("Optional description"),
+    }, async ({ name, paints, description }) => {
+        const payload = { name };
+        if (paints !== undefined)
+            payload.paints = paints;
+        if (description !== undefined)
+            payload.description = description;
+        return callPluginCommand(queue, "create_paint_style", payload);
+    });
+    server.tool("create_text_style", "Create a local TextStyle. fontName.family + fontName.style must be loaded in Figma (plugin loads the font).", {
+        name: z.string().describe("Style name"),
+        fontName: z
+            .object({ family: z.string(), style: z.string() })
+            .describe("Figma FontName"),
+        fontSize: z.number().optional(),
+        lineHeight: z.record(z.unknown()).optional().describe("Figma LineHeight"),
+        letterSpacing: z.record(z.unknown()).optional().describe("Figma LetterSpacing"),
+        textDecoration: z.string().optional(),
+        textCase: z.string().optional(),
+        description: z.string().optional(),
+    }, async (args) => callPluginCommand(queue, "create_text_style", args));
+    server.tool("create_effect_style", "Create a local EffectStyle with the given effects (Figma Effect objects).", {
+        name: z.string().describe("Style name"),
+        effects: z.array(z.record(z.unknown())).describe("Array of Figma Effect objects"),
+        description: z.string().optional(),
+    }, async (args) => callPluginCommand(queue, "create_effect_style", args));
+    server.tool("set_text_style", "Assign a TextStyle to a node (sets textStyleId).", {
+        nodeId: z.string().describe("Figma node id"),
+        styleId: z.string().describe("TextStyle id"),
+    }, async ({ nodeId, styleId }) => callPluginCommand(queue, "set_text_style", { nodeId, styleId }));
+    server.tool("set_effect_style", "Assign an EffectStyle to a node (sets effectStyleId).", {
+        nodeId: z.string().describe("Figma node id"),
+        styleId: z.string().describe("EffectStyle id"),
+    }, async ({ nodeId, styleId }) => callPluginCommand(queue, "set_effect_style", { nodeId, styleId }));
+    server.tool("set_stroke_style", "Assign a PaintStyle to a node's stroke (sets strokeStyleId).", {
+        nodeId: z.string().describe("Figma node id"),
+        styleId: z.string().describe("PaintStyle id"),
+    }, async ({ nodeId, styleId }) => callPluginCommand(queue, "set_stroke_style", { nodeId, styleId }));
+    server.tool("set_fill_style", "Assign a PaintStyle to a node's fill (sets fillStyleId).", {
+        nodeId: z.string().describe("Figma node id"),
+        styleId: z.string().describe("PaintStyle id"),
+    }, async ({ nodeId, styleId }) => callPluginCommand(queue, "set_fill_style", { nodeId, styleId }));
+}
+//# sourceMappingURL=styles.js.map

package/dist/tools/styles.js.map

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

package/dist/tools/tokens.d.ts

@@ -1,6 +1,6 @@
 /**
- * MCP tools for Vars / Tokens operations.
+ * MCP tools for Vars / Tokens operations (full workspace CRUD).
  */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpServer } from "../../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
 import type { CommandQueue } from "../command-queue.js";
 export declare function registerTokenTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/tokens.js

@@ -1,7 +1,8 @@
 /**
- * MCP tools for Vars / Tokens operations.
+ * MCP tools for Vars / Tokens operations (full workspace CRUD).
  */
 import { z } from "zod";
+import { callPluginCommand } from "./shared.js";
 export function registerTokenTools(server, queue) {
     server.tool("export_variables", "Export design token variables and styles to Figma. By default exports ALL collections with codeSyntax and scopes enabled. Use 'collection' to filter by name.", {
         collection: z.string().optional().describe("Export only this collection (by name). Omit to export all."),
@@ -18,49 +19,79 @@ export function registerTokenTools(server, queue) {
             settings.forceUpdateAll = forceUpdateAll;
         if (deleteOrphans !== undefined)
             settings.deleteOrphans = deleteOrphans;
-        const result = await queue.execute("export_variables", { settings });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("reset_diff", "Reset all Diff-IDs across all token files. Forces re-export of all variables on next export.", {}, async () => {
-        const result = await queue.execute("reset_diff");
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("reset_diff_collection", "Reset Diff-IDs for a specific collection.", { collectionName: z.string().describe("Name of the collection to reset") }, async ({ collectionName }) => {
-        const result = await queue.execute("reset_diff_collection", { collectionName });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return callPluginCommand(queue, "export_variables", { settings });
     });
+    server.tool("reset_diff", "Reset all Diff-IDs across all token files. Forces re-export of all variables on next export.", {}, async () => callPluginCommand(queue, "reset_diff"));
+    server.tool("reset_diff_collection", "Reset Diff-IDs for a specific collection.", { collectionName: z.string().describe("Name of the collection to reset") }, async ({ collectionName }) => callPluginCommand(queue, "reset_diff_collection", { collectionName }));
     server.tool("reset_diff_file", "Reset Diff-IDs for a specific token file.", {
         fileId: z.string().describe("Token file ID"),
         fileName: z.string().describe("Token file name"),
-    }, async ({ fileId, fileName }) => {
-        const result = await queue.execute("reset_diff_file", { fileId, fileName });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("reapply_token_bindings", "Re-apply token bindings to nodes. Scope can be 'selection', 'page', or 'document'.", { scope: z.string().describe("Scope: selection, page, or document") }, async ({ scope }) => {
-        const result = await queue.execute("reapply_token_bindings", { scope });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
+    }, async ({ fileId, fileName }) => callPluginCommand(queue, "reset_diff_file", { fileId, fileName }));
+    server.tool("reapply_token_bindings", "Re-apply token bindings to nodes. Scope can be 'selection', 'page', or 'document'.", { scope: z.string().describe("Scope: selection, page, or document") }, async ({ scope }) => callPluginCommand(queue, "reapply_token_bindings", { scope }));
     server.tool("cross_file_sync_fetch", "Fetch remote variables from a published Figma file for cross-file sync.", {
         fileKey: z.string().describe("Figma file key"),
         accessToken: z.string().describe("Figma access token"),
-    }, async ({ fileKey, accessToken }) => {
-        const result = await queue.execute("cross_file_sync_fetch", { fileKey, accessToken });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, async ({ fileKey, accessToken }) => callPluginCommand(queue, "cross_file_sync_fetch", { fileKey, accessToken }));
+    server.tool("cross_file_sync_apply", "Apply cross-file sync entries to local variables.", { entries: z.array(z.unknown()).describe("Sync entries to apply") }, async ({ entries }) => callPluginCommand(queue, "cross_file_sync_apply", { entries }));
+    // ─── Token file workspace CRUD ───
+    server.tool("list_token_files", "List token files in the plugin workspace. Returns id, name, folder, gitPath, tokenCount, tokenTypes, updatedAt for each file. Use this as the first step before reading or editing token files.", {}, async () => callPluginCommand(queue, "list_token_files"));
+    server.tool("get_token_file_content", "Read raw JSON text of a token file from the plugin workspace (by internal fileId from list_token_files).", { fileId: z.string().describe("Token file id (tf_...) from the plugin") }, async ({ fileId }) => callPluginCommand(queue, "get_token_file_content", { fileId }));
+    server.tool("save_token_file", "Write token file JSON content into the plugin workspace (upsert). Provide fileId to update an existing file, or name+folder to create/update by identity. Marks the file dirty for Git.", {
+        fileId: z.string().optional().describe("Token file id (tf_...). Omit to create a new file by name/folder."),
+        name: z.string().optional().describe("File name (e.g. \"colors.json\"). Required when creating."),
+        folder: z.string().nullable().optional().describe("Folder path relative to workspace (e.g. \"tokens\"). Use null or omit for the root."),
+        content: z.string().describe("Full file body (valid JSON string)"),
+    }, async ({ fileId, name, folder, content }) => {
+        const payload = { content };
+        if (fileId)
+            payload.fileId = fileId;
+        if (name)
+            payload.name = name;
+        if (folder !== undefined)
+            payload.folder = folder;
+        return callPluginCommand(queue, "save_token_file", payload);
     });
-    server.tool("cross_file_sync_apply", "Apply cross-file sync entries to local variables.", { entries: z.array(z.unknown()).describe("Sync entries to apply") }, async ({ entries }) => {
-        const result = await queue.execute("cross_file_sync_apply", { entries });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    server.tool("create_token_file", "Create a new token JSON file in the plugin workspace. Returns the new fileId. Use overwrite=true to replace an existing file with the same name+folder.", {
+        name: z.string().describe("File name (e.g. \"colors.json\" or \"button.comp.json\")"),
+        folder: z.string().nullable().optional().describe("Folder path (e.g. \"tokens\"). Null/omit for root."),
+        content: z.string().optional().describe("Initial JSON body. Defaults to '{}'."),
+        overwrite: z.boolean().optional().describe("Replace existing file with the same name+folder (default: false)"),
+    }, async ({ name, folder, content, overwrite }) => {
+        const payload = { name };
+        if (folder !== undefined)
+            payload.folder = folder;
+        if (content !== undefined)
+            payload.content = content;
+        if (overwrite !== undefined)
+            payload.overwrite = overwrite;
+        return callPluginCommand(queue, "create_token_file", payload);
     });
-    server.tool("get_token_file_content", "Read raw JSON text of a token file from the plugin workspace (by internal fileId from list_token_files).", { fileId: z.string().describe("Token file id (tf_...) from the plugin") }, async ({ fileId }) => {
-        const result = await queue.execute("get_token_file_content", { fileId });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    server.tool("delete_token_file", "Delete a token file from the plugin workspace. If the file is tracked by Git, its gitPath is queued for deletion on next push.", { fileId: z.string().describe("Token file id (tf_...)") }, async ({ fileId }) => callPluginCommand(queue, "delete_token_file", { fileId }));
+    server.tool("move_token_file", "Move / rename a token file in the plugin workspace. Pass any combination of newName and newFolder.", {
+        fileId: z.string().describe("Token file id (tf_...)"),
+        newName: z.string().optional().describe("New file name (keep existing if omitted)"),
+        newFolder: z.string().nullable().optional().describe("New folder (null for root; keep existing if omitted)"),
+    }, async ({ fileId, newName, newFolder }) => {
+        const payload = { fileId };
+        if (newName !== undefined)
+            payload.newName = newName;
+        if (newFolder !== undefined)
+            payload.newFolder = newFolder;
+        return callPluginCommand(queue, "move_token_file", payload);
     });
-    server.tool("save_token_file", "Write token file JSON content into the plugin workspace (updates in-memory model and marks file dirty for Git).", {
-        fileId: z.string().describe("Token file id"),
-        content: z.string().describe("Full file body (JSON string)"),
-    }, async ({ fileId, content }) => {
-        const result = await queue.execute("save_token_file", { fileId, content });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    server.tool("rename_token_file", "Alias for move_token_file that only changes the file name.", {
+        fileId: z.string().describe("Token file id (tf_...)"),
+        newName: z.string().describe("New file name"),
+    }, async ({ fileId, newName }) => callPluginCommand(queue, "rename_token_file", { fileId, newName }));
+    server.tool("get_tokens_config", "Read the plugin tokens workspace configuration (config.json content). Inspect collection definitions, folder enablement and reference chains.", {}, async () => callPluginCommand(queue, "get_tokens_config"));
+    server.tool("save_tokens_config", "Overwrite the plugin config.json. Use this to define/modify collections, mode references, and file enablement. Content MUST be valid JSON and follow the SXL config schema (see docs).", { content: z.string().describe("Full config.json body as a JSON string") }, async ({ content }) => callPluginCommand(queue, "save_tokens_config", { content }));
+    server.tool("get_applied_tokens", "Read the applied token bindings (stored in plugin data on the node) for a specific Figma node. Returns list of bindings (nodeId, tokenPath, property) and the composition binding if the node is part of a composition. Omit nodeId to use current selection.", {
+        nodeId: z.string().optional().describe("Figma node id. Omit to use current selection."),
+    }, async ({ nodeId }) => {
+        const payload = {};
+        if (nodeId)
+            payload.nodeId = nodeId;
+        return callPluginCommand(queue, "get_applied_tokens", payload);
     });
 }
 //# sourceMappingURL=tokens.js.map

package/dist/tools/tokens.js.map

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

package/dist/tools/variables.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP tools for Figma Variables CRUD.
+ *
+ * Full lifecycle: rename/delete variables and collections, add/remove/rename
+ * modes, set per-mode values, scopes and codeSyntax. All tools here mutate
+ * the Figma document and therefore require Design mode (plugin returns a
+ * typed EDITOR_MODE_READONLY error in Dev Mode).
+ */
+import type { McpServer } from "../../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
+import type { CommandQueue } from "../command-queue.js";
+export declare function registerVariableTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/variables.js

@@ -0,0 +1,55 @@
+/**
+ * MCP tools for Figma Variables CRUD.
+ *
+ * Full lifecycle: rename/delete variables and collections, add/remove/rename
+ * modes, set per-mode values, scopes and codeSyntax. All tools here mutate
+ * the Figma document and therefore require Design mode (plugin returns a
+ * typed EDITOR_MODE_READONLY error in Dev Mode).
+ */
+import { z } from "zod";
+import { callPluginCommand } from "./shared.js";
+const CODE_SYNTAX_PLATFORMS = ["WEB", "iOS", "ANDROID"];
+export function registerVariableTools(server, queue) {
+    server.tool("rename_variable", "Rename a Figma local variable.", {
+        variableId: z.string().describe("Variable id (VariableID:...)"),
+        name: z.string().describe("New variable name"),
+    }, async ({ variableId, name }) => callPluginCommand(queue, "rename_variable", { variableId, name }));
+    server.tool("delete_variable", "Delete a Figma local variable.", { variableId: z.string().describe("Variable id") }, async ({ variableId }) => callPluginCommand(queue, "delete_variable", { variableId }));
+    server.tool("rename_variable_collection", "Rename a Figma local variable collection.", {
+        collectionId: z.string().describe("Collection id (VariableCollectionId:...)"),
+        name: z.string().describe("New collection name"),
+    }, async ({ collectionId, name }) => callPluginCommand(queue, "rename_variable_collection", { collectionId, name }));
+    server.tool("delete_variable_collection", "Delete a Figma local variable collection (and all variables inside it).", { collectionId: z.string().describe("Collection id") }, async ({ collectionId }) => callPluginCommand(queue, "delete_variable_collection", { collectionId }));
+    server.tool("add_variable_mode", "Add a new mode to a variable collection.", {
+        collectionId: z.string().describe("Collection id"),
+        modeName: z.string().describe("Mode display name"),
+    }, async ({ collectionId, modeName }) => callPluginCommand(queue, "add_variable_mode", { collectionId, modeName }));
+    server.tool("remove_variable_mode", "Remove a mode from a variable collection.", {
+        collectionId: z.string().describe("Collection id"),
+        modeId: z.string().describe("Mode id to remove"),
+    }, async ({ collectionId, modeId }) => callPluginCommand(queue, "remove_variable_mode", { collectionId, modeId }));
+    server.tool("rename_variable_mode", "Rename a mode inside a variable collection.", {
+        collectionId: z.string().describe("Collection id"),
+        modeId: z.string().describe("Mode id"),
+        name: z.string().describe("New mode name"),
+    }, async ({ collectionId, modeId, name }) => callPluginCommand(queue, "rename_variable_mode", { collectionId, modeId, name }));
+    server.tool("set_variable_mode_value", "Set a variable's value for a specific mode. For COLOR variables, value can be a hex string (e.g. '#ff0000' or '#ff0000ff') or an RGBA object. For other types, forward a native value (number / string / boolean / VariableAlias).", {
+        variableId: z.string().describe("Variable id"),
+        modeId: z.string().describe("Mode id"),
+        value: z.unknown().describe("Value to set (type depends on variable.resolvedType)"),
+    }, async ({ variableId, modeId, value }) => callPluginCommand(queue, "set_variable_mode_value", { variableId, modeId, value }));
+    server.tool("set_variable_scopes", "Set the Variable.scopes array. Pass an array of scope names accepted by Figma (e.g. ['ALL_SCOPES'], ['CORNER_RADIUS','STROKE_FLOAT']).", {
+        variableId: z.string().describe("Variable id"),
+        scopes: z.array(z.string()).describe("Array of VariableScope values"),
+    }, async ({ variableId, scopes }) => callPluginCommand(queue, "set_variable_scopes", { variableId, scopes }));
+    server.tool("set_variable_code_syntax", "Set (or remove) codeSyntax for a specific platform on a variable.", {
+        variableId: z.string().describe("Variable id"),
+        platform: z.enum(CODE_SYNTAX_PLATFORMS).describe("Platform: WEB | iOS | ANDROID"),
+        value: z.string().nullable().optional().describe("New codeSyntax value. Pass null/empty to remove."),
+    }, async ({ variableId, platform, value }) => callPluginCommand(queue, "set_variable_code_syntax", {
+        variableId,
+        platform,
+        value: value ?? null,
+    }));
+}
+//# sourceMappingURL=variables.js.map

package/dist/tools/variables.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sxl-studio/bridge",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "MCP/HTTP bridge server for SXL Studio Figma plugin — enables remote control from IDE",
   "type": "module",
   "main": "dist/index.js",