@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.41

package/dist/resources/guides/mobile.md

@@ -179,12 +179,12 @@ istekle gider.
    Gateway alan tipini şemadan bilemediği için uyarı metinseldir: `.value` ile biten en az üç parçalı
    yol (`urlInput.value` gibi bileşen değeri ve `fileInput1.value.value` uyarı almaz).
 
-Workflow'un dosya yükleme adımı yalnız `{ id }` döndürür (URL yok); görsel adresi kaydı okuyan uçtan
-gelir. `page_screenshot` ile listede görseli doğrulayın.
+Workflow'un `file-upload` adımı da aynı nesneyi döndürür, adres `<adım>.data.absolute_path`
+(`platform_guide('workflow')`). `page_screenshot` ile listede görseli doğrulayın.
 
 ## Liste ve boş durumu
 
-Mobil `repeater`'ın çocukları TAM İKİ `view`'dır (web listesi tek şablonludur, bu şekil YALNIZ mobildir) — satır şablonu ve boş görünüm (ADR
+Mobil `repeater`'ın çocukları TAM İKİ `view`'dır (web'de tek şablon) — satır şablonu ve boş görünüm (ADR
 docs/adr/0005; başka şekil 422 `fixed-views`). Satır yokken boş görünüm bir kez, tam genişlikte
 çizilir; boş ekranı oraya tasarla. `emptyTitle`/`emptyDescription`/`emptyIcon` prop'ları ve kardeş
 `emptystate` yolu 2026-09-30'da kaldırıldı. Mobil `view` çocuklarını sütunda dizer. Tam gövde:
@@ -204,15 +204,15 @@ bölümleri bileşen render anında çıkarır.
 3. **Çocuklar konumsaldır:** çocuk 0 bölüm başlığı, çocuk 1 öğe şablonu; fazlası çizilmez.
 
    ```json
-   { "elementId": "tasks", "name": "tasks", "type": "grouped-list",
+   { "elementId": "tasks", "name": "tasks", "type": "grouped-list", "blocks": [],
      "props": { "rows": { "type": "code", "ref": "{{ q_tasks.data }}" },
-                "groupBy": { "type": "static", "data": "dueDate" },
-                "itemPressable": { "type": "static", "data": true } },
+       "groupBy": { "type": "static", "data": "dueDate" },
+       "itemPressable": { "type": "static", "data": true } },
      "children": [
-       { "elementId": "day_title", "name": "day_title", "type": "text",
+       { "elementId": "day_title", "name": "day_title", "type": "text", "blocks": [],
          "props": { "content": { "type": "code", "ref": "{{ Section.title }} · {{ Section.count }}" } } },
-       { "elementId": "task_row", "name": "task_row", "type": "container", "props": {},
-         "children": [ { "elementId": "task_title", "name": "task_title", "type": "text",
+       { "elementId": "task_row", "name": "task_row", "type": "container", "props": {}, "blocks": [],
+         "children": [ { "elementId": "task_title", "name": "task_title", "type": "text", "blocks": [],
            "props": { "content": { "type": "code", "ref": "{{ item.title }}" } } } ] } ] }
    ```
 
@@ -241,10 +241,10 @@ düğümü sayfa kök kabının SONUNA koyun (akıştaki yeri boş kalır).
   sayılır), `respectSafeArea` (varsayılan açık). Alt eylem çubuğu:
 
   ```json
-  { "elementId": "action_bar", "name": "action_bar", "type": "floating-container",
+  { "elementId": "action_bar", "name": "action_bar", "type": "floating-container", "blocks": [],
     "props": { "anchor": { "type": "static", "data": "bottom-center" },
-               "fullWidth": { "type": "static", "data": true } },
-    "children": [ { "elementId": "bar", "name": "bar", "type": "container",
+      "fullWidth": { "type": "static", "data": true } },
+    "children": [ { "elementId": "bar", "name": "bar", "type": "container", "blocks": [],
       "props": { "direction": { "type": "static", "data": "row" } }, "children": [] } ] }
   ```
 
