@atezer/figma-mcp-bridge 1.7.29 → 1.9.0

package/agents/ds-auditor.md

@@ -1,35 +1,86 @@
 ---
 name: ds-auditor
-description: Figma ekranlarını design system uyumu açısından otonom olarak denetler, DS uyum raporu üretir. "DS audit yap", "design system kontrolü", "ekranı denetle" ifadeleriyle tetiklenir.
-model: sonnet
+description: Figma ekranlarını 5 kategori açısından denetler (DS compliance / a11y / drift / visual QA / impact). Read-only çalışır; düzeltme sadece önerir. "DS audit", "a11y kontrolü", "drift kontrol", "visual QA", "impact analizi", "ekranı denetle" ifadeleriyle tetiklenir.
+model: opus
 maxTurns: 30
 ---
 
-# DS Auditor — Design System Uyumluluk Denetim Ajanı
+# DS Auditor — Claude Code Thin Delegator
 
-Sen F-MCP DS Auditor ajanısın. Görevin Figma ekranlarını design system uyumu açısından otonom olarak denetlemek ve kapsamlı bir rapor üretmektir.
+Bu agent **sadece Claude Code'a özgü bir wrapper'dır**. Tüm iş mantığı (audit type routing, skill registry, read-only discipline, cache-first, self-audit, rapor formatı) `fmcp-ds-audit-orchestrator` skill'inde yaşar. Diğer platformlar (Cursor / Desktop / Web) aynı orchestrator skill'i doğrudan kullanır.
 
 ## Görev
 
-1. **Bağlantı kontrolü:** `figma_get_status()` ile Figma plugin bağlantısını doğrula.
-2. **Hedef tespiti:** Kullanıcıdan hangi ekran/frame'in denetleneceğini öğren veya mevcut sayfadaki tüm frame'leri tara.
-3. **Denetim:** `audit-figma-design-system` skill'indeki adımları uygula:
-   - DS bileşen kullanımı (instance vs local)
-   - Token bağlantıları (bound vs unbound)
-   - Stil tutarlılığı (text style, color style)
-   - Spacing/padding uyumu
-4. **Raporlama:** Bulgularını yapılandırılmış markdown formatında sun.
-5. **Öneriler:** Her bulgu için düzeltme önerisi ver (hangi skill kullanılmalı: fix-figma-design-system-finding veya apply-figma-design-system).
+### Adım 0 — Orchestrator Skill'i Yükle
 
-## Hata Kurtarma
+```
+Read("skills/fmcp-ds-audit-orchestrator/SKILL.md")
+```
 
-- **Plugin baglanti koparsa:** `figma_get_status()` ile tekrar kontrol et. Baglanti geri gelmezse kullaniciya bilgi ver.
-- **Tool hatasi:** Bir kez tekrar dene. Ikinci hatada durumu raporla ve manuel mudahale oner.
-- **Timeout:** Kapsami daralt (daha az node, daha dusuk depth/verbosity) ve tekrar dene.
+Essentials bölümü common case için yeterlidir. Advanced bölümüne sadece şu koşullarda in:
+- Çoklu audit tipi (compliance + a11y + drift aynı anda)
+- Cache hit ama forced refresh istendi
+- Büyük ekran SEVERE drill-down gerektiriyor
+- Fix önerisi karmaşık (narrow vs full karar)
+- Skill evolution ihtiyacı (yeni audit tipi)
 
-## Kurallar
+### Adım 1 — Audit Type Tespit
 
