@appaflytech/zeyrek-ai-mcp 0.0.22 → 0.0.24

package/dist/knowledge/mobileComponentEvents.js

@@ -12,7 +12,23 @@ 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.'
+                value: 'string | number | boolean | Array — seçenek ÖZGÜN tipinde (değeri `34` yazılmış seçenek sayı yayar). `multiple` açıkken seçili değerlerin DİZİSİ (`[34, "a"]`); tek kipte seçili çipe yeniden dokunmak boş metin (`""`) yayar. Devre dışı seçenek olay yaymaz.'
+            }
+        }
+    },
+    // Web ikizinin yükü metindir (`e.currentTarget.value`); mobil seçeneği ÖZGÜN tipinde yayar (f-06, `optionEmitValues`).
+    // İki platformda aynı koşul için karşılaştırmayı metne çevirin: `String(self.value) === '34'`.
+    radio: {
+        change: {
+            payload: {
+                value: 'string | number | boolean — seçilen seçeneğin ÖZGÜN değeri (değeri `34` yazılmış seçenek sayı yayar; web aynı seçimi `"34"` metni olarak yayar)'
+            }
+        }
+    },
+    checkboxgroup: {
+        change: {
+            payload: {
+                value: 'Array — seçili seçeneklerin ÖZGÜN değerleri (`["su", 9]`; web metin dizisi yayar). Seçeneklerde olmayan eski değer metin kalır'
             }
         }
     },
@@ -56,9 +72,31 @@ export const mobileComponentEventContracts = {
         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)" } },
+        message: {
+            payload: { data: "string — sayfanın window.ReactNativeWebView.postMessage(metin) ile yolladığı metin, olduğu gibi; makine data prop'una yazar (self.data)" },
+            reads: "iki yönlü köprü: sayfa window.ngApps.emit(name, data) çağırırsa yük olayın params'ında gelir — akış event.name ve event.data okur (self.data yazılmaz)"
+        },
         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)" }
     },
