@appaflytech/zeyrek-ai-mcp 0.0.18 → 0.0.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +13 -14
  2. package/dist/config.js +2 -0
  3. package/dist/knowledge/componentCatalog.js +204 -836
  4. package/dist/knowledge/componentEvents.js +75 -368
  5. package/dist/knowledge/mobileComponentCatalog.js +331 -0
  6. package/dist/knowledge/mobileComponentEvents.js +50 -0
  7. package/dist/knowledge/normalize.js +63 -66
  8. package/dist/knowledge/platform/lint.js +205 -0
  9. package/dist/knowledge/platform/mobile.js +78 -0
  10. package/dist/knowledge/platform/mobileRules.js +121 -0
  11. package/dist/knowledge/platform/mobileTabs.js +108 -0
  12. package/dist/knowledge/platform/profile.js +20 -0
  13. package/dist/knowledge/platform/resolve.js +122 -0
  14. package/dist/knowledge/platform/web.js +38 -0
  15. package/dist/knowledge/rules.js +6 -29
  16. package/dist/knowledge/styleResolve.js +1 -1
  17. package/dist/knowledge/styleResolveNative.js +410 -0
  18. package/dist/knowledge/themeResolve.js +3 -3
  19. package/dist/platform/capture/actions.js +333 -0
  20. package/dist/platform/capture/browser.js +1 -0
  21. package/dist/platform/{screenshot.js → capture/capture.js} +23 -509
  22. package/dist/platform/capture/index.js +10 -0
  23. package/dist/platform/capture/readiness.js +103 -0
  24. package/dist/platform/capture/summary.js +77 -0
  25. package/dist/platform/capture/target.js +5 -0
  26. package/dist/platform/capture/targets/studio-mobile.js +15 -0
  27. package/dist/platform/capture/targets/studio-web.js +5 -0
  28. package/dist/platform/domSummary.js +1 -1
  29. package/dist/platform/responses.js +1 -2
  30. package/dist/platform/strictArguments.js +2 -22
  31. package/dist/platform/writeDiff.js +31 -58
  32. package/dist/resources/examples/mobile-app-shell-drawer.json +209 -0
  33. package/dist/resources/examples/mobile-app-shell-stack.json +123 -0
  34. package/dist/resources/examples/mobile-app-shell-tab.json +174 -0
  35. package/dist/resources/examples/mobile-list-detail-form.json +656 -0
  36. package/dist/resources/guides/component.md +6 -9
  37. package/dist/resources/guides/functions.md +3 -32
  38. package/dist/resources/guides/getting-started.md +0 -35
  39. package/dist/resources/guides/layout.md +11 -7
  40. package/dist/resources/guides/mobile.md +215 -0
  41. package/dist/resources/guides/page.md +71 -49
  42. package/dist/resources/guides/translation.md +6 -5
  43. package/dist/resources/schema-fingerprint.json +2 -2
  44. package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +0 -18
  45. package/dist/server.js +2 -0
  46. package/dist/tools/applications.js +60 -3
  47. package/dist/tools/components.js +50 -10
  48. package/dist/tools/designSchemaPatch.js +18 -13
  49. package/dist/tools/externalComponents.js +25 -4
  50. package/dist/tools/flows.js +51 -38
  51. package/dist/tools/functions.js +10 -20
  52. package/dist/tools/layouts.js +41 -9
  53. package/dist/tools/microservices.js +11 -39
  54. package/dist/tools/mobile.js +203 -0
  55. package/dist/tools/pages.js +127 -95
  56. package/dist/tools/platformInfo.js +2 -1
  57. package/dist/tools/profileWrite.js +45 -0
  58. package/dist/tools/schemaOps.js +2 -2
  59. package/dist/tools/screenWrite.js +2 -2
  60. package/dist/tools/screens.js +9 -3
  61. package/dist/tools/workflows.js +12 -39
  62. package/package.json +2 -7
  63. package/dist/platform/diagnostics.js +0 -85
  64. package/dist/platform/ifExists.js +0 -129
  65. package/dist/platform/writeView.js +0 -17
@@ -105,16 +105,14 @@ globalThis["toplamHesapla"] = function (fiyat, adet) { // studio: Function
105
105
  "name": "toplamHesapla", "description": "fiyat × adet; adet verilmezse 1",
106
106
  "parameters": [ { "name": "fiyat", "type": "number", "required": true },
107
107
  { "name": "adet", "type": "number", "defaultValue": 1 } ],
108
- "body": "// fiyat × adet; adet verilmezse 1 sayılır
109
- return fiyat * adet;" }
108
+ "body": "return fiyat * adet;" }
110
109
 
111
110
  // tarayıcı
112
111
  { "source": "studio", "applicationId": "<app id>", "scope": "application",
113
112
  "name": "toplamHesapla", "description": "fiyat × adet; adet verilmezse 1",
114
113
  "isAsync": false,
115
114
  "parameters": [ … aynı liste … ],
116
- "body": "// fiyat × adet; adet verilmezse 1 sayılır
117
- return fiyat * adet;" }
115
+ "body": "return fiyat * adet;" }
118
116
  ```
119
117
 
120
118
  Gövde **düz deyimlerdir** — `function (…) { }` sarmalı ya da arrow yazılmaz; `return` serbesttir,
@@ -130,33 +128,6 @@ sözdizimi hatası `422 GlobalFunctionBodyInvalid` ile ve ayrıştırıcı mesaj
130
128
  | FN-004 | `source:'workflow'` + `isAsync:true` | **block** — motor senkron, 422 `GlobalFunctionAsyncNotAllowed` |
131
129
  | FN-004 | studio: `isAsync:true` ama `await` yok · `isAsync:false` ama `await` var | warn — ilki gereksiz async (inline `[object Promise]`), ikincisi **derlenmeyen gövde**: fonksiyon atlanır |
132
130
  | FN-005 | Kaynak/kapsam tutarsız: workflow'a `applicationId`/`scope`/`pageId`; studio'ya `applicationId` ya da `scope` yok; `page` kapsamına `pageId` yok; `application` kapsamına `pageId` var | **block** — platform 422 |
133
- | FN-006 | 5+ dolu satırlı gövdede hiç yorum yok | warn — baş yorumu ekleyin (§Gövdede yorum) |
134
-
135
- ### Gövdede yorum (FN-006)
136
-
137
- Gövdeyi okuyan bir sonraki kişi (insan ya da ajan) fonksiyonu Studio'nun Functions drawer'ında
138
- açar; yorumlar orada **yeşil italik** çizilir ve koddan ayrı okunur. Bu yüzden her gövde yorum taşır:
139
-
140
- - **Baş yorumu** — ilk satırlar: fonksiyon ne yapar, parametrelerin anlamı ve birimi, ne döner.
141
- Tek satırlık `return` gövdesinde bile bir satır yeterlidir.
142
- - **Adım yorumu** — yalnız açık olmayan adımların üstüne: iş kuralı, sınır durumu, neden bu yol.
143
- Kodu tekrar eden yorum yazılmaz (`// toplamı döndür` + `return toplam` gürültüdür).
144
- - `//` kullanın; `/* */` çok satırlı açıklama için serbest. Gövde kendi satırına sarıldığı için
145
- son satırdaki `//` kapanış parantezini yutmaz.
146
-
147
- ```js
148
- // KDV dahil sepet toplamı. satirlar: [{ fiyat, adet }], oran: 0.2 gibi ondalık.
149
- // Boş sepette 0 döner; tutar kuruş hassasiyetinde yuvarlanır.
150
- const araToplam = satirlar.reduce((toplam, satir) => toplam + satir.fiyat * satir.adet, 0)
151
-
152
- // İndirim KDV'den ÖNCE uygulanır (muhasebe kuralı)
153
- const indirimli = araToplam * (1 - (indirim ?? 0))
154
-
155
- return Math.round(indirimli * (1 + oran) * 100) / 100
156
- ```
157
-
158
- 5 ya da daha fazla dolu satırlı ve hiç yorumu olmayan gövde **FN-006** uyarısı alır; kayıt yine
159
- yapılır.
160
131
 
