@appaflytech/zeyrek-ai-mcp 0.0.1

package/dist/knowledge/componentCatalog.js

@@ -0,0 +1,438 @@
+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.',
+        guide: 'html',
+        behavior: [
+            "content `{{` içeriyorsa Mustache şablonu olarak context prop'uyla render edilir; şablon hatasında ham içerik basılır (sayfa ölmez).",
+            "Flow'dan HTML'e veri DÖNER: setter adımı context prop'una yazınca içerik otomatik yeniden render olur — dinamik gösterimin doğru yolu budur.",
+            "HTML içinden flow tetikleme: actions dizisine { key, text, flow } satırı ekle, HTML'de fireEvent('<key>', {...}) çağır. Flow'da event.name = key, event.data = ikinci argüman.",
+            "Satır içi <script> etiketleri çalışır ve içerik her değiştiğinde yeniden çalışır; script gövdesinde komponent-bağlı fireEvent / onCleanup(fn) / loadScript(url) yerelleri hazırdır.",
+            "<script src=...> bilinçli olarak YÜKLENMEZ (öznitelik kopyalanmaz) — harici kütüphane loadScript(url) ile çekilir (Promise döner, url bazında tekilleştirir).",
+            "Script'ler flow ifade bağlamına (Page, Steps, komponent adları) erişemez; köprü yalnız fireEvent (dışarı) ve context (içeri).",
+            "Şema olayı yalnız mount'tur; aksiyonlar set_event ile DEĞİL kendi flow prop'uyla bağlanır (type:'flow', ref:<flowId>)."
+        ],
+        propNotes: {
+            content: "Ham HTML ya da Mustache şablonu. type:'code' + {{ }} ifadesiyle dinamik de beslenebilir.",
+            context: 'Mustache değişken sözlüğü (nesne). Setter ile yazmak içeriği yeniden render eder.',
+            style: "emotion css() bloğu: iç seçiciler ve &:hover çalışır, üretilen sınıf komponente scope'ludur.",
+            actions: "[{ key, text, flow }] — key fireEvent adıdır (text'ten snake üretilir), flow çalıştırılacak akıştır."
+        }
+    },
+    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.',
+        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.',
+            "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)."
+        ],
+        propNotes: {
+            rows: 'Satır dizisi; mount/filter/sort/pagination akışlarının setter adımıyla doldurulur.',
+            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: "Kolon tanımları; mapping anahtarları kolonların name'iyle birebir eşleşmeli.",
+            isEditable: 'Hücre içi düzenleme; değişen satır rowChange olayında self.rows üzerinde güncellenir.'
+        }
+    },
+    datatable: {
+        summary: 'Kendi filtre paneli/sıralaması/sayfalaması İÇİNDE olan tablo: tek mount akışı yazılır, komponent etkileşimde prop’larını güncelleyip mount’u yeniden tetikler.',
+        behavior: [
+            "Tek olay yayması tasarımdır: kullanıcı süzünce/sıralayınca filters/sortField/sortType/offset prop'larını node'a yazar ve mount'u yeniden tetikler — akış bu prop'ları uca parametre geçirir. Yani mount/filter/sort/pagination için AYRI akışlar kurmak gerekmez (table'da gerekir).",
+            'Zengin kolon biçimlendirme (renk haritası, prefix/suffix, tarih formatı, avatar) kolon şemasındadır; satır seçimi/çift tık YOKTUR — gerekiyorsa table kullan.',
+            "Liste→form geçişi satır AKSİYONUYLA kurulur: actions:[{ text, kind, icon, flow:{ type:'flow', ref:<flowId> } }]. doubleClick/select bağlamak 200 döner ama bağ ölüdür (gateway PAGE-008 keser).",
+            "Aksiyona tıklanınca komponent ÖNCE tıklanan satırı kendi selectedRow prop'una yazar, SONRA akışı çalıştırır (Table.svelte:72 setNode + onEmit) — akışta satır '<elementId>.selectedRow.<alan>' ile okunur. selectedRow katalogda hidden'dır; setter ile yazılmaz, komponent doldurur."
+        ],
+        propNotes: {
+            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."
+        }
+    },
+    form: {
+        summary: "Alanları saran kapsayıcı; submit olayı yayar ve doğrulama hatalarını errorElementId'deki form-validation-errors komponentinde toplar.",
+        behavior: [
+            "Düzen prop'ları (layout/direction/gap/horizontalAlign…) YOKTUR — onlar container'a aittir. Form çocukları ızgara koordinatıyla (blocks[].position + size.w) dizilir; 'layout' yazmak unknown-prop ile reddedilir.",
+            "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."
+        ],
+        propNotes: {
+            errorElementId: "Sayfadaki form-validation-errors komponentinin elementId'si — bağlanmazsa alan doğrulama mesajları görünmez."
+        }
+    },
+    container: {
+        summary: "Genel kapsayıcı; children'ını ya FLEX akışıyla (yeni kapsayıcıların varsayılanı) ya da 12 kolonluk IZGARA ile dizer. Her sayfanın kökünde silinemeyen page_container bundandır ve o da aynı düzen prop'larını alır.",
+        behavior: [
+            "states.isWrapper:true iken salt düzen elemanıdır: title ve __header bloğu ÇİZİLMEZ — kart başlığı gerekiyorsa içine text komponenti koy (platform_guide('page') Bilinen sınırlar).",
+            "page_container'ın isLoading prop'u sayfa açılış akışının yükleniyor bayrağıdır.",
+            "layout:'flex' çocukları akışa alır (RenderComponent düzeni .ng-app__node-children sarmalına yazar): sıra blocks[].position'dan gelir (önce y, sonra x) ama y BOŞLUKLARI yok sayılır — flex'te dikey konum yalnız sıradır, ızgara koordinatı değil.",
+            "Flex çocuğun GENİŞLİĞİ yine 12 kolonluk blocks[].size.w'dur (row'da flex-basis w/12, column'da width w/12) — içerik genişliği DEĞİL. Yani ızgara↔flex geçişi kayıpsızdır ve genişlik şemadan kurulabilir.",
+            "Flex kapsayıcının yüksekliği içeriğinden gelir; verticalAlign'ın dağıtacak boşluğu olması için appearance.heightType:'fixed' + size.h vermek gerekir. İstisna: states.isWrapper:true olan page_container zaten min-height:80vh ile sayfa boyu durur, onda dikey hizalama boşluksuz da çalışır.",
+            "layout:'grid' iken diğer altı prop okunmaz — Studio panelinde de gizlenir. Katalogda tanımlı oldukları için doğrulama duvarı susar: ızgara kapsayıcıya direction yazmak sessizce hiçbir şey yapmaz (gateway PAGE-015 ile uyarır).",
+            "Katalog varsayılanı 2026-08-25'te grid → FLEX oldu ama varsayılan düğüm KURULURKEN props'a yazılır (Studio bırakma yolu definition.defaults'u kopyalar), renderer'da geriye dönük bir etkisi YOKTUR: layout prop'u hiç olmayan düğüm — bütün eski kayıtlar — ızgara çizilmeye devam eder. Yani şemayı sen kuruyorsan varsayılana güvenme, layout'u açıkça yaz."
+        ],
+        propNotes: {
+            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.",
+            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 → 0 / 8 / 16 / 32px. Ç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. Kapalıyken (varsayılan) satıra sığmayan çocuklar sıkışır, alt satıra inmez.",
+            title: "isWrapper:false kapta başlık çizer; page_container'da ise tarayıcı sekmesinin adını yazar (browserTitle).",
+            isLoading: 'Gövdeyi 100px’e kısar ve spinner gösterir; sayfa açılış akışında bayrak olarak kullanılır.'
+        }
+    },
+    repeater: {
+        summary: 'Kart listesi: rows dizisindeki her satır için children şablonunu yineler; satır bağlamı item/Row olarak çocuklara iner.',
+        propNotes: {
+            rows: 'Yinelenen veri; çocuk komponent ifadelerinde satıra item / Row ile erişilir.',
+            selectedIndex: 'change olayında seçilen kartın sırası.'
+        }
+    },
+    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)."]
+    },
+    drawer: {
+        summary: 'Yandan açılan katman; modal ile aynı kurallar: şema kökünde yaşar, kendi children ve akışlarını taşır.'
+    },
+    dropdown: {
+        summary: 'Tek seçim listesi; options statik verilebilir ya da mount/search akışıyla uzaktan doldurulur.',
+        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.'
+        }
+    },
+    'multi-select': {
+        summary: 'Aranabilir çoklu seçim; value bir değer dizisidir, search olayı sunucu taraflı arama kurmaya yarar.'
+    },
+    '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.' },
+    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 }.' },
+    datetimepicker: { summary: 'Tarih+saat seçici; değer event.data’da değil self.value’dadır.' },
+    daterangepicker: { summary: 'Tarih aralığı; change yükü { valueFrom, valueTo, HH, mm }.' },
+    datetimerangepicker: { summary: 'Tarih+saat aralığı; daterangepicker ile aynı yük.' },
+    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.' },
+    'file-viewer': { summary: 'Dosya önizleyici (pdf/görsel); file prop’una drive dosyası bağlanır.' },
+    button: { summary: 'Tıklama kaynağı; click olayı veri taşımaz, bağlam gerekiyorsa ifadede komponent adlarıyla okunur.' },
+    'dropdown-button': { summary: 'Menülü buton; clickItem olayı tıklanan menü öğesini taşır.' },
+    compound: { summary: 'İkincil metinli büyük buton (compound button); click yayar.' },
+    'confirm-bar': { summary: 'Satır içi onay şeridi; click olayı tıklanan buton tanımını taşır.' },
+    card: {
+        summary: 'Görsel + başlık + açıklama + buton metni taşıyan hazır KART; click yayar.',
+        behavior: [
+            "KAPSAYICI DEĞİLDİR: çocuk kabul etmez (not-droppable). Kutu içinde serbest içerik göstermek için container kullanın (istenirse states.isWrapper:true).",
+            'Yükseklik 10-50 aralığındadır (min 10, max 20 varsayılan, max 50); aralık dışı blocks[].size.h invalid-size ile reddedilir.'
+        ]
+    },
+    'qm-card': { summary: 'QM gösterge kartı; click yayar.' },
+    tabs: { summary: 'Sekmeler; tab olayı seçilen sekme anahtarını taşır, her view children sırasıyla eşleşir.' },
+    'collapsible-container': { summary: 'Aç/kapa kapsayıcı; collapsed/expanded olayları yayar.' },
+    'tree-view': {
+        summary: 'Hiyerarşik liste: data ağacını çizer, satır tıklamasını click olayıyla akışa verir, satır başına aksiyon menüsü ve isteğe bağlı istemci-tarafı arama taşır.',
+        behavior: [
+            "click yükü komponentin KENDİ prop'larına yazılır (onEmit → setNode): tıklanan satırın key'i self.selected'a, satırın TAMAMI self.currentItem'a — akışta ikisi de self ile okunur.",
+            'selected akıştan yazıldığında o düğüme giden dallar KENDİLİĞİNDEN açılır (yalnız açar; kullanıcının elle açtıklarını kapatmaz). Satır verisindeki isExpanded:true de kendi başına açar.',
+            "actions komponent düzeyinde BİR KEZ tanımlanır, her satır aynı menüyü çizer; bir satır farklılaşacaksa veri öğesine _actions dizisi konur ve SIRA numarasıyla şablonun üstüne biner (o satırda gizleme / etiket değiştirme).",
+            "Aksiyonlar set_event ile DEĞİL kendi flow prop'larıyla bağlanır (emptystate/html deseni); tıklanan satır akışa self.currentItem olarak geçer, ayrı bir şema olayı yayılmaz.",
+            'isSearchable:true arama kutusunu + tümünü aç/kapat düğmelerini açar. Süzme text ve subtle alanlarında geçer, eşleşenin ataları yerinde kalır, eşleşenin alt ağacı bütün görünür ve süzme sürerken dallar açık çizilir. Süzme İSTEMCİ tarafındadır: sunucuda arama gerekiyorsa kutuyu kapatıp kendi textinput + akış çiftini kur.',
+            'isLoading iskelet satır çizer; veri (ya da arama sonucu) boşsa emptyText basılır.',
+            'Satır ikonu icon > image > varsayılan klasör ikonu sırasıyla seçilir; satırdaki isHidden satırı hiç çizmez, isDisabled tıklamayı yutar.'
+        ],
+        propNotes: {
+            data: '[{ key, text, subtle, icon, image, isExpanded, isHidden, isDisabled, children[], _actions[] }] — key satırın kimliğidir, selected onunla eşleşir.',
+            selected: 'Seçili satırın key’i; setter ile dışarıdan da sürülebilir (o dala kadar ağaç açılır).',
+            currentItem: 'Gizli prop: son tıklanan / aksiyon alınan satırın tamamı.',
+            isSearchable: 'İstemci tarafı arama kutusu + tümünü aç/kapat araçları.',
+            searchPlaceholder: 'Arama kutusunun ipucu metni.',
+            emptyText: 'Veri ya da arama sonucu boşken basılan metin.',
+            actionsTitle: 'Aksiyon menüsünün başlığı.',
+            isActionsShowAlways: 'Aksiyon düğmesi sürekli görünür (varsayılan: satırın üstüne gelince).'
+        }
+    },
+    text: {
+        summary: 'Tek satırlık metin gösterimi; değer type:code prop’uyla ifadeye bağlanabilir.',
+        behavior: [
+            "Yükseklik SABİTTİR: maxSize.h = 1 (katalog varsayılanı 8'dir ve olduğu gibi kopyalanırsa reddedilir; gateway 1'e çeker ve gatewayNormalized ile bildirir). Çok satırlı metin için textarea ya da html kullanın."
+        ]
+    },
+    image: { summary: 'Görsel; click yayar, src ifadeyle beslenebilir.' },
+    video: { summary: 'Video oynatıcı; play/pause/ended olayları yayar.' },
+    qrcode: { summary: 'QR kod üretimi; value prop’undan çizer.' },
+    tags: { summary: 'Salt gösterim etiket listesi (tag-input’un okunur akrabası).' },
+    notification: {
+        summary: 'Sayfa içi geri bildirim kutusu; akışlarda alert adımı yerine bu komponent kullanılır.',
+        behavior: [
+            "isHidden bu komponentin KATALOĞUNDA YOKTUR: şemaya props.isHidden yazmak unknown-prop ile reddedilir (altın örnekte bir dönem yanlış duruyordu). Runtime'da gizleme çalışır — RenderComponent her komponentte props.isHidden'a bakar — ama prop'u oraya SETTER yazar, şema değil.",
+            "appearance.isHidden bir çözüm DEĞİLDİR: kaydedilir ama runtime hiçbir yerde okumaz (renderer yalnız props.isHidden'a bakar).",
+            'Başlangıçta gizli bir bildirim istiyorsanız komponenti şemada bırakın ve içeriğini/görünürlüğünü akıştaki setter ile yönetin; timeout verilirse kendini kapatır.'
+        ],
+        propNotes: {
+            kind: 'information | error | success | warning (buton kind sözlüğünden farklıdır: orada info/primary vardır)'
+        }
+    },
+    'form-validation-errors': { summary: 'Formun doğrulama hatalarını listeler; form.errorElementId buraya işaret eder.' },
+    breadcrumb: { summary: 'Sayfa yolu; currentTitle setter ile kip etiketine (Yeni/Düzenle) çevrilir.' },
+    'page-header': { summary: 'Sayfa başlığı bandı; yalnız mount yayar.' },
+    header: { summary: 'Uygulama üst çubuğu (layout parçası); navigation dizisi iç içe Prop sarmalı ister.' },
+    sidebar: { summary: 'Yan menü (layout parçası).' },
+    'auth-layout': { summary: 'Giriş ekranı kabuğu: logo kolonu + form slotu; primaryClick/secondaryClick olayları yayar.' },
+    layout: { summary: 'Layout kök komponenti; logout olayı yayar, sayfalar slot’una yerleşir.' },
+    slot: { summary: 'Layout’ta sayfa içeriğinin yerleştiği delik — slot’suz layout’a bağlanan sayfa BOŞ görünür.' },
+    view: { summary: 'Tabs/switcher altındaki görünüm kapsayıcısı; children gruplamaya yarar.' },
+    'widget-area': { summary: 'Widget’ların yerleştirildiği alan.' },
+    'audit-basic': { summary: 'Kayıt meta kutusu (oluşturan/güncelleyen); meta prop’u tek setter ile beslenir.' },
+    'audit-history': { summary: 'Kayıt geçmişi listesi.' },
+    'document-editor': { summary: 'Office şablon doldurma/görüntüleme editörü; file prop’una drive dosyası bağlanır.' },
+    'qm-header': { summary: 'QM uygulama başlığı: global arama, bildirimler, hesap menüsü, mega menü.' },
+    'qm-sidebar': { summary: 'QM yan menüsü.' },
+    'qm-content': { summary: 'QM içerik kapsayıcısı.' },
+    // — 2026-08-25 eşleme turu: ng-apps-ui kataloğunda olup burada kaydı olmayan 22 komponent.
+    // Kaynak: packages/ng-apps-ui/src/components/<ad>/{schema.ts,*.svelte,*-logic.ts} +
+    // zeyrek-frontend/docs/components/*.md davranış sözleşmeleri.
+    autocomplete: {
+        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.",
+            "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."
+        ],
+        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.',
+            strict: 'Blur’da options ile eşleşmeyen metni siler.',
+            maxSuggestions: 'Listede gösterilecek azami öneri (iki modda da geçerli).'
+        }
+    },
+    avatar: {
+        summary: 'Kullanıcı avatarı: src yoksa isimden baş harf üretir; items verilirse üst üste binen grup ve "+N" kuyruğu çizer.',
+        behavior: ["click olayı yalnız bağlıysa komponent tıklanabilir hâle gelir (image deseni)."],
+        propNotes: {
+            src: 'Görsel URL’i ya da drive dosyası; yüklenemezse baş harflere düşer.',
+            items: 'Grup kipi: her öğe kendi src/name’ini taşır, maxCount üstü "+N" olur.'
+        }
+    },
+    badge: {
+        summary: 'Sayaç/durum rozeti: maxCount üstü "99+" olur, 0 showZero verilmedikçe gizlenir, isDot ile salt nokta çizer. Olay YAYMAZ.',
+        behavior: [
+            'value SAYIYSA sayaç kuralları işler (0 gizlenir, maxCount aşılırsa "99+"); sayıya çevrilemeyen metin ("Yeni", "Beta") olduğu gibi basılır — durum rozeti böyle kurulur.',
+            'isDot:true iken value · icon · maxCount OKUNMAZ, yalnız renkli nokta çizilir; nokta tek başına anlam taşıyorsa dotLabel doldurulmalı (yoksa ekran okuyucuya aria-hidden geçilir).',
+            'isPulsing nabız animasyonu ekler ve prefers-reduced-motion açık kullanıcıda kendiliğinden durur.'
+        ],
+        propNotes: {
+            value: 'Sayı ya da metin; boş string rozeti tamamen gizler.',
+            icon: 'Metnin soluna küçük ikon; nokta kipinde çizilmez.',
+            dotLabel: 'Nokta kipinin erişilebilir etiketi (title + aria-label).',
+            isPulsing: 'Nabız animasyonu — canlı/bekleyen durum vurgusu.',
+            variant: 'solid | soft | outline — soft ve outline rengi metne taşır, zemini şeffaflaştırır.',
+            size: 'sm | md | lg — yalnız ölçü değişir, sayaç kuralları aynı kalır.'
+        }
+    },
+    'breadcrumb-title': {
+        summary: 'Kalın sayfa başlığı + önünde daralan kırıntı izi; eski mustache "doküman başlık" HTML widget’ının komponent karşılığı.',
+        behavior: [
+            "Son maxVisibleItems öğe satır içinde kalır, öncekiler '…' menüsüne toplanır (varsayılan 1; 0 = izin tamamı menüde).",
+            "Öğeye tıklamak önce öğenin KENDİ flow'unu çalıştırır, sonra clickItem yayar (dropdown-button sözleşmesi).",
+            'rootHref verilmişse kök ikonu ona gider ve rootFlow ÇALIŞMAZ — href akışı ezer.'
+        ],
+        propNotes: {
+            items: '[{ text, flow, isHidden }] — sıralı iz; isHidden olanlar sayımdan önce elenir.',
+            maxVisibleItems: 'Satır içinde kalacak öğe sayısı (varsayılan 1).'
+        }
+    },
+    carousel: {
+        summary: 'Ok/nokta/altyazı ve isteğe bağlı otomatik oynatmalı görsel slider.',
+        behavior: [
+            "activeIndex tek doğruluk kaynağıdır: her gezinme slideChange yayar ve indeksi komponentin kendi prop'una yazar; akıştan atanan aralık dışı değer SARILMAZ, son slayta kırpılır.",
+            'Slaytta href ya da flow varsa slayt tıklanabilir <a> olur; slideClick yükü tıklanan slaytı ve indeksini taşır.',
+            'autoplay + interval (saniye, en az 1) ve pauseOnHover birlikte çalışır; loop kapalıyken uçtaki ok pasifleşir.'
+        ],
+        propNotes: {
+            items: '[{ src, title, description, alt, href, flow }] — src drive dosyası ya da URL.',
+            activeIndex: 'Görünen slayt; setter ile dışarıdan da sürülebilir.',
+            fit: 'cover | contain | fill | none (card.imageFit ile aynı sözleşme).'
+        }
+    },
+    chart: {
+        summary: 'ECharts tabanlı grafik (bar/line/area/pie/donut + waterfall, histogram, pareto, bullet, tornado, radial). VERİ ÇEKMEZ: satırlar rows prop’una akışla yazılır.',
+        behavior: [
+            "Veri prop'u data DEĞİL rows'tur (data eski adıdır, yalnız geriye uyumluluk için duruyor). Kategori categoryField, değerler series[].valueField ile çözülür.",
+            'seriesField + valueField birlikte verilirse satırlar "kategori+seri başına bir satır" sayılıp geniş biçime pivotlanır; series dizisi o zaman prop’tan değil veriden türetilir.',
+            'aggregate/sort/topN/nullMode veriyi çizimden ÖNCE dönüştürür — aynı işi akışta yapmana gerek yok.',
+            'isDrillDown:true iken veri noktasına tıklamak kırıntı seviyesi ekler; dataPointClick yükü kaynak satırın TAMAMINI (row) taşır, böylece alt seviye sorgusu tek olayla kurulur. Geri dönüş breadcrumbClick ile bildirilir ve yeniden sorgulamak akışın işidir.',
+            'isExportable "tablo olarak gör" + dışa aktarma araç çubuğunu açar; showRefresh refresh olayını yayan bir yenile düğmesi ekler.'
+        ],
+        propNotes: {
+            rows: 'Satır dizisi; mount/filter akışlarının setter hedefi.',
+            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.',
+            isDrillDown: 'Veri noktası tıklamasını kırıntı seviyesine çevirir; sorguyu akış yeniler.'
+        }
+    },
+    checkboxgroup: {
+        summary: 'Değeri DİZİ olan çoklu kutu grubu (multi-select’in liste hâlinde açılmış hâli).',
+        behavior: ['Zorunluluk/en az-en çok seçim kuralları formun validations’ından gelir (required · minItems · maxItems).'],
+        propNotes: {
+            value: 'string[] — akıştan gelen dizide string olmayan öğeler elenir.',
+            options: '[{ label, value }]; direction ile dikey/yatay dizilir.'
+        }
+    },
+    emptystate: {
+        summary: 'Boş ekran/liste bloğu: görsel ya da ikon + başlık + açıklama + aksiyon düğmeleri.',
+        behavior: [
+            "actions[].flow doğrudan çalışır (emit'in flowId'si üzerinden) ve ayrıca actionClick yayılır — table'ın boş durum aksiyonlarıyla aynı sözleşme.",
+            'image verilirse icon ÇİZİLMEZ (görsel ikonu ezer); ikisi birden gösterilmez.',
+            'isDisabled aksiyon tıklamayı yutar: ne kendi flow’u çalışır ne actionClick yayılır.'
+        ],
+        propNotes: {
+            image: 'Drive dosyası ya da URL; verildiğinde icon yok sayılır.',
+            size: 'sm | md | lg — ikon/görsel ölçüsünü ve dikey boşluğu birlikte ölçekler (dar kartta sm).',
+            actions: '[{ text, icon, kind, variant, flow, isHidden, isDisabled }] — boş bırakılan alanlar hiç çizilmez.'
+        }
+    },
+    iframe: {
+        summary: 'Sandbox’lı dış sayfa gömme. javascript:/data:/vbscript:/file: şemaları engellenir.',
+        behavior: [
+            "isSandboxed (varsayılan AÇIK) allow-scripts allow-forms allow-popups verir ama allow-same-origin VERMEZ — gömülü sayfa uygulamanın çerezine/depolamasına erişemez.",
+            'Yalnız mount yayar: çapraz kaynak içerikte load/error olayı üretilemez.'
+        ]
+    },
+    jsonviewer: {
+        summary: 'Bağlanan veriyi katlanabilir JSON ağacı olarak çizer (hata ayıklama/detay ekranı). Olay YAYMAZ.',
+        behavior: [
+            "data STRING gelir ve '{' ya da '[' ile başlarsa JSON olarak parse edilip ağaç çizilir — uçtan metin olarak dönen gövdeyi akışta ayrıca çözmeye gerek yok; parse edilemezse düz metin gibi gösterilir.",
+            'Boş veri (null · undefined · "" · {} · []) ağaç yerine emptyText satırını çizer ve araç çubuğu gizlenir.',
+            'expandDepth çalışma anında değişirse ağaç YENİDEN kurulur: elle açıp kapattıkların sıfırlanır, düğümler yeni derinliğe göre açılır.',
+            'Araç çubuğu (showToolbar) tümünü aç / tümünü kapat / JSON kopyala düğmeleridir; her düğümün kendi kopyala düğmesi de vardır. Kopyalama panoya güvenli bağlam ister; izin yoksa sessizce hiçbir şey olmaz.',
+            '60 karakteri aşan string yaprakları önizlemede kırpılır ("…"); yaprağa tıklamak tam değeri açar.'
+        ],
+        propNotes: {
+            data: 'Nesne/dizi ya da JSON metni; döngüsel referanslar "[Circular]" yaprağına düşer.',
+            expandDepth: 'Açılışta açık kalacak seviye sayısı (0 = her şey kapalı).',
+            emptyText: 'Veri boşken basılan metin.',
+            showToolbar: 'Aç/kapat/kopyala araç çubuğu (varsayılan AÇIK).'
+        }
+    },
+    'language-selector': {
+        summary: 'Son kullanıcının sayfa dilini değiştirdiği açılır liste; projenin aktif dillerini kendi ana dil adlarıyla listeler.',
+        behavior: [
+            "change olayında runtime machine.setLanguage(value) çağırır: seçim localStorage'a (zeyrek:{appSlug}:lang) yazılır ve çeviri bağlı bütün prop'lar SAYFA YENİLENMEDEN yeniden çözülür.",
+            'Projede dil tanımlı değilse liste boş çizilir — önce proje dillerini (Translations paneli) kur.'
+        ]
+    },
+    otpinput: {
+        summary: 'Tek haneli kutulardan oluşan tek kullanımlık kod girişi (2–12 hane); yapıştırma kutulara dağılır.',
+        behavior: ['Bütün kutular dolduğunda change’e EK olarak complete olayı yayılır — doğrulama akışını buna bağla.'],
+        propNotes: {
+            value: 'Birleşik string; ortadaki kutu silinince sonraki haneler sola kayar.',
+            digitCount: '2–12 arası kutu sayısı.',
+            isMasked: 'Haneleri nokta olarak gösterir.'
+        }
+    },
+    pagination: {
+        summary: 'table/datatable’ın içindeki sayfalayıcının BAĞIMSIZ hâli: repeater, kart listesi ya da özel düzen için offset/limit üretir.',
+        behavior: [
+            "Her gezinme change yayar ve offset/limit'i komponentin kendi prop'una yazar. Akışta bu değerleri event.data'dan DEĞİL self.offset / self.limit'ten (ya da value type:'property' ile) oku — event.data boş gelir ve sorgu LIMIT/OFFSET null ile TÜM satırları döndürür.",
+            'limit değişince offset her zaman 0’a sıfırlanır (eski offset yeni sayfa boyunda anlamsızdır).',
+            'Sayfalama durumunu ya bu komponentin prop’unda tut ve sorguyu {{pagination.offset}} ile bağla, YA DA sayfa değişkeninde tut ve change akışında setter adımıyla yaz. Komponentin prop’unu sayfa değişkenine bağlayıp otomatik geri yazma beklemek ÇALIŞMAZ.',
+            'totalRows/offset/limit adları table/datatable ile birebir aynıdır; aynı sorgu bağları ikisiyle de çalışır.'
+        ],
+        propNotes: {
+            totalRows: 'Toplam kayıt; sayfa sayısı bundan hesaplanır.',
+            variant: 'numbers (numaralı düğmeler) | simple (düzenlenebilir sayfa kutusu, varsayılan) | compact (salt "3 / 12").',
+            limitOptions: 'Sayfa boyu seçenekleri; geçersizler elenir, hiçbiri kalmazsa [10,20,30,40,50] kullanılır.',
+            infoTemplate: '{from} {to} {total} {page} {pages} yer tutucuları; boşsa yerelin varsayılan metni.'
+        }
+    },
+    progress: {
+        summary: 'Çubuk ya da daire biçiminde ilerleme göstergesi; eşiğe göre renk değiştirir. Olay YAYMAZ.',
+        propNotes: {
+            value: '0..max arası; yüzde kırpılarak hesaplanır.',
+            colorMap: '{ "0": "error", "50": "warning", "80": "success" } — yüzdeye eşit/altındaki EN BÜYÜK eşiğin rengi kazanır, yoksa color prop’u.'
+        }
+    },
+    rating: {
+        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.'],
+        propNotes: { value: '0..max arası sayı; akıştan gelen değer bu aralığa kırpılır.' }
+    },
+    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.',
+        behavior: ["actions[].flow doğrudan çalışır ve actionClick yayılır (emptystate ile aynı sözleşme)."]
+    },
+    slider: {
+        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.'],
+        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).'
+        }
+    },
+    statcard: {
+        summary: 'KPI kartı: büyük değer + ikon + trend oku + satır içi sparkline + alt bilgi bağlantısı.',
+        behavior: [
+            'value SAYIYA çözülüyorsa valueFormat ile biçimlenir, çözülmüyorsa ("N/A", "3 gün") olduğu gibi basılır; boş değer "—" çizer.',
+            'invertTrend yalnız RENGİ ters çevirir (hata oranı gibi "azalan iyidir" metrikleri için); ok yönü değişmez.',
+            'Kartın kendisi click, alt bilgi satırı ayrı footerClick yayar; footerHref verilmişse alt bilgi bağlantı olur ve footerFlow yerine ona gider.'
+        ],
+        propNotes: {
+            value: 'Sayı ya da metin; sayıysa valueFormat uygulanır.',
+            sparkline: 'Sayı dizisi; kendi min/max’ına göre ölçeklenir (sıfır tabanlı değil).',
+            trend: 'Yüzde değişim; 0 nötrdür ve panelden temizlenemez.'
+        }
+    },
+    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.'
+        ]
+    },
+    timeline: {
+        summary: 'Durum renkli işaretçilerle tarihli olay listesi (audit-history’nin serbest veriyle çalışan genel hâli).',
+        behavior: [
+            'reverse sıralamayı maxCount kırpmasından ÖNCE uygular, böylece "ters + N kayıt" gerçekten EN YENİ N kaydı gösterir.',
+            'maxCount üstü kayıtlar atılmaz: "Show more" çıkar, showMore olayı yayılır ve kalanların tamamı açılır; items yeni bir diziyle değişince görünüm kırpılmış hâline döner.',
+            "Öğede href/flow varsa satır tıklanabilir; clickItem yükü öğeyi ve indeksini taşır, öğenin kendi flow'u da doğrudan çalışır."
+        ],
+        propNotes: {
+            items: '[{ title, subtitle, description, date, status, icon, avatar, href, flow, isPending }] — boş alanlar çizilmez.',
+            dateFormat: 'absolute (varsayılan) | relative ("2 gün önce").',
+            maxCount: 'Görünür kayıt sınırı; aşıldığında Show more çıkar.'
+        }
+    },
+    timepicker: {
+        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.'],
+        propNotes: { value: "'HH:mm' — Time doğrulamaları ve formun saat karşılaştırmaları bu biçimi bekler." }
+    },
+    toast: {
+        summary: 'Geçici bildirim TETİKLEYİCİSİ: sayfada yer kaplamaz (0×0), isOpen true’ya çekildiğinde bir toast atar.',
+        behavior: [
+            "Tetikleme isOpen'ın YÜKSELEN KENARIDIR: komponent toast'ı gösterdikten sonra isOpen'ı kendi prop'unda false'a geri yazar. Akışta setter ile true yaz, sıfırlamayı düşünme.",
+            'Süre kind’a göre gelir (success/info/default 4sn, warning 6sn, error 8sn, loading süresiz); duration verirsen o kazanır, isSticky ise kapanmaz.',
+            "actions[].flow doğrudan çalışır ve actionClick yayılır; keepOpen verilmedikçe tıklama toast'ı kapatır.",
+            'Toast alanını runtime her uygulamada bir kez kurar — ikinci bir toast komponenti eklemek bildirimleri ÇİFTLEMEZ, her tetikleyici kendi toast’ını atar.'
+        ],
+        propNotes: {
+            isOpen: 'Setter ile true yaz → bir toast; komponent false’a geri döner.',
+            kind: 'default | info | success | error | warning | loading.',
+            position: '9 çapa: top/bottom × left/center/right, center, top-full/bottom-full (tam genişlik bant).',
+            actions: '[{ text, flow, keepOpen, showCountdown }] — en çok 2 düğme.'
+        }
+    }
+};
+export const knowledgeNote = 'knowledge alanı elle doğrulanmış davranış bilgisidir; kayıt yoksa davranış sözlüğe henüz işlenmemiştir — prop/olay semantiği tahmin etmeyin, gerekirse NgApps.UI kaynağına bakın.';
+export function knowledgeFor(slug) {
+    return slug ? componentKnowledge[slug] : undefined;
+}

