@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/resources/guides/mobile.md

@@ -20,8 +20,10 @@ anlamları ayrı.
    `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`).
+   Sayfa akışı `microservice` adımıyla aynı uçları çağırır. Veri bağlamanın telefon
+   kararları: `platform_guide('mobile-connect-data')`.
+3. **Ekranlar.** `page_schema_patch` ile bileşen ekle, akış bağla (`flow_create` → `set_event`). Cihaza
+   dokunan adımlar (izin, konum, bildirim, reklam, geri, kod tarama): `platform_guide('mobile-steps')`.
 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.
 
@@ -119,12 +121,9 @@ mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`ap
 - **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`:
-  `table` (varsayılan, yatay kaydırılan tablo; başlığa dokunuş `__sort-<kolon>`) ya da `cards` (satır başına
-  kart). Eylemler `__action-<satır>-<sıra>`, `dropdown` kipinde `__more-<satır>` → alttan eylem sayfası;
-  sayfa çubuğu `__page-prev`/`__page-next`. Filtre düzenleyicisi, özet satırı ve sabit eylem sütunu yok.
+- **Faz 10:** `datatable` web ikizidir (kolon, sıralama, sayfa ve akış sözleşmesi web'in). Telefon farkları
+  (`variant: table | cards`, filtre çipleri, düzenleme alt sayfası, sonsuz kaydırma) `component_get`
+  `mobileKnowledge`'ta; bağlı tablonun telefon ayarı `platform_guide('mobile-connect-data')`'da.
 - Web'e özgü bileşenlerin mobil karşılığı:
 
 | Web | Mobilde |
@@ -136,6 +135,7 @@ mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`ap
 | `iframe` | `webview` (`src` ya da `html`) |
 | `theme-toggle` | cihaz teması |
 | `fileUpload` | `fileInput` (alan) ya da `filebutton` (düğme) — sürükle-bırak yok |
+| `attachments` | `filebutton` (`isMultiple`) — önizlemeli kart ızgarası, popup ve sürükle-bırak yok |
 
 **Harici bileşen mobilde yoktur** (`MOB-006`): protokol v1 tarayıcı `.mjs` paketidir;
 `external_component_*` araçları mobil uygulamada platforma gitmez. **Geçici yol `html`** (2026-09-28):
@@ -365,7 +365,7 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
 ## 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
+  (cihaz, app-bar ya da 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 } } })`:
 
@@ -377,7 +377,7 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
       "style": "default",
       "items": [
         { "page": "<page_list id>", "label": "Görevler", "icon": "list" },
-        { "page": "<page_list id>", "label": "Profil", "icon": "user" }
+        { "page": "<id>", "label": "Sepet", "badge": { "source": "state", "ref": "sepet.adet" }, "reselect": "keep" }
       ],
       "showLabels": true
     }
@@ -385,14 +385,19 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
 }
 ```
 
-  `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
+  `items` 1–5 sayfa **id**'si (slug değil), tekrarsız; `floating` köşe `pill` + gölge `md`. Renk ayarda YOK: zemin `surface`, seçili `accent-primary`, seçilmemiş
+  `text-secondary` (`theme_update`); `style: 'custom'` + `customWidgetId` çubuğu o widget'la ç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.
+  `badge.ref` **saklı** state yolu; `keep`: ikinci dokunuşta yığın durur.
+  Çubuk düzeyinde iki davranış anahtarı vardır ve **yalnız varsayılandan ayrılınca yazılır**: `"keepStackOnSwitch": false`
+  (sekme değişince hedef sekme köke döner; alan yoksa yığın korunur) ve `"hideOnKeyboard": true` (klavye açılınca çubuk
+  gizlenir; alan yoksa görünür). `true`/`false`'tan başka değer (ör. metin `"false"`) yok sayılır ve `MOB-007` uyarır.
+  İkinci dokunuş (`reselect`) ile sekme değişimi (`keepStackOnSwitch`) ayrı ayardır; eski runtime anahtarları bilmez ve
+  varsayılan davranışta kalır.
 - **Çekmece bir bileşendir.** `drawer` widget'ı + `app-bar`'ın `menuTarget` prop'u çekmeceyi açar.
   Ç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ışı:
+  (sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); liste → detay → form:
   `ngapps://examples/mobile-list-detail-form`; kod tarama (düğme → `scan-code` → alana yaz):
   `ngapps://examples/mobile-scan-code`.
 