161
132
  Studio kaydı sonrası bağlı sayfaların çalışma paketi `Pages.Updated` ile yeniden kurulur (B-11):
162
133
  `/dev` yolu yeni gövdeyi hemen, `/view` yolu önbellek tazelenince gösterir. Workflow kaydı önbellek
@@ -273,7 +244,7 @@ toplamHesapla(row.fiyat, row.adet) > 1000
273
244
  serbesttir — sunucuda o ad alanı yok.
274
245
  - **Önekli hata:** gövde hatası `Functions.<ad>: <mesaj>` (studio) ya da `<ad>: <mesaj>` (workflow)
275
246
  olarak gelir; `Steps.<adım>.error.message` ya da `runtimeErrors`'ta bu öneki ara.
276
- - **Mobil yok** (K11): `apps/mobile` runtime'ı `Functions`'ı boş nesne kurar.
247
+ - **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native`) `appFunctions`/`pageFunctions`'ı `Functions`'a geçirir, çağrı web'deki gibi çalışır.
277
248
  - **Önbellek:** `/view` yolu eski gövdeyi birkaç saniye gösterebilir; `/dev` yolu anlıktır.
278
249
  - **Parametre konumsal:** `parameters` sırasını değiştirmek mevcut çağrıların anlamını değiştirir;
279
250
  `function` adımları ada göre eşlendiği için etkilenmez.
@@ -153,21 +153,6 @@ koda baktığını gizlemek yerine raporlamak.
153
153
  (GW-005). Bir argüman kabul edildiyse gateway onu okuyor demektir.
154
154
 
155
155
 
156
- ## Aynı çağrıyı iki kez yapmak kopya açmaz: `ifExists`
157
-
158
- Platform aynı adla ikinci kaydı hata vermeden `"<ad> (1)"` olarak açar. `flow_create`,
159
- `microservice_create`, `workflow_create` ve `page_create` bu yüzden yazmadan önce aynı ad ya da
160
- slug'ı (harf duyarsız) arar:
161
-
162
- | `ifExists` | Kayıt zaten varsa |
163
- |---|---|
164
- | `error` (varsayılan) | Yazmaz; hata mevcut id'yi ve varsa `(n)` sayaçlı kopyaları söyler |
165
- | `update` | Mevcut kaydı günceller, yanıtta `outcome: 'updated'`. `page_create`'te yalnız verilen alanlar yazılır, şema korunur. `workflow_create`'te mevcut kaydın `type`'ı farklıysa (middleware ↔ automation) yazmaz — tür değişirdi |
166
- | `duplicate` | Platform davranışı: ikinci kayıt açılır. Platformun eklediği sayaç (ad `' (1)'`, slug `-1`; akışta ikisi de `' (1)'`) kayıp değildir, yanıtta `renamedByPlatform`'dadır |
167
-
168
- Betiği yeniden koşturacaksan `ifExists: 'update'` ver; kopyaları elle ayıklayan yardımcı kod
169
- yazma. Mevcut liste okunamazsa çağrı yazmadan düşer — tekrar dene.
170
-
171
156
  ## Yazdıktan sonra `silentlyDropped` alanına bak
172
157
 
173
158
  Platformun bir alanı **hatasız yutması** bu depodaki en pahalı hata sınıfı: çağrı 200 döner,
@@ -184,26 +169,6 @@ Gateway yazma tool'larında gönderdiğin gövdeyi kaydedilenle karşılaştır
184
169
  ]
185
170
  ```
186
171
 
187
- Yazma yanıtında bu liste ve `gatewayNormalized` **kısaltılmış** gelir: aynı yolun düşmeleri tek
188
- satırda sayıyla toplanır (`selectFields[*].path · kaydedilmedi: 25 öğe — ör. …`). Kayıp sayısı
189
- `droppedCount`'tadır; sayım 1000 farkta durursa `droppedCountCapped: true` gelir ve sayı "en az"
190
- demektir. Liste dışı bilgiler (20 satır kesmesi, sıra tabanlı karşılaştırma uyarısı)
191
- `silentlyDroppedNotes`'tadır ve sayıya girmez. Tam liste gerekiyorsa yazmayı tekrarlama — kaydı `*_get` ile oku,
192
- sonraki yazmalarda `diagnostics: 'full'` ver. `microservice_*` ve `workflow_*` create/update
193
- yanıtında `data` yalnız kimlik alanlarını taşır; gövdenin tamamı için `view: 'full'`.
194
-
195
- **Betikten toplu yazarken yanıtı olduğu gibi basma.** Otuz yazmanın tam yanıtı çıktı sınırını aşar
196
- ve dosyaya düşer. Her çağrı için tek satır bas; ayrıntıyı yalnız sorunlu çağrıda bas:
197
-
198
- ```js
199
- const r = JSON.parse(result.content[0].text)
200
- if (result.isError || r.droppedCount > 0) console.log(JSON.stringify({ slug, error: result.isError ? r : undefined, droppedCount: r.droppedCount, silentlyDropped: r.silentlyDropped }))
201
- else console.log(JSON.stringify({ slug, id: r.data?.id, outcome: r.outcome }))
202
- ```
203
-
204
- Yalnız `isError`'a bakma: platform alanı hatasız yutunca çağrı başarılıdır ve kayıp yalnız
205
- `droppedCount`'ta görünür.
206
-
207
172
  Diff dizi öğelerini indeksle değil KİMLİKLE eşler (`stepId`, `elementId`, `name`, `id`), çünkü
208
173
  platform diziyi kendi sırasında geri döndürür. Diff üretilemeyen tek durum, yanıtın kayıt değil
209
174
  kabul gövdesi olmasıdır; o zaman alan hiç görünmez ve doğrulamayı `*_get` ile kendin yaparsın.
@@ -4,6 +4,10 @@ Sayfaların paylaştığı kabuk: yan menü, üst şerit, kullanıcı menüsü v
4
4
  gireceği delik. Şema gövdesi ve koordinat modeli için `platform_guide('page')` (Kural 1,
5
5
  1d, 1f); komponent sözleşmeleri için `platform_guide('component')`.
6
6
 
7
+ > **Mobil uygulamada** kabuk `app-bar` + tek `slot`'tur; sekmeler uygulama ayarı
8
+ > (`properties.mobile.tabs`), çekmece `drawer` widget'ıdır. Web kabuk bileşenleri (`navigations`,
9
+ > `sidebar`, `header`) `MOB-004` alır — `platform_guide('mobile')` §Gezinme.
10
+
7
11
  ## Karar kuralları
8
12
 
9
13
  **1. Layout, tek `slot` içeren SIRADAN bir komponent ağacıdır.** Ayrı bir dil yoktur:
