@appaflytech/zeyrek-ai-mcp 0.0.20 → 0.0.22

package/dist/knowledge/mobileComponentCatalog.js

@@ -146,6 +146,18 @@ export const mobileComponentKnowledge = {
             'Seçenekler normalize edilir: düz metin dizisi, nesne dizisi ve `optionType: "grouped"` çocukları tek biçime iner; grup başlığı seçilemez, etiketi olmayan seçenek değerini gösterir.'
         ]
     },
+    'language-selector': {
+        summary: 'Dil değiştirici; `dropdown`un tam ekran `Modal` listesiyle çizilir, seçim uygulama çapında kalıcı olur.',
+        differences: [
+            "Çizim `dropdown`un kendisidir (plans/mobil-coklu-dil K4): tetikleyici `role=\"combobox\"` (iç rol `<elementId>__trigger`), liste tam ekran `Modal`da `role=\"option\"` + `data-value` satırları; temizleme düğmesi YOK (dil boş olamaz). `page_screenshot` `select: '<elementId>', value: 'en'` ile seçilir, seçenek metni dilin yerel adıdır (`LANGUAGE_NAMES`: `tr` → Türkçe, `en` → English).",
+            "Diller ve aktif dil makineden enjekte edilir (web `RenderComponent` ile aynı): `languages` = projenin dil listesi (`project_update(languages)`), `value` = `machine.getLanguage()`. Seçim `machine.setLanguage(value)` ile bütün düğümlere `reload` yayar (çeviriye bağlı prop'lar yerinde çözülür), sonra `change { value, selectedLabel }` sayfa akışına gider.",
+            "Seçim makineye VERİLEN depoya `zeyrek:<app>:lang` anahtarıyla yazılır: `/preview` ve `/dev|/view`'da tarayıcı `localStorage`, cihazda uygulamanın kv-store'u — uygulama yeniden açılınca o dille başlar. Cihazda barındırıcı seçimi uygulama çapında yayar (`onLanguageChange`): öteki sekmelerin ekranları ve sekme etiketleri de değişir; `?lang` yalnız web barındırıcısında vardır.",
+            "Projede dil tanımlı değilse (`languages` boş) liste boş çizilir — önce `project_update(languages, defaultLanguage)`; `project_get` yanıtındaki `localization` bloğu runtime'ın çevirileri çözüp çözemeyeceğini söyler."
+        ],
+        propNotes: {
+            label: 'Alan etiketi (`FieldShell`); boşsa yalnız tetikleyici çizilir.'
+        }
+    },
     divider: {
         summary: 'Çizgi; etiket verilirse çizgi etiketin iki yanına bölünür.',
         differences: [
@@ -305,7 +317,7 @@ export const mobileComponentKnowledge = {
         differences: [
             '`marks`, `showTicks` ve `autofocus` DÜŞÜRÜLDÜ.',
             'Jest `PanResponder` ile çözülür ve YALNIZ YATAY sürüklemeyi yakalar: dokunuşu başlangıçta yakalasaydı sayfa kaydırması değeri değiştirirdi (ölçüldü — kaydırma 40`ı 100 yapıyordu).',
-            'Sürüklerken `change`, parmak kalkınca `changed` yayılır; akış genelde `changed`e bağlanır.'
+            'Sürüklerken `change`, parmak kalkınca `changed` yayılır; akış genelde `changed`e bağlanır. İze dokunuş değeri o noktaya getirir (`change` + `changed`). Jest `modal`/çekmece içinde de çalışır.'
         ]
     },
     tabs: {
@@ -327,5 +339,205 @@ export const mobileComponentKnowledge = {
         propNotes: {
             side: 'Balonun tetikleyiciye göre yanı. Seçilen yan ekrana sığmazsa balon ÇEVRİLMEZ, yalnız ekran içine kaydırılır.'
         }
+    },
+    markdown: {
+        summary: 'Markdown metnini çizer: başlık, paragraf, liste, bağlantı, kod, alıntı, ayraç, tablo, görsel. Web`de karşılığı YOKTUR — web `html` ayrı bileşendir ve HTML çalıştırır.',
+        differences: [
+            'Metin `marked` ile ayrıştırılır ve bileşenin kendi ilkelleriyle çizilir: HTML üretilmez, hiçbir şey çalıştırılmaz. Satır içi HTML etiketi düşer (içindeki metin kalır), blok HTML etiketsiz metne iner; `&amp;` gibi varlıklar çözülür — kod aralığında çözülmez, orada ham metindir.',
+            'HTML gibi: yumuşak satır sonu boşluktur ve ardışık boşluklar teke iner, yalnız sert kırılma (satır sonunda iki boşluk) satır kırar. GFM görev maddesi (`- [ ]`, `- [x]`) nokta yerine ☐/☑ çizilir (sıralı listede numaranın yanında); sıralı liste yazıldığı sayıdan başlar (`0.` dahil).',
+            'Başlık puntoları `text` bileşeninin tip ölçeğinden (`h1`–`h4`; 5 ve 6 `h4` puntosunda), renkler token sınıflarından: kod `--muted` zemin, bağlantı `--primary`, alıntı ve tablo `--border` çizgi. Düğümün `typographyStyle`ı her metne iner; puntosu ve satır yüksekliği GÖVDE metnindir, başlık kendi puntosunu korur.',
+            'Görsel yalnız tek başına bir paragrafta ve http(s) adresiyle çizilir (tam genişlik, 180 dp yükseklik, `contain`); satır içindeki görsel alt metnine iner.',
+            'Bağlantıya dokunuş `linkClick { href }` yayar (ham adres); `linkOpensExternal` açıkken (varsayılan) yalnız http(s), mailto ve tel adresi sistem tarayıcısında açılır — `javascript:` ya da göreli adres açılmaz ama olay yine gelir, gezinmeye akış karar verir. Tasarım kipinde bağlantı basılamaz; boş içerik tasarımda yer tutucu, runtime`da hiçbir şey çizer.'
+        ],
+        propNotes: {
+            content: "Markdown metni (CommonMark + GFM tablo ve üstü çizili); bağlanabilir: `{ type: 'code', ref: '{{ ... }}' }`.",
+            linkOpensExternal: 'false iken bağlantı yalnız `linkClick` yayar, hiçbir şey açmaz — gezinmeyi akış yapar (ör. `redirect`).'
+        }
+    },
+    calendar: {
+        summary: 'Satır içi ay takvimi: tek gün ya da aralık seçer. Web`de katalog bileşeni DEĞİLDİR (web `calendar` yalnız `datepicker`ın açılır ızgarası); ızgara kuralı onunla aynı modülden.',
+        differences: [
+            'Prop adları web `datepicker`ınkiler (`value`, `minDate`, `maxDate`, `locale`) ve `change` yükü onun biçimidir (`yyyy-MM-ddT00:00:00`, yerel duvar saati, dilim eki yok) — iki bileşen akışlarda birbirinin yerine geçer. Gelen değer web `datepicker`ın `toDate` kuralıyla okunur: yalın `yyyy-MM-dd` yerel gündür; dilim taşıyan metin (`…Z`, `+00:00` — platform statik tarih değerini UTC`ye çevirip kaydeder) yerel güne çevrilir; sayı zaman damgası da okunur.',
+            'Izgara altı haftadır (42 gün); hafta Türkçede Pazartesi, İngilizcede Pazar başlar. `locale` boşsa uygulamanın dili; Türkçe olmayan dil İngilizceye, bilinmeyen dil Türkçeye düşer.',
+            'İç roller: `<elementId>__prev` ve `<elementId>__next` (ay), `<elementId>__day-yyyy-MM-dd` (gün) — `page_screenshot` `click` onlarla basar. Ay dışındaki güne basış o aya da geçer.',
+            'Salt okunurken aylar gezilir ama gün seçilmez; pasifken ikisi de kapalı. Değer akıştan başka bir aya yazılınca takvim o aya döner. Tasarım kipinde statik ay çizilir, basılamaz.'
+        ],
+        propNotes: {
+            mode: "`single` (varsayılan) ya da `range`. Aralıkta ilk basış başlangıç (`value`), ikinci basış bitiş (`endValue`); başlangıçtan önceki gün ya da tamamlanmış aralığa basış yeni aralık başlatır. `change` iki alanı birlikte yazar.",
+            endValue: "Aralığın bitişi; yalnız `mode: 'range'` iken okunur ve panelde görünür.",
+            minDate: 'Sınırdan önceki günler soluk ve basılamaz, sınırın kendisi seçilebilir; `maxDate` simetrik.',
+            markedDates: "İşaretli günler: `[{ date: 'yyyy-MM-dd' }]` (düz tarih metni dizisi de okunur) — günün altında nokta; seçili günde nokta zıt renktedir."
+        }
+    },
+    otpinput: {
+        summary: 'Tek kullanımlık kod kutuları; kurallar web ile AYNI modülden (`otp-logic`): temizleme, tamamlanma, ayraç, yeniden gönder sayacı.',
+        differences: [
+            'Web her kutuyu ayrı alan yapar; mobilde yazıyı kutuların üstündeki TEK görünmez alan alır (`<elementId>__input`): yapıştırma, SMS`ten otomatik doldurma (`oneTimeCode`) ve silme klavyenin kendi davranışıdır, kutular yalnız gösterir. Alan uzunluk sınırı taşımaz — ayraçlı yapıştırma (`123-456`) temizlenip kutu sayısına kesilir, rakam kaybolmaz — ve imleç hep sondadır. `page_screenshot` `set` o alana yazar.',
+            '`change` ve `complete` web gibi yalnız GERÇEK değişimde yayılır (`complete` kodu dolduran değişimle birlikte); kabul edilmeyen karakter ve fazlası düşer.',
+            'Kilitler web ile aynı: pasif, salt okunur, görünüm ve yükleniyor kipleri yazmayı kapatır; görünüm kipinde kutular düz metne iner ve yeniden gönder çizilmez. Sayaç bağlanınca başlar, `<elementId>__resend` basınca `resend` yayar ve yeniden başlar; tasarım kipinde sayaç koşmaz.',
+            '`style` düşer (ham CSS); kutu ölçüsü form yüksekliği, punto form puntosunun 1,2 katı, boşluk puntoya oranlı (web `--otp-gap`).'
+        ]
+    },
+    qrcode: {
+        summary: 'QR kodu: `data` kodlanır, `quietZone` sessiz bölgedir (modül birimi, varsayılan 1).',
+        differences: [
+            'Matris `toqr` ile üretilir ve düz görünümlerle çizilir (`react-native-svg` yok); hata düzeltme `M` sabittir ve web\'in `errorCorrectionLevel` prop\'u mobil şemadan düşer; renk web gibi siyah üstüne beyaz — koyu temada da (okuyucular ters kodu her zaman okumaz).',
+            'Kare kutunun kenarı: genişliği belli düğümde (`widthType: fill` ya da `fixed`) düğümün genişliği, içerik genişliğinde (`auto` ya da `widthType` hiç yazılmamış) 200 dp; genişlik ölçülemezse de (kanvasta satır kabındaki `fill`) 200 dp — cihaz o düğümü tam genişlik çizer. Sabit px boy kenarı sınırlar. Modül ölçüsü tam sayıya iner, artan birkaç piksel ortalanır. Belirli boy için `appearance.widthType: fixed` + `widthString`.',
+            'Veri boşsa ya da QR`a sığmıyorsa (yaklaşık 2,3 KB üstü) yer tutucu çizilir. `quietZone` web ile aynı `common` grubundadır (eski adı `padding` ortak çizim katmanının CSS boşluğuyla çakışıyordu, CQ-272).'
+        ],
+        propNotes: {
+            quietZone: 'Sessiz bölge, MODÜL birimiyle (piksel değil); varsayılan 1, panel aralığı web şemasıyla aynı 1–10 (çizer 16\'ya kadar kabul eder). Okuyucular için 2–4 önerilir.'
+        }
+    },
+    stack: {
+        summary: 'Çocuklarını üst üste bindiren kap (FlutterFlow Stack). Web`de karşılığı YOKTUR.',
+        differences: [
+            'İLK çocuk taban katmandır: akışta durur ve yığının boyunu verir. Sonraki her çocuk onun ÜSTÜNE biner; dizi sırası çizim sırasıdır (sonraki üstte).',
+            'Üst katmanlar yığının `alignment`ıyla (9 nokta) hizalanır; kaydırmayı çocuğun kendi kenar boşluğu verir (ör. `bottom-right` + sağ/alt margin 8). Hizalama ÇOCUKTA değil yığındadır — `appearance.stackAlign` diye bir alan YOKTUR.',
+            'Farklı köşelerde katman için çocuk kap iki eksende `fill` olur (yığını kaplar) ve içeriğini kendi `horizontalAlign`/`verticalAlign`ı ile yerleştirir.',
+            'Katmanın boş alanı dokunuşu alttaki katmana geçirir. Çocuklar `blocks` taşımaz (MOB-001 aynen geçerli).'
+        ],
+        propNotes: {
+            alignment: "Üst katmanların yeri: `top-left` (varsayılan) · `top-center` · `top-right` · `center-left` · `center` · `center-right` · `bottom-left` · `bottom-center` · `bottom-right`. Yığının boyu kutudan geliyorsa (`fixed`, `fill`, oran) taban da bu noktaya hizalanır."
+        }
+    },
+    'list-item': {
+        summary: 'Liste satırı (FlutterFlow ListTile): baş ikon ya da görsel · başlık · alt başlık · son metin ve ikon; basılabilir. Web`de karşılığı YOKTUR.',
+        differences: [
+            'Satıra dokunuş `click` yayar (yük yok). Pasifken soluk ve basılamaz; tasarım kipinde basış kanvasın seçim jestidir.',
+            'Baş tarafta `leadingImage` `leadingIcon`dan önce gelir (40 dp yuvarlak görsel; yüklenmezse başlığın baş harfleri). Boş ikon çizilmez.',
+            'Ölçüler Material liste satırı: tek satır 56, alt başlıklı 72; `dense` 48 / 60. Renkler token sınıflarından (başlık `--foreground`, alt başlık ve son taraf `--muted-foreground`, basılıyken `--accent`).',
+            'Son tarafta anahtar YOKTUR: anahtarlı satır `container` (satır) + `text` + `switch` ile kurulur. Tekrarlayıcı içinde satır olarak kullanılır — `repeater` satırının akışı tıklanan satırı `<tekrarlayıcı>.selectedItem` ile okur.'
+        ]
+    },
+    carousel: {
+        summary: 'Parmakla kaydırılan sayfalar (FlutterFlow Carousel ve PageView): çocuk sayfalar ya da web gibi `items` görselleri.',
+        differences: [
+            'Prop adları ve olaylar web kaydırıcısınınki: `activeIndex` etkin sayfadır, kaydırma/oklar/noktalar/otomatik oynatma yalnız `slideChange { activeIndex }` yayar ve şerit prop değişince kayar (web gibi denetimli).',
+            'Mobilde bırakılabilir: çocuğu varsa her ÇOCUK bir sayfadır ve `items` okunmaz (`tabs` gövde modeli); çocuksuz kaydırıcı `items` görsellerini çizer. Kanvasta yalnız `activeIndex` sayfası çizilir — sayfa seçici paneldeki bu alandır.',
+            'Görsel sayfaya dokunuş web gibi yalnız bağlantısı ya da akışı olan sayfada `slideClick { currentItem, index }` yayar; dış adres (http(s), mailto, tel, alan adı) sistem tarayıcısında açılır, uygulama içi yol (`/sayfa`) açılmaz — gezinmeyi `slideClick` akışı yapar.',
+            'Düşenler: `style`, `pauseOnHover` (sürükleme oynatmayı zaten durdurur), `transition` (sayfalar kayar). Ek: `peek`. Oklar `<elementId>__prev`/`__next`, noktalar `<elementId>__dot-<n>` iç rolleri — `page_screenshot` `click` onlarla basar.',
+            'Boy kutudan gelmiyorsa görsel sayfa 16:9, çocuk sayfalar en uzununun boyunda. Genişlik belli değilse (Studio`dan bırakılan düğümün `widthType`ı yok) cihaz genişliği kullanılır; kaydırıcıya `widthType: fill` verin.'
+        ],
+        propNotes: {
+            peek: 'Komşu sayfaların kenardan görünen payı (dp); en çok genişliğin dörtte biri, sayfalar araya küçük boşluk alır. 0 (varsayılan) tam genişlik sayfa.'
+        }
+    },
+    fab: {
+        summary: 'Yüzen eylem düğmesi (FlutterFlow FloatingActionButton): ekranın alt köşesinde durur, sayfa kaydırılırken yerinde kalır. Web`de karşılığı YOKTUR.',
+        differences: [
+            'Sayfanın NERESİNE konursa konsun runtime`da barındırıcının ekran katmanına taşınır: kenardan 16 dp, sekme çubuğu varsa onun üstünde, yoksa ev göstergesinin üstünde. Düğümün kendi yeri akışta boş kalır — sayfa kök kabının sonuna koyun.',
+            'Dokunuş `click` yayar. `page_screenshot` düğmeyi `<elementId>__press` ile bulur (düğüm kabuğu runtime`da boştur).',
+            'Renk `kind`den, `button` ile aynı eşleme (dolu varyant); 56 dp yuvarlak. `extended` açık ve `label` doluysa etiket ikonun yanında yazılır, yoksa etiket yalnız erişilebilirlik adıdır.',
+            'Kanvasta yerinde, kesikli bir halka içinde çizilir ve basılamaz.'
+        ],
+        propNotes: {
+            position: '`bottom-right` (varsayılan) · `bottom-center` · `bottom-left`.',
+            icon: 'Material Symbols adı; boşsa `add`.'
+        }
+    },
+    timer: {
+        summary: 'Geri sayım ya da kronometre (FlutterFlow Timer). Web`de karşılığı YOKTUR.',
+        differences: [
+            'Akış bileşenin yöntemini çağıramaz, yalnız prop yazar: başlat/duraklat `isRunning` (setter), sıfırlama `value` yazmaktır (geri sayımda ör. `duration`, kronometrede 0).',
+            'Çalışırken her saniye `tick { value }` yayar ve makine `value`yu yazar; geri sayım 0`a inince `finish { isRunning: false }` yayar. Sayaç duvar saatinden hesaplanır, aralık gecikse de kaymaz.',
+            'Gösterim `format`la (`mm:ss` saati dakikaya katar, `HH:mm:ss`, `ss`); punto `text` bileşeninin `h2` ölçeğinden, `typographyStyle` üstüne biner. Tasarım kipinde durur.'
+        ],
+        propNotes: {
+            value: 'Gösterilen saniye; boşsa geri sayımda `duration`, kronometrede 0. Sayaç her tikte yazar — akışın yazdığı başka bir değer sayacı o değerden yeniden kurar.',
+            duration: 'Geri sayımın başlangıcı (saniye, varsayılan 60); yalnız `mode: countdown`da panelde görünür.'
+        }
+    },
+    rating: {
+        summary: 'Yıldızla puanlama; kurallar web ile AYNI modülden (`rating-logic`): yarım yıldız, aynı puana dokununca temizleme, puan metni.',
+        differences: [
+            'Yıldıza dokunuş `change { value }` yayar; `allowHalf` açıkken yıldızın SOL yarısı ayrı dokunma alanıdır ve yarım puan verir. İç roller: `<elementId>__star-<n>` (1`den; tam puan — yarım açıkken yıldızın sağ yarısı) ve `<elementId>__star-<n>-half` (sol yarı) — `page_screenshot` `click` onlarla basar.',
+            'Ekran okuyucuda yıldız şeridi TEK ayarlanabilir öğedir: değeri okunur, yukarı/aşağı kaydırma web`in ok tuşu adımıyla arttırır/azaltır (yarım açıkken 0,5). Pasif (`isDisabled`) soluk çizilir.',
+            'Cihazın ikon yazı tipi dolgusuzdur: varsayılan yıldız Unicode ★ ile iki hâlde de dolu çizilir, hâl RENKLE ayrışır (`inactiveColor` `default` kenar rengi, öteki tonlar soluk). Seçilen `icon` glif olarak kalır ve dolu/boş yalnız renkle ayrışır.',
+            '`focus`/`blur` şemada kalır ama mobilde yayılmaz (yıldız şeridinin klavye odağı yok). Düşenler: `style`, `autofocus`.'
+        ]
+    },
+    'multi-select': {
+        summary: 'Çoklu seçim: alanda kaldırılabilir çipler, dokununca alttan açılan onay kutulu liste; değer ve olaylar web ile aynı.',
+        differences: [
+            'Değer `{ label, value }` DİZİSİDİR (düz değer ve `{ id, text }` de okunur); her dokunuş `change { value }` yayar, yük `id`/`text` ikizlerini taşır — web `multi-select.functions.ts`in kuralları mobilde ikizlendi.',
+            'Liste alttan açılır (`dropdown` emsali): gruplu listede (`optionType: grouped`) çocuklu satır `isSelectable` değilse başlıktır, gruplar hep açıktır (`isExpanded` okunmaz). Arama kutusu `search` olayına akış bağlıysa `search { searchText }` yayar ve listeyi akış yazar, değilse yerelde süzer. Liste açılınca `focus`, kapanınca (`Done` ya da perde) `blur`; arama doluyken kapanırsa ve `search` akışa bağlıysa web gibi `search { searchText: "" }` de yayılır (yeniden açılan liste eski sonuçla kalmasın).',
+            'Üst sınır web gibi formun `maxItems` doğrulamasıdır, seçim kesilmez. Alanda en çok üç çip, gerisi "+n". İç roller `__trigger`, `__clear`, `__done`; satırlar `role="option"` + `data-value`.'
+        ]
+    },
+    toast: {
+        summary: 'Geçici bildirim tetikleyicisi; tetikleme sözleşmesi web ile aynı (akış `isOpen`ı açar, bileşen bildirimi gösterip `isOpen`ı kapatır).',
+        differences: [
+            'Bildirim uygulamanın toast deposuna eklenir ve SAYFADAN BAĞIMSIZ yaşar: "Kaydedildi" gösterip `redirect` yapan akışta hedef sayfada görünmeye devam eder. Düğümün kendisi runtime`da hiçbir şey çizmez; kanvasta örnek balon yerinde çizilir.',
+            'Web`in dokuz `position`ı telefonda üçe iner: `top-*`/`top-full` üst, `center` orta, öteki hepsi (varsayılan `bottom-right`) alt; bildirim ekran genişliğindedir. Alttaki bildirim sekme çubuğunun üstünde durur.',
+            'Açık `modal`, çekmece ya da `dropdown`/`multi-select` listesi varken bildirim onun ÜSTÜNDE çizilir (modaldaki formun tipli uyarısı, çoklu seçimin her dokunuşunda koşan akışın uyarısı görünür); saydam `tooltip` balonunun altında sayfadaki yerinde kalır. Klavye açıkken alttaki bildirim klavyenin üstüne çıkar.',
+            '`dedupeKey` YAZILMIŞSA aynı anahtarlı bildirim görünürken ya da `delay`i dolmamışken yenisi yığılmaz; yazılmamışsa web gibi yığılır. Bir konumda en çok üç bildirim, fazlası en eskisini kapatır. Süre web`in tür varsayılanı (bilgi/başarı 4 sn, uyarı 6, hata 8, yükleniyor kalıcı).',
+            'Olaylar web`inki: `open`, `close`, `click` (gövde), `actionClick { text, index }` (eylemin kendi akışıyla). Düşenler: `style`, `pauseOnHover`, `showCopyButton` (pano native modül ister), `allowHtml` (metin olduğu gibi), `priority`.',
+            'Akışın `alert` adımındaki tipli uyarılar (success/info/warning/error) cihazda da aynı depo üzerinden toast olur ve beklemez; düz uyarı onay bekleyen diyalogdur.'
+        ]
+    },
+    video: {
+        summary: 'Video oynatıcı; prop ve olaylar web ikizininki (`src`, `poster`, `autoplay`, `loop`, `muted`, `controls`; `play`/`pause`/`ended`/`click`).',
+        differences: [
+            'Cihazda `expo-video` (denetimler platformun kendi oynatıcısı), Studio kanvası ve önizlemede HTML5 `<video>`. Kanvasta oynatılmaz ve dokunuş almaz — dokunuş seçim jestidir, denetimler yalnız görünür.',
+            'Kutu: boyu kabuktan gelen video (`heightType: fixed` + ölçülebilir `heightString`, ya da `fill`) kabuğu doldurur; genişliği belli video (`widthType: fill`, ya da `fixed` + `widthString`) boyunu orandan alır — panelin `appearance.aspectRatio`su, yoksa 16:9; genişliği belli değilse boy 200 dp. Studio`dan bırakılan video `heightType: fixed` alır ama ölçüsü yoktur: 16:9 için `widthType: fill` verin. Video kutuyu `cover` ile doldurur (web ikizi gibi).',
+            '`autoplay` yalnız oynatıcı kurulurken (sayfa açılışı, kaynak değişimi) uygulanır; tarayıcı sesli otomatik oynatmayı engelleyebilir (`muted` açın). `ended` `loop` açıkken yayılmaz. `click` yalnız `controls: false` iken yayılır — denetimler açıkken dokunuş oynatıcınındır.',
+            'Cihazda afiş yerel bir özellik değildir: `poster` ilk oynatmaya dek videonun üstünde çizilir ve denetimler açıkken ortasındaki oynat düğmesi oynatmayı başlatır. Düşen: `style`.',
+            'Cihazda sayfa odağı kaybedince (yığında arkaya düşünce, başka sekmeye geçince) video durur ve `pause` yayar; dönüşte kendiliğinden sürmez. Döngü sınırındaki ve ara belleğe almadaki kısa duruşlar `pause`/`play` yaymaz (web `<video loop>` gibi).'
+        ]
+    },
+    audio: {
+        summary: 'Ses oynatıcı (FlutterFlow AudioPlayer): oynat/duraklat düğmesi, başlık, ilerleme izi ve süre. Web`de karşılığı YOKTUR.',
+        differences: [
+            'Cihazda `expo-audio`, kanvas ve önizlemede HTML5 `<audio>`; denetim iki yerde aynı çizimdir. Cihazda iOS`un sessiz anahtarına uymaz (müzik uygulamalarının davranışı).',
+            'Akış yöntem çağıramaz, prop yazar: çalma `isPlaying`dir — açılışta `true` otomatik oynatmadır, akış `true`/`false` yazarak başlatır ve durdurur, bitmiş ses baştan çalar. Kullanıcı denetimle başlatıp durdurunca `play`/`pause` `{ isPlaying }` yayar ve makine prop`u yazar; ses bitince önce `pause`, ardından `ended { isPlaying: false }` (`loop` açıkken `ended` yok). Tarayıcı sesli otomatik oynatmayı reddederse `pause { isPlaying: false }` yayılır.',
+            'İzde dokunulan yere atlanır. İç roller `<elementId>__toggle` (oynat/duraklat) ve `<elementId>__track` (iz) — `page_screenshot` `click` onlarla basar.',
+            '`showControls: false` bileşeni görünmez yapar ama ses çalar (arka plan sesi, akışla çalınan efekt); kanvasta kesikli yer tutucu çizilir. Tasarım kipinde çalmaz.',
+            'Ara belleğe alma (yavaş ağ, izde tamponlanmamış noktaya atlama) duruş sayılmaz, `pause` yaymaz. `ended` akışı aynı turda yeniden `isPlaying: true` yazarsa ses baştan çalar (akışla tekrar). Cihazda sayfa odağı kaybedince (yığında arkaya düşünce) ses durur ve `pause { isPlaying: false }` yayar; dönüşte kendiliğinden sürmez. Kaynak değişince yeni kaynak baştan yüklenir, `isPlaying` açıksa çalar.'
+        ],
+        propNotes: {
+            src: 'Ses dosyasının adresi ya da platform dosyası (mp3, m4a, aac, wav). Canlı yayın adresinin süresi bilinmez: iz ilerlemez, süre 0:00 yazar.',
+            isPlaying: 'Çalıyor mu: akışın yazdığı `true` çalar, `false` durdurur. Kullanıcının denetimi ve bitiş bu prop`u geri yazar.',
+            title: 'Denetimin üstündeki başlık (tek satır); boşsa çizilmez.'
+        }
+    },
+    lottie: {
+        summary: 'Lottie animasyonu (FlutterFlow Lottie Animation): Lottie JSON ya da dotLottie (`.lottie`). Web`de karşılığı YOKTUR.',
+        differences: [
+            'Cihazda `lottie-react-native`, kanvas ve önizlemede `@lottiefiles/dotlottie-react`: çizici ve WASM`ı ayrı parçadır, yalnız `lottie` düğümü olan sayfada yüklenir ve WASM paketin kendisinden sunulur (CDN`e gidilmez). Kanvasta da oynar.',
+            'Akış prop yazar: `isPlaying: false` yerinde durdurur, `true` kaldığı yerden sürdürür. Döngüsüz (`loop: false`) animasyon bitince `finish { isPlaying: false }` yayar; akış yeniden `true` yazınca baştan oynar — `finish` akışının kendisi aynı turda `true` yazsa da (akışla tekrar). Tasarım kipinde açık kalan `isPlaying` bitişi tekrar ettirmez.',
+            'Kutu `video` ile aynı kuraldan, varsayılan oran olmadan: kabuktan gelen boy ya da (genişlik belliyken) panelin `aspectRatio`su, yoksa 150 dp; animasyon kutuya `contain` ile sığar. Dokunuş almaz, `click` olayı yoktur.'
+        ],
+        propNotes: {
+            src: "Animasyonun adresi (`.json` Lottie, `.lottie` dotLottie — cihazda adreste `.lottie` GEÇMELİ, uzantısız dosya JSON sanılır), platform dosyası ya da JSON'un kendisi METİN olarak (yapıştırılan ya da ifadenin ürettiği metin, ör. `{{ JSON.stringify(...) }}`). NESNE olarak bağlanan animasyon kaynak DEĞİLDİR (runtime prop eşleyicisi iç içe düz nesneyi bozuyor) — yer tutucu çizilir. Katman dizisi (`layers`) taşımayan JSON da kaynak sayılmaz.",
+            speed: 'Oynatma hızı çarpanı (1 = normal); 0,1–10 aralığına kırpılır, geçersiz değer 1.'
+        }
+    },
+    signature: {
+        summary: 'İmza pedi; prop ve olaylar web ikizininki (`value` PNG data URL ya da ham SVG, `penColor`, `penWidth`, `outputFormat`, `clearText`; `change { value }`, `clear`).',
+        differences: [
+            'Cihazda mürekkep `react-native-svg`, jest `PanResponder`; kanvas ve önizlemede DOM `<svg>`. Her tamamlanan vuruşta değer web gibi `change { value }` ile yazılır: `self.value` de `event.data.value` da dolu gelir. PNG cihazda görünmez bir `Svg`nin anlık görüntüsüdür (ekran ölçeğinde), web`de `<canvas>`ın; ikisi aynı SVG belgesinin çizimidir ve kalem rengi boşsa ekranda tema metin rengi, değerde somut `#111111` olur.',
+            'Vuruş sürerken sayfanın ve `scroll-view`un kaydırması kilitlidir: dikey vuruş sayfayı sürüklemez (web`de pedin `touch-action: none`ı); parmak kalkınca sayfa normal kayar.',
+            'Temizle düğmesi (`<elementId>__clear`, `clearText`, boşsa "Clear") çizim ya da değer varken ve alan kilitsizken görünür; basınca önce `change { value: \'\' }`, sonra `clear`. Ped `<elementId>__pad`. Tasarım kipinde çizilmez, Temizle basılmaz.',
+            'Boyu kabuktan gelen düğümde (`heightType: fixed` ya da `fill`) ped kabuğu doldurur; yoksa taban yükseklik boya göre 72/96/128 dp. Kayıtlı `value` PNG ise görsel, SVG (ham işaretleme ya da `data:image/svg+xml`) ise vektör olarak çizilir; tanınmayan metin çizilmez. Düşen: `style`.',
+            'iOS`ta sistem jesti imzadan önce gelir: iOS 26`da yığına itilmiş sayfada pede SAĞA atılan vuruş sayfayı kapatır (ARC-116, ölçüldü), `modal` sunumlu sayfada aşağı vuruş sayfayı kapatabilir (ölçülmedi). İmzayı sekme kökündeki ya da itilmemiş sayfaya koyun.'
+        ]
+    },
+    webview: {
+        summary: 'Uygulama içinde web sayfası (`src`) ya da satır içi HTML (`html`) — FlutterFlow WebView. Web`in `iframe`inin mobil karşılığıdır; web`de bu slug YOKTUR.',
+        differences: [
+            'Cihazda `react-native-webview`; kanvas ve önizlemede web `iframe`inin korumalı alanıyla `<iframe>` (betik, form, açılır pencere; `allow-same-origin` yok — çerez ya da depolama isteyen site önizlemede eksik çalışabilir, cihazda tam). Kanvasta dokunuş almaz. Android`de görünüm kendi içeriğini sayfanın kaydırma kabı içinde de kaydırır.',
+            'Gezinme varsayılan KAPALI (güvenlik kararı): ilk yükleme ve yönlendirmeleri (ilk `load`a kadar), alt çerçeveler ve aynı belgedeki çapalar serbesttir; yüklemeden sonra başka belgeye giden gezinme `navigate { url }` yayar ve ENGELLENİR. Adres sistemde (http(s) tarayıcıda, `mailto:`/`tel:`/`sms:` ilgili uygulamada) YALNIZ kullanıcının dokunduğu bağlantıda açılır — betiğin gezinmesi (`location`, zamanlayıcı, programla tıklama) ve form gönderimi yalnız olay yayar, uygulama şemaları (ör. `whatsapp://`) hiç açılmaz. `allowNavigation: true` gezinmeyi görünümün içinde yapar, `navigate` yine yayılır. Yeni pencere (`target="_blank"`, `window.open`) görünümde açılmaz: `navigate` yayılır, kullanıcının dokunduğu bağlantıysa (izin açıkken de) sistemde açılır.',
+            'Kuralın bilinen boşlukları: ilk `load`dan ÖNCE her gezinme serbesttir (betik ya da hızlı dokunuş dahil); aynı adrese yapılan form gönderimi aynı belge sayılır; Android POST isteğini kurala hiç getirmez ve karar 250 ms içinde verilemezse yüklemeye izin verir (olay yine yayılır). Web`de köprü yalnız `html` içeriğinde ve yalnız gerçek bağlantı dokunuşunu görür: betiğin gezinmesi, form gönderimi ve açılır pencere çerçevenin içinde ya da yeni sekmede kalır; başka kökenli `src` sayfasında köprü hiç yoktur.',
+            'Sayfadan akışa: `window.ReactNativeWebView.postMessage(metin)` → `message { data }` (metin olduğu gibi; JSON`u akış ayrıştırır). Web`de köprü `html` içeriğinde çalışır, başka kökenli `src` sayfasında YOKTUR.',
+            'Kutu `lottie` kuralından: kabuktan gelen boy ya da (genişlik belliyken) panelin `aspectRatio`su, yoksa 300 dp. `load` her tamamlanan yüklemede (izin verilen gezinmeden sonra da) yayılır. Cihazda yüklenemeyen sayfa (ağ hatası) `error` yayar ve yer tutucu çizer; web`de tarayıcı engellenen ya da bulunamayan çerçevede de `load` atar, `error` pratikte gelmez (web `iframe` gibi).'
+        ],
+        propNotes: {
+            src: 'Mutlak adres (`https://…`); `javascript:`, `data:`, `vbscript:`, `file:` şemaları boşa düşer (web `iframe` süzgeci). Göreli adres cihazda yüklenmez. `html` doluysa yok sayılır.',
+            html: 'Satır içi HTML belgesi; doluysa `src`nin önüne geçer. Cihazda `about:blank` kökeninde, web`de kökensiz korumalı `srcdoc` olarak çizilir; sayfa içi çapa (`#bolum`) yerinde kaydırır.',
+            allowNavigation: 'Açıkken bağlantılar görünümün İÇİNDE açılır; kapalıyken (varsayılan) gezinme engellenir ve kullanıcının dokunduğu bağlantı sistemde açılır. İki durumda da `navigate { url }` yayılır.',
+            injectedJs: 'Belge yüklenince koşan JavaScript (ör. `window.ReactNativeWebView.postMessage(document.title)`); cihazda iki içerikte, web`de yalnız `html`de. Gömülen sayfada tam yetkiyle koşar — yalnız güvenilen içerikte kullanın.',
+            title: 'Erişilebilirlik etiketi (ekran okuyucu; web`de `<iframe title>`).'
+        }
     }
 };

package/dist/knowledge/mobileComponentEvents.js

@@ -19,6 +19,54 @@ export const mobileComponentEventContracts = {
     tooltip: {
         open: NO_DATA
     },
+    calendar: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string 'yyyy-MM-ddT00:00:00' | null — seçilen gün (aralıkta başlangıç); web datepicker'ın biçimi: yerel duvar saati, gece yarısı, dilim eki yok",
+                endValue: "string 'yyyy-MM-ddT00:00:00' | null — YALNIZ mode: 'range'; ilk basışta null, ikinci basışta bitiş günü"
+            }
+        }
+    },
+    stack: {
+        mount: NO_DATA
+    },
+    'list-item': {
+        click: NO_DATA
+    },
+    fab: {
+        click: NO_DATA
+    },
+    timer: {
+        mount: NO_DATA,
+        tick: { payload: { value: 'number — gösterilen saniye (geri sayımda kalan, kronometrede geçen); makine value prop\'una yazar' } },
+        finish: { payload: { isRunning: 'false — geri sayım 0\'a indi; makine isRunning\'i kapatır' } }
+    },
+    audio: {
+        mount: NO_DATA,
+        play: { payload: { isPlaying: "true — çalma başladı (denetim ya da akış); makine isPlaying'i yazar" } },
+        pause: { payload: { isPlaying: "false — çalma durdu (denetim, akış, bitiş ya da tarayıcının otomatik oynatma reddi); makine isPlaying'i yazar" } },
+        ended: { payload: { isPlaying: "false — ses sona vardı (loop kapalıyken, pause'tan sonra); makine isPlaying'i kapatır" } }
+    },
+    lottie: {
+        mount: NO_DATA,
+        finish: { payload: { isPlaying: "false — döngüsüz animasyon bitti; makine isPlaying'i kapatır, yeniden true yazmak baştan oynatır" } }
+    },
+    webview: {
+        mount: NO_DATA,
+        load: { payload: {}, reads: "her tamamlanan yüklemede yayılır (izin verilen gezinmeden sonra da); cihazda yüklenemeyen sayfada yayılmaz (yerine error), web'de tarayıcı engellenen çerçevede de yayar" },
+        navigate: { payload: { url: "string — sayfanın gitmek istediği adres; makine url prop'una yazar (self.url). allowNavigation kapalıyken (varsayılan) gezinme engellenir; adres yalnız kullanıcının dokunduğu bağlantıda sistemde açılır" } },
+        message: { payload: { data: "string — sayfanın window.ReactNativeWebView.postMessage(metin) ile yolladığı metin, olduğu gibi; makine data prop'una yazar (self.data)" } },
+        error: { payload: {}, reads: "cihazda sayfa yüklenemeyince (ağ hatası) yayılır, görünüm yer tutucu çizer; web'de pratikte gelmez (iframe gibi)" }
+    },
+    markdown: {
+        mount: NO_DATA,
+        linkClick: {
+            payload: {
+                href: "string — dokunulan bağlantının ham adresi; şema süzülmeden gelir (dışarıda yalnız http(s), mailto, tel açılır)"
+            }
+        }
+    },
     'app-bar': {
         clickBack: NO_DATA,
         clickMenu: NO_DATA,

package/dist/knowledge/normalize.js

@@ -2082,32 +2082,76 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
         if (op.op !== 'set_event' && op.op !== 'remove_event')
             continue;
         const eventName = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : undefined;
+        const boundTo = (events) => asObjects(events)
+            .filter(event => String(event.name ?? '') === eventName && typeof event.value === 'string' && event.value !== '');
+        // Bir olaya birden fazla akış bağlı olabilir. Değersiz `remove_event` o durumda platformda
+        // `ambiguous-event` ile düşer ve hiçbir bağ kalkmaz; değerli olan yalnız o akışı çözer.
+        const removedBy = (named) => eventValue === undefined
+            ? (named.length === 1 ? named : [])
+            : named.filter(event => event.value === eventValue);
         // `remove_event target:'page'` düğümü değil barındırıcının düzey olaylarını hedefler
         // (`PageSchemaMicroOpApplier.PageTarget`); düğüm aramasına düşseydi plan boş kalır ve yalnız
         // oraya bağlı akış kapıdan geçip kalıcı silinirdi. Düzey olayı olmayan widget'ta applier da
         // düğüm aramasına düşer.
         if (op.op === 'remove_event' && target === 'page' && Array.isArray(pageEvents)) {
             const hostEvents = asObjects(pageEvents);
-            const removed = hostEvents.find(event => String(event.name ?? '') === eventName);
-            if (typeof removed?.value !== 'string' || removed.value === '')
-                continue;
-            const surviving = new Set(hostEvents.filter(event => event !== removed && typeof event.value === 'string').map(event => String(event.value)));
+            const removed = removedBy(boundTo(hostEvents));
+            const surviving = new Set(hostEvents.filter(event => !removed.includes(event) && typeof event.value === 'string').map(event => String(event.value)));
             collectFlowRefsExcept(nodes, '', surviving);
-            if (!surviving.has(removed.value))
-                plan.push({ target, op: 'remove_event', flowIds: [removed.value] });
+            const flowIds = [...new Set(removed.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
+            if (flowIds.length > 0)
+                plan.push({ target, op: 'remove_event', flowIds });
             continue;
         }
         const node = findNodeByElementId(nodes, target);
-        const current = asObjects(node?.events).find(event => String(event.name ?? '') === eventName);
-        const currentValue = typeof current?.value === 'string' ? current.value : '';
-        if (currentValue === '' || currentValue === String(op.eventValue ?? ''))
+        const named = boundTo(node?.events);
+        // `set_event` adın BÜTÜN bağlarını tek kayda indirir; yeni değerden farklı her akış bağını kaybeder.
+        const losing = op.op === 'set_event' ? named.filter(event => event.value !== eventValue) : removedBy(named);
+        if (losing.length === 0)
             continue;
         const surviving = survivingRefs(target, eventName);
-        if (!surviving.has(currentValue))
-            plan.push({ target, op: String(op.op), flowIds: [currentValue] });
+        for (const event of named) {
+            if (!losing.includes(event))
+                surviving.add(String(event.value));
+        }
+        const flowIds = [...new Set(losing.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
+        if (flowIds.length > 0)
+            plan.push({ target, op: String(op.op), flowIds });
     }
     return plan;
 }
+/**
+ * PAGE-034 — dolu bir olaya farklı akışla `set_event` gelmesi. `set_event` adın bütün bağlarını
+ * TEK kayda indirir, yani önceki akış bağını sessizce kaybeder; akış başka yerden de
+ * referanslıysa `orphanedFlowPlan` da susar ve kayıp hiç görünmez (maddelerim 4: makale önerisi
+ * akışı, akıllı öneri bağlanınca çalışmaz oldu). Olaya ikinci akış eklemek `add_event`'tir; bilerek
+ * değiştirmek için op'a `replaceBoundFlows: true` verilir. Okunan ağaçta olmayan hedef denetlenmez.
+ */
+export function boundEventOps(schema, ops) {
+    const nodes = asObjects(schema);
+    return asObjects(ops)
+        .filter(op => op.op === 'set_event' && op.replaceBoundFlows !== true)
+        .flatMap(op => {
+        const target = String(op.target ?? '');
+        const event = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : '';
+        const bound = asObjects(findNodeByElementId(nodes, target)?.events)
+            .filter(entry => String(entry.name ?? '') === event && typeof entry.value === 'string' && entry.value !== '')
+            .map(entry => String(entry.value));
+        const replaced = [...new Set(bound)].filter(flowId => flowId !== eventValue);
+        if (replaced.length === 0)
+            return [];
+        return [`PAGE-034: '${target}' komponentinin '${event}' olayına zaten bağlı akış var (${replaced.join(', ')}). set_event olayın BÜTÜN bağlarını tek akışa indirir ve bu akışlar olay tetiklenince artık çalışmaz. `
+                + `Olaya bir akış daha eklemek için { op: 'add_event', target: '${target}', event: '${event}', eventValue: '${eventValue}' } kullanın — bağlı akışların hepsi paralel koşar. `
+                + `Mevcut bağı bilerek değiştirmek istiyorsanız aynı op'a replaceBoundFlows: true ekleyin.`];
+    });
+}
+/** Gateway'e ait op alanları platforma gitmez. */
+export function stripGatewayEventFields(ops) {
+    for (const op of ops)
+        delete op.replaceBoundFlows;
+}
 export function orphanedFlowMessage(plan) {
     const lines = plan.map(entry => `'${entry.target}' (${entry.op}) → ${entry.flowIds.join(', ')}`);
     return `İstek gönderilmedi: bu yama ${plan.reduce((total, entry) => total + entry.flowIds.length, 0)} akışı sayfada referanssız bırakıyor ve platform referanssız akışı KALICI siler — ${lines.join(' · ')}. `

package/dist/knowledge/platform/mobileRules.js

@@ -58,16 +58,18 @@ export const REDIRECT_PRESENTATIONS = new Set(['push', 'modal', 'replace']);
  * Mobil pakete giren bileşen Dalga 2/3 listesinden DÜŞER: yayında olduğunu mobil sözlükteki kaydı
  * söyler (`mobileComponentKnowledge`, parite testiyle `components.json`'a kilitli). Katalog A
  * (2026-09-24) sekiz web ikizini buradan indirdi: `radio`, `checkboxgroup`, `slider`, `tabs`, `badge`,
- * `avatar`, `progress`, `collapsible-container`. Dalga 1 listesi artık yalnız `mobileNotes`'un bilgi
- * satırıdır — MOB-003'te yayındaki bileşeni sözlük tanır (`box-section` Dalga 1'de ama pakette yok).
+ * `avatar`, `progress`, `collapsible-container`; Katalog C (09) Dalga 3'ten `video` ve `signature`ı; dil dalgası
+ * (plans/mobil-coklu-dil F1, 2026-09-25) Dalga 2'den `language-selector`ı. Dalga 1
+ * listesi artık yalnız `mobileNotes`'un bilgi satırıdır — MOB-003'te yayındaki bileşeni sözlük tanır
+ * (`box-section` Dalga 1'de ama pakette yok).
  */
 export const MOBILE_COMPONENT_WAVES = Object.fromEntries([
     ...['container', 'box-section', 'form', 'slot', 'text', 'icon', 'image', 'divider', 'spacer', 'button', 'textinput', 'textarea', 'numberinput', 'password', 'checkbox', 'switch', 'dropdown', 'repeater', 'card', 'emptystate', 'form-validation-errors', 'modal', 'drawer', 'app-bar'].map(slug => [slug, 1]),
-    ...['box', 'datepicker', 'timepicker', 'otpinput', 'phoneinput', 'rating', 'statcard', 'toast', 'detailview', 'page-header', 'qrcode', 'language-selector', 'multi-select', 'autocomplete'].map(slug => [slug, 2]),
-    ...['datatable', 'chart', 'kanban', 'timeline', 'fileUpload', 'filebutton', 'fileInput', 'signature', 'carousel', 'video', 'texteditor', 'html', 'stepper', 'tree-view'].map(slug => [slug, 3])
+    ...['box', 'datepicker', 'timepicker', 'phoneinput', 'statcard', 'detailview', 'page-header', 'autocomplete'].map(slug => [slug, 2]),
+    ...['datatable', 'chart', 'kanban', 'timeline', 'fileUpload', 'filebutton', 'fileInput', 'texteditor', 'html', 'stepper', 'tree-view'].map(slug => [slug, 3])
 ]);
 export const MOBILE_WEB_ONLY = {
-    iframe: "dış içerik için button + redirect (targetBlank) ile tarayıcıda açın",
+    iframe: "'webview' (src ya da html; bağlantılar varsayılan olarak sistem tarayıcısında açılır)",
     sidebar: "'drawer' widget'ı + app-bar.menuTarget",
     navigations: 'Ayarlar › Sekmeler (application_update properties.mobile.tabs)',
     header: "'app-bar'",

package/dist/knowledge/rules.js

@@ -420,6 +420,8 @@ export function rawQueryParameterNames(rawQuery) {
 }
 const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 const functionsGuide = 'ngapps://guides/functions';
+/** FN-006: bu kadar dolu satırdan uzun gövde yorumsuz kalmaz; tek satırlık `return` yorum istemez. */
+const FUNCTION_COMMENT_MIN_LINES = 5;
 export const policyRules = [
     {
         id: 'MS-001',
@@ -2030,6 +2032,25 @@ export const policyRules = [
             return [];
         }
     },
+    {
+        id: 'FN-006',
+        module: 'function',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Kullanıcı isteği 2026-09-18: ajan fonksiyon yazarken gövdeye ne yaptığını söyleyen yorum koyar; Studio editörü yorumu yeşil italik çizer. Gövde kendi satırına sarılır (function-source.ts, GlobalFunction.cs AppendLine), '//' kapanış parantezini yutmaz",
+        check: definition => {
+            const name = String(definition.name ?? '?');
+            const body = typeof definition.body === 'string' ? definition.body : '';
+            const lineCount = body.split('\n').filter(line => line.trim() !== '').length;
+            if (lineCount < FUNCTION_COMMENT_MIN_LINES || /(^|\s)\/\/|\/\*/m.test(body))
+                return [];
+            return [{
+                    ruleId: 'FN-006',
+                    severity: 'warn',
+                    message: `'${name}' gövdesi ${lineCount} satır ama hiç yorum yok. Başa ne yaptığını, parametreleri ve dönüşü söyleyen kısa bir '//' yorumu, açık olmayan adımların üstüne de birer satır yorum ekleyin; kodu tekrar eden yorum yazmayın.`,
+                    guide: functionsGuide
+                }];
+        }
+    },
     {
         id: 'FLOW-024',
         module: 'flow',

package/dist/platform/diagnostics.js

@@ -0,0 +1,85 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { z } from 'zod';
+const activeMode = new AsyncLocalStorage();
+const MAX_NOTES = 8;
+const MAX_NOTE_CHARS = 240;
+const MAX_DROPS = 5;
+export const diagnosticsParam = z.enum(['compact', 'full']).optional().describe("Yanıttaki gatewayNormalized / silentlyDropped listelerinin boyu. compact (varsayılan): aynı not tekilleşir, uzun not kısalır (en fazla 8); aynı yolun düşmeleri tek satırda sayıyla toplanır (en fazla 5 grup); droppedCount her zaman tam sayıdır. full: listelerin tamamı.");
+export function runWithDiagnostics(mode, run) {
+    return activeMode.run(mode, run);
+}
+/**
+ * Tanılama listeleri her yazma çağrısında yanıta girer ve aynı gerekçe cümlesi çağrı başına tekrar
+ * eder. Kırpma yalnız GÖRÜNÜMÜ küçültür: `silentlyDropped` "kaydedildi mi" sorusunun tek kanıtı olduğu
+ * için liste hiçbir zaman sessizce boşalmaz — toplam sayı ve kalan satır sayısı yanıtta kalır, tam
+ * liste gateway günlüğünde (`sessiz düşme` / `düzeltme` adımları) durur.
+ *
+ * Kip bağlamı olmayan çağrı (okuma ve silme tool'ları, doğrudan `toolResult` kullanan testler) tam
+ * listeyi görür; kısaltma yalnız `diagnostics` parametresini taşıyan yazma tool'larında devreye girer.
+ */
+export function compactDiagnostics(payload) {
+    if (activeMode.getStore() !== 'compact')
+        return payload;
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+        return payload;
+    const record = payload;
+    const notes = Array.isArray(record.gatewayNormalized) ? record.gatewayNormalized.map(String) : undefined;
+    const drops = Array.isArray(record.silentlyDropped) ? record.silentlyDropped.map(String) : undefined;
+    if (notes === undefined && drops === undefined)
+        return payload;
+    const hidden = [];
+    const result = { ...record };
+    if (notes !== undefined) {
+        const counts = new Map();
+        for (const note of notes)
+            counts.set(note, (counts.get(note) ?? 0) + 1);
+        const unique = [...counts.entries()].map(([note, count]) => {
+            const shortened = note.length > MAX_NOTE_CHARS ? `${note.slice(0, MAX_NOTE_CHARS - 1)}…` : note;
+            return count > 1 ? `${shortened} (×${count})` : shortened;
+        });
+        const shortenedCount = notes.filter(note => note.length > MAX_NOTE_CHARS).length;
+        const kept = unique.slice(0, MAX_NOTES);
+        result.gatewayNormalized = unique.length > MAX_NOTES ? [...kept, `… ${unique.length - MAX_NOTES} not daha`] : kept;
+        if (unique.length > MAX_NOTES)
+            hidden.push(`${unique.length - MAX_NOTES} not`);
+        if (shortenedCount > 0)
+            hidden.push(`${shortenedCount} notun gerekçesi kısaltıldı`);
+    }
+    if (drops !== undefined) {
+        const droppedCount = typeof record.droppedCount === 'number' ? record.droppedCount : drops.length;
+        const grouped = groupDrops(drops, record.droppedCountCapped === true || droppedCount > drops.length);
+        const kept = grouped.slice(0, MAX_DROPS);
+        if (grouped.length !== drops.length)
+            hidden.push('benzer düşme satırları toplandı');
+        if (grouped.length > MAX_DROPS)
+            hidden.push(`${grouped.length - MAX_DROPS} düşme grubu`);
+        result.silentlyDropped = grouped.length > MAX_DROPS ? [...kept, `… ${grouped.length - MAX_DROPS} grup daha`] : kept;
+        result.droppedCount = droppedCount;
+    }
+    if (hidden.length === 0)
+        return result;
+    return { ...result, diagnosticsNote: "Kısaltıldı; yazmayı tekrarlamayın. Tam liste: sonraki çağrıda diagnostics:'full'." };
+}
+/**
+ * Aynı yolun farklı öğelerindeki düşmeler (`selectFields[fieldId=a].path`, `selectFields[fieldId=b].path`, …)
+ * aynı sorunu tekrar eder. Seçici ve indeks `[*]`'a indirgenir, grup tek satırda sayıyla ve bir örnekle
+ * döner. Listedeki HER satır kayıptır (sıra uyarısı ve kesme bilgisi `silentlyDroppedNotes`'tadır ve
+ * buraya hiç girmez); micro-op satırları (`add_component 'x': …`) da kendi yolu altında gruplanır.
+ * Liste kesildiyse ya da sayım tavana vurduysa grup sayısı "en az" diye yazılır.
+ */
+function groupDrops(drops, partial) {
+    const groups = new Map();
+    for (const line of drops) {
+        const separator = line.indexOf(': ');
+        const path = separator === -1 ? line : line.slice(0, separator);
+        const outcome = line.includes(' ↔ ') ? (line.endsWith('kaydedilen yok') ? ' · kaydedilmedi' : ' · farklı kaydedildi') : '';
+        const pattern = `${path.replace(/\[[^\]]*\]/g, '[*]')}${outcome}`;
+        groups.set(pattern, [...(groups.get(pattern) ?? []), line]);
+    }
+    return [...groups.entries()].map(([pattern, lines]) => {
+        if (lines.length === 1)
+            return lines[0];
+        const example = lines[0].length > 160 ? `${lines[0].slice(0, 159)}…` : lines[0];
+        return `${pattern}: ${partial ? 'en az ' : ''}${lines.length} öğe — ör. ${example}`;
+    });
+}