-- Sadece okuma işlemleri yap — hiçbir şeyi değiştirme.
-- Her tasarım değerini DS'ten doğrula: hardcoded değer = FAIL.
-- Raporu Türkçe yaz.
-- CI ortamında JSON formatı kullan.
+Orchestrator Essentials'ındaki "Audit Type Routing" tablosuna bak. Talepten keyword ile tipi seç: `compliance | a11y | drift | visual_qa | impact | auto`.
+
+Net değil → `AskUserQuestion` ile çoklu seçim sor.
+
+### Adım 2 — Cache Kontrol
+
+```
+.claude/audits/<YYYY-MM-DD>-<nodeId>.md
+```
+24h içinde rapor var → oku, cache hit (lazy-create dizini ilk kullanımda). Yoksa fresh audit.
+
+30 günden eski dosyaları temizle (her çalıştırma başında housekeeping).
+
+### Adım 3 — Sub-Skill Read (Audit Type'a Göre)
+
+| Mod | Read |
+|---|---|
+| compliance | `skills/audit-figma-design-system/SKILL.md` |
+| a11y | `skills/figma-a11y-audit/SKILL.md` |
+| drift | `skills/design-drift-detector/SKILL.md` |
+| visual_qa | `skills/visual-qa-compare/SKILL.md` |
+| impact | `skills/ds-impact-analysis/SKILL.md` |
+
+Sadece seçilen modun sub-skill'ini Read et — diğerlerine DOKUNMA.
+
+### Adım 4 — Read-Only Discipline
+
+**Hiçbir mutation YAPMA.** Bulgular + düzeltme önerisi. Kullanıcı "fix uygula" derse:
+- Onayı al
+- Öneri: `screen-builder` agent'ını tetikle (bu düzeltmeyi o yapar) veya `fmcp-screen-orchestrator` skill'ini çağır
+- Narrow (1-3 bulgu tek frame) → `fix-figma-design-system-finding`
+- Full (4+ bulgu veya dağınık) → `apply-figma-design-system`
+
+### Adım 5 — Self-Audit (Rapor Kalite)
+
+Teslim öncesi:
+- Her SEVERE kategori için ≥1 somut nodeId var mı?
+- Her bulgu için "neden önemli" + düzeltme önerisi var mı?
+- Metrik bloğu eksiksiz mi?
+
+Fail → düzelt, sonra teslim.
+
+### Adım 6 — Rapor
+
+Orchestrator'ın "Rapor Formatı" şablonunu kullan. CI ortamında JSON mode destekle (`CI=true` env var veya kullanıcı "JSON formatında" derse).
+
+## Kritik Kurallar (Özet — Full: orchestrator skill)
+
+- **Read-only:** Hiçbir `figma_execute` mutation yok, sadece `figma_get_*` read tool'ları
+- **Cheap-first:** depth=1, summary; SEVERE bulgu alt ağacında drill-down
+- **Cache-first:** `.claude/audits/` önce kontrol, 30 günden eski temizle
+- **Her bulgu için nodeId:** Somut olmadan raporlama yok
+- **Türkçe rapor:** metrik bloğu sonunda
+
+## Memory Referansları
+
+- `feedback_figma_approval.md` — destructive action onay kuralı
+- `feedback_turkish_chars.md` — Türkçe karakter kontrolü

package/agents/screen-builder.md

@@ -1,35 +1,73 @@
 ---
 name: screen-builder
-description: Açıklama veya koddan Figma ekranı oluşturur, DS bileşenlerini kullanır. "Figma'da ekran oluştur", "ekran tasarla", "generate screen" ifadeleriyle tetiklenir.
-model: sonnet
+description: DS-compliant Figma ekran üretim agent'ı. Text / yüklenmiş görsel / Figma benchmark / "fikrim yok" girdilerinden ekran üretir. "ekran tasarla", "figma'da ekran oluştur", "alternatif üret", "bu görselden ilham al" ifadeleriyle tetiklenir. Claude Code sub-agent isolation avantajıyla ana conversation context'ini temiz tutar.
+model: opus
 maxTurns: 40
 ---
 
-# Screen Builder — Figma Ekran Oluşturma Ajanı
+# Screen Builder — Claude Code Thin Delegator
 
-Sen F-MCP Screen Builder ajanısın. Görevin açıklama, wireframe veya koddan Figma'da tam ekran oluşturmaktır.
+Bu agent **sadece Claude Code'a özgü bir wrapper'dır**. Tüm iş mantığı, karar akışı, skill registry, intake routing, self-audit gate ve rapor formatı `fmcp-screen-orchestrator` skill'inde yaşar. Diğer platformlar (Cursor / Claude Desktop / Claude Web) aynı orchestrator skill'i doğrudan kullanır — bu delegator onlar için gereksizdir.
 
 ## Görev
 
-1. **Bağlantı kontrolü:** `figma_get_status()` ile Figma plugin bağlantısını doğrula.
-2. **DS hazırlık:** Kayıtlı kütüphaneyi kontrol et (`.claude/libraries/`), yoksa `figma_search_components()` ile DS bileşenlerini tara.
-3. **Token okuma:** `figma_get_variables()` ve `figma_get_styles()` ile tasarım token'larını al.
-4. **Ekran oluşturma:** `generate-figma-screen` skill'indeki adımları uygula:
-   - DS bileşen instance'ları kullan (hardcoded shape YASAK)
-   - Tüm değerleri DS variable'larına bağla
-   - Auto-layout ile responsive yapı kur
-5. **Doğrulama:** `figma_capture_screenshot()` ile sonucu göster ve kullanıcı onayı al.
+### Adım 0 — Orchestrator Skill'i Yükle
 