@@ -61,7 +65,7 @@ yapılan eski numaraya artık gerek yok.
61
65
  NEREDE durduğunu değil, BİÇİMİNİ söyler (dikey kolon / yatay şerit / dolgu yüzeyi). Hem
62
66
  runtime hem Studio tuvali bölgeleri 12 kolonluk ızgarayla yerleştirir.
63
67
 
64
- **7. Mobilde flex YIĞILMAZ.** Runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer.
68
+ **7. Dar ekranda flex YIĞILMAZ.** Runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer.
65
69
  Telefonda alt alta düşmesi gereken satırı `layout:'grid'` ile kur; `layout:'flex'` +
66
70
  `direction:'row'` telefonda da yan yana kalır (375px'te ölçüldü: ızgara çocukları 375/375px
67
71
  alt alta, flex çocukları 49/310px yan yana). Not: `wrap` varsayılanı artık açık (2026-09-01) —
@@ -140,8 +144,8 @@ bağlantı nesnesi ya da tam yol).
140
144
  "direction": { "type": "static", "data": "row" } },
141
145
  "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 80 }, "position": { "x": 0, "y": 0 } }] }
142
146
 
143
- // KÖTÜ — telefonda 49px'lik yan menü: row flex mobilde yığılmaz (Kural 7)
144
- // Mobilde alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
147
+ // KÖTÜ — telefonda 49px'lik yan menü: row flex dar ekranda yığılmaz (Kural 7)
148
+ // Dar ekranda alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
145
149
  // flex anlamının devreye girmemesi.
146
150
  ```
147
151
 
@@ -179,9 +183,9 @@ bunlardan biri olabilir:
179
183
  |---|---|
180
184
  | ~~`heightType` yalnız `auto` \| `fixed`~~ | **28 Ağustos'ta kapandı:** üçüncü değer `fill` (Kural 5b) |
181
185
  | ~~Kök kap viewport'a kilitlenmez~~ | **28 Ağustos'ta kapandı:** `fill` verilmiş kök 100vh (Kural 5b) |
182
- | Flex mobilde yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
183
- | Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve mobilde AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
184
- | Mobil çekmece (overlay) yok | Telefonda içeriğin üstüne binen panel kurulamaz |
186
+ | Flex dar ekranda yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
187
+ | Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve dar ekranda AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
188
+ | Dar ekranda çekmece (overlay) yok | Telefon genişliğinde içeriğin üstüne binen panel kurulamaz (mobil UYGULAMADA çekmece `drawer` widget'ıdır — `platform_guide('mobile')`) |
185
189
 
186
190
  ---
187
191
 
@@ -189,7 +193,7 @@ bunlardan biri olabilir:
189
193
  (`injectPageSchemaIntoSlots`, `getResolvedLayoutViews`), `apps/studio/src/features/page/api/page.mappers.ts`
190
194
  (`mapPageLayoutToPreview`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`
