@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.22

package/dist/tools/pages.js

@@ -10,7 +10,8 @@ import { emptyWriteDiff, schemaOpDrops, unwrapProps, withWriteDiff, writeDiff }
 import { PlatformApiError } from '../platform/errors.js';
 import { existingMatch, ifExistsParam, listAll, withOutcome } from '../platform/ifExists.js';
 import { handle, toolResult, toolError } from '../platform/responses.js';
-import { StudioScreenshotter } from '../platform/screenshot.js';
+import { StudioScreenshotter } from '../platform/capture/index.js';
+import { captureTargetFor } from '../platform/capture/target.js';
 import { diffSummaries, summaryLines, summaryStats } from '../platform/domSummary.js';
 import { captureKey, imageHash, sharedCaptureMemory } from '../platform/screenshotMemory.js';
 import { summarizeLayout } from '../knowledge/layoutSummary.js';
@@ -22,6 +23,9 @@ import { dirname, resolve } from 'node:path';
 import { setPropTypeErrors } from '../knowledge/propTypes.js';
 import { designSnapshotInput } from '../knowledge/designSnapshot.js';
 import { discoverPage } from '../knowledge/pageDiscover.js';
+import { applicationTypeField, resolveProfile, resolveProfileBySlug } from '../knowledge/platform/resolve.js';
+import { resolveThemeNative } from '../knowledge/styleResolveNative.js';
+import { boundFlowSteps, screenProfileWarnings } from './profileWrite.js';
 import { z } from 'zod';
 /**
  * Runtime paketindeki `appFunctions`/`pageFunctions` (UiFunctionRuntimeDto: id, name, parameters,
@@ -105,6 +109,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         annotations: readOnly
     }, handle(config, async ({ project, environment, applicationId, pageId }) => {
         const page = await fetchPage(platform, project, environment, applicationId, pageId);
+        const resolved = await resolveProfile(platform, applicationId);
         const layout = (page.layout ?? {});
         return {
             id: page.id,
@@ -123,7 +128,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             flows: (Array.isArray(page.flows) ? page.flows : [])
                 .map(flow => ({ id: flow.id, name: flow.name, slug: flow.slug })),
             schemaNodes: countSchemaNodes(page.schema),
-            updatedAt: page.audit?.updatedAt ?? page.audit?.createdAt
+            updatedAt: page.audit?.updatedAt ?? page.audit?.createdAt,
+            ...applicationTypeField(resolved)
         };
     }));
     server.registerTool('page_runtime_get', {
@@ -171,11 +177,17 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const styleSource = resolveStyles ? (theme ?? null) : undefined;
         const asNodes = (value) => (Array.isArray(value) ? value : []);
         const named = (value) => (Array.isArray(value) ? value : []).map(entry => ({ id: entry.id, name: entry.name, slug: entry.slug }));
+        const runtimeApplication = (body.application ?? {});
+        // Mobil uygulama React Native stiliyle çizilir (G4): rapor CSS kaskadı değil `shell`/`text`.
+        const nativeTheme = resolveStyles && runtimeApplication.type === 'mobile' ? resolveThemeNative((theme ?? undefined)) : undefined;
+        const nodeStyleSource = nativeTheme ? undefined : styleSource;
         return {
             page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, browserTitleKey: body.browserTitleKey, isHomepage: body.isHomepage },
+            ...(typeof runtimeApplication.type === 'string' ? { applicationType: runtimeApplication.type } : {}),
             events: body.events ?? [],
-            layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, styleSource)) } : null,
-            schema: asNodes(body.schema).map(node => summarize(node, styleSource)),
+            layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, nodeStyleSource, nativeTheme)) } : null,
+            schema: asNodes(body.schema).map(node => summarize(node, nodeStyleSource, nativeTheme)),
+            ...(nativeTheme ? { styleResolver: 'native' } : {}),
             widgets: named(body.widgets),
             flows: named(body.flows),
             variableKeys: Object.keys((body.variables ?? {})),
@@ -194,9 +206,11 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                     }
                 }
                 : {}),
-            note: resolveStyles
-                ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler — styleLayers.componentPreset ise CSS DEĞİL, düğümün hangi bileşen preseti versiyonundan kurulduğunun işaretidir."
-                : "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'. Bir düğümün ekranda GERÇEKTEN aldığı stili görmek için resolveStyles:true."
+            note: nativeTheme
+                ? "Mobil uygulama: nativeStyle, mobil çizerin düğüme verdiği React Native stilidir — shell kutunun, text içine akan metnin stili (RN'de tipografi miras alınmaz); warnings mobilde çizilmeyen değerlerdir (MOB-002). Tema componentStyles/preset katmanı mobil çizerde henüz uygulanmıyor, bu yüzden rapora girmez."
+                : resolveStyles
+                    ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler — styleLayers.componentPreset ise CSS DEĞİL, düğümün hangi bileşen preseti versiyonundan kurulduğunun işaretidir."
+                    : "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'. Bir düğümün ekranda GERÇEKTEN aldığı stili görmek için resolveStyles:true."
         };
     }));
     const screenshotter = injectedScreenshotter ?? new StudioScreenshotter(config);
@@ -213,7 +227,15 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             viewport: z.object({
                 width: z.number().int().min(320).max(3840),
                 height: z.number().int().min(240).max(2160)
-            }).optional().describe('Varsayılan 1280x800 (deviceScaleFactor 1)'),
+            }).optional().describe('Varsayılan 1280x800 (deviceScaleFactor 1); mobil uygulamada varsayılan device. Verilirse device yok sayılır'),
+            device: z.union([
+                z.enum(['phone', 'tablet']),
+                z.object({
+                    width: z.number().int().min(320).max(3840),
+                    height: z.number().int().min(240).max(2160),
+                    scale: z.number().min(1).max(3).optional()
+                })
+            ]).optional().describe("Yalnız MOBİL uygulama: cihaz ön ayarı — 'phone' 390x844 @2x (varsayılan), 'tablet' 820x1180 @2x, ya da { width, height, scale? }. Kare cihaz piksel yoğunluğunda çıkar (phone → 780x1688 px); raster küçültme için scale parametresi bununla çarpılır. Web uygulamasında reddedilir: dar ekran için viewport verin."),
             fullPage: z.boolean().optional().describe('true: kaydırılan kısım dahil tüm sayfa; varsayılan yalnız viewport karesi'),
             delayMs: z.number().int().min(0).max(60000).optional().describe("Hazırlık bütçesine EK süre (ms). Varsayılan bütçe 15 sn'dir ve kare sayfa hazır olur olmaz alınır (akışsız giriş ekranı ~1 sn, dashboard mount akışları bitince) — normalde vermeye gerek yok. Yalnız sayfa gerçekten uzun sürüyorsa (soğuk Vite derlemesi, ağır mount akışı) büyütün: bütçe dolduğunda sayfa hâlâ hazır değilse çağrı hatayla döner, kare alınmaz. Sayfanın AÇILMASI için beklenen 20 sn'lik navigasyon süresi de bu kadar uzar — soğuk Studio'da tek düğme budur (09-08 S-8)."),
             captureUnready: z.boolean().optional().describe("true: TEŞHİS kipi — bütçe dolduğunda sayfa hazır olmasa da kare alınır ve yanıt pageState: 'not-ready' taşır (iskelet/yarım kare görülebilir). Varsayılan false: yüklenmemiş sayfa çekilmez, hata döner."),
@@ -229,7 +251,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 value: z.unknown().optional().describe("'set' için yazılacak değer. Tarih kutularına ISO yazın ('2026-08-01'); çok alanlı tarih aralığında kök DEĞİL kutu hedeflenir: '<elementId>__start' / '<elementId>__end'. 'tab' için sekmenin ANAHTARI ('iot') ya da görünen metni; 'select' için seçeneğin value'su ya da görünen metni"),
                 ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi")
             })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
-            language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı."),
+            language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı. MOBİL uygulamada da geçerlidir (/preview aynı ?lang'i okur); cihazın kendisinde ?lang yoktur (platform_guide('mobile') §Çok dil)."),
             colorScheme: z.enum(['light', 'dark']).optional().describe("Kareyi açık ya da koyu temada çeker. Ziyaretçi tema tercihi çerezde değil localStorage'da yaşar ve tema store'u onu sayfa açılırken bir kez okur; gateway tercihi sayfa script'lerinden ÖNCE eker, bu yüzden sayfada 'theme-toggle' komponenti OLMASA DA koyu tema karesi alınabilir. Verilmezse projenin kendi modu çizilir."),
             format: z.enum(['png', 'jpeg']).optional().describe("Kare biçimi; varsayılan 'png'. Doğrulama karesi için 'jpeg' + quality 60 bağlamı küçültür (ölçüldü 2026-09-16, aynı sayfa: scale 1'de png 8639 B / jpeg60 8691 B — kazanç yok; scale 0.5'te png 3603 B / jpeg60 3035 B). Asıl kaldıraç ÖLÇEKTİR; renk ve kenar keskinliğinin kendisi inceleniyorsa png'de kalın."),
             quality: z.number().int().min(1).max(100).optional().describe("Yalnız format:'jpeg' ile: 1-100, doğrulama için 60 yeter. format 'png' iken verilirse çağrı reddedilir — PNG kayıpsızdır, kalite ayarı yoktur."),
@@ -244,7 +266,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             outPath: z.string().min(1).optional().describe('Verilirse PNG bu yerel yola yazılır ve inline görüntü DÖNMEZ; yalnız özet (yol, boyut) döner — büyük fullPage kareleri için')
         },
         annotations: readOnly
-    }, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, summary, image, format, quality, scale, clip, diff }) => {
+    }, async ({ project, environment, applicationSlug, pageSlug, viewport, device, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, summary, image, format, quality, scale, clip, diff }) => {
         try {
             if (anonymous === true && (asUser !== undefined || cookies !== undefined)) {
                 throw new PlatformApiError("page_screenshot: anonymous:true ile asUser/cookies birlikte verilemez — biri kimliksiz kareyi, diğeri belirli bir kimlikle çekilen kareyi ister. Anonim kare için yalnız anonymous:true, üye kimliğiyle kare için yalnız asUser (ve gerekiyorsa cookies) gönderin.");
@@ -288,7 +310,24 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 }
             }
             const url = `${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}${languageChoice ? `?lang=${languageChoice.code}` : ''}`;
-            const size = viewport ?? { width: 1280, height: 800 };
+            // Hedef ve cihaz uygulamanın platform profilinden (G3): mobil uygulama react-native-web
+            // çizimidir, varsayılan kare telefon ön ayarıdır. Tip okunamazsa web davranışı aynen.
+            const resolved = await resolveProfileBySlug(platform, projectSlug, applicationSlug);
+            const target = captureTargetFor(resolved.profile.capture.target);
+            const mobile = resolved.profile.platform === 'mobile';
+            if (device !== undefined && !mobile) {
+                throw new PlatformApiError(`page_screenshot: device yalnız MOBİL uygulamada geçerlidir — '${applicationSlug}' ${resolved.known ? 'bir web uygulaması' : 'uygulamasının tipi okunamadı (web varsayıldı)'}. Web'in dar ekran kırılımını görmek için viewport verin (ör. { width: 390, height: 844 }).`);
+            }
+            const deviceName = typeof device === 'string' ? device : device === undefined && mobile ? resolved.profile.capture.defaultDevice : undefined;
+            const preset = typeof device === 'object'
+                ? { width: device.width, height: device.height, dpr: device.scale ?? 1 }
+                : deviceName === undefined ? undefined : resolved.profile.capture.devices[deviceName];
+            const appliedDevice = viewport === undefined && preset !== undefined ? preset : undefined;
+            const deviceNote = viewport !== undefined && device !== undefined
+                ? 'viewport verildiği için device yok sayıldı: kare verilen viewport ve deviceScaleFactor 1 ile çekildi.'
+                : undefined;
+            const size = viewport ?? (appliedDevice ? { width: appliedDevice.width, height: appliedDevice.height } : { width: 1280, height: 800 });
+            const dpr = appliedDevice && appliedDevice.dpr !== 1 ? appliedDevice.dpr : undefined;
             const extraCookies = Object.entries(cookies ?? {}).map(([name, value]) => ({ name, value }));
             const identity = anonymous === true ? 'anonymous' : asUser === undefined ? 'gateway' : 'asUser';
             const identityToken = anonymous ? undefined : resolveIdentity(asUser) ?? await platform.accessToken();
@@ -313,7 +352,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 ...(quality === undefined ? {} : { quality }),
                 ...(scale === undefined ? {} : { scale }),
                 ...(clip === undefined ? {} : { clip: clip }),
-                ...(actions === undefined ? {} : { actions: actions })
+                ...(actions === undefined ? {} : { actions: actions }),
+                ...(mobile ? { target } : {}),
+                ...(dpr === undefined ? {} : { dpr })
             });
             // Fark ÖZETTEN çıkar; `summary:false` verilse de fark için toplanmıştır (yanıta girmez).
             // Anahtar KİMLİĞİ ayırır (K8): 'asUser' etiketi yetmez — iki farklı üyenin jetonu aynı
@@ -384,6 +425,11 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 ...(languageChoice?.note ? { languageNote: languageChoice.note } : {}),
                 ...(colorScheme === undefined ? {} : { colorScheme }),
                 viewport: size,
+                ...(appliedDevice === undefined ? {} : { device: typeof device === 'object' ? { ...device } : deviceName, deviceScaleFactor: appliedDevice.dpr }),
+                ...(deviceNote === undefined ? {} : { deviceNote }),
+                // Web karesinin yanıtı profil öncesiyle aynı kalır (G3 kısıtı); alan yalnız mobilde.
+                ...(mobile ? applicationTypeField(resolved) : {}),
+                ...(target.platformNote === undefined ? {} : { platformNote: target.platformNote }),
                 fullPage: fullPage === true,
                 identity,
                 cookieNames,
@@ -535,19 +581,20 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         annotations: readOnly
     }, handle(config, async ({ project, environment, applicationId, pageId, mode, componentId }) => {
         const page = await fetchPage(platform, project, environment, applicationId, pageId);
+        const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
         const updatedAt = page.audit?.updatedAt ?? page.audit?.createdAt;
         const version = page.version;
         if (mode === 'full')
-            return { version, updatedAt, schema: page.schema ?? [] };
+            return { version, updatedAt, ...typeField, schema: page.schema ?? [] };
         if (mode === 'subtree') {
             if (!componentId)
                 throw new PlatformApiError("mode='subtree' için componentId zorunludur.");
             const subtree = findNode(page.schema, componentId);
             if (!subtree)
                 throw new PlatformApiError(`Sayfada '${componentId}' id'li bir komponent yok; page_schema_get'i summary kipinde çağırıp hedefi doğrulayın.`);
-            return { version, updatedAt, schema: subtree };
+            return { version, updatedAt, ...typeField, schema: subtree };
         }
-        return { version, updatedAt, schema: (page.schema ?? []).map(node => summarize(node)) };
+        return { version, updatedAt, ...typeField, schema: (page.schema ?? []).map(node => summarize(node)) };
     }));
     server.registerTool('page_state', {
         title: 'Sayfa durumunu getir',
@@ -573,15 +620,20 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             ...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
             ...codePropTemplateErrors(opRecords).map(issue => `PAGE-032 — ${issue}`)
         ];
-        const ordering = await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId));
+        const resolved = await resolveProfile(platform, applicationId);
+        const ordering = resolved.profile.layout.orderBy === 'block-position'
+            ? await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId))
+            : { ops: opRecords, moved: [], warnings: [] };
+        const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', ops: opRecords });
         const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
             environment,
             body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
         })) ?? {});
         if (validationIssues.length > 0)
             response.validationWarnings = validationIssues;
-        if (ordering.warnings.length > 0)
-            response.layoutWarnings = ordering.warnings;
+        if (ordering.warnings.length > 0 || profileWarnings.length > 0)
+            response.layoutWarnings = [...ordering.warnings, ...profileWarnings];
+        Object.assign(response, applicationTypeField(resolved));
         return withNormalization(response, [
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),
@@ -669,7 +721,12 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 retargeted = retargetRootAdds(opRecords, PAGE_CONTAINER_ELEMENT_ID);
             }
         }
-        const ordering = await orderByIndex(opRecords, readPage);
+        const resolved = await resolveProfile(platform, applicationId);
+        const blocksMeaningful = resolved.profile.layout.blocksMeaningful;
+        // Mobil (dizi sırası): index platformun kendi add/move index'idir, konum çevirisi yapılmaz.
+        const ordering = resolved.profile.layout.orderBy === 'block-position'
+            ? await orderByIndex(opRecords, readPage)
+            : { ops: opRecords, moved: [], warnings: [] };
         const sentOps = ordering.ops;
         // Akış silen op'lar yamadan ÖNCE hesaplanır: uyarı sonradan geldiğinde akış zaten kalıcı
         // silinmiş oluyordu ve "önce yedekle" tavsiyesi uygulanamıyordu (09-05 koşusu, G-21).
@@ -729,10 +786,10 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 // görünür, iç içeliği ancak hedef parent zinciri belli olunca anlarsın.
                 nestedAfterOps = nestedRepeaterNodes(simulated);
                 layoutWarnings = [
-                    ...pageContainerPositionWarning(page.schema),
-                    ...verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched),
+                    ...(blocksMeaningful ? pageContainerPositionWarning(page.schema) : []),
+                    ...(blocksMeaningful ? verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched) : []),
                     ...stringStyleWarning(stringStyleNodes(simulated)),
-                    ...inertFlexPropWarning(inertFlexPropNodes(simulated)),
+                    ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(simulated)) : []),
                     ...flexSizeWarnings(simulated, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'),
                     ...spacingLayerWarnings(simulated, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')
                 ];
@@ -747,7 +804,12 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const resized = resizeOps.length > 0 ? planResizes((await readPage()).schema ?? [], resizeOps) : { serverOps: [], applied: [], warnings: [] };
         const propTypes = propTypeOps.length > 0 ? planPropTypes((await readPage()).schema ?? [], propTypeOps) : { serverOps: [], applied: [] };
         const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...sentOps];
-        layoutWarnings = [...ordering.warnings, ...layoutWarnings];
+        const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
+            kind: 'page',
+            ops: [...opRecords, ...propTypeOps],
+            steps: await boundFlowSteps(platform, resolved, project, environment, 'page', applicationId, pageId, opRecords)
+        });
+        layoutWarnings = [...ordering.warnings, ...layoutWarnings, ...profileWarnings];
         // Tek istek, tek sürüm: öykünülen op'lar 2026-09-14'e kadar ayrı GET + tam PUT çiftleriydi ve
         // yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
         // baseVersion yalnız biliniyorsa gider (ajanın verdiği ya da bu çağrıda zaten okunan sayfanınki):
@@ -801,6 +863,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 opDrops = emptyWriteDiff();
             }
         }
+        Object.assign(response, applicationTypeField(resolved));
         return withWriteDiff(withNormalization(response, [
             ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
             ...componentDefaultsNote(normalized.components),
@@ -845,16 +908,21 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, events, schema, view, ifExists }) => {
-        const container = ensurePageContainer(schema ?? []);
+        const resolved = await resolveProfile(platform, applicationId);
+        const blocksMeaningful = resolved.profile.layout.blocksMeaningful;
+        const container = ensurePageContainer(schema ?? [], resolved.profile.layout.rootContainer);
         assertScreenWriteGuards('page', { schema: container.schema, events });
         const stringStyles = stringStyleNodes(container.schema);
         const fixed = normalizeComponentDefaults(container.schema);
-        const reset = resetPageContainerPosition(container.schema);
+        // Mobil çizer blokları okumaz (D3): kök konumu sıfırlama, blok sıralama ve dikey boşluk
+        // uyarısı yalnız ızgaranın anlamlı olduğu profilde koşar.
+        const reset = blocksMeaningful ? resetPageContainerPosition(container.schema) : [];
         const catalogNotes = (schema ?? []).length > 0
             ? await screenCatalogNotes(platform, project, environment, applicationId, container.schema)
             : [];
-        const moved = reorderSchemaBlocks(container.schema);
-        const gaps = (schema ?? []).length > 0 ? verticalGapWarnings(container.schema, 'PAGE-010 (uyarı)') : [];
+        const moved = blocksMeaningful ? reorderSchemaBlocks(container.schema) : [];
+        const gaps = (schema ?? []).length > 0 && blocksMeaningful ? verticalGapWarnings(container.schema, 'PAGE-010 (uyarı)') : [];
+        const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', nodes: container.schema });
         const existing = await existingMatch({
             code: 'PAGE-035',
             noun: 'sayfa',
@@ -882,12 +950,13 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
             const updateWarnings = schema === undefined
                 ? []
-                : [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')];
+                : [...gaps, ...stringStyleWarning(stringStyles), ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(container.schema)) : []), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'), ...profileWarnings];
             const summary = {
                 id: pageId,
                 outcome: 'updated',
                 changed,
-                preserved: { schemaNodes: countSchemaNodes(body.schema), events: body.events.length }
+                preserved: { schemaNodes: countSchemaNodes(body.schema), events: body.events.length },
+                ...applicationTypeField(resolved)
             };
             if (updateWarnings.length > 0)
                 summary.layoutWarnings = updateWarnings;
@@ -920,10 +989,13 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             saved.schema = saved.schema.map(node => summarize(node));
         }
         const normalized = withWriteDiff(withNormalization(withOutcome(response, undefined), [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]), drops);
-        const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')];
-        if (createWarnings.length === 0 || !normalized || typeof normalized !== 'object')
+        const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(container.schema)) : []), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'), ...profileWarnings];
+        const typeField = applicationTypeField(resolved);
+        if (!normalized || typeof normalized !== 'object')
             return normalized;
-        return { ...normalized, layoutWarnings: createWarnings };
+        if (createWarnings.length === 0)
+            return Object.keys(typeField).length === 0 ? normalized : { ...normalized, ...typeField };
+        return { ...normalized, ...typeField, layoutWarnings: createWarnings };
     }));
     server.registerTool('page_update', {
         title: 'Sayfa üstbilgisini güncelle',
@@ -948,13 +1020,21 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
         assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events });
         const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
+        const resolved = overrides.schema === undefined ? undefined : await resolveProfile(platform, applicationId);
+        const blocksMeaningful = resolved?.profile.layout.blocksMeaningful ?? true;
         const fixed = normalizeComponentDefaults(overrides.schema);
-        const reset = overrides.schema === undefined ? [] : resetPageContainerPosition(overrides.schema);
+        const reset = overrides.schema === undefined || !blocksMeaningful ? [] : resetPageContainerPosition(overrides.schema);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.schema);
-        const moved = overrides.schema === undefined ? [] : reorderSchemaBlocks(overrides.schema);
+        const moved = overrides.schema === undefined || !blocksMeaningful ? [] : reorderSchemaBlocks(overrides.schema);
         const gaps = overrides.schema === undefined
             ? []
-            : [...verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)'), ...inertFlexPropWarning(inertFlexPropNodes(overrides.schema)), ...flexSizeWarnings(overrides.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(overrides.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')];
+            : [
+                ...(blocksMeaningful ? verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)') : []),
+                ...(resolved?.profile.layout.modes.has('grid') ?? true ? inertFlexPropWarning(inertFlexPropNodes(overrides.schema)) : []),
+                ...flexSizeWarnings(overrides.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'),
+                ...spacingLayerWarnings(overrides.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'),
+                ...(resolved ? await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', nodes: overrides.schema }) : [])
+            ];
         const body = pageUpdateBody(current, overrides);
         await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
         const summary = {

package/dist/tools/platformInfo.js

@@ -64,7 +64,8 @@ const guideRouting = {
     microfunction: 'kendi runtime\'ında koşan Node/Python fonksiyonu: protokol, yayın döngüsü, step kullanımı',
     entity: "alan tipleri, ilişkiler, hazır entity'ler",
     page: 'sayfa/flow işleri; flex düzen prop grubu ve boyut modları (Kural 1f-2)',
-    layout: 'yerleşim kabuğu: tek slot, views, mobil yığılma, widthType fill/fixed/auto',
+    layout: 'yerleşim kabuğu: tek slot, views, dar ekranda yığılma, widthType fill/fixed/auto',
+    mobile: "mobil UYGULAMA (type:'mobile'): kurulum sırası (mobile_app_create), flex-only yerleşim, tipli stil, sekmeler (properties.mobile.tabs) ve çekmece, adım sözlüğü, MOB-* bulguları, page_screenshot device",
     component: 'komponent modeli, olay sözleşmeleri, appearance boyut sözlüğü (widthString/heightString)',
     html: 'hazır komponent yetmediğinde tek seferlik kaçış kapısı (Mustache, fireEvent, script kuralları)',
     'external-component': 'kalıcı ihtiyaçta kendi komponentini yazıp yayınlama',

package/dist/tools/profileWrite.js

@@ -0,0 +1,45 @@
+import { findingLines, profileFindings } from '../knowledge/platform/lint.js';
+import { resolveProfile } from '../knowledge/platform/resolve.js';
+import { fetchCatalogSlugs } from './components.js';
+import { flowPath } from './screens.js';
+/**
+ * Sayfa/layout/widget yazma yollarının profil kapısı: mobil profilde `MOB-*` bulgularını
+ * `layoutWarnings[]` satırı olarak döner. Web profilinde HİÇBİR istek atmaz ve boş dizi döner —
+ * web yanıtı profil öncesiyle aynı kalır (G1 golden).
+ */
+export async function screenProfileWarnings(platform, resolved, project, environment, applicationId, input) {
+    if (resolved.profile.platform === 'web')
+        return [];
+    const catalog = await fetchCatalogSlugs(platform, project, environment, applicationId).catch(() => undefined);
+    return findingLines(profileFindings(resolved.profile, { ...input, ...(catalog ? { catalog } : {}) }));
+}
+/**
+ * `set_event` ile bağlanan akışların adımları (MOB-005). Akış gövdeleri şemada değil ayrı uçtadır;
+ * okunamazsa bulgu üretilmez, yazım yine geçer.
+ */
+export async function boundFlowSteps(platform, resolved, project, environment, host, applicationId, hostId, ops) {
+    if (resolved.profile.platform === 'web')
+        return [];
+    const flowIds = new Set(ops.filter(entry => entry.op === 'set_event').map(entry => String(entry.eventValue ?? '')).filter(id => id.length > 0));
+    if (flowIds.size === 0)
+        return [];
+    try {
+        const hosted = await platform.tenant('GET', project, flowPath(host, applicationId, hostId), { environment });
+        return (hosted?.data ?? [])
+            .filter(flow => flowIds.has(String(flow.id ?? '')))
+            .flatMap(flow => [...(Array.isArray(flow.steps) ? flow.steps : []), ...(Array.isArray(flow.errorSteps) ? flow.errorSteps : [])]);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Akış yazma yollarının profil kapısı (MOB-005): mobil uygulamada `download`/`setcookie` adımının
+ * davranış farkını `platformWarnings`'e yazar. Web profilinde istek atmaz, boş döner.
+ */
+export async function flowProfileWarnings(platform, applicationId, steps) {
+    const resolved = await resolveProfile(platform, applicationId);
+    if (resolved.profile.platform === 'web')
+        return [];
+    return findingLines(profileFindings(resolved.profile, { kind: 'page', steps }));
+}

package/dist/tools/screenWrite.js

@@ -1,4 +1,4 @@
-import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote } from '../knowledge/normalize.js';
+import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote, droppableStatesNote } from '../knowledge/normalize.js';
 import { FUNCTIONS_NAMESPACE } from '../knowledge/functionGuards.js';
 import { applyCatalogLayoutRules } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