@@ -411,8 +411,8 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 |---|---|
 | `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres) |
 | `navigate` | eski mobil şemaların adı — `redirect`'in takma adıdır; gateway `redirect`'e çevirir |
-| `alert` | tipli uyarı (`success`/`error`/`info`/`warning`) toast'tur ve beklemez; düz uyarı onay bekler. Eylem düğmeli bildirim ("Silindi · Geri al") `alert`le kurulmaz: sayfaya bir `toast` bileşeni koyun (`actions: [{ text, flow }]`, gerekirse `keepOpen`), akış setter'la `isOpen: true` yazar; basış eylemin kendi akışını koşar (`actionClick { text, index }`) |
-| `confirm` | `yes` / `no` dalları |
+| `alert` | tipli uyarı (`success`/`error`/`info`/`warning`) toast'tur ve beklemez; düz uyarı onay bekler. `message`/`description` metin şablonudur (`"{{ t('kayit.tamam') }}"`; `platform_guide('page')` §alert). Eylem düğmeli bildirim ("Silindi · Geri al") `alert`le kurulmaz: sayfaya bir `toast` bileşeni koyun (`actions: [{ text, flow }]`, gerekirse `keepOpen`), akış setter'la `isOpen: true` yazar; basış eylemin kendi akışını koşar (`actionClick { text, index }`) |
+| `confirm` | `yes` / `no` dalları; `message`/`title`/`confirmText`/`cancelText` metin şablonudur (`{{ }}`, çeviri `t('anahtar')`) |
 | `download` | adres cihazın açma sayfasında açılır; ikili gövde (JSON değil) önbelleğe dosya olarak yazılıp paylaşım sayfasında (`expo-sharing`) açılır, Studio mobil önizlemesi dosyayı indirir (`MOB-005`, bilgi) |
 | `storage` | `args.name` `state.page.<key>` / `state.app.<key>` ise o state'i yazar (§Kalıcı state), değilse cihaz deposuna |
 | `setcookie` | güvenli cihaz deposuna (SecureStore) yazar; değer sonraki her istekte `X-Flow-Cookie` başlığıyla gider ve middleware/workflow onu web'deki gibi `cookie.<ad>` olarak okur — `Cookie` başlığıyla gitmez, çünkü iOS onu yerel çerez kavanozuyla virgülle birleştirip bozuyordu (`MOB-005`, bilgi); aynı adlı sunucu çerezi varsa o kazanır. Studio paleti mobilde de sunar |
@@ -421,10 +421,11 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 | `location` | cihaz konumu (`expo-location`; ilk kullanımda izin sorulur; derleme konumu taşımıyorsa sorulmaz, `error` dalı `status: 'unavailable'`). `args.value` doğruluk, düz metin: `low` · `balanced` · `high` (boş → `balanced`); `args.isRaw: true` → adres çözülmez. Sonuç `Steps.<adım>.data = { latitude, longitude, accuracy, address }`, `address = { country, region, subregion, city, district, street, postalCode }` ya da `null` (Türkiye'de il `region`, ilçe `subregion`, yoksa `city`). İzin reddi `Steps.<adım>.error = { status: 'denied', message }`, okunamayan konum `unavailable`: adımın `error` dalı bağlıysa o koşar (`always` koşmaz), yoksa akışın hata akışı, o da yoksa `always` (`data: null`). Web'de tarayıcı konumu, adres hep `null` |
 
 | `notification-permission` | bildirim izni ister (sorulmuşsa yeniden sormaz, kalıcı red yeniden sorulmaz). Sonuç `Steps.<adım>.data.status`: `granted` · `denied` · `undetermined`; red hata değildir, hep `always` |
-| `notification-schedule` | yerel bildirim planlar (`expo-notifications`; uzak push değil). `args.name` kimlik (düz metin; aynı kimlik eskisinin yerini alır), `args.title` başlık (düz metin), `args.message` gövde (**ifade**), `args.value` zaman (**ifade**): sonucu `'HH:mm'` → her gün, `{ weekday: 1–7, time: 'HH:mm' }` → her hafta (1 = Pazartesi), ISO tarih-saat → bir kez. `args.path` dokununca açılacak sayfanın slug'ı (+ `args.query` ifade), boşsa uygulama açılır. İzin yoksa `error.status: 'denied'`, geçmiş ya da okunamayan zaman `invalid`: `error` dalı → hata akışı → `always`. Web'de desteklenmez (`unsupported`) — sayfa kapalıyken tarayıcı gösteremez |
-| `notification-cancel` | `args.name` kimlikli planlı bildirimi siler, `'*'` hepsini; hep `always` |
+| `notification-schedule` | yerel bildirim planlar (`expo-notifications`; uzak push değil). `args.name` kimlik ve `args.title` başlık **metin şablonudur** — yalnız `{{ }}` içi çözülür (`'ilac-{{ item.id }}-0800'` kayıt başına ayrı kimlik, `"{{ t('ilac.vakti') }}"` çeviri; `{{ }}` dışındaki ifade çözülmez, FLOW-022); aynı kimlik eskisinin yerini alır. `args.message` gövde (**ifade**), `args.value` zaman (**ifade**): sonucu `'HH:mm'` → her gün, `{ weekday: 1–7, time: 'HH:mm' }` → her hafta (1 = Pazartesi), ISO tarih-saat → bir kez. `args.path` dokununca açılacak sayfanın slug'ı, düz metin — şablon çözmez (+ `args.query` ifade), boşsa uygulama açılır. İzin yoksa `error.status: 'denied'`, geçmiş ya da okunamayan zaman `invalid`: `error` dalı → hata akışı → `always`. Web'de desteklenmez (`unsupported`) — sayfa kapalıyken tarayıcı gösteremez |
+| `notification-cancel` | `args.name` kimlikli planlı bildirimi siler (planlamadaki gibi metin şablonu: `'ilac-{{ item.id }}-0800'`), `'*'` hepsini; hep `always` |
 | `permission` | bir cihaz iznine bakar ya da ister. `args.value` izin türü, **düz metin — ifade olamaz** (mağaza derlemesinin taşıyacağı izinler bu değerden, akış koşmadan hesaplanır; `FLOW-038`); `args.name` kip: `check` yalnız okur (sistem penceresi açılmaz), `request` verilmemiş ve hâlâ sorulabilen izni ister (boş → `request`). Sonuç `Steps.<adım>.data = { status, canAskAgain }`: `granted` · `denied` · `undetermined` · `unavailable` (derleme bu izni taşımıyor ya da web önizlemesi); `canAskAgain: false` → yalnız Ayarlar'dan değişir. `tracking` (iOS App Tracking Transparency) sonucu ayrıca `advertisingId` taşır: izin `granted` iken IDFA (iOS) / AAID (Android), değilse `null`; oynatıcı `tracking`'i hiç taşımaz (`unavailable`). Red hata değildir, hep `always`. Türler: `mobile_store_get { detail: ['permissions'] }` (`support: supported` satırlarının `key`'i) |
 | `open-settings` | uygulamanın sistem ayar sayfasını açar; `Steps.<adım>.data.opened`. Argüman almaz |
+| `back` | gezinme yığınında bir geri (iOS geri kaydırmasıyla aynı sonuç; kök ADR 0013). Argüman almaz (yazılan okunmaz), sonuç yazmaz, hata üretmez, hep `always`. Yığının ilk ekranında hiçbir şey yapmaz; Studio önizlemesinde runtime'ın kendi gezinmesi yoksa yine hiçbir şey, web uygulamasında tarayıcının geri'sidir. Formu kaydedip önceki ekrana dönmek için `redirect` yerine bunu kullanın: `redirect` yığına yeni ekran iter, geri kaydırması kaydedilen forma döner. 2026-10-08 öncesi runtime ve backend `back`'i tanımaz |
 | `ad-show` | tam ekran reklam (kök ADR 0012). `args.value` mağaza ayarındaki yerleşimin **adı**, düz metin (`FLOW-039`); biçimi `interstitial` · `rewarded` · `rewardedInterstitial` olmalı. Reklam yüklenip gösterilir, kullanıcı kapatınca `Steps.<adım>.data = { shown: true, reward }` ile sürer — `reward` ödüllü reklamı sonuna kadar izleyende `{ type, amount }`, değilse `null` (ödül ayrı dal değil, `condition` ile okunur). 10 sn'de reklam yoksa, SDK hata verirse, derleme reklam taşımıyorsa ya da rıza yoksa `error.status: 'unavailable'`; tanımsız ya da banner yerleşimi `invalid`: `error` dalı → hata akışı → `always`. Oynatıcı ve web önizlemesi her zaman `unavailable` — reklamsız dalı orada sınayın. Paletten yalnız mobilde |
 
 Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce
@@ -455,7 +456,11 @@ ayarda tanımlı olduğu sayfa/akış yazımında denetlenemez — `mobile_store
 düğmenin `click`'i → `location` (`always` → setter `il.value = Steps.konum.data.address?.region`, `error` →
 setter hata metni). Uzak push (sunucudan gelen bildirim) ayrı bölümde: §Uzak push.
 