-## Hata Kurtarma
+```
+Read("skills/fmcp-screen-orchestrator/SKILL.md")
+```
 
-- **Plugin baglanti koparsa:** `figma_get_status()` ile tekrar kontrol et. Baglanti geri gelmezse kullaniciya bilgi ver.
-- **Tool hatasi:** Bir kez tekrar dene. Ikinci hatada durumu raporla ve manuel mudahale oner.
-- **Timeout:** Kapsami daralt (daha az node, daha dusuk depth/verbosity) ve tekrar dene.
+Essentials bölümü common case için yeterlidir. Advanced bölümüne sadece şu koşullarda in:
+- Intake modu karmaşık (nested benchmark, hybrid image + metin)
+- 3. self-audit denemesi başarısız
+- Skill evolution ihtiyacı doğdu
+- Non-obvious error (plugin bağlantı kaybı, timeout döngüsü)
 
-## Kurallar
+### Adım 1 — Kullanıcı Talebini Intake Mode'a Eşle
 
-- `figma-canvas-ops` kurallarını her `figma_execute` öncesi uygula.
-- Hardcoded renk/boyut/font YASAK — tümü DS'ten bağlanmalı.
-- Her node'da DS variable bağlantısı zorunlu.
-- Brand profile varsa (`.fmcp-brand-profile.json`) oku ve uygula.
-- Raporu ve tüm iletişimi Türkçe yap.
+Orchestrator Essentials'ındaki "Karar Akışı" bölümüne bak. Talebi şu modlardan birine ata:
+- `text_only` — net metin açıklaması
+- `figma_benchmark` — Figma URL pattern (`figma.com/file/...?node-id=`)
+- `image_uploaded` — kullanıcı sohbete görsel eklemiş
+- `image_url` — HTTP URL ama Figma değil (dribbble/behance/vs)
+- `no_idea` — kullanıcı "bilmiyorum/bir şey öner/fikrim yok" diyor
+
+Belirsizse önce `Read("skills/fmcp-intent-router/SKILL.md")` ile netleştir.
+
+### Adım 2 — Orchestrator Karar Akışını Uygula
+
+Orchestrator'ın "Karar Akışı" tablosunu takip et. Sub-skill'leri **yalnızca karar anında** Read et (lazy loading):
+- Intake image/benchmark modunda mı? → `Read("skills/inspiration-intake/SKILL.md")`
+- `figma_execute` çağıracak mısın? → `Read("skills/figma-canvas-ops/SKILL.md")` pre-flight
+- Ana üretim? → `Read("skills/generate-figma-screen/SKILL.md")`
+
+Sezgisel "belki lazım olur" Read yasak. Gereksiz sub-skill yüklemesi sub-agent context'ini şişirir.
+
+### Adım 3 — Self-Audit Gate (Zorunlu)
+
+Teslim öncesi:
+```
+figma_validate_screen(nodeId=<wrapper_id>, minScore=80)
+```
+`minScore=80` **her çağrıda explicit**. Başarısız → hedefli düzelt → yeniden validate. 3 deneme fail → Advanced bölümünün Error Recovery Matrix'ine in.
+
+### Adım 4 — Rapor
+
+Orchestrator'ın "Rapor Formatı" şablonunu kullan. Metrik bloğu (kullanılan skill'ler / API call / cache hit-miss / execute sayısı / validate score) **zorunlu**, atlanamaz.
+
+## Kritik Kurallar (Özet — Full: orchestrator skill)
+
+- **v1.8.2 build-from-scratch:** `"alternatif/varyasyon/farklı/yeni/tasarla/redesign"` keyword'leri → build-from-scratch KİLİTLİ, `figma_clone_screen_to_device` ASLA. Authoritative source: `skills/fmcp-intent-router/SKILL.md:68-80`
+- **DS fallback chain:** Component → Primitive variant → Token-bound frame → ASLA raw shape
+- **Inspiration only:** Benchmark/görselden değer alma YASAK, sadece niyet
+- **Cache-first:** `.claude/design-systems/<lib>/` cache'i API çağırmadan ÖNCE oku
+- **Türkçe rapor:** metrik bloğu sonunda
+
+## Memory Referansları
+
+- `feedback_figma_approval.md` — Figma onay kuralı
+- `feedback_ds_component_usage.md` — ham text/shape YASAK
+- `feedback_autolayout_fill.md` — FILL kuralı
+- `feedback_figma_screen_standard.md` — ≤5 execute hedefi
+- `feedback_gestalt_design.md` — eşit spacing YASAK
+- `feedback_turkish_chars.md` — Türkçe karakter kontrolü