@@ -425,9 +430,9 @@ Mobil uygulama web ile **aynı sözlüğü ve aynı motoru** kullanır (plans/mo
 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 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.
+`haptic`, `location`, `notification-permission` / `-schedule` / `-cancel`, `permission`, `open-settings`, `back`,
+`ad-show` ve `scan-code`'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
@@ -519,17 +524,30 @@ variable_create({ applicationId, pageId, variables: [
   kabuğun yükleme göstergesi) durur, aynı sayfanın iki karesi aynı çıkar. Hareketin kendisini görmek için
   `motion: 'play'` (kare çekildiği ana bağlıdır; yanıt `motionNote` taşır).
 
-## Cihazda önizleme
+## Studio'da ne görünür
 
-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.
+Mobil ekran tasarımcısındaki telefon ekranın **runtime çizimidir**: kayıtlı sayfa gerçek veri, kabuk ve akışlarla
+çizilir, kaydedilmemiş değişiklik anında üstüne yansır. Ayrı bir "canlı" kip yoktur; "Canlı" yalnız
+production ortamının adıdır. **Düzenle** kipinde dokunuş seçer (production'da akış koşmaz), **Dene** kipinde
+uygulamadaki gibi çalışır ve development'ta gerçek veriye yazar. **Ekran durumu** çipi (Gerçek veri · Örnek veri ·
+Yükleniyor · Boş · Hata · Erişim yok) hâli yalnız telefonda zorlar, şemaya yazmaz. **Kim olarak** çipi telefonu bir
+uygulama kullanıcısı, rol ya da Studio kullanıcısı olarak çizer; o kimliğin göremediği bileşen taralıdır. Yeni
+bağlanan liste kayda kadar örnek satırla çizilir. `page_screenshot` aynı runtime'ı kayıtlı hâliyle çeker (taslak,
+örnek rozeti ve tarama karede yok). Tasarımcı şema yayınına abone değildir: MCP'nin yazdığı değişikliği açık
+tasarımcı kendiliğinden göstermez, kullanıcı ekranı yeniden açar.
+
+## Cihazda dene
+
+Studio'daki **Cihazda dene** penceresinin iki yolu var; tarayıcıda deneme yolu yoktur. **Telefonunda:** Zeyrek
+Mobile App Store'dan ya da Google Play'den yüklenir (pencere mağaza bağlantısını verir; davet yoktur), pencerede
+çıkan kod okutulur (120 sn geçerli). **Senin Mac'inde:** kullanıcı kendi Mac'ini bir kez ekler, simülatör o Mac'te
+açılır; Mac'i olmayan için Zeyrek'in Mac'inde açma henüz yoktur. **Kaydettiğinde güncellenir:** yazdığın yama
+telefonda ve simülatörde yenilenir. Ajan kod üretmez, önizleme başlatmaz; kullanıcıyı bu pencereye yönlendirir.
 
 ## Yayın
 
 Mağaza yayını ayrı rehberdedir: `platform_guide('mobile-publish')` — `mobile_store_*` / `mobile_asset_*` /
-`mobile_build_*` akışı, ekran görüntüsü, ön kontrol (P-01…P-11), derleme hata kodları ve insanın Studio › Yayın'da
+`mobile_build_*` akışı, ekran görüntüsü, ön kontrol (P-01…P-22), derleme hata kodları ve insanın Studio › Yayın'da
 yaptıkları. Derlenen uygulama
 **production ortamını** okur; ilk derleme kimlik alanlarını (`bundleIdentifier`, `androidPackage`, `scheme`) kilitler.
 

package/dist/resources/guides/page.md

@@ -95,7 +95,7 @@ alanlar denetlenmez); katalog okunamazsa denetim susar ve yazma eskisi gibi geç
   `Data = RedirectPage.Slug`). Sabit `'/hastalar'` yazarsan sayfa slug'ı değişince bağlantı
   sessizce kırılır; `pageId` referansı değişiklikten etkilenmez. Aynısı `flow` prop'u için
   `type: 'flow'` + `ref: <flowId>`, dosya için `type: 'file'` + `ref: <fileId>`.
-  İSTİSNA: form dosya alanının (fileInput / filebutton / fileUpload) `value`'suna `type: 'file'` bağlama — çip
+  İSTİSNA: form dosya alanının (fileInput / filebutton / fileUpload / attachments) `value`'suna `type: 'file'` bağlama — çip
   URL yazar ve kullanıcı dokunmadan kaydederse tekil FILE alanı sessizce NULL'lanır (ölçüldü 2026-10-02). Varsayılan
   dosya için `{ type: 'static', data: { type: 'ref', value: <fileId>, fileName, absolute_path } }` ver (`component_get`
   notu).
@@ -1061,16 +1061,19 @@ parametresini geçir.
 
 | istenen | yol |
 |---|---|
-| Değere göre sabit renk | `tag` kolonu + `colorMap`: `[{ value: 'Active', label: 'Aktif', color: 'success' }]` — hücrenin KENDİ değerine bakar, satırın başka alanına göre hesaplanamaz |
+| Değere göre sabit renk | `tag` kolonu + `colorMap`: `[{ value: 'Active', label: 'Aktif', color: 'success' }]` — hücrenin KENDİ değerine bakar, satırın başka alanına göre hesaplanamaz. `value` KOD, `label` görünen yazıdır (çeviri sarmalı olabilir); `value`'ya görünen yazı yazılmaz (TR-005) |
 | Satıra göre koşullu renk | hücre değerini `{ label, color }` nesnesi olarak yaz: renk satır verisinde taşınır |
 
 ```jsonc
 // setter: rows'a yazmadan önce hücreyi { label, color } nesnesine çevir
 { "type": "change", "element": "tbl", "property": "rows", "source": "component",
   "mapping": { "source": "", "mappings": {} },
-  "value": { "type": "code", "ref": "(Steps.listele?.data || []).map(function (r) { return Object.assign({}, r, { durum: { label: r.durum, color: r.durum === 'İptal' ? 'error' : 'success' } }); })" } }
+  "value": { "type": "code", "ref": "(Steps.listele?.data || []).map(function (r) { return Object.assign({}, r, { durum: { label: t('common.status.' + r.status), color: r.status === 'Cancelled' ? 'error' : 'success' } }); })" } }
 ```
 
