@appaflytech/zeyrek-ai-mcp 0.0.28 → 0.0.30

package/dist/knowledge/platform/lint.js

@@ -0,0 +1,385 @@
+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';
+import { listThemeVarNames } from '../themeResolve.js';
+import { closestArgument } from '../../platform/argumentAliases.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);
+    }
+}
+/**
+ * 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 ?? '?');
+}
+const GRID_LAYOUTS = new Set(['grid', 'cssgrid']);
+const RELATIVE_UNIT = /\b\d*\.?\d+(em|rem)\b|calc\(/i;
+/**
+ * THEME-012: mobil çizici `var(--ng-…)`'yi yalnız temanın yaydığı değişkenlerden çözer
+ * (`compose-native-style.ts` `resolveThemeToken`); web'deki bileşen yerel değişkenleri (`--ng-nav-bg` …)
+ * cihazda yoktur. Temada olmayan, yedeksiz bir ad çözülmez: zemin saydam kalır ve iOS gölgesi her çocuğa
+ * düşer (koşu 37 K37-c, `var(--ng-surface)`). Web profili bu kuralı koşmaz.
+ */
+const STYLE_GROUP_PROPS = new Set(['surfaceStyle', 'typographyStyle', 'headerStyle']);
+const UNRESOLVED_TOKEN = /var\(\s*(--ng-[\w-]+)\s*\)/g;
+let themeVarNames;
+function nearestThemeVar(name) {
+    themeVarNames ??= listThemeVarNames();
+    const tail = `-${name.replace(/^--ng-/, '')}`;
+    const bySuffix = themeVarNames.filter(known => known.endsWith(tail)).sort((left, right) => left.length - right.length)[0];
+    return bySuffix ?? closestArgument(name, themeVarNames);
+}
+function unknownThemeTokens(value) {
+    themeVarNames ??= listThemeVarNames();
+    const found = [];
+    const visit = (entry) => {
+        const unwrapped = propValue(entry);
+        if (typeof unwrapped === 'string') {
+            for (const match of unwrapped.matchAll(UNRESOLVED_TOKEN)) {
+                const name = match[1] ?? '';
+                if (!themeVarNames.includes(name))
+                    found.push(name);
+            }
+            return;
+        }
+        for (const nested of Object.values(asRecord(unwrapped) ?? {}))
+            visit(nested);
+    };
+    visit(value);
+    return [...new Set(found)];
+}
+/**
+ * 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 fileIdSources = [];
+    const nodeTypes = new Map();
+    const floorImages = [];
+    const namelessIconButtons = [];
+    const unknownTokens = [];
+    const hit = (map, key, target) => map.set(key, [...(map.get(key) ?? []), target]);
+    const inspectTokens = (target, value) => {
+        for (const name of unknownThemeTokens(value)) {
+            const nearest = nearestThemeVar(name);
+            unknownTokens.push(nearest ? `${target}: ${name} → ${nearest}` : `${target}: ${name}`);
+        }
+    };
+    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);
+        }
+    };
+    // 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);
+        for (const group of STYLE_GROUP_PROPS)
+            inspectTokens(target, props[group]);
+        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);
+            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) {
+            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);
+    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')
+            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);
+            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 && !documentCss)
+                hit(styleHits, 'style', target);
+            if (prop === 'hoverStyle' && !profile.style.hoverStyle)
+                hit(styleHits, 'hoverStyle', target);
+            if (prop === 'surfaceStyle')
+                inspectSurface(target, op.value);
+            if (STYLE_GROUP_PROPS.has(prop))
+                inspectTokens(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) {
+        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.`
+        });
+    }
+    if (unknownTokens.length > 0) {
+        findings.push({
+            code: 'THEME-012',
+            severity: 'warn',
+            target: [...new Set(unknownTokens.map(entry => entry.split(':')[0] ?? entry))].join(', '),
+            message: `temada tanımlı olmayan jeton cihazda çözülmez (zemin saydam kalır, iOS gölgesi içeriğe düşer): ${[...new Set(unknownTokens)].join(' · ')}. Geçerli adlar temanın yaydığı değişkenlerdir (theme_get); bilerek kullanıyorsanız yedek verin: var(--ad, #fff). Yazım platforma gitti.`,
+            guide: "platform_guide('theme')"
+        });
+    }
+    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 (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,
+            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"
+        });
+    }
+    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 => {
+        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' tarayıcı indirmesi yapmaz: adres dönen yanıt Linking.openURL ile açılır, ikili gövde (JSON değil) önbelleğe yazılıp paylaşım sayfasında (expo-sharing) açılır"
+                : "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);
+}
+/**
+ * MOB-014: yazılan değişkenlerden, profilin barındırıcısının depo vermediği saklama türünü taşıyanlar.
+ * Kararı platform adı değil profilin `state.storageKinds` ekseni verir; `profileFindings`'ten ayrı
+ * durur çünkü o yalnız mobil profilde bulgu üretir, bu kural kümenin boş olduğu profilde tetiklenir.
+ */
+export function stateStorageFindings(profile, entries) {
+    const ignored = entries.filter(entry => entry.storage !== undefined && !profile.state.storageKinds.has(entry.storage));
+    if (ignored.length === 0)
+        return [];
+    return [{
+            code: MOBILE_RULES['MOB-014'].id,
+            severity: MOBILE_RULES['MOB-014'].severity,
+            target: ignored.map(entry => `'${entry.key}'`).join(', '),
+            message: `saklama türü (${[...new Set(ignored.map(entry => entry.storage))].join(', ')}) ${profile.platform} uygulamasında uygulanmıyor: tür kayda yazıldı ama bu platformun çalışma zamanı depo vermez — state bellekte çalışır, sayfa yeniden açılınca varsayılana döner`,
+            guide: "platform_guide('mobile') §Kalıcı state"
+        }];
+}
+/**
+ * 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

@@ -0,0 +1,142 @@
+import { ENGINE_STEP_TYPES, STATE_STORAGE_KINDS, 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.
+ *
+ * Mizanpaj sözleşmesi (plans/mobil-mizanpaj-dili 02): kök `size: shrink` (S-16: `grow` çocukları ekran
+ * boyunca eşit paya böler) ve `horizontalAlign: stretch` (Studio şablonu). Şablon kabuklu sayfanındır:
+ * üst güvenli alan ve 16 dp yatay kenar boşluğu kabuğun işidir (`safe-area top` + slot margin'i). Kabuksuz
+ * sayfayı `shellLessPageSkeleton` tamamlar — sayfanın layout'u ancak yazımda kesinleşir.
+ */
+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: 'stretch' },
+            verticalAlign: { type: 'static', data: 'top' },
+            size: { type: 'static', data: 'shrink' },
+            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: []
+    };
+}
+/**
+ * Kabuksuz sayfanın iskeleti (S1/S4): kök yatay 16 padding taşır — `isWrapper` yalnız margin'i sıfırlar,
+ * kökün padding'i çizilir (01'de ölçüldü) — ve ilk çizilen öğe üst güvenli alan değilse tepeye
+ * `safe_area_top` konur. Gateway'in kurduğu köke uygulanır; notu döner.
+ */
+export function shellLessPageSkeleton(root) {
+    const children = Array.isArray(root.children) ? root.children : [];
+    const addsSafeArea = topSafeAreaMissing(children);
+    root.appearance = { ...root.appearance, paddingType: 'custom', paddingValues: { top: 0, right: 16, bottom: 0, left: 16 } };
+    root.children = addsSafeArea ? [topSafeArea(), ...children] : children;
+    return [`mobil kabuksuz sayfa: köke yatay 16 padding yazıldı${addsSafeArea ? " ve tepeye üst güvenli alan (safe_area_top, edges:'top') eklendi" : ''} — ekran kenarı boşluğu ve durum çubuğu payı (mizanpaj S1/S4). Kabuklu sayfada ikisi kabuğun işidir: layoutId verin`];
+}
+/** Ekrana sabit katmanlar akışta değildir; üst payı onlar vermez (`topSafeAreaMissing`, Studio kanvası). */
+export const OVERLAY_TYPES = ['drawer', 'fab', 'floating-container', 'modal', 'toast'];
+/** `safe-area`'nın `edges`'i; yazılmamışsa `all` (Studio `KNOWN_SAFE_EDGES`). */
+export function safeAreaEdges(node) {
+    const edges = node.props?.edges;
+    const value = edges && typeof edges === 'object' ? edges.data : edges;
+    return typeof value === 'string' && value !== '' ? value : 'all';
+}
+/** Akışta çizilen ilk öğe (kaplama katmanları ve yüzen düğümler atlanır). */
+export function firstDrawn(nodes) {
+    return nodes.find(node => !OVERLAY_TYPES.includes(String(node.type ?? '')) && node.states?.isFloating !== true);
+}
+/**
+ * İlk çizilen öğe üst payı veriyor mu — Studio'nun `topSafeAreaMissing`'iyle aynı anlam
+ * (`apps/studio/src/features/mobile/mobile-native-canvas.functions.ts`): `edges` yazılmamışsa `all`dır,
+ * yalnız `bottom` üst payı vermez; ilk öğe çocuklu bir kapsa onun ilk öğesine bakılır. Boş sayfa da pay alır.
+ */
+export function topSafeAreaMissing(nodes, mode = 'skeleton') {
+    const first = firstDrawn(nodes);
+    if (!first)
+        return true;
+    if (first.type === 'safe-area')
+        return safeAreaEdges(first) === 'bottom';
+    const children = Array.isArray(first.children) ? first.children : [];
+    if (children.length > 0)
+        return topSafeAreaMissing(children, mode);
+    // Studio: boş kap hiçbir şey çizmez, korunacak içerik de yoktur — uyarı yok. İskelet ise payı yine kurar.
+    return mode === 'studio' ? first.states?.isDroppable !== true : true;
+}
+/** Studio'nun yeni sayfa şablonundaki payla aynı (`new-page-schema.functions.ts`). */
+function topSafeArea() {
+    return {
+        elementId: 'safe_area_top',
+        kind: 'component',
+        name: 'safe_area_top',
+        type: 'safe-area',
+        props: { edges: { type: 'static', data: 'top' } },
+        blocks: [],
+        states: { isSticky: false, isDroppable: true, isScrollable: false, isWrapper: false },
+        appearance: { heightType: 'auto', widthType: 'fill' },
+        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', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel']),
+        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,
+    state: { storageKinds: new Set(STATE_STORAGE_KINDS) },
+    capture: {
+        target: 'studio-mobile',
+        devices: {
+            phone: { width: 390, height: 844, dpr: 2 },
+            tablet: { width: 820, height: 1180, dpr: 2 }
+        },
+        defaultDevice: 'phone'
+    }
+});