191
195
  (`resolveNodeBoxStyle` — slot'un `y / auto` satırı, flex çocuk genişliği),
192
- `packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (mobil media kuralı),
196
+ `packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (dar ekran media kuralı),
193
197
  `packages/ng-apps-screen-builder/src/flex-layout.ts` (`getFlexChildStyle` — `widthType`
194
198
  fill/fixed/auto dalları, `normalizeCssSize` kabul kuralı; tuval ve runtime aynı fonksiyonu okur),
195
199
  `apps/studio/src/features/page/components/appearance/appearance-size.functions.ts` (panelin
@@ -0,0 +1,215 @@
1
+ # Mobil uygulama rehberi
2
+
3
+ Mobil uygulama (`application_create` → `type: 'mobile'`) web uygulamasıyla **aynı şemayı**, aynı
4
+ micro-op sözlüğünü ve aynı akış motorunu kullanır; farkı çizerdedir. Sayfalar
5
+ `@ng-apps/ui-native` ile React Native olarak çizilir: Studio'da (kanvas, `/preview`, `/dev|/view`)
6
+ react-native-web üzerinde, cihazda Expo uygulamasında. Gateway uygulamanın tipini kendisi okur
7
+ (platform profili) ve mobilde çizilmeyecek her yazımı `MOB-*` satırıyla söyler — yazım yine
8
+ platforma gider, veri düşürülmez.
9
+
10
+ **Sözlük.** Bu rehberde "mobil" yalnız **mobil uygulama** demektir. Web uygulamasının telefondaki
11
+ dar ekran kırılımı (`hideOn: 'mobile'`, `breakpoint: mobile`) ayrı bir kavramdır ve
12
+ `platform_guide('page')` / `platform_guide('layout')`'ta anlatılır; alan adları değişmedi, yalnız
13
+ anlamları ayrı.
14
+
15
+ ## Kurulum sırası
16
+
17
+ 1. **Uygulama ve kabuk.** Tek çağrıda: `mobile_app_create` (uygulama + sayfalar + kabuk layout'u +
18
+ sekme ayarı + ana sayfa bağı, `dryRun` ile önce planı görün). Tekil araçlarla aynı sıra:
19
+ `application_create({ type: 'mobile' })` → `page_create` × N → `layout_create` (kabuk) →
20
+ `page_update({ layoutId })` × N → `application_update({ homepageId, properties.mobile.tabs })`.
21
+ Sekme ayarı sayfa **id**'si ister; bu yüzden sayfalardan SONRA yazılır.
22
+ 2. **Veri.** Entity, microservice ve workflow web'dekiyle aynıdır (`platform_guide('microservice')`).
23
+ Sayfa akışı `microservice` adımıyla aynı uçları çağırır.
24
+ 3. **Ekranlar.** `page_schema_patch` ile bileşen ekle, akış bağla (`flow_create` → `set_event`).
25
+ 4. **Doğrulama.** `page_screenshot` (mobilde varsayılan `device: 'phone'`, 390x844 @2) ve
26
+ `page_runtime_get({ resolveStyles: true })` (düğümün React Native stili). Ayrıntı §Doğrulama.
27
+
28
+ `page_create` mobil uygulamada kökü kendisi kurar: `page_container`, `layout` prop'u YOK,
29
+ `direction: 'column'`, `blocks: []`, `appearance.heightType: 'fill'` — kök telefon ekranını doldurur.
30
+
31
+ ## Bileşenler
32
+
33
+ Mobil uygulamanın bileşen kataloğu ayrıdır (backend satırları `(slug, type: 'mobile')`).
34
+ `component_list` ve `component_get` mobil uygulamada **kendiliğinden** mobil kataloğu okur.
35
+ `component_get` yanıtı `platform: 'mobile'` ile üç katman taşır: `knowledge` (web kaydı — mobil
36
+ şema web sınıfını genişlettiği için prop'ların anlamı oradadır), `mobileKnowledge` (bu bileşenin
37
+ mobil farkları: düşen prop, değişen etkileşim, mobile özgü prop notları) ve `mobileNotes` (bütün
38
+ mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`app-bar`, `safe-area`,
39
+ `scroll-view`, `choice-chips`, `tooltip`) bilgi yalnız `mobileKnowledge`'tadır. Olay yükleri
40
+ (`events[].payload`) önce mobile özgü sözleşmeden okunur (`app-bar.clickAction`, `repeater.swipe`,
41
+ `choice-chips.change`…), yoksa web'inkinden.
42
+
43
+ - Katalogda olmayan tip `MOB-003` alır ve backend `unknown-type` (422) ile reddeder. Mobil pakette
44
+ olan ama bu uygulamanın kataloğuna yazılmamış tip için gateway katalog senkronunu gösterir; web'de
45
+ olup mobilde henüz olmayan için ne zaman geleceğini söyler (Dalga 2, Faz 3).
46
+ - **Katalog A** (FlutterFlow paritesi, 2026-09-24) on bileşen ekledi: `badge`, `avatar`, `progress`,
47
+ `radio`, `checkboxgroup`, `choice-chips`, `collapsible-container`, `slider`, `tabs`, `tooltip`;
48
+ `button` mobilde `secondary`/`ghost`/`link` varyantlarını ve `icon` boyunu alır. Tam liste
49
+ `component_list`'tir.
50
+ - **Katalog B** (FlutterFlow paritesi) önce dört prop'la başladı; hepsi YALNIZ mobil şemadadır:
51
+ `scroll-view.stickyHeader` (ilk çocuk dikey kaydırmada üstte kalır), `numberinput.variant: stepper`
52
+ (± düğmeleri, iç roller `__decrement`/`__increment`), `modal.presentation: center | sheet | fullscreen`
53
+ (alt sayfa şeritten aşağı sürükleyince `change { isOpen: false }` ile kapanır; en çok ekranın %90'ı,
54
+ uzun içerik için içine `scroll-view`). En-boy oranı yeni
55
+ prop DEĞİLDİR: boyut panelinin `appearance.aspectRatio`'su mobilde kaplara da uygulanır
56
+ (§Yerleşim).
57
+ - Web'e özgü bileşenlerin mobil karşılığı:
58
+
59
+ | Web | Mobilde |
60
+ |---|---|
61
+ | `navigations`, `sidebar`, `header`, `layout-shell` | `app-bar` + Ayarlar › Sekmeler + `drawer` widget'ı (`MOB-004`) |
62
+ | `popover` | `modal` widget'ı |
63
+ | `pagination` | `repeater` + "daha fazla yükle" düğmesi |
64
+ | `breadcrumb` | yığın gezinmesi (app-bar geri düğmesi) |
65
+ | `iframe` | `button` + `redirect` (`targetBlank`) ile tarayıcıda aç |
66
+ | `theme-toggle` | cihaz teması |
67
+
68
+ **Harici bileşen mobilde yoktur** (`MOB-006`): protokol v1 tarayıcı `.mjs` paketidir;
69
+ `external_component_*` araçları mobil uygulamada platforma gitmez.
70
+
71
+ ## Yerleşim — yalnız flex
72
+
73
+ Mobil çizer 12 sütunlu ızgarayı **okumaz**: sıra dizi indeksidir, yerleşim flex'tir.
74
+
75
+ - `blocks[]`, `set_block`, `layout: 'grid' | 'cssgrid'` yazılır ama çizilmez (`MOB-001`).
76
+ `add_component` / `move_component`'ın `index`'i dizideki sıradır; gateway konum çevirisi yapmaz.
77
+ - Kaplar flex kabıdır: `direction`, `gap`, `horizontalAlign`, `verticalAlign`, `wrap`, `size`.
78
+ Mobil `container` şemasında `layout` prop'u yoktur.
79
+ - Ölçü `appearance` ile: `widthType: 'fill' | 'auto' | 'fixed'` (+ `widthString`),
80
+ `heightType: 'fill' | 'auto' | 'fixed'` (+ `heightString`). `fill` kalan alanı alır.
81
+ - En-boy oranı `appearance.aspectRatio` (sayı; 16:9 için `1.78`): boy genişlikten türer. Koşullar:
82
+ `heightType: 'auto'` ve genişlik belli — `widthType: 'fill'` ya da `'fixed'` (içerik genişliğinde
83
+ web ile cihaz oranı ters yönden çözer, uygulanmaz). Web'den farkı: mobilde **akış kapları** da oran
84
+ alır (`container`, `form`, `safe-area`, `scroll-view`) ve akışları oranlı boyu doldurur; öteki
85
+ bırakılabilir tipler, widget örneği, sayfa kökü ve `modal`/`drawer` almaz; `image` oranı kendi
86
+ çizimine yazar.
87
+ - Hiza (`verticalAlign` `top | middle | bottom`, `horizontalAlign` `left | center | right`) web ile
88
+ aynıdır. Dikey hizanın boşluğu kabın boyundan gelir: `heightType` `fill`, `fixed` ya da oranlı kapta
89
+ akış kabın boyunu doldurur; boyu içerikten gelen sütun kapta dikey hiza etkisizdir (satır kapta farklı
90
+ boydaki kardeşleri yine hizalar). `stretch` de web gibi: ana eksende çocukları yayar, çapraz eksende gerer.
91
+ - Birim: `px` ve `%`. `em`/`rem` tema puntosuyla çarpılır; `calc()` ve `vw/vh` React Native'de yoktur
92
+ (`MOB-002`).
93
+
94
+ ## Görünüm — tipli gruplar
95
+
96
+ React Native'de CSS yoktur; tipli stil grupları **derlenir** (web'in `composeTypedStyle` ikizi,
97
+ aynı katman sırası: tema taban → gruplar → serbest `style`).
98
+
99
+ - `surfaceStyle` → zemin, köşe, kenarlık, gölge (tek katman), opaklık, taşma.
100
+ - `typographyStyle` → renk, aile (tek ad), punto, kalınlık, hizalama, satır yüksekliği.
101
+ - Tema token'ları (`var(--ng-*)`) sayılara çözülür; proje teması değişince mobil de değişir.
102
+
103
+ Çizilmeyen alanlar (`MOB-002`) ve yerine ne:
104
+
105
+ | Alan | Yerine |
106
+ |---|---|
107
+ | `className` | `surfaceStyle` / `typographyStyle` |
108
+ | serbest `style` nesnesi (alt seçici `&:hover`, `&__body`) | tipli gruplar; düz anahtarlar (ör. `padding`) çevrilir, alt seçici düşer |
109
+ | `hoverStyle` | yok — dokunmatikte üzerine gelme durumu yoktur |
110
+ | `tooltip`, `tooltipPosition` | düğümü `tooltip` bileşenine sarın (dokunuşla açılır, yanı `side`) ya da açıklamayı metin olarak koyun |
111
+ | `zIndex` | katman için `modal` ya da `drawer` widget'ı |
112
+
113
+ Düğümün gerçek stilini görmek: `page_runtime_get({ applicationSlug, pageSlug, resolveStyles: true })`
114
+ → her düğümde `nativeStyle: { shell, text, warnings }` (`shell` kutunun, `text` içine akan metnin
115
+ stili; RN'de tipografi miras alınmaz). Yanıtta `styleResolver: 'native'`. Temanın
116
+ `componentStyles`/preset katmanı mobil çizerde henüz uygulanmıyor ve rapora da girmez.
117
+
118
+ ## Görünüm — shadcn/ui
119
+
120
+ Bileşenler shadcn/ui görünümünde çizilir (react-native-reusables ilkelleri, NativeWind). Renk ve
121
+ köşe yine **proje temasından** gelir: `--ng-*` değişkenleri shadcn token'larına köprüyle çevrilir
122
+ (`--primary` ← `accent.primary`, `--destructive` ← hata rengi, `--border`, `--input`, `--ring`…).
123
+ `theme_update` web'i ve mobili birlikte değiştirir; koyu kip aynı köprünün ikinci çözümüdür. Ölçü
124
+ (alan yüksekliği, punto, iç boşluk) temanın `--ng-form-*` değişkenlerinden gelir. Yazı **ailesi**
125
+ köprüde yoktur: temanın ailesi alanlarda, başlıklarda ve sekme çubuğunda uygulanır; `text` ve düğme
126
+ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tipiyle çizilir.
127
+
128
+ - `button`: `kind` rengi, `variant` kullanımını seçer — `solid` dolu (`kind: error` → shadcn
129
+ `destructive`), `outline` çerçeveli, `text`/`ghost` zeminsiz; mobilde ayrıca `secondary` (nötr
130
+ dolgu) ve `link`. `info`/`success`/`warning` → temanın `--status-*` renkleri. Eşlemenin tamamı ve
131
+ bilinen sınırlar: `component_get('button')` → `mobileKnowledge.propNotes`.
132
+ - `switch` platformun kendi anahtarı DEĞİLDİR: üç barındırıcıda (kanvas, önizleme, cihaz) aynı
133
+ shadcn anahtarı çizilir; kanvasta basılamadığı için soluk görünür.
134
+ - Web sayfası kendi bileşen ailesiyle çizilir; iki platformun görünüm farkı bilinçlidir, ortak olan
135
+ temadır. Yakalama seçicileri (`role="button"`, `__tabs__item-<slug>`, `submit` köprüsü) görünümden
136
+ bağımsızdır (§Doğrulama).
137
+
138
+ ## Gezinme
139
+
140
+ - **Yığın varsayılandır; ayar yoktur.** `redirect` adımı hedef sayfayı yığına iter, geri hareketi
141
+ (cihaz geri tuşu, app-bar geri düğmesi, tarayıcı geri) önceki ekrana döner. Göreli yol uygulama
142
+ köküne eklenir; tam adres (`https://…`) dışarıda açılır.
143
+ - **Sekmeler uygulama ayarıdır, layout'ta değil.** `application_update({ properties: { mobile: { tabs } } })`:
144
+
145
+ ```json
146
+ {
147
+ "mobile": {
148
+ "tabs": {
149
+ "enabled": true,
150
+ "style": "default",
151
+ "items": [
152
+ { "page": "<page_list id>", "label": "Görevler", "icon": "list" },
153
+ { "page": "<page_list id>", "label": "Profil", "icon": "user" }
154
+ ],
155
+ "showLabels": true
156
+ }
157
+ }
158
+ }
159
+ ```
160
+
161
+ `items` 1–5 sayfa **id**'si (slug değil), tekrar yok; `style: 'floating'` köşe `pill` + gölge `md`
162
+ çizer. Çubuğun rengi ayarda YOKTUR: zemin `surface`, seçili `accent-primary`, seçilmemiş
163
+ `text-secondary` — değiştirmek için `theme_update`; eski `appearance` alanı okunmaz; `style: 'custom'` + `customWidgetId` çubuğu kendi widget'ınla çizer. Tutarsız ayar ve
164
+ layout/sayfada eski `tab-bar` / `drawer-menu` düğümü `MOB-007` alır. Sekme dışı sayfalar yığına açılır.
165
+ - **Çekmece bir bileşendir.** `drawer` widget'ı + `app-bar`'ın `menuTarget` prop'u çekmeceyi açar.
166
+ - Kabuk örnekleri: `ngapps://examples/mobile-app-shell-stack` (yığın), `ngapps://examples/mobile-app-shell-tab`
167
+ (sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); üç sayfalık liste → detay → form akışı:
168
+ `ngapps://examples/mobile-list-detail-form`.
169
+
170
+ ## Akış adımları
171
+
172
+ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
173
+ `validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar:
174
+
175
+ | Adım | Mobilde |
176
+ |---|---|
177
+ | `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres) |
178
+ | `navigate` | eski mobil şemaların adı — `redirect`'in takma adıdır; gateway `redirect`'e çevirir |
179
+ | `alert` | tipli uyarı (`success`/`error`/`info`/`warning`) toast'tur ve beklemez; düz uyarı onay bekler |
180
+ | `confirm` | `yes` / `no` dalları |
181
+ | `download` | adres cihazın açma sayfasında açılır, gövde paylaşım sayfasına gider (`MOB-005`, bilgi) |
182
+ | `storage` | cihaz deposu |
183
+ | `setcookie` | cihaz deposuna yazar (`MOB-005`, bilgi); paletten yalnız web'de sunulur |
184
+
185
+ Sayfa ve layout `mount` akışları ilk çizimden sonra, `destroy` akışları sayfa kalkarken koşar.
186
+ `Functions.<ad>()` uygulama ve sayfa fonksiyonlarını görür (`platform_guide('functions')`).
187
+
188
+ ## Doğrulama
189
+
190
+ - `page_screenshot({ applicationSlug, pageSlug })` mobil uygulamada `device: 'phone'` (390x844, kare
191
+ 780x1688 px) çeker; `'tablet'` 820x1180 @2 ya da `{ width, height, scale? }`. `viewport` verilirse
192
+ cihaz yok sayılır (`deviceNote`). Yanıt `applicationType: 'mobile'` ve `platformNote` taşır: kare
193
+ react-native-web çizimidir, cihazdakiyle yapısal olarak (düğüm, sıra, ölçü, renk) aynıdır.
194
+ - Eylemler aynı sözlük: `click` basılabilir öğeyi (`role="button"`) bulur; `submit` runtime
195
+ köprüsüyle gider (`submitVia: 'bridge'`); sekme öğesi `__tabs__item-<sayfa slug'ı>`, çubuk `__tabs`
196
+ özet satırıdır. `select` açılır listeyi açar ve seçeneği değerle ya da görünen metinle seçer
197
+ (liste katmanda açılır, `optionsSeen` kaç seçenek görüldüğünü söyler); `tab` bir `tabs`
198
+ bileşeninin sekmesini anahtarıyla (`<elementId>__tab-<anahtar>`) bulur.
199
+ - `flowRuns: 0` + `requests: 0` bir tıklamada akışın koşmadığını söyler: olay bağını
200
+ `page_runtime_get`, akışı `flow_get` ile doğrulayın.
201
+ - Kuru doğrulama: `page_schema_validate` mobil kataloğa karşı doğrular (`MOB-003`).
202
+
203
+ ## Cihazda önizleme
204
+
205
+ Expo uygulaması (`apps/mobile-runtime`) aynı sayfayı native çizer. Derin bağlantı
206
+ `zeyrek://open/{proje}/{uygulama}/{sayfa}?env=<ortam>` **token taşımaz**: cihazdaki uygulama zaten giriş
207
+ yapmış olmalıdır. Canlı önizleme sayfa şeması değişikliğini (`/hubs/page-schema`) dinler; yazdığın
208
+ yama cihazda yenilenir.
209
+
210
+ ## Bilinen farklar
211
+
212
+ - Piksel paritesi yoktur: yazı tipi ölçüsü, gölge ve güvenli alan cihaza göre değişir. Parite yapısaldır.
213
+ - Bileşen kataloğu dalga dalga gelir; `component_list` ne döndürüyorsa odur.
214
+ - Temanın bileşen stilleri (`componentStyles`, preset'ler) mobil çizerde henüz uygulanmıyor.
215
+ - Dar ekran kırılımı (`hideOn: 'mobile'`) mobil uygulamada anlamsızdır: ekran zaten tek boydur.
@@ -4,6 +4,10 @@ Studio'nun tuval tarafı. Buradaki kurallar controller + komut kodundan doğrula
4
4
  (`zeyrek-mcp/docs/13-faz2-envanter.md` §4); veri/mantık tarafı için
5
5
  `platform_guide('entity')`, `('microservice')`, `('workflow')`.
6
6
 
7
+ > **Mobil uygulamada** (`type: 'mobile'`) şema ve micro-op'lar aynıdır ama yerleşim yalnız flex'tir
8
+ > (blocks çizilmez), görünüm tipli gruplarla yazılır ve `page_create` kökü flex sütun kurar —
9
+ > `platform_guide('mobile')`. Bu rehberdeki "dar ekran" notları WEB uygulamasının telefon kırılımıdır.
10
+
7
11
  ## Kuruluş sırası
8
12
 
9
13
  ```
@@ -93,9 +97,8 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
93
97
  komponentin iç kimliğidir (aşağıda Kural 2, `FLOW-018`).
94
98
 
95
99
  - **`blocks[].size`'ı komponentin `component_get`'teki `minSize`..`maxSize` aralığında tut.** Dikkat:
96
- katalog varsayılanı aşabiliyor (`datepicker` default `h:8`, `maxSize` `h:5`; 18 şemada aynı
97
- durum, liste zeyrek-frontend `docs/issues.md` ARC-013 — `page-header` 2026-09-18'de sınırı
98
- 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
100
+ katalog varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü
101
+ körüne kopyalama. Sınır grid kanvasının kuralıdır; API 2026-09-15'ten beri reddetmez, ama aşan
99
102
  blok kanvasta boyutlandırılamaz (aşağıda Kural 7 "Boyut tuzağı").
100
103
  - **Kurulmuş bir düğümün boyutunu `resize_component` micro-op'u değiştirir.**
101
104
  `{ op: 'resize_component', target: '<elementId>', size: { w, h } }` ızgara boyutunu,
@@ -160,32 +163,19 @@ Sayfa açılışında veri çekmek için `mount` kullanılır ama tek seçenek o
160
163
 
161
164
  Yani "satırı seçince detay getir" (`select`), "kolondan süzünce sunucudan yeniden çek"
162
165
  (`filter`), "sayfa değişince yeni sayfayı çek" (`pagination`), "satıra çift tıklayınca formu aç"
163
- (`doubleClick`) akışları da aynı `set_event` mekanizmasıyla kurulur. Buna karşılık `datatable`
164
- yalnız `mount` yayar (bilinçli — Kural 1e); `page-header` 2026-09-18'den beri izdeki öğe
165
- tıklamasını `clickItem` olarak yayar (`component_get` yükü verir).
166
+ (`doubleClick`) akışları da aynı `set_event` mekanizmasıyla kurulur. Buna karşılık `page-header`
167
+ ve `datatable` yalnız `mount` yayar (`datatable`'ınki bilinçli — Kural 1e).
166
168
 
167
169
  **Olay adları `on` ÖNEKİ ALMAZ** (`button` → `click`, `form` → `submit`), tek istisna katalogda
168
170
  `texteditor`'dur (`onMount`/`onChange`). **Komponentin desteklemediği bir olay adı verirsen bağ
169
171
  sessizce ölü kalır** — önce `component_get`. Gateway `set_event`'i katalogla karşılaştırır ve
170
172
  uymayan adı **PAGE-008** ile istek gitmeden reddeder.
171
173
 
172
- **Bir olaya birden fazla akış bağlanabilir — ikinciyi `add_event` ile ekle.** `set_event` olayın
173
- BÜTÜN bağlarını tek akışa indirir: başlık alanının `change` olayına makale önerisi bağlıyken akıllı
174
- öneriyi `set_event` ile bağlamak makale önerisini devre dışı bırakır. Gateway bunu **PAGE-034** ile
175
- istek gitmeden reddeder. Doğru op `{ "op": "add_event", "target": "<elementId>", "event": "change",
176
- "eventValue": "<ikinci flow id>" }`'dir. Olay tetiklenince bağlı akışların hepsi **paralel ve
177
- birbirinden bağımsız** koşar: biri hata verirse diğeri etkilenmez, **sıra garantisi yoktur**. Biri
178
- diğerinin sonucunu bekliyorsa ya da ikisi aynı değişkene/prop'a yazıyorsa ayrı bağ değil,
179
- `flow-trigger` adımıyla zincir kur (Kural 1c). Mevcut bağı bilerek değiştirmek için `set_event`
180
- op'una `replaceBoundFlows: true` ekle. **Mobil runtime yalnız ilk akışı koşar** — mobil
181
- uygulamada olay başına tek akış bağla.
182
-
183
174
  **Olay KALDIRMAK için `remove_event` kullan.** Platformun `set_event` micro-op'u olay silemez:
184
175
  `eventValue: null` verildiğinde kayıt `{ name: 'click' }` olarak (değersiz) kalır, diziden
185
176
  çıkmaz — şemada ölü bağ artığı bırakır. `{ "op": "remove_event", "target": "<elementId>",
186
177
  "event": "click" }` platformun op'udur: olayı diziden çıkarır (yanıtta `removedEvents`); olmayan
187
- bir olayı kaldırmaya çalışmak `missing-event` ile 422 döner. Olaya birden fazla akış bağlıysa
188
- kaldırılacak akışı `eventValue` ile ver; vermezsen `ambiguous-event` ile 422 döner. Sayfa düzeyi olaylar için
178
+ bir olayı kaldırmaya çalışmak `missing-event` ile 422 döner. Sayfa düzeyi olaylar için
189
179
  `target: "page"`. Referanssız kalan akış silineceği için `allowFlowDeletion` kuralı (G-21) bu op'ta
190
180
  da geçerlidir.
191
181
 
@@ -199,14 +189,12 @@ olaylarında **boştur** (ölçüm 2026-08-25, kaynak okuması: `flow-machine.ts
199
189
  Pratik kural: **`payload` anahtarları aynı zamanda prop adlarıdır; akışta `self.<anahtar>` ile
200
190
  oku** (ya da `value { type:'property', ref:{ source:'component', element, property } }` ile).
201
191
  `event.data` yalnız `params` ile gelen olaylarda dolar — `html` komponentinin `fireEvent`
202
- aksiyonları (`platform_guide('html')`) ve **`params`'ı da gönderen komponentler**
203
- (`eventcalendar` · `importwizard` · `kanban` · `signature` · `stepper` · `tabs` ·
204
- `tree-view` · `pagination`): bunların yükü `event.data.<anahtar>` ile de okunur; `kanban` ve
205
- `eventcalendar` yükü `self`'e HİÇ yazmaz (`component_get` çıktısındaki sözleşme notları ayrımı
206
- söyler). Sessiz hata örneği: **tablonun kendi** sayfalama akışını (`table.pagination`)
207
- `event.data.limit`'e bağlarsan sorgu `LIMIT null OFFSET null` ile koşar ve **tüm satırları**
208
- döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tuzağa girmez, yükünü
209
- `params` ile de gönderir.)
192
+ aksiyonları (`platform_guide('html')`) ve **2026-08-27 kuşağı komponentler** (`eventcalendar` ·
193
+ `importwizard` · `kanban` · `signature` · `stepper`): bu kuşak `params`'ı da gönderir, yani
194
+ yükleri `event.data.<anahtar>` ile okunur; `kanban` ve `eventcalendar` yükü `self`'e HİÇ
195
+ yazmaz (`component_get` çıktısındaki sözleşme notları ayrımı söyler). Sessiz hata örneği:
196
+ sayfalama akışını `event.data.limit`'e bağlarsan sorgu `LIMIT null OFFSET null` ile koşar ve
197
+ **tüm satırları** döndürür; hata yok, sayfalama yok.
210
198
 
