@appaflytech/zeyrek-ai-mcp 0.0.41 → 0.0.43

package/dist/platform/capture/capture.js

@@ -2,6 +2,7 @@ import { PlatformApiError } from '../errors.js';
 import { parseDomSummary } from '../domSummary.js';
 import { INTERNAL_ROLE_SEPARATOR, knownInternalRoles } from '../../knowledge/componentCatalog.js';
 import { logStep } from '../../observability/trace.js';
+import { PersistentScreenshotBrowser, persistentContextOpener, screenshotProfileRoot } from './persistent-browser.js';
 import { actionScript, activeTabScript, rootElementId, runtimePropsScript } from './actions.js';
 import { domSummaryScript } from './summary.js';
 import { createPageConsoleLog, describePageFailure, isExpressionEcho, parseRenderErrors, renderErrorsScript, splitExpressionErrors } from './console-log.js';
@@ -280,22 +281,18 @@ export class StudioScreenshotter {
         catch {
             throw new PlatformApiError('playwright-core paketi yüklü değil — zeyrek-mcp dizininde `npm install playwright-core` çalıştırın, ardından tarayıcı için `npx playwright-core install chromium`.');
         }
-        logStep('tarayıcı →', 'chromium başlatılıyor (ilk çağrı — sonraki çağrılar önbellekteki tarayıcıyı kullanır)');
+        logStep('tarayıcı →', `chromium başlatılıyor (ilk çağrı — sonraki çağrılar önbellekteki tarayıcıyı kullanır) · profil ${screenshotProfileRoot()}`);
+        const open = persistentContextOpener(chromium, this.config.screenshotBrowserPath ? { executablePath: this.config.screenshotBrowserPath } : {});
+        const browser = new PersistentScreenshotBrowser(open);
         try {
-            return await chromium.launch({
-                headless: true,
-                ...(this.config.screenshotBrowserPath ? { executablePath: this.config.screenshotBrowserPath } : {})
-            });
+            // İlk bağlam burada açılır ki başlatma hatası eskisi gibi `launch()`'tan dönsün.
+            await (await browser.newContext({ viewport: { width: 1280, height: 720 }, deviceScaleFactor: 1 })).close();
         }
         catch (firstError) {
-            try {
-                return await chromium.launch({ headless: true, channel: 'chrome' });
-            }
-            catch {
-                const message = firstError instanceof Error ? firstError.message : String(firstError);
-                throw new PlatformApiError(`Chromium başlatılamadı: ${message}. \`npx playwright-core install chromium\` ile indirin; alternatif olarak sistemdeki tarayıcının yolunu SCREENSHOT_BROWSER_PATH ile verin (alpine imajında \`apk add chromium\` + /usr/bin/chromium-browser).`);
-            }
+            const message = firstError instanceof Error ? firstError.message : String(firstError);
+            throw new PlatformApiError(`Chromium başlatılamadı: ${message}. \`npx playwright-core install chromium\` ile indirin; alternatif olarak sistemdeki tarayıcının yolunu SCREENSHOT_BROWSER_PATH ile verin (alpine imajında \`apk add chromium\` + /usr/bin/chromium-browser).`);
         }
+        return browser;
     }
     /**
      * Bekleme stratejisi bilinçli olarak `networkidle` DEĞİL: Studio'nun kök layout'u
@@ -331,7 +328,7 @@ export class StudioScreenshotter {
                 before.note = action.target === '__tabs' || action.target.startsWith(`__tabs${INTERNAL_ROLE_SEPARATOR}`)
                     ? `'${action.target}' sayfada yok: bu sayfa sekme çubuğunda değil ya da uygulamada sekmeler kapalı (application_get → properties.mobile.tabs). Sekme öğesinin kimliği __tabs__item-<sayfa slug'ı>.`
                     : action.target.includes(INTERNAL_ROLE_SEPARATOR)
-                        ? `'${action.target}' sayfada yok. Bu bir İÇ ROL hedefi: biçim <elementId>__<rol> ve bilinen roller — ${knownInternalRoles().join(' · ')}. Kolon rolleri kolonun SLUG'ından türer (başlığından değil); satır sırası 0 tabanlıdır ve sayfa değişince yeniden numaralanır.`
+                        ? `'${action.target}' sayfada yok. Bu bir İÇ ROL hedefi: biçim <elementId>__<rol> ve bilinen roller — ${knownInternalRoles().join(' · ')}. Roller görünen metinden değil kayıttaki anahtardan türer (sekme key'i, kart id'si); hedef bileşenin rollerini component_get çıktısındaki internalRoles verir.`
                         : `'${action.target}' elementId'si sayfada yok. page_schema_get ile elementId'leri listeleyin; bir komponentin İÇ kontrolünü hedefliyorsanız <elementId>__<rol> biçimini kullanın (component_get çıktısındaki internalRoles).`;
             }
             // Olay akışı uç çağırıyor: yerleşme beklemeden sonraki istek sayısını ölçmek "istek gitti mi"

package/dist/platform/capture/persistent-browser.js

@@ -0,0 +1,130 @@
+import { mkdir } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * Tarayıcı SABİT bir profille açılır. `chromium.launch()` her başlatmada geçici bir profil
+ * kuruyordu ve Chrome her yeni profilde Windows parolasının boş olup olmadığını sınıyor; bu
+ * sınama Security log'a başarısız oturum açma (4625, LogonType 2, 0xc000006a, chrome.exe)
+ * olarak düşüyor ve 10 dakikada 10 çekim yerel hesabı kilitliyordu (0xc0000234).
+ *
+ * Profil yalnız bu araca aittir; kullanıcının gerçek Chrome profili (Google\Chrome\User Data)
+ * hiçbir koşulda kullanılmaz. Profil dizini aynı anda tek süreç tarafından açılabildiği için
+ * (iki MCP oturumu) dolu dizinde sıradaki SABİT yuvaya geçilir — yuva sayısı sınırlıdır, her
+ * yuvanın sınaması ömründe bir kez olur.
+ */
+export const screenshotProfileRoot = () => path.join(process.env.LOCALAPPDATA ?? path.join(os.homedir(), '.cache'), 'zeyrek-mcp');
+const profileSlots = ['chrome-profile', 'chrome-profile-2', 'chrome-profile-3'];
+/** Yuvaları sırayla dener; her yuvada önce verilen tarayıcı, sonra sistem Chrome'u (`channel: 'chrome'`). */
+export function persistentContextOpener(chromium, primary) {
+    return async (deviceScaleFactor) => {
+        const root = screenshotProfileRoot();
+        let firstError;
+        for (const slot of profileSlots) {
+            const userDataDir = path.join(root, slot);
+            await mkdir(userDataDir, { recursive: true });
+            for (const launch of [primary, { channel: 'chrome' }]) {
+                try {
+                    return await chromium.launchPersistentContext(userDataDir, { headless: true, deviceScaleFactor, ...launch });
+                }
+                catch (error) {
+                    firstError ??= error;
+                }
+            }
+        }
+        throw firstError;
+    };
+}
+/**
+ * Kalıcı bağlamı `ScreenshotBrowser` gibi gösterir. Kalıcı bağlamda ikinci bağlam açılamaz;
+ * çekimler seri koştuğu için (`StudioScreenshotter` kuyruğu) her `newContext` aynı bağlamın
+ * üstünde bir oturum verir. `deviceScaleFactor` yalnız açılışta verilebildiği için değişince
+ * bağlam AYNI profille yeniden açılır.
+ */
+export class PersistentScreenshotBrowser {
+    open;
+    current;
+    constructor(open) {
+        this.open = open;
+    }
+    async newContext(options) {
+        if (this.current && this.current.deviceScaleFactor !== options.deviceScaleFactor) {
+            await this.close();
+        }
+        if (!this.current) {
+            const context = await this.open(options.deviceScaleFactor);
+            const entry = { context, deviceScaleFactor: options.deviceScaleFactor };
+            // Tarayıcı düşerse sonraki çekim yeniden açsın (eski `browser.newContext` hatası gibi).
+            context.on('close', () => {
+                if (this.current === entry)
+                    this.current = undefined;
+            });
+            this.current = entry;
+        }
+        return new PersistentContextSession(this.current.context, options);
+    }
+    async close() {
+        const expired = this.current;
+        this.current = undefined;
+        await expired?.context.close();
+    }
+}
+/**
+ * Tek çekimlik oturum. Eski taze bağlamın yalıtımı korunur: başlık ve init script'i bağlama
+ * değil sayfaya yazılır (sonraki çekime sızmaz — `impersonated-user-id` dahil), kapanışta
+ * çerezler ve gezilen kökenlerin depoları (localStorage, IndexedDB, …) diskteki profilden silinir.
+ */
+class PersistentContextSession {
+    context;
+    options;
+    initScripts = [];
+    headers;
+    pages = [];
+    constructor(context, options) {
+        this.context = context;
+        this.options = options;
+    }
+    addCookies(cookies) {
+        return this.context.addCookies(cookies);
+    }
+    async addInitScript(script) {
+        this.initScripts.push(script);
+    }
+    async setExtraHTTPHeaders(headers) {
+        this.headers = headers;
+    }
+    async newPage() {
+        const page = await this.context.newPage();
+        this.pages.push(page);
+        await page.setViewportSize(this.options.viewport);
+        await page.emulateMedia({ reducedMotion: this.options.reducedMotion ?? 'no-preference' });
+        if (this.headers)
+            await page.setExtraHTTPHeaders(this.headers);
+        for (const script of this.initScripts)
+            await page.addInitScript(script);
+        return page;
+    }
+    async close() {
+        const origins = new Set();
+        for (const page of this.pages) {
+            try {
+                const origin = new URL(page.url()).origin;
+                if (origin.startsWith('http'))
+                    origins.add(origin);
+            }
+            catch {
+                // about:blank vb.
+            }
+        }
+        const probe = this.pages.find(page => !page.isClosed());
+        if (probe && origins.size > 0) {
+            const cdp = await this.context.newCDPSession(probe).catch(() => undefined);
+            for (const origin of origins) {
+                await cdp?.send('Storage.clearDataForOrigin', { origin, storageTypes: 'all' }).catch(() => undefined);
+            }
+            await cdp?.detach().catch(() => undefined);
+        }
+        await this.context.clearCookies().catch(() => undefined);
+        for (const page of this.pages)
+            await page.close().catch(() => undefined);
+    }
+}

