@appaflytech/zeyrek-ai-mcp 0.0.41 → 0.0.42

package/dist/knowledge/platform/lint.js

@@ -1,9 +1,19 @@
 import { IMAGE_SOURCE_PROPS, IMAGE_SOURCE_PROP_NAMES, MOBILE_RULES, REDIRECT_PRESENTATIONS, fileIdImageExpression, missingComponentAdvice, styleReplacement } from './mobileRules.js';
+import { flattenBatchOps } from './batchOps.js';
+import { heroTagProblems, heroTagsAfterWrite, writesHeroTag } from './heroTag.js';
+import { PAGE_TRANSITIONS, resolveTransition } from './pageTransition.js';
 import { findingLine } from './profile.js';
 import { SURFACE_KEYS } from '../styleResolveNative.js';
+import { MOTION_BINDING_TYPES, MOTION_FIELDS, motionFieldBinding, motionValue } from '../motionResolve.js';
 import { DOCUMENT_STYLE_TYPES } from '../styleResolve.js';
 import { listThemeVarNames } from '../themeResolve.js';
 import { closestArgument } from '../../platform/argumentAliases.js';
+/**
+ * Uyarının yazımı durdurmadığını söyleyen cümle. OLAYI değil KURALI anlatır: aynı bulgu kuru koşuda
+ * (`page_schema_validate`) da döner ve orada hiçbir şey yazılmamıştır — "Yazım platforma gitti" kuru koşuda yanlıştı
+ * (TOOL-060, ölçüldü 2026-10-10, gerçek uç). Regresyon: `test/dry-run-wording.test.ts`.
+ */
+const NOT_BLOCKING = 'Yazım reddedilmez, platforma gider.';
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
 }
