@appaflytech/zeyrek-ai-mcp 0.0.20 → 0.0.21

package/dist/tools/workflows.js

@@ -7,10 +7,13 @@ import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { policyRules, microfunctionStepFindings, workflowStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
+import { existingMatch, ifExistsParam, listAll, platformRename, withOutcome, withRename } from '../platform/ifExists.js';
+import { outlineWrite, recordWriteViewParam } from '../platform/writeView.js';
 import fastJsonPatch from 'fast-json-patch';
 import { z } from 'zod';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
 import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+const workflowIfExistsParam = ifExistsParam('workflow', 'mevcut workflow\'u bu tanımla tam gövde günceller (id\'si korunur; workflow_update ile aynı yazma)');
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
@@ -111,27 +114,51 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_create', {
         title: 'Workflow oluştur',
-        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Her adım ve akışın kendisi 'description' taşımak ZORUNDADIR (WF-024, block): adımın NE İŞE YARADIĞINI 1-2 cümleyle yazın — Studio kanvasında ⓘ ikonu olarak görünür; mekanizmayı değil niyeti yazın. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. " + constraintSummary('CreateWorkflowCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. Uygulamada aynı ad ya da slug'da workflow varsa (tipten bağımsız) varsayılan olarak YAZMAZ ve mevcut kaydın id'sini döner (WF-034 — gönderilseydi platform '<ad> (1)' adıyla ikinci bir kayıt açardı); tekrar çalıştırılabilir yazma için ifExists:'update' verin, yanıttaki outcome 'created' | 'updated' olur. Mevcut workflow'lar okunamazsa da yazmaz. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Her adım ve akışın kendisi 'description' taşımak ZORUNDADIR (WF-024, block): adımın NE İŞE YARADIĞINI 1-2 cümleyle yazın — Studio kanvasında ⓘ ikonu olarak görünür; mekanizmayı değil niyeti yazın. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. " + constraintSummary('CreateWorkflowCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, ifExists: workflowIfExistsParam, view: recordWriteViewParam, policyOverride: policyOverrideParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, definition, ifExists, view, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy([
-            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
+        // Politika ÖNCE koşar: block alan istek platforma hiç gitmez, var-mı listesi de okunmaz.
+        const stepFindings = [
             ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
             ...await workflowStepFindings(platform, project, environment, applicationId, definition, definition.type, policyOverride),
             ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
-        ]);
-        const drift = unmappedMembers('CreateWorkflowCommand', definition);
-        const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
-        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
+        ];
+        const bodyFindings = (operation) => evaluatePolicy(config, policyRules, 'workflow', definition, { operation, workflowKind: definition.type }, policyOverride);
+        const createFindings = enforcePolicy([...bodyFindings('create'), ...stepFindings]);
+        const existing = await existingMatch({
+            code: 'WF-034',
+            noun: 'workflow',
+            where: 'bu uygulamada',
+            name: typeof definition.name === 'string' ? definition.name : undefined,
+            slug: typeof definition.slug === 'string' ? definition.slug : undefined,
+            id: typeof definition.id === 'string' ? definition.id : undefined,
+            idParam: 'definition.id',
+            ifExists,
+            list: () => listAll(platform, project, environment, `/workflows/${applicationId}`),
+            listTool: 'workflow_list',
+            copyCheck: 'kullanılıp kullanılmadığını workflow_dependencies ile kontrol edip gerekirse silin',
+            updateTool: 'id ile workflow_update',
+            kind: { key: 'type', value: definition.type }
+        });
+        // Kayıt bulunduysa yazma bir UPDATE'tir: gövde kuralları workflow_update ile aynı kipte yeniden
+        // değerlendirilir (R-1). Adım denetimleri operasyondan bağımsızdır, tekrar koşmaz.
+        const findings = existing === undefined ? createFindings : enforcePolicy([...bodyFindings('update'), ...stepFindings]);
+        const drift = unmappedMembers(existing === undefined ? 'CreateWorkflowCommand' : 'UpdateWorkflowCommand', definition);
+        const payload = existing === undefined
+            ? await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition })
+            : await platform.tenant('PUT', project, `/workflows/${applicationId}/${String(existing.id)}`, { environment, body: definition });
+        const saved = payload?.data;
+        const rename = ifExists === 'duplicate' ? platformRename(definition, saved, 'dash') : { sent: definition };
+        return attachFindings(withUnmappedMembers(withWriteDiff(withRename(withNormalization(withOutcome(outlineWrite(payload, view, ['type']), existing), normalized), rename.renamed), writeDiff(rename.sent, payload)), drift), findings);
     }));
     server.registerTool('workflow_update', {
         title: 'Workflow güncelle',
         description: 'Workflow tanımını günceller (definition = UpdateWorkflowCommand, tam gövde). Hedefli değişiklik için workflow_patch tercih edin. Her adım ve akışın kendisi \'description\' taşımak ZORUNDADIR (WF-024, block). Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. ' + constraintSummary('UpdateWorkflowCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, view: recordWriteViewParam, policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, definition, view, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
@@ -141,7 +168,7 @@ export function registerWorkflowTools(server, platform) {
         ]);
         const drift = unmappedMembers('UpdateWorkflowCommand', definition);
         const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
-        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(outlineWrite(payload, view, ['type']), normalized), writeDiff(definition, payload)), drift), findings);
     }));
     server.registerTool('workflow_patch', {
         title: 'Workflow\'a patch uygula',

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeyrek-v2/zeyrek-app.git",
+    "directory": "zeyrek-mcp"
+  },
   "engines": {
     "node": ">=20"
   },
@@ -55,4 +60,4 @@
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"
   }