package/dist/resources/examples/flow-list-to-form.json

@@ -1,22 +1,23 @@
 {
   "_meta": {
     "synthetic": false,
-    "note": "Liste sayfasından kayıt sayfasına geçiş: satıra çift tıkla → edit (?id=), 'Yeni' butonu → create (parametresiz). Tek yeni kavram redirect adımıdır; query alanı SABİT DEĞİL İFADEDİR.",
-    "harvestedFrom": "qm projesi '[SY] Departmanlar' sayfası (table-doubleClick + button-click akışları), 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §2",
+    "note": "Liste sayfasından kayıt sayfasına geçiş: satıra çift tıkla → edit (?id=), 'Yeni' butonu → create (parametresiz). Tek yeni kavram redirect adımıdır; query alanı SABİT DEĞİL İFADEDİR. Tablo `datatable`'dır: olay `rowDoubleClick`, liste tek `mount` akışıyla dolar.",
+    "harvestedFrom": "qm projesi '[SY] Departmanlar' sayfası (table-doubleClick + button-click akışları), 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §2. 2026-10-13'te kaldırılan `table` bileşeninden `datatable`'a taşındı (olay adları ve bağ sayısı değişti; redirect adımları aynı).",
     "pairsWith": "page-form-upsert (geçilen sayfa), flow-load-table (listenin kendisini dolduran akış)"
   },
   "_rules": {
     "queryIsExpression": "redirect.args.query bir İFADEDİR, sabit string değil: template literal (`id=${…}`) ve koşullu ifade yazılabilir. Sayfalar arası parametre geçmenin yolu budur; hedef sayfa Page.queryParams.<ad> ile okur. variable_create gerekmez.",
-    "selfAndNames": "İfade içinde `self` tetikleyen komponenttir (self.selectedRow.id). Komponente adıyla da erişilir (table?.selectedRow?.id) — addaki '-' silinir. Sözlük: platform_guide('expressions') §2.",
+    "selfAndNames": "İfade içinde `self` tetikleyen komponenttir (self.selectedRow.id). Komponente adıyla da erişilir (records_table?.selectedRow?.id) — addaki '-' silinir. Sözlük: platform_guide('expressions') §2.",
     "pageIdAndPath": "redirect args'ında pageId (bağlayıcı referans) ve path (slug) birlikte verilir; sabit URL yazma — slug değişince pageId referansı ayakta kalır.",
-    "eventsAreSeparate": "Bu örnek `table` komponentini varsayar: olaylar AYRI akışlara bağlanır (mount = yükle · pagination · filter · sort · doubleClick = kaydı aç). `datatable` seçersen tek `mount` akışı yeterlidir — o komponent süzme/sıralama/sayfalamayı kendi içinde yapıp prop'ları yazdıktan sonra mount'u yeniden tetikler (Kural 1e). Hangi olayların var olduğunu component_get ile doğrulayın; olay adları `on` öneki ALMAZ (button → click).",
+    "singleMountFlow": "Tablo `datatable`'dır ve liste TEK `mount` akışıyla dolar: kullanıcı süzünce/sıralayınca/sayfa değiştirince komponent kendi filters/sortField/sortType/offset prop'larını yazar ve `mount`'u yeniden tetikler (Kural 1e) — pagination/filter/sort diye ayrı olay YOKTUR, bağlamaya çalışmak PAGE-008 ile reddedilir. Kaydı açan olay `rowDoubleClick`'tir (tek tık için `rowClick`); ikisi de olaydan ÖNCE tıklanan satırı self.selectedRow'a yazar. Hangi olayların var olduğunu component_get ile doğrulayın; olay adları `on` öneki ALMAZ (button → click).",
+    "editModeAndDoubleClick": "editMode none DIŞINDAYKEN çift tık satırı ayrıca düzenlemeye açar; liste → form geçişi için tabloyu editMode: none bırakın (ya da geçişi satır aksiyonuyla kurun: actions[].flow).",
     "newButton": "'Yeni' butonu ayrı bir komponenttir ve akışı parametresiz redirect'tir; hedef sayfa parametre görmediği için create kipine düşer."
   },
   "openRecordFlowCreateArgs": {
     "host": "page",
     "hostId": "<liste sayfası id>",
-    "name": "records_table - doubleClick",
-    "slug": "records-table-doubleclick",
+    "name": "records_table - rowDoubleClick",
+    "slug": "records-table-rowdoubleclick",
     "steps": [
       {
         "stepId": "start", "name": "start", "type": "start", "kind": "normal", "args": {},
@@ -56,10 +57,7 @@
   },
   "schemaPatchOps": [
     { "op": "set_event", "target": "records_table", "event": "mount", "eventValue": "<liste yükleme flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "doubleClick", "eventValue": "<openRecord flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "pagination", "eventValue": "<liste yükleme flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "filter", "eventValue": "<liste yükleme flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "sort", "eventValue": "<liste yükleme flow id>" },
+    { "op": "set_event", "target": "records_table", "event": "rowDoubleClick", "eventValue": "<openRecord flow id>" },
     { "op": "set_event", "target": "btn_new", "event": "click", "eventValue": "<newRecord flow id>" }
   ]
 }

package/dist/resources/examples/flow-load-table.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "synthetic": true,
-    "note": "Komponentin mount olayına bağlanan flow tabloya veri yükler: yükleniyor bayrağı → microservice → satır eşleme + toplam kayıt. Bu dosyanın 2026-08-16 öncesi sürümü ÜÇ HATA taşıyordu ve ürettiği akışlar ne Studio'da çiziliyor ne runtime'da çalışıyordu; aşağıdaki şekil UI kodu okunarak düzeltildi (bkz. _rules).",
+    "note": "Komponentin mount olayına bağlanan flow tabloya (`datatable`) veri yükler: yükleniyor bayrağı → microservice → satır eşleme + toplam kayıt. Aynı akış süzme/sıralama/sayfa değişiminde de koşar: `datatable` kendi filters/sortField/sortType/offset prop'larını yazıp `mount`'u yeniden tetikler, bu yüzden adım parametreleri o prop'lardan okunur. Bu dosyanın 2026-08-16 öncesi sürümü ÜÇ HATA taşıyordu ve ürettiği akışlar ne Studio'da çiziliyor ne runtime'da çalışıyordu; aşağıdaki şekil UI kodu okunarak düzeltildi (bkz. _rules).",
     "harvestedFrom": "kod doğrulaması: NgApps.UI packages/ng-apps-flow + apps/studio/src/features/event-actions (2026-08-16)"
   },
   "_rules": {

package/dist/resources/examples/mobile-list-detail-form.json

@@ -3,7 +3,7 @@
     "synthetic": true,
     "note": "Mobil uygulamada üç sayfalık liste → detay → form akışı (G6 koşusunun girdisi): 'gorevler' mount'ta görevleri yükleyip repeater'a yazar, satıra dokunmak 'detay'ı id ile açar, 'yeni' formu kaydedip toast gösterir ve listeye döner. Yerleşim flex (blocks yok), görünüm tipli gruplarla.",
     "pairsWith": "mobile-app-shell-stack ya da mobile-app-shell-tab (kabuk), microservice-table-list (liste ucu), page-form-upsert (web'deki form ikizi)",
-    "sourceRef": "platform_guide('mobile') §Kurulum sırası, §Akış adımları; ngapps://examples/flow-list-to-form (redirect query sözleşmesi)"
+    "sourceRef": "platform_guide('mobile') §Kurulum sırası; platform_guide('mobile-steps') §Adım sözlüğü; ngapps://examples/flow-list-to-form (redirect query sözleşmesi)"
   },
   "_rules": {
     "order": "Önce kabuk ve sayfalar (mobile_app_create), sonra microservice'ler, sonra her sayfanın schemaPatchOps'u, en son akışlar (flow_create) ve bağları (set_event).",
@@ -15,7 +15,7 @@
     "verify": "page_screenshot({ applicationSlug: 'saha', pageSlug: 'yeni', actions: [{ action: 'set', target: 'in_title', value: 'Sayaç okuma' }, { action: 'submit', target: 'frm_task' }] }) → submitVia 'bridge', flowRuns ≥ 1, son kare 'gorevler'.",
     "propNames": "Prop adları mobil kataloğun adlarıdır (component_get): metin `text.content`, satırlar `repeater.rows`. Mobilde istemci tarafı form doğrulaması yok (`isRequired` prop'u yok) — zorunlu alanı kayıt akışı denetler. Kod bağı ifadeyi `ref`'te taşır: `{ type: 'code', ref: '{{ item.title }}' }` — `data`'ya yazılan ifade çizilmez (boş metin).",
     "detailFromSteps": "Detay alanları uçtan gelen veriyi SETTER adımıyla alır (`fill_detail`, `value.type: 'storage'`): `{{ Steps.… }}` kod bağı ilk çizimde okunur ve `Steps`'e yazmak düğümü yeniden okutmaz — sayfa boş kalırdı (web `page-detail-profile` ile aynı desen).",
-    "mobileBehavior": "Çekerek yenile listenin değil onu saran `scroll-view`'ın işidir (`refreshable: true` + `refresh` olayı). `redirect.presentation` push | modal | replace alır; küme dışı değer MOB-008 uyarısı ve backend 422'sidir. Sekme hedefine giden redirect'te modal `navigate`'e düşer.",
+    "mobileBehavior": "Çekerek yenile listenin değil onu saran `scroll-view`'ın işidir (`refreshable: true` + `refresh` olayı). `redirect.presentation` push | modal | replace alır; küme dışı değer MOB-008 uyarısı ve backend 422'sidir. Sekme hedefine giden redirect'te modal `navigate`'e düşer. `redirect.transition` hedefin nasıl gireceğini söyler: default | none | fade | slide | slideUp (küme dışı değeri backend 422 ile reddeder); alan yoksa uygulamanın varsayılanı (`properties.mobile.transition`) geçerlidir. `modal` sunumda ve sekme hedefinde geçiş KULLANILMAZ: 'yeni' formunun kayıttan sonraki dönüşü (`go_list`) `fade` yazar ve bu yalnız yığın kabuğunda (mobile-app-shell-stack) oynar — sekme kabuğunda (mobile-app-shell-tab) 'gorevler' bir sekme sayfasıdır, sekme değişir ve geçiş oynamaz. Liste → detay adımı (`go_detail`) `modal` olduğu için geçiş taşımaz.",
     "layoutContract": "Mizanpaj sözleşmesi platform_guide('mobile-layout'): başlık text type (fontSize değil), form direction:'column' + horizontalAlign:'stretch' (yönü yazılmamış form satırdır), aralık gap'ten. Sayfalar MOB-015…021'den sıfır bulguyla geçer."
   },
   "pages": [
@@ -681,7 +681,8 @@
             "args": {
               "pageId": "<gorevler sayfa id>",
               "path": "gorevler",
-              "query": ""
+              "query": "",
+              "transition": "fade"
             },
             "branches": [
               {

package/dist/resources/examples/mobile-scan-code.json

@@ -0,0 +1,285 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil sayfada kod tarama (scan-code adımı, kök ADR 0017): 'Barkod okut' düğmesi tam ekran tarayıcıyı açar; okunan değer barkod alanına yazılır, kullanıcı vazgeçerse ya da kamera kullanılamıyorsa error dalı tek bir uyarı gösterir. Tek yeni kavram scan-code adımıdır ve iki dalı da bağlıdır. Sayfa mizanpaj sözleşmesine uyar (MOB-015…021 bulgusuz), akış FLOW-042'den temiz geçer (test/mobile-rules.test.ts, test/mobile-layout-lint.test.ts).",
+    "pairsWith": "mobile-app-shell-stack (kabuk), mobile-form-screen (alanın içinde durduğu form düzeni), mobile-list-detail-form (okunan değerle kayıt arama / kaydetme akışı)",
+    "sourceRef": "platform_guide('mobile-steps') §Adım sözlüğü — scan-code satırı; FLOW-042; FLOW-022 (metin şablonu)"
+  },
+  "_rules": {
+    "value": "args.value izinli kod türleridir: sözlükten virgüllü DÜZ METİN — ifade, dizi ya da büyük harf değil (FLOW-042). Boş bırakılırsa bütün türler okunur; ürün barkodu için daraltmak yanlış okumayı azaltır. upc_a yoktur: UPC-A etiketi ean13 adıyla ve başında 0 ile on üç hane döner. types / formats / barcodeTypes gibi anahtarlar okunmaz.",
+    "title": "args.title tarayıcı ekranındaki yönergedir ve METİN ŞABLONUDUR (FLOW-022): düz metin olduğu gibi çizilir, çeviri için \"{{ t('urun.barkod.okut') }}\" yazılır. Boşsa ekranın kendi yönergesi çizilir.",
+    "result": "Sonuç Steps.<adım adı>.data = { value, type, source }. source 'camera' ya da 'manual' (ekrandaki 'Elle gir'); elle girişte adım birden çok tür istiyorsa type null gelir — türe göre dallanacaksan null'u da ele al.",
+    "errorBranch": "Kullanıcının tarayıcıyı kapatması bir HATADIR. error dalı bağlı değilse akışın hata akışı (errorSteps) koşar; o da yoksa akış always ile sürer ve yazma adımı Steps.scan.data.value yerine null okur. error dalında Steps.<adım adı>.error = { status, message }: cancelled (kapattı) · denied (kamera izni yok) · unavailable (derleme kamerayı taşımıyor ya da tarayıcı zaten açık) · unsupported (web uygulaması) · invalid (sözlük dışı tür). Buradaki uyarı vazgeçmeyi öteki durumlardan ayırır; error dalı koşunca always KOŞMAZ.",
+    "setter": "Okunan değer setter ile alana yazılır (element + property 'value', değer kaynağı code: Steps.scan.data.value). Değeri bir uca gönderecekseniz setter yerine microservice adımının parametresine aynı ifadeyi yazın.",
+    "placement": "Tarama düğmesi SAYFADA durur. Özel sekme çubuğunun (tabs.style: custom) bileşenindeki bir düğmeden başlatılan tarama sonuç vermez: tarayıcı açılınca çubuk sökülür ve akışı durur (bilinen açık — koddan okundu, cihazda ölçülmedi: zeyrek-frontend/docs/issues.md ARC-298).",
+    "focus": "Tarayıcı kapanınca sayfanın focus akışları koşar (başka ekrandan dönüş bir odaktır) — taramanın devamından SONRA. Odakta alanı sıfırlayan bir akış varsa okunan değeri ezer.",
+    "preview": "Önizleme (/dev, page_screenshot) kamera açmaz, telefon çerçevesinin içinde 'kod gir' penceresi çizer. page_screenshot ile sürmek için captureUnready: true ŞARTTIR — akış pencereyi beklerken 'koşuyor' sayılır ve araç onsuz 'akış hâlâ koşuyor' ile düşer: actions [click btn_tara, set __scan-value, click __scan-type-<tür> (çok türlü adımda), click __scan-confirm]; error dalı için __scan-cancel. Pencere açıkken her eylem bekleme bütçesini (15 sn) doldurur. Ölçüldü 2026-10-12: onaydan sonra in_barkod value=8690000000017, txt_kaynak 'ean13 · elle girildi'; vazgeçince runtimeErrors code 'cancelled'.",
+    "build": "Kamera izni ve modülü mağaza derlemesine kendiliğinden girer: adım production'daki bir akıştaysa derleme kamerayı taşır. Kamerayı taşımayan derleme (adım derlemeden SONRA deploy edildiyse) unavailable döner; 0.5.0'dan eski kabuk adımı hiç tanımaz. İkisinde de kullanıcıya yeni sürüm gerekir — yayın ön kontrolünün P-14 satırı söyler (platform_guide('mobile-publish'))."
+  },
+  "pages": [
+    {
+      "pageCreateArgs": {
+        "name": "Ürün sorgula",
+        "slug": "urun-sorgula"
+      },
+      "schemaPatchOps": [
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "txt_baslik",
+            "name": "txt_baslik",
+            "type": "text",
+            "kind": "component",
+            "props": {
+              "content": {
+                "type": "static",
+                "ref": null,
+                "data": "Ürün sorgula"
+              },
+              "type": {
+                "type": "static",
+                "ref": null,
+                "data": "h2"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "grp_barkod",
+            "name": "grp_barkod",
+            "type": "container",
+            "kind": "component",
+            "props": {
+              "direction": {
+                "type": "static",
+                "ref": null,
+                "data": "column"
+              },
+              "horizontalAlign": {
+                "type": "static",
+                "ref": null,
+                "data": "stretch"
+              },
+              "gap": {
+                "type": "static",
+                "ref": null,
+                "data": "medium"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill",
+              "paddingType": "none"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "in_barkod",
+                "name": "in_barkod",
+                "type": "textinput",
+                "kind": "component",
+                "props": {
+                  "label": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Barkod"
+                  },
+                  "placeholder": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Okut ya da yaz"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "txt_kaynak",
+                "name": "txt_kaynak",
+                "type": "text",
+                "kind": "component",
+                "props": {
+                  "content": {
+                    "type": "static",
+                    "ref": null,
+                    "data": ""
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "btn_tara",
+                "name": "btn_tara",
+                "type": "button",
+                "kind": "component",
+                "props": {
+                  "text": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Barkod okut"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          }
+        }
+      ],
+      "scanFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<urun-sorgula sayfa id>",
+        "name": "barkod okut",
+        "slug": "barkod-okut",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "scan"
+              }
+            ]
+          },
+          {
+            "stepId": "scan",
+            "name": "scan",
+            "type": "scan-code",
+            "kind": "normal",
+            "args": {
+              "value": "ean13,ean8,qr",
+              "title": "Ürünün barkodunu okut"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "write_code"
+              },
+              {
+                "id": "<GUID>",
+                "name": "error",
+                "nextStepId": "warn"
+              }
+            ]
+          },
+          {
+            "stepId": "write_code",
+            "name": "write_code",
+            "type": "setter",
+            "kind": "normal",
+            "args": {
+              "iteratees": [
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "in_barkod",
+                  "property": "value",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "Steps.scan.data.value"
+                  }
+                },
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "txt_kaynak",
+                  "property": "content",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "`${Steps.scan.data.type ?? 'tür bilinmiyor'} · ${Steps.scan.data.source === 'camera' ? 'kameradan' : 'elle girildi'}`"
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          },
+          {
+            "stepId": "warn",
+            "name": "warn",
+            "type": "alert",
+            "kind": "normal",
+            "args": {
+              "message": "{{ Steps.scan.error.status === 'cancelled' ? 'Kod okunmadı' : 'Kamera kullanılamıyor; barkodu elle yazabilirsin' }}",
+              "alertType": "info"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "btn_tara",
+          "event": "click",
+          "eventValue": "<barkod okut akış id>"
+        }
+      ]
+    }
+  ]
+}

package/dist/resources/guides/component.md

@@ -88,7 +88,7 @@ arayüzdür**, yetkiyi backend her istekte yeniden denetler.
 
 - **Satır metası.** Table-source uçtan dönen satırda korumalı alan varsa
   `__protected: { <alanSlug>: 'masked' | 'plain' }` bulunur; `hidden` alan satırda hiç yoktur.
-  `table` · `datatable` · `detailview` · `text` (`record` + `recordField` ile) `masked` alanı
+  `datatable` · `detailview` · `text` (`record` + `recordField` ile) `masked` alanı
   kilitli maske olarak çizer; "Göster" → gerekçe → değer 30 sn görünür, sonra yeniden maskelenir.
   "Göster" yalnız erişim özeti yüklüyken çıkar: `off`'ta (basit proje hep `off`) hiç çıkmaz —
   backend her reveal'i reddeder; `shadow`'da çıkar — backend reveal'i yine denetler, yetkisiz
@@ -109,7 +109,7 @@ arayüzdür**, yetkiyi backend her istekte yeniden denetler.
   maskeli okumak yazmayı kapatmaz. Maskeli hücre düzenlemeye **boş** açılır, yazılan değer gider, boş bırakılan
   maske gitmez; hücre seçimine girmez, toplu düzenleme maskeli kolonu sunmaz. Korumalı alanı güncellemek için
   form kurmak zorunlu değildir. Eski değeri görerek düzeltmek gerekiyorsa önce "Göster" (30 sn, editöre ön
-  doldurulmaz). Bağlı olmayan tabloda ve `table` bileşeninde maskeli hücre düzenlenmez.
+  doldurulmaz). Bağlı olmayan tabloda maskeli hücre düzenlenmez.
 - **Boş değerin gönderilmemesi isteğin kuruluşuna bağlıdır.** Microservice çağrısının parametre
   bağı boş (`null`/`''`) değeri gövdeye koymaz → saklı değer korunur. Gövdeyi akış kodunda ya da
   setter göreviyle elle kuruyorsan (`{ tckn: TextInput1.value }`) `null` gider: `canWrite` yoksa
@@ -278,7 +278,7 @@ Yol joker olabilir: `series[].data` kaydı `series.1.data` prop'unu kapsar. Bağ
 
 ## Komponent seçimi
 
-"Hangi işe hangi komponent" tablosu ve `table` / `datatable` karşılaştırması:
+"Hangi işe hangi komponent" tablosu ve `datatable` kurulumu:
 `platform_guide('page')` Kural 1e ve 7e. Kaçınılacak tek şey yarım kurulumdur (süzme
 arayüzü açık, arkası statik uç). Hazır komponentlerin hiçbiri işi karşılamıyorsa `html`
 kaçış kapısıdır — yeteneklerini `platform_guide('html')` anlatır; "platform bunu yapamaz"

package/dist/resources/guides/expressions.md

@@ -97,8 +97,8 @@ dalından devam eder.
 
 | Global | İçerik |
 |---|---|
-| `Page` | `Page.user`, `Page.variables`, `Page.components`, `Page.properties`, `Page.queryParams`, `Page.authorized(roles)` |
-| **Komponent adları** | Her komponent adıyla doğrudan değişkendir: `specialties_table.rows = data` prop'u yazar ve UI'ı günceller; `setter` adımı gibi bileşenin `change` akışını **koşturmaz** — `change` akışı yalnız kullanıcı etkileşiminde koşar (2026-10-08; öncesindeki runtime her kod yazımında `change` akışını koştururdu). Addaki `-` silinir: `tickets-table` → `ticketstable` |
+| `Page` | `Page.user`, `Page.variables`, `Page.components`, `Page.properties`, `Page.queryParams`, `Page.authorized(roles)`, `Page.language` (etkin dil kodu, salt okunur), `Page.setLanguage(kod)` (dili değiştirir: seçim saklanır, bütün bağlar yeni dilde çözülür; projede olmayan kod yok sayılır — 2026-10-14 frontend, uzak kurulumda dağıtımdan sonra; ARC-097/098) |
+| **Komponent adları** | Her komponent adıyla doğrudan değişkendir: `specialties_table.rows = data` prop'u yazar ve UI'ı günceller. Çeviriye bağlı prop **ekrandaki metinle** okunur, iç içe dizilerdekiler dahil (`menu.navigations[0].title`, `drawer.actions[0].text`); okunan diziyi aynı metinle geri yazmak çeviri bağını korur (2026-10-14 frontend, uzak kurulumda dağıtımdan sonra — öncesinde okuma `null` verirdi); `setter` adımı gibi bileşenin `change` akışını **koşturmaz** — `change` akışı yalnız kullanıcı etkileşiminde koşar (2026-10-08; öncesindeki runtime her kod yazımında `change` akışını koştururdu). Addaki `-` silinir: `tickets-table` → `ticketstable` |
 | `state.page` / `state.app` | Sayfa/uygulama state'i (oku/yaz): `state.page.selectedId = row.id`. **Bellekte yaşar** — sayfa her açıldığında tanımlı `value`'dan başlar; mobil uygulamada kalıcı olması için değişkene `storage` verilir (`platform_guide('mobile')` §Kalıcı state). **Tanımlı değişkenler de buradadır:** `variable_create` ile yazılan her `key` sayfa düzeyinde `state.page.<key>`, uygulama düzeyinde `state.app.<key>` olur; `value` nesneyse alanlarına inilir (`state.page.MyTest.isActive`) |
 | `Steps` | Adım çıktıları: `Steps.load_specialties` — anahtar adımın **ADIdır**, `stepId` değil (`setStorage(task.name, …)`); `Steps.<adım>.error` o adımın hatası: `{ status, message, body }` — `message` ucun kendi mesajı (`err.reason`, boşsa HTTP durum metni), `status` HTTP kodu, `body` ucun hata gövdesi (`microservice.ts` `.catch`; tablo `platform_guide('page')`). `Steps.error` ise hata akışı için doldurulur (`onError` koşmadan önce `setStorage('error', …)` yapar) ve **yalnız orada okunur**: storage sayfa başına tek `FlowMachine`'de yaşar, ama dışarıdan başlayan her akış başlarken `'error'`'u ve kendi adımlarının önceki değerlerini temizler (`flow-engine.ts` `run`, 2026-09-25) — normal akışta `Steps.error` boştur; hata akışı ve onun tetiklediği akış (`nested`) onu görür ve şekli `{ message, code, step: { id, name, type, data } }`'dir: kullanıcıya gösterilecek metin `Steps.error.message`'tır (`err.response.data.message`, boşsa durum metni). **Başarılı bir adımda `Steps.<adım>.data` gerçek bir `Array`'dir** — `.map` · `.filter` · `.concat` · `.length` çalışır. Adım HATA dönerse `Steps.<adım>.data` `null`'dır, gövde `.error.body`'dedir; aşağıdaki kutuya bakın |
 | `self` · `item` · `Row` / `RowIndex` | Tetikleyen komponent (yazılabilir) · repeater/tablo satırı (yazmak YALNIZ o satırı günceller). Satır AKIŞINDA (satırdaki düğümün olayı) ARC-121 düzeltmesini (2026-09-27) taşıyan runtime gerekir, eskisinde boştu — sürümden bağımsız yol `<liste>.selectedItem` / `.selectedIndex`. Tekrarlayıcının KENDİ `change`/`select` akışında satır bağlamı yoktur. `item.x = …` yazımı da aynı kuraldadır: o satırı günceller, tekrarlayıcının `change` akışını koşturmaz |