@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.22

package/dist/knowledge/mobileComponentEvents.js

@@ -0,0 +1,98 @@
+/**
+ * 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
+    },
+    calendar: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string 'yyyy-MM-ddT00:00:00' | null — seçilen gün (aralıkta başlangıç); web datepicker'ın biçimi: yerel duvar saati, gece yarısı, dilim eki yok",
+                endValue: "string 'yyyy-MM-ddT00:00:00' | null — YALNIZ mode: 'range'; ilk basışta null, ikinci basışta bitiş günü"
+            }
+        }
+    },
+    stack: {
+        mount: NO_DATA
+    },
+    'list-item': {
+        click: NO_DATA
+    },
+    fab: {
+        click: NO_DATA
+    },
+    timer: {
+        mount: NO_DATA,
+        tick: { payload: { value: 'number — gösterilen saniye (geri sayımda kalan, kronometrede geçen); makine value prop\'una yazar' } },
+        finish: { payload: { isRunning: 'false — geri sayım 0\'a indi; makine isRunning\'i kapatır' } }
+    },
+    audio: {
+        mount: NO_DATA,
+        play: { payload: { isPlaying: "true — çalma başladı (denetim ya da akış); makine isPlaying'i yazar" } },
+        pause: { payload: { isPlaying: "false — çalma durdu (denetim, akış, bitiş ya da tarayıcının otomatik oynatma reddi); makine isPlaying'i yazar" } },
+        ended: { payload: { isPlaying: "false — ses sona vardı (loop kapalıyken, pause'tan sonra); makine isPlaying'i kapatır" } }
+    },
+    lottie: {
+        mount: NO_DATA,
+        finish: { payload: { isPlaying: "false — döngüsüz animasyon bitti; makine isPlaying'i kapatır, yeniden true yazmak baştan oynatır" } }
+    },
+    webview: {
+        mount: NO_DATA,
+        load: { payload: {}, reads: "her tamamlanan yüklemede yayılır (izin verilen gezinmeden sonra da); cihazda yüklenemeyen sayfada yayılmaz (yerine error), web'de tarayıcı engellenen çerçevede de yayar" },
+        navigate: { payload: { url: "string — sayfanın gitmek istediği adres; makine url prop'una yazar (self.url). allowNavigation kapalıyken (varsayılan) gezinme engellenir; adres yalnız kullanıcının dokunduğu bağlantıda sistemde açılır" } },
+        message: { payload: { data: "string — sayfanın window.ReactNativeWebView.postMessage(metin) ile yolladığı metin, olduğu gibi; makine data prop'una yazar (self.data)" } },
+        error: { payload: {}, reads: "cihazda sayfa yüklenemeyince (ağ hatası) yayılır, görünüm yer tutucu çizer; web'de pratikte gelmez (iframe gibi)" }
+    },
+    markdown: {
+        mount: NO_DATA,
+        linkClick: {
+            payload: {
+                href: "string — dokunulan bağlantının ham adresi; şema süzülmeden gelir (dışarıda yalnız http(s), mailto, tel açılır)"
+            }
+        }
+    },
+    '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)'
+            }
+        }
+    }
+};

package/dist/knowledge/normalize.js

@@ -2,6 +2,7 @@ import { logStep } from '../observability/trace.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { ensureWorkflowErrorPath } from './errorPath.js';
 import { TYPED_STYLE_COMPONENTS } from './styleResolve.js';
+import { STEP_ALIASES } from './platform/profile.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
 function asArray(value) {
@@ -269,12 +270,11 @@ export function normalizeWorkflowDefinition(definition) {
  */
 /**
  * Adım tipi sözlüğü backend'in, KOŞAN tipler barındırıcının: motor yedi tip register eder, web
- * `Runtime.svelte` altı, mobil `ScreenRuntime.tsx` beş tip ekler ve aynı sayfa kaydı ikisinde de
+ * `Runtime.svelte` altı, mobil `runtime-tasks.ts` yedi tip ekler ve aynı sayfa kaydı ikisinde de
  * koşar. Register edilmemiş bir tipe gelen akış sessizce ölür (`flow-engine.ts` `process()`
  * callback bulamazsa next/completed/stopped hiç çağrılmaz), üstelik `run()` promise'i
  * çözülmediği için `__ngAppsFlowActivity.running` sıfıra inmez. İki hâl tamamen türetilebilir
- * olduğu için lint değil NORMALİZASYON — kalanı (`confirm`/`download` mobilde yok) yalnız
- * uygulama tarafında kapanabilir, `FLOW-023` onları uyarır.
+ * olduğu için lint değil NORMALİZASYON; `FLOW-023` kalan hâlleri uyarır.
  */
 function normalizeFlowHostGaps(steps, list) {
     const fixes = [];
@@ -288,12 +288,15 @@ function normalizeFlowHostGaps(steps, list) {
         .map(step => String(step.stepId ?? ''))
         .filter(id => id.length > 0));
     for (const step of list) {
-        // navigate ile redirect'in argümanı AYNI ({ path, pageId, query, targetBlank }) ama navigate'i
-        // yalnız mobil register eder; redirect ise iki barındırıcıda da koşar (mobilde aynı navigate
-        // uygulamasına eşlenir), yani redirect kesin üstün.
-        if (step.type === 'navigate') {
-            step.type = 'redirect';
-            fixes.push(`'${label(step)}': type navigate → redirect yazıldı — argüman şekli aynı ({ path, pageId, query, targetBlank }) ama navigate'i web barındırıcısı register etmez, redirect ikisinde de koşar`);
+        // navigate ile redirect'in argümanı AYNI ({ path, pageId, query, targetBlank, presentation })
+        // ama navigate'i yalnız mobil register eder; redirect ise iki barındırıcıda da koşar (mobilde
+        // aynı navigate uygulamasına eşlenir), yani redirect kesin üstün. `presentation`
+        // (push | modal | replace) yalnız mobil barındırıcıda okunur; web yok sayar.
+        const alias = STEP_ALIASES[String(step.type ?? '')];
+        if (alias) {
+            const original = String(step.type);
+            step.type = alias;
+            fixes.push(`'${label(step)}': type ${original} → ${alias} yazıldı — argüman şekli aynı ({ path, pageId, query, targetBlank, presentation }) ama ${original}'i web barındırıcısı register etmez, ${alias} ikisinde de koşar`);
         }
         if (endStepIds.size === 0)
             continue;
@@ -650,6 +653,44 @@ export function styleKeyNote(fixed) {
             + 'değer kaydedilir ama hiç uygulanmaz ve tek işareti tarayıcı konsoludur (F-06). '
             + "Seçici anahtarlara ('&__body', ':hover', '--token') dokunulmadı."];
 }
+/**
+ * Kabın `states.isDroppable`ı KATALOĞUN kararıdır. Gateway düğümü kurarken bu alanı
+ * yazmıyordu (`DEFAULT_STATES` hepsini `false` bırakır) ve Studio kanvası düğümü kap saymıyordu:
+ * imleç `scroll-view`un İÇİNDEYKEN bırakma planı sayfa kabına düşüyor, çizgi kabın üst kenarına
+ * çiziliyordu (ölçüldü 2026-09-21, `test/mobile app` › `Satislar`). Aynı tipi paletten ekleyen
+ * Studio katalog değerini yazdığı için tek şemada iki türlü davranan kap oluyordu.
+ *
+ * Değer uygulamanın KENDİ sözlüğünden gelir (`listComponents`; mobil uygulamada `type=mobile`
+ * satırları), yani kural platformdan bağımsızdır ve kuruluşun kendi komponentlerini de kapsar.
+ * Yalnız `true` yazılır: katalog bir tipi kap saymıyorsa düğüme dokunulmaz.
+ */
+export function normalizeDroppableStates(nodes, droppable) {
+    const fixed = [];
+    if (droppable.size === 0)
+        return fixed;
+    for (const node of asObjects(nodes)) {
+        const type = typeof node.type === 'string' ? node.type : '';
+        if (droppable.get(type) === true) {
+            // `states` normalde `normalizeComponentDefaults`tan geçmiş olur; gelmediyse burada da
+            // eksiksiz kurulur — yarım `states` platformda NullReference üretir.
+            if (!node.states || typeof node.states !== 'object' || Array.isArray(node.states)) {
+                node.states = { ...DEFAULT_STATES };
+            }
+            const states = node.states;
+            if (states.isDroppable !== true) {
+                states.isDroppable = true;
+                fixed.push(`'${String(node.elementId ?? node.name ?? type)}' (${type})`);
+            }
+        }
+        fixed.push(...normalizeDroppableStates(node.children, droppable));
+    }
+    return fixed;
+}
+export function droppableStatesNote(fixed) {
+    return fixed.length === 0
+        ? []
+        : [`states.isDroppable katalogdan yazıldı (${fixed.join(' · ')}) — kataloğun kap saydığı düğüm Studio kanvasında da kap olmalı; alanı bilerek kapatmak için resize_component/set_states kullanın`];
+}
 export function normalizeComponentDefaults(nodes) {
     const fixed = [];
     for (const node of asObjects(nodes)) {
@@ -884,11 +925,11 @@ export function pageContainerNode() {
  * çekilirlerse sayfa içeriğinin akışına girer ve katman olarak açılmazlar.
  */
 const ROOT_LAYER_TYPES = new Set(['modal', 'drawer']);
-export function ensurePageContainer(schema) {
+export function ensurePageContainer(schema, rootContainer = pageContainerNode) {
     const nodes = asObjects(schema);
     if (nodes.some(node => node.elementId === PAGE_CONTAINER_ELEMENT_ID))
         return { schema: nodes, fixes: [] };
-    const container = pageContainerNode();
+    const container = rootContainer();
     const layers = nodes.filter(node => ROOT_LAYER_TYPES.has(String(node.type ?? '')));
     container.children = nodes.filter(node => !ROOT_LAYER_TYPES.has(String(node.type ?? '')));
     const moved = container.children.length;

package/dist/knowledge/platform/lint.js

@@ -0,0 +1,205 @@
+import { MOBILE_RULES, REDIRECT_PRESENTATIONS, missingComponentAdvice, styleReplacement } from './mobileRules.js';
+import { findingLine } from './profile.js';
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function walk(value, visit) {
+    if (!Array.isArray(value)) {
+        const single = asRecord(value);
+        if (single)
+            walk([single], visit);
+        return;
+    }
+    for (const entry of value) {
+        const node = asRecord(entry);
+        if (!node)
+            continue;
+        visit(node);
+        walk(node.children, visit);
+    }
+}
+function propValue(value) {
+    const wrapped = asRecord(value);
+    return wrapped && 'data' in wrapped && typeof wrapped.type === 'string' ? wrapped.data : value;
+}
+function label(node) {
+    return String(node.elementId ?? node.name ?? node.type ?? '?');
+}
+const GRID_LAYOUTS = new Set(['grid', 'cssgrid']);
+const RELATIVE_UNIT = /\b\d*\.?\d+(em|rem)\b|calc\(/i;
+/**
+ * Profilin taşınabilirlik bulguları. Web profilinde HER ZAMAN boş dizi döner — web davranışı
+ * değişmez (G1 kilidi); bulgular yalnız mobil profilde üretilir.
+ */
+export function profileFindings(profile, input) {
+    if (profile.platform === 'web')
+        return [];
+    const findings = [];
+    const nodes = [];
+    const blockNodes = [];
+    const gridNodes = [];
+    const styleHits = new Map();
+    const unknownTypes = new Map();
+    const shellNodes = new Map();
+    const legacyNodes = [];
+    const hit = (map, key, target) => map.set(key, [...(map.get(key) ?? []), target]);
+    const inspectAppearance = (target, appearance) => {
+        if (!appearance)
+            return;
+        for (const key of profile.appearance.ignoredKeys) {
+            const value = appearance[key];
+            if (value !== undefined && value !== null && value !== '' && value !== 0)
+                hit(styleHits, key, target);
+        }
+        for (const key of ['widthString', 'heightString']) {
+            const value = appearance[key];
+            if (typeof value === 'string' && RELATIVE_UNIT.test(value))
+                hit(styleHits, `${key} (${value})`, target);
+        }
+    };
+    const inspectNode = (node) => {
+        const target = label(node);
+        const type = String(node.type ?? '');
+        const props = asRecord(node.props) ?? {};
+        nodes.push(node);
+        if (Array.isArray(node.blocks) && node.blocks.length > 0 && !profile.layout.blocksMeaningful)
+            blockNodes.push(target);
+        const layout = propValue(props.layout);
+        if (typeof layout === 'string' && GRID_LAYOUTS.has(layout))
+            gridNodes.push(`${target} (layout:${layout})`);
+        inspectAppearance(target, asRecord(node.appearance));
+        if (!profile.style.freeStyle) {
+            const style = propValue(props.style);
+            if ((asRecord(style) && Object.keys(style).length > 0) || (typeof style === 'string' && style.trim() !== ''))
+                hit(styleHits, 'style', target);
+        }
+        if (!profile.style.hoverStyle) {
+            const hover = propValue(props.hoverStyle);
+            if (asRecord(hover) && Object.keys(hover).length > 0)
+                hit(styleHits, 'hoverStyle', target);
+        }
+        if (type && input.catalog && input.catalog.size > 0 && !input.catalog.has(type) && !profile.shell.legacyShellNodes.has(type))
+            hit(unknownTypes, type, target);
+        if (type && profile.shell.suggestions[type])
+            hit(shellNodes, type, target);
+        if (type && profile.shell.legacyShellNodes.has(type))
+            legacyNodes.push(`${target} (${type})`);
+    };
+    walk(input.nodes, inspectNode);
+    for (const op of input.ops ?? []) {
+        const target = typeof op.target === 'string' ? op.target : '?';
+        if (op.op === 'add_component')
+            walk(op.component, inspectNode);
+        if (op.op === 'set_block' && !profile.layout.blocksMeaningful)
+            blockNodes.push(`${target} (set_block)`);
+        if (op.op === 'set_appearance')
+            inspectAppearance(target, asRecord(op.appearance));
+        if (op.op === 'replace_prop' || op.op === 'set_binding') {
+            const prop = String(op.prop ?? '');
+            const value = propValue(op.value);
+            if (prop === 'layout' && typeof value === 'string' && GRID_LAYOUTS.has(value))
+                gridNodes.push(`${target} (layout:${value})`);
+            if (prop === 'style' && !profile.style.freeStyle)
+                hit(styleHits, 'style', target);
+            if (prop === 'hoverStyle' && !profile.style.hoverStyle)
+                hit(styleHits, 'hoverStyle', target);
+        }
+    }
+    if (blockNodes.length > 0 || gridNodes.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-001'].id,
+            severity: 'warn',
+            message: [
+                blockNodes.length > 0 ? `blok (12 sütun ızgara) mobil çizerde yok sayılır: ${[...new Set(blockNodes)].join(', ')}` : '',
+                gridNodes.length > 0 ? `grid/cssgrid yerleşimi yok, kap flex çizilir: ${gridNodes.join(', ')}` : ''
+            ].filter(Boolean).join(' · ') + ". Sıra dizi indeksinden, yerleşim flex'ten gelir (direction/gap/horizontalAlign). Yazım platforma gitti.",
+            guide: "platform_guide('mobile')"
+        });
+    }
+    for (const [key, targets] of styleHits) {
+        findings.push({
+            code: MOBILE_RULES['MOB-002'].id,
+            severity: 'warn',
+            target: [...new Set(targets)].join(', '),
+            message: `'${key}' mobilde çizilmez — ${styleReplacement(key.split(' ')[0] ?? key)}. Yazım platforma gitti.`
+        });
+    }
+    for (const [type, targets] of unknownTypes) {
+        findings.push({
+            code: MOBILE_RULES['MOB-003'].id,
+            severity: 'warn',
+            target: [...new Set(targets)].join(', '),
+            message: missingComponentAdvice(type)
+        });
+    }
+    for (const [type, targets] of shellNodes) {
+        findings.push({
+            code: MOBILE_RULES['MOB-004'].id,
+            severity: 'warn',
+            target: [...new Set(targets)].join(', '),
+            message: `'${type}' web kabuğudur, mobil uygulamada karşılığı: ${profile.shell.suggestions[type]}`,
+            guide: "examples/mobile-app-shell-{tab,stack,drawer}.json"
+        });
+    }
+    if (legacyNodes.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-007'].id,
+            severity: 'warn',
+            target: legacyNodes.join(', '),
+            message: "sekme çubuğu ve çekmece menüsü katalog bileşeni değildir, çizer bu düğümleri yok sayar — sekmeler Ayarlar › Sekmeler'den (application_update properties.mobile.tabs), çekmece 'drawer' widget'ı + app-bar.menuTarget"
+        });
+    }
+    const infoSteps = new Map();
+    const badPresentation = new Map();
+    walkSteps(input.steps, step => {
+        const type = String(step.type ?? '');
+        if (profile.steps.infoOnly.has(type))
+            hit(infoSteps, type, String(step.stepId ?? step.name ?? '?'));
+        // MOB-008: sunum biçimi yalnız `redirect`te anlamlı ve kümesi kapalı.
+        // Alan YOKSA bulgu yok — varsayılan `push` ve yazımların çoğu onu yazmaz.
+        if (type !== 'redirect')
+            return;
+        const args = asRecord(step.args);
+        const presentation = args?.presentation;
+        if (presentation === undefined || presentation === null || presentation === '')
+            return;
+        if (!REDIRECT_PRESENTATIONS.has(String(presentation))) {
+            hit(badPresentation, String(presentation), String(step.stepId ?? step.name ?? '?'));
+        }
+    });
+    for (const [value, stepIds] of badPresentation) {
+        findings.push({
+            code: MOBILE_RULES['MOB-008'].id,
+            severity: 'warn',
+            target: stepIds.join(', '),
+            message: `redirect.presentation '${value}' tanınmıyor — ${[...REDIRECT_PRESENTATIONS].join(' | ')} bekleniyor. Backend doğrulayıcısı 422 döner; geçse bile çizer 'push'a düşer.`,
+            guide: "platform_guide('mobile')"
+        });
+    }
+    for (const [type, stepIds] of infoSteps) {
+        findings.push({
+            code: MOBILE_RULES['MOB-005'].id,
+            severity: 'info',
+            target: stepIds.join(', '),
+            message: type === 'download'
+                ? "mobil uygulamada 'download' dosyayı cihazın paylaşım/açma sayfasında açar (Linking.openURL) — tarayıcı indirmesi yok"
+                : "mobil uygulamada 'setcookie' çerez yazmaz, cihaz deposuna (storage, expo-sqlite/kv-store) eşlenir — okuyan ifadeler aynı çalışır"
+        });
+    }
+    return findings;
+}
+function walkSteps(value, visit) {
+    if (!Array.isArray(value))
+        return;
+    for (const entry of value) {
+        const step = asRecord(entry);
+        if (!step)
+            continue;
+        visit(step);
+        walkSteps(step.steps, visit);
+    }
+}
+/** Bulguları `layoutWarnings[]` satırlarına çevirir. */
+export function findingLines(findings) {
+    return findings.map(findingLine);
+}

package/dist/knowledge/platform/mobile.js

@@ -0,0 +1,78 @@
+import { ENGINE_STEP_TYPES, STEP_ALIASES } from './profile.js';
+import { PAGE_CONTAINER_ELEMENT_ID } from '../normalize.js';
+/**
+ * Mobil uygulamanın kök kapsayıcısı. Web'in `pageContainerNode()`'undan üç farkı var:
+ *
+ * - `layout` prop'u YOK: mobil `container` şeması onu düşürür (`@ng-apps/ui-native`
+ *   `components/container/schema.ts` `omitProps(['layout', …])`) — mobil kanvas yalnız flex akışıdır
+ *   ve backend doğrulayıcısı mobil kataloğa bakar, yazılan `layout` bilinmeyen prop olurdu.
+ * - `direction: 'column'`, `wrap: false`: telefon ekranı dikey akar; web kökü satır + sarma ile
+ *   12 sütunu taklit eder.
+ * - `blocks: []` ve `heightType: 'fill'`: çizer blokları yok sayar (D3), kök ekranı doldurur.
+ */
+export function mobileRootContainer() {
+    return {
+        elementId: PAGE_CONTAINER_ELEMENT_ID,
+        kind: 'component',
+        name: PAGE_CONTAINER_ELEMENT_ID,
+        type: 'container',
+        props: {
+            title: { type: 'static', data: '' },
+            direction: { type: 'static', data: 'column' },
+            horizontalAlign: { type: 'static', data: 'left' },
+            verticalAlign: { type: 'static', data: 'top' },
+            size: { type: 'static', data: 'grow' },
+            gap: { type: 'static', data: 'medium' },
+            wrap: { type: 'static', data: false }
+        },
+        blocks: [],
+        states: { isSticky: false, isDroppable: true, isScrollable: true, isWrapper: true },
+        appearance: { heightType: 'fill', marginValue: 0, marginType: 'none', paddingType: 'none', paddingValue: 0 },
+        events: [],
+        validations: [],
+        stateBindings: [],
+        children: []
+    };
+}
+/**
+ * Mobil profil = taşınabilir alt küme (`plans/mobil-uygulama-expo/01-mimari-tasarim.md` §5, §7).
+ * Yazım platforma YİNE gider (D3: şema aynı); alt kümenin dışı `MOB-*` bulgusu olarak uyarılır.
+ */
+export const mobileProfile = Object.freeze({
+    platform: 'mobile',
+    catalogType: 'mobile',
+    layout: {
+        modes: new Set(['flex']),
+        blocksMeaningful: false,
+        rootContainer: mobileRootContainer,
+        orderBy: 'array-index'
+    },
+    appearance: {
+        ignoredKeys: new Set(['className', 'tooltip', 'tooltipPosition', 'zIndex']),
+        sizeUnits: new Set(['px', '%'])
+    },
+    style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
+    steps: {
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download']),
+        aliases: STEP_ALIASES,
+        infoOnly: new Set(['download', 'setcookie'])
+    },
+    shell: {
+        components: new Set(['app-bar']),
+        suggestions: {
+            navigations: "sekmeler: application_update ile properties.mobile.tabs (Ayarlar › Sekmeler); üst çubuk için 'app-bar'",
+            sidebar: "çekmece: 'drawer' widget'ı + app-bar.leading:'menu' ve menuTarget",
+            header: "'app-bar' (başlık, leading: auto | none | back | menu, sağ eylemler)"
+        },
+        legacyShellNodes: new Set(['tab-bar', 'drawer-menu'])
+    },
+    externalComponents: false,
+    capture: {
+        target: 'studio-mobile',
+        devices: {
+            phone: { width: 390, height: 844, dpr: 2 },
+            tablet: { width: 820, height: 1180, dpr: 2 }
+        },
+        defaultDevice: 'phone'
+    }
+});

package/dist/knowledge/platform/mobileRules.js

@@ -0,0 +1,123 @@
+import { MOBILE_COMPONENT_NOTES, mobileComponentKnowledge } from '../mobileComponentCatalog.js';
+export const MOBILE_RULES = {
+    'MOB-001': {
+        id: 'MOB-001',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/renderer (NativeRenderer blocks okumaz; sıra dizi indeksinden)',
+        summary: 'Mobil sayfada blok (12 sütun ızgara) ya da grid/cssgrid yerleşimi — çizer yok sayar'
+    },
+    'MOB-002': {
+        id: 'MOB-002',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/style/compose-native-style.ts (yalnız tipli gruplar derlenir)',
+        summary: 'Mobil sayfada CSS-only alan (className, tooltip, zIndex, serbest style, hoverStyle, em/rem/calc ölçü)'
+    },
+    'MOB-003': {
+        id: 'MOB-003',
+        severity: 'warn',
+        sourceRef: 'zeyrek-backend PageSchemaValidator unknown-type (mobil uygulama mobil kataloğa karşı doğrulanır)',
+        summary: 'Mobil katalogda olmayan bileşen tipi — backend 422 unknown-type ile reddeder'
+    },
+    'MOB-004': {
+        id: 'MOB-004',
+        severity: 'warn',
+        sourceRef: 'plans/mobil-uygulama-expo/05-mobil-ayarlar-ve-gezinme.md §2 (D14)',
+        summary: "Mobil layout/sayfada web kabuğu (navigations, sidebar, header) — app-bar, sekmeler ayarı ve drawer widget'ı var"
+    },
+    'MOB-005': {
+        id: 'MOB-005',
+        severity: 'info',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/runtime/runtime-tasks.ts',
+        summary: "Mobil uygulamada download paylaşım/açma sayfası açar; setcookie storage'a eşlenir"
+    },
+    'MOB-006': {
+        id: 'MOB-006',
+        severity: 'warn',
+        sourceRef: 'zeyrek-backend/docs/harici-componentler (protokol v1 tarayıcı .mjs; mobil v2 Faz 3)',
+        summary: 'Harici bileşen mobil uygulamada desteklenmiyor — çağrı platforma gitmez'
+    },
+    'MOB-007': {
+        id: 'MOB-007',
+        severity: 'warn',
+        sourceRef: 'plans/mobil-uygulama-expo/05-mobil-ayarlar-ve-gezinme.md §2.2, §2.6 (K13)',
+        summary: "Sekme ayarı tutarsız ya da layout/sayfada eski tab-bar/drawer-menu düğümü"
+    },
+    'MOB-008': {
+        id: 'MOB-008',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/apps/mobile-runtime/src/navigation/navigation.ts (hrefFor); zeyrek-backend FlowDtoValidator',
+        summary: "redirect.presentation kümede değil — push | modal | replace dışı değer backend'de 422, çizer push'a düşer"
+    }
+};
+/** `redirect` adımının tanıdığı sunum biçimleri (b-01 `StepArgument.Presentation`). */
+export const REDIRECT_PRESENTATIONS = new Set(['push', 'modal', 'replace']);
+/**
+ * Bileşen dalgaları (`plans/mobil-uygulama-expo/01-mimari-tasarim.md` §11). MOB-003 bir web bileşeninin
+ * mobilde NE ZAMAN geleceğini söyler; `web-only` hiç gelmeyecekler ve karşılıkları.
+ *
+ * Mobil pakete giren bileşen Dalga 2/3 listesinden DÜŞER: yayında olduğunu mobil sözlükteki kaydı
+ * söyler (`mobileComponentKnowledge`, parite testiyle `components.json`'a kilitli). Katalog A
+ * (2026-09-24) sekiz web ikizini buradan indirdi: `radio`, `checkboxgroup`, `slider`, `tabs`, `badge`,
+ * `avatar`, `progress`, `collapsible-container`; Katalog C (09) Dalga 3'ten `video` ve `signature`ı; dil dalgası
+ * (plans/mobil-coklu-dil F1, 2026-09-25) Dalga 2'den `language-selector`ı. Dalga 1
+ * listesi artık yalnız `mobileNotes`'un bilgi satırıdır — MOB-003'te yayındaki bileşeni sözlük tanır
+ * (`box-section` Dalga 1'de ama pakette yok).
+ */
+export const MOBILE_COMPONENT_WAVES = Object.fromEntries([
+    ...['container', 'box-section', 'form', 'slot', 'text', 'icon', 'image', 'divider', 'spacer', 'button', 'textinput', 'textarea', 'numberinput', 'password', 'checkbox', 'switch', 'dropdown', 'repeater', 'card', 'emptystate', 'form-validation-errors', 'modal', 'drawer', 'app-bar'].map(slug => [slug, 1]),
+    ...['box', 'datepicker', 'timepicker', 'phoneinput', 'statcard', 'detailview', 'page-header', 'autocomplete'].map(slug => [slug, 2]),
+    ...['datatable', 'chart', 'kanban', 'timeline', 'fileUpload', 'filebutton', 'fileInput', 'texteditor', 'html', 'stepper', 'tree-view'].map(slug => [slug, 3])
+]);
+export const MOBILE_WEB_ONLY = {
+    iframe: "'webview' (src ya da html; bağlantılar varsayılan olarak sistem tarayıcısında açılır)",
+    sidebar: "'drawer' widget'ı + app-bar.menuTarget",
+    navigations: 'Ayarlar › Sekmeler (application_update properties.mobile.tabs)',
+    header: "'app-bar'",
+    'layout-shell': "tek slot'lu sıradan layout + 'app-bar'",
+    'layout-region': "tek slot'lu sıradan layout",
+    'auth-layout': "tek slot'lu sıradan layout",
+    popover: "'modal' widget'ı",
+    'theme-toggle': 'cihaz teması otomatik (koyu/açık)',
+    pagination: "'repeater' + daha fazla yükle düğmesi",
+    breadcrumb: "yığın gezinmesi (app-bar geri düğmesi)"
+};
+const STYLE_REPLACEMENTS = {
+    className: "yerine surfaceStyle (zemin, kenar, köşe, gölge) ve typographyStyle tipli gruplarını kullanın",
+    tooltip: "dokunmatikte üzerine gelme yok — düğümü 'tooltip' bileşenine sarın (dokunuşla açılır) ya da açıklamayı metin olarak koyun",
+    tooltipPosition: "dokunmatikte üzerine gelme yok — 'tooltip' bileşeninde balonun yanı `side` prop'udur",
+    zIndex: "katman için 'modal' ya da 'drawer' widget'ı kullanın",
+    style: "serbest CSS nesnesi React Native'de çizilmez — surfaceStyle ve typographyStyle tipli gruplarına taşıyın",
+    hoverStyle: 'dokunmatikte üzerine gelme durumu yok'
+};
+export function styleReplacement(key) {
+    return STYLE_REPLACEMENTS[key] ?? 'mobil çizer bu alanı okumaz';
+}
+export function missingComponentAdvice(slug) {
+    // Yayındaki bileşen: katalog senkronu bu uygulamaya henüz yazmamış olabilir — "gelecek" demek yanlış olur.
+    if (Object.hasOwn(mobileComponentKnowledge, slug))
+        return `'${slug}' mobil pakette var ama bu uygulamanın kataloğunda henüz yok — components-sync mobil kataloğu yazdı mı (component_list)? Yazmadıysa backend 422 unknown-type döner`;
+    const wave = Object.hasOwn(MOBILE_COMPONENT_WAVES, slug) ? MOBILE_COMPONENT_WAVES[slug] : undefined;
+    if (wave === 2)
+        return `'${slug}' web'de var, mobilde Dalga 2 (F6 sonrası) — şimdilik Dalga 1 bileşenleriyle kurun (component_list)`;
+    if (wave === 3)
+        return `'${slug}' web'de var, mobilde Faz 3 (ayrı iş) — bu planda mobil karşılığı yok`;
+    const alternative = Object.hasOwn(MOBILE_WEB_ONLY, slug) ? MOBILE_WEB_ONLY[slug] : undefined;
+    if (alternative)
+        return `'${slug}' web'e özgüdür, mobilde gelmeyecek — ${alternative}`;
+    return `'${slug}' mobil katalogda yok — component_list ile mobil uygulamanın bileşenlerini görün`;
+}
+/**
+ * `component_get` mobil uygulamada (G4): kayıt mobil kataloğun satırıdır, davranış notları web
+ * runtime'ından (`knowledge`), bileşene özgü farklar mobil sözlükten (`mobileKnowledge`) gelir; bu
+ * liste BÜTÜN mobil bileşenlere geçen notlardır — kural kodlu üç not + `MOBILE_COMPONENT_NOTES`.
+ */
+export function mobileComponentNotes(slug) {
+    const wave = slug === undefined ? undefined : MOBILE_COMPONENT_WAVES[slug];
+    return [
+        "Yerleşim yalnız flex: `layout` prop'u mobil şemalarda yoktur (grid/cssgrid yok), blocks/size yok sayılır, sıra dizi indeksidir; ölçü appearance ile verilir (widthType/heightType — MOB-001).",
+        "Görünüm tipli gruplarla: surfaceStyle ve typographyStyle React Native stiline derlenir; ham CSS `style` prop'u hiçbir mobil şemada yoktur, className, `tooltip` alanı (ipucu için `tooltip` bileşeni), zIndex ve hoverStyle çizilmez (MOB-002). Karşılığı olmayan değer sessizce düşmez, uyarıya yazılır; düğümün gerçek stili: page_runtime_get(resolveStyles) → nativeStyle.",
+        "Basılabilir bileşen role=\"button\" taşır; page_screenshot click onu kabuğun içinde bulur.",
+        ...MOBILE_COMPONENT_NOTES,
+        ...(wave === undefined ? [] : [`Mobil bileşen dalgası: ${wave} (plans/mobil-uygulama-expo §11).`])
+    ];
+}