+    html: {
+        mount: NO_DATA,
+        message: {
+            payload: {},
+            reads: "belgenin window.ngApps.emit(name, data) çağrısı; yük olayın params'ındadır — akış event.name (ileti adı) ve event.data (veri) okur. actions satırının akışı ise fireEvent(key, data) ile koşar: event.name = key, event.data = veri"
+        }
+    },
+    map: {
+        mount: NO_DATA,
+        markerClick: { payload: { markerId: "string — dokunulan işaretçinin `id`si (boşsa listedeki sırası); makine markerId prop'una yazar (self.markerId). Başlığı ya da açıklaması olan işaretçide balon da açılır" } },
+        regionChange: {
+            payload: {
+                latitude: 'number — kullanıcının bıraktığı merkezin enlemi (6 basamak)',
+                longitude: 'number — merkezin boylamı (6 basamak, −180…180)',
+                zoom: 'number — web harita ölçeği (2 basamak, 1–19)'
+            },
+            reads: "yalnız kullanıcının sürüklemesi ya da yakınlaştırması bitince yayılır; akışın yazdığı görünüm ve kutu boyu değişimi yaymaz. Makine üç prop'u da yazar (self.latitude, self.longitude, self.zoom)"
+        }
+    },
     markdown: {
         mount: NO_DATA,
         linkClick: {
@@ -75,10 +113,92 @@ export const mobileComponentEventContracts = {
     'safe-area': {
         mount: NO_DATA
     },
+    // Web `container` yalnız `mount` yayar; `click` mobile-only (plans/mobil-plantcare-acigi f-04, K1).
+    container: {
+        click: NO_DATA
+    },
+    // Arama varyantının "Vazgeç"i (plans/mobil-plantcare-acigi f-05): değer temizlenir, klavye kapanır.
+    textinput: {
+        cancel: NO_DATA
+    },
     'scroll-view': {
         mount: NO_DATA,
         scrollEnd: NO_DATA,
-        refresh: NO_DATA
+        refresh: NO_DATA,
+        scroll: {
+            payload: {
+                y: 'number — dikey kaydırma konumu (yatay kaydırıcıda x)',
+                contentHeight: 'number — içeriğin boyu (yatayda contentWidth)',
+                viewportHeight: 'number — görünen alanın boyu (yatayda viewportWidth)'
+            },
+            reads: '100 ms seyreltmeli; yalnız bu olaya akış bağlıyken yayılır. Düğüme scrollY (scrollX) de yazılır'
+        }
+    },
+    'grouped-list': {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                selectedIndex: 'number — dokunulan öğenin rows içindeki DÜZ indeksi (bölüm içi değil); aynı öğeye yeniden dokununca yayılmaz. Makine selectedIndex\'i yazar, akışta tıklanan satır <liste>.selectedItem'
+            }
+        },
+        itemPress: {
+            payload: {
+                index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
+                row: 'object (öğenin satır verisi)'
+            },
+            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (list-item, button) dokunuş onun click\'ine gider, itemPress yayılmaz'
+        },
+        swipe: {
+            payload: {
+                key: 'string (kaydırma eyleminin key alanı)',
+                index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
+                row: 'object (öğenin satır verisi)'
+            }
+        },
+        sectionPress: {
+            payload: {
+                key: 'string — bölüm anahtarı (tarih değerinde yerel gün YYYY-AA-GG)',
+                title: 'string — bölüm başlığı (anahtar; boş alanlı satırların bölümünde otherSectionTitle)',
+                count: 'number — bölümdeki öğe sayısı',
+                items: 'object[] — bölümdeki satırların verisi'
+            },
+            reads: 'bölüm başlığına dokununca; yük başlık şablonunun Section ifadesiyle aynı nesnedir'
+        },
+        selectionChange: {
+            payload: {
+                selectedIndices: 'number[] — seçili satırların rows içindeki DÜZ indeksleri, sıralı',
+                count: 'number — seçili satır sayısı'
+            },
+            reads: 'yalnız selectionMode: multiple (ya da longPressSelects ile açılınca); akış event.data.selectedIndices / event.data.count okur, düğümün selectedIndices/selectedItems değeri de yazılır'
+        }
+    },
+    eventcalendar: {
+        mount: NO_DATA,
+        dateClick: {
+            payload: { date: "string 'yyyy-MM-dd'", rows: 'object[] — o güne düşen kaynak satırlar (mobil)' },
+            reads: "self'e yazılmaz — event.data ile oku; ay ve hafta görünümünde güne dokununca"
+        },
+        eventClick: {
+            payload: { id: 'string', title: 'string', row: 'kaynak satırın TAMAMI' },
+            reads: "self'e yazılmaz — event.data ile oku; gün çizelgesinde bloğa dokununca"
+        },
+        monthChange: {
+            payload: {
+                month: 'number (1-TABANLI)',
+                year: 'number',
+                view: "'month' | 'week' | 'day'",
+                start: "string 'yyyy-MM-dd' (görünen ilk gün)",
+                end: "string 'yyyy-MM-dd' (görünen son gün)"
+            },
+            reads: "self'e yazılmaz — event.data ile oku; oklar, yatay kaydırma ve Bugün ile her görünümde"
+        },
+        viewChange: {
+            payload: { view: "'month' | 'week' | 'day'", start: "string 'yyyy-MM-dd'", end: "string 'yyyy-MM-dd'" },
+            reads: "self'e yazılmaz — event.data ile oku; görünüm düğmesiyle"
+        }
+    },
+    'floating-container': {
+        mount: NO_DATA
     },
     repeater: {
         swipe: {
@@ -93,6 +213,13 @@ export const mobileComponentEventContracts = {
                 index: 'number (satırın sırası, 0 tabanlı)',
                 row: 'object (satırın verisi)'
             }
+        },
+        selectionChange: {
+            payload: {
+                selectedIndices: 'number[] — seçili satırların rows içindeki DÜZ indeksleri, sıralı',
+                count: 'number — seçili satır sayısı'
+            },
+            reads: 'yalnız selectionMode: multiple (ya da longPressSelects ile açılınca); akış event.data.selectedIndices / event.data.count okur, düğümün selectedIndices/selectedItems değeri de yazılır'
         }
     }
 };

