@appaflytech/zeyrek-ai-mcp 0.0.37 → 0.0.41

package/dist/knowledge/componentEvents.js

@@ -108,18 +108,18 @@ export const componentEventContracts = {
         mount: NO_DATA,
         change: {
             payload: { value: 'FilterGroup (iç içe and/or kural ağacı)', jexl: 'string (aynı ağacın hazır jexl ifadesi)' },
-            reads: "setter yalnız `value`yi self’e yazar; `jexl` YALNIZ event.data’dadır (params) — sorguya bağlayacağın alan odur"
+            reads: "setter yalnız `value`yi self’e yazar; `jexl` YALNIZ event.data’dadır (params) — sorguya bağlayacağın alan odur. `value` (ağaç) de event.data’da gelir — State’e geri yazmak için event.data.value’yu kullan. Ağaç değişmediyse (etkin birleştiriciye yeniden basmak) olay yayılmaz"
         }
     },
     comments: {
         mount: NO_DATA,
         submit: {
             payload: { text: 'string', parentId: "string (yanıtsa üst yorumun id’si, kök yorumda '')", mentions: 'string[] (metinden çözülmüş @kişi listesi)', author: 'string (currentUser)', process: "{ scope: 'task' | 'instance', targetId, visibility, body (@Ad → @<id>), mentionUserIds } | null (serbest yorumda null)" },
-            reads: 'Komponent yorumu ANINDA iyimser olarak listeye ekler (bekleyen katman); kalıcılık akışın işidir — rows tazelenmezse bekleyen satır bir sonraki içerik değişiminde kaybolur'
+            reads: 'Yük YALNIZ event.data’dadır (self.text/self.mentions boş gelir): {{ event.data.text }}. Komponent yorumu ANINDA iyimser olarak listeye ekler (bekleyen katman); kalıcılık akışın işidir — bekleyen satır, rows’a aynı üst yorum + metin (+ yazar) ile YENİ bir satır gelince yerini ona bırakır; akış kaydetmezse ya da metni değiştirirse "gönderiliyor…" kalır'
         },
-        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string (currentUser — işlemi yapan)' }, reads: 'beğeni de iyimserdir; sayaç rows tazelenene kadar yerel. isDisabled/isReadonly/isViewmode açıkken yayılmaz' },
-        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string (currentUser — işlemi yapan)' }, reads: 'düzenleme de iyimserdir; yeni metin "düzenlendi" işaretiyle rows tazelenene kadar yerel. Metin değişmediyse yayılmaz' },
-        delete: { payload: { id: 'string', author: 'string (currentUser — işlemi yapan)' }, reads: 'satır (kök yorumsa yanıtlarıyla birlikte) listeden hemen gizlenir; uca yazmak akışın işidir' }
+        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string (currentUser — işlemi yapan)' }, reads: 'Yük yalnız event.data’dadır. Beğeni de iyimserdir; sayaç rows tazelenene kadar yerel. isDisabled/isReadonly/isViewmode açıkken yayılmaz' },
+        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string (currentUser — işlemi yapan)' }, reads: 'Yük yalnız event.data’dadır. Düzenleme de iyimserdir; yeni metin "düzenlendi" işaretiyle rows tazelenene kadar yerel. Metin değişmediyse yayılmaz' },
+        delete: { payload: { id: 'string', author: 'string (currentUser — işlemi yapan)' }, reads: 'Yük yalnız event.data’dadır. Satır (kök yorumsa yanıtlarıyla birlikte) listeden hemen gizlenir; uca yazmak akışın işidir' }
     },
     'auth-layout': { mount: NO_DATA, primaryClick: NO_DATA, secondaryClick: NO_DATA },
     layout: { mount: NO_DATA, logout: NO_DATA },