package/dist/knowledge/componentEvents.js

@@ -0,0 +1,164 @@
+const NO_DATA = { payload: {} };
+const valueChange = (type) => ({ payload: { value: type } });
+export const componentEventContracts = {
+    table: {
+        mount: NO_DATA,
+        pagination: { payload: { offset: 'number', limit: 'number' } },
+        filter: { payload: { filters: 'Array<{ field, operator, value, filterType, conditionType }>', offset: 'number' } },
+        sort: { payload: { sortField: 'string (kolonun name alanı)', sortType: "'asc' | 'desc' | '' (temizlendi)", offset: 'number' } },
+        select: { payload: {}, reads: 'self.selectedRow' },
+        selectionChange: { payload: {}, reads: 'self.selectedRows (dizi) + self.selectedRow' },
+        doubleClick: { payload: {}, reads: 'self.selectedRow' },
+        rowChange: { payload: {}, reads: 'self.rows (düzenlenen satır yerinde güncellenir)' }
+    },
+    datatable: {
+        mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' }
+    },
+    button: { click: NO_DATA },
+    card: { click: NO_DATA },
+    compound: { click: NO_DATA },
+    image: { click: NO_DATA },
+    'qm-card': { click: NO_DATA },
+    form: { mount: NO_DATA, submit: NO_DATA },
+    container: { mount: NO_DATA },
+    'auth-layout': { mount: NO_DATA, primaryClick: NO_DATA, secondaryClick: NO_DATA },
+    layout: { mount: NO_DATA, logout: NO_DATA },
+    textinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
+    textarea: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
+    password: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
+    numberinput: { mount: NO_DATA, change: valueChange('number'), blur: NO_DATA },
+    incrementalinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
+    texteditor: { onMount: NO_DATA, onChange: valueChange('string (HTML)') },
+    checkbox: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    switch: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    radio: { change: valueChange('string') },
+    dropdown: { mount: NO_DATA, change: valueChange('seçilen option değeri'), search: { payload: { searchText: 'string' } }, focus: NO_DATA },
+    'multi-select': { mount: NO_DATA, change: valueChange('değer dizisi'), search: { payload: { searchText: 'string' } }, focus: NO_DATA },
+    'tag-input': { mount: NO_DATA, change: valueChange('etiket dizisi'), focus: NO_DATA },
+    datepicker: { mount: NO_DATA, change: { payload: { value: 'string (tarih)', HH: 'string', mm: 'string' } } },
+    datetimepicker: { mount: NO_DATA, change: { payload: {}, reads: 'self.value' } },
+    daterangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
+    datetimerangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
+    fileUpload: { change: { payload: {}, reads: 'self.value' } },
+    fileInput: { change: { payload: { value: 'Array<{ type, value }>', fileName: 'string' } } },
+    filebutton: { change: { payload: { value: 'Array<{ type, value }>', fileName: 'string' } } },
+    'file-viewer': { mount: NO_DATA },
+    modal: { open: NO_DATA, close: NO_DATA },
+    drawer: { open: NO_DATA, close: NO_DATA },
+    repeater: { mount: NO_DATA, change: { payload: { selectedIndex: 'number' }, reads: 'item / Row (satır bağlamı)' } },
+    tabs: { mount: NO_DATA, tab: { payload: { selected: 'string (sekme anahtarı)' } } },
+    'tree-view': {
+        mount: NO_DATA,
+        click: {
+            payload: { selected: 'string (tıklanan satırın key’i)', currentItem: 'tıklanan satırın tamamı ({ key, text, subtle, icon, image, children… })' },
+            reads: "aksiyon menüsü AYRI olay yaymaz: aksiyonun kendi flow'u çalışır ve satır yine self.currentItem'a yazılır"
+        }
+    },
+    'dropdown-button': { mount: NO_DATA, click: NO_DATA, clickItem: { payload: { currentItem: 'tıklanan menü öğesi' } } },
+    'confirm-bar': { mount: NO_DATA, click: { payload: { currentItem: 'tıklanan buton tanımı' } } },
+    'collapsible-container': { mount: NO_DATA, collapsed: NO_DATA, expanded: NO_DATA },
+    'audit-basic': { mount: NO_DATA },
+    'audit-history': { mount: NO_DATA },
+    'form-validation-errors': { mount: NO_DATA },
+    'page-header': { mount: NO_DATA },
+    header: { mount: NO_DATA },
+    sidebar: { mount: NO_DATA },
+    html: { mount: NO_DATA },
+    view: { mount: NO_DATA },
+    'widget-area': { mount: NO_DATA },
+    'document-editor': { mount: NO_DATA },
+    video: { mount: NO_DATA, click: NO_DATA, play: NO_DATA, pause: NO_DATA, ended: NO_DATA },
+    // — 2026-08-25 eşleme turu: ng-apps-ui'da olay YAYAN ama burada kaydı olmayan komponentler.
+    // Yükler kaynaktaki dispatch('emit', { name, data }) / machine.onEmit(id, { event, data })
+    // çağrılarından birebir çıkarıldı. Olay yaymayan komponentler (badge · breadcrumb · jsonviewer ·
+    // notification · progress · qrcode · slot · tags · text) bilinçli olarak kayıtsızdır.
+    autocomplete: {
+        mount: NO_DATA,
+        change: valueChange('string (YAZILAN metin — option değeri değil)'),
+        select: { payload: { value: "seçilen option'ın değeri", label: "seçilen option'ın etiketi" }, reads: 'self.value etiketi taşır; id gerekiyorsa bu olaydaki value' },
+        search: { payload: { searchText: 'string' } },
+        enter: { payload: { value: 'string (Enter anındaki metin; vurgulu öneri yokken)' } },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    avatar: { click: NO_DATA },
+    'breadcrumb-title': {
+        mount: NO_DATA,
+        clickItem: { payload: { currentItem: '{ text, flow, isHidden } — tıklanan iz öğesi' } },
+        clickRoot: NO_DATA
+    },
+    carousel: {
+        mount: NO_DATA,
+        slideChange: { payload: { activeIndex: 'number' } },
+        slideClick: { payload: { currentItem: 'slayt nesnesi', index: 'number' } }
+    },
+    chart: {
+        mount: NO_DATA,
+        dataPointClick: { payload: { name: 'string (kategori)', seriesName: 'string', value: 'number | null', dataIndex: 'number', row: 'kaynak satırın TAMAMI | null' } },
+        breadcrumbClick: { payload: { filterValue: 'hedef seviyenin filtre değeri (kök seviyede undefined)' } },
+        selectionChange: { payload: { selected: 'seçili veri noktaları' } },
+        legendClick: { payload: { name: 'string (seri adı)', selected: 'seri → görünürlük haritası' } },
+        axisLabelClick: { payload: { value: 'string (tıklanan eksen etiketi)' } },
+        zoom: { payload: { start: 'number (görünen aralığın başlangıç yüzdesi)', end: 'number (bitiş yüzdesi)' }, reads: "ECharts dataZoom params'ı olduğu gibi geçer; sürüme göre batch/startValue/endValue de gelebilir" },
+        refresh: NO_DATA,
+        retry: NO_DATA
+    },
+    checkboxgroup: { mount: NO_DATA, change: valueChange('string[] (seçili değerler)') },
+    emptystate: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
+    iframe: { mount: NO_DATA },
+    'language-selector': { change: { payload: { value: 'string (dil kodu)' }, reads: 'runtime ayrıca machine.setLanguage(value) çağırır' } },
+    otpinput: {
+        mount: NO_DATA,
+        change: valueChange('string (birleşik kod)'),
+        complete: { payload: { value: 'string (tüm haneler dolduğunda)' } }
+    },
+    pagination: { mount: NO_DATA, change: { payload: { offset: 'number', limit: 'number' }, reads: 'self.offset · self.limit (sorguyu bunlara bağla)' } },
+    rating: { mount: NO_DATA, change: valueChange('number (0..max; allowHalf ile yarım)') },
+    result: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
+    slider: {
+        mount: NO_DATA,
+        change: valueChange('number (sürüklerken sürekli)'),
+        changed: valueChange('number (tutamak bırakıldığında — pahalı akışı buna bağla)')
+    },
+    statcard: { mount: NO_DATA, click: NO_DATA, footerClick: { payload: {}, reads: "footerFlow zaten doğrudan çalışır; footerHref varsa tıklama ona gider" } },
+    switcher: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    timeline: {
+        mount: NO_DATA,
+        clickItem: { payload: { currentItem: 'tıklanan olay öğesi', index: 'number' }, reads: "öğenin kendi flow'u da doğrudan çalışır" },
+        showMore: NO_DATA
+    },
+    timepicker: { mount: NO_DATA, change: valueChange("string 'HH:mm' (temizlenince '')") },
+    toast: {
+        open: NO_DATA,
+        close: NO_DATA,
+        click: NO_DATA,
+        actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" }
+    },
+    'qm-header': {
+        mount: NO_DATA,
+        languageChange: { payload: { selectedLang: 'string (dil kodu)' } },
+        notificationClick: NO_DATA,
+        notificationSelect: { payload: { currentItem: 'seçilen bildirim kaydı' } },
+        notificationsClear: NO_DATA,
+        search: { payload: { searchValue: 'string (kırpılmış arama metni)' } },
+        searchResultClick: { payload: {}, reads: "tıklanan kayıt yalnız emit params'ında (item) taşınır ve ifade kapsamına GİRMEZ — kayıt id'si gerekiyorsa aramayı kendi komponentinle kur" }
+    },
+    'qm-sidebar': { mount: NO_DATA, collapsed: { payload: {}, reads: "daralma durumu emit'in value alanındadır; motor yalnız data'yı prop'a yazdığı için akışa ULAŞMAZ" } },
+    'qm-content': { mount: NO_DATA }
+};
+export const eventPayloadNote = "Olay yükü motorda komponentin KENDİ prop'una yazılır (FlowMachine.onEmit → setNode) ve akışta " +
+    "self.<anahtar> ile okunur — payload anahtarları aynı zamanda o prop'ların adıdır. " +
+    "event.data komponent olaylarında BOŞ gelir: motor akışı emit'in params'ıyla başlatır ve " +
+    "event.data = params.data'dır (yalnız html actions/fireEvent bu yoldan doldurur). " +
+    "payload boşsa olay veri taşımaz; 'reads' verilmişse değer yükte değil komponentin başka bir prop'undadır. " +
+    "self yerine value { type:'property', ref:{ source:'component', element:'<elementId>', property:'<prop>' } } de kullanılabilir. " +
+    "payload alanı yoksa yük sözlüğe henüz işlenmemiştir; tahmin etmeyin.";
+export function eventContractsFor(slug, names) {
+    const contracts = slug ? componentEventContracts[slug] : undefined;
+    return names.map(name => {
+        const contract = contracts?.[name];
+        if (!contract)
+            return { name };
+        return { name, payload: contract.payload, ...(contract.reads ? { reads: contract.reads } : {}) };
+    });
+}