+Renk kararı KODA bakar (`r.status === 'Cancelled'`), görünen yazıya değil (`r.durum === 'İptal'` dil değişince tutmaz —
+gateway TR-005 ile durdurur; `platform_guide('translation')` §Mantık görünen metne bağlanmaz).
+
 Renk semantik ad (`primary · info · success · warning · error` — tema token'ına çözülür, tema
 değişince izler) ya da hex/rgb/CSS renk adıdır; temalarda `info` neredeyse beyazdır, mavi için
 `primary` yaz. `colorMap` satırının `mode: 'solid'`'i o değeri dolu zemin + beyaz yazıyla çizer.
@@ -2119,6 +2122,9 @@ de silip yeniden ekleme gerekmez:
 { "op": "set_appearance", "target": "box_summary", "appearance": { "heightType": "auto", "tooltip": null } }
 ```
 
+İpucunu çeviriye bağlamak için metne `t:` öneki konur (`"tooltip": "t:shell.profile"`); ayrıntı
+`platform_guide('translation')` §Bileşen ipucu.
+
 Op **birleştirir**: yalnız verilen alanları yazar, gerisini korur; `null` alanı temizler (null
 kabul etmeyen `heightType` gibi alanlar hariç). Alan adları `page_schema_get`'in döndürdüğü
 appearance anahtarlarıdır; bilinmeyen alan `unknown-appearance-field`, tanınmayan ya da null
@@ -2340,7 +2346,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
 | Puan / kod girişi | `rating` · `otpinput` |
 | Tarih / saat / aralık | `datepicker` · `datetimepicker` · `daterangepicker` · `datetimerangepicker` · `timepicker` (yalnız HH:mm) |
 | Kimlik alanları | `textinput` (e-posta için `inputMask` Email hazır maskesi ya da `regex` kuralı — `email` diye bir bileşen YOK, `add_component` `unknown-type` ile reddedilir) · `password` |
-| Dosya | `fileUpload` (dropzone) · `fileInput` · `filebutton` · `file-viewer` |
+| Dosya | `attachments` (ek dosyalar: sürükle-bırak ya da düğme + önizlemeli kartlar, görsel/video/PDF popupta) · `fileUpload` (dropzone) · `fileInput` · `filebutton` · `file-viewer` |
 | Liste | `datatable` (Kural 1e) · `repeater` (kart listesi VE dinamik form — Kural 1g) · `tree-view` (hiyerarşi; `isSearchable` ile istemci içi arama) · `timeline` (tarihli olay akışı) |
 | Pano / takvim | `kanban` (durum kolonlarında sürüklenebilir kartlar; taşıma `cardMove` ile `event.data`'dan okunur, kalıcılık AKIŞIN işidir) · `eventcalendar` (ay/hafta/gün/ajanda; veri `rows`'a akışla yazılır, `monthChange`/`viewChange` görünen `start`/`end` aralığıyla tazeleme kancasıdır) |
 | Kayıt detayı | `detailview` — tek kaydı etiket/değer ızgarası basar (alan başına format, iç içe alan yolu); OLAY YAYMAZ, tıklanabilirlik gerekiyorsa kapsayıcıya sar |
@@ -2730,7 +2736,7 @@ micro-op hattına dönün.
   korumalı sayfada `middlewareBlocked` dönmesi beklenen davranıştır ve kendisi bir
   doğrulamadır. Tam doğrulama seti: `page_schema_validate` (kuru koşu) + `page_get` (bağlar)
   + `page_runtime_get` (son hâl).
-- **Sayfada dosya toplanabilir:** `fileUpload` (dropzone) · `fileInput` · `filebutton`
+- **Sayfada dosya toplanabilir:** `attachments` (ek dosya listesi) · `fileUpload` (dropzone) · `fileInput` · `filebutton`
   komponentleri vardır, göstermek için `image` · `file-viewer`. Yani "dosya yükleyerek cevapla"
   tipi bir alan kurulabilir. Gateway tarafında `file_upload`/`file_download` tool'ları eklendi
   (multipart / `outPath`) ama **canlı platforma karşı henüz doğrulanmadı** — ilk kullanımda

package/dist/resources/guides/translation.md

@@ -119,6 +119,45 @@ backend'de zaten tanımlı, Studio'nun "Translate" aksiyonunun ürettiği şekil
   tipli prop'larda "Translate" aksiyonu gösterilir, ama şema düzeyinde her static prop aynı Prop
   şeklini kabul eder).
 
+## Mantık görünen metne bağlanmaz (TR-005 / TR-006)
+
+Davranışı (koşul, görünürlük, renk, ikon, dal, CSS seçici) ekranda GÖRÜNEN bir yazıya bağlayan kod **metin kancasıdır**:
+yazı dile, çeviriye ve tasarımcının düzeltmesine göre değişir; değişince karşılaştırma sessizce tutmaz. qm'de İngilizceye
+geçince ev ikonu kayboldu, onay düğmeleri görünür oldu, durum renkleri griye düştü (2026-10-13…16, onlarca yer). Kural
+tek dilli uygulamada da geçerlidir: yazı düzeltilince aynı kırılma olur. **Hiçbir karar görünen metne bağlanmaz.**
+
+| Yasak (kanca) | Doğru |
+|---|---|
+| `r.durum === 'Onaylandı' ? 'success' : 'warning'` | Kayıttaki kod: `r.status === 'Approved'`; yazıyı ayrıca `t('common.status.' + r.status)` ile bas |
+| `{{ bc.title !== 'Aksiyonlar' ? 'home' : '' }}` (başlığa göre ikon) | Adres parametresi (`Page.queryParams.task`) ya da akışın açıkça yazdığı state |
+| `statusText === 'Açma onayı'` (düğme görünürlüğü) | Kodu ayrı alanda taşı: `statusCode === 'ActionOpenApproval'` |
+| `['Onaylandı', 'Reddedildi'].includes(durum)` | Kod listesi: `['Approved', 'Rejected'].includes(status)` |
+| `/Klasörler/.test(panel.textContent)` (html betiği) | Dilden bağımsız işaret: sınıf (`klasor-paneli`), `data-*` özniteliği, `elementId` |
+| CSS `[aria-label="Kolonlar"]` | Yapısal seçici (`.ng-tools__button[aria-expanded]`) ya da sınıf |
+| `colorMap: [{ value: 'Aktif', color: 'success' }]` | `value` kod, görünen yazı `label`'da (çeviri sarmalı olabilir) |
+| `currentItem.title === 'Dokümanlar'` (breadcrumb tıklaması) | Öğeye ek alan: `{ key: 'klasor', title }` → `currentItem.key === 'klasor'` |
+| Sekmeyi ya da hata satırını yazısıyla tanımak | Sekme `key`'i / kimliği (`<tabs>__tab-<key>`), bağlamdaki kod |
+
+Gateway akış, sayfa, layout ve widget yazımında denetler (`flow_*`, `page_schema_patch` / `_validate`, `page_create`,
+`page_update`, `layout_*`, `component_schema_patch`, `component_create` / `_update`):
+
+- **TR-005 (block):** bu yazımla gelen kanca isteği platforma göndermeden durdurur. Kanca sayılan: ASCII dışı (Türkçe)
+  harfli ya da boşluklu metinle karşılaştırma (`===`, `!==`, `case`, `includes`, `startsWith`, `indexOf`, düzenli ifade
+  testi, dizi üyeliği), görünen alana bakan karşılaştırma (`title`, `label`, `text`, `textContent`, `innerText`,
+  `nodeValue`, `getAttribute('aria-label')` …), etiket CSS seçicisi (`[aria-label=…]`, `[title=…]`), `colorMap` değerinde
+  görünen metin. Tek harf (`case 'ş'`), karakter sınıfı (`/[çğıöşü]/`), `Page.queryParams` değeri ve `${…}` ile kurulan
+  seçici kanca sayılmaz. Yalnız ASCII harfli boşluklu metin (`'User Group'` sunucu kodu da olabilir) sözlükte ya da
+  sayfanın yazısında geçiyorsa kanca sayılır.
+- Kayıtta zaten duran kanca **warn**: yazım durmaz. Dokunduğunuz yerdeyse aynı değişiklikte koda çevirin; o metni
+  çevirmeyin — karşılaştırma kırılır.
+- **TR-006 (warn):** tek kelimelik metin (`'Aktif'`, `'Evet'`, `'Anasayfa'`) biçimden koddan ayrılmaz; projenin varsayılan
+  dilindeki sözlük değeriyle ya da sayfanın yazısıyla aynıysa uyarır. Bir kod değeriyse yok sayın.
+- Kaçış: sunucu yalnız metin döndürüyor ve karşılaştırılacak kod yoksa aynı çağrıya `policyOverride: true` — bulgu
+  yanıtta uyarı olarak kalır. Kalıcı çözüm sunucudan kod istemektir (`platform_gap_report`).
+
+Denetim sözdizimseldir: kodun içindeki karşılaştırmayı arar, etiket ve mesaj gibi düz metni kanca saymaz. Sunucu tarafı
+(workflow, microservice, Studio fonksiyonu) denetlenmez — orada da aynı kural geçerlidir.
+
 ## Dil değiştirme: `language-selector`
 
 Son kullanıcı dili `language-selector` komponentiyle değiştirir (`platform_guide('component')`
@@ -153,6 +192,46 @@ budur. Lambda yalnız `{{#t}}` geçen şablona eklenir; `context` kendi `t` alan
 basılır; datatable'ın `html` hücresi bu sözdizimini tanımaz. 2026-10-14 frontend'i (frontend ADR 0021),
 uzak kurulumda dağıtımdan sonra.
 
+## Bileşenin kendi kelimeleri: `compProp.<bileşen>.<kelime>`
+
+Web bileşenleri son kullanıcıya kendi kelimelerini gösterir — tablonun "Rows per page"i, boş durumu,
+filtre kurucusu, açılır kutunun "Bir seçenek seçin"i, adım bileşeninin "İleri / Geri"si, etkinlik takviminin "Bugün"ü.
+2026-10-15'ten beri web bileşenleri bu modelde (`attachments` 2026-10-21'den beri, ortak kelimelerle). Bunlar prop değildir; uygulama sözlüğünde satırdır (frontend ADR 0023 / 0024, 2026-10-15):
+
+- bileşenin **kendi** kelimesi `compProp.<bileşen>.<kelime>` — `datatable` (eski adı `table` aynı anahtarları
+  kullanır), `version-compare`, `chart` (tip seçicinin adları `type<Tür>`: `compProp.chart.typeBar`) ve `pagination`
+  (`compProp.pagination.next`, `…rowsOption` — tablonun aynı adlı kelimelerinden ayrı satırdır);
+- birçok bileşende geçen **ortak** kelime tek satır `compProp.common.<kelime>` ("Yükleniyor…", "Kapat",
+  "Temizle", "Ara", korumalı değer penceresi …) — bir kez çevrilir, bütün bileşenlerde değişir;
+- form alanının **varsayılan doğrulama mesajı** da ortak kelimedir: kuralın `message`'ı boşsa
+  `compProp.common.validationRequired` / `validationMinLength` / `validationMaxLength` / `validationMinValue` /
+  `validationMaxValue` / `validationRegex` / `validationEmail` gösterilir, `{value}` kuraldan dolar. Doğrulama kelimesi
+  taşıyan bir bileşen studio'da tohumlanınca yedi kuralın hepsinin satırı yazılır (akışın doğrulama adımı her kuralı
+  uygulayabilir).
+
+Ekrandaki zincir: düğümün `texts` prop'u → sözlükteki satır (bileşenin dili → varsayılan dil) → bileşenin
+tohum metni (dil → İngilizce). Sözlükte satır yokken ekran eskisiyle aynıdır. Bir dilde satır yoksa varsayılan
+dildeki satır görünür (K60).
+
+- **Bütün tablolarda değiştirmek:** sözlüğe yaz — `translation_update` ile
+  `compProp.datatable.rowsPerPage` = `{ tr: 'Sayfa başına kayıt', en: 'Records per page' }`.
+- **Yalnız bir tabloda değiştirmek:** o düğümün gizli `texts` prop'una yalnız o kelimeyi yaz —
+  `{ "op": "replace_prop", "target": "<tablo>", "prop": "texts", "value": { "rowsPerPage":
+  { "type": "translation", "ref": "page.x.kayitSayisi" } } }`. Yazılmayan kelime sözlükten gelir;
+  `texts`'e bütün kelimeleri kopyalama.
+- Tablonun kelime adlarının tam listesi (124) `component_get('datatable')` › `propNotes.texts`'te; her
+  bileşenin listesi studio'nun Translations sekmesinde. İşleç yazıları `op<İşleç>` (`opEq`) ve kısa hâlleri
+  `opShort<İşleç>` (`opShortContains`). Listede olmayan ad yazılmaz — bileşen onu okumaz.
+- Kelime gibi çalışan ayarlar (`placeholder`, `emptyText`, `trueLabel` …) boş bırakılır; boşken ortak kelime
+  görünür. Ayrıntı `platform_guide('component')` §Arayüz metni.
+- Satırları studio yazar, yalnız iki yoldan: kelimeli bileşen studio'da **paletten** sayfaya konunca eksik
+  bileşen satırları tohumla (tr / en / ar) eklenir; çeviri panelindeki "Eksik bileşen
+  kelimelerini ekle" bütün sayfa, layout ve widget'ları tarar ve satırları Kaydet'le yazar. Dolu
+  satıra ikisi de dokunmaz. **MCP ile eklenen bileşen (`add_component`, `page_schema_patch`) satır
+  yazdırmaz** — sözlükte satır yokken bileşen tohum metnini gösterir; kelimeyi değiştireceksen satırı
+  `translation_update` ile kendin yaz. Tohumu olmayan dil (ru) boş kalır — onu da `translation_update`
+  ile doldur. Mobil bileşenler kelimeleri henüz sözlükten okumaz (tohum gösterir).
+
 ## Kareyi ikinci dilde almak: `page_screenshot(language:)`
 
 Dil değiştirici **kanıt için gerekli değildir.** Runtime boot dilini şu sırayla seçer:
@@ -221,6 +300,22 @@ Runtime `t:` ile başlayan bir mesajı anahtar sayar ve normal zincirden çözer
 olduğu gibi gösterilir. Çözüm çalışma anında olduğu için şema varsayılanlarını değiştirmek
 gerekmez — `schema.ts`'e dokunulmaz, katalog yeniden yüklenmez.
 
+## Bileşen ipucu: `appearance.tooltip` ve `t:` öneki
+
+Üstüne gelince çıkan ipucu bir prop değil, düğümün `appearance.tooltip` alanıdır (düz metin);
+`set_prop_type` ona uygulanamaz. Doğrulama mesajıyla aynı sözleşme geçerlidir — metnin kendisine
+`t:` öneki konur:
+
+```jsonc
+{ "op": "set_appearance", "target": "shell_profile", "appearance": { "tooltip": "t:shell.profile" } }
+```
+
+Ekran anahtarı uygulama sözlüğünden okur (aktif dil → varsayılan dil → anahtarın kendisi) ve dil
+değişince ipucu da değişir; öneksiz metin olduğu gibi kalır. Studio'da bağ, ipucu yazılmış
+bileşenin Translations sekmesindeki "İpucu" satırından kurulur ve kaldırılır; Properties'teki kutu
+bağlıyken anahtarı çip olarak gösterir. Yalnız web: mobil panelde ipucu alanı yoktur
+(`platform_guide('mobile')`). Tasarım kanvası ipucu çizmez; önizleme ve çalışma anı çizer.
+
 ## Dosyayla toplu çeviri (Excel)
 
 İnsan bir çevirmene yeni bir dil yaptıracaksa: sözlük Excel'e iner, çevirmen hedef sütunu doldurur,

