@appaflytech/zeyrek-ai-mcp 0.0.13 → 0.0.15

package/dist/knowledge/componentEvents.js

@@ -22,11 +22,49 @@ export const componentEventContracts = {
         mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' }
     },
     button: { mount: NO_DATA, click: NO_DATA },
-    card: { click: NO_DATA },
-    compound: { click: NO_DATA },
-    image: { click: NO_DATA },
+    card: {
+        mount: NO_DATA,
+        click: NO_DATA,
+        buttonClick: {
+            payload: {},
+            reads: 'Kartın kendi butonuna (buttonText) basılınca yayılır. Kabarcığı DURDURMAZ: aynı tıklama kartın click olayını da çalıştırır — yalnız buton eylemi isteniyorsa click bağını boş bırakın.'
+        }
+    },
+    compound: {
+        mount: NO_DATA,
+        click: {
+            payload: {},
+            reads: 'Düğmeye tıklanınca yayılır — href YAZILIYKEN DE yayılır, yani gezinme ile akış birlikte koşar. isDisabled ya da isLoading açıkken hiç yayılmaz.'
+        }
+    },
+    image: {
+        mount: NO_DATA,
+        click: {
+            payload: {},
+            reads: 'Görsele (ya da kırık/boş kaynağın yedek kutusuna) tıklanınca yayılır. isZoomable açıkken aynı tıklama büyütülmüş önizlemeyi de açar; akış iptal edilmez.'
+        }
+    },
+    qrcode: {
+        mount: NO_DATA,
+        click: {
+            payload: {},
+            reads: 'Koda tıklanınca yayılır, ama YALNIZ akışa bağlıysa ve ekranda gerçek bir kod varken (yer tutucu ve iskelet tıklanmaz). Bağlıyken düğüm <button> olur ve odak sırasına girer; bağlı değilken role="img" taşıyan salt görsel bir <div>tür.'
+        },
+        error: {
+            payload: {
+                errorText: 'string (kütüphanenin kendi mesajı, ör. "Data too long: expected 1273 but got 1600")'
+            },
+            reads: 'self.errorText YA DA event.data.errorText — ikisi de dolu. YALNIZ üretim başarısızlığında yayılır — pratikte tek sebebi kapasite: seçilen errorCorrectionLevel’de sığmayan data (bayt sınırı L 2953 · M 2331 · Q 1663 · H 1273). BOŞ data hata DEĞİLDİR ve bu olayı çalıştırmaz, kesikli yer tutucu çizilir. Veri düzelince hata bir sonraki çizim turunda temizlenir ve olay yeniden yayılmaz.'
+        }
+    },
     'qm-card': { click: NO_DATA },
-    form: { mount: NO_DATA, submit: NO_DATA },
+    form: {
+        mount: NO_DATA,
+        submit: {
+            payload: {},
+            reads: "Yalnız BÜTÜN kurallar geçince yayılır (alan kuralları + formun kendi validations dizisi); kalırsa olay çalışmaz, alanlar işaretlenir. event.data BOŞ. event.source.id = formu gönderen düğmenin ADI, event.source.props = onun prop'ları (Type='submit' düğme; Enter'la gönderimde formun ilk submit düğmesi; formda hiç submit düğmesi yoksa event.source formun KENDİSİDİR) — aynı formu iki düğme gönderiyorsa ('Kaydet' / 'Kaydet ve kapat') dallanma buradan. Toplu değer self.value = { <alan adı>: değer } (Page.components.<form>.value ile de okunur), self.isValid bu anda her zaman true."
+        }
+    },
     container: { mount: NO_DATA },
     aibox: { mount: NO_DATA },
     box: { mount: NO_DATA },
@@ -34,8 +72,8 @@ export const componentEventContracts = {
     divider: {},
     spacer: {},
     popover: {
-        open: { payload: { isOpen: 'boolean (true)' }, reads: 'setter: self.isOpen da yazılır — akış paneli isOpen prop’unu değiştirerek de açıp kapatabilir' },
-        close: { payload: { isOpen: 'boolean (false)' }, reads: 'setter: self.isOpen da yazılır' }
+        open: { payload: { isOpen: 'boolean (true)' }, reads: 'Tetikleyici yolunda setter: self.isOpen da yazılır. Akış isOpen’ı kendisi yazınca da open çıkar (setter’sız, prop zaten yazılmış) — açılış nasıl olursa olsun tek olay. İlk çizimde çıkmaz; editörde tetikleyici çalışmaz.' },
+        close: { payload: { isOpen: 'boolean (false)' }, reads: 'Tetikleyici, dışarı tıklama, Escape ya da hover ayrılışı: setter, self.isOpen yazılır. Akış isOpen’ı false yazınca da close çıkar (setter’sız).' }
     },
     phoneinput: {
         mount: NO_DATA,
@@ -70,9 +108,9 @@ export const componentEventContracts = {
             payload: { text: 'string', parentId: "string (yanıtsa üst yorumun id’si, kök yorumda '')", mentions: 'string[] (metinden çözülmüş @kişi listesi)', author: 'string (currentUser)' },
             reads: 'Komponent yorumu ANINDA iyimser olarak listeye ekler (bekleyen katman); kalıcılık akışın işidir — rows tazelenmezse bekleyen satır bir sonraki içerik değişiminde kaybolur'
         },
-        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string' }, reads: 'beğeni de iyimserdir; sayaç rows tazelenene kadar yerel' },
-        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string' } },
-        delete: { payload: { id: 'string', author: 'string' }, reads: 'satır listeden hemen çıkarılır; uca yazmak akışın işidir' }
+        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string (currentUser — işlemi yapan)' }, reads: 'beğeni de iyimserdir; sayaç rows tazelenene kadar yerel. isDisabled/isReadonly/isViewmode açıkken yayılmaz' },
+        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string (currentUser — işlemi yapan)' }, reads: 'düzenleme de iyimserdir; yeni metin "düzenlendi" işaretiyle rows tazelenene kadar yerel. Metin değişmediyse yayılmaz' },
+        delete: { payload: { id: 'string', author: 'string (currentUser — işlemi yapan)' }, reads: 'satır (kök yorumsa yanıtlarıyla birlikte) listeden hemen gizlenir; uca yazmak akışın işidir' }
     },
     'auth-layout': { mount: NO_DATA, primaryClick: NO_DATA, secondaryClick: NO_DATA },
     layout: { mount: NO_DATA, logout: NO_DATA },
@@ -113,7 +151,18 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
-    incrementalinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
+    incrementalinput: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string (elle yazılan metin) YA DA { Prefix, Separator, Counter, DigitCount, FieldId } (sunucudan kod gelince: kodun METNİ DEĞİL, kodu üreten şekil)"
+            },
+            reads: 'setter: self.value da yazılır. Elle yazarken HER TUŞTA, otomatik kod gelince bir kez yayılır — pahalı akışı changed’e bağla'
+        },
+        changed: valueChange('string (alan bırakılınca kesinleşen metin; yalnız ELLE düzenlemede yayılır)'),
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     // Adlar 2026-09-11'de `on` önekinden kurtuldu: şema onMount/onChange diyordu, runtime
     // mount/change yayıyordu ve flow-machine eşleşmeyi ADLA yaptığı için bu bileşene bağlanan
     // hiçbir akış çalışmıyordu.