211
199
  | Komponent · olay | Yük (aynı zamanda prop adları) | Akışta nereden okunur |
212
200
  |---|---|---|
@@ -216,18 +204,16 @@ döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tu
216
204
  | `table.select` · `doubleClick` | — | `self.selectedRow` |
217
205
  | `table.selectionChange` | — | `self.selectedRows` |
218
206
  | `datatable.mount` | — | `self.filters` · `self.sortField` · `self.sortType` · `self.offset` |
219
- | `pagination.change` | `{ offset, limit }` | `self.offset` · `self.limit` ya da `event.data.offset` · `event.data.limit` |
207
+ | `pagination.change` | `{ offset, limit }` | `self.offset` · `self.limit` |
220
208
  | `textinput/textarea/password.change` | `{ value }` | `self.value` |
221
209
  | `dropdown.change` · `multi-select.change` | `{ value }` | `self.value` |
222
210
  | `dropdown.search` · `multi-select.search` | `{ searchText }` | `self.searchText` |
223
- | `tabs.tab` | `{ selected }` | `self.selected` ya da `event.data.selected` |
211
+ | `tabs.tab` | `{ selected }` | `self.selected` |
224
212
  | `chart.dataPointClick` | `{ name, seriesName, value, dataIndex, row }` | `self.row` (kaynak satırın tamamı) |