package/dist/resources/knowledge.js

@@ -13,7 +13,9 @@ export function listKnowledgeFiles(kind) {
 /**
  * `schemas` MCP kaynağı olarak YAYINLANMAZ (yalnız `guides` ve `examples` kayıtlıdır) ama
  * dosyalar aynı klasör düzeninde durur ve drift testleri onları da okur — şema kaynağı
- * platformun swagger'ından üretiliyor ve bir alanın oradan düşmesi sessizce olur.
+ * platformun swagger'ından üretiliyor ve bir alanın oradan düşmesi sessizce olur. `prompts`
+ * kaynak değil MCP prompt'udur (`src/prompts/`, ADR 0003); metni burada durur ki `copy-assets`
+ * onu `dist`'e taşısın ve gözden geçirme metin olarak yapılsın.
  */
 export function readKnowledgeFile(kind, file) {
     return readFileSync(join(resourcesDirectory, kind, file), 'utf8');

package/dist/resources/prompts/mobile-publish-prepare.md

@@ -0,0 +1,89 @@
+# Mobil uygulamayı yayına hazırla
+
+Uygulama: `{{applicationId}}`. Görev: Studio › Yayınla'nın **3 · Test sürümü** (kimlik ve sürüm, Apple hesabı,
+Google Play hesabı, test ön kontrolü) ve **4 · Yayına hazırla** (mağaza metinleri, görseller, yaş derecelendirmesi,
+gizlilik, beyanlar, sürüm-fiyat-yayın, konsolda kalanlar) adımlarını zeyrek-ai araçlarıyla doldurmak, ön kontrolü
+kuru koşmak ve insana kalan işi tek listede vermek. Kurallar ve alan sınırları `platform_guide('mobile-publish')`'dedir;
+başlamadan önce §Yolculuk, §Test derlemesi, §Akış, §Yaş derecelendirmesi ve §Ön kontrol bölümlerini oku.
+
+## Sınırlar — bunlar pazarlık konusu değil
+
+- **Gizli bilgi girmezsin:** Apple/Google hesabı, sertifika, profil, keystore, harita anahtarı, demo parolası,
+  APNs anahtarı, `google-services.json`. Bunlar Studio › Yayın › Hesaplar'da insanın işidir.
+- **Beyanı kendin işaretlemezsin:** `mobile_store_update { applicationId, declarations }` ile `true` yalnız kullanıcı o formu
+  App Store Connect / Play Console'da doldurduğunu **bu konuşmada açıkça söyledikten sonra** yazılır.
+- **Geri dönüşsüz bir şey kendiliğinden başlatmazsın:** production'a dağıtım ve mağazaya gönderim yok; ön kontrol
+  `mobile_build_start` ile yalnız `dryRun: true` koşulur. Test derlemesi isteğe bağlıdır ve **yalnız kullanıcı bu
+  konuşmada açıkça isterse** `dryRun`'sız başlatılır (adım 4). Apple'daki kimlik kaydı da silinemez: yalnız
+  kullanıcı kimliği bu konuşmada onayladıktan sonra yapılır (adım 4).
+- **Kilitli alana dokunmazsın:** `lockedFields` içindeki kimlik ve sayaçlar ilk derlemeden sonra değişmez.
+- Bir alanın değerini uydurmazsın: uygulamanın içeriğinden (sayfalar, akışlar, mevcut ayar) çıkaramadığın her
+  şeyi — şirket adı, destek e-postası, gizlilik politikası adresi, fiyat — kullanıcıya **tek seferde, liste
+  olarak** sor.
+
+## Sıra
+
+### 3 · Test sürümü
+
+1. **Durumu oku.** `mobile_store_get { applicationId, detail: ['assets', 'signing', 'changes'] }`. Not et:
+   `persisted`, `lockedFields`, `settings.releaseTargets` (bu sürüm hangi mağazalara gidiyor), mevcut `listing`
+   dilleri, görsel yuvaları, beyanlar, `signing` eksikleri. Kapalı mağazanın alanlarını doldurma.
+2. **Kimlik ve sürüm.** `persisted: false` ise kimlik otomatik varsayılandır: kullanıcı onaylarsa
+   `bundleIdentifier`, `androidPackage`, `scheme`'i ilk derlemeden önce yaz. `displayName` ve `version`
+   (MAJOR.MINOR.PATCH) dolu olsun.
+3. **Hesaplar.** Bu sürümün gittiği mağazaların `signing` eksiklerini (Apple hesabı, Google Play hesabı, sertifika,
+   profil, keystore) kalanlar listesine yaz — Studio › Yayın › Hesaplar.
+4. **Test ön kontrolü.** Açık her platform için
+   `mobile_build_start { applicationId, platform, target, scope: 'test', dryRun: true }` (iOS `testflight`, Android
+   `internal`). Kullanıcı başka bir ortamdan (development ya da hazır bir dal) test etmek istiyorsa `environment` ekle;
+   ön kontrol o ortamda sorar. Ajanın düzeltebildiği `fail` satırlarını düzelt ve yeniden koş; düzeltemediklerini
+   kalanlara yaz. iOS'ta `asc_bundle_id_missing` çıkarsa kimliği (`bundleIdentifier`) kullanıcıya göster ve Apple'daki
+   kaydın silinemeyeceğini söyle; yalnız açık onayıyla `mobile_store_update { applicationId, registerAppleBundleId: true }`,
+   sonra ön kontrolü yeniden koş. Onay yoksa kalanlara yaz. Test derlemesi isteğe bağlıdır: yalnız kullanıcı açıkça
+   isterse aynı çağrıyı `dryRun`'sız yap — her başlatma derleme numarası ayırır ve kimliği kilitler. Production'dan
+   alınan test derlemesi sonradan yeniden derlenmeden incelemeye / yükseltmeye gidebilir; development ya da dal
+   derlemesi asla mağazaya gitmez — kullanıcıya bunu ortamı seçerken söyle.
+
+### 4 · Yayına hazırla
+
+5. **Mağaza metinleri.** Uygulamanın dilleri için `settings.listing.<dil>`: `title` (≤ 30), `subtitle` (≤ 30),
+   `shortDescription` (≤ 80), `description` (≤ 4000), `keywords` (dizi; virgülle birleşince ≤ 100), `releaseNotes`. Metni
+   uygulamanın gerçek ekranlarından yaz; reklam dili, rakip adı, "en iyi" gibi ifadeler yok. iOS açıksa
+   `apple.categories.primary` ve `apple.copyright`, Android açıksa `play.contactEmail`.
+6. **Görseller.** Derleme görselleri (`icon`, `adaptiveForeground`, `adaptiveBackground`,
+   `adaptiveMonochrome`, `splash`) eksikse kullanıcıdan dosya iste ya da var olan dosyanın yolunu sor.
+   Ekran görüntüsü: her mağaza dili ve açık platformun cihaz sınıfı için 3–5 gerçek ekran —
+   `page_screenshot { applicationSlug, pageSlug, environment: 'production', device, format: 'jpeg', quality: 92, language, colorScheme: 'light', outPath }`
+   → `mobile_asset_create { applicationId, kind: 'screenshot', deviceClass, locale, path }`. `applicationSlug`
+   `application_list`'ten, `pageSlug` `page_list`'ten; `device` rehberdeki cihaz tablosundan; `language` o
+   yuvanın `locale`'idir — verilmezse kare projenin varsayılan dilinde çıkar ve başka dilin yuvasına yanlış dilde
+   yüklenir. Yuva birikimlidir (en çok 10 görsel): 1. adımda okuduğun yuvada görsel varsa kullanıcıya sormadan
+   ekleme yapma. Giriş ve splash sayfası çekilmez. Production'da sayfa yoksa kullanıcıya sor: ekran görüntüsü
+   canlıya almadan sonraya kalabilir.
+7. **Yaş derecelendirmesi** (iOS açıksa). `settings.apple.advisory`: rehberdeki **bütün** soruları cevapla;
+   reklam açıksa `advertising: 'true'`. Emin olmadığın soruyu kullanıcıya sor.
+8. **Gizlilik.** `settings.urls.privacyPolicy` (https). Yoksa kullanıcıdan iste; uydurma adres yazma.
+9. **Beyanlar.** Açık mağazanın beyanlarını (`appPrivacy` · `dataSafety`, `contentRating`, `targetAudience`,
+   `appAccess`) kullanıcıya hatırlat; onay gelenleri işaretle, gelmeyenleri kalanlar listesine yaz.
+10. **Sürüm, fiyat, yayın.** `apple.releaseType` (varsayılan `manual`), `apple.pricing`, `apple.territories`;
+    kullanıcının tercihi yoksa varsayılanı koru ve bunu raporda söyle. Konsolda elle yapılanları (fiyat planı,
+    içerik derecelendirme anketi gibi) kalanlara yaz.
+11. **Mağaza ön kontrolü.** Açık her platform için `mobile_build_start { applicationId, platform, target, dryRun: true }`
+    (iOS `testflight`, Android `internal`; kapsam `store` — mağazaya giden işin bütün kuralları). Ajanın düzeltebildiği
+    `fail` satırlarını düzelt ve yeniden koş; düzeltemediklerini kalanlara yaz.
+
+Her `mobile_store_update` yanıtındaki `changed` ve MOB-022 uyarılarını oku; 409 (bayat kayıt) gelirse aynı
+yamayla yeniden çağır.
+
+## Rapor
+
+Sonunda iki tablo ver:
+
+1. **Doldurduklarım** — adım · bölüm · alan · yazılan değer (uzun metinde ilk 60 karakter).
+2. **Sana kalanlar** — iş · nerede (Studio › Yayın › Hesaplar, App Store Connect, Play Console) · neden ·
+   hangi adımı kilitliyor.
+
+Ardından tek cümleyle sıradaki adımı söyle. Studio sonraki adımı ancak öncekinin koşulu karşılanınca açar:
+3 · Test sürümü'nde kimlik ya da bu sürümün gittiği mağazanın hesap bölümü eksikse 4 · Yayına hazırla açılmaz (test
+derlemesi kapı değildir); 4 · Yayına hazırla'da eksik bölüm kalırsa 5 · Canlıya al açılmaz; 5'te production'a gitmemiş
+değişiklik (`changes.live`) varsa dağıtım insan onaylıdır — kullanıcıya Studio'dan canlıya almasını söyle.

