@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.22

package/dist/platform/{screenshot.js → capture/capture.js}

@@ -1,7 +1,10 @@
-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 { 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 { actionScript, activeTabScript, rootElementId, runtimePropsScript } from './actions.js';
+import { domSummaryScript } from './summary.js';
+import { decideReadiness, describeUnready, parseReadiness, readinessScript, runtimePath } from './readiness.js';
 /**
  * Ziyaretçinin tema tercihinin yaşadığı localStorage anahtarı — `theme-toggle` bunu yazar,
  * `Theme` okur ve projenin kendi modunun önüne geçirir
@@ -9,323 +12,6 @@ import { logStep } from '../observability/trace.js';
  * DEĞİL tarayıcı başına tektir.
  */
 const VIEWER_MODE_STORAGE_KEY = 'zeyrek-viewer-theme-mode';
-/**
- * G-24 — gateway sayfayı kurabiliyor, okuyabiliyor ve çizdirebiliyordu ama üzerinde OLAY
- * TETİKLEYEMİYORDU: "filtre değişince veri yenileniyor" iddiası yalnız şema okumasıyla
- * kanıtlanabiliyordu. 09-05 koşusunda üç olay bağının ikisi şemada "bağlı" görünüp gerçekte
- * çalışmıyordu (form submit hiç doğmuyordu, `code` adımının gövdesi kaydedilmemişti) ve ikisi de
- * yalnız gerçek tıklamayla görüldü.
- *
- * Değer yazarken NATIVE setter kullanılır ve `input`+`change` olayları bubbles ile atılır: DOM
- * value'sunu düz atamak framework'ün duyduğu olayı üretmez, alan dolu görünür ama akış çalışmaz.
- * `resource` sayacı "istek gerçekten gitti mi" sorusunu cevaplar — koşuda kusuru kesinleştiren
- * gözlem tam olarak buydu (ağ kaydında hiç istek yoktu).
- */
-export function actionScript(action) {
-    const selector = JSON.stringify(`[data-element-id="${String(action.target ?? '')}"]`);
-    const value = JSON.stringify(action.value ?? '');
-    if (action.action === 'click') {
-        return `(function () {
-      var count = performance.getEntriesByType('resource').length;
-      var node = document.querySelector(${selector});
-      if (!node) return { found: false, applied: false, requests: count };
-      var target = node.matches('button, a, [role="button"]') ? node : (node.querySelector('button, a, [role="button"]') || 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.
-      if (target.closest && target.closest('[role="tablist"]') && !node.matches('[role="tab"]')) {
-        return { found: true, applied: false, note: "hedef bir sekme grubu: click İLK sekmeye giderdi — sekme seçmek için { action: 'tab', target: '" + ${JSON.stringify(String(action.target ?? ''))} + "', value: '<sekme anahtarı ya da metni>' } kullanın", requests: count };
-      }
-      target.click();
-      return { found: true, applied: true, requests: count };
-    })()`;
-    }
-    // S-2 — sekme SEÇİLEMİYORDU: kimlik `<elementId>__tab-<key>` (frontend f-02) önce denenir,
-    // runtime onu basmıyorsa görünen metinle eşlenir ve rapor hangisiyle eşlediğini söyler —
-    // metin çeviriye bağlıdır, dil değişince kırılır.
-    if (action.action === 'tab') {
-        const roleSelector = JSON.stringify(`[data-element-id="${String(action.target ?? '')}__tab-${String(action.value ?? '')}"]`);
-        return `(function () {
-      var count = performance.getEntriesByType('resource').length;
-      var root = document.querySelector(${selector});
-      if (!root) return { found: false, applied: false, requests: count };
-      var wanted = String(${value});
-      var byRole = document.querySelector(${roleSelector});
-      var buttons = Array.prototype.slice.call(root.querySelectorAll('[role="tab"]'));
-      var byText = buttons.filter(function (button) { return (button.textContent || '').trim() === wanted; })[0]
-        || buttons.filter(function (button) { return (button.textContent || '').trim().toLowerCase() === wanted.toLowerCase(); })[0];
-      var target = byRole || byText;
-
-      if (!target) {
-        var names = buttons.map(function (button) { return (button.textContent || '').trim(); }).join(' · ');
-        return { found: true, applied: false, optionsSeen: buttons.length, requests: count, note: buttons.length === 0
-          ? "bu düğümde sekme yok (role=tab) — hedef gerçekten bir sekme grubu mu? page_schema_get ile tipe bakın"
-          : "sekme bulunamadı: " + wanted + " — sekme ANAHTARINI ya da görünen metnini verin; görülenler: " + names };
-      }
-
-      if (target.disabled === true || target.getAttribute('aria-disabled') === 'true') {
-        return { found: true, applied: false, note: "sekme devre dışı (disabled): " + wanted, requests: count };
-      }
-
-      target.click();
-      return { found: true, applied: true, matchedBy: byRole ? 'role' : 'text', requests: count };
-    })()`;
-    }
-    // S-3 — açılır kutuda seçim. 'set' ile aynı gövde; buradaki fark yalnız prop izi tutulmamasıdır
-    // (seçim kutunun kendi değerini yazar, DOM'a elle yazılan bir değer yoktur).
-    if (action.action === 'select') {
-        return `(function () {
-      var count = performance.getEntriesByType('resource').length;
-      var node = document.querySelector(${selector});
-      if (!node) return { found: false, applied: false, requests: count };
-      var wanted = String(${value});
-      var finish = function (result) { return result; };
-
-    var combobox = node.querySelector('[role="combobox"], .ng-select__value-container, .ng-multiselect__value-container');
-    if (combobox) {
-      // Liste BU kutunun kabının içindedir. Sorgular belge kapsamlı kaldığında açık duran başka
-      // bir kutunun (multiselect seçimden sonra kapanmıyor) seçeneğine tıklanabiliyordu ve adım
-      // "uygulandı" diyordu; komşunun yükleme göstergesi de bu kutunun kararını blokluyordu (B-5).
-      var scope = combobox.closest('.ng-select, .ng-multiselect') || node;
-
-      combobox.click();
-
-      return new Promise(function (resolve) {
-        var waited = 0;
-        var step = 100;
-        var limit = 3000;
-
-        var attempt = function () {
-          var loading = scope.querySelector('.ng-select__loading, .ng-multiselect__loading');
-          var options = Array.prototype.slice.call(scope.querySelectorAll('[role="treeitem"][data-value]'));
-          var byValue = options.filter(function (option) { return option.getAttribute('data-value') === wanted; })[0];
-          var byText = options.filter(function (option) { return (option.textContent || '').trim() === wanted; })[0];
-          var match = byValue || byText;
-
-          if (match) {
-            var button = match.querySelector('button');
-            // Seçilemeyen seçeneğe tıklamak hiçbir şey yapmaz; "uygulandı" demek yanlış olurdu (B-6).
-            if (match.getAttribute('aria-disabled') === 'true' || (button && button.disabled)) {
-              resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: "seçenek devre dışı (aria-disabled): " + wanted }));
-              return;
-            }
-
-            (button || match).click();
-            resolve(finish({ found: true, applied: true, matchedBy: byValue ? 'value' : 'text', optionsSeen: options.length, waitedMs: waited, requests: count }));
-            return;
-          }
-
-          var settled = !loading && (options.length > 0 || !!scope.querySelector('.ng-select__empty, .ng-multiselect__empty'));
-
-          if (settled || waited >= limit) {
-            var seen = options.slice(0, 10).map(function (option) { return (option.textContent || '').trim(); }).join(' · ');
-            // Liste HİÇ açılmadıysa kusur sorguda değil kutunun kendisinde olabilir:
-            // handleContainerClick kilitli/salt-okunur/yükleniyor kutuda erken döner.
-            var locked = !scope.querySelector('.ng-select__list, .ng-multiselect__list');
-            var note = options.length > 0
-              ? "açılır kutuda bu değere karşılık gelen seçenek yok: " + wanted + " — görülen " + options.length + " seçenek: " + seen
-              : locked
-                ? "açılır kutu AÇILMADI (" + waited + " ms): kutu devre dışı, salt okunur ya da hâlâ yükleniyor olabilir — page_runtime_get ile isDisabled/isReadonly/isLoading prop'larına bakın"
-                : "açılır kutu açıldı ama " + waited + " ms içinde hiç seçenek basılmadı — seçenekler bir sorgudan geliyorsa query_preview ile doğrulayın, yavaşsa önce bir wait adımı ekleyin";
-            resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: note }));
-            return;
-          }
-
-          waited += step;
-          setTimeout(attempt, step);
-        };
-
-        attempt();
-      });
-    }
-      return { found: true, applied: false, note: "bu düğümde açılır kutu yok (role=combobox / .ng-select__value-container) — native alan için 'set', butona basmak için 'click' kullanın", requests: count };
-    })()`;
-    }
-    // S-4 — form gönderme. Gönder butonu olmayan ya da Enter ile gönderilen form başsız
-    // doğrulanamıyordu; `requestSubmit` formun kendi submit olayını doğduğu gibi doğurur.
-    if (action.action === 'submit') {
-        return `(function () {
-      var count = performance.getEntriesByType('resource').length;
-      var node = document.querySelector(${selector});
-      if (!node) return { found: false, applied: false, requests: count };
-      var form = node.matches('form') ? node : (node.querySelector('form') || node.closest('form'));
-
-      if (form) {
-        if (typeof form.requestSubmit === 'function') {
-          form.requestSubmit();
-          return { found: true, applied: true, submitVia: 'requestSubmit', requests: count };
-        }
-
-        form.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));
-        return { found: true, applied: true, submitVia: 'dispatch', requests: count };
-      }
-
-      var button = node.querySelector('button[type="submit"]');
-
-      if (button) {
-        button.click();
-        return { found: true, applied: true, submitVia: 'button', requests: count };
-      }
-
-      return { found: true, applied: false, note: "bu düğüm bir form değil ve içinde submit butonu da yok — form komponentinin elementId'sini hedefleyin", requests: count };
-    })()`;
-    }
-    // G-09 — kanban kartı ve takvim etkinliği HTML5 DnD ile taşınır. Olaylar sentetik atılır ve
-    // TEK DataTransfer'i paylaşır; koordinat bırakma hedefinin merkezidir, çünkü takvimin saat
-    // kolonu bırakılan saati `clientY`'den hesaplar (slot hedefi o saatin ortasına düşer).
-    // Playwright `dragTo` gerçek fare sürer ama ScreenshotPage bu yeteneği taşımaz; betik yolu
-    // öteki eylemlerle aynı ölçüm döngüsünden (requests · flowRuns) geçer.
-    if (action.action === 'drag') {
-        const destination = JSON.stringify(`[data-element-id="${String(action.to ?? '')}"]`);
-        const destinationName = JSON.stringify(String(action.to ?? ''));
-        return `(function () {
-      var count = performance.getEntriesByType('resource').length;
-      var node = document.querySelector(${selector});
-      if (!node) return { found: false, applied: false, requests: count };
-      var drop = document.querySelector(${destination});
-      if (!drop) return { found: false, applied: false, note: "sürükleme kaynağı bulundu ama bırakma hedefi ('to') sayfada yok: " + ${destinationName} + " — kanban kolonu <elementId>__col-<value>, takvim günü <elementId>__day-<yyyy-MM-dd>, saat dilimi <elementId>__slot-<yyyy-MM-dd>T<HH>", requests: count };
-      if (node.getAttribute('draggable') !== 'true') return { found: true, applied: false, note: "kaynak sürüklenebilir değil (draggable != true) — kanban isDraggable ya da eventcalendar isEditable kapalı olabilir", requests: count };
-      var transfer = new DataTransfer();
-      var center = function (element) { var rect = element.getBoundingClientRect(); return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 }; };
-      var fire = function (element, type, at) { element.dispatchEvent(new DragEvent(type, { bubbles: true, cancelable: true, composed: true, dataTransfer: transfer, clientX: at.x, clientY: at.y })); };
-      var from = center(node);
-      var to = center(drop);
-      fire(node, 'dragstart', from);
-      fire(drop, 'dragenter', to);
-      fire(drop, 'dragover', to);
-      fire(drop, 'drop', to);
-      fire(node, 'dragend', to);
-      return { found: true, applied: true, requests: count };
-    })()`;
-    }
-    const target = String(action.target ?? '');
-    const root = rootElementId(target);
-    // G-14 — `applied` yalnız "DOM'a yazıldı" demekti: tarih seçici olayı dinlemiyordu, kutu dolu
-    // görünüyor, prop boş kalıyordu. Kökün prop parmak izi eylemden ÖNCE alınır; runActions
-    // yerleşmeden sonra yeniden okuyup `propWritten`'ı çıkarır. Çok alanlı bileşenin kökünde tek
-    // değer yoktur — ilk kutuya yazmak yarım değeri "uygulandı" diye raporluyordu, kök reddedilir.
-    return `(function () {
-    var count = performance.getEntriesByType('resource').length;
-    var node = document.querySelector(${selector});
-    if (!node) return { found: false, applied: false, requests: count };
-    var wanted = String(${value});
-    var propsBefore = ${runtimePropsScript(root)};
-    var finish = function (result) { if (propsBefore !== undefined) result.propsBefore = propsBefore; return result; };
-
-    if (${JSON.stringify(root === target)}) {
-      var parts = Array.prototype.slice.call(node.querySelectorAll(${JSON.stringify(`[data-element-id^="${root}${INTERNAL_ROLE_SEPARATOR}"]`)}))
-        .filter(function (part) { return part.querySelector('input, select, textarea'); })
-        .map(function (part) { return part.getAttribute('data-element-id'); });
-      if (parts.length > 1) return finish({ found: true, applied: false, note: "çok alanlı bileşen: kökte tek değer yok, değeri kutulardan birine yazın — " + parts.join(' · '), requests: count });
-    }
-
-    // Açılır kutu (dropdown / multi-select) NATIVE alan değildir: değeri yazmak hiçbir şey
-    // yapmaz, seçeneğe TIKLANMASI gerekir. 'set' bu noktada 'select' fiiliyle AYNI yola girer —
-    // iki kopya seçim mantığı tutulmaz.
-
-    var combobox = node.querySelector('[role="combobox"], .ng-select__value-container, .ng-multiselect__value-container');
-    if (combobox) {
-      // Liste BU kutunun kabının içindedir. Sorgular belge kapsamlı kaldığında açık duran başka
-      // bir kutunun (multiselect seçimden sonra kapanmıyor) seçeneğine tıklanabiliyordu ve adım
-      // "uygulandı" diyordu; komşunun yükleme göstergesi de bu kutunun kararını blokluyordu (B-5).
-      var scope = combobox.closest('.ng-select, .ng-multiselect') || node;
-
-      combobox.click();
-
-      return new Promise(function (resolve) {
-        var waited = 0;
-        var step = 100;
-        var limit = 3000;
-
-        var attempt = function () {
-          var loading = scope.querySelector('.ng-select__loading, .ng-multiselect__loading');
-          var options = Array.prototype.slice.call(scope.querySelectorAll('[role="treeitem"][data-value]'));
-          var byValue = options.filter(function (option) { return option.getAttribute('data-value') === wanted; })[0];
-          var byText = options.filter(function (option) { return (option.textContent || '').trim() === wanted; })[0];
-          var match = byValue || byText;
-
-          if (match) {
-            var button = match.querySelector('button');
-            // Seçilemeyen seçeneğe tıklamak hiçbir şey yapmaz; "uygulandı" demek yanlış olurdu (B-6).
-            if (match.getAttribute('aria-disabled') === 'true' || (button && button.disabled)) {
-              resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: "seçenek devre dışı (aria-disabled): " + wanted }));
-              return;
-            }
-
-            (button || match).click();
-            resolve(finish({ found: true, applied: true, matchedBy: byValue ? 'value' : 'text', optionsSeen: options.length, waitedMs: waited, requests: count }));
-            return;
-          }
-
-          var settled = !loading && (options.length > 0 || !!scope.querySelector('.ng-select__empty, .ng-multiselect__empty'));
-
-          if (settled || waited >= limit) {
-            var seen = options.slice(0, 10).map(function (option) { return (option.textContent || '').trim(); }).join(' · ');
-            // Liste HİÇ açılmadıysa kusur sorguda değil kutunun kendisinde olabilir:
-            // handleContainerClick kilitli/salt-okunur/yükleniyor kutuda erken döner.
-            var locked = !scope.querySelector('.ng-select__list, .ng-multiselect__list');
-            var note = options.length > 0
-              ? "açılır kutuda bu değere karşılık gelen seçenek yok: " + wanted + " — görülen " + options.length + " seçenek: " + seen
-              : locked
-                ? "açılır kutu AÇILMADI (" + waited + " ms): kutu devre dışı, salt okunur ya da hâlâ yükleniyor olabilir — page_runtime_get ile isDisabled/isReadonly/isLoading prop'larına bakın"
-                : "açılır kutu açıldı ama " + waited + " ms içinde hiç seçenek basılmadı — seçenekler bir sorgudan geliyorsa query_preview ile doğrulayın, yavaşsa önce bir wait adımı ekleyin";
-            resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: note }));
-            return;
-          }
-
-          waited += step;
-          setTimeout(attempt, step);
-        };
-
-        attempt();
-      });
-    }
-
-    var field = node.matches('input, select, textarea') ? node : node.querySelector('input, select, textarea');
-    if (!field) return finish({ found: true, applied: false, note: 'düğümde input/select/textarea yok — bu komponent native alan kullanmıyor olabilir, click ile deneyin', requests: count });
-    var proto = field instanceof HTMLSelectElement ? HTMLSelectElement.prototype
-      : (field instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype);
-    if (field instanceof HTMLInputElement && (field.type === 'checkbox' || field.type === 'radio')) {
-      var shouldCheck = wanted === 'true' || wanted === '1' || wanted === 'on';
-      if (field.checked !== shouldCheck) field.click();
-      return finish({ found: true, applied: true, requests: count });
-    }
-    var setter = Object.getOwnPropertyDescriptor(proto, 'value').set;
-    setter.call(field, ${value});
-    field.dispatchEvent(new Event('input', { bubbles: true }));
-    field.dispatchEvent(new Event('change', { bubbles: true }));
-    return finish({ found: true, applied: true, requests: count });
-  })()`;
-}
-/** `rf_range__start` → `rf_range`: iç rol hedefinin prop'ları kök düğümde yaşar. */
-export function rootElementId(target) {
-    const separator = target.indexOf(INTERNAL_ROLE_SEPARATOR);
-    return separator > 0 ? target.slice(0, separator) : target;
-}
-/**
- * Düğümün runtime prop'larının parmak izi (`@ng-apps/flow` → flow-runtime-props.ts,
- * `window.__ngAppsReadProps`). `undefined` okuyucu yayınlanmıyor (eski runtime) ya da prop'lar
- * serileşmiyor; `null` hiçbir makine düğümü tanımıyor; dize karşılaştırılabilir iz.
- */
-export function runtimePropsScript(elementId) {
-    return `(function () { /* runtimePropsSnapshot */
-    var read = window.__ngAppsReadProps;
-    if (typeof read !== 'function') return undefined;
-    try { var props = read(${JSON.stringify(elementId)}); return props === null ? null : JSON.stringify(props); } catch (error) { return undefined; }
-  })()`;
-}
-/**
- * Hangi sekme AÇIK? `tab` adımı tıklamanın işe yarayıp yaramadığını ancak bununla kanıtlar:
- * tıklama "uygulandı" dese de bileşen seçimi kendi `selected` prop'una yazmamış olabilir.
- * `undefined` düğüm yok, `null` sekme grubu var ama hiçbiri seçili değil.
- */
-export function activeTabScript(elementId) {
-    return `(function () { /* activeTabSnapshot */
-    var root = document.querySelector(${JSON.stringify(`[data-element-id="${elementId}"]`)});
-    if (!root) return undefined;
-    var active = root.querySelector('[role="tab"][aria-selected="true"]');
-    return active ? String(active.textContent || '').replace(/\\s+/g, ' ').trim() : null;
-  })()`;
-}
 /**
  * fullPage karesi Chromium'un viewport ötesi yakalamasıyla değil, viewport'u içerik boyuna
  * büyüterek alınır: Studio runtime'ı kendi kaydırma kabını `100vh` üzerine kuruyor ve viewport
@@ -389,80 +75,6 @@ export function imageSize(buffer) {
     }
     return undefined;
 }
-/**
- * NE GÖRÜNÜYOR — resimsiz (S-5). Aynı sayfa yüklemesinden çıkan üçüncü çıktı: her KÖK runtime
- * düğümünün görünürlüğü, metni, satır sayısı, açık sekmesi, değeri ve hata metinleri.
- *
- * Kök düğüm = kimliğinde `__` OLMAYAN düğüm; iç roller (`tbl__row-3`) satır sayısına dönüşür,
- * listeye girmez. Tavan 300 düğüm, metin 80 karakter (K3) — özet bir kareyi değiştirmeli, onun
- * kadar pahalı olmamalı. Tip `data-component-type`'tan gelir (frontend f-02); runtime basmıyorsa
- * alan YAZILMAZ ve `typed: false` döner — `layoutReportUnavailable` ile aynı dürüstlük kuralı.
- */
-export function domSummaryScript(viewportHeight) {
-    return `(function () { /* domSummary */
-  var MAX = 300;
-  var CUT = 80;
-  // Görünür alanın GERÇEK boyu: fullPage ve clip yolları viewport'u içerik boyuna büyütür ve
-  // o anda window.innerHeight = içerik yüksekliği olur — her düğüm "ekran içinde" görünürdü ve
-  // "kart katlanmanın altında mı" sorusu HER ZAMAN 'visible' cevabı alırdı (B-10).
-  var VH = ${Math.max(Math.round(viewportHeight), 1)};
-  var clean = function (value) { return String(value || '').replace(/\\s+/g, ' ').trim(); };
-  var ROOT_SELECTOR = '[data-element-id]:not([data-element-id*="__"])';
-  var all = Array.prototype.slice.call(document.querySelectorAll('[data-element-id]'));
-  var roots = all.filter(function (node) { return String(node.getAttribute('data-element-id') || '').indexOf('__') < 0; });
-  var typed = false;
-  var nodes = roots.slice(0, MAX).map(function (node) {
-    var id = node.getAttribute('data-element-id');
-    var type = node.getAttribute('data-component-type');
-    if (type) typed = true;
-    // Bir olgu, ONU TAŞIYAN düğüme yazılır: en yakın kök ata bu düğüm değilse o olgu
-    // çocuğundur ve orada zaten listelenecektir (B-8). Aksi hâlde aynı değer üç satırda çıkar.
-    var owned = function (element) { return !!element && element.closest(ROOT_SELECTOR) === node; };
-    var rect = node.getBoundingClientRect();
-    var visible = typeof node.checkVisibility === 'function'
-      ? !!node.checkVisibility({ checkVisibilityCSS: true, checkOpacity: true })
-      : (rect.width > 0 && rect.height > 0);
-    var inViewport = rect.bottom > 0 && rect.right > 0 && rect.top < VH && rect.left < (window.innerWidth || 0);
-    // Kap düğümün innerText'i ÇOCUKLARININ metnidir; metin yalnız YAPRAK köklerde yazılır.
-    var nested = Array.prototype.slice.call(node.querySelectorAll('[data-element-id]'))
-      .some(function (child) { return String(child.getAttribute('data-element-id') || '').indexOf('__') < 0; });
-    var text = nested ? '' : clean(node.innerText);
-    if (text.length > CUT) text = text.slice(0, CUT) + '…';
-    var rows = document.querySelectorAll('[data-element-id^="' + id + '__row-"]').length;
-    var tab = node.querySelector('[role="tab"][aria-selected="true"]');
-    var field = node.querySelector('input, select, textarea');
-    var chosen = node.querySelector('.selected-item');
-    var holder = field || chosen;
-    var value = !owned(holder) ? '' : (field ? (field.type === 'password' ? '***' : clean(field.value)) : clean(chosen.textContent));
-    var media = node.querySelector('img, svg, canvas, video, iframe');
-    // İç içe <li> hem grubu hem alt mesajları sayıyordu: tek grup + 2 alt hata 3 görünüyordu (B-7).
-    var errorItems = Array.prototype.slice.call(node.querySelectorAll('.form-validation-errors li:not(:has(li))'))
-      .filter(owned).map(function (item) { return clean(item.textContent); });
-    // aria-invalid hem köke hem input'a yazılabiliyor (Password.svelte); yalnız ALANLAR sayılır.
-    var invalid = Array.prototype.slice.call(node.querySelectorAll('input[aria-invalid="true"], select[aria-invalid="true"], textarea[aria-invalid="true"]')).filter(owned).length;
-    var summary = { elementId: id, visible: !!visible, inViewport: !!inViewport };
-    if (type) summary.type = type;
-    if (text) summary.text = text;
-    if (rows > 0) summary.rows = rows;
-    if (owned(tab)) summary.activeTab = clean(tab.textContent);
-    if (value) summary.value = value;
-    if (visible && !text && !media && !nested) summary.empty = true;
-    if (errorItems.length > 0) summary.errors = errorItems;
-    else if (invalid > 0) summary.errors = ['aria-invalid: ' + invalid];
-    return summary;
-  });
-  var messages = [];
-  Array.prototype.slice.call(document.querySelectorAll('.ng-toast')).forEach(function (toast) {
-    var name = String(toast.className || '');
-    var kind = name.indexOf('ng-toast--error') >= 0 ? 'toast/error' : (name.indexOf('ng-toast--success') >= 0 ? 'toast/success' : 'toast');
-    messages.push({ kind: kind, text: clean(toast.innerText).slice(0, 160) });
-  });
-  Array.prototype.slice.call(document.querySelectorAll('.view-detail__error, .error-page')).forEach(function (node) {
-    messages.push({ kind: 'error', text: clean(node.innerText).slice(0, 160) });
-  });
-  return { nodes: nodes, messages: messages, truncated: roots.length > MAX, typed: typed };
-})()`;
-}
 /**
  * Kare taşmayı gösterir ama ölçmez: aynı sayfa yüklemesinden neredeyse bedavaya çıkan ikinci
  * çıktı her runtime düğümünün efektif piksel kutusudur. Düğümler `data-element-id` taşımıyorsa
@@ -487,67 +99,6 @@ export const layoutReportScript = [
  * flow-runtime-errors.ts); kare çekilirken bedavaya okunur.
  */
 export const flowRuntimeErrorsScript = 'Array.isArray(window.__ngAppsFlowRuntimeErrors) ? window.__ngAppsFlowRuntimeErrors.slice(0, 50) : []';
-/**
- * Kare ne zaman hazır? (G-30 → B-6, 2026-09-07)
- *
- * `delayMs` TAHMİNDİ; 09-05'te runtime koşan akış sayacını yayınlamaya başladı (`@ng-apps/flow`
- * → flow-runtime-errors.ts) ve bekleme "running sıfır, completed > 0" olunca bitiyordu. Bu şart
- * mount akışı OLMAYAN sayfada (giriş ekranı) hiç sağlanmaz; akış tetiklemeyen `set` eylemi de
- * `completed`'ı artırmaz. 09-06·2 koşusunda üç eylemli giriş denemesi bu yüzden 47 sn sürdü;
- * sentetik ölçümde sayfa 0.3 sn'de hazırken aynı çağrı 48 sn'ydi — süre sayfanın değil, bu
- * döngünün. Hazırlık artık TEK anlık görüntüden okunur: akış sayacı + Studio'nun yükleme
- * iskeleti (`ViewDetail.svelte` → `.view-detail > .bx--skeleton__placeholder`) + runtime
- * düğümleri (`[data-element-id]`) + hata/bulunamadı hâli + adres. Karar `decideReadiness`'ta.
- *
- * Yüklenmemiş kare ASLA dönmez: bütçe dolduğunda sayfa hâlâ hazır değilse çağrı hatayla düşer
- * (`captureUnready: true` teşhis kipi dışında). Bozuk sayfayı görmek istiyorsan hata mesajı
- * neyin görüldüğünü zaten söyler.
- */
-export const readinessScript = `(function () { /* readinessSnapshot */
-  var activity = window.__ngAppsFlowActivity;
-  return {
-    activity: activity && typeof activity.running === 'number' && typeof activity.completed === 'number' ? { running: activity.running, completed: activity.completed } : null,
-    runtimeNodes: document.querySelectorAll('[data-element-id]').length,
-    skeleton: !!document.querySelector('.view-detail > .bx--skeleton__placeholder'),
-    viewDetail: !!document.querySelector('.view-detail'),
-    errorState: !!document.querySelector('.view-detail__error, .view-detail .error-page'),
-    readyState: String(document.readyState),
-    href: String(location.href)
-  };
-})()`;
-/** Okunan değer gerçekten sayaç mı; değilse sayfa sayaç yayınlamıyordur (eski runtime). */
-export function isFlowActivity(activity) {
-    if (!activity || typeof activity !== 'object')
-        return false;
-    const { running, completed } = activity;
-    return typeof running === 'number' && typeof completed === 'number';
-}
-/** Tarayıcıdan dönen değer anlık görüntü mü; yönlendirme sırasında evaluate düşer ve undefined kalır. */
-export function parseReadiness(raw) {
-    if (!raw || typeof raw !== 'object')
-        return undefined;
-    const value = raw;
-    if (typeof value.runtimeNodes !== 'number' || typeof value.href !== 'string')
-        return undefined;
-    return {
-        activity: isFlowActivity(value.activity) ? { running: value.activity.running, completed: value.activity.completed } : null,
-        runtimeNodes: value.runtimeNodes,
-        skeleton: value.skeleton === true,
-        viewDetail: value.viewDetail === true,
-        errorState: value.errorState === true,
-        readyState: String(value.readyState ?? ''),
-        href: value.href
-    };
-}
-/** `/dev` ve `/view` aynı sayfadır (Studio `hooks.ts` reroute); yönlendirme kararı yalnız yoldan verilir. */
-export function runtimePath(url) {
-    try {
-        return new URL(url).pathname.replace(/^\/dev\//, '/view/').replace(/\/+$/, '');
-    }
-    catch {
-        return url;
-    }
-}
 const maxCaptureHeight = 16384;
 const navigationTimeoutMs = 20000;
 const apiResponseTimeoutMs = 15000;
@@ -555,12 +106,6 @@ const settleMs = 600;
 /** Akış bittikten sonra Svelte'in son render'ına bırakılan pay. */
 const flowSettleGraceMs = 250;
 const flowPollMs = 120;
-/** "Hiç akış koşmadı" kararı için DOM'un kaç yoklama değişmemesi gerekir (~600 ms = eski settleMs). */
-const quietPolls = 5;
-/** Sayaç yayınlanmayan runtime'da tek kanıt DOM durulmasıdır; daha uzun beklenir (~1 sn). */
-const legacyQuietPolls = 8;
-/** Runtime dışına yönlendirme: hedef sayfanın kendi JS'i çizmeyi bitirsin (~1.5 sn). */
-const redirectQuietPolls = 12;
 const idleCloseMs = 60000;
 /** Etkileşim adımındaki `wait` üst sınırı; delayMs tavanıyla aynı çizgide. */
 const maxActionWaitMs = 15000;
@@ -580,42 +125,6 @@ const navigationAttempts = 2;
 function isNavigationTimeout(message) {
     return /timeout/i.test(message);
 }
-/**
- * Tek anlık görüntüden "kare alınabilir" kararı; iki uçta da yanlış beklememek için tek yerde.
- * `quiet` görüntünün kaç yoklamadır değişmediğidir, `completedBefore` bu beklemenin başındaki
- * bitmiş akış sayısı (sayfa değiştiyse çağıran sıfırlar). İskelet görünüyorsa hiçbir karar yok.
- */
-export function decideReadiness(snapshot, quiet, completedBefore, baselineUrl) {
-    if (snapshot.skeleton)
-        return undefined;
-    const { activity } = snapshot;
-    const idle = activity !== null && activity.running === 0;
-    if (idle && activity.completed > completedBefore && snapshot.runtimeNodes > 0)
-        return 'ready';
-    if (idle && snapshot.runtimeNodes > 0 && quiet >= quietPolls)
-        return 'ready-no-flows';
-    if (activity === null && snapshot.runtimeNodes > 0 && quiet >= legacyQuietPolls)
-        return 'ready-no-counter';
-    if (idle && snapshot.errorState && quiet >= quietPolls)
-        return 'error';
-    if (!snapshot.viewDetail && snapshot.readyState === 'complete' && baselineUrl !== undefined && runtimePath(snapshot.href) !== runtimePath(baselineUrl) && quiet >= redirectQuietPolls)
-        return 'redirected';
-    return undefined;
-}
-/** Hata mesajı için: bütçe dolduğunda sayfada NE görüldü. */
-export function describeUnready(readiness, apiNote) {
-    const snapshot = readiness.snapshot;
-    const suffix = apiNote === undefined ? '' : ` · ${apiNote}`;
-    if (!snapshot)
-        return `tarayıcı sayfayı hiç değerlendiremedi (sürekli yönlendirme ya da bağlam düştü)${suffix}`;
-    if (snapshot.skeleton)
-        return `sayfa hâlâ yükleme iskeletinde${suffix}`;
-    if (snapshot.activity && snapshot.activity.running > 0)
-        return `${snapshot.activity.running} akış hâlâ koşuyor (${snapshot.activity.completed} bitti)${suffix}`;
-    if (snapshot.runtimeNodes === 0)
-        return `runtime hiç render olmadı — data-element-id taşıyan düğüm yok${snapshot.viewDetail ? '' : ', .view-detail kabı da yok'}${suffix}`;
-    return `sayfa durulmadı (${snapshot.runtimeNodes} düğüm, sayaç ${snapshot.activity ? `${snapshot.activity.running} koşan / ${snapshot.activity.completed} biten` : 'yok'})${suffix}`;
-}
 async function measureContentHeight(page) {
     const measured = await page.evaluate(contentHeightScript).catch(() => undefined);
     const height = measured?.contentHeight;
@@ -767,7 +276,7 @@ export class StudioScreenshotter {
             }
             const snapshotBefore = parseReadiness(await page.evaluate(readinessScript).catch(() => undefined));
             const activityBefore = snapshotBefore?.activity ?? null;
-            const raw = await page.evaluate(actionScript(action)).catch(error => ({
+            const raw = await page.evaluate(actionScript(action, request.target)).catch(error => ({
                 found: false,
                 applied: false,
                 note: error instanceof Error ? error.message : String(error),
@@ -778,9 +287,11 @@ export class StudioScreenshotter {
             // iç rol denemesidir: bilinen roller sayılır. Kök hedefi bulunamadıysa sorun elementId'nin
             // kendisindedir, şemayı okumaya yönlendirilir (P1-3 Step 3).
             if (before.found === false && !before.note && typeof action.target === 'string') {
-                before.note = 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}' 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).`;
+                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}' 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"
             // sorusunu cevaplar — koşuda kusuru kesinleştiren gözlem buydu.
@@ -917,7 +428,7 @@ export class StudioScreenshotter {
         });
         let context;
         try {
-            context = await browser.newContext({ viewport: request.viewport, deviceScaleFactor: request.scale ?? 1 });
+            context = await browser.newContext({ viewport: request.viewport, deviceScaleFactor: (request.dpr ?? 1) * (request.scale ?? 1) });
         }
         catch {
             this.browserPromise = this.launch();
@@ -925,7 +436,7 @@ export class StudioScreenshotter {
                 this.browserPromise = undefined;
                 throw error;
             });
-            context = await browser.newContext({ viewport: request.viewport, deviceScaleFactor: request.scale ?? 1 });
+            context = await browser.newContext({ viewport: request.viewport, deviceScaleFactor: (request.dpr ?? 1) * (request.scale ?? 1) });
         }
         logStep('tarayıcı →', `GET ${request.url} · viewport ${request.viewport.width}x${request.viewport.height}${request.fullPage ? ' · fullPage' : ''}${request.token ? '' : ' · gateway jetonu YOK'}${(request.cookies ?? []).length > 0 ? ` · caller çerezleri: ${(request.cookies ?? []).map(cookie => cookie.name).join(', ')}` : ''}${request.token || (request.cookies ?? []).length > 0 ? '' : ' · ANONİM (çerez YOK)'}${request.colorScheme ? ` · tema ${request.colorScheme}` : ''}`);
         try {
@@ -1002,8 +513,11 @@ export class StudioScreenshotter {
             // tablo açan bir çekim viewport boyunda kalıyordu; `contentHeight` ilk sekmenin boyuydu
             // (S-1, 2026-09-16 raporu madde 6). Yalnız YÜKSEKLİK büyür, genişlik sabittir: `hideOn`
             // kırılım noktaları ve duyarlı yerleşim kareyi çekerken kaymaz (K4).
+            // Doku sınırı RASTER pikseldir: mobil kare @2-3 çekilir, CSS tavanı ölçekle bölünür (web'de
+            // ölçek ≤ 1, tavan 16384 kalır).
+            const heightLimit = Math.floor(maxCaptureHeight / Math.max(1, (request.dpr ?? 1) * (request.scale ?? 1)));
             const measured = request.fullPage ? await measureContentHeight(page) : undefined;
-            const captureHeight = measured === undefined ? undefined : Math.min(measured, maxCaptureHeight);
+            const captureHeight = measured === undefined ? undefined : Math.min(measured, heightLimit);
             let viewportHeight = request.viewport.height;
             if (captureHeight !== undefined && captureHeight > viewportHeight) {
                 await page.setViewportSize({ width: request.viewport.width, height: captureHeight });
@@ -1018,10 +532,10 @@ export class StudioScreenshotter {
                 clip = await resolveClip(page, request.clip);
                 if (clip.y + clip.height > viewportHeight) {
                     const wanted = Math.ceil(clip.y + clip.height) + 8;
-                    if (wanted > maxCaptureHeight) {
-                        throw new PlatformApiError(`page_screenshot: kırpma kutusu ${Math.round(clip.y)}+${Math.round(clip.height)} px'te bitiyor ve Chromium'un ${maxCaptureHeight} px'lik doku sınırının altına sığmıyor — viewport o kadar büyütülemez ve kare kutunun tamamını gösteremezdi. Kutuyu elle daraltın ({ x, y, width, height }) ya da sayfayı bölerek doğrulayın.`);
+                    if (wanted > heightLimit) {
+                        throw new PlatformApiError(`page_screenshot: kırpma kutusu ${Math.round(clip.y)}+${Math.round(clip.height)} px'te bitiyor ve Chromium'un ${maxCaptureHeight} px'lik doku sınırının${heightLimit === maxCaptureHeight ? '' : ` (bu ölçekte ${heightLimit} CSS px)`} altına sığmıyor — viewport o kadar büyütülemez ve kare kutunun tamamını gösteremezdi. Kutuyu elle daraltın ({ x, y, width, height }) ya da sayfayı bölerek doğrulayın.`);
                     }
-                    const grown = Math.min(wanted, maxCaptureHeight);
+                    const grown = Math.min(wanted, heightLimit);
                     await page.setViewportSize({ width: request.viewport.width, height: grown });
                     viewportHeight = grown;
                     await this.settleAfterResize(page, readiness.snapshot?.href ?? request.url);
@@ -1072,7 +586,7 @@ export class StudioScreenshotter {
                 readyAfterMs: readiness.waitedMs,
                 ...(finalUrl === undefined ? {} : { finalUrl }),
                 ...(measured === undefined ? {} : { contentHeight: measured }),
-                ...(measured !== undefined && measured > maxCaptureHeight ? { fullPageTruncated: true } : {}),
+                ...(measured !== undefined && measured > heightLimit ? { fullPageTruncated: true } : {}),
                 ...(layout === undefined ? {} : { layout }),
                 ...(actions === undefined ? {} : { actions }),
                 ...(runtimeErrors.length > 0 ? { runtimeErrors } : {}),

package/dist/platform/capture/index.js

@@ -0,0 +1,10 @@
+/**
+ * Ekran görüntüsü çekirdeği (plans/mobil-uygulama-expo G3): tarayıcı sözleşmesi, hazırlık kararı,
+ * etkileşim eylemleri, DOM özeti ve çekim döngüsü ayrı modüllerde; platforma göre değişen
+ * kısım yakalama HEDEFİDİR (`target.ts`, `targets/*`).
+ */
+export * from './browser.js';
+export * from './actions.js';
+export * from './summary.js';
+export * from './readiness.js';
+export * from './capture.js';