@appaflytech/zeyrek-ai-mcp 0.0.36 → 0.0.40

package/dist/knowledge/mobileComponentEvents.js

@@ -0,0 +1,259 @@
+/**
+ * MOBİLE ÖZGÜ olay yükleri. Mobil komponentlerin ÇOĞU web şemasını genişletir ve
+ * olayları web sözleşmesindedir (`componentEvents.ts`) — bu dosya yalnız web'de
+ * karşılığı OLMAYAN komponentler içindir (`app-bar` gibi kabuk komponentleri).
+ *
+ * Okuyucu önce buraya, sonra web sözlüğüne bakar; parity testi
+ * (`test/mobile-component-parity.test.ts`) her mobil olayın iki sözlükten
+ * birinde karşılanmasını zorunlu tutar.
+ */
+const NO_DATA = { payload: {} };
+export const mobileComponentEventContracts = {
+    'choice-chips': {
+        change: {
+            payload: {
+                value: 'string | number | boolean | Array — seçenek ÖZGÜN tipinde (değeri `34` yazılmış seçenek sayı yayar). `multiple` açıkken seçili değerlerin DİZİSİ (`[34, "a"]`); tek kipte seçili çipe yeniden dokunmak boş metin (`""`) yayar. Devre dışı seçenek olay yaymaz.'
+            }
+        }
+    },
+    // Web ikizinin yükü metindir (`e.currentTarget.value`); mobil seçeneği ÖZGÜN tipinde yayar (f-06, `optionEmitValues`).
+    // İki platformda aynı koşul için karşılaştırmayı metne çevirin: `String(self.value) === '34'`.
+    radio: {
+        change: {
+            payload: {
+                value: 'string | number | boolean — seçilen seçeneğin ÖZGÜN değeri (değeri `34` yazılmış seçenek sayı yayar; web aynı seçimi `"34"` metni olarak yayar)'
+            }
+        }
+    },
+    checkboxgroup: {
+        change: {
+            payload: {
+                value: 'Array — seçili seçeneklerin ÖZGÜN değerleri (`["su", 9]`; web metin dizisi yayar). Seçeneklerde olmayan eski değer metin kalır'
+            }
+        }
+    },
+    tooltip: {
+        open: NO_DATA
+    },
+    calendar: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string 'yyyy-MM-ddT00:00:00' | null — seçilen gün (aralıkta başlangıç); web datepicker'ın biçimi: yerel duvar saati, gece yarısı, dilim eki yok",
+                endValue: "string 'yyyy-MM-ddT00:00:00' | null — YALNIZ mode: 'range'; ilk basışta null, ikinci basışta bitiş günü"
+            }
+        }
+    },
+    stack: {
+        mount: NO_DATA
+    },
+    'list-item': {
+        click: NO_DATA
+    },
+    fab: {
+        click: NO_DATA
+    },
+    'photo-viewer': {
+        change: { payload: { index: 'number — gösterilen fotoğrafın sırası (0 tabanlı); makine index prop\'una yazar' } },
+        close: { payload: {}, reads: 'kapat düğmesi ya da geri; makine isOpen\'ı kapatır' },
+        share: { payload: { row: 'gösterilen satırın tamamı (images dizisindeki nesne)', index: 'number — satırın sırası' }, reads: 'Paylaş düğmesi yalnız bu olay bir akışa bağlıysa çizilir; paylaşmak akışın işidir' },
+        delete: { payload: { row: 'gösterilen satırın tamamı', index: 'number — satırın sırası' }, reads: 'Sil düğmesi yalnız bu olay bir akışa bağlıysa çizilir; satırı silmek ve listeyi yenilemek akışın işidir' }
+    },
+    timer: {
+        mount: NO_DATA,
+        tick: { payload: { value: 'number — gösterilen saniye (geri sayımda kalan, kronometrede geçen); makine value prop\'una yazar' } },
+        finish: { payload: { isRunning: 'false — geri sayım 0\'a indi; makine isRunning\'i kapatır' } }
+    },
+    audio: {
+        mount: NO_DATA,
+        play: { payload: { isPlaying: "true — çalma başladı (denetim ya da akış); makine isPlaying'i yazar" } },
+        pause: { payload: { isPlaying: "false — çalma durdu (denetim, akış, bitiş ya da tarayıcının otomatik oynatma reddi); makine isPlaying'i yazar" } },
+        ended: { payload: { isPlaying: "false — ses sona vardı (loop kapalıyken, pause'tan sonra); makine isPlaying'i kapatır" } }
+    },
+    lottie: {
+        mount: NO_DATA,
+        finish: { payload: { isPlaying: "false — döngüsüz animasyon bitti; makine isPlaying'i kapatır, yeniden true yazmak baştan oynatır" } }
+    },
+    webview: {
+        mount: NO_DATA,
+        load: { payload: {}, reads: "her tamamlanan yüklemede yayılır (izin verilen gezinmeden sonra da); cihazda yüklenemeyen sayfada yayılmaz (yerine error), web'de tarayıcı engellenen çerçevede de yayar" },
+        navigate: { payload: { url: "string — sayfanın gitmek istediği adres; makine url prop'una yazar (self.url). allowNavigation kapalıyken (varsayılan) gezinme engellenir; adres yalnız kullanıcının dokunduğu bağlantıda sistemde açılır" } },
+        message: {
+            payload: { data: "string — sayfanın window.ReactNativeWebView.postMessage(metin) ile yolladığı metin, olduğu gibi; makine data prop'una yazar (self.data)" },
+            reads: "iki yönlü köprü: sayfa window.ngApps.emit(name, data) çağırırsa yük olayın params'ında gelir — akış event.name ve event.data okur (self.data yazılmaz)"
+        },
+        error: { payload: {}, reads: "cihazda sayfa yüklenemeyince (ağ hatası) yayılır, görünüm yer tutucu çizer; web'de pratikte gelmez (iframe gibi)" }
+    },
+    html: {
+        mount: NO_DATA,
+        message: {
+            payload: {},
+            reads: "belgenin window.ngApps.emit(name, data) çağrısı; yük olayın params'ındadır — akış event.name (ileti adı) ve event.data (veri) okur. actions satırının akışı ise fireEvent(key, data) ile koşar: event.name = key, event.data = veri"
+        }
+    },
+    map: {
+        mount: NO_DATA,
+        markerClick: { payload: { markerId: "string — dokunulan işaretçinin `id`si (boşsa listedeki sırası); makine markerId prop'una yazar (self.markerId). Başlığı ya da açıklaması olan işaretçide balon da açılır" } },
+        regionChange: {
+            payload: {
+                latitude: 'number — kullanıcının bıraktığı merkezin enlemi (6 basamak)',
+                longitude: 'number — merkezin boylamı (6 basamak, −180…180)',
+                zoom: 'number — web harita ölçeği (2 basamak, 1–19)'
+            },
+            reads: "yalnız kullanıcının sürüklemesi ya da yakınlaştırması bitince yayılır; akışın yazdığı görünüm ve kutu boyu değişimi yaymaz. Makine üç prop'u da yazar (self.latitude, self.longitude, self.zoom)"
+        },
+        press: {
+            payload: {
+                latitude: 'number — yerin enlemi: tek işaretçi varsa o işaretçi, yoksa görünümün merkezi',
+                longitude: 'number — yerin boylamı',
+                mapsUrl: "string — yeri cihazın harita uygulamasında açan adres (iOS Apple Haritalar https://maps.apple.com/?ll=…&q=<ad>, Android geo:<lat>,<lng>?q=…(<ad>), web Google Haritalar araması)"
+            },
+            reads: "işaretçi dışına dokunuşta yayılır (interactive: false önizlemede bütün yüzey). Makine YALNIZ mapsUrl'i düğüme yazar (self.mapsUrl) — koordinat yazılsaydı harita kayardı; koordinat event.data'dadır. Tarif: redirect isRaw: true, path: '<harita>.mapsUrl'"
+        }
+    },
+    adBanner: {
+        mount: NO_DATA,
+        load: {
+            payload: {
+                width: 'number — yüklenen reklamın genişliği (dp)',
+                height: 'number — yüklenen reklamın yüksekliği (dp)'
+            },
+            reads: 'yalnız mağaza sürümünde, reklam yüklenip çizilince yayılır'
+        },
+        fail: {
+            payload: {
+                code: "string — SDK hata kodu (`googleMobileAds/no-fill`, `googleMobileAds/network-error`…) ya da `unavailable`: derleme reklam taşımıyor (oynatıcı, web), ya da yerleşim bu platformda yok / banner değil",
+                message: 'string — hatanın açıklaması'
+            },
+            reads: "reklam çizilemeyince yayılır; kutu yer kaplamaz. Reklam alanını akışla gizlemek ya da yerine içerik koymak için kullanın. Mağaza sürümünde rıza yokken ya da SDK henüz başlamamışken YAYILMAZ"
+        },
+        click: { payload: {}, reads: 'kullanıcı reklama dokununca (yalnız mağaza sürümü)' },
+        open: { payload: {}, reads: 'reklam ekranı kaplayan bir katman açınca' },
+        close: { payload: {}, reads: 'kullanıcı reklam katmanından uygulamaya dönünce' }
+    },
+    markdown: {
+        mount: NO_DATA,
+        linkClick: {
+            payload: {
+                href: "string — dokunulan bağlantının ham adresi; şema süzülmeden gelir (dışarıda yalnız http(s), mailto, tel açılır)"
+            }
+        }
+    },
+    'app-bar': {
+        clickBack: NO_DATA,
+        clickMenu: NO_DATA,
+        clickAction: { payload: { key: 'string (eylemin key alanı; yoksa dizideki sırası)' } }
+    },
+    'safe-area': {
+        mount: NO_DATA
+    },
+    // Web `container` yalnız `mount` yayar; `click` mobile-only (plans/mobil-plantcare-acigi f-04, K1).
+    container: {
+        click: NO_DATA
+    },
+    // Arama varyantının "Vazgeç"i (plans/mobil-plantcare-acigi f-05): değer temizlenir, klavye kapanır.
+    textinput: {
+        cancel: NO_DATA
+    },
+    'scroll-view': {
+        mount: NO_DATA,
+        scrollEnd: NO_DATA,
+        refresh: NO_DATA,
+        scroll: {
+            payload: {
+                y: 'number — dikey kaydırma konumu (yatay kaydırıcıda x)',
+                contentHeight: 'number — içeriğin boyu (yatayda contentWidth)',
+                viewportHeight: 'number — görünen alanın boyu (yatayda viewportWidth)'
+            },
+            reads: '100 ms seyreltmeli; yalnız bu olaya akış bağlıyken yayılır. Düğüme scrollY (scrollX) de yazılır'
+        }
+    },
+    'grouped-list': {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                selectedIndex: 'number — dokunulan öğenin rows içindeki DÜZ indeksi (bölüm içi değil); aynı öğeye yeniden dokununca yayılmaz. Makine selectedIndex\'i yazar, akışta tıklanan satır <liste>.selectedItem'
+            }
+        },
+        itemPress: {
+            payload: {
+                index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
+                row: 'object (öğenin satır verisi)'
+            },
+            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (button, click\'i bağlı list-item) dokunuş onun click\'ine gider, itemPress yayılmaz; click\'i bağlı olmayan list-item basılamaz, dokunuş itemPress\'e gider'
+        },
+        swipe: {
+            payload: {
+                key: 'string (kaydırma eyleminin key alanı)',
+                index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
+                row: 'object (öğenin satır verisi)'
+            }
+        },
+        sectionPress: {
+            payload: {
+                key: 'string — bölüm anahtarı (tarih değerinde yerel gün YYYY-AA-GG)',
+                title: 'string — bölüm başlığı (anahtar; boş alanlı satırların bölümünde otherSectionTitle)',
+                count: 'number — bölümdeki öğe sayısı',
+                items: 'object[] — bölümdeki satırların verisi'
+            },
+            reads: 'bölüm başlığına dokununca; yük başlık şablonunun Section ifadesiyle aynı nesnedir'
+        },
+        selectionChange: {
+            payload: {
+                selectedIndices: 'number[] — seçili satırların rows içindeki DÜZ indeksleri, sıralı',
+                count: 'number — seçili satır sayısı'
+            },
+            reads: 'yalnız selectionMode: multiple (ya da longPressSelects ile açılınca); akış event.data.selectedIndices / event.data.count okur, düğümün selectedIndices/selectedItems değeri de yazılır'
+        }
+    },
+    eventcalendar: {
+        mount: NO_DATA,
+        dateClick: {
+            payload: { date: "string 'yyyy-MM-dd'", rows: 'object[] — o güne düşen kaynak satırlar (mobil)' },
+            reads: "self'e yazılmaz — event.data ile oku; ay ve hafta görünümünde güne dokununca"
+        },
+        eventClick: {
+            payload: { id: 'string', title: 'string', row: 'kaynak satırın TAMAMI' },
+            reads: "self'e yazılmaz — event.data ile oku; gün çizelgesinde bloğa dokununca"
+        },
+        monthChange: {
+            payload: {
+                month: 'number (1-TABANLI)',
+                year: 'number',
+                view: "'month' | 'week' | 'day'",
+                start: "string 'yyyy-MM-dd' (görünen ilk gün)",
+                end: "string 'yyyy-MM-dd' (görünen son gün)"
+            },
+            reads: "self'e yazılmaz — event.data ile oku; oklar, yatay kaydırma ve Bugün ile her görünümde"
+        },
+        viewChange: {
+            payload: { view: "'month' | 'week' | 'day'", start: "string 'yyyy-MM-dd'", end: "string 'yyyy-MM-dd'" },
+            reads: "self'e yazılmaz — event.data ile oku; görünüm düğmesiyle"
+        }
+    },
+    'floating-container': {
+        mount: NO_DATA
+    },
+    repeater: {
+        swipe: {
+            payload: {
+                key: 'string (kaydırma eyleminin key alanı)',
+                index: 'number (satırın sırası, 0 tabanlı)',
+                row: 'object (satırın verisi)'
+            }
+        },
+        itemPress: {
+            payload: {
+                index: 'number (satırın sırası, 0 tabanlı)',
+                row: 'object (satırın verisi)'
+            }
+        },
+        selectionChange: {
+            payload: {
+                selectedIndices: 'number[] — seçili satırların rows içindeki DÜZ indeksleri, sıralı',
+                count: 'number — seçili satır sayısı'
+            },
+            reads: 'yalnız selectionMode: multiple (ya da longPressSelects ile açılınca); akış event.data.selectedIndices / event.data.count okur, düğümün selectedIndices/selectedItems değeri de yazılır'
+        }
+    }
+};

