@appaflytech/zeyrek-ai-mcp 0.0.14 → 0.0.15

package/dist/resources/guides/component.md

@@ -29,6 +29,14 @@ component_get   → tek tipin TAM sözleşmesi, üç katman birleşik:
 - **Boyut:** `blocks[].size` katalogdaki `maxSize`'ı aşamaz; yükseklikte
   `appearance.heightType: 'auto'` tercih edilir. Katalog varsayılanı bazı tiplerde kendi
   sınırını aşar — körü körüne kopyalama, gateway kırpar ve bildirir.
+- **Çocuk tarafı flex sözleşmesi — `mode: 'flex'` (2026-09-18):** flex kapta kalan alanı alan
+  öğe komponent değil onu taşıyan düğüm sarmalayıcısıdır ve sarmalayıcının `flex`i ortak
+  katmanda yazılır. `mode` prop'u `'flex'` olan bir çocuk (bugün yalnız `spacer`) kabın ANA
+  ekseninde kalanı ister: sütunda kalan yükseklik, satırda kalan genişlik, sıfır taban (wrap
+  açıkken satırdan düşmez). `appearance.widthType`/`heightType`'tan bağımsızdır ve ana
+  eksende onları yener; kabın ölçüsü o eksende belirli olmalıdır (auto/hug sütunda kalan
+  alan yoktur). Komponentin kendi `style`'ından istenemez — `style`'a `flex` yazma tablosuna
+  bkz. aşağıda.
 
 ### Arayüz metni ve biçimler uygulama dilini izler
 

package/dist/resources/guides/page.md

@@ -93,8 +93,9 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   komponentin iç kimliğidir (aşağıda Kural 2, `FLOW-018`).
 
 - **`blocks[].size`'ı komponentin `component_get`'teki `minSize`..`maxSize` aralığında tut.** Dikkat:
-  katalog varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü
-  körüne kopyalama. Sınır grid kanvasının kuralıdır; API 2026-09-15'ten beri reddetmez, ama aşan
+  katalog varsayılanı aşabiliyor (`datepicker` default `h:8`, `maxSize` `h:5`; 18 şemada aynı
+  durum, liste zeyrek-frontend `docs/issues.md` ARC-013 — `page-header` 2026-09-18'de sınırı
+  12'ye açarak çıktı) — varsayılanı körü körüne kopyalama. Sınır grid kanvasının kuralıdır; API 2026-09-15'ten beri reddetmez, ama aşan
   blok kanvasta boyutlandırılamaz (aşağıda Kural 7 "Boyut tuzağı").
 - **Kurulmuş bir düğümün boyutunu `resize_component` micro-op'u değiştirir.**
   `{ op: 'resize_component', target: '<elementId>', size: { w, h } }` ızgara boyutunu,
@@ -159,8 +160,9 @@ Sayfa açılışında veri çekmek için `mount` kullanılır ama tek seçenek o
 
 Yani "satırı seçince detay getir" (`select`), "kolondan süzünce sunucudan yeniden çek"
 (`filter`), "sayfa değişince yeni sayfayı çek" (`pagination`), "satıra çift tıklayınca formu aç"
-(`doubleClick`) akışları da aynı `set_event` mekanizmasıyla kurulur. Buna karşılık `page-header`
-ve `datatable` yalnız `mount` yayar (`datatable`'ınki bilinçli — Kural 1e).
+(`doubleClick`) akışları da aynı `set_event` mekanizmasıyla kurulur. Buna karşılık `datatable`
+yalnız `mount` yayar (bilinçli — Kural 1e); `page-header` 2026-09-18'den beri izdeki öğe
+tıklamasını `clickItem` olarak yayar (`component_get` yükü verir).
 
 **Olay adları `on` ÖNEKİ ALMAZ** (`button` → `click`, `form` → `submit`), tek istisna katalogda
 `texteditor`'dur (`onMount`/`onChange`). **Komponentin desteklemediği bir olay adı verirsen bağ
@@ -197,12 +199,14 @@ olaylarında **boştur** (ölçüm 2026-08-25, kaynak okuması: `flow-machine.ts
 Pratik kural: **`payload` anahtarları aynı zamanda prop adlarıdır; akışta `self.<anahtar>` ile
 oku** (ya da `value { type:'property', ref:{ source:'component', element, property } }` ile).
 `event.data` yalnız `params` ile gelen olaylarda dolar — `html` komponentinin `fireEvent`
-aksiyonları (`platform_guide('html')`) ve **2026-08-27 kuşağı komponentler** (`eventcalendar` ·
-`importwizard` · `kanban` · `signature` · `stepper`): bu kuşak `params`'ı da gönderir, yani
-yükleri `event.data.<anahtar>` ile okunur; `kanban` ve `eventcalendar` yükü `self`'e HİÇ
-yazmaz (`component_get` çıktısındaki sözleşme notları ayrımı söyler). Sessiz hata örneği:
-sayfalama akışını `event.data.limit`'e bağlarsan sorgu `LIMIT null OFFSET null` ile koşar ve
-**tüm satırları** döndürür; hata yok, sayfalama yok.
+aksiyonları (`platform_guide('html')`) ve **`params`'ı da gönderen komponentler**
+(`eventcalendar` · `importwizard` · `kanban` · `signature` · `stepper` · `tabs` ·
+`tree-view` · `pagination`): bunların yükü `event.data.<anahtar>` ile de okunur; `kanban` ve
+`eventcalendar` yükü `self`'e HİÇ yazmaz (`component_get` çıktısındaki sözleşme notları ayrımı
+söyler). Sessiz hata örneği: **tablonun kendi** sayfalama akışını (`table.pagination`)
+`event.data.limit`'e bağlarsan sorgu `LIMIT null OFFSET null` ile koşar ve **tüm satırları**
+döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tuzağa girmez, yükünü
+`params` ile de gönderir.)
 
 | Komponent · olay | Yük (aynı zamanda prop adları) | Akışta nereden okunur |
 |---|---|---|
@@ -212,16 +216,18 @@ sayfalama akışını `event.data.limit`'e bağlarsan sorgu `LIMIT null OFFSET n
 | `table.select` · `doubleClick` | — | `self.selectedRow` |
 | `table.selectionChange` | — | `self.selectedRows` |
 | `datatable.mount` | — | `self.filters` · `self.sortField` · `self.sortType` · `self.offset` |
-| `pagination.change` | `{ offset, limit }` | `self.offset` · `self.limit` |
+| `pagination.change` | `{ offset, limit }` | `self.offset` · `self.limit` ya da `event.data.offset` · `event.data.limit` |
 | `textinput/textarea/password.change` | `{ value }` | `self.value` |
 | `dropdown.change` · `multi-select.change` | `{ value }` | `self.value` |
 | `dropdown.search` · `multi-select.search` | `{ searchText }` | `self.searchText` |
-| `tabs.tab` | `{ selected }` | `self.selected` |
+| `tabs.tab` | `{ selected }` | `self.selected` ya da `event.data.selected` |
 | `chart.dataPointClick` | `{ name, seriesName, value, dataIndex, row }` | `self.row` (kaynak satırın tamamı) |
-| `repeater.change` | `{ selectedIndex }` | `item` / `Row` satır bağlamı |
+| `repeater.change` · `repeater.select` | `{ selectedIndex }` | `self.selectedIndex` · `self.selectedItem` (akış satır bağlamında koşmaz, `item`/`Row` boş) |
 | `html` aksiyonu (`fireEvent`) | ikinci argüman | **`event.data`** |
 | `kanban.cardMove` | `{ id, row, from, to }` | **`event.data`** (self'e yazılmaz) |
+| `kanban.cardAdd` · `kanban.cardRemove` | `{ column }` · `{ id, row, column }` | **`event.data`** (self'e yazılmaz; kart eklenmez/gizlenmez, akış yazıp `rows`'u tazeler) |
 | `eventcalendar.eventMove` | `{ id, row, start, end, previousStart, previousEnd }` | **`event.data`** (self'e yazılmaz) |
+| `eventcalendar.monthChange` · `eventcalendar.viewChange` · `eventcalendar.eventCreate` | `{ month, year, view, start, end }` · `{ view, start, end }` · `{ start, end, allDay }` | **`event.data`** (self'e yazılmaz; veri sorgusunu kesişimle bağla: başlangıç < `end`+1 gün ve bitiş >= `start`) |
 | `importwizard.complete` | `{ rows, errors, fileName, total }` | `self.rows`… ya da `event.data` |
 | `stepper.stepChange` | `{ currentStep, previous }` | `self.currentStep` ya da `event.data` |
 | `signature.change` | `{ value }` | `self.value` ya da `event.data.value` |
@@ -1825,7 +1831,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
 | Kimlik alanları | `email` · `password` |
 | Dosya | `fileUpload` (dropzone) · `fileInput` · `filebutton` · `file-viewer` |
 | Liste | `table` · `datatable` (Kural 1e) · `repeater` (kart listesi VE dinamik form — Kural 1g) · `tree-view` (hiyerarşi; `isSearchable` ile istemci içi arama) · `timeline` (tarihli olay akışı) |
-| Pano / takvim | `kanban` (durum kolonlarında sürüklenebilir kartlar; taşıma `cardMove` ile `event.data`'dan okunur, kalıcılık AKIŞIN işidir) · `eventcalendar` (ay/hafta/gün; veri `rows`'a akışla yazılır, `monthChange` tazeleme kancasıdır, `month` 1-tabanlı) |
+| Pano / takvim | `kanban` (durum kolonlarında sürüklenebilir kartlar; taşıma `cardMove` ile `event.data`'dan okunur, kalıcılık AKIŞIN işidir) · `eventcalendar` (ay/hafta/gün/ajanda; veri `rows`'a akışla yazılır, `monthChange`/`viewChange` görünen `start`/`end` aralığıyla tazeleme kancasıdır) |
 | Kayıt detayı | `detailview` — tek kaydı etiket/değer ızgarası basar (alan başına format, iç içe alan yolu); OLAY YAYMAZ, tıklanabilirlik gerekiyorsa kapsayıcıya sar |
 | Adımlı akış | `stepper` — tabs gibi her adım kendi droppable görünümünü taşır; ileri gidiş `canProceed` kapısıyla (`{{ form1.isValid === true }}` biçimi), adım `currentStep` setter'ıyla sürülür |
 | İmza / CSV içe aktarma | `signature` (değer PNG data-URL ya da ham SVG; `change` setter'lı) · `importwizard` (3 adımlı sihirbaz; temiz+hatalı satırlar `complete` yükünde — satırları uca yazmak akışın işidir) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",