-}
+}

package/dist/knowledge/mobileComponentCatalog.js

@@ -1,331 +0,0 @@
-/**
- * Bütün mobil komponentler için geçerli kurallar. Kayıt başına tekrarlanmaz;
- * okuyucu (`component_get`) bu notları `mobileNotes`'a ekler
- * (`platform/mobileRules.ts` `mobileComponentNotes`). Yerleşim (MOB-001) ve stil
- * (MOB-002) notları kural koduyla birlikte orada durur, burada tekrarlanmaz.
- */
-export const MOBILE_COMPONENT_NOTES = [
-    "Tasarım kipinde (Studio kanvası) alanlar yazılamaz ve düğmeler basılamaz: dokunuş kanvasın seçim jestidir.",
-    "Olay yükleri web ile AYNI sözleşmedir (`componentEvents.ts`): alanlar `change`/`changed`/`enter`/`focus`/`blur`, seçim bileşenleri `change` + `checked`/`unchecked`, katmanlar kapanışta `change { isOpen: false }` ve `open`/`close` yayar; `type: submit` düğme `click` yaymaz, üstteki `form`un `submit`ini tetikler (`formId` varsa o formun). Web'deki istemci tarafı şema doğrulaması (`validations` → zod) mobilde YOKTUR: doğrulamayı akışta yapın.",
-    "Bileşenler shadcn/ui görünümünde çizilir (react-native-reusables ilkelleri, NativeWind); renk ve köşe yine PROJE TEMASINDAN gelir: `--ng-*` değişkenleri shadcn token'larına (`--primary`, `--secondary`, `--muted`, `--destructive`, `--border`, `--input`, `--ring`…) ve köşe ölçeğine köprüyle çevrilir (`shadcn-vars.ts`), koyu kip aynı köprünün ikinci çözümüdür. Tema değişince web ve mobil birlikte hareket eder; web sayfası kendi bileşen ailesiyle çizildiği için iki platformun görünüm farkı bilinçlidir. Ölçü (alan yüksekliği, punto, iç boşluk) temanın `--ng-form-*` değişkenlerinden gelir. Yazı AİLESİ köprüde yoktur: temanın ailesi alanlarda (metin, sayı, parola, açılır liste), başlıklarda (`app-bar`, `form`, `modal`/`drawer`, boş durum) ve sekme çubuğunda uygulanır; `text` ve düğme etiketi ata kabın `typographyStyle` ailesini, o da yoksa platform yazı tipini kullanır; alan, anahtar ve onay kutusu etiketleri HER ZAMAN platform yazı tipiyle çizilir.",
-    "Boyut panelinin en-boy oranı (`appearance.aspectRatio`, SAYI — 16:9 için `1.78`) boyu genişlikten türetir ve düğüm KABUĞUNA yazılır (zemin, kenar ve iç boşluk dahil görünen kutu tam oranda). Üç koşul: `heightType: 'auto'` (web ile aynı; `fixed`/`fill` ya da yazılmamış boy oranı ezer), genişlik BELLİ — `widthType: 'fill'` ya da `'fixed'` + `widthString` (içerik genişliğinde react-native-web boyu genişlikten, cihazın Yoga'sı genişliği boydan türetir; iki kutu ayrışmasın diye oran o durumda uygulanmaz), düğüm widget örneği değil. Web'den farkı AKIŞ KAPLARI: `container`, `form`, `safe-area`, `scroll-view` mobilde oran alır ve akışları oranlı boyu doldurur (`verticalAlign` `middle`/`bottom`/`stretch` web gibi çalışır). Öteki bırakılabilir tipler (`collapsible-container`, `repeater`, `tabs`, `tooltip`), sayfa kökü ve katmanlar (`modal`, `drawer`) oran almaz; `image` oranı kendi çizimine yazar."
-];
-/**
- * Web sözlüğünün `STATE_FLAG_NOTES`'undan mobilde FARKLI olan bayraklar. `component_get` mobil
- * uygulamada bunları web notlarının üstüne yazar; kaydı olmayan bayrak web notunu korur.
- * Kaynak: `packages/ng-apps-ui-native/src/renderer/renderer.functions.ts` `aspectRatioStyle`.
- */
-export const MOBILE_STATE_FLAG_NOTES = {
-    isDroppable: "Düğüm çocuk kabul eder ve iç dolgusunu padding kutusundan alır. Web'den farklı olarak mobilde AKIŞ KAPLARI (`container`, `form`, `safe-area`, `scroll-view`) appearance.aspectRatio'yu uygular — boy `auto` ve genişlik `fill`/`fixed` iken; kabın akışı oranlı boyu doldurur. Öteki bırakılabilir tipler (katlanır kap, liste, sekmeler, ipucu, katmanlar) oranı yok sayar."
-};
-export const mobileComponentKnowledge = {
-    container: {
-        summary: 'Flex akışı; mobil sayfanın tek yerleşim kabı.',
-        differences: [
-            "`layout` düşer (flex-only), `hoverStyle` düşer (dokunmatikte hover durumu yoktur), `style` düşer.",
-            'Yüzey (zemin, köşe, kenarlık, gölge) düğüm kabuğunda derlenir; kabın kendisi yalnız yön, hizalama ve aralık (`gap`) taşır.',
-            "Hiza adları web ile aynı eşlenir: `verticalAlign: 'middle'` ve `horizontalAlign: 'center'` ortalar. Dikey hizanın kullanacağı boşluk kabın boyundan gelir — `heightType` `fill`, `fixed` ya da en-boy oranlı kapta akış kabuğun boyunu doldurur; boyu içerikten gelen SÜTUN kapta dikey hiza etkisizdir (satır kapta farklı boydaki kardeşleri yine hizalar). `stretch` de web gibi: ana eksende (sütunda `verticalAlign`, satırda `horizontalAlign`) çocukları eksen boyunca yayar, çapraz eksende gerer.",
-            'Kutu modeli web ile AYNI kural ve varsayılanlarla çizilir (`appearance.marginType/paddingType`, `normal` = 4 / 10 dp, `custom` kenar kenar): tipi yazılmamış düğüm `normal` dış boşluk, bırakılabilir kap `normal` iç boşluk alır — kenara yaslanacak kapta `none` yazın. `wrap: true` iken satırlar çapraz hizayı izler (web `flex-layout` ile aynı: `stretch` kabı doldurur, `top`/`left` üstten dizer).'
-        ]
-    },
-    'widget-area': {
-        summary: 'Konteyner widget`ının kökü; yerleşim sözleşmesi `container` ile aynıdır.',
-        differences: [
-            '`layout` düşer (flex-only), `style` düşer.',
-            'Özel sekme çubuğu (Ayarlar › Sekmeler › Özel widget, K14) bu kökü taşıyan mobil widget`tır: runtime onu `Widget.tabs = { items: [{ page, slug, label, icon, active }], activePage }` parametresiyle çizer, kök kimliği `__tabs`.'
-        ]
-    },
-    'safe-area': {
-        summary: 'Güvenli alan kabı: içeriği durum çubuğu, çentik ve ev göstergesinden uzak tutar (D15).',
-        differences: [
-            'Web`de karşılığı YOKTUR — mobile özgü şema; yerleşim alanları mobil `container` ile aynıdır, varsayılan yön sütun.',
-            'Pay barındırıcının cihaz bilgisinden gelir (`host.device.insets`): cihazda gerçek güvenli alan, Studio kanvasında seçili cihaz ön ayarı, önizlemede çerçevenin cihazı. Tarayıcıda tam sayfa `/dev`de pay yoktur.',
-            '`edges`: all (dört kenar) · top · bottom · vertical. Tasarım kanvası ve önizleme payı KENDİLİĞİNDEN BIRAKMAZ; mobil sayfanın kökü genellikle `safe-area` (ya da içinde `app-bar`) olmalıdır.',
-            'Varsayılan sütun + `stretch` ve kenara yaslı: boşluk tipi yazılmamışsa dış/iç boşluk `none` sayılır (`safe-area`, `scroll-view`, `app-bar` — açıkça seçilen değer uygulanır).'
-        ]
-    },
-    'scroll-view': {
-        summary: 'Kaydırılabilir kap; uzun içeriği kaydıran açık bir karardır.',
-        differences: [
-            'Web`de karşılığı YOKTUR — mobil ekran kendiliğinden kaymaz; `heightType: fill` ile ekranın kalanını kaplatın.',
-            '`horizontal` yatay kaydırır; yerleşim alanları içerik kabına uygulanır. Sona varınca `scrollEnd` yayılır.',
-            '`refreshable` YALNIZ dikey kaydırmada ve yalnız runtime kipinde çekerek yenileyi açar (`refresh` olayı); tasarım kanvasında jest çizilmez. Barındırıcı (Expo) kendi çekerek yenilesini bu durumda KAPATIR, yoksa iki gösterge üst üste biner.',
-            '`stickyHeader` (FlutterFlow StickyHeader) İLK çocuğu kaydırırken üstte tutar — tasarım kanvasında da; yalnız dikey kaydırmada (RN `stickyHeaderIndices`), `horizontal` açıkken yok sayılır ve panel alanı gizler.'
-        ],
-        propNotes: {
-            refreshable: 'Çekerek yenile; akış bir söz döndürürse gösterge onu bekler, döndürmezse 600 ms döner.',
-            stickyHeader: 'İlk çocuk yapışır: başlık olacak kabı ilk sıraya koyun ve ona kendi zeminini verin — yapışan kap saydamsa altından akan içerik görünür.'
-        }
-    },
-    text: {
-        summary: 'Metin; punto temanın tip ölçeğinden gelir.',
-        differences: [
-            '`wordBreak` düşer: React Native metni `numberOfLines`/`ellipsizeMode` ile sınırlar, CSS kırma kuralının karşılığı yoktur.',
-            "Seviyenin mobil karşılığı varsa (`--ng-font-size-<seviye>-mobile`) o kullanılır; metin stili ATA KAPTAN MİRAS ALINMAZ (RN'de miras yoktur), kabuk tipografiyi bağlama yazar."
-        ]
-    },
-    button: {
-        summary: "Tıklama kaynağı; shadcn `Button` ilkeli. `kind` semantik rengi, `variant` o rengin kullanımını seçer; mobil kırılım shadcn'in `secondary`/`ghost`/`link` varyantlarını ve `icon` boyunu ekler (web şeması değişmez).",
-        differences: [
-            '`isNewTabLink` düşer: mobilde sekme yoktur, bağlantı sistem tarayıcısına ya da derin bağlantıya gider (F5/F6).',
-            '`isLoading` açıkken metnin yanında `ActivityIndicator` döner.',
-            "`icon`, `iconPosition`, `badgeValue` ve `badgeColor` şemada durur ama mobil çizer bugün ÇİZMEZ: düğmede yalnız etiket ve yükleniyor göstergesi vardır.",
-            "Etiketin rengi düğmenin kendi kararıdır (`kind`/`variant` kontrastı): ata kabın `typographyStyle.color`ı etikete İNMEZ, punto da temanın form ölçüsünden gelir; aile ve kalınlık gibi öteki tipografi alanları iner."
-        ],
-        propNotes: {
-            variant: "shadcn varyantına çevrilir: `solid` → `default` (`kind: error` iken `destructive`) · `outline` → `outline` (`--background` zemin, `--border` kenar) · `text` (web'in adı) ve `ghost` → `ghost` (zeminsiz) · `secondary` → `secondary` (nötr `--secondary` dolgu) · `link` → `link` (zeminsiz, etiket `--primary`). `secondary`, `ghost` ve `link` YALNIZ mobil şemada seçenektir.",
-            kind: "Rengin nerede göründüğü varyanta bağlıdır. `solid`: zemin `primary` → `--primary`, `error` → `--destructive`, `info`/`success`/`warning` → `--status-*`. `outline`: `primary` NÖTR kalır (`--border` kenar, ön plan rengi etiket), `error` ve durum renkleri kenarı ve etiketi boyar. `text`: `primary` nötr ön plan etiketi, `error` ve durum renkleri etiketi boyar (`ghost` `primary`/`error`'da aynı). `secondary`: nötr dolgu, `error` etiketi `--destructive` yapar. `link`: etiket `--primary`, `error` iken `--destructive`. BİLİNEN HATA: `info`/`success`/`warning` `ghost`, `secondary` ya da `link` ile verilirse zemin de etiket de aynı durum rengine boyanır ve etiket okunmaz — bu üç varyantta `kind`'ı `primary` ya da `error` bırakın.",
-            size: "`sm` → shadcn `sm`, `md` → `default`, `lg` → `lg`, boş (`''`) temanın varsayılanı (`--ng-form-default-size`); bu kademelerde yükseklik, punto ve yatay iç boşluk sınıftan değil temanın `--ng-form-height-*`/`--ng-form-font-size-*`/`--ng-form-padding-x-*` değişkenlerinden gelir. `icon` (yalnız mobil) için temada `--ng-form-*-icon` değişkeni YOKTUR: satır içi yükseklik tanımsız kalır, iç boşluk `spacing.md`'ye, punto taban puntoya düşer ve düğme ikon da çizmez — bu kademe bugün kullanışlı değildir."
-        }
-    },
-    form: {
-        summary: 'Alanları taşıyan kap; yerleşim sözleşmesi `container` ile aynıdır.',
-        differences: [
-            '`layout` düşer (flex-only).',
-            'Doğrulama ve `submit` akışı F5 runtime fazında bağlanır; tasarım kipinde form yalnız alanları dizer.'
-        ]
-    },
-    'form-validation-errors': {
-        summary: 'Formun topladığı hataların listesi; renk temanın hata renginden gelir.',
-        differences: [
-            'Satır metni `label` + `message` birleşiminden çıkar; düz metin dizisi de kabul edilir.',
-            'Başlık `hideFormValidationMessage` ile gizlenir; liste ve başlık ikisi de boşsa komponent HİÇ çizilmez (web kutuyu boş çizer).'
-        ]
-    },
-    textinput: {
-        summary: 'Tek satırlık metin alanı; etiket/açıklama/hata kabuğu bütün alanlarda ortaktır.',
-        differences: [
-            '`inputMask` düşer: web maskesi DOM olayına bağlıdır, mobil karşılığı (klavye tipi + biçimleyici) Faz 3.',
-            '`clearable` düşer: temizleme düğmesi Dalga 1b`in `icon` komponentini bekliyor.',
-            'Sayaç kuralı web ile aynı: yalnız `showCounter` açık VE `maxChars` > 0 iken çizilir.'
-        ]
-    },
-    textarea: {
-        summary: 'Çok satırlı metin alanı.',
-        differences: [
-            'Yükseklik satır sayısından hesaplanır (`lines`, `minLines`, `maxLines`): React Native `TextInput` satır sayısını kendi ölçmez, yükseklik açıkça verilmelidir.'
-        ]
-    },
-    numberinput: {
-        summary: 'Sayısal klavye açan alan; değer `Intl.NumberFormat` ile biçimlenir.',
-        differences: [
-            'Klavye `allowDemicalPoints` açıkken `decimal-pad`, kapalıyken `number-pad`. Yazılan değer ayrıştırılabildiği anda `minValue`/`maxValue` aralığına kırpılarak yazılır.',
-            'Web alanı artı/eksi düğmelerini HEP çizer; mobilde düz alan varsayılandır. Düğmeler `variant: stepper` ile gelir — YALNIZ mobil şemada (web şeması değişmez; FlutterFlow Count Controller): alanın iki yanında `-`/`+` (shadcn `outline` `icon`), alana elle yazmak açık kalır; web gibi salt okunur ve görüntüleme kipinde çizilmez, yüklenirken pasiftir. İç roller `<elementId>__decrement` / `<elementId>__increment` — `page_screenshot` `click` onlarla basar.'
-        ],
-        propNotes: {
-            variant: "`input` (varsayılan) düz alan; `stepper` ± düğmeli. Basış web `stepBy` gibi değeri `step` kadar değiştirir ve sırayla `change` ile `changed` yayar (`{ value }`): boş değer 0'dan başlar, `step` yoksa ya da pozitif değilse 1; sonuç ve adım alanın GÖSTERDİĞİ basamağa oturur (tam sayı alanında adım en az 1, ondalıkta `decimalPlaces`), yani saklanan değer ekrandakiyle aynıdır; `minValue`/`maxValue`'ya kırpılır. Web kuralıyla `+` yalnız değer üst sınırın altındayken, `-` alt sınırın üstündeyken basılır (aralık dışındaki değerde ters yöne götüren düğme pasif); tasarım kipinde basılamaz."
-        }
-    },
-    password: {
-        summary: 'Gizli metin alanı; göster/gizle düğmesi alanın içindedir.',
-        differences: [
-            "`autofill` düşer: tarayıcının `autocomplete` sözlüğüdür, mobil karşılığı `textContentType`/`autoComplete` (Faz 3).",
-            'Göster/gizle düğmesi şimdilik METİNDİR (`Show`/`Hide`); `icon` Dalga 1b`de inince ikona döner. Kimliği `<elementId>__reveal` — `page_screenshot` `click` onunla basar.'
-        ]
-    },
-    checkbox: {
-        summary: 'Onay kutusu; shadcn `Checkbox` ilkeli (`@rn-primitives/checkbox`), işaret Material Symbols glifidir. Kutu ölçüsü temanın form puntosundan çıkar.',
-        differences: [
-            '`isIndeterminate` `value`yu bastırır ve tire (`remove` glifi) çizer; belirsiz kutuya dokunmak onu seçili yapar.',
-            'Etikete dokunmak da kutuyu çevirir (basış satırın `Pressable`ında toplanır).',
-            '`labelPosition` yalnız `left`/`right`; `left` seçilince etiket ile kutu satırın iki ucuna yaslanır.'
-        ]
-    },
-    switch: {
-        summary: 'Açma/kapama anahtarı; shadcn `Switch` ilkeli (`@rn-primitives/switch`) — üç barındırıcıda AYNI görünüm.',
-        differences: [
-            'Platformun kendi anahtarı (iOS/Android `Switch`) KULLANILMAZ: açıkken zemin `--primary`, kapalıyken `--input`, baş `--background`; kanvas, önizleme ve cihaz aynı bileşeni çizer.',
-            '`isReadonly` ve `isDisabled` anahtarı kilitler ve soldurur; `isDisabled` etiketi de soldurur. Tasarım kanvasında anahtar basılamaz olduğu için HER anahtar soluk çizilir — önizlemede ve cihazda değil.'
-        ]
-    },
-    dropdown: {
-        summary: 'Seçim listesi; liste tam ekran `Modal` olarak açılır.',
-        differences: [
-            'Açılır liste kutunun altına DEĞİL, ekranın altından açılan tam ekran modala çizilir: küçük ekranda kutunun altına açılan liste klavyeyle çakışıyor.',
-            'Tetikleyici shadcn `Input` görünümündedir (`--input` kenarı; yükseklik, köşe ve punto öteki alanlarla aynı `--ng-form-*` ölçüsü); liste `--popover` yüzeyinde, seçili satırda `check` glifi. Tetikleyici `role="combobox"` taşır (iç rol `<elementId>__trigger`, temizleme düğmesi `<elementId>__clear`), seçilebilir satırlar `role="option"` + `data-value`; liste katmanda açıldığı için `page_screenshot` `select` seçeneği belgede arar ve değerle ya da görünen metinle seçer.',
-            'Seçenekler normalize edilir: düz metin dizisi, nesne dizisi ve `optionType: "grouped"` çocukları tek biçime iner; grup başlığı seçilemez, etiketi olmayan seçenek değerini gösterir.'
-        ]
-    },
-    divider: {
-        summary: 'Çizgi; etiket verilirse çizgi etiketin iki yanına bölünür.',
-        differences: [
-            "Kesikli/noktalı desen `borderStyle` ile çizilir (arka planla çizilen düz çizgide desen görünmez); kalınlık kenarlığa yazılır.",
-            'Dikey kipte çizgi kabın yüksekliğini alır (`alignSelf: stretch`).'
-        ]
-    },
-    spacer: {
-        summary: 'Boşluk; `flex` kipinde kalan alanı yer, `fixed` kipinde `size` kadar.',
-        differences: [
-            'Tasarım kipinde `showInEditor` açıkken kesikli çerçeveyle görünür olur; runtime`da iz bırakmaz (web ile aynı sözleşme).'
-        ]
-    },
-    image: {
-        summary: 'Görsel; kaynak düz URL ya da platformun dosya nesnesi olabilir.',
-        differences: [
-            'RN `Image` kullanılır (expo-image değil): paket üç barındırıcıda da aynı kodla çalışır.',
-            'Kaynak çözülemezse (boş prop, tanınmayan nesne) YER TUTUCU çizilir — boş kutu tasarımcıya "kaynak boş" demenin tek yolu.',
-            'Boyut panelinin en-boy oranı (`appearance.aspectRatio`) görselin KENDİSİNE yazılır (web`de de medya oranı kendi uygular): genişlik satırı kaplar, boy oranla gelir. Koşullar kaplarla aynı: boy `auto` ve genişlik `fill`/`fixed`; değilse (ya da oran yoksa) görsel 96 dp taban boyla çizilir.'
-        ]
-    },
-    icon: {
-        summary: 'Tek glif; Material Symbols LİGATÜRÜ olarak çizilir.',
-        differences: [
-            'Glif bir metindir: ad (`home`) yazı tipi tarafından glife çevrilir, ayrı svg seti taşınmaz. Studio sayfası yazı tipini yüklü tutar; Expo uygulaması `expo-font` ile yükler (F6).',
-            '`isSpinning` düşer: dönen ikon `Animated` döngüsü ister, v1`de animasyon yok.',
-            '`isNewTabLink` düşer (button ile aynı gerekçe).'
-        ]
-    },
-    card: {
-        summary: 'Görsel + başlık + açıklama + düğme.',
-        differences: [
-            '`imageFit` RN `resizeMode`a çevrilir: cover→cover, contain→contain, fill→stretch, none→center.',
-            'Kartın TAMAMI dokunulabilir ve tek `click` yayar (web ile aynı: düğmenin kendi olayı yoktur); liste satırına dokunmak repeater şablonundaki kartın `click`idir. Kart çocuk ALMAZ — satırın alanlarını `title`/`description` kod bağıyla (`{ type: \'code\', ref: \'{{ item.alan }}\' }`) verin.'
-        ]
-    },
-    emptystate: {
-        summary: 'Liste boşken çizilen ikon + başlık + açıklama + eylemler.',
-        differences: [
-            'İkon `icon` komponentiyle aynı ligatür yolunu kullanır.',
-            'Metni olmayan eylem kaydı çizilmez; eylem kimlikleri `__action-<sıra>`.'
-        ]
-    },
-    slot: {
-        summary: 'Layout`un sayfa yuvası; runtime`da sayfanın şeması buraya enjekte edilir.',
-        differences: [
-            'Tasarım kipinde YER TUTUCU çizilir (kesikli kutu + ad): boş `View` yuvayı görünmez yapıyor, layout`ta yeri kestirilemiyordu.'
-        ]
-    },
-    repeater: {
-        summary: 'Şablon düğümlerini satır başına tekrarlar; satır kimlikleri `__row-<i>`.',
-        differences: [
-            '`FlatList` v1`de KULLANILMAZ: sanallaştırma yalnız gerçek veriyle anlamlı, tasarım kipinde ölçüm haritasını bozar (kaplama görünmeyen satırın kutusunu bulamaz).',
-            'Tasarım kipinde şablon BİR kez çizilir. Runtime`da her satır web ile AYNI makine parametresiyle (`index`, `row`, `repeaterId`) çizilir: bağlı prop`lar ve akışlar `Row` / `RowIndex` okur; satır yoksa hiçbir şey çizilmez (web ile aynı).',
-            'Satırdaki bir düğümün olayı ÖNCE tekrarlayıcıya `change { selectedIndex }` yazar (aynı satırsa yazmaz), sonra kendi akışını koşar (web sırası): akışta tıklanan satır `<tekrarlayıcı>.selectedItem`dır. `item`/`Row`/`RowIndex` yalnız prop BAĞLARINDA satırdır; akış ifadesinde tanımsız döner (ölçüldü 2026-09-19).',
-            '`columnCount` > 1 iken satırlar yüzde genişlikle sarılır (RN`de CSS grid yok).',
-            '`swipeActions` ve `itemPressable` MOBİLE ÖZGÜDÜR (webde yok). Jest RN `Animated` + `PanResponder` ile kurulur — paket v1`de `reanimated`/`gesture-handler` yok — ve yalnız YATAY harekette yakalanır, böylece dikey kaydırma kaba kalır. Tasarım kipinde satırlar şablon olarak çizildiği için jest hiç bağlanmaz.',
-            '`swipe` ve `itemPress` yükleri satırı `row` alanında TAŞIR; akış ifadesindeki `Row`/`RowIndex` bağı ayrı bir konudur (ARC-080).'
-        ],
-        propNotes: {
-            itemPressable: 'Satıra dokunulabilir yapar; dokunuş önce `change { selectedIndex }`, sonra `itemPress` yayar.',
-            swipeActions: 'Sola kaydırınca açılan eylemler: `key` (zorunlu), `label`, `tone` (default · danger), `icon`. Her eylem 72 pt genişliktedir.'
-        }
-    },
-    modal: {
-        summary: 'Widget kökü; sayfa akışının dışında, üstte açılan katman.',
-        differences: [
-            'RN `Modal` kullanılır; genişlik web kademelerinden ekran ORANINA çevrilir (small 0.75 · medium 0.85 · large 0.95).',
-            'Görünüm temanın shadcn token`larından: perde `--overlay` yarı saydam, gövde `--background` zemin + `--border` kenar + büyük köşe + gölge. Açılış, kapanış ve olaylar değişmedi.',
-            'Gövdenin kapatma (×) düğmesinin iç rol kimliği `<elementId>__overlay` (adı tarihsel; `isDismissDisabled` açıkken çizilmez) — `page_screenshot` `click` onunla kapatır.',
-            'Tasarım kipinde HER ZAMAN açık ve YERİNDE (sayfa akışında) çizilir: kapalı bir widget`ın içi düzenlenemez; RN `Modal` react-native-web`de sayfanın tamamını kaplayan bir portal açtığı için kanvasta kullanılmaz.',
-            '`presentation` YALNIZ mobil şemadadır (web şeması değişmez; FlutterFlow BottomSheet): `center` ortadaki kutu, `sheet` alt sayfa, `fullscreen` tam ekran. Tasarım kipinde üçü de yerinde, kendi görünümüyle çizilir.'
-        ],
-        propNotes: {
-            presentation: "`center` (varsayılan; kayıtlı modallar böyle kalır) web ile aynı kutu, genişlik `size`dan. `sheet`: ekranın altına yapışık, tam genişlik, üst köşeleri yuvarlak ve tutamaçlı; cihazda alttan kayarak açılır. Tutamaç + başlık şeridinden aşağı sürükleyince — boyunun üçte biri ya da hızlı savurma — `change { isOpen: false }` ile kapanır; `isDismissDisabled` açıkken yerine döner. İçerik kendi kaydırmasını korur (sürükleme yalnız şeritte); alt sayfa en çok ekranın %90'ıdır, uzun içerik kesilir — kaydırmak için içine `scroll-view` koyun. Kapanış isteği tutmazsa (bir bağ `isOpen`'ı geri yazarsa) sayfa 300 ms sonra yerine döner. `fullscreen`: perdesiz tam ekran, çentik ve ev göstergesi payı dolguda; cihazda kayarak açılır. `size` yalnız `center`da anlamlıdır, panel diğer ikisinde gizler."
-        }
-    },
-    drawer: {
-        summary: 'Mobil ÇEKMECE (D14): expo-router Drawer navigator`ı yerine widget.',
-        differences: [
-            'RN `Modal` + kenara yaslı panel; kenardan kaydırma ve yumuşak geçiş Faz 3 (reanimated/gesture-handler v1`de paket bağımlılığı değil).',
-            'Görünüm temanın shadcn token`larından: perde `--overlay` yarı saydam, panel `--background` zemin + iç kenarda `--border` çizgisi + gölge.',
-            '`size` kademeleri ekran oranına iner (default 0.72 … full 1); `position` yalnız left/right.',
-            'Kaplamaya dokunuş kapatır (`__overlay` iç rolü), `isDismissDisabled` açıkken dokunuş yutulur.',
-            '`app-bar.menuTarget` bu widget`ı açar (`host.shell.openMenu` → makinede `isOpen: true`); kapanış `change { isOpen: false }` yazar, geçişte `open`/`close` yayılır.',
-            'Tasarım kipinde yerinde çizilir (modal ile aynı gerekçe).'
-        ]
-    },
-    'app-bar': {
-        summary: 'Ekranın üst çubuğu: başlık, sol uç (geri ya da çekmece menüsü) ve sağ eylemler.',
-        differences: [
-            'Web`de karşılığı YOKTUR — mobile özgü şema (web `header` sayfa akışının parçasıdır, bu ekranın kabuğudur).',
-            '`leading: auto` runtime`da `host.shell.canGoBack`tan çözülür: geri gidilebiliyorsa geri, gidilemiyorsa `menuTarget` varsa menü, yoksa boş. Tasarım kipinde çubuk boş kalmasın diye menü/geri çizilir.',
-            'İç roller `__back`, `__menu`, `__action-<key>` (K2 kalıbı); `page_screenshot` eylemleri bunları kullanır.',
-            'Üst güvenli alan payı çubuğun işi DEĞİLDİR: düz kanvas kararından (D15) sonra payı kullanıcı `SafeAreaView` ile kurar.'
-        ]
-    },
-    badge: {
-        summary: 'Sayaç ya da durum rozeti; taşma (99+) ve nokta kipi var.',
-        differences: [
-            '`isPulsing` DÜŞÜRÜLDÜ: nabız animasyonu web CSS keyframe`idir, mobilde karşılığı yoktur.',
-            'İkon İSTEĞE BAĞLIDIR ve verilmediğinde ÇİZİLMEZ — ortak ikon çözücü boş prop`ta `star`a düştüğü için bu slug prop`un gerçekten verilip verilmediğine kendisi bakar.'
-        ],
-        propNotes: {
-            color: 'Renk SINIFTAN gelir (`bg-status-*`); `custom` seçilirse `customColor` ham renktir.',
-            maxCount: 'Aşıldığında metin `<maxCount>+` olur (99 → `99+`). Web ikiziyle aynı beş altın vaka `badge-logic.spec.ts`te kilitli.'
-        }
-    },
-    avatar: {
-        summary: 'Kullanıcı avatarı: görsel, baş harf yedeği ve `+N` grup kipi.',
-        differences: [
-            'Grup kipinde üst üste binme `spacing` ile negatif kenar boşluğundan çizilir; web`in `z-index` katmanı yerine çizim SIRASI belirler.'
-        ]
-    },
-    progress: {
-        summary: 'Çubuk ilerleme göstergesi; eşiklere göre renk değiştirir.',
-        differences: [
-            '`variant` (dairesel), `isStriped` ve `isIndeterminate` DÜŞÜRÜLDÜ: üçü de CSS animasyonu ya da `conic-gradient` ister.',
-            'Kutu satırın tamamını kaplar (`width: 12`).'
-        ]
-    },
-    radio: {
-        summary: 'Tek seçimli seçenek listesi.',
-        differences: [
-            '`autofocus` DÜŞÜRÜLDÜ: mobilde odak kavramı yoktur.',
-            'Seçenekler HER ZAMAN alt alta çizilir — dokunma hedefi korunur.',
-            'Seçeneğin iç rol kimliği `<elementId>__option-<değer>` (runtime\'da `data-element-id`) — `page_screenshot` `click` seçeneğe onunla basar.'
-        ]
-    },
-    checkboxgroup: {
-        summary: 'Seçili değerleri bir liste oluşturan onay kutusu grubu.',
-        differences: [
-            '`autofocus` ve `columnCount` DÜŞÜRÜLDÜ: çok sütun telefon genişliğinde dokunma hedefini bozar; yerine `direction: horizontal` sarmalı kullanılır.',
-            'Kutu satırın tamamını kaplar (`width: 12`).',
-            'İç roller `<elementId>__option-<değer>` ve (`showSelectAll` açıkken) `<elementId>__select-all` — `page_screenshot` `click` onlarla basar.'
-        ]
-    },
-    'choice-chips': {
-        summary: 'Dokunma için boyutlandırılmış, satır sarmalı seçilebilir çip dizisi. Web`de karşılığı YOKTUR.',
-        differences: [
-            'Mobile özgü şema: web`de bu işi `checkboxgroup`/`radio` görür; dokunmatikte çip dizisi daha az yer kaplar.',
-            '`multiple` açıkken `value` virgülle ayrılmış listedir, kapalıyken tek değer.',
-            'İkon İSTEĞE BAĞLIDIR ve verilmediğinde çizilmez (`badge` ile aynı gerekçe).',
-            'Çipin iç rol kimliği `<elementId>__chip-<değer>` — `page_screenshot` `click` çipe onunla basar.'
-        ]
-    },
-    'collapsible-container': {
-        summary: 'Başlığa dokununca açılıp kapanan kap; çocuklar gövdeye iner.',
-        differences: [
-            'Bırakılabilir bir KAPTIR (`isDroppable`), gövdesi çocuklardır.',
-            'Açılma animasyonu YOKTUR: yükseklik anında değişir (düzen animasyonu bu dalgada kullanılmadı).',
-            'Başlığa basmak web ile AYNI olayı yayar (`expanded`/`collapsed { isOpen }`); makine `isOpen`\'ı yazar ve gövde açılıp kapanır. Tetikleyicinin iç rol kimliği `<elementId>__trigger` — `page_screenshot` `click` onunla basar.'
-        ]
-    },
-    slider: {
-        summary: 'En küçük ve en büyük değer arasında sayısal kaydırıcı.',
-        differences: [
-            '`marks`, `showTicks` ve `autofocus` DÜŞÜRÜLDÜ.',
-            'Jest `PanResponder` ile çözülür ve YALNIZ YATAY sürüklemeyi yakalar: dokunuşu başlangıçta yakalasaydı sayfa kaydırması değeri değiştirirdi (ölçüldü — kaydırma 40`ı 100 yapıyordu).',
-            'Sürüklerken `change`, parmak kalkınca `changed` yayılır; akış genelde `changed`e bağlanır.'
-        ]
-    },
-    tabs: {
-        summary: 'Başlıkların altında içerik gösteren sekme kabı.',
-        differences: [
-            'İçerik modeli web ile AYNI: her sekmenin gövdesi SIRADAKİ çocuk düğümdür — etkin sekmenin (`selected` anahtarı) `tabs` dizisindeki sırası hangi çocuğun çizileceğini seçer; gizli/pasif sekme sırayı kaydırmaz.',
-            'Basılan sekme web ile AYNI olayı yayar (`tab { selected }`); makine `selected`\'ı yazar ve gövde değişir. Sekmenin iç rol kimliği `<elementId>__tab-<anahtar>` (runtime\'da `data-element-id`) — `page_screenshot` `tab` onu anahtarla bulur.',
-            'Sekme başlıkları taşarsa yatay kaydırılır; telefonda sarmalanmaz.'
-        ]
-    },
-    tooltip: {
-        summary: 'DOKUNUŞLA açılan ipucu balonu; çocuklar tetikleyicidir. Web`de karşılığı YOKTUR.',
-        differences: [
-            'Web`de ipucu hover ile açılır; dokunmatikte hover yoktur (MOB-002), bu yüzden jest DOKUNUŞTUR — ikinci dokunuş kapatır, dışarı dokunmak da kapatır.',
-            'Bırakılabilir bir KAPTIR: tetikleyici çocuklarıdır, yani her şeye (düğme, ikon, kart) ipucu takılabilir.',
-            'TASARIM KİPİNDE BALON ÇİZİLMEZ: kanvasta açık balon ölçümü ve seçim kutusunu kaydırırdı. Tasarımcı metni panelden düzenler.',
-            'Balon sayfa ağacının DIŞINA, barındırıcının katmanına çizilir (`modal`/`drawer` ile aynı çerçeve) — kaydırma kabı ya da kırpan kap onu kesmesin diye.'
-        ],
-        propNotes: {
-            side: 'Balonun tetikleyiciye göre yanı. Seçilen yan ekrana sığmazsa balon ÇEVRİLMEZ, yalnız ekran içine kaydırılır.'
-        }
-    }
-};

