@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.22

package/dist/resources/guides/layout.md

@@ -4,6 +4,10 @@ Sayfaların paylaştığı kabuk: yan menü, üst şerit, kullanıcı menüsü v
 gireceği delik. Şema gövdesi ve koordinat modeli için `platform_guide('page')` (Kural 1,
 1d, 1f); komponent sözleşmeleri için `platform_guide('component')`.
 
+> **Mobil uygulamada** kabuk `app-bar` + tek `slot`'tur; sekmeler uygulama ayarı
+> (`properties.mobile.tabs`), çekmece `drawer` widget'ıdır. Web kabuk bileşenleri (`navigations`,
+> `sidebar`, `header`) `MOB-004` alır — `platform_guide('mobile')` §Gezinme.
+
 ## Karar kuralları
 
 **1. Layout, tek `slot` içeren SIRADAN bir komponent ağacıdır.** Ayrı bir dil yoktur:
@@ -61,7 +65,7 @@ yapılan eski numaraya artık gerek yok.
 NEREDE durduğunu değil, BİÇİMİNİ söyler (dikey kolon / yatay şerit / dolgu yüzeyi). Hem
 runtime hem Studio tuvali bölgeleri 12 kolonluk ızgarayla yerleştirir.
 
-**7. Mobilde flex YIĞILMAZ.** Runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer.
+**7. Dar ekranda flex YIĞILMAZ.** Runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer.
 Telefonda alt alta düşmesi gereken satırı `layout:'grid'` ile kur; `layout:'flex'` +
 `direction:'row'` telefonda da yan yana kalır (375px'te ölçüldü: ızgara çocukları 375/375px
 alt alta, flex çocukları 49/310px yan yana). Not: `wrap` varsayılanı artık açık (2026-09-01) —
@@ -140,8 +144,8 @@ bağlantı nesnesi ya da tam yol).
              "direction": { "type": "static", "data": "row" } },
   "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 80 }, "position": { "x": 0, "y": 0 } }] }
 