package/dist/knowledge/mobileStore.js

@@ -0,0 +1,396 @@
+export const PACKAGE_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*(\.[a-zA-Z][a-zA-Z0-9_]*)+$/;
+export const SCHEME_PATTERN = /^[a-z][a-z0-9+.-]{2,}$/;
+export const VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+export const LOCALE_PATTERN = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8})?$/;
+export const COLOR_PATTERN = /^#[0-9a-fA-F]{6}$/;
+export const PERMISSION_KEY_PATTERN = /^[a-z][A-Za-z0-9]*$/;
+export const RESERVED_SCHEME = 'zeyrek';
+export const MAX_BUILD_NUMBER = 2_100_000_000;
+export const DISPLAY_NAME_MAX_LENGTH = 30;
+export const PERMISSION_TEXT_MAX_LENGTH = 500;
+export const KEYWORDS_MAX_LENGTH = 100;
+export const COPYRIGHT_MAX_LENGTH = 200;
+export const ORIENTATIONS = ['portrait', 'landscape', 'default'];
+export const USER_INTERFACE_STYLES = ['automatic', 'light', 'dark'];
+export const SPLASH_RESIZE_MODES = ['contain', 'cover'];
+export const RELEASE_STATUSES = ['draft', 'completed'];
+/** İznin mağaza derlemesindeki kipi (kök ADR 0010): kullanıma göre · her zaman · hiç. Anahtarları backend doğrular. */
+export const PERMISSION_MODES = ['auto', 'on', 'off'];
+/** Reklam ayarı (kök ADR 0012) — backend `MobileStoreSettingsValidator` / `MobileAdFormat` aynası. */
+export const AD_APP_ID_PATTERN = /^ca-app-pub-\d{16}~\d{10}$/;
+export const AD_UNIT_ID_PATTERN = /^ca-app-pub-\d{16}\/\d{10}$/;
+export const AD_UNIT_NAME_PATTERN = /^[a-z][A-Za-z0-9]{0,39}$/;
+export const AD_UNITS_MAX_COUNT = 40;
+export const AD_FORMATS = ['banner', 'interstitial', 'rewarded', 'rewardedInterstitial', 'appOpen'];
+/** Reklam açıkken taşınması gereken izin: iOS ATT (backend `MobileStoreSettings.AdsPermission`). */
+export const ADS_PERMISSION = 'tracking';
+export const LISTING_LIMITS = {
+    title: 30,
+    subtitle: 30,
+    shortDescription: 80,
+    description: 4000,
+    promoText: 170,
+    releaseNotes: 4000
+};
+export const URL_FIELDS = ['support', 'marketing', 'privacyPolicy', 'privacyChoices'];
+/** İlk derlemenin kilitlediği alanlar (`MobileStoreSettings.FieldsLockedByFirstBuild`) */
+export const LOCKABLE_FIELDS = ['bundleIdentifier', 'androidPackage', 'scheme', 'iosBuildNumber', 'androidVersionCode'];
+export const JAVA_KEYWORDS = new Set([
+    'abstract', 'assert', 'boolean', 'break', 'byte', 'case', 'catch', 'char', 'class', 'const', 'continue', 'default',
+    'do', 'double', 'else', 'enum', 'extends', 'final', 'finally', 'float', 'for', 'goto', 'if', 'implements', 'import',
+    'instanceof', 'int', 'interface', 'long', 'native', 'new', 'package', 'private', 'protected', 'public', 'return',
+    'short', 'static', 'strictfp', 'super', 'switch', 'synchronized', 'this', 'throw', 'throws', 'transient', 'try',
+    'void', 'volatile', 'while', 'true', 'false', 'null'
+]);
+/**
+ * Mağaza görseli yuvası (`mobile-store/{appId}/assets`) — kaynak backend `MobileStoreAssetKind.cs` ve
+ * `MobileStoreAssetValidator.cs`; Studio kopyası `store-assets.validation.ts`. Parite:
+ * `test/mobile-store-assets.test.ts` (plans/mobil-yayin-mcp g-01).
+ */
+export const ASSET_KINDS = ['icon', 'adaptiveForeground', 'adaptiveBackground', 'adaptiveMonochrome', 'splash', 'featureGraphic', 'screenshot', 'promo'];
+/** Derlemeye giren görseller dilsizdir (`MobileStoreAssetValidator.BuildKinds`); PNG zorunlu */
+export const BUILD_ASSET_KINDS = ['icon', 'adaptiveForeground', 'adaptiveBackground', 'adaptiveMonochrome', 'splash'];
+export const DEVICE_CLASSES = ['iphone69', 'ipad13', 'phone', 'tablet7', 'tablet10'];
+export const MAX_ASSET_BYTES = 10_485_760;
+export const MAX_IMAGES_PER_SLOT = 10;
+/**
+ * Cihaz sınıfı → `page_screenshot` `device` argümanı. Çıktı = width·scale × height·scale ve mağazanın
+ * kabul ettiği ölçüdür; Studio "Önizlemeden üret" aynı tabloyu kullanır (`screenshot-capture.ts`
+ * `CAPTURE_TARGETS`). iPhone 6.9" ve iPad 13" alfa kanalı kabul etmez: kare JPEG çekilir.
+ */
+export const SCREENSHOT_CAPTURE_DEVICES = {
+    iphone69: { width: 440, height: 956, scale: 3 },
+    ipad13: { width: 1032, height: 1376, scale: 2 },
+    phone: { width: 360, height: 720, scale: 3 },
+    tablet7: { width: 600, height: 960, scale: 2 },
+    tablet10: { width: 800, height: 1280, scale: 2 }
+};
+/** Beyan anahtarları (`MobileStoreSettings.*Declaration`); iOS appPrivacy, ötekiler Android */
+export const DECLARATION_KEYS = ['appPrivacy', 'dataSafety', 'contentRating', 'targetAudience', 'appAccess'];
+/**
+ * Yuva kuralının istek gitmeden denetlenen kısmı (`MobileStoreAssetValidator`): derleme görseli dil
+ * almaz, ekran görüntüsü cihaz sınıfı ister, öteki türler cihaz sınıfı almaz. Ölçü/biçim/alfa
+ * denetimi dosyanın içeriğine bakar ve backend'de kalır (422 gövdesi ajana olduğu gibi döner).
+ */
+export function assetSlotProblem(kind, locale, deviceClass) {
+    if (BUILD_ASSET_KINDS.includes(kind) && locale !== undefined) {
+        return `'${kind}' derlemeye giren görseldir ve dilsizdir — locale verilmez`;
+    }
+    if (kind === 'screenshot' && deviceClass === undefined) {
+        return `'screenshot' cihaz sınıfı ister — deviceClass: ${DEVICE_CLASSES.join(' | ')}`;
+    }
+    if (kind !== 'screenshot' && deviceClass !== undefined) {
+        return `deviceClass yalnız 'screenshot' içindir — '${kind}' için verilmez`;
+    }
+    if (locale !== undefined && !LOCALE_PATTERN.test(locale)) {
+        return `locale '${locale}' biçimsiz — ${LOCALE_PATTERN.source} ('tr', 'en-US')`;
+    }
+    return undefined;
+}
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const text = (value) => typeof value === 'string' ? value : '';
+const isBlank = (value) => text(value).trim().length === 0;
+/** Backend `EmailAddress()` (ASP.NET Core uyumlu): tek `@`, başta ve sonda değil */
+const isEmail = (value) => {
+    const index = value.indexOf('@');
+    return index > 0 && index !== value.length - 1 && index === value.lastIndexOf('@');
+};
+/** .NET `Uri.TryCreate(Absolute)` + `https` + host; `https:host` (çift eğik çizgisiz) reddedilir */
+const isHttpsUrl = (value) => {
+    if (!/^https:\/\//i.test(value.trim()))
+        return false;
+    try {
+        const url = new URL(value);
+        return url.protocol === 'https:' && url.hostname.length > 0;
+    }
+    catch {
+        return false;
+    }
+};
+/** Biçim hataları: backend `PUT`'u 422 ile reddedecek her alan (alan yolu = backend `errorFields` anahtarı). */
+export function storeSettingsFormatErrors(settings) {
+    const errors = [];
+    const add = (field, message) => errors.push({ field, message });
+    const displayName = settings.displayName;
+    if (isBlank(displayName))
+        add('displayName', 'boş olamaz');
+    else if (text(displayName).length > DISPLAY_NAME_MAX_LENGTH)
+        add('displayName', `en çok ${DISPLAY_NAME_MAX_LENGTH} karakter`);
+    for (const field of ['bundleIdentifier', 'androidPackage']) {
+        const value = text(settings[field]);
+        if (isBlank(value))
+            add(field, 'boş olamaz');
+        else if (!PACKAGE_NAME_PATTERN.test(value))
+            add(field, `ters alan adı biçiminde olmalı (ör. com.firma.uygulama): ${PACKAGE_NAME_PATTERN.source}`);
+    }
+    const keyword = text(settings.androidPackage).split('.').find(segment => JAVA_KEYWORDS.has(segment));
+    if (keyword)
+        add('androidPackage', `'${keyword}' segmenti Java anahtar sözcüğü — Android paket adında kullanılamaz`);
+    const scheme = text(settings.scheme);
+    if (isBlank(scheme))
+        add('scheme', 'boş olamaz');
+    else if (!SCHEME_PATTERN.test(scheme))
+        add('scheme', `küçük harfle başlar, en az 3 karakter, yalnız a-z 0-9 + . -: ${SCHEME_PATTERN.source}`);
+    else if (scheme === RESERVED_SCHEME)
+        add('scheme', `'${RESERVED_SCHEME}' oynatıcı uygulamanın şeması — mağaza derlemesi alamaz`);
+    const version = text(settings.version);
+    if (isBlank(version))
+        add('version', 'boş olamaz');
+    else if (!VERSION_PATTERN.test(version))
+        add('version', 'MAJOR.MINOR.PATCH biçiminde olmalı, öndeki sıfır yok (ör. 1.2.0)');
+    for (const field of ['iosBuildNumber', 'androidVersionCode']) {
+        const value = settings[field];
+        if (value !== undefined && value !== null && (typeof value !== 'number' || !Number.isInteger(value) || value < 0 || value > MAX_BUILD_NUMBER)) {
+            add(field, `0 … ${MAX_BUILD_NUMBER} arası tam sayı`);
+        }
+    }
+    const choices = [
+        ['orientation', ORIENTATIONS],
+        ['userInterfaceStyle', USER_INTERFACE_STYLES],
+        ['splashResizeMode', SPLASH_RESIZE_MODES]
+    ];
+    for (const [field, allowed] of choices) {
+        if (!allowed.includes(text(settings[field])))
+            add(field, `kabul edilen değerler: ${allowed.join(' | ')}`);
+    }
+    for (const field of ['adaptiveIconBackground', 'splashBackgroundColor']) {
+        if (!COLOR_PATTERN.test(text(settings[field])))
+            add(field, '#RRGGBB biçiminde renk olmalı');
+    }
+    for (const [key, value] of Object.entries(isObject(settings.permissions) ? settings.permissions : {})) {
+        if (!PERMISSION_KEY_PATTERN.test(key))
+            add(`permissions.${key}`, `modül anahtarı ${PERMISSION_KEY_PATTERN.source} biçiminde olmalı (ör. camera)`);
+        else if (value !== null && (isBlank(value) || text(value).length > PERMISSION_TEXT_MAX_LENGTH))
+            add(`permissions.${key}`, `null ya da 1–${PERMISSION_TEXT_MAX_LENGTH} karakter izin açıklaması`);
+    }
+    for (const [key, value] of Object.entries(isObject(settings.permissionModes) ? settings.permissionModes : {})) {
+        if (!PERMISSION_KEY_PATTERN.test(key))
+            add(`permissionModes.${key}`, `izin anahtarı ${PERMISSION_KEY_PATTERN.source} biçiminde olmalı; anahtarlar: mobile_store_get { detail: ['permissions'] }`);
+        else if (!PERMISSION_MODES.includes(text(value)))
+            add(`permissionModes.${key}`, `kabul edilen değerler: ${PERMISSION_MODES.join(' | ')}`);
+    }
+    const launchPermissions = Array.isArray(settings.launchPermissions) ? settings.launchPermissions : [];
+    for (const [index, key] of launchPermissions.entries()) {
+        if (!PERMISSION_KEY_PATTERN.test(text(key)))
+            add(`launchPermissions.${String(key)}`, `izin anahtarı ${PERMISSION_KEY_PATTERN.source} biçiminde olmalı; anahtarlar: mobile_store_get { detail: ['permissions'] }`);
+        else if (launchPermissions.indexOf(key) !== index)
+            add(`launchPermissions.${String(key)}`, 'anahtar iki kez yazılmış');
+        else if (isObject(settings.permissionModes) && settings.permissionModes[text(key)] === 'off')
+            add(`launchPermissions.${String(key)}`, `permissionModes.${String(key)} 'off': derlemeye dahil edilmeyen izin açılışta sorulamaz — kipi auto ya da on yapın ya da anahtarı listeden çıkarın`);
+    }
+    for (const [locale, listing] of Object.entries(isObject(settings.listing) ? settings.listing : {})) {
+        if (!LOCALE_PATTERN.test(locale)) {
+            add(`listing.${locale}`, "dil kodu geçersiz (ör. 'tr', 'en-US')");
+            continue;
+        }
+        const entry = isObject(listing) ? listing : {};
+        for (const [field, max] of Object.entries(LISTING_LIMITS)) {
+            if (text(entry[field]).length > max)
+                add(`listing.${locale}.${field}`, `en çok ${max} karakter (${text(entry[field]).length} verildi)`);
+        }
+        const keywords = Array.isArray(entry.keywords) ? entry.keywords.map(text).join(',') : '';
+        if (keywords.length > KEYWORDS_MAX_LENGTH)
+            add(`listing.${locale}.keywords`, `virgülle birleşik en çok ${KEYWORDS_MAX_LENGTH} karakter (${keywords.length} verildi)`);
+    }
+    const urls = isObject(settings.urls) ? settings.urls : {};
+    for (const field of URL_FIELDS) {
+        if (!isBlank(urls[field]) && !isHttpsUrl(text(urls[field])))
+            add(`urls.${field}`, 'boş ya da mutlak https:// adres olmalı');
+    }
+    const play = isObject(settings.play) ? settings.play : {};
+    const review = isObject(settings.review) ? settings.review : {};
+    const apple = isObject(settings.apple) ? settings.apple : {};
+    if (!isBlank(play.contactEmail) && !isEmail(text(play.contactEmail)))
+        add('play.contactEmail', 'geçerli e-posta olmalı');
+    if (play.releaseStatus !== undefined && play.releaseStatus !== null && !RELEASE_STATUSES.includes(text(play.releaseStatus)))
+        add('play.releaseStatus', `kabul edilen değerler: ${RELEASE_STATUSES.join(' | ')}`);
+    if (!isBlank(review.email) && !isEmail(text(review.email)))
+        add('review.email', 'geçerli e-posta olmalı');
+    if (text(apple.copyright).length > COPYRIGHT_MAX_LENGTH)
+        add('apple.copyright', `en çok ${COPYRIGHT_MAX_LENGTH} karakter`);
+    const ads = isObject(settings.ads) ? settings.ads : {};
+    const units = (Array.isArray(ads.units) ? ads.units : []).filter(isObject);
+    const appIdExample = 'ca-app-pub-0000000000000000~0000000000';
+    const unitIdExample = 'ca-app-pub-0000000000000000/0000000000';
+    for (const field of ['iosAppId', 'androidAppId']) {
+        if (!isBlank(ads[field]) && !AD_APP_ID_PATTERN.test(text(ads[field])))
+            add(`ads.${field}`, `AdMob App ID biçiminde olmalı (${appIdExample}; birim kimliğindeki '/' değil '~')`);
+    }
+    if (ads.enabled === true && isBlank(ads.iosAppId) && isBlank(ads.androidAppId))
+        add('ads.enabled', 'reklam açıkken en az bir platformun AdMob App ID\'si gerekir (ads.iosAppId / ads.androidAppId)');
+    if (units.length > AD_UNITS_MAX_COUNT)
+        add('ads.units', `en çok ${AD_UNITS_MAX_COUNT} yerleşim`);
+    const invalidNames = [...new Set(units.map(unit => text(unit.name)).filter(name => !AD_UNIT_NAME_PATTERN.test(name) || units.filter(unit => text(unit.name) === name).length > 1))];
+    for (const name of invalidNames)
+        add(`ads.units.${name}`, `yerleşim adı ${AD_UNIT_NAME_PATTERN.source} biçiminde ve tekil olmalı (adBanner.unit ve ad-show.value bu adla anar)`);
+    for (const unit of units.filter(entry => !invalidNames.includes(text(entry.name)))) {
+        const name = text(unit.name);
+        if (!AD_FORMATS.includes(text(unit.format)))
+            add(`ads.units.${name}.format`, `kabul edilen biçimler: ${AD_FORMATS.join(' | ')}`);
+        for (const platform of ['ios', 'android']) {
+            if (!isBlank(unit[platform]) && !AD_UNIT_ID_PATTERN.test(text(unit[platform])))
+                add(`ads.units.${name}.${platform}`, `AdMob reklam birimi kimliği biçiminde olmalı (${unitIdExample})`);
+        }
+        if (isBlank(unit.ios) && isBlank(unit.android))
+            add(`ads.units.${name}`, 'en az bir platformun reklam birimi kimliği gerekir (ios / android)');
+    }
+    if (!isBlank(ads.appOpenUnit) && text(units.find(unit => text(unit.name) === text(ads.appOpenUnit))?.format) !== 'appOpen')
+        add('ads.appOpenUnit', `'${text(ads.appOpenUnit)}' appOpen biçiminde tanımlı bir yerleşim değil`);
+    if (ads.enabled === true && isObject(settings.permissionModes) && settings.permissionModes[ADS_PERMISSION] === 'off')
+        add(`permissionModes.${ADS_PERMISSION}`, "reklam açıkken izleme izni (tracking) kapatılamaz — iOS'ta kişiselleştirilmiş reklam ATT ister; kipi auto ya da on yapın");
+    return errors;
+}
+/**
+ * Mağazaya YÜKLEME (testflight/internal) için boş kalan gizli olmayan alanlar — `build` hedefini
+ * etkilemez, taslak kaydı engellemez. Kesin liste ön kontroldür (P-01, varsayılan dil projeden gelir).
+ */
+export function storeSettingsMissingForUpload(settings) {
+    const urls = isObject(settings.urls) ? settings.urls : {};
+    const apple = isObject(settings.apple) ? settings.apple : {};
+    const categories = isObject(apple.categories) ? apple.categories : {};
+    const play = isObject(settings.play) ? settings.play : {};
+    const listings = Object.values(isObject(settings.listing) ? settings.listing : {}).filter(isObject);
+    const missing = [];
+    if (!listings.some(listing => !isBlank(listing.title) && !isBlank(listing.description)))
+        missing.push('listing.<dil>.title + description');
+    if (isBlank(urls.privacyPolicy))
+        missing.push('urls.privacyPolicy');
+    if (isBlank(categories.primary))
+        missing.push('apple.categories.primary (iOS)');
+    if (isBlank(apple.copyright))
+        missing.push('apple.copyright (iOS)');
+    if (isBlank(play.contactEmail))
+        missing.push('play.contactEmail (Android)');
+    return missing;
+}
+/**
+ * Backend `PUT` tam satırı yazar: gönderilmeyen alan varsayılana döner (`displayName` boşalır → 422,
+ * `listing` silinir). Yama bu yüzden okunan kaydın üstüne birleştirilir: düz nesneler alan alan,
+ * dizi ve skaler değer yerine geçer. Sayaçlar yalnız yamada varsa gider — okunan sayacı geri yazmak,
+ * arada derleme başlamışsa kilit ihlali (422) üretirdi (`null` = değiştirme).
+ */
+export function mergeStoreSettings(current, patch) {
+    const merge = (base, overlay) => {
+        if (!isObject(base) || !isObject(overlay))
+            return overlay;
+        return Object.fromEntries([...new Set([...Object.keys(base), ...Object.keys(overlay)])]
+            .map(key => [key, key in overlay ? merge(base[key], overlay[key]) : base[key]]));
+    };
+    const merged = merge(current, patch);
+    for (const counter of ['iosBuildNumber', 'androidVersionCode']) {
+        if (!(counter in patch))
+            delete merged[counter];
+    }
+    return merged;
+}
+/** Yamanın gerçekten değiştirdiği yaprak alan yolları (`listing.tr.title`, `bundleIdentifier`). */
+export function changedStoreFields(current, patch, prefix = '') {
+    return Object.entries(patch).flatMap(([key, value]) => {
+        const before = current[key];
+        const path = `${prefix}${key}`;
+        if (isObject(value) && isObject(before))
+            return changedStoreFields(before, value, `${path}.`);
+        return JSON.stringify(value) === JSON.stringify(before ?? null) ? [] : [path];
+    });
+}
+const guide = "platform_guide('mobile-publish')";
+/**
+ * MOB-023 — taşınan küme derlemede donar: kullanılan izin mağazadaki son derlemede (backend'in
+ * `missingFromStoreBuilds`'i) yoksa kurulu uygulama onu isteyemez. Production kullanıyorsa bugünün sorunudur;
+ * yalnız okunan ortam kullanıyorsa dağıtımdan sonra olacaktır. Kip `off` ise sessiz: yeni derleme de taşımaz
+ * (o çelişkiyi P-12 söyler). Kullanılmayan iznin derlemede olmaması budamanın işidir.
+ */
+export function permissionStoreBuildWarnings(permissions, environment) {
+    return permissions.flatMap((entry) => {
+        const builds = (Array.isArray(entry.missingFromStoreBuilds) ? entry.missingFromStoreBuilds : []).filter(isObject);
+        if (builds.length === 0 || entry.mode === 'off')
+            return [];
+        const names = builds.map(build => `${text(build.platform)} ${text(build.appVersion)} (${String(build.buildNumber)})`).join(', ');
+        const productionUsage = isObject(entry.build) && typeof entry.build.usageCount === 'number' ? entry.build.usageCount : 0;
+        const usage = Array.isArray(entry.usage) ? entry.usage.length : 0;
+        if (productionUsage > 0)
+            return [`${text(entry.key)}: production kullanıyor ama mağazadaki son derleme taşımıyor (${names}) — kurulu uygulamada izin istenemez ('unavailable'); yeni bir mağaza derlemesi gerekir (MOB-023, ${guide}).`];
+        return usage > 0
+            ? [`${text(entry.key)}: ${environment} kullanıyor, mağazadaki son derleme taşımıyor (${names}) — production'a dağıtıldıktan sonra yeni bir mağaza derlemesi gerekir (MOB-023, ${guide}).`]
+            : [];
+    });
+}
+/**
+ * MOB-025 — açılışta sorma kabuğun ayrı bir yeteneğidir (`shell.carriesLaunchPermissions`). Yayındaki kabuk onu
+ * taşımıyorsa ayar saklanır ama derleme sormaz: liste manifeste yazılmaz. Eski backend alanı söylemez; o zaman
+ * iddia edilmez.
+ */
+export function permissionLaunchShellWarnings(permissions, shell) {
+    const asked = permissions.filter(entry => entry.askOnLaunch === true).map(entry => text(entry.key));
+    if (asked.length === 0 || !isObject(shell) || shell.carriesLaunchPermissions !== false)
+        return [];
+    return [`${asked.join(', ')}: açılışta sorulacak diye ayarlı ama yayındaki kabuk paketi (${text(shell.version)}) açılışta izin sormuyor — ayar saklanır, mağaza derlemesi sormaz (ön kontrol P-12 uyarır). Daha yeni bir kabuk yayınlanana kadar izni bir akış adımından isteyin (MOB-025, ${guide}).`];
+}
+/**
+ * MOB-027 — izleme izni (kök ADR 0011): mağaza derlemesi `tracking`'i taşıyorsa App Store Connect App Privacy'de
+ * "Device ID — Used to Track You" ve Play Data safety'de "Advertising ID" beyanı insanın işidir; Apple izin penceresinden
+ * önce teşvik ya da ön pencereyi yasaklar (5.1.2). Taşınmayan izin için söylenecek bir şey yoktur.
+ */
+export function trackingDeclarationWarnings(permissions) {
+    const tracking = permissions.find(entry => entry.key === ADS_PERMISSION);
+    return isObject(tracking?.build) && tracking.build.carried === true
+        ? [`${ADS_PERMISSION}: mağaza derlemesi izleme iznini (ATT) taşıyor — App Store Connect App Privacy'de "Device ID — Used to Track You", Play Console Data safety'de "Advertising ID" beyanı insanın işidir; izin penceresinden önce ödül/teşvik ya da kendi ön pencerenizi göstermeyin (App Store 5.1.2). Sonuçtaki advertisingId yalnız granted iken doludur (MOB-027, ${guide}).`]
+        : [];
+}
+/**
+ * MOB-026 — reklam açıkken ajanın bilmesi gereken, kayıttan okunabilen durumlar (kök ADR 0012). Satırlar `<konu>: …`
+ * biçimindedir. Test kipi mağaza yüklemesinde de test reklamı gösterir (ön kontrol P-13 `manual`); yerleşimsiz reklam
+ * SDK'yı bağlar ama hiçbir şey göstermez; App ID'si verilmiş platformda birimi olmayan yerleşim o platformda yer kaplamaz
+ * (`adBanner`) ya da `invalid` döner (`ad-show`). Beyan satırı her zaman gelir: App Privacy, Data safety ve AdMob rıza
+ * mesajı konsolda insanın işidir, gateway yazamaz.
+ */
+export function adsStoreWarnings(settings) {
+    const ads = isObject(settings.ads) ? settings.ads : {};
+    if (ads.enabled !== true)
+        return [];
+    const units = (Array.isArray(ads.units) ? ads.units : []).filter(isObject);
+    const platforms = [['ios', 'iOS', ads.iosAppId], ['android', 'Android', ads.androidAppId]];
+    const lines = [];
+    if (ads.testMode !== false)
+        lines.push(`testMode: test kipi açık — mağaza yüklemesinde de gerçek reklam yerine Google test reklamı gösterilir; yayından önce ads.testMode: false (ön kontrol P-13, MOB-026, ${guide}).`);
+    if (units.length === 0)
+        lines.push(`yerleşim: reklam açık ama hiç yerleşim yok — SDK bağlanır, hiçbir reklam gösterilmez; ads.units'e banner ya da tam ekran yerleşim ekleyin (MOB-026, ${guide}).`);
+    for (const unit of units) {
+        const missing = platforms.filter(([field, , appId]) => !isBlank(appId) && isBlank(unit[field])).map(([, label]) => label);
+        if (missing.length > 0)
+            lines.push(`${text(unit.name)}: ${missing.join(' ve ')}'de birim yok — o platformda adBanner yer kaplamaz, ad-show 'invalid' döner (MOB-026).`);
+    }
+    lines.push(`beyan: reklam izleme sayılır — App Store Connect App Privacy'de "Device ID — Used to Track You" (ve reklam verisi), Play Console Data safety'de "Advertising ID", AdMob konsolunda rıza (GDPR/UMP) mesajı insanın işidir; gateway yazamaz. Beyanı kullanıcı onaylayınca mobile_store_update { declarations } (MOB-026, ${guide}).`);
+    return lines;
+}
+/** MOB-022 — `definition` birleşmiş kayıttır; biçim hatası backend'in 422'siyle aynı ret (block), eksik alan uyarı. */
+export const mobileStorePolicyRules = [
+    {
+        id: 'MOB-022',
+        module: 'mobileStore',
+        appliesTo: ['update'],
+        sourceRef: 'MobileStoreSettingsValidator (zeyrek-backend/docs/mobile-builds.md §Doğrulama tablosu); yükleme eksikleri MobileStorePreflightService P-01',
+        check: (definition) => {
+            const errors = storeSettingsFormatErrors(definition);
+            const missing = storeSettingsMissingForUpload(definition);
+            return [
+                ...(errors.length > 0
+                    ? [{
+                            ruleId: 'MOB-022',
+                            severity: 'block',
+                            message: `Mağaza ayarı biçimsiz — backend PUT'u 422 ile reddeder, hiçbir alan yazılmaz: ${errors.map(error => `${error.field}: ${error.message}`).join(' · ')}`,
+                            guide
+                        }]
+                    : []),
+                ...(missing.length > 0
+                    ? [{
+                            ruleId: 'MOB-022',
+                            severity: 'warn',
+                            message: `Mağazaya yükleme (testflight/internal) için eksik: ${missing.join(', ')}. Kayıt taslak olarak yazılır ve 'build' hedefini etkilemez; kesin liste mobile_build_start { dryRun: true } ön kontrolündedir. Görseller mobile_asset_create ile, beyanlar kullanıcının onayıyla mobile_store_update { declarations } ile yazılır; gizli bilgi MCP'den yazılmaz — Studio › Yayın › Hesaplar.`,
+                            guide
+                        }]
+                    : [])
+            ];
+        }
+    }
+];