@appaflytech/zeyrek-ai-mcp 0.0.31 → 0.0.32

package/dist/knowledge/platform/mobileRules.js

@@ -1,231 +0,0 @@
-import { MOBILE_COMPONENT_NOTES, mobileComponentKnowledge } from '../mobileComponentCatalog.js';
-import { STYLE_GROUP_FIELDS } from '../styleResolve.js';
-export const MOBILE_RULES = {
-    'MOB-001': {
-        id: 'MOB-001',
-        severity: 'warn',
-        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/renderer (NativeRenderer blocks okumaz; sıra dizi indeksinden)',
-        summary: 'Mobil sayfada blok (12 sütun ızgara) ya da grid/cssgrid yerleşimi — çizer yok sayar'
-    },
-    'MOB-002': {
-        id: 'MOB-002',
-        severity: 'warn',
-        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/style/compose-native-style.ts (yalnız tipli gruplar derlenir)',
-        summary: "Mobil sayfada CSS-only alan (className, tooltip, zIndex, serbest style, hoverStyle, em/rem/calc ölçü, surfaceStyle'ın tanımadığı alt anahtar)"
-    },
-    'MOB-003': {
-        id: 'MOB-003',
-        severity: 'warn',
-        sourceRef: 'zeyrek-backend PageSchemaValidator unknown-type (mobil uygulama mobil kataloğa karşı doğrulanır)',
-        summary: 'Mobil katalogda olmayan bileşen tipi — backend 422 unknown-type ile reddeder'
-    },
-    'MOB-004': {
-        id: 'MOB-004',
-        severity: 'warn',
-        sourceRef: 'plans/mobil-uygulama-expo/05-mobil-ayarlar-ve-gezinme.md §2 (D14)',
-        summary: "Mobil layout/sayfada web kabuğu (navigations, sidebar, header) — app-bar, sekmeler ayarı ve drawer widget'ı var"
-    },
-    'MOB-005': {
-        id: 'MOB-005',
-        severity: 'info',
-        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/runtime/runtime-tasks.ts',
-        summary: "Mobil uygulamada download paylaşım/açma sayfası açar; setcookie storage'a eşlenir"
-    },
-    'MOB-006': {
-        id: 'MOB-006',
-        severity: 'warn',
-        sourceRef: 'zeyrek-backend/docs/harici-componentler (protokol v1 tarayıcı .mjs; mobil v2 Faz 3); 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',
-        severity: 'warn',
-        sourceRef: 'plans/mobil-uygulama-expo/05-mobil-ayarlar-ve-gezinme.md §2.2, §2.6 (K13)',
-        summary: "Sekme ayarı tutarsız ya da layout/sayfada eski tab-bar/drawer-menu düğümü"
-    },
-    'MOB-008': {
-        id: 'MOB-008',
-        severity: 'warn',
-        sourceRef: 'zeyrek-frontend/apps/mobile-runtime/src/navigation/navigation.ts (hrefFor); zeyrek-backend FlowDtoValidator',
-        summary: "redirect.presentation kümede değil — push | modal | replace dışı değer backend'de 422, çizer push'a düşer"
-    },
-    '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-014': {
-        id: 'MOB-014',
-        severity: 'warn',
-        sourceRef: 'docs/adr/0004-state-saklama-turu.md; zeyrek-frontend/packages/ng-apps-flow/src/machine/state-persistence.ts (depoyu barındırıcı verir; web Runtime.svelte vermez)',
-        summary: "State saklama türü (storage: device | secure) uygulamanın platformunda uygulanmıyor — kayda yazılır, state bellekte çalışır"
-    },
-    'MOB-015': {
-        id: 'MOB-015',
-        severity: 'warn',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S1; zeyrek-frontend/apps/studio/src/features/mobile/mobile-native-canvas.functions.ts (topSafeAreaMissing); apps/mobile-runtime PageScreen.tsx (host payı uygulamaz, plan D15)',
-        summary: 'Üst güvenli alan tek yerde değil: kabuksuz sayfada/kabukta eksik ya da kabuk verirken sayfada ikinci pay'
-    },
-    'MOB-016': {
-        id: 'MOB-016',
-        severity: 'warn',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S3; zeyrek-frontend/apps/mobile-runtime/src/runtime/PageScreen.tsx (sayfa her zaman ScrollView içinde)',
-        summary: "Kaydırma tek yerde değil: kök `size: grow`, gerekçesiz ya da iç içe dikey scroll-view"
-    },
-    'MOB-017': {
-        id: 'MOB-017',
-        severity: 'warn',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S12',
-        summary: 'Ekranda tek app-bar yok: kabuk verirken sayfada ikinci app-bar ya da app-bar ilk çizilen öğe değil'
-    },
-    'MOB-018': {
-        id: 'MOB-018',
-        severity: 'info',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S13',
-        summary: 'Boş kap: çocuksuz, görünürlüğe bağlı olmayan bırakılabilir kap ekranda boş şerit bırakır'
-    },
-    'MOB-019': {
-        id: 'MOB-019',
-        severity: 'warn',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S6/S8; zeyrek-frontend ng-apps-screen-builder spacing.ts + ng-apps-ui-native renderer.functions.ts nodeSpacingStyle (ayna: nativeBoxModel.ts)',
-        summary: 'Kenar kayması: sütun akışındaki öğe kardeşlerinden içeride/dışarıda başlıyor (zeminsiz kap ya da sarmalayıcı içeriği iter)'
-    },
-    'MOB-020': {
-        id: 'MOB-020',
-        severity: 'warn',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S8/S9; renderer.functions.ts containerDirection (yazılmamış yön satır)',
-        summary: "Genişlik tutarsızlığı: sütunda fill olmayan tam genişlik öğesi ya da form alanı taşıyan satır kabı"
-    },
-    'MOB-021': {
-        id: 'MOB-021',
-        severity: 'info',
-        sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S5/S7/S11',
-        summary: 'Ölçek dışı değer: özel boşluk ya da sayısal gap 0/4/8/16/24/32 dışında, ham yarıçap, px yazı boyu'
-    }
-};
-/**
- * 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']);
-/**
- * Bileşen dalgaları (`plans/mobil-uygulama-expo/01-mimari-tasarim.md` §11). MOB-003 bir web bileşeninin
- * mobilde NE ZAMAN geleceğini söyler; `web-only` hiç gelmeyecekler ve karşılıkları.
- *
- * Mobil pakete giren bileşen Dalga 2/3 listesinden DÜŞER: yayında olduğunu mobil sözlükteki kaydı
- * söyler (`mobileComponentKnowledge`, parite testiyle `components.json`'a kilitli). Katalog A
- * (2026-09-24) sekiz web ikizini buradan indirdi: `radio`, `checkboxgroup`, `slider`, `tabs`, `badge`,
- * `avatar`, `progress`, `collapsible-container`; Katalog C (09) Dalga 3'ten `video`, `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); f-14 (2026-09-28)
- * Dalga 3'ten `timeline`ı ve listede olmayan `dropdown-button`ı (web ikizleri) ile mobile özgü `skeleton` ve `photo-viewer`ı. 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', 'phoneinput', 'statcard', 'detailview', 'page-header', 'autocomplete'].map(slug => [slug, 2]),
-    ...['kanban', '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)",
-    sidebar: "'drawer' widget'ı + app-bar.menuTarget",
-    navigations: 'Ayarlar › Sekmeler (application_update properties.mobile.tabs)',
-    header: "'app-bar'",
-    'layout-shell': "tek slot'lu sıradan layout + 'app-bar'",
-    'layout-region': "tek slot'lu sıradan layout",
-    'auth-layout': "tek slot'lu sıradan layout",
-    popover: "'modal' widget'ı",
-    'theme-toggle': "uygulama içi tema ayarı: 'choice-chips' (variant: segmented, Sistem/Açık/Koyu) → storage adımı name: 'zeyrek:theme-mode', value: system | light | dark; barındırıcı temayı anında değiştirir, cihazda kalıcı (seçim yazılmadıysa cihaz teması)",
-    pagination: "'repeater' + daha fazla yükle 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: "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) {
-    // Yayındaki bileşen: katalog senkronu bu uygulamaya henüz yazmamış olabilir — "gelecek" demek yanlış olur.
-    if (Object.hasOwn(mobileComponentKnowledge, slug))
-        return `'${slug}' mobil pakette var ama bu uygulamanın kataloğunda henüz yok — components-sync mobil kataloğu yazdı mı (component_list)? Yazmadıysa backend 422 unknown-type döner`;
-    const wave = Object.hasOwn(MOBILE_COMPONENT_WAVES, slug) ? MOBILE_COMPONENT_WAVES[slug] : undefined;
-    if (wave === 2)
-        return `'${slug}' web'de var, mobilde Dalga 2 (F6 sonrası) — şimdilik Dalga 1 bileşenleriyle kurun (component_list)`;
-    if (wave === 3)
-        return `'${slug}' web'de var, mobilde Faz 3 (ayrı iş) — bu planda mobil karşılığı yok`;
-    const alternative = Object.hasOwn(MOBILE_WEB_ONLY, slug) ? MOBILE_WEB_ONLY[slug] : undefined;
-    if (alternative)
-        return `'${slug}' web'e özgüdür, mobilde gelmeyecek — ${alternative}`;
-    return `'${slug}' mobil katalogda yok — component_list ile mobil uygulamanın bileşenlerini görün`;
-}
-/**
- * `component_get` mobil uygulamada (G4): kayıt mobil kataloğun satırıdır, davranış notları web
- * runtime'ından (`knowledge`), bileşene özgü farklar mobil sözlükten (`mobileKnowledge`) gelir; bu
- * liste BÜTÜN mobil bileşenlere geçen notlardır — kural kodlu üç not + `MOBILE_COMPONENT_NOTES`.
- */
-export function mobileComponentNotes(slug) {
-    const wave = slug === undefined ? undefined : MOBILE_COMPONENT_WAVES[slug];
-    return [
-        "Yerleşim yalnız flex: `layout` prop'u mobil şemalarda yoktur (grid/cssgrid yok), blocks/size yok sayılır, sıra dizi indeksidir; ölçü appearance ile verilir (widthType/heightType — MOB-001).",
-        "Görünüm tipli gruplarla: surfaceStyle ve typographyStyle React Native stiline derlenir; ham CSS `style` prop'u `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/mobileSpacing.js

@@ -1,82 +0,0 @@
-import { MOBILE_TRANSPARENT_WRAPPER_TYPES } from '../mobileComponentCatalog.js';
-import { PAGE_CONTAINER_ELEMENT_ID } from '../normalize.js';
-/**
- * Boşluğunu runtime'ın kendisi çözen tipler: kabuk parçaları ve katmanlar margin'siz çizilir
- * (`ng-apps-ui-native` `FLUSH_SPACING_TYPES`, `@ng-apps/screen-builder` `HIDE_SPACING_TYPES`). `tooltip`
- * f-01'den beri runtime'da da muaf, ama burada bilerek yok: mobil runtime uygulamaya gömülüdür ve f-01'den
- * önce derlenmiş uygulamada açık `none` hizayı yine korur.
- */
-const RUNTIME_FLUSH_TYPES = ['safe-area', 'scroll-view', 'app-bar', 'auth-layout', 'modal', 'drawer'];
-export const emptyMobileSpacingFix = () => ({ margin: [], wrappers: [], legacyParents: [] });
-/**
- * Mizanpaj sözleşmesi S5/S6 (plans/mobil-mizanpaj-dili 02, K3-b): mobilde kardeşler arası boşluk yalnız
- * ebeveynin `gap`'inden gelir. Runtime margin tipi yazılmamış düğüme 4 dp verir ve bu her iç içe katmanda
- * birikir; yeni düğüme `marginType: 'none'` yazılır. Kardeşleri varsayılan margin'le duran (eski) bir
- * kaba eklenen düğüme dokunulmaz — yeni düğüm eskilerden 4 dp kayardı. Saydam sarmalayıcı (`tooltip`)
- * içeriğini içeri itmesin diye padding'siz ve tam genişlik yazılır. Açıkça yazılmış değer korunur.
- */
-export function applyMobileSpacingDefaults(nodes, existingSiblings, fix, parentId = '') {
-    const list = asNodes(nodes);
-    // Boşluğunu runtime'ın çözdüğü kardeş (kabuksuz sayfanın `safe_area_top`'u gibi) hizaya karar vermez.
-    const followsNone = existingSiblings
-        .filter(sibling => !RUNTIME_FLUSH_TYPES.includes(String(sibling.type ?? '')))
-        .every(sibling => appearanceOf(sibling).marginType === 'none');
-    if (!followsNone && list.length > 0 && !fix.legacyParents.includes(parentId))
-        fix.legacyParents.push(parentId);
-    for (const node of list) {
-        const type = String(node.type ?? '');
-        const appearance = appearanceOf(node);
-        const id = String(node.elementId ?? type);
-        if (followsNone && !RUNTIME_FLUSH_TYPES.includes(type) && appearance.marginType === undefined) {
-            node.appearance = { ...appearance, marginType: 'none' };
-            fix.margin.push(id);
-        }
-        if (MOBILE_TRANSPARENT_WRAPPER_TYPES.includes(type) && (appearance.paddingType === undefined || appearance.widthType === undefined)) {
-            node.appearance = {
-                ...appearanceOf(node),
-                ...(appearance.paddingType === undefined ? { paddingType: 'none' } : {}),
-                ...(appearance.widthType === undefined ? { widthType: 'fill' } : {})
-            };
-            fix.wrappers.push(id);
-        }
-        applyMobileSpacingDefaults(node.children, [], fix, id);
-    }
-}
-/** `add_component` op'larının (batch içindekiler dâhil) yeni düğümlerine aynı kural; kardeşler kayıtlı ağaçtan. */
-export function applyMobileSpacingToOps(ops, savedSchema, fix) {
-    for (const op of ops) {
-        if (op.op === 'batch')
-            applyMobileSpacingToOps(asNodes(op.ops), savedSchema, fix);
-        if (op.op !== 'add_component' || !op.component || typeof op.component !== 'object')
-            continue;
-        const saved = asNodes(savedSchema);
-        const requested = typeof op.parent === 'string' ? op.parent : 'root';
-        // Kök ekleme sayfada `page_container`'a gider (yazımda `retargetRootAdds`, kuru koşuda platform).
-        const parentId = requested === 'root' && findNode(saved, PAGE_CONTAINER_ELEMENT_ID) ? PAGE_CONTAINER_ELEMENT_ID : requested;
-        const siblings = parentId === 'root' ? saved : asNodes(findNode(saved, parentId)?.children);
-        applyMobileSpacingDefaults([op.component], siblings, fix, parentId);
-    }
-}
-export function mobileSpacingNote(fix) {
-    return [
-        ...(fix.margin.length > 0 ? [`mobil: margin tipi yazılmamış ${fix.margin.length} düğüme marginType:'none' yazıldı (${fix.margin.slice(0, 8).join(', ')}${fix.margin.length > 8 ? ', …' : ''}) — kardeşler arası boşluk yalnız ebeveynin gap'inden gelir; runtime'ın varsayılan 4 dp margin'i iç içe katmanlarda birikir (mizanpaj sözleşmesi S5). Bilerek boşluk istediğin düğüme marginType yaz`] : []),
-        ...(fix.wrappers.length > 0 ? [`mobil: saydam sarmalayıcıya (${fix.wrappers.join(', ')}) paddingType:'none' ve widthType:'fill' yazıldı — padding'i içeriğini kardeşlerinden içeri iterdi (S6)`] : []),
-        ...(fix.legacyParents.length > 0 ? [`mobil: kardeşleri varsayılan margin'le duran kapta (${fix.legacyParents.join(', ')}) yeni düğümün margin'ine dokunulmadı — eskilerle aynı hizada kalsın diye. Kabı sözleşmeye taşımak için bütün çocuklarına marginType:'none' yazın`] : [])
-    ];
-}
-function asNodes(value) {
-    return Array.isArray(value) ? value.filter((item) => !!item && typeof item === 'object') : [];
-}
-function appearanceOf(node) {
-    return node.appearance && typeof node.appearance === 'object' ? node.appearance : {};
-}
-function findNode(nodes, elementId) {
-    for (const node of nodes) {
-        if (node.elementId === elementId)
-            return node;
-        const found = findNode(asNodes(node.children), elementId);
-        if (found)
-            return found;
-    }
-    return undefined;
-}

package/dist/knowledge/platform/mobileTabs.js

@@ -1,108 +0,0 @@
-export const MAX_MOBILE_TABS = 5;
-const STYLES = new Set(['default', 'floating', 'custom']);
-function record(value) {
-    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
-}
-function text(value) {
-    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
-}
-/** Öğenin sayfa id'si: `{ page }` ya da düz metin (`items: ['id']`). */
-function entryPage(entry) {
-    const item = record(entry);
-    return item ? text(item.page) : text(entry);
-}
-/** `Application.properties.mobile.tabs` — ham değer, doğrulanmamış. */
-export function readMobileTabs(properties) {
-    return record(record(properties)?.mobile)?.tabs;
-}
-/**
- * Ham sekme ayarını çizilebilir biçime getirir; çizilecek çubuk yoksa `null` (yığın).
- *
- * - Nesne değilse, `enabled !== true` ise ya da geçerli öğe kalmadıysa → `null`.
- * - `style` bilinmiyorsa `default`; `showLabels` boolean değilse `true`.
- * - Öğe `{ page }` ya da düz sayfa id'sidir; sayfası yoksa düşer; `pages` verildiyse orada olmayan
- *   sayfa düşer; tekrar eden sayfa (ilki kalır) atılır; `MAX_MOBILE_TABS`'tan sonrası kırpılır.
- *   `label`/`icon` boş metinse yazılmaz.
- * - Görünüm alanı yoktur: çubuk temadan çizilir; eski kayıtların `appearance`'ı okunmaz.
- * - `customWidgetId` yalnız `custom` türde ve metinse yazılır.
- */
-export function normalizeMobileTabs(tabs, pages) {
-    const source = record(tabs);
-    if (!source || source.enabled !== true)
-        return null;
-    const known = pages ? new Set(pages.map(page => page.id)) : undefined;
-    const seen = new Set();
-    const items = [];
-    for (const entry of Array.isArray(source.items) ? source.items : []) {
-        const item = record(entry);
-        const page = entryPage(entry);
-        if (!page || seen.has(page) || (known && !known.has(page)))
-            continue;
-        seen.add(page);
-        const label = text(item?.label);
-        const icon = text(item?.icon);
-        items.push({ page, ...(label ? { label } : {}), ...(icon ? { icon } : {}) });
-        if (items.length === MAX_MOBILE_TABS)
-            break;
-    }
-    if (items.length === 0)
-        return null;
-    const style = (typeof source.style === 'string' && STYLES.has(source.style) ? source.style : 'default');
-    const customWidgetId = style === 'custom' ? text(source.customWidgetId) : undefined;
-    return {
-        enabled: true,
-        style,
-        items,
-        ...(customWidgetId ? { customWidgetId } : {}),
-        showLabels: typeof source.showLabels === 'boolean' ? source.showLabels : true
-    };
-}
-/**
- * MOB-007 denetimi: ham ayarın normalizasyonda neyi kaybedeceğini ve tutarsızlıklarını söyler.
- * Yazım yine platforma gider (D3); bulgular yalnız uyarıdır.
- */
-export function mobileTabsProblems(tabs, context = {}) {
-    if (tabs === undefined || tabs === null)
-        return [];
-    const source = record(tabs);
-    if (!source)
-        return [`properties.mobile.tabs nesne olmalı (gelen: ${Array.isArray(tabs) ? 'dizi' : typeof tabs}) — sekme çubuğu çizilmez, uygulama yığınla açılır`];
-    const problems = [];
-    const rawItems = Array.isArray(source.items) ? source.items : undefined;
-    if (source.enabled !== undefined && typeof source.enabled !== 'boolean')
-        problems.push(`enabled boolean olmalı (gelen: ${JSON.stringify(source.enabled)}) — true olmayan her değer sekmeleri kapatır`);
-    if (source.style !== undefined && !(typeof source.style === 'string' && STYLES.has(source.style)))
-        problems.push(`style '${String(source.style)}' tanınmıyor (default | floating | custom) — 'default' çizilir`);
-    if (source.items !== undefined && !rawItems)
-        problems.push('items dizi olmalı — hiçbir sekme çizilmez');
-    const items = rawItems ?? [];
-    const pageIds = items.map(entryPage);
-    if (source.enabled === true && items.length === 0)
-        problems.push("enabled:true ama items boş — çubuk çizilmez; en az bir sayfa ekleyin ya da enabled:false yazın");
-    if (items.length > MAX_MOBILE_TABS)
-        problems.push(`${items.length} sekme var, en çok ${MAX_MOBILE_TABS} çizilir — fazlası kırpılır (${pageIds.slice(MAX_MOBILE_TABS).filter(Boolean).join(', ')})`);
-    const missingPage = pageIds.filter(id => !id).length;
-    if (missingPage > 0)
-        problems.push(`${missingPage} öğede page (sayfa id'si) yok — o öğeler düşer`);
-    const duplicates = pageIds.filter((id, index) => id && pageIds.indexOf(id) !== index);
-    if (duplicates.length > 0)
-        problems.push(`aynı sayfa birden çok sekmede: ${[...new Set(duplicates)].join(', ')} — tekrarlar atılır`);
-    if (context.pages) {
-        const known = new Set(context.pages.map(page => page.id));
-        const unknown = pageIds.filter((id) => Boolean(id) && !known.has(id));
-        if (unknown.length > 0)
-            problems.push(`var olmayan sayfa: ${[...new Set(unknown)].join(', ')} — page_list ile id'leri doğrulayın; bu öğeler düşer (item.page slug değil sayfa id'sidir)`);
-    }
-    const normalized = normalizeMobileTabs(tabs, context.pages ?? null);
-    if (normalized && context.homepageId && normalized.items[0]?.page !== context.homepageId) {
-        problems.push(`açılış sayfası (${context.homepageId}) ilk sekme değil — uygulama açılış sayfasıyla başlar ama çubukta başka sekme seçili görünür; açılış sayfasını items'ın başına alın`);
-    }
-    if (normalized?.style === 'custom') {
-        const widgetId = normalized.customWidgetId;
-        if (!widgetId)
-            problems.push("style:'custom' ama customWidgetId yok — özel sekme çubuğu widget'ı seçilmeli (component_list kind:'widget')");
-        else if (context.widgetIds && !context.widgetIds.has(widgetId))
-            problems.push(`customWidgetId '${widgetId}' bu mobil uygulamanın widget'ı değil — çubuk yerine uyarı çizilir`);
-    }
-    return problems;
-}

package/dist/knowledge/platform/nativeBoxModel.js

@@ -1,44 +0,0 @@
-import { MOBILE_DROPPABLE_TYPES } from '../mobileComponentCatalog.js';
-/**
- * Mobil runtime'ın kutu modelinin aynası (MOB-019): bir düğümün sol dış boşluğu ve çocuklarını içeri iten sol
- * iç boşluğu. Kaynak `@ng-apps/screen-builder` `spacing.ts` (`resolveSpacing`, sabitler, `HIDE_SPACING_TYPES`),
- * `constants.ts` (`NO_PADDING_TYPES`) ve `ng-apps-ui-native` `renderer.functions.ts` (`nodeSpacingStyle`,
- * `FLUSH_SPACING_TYPES`). Ayna bayatlarsa `test/native-inset-parity.test.ts` kırmızıya düşer.
- */
-export const RUNTIME_NORMAL_MARGIN = 4;
-export const RUNTIME_NORMAL_PADDING = 10;
-export const FLUSH_SPACING_TYPES = ['safe-area', 'scroll-view', 'app-bar', 'tooltip'];
-export const HIDE_SPACING_TYPES = ['auth-layout', 'modal', 'drawer'];
-export const NO_PADDING_TYPES = ['auth-layout', 'modal', 'drawer'];
-export const SHELL_ROOT_TYPES = ['layout', 'layout-shell'];
-/** `widthType` yazılmasa da tam genişlik çizilen tipler (`renderer.functions.ts` `FULL_WIDTH_TYPES`, MOB-020). */
-export const FULL_WIDTH_TYPES = ['app-bar'];
-/** Düğümün sol dış boşluğu (dp). `isWrapper`, katmanlar ve kabuk kökü dış boşluk almaz. */
-export function nativeMarginLeft(node) {
-    const states = (node.states ?? {});
-    const type = String(node.type ?? '');
-    if (states.isWrapper || HIDE_SPACING_TYPES.includes(type) || states.isShell || SHELL_ROOT_TYPES.includes(type))
-        return 0;
-    return sideValue(node.appearance, 'margin', FLUSH_SPACING_TYPES.includes(type), RUNTIME_NORMAL_MARGIN);
-}
-/** Bırakılabilir düğümün çocuklarına verdiği sol iç boşluk (dp); `isWrapper` bunu SIFIRLAMAZ (01'de ölçüldü). */
-export function nativePaddingLeft(node) {
-    const states = (node.states ?? {});
-    const type = String(node.type ?? '');
-    const droppable = states.isDroppable ?? MOBILE_DROPPABLE_TYPES.includes(type);
-    if (!droppable || NO_PADDING_TYPES.includes(type) || states.isShell || SHELL_ROOT_TYPES.includes(type))
-        return 0;
-    return sideValue(node.appearance, 'padding', FLUSH_SPACING_TYPES.includes(type), RUNTIME_NORMAL_PADDING);
-}
-/** `resolveSpacing`: tip yoksa (ya da boşsa) `normal`; `custom` kenar değerini, yoksa tek değeri okur. */
-function sideValue(appearance, layer, flush, normal) {
-    const written = appearance?.[`${layer}Type`];
-    const type = typeof written === 'string' && written !== '' ? written : flush ? 'none' : 'normal';
-    if (type === 'normal')
-        return normal;
-    if (type !== 'custom')
-        return 0;
-    const values = appearance?.[`${layer}Values`];
-    const left = Number(values?.left ?? appearance?.[`${layer}Value`] ?? 0);
-    return Number.isFinite(left) ? left : 0;
-}

package/dist/knowledge/platform/profile.js

@@ -1,25 +0,0 @@
-/**
- * Değişken kaydının `storage` alanının alabildiği değerler (`docs/adr/0004-state-saklama-turu.md`):
- * `device` cihaz deposu, `secure` güvenli depo. Alanın yokluğu bellektir — `memory` kayda yazılmaz.
- */
-export const STATE_STORAGE_KINDS = ['device', 'secure'];
-/**
- * Motorun kendi register ettiği adımlar (`@ng-apps/flow` `flow-engine.ts` initialize) — iki
- * platformda da koşar. `end` ve `query` hiçbir barındırıcıda yoktur (normalizasyon `end`'i atar).
- */
-export const ENGINE_STEP_TYPES = ['start', 'setter', 'code', 'condition', 'microservice', 'validation', 'flow-trigger', 'function'];
-/**
- * Eski adım tipi → koşan karşılığı. `navigate` ile `redirect`'in argümanı aynıdır; web `navigate`'i
- * register etmez, yeni mobil runtime onu `redirect` takma adı olarak kaydeder — iki platformda da
- * `redirect` kesin üstündür.
- */
-export const STEP_ALIASES = Object.freeze({ navigate: 'redirect' });
-/** Tipli stil grupları iki platformda da çizilir (web CSS'e, mobil RN stiline derler). */
-export const TYPED_STYLE_GROUPS = ['surfaceStyle', 'typographyStyle', 'sectionStyle', 'headerStyle', 'valueStyle'];
-/** Bulguyu mevcut `layoutWarnings[]` satır biçimine çevirir (`PAGE-010 (uyarı) — …` kalıbı). */
-export function findingLine(finding) {
-    const level = finding.severity === 'info' ? 'bilgi' : 'uyarı';
-    const target = finding.target ? ` [${finding.target}]` : '';
-    const guide = finding.guide ? ` (${finding.guide})` : '';
-    return `${finding.code} (${level})${target} — ${finding.message}${guide}`;
-}

package/dist/knowledge/platform/resolve.js

@@ -1,122 +0,0 @@
-import { mobileProfile } from './mobile.js';
-import { webProfile } from './web.js';
-export const APPLICATION_TYPE_TTL_MS = 10 * 60_000;
-const caches = new WeakMap();
-function cacheOf(platform) {
-    let cache = caches.get(platform);
-    if (!cache) {
-        cache = new Map();
-        caches.set(platform, cache);
-    }
-    return cache;
-}
-/** Backend `ApplicationType` JSON'da açıklama metniyle ('web' | 'mobile') döner; eski sayısal biçim de okunur. */
-export function readApplicationPlatform(value) {
-    if (value === 1 || (typeof value === 'string' && value.toLowerCase() === 'mobile'))
-        return 'mobile';
-    if (value === 0 || (typeof value === 'string' && value.toLowerCase() === 'web'))
-        return 'web';
-    return undefined;
-}
-export function profileFor(platform) {
-    return platform === 'mobile' ? mobileProfile : webProfile;
-}
-function factsOf(record) {
-    const platform = readApplicationPlatform(record.type);
-    const id = typeof record.id === 'string' ? record.id : undefined;
-    if (!platform || !id)
-        return undefined;
-    const homepage = record.homepage && typeof record.homepage === 'object' ? record.homepage.id : undefined;
-    const homepageId = typeof record.homepageId === 'string' ? record.homepageId : typeof homepage === 'string' ? homepage : undefined;
-    const properties = record.properties && typeof record.properties === 'object' && !Array.isArray(record.properties)
-        ? record.properties
-        : undefined;
-    return {
-        id,
-        platform,
-        ...(typeof record.slug === 'string' ? { slug: record.slug } : {}),
-        ...(typeof record.name === 'string' ? { name: record.name } : {}),
-        ...(typeof record.projectSlug === 'string' ? { projectSlug: record.projectSlug } : {}),
-        ...(homepageId ? { homepageId } : {}),
-        ...(properties ? { properties } : {})
-    };
-}
-function fresh(entry) {
-    return entry !== undefined && Date.now() - entry.at < APPLICATION_TYPE_TTL_MS;
-}
-export async function resolveApplication(platform, applicationId) {
-    const cache = cacheOf(platform);
-    const cached = cache.get(applicationId);
-    if (fresh(cached))
-        return cached.facts;
-    try {
-        const payload = await platform.org('GET', `/applications/${applicationId}`);
-        const facts = factsOf(((payload?.data ?? payload) ?? {}));
-        if (facts)
-            cache.set(applicationId, { facts, at: Date.now() });
-        return facts;
-    }
-    catch {
-        return undefined;
-    }
-}
-export async function resolveProfile(platform, applicationId) {
-    const application = await resolveApplication(platform, applicationId);
-    return application
-        ? { profile: profileFor(application.platform), known: true, application }
-        : { profile: webProfile, known: false };
-}
-const SLUG_LOOKUP_PAGE = 50;
-/**
- * `page_screenshot` ve `page_runtime_get` uygulamayı slug ile tanır. Org listesi `searchTerm` ile
- * daraltılır ve slug + proje slug'ı BİREBİR eşleşen kayıt alınır (arama ILIKE'tır, `shop` `shop-2`'yi
- * de getirir). B1'den beri liste tip filtresi verilmeyince iki tipi de döner. Aynı slug'ı çok proje
- * kullanıyorsa (`mobile`, `admin`) aranan kayıt ilk sayfanın dışında kalabilir: sayfa doluysa ve
- * eşleşme yoksa arama proje kimliğiyle tekrarlanır — (proje, slug) tekildir.
- */
-export async function resolveProfileBySlug(platform, projectSlug, applicationSlug) {
-    const cache = cacheOf(platform);
-    const key = `slug:${projectSlug}/${applicationSlug}`;
-    const cached = cache.get(key);
-    if (fresh(cached))
-        return { profile: profileFor(cached.facts.platform), known: true, application: cached.facts };
-    try {
-        const search = async (query) => {
-            const payload = await platform.org('GET', '/applications', { query: { searchTerm: applicationSlug, pageLength: SLUG_LOOKUP_PAGE, ...query } });
-            return Array.isArray(payload?.data) ? payload.data : [];
-        };
-        const matchIn = (rows) => rows.find(row => row.slug === applicationSlug && (row.projectSlug === undefined || row.projectSlug === projectSlug));
-        const rows = await search({});
-        let match = matchIn(rows);
-        if (!match && rows.length >= SLUG_LOOKUP_PAGE) {
-            const project = await platform.org('GET', `/p/${projectSlug}`);
-            const projectId = (project?.data ?? project)?.id;
-            if (typeof projectId === 'string')
-                match = matchIn(await search({ projectId }));
-        }
-        const facts = match ? factsOf(match) : undefined;
-        if (!facts)
-            return { profile: webProfile, known: false };
-        cache.set(key, { facts, at: Date.now() });
-        return { profile: profileFor(facts.platform), known: true, application: facts };
-    }
-    catch {
-        return { profile: webProfile, known: false };
-    }
-}
-/** Yazma araçları uygulamayı değiştirdiğinde (tip, slug, properties) kaydı düşürür. */
-export function forgetApplication(platform, applicationId) {
-    const cache = cacheOf(platform);
-    if (applicationId === undefined) {
-        cache.clear();
-        return;
-    }
-    for (const [key, entry] of cache) {
-        if (key === applicationId || entry.facts.id === applicationId)
-            cache.delete(key);
-    }
-}
-/** Yanıta eklenen alan: tip biliniyorsa `applicationType`, bilinmiyorsa hiçbir şey. */
-export function applicationTypeField(resolved) {
-    return resolved.known ? { applicationType: resolved.profile.platform } : {};
-}