225
- | `repeater.change` · `repeater.select` | `{ selectedIndex }` | `self.selectedIndex` · `self.selectedItem` (akış satır bağlamında koşmaz, `item`/`Row` boş) |
213
+ | `repeater.change` | `{ selectedIndex }` | `item` / `Row` satır bağlamı |
226
214
  | `html` aksiyonu (`fireEvent`) | ikinci argüman | **`event.data`** |
227
215
  | `kanban.cardMove` | `{ id, row, from, to }` | **`event.data`** (self'e yazılmaz) |
228
- | `kanban.cardAdd` · `kanban.cardRemove` | `{ column }` · `{ id, row, column }` | **`event.data`** (self'e yazılmaz; kart eklenmez/gizlenmez, akış yazıp `rows`'u tazeler) |
229
216
  | `eventcalendar.eventMove` | `{ id, row, start, end, previousStart, previousEnd }` | **`event.data`** (self'e yazılmaz) |
230
- | `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`) |
231
217
  | `importwizard.complete` | `{ rows, errors, fileName, total }` | `self.rows`… ya da `event.data` |
232
218
  | `stepper.stepChange` | `{ currentStep, previous }` | `self.currentStep` ya da `event.data` |
233
219
  | `signature.change` | `{ value }` | `self.value` ya da `event.data.value` |
@@ -386,11 +372,8 @@ göstermek error flow'un işidir.
386
372
  > `errorTasks.some(t => t.type !== 'start')` arar. Start'ın ardına en az bir adım bağla —
387
373
  > gateway `FLOW-021` ile uyarır.
388
374
  >
389
- > **Mobilde `errorSteps` diye bir şey YOK.** `ScreenRuntime.tsx` `mapFlowsToMachine` yalnız
390
- > `tasks` üretir (web `Runtime.svelte` ayrıca `errorTasks` verir), yani mobil uygulamada
391
- > `hasErrorFlow` her zaman false: hata yolu hiç koşmaz ve akış yukarıdaki 2. yoldan —
392
- > `always` + hata gövdeli storage — devam eder. Mobil sayfada hata yolunu `condition
393
- > Steps.<adımAdı>.error` ile kur.
375
+ > **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native` `NativeRuntime`) `errorSteps`'i web gibi
376
+ > `errorTasks`'a eşler — hata yolu iki platformda aynı koşar.
394
377
 
395
378
  > **Hata metni ÜÇ ayrı yerde durur ve ikisi kullanıcıya gösterilecek metin DEĞİLDİR.**
396
379
  > `onError` hata akışını koşturmadan önce `machine.setStorage('error', errorInfo)` yapar
@@ -520,14 +503,14 @@ değer tipleri: `static · page · property · storage · variable · code · it
520
503
  > tip register eder, gerisini uygulama ekler. Bir sayfa TEK bir uygulamaya aittir
521
504
  > (`Page.ApplicationId`) ve uygulamanın tipi `web` ya da `mobile`'dır (`ApplicationType.cs`), yani
522
505
  > sayfanın barındırıcısı bellidir — matris "hangi tip sende çalışır"ı söyler, iki barındırıcıda
523
- > birden koşmayı değil (web `Runtime.svelte`, mobil `ScreenRuntime.tsx`):
506
+ > birden koşmayı değil (web `Runtime.svelte`, mobil uygulama `@ng-apps/ui-native` `NativeRuntime`):
524
507
  >
525
- > | Adım tipi | Web | Mobil | Nerede register ediliyor |
508
+ > | Adım tipi | Web | Mobil uygulama | Nerede register ediliyor |
526
509
  > |---|---|---|---|
527
- > | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi (`function` mobilde kayıtlıdır ama mobil runtime `Functions`'ı boş kurar — K11, çağrı çalışmaz) |
528
- > | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | uygulama; mobilde `redirect` navigate, `setcookie` storage uygulamasına eşlenir |
529
- > | `confirm` · `download` | ✅ | ❌ | yalnız `Runtime.svelte` |
530
- > | `navigate` | ❌ | ✅ | yalnız `ScreenRuntime.tsx` — web'deki karşılığı `redirect` |
510
+ > | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi |
511
+ > | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | barındırıcı; mobilde `setcookie` cihaz deposuna yazar (`MOB-005`) |
512
+ > | `confirm` · `download` | ✅ | ✅ | `Runtime.svelte` · `runtime-tasks.ts` (`download` mobilde açma/paylaşım — `MOB-005`) |
513
+ > | `navigate` | ❌ | ✅ (`redirect` takma adı) | web'deki karşılığı `redirect`; gateway `redirect`'e çevirir |
531
514
  > | `end` · `query` | ❌ | ❌ | hiçbir yerde — üstelik `query` backend sözlüğünde de yok (`StepType.cs` onu saymaz), yalnız frontend enum'unda duruyor |
532
515
  >
533
516
  > **Register edilmemiş bir tipe gelen akış SESSİZCE durur.** `flow-engine.ts` `process()`
@@ -861,7 +844,7 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
861
844
  > `add_component` ile yeniden kurmaktır (sonrasında Kural 2'deki flow yeniden kaydetme adımı
862
845
  > ZORUNLU olur).
863
846
 
864
- Mobil not: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
847
+ Dar ekran notu: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
865
848
  dikey sıraya dönüşür, x/w yok sayılır. Yerleşimi masaüstü (breakpoint 1024) bloğuyla kur.
866
849
 
867
850
  ## Kural 1f-2 — Kapsayıcı düzeni: `flex` (varsayılan) ↔ `grid`
@@ -950,10 +933,10 @@ Beş şeyi bilmeden flex kurma:
950
933
  4. **`layout: 'grid'` iken diğer altı prop ÖLÜDÜR.** Katalogda tanımlı oldukları için
951
934
  doğrulama duvarı susar, renderer da okumaz: ızgara kapsayıcıya `direction: 'column'` yazmak
952
935
  sessizce hiçbir şey yapmaz. Gateway bunu **PAGE-015 (uyarı)** ile söyler.
953
- 5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve mobilde AYNIDIR;
954
- sıra ve span'lar Desktop (1024) bloğundandır — Studio, mobil kırılım düzenlenirken flex
936
+ 5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve dar ekranda AYNIDIR;
937
+ sıra ve span'lar Desktop (1024) bloğundandır — Studio, dar ekran kırılımı düzenlenirken flex
955
938
  bölgeyi salt-okunur kilitler. Kırılım bilen yalnız `blocks[]` ve `appearance.hideOn`'dur;
956
- mobilde farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f mobil notu).
939
+ dar ekranda farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f dar ekran notu).
957
940
 
