@createlex/figma-swiftui-mcp 1.2.9 → 1.4.0

package/companion/bridge-server.cjs

@@ -316,8 +316,8 @@ function startBridgeServer(options = {}) {
     const assetCount = data.assetExportPlan?.candidates?.length ?? 0;
     const aiWorkflow = {
       IF_YOU_HAVE_MCP_ACCESS: {
-        step1: 'Call the MCP tool `write_selection_to_xcode` (server: figma-swiftui). It generates SwiftUI with correct Image("name") asset references AND writes the PNG files to Assets.xcassets automatically.',
-        step2: 'After write_selection_to_xcode returns, ONLY refine the code it produced: add GeometryReader for responsiveness, wire @State interactions. DO NOT rewrite Image("name") calls or replace them with Rectangle()/shapes.',
+        step1: 'Call the MCP tool `write_selection_to_xcode` with generationMode="editable" (the default). It exports individual PNG assets with correct blendMode info and generates Image("name").blendMode() calls automatically.',
+        step2: 'After write_selection_to_xcode returns, ONLY refine: add GeometryReader for responsiveness, wire @State interactions. DO NOT rewrite Image("name") calls, DO NOT switch to fidelity mode unless the whole frame is a single photo with no text.',
         mcpTool: 'write_selection_to_xcode',
         mcpServer: 'figma-swiftui',
       },

package/companion/mcp-server.mjs

@@ -765,11 +765,11 @@ server.registerTool('write_generated_swiftui_to_xcode', {
 });
 
 server.registerTool('write_selection_to_xcode', {
-  description: 'Generate SwiftUI from the connected Figma selection and write it into the configured Xcode project. THIS IS THE CORRECT TOOL TO CALL — it exports real PNG assets to Assets.xcassets and generates Image("name") references automatically. Use generationMode="fidelity" for designs with blend modes, 3D renders, complex shadows, or photographic images — fidelity rasterizes the whole frame as one pixel-perfect PNG instead of trying to reconstruct it with shapes.',
+  description: 'Generate SwiftUI from the connected Figma selection and write it into the configured Xcode project. THIS IS THE CORRECT TOOL TO CALL — it exports real PNG assets to Assets.xcassets and generates Image("name") references automatically. Always use the default generationMode="editable" — individual assets include blendModeSwiftUI values so blend modes are applied correctly on each Image(). Only use generationMode="fidelity" when the ENTIRE frame is a single photographic image or illustration with no text, no interactive elements, and no distinct layers (e.g. a full-bleed photo background).',
   inputSchema: {
     nodeIds: z.array(z.string()).optional().describe('Optional list of Figma node ids. If omitted, uses the current selection'),
     includeOverflow: z.boolean().default(false).describe('Ignore Figma clipping when generating layout'),
-    generationMode: z.enum(['editable', 'fidelity']).default('editable').describe('Use fidelity for designs with blend modes, 3D renders, complex shadows, or photographic content — rasterizes the whole frame as one pixel-perfect PNG. Use editable for UI screens with native controls (buttons, lists, forms).'),
+    generationMode: z.enum(['editable', 'fidelity']).default('editable').describe('Default: editable — generates individual SwiftUI elements with correct .blendMode() on each Image(). Use fidelity ONLY when the whole frame is a single photo/illustration with no text or interactive elements.'),
     projectPath: z.string().optional().describe('Optional Xcode source folder override'),
   },
 }, async ({ nodeIds, includeOverflow, generationMode, projectPath }) => {

package/companion/setup.cjs

@@ -6,10 +6,13 @@
  *
  * Supported targets:
  *   - Claude Desktop  (~/Library/Application Support/Claude/claude_desktop_config.json)
- *   - Claude Code     (~/.claude.json  → mcpServers)
+ *   - Claude Code     (~/.claude.json  → mcpServers)  (covers CLI + desktop + web)
  *   - Cursor          (~/.cursor/mcp.json)
  *   - Windsurf        (~/.codeium/windsurf/mcp_config.json)
  *   - VS Code         (~/.vscode/mcp.json  — user-level)
+ *   - OpenCode        (~/.config/opencode/opencode.json  → mcp)
+ *   - Codex CLI       (~/.codex/config.toml  → [mcp_servers.figma-swiftui])
+ *   - Gemini CLI      (~/.gemini/settings.json)
  *   - Antigravity     (~/.gemini/antigravity/mcp_config.json)
  */
 
@@ -118,6 +121,26 @@ function getTargets({ nodePath, scriptPath }) {
       entry: stdioEntry,
       wrapKey: null, // VS Code uses { servers: { ... } } at top level
     },
+    {
+      name: 'OpenCode',
+      path: path.join(home, '.config', 'opencode', 'opencode.json'),
+      key: 'mcp',
+      entry: scriptPath
+        ? { type: 'local', command: [nodePath, scriptPath, 'start'], enabled: true }
+        : { type: 'local', command: [resolveNpxPath(), '-y', '@createlex/figma-swiftui-mcp', 'start'], enabled: true },
+    },
+    {
+      name: 'Codex CLI',
+      path: path.join(home, '.codex', 'config.toml'),
+      format: 'toml',
+      entry: { command: stdioEntry.command, args: stdioEntry.args },
+    },
+    {
+      name: 'Gemini CLI',
+      path: path.join(home, '.gemini', 'settings.json'),
+      key: 'mcpServers',
+      entry: stdioEntry,
+    },
     {
       name: 'Antigravity (Gemini)',
       path: path.join(home, '.gemini', 'antigravity', 'mcp_config.json'),
@@ -145,6 +168,48 @@ function writeJsonSafe(filePath, data) {
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
 }
 
+// ── TOML helpers (minimal, for Codex config.toml) ────────────────────
+// We only need to append/check a [mcp_servers.<name>] section — no full
+// TOML parser required.
+
+function tomlHasServer(raw, serverName) {
+  const pattern = new RegExp(`^\\[mcp_servers\\.${serverName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\]`, 'm');
+  return pattern.test(raw);
+}
+
+function tomlFormatValue(v) {
+  if (typeof v === 'string') return `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+  if (typeof v === 'boolean') return v ? 'true' : 'false';
+  if (typeof v === 'number') return String(v);
+  if (Array.isArray(v)) return `[${v.map(tomlFormatValue).join(', ')}]`;
+  return `"${v}"`;
+}
+
+function buildTomlSection(serverName, entry) {
+  const lines = [`[mcp_servers.${serverName}]`];
+  for (const [k, v] of Object.entries(entry)) {
+    if (k === 'env' && typeof v === 'object') continue; // handle env as sub-table
+    lines.push(`${k} = ${tomlFormatValue(v)}`);
+  }
+  if (entry.env && Object.keys(entry.env).length > 0) {
+    lines.push(`[mcp_servers.${serverName}.env]`);
+    for (const [ek, ev] of Object.entries(entry.env)) {
+      lines.push(`${ek} = ${tomlFormatValue(ev)}`);
+    }
+  }
+  return lines.join('\n') + '\n';
+}
+
+function appendTomlServer(filePath, serverName, entry, dryRun) {
+  const raw = fs.readFileSync(filePath, 'utf-8');
+  if (tomlHasServer(raw, serverName)) return false; // already present
+  const section = '\n' + buildTomlSection(serverName, entry);
+  if (!dryRun) {
+    fs.appendFileSync(filePath, section, 'utf-8');
+  }
+  return true;
+}
+
 // ── Main ──────────────────────────────────────────────────────────────
 function runSetup(flags = {}) {
   const force = flags.force || false;
@@ -177,6 +242,25 @@ function runSetup(flags = {}) {
       continue;
     }
 
+    // ── TOML targets (Codex) ──────────────────────────────────────
+    if (target.format === 'toml') {
+      const raw = fs.readFileSync(target.path, 'utf-8');
+      if (tomlHasServer(raw, MCP_KEY) && !force) {
+        console.log(`  ✅  ${target.name}  — already configured`);
+        skipped++;
+        continue;
+      }
+      if (dryRun) {
+        console.log(`  🟡  ${target.name}  — would configure (dry run)`);
+      } else {
+        appendTomlServer(target.path, MCP_KEY, target.entry, false);
+        console.log(`  ✅  ${target.name}  — configured!`);
+      }
+      configured++;
+      continue;
+    }
+
+    // ── JSON targets ────────────────────────────────────────────
     const config = readJsonSafe(target.path);
     if (!config) {
       console.log(`  ⚠️  ${target.name}  — could not parse config`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@createlex/figma-swiftui-mcp",
-  "version": "1.2.9",
+  "version": "1.4.0",
   "description": "CreateLex MCP runtime for Figma-to-SwiftUI generation and Xcode export",
   "bin": {
     "figma-swiftui-mcp": "bin/figma-swiftui-mcp.js"