package/dist/resources/schema-fingerprint.json

@@ -1,8 +1,8 @@
 {
-  "hash": "ba18a5111614d9b1e63e0d50f1a06a4dce1081b3d482c88e7620ca4bda9a466b",
-  "generatedAt": "2026-10-14T08:45:02.944Z",
-  "types": 337,
-  "files": 167,
+  "hash": "c1fb21eeab36758c9d81fcd1b41ece1b456a514e7aa944c41e190727b5cdc0ed",
+  "generatedAt": "2026-10-21T05:42:28.082Z",
+  "types": 348,
+  "files": 173,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
   "missing": [
     "NgApps.Infrastructure.Models.IdNamePair`1[[System.Guid, System.Private.CoreLib, Version=9.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]",

package/dist/resources/schemas/ApplyMicrofunctionArchiveChangesCommand.json

@@ -0,0 +1,76 @@
+{
+  "schema": {
+    "required": [
+      "operations"
+    ],
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "expectedHash": {
+        "type": "string",
+        "nullable": true
+      },
+      "operations": {
+        "minItems": 1,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/NgApps.Application.Contexts.Studio.Microfunctions.MicrofunctionArchiveOperationDto"
+        }
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {
+      "NgApps.Application.Contexts.Studio.Microfunctions.MicrofunctionArchiveOperationDto": {
+        "required": [
+          "path"
+        ],
+        "type": "object",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.Microfunctions.MicrofunctionArchiveOperationType"
+          },
+          "path": {
+            "minLength": 1,
+            "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))[^/\\\\\\x00]+(?:/[^/\\\\\\x00]+)*$",
+            "type": "string"
+          },
+          "content": {
+            "type": "string",
+            "nullable": true
+          },
+          "encoding": {
+            "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.Microfunctions.MicrofunctionArchiveContentEncoding"
+          },
+          "newPath": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "NgApps.Domain.Contexts.Studio.Microfunctions.MicrofunctionArchiveOperationType": {
+        "enum": [
+          "write-file",
+          "create-directory",
+          "delete",
+          "rename"
+        ],
+        "type": "string",
+        "format": ""
+      },
+      "NgApps.Domain.Contexts.Studio.Microfunctions.MicrofunctionArchiveContentEncoding": {
+        "enum": [
+          "utf8",
+          "base64"
+        ],
+        "type": "string",
+        "format": ""
+      }
+    }
+  }
+}

package/dist/resources/schemas/ConnectDataDescribeDto.json

@@ -28,6 +28,9 @@
       },
       "source": {
         "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.ConnectData.ConnectDataSourceMetaModel"
+      },
+      "lookupMobile": {
+        "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.ConnectData.ConnectDataLookupMobileModel"
       }
     },
     "additionalProperties": false
