@appaflytech/zeyrek-ai-mcp 0.0.28 → 0.0.30

package/dist/knowledge/mobileComponentEvents.js

@@ -0,0 +1,239 @@
+/**
+ * MOBİLE ÖZGÜ olay yükleri. Mobil komponentlerin ÇOĞU web şemasını genişletir ve
+ * olayları web sözleşmesindedir (`componentEvents.ts`) — bu dosya yalnız web'de
+ * karşılığı OLMAYAN komponentler içindir (`app-bar` gibi kabuk komponentleri).
+ *
+ * Okuyucu önce buraya, sonra web sözlüğüne bakar; parity testi
+ * (`test/mobile-component-parity.test.ts`) her mobil olayın iki sözlükten
+ * birinde karşılanmasını zorunlu tutar.
+ */
+const NO_DATA = { payload: {} };
+export const mobileComponentEventContracts = {
+    'choice-chips': {
+        change: {
+            payload: {
+                value: 'string | number | boolean | Array — seçenek ÖZGÜN tipinde (değeri `34` yazılmış seçenek sayı yayar). `multiple` açıkken seçili değerlerin DİZİSİ (`[34, "a"]`); tek kipte seçili çipe yeniden dokunmak boş metin (`""`) yayar. Devre dışı seçenek olay yaymaz.'
+            }
+        }
+    },
+    // Web ikizinin yükü metindir (`e.currentTarget.value`); mobil seçeneği ÖZGÜN tipinde yayar (f-06, `optionEmitValues`).
+    // İki platformda aynı koşul için karşılaştırmayı metne çevirin: `String(self.value) === '34'`.
+    radio: {
+        change: {
+            payload: {
+                value: 'string | number | boolean — seçilen seçeneğin ÖZGÜN değeri (değeri `34` yazılmış seçenek sayı yayar; web aynı seçimi `"34"` metni olarak yayar)'
+            }
+        }
+    },
+    checkboxgroup: {
+        change: {
+            payload: {
+                value: 'Array — seçili seçeneklerin ÖZGÜN değerleri (`["su", 9]`; web metin dizisi yayar). Seçeneklerde olmayan eski değer metin kalır'
+            }
+        }
+    },
+    tooltip: {
+        open: NO_DATA
+    },
+    calendar: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string 'yyyy-MM-ddT00:00:00' | null — seçilen gün (aralıkta başlangıç); web datepicker'ın biçimi: yerel duvar saati, gece yarısı, dilim eki yok",
+                endValue: "string 'yyyy-MM-ddT00:00:00' | null — YALNIZ mode: 'range'; ilk basışta null, ikinci basışta bitiş günü"
+            }
+        }
+    },
+    stack: {
+        mount: NO_DATA
+    },
+    'list-item': {
+        click: NO_DATA
+    },
+    fab: {
+        click: NO_DATA
+    },
+    'photo-viewer': {
+        change: { payload: { index: 'number — gösterilen fotoğrafın sırası (0 tabanlı); makine index prop\'una yazar' } },
+        close: { payload: {}, reads: 'kapat düğmesi ya da geri; makine isOpen\'ı kapatır' },
+        share: { payload: { row: 'gösterilen satırın tamamı (images dizisindeki nesne)', index: 'number — satırın sırası' }, reads: 'Paylaş düğmesi yalnız bu olay bir akışa bağlıysa çizilir; paylaşmak akışın işidir' },
+        delete: { payload: { row: 'gösterilen satırın tamamı', index: 'number — satırın sırası' }, reads: 'Sil düğmesi yalnız bu olay bir akışa bağlıysa çizilir; satırı silmek ve listeyi yenilemek akışın işidir' }
+    },
+    timer: {
+        mount: NO_DATA,
+        tick: { payload: { value: 'number — gösterilen saniye (geri sayımda kalan, kronometrede geçen); makine value prop\'una yazar' } },
+        finish: { payload: { isRunning: 'false — geri sayım 0\'a indi; makine isRunning\'i kapatır' } }
+    },
+    audio: {
+        mount: NO_DATA,
+        play: { payload: { isPlaying: "true — çalma başladı (denetim ya da akış); makine isPlaying'i yazar" } },
+        pause: { payload: { isPlaying: "false — çalma durdu (denetim, akış, bitiş ya da tarayıcının otomatik oynatma reddi); makine isPlaying'i yazar" } },
+        ended: { payload: { isPlaying: "false — ses sona vardı (loop kapalıyken, pause'tan sonra); makine isPlaying'i kapatır" } }
+    },
+    lottie: {
+        mount: NO_DATA,
+        finish: { payload: { isPlaying: "false — döngüsüz animasyon bitti; makine isPlaying'i kapatır, yeniden true yazmak baştan oynatır" } }
+    },
+    webview: {
+        mount: NO_DATA,
+        load: { payload: {}, reads: "her tamamlanan yüklemede yayılır (izin verilen gezinmeden sonra da); cihazda yüklenemeyen sayfada yayılmaz (yerine error), web'de tarayıcı engellenen çerçevede de yayar" },
+        navigate: { payload: { url: "string — sayfanın gitmek istediği adres; makine url prop'una yazar (self.url). allowNavigation kapalıyken (varsayılan) gezinme engellenir; adres yalnız kullanıcının dokunduğu bağlantıda sistemde açılır" } },
+        message: {
+            payload: { data: "string — sayfanın window.ReactNativeWebView.postMessage(metin) ile yolladığı metin, olduğu gibi; makine data prop'una yazar (self.data)" },
+            reads: "iki yönlü köprü: sayfa window.ngApps.emit(name, data) çağırırsa yük olayın params'ında gelir — akış event.name ve event.data okur (self.data yazılmaz)"
+        },
+        error: { payload: {}, reads: "cihazda sayfa yüklenemeyince (ağ hatası) yayılır, görünüm yer tutucu çizer; web'de pratikte gelmez (iframe gibi)" }
+    },
+    html: {
+        mount: NO_DATA,
+        message: {
+            payload: {},
+            reads: "belgenin window.ngApps.emit(name, data) çağrısı; yük olayın params'ındadır — akış event.name (ileti adı) ve event.data (veri) okur. actions satırının akışı ise fireEvent(key, data) ile koşar: event.name = key, event.data = veri"
+        }
+    },
+    map: {
+        mount: NO_DATA,
+        markerClick: { payload: { markerId: "string — dokunulan işaretçinin `id`si (boşsa listedeki sırası); makine markerId prop'una yazar (self.markerId). Başlığı ya da açıklaması olan işaretçide balon da açılır" } },
+        regionChange: {
+            payload: {
+                latitude: 'number — kullanıcının bıraktığı merkezin enlemi (6 basamak)',
+                longitude: 'number — merkezin boylamı (6 basamak, −180…180)',
+                zoom: 'number — web harita ölçeği (2 basamak, 1–19)'
+            },
+            reads: "yalnız kullanıcının sürüklemesi ya da yakınlaştırması bitince yayılır; akışın yazdığı görünüm ve kutu boyu değişimi yaymaz. Makine üç prop'u da yazar (self.latitude, self.longitude, self.zoom)"
+        },
+        press: {
+            payload: {
+                latitude: 'number — yerin enlemi: tek işaretçi varsa o işaretçi, yoksa görünümün merkezi',
+                longitude: 'number — yerin boylamı',
+                mapsUrl: "string — yeri cihazın harita uygulamasında açan adres (iOS Apple Haritalar https://maps.apple.com/?ll=…&q=<ad>, Android geo:<lat>,<lng>?q=…(<ad>), web Google Haritalar araması)"
+            },
+            reads: "işaretçi dışına dokunuşta yayılır (interactive: false önizlemede bütün yüzey). Makine YALNIZ mapsUrl'i düğüme yazar (self.mapsUrl) — koordinat yazılsaydı harita kayardı; koordinat event.data'dadır. Tarif: redirect isRaw: true, path: '<harita>.mapsUrl'"
+        }
+    },
+    markdown: {
+        mount: NO_DATA,
+        linkClick: {
+            payload: {
+                href: "string — dokunulan bağlantının ham adresi; şema süzülmeden gelir (dışarıda yalnız http(s), mailto, tel açılır)"
+            }
+        }
+    },
+    'app-bar': {
+        clickBack: NO_DATA,
+        clickMenu: NO_DATA,
+        clickAction: { payload: { key: 'string (eylemin key alanı; yoksa dizideki sırası)' } }
+    },
+    'safe-area': {
+        mount: NO_DATA
+    },
+    // Web `container` yalnız `mount` yayar; `click` mobile-only (plans/mobil-plantcare-acigi f-04, K1).
+    container: {
+        click: NO_DATA
+    },
+    // Arama varyantının "Vazgeç"i (plans/mobil-plantcare-acigi f-05): değer temizlenir, klavye kapanır.
+    textinput: {
+        cancel: NO_DATA
+    },
+    'scroll-view': {
+        mount: NO_DATA,
+        scrollEnd: NO_DATA,
+        refresh: NO_DATA,
+        scroll: {
+            payload: {
+                y: 'number — dikey kaydırma konumu (yatay kaydırıcıda x)',
+                contentHeight: 'number — içeriğin boyu (yatayda contentWidth)',
+                viewportHeight: 'number — görünen alanın boyu (yatayda viewportWidth)'
+            },
+            reads: '100 ms seyreltmeli; yalnız bu olaya akış bağlıyken yayılır. Düğüme scrollY (scrollX) de yazılır'
+        }
+    },
+    'grouped-list': {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                selectedIndex: 'number — dokunulan öğenin rows içindeki DÜZ indeksi (bölüm içi değil); aynı öğeye yeniden dokununca yayılmaz. Makine selectedIndex\'i yazar, akışta tıklanan satır <liste>.selectedItem'
+            }
+        },
+        itemPress: {
+            payload: {
+                index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
+                row: 'object (öğenin satır verisi)'
+            },
+            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (list-item, button) dokunuş onun click\'ine gider, itemPress yayılmaz'
+        },
+        swipe: {
+            payload: {
+                key: 'string (kaydırma eyleminin key alanı)',
+                index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
+                row: 'object (öğenin satır verisi)'
+            }
+        },
+        sectionPress: {
+            payload: {
+                key: 'string — bölüm anahtarı (tarih değerinde yerel gün YYYY-AA-GG)',
+                title: 'string — bölüm başlığı (anahtar; boş alanlı satırların bölümünde otherSectionTitle)',
+                count: 'number — bölümdeki öğe sayısı',
+                items: 'object[] — bölümdeki satırların verisi'
+            },
+            reads: 'bölüm başlığına dokununca; yük başlık şablonunun Section ifadesiyle aynı nesnedir'
+        },
+        selectionChange: {
+            payload: {
+                selectedIndices: 'number[] — seçili satırların rows içindeki DÜZ indeksleri, sıralı',
+                count: 'number — seçili satır sayısı'
+            },
+            reads: 'yalnız selectionMode: multiple (ya da longPressSelects ile açılınca); akış event.data.selectedIndices / event.data.count okur, düğümün selectedIndices/selectedItems değeri de yazılır'
+        }
+    },
+    eventcalendar: {
+        mount: NO_DATA,
+        dateClick: {
+            payload: { date: "string 'yyyy-MM-dd'", rows: 'object[] — o güne düşen kaynak satırlar (mobil)' },
+            reads: "self'e yazılmaz — event.data ile oku; ay ve hafta görünümünde güne dokununca"
+        },
+        eventClick: {
+            payload: { id: 'string', title: 'string', row: 'kaynak satırın TAMAMI' },
+            reads: "self'e yazılmaz — event.data ile oku; gün çizelgesinde bloğa dokununca"
+        },
+        monthChange: {
+            payload: {
+                month: 'number (1-TABANLI)',
+                year: 'number',
+                view: "'month' | 'week' | 'day'",
+                start: "string 'yyyy-MM-dd' (görünen ilk gün)",
+                end: "string 'yyyy-MM-dd' (görünen son gün)"
+            },
+            reads: "self'e yazılmaz — event.data ile oku; oklar, yatay kaydırma ve Bugün ile her görünümde"
+        },
+        viewChange: {
+            payload: { view: "'month' | 'week' | 'day'", start: "string 'yyyy-MM-dd'", end: "string 'yyyy-MM-dd'" },
+            reads: "self'e yazılmaz — event.data ile oku; görünüm düğmesiyle"
+        }
+    },
+    'floating-container': {
+        mount: NO_DATA
+    },
+    repeater: {
+        swipe: {
+            payload: {
+                key: 'string (kaydırma eyleminin key alanı)',
+                index: 'number (satırın sırası, 0 tabanlı)',
+                row: 'object (satırın verisi)'
+            }
+        },
+        itemPress: {
+            payload: {
+                index: 'number (satırın sırası, 0 tabanlı)',
+                row: 'object (satırın verisi)'
+            }
+        },
+        selectionChange: {
+            payload: {
+                selectedIndices: 'number[] — seçili satırların rows içindeki DÜZ indeksleri, sıralı',
+                count: 'number — seçili satır sayısı'
+            },
+            reads: 'yalnız selectionMode: multiple (ya da longPressSelects ile açılınca); akış event.data.selectedIndices / event.data.count okur, düğümün selectedIndices/selectedItems değeri de yazılır'
+        }
+    }
+};