@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/dist/knowledge/componentCatalog.js

@@ -27,7 +27,7 @@ export const TABLE_COLUMN_TYPE_NOTE = "KOLON TİPİ SÖZLÜĞÜ (bekler → çiz
     "file: dosya alanı ya da url metni → dosya adı + ikon, yeni sekmede açılan bağlantı. " +
     "url: metin → tıklanabilir bağlantı (ikonlu, http ise yeni sekme). link: metin → tıklanmayan düz bağlantı görünümü. " +
     "email: metin → düz metin. " +
-    "dropdown: option value'su → kolonun options listesinden LABEL, appearance renginde rozet. multiselect: value dizisi → eşleşen label'lar rozet olarak. " +
+    "dropdown: option value'su → kolonun options listesinden LABEL, appearance renginde rozet. multiselect: value dizisi → DEĞER SIRASIYLA label rozetleri; options'ta karşılığı olmayan değer olduğu gibi yazılır (düşürülmez), tek bir değer tek elemanlı dizi sayılır. " +
     "tag: metin → appearance renginde TEK rozet; renk kolonun appearance prop'undan gelir (satır bazında rows[i]._columns[<indeks>].appearance ile ezilir), serbest hex ALMAZ. " +
     "tags: [{ value, color }] dizisi ya da metin dizisi → çok rozet, renk SATIR VERİSİNDEN (serbest hex burada geçer), sığmayanlar +N ile toplanır. " +
     "action: veri kolonu DEĞİL — aksiyon sütunu ayrı çizilir; kolon tanımında seçilirse ham değer metin olarak görünür.";
@@ -45,9 +45,12 @@ export const STYLE_GROUP_NOTES = {
  * borderWidth…) yerini alır; kayıtlı appearance değerleri çizilmeye devam eder
  * ama Studio'da artık düzenlenmez — yeni karar surfaceStyle'a yazılır.
  */
+const DATE_VALUE_FORMAT_NOTE = "YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metni (dilim eki yok; valueOffset verilmişse o kadar saat kaydırılmış) ya da null. Biçim uygulama dilinden ve locale'den BAĞIMSIZDIR — locale yalnız ekrandaki metni değiştirir. Uca type:'text' parametreyle aynen gider; SQL'de ::timestamp ile okunur, to_timestamp/AM-PM ayrıştırması GEREKMEZ (G-01: backend bu değeri eskiden en-US '9/15/2026 10:23:00 PM' metnine çeviriyordu, 2026-09-15'te düzeltildi).";
 export const LOCALE_FOLLOWS_APP_NOTE = "Boş bırak — komponent o zaman UYGULAMA dilini izler ve language-selector ile dil değişince gün/ay adları ve saat biçimi anında güncellenir. Doldurulursa o dile SABİTLENİR (bilinçli sabitleme için). Tasarımcı listesi tr/en gösterir ama uygulama dili yolu her ISO 639-1 kodunu kabul eder; sözlüğü olmayan dilde METİN İngilizceye düşer, sayı/tarih BİÇİMİ o dilin kendi kuralını kullanır.";
 const NODE_SURFACE_NOTE = STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens +
     " Bu bileşen grubu KENDİ OKUMAZ: render katmanı yüzeyi düğüm kutusuna (.ng-app__node-item) yazar, contentOverflow kutunun kendisine iner. Eski appearance Surface alanları (background/borderWidth/radius/shadow/opacity/overflow) EMEKLİ — yeni karar buraya yazılır.";