@@ -49,6 +59,7 @@ function label(node) {
 }
 const GRID_LAYOUTS = new Set(['grid', 'cssgrid']);
 const RELATIVE_UNIT = /\b\d*\.?\d+(em|rem)\b|calc\(/i;
+const TEMPLATE_VALUE = /\{\{[\s\S]*\}\}/;
 /**
  * THEME-012: mobil çizici `var(--ng-…)`'yi yalnız temanın yaydığı değişkenlerden çözer
  * (`compose-native-style.ts` `resolveThemeToken`); web'deki bileşen yerel değişkenleri (`--ng-nav-bg` …)
@@ -103,6 +114,7 @@ export function profileFindings(profile, input) {
     const floorImages = [];
     const namelessIconButtons = [];
     const unknownTokens = [];
+    const motionSkips = [];
     const hit = (map, key, target) => map.set(key, [...(map.get(key) ?? []), target]);
     const inspectTokens = (target, value) => {
         for (const name of unknownThemeTokens(value)) {
@@ -136,6 +148,42 @@ export function profileFindings(profile, input) {
                 hit(styleHits, `surfaceStyle.${key}`, target);
         }
     };
+    // MOB-028: hareket çözücüsü tanımadığı alt anahtarı ve okuyamadığı değeri ATLAR, nesne olmayan grubu hareket
+    // saymaz (frontend `resolve-motion.ts`) — yazım kabul edilir, hareket uyarısız eksik çıkar. Uyarı metni
+    // çözücününkidir. İfadeye bağlı GRUP (`code`/`translation` sarmalı; `data`sı yalnız tasarım yedeğidir) çalışma
+    // anında çözülür: burada okunamaz, denetlenmez. Grubun içindeki TEK alan ifadeye (`code`) bağlıysa o da çalışma
+    // anında değerlendirilir (frontend ADR 0020): uyarı değildir, yalnız tasarım yedeği denetlenir. Alanda çözülmeyen
+    // yazım (şablon metni, `code` dışı bağ) söylenir (`motionFieldBinding`).
+    const inspectMotion = (target, value) => {
+        if (boundWrapper(value))
+            return;
+        const raw = asRecord(value);
+        // Veri taşımayan sarmal yalnız BİLİNEN bir değer türüyse sarmaldır: alanı yanlışlıkla `type` diye yazılmış ham
+        // grup (`{ type: 'fade', duration: 300 }`) sarmal sanılıp denetimsiz geçiyordu.
+        if (raw && typeof raw.type === 'string' && (raw.type === 'static' || MOTION_BINDING_TYPES.includes(raw.type)) && !('data' in raw))
+            return;
+        const group = propValue(value);
+        if (group === undefined || group === null || group === '' || (typeof group === 'string' && TEMPLATE_VALUE.test(group)))
+            return;
+        const fields = asRecord(group);
+        if (!fields) {
+            motionSkips.push(`${target}: motionStyle: ${typeof group === 'string' ? `'${group}'` : JSON.stringify(group)} nesne değil — alanlar nesnenin içinde yazılır ({ enter: 'fade' }), hareket yok sayılır`);
+            return;
+        }
+        for (const [key, wrapped] of Object.entries(fields)) {
+            const binding = motionFieldBinding(key, wrapped);
+            if (binding?.kind === 'unresolved')
+                motionSkips.push(`${target}: ${binding.warning}`);
+            const field = binding ? binding.fallback : propValue(wrapped);
+            if (field === undefined || field === null || field === '')
+                continue;
+            const warning = MOTION_FIELDS.includes(key)
+                ? motionValue(key, field).warning
+                : `motionStyle.${key}: tanınmayan alan, atlandı`;
+            if (warning)
+                motionSkips.push(`${target}: ${warning}`);
+        }
+    };
     const inspectNode = (node) => {
         const target = label(node);
         const type = String(node.type ?? '');
@@ -154,6 +202,7 @@ export function profileFindings(profile, input) {
             gridNodes.push(`${target} (layout:${layout})`);
         inspectAppearance(target, asRecord(node.appearance));
         inspectSurface(target, props.surfaceStyle);
+        inspectMotion(target, props.motionStyle);
         for (const group of STYLE_GROUP_PROPS)
             inspectTokens(target, props[group]);
         if (type === 'image' && !imageHasDefiniteHeight(asRecord(node.appearance)))
@@ -182,7 +231,9 @@ export function profileFindings(profile, input) {
     walk(input.nodes, inspectNode);
     const savedTypes = new Map();
     walk(input.savedNodes, node => savedTypes.set(label(node), String(node.type ?? '')));
-    for (const op of input.ops ?? []) {
+    // Toplu yamanın zarfı açılır: içindeki op'lar tek tek yazılmış gibi denetlenir (TOOL-057).
+    const ops = flattenBatchOps(input.ops ?? []);
+    for (const op of ops) {
         const target = typeof op.target === 'string' ? op.target : '?';
         if (op.op === 'add_component')
             walk(op.component, inspectNode);
@@ -203,6 +254,8 @@ export function profileFindings(profile, input) {
                 hit(styleHits, 'hoverStyle', target);
             if (prop === 'surfaceStyle')
                 inspectSurface(target, op.value);
+            if (prop === 'motionStyle')
+                inspectMotion(target, op.value);
             if (STYLE_GROUP_PROPS.has(prop))
                 inspectTokens(target, op.value);
             // MOB-011: var olan düğümün tipi op'ta yok — tip biliniyorsa (aynı yazımda eklendi) ona, yoksa prop adına bakılır.
@@ -220,7 +273,7 @@ export function profileFindings(profile, input) {
             message: [
                 blockNodes.length > 0 ? `blok (12 sütun ızgara) mobil çizerde yok sayılır: ${[...new Set(blockNodes)].join(', ')}` : '',
                 gridNodes.length > 0 ? `grid/cssgrid yerleşimi yok, kap flex çizilir: ${gridNodes.join(', ')}` : ''
-            ].filter(Boolean).join(' · ') + ". Sıra dizi indeksinden, yerleşim flex'ten gelir (direction/gap/horizontalAlign). Yazım platforma gitti.",
+            ].filter(Boolean).join(' · ') + ". Sıra dizi indeksinden, yerleşim flex'ten gelir (direction/gap/horizontalAlign). " + NOT_BLOCKING,
             guide: "platform_guide('mobile')"
         });
     }
@@ -229,7 +282,33 @@ export function profileFindings(profile, input) {
             code: MOBILE_RULES['MOB-002'].id,
             severity: 'warn',
             target: [...new Set(targets)].join(', '),
-            message: `'${key}' mobilde çizilmez — ${styleReplacement(key.split(' ')[0] ?? key)}. Yazım platforma gitti.`
+            message: `'${key}' mobilde çizilmez — ${styleReplacement(key.split(' ')[0] ?? key)}. ${NOT_BLOCKING}`
+        });
+    }
+    // MOB-030: aynı sayfada aynı statik heroTag (frontend `hero-tag.ts`; ayna heroTag.ts). Sayfanın yazımdan SONRAKİ
+    // etiketleri okunur ve yalnız bu yazımın dokunduğu bir düğümü içeren yineleme söylenir — kayıtlı ağaçta zaten duran
+    // yineleme ilgisiz her yazımda yinelenmez. Bilgidir: yineleme yalnız sayfa bir yakınlaşmanın HEDEFİ olduğunda
+    // belirsizdir; kaynak sayfada aynı etiketli kartlar olağandır (kaynak dokunulan düğümdür).
+    const hero = heroTagsAfterWrite({ nodes: input.nodes, savedNodes: input.savedNodes, ops });
+    const heroDuplicates = [...new Set(hero.entries.filter(entry => entry.tag !== undefined).map(entry => entry.tag))]
+        .map(tag => hero.entries.filter(entry => entry.tag === tag))
+        .filter(group => group.length > 1 && group.some(entry => hero.written.has(entry.elementId)));
+    if (heroDuplicates.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-030'].id,
+            severity: 'info',
+            target: heroDuplicates.flatMap(group => group.map(entry => entry.elementId)).join(', '),
+            message: `${heroDuplicates.flatMap(group => heroTagProblems(group)).join(' · ')}. Yalnız bu sayfa bir yakınlaşmanın HEDEFİ olduğunda önemlidir: hizalama kutusu tektir. Kaynak sayfada aynı etiketli kartlar ve liste satırları sorun değildir (kaynak dokunulan düğümdür); hedefte ayrı öğelerse ayrı etiket verin.`,
+            guide: "platform_guide('page') §Kural 1g-3"
+        });
+    }
+    if (motionSkips.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-028'].id,
+            severity: 'warn',
+            target: [...new Set(motionSkips.map(entry => entry.split(':')[0] ?? entry))].join(', '),
+            message: `motionStyle'da çözücünün atladığı alan var, hareket eksik çıkar: ${[...new Set(motionSkips)].join(' · ')}. Alanlar: ${MOTION_FIELDS.join(', ')}. ${NOT_BLOCKING}`,
+            guide: "platform_guide('mobile')"
         });
     }
     if (unknownTokens.length > 0) {
@@ -237,7 +316,7 @@ export function profileFindings(profile, input) {
             code: 'THEME-012',
             severity: 'warn',
             target: [...new Set(unknownTokens.map(entry => entry.split(':')[0] ?? entry))].join(', '),
-            message: `temada tanımlı olmayan jeton cihazda çözülmez (zemin saydam kalır, iOS gölgesi içeriğe düşer): ${[...new Set(unknownTokens)].join(' · ')}. Geçerli adlar temanın yaydığı değişkenlerdir (theme_get); bilerek kullanıyorsanız yedek verin: var(--ad, #fff). Yazım platforma gitti.`,
+            message: `temada tanımlı olmayan jeton cihazda çözülmez (zemin saydam kalır, iOS gölgesi içeriğe düşer): ${[...new Set(unknownTokens)].join(' · ')}. Geçerli adlar temanın yaydığı değişkenlerdir (theme_get); bilerek kullanıyorsanız yedek verin: var(--ad, #fff). ${NOT_BLOCKING}`,
             guide: "platform_guide('theme')"
         });
     }
@@ -291,12 +370,14 @@ export function profileFindings(profile, input) {
             code: MOBILE_RULES['MOB-011'].id,
             severity: 'warn',
             target: fileIdSources.map(source => source.target).join(', '),
-            message: `${[...new Set(fileIdSources.map(source => `'${source.expression}'`))].join(', ')} '.value' ile bitiyor — kayıttan okunan FILE alanı { type: 'ref', value: <dosya id>, absolute_path: <url> } döner ve '.value' dosya KİMLİĞİDİR (GUID), görsel çizilmez. Nesnenin kendisini verin ('${object}') ya da '.absolute_path' yazın. Gateway alan tipini sayfa şemasından bilemez: yol FILE alanı değilse (ör. URL taşıyan metin alanı) uyarıyı yok sayın. Yazım platforma gitti.`,
+            message: `${[...new Set(fileIdSources.map(source => `'${source.expression}'`))].join(', ')} '.value' ile bitiyor — kayıttan okunan FILE alanı { type: 'ref', value: <dosya id>, absolute_path: <url> } döner ve '.value' dosya KİMLİĞİDİR (GUID), görsel çizilmez. Nesnenin kendisini verin ('${object}') ya da '.absolute_path' yazın. Gateway alan tipini sayfa şemasından bilemez: yol FILE alanı değilse (ör. URL taşıyan metin alanı) uyarıyı yok sayın. ${NOT_BLOCKING}`,
             guide: "platform_guide('mobile') §Dosya ve fotoğraf"
         });
     }
     const infoSteps = new Map();
     const badPresentation = new Map();
+    const badTransition = new Map();
+    const unusedTransition = new Map();
     walkSteps(input.steps, step => {
         const type = String(step.type ?? '');
         if (profile.steps.infoOnly.has(type))
@@ -307,10 +388,24 @@ export function profileFindings(profile, input) {
             return;
         const args = asRecord(step.args);
         const presentation = args?.presentation;
+        const stepId = String(step.stepId ?? step.name ?? '?');
+        // MOB-029: geçişin kararını çalışma zamanının çözücüsü verir (ayna: pageTransition.ts) — lint ikinci bir kural
+        // yazmaz. Alan YOKSA bulgu yok: adım uygulamanın varsayılanını kullanır. Sekme hedefi burada bilinmez
+        // (lint sekme ayarını görmez); o durumda da geçiş kullanılmaz ve rehber bunu söyler.
+        // Akış araçları bu lint'i BAŞARILI yazımdan sonra koşar ve küme dışı değeri backend 422 ile önce reddeder: uyarı
+        // dalı bugün yalnız backend'in doğrulamadığı bir yazım yolunda konuşur (MOB-008 ile aynı durum); bilgi dalı canlıdır.
+        if (args?.transition !== undefined && args.transition !== null && args.transition !== '') {
+            const resolved = resolveTransition({ step: args.transition, presentation }, { reduceMotion: false });
+            const written = typeof args.transition === 'string' ? args.transition : JSON.stringify(args.transition);
+            if (resolved.warnings.length > 0)
+                hit(badTransition, written, stepId);
+            else if (resolved.fixedBy === 'modal')
+                hit(unusedTransition, written, stepId);
+        }
         if (presentation === undefined || presentation === null || presentation === '')
             return;
         if (!REDIRECT_PRESENTATIONS.has(String(presentation))) {
-            hit(badPresentation, String(presentation), String(step.stepId ?? step.name ?? '?'));
+            hit(badPresentation, String(presentation), stepId);
         }
     });
     for (const [value, stepIds] of badPresentation) {
@@ -322,6 +417,24 @@ export function profileFindings(profile, input) {
             guide: "platform_guide('mobile')"
         });
     }
+    for (const [value, stepIds] of badTransition) {
+        findings.push({
+            code: MOBILE_RULES['MOB-029'].id,
+            severity: 'warn',
+            target: stepIds.join(', '),
+            message: `redirect.transition '${value}' tanınmıyor — ${PAGE_TRANSITIONS.join(', ')} bekleniyor. Backend doğrulayıcısı 422 döner; alanı yazmazsanız adım uygulamanın varsayılan geçişiyle açılır.`,
+            guide: "platform_guide('page') §Kural 1g-2"
+        });
+    }
+    for (const [value, stepIds] of unusedTransition) {
+        findings.push({
+            code: MOBILE_RULES['MOB-029'].id,
+            severity: 'info',
+            target: stepIds.join(', '),
+            message: `redirect.transition '${value}' modal sunumla birlikte yazılmış — modal sistemin kağıt animasyonuyla açılır, geçiş kullanılmaz (hedef bir sekme sayfasıysa da kullanılmaz: sekme değişir).`,
+            guide: "platform_guide('page') §Kural 1g-2"
+        });
+    }
     for (const [type, stepIds] of infoSteps) {
         findings.push({
             code: MOBILE_RULES['MOB-005'].id,
@@ -345,6 +458,15 @@ function walkSteps(value, visit) {
         walkSteps(step.steps, visit);
     }
 }
+/**
+ * Denetim bu yama için kayıtlı ağacı ister mi (`ProfileLintInput.savedNodes`): `style` yazımında hedefin tipi (belge
+ * CSS'i taşıyan düğüm mü — MOB-002), `heroTag` yazımında sayfanın öteki etiketleri (MOB-030). Çağıran ağacı yalnız bu
+ * durumda okur. Denetimle AYNI op listesine bakar (zarf açılır): 2026-10-10'da denetim zarfı açıp çağıran açmayınca
+ * kayıtlı `html` düğümünün belge CSS'i zarf içinde yanlış MOB-002 aldı (regresyon `test/batch-profile-lint.test.ts`).
+ */
+export function profileLintReadsSavedNodes(ops) {
+    return writesHeroTag(ops) || flattenBatchOps(ops).some(op => (op.op === 'replace_prop' || op.op === 'set_binding') && op.prop === 'style');
+}
 /** Bulguları `layoutWarnings[]` satırlarına çevirir. */
 export function findingLines(findings) {
     return findings.map(findingLine);

package/dist/knowledge/platform/mobile.js

@@ -116,7 +116,7 @@ export const mobileProfile = Object.freeze({
     },
     style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back', 'scan-code']),
         aliases: STEP_ALIASES,
         infoOnly: new Set(['download', 'setcookie'])
     },

package/dist/knowledge/platform/mobileLayoutLint.js

@@ -1,4 +1,4 @@
-import { MOBILE_DROPPABLE_TYPES, MOBILE_OUT_OF_FLOW_TYPES, MOBILE_TRANSPARENT_WRAPPER_TYPES } from '../mobileComponentCatalog.js';
+import { MOBILE_DROPPABLE_TYPES, MOBILE_OPTIONAL_VIEW_INDEX, MOBILE_OUT_OF_FLOW_TYPES, MOBILE_TRANSPARENT_WRAPPER_TYPES } from '../mobileComponentCatalog.js';
 import { PAGE_CONTAINER_ELEMENT_ID } from '../normalize.js';
 import { OVERLAY_TYPES, firstDrawn, safeAreaEdges, topSafeAreaMissing } from './mobile.js';
 import { MOBILE_RULES } from './mobileRules.js';
@@ -82,6 +82,8 @@ export function mobileLayoutFindings(input) {
             return;
         if (type === 'safe-area' && ancestors.length === 0)
             return;
+        if (isOptionalView(node, ancestors.at(-1)))
+            return;
         findings.push({ ...rule('MOB-018', label(node), `boş ${type}: ekranda boş şerit bırakır${type === 'safe-area' ? ` (edges: '${safeAreaEdges(node)}' payı kadar)` : ''}. İçeriğini ekleyin ya da silin`), severity: 'info' });
     });
     if (screenRoot)
@@ -282,6 +284,11 @@ function key(finding) {
 function rule(code, target, message) {
     return { code: MOBILE_RULES[code].id, severity: MOBILE_RULES[code].severity, target, message, guide: "platform_guide('mobile-layout')" };
 }
+/** Sabit görünümlü sahibinin bilerek boş bırakılabilen görünümü: veri yokken açılan görünüm (`MOBILE_OPTIONAL_VIEW_INDEX`). */
+function isOptionalView(node, parent) {
+    const index = MOBILE_OPTIONAL_VIEW_INDEX[String(parent?.type ?? '')];
+    return index !== undefined && asNodes(parent?.children).filter(child => child.type === 'view')[index] === node;
+}
 function asNodes(value) {
     return Array.isArray(value) ? value.filter((item) => !!item && typeof item === 'object') : [];
 }

package/dist/knowledge/platform/mobileRules.js

@@ -114,6 +114,24 @@ export const MOBILE_RULES = {
         severity: 'info',
         sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S5/S7/S11',
         summary: 'Ölçek dışı değer: özel boşluk ya da sayısal gap 0/4/8/16/24/32 dışında, ham yarıçap, px yazı boyu'
+    },
+    'MOB-028': {
+        id: 'MOB-028',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/resolve-motion.ts (tanınmayan alan ve okunamayan değer atlanır)',
+        summary: "Mobil motionStyle'da tanınmayan alt anahtar ya da küme/aralık dışı değer — çözücü atlar, hareket eksik çıkar"
+    },
+    'MOB-029': {
+        id: 'MOB-029',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/resolve-transition.ts (çözücü; ayna pageTransition.ts); zeyrek-backend FlowDtoValidator (StepTransition); simülatör ölçümü 2026-10-10',
+        summary: "redirect.transition ya da properties.mobile.transition kümede değil (default | none | fade | slide | slideUp) — adımda backend 422; modal sunumda yazılan geçiş kullanılmaz (bilgi)"
+    },
+    'MOB-030': {
+        id: 'MOB-030',
+        severity: 'info',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/hero-tag.ts (kural; ayna heroTag.ts); zeyrek-frontend/docs/adr/0022-hero-yolu.md; simülatör ölçümü 2026-10-10',
+        summary: "Aynı sayfada aynı statik heroTag'i birden çok düğüm taşıyor — sayfa yakınlaşmanın hedefi olduğunda ilk çizilen hizalanır; kaynak sayfada sorun değildir"
     }
 };
 /**

package/dist/knowledge/platform/pageTransition.js

@@ -0,0 +1,57 @@
+/**
+ * Mobil sayfa geçişinin gateway aynası: sözlük ve çözücü. Kaynak frontend'dedir
+ * (`zeyrek-frontend/packages/ng-apps-ui-native/src/motion/` — `transition-fields.ts`, `resolve-transition.ts`;
+ * uygulama ayarının okuyucusu `src/shell/mobile-transition.ts`). Bu dosya onun kopyasıdır ve
+ * `test/page-transition-parity.test.ts` ile kilitlidir: frontend'in altın vakaları (`transition-golden.json`) aynı
+ * girdiden aynı çıktıyı ve harfi harfine aynı uyarıyı vermeli; aynı dosyanın `values` listesi backend enum'unun
+ * (`StepTransition`) kopyasına da kilitlidir. Test kırılınca test düzeltilmez, bu dosya senkronlanır.
+ *
+ * Değerler ürünün dilidir; yerel yığının adları (`slide_from_right`) burada geçmez. Kuralların ölçümü:
+ * simülatör, 2026-10-10 (`zeyrek-frontend/docs/features/mobile-runtime.md` §Sayfa geçişi).
+ */
+export const PAGE_TRANSITIONS = ['default', 'none', 'fade', 'slide', 'slideUp'];
+/** Boş değer ne değer ne uyarıdır (seçilmemiş); kümede olmayan değer `value` taşımaz. */
+export function transitionValue(raw, source) {
+    if (raw === undefined || raw === null || (typeof raw === 'string' && raw.trim() === ''))
+        return {};
+    if (typeof raw === 'string' && PAGE_TRANSITIONS.includes(raw))
+        return { value: raw };
+    return {
+        warning: `${source}: ${typeof raw === 'string' ? `'${raw}'` : JSON.stringify(raw)} geçersiz — ${PAGE_TRANSITIONS.join(', ')}, atlandı`
+    };
+}
+export const TRANSITION_SOURCES = { step: 'redirect.transition', application: 'properties.mobile.transition' };
+/**
+ * "Bu gezinmede hangi geçiş oynar." Öncelik: adım → uygulama varsayılanı → `default`; okunamayan değer uyarısıyla
+ * atlanır. Sekme hedefi ve `modal` sunum seçimi kullanmaz (sekme önce gelir). "Hareketi azalt"ta seçilmiş geçiş
+ * `none` olur, `default` sisteme kalır.
+ */
+export function resolveTransition(input, context) {
+    const step = transitionValue(input.step, TRANSITION_SOURCES.step);
+    const application = transitionValue(input.application, TRANSITION_SOURCES.application);
+    const warnings = [step.warning, application.warning].filter((warning) => warning !== undefined);
+    if (input.tabTarget)
+        return { transition: 'default', fixedBy: 'tab', warnings };
+    if (input.presentation === 'modal')
+        return { transition: 'default', fixedBy: 'modal', warnings };
+    const chosen = step.value ?? application.value ?? 'default';
+    return { transition: context.reduceMotion && chosen !== 'default' ? 'none' : chosen, warnings };
+}
+/**
+ * `properties.mobile.transition`'ın HAM değeri; alan yoksa `undefined`. Frontend'in `readMobileTransition`'ı doğrulanmış
+ * değeri verir ve bozuk olanı sessizce düşürür; gateway uyarmak için ham değeri ister — adı bu yüzden farklı.
+ */
+export function rawMobileTransition(properties) {
+    const mobile = properties?.mobile;
+    return mobile && typeof mobile === 'object' ? mobile.transition : undefined;
+}
+/**
+ * MOB-029'un uygulama ayarı ayağı. Backend `properties`'i doğrulamaz (jsonb serbest) ve cihazın okuyucusu sözlük
+ * dışı değeri SESSİZCE düşürür — uyarının verildiği tek yer burasıdır.
+ */
+export function mobileTransitionProblems(properties) {
+    const { warning } = transitionValue(rawMobileTransition(properties), TRANSITION_SOURCES.application);
+    return warning
+        ? [`${warning} — cihaz değeri okumaz, geçişini seçmemiş yönlendirme adımları sistemin geçişiyle açılır`]
+        : [];
+}

package/dist/knowledge/platform/web.js

@@ -20,7 +20,7 @@ export const webProfile = Object.freeze({
     },
     style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back', 'scan-code']),
         aliases: STEP_ALIASES,
         infoOnly: new Set()
     },

package/dist/knowledge/rules.js

@@ -173,6 +173,7 @@ const flowBranchNames = {
     'open-settings': ['always'],
     'ad-show': ['always', 'error'],
     back: ['always'],
+    'scan-code': ['always', 'error'],
     end: []
 };
 /**
@@ -185,7 +186,7 @@ export const knownFlowStepTypes = new Set([
     'start', 'end', 'query', 'setter', 'download', 'condition', 'redirect', 'setcookie', 'alert', 'confirm',
     'microservice', 'validation', 'flow-trigger', 'storage', 'navigate', 'code', 'function', 'share',
     'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'bpm',
-    'permission', 'open-settings', 'ad-show', 'back'
+    'permission', 'open-settings', 'ad-show', 'back', 'scan-code'
 ]);
 /**
  * Cihaz yeteneği adımlarının kapalı kümeleri — `@ng-apps/flow` `tasks/device/device.functions.ts`
@@ -199,6 +200,12 @@ export const locationAccuracies = new Set(['low', 'balanced', 'high']);
  * ve `adBanner.unit` bu adla mağaza ayarındaki yerleşimi anar.
  */
 export const adPlacementNamePattern = /^[a-z][A-Za-z0-9]{0,39}$/;
+/**
+ * `scan-code` adımının kod türleri — `@ng-apps/flow` `SCAN_CODE_TYPES`'ın aynası (kök ADR 0017); altın dosya
+ * `scan-code-golden.json` ile kilitlidir (`test/flow-step-parity.test.ts`), backend `ScanCodeType` aynı kümeyle 422 döner.
+ * `upc_a` bilerek yok: UPC-A etiketi iki platformda `ean13` ve on üç haneyle döner.
+ */
+export const scanCodeTypes = new Set(['aztec', 'codabar', 'code39', 'code93', 'code128', 'datamatrix', 'ean8', 'ean13', 'itf14', 'pdf417', 'qr', 'upc_e']);
 /** `permission` adımının kipleri — `@ng-apps/flow` `PERMISSION_MODES`'un aynası (kök ADR 0010); tür adını gateway bilmez, backend doğrular. */
 export const permissionStepModes = new Set(['request', 'check']);
 /**
@@ -2710,6 +2717,50 @@ export const policyRules = [
             return findings;
         })
     },
+    {
+        id: 'FLOW-042',
+        module: 'flow',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Kod tarama adımının argümanı StepManagementArgument'ın mevcut alanlarındadır (kök docs/adr/0017-kod-tarama-akis-adimi.md): scan-code.value = izinli kod türleri (sözlükten virgüllü küme, DÜZ METİN; boş → hepsi), scan-code.title = ekrandaki yönerge (metin şablonu, FLOW-022). Backend FlowDtoValidator her adı ScanCodeType kümesiyle BİREBİR karşılaştırır (büyük harf ve ifade sarmalı 422, FlowStepScanCodeTypeUnknown); çalışma zamanı sözlük dışı adda ekranı açmaz, `invalid` döner. upc_a sözlükte yoktur: UPC-A etiketi iki platformda ean13 ve on üç haneyle (başında 0) döner. types / formats / barcodeTypes anahtarları sözleşmede yok, 200 ile sessizce düşer ve adım bütün türleri okur.",
+        check: definition => flowAllSteps(definition)
+            .filter(step => step.type === 'scan-code')
+            .flatMap((step) => {
+            const args = (step.args ?? {});
+            const raw = typeof args.value === 'string' ? args.value : '';
+            const names = raw.split(',').map(name => name.trim()).filter(name => name !== '');
+            const unknown = names.filter(name => !scanCodeTypes.has(name));
+            const stray = ['types', 'formats', 'barcodeTypes', 'codeTypes', 'type'].filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
+            const allowed = [...scanCodeTypes].join(', ');
+            const findings = [];
+            if (unknown.length > 0) {
+                const unquoted = raw.replace(/^['"`](.*)['"`]$/, '$1');
+                const lowered = unknown.filter(name => scanCodeTypes.has(name.toLowerCase()));
+                findings.push({
+                    ruleId: 'FLOW-042',
+                    severity: 'block',
+                    message: unquoted !== raw && unquoted.split(',').every(name => scanCodeTypes.has(name.trim()))
+                        ? `'${flowStepLabel(step)}' scan-code adımının kod türleri tırnaklı yazılmış: ${raw}. Bu alan DÜZ METİNDİR, ifade değil — args.value: '${unquoted}' yazın.`
+                        : /\{\{|\}\}|[()[\]]|\bstate\b|\bSteps\b/.test(raw)
+                            ? `'${flowStepLabel(step)}' scan-code adımının kod türleri ifade olarak yazılmış: ${raw}. Bu alan DÜZ METİNDİR ve olduğu gibi okunur (platform 422 döner) — türleri virgülle yazın ya da hepsi için boş bırakın. Kullanılabilir: ${allowed}.`
+                            : unknown.includes('upc_a')
+                                ? `'${flowStepLabel(step)}' scan-code adımında 'upc_a' sözlükte yok: UPC-A etiketi iki platformda 'ean13' türüyle ve on üç haneyle (başında 0) döner — 'ean13' yazın (platform 422 döner). Kullanılabilir: ${allowed}.`
+                                : lowered.length > 0
+                                    ? `'${flowStepLabel(step)}' scan-code adımının kod türü büyük harfle yazılmış: ${lowered.join(', ')}. Adlar küçük harftir ve birebir karşılaştırılır (platform 422 döner) — ${lowered.map(name => `'${name.toLowerCase()}'`).join(', ')} yazın.`
+                                    : `'${flowStepLabel(step)}' scan-code adımının kod türü tanınmıyor: ${unknown.join(', ')}; platform 422 döner. Kullanılabilir: ${allowed} (boş → hepsi).`,
+                    guide: 'ngapps://guides/mobile-steps'
+                });
+            }
+            if (stray.length > 0) {
+                findings.push({
+                    ruleId: 'FLOW-042',
+                    severity: names.length > 0 ? 'warn' : 'block',
+                    message: `'${flowStepLabel(step)}' scan-code adımında args.${stray.join('/args.')} alanı var: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür ve adım bütün kod türlerini okur. Türler args.value'ya virgüllü düz metin olarak yazılır (ör. 'qr,ean13'). Kullanılabilir: ${allowed}.`,
+                    guide: 'ngapps://guides/mobile-steps'
+                });
+            }
+            return findings;
+        })
+    },
     {
         id: 'FLOW-041',
         module: 'flow',

package/dist/knowledge/styleResolveNative.js

@@ -1,3 +1,4 @@
+import { motionFieldBinding, resolveMotion } from './motionResolve.js';
 import { TRANSFORM_RANGES, rawProp, resolveNodeStyleLayers, transformValue } from './styleResolve.js';
 import { mergeTypeScale, resolveTheme } from './themeResolve.js';
 /* ---- css-value.ts ---- */
@@ -440,6 +441,8 @@ const composeSurface = (surface, shell, theme, context) => {
             context.warnings?.push(`surfaceStyle.${key}: mobilde karşılığı yok, atlandı`);
     }
 };