-Sayfa ve layout `mount` akışları ilk çizimden sonra, `destroy` akışları sayfa kalkarken koşar.
+Sayfa ve layout `mount` akışları ilk çizimden sonra, `destroy` akışları sayfa kalkarken koşar. Yığındaki
+ve sekmedeki ekran bağlı kalır: geri dönüşte `mount` KOŞMAZ. Listeyi yeniden okumak için sayfanın
+**`focus`** olayı vardır (layout'ta yok): ilk görünüşte `mount`'tan sonra ve her geri dönüşte / sekme
+değişiminde koşar. Bağ: `page_update` `events: [{ name: 'focus', value: <flow id> }]`. Form doldurma
+`mount`'ta, liste okuması `focus`'ta — aynı okuma ikisine bağlanırsa ilk açılışta çift istek gider.
 `Functions.<ad>()` uygulama ve sayfa fonksiyonlarını görür (`platform_guide('functions')`).
 
 
@@ -488,7 +493,8 @@ Sunucudan gönderilen bildirim yerel `notification-schedule`'dan ayrıdır. Kana
 ## Kalıcı state
 
 State varsayılan olarak **bellektedir**: sayfa her açıldığında `variable_create`'te yazılan `value`'dan
-başlar, akışın yazdığı değer ekran kapanınca kaybolur. Uygulama kapanıp açıldığında kaldığı yerden
+başlar, akışın yazdığı değer ekran kapanınca kaybolur — `state.app` dahil: sayfalar arası
+taşımak da `storage` ister (38 S-5). Uygulama kapanıp açıldığında kaldığı yerden
 sürmesi gereken değer için değişkene saklama türü verin:
 
 | `storage` | Depo | Ne için |
@@ -526,7 +532,10 @@ variable_create({ applicationId, pageId, variables: [
   780x1688 px) çeker; `'tablet'` 820x1180 @2 ya da `{ width, height, scale? }`. `viewport` verilirse
   cihaz yok sayılır (`deviceNote`). Yanıt `applicationType: 'mobile'` ve `platformNote` taşır: kare
   react-native-web çizimidir, cihazdakiyle yapısal olarak (düğüm, sıra, ölçü, renk) aynıdır.
-- Eylemler aynı sözlük: `click` basılabilir öğeyi (`role="button"`) bulur; `submit` runtime
+- Eylemler aynı sözlük: `click` önce düğümün kendisine (basılabilirse: `role="button"`/`"switch"`/
+  `"combobox"`), sonra `<elementId>__press` yüzeyine, en son içteki ilk düğmeye basar — anahtar ve
+  onay kutusu kök kimlikle çevrilir, çoklu seçimi `<elementId>__trigger` açar (çipin "kaldır"ına
+  basmaz); `set` alana odaklanır, yazar ve odaktan çıkar (`changed` koşar); `submit` runtime
   köprüsüyle gider (`submitVia: 'bridge'`); sekme öğesi `__tabs__item-<sayfa slug'ı>`, çubuk `__tabs`
   özet satırıdır. `select` açılır listeyi açar ve seçeneği değerle ya da görünen metinle seçer
   (liste katmanda açılır, `optionsSeen` kaç seçenek görüldüğünü söyler); `tab` bir `tabs`

package/dist/resources/guides/page.md

@@ -282,7 +282,8 @@ dalı bulamaz ve akışı **sessizce durdurur** (`flow-engine.ts:79`); Studio da
 İstisnalar: `condition` → dal adı rule id'sidir (ve o id bir **GUID**'dir — aşağıdaki tuzak 6),
 `confirm` → `yes|no|always`, `microservice` →
 `always` (eski akışlarda `success` de çalışır) **+ `error`** — bağlarsan hata anında `always`
-yerine ondan sürer (2026-09-26, ADR 0004; ayrıntı aşağıdaki §"4xx de hatadır").
+yerine ondan sürer (2026-09-26, ADR 0004; ayrıntı aşağıdaki §"4xx de hatadır"), `validation` →
+`success` (hepsi geçti) | `error` (biri düştü), ardından her durumda `always` (kuralları aşağıda).
 
 **2. `iteratees[].type` yalnız `change` | `fill`.** `setter.ts` başka değerde hiçbir dala
 girmez — adım çalışır, hiçbir şey yapmaz. `change` tek prop'a değer yazar, `fill` diziyi
@@ -445,13 +446,15 @@ göstermek error flow'un işidir.
 > | `Steps.<adımAdı>.error.body` | Ucun hata gövdesi — eski `Steps.<adımAdı>.data`'nın taşındığı yer | `microservice.ts` `.catch` |
 > | `Steps.<adımAdı>.data` | **HER ZAMAN `null`**'dır — başarı gövdesi değil, hiçbir gövde değil (eskiden hata gövdesiydi) | `microservice.ts` `.catch` |
 >
-> **`alert` adımının `message`'ı DÜZ METİNDİR — ifade yazarsan ekranda o ifade görünür.**
-> `alert.ts` `task.argument.message`'ı doğrudan `toast.error()`'a geçirir ve `args` hiçbir yerde
-> değerlendirilmez (`Runtime.svelte` `argument: step.args`): `{ "type": "alert", "args": {
-> "message": "Steps.error.message", "alertType": "error" } }` kullanıcıya harfi harfine
-> `Steps.error.message` gösterir. Sabit bir uyarı yetiyorsa `alert` en ucuz adımdır; **ucun ne
-> dediğini göstereceksen bir `setter` (ya da `code`) adımı zorunludur** — `value.type: 'code'`
-> ifadeyi orada gerçekten çalıştırır:
+> **`alert` adımının `message`'ı ve `description`'ı METİN ŞABLONUDUR — yalnız `{{ }}` içi çözülür.**
+> Bileşen prop bağlamasıyla aynı çözücü (`@ng-apps/flow` `resolveStepText` → `runPropertyCode`; web ve
+> cihaz aynı): `{ "type": "alert", "args": { "message": "{{ Steps.error?.message ?? 'İşlem başarısız' }}",
+> "alertType": "error" } }` ucun mesajını gösterir, `"{{ t('kayit.tamam') }}"` etkin dildeki çeviriyi.
+> `{{ }}` DIŞINDA yazılan ifade çözülmez: `"message": "Steps.error.message"` kullanıcıya harfi harfine
+> `Steps.error.message` gösterir (FLOW-022 uyarır). `{{ }}` içermeyen metin olduğu gibi kalır. 2026-10-08
+> öncesi runtime'da (yeniden yayımlanmamış kurulum, eski mobil derleme) bu alanlar düz metindi; orada
+> ucun mesajı bir `setter` (ya da `code`) adımıyla bir bileşene yazılır — mesajı ekranda kalıcı
+> göstermek için bugün de bu yol geçerlidir:
 >
 > ```jsonc
 > // errorSteps: start → bu setter. Metni bir notification/text komponentine yazar.
@@ -463,13 +466,14 @@ göstermek error flow'un işidir.
 >   "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }] }
 > ```
 
-> **`confirm` adımının diyalog çerçevesi de yazılabilir.** `args` dört düz metin alanı taşır:
+> **`confirm` adımının diyalog çerçevesi de yazılabilir.** `args` dört metin alanı taşır:
 > `message` (gövde), `title` (başlık), `confirmText` (onay düğmesi, `yes` dalı), `cancelText`
 > (vazgeç düğmesi, `no` dalı). Son üçü isteğe bağlıdır; boş bırakılan alan dile göre sabit metne
 > düşer ("Emin misiniz?" / "Evet" / "Hayır" — `dialog.functions.ts` `resolveDialogFrame`).
-> Dördü de `alert`'in `message`'ı gibi DÜZ METİNDİR (FLOW-022 hepsini denetler):
-> `{ "type": "confirm", "args": { "message": "Bu risk ve 4 aksiyonu silinecek.", "title": "Riski sil",
-> "confirmText": "Sil", "cancelText": "Vazgeç" } }`.
+> Dördü de `alert`'in `message`'ı gibi METİN ŞABLONUDUR (FLOW-022 hepsini denetler); çok dilli
+> uygulamada çeviri anahtarıyla yazılır:
+> `{ "type": "confirm", "args": { "message": "{{ t('risk.sil.onay') }}", "title": "{{ Row.name }} silinsin mi?",
+> "confirmText": "{{ t('sil') }}", "cancelText": "Vazgeç" } }`.
 
 > **Hangi yolu seçeceksin — adımın kendi `error` dalı mı, `errorSteps` mi, ana akışta
 > `condition` mı?** Bir hatada sırayla denenir (yukarıdaki 4xx bölümü) — üçü birden TANIMLI
@@ -528,6 +532,30 @@ Tarif: `platform_guide('middleware')`.
 - Adım hedef akışı **bekler** (`await engine.run`), sonra `always` dalından devam eder.
 - Gateway boş/yarım `args`'ı **FLOW-014** ile yakalar.
 
+**`validation` adımının kuralları `args.validations` dizisindedir** (kök ADR 0014). Her kural
+`{ id?, component, property, type, errorMessage, settings }`: `component` sayfadaki bileşenin
+**elementId**'si (boş → bileşensiz kural; sayfada olmayan ad 404), `property` okunacak prop
+(çoğunlukla `value`), `type` ∈ `required · email · regex · min-length · max-length · min-value ·
+max-value`, `errorMessage` düz metin ya da `t:` anahtarı (düşen alanın `invalidText`'ine yazılır),
+`settings` tek parametredir — runtime **ilk değeri** okur (`{ "value": 8 }`, `{ "pattern": "^\\d+$" }`;
+parametresiz tipte `{}`). Kurallar dizi sırasıyla koşar; kuralsız adım yükte `[]` döner ve her
+çalıştırmada `success`'e gider.
+
+```jsonc
+{ "stepId": "kontrol", "name": "kontrol", "type": "validation", "kind": "normal",
+  "args": { "validations": [
+      { "component": "email", "property": "value", "type": "email", "errorMessage": "t:validation.email", "settings": {} },
+      { "component": "sifre", "property": "value", "type": "min-length", "errorMessage": "En az 8 karakter", "settings": { "value": 8 } } ] },
+  "branches": [ { "id": "<GUID>", "name": "success", "nextStepId": "kaydet" },
+                { "id": "<GUID>", "name": "error",   "nextStepId": null } ] }
+```
+
+- `always` `success`/`error`'dan **sonra** da koşar — kaydetmeyi `always`'e bağlarsan düşen
+  formda da kaydeder.
+- Bu şekil komponentin kendi `validations`'ından (`set_validations { type, message, value }`)
+  farklıdır; `message`/`value` burada sessizce düşer. Tanınmayan `type` runtime'da **geçer** sayılır
+  (platform kümeyi doğrulamaz). Gateway ikisini de **FLOW-041** ile yakalar.
+
 > **`code` adımının gövdesi `args.value` alanındadır — düz JS metni olarak.** Runtime onu
 > `(async () => { <value> })()` içinde koşturur (`code.ts:18`), yani `await` serbesttir ve dönüş
 > değeri akışa taşınmaz; etkiyi `Page`/`state`/komponent yazarak üretirsin. **Alan boşsa adım
@@ -618,7 +646,7 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > **`platform_guide('functions')`**.
 >
 > **`share` adımı ("Share")** metin ve bağlantı paylaşır: `args: { title, message, path }`. `title`
-> DÜZ METİNDİR (ifade yazılırsa FLOW-022 uyarır); `message` ve `path` `storage.value` gibi
+> DÜZ METİNDİR — `{{ }}` şablonu da çözülmez (ifade ya da `{{ }}` yazılırsa FLOW-022 uyarır); `message` ve `path` `storage.value` gibi
 > İFADEDİR — düz metin tırnak ister (`"'Şuna bak'"`, `"'https://…/urun/' + Page.queryParams.id"`).
 > Bağlantının adı `url` DEĞİL `path`'tir: backend `Title`/`Message`/`Path` alanlarında saklar ve
 > tanımadığı anahtarı 200 ile sessizce düşürür (FLOW-035 `url`/`link`/`text`'i ve tırnaksız adresi
@@ -937,13 +965,16 @@ kapsayıcının kardeşi olarak yaşar (qm `[SY] Profil bilgilerim`: `page_conta
 > Bu tiplerde `size.h` gerçek yüksekliktir — göz kararı değil, içeriğe göre hesapla
 > (bir satır ≈ 10px; Kural 1f).
 
-## Kural 1d-2 — Sayfanın ve layout'un KENDİ olayları: `mount` · `destroy`
+## Kural 1d-2 — Sayfanın ve layout'un KENDİ olayları: `mount` · `destroy` (mobil sayfada + `focus`)
 
 Komponent olaylarından AYRI olarak sayfa ve layout kayıtları kendi olay listesini taşır
 (`events: [{ name, value: <flow id> }]`) ve geçerli adlar SABİTTİR: **`mount`**
 (yüklendiğinde) ve **`destroy`** (sayfadan/layouttan ayrılırken — runtime destroy akışlarını
-navigasyondan ÖNCE koşar). Başka ad platformca kabul edilir ama bağ sessizce ölü kalır —
-gateway **PAGE-011 / LAY-004** ile istek gitmeden reddeder.
+navigasyondan ÖNCE koşar). **Mobil uygulamanın SAYFASI** bir ad daha alır: **`focus`** — ekran
+her göründüğünde koşar (ilk açılışta `mount`'tan sonra, sonra yığından geri dönüşte ve sekme
+değişiminde; `platform_guide('mobile')`). Başka ad platformca kabul edilir ama bağ sessizce ölü
+kalır — gateway **PAGE-011 / LAY-004** ile istek gitmeden reddeder; `focus` layout'ta ve web
+sayfasında da reddedilir (web sayfayı her gezinmede baştan kurar, `mount` yeter).
 
 - Bağlama yolu `set_event` DEĞİLDİR (o komponent hedefler): sayfada `page_create` /
   `page_update`'in `events` parametresi, layout'ta `layout_create/update`'in `events`'i.

package/dist/resources/guides/translation.md

@@ -55,7 +55,8 @@ diye bir alan **hiç görünmez**; blok tam olarak bunu görünür kılmak için
 | Tool | Ne yapar |
 |---|---|
 | `translation_list` | Application'ın tüm `(language, key, value)` kayıtlarını düz liste döner |
-| `translation_update` | `keys` (ekle/güncelle, `componentId` opsiyonel) ve/veya `deletedKeys` (sil) — ikisi de aynı çağrıda verilebilir, en az biri dolu olmalı |
+| `translation_update` | `keys` (ekle/güncelle, `componentId` opsiyonel) ve/veya `deletedKeys` (sil) — ikisi de aynı çağrıda verilebilir, en az biri dolu olmalı. `file` kipi: doldurulmuş Excel'i içe aktarır (aşağıda) |
+| `translation_export` | Çevirmene verilecek Excel dosyasını yerel yola yazar (aşağıda) |
 | `project_update` | `languages`/`defaultLanguage` — proje dillerini kurar/değiştirir |
 
 ```jsonc
@@ -194,6 +195,45 @@ Runtime `t:` ile başlayan bir mesajı anahtar sayar ve normal zincirden çözer
 olduğu gibi gösterilir. Çözüm çalışma anında olduğu için şema varsayılanlarını değiştirmek
 gerekmez — `schema.ts`'e dokunulmaz, katalog yeniden yüklenmez.
 
+## Dosyayla toplu çeviri (Excel)
+
+İnsan bir çevirmene yeni bir dil yaptıracaksa: sözlük Excel'e iner, çevirmen hedef sütunu doldurur,
+dosya geri yüklenir. **Çeviriyi sen yapacaksan dosyaya gerek yok** — `translation_list` ile oku,
+`translation_update { keys }` ile yaz.
+
+```jsonc
+// 1. dışa aktar — dosya YALNIZ outPath'e yazılır, Sürücü'ye yüklenmez
+{ "applicationId": "<app id>", "targetLanguage": "es", "outPath": "C:/ceviri/crm-es.xlsx" }   // translation_export
+// → { keys: 120, targetMissing: 120, sourceLanguage: "en", note: "… TR-004 …" }
+
+// 2. çevirmen C sütununu doldurur; 3. önce kuru koşu
+{ "applicationId": "<app id>", "file": "C:/ceviri/crm-es.xlsx", "targetLanguage": "es", "dryRun": true }   // translation_update
+// → { created: 118, skippedEmpty: 2, unknownKeyCount: 0, targetLanguageInProject: false, note: "… ekleyecek …" }
+
+// 4. gerçek içe aktarma
+{ "applicationId": "<app id>", "file": "C:/ceviri/crm-es.xlsx", "targetLanguage": "es" }                   // translation_update
+// → { created: 118, languageAdded: true, … }
+```
+
+Dosya: tek sayfa, `A` Key · `B` kaynak dil (yalnız referans, okunmaz) · `C` hedef dil; başlıklar
+`Key` · `Default Language (EN)` · `Target Language (ES)`. İçe aktarma **başlık satırını okumaz**:
+değerler `translation_update`'in zorunlu `targetLanguage`'ındaki dile yazılır, `C1`'deki `(ES)` yalnız
+çevirmen içindir ve dili belirlemez. Gizli `_zeyrek`
+sayfası dosyanın hangi application'dan çıktığını söyler; başka bir application'ın dosyası yine
+yazılır ama yanıt `applicationMismatch: true` ve not taşır.
+
+- **Dolu hücre mevcut değeri ezer**, boş/boşluk hücre atlanır, hiçbir şey silinmez.
+- **Application'da olmayan key açılmaz** — `unknownKeys`'e düşer. Yeni key `keys` kipiyle açılır.
+- Key eşleşmesi önce birebir, yoksa büyük/küçük harf duyarsız tek aday; aynı key dosyada iki satırda
+  ise 422 ve hiçbir şey yazılmaz.
+- **Hedef dil projede yoksa içe aktarma onu projeye ekler — bütün ortamlara** (TR-004). Önce
+  `project_update` gerekmez; ama dil production'a da gider ve orada çeviriler deployment'la gelene
+  kadar runtime varsayılan dile düşer.
+- Dosya platformda **saklanmaz**: ne dışa aktarma ne içe aktarma Sürücü'ye bir şey bırakır.
+- Studio'nun çeviri panelindeki JSON içe aktarma bundan farklıdır: o yalnız boşları doldurur ve
+  projede olmayan dili atlar.
+- Sınırlar: `.xlsx` (`.xls`, csv, json reddedilir), 10 MB, 10.000 satır.
+
 ## Bilinen sınırlar
 
 - **Flow adımlarında Translation kaynağı YOK.** `value.type` sözlüğünde (`platform_guide('page')`

package/dist/resources/guides/workflow.md

@@ -286,7 +286,10 @@ Global-error dalında `error` değişkeni tanımlıdır:
 ```
 
 Fail dalında aynı zincir `<adım adı>.error.cause`'tadır (`<adım adı>.error` = `{ code, message, detail,
-type, cause }`).
+type, cause }`). Serbest `error` değişkenini YALNIZ global-error dalı kurar
+(`ActivityContext.EnterGlobalErrorHandling`): bağlı `fail` dalının hedefi `error.message` okursa
+`undefined` alır — orada `<adım adı>.error.message` / `.code` okuyun (WF-035 uyarır; hedef aynı zamanda
+global-error dalının hedefi olsa da).
 
 `error.step` hangi adımın patladığını söyler. `input`/`data` alanları ifade değerlerini ve adım
 çıktısını taşır — gövdeye yalnız ihtiyaç duyduğun alt kümeyi yaz (gateway'in varsayılanı
@@ -575,6 +578,33 @@ Tam örnek, ölçülen çıktı şekli ve `code` çocuğu tuzağının çıkış
 > `The JSON value could not be converted to System.Guid` ile reddetti. Geçerli önek harfleri
 > yalnız `a`–`f`'tir.
 
+## `file-upload` adımı: çıktı, dosya alanının tablo okuma biçimidir (K10, 2026-10-08)
+
+Adım `rule.fileString`'i (base64, JS ifadesi) `rule.folderId` klasörüne `rule.fileName` (JS ifadesi;
+boşsa GUID) adıyla yazar, dosyayı geri okur ve **tablo okumasının FILE alanında döndürdüğü nesneyi**
+üretir (`FileUploadStep.OutputSchema`; iki yol aynı `FilePathMapper`'ı kullanır):
+
+```json
+{
+  "id": "0199c3a2-7b1e-7c4d-9a10-3f2b8c6d5e41",
+  "path": "uploads/photo.png",
+  "absolute_path": "https://acme.example.com/dev/uploads/photo.png",
+  "type": "ref",
+  "value": "0199c3a2-7b1e-7c4d-9a10-3f2b8c6d5e41",
+  "fileName": "photo.png"
+}
+```
+
+- Sonraki adımlar **adım adı + `.data`** ile okur: adres `yukle.data.absolute_path`, kimlik
+  `yukle.data.id` (`value` aynı id'dir). `absolute_path` = uygulamanın dosya sunum ucu (org slug +
+  ortamın depolama öneki) + `/` + `path`; `path` boşsa `""`. Görsel için ikinci okuma gerekmez.
+- **Aynı içerik klasörde varsa** yeni dosya yazılmaz: `id`, adres ve `fileName` var olan dosyanındır.
+- **Mobil görsel:** `response` adımı nesneyi döndürür (`bodyExpression: "({ foto: yukle.data })"`),
+  sayfa akışı `Steps.<sayfa adımı>.data.foto`'yu `image.src`'ye verir — nesnenin kendisi ya da
+  `.absolute_path`; `.value` dosya kimliğidir, görsel çizilmez (`platform_guide('mobile')` §Dosya ve fotoğraf).
+- 2026-10-08'den eski backend imajı yalnız `{ id }` döndürür: `yukle.data.absolute_path` `undefined`
+  çıkıyorsa imaj bayattır. Kaynak: backend `FileUploadStepTests`; canlı koşuyla henüz ölçülmedi.
+
 ## Table step kuralları
 
 - `rule` içinde `datasourceId` + `entityId` zorunlu; `selectFields`/`filters` öğelerinde

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "63d0b9efc3b8d0c0d8ef9c8b7478b3abf8cb482e4e80276202b3faed73cedddf",
-  "generatedAt": "2026-10-08T09:32:48.956Z",
+  "hash": "1766032527c4215282c73fb003cbe3526babafabc8588b80289dc28fd4e8b393",
+  "generatedAt": "2026-10-12T12:46:03.355Z",
   "types": 337,
   "files": 167,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",

package/dist/tools/entities.js

@@ -26,6 +26,40 @@ function preserveApplicationBinding(definition) {
     if (applicationIds.length > 0)
         definition.applicationIds = applicationIds;
 }
+/**
+ * 37 S-1: platform PATCH op'larını `EntityDto` OKUMA şekline uygular (`PatchEntityCommandHandler` →
+ * `UpdateEntityCommand.FromDto`, `ApplicationIds = Applications.Select(a => a.ApplicationId)`). Bağ
+ * `/applications` yolunda `{ applicationId }` öğeleriyle yazılır; `/applicationIds` belgede yoktur
+ * (gateway önizlemesi `OPERATION_PATH_UNRESOLVABLE` ile düşer), çıplak guid 500 `JsonException`,
+ * `{ id }` boş `applicationId` ile "This record is in use" verir. Ajan yazma adını bilerek geldiği
+ * için reddetmek yerine çevrilir ve `gatewayNormalized` ile söylenir (microservice `/roleIds` emsali).
+ */
+function normalizeApplicationBindingOps(operations) {
+    const notes = [];
+    const asBinding = (entry) => {
+        if (typeof entry === 'string')
+            return { applicationId: entry };
+        if (entry && typeof entry === 'object' && !('applicationId' in entry) && typeof entry.id === 'string')
+            return { applicationId: entry.id };
+        return entry;
+    };
+    for (const operation of operations) {
+        const path = typeof operation.path === 'string' ? operation.path : '';
+        if (path === '/applicationIds' || path.startsWith('/applicationIds/')) {
+            operation.path = `/applications${path.slice('/applicationIds'.length)}`;
+            notes.push(`patch yolu '${path}' → '${operation.path}': yamalanan belge entity_get'in OKUMA şeklidir (EntityDto) ve uygulama bağı orada 'applications' [{ applicationId }] alanıdır; 'applicationIds' yalnız create/update GÖVDESİNDE vardır.`);
+        }
+        const target = operation.path;
+        if (target !== '/applications' && !target.startsWith('/applications/'))
+            continue;
+        const before = JSON.stringify(operation.value);
+        operation.value = target === '/applications' && Array.isArray(operation.value) ? operation.value.map(asBinding) : target.split('/').length === 3 ? asBinding(operation.value) : operation.value;
+        if (JSON.stringify(operation.value) !== before) {
+            notes.push(`'${target}' değeri { applicationId } öğesine çevrildi — çalışan şekil: { op: 'replace', path: '/applications', value: [{ applicationId: '<application id>' }] }.`);
+        }
+    }
+    return notes;
+}
 /**
  * `UpdateEntityCommandHandler` gövdedeki `Indexes` null ise onu BOŞ LİSTEYE çeviriyor
  * (`request.Indexes?…ToList() ?? []`) ve `Entity.FindProcessedIndexes` boş listede entity'nin
@@ -178,7 +212,7 @@ export function registerEntityTools(server, platform) {
     }));
     server.registerTool('entity_patch', {
         title: 'Entity\'ye patch uygula',
-        description: "YENİ alanı korumayla ya da türetilmiş alan olarak eklemek için de kullanılır (PROT-003/PROT-004); eklenen ya da kuralı değişen türetilmiş alanı dolu satırlarda derived-fill işi doldurur (tablo kilitlenmez, bitiş import_history { entityId }). VAR OLAN alanın korumasını değiştirmez — platform 400 ProtectionChangeNotAllowed döner, gateway istek göndermeden durdurur ve yol entity_protection_update'tir. Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut tanımı okur, yolları çözer ve op'ları platformun PATCH /entities/{id} ucuna `{ baseVersion, ops }` olarak geçirir — tam gövde PUT'u ATILMAZ, yalnız fark yazılır. Yanıt outline özetidir. YOLLARDA SEÇİCİ KULLANIN, indeks değil: '/fields[slug=email]/nullable' — indeksle yazmak alan sırası değişince SESSİZCE yanlış alanı yazar. Gateway seçiciyi indekse çevirir ve hangi kayda indiğini yanıttaki patchTargets ile söyler. `baseVersion` okunan kaydın `version` alanından gelir; kayıt bu arada değiştiyse platform 409 döner ve HİÇBİR op uygulanmaz. 'applications' → 'applicationIds' çevirisini artık platform yapar. `fields[].isLocalized: true` alanı ana tablodan çıkarıp companion `<slug>_localization` entity'sine taşır (yalnız düz METİN alanı; anahtar/unique/ilişki olamaz) — platform_guide('entity') §'Çoklu dilli alan'.",
+        description: "YENİ alanı korumayla ya da türetilmiş alan olarak eklemek için de kullanılır (PROT-003/PROT-004); eklenen ya da kuralı değişen türetilmiş alanı dolu satırlarda derived-fill işi doldurur (tablo kilitlenmez, bitiş import_history { entityId }). VAR OLAN alanın korumasını değiştirmez — platform 400 ProtectionChangeNotAllowed döner, gateway istek göndermeden durdurur ve yol entity_protection_update'tir. Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut tanımı okur, yolları çözer ve op'ları platformun PATCH /entities/{id} ucuna `{ baseVersion, ops }` olarak geçirir — tam gövde PUT'u ATILMAZ, yalnız fark yazılır. Yanıt outline özetidir. YOLLARDA SEÇİCİ KULLANIN, indeks değil: '/fields[slug=email]/nullable' — indeksle yazmak alan sırası değişince SESSİZCE yanlış alanı yazar. Gateway seçiciyi indekse çevirir ve hangi kayda indiğini yanıttaki patchTargets ile söyler. `baseVersion` okunan kaydın `version` alanından gelir; kayıt bu arada değiştiyse platform 409 döner ve HİÇBİR op uygulanmaz. UYGULAMA BAĞI '/applications' yolundadır ve öğeleri { applicationId } nesneleridir: {op:'replace', path:'/applications', value:[{applicationId:'<application id>'}]} — tam listeyi yazar; tek bağ eklemek {op:'add', path:'/applications/-', value:{applicationId:'<application id>'}}. '/applicationIds' yolunu ya da çıplak guid / { id } öğesini gateway bu şekle çevirir ve gatewayNormalized ile söyler; 'applications' → 'applicationIds' gövde çevirisini platform yapar. `fields[].isLocalized: true` alanı ana tablodan çıkarıp companion `<slug>_localization` entity'sine taşır (yalnız düz METİN alanı; anahtar/unique/ilişki olamaz) — platform_guide('entity') §'Çoklu dilli alan'.",
         inputSchema: { project: projectParam, environment: environmentParam, datasourceId: guid.optional().describe('Verilmezse gateway datasource ağacından bulur'), id: entityRef, operations: patchOperationsParam.optional(), ops: patchOperationsParam.optional().describe("'operations' ile aynı alan (eşanlamlı) — sayfa micro-op tool'larıyla aynı adı kullanabilmeniz için"), policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, datasourceId, id, operations: givenOperations, ops, policyOverride }) => {
@@ -187,7 +221,10 @@ export function registerEntityTools(server, platform) {
         const entity = datasourceId && isGuid(id) ? { entityId: id, datasourceId } : await resolver.entity(id);
         const current = await platform.tenant('GET', project, `/entities/${entity.datasourceId}/${entity.entityId}`, { environment });
         const definition = structuredClone((current?.data ?? current));
-        const resolvedOps = resolvePatchOperations(definition, operations, 'entity_get');
+        // Bağ yolu seçici çözümünden ÖNCE çevrilir: '/applicationIds' belgede yoktur (37 S-1).
+        const bindingOperations = structuredClone(operations);
+        const bindingNotes = normalizeApplicationBindingOps(bindingOperations);
+        const resolvedOps = resolvePatchOperations(definition, bindingOperations, 'entity_get');
         // Politika, yazmadan önce sonucu görmeli; yerel kopya YALNIZ değerlendirme için, gövde olarak gönderilmez.
         const preview = fastJsonPatch.applyPatch(definition, resolvedOps.operations, true, false).newDocument;
         const protectionChanges = changedExistingProtections(current?.data ?? current, preview);
@@ -208,7 +245,7 @@ export function registerEntityTools(server, platform) {
         });
         const written = patchResult(saved, preview);
         const touched = patchedSections(written.data, resolvedOps.operations);
-        return attachFindings(withUnmappedMembers(withResolved({
+        return attachFindings(withUnmappedMembers(withResolved(withNormalization({
             applied: operations.length,
             newVersion: written.newVersion,
             patchTargets: resolvedOps.targets,
@@ -216,7 +253,7 @@ export function registerEntityTools(server, platform) {
             // S-8: yazılanın kanıtı yanıtta dursun; dokunulmayan bölümler outline'da kalır.
             ...(Object.keys(touched).length > 0 ? { touched } : {}),
             outline: entityOutline(written.data)
-        }, resolver.resolved), drift), findings);
+        }, bindingNotes), resolver.resolved), drift), findings);
     }));
     server.registerTool('entity_protection_update', {
         title: 'Alan korumasını değiştir',

package/dist/tools/layouts.js

@@ -3,7 +3,7 @@ import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
 import { fillComponentNames, componentNameNote, normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
-import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode } from './screens.js';
+import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode, readFullSchema } from './screens.js';
 import { assertScreenWriteGuards, assertScreenCatalog } from './screenWrite.js';
 import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../knowledge/propTypes.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
@@ -58,24 +58,39 @@ export function registerLayoutTools(server, platform) {
     }));
     server.registerTool('layout_schema_get', {
         title: "Layout komponent ağacını oku",
-        description: "Layout'un komponent ağacını (views) okur — page_schema_get'in layout karşılığı. Ağaçta hedefli değişiklik için layout_schema_patch (sayfa ile aynı micro-op sözlüğü, PATCH /layouts/{app}/{id}/schema). Ad/parametre/olay alanlarında ya da düz JSON Patch yolu gerektiğinde layout_patch — o araç buradaki updatedAt'i expectedUpdatedAt olarak kabul eder. Tam ağacı kendiniz yazacaksanız layout_update.",
+        description: "Layout'un komponent ağacını (views) okur — page_schema_get'in layout karşılığı. Ağaçta hedefli değişiklik için layout_schema_patch (sayfa ile aynı micro-op sözlüğü, PATCH /layouts/{app}/{id}/schema). Ad/parametre/olay alanlarında ya da düz JSON Patch yolu gerektiğinde layout_patch — o araç buradaki updatedAt'i expectedUpdatedAt olarak kabul eder. Tam ağacı kendiniz yazacaksanız layout_update. full ve subtree yanıtı nodeCount taşır; full tek yanıta sığmazsa HATA döner (sessiz kırpma yok): cursor:'0' ile parça parça okuyun — page_schema_get ile aynı sözleşme (items[] { parentElementId, index, node }, nextCursor bitene kadar; layout okuma arasında değişirse 409). allowTruncated:true kırpılmış gövdeyi açıkça verir — o gövdeyi layout_update'e geri yazmayın.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
             applicationId: guid,
             id: guid,
-            mode: modeParam,
-            componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si")
+            mode: modeParam.describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm views; tek yanıta sığmazsa HATA döner — cursor:'0' ile parça parça okuyun (nextCursor bitene kadar) ya da allowTruncated:true ile kırpılmış gövdeyi açıkça isteyin."),
+            componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si"),
+            cursor: z.string().min(1).optional().describe("Yalnız mode:'full': parçalı okuma. İlk çağrıda '0', sonra yanıttaki nextCursor; nextCursor gelmeyince views bitmiştir. Layout okuma arasında değişirse (updatedAt) 409 döner — cursor:'0' ile baştan başlayın."),
+            allowTruncated: z.boolean().optional().describe("Yalnız mode:'full': true verilirse sığmayan views hata yerine kırpılarak döner (nodeCount toplamı söyler, düşen düğümler söylenmez). Varsayılan false.")
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationId, id, mode, componentId }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, mode, componentId, cursor, allowTruncated }) => {
         const layout = await fetchHost(platform, 'layout', project, environment, applicationId, id);
         const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
         const audit = layout.audit;
         const updatedAt = audit?.updatedAt ?? audit?.createdAt;
         const views = (layout.views ?? []);
-        if (mode === 'full')
-            return { updatedAt, ...typeField, views };
+        if (cursor !== undefined && mode !== 'full') {
+            throw new PlatformApiError(`cursor yalnız mode:'full' ile çalışır (verilen mode: '${mode ?? 'summary'}'); parçalı okuma tüm views içindir. mode:'full' ile cursor:'0' verin ya da cursor'ı kaldırın.`, 400);
+        }
+        if (mode === 'full') {
+            return readFullSchema({
+                noun: 'Layout',
+                field: 'views',
+                nodes: views,
+                versionKey: String(updatedAt ?? ''),
+                base: { updatedAt, ...typeField },
+                cursor,
+                allowTruncated,
+                maxResponseBytes: config.maxResponseBytes
+            });
+        }
         if (mode === 'subtree') {
             if (!componentId)
                 throw new PlatformApiError("mode='subtree' için componentId zorunludur.");

package/dist/tools/mobile.js

@@ -49,6 +49,7 @@ export function buildMobileAppPlan(input) {
     ];
 }
 /** Kabuk ağacı örnek dosyasından okunur — örnek ile aracın kurduğu layout tek kaynaktır. */
+const drawerButtonId = (pageSlug) => `menu_${pageSlug.replace(/[^A-Za-z0-9]+/g, '_')}`;
 function shellViews(input) {
     const example = JSON.parse(readKnowledgeFile('examples', input.drawer ? 'mobile-app-shell-drawer.json' : 'mobile-app-shell-stack.json'));
     const views = structuredClone(example.layoutCreate.views);
@@ -57,6 +58,19 @@ function shellViews(input) {
     const appBar = findAppBar(views);
     if (appBar && input.title)
         appBar.props.title = { type: 'static', ref: null, data: input.title };
+    // 37 S-9 / g-24: örneğin düğmeleri ŞABLONDUR; çekmece uygulamanın kendi sayfalarından birer düğme taşır.
+    const drawer = views.find(node => node.type === 'drawer');
+    const template = drawer?.children?.find(node => node.type === 'button');
+    if (drawer && template) {
+        drawer.children = input.pages.map(page => {
+            const elementId = drawerButtonId(page.pageSlug);
+            const button = structuredClone(template);
+            button.elementId = elementId;
+            button.name = elementId;
+            button.props = { ...button.props, text: { type: 'static', ref: null, data: page.pageName } };
+            return button;
+        });
+    }
     return views;
 }
 const SHELL_TYPES = ['app-bar', 'slot'];
@@ -274,7 +288,7 @@ export function registerMobileTools(server, platform) {
             ...(tabs ? { tabs: tabs.map(tab => tab.pageSlug) } : {}),
             completed,
             ...(warnings.length > 0 ? { warnings } : {}),
-            next: "Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). platform_guide('mobile')."
+            next: `Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). ${input.drawer ? `Çekmece düğmeleri sayfalardan türedi (${pages.map(page => drawerButtonId(page.pageSlug)).join(', ')}): her birine flow_create (host: 'layout', redirect) + layout_schema_patch set_event { event: 'click' } bağlayın. ` : ''}platform_guide('mobile').`
         };
     }));
 }