@@ -144,6 +193,13 @@ export const componentEventContracts = {
     dropdown: { mount: NO_DATA, change: { payload: { value: 'seçilen option değeri', selectedLabel: "seçilen option'ın label metni (temizlemede '')" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
     'multi-select': { mount: NO_DATA, change: { payload: { value: "seçilen değerlerin dizisi: [{ value, label, id, text }] — id/text, value/label'ın eski adlı ikizleridir" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
     'tag-input': { mount: NO_DATA, change: { payload: { value: 'etiket dizisi: [{ value, color? }] — renk verilmemiş etikette color anahtarı HİÇ bulunmaz' } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
+    tags: {
+        mount: NO_DATA,
+        clickItem: {
+            payload: { currentItem: 'tıklanan öğe (values’taki nesnenin tamamı; düz metin dizisinde metin)', index: 'number (values dizisindeki gerçek yer; atlanan öğeler kaydırmaz)' },
+            reads: "event.data.currentItem ve event.data.index ile oku; currentItem ayrıca self.currentItem'a yazılır, index self'e YAZILMAZ. clickItem satırı yoksa etiketler tıklanamaz. Bileşen isActive'i değiştirmez — seçimi akış values'a yazar"
+        }
+    },
     datepicker: {
         mount: NO_DATA,
         change: {
@@ -190,42 +246,153 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
-    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 },
+    fileUpload: {
+        change: {
+            payload: { value: "Array<{ value: base64 data URL, fileName: string, type: 'file', ref: '' }>" },
+            reads: 'self.value — dosya EKLENİNCE de SİLİNİNCE de (çipe tıklama) aynı olay yayılır ve yük her seferinde KALAN TÜM listedir, yalnız yeni dosyalar değil. isMultiple:false iken dizi tek elemanlıdır. Kilitliyken (isDisabled/isReadonly/isViewmode) hiç yayılmaz; tür/boyut/adet sınırına takılan dosya listeye girmez ve uyarı komponentin içinde çizilir, ama kabul KISMİDİR: geçen dosya varsa olay GEÇENLERLE yayılır, yalnız hepsi reddedilirse hiç yayılmaz. enableCrop açıkken görsel dosyalar kırpma katmanından geçtikten SONRA yayılır (İptal dosyayı düşürür; hepsi düşerse olay çalışmaz).'
+        }
+    },
+    fileInput: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: '{ type: "file", fileName: string, value: string (base64 data URL) } — isMultiple açıkken bu nesnelerin DİZİSİ; boşaltma { type: "ref", value: null } (çoklu seçimde tek elemanlı dizisi)'
+            },
+            reads: 'Tek anahtar value düğümün prop’una yazılır: akış self.value ile okur, dosya adı self.value.fileName’dedir (ÜST DÜZEY fileName anahtarı YOKTUR — 2026-09-17’de kayıttan çıkarıldı, runtime hiç göndermiyordu). Çoklu seçimde yeni dosyalar eskilerin üstüne EKLENİR ve yük KALAN TÜM listedir. Tür/boyut/adet sınırına takılan dosya listeye girmez ve uyarı alanın altına yerel mesaj olarak yazılır, ama kabul KISMİDİR: geçen dosya varsa change GEÇENLERLE yayılır (5 dosya + maxFileCount:3 → 3’ü akışa gider), yalnız hepsi elenirse hiç yayılmaz — tek dosyalık alanda zaten hepsi ya da hiçbiri. Açılır listedeki × o dosyayı siler ve change’i KALAN listeyle yayar; son dosya silinince ve çipin temizle düğmesiyle boşaltma değeri yazılır. Kilitliyken (isDisabled/isReadonly/isViewmode) hiç yayılmaz; enableCrop açıkken görseller kırpma katmanından geçtikten SONRA yayılır (İptal dosyayı düşürür, hepsi düşerse olay çalışmaz)'
+        }
+    },
+    filebutton: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "tekli kipte { type: 'file', value: base64 data URL, fileName: string, ref: '' } TEK nesne (temizlenince null); çoklu kipte aynı nesnelerin DİZİSİ (temizlenince [])"
+            },
+            reads: "self.value — düğümün value prop'una yazılır. fileName üst düzey anahtar DEĞİLDİR, her dosyanın kendi alanıdır (2026-09-17'de düzeltildi; kayıt runtime'ın hiç göndermediği bir yük anlatıyordu). Çoklu kipte yük KALAN TÜM listedir: yeni parti mevcut listenin ÜSTÜNE eklenir, X bir satırı siler, 'Tümünü temizle' [] yayar. Kilitliyken (isDisabled/isReadonly/isViewmode) hiç yayılmaz; tür/boyut/adet sınırına takılan dosya listeye girmez, uyarı komponentin içinde çizilir ve hepsi elenirse olay çalışmaz."
+        }
+    },
+    'file-viewer': { mount: NO_DATA, load: NO_DATA, error: 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ı)' } } },
+    repeater: {
+        mount: NO_DATA,
+        change: {
+            payload: { selectedIndex: 'number (satırın sırası, 0’dan)' },
+            reads: 'self.selectedItem (seçilen satırın verisi) — seçilen satır DEĞİŞİNCE yayılır: satıra tıklama ya da satırdaki bir çocuğun olayı. Aynı satıra tekrar tıklamak change üretmez. Akış satır bağlamında koşmaz: item/Row burada boştur, satırı self.selectedItem ile oku'
+        },
+        select: {
+            payload: { selectedIndex: 'number (tıklanan satırın sırası, 0’dan)' },
+            reads: 'self.selectedItem — satıra ulaşan HER tıklamada yayılır (aynı satır dahil; tıklamayı yutan dropdown-button/tag-input/tarih seçici gibi çocuklarda gelmez, etiket tıklaması tek sayılır); satır değiştiyse change ondan önce yayılır. Satırdaki butonun kendi click akışı select’ten önce başlar'
+        }
+    },
+    tabs: {
+        mount: NO_DATA,
+        tab: {
+            payload: { selected: 'string (geçilen sekmenin key\'i; key boşsa sırası "0", "1"…)' },
+            reads: "selected self'e yazılır; event.data.selected da dolu gelir. Yalnız kullanıcı selected'dan farklı key'li sekmeye geçince (tıklama, ←/→/Home/End) yayılır — selected'ın gösterdiği sekmeye tekrar tıklamak ve akışın selected yazması olay üretmez; görünen sekme bir geri düşüşse ona tıklamak yayar"
+        }
+    },
     '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"
+            reads: "event.data.selected / event.data.currentItem ya da self.selected / self.currentItem — ikisi de dolu. isDisabled satır tıklanmaz. Aksiyon menüsü AYRI olay yaymaz: aksiyonun kendi flow'u çalışır, orada event.data = { currentItem, actionKey } ve satır yine self.currentItem'a yazılır"
+        },
+        change: {
+            payload: {
+                checkedKeys: "string[] (normalize edilmiş işaretli key'ler, belge sırasıyla; ağaçta çizilmeyen key'ler sonda)",
+                currentItem: 'kutusuna tıklanan satırın tamamı',
+                isChecked: 'boolean (tıklamadan sonra o satır tam işaretli mi; yalnız event.data’da)'
+            },
+            reads: "event.data.checkedKeys ya da self.checkedKeys; self.currentItem da yazılır, isChecked yalnız event.data'da. Yalnız isCheckable:true iken kullanıcı kutuya tıklayınca yayılır — akışın checkedKeys yazması olay üretmez"
+        }
+    },
+    'dropdown-button': {
+        mount: NO_DATA,
+        click: {
+            payload: {},
+            reads: 'Butonun kendisine basılınca (menüyü açan/kapatan tıklama) yayılır — menü açılmasa bile. isDisabled/isLoading iken hiç yayılmaz. Menü SATIRI bu olayı yaymaz.'
+        },
+        clickItem: {
+            payload: {
+                currentItem: 'tıklanan menü öğesinin TAMAMI ({ key, text, icon, flow, isDanger, isDisabled… }) — akışta self.currentItem ile okunur'
+            },
+            reads: "Her satır tıklamasında yayılır. Satırın kendi flow'u (options[].flow) varsa o akış AYRICA çalışır ve aynı currentItem'ı görür; yani flow bağlı bir satır iki akış tetikleyebilir."
+        }
+    },
+    'confirm-bar': {
+        mount: NO_DATA,
+        click: {
+            payload: { currentItem: 'tıklanan aksiyonun TAMAMI (key, text, kind, variant, icon, flow, href, isDisabled, isLoading…)' },
+            reads: "self.currentItem — şeridin aksiyon butonuna basılınca yayılır. Aksiyonun kendi flow'u varsa o akış ÖNCE koşar ve click olayına bağlı akışlar AYRICA koşar (tek tıklamada iki akış); yalnız biri istensin diye ya aksiyonun flow alanını ya da click bağını boş bırakın. href yazılmış aksiyon LİNK olur: tarayıcı adrese gider, click YAYILMAZ (Button'un type:'link' sözleşmesi). isDisabled/isLoading aksiyonun tıklaması hiç yayılmaz."
+        },
+        close: {
+            payload: { isHidden: 'true' },
+            reads: 'Yalnız showCloseButton:true iken çizilen kapatma düğmesine basılınca yayılır. Şerit KENDİNİ gizler: isHidden düğümün prop\'una yazılır (self.isHidden true olur) ve render katmanı şeridi söker — geri getirmek için akışta isHidden:false yazın. Tasarımcı kanvasında gizlenme uygulanmaz.'
+        }
+    },
+    'collapsible-container': {
+        mount: NO_DATA,
+        collapsed: {
+            payload: {},
+            reads: "Kullanıcı bölümü KAPATINCA yayılır; komponent aynı anda isOpen'ı false'a yazar, akışta self.isOpen ile okunur. Akıştan (setter ile) isOpen yazmak bu olayı YAYMAZ. Kapanışta gövdedeki komponentler DOM'dan sökülür: onların durumu kaybolur, açılışta mount'ları yeniden koşar"
+        },
+        expanded: {
+            payload: {},
+            reads: "Kullanıcı bölümü AÇINCA yayılır (isOpen true olarak geri yazılır, akışta self.isOpen). Kapalı bölümün içi hiç kurulmadığı için verinin çekileceği doğru yer budur; her açılışta yeniden koşar, tek seferlik değildir"
         }
     },
-    '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 },
+    'audit-history': {
+        mount: NO_DATA,
+        showMore: { payload: {}, reads: 'yalnız histories visibleLogCount’u aşınca çıkan "Daha fazla göster" düğmesine basılınca; görünür sınır visibleLogCount kadar büyür, kalan kalmayınca düğme kaybolur. Bileşen veri çekmez; backend kayıt başına en fazla 5 işlem verdiği için meta.history bağlıyken düğme ancak visibleLogCount < 5 iken çıkar' }
+    },
     'form-validation-errors': { mount: NO_DATA },
-    'page-header': { mount: NO_DATA },
+    'page-header': {
+        mount: NO_DATA,
+        clickItem: {
+            payload: {
+                currentItem: 'tıklanan links satırının tamamı (düz metin dizisinde metnin kendisi)',
+                index: 'number (links dizisindeki gerçek yer; metinsiz satırlar atlanır ama kaydırmaz). Kök öğe yoktur, -1 gelmez'
+            },
+            reads: "event.data.currentItem ve event.data.index ile oku. currentItem düğüme de yazılır (şemada gizli durum prop'u) ama self.currentItem ifade yüzeyine yalnız düğüm o anahtarı kayıtta taşıyorsa çıkar (makine anahtar kümesini kurulurken düğümün prop'larından toplar) — güvenilir yol event.data'dır; index self'e YAZILMAZ. Olayı içteki breadcrumb yayar, page-header olduğu gibi geçirir — yalnız page-header düğümünde bir akış bağlıysa yayılır, bağsız tıklama düğüme hiçbir şey yazmaz. Başlık (pageTitle, izin son öğesi) tıklanabilir DEĞİLDİR, bu olayı hiç yaymaz. Adresi olan öğe <a> olduğu için bağlı tıklama hem bu olayı yayar HEM de adrese gider — yalnız akış karar versin isteniyorsa satırın href'ini boş bırak"
+        }
+    },
     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 },
+    video: {
+        mount: {
+            payload: {},
+            reads: "Bileşen mount'u KENDİSİ yaymaz — ortak render katmanı (RenderComponent.handleMount) her düğüm için bir kez yayar. 2026-09-16 turuna kadar Video.svelte de kendi onMount'unda yayıyordu ve mount'a bağlı akış İKİ KEZ koşuyordu (ARC-006, kapandı)"
+        },
+        click: {
+            payload: {},
+            reads: 'Yalnız akışa bağlıysa sarmalayıcı tıklanabilir olur; controls açıkken oynat/duraklat düğmesine basmak da bu olayı tetikler (tıklama sarmalayıcıya kabarır). isLoading:true iken HİÇ çalışmaz — o dalda oynatıcı yerine iskelet çizilir ve sarmalayıcı tıklanabilir değildir'
+        },
+        play: {
+            payload: { isPlaying: 'boolean (true)' },
+            reads: "setter: self.isPlaying da yazılır — akış props.isPlaying'e true yazarak videoyu BAŞLATABİLİR de (sesli videoda tarayıcı reddeder). event.data ayrıca { currentTime: number (saniye), duration: number (saniye; meta yüklenmemişse VE canlı yayında — süresi Infinity — 0) } taşır"
+        },
+        pause: {
+            payload: { isPlaying: 'boolean (false)' },
+            reads: "setter: self.isPlaying da yazılır; akış false yazarak duraklatabilir. event.data: { currentTime, duration }. DİKKAT: video BİTTİĞİNDE de yayılır — HTML spesifikasyonu bitişte önce pause sonra ended yayar, yani 'kullanıcı duraklattı' demek değildir; ayırmak için currentTime ≈ duration karşılaştır"
+        },
+        ended: {
+            payload: { isPlaying: 'boolean (false)' },
+            reads: 'loop açıkken HİÇ yayılmaz (döngü videosu bitmez). event.data: { currentTime, duration } — bitişte currentTime pratikte duration’a eşittir. Bitişte pause’dan SONRA gelir (spesifikasyon sırası), yani ended akışı pause akışının ardından koşar'
+        }
+    },
     // — 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 (breadcrumb · qrcode · slot · tags ·
-    // text) bilinçli olarak kayıtsızdır. `notification` bu listede
+    // çağrılarından birebir çıkarıldı. Olay yaymayan komponentler (slot ·
+    // text) bilinçli olarak kayıtsızdır. `breadcrumb` de bu listedeydi; 2026-09-17
+    // component-analiz turunda şemaya mount + clickItem eklendi ve kaydı yukarıda açıldı. `notification` bu listede
     // YANLIŞLIKLA yer almıştı — Notification.svelte hem timeout'ta hem kapatma tıklamasında
-    // dispatch('emit', { name:'toggled', data:{isHidden:true}, setter:true }) çağırıyor (düzeltme
-    // 2026-08-25c, `docs/20-komponent-bilgi-katmani.md` §9).
+    // emit yayıyor (düzeltme 2026-08-25c, `docs/20-komponent-bilgi-katmani.md` §9); o emit'in adı
+    // 2026-09-17'de toggled → close oldu ve şemada bildirildi, kaydı aşağıda.
     autocomplete: {
         mount: NO_DATA,
         change: {
@@ -244,52 +411,112 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
-    avatar: { click: NO_DATA },
-    badge: { click: NO_DATA },
-    icon: { click: NO_DATA },
+    avatar: { mount: NO_DATA, click: NO_DATA },
+    badge: {
+        mount: NO_DATA,
+        click: {
+            payload: {},
+            reads: 'yalnız şemada bir akış bağlıysa yayılır; bağlıyken rozet <button> olur, bağlı değilken salt görsel <span> kalır ve olay hiç çıkmaz'
+        }
+    },
+    icon: { mount: NO_DATA, click: NO_DATA },
+    breadcrumb: {
+        mount: NO_DATA,
+        clickItem: {
+            payload: {
+                currentItem: 'tıklanan öğe (items satırının tamamı; düz metin dizisinde metin). KÖK öğede items satırı yoktur, yük { title: homeTitle, href: homeHref } taşır',
+                index: 'number (items dizisindeki gerçek yer; metinsiz öğeler atlanır ama kaydırmaz). KÖK öğede -1'
+            },
+            reads: "event.data.currentItem ve event.data.index ile oku; currentItem ayrıca self.currentItem'a yazılır (şemada gizli durum prop'u), index self'e YAZILMAZ. Yalnız şemada bir akış bağlıysa yayılır — bağsız tıklama düğüme hiçbir şey yazmaz. Bulunulan sayfa (currentTitle) tıklanabilir DEĞİLDİR, bu olayı hiç yaymaz. Adresi olan öğe <a> olduğu için bağlı tıklama hem bu olayı yayar HEM de adrese gider — yalnız akış karar versin isteniyorsa öğenin href'ini boş bırak; href'i de clickItem bağı da olmayan öğe düz metindir, tıklanamaz"
+        }
+    },
     'breadcrumb-title': {
         mount: NO_DATA,
-        clickItem: { payload: { currentItem: '{ text, flow, isHidden } — tıklanan iz öğesi' } },
-        clickRoot: NO_DATA
+        clickItem: {
+            payload: { currentItem: '{ key, text, flow, isHidden } — tıklanan iz öğesi (satır içi ya da … menüsünden, ikisi de aynı yükü yayar)' },
+            reads: 'self.currentItem — öğe düğümün prop’una da yazılır; akış hangi adımın seçildiğini self.currentItem.key ile okur. Öğenin kendi flow’u varsa ÖNCE o çalışır, sonra clickItem yayılır.'
+        },
+        clickRoot: {
+            payload: {},
+            reads: 'Kök ikonuna her basışta yayılır — rootHref yazılıyken de (o durumda yalnız rootFlow atlanır, gezinme olaydan sonra başlar).'
+        }
     },
     carousel: {
         mount: NO_DATA,
-        slideChange: { payload: { activeIndex: 'number' } },
-        slideClick: { payload: { currentItem: 'slayt nesnesi', index: 'number' } }
+        slideChange: {
+            payload: { activeIndex: 'number (görünen slaytın 0-tabanlı indeksi)' },
+            reads: "event.data.activeIndex ile oku; aynı değer setter ile düğümün kendi activeIndex prop'una da yazılır (self.activeIndex). Ok, nokta, klavye (←/→), swipe ve otomatik geçişin hepsi bu olaydan geçer; aynı indekse gitmek olay yaymaz"
+        },
+        slideClick: {
+            payload: { currentItem: 'tıklanan slayt nesnesinin tamamı (items satırı)', index: 'number (items dizisindeki yer)' },
+            reads: "event.data.currentItem ve event.data.index ile oku; currentItem ayrıca self.currentItem'a yazılır, index self'e YAZILMAZ. HER slayt tıklamasında yayılır (href/flow şart değil); slaytta flow varsa bu olayın akışı da slaytın kendi flow'u da çalışır, ikisi de aynı event.data'yı alır. Eşiği aşan sürükleme ve ok/nokta düğmeleri bu olayı tetiklemez"
+        }
     },
     chart: {
         mount: NO_DATA,
-        dataPointClick: { payload: { name: 'string (kategori)', seriesName: 'string', value: 'number | null', dataIndex: 'number', row: 'kaynak satırın TAMAMI | null' } },
+        dataPointClick: { payload: { name: 'string (kategori); scatter grafiğinde x değeri', seriesName: 'string', value: 'number | null; scatter grafiğinde y', dataIndex: 'number', row: 'kaynak satırın TAMAMI | null' }, reads: 'YALNIZ seri noktasında yayılır; eksen etiketi tıklaması axisLabelClick’tir (2026-09-16 öncesinde o da boş bir dataPointClick üretiyordu). scatter noktası ECharts tarafında [x, y, size] dizisidir, yük tek değere indirgenir: name = x, value = y' },
         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" },
+        axisLabelClick: { payload: { value: 'string (tıklanan eksen etiketi)' }, reads: 'Kategori ekseni hangi eksene düşerse oradan gelir — yatay yönelimde yAxis (2026-09-16 öncesinde yatayda hiç yayılmıyordu)' },
+        zoom: { payload: { start: 'number | null (görünen aralığın başlangıç yüzdesi)', end: 'number | null (bitiş yüzdesi)', startValue: 'number | null (eksenin kendi birimindeki mutlak alt sınır)', endValue: 'number | null (mutlak üst sınır)' }, reads: 'Yük normalize edilir: ECharts iki dataZoom bileşeniyle alanları batch içine koysa da akış her zaman bu dört alanı görür. Aralığı sorguya çevirecekseniz yüzdeleri değil startValue/endValue kullanın (2026-09-16)' },
         refresh: NO_DATA,
         retry: NO_DATA
     },
     checkboxgroup: { mount: NO_DATA, change: valueChange('string[] (seçili değerler)'), focus: NO_DATA, blur: NO_DATA },
-    emptystate: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
-    iframe: { mount: NO_DATA, load: NO_DATA, error: NO_DATA },
+    emptystate: {
+        mount: NO_DATA,
+        actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır; index GÖRÜNEN aksiyonların sırasıdır (isHidden olanlar elenmiş). href dolu satırda olay YİNE yayılır ama aynı sekmede gezinme sayfayı değiştirir ve olayın sayfa-içi sonucu görünmeden kaybolur — ikisini birlikte görmek için satırda isNewTabLink aç" }
+    },
+    iframe: {
+        mount: NO_DATA,
+        load: NO_DATA,
+        error: NO_DATA,
+        message: {
+            payload: {
+                message: 'gömülü sayfanın postMessage ile yolladığı ham değer (structured clone; string, sayı, nesne…)',
+                origin: "string — mesajı yollayan belgenin origin'i; isSandboxed AÇIKKEN opak origin yüzünden 'null' gelir"
+            },
+            reads: "yalnız event.data.message / event.data.origin — message hiçbir prop yazmaz. Gömülü sayfa window.parent.postMessage(payload, '*') çağırır; YALNIZ bu çerçeveden gelen mesaj kabul edilir (event.source karşılaştırması), sayfadaki başka bir iframe ya da uygulamanın kendi postMessage'ı olayı çalıştırmaz. Origin süzgeci runtime'da YOKTUR — güvenilecek origin kararı akışa aittir"
+        }
+    },
     jsonviewer: {
+        mount: NO_DATA,
         nodeClick: {
             payload: {
                 path: "string (nokta/köşeli-parantez yolu — 'user.roles[0].name'; kökte boş)",
                 key: 'string (düğümün anahtarı; dizi öğesinde indeks)',
                 kind: "'object' | 'array' | 'string' | 'number' | 'boolean' | 'null'",
                 value: 'düğümün ham değeri (object/array için alt ağacın tamamı)'
-            }
+            },
+            reads: 'event.data.path / key / kind / value; self.currentItem’a value’suz { path, key, kind } yazılır. Aç/kapa oku ve satırın kopyala düğmesi bu olayı yaymaz'
         },
         copy: {
             payload: {
                 path: "string (kopyalanan düğümün yolu; araç çubuğundan TÜMÜNÜ kopyalamada boş + kind:'root')",
+                key: "string (düğümün anahtarı; tümünü kopyalamada boş)",
                 kind: "'root' | 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null'",
                 value: 'kopyalanan değer (tümünü kopyalamada normalize edilmiş TÜM veri)'
-            }
+            },
+            reads: 'yalnız event.data — copy hiçbir prop yazmaz. Pano yazılamazsa (izin/güvensiz bağlam) olay yayılmaz'
+        }
+    },
+    'language-selector': {
+        mount: { ...NO_DATA, reads: 'self.value BOŞTUR: enjekte edilen geçerli dil düğümün prop kaydına yazılmıyor, oraya yalnız change yükü yazılıyor (ölçüldü 2026-09-18, ARC-098). Dili okuyacak akışı change’e bağla' },
+        change: {
+            payload: { value: 'string (seçilen dil kodu, projenin yazdığı biçimde)' },
+            reads: 'Yük düğümün kendi value prop’una yazılır (yazmayı machine.onEmit yapar, çünkü olayda data var), akış self.value ile okur. Dili DEĞİŞTİREN yazma bu değildir: render katmanı aynı olayda machine.setLanguage(value) + setAppLocale(value) çağırır. Yalnız kullanıcı seçiminde yayılır; akışın value’ya yazması hiçbir şeyi değiştirmez (enjekte edilen değer ezer)'
+        },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    notification: {
+        mount: { payload: {}, reads: 'Ortak render katmanından gelir ve band GÖRÜNÜR olduğunda bir kez yayılır; isHidden:true iken yayılmaz' },
+        close: {
+            payload: { isHidden: 'boolean (her zaman true — band kendini kapatırken props.isHidden yazar)' },
+            reads: "event.data.reason — kapatma düğmesi 'user', zaman aşımı 'timeout'. Bandı yeniden açmak akışın işidir: props.isHidden false yazılmadıkça kapalı kalır. 2026-09-17'den önce bu emit toggled adıyla yayılıyordu ve şemada bildirilmediği için akışa BAĞLANAMIYORDU"
         }
     },
-    'language-selector': { change: { payload: { value: 'string (dil kodu)' }, reads: 'runtime ayrıca machine.setLanguage(value) çağırır' } },
-    notification: { toggled: { payload: { isHidden: 'boolean' } } },
     otpinput: {
         mount: NO_DATA,
         change: valueChange('string (birleşik kod)'),
@@ -298,10 +525,22 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
-    pagination: { mount: NO_DATA, change: { payload: { offset: 'number', limit: 'number' }, reads: 'self.offset · self.limit (sorguyu bunlara bağla)' } },
-    progress: { complete: NO_DATA },
+    pagination: {
+        mount: NO_DATA,
+        change: {
+            payload: { offset: 'number (yeni sayfanın offset’i; limit değişince 0)', limit: 'number' },
+            reads: 'event.data.offset / event.data.limit ya da self.offset · self.limit — ikisi de dolu (sorguyu bunlara bağla). Yalnız offset ya da limit gerçekten değişince yayılır; akışın yazması yaymaz'
+        }
+    },
+    progress: { mount: NO_DATA, click: NO_DATA, complete: NO_DATA },
     rating: { mount: NO_DATA, change: valueChange('number (0..max; allowHalf ile yarım)'), focus: NO_DATA, blur: NO_DATA },
-    result: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
+    result: {
+        mount: NO_DATA,
+        actionClick: {
+            payload: { text: 'string (aksiyonun metni)', index: 'number' },
+            reads: "aksiyonun kendi flow'u zaten doğrudan çalışır. index GÖRÜNEN sıradır: isHidden satırlar çizilmeden ELENİR, yani gizli satırı olan bir listede index actions dizisindeki sıra DEĞİLDİR — akışı sıraya değil text'e ya da aksiyonun kendi flow'una bağla. isLoading açıkken HİÇ yayılmaz (iskelet çizilirken düğme de yoktur); isDisabled satır da yaymaz"
+        }
+    },
     slider: {
         mount: NO_DATA,
         change: valueChange('number (sürüklerken sürekli)'),
@@ -309,7 +548,7 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
-    statcard: { mount: NO_DATA, click: NO_DATA, footerClick: { payload: {}, reads: "footerFlow zaten doğrudan çalışır; footerHref varsa tıklama ona gider" } },
+    statcard: { mount: NO_DATA, click: { payload: {}, reads: "Yalnız bir akış bağlıysa yayılır; bağlıyken kartın ana yüzeyi <button> olur (alt satır bunun dışındadır)" }, footerClick: { payload: {}, reads: "Alt satır HER tıklamada yayar — footerHref verilmiş olsa bile; tarayıcı gezinirken akış yarıda kalabilir, isNewTabLink açıkken kalmaz" } },
     switcher: {
         mount: NO_DATA,
         change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her geçişte İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
@@ -318,15 +557,31 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
+    'theme-toggle': {
+        mount: NO_DATA,
+        change: {
+            payload: { value: "'light' | 'dark' | '' (boş = tercih temizlendi, projenin teması geçerli)" },
+            reads: "setter: self.value da yazılır. Kullanıcı tıklamasında yayılır. Akışın SETTER adımıyla value yazması temayı değiştirir ama bu olayı yaymaz (geri besleme döngüsü olurdu); CODE adımından yazmak (Page.components.x.value = 'dark') ise onEmit üzerinden gittiği için düğümün change akışlarını ÇALIŞTIRIR — ikisini karıştırma. Studio kanvasında hiç yayılmaz (_editorMode). Boş değer yalnız hasAutoMode açıkken çıkabilir"
+        }
+    },
     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
+        clickItem: {
+            payload: { currentItem: 'tıklanan olay öğesi (items’taki nesnenin tamamı)', index: 'number (items dizisindeki gerçek yer; reverse/maxCount’tan etkilenmez)' },
+            reads: "event.data.currentItem ve event.data.index ile oku; currentItem ayrıca self.currentItem'a yazılır, index self'e YAZILMAZ. Her satır tıklamasında yayılır; öğede flow varsa bu olayın akışı da öğenin kendi flow'u da çalışır (bu olay önce başlatılır, biri diğerini beklemez; ikisi de aynı event.data) — aynı akışı iki yere bağlarsan iki kez çalışır"
+        },
+        showMore: { payload: {}, reads: 'yalnız maxCount aşılınca çıkan "Show more" düğmesine basılınca; kalan öğelerin tamamı açılır ve düğme kaybolur (items yeni diziyle değişince yeniden çıkar)' }
     },
     timepicker: { mount: NO_DATA, change: { payload: { value: "string 'HH:mm' (temizlenince '')", selectedLabel: "seçilen saatin gösterilen metni — 12h kipinde '01:00 PM' (temizlenince '')" } }, focus: NO_DATA, blur: NO_DATA },
     toast: {
-        open: NO_DATA,
-        close: NO_DATA,
+        open: {
+            payload: {},
+            reads: 'Toast KUYRUĞA girdiğinde yayılır: delay kadar beklenir; duplicates ignore/count ile atılan ya da do-not-disturb ile bastırılan tetikleme open YAYMAZ. Aynı konumda 5 toast doluysa fazlası ekranda görünmeden de open yayar (görünürlük ayrı bir katman). isOpen’ı false’a döndüren change setter’ı bundan bağımsız, her tetiklemede hemen yayılır'
+        },
+        close: {
+            payload: { reason: "'timeout' | 'user' | 'programmatic'" },
+            reads: 'Toast kapanınca yayılır; akışta self.reason ile okunur. timeout = süre doldu; user = kullanıcı kapattı (× düğmesi, closeOnClick tıklaması, kaydırma, Escape, aksiyon düğmesi, Clear all); programmatic = koddan dismiss/dismissAll. duplicates ile atılan tetikleme ve delay beklerken iptal edilen toast close YAYMAZ'
+        },
         click: NO_DATA,
         actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" }
     },
@@ -350,47 +605,96 @@ export const componentEventContracts = {
     eventcalendar: {
         mount: NO_DATA,
         monthChange: {
-            payload: { month: 'number (1-TABANLI)', year: 'number' },
-            reads: "yük self'e YAZILMAZ — event.data ile oku; gezinme okları/Bugün ile her görünümde yayılır, ilk mount'ta yayılmaz"
+            payload: {
+                month: 'number (1-TABANLI, imlecin ayı)',
+                year: 'number',
+                view: "'month' | 'week' | 'day' | 'agenda'",
+                start: "string 'yyyy-MM-dd' (görünen ilk gün, dahil)",
+                end: "string 'yyyy-MM-dd' (görünen son gün, dahil)"
+            },
+            reads: "yük self'e YAZILMAZ — event.data ile oku; gezinme okları/Bugün ile her görünümde yayılır, ilk mount'ta yayılmaz, isLoading'de de yayılır. Veri sorgusunu start/end'e KESİŞİM olarak bağla: etkinlikBaşlangıç < end+1 gün VE etkinlikBitiş >= start (end tarih-yalnız ve dahil; ay ızgarası komşu ay günlerini, ajanda/hafta ay sınırını kapsar)"
+        },
+        viewChange: {
+            payload: {
+                view: "'month' | 'week' | 'day' | 'agenda'",
+                start: "string 'yyyy-MM-dd' (yeni görünümün ilk günü)",
+                end: "string 'yyyy-MM-dd' (yeni görünümün son günü)"
+            },
+            reads: "self'e yazılmaz — event.data ile oku; yalnız görünüm düğmesiyle yayılır (defaultView değişince yayılmaz)"
         },
-        viewChange: { payload: { view: "'month' | 'week' | 'day'" }, reads: "self'e yazılmaz — event.data ile oku" },
         dateClick: {
             payload: { date: "string 'yyyy-MM-dd'" },
-            reads: "yalnız AY görünümünde ve isCreatable KAPALIYKEN; self'e yazılmaz — event.data ile oku"
+            reads: "yalnız AY görünümünde, isCreatable KAPALIYKEN ve isLoading değilken; self'e yazılmaz — event.data ile oku"
         },
         eventCreate: {
-            payload: { start: "string (ay tıklaması: 'yyyy-MM-dd' · saat slotu: ISO)", end: 'string (slotta start+60dk)', allDay: 'boolean' },
-            reads: "self'e yazılmaz — event.data ile oku"
+            payload: {
+                start: "string (tüm gün: 'yyyy-MM-dd' · saatli: ISO)",
+                end: "string (tüm gün: son gün DAHİL 'yyyy-MM-dd' · saatli: ISO; tek slotta start+60dk, seçimde son slotun sonu)",
+                allDay: 'boolean'
+            },
+            reads: "self'e yazılmaz — event.data ile oku; tıklama ya da sürükleyerek aralık seçimi (fare/kalem; dokunmatikte yalnız tek hücre), bırakmada tek olay; etkinlik eklenmez, akış yazıp rows'u tazeler"
         },
         eventClick: {
             payload: { id: 'string', title: 'string', row: 'kaynak satırın TAMAMI' },
-            reads: "self'e yazılmaz — event.data ile oku"
+            reads: "self'e yazılmaz — event.data ile oku; ay/hafta/gün/ajanda hepsinde, isLoading'de yayılmaz"
         },
         eventMove: {
-            payload: { id: 'string', row: 'kaynak satırın TAMAMI', start: 'string (ISO)', end: 'string (ISO)', previousStart: 'string (ISO)', previousEnd: 'string (ISO)' },
-            reads: "self'e yazılmaz — event.data ile oku; akış kalıcılaştırıp rows'u tazelemezse taşınan etkinlik geri döner"
+            payload: {
+                id: 'string',
+                row: 'kaynak satırın TAMAMI',
+                start: "string (tüm gün: 'yyyy-MM-dd' · saatli: ISO)",
+                end: "string (tüm gün: 'yyyy-MM-dd' · saatli: ISO)",
+                previousStart: 'string (aynı biçim; ekranda görünen önceki aralık)',
+                previousEnd: 'string (aynı biçim)'
+            },
+            reads: "self'e yazılmaz — event.data ile oku; taşıma ve kenardan boyutlandırma aynı olay; akış kalıcılaştırıp rows'u tazelemezse etkinlik geri döner"
         }
     },
     importwizard: {
         mount: NO_DATA,
+        change: {
+            payload: {
+                currentStep: 'number (0 dosya · 1 eşleme · 2 önizleme)',
+                fileName: 'string (okunan dosyanın adı; henüz dosya yoksa "")',
+                rowCount: 'number (dosyadaki HAM veri satırı sayısı — doğrulamadan önce)'
+            },
+            reads: "adım her değiştiğinde yayılır; currentStep ve fileName düğüme de yazılır (self.currentStep), rowCount yalnız event.data'dadır"
+        },
         complete: {
             payload: {
                 rows: 'Record<string,string>[] (TEMİZ satırlar; değerler hep string)',
-                errors: 'Array<{ rowIndex, field, message, raw }>',
+                errors: 'Array<{ rowIndex, field, code, message, limit?, raw }> (code: required | maxRows)',
                 fileName: 'string',
                 total: 'number (temiz satır + hata KAYDI sayısı)'
             },
             reads: "hem self.rows/self.errors/… hem event.data dolu gelir (params kuşağı); satırları uca yazmak complete akışının işidir"
         },
-        cancel: NO_DATA
+        cancel: {
+            payload: {
+                currentStep: 'number (her zaman 0)',
+                fileName: 'string (her zaman "")',
+                rows: 'Record<string,string>[] (her zaman [])',
+                errors: 'Array<…> (her zaman [])',
+                total: 'number (her zaman 0)'
+            },
+            reads: '✕ sıfırlaması: aynı boş yük düğüme de yazılır, yani cancel sonrası self.rows/self.total bayat kalmaz'
+        }
     },
     kanban: {
         mount: NO_DATA,
         cardMove: {
             payload: { id: 'string', row: 'kaynak satırın TAMAMI', from: 'string (kaynak kolon value)', to: 'string (hedef kolon value)' },
-            reads: "BİLİNÇLİ olarak self'e yazılmaz — event.data ile oku; yeni kolonu uca yaz + rows'u tazele, yoksa kart geri döner"
+            reads: "BİLİNÇLİ olarak self'e yazılmaz — event.data ile oku; yeni kolonu uca yaz + rows'u tazele, yoksa kart geri döner. isLoading:true iken sürükleme başlamaz, olay yayılmaz"
         },
-        cardClick: { payload: { id: 'string', row: 'kaynak satırın TAMAMI' }, reads: "self'e yazılmaz — event.data ile oku" }
+        cardClick: { payload: { id: 'string', row: 'kaynak satırın TAMAMI' }, reads: "self'e yazılmaz — event.data ile oku; isLoading:true iken yayılmaz" },
+        cardAdd: {
+            payload: { column: 'string (düğmesine basılan kolonun value değeri)' },
+            reads: "self'e yazılmaz — event.data.column ile oku. Yalnız isAddable:true iken kolon altındaki düğmeden yayılır; kart EKLENMEZ — akış satırı uca yazıp rows'u tazeler (ya da form açar). isLoading:true iken yayılmaz"
+        },
+        cardRemove: {
+            payload: { id: 'string', row: 'kaynak satırın TAMAMI', column: 'string (kartın o anki kolonu; atanmamış kuyrukta ham değer)' },
+            reads: "self'e yazılmaz — event.data ile oku. Yalnız isRemovable:true iken kartın × düğmesinden yayılır, cardClick YAYMAZ; kart GİZLENMEZ — akış (onay alıp) satırı siler ve rows'u tazeler. isLoading:true iken yayılmaz"
+        }
     },
     signature: {
         mount: NO_DATA,
@@ -404,7 +708,7 @@ export const componentEventContracts = {
         mount: NO_DATA,
         stepChange: {
             payload: { currentStep: 'number (hedef adım, 0 tabanlı)', previous: 'number (önceki adım)' },
-            reads: "currentStep self'e yazılır; event.data da dolu gelir"
+            reads: "currentStep self'e yazılır; event.data da dolu gelir. Gizli adımlar atlanır (currentStep bir sonraki görünür adımın indeksidir, previous ile ardışık olmayabilir); previous kullanıcının GÖRDÜĞÜ adımdır (gizli adıma yazılmış currentStep değil); isLoading:true iken düğme ve başlıklar devre dışı, olay yayılmaz"
         },
         finish: { payload: { currentStep: 'number (son adımın indeksi)' }, reads: 'adımı değiştirmez; yalnız son adımda kapı açıkken yayılır' },
         validationFail: {