+/** Tipografi grubunun `composeTypography`'nin okuduğu alanları (frontend derleyicisiyle parite: `test/style-resolve-native.test.ts`). */
+export const TYPOGRAPHY_KEYS = new Set(['textColor', 'fontFamily', 'fontSize', 'fontWeight', 'fontStyle', 'textDecoration', 'textAlign', 'letterSpacing', 'lineHeight']);
 const composeTypography = (typography, text, theme, context) => {
     const color = asText(typography.textColor, theme, context.warnings, 'typographyStyle.textColor');
     if (color)
@@ -510,20 +513,101 @@ export function composeNativeStyle(input, theme) {
  * Bir düğümün mobil çizerdeki stili (`NativeRenderer` → `nativeNodeStyle`, `renderer.functions.ts`). Temanın katmanı
  * (`componentStyles[tip]` ← `$preset`) web'in çözücüsünden gelir ve TABANDIR; panel grupları üstüne, düğümün serbest
  * `style`'ı son söz; `$preset` işareti RN stiline inmez (plans/mobil-plantcare-acigi f-16 — 2026-09-28'e dek çizer bu
- * katmanı okumuyordu, rapor da okumuyordu). İfadeye bağlı prop çalışma anında çözülür, burada yok.
+ * katmanı okumuyordu, rapor da okumuyordu). İfadeye bağlı prop çalışma anında çözülür, burada yok: grubu bağlı düğümde
+ * grup (tasarım yedeği taşısa da) stile girmez; yüzey ve tipografi grubunun TEK alanı bağlıysa (`{ type: 'code', ref }`,
+ * frontend ADR 0020) o alan stile girmez ve `bound`'da `<grup>.<alan>` diye listelenir — yedeği çizerin verdiği değer
+ * değildir (yedeksiz sarmal `"[object Object]"` yazılıyordu, inceleme 2026-10-09). Çizerin TANIMADIĞI alan bağlı olsa da
+ * bağlı alan değildir (`bound`'a girmez; yüzeyde derleyicinin "karşılığı yok" uyarısı düşer). `ref`'i boş `code` sarmalı
+ * bağ değildir: verisi ham değer okunur; verisiz sarmal alanı yok sayar (çizer `mapSchemaPropToRawProp` ile aynı).
+ *
+ * `motion`, kabuğun `motionStyle`'dan uyguladığı harekettir (`NativeRenderer` → `nodeMotionOf`, `/dev` ve cihaz):
+ * yalnız hareketi olan düğümde yazılır. Kanvas ve "hareketi azalt" onu dondurur — rapor dondurulmamış çözümdür.
  */
 export function nodeNativeStyle(node, theme, source) {
     const props = node.props;
+    const bound = [];
     const group = (name) => {
         const value = rawProp(props, name);
         return isPlainObject(value) ? value : null;
     };
+    const evaluated = (name, known) => {
+        const value = isBound(props?.[name]) ? null : group(name);
+        if (!value)
+            return value;
+        const kept = { ...value };
+        for (const [field, wrapper] of fieldWrappers(props?.[name])) {
+            if (!isExpression(wrapper)) {
+                if (!('data' in wrapper))
+                    delete kept[field];
+            }
+            else if (known.has(field)) {
+                delete kept[field];
+                bound.push(`${name}.${field}`);
+            }
+            else {
+                // Tanınmayan alan: sarmalı değer olarak kalır ki derleyicinin kendi "karşılığı yok" uyarısı düşsün.
+                kept[field] = wrapper;
+            }
+        }
+        return kept;
+    };
     const layers = resolveNodeStyleLayers(rawProp(props, 'style'), source, node.type);
-    return composeNativeStyle({
+    const composed = composeNativeStyle({
         themeStyle: layers.theme,
-        surfaceStyle: group('surfaceStyle'),
-        typographyStyle: group('typographyStyle'),
+        surfaceStyle: evaluated('surfaceStyle', SURFACE_KEYS),
+        typographyStyle: evaluated('typographyStyle', TYPOGRAPHY_KEYS),
         hoverStyle: group('hoverStyle'),
         style: layers.own
     }, theme);
+    const style = bound.length > 0 ? { ...composed, bound } : composed;
+    const resolved = nodeMotion(props?.motionStyle);
+    if (!resolved)
+        return style;
+    const { warnings, ...motion } = resolved;
+    const reported = { ...style, warnings: [...style.warnings, ...warnings] };
+    // Hareket çıkmadıysa (yalnız atlanan alanlar) `motion` yazılmaz; uyarıları yine listededir.
+    return Object.keys(motion).length > 0 ? { ...reported, motion } : reported;
+}
+const RUNNING = { design: false, reduceMotion: false };
+/**
+ * İfadeye bağlı GRUP zarfı (`code`, `translation`): değeri çalışma anında oluşur. Zarfın `data`'sı tasarım zamanı
+ * yedeğidir (kanvasın gösterdiği değer), çizerin uyguladığı değer değil — rapora girmez.
+ */
+const isBound = (value) => isPlainObject(value) && (value.type === 'code' || value.type === 'translation');
+/**
+ * Statik grubun sarmallı alanları (`{ type, data?, ref? }`), ham hâlleriyle. Tasarım şeması statik sarmala
+ * `type: 'static'` yazar, yayınlanan sayfanın yükü yazmaz (backend `AppProp`, 2026-10-04'ten beri; statik alanda
+ * `type: null` gelir) — ikisi de statiktir (frontend `inner-bindings.ts` `fieldsOf` ile aynı kural). Yalnız yazılı
+ * `type`'ı tanıyan ilk sürüm gerçek yükte bağlı alanı hiç görmüyordu (ölçüldü 2026-10-09).
+ */
+const fieldWrappers = (prop) => Object.entries(isPlainObject(prop) && (prop.type ?? 'static') === 'static' && isPlainObject(prop.data) ? prop.data : {})
+    .filter((entry) => isPlainObject(entry[1]) && typeof entry[1].type === 'string');
+/** İfadeye bağlı alan sarmalı: çizer onu çalışma anında değerlendirir (frontend ADR 0020, `inner-bindings.ts` `isCodeBinding`). */
+const isExpression = (wrapper) => wrapper.type === 'code' && typeof wrapper.ref === 'string' && wrapper.ref !== '';
+/**
+ * Düğümün ham `motionStyle` prop'undan (zarfıyla) çalışma anı çözümü. Bağlı grup atlanır. Grubun içindeki tek alan
+ * ifadeye bağlıysa (`code`) değeri çalışma anında oluşur: çözüme girmez, `bound`'da adıyla listelenir — tasarım yedeği
+ * çizerin uyguladığı değer değildir. Çözülmeyen yazım (şablon metni, `code` dışı bağ) uyarısıyla listenin başındadır;
+ * çizerin ham değer olarak okuduğu verisi varsa çözüme o girer (`motionFieldBinding`).
+ */
+function nodeMotion(prop) {
+    if (!isPlainObject(prop) || isBound(prop) || !isPlainObject(prop.data))
+        return null;
+    const unresolved = [];
+    const bound = [];
+    const written = Object.fromEntries(Object.entries(prop.data).flatMap(([field, value]) => {
+        const binding = motionFieldBinding(field, value);
+        if (!binding)
+            return [[field, value]];
+        if (binding.kind === 'expression') {
+            bound.push(field);
+            return [];
+        }
+        unresolved.push(binding.warning);
+        return binding.fallback === undefined ? [] : [[field, { type: 'static', data: binding.fallback }]];
+    }));
+    const resolved = resolveMotion(rawProp({ motionStyle: { type: 'static', data: written } }, 'motionStyle'), RUNNING);
+    if (!resolved && unresolved.length === 0 && bound.length === 0)
+        return null;
+    return { ...resolved, ...(bound.length > 0 ? { bound } : {}), warnings: [...unresolved, ...(resolved?.warnings ?? [])] };
 }

package/dist/platform/capture/actions.js

@@ -20,6 +20,9 @@ export function actionScript(action, captureTarget = studioWebTarget) {
     // Seçeneklerin arandığı kök: web'de kutunun kabı (`scope`), mobilde belge (liste `Modal` katmanında).
     const optionRoot = captureTarget.optionsOutsideNode ? 'document' : 'scope';
     if (action.action === 'click') {
+        // `<elementId>__press` basış yüzeyinin KENDİSİDİR (frontend K2 sözleşmesi): içinde düğme taşıyan yüzeyde
+        // (`flip-card` — web'de iç içe `<button>` olmasın diye `div` çizilir) ilk düğmeye inilmez.
+        const pressSurface = String(action.target ?? '').endsWith(`${INTERNAL_ROLE_SEPARATOR}press`);
         return `(function () {
       var count = performance.getEntriesByType('resource').length;
       var node = document.querySelector(${selector});
@@ -29,7 +32,7 @@ export function actionScript(action, captureTarget = studioWebTarget) {
       // çipin "kaldır" düğmesidir — eskiden ona basılıp seçim siliniyordu (37 S-18). Tek basışlı
       // denetimin yüzeyi <id>__press'tir (ui-native press-role-guard), anahtarınki role="switch".
       var press = document.querySelector(${JSON.stringify(`[data-element-id="${String(action.target ?? '')}${INTERNAL_ROLE_SEPARATOR}press"]`)});
-      var target = node.matches('button, a, [role="button"], [role="switch"], [role="combobox"]') ? node
+      var target = ${pressSurface} || node.matches('button, a, [role="button"], [role="switch"], [role="combobox"]') ? node
         : (press || node.querySelector('button, a, [role="button"], [role="switch"]') || node);
       // S-2: sekme grubunun KÖKÜNE click, DOM sırasındaki ilk sekmeye gider ve "uygulandı" der —
       // ajan ikinci sekmeyi hiç seçemiyordu (2026-09-16 raporu madde 6). Sekme seçmek 'tab'in işi.