@appaflytech/zeyrek-ai-mcp 0.0.28 → 0.0.30

package/dist/knowledge/componentEvents.js

@@ -19,7 +19,16 @@ export const componentEventContracts = {
         rowChange: { payload: {}, reads: 'self.selectedRow (düzenlenen satır, YENİ değeriyle) — satır nesnesi self.rows içinde de yerinde güncellenir; değer gerçekten değişmediyse olay çalışmaz' }
     },
     datatable: {
-        mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' }
+        mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' },
+        save: {
+            payload: {},
+            reads: "self.changeset = { inserted:[{ rowId, values }], updated:[{ rowId, id, patch }], deleted:[{ rowId, id }] } (komponent olaydan ÖNCE yazar). Bağlı tabloda (rows connectData) yazmayı runtime bağlantısı yapar, akış ardından koşar; hatalar self.rowErrors [{ rowId, field?, message }]. İşlemin bağlamı da olaydan ÖNCE yazılır (2026-09-21): self.operation (rowAdd|rowEdit|cellEdit|rowDelete|bulkEdit|bulkDelete|batchSave), self.editedRows (tam satırlar), self.deletedRows (silinen tam satırlar), self.editedCell ({ rowId, field, value, previousValue }, yalnız cellEdit), self.bulkPatch (yalnız bulkEdit). Her işlem için ayrı olay yoktur; tek save akışı self.operation ile ayırır"
+        },
+        discard: { payload: {}, reads: 'self.discardedRowIds (vazgeçilen taslak satır kimlikleri)' },
+        rowClick: { payload: {}, reads: 'self.selectedRow (tıklanan satırın sunucu satırı; kaydedilmemiş yeni satırda taslak değerleri). Veri hücresine tıklamada yayılır — onay kutusu, ✏/🗑 ve aksiyon düğmeleri tetiklemez; çift tık önce iki rowClick üretir' },
+        rowDoubleClick: { payload: {}, reads: 'self.selectedRow (çift tıklanan satır). Düzenleme kipi açıksa satır/hücre ayrıca düzenlemeye açılır; editMode none tabloda detay sayfasına gitmek gibi akışlar için' },
+        cellSelectionChange: { payload: {}, reads: "self.selectedCells = { column, rowIds[], anchorRowId } (aynı kolonda Shift aralık, Ctrl/Alt tekil; yalnız düzenlenebilen hücreler)" },
+        rowSelectionChange: { payload: {}, reads: 'self.selectedRows (seçili satırların sunucu satırları; onay kutusu kolonu yalnız bulkActions açık ve editMode none değilken vardır)' }
     },
     button: { mount: NO_DATA, click: NO_DATA },
     card: {
@@ -105,7 +114,7 @@ export const componentEventContracts = {
     comments: {
         mount: NO_DATA,
         submit: {
-            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)' },
+            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)', process: "{ scope: 'task' | 'instance', targetId, visibility, body (@Ad → @<id>), mentionUserIds } | null (serbest yorumda null)" },
             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 (currentUser — işlemi yapan)' }, reads: 'beğeni de iyimserdir; sayaç rows tazelenene kadar yerel. isDisabled/isReadonly/isViewmode açıkken yayılmaz' },
@@ -361,6 +370,7 @@ export const componentEventContracts = {
     sidebar: { mount: NO_DATA },
     html: { mount: NO_DATA },
     view: { mount: NO_DATA },
+    'datatable-cell': { mount: NO_DATA },
     'widget-area': { mount: NO_DATA },
     'document-editor': { mount: NO_DATA },
     video: {
@@ -454,11 +464,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
@@ -715,6 +725,114 @@ export const componentEventContracts = {
             payload: { currentStep: 'number (engellenen adım)', previous: 'number (aynı değer)' },
             reads: 'YALNIZ İleri düğmesinden yayılır; engellenen başlık tıklaması sessiz kalır'
         }
+    },
+    'task-inbox': {
+        mount: NO_DATA,
+        tabChange: {
+            payload: { tab: "string (mine | group | delegated | started | done | planned)", scope: 'string (app | realm)' },
+            reads: "setter: activeTab self'e yazılır; tab ve scope event.data ile gelir"
+        },
+        taskClick: { payload: { taskId: 'string', row: 'tıklanan satırın TAMAMI' }, reads: "self'e yazılmaz — event.data ile oku" },
+        claim: { payload: { taskId: 'string', version: 'string (optimistic sürüm)', row: 'satırın TAMAMI' }, reads: "self'e yazılmaz — event.data ile oku; process.task.claim { id: taskId, version }" },
+        bulkClaim: { payload: { taskIds: 'string[]', rows: 'seçili ve üstlenilebilir satırlar' }, reads: "self'e yazılmaz — event.data ile oku" },
+        search: { payload: { q: 'string (kırpılmış, boş gönderilmez)' }, reads: "self'e yazılmaz — event.data ile oku; rows ← process.task.list { tab, q } sonucu; appliedFilter sistem ucunda yok — rozet gerekiyorsa Page.bpm.tasks(tab, { q }).appliedFilter" },
+        clearFilter: { payload: {}, reads: "self'e yazılmaz; appliedFilter ← null ve liste q'suz yeniden okunur" }
+    },
+    'task-actions': {
+        mount: NO_DATA,
+        action: {
+            payload: { action: "string (approve | reject | complete | request-info | provide-info | reassign | sign | start-assessment | submit-assessment | özel eylem id)", taskId: 'string', version: "string? (start-assessment ve submit-assessment yükünde YOKTUR: sınavı açmak görevi üstlenir ve sürümü ilerletir, panelin çizildiği sürüm bayattır — gönderilse 409 alınır)", comment: 'string?', payload: "object? (sign: payload.signature = { meaning, email?, password }; submit-assessment: payload.answers = { soruId: cevap })", targetUserId: 'string? (reassign)' },
+            reads: "self'e yazılmaz — event.data ile oku; boş alanlar yükte hiç yoktur"
+        },
+        assistantSummary: { payload: { taskId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; assistant ← await Page.bpm.task(taskId).assistant()" },
+        assistantAsk: { payload: { taskId: 'string', question: 'string (kırpılmış)' }, reads: "self'e yazılmaz — event.data ile oku; assistant ← await Page.bpm.task(taskId).assistant(question)" }
+    },
+    'process-timeline': {
+        mount: NO_DATA,
+        clickItem: { payload: { currentItem: 'tıklanan satır ({ key, kind, nodeId, taskId, title, actor, decision, round, isSuperseded })', index: 'number' }, reads: "self'e yazılmaz — event.data ile oku" },
+        exportLedger: { payload: {}, reads: 'yük yok — akış Page.bpm.instance(instanceId).exportLedger() ile CSV metnini alır' },
+        verifyLedger: { payload: {}, reads: "yük yok — akış process.instance.ledger.verify { id: instanceId } sonucunu (isValid, brokenAtSequence) ledgerStatus/brokenAtSequence'e yazar" }
+    },
+    'process-monitor': {
+        mount: NO_DATA,
+        filter: {
+            payload: { filter: 'object (güncel süzgeç: definitionId, state, unitId, priority, slaBreached …)', query: 'object (process.instance.list için yalnız sunucu alanları)' },
+            reads: "event.data ile oku; filter prop'u komponent içinde de güncellenir"
+        },
+        clickItem: { payload: { currentItem: 'tıklanan satırın TAMAMI (currentNodes, ageHours, slaStatus dahil)', index: 'number' }, reads: "self'e yazılmaz — event.data ile oku" },
+        instanceAction: {
+            payload: { operation: 'string (retry | skip | assign)', instanceId: 'string', nodeId: 'string? (ilk bekleyen adım)', taskIds: 'string[] (sahipsiz görevler)', reason: 'string?', targetUserId: 'string? (assign)', dueAt: 'string?', targetNodeId: 'string?' },
+            reads: "self'e yazılmaz — event.data ile oku; retry → process.instance.retry { id, reason }, skip → process.instance.skip { id, nodeId, reason }, assign → process.batch.execute { kind: 'reassign', taskIds, targetUserId, reason }"
+        },
+        bulkAction: {
+            payload: { operation: 'string (reassign | extend-due | suspend | jump | cancel)', instanceIds: 'string[] (uygun durumdaki seçili örnekler)', taskIds: 'string[] (yalnız reassign/extend-due)', fromNodeIds: 'object? (yalnız jump: { instanceId: bekleyen ilk adım })', reason: 'string?', targetUserId: 'string?', dueAt: 'string? (UTC ISO; yerel girişten çevrilir)', targetNodeId: 'string?' },
+            reads: "self'e yazılmaz — event.data ile oku; boş alanlar yükte hiç yoktur. reassign/extend-due → process.batch.execute { kind: operation, taskIds, … }; diğerleri örnek başına process.instance.<operation> { id, … } (jump: { fromNodeId: fromNodeIds[id], targetNodeId, reason }) — akış grafiğinde condition → microservice → code döngüsüyle"
+        },
+        undo: { payload: { batchOperationId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.batch.undo { id: batchOperationId }" }
+    },
+    'process-variants': {
+        mount: NO_DATA,
+        select: {
+            payload: { value: "string (düğüm kimlikleri '>' ile birleşik)", path: 'string[]', instanceCount: 'number', sampleInstanceIds: 'string[] (en çok beş örnek)' },
+            reads: "value self'e yazılır (setter); path ve örnekler event.data ile okunur"
+        },
+        clickInstance: { payload: { instanceId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.instance.get { id: instanceId }" },
+        download: { payload: { format: 'string (xes | ocel)' }, reads: "self'e yazılmaz — event.data ile oku; Page.bpm.exportLog(slug, format, { from, to })" }
+    },
+    'read-proof-matrix': {
+        mount: NO_DATA,
+        remind: {
+            payload: { revision: 'string', instanceId: 'string?', userIds: 'string[] (bekleyen okuyucular)' },
+            reads: "self'e yazılmaz — event.data ile oku; okumayanlara bildirim gönderen akışı çağır"
+        }
+    },
+    'case-view': {
+        mount: NO_DATA,
+        action: {
+            payload: { action: 'string (discretionary | start | complete | disable | enable)', itemId: 'string', planItemId: "string ('' — discretionary)" },
+            reads: "self'e yazılmaz — event.data ile oku; Page.bpm.cases.act(caseInstanceId, event.data), sonra view'i yeniden setter yaz"
+        },
+        clickTask: { payload: { taskId: 'string', planItemId: 'string', itemId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.task.get { id: taskId }" }
+    },
+    'delegation-editor': {
+        mount: NO_DATA,
+        save: {
+            payload: { fromUserId: 'string? (yalnız başkası adına)', toUserId: 'string', startsAt: 'string (ISO)', endsAt: 'string? (ISO)', processSlugs: 'string[] (boş = tüm süreçler)', reason: 'string?' },
+            reads: "self'e yazılmaz — event.data ile oku; process.delegation.create (event.data alanları). Yalnız istemci doğrulaması geçince yayılır"
+        },
+        end: { payload: { delegationId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.delegation.end { id: delegationId }" }
+    },
+    'handover-wizard': {
+        mount: NO_DATA,
+        stepChange: { payload: { step: 'string (tasks | ownership | confirm)', index: 'number' }, reads: "self'e yazılmaz — event.data ile oku" },
+        apply: {
+            payload: { userId: 'string', decisions: '[{ kind, key, target, targetUserId? }]', force: 'boolean', deactivate: 'boolean' },
+            reads: "self'e yazılmaz — event.data ile oku; process.handover.apply { userId, decisions, force }"
+        }
+    },
+    'notification-center': {
+        mount: NO_DATA,
+        open: { payload: { notificationId: 'string', link: 'string?', taskId: 'string?', instanceId: 'string?', markRead: 'boolean (okunmamış satırda true)' }, reads: "self'e yazılmaz — event.data ile oku" },
+        read: { payload: { notificationId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.notification.read { id: notificationId }" },
+        ack: { payload: { notificationId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.notification.ack { id: notificationId }" },
+        markAllRead: { payload: { notificationIds: 'string[] (okunmamışlar)' }, reads: "self'e yazılmaz — event.data ile oku; her kimlik için read()" },
+        savePreference: {
+            payload: { mode: 'string (immediate | digest | sla-only)', digestAt: "string ('HH:mm:00')", quietFrom: "string | null", quietTo: "string | null", timeZone: 'string' },
+            reads: "self'e yazılmaz — event.data ile oku; process.notification-preference.update (event.data alanları)"
+        }
+    },
+    'approval-chain-editor': {
+        mount: NO_DATA,
+        save: {
+            payload: { definitionId: 'string', baseVersion: 'number (aktif sürüm)', overrideRevision: 'number (okunan revizyon; uyarlama yoksa 0)', patch: 'JsonPatchOperation[] (aktif sürüme karşı tam uyarlama, seçicili yollar)' },
+            reads: "self'e yazılmaz — event.data ile oku; process.override.save { id: definitionId, baseVersion, overrideRevision, patch }. Yalnız istemci doğrulaması geçince yayılır"
+        },
+        reset: { payload: { definitionId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.override.reset { id: definitionId }" },
+        migrateOpen: { payload: { definitionId: 'string' }, reads: "self'e yazılmaz — event.data ile oku; process.override.migrate-open { id: definitionId }" },
+        simulate: {
+            payload: { definitionId: 'string', subjectRowId: 'string?', overridePatch: 'JsonPatchOperation[] (kaydedilmemiş uyarlama)' },
+            reads: "self'e yazılmaz — event.data ile oku; process.override.simulate { id: definitionId, subjectRowId, overridePatch } sonucunu simulation prop'una yaz"
+        }
     }
 };
 export const eventPayloadNote = "Olay yükü motorda komponentin KENDİ prop'una yazılır (FlowMachine.onEmit → setNode) ve akışta " +
@@ -725,8 +843,15 @@ export const eventPayloadNote = "Olay yükü motorda komponentin KENDİ prop'una
     "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)