@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/README.md

@@ -4,10 +4,10 @@ Zeyrek (NgApps) platformunu **MCP tool'ları** olarak sunan bağımsız gateway.
 oturumu Studio arayüzüne hiç girmeden proje kurabilir, veri modeli çıkarabilir, mikroservis ve
 workflow yazıp çalıştırabilir, sayfa tasarlayabilir.
 
-- **191 tool · 32 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
+- **208 tool · 34 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
   import, microservice, query, workflow, automation, function, dto, view, dependency), Studio
-  tasarım tarafı (page, component, external component, flow, layout, variable, function, folder,
-  file, access, translation), yönetim (template, organization, deployment) ve proje dallanması
+  tasarım tarafı (page, **theme**, component, external component, flow, layout, variable, function,
+  folder, file, access, translation), yönetim (template, organization, deployment) ve proje dallanması
   (environment, merge).
 - Platform koduna referans vermez: Organization.API ile Tenant.API'yi **HTTP üzerinden** sarar —
   istekler MVC binding'den geçtiği için FluentValidation aynen çalışır.
@@ -29,7 +29,7 @@ ekleyin:
     "zeyrek-ai": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@appaflytech/zeyrek-ai-mcp@0.0.5", "--stdio"],
+      "args": ["-y", "@appaflytech/zeyrek-ai-mcp@latest", "--stdio"],
       "env": {
         "ORG_API_BASE_URL": "https://new-zeyrek.glomil.com/api/org",
         "TENANT_API_BASE_URL": "https://new-zeyrek.glomil.com/api",
@@ -56,7 +56,7 @@ claude mcp add zeyrek-ai \
   -e DEFAULT_ENVIRONMENT=development \
   -e USERNAME=admin@zeyrek.com \
   -e PASSWORD='parolanız' \
-  -- npx -y @appaflytech/zeyrek-ai-mcp@0.0.5 --stdio
+  -- npx -y @appaflytech/zeyrek-ai-mcp@latest --stdio
 ```
 
 **İlk doğrulama:** oturumda `platform_whoami` tool'unu çağırtın — kimlik, org çözümü ve ağ
@@ -64,9 +64,10 @@ erişimi tek seferde test edilir. Tool listesi boş geliyorsa Sorun giderme böl
 
 ### Sürüm seçimi
 
-`@0.0.5` gibi sabit sürüm önerilir: npx kopyayı önbelleğe alır, sabit sürümde herkes aynı
-gateway'i çalıştırır. `@latest` yazarsanız ekipteki makineler farklı sürümlerde kalabilir;
-güncellemek için `.mcp.json`'daki sürümü yükseltip MCP sunucusunu yeniden başlatın.
+`@latest` önerilir: `main`'e giren her gateway değişikliği CI'da otomatik yayınlanır (bkz.
+Yayınlama), yeni sürüm MCP sunucusu yeniden başlatılınca gelir. npx kopyayı önbelleğe aldığı
+için eski sürümde kalan makinede `~/.npm/_npx` silinip sunucu yeniden başlatılır. Herkesin aynı
+gateway'i çalıştırması gereken işlerde (koşu, kabul testi) `@0.0.8` gibi sabit sürüm yazın.
 
 ---
 
@@ -138,10 +139,10 @@ ya da ikisi karışık (`core,page`). `platform` modülü (3 tool) her kümede v
 
 | Küme | Tool | Modüller |
 |---|---|---|
-| `core` | 111 | platform, project, application, datasource, entity, row, microservice, query, workflow, automation, function, dto, view, dependency, environment, merge, activity, revision |
-| `studio` | 69 | platform, page, component, externalComponent, flow, layout, variable, function, folder, file, access, translation, revision |
-| `admin` | 26 | platform, template, organization, deployment, environment, merge, activity |
-| (boş) | **185** | 32 modülün tamamı |
+| `core` | 136 | platform, project, application, datasource, entity, row, import, microservice, microfunction, query, workflow, automation, function, dto, view, dependency, environment, merge, activity, revision |
+| `studio` | 78 | platform, page, theme, component, externalComponent, flow, layout, variable, function, folder, file, import, access, translation, revision |
+| `admin` | 27 | platform, template, organization, deployment, environment, merge, activity |
+| (boş) | **208** | 34 modülün tamamı |
 
 Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları listeleyen bir hata yazar.
 
@@ -165,7 +166,8 @@ Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları li
   `platform_guide('page')`.
 - **Yazma tool'ları replace gövdeleri merge eder:** `page_update`, `layout_update`,
   `component_update` kaydı önce okur, yalnız verdiğiniz alanları değiştirir; şema/olay kaybı
-  olmaz. `flow_*` uçlarının istediği barındırıcı gövdesini de gateway kurar.
+  olmaz. `flow_*` yazmaları yalnız akışı gönderir; olay bağı `page_schema_patch` /
+  `layout_schema_patch` / `component_schema_patch` ile ayrı yazılır.
 - **Gerçek ekran:** UI değişikliği `page_screenshot` ile doğrulanır (`STUDIO_BASE_URL` gerekir;
   ilk kullanımda `npx playwright-core install chromium`).
 
@@ -213,7 +215,7 @@ etiketleri, diğer `LOG_*` ayarları ve maskeleme:
 | `POST /connect/token` 404 / "kayıt bulunamadı" | Kimlik makine kullanıcı adıyla gidiyor — `USERNAME` üstteki üçüncü davranış maddesi. |
 | `Host` çözülemedi / 404 | `ORGANIZATION` + `HOST_SUFFIX` birlikte `{org}.{suffix}` üretir; ikisi de doğru olmalı. |
 | `page_screenshot` hata veriyor | `STUDIO_BASE_URL` boş ya da tarayıcı yok: `npx playwright-core install chromium` veya `SCREENSHOT_BROWSER_PATH`. |
-| Eski sürüm çalışıyor | npx önbelleği: `.mcp.json`'da sabit sürüm yazın ve sunucuyu yeniden başlatın. |
+| Eski sürüm çalışıyor | npx önbelleği: `~/.npm/_npx`'i silip sunucuyu yeniden başlatın ya da `.mcp.json`'da sabit sürüm yazın. |
 
 Her durumda ilk bakılacak yer günlük dosyasıdır (`LOG_DIR`).
 
@@ -225,7 +227,7 @@ Gateway'i ortak bir sunucu olarak çalıştırmak için (stateless streamable HT
 POST):
 
 ```bash
-npx -y @appaflytech/zeyrek-ai-mcp@0.0.5     # --stdio olmadan
+npx -y @appaflytech/zeyrek-ai-mcp@latest     # --stdio olmadan
 ```
 
 Sağlık ucu: `http://localhost:5100/healthz` (port `MCP_PORT`). İstemci kaydı:
@@ -276,19 +278,23 @@ kural envanteri [`docs/08-kural-envanteri.md`](docs/08-kural-envanteri.md).
 
 ### Yayınlama (paket bakımcısı)
 
+Yayın otomatiktir: `main`'e `zeyrek-mcp/` değişikliği girince CI işi `publish:mcp:npm`
+([`scripts/ci-publish-npm.sh`](scripts/ci-publish-npm.sh)) paketi üretip npm'deki son sürümle
+içerik olarak karşılaştırır; pakete giren dosyalar değiştiyse yeni patch sürümünü yayınlar.
+Sürümün kaynağı npm'dir, CI `package.json`'ı geri commit'lemez. Minor/major için
+`package.json`'daki sürümü elle yükseltip merge edin. Yayını o commit için atlamak: commit
+mesajına `DoNotDeploy` (iş elle tetiklenir hâle gelir).
+
+Yerelde deneme (yayın yapmaz; `npm ci` çalıştırdığı için bir kopyada ya da Linux container'da):
+
 ```bash
-cd zeyrek-mcp
-npm run typecheck && npm test
-npm version patch            # package.json sürümü
-npm publish                  # prepack: tsc -p tsconfig.build.json + varlık kopyalama
+DRY_RUN=1 sh scripts/ci-publish-npm.sh
 ```
 
 `dist/` içine `src/resources/{schemas,guides,examples}` altındaki JSON/MD varlıklarını
 `scripts/copy-assets.ts` kopyalar — `tsc` tek başına bunları taşımaz. Yayınlanan paket
 `dist/`, `README.md` ve iki `.env` şablonundan oluşur.
 
-Sürüm yükseldikten sonra ekipteki `.mcp.json` örneklerindeki sabit sürümü de güncelleyin.
-
 ---
 
 ## Bilinen sınırlar

package/dist/config.js

@@ -16,6 +16,7 @@ export const moduleNames = [
     "dto",
     "view",
     "page",
+    "theme",
     "component",
     "externalComponent",
     "flow",
@@ -61,6 +62,7 @@ export const modulePresets = {
     studio: [
         "platform",
         "page",
+        "theme",
         "component",
         "externalComponent",
         "flow",

package/dist/knowledge/backendConstraints.js

@@ -417,6 +417,9 @@ function microserviceFindings(body) {
             findings.push(`sourceParameters.fields[${index}]: writeOn:'${String(field.writeOn)}' yalnız operation:'upsert' ucunda anlamlı; bu uç '${operation ?? '?'}' — writeOn'u kaldırın ya da 'always' bırakın (Fields.All(WriteOn == Always) when Operation != Upsert).`);
         }
     });
+    if (body.source === 'table' && operation !== undefined && operation.startsWith('bulk-') && asObjects(parameters.filters).length > 0) {
+        findings.push(`sourceParameters.filters: '${operation}' ucu filtre KULLANMAZ — bulk create/update satırları gövdeden, bulk delete birincil anahtarları gövdeden okur. Filtreleri kaldırın.`);
+    }
     flattenFilters(parameters.filters).forEach((filter, index) => {
         if (!isSingleFilter(filter))
             return;

package/dist/knowledge/componentCatalog.js

@@ -45,9 +45,12 @@ export const STYLE_GROUP_NOTES = {
  * borderWidth…) yerini alır; kayıtlı appearance değerleri çizilmeye devam eder
  * ama Studio'da artık düzenlenmez — yeni karar surfaceStyle'a yazılır.
  */
+const DATE_VALUE_FORMAT_NOTE = "YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metni (dilim eki yok; valueOffset verilmişse o kadar saat kaydırılmış) ya da null. Biçim uygulama dilinden ve locale'den BAĞIMSIZDIR — locale yalnız ekrandaki metni değiştirir. Uca type:'text' parametreyle aynen gider; SQL'de ::timestamp ile okunur, to_timestamp/AM-PM ayrıştırması GEREKMEZ (G-01: backend bu değeri eskiden en-US '9/15/2026 10:23:00 PM' metnine çeviriyordu, 2026-09-15'te düzeltildi).";
 export const LOCALE_FOLLOWS_APP_NOTE = "Boş bırak — komponent o zaman UYGULAMA dilini izler ve language-selector ile dil değişince gün/ay adları ve saat biçimi anında güncellenir. Doldurulursa o dile SABİTLENİR (bilinçli sabitleme için). Tasarımcı listesi tr/en gösterir ama uygulama dili yolu her ISO 639-1 kodunu kabul eder; sözlüğü olmayan dilde METİN İngilizceye düşer, sayı/tarih BİÇİMİ o dilin kendi kuralını kullanır.";
 const NODE_SURFACE_NOTE = STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens +
     " Bu bileşen grubu KENDİ OKUMAZ: render katmanı yüzeyi düğüm kutusuna (.ng-app__node-item) yazar, contentOverflow kutunun kendisine iner. Eski appearance Surface alanları (background/borderWidth/radius/shadow/opacity/overflow) EMEKLİ — yeni karar buraya yazılır.";
+/** layout ve navigations'ın ORTAK menü satırı grubu (frontend style-group-schemas.ts navigationStyleGroup + navigation-style-logic.ts). */
+const NAVIGATION_STYLE_NOTE = "Menü satırlarının TİPLİ grubu, menünün TAMAMINA uygulanır: padding (CSS kutu kısayolu; sol değer satırın derinlik girintisiyle TOPLANIR), radius (tema kademesi 'sm|md|lg|pill' ya da CSS), textColor · iconColor · hoverBackground (seçili OLMAYAN satırlar), activeBackground · activeTextColor · activeIconColor (seçili satır; zemin hover'da da korunur). Boş iconColor yazı rengini izler. Renkler hex ya da var(--ng-…) token'ı alır. ÖĞE BAZLI STİL YOKTUR: navigations[].style diye bir alan tanımlı değil, yazılan değer sessizce düşer — satır görünümünü yalnız bu grup verir. Grubun yazmadığı CSS için style'ın &__item / &__item--active / &__icon parçaları kullanılır (yalnız navigations bileşeninde; layout'un style'ı menüye ulaşmaz). resolvedStyle raporu bu grubu İÇERMEZ.";
 export const componentKnowledge = {
     html: {
         summary: 'Kaçış kapısı: hazır komponentler yetmediğinde ham HTML + Mustache şablonu + scoped CSS + satır içi script + flow köprüsüyle her gereksinimi kapatır.',
@@ -114,7 +117,7 @@ export const componentKnowledge = {
             image: "IMAGE/FILE kolonu düz URL string'i KABUL ETMEZ: hücre `{ absolute_path, display_name }` (ya da `fileName`) alanlarını taşıyan bir DOSYA NESNESİ (veya nesne dizisi) bekler — `DisplayCellView.svelte:10` `file.absolute_path ?? ''` okur, düz string verilince kaynak boş kalır ve hücre SESSİZCE boş çizilir (09-04 Y-21). Satır verisi bir metin kolonunda URL taşıyorsa kolonu 'url'/'link' yap ya da veriyi { absolute_path: '<url>', display_name: '<ad>' } biçimine çevir; entity'nin FILE alanı zaten bu şekli döner.",
             actions: "Satır aksiyonları. kind sözlüğü BUTON'unkinden farklıdır: error · information · solid · transparent · dark · danger · warning (butonda success/error/info/primary/warning). Yanlış sözlükten değer invalid-enum-value verir.",
             selectedRow: "Salt okunur: satır aksiyonu tıklanınca komponentin kendisi doldurur; akış ifadesinde '<elementId>.selectedRow' ile okunur.",
-            colorMap: "Kolon içi değer→renk sözlüğü: [{ value:'Active', color:'#16a34a' }]. STATİKTİR — hücrenin kendi değerine bakar, satırın başka alanına göre hesaplanamaz. Satıra göre koşullu renk gerekiyorsa ya table + _columns ezmesi kullan ya da satır verisinde rengi taşı ({ label, color }) — render sırası: veri objesindeki color → colorMap[etiket] → autoColor.",
+            colorMap: "Kolon içi değer→renk sözlüğü: [{ value:'Active', color:'#16a34a' }]. STATİKTİR — hücrenin kendi değerine bakar, satırın başka alanına göre hesaplanamaz. Satıra göre koşullu renk gerekiyorsa ya table + _columns ezmesi kullan ya da satır verisinde rengi taşı ({ label, color }) — render sırası: veri objesindeki color → colorMap[etiket] → autoColor. TAG HÜCRE ŞEKLİ: metin, { label, color? } ya da { value, color? } (label yoksa value okunur; ikisi de yoksa obje ham JSON basılır) veya bunların dizisi. RENK (veri objesinde de colorMap'te de): semantik ad primary · info · success · warning · error TEMA TOKEN'INA çözülür (tema değişince izler, ham hex yazmaya gerek yok); hex/rgb/'var(--ng-…)'/CSS renk adı olduğu gibi geçer; başka bir değer (yazım hatası, çözülmemiş '{{ }}') o kademeyi ATLAR ve sıradakine düşer. Veri objesindeki variant OKUNMAZ — outline/solid kolonun appearance'ından gelir. Solid rozetin yazı rengi token'da CSS ile siyah/beyaz seçilir.",
             tableStyle: "zebra | plain — satır zemini varyantı; CSS DEĞİL. Serbest CSS için ayrı `style` prop'u vardır (parça bazlı).",
             style: "Parça bazlı CSS: &__toolbar · &__title · &__head · &__th · &__body · &__row · &__td. designerCss her bildirime !important ekler, yani komponentin kendi çerçeve/ayraç varsayılanlarını ezer — Figma tipi düz tablo bununla kurulur."
         }
@@ -124,10 +127,12 @@ export const componentKnowledge = {
         behavior: [
             "Düzen prop grubunun TAMAMINI taşır (2026-09-01): layout ('flex' | 'grid') + direction/horizontalAlign/verticalAlign/size/gap/wrap, varsayılanları container ile aynı (flex · row · left · top · shrink · medium · wrap açık). 'Form'a layout yazılmaz' eski bilgidir. layout prop'u hiç yazılmamış eski form kayıtları ızgara koordinatıyla (blocks[].position + size.w) dizilmeye devam eder. Platform kataloğu component_get'te hâlâ eski şemayı gösteriyorsa kayıt yenilenmemiştir (ARC-024).",
             "Alan doğrulaması komponentin kendi validations dizisindedir: [{ type: 'required'|'email'|'max-length'…, message, value, isActive }] — dördü de zorunlu, eski 'maxLength' yazımı kaydedilir ama runtime doğrulayıcı onu TANIMAZ ve sessizce hiçbir şey doğrulamaz.",
-            "message bir ÇEVİRİ ANAHTARI olabilir: 't:' önekiyle yazılan mesaj (ör. 't:form.required') uygulamanın çeviri sözlüğünden çözülür — hem alanın kendi hata metninde hem form-validation-errors listesinde. Öneksiz mesaj yazarın kendi cümlesidir ve iki nokta içerse bile aynen gösterilir. Çözüm form MOUNT olurken bir kez yapılır: ekranda hata dururken dil değiştirilirse metin sayfa yenilenene kadar eski dilde kalır."
+            "message bir ÇEVİRİ ANAHTARI olabilir: 't:' önekiyle yazılan mesaj (ör. 't:form.required') uygulamanın çeviri sözlüğünden çözülür — hem alanın kendi hata metninde hem form-validation-errors listesinde. Öneksiz mesaj yazarın kendi cümlesidir ve iki nokta içerse bile aynen gösterilir. Çözüm form MOUNT olurken bir kez yapılır: ekranda hata dururken dil değiştirilirse metin sayfa yenilenene kadar eski dilde kalır.",
+            "Formu temizlemek için akış kodunda resetForm('<form adı>') çağrılır (2026-09-15): alanlar başlangıç değerine döner, form gönderilmemiş hâline geçer, hata işaretleri ve form-validation-errors listesi silinir. Alanları setter ile tek tek null'a çekmek YANLIŞ yoldur: form bir kez gönderildiyse her change doğrulamayı yeniden koşturur ve boş form 'zorunlu alan' mesajlarıyla açılır. Gönderim sonrası otomatik temizlik isteniyorsa isClearFormInputsAfterSubmit aynı sıfırlamayı yapar."
         ],
         propNotes: {
-            surfaceStyle: NODE_SURFACE_NOTE,
+            surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Form grubu KENDİ derler (2026-09-15): değer <form> KÖKÜNE iner, contentOverflow gövdeye ('&__body'). Formu bir kartın içine koyup kendi zeminini/çerçevesini kaldırmanın yolu budur: { background: 'transparent', borderTop: 'none', borderRight: 'none', borderBottom: 'none', borderLeft: 'none' }.",
+            style: STYLE_GROUP_NOTES.styleEscape + " Parçalar: KÖK (anahtarlar doğrudan style'da) <form> elemanıdır ve TABAN zemini (--ng-background-surface), 1px çerçeveyi (--ng-border-primary) ve köşeyi (--ng-rounded) ÇİZER; '&__body' yalnız kaydırma/esneme taşır — çerçeveyi '&__body'ye yazarak kaldıramazsın. '&__header' başlık bandı, '&__title' başlık metni. DOM yapısına bağlı seçiciler ('& > div') belgelenmemiştir ve iç yapı değişince sessizce kırılır.",
             errorElementId: "Sayfadaki form-validation-errors komponentinin elementId'si — bağlanmazsa alan doğrulama mesajları görünmez."
         }
     },
@@ -244,7 +249,7 @@ export const componentKnowledge = {
         behavior: [
             "Yerleşim prop'ları (layout/direction/gap/gridColumns...) box ile BİREBİR aynıdır ve bileşende okunmaz — çocuk sarmalayıcısını RenderComponent/Draggable giydirir. layout değerleri de box ile aynı: 'flex' | 'grid' (2026-09-02'de 'cssgrid' seçenek olmaktan çıktı; o değerle kayıtlı düğümler gerçek display:grid akışıyla çizilmeye devam eder).",
             "KATMAN SIRASI (K4): tema componentStyles → $preset TABANDIR (varsayılan verir); tipli grup alanları temayı alan alan EZER (tasarımcının/AI'ın açık seçimi kazanır); düğümün serbest style'ı her şeyin üstünde SON SÖZDÜR.",
-            "TEMA PRESET'İ: bir tema preset'ini düğüme bağlamak için style.$preset: '<ad>' yaz (adlar project_get → theme.presets; componentStyles[type] referanssız, tipin her örneğine uygulanır). Bir alanı 'temaya bırakmak' = o alanı HİÇ yazmamak (null/boş) — studio'daki 'Temaya dön' tam olarak bunu yapar; tema değerini gruba kopyalamak bağı koparır.",
+            "TEMA PRESET'İ: bir tema preset'ini düğüme bağlamak için style.$preset: '<ad>' yaz (adlar theme_get → presets, sayfa bağlamında page_runtime_get → theme.presets; preset'i yazmak/silmek theme_update; componentStyles[type] referanssız, tipin her örneğine uygulanır). Bir alanı 'temaya bırakmak' = o alanı HİÇ yazmamak (null/boş) — studio'daki 'Temaya dön' tam olarak bunu yapar; tema değerini gruba kopyalamak bağı koparır.",
             "STİL YAZMA SIRASI: önce tipli gruplar (alan varsa oraya), grubun karşılamadığı karar style kanalına (custom properties). Tipli alan dururken aynı özelliği style'a yazmak paneli yanıltır — style kazanır ama panel alanı 'etkisiz' görünür.",
             "Yüzey neden prop: düğümün appearance kanalı sarmalayıcıyı (.ng-app__node-item) boyar, kutunun İÇİNİ değil — box'ta .ng-box'ın kendi background/border-radius'una hiçbir panelden ulaşılamıyor. surfaceStyle bu boşluğu kapatır.",
             "Bölge (header/footer) düğümleri box ile ORTAKTIR: hasHeader/hasFooter aynı box-section düğümlerini açar. sectionStyle kuralları bu yüzden '&__header' gibi bir parçaya değil, gerçek '& .ng-box-section--header' seçicisine yazılır.",
@@ -282,7 +287,7 @@ export const componentKnowledge = {
             layout: "'flex' (katalog varsayılanı; akış) | 'grid' (12 kolonluk ızgara). Prop hiç yazılmamışsa renderer IZGARA çizer — varsayılan yalnız düğüm kurulurken materyalize olur. Aşağıdaki altı prop YALNIZ 'flex' iken etkilidir.",
             direction: "'row' (varsayılan) | 'column' → flex-direction. Hangi hizalamanın ana eksen olduğunu bu belirler.",
             horizontalAlign: "left | center | right | stretch. row'da ANA eksen (justify-content), column'da ÇAPRAZ eksen (align-items). stretch: ana eksende space-between, çapraz eksende tam doldurma.",
-            verticalAlign: "top | middle | bottom | stretch. row'da ÇAPRAZ eksen, column'da ANA eksen — horizontalAlign ile rollerini değiştirirler.",
+            verticalAlign: "top | middle | bottom | stretch. row'da ÇAPRAZ eksen, column'da ANA eksen — horizontalAlign ile rollerini değiştirirler. row'da stretch seçiliyken çocuğun sabit yüksekliği (heightType fixed → heightString ya da size.h×10px) HEIGHT değil MIN-HEIGHT olarak yazılır (2026-09-15): çocuklar en uzun kardeşin boyuna eşitlenir, sabit ölçü taban kalır — eşit boylu KPI kartları için her karta elle aynı heightString yazmak gerekmez. İstisna: isScrollable çocuk kesin yüksekliğini korur. Izgara kapta (layout grid) bu prop da gap de okunmaz; eşit kart satırı flex row + stretch ile kurulur.",
             size: "'shrink' (çocuklar flex: 0 1 auto, varsayılan) | 'grow' (flex: 1 1 auto — çocuklar boşluğu paylaşır).",
             gap: "none | small | medium (varsayılan) | large → tema değişkenleri: 0 / var(--ng-spacing-sm) / --ng-spacing-md / --ng-spacing-lg (varsayılan temada 8/16/32px). Alan allowCustom'dır: '18px' ya da 'var(--ng-spacing-xl)' gibi ham CSS değeri de geçer. Çocuk genişlik formülünden payı düşülür, böylece w toplamı 12 olan satır tam kapanır.",
             wrap: "flex-wrap: wrap. Varsayılan AÇIK (2026-09-01'de flipledi): w:12 çocuklar alt satıra sararak dikey akar. Kapatırsan satıra sığmayan çocuklar sıkışır, alta inmez.",
@@ -300,7 +305,10 @@ export const componentKnowledge = {
     },
     modal: {
         summary: 'Ortalanmış katman; şemanın KÖKÜNDE page_container’ın kardeşi olarak durur, içeriği (kendi formu ve submit akışı dahil) children’ına eklenir.',
-        behavior: ["open/close olayları akışa bağlanabilir; açma/kapama isHidden ile değil kendi open state'iyle yürür (setter ile isOpen yaz)."],
+        behavior: [
+            "open/close olayları akışa bağlanabilir; açma/kapama isHidden ile değil kendi open state'iyle yürür (setter ile isOpen yaz).",
+            "Kaplama çerçevesidir (isFrame): kanvasta blok tutmaz, runtime kutu stili yazmadan ayrı dalda çizer. Katalog boyutu bilerek BOŞ aralıktır (minSize 1, maxSize 0) ve 2026-09-15'ten beri doğrulayıcı blocks[].size'ı hiçbir eksende DENETLEMEZ (boyut sınırı kanvasın kuralıdır) — add_component ile kökte (parent null) herhangi bir { w, h } ile eklenir. Daha eski backend build'i her boyutu 'Height of modal must be between 1 and 0' (invalid-size) ile reddeder; o durumda imaj yenilenmemiştir. drawer ve toast aynı kuraldadır."
+        ],
         propNotes: { surfaceStyle: NODE_SURFACE_NOTE }
     },
     drawer: {
@@ -516,30 +524,105 @@ export const componentKnowledge = {
             isLoading: 'Grubu KİLİTLER (checkboxgroup deseni): seçenek listesi soluklaşır, tık yutulur, change yayılmaz ve grup aria-busy taşır; etiketin yanında dönen spinner çizilir. Seçenekleri getiren sorgu sürerken aç, gelince kapat.'
         }
     },
-    datepicker: { summary: 'Tarih seçici; change yükü { value, HH, mm }.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
-    datetimepicker: { summary: 'Tarih+saat seçici; değer event.data’da değil self.value’dadır.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
-    daterangepicker: { summary: 'Tarih aralığı; change yükü { valueFrom, valueTo, HH, mm }.', propNotes: { locale: LOCALE_FOLLOWS_APP_NOTE } },
+    datepicker: {
+        summary: 'Tek GÜN seçici (saat yok): takvimden ya da kutuya yazarak; change yükü tek anahtar { value }.',
+        behavior: [
+            "Değer YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok, saat kısmı seçimde 00:00) ya da null. change düğümün prop'una yazar: akış değeri self.value ile okur, event.data BOŞTUR (CQ-149). 2026-09-15 öncesinde bu kayıt yükte HH ve mm anahtarları da olduğunu söylüyordu — runtime hiç göndermiyordu, self.HH okuyan ifade boş dönerdi.",
+            "minDate/maxDate GÜN sınırıdır ('yyyy-MM-dd'): ikisi de KENDİ günü dahil seçilebilir kalır. 2026-09-15'te düzeltildi — çıplak gün metni UTC gece yarısı olarak okunuyordu, Greenwich'in doğusunda (TR: +03) minDate'in kendi günü takvimde PASİF görünüyordu, yazarak seçilirse değer 03:00'a kaydırılıyordu; batısında (örn. New York −04) aynı kusur maxDate'te çıkıyordu — maxDate'in KENDİ günü pasifti. Sınır dışı günler takvimde pasiftir; kutuya YAZILAN sınır dışı bir tarih hata vermez, o sınır gününün gece yarısına çekilir. Akıştan yazılan değer bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            'Takvim tek gün seçtirir; komşu ayların günleri de seçilebilir, yıl açılır listesi 1900-2100 arasında gezer, popup her ay altı hafta çizer. Seçim anında popup kapanır ve change yayılır — onay adımı yoktur.',
+            "Kutuya elle yazmak için çift tıklanır (tek tık takvimi açar). Okunan desenler tr'de 'd MMM yyyy' · 'd MMMM yyyy' · 'd.MM.yyyy' · 'dd.MM.yyyy' · 'dd.MM.yy', diğer dillerde 'MMM d, yyyy' · 'MMMM d, yyyy' · 'MM/dd/yyyy' · 'M/d/yyyy' · 'MM/dd/yy'; 1900 öncesi ve 2100 sonrası yıl reddedilir. Okunamayan yazı tutulan değere döner, değer yoksa kutu BOŞALIR (2026-09-15; öncesinde reddedilen metin değermiş gibi ekranda kalıyordu). Kutu salt okunur olsa da programdan gelen change'i DİNLER: page_screenshot 'set' ile ISO tarih ('2026-08-01', '2026-08-01T09:30') ya da gösterim biçimi yazılabilir ve değer takvimden seçilmiş gibi yayılır; okunamayan metinde actionsReport propWritten:false döner. 2026-09-15 öncesi olay dinlenmiyordu: kutu dolu görünüyor, prop boş kalıyordu (G-14).",
+            'Doğrulama kuralları: required · min · max (2026-09-15; pattern bildirimi kaldırıldı — panel tarih alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu, CQ-226). min/max değeri gün metnidir ve alanın minDate/maxDate prop\'larından AYRIDIR: minDate/maxDate takvimi kısar, min/max gönderimde hata gösterir. DİKKAT (CQ-252): Form kuralın gün metnini UTC, alanın değerini YEREL okuyor (form/helper.ts dateMs), yani UTC olmayan her dilimde SINIR GÜNÜNÜN KENDİSİ yanlış tarafta kalıyor — Türkiye saatinde tam min gününe eşit bir değer yine de en-az hatası veriyor. Bugünkü güvenli yol: sınırı bir gün geniş tutmak ya da kural yerine minDate/maxDate kullanmak.',
+            'focus/blur ALAN düzeyindedir (2026-09-15): girdi ile takvim arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.',
+            'isLoading KİLİT DEĞİLDİR (2026-09-15): alan kullanılabilir kalır, sağ uçta dönen spinner çizilir (o sırada X gizlenir) ve kök aria-busy taşır. Kilit için isDisabled kullan.',
+            "Değer doluyken sağ uçta X çıkar ve change'i null ile yayar; kilitli kipte X yoktur. Gösterim dili locale'den (boşsa uygulama dili): tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'. Biçim ve haftanın ilk günü prop'u YOK (ARC-071).",
+            'Saat gerekiyorsa datetimepicker, aralık gerekiyorsa daterangepicker kullanılır; bu bileşen saat taşımaz.'
+        ],
+        propNotes: {
+            value: "Seçili gün: 'yyyy-MM-ddTHH:mm:ss' ya da 'yyyy-MM-dd' metni, ya da null. Çıplak gün YEREL okunur (UTC kaydırması yok). Okunamayan metin alanı BOŞ gösterir, hata vermez. " + DATE_VALUE_FORMAT_NOTE,
+            minDate: "En erken gün ('yyyy-MM-dd'); o günün kendisi seçilebilir, öncesi takvimde pasif kalır.",
+            maxDate: 'En geç gün; o günün kendisi seçilebilir, sonrası pasif kalır.',
+            placeholder: "Boş alanda görünen metin; varsayılanı '01.01.2000' ama kutu değeri her zaman dilin desenine göre yazar (tr '10 Eyl 2026', diğer diller 'Sep 10, 2026') — yer tutucu bir biçim SÖZÜ DEĞİLDİR.",
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez. Gün sınırına yakın bir değeri komşu güne kaydırabilir.',
+            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3).',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
+        }
+    },
+    datetimepicker: {
+        summary: 'Tek alanda tarih + saat seçici: takvim + dakika adımlı saat listesi; değer tek value, change yükü { value }.',
+        behavior: [
+            "Değer YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok) ya da null. change düğümün prop'una yazar: akış değeri self.value ile okur, event.data BOŞTUR (CQ-149). 2026-09-16 öncesinde olay kaydında yük anahtarı yoktu; runtime her zaman { value } gönderiyordu.",
+            "Değer ancak TARİH + SAAT ikisi de seçilince yazılır: boş alanda takvimden yalnız gün seçmek change YAYMAZ — gün ekranda taslak kalır (kutu günü ve 00:00'ı gösterir ama self.value null'dır, required düşer — CQ-237), saat listesi kendiliğinden açılır ve saat seçilince yayılır. Günü yeniden seçmek de taslağı YAZMAZ (2026-09-16'da düzeltildi: ikinci gün seçimi …T00:00:00 yayıyordu). Alan zaten bir değer tutuyorsa (kullanıcı seçmiş ya da akış yazmış) tarihi değiştirmek TUTULAN saati koruyup hemen yayar. Gün seçmeden saat seçmek bugünün gününü kullanır ve hemen yayar. Akıştan gelen değer taslağı düşürür.",
+            "Saat listesi minutesStep adımıyla gösterilen günün (yoksa bugünün) üstünde üretilir; minDate öncesi ve maxDate sonrası saatler listede KALIR ama pasiftir. Liste minutesStep ve dil değişince yeniden üretilir (2026-09-16 öncesinde yalnız değer ya da sınır değişince yenileniyordu).",
+            "minDate/maxDate tarih-saat ANIDIR ('yyyy-MM-ddTHH:mm'): takvimde sınırın KENDİ günü seçilebilir kalır, o günün sınır dışı saatleri listede pasiftir. 2026-09-16'da düzeltildi — takvim sınırı an olarak karşılaştırıyordu, saati olan bir minDate (örn. …T14:00) kendi gününü takvimde PASİF gösteriyordu, o gün hiç seçilemiyordu. Yayma öncesi sarmalayıcı seçimi [minDate, maxDate] içine çeker (sınır dışı seçim hata VERMEZ, sınıra yapışır); akıştan yazılan değer bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            "Kutulara elle yazmak için çift tıklanır (tek tık takvimi / saat listesini açar). Tarih kutusu datepicker desenlerini okur (tr 'd MMM yyyy' · 'd.MM.yyyy' …, diğer dillerde 'MMM d, yyyy' · 'MM/dd/yyyy' …, her dilde ISO 'yyyy-MM-dd') ve takvimden gün seçmekle AYNI kurala girer. Saat kutusu '14:30', '14', en'de '02:30 PM' okur; okunamayan saat kutuyu tutulan saate geri çevirir, değeri bozmaz. 2026-09-16 öncesinde saat kutusu çift tıklamadan da yazılabiliyordu ve yazılan metin yok sayılıp ekranda kalıyordu.",
+            "page_screenshot 'set' kökte TARİH kutusuna yazar ve takvimden gün seçmekle aynı kuraldır: alan değer tutuyorsa tutulan saat korunup yazılır; boşsa yalnız taslak olur ve actionsReport propWritten:false döner. ISO metnindeki saat kısmı ('2026-08-01T09:30') KULLANILMAZ ve saat kutusunun iç kimliği yoktur, 'set' ile hedeflenemez (TOOL-020). Tam değeri doğrulamak için önce akıştan self.value yazın.",
+            "Doğrulama kuralları: required · min · max (2026-09-16; pattern bildirimi kaldırıldı — panel tarih-saat alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu, CQ-226). min/max değeri 'yyyy-MM-ddTHH:mm' metnidir ve alanın minDate/maxDate prop'larından AYRIDIR: minDate/maxDate takvimi ve listeyi kısar, min/max gönderimde hata gösterir. Kurala çıplak gün ('2026-09-10') yazma — Form onu UTC okur ve UTC olmayan dilimde sınır birkaç saat kayar (CQ-252); saatiyle yaz.",
+            'focus/blur ALAN düzeyindedir (2026-09-16): tarih kutusu, saat kutusu, takvim ve saat listesi arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.',
+            'isLoading KİLİT DEĞİLDİR (2026-09-16): alan kullanılabilir kalır, sağ uçta dönen spinner çizilir (o sırada X gizlenir) ve kök aria-busy taşır. Kilit için isDisabled kullan.',
+            "Değer (ya da taslak gün) doluyken sağ uçta X çıkar; değeri boşaltıp change'i null ile yayar, yalnız taslak gün varsa taslağı düşürür ve change YAYMAZ (değer zaten boştu); kilitli kipte X yoktur. Gösterim dili locale'den (boşsa uygulama dili): tarih tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'; saat en'de 12 saat (01:00 PM), diğer dillerde 24 saat. Değer her dilde aynı 24 saatlik metindir. Biçim ve haftanın ilk günü prop'u YOK (ARC-071, CQ-098). Yalnız gün için datepicker, aralık için datetimerangepicker kullanılır."
+        ],
+        propNotes: {
+            value: "Seçili an: 'yyyy-MM-ddTHH:mm:ss' ya da null. Çıplak 'yyyy-MM-dd' YEREL gece yarısı okunur (UTC kaydırması yok). Okunamayan metin alanı BOŞ gösterir, hata vermez. " + DATE_VALUE_FORMAT_NOTE,
+            minutesStep: "Saat listesinin adımı, METİN enum: '1' | '2' | '3' | '4' | '5' | '6' | '10' | '12' | '15' | '30' | '60' (varsayılan '15'). 0, negatif ya da okunamayan değer 15'e düşer; 1 dakika 1440 satır demektir.",
+            minDate: "En erken an ('yyyy-MM-ddTHH:mm'); o günün kendisi takvimde seçilebilir, günün sınırdan önceki saatleri listede pasif kalır. Sınır dışına düşen seçim sınıra çekilir.",
+            maxDate: "En geç an; o gün seçilebilir, sınırdan sonraki saatler pasif, sınır dışı seçim sınıra çekilir. Saatiyle yaz ('…T23:59'): çıplak gün ('2026-09-20') o günün 00:00'ıdır, günün geri kalanı pasif kalır.",
+            placeholder: "Boş tarih kutusunda görünen metin (varsayılan 'Select date'); kutu değeri her zaman dilin desenine göre yazar — yer tutucu bir biçim SÖZÜ DEĞİLDİR.",
+            timePlaceholder: "Boş saat kutusunda görünen metin (varsayılan 'Select time'). Taslak gün seçilince kutu 00:00 gösterir, yer tutucu görünmez (CQ-237).",
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez.',
+            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. displayOffset ile HER ZAMAN ters işaretli ver (+3 / -3): kullanıcı gösterilen saati seçer ve korur, yalnız biri verilirse her tarih değişikliğinde tutulan saat o kadar kayar.',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
+        }
+    },
+    daterangepicker: {
+        summary: 'GÜN aralığı (saat yok): değer valueFrom/valueTo İKİLİSİDİR (tek value yok); her yarı bir takvim + yazılabilir kutu; change yükü { valueFrom, valueTo }.',
+        behavior: [
+            "İki uç da YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok; seçimde saat 00:00, gece yarısı yaşanmayan yaz saati günlerinde 01:00) ya da null. change her iki anahtarı birden taşır ve düğümün prop'una yazar: akış self.valueFrom / self.valueTo ile okur, event.data BOŞTUR (CQ-149). Form aralığı { valueFrom, valueTo } nesnesi olarak görür; required ancak İKİSİ de doluyken geçer. 2026-09-16 öncesinde bu kayıt yükte HH ve mm anahtarları da olduğunu söylüyordu — runtime hiç göndermiyordu.",
+            "minDate/maxDate GÜN sınırıdır ('yyyy-MM-dd'): ikisi de KENDİ günü dahil seçilebilir kalır. Takvimler de gün olarak karşılıklı sınırlanır: bitiş takvimi başlangıç GÜNÜNDEN, başlangıç takvimi bitiş GÜNÜNE kadar açıktır — aynı gün başlayıp biten tek günlük aralık seçilebilir. 2026-09-16'da düzeltildi: çıplak gün metni UTC gece yarısı okunuyordu, Greenwich'in doğusunda (TR: +03) minDate'in kendi günü takvimde PASİF görünüyor ve sınıra çekilen değer 03:00 yazılıyordu, batısında maxDate'in kendi günü pasifti; saatli bir başlangıç (displayOffset, akıştan saatli değer) bitiş takviminde kendi gününü kapatıyordu.",
+            "Yayma öncesi sarmalayıcı çifti üç adımda kurar: (1) her uç [minDate, maxDate] günlerinin içine çekilir (sınır dışı yazılan tarih o sınır gününün gece yarısına yapışır, hata VERMEZ); (2) DEĞİŞEN uç seçilen günden valueOffset kaydırılarak yazılır, DOKUNULMAYAN uç tuttuğu değerle yazılır (kırpma onu taşımadıysa) — aynı günü yeniden seçmek de değişikliktir; (3) sıra YAZILAN değerler üzerinde uygulanır: bitiş başlangıçtan önceyse başlangıca eşitlenir, yani kullanıcı değişikliğinden sonra valueFrom <= valueTo her zaman tutar. Bu yüzden başlangıç saat taşıyorsa (akış '…T10:00:00' yazmışsa) aynı günde biten aralığın bitişi de o saati alır. 2026-09-16 öncesinde iki uç da GÖSTERİLEN hâlinden yeniden türetiliyordu: yalnız displayOffset ya da yalnız valueOffset verilmiş alanda dokunulmayan uç her seçimde o kadar saat kayıyordu. Akıştan yazılan değerler bu kapıdan GEÇMEZ, olduğu gibi gösterilir (ta ki kullanıcı bir yarıyı değiştirene dek); çıplak 'yyyy-MM-dd' YEREL gece yarısı okunur, okunamayan metin yarıyı BOŞ gösterir.",
+            "Başlangıç seçilince ve bitiş boşsa bitiş takvimi kendiliğinden açılır. Her seçim popup'ı kapatır ve change'i hemen yayar — onay adımı yoktur. Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri olduğu gibi); kilitli kipte X yoktur.",
+            "Kutuya elle yazmak için çift tıklanır (tek tık takvimi açar); okunan desenler datepicker ile aynıdır (tr 'd MMM yyyy' · 'd.MM.yyyy' · 'dd.MM.yyyy' …, diğer dillerde 'MMM d, yyyy' · 'MM/dd/yyyy' …, her dilde ISO 'yyyy-MM-dd'). İki kutu ayrı adreslenir: '<elementId>__start' (valueFrom) ve '<elementId>__end' (valueTo). page_screenshot 'set' kökü REDDEDER (tek değer yok); kutuya ISO tarih ('2026-08-01') ya da gösterim biçimi ('1 Ağu 2026') yazılır, kutu değeri kendi change yoluna sokar ve prop'a yazar. Okunamayan metin kutuyu tutulan değere geri çevirir; actionsReport propWritten:false döner (G-14, 2026-09-15).",
+            "Doğrulama kuralları: required · min · max (2026-09-16; pattern bildirimi kaldırıldı — panel tarih alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu, CQ-226). min/max değeri gün metnidir, Form aralığın İKİ ucunu da sınırla karşılaştırır ve alanın minDate/maxDate prop'larından AYRIDIR: minDate/maxDate takvimi kısar, min/max gönderimde hata gösterir. DİKKAT (CQ-252): Form kuralın gün metnini UTC, alanın değerini YEREL okuyor, yani UTC olmayan her dilimde SINIR GÜNÜNÜN KENDİSİ yanlış tarafta kalıyor. Bugünkü güvenli yol: kural yerine minDate/maxDate kullanmak ya da sınırı bir gün geniş tutmak.",
+            "focus/blur ALAN düzeyindedir (2026-09-16): iki kutu ve iki takvim arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.",
+            "isLoading KİLİT DEĞİLDİR (2026-09-16): alan kullanılabilir kalır, iki yarının X'i yerinde durur, satırın sağ ucunda dönen spinner çizilir ve kutu aria-busy taşır (450px altındaki dikey yığılmada spinner çizilmez, aria-busy kalır). Kilit için isDisabled kullan.",
+            "Gösterim dili locale'den (boşsa uygulama dili): tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'. Değer her dilde aynı metindir. Biçim ve haftanın ilk günü prop'u YOK (ARC-071). Saat gerekiyorsa datetimerangepicker, tek gün gerekiyorsa datepicker kullanılır."
+        ],
+        propNotes: {
+            valueFrom: "Başlangıç günü: 'yyyy-MM-ddTHH:mm:ss' ya da 'yyyy-MM-dd' metni, ya da null. Çıplak gün YEREL okunur (UTC kaydırması yok). " + DATE_VALUE_FORMAT_NOTE,
+            valueTo: "Bitiş günü; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı yalnız kullanıcı seçiminde uygulanır.",
+            minDate: "En erken gün ('yyyy-MM-dd'); o günün kendisi iki takvimde de seçilebilir, öncesi pasif kalır.",
+            maxDate: 'En geç gün; o günün kendisi seçilebilir, sonrası pasif kalır.',
+            startPlaceholder: "Başlangıç kutusu boşken görünen metin; varsayılanı '01.01.2000' ama kutu değeri her zaman dilin desenine göre yazar (tr '10 Eyl 2026', diğer diller 'Sep 10, 2026') — yer tutucu bir biçim SÖZÜ DEĞİLDİR.",
+            endPlaceholder: "Bitiş kutusunun yer tutucusu; startPlaceholder ile aynı kural (varsayılan '05.01.2000').",
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez. Gün sınırına yakın bir değeri komşu güne kaydırabilir.',
+            valueOffset: 'DEĞİŞEN ucu yazarken kaydıran saat sayısı; dokunulmayan uç tuttuğu değerle kalır. Gösterim yazılan değerden okunduğu için tek başına verilirse ekranda da görünür (-3: 15 seçilir, \'…14T21:00:00\' yazılır, kutu 14 gösterir) ve min/max kurallarının karşılaştırdığı değeri de kaydırır. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3).',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kutu aria-busy taşır.'
+        }
+    },
     datetimerangepicker: {
         summary: 'Tarih+saat aralığı: değer valueFrom/valueTo İKİLİSİDİR (tek value yok); her yarı bir takvim + dakika adımlı saat listesi; change yükü { valueFrom, valueTo }.',
         behavior: [
             "İki uç da YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok) ya da null. change her iki anahtarı birden taşır ve düğümün prop'una yazar: akış self.valueFrom / self.valueTo ile okur. Form aralığı { valueFrom, valueTo } nesnesi olarak görür; required ancak İKİSİ de doluyken geçer.",
             "Bir yarının değeri ancak TARİH + SAAT ikisi de seçilince yazılır: takvimden yalnız gün seçmek change YAYMAZ — gün ekranda taslak olarak kalır (kutu günü ve 00:00'ı gösterir, CQ-237), günü yeniden seçmek de, diğer yarıyı tamamlamak da o taslağı YAZMAZ; saat listesi kendiliğinden açılır ve saat seçilince yayılır (tek datetimepicker ile aynı kural). Yarı zaten bir değer tutuyorsa (kullanıcı seçmiş ya da akış yazmış) tarihi değiştirmek TUTULAN saati koruyup hemen yayar — 2026-09-12'de düzeltildi, öncesinde listeden saat seçildikten sonra tarih değişikliği ekranda görünüp değere hiç yazılmıyordu. Akıştan gelen değer taslağı düşürür.",
-            "Saat listeleri minutesStep adımıyla o yarının GÜNÜ üstünde üretilir; minDate/maxDate DIŞI ve karşı ucun ÖTESİNDEKİ saatler (başlangıç için bitişten sonrası, bitiş için başlangıçtan öncesi) listede KALIR ama pasiftir. Takvimler de karşılıklı sınırlanır: bitiş takvimi başlangıç gününden önceye, başlangıç takvimi bitiş gününden sonraya izin vermez.",
-            "Yayma öncesi sarmalayıcı sınırlar: her uç [minDate, maxDate] içine çekilir, bitiş başlangıçtan önce kalırsa bitiş başlangıca eşitlenir. Sınır dışı bir seçim hata VERMEZ, sınıra yapışır. Akıştan yazılan değerler bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            "Saat listeleri minutesStep adımıyla o yarının GÜNÜ üstünde üretilir; minDate/maxDate DIŞI ve karşı ucun ÖTESİNDEKİ saatler (başlangıç için bitişten sonrası, bitiş için başlangıçtan öncesi) listede KALIR ama pasiftir. Takvimler GÜN olarak sınırlanır: bitiş takvimi başlangıç GÜNÜNDEN önceye, başlangıç takvimi bitiş GÜNÜNDEN sonraya, ikisi de minDate/maxDate GÜNLERİNİN dışına izin vermez — sınırın KENDİ günü her zaman seçilebilir, saat düzeyindeki sınır yalnız listede ve kırpmada uygulanır (2026-09-16; öncesinde saat taşıyan sınırın kendi günü takvimde pasifti: başlangıç 10:30 iken aynı gün biten aralık, minDate 09:00 iken o gün seçilemiyordu).",
+            "Yayma öncesi sarmalayıcı sınırlar: her uç [minDate, maxDate] ANINA çekilir; bir yarı değişince DOKUNULMAYAN uç kırpma onu taşımadıkça tuttuğu değerle yazılır; sıra YAZILAN çift üzerinde uygulanır, bitiş başlangıçtan önce kalırsa başlangıca eşitlenir. Sınır dışı bir seçim hata VERMEZ, sınıra yapışır. Akıştan yazılan değerler yazıldıkları anda bu kapıdan GEÇMEZ, olduğu gibi gösterilir; ama HANGİ yarıda olursa olsun bir sonraki kullanıcı seçimi onları da kırpar/sıraya sokar (sınır dışı uç sınıra, başlangıçtan önceki bitiş başlangıca) ve dokunulmayan ucu yayılan biçimde ('yyyy-MM-ddTHH:mm:ss', çıplak gün '…T00:00:00') yeniden yazar. Etkinleşen sınır günlerinin yan etkisi: tutulan saat o günde sınırın dışına düşerse (başlangıç 10:30, bitiş ertesi gün 09:00 → bitişte başlangıç günü seçilir) uç sessizce sınıra çekilir; sınırı günün son adımından geç olan gün (minDate 23:50, adım 15) seçilebilir ama listede seçilebilir saat yoktur, saat elle yazılır. 2026-09-16'ya kadar iki uç da gösterilen hâlinden yeniden türetiliyordu: yalnız displayOffset ya da yalnız valueOffset verilmiş alanda dokunulmayan uç her seçimde o kadar saat kayıyordu.",
             "Doğrulama kuralları: required · min · max (2026-09-12; pattern bildirimi kaldırıldı — panel tarih-saat alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu). min/max değeri 'yyyy-MM-ddTHH:mm' tarih-saat metnidir ve Form aralığın İKİ ucunu da sınırla karşılaştırır.",
             "focus/blur ALAN düzeyindedir (2026-09-12): iki tarih girdisi, iki saat girdisi, takvim ve saat listesi arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.",
             "isLoading KİLİT DEĞİLDİR (2026-09-12): alan odaklanabilir kalır, sağ uçta dönen spinner çizilir, kök aria-busy taşır (478px altındaki dikey yığılmada spinner çizilmez, aria-busy kalır). Kilit için isDisabled kullan.",
-            "Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri olduğu gibi). İkisini birden boşaltmanın yolu iki X ya da akıştan iki prop'u null yazmaktır.",
-            "Gösterim dili locale'den (boşsa uygulama dili): tarih tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'; saat en'de 12 saat (01:00 PM), diğer dillerde 24 saat. Değer her dilde aynı 24 saatlik metindir. Biçim prop'u YOK (ARC-071)."
+            "Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri tuttuğu değerle yazılır). Yalnız taslak gün tutan yarının X'i taslağı siler ama change YAYMAZ — değer zaten boştu (2026-09-16; öncesinde değişmeyen değerle change yayıyordu). İkisini birden boşaltmanın yolu iki X ya da akıştan iki prop'u null yazmaktır.",
+            "Gösterim dili locale'den (boşsa uygulama dili): tarih tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'; saat en'de 12 saat (01:00 PM), diğer dillerde 24 saat. Değer her dilde aynı 24 saatlik metindir. Biçim prop'u YOK (ARC-071).",
+            "Tarih kutuları '<elementId>__start' / '<elementId>__end' ile adreslenir (G-14, 2026-09-15). page_screenshot 'set' kökü reddeder; kutuya ISO tarih yazmak takvimden gün seçmekle AYNI kuraldır: yarı değer tutmuyorsa yalnız taslak olur ve propWritten:false döner — saat kutusu ayrıca hedeflenemez, önce akıştan değer yazın ya da saati tıklamayla seçin."
         ],
         propNotes: {
-            valueFrom: "Başlangıç: 'yyyy-MM-ddTHH:mm:ss' ya da null. Akıştan yazarken bu biçimi (ya da Date'in okuduğu bir ISO metnini) kullan; okunamayan metin yarıyı BOŞ gösterir, hata vermez.",
-            valueTo: "Bitiş; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı yalnız kullanıcı seçiminde uygulanır.",
+            valueFrom: "Başlangıç: 'yyyy-MM-ddTHH:mm:ss' ya da null. Akıştan yazarken bu biçimi (ya da Date'in okuduğu bir ISO metnini) kullan; çıplak 'yyyy-MM-dd' o günün YEREL gece yarısıdır (2026-09-16'ya kadar UTC okunuyordu, TR'de 03:00 görünüyordu); okunamayan metin yarıyı BOŞ gösterir, hata vermez.",
+            valueTo: "Bitiş; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı kullanıcı seçiminde uygulanır: hangi yarıda olursa olsun bir sonraki seçim bitişi başlangıca çeker.",
             minutesStep: "Saat listelerinin adımı, METİN enum: '1' | '2' | '3' | '4' | '5' | '6' | '10' | '12' | '15' | '30' | '60' (varsayılan '15'). 0, negatif ya da okunamayan değer 15'e düşer; 1 dakika 1440 satır demektir.",
-            minDate: "En erken tarih-saat ('yyyy-MM-ddTHH:mm:ss'); öncesi takvimde ve saat listesinde pasif kalır, yine de sınır dışına düşen seçim sınıra çekilir.",
-            maxDate: 'En geç tarih-saat; sonrası pasif, sınır dışı seçim sınıra çekilir.',
-            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez.',
-            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3): kullanıcının gördüğü saat seçtiği saattir, saklanan değer sabit kalır.',
+            minDate: "En erken tarih-saat ('yyyy-MM-ddTHH:mm:ss'); takvimde o GÜNÜN öncesi, saat listesinde o ANIN öncesi pasif kalır (kendi günü seçilebilir); sınır dışına düşen seçim sınır anına çekilir.",
+            maxDate: 'En geç tarih-saat; takvimde o GÜNÜN sonrası, saat listesinde o ANIN sonrası pasif (kendi günü seçilebilir); sınır dışı seçim sınır anına çekilir.',
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); yalnız gösterilir, yazmada geri alınmaz — seçilen/korunan saat GÖSTERİLEN saattir. valueOffset ile ters işaretli verilmezse bir yarının tarihini değiştirmek o yarının saklanan saatini her seferinde +3 kaydırır (…06T18:00 → …07T21:00 → …08T00:00).',
+            valueOffset: "DEĞİŞEN ucu yazarken kaydıran saat sayısı; dokunulmayan uç tuttuğu değerle kalır (2026-09-16'ya kadar o uç da her seçimde kayıyordu). Gösterim yazılan değerden okunduğu için tek başına verilirse ekranda da görünür (-3: 15:00 seçilir, '…T12:00:00' yazılır, kutu 12:00 gösterir) ve değişen yarının tarihini her değiştirmede saati o kadar kaydırır. displayOffset ile HER ZAMAN ters işaretli ver (+3 / -3): kullanıcı gösterilen saati seçer ve korur, saklanan değer sabit kalır.",
             locale: LOCALE_FOLLOWS_APP_NOTE,
             isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
         }
@@ -549,10 +632,20 @@ export const componentKnowledge = {
     filebutton: { summary: 'Buton görünümlü dosya seçici; fileInput ile aynı yük.' },
     'file-viewer': { summary: 'Dosya önizleyici (pdf/görsel); file prop’una drive dosyası bağlanır.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
     button: {
-        summary: 'Tıklama kaynağı; click olayı veri taşımaz, bağlam gerekiyorsa ifadede komponent adlarıyla okunur.',
+        summary: "Tıklama kaynağı; type üç işten birini seçer — 'button' click akışını çalıştırır, 'submit' bir Form'u gönderir, 'link' bir adrese gider. click olayı veri taşımaz, bağlam gerekiyorsa ifadede komponent adlarıyla okunur.",
+        behavior: [
+            "click YALNIZ type:'button' iken yayılır. type:'submit' click YAYMAZ, formu gönderir: akışı butona değil formun submit olayına bağla (form doğrulaması geçerse yayılır). type:'link' de click yaymaz, tarayıcı href'e gider.",
+            "type:'submit' buton bir Form'un İÇİNDEYSE formId gerekmez, tarayıcı en yakın forma bağlar; formun DIŞINDAYSA formId = formun elementId'si ya da adı. isDisabled/isLoading açıkken gönderim de kilitlidir.",
+            "href ve isNewTabLink YALNIZ type:'link' iken okunur — href doldurmak butonu link yapmaz. İç sayfaya link için href'e URL değil { type:'page', ref:<pageId> } Prop'u yaz. Link kilitliyken (isDisabled/isLoading) ya da href boşken hiçbir yere gitmez ve odak almaz; kilit kalkınca ya da href akışla değişince adres anında güncellenir (2026-09-11 öncesi ilk çizimdeki adreste donuyordu: kilitli açılan link hep ölü kalıyordu).",
+            "Kayıtlı sayfalardaki eski kind:'custom' + customColor ikilisi VERİ GÖÇÜ OLMADAN aynen çizilir (render-anı takma adı, text emsali): surfaceStyle.background boşsa eski renk `--ng-btn-custom-color` değişkeniyle solid/outline/text varyantına eskisi gibi iner; Background doldurulunca takma ad susar. page_runtime_get(resolveStyles:true) bu değişkeni resolvedStyle'da gösterir. DİKKAT: platformun doğrulama duvarı sayfanın TAMAMINI okur — böyle bir düğüm taşıyan sayfaya yapılan her page_schema_patch, dokunulmayan düğüm yüzünden invalid-enum-value/unknown-prop ile reddedilir (ARC-036). Sayfayı yeniden yazmadan önce o butonu kind: semantik değer + surfaceStyle.background'a çevir (aynı çağrıda replace_prop ile).",
+            "İpucu (tooltip) prop'u YOKTUR: düğümün ortak appearance.tooltip alanı (+ tooltipPosition: top · bottom · left · right) her komponentte ipucu çizer. Tıklamadan önce onay istemek de butonun değil akışın işidir: click akışının başına confirm adımı koy (yalnız web — mobil barındırıcıda confirm adımı yok)."
+        ],
         propNotes: {
-            kind: "primary | info | success | warning | error | custom — 'custom' seçilirse renk customColor'dan gelir. `datatable.actions[].kind` FARKLI bir sözlük kullanır (error · information · solid · transparent · dark · danger · warning) — buradan bir değer (örn. 'transparent') butona yazılırsa invalid-enum-value verir.",
-            customColor: "Yalnız kind:'custom' iken okunur; hex ya da tema token'ı ('var(--ng-accent-primary)').",
+            kind: "primary | info | success | warning | error — beş semantik renk, temayı izler; temizlenirse (null) primary çizilir. ÖZEL ZEMİN için kind değil surfaceStyle.background yazılır (Dalga 4, 2026-09-14): eski custom seçeneği ve customColor şemadan kalktı, yazılırsa invalid-enum-value / unknown-prop. `datatable.actions[].kind` FARKLI bir sözlük kullanır (error · information · solid · transparent · dark · danger · warning) — buradan bir değer (örn. 'transparent') butona yazılırsa invalid-enum-value verir.",
+            icon: "{ name: 'save', color? } nesnesi; düz 'save' metni de okunur (AI sözlüğü icon'u string gösteriyor — CQ-164). Adı boş ya da temizlenmiş ikon hiç çizilmez. Yükleniyorken ikonun yerinde spinner döner (link tipinde spinner yok).",
+            iconPosition: "'left' (varsayılan) | 'right' — ikonun (ve yükleniyorken spinner'ın) metnin hangi yanında durduğu; ikon yokken etkisiz.",
+            align: "'none' (varsayılan) butonu hücrenin TÜM genişliğine yayar; 'left' · 'center' · 'right' butonu içerik kadar daraltıp yaslar. Temizlenirse (null) 'none' sayılır.",
+            surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Buton yüzeyi (contentOverflow YOK — kaydırılan içerik yok). Her alan kind/variant CSS'inin ÜSTÜNE biner (tasarımcı kazanır): background Outline/Text varyantında da zemini doldurur ve o varyantların kind renkli hover dolgusu görünmez olur; shadow hover/active'de sabit kalır; opacity devre dışı görünümünü (0.5) de ezer. Metin rengi kind'dan gelir, burada alan yok — açık bir zeminde okunur kalması için style: { color: '…' }.",
             badgeValue: "Butonun köşe rozetinin metni ('3', '99+'); boşsa rozet çizilmez. Rengi badgeColor'dan gelir (primary|info|success|warning|error, varsayılan 'error')."
         }
     },
@@ -563,11 +656,11 @@ export const componentKnowledge = {
         summary: 'Görsel + başlık + açıklama + buton metni taşıyan hazır KART; click yayar.',
         behavior: [
             "KAPSAYICI DEĞİLDİR: çocuk kabul etmez (not-droppable). Kutu içinde serbest içerik göstermek için container kullanın (istenirse states.isWrapper:true).",
-            'Yükseklik 10-50 aralığındadır (min 10, max 20 varsayılan, max 50); aralık dışı blocks[].size.h invalid-size ile reddedilir.'
+            'Yükseklik 10-50 aralığındadır (min 10, max 20 varsayılan, max 50). Bu sınır grid kanvasının kuralıdır, API aralık dışı blocks[].size.h değerini reddetmez; yine de aralıkta tutun.'
         ]
     },
     'qm-card': { summary: 'QM gösterge kartı; click yayar.' },
-    tabs: { summary: 'Sekmeler; tab olayı seçilen sekme anahtarını taşır, her view children sırasıyla eşleşir.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
+    tabs: { summary: "Sekmeler; tab olayı seçilen sekme anahtarını taşır, her view children sırasıyla eşleşir. Etkin OLMAYAN sekmenin içeriği DOM'da YOKTUR (keepAlways dışında): o sekmedeki bir düğümü hedefleyen doğrulama önce page_screenshot actions { action: 'tab', value: '<sekme anahtarı>' } ister — sekme grubunun köküne click ilk sekmeye gider ve reddedilir.", propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
     'collapsible-container': { summary: 'Aç/kapa kapsayıcı; collapsed/expanded olayları yayar.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
     'tree-view': {
         summary: 'Hiyerarşik liste: data ağacını çizer, satır tıklamasını click olayıyla akışa verir, satır başına aksiyon menüsü ve isteğe bağlı istemci-tarafı arama taşır.',
@@ -594,7 +687,7 @@ export const componentKnowledge = {
     text: {
         summary: 'Tek satırlık metin gösterimi; değer type:code prop’uyla ifadeye bağlanabilir. Görünümü TİPLİ stil gruplarındadır (typographyStyle · surfaceStyle), ham CSS değil.',
         behavior: [
-            "Yükseklik SABİTTİR: maxSize.h = 1 (katalog varsayılanı 8'dir ve olduğu gibi kopyalanırsa reddedilir; gateway 1'e çeker ve gatewayNormalized ile bildirir). Çok satırlı metin için textarea ya da html kullanın.",
+            "Yükseklik SABİTTİR: maxSize.h = 1 (katalog varsayılanı 8'dir ve olduğu gibi kopyalanırsa kanvasta boyutlandırılamaz; gateway 1'e çeker ve gatewayNormalized ile bildirir). Çok satırlı metin için textarea ya da html kullanın.",
             "type HTML etiketi + ölçek seviyesidir (h1|h2|h3|label|p|small; a11y için doğru seviyeyi seç). Punto/kalınlık/renk/hiza kararı typographyStyle'dadır: fontSize seviyenin puntosunu ezer, boş bırakılırsa seviye ölçeği (tema --ng-font-size-*) geçerlidir.",
             "EMEKLİ prop'lar: isBold, align, color, customColor şemada YOK — yazılırsa unknown-prop ile reddedilir. Karşılıkları: typographyStyle.fontWeight ('600'), textAlign, textColor (semantik renk için tema token'ı: var(--ng-status-success) gibi). Kayıtlı eski sayfalarda bu prop'lar render anında takma adla çözülür (resolvedStyle bunu gösterir), yeni yazımda kullanılmaz.",
             "Hover grubu yok (metnin hover semantiği yok); surfaceStyle etiket/vurgulu paragraf içindir (zemin, köşe, çerçeve, gölge) ve contentOverflow alanı yoktur (taşma hedefi yok).",
@@ -614,7 +707,7 @@ export const componentKnowledge = {
         summary: 'Sayfa içi geri bildirim kutusu; akışlarda alert adımı yerine bu komponent kullanılır.',
         behavior: [
             "isHidden 2026-08-26'dan beri bu komponentin ŞEMASINDA VARDIR (daha önce yoktu ve bu katalog bir dönem 'unknown-prop verir' diyordu): props.isHidden'ı doğrudan şemaya yazabilirsin, başlangıçta gizli bildirim için container'a sarmak GEREKMEZ.",
-            "appearance.isHidden bir çözüm DEĞİLDİR: kaydedilir ama runtime hiçbir yerde okumaz (renderer yalnız props.isHidden'a bakar).",
+            "Görünürlük yalnız props.isHidden'dır: appearance'ta isHidden alanı YOKTUR (2026-09-15'te platformdan kaldırıldı, S-16). Gövdeye appearance.isHidden konursa gateway onu props.isHidden'a taşır ve gatewayNormalized'da bildirir.",
             "Kendini KAPATIRKEN props.isHidden'a yazar: hem timeout dolduğunda hem kapatma düğmesinde 'toggled' emit'i { isHidden: true } taşır (Notification.svelte handleEvent). Şema events sözlüğünde bu ad YOKTUR — akışa bağlanacak bir olay değil, prop'a geri yazma yoludur.",
             'Başlangıçta gizli bir bildirim: şemaya props.isHidden:true yaz, açılışı akıştaki setter ile yap; timeout verilirse kendini kapatır.'
         ],
@@ -623,7 +716,25 @@ export const componentKnowledge = {
             isHidden: 'Şemada tanımlıdır; statik true ile gizli başlatılır, akıştaki setter ile açılıp kapanır. Komponent kendi kapanışında da bu prop\'a yazar.'
         }
     },
-    'form-validation-errors': { summary: 'Formun doğrulama hatalarını listeler; form.errorElementId buraya işaret eder.' },
+    'form-validation-errors': {
+        summary: 'Formun doğrulama hatalarını tek kutuda listeler; form.errorElementId buraya işaret eder. Liste boşken hiçbir şey çizmez.',
+        behavior: [
+            "BAĞLAMA: form'un errorElementId prop'una bu düğümün elementId'sini HER ZAMAN yaz. Yazılmazsa Form yalnız KENDİ İÇİNDEKİ ve elementId'si 'formvalidation-errors' ile başlayan düğümü bulur — o önek yalnız studio kenar çubuğundan sürüklenen düğümde oluşur; MCP ile kurulan, kopyalanan ya da formun dışına konan liste bulunmaz ve hiç dolmaz (docs/issues.md CQ-259).",
+            'Listeyi Form doldurur: ilk submit’ten sonra hatalı alanları yazar, sonra her alan değişikliğinde listeyi yeniden yazar (düzelen alan düşer); başarısız submit’te kutuya kaydırır. resetForm listeyi de siler. Liste boşken bileşen DOM’a hiçbir şey basmaz.',
+            "errors öğesi { id, label, message }: id hatalı alanın elementId'si, label alan adı, message metin. Aynı id'li hatalar alan adının altında tek grupta toplanır. id'si olan satır düğmedir — tıklanınca alan kapalı bir sekmedeyse o sekme açılır, alana odaklanılır, kaydırılır ve 2 sn vurgulanır; id'siz satır düz metindir ve gruplanmaz. Dizi yerine düz metin öğesi ('Kayıt reddedildi') { message } sayılır; message'ı boş öğe ve dizi olmayan değer (null) çizilmez.",
+            'Sunucu hatalarını (ör. 422 yanıtı) göstermek için akıştan setter ile errors yaz — Form’un yazdığıyla aynı biçim. Form bir sonraki submit/alan değişikliğinde listeyi kendi sonucuyla EZER.',
+            "message DÜZ METİN olarak basılır (2026-09-16'ya kadar HTML yorumlanıyordu; akıştan gelen metinde betik çalışabilirdi) — alanın kendi hata metniyle aynı. label'daki HTML etiketleri sökülür.",
+            "Paneldeki errors listesi yalnız KANVAS ÖNİZLEMESİDİR: sayfa açılınca düğümde statik değer silinir (2026-09-16'ya kadar yalnız bileşenin yerel kopyası siliniyordu ve düğümün başka bir prop'u — title, isHidden — akıştan değişince 'Username / Zip / Expiration date' örnekleri canlı sayfada beliriyordu). {{ }} ile bağlı errors silinmez. Silme düğüm başına bir kez yapılır: sekme değişimi ya da isHidden ile yeniden takılan liste Form'un yazdığı hataları korur.",
+            "Kutu role='alert' taşır: belirdiğinde ekran okuyucu içeriği duyurur; ikonlar okunmaz. Satır düğmelerinin klavye odak halkası vardır.",
+            'Olay: yalnız mount (render katmanı atar); tıklama olayı yoktur, satır tıkı alana gider.'
+        ],
+        propNotes: {
+            title: "Kutunun başlığı (kırmızı, listenin üstünde); boşsa başlık satırı çizilmez. Varsayılan 'Please review the form and correct the following errors.' — 2026-09-16'ya kadar 'formula' yazım hatasıyla bırakılıyordu, eski düğümler kendi değerini taşır.",
+            errors: "Çalışma anında Form'a (ya da setter yazan akışa) aittir: [{ id, label, message }]. Statik değer yalnız kanvas önizlemesidir ve sayfa açılınca silinir — kalıcı bir mesaj için notification kullan.",
+            hideFormValidationMessage: "true → Form alanların altındaki hata metnini yazmaz, yalnız kırmızı çerçeve kalır; mesajlar yalnız bu listede görünür. Form bunu BU düğümden okur, yani errorElementId bağlı değilse etkisizdir. Kanvasta görünür etkisi yoktur.",
+            style: STYLE_GROUP_NOTES.styleEscape + " Parçalar: KÖK (anahtarlar doğrudan style'da) kırmızı kutudur — zemin (--ng-red-50), çerçeve (--ng-red-200), köşe; '&__title' başlık metni. Satır sınıfları belgelenmemiştir."
+        }
+    },
     breadcrumb: { summary: 'Sayfa yolu; currentTitle setter ile kip etiketine (Yeni/Düzenle) çevrilir.' },
     'page-header': {
         summary: 'Sayfa başlığı bandı; yalnız mount yayar.',
@@ -676,6 +787,7 @@ export const componentKnowledge = {
         ],
         propNotes: {
             surfaceStyle: NODE_SURFACE_NOTE,
+            navigationStyle: NAVIGATION_STYLE_NOTE,
             activeHref: "Vurgulanacak menü satırının adresi; boşken adres çubuğu karar verir (sidebar ile aynı davranış). YENİ prop — platform kataloğuna CI senkronuyla iner.",
             layout: "'flex' (katalog varsayılanı; akış) | 'grid' (12 kolonluk ızgara). Prop hiç yazılmamışsa renderer IZGARA çizer. Diğer altı yerleşim prop'u yalnız 'flex' iken etkilidir; anlamları container kaydındakiyle birebir aynı."
         }
@@ -686,14 +798,15 @@ export const componentKnowledge = {
             'Ağacı layout ve sidebar ile ORTAK renderer çizer (Navigations/NavigationsItem) — üçünün menü davranışı birebir aynıdır; ayrıntı sidebar kaydında.',
             "Öğe bazlı isHidden BU şemada VARDIR: canlıda elenir, Studio'nun düzenleyici kipinde görünmeye devam eder (Navigations.svelte: {#if isEditorMode || item.isHidden !== true}).",
             "activeHref boşken menü tarayıcıdaki adrese uyan satırı kendi bulur; adres mount'ta BİR KEZ okunur (bağlantılar tam sayfa yükler).",
-            "style PROP'U ÖLÜDÜR: şema &__item ve &__item--active parçalarını sunuyor ama Navigations.svelte style diye bir prop KABUL ETMİYOR (yalnız navigations ve activeHref alır) ve satırları NavigationsItem kendi scoped .nav-btn sınıfıyla çizer. Panelden yazılan hiçbir şey uygulanmaz — sidebar'daki aynı kusurun ikizi (zeyrek-frontend docs/issues.md CQ-143 / CQ-132).",
+            "Satır görünümü TİPLİ navigationStyle grubuyla verilir (2026-09-15, layout ile aynı grup); serbest style'ın &__item, &__item--active ve &__icon parçaları da artık gerçek elemanlara basılır ve gruptan SONRA gelir (son söz).",
             'Menü olay YAYMAZ (şemada yalnız mount); gezinme ham <a href> ile tam sayfa yükleyerek olur.'
         ],
         propNotes: {
             navigations: "Ağaç: { title, href, icon, isHidden, isExpandable, isExpanded, children }. href düz metin ya da bağlantı seçicisinin nesnesi ({ type:'page', data, ref }) olabilir; ikisini de getHref çözer.",
             activeHref: 'Vurgulanacak satırın adresi; boş bırakılırsa tarayıcıdaki adres karar verir.',
             isHidden: 'Komponentin tamamını gizler (ortak katman prop’u); öğe bazlı gizleme navigations[].isHidden’dır.',
-            style: 'ÖLÜ — hiçbir etkisi yok (bkz. davranış). Menü biçimini değiştirmek bugün mümkün değil.'
+            navigationStyle: NAVIGATION_STYLE_NOTE,
+            style: "Kaçış kanalı: &__item (her satır), &__item--active (seçili satır), &__icon (satır ikonu). Önce navigationStyle'ı kullan; burada yalnız grubun karşılamadığı CSS yazılır."
         }
     },
     'layout-shell': {
@@ -733,7 +846,7 @@ export const componentKnowledge = {
         behavior: [
             "Layout'ta TEK slot olmalı. Enjeksiyon HER slot'a ayrı ayrı kopyalar (layout.functions.ts injectPageSchemaIntoSlots ağacı dolaşır ve type==='slot' gören her düğümün children'ına sayfa şemasının klonunu yazar; önizleme tarafında page.mappers.mapPageLayoutToPreview aynısını yapar): iki slot = sayfa iki kez çizilir, elementId'ler çakışır. Doğrulama: page_state.layoutSlots.",
             "Slot'un yerleşimi ızgara bloğundan gelir ve satır yüksekliği AÇIK UÇLUDUR — runtime slot için grid-row'u `y / auto` yazar (render.functions.ts), yani sayfa içeriği ne kadar uzarsa slot o kadar uzar. Slot'a sabit yükseklik vermeye çalışmak anlamsızdır.",
-            "Blok boyu yine de katalog sınırının içinde kalmalı: maxSize.h 200 (2026-09-12'den önce 80'di ve katalog varsayılanı 110 bile sınırın dışındaydı). Sınırı aşan TEK blok bütün yerleşimi/sayfayı PageSchemaValidationException + `invalid-size` ile düşürür."
+            "Blok boyu yine de katalog sınırının içinde kalmalı: maxSize.h 200 (2026-09-12'den önce 80'di ve katalog varsayılanı 110 bile sınırın dışındaydı). Bu sınır grid kanvasının kuralıdır; API blok boyunu denetlemez, ama sınırı aşan blok kanvasta boyutlandırılamaz."
         ]
     },
     view: { summary: 'Tabs/switcher altındaki görünüm kapsayıcısı; children gruplamaya yarar.' },
@@ -859,6 +972,7 @@ export const componentKnowledge = {
             categoryField: 'Kategori ekseni alan adı (varsayılan "label").',
             series: "[{ valueField, type?, axis?, color?, stack?, lowField/highField?, targetField? }] — yFields'ın yerini aldı.",
             stackMode: 'none | stacked | percent.',
+            dataLabels: "{ show, position, content, showTotal }. showTotal YALNIZ stackMode:'stacked' iken iş görür: her yığının tepesine (yatayda sağına) dilimlerin toplamını yazar, valueFormat uygulanır; toplam EKSENE ve LEGEND'e GİRMEZ. 2026-09-15 düzeltmesi — öncesinde toplam şeffaf bir seri olarak yığına ekleniyordu: değer ekseni gerçek en yüksek yığının İKİ KATINA çıkıyor, toplam etiketi barın çok üstünde boşlukta duruyor ve legend'de '<grup>__total' diye dördüncü bir madde beliriyordu (S-18). percent modunda etkisizdir.",
             isDrillDown: 'Veri noktası tıklamasını kırıntı seviyesine çevirir; sorguyu akış yeniler.'
         }
     },
@@ -1163,13 +1277,14 @@ export const componentKnowledge = {
             "Sürükleyerek taşıma yalnız isEditable ile: ay görünümünde gün kayar (saat korunur), hafta/gün kolonunda saat 30 dakikaya yuvarlanır; tüm-gün etkinlik saat KAZANMAZ. Yeniden boyutlandırma (resize) yoktur.",
             "Süresi >=24 saat ya da 00:00→00:00 olan etkinlik 'tüm gün' sayılır ve saat ızgarası yerine üst şeride çizilir; çok günlü etkinlik ay görünümünde kapladığı HER güne ayrı çip düşer (sürekli bant yok).",
             "defaultDate ve defaultView yalnız İLK kurulumda okunur — sonradan prop değişse de takvim kımıldamaz.",
-            "Hafta başlangıcı yerele bağlıdır (tr Pazartesi, en Pazar); startHour/endHour saat penceresini belirler, pencereye kısmen taşan blok en az 15 dakikalık yükseklikle çizilir."
+            "Hafta başlangıcı yerele bağlıdır (tr Pazartesi, en Pazar); startHour/endHour saat penceresini belirler, pencereye kısmen taşan blok en az 15 dakikalık yükseklikle çizilir.",
+            "Etkinlik her görünümde <elementId>__event-<id> data-element-id'si taşır; bırakma hedefleri ay hücresi ve hafta/gün kolonu <elementId>__day-<yyyy-MM-dd>, tüm gün hücresi __allday-<yyyy-MM-dd>, saat dilimi __slot-<yyyy-MM-dd>T<HH> (YEREL tarih). eventClick 'click' ile, eventMove page_screenshot actions 'drag' (target etkinlik, to gün/slot) ile doğrulanır; slota bırakma o saatin ortasına düşer ve 30 dakikaya yuvarlanır. Çok günlü etkinlik aynı kimliği her gününde taşır, hedef ilk eşleşmedir."
         ],
         propNotes: {
             rows: 'Etkinlik satırları; mount/monthChange akışlarının setter hedefi. Alan adları titleField/startField/endField/colorField/idField ile çözülür (nokta ayraçlı iç içe yol çalışır).',
             colorField: "Geçerli CSS rengi olduğu gibi kullanılır, semantik durum adı tema değişkenine çözülür, tanınmayan değer accent'e düşer. 'info' beyaz temada görünmezdir — ham renk ver.",
             maxVisibleEvents: 'Ay hücresinde görünen çip sayısı (varsayılan 3); fazlası +n olur.',
-            defaultDate: "Açılış ayı (yyyy-MM-dd; katalog varsayılanı örnek veriyle aynı ay olan '2026-08-01'). YALNIZ ilk kurulumda okunur.",
+            defaultDate: "Açılış ayı (yyyy-MM-dd ya da ISO tarih-saat; katalog varsayılanı örnek veriyle aynı ay olan '2026-08-01'). YALNIZ ilk kurulumda okunur. BOŞ bırakılırsa bugünün ayı açılır — 'bugün' için sabit tarih yazmayın. İfadeyle bağlanacaksa code prop'u '{{ }}' içinde yazılır: { type: 'code', ref: \"{{ new Date().toISOString().slice(0, 10) }}\" } — parantezsiz ifade metin olarak gelir (PAGE-032 reddeder). Bu iki biçim dışındaki her metin bugüne düşer.",
             startHour: 'Hafta/gün görünümünün ilk saati (varsayılan 8); endHour en az startHour+1 olacak biçimde kırpılır (varsayılan 18).'
         }
     },
@@ -1198,7 +1313,8 @@ export const componentKnowledge = {
             "Kolon içi SIRALAMA yoktur: kartlar rows dizisinin sırasıyla çizilir, aynı kolona bırakma no-op'tur, sıra ne taşınır ne yayılır.",
             "wipLimit yalnız GÖRSELDİR: aşımda kolon başlığı kırmızılaşır ama bırakma engellenmez; 0/boş = sınırsız.",
             "Kart şablonu sabittir: başlığın ilk harfi (TR büyük harf) rozet + başlık + alt başlık — resim avatarı, etiket, tarih alanı yoktur. Renk karta sol şerit, kolona üst şerit olarak iner (ham CSS ya da semantik ad).",
-            "Sürükleme yerel HTML5 DnD'dir; klavyeyle taşıma yolu yoktur (Enter yalnız cardClick yayar). isLoading sürüklemeyi de kilitler."
+            "Sürükleme yerel HTML5 DnD'dir; klavyeyle taşıma yolu yoktur (Enter yalnız cardClick yayar). isLoading sürüklemeyi de kilitler.",
+            "Kart <elementId>__card-<id>, kolon <elementId>__col-<value> data-element-id'si taşır (id = idField değeri, yoksa card-<sıra>): cardClick page_screenshot actions 'click' ile, cardMove 'drag' (target kart, to kolon) ile uçtan uca doğrulanır — actionsReport flowRuns/requests taşımanın akışı gerçekten koşturduğunu gösterir."
         ],
         propNotes: {
             rows: 'Kart satırları; alan adları columnField/titleField/subtitleField/idField/colorField ile çözülür (nokta ayraçlı iç içe yol çalışır).',
@@ -1326,6 +1442,29 @@ export const INTERNAL_ROLES_BY_TYPE = {
         'colmenu',
         'search (arama kutusu, isSearchable)',
         'row-<0 tabanlı sıra; sayfa değişince yeniden numaralanır>'
+    ],
+    kanban: [
+        "card-<kart id'si (idField; yoksa card-<sıra>)>",
+        "col-<kolon value'su> (bırakma hedefi)"
+    ],
+    eventcalendar: [
+        "event-<etkinlik id'si (idField; yoksa event-<sıra>)>",
+        'day-<yyyy-MM-dd> (ay hücresi / hafta-gün kolonu, bırakma hedefi)',
+        'allday-<yyyy-MM-dd> (tüm gün hücresi, bırakma hedefi)',
+        'slot-<yyyy-MM-dd>T<HH> (saat dilimi, bırakma hedefi)'
+    ],
+    // Sekme butonu kimliğini sekmenin KEY'inden alır (başlık çeviriye bağlıdır, dil değişince
+    // kayardı). Kök düğüme click DOM sırasındaki ilk sekmeye gider; seçim `tab` eyleminin işidir.
+    tabs: [
+        "tab-<sekme anahtarı>"
+    ],
+    daterangepicker: [
+        'start (başlangıç tarihi kutusu, valueFrom)',
+        'end (bitiş tarihi kutusu, valueTo)'
+    ],
+    datetimerangepicker: [
+        'start (başlangıç tarihi kutusu, valueFrom)',
+        'end (bitiş tarihi kutusu, valueTo)'
     ]
 };
 /** Hedefteki `__` ayracından sonrası bir iç roldür; gateway bulunamayan hedefte listeyi basar. */