@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

package/dist/resources/guides/expressions.md

@@ -97,11 +97,11 @@ dalından devam eder.
 
 | Global | İçerik |
 |---|---|
-| `Page` | `Page.user`, `Page.variables`, `Page.components`, `Page.properties`, `Page.queryParams`, `Page.authorized(roles)` |
-| **Komponent adları** | Her komponent adıyla doğrudan değişkendir: `specialties_table.rows = data` hem prop'u yazar hem UI'ı günceller (change event). Addaki `-` silinir: `tickets-table` → `ticketstable` |
+| `Page` | `Page.user`, `Page.variables`, `Page.components`, `Page.properties`, `Page.queryParams`, `Page.authorized(roles)`, `Page.language` (etkin dil kodu, salt okunur), `Page.setLanguage(kod)` (dili değiştirir: seçim saklanır, bütün bağlar yeni dilde çözülür; projede olmayan kod yok sayılır — 2026-10-14 frontend, uzak kurulumda dağıtımdan sonra; ARC-097/098) |
+| **Komponent adları** | Her komponent adıyla doğrudan değişkendir: `specialties_table.rows = data` prop'u yazar ve UI'ı günceller. Çeviriye bağlı prop **ekrandaki metinle** okunur, iç içe dizilerdekiler dahil (`menu.navigations[0].title`, `drawer.actions[0].text`); okunan diziyi aynı metinle geri yazmak çeviri bağını korur (2026-10-14 frontend, uzak kurulumda dağıtımdan sonra — öncesinde okuma `null` verirdi); `setter` adımı gibi bileşenin `change` akışını **koşturmaz** — `change` akışı yalnız kullanıcı etkileşiminde koşar (2026-10-08; öncesindeki runtime her kod yazımında `change` akışını koştururdu). Addaki `-` silinir: `tickets-table` → `ticketstable` |
 | `state.page` / `state.app` | Sayfa/uygulama state'i (oku/yaz): `state.page.selectedId = row.id`. **Bellekte yaşar** — sayfa her açıldığında tanımlı `value`'dan başlar; mobil uygulamada kalıcı olması için değişkene `storage` verilir (`platform_guide('mobile')` §Kalıcı state). **Tanımlı değişkenler de buradadır:** `variable_create` ile yazılan her `key` sayfa düzeyinde `state.page.<key>`, uygulama düzeyinde `state.app.<key>` olur; `value` nesneyse alanlarına inilir (`state.page.MyTest.isActive`) |
-| `Steps` | Adım çıktıları: `Steps.load_specialties` — anahtar adımın **ADIdır**, `stepId` değil (`setStorage(task.name, …)`); `Steps.<adım>.error` o adımın hatası — ama YALNIZ HTTP durum metnidir (401 için `'Unauthorized'`), ucun mesajı değil. `Steps.error` ise hata akışı için doldurulur (`onError` koşmadan önce `setStorage('error', …)` yapar) ve **yalnız orada okunur**: storage sayfa başına tek `FlowMachine`'de yaşar, ama dışarıdan başlayan her akış başlarken `'error'`'u ve kendi adımlarının önceki değerlerini temizler (`flow-engine.ts` `run`, 2026-09-25) — normal akışta `Steps.error` boştur; hata akışı ve onun tetiklediği akış (`nested`) onu görür ve şekli `{ message, code, step: { id, name, type, data } }`'dir: kullanıcıya gösterilecek metin `Steps.error.message`'tır (`err.response.data.message`, boşsa durum metni). **Başarılı bir adımda `Steps.<adım>.data` gerçek bir `Array`'dir** — `.map` · `.filter` · `.concat` · `.length` çalışır. Adım HATA dönerse aynı alan ucun hata gövdesini taşır; aşağıdaki kutuya bakın |
-| `self` · `item` · `Row` / `RowIndex` | Tetikleyen komponent (yazılabilir) · repeater/tablo satırı (yazmak YALNIZ o satırı günceller). Satır AKIŞINDA (satırdaki düğümün olayı) ARC-121 düzeltmesini (2026-09-27) taşıyan runtime gerekir, eskisinde boştu — sürümden bağımsız yol `<liste>.selectedItem` / `.selectedIndex`. Tekrarlayıcının KENDİ `change`/`select` akışında satır bağlamı yoktur. `item.x = …` yazımı tekrarlayıcının `change` olayı olarak iletilir: `change`'e bağlı akış her yazımda koşar, o akış da `item`'a yazarsa döngü olur |
+| `Steps` | Adım çıktıları: `Steps.load_specialties` — anahtar adımın **ADIdır**, `stepId` değil (`setStorage(task.name, …)`); `Steps.<adım>.error` o adımın hatası: `{ status, message, body }` — `message` ucun kendi mesajı (`err.reason`, boşsa HTTP durum metni), `status` HTTP kodu, `body` ucun hata gövdesi (`microservice.ts` `.catch`; tablo `platform_guide('page')`). `Steps.error` ise hata akışı için doldurulur (`onError` koşmadan önce `setStorage('error', …)` yapar) ve **yalnız orada okunur**: storage sayfa başına tek `FlowMachine`'de yaşar, ama dışarıdan başlayan her akış başlarken `'error'`'u ve kendi adımlarının önceki değerlerini temizler (`flow-engine.ts` `run`, 2026-09-25) — normal akışta `Steps.error` boştur; hata akışı ve onun tetiklediği akış (`nested`) onu görür ve şekli `{ message, code, step: { id, name, type, data } }`'dir: kullanıcıya gösterilecek metin `Steps.error.message`'tır (`err.response.data.message`, boşsa durum metni). **Başarılı bir adımda `Steps.<adım>.data` gerçek bir `Array`'dir** — `.map` · `.filter` · `.concat` · `.length` çalışır. Adım HATA dönerse `Steps.<adım>.data` `null`'dır, gövde `.error.body`'dedir; aşağıdaki kutuya bakın |
+| `self` · `item` · `Row` / `RowIndex` | Tetikleyen komponent (yazılabilir) · repeater/tablo satırı (yazmak YALNIZ o satırı günceller). Satır AKIŞINDA (satırdaki düğümün olayı) ARC-121 düzeltmesini (2026-09-27) taşıyan runtime gerekir, eskisinde boştu — sürümden bağımsız yol `<liste>.selectedItem` / `.selectedIndex`. Tekrarlayıcının KENDİ `change`/`select` akışında satır bağlamı yoktur. `item.x = …` yazımı da aynı kuraldadır: o satırı günceller, tekrarlayıcının `change` akışını koşturmaz |
 | `event` | `{name, data, source: {id, props}}` |
 | `cookie` | `cookie.get(name)` / `cookie.set(name, value, {expiresInHours, path})` / `cookie.remove(name)` — tarayıcı cookie'si |
 | `setComponentProperty(name, key, value)` / `getComponentProperty(name, key)` | fonksiyon alternatifi |