package/agents/token-syncer.md

@@ -1,32 +1,76 @@
 ---
 name: token-syncer
-description: Figma design token'larını kod dosyalarıyla senkronize eder (CSS/Tailwind/Swift/Compose). "Token'ları senkronla", "export tokens", "token pipeline" ifadeleriyle tetiklenir.
-model: sonnet
+description: Figma design token'larını kod dosyalarıyla (CSS/Tailwind/Swift/Compose/Sass) senkronize eder. Diff preview + onay + write zorunlu akış. "token sync", "export tokens", "Tailwind'e aktar", "design tokens" ifadeleriyle tetiklenir.
+model: opus
 maxTurns: 20
 ---
 
-# Token Syncer — Design Token Senkronizasyon Ajanı
+# Token Syncer — Claude Code Thin Delegator
 
-Sen F-MCP Token Syncer ajanısın. Görevin Figma variable'larını ve stil'lerini kod tarafındaki token dosyalarıyla senkronize etmektir.
+Bu agent **sadece Claude Code'a özgü bir wrapper'dır**. Tüm iş mantığı (platform routing, diff preview, binding coverage, rapor formatı) `fmcp-token-sync-orchestrator` skill'inde yaşar. Diğer platformlar (Cursor / Desktop / Web) aynı orchestrator skill'i doğrudan kullanır.
 
 ## Görev
 
-1. **Bağlantı kontrolü:** `figma_get_status()` ile Figma plugin bağlantısını doğrula.
-2. **Token okuma:** `figma_get_variables()` ve `figma_get_styles()` ile mevcut token'ları çek.
-3. **Platform tespiti:** Hedef platformu belirle (Web: CSS/Tailwind/Sass, iOS: Swift, Android: Compose/XML).
-4. **Senkronizasyon:** `design-token-pipeline` skill'indeki adımları uygula:
-   - Figma → Kod (export)
-   - Kod → Figma (import — opsiyonel)
-5. **Doğrulama:** Oluşturulan dosyaları kontrol et.
+### Adım 0 — Orchestrator Skill'i Yükle
 
-## Hata Kurtarma
+```
+Read("skills/fmcp-token-sync-orchestrator/SKILL.md")
+```
 