@@ -100,6 +103,13 @@
           },
           "isMultiple": {
             "type": "boolean"
+          },
+          "dateBuckets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -190,6 +200,9 @@
           "isSchemaSampled": {
             "type": "boolean"
           },
+          "grouping": {
+            "type": "boolean"
+          },
           "parameters": {
             "type": "array",
             "items": {
@@ -200,6 +213,19 @@
         },
         "additionalProperties": false
       },
+      "NgApps.Domain.Contexts.Studio.ConnectData.ConnectDataLookupMobileModel": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "nullable": true
+          },
+          "row": {
+            "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.ConnectData.ConnectDataMobileRowModel"
+          }
+        },
+        "additionalProperties": false
+      },
       "NgApps.Domain.Contexts.Access.Policies.FieldAccess": {
         "enum": [
           "hidden",
@@ -338,6 +364,24 @@
           }
         },
         "additionalProperties": false
+      },
+      "NgApps.Domain.Contexts.Studio.ConnectData.ConnectDataMobileRowModel": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "subtitle": {
+            "type": "string",
+            "nullable": true
+          },
+          "trailing": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
       }
     }
   }

package/dist/resources/schemas/ConnectDataResultDto.json

@@ -177,6 +177,13 @@
           },
           "isMultiple": {
             "type": "boolean"
+          },
+          "dateBuckets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -249,6 +256,9 @@
           "isSchemaSampled": {
             "type": "boolean"
           },
+          "grouping": {
+            "type": "boolean"
+          },
           "parameters": {
             "type": "array",
             "items": {

package/dist/resources/schemas/CreateMicrofunctionCommand.json

@@ -70,6 +70,14 @@
         },
         "nullable": true
       },
+      "dependencies": {
+        "type": "string",
+        "nullable": true
+      },
+      "testArguments": {
+        "type": "string",
+        "nullable": true
+      },
       "publish": {
         "type": "boolean"
       }

package/dist/resources/schemas/InvokeMicrofunctionCommand.json

@@ -7,10 +7,6 @@
         "format": "uuid"
       },
       "args": {
-        "type": "object",
-        "additionalProperties": {
-          "nullable": true
-        },
         "nullable": true
       },
       "preview": {