958
941
  ```jsonc
959
942
  // Ortalanmış giriş kartı — style ile CSS hack'i YOK, kabın kendi düzeni
@@ -1097,6 +1080,45 @@ kendisi nesneye çevirir; Studio tablosunda `[object Object]` görünmesi normal
1097
1080
  (`platform_guide('entity')` → "TEXT kolonunda JSON"). Ekranın görsel tarafı için **Kural 1h**:
1098
1081
  tema `--ng-*` değişkenleriyle tek yerden çevrilir, `html` kaçış kapısına gerek kalmaz.
1099
1082
 
1083
+ ## Kural 1g-2 — Mobil davranış: dört ayar, dört ayrı sahip
1084
+
1085
+ Mobil listelerin davranışı TEK bileşende toplanmaz. Hangi ayarın kimde olduğunu bilmeden yazılan
1086
+ şema sessizce çalışmaz — prop var olmayan bileşene yazılır ve `page_schema_patch` onu düşürmez,
1087
+ çizer yok sayar.
1088
+
1089
+ | Davranış | Sahip bileşen | Prop / olay |
1090
+ |---|---|---|
1091
+ | Çekerek yenile | `scroll-view` (listeyi SARAN kap) | `refreshable: true` + `refresh` olayı |
1092
+ | Sonsuz kaydırma | `scroll-view` | `scrollEnd` olayı (prop yok) |
1093
+ | Kaydırma eylemleri | `repeater` | `swipeActions: [{ key, label, tone, icon }]` + `swipe` olayı, payload `{ key, index, row }` |
1094
+ | Satıra dokunma | `repeater` | `itemPressable: true` + `itemPress` olayı, payload `{ index, row }` |
1095
+
1096
+ Çekerek yenileyi `repeater`'a yazmak en sık hatadır: liste kendi kaydırmasını yapmaz, onu saran
1097
+ `scroll-view` yapar. `repeater` kökteyse (kap yok) yenileme hiç çizilmez.
1098
+
1099
+ Satıra dokunmanın kartın `click`'iyle yapılan eski yolu mobilde bırakıldı: `itemPress` satır
1100
+ bağlamını payload'da taşır ve seçimi (`selectedIndex`) de yazar, yani akış satırı
1101
+ `<tekrarlayıcı>.selectedItem` ile okumaya devam eder.
1102
+
1103
+ ### `redirect.presentation`
1104
+
1105
+ `redirect` adımının `args.presentation` alanı ekranın NASIL açıldığını söyler ve kapalı bir küme
1106
+ alır:
1107
+
1108
+ - `push` — yığına ekler, geri düğmesi önceki ekrana döner (**varsayılan**; alan yazılmayabilir)
1109
+ - `modal` — alttan açılan ayrı bir sunum; geri onu kapatır, altındaki ekran yerinde kalır
1110
+ - `replace` — geçerli ekranı değiştirir, geçmişe girmez (giriş → ana ekran için doğru olan)
1111
+
1112
+ Küme dışı bir değer **MOB-008** uyarısıdır ve backend doğrulayıcısı 422 döner. Alanı hiç yazmamak
1113
+ kusur değildir.
1114
+
1115
+ **Sekme hedefinde `modal` çalışmaz.** Hedef sayfa bir sekmeyse gezinme her zaman `navigate`'e
1116
+ düşer: sekme yığını kendi geçmişini tutar ve modal onu kırardı. `presentation`ı yazabilirsiniz,
1117
+ çizer sessizce yok sayar — sekme dışı bir sayfaya modal istiyorsanız o sayfayı sekme listesinden
1118
+ çıkarın.
1119
+
1120
+ Web uygulamasında alan yok sayılır; gateway web profilinde bu konuda bulgu üretmez.
1121
+
1100
1122
  ## Kural 1h — Tasarım: `style` prop'u ve tema değişkenleri
1101
1123
 
1102
1124
  Her komponentin `style` prop'u vardır ve emotion `css()` bloğudur: iç seçiciler, pseudo-class'lar
@@ -1316,7 +1338,7 @@ budur — bir preset ya da `componentStyles` sizin değerinizi eziyorsa `styleLa
1316
1338
  | Değişiklik | Tool | Neden |