-// KÖTÜ — telefonda 49px'lik yan menü: row flex mobilde yığılmaz (Kural 7)
-// Mobilde alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
+// KÖTÜ — telefonda 49px'lik yan menü: row flex dar ekranda yığılmaz (Kural 7)
+// Dar ekranda alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
 // flex anlamının devreye girmemesi.
 ```
 
@@ -179,9 +183,9 @@ bunlardan biri olabilir:
 |---|---|
 | ~~`heightType` yalnız `auto` \| `fixed`~~ | **28 Ağustos'ta kapandı:** üçüncü değer `fill` (Kural 5b) |
 | ~~Kök kap viewport'a kilitlenmez~~ | **28 Ağustos'ta kapandı:** `fill` verilmiş kök 100vh (Kural 5b) |
-| Flex mobilde yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
-| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve mobilde AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
-| Mobil çekmece (overlay) yok | Telefonda içeriğin üstüne binen panel kurulamaz |
+| Flex dar ekranda yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
+| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve dar ekranda AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
+| Dar ekranda çekmece (overlay) yok | Telefon genişliğinde içeriğin üstüne binen panel kurulamaz (mobil UYGULAMADA çekmece `drawer` widget'ıdır — `platform_guide('mobile')`) |
 
 ---
 
@@ -189,7 +193,7 @@ bunlardan biri olabilir:
 (`injectPageSchemaIntoSlots`, `getResolvedLayoutViews`), `apps/studio/src/features/page/api/page.mappers.ts`
 (`mapPageLayoutToPreview`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`
 (`resolveNodeBoxStyle` — slot'un `y / auto` satırı, flex çocuk genişliği),
-`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (mobil media kuralı),
+`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (dar ekran media kuralı),
 `packages/ng-apps-screen-builder/src/flex-layout.ts` (`getFlexChildStyle` — `widthType`
 fill/fixed/auto dalları, `normalizeCssSize` kabul kuralı; tuval ve runtime aynı fonksiyonu okur),
 `apps/studio/src/features/page/components/appearance/appearance-size.functions.ts` (panelin

package/dist/resources/guides/mobile.md

@@ -0,0 +1,264 @@
+# Mobil uygulama rehberi
+
+Mobil uygulama (`application_create` → `type: 'mobile'`) web uygulamasıyla **aynı şemayı**, aynı
+micro-op sözlüğünü ve aynı akış motorunu kullanır; farkı çizerdedir. Sayfalar
+`@ng-apps/ui-native` ile React Native olarak çizilir: Studio'da (kanvas, `/preview`, `/dev|/view`)
+react-native-web üzerinde, cihazda Expo uygulamasında. Gateway uygulamanın tipini kendisi okur
+(platform profili) ve mobilde çizilmeyecek her yazımı `MOB-*` satırıyla söyler — yazım yine
+platforma gider, veri düşürülmez.
+
+**Sözlük.** Bu rehberde "mobil" yalnız **mobil uygulama** demektir. Web uygulamasının telefondaki
+dar ekran kırılımı (`hideOn: 'mobile'`, `breakpoint: mobile`) ayrı bir kavramdır ve
+`platform_guide('page')` / `platform_guide('layout')`'ta anlatılır; alan adları değişmedi, yalnız
+anlamları ayrı.
+
+## Kurulum sırası
+
+1. **Uygulama ve kabuk.** Tek çağrıda: `mobile_app_create` (uygulama + sayfalar + kabuk layout'u +
+   sekme ayarı + ana sayfa bağı, `dryRun` ile önce planı görün). Tekil araçlarla aynı sıra:
+   `application_create({ type: 'mobile' })` → `page_create` × N → `layout_create` (kabuk) →
+   `page_update({ layoutId })` × N → `application_update({ homepageId, properties.mobile.tabs })`.
+   Sekme ayarı sayfa **id**'si ister; bu yüzden sayfalardan SONRA yazılır.
+2. **Veri.** Entity, microservice ve workflow web'dekiyle aynıdır (`platform_guide('microservice')`).
+   Sayfa akışı `microservice` adımıyla aynı uçları çağırır.
+3. **Ekranlar.** `page_schema_patch` ile bileşen ekle, akış bağla (`flow_create` → `set_event`).
+4. **Doğrulama.** `page_screenshot` (mobilde varsayılan `device: 'phone'`, 390x844 @2) ve
+   `page_runtime_get({ resolveStyles: true })` (düğümün React Native stili). Ayrıntı §Doğrulama.
+
+`page_create` mobil uygulamada kökü kendisi kurar: `page_container`, `layout` prop'u YOK,
+`direction: 'column'`, `blocks: []`, `appearance.heightType: 'fill'` — kök telefon ekranını doldurur.
+
+## Bileşenler
+
+Mobil uygulamanın bileşen kataloğu ayrıdır (backend satırları `(slug, type: 'mobile')`).
+`component_list` ve `component_get` mobil uygulamada **kendiliğinden** mobil kataloğu okur.
+`component_get` yanıtı `platform: 'mobile'` ile üç katman taşır: `knowledge` (web kaydı — mobil
+şema web sınıfını genişlettiği için prop'ların anlamı oradadır), `mobileKnowledge` (bu bileşenin
+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`) 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.
+
+- Katalogda olmayan tip `MOB-003` alır ve backend `unknown-type` (422) ile reddeder. Mobil pakette
+  olan ama bu uygulamanın kataloğuna yazılmamış tip için gateway katalog senkronunu gösterir; web'de
+  olup mobilde henüz olmayan için ne zaman geleceğini söyler (Dalga 2, Faz 3).
+- **Katalog A** (FlutterFlow paritesi, 2026-09-24) on bileşen ekledi: `badge`, `avatar`, `progress`,
+  `radio`, `checkboxgroup`, `choice-chips`, `collapsible-container`, `slider`, `tabs`, `tooltip`;
+  `button` mobilde `secondary`/`ghost`/`link` varyantlarını ve `icon` boyunu alır. Tam liste
+  `component_list`'tir.
+- **Katalog B** (FlutterFlow paritesi) önce dört prop'la başladı; hepsi YALNIZ mobil şemadadır:
+  `scroll-view.stickyHeader` (ilk çocuk dikey kaydırmada üstte kalır), `numberinput.variant: stepper`
+  (± düğmeleri, iç roller `__decrement`/`__increment`), `modal.presentation: center | sheet | fullscreen`
+  (alt sayfa şeritten aşağı sürükleyince `change { isOpen: false }` ile kapanır; en çok ekranın %90'ı,
+  uzun içerik için içine `scroll-view`). En-boy oranı yeni
+  prop DEĞİLDİR: boyut panelinin `appearance.aspectRatio`'su mobilde kaplara da uygulanır
+  (§Yerleşim).
+  İkinci adımda dört bileşen: `markdown` (Markdown çizer, HTML çalıştırmaz; bağlantı `linkClick { href }`)
+  ve `calendar` (satır içi takvim, tek gün ya da aralık; prop adları ve `change` biçimi web
+  `datepicker`ınki) mobile özgüdür; `otpinput` ve `qrcode` web ikizleridir, kuralları web modülünden.
+  Üçüncü adımda dört bileşen daha: `stack` (katmanlar: ilk çocuk taban, üsttekiler yığının 9 noktalı
+  `alignment`ıyla hizalanır — çocukta hiza alanı YOKTUR), `list-item` (satır: baş · başlık · alt başlık ·
+  son; `click`), `fab` (yüzen düğme: sayfanın neresinde olursa olsun ekranın alt köşesinde durur, içerikle
+  kaymaz; `click`, iç rol `__press`) mobile özgüdür; `carousel` web ikizidir (`activeIndex`,
+  `slideChange`) ve mobilde bırakılabilir — çocukları sayfalardır.
+  Dördüncü adım Katalog B'yi kapattı: `timer` (mobile özgü; başlat/duraklat `isRunning`, sıfırlama `value`
+  yazmak; `tick { value }` her saniye, `finish`), `rating`, `multi-select` (değer `{ label, value }`
+  dizisi) ve `toast` web ikizleridir. `toast`ın bildirimi sayfadan bağımsız yaşar (`redirect`ten sonra da
+  görünür), açık modal ya da çekmecenin de üstünde çizilir; akışın tipli `alert` uyarıları cihazda da
+  toast'tur.
+- **Katalog C** (cihaz modüllü bileşenler) medyayla başladı: `video` web ikizidir (cihazda `expo-video`,
+  kanvas ve önizlemede HTML5 `<video>`; `click` yalnız `controls: false` iken), `audio` (oynat/duraklat,
+  ilerleme izi; iç roller `__toggle`, `__track`) ve `lottie` (Lottie JSON ya da `.lottie`) mobile özgüdür.
+  İkisinde çalma `isPlaying` prop'udur: akış `true`/`false` yazar, bileşen `play`/`pause`/`ended` ya da
+  `finish` olayında `{ isPlaying }` yayar ve prop'u gerçeğe döndürür.
+  İkinci adım: `signature` web ikizidir (her vuruşta `change { value }` PNG data URL; vuruş sürerken sayfa
+  kaymaz; iOS'ta itilmiş sayfada sağa vuruş sayfayı kapatır, ARC-116) ve `webview` mobile özgüdür (web
+  `iframe`inin karşılığı): `src` ya da `html`; yüklemeden sonra başka belgeye giden gezinme varsayılan olarak
+  engellenir ve `navigate { url }` yayar, adres yalnız kullanıcının dokunduğu bağlantıda sistem tarayıcısında
+  açılır (`allowNavigation` görünümde açar); sayfa akışa `window.ReactNativeWebView.postMessage(metin)` →
+  `message { data }` ile yazar, yüklenemeyen sayfa `error` yayar.
+- Web'e özgü bileşenlerin mobil karşılığı:
+
+| Web | Mobilde |
+|---|---|
+| `navigations`, `sidebar`, `header`, `layout-shell` | `app-bar` + Ayarlar › Sekmeler + `drawer` widget'ı (`MOB-004`) |
+| `popover` | `modal` widget'ı |
+| `pagination` | `repeater` + "daha fazla yükle" düğmesi |
+| `breadcrumb` | yığın gezinmesi (app-bar geri düğmesi) |
+| `iframe` | `webview` (`src` ya da `html`) |
+| `theme-toggle` | cihaz teması |
+
+**Harici bileşen mobilde yoktur** (`MOB-006`): protokol v1 tarayıcı `.mjs` paketidir;
+`external_component_*` araçları mobil uygulamada platforma gitmez.
+
+## Yerleşim — yalnız flex
+
+Mobil çizer 12 sütunlu ızgarayı **okumaz**: sıra dizi indeksidir, yerleşim flex'tir.
+
+- `blocks[]`, `set_block`, `layout: 'grid' | 'cssgrid'` yazılır ama çizilmez (`MOB-001`).
+  `add_component` / `move_component`'ın `index`'i dizideki sıradır; gateway konum çevirisi yapmaz.
+- Kaplar flex kabıdır: `direction`, `gap`, `horizontalAlign`, `verticalAlign`, `wrap`, `size`.
+  Mobil `container` şemasında `layout` prop'u yoktur.
+- Ölçü `appearance` ile: `widthType: 'fill' | 'auto' | 'fixed'` (+ `widthString`),
+  `heightType: 'fill' | 'auto' | 'fixed'` (+ `heightString`). `fill` kalan alanı alır.
+- En-boy oranı `appearance.aspectRatio` (sayı; 16:9 için `1.78`): boy genişlikten türer. Koşullar:
+  `heightType: 'auto'` ve genişlik belli — `widthType: 'fill'` ya da `'fixed'` (içerik genişliğinde
+  web ile cihaz oranı ters yönden çözer, uygulanmaz). Web'den farkı: mobilde **akış kapları** da oran
+  alır (`container`, `form`, `safe-area`, `scroll-view`) ve akışları oranlı boyu doldurur; öteki
+  bırakılabilir tipler, widget örneği, sayfa kökü ve `modal`/`drawer` almaz; `image` oranı kendi
+  çizimine yazar.
+- Hiza (`verticalAlign` `top | middle | bottom`, `horizontalAlign` `left | center | right`) web ile
+  aynıdır. Dikey hizanın boşluğu kabın boyundan gelir: `heightType` `fill`, `fixed` ya da oranlı kapta
+  akış kabın boyunu doldurur; boyu içerikten gelen sütun kapta dikey hiza etkisizdir (satır kapta farklı
+  boydaki kardeşleri yine hizalar). `stretch` de web gibi: ana eksende çocukları yayar, çapraz eksende gerer.
+- Birim: `px` ve `%`. `em`/`rem` tema puntosuyla çarpılır; `calc()` ve `vw/vh` React Native'de yoktur
+  (`MOB-002`).
+
+## Görünüm — tipli gruplar
+
+React Native'de CSS yoktur; tipli stil grupları **derlenir** (web'in `composeTypedStyle` ikizi,
+aynı katman sırası: tema taban → gruplar → serbest `style`).
+
+- `surfaceStyle` → zemin, köşe, kenarlık, gölge (tek katman), opaklık, taşma.
+- `typographyStyle` → renk, aile (tek ad), punto, kalınlık, hizalama, satır yüksekliği.
+- 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:
+
+| Alan | Yerine |
+|---|---|
+| `className` | `surfaceStyle` / `typographyStyle` |
+| serbest `style` nesnesi (alt seçici `&:hover`, `&__body`) | tipli gruplar; düz anahtarlar (ör. `padding`) çevrilir, alt seçici düşer |
+| `hoverStyle` | yok — dokunmatikte üzerine gelme durumu yoktur |
+| `tooltip`, `tooltipPosition` | düğümü `tooltip` bileşenine sarın (dokunuşla açılır, yanı `side`) ya da açıklamayı metin olarak koyun |
+| `zIndex` | katman için `modal` ya da `drawer` widget'ı |
+
+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
+`componentStyles`/preset katmanı mobil çizerde henüz uygulanmıyor ve rapora da girmez.
+
+## Görünüm — shadcn/ui
+
+Bileşenler shadcn/ui görünümünde çizilir (react-native-reusables ilkelleri, NativeWind). Renk ve
+köşe yine **proje temasından** gelir: `--ng-*` değişkenleri shadcn token'larına köprüyle çevrilir
+(`--primary` ← `accent.primary`, `--destructive` ← hata rengi, `--border`, `--input`, `--ring`…).
+`theme_update` web'i ve mobili birlikte değiştirir; koyu kip aynı köprünün ikinci çözümüdür. Ölçü
+(alan yüksekliği, punto, iç boşluk) temanın `--ng-form-*` değişkenlerinden gelir. Yazı **ailesi**
+köprüde yoktur: temanın ailesi alanlarda, başlıklarda ve sekme çubuğunda uygulanır; `text` ve düğme
+etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tipiyle çizilir.
+
+- `button`: `kind` rengi, `variant` kullanımını seçer — `solid` dolu (`kind: error` → shadcn
+  `destructive`), `outline` çerçeveli, `text`/`ghost` zeminsiz; mobilde ayrıca `secondary` (nötr
+  dolgu) ve `link`. `info`/`success`/`warning` → temanın `--status-*` renkleri. Eşlemenin tamamı ve
+  bilinen sınırlar: `component_get('button')` → `mobileKnowledge.propNotes`.
+- `switch` platformun kendi anahtarı DEĞİLDİR: üç barındırıcıda (kanvas, önizleme, cihaz) aynı
+  shadcn anahtarı çizilir; kanvasta basılamadığı için soluk görünür.
+- Web sayfası kendi bileşen ailesiyle çizilir; iki platformun görünüm farkı bilinçlidir, ortak olan
+  temadır. Yakalama seçicileri (`role="button"`, `__tabs__item-<slug>`, `submit` köprüsü) görünümden
+  bağımsızdır (§Doğrulama).
+
+## Gezinme
+
+- **Yığın varsayılandır; ayar yoktur.** `redirect` adımı hedef sayfayı yığına iter, geri hareketi
+  (cihaz geri tuşu, app-bar geri düğmesi, tarayıcı geri) önceki ekrana döner. Göreli yol uygulama
+  köküne eklenir; tam adres (`https://…`) dışarıda açılır.
+- **Sekmeler uygulama ayarıdır, layout'ta değil.** `application_update({ properties: { mobile: { tabs } } })`:
+
+```json
+{
+  "mobile": {
+    "tabs": {
+      "enabled": true,
+      "style": "default",
+      "items": [
+        { "page": "<page_list id>", "label": "Görevler", "icon": "list" },
+        { "page": "<page_list id>", "label": "Profil", "icon": "user" }
+      ],
+      "showLabels": true
+    }
+  }
+}
+```
+
+  `items` 1–5 sayfa **id**'si (slug değil), tekrar yok; `style: 'floating'` köşe `pill` + gölge `md`
+  çizer. Çubuğun rengi ayarda YOKTUR: zemin `surface`, seçili `accent-primary`, seçilmemiş
+  `text-secondary` — değiştirmek için `theme_update`; eski `appearance` alanı okunmaz; `style: 'custom'` + `customWidgetId` çubuğu kendi widget'ınla çizer. Tutarsız ayar ve
+  layout/sayfada eski `tab-bar` / `drawer-menu` düğümü `MOB-007` alır. Sekme dışı sayfalar yığına açılır.
+- **Çekmece bir bileşendir.** `drawer` widget'ı + `app-bar`'ın `menuTarget` prop'u çekmeceyi açar.
+- 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`.
+
+## Çok dil
+
+Mobil uygulama web ile **aynı sözlüğü ve aynı motoru** kullanır (plans/mobil-coklu-dil, 2026-09-25):
+`project_update(languages, defaultLanguage)` → prop'u bağla (`set_prop_type(target, prop, 'translation', ref)`)
+→ `translation_update`. Kurulum ve fallback zinciri `platform_guide('translation')`.
+
+- **Dil değiştirici:** `language-selector` mobil katalogdadır (`component_get` → `mobileKnowledge`):
+  `dropdown`un tam ekran `Modal` listesi, tetikleyici `role="combobox"`, seçenekler dilin yerel adıyla
+  (`tr` → Türkçe). Seçim `machine.setLanguage` ile bütün prop'ları yerinde çözer ve cihazda uygulama
+  çapında yayılır: öteki sekmelerin ekranları ve sekme etiketleri de değişir, makine yeniden kurulmaz.
+- **Cihazda boot sırası:** uygulama içi seçim → cihazda kayıtlı seçim (`zeyrek:<app>:lang`) → cihaz dili
+  → projenin varsayılanı. `?lang` CİHAZDA YOKTUR; `/preview`'da vardır, bu yüzden `page_screenshot(language:)`
+  mobil sayfada da çalışır — kanıt için sayfaya seçici koymak gerekmez.
+- **Sekme etiketi:** `properties.mobile.tabs[].label` `t:<anahtar>` ile çevrilir (doğrulama mesajıyla aynı
+  önek); `mobile_app_create` `tabs[].label` de kabul eder. Sayfa adı fallback'i düz kalır.
+- **Çerçeve:** cihazda `alert`/`confirm` düğmeleri (`Tamam`/`Evet`/`Hayır` ↔ `OK`/`Yes`/`No`) uygulama dilini
+  izler; mesaj gövdesi akışın kendi metnidir.
+- **Doğrulama:** `page_screenshot({ language: 'en' })` ikinci dilin karesi;
+  `page_screenshot({ actions: [{ select: '<seçici elementId>', value: 'en' }] })` seçiciyi sürer
+  (`optionsSeen` proje dili sayısıdır); seçici sonrası sekme çubuğunun `t:` etiketleri de aynı karede
+  çevrilir (ölçüldü 2026-09-25: `Ana/Liste`).
+- **Bilinen fark:** mobilde istemci tarafı şema doğrulaması yoktur, `t:` doğrulama mesajı akışta
+  (`Loc()` / `t()`) çözülür.
+
+## 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 |
+| `confirm` | `yes` / `no` dalları |
+| `download` | adres cihazın açma sayfasında açılır, gövde paylaşım sayfasına gider (`MOB-005`, bilgi) |
+| `storage` | cihaz deposu |
+| `setcookie` | cihaz deposuna yazar (`MOB-005`, bilgi); paletten yalnız web'de sunulur |
+
+Sayfa ve layout `mount` akışları ilk çizimden sonra, `destroy` akışları sayfa kalkarken koşar.
+`Functions.<ad>()` uygulama ve sayfa fonksiyonlarını görür (`platform_guide('functions')`).
+
+## Doğrulama
+
+- `page_screenshot({ applicationSlug, pageSlug })` mobil uygulamada `device: 'phone'` (390x844, kare
+  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
+  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`
+  bileşeninin sekmesini anahtarıyla (`<elementId>__tab-<anahtar>`) bulur.
+- `flowRuns: 0` + `requests: 0` bir tıklamada akışın koşmadığını söyler: olay bağını
+  `page_runtime_get`, akışı `flow_get` ile doğrulayın.
+- Kuru doğrulama: `page_schema_validate` mobil kataloğa karşı doğrular (`MOB-003`).
+
+## Cihazda önizleme
+
+Expo uygulaması (`apps/mobile-runtime`) aynı sayfayı native çizer. Derin bağlantı
+`zeyrek://open/{proje}/{uygulama}/{sayfa}?env=<ortam>` **token taşımaz**: cihazdaki uygulama zaten giriş
+yapmış olmalıdır. Canlı önizleme sayfa şeması değişikliğini (`/hubs/page-schema`) dinler; yazdığın
+yama cihazda yenilenir.
+
+## Bilinen farklar
+
+- Piksel paritesi yoktur: yazı tipi ölçüsü, gölge ve güvenli alan cihaza göre değişir. Parite yapısaldır.
+- Bileşen kataloğu dalga dalga gelir; `component_list` ne döndürüyorsa odur.
+- Temanın bileşen stilleri (`componentStyles`, preset'ler) mobil çizerde henüz uygulanmıyor.
+- Dar ekran kırılımı (`hideOn: 'mobile'`) mobil uygulamada anlamsızdır: ekran zaten tek boydur.

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ı
 
 ```
@@ -386,11 +390,8 @@ göstermek error flow'un işidir.
 > `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.**
 > `onError` hata akışını koşturmadan önce `machine.setStorage('error', errorInfo)` yapar
@@ -520,14 +521,14 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > 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` | ✅ | ✅ | `Runtime.svelte` · `runtime-tasks.ts` (`download` mobilde açma/paylaşım — `MOB-005`) |
+> | `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()`
@@ -861,7 +862,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`
@@ -950,10 +951,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
@@ -1097,6 +1098,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

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/server.js

@@ -39,6 +39,7 @@ import { registerMergeTools } from "./tools/merges.js";
 import { registerRevisionTools } from "./tools/revisions.js";
 import { registerActivityTools } from "./tools/activities.js";
 import { registerDtoTools } from "./tools/dtos.js";
+import { registerMobileTools } from "./tools/mobile.js";
 const moduleRegistrations = {
     platform: registerPlatformTools,
     project: registerProjectTools,
@@ -80,6 +81,7 @@ const moduleRegistrations = {
     merge: registerMergeTools,
     activity: registerActivityTools,
     revision: registerRevisionTools,
+    mobile: registerMobileTools,
 };
 export function createGatewayServer(platform) {
     const server = rejectUnknownArguments(instrumentServer(new McpServer({ name: "ngapps", version: "0.1.0" }), platform.config));

package/dist/tools/applications.js

@@ -1,6 +1,44 @@
 import { guid, pagingParams, readOnly, writes, updates, destructive } from './common.js';
 import { handle } from '../platform/responses.js';
+import { forgetApplication, readApplicationPlatform, resolveApplication } from '../knowledge/platform/resolve.js';
+import { mobileTabsProblems, readMobileTabs } from '../knowledge/platform/mobileTabs.js';
+import { findingLine } from '../knowledge/platform/profile.js';
 import { z } from 'zod';
+/**
+ * MOB-007 (sekme ayarı) — `properties.mobile.tabs` yazan mobil uygulama çağrısının denetimi. Yazım
+ * platforma YİNE gider (D3; backend `properties`'i doğrulamaz): bulgu `platformWarnings`'e düşer.
+ * Sayfa ve widget listesi okunamazsa o denetimler atlanır, biçim denetimi yine koşar.
+ */
+export async function mobileTabsWarnings(platform, applicationId, projectSlug, homepageId, properties) {
+    const tabs = readMobileTabs(properties);
+    if (tabs === undefined)
+        return [];
+    const pages = applicationId && projectSlug
+        ? await platform.tenant('GET', projectSlug, `/pages/${applicationId}`, { query: { pageIndex: 0, pageLength: 200 } })
+            .then(response => (response?.data ?? []).map(page => ({ id: String(page.id ?? '') })))
+            .catch(() => undefined)
+        : undefined;
+    const widgetIds = applicationId && projectSlug
+        ? await platform.tenant('GET', projectSlug, `/components/${applicationId}`, { query: { pageIndex: 0, pageLength: 999 } })
+            .then(response => new Set((response?.data ?? []).filter(entry => entry.kind === 'widget').map(entry => String(entry.id ?? ''))))
+            .catch(() => undefined)
+        : undefined;
+    return mobileTabsProblems(tabs, {
+        ...(pages ? { pages } : {}),
+        ...(homepageId ? { homepageId } : {}),
+        ...(widgetIds ? { widgetIds } : {})
+    }).map(message => findingLine({
+        code: 'MOB-007',
+        severity: 'warn',
+        message,
+        guide: "platform_guide('mobile') §Gezinme"
+    }));
+}
+function withPlatformWarnings(response, warnings) {
+    if (warnings.length === 0 || !response || typeof response !== 'object' || Array.isArray(response))
+        return response;
+    return { ...response, platformWarnings: warnings };
+}
 export function registerApplicationTools(server, platform) {
     const config = platform.config;
     server.registerTool('application_list', {
@@ -34,7 +72,14 @@ export function registerApplicationTools(server, platform) {
             notFoundPageId: guid.optional()
         },
         annotations: writes
-    }, handle(config, ({ projectId, ...body }) => platform.org('POST', `/applications/${projectId}`, { body })));
+    }, handle(config, async ({ projectId, ...body }) => {
+        const warnings = readApplicationPlatform(body.type) === 'mobile'
+            ? await mobileTabsWarnings(platform, undefined, undefined, undefined, body.properties)
+            : [];
+        const response = await platform.org('POST', `/applications/${projectId}`, { body });
+        forgetApplication(platform);
+        return withPlatformWarnings(response, warnings);
+    }));
     server.registerTool('application_update', {
         title: 'Application güncelle',
         description: 'Application bilgilerini günceller; homepageId zorunludur (mevcut değeri application_get ile alın).',
@@ -49,11 +94,23 @@ export function registerApplicationTools(server, platform) {
             notFoundPageId: guid.optional()
         },
         annotations: updates
-    }, handle(config, ({ id, ...body }) => platform.org('PUT', `/applications/${id}`, { body })));
+    }, handle(config, async ({ id, ...body }) => {
+        const current = await resolveApplication(platform, id);
+        const warnings = current?.platform === 'mobile'
+            ? await mobileTabsWarnings(platform, id, current.projectSlug, body.homepageId, body.properties)
+            : [];
+        const response = await platform.org('PUT', `/applications/${id}`, { body });
+        forgetApplication(platform, id);
+        return withPlatformWarnings(response, warnings);
+    }));
     server.registerTool('application_delete', {
         title: 'Application sil',
         description: 'Application\'ı kalıcı olarak siler.',
         inputSchema: { id: guid },
         annotations: destructive
-    }, handle(config, args => platform.org('DELETE', `/applications/${args.id}`)));
+    }, handle(config, async (args) => {
+        const response = await platform.org('DELETE', `/applications/${args.id}`);
+        forgetApplication(platform, args.id);
+        return response;
+    }));
 }