@atezer/figma-mcp-bridge 1.9.6 → 1.9.8

package/f-mcp-plugin/code.js

@@ -6,7 +6,7 @@
 
 // v1.8.0+: Plugin version reported in WebSocket "ready" handshake.
 // Keep in sync with package.json and src/core/version.ts.
-var FMCP_PLUGIN_VERSION = '1.9.6';
+var FMCP_PLUGIN_VERSION = '1.9.8';
 
 /**
  * v1.9.6: Post-execute scan — figma_execute sonrasında oluşturulan node'ları
@@ -2939,6 +2939,211 @@ figma.ui.onmessage = async (msg) => {
     }
   }
 
+  // ============================================================================
+  // CREATE_MINI_DS (v1.9.7) — Boş dosyada minimal Design System kur.
+  // 2-phase batched: Phase 1 = Variable Collections + Variables + Text Styles
+  //                  Phase 2 = Components (Button/Input/Card)
+  // Her phase ayrı promise chain, timeout 30s içinde tamamlanır.
+  // ============================================================================
+  else if (msg.type === 'CREATE_MINI_DS') {
+    try {
+      console.log('🌉 [F-MCP v1.9.7] CREATE_MINI_DS starting...');
+
+      var primaryColor = msg.primaryColor || '#1464FF';
+      var fontFamily = msg.fontFamily || 'Inter';
+      var dsName = msg.name || 'Mini DS';
+      var includeComponents = msg.includeComponents !== false;
+
+      // ---------- Hex → RGB ----------
+      function hexToRgb(hex) {
+        var h = hex.replace('#', '');
+        if (h.length === 3) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2];
+        var r = parseInt(h.slice(0,2), 16) / 255;
+        var g = parseInt(h.slice(2,4), 16) / 255;
+        var b = parseInt(h.slice(4,6), 16) / 255;
+        return { r: r, g: g, b: b };
+      }
+      function mix(a, b, t) { return { r: a.r*(1-t)+b.r*t, g: a.g*(1-t)+b.g*t, b: a.b*(1-t)+b.b*t }; }
+
+      var primaryRgb = hexToRgb(primaryColor);
+      var black = { r: 0, g: 0, b: 0 };
+      var white = { r: 1, g: 1, b: 1 };
+
+      // ---------- PHASE 1: Variable Collections + Variables + Text Styles ----------
+      var colorCollection = figma.variables.createVariableCollection(dsName + ' — Colors');
+      var modeId = colorCollection.defaultModeId;
+      var colorVars = {};
+
+      function addColorVar(name, rgb) {
+        var v = figma.variables.createVariable(name, colorCollection, 'COLOR');
+        v.setValueForMode(modeId, rgb);
+        colorVars[name] = v;
+      }
+
+      addColorVar('primary/default', primaryRgb);
+      addColorVar('primary/hover', mix(primaryRgb, black, 0.1));
+      addColorVar('primary/disabled', mix(primaryRgb, white, 0.5));
+      addColorVar('bg/level-0', white);
+      addColorVar('bg/level-1', { r: 0.97, g: 0.97, b: 0.98 });
+      addColorVar('bg/level-2', { r: 0.93, g: 0.94, b: 0.96 });
+      addColorVar('text/primary', { r: 0.1, g: 0.1, b: 0.1 });
+      addColorVar('text/secondary', { r: 0.4, g: 0.4, b: 0.45 });
+      addColorVar('text/on-primary', white);
+      addColorVar('success/default', { r: 0.18, g: 0.73, b: 0.39 });
+      addColorVar('error/default', { r: 0.91, g: 0.22, b: 0.27 });
+      addColorVar('warning/default', { r: 0.98, g: 0.69, b: 0.13 });
+
+      var sizingCollection = figma.variables.createVariableCollection(dsName + ' — Sizing');
+      var sizingMode = sizingCollection.defaultModeId;
+      var sizingVars = {};
+      function addSizingVar(name, value) {
+        var v = figma.variables.createVariable(name, sizingCollection, 'FLOAT');
+        v.setValueForMode(sizingMode, value);
+        sizingVars[name] = v;
+      }
+      addSizingVar('spacing/xs', 4);
+      addSizingVar('spacing/sm', 8);
+      addSizingVar('spacing/md', 16);
+      addSizingVar('spacing/lg', 24);
+      addSizingVar('spacing/xl', 32);
+      addSizingVar('radius/sm', 4);
+      addSizingVar('radius/md', 8);
+      addSizingVar('radius/lg', 16);
+
+      // Text Styles (font loading required)
+      await figma.loadFontAsync({ family: fontFamily, style: 'Semi Bold' }).catch(function() {});
+      await figma.loadFontAsync({ family: fontFamily, style: 'Regular' }).catch(function() {});
+
+      function createTextStyle(name, fontSize, lineHeight, fontStyle) {
+        var ts = figma.createTextStyle();
+        ts.name = name;
+        try {
+          ts.fontName = { family: fontFamily, style: fontStyle };
+          ts.fontSize = fontSize;
+          ts.lineHeight = { unit: 'PIXELS', value: lineHeight };
+        } catch (e) {
+          console.warn('TextStyle ' + name + ' font set failed:', e.message);
+        }
+        return ts;
+      }
+
+      var titleStyle = createTextStyle(dsName + '/Title/Large', 24, 32, 'Semi Bold');
+      var bodyStyle = createTextStyle(dsName + '/Body/Default', 14, 20, 'Regular');
+      var captionStyle = createTextStyle(dsName + '/Caption/Small', 12, 16, 'Regular');
+
+      console.log('🌉 [F-MCP v1.9.7] Phase 1 done — variables + text styles created');
+
+      // ---------- PHASE 2: Components ----------
+      var componentIds = {};
+      if (includeComponents) {
+        // Button component
+        var buttonFrame = figma.createFrame();
+        buttonFrame.name = dsName + '/Button/Primary';
+        buttonFrame.layoutMode = 'HORIZONTAL';
+        buttonFrame.primaryAxisSizingMode = 'AUTO';
+        buttonFrame.counterAxisSizingMode = 'AUTO';
+        buttonFrame.primaryAxisAlignItems = 'CENTER';
+        buttonFrame.counterAxisAlignItems = 'CENTER';
+        buttonFrame.setBoundVariable('paddingLeft', sizingVars['spacing/md']);
+        buttonFrame.setBoundVariable('paddingRight', sizingVars['spacing/md']);
+        buttonFrame.setBoundVariable('paddingTop', sizingVars['spacing/sm']);
+        buttonFrame.setBoundVariable('paddingBottom', sizingVars['spacing/sm']);
+        buttonFrame.setBoundVariable('cornerRadius', sizingVars['radius/md']);
+        buttonFrame.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: primaryRgb }, 'color', colorVars['primary/default'])];
+
+        var buttonText = figma.createText();
+        try {
+          buttonText.fontName = { family: fontFamily, style: 'Semi Bold' };
+          buttonText.characters = 'Button';
+          await buttonText.setTextStyleIdAsync(bodyStyle.id).catch(function() {});
+          buttonText.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 1, g: 1, b: 1 } }, 'color', colorVars['text/on-primary'])];
+        } catch (e) { console.warn('Button text fail:', e.message); }
+        buttonFrame.appendChild(buttonText);
+        var buttonComp = figma.createComponentFromNode(buttonFrame);
+        componentIds.button = buttonComp.id;
+
+        // Input component
+        var inputFrame = figma.createFrame();
+        inputFrame.name = dsName + '/Input/Default';
+        inputFrame.resize(240, 40);
+        inputFrame.layoutMode = 'HORIZONTAL';
+        inputFrame.primaryAxisAlignItems = 'CENTER';
+        inputFrame.setBoundVariable('paddingLeft', sizingVars['spacing/md']);
+        inputFrame.setBoundVariable('paddingRight', sizingVars['spacing/md']);
+        inputFrame.setBoundVariable('cornerRadius', sizingVars['radius/md']);
+        inputFrame.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.97, g: 0.97, b: 0.98 } }, 'color', colorVars['bg/level-1'])];
+        inputFrame.strokes = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.9, g: 0.9, b: 0.92 } }, 'color', colorVars['bg/level-2'])];
+        inputFrame.strokeWeight = 1;
+
+        var placeholder = figma.createText();
+        try {
+          placeholder.fontName = { family: fontFamily, style: 'Regular' };
+          placeholder.characters = 'Placeholder';
+          await placeholder.setTextStyleIdAsync(bodyStyle.id).catch(function() {});
+          placeholder.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.4, g: 0.4, b: 0.45 } }, 'color', colorVars['text/secondary'])];
+        } catch (e) {}
+        inputFrame.appendChild(placeholder);
+        var inputComp = figma.createComponentFromNode(inputFrame);
+        componentIds.input = inputComp.id;
+
+        // Card component
+        var cardFrame = figma.createFrame();
+        cardFrame.name = dsName + '/Card/Default';
+        cardFrame.layoutMode = 'VERTICAL';
+        cardFrame.primaryAxisSizingMode = 'AUTO';
+        cardFrame.counterAxisSizingMode = 'AUTO';
+        cardFrame.setBoundVariable('paddingLeft', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('paddingRight', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('paddingTop', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('paddingBottom', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('itemSpacing', sizingVars['spacing/sm']);
+        cardFrame.setBoundVariable('cornerRadius', sizingVars['radius/lg']);
+        cardFrame.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 1, g: 1, b: 1 } }, 'color', colorVars['bg/level-0'])];
+        cardFrame.strokes = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.93, g: 0.94, b: 0.96 } }, 'color', colorVars['bg/level-2'])];
+        cardFrame.strokeWeight = 1;
+
+        var cardTitle = figma.createText();
+        try {
+          cardTitle.fontName = { family: fontFamily, style: 'Semi Bold' };
+          cardTitle.characters = 'Card title';
+          await cardTitle.setTextStyleIdAsync(titleStyle.id).catch(function() {});
+          cardTitle.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.1, g: 0.1, b: 0.1 } }, 'color', colorVars['text/primary'])];
+        } catch (e) {}
+        cardFrame.appendChild(cardTitle);
+        var cardComp = figma.createComponentFromNode(cardFrame);
+        componentIds.card = cardComp.id;
+
+        console.log('🌉 [F-MCP v1.9.7] Phase 2 done — 3 components created');
+      }
+
+      figma.ui.postMessage({
+        type: 'CREATE_MINI_DS_RESULT',
+        requestId: msg.requestId,
+        success: true,
+        dsName: dsName,
+        variableCollectionIds: { colors: colorCollection.id, sizing: sizingCollection.id },
+        textStyleIds: { title: titleStyle.id, body: bodyStyle.id, caption: captionStyle.id },
+        componentIds: componentIds,
+        summary: {
+          colorVariableCount: Object.keys(colorVars).length,
+          sizingVariableCount: Object.keys(sizingVars).length,
+          textStyleCount: 3,
+          componentCount: Object.keys(componentIds).length,
+        },
+        hint: "v1.9.7 Mini DS hazir. Ekran kurmak icin figma_execute kullan: importVariableByKeyAsync + importComponentByKeyAsync ile key'leri al, instance + setBoundVariable yaparak olustur.",
+      });
+    } catch (error) {
+      var errorMsg = error && error.message ? error.message : String(error);
+      console.error('🌉 [F-MCP v1.9.7] CREATE_MINI_DS error:', errorMsg);
+      figma.ui.postMessage({
+        type: 'CREATE_MINI_DS_RESULT',
+        requestId: msg.requestId,
+        success: false,
+        error: errorMsg,
+      });
+    }
+  }
+
   // ============================================================================
   // DELETE_NODE - Delete a node
   // ============================================================================

package/f-mcp-plugin/ui.html

@@ -424,7 +424,7 @@
     window.__figmaFileName = null;
     // v1.8.0+: Plugin version reported in WebSocket "ready" handshake.
     // Keep in sync with package.json, src/core/version.ts, f-mcp-plugin/code.js.
-    var FMCP_PLUGIN_VERSION = '1.9.6';
+    var FMCP_PLUGIN_VERSION = '1.9.8';
 
     // v1.9.2+ Startup log — Figma plugin iframe'de yeni kod yüklendiğini doğrulamak için.
     // Console'da bu log görünüyorsa plugin güncel. Görünmüyorsa iframe eski kopyayı tutuyor
@@ -778,11 +778,28 @@
         if (options.format) params.format = options.format;            // PNG, JPG
         if (options.scale != null) params.scale = options.scale;       // 1, 2, 4, etc.
         if (options.jpegQuality != null) params.jpegQuality = options.jpegQuality;  // 30-100 (v1.8.0)
+        // v1.9.5 method selection params
+        if (options.returnMode) params.returnMode = options.returnMode;
+        if (options.regionStrategy) params.regionStrategy = options.regionStrategy;
+        if (options.maxRegions != null) params.maxRegions = options.maxRegions;
+        if (options.sliceHeight != null) params.sliceHeight = options.sliceHeight;
+        if (options.requestedSlices) params.requestedSlices = options.requestedSlices;
       }
       return window.sendPluginCommand('CAPTURE_SCREENSHOT', params, 30000)
         .catch(function(err) { return { success: false, error: err.message || String(err) }; });
     };
 
+    // v1.9.7: Create Mini DS — variables + text styles + components in one call
+    window.createMiniDs = (params) => {
+      return window.sendPluginCommand('CREATE_MINI_DS', {
+        primaryColor: params.primaryColor || '#1464FF',
+        fontFamily: params.fontFamily || 'Inter',
+        name: params.name || 'Mini DS',
+        includeComponents: params.includeComponents !== false,
+      }, 45000) // 45s — font loading + 3 component creation takes time
+        .catch(function(err) { return { success: false, error: err.message || String(err) }; });
+    };
+
     // Batch export nodes as SVG/PNG/JPG/PDF with base64
     window.batchExportNodes = (nodeIds, format, scale, svgOutlineText, svgIncludeId, svgSimplifyStroke) => {
       return window.sendPluginCommand('BATCH_EXPORT_NODES', {
@@ -1856,6 +1873,7 @@
               if (method === 'refreshVariables') return window.refreshVariables();
               if (method === 'getLocalComponents') return window.getLocalComponents(params.currentPageOnly, params.limit);
               if (method === 'searchLibraryAssets') return window.searchLibraryAssets(params.query, params.assetTypes, params.limit, params.currentPageOnly);
+              if (method === 'getCodeConnectHints') return window.getCodeConnectHints(params.nodeIds, params.scanCurrentPage, params.maxNodes);
               if (method === 'instantiateComponent') return window.instantiateComponent(params.componentKey, params.options);
               if (method === 'setNodeDescription') return window.setNodeDescription(params.nodeId, params.description, params.descriptionMarkdown);
               if (method === 'captureScreenshot') return window.captureScreenshot(params.nodeId, params.options);
@@ -1881,6 +1899,7 @@
               if (method === 'setNodeCornerRadius') return window.setNodeCornerRadius(params.nodeId, params.radius);
               if (method === 'cloneScreenToDevice') return window.cloneScreenToDevice(params);
               if (method === 'validateScreen') return window.validateScreen(params);
+              if (method === 'createMiniDs') return window.createMiniDs(params);
               if (method === 'cloneNode') return window.cloneNode(params.nodeId);
               if (method === 'deleteNode') return window.deleteNode(params.nodeId);
               if (method === 'renameNode') return window.renameNode(params.nodeId, params.newName);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atezer/figma-mcp-bridge",
-	"version": "1.9.6",
+	"version": "1.9.8",
 	"description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
 	"type": "module",
 	"main": "dist/local-plugin-only.js",
@@ -27,7 +27,8 @@
 		"LICENSE"
 	],
 	"scripts": {
-		"prepublishOnly": "npm run build && npm run validate:fmcp-skills",
+		"prepublishOnly": "npm run generate:embedded-skills && npm run build && npm run validate:fmcp-skills",
+		"generate:embedded-skills": "node scripts/generate-embedded-skills.mjs",
 		"dev": "node dist/local-plugin-only.js",
 		"build:run": "npm run build && node dist/local-plugin-only.js",
 		"build": "tsc -p tsconfig.local.json",

package/skills/fmcp-intent-router/SKILL.md

@@ -28,18 +28,32 @@ Bu SKILL bu üç soruyu **upstream** çözer. Claude intent'i netleştirmeden hi
 
 Kullanıcı F-MCP ile ilgili herhangi bir talep yaptığında Claude bu 9 adımı SIRAYLA uygular. Hiçbir adım atlanmaz.
 
-### 🚨 Adım 0 — DS GATE (v1.9.1+ MUTLAK İLK KAPI)
+### 🚨 Adım 0 — DS GATE + BLANK FILE CHECK (v1.9.7+ MUTLAK İLK KAPI)
 
 **Herhangi bir intent analysis veya figma_* tool çağrısından ÖNCE:**
 
-1. `.claude/design-systems/active-ds.md` dosyasını oku
-2. `Status:` alanını kontrol et:
-   - **`✅ Aktif`** → DS net, Adım 1'e (Intent Analysis) geç
-   - **`❌ Henüz seçilmedi`** VEYA dosya yok → **DUR**, hiçbir tool çağırma, kullanıcıya DS sorusu sor:
-     > "Aktif bir design system belirlenmemiş. Hangi DS ile ilerlemek istersiniz?
-     > (Mevcut seçenekler için library listesini vermenizi istiyorum, veya SUI gibi spesifik bir isim verin.)
-     > Bu sorunun cevabı gelmeden hiçbir keşif / tarama yapmayacağım."
-3. Kullanıcı cevabı gelince `active-ds.md`'yi güncelle (`Status: ✅ Aktif`, `Library Name: <isim>`), sonra Adım 1'e geç.
+1. `figma_get_status` çağır — plugin bağlı mı, response'ta `_bootstrap` varsa direktifleri OKU (v1.9.7)
+2. `.claude/design-systems/active-ds.md` dosyasını oku
+3. `Status:` alanını kontrol et:
+   - **`✅ Aktif`** → DS net, Blank File Sub-Check'e geç (madde 5)
+   - **`❌ Henüz seçilmedi`** VEYA dosya yok → kullanıcıya DS sorusu sor (madde 4)
+4. **DS Sorusu (klasik):** "Aktif bir design system belirlenmemiş. Hangi DS ile ilerlemek istersiniz? (SUI / Material / kendi library)"
+
+5. **BLANK FILE SUB-CHECK (v1.9.7, ZORUNLU):** `figma_get_design_system_summary` çağır.
+   - `components === 0 && componentSets === 0 && variableCollections.length === 0` ise **BOŞ DOSYA** tespit edildi.
+   - `_nextStep: "BLANK_FILE_DIALOG_REQUIRED"` response'ta görünüyorsa, **kullanıcıya 4 seçenek sun** (AskUserQuestion tek call, 4 option):
+     ```
+     Q: "Bu dosyada henüz Design System yok. Nasıl ilerleyelim?"
+     (a) Team library import — "Hangi library? SUI, Material 3, iOS HIG, veya kendi library'niz?"
+     (b) Mini DS kur otomatik — figma_create_mini_ds tool'u çağrılır (12 color + 8 sizing + 3 text style + Button/Input/Card)
+     (c) Referans DS kopyala — "Material 3 template / iOS HIG template"
+     (d) DS'siz ilerle — linter tolerant mode, hardcoded değerler kabul (explicit acceptance)
+     ```
+   - **Seçim yapılmadan `figma_execute createFrame` YASAK.** Claude ham createFrame denerse plugin `_DESIGN_SYSTEM_VIOLATIONS_BLOCKING` flag'i döndürür, retry zorunlu olur.
+   - Kullanıcı "(b)" derse Claude `figma_create_mini_ds({ primaryColor, fontFamily, name })` tek tool çağrısı yapar, sonra ekran üretimine geçer.
+   - Kullanıcı "(a)" derse Claude `figma_get_library_variables(libraryName)` ile listeleme yapar, seçenek sunar.
+
+6. Seçim sonrası `active-ds.md`'yi güncelle (`Status: ✅ Aktif`, `Library Name: <isim>`), sonra Adım 1'e geç.
 
 **Neden bu kadar katı:**
 - DS belirsizken `figma_search_assets`, `figma_get_file_data`, `figma_get_library_variables` çağırmak = kullanıcının istemediği library'leri enumere etmek = **token israfı + UX bozulması**

package/skills/fmcp-screen-orchestrator/SKILL.md

@@ -144,6 +144,32 @@ Benchmark/görselden DEĞER alma YASAK. Sadece NİYET: layout yönü, hiyerarşi
 2. **Content** — DS instance yerleşimi → screenshot → onay
 3. **Polish** — spacing, states, edge cases → son screenshot → audit
 
+### v1.9.7 Anti-Suppression Kuralı (MUTLAK — HARD enforcement)
+
+BLOCKING response gördüğünde YASAK ifadeler:
+- "bu projede geçerli değil"
+- "dosyada DS yok, bu uyarılar önemsiz"
+- "şimdilik skip edelim"
+- "sonra düzeltiriz"
+- "yine de devam ediyorum"
+
+**Server seviyesi enforcement (Katman 3):** Claude BLOCKING flag gördükten sonra **aynı nodeId** üzerinde ikinci `figma_execute` mutation yaparsa server **HARD_ERROR** döndürür — tool fail eder, response değil error. Claude bunu skip edemez.
+
+**Override escape hatch:** Sadece kullanıcı onayı ile `// FORCE_OVERRIDE` comment'i kod başına ekleyerek bypass edilebilir.
+
+**ZORUNLU davranış BLOCKING gördüğünde:**
+1. BLOCKING'i OKU — hangi nodeId, hangi kategori? (_postExecuteViolations.violations)
+2. Kök nedeni analiz et:
+   - UNBOUND_FILL → setBoundVariableForPaint eksik
+   - UNBOUND_PADDING → setBoundVariable eksik
+   - UNBOUND_TEXTSTYLE → setTextStyleIdAsync eksik
+   - NO_INSTANCE_USAGE → DS component yok, import edilmeli
+3. Kullanıcıya sor SADECE şu koşullarda:
+   - DS gerçekten yok → Adım 0 Blank File sub-check'e dön (4 option)
+   - Override gerekli → "BLOCKING'i geçici bypass etmek istiyor musun?"
+4. Kullanıcı override isterse `// FORCE_OVERRIDE` comment ile kod tekrar çalıştır
+5. Aksi takdirde kodu DÜZELT ve retry
+
 ### v1.9.5 Discovery Budget Rule (SERT)
 
 - **Maks 3 discovery çağrısı** (figma_get_*, figma_search_*, figma_execute read-only) sonra plan sun.