@appaflytech/zeyrek-ai-mcp 0.0.32 → 0.0.33

package/dist/resources/guides/page.md

@@ -4,6 +4,10 @@ Studio'nun tuval tarafı. Buradaki kurallar controller + komut kodundan doğrula
 (`zeyrek-mcp/docs/13-faz2-envanter.md` §4); veri/mantık tarafı için
 `platform_guide('entity')`, `('microservice')`, `('workflow')`.
 
+> **Mobil uygulamada** (`type: 'mobile'`) şema ve micro-op'lar aynıdır ama yerleşim yalnız flex'tir
+> (blocks çizilmez), görünüm tipli gruplarla yazılır ve `page_create` kökü flex sütun kurar —
+> `platform_guide('mobile')`. Bu rehberdeki "dar ekran" notları WEB uygulamasının telefon kırılımıdır.
+
 ## Kuruluş sırası
 
 ```
@@ -222,7 +226,7 @@ döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tu
 | `dropdown.search` · `multi-select.search` | `{ searchText }` | `self.searchText` |
 | `tabs.tab` | `{ selected }` | `self.selected` ya da `event.data.selected` |
 | `chart.dataPointClick` | `{ name, seriesName, value, dataIndex, row }` | `self.row` (kaynak satırın tamamı) |
-| `repeater.change` · `repeater.select` | `{ selectedIndex }` | `self.selectedIndex` · `self.selectedItem` (akış satır bağlamında koşmaz, `item`/`Row` boş) |
+| `repeater.change` · `repeater.select` | `{ selectedIndex }` | `self.selectedIndex` · `self.selectedItem` (akış satır bağlamında koşmaz, `item`/`Row` boş); satırdaki bir düğmenin akışında setter'ın yazım kapsamı OLAYIN kaynağı değil HEDEFİN ağaçtaki yeriyle belirlenir — satırın şablonu içindeki bir hedefe satır bazlı (`_repeaterValues`), dışındaki bir hedefe (modal, sayfa düzeyi metin) sayfa kapsamında yazılır (ZM-08, 2026-09-26); iç içe repeater zaten `PAGE-013` ile reddedilir, ama bir DIŞ repeater'ın şablonuna İÇ satırdan yazan bir akış varsa yazım dış satırın değil İÇ satırın kimliğiyle anahtarlanır — bilinen açık, PAGE-013 riski düşük tutar |
 | `html` aksiyonu (`fireEvent`) | ikinci argüman | **`event.data`** |
 | `kanban.cardMove` | `{ id, row, from, to }` | **`event.data`** (self'e yazılmaz) |
 | `kanban.cardAdd` · `kanban.cardRemove` | `{ column }` · `{ id, row, column }` | **`event.data`** (self'e yazılmaz; kart eklenmez/gizlenmez, akış yazıp `rows`'u tazeler) |
@@ -245,7 +249,8 @@ dalı bulamaz ve akışı **sessizce durdurur** (`flow-engine.ts:79`); Studio da
 `sourceBranch === 'always'` ile çizdiği için panelde **Start kartından sonrası boş görünür**.
 İ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).
+`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").
 
 **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
