@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.23

package/dist/resources/examples/mobile-list-detail-form.json

@@ -0,0 +1,656 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil uygulamada üç sayfalık liste → detay → form akışı (G6 koşusunun girdisi): 'gorevler' mount'ta görevleri yükleyip repeater'a yazar, satıra dokunmak 'detay'ı id ile açar, 'yeni' formu kaydedip toast gösterir ve listeye döner. Yerleşim flex (blocks yok), görünüm tipli gruplarla.",
+    "pairsWith": "mobile-app-shell-stack ya da mobile-app-shell-tab (kabuk), microservice-table-list (liste ucu), page-form-upsert (web'deki form ikizi)",
+    "sourceRef": "platform_guide('mobile') §Kurulum sırası, §Akış adımları; ngapps://examples/flow-list-to-form (redirect query sözleşmesi)"
+  },
+  "_rules": {
+    "order": "Önce kabuk ve sayfalar (mobile_app_create), sonra microservice'ler, sonra her sayfanın schemaPatchOps'u, en son akışlar (flow_create) ve bağları (set_event).",
+    "flexOnly": "Mobil çizer blocks okumaz: add_component'e blocks yazma, sıra index'tir (MOB-001). Genişlik appearance.widthType ile.",
+    "repeaterRows": "repeater'ın satır şablonu çocuklarıdır ve satırlar `rows` prop'una yazılır; satır verisi item.<alan> ile okunur. `card` çocuk almaz: satır kartının alanları `title`/`description` bağıyla verilir. Satıra dokunuş MOBİLDE repeater'ın kendi `itemPress` olayıdır (`itemPressable: true`) — kartın `click`'i değil; payload `{ index, row }` taşır. Satır iç rolü <elementId>__row-<i> page_screenshot'ta tıklanabilir.",
+    "queryIsExpression": "redirect.args.query ifadedir: `id=${lst_tasks.selectedItem.id}`; hedef sayfa Page.queryParams.id ile okur (flow-list-to-form ile aynı sözleşme). Satır çocuğunun AKIŞINDA `item`/`Row` tıklanan satır DEĞİLDİR (yalnız prop bağlarında satır bağlamıdır): dokunuş önce tekrarlayıcının `selectedIndex`'ini yazar, akış satırı `<tekrarlayıcı>.selectedItem` olarak okur.",
+    "toastDoesNotWait": "alert.alertType 'success' toast'tur ve beklemez; ardından gelen redirect hemen koşar. Onay beklemek için alertType verme.",
+    "catalog": "repeater, form, textinput, textarea, card ve text mobil kataloğun Dalga 1 bileşenleridir; component_list mobil uygulamada döndürmüyorsa yazım MOB-003 alır.",
+    "verify": "page_screenshot({ applicationSlug: 'saha', pageSlug: 'yeni', actions: [{ action: 'set', target: 'in_title', value: 'Sayaç okuma' }, { action: 'submit', target: 'frm_task' }] }) → submitVia 'bridge', flowRuns ≥ 1, son kare 'gorevler'.",
+    "propNames": "Prop adları mobil kataloğun adlarıdır (component_get): metin `text.content`, satırlar `repeater.rows`. Mobilde istemci tarafı form doğrulaması yok (`isRequired` prop'u yok) — zorunlu alanı kayıt akışı denetler. Kod bağı ifadeyi `ref`'te taşır: `{ type: 'code', ref: '{{ item.title }}' }` — `data`'ya yazılan ifade çizilmez (boş metin).",
+    "detailFromSteps": "Detay alanları uçtan gelen veriyi SETTER adımıyla alır (`fill_detail`, `value.type: 'storage'`): `{{ Steps.… }}` kod bağı ilk çizimde okunur ve `Steps`'e yazmak düğümü yeniden okutmaz — sayfa boş kalırdı (web `page-detail-profile` ile aynı desen).",
+    "mobileBehavior": "Çekerek yenile listenin değil onu saran `scroll-view`'ın işidir (`refreshable: true` + `refresh` olayı). `redirect.presentation` push | modal | replace alır; küme dışı değer MOB-008 uyarısı ve backend 422'sidir. Sekme hedefine giden redirect'te modal `navigate`'e düşer."
+  },
+  "pages": [
+    {
+      "pageCreateArgs": {
+        "name": "Görevler",
+        "slug": "gorevler"
+      },
+      "schemaPatchOps": [
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "scr_tasks",
+            "name": "scr_tasks",
+            "type": "scroll-view",
+            "kind": "component",
+            "props": {
+              "refreshable": {
+                "type": "static",
+                "ref": null,
+                "data": true
+              }
+            },
+            "appearance": {
+              "widthType": "fill",
+              "heightType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "scr_tasks",
+          "component": {
+            "elementId": "lst_tasks",
+            "name": "lst_tasks",
+            "type": "repeater",
+            "kind": "component",
+            "props": {
+              "rows": {
+                "type": "static",
+                "ref": null,
+                "data": []
+              },
+              "itemPressable": {
+                "type": "static",
+                "ref": null,
+                "data": true
+              }
+            },
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "row_card",
+                "name": "row_card",
+                "type": "card",
+                "kind": "component",
+                "props": {
+                  "title": {
+                    "type": "code",
+                    "ref": "{{ item.title }}"
+                  },
+                  "description": {
+                    "type": "code",
+                    "ref": "{{ item.status }}"
+                  }
+                },
+                "appearance": {
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "btn_new",
+            "name": "btn_new",
+            "type": "button",
+            "kind": "component",
+            "props": {
+              "text": {
+                "type": "static",
+                "ref": null,
+                "data": "Yeni görev"
+              }
+            },
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        }
+      ],
+      "mountFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<gorevler sayfa id>",
+        "name": "gorevler mount",
+        "slug": "gorevler-mount",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "load_tasks"
+              }
+            ]
+          },
+          {
+            "stepId": "load_tasks",
+            "name": "load_tasks",
+            "type": "microservice",
+            "kind": "normal",
+            "args": {
+              "microserviceId": "<görev listesi microservice id>",
+              "isRaw": false,
+              "parameters": []
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "success",
+                "nextStepId": "apply_rows"
+              },
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          },
+          {
+            "stepId": "apply_rows",
+            "name": "apply_rows",
+            "type": "setter",
+            "kind": "normal",
+            "args": {
+              "iteratees": [
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "element": "lst_tasks",
+                  "property": "rows",
+                  "source": "component",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "Steps.load_tasks.data"
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "rowFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<gorevler sayfa id>",
+        "name": "satırı aç",
+        "slug": "gorev-ac",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "go_detail"
+              }
+            ]
+          },
+          {
+            "stepId": "go_detail",
+            "name": "go_detail",
+            "type": "redirect",
+            "kind": "normal",
+            "args": {
+              "pageId": "<detay sayfa id>",
+              "path": "detay",
+              "query": "`id=${lst_tasks.selectedItem.id}`",
+              "presentation": "modal"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "page_container",
+          "event": "mount",
+          "eventValue": "<mount akış id>"
+        },
+        {
+          "op": "set_event",
+          "target": "btn_new",
+          "event": "click",
+          "eventValue": "<yeni sayfaya redirect akış id>"
+        },
+        {
+          "op": "set_event",
+          "target": "lst_tasks",
+          "event": "itemPress",
+          "eventValue": "<satırı aç akış id>"
+        },
+        {
+          "op": "set_event",
+          "target": "scr_tasks",
+          "event": "refresh",
+          "eventValue": "<mount akış id>"
+        }
+      ]
+    },
+    {
+      "pageCreateArgs": {
+        "name": "Görev detayı",
+        "slug": "detay"
+      },
+      "schemaPatchOps": [
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "txt_title",
+            "name": "txt_title",
+            "type": "text",
+            "kind": "component",
+            "props": {
+              "content": {
+                "type": "static",
+                "ref": null,
+                "data": ""
+              },
+              "typographyStyle": {
+                "type": "static",
+                "ref": null,
+                "data": {
+                  "fontSize": "20px",
+                  "fontWeight": "600"
+                }
+              }
+            },
+            "appearance": {},
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "txt_status",
+            "name": "txt_status",
+            "type": "text",
+            "kind": "component",
+            "props": {
+              "content": {
+                "type": "static",
+                "ref": null,
+                "data": ""
+              }
+            },
+            "appearance": {},
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        }
+      ],
+      "mountFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<detay sayfa id>",
+        "name": "detay mount",
+        "slug": "detay-mount",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "load_task"
+              }
+            ]
+          },
+          {
+            "stepId": "load_task",
+            "name": "load_task",
+            "type": "microservice",
+            "kind": "normal",
+            "args": {
+              "microserviceId": "<görev getir microservice id>",
+              "isRaw": false,
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": "text",
+                  "source": "query-string",
+                  "value": {
+                    "type": "code",
+                    "ref": "Page.queryParams.id"
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "fill_detail"
+              }
+            ]
+          },
+          {
+            "stepId": "fill_detail",
+            "name": "fill_detail",
+            "type": "setter",
+            "kind": "normal",
+            "args": {
+              "iteratees": [
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "txt_title",
+                  "property": "content",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "storage",
+                    "ref": "load_task.data.title"
+                  }
+                },
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "txt_status",
+                  "property": "content",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "storage",
+                    "ref": "load_task.data.status"
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "page_container",
+          "event": "mount",
+          "eventValue": "<detay mount akış id>"
+        }
+      ]
+    },
+    {
+      "pageCreateArgs": {
+        "name": "Yeni görev",
+        "slug": "yeni"
+      },
+      "schemaPatchOps": [
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "frm_task",
+            "name": "frm_task",
+            "type": "form",
+            "kind": "component",
+            "props": {},
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "in_title",
+                "name": "in_title",
+                "type": "textinput",
+                "kind": "component",
+                "props": {
+                  "label": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Başlık"
+                  }
+                },
+                "appearance": {
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "in_note",
+                "name": "in_note",
+                "type": "textarea",
+                "kind": "component",
+                "props": {
+                  "label": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Not"
+                  }
+                },
+                "appearance": {
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "btn_save",
+                "name": "btn_save",
+                "type": "button",
+                "kind": "component",
+                "props": {
+                  "text": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Kaydet"
+                  },
+                  "type": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "submit"
+                  }
+                },
+                "appearance": {
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          }
+        }
+      ],
+      "submitFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<yeni sayfa id>",
+        "name": "görev kaydet",
+        "slug": "gorev-kaydet",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "save_task"
+              }
+            ]
+          },
+          {
+            "stepId": "save_task",
+            "name": "save_task",
+            "type": "microservice",
+            "kind": "normal",
+            "args": {
+              "microserviceId": "<görev oluştur microservice id>",
+              "isRaw": false,
+              "parameters": [
+                {
+                  "name": "title",
+                  "type": "text",
+                  "source": "body",
+                  "value": {
+                    "type": "property",
+                    "ref": {
+                      "element": "in_title",
+                      "property": "value"
+                    }
+                  }
+                },
+                {
+                  "name": "note",
+                  "type": "text",
+                  "source": "body",
+                  "value": {
+                    "type": "property",
+                    "ref": {
+                      "element": "in_note",
+                      "property": "value"
+                    }
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "success",
+                "nextStepId": "notify"
+              },
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          },
+          {
+            "stepId": "notify",
+            "name": "notify",
+            "type": "alert",
+            "kind": "normal",
+            "args": {
+              "message": "Görev kaydedildi",
+              "alertType": "success"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "go_list"
+              }
+            ]
+          },
+          {
+            "stepId": "go_list",
+            "name": "go_list",
+            "type": "redirect",
+            "kind": "normal",
+            "args": {
+              "pageId": "<gorevler sayfa id>",
+              "path": "gorevler",
+              "query": ""
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "frm_task",
+          "event": "submit",
+          "eventValue": "<görev kaydet akış id>"
+        }
+      ]
+    }
+  ]
+}