@@ -354,7 +354,7 @@ export const componentEventContracts = {
     'audit-basic': { mount: NO_DATA },
     'audit-history': {
         mount: NO_DATA,
-        showMore: { payload: {}, reads: 'yalnız histories visibleLogCount’u aşınca çıkan "Daha fazla göster" düğmesine basılınca; görünür sınır visibleLogCount kadar büyür, kalan kalmayınca düğme kaybolur. Bileşen veri çekmez; backend kayıt başına en fazla 5 işlem verdiği için meta.history bağlıyken düğme ancak visibleLogCount < 5 iken çıkar' }
+        showMore: { payload: {}, reads: 'yalnız histories visibleLogCount’u aşınca çıkan "Daha fazla göster" düğmesine basılınca; görünür sınır visibleLogCount kadar büyür, kalan kalmayınca düğme kaybolur; en yeni (ilk) girdi değişince sınır başa döner. Bileşen veri çekmez; backend kayıt başına en fazla 5 işlem verdiği için meta.history bağlıyken düğme ancak visibleLogCount < 5 iken çıkar' }
     },
     'form-validation-errors': { mount: NO_DATA },
     'page-header': {
@@ -381,7 +381,7 @@ export const componentEventContracts = {
         },
         click: {
             payload: {},
-            reads: 'Yalnız akışa bağlıysa sarmalayıcı tıklanabilir olur; controls açıkken oynat/duraklat düğmesine basmak da bu olayı tetikler (tıklama sarmalayıcıya kabarır). isLoading:true iken HİÇ çalışmaz — o dalda oynatıcı yerine iskelet çizilir ve sarmalayıcı tıklanabilir değildir'
+            reads: "Yalnız akışa bağlıysa çalışır (sarmalayıcı <div>; controls:false iken role=button + Enter/Boşluk da tetikler); controls açıkken videonun YÜZEYİNE tıklamak hem oynatır hem bu olayı tetikler, kontrol çubuğundaki yerel oynat/duraklat düğmesi ise videoyu oynatır AMA bu olayı TETİKLEMEZ (ölçüldü 2026-10-05). isLoading:true iken HİÇ çalışmaz — o dalda oynatıcı yerine iskelet çizilir ve sarmalayıcı tıklanabilir değildir"
         },
         play: {
             payload: { isPlaying: 'boolean (true)' },
@@ -394,6 +394,14 @@ export const componentEventContracts = {
         ended: {
             payload: { isPlaying: 'boolean (false)' },
             reads: 'loop açıkken HİÇ yayılmaz (döngü videosu bitmez). event.data: { currentTime, duration } — bitişte currentTime pratikte duration’a eşittir. Bitişte pause’dan SONRA gelir (spesifikasyon sırası), yani ended akışı pause akışının ardından koşar'
+        },
+        load: {
+            payload: {},
+            reads: "Kaynağın İLK KARESİ hazır olunca (loadeddata) yayılır; kaynak her değiştiğinde yeniden. Değer yazmaz (setter yok). event.data: { duration: number (saniye; sonsuz ya da bilinmiyorsa 0), width: number, height: number (kaynağın kendi piksel boyu) }. Yalnız oynatıcı çizilirken yayılır: isLoading:true iken <video> yoktur, load gelmez (iskeleti kaynağı çözen sorgudan kapat). Boş src'de ya da error'da yayılmaz"
+        },
+        error: {
+            payload: {},
+            reads: "Kaynak yüklenemediğinde yayılır (404, video olmayan dosya, desteklenmeyen biçim, ağ kopması). Değer yazmaz, ama isPlaying true ise false'a düşer. event.data: { code: number (MediaError.code: 1 iptal · 2 ağ · 3 çözümleme · 4 kaynak yok/desteklenmiyor), message: string (tarayıcıya bağlı, çoğu kez boş) }. Bileşen kendi hata görünümü çizmez: siyah kutu kalır, kullanıcıya bildirmek akışın işidir. Boş src'de yayılmaz"
         }
     },
     // — 2026-08-25 eşleme turu: ng-apps-ui'da olay YAYAN ama burada kaydı olmayan komponentler.
@@ -672,7 +680,7 @@ export const componentEventContracts = {
                 fileName: 'string (okunan dosyanın adı; henüz dosya yoksa "")',
                 rowCount: 'number (dosyadaki HAM veri satırı sayısı — doğrulamadan önce)'
             },
-            reads: "adım her değiştiğinde yayılır; currentStep ve fileName düğüme de yazılır (self.currentStep), rowCount yalnız event.data'dadır"
+            reads: "adım her değiştiğinde yayılır; currentStep ve fileName düğüme de yazılır (self.currentStep), rowCount yalnız event.data'dadır. resetAfterComplete açıkken complete'ten hemen sonra { currentStep: 0, fileName: tamamlanan dosya, rowCount: 0 } ile bir kez daha yayılır"
         },
         complete: {
             payload: {
@@ -790,6 +798,39 @@ export const componentEventContracts = {
             reads: "self'e yazılmaz — event.data ile oku; okumayanlara bildirim gönderen akışı çağır"
         }
     },
+    'version-compare': {
+        mount: NO_DATA,
+        pairChange: {
+            payload: { oldId: 'string | number', newId: 'string | number' },
+            reads: "setter: oldId/newId self'e yazılır; event.data = { oldId, newId } — akış yeni çiftin files/fields/contextNote'unu yeniler"
+        },
+        fileRequest: {
+            payload: { id: 'string | number (dosyası gereken sürüm)' },
+            reads: "self'e yazılmaz — event.data.id ile oku; akış dosyayı alıp files[id] = { name, type, data, size } yazar, alamazsa files[id].error = { message, at } yazar (at: deneme zamanı). Tekrar dene fileRequest'i yeniden yayar ve files[id]'nin İÇERİĞİ öncekinden farklı olana dek bekler — hata kaydı her denemede ayırt edilebilir olmalı (aynı { error: true } yeniden yazılırsa kart beklemede kalır). Dosya gelip sonra files'tan düşerse yeniden istenir"
+        },
+        openVersion: { payload: { id: 'string | number' }, reads: "self'e yazılmaz — event.data.id ile oku" },
+        summary: {
+            payload: { all: 'number', add: 'number', del: 'number', mod: 'number' },
+            reads: "self'e yazılmaz — event.data ile oku; karşılaştırma bitince bir kez — karşılaştırılamaz sonuçta (görsel, taranmış pdf) yayılmaz"
+        },
+        selectionChange: {
+            payload: { selected: 'number (değişikliğin n’si)', section: 'string (değişikliğin bölümü / grubu)', kind: "'add' | 'del' | 'mod'" },
+            reads: "kendi gezinmede setter: yalnız selected self'e yazılır; event.data = { selected, section, kind } — okuma modunda görev çubuğunun 'Seçili: <bölüm> · <tür>' satırı. Açılışta / çift değişince (ilk seçim) ve selected dışarıdan yazılıp seçim değişince de yayılır, setter'sız (self'e yazılmaz); aynı seçim yeniden yayılmaz — akış selected'ı geri yazınca döngü olmaz"
+        },
+        inlineViewChange: {
+            payload: { inlineView: "'marked' | 'standard'" },
+            reads: "setter: inlineView self'e yazılır; event.data = { inlineView } — inline kipte 'İşaretli / Standart görünüm' anahtarı; sayfa standard'da kendi görüntüleyicisini gösterir, durumu (state) akış tutar"
+        },
+        inlineToolClick: {
+            payload: { key: 'string (basılan inlineTools düğmesinin ya da seçeneği seçilen menu öğesinin key’i)', item: 'string? (yalnız menu öğesinde: seçilen options[].key)' },
+            reads: "self'e yazılmaz — event.data.key (menu öğesinde ayrıca event.data.item) ile oku; inline satırındaki uygulama düğmesi (ör. yakınlaştır, indir, yazdır, tam ekran) ya da menu öğesinin seçeneği (ör. versiyon). Sağ grup sığmayınca '⋯' listesinden seçilen düğme satırdakiyle AYNI yükü yayar (ADR 0020). isDisabled düğme / seçenek yaymaz; text / separator öğesi basılmaz"
+        },
+        close: { payload: {}, reads: 'yük yok — kapat düğmesi, Esc ya da yüklemede Vazgeç' },
+        error: {
+            payload: { id: 'string | number? (karşılaştırma worker’ı çökerse ya da karşılaştırmanın kendisi hata verirse yok)', kind: "'fetch' | 'read' | 'unsupported' | 'tooMany'", message: 'string? (fetch: files[id].error.message ya da HTTP durumu; read: çözme/okuma hatası; unsupported: dosya türü; tooMany: değişiklik sayısı 5000 sınırını aştı — kimliksiz, kart gösterilir)' },
+            reads: "self'e yazılmaz — event.data ile oku"
+        }
+    },
     'case-view': {
         mount: NO_DATA,
         action: {

package/dist/knowledge/connectDataBind.js

@@ -375,7 +375,11 @@ export function buildDefinition(input, describe, connectable, connectablePaths =
     for (const slug of (keptSlugs(input.edit?.editable) ?? []).filter(item => describe.fields.find(field => field.slug === item)?.type === 'file')) {
         block('CD-018', `'${slug}' dosya alanı: edit.editable'a konamaz — bağlı bileşen dosyayı satır içinde yazmaz, platform kaydı 422 connect-data-editable-file ile reddeder. '${slug}'i editable'dan çıkarın; dosyayı file_upload + row_update (ya da bir microservice) yazar.`);
     }
-    for (const slug of [...(keptSlugs(input.filterable) ?? []), ...(keptSlugs(input.searchable) ?? [])]) {
+    // qm S-12: view kaynaklı microservice'te (describe source.textSearch, MicroserviceConnectDataSourceExecutor) alanlar süzülemez
+    // ama arama vardır — ConnectDataService request.Search'ü uca geçirir; searchable alanı ise kayıtta 422 alır. Genel
+    // "süzülemez/aranamaz" mesajı ajanı çıkmaza sokuyordu. View kaynağında aynı yolu CD-013 söyler (connectDataShapeIssues).
+    const textSearchSource = input.source.kind === 'microservice' && describe.source?.textSearch === true;
+    for (const slug of [...(keptSlugs(input.filterable) ?? []), ...(textSearchSource ? [] : keptSlugs(input.searchable) ?? [])]) {
         const field = describe.fields.find(item => item.slug === slug);
         if (field && (field.canFilter === false || (field.operators ?? []).length === 0)) {
             block('CD-002', `'${slug}' süzülemez (canFilter yok ya da işleç yok); filterable/searchable'a konamaz.`);
@@ -389,7 +393,11 @@ export function buildDefinition(input, describe, connectable, connectablePaths =
     }
     for (const slug of keptSlugs(input.searchable) ?? []) {
         const field = describe.fields.find(item => item.slug === slug);
-        if (field && field.canFilter !== false && (field.type !== 'string' || field.isProtected || !(field.operators ?? []).includes('icontains'))) {
+        const searchableField = field?.type === 'string' && !field.isProtected && (field.operators ?? []).includes('icontains');
+        if (field && textSearchSource && !searchableField) {
+            block('CD-002', `'${slug}' aranamaz: '${describe.source?.slug ?? describe.source?.id}' metin aramalı bir kaynak (describe source.textSearch) — arama searchable ile değil, istekteki search ile sunucuda çalışır; platform searchable alanı kayıtta 422 connect-data-source-feature-unsupported ile reddeder. searchable'ı boş bırakın; arama metnini platform istekteki search ile uca geçirir ve uç metni kendisi arar.`);
+        }
+        else if (field && field.canFilter !== false && !searchableField) {
             block('CD-002', `'${slug}' aranamaz: arama yalnız korumasız, içerir (icontains) işleci olan metin alanında çalışır — platform bu alanı aramada YOK SAYAR (geçerli hiç alan kalmazsa 422 ConnectDataFilterNotAllowed). Aranabilir bir metin alanı seçin.`);
         }
     }

package/dist/knowledge/expressionPrelude.js

@@ -13,6 +13,7 @@ export const EXPRESSION_PRELUDE_NAMES = [
     'params',
     '_PROXY_TAG',
     '_STATE_PROXY_TAG',
+    '_componentItem',
     'Components',
     'Page',
     '_stripProxy',

package/dist/knowledge/mobileComponentCatalog.js

@@ -160,7 +160,7 @@ export const mobileComponentKnowledge = {
         differences: [
             '`isIndeterminate` `value`yu bastırır ve tire (`remove` glifi) çizer; belirsiz kutuya dokunmak onu seçili yapar.',
             'Etikete dokunmak da kutuyu çevirir (basış satırın `Pressable`ında toplanır).',
-            '`page_screenshot` kutuyu `<elementId>__press` ile çevirir (düğmedeki gibi; kök kimliğe `click` kabuğa gider ve kutuyu ÇEVİRMEZ).',
+            '`page_screenshot` kutuyu `<elementId>__press` yüzeyinden çevirir (düğmedeki gibi); kök kimliğe `click` de o yüzeye basar (SCR-015).',
             '`labelPosition` yalnız `left`/`right`; `left` seçilince etiket ile kutu satırın iki ucuna yaslanır.',
             'Düşenler: `autofocus` ve `focus`/`blur` olayları (onay kutusunun klavye odağı yok, tek sinyal değer değişimidir).'
         ]
@@ -168,7 +168,7 @@ export const mobileComponentKnowledge = {
     switch: {
         summary: 'Açma/kapama anahtarı; shadcn `Switch` ilkeli (`@rn-primitives/switch`) — üç barındırıcıda AYNI görünüm.',
         differences: [
-            '`page_screenshot` anahtarı `<elementId>__press` ile çevirir (kök kimliğe `click` kabuğa gider).',
+            '`page_screenshot` anahtarı `<elementId>__press` (`role="switch"`) yüzeyinden çevirir; kök kimliğe `click` de o yüzeye basar (SCR-015).',
             'Platformun kendi anahtarı (iOS/Android `Switch`) KULLANILMAZ: açıkken zemin `--primary`, kapalıyken `--input`, baş `--background`; kanvas, önizleme ve cihaz aynı bileşeni çizer.',
             '`isReadonly` ve `isDisabled` anahtarı kilitler ve soldurur; `isDisabled` etiketi de soldurur. Tasarım kanvasında anahtar basılamaz olduğu için HER anahtar soluk çizilir — önizlemede ve cihazda değil.',
             'Düşenler: `autofocus` ve `focus`/`blur` olayları (anahtarın klavye odağı yok, tek sinyal değer değişimidir).'
@@ -179,7 +179,7 @@ export const mobileComponentKnowledge = {
         differences: [
             '`presentation` (mobile özgü): `auto` (varsayılan) sekiz ve daha az seçenekli, aramasız listeyi alanın hemen ALTINDA açar (altta yer yoksa ya da klavye açıksa üstte), öbürünü ekranın altından açılan sayfada; `sheet` hep sayfa, `inline` hep alan altı (arama varsa sayfa).',
             'Sayfada dokuz ve daha çok seçenek ya da `search` akışa bağlıyken tepede arama kutusu durur (iç rol `<elementId>__search`): bağlıysa `search { searchText }` yayar ve listeyi akış yazar, değilse yerelde süzer. Açılış `focus`, kapanış `blur` yayar.',
-            'Seçenek görseli web `SelectItem` önceliğiyle: `prefixImage` > `prefixText` (zemini `color`) > `icon` (rengi `color`); seçiliyken kutuda da çizilir. Gizli seçenek (`isHidden`) çizilmez. `isViewmode` kutuyu kilitler, ok ve temizleme düğmesini kaldırır. Düşenler: `options[].tooltip`, `isExpanded`, `isSelectable`, `lookupMode` (ağaç, üzerine gelme ve ↗ lookup penceresi yok).',
+            'Seçenek görseli web `SelectItem` önceliğiyle: `prefixImage` > `prefixText` (zemini `color`) > `icon` (rengi `color`); seçiliyken kutuda da çizilir. Gizli seçenek (`isHidden`) çizilmez. `isViewmode` kutuyu kilitler, ok ve temizleme düğmesini kaldırır. Düşenler: `options[].tooltip`, `isExpanded`, `isSelectable` (ağaç ve üzerine gelme yok). Mobil şema `lookupMode`’u web sınıfından devralır ama mobil çizici onu OKUMAZ: ↗ lookup penceresi açılmaz, yazılan değer etkisizdir.',
             'Tetikleyici shadcn `Input` görünümündedir (`--input` kenarı; yükseklik, köşe ve punto öteki alanlarla aynı `--ng-form-*` ölçüsü); liste `--popover` yüzeyinde, seçili satırda `check` glifi. Tetikleyici `role="combobox"` taşır (iç rol `<elementId>__trigger`, temizleme düğmesi `<elementId>__clear`), seçilebilir satırlar `role="option"` + `data-value`; liste katmanda açıldığı için `page_screenshot` `select` seçeneği belgede arar ve değerle ya da görünen metinle seçer.',
             '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.'
         ]
@@ -471,7 +471,7 @@ export const mobileComponentKnowledge = {
         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).',
+            '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-416).',
             "`click` bir akışa bağlıysa kod runtime'da basılır (web gibi); bağlı değilse dokunuşu yutmaz. QR'a sığmayan veri `error { errorText }`ü makine başına bir kez yayar (satırdaki seçim değişimi yeniden yaydırmaz)."
         ],
         propNotes: {
@@ -494,7 +494,7 @@ export const mobileComponentKnowledge = {
     '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.',
+            'Satır yalnız `click` bir akışa BAĞLIYKEN basılır ve `click` yayar (yük yok); bağsız satır düz kutudur ve dokunuşu yutmaz — `repeater`/`grouped-list` şablonunda basış listenin `itemPress`ine gider (2026-10-08). Pasifken soluk ve basılamaz; tasarım kipinde basılmaz (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.',
             "`leadingImage` `image` ile aynı çözümden geçer: kayıttaki FILE alanını nesne olarak verin (`{{ item.foto }}`) ya da `.absolute_path` yazın; `.value` dosya kimliğidir (GUID), görsel çizilmez (MOB-011).",
             'Ö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`).',
@@ -553,7 +553,7 @@ export const mobileComponentKnowledge = {
             'Başlık ifadelerde `Section` okur: `{ key, title, count, items }` — ör. `{{ Section.title }} · {{ Section.count }}`. Başlık satır kapsamı TAŞIMAZ (salt okunur, `Row`/`item` boş). `Section` ayrılmış addır: aynı adlı komponent ifade bağlamından süzülür.',
             'Gruplama: tarih/saat değeri cihazın yerel gününe (`YYYY-AA-GG`) indirgenir, diğer değer metne; başlık = anahtar (biçimli başlık için `Section.key` ile ifade yazın). Alanı boş/eksik satırlar en sondaki `otherSectionTitle` bölümüne düşer.',
             'Yapışkan başlık (`stickySectionHeaders`) yalnız boyu kabuktan gelen listede çalışır ve cihazda/önizlemede SINIRLI boy ister: `appearance.heightType: fixed` + `heightString` verin. `auto`da liste düz akıştır; sayfanın kaydırıcısı içindeki `fill` içerik kadar uzar, iç kaydırıcı oluşmaz, başlık yapışmaz.',
-            'Öğe şablonu basılabilir bir bileşense (`list-item`, `button`) dokunuş onun `click`ine gider ve `itemPress` yayılmaz (repeater ile aynı); `itemPress` için şablonu basılamayan bir kap yapın ya da akışı `list-item.click`e bağlayın (satır seçimi yine olur).',
+            'Öğe şablonu basılabilir bir bileşense (`button`, `click`i bağlı `list-item`) dokunuş onun `click`ine gider ve `itemPress` yayılmaz (repeater ile aynı); `click`i bağlı olmayan `list-item` basılamaz, dokunuş `itemPress`e gider (2026-10-08). Akışı `list-item.click`e bağlarsanız satır seçimi yine olur.',
             'Çoklu seçim `repeater` ile AYNI sözleşmedir: `selectionMode: multiple` (onay kutusu, dokunuş seçer, `itemPress` yayılmaz), `longPressSelects`, `selectionChange { selectedIndices, count }`, düğümde `selectedIndices`/`selectedItems` — gruplu görev listesinde toplu Ertele/Tamamla.',
             'v1`de yok: `columnCount`, sanallaştırma, başlıktan yazan akış. Studio`nun satır farkında yerleri (Bind modalı `Row` önerisi, setter satır hedefi) yalnız `repeater`ı tanır — `grouped-list` içinde `Row`/`item` ifadesini elle yazın.'
         ],
@@ -615,7 +615,7 @@ export const mobileComponentKnowledge = {
             '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`.',
             'Yerel arama (akış bağlı değilken) `dropdown` gibi veri dilinin yereliyle ve işaretsiz katlanır: İngilizce uygulamada "in" "India"yı, "suk" "Sükkülent"i bulur (2026-09-29; öncesinde hep `tr-TR`).',
-            'Satırın görseli web `SelectItem` önceliğiyle: `prefixImage` > `prefixText` (zemini `color`) > `icon` (rengi `color`). Düşenler: `options[].tooltip`, `isExpanded`, `lookupMode` (gruplar hep açık; üzerine gelme ve ↗ lookup penceresi yok).'
+            'Satırın görseli web `SelectItem` önceliğiyle: `prefixImage` > `prefixText` (zemini `color`) > `icon` (rengi `color`). Düşenler: `options[].tooltip`, `isExpanded` (gruplar hep açık; üzerine gelme yok). Mobil şema `lookupMode`’u web sınıfından devralır ama mobil çizici onu OKUMAZ: ↗ lookup penceresi açılmaz, yazılan değer etkisizdir.'
         ]
     },
     toast: {
@@ -768,7 +768,7 @@ export const mobileComponentKnowledge = {
             'Değer web gibi `{ value: base64 veri URL`si, fileName, type: "file" }` (çoklu kipte dizi, yeni seçim üstüne eklenir; boşaltma `{ type: "ref", value: null }`, çoklu kipte `[{ type: "ref", value: null }]`) — backend `TableFileParameter { value, type: ref|file|document, fileName }` biçiminin aynısı: `file` depoya yazılır, `ref` var olan dosyayı bağlar, `null` alanı boşaltır. Base64 sayfa durumunda ve istek gövdesinde taşındığı için `maxFileSizeMb` (mobil varsayılan 10) sıfırlanmaz. Kamera/galeri fotoğrafı uzun kenarı `maxImageDimension`a (varsayılan 1600 px; 0 = kapalı) indirilip JPEG olarak yeniden kodlanır — boyut kapısı küçültülmüş dosyaya bakar; belge seçiciden gelen dosyaya dokunulmaz. Fotoğraf arşivinden gelen HEIC iOS`ta JPEG`e çevrilir (`.jpg` — web`de Safari`nin yaptığı gibi), fotoğraflar `quality` ile sıkıştırılır. Görsel seçimler alanda küçük resimle görünür.',
             'Tür/boyut/adet kapısı web kuralıdır (tek uyarı, tür ihlali önce; uyarı metni uygulama dilinde). İç roller: kutu `<elementId>__field`, Gözat `__browse`, temizle `__clear`, çoklu kipte satır silme `__file-<n>__delete`. `isReadonly`/`isViewmode` Gözat`ı ve X`i gizler.',
             'Düşen: `style`.',
-            'f-13 (mobile özgü görünüm ve düzenleme): görsel dosya satırda 48 px küçük resimdir; tekli değerde satır "Değiştir" (`__file-0__change`, seçici yeniden açılır, değer yerinde değişir) ve kaldır taşır. `variant: tile` 1:1 kesikli "+ Ekle" karosu (`__add`) ve üç sütunlu küçük resim ızgarasıdır: dolu karoya basış değiştirir (`__file-<n>__change`), köşedeki × siler (`__file-<n>__delete`). `enableCrop` + `cropAspectRatio` cihazda sistem kırpıcısını açar (yalnız tek seçimde; iOS serbest oranı kesin uygulamaz; önizlemede kırpma yok), `rotateOnPick` (0/90/180/270) seçilen fotoğrafı döndürür. Kamera izni verilmezse değer değişmez, alanın altında Ayarlar bağlantılı not çıkar (`__settings`); alan geçersiz sayılmaz. Fotoğraf arşivi izin istemez (iOS PHPicker, Android sistem seçicisi).'
+            'f-13 (mobile özgü görünüm ve düzenleme): görsel dosya satırda 48 px küçük resimdir; tekli değerde satır "Değiştir" (`__file-0__change`, seçici yeniden açılır, değer yerinde değişir) ve kaldır taşır. `variant: tile` 1:1 kesikli "+ Ekle" karosu (`__add`) ve üç sütunlu küçük resim ızgarasıdır: dolu karoya basış değiştirir (`__file-<n>__change`), köşedeki × siler (`__file-<n>__delete`). `enableCrop` + `cropAspectRatio` cihazda sistem kırpıcısını açar (yalnız tek seçimde; iOS serbest oranı kesin uygulamaz; önizlemede kırpma yok), `rotateOnPick` (0/90/180/270) seçilen fotoğrafı döndürür. Kamera izni verilmezse değer değişmez, alanın altında Ayarlar bağlantılı not çıkar (`__settings`); alan geçersiz sayılmaz. Kamera iznini taşımayan derlemede (`source: camera`) izin istenmez, not Ayarlar bağlantısız "bu uygulamada kamera kullanılamıyor" der. Fotoğraf arşivi izin istemez (iOS PHPicker, Android sistem seçicisi).'
         ],
         propNotes: {
             source: 'Dosyanın geldiği yer: `files` (belgeler, varsayılan), `library` (fotoğraf arşivi), `camera`, `ask` (Kamera / Fotoğraflar / Dosyalar sorulur). `library` ve `camera` yalnız fotoğraf verir.',
@@ -797,7 +797,7 @@ export const mobileComponentKnowledge = {
             'Cihazda `react-native-maps`: iOS Apple Haritalar, Android Google Haritalar (Expo Go`da anahtarsız; geliştirme/EAS derlemesinde Android Google anahtarı ve konum izin metinleri gerekir — ARC-128). Kanvas ve önizlemede Leaflet + OpenStreetMap karoları (anahtarsız, köşede OSM atfı; OSM`nin ortak karo sunucusu yoğun trafiğe açık değildir). Kanvasta dokunuş almaz ve sürüklenmez; karolar ve işaretçiler çizilir.',
             'Görünüm üç sayıdır: `latitude`, `longitude`, `zoom` (web harita ölçeği 1–19, kesirli olabilir; cihazda Apple/Google bölgesine çevrilir). Nesne `center` prop`u YOKTUR: bağlanan düz nesne runtime`da bozulur (ARC-117).',
             'Akış `latitude`/`longitude`/`zoom` yazınca harita oraya gider (web`de anında, cihazda kısa canlandırmayla) ve `regionChange` YAYMAZ. Kullanıcı sürükleyip yakınlaştırınca bıraktığı görünüm `regionChange { latitude, longitude, zoom }` ile düğüme geri yazılır (`carousel.activeIndex` gibi: prop`a bağlı ifade o an ezilir). Kutu ya da pencere boyunun değişmesi olay sayılmaz.',
-            'İşaretçiye dokunmak `markerClick { markerId }` yayar ve başlığı ya da açıklaması varsa balon açar. Harita işaretçiye ORTALANMAZ; kenardaki işaretçinin balonu sığmazsa harita sığdıracak kadar kayar ve bu kayma `regionChange` yayar (iOS ve web`de ölçüldü). Üst üste binen işaretçilerde iOS`ta `markerId` açılan balonunkinden farklı olabilir (ARC-130). İşaretçi rengi temanın ana rengidir. Döndürme ve eğme kapalıdır (ölçek kuzey yukarı görünümün ölçeğidir).',
+            'İşaretçiye dokunmak `markerClick { markerId }` yayar ve başlığı ya da açıklaması varsa balon açar. Harita işaretçiye ORTALANMAZ; kenardaki işaretçinin balonu sığmazsa harita sığdıracak kadar kayar ve bu kayma `regionChange` yayar (iOS ve web`de ölçüldü). Üst üste binen işaretçilerde iOS`ta `markerId` açılan balonunkinden farklı olabilir (ARC-265). İşaretçi rengi temanın ana rengidir. Döndürme ve eğme kapalıdır (ölçek kuzey yukarı görünümün ölçeğidir).',
             '`interactive: false` sürüklemeyi ve yakınlaştırmayı kapatır, işaretçiler dokunulabilir kalır ve sayfa haritanın üstünden kayar. Açıkken haritanın üstündeki dikey sürükleme haritayı kaydırır, sayfayı değil.',
             '"Haritada aç" (adres önizlemesi): işaretçi dışına dokunuş `press { latitude, longitude, mapsUrl }` yayar ve düğüme yalnız `mapsUrl` yazılır. Yer tek işaretçiyse o işaretçi (adıyla), değilse görünümün merkezidir. Akış `redirect` `isRaw: true`, `path: \'<harita>.mapsUrl\'` ile açar: iOS Apple Haritalar, Android `geo:` (kullanıcının harita uygulaması), web Google Haritalar. Ayrı bir adım yoktur.',
             'Kutu `webview` kuralından: kabuktan gelen boy ya da panelin `aspectRatio`su, yoksa 300 dp.'
@@ -811,6 +811,18 @@ export const mobileComponentKnowledge = {
             showUser: 'Kullanıcının konumunu çizer. Cihazda iOS izni MapKit sorar, Android`de bileşen çalışma anı izni ister; web`de tarayıcı konum izni. Yalnız runtime`da. "Konumum" düğmesi yoktur (Android`inki kamerayı `regionChange` yaymadan taşırdı); konuma gitmek akışın `latitude`/`longitude` yazmasıdır.'
         }
     },
+    adBanner: {
+        summary: 'Google Mobile Ads banner`ı (kök ADR 0012). Web`de karşılığı YOKTUR. Reklam yalnız MAĞAZA sürümünde çizilir; kanvas, önizleme, `/view` ve Zeyrek Mobile oynatıcısı boyutlu kesikli yer tutucu ("Ad · <yerleşim> · 320×50") çizer.',
+        differences: [
+            '`unit` mağaza ayarındaki reklam yerleşiminin ADIDIR (`mobile_store_update` `settingsPatch.ads.units[].name`), AdMob birim kimliği DEĞİL: kimlik derlemenin platformuna göre manifestten çözülür. Yerleşim `banner` biçiminde olmalı; tam ekran yerleşimi (`interstitial`, `rewarded`…) banner çizmez — onlar `ad-show` adımının işidir.',
+            'Mağaza sürümünde sıra: rıza formu (UMP) → açılış izinleri (iOS ATT) → SDK başlatma; o bitene kadar ve reklam kapalı/rıza yokken bileşen YER KAPLAMAZ ve olay yaymaz. iOS`ta izleme izni verilmemişse reklam kişiselleştirilmeden istenir. Mağaza ayarında `testMode` açıkken Google test birimi çizilir ("Test Ad").',
+            'Yerleşim bu platformda yoksa ya da banner değilse yer kaplamaz ve `fail { code: \'unavailable\' }` yayar; oynatıcıda ve web`de de çalışma kipinde aynı olay yayılır (reklamsız akışı orada da sınayın). Yüklenemeyen reklam (`no-fill`) kutusunu kaldırır: boş kutu kullanıcıya hata gibi görünür.'
+        ],
+        propNotes: {
+            unit: 'Reklam yerleşiminin adı (`^[a-z][A-Za-z0-9]{0,39}$`, mağaza ayarında tanımlı). Panel serbest metindir — yanlış ad cihazda boş kutu + `fail` verir.',
+            size: '`banner` 320×50 (varsayılan) · `largeBanner` 320×100 · `mediumRectangle` 300×250 · `fullBanner` 468×60 · `leaderboard` 728×90 (tablet) · `adaptive` kabın genişliğine uyarlı çapa banner · `inlineAdaptive` içerik arası uyarlı. Yer tutucunun ölçüsü bu tablodandır; uyarlanır boyların gerçek yüksekliğini SDK belirler.'
+        }
+    },
     datatable: {
         summary: 'Veri tablosu (FlutterFlow DataTable); prop`lar ve akış sözleşmesi web ikizininki: sıralama ya da sayfa değişince sorgu prop`ları (`sortField`/`sortType`/`offset`) düğüme yazılır ve `mount` yeniden koşar, satır eylemi önce `selectedRow`u yazar sonra eylemin kendi akışını koşturur (yazım web gibi sessizdir, `silentUpdate: [elementId]`: tablo yeniden çizilmez, kaydırma konumu korunur). Hücre biçimi, görünür kolonlar, sıralama döngüsü ve sayfa hesabı web`in modülünden gelir (`renderCell`, `buildViewColumns`, `nextSort`, `computePageState`): iki platform aynı veriden aynı metni üretir.',
         differences: [

package/dist/knowledge/mobileComponentEvents.js

@@ -111,6 +111,26 @@ export const mobileComponentEventContracts = {
             reads: "işaretçi dışına dokunuşta yayılır (interactive: false önizlemede bütün yüzey). Makine YALNIZ mapsUrl'i düğüme yazar (self.mapsUrl) — koordinat yazılsaydı harita kayardı; koordinat event.data'dadır. Tarif: redirect isRaw: true, path: '<harita>.mapsUrl'"
         }
     },
+    adBanner: {
+        mount: NO_DATA,
+        load: {
+            payload: {
+                width: 'number — yüklenen reklamın genişliği (dp)',
+                height: 'number — yüklenen reklamın yüksekliği (dp)'
+            },
+            reads: 'yalnız mağaza sürümünde, reklam yüklenip çizilince yayılır'
+        },
+        fail: {
+            payload: {
+                code: "string — SDK hata kodu (`googleMobileAds/no-fill`, `googleMobileAds/network-error`…) ya da `unavailable`: derleme reklam taşımıyor (oynatıcı, web), ya da yerleşim bu platformda yok / banner değil",
+                message: 'string — hatanın açıklaması'
+            },
+            reads: "reklam çizilemeyince yayılır; kutu yer kaplamaz. Reklam alanını akışla gizlemek ya da yerine içerik koymak için kullanın. Mağaza sürümünde rıza yokken ya da SDK henüz başlamamışken YAYILMAZ"
+        },
+        click: { payload: {}, reads: 'kullanıcı reklama dokununca (yalnız mağaza sürümü)' },
+        open: { payload: {}, reads: 'reklam ekranı kaplayan bir katman açınca' },
+        close: { payload: {}, reads: 'kullanıcı reklam katmanından uygulamaya dönünce' }
+    },
     markdown: {
         mount: NO_DATA,
         linkClick: {
@@ -160,7 +180,7 @@ export const mobileComponentEventContracts = {
                 index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
                 row: 'object (öğenin satır verisi)'
             },
-            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (list-item, button) dokunuş onun click\'ine gider, itemPress yayılmaz'
+            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (button, click\'i bağlı list-item) dokunuş onun click\'ine gider, itemPress yayılmaz; click\'i bağlı olmayan list-item basılamaz, dokunuş itemPress\'e gider'
         },
         swipe: {
             payload: {

package/dist/knowledge/mobileStore.js

@@ -16,6 +16,14 @@ export const SPLASH_RESIZE_MODES = ['contain', 'cover'];
 export const RELEASE_STATUSES = ['draft', 'completed'];
 /** İznin mağaza derlemesindeki kipi (kök ADR 0010): kullanıma göre · her zaman · hiç. Anahtarları backend doğrular. */
 export const PERMISSION_MODES = ['auto', 'on', 'off'];
+/** Reklam ayarı (kök ADR 0012) — backend `MobileStoreSettingsValidator` / `MobileAdFormat` aynası. */
+export const AD_APP_ID_PATTERN = /^ca-app-pub-\d{16}~\d{10}$/;
+export const AD_UNIT_ID_PATTERN = /^ca-app-pub-\d{16}\/\d{10}$/;
+export const AD_UNIT_NAME_PATTERN = /^[a-z][A-Za-z0-9]{0,39}$/;
+export const AD_UNITS_MAX_COUNT = 40;
+export const AD_FORMATS = ['banner', 'interstitial', 'rewarded', 'rewardedInterstitial', 'appOpen'];
+/** Reklam açıkken taşınması gereken izin: iOS ATT (backend `MobileStoreSettings.AdsPermission`). */
+export const ADS_PERMISSION = 'tracking';
 export const LISTING_LIMITS = {
     title: 30,
     subtitle: 30,
@@ -200,6 +208,36 @@ export function storeSettingsFormatErrors(settings) {
         add('review.email', 'geçerli e-posta olmalı');
     if (text(apple.copyright).length > COPYRIGHT_MAX_LENGTH)
         add('apple.copyright', `en çok ${COPYRIGHT_MAX_LENGTH} karakter`);
+    const ads = isObject(settings.ads) ? settings.ads : {};
+    const units = (Array.isArray(ads.units) ? ads.units : []).filter(isObject);
+    const appIdExample = 'ca-app-pub-0000000000000000~0000000000';
+    const unitIdExample = 'ca-app-pub-0000000000000000/0000000000';
+    for (const field of ['iosAppId', 'androidAppId']) {
+        if (!isBlank(ads[field]) && !AD_APP_ID_PATTERN.test(text(ads[field])))
+            add(`ads.${field}`, `AdMob App ID biçiminde olmalı (${appIdExample}; birim kimliğindeki '/' değil '~')`);
+    }
+    if (ads.enabled === true && isBlank(ads.iosAppId) && isBlank(ads.androidAppId))
+        add('ads.enabled', 'reklam açıkken en az bir platformun AdMob App ID\'si gerekir (ads.iosAppId / ads.androidAppId)');
+    if (units.length > AD_UNITS_MAX_COUNT)
+        add('ads.units', `en çok ${AD_UNITS_MAX_COUNT} yerleşim`);
+    const invalidNames = [...new Set(units.map(unit => text(unit.name)).filter(name => !AD_UNIT_NAME_PATTERN.test(name) || units.filter(unit => text(unit.name) === name).length > 1))];
+    for (const name of invalidNames)
+        add(`ads.units.${name}`, `yerleşim adı ${AD_UNIT_NAME_PATTERN.source} biçiminde ve tekil olmalı (adBanner.unit ve ad-show.value bu adla anar)`);
+    for (const unit of units.filter(entry => !invalidNames.includes(text(entry.name)))) {
+        const name = text(unit.name);
+        if (!AD_FORMATS.includes(text(unit.format)))
+            add(`ads.units.${name}.format`, `kabul edilen biçimler: ${AD_FORMATS.join(' | ')}`);
+        for (const platform of ['ios', 'android']) {
+            if (!isBlank(unit[platform]) && !AD_UNIT_ID_PATTERN.test(text(unit[platform])))
+                add(`ads.units.${name}.${platform}`, `AdMob reklam birimi kimliği biçiminde olmalı (${unitIdExample})`);
+        }
+        if (isBlank(unit.ios) && isBlank(unit.android))
+            add(`ads.units.${name}`, 'en az bir platformun reklam birimi kimliği gerekir (ios / android)');
+    }
+    if (!isBlank(ads.appOpenUnit) && text(units.find(unit => text(unit.name) === text(ads.appOpenUnit))?.format) !== 'appOpen')
+        add('ads.appOpenUnit', `'${text(ads.appOpenUnit)}' appOpen biçiminde tanımlı bir yerleşim değil`);
+    if (ads.enabled === true && isObject(settings.permissionModes) && settings.permissionModes[ADS_PERMISSION] === 'off')
+        add(`permissionModes.${ADS_PERMISSION}`, "reklam açıkken izleme izni (tracking) kapatılamaz — iOS'ta kişiselleştirilmiş reklam ATT ister; kipi auto ya da on yapın");
     return errors;
 }
 /**
@@ -288,6 +326,43 @@ export function permissionLaunchShellWarnings(permissions, shell) {
         return [];
     return [`${asked.join(', ')}: açılışta sorulacak diye ayarlı ama yayındaki kabuk paketi (${text(shell.version)}) açılışta izin sormuyor — ayar saklanır, mağaza derlemesi sormaz (ön kontrol P-12 uyarır). Daha yeni bir kabuk yayınlanana kadar izni bir akış adımından isteyin (MOB-025, ${guide}).`];
 }
+/**
+ * MOB-027 — izleme izni (kök ADR 0011): mağaza derlemesi `tracking`'i taşıyorsa App Store Connect App Privacy'de
+ * "Device ID — Used to Track You" ve Play Data safety'de "Advertising ID" beyanı insanın işidir; Apple izin penceresinden
+ * önce teşvik ya da ön pencereyi yasaklar (5.1.2). Taşınmayan izin için söylenecek bir şey yoktur.
+ */
+export function trackingDeclarationWarnings(permissions) {
+    const tracking = permissions.find(entry => entry.key === ADS_PERMISSION);
+    return isObject(tracking?.build) && tracking.build.carried === true
+        ? [`${ADS_PERMISSION}: mağaza derlemesi izleme iznini (ATT) taşıyor — App Store Connect App Privacy'de "Device ID — Used to Track You", Play Console Data safety'de "Advertising ID" beyanı insanın işidir; izin penceresinden önce ödül/teşvik ya da kendi ön pencerenizi göstermeyin (App Store 5.1.2). Sonuçtaki advertisingId yalnız granted iken doludur (MOB-027, ${guide}).`]
+        : [];
+}
+/**
+ * MOB-026 — reklam açıkken ajanın bilmesi gereken, kayıttan okunabilen durumlar (kök ADR 0012). Satırlar `<konu>: …`
+ * biçimindedir. Test kipi mağaza yüklemesinde de test reklamı gösterir (ön kontrol P-13 `manual`); yerleşimsiz reklam
+ * SDK'yı bağlar ama hiçbir şey göstermez; App ID'si verilmiş platformda birimi olmayan yerleşim o platformda yer kaplamaz
+ * (`adBanner`) ya da `invalid` döner (`ad-show`). Beyan satırı her zaman gelir: App Privacy, Data safety ve AdMob rıza
+ * mesajı konsolda insanın işidir, gateway yazamaz.
+ */
+export function adsStoreWarnings(settings) {
+    const ads = isObject(settings.ads) ? settings.ads : {};
+    if (ads.enabled !== true)
+        return [];
+    const units = (Array.isArray(ads.units) ? ads.units : []).filter(isObject);
+    const platforms = [['ios', 'iOS', ads.iosAppId], ['android', 'Android', ads.androidAppId]];
+    const lines = [];
+    if (ads.testMode !== false)
+        lines.push(`testMode: test kipi açık — mağaza yüklemesinde de gerçek reklam yerine Google test reklamı gösterilir; yayından önce ads.testMode: false (ön kontrol P-13, MOB-026, ${guide}).`);
+    if (units.length === 0)
+        lines.push(`yerleşim: reklam açık ama hiç yerleşim yok — SDK bağlanır, hiçbir reklam gösterilmez; ads.units'e banner ya da tam ekran yerleşim ekleyin (MOB-026, ${guide}).`);
+    for (const unit of units) {
+        const missing = platforms.filter(([field, , appId]) => !isBlank(appId) && isBlank(unit[field])).map(([, label]) => label);
+        if (missing.length > 0)
+            lines.push(`${text(unit.name)}: ${missing.join(' ve ')}'de birim yok — o platformda adBanner yer kaplamaz, ad-show 'invalid' döner (MOB-026).`);
+    }
+    lines.push(`beyan: reklam izleme sayılır — App Store Connect App Privacy'de "Device ID — Used to Track You" (ve reklam verisi), Play Console Data safety'de "Advertising ID", AdMob konsolunda rıza (GDPR/UMP) mesajı insanın işidir; gateway yazamaz. Beyanı kullanıcı onaylayınca mobile_store_update { declarations } (MOB-026, ${guide}).`);
+    return lines;
+}
 /** MOB-022 — `definition` birleşmiş kayıttır; biçim hatası backend'in 422'siyle aynı ret (block), eksik alan uyarı. */
 export const mobileStorePolicyRules = [
     {

package/dist/knowledge/normalize.js

@@ -4,6 +4,7 @@ import { ensureWorkflowErrorPath } from './errorPath.js';
 import { DOCUMENT_STYLE_TYPES, TYPED_STYLE_COMPONENTS } from './styleResolve.js';
 import { STATE_STORAGE_KINDS, STEP_ALIASES } from './platform/profile.js';
 import { inlineStyleFields } from './componentCatalog.js';
+import { FUNCTIONS_NAMESPACE } from './functionGuards.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
 function asArray(value) {
@@ -362,6 +363,7 @@ const REQUIRED_COLLECTIONS = ['events', 'validations', 'stateBindings', 'childre
  *
  * - `states`: DesignComponentManagementSchema.ToDomain:47 `States.IsSticky`'yi guard'sız okur;
  *   Appearance'ın satır 24'te varsayılanı var, States'in yok.
+ * - `blocks` doldurulmaz: konum ebeveynin düzenine bağlıdır, eksikse PAGE-037 ile reddedilir.
  * - `events` / `validations` / `stateBindings`: yalnız **micro-op yolunda** zorunlu.
  *   `page_create` (POST /pages) bunlarsız 200 döner, `PATCH …/schema` NRE verir; canlı deneyde
  *   üçü birlikte verilince geçti, her biri tek başına verilince patladı (klinik H-005 eki).
@@ -675,6 +677,11 @@ export function styleKeyNote(fixed) {
             + 'değer kaydedilir ama hiç uygulanmaz ve tek işareti tarayıcı konsoludur (F-06). '
             + "Seçici anahtarlara ('&__body', ':hover', '--token') dokunulmadı."];
 }
+/** PAGE-009 ile aynı kural: JS tanımlayıcısı (tireler çıkarılınca) ve ayrılmış `Functions` değil. */
+function isDerivableComponentName(name) {
+    const bare = name.replace(/-/g, '');
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bare) && bare !== FUNCTIONS_NAMESPACE;
+}
 /**
  * Kabın `states.isDroppable`ı KATALOĞUN kararıdır. Gateway düğümü kurarken bu alanı
  * yazmıyordu (`DEFAULT_STATES` hepsini `false` bırakır) ve Studio kanvası düğümü kap saymıyordu:
@@ -721,6 +728,7 @@ export function droppableStatesNote(fixed) {
  * hiç denetlemez (`PageSchemaValidator.cs`); Studio her düğüme `name = elementId` yazar
  * (`ScreenBuilderDroppable.svelte`). Kural deterministik olduğu için reddetmek yerine dolduruyoruz.
  * Doldurulan ad da PAGE-009'dan geçmek zorunda: çağıran bunu denetimden ÖNCE koşar. Dolu ada dokunulmaz.
+ * `normalizeComponentDefaults` aynı boşluğu yalnız geçerli bir elementId için ikinci kez kapatır (güvenlik ağı).
  */
 export function fillComponentNames(nodes) {
     const filled = [];
@@ -745,6 +753,16 @@ export function normalizeComponentDefaults(nodes) {
     const fixed = [];
     for (const node of asObjects(nodes)) {
         const missing = [];
+        // name'siz düğümü platform kabul eder ama sayfada bir akış ya da `{{ }}` kod prop'u varsa
+        // FlowEngine runCode "Cannot read properties of undefined (reading 'catch')" ile düşer, akış
+        // `running:1`'de takılır ve hata adsız düğümü işaret etmez (image ölçüm turu, 2026-10-04).
+        // Yalnız PAGE-009'un geçerli saydığı elementId'den türetilir: page_create/page_update/layout
+        // yollarında PAGE-009 denetimi bu normalizasyondan ÖNCE koşar; bozuk bir elementId'den türeyen
+        // ad denetimi atlatıp "Missing initializer in const declaration" ile sayfayı öldürürdü.
+        if ((typeof node.name !== 'string' || node.name.trim() === '') && typeof node.elementId === 'string' && isDerivableComponentName(node.elementId)) {
+            node.name = node.elementId;
+            missing.push('name');
+        }
         if (!node.states || typeof node.states !== 'object') {
             node.states = { ...DEFAULT_STATES };
             missing.push('states');
@@ -1012,7 +1030,7 @@ export const PAGE_CONTAINER_ELEMENT_ID = 'page_container';
  * Düzen prop'ları da kurulur (2026-08-25): `ContainerComponent` şemasının `layout` varsayılanı
  * `grid` → `flex` oldu ve Studio bırakma yolu katalogdaki `definition.defaults`'u düğümün
  * props'una YAZAR (`ScreenBuilderDroppable.svelte`); sayfa kökünü kuran öbür üreticiler de aynı seti
- * yazar (Studio `DEFAULT_CONTAINER_LAYOUT_PROPS`, studio-api `generatePageContainer`, platform
+ * yazar (Studio `DEFAULT_CONTAINER_LAYOUT_PROPS`, platform
  * `CreatePageWhenApplicationCreatedEventHandler` + `SeedData`). Renderer varsayılanı
  * BİLMEZ — `isFlexLayout` yalnız düğümün kendi prop'una bakar — bu yüzden gateway'in kurduğu
  * kapsayıcı da seti açıkça taşır; yoksa Studio'dan açılan sayfa flex, MCP'den açılan ızgara olurdu.
@@ -1502,10 +1520,9 @@ function collectLayout(nodes, collected) {
  */
 const MAX_REORDER_PASSES = 8;
 /**
- * Studio'da komponent tuvale bırakıldığında ızgara çakışmasını studio-api'nin sayfa kurma servisi
- * çözer: `SchemaHelper.mergeComponents` yeni komponenti kardeşlerine ekleyip `reorderComponents` →
- * `draggableElement.moveItem` ile çakışan kardeşleri aşağı iter (NgApps.UI
- * `apps/studio-api/src/domain/page/shared/page-schema.helper.ts:28`). Gateway o servisten geçmez —
+ * Studio'da komponent tuvale bırakıldığında ızgara çakışmasını Studio'nun ızgara motoru çözer:
+ * `moveItem` çakışan kardeşleri aşağı iter (`@ng-apps/screen-builder`
+ * `src/draggable/draggable.element.ts`). Gateway o motordan geçmez —
  * `page_create`/`page_update` şemayı POST/PUT ile KOMPLE yazar (`page_build` tool'u yok) — bu yüzden
  * ajanın verdiği koordinatlar olduğu gibi kayda giriyor ve aynı hücreleri isteyen komponentler
  * Studio tuvalinde üst üste biniyor. Burada aynı algoritma şemanın TAMAMINA uygulanır: en dıştaki
@@ -1626,12 +1643,34 @@ function gapWalk(parentLabel, children, code, onlyParents, isRoot, warnings, par
  * sayfadan ayrılmadan koşar (`Runtime.svelte initDestroyGuard`). Platform uydurma adı 200 ile
  * kaydeder ama runtime eşleştiremez ve bağ sessizce ölü kalır (PAGE-008'in sayfa/layout ikizi).
  */
-const SCREEN_EVENT_NAMES = new Set(['mount', 'destroy']);
-export function invalidScreenEventNames(events, code) {
+const SCREEN_EVENT_NAMES = ['mount', 'destroy'];
+/**
+ * 38 S-15 / kök ADR 0015: mobil SAYFA bir olay daha taşır, `focus` — ekran ilk göründüğünde ve her geri
+ * dönüşte (yığından geri, sekme değişimi) koşar; yığındaki ekran bağlı kaldığı için `mount` geri dönüşte
+ * koşmaz. Web her gezinmede sayfayı baştan kurar (`Runtime.svelte` focus'u tanımaz), layout'un focus'u
+ * yoktur. Ayna: `ng-apps-ui-native` `SCREEN_LIFECYCLE_EVENTS` (parite: `test/page-meta.test.ts`).
+ */
+const MOBILE_PAGE_EVENT_NAMES = [...SCREEN_EVENT_NAMES, 'focus'];
+const SCREEN_EVENT_HINTS = {
+    mount: 'mount (yüklendiğinde)',
+    destroy: 'destroy (ayrılırken; temizlik akışları için)',
+    focus: 'focus (ekran her göründüğünde — ilk açılış ve geri dönüş; listeyi yeniden okumak için)'
+};
+export function screenEventNames(kind, platform) {
+    return kind === 'page' && platform === 'mobile' ? MOBILE_PAGE_EVENT_NAMES : SCREEN_EVENT_NAMES;
+}
+/** Olaylardan biri yalnız mobil sayfada geçerliyse karar uygulamanın platformunu ister (page_update şemasız yazımı). */
+export function screenEventsNeedPlatform(events) {
+    return asObjects(events).some(event => !SCREEN_EVENT_NAMES.includes(String(event.name ?? '')) && MOBILE_PAGE_EVENT_NAMES.includes(String(event.name ?? '')));
+}
+export function invalidScreenEventNames(events, code, names = SCREEN_EVENT_NAMES) {
+    const valid = names.map(name => SCREEN_EVENT_HINTS[name] ?? name).join(' · ');
     return asObjects(events)
         .map(event => String(event.name ?? ''))
-        .filter(name => name !== '' && !SCREEN_EVENT_NAMES.has(name))
-        .map(name => `${code}: sayfa/layout düzeyinde '${name}' diye bir olay YOK — geçerli adlar: mount (yüklendiğinde) · destroy (ayrılırken; temizlik akışları için). Platform kaydı kabul eder ama bağ sessizce ölü kalır.`);
+        .filter(name => name !== '' && !names.includes(name))
+        .map(name => MOBILE_PAGE_EVENT_NAMES.includes(name)
+        ? `${code}: '${name}' yalnız mobil uygulamanın SAYFASINDA vardır (layout'ta ve web sayfasında yok; web sayfayı her gezinmede baştan kurar, mount yeter) — burada geçerli adlar: ${valid}.`
+        : `${code}: sayfa/layout düzeyinde '${name}' diye bir olay YOK — geçerli adlar: ${valid}. Platform kaydı kabul eder ama bağ sessizce ölü kalır.`);
 }
 const GUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 /**
@@ -1699,9 +1738,9 @@ function collectDesktopPositions(nodes, into) {
  * görünen sıraya yerleştir, x=0, birikimli y). Burada aynısı yapılır: akış kabında `index` GÖRÜNEN
  * sıradaki yerdir (eski kayıtlarda dizi sırası çizimle aynı değildir, Studio sürüklerken diziyi
  * değil y'yi yazar). Op'lar okunan şemanın kopyasına sırayla uygulanır; eklenen düğümün son konumu
- * kendi gövdesine, var olan kardeşlerinki yamanın sonuna `move_component {target, position}` olarak
- * yazılır. Platform position'ı düğümün İLK bloğuna yazar: ilk bloğu desktop olmayan kardeş atlanır ve
- * uyarılır. Izgara kapta çizim mutlak koordinattır; sona eklemeyen `index` orada PAGE-033 uyarısıdır.
+ * kendi gövdesine, var olan kardeşlerinki yamanın sonuna `move_component {target, breakpoint: 1024,
+ * position}` olarak yazılır. `breakpoint` açık yazılır: ilk bloğu mobil kırılım olan kardeşte mobil
+ * konum ezilmez (PAGE-033, K9). Izgara kapta çizim mutlak koordinattır; sona eklemeyen `index` orada PAGE-033 uyarısıdır.
  * `index` verilmemiş op'a dokunulmaz.
  */
 export function flexIndexOrder(schema, ops) {
@@ -1814,11 +1853,7 @@ export function flexIndexOrder(schema, ops) {
         const before = original.get(elementId);
         if (!body && !moveTargets.has(elementId) && before && before.x === final.x && before.y === final.y)
             continue;
-        if (Number(asObjects(node.blocks)[0]?.breakpoint) !== DESKTOP_BREAKPOINT) {
-            warnings.push(`PAGE-033 (uyarı): '${elementId}' flex sırasına göre y:${final.y}'e taşınmalıydı ama ilk bloğu desktop (1024) değil — platform move_component'in position'ını İLK bloğa yazar, yanlış kırılımı bozmamak için konum yazılmadı. Düğümü page_update(schema) ile düzeltin.`);
-            continue;
-        }
-        trailing.push({ op: 'move_component', target: elementId, position: { x: final.x, y: final.y } });
+        trailing.push({ op: 'move_component', target: elementId, breakpoint: DESKTOP_BREAKPOINT, position: { x: final.x, y: final.y } });
         moved.push(`${elementId} y:${before?.y ?? '?'}→${final.y}`);
     }
     return { ops: [...sent, ...trailing], moved, warnings };

package/dist/knowledge/platform/mobile.js

@@ -116,7 +116,7 @@ export const mobileProfile = Object.freeze({
     },
     style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back']),
         aliases: STEP_ALIASES,
         infoOnly: new Set(['download', 'setcookie'])
     },

package/dist/knowledge/platform/mobileRules.js

@@ -180,7 +180,7 @@ export const MOBILE_WEB_ONLY = {
     'layout-region': "tek slot'lu sıradan layout",
     'auth-layout': "tek slot'lu sıradan layout",
     popover: "'modal' widget'ı",
-    'theme-toggle': "uygulama içi tema ayarı: 'choice-chips' (variant: segmented, Sistem/Açık/Koyu) → storage adımı name: 'zeyrek:theme-mode', value: system | light | dark; barındırıcı temayı anında değiştirir, cihazda kalıcı (seçim yazılmadıysa cihaz teması)",
+    'theme-toggle': "uygulama içi tema ayarı: 'choice-chips' (variant: segmented, Sistem/Açık/Koyu) → storage adımı name: 'zeyrek:theme-mode', value: system | light | dark; barındırıcı temayı anında değiştirir, cihazda kalıcı (seçim yazılmadıysa açık tema; cihaz teması yalnız system seçilince)",
     pagination: "'repeater' + daha fazla yükle düğmesi",
     breadcrumb: "yığın gezinmesi (app-bar geri düğmesi)",
     fileUpload: "'fileInput' (alan) ya da 'filebutton' (düğme) — dokunmatikte sürükle-bırak yok; ikisi de aynı base64 değeri yazar"

package/dist/knowledge/platform/web.js

@@ -20,7 +20,7 @@ export const webProfile = Object.freeze({
     },
     style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back']),
         aliases: STEP_ALIASES,
         infoOnly: new Set()
     },