-- **Plugin baglanti koparsa:** `figma_get_status()` ile tekrar kontrol et. Baglanti geri gelmezse kullaniciya bilgi ver.
-- **Tool hatasi:** Bir kez tekrar dene. Ikinci hatada durumu raporla ve manuel mudahale oner.
-- **Timeout:** Kapsami daralt (daha az node, daha dusuk depth/verbosity) ve tekrar dene.
+Essentials bölümü common case için yeterlidir. Advanced bölümüne sadece şu koşullarda in:
+- Multi-platform sync (aynı token'lar hem CSS hem Swift)
+- Custom component mapping (code-design-mapper gerektiren)
+- Platform default path uygunsuz (custom path)
+- Kod → Figma import mode
+- Yeni platform desteği (skill evolution)
 
-## Kurallar
+### Adım 1 — Platform Tespit
 
-- Hardcoded token değeri YASAK — tümü Figma'dan okunmalı.
-- Mevcut token dosyası varsa üzerine yazmadan önce diff göster.
-- Raporu Türkçe yaz.
+Orchestrator Essentials'ındaki "Platform Routing" tablosuna bak:
+- Kullanıcı hedef dosyayı verdi mi? Uzantıdan platformu tespit et
+- Kullanıcı sadece platform adı verdi mi? Standard path öner
+- Hiçbiri yok → `AskUserQuestion` ile çoklu seçim sor (CSS / Tailwind / Swift / Compose)
+
+### Adım 2 — Sub-Skill Read
+
+```
+Read("skills/design-token-pipeline/SKILL.md")
+```
+Ana motor her zaman bu. `code-design-mapper` ve `design-system-rules` sadece spesifik ihtiyaç olursa.
+
+### Adım 3 — Dry-Run + Diff Preview
+
+**Dosyaya yazma!** Sadece buffer'a al, mevcut dosyayla unified diff üret, sohbete yaz.
+
+### Adım 4 — Onay Al
+
+`AskUserQuestion` ile: "Bu değişiklikleri uygulayayım mı? (Evet / Hayır / Sadece bazıları)". Onay olmadan `Write` / `Edit` yasak.
+
+### Adım 5 — Write (Onay Sonrası)
+
+- Mevcut dosya varsa → `Edit` ile hedefli
+- Yoksa → `Write` ile yeni dosya
+
+### Adım 6 — Self-Audit (Binding Coverage)
+
+Write sonrası:
+- Toplam token sayısı
+- Binding oranı (%)
+- Upgraded (hardcoded → variable binding)
+- Leftover (hâlâ hardcoded kalan node sayısı) → ds-auditor'a yönlendir
+
+### Adım 7 — Rapor
+
+Orchestrator'ın "Rapor Formatı" şablonunu kullan. Metrik bloğu zorunlu.
+
+## Kritik Kurallar (Özet — Full: orchestrator skill)
+
+- **Diff olmadan write YOK:** Mutlak kural, ihlal edilemez
+- **Platform tespit:** Belirsizse sor, tahmin etme
+- **Cheap-first:** `figma_get_variables(verbosity="summary")` default; full sadece eksik binding keşfinde
+- **Türkçe rapor:** metrik bloğu sonunda
+
+## Memory Referansları
+
+- `feedback_figma_approval.md` — destructive action onay kuralı
+- `feedback_turkish_chars.md` — Türkçe karakter kontrolü

package/dist/core/code-warnings.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Static analyzer for figma_execute code — detects Plugin API gotchas AND
+ * design-system discipline violations.
+ *
+ * v1.8.1+: Emits structured CodeWarning objects with SEVERE vs ADVISORY
+ * severity. SEVERE warnings surface as _designSystemViolations in the
+ * execute response (prominent, Claude-readable); ADVISORY warnings stay
+ * in _warnings (legacy gotchas).
+ *
+ * Never blocks execution — the analyzer is advisory-only by design.
+ * Claude reads the warnings and self-corrects on the next turn.
+ */
+/** Warning severity — SEVERE violates DS discipline; ADVISORY is a gotcha hint. */
+export type WarningSeverity = "SEVERE" | "ADVISORY";
+export interface CodeWarning {
+    severity: WarningSeverity;
+    category: string;
+    message: string;
+}
+/**
+ * Analyze figma_execute code for common mistakes AND design-system discipline
+ * violations. Returns an array of structured warnings.
+ *
+ * SEVERE categories (v1.8.1+):
+ *   HARDCODED_COLOR        — SOLID fills without setBoundVariableForPaint
+ *   NO_INSTANCE_USAGE      — 3+ createFrame without component instantiation
+ *   HARDCODED_FONT_SIZE    — .fontSize without setTextStyleIdAsync
+ *   HARDCODED_SPACING      — padding/itemSpacing/cornerRadius without setBoundVariable
+ *   HAND_BUILT_SEPARATORS  — 2+ createRectangle without instance/binding
+ *   NO_AUTO_LAYOUT         — createFrame without layoutMode
+ *
+ * ADVISORY categories (pre-v1.8.1 legacy gotchas):
+ *   ORDERING               — FILL/ABSOLUTE set before appendChild
+ *   SYNC_API               — sync style APIs in dynamic-page mode
+ *   FONT_LOAD              — .characters= without loadFontAsync
+ */
+export declare function analyzeCodeForWarnings(code: string): CodeWarning[];
+//# sourceMappingURL=code-warnings.d.ts.map

package/dist/core/code-warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-warnings.d.ts","sourceRoot":"","sources":["../../src/core/code-warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CA2LlE"}

package/dist/core/code-warnings.js

@@ -0,0 +1,191 @@
+/**
+ * Static analyzer for figma_execute code — detects Plugin API gotchas AND
+ * design-system discipline violations.
+ *
+ * v1.8.1+: Emits structured CodeWarning objects with SEVERE vs ADVISORY
+ * severity. SEVERE warnings surface as _designSystemViolations in the
+ * execute response (prominent, Claude-readable); ADVISORY warnings stay
+ * in _warnings (legacy gotchas).
+ *
+ * Never blocks execution — the analyzer is advisory-only by design.
+ * Claude reads the warnings and self-corrects on the next turn.
+ */
+/**
+ * Analyze figma_execute code for common mistakes AND design-system discipline
+ * violations. Returns an array of structured warnings.
+ *
+ * SEVERE categories (v1.8.1+):
+ *   HARDCODED_COLOR        — SOLID fills without setBoundVariableForPaint
+ *   NO_INSTANCE_USAGE      — 3+ createFrame without component instantiation
+ *   HARDCODED_FONT_SIZE    — .fontSize without setTextStyleIdAsync
+ *   HARDCODED_SPACING      — padding/itemSpacing/cornerRadius without setBoundVariable
+ *   HAND_BUILT_SEPARATORS  — 2+ createRectangle without instance/binding
+ *   NO_AUTO_LAYOUT         — createFrame without layoutMode
+ *
+ * ADVISORY categories (pre-v1.8.1 legacy gotchas):
+ *   ORDERING               — FILL/ABSOLUTE set before appendChild
+ *   SYNC_API               — sync style APIs in dynamic-page mode
+ *   FONT_LOAD              — .characters= without loadFontAsync
+ */
+export function analyzeCodeForWarnings(code) {
+    const warnings = [];
+    // ────────────────────────────────────────────────────────────────────
+    // SECTION 1 — Plugin API gotchas (ADVISORY)
+    // ────────────────────────────────────────────────────────────────────
+    // 1a. FILL before appendChild — must set FILL *after* node is in auto-layout parent
+    if (/layoutSizing(?:Horizontal|Vertical)\s*=\s*['"]FILL['"]/i.test(code)) {
+        const fillIdx = code.search(/layoutSizing(?:Horizontal|Vertical)\s*=\s*['"]FILL['"]/i);
+        const appendIdx = code.indexOf("appendChild");
+        if (appendIdx === -1 || fillIdx < appendIdx) {
+            warnings.push({
+                severity: "ADVISORY",
+                category: "ORDERING",
+                message: "layoutSizingHorizontal/Vertical = 'FILL' appendChild'dan ONCE ayarlanmis. " +
+                    "Oncesinde hata verir. FILL'i appendChild SONRASINA tasi.",
+            });
+        }
+    }
+    // 1b. layoutPositioning = ABSOLUTE before appendChild (v1.8.1: added)
+    if (/layoutPositioning\s*=\s*['"]ABSOLUTE['"]/i.test(code)) {
+        const absIdx = code.search(/layoutPositioning\s*=\s*['"]ABSOLUTE['"]/i);
+        const appendIdx = code.indexOf("appendChild");
+        if (appendIdx === -1 || absIdx < appendIdx) {
+            warnings.push({
+                severity: "ADVISORY",
+                category: "ORDERING",
+                message: "layoutPositioning = 'ABSOLUTE' appendChild'dan ONCE ayarlanmis. " +
+                    "Parent layoutMode !== NONE kontrolu basarisiz olur. appendChild SONRA ayarla.",
+            });
+        }
+    }
+    // 1c. Sync API usage — should use Async versions
+    // v1.8.2: expanded to include node/style/variable lookup APIs that fail
+    // in dynamic-page mode (causing "Cannot call with documentAccess: dynamic-page" errors)
+    const syncApis = [
+        { sync: "getLocalPaintStyles(", async: "getLocalPaintStylesAsync(" },
+        { sync: "getLocalTextStyles(", async: "getLocalTextStylesAsync(" },
+        { sync: "getLocalEffectStyles(", async: "getLocalEffectStylesAsync(" },
+        { sync: "getLocalGridStyles(", async: "getLocalGridStylesAsync(" },
+        // v1.8.2: dynamic-page mode fixes
+        { sync: "figma.getNodeById(", async: "figma.getNodeByIdAsync(" },
+        { sync: "figma.getStyleById(", async: "figma.getStyleByIdAsync(" },
+        { sync: "figma.variables.getVariableById(", async: "figma.variables.getVariableByIdAsync(" },
+        { sync: "figma.variables.getVariableCollectionById(", async: "figma.variables.getVariableCollectionByIdAsync(" },
+        { sync: "figma.importComponentByKey(", async: "figma.importComponentByKeyAsync(" },
+    ];
+    for (const api of syncApis) {
+        if (code.includes(api.sync) && !code.includes(api.async)) {
+            warnings.push({
+                severity: "ADVISORY",
+                category: "SYNC_API",
+                message: `Sync API '${api.sync.slice(0, -1)}' tespit edildi. 'await ${api.async.slice(0, -1)}' kullanin — dynamic-page modunda sync API'ler calismaz.`,
+            });
+        }
+    }
+    // 1d. Font not loaded before text modification
+    if ((/\.characters\s*=/.test(code) || code.includes(".insertCharacters") || code.includes(".deleteCharacters")) &&
+        !code.includes("loadFontAsync")) {
+        warnings.push({
+            severity: "ADVISORY",
+            category: "FONT_LOAD",
+            message: "Text icerik degisikligi (characters) tespit edildi, ancak loadFontAsync cagrisi yok. " +
+                "Metin degistirmeden once 'await figma.loadFontAsync(node.fontName)' ekleyin.",
+        });
+    }
+    // 1e. Sync page assignment — does not work
+    if (/figma\.currentPage\s*=/.test(code) && !code.includes("setCurrentPageAsync")) {
+        warnings.push({
+            severity: "ADVISORY",
+            category: "SYNC_API",
+            message: "'figma.currentPage = ...' calismaz. 'await figma.setCurrentPageAsync(page)' kullanin.",
+        });
+    }
+    // ────────────────────────────────────────────────────────────────────
+    // SECTION 2 — Design System Discipline (SEVERE — v1.8.1+)
+    // These warnings indicate Claude is bypassing DS tokens and instance reuse,
+    // producing hand-built UI that ignores the configured design system.
+    // ────────────────────────────────────────────────────────────────────
+    // 2a. Hardcoded solid color literal — fills = [{type:'SOLID',color:{r:...,g:...,b:...}}]
+    // Matches any code that constructs a SOLID paint with inline RGB values.
+    const hardcodedSolidRegex = /type\s*:\s*['"]SOLID['"][\s\S]{0,200}?color\s*:\s*\{\s*r\s*:\s*[\d.]+/;
+    if (hardcodedSolidRegex.test(code)) {
+        // If the code ALSO uses setBoundVariableForPaint, it's probably binding the
+        // variable and using the solid as a structure scaffold — allow it.
+        if (!code.includes("setBoundVariableForPaint")) {
+            warnings.push({
+                severity: "SEVERE",
+                category: "HARDCODED_COLOR",
+                message: "❌ TOKEN DISIPLINI IHLALI: Hardcoded SOLID color tespit edildi ama setBoundVariableForPaint cagrisi yok. " +
+                    "Design system token binding ZORUNLUDUR. Once 'figma_get_library_variables' ile variable key'leri al, " +
+                    "sonra 'importVariableByKeyAsync' + 'setBoundVariableForPaint' kullan. " +
+                    "Ornek: const v = await figma.variables.importVariableByKeyAsync('KEY'); " +
+                    "const bound = figma.variables.setBoundVariableForPaint(fills[0], 'color', v); node.fills = [bound];",
+            });
+        }
+    }
+    // 2b. No-instance usage — 3+ createFrame but 0 component instantiation
+    const createFrameCount = (code.match(/figma\.createFrame\(\)/g) || []).length;
+    const hasInstanceCreation = code.includes("importComponentByKeyAsync") ||
+        code.includes("createInstance()") ||
+        code.includes(".createInstance(") ||
+        code.includes("importComponentSetByKeyAsync");
+    if (createFrameCount >= 3 && !hasInstanceCreation) {
+        warnings.push({
+            severity: "SEVERE",
+            category: "NO_INSTANCE_USAGE",
+            message: `❌ DS BILESEN KULLANIMI EKSIK: ${createFrameCount} adet createFrame() cagrisi tespit edildi ama ` +
+                "hicbir component instance olusturulmamis (importComponentByKeyAsync / createInstance yok). " +
+                "Design system bilesenleri varsa SIFIRDAN CIZME - once figma_search_assets ile mevcut DS " +
+                "bileseni ara, sonra figma_instantiate_component veya importComponentByKeyAsync kullan. " +
+                "Hesapkart, Button, NavigationTopBar, BottomNav, PillTabs gibi DS bilesenleri zaten library'de var.",
+        });
+    }
+    // 2c. Hardcoded fontSize without setTextStyleIdAsync
+    if (/\.fontSize\s*=\s*\d/.test(code) && !code.includes("setTextStyleIdAsync")) {
+        warnings.push({
+            severity: "SEVERE",
+            category: "HARDCODED_FONT_SIZE",
+            message: "❌ TIPOGRAFI DISIPLINI IHLALI: Hardcoded fontSize tespit edildi ama setTextStyleIdAsync cagrisi yok. " +
+                "DS text style'lari ZORUNLUDUR. figma_import_style ile text style import et veya " +
+                "getLocalTextStylesAsync() ile bul, sonra 'await textNode.setTextStyleIdAsync(style.id)' kullan. " +
+                "Bu font family + size + weight + line-height'i TEK seferde bagllar. " +
+                "Uyari: setBoundVariable('fontSize', v) YANLIS - sadece size bagllar, style bagllmaz.",
+        });
+    }
+    // 2d. Hardcoded padding/gap/radius without setBoundVariable
+    const spacingAssignRegex = /\.(?:paddingTop|paddingBottom|paddingLeft|paddingRight|itemSpacing|counterAxisSpacing|topLeftRadius|topRightRadius|bottomLeftRadius|bottomRightRadius|cornerRadius)\s*=\s*\d/;
+    if (spacingAssignRegex.test(code) && !code.includes("setBoundVariable")) {
+        warnings.push({
+            severity: "SEVERE",
+            category: "HARDCODED_SPACING",
+            message: "❌ SPACING DISIPLINI IHLALI: Hardcoded padding/itemSpacing/cornerRadius tespit edildi ama " +
+                "setBoundVariable cagrisi yok. DS spacing token'lari ZORUNLUDUR. " +
+                "figma_get_library_variables ile spacing variable key'lerini al, importVariableByKeyAsync ile import et, " +
+                "'node.setBoundVariable(\"paddingLeft\", variable)' kullan. " +
+                "Yaygin DS spacing token'lari: spacing/100, spacing/200, spacing/300, spacing/400.",
+        });
+    }
+    // 2e. Rectangle as separator without DS reference (often indicates hand-built dividers)
+    const rectCount = (code.match(/figma\.createRectangle\(\)/g) || []).length;
+    if (rectCount >= 2 && !hasInstanceCreation && !code.includes("setBoundVariableForPaint")) {
+        warnings.push({
+            severity: "SEVERE",
+            category: "HAND_BUILT_SEPARATORS",
+            message: `❌ ${rectCount} adet createRectangle() cagrisi tespit edildi (muhtemelen divider/separator icin). ` +
+                "DS'de Divider/Separator bileseni varsa onu kullan, elle rectangle cizme. " +
+                "Alternatif: frame border + setBoundVariableForPaint ile stroke token binding.",
+        });
+    }
+    // 2f. No auto-layout — createFrame without layoutMode assignment
+    if (createFrameCount >= 1 && !code.includes("layoutMode")) {
+        warnings.push({
+            severity: "SEVERE",
+            category: "NO_AUTO_LAYOUT",
+            message: `❌ RESPONSIVE EKSIK: ${createFrameCount} adet createFrame() cagrisi var ama hicbir layoutMode atamasi yok. ` +
+                "Auto-layout olmayan frame'ler responsive degildir, icerige gore boyutlanmaz. " +
+                "Her frame icin 'frame.layoutMode = \"VERTICAL\"' (veya HORIZONTAL) + primaryAxisSizingMode ekle.",
+        });
+    }
+    return warnings;
+}
+//# sourceMappingURL=code-warnings.js.map

package/dist/core/code-warnings.js.map

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

package/dist/core/device-presets.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Figma device frame presets — canonical dimensions used in Figma's
+ * built-in "Frame" picker (matches the iPhone/Android/iPad preset list).
+ *
+ * v1.8.1+: Used by figma_clone_screen_to_device to adapt a source
+ * screen to a target device size while preserving auto-layout and
+ * library instance bindings.
+ */
+export interface DevicePreset {
+    /** Canonical name shown in Figma UI */
+    name: string;
+    /** Width in points (Figma uses px but logical points) */
+    width: number;
+    /** Height in points */
+    height: number;
+    /** Platform category for grouping */
+    category: "phone" | "tablet" | "desktop" | "watch" | "custom";
+    /** Additional aliases that resolve to this preset */
+    aliases?: string[];
+}
+/**
+ * Built-in device presets — matches Figma's Frame picker as of 2025-2026.
+ * Values verified against the user-provided screenshot of Figma's frame panel.
+ */
+export declare const DEVICE_PRESETS: DevicePreset[];
+/**
+ * Look up a device preset by name or alias (case-insensitive).
+ * Returns undefined if no match found.
+ */
+export declare function findPreset(name: string): DevicePreset | undefined;
+/**
+ * Parse a custom device dimension string like "1200x800" or "1200×800".
+ * Returns undefined if the string is not a valid dimension pair.
+ */
+export declare function parseCustomDimension(input: string): {
+    width: number;
+    height: number;
+} | undefined;
+/**
+ * Resolve a device string (name, alias, or custom "WxH") to concrete
+ * dimensions. Used by figma_clone_screen_to_device before sending the
+ * request to the plugin handler.
+ */
+export declare function resolveDevice(input: string): {
+    name: string;
+    width: number;
+    height: number;
+} | undefined;
+//# sourceMappingURL=device-presets.d.ts.map

package/dist/core/device-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-presets.d.ts","sourceRoot":"","sources":["../../src/core/device-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC5B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9D,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAkExC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAwBjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAU/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAc7D"}