package/dist/knowledge/mobileComponentEvents.js

@@ -1,50 +0,0 @@
-/**
- * MOBİLE ÖZGÜ olay yükleri. Mobil komponentlerin ÇOĞU web şemasını genişletir ve
- * olayları web sözleşmesindedir (`componentEvents.ts`) — bu dosya yalnız web'de
- * karşılığı OLMAYAN komponentler içindir (`app-bar` gibi kabuk komponentleri).
- *
- * Okuyucu önce buraya, sonra web sözlüğüne bakar; parity testi
- * (`test/mobile-component-parity.test.ts`) her mobil olayın iki sözlükten
- * birinde karşılanmasını zorunlu tutar.
- */
-const NO_DATA = { payload: {} };
-export const mobileComponentEventContracts = {
-    'choice-chips': {
-        change: {
-            payload: {
-                value: 'string — seçili çipin değeri. `multiple` açıkken seçili değerler virgülle ayrılmış tek dize olarak gelir.'
-            }
-        }
-    },
-    tooltip: {
-        open: NO_DATA
-    },
-    'app-bar': {
-        clickBack: NO_DATA,
-        clickMenu: NO_DATA,
-        clickAction: { payload: { key: 'string (eylemin key alanı; yoksa dizideki sırası)' } }
-    },
-    'safe-area': {
-        mount: NO_DATA
-    },
-    'scroll-view': {
-        mount: NO_DATA,
-        scrollEnd: NO_DATA,
-        refresh: NO_DATA
-    },
-    repeater: {
-        swipe: {
-            payload: {
-                key: 'string (kaydırma eyleminin key alanı)',
-                index: 'number (satırın sırası, 0 tabanlı)',
-                row: 'object (satırın verisi)'
-            }
-        },
-        itemPress: {
-            payload: {
-                index: 'number (satırın sırası, 0 tabanlı)',
-                row: 'object (satırın verisi)'
-            }
-        }
-    }
-};