@@ -371,36 +376,42 @@ Satır eşlemeli tablo yüklemesinin tam şekli (yükleniyor bayrağı → uç
 göstermek error flow'un işidir.
 
 > **4xx de hatadır ve `always` dalı seni KURTARMAZ.** `microservice.ts` `.catch` bloğu
-> reddedilen her istekte koşar — 401/403/404/422 dâhil. Sonrası iki yoldan biridir ve ikisi de
-> "ekranda hiçbir şey olmadı" ile biter:
+> reddedilen her istekte koşar — 401/403/404/422 dâhil — ve storage'a HER ZAMAN
+> `{ data: null, headers: null, error: { status, message, body } }` yazar (ADR 0004,
+> 2026-09-26 — eskiden hata gövdesi `data`'ya yazılıyordu). `.finally` sonra ÜÇ yoldan birini
+> dener, SIRAYLA:
 >
-> 1. **Hata yolu VARSA** `engine.onError` true döner ve `.finally` `return` eder —
->    `engine.next('always')` **hiç çağrılmaz**. Yani `always` ile `errorSteps` birbirini dışlar;
->    ikisini birden kuramazsın, hata yolu ana akışın devamını devralır.
-> 2. **Hata yolu YOKSA** `always` koşar, ama storage artık `{ error, data }`'dır ve
->    `Steps.<ad>.data` başarı gövdesi değil **hata gövdesidir**. Sıradaki `condition`
->    `!!Steps.signIn.data.token` gibi bir ifadeyi `undefined` üzerinden değerlendirir, sessizce
->    diğer dala düşer ve `else` dalı bağlı değilse akış orada biter.
+> 1. **Adımın kendi `error` dalı BAĞLIYSA** akış oradan sürer — `always` **hiç koşmaz**
+>    (`hasBranch('error')`). Bu dal `Steps.<ad>.error` okuyabilir; ana akışın kalanı hiç çalışmaz.
+> 2. **`error` dalı yoksa, `errorSteps` VARSA** `engine.onError` true döner ve `.finally` `return`
+>    eder — yine `always` koşmaz, flow'un hata akışı devralır (aşağıdaki karşılaştırma tablosu).
+> 3. **İkisi de yoksa** `always` koşar, ama `Steps.<ad>.data` artık **NULL**dır — başarı gövdesi
+>    değil, hiç gövde değil. Sıradaki bir `condition` `!!Steps.signIn.data.token` gibi bir
+>    ifadeyi `null.token` üzerinden dener; `runCode` hatayı yutar (K2), ifade `undefined` döner ve
+>    akış sessizce diğer dala düşer — `else` dalı bağlı değilse akış orada biter. `data`yı bir
+>    liste prop'una yazan bir setter artık patlayan bir nesne değil `null` görür (repeater/table
+>    `null`'ı boş liste sayar), ama hata OLDUĞUNU fark etmeden geçer — gateway bunu **FLOW-028**
+>    ile uyarır.
 >
 > **`errorSteps` yalnız `start` taşıyorsa hata yolu YOKTUR:** `hasErrorFlow`
 > `errorTasks.some(t => t.type !== 'start')` arar. Start'ın ardına en az bir adım bağla —
 > gateway `FLOW-021` ile uyarır.
 >
-> **Mobilde `errorSteps` diye bir şey YOK.** `ScreenRuntime.tsx` `mapFlowsToMachine` yalnız
-> `tasks` üretir (web `Runtime.svelte` ayrıca `errorTasks` verir), yani mobil uygulamada
-> `hasErrorFlow` her zaman false: hata yolu hiç koşmaz ve akış yukarıdaki 2. yoldan —
-> `always` + hata gövdeli storage — devam eder. Mobil sayfada hata yolunu `condition
-> Steps.<adımAdı>.error` ile kur.
+> **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native` `NativeRuntime`) `errorSteps`'i web gibi
+> `errorTasks`'a eşler — hata yolu iki platformda aynı koşar.
 
-> **Hata metni ÜÇ ayrı yerde durur ve ikisi kullanıcıya gösterilecek metin DEĞİLDİR.**
+> **Hata metni birden çok yerde durur, hepsi aynı şey değildir (2026-09-26 itibarıyla, ADR 0004).**
 > `onError` hata akışını koşturmadan önce `machine.setStorage('error', errorInfo)` yapar
-> (`flow-engine.ts`), yani hata akışının adımları `Steps.error`'ı okuyabilir:
+> (`flow-engine.ts`), yani hata akışının adımları `Steps.error`'ı okuyabilir; patlayan adımın
+> KENDİ storage'ı ise (bağlı `error` dalı da `always` da) `Steps.<adımAdı>.error` nesnesini taşır:
 >
 > | İfade | Ne taşır | Kaynak |
 > |---|---|---|
-> | **`Steps.error.message`** | **Ucun kendi mesajı** — `err.response.data.message`; boşsa HTTP durum metnine düşer. **Kullanıcıya gösterilecek metin budur.** Yanında `Steps.error.code` · `Steps.error.step.name` (patlayan adım) · `Steps.error.step.data` (ucun gövdesi) gelir | `microservice.ts` `err.reason \|\| HttpStatusText[err.code]` → `flow-engine.ts` `onError` |
-> | `Steps.<adımAdı>.error` | Yalnız HTTP **durum metni** — 401 için `'Unauthorized'`. Hata OLDUĞUNU anlamaya yarar, göstermeye değil | `microservice.ts` `.catch` `HttpStatusText[err.code]` |
-> | `Steps.<adımAdı>.data` | Ucun **hata gövdesi** (`err.response.data`) — başarı gövdesi değil. `.message` alanı burada da vardır | `microservice.ts` `.catch` |
+> | **`Steps.error.message`** | **Yalnız `errorSteps` içinde** — ucun kendi mesajı, `err.reason` → HTTP durum metni → `'Service request failed'`. Yanında `Steps.error.code` · `Steps.error.step.name` (patlayan adım) · `Steps.error.step.data` (ucun hata gövdesi; parametre ifadesi patladıysa `null`) gelir | `microservice.ts` `err.reason \|\| HttpStatusText[err.code]` → `flow-engine.ts` `onError` |
+> | `Steps.<adımAdı>.error.message` | Patlayan adımın KENDİ storage'ında ucun mesajı — `error` dalında da `always`'te de okunur, sıra aynı: `err.reason` → HTTP durum metni → `'Service request failed'` | `microservice.ts` `.catch` |
+> | `Steps.<adımAdı>.error.status` | HTTP durum KODU (sayı) — parametre ifadesi patladıysa `null` | `microservice.ts` `.catch` |
+> | `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
@@ -428,15 +439,24 @@ göstermek error flow'un işidir.
 > `{ "type": "confirm", "args": { "message": "Bu risk ve 4 aksiyonu silinecek.", "title": "Riski sil",
 > "confirmText": "Sil", "cancelText": "Vazgeç" } }`.
 
-> **Hangi yolu seçeceksin — `errorSteps` mi, ana akışta `condition` mı?** İkisi birden
-> kurulamaz (yukarıdaki 1. madde), yani bu bir tercih değil bir karar:
+> **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
+> olabilir ama aynı anda yalnız biri koşar: **`error` dalı bağlıysa o kazanır**, yoksa
+> `errorSteps`, ikisi de yoksa `always` + `condition`:
 >
-> | | `errorSteps` | ana akışta `condition Steps.<adımAdı>.error` |
-> |---|---|---|
-> | Ana akışın kalanı | **koşmaz** — hata akışı devralır | koşar, dalı sen seçersin |
-> | Yükleniyor bayrağı · modal kapatma · tablo tazeleme | hata akışında **yeniden kurmak zorundasın**; kurmazsan bayrak açık kalır | zaten ana akışta duruyor |
-> | Hata metni | `Steps.error.message` (yukarıdaki tablo) | `Steps.<adımAdı>.data.message`, hata olduğunu `Steps.<adımAdı>.error` söyler |
-> | Ne zaman doğru | hata anında akış **tamamen başka bir yola** sapacaksa (başarısız giriş, yetkisiz sayfa) | kalan adımların çoğu hata hâlinde de koşacaksa — **form gönderimlerinin varsayılanı budur** (Kural 7) |
+> | | adımın kendi `error` dalı (g-02) | `errorSteps` | ana akışta `condition !!Steps.<adımAdı>.error` |
+> |---|---|---|---|
+> | Kapsam | yalnız BU adımın hatası | akıştaki HERHANGİ bir adımın hatası | yalnız BU adımın hatası |
+> | Ana akışın kalanı | **koşmaz** — bu dal devralır | **koşmaz** — hata akışı devralır | koşar, dalı sen seçersin |
+> | Yükleniyor bayrağı · modal kapatma · tablo tazeleme | dalda **yeniden kurmak zorundasın** | hata akışında **yeniden kurmak zorundasın**; kurmazsan bayrak açık kalır | zaten ana akışta duruyor |
+> | Hata metni | `Steps.<adımAdı>.error.message` | `Steps.error.message` (yukarıdaki tablo) | `Steps.<adımAdı>.error.message`; hata olduğunu `!!Steps.<adımAdı>.error` söyler — `.error.status` parametre ifadesi patladıysa `null`dur, o yolu KAÇIRIR |
+> | Ne zaman doğru | hata anında BU adımın sonrası **tamamen başka bir yola** sapacaksa | hata anında akış **tamamen başka bir yola** sapacaksa (başarısız giriş, yetkisiz sayfa) | kalan adımların çoğu hata hâlinde de koşacaksa — **form gönderimlerinin varsayılanı budur** (Kural 7) |
+>
+> **"Ana akışta condition" sütunu `.error`'u okumalı, `.data`'yı değil.** `Steps.<adımAdı>.data`'nın
+> DOLU/BOŞ olmasına bakarak başarı/hata ayırmak (`data.token` gibi bir alanın varlığını yoklamak)
+> artık yanıltıcıdır — `data` hata anında zaten `null`'dur (yukarıdaki §"4xx de hatadır"). Böyle bir
+> `condition`'ı gateway **FLOW-028** ile uyarır; adıma ayrıca bir `error` dalı bağlayın (aşağıdaki
+> 7c örneği) — `error` dalı bağlıysa uyarı düşer, çünkü hata artık `always`'e hiç uğramaz.
 
 Zorunlu filtresi olan uçlarda (`patient-*`, `doctor-appointments` gibi `isRequired: true`
 filtreli microservice'ler) parametreyi adımda ver, yoksa uç `MissingParameterException` atar:
@@ -513,21 +533,21 @@ Tarif: `platform_guide('middleware')`.
 
 **Sözlükler** (`StepType.cs`, `StepParameterValueType.cs` — hepsi küçük harf):
 `start · microservice · setter · setcookie · validation · condition · redirect · alert ·
-confirm · flow-trigger · storage · navigate · code · download · function · end`
+confirm · flow-trigger · storage · navigate · code · download · function · share · end`
 değer tipleri: `static · page · property · storage · variable · code · item · state`
 
 > **Sözlükte olmak KOŞACAĞI anlamına gelmez — koşan tipler barındırıcıdan gelir.** Motor yedi
 > tip register eder, gerisini uygulama ekler. Bir sayfa TEK bir uygulamaya aittir
 > (`Page.ApplicationId`) ve uygulamanın tipi `web` ya da `mobile`'dır (`ApplicationType.cs`), yani
 > sayfanın barındırıcısı bellidir — matris "hangi tip sende çalışır"ı söyler, iki barındırıcıda
-> birden koşmayı değil (web `Runtime.svelte`, mobil `ScreenRuntime.tsx`):
+> birden koşmayı değil (web `Runtime.svelte`, mobil uygulama `@ng-apps/ui-native` `NativeRuntime`):
 >
-> | Adım tipi | Web | Mobil | Nerede register ediliyor |
+> | Adım tipi | Web | Mobil uygulama | Nerede register ediliyor |
 > |---|---|---|---|
-> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi (`function` mobilde kayıtlıdır ama mobil runtime `Functions`'ı boş kurar — K11, çağrı çalışmaz) |
-> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | uygulama; mobilde `redirect` navigate, `setcookie` storage uygulamasına eşlenir |
-> | `confirm` · `download` | ✅ | ❌ | yalnız `Runtime.svelte` |
-> | `navigate` | ❌ | ✅ | yalnız `ScreenRuntime.tsx` — web'deki karşılığı `redirect` |
+> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi |
+> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | barındırıcı; mobilde `setcookie` cihaz deposuna yazar (`MOB-005`) |
+> | `confirm` · `download` · `share` | ✅ | ✅ | `Runtime.svelte` · `runtime-tasks.ts` (`download` mobilde açma/paylaşım — `MOB-005`; `share` aşağıda) |
+> | `navigate` | ❌ | ✅ (`redirect` takma adı) | web'deki karşılığı `redirect`; gateway `redirect`'e çevirir |
 > | `end` · `query` | ❌ | ❌ | hiçbir yerde — üstelik `query` backend sözlüğünde de yok (`StepType.cs` onu saymaz), yalnız frontend enum'unda duruyor |
 >
 > **Register edilmemiş bir tipe gelen akış SESSİZCE durur.** `flow-engine.ts` `process()`
@@ -563,6 +583,19 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > adımında ve `{{ }}` bağlamasında `Functions.<ad>(…)` ile de çağrılır; gateway bilinmeyen adı ve
 > fazla argümanı FLOW-025 ile uyarır. Tam gövde `ngapps://examples/flow-call-function`, kurallar
 > **`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
+> İ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-027 `url`/`link`/`text`'i ve tırnaksız adresi
+> bloklar). Bağlantı ŞEMALI TAM ADRES olmalı (`https://…`, `mailto:…`): şemasız değer (`www.…`,
+> `urun/42`) adres sayılmaz, metnin sonuna eklenir. İfadenin sonucu yalnız dize ya da sayıysa
+> paylaşılır; `false` (`koşul && 'x'`), `null` ve nesne boş sayılır. Cihazda paylaşım sayfası açılır
+> (Android'de bağlantı metnin sonuna eklenir), web'de tarayıcının paylaşım penceresi, yoksa ya da
+> reddederse metin + bağlantı panoya yazılır ve bildirim çıkar. Tek dal `always`: iOS'ta sayfa
+> kapanınca, Android'de seçici açılır açılmaz (RN seçicinin kapanışını bildirmez) sürer; metin de
+> bağlantı da boşsa hiçbir şey açılmaz, akış hemen sürer.
 
 > Bir microservice adımı kaydedildiğinde platform `args.microserviceSchema`'yı
 > (parameterScheme + returnScheme + `isReturnArray`) kendisi doldurur — `flow_get` ile geri
@@ -861,7 +894,7 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
 > `add_component` ile yeniden kurmaktır (sonrasında Kural 2'deki flow yeniden kaydetme adımı
 > ZORUNLU olur).
 
-Mobil not: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
+Dar ekran notu: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
 dikey sıraya dönüşür, x/w yok sayılır. Yerleşimi masaüstü (breakpoint 1024) bloğuyla kur.
 
 ## Kural 1f-2 — Kapsayıcı düzeni: `flex` (varsayılan) ↔ `grid`
@@ -879,7 +912,7 @@ aynı prop grubunu o da alır. Grup katalogda tanımlıdır, yani şemadan kurul
 | `horizontalAlign` | **`left`** · `center` · `right` · `stretch` | `row`'da ana eksen (`justify-content`), `column`'da çapraz eksen (`align-items`). |
 | `verticalAlign` | **`top`** · `middle` · `bottom` · `stretch` | `row`'da çapraz eksen, `column`'da ana eksen (rolleri `horizontalAlign` ile takas). |
 | `size` | **`shrink`** · `grow` | Çocuklara `flex: 0 1 auto` / `1 1 auto`. |
-| `gap` | `none` · `small` · **`medium`** · `large` **ya da ham CSS** | Preset'ler tema değişkenidir: 0 / `var(--ng-spacing-sm)` / `--ng-spacing-md` / `--ng-spacing-lg` (varsayılan temada 8/16/32px). Alan `allowCustom`'dır: `"18px"` ya da `"var(--ng-spacing-xl)"` gibi ham değer de geçer. `box-section`/`aibox`'taki sayısal `gapCustom` doluysa preset'i ezer. |
+| `gap` | `none` · `small` · **`medium`** · `large` | Preset'ler tema değişkenidir: 0 / `var(--ng-spacing-sm)` / `--ng-spacing-md` / `--ng-spacing-lg` (varsayılan temada 8/16/32px). Yalnız bu dört preset geçer: `"18px"` gibi ham değer platform doğrulamasında `invalid-enum-value` ile reddedilir. `box-section`/`aibox`'taki sayısal `gapCustom` doluysa preset'i ezer. |
 | `wrap` | kapalı · **açık** | `flex-wrap`. **Varsayılan 2026-09-01'de açık oldu:** `row` + `w:12` çocuklar artık alt satıra sararak dikey akar. Kapatırsan taşan çocuklar tek satıra sıkışır. |
 
 **`form` da bu grubun tamamını taşır (2026-09-01):** varsayılanları container ile aynı
@@ -950,10 +983,10 @@ Beş şeyi bilmeden flex kurma:
 4. **`layout: 'grid'` iken diğer altı prop ÖLÜDÜR.** Katalogda tanımlı oldukları için
    doğrulama duvarı susar, renderer da okumaz: ızgara kapsayıcıya `direction: 'column'` yazmak
    sessizce hiçbir şey yapmaz. Gateway bunu **PAGE-015 (uyarı)** ile söyler.
-5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve mobilde AYNIDIR;
-   sıra ve span'lar Desktop (1024) bloğundandır — Studio, mobil kırılım düzenlenirken flex
+5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve dar ekranda AYNIDIR;
+   sıra ve span'lar Desktop (1024) bloğundandır — Studio, dar ekran kırılımı düzenlenirken flex
    bölgeyi salt-okunur kilitler. Kırılım bilen yalnız `blocks[]` ve `appearance.hideOn`'dur;
-   mobilde farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f mobil notu).
+   dar ekranda farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f dar ekran notu).
 
 ```jsonc
 // Ortalanmış giriş kartı — style ile CSS hack'i YOK, kabın kendi düzeni
@@ -976,7 +1009,7 @@ gibi bitişik duracak elemanlar için ÜÇ şart birden gerekir; biri eksikse ar
 
 1. Her çocuğa **`appearance.widthType: 'auto'`** — içerik kadar yer kaplar (`flex: 0 1 auto`).
    Yazılmazsa eski 12 kolon payı geçerlidir ve çocuk kolonunu doldurur, bitişemez.
-2. Kaba **`gap: 'none'`** (ya da ham ince değer: `"2px"`, `"4px"` — alan `allowCustom`).
+2. Kaba **`gap: 'none'`** (ham ince değer yazılamaz — `"2px"` platformda 422; ince aralık gerekiyorsa çocuğa `appearance.marginType: 'custom'`).
 3. Her çocuğa **`appearance.marginType: 'none'`** — en çok atlanan şart: `marginType`
    yazılmamış düğüm `normal` sayılır ve her kenara 4px basar (`spacing.ts`
    `CANVAS_NORMAL_MARGIN`), yani `gap:'none'` olsa bile komşular arasında 8px kalır.
@@ -1080,15 +1113,22 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 > SONRAKİ ağaca bakarak. Layout'ta da geçerlidir: kırılma
 > `_repeaterValues` geri yazmasındadır, barındıranın sayfa mı layout mu olduğuna bakmaz.
 >
+> **Mobil uygulamada** başlıklar altında gruplu liste (güne/kategoriye göre) iç içe repeater
+> gerektirmez: tek `grouped-list` (`groupBy` + başlık `{{ Section.title }}` + öğe şablonu) —
+> `platform_guide('mobile')` §Güne göre görev listesi. PAGE-013 mesajı mobilde bunu önerir.
+>
 > **Yapılacak:** satır içi listeyi tek bir `textarea`'da **satır başına bir öğe** olarak topla
 > (`options_text`), kaydederken `split('\n')`'le böl. Ölçülmüş çalışan sürüm: anket editörü
 > (`anket-admin/anket-duzenle`). Gerçekten satır satır düzenleme gerekiyorsa iç listeyi AYRI bir
 > sayfada/modalda yönet — iç içe repeater bunu karşılamıyor.
 
 > **Repeater satırını akıştan silmek/eklemek:** repeater ÇOCUĞUNDAKİ bir butonun click akışında
-> `RowIndex` doğru satırı verir, ve hedef repeater'ın KENDİSİ olduğu için `rows`'a yazmak serbesttir
-> (`isRepeaterSelf` dalı satır-değeri yoluna girmez). Ölçülmüş desen:
-> `q_list.rows = (q_list.rows || []).filter(function(r, i){ return i !== RowIndex; })`.
+> tıklanan satır olay makineye gitmeden SEÇİLİR, yani `q_list.selectedIndex` o satırdır — her runtime
+> sürümünde. Hedef repeater'ın KENDİSİ olduğu için `rows`'a yazmak serbesttir (`isRepeaterSelf` dalı
+> satır-değeri yoluna girmez). Desen:
+> `q_list.rows = (q_list.rows || []).filter(function(r, i){ return i !== q_list.selectedIndex; })`.
+> `RowIndex` de aynı satırı verir, ama yalnız ARC-121 düzeltmesini (2026-09-27) taşıyan runtime'da;
+> eskisinde akışta tanımsızdı.
 > Ekleme aynı şekilde `.slice()` + `push` ile yapılır; satır numarasını ekledikten sonra yeniden ata.
 
 **Gönderimi saklamak:** satır başına normalize kayıt yerine tek `TEXT` kolonda anlık görüntü
@@ -1097,6 +1137,45 @@ kendisi nesneye çevirir; Studio tablosunda `[object Object]` görünmesi normal
 (`platform_guide('entity')` → "TEXT kolonunda JSON"). Ekranın görsel tarafı için **Kural 1h**:
 tema `--ng-*` değişkenleriyle tek yerden çevrilir, `html` kaçış kapısına gerek kalmaz.
 
+## Kural 1g-2 — Mobil davranış: dört ayar, dört ayrı sahip
+
+Mobil listelerin davranışı TEK bileşende toplanmaz. Hangi ayarın kimde olduğunu bilmeden yazılan
+şema sessizce çalışmaz — prop var olmayan bileşene yazılır ve `page_schema_patch` onu düşürmez,
+çizer yok sayar.
+
+| Davranış | Sahip bileşen | Prop / olay |
+|---|---|---|
+| Çekerek yenile | `scroll-view` (listeyi SARAN kap) | `refreshable: true` + `refresh` olayı |
+| Sonsuz kaydırma | `scroll-view` | `scrollEnd` olayı (prop yok) |
+| Kaydırma eylemleri | `repeater` | `swipeActions: [{ key, label, tone, icon }]` + `swipe` olayı, payload `{ key, index, row }` |
+| Satıra dokunma | `repeater` | `itemPressable: true` + `itemPress` olayı, payload `{ index, row }` |
+
+Çekerek yenileyi `repeater`'a yazmak en sık hatadır: liste kendi kaydırmasını yapmaz, onu saran
+`scroll-view` yapar. `repeater` kökteyse (kap yok) yenileme hiç çizilmez.
+
+Satıra dokunmanın kartın `click`'iyle yapılan eski yolu mobilde bırakıldı: `itemPress` satır
+bağlamını payload'da taşır ve seçimi (`selectedIndex`) de yazar, yani akış satırı
+`<tekrarlayıcı>.selectedItem` ile okumaya devam eder.
+
+### `redirect.presentation`
+
+`redirect` adımının `args.presentation` alanı ekranın NASIL açıldığını söyler ve kapalı bir küme
+alır:
+
+- `push` — yığına ekler, geri düğmesi önceki ekrana döner (**varsayılan**; alan yazılmayabilir)
+- `modal` — alttan açılan ayrı bir sunum; geri onu kapatır, altındaki ekran yerinde kalır
+- `replace` — geçerli ekranı değiştirir, geçmişe girmez (giriş → ana ekran için doğru olan)
+
+Küme dışı bir değer **MOB-008** uyarısıdır ve backend doğrulayıcısı 422 döner. Alanı hiç yazmamak
+kusur değildir.
+
+**Sekme hedefinde `modal` çalışmaz.** Hedef sayfa bir sekmeyse gezinme her zaman `navigate`'e
+düşer: sekme yığını kendi geçmişini tutar ve modal onu kırardı. `presentation`ı yazabilirsiniz,
+çizer sessizce yok sayar — sekme dışı bir sayfaya modal istiyorsanız o sayfayı sekme listesinden
+çıkarın.
+
+Web uygulamasında alan yok sayılır; gateway web profilinde bu konuda bulgu üretmez.
+
 ## Kural 1h — Tasarım: `style` prop'u ve tema değişkenleri
 
 Her komponentin `style` prop'u vardır ve emotion `css()` bloğudur: iç seçiciler, pseudo-class'lar
@@ -1304,20 +1383,6 @@ bağlamında `page_runtime_get` → `theme.presets`; `componentStyles[type]` ref
 Preset'in kendisini yazmak/silmek `theme_update` işidir — `platform_guide('theme')`. Bir alanı temaya bırakmak = o alanı hiç yazmamak;
 studio'da bunun adı "Temaya dön"dür. Tema değerini gruba kopyalama — bağ kopar, tema değişince izlemez.
 
-**Yatay denge MÜREKKEPLE ölçülür, kutuyla değil (2026-09-29).** "Soldan sağdan eşit" bir
-düğme/çip/hap için iki kenardaki boşluk, elemanların kutusundan değil GÖRÜNEN çizgiden ölçülür:
-Material glifinin kendi yan boşluğu (~0.2em) vardır ve kutular eşitken ikon tarafı 3px daha
-geniş görünür. Rexora'da "Export Report" ve "Save Order" kutu ölçüsüyle 12/12 "eşit" raporlandı,
-kullanıcı iki kez "yazı sağa yapışmış" dedi. Kurallar:
-- `button` ikon + metinde dengeyi KENDİSİ kurar (ikon tarafını ~0.2em daraltır). Dolguyu
-  değiştirmek için `style.padding` YAZMA — `!important` ile bu dengeyi ezer; `style:
-  { '--ng-btn-pad-x': '18px' }` yaz, iki taraf ondan türetilir.
-- Yuvarlak (pill) düğmede yatay dolgu yüksekliğin ~%35-40'ı olmalı; 44px'lik hapta 12px dar
-  görünür (16-18px).
-- Kendi kurduğun çipte (container/html) ikon tarafını glif yan boşluğu kadar dar tut ya da
-  simetrik bir öğeyle (avatar, nokta) başla. Doğrulama: `page_screenshot` + ölçü betiğinde
-  glifin `measureText().actualBoundingBox*` değerleriyle mürekkep kenarı.
-
 **Efektif stili okumak:** `page_runtime_get(resolveStyles: true)` her düğüme `resolvedStyle`
 (kaskad çözülmüş birleşik stil) ve `styleLayers` (`{ typedGroups, componentStyle, preset, own }`)
 ekler. "Bu kutu neden böyle görünüyor / benim yazdığım stil neden görünmüyor" sorusunun cevabı
@@ -1337,6 +1402,16 @@ alanları silinir. Gateway bu yüzden `page_update`'te sayfayı önce okur, yaln
 alanları değiştirip tam gövdeyi geri yazar (`layout_update` ve `component_update` de aynı).
 Yine de `schema` parametresini elle doldurursan okuduğun hâli değil, **verdiğin liste** yazılır.
 
+**`page_update` sürümsüz yazmaz (PAGE-039).** Platform sayfa PUT'unu `baseVersion` olmadan reddeder.
+`baseVersion` vermezsen gateway bu sayfada en son gördüğü sürümü gönderir: `page_get` ya da
+`page_schema_get` yanıtındaki `version`, `page_schema_patch`'in `newVersion`'ı ya da önceki
+`page_update`'in yazdığı sürüm. Hiçbiri yoksa istek **gönderilmez** — önce oku. Sayfa o sürümden beri
+değiştiyse (Studio'da açık sekme, başka ajan) 409 döner; mesaj güncel sürümü ve son yazmayı (zaman,
+kullanıcı, kaynak, revizyon) söyler ve hiçbir şey yazılmaz. Doğru yol yeniden okuyup değişikliği
+`page_schema_patch` ile yapmaktır; aradaki değişikliği bilerek ezmek için `force: true` son sürümü
+okuyup onun üstüne yazar ve yanıt `forced: true` taşır. Sebep: Bitki Bakım koşusunda sürümsüz bir
+tam gövde yazımı ana sayfayı ve profili boşalttı, akışları sildirdi (14:02).
+
 ### Atomiklik: 500 KB'lık şemada tek komponente dokunmak
 
 `page_schema_patch` şemanın tamamını göndermez — yalnız op'ları gönderir. Tam gövde ne LLM
@@ -1346,7 +1421,8 @@ ve geri yazar. Sözleşme (`PatchPageSchemaCommandHandler`):
 | Aşama | Ne yapar |
 |---|---|
 | Kilit | Sayfa başına 60 sn'lik dağıtık kilit; başka bir aktör yazıyorsa istek `PageSchemaLockedException` ile döner (409) |
-| Sürüm | `baseVersion` verdiysen `UpdatedAt.Ticks` ile karşılaştırılır; tutmazsa `PageSchemaVersionConflictException` (409) ve **hiçbir op uygulanmaz** |
+| Sürüm | `baseVersion` verdiysen `UpdatedAt.Ticks` ile karşılaştırılır; tutmazsa `PageSchemaVersionConflictException` (409) ve **hiçbir op uygulanmaz** — bütün op'lar etkisizse hariç (aşağıdaki "Tekrar" satırı) |
+| Tekrar | `add_component`'in `elementId`'si zaten varsa ve düğüm istenen ebeveynde, istenen içerikle duruyorsa op **etkisizdir** (hata değil; konum karşılaştırılmaz). Hedef düğümü değiştirmeyen `replace_prop`/`set_*`/`add_event` da etkisizdir. Bütün op'lar etkisizse yama yazılmaz, sürüm artmaz ve eski `baseVersion`'a rağmen 200 `noop: true` döner; sürüm eskiyse `stale: true` ve `newVersion` sizin gönderdiğinizdir. Aynı id'de farklı düğüm hâlâ 422 `duplicate-id`'dir |
 | Uygulama | Her op hedefini ağaçta arar (`Find` → JSON Pointer) ve **yalnız o düğüme** dokunur; kardeşler, üst düğümler ve diğer alt ağaçlar bit düzeyinde korunur |
 | Hep-ya-hiç | Op'lar önce bellekte uygulanır; **tek bir hata** (bilinmeyen op, bulunamayan hedef, tekrar eden elementId, doğrulama) tüm komutu düşürür — kısmi yazma yoktur |
 | Doğrulama | Tam şema `PageSchemaValidator`'dan geçer (422 + alan bazlı `errors`) |
@@ -1355,7 +1431,18 @@ ve geri yazar. Sözleşme (`PatchPageSchemaCommandHandler`):
 
 Yanıt üç alan döner: `applied` (uygulanan op sayısı), **`appliedPatch`** (her op'un şemada tam
 olarak hangi JSON Pointer'a ne yaptığı — RFC 6902 biçiminde; "gerçekten yalnız o komponente mi
-dokunuldu" sorusunun kanıtı) ve **`newVersion`** (`UpdatedAt.Ticks`).
+dokunuldu" sorusunun kanıtı) ve **`newVersion`** (`UpdatedAt.Ticks`). Etkisiz op varsa `unchanged`
+(elementId listesi) ve `alreadyApplied` cümlesi gelir; hepsi etkisizse `noop: true`.
+
+**Yanıt kaybolursa aynı gövdeyle tekrarla.** Ağ koptu, zaman aşımı oldu ve yamanın uygulanıp
+uygulanmadığını bilmiyorsan aynı `page_schema_patch`'i **aynı gövde ve aynı `baseVersion`** ile
+yeniden gönder. Uygulanmışsa `noop: true` + `alreadyApplied` döner, hiçbir şey ikinci kez yazılmaz;
+uygulanmamışsa yama şimdi uygulanır. `add_component` (gövdede `id` verme — platform her istekte yeni
+`id` üretir, karşılaştırma onu yok sayar), aynı değeri yazan `replace_prop`/`set_*` ve aynı bağı kuran
+`add_event` tekrarda etkisizdir. İki istisna: `remove_component` ikinci kez `unknown-target` döner — o
+durumda `page_schema_get` ile bak; eklediğin düğümün bir prop'unu aynı yamanın sonraki op'u
+değiştirdiyse tekrar `duplicate-id` alır. Yanıt `stale: true` taşıyorsa sayfa sürümünden beri başka bir
+yazımla da değişmiştir: devam etmeden önce yeniden oku. `idempotencyKey` yoktur ve gerekmez.
 
 > **`appliedPatch` gövdesi VARSAYILAN OLARAK iskelettir.** Girdi `{ op, path }` döner; eklenen
 > düğüm `component` altında yalnız `id`/`elementId`/`name`/`type`/`children` taşır. Kanıt zaten
@@ -1375,12 +1462,29 @@ yamanın `baseVersion`'ıdır. Kontrol platformda atomiktir (satır kilidi + sü
 `UPDATE`'te), yani iki çağrı arasına giren yazarı da yakalar. `baseVersion` vermezsen gateway yalnız
 bu çağrıda zaten okuduğu sayfanın sürümünü gönderir; hiç okumadıysa yama sürümsüz gider ve son
 yazan kazanır. Eski `expectedUpdatedAt` hâlâ çalışır ama `baseVersion`'ın yerini tutmaz.
+
+**Studio da sürüm gönderir (2026-09-26, ZM-27).** Önceden Studio'da açık kalan bir sekme, yayını
+kaçırdığı yamalarının üstüne kendi eski (bir kez boş) şemasını yazıyor ve bağı kalmayan akışları
+sildiriyordu. Artık Studio'nun her kaydı sürüm taşır: eski sekme 409 alır ve taslağını senin
+yazdığının üstüne birleştirir. `revision_list`'te yamandan sonra `source: studio` satırı görürsen bu
+artık bir üzerine yazma değil, birleştirilmiş bir kayıttır — yine de `revision_diff` ile bak.
 Yanıttaki `touched`, kaydı değişen elementId'leri listeler (eklenen alt ağaç dâhil).
 
 > **Büyük şemada çalışma sırası:** `mode:'summary'` ile ağacı çıkar (props yok, 500 KB'lık sayfada
 > bile küçük) → hedefin `elementId`'sini al → gerekiyorsa `mode:'subtree'` ile yalnız o dalı oku →
 > op'ları `page_schema_validate` ile kuru koştur → `page_schema_patch`. `mode:'full'` yalnız
 > gerçekten tüm şema gerektiğinde çağrılır.
+>
+> **`full` sığmazsa hata verir, kırpmaz.** Yanıt boyut sınırını aşan şemada `mode:'full'` hata döner
+> ve düğüm sayısını söyler. Tamamı gerekiyorsa `cursor:'0'` ile oku ve `nextCursor` gelmeyene kadar
+> sür: her parça `items[]` taşır, kalem `parentElementId` düğümünün `children[index]`'inin yerine
+> geçer (`parentElementId` yoksa kök dizinin `[index]`'i); alt ağacı sığmayan düğüm kabuk gelir
+> (`children: [{ elementId, deferred: true }]`) ve sonraki kalemler onu doldurur. Toplanan düğüm sayısı
+> `nodeCount`'a eşit değilse okuma eksiktir. Okuma arasında sayfa değişirse 409 — baştan başla.
+> `allowTruncated:true` kırpılmış gövdeyi açıkça verir (`truncated: true`); o gövdeye dayanan
+> `page_schema_patch` PAGE-038 uyarısı taşır. **`page_update`'e kırpık ya da yarım şema gönderme:**
+> PUT tam REPLACE'tir, eksik düğümler geri dönüşsüz silinir — gateway düğüm eksilten şemayı
+> `allowNodeLoss:true` olmadan PAGE-037 ile reddeder.
 
 > **`remove_component`'in yan etkisi — tek istisna.** Sayfa kaydedilirken artık hiçbir komponent
 > olayının, prop'unun ya da sayfa olayının referans vermediği akışlar platformca **kalıcı olarak
@@ -1491,7 +1595,9 @@ isimlerine bağlanır.
 
 **Platform değişkenleri tek tek değil SET olarak tutar:** uygulama başına bir kayıt, sayfa başına
 bir kayıt (`variable_create` `pageId` verirsen sayfa, vermezsen uygulama düzeyi). Kayıt zaten varsa
-create update'e döner. Şekil `[{ key, value }]`; `value` **herhangi bir JSON** olabilir:
+create update'e döner. Şekil `[{ key, value, storage? }]`; `value` **herhangi bir JSON** olabilir.
+State **bellektedir** — sayfa her açıldığında `value`'dan başlar; `storage: 'device' | 'secure'` yalnız
+mobil uygulamada değeri cihazda saklar (`platform_guide('mobile')` §Kalıcı state, `MOB-014`):
 
 ```jsonc
 variable_create({ applicationId, pageId, variables: [
@@ -1503,7 +1609,7 @@ variable_create({ applicationId, pageId, variables: [
 - Uç seti **komple değiştirir**; gateway mevcut seti okuyup anahtar bazında birleştirir. Kasten
   silmek için `replace: true`. `variable_delete` **setin tamamını** siler.
 - Platform `data`'yı JSON **string** olarak saklar (`"[{\"key\":…}]"`); gateway çeviriyi iki yönde
-  de yapar — `variable_list` sana `[{key, value}]` döndürür. Ham HTTP kullanıyorsan string
+  de yapar — `variable_list` sana `[{key, value, storage?}]` döndürür. Ham HTTP kullanıyorsan string
   zorunludur: gövdede yalnız `data` alanı okunur, `name`/`type`/`defaultValue` gibi alanlar
   **sessizce yok sayılır** ve kayıt boş yazılır (istek yine 200 döner).
 
@@ -1529,25 +1635,6 @@ Tercih kuralı: *"bu değer başka bir değerden TÜRETİLİYORSA"* `set_binding
 *"bir OLAY sonucunda bir kez yazılacaksa"* (uçtan veri çekme gibi) flow + setter kullan.
 İkisini aynı prop'ta karıştırma — setter'ın yazdığı değeri canlı bağ bir sonraki tetikte ezer.
 
-**Designer'da da görünsün: varsayılan değer kur (2026-09-29).** Studio kanvası akış
-koşturmaz; `type:'code'` prop'larını tasarım anında `state.page.*` / `state.app.*`
-değişkenlerinin **varsayılan değerleriyle** çözer (Rexora dashboard: KPI'lar, grafikler ve
-metinler önce `{{ state.page… }}` ham metni olarak görünüyordu). Kural: tasarımcıya boş kutu
-bırakma, kanvasta da view'daki içeriğin aynısı görünsün.
-- Veriyi akışla (microservice → setter) yüklesen bile, bağlanan şeklin **gerçekçi bir
-  örneğini** `variable_create` ile sayfa değişkeni olarak kur ve prop'u ona bağla — view'da akış
-  değeri ezer, kanvasta örnek görünür.
-- Kanvasta çözülmeyen ifadeler: `item.*` (repeater satırı), `Functions.*`, komponent adları ve
-  `Steps.*`. Bunları taşıyan prop'a `data` alanında tasarım değeri ver (metin olmayan prop'larda
-  kanvas `data`'yı çizer); metin prop'u çözülmeyen ifadeyi ipucu olarak gösterir, bu yüzden
-  metni mümkünse `state.page` üzerinden besle (`{{ state.page.summary.totalText }}`).
-- `repeater`'ın `rows`'u statik ya da `state.page`'e bağlı olsun; kanvas tek satırı şablon
-  olarak çizer.
-- Yer tutucu boşluk için BOŞ `container` kurma, `spacer` kullan. Boş kap kanvasta bırakma
-  alanı olarak ~130px yükseklik alır ve bulunduğu satırı şişirir (Rexora New Order: tablo
-  başlık satırı designer'da 148px, view'da 38px). Satırda yatay boşluk: `spacer` +
-  `mode:'fixed'` + `size: 0` + `appearance.widthType:'fixed'` / `widthString:'32px'`.
-
 **`stateBindings[]` (şema düğümündeki dizi)** Studio'nun state-bağımlılık özelliğidir:
 `[{ name, expression, targets: [{ elementId, elementProperty }] }]` — bir ifade değişince
 listedeki hedef prop'lara yazılır. Micro-op sözlüğünde karşılığı YOKTUR; yalnız
@@ -1824,15 +1911,24 @@ page_container
 ```
 start → [setter] btn.isLoading = true, btn.isDisabled = true, notification gizle
       → [microservice] sign-in (POST; email + password body'den)
-      → [condition] !!Steps.signIn.data.token
-          ├─ always → [setter] buton durumunu sıfırla
-          ├─ if   → [setcookie] { name:'APP_Token', value:'Steps.signIn.data.token',
-          │                        expiresInHours: 240 }
-          │         → [redirect] hedef sayfaya
-          └─ else → [setter] notification.content =
-                      { type:'code', ref:'Steps.signIn.data.message || "Giriş başarısız"' }
+          ├─ error  → [setter] btn.isLoading=false, btn.isDisabled=false,
+          │            notification.content =
+          │              { type:'code', ref:'Steps.signIn.error?.message ?? "Giriş başarısız"' }
+          └─ always → [condition] !!Steps.signIn.data.token
+                        ├─ always → [setter] buton durumunu sıfırla
+                        ├─ if   → [setcookie] { name:'APP_Token', value:'Steps.signIn.data.token',
+                        │                         expiresInHours: 240 }
+                        │          → [redirect] hedef sayfaya
+                        └─ else → [setter] notification.content =
+                                    { type:'code', ref:'Steps.signIn.error?.message ?? "Giriş başarısız"' }
 ```
 
+- **`sign-in` adımının `error` dalı burada ZORUNLUDUR, süs değil.** Dal bağlı değilken bu şablonun
+  `condition`'ı `Steps.signIn.data.token`'ı okur ve gateway'i **FLOW-028** ile uyarır (yukarıdaki
+  "Hangi yolu seçeceksin" notu): hata anında `data` `null`'dur, token okuması sessizce `undefined`
+  döner. Dal bağlanınca hata onun üzerinden sürer — `always`/`condition` yalnız BAŞARIDA çalışır,
+  yani `data.token` orada gerçek bir iş kuralıdır (uç 200 dönüp token'sız yanıt verirse), hata
+  algılama YÖNTEMİ değil.
 - **Cookie adı middleware'in okuduğu adla birebir aynı olmalı** (`cookie.APP_Token` —
   `platform_guide('middleware')` Tarif 1). Uyuşmazlık sessizce "hep 401" demektir.
 - `redirect` adımı `isRaw: true` iken `path` **çok satırlı JS bloğudur** (son ifade değeri döner) —
@@ -2022,9 +2118,14 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
 > (`dto_get` ile bak: genelde `role`, `role_name`, `roles_csv` vardır). Sayfa tarafında CSV
 > kullan — ayrıntı ve şablon `platform_guide('expressions')` §2.
 >
-> **Uç hata dönerse `.data` dizi değildir.** 401/404 sonrası `Steps.x.data` bir nesnedir ve
-> `rows || []` bunu yakalamaz (nesne truthy) → `rows.filter is not a function` /
-> `(items ?? []).map is not a function`. `Array.isArray(Steps.x?.data) ? Steps.x.data : []` yaz.
+> **Uç hata dönerse `.data` NULL'dur, hata gövdesi değil (ADR 0004, 2026-09-26).** 2026-09-26'ya
+> kadar `Steps.x.data` 401/404 sonrası hata gövdesiydi ve `rows || []` bunu yakalamıyordu (nesne
+> truthy) → `rows.filter is not a function` / `(items ?? []).map is not a function`; artık uç hata
+> dönünce `data` **null**'dur ve bu adım boş veriyle koşar — `rows` gibi bir listeye bağlarsan
+> bileşen `null`'ı boş liste sayar, `Array.isArray(...) ? ... : []` sarmalamaya artık gerek yok.
+> Hata OLDUĞUNU fark etmeden geçmemek için `error` dalı bağlayın (yukarıdaki §"4xx de hatadır",
+> gateway bunu bağlı değilken **FLOW-028** ile uyarır); hata gövdesini görmek istiyorsan
+> `Steps.x.error.body`'yi okuyun.
 
 ## ⚠️ `page_schema_patch` `html` komponentini reddediyor — katalogda mükerrer kayıt (2026-08-19)
 
@@ -2087,6 +2188,31 @@ micro-op hattına dönün.
 > uyarı yoktu. Silinmesini bilerek istiyorsanız çağrıyı `allowFlowDeletion: true` ile tekrarlayın;
 > yanıt `deletedFlows` ile hangi akışların gittiğini listeler.
 >
+> **Silinen akış geri kurulabilir (2026-09-26, ZM-27).** Sayfa kaydının sildiği akış artık revizyon
+> defterine `operation: delete` satırı olarak düşer (kaynağı `studio` ya da `mcp`). `flow_restore`
+> akışı son revizyonundaki ad, slug ve adımlarla AYNI id ile yeniden kurar; olaya bağlamaz —
+> geri geldikten sonra `set_event`. İki sınır: revizyon saklama süresi (budanan akış 404) ve
+> adımların hedeflediği komponentler — akış bir komponenti tetikleyen/parametre olarak
+> gösteriyorsa o komponent şemada durmalıdır (canlı ölçüldü: `flow_restore` "Trigger Element Id"
+> dış anahtarına çarpar).
+>
+> **Boşalan sayfa: `page_restore` (2026-09-26).** Sayfayı ve akışlarını birlikte geri kurar:
+> `revision_list(module: 'page', recordId: <pageId>)` → boşalmadan önceki revizyonu bul (`source` ve
+> `correlationId` yardım eder; `revision_get` ile içeriğine bak) → `page_restore({ revisionNo })`.
+> Platform önce eksik akışları adımsız kurar, sonra şemayı eski komponent id'leriyle yazar, sonra
+> adımları yazar — akış→komponent ve olay→akış dış anahtarları bu sırayla tek transaction'da çözülür.
+> Yanıt `restoredFlows` ve `deletedFlows` (N'den sonra bağlanmış, şimdi yetim kalan) döner.
+> Revizyonu kalmamış bir akış varsa 409 ve hiçbir şey yazılmaz.
+>
+> **Doğru revizyonu seç.** Şemayı yüklemeyen komutların (`UpdateProjectCommand`,
+> `UpdateApplicationCommand`…) yazdığı sayfa revizyonları komponent taşımaz; komponenti olan sayfayı
+> böyle bir revizyona döndürmek 409 `PageRevisionEmptyException` ile reddedilir (bilerek boşaltmak için
+> `allowEmpty: true`). `correlationId`'si `PatchPageSchemaCommand` ya da `UpdatePageCommand` olan
+> revizyonu seç. İki sınır daha: N'den beri silinen layout/rol/middleware/özel komponent ya da başka
+> sayfanın aldığı slug geri yüklemeyi dış anahtar/benzersizlik hatasıyla düşürür (transaction geri
+> alınır, veri kaybı yok); yalnız başka bir akışın adımından çağrılan (olaya bağlı olmayan) akışlar
+> geri kurulmaz — onlar için `flow_restore`.
+>
 > **FLOW-018 artık silinen düğümün ALT AĞACINI da görüyor.** Eskiden yalnız op'un kendi
 > `target`'ına bakılıyordu: bir kapsayıcı silinince ÇOCUĞUNA yazan setter sessizce kopuyor ve
 > uyarı hiç çıkmıyordu (09-05, `sign_in_form` → `btn_sign_in`).
@@ -2130,6 +2256,9 @@ micro-op hattına dönün.
   style + Kural 1h deseniyle yeniden kurulunca kart 400px'e ve ortaya oturdu. Gateway bunu **PAGE-014 (uyarı)** ile
   yanıtın `layoutWarnings` alanında bildirir. **Düzeni `style` ile kurmaya hiç kalkışma:**
   ortalama/yaslama/aralık işi kapsayıcının kendi `layout: 'flex'` prop grubuna aittir (Kural 1f-2).
+  **İstisna `html`:** onun `style`'ı yazarın işaretlemesine kapsamlı giren CSS metnidir (web'de iç
+  seçicili sınıf, mobilde belgenin stil bloğu) — string asıl biçimdir ve PAGE-014 onda susar. Mobilde
+  `html`'e nesne `style` verme: çizilmez (MOB-002).
 - **Menüde "bulunduğun sayfa" vurgusu: `sidebar`/`layout`'ta `activeHref`, `header`'da
   `activeNavHref`.** `sidebar` ve `layout` menü ağacını ortak renderer'la çizer: `activeHref` boşken
   tarayıcıdaki adrese uyan satırı kendileri vurgular, prop yazılırsa o satır vurgulanır (akıştan

package/dist/resources/guides/theme.md

@@ -47,7 +47,10 @@ Değişkenlerin tam listesi ve o projedeki değerleri: `theme_get(view:'resolved
 sırası bellidir: projenin tamamı için tema token'ı (`theme_update`), tekrar eden bir kalıp için
 adlı preset (`presets` + `style.$preset`), yalnız o düğüme özgü karar için düğümün kendi
 `style`'ı. Sabit hex yazmak yerine `var(--ng-accent-primary)` yazmak, düğümü temaya BAĞLI
-tutar.
+tutar. **Adı uydurmayın:** geçerli adlar temanın yaydığı değişkenlerdir (`theme_get({ view: 'resolved' })`'in `cssVars`'ı;
+yüzeyler `--ng-background-surface`, `--ng-background-surface-alt`, `--ng-background-canvas`). Mobil
+çizici yalnız bunları çözer; `var(--ng-surface)` gibi tanımsız bir ad cihazda saydam kalır ve iOS
+gölgesi içeriğe düşer (THEME-012 uyarısı).
 
 **2. Marka rengi tek çağrıdır.** `theme_update({ palette: { accent: { primary, hover } } })`
 sayfadaki her butonu, odak halkasını, seçili satırı ve grafik serisini birden çevirir. Komponent
@@ -98,7 +101,10 @@ theme_update({ theme: {
 ```
 
 **Yazı tipi ve ölçek:** `fontFamily` panelin Google Fonts listesinden bir ad olmalı — runtime
-fontu ADIYLA Google'dan çeker, tanınmayan ad sessizce sans-serif'e düşer (THEME-008).
+fontu ADIYLA Google'dan çeker, tanınmayan ad sessizce sans-serif'e düşer (THEME-008). Mobilde de
+aynı kural geçerlidir: cihaz aynı adı Google Fonts'tan TTF olarak indirip `expo-font` ile yükler
+(400 ve 700 kalınlık) — Android'de kalın yüz SENTETİKTİR (iOS gerçek kalın dosyayı çizer,
+ZM-10, 2026-09-26).
 
 ```jsonc
 theme_update({ theme: {

package/dist/resources/guides/translation.md

@@ -208,7 +208,7 @@ gerekmez — `schema.ts`'e dokunulmaz, katalog yeniden yüklenmez.
   `translation_update` artık uygulamanın bütün sayfalarının önbellek satırlarını düşürüyor
   (`RefreshPageCacheWhenTranslationChangedCommand`), okuma yolu cache-aside olduğu için bir
   sonraki `page_runtime_get` taze değeri kurar. Yazmadan hemen sonra okuyabilirsin.
-- Mobil runtime (`apps/mobile`) bu özelliği henüz beslemiyor — yalnız web.
+- Mobil uygulama runtime'ı (`@ng-apps/ui-native`, Expo) web ile aynı sözlüğü ve motoru kullanır (2026-09-25, plans/mobil-coklu-dil): `language-selector` mobil katalogda, cihazda dil sırası uygulama içi seçim → kayıtlı seçim → cihaz dili → varsayılan (`?lang` yalnız `/preview`'da), seçim uygulama çapında ve kalıcı, sekme etiketi `t:<anahtar>`, `X-Data-Language` sonraki isteklerle gider. Ayrıntı `platform_guide('mobile')` §Çok dil.
 
 ## Backend doğrulama sınırları (TR-001)
 

package/dist/resources/guides/workflow.md

@@ -651,9 +651,15 @@ Tam örnek, ölçülen çıktı şekli ve `code` çocuğu tuzağının çıkış
 
   ```js
   // dizi (isSingle:false) · nesne (isSingle:true) · düz değer (yalnız pk dönen yazma)
-  (Array.isArray(x.data) ? (x.data[0] && x.data[0].id) : (x.data && x.data.id !== undefined ? x.data.id : x.data))
+  (x.data && typeof x.data !== 'string' && typeof x.data.length === 'number' ? (x.data[0] && x.data[0].id) : (x.data && x.data.id !== undefined ? x.data.id : x.data))
   ```
 
+  Diziyi `Array.isArray` ile değil `.length` ile tanıyın: 2026-09-27'den önceki backend'de tablo
+  adımının listesi Jint'e sarılı bir CLR nesnesi olarak iniyordu ve `Array.isArray(x.data)` `false`
+  dönüyordu — koşuda (2026-09-24) giriş akışı bu yüzden her kullanıcıyı 401 ile reddetti
+  (`zeyrek-backend/docs/incident-log.md` #89). `.length`, `.map`, `.filter` o sürümde de çalışıyordu;
+  düzeltilmiş backend'de `Array.isArray` de doğrudur.
+
   Şekli bilmiyorsan bu yazımı kullan; `workflow_preview` çıktısında `steps[].output`'a bakarak
   hangi vakada olduğunu da görebilirsin.