package/dist/knowledge/normalize.js

@@ -1,7 +1,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 { DOCUMENT_STYLE_TYPES, 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' };
@@ -1886,12 +1886,22 @@ export function nestedRepeaterNodes(nodes) {
     walk(asObjects(nodes), false);
     return found;
 }
-export function nestedRepeaterMessage(ids) {
-    return `PAGE-013 — repeater içinde repeater (istek gönderilmedi): ${ids.join(' · ')}. `
+/**
+ * Mobil profilde gruplu listenin (gün/kategori başlığı altında satırlar) hazır bileşeni vardır:
+ * `grouped-list` (ui-native, ADR 0007). Web'de karşılığı yok — web mesajı textarea tarifinde kalır.
+ */
+export function nestedRepeaterMessage(ids, platform = 'web') {
+    const measured = `PAGE-013 — repeater içinde repeater (istek gönderilmedi): ${ids.join(' · ')}. `
         + 'Ölçüldü (2026-08-19): iç repeater OKUMADA çalışır ama girilen değer dış satıra GERİ YAZILMAZ '
         + '(_repeaterValues null kalır) ve tek düzenlemeden sonra DOM bozulur. Sebep yapısal: şemada iç '
-        + 'repeater tek düğümdür, dış satır başına ayrı düğüm yoktur. Satır içi listeyi tek bir textarea '
-        + "ile topla (satır başına bir öğe) ve kaydederken split('\n') ile böl — platform_guide('page') Kural 1g.";
+        + 'repeater tek düğümdür, dış satır başına ayrı düğüm yoktur. ';
+    const textarea = "Satır içi listeyi tek bir textarea ile topla (satır başına bir öğe) ve kaydederken split('\n') ile böl — platform_guide('page') Kural 1g.";
+    if (platform !== 'mobile')
+        return measured + textarea;
+    return measured
+        + 'Başlıklar altında gruplanmış liste (güne/kategoriye göre) için mobilde tek `grouped-list` kur: düz `rows` + '
+        + '`groupBy` alan yolu; çocuk 0 bölüm başlığı (`{{ Section.title }}`), çocuk 1 öğe şablonu (`Row`, `{{ item.<alan> }}`) — '
+        + "platform_guide('mobile') §Güne göre görev listesi. Satır içinde düzenlenen alt liste gerekiyorsa: " + textarea;
 }
 /**
  * `style` prop'u düz CSS STRING verilmiş düğümler. Çalışır (emotion string'i CSS metni sayar) ama
@@ -1905,7 +1915,7 @@ export function stringStyleNodes(nodes) {
         for (const node of list) {
             const props = (node.props ?? {});
             const style = props.style;
-            if (style && typeof style.data === 'string' && style.data.includes(':')) {
+            if (style && typeof style.data === 'string' && style.data.includes(':') && !DOCUMENT_STYLE_TYPES.has(String(node.type))) {
                 found.push(String(node.elementId ?? node.name ?? '?'));
             }
             walk(asObjects(node.children));

package/dist/knowledge/platform/lint.js

@@ -1,5 +1,7 @@
-import { MOBILE_RULES, REDIRECT_PRESENTATIONS, missingComponentAdvice, styleReplacement } from './mobileRules.js';
+import { IMAGE_SOURCE_PROPS, IMAGE_SOURCE_PROP_NAMES, MOBILE_RULES, REDIRECT_PRESENTATIONS, fileIdImageExpression, missingComponentAdvice, styleReplacement } from './mobileRules.js';
 import { findingLine } from './profile.js';
+import { SURFACE_KEYS } from '../styleResolveNative.js';
+import { DOCUMENT_STYLE_TYPES } from '../styleResolve.js';
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
 }
@@ -18,10 +20,28 @@ function walk(value, visit) {
         walk(node.children, visit);
     }
 }
+/**
+ * Koda ya da çeviriye bağlı prop: değeri çalışma anında `ref`'ten gelir, `data` yalnız tasarım yedeğidir.
+ * Belge CSS'i alan tipte (`DOCUMENT_STYLE_TYPES`) bağlı `style` metin sayılır — şema onu uzun metin ilan eder.
+ */
+function boundWrapper(value) {
+    const wrapped = asRecord(value);
+    return wrapped !== undefined && (wrapped.type === 'code' || wrapped.type === 'translation');
+}
 function propValue(value) {
     const wrapped = asRecord(value);
     return wrapped && 'data' in wrapped && typeof wrapped.type === 'string' ? wrapped.data : value;
 }
+/** Prop'un bağlı ifadesi: code sarmalının `ref`i (yoksa `data`sı) ya da çıplak şablon metni. */
+function boundExpression(value) {
+    if (typeof value === 'string')
+        return value;
+    const wrapped = asRecord(value);
+    if (!wrapped || wrapped.type !== 'code')
+        return undefined;
+    const expression = wrapped.ref ?? wrapped.data;
+    return typeof expression === 'string' ? expression : undefined;
+}
 function label(node) {
     return String(node.elementId ?? node.name ?? node.type ?? '?');
 }
@@ -42,6 +62,10 @@ export function profileFindings(profile, input) {
     const unknownTypes = new Map();
     const shellNodes = new Map();
     const legacyNodes = [];
+    const fileIdSources = [];
+    const nodeTypes = new Map();
+    const floorImages = [];
+    const namelessIconButtons = [];
     const hit = (map, key, target) => map.set(key, [...(map.get(key) ?? []), target]);
     const inspectAppearance = (target, appearance) => {
         if (!appearance)
@@ -57,20 +81,45 @@ export function profileFindings(profile, input) {
                 hit(styleHits, `${key} (${value})`, target);
         }
     };
+    // Mobil derleyici yüzey grubunun yalnız bilinen alanlarını okur; kalan alt anahtar cihazda düşer.
+    // `data`sız sarmal (`{ type: 'code', ref }`) bütün grubu bir ifadeye bağlar: denetlenecek alt anahtar yoktur.
+    const inspectSurface = (target, value) => {
+        const raw = asRecord(value);
+        if (raw && typeof raw.type === 'string' && !('data' in raw))
+            return;
+        for (const [key, wrapped] of Object.entries(asRecord(propValue(value)) ?? {})) {
+            const value = propValue(wrapped);
+            if (!SURFACE_KEYS.has(key) && value !== undefined && value !== null && value !== '')
+                hit(styleHits, `surfaceStyle.${key}`, target);
+        }
+    };
     const inspectNode = (node) => {
         const target = label(node);
         const type = String(node.type ?? '');
         const props = asRecord(node.props) ?? {};
         nodes.push(node);
+        nodeTypes.set(target, type);
+        for (const prop of IMAGE_SOURCE_PROPS[type] ?? []) {
+            const expression = fileIdImageExpression(boundExpression(props[prop]) ?? '');
+            if (expression)
+                fileIdSources.push({ target: `${target}.${prop}`, expression });
+        }
         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));
+        inspectSurface(target, props.surfaceStyle);
+        if (type === 'image' && !imageHasDefiniteHeight(asRecord(node.appearance)))
+            floorImages.push(target);
+        if (type === 'button' && propValue(props.size) === 'icon' && !String(propValue(props.ariaLabel) ?? '').trim() && !String(propValue(props.text) ?? '').trim()) {
+            namelessIconButtons.push(target);
+        }
         if (!profile.style.freeStyle) {
             const style = propValue(props.style);
-            if ((asRecord(style) && Object.keys(style).length > 0) || (typeof style === 'string' && style.trim() !== ''))
+            const documentCss = DOCUMENT_STYLE_TYPES.has(type) && (typeof style === 'string' || boundWrapper(props.style));
+            if (!documentCss && ((asRecord(style) && Object.keys(style).length > 0) || (typeof style === 'string' && style.trim() !== '')))
                 hit(styleHits, 'style', target);
         }
         if (!profile.style.hoverStyle) {
@@ -86,6 +135,8 @@ export function profileFindings(profile, input) {
             legacyNodes.push(`${target} (${type})`);
     };
     walk(input.nodes, inspectNode);
+    const savedTypes = new Map();
+    walk(input.savedNodes, node => savedTypes.set(label(node), String(node.type ?? '')));
     for (const op of input.ops ?? []) {
         const target = typeof op.target === 'string' ? op.target : '?';
         if (op.op === 'add_component')
@@ -97,12 +148,22 @@ export function profileFindings(profile, input) {
         if (op.op === 'replace_prop' || op.op === 'set_binding') {
             const prop = String(op.prop ?? '');
             const value = propValue(op.value);
+            const targetType = nodeTypes.get(target) ?? savedTypes.get(target) ?? '';
+            const documentCss = DOCUMENT_STYLE_TYPES.has(targetType) && (typeof value === 'string' || op.op === 'set_binding' || boundWrapper(op.value));
             if (prop === 'layout' && typeof value === 'string' && GRID_LAYOUTS.has(value))
                 gridNodes.push(`${target} (layout:${value})`);
-            if (prop === 'style' && !profile.style.freeStyle)
+            if (prop === 'style' && !profile.style.freeStyle && !documentCss)
                 hit(styleHits, 'style', target);
             if (prop === 'hoverStyle' && !profile.style.hoverStyle)
                 hit(styleHits, 'hoverStyle', target);
+            if (prop === 'surfaceStyle')
+                inspectSurface(target, op.value);
+            // MOB-011: var olan düğümün tipi op'ta yok — tip biliniyorsa (aynı yazımda eklendi) ona, yoksa prop adına bakılır.
+            const knownType = nodeTypes.get(target);
+            const imageProp = knownType === undefined ? IMAGE_SOURCE_PROP_NAMES.has(prop) : (IMAGE_SOURCE_PROPS[knownType] ?? []).includes(prop);
+            const expression = imageProp ? fileIdImageExpression(boundExpression(typeof op.expression === 'string' ? op.expression : op.value) ?? '') : undefined;
+            if (expression)
+                fileIdSources.push({ target: `${target}.${prop}`, expression });
         }
     }
     if (blockNodes.length > 0 || gridNodes.length > 0) {
@@ -141,6 +202,24 @@ export function profileFindings(profile, input) {
             guide: "examples/mobile-app-shell-{tab,stack,drawer}.json"
         });
     }
+    if (floorImages.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-012'].id,
+            severity: 'info',
+            target: floorImages.join(', '),
+            message: "görselin boyu belirsiz, 96 dp taban boyla çizilir — boy verin (heightType: 'fixed' + heightString ya da 'fill': görsel kabuğu doldurur) ya da oran verin (appearance.aspectRatio + heightType: 'auto' + widthType 'fill'/'fixed')",
+            guide: "platform_guide('mobile')"
+        });
+    }
+    if (namelessIconButtons.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-013'].id,
+            severity: 'info',
+            target: namelessIconButtons.join(', '),
+            message: "ikon boyundaki düğmenin adı yok — size: 'icon' metni çizmez ve ekran okuyucu ikonun ligatür adını (ör. 'notifications') okur; ariaLabel verin (ör. 'Bildirimler')",
+            guide: "platform_guide('mobile')"
+        });
+    }
     if (legacyNodes.length > 0) {
         findings.push({
             code: MOBILE_RULES['MOB-007'].id,
@@ -149,6 +228,17 @@ export function profileFindings(profile, input) {
             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"
         });
     }
+    if (fileIdSources.length > 0) {
+        const sample = fileIdSources[0]?.expression ?? '';
+        const object = sample.replace(/\??\.value(\s*\}\})$/, '$1');
+        findings.push({
+            code: MOBILE_RULES['MOB-011'].id,
+            severity: 'warn',
+            target: fileIdSources.map(source => source.target).join(', '),
+            message: `${[...new Set(fileIdSources.map(source => `'${source.expression}'`))].join(', ')} '.value' ile bitiyor — kayıttan okunan FILE alanı { type: 'ref', value: <dosya id>, absolute_path: <url> } döner ve '.value' dosya KİMLİĞİDİR (GUID), görsel çizilmez. Nesnenin kendisini verin ('${object}') ya da '.absolute_path' yazın. Gateway alan tipini sayfa şemasından bilemez: yol FILE alanı değilse (ör. URL taşıyan metin alanı) uyarıyı yok sayın. Yazım platforma gitti.`,
+            guide: "platform_guide('mobile') §Dosya ve fotoğraf"
+        });
+    }
     const infoSteps = new Map();
     const badPresentation = new Map();
     walkSteps(input.steps, step => {
@@ -203,3 +293,20 @@ function walkSteps(value, visit) {
 export function findingLines(findings) {
     return findings.map(findingLine);
 }
+/**
+ * Görselin boyu belli mi — mobil `imageFrameStyle` sırası: kabuktan (`fixed` + ölçülebilir `heightString`,
+ * ya da `fill`) ya da orandan (`aspectRatio` + `heightType: 'auto'` + genişlik `fill`/`fixed`+ölçü).
+ * Değilse görsel 96 dp taban boyla çizilir (MOB-012). Koşu bulgusu: `fixed`le kurulan görseller boşluk
+ * bıraktı, doğru kalıp yalnız bileşen açıklamasında yazıyordu (plans/mobil-plantcare-acigi g-10 adım 3).
+ */
+function imageHasDefiniteHeight(appearance) {
+    if (!appearance)
+        return false;
+    // Çizicinin `cssLength`'i: sayı, `Npx` ya da `N%` — birimsiz dize ölçülemez.
+    const measurable = (value) => typeof value === 'number' || (typeof value === 'string' && /^\d+(\.\d+)?(px|%)$/.test(value.trim()));
+    const heightType = appearance.heightType;
+    if (heightType === 'fill' || (heightType === 'fixed' && measurable(appearance.heightString)))
+        return true;
+    const definiteWidth = appearance.widthType === 'fill' || (appearance.widthType === 'fixed' && measurable(appearance.widthString));
+    return Number(appearance.aspectRatio) > 0 && heightType === 'auto' && definiteWidth;
+}

package/dist/knowledge/platform/mobile.js

@@ -53,7 +53,7 @@ export const mobileProfile = Object.freeze({
     },
     style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share']),
         aliases: STEP_ALIASES,
         infoOnly: new Set(['download', 'setcookie'])
     },

package/dist/knowledge/platform/mobileRules.js

@@ -1,4 +1,5 @@
 import { MOBILE_COMPONENT_NOTES, mobileComponentKnowledge } from '../mobileComponentCatalog.js';
+import { STYLE_GROUP_FIELDS } from '../styleResolve.js';
 export const MOBILE_RULES = {
     'MOB-001': {
         id: 'MOB-001',
@@ -10,7 +11,7 @@ export const MOBILE_RULES = {
         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çü)'
+        summary: "Mobil sayfada CSS-only alan (className, tooltip, zIndex, serbest style, hoverStyle, em/rem/calc ölçü, surfaceStyle'ın tanımadığı alt anahtar)"
     },
     'MOB-003': {
         id: 'MOB-003',
@@ -33,8 +34,8 @@ export const MOBILE_RULES = {
     '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'
+        sourceRef: 'zeyrek-backend/docs/harici-componentler (protokol v1 tarayıcı .mjs; mobil v2 Faz 3); plans/mobil-plantcare-acigi f-20 K7',
+        summary: "Harici bileşen mobil uygulamada desteklenmiyor — çağrı platforma gitmez; geçici yol 'html' bileşeni"
     },
     'MOB-007': {
         id: 'MOB-007',
@@ -47,8 +48,57 @@ export const MOBILE_RULES = {
         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"
+    },
+    'MOB-011': {
+        id: 'MOB-011',
+        severity: 'warn',
+        sourceRef: 'zeyrek-backend FilePathMapper.MapFileProperties (okunan FILE alanı { type: ref, value: <dosya id>, absolute_path }); zeyrek-frontend ng-apps-ui-native image-logic.ts resolveImageSource (plans/mobil-kosu-acik-yuksekler f-01)',
+        summary: "Görsel kaynağı ifadesi '.value' ile bitiyor — kayıttan okunan FILE alanında bu dosya kimliğidir (GUID), görsel çizilmez"
+    },
+    'MOB-012': {
+        id: 'MOB-012',
+        severity: 'info',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/components/image/image-logic.ts (imageFrameStyle)',
+        summary: "Mobil görselin boyu ne kabuktan (fixed + ölçü, fill) ne orandan (aspectRatio + heightType auto + belli genişlik) geliyor — 96 dp taban boyla çizilir"
+    },
+    'MOB-013': {
+        id: 'MOB-013',
+        severity: 'info',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/components/button/index.tsx (accessibleLabel: ariaLabel → text → ikon adı)',
+        summary: "İkon boyunda (size: icon) düğmenin adı yok — ne ariaLabel ne text; ekran okuyucu ikonun ligatür adını (notifications) okur"
     }
 };
+/**
+ * MOB-011: dosya nesnesini görsel olarak çizen prop'lar (mobil `resolveImageSource` tüketicileri).
+ * Hedefin tipi bilinmiyorsa (var olan düğüme `set_binding`) prop adı yeter — `IMAGE_SOURCE_PROP_NAMES`.
+ */
+export const IMAGE_SOURCE_PROPS = {
+    image: ['src'],
+    avatar: ['src'],
+    'list-item': ['leadingImage'],
+    card: ['image']
+};
+export const IMAGE_SOURCE_PROP_NAMES = new Set(Object.values(IMAGE_SOURCE_PROPS).flat());
+const TEMPLATE = /\{\{([\s\S]*?)\}\}/g;
+const MEMBER_PATH = /^[A-Za-z_$][\w$]*(?:\??\.[A-Za-z_$][\w$]*|\[\s*(?:\d+|'[^']*'|"[^"]*")\s*\])+$/;
+/**
+ * MOB-011'in desen denetimi. Gateway sayfa şemasından bir alanın FILE olduğunu BİLEMEZ (alan tipi
+ * entity'de, ifade yalnız bir yol) — bu yüzden kural metinseldir ve uyarı düzeyindedir: en az üç
+ * parçalı bir üye yolu (`item.foto.value`, `pages.x.params.kayit.foto.value`) `.value` ile bitiyorsa
+ * ilk eşleşen `{{ }}` şablonunu döner. İki parçalı yol (`urlInput.value` — bileşenin kendi değeri) ve
+ * `.value.value` (dosya alanının base64'ü: `fileInput1.value.value`) eşleşmez.
+ */
+export function fileIdImageExpression(template) {
+    for (const match of template.matchAll(TEMPLATE)) {
+        const body = (match[1] ?? '').trim();
+        if (!MEMBER_PATH.test(body))
+            continue;
+        const segments = body.match(/[A-Za-z_$][\w$]*|\[[^\]]*\]/g) ?? [];
+        if (segments.length >= 3 && segments[segments.length - 1] === 'value' && segments[segments.length - 2] !== 'value')
+            return match[0];
+    }
+    return undefined;
+}
 /** `redirect` adımının tanıdığı sunum biçimleri (b-01 `StepArgument.Presentation`). */
 export const REDIRECT_PRESENTATIONS = new Set(['push', 'modal', 'replace']);
 /**
@@ -58,15 +108,19 @@ export const REDIRECT_PRESENTATIONS = new Set(['push', 'modal', 'replace']);
  * 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
+ * `avatar`, `progress`, `collapsible-container`; Katalog C (09) Dalga 3'ten `video`, `signature`, `chart`,
+ * `fileInput` ve `filebutton`ı, Dalga 2'den `datepicker` ve `timepicker`ı (`fileUpload`un sürükle-bırak alanı
+ * dokunmatikte yok: web'e özgü, karşılığı iki dosya alanı); dil dalgası (plans/mobil-coklu-dil F1, 2026-09-25)
+ * Dalga 2'den `language-selector`ı; faz 10b (2026-09-27) Dalga 3'ten `datatable`ı; plans/mobil-plantcare-acigi f-11
+ * (2026-09-27) listede olmayan `daterangepicker`i doğrudan pakete aldı; f-20 (2026-09-28) Dalga 3'ten `html`ı (mobilde
+ * geçici çözüm kapısı, K7); f-12 (2026-09-28) listede olmayan `eventcalendar`ı (web ikizi, ay/hafta/gün). 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])
+    ...['box', 'phoneinput', 'statcard', 'detailview', 'page-header', 'autocomplete'].map(slug => [slug, 2]),
+    ...['kanban', 'timeline', 'texteditor', '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)",
@@ -79,17 +133,22 @@ export const MOBILE_WEB_ONLY = {
     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)"
+    breadcrumb: "yığın gezinmesi (app-bar geri düğmesi)",
+    fileUpload: "'fileInput' (alan) ya da 'filebutton' (düğme) — dokunmatikte sürükle-bırak yok; ikisi de aynı base64 değeri yazar"
 };
 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",
+    zIndex: "görselin üstüne rozet/hap/etiket/açıklama bindirmek için 'stack' (ilk çocuk taban, ötekiler üst katman; katman olarak fill×fill bir container koyup kendi hizasıyla köşeye yerleştirin), ekrana sabit içerik (FAB, alt eylem çubuğu, üst şerit) için 'floating-container' (anchor 9 nokta, offsetX/offsetY, fullWidth), kaydırırken üstte kalan başlık için scroll-view çocuğunda states.isSticky, sayfayı örten katman için 'modal' ya da 'drawer' widget'ı",
+    style: "serbest CSS nesnesi React Native'de çizilmez — surfaceStyle ve typographyStyle tipli gruplarına taşıyın; position/zIndex ile ekrana sabitlemek yerine 'floating-container' kullanın",
     hoverStyle: 'dokunmatikte üzerine gelme durumu yok'
 };
 export function styleReplacement(key) {
+    if (key.startsWith('surfaceStyle.')) {
+        const fields = (STYLE_GROUP_FIELDS.surfaceStyle ?? []).map(field => `\`${field}\``).join(', ');
+        return `yüzey grubunun alanları ${fields} (döndürme derece, ölçek yüzde — 100 aynı boy, kaydırma px)`;
+    }
     return STYLE_REPLACEMENTS[key] ?? 'mobil çizer bu alanı okumaz';
 }
 export function missingComponentAdvice(slug) {
@@ -115,7 +174,7 @@ 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.",
+        "Görünüm tipli gruplarla: surfaceStyle ve typographyStyle React Native stiline derlenir; ham CSS `style` prop'u `html` dışında hiçbir mobil şemada yoktur (`html`'in metin `style`'ı kendi belgesine kapsamlı girer), 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).`])

package/dist/knowledge/platform/web.js

@@ -20,7 +20,7 @@ export const webProfile = Object.freeze({
     },
     style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share']),
         aliases: STEP_ALIASES,
         infoOnly: new Set()
     },