@appaflytech/zeyrek-ai-mcp 0.0.41 → 0.0.43

package/dist/knowledge/mobileComponentCatalog.js

@@ -1,3 +1,35 @@
+import { MOTION_DEFAULTS, MOTION_EASING, MOTION_ENTER, MOTION_EXIT, MOTION_LOOP, MOTION_OUTSIDE_SHELL, MOTION_PRESS, MOTION_RANGES, MOTION_TRANSITION } from './motionResolve.js';
+/**
+ * `motionStyle` düğüm kabuğunun grubudur (frontend `catalog-schema.ts`, ADR 0018): not kayıt başına değil burada tek
+ * kez yazılır. Değer kümeleri, aralıklar ve grubu taşımayan tipler aynadan okunur (`motionResolve.ts`), elle
+ * kopyalanmaz. Kabuğun uygulaması: frontend `renderer/MotionShell.tsx` (ölçüldü 2026-10-08: oyun alanı, `/dev`, iOS).
+ */
+const motionChoices = (values) => values.filter(value => value !== 'none').map(value => `\`${value}\``).join(', ');
+const MOTION_STYLE_NOTE = `\`motionStyle\` (mobile özgü; panelde Motion bölümü; içeriğini kabuğun dışında çizen ${MOTION_OUTSIDE_SHELL.map(type => `\`${type}\``).join(', ')} dışında HER bileşende) düğümün hareketidir: \`enter\` (${motionChoices(MOTION_ENTER)}), ` +
+    `\`exit\` (${motionChoices(MOTION_EXIT)}), \`loop\` (${motionChoices(MOTION_LOOP)}), \`transition\` (${motionChoices(MOTION_TRANSITION)}), ` +
+    `\`press\` (${motionChoices(MOTION_PRESS)}), \`layout\` (true/false: kardeş eklenip çıkınca kayarak yer değiştirir), ` +
+    `\`duration\` ${MOTION_RANGES.duration.join('–')} ms, \`delay\` ${MOTION_RANGES.delay.join('–')} ms, \`easing\` (${MOTION_EASING.map(value => `\`${value}\``).join(', ')}). ` +
+    `Seçenekli alanlarda \`none\` hareket yok demektir. Yazılmayan alan yok sayılır (süre ${MOTION_DEFAULTS.duration} ms, eğri \`${MOTION_DEFAULTS.easing}\`) ve şema bu değerleri düğüme YAZMAZ — siz de yazmayın: ` +
+    `\`loop\` süre ve eğri yazılmamışsa kendi önayarını kullanır (dönme 1 sn doğrusal, nabız 2 sn, zıplama 1 sn), yazılmışsa onu. \`press\` süresi kendinindir (150 ms). ` +
+    `Yalnız süre/gecikme/eğri yazılmış grup hareket değildir. Tanınmayan alan ve küme/aralık dışı değer atlanır (MOB-028). ` +
+    `Düğüm kabuğu uygular; \`/dev\`'de ve cihazda oynar: \`enter\` düğüm çizilince, \`exit\` gizlenince (\`isHidden\`), \`layout\` bir kardeş gizlenip görününce, \`transition\` kabuğun stili değişince (ör. akış \`surfaceStyle\`'ı yazınca). ` +
+    `Giriş biter, döngü sonra başlar. Döngü ve \`press\`, \`surfaceStyle\`'ın döndürme/ölçek/kaydırma/opaklığının ÜSTÜNE biner. ` +
+    `Kanvasta donuktur (Studio araç çubuğundaki Oynat seçili düğümün girişini ya da döngüsünü bir kez oynatır); cihazın/tarayıcının 'hareketi azalt' ayarında ve \`page_screenshot\`'ın varsayılan (donuk) karesinde durur — görmek için \`motion: 'play'\`. ` +
+    `Çözümü \`page_runtime_get({ resolveStyles: true })\` \`nativeStyle.motion\`'da verir. Web şemasında yoktur.`;
+/**
+ * `heroTag` taşıyan tipler. Kaynak: frontend `packages/ng-apps-ui-native/src/catalog-schema.ts` `HERO_TAG_TYPES`
+ * (parite: `test/mobile-component-parity.test.ts` — katalogda alanı taşıyan tiplerle aynı küme).
+ */
+export const MOBILE_HERO_TAG_TYPES = ['container', 'image'];
+/**
+ * `heroTag` düğüm kabuğunun alanıdır (frontend ADR 0022): not tek yerde yazılır, taşıyan tiplerin kaydına oradan girer.
+ * Ölçüm: iOS simülatörü 2026-10-10 (`zeyrek-frontend/docs/features/mobile-runtime.md` §Paylaşılan öğe).
+ */
+const HERO_TAG_NOTE = "Paylaşılan öğe etiketi (mobile özgü; panelde 'Shared element' bölümü). Bu düğüme ya da içine dokunulup bir `redirect` adımıyla başka sayfaya gidilince hedef sayfa bu düğümün kutusundan BÜYÜYEREK açılır, geri dönüşte o kutuya küçülür (iOS'un yakınlaşma geçişi: sayfanın tamamı büyür, yalnız öğe uçmaz). " +
+    'Hedef sayfada AYNI etiketi taşıyan düğüm açılışın hizalandığı kutudur — iki sayfaya aynı metni yazın; hedefte eş yoksa sayfa yine kaynaktan büyür, hizalanacak kutu olmaz. ' +
+    "Kaynak, dokunuşun içinde başladığı en içteki etiketli düğümdür; dokunuş etiketli bir düğümün dışındaysa dokunulan liste satırının (ya da `click`i bağlı kabın) ilk KURULAN etiketli düğümü (kardeşlerde belge sırası; iç içe iki etiketli düğümde İÇTEKİ — satıra tek etiket yazın). Yani satıra dokunmak satırdaki etiketli görselden açar ve etiketi satıra özgü yazmak GEREKMEZ; hedef sayfada birden çok etiketli düğüm varsa doğrusunu ifade seçtirir (satırda `{{ 'urun-' + item.id }}`, hedefte `{{ 'urun-' + Page.queryParams.id }}`). Hedef etiketini SORGU PARAMETRESİNDEN türetin: sonradan yüklenen veriye bağlı etiket ilk çizimde boştur, değer gelince düğüm yeniden kurulur (mount akışları ikinci kez koşar). " +
+    "YALNIZ iOS 18+ cihazda oynar: Android'de, `/dev` önizlemesinde, `page_screenshot`'ta ve kanvasta sayfa adımın geçişiyle açılır (`redirect.transition`, MOB-029). Etiketli öğeden açılan sayfada adımın geçişi oynamaz (yakınlaşma yerine geçer); `modal` sunumda da oynar; sekme değişiminde, `replace` sunumda ve cihazın 'hareketi azalt' ayarında oynamaz. " +
+    "Hedef düğümün `motionStyle.enter`'ı oynamaz (öncelik yakınlaşmanın); hedef olmayan düğümünki oynar. Aynı sayfada aynı statik etiketi iki düğüme yazmak KAYNAK sayfada olağandır (aynı etiketli kartlar); HEDEF sayfada hizalama kutusu tektir ve ilk çizilen düğüm hizalanır — yazım bunu bilgi notuyla söyler (MOB-030). Eşi olmayan etiket için uyarı yoktur: sayfanın etiketleri (layout'unkiler dahil) `page_runtime_get` özetinde `heroTags`'te okunur — iki sayfayı oradan karşılaştırın.";
 /**
  * Bütün mobil komponentler için geçerli kurallar. Kayıt başına tekrarlanmaz;
  * okuyucu (`component_get`) bu notları `mobileNotes`'a ekler
@@ -5,6 +37,7 @@
  * (MOB-002) notları kural koduyla birlikte orada durur, burada tekrarlanmaz.
  */
 export const MOBILE_COMPONENT_NOTES = [
+    MOTION_STYLE_NOTE,
     "Tasarım kipinde (Studio kanvası) alanlar yazılamaz ve düğmeler basılamaz: dokunuş kanvasın seçim jestidir.",
     "Olay yükleri web ile AYNI sözleşmedir (`componentEvents.ts`): alanlar `change`/`changed`/`enter`/`focus`/`blur`, seçim bileşenleri `change` + `checked`/`unchecked`, katmanlar kapanışta `change { isOpen: false }` ve `open`/`close` yayar; `type: submit` düğme `click` yaymaz, üstteki `form`un `submit`ini tetikler (`formId` varsa o formun). Form doğrulaması web ile AYNIDIR (2026-09-28): alanların `validations`'ı ve formun koşullu `validations`'ı gönderimde koşar, geçersiz form `submit` YAYMAZ, alan `isInvalid`/`invalidText` alır, hatalar `form-validation-errors`'a yazılır; ilk gönderimden sonra her değişimde alan yeniden doğrulanır. Doğrulamayı akışta elle kurmayın. Mobile özgü `form.showValidState` dolu ve geçerli alana ✓ verir. `required` işaretsiz onay kutusunu değer sayar (web kuralı) — 'kabul et' formun koşullu kuralıdır: `{ element: 'kosullar', condition: '!kosullar.value', message }`.",
     "Bileşenler shadcn/ui görünümünde çizilir (react-native-reusables ilkelleri, NativeWind); renk ve köşe yine PROJE TEMASINDAN gelir: `--ng-*` değişkenleri shadcn token'larına (`--primary`, `--secondary`, `--muted`, `--destructive`, `--border`, `--input`, `--ring`…) ve köşe ölçeğine köprüyle çevrilir (`shadcn-vars.ts`), koyu kip aynı köprünün ikinci çözümüdür. Tema değişince web ve mobil birlikte hareket eder; web sayfası kendi bileşen ailesiyle çizildiği için iki platformun görünüm farkı bilinçlidir. Ölçü (alan yüksekliği, punto, iç boşluk) temanın `--ng-form-*` değişkenlerinden gelir. Yazı AİLESİ köprüde yoktur: temanın ailesi alanlarda (metin, sayı, parola, açılır liste), başlıklarda (`app-bar`, `form`, `modal`/`drawer`, boş durum) ve sekme çubuğunda uygulanır; `text` ve düğme etiketi ata kabın `typographyStyle` ailesini, o da yoksa platform yazı tipini kullanır; alan, anahtar ve onay kutusu etiketleri HER ZAMAN platform yazı tipiyle çizilir.",
@@ -27,11 +60,30 @@ export const MOBILE_STATE_FLAG_NOTES = {
  * sabit katmanlar, alt ağaçları hizaya girmez. İçerik genişlikli: genişliği içeriğinden gelen
  * yapraklar, sağ kenar sapması sayılmaz.
  */
-export const MOBILE_DROPPABLE_TYPES = ['carousel', 'collapsible-container', 'container', 'drawer', 'floating-container', 'form', 'grouped-list', 'modal', 'repeater', 'safe-area', 'scroll-view', 'stack', 'tabs', 'tooltip', 'view', 'widget-area'];
+export const MOBILE_DROPPABLE_TYPES = ['carousel', 'collapsible-container', 'container', 'drawer', 'flip-card', 'floating-container', 'form', 'grouped-list', 'modal', 'repeater', 'safe-area', 'scroll-view', 'stack', 'swipeable-stack', 'tabs', 'tooltip', 'view', 'widget-area'];
 export const MOBILE_OUT_OF_FLOW_TYPES = ['app-bar', 'drawer', 'fab', 'floating-container', 'modal', 'toast'];
 export const MOBILE_INTRINSIC_WIDTH_TYPES = ['avatar', 'badge', 'icon', 'rating', 'text', 'timer'];
 /** Yalnız davranış ekleyen kap: çizimi çocuğundan ibarettir, kendi boşluğu içeriği içeri iter (mizanpaj S6). */
 export const MOBILE_TRANSPARENT_WRAPPER_TYPES = ['tooltip'];
+/**
+ * Satır listeleri: çocuklarını makinenin satır kapsamıyla (`Row` / `item`, `_repeaterValues`) satır başına çizen tipler.
+ * Kaynak: frontend `packages/ng-apps-flow/src/machine/handlers/row-list-type.ts` `ROW_LIST_TYPES` (parite:
+ * `test/normalize.test.ts`). Kapsam tek seviyedir, bu yüzden biri ötekinin alt ağacına yazılamaz (PAGE-013,
+ * `normalize.ts` `nestedRepeaterNodes`; plans/mobil-animasyon-sistemi faz 04 F-3).
+ */
+export const MOBILE_ROW_LIST_TYPES = ['repeater', 'grouped-list', 'swipeable-stack'];
+const ROW_LIST_NESTING_NOTE = `Satır listeleri (${MOBILE_ROW_LIST_TYPES.map(type => `\`${type}\``).join(', ')}) birbirinin İÇİNE konmaz: satır kapsamı tek seviyedir, MCP yazımı \`PAGE-013\` ile reddeder.`;
+/**
+ * Sabit görünümlü bileşenin BİLEREK boş bırakılabilen görünümü (`view` çocukları içindeki sırası): veri yokken açılan
+ * görünüm. Boş bırakılınca liste boşken hiçbir şey çizilmez — tasarım tercihidir, boş kap değil (MOB-018;
+ * plans/mobil-animasyon-sistemi faz 04 F-4). `swipeable-stack`'te aynı görünüm `loop` kapalıyken son karttan sonra da
+ * açılır: boş bırakılınca deste bitince alan boş kalır; aynı tercih, not düşülmez. Bu görünüm satır kapsamında da
+ * değildir: içindeki liste iç içe sayılmaz (PAGE-013, `nestedRepeaterNodes` — yalnız mobil profilde; web listesinin
+ * görünümü yoktur). Kaynak: frontend şemalarının `views` prop'undaki `empty` seçeneği
+ * (`packages/ng-apps-ui-native/components.json`; parite: `test/mobile-layout-lint.test.ts`). `flip-card` yüzleri burada
+ * yoktur: boş yüz ekranda boş kutudur.
+ */
+export const MOBILE_OPTIONAL_VIEW_INDEX = { repeater: 1, 'swipeable-stack': 1 };
 export const mobileComponentKnowledge = {
     container: {
         summary: 'Flex akışı; mobil sayfanın tek yerleşim kabı.',
@@ -42,7 +94,8 @@ export const mobileComponentKnowledge = {
             'Kutu modeli web ile AYNI kural ve varsayılanlarla çizilir (`appearance.marginType/paddingType`, `normal` = 4 / 10 dp, `custom` kenar kenar): tipi yazılmamış düğüm `normal` dış boşluk, bırakılabilir kap `normal` iç boşluk alır — kenara yaslanacak kapta `none` yazın. `wrap: true` iken satırlar çapraz hizayı izler (web `flex-layout` ile aynı: `stretch` kabı doldurur, `top`/`left` üstten dizer).',
             "`title`/`description` web gibi gövdenin üstünde başlık bandı çizer (sarmalayıcı kapta hiç); görünümü `headerStyle`tan (başlık rengi/boyu/kalınlığı, ayraç, dolgu, dış boşluk, asgari boy, hiza — token ve `calc` çözülür). `size: grow` her doğrudan çocuğa ana eksende pay verir (web `flex: 1 1 auto`; içerik boyundan büyür, eşit değil — eşit karo için çocuğa `widthType: fixed` + yüzde).",
             "`click` (mobile-only olay, K1): bir akışa bağlıysa kap runtime'da basılır — bileşik kart (`card` çocuk almaz, kap alır). Basılı his soluklaşma + küçülme; içteki düğmenin basışı kabın `click`ini tetiklemez. Bağsız kap dokunuşu yutmaz. `ariaLabel` basılabilir kabın ekran okuyucu adıdır; cihazda rol `button`, web'de rol yazılmaz (react-native-web `button` rolünü `<button>` öğesine çevirir, içteki düğme iç içe `<button>` olurdu)."
-        ]
+        ],
+        propNotes: { heroTag: HERO_TAG_NOTE }
     },
     'widget-area': {
         summary: 'Konteyner widget`ının kökü; yerleşim sözleşmesi `container` ile aynıdır.',
@@ -87,6 +140,7 @@ export const mobileComponentKnowledge = {
         summary: 'Metin; punto temanın tip ölçeğinden gelir.',
         differences: [
             '`wordBreak` düşer: React Native metni `numberOfLines`/`ellipsizeMode` ile sınırlar, CSS kırma kuralının karşılığı yoktur.',
+            'Düşenler: `record`, `recordField`, `revealEntity` (korumalı değerin kilitli maskesi ve "Göster"i mobilde yok; metin bağlandığı değeri olduğu gibi çizer).',
             "`lineClamp` (1–10) `numberOfLines` + sonda üç nokta olarak uygulanır (2026-09-27, f-05). Mobile-only `highlight`: aramaya bağlanan metin — eşleşen parçalar `font-semibold text-primary`; karşılaştırma uygulama diline göre katlanır (`tr`'de `I`↔`ı`, `İ`↔`i`). Satır içi bağlantı için `markdown` + `linkClick` kullanın.",
             "Seviyenin mobil karşılığı varsa (`--ng-font-size-<seviye>-mobile`) o kullanılır; metin stili ATA KAPTAN MİRAS ALINMAZ (RN'de miras yoktur), kabuk tipografiyi bağlama yazar."
         ]
@@ -128,7 +182,8 @@ export const mobileComponentKnowledge = {
             "`clearable`: değer doluyken ve alan düzenlenebilirken sağda × (`<elementId>__clear`); basış `change('')` + `changed('')`, odak alanda kalır.",
             "Mobile-only (D11): `keyboardType` (`default|email|phone|number|decimal|url`; boşsa maskeden), `autoComplete` (`off|email|name|tel|username|postal-code|one-time-code` → iOS `textContentType`), `variant: search` (hap köşe, başta arama ikonu, odaktayken sağda uygulama dilinde \"Vazgeç\" `<elementId>__cancel`: değeri temizler, klavyeyi kapatır, `cancel` yayar), `isValid` (yeşil kenar + ✓; geçersizlik kazanır).",
             '`prefixIcon`/`suffixIcon` alanın içinde glif olarak çizilir (ortak `FieldBox`); `autofocus` runtime\'da klavyeyi açar. 2026-09-27\'ye dek dördü de çizilmiyordu (f-05).',
-            'Sayaç kuralı web ile aynı: yalnız `showCounter` açık VE `maxChars` > 0 iken çizilir.'
+            'Sayaç kuralı web ile aynı: yalnız `showCounter` açık VE `maxChars` > 0 iken çizilir.',
+            'Düşenler: `isMasked` (korumalı değerin "yeni değer gir" kipi mobilde yok; alan bağlandığı değeri olduğu gibi gösterir).'
         ]
     },
     textarea: {
@@ -220,7 +275,8 @@ export const mobileComponentKnowledge = {
             'Görselin boyu (`imageFrameStyle`, `video`/`lottie` ile aynı sıra): (1) boy kabuktan geliyorsa görsel kabuğu DOLDURUR — `heightType: fixed` + `px` boyda tam, `fixed` + `%` boyda ve `fill`de 96 dp taban boyun altına inmeden (ata içerik boyundaysa yüzde ve `fill` boy vermez); (2) değilse `appearance.aspectRatio` görselin kendisine yazılır: boy `auto` ve genişlik `fill`/`fixed` iken boy genişlikten türer; (3) ikisi de yoksa 96 dp taban boy (MOB-012 bilgi satırı). 2026-09-27\'ye dek (1) yoktu: `fixed` verilen görsel 96 dp çizilip altında boşluk bırakıyordu.',
             'Düşenler: `isZoomable`, `isRotatable` (görsel kendisi büyütmez; tam ekran görüntüleyici ayrı iş, plans/mobil-plantcare-acigi f-14).',
             'Mobile özgü alanlar: `fit` (`cover` varsayılan — web kuralı: `widthType: contain` sığdırır; `contain` sığdırır, `fill` gerer), `fallbackSrc` (kaynak boşsa ya da yüklenemezse çizilir; o da yoksa yer tutucu) ve `surfaceStyle` (köşe, kenar, gölge, opaklık; köşe görselin kendisine de yazılır, grupta köşe yoksa tema köşesi). Yuvarlak küçük resim: `surfaceStyle: { radius: "14px" }` + `appearance.aspectRatio: 1` — sarmalayıcı kap gerekmez.'
-        ]
+        ],
+        propNotes: { heroTag: HERO_TAG_NOTE }
     },
     icon: {
         summary: 'Tek glif; Material Symbols LİGATÜRÜ olarak çizilir.',
@@ -255,20 +311,21 @@ export const mobileComponentKnowledge = {
         ]
     },
     repeater: {
-        summary: 'İki görünümlü liste (YALNIZ mobil; web listesi tek şablonlu): children = [view (satır şablonu, satır başına tekrarlanır), view (boş görünüm, satır yokken bir kez)]; satır kimlikleri `__row-<i>`.',
+        summary: 'İki görünümlü liste (YALNIZ mobil; web listesi tek şablonlu): children = [view (satır şablonu, satır başına tekrarlanır), view (boş görünüm, satır yokken bir kez)]; satır kimlikleri `__row-<i>` (`page_screenshot` satırı `<elementId>__row-<i>` ile tıklar; özet satırları sayar).',
         differences: [
             '`FlatList` v1`de KULLANILMAZ: sanallaştırma yalnız gerçek veriyle anlamlı, tasarım kipinde ölçüm haritasını bozar (kaplama görünmeyen satırın kutusunu bulamaz).',
             'Tasarım kipinde şablon BİR kez çizilir. Runtime`da her satır web ile AYNI makine parametresiyle (`index`, `row`, `repeaterId`) çizilir: bağlı prop`lar `Row` / `RowIndex` / `item` okur. Satır yoksa (`rows` boş dizi ya da `null`) İKİNCİ görünüm (boş görünüm) bir kez, tam genişlikte ve sayfa bağlamıyla çizilir (ADR docs/adr/0005, 2026-09-30; web listesi boşken hiçbir şey çizmez). Boş durumu oraya serbestçe tasarla (emptystate, düğme, görsel); `emptyTitle`/`emptyDescription`/`emptyIcon` prop\'ları ve kardeş `emptystate` yolu KALDIRILDI. Görünümün çocukları dikey akar (`view` çizimi container\'a sütun olarak devredilir).',
             'Satırdaki bir düğümün olayı ÖNCE tekrarlayıcıya `change { selectedIndex }` yazar (aynı satırsa yazmaz), sonra kendi akışını koşar (web sırası), çocuğun `click`inden sonra da `select` yayar. Akışta tıklanan satırın iki yolu var: `<tekrarlayıcı>.selectedItem` / `.selectedIndex` HER runtime sürümünde çalışır (önerilen); `Row` / `RowIndex` / `item` ARC-121 düzeltmesini (2026-09-27) taşıyan runtime`da da satırı verir ve `item`a yazmak YALNIZ o satırı günceller — daha eski runtime`da akış ifadesinde boştu (ölçüldü 2026-09-19).',
             'Satır bağlamındaki bir akışın setter hedefi satırın şablonu DIŞINDAysa (bir modal, sayfa düzeyi bir metin) yazım SAYFA kapsamında olur; İÇİNDEyse satır bazlı depoya (`_repeaterValues`) yazılır — kapsamı olayın kaynağı değil hedefin AĞAÇTAKİ yeri belirler, `flow-trigger` üzerinden koşan aynı akış için de değişmez (ZM-08, `isElementInRepeaterTemplate`, 2026-09-26).',
-            'İç içe repeater zaten MCP tarafından reddedilir (`PAGE-013`) — başlıklar altında gruplu liste (güne göre görevler) için `grouped-list` kullanın; yoksa bir DIŞ repeater\'ın şablonuna İÇ satırdan yazan bir akışın yazımı dış satırın değil İÇ satırın kimliğiyle anahtarlanırdı — bilinen açık, `PAGE-013` riski düşük tutar.',
+            `${ROW_LIST_NESTING_NOTE} Başlıklar altında gruplu liste (güne göre görevler) için \`grouped-list\` kullanın; yoksa bir DIŞ listenin şablonuna İÇ satırdan yazan bir akışın yazımı dış satırın değil İÇ satırın kimliğiyle anahtarlanırdı — bilinen açık, \`PAGE-013\` riski düşük tutar.`,
             '`columnCount` > 1 iken satırlar yüzde genişlikle sarılır (RN`de CSS grid yok).',
             '`direction: horizontal` (MOBİLE ÖZGÜ) satırları tek satırlı, göstergesiz yatay kaydırıcıda dizer — ana sayfanın bitki kartı şeridi. Öğe genişliği `itemWidth` (px; boşsa şablonun kendi `appearance` genişliği), aralık `horizontalSpacing`; `snap: item` kaydırmayı kart başına oturtur (web önizlemesinde CSS scroll-snap). `columnCount` yatayda yok sayılır. Şablon kabına `widthType: fill` verin ki kart `itemWidth`i doldursun.',
             'GRUPLAMA bu bileşende YOKTUR: başlıklar altında liste (türe/zamana göre görevler) `grouped-list`tir — sayaç başlık şablonunda `Section.count`, toplu eylem başlıktaki bir `button` (akışı `Section.items` okur).',
+            'Düşenler: `cardFill` (web ızgarasında kartı en uzun kartın boyuna uzatır; mobil satır içeriğinin boyundadır).',
             'Çoklu seçim (MOBİLE ÖZGÜ): `selectionMode: multiple` satır başına onay kutusu çizer, dokunuş seçimi değiştirir ve `itemPress`/`change`/`select` YAYILMAZ; `selectionChange { selectedIndices, count }` yayılır. Seçim düğüme yazılır: `{{ <liste>.selectedItems.length }} seçildi`, `<liste>.selectedIndices`. `longPressSelects: true` uzun basışla kipi açar (basılan satır seçili). Kipi kapatmak: setter ile `selectionMode: \'single\'` + `selectedIndices: []` + `selectedItems: []`. Seçim başlığı ayrı bir `app-bar`dır, iki çubuk `isHidden` bağıyla yer değiştirir.',
             '`swipeActions` (eylemin `icon`u etiketin üstünde glif olarak çizilir) ve `itemPressable` MOBİLE ÖZGÜDÜR (webde yok). Jest RN `Animated` + `PanResponder` ile kurulur — paket v1`de `reanimated`/`gesture-handler` yok — ve yalnız YATAY harekette yakalanır, böylece dikey kaydırma kaba kalır. Tasarım kipinde satırlar şablon olarak çizildiği için jest hiç bağlanmaz.',
             '`swipe` ve `itemPress` yükleri satırı `row` alanında TAŞIR; akış ifadesindeki `Row`/`RowIndex` bağı ayrı bir konudur (ARC-121).',
-            'Düşenler: `autoRowSize` (mobil satır her zaman içeriğinin boyundadır), `size` (mobil kart hücresi çocuklarını büyütmez; 2026-09-30).'
+            'Düşenler: `autoRowSize` (mobil satır her zaman içeriğinin boyundadır), `size` (mobil kart hücresi çocuklarını büyütmez; 2026-09-30), `cardFill` (kart hücre boyuna gerilmez, içeriğinin boyundadır; 2026-10-14).'
         ],
         propNotes: {
             itemPressable: 'Satıra dokunulabilir yapar; dokunuş önce `change { selectedIndex }`, sonra `itemPress` yayar.',
@@ -536,7 +593,7 @@ export const mobileComponentKnowledge = {
             '`defaultView: month | week | day`. Ay: günde en çok `maxVisibleEvents` (varsayılan 3) nokta, fazlası `+`; seçili gün dolgulu, altında `dayCountLabel` sayacı (`{n} görev`); geçmiş günler `pastDimmed` ile soluk. Hafta: 7 günlük şerit, yatay kaydırma haftayı değiştirir. Gün: `startHour`–`endHour` saat satırları, çakışan bloklar yan yana, süresiz satır 30 dk, `doneField` doluysa blok soluk, bugünde "şimdi" çizgisi.',
             'MOBİLE ÖZGÜ: `pastDimmed`, `showTodayButton`, `legend` (açık `{label, color}` listesi — satırlardan türetilmez), `dayCountLabel`, `doneField`.',
             'Olaylar web sözleşmesiyle, yük `event.data`da (düğüme yazılmaz): `dateClick { date, rows }` (mobilde günün satırları da gelir — seçili günün görevlerini alttaki `repeater`a setter ile `event.data.rows` yazın), `eventClick { id, title, row }` (gün çizelgesinde), `monthChange { month, year, view, start, end }` (oklar, kaydırma ve Bugün — her görünümde), `viewChange { view, start, end }`.',
-            'Düşenler: `isEditable`/`isCreatable` ve `eventMove`/`eventCreate` (sürükleme jesti), `agendaDays` (liste görünümü `grouped-list` ile), `isLoading`.'
+            'Düşenler: `isEditable`/`isCreatable` ve `eventMove`/`eventCreate` (sürükleme jesti), `agendaDays` (liste görünümü `grouped-list` ile), `isLoading`, `source` (süreç görevleri kaynağı mobilde yok; takvim yalnız `rows` çizer).'
         ],
         propNotes: {
             rows: 'Etkinlik satırları; genelde sorguya kod bağıyla: `{ type: \'code\', ref: \'{{ q_gorevler.data }}\' }`.',
@@ -549,12 +606,13 @@ export const mobileComponentKnowledge = {
         summary: 'Gruplu liste (FlutterFlow GroupedListView): düz `rows`u `groupBy` alanına göre bölümlere ayırır, her bölümü bir başlık ve öğeleriyle çizer. İç içe repeater (PAGE-013) yerine gün/kategori başlıklı liste budur. Web`de karşılığı YOKTUR.',
         differences: [
             'Çocuklar KONUMSAL şablondur: çocuk 0 bölüm başlığı, çocuk 1 öğe şablonu; fazlası çizilmez. Tasarım kanvasında iki şablon bir kez, alt alta çizilir.',
-            'Öğe repeater satırıyla AYNI params`ı alır (`index` = `rows` içindeki DÜZ indeks, `row`, `repeaterId`): bağlı prop`larda `Row`, `RowIndex`, `{{ item.<alan> }}` iki yönlü bağ; akışta tıklanan satır `<liste>.selectedItem`; satır kapsamlı yazım (`_repeaterValues`) repeater`daki gibi.',
+            'Öğe repeater satırıyla AYNI params`ı alır (`index` = `rows` içindeki DÜZ indeks, `row`, `repeaterId`): bağlı prop`larda `Row`, `RowIndex`, `{{ item.<alan> }}` iki yönlü bağ; akışta tıklanan satır `<liste>.selectedItem`; satır kapsamlı yazım (`_repeaterValues`) repeater`daki gibi. Öğe kimlikleri repeater`daki gibi `__row-<i>` (düz indeks): `page_screenshot` öğeyi `<elementId>__row-<i>` ile tıklar, özet öğeleri sayar.',
             'Başlık ifadelerde `Section` okur: `{ key, title, count, items }` — ör. `{{ Section.title }} · {{ Section.count }}`. Başlık satır kapsamı TAŞIMAZ (salt okunur, `Row`/`item` boş). `Section` ayrılmış addır: aynı adlı komponent ifade bağlamından süzülür.',
             'Gruplama: tarih/saat değeri cihazın yerel gününe (`YYYY-AA-GG`) indirgenir, diğer değer metne; başlık = anahtar (biçimli başlık için `Section.key` ile ifade yazın). Alanı boş/eksik satırlar en sondaki `otherSectionTitle` bölümüne düşer.',
             'Yapışkan başlık (`stickySectionHeaders`) yalnız boyu kabuktan gelen listede çalışır ve cihazda/önizlemede SINIRLI boy ister: `appearance.heightType: fixed` + `heightString` verin. `auto`da liste düz akıştır; sayfanın kaydırıcısı içindeki `fill` içerik kadar uzar, iç kaydırıcı oluşmaz, başlık yapışmaz.',
             'Öğe şablonu basılabilir bir bileşense (`button`, `click`i bağlı `list-item`) dokunuş onun `click`ine gider ve `itemPress` yayılmaz (repeater ile aynı); `click`i bağlı olmayan `list-item` basılamaz, dokunuş `itemPress`e gider (2026-10-08). Akışı `list-item.click`e bağlarsanız satır seçimi yine olur.',
             'Çoklu seçim `repeater` ile AYNI sözleşmedir: `selectionMode: multiple` (onay kutusu, dokunuş seçer, `itemPress` yayılmaz), `longPressSelects`, `selectionChange { selectedIndices, count }`, düğümde `selectedIndices`/`selectedItems` — gruplu görev listesinde toplu Ertele/Tamamla.',
+            ROW_LIST_NESTING_NOTE,
             'v1`de yok: `columnCount`, sanallaştırma, başlıktan yazan akış. Studio`nun satır farkında yerleri (Bind modalı `Row` önerisi, setter satır hedefi) yalnız `repeater`ı tanır — `grouped-list` içinde `Row`/`item` ifadesini elle yazın.'
         ],
         propNotes: {
@@ -570,6 +628,46 @@ export const mobileComponentKnowledge = {
             longPressSelects: 'Uzun basış çoklu seçim kipini açar.'
         }
     },
+    'flip-card': {
+        summary: 'İki yüzlü kart (FlutterFlow FlippableCard): dokununca 3B dönerek öteki yüzünü gösterir. Web`de karşılığı YOKTUR.',
+        differences: [
+            "children TAM iki `view` düğümüdür, bu sırayla: ön yüz, arka yüz (`repeater` gibi sabit görünüm; başka şekil 422 `fixed-views`). İçeriği görünümlerin İÇİNE koyun: `flip-card › view › …`. Görünümün çocukları dikey akar.",
+            'Görünen yüz `isFlipped`tir (false ön, true arka). Karta dokunuş onu çevirir ve `flip { isFlipped }` yayar; akış da setter ile `isFlipped` yazabilir (o zaman `flip` yayılmaz). Koşul: `{{ <kart>.isFlipped }}`.',
+            'Yüzün içindeki denetim (button, list-item, switch, metin alanı) dokunuşu kendisi alır, kart dönmez. Yalnız düğmeyle dönen kart: `flipOnPress: false` + düğmenin akışında setter `isFlipped: !<kart>.isFlipped`.',
+            'Kartın boyu ÖN yüzün boyudur; arka yüz aynı kutuyu doldurur (daha uzun arka yüz taşar). İki yüz farklı boydaysa karta `appearance.heightType: fixed` verin.',
+            'Dönüş `duration` ms sürer (100–2000, varsayılan 400), `direction: horizontal` düşey eksende, `vertical` yatay eksende. "Hareketi azalt"ta ve `page_screenshot`ın donuk karesinde yüz anında değişir.',
+            'Tasarım kanvasında kart dönmez ve önizlemedeki TEK yüz çizilir (`isFlipped`); öteki yüz, içinden bir düğüm seçilince açılır. Görünmeyen yüz çalışırken dokunuş almaz.'
+        ],
+        propNotes: {
+            isFlipped: 'Açılışta görünen yüz: `false` ön (varsayılan), `true` arka. Basış ve akış bu alanı yazar.',
+            flipOnPress: 'Karta dokunuş çevirir mi (varsayılan açık). Kapalıyken yalnız `isFlipped` yazımı çevirir.',
+            direction: '`horizontal` (varsayılan; kart sağa-sola döner) · `vertical` (yukarı-aşağı).',
+            duration: 'Dönüşün süresi (ms), 100–2000; varsayılan 400.',
+            views: "Sabit iki görünüm: 'front' ve 'back'. Değer YAZILMAZ; görünümler children'daki iki view düğümüdür."
+        }
+    },
+    'swipeable-stack': {
+        summary: 'Kaydırılarak atılan kart destesi (FlutterFlow SwipeableStack): `rows`un her satırı bir karttır, üstteki kart sola ya da sağa atılır. Web`de karşılığı YOKTUR.',
+        differences: [
+            "İki görünümlü satır listesidir (`repeater` ile aynı şekil): children = [view (kart şablonu, satır başına), view (boş görünüm, kart kalmayınca bir kez)]; başka şekil 422 `fixed-views`. Kart şablonu `repeater` satırının params`ını alır: bağlı prop`larda `{{ item.<alan> }}`, `Row`, `RowIndex`.",
+            'Üstteki kart `currentIndex` satırıdır; arkasında en çok `visibleCount − 1` kart görünür (her biri `stackOffset` dp aşağıda ve %5 küçük). Kaydırma `currentIndex`i bir artırır — denetimlidir: akış setter ile `currentIndex` yazarak desteyi ilerletebilir ya da başa alabilir (`0`); o zaman kart animasyonsuz değişir ve olay yayılmaz.',
+            'Kart genişliğin %30`undan uzağa çekilince ya da hızla savrulunca atılır, yoksa yerine döner. Sırayla: `change { selectedIndex }` → `swipeLeft` / `swipeRight` (yük `event.data`: `{ index, row, direction }`) → son satırsa `finish`. Akışta kaydırılan kart `event.data.row` ya da `<deste>.selectedItem`.',
+            '`swipeDirections: left | right` öteki yönü kapatır (kart o yöne dirençle çekilir ama atılmaz). Beğen/geç ayrımı iki olaya iki akış bağlanarak kurulur; yön tek akışta `event.data.direction`.',
+            '`loop` kapalıyken son karttan sonra boş görünüm çizilir (`currentIndex` = satır sayısı); açıkken deste başa döner. `rows` boşsa da boş görünüm çizilir.',
+            'Jest yalnız YATAY harekette yakalanır: dikey kaydırma sayfada kalır, kart sürüklenirken sayfa kaymaz. Karttaki düğmeye dokunuş düğmenin akışını koşturur (önce `change { selectedIndex }`); düğmeden başlayan kaydırma düğmeyi tetiklemez.',
+            'Destenin boyu ÜSTTEKİ kartın boyudur; kartlara aynı boyu verin (şablon kabına `heightType: fixed`), yoksa kart değiştikçe deste boy değiştirir. Tasarım kanvasında şablon bir kez çizilir, jest yoktur.',
+            `${ROW_LIST_NESTING_NOTE} v1\`de yok: dikey kaydırma yönleri, akıştan animasyonlu atma, sanallaştırma. Studio\`nun satır farkında yerleri (Bind modalı \`Row\` önerisi) yalnız \`repeater\`ı tanır — \`item\`/\`Row\` ifadesini elle yazın.`
+        ],
+        propNotes: {
+            rows: 'Düz satır dizisi (repeater `rows` ile aynı biçim); genellikle sorguya kod bağıyla: `{ type: \'code\', ref: \'{{ q_kartlar.data }}\' }`.',
+            currentIndex: 'Üstteki kartın `rows` içindeki indeksi (varsayılan 0). Kaydırma yazar; akış da yazabilir.',
+            visibleCount: 'Aynı anda çizilen kart sayısı, 1–5 (varsayılan 3).',
+            stackOffset: 'Arkadaki kartın derinlik başına aşağı kayması (dp), varsayılan 8; 0 kartları tam üst üste koyar.',
+            swipeDirections: '`both` (varsayılan) · `left` · `right`.',
+            loop: 'Son karttan sonra ilk kart gelir; `finish` yine son satırda yayılır.',
+            views: "Sabit iki görünüm: 'item' (kart şablonu) ve 'empty' (boş görünüm). Değer YAZILMAZ; görünümler children'daki iki view düğümüdür."
+        }
+    },
     'floating-container': {
         summary: 'Ekrana sabit kap: çocuklarını ekranın dokuz noktasından birine sabitler, sayfa kayarken yerinde kalır (FAB`dan fazlası: alt eylem çubuğu, üst şerit, köşe rozeti). Web`de karşılığı YOKTUR.',
         differences: [
@@ -630,13 +728,14 @@ export const mobileComponentKnowledge = {
         ]
     },
     video: {
-        summary: 'Video oynatıcı; prop ve olaylar web ikizininki (`src`, `poster`, `autoplay`, `loop`, `muted`, `controls`; `play`/`pause`/`ended`/`click`).',
+        summary: 'Video oynatıcı; prop ve olaylar web ikizininki (`src`, `poster`, `autoplay`, `loop`, `muted`, `controls`, `ariaLabel`; `play`/`pause`/`ended`/`click`/`load`/`error`).',
         differences: [
             'Cihazda `expo-video` (denetimler platformun kendi oynatıcısı), Studio kanvası ve önizlemede HTML5 `<video>`. Kanvasta oynatılmaz ve dokunuş almaz — dokunuş seçim jestidir, denetimler yalnız görünür.',
             'Kutu: boyu kabuktan gelen video (`heightType: fixed` + ölçülebilir `heightString`, ya da `fill`) kabuğu doldurur; genişliği belli video (`widthType: fill`, ya da `fixed` + `widthString`) boyunu orandan alır — panelin `appearance.aspectRatio`su, yoksa 16:9; genişliği belli değilse boy 200 dp. Studio`dan bırakılan video `heightType: fixed` alır ama ölçüsü yoktur: 16:9 için `widthType: fill` verin. Video kutuyu `cover` ile doldurur (web ikizi gibi).',
             '`autoplay` yalnız oynatıcı kurulurken (sayfa açılışı, kaynak değişimi) uygulanır; tarayıcı sesli otomatik oynatmayı engelleyebilir (`muted` açın). `ended` `loop` açıkken yayılmaz. `click` yalnız `controls: false` iken yayılır — denetimler açıkken dokunuş oynatıcınındır.',
-            'Cihazda afiş yerel bir özellik değildir: `poster` ilk oynatmaya dek videonun üstünde çizilir ve denetimler açıkken ortasındaki oynat düğmesi oynatmayı başlatır. Düşen: `style`.',
-            'Cihazda sayfa odağı kaybedince (yığında arkaya düşünce, başka sekmeye geçince) video durur ve `pause` yayar; dönüşte kendiliğinden sürmez. Döngü sınırındaki ve ara belleğe almadaki kısa duruşlar `pause`/`play` yaymaz (web `<video loop>` gibi).'
+            'Cihazda afiş yerel bir özellik değildir: `poster` ilk oynatmaya dek videonun üstünde çizilir ve denetimler açıkken ortasındaki oynat düğmesi oynatmayı başlatır. Erişilebilir ad (`ariaLabel`) cihazda yalnız `controls: false` iken okunur (oynatıcının ve `click` düğmesinin adı); denetimler açıkken yerel denetimler ekran okuyucudan gizlenmesin diye oynatıcı tek öğe yapılmaz. Düşen: `style`.',
+            'Cihazda sayfa odağı kaybedince (yığında arkaya düşünce, başka sekmeye geçince) video durur ve `pause` yayar; dönüşte kendiliğinden sürmez. Döngü sınırındaki ve ara belleğe almadaki kısa duruşlar `pause`/`play` yaymaz (web `<video loop>` gibi).',
+            '`load` kaynak yüklenince `{ duration, width, height }` (cihazda boyut ilk video izinden; bilinmeyen değer 0), `error` `{ code, message }` yayar — cihazda `expo-video` hata kodu taşımaz, `code` 0. Oynatma niyeti (`isPlaying: true`) varken hata kolu `false`a geri yazar (web ikizi gibi). (2026-10-14).'
         ]
     },
     audio: {
@@ -828,8 +927,8 @@ export const mobileComponentKnowledge = {
         differences: [
             '`variant: table` (varsayılan) yatay kaydırılan tablodur: başlık satırı, sıralanabilir kolonda başlığa dokunuş (`<elementId>__sort-<kolon>`, yön oku başlıkta), eylem sütunu satırın sonunda; dikey kaydırma sayfanındır, tablonun üstünden başlayan dikey kaydırma sayfayı kaydırır; kolonların toplamı çerçeveden darsa kolonlar web gibi çerçeveye yayılır (`table-layout: fixed`). `variant: cards` satır başına kart çizer: ilk görünür görsel kolon kartın başına, ilk görsel olmayan kolon başlığa, kalanlar etiket-değer satırlarına; kart kipinde sıralama başlığı yoktur (sıralama akışla yazılır).',
             'Eylemler web paletiyle (`solid` birincil, `information` kenarlı, `transparent` hayalet, `error`/`danger` yıkıcı, `warning`, `dark`): `actionType: button` satırda düğmeler (`<elementId>__action-<satır>-<sıra>`), `dropdown` ⋯ düğmesi (`<elementId>__more-<satır>`) alttan açılan eylem sayfası (`<elementId>__sheet-action-<sıra>`; cihazda `modal` ile aynı katman). Satırın `_actions` dizisi web gibi eylemi ezer, `isHidden` gizler, `isDisabled` kilitler.',
-            'Sayfalama (`isPaginated`): ‹ `1–10 / 57` › çubuğu (`<elementId>__page-prev`, `__page-next`); metin dil bağımsızdır. Web`in sayfa numarası kutusu ve sayfa başına satır seçimi yok (`limit` panelden ya da akıştan; düğümde hiç yazılmamışsa web gibi 10). Başlık doluyken yanındaki yenile düğmesi (`<elementId>__refresh`) `mount`u koşturur.',
-            'Düşenler: `style`, `actionsPinned` (sabit eylem sütunu). Okunmayanlar: kolonların `isFilterable`ı ve gizli `filters` — filtre düzenleyicisi mobilde yok, akışın yazdığı `filters` sorguya olduğu gibi gider; özet satırı yok. Satır sanallaştırma yok: uzun veri için yol `limit`tir (100 satır × 6 kolon cihazda geliştirme kipinde ~0,7 sn`de çizildi).',
+            'Sayfalama (`isPaginated`): ‹ `1–10 / 57` › çubuğu (`<elementId>__page-prev`, `__page-next`); metin dil bağımsızdır. Web`in sayfa numarası kutusu ve sayfa başına satır seçimi yok (`limit` panelden ya da akıştan; düğümde hiç yazılmamışsa web gibi 10). Başlık doluyken yanındaki yenile düğmesi (`<elementId>__refresh`) `mount`u koşturur; `showRefresh: false` düğmeyi kaldırır.',
+            'Düşenler: `style`, `actionsPinned` (sabit eylem sütunu); satır içi düzenleme `editMode`, `canEditRow`, `canAddRow`, `addRowButton`, `addRowShortcut`, `canDeleteRow`, `bulkActions`, `canReorderRows`, `orderField` ve olayları `save`, `discard`, `cellSelectionChange`, `rowSelectionChange` (mobil tablo salt okunur; satır işlemi `actions` ile yapılır; ailenin kolon alanları columns[].editable · columns[].relationTypeField · columns[].relationTargets da düşer); filtre arayüzü `filterMode`, `advancedFilter`, `filterPosition`, `showFilterSummary`; araçlar ve yerleşim `showExport`, `showColumnManager`, `toolsPosition`, `footerPosition`, `showRecordSummary`, `stickyHeader`, `stickyFooter`; sayfalama biçimi `paginationMode`, `paginationPosition`; satır dokunuşu `rowClick`, `rowDoubleClick` (satıra dokunuş olay yaymaz); `revealEntity`. Okunmayanlar: kolonların `isFilterable`ı ve gizli `filters` — filtre düzenleyicisi mobilde yok, akışın yazdığı `filters` sorguya olduğu gibi gider; özet satırı yok. Satır sanallaştırma yok: uzun veri için yol `limit`tir (100 satır × 6 kolon cihazda geliştirme kipinde ~0,7 sn`de çizildi).',
             'Hücre: metin tablo kipinde tek satırda kırpılır (`multiLine` ise `lineClamp` kadar satır), kart kipinde sarar; etiket rengi temadan çözülür, üstündeki metin koyu/açık seçilir; `image` kolonu `imageHeight` karesi; `file` ve `url` dokunuşla sistemde açılır (kanvasta kilitli); `progress` her zaman çubuktur (daire kipi çubuk çizilir). Yükleniyor (`isLoading`) satırların yerine ortada dönen gösterge; satır yokken gövde web`in boş satırı kadar (120) boş kalır, ileti yazılmaz. Bırakılamaz — web ikizi bırakılabilir bildirir ama çocuk çizmez.'
         ],
         propNotes: {
@@ -862,7 +961,7 @@ export const mobileComponentKnowledge = {
         differences: [
             'Dikey tek düzen. Satırlar `groupByDate` (MOBİLE ÖZGÜ, varsayılan açık) ile gün başlıklarına ayrılır ("Bugün", "Dün", yoksa `dateFormat`); kapalıyken tek liste. `items[].images` (MOBİLE ÖZGÜ): adres dizisi (`["a.jpg", "b.jpg"]`, statik satırda da kabul edilir — ARC-152) ya da virgülle ayrılmış metin (`"a.jpg, b.jpg"`); bağla gelen satırda `[{ src }]` de okunur. Satırın altında küçük resimler.',
             'Satıra dokunuş `clickItem { currentItem, index }` yayar; öğenin kendi `flow`u da koşar (web: bağlı akış önce başlatılır). `maxCount` aşılınca "Tümünü göster" (`<elementId>__show-more`) kalanı açar ve `showMore` yayar. `showMoreText`/`emptyText` yazılmamışsa uygulama dilinden gelir ("Tümünü göster" / "Henüz kayıt yok"). Satır iç rolü `<elementId>__item-<index>`.',
-            'Düşenler: `orientation` (mobil yalnız dikey), `style`.'
+            'Düşenler: `orientation` (mobil yalnız dikey), `style`, `isClickable` (satır, düğümün `clickItem`ı bağlıysa kendiliğinden basılır).'
         ]
     },
     'photo-viewer': {

package/dist/knowledge/mobileComponentEvents.js

@@ -234,6 +234,47 @@ export const mobileComponentEventContracts = {
     'floating-container': {
         mount: NO_DATA
     },
+    'flip-card': {
+        mount: NO_DATA,
+        flip: {
+            payload: {
+                isFlipped: 'boolean — YENİ durum: true arka yüz, false ön yüz'
+            },
+            reads: "karta dokununca (flipOnPress açıkken); makine isFlipped'i düğüme yazar, akış <kart>.isFlipped okur. Akışın isFlipped'e yazması kartı çevirir ama flip yaymaz. Yüzün içindeki basılabilir bileşene (button, list-item) dokunuş kartı çevirmez"
+        }
+    },
+    'swipeable-stack': {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                selectedIndex: "number — kaydırılan (ya da içindeki bir bileşenine dokunulan) kartın rows içindeki indeksi; aynı kartta yeniden yayılmaz. Makine selectedIndex'i yazar, akışta kart <deste>.selectedItem"
+            }
+        },
+        swipeLeft: {
+            payload: {
+                index: 'number (kaydırılan kartın rows içindeki indeksi, 0 tabanlı)',
+                row: 'object (kaydırılan kartın satır verisi)',
+                direction: "'left'"
+            },
+            reads: "self'e yazılmaz — event.data ile oku. Olaydan önce change { selectedIndex } yayılır ve düğümün currentIndex'i bir sonraki karta yazılır (<deste>.currentIndex yeni üst karttır)"
+        },
+        swipeRight: {
+            payload: {
+                index: 'number (kaydırılan kartın rows içindeki indeksi, 0 tabanlı)',
+                row: 'object (kaydırılan kartın satır verisi)',
+                direction: "'right'"
+            },
+            reads: "self'e yazılmaz — event.data ile oku. Olaydan önce change { selectedIndex } yayılır ve düğümün currentIndex'i bir sonraki karta yazılır (<deste>.currentIndex yeni üst karttır)"
+        },
+        finish: {
+            payload: {
+                index: 'number (son kartın rows içindeki indeksi)',
+                row: 'object (son kartın satır verisi)',
+                direction: "'left' | 'right'"
+            },
+            reads: "self'e yazılmaz — event.data ile oku. rows'un SON satırı kaydırılınca, yön olayından sonra; loop açıkken de yayılır (deste başa döner)"
+        }
+    },
     repeater: {
         swipe: {
             payload: {

package/dist/knowledge/motionResolve.js

@@ -0,0 +1,252 @@
+/**
+ * Mobil `motionStyle` grubunun gateway aynası: alan tablosu ve çözücü. Kaynak frontend'dedir
+ * (`zeyrek-frontend/packages/ng-apps-ui-native/src/motion/` — `motion-fields.ts`, `motion-presets.ts`,
+ * `resolve-motion.ts`); bu dosya onun kopyasıdır ve iki kilitle bağlıdır (`test/motion-resolve.test.ts`):
+ * frontend'in altın vakaları (`motion-golden.json`) aynı çıktıyı vermeli, mobil katalogdaki grubun alanları ve
+ * seçenekleri bu tabloyla aynı olmalı. Test kırılınca test düzeltilmez, bu dosya senkronlanır.
+ *
+ * Çözüm reanimated'in girdisinin serileştirilebilir tanımıdır: giriş/çıkış/yerleşim oluşturucu adıyla,
+ * döngü ve değer geçişi CSS API alanlarıyla (frontend ADR 0006).
+ */
+export const MOTION_ENTER = ['none', 'fade', 'fadeUp', 'fadeDown', 'slideLeft', 'slideRight', 'zoomIn'];
+export const MOTION_EXIT = ['none', 'fade', 'fadeUp', 'fadeDown', 'slideLeft', 'slideRight', 'zoomOut'];
+export const MOTION_EASING = ['ease', 'easeIn', 'easeOut', 'easeInOut', 'linear'];
+export const MOTION_LOOP = ['none', 'pulse', 'spin', 'bounce'];
+export const MOTION_TRANSITION = ['none', 'colors', 'opacity', 'transform', 'all'];
+export const MOTION_PRESS = ['none', 'scale', 'opacity'];
+/**
+ * Grubu TAŞIMAYAN mobil tipler: görünen içeriğini düğüm kabuğunun dışında çizerler (katman, bildirim, ekran katmanına
+ * taşınan), kabukları çalışma anında boş kutudur — frontend `catalog-schema.ts` `DRAWN_OUTSIDE_SHELL`. Katalogla
+ * kilitli (`test/motion-resolve.test.ts`).
+ */
+export const MOTION_OUTSIDE_SHELL = ['drawer', 'fab', 'floating-container', 'modal', 'photo-viewer', 'toast'];
+/** ms cinsinden kabul aralıkları. */
+export const MOTION_RANGES = {
+    duration: [100, 2000],
+    delay: [0, 5000]
+};
+/** Alan düğümde yokken çizerin okuduğu değerler; şema bunları düğüme YAZMAZ (grubun kayıtlı varsayılanı yoktur). */
+export const MOTION_DEFAULTS = {
+    enter: 'none',
+    exit: 'none',
+    duration: 300,
+    delay: 0,
+    easing: 'easeOut',
+    layout: false,
+    loop: 'none',
+    transition: 'none',
+    press: 'none'
+};
+export const MOTION_FIELDS = Object.keys(MOTION_DEFAULTS);
+/** Seçenekli alanların değer kümeleri; katalog paritesi ve sözlük notu buradan okur. */
+export const MOTION_CHOICES = {
+    enter: MOTION_ENTER,
+    exit: MOTION_EXIT,
+    easing: MOTION_EASING,
+    loop: MOTION_LOOP,
+    transition: MOTION_TRANSITION,
+    press: MOTION_PRESS
+};
+const DECIMAL_TEXT = /^\d+(\.\d+)?$/;
+const isEmpty = (raw) => raw === undefined || raw === null || (typeof raw === 'string' && raw.trim() === '');
+/**
+ * Alanın değeri. Boş değer ne değer ne uyarıdır (alan yazılmamış). Okunamayan değer `value` taşımaz; uyarı
+ * frontend'inkiyle harfi harfine aynıdır (altın vaka onu karşılaştırır).
+ */
+export const motionValue = (field, raw) => {
+    if (isEmpty(raw))
+        return {};
+    const reject = (expected) => ({
+        warning: `motionStyle.${field}: ${typeof raw === 'string' ? `'${raw}'` : JSON.stringify(raw)} geçersiz — ${expected}, atlandı`
+    });
+    const name = field;
+    if (name === 'duration' || name === 'delay') {
+        const [min, max] = MOTION_RANGES[name];
+        // Metin yalnız ondalık yazımla sayıdır: `Number()` üstel ('1e3') ve onaltılık ('0x1F4') metni de sayıya çevirir.
+        const number = typeof raw === 'number' ? raw : typeof raw === 'string' && DECIMAL_TEXT.test(raw.trim()) ? Number(raw) : NaN;
+        return Number.isFinite(number) && number >= min && number <= max
+            ? { value: number }
+            : reject(`${min}…${max} arası sayı (ms)`);
+    }
+    if (name === 'layout') {
+        if (raw === true || raw === 'true')
+            return { value: true };
+        if (raw === false || raw === 'false')
+            return { value: false };
+        return reject('true ya da false');
+    }
+    const choices = MOTION_CHOICES[name] ?? [];
+    return typeof raw === 'string' && choices.includes(raw)
+        ? { value: raw }
+        : reject(choices.join(', '));
+};
+const ENTER_PRESETS = {
+    fade: 'FadeIn',
+    fadeUp: 'FadeInUp',
+    fadeDown: 'FadeInDown',
+    slideLeft: 'SlideInLeft',
+    slideRight: 'SlideInRight',
+    zoomIn: 'ZoomIn'
+};
+const EXIT_PRESETS = {
+    fade: 'FadeOut',
+    fadeUp: 'FadeOutUp',
+    fadeDown: 'FadeOutDown',
+    slideLeft: 'SlideOutLeft',
+    slideRight: 'SlideOutRight',
+    zoomOut: 'ZoomOut'
+};
+const LAYOUT_PRESET = 'LinearTransition';
+const EASING_CSS = {
+    ease: 'ease',
+    easeIn: 'ease-in',
+    easeOut: 'ease-out',
+    easeInOut: 'ease-in-out',
+    linear: 'linear'
+};
+/** Döngülerin kendi süresi ve eğrisi vardır; düğümde `duration`/`easing` YAZILMAMIŞSA bunlar geçer, 300 ms değil. */
+const LOOP_PRESETS = {
+    spin: {
+        keyframes: { from: { transform: [{ rotate: '0deg' }] }, to: { transform: [{ rotate: '360deg' }] } },
+        duration: 1000,
+        easing: 'linear'
+    },
+    pulse: {
+        keyframes: { '0%': { opacity: 1 }, '50%': { opacity: 0.5 }, '100%': { opacity: 1 } },
+        duration: 2000,
+        easing: 'cubic-bezier(0.4, 0, 0.6, 1)'
+    },
+    bounce: {
+        keyframes: {
+            '0%': { transform: [{ translateY: '-25%' }], animationTimingFunction: 'cubic-bezier(0.8, 0, 1, 1)' },
+            '50%': { transform: [{ translateY: '0%' }], animationTimingFunction: 'cubic-bezier(0, 0, 0.2, 1)' },
+            '100%': { transform: [{ translateY: '-25%' }], animationTimingFunction: 'cubic-bezier(0.8, 0, 1, 1)' }
+        },
+        duration: 1000,
+        easing: 'linear'
+    }
+};
+const TRANSITION_PROPERTIES = {
+    colors: ['backgroundColor', 'borderColor', 'color'],
+    opacity: ['opacity'],
+    transform: ['transform'],
+    all: 'all'
+};
+const PRESS_PRESETS = {
+    scale: { property: 'scale', to: 0.95 },
+    opacity: { property: 'opacity', to: 0.7 }
+};
+/** Dokunma tepkisinin süresi kendinindir; düğümün süre/gecikme/eğrisi ona geçmez. */
+const PRESS_TIMING = { duration: 150, easing: 'easeOut' };
+const isActive = (settings) => settings.enter !== 'none' ||
+    settings.exit !== 'none' ||
+    settings.layout ||
+    settings.loop !== 'none' ||
+    settings.transition !== 'none' ||
+    settings.press !== 'none';
+/**
+ * Frontend `resolveMotion` ile aynı kurallar: dondurma önce gelir (tasarım kipi ya da "hareketi azalt" → `null`),
+ * hiçbir hareket alanı dolu değilse `null` (yalnız süre yazılmış ayar hareket değildir), okunamayan alan ve
+ * tanınmayan anahtar atlanıp `warnings`'e yazılır.
+ */
+export const resolveMotion = (input, context) => {
+    if (context.design || context.reduceMotion)
+        return null;
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        return null;
+    const warnings = [];
+    const settings = { ...MOTION_DEFAULTS };
+    const given = new Set();
+    for (const [key, raw] of Object.entries(input)) {
+        if (!MOTION_FIELDS.includes(key)) {
+            warnings.push(`motionStyle.${key}: tanınmayan alan, atlandı`);
+            continue;
+        }
+        const field = key;
+        const read = motionValue(field, raw);
+        if (read.warning)
+            warnings.push(read.warning);
+        if (read.value === undefined)
+            continue;
+        Object.assign(settings, { [field]: read.value });
+        given.add(field);
+    }
+    // Hareket çıkmadıysa sarmalayıcı takılmaz; atlanan alanın uyarısı yine de döner (yalnız `warnings` taşıyan sonuç).
+    if (!isActive(settings))
+        return warnings.length > 0 ? { warnings } : null;
+    const result = { warnings };
+    const timing = { duration: settings.duration, delay: settings.delay, easing: settings.easing };
+    if (settings.enter !== 'none')
+        result.entering = { preset: ENTER_PRESETS[settings.enter], ...timing };
+    if (settings.exit !== 'none')
+        result.exiting = { preset: EXIT_PRESETS[settings.exit], ...timing };
+    if (settings.layout)
+        result.layout = { preset: LAYOUT_PRESET, duration: settings.duration, easing: settings.easing };
+    if (settings.press !== 'none')
+        result.press = { ...PRESS_PRESETS[settings.press], ...PRESS_TIMING };
+    const style = {};
+    if (settings.loop !== 'none') {
+        const loop = LOOP_PRESETS[settings.loop];
+        Object.assign(style, {
+            animationName: loop.keyframes,
+            animationDuration: `${given.has('duration') ? settings.duration : loop.duration}ms`,
+            animationDelay: `${settings.delay}ms`,
+            animationTimingFunction: given.has('easing') ? EASING_CSS[settings.easing] : loop.easing,
+            animationIterationCount: 'infinite'
+        });
+    }
+    if (settings.transition !== 'none') {
+        Object.assign(style, {
+            transitionProperty: TRANSITION_PROPERTIES[settings.transition],
+            transitionDuration: `${settings.duration}ms`,
+            transitionDelay: `${settings.delay}ms`,
+            transitionTimingFunction: EASING_CSS[settings.easing]
+        });
+    }
+    if (Object.keys(style).length > 0)
+        result.style = style;
+    return result;
+};
+/*
+ * Buradan aşağısı AYNA DEĞİLDİR: gateway'in saklanan biçimi (değer sarmalları) okumasıdır.
+ */
+/**
+ * Statik olmayan değer sarmalları — `normalize.ts` `PROP_VALUE_TYPES`'ın `static` dışındakileri. O modül bu dosyayı
+ * (katalog notları üzerinden) içe aktarır; döngü olmasın diye liste burada yinelenir, `motion-resolve.test.ts` kilitler.
+ */
+export const MOTION_BINDING_TYPES = ['file', 'flow', 'widget', 'element', 'page', 'code', 'translation', 'connectData'];
+const TEMPLATE_TEXT = /\{\{[\s\S]*\}\}/;
+/**
+ * Grubun İÇİNDEKİ tek alanın ifadeye bağı; bağ yoksa `null`. `code` sarmalı çalışma anında DEĞERLENDİRİLİR (frontend
+ * ADR 0020; ölçüldü 2026-10-09, web `/dev` ve mobil oyun alanı — ondan önce hiçbir şey uygulamıyordu): uyarı değildir,
+ * değeri burada bilinemez. Alan düzeyinde çözülmeyen iki yazım kalır: sarmalsız düz metindeki `{{ … }}` (üst düzey
+ * prop'ta da ifade değildir) ve `code` dışındaki bağ türleri. Çözücü TANIMADIĞI alanı bağlı olsa da atlar: orada bağın
+ * türü değil alanın adı söylenir (yazım hatası `looop` ifadeye bağlıyken sessiz geçiyordu — inceleme 2026-10-09). `ref`'i
+ * boş `code` sarmalı ifade değildir: çizer sarmalın verisini ham değer okur, bağ toplamaz. Rapor
+ * (`nativeStyle.motion`) ve yazım denetimi (MOB-028) bu ayrımı buradan okur.
+ */
+export const motionFieldBinding = (field, raw) => {
+    const wrapper = typeof raw === 'object' && raw !== null && !Array.isArray(raw) ? raw : undefined;
+    const bound = wrapper !== undefined && typeof wrapper.type === 'string' && MOTION_BINDING_TYPES.includes(wrapper.type);
+    // Statik sarmal: tasarım şemasında `type: 'static'`, yayınlanan sayfanın yükünde `type` yok ya da `null`.
+    const fixed = wrapper !== undefined && (wrapper.type === 'static' || ((wrapper.type ?? null) === null && 'data' in wrapper));
+    const inner = fixed ? wrapper.data : raw;
+    if (!bound && !(typeof inner === 'string' && TEMPLATE_TEXT.test(inner)))
+        return null;
+    if (!MOTION_FIELDS.includes(field))
+        return { kind: 'unresolved', warning: `motionStyle.${field}: tanınmayan alan, atlandı` };
+    if (!bound) {
+        return { kind: 'unresolved', warning: `motionStyle.${field}: '{{ … }}' düz metindir, ifade olarak çalışmaz — alan yok sayılır; ifade için alanı { type: 'code', ref } sarmalıyla yazın` };
+    }
+    const candidate = wrapper?.data;
+    const fallback = isEmpty(candidate) || (typeof candidate === 'string' && TEMPLATE_TEXT.test(candidate)) ? undefined : candidate;
+    const carried = fallback === undefined ? {} : { fallback };
+    const outcome = fallback === undefined ? 'alan yok sayılır' : `sarmalın verisi (${typeof fallback === 'string' ? `'${fallback}'` : JSON.stringify(fallback)}) ham değer olarak okunur`;
+    if (wrapper?.type === 'code') {
+        if (typeof wrapper.ref === 'string' && wrapper.ref !== '')
+            return { kind: 'expression', ...carried };
+        // Çizer ifadesi boş sarmalı bağ saymaz (`inner-bindings.ts` `isCodeBinding`; panelde fx açık, metin silinmiş).
+        return { kind: 'unresolved', ...carried, warning: `motionStyle.${field}: 'code' sarmalının ifadesi (ref) boş, bağ değildir — ${outcome}` };
+    }
+    return { kind: 'unresolved', ...carried, warning: `motionStyle.${field}: alan düzeyinde yalnız ifade (code) çalışır — '${String(wrapper?.type)}' bağı çözülmez, ${outcome}` };
+};