@appaflytech/zeyrek-ai-mcp 0.0.32 → 0.0.34

package/dist/knowledge/componentCatalog.js

@@ -134,7 +134,7 @@ export const componentKnowledge = {
         behavior: [
             LAYOUT_ABSENT_NOTE,
             "GÖNDERİM: submit yalnız bütün kurallar geçince yayılır; kalırsa alanlar işaretlenir, liste dolar ve sayfa listeye kayar. Alan mesajları formun İLK gönderiminden sonra görünür, o andan itibaren her change o alanı canlı yeniden doğrular. Formu gönderen düğme Type='submit' olur (form içinde ya da formId ile bağlı); akışta event.source.id gönderen düğmenin ADI, event.source.props onun prop'larıdır — event.data boştur (componentEvents).",
-            "value ve isValid RUNTIME YAZAR, panelde çizilmez (2026-09-18): Page.components.<form>.value = { <alan adı>: değer } — yalnız doğrulama sözlüğündeki alan bileşenleri girer (text/button gibi gösterim düğümleri girmez), boş alan null, aralık seçici { valueFrom, valueTo }; gönderim akışında self.value ile de okunur ve uca olduğu gibi verilebilir. Page.components.<form>.isValid mount'ta ve her değişimde SESSİZCE yeniden hesaplanır (gizli alanlar muaf, form düzeyi kurallar dahil) — mesaj göstermez; submit düğmesini {{ !Page.components.<form>.isValid }} ile kilitlemenin yolu budur. İkisini setter ile YAZMA, sonraki değişimde ezilir.",
+            "value ve isValid RUNTIME YAZAR, panelde çizilmez (2026-09-18): Page.components.<form>.value = { <alan adı>: değer } — yalnız doğrulama sözlüğündeki alan bileşenleri girer (text/button gibi gösterim düğümleri girmez), boş alan null, aralık seçici { valueFrom, valueTo }; gönderim akışında self.value ile de okunur. DİKKAT (ölçüldü 2026-10-03): bu toplu değer boolean ve sayı alanlarında false/0'ı '' taşır — uca form.value/self.value ile VERME: nullable kolon NULL'lanır (kayıttaki 7/true silinir), NOT NULL kolonda 400 RowValidationFailed. Uca her alanı KENDİ prop'undan gönder (property ref ya da Page.components.<alan>.value); form resetForm ya da isClearFormInputsAfterSubmit kullanıyorsa sıfırlama alanın prop'unu da ''ya çevirir, o durumda değeri zorla: boolean <alan>.value === true, sayı typeof <alan>.value === 'number' ? <alan>.value : null. required da değeri aynı biçimde okur: 0 ve false BOŞ sayılır (bileşen notlarına bak). Page.components.<form>.isValid mount'ta ve her değişimde SESSİZCE yeniden hesaplanır (form düzeyi kurallar dahil) — mesaj göstermez. GİZLİLİK MUAFİYETİ YALNIZ ALANIN KENDİ isHidden'ıdır: isHidden'lı bir kabın (container/box) ya da appearance.hideOn ile gizlenen kabın içindeki zorunlu alan doğrulanmaya devam eder, ekranda olmadığı hâlde hata listesine girer ve gönderimi KİLİTLER; form düzeyi kural (validations element) hedefi kendisi gizli olsa bile koşar. Koşullu bölümde zorunlu alanların her birine kendi isHidden koşulunu ver, kabı gizlemeye güvenme. isHidden bir ifadeye ({{ }}) bağlıysa isValid bir adım geriden gelebilir (gönderim gizliliği canlı okur); gizli alanların değeri value'da kalır (ölçüldü 2026-10-03); submit düğmesini {{ !Page.components.<form>.isValid }} ile kilitlemenin yolu budur. İkisini setter ile YAZMA, sonraki değişimde ezilir.",
             "Düzen prop grubunun TAMAMINI taşır (2026-09-01): layout ('flex' | 'grid') + direction/horizontalAlign/verticalAlign/size/gap/wrap, varsayılanları container ile aynı (flex · row · left · top · shrink · medium · wrap açık). 'Form'a layout yazılmaz' eski bilgidir. layout prop'u hiç yazılmamış eski form kayıtları ızgara koordinatıyla (blocks[].position + size.w) dizilmeye devam eder. Platform kataloğu component_get'te hâlâ eski şemayı gösteriyorsa kayıt yenilenmemiştir (ARC-024).",
             "Alan doğrulaması komponentin kendi validations dizisindedir: [{ type: 'required'|'email'|'max-length'…, message, value, isActive }] — dördü de zorunlu, eski 'maxLength' yazımı kaydedilir ama runtime doğrulayıcı onu TANIMAZ ve sessizce hiçbir şey doğrulamaz. min-value/max-value tarih kuralının çıplak 'yyyy-MM-dd' değeri YEREL gün okunur (2026-09-18): sınır gününe eşit bir alan değeri her saat diliminde geçer (eskiden UTC okunup Türkiye'de 3 saat kayıyordu, CQ-252).",
             "message bir ÇEVİRİ ANAHTARI olabilir: 't:' önekiyle yazılan mesaj (ör. 't:form.required') uygulamanın çeviri sözlüğünden çözülür — hem alanın kendi hata metninde hem form-validation-errors listesinde. Öneksiz mesaj yazarın kendi cümlesidir ve iki nokta içerse bile aynen gösterilir. Çözüm form MOUNT olurken bir kez yapılır: ekranda hata dururken dil değiştirilirse metin sayfa yenilenene kadar eski dilde kalır.",
@@ -148,8 +148,8 @@ export const componentKnowledge = {
             validations: "FORM DÜZEYİ kurallar — alanın kendi validations dizisi DEĞİL: [{ name, element, condition, message }]. condition bir ifade ya da fx bağıdır ve TRUE olunca kural KIRILMIŞ sayılır ('table1.rows.length <= 0', 'Page.components.end.value < Page.components.start.value'); element (elementId) işaretlenir, message (t: anahtarı olabilir) listeye o alanın etiketiyle girer. İŞARET ve MESAJ yalnız gönderimde; koşulun kendisi isValid için her alan değişiminde sessizce yeniden değerlendirilir (formun dışındaki bir düğüme bağlı koşul — 'table1.rows.length' gibi — yalnız o anlarda ve gönderimde okunur). Repeater içindeki form için value/isValid tanımsızdır (satır parametresi taşımaz).",
             title: "Başlık bandının metni; boş bırakılırsa bant ve alt çizgisi hiç çizilmez.",
             isLoading: "Açıkken alanlar yerine yükleme animasyonu — çocuklar DOM'dan kalkar, kapanınca yeniden mount olur (mount olayları ikinci kez çalışır). Sorgu sonucu gelene kadar formu kapatmak için akıştan açılıp kapatılır.",
-            value: "RUNTIME YAZAR, okunur: { <alan adı>: değer } — alan adı düğümün name'i, boş alan null, aralık seçici { valueFrom, valueTo }; gösterim düğümleri girmez. Panelde görünmez, setter ile yazılmaz.",
-            isValid: "RUNTIME YAZAR, okunur: bütün alan kuralları ve form düzeyi kurallar şu an geçiyor mu. Mount'ta ve her değişimde sessizce güncellenir, mesaj göstermez; gizli alanlar muaf."
+            value: "RUNTIME YAZAR, okunur: { <alan adı>: değer } — alan adı düğümün name'i, boş alan null (boolean/sayı alanında false/0 da '' olur — uca verme, behavior'a bak), aralık seçici { valueFrom, valueTo }; gösterim düğümleri girmez. Panelde görünmez, setter ile yazılmaz.",
+            isValid: "RUNTIME YAZAR, okunur: bütün alan kuralları ve form düzeyi kurallar şu an geçiyor mu. Mount'ta ve her değişimde sessizce güncellenir, mesaj göstermez; yalnız KENDİ isHidden'ı açık alanlar muaf — gizli kabın içindeki alan muaf değil."
         }
     },
     box: {
@@ -448,7 +448,7 @@ export const componentKnowledge = {
             'Liste açıldığında seçili olanlar (ve seçili çocuğu olan başlıklar) başa alınır; sıra liste AÇILDIĞI ANDA dondurulur, seçim değiştikçe satırlar zıplamaz.',
             "optionType='grouped' iken children alt satırları çizer; çocuğu olan satır VARSAYILAN OLARAK SEÇİLEMEZ: kutusu çizilmez ve satırın kendisi disabled'dır, açıp kapatmak yalnız sağdaki ok düğmesiyle (ya da klavyede Enter/ok tuşlarıyla) olur — başlık da seçilebilsin isteniyorsa o option'a isSelectable ver. optionType='single' iken children/isExpanded/isSelectable okunmaz.",
             'Arama kutusu boşken Backspace son etiketi siler; etiketler tek satıra sığmazsa fazlası "+n" rozetinde toplanır (kilitli/viewmode alanda rozet tıklanınca kalanları listeler).',
-            "Doğrulama kuralları: required · minItems · maxItems (2026-09-11; `pattern` bildirimi kaldırıldı — değeri dizi olan alanda uygulanacak metin yok ve panelde hiç çizilemiyordu). Panel bu iki sayı kuralını 'Min length' / 'Max length' adıyla çizer; dizide uzunluk = SEÇİLİ ELEMAN SAYISI."
+            "Doğrulama kuralları: required · minItems · maxItems (2026-09-11; `pattern` bildirimi kaldırıldı — değeri dizi olan alanda uygulanacak metin yok ve panelde hiç çizilemiyordu). Panel bu iki sayı kuralını 'Min length' / 'Max length' adıyla çizer; dizide uzunluk = SEÇİLİ ELEMAN SAYISI. minItems/maxItems yazılırsa gateway min-length/max-length'e çevirir."
         ],
         propNotes: {
             value: "Seçili değerlerin dizisi — ilişki alanlarında etiket değil id yazılır/okunur. Düz değer dizisi de (['a', 'b']) geçerlidir; etiketler options yüklendiğinde tazelenir.",
@@ -469,7 +469,7 @@ export const componentKnowledge = {
             "Seçenekler iki kaynaktan gelir: statik options prop'u yerel olarak süzülür; komponente search olayına akış bağlıysa süzme SUNUCUDADIR ve options akıştan geldiği gibi gösterilir (dropdown/autocomplete deseninin aynısı). Eklenmiş etiketler her iki modda da listeden düşer.",
             'Olaylar: mount (render katmanı atar) · change (etiket eklenince/silinince/rengi değişince, setter) · search · focus · blur. Etiketin rengini değiştirmek de change yayar — renk değerin parçasıdır.',
             'Yinelenen etiket eklenemez: ölçü kırpılmış + küçük harftir ("Ankara" varken "ankara" eklenmez). Yapıştırma , ve satır sonundan böler, her parça ayrı etiket olur; options ile eşleşen parça seçeneğin RENGİYLE eklenir.',
-            "Zorunluluk ve eleman SAYISI sınırı Validations'tan kurulur: Required · Min length · Max length. Dizi alanında 'length' eleman sayısını ölçer (CQ-226 ad ikiliği). Bileşen bu sınırı kendisi GÖRMEZ, yani sınır dolunca giriş kapanmaz, kural gönderimde işler (CQ-093)."
+            "Zorunluluk ve eleman SAYISI sınırı Validations'tan kurulur: Required · Min length · Max length. Dizi alanında 'length' eleman sayısını ölçer (CQ-226 ad ikiliği); minItems/maxItems yazılırsa gateway min-length/max-length'e çevirir. Bileşen bu sınırı kendisi GÖRMEZ, yani sınır dolunca giriş kapanmaz, kural gönderimde işler (CQ-093)."
         ],
         propNotes: {
             value: 'Seçili etiketler: [{ value, color? }]. Renk hex (#rrggbb); verilmezse etiket gri çizilir.',
@@ -488,11 +488,11 @@ export const componentKnowledge = {
         behavior: [
             "change HER TUŞTA yayılır; değer kesinleşince (blur/Enter) changed yayılır — arama sorgusu ya da kayıt gibi pahalı akışı changed'e (ya da enter'a) bağla, change'e değil.",
             "enter yalnız Enter'da yayılır; textinput bir form içindeyse Enter aynı anda formun submit akışını da tetikler — kaydetmeyi forma bağla, enter'a bağlarsan iki kez çalışır.",
-            "inputMask seçiliyse yazılan metin anında maskeye biçimlenir ve value biçimli halidir ('0(555) 123 45 67' gibi); ham rakam istiyorsan akışta ayıkla. Maske dışı karakterler sessizce düşer."
+            "inputMask seçiliyse KULLANICININ yazdığı metin anında maskeye biçimlenir ve value biçimli hâlidir ('0(555) 123 45 67'); kullanıcı yazarken maske dışı karakterler sessizce düşer. Akıştan/kayıttan yazılan değer ise OLDUĞU GİBİ kalır (ekranda biçimli görünür). Form, biçimlenince hiçbir karakter kaybetmeyen ham değeri ('5551234567') kabul eder ve akışa HAM gönderir; karakter kaybettiren değer ('+905551234567', fazla hane, küçük harf) ile tarih/saat/son kullanma maskelerindeki ayraçsız değer 'Value does not match the selected input mask.' ile formu kilitler — o maskelere akıştan biçimli yaz. Ham rakam istiyorsan akışta ayıkla (2026-10-03)."
         ],
         propNotes: {
             clearable: 'Değer varken alanın sağında × düğmesi çizer; tıklanınca value boşalır ve change + changed yayılır. Kilitli (disabled/readonly/viewmode/loading) alanda çizilmez.',
-            inputMask: "Hazır maske anahtarı (pattern:/date:/time:/regex:…); serbest desen için 'custom:' öneki ('custom:(###) ###-####').",
+            inputMask: "Hazır maske anahtarı (pattern:/date:/time:/regex:…); serbest desen için 'custom:' öneki ('custom:(###) ###-####'). IBAN anahtarı 'iban:TR## #### #### #### #### #### #### ##' dizesi 28 # okunur ama deseni TR + 24 rakamdır (26 karakter); geçerli TR IBAN biçimlenir ve Form maske denetiminden geçer (2026-10-03).",
             prefixIcon: "Alanın İÇİNDE solda çizilen salt görsel ikon ({ name: 'search' }); value'ya karışmaz. Renk verilmezse ikincil metin rengi. Viewmode'da hiç çizilmez: alan düz metne döner ve ikon yuvası kadar girinti bırakmaz.",
             suffixIcon: "Alanın içinde sağda çizilen ikon; × ve spinner'ın sağında durur. Viewmode'da hiç çizilmez.",
             maxChars: "SERT sınır: fazlası YAZILAMAZ (maskesizde tarayıcı maxlength'i, maskelide biçimlenmiş değer kesilir). Akıştan gelen daha uzun değer aynen gösterilir, yeniden yazılmaz (sayaç 45/40 okur). validations.maxLength'ten FARKLIDIR: o yalnız doğrular. 0/boş = sınırsız.",
@@ -537,7 +537,9 @@ export const componentKnowledge = {
             "change HER TUŞTA ve artı/eksi düğmesinde yayılır; değer kesinleşince (blur/Enter, düğme tıklaması) changed yayılır — sorgu ya da kayıt gibi pahalı akışı changed'e (ya da enter'a) bağla.",
             "minValue/maxValue yazarken değil KESİNLEŞİNCE kırpar: min 10 alanına '15' yazılabilir (ilk tuşta 1 → 10'a çekilmez); blur/Enter'da aralık dışı değer sınıra çekilir ve change+changed yayılır. 0 gerçek sınırdır, boş = sınırsız.",
             "Boşaltılan alan 0 sayılır: silinince change 0 yayılır, blur'da alan 0 gösterir; null/boş değer durumu yoktur. placeholder yalnız value akıştan null/boş yazıldığında görünür.",
-            "allowDemicalPoints kapalıyken tarayıcının native number alanıdır (tam sayı kullanımı; step tam sayı ver), açıkken locale'e göre biçimlenen metin alanıdır (tr 1.250,50 / en 1,250.50) — decimalPlaces, useThousandsSeparator ve locale yalnız açıkken okunur. Modu kapatıp açmak kesri düşürür."
+            "allowDemicalPoints kapalıyken tarayıcının native number alanıdır (tam sayı kullanımı; step tam sayı ver), açıkken locale'e göre biçimlenen metin alanıdır (tr 1.250,50 / en 1,250.50) — decimalPlaces, useThousandsSeparator ve locale yalnız açıkken okunur. Modu kapatıp açmak kesri düşürür.",
+            "required 0'ı da BOŞ sayar: kullanıcının sildiği kutu 0 yayar ve yine 'zorunlu' hatası verir. 0 meşruysa required koyma; 'pozitif olmalı' için min-value: 1 kullan. value'yu açıkça yaz: yazılmazsa ekranda 0 görünür ama form boş sayar ve kullanıcının o boş kutuya yazdığı 0 olay yaymaz (ölçüldü 2026-10-03).",
+            "Tam sayı kipinde (allowDemicalPoints kapalı) alan tarayıcının min/max/step denetimini taşır ve Form'da novalidate yoktur: açılışta ya da akıştan gelen aralık dışı ya da adım ızgarası dışı değer (değersiz düğümün gösterdiği 0 + minValue 1, akıştan 15 > maxValue 10, akıştan 2.5 + step 1) Kaydet'te TARAYICI balonuyla gönderimi durdurur — submit akışı koşmaz, hata listesi boş kalır, aynı formdaki diğer alanların hataları da görünmez. Kullanıcının yazdığı aralık dışı değer blur/Enter'da sınıra çekilir; adım dışı ondalık (2.5, step 1) çekilmez ve aynı balona takılır. Adım ızgarası minValue'dan başlar (min 1, step 10 → 1, 11, 21…); bileşenin + düğmesi 0'dan 10 üretip balona takılabilir. Bu yüzden value'yu aralıkta ve ızgarada yaz, minValue 0'dan büyükse value'yu mutlaka yaz. isReadonly alan bu denetimden muaftır. Ondalık kipte (allowDemicalPoints açık) min/max/step hiç uygulanmaz: akıştan gelen aralık dışı değer olduğu gibi gider (ölçüldü 2026-10-03)."
         ],
         propNotes: {
             prefix: "Girdinin içinde SOLDA çizilen salt görsel ek (₺, $ gibi); value'ya karışmaz. Viewmode'da da çizilir — değerin anlamını taşır.",
@@ -552,21 +554,23 @@ export const componentKnowledge = {
     incrementalinput: {
         summary: 'Otomatik kod alanı: önek + ayraç + sıfır dolgulu sayaç (INV-0001); sıradaki kodu runtime’da sunucudan çeker. Sayısal stepper DEĞİLDİR — artır/azalt için numberinput.',
         behavior: [
-            'Sunucu isteği YALNIZ runtime rotalarında atılır (/preview, /view, /dev, /branch) ve ilki 1 sn gecikmeyle gider; tasarım kanvasında hiç atılmaz. Kanvasta alan boş kalır, üretilecek kod YER TUTUCU olarak önizlenir (önek/ayraç/sayaç/hane böylece kanvasta görünür).',
+            "MCP ile kurarken separator, counter, digitcount, autoFetchNextCode:true ve field AÇIKÇA yazılır: component_get.defaults (separator '-', counter 1, digitcount 2, autoFetchNextCode true) yalnız Studio'dan bırakılan düğüme yazılır; düğümde yoksa bileşen ''/null/null/false okur, alan düz metin kutusuna döner, istek gitmez ve kayıt NULL gider (ölçüldü 2026-10-02).",
+            "Sunucu isteği YALNIZ runtime rotalarında atılır (/preview, /view, /dev, /branch) ve ilki 1 sn gecikmeyle gider; tasarım kanvasında hiç atılmaz. Değer boşken alan (kanvasta VE runtime'da) counter'dan YERELDE hesaplanan kodu gri yer tutucu olarak gösterir — bu, sunucunun vereceği numara da değer de DEĞİLDİR (ölçüldü 2026-10-02: yer tutucu NUL-0001, gerçek sıradaki NUL-0003).",
             'İstek POST entities/{entityId}/row/next-code — entity + alan (field) seçilmeden, sayaç ya da hane 0 iken, ya da önek varken ayraç boşken hiç gitmez. Önek BOŞ olabilir: o zaman ayraç da düşer ve kod yalnız sayaçtır.',
             'change olayı İKİ farklı yük taşır: sunucudan kod gelince değer NESNEdir ({ Prefix, Separator, Counter, DigitCount, FieldId }) — kodun metni değil kodu ÜRETEN şekil; kullanıcı elle yazınca değer düz METİNdir. self.value okuyan akış ikisini de karşılamalı.',
-            'Elle yazılan değer korunur: yazmaya başlandıktan sonra dönen sunucu yanıtı atılır, alan yeniden yazılmaz. Aynı entity/alan/şekil için istek bir kez atılır (şekil değişirse yenilenir).',
+            "Elle yazılan değer korunur: yazmaya başlandıktan sonra dönen sunucu yanıtı atılır, alan yeniden yazılmaz. Değer dolu METİNse istek hiç gitmez. İstek açılışta bir kez gider; runtime'da akış şekil prop'unu (prefix/counter…) değiştirirse yeni istek ÖNCEKİ şekille gider (ölçüldü 2026-10-02: prefix YEN yazıldı, kod NUL-0008 kaydedildi) — şekli akıştan değiştirme.",
+            "Form temizlenince (isClearFormInputsAfterSubmit ya da resetForm) değer null olur ve yeni kod GELMEZ: art arda kayıtta ikinci kayıt kodsuz gider (nullable alanda NULL, NOT NULL alanda 400 RowValidationFailed). Ardışık kayıt formunda temizlemeyi KAPALI tut — değer şekil nesnesi kalır ve backend her kayıtta yeni kod üretir (ölçüldü: WRK-0009, WRK-0010); ekranda eski kod kalır, yeni numarayı kayıttan dönen satırdan al.",
             'next-code isteği başarısız olursa alan invalid görünür ve hata metni invalidText’in YERİNE yazılır — panelde isInvalid kapalı olsa bile.',
             'Dört kip ekranda ayrı görünür: isDisabled gri + tıklanamaz, isReadonly okunur zemin, isViewmode çerçevesiz düz metin (önizleme de çizilmez), isLoading alanı dondurur ve sağda spinner döndürür. İstek sürerken bileşen isLoading görünümünü KENDİSİ açar.'
         ],
         propNotes: {
-            value: 'Ya sunucudan gelen şekil nesnesi ya da elle yazılmış metin (davranışa bak). Kayıtlı satır nesneyi saklar, ekranda kodun metni görünür.',
-            prefix: 'Kodun başındaki sabit ek (INV). Boş bırakılabilir; boşsa ayraç da yazılmaz.',
-            separator: 'Önek ile sayaç arasındaki ayraç. Önek varsa ZORUNLUDUR — boşsa kod hiç üretilmez.',
-            counter: 'Sayacın başlangıç değeri (en az 1). Sıradaki numarayı backend belirler; bu değer isteğin başlangıç noktasıdır.',
-            digitcount: 'Sayacın kaç haneye sıfırla doldurulacağı (en az 1): 4 → 0001.',
+            value: "Ya sunucudan gelen şekil nesnesi ya da elle yazılmış metin (davranışa bak). Nesneyi uca OLDUĞU GİBİ gönder: backend kodu üretir ve alanı kod METNİYLE değiştirir (satırda INV-0003 gibi metin durur, nesne değil). Nesnedeki Counter başlangıç değeridir, kaydedilen numara değil; kod metni akışta YOKTUR — kayıttan dönen satırdan oku (Steps.<adım>.data.<alan>) (ölçüldü 2026-10-02).",
+            prefix: "Kodun başındaki sabit ek (INV). Boş bırakılabilir; boşsa ayraç da yazılmaz. Backend sınırı en çok 3 karakter: önizleme fazlasını gösterir ama kayıt 400 InvalidParameterException ile düşer, satır yazılmaz (ölçüldü 2026-10-02).",
+            separator: "Önek ile sayaç arasındaki ayraç. Önek varsa ZORUNLUDUR — boşsa kod hiç üretilmez. Backend sınırı 1 karakter: '--' önizlenir ama kayıt 400 InvalidParameterException ile düşer.",
+            counter: "Sayacın başlangıç değeri (en az 1). Sıradaki numarayı backend belirler; bu değer isteğin başlangıç noktasıdır. Numara alan başına TEK sıradır: önek değişse de kaldığı yerden devam eder (ölçüldü: INV-0002'den sonra NUL önekiyle ilk kod NUL-0003).",
+            digitcount: "Sayacın kaç haneye sıfırla doldurulacağı (1–12): 4 → 0001. 12'yi aşan değer önizlenir ama kayıt 400 InvalidParameterException ile düşer.",
             autoFetchNextCode: 'Kapalıyken istek atılmaz VE önek/ayraç/sayaç/hane hiç okunmaz — alan düz bir metin girdisine döner, kanvas önizlemesi de kaybolur.',
-            field: 'Kodun hangi tablonun hangi alanı üzerinden ilerleyeceği (entity + alan). Seçilmeden otomatik çekme çalışmaz.',
+            field: 'Kodun hangi tablonun hangi alanı üzerinden ilerleyeceği. Biçim: JSON metni {"entityId":"<GUID>","fieldId":"<GUID>"} (Studio bunu yazar) ya da aynı anahtarlı nesne; ikisi de GUID. Slug çalışmaz: düz slug sessizce istek atmaz, JSON içinde slug 404 alır; { entity, field } anahtarları okunmaz. Alan Incremental tipinde ve formun YAZDIĞI alanla aynı olmalı — değilse önizleme çalışır ama kayıt 400 InvalidParameterException ile düşer (ölçüldü 2026-10-02).',
             placeholder: 'Alan boşken görünen metin. Otomatik çekme açıkken önizlenen kod bunu EZER; buradaki metin yalnız otomatik çekme kapalıyken görünür.',
             prefixIcon: "Alanın İÇİNDE solda çizilen salt görsel ikon ({ name: 'tag' }); value'ya karışmaz. Viewmode'da çizilmez.",
             suffixIcon: "Alanın içinde sağda çizilen ikon; yükleniyor spinner'ının sağında durur. Viewmode'da çizilmez.",
@@ -600,7 +604,8 @@ export const componentKnowledge = {
             'Kilitli (isDisabled/isReadonly/isViewmode) ya da isLoading olan kutu hiçbir olay yaymaz; focus/blur de susar.',
             'value akıştan METİN gelirse: "false" · "0" · "no" · "off" · "null" · "undefined" · "nan" · boş metin YANLIŞ sayılır, kalan dolu metin doğru. Yine de alana boolean yaz — sözleşme boolean’dır.',
             'Zorunluluk prop değil, Form’un doğrulama listesinden gelir (`required`). checkbox’ın TEK doğrulama kuralı odur — panel boolean tipinin listesini çizer, desen/uzunluk kuralı yoktur.',
-            'Birden çok seçenek gerekiyorsa checkbox yığmak yerine checkboxgroup kullan: değeri string[] ve seç-tümü/sayaç onda hazır.'
+            'Birden çok seçenek gerekiyorsa checkbox yığmak yerine checkboxgroup kullan: değeri string[] ve seç-tümü/sayaç onda hazır.',
+            "required = kutu İŞARETLİ olmalı: işaretsiz (false) kutu boş sayılır ve 'zorunlu' hatası verir — onay/şart kabul kutusu için doğru kullanım. false meşru bir cevapsa required koyma (ölçüldü 2026-10-03)."
         ],
         propNotes: {
             labelPosition: "Etiketin kutuya göre yeri: 'right' (varsayılan, kutu solda) ya da 'left'. Kutu her iki yerleşimde de etikete yapışır; ayrı bir hizalama prop’u yoktur, satırın hizası düğümün appearance kanalından gelir.",
@@ -619,7 +624,8 @@ export const componentKnowledge = {
             'value akıştan METİN gelirse: "false" · "0" · "no" · "off" · "null" · "undefined" · "nan" · boş metin YANLIŞ sayılır, kalan dolu metin doğru (checkbox ile ortak normalizasyon). Yine de alana boolean yaz — sözleşme boolean’dır.',
             'Zorunluluk prop değil, Form’un doğrulama listesinden gelir (`required`). switch’in TEK doğrulama kuralı odur — panel boolean tipinin listesini çizer, desen/uzunluk kuralı yoktur.',
             'isIndeterminate YOKTUR ve bilerek eklenmedi: anahtar tanımı gereği ikili, "kısmen açık" diye bir durumu yok. Üçüncü durum gerekiyorsa checkbox kullan.',
-            'Anahtarın rengi TEMANIN vurgu renginden gelir; renk prop’u yoktur ve style düğümün KÖKÜNE yazılır (kolun kendisine ulaşmaz) — "yeşil anahtar" gibi bir istek tema ayarıdır, prop değil.'
+            'Anahtarın rengi TEMANIN vurgu renginden gelir; renk prop’u yoktur ve style düğümün KÖKÜNE yazılır (kolun kendisine ulaşmaz) — "yeşil anahtar" gibi bir istek tema ayarıdır, prop değil.',
+            "required = anahtar AÇIK olmalı: kapalı (false) anahtar boş sayılır ve 'zorunlu' hatası verir. Kapalı da meşru bir seçimse required koyma (ölçüldü 2026-10-03)."
         ],
         propNotes: {
             labelPosition: "Etiketin anahtara göre yeri: 'right' (varsayılan, anahtar solda) ya da 'left'. Anahtar her iki yerleşimde de etikete yapışır; yükleniyor spinner'ı kolla etiketin ARASINDA durur — 'right'ta kolun sağında, 'left'te satırın sonunda.",
@@ -749,7 +755,7 @@ export const componentKnowledge = {
     fileUpload: {
         summary: 'Sürükle-bırak yükleme ALANI (dropzone): büyük bir hedef kutu, tıklayınca da dosya penceresi açar, seçilenleri silinebilir çip listesi olarak gösterir ve görselleri kırpabilir. Tek satırlık alan için fileInput, düz buton için filebutton. Seçim self.value’dan okunur.',
         behavior: [
-            "Komponentin YAYDIĞI value her zaman DİZİDİR: [{ value: base64 data URL, fileName, type: 'file', ref: '' }]. isMultiple:false iken tek elemanlı dizi — nesne değil. Akış tek nesne ya da düz URL metni yazarsa da liste çizilir (2026-09-17'ye kadar hiç çizilmiyordu).",
+            "Komponentin change ile YAYDIĞI value her zaman DİZİDİR — isMultiple:false iken de tek elemanlı dizi, çip silinince []. Yeni seçilen dosya { type:'file', ref:'', fileName, value:<base64 data URL> } olur; akışın yazdığı kayıtlı dosyalar listede OLDUĞU GİBİ kalır. Akışın yazdığı değer change gelene kadar yazıldığı şekliyle durur (nesne yazdıysan value nesnedir). Kayıtlı dosyayı geri basmak için uç ya da workflow table get adımının döndüğü FILE değerini OLDUĞU GİBİ yaz — tekil alanda { type:'ref', value:<fileId>, fileName, absolute_path, … }, çoka-çok alanda bunun dizisi: her dosya ayrı çipte adıyla çizilir, dokunmadan kaydetmek dosyaları korur. Düz URL metni ya da dizisi YAZMA: çip aynı görünür ama kayıt bozulur — çoka-çok alanda 500 JsonException, tekil alanda dosya sessizce silinir, bir çip silinince kalan URL { type:'file', value:<URL> } olarak yayılır ve 500 FormatException verir (ölçüldü 2026-10-02).",
             'Çipe tıklamak o dosyayı listeden siler ve change olayını KALAN listeyle yayar; ayrı bir silme olayı yoktur. Kilitliyken (isDisabled/isReadonly/isViewmode) ne ekleme ne silme olur, sürükleme de tepki vermez.',
             'allowedFiletypes KAPALI bir uzantı listesidir: seçilmeyen uzantı dosya penceresinde de görünmez, sürüklenirse reddedilir ve komponentin içinde tür uyarısı çizilir. jpg ve jpeg AYRI satırdır — ikisini de kabul edeceksen ikisini de seç. Listede HİÇ olmayan bir uzantı için customFiletypes metin alanına yaz ("heic, p7m" — virgül/boşluk/noktalı virgül ayırır, baştaki . ve * atılır, küçük harfe iner); iki kaynak birleşir. İkisi de boşsa her tür serbesttir.',
             'maxFileSizeMb / maxFileCount yalnız kullanıcıya hızlı geri bildirimdir, sunucu tarafını bağlamaz. 0, negatif ya da boş değer SINIRSIZ demektir. Sınıra takılan dosya listeye girmez, geçenler girer (hepsi ya da hiçbiri değil); boyut ihlali adet ihlalinin önüne geçer. Adet sınırı çok seçimde zaten seçili dosyaları da sayar.',
@@ -758,7 +764,7 @@ export const componentKnowledge = {
             'Doğrulama: required ve pattern. isInvalid/invalidText Form’un merkezi hatasıdır; komponentin kendi tür ve sınır uyarıları ondan ayrı çizilir.'
         ],
         propNotes: {
-            value: "Panelde GİZLİ (.hide()): değeri elle yazmak yerine akıştan bağla ya da change'den sonra self.value ile oku. Akış dizi yerine tek nesne ya da düz URL metni yazarsa da çip çizilir (metinde ad son yol parçasından alınır).",
+            value: "Panelde GİZLİ (.hide()): akıştan bağla, change'den sonra self.value ile oku. Kayıtlı dosyayı forma basarken uç/workflow get adımının FILE değerini (type:'ref') OLDUĞU GİBİ yaz, düz URL yazma. TEKİL FILE alanına gönderirken diziyi açmak ZORUNLU — değer v ise Array.isArray(v) ? (v[0] || { type:'ref', value:null }) : v. Dizi gönderilirse tablo ucu 200 döner ama alanı sessizce NULL'lar: yeni dosya açılmaz, mevcut dosya da silinir. Yalnız v[0] da yetmez: dokunulmamış formda değer akışın yazdığı nesnedir. Çoka-çok alana değer olduğu gibi gider: X ile silinen dosya düşer, kalan type:'ref' kayıtları korunur, yeni dosyalar açılır (ölçüldü 2026-10-02). Tasarımda value'ya drive dosyası BAĞLAMA ({ type:'file', ref:<fileId> } — Studio panelinin dosya seçicisi de bunu yazar): çalışma anı değeri { type:'file', ref, data:<URL> } olur, çip dosya adı yerine URL yazar ve kullanıcı dokunmadan kaydederse backend type:'file' kaydında yalnız value'yu okuduğu için tekil alan sessizce NULL'lanır (200 döner, mevcut dosya silinir; NOT NULL alanda 400 InvalidParameterException). Varsayılan dosya gerekiyorsa value'yu static ref nesnesi olarak ver: { type:'static', data:{ type:'ref', value:'<fileId>', fileName, absolute_path } } — çip adıyla çizilir, dokunmadan kayıt dosyayı yazar (ölçüldü 2026-10-02).",
             customFiletypes: "allowedFiletypes listesinde HİÇ olmayan uzantılar için serbest metin: 'heic, p7m' (virgül/boşluk/noktalı virgül ayırır). İki kaynak birleşir; fileInput'taki aynı adlı prop'la aynı sözleşme.",
             size: "sm | md | lg — metin ve ikon ölçeğini değiştirir; boş bırakılırsa uygulamanın form boyutu geçerlidir (2026-09-17 öncesinde hiçbir etkisi yoktu).",
             isMultiple: 'Kapalıyken yeni seçim eskisinin YERİNE geçer, listeye eklenmez.',
@@ -776,7 +782,7 @@ export const componentKnowledge = {
             'isLoading prop’u YOKTUR ve bilinçlidir (CQ-215): bu dosya ailesinde yükleniyor sözcüğü alan kilidi mi yükleme ilerlemesi mi, karar verilmedi. Alanı dondurmak için isDisabled kullan.'
         ],
         propNotes: {
-            value: 'Tek dosyada { type, fileName, value } NESNESİ, isMultiple açıkken bu nesnelerin DİZİSİ; value base64 data URL’dir. Akıştan yazarken de aynı şekli yaz — okunamayan değer alanı BOŞ gösterir, hata vermez.',
+            value: "Tek dosyada NESNE, isMultiple açıkken nesnelerin DİZİSİ. Kullanıcının seçtiği YENİ dosya { type:'file', fileName, value:<base64 data URL> } olarak gelir ve uca böyle gider; çoklu kipte yeni seçim dizinin sonuna eklenir ve kayıtta yalnız o dosya açılır. Kayıtlı dosyayı forma geri basarken uç ya da workflow table get adımının döndüğü FILE değerini OLDUĞU GİBİ yaz — tekil alanda nesne ({ type:'ref', value:<fileId>, fileName, absolute_path, … }), çoka-çok alanda bu nesnelerin dizisi: kullanıcı dokunmadan kaydederse aynı değer uca gider, dosyalar referans olarak korunur, yeni dosya açılmaz; X ile silinen dosya gövdeden düşer. Tek dosyada çip adıyla çizilir; 2+ dosyada çip 'N dosya seçildi' yazar, adlar çipe tıklayınca açılan listededir. Kayıtlı dosyayı type:'file' ile (value'da URL ya da guid) YAZMA: ekranda fark görünmez ama backend value'yu base64 diye çözer ve kayıt 500 FormatException ile düşer. Asgari { type:'ref', value:<fileId> } kaydı geçirir ama tek dosya çipi 'undefined' yazar; fileName ve absolute_path da taşınmalı. row_get/row_list şekillerini uca geri yazma: tekil alanda düz guid ya da { id, display_name } tablo kaynaklı uçta alanı SESSİZCE NULL'lar (200; workflow table adımı bu ikisini doğru bağlar); çoka-çok alanda row_get/row_list'in [{ id, display_name }] dizisi uçta DA workflow table adımında DA bütün dosyaları sessizce siler, düz guid dizisi 500 JsonException verir. Boşaltmak için tekil alanda { type:'ref', value:null }, çoklu alanda [{ type:'ref', value:null }] ya da []. (ölçüldü 2026-10-02) Tasarımda value'ya drive dosyası BAĞLAMA ({ type:'file', ref:<fileId> } — Studio panelinin dosya seçicisi de bunu yazar): çalışma anı değeri { type:'file', ref, data:<URL> } olur, çip dosya adı yerine URL yazar ve kullanıcı dokunmadan kaydederse backend type:'file' kaydında yalnız value'yu okuduğu için tekil alan sessizce NULL'lanır (200 döner, mevcut dosya silinir; NOT NULL alanda 400 InvalidParameterException). Varsayılan dosya gerekiyorsa value'yu static ref nesnesi olarak ver: { type:'static', data:{ type:'ref', value:'<fileId>', fileName, absolute_path } } — çip adıyla çizilir, dokunmadan kayıt dosyayı yazar (ölçüldü 2026-10-02).",
             button_text: 'Gözat butonunun metni (varsayılan Browse); boşaltılırsa buton HİÇ çizilmez, görüntüleme ve salt okunur kiplerde de çizilmez. Adın snake_case olması kayıtlı sayfalar yüzündendir (ARC-085); buttonText yazmak unknown-prop verir.',
             placeholder: 'Dosya seçilmemişken gösterilen metin; boş bırakılırsa uygulama dilinde hazır metin yazar (Dosya seçiniz / Choose a file).',
             allowedFiletypes: 'Sabit listeden seçilen uzantılar (pdf, docx, doc, xlsx, xls, pptx, ppt, txt, csv, jpg, png, heic, zip…). Boş bırakmak her tür serbest demektir; listede olmayan uzantı için customFiletypes. Liste 2026-09-17’den beri bir ipucu değil gerçek bir ENGEL olduğu için her uzantı AYRI satırdır: jpg seçip jpeg seçmemek .jpeg dosyasını reddettirir, doc/docx ve xls/xlsx çiftleri de ayrıdır.',
@@ -795,7 +801,7 @@ export const componentKnowledge = {
             "Olaylar: mount ve change. mount'ı platform her düğüm için yayar ama bileşen bildirmediği sürece akışa bağlanamıyordu (2026-09-17'de bildirime eklendi)."
         ],
         propNotes: {
-            value: "Seçili dosya(lar). Panelde ÇİZİLİR ve akıştan yazılabilir (2026-09-17'ye kadar gizliydi, bu yüzden AI sözlüğünde de görünmüyordu): kayıtlı bir dosyayı forma geri basmanın yolu budur. Tekli kipte nesne, çoklu kipte dizi; boşaltmak için null (çoklu kipte []). Kipiyle uyuşmayan şekil de OKUNUR: çoklu kipte yazılan tek nesne listelenir, tekli kipte yazılan dizinin ilk dosyası çizilir (2026-09-17'ye kadar ikisi de sessizce hiçbir şey göstermiyordu). İçeriği olmayan kayıt (ne value ne data ne absolute_path) hiç çizilmez.",
+            value: "Seçili dosya(lar). Panelde ÇİZİLİR ve akıştan yazılabilir (2026-09-17'ye kadar gizliydi, bu yüzden AI sözlüğünde de görünmüyordu): kayıtlı bir dosyayı forma geri basmanın yolu budur. Tekli kipte nesne, çoklu kipte dizi; boşaltmak için null (çoklu kipte []). Kipiyle uyuşmayan şekil de OKUNUR: çoklu kipte yazılan tek nesne listelenir, tekli kipte yazılan dizinin ilk dosyası çizilir (2026-09-17'ye kadar ikisi de sessizce hiçbir şey göstermiyordu). İçeriği olmayan kayıt (ne value ne data ne absolute_path) hiç çizilmez. Tasarımda value'ya drive dosyası BAĞLAMA ({ type:'file', ref:<fileId> } — Studio panelinin dosya seçicisi de bunu yazar): çalışma anı değeri { type:'file', ref, data:<URL> } olur, çip dosya adı yerine URL yazar ve kullanıcı dokunmadan kaydederse backend type:'file' kaydında yalnız value'yu okuduğu için tekil alan sessizce NULL'lanır (200 döner, mevcut dosya silinir; NOT NULL alanda 400 InvalidParameterException). Varsayılan dosya gerekiyorsa value'yu static ref nesnesi olarak ver: { type:'static', data:{ type:'ref', value:'<fileId>', fileName, absolute_path } } — çip adıyla çizilir, dokunmadan kayıt dosyayı yazar (ölçüldü 2026-10-02).",
             text: 'Butonun üzerindeki metin (varsayılan "Attach File"); ikon sabittir. Alanın başlığı ayrı bir prop\'tur: label.',
             description: 'Butonun altındaki yardım metni. Dosya seçilir seçilmez yerini dosya listesi alır, seçim temizlenince geri gelir (fileInput ile aynı kural).',
             allowedFiletypes: 'İzin verilen uzantılar (çoklu seçim, kapalı liste). Hem dosya diyaloğunun accept süzgecini hem de seçimden SONRAKİ denetimi besler: liste dışı bir dosya seçilirse değere girmez ve komponentin içinde "desteklenmiyor" uyarısı çizilir (2026-09-17; öncesinde yalnız diyalog süzgeciydi, "Tüm dosyalar" ile aşılabiliyordu). Hem allowedFiletypes hem customFiletypes boşsa her tür serbesttir.',
@@ -1705,7 +1711,7 @@ export const componentKnowledge = {
     checkboxgroup: {
         summary: 'Değeri DİZİ olan çoklu kutu grubu (multi-select’in liste hâlinde açılmış hâli).',
         behavior: [
-            'Zorunluluk/en az-en çok seçim kuralları formun validations’ından gelir (required · minItems · maxItems).',
+            'Zorunluluk/en az-en çok seçim kuralları formun validations’ından gelir: required · min-length · max-length. Kayıt defteri (component_get.validations) iki sayı kuralını minItems/maxItems adıyla gösterir; gateway bunları min-length/max-length’e çevirir (backend ve runtime yalnız tireli adı tanır, Studio paneli de bu adla yazar). Form dizide uzunluk olarak SEÇİLİ ELEMAN SAYISINI ölçer.',
             "focus/blur GRUP düzeyindedir: kutular arasında Tab'lamak ayrı olay üretmez, yalnız grubun dışına çıkılınca/girilince bir kez yayılır (otpinput deseniyle aynı).",
             'DEĞER MODELİ düz bir string[]’dir, seçenek→boolean haritası DEĞİL: bir seçenek, değeri listede olduğu için işaretli görünür. Bu yüzden options içindeki value’lar BENZERSİZ olmalıdır — liste value ile anahtarlandığı için aynı value’yu iki seçeneğe vermek desteklenmez (geliştirme derlemesinde “duplicate keys” hatası fırlatır, üretimde liste bozulur).',
             'Seçenek listesinin TANIMADIĞI değerler korunur: tek tık da seç-tümü de listede karşılığı olmayan bir değeri silmez (sorguyla filtrelenmiş listede önceki seçimler kaybolmasın diye).',
@@ -1909,7 +1915,8 @@ export const componentKnowledge = {
         summary: 'Yıldız (ya da seçilen ikon) ile puanlama girişi.',
         behavior: [
             'Mevcut değere yeniden tıklamak puanı 0’a düşürür; allowHalf açıkken yıldızın sol yarısı yarım puan verir.',
-            "focus/blur yıldız GRUBUNUN tamamı için bir kez yayılır (kapsayıcıda focusin/focusout dinlenir), yıldız başına değil: yıldıza TIKLAMAK da alana girmek sayılır ve focus yayar, yıldızlar arasında gezinmek yeniden yaymaz, blur yalnız odak şeritten büsbütün çıkınca gelir. Kilitli (isDisabled/isReadonly/isViewmode) ya da yükleniyor alan hiçbir odak olayı yaymaz."
+            "focus/blur yıldız GRUBUNUN tamamı için bir kez yayılır (kapsayıcıda focusin/focusout dinlenir), yıldız başına değil: yıldıza TIKLAMAK da alana girmek sayılır ve focus yayar, yıldızlar arasında gezinmek yeniden yaymaz, blur yalnız odak şeritten büsbütün çıkınca gelir. Kilitli (isDisabled/isReadonly/isViewmode) ya da yükleniyor alan hiçbir odak olayı yaymaz.",
+            "required = en az bir yıldız: 0 puansız sayılır ve 'zorunlu' hatası verir (aynı yıldıza yeniden tık 0'a çeker) (ölçüldü 2026-10-03)."
         ],
         propNotes: {
             value: '0..max arası sayı; akıştan gelen değer bu aralığa kırpılır.',
@@ -1945,7 +1952,8 @@ export const componentKnowledge = {
         behavior: [
             'change sürüklerken sürekli, changed yalnız bırakıldığında yayılır — pahalı akışı changed’e bağla.',
             "focus/blur GRUP düzeyindedir (checkboxgroup/otpinput deseni): input'un kendisi değil dıştaki kapsayıcı dinler, tek giriş/çıkışta bir kez yayılır.",
-            'isReadonly/isViewmode/isLoading rayı değiştirilemez yapar ama alanı ODAKLANABİLİR bırakır (değer klavyeyle ve ekran okuyucuyla okunur) ve kilitli alan focus/blur/change YAYMAZ; native disabled ve “yasak” imleci yalnız isDisabled’dan gelir.'
+            'isReadonly/isViewmode/isLoading rayı değiştirilemez yapar ama alanı ODAKLANABİLİR bırakır (değer klavyeyle ve ekran okuyucuyla okunur) ve kilitli alan focus/blur/change YAYMAZ; native disabled ve “yasak” imleci yalnız isDisabled’dan gelir.',
+            "required 0'ı boş sayar: 0'a çekilmiş kaydırıcı 'zorunlu' hatası verir. 0 meşruysa required koyma; alt sınırı minValue ile ver (ölçüldü 2026-10-03)."
         ],
         propNotes: {
             value: 'Sayı; akıştan gelen değer [minValue, maxValue] aralığına kırpılır (0 geçerli sınırdır) ve adıma oturmuyorsa en yakın geçerli adımda GÖSTERİLİR (tutamağın gittiği yer) — akışa yazılan sayı bundan etkilenmez, ekrandaki ile aynı olması isteniyorsa adıma oturan bir değer yaz.',
@@ -1981,7 +1989,8 @@ export const componentKnowledge = {
             'value akıştan METİN gelirse: "false" · "0" · "no" · "off" · "null" · "undefined" · "nan" · boş metin YANLIŞ sayılır, kalan dolu metin doğru (checkbox/switch ile ortak normalizasyon, 2026-09-11). Yine de alana boolean yaz — sözleşme boolean’dır.',
             'Zorunluluk prop değil, Form’un doğrulama listesinden gelir (`required`) — switcher’ın TEK doğrulama kuralı odur. 2026-09-11’e kadar panel bu bileşen için hiç liste çizmiyordu (slug `ComponentValidationTypes` sözlüğünde yoktu), artık boolean tipinin listesi çiziliyor.',
             'Form içindeki switcher artık boolean bir alan olarak davranır: submit’te değeri boolean şemayla doğrulanır (önce metin tipine düşüyordu, yani kural yokken bile tip hatası veriyordu) ve formun Reset’i onu da başlangıç değerine döndürür (önce sıfırlamadan muaftı). 2026-09-11.',
-            'Vurgulu segmentin rengi TEMANIN vurgu renginden gelir; renk prop’u yoktur ve style düğümün KÖKÜNE yazılır (segmentlere ulaşmaz).'
+            'Vurgulu segmentin rengi TEMANIN vurgu renginden gelir; renk prop’u yoktur ve style düğümün KÖKÜNE yazılır (segmentlere ulaşmaz).',
+            "required false segmentini REDDEDER: false boş sayılır ve 'zorunlu' hatası verir. İki seçenek de meşruysa required KOYMA — switcher'ın değeri her zaman vardır (ölçüldü 2026-10-03)."
         ],
         propNotes: {
             label: 'Alanın adı, track’in üstünde. Boş bırakılırsa hiç çizilmez ve kontrolün ekran okuyucudaki adı iki segmentin metninden okunur — form içindeki switcher’a etiket yaz.',

package/dist/knowledge/componentEvents.js

@@ -158,7 +158,7 @@ export const componentEventContracts = {
             payload: {
                 value: "string (elle yazılan metin) YA DA { Prefix, Separator, Counter, DigitCount, FieldId } (sunucudan kod gelince: kodun METNİ DEĞİL, kodu üreten şekil)"
             },
-            reads: 'setter: self.value da yazılır. Elle yazarken HER TUŞTA, otomatik kod gelince bir kez yayılır — pahalı akışı changed’e bağla'
+            reads: 'setter: self.value da yazılır. Elle yazarken HER TUŞTA, otomatik kod gelince bir kez yayılır — pahalı akışı changed’e bağla. Yükte kodun METNİ yoktur; Counter başlangıç değeridir, kaydedilen numara değil — numarayı kayıttan dönen satırdan oku.'
         },
         changed: valueChange('string (alan bırakılınca kesinleşen metin; yalnız ELLE düzenlemede yayılır)'),
         focus: NO_DATA,
@@ -249,8 +249,8 @@ export const componentEventContracts = {
     },
     fileUpload: {
         change: {
-            payload: { value: "Array<{ value: base64 data URL, fileName: string, type: 'file', ref: '' }>" },
-            reads: 'self.value — dosya EKLENİNCE de SİLİNİNCE de (çipe tıklama) aynı olay yayılır ve yük her seferinde KALAN TÜM listedir, yalnız yeni dosyalar değil. isMultiple:false iken dizi tek elemanlıdır. Kilitliyken (isDisabled/isReadonly/isViewmode) hiç yayılmaz; tür/boyut/adet sınırına takılan dosya listeye girmez ve uyarı komponentin içinde çizilir, ama kabul KISMİDİR: geçen dosya varsa olay GEÇENLERLE yayılır, yalnız hepsi reddedilirse hiç yayılmaz. enableCrop açıkken görsel dosyalar kırpma katmanından geçtikten SONRA yayılır (İptal dosyayı düşürür; hepsi düşerse olay çalışmaz).'
+            payload: { value: "Array — her eleman: yeni seçimde { type:'file', ref:'', fileName, value:<base64 data URL> }; akışın yazdığı kayıtlı dosya AYNEN ({ type:'ref', value:<fileId>, fileName, absolute_path, … }); akış düz URL yazdıysa { type:'file', ref:'', fileName, value:<URL> } (kayıtta 500 FormatException)" },
+            reads: "self.value — dosya EKLENİNCE de SİLİNİNCE de (çipe tıklama) aynı olay yayılır ve yük her seferinde KALAN TÜM listedir, yalnız yeni dosyalar değil. isMultiple:false iken dizi tek elemanlıdır. Kilitliyken (isDisabled/isReadonly/isViewmode) hiç yayılmaz; tür/boyut/adet sınırına takılan dosya listeye girmez ve uyarı komponentin içinde çizilir, ama kabul KISMİDİR: geçen dosya varsa olay GEÇENLERLE yayılır, yalnız hepsi reddedilirse hiç yayılmaz. enableCrop açıkken görsel dosyalar kırpma katmanından geçtikten SONRA yayılır (İptal dosyayı düşürür; hepsi düşerse olay çalışmaz). Akışın yazdığı type:'ref' kayıtları yükte aynen kalır. isMultiple:false iken de dizidir (silmede []); tekil FILE alanına göndermeden önce ilk elemanı al (componentCatalog fileUpload.propNotes.value)."
         }
     },
     fileInput: {

package/dist/knowledge/normalize.js

@@ -456,7 +456,13 @@ const VALIDATION_TYPE_ALIASES = new Map([
     ...VALIDATION_CANONICAL_TYPES.map(type => [type.replace(/-/g, ''), type]),
     ['pattern', 'regex'],
     ['min', 'min-value'],
-    ['max', 'max-value']
+    ['max', 'max-value'],
+    // OR-2 (2026-10-03): kayıt defteri checkboxgroup/multi-select/tag-input kuralını minItems/maxItems
+    // adıyla ilan eder (component_get.validations); backend ValidationType'ta bu ad yok, runtime da tanımaz.
+    // Studio paneli bu üçüne 'custom' şablonundan min-length/max-length yazar (ng-apps-types
+    // validation/constants.ts) ve Form uzunluk kuralı dizide SEÇİLİ ELEMAN sayısını ölçer.
+    ['minitems', 'min-length'],
+    ['maxitems', 'max-length']
 ]);
 const VALIDATION_VALUE_REQUIRED = new Set(['regex', 'max-length', 'min-length', 'max-value', 'min-value', 'value-options']);
 function canonicalValidationType(value) {
@@ -650,6 +656,34 @@ export function styleKeyNote(fixed) {
             + 'değer kaydedilir ama hiç uygulanmaz ve tek işareti tarayıcı konsoludur (F-06). '
             + "Seçici anahtarlara ('&__body', ':hover', '--token') dokunulmadı."];
 }
+/**
+ * Y-15 — adı eksik, null ya da boş/boşluk olan düğüm runtime'ın ifade ön sözünü bozar: `getNodeNames`
+ * null adı `"null"` anahtarına çevirir, `runCode` `const null = Components["null"]` satırını üretir
+ * (`ng-apps-flow/src/flow-execution.functions.ts`) ve sayfadaki BÜTÜN ifadeler SyntaxError'la düşer;
+ * hata yalnız akış adımının runtimeErrors'ında görünür (ölçüldü 2026-10-03, `y15-adsiz`). Backend adı
+ * hiç denetlemez (`PageSchemaValidator.cs`); Studio her düğüme `name = elementId` yazar
+ * (`ScreenBuilderDroppable.svelte`). Kural deterministik olduğu için reddetmek yerine dolduruyoruz.
+ * Doldurulan ad da PAGE-009'dan geçmek zorunda: çağıran bunu denetimden ÖNCE koşar. Dolu ada dokunulmaz.
+ */
+export function fillComponentNames(nodes) {
+    const filled = [];
+    for (const node of asObjects(nodes)) {
+        const name = node.name;
+        const blank = name === undefined || name === null || (typeof name === 'string' && name.trim().length === 0);
+        if (blank && typeof node.elementId === 'string' && node.elementId.length > 0) {
+            node.name = node.elementId;
+            filled.push(node.elementId);
+        }
+        filled.push(...fillComponentNames(node.children));
+    }
+    return filled;
+}
+export function componentNameNote(filled) {
+    if (filled.length === 0)
+        return [];
+    const access = filled.length === 1 ? filled[0] : "her düğümün kendi elementId'si";
+    return [`${filled.map(id => `'${id}'`).join(', ')}: name eksikti, elementId'den yazıldı — ifadelerde ${access} ile erişilir (adsız düğüm runtime'da sayfadaki bütün ifadeleri düşürür, Y-15)`];
+}
 export function normalizeComponentDefaults(nodes) {
     const fixed = [];
     for (const node of asObjects(nodes)) {
@@ -708,6 +742,65 @@ export function normalizeComponentDefaults(nodes) {
     }
     return fixed;
 }
+export const COMPONENT_BODY_RULE = "Asgari gövde: { elementId, name (= elementId), type, props, blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }] }. "
+    + "Gateway blocks'u doldurmaz: blocks'u olmayan ya da null olan düğüm platformda kayıt sırasında 500 NullReferenceException verir. "
+    + "Boyutu component_get çıktısındaki sizes'tan al; flex kapta position yalnız sırayı belirtir (sırayı index ile de verebilirsin, blocks yine gövdede olur), "
+    + 'ızgara kapta x:0, y: kardeşlerin altı (en büyük y+h).';
+/**
+ * Y-13 / PAGE-037 — `blocks` alanı hiç olmayan ya da `null` olan düğümleri (çocuklar dahil) toplar.
+ * `DesignComponentManagementSchema.Blocks`'un varsayılanı yoktur; `ToDomain` null listeyi
+ * `AddBlocks(null)` ile atlar, `_blocks` başlatılmaz ve `Blocks` getter'ı kayıtta patlar
+ * (`DesignComponent.cs:36-37,305`; yeni düğümde revizyon yakalama `ToObject:464`, var olan düğümde
+ * `DesignComponentRepository.UpsertRange` → `Override`). Ölçüldü 2026-10-04: son 7 günde eklenen
+ * düğümlerin ~%20'si blocks'suz geldi ve hepsi 500 aldı. Konum ebeveynin düzenine bağlı olduğu için
+ * doldurmuyoruz, reddediyoruz. `blocks: []` platformda kaydolur (ölçüldü 2026-10-04, `y13-blocks`) ve buraya girmez.
+ */
+export function missingBlocksNodes(nodes) {
+    const missing = [];
+    for (const node of asObjects(nodes)) {
+        if (node.blocks === undefined || node.blocks === null) {
+            missing.push(`'${String(node.elementId ?? node.name ?? node.type ?? '?')}': blocks eksik — şunu ver: [{breakpoint:1024, size:{w,h}, position:{x,y}}]`);
+        }
+        missing.push(...missingBlocksNodes(node.children));
+    }
+    return missing;
+}
+/**
+ * PAGE-037 kimlik ayağı — platform elementId'siz add_component'i 'missing-id' ile reddeder
+ * (`PageSchemaMicroOpApplier.cs` add_component dalı) ama mesajı kimliğin hangi alan olduğunu
+ * söylemez. Ajanlar `name` verip elementId'yi atladı (Y-13 neden analizi N-B3, 5 düğüm).
+ */
+export function addComponentIdErrors(ops) {
+    const errors = [];
+    for (const op of asObjects(ops)) {
+        if (op.op !== 'add_component')
+            continue;
+        const component = op.component && typeof op.component === 'object' ? op.component : {};
+        const elementId = component.elementId;
+        if (typeof elementId === 'string' && elementId.trim() !== '')
+            continue;
+        const name = typeof component.name === 'string' && component.name.trim() !== '' ? component.name : undefined;
+        errors.push(`add_component: component.elementId yok (platform 'missing-id' ile reddeder) — kimlik elementId'dir; name ifade adıdır, ikisini aynı yaz${name ? ` (elementId: '${name}', name: '${name}')` : ''}`);
+    }
+    return errors;
+}
+/**
+ * PAGE-037. Yalnız çağıranın verdiği ağaca bakar: page_create'in eklediği page_container
+ * blocks'la üretilir, okunan kayıttaki düğümler (layout_patch) platformdan blocks listesiyle gelir.
+ * Sayfa/layout yazma kapısı (`assertScreenWriteGuards`), `page_schema_validate` ve
+ * `component_update` çağırır; `page_schema_patch` aynı denetimi op başına toplar.
+ */
+export function assertComponentBlocks(nodes) {
+    const missing = missingBlocksNodes(nodes);
+    if (missing.length === 0)
+        return;
+    throw new PlatformApiError(`PAGE-037 — komponent gövdesinde blocks yok (istek gönderilmedi): ${missing.join(' · ')}. ${COMPONENT_BODY_RULE}`, 400);
+}
+export function assertAddComponentIds(ops) {
+    const errors = addComponentIdErrors(ops);
+    if (errors.length > 0)
+        throw new PlatformApiError(`PAGE-037 — ${errors.join(' · ')} (istek gönderilmedi). ${COMPONENT_BODY_RULE}`, 400);
+}
 /**
  * add_component micro-op'unun taşıdığı komponent ağacı da aynı ToDomain yolundan geçer.
  */
@@ -804,6 +897,7 @@ export function normalizeSchemaOps(ops) {
     const components = [];
     const props = [];
     const validations = [];
+    const names = [];
     for (const op of asObjects(ops)) {
         if (op.op === 'replace_prop') {
             if (isStylePropName(String(op.prop ?? ''))) {
@@ -825,9 +919,10 @@ export function normalizeSchemaOps(ops) {
         }
         if (op.op !== 'add_component' || !op.component)
             continue;
+        names.push(...fillComponentNames([op.component]));
         components.push(...normalizeComponentDefaults([op.component]));
     }
-    return { components, props, validations };
+    return { components, props, validations, names };
 }
 export function validationNote(fixed) {
     return fixed.length === 0 ? [] : [`validation gövdeleri düzeltildi (${fixed.join(' · ')})`];
@@ -1800,7 +1895,7 @@ export function rootAddsNote(retargeted, containerElementId) {
 export function componentDefaultsNote(fixed) {
     if (fixed.length === 0)
         return [];
-    return [`komponent gövdelerine eksik zorunlu alanlar eklendi (${fixed.join(' · ')}): bunlar olmadan platform NullReferenceException verir ve page_schema_validate bunu yakalamaz`];
+    return [`komponent gövdelerine eksik varsayılan alanlar eklendi (${fixed.join(' · ')}): bunlar olmadan platform NullReferenceException verir ve page_schema_validate bunu yakalamaz. blocks eklenmez — gövdede olmalı (PAGE-037)`];
 }
 /**
  * Create yolu junction kaydını açar ama fiziksel tabloyu kurmaz (platform bug'ı P-01,

package/dist/platform/screenshot.js

@@ -81,6 +81,68 @@ export function actionScript(action) {
       var finish = function (result) { return result; };
 
     var combobox = node.querySelector('[role="combobox"], .ng-select__value-container, .ng-multiselect__value-container');
+
+    // SA-12 — autocomplete girdisi de role="combobox" taşır ama açılır kutu değildir: listesi yalnız
+    // input olayıyla açılır (tıklama hiçbir şey yapmaz), öneri satırı role="option" ve data-value
+    // TAŞIMAZ, seçim satırın mousedown'ındadır (Autocomplete.svelte on:mousedown|preventDefault;
+    // click ölçüldü, seçmedi). Dropdown yoluna girdiğinde 3 sn bekleyip "kutu devre dışı" diyordu.
+    // İstenen metin yazılır ve GÖRÜNEN METNİ eşleşen satıra mousedown atılır; value ile seçim yoktur.
+    var suggest = combobox && combobox.closest('.ng-autocomplete');
+    if (suggest) {
+      // Vurgu satırı [metin, ' ', <strong>, ' ', metin] düğümleriyle basılır (Svelte derleyicisi):
+      // textContent 'Ist anbul' olur. Yalnız-boşluk düğümleri atlanınca etiket geri gelir.
+      var labelOf = function (option) {
+        var label = option.querySelector('.ng-autocomplete__item-label');
+        if (label) return Array.prototype.map.call(label.childNodes, function (part) { return part.nodeType === 3 && !/\\S/.test(part.textContent) ? '' : part.textContent; }).join('').trim();
+        var caption = option.querySelector('.ng-autocomplete__item-caption');
+        var text = option.textContent || '';
+        return (caption ? text.replace(caption.textContent || '', '') : text).trim();
+      };
+      var same = function (left, right) { return left.replace(/\\s+/g, ' ').trim().toLowerCase() === right.replace(/\\s+/g, ' ').trim().toLowerCase(); };
+
+      Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set.call(combobox, wanted);
+      combobox.dispatchEvent(new Event('input', { bubbles: true }));
+
+      return new Promise(function (resolve) {
+        var waited = 0;
+        var step = 100;
+        var limit = 3000;
+
+        var attempt = function () {
+          var options = Array.prototype.slice.call(suggest.querySelectorAll('[role="option"]'));
+          var match = options.filter(function (option) { return same(labelOf(option), wanted); })[0];
+
+          if (match) {
+            match.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true }));
+            resolve(finish({ found: true, applied: true, matchedBy: 'text', optionsSeen: options.length, waitedMs: waited, requests: count }));
+            return;
+          }
+
+          if (waited >= limit) {
+            var empty = suggest.querySelector('.ng-autocomplete__empty');
+            var seen = options.slice(0, 10).map(labelOf).join(' · ');
+            var shown = options.length > 0
+              ? "görülen " + options.length + " öneri: " + seen
+              : empty
+                ? "liste: '" + (empty.textContent || '').trim() + "'"
+                : "öneri listesi hiç basılmadı — yazılan metin minChars eşiğinin altında ya da alan kilitli olabilir (page_runtime_get ile minChars/isDisabled/isReadonly)";
+            var result = { found: true, applied: false, waitedMs: waited, requests: count, note: "öneri listesinde '" + wanted + "' yok (" + waited + " ms) — " + shown + ". Yazılan metin ('" + wanted + "') alanda kaldı. Autocomplete yalnız görünen metinle seçer, value ile değil; öneriler bir sorgudan geliyorsa query_preview ile doğrulayın." };
+            // optionsSeen: 0 yazılmaz — page_screenshot sıfır seçenekli 'select' için açılır kutuya
+            // ait "devre dışı ya da salt okunur olabilir" notunu basar (tools/pages.ts emptyOptions);
+            // bu dalın nedeni yukarıdaki nottadır.
+            if (options.length > 0) result.optionsSeen = options.length;
+            resolve(finish(result));
+            return;
+          }
+
+          waited += step;
+          setTimeout(attempt, step);
+        };
+
+        attempt();
+      });
+    }
+
     if (combobox) {
       // Liste BU kutunun kabının içindedir. Sorgular belge kapsamlı kaldığında açık duran başka
       // bir kutunun (multiselect seçimden sonra kapanmıyor) seçeneğine tıklanabiliyordu ve adım
@@ -221,9 +283,12 @@ export function actionScript(action) {
     // Açılır kutu (dropdown / multi-select) NATIVE alan değildir: değeri yazmak hiçbir şey
     // yapmaz, seçeneğe TIKLANMASI gerekir. 'set' bu noktada 'select' fiiliyle AYNI yola girer —
     // iki kopya seçim mantığı tutulmaz.
+    //
+    // SA-12 — autocomplete girdisi de role="combobox" taşır ama serbest metin alanıdır: listesi
+    // tıklamayla değil input olayıyla açılır. Native yola düşer; öneri seçmek 'select'in işi.
 
     var combobox = node.querySelector('[role="combobox"], .ng-select__value-container, .ng-multiselect__value-container');
-    if (combobox) {
+    if (combobox && !combobox.closest('.ng-autocomplete')) {
       // Liste BU kutunun kabının içindedir. Sorgular belge kapsamlı kaldığında açık duran başka
       // bir kutunun (multiselect seçimden sonra kapanmıyor) seçeneğine tıklanabiliyordu ve adım
       // "uygulandı" diyordu; komşunun yükleme göstergesi de bu kutunun kararını blokluyordu (B-5).

package/dist/resources/guides/component.md

@@ -57,9 +57,9 @@ Doğrulama mesajını çeviriye bağlamak ayrı bir sözleşmedir (`t:` öneki,
 
 ## Olay modeli
 
-- Olay adları `component_get.events`'ten okunur, **`on` öneki almaz** (tek istisna
-  `texteditor`: onMount/onChange). Uydurma ada bağ sessizce ölü kalır — gateway PAGE-008 ile
-  reddeder.
+- Olay adları `component_get.events`'ten okunur, **`on` öneki almaz** (`texteditor` dahil:
+  `mount`/`change`/`changed`/`focus`/`blur`). Uydurma ada bağ sessizce ölü kalır — gateway
+  PAGE-008 ile reddeder.
 - Yük `events[].payload`'dadır ama akışa **`event.data` ile GELMEZ**: motor yükü komponentin
   KENDİ prop'una yazar (`FlowMachine.onEmit` → `setNode`) ve akışı emit'in `params`'ıyla başlatır.
   Yani `payload` anahtarları prop adlarıdır ve `self.<anahtar>` ile okunur (ya da

package/dist/resources/guides/entity.md

@@ -290,9 +290,11 @@ create step'inde aynı kural geçerlidir:
 "ticket_no": "TLP-0002"
 ```
 
-Girdi sınırları (`IncrementalCodeInput.TryParse`; ihlal edilirse nesne geçersiz sayılır ve kod
-üretilmez): `Prefix` ≤ 3 karakter · `Separator` ≤ 1 karakter · `Counter` ≥ 1 ·
-`DigitCount` 1–12.
+Girdi sınırları (`IncrementalCodeInput.TryParse`): `Prefix` ≤ 3 karakter · `Separator` ≤ 1
+karakter · `Counter` ≥ 1 · `DigitCount` 1–12. İhlal edilirse yazma 400
+`InvalidParameterException` ile düşer ve satır yazılmaz (`EntityService.ApplyIncrementalValuesAsync`;
+tablo kaynaklı uçta ölçüldü 2026-10-02). `row_next_code` bu sınırları DENETLEMEZ, aşan şekli de
+kodla döndürür. Nesnedeki `FieldId` yazılan alanın id'si olmalı, değilse aynı 400.
 
 - **Sayaç kendini onarır:** üretim var olan en yüksek koddan devam eder
   (`EntityIncrementSequenceService.ResolveStartingCounterAsync`), yani elle `TLP-0005` yazdıktan

package/dist/resources/guides/page.md

@@ -4,6 +4,17 @@ 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')`.
 
+**Asgari komponent gövdesi** — her yazma yolunda, her düğümde (çocuklar dahil); ayrıntı Kural 1:
+
+```jsonc
+{ "elementId": "btn_kaydet", "name": "btn_kaydet", "type": "button",
+  "props": { "text": { "type": "static", "data": "Kaydet" } },
+  "blocks": [{ "breakpoint": 1024, "size": { "w": 3, "h": 4 }, "position": { "x": 0, "y": 0 } }] }
+```
+
+`blocks` zorunlu, gateway doldurmaz (yoksa istek PAGE-037 ile reddedilir); `name` = `elementId`
+(ifadelerde `name` okunur). Flex kapta `position` yalnız sıradır, ızgarada gerçek hücredir.
+
 ## Kuruluş sırası
 
 ```
@@ -32,7 +43,7 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
 
 ```jsonc
 { "elementId": "page_header_1", "kind": "component", "type": "<component_list slug'ı>",
-  "name": "Page header",
+  "name": "page_header_1",
   "props":  { "pageTitle": { "type": "static", "data": "Branşlar" } },
   "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
   "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 0 } }],
@@ -74,6 +85,10 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   `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
+  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).
 - **Çoklu dilli metin için `type: 'translation'` + `ref: <çeviri anahtarı>`.** Runtime `data`'yı
   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_*`
@@ -119,20 +134,32 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   kaydırıldı (…)"` ile bildiriyor. Kökteki `modal`/`drawer` katmanları sayfa akışında durmadığı için
   hariç. Aynı hücreyi paylaşan komponentlerden hangisinin üstte kalacağı garanti değil — konumu sen
   doğru ver, düzeltme yalnız emniyet kemeri.
-- **Zorunlu alanlar:** `states` her yolda, `events` / `validations` / `stateBindings` ise
-  **micro-op yolunda** (`page_schema_patch`). `states` için sebep açık:
-  `DesignComponentManagementSchema.ToDomain:47` guard'sız okur, `Appearance`'ın varsayılanı var
-  `States`'in yok. Diğer üçünü `page_create` (POST /pages) tolere ediyor ama `PATCH …/schema`
-  etmiyor — canlı deneyde üçü **birlikte** verilince geçti, her biri **tek başına** verilince
-  `NullReferenceException` aldı. **Gateway hepsini senin yerine dolduruyor**
+- **Zorunlu alanlar:** `elementId`, `name`, `type` ve `blocks` her düğümde senin işin;
+  `blocks` (gateway doldurmaz) yoksa ya da `null`'sa platform kayıtta 500
+  `NullReferenceException` verir, gateway bu yüzden isteği göndermeden **PAGE-037** ile reddeder
+  (`blocks: []` reddedilmez). `name` = `elementId` yaz; boş bırakırsan gateway elementId'yi ad
+  olarak yazar ve bildirir (Y-15). `states` her yolda, `events` / `validations` /
+  `stateBindings` ise **micro-op yolunda** gerekir: `states`'i
+  `DesignComponentManagementSchema.ToDomain:47` guard'sız okur; diğer üçünü `page_create`
+  tolere ediyor ama `PATCH …/schema` onlarsız `NullReferenceException` alıyor (canlı deney).
+  **Bunları (ve `children`'ı) gateway senin yerine dolduruyor**
   (`page_create`/`page_update`/`page_schema_patch`, `layout_create/update`,
-  `component_create/update`) ve yanıtta `gatewayNormalized` ile bildiriyor; yani elle yazman
-  gerekmiyor, ama ham HTTP kullanıyorsan bu farkı bilmen gerekir.
-
-> **`page_schema_validate`'e tek başına güvenme.** `ValidatePageSchemaQuery` yalnız micro-op'ları
-> uygulayıp şema kurallarını denetler, `ToDomain`'e hiç girmez — eksik `states`'li bir gövdeye
-> `{"valid":true}` der, yazma yolu ise patlar. Gövde tamamlandığında ise doğrulayıcı işini
-> düzgün yapar (boyut/hedef hatalarını açık mesajla verir).
+  `component_create/update`) ve yanıtta `gatewayNormalized` ile bildiriyor — `blocks`'u değil.
+- **`blocks` tarifi (tek kural):** her düğüme
+  `[{ "breakpoint": 1024, "size": { "w", "h" }, "position": { "x", "y" } }]` ver; `size`'ı
+  `component_get` çıktısındaki `sizes`'tan al. Konumun anlamı **ebeveynin** `layout`'una bağlıdır:
+  - flex kap (`layout: 'flex'`): `position` yalnız sırayı belirtir (önce `y`, sonra `x`). Sırayı
+    `index` ile de verebilirsin — `page_schema_patch` kardeşlerin konumunu görünen sıraya göre
+    yeniden yazar (Kural 1f-2) — ama `blocks` yine gövdede olur.
+  - ızgara kap (`layout: 'grid'` ya da `layout` prop'u yok): `position` gerçek hücredir; sona
+    eklemek için `x: 0`, `y`: kardeşlerin en büyük `y + h` değeri. Aynı hücre üst üste biner.
+  - `blocks: []` kaydolur ama runtime 1024 bloğu bulamaz ve yerleşim sessizce bozulur — verme.
+
+> **`page_schema_validate`'in platform ayağına tek başına güvenme.** `ValidatePageSchemaQuery`
+> `ToDomain`'i koşar ama `NullReferenceException` kayıt adımında çıkar — eksik `states`'li ya da
+> `blocks`'suz bir gövdeye platform `{"valid":true}` der, yazma yolu ise patlar. Gateway eksik
+> varsayılanları kuru koşuda da doldurur, `blocks`'suz düğümü (PAGE-037) ve bozuk adı (PAGE-009)
+> yazmayla aynı biçimde reddeder.
 
 ## Kural 1b — `page_build` YOK
 
@@ -164,8 +191,8 @@ Yani "satırı seçince detay getir" (`select`), "kolondan süzünce sunucudan y
 yalnız `mount` yayar (bilinçli — Kural 1e); `page-header` 2026-09-18'den beri izdeki öğe
 tıklamasını `clickItem` olarak yayar (`component_get` yükü verir).
 
-**Olay adları `on` ÖNEKİ ALMAZ** (`button` → `click`, `form` → `submit`), tek istisna katalogda
-`texteditor`'dur (`onMount`/`onChange`). **Komponentin desteklemediği bir olay adı verirsen bağ
+**Olay adları `on` ÖNEKİ ALMAZ** (`button` → `click`, `form` → `submit`, `texteditor` → `change`);
+katalogda istisna yok. **Komponentin desteklemediği bir olay adı verirsen bağ
 sessizce ölü kalır** — önce `component_get`. Gateway `set_event`'i katalogla karşılaştırır ve
 uymayan adı **PAGE-008** ile istek gitmeden reddeder.
 
@@ -610,9 +637,9 @@ Runtime, ifade çalıştırmadan önce sayfadaki **her** komponent için bir de
 const <komponentin name'i> = Components["<komponentin name'i>"];
 ```
 
-`name` geçerli bir JS tanımlayıcısı değilse (boşluk, nokta, birden çok tire…) üretilen satır
-sözdizimi hatası olur ve **o sayfadaki BÜTÜN ifadeler** — condition kuralları, `value.type:'code'`
-ref'leri, `code` adımları — tek seferde ölür:
+`name` geçerli bir JS tanımlayıcısı değilse (boşluk, nokta, birden çok tire…) ya da hiç yoksa
+üretilen satır sözdizimi hatası olur ve **o sayfadaki BÜTÜN ifadeler** — condition kuralları,
+`value.type:'code'` ref'leri, `code` adımları — tek seferde ölür:
 
 ```
 Expression error: Missing initializer in const declaration in <senin ifaden>
@@ -624,7 +651,12 @@ dönüyor, condition patlıyor, kullanıcı yönlenmiyordu.
 
 **Kural:** `name` **her zaman `elementId` ile aynı** olsun (`btn_login`, `tbl_mng`). Okunabilir
 Türkçe başlık `props.title` / `props.text` / `props.label` / `props.pageTitle` içine yazılır —
-`name` bir etiket değil, **değişken adıdır**.
+`name` bir etiket değil, **değişken adıdır**. Gateway eksik/boş adı elementId'den doldurur ve
+bildirir; yine de adı açıkça elementId ile aynı yaz.
+
+**Tire:** runtime addan yalnız **ilk** tireyi siler (`name.replace('-', '')`) ve PAGE-009 da aynı
+dönüşümle denetler: `a-b` geçer (`ab` olur), `a-b-c` reddedilir (`ab-c` tanımlayıcı değildir).
+Tire yerine `_` kullan.
 
 > **Layout adları her sayfaya sızar.** Layout'un komponentleri de aynı `const` listesine girer;
 > layout'ta tek bir bozuk ad, o layout'a bağlı **her** sayfayı öldürür. `layout_update` yaparken de
@@ -635,7 +667,9 @@ Türkçe başlık `props.title` / `props.text` / `props.label` / `props.pageTitl
 >
 > Gateway bunu **PAGE-009** ile HER sayfa ve layout yazma yolunda istek gitmeden reddeder:
 > `page_create`, `page_update(schema)`, `add_component` (sayfa, `layout_schema_patch` ve
-> `component_schema_patch` yamalarında), `layout_create`, `layout_update(views)` ve `layout_patch`.
+> `component_schema_patch` yamalarında), `layout_create`, `layout_update(views)` ve `layout_patch`;
+> `page_schema_validate` aynı kararı verir. Ad doldurulduktan sonra denetlenir: geçersiz bir
+> elementId adsız gelirse o da reddedilir.
 
 ## Kural 1d — Sayfa iskeleti: `page_container` ve boyutlandırma
 
@@ -856,10 +890,10 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
 > (`page_container` böyledir ve öyle kalmalı). Sadece "başlık/çerçeve çizilmesin" diye wrapper
 > 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).
+> 2026-09-09'da şemadan kaldırıldı — bileşen onları hiçbir zaman okumuyordu, no-op'tu. Yanlış
+> `isWrapper`'ı düğümü silmeden düzelt: `resize_component { target, states: { isWrapper: false } }`
+> (platforma `set_states` olarak gider). `remove_component` + `add_component` ona yazan akış
+> setter'larını öldürür (`FLOW-018`).
 
 Mobil not: <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.
@@ -884,7 +918,8 @@ aynı prop grubunu o da alır. Grup katalogda tanımlıdır, yani şemadan kurul
 
 **`form` da bu grubun tamamını taşır (2026-09-01):** varsayılanları container ile aynı
 (`flex` · `row` · `left` · `top` · `shrink` · `medium` · `wrap` açık). "Form'a layout yazılmaz"
-eski bilgidir. (Platform kataloğu güncel şemayı `component_get`'te göstermiyorsa kayıt
+eski bilgidir. Ama varsayılan düğüme yazılmaz (aşağıda): `layout`'u açıkça yazmadığın form
+ızgara çizilir ve çocukları ızgara koordinatıyla dizilir. (Platform kataloğu güncel şemayı `component_get`'te göstermiyorsa kayıt
 yenilenmemiştir — ARC-024.)
 
 `stretch` iki eksende farklı anlama gelir: **ana** eksende `space-between` (çocukları uçlara
@@ -927,13 +962,17 @@ 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:
+   **Dizi sırası çizimi belirlemez** — `children[]` içindeki yer değil `y` kazanır; iki çocuğa
+   aynı `y`'yi verme (ölçümde eşit `y`'li iki çocuk dizi sırasının tersine çizildi, sıra garanti
+   değil). 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`
+   `{ "op": "add_component", "parent": "<flex kap>", "index": 0, "component": { … } }` —
+   `component` yine tam gövdedir, `blocks` dahil (verdiğin `position`'ı gateway sıraya göre yeniden
+   yazar; koordinat hesaplamak gerekmez ama `blocks`'suz gövde PAGE-037 ile reddedilir),
+   `remove_component` + `add_component` hiç gerekmez. Bu çeviriyi yalnız `page_schema_patch` yapar;
+   `layout_schema_patch` ve `component_schema_patch`'te sırayı `position.y` verir. **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.
@@ -983,12 +1022,13 @@ gibi bitişik duracak elemanlar için ÜÇ şart birden gerekir; biri eksikse ar
 
 ```jsonc
 // Bitişik rozet dizisi: kap + iki çocuktan biri (diğeri aynı desen)
-{ "elementId": "badge_row", "type": "container", "kind": "component",
+{ "elementId": "badge_row", "name": "badge_row", "type": "container", "kind": "component",
   "props": { "layout": { "type": "static", "data": "flex" },
              "direction": { "type": "static", "data": "row" },
              "gap": { "type": "static", "data": "none" } },
+  "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 4 }, "position": { "x": 0, "y": 0 } }],
   "children": [
-    { "elementId": "badge_1", "type": "button", "kind": "component",
+    { "elementId": "badge_1", "name": "badge_1", "type": "button", "kind": "component",
       "appearance": { "widthType": "auto", "marginType": "none", "heightType": "auto" },
       "blocks": [{ "breakpoint": 1024, "size": { "w": 2, "h": 4 }, "position": { "x": 0, "y": 0 } }] }
   ] }
@@ -1056,6 +1096,10 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 > `{ background:'transparent', border:'none', '&__body': { padding:'0px' } }`.
 > `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.
+>
+> **Zorunlu alanı gizli kaba SARMA:** form, yalnız alanın KENDİ `isHidden`'ını muaf tutar. Sarmalayıcı
+> kap gizliyken içindeki `required` alan doğrulanmaya devam eder, ekranda görünmeyen hatayla gönderimi
+> kilitler (ölçüldü 2026-10-03). Alanın kendi `isHidden`'ı varsa koşulu ona ver; yoksa alanı zorunlu yapma.
 
 > **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
@@ -1472,9 +1516,9 @@ boş görünür**; kayıt tarafında hiçbir hata çıkmaz (kütüphane turu R1)
 
 ```jsonc
 "views": [
-  { "elementId": "app_header", "kind": "component", "type": "header", "props": { … },
+  { "elementId": "app_header", "name": "app_header", "kind": "component", "type": "header", "props": { … },
     "blocks": [{ "breakpoint": 1024, "size": { "h": 8, "w": 12 }, "position": { "x": 0, "y": 0 } }] },
-  { "elementId": "content_slot", "kind": "component", "type": "slot", "name": "İçerik",
+  { "elementId": "content_slot", "kind": "component", "type": "slot", "name": "content_slot",
     "props": {}, "blocks": [{ "breakpoint": 1024, "size": { "h": 80, "w": 12 }, "position": { "x": 0, "y": 8 } }] }
 ]
 ```
@@ -1861,7 +1905,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
 | İki durumlu | `checkbox` · `switch` · `switcher` (iki durum yan yana) |
 | Puan / kod girişi | `rating` · `otpinput` |
 | Tarih / saat / aralık | `datepicker` · `datetimepicker` · `daterangepicker` · `datetimerangepicker` · `timepicker` (yalnız HH:mm) |
-| Kimlik alanları | `email` · `password` |
+| 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` |
 | Liste | `table` · `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) |
@@ -1870,7 +1914,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
 | İmza / CSV içe aktarma | `signature` (değer PNG data-URL ya da ham SVG; `change` setter'lı) · `importwizard` (3 adımlı sihirbaz; temiz+hatalı satırlar `complete` yükünde — satırları uca yazmak akışın işidir) |
 | Sayfalama (tablo dışı listeler için) | `pagination` — offset/limit yazar, `self.offset`/`self.limit` ile sorguya bağlanır |
 | Grafik / KPI | `chart` (ECharts: bar·line·area·pie·donut + waterfall/histogram/pareto/bullet/tornado/radial) · `statcard` (tek KPI + trend + sparkline) · `progress` |
-| Kapsayıcı / düzen | `container` (ızgara ya da flex — Kural 1f-2) · `form` (düzen prop'u YOK, çocuklar ızgara koordinatıyla dizilir) · `tabs` · `collapsible-container` · `accordion` |
+| Kapsayıcı / düzen | `container` (ızgara ya da flex — Kural 1f-2) · `form` (container ile aynı düzen prop'ları; `layout` yazılmazsa ızgara — Kural 1f-2) · `tabs` · `collapsible-container` · `accordion` |
 | Kart görünümü | `card` — **kapsayıcı DEĞİLDİR**, çocuk kabul etmez (`not-droppable`) ve yüksekliği 10-50 aralığındadır. Kutu içinde serbest içerik için `container` kullan. |
 | Katman | `modal` · `drawer` (şema kökünde — Kural 1d) |
 | Geri bildirim | `notification` (sayfa içi kutu) · `toast` (geçici bildirim; isOpen yükselen kenarı) · `form-validation-errors` · `confirm-bar` · `result` (işlem sonucu ekranı) · `emptystate` (boş liste; ikon YA DA görsel + aksiyon düğmeleri) |

package/dist/tools/components.js

@@ -1,5 +1,5 @@
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
-import { normalizeComponentDefaults, componentDefaultsNote, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, withNormalization } from '../knowledge/normalize.js';
+import { normalizeComponentDefaults, componentDefaultsNote, assertComponentBlocks, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, withNormalization } from '../knowledge/normalize.js';
 import { eventContractsFor, eventPayloadNote } from '../knowledge/componentEvents.js';
 import { componentPresetDefaults, readProjectTheme } from '../knowledge/themeSchema.js';
 import { knowledgeFor, knowledgeNote, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
@@ -270,6 +270,10 @@ export function registerComponentTools(server, platform) {
         },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, slug, ...changes }) => {
+        // PAGE-037: UpdateComponentCommand de UpsertRange'ten geçer, blocks'suz widget düğümü kayıtta
+        // 500 verir. component_create bu kapıdan geçmez — CreateComponentCommand revizyon kapsamı
+        // açmıyor ve platform orada blocks'suz düğümü blocks: [] gibi kaydediyor (2026-10-04, kod okuması).
+        assertComponentBlocks(changes.schema);
         const components = await listComponents(platform, project, environment, applicationId);
         const current = components.find(entry => entry.slug === slug);
         if (!current) {

package/dist/tools/designSchemaPatch.js

@@ -1,4 +1,4 @@
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, normalizeSchemaOps, validationNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, normalizeSchemaOps, assertAddComponentIds, validationNote, componentNameNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
 import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, removeNodeFromTree, planEventRemovals, planResizes, planPropTypes, assertOpBodies } from './schemaOps.js';
 import { guid, projectParam, environmentParam, updates, microOps } from './common.js';
 import { fetchHost, hostPath } from './screens.js';
@@ -61,6 +61,7 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         const opRecords = allOps.filter(entry => !['remove_event', 'resize_component', 'set_prop_type'].includes(String(entry.op)));
         const normalized = normalizeSchemaOps(opRecords);
         assertOpBodies(opRecords, propTypeOps);
+        assertAddComponentIds(opRecords);
         const record = await fetchHost(platform, host, project, environment, applicationId, id);
         // Platform ucu kaydın türüne bakmaz: sıradan bir komponentin id'si verilirse kataloğundaki
         // tanımın yanına bir şema yazılırdı.
@@ -155,6 +156,7 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
             }
         }
         return withWriteDiff(withNormalization(response, [
+            ...componentNameNote(normalized.names),
             ...sectionNotes,
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),

package/dist/tools/layouts.js

@@ -2,7 +2,7 @@ import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, u
 import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
-import { normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
+import { fillComponentNames, componentNameNote, normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
 import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode } from './screens.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
 import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../knowledge/propTypes.js';
@@ -12,7 +12,7 @@ import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
     .describe("JSON Patch listesi (RFC 6902): { op, path, value }. Yol seçici alabilir — '/views/0/children[elementId=baslik]/props/content/data'.");
-const viewsParam = schemaParam.describe("Layout'un komponent ağacı. DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2).");
+const viewsParam = schemaParam.describe("Layout'un komponent ağacı: her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2).");
 function countSlots(nodes) {
     if (!Array.isArray(nodes))
         return 0;
@@ -90,6 +90,7 @@ export function registerLayoutTools(server, platform) {
         },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, name, views, events, parameters }) => {
+        const named = fillComponentNames(views);
         assertScreenWriteGuards('layout', { schema: views, events });
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, views);
@@ -99,7 +100,7 @@ export function registerLayoutTools(server, platform) {
             body: { name, views: views ?? [], events: events ?? [], parameters: parameters ?? null }
         });
         const drops = writeDiff({ name, views: views ?? [], events: events ?? [] }, response);
-        const normalized = withWriteDiff(withNormalization(response, [...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(views)]), drops);
+        const normalized = withWriteDiff(withNormalization(response, [...componentNameNote(named), ...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(views)]), drops);
         if (gaps.length === 0 || !normalized || typeof normalized !== 'object')
             return normalized;
         return { ...normalized, layoutWarnings: gaps };
@@ -120,6 +121,7 @@ export function registerLayoutTools(server, platform) {
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, ...changes }) => {
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
+        const named = fillComponentNames(overrides.views);
         assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events });
         const current = await fetchHost(platform, 'layout', project, environment, applicationId, id);
         const fixed = normalizeComponentDefaults(overrides.views);
@@ -130,7 +132,7 @@ export function registerLayoutTools(server, platform) {
         const summary = { id, changed: Object.keys(overrides), preserved: { viewNodes: body.views.length } };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
-        return withNormalization(summary, [...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(body.views)]);
+        return withNormalization(summary, [...componentNameNote(named), ...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(body.views)]);
     }));
     server.registerTool('layout_patch', {
         title: "Layout'a patch uygula",
@@ -180,6 +182,7 @@ export function registerLayoutTools(server, platform) {
         const overrides = Object.fromEntries(['name', 'views', 'events', 'parameters']
             .filter(key => patched[key] !== undefined)
             .map(key => [key, patched[key]]));
+        const named = fillComponentNames(overrides.views);
         assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events });
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.views);
@@ -206,6 +209,7 @@ export function registerLayoutTools(server, platform) {
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
         return withNormalization(summary, [
+            ...componentNameNote(named),
             ...componentDefaultsNote(fixed),
             ...catalogNotes,
             ...slotWarning(body.views),

package/dist/tools/pages.js

@@ -1,9 +1,9 @@
 import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps, isBranchName } from './common.js';
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, fillComponentNames, componentNameNote, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, addComponentIdErrors, missingBlocksNodes, assertAddComponentIds, assertComponentBlocks, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
 import { functionSignature } from '../knowledge/functionGuards.js';
 import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath } from './screens.js';
 import { fetchComponentEventNames } from './components.js';
-import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
+import { assertComponentNames, assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
 import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
 import { formBindingWarnings, formSubmitButtonWarnings } from '../knowledge/coverage.js';
 import { emptyWriteDiff, schemaOpDrops, unwrapProps, withWriteDiff, writeDiff } from '../platform/writeDiff.js';
@@ -229,7 +229,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 to: z.string().min(1).optional().describe("Yalnız 'drag': bırakma hedefinin elementId'si — kanban kolonu '<elementId>__col-<value>', takvim günü '<elementId>__day-<yyyy-MM-dd>', tüm gün hücresi '<elementId>__allday-<yyyy-MM-dd>', saat dilimi '<elementId>__slot-<yyyy-MM-dd>T<HH>'"),
                 value: z.unknown().optional().describe("'set' için yazılacak değer. Tarih kutularına ISO yazın ('2026-08-01'); çok alanlı tarih aralığında kök DEĞİL kutu hedeflenir: '<elementId>__start' / '<elementId>__end'. 'tab' için sekmenin ANAHTARI ('iot') ya da görünen metni; 'select' için seçeneğin value'su ya da görünen metni"),
                 ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi")
-            })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
+            })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. Autocomplete'te 'set' metni alana yazar, 'select' metni yazıp öneri satırını GÖRÜNEN METİNLE seçer (value ile değil; eşleşme yoksa yazılan metin alanda kalır ve note bunu söyler). 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
             language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı."),
             colorScheme: z.enum(['light', 'dark']).optional().describe("Kareyi açık ya da koyu temada çeker. Ziyaretçi tema tercihi çerezde değil localStorage'da yaşar ve tema store'u onu sayfa açılırken bir kez okur; gateway tercihi sayfa script'lerinden ÖNCE eker, bu yüzden sayfada 'theme-toggle' komponenti OLMASA DA koyu tema karesi alınabilir. Verilmezse projenin kendi modu çizilir."),
             format: z.enum(['png', 'jpeg']).optional().describe("Kare biçimi; varsayılan 'png'. Doğrulama karesi için 'jpeg' + quality 60 bağlamı küçültür (ölçüldü 2026-09-16, aynı sayfa: scale 1'de png 8639 B / jpeg60 8691 B — kazanç yok; scale 0.5'te png 3603 B / jpeg60 3035 B). Asıl kaldıraç ÖLÇEKTİR; renk ve kenar keskinliğinin kendisi inceleniyorsa png'de kalın."),
@@ -570,11 +570,19 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         // op'larına çevrilir, platform dokunulan düğümleri aynı kapsamla doğrular.
         const opRecords = allOps.filter(entry => entry.op !== 'resize_component');
         const normalized = normalizeSchemaOps(opRecords);
+        const added = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component).filter(Boolean);
+        // page_schema_patch'in sırası: kimlik ve blocks op başına (PAGE-037), sonra ad (PAGE-009).
+        assertAddComponentIds(opRecords);
+        assertComponentBlocks(added);
+        assertComponentNames('page', added);
         const validationIssues = [
             ...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
             ...codePropTemplateErrors(opRecords).map(issue => `PAGE-032 — ${issue}`)
         ];
         const ordering = await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId));
+        // Yazmadaki gibi katalog kuralları GİDEN listeye: kuru koşu kırpılmamış boyutu doğrulayıp
+        // yazmanın geçireceği gövdeye hata veriyor, notu da vermiyordu (Y-13 C).
+        const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, ordering.ops.filter(entry => entry.op === 'add_component').map(entry => entry.component));
         const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
             environment,
             body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
@@ -584,8 +592,10 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         if (ordering.warnings.length > 0)
             response.layoutWarnings = ordering.warnings;
         return withNormalization(response, [
+            ...componentNameNote(normalized.names),
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),
+            ...catalogNotes,
             ...replacePropNote(normalized.props),
             ...flexIndexOrderNote(ordering.moved)
         ]);
@@ -655,6 +665,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             reject('PAGE-016', entry, schemaOpValidationErrors([entry]));
         for (const entry of opRecords)
             reject('PAGE-032', entry, codePropTemplateErrors([entry]));
+        for (const entry of opRecords)
+            reject('PAGE-037', entry, [...addComponentIdErrors([entry]), ...(entry.op === 'add_component' ? missingBlocksNodes([entry.component]) : [])]);
         if (opRecords.some(entry => entry.op === 'set_event' || entry.op === 'add_event')) {
             const typesByElementId = new Map();
             try {
@@ -701,7 +713,10 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 throw new PlatformApiError(orphanedFlowMessage(deletedFlows), 400);
             }
         }
-        const added = opRecords
+        // Katalog kuralları platforma GİDEN listeye uygulanır: index'li yamada `flexIndexOrder` op'ları
+        // kopyalar; kırpma ve heightType opRecords'a yazılınca gövdeye girmiyor, not yine "düzeltildi"
+        // diyordu (Y-13 C, ölçüldü 2026-10-03: s_all index:0 ile h:2 ve appearance'sız gitti).
+        const added = sentOps
             .filter(entry => entry.op === 'add_component')
             .map(entry => entry.component);
         assertScreenWriteGuards('page', { schema: added });
@@ -816,6 +831,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         }
         return withWriteDiff(withNormalization(response, [
             ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
+            ...componentNameNote(normalized.names),
             ...sectionNotes,
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),
@@ -860,6 +876,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, events, schema, view, ifExists }) => {
         const container = ensurePageContainer(schema ?? []);
+        const named = fillComponentNames(container.schema);
         assertScreenWriteGuards('page', { schema: container.schema, events });
         const stringStyles = stringStyleNodes(container.schema);
         const fixed = normalizeComponentDefaults(container.schema);
@@ -905,7 +922,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             };
             if (updateWarnings.length > 0)
                 summary.layoutWarnings = updateWarnings;
-            return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
+            return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
         }
         const response = await platform.tenant('POST', project, `/pages/${applicationId}`, {
             environment,
@@ -933,7 +950,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         if (view !== 'full' && Array.isArray(saved.schema)) {
             saved.schema = saved.schema.map(node => summarize(node));
         }
-        const normalized = withWriteDiff(withNormalization(withOutcome(response, undefined), [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]), drops);
+        const normalized = withWriteDiff(withNormalization(withOutcome(response, undefined), [...container.fixes, ...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]), drops);
         const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')];
         if (createWarnings.length === 0 || !normalized || typeof normalized !== 'object')
             return normalized;
@@ -955,11 +972,12 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             roleIds: z.array(guid).optional(),
             middlewareIds: z.array(guid).optional(),
             events: eventsParam.optional(),
-            schema: schemaParam.optional().describe('Nadiren gerekir; verilmezse mevcut şema korunur')
+            schema: schemaParam.optional().describe('Nadiren gerekir; verilirse her düğümde elementId, name (= elementId), type, blocks zorunlu (PAGE-037, gateway blocks doldurmaz); verilmezse mevcut şema korunur')
         },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, pageId, ...changes }) => {
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
+        const named = fillComponentNames(overrides.schema);
         assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events });
         const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
         const fixed = normalizeComponentDefaults(overrides.schema);
@@ -978,7 +996,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
-        return withNormalization(summary, [...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
+        return withNormalization(summary, [...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
     }));
     server.registerTool('page_clone', {
         title: 'Sayfa klonla',

package/dist/tools/schemaOps.js

@@ -1,4 +1,4 @@
-import { isFlexContainer, schemaOpValidationErrors, FLEX_LAYOUT_PROP_NAMES, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+import { isFlexContainer, schemaOpValidationErrors, FLEX_LAYOUT_PROP_NAMES, PAGE_CONTAINER_ELEMENT_ID, COMPONENT_BODY_RULE } from '../knowledge/normalize.js';
 import { findNode, outlineAppliedPatch } from './screens.js';
 import { setPropTypeErrors } from '../knowledge/propTypes.js';
 import { PlatformApiError } from '../platform/errors.js';
@@ -24,7 +24,7 @@ export function outlineWriteResponse(response) {
     if (Array.isArray(container.appliedPatch))
         container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
 }
-export const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component} | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akış iki kez 422 duplicate-event. Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
+export const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component: {elementId, name (= elementId), type, props, blocks: [{breakpoint: 1024, size: {w,h}, position: {x,y}}]}} (blocks ZORUNLU, gateway doldurmaz — blocks'suz ya da null blocks'lu düğüm istek gitmeden PAGE-037 ile reddedilir, platform onu kayıtta 500 NullReferenceException ile düşürürdü; flex kapta position yalnız sıradır; ifadede name okunur, elementId değil) | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akış iki kez 422 duplicate-event. Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir, blocks yine zorunlu; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
 /**
  * PAGE-008 — `set_event` uydurma bir olay adıyla 200 döner ve bağ SESSİZCE ölü kalır: motor olayı
  * komponentin yaydığı adla eşleştirir, eşleşme yoksa akış hiç çalışmaz. Kontrol yalnız hedefin
@@ -58,7 +58,8 @@ export function rejectedOpsMessage(unordered) {
     const validationHint = rejected.some(entry => entry.code === 'PAGE-016')
         ? " PAGE-016 çalışan biçimi dört alanı da taşır: { type: 'required'|'email'|'regex'|'max-length'|'min-length'|'max-value'|'min-value'|'value-options', message: '<kullanıcıya görünen metin>', value: <eşik/desen/true>, isActive: true }."
         : '';
-    return `Ön kontrol ${rejected.length} op'u reddetti; yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi). Düşen op'ları düzeltip TÜM listeyi tek çağrıda yeniden gönderin.${validationHint}\n${lines.join('\n')}\nrejectedOps: ${JSON.stringify(rejected)}`;
+    const bodyHint = rejected.some(entry => entry.code === 'PAGE-037') ? ` PAGE-037 ${COMPONENT_BODY_RULE}` : '';
+    return `Ön kontrol ${rejected.length} op'u reddetti; yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi). Düşen op'ları düzeltip TÜM listeyi tek çağrıda yeniden gönderin.${validationHint}${bodyHint}\n${lines.join('\n')}\nrejectedOps: ${JSON.stringify(rejected)}`;
 }
 export function collectTypes(nodes, into) {
     for (const node of nodes ?? []) {

package/dist/tools/screenWrite.js

@@ -1,4 +1,4 @@
-import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote } from '../knowledge/normalize.js';
+import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, assertComponentBlocks, blockSizeNote, heightTypeNote, sizeStringNote } from '../knowledge/normalize.js';
 import { FUNCTIONS_NAMESPACE } from '../knowledge/functionGuards.js';
 import { applyCatalogLayoutRules } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
@@ -10,15 +10,24 @@ const GUARD_CODES = {
 /**
  * JS tanımlayıcısı olmayan ya da AYRILMIŞ `name` alanlarını toplar; ad
  * `const <ad> = Components["<ad>"]` üretimine girer.
+ *
+ * Anahtar runtime'daki gibi hesaplanır: `runCode` addan yalnız İLK tireyi siler
+ * (`key.replace('-', '')`, `ng-apps-flow/src/flow-execution.functions.ts`). 2026-10-03'e kadar burada
+ * bütün tireler siliniyordu (`/-/g`); `a-b-c` denetimden geçti ve sayfadaki bütün ifadeleri
+ * düşürdü (Y-15, ölçüldü: `y15-cift-tire`).
  */
 export function invalidComponentNames(nodes) {
     const found = [];
     for (const node of nodes ?? []) {
         const name = node.name;
-        if (typeof name === 'string' && name.length > 0 && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name.replace(/-/g, ''))) {
-            found.push(`'${name}' (${node.elementId ?? '?'})`);
+        const key = typeof name === 'string' ? name.replace('-', '') : '';
+        if (typeof name === 'string' && name.length > 0 && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {
+            const dashes = key.includes('-')
+                ? ` — runtime addan yalnız ilk tireyi siler, kalan '${key}' JS tanımlayıcısı değil; tire yerine _ kullan ('${name.replace(/-/g, '_')}')`
+                : '';
+            found.push(`'${name}' (${node.elementId ?? '?'})${dashes}`);
         }
-        else if (typeof name === 'string' && name.replace(/-/g, '') === FUNCTIONS_NAMESPACE) {
+        else if (typeof name === 'string' && key === FUNCTIONS_NAMESPACE) {
             // K1: preamble her komponent için `const <ad> = Components["<ad>"]` üretir; `Functions` adlı
             // komponent kullanıcı fonksiyonlarının ad alanını ezer ve sayfadaki her Functions.x() ölür.
             found.push(`'${name}' (${node.elementId ?? '?'}) — ayrılmış ad: ${FUNCTIONS_NAMESPACE} kullanıcı fonksiyonlarının ad alanıdır (K1)`);
@@ -29,8 +38,8 @@ export function invalidComponentNames(nodes) {
 }
 /**
  * Sayfa ve layout yazma yollarının ORTAK kapısı: olay adı (PAGE-011 · LAY-004), widget düğümü
- * (PAGE-012 · LAY-005), komponent adı (PAGE-009) ve iç içe repeater (PAGE-013) denetimleri —
- * hepsi istek gitmeden 400.
+ * (PAGE-012 · LAY-005), komponent adı (PAGE-009), blocks (PAGE-037) ve iç içe repeater (PAGE-013)
+ * denetimleri — hepsi istek gitmeden 400.
  *
  * PAGE-009 ve PAGE-013'ün layout ayağı 2026-09-09'da eklendi: ikisi de yalnız sayfa yollarında
  * koşuyordu, oysa layout `views`'ü aynı runtime'dan geçer — bozuk ad o layout'a bağlı HER
@@ -45,17 +54,28 @@ export function assertScreenWriteGuards(kind, screen) {
     const badWidgets = invalidWidgetTypeNodes(screen.schema, codes.widgets);
     if (badWidgets.length > 0)
         throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
-    const badNames = invalidComponentNames(screen.schema);
-    if (badNames.length > 0) {
-        throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil ya da ayrılmış (istek gönderilmedi): ${badNames.join(' · ')}. `
-            + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir; boşluklu ya da geçersiz bir ad '
-            + 'SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür (layout adları her sayfaya sızar). '
-            + `name alanını elementId ile aynı yaz; okunabilir Türkçe başlık için props.title / props.text / props.label kullan (${codes.noun} ${codes.tree}).`, 400);
-    }
+    assertComponentNames(kind, screen.schema);
+    assertComponentBlocks(screen.schema);
     const nested = nestedRepeaterNodes(screen.schema);
     if (nested.length > 0)
         throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
 }
+/**
+ * PAGE-009. `page_schema_validate` de bunu çağırır: kuru koşu yazmayla aynı kararı verir — Y-15
+ * ölçümünde bozuk ad kuru koşuda `valid:true` dönüyor, yazmada 400 alıyordu.
+ */
+export function assertComponentNames(kind, nodes) {
+    const codes = GUARD_CODES[kind];
+    const badNames = invalidComponentNames(nodes);
+    if (badNames.length === 0)
+        return;
+    throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil ya da ayrılmış (istek gönderilmedi): ${badNames.join(' · ')}. `
+        + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir ve addan yalnız İLK tireyi siler; boşluklu, '
+        + 'iki tireli ya da geçersiz bir ad SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür '
+        + '(layout adları her sayfaya sızar). name alanını elementId ile aynı yaz; ad verilmezse gateway elementId\'yi ad olarak '
+        + 'yazar, bu yüzden elementId de geçerli bir tanımlayıcı olmalı (harf, rakam, _). '
+        + `Okunabilir Türkçe başlık için props.title / props.text / props.label kullan (${codes.noun} ${codes.tree}).`, 400);
+}
 /**
  * Katalog kurallarını (blok sınırı · auto-height · boyut string'i) ağaca uygular ve
  * `withNormalization` kuyruğuna giren üç notu döndürür. Boş/verilmemiş ağaçta katalog

package/dist/tools/screens.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
 export const hostParam = z.enum(['page', 'layout', 'component'])
     .describe("Akışın barındırıcısı: page | layout | component (widget de component'tir)");
 export const schemaParam = z.array(z.record(z.unknown()))
-    .describe('Komponent ağacı (DesignComponentManagementSchema listesi); verilmezse mevcut şema korunur');
+    .describe("Komponent ağacı (DesignComponentManagementSchema listesi): her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). Verilmezse mevcut şema korunur");
 export const eventsParam = z.array(z.record(z.unknown()))
     .describe("Sayfa/layout düzeyi olaylar: [{ name, value }] — value bir flow id'sidir");
 export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",