package/dist/resources/guides/component.md

@@ -3,6 +3,11 @@
 Sayfaya konan her şeyin ortak kuralları. Kuruluş sırası ve şema gövdesi için
 `platform_guide('page')`; HTML kaçış kapısının derin sözleşmesi için `platform_guide('html')`.
 
+> **Mobil uygulamada** katalog ayrıdır: `component_list`/`component_get` mobil satırları okur,
+> `component_get` `mobileKnowledge` (bileşenin mobil farkları) ve `mobileNotes` ekler; katalogda
+> olmayan tip `MOB-003` alır. Stil CSS değil React Native'dir — `page_runtime_get(resolveStyles)`
+> `nativeStyle` döner (`platform_guide('mobile')`).
+
 ## Keşif: iki tool, üç bilgi katmanı
 
 ```
@@ -108,7 +113,7 @@ Her şema düğümünde iki sözlük vardır; ikisi de ortak render katmanında
 
 | `states` | Anlamı |
 |---|---|
-| `isDroppable` | İçine komponent alır (container/form/repeater true) |
+| `isDroppable` | İçine komponent alır (container/form/repeater true). **Değer kataloğun kararıdır** (`component_list` `droppable` sütunu): Studio kanvası bırakma hedefini bu alandan çözer, bu yüzden gateway yazdığı düğümlerde alanı katalogdan doldurur ve `gatewayNormalized` ile bildirir (PAGE-036). `false` yazılmış bir kabın içine kanvasta bırakma yapılamaz — bilerek kapatmak için `resize_component`/`set_states` |
 | `isScrollable` | İçeriği kendi alanında kaydırır (sabit yükseklikte `overflow-y: auto`) |
 | `isWrapper` | Sayfanın/layout'un/widget'ın ANA kabı — salt düzen elemanı: `height:100%` + **`min-height:80vh`**, kap başlığı ÇİZİLMEZ. **Yalnız sayfa boyu kaplaması gereken tek kap için kullan:** iç içe kutuya verirsen 720px'lik pencerede o kutu 36px içerikle bile 576px çizilir (ölçüldü, `platform_guide('page')` Kural 1f). Çerçeve/başlık gizlemek için wrapper değil `style` (`border:'none'`) kullan. Kurulmuş bir düğümün bayrağını `resize_component` micro-op'unun `states` alanı değiştirir — düğümü yeniden kurmak gerekmez |
 | `isSticky` | Kaydırmada yerinde kalır (header/sidebar; z-index'i otomatik) |

package/dist/resources/guides/functions.md

@@ -273,7 +273,7 @@ toplamHesapla(row.fiyat, row.adet) > 1000
   serbesttir — sunucuda o ad alanı yok.
 - **Önekli hata:** gövde hatası `Functions.<ad>: <mesaj>` (studio) ya da `<ad>: <mesaj>` (workflow)
   olarak gelir; `Steps.<adım>.error.message` ya da `runtimeErrors`'ta bu öneki ara.
-- **Mobil yok** (K11): `apps/mobile` runtime'ı `Functions`'ı boş nesne kurar.
+- **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native`) `appFunctions`/`pageFunctions`'ı `Functions`'a geçirir, çağrı web'deki gibi çalışır.
 - **Önbellek:** `/view` yolu eski gövdeyi birkaç saniye gösterebilir; `/dev` yolu anlıktır.
 - **Parametre konumsal:** `parameters` sırasını değiştirmek mevcut çağrıların anlamını değiştirir;
   `function` adımları ada göre eşlendiği için etkilenmez.