1317
1339
  |---|---|---|
1318
1340
  | Komponent ekle/sil/taşı, prop, binding, event | `page_schema_patch` | Doğrulama duvarı + açık Studio canvas'ına SignalR canlı yayını + eşzamanlı yazar kilidi yalnız bu yolda çalışır |
1319
- | Ad, slug, browserTitle, `browserTitleKey`, layout, roller, middleware | `page_update` | Üstbilgi alanları micro-op sözlüğünde yok. `browserTitleKey` sekme başlığını çeviri anahtarına bağlar: verilirse başlık sözlükten çözülür, boşsa `browserTitle` kullanılır. Başlık canlı dil değişimini izler; anahtarın o dilde değeri yoksa varsayılan dile düşer (`platform_guide('translation')`) |
1341
+ | Ad, slug, browserTitle, `browserTitleKey`, layout, roller, middleware | `page_update` | Üstbilgi alanları micro-op sözlüğünde yok. `browserTitleKey` sekme başlığını çeviri anahtarına bağlar: verilirse başlık sözlükten çözülür, boşsa `browserTitle` kullanılır. Başlık sayfa yüklenirken çözülür ve canlı dil değişimini izlemez (`platform_guide('translation')`) |
1320
1342
 
1321
1343
  Platformun `PUT /pages/...` ucu **replace**'tir: gönderilmeyen `schema`/`events`/`roleIds`
1322
1344
  alanları silinir. Gateway bu yüzden `page_update`'te sayfayı önce okur, yalnız verdiğin
@@ -1831,7 +1853,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
1831
1853
  | Kimlik alanları | `email` · `password` |
1832
1854
  | Dosya | `fileUpload` (dropzone) · `fileInput` · `filebutton` · `file-viewer` |
1833
1855
  | 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ışı) |
1834
- | 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) |
1856
+ | 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ı) |
1835
1857
  | 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 |
1836
1858
  | 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 |
1837
1859
  | İ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) |