@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/dist/resources/guides/page.md

@@ -78,16 +78,18 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   her turda çözümlenmiş metinle EZER — anahtar yalnız `ref`'te yaşar, `data`'ya yazıp
   güvenme (`code` prop'uyla aynı davranış). Tam şekil, fallback zinciri ve `translation_*`
   tool'ları için `platform_guide('translation')`.
-- **Kurulmuş bir düğümün prop TİPİNİ `set_prop_type` micro-op'u değiştirir.**
+- **Kurulmuş bir düğümün prop TİPİNİ yerinde değiştir — düğümü yeniden KURMA.** İki eş yol var:
+  `{ op: 'replace_prop', target: '<elementId>', prop: 'content', value: { type: 'translation', ref: 'dashboard.kpi.total' } }`
+  (applier `code` ve `translation` sarmalını tipiyle korur; gateway 2026-09-15'e kadar translation
+  sarmalını reddediyordu) ya da
   `{ op: 'set_prop_type', target: '<elementId>', prop: 'content', propType: 'translation', ref: 'dashboard.kpi.total' }`
-  bir `static` prop'u çeviriye, `propType: 'code'` + `ref: '<ifade>'` koda, `propType: 'static'` +
-  `data: <değer>` sabite bağlar. Bu bir **gateway emülasyonudur**: `replace_prop` gönderilen ham
-  değeri her zaman `static` Prop'una sarar ve sarmalanmış Prop nesnesini reddeder, yani prop tipini
-  yazamaz. Op olmadan tek yol düğümü `remove_component` + `add_component` ile yeniden kurmaktı;
-  2026-09-06 koşusunda on bir etiket bu yolla kuruldu ve onlara yazan **dokuz setter iteratee'si**
-  platform tarafından sessizce silindi (üç KPI kartı boş kaldı). Taşıyıcı alan tipe göre değişir —
-  `static` değeri `data`'da, `code` ve `translation` `ref`'te taşır; eksik taşıyıcı istek
-  gönderilmeden reddedilir ve `page_schema_validate` aynı kararı verir.
+  (gateway emülasyonu; mevcut `data`'yı tasarım yedeği olarak taşır). Taşıyıcı alan tipe göre
+  değişir — `static` değeri `data`'da, `code` ve `translation` `ref`'te taşır; eksik taşıyıcı istek
+  gönderilmeden reddedilir ve `page_schema_validate` aynı kararı verir. Eski yol
+  `remove_component` + `add_component` idi: 2026-09-06 koşusunda on bir etiket bu yolla kuruldu ve
+  onlara yazan **dokuz setter iteratee'si** sessizce silindi; 2026-09-15'te (G-04) aynı zincir bir
+  `daterangepicker` yer tutucusunu çeviriye bağlarken tekrarlandı — setter hedefi elementId değil
+  komponentin iç kimliğidir (aşağıda Kural 2, `FLOW-018`).
 
 - **`blocks[].size`, komponentin `component_get`'teki `maxSize`'ını aşamaz.** Dikkat: katalog
   varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü körüne
@@ -394,6 +396,14 @@ göstermek error flow'un işidir.
 >   "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }] }
 > ```
 
+> **`confirm` adımının diyalog çerçevesi de yazılabilir.** `args` dört düz metin alanı taşır:
+> `message` (gövde), `title` (başlık), `confirmText` (onay düğmesi, `yes` dalı), `cancelText`
+> (vazgeç düğmesi, `no` dalı). Son üçü isteğe bağlıdır; boş bırakılan alan dile göre sabit metne
+> düşer ("Emin misiniz?" / "Evet" / "Hayır" — `dialog.functions.ts` `resolveDialogFrame`).
+> Dördü de `alert`'in `message`'ı gibi DÜZ METİNDİR (FLOW-022 hepsini denetler):
+> `{ "type": "confirm", "args": { "message": "Bu risk ve 4 aksiyonu silinecek.", "title": "Riski sil",
+> "confirmText": "Sil", "cancelText": "Vazgeç" } }`.
+
 > **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:
 >
@@ -479,7 +489,7 @@ 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 · end`
+confirm · flow-trigger · storage · navigate · code · download · function · 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
@@ -490,7 +500,7 @@ değer tipleri: `static · page · property · storage · variable · code · it
 >
 > | Adım tipi | Web | Mobil | Nerede register ediliyor |
 > |---|---|---|---|
-> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi |
+> | `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` |
@@ -521,6 +531,14 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > (`Page.*`, komponentlere adıyla erişim, `state.page/app`, `Steps`, `self`/`item`/`event`,
 > `cookie.get/set`, `await`) ve `value.type` çözümleme tablosu için
 > **`platform_guide('expressions')`** — uydurma erişim adı sessizce `undefined` üretir.
+>
+> **`function` adımı ("Call function")** bir kullanıcı fonksiyonunu çağırır: `args: { functionId, functionName,
+> parameters: [{ name, value }] }` — `functionId` zorunlu ve gerçek (`function_list`; FLOW-024 block),
+> `parameters[].name` fonksiyonun bildirimindeki adla eşleşir, `value` şekli `microservice` adımıyla
+> aynıdır. Çıktı `Steps.<adımAdı>.data` (hata `.error.message`), dal `always`. Aynı fonksiyon `code`
+> 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')`**.
 
 > Bir microservice adımı kaydedildiğinde platform `args.microserviceSchema`'yı
 > (parameterScheme + returnScheme + `isReturnArray`) kendisi doldurur — `flow_get` ile geri
@@ -812,8 +830,9 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
 >
 > Kural: **`isWrapper` yalnız gerçekten sayfa boyu kaplaması gereken kap içindir**
 > (`page_container` böyledir ve öyle kalmalı). Sadece "başlık/çerçeve çizilmesin" diye wrapper
-> yapma — o iş `container` için `style` ile (`background:'transparent'`, `border:'none'`),
-> `form` için `hideBorders`/`hidePadding` prop'larıyla yapılır. **`states` için micro-op
+> yapma — o iş `container` için de `form` için de `style` ile yapılır (`background:'transparent'`,
+> `border:'none'`, `padding:0`). `form`'un eski `hideBorders`/`hidePadding` prop'ları
+> 2026-09-09'da şemadan kaldırıldı — bileşen onları hiçbir zaman okumuyordu, no-op'tu. **`states` için micro-op
 > YOKTUR:** yanlış `isWrapper`'ı düzeltmenin tek yolu düğümü `remove_component` +
 > `add_component` ile yeniden kurmaktır (sonrasında Kural 2'deki flow yeniden kaydetme adımı
 > ZORUNLU olur).
@@ -884,6 +903,16 @@ Beş şeyi bilmeden flex kurma:
    aradaki boşluklar çizilmez. Yine de bitişik ver (0,1,2…): kapsayıcı ileride `grid`'e
    döndürülürse şema geçerli kalsın. Gateway bu yüzden **flex kapsayıcının İÇİNDE PAGE-010
    boşluk uyarısı üretmez** (ızgarada üretmeye devam eder).
+   **Dizi sırası çizimi belirlemez** — `children[]` içindeki yer değil `y` kazanır; `y`'si eşit
+   iki çocukta dizi sırası kazanır. Bu yüzden flex kapta sıralamanın yolu `index`'tir:
+   `add_component`/`move_component`'e verilen `index` **görünen sıradaki yeri** belirler ve gateway
+   kardeşlerin konumunu Studio'nun flex tuvali gibi yeniden yazar (x=0, alt alta birikimli y;
+   yanıtın `gatewayNormalized` notu hangi `y`'nin değiştiğini söyler). Grafiğin üstüne başlık:
+   `{ "op": "add_component", "parent": "<flex kap>", "index": 0, "component": { … } }` — koordinat
+   hesaplamak gerekmez, `remove_component` + `add_component` hiç gerekmez. **Izgara kapta `index`
+   çizimi değiştirmez** (her çocuk kendi `position`'ında mutlak çizilir): sırayı
+   `move_component { target, position: { x, y } }` ile ver; sona eklemeyen `index` orada
+   **PAGE-033 (uyarı)** üretir.
 3. **Flex kapsayıcının yüksekliği içeriğine oturur.** `verticalAlign`'ın dağıtacak boşluğu
    olması için `appearance.heightType: 'fixed'` vermelisin — ölçü `heightString`'den
    (serbest CSS uzunluğu, ör. `"30vh"`), o yoksa `size.h × 10px`'ten gelir. `heightString`
@@ -1001,7 +1030,8 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 > sarmalayıcıya bağla (yukarıdaki `box_multi`). Sarmalayıcıyı **`isWrapper:false`** kur
 > (Kural 1f: wrapper = `min-height:80vh`) ve çerçevesini `style` ile kapat:
 > `{ background:'transparent', border:'none', '&__body': { padding:'0px' } }`.
-> `appearance.isHidden` diye bir kaçış yolu YOKTUR — runtime onu hiç okumaz.
+> `appearance.isHidden` diye bir alan YOKTUR (2026-09-15'te platformdan kaldırıldı, S-16) —
+> görünürlük yalnız `props.isHidden`'dır.
 
 > **Satır BAŞINA doğrulama kurulamaz.** `validations` komponentin kendisindedir, tüm satırlar
 > onu paylaşır — "3. soru zorunlu, 4. soru değil" şemayla ifade edilemez. Zorunluluk satır
@@ -1129,6 +1159,13 @@ yapmazsan ekran "platform mavisi" görünür; marka rengine çevirmek tek satır
 BÜTÜN girdileri yuvarlar; aynı şeyi komponent komponent `&__input { borderRadius }` yazarak
 yapmak hem uzun sürer hem de yeni komponent eklendiğinde tutarsızlık üretir.
 
+**Koyu tema karesi için sayfada `theme-toggle` bulunması gerekmez.** Ziyaretçinin tema tercihi
+çerezde değil `localStorage`'da (`zeyrek-viewer-theme-mode`) yaşar ve tema store'u onu sayfa
+açılırken bir kez okur; `page_screenshot` `colorScheme: 'dark' | 'light'` parametresi tercihi
+sayfa script'lerinden ÖNCE eker. İki temayı da doğrulamak, tasarıma düğme eklemeden iki çağrıdır
+(aynı tool'un `language` parametresi ikinci dil için aynı işi yapar —
+`platform_guide('translation')`).
+
 ### 1h-3 — Ölçülmüş hazır bloklar (anket ekranından, olduğu gibi kullanılabilir)
 
 ```jsonc
@@ -1543,6 +1580,19 @@ alanına dokunur. **Komponenti silip yeniden eklemeyin:** `remove_component` + `
 turu o komponente bağlı setter hedeflerini koparır (Kural 1e sonundaki not) ve komponentin tek
 referans verdiği akışları kalıcı olarak sildirir (Kural 2'deki yan etki notu).
 
+**Kurulu düğümün appearance'ını değiştirmek: `set_appearance`.** Aynı gerekçeyle appearance için
+de silip yeniden ekleme gerekmez:
+
+```jsonc
+{ "op": "set_appearance", "target": "box_summary", "appearance": { "heightType": "auto", "tooltip": null } }
+```
+
+Op **birleştirir**: yalnız verilen alanları yazar, gerisini korur; `null` alanı temizler. Alan
+adları `page_schema_get`'in döndürdüğü appearance anahtarlarıdır; bilinmeyen alan
+`unknown-appearance-field`, tanınmayan enum değeri (`heightType: "tall"`) 400 ile reddedilir.
+**`isHidden` bir appearance alanı DEĞİLDİR** — gizlemek için `replace_prop { prop: 'isHidden' }`
+ya da `set_binding { prop: 'isHidden' }` (Kural 7a'daki `isHidden` notu).
+
 **Kip ayrımı query parametresidir:** aynı sayfa `?id=<kayıt>` ile edit, parametresiz create.
 
 `mount` akışı (`page_container` ya da `form` üzerine bağlanır):
@@ -1655,10 +1705,12 @@ start → [setter] btn_save.isLoading = true
 > artık doğrudan `props.isHidden` yazılabilir; sırf gizlemek için `container`'a sarmak
 > GEREKMEZ. Tek doğru kaynak `component_get` + `page_schema_validate` kuru koşusudur.
 >
-> **`appearance.isHidden` bir kaçış yolu DEĞİLDİR:** kaydedilir ama runtime hiçbir yerde okumaz
-> (renderer yalnız `props.isHidden`'a bakar) — komponent görünmeye devam eder. Başlangıçta gizli
-> göstermek için ya komponenti `isHidden`'ı OLAN bir `container`'a sar (Kural 1g) ya da
-> görünürlüğü sayfa açılış akışının setter'ıyla kur.
+> **Appearance'ta `isHidden` alanı YOKTUR** (2026-09-15'te platformdan kaldırıldı, S-16): renderer
+> yalnız `props.isHidden`'a bakar. Başlangıçta gizli bildirim şemada
+> `"props": { "isHidden": { "type": "static", "data": true } }` ile kurulur, açılışı akıştaki
+> setter yapar. `add_component` / `page_update` gövdesine yine de `appearance.isHidden` konursa
+> gateway değeri `props.isHidden`'a taşır ve `gatewayNormalized`'da bildirir (prop zaten verilmişse
+> o kazanır); `set_appearance` ile `isHidden` yazmak istek gönderilmeden reddedilir.
 
 ### 7b — Liste → form geçişi
 
@@ -1848,6 +1900,18 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
 > hiç görünmeyen düğüm var; `zeroSized` çizilmemiş komponenti gösterir. Runtime düğümleri
 > `data-element-id` basmıyorsa yanıt `layoutReportUnavailable` der — tool tahmin üretmez.
 >
+> **Sürükle-bırakı gerçekten sınamak (G-09).** `kanban` ve `eventcalendar` iç öğelerine
+> `<elementId>__<rol>` kimliği yazar (tablonun `__row-<n>`'i ile aynı kalıp):
+> kart `kb_board__card-<id>`, kolon `kb_board__col-<value>`; etkinlik `cal_plan__event-<id>`,
+> gün `cal_plan__day-<yyyy-MM-dd>`, tüm gün hücresi `cal_plan__allday-<yyyy-MM-dd>`, saat dilimi
+> `cal_plan__slot-<yyyy-MM-dd>T<HH>`. `id`, `idField`'ın değeridir (yoksa `card-<sıra>` /
+> `event-<sıra>`); tarih yereldir. Tıklama yolu `click` ile, taşıma `drag` ile sınanır:
+> `actions: [{ action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned' }]`.
+> `actionsReport[].flowRuns`/`requests` sıfırsa `cardMove`/`eventMove` bağı kurulu görünse de
+> taşıma kalıcılaşmamıştır. Kaynak `draggable` değilse (`isDraggable`/`isEditable` kapalı)
+> adım `applied:false` ve notla döner. Çok günlü etkinlik aynı kimliği her gün hücresinde taşır;
+> hedef ilk eşleşmedir.
+>
 > **Üye kimliğiyle doğrulama (`asUser`).** Kapının kapalı olduğunu görmek yarısıdır; açık
 > olduğunu görmek diğer yarısı. `page_runtime_get` ve `page_screenshot` aynı `asUser` alanını
 > alır: uygulamanın kendi giriş ucundan (`microservice_execute`) aldığın üye jetonunu verirsin,
@@ -1935,10 +1999,22 @@ micro-op hattına dönün.
 >
 > **Gateway artık bunu söylüyor (FLOW-018).** `remove_component` içeren bir yamada gateway sayfanın
 > akışlarını okur ve silinen düğümü hedefleyen setter adımlarını uyarı olarak listeler: hangi akış,
-> hangi adım, hangi hedef. Uyarıyı gördüğünde yapılacak tek şey `flow_update` ile aynı gövdeyi
-> yeniden kaydetmektir. Ters yönü (`silinen düğümün referans verdiği` akışların platformca kalıcı
+> hangi adım, hangi hedef. Ters yönü (`silinen düğümün referans verdiği` akışların platformca kalıcı
 > silinmesi) ayrı bir uyarı kapsar; ikisi birlikte çıkabilir. Ölçüm 2026-09-04 (benchmark 4. koşu):
 > uyarı yokken aynı tuzak ~8 dakika teşhis aldı ve yalnız ekran görüntüsüyle görüldü.
+>
+> **Mekanizma ve onarım (2026-09-15, G-04).** Setter iteratee'si hedefini elementId olarak DEĞİL,
+> komponentin iç kimliği olarak saklar (`step_iterates.DesignComponentId`, FK `SetNull`); düğüm
+> yeni kimlikle yazılınca eski satır silinir ve alan boşalır — `flow_get` iteratee'yi `element`'siz
+> döndürür. Bu yüzden **`flow_get`'ten okunan gövdeyi aynen yeniden kaydetmek onarmaz** (element
+> zaten yok; `flow_update` FLOW-017'ye takılır). İki güvence var: (1) backend artık AYNI yamada
+> silinip aynı `elementId` ile eklenen düğüme (alt ağaç dahil) eski kimliğini geri veriyor, bağ
+> kopmuyor; (2) gateway yamadan sonra akışları yeniden okur ve kopan her iteratee için yanıtta
+> `flowTargetsLost` ile hazır onarımı verir:
+> `flow_patch` `{ op: 'add', path: '/steps[stepId=s4]/args/iteratees/0/element', value: 'f_range' }`.
+> `flow_get` de hedefsiz setter iteratee'sini `flowWarnings` (`FLOW-017 (okuma)`) ile gösterir.
+> Ayrı isteklerle (önce sil, sonra ekle) yapılan yeniden kurulum ve komple şema yazan `page_update`
+> bu korumanın DIŞINDADIR — prop tipini değiştirmek için düğümü hiç yeniden kurmayın.
 
 ## Bilinen sınırlar
 
@@ -2013,8 +2089,11 @@ micro-op hattına dönün.
   (süssüz) ekrana ifadenin **kendisini** basar; ifade yalnız `data`'da olursa prop **boş**
   render edilir. `set_binding` micro-op'u eski sürümlerde `data`'ya yazıyordu — bu davranış
   düzeltildi, ama daha önce kurulmuş sayfalarda kalıntı olabilir. Prop nesnesini birebir
-  kontrol etmen gerekirse `remove_component` + `add_component` ile
-  `{"type":"code","ref":"{{ … }}","data":"<yedek>"}` yaz; `replace_prop` her zaman `static` kurar.
+  kontrol etmen gerekirse `replace_prop` ile
+  `value: {"type":"code","ref":"{{ … }}"}` yaz — code tipi ve `ref` olduğu gibi kaydedilir
+  (platform code prop'unda `data`'yı saklamaz).
+  `replace_prop`'a `expression` alanı verme: platform onu yalnız `set_binding`'de okur (gateway
+  code sarmalına çevirir).
 
 - **Ana sayfa sayfadan değil application'dan değişir:** `page_create/update` gövdesindeki
   `isHomepage` platformca yok sayılır (tasarım). Doğru yol `application_update` →

package/dist/resources/guides/translation.md

@@ -81,22 +81,23 @@ backend'de zaten tanımlı, Studio'nun "Translate" aksiyonunun ürettiği şekil
   "value": { "type": "translation", "ref": "home.welcome", "data": "Hoş geldiniz" } }
 ```
 
-> **`replace_prop` ile kurulamaz, `set_prop_type` ile kurulur.** Micro-op applier her `value`'yu
-> `Static` (ifade verilmişse `Code`) Prop'a çevirir (`PageSchemaMicroOpApplier.cs:77`);
-> `translation` sarmalı gönderildiğinde sarmal `Data`'nın içine düşer ve prop sessizce bozulur.
-> Gateway `replace_prop`'un bu kullanımını **reddeder**. Kurulu bir prop'u çeviriye bağlamanın
-> yolu `set_prop_type`'tır:
+> **Yukarıdaki `replace_prop` sarmalı olduğu gibi çalışır (2026-09-15, G-04).** Micro-op applier
+> `{type, ref, data}` sözlüğünün tipini korur ve `Translation` Prop'unu `Ref` + metin `Data` ile
+> kurar (`PageSchemaMicroOpApplier.ApplyOne`). Gateway bu kullanımı eskiden reddedip komponenti
+> yeniden eklemeyi öneriyordu; o öneri uygulanınca düğüme yazan setter iteratee'lerinin `element`'i
+> silindi (bir panoda alt başlık ve tarih aralığı boş kaldı). Ref'siz translation sarmalı istek
+> gönderilmeden reddedilir; nesne `data` silinir. Eş yol `set_prop_type`'tır — mevcut `data`'yı
+> tasarım yedeği olarak taşır ve layout ağacında (micro-op hattı yok) tek yoldur:
 >
 > ```jsonc
 > { "op": "set_prop_type", "target": "welcome_text", "prop": "text",
 >   "propType": "translation", "ref": "home.welcome" }
 > ```
 >
-> Gateway şemayı okur, prop'un TİPİNİ yerinde değiştirir ve sayfayı tam gövdeyle geri yazar —
-> düğümün olay/setter bağları korunur. Eski yol (`remove_component` + `add_component`) düğümü
-> yeniden kurduğu için ona yazan setter iteratee'lerini sessizce öldürüyordu; artık gerekmiyor.
-> Taşıyıcı alan tipe göre değişir: `static` → `data`, `code` ve `translation` → `ref`. Eksik
-> taşıyıcı istek platforma gitmeden reddedilir ve `page_schema_validate` aynı kararı verir.
+> İkisi de düğümün olay/setter bağlarını korur. **Prop tipini değiştirmek için
+> `remove_component` + `add_component` yapmayın.** Taşıyıcı alan tipe göre değişir: `static` →
+> `data`, `code` ve `translation` → `ref`. Eksik taşıyıcı istek platforma gitmeden reddedilir ve
+> `page_schema_validate` aynı kararı verir.
 >
 > Ölçüldü 2026-09-08 (yerel `dil-dogrulama/dil-app`): kurulu bir `statcard`'ın `title` prop'u tek
 > `set_prop_type` op'uyla `f11.tam` anahtarına bağlandı; gerçek ekranda `tr` → "iki dilde dolu",
@@ -123,6 +124,30 @@ Son kullanıcı dili `language-selector` komponentiyle değiştirir (`platform_g
 prop'lar sayfa yenilenmeden yeniden çözülür — ayrı bir akış kurmana gerek yok, komponenti sayfaya
 eklemen yeterli. Projede dil tanımlı değilse (`languages` boşsa) liste boş çizilir.
 
+## 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:
+`?lang=<kod>` → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı
+(`resolveRuntimeLanguage`). `page_screenshot` `language` parametresi adrese o sorgu değerini
+ekler; seçim hem çeviriye bağlı prop'ları hem **çok dilli alanların satır değerlerini** kapsar,
+çünkü aynı değer veri diline de geçirilir.
+
+```jsonc
+{ "applicationSlug": "app", "pageSlug": "dashboard", "language": "en" }
+{ "applicationSlug": "app", "pageSlug": "dashboard", "language": "tr" }   // aynı sayfa, ikinci dil
+```
+
+Bunun pratik sonucu: **referans tasarımına dil değiştirici eklemek zorunda değilsin.** Görsel
+repro'su olan bir ekranı bozmadan iki dilin karesini alabilirsin; `language-selector` yalnız son
+kullanıcı gerçekten dil değiştirecekse gerekir.
+
+- Kod projenin `languages` listesinde değilse çağrı **reddedilir**. Runtime tanımadığı kodu yok
+  sayıp kareyi varsayılan dilde çizerdi ve "çevrildi" sanılan yanlış bir kare rapora girerdi.
+- Bölgeli kod (`tr-TR`) indirgenir ve indirgeme yanıtta `languageNote` ile bildirilir.
+- Aynı tool'un `colorScheme` parametresi ziyaretçinin tema tercihini sayfa açılmadan eker
+  (`localStorage`'daki `zeyrek-viewer-theme-mode`), yani koyu tema karesi için sayfada
+  `theme-toggle` bulunması da gerekmez.
+
 ## İstek dili: nereden gelir, hangi ifadede ne denir
 
 Her istekte dil şu sırayla çözülür: **`X-Data-Language` başlığı → `Accept-Language` → projenin

package/dist/resources/guides/workflow.md

@@ -375,6 +375,22 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
   başka alana ihtiyacı varsa bunları **`returnFields`** ile iste
   (`{ alias, fieldId, fieldSlug }` öğeleriyle) — `selectFields` write operasyonunda sessizce
   yok sayılır.
+- **Bulk yazma (`bulk-create`/`bulk-update`/`bulk-delete`) table step'te de vardır**, ama tek
+  satırlık `create`/`update`'in aksine satır dizisi `fields`'tan değil, adımın **`expression`**
+  alanının (JS) sonucundan gelir: `rule.expression` bir **dizi** döndürmeli, dizideki her
+  nesnenin anahtarı alan **slug**'ıdır (fieldId değil). `bulk-delete`'te dizi ya birincil anahtar
+  değerlerinin düz listesi (`{ value: [...] }` şeklinde tek elemanlı sarmalayıcı) ya da her öğesi
+  `{ <pk slug>: <değer> }` olan nesne dizisidir. Tek istekte en fazla 1000 satır
+  (`EntityConstants.BulkRowLimit`); aşarsa `BulkRowLimitException`. `fields`'ta tanımlı ve
+  **değeri dolu** bir sabit varsa her satıra uygulanır; boş bırakılan alanlar `expression`
+  sonucundaki satırı ezmez.
+  - **Dosya (ve çoka-çok dosya) alanı `bulk-create`/`bulk-update`'te desteklenir** — microservice
+    tarafındaki `bulk-create`/`bulk-update` ile **aynı format**
+    (`{ type, fileName, value, clone, override, id }`); her satırın dosya değeri ayrı ayrı
+    `fileService`'e yüklenir, dosya alanı olan tabloda bulk artık reddedilmez.
+  - **Studio'nun workflow table formunda bulk için `expression` editörü henüz yoktur** — akışı
+    UI'dan kurarken bulk operasyonu seçilemez; `rule.expression`'ı JSON/`workflow_patch` ile elle
+    yazmak gerekir, yoksa adım `MissingParameterException` ile düşer.
 - **Çıktının ŞEKLİ `isSingle`'a bağlıdır** (ölçüm: 09-04 koşusu Y-15). `isSingle: true` ise
   `<step>.data` nesnedir ve `<step>.data.id` çalışır; **`isSingle: false` ise `data` bir
   DİZİDİR** — `<step>.data.id` `undefined` olur, akış `RowValidationFailed` ile düşer ve hata
@@ -395,6 +411,38 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
 > **Gateway table step'lerinde `path`/`sort`/`limit` eksiklerini otomatik dolduruyor**
 > (yanıtta `gatewayNormalized`). Dolu değerlere dokunmaz; yanlış path yine WF/MS block'una takılır.
 
+## Table update adımı: yazılan alan kümesi ADIMDAN gelir
+
+`operation: 'update'` (aynısı `create`/`upsert`) adımında SET listesi `rule.fields[]`'tir.
+`PrepareParameters` listedeki **her** alanın ifadesini değerlendirir (`TableStep.cs:508-530`),
+`undefined` dönen sonucu `Parse` `null`a çevirir (`CommonFieldType.cs:59`) ve satır sözlüğü
+süzgeçsiz kurulur (`TableStep.ByUpdateAsync`, `:254-262`). İki sonucu vardır:
+
+- Gövdede o anahtar yoksa `input.x` **`undefined`**'dır ve kolona **NULL yazılır** — eski değer
+  silinir, yanıt yine 200'dür.
+- Adımda listelenmeyen alan hiçbir gövdeyle **değiştirilemez**.
+
+Ölçüm (2026-09-15): `fields: [title, owner, status]` olan bir update adımına `{ id, status }`
+gövdesi gitti; uç 200 döndü, `status` değişti, `title` ve `owner` **NULL** oldu. Microservice
+`update` ucuyla birebir aynı davranış; tam tablo ve kısmi güncellemenin üç doğru yolu
+`platform_guide('microservice')` §"Güncelleme sözleşmesi"nde.
+
+Gateway bunun tanımdan görülebilen hâlini **WF-031 (warn)** ile keser: yazma adımı akışın giriş
+DTO'sunda OLMAYAN bir `input.x` alanını bağlıyorsa o ifade kesinlikle `undefined` döner ve kural
+eksik alanları adıyla sayar. Uyarıyı susturmanın doğru yolu adımı **eylem başına daraltmaktır**
+(`fields[]` yalnız o eylemin yazdığı alanlar); alanı DTO'ya eklemek yalnız izin verir, çağıranın
+her istekte göndereceğini garanti etmez.
+
+Akışta kısmi güncelleme gerekiyorsa **oku-birleştir**: önce `table get`, sonra `table update`,
+gelmeyen alan okunan değere düşsün —
+
+```js
+typeof input.title !== 'undefined' && input.title !== null ? input.title : read_row.data.title
+```
+
+(ölçüldü: `{ id, status }` gövdesiyle `title`/`owner` korundu). Bedeli fazladan bir okuma turu ve
+**son yazan kazanır**; eylem başına ayrı uç kurmak hâlâ daha ucuz ve daha güvenlidir.
+
 ## Response step'i gövdeyi `bodyExpression`'dan üretir
 
 `rule: { dataTransferObjectId }` **hiçbir şey döndürmez** (`result: null`). Çalışan şekil:
@@ -537,7 +585,7 @@ yolunu değiştirir: kapalı yolu deneyip raporuna "kanıtlayamadım" yazma, kan
 - Join'li table step'inde kök `rule.alias` boş (WF-019, block — Postgres 42601'in sebebi)
 - Akışta hiç okunmayan `selectFields` alanı (WF-023, warn — gereksiz taşınan sütun)
 - Adımda ya da akışta `description` yok (WF-024, block — Studio'da adım okunamaz kalır)
-- İlişki alanının içini okuyan ifade (WF-020, warn — join yoksa alan düz FK'dır)
+- İlişki alanının içini okuyan ifade (WF-020, warn — join yoksa alan düz FK'dır); `Functions.<ad>()` çağrısı SUNUCUDA GEÇERSİZDİR (`WF-030` block, 2026-09-10) — `function_create source:'workflow'` ile tanımla, çıplak adla çağır
 - `set-user` adımı olmadan `user` okuyan middleware (MW-003, warn)
 - Backend zorunlulukları (WF-026, block — istek gitmeden): `name`/`slug`; `returnDtoId` varsa
   `returnBehavior`, `parameterDtoId` varsa `parameterBehavior` (`primitive` | `object` | `array`),
@@ -615,7 +663,8 @@ Kaydedilen sözleşme üç tüketim yolunda da aynı şekilde bağlanır:
 |---|---|
 | `queryStepSourceType: 'library'` (workflow query adımı) | Adımın ifadeleri: `rule.expression` (nesne literali) ya da `rule.queryParameters[]` — ikisi de **JavaScript ifadesidir**; istek girdisini (`input.year`), önceki adım çıktısını **ve bağlı middleware'in `user.*` değişkenini** okur |
 | Query kaynaklı microservice (`source: 'query'`) | Yalnız çağrının kendisi: **body → query-string → header** (`MicroserviceExecuteParameter.FindValue`); ifade YOKTUR, `user.*` bu yola girmez |
-| `query_preview` | `parameters` alanı — davranış yukarıdaki ikisiyle aynıdır |
+| `query_preview` | Komutun `definition.parameters[].value` alanı; tool'un üst düzey `parameters` argümanı (ad → değer) gateway'de oraya bağlanır. Değer almayan parametre yanıtta `unboundParameters` ile listelenir |
+| `microservice_execute` / `microservice_debug` | Üst düzey `parameters` (ad → değer): gateway GET/DELETE'te query-string'e, POST/PUT'ta gövdeye koyar — yukarıdaki query kaynaklı uç satırının okuduğu yer. `microservice_debug` NULL bağlanan parametreyi `unboundParameters` ile adıyla verir |
 
 > **Boş string parametre `NULL`'a çevrilir.** `Query.NormalizePreviewParameters` değeri normalize
 > ederken boş ya da yalnız boşluktan oluşan değeri `null` yapar. `WHERE status = {{durum}}` yazıp

package/dist/resources/schema-fingerprint.json

@@ -1,8 +1,8 @@
 {
-  "hash": "0e6bb2b45f8c545b50dc6d6169e7d816d9cb9532ecbaed894307995d537ff3b6",
-  "generatedAt": "2026-09-09T09:49:52.511Z",
-  "types": 103,
-  "files": 73,
+  "hash": "cafe3a6b082c7828cece4eaa1c0115ba28581f157eac3288abcf068c7f6f8533",
+  "generatedAt": "2026-09-15T10:24:42.398Z",
+  "types": 185,
+  "files": 107,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
   "missing": []
 }

package/dist/resources/schemas/AnalyzeImportQuery.json

@@ -0,0 +1,51 @@
+{
+  "schema": {
+    "required": [
+      "fileId"
+    ],
+    "type": "object",
+    "properties": {
+      "datasourceId": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "fileId": {
+        "minLength": 1,
+        "type": "string",
+        "format": "uuid"
+      },
+      "locale": {
+        "type": "string",
+        "nullable": true
+      },
+      "headerRow": {
+        "minimum": 0,
+        "type": "integer",
+        "format": "int32",
+        "nullable": true
+      },
+      "csv": {
+        "$ref": "#/components/schemas/NgApps.Application.Contexts.Datastore.Imports.ImportCsvOptionsDto"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {
+      "NgApps.Application.Contexts.Datastore.Imports.ImportCsvOptionsDto": {
+        "type": "object",
+        "properties": {
+          "delimiter": {
+            "type": "string",
+            "nullable": true
+          },
+          "encoding": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}

package/dist/resources/schemas/ApplyMergePlanCommand.json

@@ -0,0 +1,19 @@
+{
+  "schema": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "planId": {
+        "type": "string",
+        "format": "uuid"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {}
+  }
+}

package/dist/resources/schemas/CreateBulkRowCommand.json

@@ -23,6 +23,9 @@
           "nullable": true
         },
         "nullable": true
+      },
+      "relationsByName": {
+        "type": "boolean"
       }
     },
     "additionalProperties": false

package/dist/resources/schemas/CreateEnvironmentCommand.json

@@ -0,0 +1,31 @@
+{
+  "schema": {
+    "required": [
+      "name"
+    ],
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "name": {
+        "minLength": 1,
+        "pattern": "\\A(?=.{3,31}\\z)[a-z][a-z0-9_-]*(/[a-z0-9][a-z0-9_-]*)*\\z",
+        "type": "string"
+      },
+      "parentEnvironmentId": {
+        "type": "string",
+        "format": "uuid",
+        "nullable": true
+      },
+      "includeRecords": {
+        "type": "boolean"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {}
+  }
+}

package/dist/resources/schemas/CreateGlobalFunctionCommand.json

@@ -0,0 +1,95 @@
+{
+  "schema": {
+    "required": [
+      "body",
+      "name",
+      "source"
+    ],
+    "type": "object",
+    "properties": {
+      "source": {
+        "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionSource"
+      },
+      "applicationId": {
+        "type": "string",
+        "format": "uuid",
+        "nullable": true
+      },
+      "pageId": {
+        "type": "string",
+        "format": "uuid",
+        "nullable": true
+      },
+      "scope": {
+        "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionScope"
+      },
+      "name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "type": "string",
+        "nullable": true
+      },
+      "isAsync": {
+        "type": "boolean"
+      },
+      "parameters": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/NgApps.Application.Contexts.Studio.GlobalFunctions.GlobalFunctionParameterDto"
+        },
+        "nullable": true
+      },
+      "body": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {
+      "NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionSource": {
+        "enum": [
+          "workflow",
+          "studio"
+        ],
+        "type": "string",
+        "format": ""
+      },
+      "NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionScope": {
+        "enum": [
+          "application",
+          "page"
+        ],
+        "type": "string",
+        "format": ""
+      },
+      "NgApps.Application.Contexts.Studio.GlobalFunctions.GlobalFunctionParameterDto": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "required": {
+            "type": "boolean"
+          },
+          "defaultValue": {
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}