@@ -65,5 +65,5 @@ export async function screenCatalogNotes(platform, project, environment, applica
     if (!Array.isArray(nodes) || nodes.length === 0)
         return [];
     const catalog = await applyCatalogLayoutRules(platform, project, environment, applicationId, nodes);
-    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes)];
+    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes), ...droppableStatesNote(catalog.states)];
 }

package/dist/tools/screens.js

@@ -1,5 +1,6 @@
 import { PlatformApiError } from '../platform/errors.js';
 import { resolveNodeStyleReport } from '../knowledge/styleResolve.js';
+import { nodeNativeStyle } from '../knowledge/styleResolveNative.js';
 import { z } from 'zod';
 export const hostParam = z.enum(['page', 'layout', 'component'])
     .describe("Akışın barındırıcısı: page | layout | component (widget de component'tir)");
@@ -13,21 +14,26 @@ export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().descr
  * `styleSource` verilirse (undefined DEĞİLSE) her düğüme efektif stil raporu da
  * yazılır: tema componentStyles → preset → düğümün kendi stili kaskadı.
  */
-export function summarize(node, styleSource) {
+export function summarize(node, styleSource, nativeTheme) {
     const summary = {
         id: node.id,
         elementId: node.elementId,
         name: node.name,
         type: node.type
     };
-    if (styleSource !== undefined) {
+    // Mobil uygulama: stil CSS değil React Native nesnesidir (`shell` kutu, `text` metin).
+    if (nativeTheme !== undefined) {
+        const { shell, text, warnings } = nodeNativeStyle(node, nativeTheme);
+        summary.nativeStyle = { shell, text, ...(warnings.length > 0 ? { warnings } : {}) };
+    }
+    else if (styleSource !== undefined) {
         const report = resolveNodeStyleReport(node, styleSource ?? undefined);
         if (report.resolvedStyle !== undefined)
             summary.resolvedStyle = report.resolvedStyle;
         summary.styleLayers = report.styleLayers;
     }
     if (Array.isArray(node.children) && node.children.length > 0) {
-        summary.children = node.children.map(child => summarize(child, styleSource));
+        summary.children = node.children.map(child => summarize(child, styleSource, nativeTheme));
     }
     return summary;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",