@@ -116,9 +116,10 @@ dalından devam eder.
 > **`.map is not a function` bir dizi sözleşmesi sorunu DEĞİL, düşmüş bir adımdır.**
 > Ölçüldü 2026-09-05 (`f09-repro/probe`, yerel kurulum): başarılı bir microservice adımında
 > `Steps.<adım>.data` `[object Array]`'dir, `Array.isArray` true döner ve `.map`/`.filter`/
-> `.concat` çalışır. Adım hata döndüğünde (401, 500, geçersiz parametre) motor aynı alana ucun
-> **hata gövdesini** yazar — o bir nesnedir, dizi metodları yoktur ve
-> `(Steps.x.data || []).map is not a function` tam olarak burada çıkar. 2026-09-05 koşusunda
+> `.concat` çalışır. Adım hata döndüğünde (401, 500, geçersiz parametre) eski runtime aynı alana ucun
+> **hata gövdesini** yazıyordu — o bir nesnedir, dizi metodları yoktur ve
+> `(Steps.x.data || []).map is not a function` tam olarak burada çıkıyordu. Bugünkü runtime `data`'yı
+> `null` yazar ve gövdeyi `Steps.<adım>.error.body`'ye taşır (`|| []` koruması artık yeter). 2026-09-05 koşusunda
 > boş kalan şirket filtresinin sebebi buydu: adım korumalı bir uca 401 ile düşmüştü.
 > **Teşhis sırası:** önce `Steps.<adım>.error`'a bak, sonra ifadeyi suçla. Bir dizi bekliyorsan
 > `Array.isArray(Steps.<adım>.data)` ile koru; boş listeye düşmek, hata gövdesi üzerinde

package/dist/resources/guides/merge.md

@@ -17,11 +17,12 @@ onaylıdır**. Buradaki tool'ların hiçbiri production'a yazmaz.
 environment_create {projectId, name}        → 202, dal "creating"
 environment_list   {projectId}              → state "ready" olana kadar (30-60 sn)
 … tenant tool'larını environment: "<dal>" ile çağır (page_schema_patch, entity_patch, …)
-merge_plan   {projectId, sourceEnvironmentId} → 202, plan "planning"
+merge_plan   {projectId, sourceEnvironmentId, title} → 202, plan "planning" (title ZORUNLU)
 merge_get    {projectId, planId}              → status "planned" olana kadar
 merge_get    {projectId, planId, view:"conflicts"} → çakışanları oku
-merge_resolve{projectId, planId, resolutions[]}   → her çakışmaya source|target seç
-merge_apply  {projectId, planId, message}         → 202  (message ZORUNLU)
+merge_get    {projectId, planId, checks:true}       → merge öncesi doğrulama (uyarılar)
+merge_resolve{projectId, planId, resolutions[]}   → source | target | both | custom
+merge_apply  {projectId, planId}                  → 202
 merge_get    {projectId, planId}                  → status "applied"
 environment_list {projectId}                      → dal listede yok, şeması düştü
 ```
@@ -94,7 +95,9 @@ değişkenler, çözülen ref'ler) kareyi tamamlar: kare ne çizildiğini, bu ik
 - `kind`: `add` | `update` | `delete` | `conflict`
 - `dataRisk`: entity kaleminde veri riski var — **sebep `dataRiskReasons[]` içindedir**
 - `derivedFromKey`: kalem OTOMATİK ÜRETİLMİŞ bir kayıtsa (varsayılan DTO) kaynağının anahtarı
-- `elements[]`: `path`, `kind`, `base`, `source` (dal), `target` (development), `resolution`
+- `elements[]`: `path`, `kind`, `base`, `source` (dal), `target` (development), `resolution`. Açık bir elemanda
+  `resolution` hiç gelmez: gateway null alanları düşürür, yani alanın yokluğu "karar verilmedi" demektir.
+  `ownerElementId`: yolu bileşeni adlandırmayan widget prop'unun (`widgetComponentProps[id=…]`) bileşeni
 
 `dataRisk` bir **uyarıdır, apply'ı bloklamaz**; dört sebepten biriyle doğrudur:
 
@@ -144,8 +147,83 @@ bir merge'de entity ve onun varsayılan DTO'su böylece zıt çözülemez.
 { "itemKey": "page:8f1c…", "path": "components[elementId=btn_save].props[name=label].ref", "choice": "source" }
 ```
 