+/** layout ve navigations'ın ORTAK menü satırı grubu (frontend style-group-schemas.ts navigationStyleGroup + navigation-style-logic.ts). */
+const NAVIGATION_STYLE_NOTE = "Menü satırlarının TİPLİ grubu, menünün TAMAMINA uygulanır: padding (CSS kutu kısayolu; sol değer satırın derinlik girintisiyle TOPLANIR), radius (tema kademesi 'sm|md|lg|pill' ya da CSS), textColor · iconColor · hoverBackground (seçili OLMAYAN satırlar), activeBackground · activeTextColor · activeIconColor (seçili satır; zemin hover'da da korunur). Boş iconColor yazı rengini izler. Renkler hex ya da var(--ng-…) token'ı alır. ÖĞE BAZLI STİL YOKTUR: navigations[].style diye bir alan tanımlı değil, yazılan değer sessizce düşer — satır görünümünü yalnız bu grup verir. Grubun yazmadığı CSS için style'ın &__item / &__item--active / &__icon parçaları kullanılır (yalnız navigations bileşeninde; layout'un style'ı menüye ulaşmaz). resolvedStyle raporu bu grubu İÇERMEZ.";
 export const componentKnowledge = {
     html: {
         summary: 'Kaçış kapısı: hazır komponentler yetmediğinde ham HTML + Mustache şablonu + scoped CSS + satır içi script + flow köprüsüyle her gereksinimi kapatır.',
@@ -70,22 +73,32 @@ export const componentKnowledge = {
         }
     },
     table: {
-        summary: 'Etkileşimli veri ızgarası: satır seçimi, çift tık, hücre içi düzenleme, kolon filtreleme/sıralama — her etkileşim AYRI olay olarak akışa bağlanır.',
+        summary: 'Etkileşimli veri ızgarası: satır seçimi, çift tık, hücre içi düzenleme, kolon filtreleme/sıralama, araç çubuğunda arama — her etkileşim AYRI olay olarak akışa bağlanır.',
         behavior: [
-            'Süzme/sıralama/sayfalama sunucu taraflıdır: filters/sortField/offset akışla uca gider, dönen satırlar rows prop’una setter ile yazılır.',
+            'Süzme/sıralama/arama/sayfalama sunucu taraflıdır: filters/sortField/searchText/offset akışla uca gider, dönen satırlar rows prop’una setter ile yazılır.',
+            'AKIŞ BAĞLANMAZSA KONTROL ÇİZİLİR AMA SATIR DEĞİŞMEZ: showSort başlığa ok, filterMode filtre satırı/paneli, isSearchable arama kutusu koyar; tablo rows’u KENDİSİ sıralamaz, süzmez, aramaz, sayfalamaz. İlgili olay (sort · filter · search · pagination) mount akışıyla aynı sorguya bağlanmadıysa ok döner, kutu dolar, satırlar yerinde kalır. Üçünün de yazdığı offset 0’a döner.',
+            'SATIR TIKLAMASI HER KİPTE self.selectedRow’a yazar ve select’i çalıştırır — rowSelection:none dahil; rowSelection yalnız VURGUYU ve onay kutularını belirler (none: vurgu yok · single: tıklanan satır boyanır · multi: kutu kolonu). self.selectedRows YALNIZ multi kutularıyla değişir ve selectionChange’i çalıştırır; başlık kutusu yalnız o sayfanın satırlarını seçer/bırakır. Seçimin yeniden sorgudan sonra da tutması için bir kolon isKey olmalı (tipik: gizli id kolonu) — yoksa nesne kimliğiyle eşleşir ve yeni gelen satır nesneleri seçili görünmez.',
+            'isReadonly:true HÜCRE DÜZENLEMEYİ KAPATIR (isEditable:true’yu ezer; çift tık ve Enter editör açmaz), satır tıklamasının select/doubleClick’ini, multi onay kutularını (kilitli çizilir) ve aksiyon kolonunu (hiç çizilmez) kapatır. Filtre, sıralama, arama ve sayfalama salt okunur tabloda da çalışır.',
+            'Satır aksiyonu (actions[i].flow) tıklanınca ÖNCE self.selectedRow o satıra yazılır, SONRA aksiyonun kendi akışı çalışır — olay adı yoktur, akış aksiyon kaydının flow alanındadır. emptyActions satırsız çalışır ve selectedRow YAZMAZ. actionType:"dropdown" aksiyonları ⋯ menüsüne toplar.',
+            "totalRows yazılmazsa (0/boş) tablo elindeki satırlardan fazlasını bilemez: sayfalayıcı TEK SAYFA kalır ve gösterge o satırları sayar ('12 / 12'); ileri oku pasiftir. limit sayfa boyu listesinde (10·20·30·40·50) yoksa (25, 100) listeye eklenir. rows/filters/selectedRows akıştan null ya da dizi olmayan bir değerle gelirse boş liste sayılır, tablo çökmez (selectedRows'a tek satır nesnesi yazma — dizi yaz).",
             "isPaginated:true + akışta limit/offset parametreleri + pagination olayı üçlüsü birlikte kurulmalı; biri eksikse tablo tek sayfa kalır (platform_guide('page') Kural 1c).",
-            "SATIR BAZLI GÖRÜNÜM EZMESİ: bir satır kendi _columns DİZİSİNİ taşıyabilir — rows[i]._columns[<kolonun columns dizisindeki İNDEKSİ>] = { appearance:'error', isBold:true, options:[...] } kolon tanımıyla birleşir (column-view.ts resolveColumn → Table.svelte:1207 <TableCell {column}>). İndeks TANIM sırasıdır: buildViewColumns index'i isHidden kolonlar elenmeden ÖNCE atar, görünür sıra değil. Kullanıcı kolon menüsünden kolon gizlese bile indeksler kaymaz (hideColumns buildViewColumns'dan SONRA uygulanır). Ezilebilen alanlar appearance · options · isBold; CSV export'u da ezmeyi uygular. Aynı kalıp _actions[i] ile satır bazlı aksiyon ezmesinde de çalışır (rowActions). ŞEMA PROP'U DEĞİLDİR — component_get prop listesinde görünmez, satır verisinin içinde taşınır.",
+            "SATIR BAZLI GÖRÜNÜM EZMESİ: bir satır kendi _columns DİZİSİNİ taşıyabilir — rows[i]._columns[<kolonun columns dizisindeki İNDEKSİ>] = { appearance:'error', isBold:true, options:[...] } kolon tanımıyla birleşir (column-view.ts resolveColumn → Table.svelte <TableCell {column}>). İndeks TANIM sırasıdır: buildViewColumns index'i isHidden kolonlar elenmeden ÖNCE atar, görünür sıra değil. Kullanıcı kolon menüsünden kolon gizlese bile indeksler kaymaz (hideColumns buildViewColumns'dan SONRA uygulanır). Ezilebilen alanlar appearance · options · isBold; CSV export'u da ezmeyi uygular. Aynı kalıp _actions[i] ile satır bazlı aksiyon ezmesinde de çalışır (rowActions). ŞEMA PROP'U DEĞİLDİR — component_get prop listesinde görünmez, satır verisinin içinde taşınır.",
             "Koşullu/satır bazlı renk table'da _columns ile kurulur ve style prop'unu KAYBETTİRMEZ — datatable'ın colorMap'i statiktir. Hem CSS hem satıra göre renk isteyen tablo table'dır; renk için datatable'a mecbur değilsin."
         ],
         propNotes: {
             surfaceStyle: NODE_SURFACE_NOTE,
             rows: 'Satır dizisi; mount/filter/sort/pagination akışlarının setter adımıyla doldurulur.',
             appearance: "YÜKSEKLİK/GENİŞLİK ELLE HESAPLANMAZ (ölçüldü 2026-09-05, f11-repro). heightType:'auto' tablo içeriği kadar uzar — satır sayısı × satır yüksekliği hesabı gerekmez. heightType:'fixed' gövdeyi KAYDIRIR (grid-container overflow:auto), satır kaybolmaz; kare'de görünmeyen satır kırpılmış değil kaydırılmıştır. KOLONLAR KARTI TAŞIRMAZ: genişlik toplamı kabı aşarsa tablo kendi içinde YATAY kaydırır ve sağ kenara taşma göstergesi koyar; kabın scrollWidth'i değişmez. Toplam kaptan KÜÇÜKSE kolonlar orantılı büyütülüp kap tam doldurulur (stretchColumns) — bu yüzden 'kolonu daraltayım da sığsın' yamalarına gerek yok. Tek gerçek tuzak yerleşim tarafındadır: FLEX ebeveynde blocks[].size yok sayılır, ölçü appearance'tan gelir; IZGARA ebeveynde tersi (gateway PAGE-019 ile uyarır).",
-            totalRows: "Toplam kayıt: Number(Steps.<adım>?.headers?.[\"total-count\"] ?? 0) guard'lı ifadesiyle yazılır.",
-            rowSelection: "none | single | multi — seçim self.selectedRow / self.selectedRows prop'larından okunur.",
-            columns: TABLE_COLUMN_TYPE_NOTE + " Kolon tanımları; mapping anahtarları kolonların name'iyle birebir eşleşmeli. RENK: tag kolonu appearance ile 5 token alır (primary · info · success · warning · error) ve satır bazında _columns ezmesiyle değişir; serbest hex gerekiyorsa tags kolonunu kullan ve satır verisine [{ value, color:'#da1e28' }] yaz. Sayı/tarih biçimlendirmesi (prefix/suffix/precision/thousands/dateFormat/imageShape) table'da YOK — o datatable'ın kolon şemasındadır. ORANSAL ÇUBUK: type:'progress' hücrede çubuk çizer ve HAM SAYI bekler (yüzdeyi kendisi hesaplar): value/max. max varsayılanı 100, yani 0..100 arası yüzde alanını doğrudan bağlayabilirsin; sayı 25/40 gibi bir orandan geliyorsa max'ı paydaya ver. Ayarlar: progressVariant(bar|circle) · progressLabel(none|percent|fraction|value) · progressColor(primary|info|success|warning|error|custom) + customProgressColor · thresholds[{from(%), color}] — eşik listesi doluysa çubuğun DOLULUK YÜZDESİNE göre son eşiğin rengi kazanır, yani tek kolon 80'in altında yeşil üstünde kırmızı olur. Sayıya çevrilemeyen değer 0'dır, hücre boş çubuk çizer.",
+            totalRows: "Toplam kayıt: Number(Steps.<adım>?.headers?.[\"total-count\"] ?? 0) guard'lı ifadesiyle yazılır. Yazılmazsa sayfalayıcı tek sayfa kalır ve gösterge eldeki satırları sayar.",
+            rowSelection: "none | single | multi — seçim self.selectedRow / self.selectedRows prop'larından okunur. none 'satır seçilemez' DEMEK DEĞİL: satır tıklaması yine selectedRow'a yazar ve select'i çalıştırır, yalnız vurgu yoktur.",
+            isSearchable: "Araç çubuğuna arama kutusu koyar. Kutu yalnız searchText'i yazar ve search olayını { searchText, offset:0 } ile çalıştırır; SÜZMEYİ AKIŞ YAPAR — search olayını mount'la aynı sorguya bağla ve metni akışta self.searchText ile okuyup uca parametre olarak geçir. Metin kırpılmadan gelir.",
+            searchText: "Uygulanan arama metni. Kutu yazar, akış okur. Tasarımda doldurulursa kutu O METİNLE açılır — ama tablo kendisi aramadığı için ilk sayfa ancak mount akışı da self.searchText'i sorguya geçiriyorsa aranmış gelir. Akıştan yazılırsa kutu o metni gösterir.",
+            size: "Satır YOĞUNLUĞU (panel etiketi 'Row density'): sm sıkı · md ve boş = temanın normal satır yüksekliği · lg ferah. Form bileşenlerinin temadaki varsayılan girdi boyutunu İZLEMEZ. Yalnız satır ve başlık yüksekliğini değiştirir (yazı boyu değişmez); filtre satırı her yoğunlukta aynı kalır.",
+            isReadonly: "Düzenlemeyi (isEditable'ı ezer), satır tıklamasının select/doubleClick'ini, multi onay kutularını ve aksiyon kolonunu kapatır; filtre/sıralama/arama/sayfalama çalışmaya devam eder.",
+            limit: "Sayfa boyu. Sayfalayıcıdaki liste 10·20·30·40·50'dir; başka bir değer (25, 100) listeye eklenir ve seçili görünür. pagination olayı { offset, limit } yazar.",
+            columns: TABLE_COLUMN_TYPE_NOTE + " Kolon tanımları; mapping anahtarları kolonların name'iyle birebir eşleşmeli. HİZA: kolonun align alanı left|center|right (boş = left) başlığı ve hücreyi birlikte hizalar — sayı/para kolonlarını sağa yaslamak için; tags kolonu hizalanmaz (rozetler taşma ölçümü için soldan dizilir); progress çubuğu hücreyi doldurur, circle varyantı varsayılan olarak ortalıdır. isBold tag · tags · url · link · switch · image · progress DIŞINDAKİ kolonlarda hücreyi kalın yazar (onlar kendi kalınlığını çizer ya da metin taşımaz). progress ayarları (max, progressVariant, progressLabel, progressColor, customProgressColor, thresholds) YALNIZ type:'progress' kolonunda okunur. RENK: tag kolonu appearance ile 5 token alır (primary · info · success · warning · error) ve satır bazında _columns ezmesiyle değişir; serbest hex gerekiyorsa tags kolonunu kullan ve satır verisine [{ value, color:'#da1e28' }] yaz. Sayı/tarih biçimlendirmesi (prefix/suffix/precision/thousands/dateFormat/imageShape) table'da YOK — o datatable'ın kolon şemasındadır. ORANSAL ÇUBUK: type:'progress' hücrede çubuk çizer ve HAM SAYI bekler (yüzdeyi kendisi hesaplar): value/max. max varsayılanı 100, yani 0..100 arası yüzde alanını doğrudan bağlayabilirsin; sayı 25/40 gibi bir orandan geliyorsa max'ı paydaya ver. Ayarlar: progressVariant(bar|circle) · progressLabel(none|percent|fraction|value) · progressColor(primary|info|success|warning|error|custom) + customProgressColor · thresholds[{from(%), color}] — eşik listesi doluysa çubuğun DOLULUK YÜZDESİNE göre son eşiğin rengi kazanır, yani tek kolon 80'in altında yeşil üstünde kırmızı olur. Sayıya çevrilemeyen değer 0'dır, hücre boş çubuk çizer.",
             style: "İKİ AYRI YAZIM KURALI: style.root emotion css() bloğudur (camelCase çalışır, iç seçici yazılabilir); style.thead|th|tr|td ise satır içi style attribute'una basılır (column-view.ts toStyleString anahtarı olduğu gibi yazar) — bu dördünde KEBAB-CASE zorunludur, fontSize sessizce düşer, font-size çalışır.",
-            isEditable: 'Hücre içi düzenleme; değişen satır rowChange olayında self.rows üzerinde güncellenir.'
+            isEditable: "Hücre içi düzenleme: çift tık ya da Enter editörü açar, Enter/dışarı tıklama işler, Escape vazgeçer. Değer GERÇEKTEN değiştiyse rowChange çalışır (saklı değer de aynı normalleştirmeden geçer: '1250' metni tutan money hücresini açıp kapatmak olay üretmez) ve düzenlenen satır YENİ değeriyle self.selectedRow'dadır (satır self.rows içinde de yerinde güncellenir). number · money · pertance · progress kolonları sayı olarak yazılır; tag · tags · link kolonları düzenlenmez. isReadonly:true iken hiçbir hücre düzenlenmez."
         }
     },
     datatable: {
@@ -104,7 +117,7 @@ export const componentKnowledge = {
             image: "IMAGE/FILE kolonu düz URL string'i KABUL ETMEZ: hücre `{ absolute_path, display_name }` (ya da `fileName`) alanlarını taşıyan bir DOSYA NESNESİ (veya nesne dizisi) bekler — `DisplayCellView.svelte:10` `file.absolute_path ?? ''` okur, düz string verilince kaynak boş kalır ve hücre SESSİZCE boş çizilir (09-04 Y-21). Satır verisi bir metin kolonunda URL taşıyorsa kolonu 'url'/'link' yap ya da veriyi { absolute_path: '<url>', display_name: '<ad>' } biçimine çevir; entity'nin FILE alanı zaten bu şekli döner.",
             actions: "Satır aksiyonları. kind sözlüğü BUTON'unkinden farklıdır: error · information · solid · transparent · dark · danger · warning (butonda success/error/info/primary/warning). Yanlış sözlükten değer invalid-enum-value verir.",
             selectedRow: "Salt okunur: satır aksiyonu tıklanınca komponentin kendisi doldurur; akış ifadesinde '<elementId>.selectedRow' ile okunur.",
-            colorMap: "Kolon içi değer→renk sözlüğü: [{ value:'Active', color:'#16a34a' }]. STATİKTİR — hücrenin kendi değerine bakar, satırın başka alanına göre hesaplanamaz. Satıra göre koşullu renk gerekiyorsa ya table + _columns ezmesi kullan ya da satır verisinde rengi taşı ({ label, color }) — render sırası: veri objesindeki color → colorMap[etiket] → autoColor.",
+            colorMap: "Kolon içi değer→renk sözlüğü: [{ value:'Active', color:'#16a34a' }]. STATİKTİR — hücrenin kendi değerine bakar, satırın başka alanına göre hesaplanamaz. Satıra göre koşullu renk gerekiyorsa ya table + _columns ezmesi kullan ya da satır verisinde rengi taşı ({ label, color }) — render sırası: veri objesindeki color → colorMap[etiket] → autoColor. TAG HÜCRE ŞEKLİ: metin, { label, color? } ya da { value, color? } (label yoksa value okunur; ikisi de yoksa obje ham JSON basılır) veya bunların dizisi. RENK (veri objesinde de colorMap'te de): semantik ad primary · info · success · warning · error TEMA TOKEN'INA çözülür (tema değişince izler, ham hex yazmaya gerek yok); hex/rgb/'var(--ng-…)'/CSS renk adı olduğu gibi geçer; başka bir değer (yazım hatası, çözülmemiş '{{ }}') o kademeyi ATLAR ve sıradakine düşer. Veri objesindeki variant OKUNMAZ — outline/solid kolonun appearance'ından gelir. Solid rozetin yazı rengi token'da CSS ile siyah/beyaz seçilir.",
             tableStyle: "zebra | plain — satır zemini varyantı; CSS DEĞİL. Serbest CSS için ayrı `style` prop'u vardır (parça bazlı).",
             style: "Parça bazlı CSS: &__toolbar · &__title · &__head · &__th · &__body · &__row · &__td. designerCss her bildirime !important ekler, yani komponentin kendi çerçeve/ayraç varsayılanlarını ezer — Figma tipi düz tablo bununla kurulur."
         }
@@ -114,10 +127,12 @@ export const componentKnowledge = {
         behavior: [
             "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.",
-            "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."
+            "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.",
+            "Formu temizlemek için akış kodunda resetForm('<form adı>') çağrılır (2026-09-15): alanlar başlangıç değerine döner, form gönderilmemiş hâline geçer, hata işaretleri ve form-validation-errors listesi silinir. Alanları setter ile tek tek null'a çekmek YANLIŞ yoldur: form bir kez gönderildiyse her change doğrulamayı yeniden koşturur ve boş form 'zorunlu alan' mesajlarıyla açılır. Gönderim sonrası otomatik temizlik isteniyorsa isClearFormInputsAfterSubmit aynı sıfırlamayı yapar."
         ],
         propNotes: {
-            surfaceStyle: NODE_SURFACE_NOTE,
+            surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Form grubu KENDİ derler (2026-09-15): değer <form> KÖKÜNE iner, contentOverflow gövdeye ('&__body'). Formu bir kartın içine koyup kendi zeminini/çerçevesini kaldırmanın yolu budur: { background: 'transparent', borderTop: 'none', borderRight: 'none', borderBottom: 'none', borderLeft: 'none' }.",
+            style: STYLE_GROUP_NOTES.styleEscape + " Parçalar: KÖK (anahtarlar doğrudan style'da) <form> elemanıdır ve TABAN zemini (--ng-background-surface), 1px çerçeveyi (--ng-border-primary) ve köşeyi (--ng-rounded) ÇİZER; '&__body' yalnız kaydırma/esneme taşır — çerçeveyi '&__body'ye yazarak kaldıramazsın. '&__header' başlık bandı, '&__title' başlık metni. DOM yapısına bağlı seçiciler ('& > div') belgelenmemiştir ve iç yapı değişince sessizce kırılır.",
             errorElementId: "Sayfadaki form-validation-errors komponentinin elementId'si — bağlanmazsa alan doğrulama mesajları görünmez."
         }
     },
@@ -186,11 +201,22 @@ export const componentKnowledge = {
     phoneinput: {
         summary: 'Ülke kodu seçicili telefon girişi; değeri her zaman E.164 biçiminde yazar (+905321234567).',
         behavior: [
-            'Yazılan metin ülkeye göre süzülür ve hane sınırına kırpılır; DEĞER DEĞİŞMEDİYSE change YAYILMAZ — duvara çarpan tuşlar boş akış tetiklemez.',
-            "blur her odak kaybında yayılır (değer aynı olsa bile) ve setter DEĞİLDİR — 'alan bırakıldı' kancası olarak kullan.",
-            'defaultCountry yalnız BAŞLANGIÇ ülkesidir; kullanıcı seçiciyi değiştirince değer yeni ülkenin koduyla yeniden kurulur.'
+            'Yazılan metin ülkeye göre süzülür ve hane sınırına kırpılır; DEĞER DEĞİŞMEDİYSE change YAYILMAZ — duvara çarpan tuşlar boş akış tetiklemez. Hane sınırı ülke uzunluk bildirmiyorsa da vardır: alan kodu + numara 15 haneyi (E.164) aşamaz.',
+            "blur her odak kaybında yayılır (değer aynı olsa bile) ve setter DEĞİLDİR — 'alan bırakıldı' kancası olarak kullan. focus/blur SATIR düzeyindedir: numara alanı ile ülke seçicisi arasında gezinmek olay yaymaz.",
+            'Üç olay (change, enter, blur) aynı yükü taşır ve ÜÇÜ DE self.value’yu yazar — platform emisyonun data’sını koşulsuz düğüme yazıyor, "setter" bayrağı okunmuyor (ARC-067). Yazılan tek anahtar value’dur; formattedValue ve isValid düğüme YAZILMAZ, akışta yalnız event.data ile okunur.',
+            'defaultCountry yalnız BAŞLANGIÇ ülkesidir; kullanıcı seçiciyi değiştirince değer yeni ülkenin koduyla yeniden kurulur. Kayıtlı bir değerin alan kodu her zaman defaultCountry’yi yener.',
+            'Dört kip ekranda ayrı görünür: isDisabled gri + yasak imleç, isReadonly okunur zemin, isViewmode çerçevesiz düz metin, isLoading ise alanı GRİLEŞTİRMEZ — imleç progress olur ve satırın sonunda spinner döner. isDisabled dışındaki üçü alanı odaklanabilir bırakır.'
         ],
-        propNotes: { value: 'E.164 metni; boş girişte boş string.' }
+        propNotes: {
+            value: 'E.164 metni; boş girişte boş string.',
+            defaultCountry: 'Boş alanın açılacağı ülke. Panelden değiştirmek boş alanı ANINDA yeni ülkeye taşır; alanda değer varsa değerin alan kodu kazanır.',
+            isCountryLocked: 'Ülke seçicisini kaldırır ve yerine sabit alan kodunu metin olarak çizer — tek ülkeli formda kullanıcının yanlış ülke seçmesini kapatır. Ülkeyi defaultCountry belirler; kayıtlı değerin alan kodu yine kazanır.',
+            autofocus: 'Sayfa açılınca odak numara alanına gelir — ülke seçicisine değil (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            size: 'Alanın yüksekliği, puntosu, köşe yarıçapı ve yan dolgusu; boş bırakılırsa temanın form ölçüsü kullanılır.',
+            isReadonly: 'Alan okunur zemine geçer, odaklanabilir ve seçilebilir kalır; yazmak ve ülke değiştirmek kapalıdır, olay yayılmaz.',
+            isViewmode: 'Alan çerçevesiz düz metne iner (kayıt görüntüleme ekranı); odak izi yine çizilir, olay yayılmaz.',
+            isLoading: 'Alanı dondurur (readonly, gri değil; ülke seçici görünür kalır ama seçim geri alınır, olay yayılmaz) ve satırın sonunda dönen spinner çizer. Numara doğrulama gibi bir sorgu sürerken aç, gelince kapat.'
+        }
     },
     filterbuilder: {
         summary: 'İç içe and/or filtre kuralları kurar ve akışa HEM kural ağacını HEM hazır jexl ifadesini verir.',
@@ -261,7 +287,7 @@ export const componentKnowledge = {
             layout: "'flex' (katalog varsayılanı; akış) | 'grid' (12 kolonluk ızgara). Prop hiç yazılmamışsa renderer IZGARA çizer — varsayılan yalnız düğüm kurulurken materyalize olur. Aşağıdaki altı prop YALNIZ 'flex' iken etkilidir.",
             direction: "'row' (varsayılan) | 'column' → flex-direction. Hangi hizalamanın ana eksen olduğunu bu belirler.",
             horizontalAlign: "left | center | right | stretch. row'da ANA eksen (justify-content), column'da ÇAPRAZ eksen (align-items). stretch: ana eksende space-between, çapraz eksende tam doldurma.",
-            verticalAlign: "top | middle | bottom | stretch. row'da ÇAPRAZ eksen, column'da ANA eksen — horizontalAlign ile rollerini değiştirirler.",
+            verticalAlign: "top | middle | bottom | stretch. row'da ÇAPRAZ eksen, column'da ANA eksen — horizontalAlign ile rollerini değiştirirler. row'da stretch seçiliyken çocuğun sabit yüksekliği (heightType fixed → heightString ya da size.h×10px) HEIGHT değil MIN-HEIGHT olarak yazılır (2026-09-15): çocuklar en uzun kardeşin boyuna eşitlenir, sabit ölçü taban kalır — eşit boylu KPI kartları için her karta elle aynı heightString yazmak gerekmez. İstisna: isScrollable çocuk kesin yüksekliğini korur. Izgara kapta (layout grid) bu prop da gap de okunmaz; eşit kart satırı flex row + stretch ile kurulur.",
             size: "'shrink' (çocuklar flex: 0 1 auto, varsayılan) | 'grow' (flex: 1 1 auto — çocuklar boşluğu paylaşır).",
             gap: "none | small | medium (varsayılan) | large → tema değişkenleri: 0 / var(--ng-spacing-sm) / --ng-spacing-md / --ng-spacing-lg (varsayılan temada 8/16/32px). Alan allowCustom'dır: '18px' ya da 'var(--ng-spacing-xl)' gibi ham CSS değeri de geçer. Çocuk genişlik formülünden payı düşülür, böylece w toplamı 12 olan satır tam kapanır.",
             wrap: "flex-wrap: wrap. Varsayılan AÇIK (2026-09-01'de flipledi): w:12 çocuklar alt satıra sararak dikey akar. Kapatırsan satıra sığmayan çocuklar sıkışır, alta inmez.",
@@ -274,12 +300,15 @@ export const componentKnowledge = {
         propNotes: {
             surfaceStyle: NODE_SURFACE_NOTE,
             rows: 'Yinelenen veri; çocuk komponent ifadelerinde satıra item / Row ile erişilir.',
-            selectedIndex: "change olayının YÜKÜDÜR, şema prop'u DEĞİL (component_get prop listesinde görünmez; şemadaki gizli alan selectedItem'dır). RenderComponent tıklanan kartın sırasını bu adla yayar, akışta self.selectedIndex ile okunur."
+            selectedIndex: "Satırdaki bir çocuk (ör. buton) olay yayınca RenderComponent `change` ile yazar; akışta self.selectedIndex ile okunur, `{{ <repeater>.selectedIndex }}` ile başka bileşene bağlanır. Şemada gizli durum prop'udur (panelde çizilmez). 2026-09-09'a kadar runtime'daki ters koşul yüzünden HİÇ yazılmıyordu (gerçek ekranda ölçüldü, düzeltildi); eski gizli selectedItem alanı da aynı gün kaldırıldı, kimse okumuyordu."
         }
     },
     modal: {
         summary: 'Ortalanmış katman; şemanın KÖKÜNDE page_container’ın kardeşi olarak durur, içeriği (kendi formu ve submit akışı dahil) children’ına eklenir.',
-        behavior: ["open/close olayları akışa bağlanabilir; açma/kapama isHidden ile değil kendi open state'iyle yürür (setter ile isOpen yaz)."],
+        behavior: [
+            "open/close olayları akışa bağlanabilir; açma/kapama isHidden ile değil kendi open state'iyle yürür (setter ile isOpen yaz).",
+            "Kaplama çerçevesidir (isFrame): kanvasta blok tutmaz, runtime kutu stili yazmadan ayrı dalda çizer. Katalog boyutu bilerek BOŞ aralıktır (minSize 1, maxSize 0) ve 2026-09-15'ten beri doğrulayıcı boş aralıklı eksende blocks[].size'ı DENETLEMEZ — add_component ile kökte (parent null) herhangi bir { w, h } ile eklenir. Daha eski backend build'i her boyutu 'Height of modal must be between 1 and 0' (invalid-size) ile reddeder; o durumda imaj yenilenmemiştir. drawer ve toast aynı kuraldadır."
+        ],
         propNotes: { surfaceStyle: NODE_SURFACE_NOTE }
     },
     drawer: {
@@ -288,35 +317,254 @@ export const componentKnowledge = {
     },
     dropdown: {
         summary: 'Tek seçim listesi; options statik verilebilir ya da mount/search akışıyla uzaktan doldurulur.',
+        behavior: [
+            "Alan SEÇİLİ METNİ options'tan çözer: value dolu ama o value'lu bir option listede YOKSA kutu BOŞ görünür (hata vermez). Uzaktan dolan listede sırayı koru — önce options'ı yaz, sonra value'yu; ikisi ayrı akışlarda yazılıyorsa alan bir an boş kalır.",
+            "Eşleşme TİPE DUYARLIDIR (katı ===): options'tan gelen { id: 34 } sayı kalır, alanın value'su ise metindir ('34'), yani bu ikisi EŞLEŞMEZ ve kutu boş görünür. Bu, 'value var ama görünmüyor' vakalarının en sık sebebidir — eşlemeyi akış katmanında aynı tipe getir.",
+            "change yükü { value, selectedLabel } taşır ve ikisi de düğümün prop'una yazılır: akışta self.value ve self.selectedLabel ile okunur. selectedLabel 2026-09-11'de eklendi — etiketi göstermek için options'ta arama yapmaya gerek yok. Temizleme (X) de change yayar, ikisi de boş metin olur.",
+            "Arama VARSAYILAN OLARAK YERELDİR (label üzerinde bulanık eşleme). Sayfa bu bileşene bir `search` olayı bağlarsa yerel süzme KAPANIR ve tamamen akışın sorumluluğuna geçer: bileşen searchText'i yazıp olayı atar, akış options'ı yeniden yazmazsa liste değişmez. Uzak aramada isLoading'i akıştan aç/kapa.",
+            "isLoading KİLİT DEĞİLDİR (2026-09-11): alan odaklanabilir kalır, açık liste yükleniyor satırını gösterir ve kullanıcı yazmayı sürdürebilir. Öncesinde isLoading alanı disabled yapıyordu, yani uzak arama her tuşta odağı düşürüyordu. Tek şart: liste KAPALIYKEN isLoading açıksa chevron'a tıklamak listeyi açmaz (metin alanına tıklamak ve klavye açar) — ortak Select'in kuralı.",
+            'Olaylar: mount (render katmanı atar) · change · search · focus · blur. blur 2026-09-11’de eklendi ve odak alanın TAMAMINI terk edince yayılır — liste açılırken odak arama kutusuna geçtiğinde yayılmaz, yani blur’a bağlanan doğrulama liste içinde tetiklenmez.',
+            "optionType='grouped' iken option'ın children'ı alt satırları çizer; çocuğu olan satır VARSAYILAN OLARAK SEÇİLEMEZ, yalnız açılır/kapanır — başlığın kendisi de seçilebilsin isteniyorsa o option'a isSelectable ver. optionType='single' iken children/isExpanded/isSelectable okunmaz.",
+            "Tek doğrulama kuralı `required`'dır (2026-09-11; `pattern` bildirimi kaldırıldı, panelde hiç çizilemiyordu)."
+        ],
         propNotes: {
-            value: "Seçilen option'ın value'su — ilişki alanlarında etiket değil id yazılır/okunur.",
-            options: '[{ label, value }] dizisi; akışla doldurulacaksa setter hedefi budur.'
+            value: "Seçilen option'ın value'su — ilişki alanlarında etiket değil id yazılır/okunur. Kutuda ancak aynı value'lu bir option listede varken metin görünür ve karşılaştırma tipe duyarlıdır (sayı 34 ile metin '34' eşleşmez).",
+            options: '[{ label, value }] dizisi; akışla doldurulacaksa setter hedefi budur. Ek alanlar: caption, icon/prefixImage/prefixText, color, tooltip, isDisabled, isHidden ve grouped modda children/isSelectable/isExpanded.',
+            optionType: "'single' düz liste, 'grouped' children ile ağaç. single'da children ve yanındaki iki bayrak hiç okunmaz.",
+            clearable: 'Seçimi temizleyen X düğmesi (varsayılan açık). Temizleme change yayar, ayrı bir olay yoktur.',
+            emptyText: 'Liste boşken gösterilen metin; boş bırakılırsa arayüz dilinden gelen "sonuç yok" metni kullanılır.',
+            placeholder: 'Seçim yokken kutuda duran metin; aynı zamanda yükleniyor satırının metnidir.',
+            searchText: "Gizli durum prop'u: bileşen OKUMAZ, `search` olayıyla yazar. Uzak aramada sorguyu akışta self.searchText ile oku.",
+            selectedLabel: "Gizli durum prop'u: `change` seçilen option'ın label metnini buraya yazar (temizlemede boş metin). Yalnız kullanıcı seçimiyle dolar — value'yu akıştan yazmak burayı GÜNCELLEMEZ.",
+            isLoading: 'Uzak arama/doldurma sürerken akıştan açılır; alan kilitlenmez, yalnız spinner ve yükleniyor satırı çizilir.'
         }
     },
     'multi-select': {
-        summary: 'Aranabilir çoklu seçim; value bir değer dizisidir, search olayı sunucu taraflı arama kurmaya yarar.'
+        summary: 'Aranabilir çoklu seçim; value bir değer dizisidir, seçilenler etiket (chip) olarak görünür, search olayı sunucu taraflı arama kurmaya yarar.',
+        behavior: [
+            "value bir DİZİDİR ve üç biçimi de okunur: düz değer (['policies', 7]), şemanın biçimi ([{ value, label }]) ve eski ikizler ([{ id, text }]). Düz değer yazmak 2026-09-11'e kadar etiketi 'undefined' gösteriyordu; artık değer etiketin kendisi olur ve doğru metin options yüklenince gelir.",
+            "Etiketin metni options'tan tazelenir: aynı value'lu option listede varsa onun label'ı yazılır. Bu arama METİNLEŞTİREREK karşılaştırır (String(a) === String(b)), AMA yalnız etiket metni için: satırın işaretli görünmesi ve seçimin kaldırılması KATI karşılaştırma kullanır. Yani value'da metin '34', options'ta sayı 34 varsa çip doğru etiketle çizilir ama liste satırı işaretsiz kalır ve tıklamak hiçbir şey yapmaz — eşlemeyi akış katmanında aynı tipe getir (CQ-208).",
+            "change yükü { value: [{ value, label, id, text }] } taşır ve düğümün value prop'una yazılır: akışta self.value ile okunur. id/text, value/label'ın eski adlı ikizleridir — kayıtlı sayfalar onlarla okuduğu için bilerek korunuyor.",
+            'Her seçimden sonra arama kutusu TEMİZLENİR ve tam liste geri gelir (bilinçli davranış); liste kapanınca da temizlenir ve bir kez boş search yayılır.',
+            "Arama VARSAYILAN OLARAK YERELDİR (label üzerinde bulanık eşleme). Sayfa bu bileşene bir `search` olayı bağlarsa yerel süzme KAPANIR ve tamamen akışın sorumluluğuna geçer: bileşen searchText'i yazıp olayı atar, akış options'ı yeniden yazmazsa liste değişmez. Uzak aramada isLoading'i akıştan aç/kapa.",
+            'isLoading KİLİT DEĞİLDİR (2026-09-11): alan odaklanabilir kalır, açık liste yükleniyor satırını gösterir ve kullanıcı yazmayı sürdürebilir. Öncesinde isLoading alanı disabled yapıyordu, yani uzak arama her tuşta odağı düşürüyordu. Tek şart: liste KAPALIYKEN isLoading açıksa kutuya tıklamak listeyi açmaz (arama kutusuna odaklanmak açar).',
+            'Olaylar: mount (render katmanı atar) · change · search · focus · blur. blur 2026-09-11’de eklendi ve odak alanın TAMAMINI terk edince yayılır: etikete, X’e ya da chevron’a basmak odağı alandan çıkarmaz ve liste içinde gezinmek blur yaymaz. Alan terk edilince açık liste de kapanır.',
+            '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."
+        ],
+        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.",
+            options: '[{ label, value }] dizisi; akışla doldurulacaksa setter hedefi budur. Ek alanlar: caption, icon/prefixImage/prefixText, color, tooltip, isDisabled, isHidden ve grouped modda children/isSelectable/isExpanded.',
+            optionType: "'single' düz liste, 'grouped' children ile ağaç. single'da children ve yanındaki iki bayrak hiç okunmaz.",
+            clearable: 'Tüm seçimi temizleyen X düğmesi (varsayılan açık, yalnız seçim varken çizilir). Temizleme change yayar, ayrı bir olay yoktur.',
+            emptyText: 'Liste boşken gösterilen metin; boş bırakılırsa arayüz dilinden gelen "sonuç yok" metni kullanılır.',
+            placeholder: 'Hiç seçim yokken kutuda duran metin; aynı zamanda yükleniyor satırının metnidir.',
+            searchText: "Gizli durum prop'u: bileşen OKUMAZ, `search` olayıyla yazar. Uzak aramada sorguyu akışta self.searchText ile oku.",
+            isLoading: 'Uzak arama/doldurma sürerken akıştan açılır; alan kilitlenmez, yalnız spinner ve yükleniyor satırı çizilir.'
+        }
+    },
+    'tag-input': {
+        summary: 'Etiket listesi girişi; value etiket dizisidir, renkli etiket destekler.',
+        behavior: [
+            'value bir DİZİdir: [{ value, color? }]. Akıştan gelen liste çizilmeden önce SÜZÜLÜR: null giriş, metin olmayan ya da boş value düşer, aynı etiket (kırpılmış+küçük harf ölçüsüyle) ikinci kez gelirse ilk geçen bütünüyle kalır. Geçen giriş DEĞİŞTİRİLMEZ — kırpılmaz ve fazladan alanları atılmaz, yani veri kaynağından gelen ek alanlar change ile geri yazılırken korunur. Düz metin dizisi de geçerlidir: ["billing","critical"] renksiz iki etiket çizer (tags tablo hücresiyle aynı süzme).',
+            'Kullanıcı listede olmayan metni Enter ile ya da listenin sonundaki "oluştur" satırıyla etikete çevirir; strict:true bunu kapatır ve yalnız options içindeki etiketler eklenebilir (metin kutuda kalır, sessizce silinmez). strict YAPIŞTIRMAYI da kapsar: çok parçalı bir yapıştırmada eşleşmeyen parçalar düşer.',
+            "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)."
+        ],
+        propNotes: {
+            value: 'Seçili etiketler: [{ value, color? }]. Renk hex (#rrggbb); verilmezse etiket gri çizilir.',
+            options: '[{ value, color?, isDisabled? }] — kullanıcıya önerilen hazır etiketler; akışla doldurulacaksa setter hedefi budur.',
+            colors: "Yeni etikete verilebilecek hazır renk paleti ([{ color }]). Palet ayrıca options ve value üstündeki renklerle zenginleşir; kullanıcı HSV seçiciyle palet dışı renk de verebilir.",
+            strict: 'Serbest metni kapatır: yalnız options içindeki etiketler eklenebilir (yazarak da yapıştırarak da), "oluştur" satırı çizilmez.',
+            clearable: 'Alanın sağındaki × düğmesi (hepsini siler). Varsayılan AÇIK.',
+            createNewLabel: 'Listede olmayan metin yazılınca çıkan "oluştur" satırının başındaki metin; satır bu metni ve tırnak içinde yazılanı gösterir.',
+            debounce: "Yalnız akış tabanlı search'i geciktirir (ms); yerel süzme senkrondur ve debounce'u yok sayar. Etiket seçilince bekleyen arama iptal edilir.",
+            searchText: "Gizli durum prop'u: bileşen OKUMAZ, `search` olayıyla YAZAR. Uzak aramada sorguyu akışta self.searchText ile oku.",
+            autofocus: 'Sayfa açılınca odak metin kutusuna gelir (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.'
+        }
+    },
+    textinput: {
+        summary: 'Tek satır metin girişi; value prop’u yazılabilir, change olayı { value } taşır.',
+        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."
+        ],
+        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:(###) ###-####').",
+            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.",
+            showCounter: "Alanın altında sağa dayalı sayaç: maxChars varsa '12/40', yoksa '12'.",
+            autofocus: 'Sayfa açılınca odak bu alana gelir (kilitli alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isLoading: "Alanı dondurur (readonly, gri değil) ve sağda dönen spinner çizer (× gizlenir, olay yayılmaz); changed'e bağlı sorgu sürerken aç, tamamlanınca kapat."
+        }
+    },
+    textarea: {
+        summary: 'Çok satırlı metin girişi; textinput ile aynı olay sözleşmesi (enter hariç — Enter satır ekler).',
+        behavior: [
+            "change HER TUŞTA, changed değer kesinleşince (blur) yayılır — pahalı akışı changed'e bağla.",
+            "autoGrow:true (varsayılan) kutuyu içerikle büyütür: minLines/maxLines sınırlar; minLines yoksa lines taban satır sayısı olur (panelde gizli olsa da). autoGrow:false sabit lines yüksekliği, fazlası kaydırılır."
+        ],
+        propNotes: {
+            maxChars: "SERT sınır (tarayıcı maxlength): fazlası yazılamaz. Akıştan gelen daha uzun değer aynen gösterilir (sayaç 45/40 okur). validations.maxLength'ten FARKLIDIR: o yalnız doğrular. 0/boş = sınırsız.",
+            showCounter: "Kutunun altında sağa dayalı sayaç: maxChars varsa '12/40', yoksa '12'.",
+            autofocus: 'Sayfa açılınca odak bu alana gelir (dondurulmuş alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isLoading: "Alanı dondurur (readonly, gri değil) ve sağ üstte spinner çizer; changed'e bağlı sorgu sürerken aç, tamamlanınca kapat."
+        }
+    },
+    texteditor: {
+        summary: 'Zengin metin editörü (Quill); value HTML string, change her tuşta / changed odak çıkışında yayılır.',
+        behavior: [
+            "change HER TUŞTA yayılır (zengin metinde her karakter bir akış koşusu demektir); değer odak çıkışında kesinleşince changed yayılır — sorgu ya da kayıt gibi pahalı akışı changed'e bağla.",
+            'BOŞ editör boş metin yayar: Quill kullanıcı içeriği sildiğinde <p><br></p> tutar, bileşen bunu akışa boş metin olarak yazar ki validations.required ("değer doluysa geç") gerçekten düşsün.',
+            "isDisabled, isReadonly ve isViewmode üçü de editörü GERÇEKTEN kilitler (2026-09-11 düzeltmesi; öncesinde readonly/viewmode yalnız CSS sınıfıydı ve alan yazmaya açık kalıyordu). isViewmode ayrıca toolbar'ı gizler ve çerçeveyi kaldırır — salt okuma gösterimi budur.",
+            'Kilitliyken bile akıştan gelen value yazılır; kilit yalnız kullanıcının klavyesini kapatır.'
+        ],
+        propNotes: {
+            value: 'HTML string. Salt gösterim için HTML ya da Text bileşeni de kullanılabilir; burada saklanan biçimlendirmenin kendisidir.',
+            placeholder: 'Yalnız editör boşken çizilir (Quill kendi .ql-blank kapısını kullanır). Biçimlendirilmiş içerik girildiği anda kaybolur.',
+            autofocus: 'Sayfa açılınca imleç editörün içine gelir (kilitli/yükleniyor editörde ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            size: "Etiketin ve editör gövdesinin ölçüsü: sm | md | lg; boş bırakılırsa temanın form ölçüsü kullanılır.",
+            isLoading: "Editörü kapatır (zengin metinde tık iptali yok, Quill'in kendi kapısı kullanılır) ama disabled görünümünü almaz: alan soluklaşır, etiketin yanında spinner döner ve alan aria-busy taşır.",
+            style: "Alt yuvalar: &__label · &__container (editör gövdesi) · &__description · &__error. Toolbar yuvası YOKTUR — Quill onu kabın dışına, kardeş düğüm olarak çizer."
+        }
     },
-    'tag-input': { summary: 'Etiket listesi girişi; value etiket dizisidir, renkli etiket destekler.' },
-    textinput: { summary: 'Tek satır metin girişi; value prop’u yazılabilir, change olayı { value } taşır.' },
-    textarea: { summary: 'Çok satırlı metin girişi.' },
-    texteditor: { summary: 'Zengin metin editörü; onChange değeri HTML string’dir. Olay adları istisnadır: onMount/onChange (on önekli).' },
     numberinput: {
-        summary: 'Sayı girişi; change olayı number taşır.',
+        summary: 'Sayı girişi; value number, change her tuşta / changed kesinleşince { value: number } taşır.',
+        behavior: [
+            "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."
+        ],
         propNotes: {
-            prefix: "Girdinin içinde SOLDA çizilen salt görsel ek (₺, $ gibi); value'ya karışmaz.",
-            suffix: "Girdinin içinde SAĞDA çizilen salt görsel ek (%, kg gibi); value'ya karışmaz.",
-            useThousandsSeparator: "Binlik ayracı YALNIZ ondalık (metin) modda çalışır — allowDemicalPoints kapalıyken native number girişi ayraç gösteremez, prop sessizce etkisizdir. Odakta ayraçlar soyulur, blur'da yeniden gruplanır; ayraç yerelden gelir (tr: 1.250,50 / en: 1,250.50)."
+            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.",
+            suffix: "Girdinin içinde SAĞDA çizilen salt görsel ek (%, kg gibi); value'ya karışmaz. Viewmode'da da çizilir — değerin anlamını taşır.",
+            prefixIcon: "Alanın içinde en solda çizilen salt görsel ikon ({ name: 'payments' }); prefix metni ikonun sağında durur. value'ya karışmaz. Viewmode'da çizilmez (metin eklerinin aksine).",
+            suffixIcon: "Alanın içinde sağda, suffix metninin sağında ve artı/eksi düğmelerinin solunda çizilen ikon; yükleniyor spinner'ı onun sağına gelir. Viewmode'da çizilmez.",
+            useThousandsSeparator: "Binlik ayracı YALNIZ ondalık (metin) modda çalışır — allowDemicalPoints kapalıyken native number girişi ayraç gösteremez, prop sessizce etkisizdir. Odakta ayraçlar soyulur, blur'da yeniden gruplanır; ayraç yerelden gelir (tr: 1.250,50 / en: 1,250.50).",
+            autofocus: 'Sayfa açılınca odak bu alana gelir (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isLoading: "Alanı dondurur (readonly, gri değil; artı/eksi pasif, olay yayılmaz) ve sağda dönen spinner çizer; changed'e bağlı sorgu sürerken aç, tamamlanınca kapat."
         }
     },
     incrementalinput: { summary: 'Otomatik kod üretici (önek + ayraç + sayaç); bir sonraki kodu runtime’da çeker.' },
-    password: { summary: 'Parola girişi; textinput ile aynı olay sözleşmesi.' },
-    checkbox: { summary: 'İki durumlu kutu; change/checked/unchecked olayları boolean taşır.' },
-    switch: { summary: 'Anahtar; checkbox ile aynı sözleşme, görsel fark.' },
-    radio: { summary: 'Tek seçim düğme grubu; change seçilen değeri taşır.' },
-    datepicker: { summary: 'Tarih seçici; change yükü { value, HH, mm }.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
-    datetimepicker: { summary: 'Tarih+saat seçici; değer event.data’da değil self.value’dadır.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
-    daterangepicker: { summary: 'Tarih aralığı; change yükü { valueFrom, valueTo, HH, mm }.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
-    datetimerangepicker: { summary: 'Tarih+saat aralığı; daterangepicker ile aynı yük.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
+    password: {
+        summary: 'Parola girişi; karakterleri maskeler, sağdaki göz düğmesi geçici olarak açar. Olay sözleşmesi textinput ile aynı.',
+        behavior: [
+            "change HER TUŞTA, changed değer kesinleşince (blur/Enter) yayılır — giriş denemesi gibi pahalı akışı changed'e ya da enter'a bağla, change'e değil.",
+            "enter yalnız Enter'da yayılır; alan bir form içindeyse Enter aynı anda formun submit akışını da tetikler — girişi forma bağla, enter'a bağlarsan iki kez çalışır.",
+            "Parola alan alanı gösterir ama okumaz: value akışa düz metin gider, log ve bildirime yazma.",
+            "'Parola tekrar' gibi alanlar arası kural Form component'inin Custom Validations alanında tanımlanır; alanın kendi validations bloğu (required/minLength/maxLength/pattern) tek alanı doğrular."
+        ],
+        propNotes: {
+            revealable: 'Sağdaki göz düğmesini çizer (varsayılan açık); kapatılırsa parola hiçbir şekilde gösterilemez. Alan kilitlenince ya da isLoading açılınca açık olan parola kendiliğinden yeniden maskelenir.',
+            prefixIcon: "Alanın İÇİNDE solda çizilen salt görsel ikon ({ name: 'lock' }); value'ya karışmaz.",
+            suffixIcon: 'Alanın içinde sağda, spinner ve göz düğmesinin solunda çizilen ikon.',
+            maxChars: "SERT sınır (tarayıcı maxlength): fazlası YAZILAMAZ. Akıştan gelen daha uzun değer aynen gösterilir. validations.maxLength'ten FARKLIDIR: o yalnız doğrular. 0/boş = sınırsız.",
+            showCounter: "Alanın altında sağa dayalı sayaç: maxChars varsa '12/40', yoksa '12'. Parola UZUNLUĞUNU ekranda gösterir — PIN gibi sabit uzunluklu alanlarda aç.",
+            autofill: "Tarayıcı/parola yöneticisi davranışı: 'off' (varsayılan, doldurma yok), 'current-password' (giriş ekranı — kayıtlı parolayı doldurur), 'new-password' (parola belirleme/değiştirme — kaydetmeyi ve üretmeyi önerir). Giriş ekranı kuruyorsan current-password ver, yoksa tarayıcı alanı doldurmaz.",
+            autofocus: 'Sayfa açılınca odak bu alana gelir (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isLoading: "Alanı dondurur (readonly, gri değil; göz düğmesi pasif, olay yayılmaz) ve sağda dönen spinner çizer; giriş isteği sürerken aç, yanıt gelince kapat.",
+            isViewmode: 'Salt okunur düz metin görünümü: göz düğmesi ve ikonlar çizilmez, değer maskeli kalır.'
+        }
+    },
+    checkbox: {
+        summary: 'Tek bir seçeneği işaretleten iki durumlu kutu; değeri boolean, change/checked/unchecked olayları aynı tıkta yayılır.',
+        behavior: [
+            'Bir tık İKİ olay yayar: önce change, sonra yeni duruma göre checked ya da unchecked. Üçü de setter’dır (self.value yazılır) — kaydı yalnız BİRİNE bağla, yoksa akış iki kez koşar. checked/unchecked yalnız "işaretlenince şunu yap" gibi tek yönlü işler için vardır.',
+            '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.'
+        ],
+        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.",
+            isIndeterminate: 'Üçüncü (belirsiz) durum: kutu ne işaretli ne boş, içinde çizgi çizilir — "alt seçeneklerin bir kısmı seçili" demektir. value’yu DEĞİŞTİRMEZ, yalnız görünümü değiştirir ve HTML gereği işaretli durumu görsel olarak bastırır. Kullanıcı kutuya tıkladığı anda tarayıcı bu durumu kendisi düşürür; bileşen her render turunda prop’u DOM’a yeniden yazdığı için akış aynı değeri geri hesapladığında çizgi geri gelir (seç-tümü kutusunu her seçim değişiminde yeniden hesapla).',
+            isLoading: 'Kutuyu dondurur (tık iptal edilir, olay yayılmaz) ama GRİLEŞTİRMEZ ve `disabled` YAPMAZ — kilit kipi değildir: odak ve tab sırası korunur, alan `aria-busy` ile "meşgul" duyurulur. Etiketin yanında dönen bir spinner çizilir; change’e bağlı kayıt sürerken aç, yanıt gelince kapat. Kilitli bir alanda spinner yine çizilir ama kutu kilit görünümünde kalır.',
+            autofocus: 'Sayfa açılınca odak bu kutuya gelir (kilitli/yükleniyor kutuda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isViewmode: 'Salt okunur görünüm: kutu çerçevesiz/zeminsiz kalır, işaretliyse tık görünür, tıklanamaz.',
+            value: 'Kutunun işaretli olup olmadığı (boolean). Akıştan yazılınca kutu yansıtır; kullanıcı değiştirince change setter’ı geri yazar.'
+        }
+    },
+    switch: {
+        summary: 'Anahtar; iki durumlu boolean değer, checkbox ile AYNI sözleşme (change/checked/unchecked + mount + focus/blur, üç değer olayı da setter).',
+        behavior: [
+            'Bir flip İKİ olay yayar: önce change, sonra yeni duruma göre checked ya da unchecked. Üçü de setter’dır (self.value yazılır) — kaydı yalnız BİRİNE bağla, yoksa akış iki kez koşar.',
+            'Kilitli (isDisabled/isReadonly/isViewmode) ya da isLoading olan anahtar 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 (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.'
+        ],
+        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.",
+            isLoading: 'Anahtarı dondurur (tık iptal edilir, olay yayılmaz) ama GRİLEŞTİRMEZ ve `disabled` YAPMAZ — kilit kipi değildir: odak ve tab sırası korunur, alan `aria-busy` ile "meşgul" duyurulur. Anahtarla etiketin arasında dönen bir spinner çizilir; change’e bağlı kayıt sürerken aç, yanıt gelince kapat.',
+            autofocus: 'Sayfa açılınca odak bu anahtara gelir (kilitli/yükleniyor anahtarda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isViewmode: 'Salt okunur görünüm: kol sönük çerçeveyle çizilir, açıksa açık görünür, tıklanamaz.',
+            value: 'Anahtarın açık olup olmadığı (boolean). Akıştan yazılınca anahtar yansıtır; kullanıcı değiştirince change setter’ı geri yazar.'
+        }
+    },
+    radio: {
+        summary: 'Tek seçim düğme grubu; change seçilen değeri taşır.',
+        behavior: [
+            'change YALNIZ seçilen değer gerçekten değişince yayılır (aynı seçeneğe tekrar tıklamak olay üretmez) ve setter’dır — self.value yazılır.',
+            'Zorunluluk prop değil, Form’un doğrulama listesinden gelir (`required`). radio’nun TEK doğrulama kuralı odur — panel boolean tipinin listesini çizer, desen/uzunluk kuralı yoktur.',
+            'radio’da isReadonly ve isViewmode YOKTUR — standart giriş sözleşmesinin üç kilidinden yalnız isDisabled var. Salt okunur gösterim gerekiyorsa başka bir bileşen kullan.',
+            'focus/blur olayı da yoktur (checkbox/checkboxgroup’tan farkı).'
+        ],
+        propNotes: {
+            options: '[{ label, value }]; tek seçim, gruplama native name üzerinden — ok tuşlarıyla gezinti tarayıcınındır.',
+            autofocus: 'Sayfa açılınca odak gruba gelir (kilitli/yükleniyor grupta ve tasarım kanvasında çalışmaz). Grubun tek alanı olmadığı için odak ilk kilitsiz seçeneğe düşer. Sayfada tek alana ver.',
+            isLoading: 'Grubu KİLİTLER (checkboxgroup deseni): seçenek listesi soluklaşır, tık yutulur, change yayılmaz ve grup aria-busy taşır; etiketin yanında dönen spinner çizilir. Seçenekleri getiren sorgu sürerken aç, gelince kapat.'
+        }
+    },
+    datepicker: {
+        summary: 'Tarih seçici; change yükü { value, HH, mm }.',
+        behavior: [
+            "Kutu salt okunurdur (elle yazma çift tıkla açılır) ama programdan gelen change'i DİNLER: page_screenshot 'set' ile ISO tarih ('2026-08-01') ya da gösterim biçimi yazılabilir, değer takvimden seçilmiş gibi yayılır. 2026-09-15 öncesi olay dinlenmiyordu: kutu dolu görünüyor, prop boş kalıyordu (G-14)."
+        ],
+        propNotes: { value: DATE_VALUE_FORMAT_NOTE, locale: LOCALE_FOLLOWS_APP_NOTE }
+    },
+    datetimepicker: { summary: 'Tarih+saat seçici; değer event.data’da değil self.value’dadır.', propNotes: { value: DATE_VALUE_FORMAT_NOTE, locale: LOCALE_FOLLOWS_APP_NOTE } },
+    daterangepicker: {
+        summary: 'Tarih aralığı; change yükü { valueFrom, valueTo, HH, mm }.',
+        behavior: [
+            "İki kutu ayrı adreslenir: '<elementId>__start' (valueFrom) ve '<elementId>__end' (valueTo). page_screenshot 'set' kökü REDDEDER (tek değer yok); kutuya ISO tarih ('2026-08-01') ya da gösterim biçimi ('1 Ağu 2026') yazılır, kutu değeri kendi change yoluna sokar ve prop'a yazar. Okunamayan metin kutuyu tutulan değere geri çevirir; actionsReport propWritten:false döner (G-14, 2026-09-15)."
+        ],
+        propNotes: { valueFrom: DATE_VALUE_FORMAT_NOTE, valueTo: DATE_VALUE_FORMAT_NOTE, locale: LOCALE_FOLLOWS_APP_NOTE }
+    },
+    datetimerangepicker: {
+        summary: 'Tarih+saat aralığı: değer valueFrom/valueTo İKİLİSİDİR (tek value yok); her yarı bir takvim + dakika adımlı saat listesi; change yükü { valueFrom, valueTo }.',
+        behavior: [
+            "İki uç da YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok) ya da null. change her iki anahtarı birden taşır ve düğümün prop'una yazar: akış self.valueFrom / self.valueTo ile okur. Form aralığı { valueFrom, valueTo } nesnesi olarak görür; required ancak İKİSİ de doluyken geçer.",
+            "Bir yarının değeri ancak TARİH + SAAT ikisi de seçilince yazılır: takvimden yalnız gün seçmek change YAYMAZ — gün ekranda taslak olarak kalır (kutu günü ve 00:00'ı gösterir, CQ-237), günü yeniden seçmek de, diğer yarıyı tamamlamak da o taslağı YAZMAZ; saat listesi kendiliğinden açılır ve saat seçilince yayılır (tek datetimepicker ile aynı kural). Yarı zaten bir değer tutuyorsa (kullanıcı seçmiş ya da akış yazmış) tarihi değiştirmek TUTULAN saati koruyup hemen yayar — 2026-09-12'de düzeltildi, öncesinde listeden saat seçildikten sonra tarih değişikliği ekranda görünüp değere hiç yazılmıyordu. Akıştan gelen değer taslağı düşürür.",
+            "Saat listeleri minutesStep adımıyla o yarının GÜNÜ üstünde üretilir; minDate/maxDate DIŞI ve karşı ucun ÖTESİNDEKİ saatler (başlangıç için bitişten sonrası, bitiş için başlangıçtan öncesi) listede KALIR ama pasiftir. Takvimler de karşılıklı sınırlanır: bitiş takvimi başlangıç gününden önceye, başlangıç takvimi bitiş gününden sonraya izin vermez.",
+            "Yayma öncesi sarmalayıcı sınırlar: her uç [minDate, maxDate] içine çekilir, bitiş başlangıçtan önce kalırsa bitiş başlangıca eşitlenir. Sınır dışı bir seçim hata VERMEZ, sınıra yapışır. Akıştan yazılan değerler bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            "Doğrulama kuralları: required · min · max (2026-09-12; pattern bildirimi kaldırıldı — panel tarih-saat alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu). min/max değeri 'yyyy-MM-ddTHH:mm' tarih-saat metnidir ve Form aralığın İKİ ucunu da sınırla karşılaştırır.",
+            "focus/blur ALAN düzeyindedir (2026-09-12): iki tarih girdisi, iki saat girdisi, takvim ve saat listesi arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.",
+            "isLoading KİLİT DEĞİLDİR (2026-09-12): alan odaklanabilir kalır, sağ uçta dönen spinner çizilir, kök aria-busy taşır (478px altındaki dikey yığılmada spinner çizilmez, aria-busy kalır). Kilit için isDisabled kullan.",
+            "Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri olduğu gibi). İkisini birden boşaltmanın yolu iki X ya da akıştan iki prop'u null yazmaktır.",
+            "Gösterim dili locale'den (boşsa uygulama dili): tarih tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'; saat en'de 12 saat (01:00 PM), diğer dillerde 24 saat. Değer her dilde aynı 24 saatlik metindir. Biçim prop'u YOK (ARC-071).",
+            "Tarih kutuları '<elementId>__start' / '<elementId>__end' ile adreslenir (G-14, 2026-09-15). page_screenshot 'set' kökü reddeder; kutuya ISO tarih yazmak takvimden gün seçmekle AYNI kuraldır: yarı değer tutmuyorsa yalnız taslak olur ve propWritten:false döner — saat kutusu ayrıca hedeflenemez, önce akıştan değer yazın ya da saati tıklamayla seçin."
+        ],
+        propNotes: {
+            valueFrom: "Başlangıç: 'yyyy-MM-ddTHH:mm:ss' ya da null. Akıştan yazarken bu biçimi (ya da Date'in okuduğu bir ISO metnini) kullan; okunamayan metin yarıyı BOŞ gösterir, hata vermez.",
+            valueTo: "Bitiş; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı yalnız kullanıcı seçiminde uygulanır.",
+            minutesStep: "Saat listelerinin adımı, METİN enum: '1' | '2' | '3' | '4' | '5' | '6' | '10' | '12' | '15' | '30' | '60' (varsayılan '15'). 0, negatif ya da okunamayan değer 15'e düşer; 1 dakika 1440 satır demektir.",
+            minDate: "En erken tarih-saat ('yyyy-MM-ddTHH:mm:ss'); öncesi takvimde ve saat listesinde pasif kalır, yine de sınır dışına düşen seçim sınıra çekilir.",
+            maxDate: 'En geç tarih-saat; sonrası pasif, sınır dışı seçim sınıra çekilir.',
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez.',
+            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3): kullanıcının gördüğü saat seçtiği saattir, saklanan değer sabit kalır.',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
+        }
+    },
     fileUpload: { summary: 'Sürükle-bırak dosya yükleme (dropzone); seçim self.value’dan okunur.' },
     fileInput: { summary: 'Dosya seç girişi; change yükü { value: [{ type, value }], fileName }.' },
     filebutton: { summary: 'Buton görünümlü dosya seçici; fileInput ile aynı yük.' },
@@ -387,7 +635,7 @@ export const componentKnowledge = {
         summary: 'Sayfa içi geri bildirim kutusu; akışlarda alert adımı yerine bu komponent kullanılır.',
         behavior: [
             "isHidden 2026-08-26'dan beri bu komponentin ŞEMASINDA VARDIR (daha önce yoktu ve bu katalog bir dönem 'unknown-prop verir' diyordu): props.isHidden'ı doğrudan şemaya yazabilirsin, başlangıçta gizli bildirim için container'a sarmak GEREKMEZ.",
-            "appearance.isHidden bir çözüm DEĞİLDİR: kaydedilir ama runtime hiçbir yerde okumaz (renderer yalnız props.isHidden'a bakar).",
+            "Görünürlük yalnız props.isHidden'dır: appearance'ta isHidden alanı YOKTUR (2026-09-15'te platformdan kaldırıldı, S-16). Gövdeye appearance.isHidden konursa gateway onu props.isHidden'a taşır ve gatewayNormalized'da bildirir.",
             "Kendini KAPATIRKEN props.isHidden'a yazar: hem timeout dolduğunda hem kapatma düğmesinde 'toggled' emit'i { isHidden: true } taşır (Notification.svelte handleEvent). Şema events sözlüğünde bu ad YOKTUR — akışa bağlanacak bir olay değil, prop'a geri yazma yoludur.",
             'Başlangıçta gizli bir bildirim: şemaya props.isHidden:true yaz, açılışı akıştaki setter ile yap; timeout verilirse kendini kapatır.'
         ],
@@ -449,6 +697,7 @@ export const componentKnowledge = {
         ],
         propNotes: {
             surfaceStyle: NODE_SURFACE_NOTE,
+            navigationStyle: NAVIGATION_STYLE_NOTE,
             activeHref: "Vurgulanacak menü satırının adresi; boşken adres çubuğu karar verir (sidebar ile aynı davranış). YENİ prop — platform kataloğuna CI senkronuyla iner.",
             layout: "'flex' (katalog varsayılanı; akış) | 'grid' (12 kolonluk ızgara). Prop hiç yazılmamışsa renderer IZGARA çizer. Diğer altı yerleşim prop'u yalnız 'flex' iken etkilidir; anlamları container kaydındakiyle birebir aynı."
         }
@@ -459,14 +708,15 @@ export const componentKnowledge = {
             'Ağacı layout ve sidebar ile ORTAK renderer çizer (Navigations/NavigationsItem) — üçünün menü davranışı birebir aynıdır; ayrıntı sidebar kaydında.',
             "Öğe bazlı isHidden BU şemada VARDIR: canlıda elenir, Studio'nun düzenleyici kipinde görünmeye devam eder (Navigations.svelte: {#if isEditorMode || item.isHidden !== true}).",
             "activeHref boşken menü tarayıcıdaki adrese uyan satırı kendi bulur; adres mount'ta BİR KEZ okunur (bağlantılar tam sayfa yükler).",
-            "style PROP'U ÖLÜDÜR: şema &__item ve &__item--active parçalarını sunuyor ama Navigations.svelte style diye bir prop KABUL ETMİYOR (yalnız navigations ve activeHref alır) ve satırları NavigationsItem kendi scoped .nav-btn sınıfıyla çizer. Panelden yazılan hiçbir şey uygulanmaz — sidebar'daki aynı kusurun ikizi (zeyrek-frontend docs/issues.md CQ-143 / CQ-132).",
+            "Satır görünümü TİPLİ navigationStyle grubuyla verilir (2026-09-15, layout ile aynı grup); serbest style'ın &__item, &__item--active ve &__icon parçaları da artık gerçek elemanlara basılır ve gruptan SONRA gelir (son söz).",
             'Menü olay YAYMAZ (şemada yalnız mount); gezinme ham <a href> ile tam sayfa yükleyerek olur.'
         ],
         propNotes: {
             navigations: "Ağaç: { title, href, icon, isHidden, isExpandable, isExpanded, children }. href düz metin ya da bağlantı seçicisinin nesnesi ({ type:'page', data, ref }) olabilir; ikisini de getHref çözer.",
             activeHref: 'Vurgulanacak satırın adresi; boş bırakılırsa tarayıcıdaki adres karar verir.',
             isHidden: 'Komponentin tamamını gizler (ortak katman prop’u); öğe bazlı gizleme navigations[].isHidden’dır.',
-            style: 'ÖLÜ — hiçbir etkisi yok (bkz. davranış). Menü biçimini değiştirmek bugün mümkün değil.'
+            navigationStyle: NAVIGATION_STYLE_NOTE,
+            style: "Kaçış kanalı: &__item (her satır), &__item--active (seçili satır), &__icon (satır ikonu). Önce navigationStyle'ı kullan; burada yalnız grubun karşılamadığı CSS yazılır."
         }
     },
     'layout-shell': {
@@ -505,7 +755,8 @@ export const componentKnowledge = {
         summary: 'Layout’ta sayfa içeriğinin yerleştiği delik — slot’suz layout’a bağlanan sayfa BOŞ görünür.',
         behavior: [
             "Layout'ta TEK slot olmalı. Enjeksiyon HER slot'a ayrı ayrı kopyalar (layout.functions.ts injectPageSchemaIntoSlots ağacı dolaşır ve type==='slot' gören her düğümün children'ına sayfa şemasının klonunu yazar; önizleme tarafında page.mappers.mapPageLayoutToPreview aynısını yapar): iki slot = sayfa iki kez çizilir, elementId'ler çakışır. Doğrulama: page_state.layoutSlots.",
-            "Slot'un yerleşimi ızgara bloğundan gelir ve satır yüksekliği AÇIK UÇLUDUR — runtime slot için grid-row'u `y / auto` yazar (render.functions.ts), yani sayfa içeriği ne kadar uzarsa slot o kadar uzar. Slot'a sabit yükseklik vermeye çalışmak anlamsızdır."
+            "Slot'un yerleşimi ızgara bloğundan gelir ve satır yüksekliği AÇIK UÇLUDUR — runtime slot için grid-row'u `y / auto` yazar (render.functions.ts), yani sayfa içeriği ne kadar uzarsa slot o kadar uzar. Slot'a sabit yükseklik vermeye çalışmak anlamsızdır.",
+            "Blok boyu yine de katalog sınırının içinde kalmalı: maxSize.h 200 (2026-09-12'den önce 80'di ve katalog varsayılanı 110 bile sınırın dışındaydı). Sınırı aşan TEK blok bütün yerleşimi/sayfayı PageSchemaValidationException + `invalid-size` ile düşürür."
         ]
     },
     view: { summary: 'Tabs/switcher altındaki görünüm kapsayıcısı; children gruplamaya yarar.' },
@@ -538,17 +789,30 @@ export const componentKnowledge = {
         summary: "Öneri listeli SERBEST METİN girişi. dropdown'dan farkı: value seçilen option'ın değeri değil, KULLANICININ YAZDIĞI metindir.",
         behavior: [
             "Öneriler iki kaynaktan gelir: statik options prop'u yerel olarak süzülür; komponente search olayına akış bağlıysa liste akıştan geldiği gibi gösterilir (dropdown deseninin aynısı).",
-            "Seçilen option'ın ID'sine ihtiyacın varsa select olayını dinle: value prop'una ETİKET yazılır, id yalnız select yükünde gelir.",
+            "Seçilen option'ın ID'sine ihtiyacın varsa select olayını dinle: alanın value'suna ETİKET yazılır, option'ın kendi değeri yalnız select yükünde gelir. Yük 2026-09-11'de { value, label } iken { selectedValue, selectedLabel } oldu ve akışta self.selectedValue / self.selectedLabel ile okunur — eski adlar alanın KENDİ value ve label prop'larını eziyordu (seçim yapılınca kutuda option'ın değeri beliriyor, alanın etiketi de option'ın metnine dönüyordu). select'e bağlı eski akışlar yeni adlarla güncellenmeli.",
             "strict:true serbest metni bulanıklaştırmaz, blur'da eşleşmeyen metni BOŞALTIR — şehir/ülke gibi yalnız geçerli değer isteyen alanlar içindir.",
-            "debounce yalnız akış tabanlı search'i geciktirir; yerel süzme senkrondur ve debounce'u yok sayar."
+            "debounce yalnız akış tabanlı search'i geciktirir; yerel süzme senkrondur ve debounce'u yok sayar. Öneri seçilince ya da alan temizlenince bekleyen arama iptal edilir.",
+            "minChars hem listeyi hem İSTEĞİ geciktirir (2026-09-11): eşiğin altında akışa search GİTMEZ. Eşik 0 olduğu sürece davranış değişmez.",
+            "Liste ne zaman açılırsa açılsın (openOnFocus dahil) GÖSTERDİĞİ öneriler yazılan metne göre süzülür; eşiğin altında ham tüm liste gösterilmez.",
+            "Temizleme (×) ve strict geri alma change olayını { value: '', selectedValue: '', selectedLabel: '' } ile yayar: alan boşalınca seçim durumu da boşalır. Seçimin ÜSTÜNE serbest metin yazmak ise selectedValue/selectedLabel'ı sıfırlamaz — o ikisi 'kullanıcının listeden en son seçtiği şey'dir, value'nun türevi değil.",
+            "Olaylar: mount (render katmanı atar) · change (her tuş vuruşu, setter) · select · search · enter · focus · blur. focus ve blur KİLİTLİ alanda (isDisabled/isReadonly/isViewmode) yayılmaz — ikisi de aynı muhafızın arkasında, yani eşleşmeyen bir focus gelmez.",
+            "isViewmode alanı düz metne çevirir: kenarlık, zemin ve ikonlar çizilmez, liste açılmaz (textinput/password ile aynı görünüm kuralı)."
         ],
         propNotes: {
             value: "Yazılan metin (change her tuş vuruşunda yayılır). Option değeri DEĞİLDİR.",
             options: '[{ label, value, caption?, icon? }] — akışla doldurulacaksa setter hedefi budur.',
-            minChars: 'Liste bu karakter sayısından önce açılmaz (openOnFocus zaten açtıysa yok sayılır).',
-            openOnFocus: 'Odakta mevcut options listesini gösterir; YENİ bir search tetiklemez.',
+            minChars: 'Liste bu karakter sayısından önce açılmaz ve akışa search gönderilmez (openOnFocus listeyi yine de açar, ama arama yine gitmez).',
+            openOnFocus: 'Odakta mevcut options listesini (yazılan metne göre süzülmüş hâliyle) gösterir; YENİ bir search tetiklemez.',
             strict: 'Blur’da options ile eşleşmeyen metni siler.',
-            maxSuggestions: 'Listede gösterilecek azami öneri (iki modda da geçerli).'
+            maxSuggestions: 'Listede gösterilecek azami öneri (iki modda da geçerli).',
+            emptyText: 'Sonuç yokken listede duran metin; boş bırakılırsa arayüz dilinden gelen "sonuç bulunamadı" metni kullanılır.',
+            loadingText: 'isLoading açıkken listede duran metin; boş bırakılırsa arayüz dilinden gelen "yükleniyor" metni kullanılır.',
+            prefixIcon: "Alanın İÇİNDE solda çizilen salt görsel ikon ({ name: 'search' }); value'ya karışmaz. Viewmode'da hiç çizilmez.",
+            suffixIcon: "Alanın içinde sağda çizilen ikon; temizle düğmesinin sağında durur. Viewmode'da hiç çizilmez.",
+            autofocus: 'Sayfa açılınca odak bu alana gelir (kilitli alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            searchText: "Gizli durum prop'u: bileşen OKUMAZ, `search` olayıyla yazar. Uzak aramada sorguyu akışta self.searchText ile oku.",
+            selectedValue: "Gizli durum prop'u: `select` seçilen option'ın DEĞERİNİ buraya yazar. Yalnız kullanıcı öneriye tıklayınca/Enter'layınca dolar; serbest metin yazmak burayı güncellemez, yani value ile eşleşmesi garanti değildir.",
+            selectedLabel: "Gizli durum prop'u: `select` seçilen option'ın METNİNİ buraya yazar (aynı anda value'ya da yazılır). Adı `label` olamaz, alanın kendi etiketini ezerdi."
         }
     },
     avatar: {
@@ -618,6 +882,7 @@ export const componentKnowledge = {
             categoryField: 'Kategori ekseni alan adı (varsayılan "label").',
             series: "[{ valueField, type?, axis?, color?, stack?, lowField/highField?, targetField? }] — yFields'ın yerini aldı.",
             stackMode: 'none | stacked | percent.',
+            dataLabels: "{ show, position, content, showTotal }. showTotal YALNIZ stackMode:'stacked' iken iş görür: her yığının tepesine (yatayda sağına) dilimlerin toplamını yazar, valueFormat uygulanır; toplam EKSENE ve LEGEND'e GİRMEZ. 2026-09-15 düzeltmesi — öncesinde toplam şeffaf bir seri olarak yığına ekleniyordu: değer ekseni gerçek en yüksek yığının İKİ KATINA çıkıyor, toplam etiketi barın çok üstünde boşlukta duruyor ve legend'de '<grup>__total' diye dördüncü bir madde beliriyordu (S-18). percent modunda etkisizdir.",
             isDrillDown: 'Veri noktası tıklamasını kırıntı seviyesine çevirir; sorguyu akış yeniler.'
         }
     },
@@ -625,11 +890,23 @@ export const componentKnowledge = {
         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).',
-            "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ı)."
+            "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).',
+            'Seç-tümü YALNIZ seçilebilir seçenekleri hareket ettirir: options[].isDisabled olan bir seçenek akıştan işaretli geldiyse öyle kalır, temizlemede de elenmez. Kutu üç durumludur; bir kısmı seçiliyken tik değil ÇİZGİ çizer.',
+            'Sayacın (showCounter) paydası SEÇENEK SAYISIDIR, Max items değil — bileşen kendi doğrulama değerlerini göremez (CQ-093), yani "2/5" beş seçenekten ikisi demektir.',
+            'Dört kilit de (isDisabled · isReadonly · isViewmode · isLoading) tıkı yutar, change yaymaz ve focus/blur’u susturur. isDisabled dışındakiler kutuyu odaklanabilir bırakır (textinput deseni); salt okunur soluk zeminle, görüntüleme kipi zeminsiz kutuyla ayrışır.'
         ],
         propNotes: {
-            value: 'string[] — akıştan gelen dizide string olmayan öğeler elenir.',
-            options: '[{ label, value }]; direction ile dikey/yatay dizilir.'
+            value: 'string[] — akıştan gelen dizide string olmayan öğeler elenir; dizi olmayan bir değer boş liste sayılır.',
+            options: '[{ label, value, caption, icon, isDisabled }] — caption ikinci satıra küçük punto ile, icon kutunun sağına çizilir (dropdown/multi-select ile aynı alan adları). Diziliş direction/columnCount’tan gelir.',
+            columnCount: '0 = ızgara yok (diziliş direction’dan gelir), 1..4 = eşit sütunlu ızgara ve direction panelde GİZLENİR. Sayı bir ÜST SINIRDIR: hücre dar olduğunda sütun sayısı taşmak yerine kendiliğinden düşer.',
+            showSelectAll: 'Listenin üstüne hepsini seçen/temizleyen kutuyu koyar; metni selectAllText’tir (yalnız bu açıkken panelde görünür).',
+            showCounter: 'Listenin üstünde "seçili/toplam" sayacı çizer; payda seçenek sayısıdır.',
+            emptyText: 'Seçenek listesi boşken yazılan metin (varsayılan "No options yet"); boş bırakılırsa o durumda hiçbir şey çizilmez. Seç-tümü/sayaç şeridinin çizilmemesi ise emptyText’e DEĞİL, listenin boş olmasına bağlıdır — seçilecek/sayılacak bir şey yoktur.',
+            variant: 'default = kutu + metin; card = her seçenek çerçeveli kart, işaretli olanın kenarlığı vurgulanır (caption/ikon kullanılan listelerde okunur).',
+            isLoading: 'Grubu KİLİTLER: liste soluklaşır, tık yutulur, change yayılmaz ve grup aria-busy taşır. Seçenekleri getiren sorgu sürerken aç, gelince kapat.',
+            autofocus: 'Sayfa açılınca odak gruba gelir (kilitli/yükleniyor grupta ve tasarım kanvasında çalışmaz). Grubun tek alanı olmadığı için odak ilk kilitsiz kutuya düşer: seç-tümü çiziliyse o, yoksa ilk seçenek. Sayfada tek alana ver.'
         }
     },
     emptystate: {
@@ -708,12 +985,18 @@ export const componentKnowledge = {
         behavior: [
             'Bütün kutular dolduğunda change’e EK olarak complete olayı yayılır — doğrulama akışını buna bağla.',
             "resend yalnız resendSeconds>0 iken görünen düğmeden gelir ve geri sayım bitmeden tıklanamaz; tetiklenince kendi geri sayımını yeniden başlatır.",
-            "focus/blur GRUP düzeyindedir (checkboxgroup deseniyle aynı): kutular arasında Tab'lamak olay üretmez, yalnız gruba giriş/çıkışta bir kez yayılır."
+            "focus/blur GRUP düzeyindedir (checkboxgroup deseniyle aynı): kutular arasında Tab'lamak olay üretmez, yalnız gruba giriş/çıkışta bir kez yayılır.",
+            'change ve complete yalnız değer GERÇEKTEN değiştiğinde yayılır: reddedilen bir tuş (numeric alanda harf), boş alanda backspace ya da aynı kodun yeniden yapıştırılması hiçbir olay üretmez. Yani complete kenar tetiklidir — complete’e bağlanan doğrulama akışı tek kod için iki kez koşmaz.',
+            'Bunun bedeli: alan doluyken complete bir daha yayılmaz, yani AYNI kod yeniden denenemez. Doğrulama başarısız olan akış value’yu boşaltmalı (change setter olduğu için düğümün value’suna yazmak yeter); yoksa kullanıcı kutuları elle silmeden yeni bir deneme tetikleyemez.',
+            'Dört kilit ayrı davranır: yalnız isDisabled alanı Tab sırasından düşürür. isReadonly/isViewmode/isLoading alanı odaklanabilir bırakır (kutular arası ok tuşuyla gezinme açıktır) ama değiştirmeyi kapatır; isViewmode ayrıca “kodu tekrar gönder” düğmesini hiç çizmez.'
         ],
         propNotes: {
-            value: 'Birleşik string; ortadaki kutu silinince sonraki haneler sola kayar.',
+            value: 'Birleşik string; ortadaki kutu silinince sonraki haneler sola kayar. Backspace dolu kutuyu yerinde siler, boş kutuda bir geri adım atar; Delete her zaman bulunduğu kutuyu siler.',
             digitCount: '2–12 arası kutu sayısı.',
-            isMasked: 'Haneleri nokta olarak gösterir.'
+            isMasked: 'Haneleri nokta olarak gösterir.',
+            isReadonly: 'Kutular kendi zeminini alır (okunur tonu) ve yazma kapanır; alan odaklanabilir kalır.',
+            isViewmode: 'Alan düz metne iner — kutu çerçevesi ve zemini çizilmez, resend düğmesi görünmez.',
+            autofocus: 'Sayfa açılınca odak İLK kutuya gelir; yazdıkça kutular kendiliğinden ilerler (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.'
         }
     },
     pagination: {
@@ -745,9 +1028,13 @@ 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 (tek bir role=\"slider\" kapsayıcıda dinlenir), yıldız başına değil."
+            "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."
         ],
-        propNotes: { value: '0..max arası sayı; akıştan gelen değer bu aralığa kırpılır.' }
+        propNotes: {
+            value: '0..max arası sayı; akıştan gelen değer bu aralığa kırpılır.',
+            isViewmode: 'isReadonly ile AYNI sonucu verir: puan kilitlenir, imleç düz kalır, odak alınmaz. Yıldızın zemini olmadığı için ikisini ayıran görsel bir fark yoktur (zemine dayanan checkbox/checkboxgroup ayrımı burada uygulanamaz); "yasak" imleci yalnız isDisabled ile çıkar. Kilitli olduğunu söylemek yetiyorsa ikisinden birini seç, ekranda fark aranmasın.',
+            autofocus: 'Sayfa açılınca odak yıldız şeridine gelir — şerit tek tab durağıdır, tek tek yıldızlar odak almaz (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.'
+        }
     },
     result: {
         summary: 'Durum bloğu (success/error/warning/info): büyük ikon + başlık + alt başlık + aksiyonlar — işlem sonucu ekranları için.',
@@ -757,11 +1044,14 @@ export const componentKnowledge = {
         summary: 'minValue–maxValue arasında sayısal kaydırıcı (tek değer; iki tutamaklı aralık YOKTUR).',
         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."
+            "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.'
         ],
         propNotes: {
-            value: 'Sayı; akıştan gelen değer [minValue, maxValue] aralığına kırpılır (0 geçerli sınırdır).',
-            showTicks: 'datalist ile çentik gösterir (yalnız ≤50 çentikte).'
+            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.',
+            step: '0/negatif → 1. Ondalık adımda (0.5) gösterilen sayının basamak sayısı adımdan türer; valueFormat.decimals yazılıysa o kazanır.',
+            showTicks: 'datalist ile çentik gösterir (yalnız ≤50 çentikte).',
+            autofocus: 'Sayfa açılınca odak kaydırıcıya gelir (kilitli/yükleniyor alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.'
         }
     },
     statcard: {
@@ -780,9 +1070,24 @@ export const componentKnowledge = {
     switcher: {
         summary: 'İki durumu YAN YANA gösteren boolean kontrol (switch’in kolu yerine iki segment); aktif olan vurgulanır.',
         behavior: [
-            'Olay sözleşmesi switch ile aynıdır: change · checked · unchecked, hepsi boolean taşır.',
-            'Yan etiket (label) ve description YOKTUR — içerik iki segmentin kendi trueLabel/trueIcon ve falseLabel/falseIcon alanlarıdır.'
-        ]
+            'Olay sözleşmesi switch ile aynıdır: change · checked · unchecked + mount + focus/blur; üç değer olayı da boolean taşır ve setter’dır — kaydı yalnız BİRİNE bağla, yoksa akış iki kez koşar.',
+            'Alan etiketi (label) ve description 2026-09-11’de EKLENDİ ve boş doğar: yazılırsa etiket track’in ÜSTÜNDE, açıklama ALTINDA çizilir. Segmentlerin kendi metni ayrıdır (trueLabel/trueIcon · falseLabel/falseIcon) — "Aylık / Yıllık" segmentlere, "Fatura dönemi" label’a yazılır. isInvalid açıkken açıklamanın yerini invalidText alır.',
+            'Kilitli (isDisabled/isReadonly/isViewmode) ya da isLoading olan kontrol hiçbir DEĞER olayı yaymaz; focus/blur de susar. `mount` bunun dışındadır: onu bileşen değil render katmanı atar, kilitli kontrolde de yayılır.',
+            '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).'
+        ],
+        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.',
+            description: 'Track’in altındaki yardım metni; isInvalid açıkken yerini invalidText alır (ikisi aynı anda çizilmez).',
+            value: 'Hangi segmentin seçili olduğu (boolean; true = sağdaki/trueLabel segmenti). Akıştan yazılınca kontrol yansıtır, kullanıcı değiştirince change setter’ı geri yazar.',
+            trueLabel: 'Sağdaki (true) segmentin metni; varsayılan "On". trueIcon ile birlikte ya da tek başına kullanılır — ikisi de boşsa segment boş bir kutu olarak çizilir.',
+            falseLabel: 'Soldaki (false) segmentin metni; varsayılan "Off". falseIcon ile birlikte ya da tek başına kullanılır.',
+            autofocus: 'Sayfa açılınca odak bu kontrole gelir (kilitli/yükleniyor kontrolde ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
+            isViewmode: 'Salt okunur görünüm: vurgu sönük renge düşer, seçili segment seçili görünür, tıklanamaz.',
+            isLoading: 'Kontrolü dondurur (tık iptal edilir, olay yayılmaz) ama GRİLEŞTİRMEZ ve `disabled` YAPMAZ — kilit kipi değildir: odak ve tab sırası korunur, alan `aria-busy` taşır. Track’in sağında dönen spinner çizilir.'
+        }
     },
     'theme-toggle': {
         summary: 'Uygulamayı açık/koyu temaya çeviren tek düğme; tercih tarayıcıda kalıcıdır. Olay YAYMAZ.',
@@ -813,9 +1118,25 @@ export const componentKnowledge = {
         summary: 'Bağımsız saat seçici; değer tam olarak HH:mm biçimindedir.',
         behavior: [
             'minTime/maxTime dışındaki seçenekler listeden ATILMAZ, pasifleştirilir; minutesStep seçenek adımını belirler.',
-            "focus/blur GRUP düzeyindedir: paylaşılan Select kendi focus'unu yayar ama blur'ü yok, o yüzden ikisi de kapsayıcı üstünden köklendi — checkboxgroup/otpinput/slider ile aynı desen."
+            "Liste adımdan ÜRETİLİR, ama alanın TUTTUĞU saat adıma düşmese bile listede kalır (2026-09-11): minutesStep=15 iken 09:07 kendi yerine eklenir ve kutuda görünür. Öncesinde eşleşen seçenek olmadığı için alan BOŞ görünüyordu — veritabanından gelen saatlerin olağan hâli. Şart, değerin KATI 'HH:mm' olmasıdır: '9:07' ya da '09:07:00' hiçbir seçenekle eşleşmez ve kutu yine boş kalır.",
+            "change yükü { value, selectedLabel } taşır ve ikisi de düğümün prop'una yazılır: akışta self.value ve self.selectedLabel ile okunur. selectedLabel 2026-09-11'de eklendi — 12h kipinde etiket '01:00 PM' iken value '13:00' kalır, gösterilen metnin tek kaynağı budur. Temizleme (X) de change yayar, ikisi de boş metin olur.",
+            "isLoading KİLİT DEĞİLDİR (2026-09-11): alan odaklanabilir kalır, kök aria-busy taşır ve açık liste yükleniyor satırını gösterir. Öncesinde isLoading alanı disabled yapıyordu; ortak Select'i kullanan üç bileşenden en son bu düzeltildi. Tek şart: liste KAPALIYKEN isLoading açıksa chevron'a tıklamak listeyi açmaz (metin alanına tıklamak ve klavye açar) — ortak Select'in kuralı.",
+            "focus/blur GRUP düzeyindedir: paylaşılan Select kendi focus'unu yayar ama blur'ü yok, o yüzden ikisi de kapsayıcı üstünden köklendi — checkboxgroup/otpinput/slider ile aynı desen. Alanın kendi kromuna (chevron, X) basmak artık SAHTE blur yaymaz: sarmalayıcı mousedown'ı iptal edip odağı alanda tutuyor, yani blur yalnız alan gerçekten terk edilince gelir. (Odaksız alanda chevron'a basmak listeyi açar ve normal focus'unu yayar.)",
+            'Doğrulama kuralları: required · min · max (2026-09-11; pattern bildirimi kaldırıldı — panel saat alanına regex kuralı hiç çizmiyor, yazılan satırı düğüm seçilince siliyordu). min/max değerleri de HH:mm metnidir ve saniye taşıyan bir değer karşılaştırmadan sessizce düşer (CQ-095).',
+            'format YALNIZ GÖSTERİMDİR: 12h etiketleri 01:00 PM biçiminde çizer, saklanan value her iki kipte de HH:mm kalır. Liste içi arama DEĞERİ değil ETİKETİ arar, yani 12h kipinde "13" yazmak saat 13:00\'ü BULMAZ (etiketi "01:00 PM"), "01" bulur.'
         ],
-        propNotes: { value: "'HH:mm' — Time doğrulamaları ve formun saat karşılaştırmaları bu biçimi bekler." }
+        propNotes: {
+            value: "'HH:mm' — Time doğrulamaları ve formun saat karşılaştırmaları bu biçimi bekler. Adıma düşmeyen bir saat de gösterilir (listeye kendi yerinde eklenir); biçimi bozuk bir değer gösterilmez, kutu boş görünür.",
+            minutesStep: "Liste adımı, METİN enum: '1' | '5' | '10' | '15' | '30' | '60'. 1 dakika 1440 satır demektir.",
+            minTime: "Bu saatten öncesi listede KALIR ama seçilemez. Serbest metin alanı, bağışlayıcı okunur: '9', '9:00', '9.00', '0900' hepsi 09:00'dır; okunamayan metin sınır KOYMAZ (sessizce sınırsız).",
+            maxTime: 'Bu saatten sonrası listede kalır ama seçilemez; minTime ile aynı bağışlayıcı okuma.',
+            disabledTimes: "[{ time: 'HH:mm' }] — aralığın içinde olsalar bile seçilemeyen saatler. Okunamayan satır hiçbir saati engellemez. Zaten seçili olan bir saati engellemek onu TEMİZLEMEZ: alan değeri pasif hâlde tutmayı sürdürür, gerekiyorsa akıştan boşalt.",
+            clearable: 'Seçili saatin yanındaki X (varsayılan açık). Temizleme change yayar, ayrı bir olay yoktur.',
+            emptyText: 'Liste içinde arama hiçbir saati bulamayınca yazılacak metin; boş bırakılırsa arayüz dilinden gelen "sonuç yok" metni kullanılır.',
+            format: "'24h' (varsayılan) | '12h'. Yalnız etiketleri değiştirir; tarih/saat bileşenleri 24 saatlik gösterime sabit olduğu için aynı sayfada ikisi ayrışır (CQ-098).",
+            selectedLabel: "Gizli durum prop'u: `change` seçilen saatin GÖSTERİLEN metnini buraya yazar (temizlemede boş metin). Yalnız kullanıcı seçimiyle dolar — value'yu akıştan yazmak burayı GÜNCELLEMEZ.",
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
+        }
     },
     toast: {
         summary: 'Geçici bildirim TETİKLEYİCİSİ: sayfada yer kaplamaz (0×0), isOpen true’ya çekildiğinde bir toast atar.',
@@ -866,13 +1187,14 @@ export const componentKnowledge = {
             "Sürükleyerek taşıma yalnız isEditable ile: ay görünümünde gün kayar (saat korunur), hafta/gün kolonunda saat 30 dakikaya yuvarlanır; tüm-gün etkinlik saat KAZANMAZ. Yeniden boyutlandırma (resize) yoktur.",
             "Süresi >=24 saat ya da 00:00→00:00 olan etkinlik 'tüm gün' sayılır ve saat ızgarası yerine üst şeride çizilir; çok günlü etkinlik ay görünümünde kapladığı HER güne ayrı çip düşer (sürekli bant yok).",
             "defaultDate ve defaultView yalnız İLK kurulumda okunur — sonradan prop değişse de takvim kımıldamaz.",
-            "Hafta başlangıcı yerele bağlıdır (tr Pazartesi, en Pazar); startHour/endHour saat penceresini belirler, pencereye kısmen taşan blok en az 15 dakikalık yükseklikle çizilir."
+            "Hafta başlangıcı yerele bağlıdır (tr Pazartesi, en Pazar); startHour/endHour saat penceresini belirler, pencereye kısmen taşan blok en az 15 dakikalık yükseklikle çizilir.",
+            "Etkinlik her görünümde <elementId>__event-<id> data-element-id'si taşır; bırakma hedefleri ay hücresi ve hafta/gün kolonu <elementId>__day-<yyyy-MM-dd>, tüm gün hücresi __allday-<yyyy-MM-dd>, saat dilimi __slot-<yyyy-MM-dd>T<HH> (YEREL tarih). eventClick 'click' ile, eventMove page_screenshot actions 'drag' (target etkinlik, to gün/slot) ile doğrulanır; slota bırakma o saatin ortasına düşer ve 30 dakikaya yuvarlanır. Çok günlü etkinlik aynı kimliği her gününde taşır, hedef ilk eşleşmedir."
         ],
         propNotes: {
             rows: 'Etkinlik satırları; mount/monthChange akışlarının setter hedefi. Alan adları titleField/startField/endField/colorField/idField ile çözülür (nokta ayraçlı iç içe yol çalışır).',
             colorField: "Geçerli CSS rengi olduğu gibi kullanılır, semantik durum adı tema değişkenine çözülür, tanınmayan değer accent'e düşer. 'info' beyaz temada görünmezdir — ham renk ver.",
             maxVisibleEvents: 'Ay hücresinde görünen çip sayısı (varsayılan 3); fazlası +n olur.',
-            defaultDate: "Açılış ayı (yyyy-MM-dd; katalog varsayılanı örnek veriyle aynı ay olan '2026-08-01'). YALNIZ ilk kurulumda okunur.",
+            defaultDate: "Açılış ayı (yyyy-MM-dd ya da ISO tarih-saat; katalog varsayılanı örnek veriyle aynı ay olan '2026-08-01'). YALNIZ ilk kurulumda okunur. BOŞ bırakılırsa bugünün ayı açılır — 'bugün' için sabit tarih yazmayın. İfadeyle bağlanacaksa code prop'u '{{ }}' içinde yazılır: { type: 'code', ref: \"{{ new Date().toISOString().slice(0, 10) }}\" } — parantezsiz ifade metin olarak gelir (PAGE-032 reddeder). Bu iki biçim dışındaki her metin bugüne düşer.",
             startHour: 'Hafta/gün görünümünün ilk saati (varsayılan 8); endHour en az startHour+1 olacak biçimde kırpılır (varsayılan 18).'
         }
     },
@@ -901,7 +1223,8 @@ export const componentKnowledge = {
             "Kolon içi SIRALAMA yoktur: kartlar rows dizisinin sırasıyla çizilir, aynı kolona bırakma no-op'tur, sıra ne taşınır ne yayılır.",
             "wipLimit yalnız GÖRSELDİR: aşımda kolon başlığı kırmızılaşır ama bırakma engellenmez; 0/boş = sınırsız.",
             "Kart şablonu sabittir: başlığın ilk harfi (TR büyük harf) rozet + başlık + alt başlık — resim avatarı, etiket, tarih alanı yoktur. Renk karta sol şerit, kolona üst şerit olarak iner (ham CSS ya da semantik ad).",
-            "Sürükleme yerel HTML5 DnD'dir; klavyeyle taşıma yolu yoktur (Enter yalnız cardClick yayar). isLoading sürüklemeyi de kilitler."
+            "Sürükleme yerel HTML5 DnD'dir; klavyeyle taşıma yolu yoktur (Enter yalnız cardClick yayar). isLoading sürüklemeyi de kilitler.",
+            "Kart <elementId>__card-<id>, kolon <elementId>__col-<value> data-element-id'si taşır (id = idField değeri, yoksa card-<sıra>): cardClick page_screenshot actions 'click' ile, cardMove 'drag' (target kart, to kolon) ile uçtan uca doğrulanır — actionsReport flowRuns/requests taşımanın akışı gerçekten koşturduğunu gösterir."
         ],
         propNotes: {
             rows: 'Kart satırları; alan adları columnField/titleField/subtitleField/idField/colorField ile çözülür (nokta ayraçlı iç içe yol çalışır).',
@@ -914,15 +1237,20 @@ export const componentKnowledge = {
         behavior: [
             "change her tamamlanan ÇİZGİDE (pointer bırakılınca) yayılır, hareket sırasında değil; value hem self.value'ya yazılır (setter) hem event.data.value ile gelir. Temizleme önce change('') sonra clear (veri taşımaz) yayar.",
             "outputFormat 'png' (varsayılan) base64 data-URL üretir; 'svg' HAM SVG işaretlemesi döner (data-URL DEĞİL) — kaydederken/gömerken ayrımı gözet. PNG üretimi başarısız olursa sessizce SVG metnine düşer.",
-            "Mevcut value yeniden düzenlemeye YÜKLENMEZ: data:image… ya da <svg ile başlayan değer arka planda resim olarak gösterilir, ilk yeni çizgi onu tamamen değiştirir — ekleme/undo yoktur.",
+            "Mevcut value yeniden düzenlemeye VEKTÖR olarak yüklenmez: data:image… ya da <svg ile başlayan değer arka planda resim olarak gösterilir, ilk yeni çizgi onu tamamen değiştirir — ekleme/undo yoktur. Tanınmayan metin hiç çizilmez.",
+            "DIŞARIDAN yazılan value pedi sıfırlar: akış setter'ı value'yu '' yaparsa çizim ekrandan da silinir, başka bir imza yazarsa o arka plana geçer. Bileşenin kendi yazdığı değerin yankısı dış yazma sayılmaz, yani imza her vuruşta süpürülmez. Akıştan temizlemenin yolu budur; ayrı bir clear aksiyonu yoktur.",
+            "outputFormat / penColor / penWidth değişince EKRANDAKİ vuruşlar yeni ayarlarla yeniden dışa aktarılır ve change yayılır — panelden biçimi çevirmek değeri de çevirir. Vuruşu olmayan kayıtlı value yeniden üretilemez, ona dokunulmaz.",
             "Yeniden boyutlanma çizimi silmez ama mürekkep sol üst köşeye çapalı kalır (ölçeklenmez); bir sonraki çizgi güncel boyutla dışa aktarır.",
-            "Zorunluluk formun validations'ıyla kurulur (şemada isRequired yoktur). Ekran rengi penColor || tema metni, dışa aktarım rengi penColor || #111111 — tema değişkeni dışa aktarıma taşınmaz.",
+            "Zorunluluk formun validations'ıyla kurulur (şemada isRequired yoktur). Ekran rengi penColor || tema metni, dışa aktarım rengi penColor || #111111 — tema değişkeni dışa aktarıma taşınmaz, yani koyu temada ekranda açık görünen mürekkep koyu olarak dışa aktarılır.",
             "isDisabled/isReadonly/isViewmode üçü de kilitler; kilitliyken Clear düğmesi hiç çizilmez."
         ],
         propNotes: {
             value: "İmza string'i (PNG data-URL ya da SVG işaretlemesi); boş imza ''dir, null değil.",
+            placeholder: "Boş pedin ortasındaki çağrı metni ('İmzanızı buraya atın'); yazılmazsa ✒️ simgesi çizilir. Yalnız ped boşken ve kayıtlı imza yokken görünür.",
             outputFormat: "'png' | 'svg' — svg dışındaki her değer png sayılır.",
-            penWidth: "En az 1'e kırpılır; geçersiz değer 2'ye düşer."
+            penWidth: "En az 1'e kırpılır; geçersiz değer 2'ye düşer.",
+            size: "sm | md | lg; boş bırakılırsa temanın form ölçüsü. YALNIZ pedin kendi yazısını (placeholder ve Clear düğmesi) ve pedin TABAN yüksekliğini değiştirir; etiketin ve açıklama satırının puntosuna DOKUNMAZ (ikisi de ortak bileşen, kendi tokenlarını okur). Pedin gerçek yüksekliğini kanvastaki düğüm belirler.",
+            clearText: "Clear düğmesinin metni; boşsa 'Clear'. Düğme yalnız değer varken ve alan kilitli değilken çizilir."
         }
     },
     stepper: {
@@ -1022,7 +1350,26 @@ export const INTERNAL_ROLES_BY_TYPE = {
         'pager-refresh',
         "sort-<kolon slug'ı>",
         'colmenu',
+        'search (arama kutusu, isSearchable)',
         'row-<0 tabanlı sıra; sayfa değişince yeniden numaralanır>'
+    ],
+    kanban: [
+        "card-<kart id'si (idField; yoksa card-<sıra>)>",
+        "col-<kolon value'su> (bırakma hedefi)"
+    ],
+    eventcalendar: [
+        "event-<etkinlik id'si (idField; yoksa event-<sıra>)>",
+        'day-<yyyy-MM-dd> (ay hücresi / hafta-gün kolonu, bırakma hedefi)',
+        'allday-<yyyy-MM-dd> (tüm gün hücresi, bırakma hedefi)',
+        'slot-<yyyy-MM-dd>T<HH> (saat dilimi, bırakma hedefi)'
+    ],
+    daterangepicker: [
+        'start (başlangıç tarihi kutusu, valueFrom)',
+        'end (bitiş tarihi kutusu, valueTo)'
+    ],
+    datetimerangepicker: [
+        'start (başlangıç tarihi kutusu, valueFrom)',
+        'end (bitiş tarihi kutusu, valueTo)'
     ]
 };
 /** Hedefteki `__` ayracından sonrası bir iç roldür; gateway bulunamayan hedefte listeyi basar. */