@appaflytech/zeyrek-ai-mcp 0.0.32 → 0.0.33

package/dist/knowledge/componentEvents.js

@@ -116,9 +116,8 @@ export const componentEventContracts = {
     layout: { mount: NO_DATA, logout: NO_DATA },
     'layout-shell': {
         mount: NO_DATA,
-        // LayoutShell.svelte announce(): sidebarOpen her değiştiğinde (overlay, Escape, akış, Durum
-        // bağlaması — SHELL-009) dispatch('emit', { name, data, params }). `params` VERİLDİĞİ için bu olay
-        // istisnadır: sidebarOpen hem self.sidebarOpen'dan hem event.data'dan okunur.
+        // LayoutShell.svelte toggle(): dispatch('emit', { name, data, params }) — `params` VERİLDİĞİ
+        // için bu olay istisnadır: sidebarOpen hem self.sidebarOpen'dan hem event.data'dan okunur.
         toggle: { payload: { sidebarOpen: 'boolean (panelin YENİ durumu)' }, reads: 'self.sidebarOpen; params verildiği için event.data.sidebarOpen de dolar' }
     },
     'layout-region': { mount: NO_DATA },
@@ -434,11 +433,8 @@ export const componentEventContracts = {
     'breadcrumb-title': {
         mount: 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)',
-                index: 'number (items dizisindeki GERÇEK yer; gizli öğeler kaydırmaz)'
-            },
-            reads: "event.data.currentItem.key ve event.data.index ile oku (2026-09-30'dan önce event.data BOŞ geliyordu — QA BT-002). Öğenin kendi flow'u varsa ÖNCE o çalışır ve AYNI yükü event.data'dan alır, sonra clickItem yayılır. currentItem düğüme de yazılır ama self.currentItem ifade yüzeyine yalnız kayıtlı düğüm o anahtarı taşıyorsa çıkar (ARC-096) — güvenilir yol event.data'dır; index self'e YAZILMAZ. breadcrumb'ın aksine olay bağlı akış olmasa da yayılır (tıklama düğüme currentItem yazar)."
+            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: {},
@@ -458,11 +454,11 @@ export const componentEventContracts = {
     },
     chart: {
         mount: NO_DATA,
-        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' },
+        dataPointClick: { payload: { name: 'string (kategori); scatter grafiğinde x değeri', seriesName: 'string', value: 'number | null; scatter grafiğinde y', dataIndex: 'number (çizimdeki sıra)', row: 'kaynak satırın TAMAMI | null' }, reads: 'YALNIZ seri noktasına basışta; eksen etiketi tıklaması axisLabelClick’tir (2026-09-16 öncesinde o da boş bir dataPointClick üretiyordu), hedef çizgisi (referenceLines) ve bant (plotBands) olay değildir. row kategori adıyla — scatter’da x değeriyle — bulunur (nullMode skip ya da huni sıralaması dataIndex`i kaydırır); kategorisi olmayan noktada (histogram kutusu, radar serisi, funnelflow düğümü/bağı) null. 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ı' } },
+        selectionChange: { payload: { selected: 'seçili veri noktaları' }, reads: "yalnız selectionMode 'single'/'multi' iken; 'none' iken ECharts'ın her tıklamada attığı boş seçim yayılmaz (2026-09-25 öncesi yayılıyordu)" },
         legendClick: { payload: { name: 'string (seri adı)', selected: 'seri → görünürlük haritası' } },
-        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)' },
+        axisLabelClick: { payload: { value: 'string (tıklanan eksen etiketi)' }, reads: 'yalnız kategori ekseninin etiketine basışta; kategori ekseni hangi eksene düşerse oradan gelir — yatay yönelimde yAxis (2026-09-16 öncesinde yatayda hiç yayılmıyordu). Nokta tıklaması ve eksen başlığı (categoryAxis.title) bu olayı yaymaz — 2026-09-25 öncesinde nesne sorgusu süzmediği için her nokta tıklamasında noktanın değeriyle yayılı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
@@ -470,7 +466,7 @@ export const componentEventContracts = {
     checkboxgroup: { mount: NO_DATA, change: valueChange('string[] (seçili değerler)'), focus: NO_DATA, blur: NO_DATA },
     emptystate: {
         mount: NO_DATA,
-        actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "event.data.text / event.data.index (2026-10-01, QA ES-005; self.text / self.index de yazılır). Aksiyonun kendi flow'u varsa tıklamada YALNIZ o akış koşar, bu olaya bağlı akış kendi flow'u olmayan aksiyonlarda koşar; 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ç" }
+        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,
@@ -542,7 +538,7 @@ export const componentEventContracts = {
         mount: NO_DATA,
         actionClick: {
             payload: { text: 'string (aksiyonun metni)', index: 'number' },
-            reads: "event.data.text / event.data.index (2026-10-01, QA RS-004; self.text / self.index de yazılır). Aksiyonun kendi flow'u varsa tıklamada YALNIZ o akış koşar, bu olaya bağlı akış kendi flow'u olmayan aksiyonlarda koşar. 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"
+            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: {
@@ -584,10 +580,10 @@ export const componentEventContracts = {
         },
         close: {
             payload: { reason: "'timeout' | 'user' | 'programmatic'" },
-            reads: 'Toast kapanınca yayılır; neden akışta event.data.reason ile okunur (2026-10-01, QA TS-006; self.reason da yazılmaya devam eder). 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'
+            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: "event.data.text / event.data.index (2026-10-01, QA TS-006). Yalnız kendi flow'u OLMAYAN aksiyonda koşar: aksiyonun flow'u varsa tıklamada o akış çalışır, bu olaya bağlı akış çalışmaz" }
+        actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" }
     },
     'qm-header': {
         mount: NO_DATA,
@@ -725,13 +721,19 @@ export const eventPayloadNote = "Olay yükü motorda komponentin KENDİ prop'una
     "self.<anahtar> ile okunur — payload anahtarları aynı zamanda o prop'ların adıdır. " +
     "event.data ESKİ kuşak komponent olaylarında BOŞ gelir: motor akışı emit'in params'ıyla başlatır ve " +
     "event.data = params.data'dır (html actions/fireEvent ile 2026-08-27 kuşağı — eventcalendar · " +
-    "importwizard · kanban · signature · stepper — ve QA turlarında params eklenen tabs · breadcrumb-title · " +
-    "toast · result · emptystate bu yoldan doldurur; ayrım tekil sözleşme notlarında). " +
+    "importwizard · kanban · signature · stepper — bu yoldan doldurur; ayrım tekil sözleşme notlarında). " +
     "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;
+/**
+ * `platformContracts` platforma özgü sözlüktür (mobilde `mobileComponentEvents.ts`): aynı olayda
+ * web sözleşmesinin ÖNÜNE geçer, web'de karşılığı olmayan bileşenin tek kaynağıdır.
+ */
+export function eventContractsFor(slug, names, platformContracts) {
+    const own = (source) => slug !== undefined && source !== undefined && Object.hasOwn(source, slug) ? source[slug] : undefined;
+    const web = own(componentEventContracts);
+    const platform = own(platformContracts);
+    const contracts = web || platform ? { ...web, ...platform } : undefined;
     return names.map(name => {
         const contract = contracts?.[name];
         if (!contract)