-`path` boş bırakılırsa o kaydın **tüm** çakışmaları aynı tarafa çözülür. `source` = dal,
-`target` = development.
+`path` boş bırakılırsa o kaydın **tüm** çakışmaları aynı karara çözülür.
+
+| `choice` | Ne yazılır | Ne zaman |
+|---|---|---|
+| `source` | dalın değeri | dal haklı |
+| `target` | development'ın değeri | development haklı |
+| `both` | iki tarafın birleşimi: development'ın listesi + dalın ekledikleri − dalın sildikleri. Development aynı öğeyi zaten eklediyse ikinci kez eklenmez | yalnız `combinable: true` elemanda (kimliksiz ya da gruplu liste); skalerde 400 |
+| `custom` | `value`'daki değer | iki taraf da tam doğru değil. `value` ZORUNLU, türü `source`/`target` ile aynı olmalı. Kök yolda kaydın gövdesidir, `order-conflict`'te kimlik listesidir. Yolsuz `custom` yalnız kaydın tek çakışması varken kabul edilir |
+
+```json
+{ "itemKey": "page:8f1c…", "path": "components[elementId=btn_save].props[name=label].ref", "choice": "custom", "value": "Siparişi kaydet" }
+```
+
+Varsayılan DTO (`derivedFromKey`) ve alanları (`derivedFromPath: fields[id=…]`) kaynağının kararını kendiliğinden
+alır. `both` kendi listesiyle yeniden birleştirilir, `custom` yalnız üç taraf aynıysa geçer. Kaynağına zıt
+çözmek 400 döner.
+
+Sayfa/layout/widget'ın **dizi prop'u** (ör. dropdown `options`) planda iki kez görünür: okunur liste `….ref` ve
+runtime'ın çizdiği satırlar `….children`. **Kararı `ref`'e verin**; `children` onu kendiliğinden izler. Bir taraf
+seçimi aynen geçer; `both` ve `custom` satırlara listeden yeniden kurulur. `children`'a ayrı ve farklı karar vermek
+ekranda listenin değil satırların çizilmesine yol açar.
+
+**Nesne prop'unda** (butonun `icon`'u, `surfaceStyle`) aynı kural anahtar düzeyindedir: anahtarın değeri
+`….ref.<anahtar>…`, runtime'ın çizdiği satırı `….children[name=<anahtar>]…`. İki taraf aynı anahtara farklı yazdıysa
+ikisi de çakışma gelir; **kararı `ref.<anahtar>`'a verin**. Satır karar istemez ve `summary.unresolved`'a girmez:
+merge onu değerin birleşik hâlinden kurar (`custom` dahil). Farklı anahtarlara yapılan değişiklikler kendiliğinden birleşir. Koşu 46 S-9:
+iki ayrı karar kabul ediliyor, sayfa satırınkini çiziyordu.
+
+Bir taraf prop'un **tipini** değiştirdiyse (`valueType`: `static` → `code`) ve öbür taraf da tipine ya da değerine
+dokunduysa (tipler farklı kalır) eleman prop'un kendisidir: yol `…props[id=…]` (widget'ta `widgetComponentProps[id=…]`), `base`/`source`/`target` prop gövdesi,
+`combinable: false`. Tip ile değer tek karardır; ayrı karar verilseydi düz metin kod olarak çalışabilirdi.
+`custom`'da `value` prop gövdesidir, kimliği sunucu yoldan yazar; statik listenin satırlarını (`children`) da `ref`'ten
+sunucu kurar, gönderilen `children` kullanılmaz:
+
+```json
+{ "itemKey": "page:8f1c…", "path": "components[elementId=btn_save].props[id=01a1…]", "choice": "custom",
+  "value": { "name": "text", "type": "primitive", "valueType": "code", "ref": "{{ 'Kaydet ' + Page.variables.adet }}", "children": [] } }
+```
+
+Kopyada `target`, dalın kopyasından türemiş DTO alanını da düşürür. `source` ise development'ın ikizinden türemiş
+DTO alanını siler.
+
+### Olası kopya: `kind: "duplicate"`
+
+İki taraf **aynı içeriği farklı kimlikle** eklediyse (iki `telefon` alanı, aynı girişi taşıyan iki bileşen) eleman
+`duplicate` gelir; `twinPath` development'taki ikizdir. `combinable: true` olan kopya **engellemez**: çözümsüz
+bırakılırsa ikisi de yazılır (git'in varsayılanı).
+
+Kopyalar **`slug` taşıyorsa** (tablo alanı = kolon, sayfa = rota) ikisi birden kalamaz: eleman `combinable: false`
+gelir, `summary.unresolved`'a sayılır ve birini seçene kadar apply edilmez; `both` 400 döner. Gerçek uçta ikisini
+tutan apply "column already exists" ile düştü.
+
+- `target`: development'ınki kalır, dalın eklemesi düşer.
+- `source`: dalınki kalır, development'ın ikizi çıkar.
+- `both`: ikisi de kalır (yalnız `combinable: true`).
+- `custom`: tek öğe yazılır. `value` öğenin gövdesidir; kimliği development'ınkine çevrilir.
+
+Development tabanda **zaten olan** bir alanı dalın eklediği slug'a yeniden adlandırdıysa dalın alanı da kopya gelir:
+`twinPath` yeniden adlandırılan alandır ve **`base` doludur** (o alanın taban hâli). Bu kopyada `source` 400 döner —
+development'ın alanı veri taşır, dalınki onun yerine geçemez; `target` (dalınki düşer) ya da `custom` seçin. Koşu 46
+S-8: ikisi de yazılıyor, apply kolon çakışmasıyla düşüyordu.
+
+Ayarı farklı, aynı adlı iki öğe kopya **sayılmaz**; ikisi ayrı eklenir ve doğrulamada `name-clash` uyarısı olarak
+görünür. İki istisna: **tablo alanında slug** (kolon adı) ve **bileşen prop'unda ad** tekildir. Ayarı farklı olsa da
+aynı slug'lı alan ya da aynı adlı prop eklemesi `combinable: false` kopyadır. Aynı adlı ama slug'ı farklı iki alan
+yine ayrı eklenir.
+
+### Merge öncesi doğrulama: `merge_get {checks: true}`
+
+| Kod | Seviye | Anlamı |
+|---|---|---|
+| `unresolved` | error | çözülmemiş çakışma ya da `slug` taşıyan çözümsüz kopya; apply 409 döner. Dizi prop'unun `children`'ı `ref` açıkken, nesne prop'unun satırı (`children[name=…]`) değeri çakışırken, türetilmiş DTO elemanı kaynağı açıkken ayrı satır almaz ve `summary.unresolved`'a girmez: kaynağı çözünce kendiliğinden çözülür |
+| `duplicate-open` | warning | çözümsüz kopya (`combinable: true`), ikisi de yazılacak |
+| `name-clash` | warning | birleşik gövdede aynı adla iki kardeş (örneğin iki `telefon` sütunu) |
+| `dangling-reference` | warning | merge'ün sildiği ya da kopya kararında düşen bir kimliğe hâlâ başvuru var |
+
+Uyarılar apply'ı engellemez; ama okunmadan `merge_apply` çağrılmaz.
 
 `merge_resolve` **özet döner** — `{ planId, status, summary, resolved }`. Planın kendisi yanıtta
 yoktur; kalan çakışmalar için `merge_get {planId, view:"conflicts"}` çağırın.
@@ -156,30 +234,31 @@ yoktur; kalan çakışmalar için `merge_get {planId, view:"conflicts"}` çağı
 | Durum | Kod | Ne yapmalı |
 |---|---|---|
 | Çözülmemiş çakışma var | 409 | `merge_get view:"conflicts"` → `merge_resolve` → tekrar `merge_apply` |
-| Development plan alındığından beri değişti | 409 | `merge_plan` ile **yeniden planla**; eski planı uygulama |
+| Dal ya da development plan alındığından beri değişti (`isStale`) | 409 | `merge_refresh`; değişmeyen elemanların kararları korunur, değişenler yeniden sorulur |
 | Plan 24 saatten eski | 400 | yeniden planla |
 
 Aynı `merge_apply` çağrısını tekrarlamak sonucu değiştirmez — 409 geçici bir hata değildir.
 
-## Mesaj zorunludur
+## Başlık zorunludur
 
-`merge_apply` mesajsız çalışmaz. Mesaj plana yazılır, plan uygulandıktan sonra da durur ve
-geçmişte bu mesajla görünür — git'teki merge commit mesajının karşılığıdır.
+İsteğin adı **plan açılırken** `merge_plan`'ın `title` alanında verilir; `merge_apply` ve `merge_revert` ayrı bir
+mesaj almaz. Başlık plana yazılır, uygulandıktan sonra da durur ve geçmişte bu adla görünür — git'teki merge
+request başlığının karşılığıdır.
 
-- Boş ya da yalnız boşluktan oluşan mesaj **şema katmanında** reddedilir; istek platforma hiç gitmez.
-- En fazla 200 karakter.
+- Boş ya da yalnız boşluktan oluşan başlık **şema katmanında** reddedilir; istek platforma hiç gitmez.
+- En fazla 100 karakter.
 - Kalıp: `<dal> → development: <amaç>`. Ne yaptığını yaz, "merge" yazma.
 
-Gateway senin yerine mesaj **uydurmaz**: ne değiştirdiğini bilen sensin.
+Gateway senin yerine başlık **uydurmaz**: ne değiştirdiğini bilen sensin.
 
 ## Geri almak
 
 Uygulanmış bir merge silinmez, **ters bir planla** geri alınır:
 
 ```
-merge_revert {projectId, planId, message}   → 202, ters plan planning
+merge_revert {projectId, planId}            → 202, ters plan planning
 merge_get {projectId, planId: <ters plan>}  → status planned olana kadar
-merge_apply {projectId, planId: <ters plan>, message}
+merge_apply {projectId, planId: <ters plan>}
 ```
 
 Bittiğinde ters plan `applied`, kaynak plan `reverted` olur; ikisi de geçmişte durur.
@@ -220,7 +299,7 @@ merge_list {projectId, environmentId:"<env>"}   → o environment'ı kaynak ya d
 ```
 
 `items[]` bu uçta **her zaman boştur** — bir planın değişiklik listesi için `merge_get`.
-Satırda `message`, `createdBy` (planı alan), `appliedBy` (uygulayan), `appliedAt` ve
+Satırda `title`, `description`, `createdBy` (planı alan), `appliedBy` (uygulayan), `appliedAt` ve
 `summary` sayaçları gelir. Sayfalama `pageIndex` / `pageLength` ile.
 
 Bir kaydın neden değiştiğini ararken sıra: `merge_list status:"applied"` → ilgili satırın
@@ -262,5 +341,6 @@ plan `applied` kalır.
 - Merge sürerken dal ve development'a yazma kilitlidir; **diğer dallar etkilenmez**.
 - Proje başına açık dal sayısı sınırlıdır (varsayılan 5) — sınır bağlantı bütçesidir, ürün kararı
   değil.
-- Dal adı `^[a-z][a-z0-9_]{2,30}$` kuralına uyar ve şema adı olur; `development`, `production`,
-  `public`, `pg_*` gibi adlar rezervedir.
+- Dal adı küçük harfle başlar; küçük harf/rakam/alt çizgi/tire ve `/` ile ayrılmış parçalardan oluşur
+  (ör. `feature/odeme`), 3-31 karakterdir ve şema adı olur. Adres parçası (slug) `/` yerine `-` taşır;
+  `development`, `production`, `public`, `pg_*` gibi adlar rezervedir.

package/dist/resources/guides/microservice.md

@@ -25,7 +25,7 @@ söyler. Hiçbir kural zorlamaz — ucun gerçek bir tuzağı yoksa alanı hiç
 - **Sessiz boş dönüş** — "filtre eşleşmezse 404 değil boş dizi döner"
 
 ```jsonc
-{ "name": "urun-listesi", "httpMethod": "Get",
+{ "name": "urun-listesi", "httpMethod": "get",
   "description": "Aktif ürünleri ada göre sıralı döner.",
   "caution": "Sayfalama yok; katalog büyüdükçe yanıt boyutu doğrusal büyür." }
 ```
@@ -534,8 +534,8 @@ hem `joins` ile getirin hem `selectFields`'a koyun; ondan sonra `filters[0][fiel
 > 2026-09-06 koşusunda dokuz uç kuruldu ve dokuz patch çağrısının dokuzu da yalnız bu yolu yazdı
 > (~3 dk). Alan create gövdesinde zaten kabul ediliyor.
 
-> Sayfa tarafındaki karşılığı: kullanıcı ekrandan süzüyorsa (`table` + `filterMode` açık, ya da
-> `datatable` + `isFilterable` kolonlar) uç `enableDynamicFilters: true` olmalı; komponent seçilen
+> Sayfa tarafındaki karşılığı: kullanıcı ekrandan süzüyorsa (`datatable` + `isFilterable`
+> kolonlar) uç `enableDynamicFilters: true` olmalı; komponent seçilen
 > koşulları kendi `filters` prop'una yazar ve akış onu uca `filters` parametresi olarak geçirir.
 > Süzme yoksa statik query-string filtreleri yeterlidir — bkz. `platform_guide('page')` Kural 1e.
 

package/dist/resources/guides/middleware.md

@@ -297,6 +297,8 @@ değişkenlerini `Page.variables` olarak taşır; tarayıcıda ve cihazda okunur
   **`rule.isPrivate: true`** ver (Studio: "Sunucuda tut"). Aynı istekteki sonraki middleware'ler
   onu okumaya devam eder; istemciye gitmez. Sayfanın akışları istemcide koşar ve `Page.variables`'ı
   okur — işaretli değişken orada `undefined`'dır; akışın ihtiyaç duyduğu alanı işaretleme.
+  `IsPrivate` değişken Studio otomatik tamamlamasında önerilmez ve `workflow_middleware_variables`
+  çıktısında da yer almaz (sonraki middleware'in editörü dahil).
 - İstemcinin gerçekten ihtiyaç duyduğu alanları ayrı, işaretsiz bir değişkende **izin listesiyle**
   kur (yukarıdaki `settings`). Aynı ad sonra işaretsiz bir adımla yeniden yazılırsa istemciye açılır.
 - Yalnız microservice uçlarına bağlı middleware'de değişken yanıtla dönmez; işaret yine de zararsızdır.

package/dist/resources/guides/mobile-layout.md

@@ -7,7 +7,8 @@ Bir mobil ekran kurmadan önce bunu okuyun. Buradaki kurallar zevk meselesi değ
 - **Yazımda uyarı.** Yazım yanıtında sözleşme dışı durum `MOB-015…021` olarak gelir (`layoutWarnings`).
 - **Çizimde ölçüm.** `page_screenshot({ layoutReport: true })` sonucu sayıyla ölçer (`layoutSummary.alignment`).
 
-Temel mobil bilgi (flex-only yerleşim, tipli stil, gezinme, adımlar) için `platform_guide('mobile')`.
+Temel mobil bilgi (flex-only yerleşim, tipli stil, gezinme) için `platform_guide('mobile')`, cihaz adımları için
+`platform_guide('mobile-steps')`.
 Altın örnek: `ngapps://examples/mobile-form-screen`.
 
 ## Sözleşme

package/dist/resources/guides/mobile-publish.md

@@ -71,6 +71,7 @@ metni yeni numarayla yeniden dener.
 | P-11 | push (yalnız `testflight` / `internal`): `warn push_incomplete` (kimlik eksik — derleme push'suz çıkar); `push_unreadable` (kimliğin şifresi çözülemiyor), `push_profile_stale` (profil APNs anahtarından önce üretilmiş), `push_firebase_mismatch` (`google-services.json` başka Firebase projesinin), `push_package_mismatch` (dosya yüklendikten sonra Android paket adı değişmiş), `push_shell_outdated` (kabuk paketi push taşımıyor) | Studio › Yayın › Hesaplar ve kimlik bilgileri (insan yükler); `push_profile_stale`: profili yeniden üret; `push_shell_outdated`: platform ayarı (destek). Push kapalı ya da hazırsa satır `ok`'tur ve dryRun'da görünmez — hazır olduğunu `mobile_store_get { manifest: true }` → `manifest.push` söyler |
 | P-12 | izinler: `warn permissions_shell_outdated` (yayındaki kabuk izin kümesini taşımıyor: sabit izinler bildirilir, kamera çalışmaz, kipler uygulanmaz — başka P-12 satırı çıkmaz); kabuk taşıyorsa `fail permission_off_in_use` (kip `off` ama production o izni yazılı olarak kullanıyor) ya da `warn launch_permissions_shell_outdated` (açılışta sorulan izin var, kabuk açılışta sormuyor; kabuk kümeyi de taşımıyorsa bu cümle ilk uyarının iletisine eklenir) | `mobile_store_update { settings: { permissionModes } }` ya da kullanımı kaldırıp dağıtım; açılış uyarısında daha yeni kabuk ya da izni akış adımından isteme |
 | P-13 | reklam (yalnız `ads.enabled`): `warn ads_app_id_missing` (bu platformun AdMob App ID'si yok — derleme reklamsız çıkar), `warn ads_shell_outdated` (yayındaki kabuk reklam taşımıyor), yükleme hedefinde `manual ads_test_mode` (test kipi açık: mağazada test reklamı görünür), değilse `ok ads_ready` (yerleşim sayısıyla) | `mobile_store_update { settings: { ads } }`; test kipini yayından önce `testMode: false` |
+| P-14 | kod tarama (yalnız production akışlarında `scan-code` adımı varsa): `warn scan_shell_outdated` (yayındaki kabuk tarayıcıyı taşımıyor — derleme çıkar, adım `error` dalıyla biter); taşıyorsa `ok scan_ready`. Kamerayı yalnız dosya alanı kullanıyorsa satır hiç gelmez | yeni kabuk paketi (destek); ajan düzeltemez |
 
 Satırın `message` ve `fixHint`'i backend'den, istek dilinde gelir.
 

package/dist/resources/guides/mobile-steps.md

@@ -0,0 +1,67 @@
+# Mobil akış adımları rehberi
+
+Mobil uygulamada (`type:'mobile'`) cihaza ve barındırıcıya dokunan akış adımları: mobildeki davranış, argüman
+sözleşmesi, `Steps.<adım>` sonucu ve tarifler. Uygulamanın kendisi (kurulum, bileşenler, gezinme, kalıcı state,
+uzak push, sayfanın `mount` / `focus` olayları) `platform_guide('mobile')`'dedir.
+
+## Adım sözlüğü
+
+Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
+`validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar:
+
+| Adım | Mobilde |
+|---|---|
+| `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. `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 (`platform_guide('mobile')` §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 |
+| `share` | RN paylaşım sayfası (metin + bağlantı; Android'de bağlantı metne eklenir, `title` iOS'ta e-posta konusu, Android'de seçici başlığı); akış `always` ile sürer — iOS'ta sayfa kapanınca, Android'de seçici açılır açılmaz (RN kapanışı bildirmez). Argümanlar `platform_guide('page')` §`share` adımı |
+| `haptic` | dokunsal geri bildirim (`expo-haptics`, izin istemez). `args.value` stil, **düz metin**: `success` · `warning` · `error` · `light` · `medium` · `heavy` · `selection`; boş → `medium`. Değer yazmaz, hep `always`. Web'de titreşim varsa kısa titreşim, yoksa hiçbir şey (paletten yalnız mobilde sunulur) |
+| `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 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 |
+| `scan-code` | tam ekran kod tarayıcı (kök ADR 0017): tek kod okur ve kapanır. `args.value` izinli türler, **virgüllü düz metin** (`FLOW-042`): `aztec` · `codabar` · `code39` · `code93` · `code128` · `datamatrix` · `ean8` · `ean13` · `itf14` · `pdf417` · `qr` · `upc_e`; boş → hepsi. `upc_a` yok: UPC-A etiketi `ean13` ve on üç haneyle (başında `0`) döner. `args.title` ekrandaki yönerge, metin şablonu (`{{ t('anahtar') }}`). Sonuç `Steps.<adım>.data`: `{ value, type, source }` — `source` `camera` ya da `manual` (ekrandaki "elle gir"; tür bilinmiyorsa `type: null`). `error` dalı: `status` `cancelled` (kullanıcı kapattı — **vazgeçme bir hatadır, `error` dalını bağla**) · `denied` (kamera izni yok) · `unavailable` (derleme kamerayı taşımıyor ya da tarayıcı zaten açık) · `unsupported` (web uygulaması) · `invalid`. Kamera izni kendiliğinden derlemeye girer (adım production'daysa). Önizleme (`/dev`, `page_screenshot`) kamera açmaz, "kod gir" penceresi çizer: `__scan-value`'ya yaz, `__scan-confirm` ya da `__scan-cancel` (çok türde `__scan-type-<tür>`). `page_screenshot` pencereyi yalnız `captureUnready: true` ile sürer (akış pencereyi beklerken "koşuyor" sayılır; her eylem 15 sn bekler). Tam gövde: `ngapps://examples/mobile-scan-code` |
+
+## Bildirim tarifi
+
+Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce
+`notification-permission` (S03 düğmesi), sonra `timepicker`'ın değeriyle `notification-schedule`
+(`value: "<saat>.value"`, değer `HH:mm`) ve `error` dalında kullanıcıya mesaj. Çevrimdışı bandı adım değil
+ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`).
+
+## İzin tarifi
+
+**İzin tarifi** (izin, ihtiyaç anında — düğmeye basılınca — istenir; sayfa açılışında değil): `permission`
+`check` → `condition`, **bu sırayla**: `status === 'granted'` ise işe devam; `'unavailable'` ise özelliği sunma
+(Ayarlar'da açılacak izin yoktur — `canAskAgain` burada da `false` gelir); `canAskAgain` ise `permission` `request`
+ve sonucuna göre devam; değilse nedenini söyleyip `open-settings`. `location` adımı, `map.showUser` ve dosya alanının
+kamera/galeri kaynağı izni kendileri de ister — `permission` adımı *ne zaman* sorulacağını seçmek ve sonucu
+okumak içindir. `unavailable` bir hata değil, derlemenin o izni taşımadığının haberidir
+(`platform_guide('mobile-publish')` §İzinler).
+
+## Reklam tarifi
+
+**Reklam tarifi** (kök ADR 0012): (1) `mobile_store_update { settings: { ads: { enabled: true, iosAppId, androidAppId,
+testMode: true, units: [{ name, format, ios, android }] } } }` — reklam, App ID'si olan platformun derlemesine `tracking`'i de sokar (ATT metni
+gider, kip `off` olamaz); (2) banner için sayfaya `adBanner` `unit: '<banner yerleşimi>'`; (3) geçiş/ödüllü reklam için
+düğme akışına `ad-show` `value: '<yerleşim>'`, `error` dalında reklamsız devam; (4) ödül `condition`:
+`Steps.<adım>.data?.reward` doluysa ödülü ver. Açılış reklamı adım değil ayardır (`ads.appOpenUnit`). Sıra cihazda:
+rıza formu → açılış izinleri (ATT) → SDK; iOS'ta izleme izni yoksa reklam kişiselleştirilmeden istenir. Yerleşim adının
+ayarda tanımlı olduğu sayfa/akış yazımında denetlenemez — `mobile_store_get` `settings.ads.units` ve `adsWarnings`
+(`MOB-026`); yayın ayrıntısı `platform_guide('mobile-publish')` §Reklamlar.
+
+## Konum ve harita
+
+`style`, `accuracy`, `reverseGeocode` gibi anahtarlar sözleşmede yoktur ve platform onları sessizce düşürür
+(`FLOW-029`). "Haritada aç" için adım yoktur: `map`'in `press` olayı düğüme `mapsUrl` yazar, akış
+`redirect` `isRaw: true`, `path: '<harita>.mapsUrl'` ile açar. Tarif — L05 "mevcut konumumu kullan":
+düğmenin `click`'i → `location` (`always` → setter `il.value = Steps.konum.data.address?.region`, `error` →
+setter hata metni). Uzak push (sunucudan gelen bildirim) ayrı rehberde: `platform_guide('mobile')` §Uzak push.

package/dist/resources/guides/mobile.md

@@ -37,7 +37,8 @@ Mobil uygulamanın bileşen kataloğu ayrıdır (backend satırları `(slug, typ
 mobil farkları: düşen prop, değişen etkileşim, mobile özgü prop notları) ve `mobileNotes` (bütün
 mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`app-bar`, `safe-area`,
 `scroll-view`, `choice-chips`, `tooltip`, `markdown`, `calendar`, `stack`, `list-item`, `fab`, `timer`,
-`audio`, `lottie`, `webview`, `map`, `adBanner`, `grouped-list`, `floating-container`, `skeleton`, `photo-viewer`) bilgi yalnız
+`audio`, `lottie`, `webview`, `map`, `adBanner`, `grouped-list`, `floating-container`, `skeleton`, `photo-viewer`,
+`flip-card`, `swipeable-stack`) bilgi yalnız
 `mobileKnowledge`'tadır. Olay yükleri
 (`events[].payload`) önce mobile özgü sözleşmeden okunur (`app-bar.clickAction`, `repeater.swipe`,
 `choice-chips.change`…), yoksa web'inkinden.
@@ -115,6 +116,9 @@ mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`ap
   listesi) ve `floating-container` (ekranın 9 noktasından birine sabit kap — §Ekrana sabit içerik)
   mobile özgüdür. `scroll-view`'de ilk çocuk dışındaki doğrudan çocuklar `states.isSticky: true` ile
   kaydırırken üstte kalır (Studio panelinde alanı yok; şemaya MCP yazar).
+- **Dönen kart ve kart destesi** (2026-10-08): `flip-card` (children = [ön `view`, arka `view`]; `isFlipped`,
+  `flip`) ve `swipeable-stack` (`repeater` şekli: [kart `view`, boş `view`], `rows`, `currentIndex`;
+  `swipeLeft` / `swipeRight` / `finish` yükü `event.data`) mobile özgüdür.
 - **Faz 10** (FlutterFlow D listesi): `datatable` web ikizidir — kolon biçimi, sıralama ve sayfa hesabı web'in
   modülünden, akış sözleşmesi aynı (sıralama/sayfa değişince `sortField`/`sortType`/`offset` düğüme yazılır ve
   `mount` yeniden koşar; satır eylemi `selectedRow`u yazıp eylemin akışını koşturur). Mobile özgü `variant`:
@@ -179,12 +183,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 +208,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 +245,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": [] } ] }
   ```
 
@@ -303,6 +307,18 @@ aynı katman sırası: tema taban → gruplar → serbest `style`).
   (`'15deg'` yazılmaz); aralık dışı (`rotate` ±360, `scale` 10–500, kaydırma ±1000) yazılmaz ve
   `nativeStyle.warnings`'e düşer. Katman ve kabukta (`modal`, `drawer`, `app-bar`) bu dört alan yoktur.
 - `typographyStyle` → renk, aile (tek ad), punto, kalınlık, hizalama, satır yüksekliği.
+- `motionStyle` (panelde Motion; kabuğun dışında çizen `modal`, `drawer`, `photo-viewer`, `toast`, `fab`,
+  `floating-container` dışında her mobil bileşende) → düğümün hareketi: `enter` / `exit` (`fade`, `fadeUp`, `fadeDown`, `slideLeft`,
+  `slideRight`, girişte `zoomIn`, çıkışta `zoomOut`), `loop` (`pulse`, `spin`, `bounce`), `transition` (`colors`,
+  `opacity`, `transform`, `all`), `press` (`scale`, `opacity`), `layout` (aç/kapa), `duration` 100–2000 ms, `delay`
+  0–5000 ms, `easing`. Yazılmayan alan yok sayılır (300 ms, `easeOut`; döngü kendi süresini kullanır) — varsayılanı
+  YAZMAYIN. Yön adı BAŞLANGIÇ tarafıdır: `fadeUp` yukarıdan, `fadeDown` aşağıdan, `slideLeft` soldan, `slideRight`
+  sağdan gelir. Tanınmayan alan ve küme/aralık dışı değer atlanır (`MOB-028`). `/dev`'de ve cihazda oynar: `enter` düğüm
+  çizilince, `exit` gizlenince (`isHidden`), `layout` bir kardeş gizlenip görününce, `transition` kabuğun stili
+  değişince; giriş biter, döngü sonra başlar; döngü ve `press` `surfaceStyle`'ın döndürme/ölçek/opaklığının üstüne
+  biner. Kanvasta donuktur (araç çubuğunda Oynat); "hareketi azalt"ta ve `page_screenshot`'ın donuk karesinde durur.
+  Koşullu hareket: alan da (`{ type: 'code', ref }`) grup da (`set_binding`) ifadeye bağlanır; alandaki düz metin
+  `{{ … }}` ifade değildir (`MOB-028`). Web şemasında yoktur.
 - Tema token'ları (`var(--ng-*)`) sayılara çözülür; proje teması değişince mobil de değişir.
 
 Çizilmeyen alanlar (`MOB-002`) ve yerine ne:
@@ -317,8 +333,9 @@ aynı katman sırası: tema taban → gruplar → serbest `style`).
 | `surfaceStyle`'ın tanımadığı alt anahtar (ör. CSS `transform` metni, `padding`) | grubun tipli alanları; döndürme/ölçek/kaydırma `rotate`, `scale`, `translateX`/`translateY` |
 
 Düğümün gerçek stilini görmek: `page_runtime_get({ applicationSlug, pageSlug, resolveStyles: true })`
-→ her düğümde `nativeStyle: { shell, text, warnings }` (`shell` kutunun, `text` içine akan metnin
-stili; RN'de tipografi miras alınmaz). Yanıtta `styleResolver: 'native'`. Temanın katmanı
+→ her düğümde `nativeStyle: { shell, text, motion, bound, warnings }` (`shell` kutunun, `text` içine akan metnin
+stili; RN'de tipografi miras alınmaz; `motion` yalnız hareketli düğümde, `motionStyle`'ın `/dev` ve cihazdaki
+çözümü; `bound` ifadeye bağlı stil alanları — değerleri çalışma anında oluşur). Yanıtta `styleResolver: 'native'`. Temanın katmanı
 (`componentStyles[tip]` ← `$preset`) TABANDIR: panel grupları üstüne biner, düğümün serbest `style`'ı son söz — rapor
 da onu içerir. Mobilde tasarım sisteminin yolu `componentStyles`'tır (`theme_update`; tipin bütün düğümlerine iner).
 Mobil katalogda `style` prop'u olmadığı için düğüme yeni `$preset` başvurusu yazılamaz; kayıtlı (ör. web'den taşınmış)
@@ -376,7 +393,8 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
   Çekmece layout'un kök dizisindedir (`views: [shell_root, nav_drawer]`), kabuk kabının içinde değil.
 - Kabuk örnekleri: `ngapps://examples/mobile-app-shell-stack` (yığın), `ngapps://examples/mobile-app-shell-tab`
   (sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); üç sayfalık liste → detay → form akışı:
-  `ngapps://examples/mobile-list-detail-form`.
+  `ngapps://examples/mobile-list-detail-form`; kod tarama (düğme → `scan-code` → alana yaz):
+  `ngapps://examples/mobile-scan-code`.
 
 ## Çok dil
 
@@ -405,60 +423,19 @@ Mobil uygulama web ile **aynı sözlüğü ve aynı motoru** kullanır (plans/mo
 ## Akış adımları
 
 Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
-`validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar:
-
-| Adım | Mobilde |
-|---|---|
-| `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ı |
-| `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 |
-| `share` | RN paylaşım sayfası (metin + bağlantı; Android'de bağlantı metne eklenir, `title` iOS'ta e-posta konusu, Android'de seçici başlığı); akış `always` ile sürer — iOS'ta sayfa kapanınca, Android'de seçici açılır açılmaz (RN kapanışı bildirmez). Argümanlar `platform_guide('page')` §`share` adımı |
-| `haptic` | dokunsal geri bildirim (`expo-haptics`, izin istemez). `args.value` stil, **düz metin**: `success` · `warning` · `error` · `light` · `medium` · `heavy` · `selection`; boş → `medium`. Değer yazmaz, hep `always`. Web'de titreşim varsa kısa titreşim, yoksa hiçbir şey (paletten yalnız mobilde sunulur) |
-| `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` |
-| `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 |
-| `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
-`notification-permission` (S03 düğmesi), sonra `timepicker`'ın değeriyle `notification-schedule`
-(`value: "<saat>.value"`, değer `HH:mm`) ve `error` dalında kullanıcıya mesaj. Çevrimdışı bandı adım değil
-ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`).
-
-**İzin tarifi** (izin, ihtiyaç anında — düğmeye basılınca — istenir; sayfa açılışında değil): `permission`
-`check` → `condition`, **bu sırayla**: `status === 'granted'` ise işe devam; `'unavailable'` ise özelliği sunma
-(Ayarlar'da açılacak izin yoktur — `canAskAgain` burada da `false` gelir); `canAskAgain` ise `permission` `request`
-ve sonucuna göre devam; değilse nedenini söyleyip `open-settings`. `location` adımı, `map.showUser` ve dosya alanının
-kamera/galeri kaynağı izni kendileri de ister — `permission` adımı *ne zaman* sorulacağını seçmek ve sonucu
-okumak içindir. `unavailable` bir hata değil, derlemenin o izni taşımadığının haberidir
-(`platform_guide('mobile-publish')` §İzinler).
-
-**Reklam tarifi** (kök ADR 0012): (1) `mobile_store_update { settings: { ads: { enabled: true, iosAppId, androidAppId,
-testMode: true, units: [{ name, format, ios, android }] } } }` — reklam, App ID'si olan platformun derlemesine `tracking`'i de sokar (ATT metni
-gider, kip `off` olamaz); (2) banner için sayfaya `adBanner` `unit: '<banner yerleşimi>'`; (3) geçiş/ödüllü reklam için
-düğme akışına `ad-show` `value: '<yerleşim>'`, `error` dalında reklamsız devam; (4) ödül `condition`:
-`Steps.<adım>.data?.reward` doluysa ödülü ver. Açılış reklamı adım değil ayardır (`ads.appOpenUnit`). Sıra cihazda:
-rıza formu → açılış izinleri (ATT) → SDK; iOS'ta izleme izni yoksa reklam kişiselleştirilmeden istenir. Yerleşim adının
-ayarda tanımlı olduğu sayfa/akış yazımında denetlenemez — `mobile_store_get` `settings.ads.units` ve `adsWarnings`
-(`MOB-026`); yayın ayrıntısı `platform_guide('mobile-publish')` §Reklamlar.
-
-`style`, `accuracy`, `reverseGeocode` gibi anahtarlar sözleşmede yoktur ve platform onları sessizce düşürür
-(`FLOW-029`). "Haritada aç" için adım yoktur: `map`'in `press` olayı düğüme `mapsUrl` yazar, akış
-`redirect` `isRaw: true`, `path: '<harita>.mapsUrl'` ile açar. Tarif — L05 "mevcut konumumu kullan":
-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.
+`validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar ayrı rehberdedir:
+`platform_guide('mobile-steps')` — `redirect`, `alert`, `confirm`, `download`, `storage`, `setcookie`, `share`,
+`haptic`, `location`, `notification-permission` / `-schedule` / `-cancel`, `permission`, `open-settings`, `back`
+ve `ad-show`'un mobildeki davranışı, argümanları, `Steps.<adım>` sonucu; bildirim, izin, reklam ve konum
+tarifleri. Bu adımlardan birini yazmadan önce onu okuyun.
+
+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')`).
 
-
 ## Uzak push
 
 Sunucudan gönderilen bildirim yerel `notification-schedule`'dan ayrıdır. Kanal ikiliye bağlıdır (NTF-004):
@@ -488,7 +465,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 +504,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`